From e6e696cd6f4b9e7a104e4625fadc91e608c8a416 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Tue, 19 Jun 2018 15:51:54 +0200
Subject: [PATCH 001/808] Bump version

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index d11d76608dfdf..1bcaa55bb9507 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '2.0.0dev0+incubating'
+version = '1.10.0beta2+incubating'

From 859ec64aee98c0294229b3c29f57f3c89b6ad533 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 27 Jun 2018 22:07:31 +0200
Subject: [PATCH 002/808] [AIRFLOW-1840] Support back-compat on old celery
 config

The new names are in-line with Celery 4, but if
anyone upgrades Airflow
without following the UPDATING.md instructions
(which we probably assume
most people won't, not until something stops
working) their workers
would suddenly just start failing. That's bad.

This will issue a warning but carry on working as
expected. We can
remove the deprecation settings (but leave the
code in config) after
this release has been made.

Closes #3549 from ashb/AIRFLOW-1840-back-compat

(cherry picked from commit a4592f91eb125d7b463f1762fbfe0f64f7bc6b3a)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 UPDATING.md              |  3 +++
 airflow/configuration.py | 53 +++++++++++++++++++++++++++++++++++++++-
 setup.py                 |  2 +-
 tests/configuration.py   | 40 +++++++++++++++++++++++++++++-
 4 files changed, 95 insertions(+), 3 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 3a66e735c3ac4..c341b38f0bc22 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -56,6 +56,9 @@ To make the config of Airflow compatible with Celery, some properties have been
 ```
 celeryd_concurrency -> worker_concurrency
 celery_result_backend -> result_backend
+celery_ssl_active -> ssl_active
+celery_ssl_cert -> ssl_cert
+celery_ssl_key -> ssl_key
 ```
 Resulting in the same config parameters as Celery 4, with more transparency.
 
diff --git a/airflow/configuration.py b/airflow/configuration.py
index 2ee453fd7d93f..e2089e5b5b94b 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -121,9 +121,29 @@ class AirflowConfigParser(ConfigParser):
         ('core', 'sql_alchemy_conn'),
         ('core', 'fernet_key'),
         ('celery', 'broker_url'),
-        ('celery', 'result_backend')
+        ('celery', 'result_backend'),
+        # Todo: remove this in Airflow 1.11
+        ('celery', 'celery_result_backend'),
     }
 
+    # A two-level mapping of (section -> new_name -> old_name). When reading
+    # new_name, the old_name will be checked to see if it exists. If it does a
+    # DeprecationWarning will be issued and the old name will be used instead
+    deprecated_options = {
+        'celery': {
+            # Remove these keys in Airflow 1.11
+            'worker_concurrency': 'celeryd_concurrency',
+            'broker_url': 'celery_broker_url',
+            'ssl_active': 'celery_ssl_active',
+            'ssl_cert': 'celery_ssl_cert',
+            'ssl_key': 'celery_ssl_key',
+        }
+    }
+    deprecation_format_string = (
+        'The {old} option in [{section}] has been renamed to {new} - the old '
+        'setting has been used, but please update your config.'
+    )
+
     def __init__(self, default_config=None, *args, **kwargs):
         super(AirflowConfigParser, self).__init__(*args, **kwargs)
 
@@ -181,10 +201,17 @@ def get(self, section, key, **kwargs):
         section = str(section).lower()
         key = str(key).lower()
 
+        deprecated_name = self.deprecated_options.get(section, {}).get(key, None)
+
         # first check environment variables
         option = self._get_env_var_option(section, key)
         if option is not None:
             return option
+        if deprecated_name:
+            option = self._get_env_var_option(section, deprecated_name)
+            if option is not None:
+                self._warn_deprecate(section, key, deprecated_name)
+                return option
 
         # ...then the config file
         if super(AirflowConfigParser, self).has_option(section, key):
@@ -192,11 +219,24 @@ def get(self, section, key, **kwargs):
             # separate the config from default config.
             return expand_env_var(
                 super(AirflowConfigParser, self).get(section, key, **kwargs))
+        if deprecated_name:
+            if super(AirflowConfigParser, self).has_option(section, deprecated_name):
+                self._warn_deprecate(section, key, deprecated_name)
+                return expand_env_var(super(AirflowConfigParser, self).get(
+                    section,
+                    deprecated_name,
+                    **kwargs
+                ))
 
         # ...then commands
         option = self._get_cmd_option(section, key)
         if option:
             return option
+        if deprecated_name:
+            option = self._get_cmd_option(section, deprecated_name)
+            if option:
+                self._warn_deprecate(section, key, deprecated_name)
+                return option
 
         # ...then the default config
         if self.defaults.has_option(section, key):
@@ -352,6 +392,17 @@ def load_test_config(self):
         # then read any "custom" test settings
         self.read(TEST_CONFIG_FILE)
 
+    def _warn_deprecate(self, section, key, deprecated_name):
+        warnings.warn(
+            self.deprecation_format_string.format(
+                old=deprecated_name,
+                new=key,
+                section=section,
+            ),
+            DeprecationWarning,
+            stacklevel=3,
+        )
+
 
 def mkdir_p(path):
     try:
diff --git a/setup.py b/setup.py
index 0b012eec0724f..a1b3b1dc6ab6c 100644
--- a/setup.py
+++ b/setup.py
@@ -230,7 +230,7 @@ def write_version(filename=os.path.join(*['airflow',
     devel_ci = [package for package in devel_all if package not in
                 ['snakebite>=2.7.8', 'snakebite[kerberos]>=2.7.8']]
 else:
-    devel_ci = devel_all
+    devel_ci = devel_all + ['unittest2']
 
 
 def do_setup():
diff --git a/tests/configuration.py b/tests/configuration.py
index ca1d1d7a37df6..ac6f7b7db7746 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -20,7 +20,7 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-import unittest
+import os
 from collections import OrderedDict
 
 import six
@@ -28,6 +28,12 @@
 from airflow import configuration
 from airflow.configuration import conf, AirflowConfigParser, parameterized_config
 
+if six.PY2:
+    # Need `assertWarns` back-ported from unittest2
+    import unittest2 as unittest
+else:
+    import unittest
+
 
 class ConfTest(unittest.TestCase):
 
@@ -154,3 +160,35 @@ def test_broker_transport_options(self):
         self.assertTrue(isinstance(section_dict['_test_only_float'], float))
 
         self.assertTrue(isinstance(section_dict['_test_only_string'], six.string_types))
+
+    def test_deprecated_options(self):
+        # Guarantee we have a deprecated setting, so we test the deprecation
+        # lookup even if we remove this explicit fallback
+        conf.deprecated_options['celery'] = {
+            'worker_concurrency': 'celeryd_concurrency',
+        }
+
+        # Remove it so we are sure we use the right setting
+        conf.remove_option('celery', 'worker_concurrency')
+
+        with self.assertWarns(DeprecationWarning):
+            os.environ['AIRFLOW__CELERY__CELERYD_CONCURRENCY'] = '99'
+            self.assertEquals(conf.getint('celery', 'worker_concurrency'), 99)
+            os.environ.pop('AIRFLOW__CELERY__CELERYD_CONCURRENCY')
+
+        with self.assertWarns(DeprecationWarning):
+            conf.set('celery', 'celeryd_concurrency', '99')
+            self.assertEquals(conf.getint('celery', 'worker_concurrency'), 99)
+            conf.remove_option('celery', 'celeryd_concurrency')
+
+    def test_deprecated_options_cmd(self):
+        # Guarantee we have a deprecated setting, so we test the deprecation
+        # lookup even if we remove this explicit fallback
+        conf.deprecated_options['celery'] = {'result_backend': 'celery_result_backend'}
+        conf.as_command_stdout.add(('celery', 'celery_result_backend'))
+
+        conf.remove_option('celery', 'result_backend')
+        conf.set('celery', 'celery_result_backend_cmd', '/bin/echo 99')
+
+        with self.assertWarns(DeprecationWarning):
+            self.assertEquals(conf.getint('celery', 'result_backend'), 99)

From 683f46688bc9228c70b3b6c96486280b29542dc4 Mon Sep 17 00:00:00 2001
From: David Hatch <dhatch@flatiron.com>
Date: Tue, 26 Jun 2018 15:26:13 -0700
Subject: [PATCH 003/808] [AIRFLOW-2681] Include last dag run of externally
 triggered DAGs in UI.

Closes #3551 from dhatch/AIRFLOW-2681

(cherry picked from commit 78f3d33388c772eafbed8fff81b0e50188297fc6)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/www/templates/airflow/dags.html      | 2 +-
 airflow/www_rbac/templates/airflow/dags.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 23978905780ea..217b39dcbb4b7 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -119,7 +119,7 @@ <h2>DAGs</h2>
                 <!-- Column 7: Last Run -->
                 <td class="text-nowrap latest_dag_run {{ dag.dag_id }}">
                   {% if dag %}
-                    {% set last_run = dag.get_last_dagrun() %}
+                    {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
                     {% if last_run and last_run.execution_date %}
                       <a href="{{ url_for('airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
                         {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index a712e5a9ee4bc..a7a7467de1f68 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -120,7 +120,7 @@ <h2>DAGs</h2>
                 <!-- Column 7: Last Run -->
                 <td class="text-nowrap latest_dag_run {{ dag.dag_id }}">
                   {% if dag %}
-                    {% set last_run = dag.get_last_dagrun() %}
+                    {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
                     {% if last_run and last_run.execution_date %}
                       <a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
                         {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}

From bd4937b56efcffb117f266d1a8c523c82e023e18 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 27 Jun 2018 22:11:43 +0200
Subject: [PATCH 004/808] [AIRFLOW-2668] Handle missing optional cryptography
 dependency

cryptography is a recommended, but optional
dependency. It was
mistakenly made a hard dependency by a refactor.
This restores that
behaviour (though without tests, as it's hard to
test that in a
unittest)

In testing this I found that running `airflow
initdb` would end up
printing the "crypto is missing" message 15 times,
making it hard to see
what was actually going on. So I have re-worked
`get_fernet()` to only
compute (and warn) once. This also makes the
consuming code easier as in
the case of the dep not being installed we still
have a class that
presents the same interface as Fernet.

Closes #3550 from ashb/AIRFLOW-2668-optional-
cryptography

(cherry picked from commit fa6c35743a5129057d870752554b0827dd7d462f)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/models.py | 111 ++++++++++++++++++++++++++--------------------
 1 file changed, 63 insertions(+), 48 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 4706c2d50b6e1..4b7e123b66aa1 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -24,11 +24,9 @@
 
 from future.standard_library import install_aliases
 
-from builtins import str
-from builtins import object, bytes
+from builtins import str, object, bytes, ImportError as BuiltinImportError
 import copy
 from collections import namedtuple, defaultdict
-import cryptography
 from datetime import timedelta
 
 import dill
@@ -104,6 +102,33 @@
 Stats = settings.Stats
 
 
+class InvalidFernetToken(Exception):
+    # If Fernet isn't loaded we need a valid exception class to catch. If it is
+    # loaded this will get reset to the actual class once get_fernet() is called
+    pass
+
+
+class NullFernet(object):
+    """
+    A "Null" encryptor class that doesn't encrypt or decrypt but that presents
+    a similar interface to Fernet.
+
+    The purpose of this is to make the rest of the code not have to know the
+    difference, and to only display the message once, not 20 times when
+    `airflow initdb` is ran.
+    """
+    is_encrypted = False
+
+    def decrpyt(self, b):
+        return b
+
+    def encrypt(self, b):
+        return b
+
+
+_fernet = None
+
+
 def get_fernet():
     """
     Deferred load of Fernet key.
@@ -114,12 +139,25 @@ def get_fernet():
     :return: Fernet object
     :raises: AirflowException if there's a problem trying to load Fernet
     """
+    global _fernet
+    if _fernet:
+        return _fernet
     try:
-        from cryptography.fernet import Fernet
-    except ImportError:
-        raise AirflowException('Failed to import Fernet, it may not be installed')
+        from cryptography.fernet import Fernet, InvalidToken
+        global InvalidFernetToken
+        InvalidFernetToken = InvalidToken
+
+    except BuiltinImportError:
+        LoggingMixin().log.warn("cryptography not found - values will not be stored "
+                                "encrypted.",
+                                exc_info=1)
+        _fernet = NullFernet()
+        return _fernet
+
     try:
-        return Fernet(configuration.conf.get('core', 'FERNET_KEY').encode('utf-8'))
+        _fernet = Fernet(configuration.conf.get('core', 'FERNET_KEY').encode('utf-8'))
+        _fernet.is_encrypted = True
+        return _fernet
     except (ValueError, TypeError) as ve:
         raise AirflowException("Could not create Fernet object: {}".format(ve))
 
@@ -673,9 +711,8 @@ def parse_from_uri(self, uri):
 
     def get_password(self):
         if self._password and self.is_encrypted:
-            try:
-                fernet = get_fernet()
-            except AirflowException:
+            fernet = get_fernet()
+            if not fernet.is_encrypted:
                 raise AirflowException(
                     "Can't decrypt encrypted password for login={}, \
                     FERNET_KEY configuration is missing".format(self.login))
@@ -685,15 +722,9 @@ def get_password(self):
 
     def set_password(self, value):
         if value:
-            try:
-                fernet = get_fernet()
-                self._password = fernet.encrypt(bytes(value, 'utf-8')).decode()
-                self.is_encrypted = True
-            except AirflowException:
-                self.log.exception("Failed to load fernet while encrypting value, "
-                                   "using non-encrypted value.")
-                self._password = value
-                self.is_encrypted = False
+            fernet = get_fernet()
+            self._password = fernet.encrypt(bytes(value, 'utf-8')).decode()
+            self.is_encrypted = fernet.is_encrypted
 
     @declared_attr
     def password(cls):
@@ -702,9 +733,8 @@ def password(cls):
 
     def get_extra(self):
         if self._extra and self.is_extra_encrypted:
-            try:
-                fernet = get_fernet()
-            except AirflowException:
+            fernet = get_fernet()
+            if not fernet.is_encrypted:
                 raise AirflowException(
                     "Can't decrypt `extra` params for login={},\
                     FERNET_KEY configuration is missing".format(self.login))
@@ -714,15 +744,9 @@ def get_extra(self):
 
     def set_extra(self, value):
         if value:
-            try:
-                fernet = get_fernet()
-                self._extra = fernet.encrypt(bytes(value, 'utf-8')).decode()
-                self.is_extra_encrypted = True
-            except AirflowException:
-                self.log.exception("Failed to load fernet while encrypting value, "
-                                   "using non-encrypted value.")
-                self._extra = value
-                self.is_extra_encrypted = False
+            fernet = get_fernet()
+            self._extra = fernet.encrypt(bytes(value, 'utf-8')).decode()
+            self.is_extra_encrypted = fernet.is_encrypted
         else:
             self._extra = value
             self.is_extra_encrypted = False
@@ -4366,32 +4390,23 @@ def get_val(self):
         if self._val and self.is_encrypted:
             try:
                 fernet = get_fernet()
-            except Exception:
-                log.error("Can't decrypt _val for key={}, FERNET_KEY "
-                          "configuration missing".format(self.key))
-                return None
-            try:
                 return fernet.decrypt(bytes(self._val, 'utf-8')).decode()
-            except cryptography.fernet.InvalidToken:
+            except InvalidFernetToken:
                 log.error("Can't decrypt _val for key={}, invalid token "
                           "or value".format(self.key))
                 return None
+            except Exception:
+                log.error("Can't decrypt _val for key={}, FERNET_KEY "
+                          "configuration missing".format(self.key))
+                return None
         else:
             return self._val
 
     def set_val(self, value):
         if value:
-            try:
-                fernet = get_fernet()
-                self._val = fernet.encrypt(bytes(value, 'utf-8')).decode()
-                self.is_encrypted = True
-            except AirflowException:
-                self.log.exception(
-                    "Failed to load fernet while encrypting value, "
-                    "using non-encrypted value."
-                )
-                self._val = value
-                self.is_encrypted = False
+            fernet = get_fernet()
+            self._val = fernet.encrypt(bytes(value, 'utf-8')).decode()
+            self.is_encrypted = fernet.is_encrypted
 
     @declared_attr
     def val(cls):

From c01a12eda27609c7150ec05d91aed4c32368ac5c Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 20 Jun 2018 23:40:04 +0100
Subject: [PATCH 005/808] [AIRFLOW-2654] Fix incorret URL on refresh in Graph
 View of FAB UI

- Fix incorrect URL requested on pressing the refresh button in the graph view.

(cherry picked from commit 8dc54e6e0034eec1511453e168499931348f684c)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/www_rbac/templates/airflow/graph.html | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 35f79b6d71edb..d56c5b760336e 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -1,13 +1,13 @@
-{# 
+{#
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
-  
+
     http://www.apache.org/licenses/LICENSE-2.0
-  
+
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -350,7 +350,7 @@
             $("#loading").css("display", "block");
             $("div#svg_container").css("opacity", "0.2");
             $.get(
-                "/airflow/object/task_instances",
+                "{{ url_for('Airflow.task_instances') }}",
                 {dag_id : "{{ dag.dag_id }}", execution_date : "{{ execution_date }}"})
             .done(
                 function(task_instances) {

From 7c5157a9366dfb118bccb0c900313ea46e5eb80f Mon Sep 17 00:00:00 2001
From: Kevin Yang <kevin.yang@airbnb.com>
Date: Thu, 14 Jun 2018 18:20:46 -0700
Subject: [PATCH 006/808] [AIRFLOW-2624] Fix webserver login as anonymous

(cherry picked from commit 2fd9328b412841429acc288b1441c8351ee15e98)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/www/utils.py    |  6 +--
 tests/www/test_utils.py | 85 ++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 86 insertions(+), 5 deletions(-)

diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 7d9c8a07501c7..44fa5c4dcd6fb 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -246,8 +246,8 @@ def action_logging(f):
     """
     @functools.wraps(f)
     def wrapper(*args, **kwargs):
-        # Only AnonymousUserMixin() does not have user attribute
-        if current_user and hasattr(current_user, 'user'):
+        # AnonymousUserMixin() has user attribute but its value is None.
+        if current_user and hasattr(current_user, 'user') and current_user.user:
             user = current_user.user.username
         else:
             user = 'anonymous'
@@ -286,7 +286,7 @@ def wrapper(*args, **kwargs):
             dag = dagbag.get_dag(dag_id)
             task = dag.get_task(task_id)
 
-            if current_user and hasattr(current_user, 'username'):
+            if current_user and hasattr(current_user, 'user') and current_user.user:
                 user = current_user.username
             else:
                 user = 'anonymous'
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index d69041a368af4..9d788e88f1ed9 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -17,9 +17,12 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import mock
 import unittest
 from xml.dom import minidom
 
+from airflow.www import app as application
+
 from airflow.www import utils
 
 
@@ -109,6 +112,84 @@ def test_params_all(self):
         self.assertEqual('page=3&search=bash_&showPaused=False',
                          utils.get_params(showPaused=False, page=3, search='bash_'))
 
+    # flask_login is loaded by calling flask_login._get_user.
+    @mock.patch("flask_login._get_user")
+    @mock.patch("airflow.settings.Session")
+    def test_action_logging_with_login_user(self, mocked_session, mocked_get_user):
+        fake_username = 'someone'
+        mocked_current_user = mock.MagicMock()
+        mocked_get_user.return_value = mocked_current_user
+        mocked_current_user.user.username = fake_username
+        mocked_session_instance = mock.MagicMock()
+        mocked_session.return_value = mocked_session_instance
+
+        app = application.create_app(testing=True)
+        # Patching here to avoid errors in applicant.create_app
+        with mock.patch("airflow.models.Log") as mocked_log:
+            with app.test_request_context():
+                @utils.action_logging
+                def some_func():
+                    pass
+
+                some_func()
+                mocked_log.assert_called_once()
+                (args, kwargs) = mocked_log.call_args_list[0]
+                self.assertEqual('some_func', kwargs['event'])
+                self.assertEqual(fake_username, kwargs['owner'])
+                mocked_session_instance.add.assert_called_once()
+
+    @mock.patch("flask_login._get_user")
+    @mock.patch("airflow.settings.Session")
+    def test_action_logging_with_invalid_user(self, mocked_session, mocked_get_user):
+        anonymous_username = 'anonymous'
+
+        # When the user returned by flask login_manager._load_user
+        # is invalid.
+        mocked_current_user = mock.MagicMock()
+        mocked_get_user.return_value = mocked_current_user
+        mocked_current_user.user = None
+        mocked_session_instance = mock.MagicMock()
+        mocked_session.return_value = mocked_session_instance
+
+        app = application.create_app(testing=True)
+        # Patching here to avoid errors in applicant.create_app
+        with mock.patch("airflow.models.Log") as mocked_log:
+            with app.test_request_context():
+                @utils.action_logging
+                def some_func():
+                    pass
+
+                some_func()
+                mocked_log.assert_called_once()
+                (args, kwargs) = mocked_log.call_args_list[0]
+                self.assertEqual('some_func', kwargs['event'])
+                self.assertEqual(anonymous_username, kwargs['owner'])
+                mocked_session_instance.add.assert_called_once()
+
+    # flask_login.current_user would be AnonymousUserMixin
+    # when there's no user_id in the flask session.
+    @mock.patch("airflow.settings.Session")
+    def test_action_logging_with_anonymous_user(self, mocked_session):
+        anonymous_username = 'anonymous'
+
+        mocked_session_instance = mock.MagicMock()
+        mocked_session.return_value = mocked_session_instance
+
+        app = application.create_app(testing=True)
+        # Patching here to avoid errors in applicant.create_app
+        with mock.patch("airflow.models.Log") as mocked_log:
+            with app.test_request_context():
+                @utils.action_logging
+                def some_func():
+                    pass
+
+                some_func()
+                mocked_log.assert_called_once()
+                (args, kwargs) = mocked_log.call_args_list[0]
+                self.assertEqual('some_func', kwargs['event'])
+                self.assertEqual(anonymous_username, kwargs['owner'])
+                mocked_session_instance.add.assert_called_once()
+
 
 if __name__ == '__main__':
     unittest.main()

From 90f05cf3351aa3bfd1201b2906062b762417d9f9 Mon Sep 17 00:00:00 2001
From: Tao feng <tfeng@lyft.com>
Date: Tue, 26 Jun 2018 00:23:11 -0700
Subject: [PATCH 007/808] [AIRFLOW-2678] Fix db schema unit test to remove
 checking fab models

(cherry picked from commit 0c2206c7d617fe4925ece6478dd5b6caf5b179ba)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 tests/utils/test_db.py | 83 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 tests/utils/test_db.py

diff --git a/tests/utils/test_db.py b/tests/utils/test_db.py
new file mode 100644
index 0000000000000..8ddd3ef715368
--- /dev/null
+++ b/tests/utils/test_db.py
@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.models import Base as airflow_base
+
+from airflow.settings import engine
+from alembic.autogenerate import compare_metadata
+from alembic.migration import MigrationContext
+from sqlalchemy import MetaData
+
+
+class DbTest(unittest.TestCase):
+
+    def test_database_schema_and_sqlalchemy_model_are_in_sync(self):
+        all_meta_data = MetaData()
+        for (table_name, table) in airflow_base.metadata.tables.items():
+            all_meta_data._add_table(table_name, table.schema, table)
+
+        # create diff between database schema and SQLAlchemy model
+        mc = MigrationContext.configure(engine.connect())
+        diff = compare_metadata(mc, all_meta_data)
+
+        # known diffs to ignore
+        ignores = [
+            # users.password is not part of User model,
+            # otherwise it would show up in (old) UI
+            lambda t: (t[0] == 'remove_column' and
+                       t[2] == 'users' and
+                       t[3].name == 'password'),
+            # ignore tables created by other tests
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 't'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'test_airflow'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'test_postgres_to_postgres'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'test_mysql_to_mysql'),
+            # ignore tables created by celery
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'celery_taskmeta'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'celery_tasksetmeta'),
+            # Ignore all the fab tables
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_permission'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_register_user'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_role'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_permission_view'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_permission_view_role'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_user_role'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_user'),
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'ab_view_menu'),
+        ]
+        for ignore in ignores:
+            diff = [d for d in diff if not ignore(d)]
+
+        self.assertFalse(diff, 'Database schema and SQLAlchemy model are not in sync')

From acfc72e01a5dd24a86513ab93e33b8856ad0e284 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 27 Jun 2018 22:34:16 +0200
Subject: [PATCH 008/808] [AIRFLOW-2650] Mark SchedulerJob as succeed when
 hitting Ctrl-c

Without this fix it turns out that the job would
remain in the running
state.

This also sets things to failed in case of any
other exception.

Closes #3525 from ashb/scheduler-job-status

(cherry picked from commit b0061f1369636c86df87829b93d5ece582591e2a)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/jobs.py | 22 ++++++++++++++--------
 tests/jobs.py   | 42 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 55 insertions(+), 9 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index ad114abda3d6f..5143e8e73e23e 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -197,14 +197,20 @@ def run(self):
             make_transient(self)
             self.id = id_
 
-            # Run
-            self._execute()
-
-            # Marking the success in the DB
-            self.end_date = timezone.utcnow()
-            self.state = State.SUCCESS
-            session.merge(self)
-            session.commit()
+            try:
+                self._execute()
+                # In case of max runs or max duration
+                self.state = State.SUCCESS
+            except SystemExit as e:
+                # In case of ^C or SIGTERM
+                self.state = State.SUCCESS
+            except Exception as e:
+                self.state = State.FAILED
+                raise
+            finally:
+                self.end_date = timezone.utcnow()
+                session.merge(self)
+                session.commit()
 
         Stats.incr(self.__class__.__name__.lower() + '_end', 1, 1)
 
diff --git a/tests/jobs.py b/tests/jobs.py
index f534b6540aa41..5dd6ff3efda9e 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -39,7 +39,7 @@
 from airflow import AirflowException, settings, models
 from airflow.bin import cli
 from airflow.executors import BaseExecutor, SequentialExecutor
-from airflow.jobs import BackfillJob, SchedulerJob, LocalTaskJob
+from airflow.jobs import BaseJob, BackfillJob, SchedulerJob, LocalTaskJob
 from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.bash_operator import BashOperator
@@ -86,6 +86,46 @@
     os.path.dirname(os.path.realpath(__file__)), 'dags')
 
 
+class BaseJobTest(unittest.TestCase):
+    class TestJob(BaseJob):
+        __mapper_args__ = {
+            'polymorphic_identity': 'TestJob'
+        }
+
+        def __init__(self, cb):
+            self.cb = cb
+            super(BaseJobTest.TestJob, self).__init__()
+
+        def _execute(self):
+            return self.cb()
+
+    def test_state_success(self):
+        job = self.TestJob(lambda: True)
+        job.run()
+
+        self.assertEquals(job.state, State.SUCCESS)
+        self.assertIsNotNone(job.end_date)
+
+    def test_state_sysexit(self):
+        import sys
+        job = self.TestJob(lambda: sys.exit(0))
+        job.run()
+
+        self.assertEquals(job.state, State.SUCCESS)
+        self.assertIsNotNone(job.end_date)
+
+    def test_state_failed(self):
+        def abort():
+            raise RuntimeError("fail")
+
+        job = self.TestJob(abort)
+        with self.assertRaises(RuntimeError):
+            job.run()
+
+        self.assertEquals(job.state, State.FAILED)
+        self.assertIsNotNone(job.end_date)
+
+
 class BackfillJobTest(unittest.TestCase):
 
     def setUp(self):

From 2c336f0f11ff4b6c2cf80881ef54c5f65b6730e4 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Sun, 17 Jun 2018 22:17:11 +0200
Subject: [PATCH 009/808] [AIRFLOW-2604] Add index to task_fail

(cherry picked from commit d00762cb914803341c5d019d14385d249346d601)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 .../versions/9635ae0956e7_index_faskfail.py   | 44 +++++++++++++++++++
 airflow/models.py                             |  5 +++
 2 files changed, 49 insertions(+)
 create mode 100644 airflow/migrations/versions/9635ae0956e7_index_faskfail.py

diff --git a/airflow/migrations/versions/9635ae0956e7_index_faskfail.py b/airflow/migrations/versions/9635ae0956e7_index_faskfail.py
new file mode 100644
index 0000000000000..da69846233e87
--- /dev/null
+++ b/airflow/migrations/versions/9635ae0956e7_index_faskfail.py
@@ -0,0 +1,44 @@
+# flake8: noqa
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+#   http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""index-faskfail
+
+Revision ID: 9635ae0956e7
+Revises: 856955da8476
+Create Date: 2018-06-17 21:40:01.963540
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = '9635ae0956e7'
+down_revision = '856955da8476'
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+
+
+def upgrade():
+    op.create_index('idx_task_fail_dag_task_date', 'task_fail', ['dag_id', 'task_id', 'execution_date'], unique=False)
+
+
+def downgrade():
+    op.drop_index('idx_task_fail_dag_task_date', table_name='task_fail')
+
diff --git a/airflow/models.py b/airflow/models.py
index 4b7e123b66aa1..b0841e6369726 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2079,6 +2079,11 @@ class TaskFail(Base):
     end_date = Column(UtcDateTime)
     duration = Column(Float)
 
+    __table_args__ = (
+        Index('idx_task_fail_dag_task_date', dag_id, task_id, execution_date,
+              unique=False),
+    )
+
     def __init__(self, task, execution_date, start_date, end_date):
         self.dag_id = task.dag_id
         self.task_id = task.task_id

From f45a5c8ed47605974775cc89799433f5a793ee3b Mon Sep 17 00:00:00 2001
From: Tim Swast <swast@google.com>
Date: Tue, 12 Jun 2018 23:53:21 +0100
Subject: [PATCH 010/808] [AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead
 of oauth2client

* Updates the GCP hooks to use the google-auth
library and removes
  dependencies on the deprecated oauth2client
package.
* Removes inconsistent handling of the scope
parameter for different
  auth methods.

Note: using google-auth for credentials requires a
newer version of the
google-api-python-client package, so this commit
also updates the
minimum version for that.

To avoid some annoying warnings about the
discovery cache not being
supported, so disable the discovery cache
explicitly as recommend here:
https://stackoverflow.com/a/44518587/101923

Tested by running:

    nosetests
tests/contrib/operators/test_dataflow_operator.py
\
        tests/contrib/operators/test_gcs*.py \
        tests/contrib/operators/test_mlengine_*.py \
        tests/contrib/operators/test_pubsub_operator.py \
        tests/contrib/hooks/test_gcp*.py \
        tests/contrib/hooks/test_gcs_hook.py \
        tests/contrib/hooks/test_bigquery_hook.py

and also tested by running some GCP-related DAGs
locally, such as the
Dataproc DAG example at
https://cloud.google.com/composer/docs/quickstart

Closes #3488 from tswast/google-auth

(cherry picked from commit 0f4d681f6f6e15acd1399dede146e75cb688d536)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>

From 4add288ccbf296bc64e3c8cdc72a7d9d071293b6 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Wed, 27 Jun 2018 22:56:42 +0200
Subject: [PATCH 011/808] Bump beta3

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index 1bcaa55bb9507..aa28ee9f952f9 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.0beta2+incubating'
+version = '1.10.0beta3+incubating'

From 80fd3125044a62759b6ab19a046078c7f568c6a8 Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Tue, 19 Jun 2018 17:09:00 -0700
Subject: [PATCH 012/808] [AIRFLOW-2646] Fix setup.py not to install snakebite
 on Python3

setup.py has a logic to avoid installing
snakebite on Python3, but it doesn't work.
This is because the variable devel_all is
now a tuple of lists. This PR fixes
that variable to be a flat list and
makes the logic work as expected.

Closes #3522 from sekikn/AIRFLOW-2646

(cherry picked from commit 105ac150580af0a1a64bb5e0417fc57b2a0e49bb)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 setup.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a1b3b1dc6ab6c..c91750057cef0 100644
--- a/setup.py
+++ b/setup.py
@@ -223,7 +223,8 @@ def write_version(filename=os.path.join(*['airflow',
 devel_all = (sendgrid + devel + all_dbs + doc + samba + s3 + slack + crypto + oracle +
              docker + ssh + kubernetes + celery + azure_blob_storage + redis + gcp_api +
              datadog + zendesk + jdbc + ldap + kerberos + password + webhdfs + jenkins +
-             druid + pinot + segment + snowflake + elasticsearch + azure_data_lake, atlas)
+             druid + pinot + segment + snowflake + elasticsearch + azure_data_lake +
+             atlas)
 
 # Snakebite & Google Cloud Dataflow are not Python 3 compatible :'(
 if PY3:

From 54da3eaf175b0224a7d6e09f57dc6278293937d0 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Sun, 17 Jun 2018 09:52:45 +0200
Subject: [PATCH 013/808] [AIRFLOW-2606] Fix DB schema and SQLAlchemy model

* Add test that verifies that database schema and SQLAlchemy model are in sync
* Add exception for users.password that doesn't exist in model and tables created by other tests
* Add migration script to merge the two heads
* Add migration script to fix not-null constrains for MySQL that were lost by 0e2a74e0fc9f_add_time_zone_awareness
* Add migration script to fix FK constraint for existing SQLite DBs
* Enable ForeignKey support for SQLite, otherwise 2e82aab8ef20_rename_user_table won't change FK in chart and known_event tables

(cherry picked from commit 680651f0ae2a314f8e9882a6bc38f4fa3795cdbe)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/jobs.py                               |  1 +
 .../versions/05f30312d566_merge_heads.py      | 43 +++++++++
 .../856955da8476_fix_sqlite_foreign_key.py    | 90 +++++++++++++++++++
 ...433877c24_fix_mysql_not_null_constraint.py | 54 +++++++++++
 airflow/models.py                             | 22 +++--
 airflow/utils/sqlalchemy.py                   |  6 ++
 6 files changed, 207 insertions(+), 9 deletions(-)
 create mode 100644 airflow/migrations/versions/05f30312d566_merge_heads.py
 create mode 100644 airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
 create mode 100644 airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 5143e8e73e23e..70891ab4c370b 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -96,6 +96,7 @@ class BaseJob(Base, LoggingMixin):
 
     __table_args__ = (
         Index('job_type_heart', job_type, latest_heartbeat),
+        Index('idx_job_state_heartbeat', state, latest_heartbeat),
     )
 
     def __init__(
diff --git a/airflow/migrations/versions/05f30312d566_merge_heads.py b/airflow/migrations/versions/05f30312d566_merge_heads.py
new file mode 100644
index 0000000000000..78d5652679ca9
--- /dev/null
+++ b/airflow/migrations/versions/05f30312d566_merge_heads.py
@@ -0,0 +1,43 @@
+# flake8: noqa
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+#   http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""merge heads
+
+Revision ID: 05f30312d566
+Revises: 86770d1215c0, 0e2a74e0fc9f
+Create Date: 2018-06-17 10:47:23.339972
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = '05f30312d566'
+down_revision = ('86770d1215c0', '0e2a74e0fc9f')
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+
+
+def upgrade():
+    pass
+
+
+def downgrade():
+    pass
diff --git a/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py b/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
new file mode 100644
index 0000000000000..5b11dc7860ea9
--- /dev/null
+++ b/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
@@ -0,0 +1,90 @@
+# flake8: noqa
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""fix sqlite foreign key
+
+Revision ID: 856955da8476
+Revises: f23433877c24
+Create Date: 2018-06-17 15:54:53.844230
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = '856955da8476'
+down_revision = 'f23433877c24'
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+
+
+def upgrade():
+    conn = op.get_bind()
+    if conn.dialect.name == 'sqlite':
+        # Fix broken foreign-key constraint for existing SQLite DBs.
+        #
+        # Re-define tables and use copy_from to avoid reflection
+        # which would fail because referenced user table doesn't exist.
+        #
+        # Use batch_alter_table to support SQLite workaround.
+        chart_table = sa.Table('chart',
+            sa.MetaData(),
+            sa.Column('id', sa.Integer(), nullable=False),
+            sa.Column('label', sa.String(length=200), nullable=True),
+            sa.Column('conn_id', sa.String(length=250), nullable=False),
+            sa.Column('user_id', sa.Integer(), nullable=True),
+            sa.Column('chart_type', sa.String(length=100), nullable=True),
+            sa.Column('sql_layout', sa.String(length=50), nullable=True),
+            sa.Column('sql', sa.Text(), nullable=True),
+            sa.Column('y_log_scale', sa.Boolean(), nullable=True),
+            sa.Column('show_datatable', sa.Boolean(), nullable=True),
+            sa.Column('show_sql', sa.Boolean(), nullable=True),
+            sa.Column('height', sa.Integer(), nullable=True),
+            sa.Column('default_params', sa.String(length=5000), nullable=True),
+            sa.Column('x_is_date', sa.Boolean(), nullable=True),
+            sa.Column('iteration_no', sa.Integer(), nullable=True),
+            sa.Column('last_modified', sa.DateTime(), nullable=True),
+            sa.PrimaryKeyConstraint('id')
+        )
+        with op.batch_alter_table('chart', copy_from=chart_table) as batch_op:
+            batch_op.create_foreign_key('chart_user_id_fkey', 'users',
+                                        ['user_id'], ['id'])
+
+        known_event_table = sa.Table('known_event',
+            sa.MetaData(),
+            sa.Column('id', sa.Integer(), nullable=False),
+            sa.Column('label', sa.String(length=200), nullable=True),
+            sa.Column('start_date', sa.DateTime(), nullable=True),
+            sa.Column('end_date', sa.DateTime(), nullable=True),
+            sa.Column('user_id', sa.Integer(), nullable=True),
+            sa.Column('known_event_type_id', sa.Integer(), nullable=True),
+            sa.Column('description', sa.Text(), nullable=True),
+            sa.ForeignKeyConstraint(['known_event_type_id'],
+                                    ['known_event_type.id'], ),
+            sa.PrimaryKeyConstraint('id')
+        )
+        with op.batch_alter_table('chart', copy_from=known_event_table) as batch_op:
+            batch_op.create_foreign_key('known_event_user_id_fkey', 'users',
+                                        ['user_id'], ['id'])
+
+
+def downgrade():
+    # Downgrade would fail because the broken FK constraint can't be re-created.
+    pass
diff --git a/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py b/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py
new file mode 100644
index 0000000000000..44edeef0695a7
--- /dev/null
+++ b/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py
@@ -0,0 +1,54 @@
+# flake8: noqa
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+#   http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""fix mysql not null constraint
+
+Revision ID: f23433877c24
+Revises: 05f30312d566
+Create Date: 2018-06-17 10:16:31.412131
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = 'f23433877c24'
+down_revision = '05f30312d566'
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import mysql
+
+def upgrade():
+    conn = op.get_bind()
+    if conn.dialect.name == 'mysql':
+        conn.execute("SET time_zone = '+00:00'")
+        op.alter_column('task_fail', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=False)
+        op.alter_column('xcom', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=False)
+        op.alter_column('xcom', 'timestamp', existing_type=mysql.TIMESTAMP(fsp=6), nullable=False)
+
+
+def downgrade():
+    conn = op.get_bind()
+    if conn.dialect.name == 'mysql':
+        conn.execute("SET time_zone = '+00:00'")
+        op.alter_column('xcom', 'timestamp', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
+        op.alter_column('xcom', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
+        op.alter_column('task_fail', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
+
diff --git a/airflow/models.py b/airflow/models.py
index b0841e6369726..bde6137022013 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -56,7 +56,7 @@
 
 from sqlalchemy import (
     Column, Integer, String, DateTime, Text, Boolean, ForeignKey, PickleType,
-    Index, Float, LargeBinary)
+    Index, Float, LargeBinary, UniqueConstraint)
 from sqlalchemy import func, or_, and_, true as sqltrue
 from sqlalchemy.ext.declarative import declarative_base, declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
@@ -885,7 +885,7 @@ class TaskInstance(Base, LoggingMixin):
     max_tries = Column(Integer)
     hostname = Column(String(1000))
     unixname = Column(String(1000))
-    job_id = Column(Integer, index=True)
+    job_id = Column(Integer)
     pool = Column(String(50))
     queue = Column(String(50))
     priority_weight = Column(Integer)
@@ -899,6 +899,7 @@ class TaskInstance(Base, LoggingMixin):
         Index('ti_state', state),
         Index('ti_state_lkp', dag_id, task_id, execution_date, state),
         Index('ti_pool', pool, state, priority_weight),
+        Index('ti_job_id', job_id),
     )
 
     def __init__(self, task, execution_date, state=None):
@@ -2072,12 +2073,13 @@ class TaskFail(Base):
 
     __tablename__ = "task_fail"
 
-    task_id = Column(String(ID_LEN), primary_key=True)
-    dag_id = Column(String(ID_LEN), primary_key=True)
-    execution_date = Column(UtcDateTime, primary_key=True)
+    id = Column(Integer, primary_key=True)
+    task_id = Column(String(ID_LEN), nullable=False)
+    dag_id = Column(String(ID_LEN), nullable=False)
+    execution_date = Column(UtcDateTime, nullable=False)
     start_date = Column(UtcDateTime)
     end_date = Column(UtcDateTime)
-    duration = Column(Float)
+    duration = Column(Integer)
 
     __table_args__ = (
         Index('idx_task_fail_dag_task_date', dag_id, task_id, execution_date,
@@ -4670,8 +4672,8 @@ class DagStat(Base):
 
     dag_id = Column(String(ID_LEN), primary_key=True)
     state = Column(String(50), primary_key=True)
-    count = Column(Integer, default=0)
-    dirty = Column(Boolean, default=False)
+    count = Column(Integer, default=0, nullable=False)
+    dirty = Column(Boolean, default=False, nullable=False)
 
     def __init__(self, dag_id, state, count=0, dirty=False):
         self.dag_id = dag_id
@@ -4804,7 +4806,9 @@ class DagRun(Base, LoggingMixin):
     dag = None
 
     __table_args__ = (
-        Index('dr_run_id', dag_id, run_id, unique=True),
+        Index('dag_id_state', dag_id, _state),
+        UniqueConstraint('dag_id', 'execution_date'),
+        UniqueConstraint('dag_id', 'run_id'),
     )
 
     def __repr__(self):
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index a00fe17c18a48..4dab322d4a106 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -101,6 +101,12 @@ def ping_connection(connection, branch):
     def connect(dbapi_connection, connection_record):
         connection_record.info['pid'] = os.getpid()
 
+    @event.listens_for(engine, "connect")
+    def set_sqlite_pragma(dbapi_connection, connection_record):
+        if 'sqlite3.Connection' in str(type(dbapi_connection)):
+            cursor = dbapi_connection.cursor()
+            cursor.execute("PRAGMA foreign_keys=ON")
+            cursor.close()
 
     @event.listens_for(engine, "checkout")
     def checkout(dbapi_connection, connection_record, connection_proxy):

From 9b0136772c5bc64e912872ec14c8eb65d378668e Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sun, 1 Jul 2018 11:54:56 +0200
Subject: [PATCH 014/808] Bump version

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index aa28ee9f952f9..b8170040b4a8f 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.0beta3+incubating'
+version = '1.10.0beta4+incubating'

From f65507fcd4632c9050d10e0911e00e8f5c6557b1 Mon Sep 17 00:00:00 2001
From: Matthew Thorley <mthorley@nav.com>
Date: Sun, 8 Jul 2018 20:52:51 +0200
Subject: [PATCH 015/808] [AIRFLOW-2710] Clarify fernet key value in
 documentation

Closes #3574 from padwasabimasala/AIRFLOW-2710

(cherry picked from commit 6b7645261b5df69b01936838f38f7f701a667518)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 docs/howto/secure-connections.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index b9c1fa10048f5..f9e252c4c365a 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -16,7 +16,7 @@ connections by following steps below:
 
     from cryptography.fernet import Fernet
     fernet_key= Fernet.generate_key()
-    print(fernet_key) # your fernet_key, keep it in secured place!
+    print(fernet_key.decode()) # your fernet_key, keep it in secured place!
 
 3. Replace ``airflow.cfg`` fernet_key value with the one from step 2.
 Alternatively, you can store your fernet_key in OS environment variable. You

From 3dedeeab0bfabcdafc0ef104cf540bdf959115e7 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sun, 8 Jul 2018 21:15:22 +0200
Subject: [PATCH 016/808] Bump version

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index b8170040b4a8f..02346d56fdef0 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.0beta4+incubating'
+version = '1.10.0+incubating'

From 26ea12a1622d9a42701c3fe49afa80465244063e Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sun, 8 Jul 2018 21:49:35 +0200
Subject: [PATCH 017/808] Update changelog

---
 CHANGELOG.txt | 775 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 775 insertions(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index fa4e6547a7e1d..00ee4a615ed0a 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,3 +1,778 @@
+AIRFLOW 1.10.0, 2018-07-08
+--------------------------
+
+[AIRFLOW-2710] Clarify fernet key value in documentation
+[AIRFLOW-2606] Fix DB schema and SQLAlchemy model
+[AIRFLOW-2646] Fix setup.py not to install snakebite on Python3
+[AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead of oauth2client
+[AIRFLOW-2604] Add index to task_fail
+[AIRFLOW-2650] Mark SchedulerJob as succeed when hitting Ctrl-c
+[AIRFLOW-2678] Fix db schema unit test to remove checking fab models
+[AIRFLOW-2624] Fix webserver login as anonymous
+[AIRFLOW-2654] Fix incorret URL on refresh in Graph View of FAB UI
+[AIRFLOW-2668] Handle missing optional cryptography dependency
+[AIRFLOW-2681] Include last dag run of externally triggered DAGs in UI.
+[AIRFLOW-1840] Support back-compat on old celery config
+[AIRFLOW-2612][AIRFLOW-2534] Clean up Hive-related tests
+[AIRFLOW-2608] Implements/Standardize custom exceptions for experimental APIs
+[AIRFLOW-2607] Fix failing TestLocalClient
+[AIRFLOW-2638] dbapi_hook: support REPLACE INTO
+[AIRFLOW-2542][AIRFLOW-1790] Rename AWS Batch Operator queue to job_queue
+[AIRFLOW-2567] Extract result from the kubernetes pod as Xcom
+[AIRFLOW-XXX] Adding REA Group to readme
+[AIRFLOW-2601] Allow user to specify k8s config
+[AIRFLOW-2559] Azure Fileshare hook
+[AIRFLOW-1786] Enforce correct behavior for soft-fail sensors
+[AIRFLOW-2355] Airflow trigger tag parameters in subdag
+[AIRFLOW-2613] Fix Airflow searching .zip bug
+[AIRFLOW-2627] Add a sensor for Cassandra
+[AIRFLOW-2634][AIRFLOW-2534] Remove dependency for impyla
+[AIRFLOW-2611] Fix wrong dag volume mount path for kubernetes executor
+[AIRFLOW-2562] Add Google Kubernetes Engine Operators
+[AIRFLOW-2630] Fix classname in test_sql_sensor.py
+[AIRFLOW-2534] Fix bug in HiveServer2Hook
+[AIRFLOW-2586] Stop getting AIRFLOW_HOME value from config file in bash operator
+[AIRFLOW-2605] Fix autocommit for MySqlHook
+[AIRFLOW-2539][AIRFLOW-2359] Move remaing log config to configuration file
+[AIRFLOW-1656] Tree view dags query changed
+[AIRFLOW-2617] add imagePullPolicy config for kubernetes executor
+[AIRFLOW-2429] Fix security/task/sensors/ti_deps folders flake8 error
+[AIRFLOW-2550] Implements API endpoint to list DAG runs
+[AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead of oauth2client
+[AIRFLOW-2429] Fix operators folder flake8 error
+[AIRFLOW-2585] Fix several bugs in CassandraHook and CassandraToGCSOperator
+[AIRFLOW-2597] Restore original dbapi.run() behavior
+[AIRFLOW-2590] Fix commit in DbApiHook.run() for no-autocommit DB
+[AIRFLOW-1115] fix github oauth api URL
+[AIRFLOW-2587] Add TIMESTAMP type mapping to MySqlToHiveTransfer
+[AIRFLOW-2591][AIRFLOW-2581] Set default value of autocommit to False in DbApiHook.run()
+[AIRFLOW-59] Implement bulk_dump and bulk_load for the Postgres hook
+[AIRFLOW-2533] Fix path to DAG's on kubernetes executor workers
+[AIRFLOW-2581] RFLOW-2581] Fix DbApiHook autocommit
+[AIRFLOW-2578] Add option to use proxies in JiraHook
+[AIRFLOW-2575] Make gcs to gcs operator work with large files
+[AIRFLOW-437] Send TI context in kill zombies
+[AIRFLOW-2566] Change backfill to rerun failed tasks
+[AIRFLOW-1021] Fix double login for new users with LDAP
+[AIRFLOW-XXX] Typo fix
+[AIRFLOW-2561] Fix typo in EmailOperator
+[AIRFLOW-2573] Cast BigQuery TIMESTAMP field to float
+[AIRFLOW-2560] Adding support for internalIpOnly to DataprocClusterCreateOperator
+[AIRFLOW-2565] templatize cluster_label
+[AIRFLOW-83] add mongo hook and operator
+[AIRFLOW-2558] Clear task/dag is clearing all executions
+[AIRFLOW-XXX] Fix doc typos
+[AIRFLOW-2513] Change `bql` to `sql` for BigQuery Hooks & Ops
+[AIRFLOW-2557] Fix pagination for s3
+[AIRFLOW-2545] Eliminate DeprecationWarning
+[AIRFLOW-2500] Fix MySqlToHiveTransfer to transfer unsigned type properly
+[AIRFLOW-2462] Change PasswordUser setter to correct syntax
+[AIRFLOW-2525] Fix a bug introduced by commit dabf1b9
+[AIRFLOW-2553] Add webserver.pid to .gitignore
+[AIRFLOW-1863][AIRFLOW-2529] Add dag run selection widgets to gantt view
+[AIRFLOW-2504] Log username correctly and add extra to search columns
+[AIRFLOW-2551] Encode binary data with base64 standard rather than base64 url
+[AIRFLOW-2537] Add reset-dagrun option to backfill command
+[AIRFLOW-2526] dag_run.conf can override params
+[AIRFLOW-2544][AIRFLOW-1967] Guard against next major release of Celery, Flower
+[AIRFLOW-XXX] Add Yieldr to who is using airflow
+[AIRFLOW-2547] Describe how to run tests using Docker
+[AIRFLOW-2538] Update faq doc on how to reduce airflow scheduler latency
+[AIRFLOW-2529] Improve graph view performance and usability
+[AIRFLOW-2517] backfill support passing key values through CLI
+[AIRFLOW-2532] Support logs_volume_subpath for KubernetesExecutor
+[AIRFLOW-2466] consider task_id in _change_state_for_tis_without_dagrun
+[AIRFLOW-2519] Fix CeleryExecutor with SQLAlchemy
+[AIRFLOW-2402] Fix RBAC task log
+[AIRFLOW-XXX] Add M4U to user list
+[AIRFLOW-2536] docs about how to deal with airflow initdb failure
+[AIRFLOW-2530] KubernetesOperator supports multiple clusters
+[AIRFLOW-1499] Eliminate duplicate and unneeded code
+[AIRFLOW-2521] backfill - make variable name and logging messages more acurate
+[AIRFLOW-2429] Fix hook, macros folder flake8 error
+[Airflow-XXX] add Prime to company list
+[AIRFLOW-2525] Fix PostgresHook.copy_expert to work with "COPY FROM"
+[AIRFLOW-2515] Add dependency on thrift_sasl to hive extra
+[AIRFLOW-2523] Add how-to for managing GCP connections
+[AIRFLOW-2510] Introduce new macros: prev_ds and next_ds
+[AIRFLOW-1730] Unpickle value of XCom queried from DB
+[AIRFLOW-2518] Fix broken ToC links in integration.rst
+[AIRFLOW-1472] Fix SLA misses triggering on skipped tasks.
+[AIRFLOW-2520] CLI - make backfill less verbose
+[AIRFLOW-2107] add time_partitioning to run_query on BigQueryBaseCursor
+[AIRFLOW-1057][AIRFLOW-1380][AIRFLOW-2362][2362] AIRFLOW Update DockerOperator to new API
+[AIRFLOW-2415] Make airflow DAG templating render numbers
+[AIRFLOW-2473] Fix wrong skip condition for TransferTests
+[AIRFLOW-2472] Implement MySqlHook.bulk_dump
+[AIRFLOW-2419] Use default view for subdag operator
+[AIRFLOW-2498] Fix Unexpected argument in SFTP Sensor
+[AIRFLOW-2509] Separate config docs into how-to guides
+[AIRFLOW-2429] Add BaseExecutor back
+[AIRFLOW-2429] Fix dag, example_dags, executors flake8 error
+[AIRFLOW-2502] Change Single triple quotes to double for docstrings
+[AIRFLOW-2503] Fix broken links in CONTRIBUTING.md
+[AIRFLOW-2501] Refer to devel instructions in docs contrib guide
+[AIRFLOW-2429] Fix contrib folder's flake8 errors
+[AIRFLOW-2471] Fix HiveCliHook.load_df to use unused parameters
+[AIRFLOW-2495] Update celery to 4.1.1
+[AIRFLOW-2429] Fix api, bin, config_templates folders flake8 error
+[AIRFLOW-2493] Mark template_fields of all Operators in the API document as "templated"
+[AIRFLOW-2489] Update FlaskAppBuilder to 1.11.1
+[AIRFLOW-2448] Enhance HiveCliHook.load_df to work with datetime
+[AIRFLOW-2487] Enhance druid ingestion hook
+[AIRFLOW-2397] Support affinity policies for Kubernetes executor/operator
+[AIRFLOW-2482] Add test for rewrite method in GCS Hook
+[AIRFLOW-2481] Fix flaky Kubernetes test
+[AIRFLOW-2479] Improve doc FAQ section
+[AIRFLOW-2485] Fix Incorrect logging for Qubole Sensor
+[AIRFLOW-2486] Remove unnecessary slash after port
+[AIRFLOW-2429] Make Airflow flake8 compliant
+[AIRFLOW-2491] Resolve flask version conflict
+[AIRFLOW-2484] Remove duplicate key in MySQL to GCS Op
+[ARIFLOW-2458] Add cassandra-to-gcs operator
+[AIRFLOW-2477] Improve time units for task duration and landing times charts for RBAC UI
+[AIRFLOW-2474] Only import snakebite if using py2
+[AIRFLOW-48] Parse connection uri querystring
+[AIRFLOW-2467][AIRFLOW-2] Update import direct warn message to use the module name
+[AIRFLOW-XXX] Fix order of companies
+[AIRFLOW-2452] Document field_dict must be OrderedDict
+[AIRFLOW-2420] Azure Data Lake Hook
+[AIRFLOW-2213] Add Quoble check operator
+[AIRFLOW-2465] Fix wrong module names in the doc
+[AIRFLOW-1929] Modifying TriggerDagRunOperator to accept execution_date
+[AIRFLOW-2460] Users can now use volume mounts and volumes
+[AIRFLOW-2110][AIRFLOW-2122] Enhance Http Hook
+[AIRFLOW-XXX] Updated contributors list
+[AIRFLOW-2435] Add launch_type to ECSOperator to allow FARGATE
+[AIRFLOW-2451] Remove extra slash ('/') char when using wildcard in gcs_to_gcs operator
+[AIRFLOW-2461] Add support for cluster scaling on dataproc operator
+[AIRFLOW-2376] Fix no hive section error
+[AIRFLOW-2425] Add lineage support
+[AIRFLOW-2430] Extend query batching to additional slow queries
+[AIRFLOW-2453] Add default nil value for kubernetes/git_subpath
+[AIRFLOW-2396] Add support for resources in kubernetes operator
+[AIRFLOW-2169] Encode binary data with base64 before importing to BigQuery
+[AIRFLOW-XXX] Add spotahome in user list
+[AIRFLOW-2457] Update FAB version requirement
+[AIRFLOW-2454][Airflow 2454] Support imagePullPolicy for k8s
+[AIRFLOW-2450] update supported k8s versions to 1.9 and 1.10
+[AIRFLOW-2333] Add Segment Hook and TrackEventOperator
+[AIRFLOW-2442][AIRFLOW-2] Airflow run command leaves database connections open
+[AIRFLOW-2016] assign template_fields for Dataproc Workflow Template sub-classes, not base class
+[AIRFLOW-2446] Add S3ToRedshiftTransfer into the "Integration" doc
+[AIRFLOW-2449] Fix operators.py to run all test cases
+[AIRFLOW-2424] Add dagrun status endpoint and increased k8s test coverage
+[AIRFLOW-2441] Fix bugs in HiveCliHook.load_df
+[AIRFLOW-2358][AIRFLOW-201804] Make the Kubernetes example optional
+[AIRFLOW-2436] Remove cli_logger in initdb
+[AIRFLOW-2444] Remove unused option(include_adhoc) in cli backfill command
+[AIRFLOW-2447] Fix TestHiveMetastoreHook to run all cases
+[AIRFLOW-2445] Allow templating in kubernetes operator
+[AIRFLOW-2086][AIRFLOW-2393] Customize default dagrun number in tree view
+[AIRFLOW-2437] Add PubNub to list of current airflow users
+[AIRFLOW-XXX] Add Quantopian to list of Airflow users
+[AIRFLOW-1978] Add WinRM windows operator and hook
+[AIRFLOW-2427] Add tests to named hive sensor
+[AIRFLOW-2412] Fix HiveCliHook.load_file to address HIVE-10541
+[AIRFLOW-2431] Add the navigation bar color parameter for RBAC UI
+[AIRFLOW-2407] Resolve Python undefined names
+[AIRFLOW-1952] Add the navigation bar color parameter
+[AIRFLOW-2222] Implement GoogleCloudStorageHook.rewrite
+[AIRFLOW-2426] Add Google Cloud Storage Hook tests
+[AIRFLOW-2418] Bump Flask-WTF
+[AIRFLOW-2417] Wait for pod is not running to end task
+[AIRFLOW-1914] Add other charset support to email utils
+[AIRFLOW-XXX] Update README.md with Craig@Work
+[AIRFLOW-1899] Fix Kubernetes tests
+[AIRFLOW-1812] Update logging example
+[AIRFLOW-2313] Add TTL parameters for Dataproc
+[AIRFLOW-2411] add dataproc_jars to templated_fields
+[AIRFLOW-XXX] Add Reddit to Airflow users
+[AIRFLOW-XXX] Fix wrong table header in scheduler.rst
+[AIRFLOW-2409] Supply password as a parameter
+[AIRFLOW-2410][AIRFLOW-75] Set the timezone in the RBAC Web UI
+[AIRFLOW-2394] default cmds and arguments in kubernetes operator
+[AIRFLOW-2406] Add Apache2 License Shield to Readme
+[AIRFLOW-2404] Add additional documentation for unqueued task
+[AIRFLOW-2400] Add Ability to set Environment Variables for K8s
+[AIRFLOW-XXX] Add Twine Labs as an Airflow user
+[AIRFLOW-1853] Show only the desired number of runs in tree view
+[AIRFLOW-2401] Document the use of variables in Jinja template
+[AIRFLOW-2403] Fix License Headers
+[AIRFLOW-1313] Fix license header
+[AIRFLOW-2398] Add BounceX to list of current airflow users
+[AIRFLOW-2363] Fix return type bug in TaskHandler
+[AIRFLOW-2389] Create a pinot db api hook
+[AIRFLOW-2390] Resolve FlaskWTFDeprecationWarning
+[AIRFLOW-1933] Fix some typos
+[AIRFLOW-1960] Add support for secrets in kubernetes operator
+[AIRFLOW-1313] Add vertica_to_mysql operator
+[AIRFLOW-1575] Add AWS Kinesis Firehose Hook for inserting batch records
+[AIRFLOW-2266][AIRFLOW-2343] Remove google-cloud-dataflow dependency
+[AIRFLOW-2370] Implement --use_random_password in create_user
+[AIRFLOW-2348] Strip path prefix from the destination_object when source_object contains a wildcard[]
+[AIRFLOW-2391] Fix to Flask 0.12.2
+[AIRFLOW-2381] Fix the flaky ApiPasswordTests test
+[AIRFLOW-2378] Add Groupon to list of current users
+[AIRFLOW-2382] Fix wrong description for delimiter
+[AIRFLOW-2380] Add support for environment variables in Spark submit operator.
+[AIRFLOW-2377] Improve Sendgrid sender support
+[AIRFLOW-2331] Support init action timeout on dataproc cluster create
+[AIRFLOW-1835] Update docs: Variable file is json
+[AIRFLOW-1781] Make search case-insensitive in LDAP group
+[AIRFLOW-2042] Fix browser menu appearing over the autocomplete menu
+[AIRFLOW-XXX] Remove wheelhouse files from travis not owned by travis
+[AIRFLOW-2336] Use hmsclient in hive_hook
+[AIRFLOW-2041] Correct Syntax in python examples
+[AIRFLOW-74] SubdagOperators can consume all celeryd worker processes
+[AIRFLOW-2369] Fix gcs tests
+[AIRFLOW-2365] Fix autocommit attribute check
+[AIRFLOW-2068] MesosExecutor allows optional Docker image
+[AIRFLOW-1652] Push DatabricksRunSubmitOperator metadata into XCOM
+[AIRFLOW-2234] Enable insert_rows for PrestoHook
+[AIRFLOW-2208][Airflow-22208] Link to same DagRun graph from TaskInstance view
+[AIRFLOW-1153] Allow HiveOperators to take hiveconfs
+[AIRFLOW-775] Fix autocommit settings with Jdbc hook
+[AIRFLOW-2364] Warn when setting autocommit on a connection which does not support it
+[AIRFLOW-2357] Add persistent volume for the logs
+[AIRFLOW-766] Skip conn.commit() when in Auto-commit
+[AIRFLOW-2351] Check for valid default_args start_date
+[AIRFLOW-1433] Set default rbac to initdb
+[AIRFLOW-2270] Handle removed tasks in backfill
+[AIRFLOW-2344] Fix `connections -l` to work with pipe/redirect
+[AIRFLOW-2300] Add S3 Select functionarity to S3ToHiveTransfer
+[AIRFLOW-1314] Cleanup the config
+[AIRFLOW-1314] Polish some of the Kubernetes docs/config
+[AIRFLOW-1314] Improve error handling
+[AIRFLOW-1999] Add per-task GCP service account support
+[AIRFLOW-1314] Rebasing against master
+[AIRFLOW-1314] Small cleanup to address PR comments (#24)
+[AIRFLOW-1314] Add executor_config and tests
+[AIRFLOW-1314] Improve k8s support
+[AIRFLOW-1314] Use VolumeClaim for transporting DAGs
+[AIRFLOW-1314] Create integration testing environment
+[AIRFLOW-1314] Git Mode to pull in DAGs for Kubernetes Executor
+[AIRFLOW-1314] Add support for volume mounts & Secrets in Kubernetes Executor
+[AIRFLOW=1314] Basic Kubernetes Mode
+[AIRFLOW-2326][AIRFLOW-2222] remove contrib.gcs_copy_operator
+[AIRFLOW-2328] Fix empty GCS blob in S3ToGoogleCloudStorageOperator
+[AIRFLOW-2350] Fix grammar in UPDATING.md
+[AIRFLOW-2302] Fix documentation
+[AIRFLOW-2345] pip is not used in this setup.py
+[AIRFLOW-2347] Add Banco de Formaturas to Readme
+[AIRFLOW-2346] Add Investorise as official user of Airflow
+[AIRFLOW-2330] Do not append destination prefix if not given
+[AIRFLOW-2240][DASK] Added TLS/SSL support for the dask-distributed scheduler.
+[AIRFLOW-2309] Fix duration calculation on TaskFail
+[AIRFLOW-2335] fix issue with jdk8 download for ci
+[AIRFLOW-2184] Add druid_checker_operator
+[AIRFLOW-2299] Add S3 Select functionarity to S3FileTransformOperator
+[AIRFLOW-2254] Put header as first row in unload
+[AIRFLOW-610] Respect _cmd option in config before defaults
+[AIRFLOW-2287] Fix incorrect ASF headers
+[AIRFLOW-XXX] Add Zego as an Apache Airflow user
+[AIRFLOW-952] fix save empty extra field in UI
+[AIRFLOW-1325] Add ElasticSearch log handler and reader
+[AIRFLOW-2301] Sync files of an S3 key with a GCS path
+[AIRFLOW-2293] Fix S3FileTransformOperator to work with boto3
+[AIRFLOW-3212][AIRFLOW-2314] Remove only leading slash in GCS path
+[AIRFLOW-1509][AIRFLOW-442] SFTP Sensor
+[AIRFLOW-2291] Add optional params to ML Engine
+[AIRFLOW-1774] Allow consistent templating of arguments in MLEngineBatchPredictionOperator
+[AIRFLOW-2302] Add missing operators and hooks
+[AIRFLOW-2312] Docs Typo Correction: Corresponding
+[AIRFLOW-1623] Trigger on_kill method in operators
+[AIRFLOW-2162] When impersonating another user, pass env variables to sudo
+[AIRFLOW-2304] Update quickstart doc to mention scheduler part
+[AIRFLOW-1633] docker_operator needs a way to set shm_size
+[AIRFLOW-1340] Add S3 to Redshift transfer operator
+[AIRFLOW-2303] Lists the keys inside an S3 bucket
+[AIRFLOW-2209] restore flask_login imports
+[AIRFLOW-2306] Add Bonnier Broadcasting to list of current users
+[AIRFLOW-2305][AIRFLOW-2027] Fix CI failure caused by []
+[AIRFLOW-2281] Add support for Sendgrid categories
+[AIRFLOW-2027] Only trigger sleep in scheduler after all files have parsed
+[AIRFLOW-2256] SparkOperator: Add Client Standalone mode and retry mechanism
+[AIRFLOW-2284] GCS to S3 operator
+[AIRFLOW-2287] Update license notices
+[AIRFLOW-2296] Add Cinimex DataLab to Readme
+[AIRFLOW-2298] Add Kalibrr to who uses airflow
+[AIRFLOW-2292] Fix docstring for S3Hook.get_wildcard_key
+[AIRFLOW-XXX] Update PR template
+[AIRFLOW-XXX] Remove outdated migrations.sql
+[AIRFLOW-2287] Add license header to docs/Makefile
+[AIRFLOW-2286] Add tokopedia to the readme
+[AIRFLOW-2273] Add Discord webhook operator/hook
+[AIRFLOW-2282] Fix grammar in UPDATING.md
+[AIRFLOW-2200] Add snowflake operator with tests
+[AIRFLOW-2178] Add handling on SLA miss errors
+[AIRFLOW-2169] Fix type 'bytes' is not JSON serializable in python3
+[AIRFLOW-2215] Pass environment to subproces.Popen in base_task_runner
+[AIRFLOW-2253] Add Airflow CLI instrumentation
+[AIRFLOW-2274] Fix Dataflow tests
+[AIRFLOW-2269] Add Custom Ink as an Airflow user
+[AIRFLOW-2259] Dataflow Hook Index out of range
+[AIRFLOW-2233] Update updating.md to include the info of hdfs_sensors renaming
+[AIRFLOW-2217] Add Slack webhook operator
+[AIRFLOW-1729] improve dagBag time
+[AIRFLOW-2264] Improve create_user cli help message
+[AIRFLOW-2260] [AIRFLOW-2260] SSHOperator add command template .sh files
+[AIRFLOW-2261] Check config/env for remote base log folder
+[AIRFLOW-2258] Allow import of Parquet-format files into BigQuery
+[AIRFLOW-1430] Include INSTALL instructions to avoid GPL
+[AIRFLOW-1430] Solve GPL dependency
+[AIRFLOW-2251] Add Thinknear as an Airflow user
+[AIRFLOW-2244] bugfix: remove legacy LongText code from models.py
+[AIRFLOW-2247] Fix RedshiftToS3Transfer not to fail with ValueError
+[AIRFLOW-2249] Add side-loading support for Zendesk Hook
+[AIRFLOW-XXX] Add Qplum to Airflow users
+[AIRFLOW-2228] Enhancements in ValueCheckOperator
+[AIRFLOW-1206] Typos
+[AIRFLOW-2060] Update pendulum version to 1.4.4
+[AIRFLOW-2248] Fix wrong param name in RedshiftToS3Transfer doc
+[AIRFLOW-1433][AIRFLOW-85] New Airflow Webserver UI with RBAC support
+[AIRFLOW-1235] Fix webserver's odd behaviour
+[AIRFLOW-1460] Allow restoration of REMOVED TI's
+[airflow-2235] Fix wrong docstrings in two operators
+[AIRFLOW-XXX] Fix chronological order for companies using Airflow
+[AIRFLOW-2124] Upload Python file to a bucket for Dataproc
+[AIRFLOW-2212] Fix ungenerated sensor API reference
+[AIRFLOW-2226] Rename google_cloud_storage_default to google_cloud_default
+[AIRFLOW-2211] Rename hdfs_sensors.py to hdfs_sensor.py for consistency
+[AIRFLOW-2225] Update document to include DruidDbApiHook
+[Airflow-2202] Add filter support in HiveMetastoreHook().max_partition()
+[AIRFLOW-2220] Remove duplicate numeric list entry in security.rst
+[AIRFLOW-XXX] Update tutorial documentation
+[AIRFLOW-2215] Update celery task to preserve environment variables and improve logging on exception
+[AIRFLOW-2185] Use state instead of query param
+[AIRFLOW-2183] Refactor DruidHook to enable sql
+[AIRFLOW-2203] Defer cycle detection
+[AIRFLOW-2203] Remove Useless Commands.
+[AIRFLOW-2203] Cache signature in apply_defaults
+[AIRFLOW-2203] Speed up Operator Resources
+[AIRFLOW-2203] Cache static rules (trigger/weight)
+[AIRFLOW-2203] Store task ids as sets not lists
+[AIRFLOW-2205] Remove unsupported args from JdbcHook doc
+[AIRFLOW-2207] Fix flaky test that uses app.cached_app()
+[AIRFLOW-2206] Remove unsupported args from JdbcOperator doc
+[AIRFLOW-2140] Add Kubernetes scheduler to SparkSubmitOperator
+[AIRFLOW-XXX] Add Xero to list of users
+[AIRFLOW-2204] Fix webserver debug mode
+[AIRFLOW-102] Fix test_complex_template always succeeds
+[AIRFLOW-442] Add SFTPHook
+[AIRFLOW-2169] Add schema to MySqlToGoogleCloudStorageOperator
+[AIRFLOW-2184][AIRFLOW-2138] Google Cloud Storage allow wildcards
+[AIRFLOW-1588] Cast Variable value to string
+[AIRFLOW-2199] Fix invalid reference to logger
+[AIRFLOW-2191] Change scheduler heartbeat logs from info to debug
+[AIRFLOW-2106] SalesForce hook sandbox option
+[AIRFLOW-2197] Silence hostname_callable config error message
+[AIRFLOW-2150] Use lighter call in HiveMetastoreHook().max_partition()
+[AIRFLOW-2186] Change the way logging is carried out in few ops
+[AIRFLOW-2181] Convert password_auth and test_password_endpoints from DOS to UNIX
+[AIRFLOW-2187] Fix Broken Travis CI due to AIRFLOW-2123
+[AIRFLOW-2175] Check that filepath is not None
+[AIRFLOW-2173] Don't check task IDs for concurrency reached check
+[AIRFLOW-2168] Remote logging for Azure Blob Storage
+[AIRFLOW-XXX] Add DocuTAP to list of users
+[AIRFLOW-2176] Change the way logging is carried out in BQ Get Data Operator
+[AIRFLOW-2177] Add mock test for GCS Download op
+[AIRFLOW-2123] Install CI dependencies from setup.py
+[AIRFLOW-2129] Presto hook calls _parse_exception_message but defines _get_pretty_exception_message
+[AIRFLOW-2174] Fix typos and wrongly rendered documents
+[AIRFLOW-2171] Store delegated credentials
+[AIRFLOW-2166] Restore BQ run_query dialect param
+[AIRFLOW-2163] Add HBC Digital to users of airflow
+[AIRFLOW-2065] Fix race-conditions when creating loggers
+[AIRFLOW-2147] Plugin manager: added 'sensors' attribute
+[AIRFLOW-2059] taskinstance query is awful, un-indexed, and does not scale
+[AIRFLOW-2159] Fix a few typos in salesforce_hook
+[AIRFLOW-2132] Add step to initialize database
+[AIRFLOW-2160] Fix bad rowid deserialization
+[AIRFLOW-2161] Add Vevo to list of companies using Airflow
+[AIRFLOW-2149] Add link to apache Beam documentation to create self executing Jar
+[AIRFLOW-2151] Allow getting the session from AwsHook
+[AIRFLOW-2097] tz referenced before assignment
+[AIRFLOW-2152] Add Multiply to list of companies using Airflow
+[AIRFLOW-1551] Add operator to trigger Jenkins job
+[AIRFLOW-2034] Fix mixup between %s and {} when using str.format Convention is to use .format for string formating oustide logging, else use lazy format See comment in related issue https://github.com/apache/incubator-airflow/pull/2823/files Identified problematic case using following command line .git/COMMIT_EDITMSG:`grep -r '%s'./* | grep '\.format('`
+[AIRFLOW-2102] Add custom_args to Sendgrid personalizations
+[AIRFLOW-1035][AIRFLOW-1053] import unicode_literals to parse Unicode in HQL
+[AIRFLOW-2127] Keep loggers during DB migrations
+[AIRFLOW-2146] Resolve issues with BQ using DbApiHook methods
+[AIRFLOW-2087] Scheduler Report shows incorrect Total task number
+[AIRFLOW-2139] Remove unncecessary boilerplate to get DataFrame using pandas_gbq
+[AIRFLOW-2125] Using binary package psycopg2-binary
+[AIRFLOW-2142] Include message on mkdir failure
+[AIRFLOW-1615] SSHHook: use port specified by Connection
+[AIRFLOW-2122] Handle boolean values in sshHook
+[AIRFLOW-XXX] Add Tile to the list of users
+[AIRFLOW-2130] Add missing Operators to API Reference docs
+[AIRFLOW-XXX] Add timeout units (seconds)
+[AIRFLOW-2134] Add Alan to the list of companies that use Airflow
+[AIRFLOW-2133] Remove references to GitHub issues in CONTRIBUTING
+[AIRFLOW-2131] Remove confusing AirflowImport docs
+[AIRFLOW-1852] Allow hostname to be overridable.
+[AIRFLOW-2126] Add Bluecore to active users
+[AIRFLOW-1618] Add feature to create GCS bucket
+[AIRFLOW-2108] Fix log indentation in BashOperator
+[AIRFLOW-2115] Fix doc links to PythonHosted
+[AIRFLOW-XXX] Add contributor from Easy company
+[AIRFLOW-1882] Add ignoreUnknownValues option to gcs_to_bq operator
+[AIRFLOW-2089] Add on kill for SparkSubmit in Standalone Cluster
+[AIRFLOW-2113] Address missing DagRun callbacks Given that the handle_callback method belongs to the DAG object, we are able to get the list of task directly with get_task and reduce the communication with the database, making airflow more lightweight.
+[AIRFLOW-2112] Fix svg width for Recent Tasks on UI.
+[AIRFLOW-2116] Set CI Cloudant version to <2.0
+[AIRFLOW-XXX] Add PMC to list of companies using Airflow
+[AIRFLOW-2100] Fix Broken Documentation Links
+[AIRFLOW-1404] Add 'flatten_results' & 'maximum_bytes_billed' to BQ Operator
+[AIRFLOW-800] Initialize valid Google BigQuery Connection
+[AIRFLOW-1319] Fix misleading SparkSubmitOperator and SparkSubmitHook docstring
+[AIRFLOW-1983] Parse environment parameter as template
+[AIRFLOW-2095] Add operator to create External BigQuery Table
+[AIRFLOW-2085] Add SparkJdbc operator
+[AIRFLOW-1002] Add ability to clean all dependencies of removed DAG
+[AIRFLOW-2094] Jinjafied project_id, region & zone in DataProc{*} Operators
+[AIRFLOW-2092] Fixed incorrect parameter in docstring for FTPHook
+[AIRFLOW-XXX] Add SocialCops to Airflow users
+[AIRFLOW-2088] Fix duplicate keys in MySQL to GCS Helper function
+[AIRFLOW-2091] Fix incorrect docstring parameter in BigQuery Hook
+[AIRFLOW-2090] Fix typo in DataStore Hook
+[AIRFLOW-1157] Fix missing pools crashing the scheduler
+[AIRFLOW-713] Jinjafy {EmrCreateJobFlow,EmrAddSteps}Operator attributes
+[AIRFLOW-2083] Docs: Use "its" instead of "it's" where appropriate
+[AIRFLOW-2066] Add operator to create empty BQ table
+[AIRFLOW-XXX] add Karmic to list of companies
+[AIRFLOW-2073] Make FileSensor fail when the file doesn't exist
+[AIRFLOW-2078] Improve task_stats and dag_stats performance
+[AIRFLOW-2080] Use a log-out icon instead of a power button
+[AIRFLOW-2077] Fetch all pages of list_objects_v2 response
+[AIRFLOW-XXX] Add TM to list of companies
+[AIRFLOW-1985] Impersonation fixes for using `run_as_user`
+[AIRFLOW-2018][AIRFLOW-2] Make Sensors backward compatible
+[AIRFLOW-XXX] Fix typo in concepts doc (dag_md)
+[AIRFLOW-2069] Allow Bytes to be uploaded to S3
+[AIRFLOW-2074] Fix log var name in GHE auth
+[AIRFLOW-1927] Convert naive datetimes for TaskInstances
+[AIRFLOW-1760] Password auth for experimental API
+[AIRFLOW-2038] Add missing kubernetes dependency for dev
+[AIRFLOW-2040] Escape special chars in task instance logs URL
+[AIRFLOW-1968][AIRFLOW-1520] Add role_arn and aws_account_id/aws_iam_role support back to aws hook
+[AIRFLOW-2048] Fix task instance failure string formatting
+[AIRFLOW-2046] Fix kerberos error to work with python 3.x
+[AIRFLOW-2063] Add missing docs for GCP
+[AIRFLOW-XXX] Fix typo in docs
+[AIRFLOW-1793] Use docker_url instead of invalid base_url
+[AIRFLOW-2055] Elaborate on slightly ambiguous documentation
+[AIRFLOW-2039] BigQueryOperator supports priority property
+[AIRFLOW-2053] Fix quote character bug in BQ hook
+[AIRFLOW-2057] Add Overstock to list of companies
+[AIRFLOW-XXX] Add Plaid to Airflow users
+[AIRFLOW-2044] Add SparkSubmitOperator to documentation
+[AIRFLOW-2037] Add methods to get Hash values of a GCS object
+[AIRFLOW-2050] Fix Travis permission problem
+[AIRFLOW-2043] Add Intercom to list of companies
+[AIRFLOW-2023] Add debug logging around number of queued files
+[AIRFLOW-XXX] Add Pernod-ricard as a airflow user
+[AIRFLOW-1453] Add 'steps' into template_fields in EmrAddSteps
+[AIRFLOW-2015] Add flag for interactive runs
+[AIRFLOW-1895] Fix primary key integrity for mysql
+[AIRFLOW-2030] Fix KeyError:`i` in DbApiHook for insert
+[AIRFLOW-1943] Add External BigQuery Table feature
+[AIRFLOW-2033] Add Google Cloud Storage List Operator
+[AIRFLOW-2006] Add local log catching to kubernetes operator
+[AIRFLOW-2031] Add missing gcp_conn_id in the example in DataFlow docstrings
+[AIRFLOW-2029] Fix AttributeError in BigQueryPandasConnector
+[AIRFLOW-2028] Add JobTeaser to official users list
+[AIRFLOW-2016] Add support for Dataproc Workflow Templates
+[AIRFLOW-2025] Reduced Logging verbosity
+[AIRFLOW-1267][AIRFLOW-1874] Add dialect parameter to BigQueryHook
+[AIRFLOW-XXX] Fixed a typo
+[AIRFLOW-XXX] Typo node to nodes
+[AIRFLOW-2019] Update DataflowHook for updating Streaming type job
+[AIRFLOW-2017][Airflow 2017] adding query output to PostgresOperator
+[AIRFLOW-1889] Split sensors into separate files
+[AIRFLOW-1950] Optionally pass xcom_pull task_ids
+[AIRFLOW-1755] Allow mount below root
+[AIRFLOW-511][Airflow 511] add success/failure callbacks on dag level
+[AIRFLOW-192] Add weight_rule param to BaseOperator
+[AIRFLOW-2008] Use callable for python column defaults
+[AIRFLOW-1984] Fix to AWS Batch operator
+[AIRFLOW-2000] Support non-main dataflow job class
+[AIRFLOW-2003] Use flask-caching instead of flask-cache
+[AIRFLOW-2002] Do not swallow exception on logging import
+[AIRFLOW-2004] Import flash from flask not flask.login
+[AIRFLOW-1997] Fix GCP operator doc strings
+[AIRFLOW-1996] Update DataflowHook waitfordone for Streaming type job[]
+[AIRFLOW-1995][Airflow 1995] add on_kill method to SqoopOperator
+[AIRFLOW-1770] Allow HiveOperator to take in a file
+[AIRFLOW-1994] Change background color of Scheduled state Task Instances
+[AIRFLOW-1436][AIRFLOW-1475] EmrJobFlowSensor considers Cancelled step as Successful
+[AIRFLOW-1517] Kubernetes operator PR fixes
+[AIRFLOW-1517] addressed PR comments
+[AIRFLOW-1517] started documentation of k8s operator
+[AIRFLOW-1517] Restore authorship of resources
+[AIRFLOW-1517] Remove authorship of resources
+[AIRFLOW-1517] Add minikube for kubernetes integration tests
+[AIRFLOW-1517] Restore authorship of resources
+[AIRFLOW-1517] fixed license issues
+[AIRFLOW-1517] Created more accurate failures for kube cluster issues
+[AIRFLOW-1517] Remove authorship of resources
+[AIRFLOW-1517] Add minikube for kubernetes integration tests
+[AIRFLOW-1988] Change BG color of None state TIs
+[AIRFLOW-790] Clean up TaskInstances without DagRuns
+[AIRFLOW-1949] Fix var upload, str() produces "b'...'" which is not json
+[AIRFLOW-1930] Convert func.now() to timezone.utcnow()
+[AIRFLOW-1688] Support load.time_partitioning in bigquery_hook
+[AIRFLOW-1975] Make TriggerDagRunOperator callback optional
+[AIRFLOW-1480] Render template attributes for ExternalTaskSensor fields
+[AIRFLOW-1958] Add **kwargs to send_email
+[AIRFLOW-1976] Fix for missing log/logger attribute FileProcessHandler
+[AIRFLOW-1982] Fix Executor event log formatting
+[AIRFLOW-1971] Propagate hive config on impersonation
+[AIRFLOW-1969] Always use HTTPS URIs for Google OAuth2
+[AIRFLOW-1954] Add DataFlowTemplateOperator
+[AIRFLOW-1963] Add config for HiveOperator mapred_queue
+[AIRFLOW-1946][AIRFLOW-1855] Create a BigQuery Get Data Operator
+[AIRFLOW-1953] Add labels to dataflow operators
+[AIRFLOW-1967] Update Celery to 4.0.2
+[AIRFLOW-1964] Add Upsight to list of Airflow users
+[AIRFLOW-XXX] Changelog for 1.9.0
+[AIRFLOW-1470] Implement BashSensor operator
+[AIRFLOW-XXX] Pin sqlalchemy dependency
+[AIRFLOW-1955] Do not reference unassigned variable
+[AIRFLOW-1957] Add contributor to BalanceHero in Readme
+[AIRFLOW-1517] Restore authorship of secrets and init container
+[AIRFLOW-1517] Remove authorship of secrets and init container
+[AIRFLOW-1935] Add BalanceHero to readme
+[AIRFLOW-1939] add astronomer contributors
+[AIRFLOW-1517] Kubernetes Operator
+[AIRFLOW-1928] Fix @once with catchup=False
+[AIRFLOW-1937] Speed up scheduling by committing in batch
+[AIRFLOW-1821] Enhance default logging config by removing extra loggers
+[AIRFLOW-1904] Correct DAG fileloc to the right filepath
+[AIRFLOW-1909] Update docs with supported versions of MySQL server
+[AIRFLOW-1915] Relax flask-wtf dependency specification
+[AIRFLOW-1920] Update CONTRIBUTING.md to reflect enforced linting rules
+[AIRFLOW-1942] Update Sphinx docs to remove deprecated import structure
+[AIRFLOW-1846][AIRFLOW-1697] Hide Ad Hoc Query behind secure_mode config
+[AIRFLOW-1948] Include details for on_kill failure
+[AIRFLOW-1938] Clean up unused exception
+[AIRFLOW-1932] Add GCP Pub/Sub Pull and Ack
+[AIRFLOW-XXX] Purge coveralls
+[AIRFLOW-XXX] Remove unused coveralls token
+[AIRFLOW-1938] Remove tag version check in setup.py
+[AIRFLOW-1916] Don't upload logs to remote from `run --raw`
+[AIRFLOW-XXX] Fix failing PubSub tests on Python3
+[AIRFLOW-XXX] Upgrade to python 3.5 and disable dask tests
+[AIRFLOW-1913] Add new GCP PubSub operators
+[AIRFLOW-1525] Fix minor LICENSE and NOTICE issues
+[AIRFLOW-1687] fix fernet error without encryption
+[AIRFLOW-1912] airflow.processor should not propagate logging
+[AIRFLOW-1911] Rename celeryd_concurrency
+[AIRFLOW-1885] Fix IndexError in ready_prefix_on_cmdline
+[AIRFLOW-1854] Improve Spark Submit operator for standalone cluster mode
+[AIRFLOW-1908] Fix celery broker options config load
+[AIRFLOW-1907] Pass max_ingestion_time to Druid hook
+[AIRFLOW-1909] Add away to list of users
+[AIRFLOW-1893][AIRFLOW-1901] Propagate PYTHONPATH when using impersonation
+[AIRFLOW-1892] Modify BQ hook to extract data filtered by column
+[AIRFLOW-1829] Support for schema updates in query jobs
+[AIRFLOW-1840] Make celery configuration congruent with Celery 4
+[AIRFLOW-1878] Fix stderr/stdout redirection for tasks
+[AIRFLOW-1897][AIRFLOW-1873] Task Logs for running instance not visible in WebUI
+[AIRFLOW-1896] FIX bleach <> html5lib incompatibility
+[AIRFLOW-1884][AIRFLOW-1059] Reset orphaned task state for external dagruns
+[AIRFLOW-XXX] Fix typo in comment
+[AIRFLOW-1869] Do not emit spurious warning on missing logs
+[AIRFLOW-1888] Add AWS Redshift Cluster Sensor
+[AIRFLOW-1887] Renamed endpoint url variable
+[AIRFLOW-1873] Set TI.try_number to right value depending TI state
+[AIRFLOW-1891] Fix non-ascii typo in default configuration template
+[AIRFLOW-1879] Handle ti log entirely within ti
+[AIRFLOW-1869] Write more error messages into gcs and file logs
+[AIRFLOW-1876] Write subtask id to task log header
+[AIRFLOW-1554] Fix wrong DagFileProcessor termination method call
+[AIRFLOW-342] Do not use amqp, rpc as result backend
+[AIRFLOW-966] Make celery broker_transport_options configurable
+[AIRFLOW-1881] Make operator log in task log
+[AIRFLOW-XXX] Added DataReply to the list of Airflow Users
+[AIRFLOW-1883] Get File Size for objects in Google Cloud Storage
+[AIRFLOW-1872] Set context for all handlers including parents
+[AIRFLOW-1855][AIRFLOW-1866] Add GCS Copy Operator to copy multiple files
+[AIRFLOW-1870] Enable flake8 tests
+[AIRFLOW-1785] Enable Python 3 tests
+[AIRFLOW-1850] Copy cmd before masking
+[AIRFLOW-1665] Reconnect on database errors
+[AIRFLOW-1559] Dispose SQLAlchemy engines on exit
+[AIRFLOW-1559] Close file handles in subprocesses
+[AIRFLOW-1559] Make database pooling optional
+[AIRFLOW-1848][Airflow-1848] Fix DataFlowPythonOperator py_file extension doc comment
+[AIRFLOW-1843] Add Google Cloud Storage Sensor with prefix
+[AIRFLOW-1803] Time zone documentation
+[AIRFLOW-1826] Update views to use timezone aware objects
+[AIRFLOW-1827] Fix api endpoint date parsing
+[AIRFLOW-1806] Use naive datetime when using cron
+[AIRFLOW-1809] Update tests to use timezone aware objects
+[AIRFLOW-1806] Use naive datetime for cron scheduling
+[AIRFLOW-1807] Force use of time zone aware db fields
+[AIRFLOW-1808] Convert all utcnow() to time zone aware
+[AIRFLOW-1804] Add time zone configuration options
+[AIRFLOW-1802] Convert database fields to timezone aware
+[AIRFLOW-XXX] Add dask lock files to excludes
+[AIRFLOW-1790] Add support for AWS Batch operator
+[AIRFLOW-XXX] Update README.md
+[AIRFLOW-1820] Remove timestamp from metric name
+[AIRFLOW-1810] Remove unused mysql import in migrations.
+[AIRFLOW-1838] Properly log collect_dags exception
+[AIRFLOW-1842] Fixed Super class name for the gcs to gcs copy operator
+[AIRFLOW-1845] Modal background now covers long or tall pages
+[AIRFLOW-1229] Add link to Run Id, incl execution_date
+[AIRFLOW-1842] Add gcs to gcs copy operator with renaming if required
+[AIRFLOW-1841] change False to None in operator and hook
+[AIRFLOW-1839] Fix more bugs in S3Hook boto -> boto3 migration
+[AIRFLOW-1830] Support multiple domains in Google authentication backend
+[AIRFLOW-1831] Add driver-classpath spark submit
+[AIRFLOW-1795] Correctly call S3Hook after migration to boto3
+[AIRFLOW-1811] Fix render Druid operator
+[AIRFLOW-1819] Fix slack operator unittest bug
+[AIRFLOW-1805] Allow Slack token to be passed through connection
+[AIRFLOW-1816] Add region param to Dataproc operators
+[AIRFLOW-868] Add postgres_to_gcs operator and unittests
+[AIRFLOW-1613] make mysql_to_gcs_operator py3 compatible
+[AIRFLOW-1817] use boto3 for s3 dependency
+[AIRFLOW-1813] Bug SSH Operator empty buffer
+[AIRFLOW-1801][AIRFLOW-288] Url encode execution dates
+[AIRFLOW-1563] Catch OSError while symlinking the latest log directory
+[AIRFLOW-1794] Remove uses of Exception.message for Python 3
+[AIRFLOW-1799] Fix logging line which raises errors
+[AIRFLOW-1102] Upgrade Gunicorn >=19.4.0
+[AIRFLOW-1756] Fix S3TaskHandler to work with Boto3-based S3Hook
+[AIRFLOW-1797] S3Hook.load_string didn't work on Python3
+[AIRFLOW-646] Add docutils to setup_requires
+[AIRFLOW-1792] Missing intervals DruidOperator
+[AIRFLOW-1789][AIRFLOW-1712] Log SSHOperator stderr to log.warning
+[AIRFLOW-1787] Fix task instance batch clear and set state bugs
+[AIRFLOW-1780] Fix long output lines with unicode from hanging parent
+[AIRFLOW-387] Close SQLAlchemy sessions properly
+[AIRFLOW-1779] Add keepalive packets to ssh hook
+[AIRFLOW-1669] Fix Docker and pin Moto to 1.1.19
+[AIRFLOW-71] Add support for private Docker images
+[AIRFLOW-XXX] Give a clue what the 'ds' variable is
+[AIRFLOW-XXX] Correct typos in the faq docs page
+[AIRFLOW-1571] Add AWS Lambda Hook
+[AIRFLOW-1675] Fix docstrings for API docs
+[AIRFLOW-1712][AIRFLOW-756][AIRFLOW-751] Log SSHOperator output
+[AIRFLOW-1776] Capture stdout and stderr for logging
+[AIRFLOW-1765] Make experimental API securable without needing Kerberos.
+[AIRFLOW-1764] The web interface should not use the experimental API
+[AIRFLOW-1771] Rename heartbeat to avoid confusion
+[AIRFLOW-1769] Add support for templates in VirtualenvOperator
+[AIRFLOW-1763] Fix S3TaskHandler unit tests
+[AIRFLOW-1315] Add Qubole File & Partition Sensors
+[AIRFLOW-1018] Make processor use logging framework
+[AIRFLOW-1695] Add RedshiftHook using boto3
+[AIRFLOW-1706] Fix query error for MSSQL backend
+[AIRFLOW-1711] Use ldap3 dict for group membership
+[AIRFLOW-1723] Make sendgrid a plugin
+[AIRFLOW-1757] Add missing options to SparkSubmitOperator
+[AIRFLOW-1734][Airflow 1734] Sqoop hook/operator enhancements
+[AIRFLOW-1761] Fix type in scheduler.rst
+[AIRFLOW-1731] Set pythonpath for logging
+[AIRFLOW-1641] Handle executor events in the scheduler
+[AIRFLOW-1744] Make sure max_tries can be set
+[AIRFLOW-1732] Improve dataflow hook logging
+[AIRFLOW-1736] Add HotelQuickly to Who Uses Airflow
+[AIRFLOW-1657] Handle failing qubole operator
+[AIRFLOW-1677] Fix typo in example_qubole_operator
+[AIRFLOW-926] Fix JDBC Hook
+[AIRFLOW-1520] Boto3 S3Hook, S3Log
+[AIRFLOW-1716] Fix multiple __init__ def in SimpleDag
+[AIRFLOW-XXX] Fix DateTime in Tree View
+[AIRFLOW-1719] Fix small typo
+[AIRFLOW-1432] Charts label for Y axis not visible
+[AIRFLOW-1743] Verify ldap filters correctly
+[AIRFLOW-1745] Restore default signal disposition
+[AIRFLOW-1741] Correctly hide second chart on task duration page
+[AIRFLOW-1728] Add networkUri, subnet, tags to Dataproc operator
+[AIRFLOW-1726] Add copy_expert psycopg2 method to PostgresHook
+[AIRFLOW-1330] Add conn_type argument to CLI when adding connection
+[AIRFLOW-1698] Remove SCHEDULER_RUNS env var in systemd
+[AIRFLOW-1694] Stop using itertools.izip
+[AIRFLOW-1692] Change test_views filename to support Windows
+[AIRFLOW-1722] Fix typo in scheduler autorestart output filename
+[AIRFLOW-1723] Support sendgrid in email backend
+[AIRFLOW-1718] Set num_retries on Dataproc job request execution
+[AIRFLOW-1727] Add unit tests for DataProcHook
+[AIRFLOW-1631] Fix timing issue in unit test
+[AIRFLOW-1631] Fix local executor unbound parallelism
+[AIRFLOW-1724] Add Fundera to Who uses Airflow?
+[AIRFLOW-1683] Cancel BigQuery job on timeout.
+[AIRFLOW-1714] Fix misspelling: s/seperate/separate/
+[AIRFLOW-1681] Add batch clear in task instance view
+[AIRFLOW-1696] Fix dataproc version label error
+[AIRFLOW-1613] Handle binary field in MySqlToGoogleCloudStorageOperator
+[AIRFLOW-1697] Mode to disable charts endpoint
+[AIRFLOW-1691] Add better Google cloud logging documentation
+[AIRFLOW-1690] Add detail to gcs error messages
+[AIRFLOW-1682] Make S3TaskHandler write to S3 on close
+[AIRFLOW-1634] Adds task_concurrency feature
+[AIRFLOW-1676] Make GCSTaskHandler write to GCS on close
+[AIRFLOW-1678] Fix erroneously repeated word in function docstrings
+[AIRFLOW-1323] Made Dataproc operator parameter names consistent
+[AIRFLOW-1590] fix unused module and variable
+[AIRFLOW-1671] Add @apply_defaults back to gcs download operator
+[AIRFLOW-988] Fix repeating SLA miss callbacks
+[AIRFLOW-1611] Customize logging
+[AIRFLOW-1668] Expose keepalives_idle for Postgres connections
+[AIRFLOW-1658] Kill Druid task on timeout
+[AIRFLOW-1669][AIRFLOW-1368] Fix Docker import
+[AIRFLOW-891] Make webserver clock include date
+[AIRFLOW-1560] Add AWS DynamoDB hook and operator for inserting batch items
+[AIRFLOW-1654] Show tooltips for link icons in DAGs view
+[AIRFLOW-1660] Change webpage width to full-width
+[AIRFLOW-1664] write file as binary instead of str
+[AIRFLOW-1659] Fix invalid obj attribute bug in file_task_handler.py
+[AIRFLOW-1635] Allow creating GCP connection without requiring a JSON file
+[AIRFLOW-1650] Fix custom celery config loading
+[AIRFLOW-1647] Fix Spark-sql hook
+[AIRFLOW-1587] Fix CeleryExecutor import error
+[Airflow-1640][AIRFLOW-1640] Add qubole default connection
+[AIRFLOW-1576] Added region param to Dataproc{*}Operators
+[AIRFLOW-1643] Add healthjump to officially using list
+[AIRFLOW-1626] Add Azri Solutions to Airflow users
+[AIRFLOW-1636] Add AWS and EMR connection type
+[AIRFLOW-1527] Refactor celery config
+[AIRFLOW-1639] Fix Fernet error handling
+[AIRFLOW-1637] Fix Travis CI build status link
+[AIRFLOW-1628] Fix docstring of sqlsensor
+[AIRFLOW-1331] add SparkSubmitOperator option
+[AIRFLOW-1627] Only query pool in SubDAG init when necessary
+[AIRFLOW-1629] Make extra a textarea in edit connections form
+[AIRFLOW-1368] Automatically remove Docker container on exit
+[AIRFLOW-289] Make airflow timezone independent
+[AIRFLOW-1356] Add `--celery_hostname` to `airflow worker`
+[AIRFLOW-1247] Fix ignore_all_dependencies argument ignored
+[AIRFLOW-1621] Add tests for server side paging
+[AIRFLOW-1591] Avoid attribute error when rendering logging filename
+[AIRFLOW-1031] Replace hard-code to DagRun.ID_PREFIX
+[AIRFLOW-1604] Rename logger to log
+[AIRFLOW-1512] Add PythonVirtualenvOperator
+[AIRFLOW-1617] Fix XSS vulnerability in Variable endpoint
+[AIRFLOW-1497] Reset hidden fields when changing connection type
+[AIRFLOW-1619] Add poll_sleep parameter to GCP dataflow operator
+[AIRFLOW-XXX] Remove landscape.io config
+[AIRFLOW-XXX] Remove non working service badges
+[AIRFLOW-1177] Fix Variable.setdefault w/existing JSON
+[AIRFLOW-1600] Fix exception handling in get_fernet
+[AIRFLOW-1614] Replace inspect.stack() with sys._getframe()
+[AIRFLOW-1519] Add server side paging in DAGs list
+[AIRFLOW-1309] Allow hive_to_druid to take tblproperties
+[AIRFLOW-1613] Make MySqlToGoogleCloudStorageOperator compaitible with python3
+[AIRFLOW-1603] add PAYMILL to companies list
+[AIRFLOW-1609] Fix gitignore to ignore all venvs
+[AIRFLOW-1601] Add configurable task cleanup time
+
 AIRFLOW 1.9.0, 2018-01-02
 -------------------------
 

From f1083cbada337731ed0b7e27b09eee7a26c8189a Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sun, 8 Jul 2018 21:58:00 +0200
Subject: [PATCH 018/808] no incubating

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index 02346d56fdef0..be4038b4af24d 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.0+incubating'
+version = '1.10.0'

From 8e54a2917ef86d5cbdd8533a4fd4f38eaf6cc144 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Fri, 13 Jul 2018 11:46:03 +0200
Subject: [PATCH 019/808] [AIRFLOW-XXX] Wrap DISCLAIMER text

(cherry picked from commit 39adc77f6fefc54fcfa893362b576070a4c3e660)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 DISCLAIMER | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/DISCLAIMER b/DISCLAIMER
index 8fe69887c3638..2758508789843 100644
--- a/DISCLAIMER
+++ b/DISCLAIMER
@@ -1 +1,6 @@
-Apache Airflow is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
+Apache Airflow is an effort undergoing incubation at The Apache Software Foundation (ASF),
+sponsored by the Apache Incubator. Incubation is required of all newly accepted projects
+until a further review indicates that the infrastructure, communications, and decision
+making process have stabilized in a manner consistent with other successful ASF projects.
+While incubation status is not necessarily a reflection of the completeness or stability
+of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

From f123cf5f8de71152d1b2b39c5c994bfc00a67d72 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Fri, 13 Jul 2018 11:42:41 +0200
Subject: [PATCH 020/808] [AIRFLOW-XXX] Use .sha512 for signature

As requested by the IPMC

(cherry picked from commit a54f74821e161fd9e5423f5cfebaeab43a021422)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 dev/sign.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dev/sign.sh b/dev/sign.sh
index da0f7a94576b2..66427a7e87ce8 100755
--- a/dev/sign.sh
+++ b/dev/sign.sh
@@ -25,5 +25,5 @@
 NAME=${1}
 
 gpg --armor --output ${NAME}.asc --detach-sig ${NAME}
-gpg --print-md SHA512 ${NAME} > ${NAME}.sha
+gpg --print-md SHA512 ${NAME} > ${NAME}.sha512
 gpg --print-md MD5 ${NAME} > ${NAME}.md5

From f4bcc33564d68b2146fb4fbf6a08f20326069306 Mon Sep 17 00:00:00 2001
From: Carl Johan Gustavsson <carl.johan@tictail.com>
Date: Fri, 13 Jul 2018 11:58:39 +0200
Subject: [PATCH 021/808] [AIRFLOW-2739] Always read default configuration
 files as utf-8

Closes #3593 from cjgu/airflow-2739

(cherry picked from commit 78da52fee477b0f7b2ee3481d32a06fca7a9841c)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/configuration.py | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index e2089e5b5b94b..2e05fde0cdea2 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -101,15 +101,20 @@ def run_command(command):
     return output
 
 
-_templates_dir = os.path.join(os.path.dirname(__file__), 'config_templates')
-with open(os.path.join(_templates_dir, 'default_airflow.cfg')) as f:
-    DEFAULT_CONFIG = f.read()
+def _read_default_config_file(file_name):
+    templates_dir = os.path.join(os.path.dirname(__file__), 'config_templates')
+    file_path = os.path.join(templates_dir, file_name)
     if six.PY2:
-        DEFAULT_CONFIG = DEFAULT_CONFIG.decode('utf-8')
-with open(os.path.join(_templates_dir, 'default_test.cfg')) as f:
-    TEST_CONFIG = f.read()
-    if six.PY2:
-        TEST_CONFIG = TEST_CONFIG.decode('utf-8')
+        with open(file_path) as f:
+            config = f.read()
+            return config.decode('utf-8')
+    else:
+        with open(file_path, encoding='utf-8') as f:
+            return f.read()
+
+
+DEFAULT_CONFIG = _read_default_config_file('default_airflow.cfg')
+TEST_CONFIG = _read_default_config_file('default_test.cfg')
 
 
 class AirflowConfigParser(ConfigParser):
@@ -502,8 +507,7 @@ def parameterized_config(template):
 
 
 if conf.getboolean('webserver', 'rbac'):
-    with open(os.path.join(_templates_dir, 'default_webserver_config.py')) as f:
-        DEFAULT_WEBSERVER_CONFIG = f.read()
+    DEFAULT_WEBSERVER_CONFIG = _read_default_config_file('default_webserver_config.py')
 
     WEBSERVER_CONFIG = AIRFLOW_HOME + '/webserver_config.py'
 

From 23191605e463c85f0935cbf5c47f31c357d1596b Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 13 Jul 2018 13:18:47 +0200
Subject: [PATCH 022/808] [AIRFLOW-1729][AIRFLOW-2797][AIRFLOW-2729] Ignore
 whole directories in .airflowignore

We can ignore whole directories by removing them
from the `dirs` array
that `os.walk()` returns. Doing this means that we
fewer disk ops if
someone has a set of modules in their dag folder
that they want to
ignore.

Also fixes [AIRFLOW-2797] - we weren't honoring
.airflowignore from a
parent dir as of #3717 -- that (expected)
behaviour is now back again.

De-duplicate the walking code as well - we had two
versions that had
gotten out of sync as of #3171. So that doesn't
happen again we now only
have one version.

Closes #3602 from ashb/ignore-whole-dirs-
airflowignore

(cherry picked from commit 6b2fdbef0ab4bd1ed91e6338bcf6440e782b7035)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/models.py               | 58 ++++++++++++---------------------
 airflow/utils/dag_processing.py | 29 +++++++++++++----
 2 files changed, 44 insertions(+), 43 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index bde6137022013..5f0713f636b40 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -510,7 +510,8 @@ def collect_dags(
         Note that if a .airflowignore file is found while processing,
         the directory, it will behaves much like a .gitignore does,
         ignoring files that match any of the regex patterns specified
-        in the file.
+        in the file. **Note**: The patterns in .airflowignore are treated as
+        un-anchored regexes, not shell-like glob patterns.
         """
         start_dttm = timezone.utcnow()
         dag_folder = dag_folder or self.dag_folder
@@ -519,42 +520,25 @@ def collect_dags(
         stats = []
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
-        if os.path.isfile(dag_folder):
-            self.process_file(dag_folder, only_if_updated=only_if_updated)
-        elif os.path.isdir(dag_folder):
-            for root, dirs, files in os.walk(dag_folder, followlinks=True):
-                patterns = []
-                ignore_file = os.path.join(root, '.airflowignore')
-                if os.path.isfile(ignore_file):
-                    with open(ignore_file, 'r') as f:
-                        patterns += [p for p in f.read().split('\n') if p]
-                for f in files:
-                    try:
-                        filepath = os.path.join(root, f)
-                        if not os.path.isfile(filepath):
-                            continue
-                        mod_name, file_ext = os.path.splitext(
-                            os.path.split(filepath)[-1])
-                        if file_ext != '.py' and not zipfile.is_zipfile(filepath):
-                            continue
-                        if not any(
-                                [re.findall(p, filepath) for p in patterns]):
-                            ts = timezone.utcnow()
-                            found_dags = self.process_file(
-                                filepath, only_if_updated=only_if_updated)
-
-                            td = timezone.utcnow() - ts
-                            td = td.total_seconds() + (
-                                float(td.microseconds) / 1000000)
-                            stats.append(FileLoadStat(
-                                filepath.replace(dag_folder, ''),
-                                td,
-                                len(found_dags),
-                                sum([len(dag.tasks) for dag in found_dags]),
-                                str([dag.dag_id for dag in found_dags]),
-                            ))
-                    except Exception as e:
-                        self.log.exception(e)
+        for filepath in utils.dag_processing.list_py_file_paths(dag_folder):
+            self.log.info(filepath)
+            try:
+                ts = timezone.utcnow()
+                found_dags = self.process_file(
+                    filepath, only_if_updated=only_if_updated)
+
+                td = timezone.utcnow() - ts
+                td = td.total_seconds() + (
+                    float(td.microseconds) / 1000000)
+                stats.append(FileLoadStat(
+                    filepath.replace(dag_folder, ''),
+                    td,
+                    len(found_dags),
+                    sum([len(dag.tasks) for dag in found_dags]),
+                    str([dag.dag_id for dag in found_dags]),
+                ))
+            except Exception as e:
+                self.log.exception(e)
         Stats.gauge(
             'collect_dags', (timezone.utcnow() - start_dttm).total_seconds(), 1)
         Stats.gauge(
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 543eb41692e03..e236397da0284 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -177,13 +177,30 @@ def list_py_file_paths(directory, safe_mode=True):
     elif os.path.isfile(directory):
         return [directory]
     elif os.path.isdir(directory):
-        patterns = []
+        patterns_by_dir = {}
         for root, dirs, files in os.walk(directory, followlinks=True):
-            ignore_file = [f for f in files if f == '.airflowignore']
-            if ignore_file:
-                f = open(os.path.join(root, ignore_file[0]), 'r')
-                patterns += [p for p in f.read().split('\n') if p]
-                f.close()
+            patterns = patterns_by_dir.get(root, [])
+            ignore_file = os.path.join(root, '.airflowignore')
+            if os.path.isfile(ignore_file):
+                with open(ignore_file, 'r') as f:
+                    # If we have new patterns create a copy so we don't change
+                    # the previous list (which would affect other subdirs)
+                    patterns = patterns + [p for p in f.read().split('\n') if p]
+
+            # If we can ignore any subdirs entirely we should - fewer paths
+            # to walk is better. We have to modify the ``dirs`` array in
+            # place for this to affect os.walk
+            dirs[:] = [
+                d
+                for d in dirs
+                if not any(re.search(p, os.path.join(root, d)) for p in patterns)
+            ]
+
+            # We want patterns defined in a parent folder's .airflowignore to
+            # apply to subdirs too
+            for d in dirs:
+                patterns_by_dir[os.path.join(root, d)] = patterns
+
             for f in files:
                 try:
                     file_path = os.path.join(root, f)

From 48847d737e5e4565f77501ef52d61060ecf072f4 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sun, 15 Jul 2018 17:56:18 +0200
Subject: [PATCH 023/808] [AIRFLOW-2752] Log using logging instead of stdout

Logging should be done using the Python log module
instead of writing directly to stdout

Closes #3604 from Fokko/patch-2

(cherry picked from commit 846e2746c0be3d9e55edd3351ae9f43228ea48a5)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/executors/base_executor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index 04c90884012f7..701ac66f8b72d 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -150,7 +150,7 @@ def heartbeat(self):
         self.sync()
 
     def change_state(self, key, state):
-        print("popping: {}".format(key))
+        self.log.debug("Changing state: {}".format(key))
         self.running.pop(key)
         self.event_buffer[key] = state
 

From fc00875ed00555e5da5661324479e8703787bbd5 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sun, 15 Jul 2018 17:59:32 +0200
Subject: [PATCH 024/808] [AIRFLOW-1729][AIRFLOW-XXX] Remove extra debug log at
 info level

I left an extra log call, at info level in #3602
that was being used for
debugging.

Closes #3603 from ashb/remove-extra-log

(cherry picked from commit 7c19ed02bc30f71fd73e38234b3b210072274f3b)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/models.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 5f0713f636b40..cb0165a2d0125 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -521,7 +521,6 @@ def collect_dags(
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
         for filepath in utils.dag_processing.list_py_file_paths(dag_folder):
-            self.log.info(filepath)
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(

From 64dacb1ca319443f06e4860b817888946943c8f1 Mon Sep 17 00:00:00 2001
From: Kevin Yuen <kevin@delphia.com>
Date: Sat, 21 Jul 2018 12:38:21 -0400
Subject: [PATCH 025/808] [AIRFLOW-2778] Explicit import for
 dag_processing.list_py_file_paths

The use of utils.dag_processing.list_py_file_paths causes a failure if
utils.dag_processing is not already loaded indirectly.

(cherry picked from commit ba5b67b6c99e0bfb0f827518cdb31b5eb5a5a626)
Signed-off-by: Ash Berlin-Taylor <ash_github@firemirror.com>
---
 airflow/models.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index cb0165a2d0125..6b244cd22640a 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -79,6 +79,7 @@
 
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, RUN_DEPS
 from airflow.utils import timezone
+from airflow.utils.dag_processing import list_py_file_paths
 from airflow.utils.dates import cron_presets, date_range as utils_date_range
 from airflow.utils.db import provide_session
 from airflow.utils.decorators import apply_defaults
@@ -520,7 +521,7 @@ def collect_dags(
         stats = []
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
-        for filepath in utils.dag_processing.list_py_file_paths(dag_folder):
+        for filepath in list_py_file_paths(dag_folder):
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(

From 3b8c4ff7a02bb7914ffab8edc810a69e77cca0e9 Mon Sep 17 00:00:00 2001
From: Nick Hughes <nick.hughes@multiply.com>
Date: Sat, 28 Jul 2018 12:55:47 +0200
Subject: [PATCH 026/808] [AIRFLOW-2812] Fix error in Updating.md for upgrading
 to 1.10

Closes #3654 from nrhvyc/AIRFLOW-2812
---
 UPDATING.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index c341b38f0bc22..80e5858192ff2 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -86,8 +86,8 @@ With Airflow 1.9 or lower, `FILENAME_TEMPLATE`, `PROCESSOR_FILENAME_TEMPLATE`, `
 ```
 [core]
 fab_logging_level = WARN
-log_filename_template = {{{{ ti.dag_id }}}}/{{{{ ti.task_id }}}}/{{{{ ts }}}}/{{{{ try_number }}}}.log
-log_processor_filename_template = {{{{ filename }}}}.log
+log_filename_template = {{ ti.dag_id }}/{{ ti.task_id }}/{{ ts }}/{{ try_number }}.log
+log_processor_filename_template = {{ filename }}.log
 
 [elasticsearch]
 elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_number}}

From 3b7e71f820bd312f2013d41eb7b2f9486a532036 Mon Sep 17 00:00:00 2001
From: Andy Wilcox <awilcox@twitter.com>
Date: Fri, 27 Jul 2018 13:03:30 -0400
Subject: [PATCH 027/808] [AIRFLOW-2810] Fix typo in Xcom model timestamp

Fix typo in Xcom model timestamp field

No new testing - the field is already represented
in migrations

Closes #3652 from andywilco/fix_datetime_typo

(cherry picked from commit a338f3276835af45765d24a6e6d43ad4ba4d66ba)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/models.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 6b244cd22640a..b789fd17323e2 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4470,7 +4470,7 @@ class XCom(Base, LoggingMixin):
     key = Column(String(512))
     value = Column(LargeBinary)
     timestamp = Column(
-        DateTime, default=timezone.utcnow, nullable=False)
+        UtcDateTime, default=timezone.utcnow, nullable=False)
     execution_date = Column(UtcDateTime, nullable=False)
 
     # source information

From 90e89f0d89e8448748a31fefea8e4e97db884048 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sat, 21 Jul 2018 19:41:43 +0200
Subject: [PATCH 028/808] [AIRFLOW-XXX] Include license folder for binary

(cherry picked from commit 27fde3840c47fbf5e4d7c429ed4a94de22f9f80c)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 MANIFEST.in | 1 +
 1 file changed, 1 insertion(+)

diff --git a/MANIFEST.in b/MANIFEST.in
index c04b80617d18d..b069194984511 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -21,6 +21,7 @@ include LICENSE
 include DISCLAIMER
 include CHANGELOG.txt
 include README.md
+graft licenses/
 graft airflow/www/templates
 graft airflow/www/static
 graft airflow/www_rbac/static

From f0549211f5b026a5b2d5c3bc6b3b74d0bf0a6536 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sat, 28 Jul 2018 13:10:43 +0200
Subject: [PATCH 029/808] [AIRFLOW-2815] Use correct copyright period

"onwards" is not specific enough

(cherry picked from commit 4f562ba8c7f12b8de74e40fe67cac7b4f38413b1)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 NOTICE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NOTICE b/NOTICE
index b1e78ad9c3380..a4727302be245 100644
--- a/NOTICE
+++ b/NOTICE
@@ -1,5 +1,5 @@
 Apache Airflow
-Copyright 2016 and onwards The Apache Software Foundation
+Copyright 2016-2018 The Apache Software Foundation
 
 
 This product includes software developed at The Apache Software

From eb34cd596b5995474aeaa6a13829df0d52673cde Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sat, 28 Jul 2018 14:25:05 +0200
Subject: [PATCH 030/808] [AIRFLOW-2779] Update licenses and remove copyright
 headers

* ssh_hook is not a port anymore
* auth backends should never had a copyright clause
* minihivecluster isnt used

(cherry picked from commit a5fa1bf8886ee3ced1306f8c2ff58541a72db96c)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 LICENSE                                       |  17 +-
 NOTICE                                        |  17 +-
 .../auth/backends/github_enterprise_auth.py   |   2 +-
 airflow/contrib/auth/backends/google_auth.py  |   2 +-
 airflow/contrib/hooks/ssh_hook.py             |   3 -
 airflow/minihivecluster.py                    |  47 ----
 licenses/LICENSE-bootstrap3-typeahead.txt     |  20 ++
 licenses/LICENSE-hue.txt                      | 202 ++++++++++++++++++
 licenses/LICENSE-jqclock.txt                  | 201 +++++++++++++++++
 licenses/LICENSE-scikit-learn.txt             |  31 +++
 10 files changed, 487 insertions(+), 55 deletions(-)
 delete mode 100644 airflow/minihivecluster.py
 create mode 100644 licenses/LICENSE-bootstrap3-typeahead.txt
 create mode 100644 licenses/LICENSE-hue.txt
 create mode 100644 licenses/LICENSE-jqclock.txt
 create mode 100644 licenses/LICENSE-scikit-learn.txt

diff --git a/LICENSE b/LICENSE
index 405540c64fb87..2288b870b4239 100644
--- a/LICENSE
+++ b/LICENSE
@@ -209,6 +209,18 @@ limitations under the License.
    licenses.
 
 
+========================================================================
+Third party Apache 2.0 licenses
+========================================================================
+
+The following components are provided under the Apache 2.0 License.
+See project link for details. The text of each license is also included
+at licenses/LICENSE-[project].txt.
+
+    (ALv2 License) hue (https://github.com/cloudera/hue/)
+    (ALv2 License) jqclock (https://github.com/JohnRDOrazio/jQuery-Clock-Plugin)
+    (ALv2 License) bootstrap3-typeahead (https://github.com/bassjobsen/Bootstrap-3-Typeahead)
+
 ========================================================================
 MIT licenses
 ========================================================================
@@ -239,10 +251,11 @@ The text of each license is also included at licenses/LICENSE-[project].txt.
 ========================================================================
 BSD 3-Clause licenses
 ========================================================================
-The following components are provided under the BSD 2-Clause license.
-See file headers and project links for details.
+The following components are provided under the BSD 3-Clause license. See project links for details.
 The text of each license is also included at licenses/LICENSE-[project].txt.
 
     (BSD 3 License) Ace (https://github.com/ajaxorg/ace)
     (BSD 3 License) d3js (https://d3js.org)
     (BSD 3 License) parallel-coordinates (http://syntagmatic.github.com/parallel-coordinates/)
+    (BSD 3 License) scikit-learn (https://github.com/scikit-learn/scikit-learn)
+
diff --git a/NOTICE b/NOTICE
index a4727302be245..544c0807667fb 100644
--- a/NOTICE
+++ b/NOTICE
@@ -1,6 +1,21 @@
 Apache Airflow
 Copyright 2016-2018 The Apache Software Foundation
 
-
 This product includes software developed at The Apache Software
 Foundation (http://www.apache.org/).
+
+=======================================================================
+
+Apache Airflow contains subcomponents with separate copyright notices and
+license terms. Your use of the source code for the these subcomponents
+is subject to the terms and conditions of their respective licenses.
+
+See the LICENSE file for a list of subcomponents and dependencies and
+their respective licenses.
+
+hue:
+-----
+This product contains a modified portion of 'Hue' developed by Cloudera, Inc.
+(https://github.com/cloudera/hue/).
+
+* Copyright 2009-2017 Cloudera Inc.
diff --git a/airflow/contrib/auth/backends/github_enterprise_auth.py b/airflow/contrib/auth/backends/github_enterprise_auth.py
index 5196725156393..641b81e46da63 100644
--- a/airflow/contrib/auth/backends/github_enterprise_auth.py
+++ b/airflow/contrib/auth/backends/github_enterprise_auth.py
@@ -1,4 +1,4 @@
-# Copyright 2015 Matthew Pelland (matt@pelland.io)
+# -*- coding: utf-8 -*-
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
diff --git a/airflow/contrib/auth/backends/google_auth.py b/airflow/contrib/auth/backends/google_auth.py
index d1a35791db888..e41934b926c31 100644
--- a/airflow/contrib/auth/backends/google_auth.py
+++ b/airflow/contrib/auth/backends/google_auth.py
@@ -1,4 +1,4 @@
-# Copyright 2016 Ananya Mishra (am747@cornell.edu)
+# -*- coding: utf-8 -*-
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
diff --git a/airflow/contrib/hooks/ssh_hook.py b/airflow/contrib/hooks/ssh_hook.py
index f51f0fbd11948..b4de5e08eef00 100755
--- a/airflow/contrib/hooks/ssh_hook.py
+++ b/airflow/contrib/hooks/ssh_hook.py
@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright 2012-2015 Spotify AB
-# Ported to Airflow by Bolke de Bruin
-#
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
diff --git a/airflow/minihivecluster.py b/airflow/minihivecluster.py
deleted file mode 100644
index c5441c67a1b61..0000000000000
--- a/airflow/minihivecluster.py
+++ /dev/null
@@ -1,47 +0,0 @@
-# -*- coding: utf-8 -*-
-# Copyright (c) 2016 Bolke de Bruin
-#
-# Licensed under the Apache License, Version 2.0 (the "License"); you may not
-# use this file except in compliance with the License. You may obtain a copy of
-# the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations under
-# the License.
-import os
-import subprocess
-import select
-import re
-
-
-class MiniHiveCluster(object):
-    def __init__(self):
-        self._minicluster_home = os.environ['MINICLUSTER_HOME']
-        self._minicluster_class = "com.ing.minicluster.MiniCluster"
-        self._start_mini_cluster()
-        self._is_started()
-
-    def _start_mini_cluster(self):
-        classpath = os.path.join(self._minicluster_home, "*")
-        cmd = ["java", "-cp", classpath, self._minicluster_class]
-
-        self.hive = subprocess.Popen(cmd, bufsize=0, stdout=subprocess.PIPE,
-                                     stderr=subprocess.PIPE, universal_newlines=True,
-                                     close_fds=True)
-
-    def terminate(self):
-        self.hive.terminate()
-
-    def _is_started(self):
-        while self.hive.poll() is None:
-            rlist, wlist, xlist = select.select([self.hive.stderr, self.hive.stdout], [], [])
-            for f in rlist:
-                line = f.readline()
-                print(line,)
-                m = re.match(".*Starting ThriftBinaryCLIService", line)
-                if m:
-                    return True
diff --git a/licenses/LICENSE-bootstrap3-typeahead.txt b/licenses/LICENSE-bootstrap3-typeahead.txt
new file mode 100644
index 0000000000000..33c48448eb596
--- /dev/null
+++ b/licenses/LICENSE-bootstrap3-typeahead.txt
@@ -0,0 +1,20 @@
+/* =============================================================
+ * bootstrap3-typeahead.js v4.0.2
+ * https://github.com/bassjobsen/Bootstrap-3-Typeahead
+ * =============================================================
+ * Original written by @mdo and @fat
+ * =============================================================
+ * Copyright 2014 Bass Jobsen @bassjobsen
+ *
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * ============================================================ */
diff --git a/licenses/LICENSE-hue.txt b/licenses/LICENSE-hue.txt
new file mode 100644
index 0000000000000..8be4f5ecb89a2
--- /dev/null
+++ b/licenses/LICENSE-hue.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2009-2017 Cloudera Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/licenses/LICENSE-jqclock.txt b/licenses/LICENSE-jqclock.txt
new file mode 100644
index 0000000000000..8dada3edaf50d
--- /dev/null
+++ b/licenses/LICENSE-jqclock.txt
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/licenses/LICENSE-scikit-learn.txt b/licenses/LICENSE-scikit-learn.txt
new file mode 100644
index 0000000000000..ecd7256f20d2d
--- /dev/null
+++ b/licenses/LICENSE-scikit-learn.txt
@@ -0,0 +1,31 @@
+New BSD License
+
+Copyright (c) 2007–2018 The scikit-learn developers.
+All rights reserved.
+
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  a. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+  b. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+  c. Neither the name of the Scikit-learn Developers  nor the names of
+     its contributors may be used to endorse or promote products
+     derived from this software without specific prior written
+     permission.
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGE.

From 5f3a4cf3037a6caa2f464f3c9c43cb02513478aa Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Sat, 28 Jul 2018 13:20:26 +0200
Subject: [PATCH 031/808] [AIRFLOW-2816] Fix license text in docs/license.rst

(cherry picked from commit af15f1150d3c2e02df9a8d330ac3dcc18c9d3e97)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 docs/license.rst | 40 +++-------------------------------------
 1 file changed, 3 insertions(+), 37 deletions(-)

diff --git a/docs/license.rst b/docs/license.rst
index f920a01658bb7..3c53035713267 100644
--- a/docs/license.rst
+++ b/docs/license.rst
@@ -6,9 +6,9 @@ License
 
 ::
 
-    Apache License
-    Version 2.0, January 2004
-    http://www.apache.org/licenses/
+                                  Apache License
+                            Version 2.0, January 2004
+                         http://www.apache.org/licenses/
 
     TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
@@ -180,37 +180,3 @@ License
        defend, and hold each Contributor harmless for any liability
        incurred by, or claims asserted against, such Contributor by reason
        of your accepting any such warranty or additional liability.
-
-    END OF TERMS AND CONDITIONS
-
-    APPENDIX: How to apply the Apache License to your work.
-
-       To apply the Apache License to your work, attach the following
-       boilerplate notice, with the fields enclosed by brackets "[]"
-       replaced with your own identifying information. (Don't include
-       the brackets!)  The text should be enclosed in the appropriate
-       comment syntax for the file format. We also recommend that a
-       file or class name and description of purpose be included on the
-       same "printed page" as the copyright notice for easier
-       identification within third-party archives.
-
-    Copyright 2015 Apache Software Foundation
-
-    Licensed to the Apache Software Foundation (ASF) under one
-    or more contributor license agreements.  See the NOTICE file
-    distributed with this work for additional information
-    regarding copyright ownership.  The ASF licenses this file
-    to you under the Apache License, Version 2.0 (the
-    "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
-    
-      http://www.apache.org/licenses/LICENSE-2.0
-    
-    Unless required by applicable law or agreed to in writing,
-    software distributed under the License is distributed on an
-    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-    KIND, either express or implied.  See the License for the
-    specific language governing permissions and limitations
-    under the License.
-    Status API Training Shop Blog About
-    © 2016 GitHub, Inc. Terms Privacy Security Contact Help

From c720c352f0762a483fa1202e1477e740631a8184 Mon Sep 17 00:00:00 2001
From: Jacob Hayes <jacob.r.hayes@gmail.com>
Date: Sun, 29 Jul 2018 11:56:41 +0200
Subject: [PATCH 032/808] [AIRFLOW-2716] Replace async and await py3.7 keywords

Closes #3578 from JacobHayes/py37-keywords

(cherry picked from commit fcd51f362c6804cb69dee8e2dd054304a0564dde)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit 0423060bb20c54035fafecda8cc0a50e65953f27)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 UPDATING.md                                       | 14 ++++++++++++++
 airflow/contrib/hooks/gcp_dataproc_hook.py        | 12 +++++++++++-
 airflow/contrib/operators/dataproc_operator.py    |  2 +-
 airflow/executors/celery_executor.py              | 12 ++++++------
 tests/contrib/operators/test_dataproc_operator.py |  8 ++++----
 5 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 80e5858192ff2..fe0e2356abbc5 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -5,6 +5,20 @@ assists users migrating to a new version.
 
 ## Airflow Master
 
+### Replace DataProcHook.await calls to DataProcHook.wait
+
+The method name was changed to be compatible with the Python 3.7 async/await keywords
+
+### DAG level Access Control for new RBAC UI
+
+Extend and enhance new Airflow RBAC UI to support DAG level ACL. Each dag now has two permissions(one for write, one for read) associated('can_dag_edit', 'can_dag_read').
+The admin will create new role, associate the dag permission with the target dag and assign that role to users. That user can only access / view the certain dags on the UI
+that he has permissions on. If a new role wants to access all the dags, the admin could associate dag permissions on an artificial view(``all_dags``) with that role.
+
+We also provide a new cli command(``sync_perm``) to allow admin to auto sync permissions.
+
+### Setting UTF-8 as default mime_charset in email utils
+
 ### Add a configuration variable(default_dag_run_display_number) to control numbers of dag run for display
 Add a configuration variable(default_dag_run_display_number) under webserver section to control num of dag run to show in UI.
 
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index fc15137cbfa91..8e4f32b13790c 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -21,6 +21,7 @@
 import uuid
 
 from apiclient.discovery import build
+from zope.deprecation import deprecation
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -224,7 +225,16 @@ def create_job_template(self, task_id, cluster_name, job_type, properties):
         return _DataProcJobBuilder(self.project_id, task_id, cluster_name,
                                    job_type, properties)
 
-    def await(self, operation):
+    def wait(self, operation):
         """Awaits for Google Cloud Dataproc Operation to complete."""
         submitted = _DataProcOperation(self.get_conn(), operation)
         submitted.wait_for_done()
+
+
+setattr(
+    DataProcHook,
+    "await",
+    deprecation.deprecated(
+        DataProcHook.wait, "renamed to 'wait' for Python3.7 compatability"
+    ),
+)
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 5d59f7fb6eb58..e72a66569d5b6 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -1216,7 +1216,7 @@ def __init__(self,
         )
 
     def execute(self, context):
-        self.hook.await(self.start())
+        self.hook.wait(self.start())
 
     def start(self, context):
         raise AirflowException('plese start a workflow operation')
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 6cfd2d3769893..481daa5826686 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -89,9 +89,9 @@ def execute_async(self, key, command,
 
     def sync(self):
         self.log.debug("Inquiring about %s celery task(s)", len(self.tasks))
-        for key, async in list(self.tasks.items()):
+        for key, task in list(self.tasks.items()):
             try:
-                state = async.state
+                state = task.state
                 if self.last_state[key] != state:
                     if state == celery_states.SUCCESS:
                         self.success(key)
@@ -106,8 +106,8 @@ def sync(self):
                         del self.tasks[key]
                         del self.last_state[key]
                     else:
-                        self.log.info("Unexpected state: %s", async.state)
-                    self.last_state[key] = async.state
+                        self.log.info("Unexpected state: %s", task.state)
+                    self.last_state[key] = task.state
             except Exception as e:
                 self.log.error("Error syncing the celery executor, ignoring it:")
                 self.log.exception(e)
@@ -115,7 +115,7 @@ def sync(self):
     def end(self, synchronous=False):
         if synchronous:
             while any([
-                    async.state not in celery_states.READY_STATES
-                    for async in self.tasks.values()]):
+                    task.state not in celery_states.READY_STATES
+                    for task in self.tasks.values()]):
                 time.sleep(5)
         self.sync()
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 65ff5cd756c89..aea130349bdea 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -508,7 +508,7 @@ def test_workflow(self):
         with patch(HOOK) as MockHook:
             hook = MockHook()
             hook.get_conn.return_value = self.mock_conn
-            hook.await.return_value = None
+            hook.wait.return_value = None
 
             dataproc_task = DataprocWorkflowTemplateInstantiateOperator(
                 task_id=TASK_ID,
@@ -525,7 +525,7 @@ def test_workflow(self):
             self.mock_workflows.instantiate.assert_called_once_with(
                 name=template_name,
                 body=mock.ANY)
-            hook.await.assert_called_once_with(self.operation)
+            hook.wait.assert_called_once_with(self.operation)
 
 
 class DataprocWorkflowTemplateInstantiateInlineOperatorTest(unittest.TestCase):
@@ -556,7 +556,7 @@ def test_iniline_workflow(self):
         with patch(HOOK) as MockHook:
             hook = MockHook()
             hook.get_conn.return_value = self.mock_conn
-            hook.await.return_value = None
+            hook.wait.return_value = None
 
             template = {
                 "placement": {
@@ -591,4 +591,4 @@ def test_iniline_workflow(self):
                 parent='projects/test-project-id/regions/test-region',
                 instanceId=mock.ANY,
                 body=template)
-            hook.await.assert_called_once_with(self.operation)
+            hook.wait.assert_called_once_with(self.operation)

From cefcf4c61f64be3792cbfed509b82a9eb4cc47be Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Wed, 1 Aug 2018 11:25:31 +0200
Subject: [PATCH 033/808] [AIRFLOW-2817] Force explicit choice on GPL
 dependency (#3660)

By default one of Apache Airflow's dependencies pulls in a GPL
library. Airflow should not install (and upgrade) without an explicit choice.

This is part of the Apache requirements as we cannot depend on Category X
software.

(cherry picked from commit c37fc0b6ba19e3fe5656ae37cef9b59cef3c29e8)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit b39e4532d9d1086c60b31553d08972bcc68df641)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 .travis.yml                             |  1 +
 INSTALL                                 | 31 +++++++++++++++++++------
 UPDATING.md                             |  6 +++++
 scripts/ci/kubernetes/docker/Dockerfile |  3 ++-
 setup.py                                | 14 +++++++++++
 tox.ini                                 |  7 +++---
 6 files changed, 51 insertions(+), 11 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 01c08d9537f64..ebc1893b1b551 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -46,6 +46,7 @@ python:
   - "3.5"
 env:
   global:
+    - SLUGIFY_USES_TEXT_UNIDECODE=yes
     - TRAVIS_CACHE=$HOME/.travis_cache/
     - KRB5_CONFIG=/etc/krb5.conf
     - KRB5_KTNAME=/etc/airflow.keytab
diff --git a/INSTALL b/INSTALL
index 5c8f03eb663e6..596ce25814088 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,13 +1,30 @@
-# INSTALL / BUILD instruction for Apache Airflow (incubating)
-# fetch the tarball and untar the source
+# INSTALL / BUILD instructions for Apache Airflow (incubating)
+
+# [required] fetch the tarball and untar the source
+# change into the directory that was untarred.
 
 # [optional] run Apache RAT (release audit tool) to validate license headers
-# RAT docs here: https://creadur.apache.org/rat/
+# RAT docs here: https://creadur.apache.org/rat/. Requires Java and Apache Rat
 java -jar apache-rat.jar -E ./.rat-excludes -d .
 
-# [optional] by default one of Apache Airflow's dependencies pulls in a GPL
-# library. If this is a concern issue (also every upgrade):
-# export SLUGIFY_USES_TEXT_UNIDECODE=yes
+# [optional] Airflow pulls in quite a lot of dependencies in order
+# to connect to other services. You might want to test or run Airflow
+# from a virtual env to make sure those dependencies are separated
+# from your system wide versions
+python -m my_env
+source my_env/bin/activate
+
+# [required] by default one of Apache Airflow's dependencies pulls in a GPL
+# library. Airflow will not install (and upgrade) without an explicit choice.
+#
+# To make sure not to install the GPL dependency:
+#   export SLUGIFY_USES_TEXT_UNIDECODE=yes
+# In case you do not mind:
+#   export GPL_UNIDECODE=yes
+
+# [required] building and installing
+# by pip (preferred)
+pip install .
 
-# install the release
+# or directly
 python setup.py install
diff --git a/UPDATING.md b/UPDATING.md
index fe0e2356abbc5..3b47882212225 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -5,6 +5,12 @@ assists users migrating to a new version.
 
 ## Airflow Master
 
+## Airflow 1.10
+
+Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
+`AIRFLOW_GPL_UNIDECODE=yes`. In case of the latter a GPL runtime dependency will be installed due to a
+dependency (python-nvd3 -> python-slugify -> unidecode).
+
 ### Replace DataProcHook.await calls to DataProcHook.wait
 
 The method name was changed to be compatible with the Python 3.7 async/await keywords
diff --git a/scripts/ci/kubernetes/docker/Dockerfile b/scripts/ci/kubernetes/docker/Dockerfile
index 498c47b21a027..93b20dbcd22fa 100644
--- a/scripts/ci/kubernetes/docker/Dockerfile
+++ b/scripts/ci/kubernetes/docker/Dockerfile
@@ -17,6 +17,8 @@
 
 FROM ubuntu:16.04
 
+ENV SLUGIFY_USES_TEXT_UNIDECODE=yes
+
 # install deps
 RUN apt-get update -y && apt-get install -y \
         wget \
@@ -33,7 +35,6 @@ RUN apt-get update -y && apt-get install -y \
         unzip \
     && apt-get clean
 
-
 RUN pip install --upgrade pip
 
 # Since we install vanilla Airflow, we also want to have support for Postgres and Kubernetes
diff --git a/setup.py b/setup.py
index c91750057cef0..2f5f730af9b25 100644
--- a/setup.py
+++ b/setup.py
@@ -34,6 +34,17 @@
 PY3 = sys.version_info[0] == 3
 
 
+# See LEGAL-362
+def verify_gpl_dependency():
+    if (not os.getenv("AIRFLOW_GPL_UNIDECODE")
+            and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes"):
+        raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
+                           "dependency (unidecode). To avoid this dependency set "
+                           "SLUGIFY_USES_TEXT_UNIDECODE=yes in your environment when you "
+                           "install or upgrade Airflow. To force installing the GPL "
+                           "version set AIRFLOW_GPL_UNIDECODE")
+
+
 class Tox(TestCommand):
     user_options = [('tox-args=', None, "Arguments to pass to tox")]
 
@@ -235,6 +246,7 @@ def write_version(filename=os.path.join(*['airflow',
 
 
 def do_setup():
+    verify_gpl_dependency()
     write_version()
     setup(
         name='apache-airflow',
@@ -353,6 +365,7 @@ def do_setup():
             'License :: OSI Approved :: Apache Software License',
             'Programming Language :: Python :: 2.7',
             'Programming Language :: Python :: 3.4',
+            'Programming Language :: Python :: 3.5',
             'Topic :: System :: Monitoring',
         ],
         author='Apache Software Foundation',
@@ -364,6 +377,7 @@ def do_setup():
             'test': Tox,
             'extra_clean': CleanCommand,
         },
+        python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
     )
 
 
diff --git a/tox.ini b/tox.ini
index 88fcd426183bd..a20d2c5546040 100644
--- a/tox.ini
+++ b/tox.ini
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -28,7 +28,7 @@ find_links =
 
 [flake8]
 max-line-length = 90
-ignore = E731
+ignore = E731,W503
 
 [testenv]
 deps =
@@ -64,6 +64,7 @@ passenv =
     BOTO_CONFIG
     KRB5_CONFIG
     KRB5_KTNAME
+    SLUGIFY_USES_TEXT_UNIDECODE
 
 commands =
   pip wheel -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]

From 862ad8b9c2eb9af206d369bc661b6a2decc22148 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Fri, 3 Aug 2018 09:11:55 +0200
Subject: [PATCH 034/808] [AIRFLOW-XXX] Update changelog for 1.10

---
 CHANGELOG.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 00ee4a615ed0a..bfcef0f2d27d2 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,6 +1,8 @@
-AIRFLOW 1.10.0, 2018-07-08
+AIRFLOW 1.10.0, 2018-08-03
 --------------------------
-
+[AIRFLOW-2817] Force explicit choice on GPL dependency
+[AIRFLOW-2716] Replace async and await py3.7 keywords
+[AIRFLOW-2810] Fix typo in Xcom model timestamp
 [AIRFLOW-2710] Clarify fernet key value in documentation
 [AIRFLOW-2606] Fix DB schema and SQLAlchemy model
 [AIRFLOW-2646] Fix setup.py not to install snakebite on Python3

From c764c1114a9831443ea8ce6af89a8dd10f346ded Mon Sep 17 00:00:00 2001
From: "Taylor D. Edmiston" <tedmiston@gmail.com>
Date: Tue, 7 Aug 2018 10:20:30 -0400
Subject: [PATCH 035/808] [AIRFLOW-2857] Fix Read the Docs env (#3703)

The Read the Docs build process was broken due to #3660. This PR fixes this.

(cherry picked from commit 8af0aa96bfe3caa51d67ab393db069d37b0c4169)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 .readthedocs.yml | 6 +++---
 setup.py         | 9 +++++++++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 643548c03e07a..c6a4da8d690c8 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -22,4 +22,4 @@ python:
         - doc
         - docker
         - gcp_api
-        - emr 
+        - emr
diff --git a/setup.py b/setup.py
index 2f5f730af9b25..25b3c8c5ca77c 100644
--- a/setup.py
+++ b/setup.py
@@ -36,6 +36,14 @@
 
 # See LEGAL-362
 def verify_gpl_dependency():
+    # The Read the Docs build environment [1] does a pip install of Airflow which cannot
+    # be overridden with custom environment variables, so we detect the READTHEDOCS env
+    # var they provide to set the env var that avoids the GPL dependency on install when
+    # building the docs site.
+    # [1]: http://docs.readthedocs.io/en/latest/builds.html#build-environment
+    if os.getenv("READTHEDOCS") == "True":
+        os.environ["SLUGIFY_USES_TEXT_UNIDECODE"] = "yes"
+
     if (not os.getenv("AIRFLOW_GPL_UNIDECODE")
             and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes"):
         raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
@@ -142,6 +150,7 @@ def write_version(filename=os.path.join(*['airflow',
 databricks = ['requests>=2.5.1, <3']
 datadog = ['datadog>=0.14.0']
 doc = [
+    'mock',
     'sphinx>=1.2.3',
     'sphinx-argparse>=0.1.13',
     'sphinx-rtd-theme>=0.1.6',

From 26f6faed690846c963f90fe06458b3711d841e25 Mon Sep 17 00:00:00 2001
From: William Horton <wdt.horton@gmail.com>
Date: Tue, 7 Aug 2018 15:48:28 -0700
Subject: [PATCH 036/808] [AIRFLOW-2869] Remove smart quote from default config

Closes #3716 from wdhorton/remove-smart-quote-
from-cfg

(cherry picked from commit 67e2bb96cdc5ea37226d11332362d3bd3778cea0)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit 700f5f088dbead866170c9a3fe7e021e86ab30bb)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/config_templates/default_airflow.cfg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 2f6130c8975f7..9a15dc0d117e8 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -606,7 +606,7 @@ image_pull_secrets =
 gcp_service_account_keys =
 
 # Use the service account kubernetes gives to pods to connect to kubernetes cluster.
-# It’s intended for clients that expect to be running inside a pod running on kubernetes.
+# It's intended for clients that expect to be running inside a pod running on kubernetes.
 # It will raise an exception if called from a process not running in a kubernetes environment.
 in_cluster = True
 

From 3a981389beefb1f45dff44a8748b2a2601963136 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 7 Aug 2018 19:43:41 +0100
Subject: [PATCH 037/808] [AIRFLOW-2140] Don't require kubernetes for the
 SparkSubmit hook (#3700)

This extra dep is a quasi-breaking change when upgrading - previously
there were no deps outside of Airflow itself for this hook. Importing
the k8s libs breaks installs that aren't also using Kubernetes.

This makes the dep optional for anyone who doesn't explicitly use the
functionality

(cherry picked from commit 0be002eebb182b607109a0390d7f6fb8795c668b)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit f58246d2ef265eb762c179a12c40e011ce62cea1)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/contrib/hooks/spark_submit_hook.py |  7 +++++--
 airflow/contrib/kubernetes/kube_client.py  | 14 +++++++++++++-
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 0185cab283345..65bb6134e6ac4 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -26,7 +26,6 @@
 from airflow.exceptions import AirflowException
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.contrib.kubernetes import kube_client
-from kubernetes.client.rest import ApiException
 
 
 class SparkSubmitHook(BaseHook, LoggingMixin):
@@ -136,6 +135,10 @@ def __init__(self,
         self._connection = self._resolve_connection()
         self._is_yarn = 'yarn' in self._connection['master']
         self._is_kubernetes = 'k8s' in self._connection['master']
+        if self._is_kubernetes and kube_client is None:
+            raise RuntimeError(
+                "{master} specified by kubernetes dependencies are not installed!".format(
+                    self._connection['master']))
 
         self._should_track_driver_status = self._resolve_should_track_driver_status()
         self._driver_id = None
@@ -559,6 +562,6 @@ def on_kill(self):
 
                     self.log.info("Spark on K8s killed with response: %s", api_response)
 
-                except ApiException as e:
+                except kube_client.ApiException as e:
                     self.log.info("Exception when attempting to kill Spark on K8s:")
                     self.log.exception(e)
diff --git a/airflow/contrib/kubernetes/kube_client.py b/airflow/contrib/kubernetes/kube_client.py
index 8b71f41242329..4b8fa17155eed 100644
--- a/airflow/contrib/kubernetes/kube_client.py
+++ b/airflow/contrib/kubernetes/kube_client.py
@@ -17,9 +17,21 @@
 from airflow.configuration import conf
 from six import PY2
 
+try:
+    from kubernetes import config, client
+    from kubernetes.client.rest import ApiException
+    has_kubernetes = True
+except ImportError as e:
+    # We need an exception class to be able to use it in ``except`` elsewhere
+    # in the code base
+    ApiException = BaseException
+    has_kubernetes = False
+    _import_err = e
+
 
 def _load_kube_config(in_cluster, cluster_context, config_file):
-    from kubernetes import config, client
+    if not has_kubernetes:
+        raise _import_err
     if in_cluster:
         config.load_incluster_config()
     else:

From a6d5ee9ce57bcdd22dde3fdf00e3b1cd26274ede Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Wed, 8 Aug 2018 08:07:08 +0200
Subject: [PATCH 038/808] [AIRFLOW-2859] Implement own UtcDateTime (#3708)

The different UtcDateTime implementations all have issues.
Either they replace tzinfo directly without converting
or they do not convert to UTC at all.

We also ensure all mysql connections are in UTC
in order to keep sanity, as mysql will ignore the
timezone of a field when inserting/updating.

(cherry picked from commit 6fd4e6055e36e9867923b0b402363fcd8c30e297)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit 8fc8c7ae5483c002f5264b087b26a20fd8ae7b67)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 airflow/bin/cli.py                |   1 -
 airflow/jobs.py                   |   6 +-
 airflow/models.py                 |   2 +-
 airflow/utils/sqlalchemy.py       |  61 +++++++++++++++++-
 run_unit_tests.sh                 |   5 +-
 setup.py                          |   1 -
 tests/core.py                     |  10 +--
 tests/test_utils/fake_datetime.py |   4 +-
 tests/utils/test_sqlalchemy.py    | 101 ++++++++++++++++++++++++++++++
 9 files changed, 174 insertions(+), 17 deletions(-)
 create mode 100644 tests/utils/test_sqlalchemy.py

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index b56e3253276bc..ac52a42664caf 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1003,7 +1003,6 @@ def initdb(args):  # noqa
     print("Done.")
 
 
-@cli_utils.action_logging
 def resetdb(args):
     print("DB: " + repr(settings.engine.url))
     if args.yes or input("This will drop existing tables "
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 70891ab4c370b..e2cf830aca296 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -40,7 +40,6 @@
     Column, Integer, String, func, Index, or_, and_, not_)
 from sqlalchemy.exc import OperationalError
 from sqlalchemy.orm.session import make_transient
-from sqlalchemy_utc import UtcDateTime
 from tabulate import tabulate
 from time import sleep
 
@@ -52,6 +51,7 @@
 from airflow.task.task_runner import get_task_runner
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, RUN_DEPS
 from airflow.utils import asciiart, helpers, timezone
+from airflow.utils.configuration import tmp_configuration_copy
 from airflow.utils.dag_processing import (AbstractDagFileProcessor,
                                           DagFileProcessorManager,
                                           SimpleDag,
@@ -60,9 +60,9 @@
 from airflow.utils.db import create_session, provide_session
 from airflow.utils.email import send_email
 from airflow.utils.log.logging_mixin import LoggingMixin, set_context, StreamLogWriter
-from airflow.utils.state import State
-from airflow.utils.configuration import tmp_configuration_copy
 from airflow.utils.net import get_hostname
+from airflow.utils.state import State
+from airflow.utils.sqlalchemy import UtcDateTime
 
 Base = models.Base
 ID_LEN = models.ID_LEN
diff --git a/airflow/models.py b/airflow/models.py
index b789fd17323e2..2096785b41c57 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -60,7 +60,6 @@
 from sqlalchemy import func, or_, and_, true as sqltrue
 from sqlalchemy.ext.declarative import declarative_base, declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
-from sqlalchemy_utc import UtcDateTime
 
 from croniter import croniter
 import six
@@ -88,6 +87,7 @@
     as_tuple, is_container, validate_key, pprinttable)
 from airflow.utils.operator_resources import Resources
 from airflow.utils.state import State
+from airflow.utils.sqlalchemy import UtcDateTime
 from airflow.utils.timeout import timeout
 from airflow.utils.trigger_rule import TriggerRule
 from airflow.utils.weight_rule import WeightRule
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index 4dab322d4a106..46f4f86eface8 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -22,15 +22,19 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
+import datetime
 import os
+import pendulum
 import time
 import random
 
 from sqlalchemy import event, exc, select
+from sqlalchemy.types import DateTime, TypeDecorator
 
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 log = LoggingMixin().log
+utc = pendulum.timezone('UTC')
 
 
 def setup_event_handlers(
@@ -101,13 +105,21 @@ def ping_connection(connection, branch):
     def connect(dbapi_connection, connection_record):
         connection_record.info['pid'] = os.getpid()
 
-    @event.listens_for(engine, "connect")
-    def set_sqlite_pragma(dbapi_connection, connection_record):
-        if 'sqlite3.Connection' in str(type(dbapi_connection)):
+    if engine.dialect.name == "sqlite":
+        @event.listens_for(engine, "connect")
+        def set_sqlite_pragma(dbapi_connection, connection_record):
             cursor = dbapi_connection.cursor()
             cursor.execute("PRAGMA foreign_keys=ON")
             cursor.close()
 
+    # this ensures sanity in mysql when storing datetimes (not required for postgres)
+    if engine.dialect.name == "mysql":
+        @event.listens_for(engine, "connect")
+        def set_mysql_timezone(dbapi_connection, connection_record):
+            cursor = dbapi_connection.cursor()
+            cursor.execute("SET time_zone = '+00:00'")
+            cursor.close()
+
     @event.listens_for(engine, "checkout")
     def checkout(dbapi_connection, connection_record, connection_proxy):
         pid = os.getpid()
@@ -117,3 +129,46 @@ def checkout(dbapi_connection, connection_record, connection_proxy):
                 "Connection record belongs to pid {}, "
                 "attempting to check out in pid {}".format(connection_record.info['pid'], pid)
             )
+
+
+class UtcDateTime(TypeDecorator):
+    """
+    Almost equivalent to :class:`~sqlalchemy.types.DateTime` with
+    ``timezone=True`` option, but it differs from that by:
+    - Never silently take naive :class:`~datetime.datetime`, instead it
+      always raise :exc:`ValueError` unless time zone aware value.
+    - :class:`~datetime.datetime` value's :attr:`~datetime.datetime.tzinfo`
+      is always converted to UTC.
+    - Unlike SQLAlchemy's built-in :class:`~sqlalchemy.types.DateTime`,
+      it never return naive :class:`~datetime.datetime`, but time zone
+      aware value, even with SQLite or MySQL.
+    - Always returns DateTime in UTC
+    """
+
+    impl = DateTime(timezone=True)
+
+    def process_bind_param(self, value, dialect):
+        if value is not None:
+            if not isinstance(value, datetime.datetime):
+                raise TypeError('expected datetime.datetime, not ' +
+                                repr(value))
+            elif value.tzinfo is None:
+                raise ValueError('naive datetime is disallowed')
+
+            return value.astimezone(utc)
+
+    def process_result_value(self, value, dialect):
+        """
+        Processes DateTimes from the DB making sure it is always
+        returning UTC. Not using timezone.convert_to_utc as that
+        converts to configured TIMEZONE while the DB might be
+        running with some other setting. We assume UTC datetimes
+        in the database.
+        """
+        if value is not None:
+            if value.tzinfo is None:
+                value = value.replace(tzinfo=utc)
+            else:
+                value = value.astimezone(utc)
+
+        return value
diff --git a/run_unit_tests.sh b/run_unit_tests.sh
index 42c78f3439e7b..27e4d08af1416 100755
--- a/run_unit_tests.sh
+++ b/run_unit_tests.sh
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -91,3 +91,4 @@ nosetests $nose_args
 
 # To run individual tests:
 # nosetests tests.core:CoreTest.test_scheduler_job
+
diff --git a/setup.py b/setup.py
index 25b3c8c5ca77c..af8b1958f7dc8 100644
--- a/setup.py
+++ b/setup.py
@@ -298,7 +298,6 @@ def do_setup():
             'requests>=2.5.1, <3',
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.2.0',
-            'sqlalchemy-utc>=0.9.0',
             'tabulate>=0.7.5, <0.8.0',
             'tenacity==4.8.0',
             'thrift>=0.9.2',
diff --git a/tests/core.py b/tests/core.py
index c3adb3c5005aa..0c178b4f715d3 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -38,7 +38,6 @@
 from email.mime.application import MIMEApplication
 from email.mime.multipart import MIMEMultipart
 from email.mime.text import MIMEText
-from freezegun import freeze_time
 from numpy.testing import assert_array_almost_equal
 from six.moves.urllib.parse import urlencode
 from time import sleep
@@ -70,6 +69,7 @@
 from airflow.configuration import AirflowConfigException, run_command
 from jinja2.sandbox import SecurityError
 from jinja2 import UndefinedError
+from pendulum import utcnow
 
 import six
 
@@ -261,7 +261,6 @@ def test_schedule_dag_start_end_dates(self):
 
         self.assertIsNone(additional_dag_run)
 
-    @freeze_time('2016-01-01')
     def test_schedule_dag_no_end_date_up_to_today_only(self):
         """
         Tests that a Dag created without an end_date can only be scheduled up
@@ -273,8 +272,11 @@ def test_schedule_dag_no_end_date_up_to_today_only(self):
         """
         session = settings.Session()
         delta = timedelta(days=1)
-        start_date = DEFAULT_DATE
-        runs = 365
+        now = utcnow()
+        start_date = now.subtract(weeks=1)
+
+        runs = (now - start_date).days
+
         dag = DAG(TEST_DAG_ID + 'test_schedule_dag_no_end_date_up_to_today_only',
                   start_date=start_date,
                   schedule_interval=delta)
diff --git a/tests/test_utils/fake_datetime.py b/tests/test_utils/fake_datetime.py
index 42bb01df01811..8182d83e9a086 100644
--- a/tests/test_utils/fake_datetime.py
+++ b/tests/test_utils/fake_datetime.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_sqlalchemy.py b/tests/utils/test_sqlalchemy.py
new file mode 100644
index 0000000000000..66f00f9427c6b
--- /dev/null
+++ b/tests/utils/test_sqlalchemy.py
@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import datetime
+import unittest
+
+from airflow import settings
+from airflow.models import DAG
+from airflow.settings import Session
+from airflow.utils.state import State
+from airflow.utils.timezone import utcnow
+
+from sqlalchemy.exc import StatementError
+
+
+class TestSqlAlchemyUtils(unittest.TestCase):
+    def setUp(self):
+        session = Session()
+
+        # make sure NOT to run in UTC. Only postgres supports storing
+        # timezone information in the datetime field
+        if session.bind.dialect.name == "postgresql":
+            session.execute("SET timezone='Europe/Amsterdam'")
+
+        self.session = session
+
+    def test_utc_transformations(self):
+        """
+        Test whether what we are storing is what we are retrieving
+        for datetimes
+        """
+        dag_id = 'test_utc_transformations'
+        start_date = utcnow()
+        iso_date = start_date.isoformat()
+        execution_date = start_date + datetime.timedelta(hours=1, days=1)
+
+        dag = DAG(
+            dag_id=dag_id,
+            start_date=start_date,
+        )
+        dag.clear()
+
+        run = dag.create_dagrun(
+            run_id=iso_date,
+            state=State.NONE,
+            execution_date=execution_date,
+            start_date=start_date,
+            session=self.session,
+        )
+
+        self.assertEqual(execution_date, run.execution_date)
+        self.assertEqual(start_date, run.start_date)
+
+        self.assertEqual(execution_date.utcoffset().total_seconds(), 0.0)
+        self.assertEqual(start_date.utcoffset().total_seconds(), 0.0)
+
+        self.assertEqual(iso_date, run.run_id)
+        self.assertEqual(run.start_date.isoformat(), run.run_id)
+
+        dag.clear()
+
+    def test_process_bind_param_naive(self):
+        """
+        Check if naive datetimes are prevented from saving to the db
+        """
+        dag_id = 'test_process_bind_param_naive'
+
+        # naive
+        start_date = datetime.datetime.now()
+        dag = DAG(dag_id=dag_id, start_date=start_date)
+        dag.clear()
+
+        with self.assertRaises((ValueError, StatementError)):
+            dag.create_dagrun(
+                run_id=start_date.isoformat,
+                state=State.NONE,
+                execution_date=start_date,
+                start_date=start_date,
+                session=self.session
+            )
+        dag.clear()
+
+    def tearDown(self):
+        self.session.close()
+        settings.engine.dispose()

From 95dc7f04a866026c039786110078e1095b9eec70 Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Wed, 8 Aug 2018 19:12:34 +0200
Subject: [PATCH 039/808] [AIRFLOW-2870] Use abstract TaskInstance for
 migration (#3720)

If we use the full model for migration it can have columns
added that are not available yet in the database. Using
an abstraction ensures only the columns that are required
for data migration are present.

(cherry picked from commit 546f1cdb5208ba8e1cf3bde36bbdbb639fa20b22)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit 95aa49a71dcc69d2e9a8e32b69a2a61cacec2b1b)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 ...24_add_executor_config_to_task_instance.py | 24 ++++++++++++-------
 ...4_add_kubernetes_resource_checkpointing.py | 24 ++++++++++++-------
 ...5c0_add_kubernetes_scheduler_uniqueness.py | 24 ++++++++++++-------
 ...7_add_max_tries_column_to_task_instance.py | 20 +++++++++++++++-
 4 files changed, 64 insertions(+), 28 deletions(-)

diff --git a/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py b/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
index b7213a3031ddd..27a9f593b54df 100644
--- a/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
+++ b/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
@@ -1,16 +1,22 @@
 # flake8: noqa
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 
 """kubernetes_resource_checkpointing
 
diff --git a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
index 4347bae92af1e..c489c05f7ea39 100644
--- a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
+++ b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
@@ -1,16 +1,22 @@
 # flake8: noqa
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 
 """kubernetes_resource_checkpointing
 
diff --git a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
index 6bc48f1105639..5c921c6a98aaf 100644
--- a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
+++ b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
@@ -1,16 +1,22 @@
 # flake8: noqa
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 
 """add kubernetes scheduler uniqueness
 
diff --git a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
index 0503d93df5bec..3c56f0707b57b 100644
--- a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
+++ b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
@@ -1,3 +1,4 @@
+# flake8: noqa
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
@@ -33,10 +34,27 @@
 from alembic import op
 import sqlalchemy as sa
 from airflow import settings
-from airflow.models import DagBag, TaskInstance
+from airflow.models import DagBag
+from airflow.utils.sqlalchemy import UtcDateTime
+
+from sqlalchemy import (
+    Column, Integer, String)
 from sqlalchemy.engine.reflection import Inspector
+from sqlalchemy.ext.declarative import declarative_base
 
+Base = declarative_base()
 BATCH_SIZE = 5000
+ID_LEN = 250
+
+
+class TaskInstance(Base):
+    __tablename__ = "task_instance"
+
+    task_id = Column(String(ID_LEN), primary_key=True)
+    dag_id = Column(String(ID_LEN), primary_key=True)
+    execution_date = Column(UtcDateTime, primary_key=True)
+    max_tries = Column(Integer)
+    try_number = Column(Integer, default=0)
 
 
 def upgrade():

From 55200b48bbc0bf86db72c2b7eab01109bb98102f Mon Sep 17 00:00:00 2001
From: Andy Cooper <andycooper.s@gmail.com>
Date: Wed, 8 Aug 2018 07:49:43 -0400
Subject: [PATCH 040/808] [AIRFLOW-2856] Pass in
 SLUGIFY_USES_TEXT_UNIDECODE=yes ENV to docker run (#3701)

(cherry picked from commit 8687ab9271b7b93473584a720f225f20fa9a7aa4)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
(cherry picked from commit 3670d49a4c5da4769be1df5b4f8ef3504b74a184)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 CONTRIBUTING.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e45060bfe75c0..21cbd5010c4ee 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -85,10 +85,7 @@ Go to your Airflow directory and start a new docker container. You can choose be
 
 ```
 # Start docker in your Airflow directory
-docker run -t -i -v `pwd`:/airflow/ python:2 bash
-
-# Go to the Airflow directory
-cd /airflow/
+docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:2 bash
 
 # Install Airflow with all the required dependencies,
 # including the devel which will provide the development tools

From 26e0d449737e8671000f671d820a9537f23f345a Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Wed, 8 Aug 2018 20:10:41 +0200
Subject: [PATCH 041/808] [AIRFLOW-XXX] Update changelog for 1.10

(cherry picked from commit 8b04e20709ebeb41aeefc0c5e3f12d35108ea504)
Signed-off-by: Bolke de Bruin <bolke@xs4all.nl>
---
 CHANGELOG.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index bfcef0f2d27d2..b4ee1755b467a 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,5 +1,10 @@
 AIRFLOW 1.10.0, 2018-08-03
 --------------------------
+[AIRFLOW-2870] Use abstract TaskInstance for migration
+[AIRFLOW-2859] Implement own UtcDateTime (#3708)
+[AIRFLOW-2140] Don't require kubernetes for the SparkSubmit hook
+[AIRFLOW-2869] Remove smart quote from default config
+[AIRFLOW-2857] Fix Read the Docs env
 [AIRFLOW-2817] Force explicit choice on GPL dependency
 [AIRFLOW-2716] Replace async and await py3.7 keywords
 [AIRFLOW-2810] Fix typo in Xcom model timestamp

From 948b09da20be7e027bb315618fa0901ef8b48b80 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 22 Aug 2018 17:06:09 +0800
Subject: [PATCH 042/808] [AIRFLOW-2921][AIRFLOW-2922] Fix bugs in
 CeleryExecutor (#3773)

Bug-1:
if a task state becomes either SUCCESS or FAILURE or REVOKED,
it will be removed from self.tasks() and self.last_state().
However, because line 108 is not indented properly,
this task will be added back to self.last_state() again.

Bug-2:
When the state is updated, it's referring to the latest
state `task.state` rather than variable `state`.
This may result in dead-lock if the state changed from
`STARTED` to `SUCCESS` after the if-elif-else block
started.

Test case is updated for fix to bug-1.
---
 airflow/executors/celery_executor.py    | 4 ++--
 tests/executors/test_celery_executor.py | 6 +++++-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 481daa5826686..6ada005ab77d2 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -106,8 +106,8 @@ def sync(self):
                         del self.tasks[key]
                         del self.last_state[key]
                     else:
-                        self.log.info("Unexpected state: %s", task.state)
-                    self.last_state[key] = task.state
+                        self.log.info("Unexpected state: %s", state)
+                        self.last_state[key] = state
             except Exception as e:
                 self.log.error("Error syncing the celery executor, ignoring it:")
                 self.log.exception(e)
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 1169c8d11b95c..d5fbbbcf1c78c 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -25,7 +25,8 @@
 from airflow.utils.state import State
 
 # leave this it is used by the test worker
-import celery.contrib.testing.tasks
+import celery.contrib.testing.tasks  # noqa: F401
+
 
 class CeleryExecutorTest(unittest.TestCase):
     def test_celery_integration(self):
@@ -53,6 +54,9 @@ def test_celery_integration(self):
         self.assertNotIn('success', executor.tasks)
         self.assertNotIn('fail', executor.tasks)
 
+        self.assertNotIn('success', executor.last_state)
+        self.assertNotIn('fail', executor.last_state)
+
 
 if __name__ == '__main__':
     unittest.main()

From 4040ce2bf4d2d51ca226c9b7b169570b224f0990 Mon Sep 17 00:00:00 2001
From: Dan Davydov <ddavydov@twitter.com>
Date: Mon, 20 Aug 2018 09:14:22 -0400
Subject: [PATCH 043/808] [AIRFLOW-2895] Prevent scheduler from spamming
 heartbeats/logs

Reverts most of AIRFLOW-2027 until the issues with it can be fixed.

Closes #3747 from aoen/revert_min_file_parsing_time_commit
---
 README.md                                    |  1 +
 UPDATING.md                                  |  6 +++
 airflow/config_templates/default_airflow.cfg |  4 +-
 airflow/jobs.py                              | 42 +++++++++++---------
 airflow/utils/dag_processing.py              | 25 ++----------
 scripts/ci/kubernetes/kube/configmaps.yaml   |  3 --
 tests/utils/test_dag_processing.py           |  2 -
 7 files changed, 35 insertions(+), 48 deletions(-)

diff --git a/README.md b/README.md
index e68d26cc8cfa2..f5fe2e1bdcd4c 100644
--- a/README.md
+++ b/README.md
@@ -233,6 +233,7 @@ Currently **officially** using Airflow:
 1. [Tile](https://tile.com/) [[@ranjanmanish](https://github.com/ranjanmanish)]
 1. [Tokopedia](https://www.tokopedia.com/) [@topedmaria](https://github.com/topedmaria)
 1. [Twine Labs](https://www.twinelabs.com/) [[@ivorpeles](https://github.com/ivorpeles)]
+1. [Twitter](https://www.twitter.com/) [[@aoen](https://github.com/aoen)]
 1. [T2 Systems](http://t2systems.com) [[@unclaimedpants](https://github.com/unclaimedpants)]
 1. [Ubisoft](https://www.ubisoft.com/) [[@Walkoss](https://github.com/Walkoss)]
 1. [United Airlines](https://www.united.com/) [[@ilopezfr](https://github.com/ilopezfr)]
diff --git a/UPDATING.md b/UPDATING.md
index 3b47882212225..d00e4f8742f26 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -5,6 +5,11 @@ assists users migrating to a new version.
 
 ## Airflow Master
 
+### min_file_parsing_loop_time config option temporarily disabled
+
+The scheduler.min_file_parsing_loop_time config option has been temporarily removed due to
+some bugs.
+
 ## Airflow 1.10
 
 Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
@@ -386,6 +391,7 @@ indefinitely. This is only available on the command line.
 After how much time should an updated DAG be picked up from the filesystem.
 
 #### min_file_parsing_loop_time
+CURRENTLY DISABLED DUE TO A BUG
 How many seconds to wait between file-parsing loops to prevent the logs from being spammed.
 
 #### dag_dir_list_interval
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 9a15dc0d117e8..deb67bb96ca25 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -428,9 +428,7 @@ run_duration = -1
 # after how much time a new DAGs should be picked up from the filesystem
 min_file_process_interval = 0
 
-# How many seconds to wait between file-parsing loops to prevent the logs from being spammed.
-min_file_parsing_loop_time = 1
-
+# How often (in seconds) to scan the DAGs directory for new files. Default to 5 minutes.
 dag_dir_list_interval = 300
 
 # How often should stats be printed to the logs
diff --git a/airflow/jobs.py b/airflow/jobs.py
index e2cf830aca296..88aa643c50152 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -532,8 +532,7 @@ def __init__(
             num_runs=-1,
             file_process_interval=conf.getint('scheduler',
                                               'min_file_process_interval'),
-            min_file_parsing_loop_time=conf.getint('scheduler',
-                                                   'min_file_parsing_loop_time'),
+            processor_poll_interval=1.0,
             run_duration=None,
             do_pickle=False,
             log=None,
@@ -548,6 +547,8 @@ def __init__(
         :type subdir: unicode
         :param num_runs: The number of times to try to schedule each DAG file.
         -1 for unlimited within the run_duration.
+        :param processor_poll_interval: The number of seconds to wait between
+        polls of running processors
         :param run_duration: how long to run (in seconds) before exiting
         :type run_duration: int
         :param do_pickle: once a DAG object is obtained by executing the Python
@@ -564,6 +565,7 @@ def __init__(
 
         self.num_runs = num_runs
         self.run_duration = run_duration
+        self._processor_poll_interval = processor_poll_interval
 
         self.do_pickle = do_pickle
         super(SchedulerJob, self).__init__(*args, **kwargs)
@@ -592,10 +594,7 @@ def __init__(
         # to 3 minutes.
         self.file_process_interval = file_process_interval
 
-        # Wait until at least this many seconds have passed before parsing files once all
-        # files have finished parsing.
-        self.min_file_parsing_loop_time = min_file_parsing_loop_time
-
+        self.max_tis_per_query = conf.getint('scheduler', 'max_tis_per_query')
         if run_duration is None:
             self.run_duration = conf.getint('scheduler',
                                             'run_duration')
@@ -1550,16 +1549,18 @@ def _execute(self):
         # DAGs in parallel. By processing them in separate processes,
         # we can get parallelism and isolation from potentially harmful
         # user code.
-        self.log.info("Processing files using up to %s processes at a time",
-                      self.max_threads)
+        self.log.info(
+            "Processing files using up to %s processes at a time",
+            self.max_threads)
         self.log.info("Running execute loop for %s seconds", self.run_duration)
         self.log.info("Processing each file at most %s times", self.num_runs)
-        self.log.info("Process each file at most once every %s seconds",
-                      self.file_process_interval)
-        self.log.info("Wait until at least %s seconds have passed between file parsing "
-                      "loops", self.min_file_parsing_loop_time)
-        self.log.info("Checking for new files in %s every %s seconds",
-                      self.subdir, self.dag_dir_list_interval)
+        self.log.info(
+            "Process each file at most once every %s seconds",
+            self.file_process_interval)
+        self.log.info(
+            "Checking for new files in %s every %s seconds",
+            self.subdir,
+            self.dag_dir_list_interval)
 
         # Build up a list of Python files that could contain DAGs
         self.log.info("Searching for files in %s", self.subdir)
@@ -1575,7 +1576,6 @@ def processor_factory(file_path):
                                                     known_file_paths,
                                                     self.max_threads,
                                                     self.file_process_interval,
-                                                    self.min_file_parsing_loop_time,
                                                     self.num_runs,
                                                     processor_factory)
 
@@ -1722,13 +1722,17 @@ def _execute_helper(self, processor_manager):
                 last_stat_print_time = timezone.utcnow()
 
             loop_end_time = time.time()
-            self.log.debug("Ran scheduling loop in %.2f seconds",
-                           loop_end_time - loop_start_time)
+            self.log.debug(
+                "Ran scheduling loop in %.2f seconds",
+                loop_end_time - loop_start_time)
+            self.log.debug("Sleeping for %.2f seconds", self._processor_poll_interval)
+            time.sleep(self._processor_poll_interval)
 
             # Exit early for a test mode
             if processor_manager.max_runs_reached():
-                self.log.info("Exiting loop as all files have been processed %s times",
-                              self.num_runs)
+                self.log.info(
+                    "Exiting loop as all files have been processed %s times",
+                    self.num_runs)
                 break
 
         # Stop any processors
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index e236397da0284..43948837065e3 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -326,7 +326,6 @@ def __init__(self,
                  file_paths,
                  parallelism,
                  process_file_interval,
-                 min_file_parsing_loop_time,
                  max_runs,
                  processor_factory):
         """
@@ -340,9 +339,6 @@ def __init__(self,
         :param process_file_interval: process a file at most once every this
         many seconds
         :type process_file_interval: float
-        :param min_file_parsing_loop_time: wait until at least this many seconds have
-        passed before parsing files once all files have finished parsing.
-        :type min_file_parsing_loop_time: float
         :param max_runs: The number of times to parse and schedule each file. -1
         for unlimited.
         :type max_runs: int
@@ -358,7 +354,6 @@ def __init__(self,
         self._dag_directory = dag_directory
         self._max_runs = max_runs
         self._process_file_interval = process_file_interval
-        self._min_file_parsing_loop_time = min_file_parsing_loop_time
         self._processor_factory = processor_factory
         # Map from file path to the processor
         self._processors = {}
@@ -529,24 +524,12 @@ def heartbeat(self):
             file_paths_in_progress = self._processors.keys()
             now = timezone.utcnow()
             file_paths_recently_processed = []
-
-            longest_parse_duration = 0
             for file_path in self._file_paths:
                 last_finish_time = self.get_last_finish_time(file_path)
-                if last_finish_time is not None:
-                    duration = now - last_finish_time
-                    longest_parse_duration = max(duration.total_seconds(),
-                                                 longest_parse_duration)
-                    if duration.total_seconds() < self._process_file_interval:
-                        file_paths_recently_processed.append(file_path)
-
-            sleep_length = max(self._min_file_parsing_loop_time - longest_parse_duration,
-                               0)
-            if sleep_length > 0:
-                self.log.debug("Sleeping for %.2f seconds to prevent excessive "
-                               "logging",
-                               sleep_length)
-                time.sleep(sleep_length)
+                if (last_finish_time is not None and
+                    (now - last_finish_time).total_seconds() <
+                        self._process_file_interval):
+                    file_paths_recently_processed.append(file_path)
 
             files_paths_at_run_limit = [file_path
                                         for file_path, num_runs in self._run_count.items()
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index 7b91aa2e8724c..1673c3e54b577 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -57,9 +57,6 @@ data:
     statsd_port = 8125
     statsd_prefix = airflow
 
-    # How many seconds to wait between file-parsing loops to prevent the logs from being spammed.
-    min_file_parsing_loop_time = 1
-
     print_stats_interval = 30
     scheduler_zombie_task_threshold = 300
     max_tis_per_query = 0
diff --git a/tests/utils/test_dag_processing.py b/tests/utils/test_dag_processing.py
index 7abe7efe9b35c..f29e384b8c657 100644
--- a/tests/utils/test_dag_processing.py
+++ b/tests/utils/test_dag_processing.py
@@ -32,7 +32,6 @@ def test_set_file_paths_when_processor_file_path_not_in_new_file_paths(self):
             parallelism=1,
             process_file_interval=1,
             max_runs=1,
-            min_file_parsing_loop_time=0,
             processor_factory=MagicMock().return_value)
 
         mock_processor = MagicMock()
@@ -52,7 +51,6 @@ def test_set_file_paths_when_processor_file_path_is_in_new_file_paths(self):
             parallelism=1,
             process_file_interval=1,
             max_runs=1,
-            min_file_parsing_loop_time=0,
             processor_factory=MagicMock().return_value)
 
         mock_processor = MagicMock()

From 392ad4af83dccc0176e5ad12764d287227b9c48b Mon Sep 17 00:00:00 2001
From: Diego Mora Cespedes <d.moracespedes@gmail.com>
Date: Wed, 4 Jul 2018 23:51:29 +0100
Subject: [PATCH 044/808] [AIRFLOW-2713] Rename async variable in setup.py for
 Python 3.7.0 compatibility

Closes #3561 from Perados/rename-async-to-
async_packages-in-setup
---
 setup.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index af8b1958f7dc8..b48087084def9 100644
--- a/setup.py
+++ b/setup.py
@@ -121,7 +121,8 @@ def write_version(filename=os.path.join(*['airflow',
     with open(filename, 'w') as a:
         a.write(text)
 
-async = [
+
+async_packages = [
     'greenlet>=0.4.9',
     'eventlet>= 0.9.7',
     'gevent>=0.13'
@@ -314,7 +315,7 @@ def do_setup():
             'devel_ci': devel_ci,
             'all_dbs': all_dbs,
             'atlas': atlas,
-            'async': async,
+            'async': async_packages,
             'azure_blob_storage': azure_blob_storage,
             'azure_data_lake': azure_data_lake,
             'cassandra': cassandra,

From 152214ea6dd08533aa40e455415c2741259482e9 Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Thu, 30 Aug 2018 14:26:11 +0200
Subject: [PATCH 045/808] [AIRFLOW-2984] Convert operator dates to UTC (#3822)

Tasks can have start_dates or end_dates separately
from the DAG. These need to be converted to UTC otherwise
we cannot use them for calculation the next execution
date.
---
 airflow/models.py |  7 +++++
 docs/timezone.rst | 67 +++++++++++++++++++++++++----------------------
 tests/core.py     |  2 +-
 tests/models.py   | 10 +++++++
 4 files changed, 53 insertions(+), 33 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 2096785b41c57..7437a19521b5f 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2387,10 +2387,17 @@ def __init__(
         self.email = email
         self.email_on_retry = email_on_retry
         self.email_on_failure = email_on_failure
+
         self.start_date = start_date
         if start_date and not isinstance(start_date, datetime):
             self.log.warning("start_date for %s isn't datetime.datetime", self)
+        elif start_date:
+            self.start_date = timezone.convert_to_utc(start_date)
+
         self.end_date = end_date
+        if end_date:
+            self.end_date = timezone.convert_to_utc(end_date)
+
         if not TriggerRule.is_valid(trigger_rule):
             raise AirflowException(
                 "The trigger_rule must be one of {all_triggers},"
diff --git a/docs/timezone.rst b/docs/timezone.rst
index 9e8598e2ed464..fe44ecfbb9f62 100644
--- a/docs/timezone.rst
+++ b/docs/timezone.rst
@@ -2,23 +2,23 @@ Time zones
 ==========
 
 Support for time zones is enabled by default. Airflow stores datetime information in UTC internally and in the database.
-It allows you to run your DAGs with time zone dependent schedules. At the moment Airflow does not convert them to the 
-end user’s time zone in the user interface. There it will always be displayed in UTC. Also templates used in Operators 
+It allows you to run your DAGs with time zone dependent schedules. At the moment Airflow does not convert them to the
+end user’s time zone in the user interface. There it will always be displayed in UTC. Also templates used in Operators
 are not converted. Time zone information is exposed and it is up to the writer of DAG what do with it.
 
-This is handy if your users live in more than one time zone and you want to display datetime information according to 
+This is handy if your users live in more than one time zone and you want to display datetime information according to
 each user’s wall clock.
 
-Even if you are running Airflow in only one time zone it is still good practice to store data in UTC in your database 
-(also before Airflow became time zone aware this was also to recommended or even required setup). The main reason is 
-Daylight Saving Time (DST). Many countries have a system of DST, where clocks are moved forward in spring and backward 
-in autumn. If you’re working in local time, you’re likely to encounter errors twice a year, when the transitions 
-happen. (The pendulum and pytz documentation discusses these issues in greater detail.) This probably doesn’t matter 
-for a simple DAG, but it’s a problem if you are in, for example, financial services where you have end of day 
-deadlines to meet. 
+Even if you are running Airflow in only one time zone it is still good practice to store data in UTC in your database
+(also before Airflow became time zone aware this was also to recommended or even required setup). The main reason is
+Daylight Saving Time (DST). Many countries have a system of DST, where clocks are moved forward in spring and backward
+in autumn. If you’re working in local time, you’re likely to encounter errors twice a year, when the transitions
+happen. (The pendulum and pytz documentation discusses these issues in greater detail.) This probably doesn’t matter
+for a simple DAG, but it’s a problem if you are in, for example, financial services where you have end of day
+deadlines to meet.
 
-The time zone is set in `airflow.cfg`. By default it is set to utc, but you change it to use the system’s settings or 
-an arbitrary IANA time zone, e.g. `Europe/Amsterdam`. It is dependent on `pendulum`, which is more accurate than `pytz`. 
+The time zone is set in `airflow.cfg`. By default it is set to utc, but you change it to use the system’s settings or
+an arbitrary IANA time zone, e.g. `Europe/Amsterdam`. It is dependent on `pendulum`, which is more accurate than `pytz`.
 Pendulum is installed when you install Airflow.
 
 Please note that the Web UI currently only runs in UTC.
@@ -28,8 +28,8 @@ Concepts
 Naïve and aware datetime objects
 ''''''''''''''''''''''''''''''''
 
-Python’s datetime.datetime objects have a tzinfo attribute that can be used to store time zone information, 
-represented as an instance of a subclass of datetime.tzinfo. When this attribute is set and describes an offset, 
+Python’s datetime.datetime objects have a tzinfo attribute that can be used to store time zone information,
+represented as an instance of a subclass of datetime.tzinfo. When this attribute is set and describes an offset,
 a datetime object is aware. Otherwise, it’s naive.
 
 You can use timezone.is_aware() and timezone.is_naive() to determine whether datetimes are aware or naive.
@@ -39,7 +39,7 @@ Because Airflow uses time-zone-aware datetime objects. If your code creates date
 .. code:: python
 
     from airflow.utils import timezone
-    
+
     now = timezone.utcnow()
     a_date = timezone.datetime(2017,1,1)
 
@@ -49,9 +49,9 @@ Interpretation of naive datetime objects
 
 Although Airflow operates fully time zone aware, it still accepts naive date time objects for `start_dates`
 and `end_dates` in your DAG definitions. This is mostly in order to preserve backwards compatibility. In
-case a naive `start_date` or `end_date` is encountered the default time zone is applied. It is applied 
+case a naive `start_date` or `end_date` is encountered the default time zone is applied. It is applied
 in such a way that it is assumed that the naive date time is already in the default time zone. In other
-words if you have a default time zone setting of `Europe/Amsterdam` and create a naive datetime `start_date` of 
+words if you have a default time zone setting of `Europe/Amsterdam` and create a naive datetime `start_date` of
 `datetime(2017,1,1)` it is assumed to be a `start_date` of Jan 1, 2017 Amsterdam time.
 
 .. code:: python
@@ -65,16 +65,16 @@ words if you have a default time zone setting of `Europe/Amsterdam` and create a
     op = DummyOperator(task_id='dummy', dag=dag)
     print(op.owner) # Airflow
 
-Unfortunately, during DST transitions, some datetimes don’t exist or are ambiguous. 
-In such situations, pendulum raises an exception. That’s why you should always create aware 
+Unfortunately, during DST transitions, some datetimes don’t exist or are ambiguous.
+In such situations, pendulum raises an exception. That’s why you should always create aware
 datetime objects when time zone support is enabled.
 
-In practice, this is rarely an issue. Airflow gives you aware datetime objects in the models and DAGs, and most often, 
-new datetime objects are created from existing ones through timedelta arithmetic. The only datetime that’s often 
+In practice, this is rarely an issue. Airflow gives you aware datetime objects in the models and DAGs, and most often,
+new datetime objects are created from existing ones through timedelta arithmetic. The only datetime that’s often
 created in application code is the current time, and timezone.utcnow() automatically does the right thing.
 
 
-Default time zone 
+Default time zone
 '''''''''''''''''
 
 The default time zone is the time zone defined by the `default_timezone` setting under `[core]`. If
@@ -92,15 +92,15 @@ it is therefore important to make sure this setting is equal on all Airflow node
 Time zone aware DAGs
 --------------------
 
-Creating a time zone aware DAG is quite simple. Just make sure to supply a time zone aware `start_date`. It is 
+Creating a time zone aware DAG is quite simple. Just make sure to supply a time zone aware `start_date`. It is
 recommended to use `pendulum` for this, but `pytz` (to be installed manually) can also be used for this.
 
 .. code:: python
 
     import pendulum
-    
+
     local_tz = pendulum.timezone("Europe/Amsterdam")
-    
+
     default_args=dict(
         start_date=datetime(2016, 1, 1, tzinfo=local_tz),
         owner='Airflow'
@@ -110,18 +110,21 @@ recommended to use `pendulum` for this, but `pytz` (to be installed manually) ca
     op = DummyOperator(task_id='dummy', dag=dag)
     print(dag.timezone) # <Timezone [Europe/Amsterdam]>
 
-
+Please note that while it is possible to set a `start_date` and `end_date` for Tasks always the DAG timezone
+or global timezone (in that order) will be used to calculate the next execution date. Upon first encounter
+the start date or end date will be converted to UTC using the timezone associated with start_date or end_date,
+then for calculations this timezone information will be disregarded.
 
 Templates
 '''''''''
 
-Airflow returns time zone aware datetimes in templates, but does not convert them to local time so they remain in UTC. 
+Airflow returns time zone aware datetimes in templates, but does not convert them to local time so they remain in UTC.
 It is left up to the DAG to handle this.
 
 .. code:: python
 
     import pendulum
-    
+
     local_tz = pendulum.timezone("Europe/Amsterdam")
     local_tz.convert(execution_date)
 
@@ -129,10 +132,10 @@ It is left up to the DAG to handle this.
 Cron schedules
 ''''''''''''''
 
-In case you set a cron schedule, Airflow assumes you will always want to run at the exact same time. It will 
-then ignore day light savings time. Thus, if you have a schedule that says 
-run at end of interval every day at 08:00 GMT+1 it will always run end of interval 08:00 GMT+1, 
-regardless if day light savings time is in place. 
+In case you set a cron schedule, Airflow assumes you will always want to run at the exact same time. It will
+then ignore day light savings time. Thus, if you have a schedule that says
+run at end of interval every day at 08:00 GMT+1 it will always run end of interval 08:00 GMT+1,
+regardless if day light savings time is in place.
 
 
 Time deltas
diff --git a/tests/core.py b/tests/core.py
index 0c178b4f715d3..db17008c6cc51 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -46,7 +46,7 @@
 from airflow.executors import SequentialExecutor
 from airflow.models import Variable
 
-configuration.conf.load_test_config()
+configuration.conf.load_test_config()  # NOQA: E402
 from airflow import jobs, models, DAG, utils, macros, settings, exceptions
 from airflow.models import BaseOperator
 from airflow.operators.bash_operator import BashOperator
diff --git a/tests/models.py b/tests/models.py
index d38681741daa1..a8cc005ba3d8a 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1499,6 +1499,16 @@ def test_timezone_awareness(self):
         ti = TI(task=op1, execution_date=execution_date)
         self.assertEquals(ti.execution_date, utc_date)
 
+    def test_task_naive_datetime(self):
+        NAIVE_DATETIME = DEFAULT_DATE.replace(tzinfo=None)
+
+        op_no_dag = DummyOperator(task_id='test_task_naive_datetime',
+                                  start_date=NAIVE_DATETIME,
+                                  end_date=NAIVE_DATETIME)
+
+        self.assertTrue(op_no_dag.start_date.tzinfo)
+        self.assertTrue(op_no_dag.end_date.tzinfo)
+
     def test_set_dag(self):
         """
         Test assigning Operators to Dags, including deferred assignment

From 6b62af7e373c5519cbeeca144365afa21856fc0f Mon Sep 17 00:00:00 2001
From: abdul-stripe <34078811+abdul-stripe@users.noreply.github.com>
Date: Fri, 31 Aug 2018 16:52:02 -0700
Subject: [PATCH 046/808] [AIRFLOW-2145] fix deadlock on clearing running TI
 (#3657)

a `shutdown` task is not considered be `unfinished`, so a dag run can
deadlock when all `unfinished` downstreams are all waiting on a task
that's in the `shutdown` state. fix this by considering `shutdown` to
be `unfinished`, since it's not truly a terminal state
---
 airflow/utils/state.py |  2 +-
 tests/models.py        | 21 ++++++++++++++++++++-
 2 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/airflow/utils/state.py b/airflow/utils/state.py
index 9da98510eb03d..70dbc5ca048e8 100644
--- a/airflow/utils/state.py
+++ b/airflow/utils/state.py
@@ -101,7 +101,6 @@ def finished(cls):
         """
         return [
             cls.SUCCESS,
-            cls.SHUTDOWN,
             cls.FAILED,
             cls.SKIPPED,
         ]
@@ -117,5 +116,6 @@ def unfinished(cls):
             cls.SCHEDULED,
             cls.QUEUED,
             cls.RUNNING,
+            cls.SHUTDOWN,
             cls.UP_FOR_RETRY
         ]
diff --git a/tests/models.py b/tests/models.py
index a8cc005ba3d8a..60aee3c84fcb1 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -801,7 +801,26 @@ def test_dagrun_deadlock(self):
         dr.update_state()
         self.assertEqual(dr.state, State.FAILED)
 
-    def test_dagrun_no_deadlock(self):
+    def test_dagrun_no_deadlock_with_shutdown(self):
+        session = settings.Session()
+        dag = DAG('test_dagrun_no_deadlock_with_shutdown',
+                  start_date=DEFAULT_DATE)
+        with dag:
+            op1 = DummyOperator(task_id='upstream_task')
+            op2 = DummyOperator(task_id='downstream_task')
+            op2.set_upstream(op1)
+
+        dr = dag.create_dagrun(run_id='test_dagrun_no_deadlock_with_shutdown',
+                               state=State.RUNNING,
+                               execution_date=DEFAULT_DATE,
+                               start_date=DEFAULT_DATE)
+        upstream_ti = dr.get_task_instance(task_id='upstream_task')
+        upstream_ti.set_state(State.SHUTDOWN, session=session)
+
+        dr.update_state()
+        self.assertEqual(dr.state, State.RUNNING)
+
+    def test_dagrun_no_deadlock_with_depends_on_past(self):
         session = settings.Session()
         dag = DAG('test_dagrun_no_deadlock',
                   start_date=DEFAULT_DATE)

From da183afc2814ecf99b494301487e06fa4f222a80 Mon Sep 17 00:00:00 2001
From: tzulberti-jampp <tomas@jampp.com>
Date: Wed, 29 Aug 2018 13:27:52 -0300
Subject: [PATCH 047/808] [AIRFLOW-2949] Add syntax highlight for single quote
 strings (#3795)

* AIRFLOW-2949: Add syntax highlight for single quote strings

* AIRFLOW-2949: Also updated new UI main.css
---
 airflow/www/static/main.css      | 1 +
 airflow/www_rbac/static/main.css | 1 +
 2 files changed, 2 insertions(+)

diff --git a/airflow/www/static/main.css b/airflow/www/static/main.css
index 57164b94e5ccf..147695c4a9591 100644
--- a/airflow/www/static/main.css
+++ b/airflow/www/static/main.css
@@ -262,3 +262,4 @@ div.square {
 .sc { color: #BA2121 } /* Literal.String.Char */
 .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
 .s2 { color: #BA2121 } /* Literal.String.Double */
+.s1 { color: #BA2121 } /* Literal.String.Single */
diff --git a/airflow/www_rbac/static/main.css b/airflow/www_rbac/static/main.css
index 5a10bfd34dc62..ab39d44d9e1a7 100644
--- a/airflow/www_rbac/static/main.css
+++ b/airflow/www_rbac/static/main.css
@@ -265,3 +265,4 @@ div.square {
 .sc { color: #BA2121 } /* Literal.String.Char */
 .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
 .s2 { color: #BA2121 } /* Literal.String.Double */
+.s1 { color: #BA2121 } /* Literal.String.Single */

From f04872ed0f8170da48385882f5e04b3c27c46134 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 3 Sep 2018 12:17:51 +0100
Subject: [PATCH 048/808] [AIRFLOW-2979] Make celery_result_backend conf
 Backwards compatible (#3832)

(#2806) Renamed `celery_result_backend` to `result_backend` and broke backwards compatibility.
---
 airflow/configuration.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 2e05fde0cdea2..4f88a6fee3c43 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -138,6 +138,7 @@ class AirflowConfigParser(ConfigParser):
         'celery': {
             # Remove these keys in Airflow 1.11
             'worker_concurrency': 'celeryd_concurrency',
+            'result_backend': 'celery_result_backend',
             'broker_url': 'celery_broker_url',
             'ssl_active': 'celery_ssl_active',
             'ssl_cert': 'celery_ssl_cert',

From 2b596f0c136f8cda7f86f1bcd5271a488259f0b2 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sun, 26 Aug 2018 13:57:26 +0200
Subject: [PATCH 049/808] [AIRFLOW-2960] Pin boto3 to <1.8 (#3810)

Boto 1.8 has been released a few days ago and they break our tests.
---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index b48087084def9..03edaaced6cd4 100644
--- a/setup.py
+++ b/setup.py
@@ -163,7 +163,7 @@ def write_version(filename=os.path.join(*['airflow',
     'elasticsearch>=5.0.0,<6.0.0',
     'elasticsearch-dsl>=5.0.0,<6.0.0'
 ]
-emr = ['boto3>=1.0.0']
+emr = ['boto3>=1.0.0, <1.8.0']
 gcp_api = [
     'httplib2>=0.9.2',
     'google-api-python-client>=1.6.0, <2.0.0dev',
@@ -201,7 +201,7 @@ def write_version(filename=os.path.join(*['airflow',
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']
 redis = ['redis>=2.10.5']
-s3 = ['boto3>=1.7.0']
+s3 = ['boto3>=1.7.0, <1.8.0']
 salesforce = ['simple-salesforce>=0.72']
 samba = ['pysmbclient>=0.1.3']
 segment = ['analytics-python>=1.2.9']

From ad951705c4f1e70eecb04a2e018759d882e3fb49 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 3 Sep 2018 00:19:51 +0100
Subject: [PATCH 050/808] [AIRFLOW-2476] Allow tabulate up to 0.8.2 (#3835)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 03edaaced6cd4..481c94c8f27e4 100644
--- a/setup.py
+++ b/setup.py
@@ -299,7 +299,7 @@ def do_setup():
             'requests>=2.5.1, <3',
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.2.0',
-            'tabulate>=0.7.5, <0.8.0',
+            'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
             'thrift>=0.9.2',
             'tzlocal>=1.4',

From 1c19190cae1eacff9e9489ef31dfe5ea5b637775 Mon Sep 17 00:00:00 2001
From: Jake Biesinger <jake.biesinger@gmail.com>
Date: Thu, 30 Aug 2018 13:12:46 -0700
Subject: [PATCH 051/808] [AIRFLOW-2900] Show code for packaged DAGs (#3749)

---
 airflow/models.py            |  5 +++--
 airflow/www/utils.py         | 25 ++++++++++++++++++++++---
 airflow/www/views.py         |  2 +-
 airflow/www_rbac/utils.py    | 20 ++++++++++++++++++++
 airflow/www_rbac/views.py    |  2 +-
 tests/www/test_utils.py      | 34 ++++++++++++++++++++++++++++++++++
 tests/www_rbac/test_utils.py | 35 +++++++++++++++++++++++++++++++++++
 7 files changed, 116 insertions(+), 7 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 7437a19521b5f..f586139bb1145 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -335,7 +335,8 @@ def process_file(self, filepath, only_if_updated=True, safe_mode=True):
             return found_dags
 
         mods = []
-        if not zipfile.is_zipfile(filepath):
+        is_zipfile = zipfile.is_zipfile(filepath)
+        if not is_zipfile:
             if safe_mode and os.path.isfile(filepath):
                 with open(filepath, 'rb') as f:
                     content = f.read()
@@ -407,7 +408,7 @@ def process_file(self, filepath, only_if_updated=True, safe_mode=True):
                 if isinstance(dag, DAG):
                     if not dag.full_filepath:
                         dag.full_filepath = filepath
-                        if dag.fileloc != filepath:
+                        if dag.fileloc != filepath and not is_zipfile:
                             dag.fileloc = filepath
                     try:
                         dag.is_subdag = False
diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 44fa5c4dcd6fb..09ac465c52d1b 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -18,16 +18,19 @@
 # under the License.
 #
 from future import standard_library
-standard_library.install_aliases()
-from builtins import str
-from builtins import object
+standard_library.install_aliases()  # noqa: E402
+from builtins import str, object
 
 from cgi import escape
 from io import BytesIO as IO
 import functools
 import gzip
+import io
 import json
+import os
+import re
 import time
+import zipfile
 
 from flask import after_this_request, request, Response
 from flask_admin.contrib.sqla.filters import FilterConverter
@@ -366,6 +369,22 @@ def zipper(response):
     return view_func
 
 
+def open_maybe_zipped(f, mode='r'):
+    """
+    Opens the given file. If the path contains a folder with a .zip suffix, then
+    the folder is treated as a zip archive, opening the file inside the archive.
+
+    :return: a file object, as in `open`, or as in `ZipFile.open`.
+    """
+
+    _, archive, filename = re.search(
+        r'((.*\.zip){})?(.*)'.format(re.escape(os.sep)), f).groups()
+    if archive and zipfile.is_zipfile(archive):
+        return zipfile.ZipFile(archive, mode=mode).open(filename)
+    else:
+        return io.open(f, mode=mode)
+
+
 def make_cache_key(*args, **kwargs):
     """
     Used by cache to get a unique key per URL
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 8f6725ef59b44..851ad90cb2770 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -670,7 +670,7 @@ def code(self):
         dag = dagbag.get_dag(dag_id)
         title = dag_id
         try:
-            with open(dag.fileloc, 'r') as f:
+            with wwwutils.open_maybe_zipped(dag.fileloc, 'r') as f:
                 code = f.read()
             html_code = highlight(
                 code, lexers.PythonLexer(), HtmlFormatter(linenos=True))
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index 7bbdada5556f2..14e18f8bc30e7 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -26,6 +26,10 @@
 import wtforms
 import bleach
 import markdown
+import re
+import zipfile
+import os
+import io
 
 from builtins import str
 from past.builtins import basestring
@@ -197,6 +201,22 @@ def json_response(obj):
         mimetype="application/json")
 
 
+def open_maybe_zipped(f, mode='r'):
+    """
+    Opens the given file. If the path contains a folder with a .zip suffix, then
+    the folder is treated as a zip archive, opening the file inside the archive.
+
+    :return: a file object, as in `open`, or as in `ZipFile.open`.
+    """
+
+    _, archive, filename = re.search(
+        r'((.*\.zip){})?(.*)'.format(re.escape(os.sep)), f).groups()
+    if archive and zipfile.is_zipfile(archive):
+        return zipfile.ZipFile(archive, mode=mode).open(filename)
+    else:
+        return io.open(f, mode=mode)
+
+
 def make_cache_key(*args, **kwargs):
     """
     Used by cache to get a unique key per URL
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 43e481ed0278c..a65e1d26e3995 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -379,7 +379,7 @@ def code(self):
         dag = dagbag.get_dag(dag_id)
         title = dag_id
         try:
-            with open(dag.fileloc, 'r') as f:
+            with wwwutils.open_maybe_zipped(dag.fileloc, 'r') as f:
                 code = f.read()
             html_code = highlight(
                 code, lexers.PythonLexer(), HtmlFormatter(linenos=True))
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index 9d788e88f1ed9..f5c3f01fb916d 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -190,6 +190,40 @@ def some_func():
                 self.assertEqual(anonymous_username, kwargs['owner'])
                 mocked_session_instance.add.assert_called_once()
 
+    def test_open_maybe_zipped_normal_file(self):
+        with mock.patch(
+                'io.open', mock.mock_open(read_data="data")) as mock_file:
+            utils.open_maybe_zipped('/path/to/some/file.txt')
+            mock_file.assert_called_with('/path/to/some/file.txt', mode='r')
+
+    def test_open_maybe_zipped_normal_file_with_zip_in_name(self):
+        path = '/path/to/fakearchive.zip.other/file.txt'
+        with mock.patch(
+                'io.open', mock.mock_open(read_data="data")) as mock_file:
+            utils.open_maybe_zipped(path)
+            mock_file.assert_called_with(path, mode='r')
+
+    @mock.patch("zipfile.is_zipfile")
+    @mock.patch("zipfile.ZipFile")
+    def test_open_maybe_zipped_archive(self, mocked_ZipFile, mocked_is_zipfile):
+        mocked_is_zipfile.return_value = True
+        instance = mocked_ZipFile.return_value
+        instance.open.return_value = mock.mock_open(read_data="data")
+
+        utils.open_maybe_zipped('/path/to/archive.zip/deep/path/to/file.txt')
+
+        mocked_is_zipfile.assert_called_once()
+        (args, kwargs) = mocked_is_zipfile.call_args_list[0]
+        self.assertEqual('/path/to/archive.zip', args[0])
+
+        mocked_ZipFile.assert_called_once()
+        (args, kwargs) = mocked_ZipFile.call_args_list[0]
+        self.assertEqual('/path/to/archive.zip', args[0])
+
+        instance.open.assert_called_once()
+        (args, kwargs) = instance.open.call_args_list[0]
+        self.assertEqual('deep/path/to/file.txt', args[0])
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index 05114881ddecf..c7179fa3a421d 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import unittest
+import mock
 from xml.dom import minidom
 
 from airflow.www_rbac import utils
@@ -109,6 +110,40 @@ def test_params_all(self):
         self.assertEqual('page=3&search=bash_&showPaused=False',
                          utils.get_params(showPaused=False, page=3, search='bash_'))
 
+    def test_open_maybe_zipped_normal_file(self):
+        with mock.patch(
+                'io.open', mock.mock_open(read_data="data")) as mock_file:
+            utils.open_maybe_zipped('/path/to/some/file.txt')
+            mock_file.assert_called_with('/path/to/some/file.txt', mode='r')
+
+    def test_open_maybe_zipped_normal_file_with_zip_in_name(self):
+        path = '/path/to/fakearchive.zip.other/file.txt'
+        with mock.patch(
+                'io.open', mock.mock_open(read_data="data")) as mock_file:
+            utils.open_maybe_zipped(path)
+            mock_file.assert_called_with(path, mode='r')
+
+    @mock.patch("zipfile.is_zipfile")
+    @mock.patch("zipfile.ZipFile")
+    def test_open_maybe_zipped_archive(self, mocked_ZipFile, mocked_is_zipfile):
+        mocked_is_zipfile.return_value = True
+        instance = mocked_ZipFile.return_value
+        instance.open.return_value = mock.mock_open(read_data="data")
+
+        utils.open_maybe_zipped('/path/to/archive.zip/deep/path/to/file.txt')
+
+        mocked_is_zipfile.assert_called_once()
+        (args, kwargs) = mocked_is_zipfile.call_args_list[0]
+        self.assertEqual('/path/to/archive.zip', args[0])
+
+        mocked_ZipFile.assert_called_once()
+        (args, kwargs) = mocked_ZipFile.call_args_list[0]
+        self.assertEqual('/path/to/archive.zip', args[0])
+
+        instance.open.assert_called_once()
+        (args, kwargs) = instance.open.call_args_list[0]
+        self.assertEqual('deep/path/to/file.txt', args[0])
+
 
 if __name__ == '__main__':
     unittest.main()

From 036de74f6f685cc95b81cfa76eac1885bba0f3e7 Mon Sep 17 00:00:00 2001
From: Keliang Chen <troychen728@gmail.com>
Date: Sun, 12 Aug 2018 11:03:43 -0700
Subject: [PATCH 052/808] [AIRFLOW-2524] Add Amazon SageMaker Training (#3658)

Add SageMaker Hook, Training Operator & Sensor
Co-authored-by: srrajeev-aws <srrajeev@amazon.com>
---
 airflow/contrib/hooks/sagemaker_hook.py       | 241 ++++++++++
 .../sagemaker_create_training_job_operator.py | 119 +++++
 .../contrib/sensors/sagemaker_base_sensor.py  |  76 ++++
 .../sensors/sagemaker_training_sensor.py      |  66 +++
 tests/contrib/hooks/test_sagemaker_hook.py    | 415 ++++++++++++++++++
 ..._sagemaker_create_training_job_operator.py | 141 ++++++
 .../sensors/test_sagemaker_base_sensor.py     | 149 +++++++
 .../sensors/test_sagemaker_training_sensor.py | 118 +++++
 8 files changed, 1325 insertions(+)
 create mode 100644 airflow/contrib/hooks/sagemaker_hook.py
 create mode 100644 airflow/contrib/operators/sagemaker_create_training_job_operator.py
 create mode 100644 airflow/contrib/sensors/sagemaker_base_sensor.py
 create mode 100644 airflow/contrib/sensors/sagemaker_training_sensor.py
 create mode 100644 tests/contrib/hooks/test_sagemaker_hook.py
 create mode 100644 tests/contrib/operators/test_sagemaker_create_training_job_operator.py
 create mode 100644 tests/contrib/sensors/test_sagemaker_base_sensor.py
 create mode 100644 tests/contrib/sensors/test_sagemaker_training_sensor.py

diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
new file mode 100644
index 0000000000000..8b8e2e41e7678
--- /dev/null
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -0,0 +1,241 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import copy
+import time
+from botocore.exceptions import ClientError
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.hooks.S3_hook import S3Hook
+
+
+class SageMakerHook(AwsHook):
+    """
+    Interact with Amazon SageMaker.
+    sagemaker_conn_id is required for using
+    the config stored in db for training/tuning
+    """
+
+    def __init__(self,
+                 sagemaker_conn_id=None,
+                 use_db_config=False,
+                 region_name=None,
+                 check_interval=5,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerHook, self).__init__(*args, **kwargs)
+        self.sagemaker_conn_id = sagemaker_conn_id
+        self.use_db_config = use_db_config
+        self.region_name = region_name
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+        self.conn = self.get_conn()
+
+    def check_for_url(self, s3url):
+        """
+        check if the s3url exists
+        :param s3url: S3 url
+        :type s3url:str
+        :return: bool
+        """
+        bucket, key = S3Hook.parse_s3_url(s3url)
+        s3hook = S3Hook(aws_conn_id=self.aws_conn_id)
+        if not s3hook.check_for_bucket(bucket_name=bucket):
+            raise AirflowException(
+                "The input S3 Bucket {} does not exist ".format(bucket))
+        if not s3hook.check_for_key(key=key, bucket_name=bucket):
+            raise AirflowException("The input S3 Key {} does not exist in the Bucket"
+                                   .format(s3url, bucket))
+        return True
+
+    def check_valid_training_input(self, training_config):
+        """
+        Run checks before a training starts
+        :param training_config: training_config
+        :type training_config: dict
+        :return: None
+        """
+        for channel in training_config['InputDataConfig']:
+            self.check_for_url(channel['DataSource']
+                               ['S3DataSource']['S3Uri'])
+
+    def check_valid_tuning_input(self, tuning_config):
+        """
+        Run checks before a tuning job starts
+        :param tuning_config: tuning_config
+        :type tuning_config: dict
+        :return: None
+        """
+        for channel in tuning_config['TrainingJobDefinition']['InputDataConfig']:
+            self.check_for_url(channel['DataSource']
+                               ['S3DataSource']['S3Uri'])
+
+    def check_status(self, non_terminal_states,
+                     failed_state, key,
+                     describe_function, *args):
+        """
+        :param non_terminal_states: the set of non_terminal states
+        :type non_terminal_states: dict
+        :param failed_state: the set of failed states
+        :type failed_state: dict
+        :param key: the key of the response dict
+        that points to the state
+        :type key: string
+        :param describe_function: the function used to retrieve the status
+        :type describe_function: python callable
+        :param args: the arguments for the function
+        :return: None
+        """
+        sec = 0
+        running = True
+
+        while running:
+
+            sec = sec + self.check_interval
+
+            if self.max_ingestion_time and sec > self.max_ingestion_time:
+                # ensure that the job gets killed if the max ingestion time is exceeded
+                raise AirflowException("SageMaker job took more than "
+                                       "%s seconds", self.max_ingestion_time)
+
+            time.sleep(self.check_interval)
+            try:
+                response = describe_function(*args)
+                status = response[key]
+                self.log.info("Job still running for %s seconds... "
+                              "current status is %s" % (sec, status))
+            except KeyError:
+                raise AirflowException("Could not get status of the SageMaker job")
+            except ClientError:
+                raise AirflowException("AWS request failed, check log for more info")
+
+            if status in non_terminal_states:
+                running = True
+            elif status in failed_state:
+                raise AirflowException("SageMaker job failed because %s"
+                                       % response['FailureReason'])
+            else:
+                running = False
+
+        self.log.info('SageMaker Job Compeleted')
+
+    def get_conn(self):
+        """
+        Establish an AWS connection
+        :return: a boto3 SageMaker client
+        """
+        return self.get_client_type('sagemaker', region_name=self.region_name)
+
+    def list_training_job(self, name_contains=None, status_equals=None):
+        """
+        List the training jobs associated with the given input
+        :param name_contains: A string in the training job name
+        :type name_contains: str
+        :param status_equals: 'InProgress'|'Completed'
+        |'Failed'|'Stopping'|'Stopped'
+        :return:dict
+        """
+        return self.conn.list_training_jobs(
+            NameContains=name_contains, StatusEquals=status_equals)
+
+    def list_tuning_job(self, name_contains=None, status_equals=None):
+        """
+        List the tuning jobs associated with the given input
+        :param name_contains: A string in the training job name
+        :type name_contains: str
+        :param status_equals: 'InProgress'|'Completed'
+        |'Failed'|'Stopping'|'Stopped'
+        :return:dict
+        """
+        return self.conn.list_hyper_parameter_tuning_job(
+            NameContains=name_contains, StatusEquals=status_equals)
+
+    def create_training_job(self, training_job_config, wait_for_completion=True):
+        """
+        Create a training job
+        :param training_job_config: the config for training
+        :type training_job_config: dict
+        :param wait_for_completion: if the program should keep running until job finishes
+        :param wait_for_completion: bool
+        :return: A dict that contains ARN of the training job.
+        """
+        if self.use_db_config:
+            if not self.sagemaker_conn_id:
+                raise AirflowException("SageMaker connection id must be present to read \
+                                        SageMaker training jobs configuration.")
+            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
+
+            config = copy.deepcopy(sagemaker_conn.extra_dejson)
+            training_job_config.update(config)
+
+        self.check_valid_training_input(training_job_config)
+
+        response = self.conn.create_training_job(
+            **training_job_config)
+        if wait_for_completion:
+            self.check_status(['InProgress', 'Stopping', 'Stopped'],
+                              ['Failed'],
+                              'TrainingJobStatus',
+                              self.describe_training_job,
+                              training_job_config['TrainingJobName'])
+        return response
+
+    def create_tuning_job(self, tuning_job_config):
+        """
+        Create a tuning job
+        :param tuning_job_config: the config for tuning
+        :type tuning_job_config: dict
+        :return: A dict that contains ARN of the tuning job.
+        """
+        if self.use_db_config:
+            if not self.sagemaker_conn_id:
+                raise AirflowException(
+                    "sagemaker connection id must be present to \
+                    read sagemaker tunning job configuration.")
+
+            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
+
+            config = sagemaker_conn.extra_dejson.copy()
+            tuning_job_config.update(config)
+
+        self.check_valid_tuning_input(tuning_job_config)
+
+        return self.conn.create_hyper_parameter_tuning_job(
+            **tuning_job_config)
+
+    def describe_training_job(self, training_job_name):
+        """
+        :param training_job_name: the name of the training job
+        :type train_job_name: string
+        Return the training job info associated with the current job_name
+        :return: A dict contains all the training job info
+        """
+        return self.conn\
+                   .describe_training_job(TrainingJobName=training_job_name)
+
+    def describe_tuning_job(self, tuning_job_name):
+        """
+        :param tuning_job_name: the name of the training job
+        :type tuning_job_name: string
+        Return the tuning job info associated with the current job_name
+        :return: A dict contains all the tuning job info
+        """
+        return self.conn\
+            .describe_hyper_parameter_tuning_job(
+                HyperParameterTuningJobName=tuning_job_name)
diff --git a/airflow/contrib/operators/sagemaker_create_training_job_operator.py b/airflow/contrib/operators/sagemaker_create_training_job_operator.py
new file mode 100644
index 0000000000000..409c5f6aa936a
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_create_training_job_operator.py
@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerCreateTrainingJobOperator(BaseOperator):
+
+    """
+       Initiate a SageMaker training
+
+       This operator returns The ARN of the model created in Amazon SageMaker
+
+       :param training_job_config:
+       The configuration necessary to start a training job (templated)
+       :type training_job_config: dict
+       :param region_name: The AWS region_name
+       :type region_name: string
+       :param sagemaker_conn_id: The SageMaker connection ID to use.
+       :type sagemaker_conn_id: string
+       :param use_db_config: Whether or not to use db config
+       associated with sagemaker_conn_id.
+       If set to true, will automatically update the training config
+       with what's in db, so the db config doesn't need to
+       included everything, but what's there does replace the ones
+       in the training_job_config, so be careful
+       :type use_db_config: bool
+       :param aws_conn_id: The AWS connection ID to use.
+       :type aws_conn_id: string
+       :param wait_for_completion: if the operator should block
+       until training job finishes
+       :type wait_for_completion: bool
+       :param check_interval: if wait is set to be true, this is the time interval
+       which the operator will check the status of the training job
+       :type check_interval: int
+       :param max_ingestion_time: if wait is set to be true, the operator will fail
+       if the training job hasn't finish within the max_ingestion_time
+       (Caution: be careful to set this parameters because training can take very long)
+       :type max_ingestion_time: int
+
+       **Example**:
+           The following operator would start a training job when executed
+
+            sagemaker_training =
+               SageMakerCreateTrainingJobOperator(
+                   task_id='sagemaker_training',
+                   training_job_config=config,
+                   region_name='us-west-2'
+                   sagemaker_conn_id='sagemaker_customers_conn',
+                   use_db_config=True,
+                   aws_conn_id='aws_customers_conn'
+               )
+    """
+
+    template_fields = ['training_job_config']
+    template_ext = ()
+    ui_color = '#ededed'
+
+    @apply_defaults
+    def __init__(self,
+                 training_job_config=None,
+                 region_name=None,
+                 sagemaker_conn_id=None,
+                 use_db_config=False,
+                 wait_for_completion=True,
+                 check_interval=5,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerCreateTrainingJobOperator, self).__init__(*args, **kwargs)
+
+        self.sagemaker_conn_id = sagemaker_conn_id
+        self.training_job_config = training_job_config
+        self.use_db_config = use_db_config
+        self.region_name = region_name
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+
+    def execute(self, context):
+        sagemaker = SageMakerHook(
+            sagemaker_conn_id=self.sagemaker_conn_id,
+            use_db_config=self.use_db_config,
+            region_name=self.region_name,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time
+        )
+
+        self.log.info(
+            "Creating SageMaker Training Job %s."
+            % self.training_job_config['TrainingJobName']
+        )
+        response = sagemaker.create_training_job(
+            self.training_job_config,
+            wait_for_completion=self.wait_for_completion)
+        if not response['ResponseMetadata']['HTTPStatusCode'] \
+           == 200:
+            raise AirflowException(
+                'Sagemaker Training Job creation failed: %s' % response)
+        else:
+            return response
diff --git a/airflow/contrib/sensors/sagemaker_base_sensor.py b/airflow/contrib/sensors/sagemaker_base_sensor.py
new file mode 100644
index 0000000000000..149c2a1aab124
--- /dev/null
+++ b/airflow/contrib/sensors/sagemaker_base_sensor.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerBaseSensor(BaseSensorOperator):
+    """
+    Contains general sensor behavior for SageMaker.
+    Subclasses should implement get_sagemaker_response()
+    and state_from_response() methods.
+    Subclasses should also implement NON_TERMINAL_STATES and FAILED_STATE methods.
+    """
+    ui_color = '#66c3ff'
+
+    @apply_defaults
+    def __init__(
+            self,
+            aws_conn_id='aws_default',
+            *args, **kwargs):
+        super(SageMakerBaseSensor, self).__init__(*args, **kwargs)
+        self.aws_conn_id = aws_conn_id
+
+    def poke(self, context):
+        response = self.get_sagemaker_response()
+
+        if not response['ResponseMetadata']['HTTPStatusCode'] == 200:
+            self.log.info('Bad HTTP response: %s', response)
+            return False
+
+        state = self.state_from_response(response)
+
+        self.log.info('Job currently %s', state)
+
+        if state in self.non_terminal_states():
+            return False
+
+        if state in self.failed_states():
+            failed_reason = self.get_failed_reason_from_response(response)
+            raise AirflowException("Sagemaker job failed for the following reason: %s"
+                                   % failed_reason)
+        return True
+
+    def non_terminal_states(self):
+        raise AirflowException("Non Terminal States need to be specified in subclass")
+
+    def failed_states(self):
+        raise AirflowException("Failed States need to be specified in subclass")
+
+    def get_sagemaker_response(self):
+        raise AirflowException(
+            "Method get_sagemaker_response()not implemented.")
+
+    def get_failed_reason_from_response(self, response):
+        return 'Unknown'
+
+    def state_from_response(self, response):
+        raise AirflowException(
+            "Method state_from_response()not implemented.")
diff --git a/airflow/contrib/sensors/sagemaker_training_sensor.py b/airflow/contrib/sensors/sagemaker_training_sensor.py
new file mode 100644
index 0000000000000..90c62ce988fbf
--- /dev/null
+++ b/airflow/contrib/sensors/sagemaker_training_sensor.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
+from airflow.utils.decorators import apply_defaults
+
+
+class SageMakerTrainingSensor(SageMakerBaseSensor):
+    """
+    Asks for the state of the training state until it reaches a terminal state.
+    If it fails the sensor errors, failing the task.
+
+    :param job_name: job_name of the training instance to check the state of
+    :type job_name: string
+    """
+
+    template_fields = ['job_name']
+    template_ext = ()
+
+    @apply_defaults
+    def __init__(self,
+                 job_name,
+                 region_name=None,
+                 *args,
+                 **kwargs):
+        super(SageMakerTrainingSensor, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.region_name = region_name
+
+    def non_terminal_states(self):
+        return ['InProgress', 'Stopping', 'Stopped']
+
+    def failed_states(self):
+        return ['Failed']
+
+    def get_sagemaker_response(self):
+        sagemaker = SageMakerHook(
+            aws_conn_id=self.aws_conn_id,
+            region_name=self.region_name
+        )
+
+        self.log.info('Poking Sagemaker Training Job %s', self.job_name)
+        return sagemaker.describe_training_job(self.job_name)
+
+    def get_failed_reason_from_response(self, response):
+        return response['FailureReason']
+
+    def state_from_response(self, response):
+        return response['TrainingJobStatus']
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
new file mode 100644
index 0000000000000..6887a5b484bed
--- /dev/null
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -0,0 +1,415 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+
+import json
+import unittest
+import copy
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow import models
+from airflow.utils import db
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.hooks.S3_hook import S3Hook
+from airflow.exceptions import AirflowException
+
+
+role = 'test-role'
+
+bucket = 'test-bucket'
+
+key = 'test/data'
+data_url = 's3://{}/{}'.format(bucket, key)
+
+job_name = 'test-job-name'
+
+image = 'test-image'
+
+test_arn_return = {'TrainingJobArn': 'testarn'}
+
+test_list_training_job_return = {
+    'TrainingJobSummaries': [
+        {
+            'TrainingJobName': job_name,
+            'TrainingJobStatus': 'InProgress'
+        },
+    ],
+    'NextToken': 'test-token'
+}
+
+test_list_tuning_job_return = {
+    'TrainingJobSummaries': [
+        {
+            'TrainingJobName': job_name,
+            'TrainingJobArn': 'testarn',
+            'TunedHyperParameters': {
+                'k': '3'
+            },
+            'TrainingJobStatus': 'InProgress'
+        },
+    ],
+    'NextToken': 'test-token'
+}
+
+output_url = 's3://{}/test/output'.format(bucket)
+create_training_params = \
+    {
+        'AlgorithmSpecification': {
+            'TrainingImage': image,
+            'TrainingInputMode': 'File'
+        },
+        'RoleArn': role,
+        'OutputDataConfig': {
+            'S3OutputPath': output_url
+        },
+        'ResourceConfig': {
+            'InstanceCount': 2,
+            'InstanceType': 'ml.c4.8xlarge',
+            'VolumeSizeInGB': 50
+        },
+        'TrainingJobName': job_name,
+        'HyperParameters': {
+            'k': '10',
+            'feature_dim': '784',
+            'mini_batch_size': '500',
+            'force_dense': 'True'
+        },
+        'StoppingCondition': {
+            'MaxRuntimeInSeconds': 60 * 60
+        },
+        'InputDataConfig': [
+            {
+                'ChannelName': 'train',
+                'DataSource': {
+                    'S3DataSource': {
+                        'S3DataType': 'S3Prefix',
+                        'S3Uri': data_url,
+                        'S3DataDistributionType': 'FullyReplicated'
+                    }
+                },
+                'CompressionType': 'None',
+                'RecordWrapperType': 'None'
+            }
+        ]
+    }
+
+create_tuning_params = \
+    {
+        'HyperParameterTuningJobName': job_name,
+        'HyperParameterTuningJobConfig': {
+            'Strategy': 'Bayesian',
+            'HyperParameterTuningJobObjective': {
+                'Type': 'Maximize',
+                'MetricName': 'test_metric'
+            },
+            'ResourceLimits': {
+                'MaxNumberOfTrainingJobs': 123,
+                'MaxParallelTrainingJobs': 123
+            },
+            'ParameterRanges': {
+                'IntegerParameterRanges': [
+                    {
+                        'Name': 'k',
+                        'MinValue': '2',
+                        'MaxValue': '10'
+                    },
+
+                ]
+            }
+        },
+        'TrainingJobDefinition': {
+            'StaticHyperParameters': create_training_params['HyperParameters'],
+            'AlgorithmSpecification': create_training_params['AlgorithmSpecification'],
+            'RoleArn': 'string',
+            'InputDataConfig': create_training_params['InputDataConfig'],
+            'OutputDataConfig': create_training_params['OutputDataConfig'],
+            'ResourceConfig': create_training_params['ResourceConfig'],
+            'StoppingCondition': dict(MaxRuntimeInSeconds=60 * 60)
+        }
+    }
+
+db_config = {
+    'Tags': [
+        {
+            'Key': 'test-db-key',
+            'Value': 'test-db-value',
+
+        },
+    ]
+}
+
+DESCRIBE_TRAINING_INPROGRESS_RETURN = {
+    'TrainingJobStatus': 'InProgress',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_COMPELETED_RETURN = {
+    'TrainingJobStatus': 'Compeleted',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_FAILED_RETURN = {
+    'TrainingJobStatus': 'Failed',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    },
+    'FailureReason': 'Unknown'
+}
+DESCRIBE_TRAINING_STOPPING_RETURN = {
+    'TrainingJobStatus': 'Stopping',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_STOPPED_RETURN = {
+    'TrainingJobStatus': 'Stopped',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+
+class TestSageMakerHook(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            models.Connection(
+                conn_id='sagemaker_test_conn_id',
+                conn_type='sagemaker',
+                login='access_id',
+                password='access_key',
+                extra=json.dumps(db_config)
+            )
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(S3Hook, 'check_for_key')
+    @mock.patch.object(S3Hook, 'check_for_bucket')
+    def test_check_for_url(self,
+                           mock_check_bucket, mock_check_key, mock_client):
+        mock_client.return_value = None
+        hook = SageMakerHook()
+        mock_check_bucket.side_effect = [False, True, True]
+        mock_check_key.side_effect = [False, True]
+        self.assertRaises(AirflowException,
+                          hook.check_for_url, data_url)
+        self.assertRaises(AirflowException,
+                          hook.check_for_url, data_url)
+        self.assertEqual(hook.check_for_url(data_url), True)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'check_for_url')
+    def test_check_valid_training(self, mock_check_url, mock_client):
+        mock_client.return_value = None
+        hook = SageMakerHook()
+        hook.check_valid_training_input(create_training_params)
+        mock_check_url.assert_called_once_with(data_url)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'check_for_url')
+    def test_check_valid_tuning(self, mock_check_url, mock_client):
+        mock_client.return_value = None
+        hook = SageMakerHook()
+        hook.check_valid_tuning_input(create_tuning_params)
+        mock_check_url.assert_called_once_with(data_url)
+
+    @mock.patch.object(SageMakerHook, 'get_client_type')
+    def test_conn(self, mock_get_client):
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
+                             region_name='us-east-1'
+                             )
+        self.assertEqual(hook.sagemaker_conn_id, 'sagemaker_test_conn_id')
+        mock_get_client.assert_called_once_with('sagemaker',
+                                                region_name='us-east-1'
+                                                )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_list_training_job(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'list_training_jobs.return_value':
+                 test_list_training_job_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.list_training_job(name_contains=job_name,
+                                          status_equals='InProgress')
+        mock_session.list_training_jobs. \
+            assert_called_once_with(NameContains=job_name,
+                                    StatusEquals='InProgress')
+        self.assertEqual(response, test_list_training_job_return)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_list_tuning_job(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'list_hyper_parameter_tuning_job.return_value':
+                 test_list_tuning_job_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.list_tuning_job(name_contains=job_name,
+                                        status_equals='InProgress')
+        mock_session.list_hyper_parameter_tuning_job. \
+            assert_called_once_with(NameContains=job_name,
+                                    StatusEquals='InProgress')
+        self.assertEqual(response, test_list_tuning_job_return)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_training_job(self, mock_client, mock_check_training):
+        mock_check_training.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_training_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.create_training_job(create_training_params,
+                                            wait_for_completion=False)
+        mock_session.create_training_job.assert_called_once_with(**create_training_params)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_training_job_db_config(self, mock_client, mock_check_training):
+        mock_check_training.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_training_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook_use_db_config = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
+                                           use_db_config=True)
+        response = hook_use_db_config.create_training_job(create_training_params,
+                                                          wait_for_completion=False)
+        updated_config = copy.deepcopy(create_training_params)
+        updated_config.update(db_config)
+        mock_session.create_training_job.assert_called_once_with(**updated_config)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_training_ends_with_wait_on(self, mock_client, mock_check_training):
+        mock_check_training.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_training_job.return_value':
+                 test_arn_return,
+                 'describe_training_job.side_effect':
+                     [DESCRIBE_TRAINING_INPROGRESS_RETURN,
+                      DESCRIBE_TRAINING_STOPPING_RETURN,
+                      DESCRIBE_TRAINING_STOPPED_RETURN,
+                      DESCRIBE_TRAINING_COMPELETED_RETURN]
+                 }
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id_1')
+        hook.create_training_job(create_training_params, wait_for_completion=True)
+        self.assertEqual(mock_session.describe_training_job.call_count, 4)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_training_throws_error_when_failed_with_wait_on(
+            self, mock_client, mock_check_training):
+        mock_check_training.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_training_job.return_value':
+                 test_arn_return,
+                 'describe_training_job.side_effect':
+                     [DESCRIBE_TRAINING_INPROGRESS_RETURN,
+                      DESCRIBE_TRAINING_STOPPING_RETURN,
+                      DESCRIBE_TRAINING_STOPPED_RETURN,
+                      DESCRIBE_TRAINING_FAILED_RETURN]
+                 }
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id_1')
+        self.assertRaises(AirflowException, hook.create_training_job,
+                          create_training_params, wait_for_completion=True)
+        self.assertEqual(mock_session.describe_training_job.call_count, 4)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_tuning_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_tuning_job(self, mock_client, mock_check_tuning):
+        mock_session = mock.Mock()
+        attrs = {'create_hyper_parameter_tuning_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.create_tuning_job(create_tuning_params)
+        mock_session.create_hyper_parameter_tuning_job.\
+            assert_called_once_with(**create_tuning_params)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'check_valid_tuning_input')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_tuning_job_db_config(self, mock_client, mock_check_tuning):
+        mock_check_tuning.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_hyper_parameter_tuning_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
+                             use_db_config=True)
+        response = hook.create_tuning_job(create_tuning_params)
+        updated_config = copy.deepcopy(create_tuning_params)
+        updated_config.update(db_config)
+        mock_session.create_hyper_parameter_tuning_job. \
+            assert_called_once_with(**updated_config)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_training_job(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_training_job.return_value': 'InProgress'}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_training_job(job_name)
+        mock_session.describe_training_job.\
+            assert_called_once_with(TrainingJobName=job_name)
+        self.assertEqual(response, 'InProgress')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_tuning_job(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_hyper_parameter_tuning_job.return_value':
+                 'InProgress'}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_tuning_job(job_name)
+        mock_session.describe_hyper_parameter_tuning_job.\
+            assert_called_once_with(HyperParameterTuningJobName=job_name)
+        self.assertEqual(response, 'InProgress')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_create_training_job_operator.py b/tests/contrib/operators/test_sagemaker_create_training_job_operator.py
new file mode 100644
index 0000000000000..156c9d74c79ec
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_create_training_job_operator.py
@@ -0,0 +1,141 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_create_training_job_operator \
+    import SageMakerCreateTrainingJobOperator
+from airflow.exceptions import AirflowException
+
+role = "test-role"
+
+bucket = "test-bucket"
+
+key = "test/data"
+data_url = "s3://{}/{}".format(bucket, key)
+
+job_name = "test-job-name"
+
+image = "test-image"
+
+output_url = "s3://{}/test/output".format(bucket)
+create_training_params = \
+    {
+        "AlgorithmSpecification": {
+            "TrainingImage": image,
+            "TrainingInputMode": "File"
+        },
+        "RoleArn": role,
+        "OutputDataConfig": {
+            "S3OutputPath": output_url
+        },
+        "ResourceConfig": {
+            "InstanceCount": 2,
+            "InstanceType": "ml.c4.8xlarge",
+            "VolumeSizeInGB": 50
+        },
+        "TrainingJobName": job_name,
+        "HyperParameters": {
+            "k": "10",
+            "feature_dim": "784",
+            "mini_batch_size": "500",
+            "force_dense": "True"
+        },
+        "StoppingCondition": {
+            "MaxRuntimeInSeconds": 60 * 60
+        },
+        "InputDataConfig": [
+            {
+                "ChannelName": "train",
+                "DataSource": {
+                    "S3DataSource": {
+                        "S3DataType": "S3Prefix",
+                        "S3Uri": data_url,
+                        "S3DataDistributionType": "FullyReplicated"
+                    }
+                },
+                "CompressionType": "None",
+                "RecordWrapperType": "None"
+            }
+        ]
+    }
+
+
+class TestSageMakerTrainingOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerCreateTrainingJobOperator(
+            task_id='test_sagemaker_operator',
+            sagemaker_conn_id='sagemaker_test_id',
+            training_job_config=create_training_params,
+            region_name='us-west-2',
+            use_db_config=True,
+            wait_for_completion=False,
+            check_interval=5
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_training_job')
+    @mock.patch.object(SageMakerHook, '__init__')
+    def test_hook_init(self, hook_init, mock_training, mock_client):
+        mock_training.return_value = {"TrainingJobArn": "testarn",
+                                      "ResponseMetadata":
+                                          {"HTTPStatusCode": 200}}
+        hook_init.return_value = None
+        self.sagemaker.execute(None)
+        hook_init.assert_called_once_with(
+            sagemaker_conn_id='sagemaker_test_id',
+            region_name='us-west-2',
+            use_db_config=True,
+            check_interval=5,
+            max_ingestion_time=None
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_training_job')
+    def test_execute_without_failure(self, mock_training, mock_client):
+        mock_training.return_value = {"TrainingJobArn": "testarn",
+                                      "ResponseMetadata":
+                                          {"HTTPStatusCode": 200}}
+        self.sagemaker.execute(None)
+        mock_training.assert_called_once_with(create_training_params,
+                                              wait_for_completion=False
+                                              )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_training_job')
+    def test_execute_with_failure(self, mock_training, mock_client):
+        mock_training.return_value = {"TrainingJobArn": "testarn",
+                                      "ResponseMetadata":
+                                          {"HTTPStatusCode": 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_base_sensor.py b/tests/contrib/sensors/test_sagemaker_base_sensor.py
new file mode 100644
index 0000000000000..bc8cbe349858f
--- /dev/null
+++ b/tests/contrib/sensors/test_sagemaker_base_sensor.py
@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
+from airflow.exceptions import AirflowException
+
+
+class TestSagemakerBaseSensor(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+    def test_subclasses_succeed_when_response_is_good(self):
+        class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
+            def non_terminal_states(self):
+                return ['PENDING', 'RUNNING', 'CONTINUE']
+
+            def failed_states(self):
+                return ['FAILED']
+
+            def get_sagemaker_response(self):
+                return {
+                    'SomeKey': {'State': 'COMPLETED'},
+                    'ResponseMetadata': {'HTTPStatusCode': 200}
+                }
+
+            def state_from_response(self, response):
+                return response['SomeKey']['State']
+
+        sensor = SageMakerBaseSensorSubclass(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test'
+        )
+
+        sensor.execute(None)
+
+    def test_poke_returns_false_when_state_is_a_non_terminal_state(self):
+        class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
+            def non_terminal_states(self):
+                return ['PENDING', 'RUNNING', 'CONTINUE']
+
+            def failed_states(self):
+                return ['FAILED']
+
+            def get_sagemaker_response(self):
+                return {
+                    'SomeKey': {'State': 'PENDING'},
+                    'ResponseMetadata': {'HTTPStatusCode': 200}
+                }
+
+            def state_from_response(self, response):
+                return response['SomeKey']['State']
+
+        sensor = SageMakerBaseSensorSubclass(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test'
+        )
+
+        self.assertEqual(sensor.poke(None), False)
+
+    def test_poke_raise_exception_when_method_not_implemented(self):
+        class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
+            def non_terminal_states(self):
+                return ['PENDING', 'RUNNING', 'CONTINUE']
+
+            def failed_states(self):
+                return ['FAILED']
+
+        sensor = SageMakerBaseSensorSubclass(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test'
+        )
+
+        self.assertRaises(AirflowException, sensor.poke, None)
+
+    def test_poke_returns_false_when_http_response_is_bad(self):
+        class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
+            def non_terminal_states(self):
+                return ['PENDING', 'RUNNING', 'CONTINUE']
+
+            def failed_states(self):
+                return ['FAILED']
+
+            def get_sagemaker_response(self):
+                return {
+                    'SomeKey': {'State': 'COMPLETED'},
+                    'ResponseMetadata': {'HTTPStatusCode': 400}
+                }
+
+            def state_from_response(self, response):
+                return response['SomeKey']['State']
+
+        sensor = SageMakerBaseSensorSubclass(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test'
+        )
+
+        self.assertEqual(sensor.poke(None), False)
+
+    def test_poke_raises_error_when_job_has_failed(self):
+        class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
+            def non_terminal_states(self):
+                return ['PENDING', 'RUNNING', 'CONTINUE']
+
+            def failed_states(self):
+                return ['FAILED']
+
+            def get_sagemaker_response(self):
+                return {
+                    'SomeKey': {'State': 'FAILED'},
+                    'ResponseMetadata': {'HTTPStatusCode': 200}
+                }
+
+            def state_from_response(self, response):
+                return response['SomeKey']['State']
+
+        sensor = SageMakerBaseSensorSubclass(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test'
+        )
+
+        self.assertRaises(AirflowException, sensor.poke, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_training_sensor.py b/tests/contrib/sensors/test_sagemaker_training_sensor.py
new file mode 100644
index 0000000000000..fb966f60afbf0
--- /dev/null
+++ b/tests/contrib/sensors/test_sagemaker_training_sensor.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.sensors.sagemaker_training_sensor \
+    import SageMakerTrainingSensor
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.exceptions import AirflowException
+
+DESCRIBE_TRAINING_INPROGRESS_RETURN = {
+    'TrainingJobStatus': 'InProgress',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_COMPELETED_RETURN = {
+    'TrainingJobStatus': 'Compeleted',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_FAILED_RETURN = {
+    'TrainingJobStatus': 'Failed',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    },
+    'FailureReason': 'Unknown'
+}
+DESCRIBE_TRAINING_STOPPING_RETURN = {
+    'TrainingJobStatus': 'Stopping',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRAINING_STOPPED_RETURN = {
+    'TrainingJobStatus': 'Stopped',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+
+class TestSageMakerTrainingSensor(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'describe_training_job')
+    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
+        mock_describe_job.side_effect = [DESCRIBE_TRAINING_FAILED_RETURN]
+        sensor = SageMakerTrainingSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name'
+        )
+        self.assertRaises(AirflowException, sensor.execute, None)
+        mock_describe_job.assert_called_once_with('test_job_name')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
+    @mock.patch.object(SageMakerHook, 'describe_training_job')
+    def test_calls_until_a_terminal_state(self,
+                                          mock_describe_job, hook_init, mock_client):
+        hook_init.return_value = None
+
+        mock_describe_job.side_effect = [
+            DESCRIBE_TRAINING_INPROGRESS_RETURN,
+            DESCRIBE_TRAINING_STOPPING_RETURN,
+            DESCRIBE_TRAINING_STOPPED_RETURN,
+            DESCRIBE_TRAINING_COMPELETED_RETURN
+        ]
+        sensor = SageMakerTrainingSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name',
+            region_name='us-east-1'
+        )
+
+        sensor.execute(None)
+
+        # make sure we called 4 times(terminated when its compeleted)
+        self.assertEqual(mock_describe_job.call_count, 4)
+
+        # make sure the hook was initialized with the specific params
+        hook_init.assert_called_with(aws_conn_id='aws_test',
+                                     region_name='us-east-1')
+
+
+if __name__ == '__main__':
+    unittest.main()

From 1d5a6ce9e1543b80add438eb08fd7adbda826966 Mon Sep 17 00:00:00 2001
From: Keliang Chen <troychen728@gmail.com>
Date: Sun, 19 Aug 2018 07:31:41 -0700
Subject: [PATCH 053/808] [AIRFLOW-2524] Add Amazon SageMaker Tuning (#3751)

Add SageMaker tuning Operator and sensor
Co-authored-by: srrajeev-aws <srrajeev@amazon.com>
---
 airflow/contrib/hooks/sagemaker_hook.py       |  24 ++-
 .../sagemaker_create_tuning_job_operator.py   | 121 +++++++++++++
 .../sensors/sagemaker_tuning_sensor.py        |  69 ++++++++
 tests/contrib/hooks/test_sagemaker_hook.py    |  18 +-
 ...st_sagemaker_create_tuning_job_operator.py | 165 ++++++++++++++++++
 .../sensors/test_sagemaker_tuning_sensor.py   | 118 +++++++++++++
 6 files changed, 505 insertions(+), 10 deletions(-)
 create mode 100644 airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
 create mode 100644 airflow/contrib/sensors/sagemaker_tuning_sensor.py
 create mode 100644 tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py
 create mode 100644 tests/contrib/sensors/test_sagemaker_tuning_sensor.py

diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index 8b8e2e41e7678..09993f96d8738 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -59,8 +59,13 @@ def check_for_url(self, s3url):
         if not s3hook.check_for_bucket(bucket_name=bucket):
             raise AirflowException(
                 "The input S3 Bucket {} does not exist ".format(bucket))
-        if not s3hook.check_for_key(key=key, bucket_name=bucket):
-            raise AirflowException("The input S3 Key {} does not exist in the Bucket"
+        if key and not s3hook.check_for_key(key=key, bucket_name=bucket)\
+           and not s3hook.check_for_prefix(
+                prefix=key, bucket_name=bucket, delimiter='/'):
+            # check if s3 key exists in the case user provides a single file
+            # or if s3 prefix exists in the case user provides a prefix for files
+            raise AirflowException("The input S3 Key "
+                                   "or Prefix {} does not exist in the Bucket {}"
                                    .format(s3url, bucket))
         return True
 
@@ -196,11 +201,13 @@ def create_training_job(self, training_job_config, wait_for_completion=True):
                               training_job_config['TrainingJobName'])
         return response
 
-    def create_tuning_job(self, tuning_job_config):
+    def create_tuning_job(self, tuning_job_config, wait_for_completion=True):
         """
         Create a tuning job
         :param tuning_job_config: the config for tuning
         :type tuning_job_config: dict
+        :param wait_for_completion: if the program should keep running until job finishes
+        :param wait_for_completion: bool
         :return: A dict that contains ARN of the tuning job.
         """
         if self.use_db_config:
@@ -216,13 +223,20 @@ def create_tuning_job(self, tuning_job_config):
 
         self.check_valid_tuning_input(tuning_job_config)
 
-        return self.conn.create_hyper_parameter_tuning_job(
+        response = self.conn.create_hyper_parameter_tuning_job(
             **tuning_job_config)
+        if wait_for_completion:
+            self.check_status(['InProgress', 'Stopping', 'Stopped'],
+                              ['Failed'],
+                              'HyperParameterTuningJobStatus',
+                              self.describe_tuning_job,
+                              tuning_job_config['HyperParameterTuningJobName'])
+        return response
 
     def describe_training_job(self, training_job_name):
         """
         :param training_job_name: the name of the training job
-        :type train_job_name: string
+        :type training_job_name: string
         Return the training job info associated with the current job_name
         :return: A dict contains all the training job info
         """
diff --git a/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py b/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
new file mode 100644
index 0000000000000..0c40a9adc93f4
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
@@ -0,0 +1,121 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerCreateTuningJobOperator(BaseOperator):
+
+    """
+       Initiate a SageMaker HyperParameter Tuning Job
+
+       This operator returns The ARN of the model created in Amazon SageMaker
+
+       :param sagemaker_conn_id: The SageMaker connection ID to use.
+       :type sagemaker_conn_id: string
+       :param region_name: The AWS region_name
+       :type region_name: string
+       :param tuning_job_config:
+       The configuration necessary to start a tuning job (templated)
+       :type tuning_job_config: dict
+       :param use_db_config: Whether or not to use db config
+       associated with sagemaker_conn_id.
+       If set to true, will automatically update the tuning config
+       with what's in db, so the db config doesn't need to
+       included everything, but what's there does replace the ones
+       in the tuning_job_config, so be careful
+       :type use_db_config: bool
+       :param wait_for_completion: if the operator should block
+       until tuning job finishes
+       :type wait_for_completion: bool
+       :param check_interval: if wait is set to be true, this is the time interval
+       which the operator will check the status of the tuning job
+       :type check_interval: int
+       :param max_ingestion_time: if wait is set to be true, the operator will fail
+       if the tuning job hasn't finish within the max_ingestion_time
+       (Caution: be careful to set this parameters because tuning can take very long)
+       :type max_ingestion_time: int
+       :param aws_conn_id: The AWS connection ID to use.
+       :type aws_conn_id: string
+
+       **Example**:
+           The following operator would start a tuning job when executed
+
+            sagemaker_tuning =
+               SageMakerCreateTuningJobOperator(
+                   task_id='sagemaker_tuning',
+                   sagemaker_conn_id='sagemaker_customers_conn',
+                   tuning_job_config=config,
+                   check_interval=2,
+                   max_ingestion_time=3600,
+                   aws_conn_id='aws_customers_conn',
+               )
+       """
+
+    template_fields = ['tuning_job_config']
+    template_ext = ()
+    ui_color = '#ededed'
+
+    @apply_defaults
+    def __init__(self,
+                 sagemaker_conn_id=None,
+                 region_name=None,
+                 tuning_job_config=None,
+                 use_db_config=False,
+                 wait_for_completion=True,
+                 check_interval=5,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerCreateTuningJobOperator, self)\
+            .__init__(*args, **kwargs)
+
+        self.sagemaker_conn_id = sagemaker_conn_id
+        self.region_name = region_name
+        self.tuning_job_config = tuning_job_config
+        self.use_db_config = use_db_config
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+
+    def execute(self, context):
+        sagemaker = SageMakerHook(sagemaker_conn_id=self.sagemaker_conn_id,
+                                  region_name=self.region_name,
+                                  use_db_config=self.use_db_config,
+                                  check_interval=self.check_interval,
+                                  max_ingestion_time=self.max_ingestion_time
+                                  )
+
+        self.log.info(
+            "Creating SageMaker Hyper Parameter Tunning Job %s"
+            % self.tuning_job_config['HyperParameterTuningJobName']
+        )
+
+        response = sagemaker.create_tuning_job(
+            self.tuning_job_config,
+            wait_for_completion=self.wait_for_completion
+        )
+        if not response['ResponseMetadata']['HTTPStatusCode'] \
+           == 200:
+            raise AirflowException(
+                "Sagemaker Tuning Job creation failed: %s" % response)
+        else:
+            return response
diff --git a/airflow/contrib/sensors/sagemaker_tuning_sensor.py b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
new file mode 100644
index 0000000000000..bc74e3a5c5461
--- /dev/null
+++ b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
+from airflow.utils.decorators import apply_defaults
+
+
+class SageMakerTuningSensor(SageMakerBaseSensor):
+    """
+    Asks for the state of the tuning state until it reaches a terminal state.
+    The sensor will error if the job errors, throwing a AirflowException
+    containing the failure reason.
+
+    :param job_name: job_name of the tuning instance to check the state of
+    :type job_name: string
+    :param region_name: The AWS region_name
+    :type region_name: string
+    """
+
+    template_fields = ['job_name']
+    template_ext = ()
+
+    @apply_defaults
+    def __init__(self,
+                 job_name,
+                 region_name=None,
+                 *args,
+                 **kwargs):
+        super(SageMakerTuningSensor, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.region_name = region_name
+
+    def non_terminal_states(self):
+        return ['InProgress', 'Stopping', 'Stopped']
+
+    def failed_states(self):
+        return ['Failed']
+
+    def get_sagemaker_response(self):
+        sagemaker = SageMakerHook(
+            aws_conn_id=self.aws_conn_id,
+            region_name=self.region_name
+        )
+
+        self.log.info('Poking Sagemaker Tuning Job %s', self.job_name)
+        return sagemaker.describe_tuning_job(self.job_name)
+
+    def get_failed_reason_from_response(self, response):
+        return response['FailureReason']
+
+    def state_from_response(self, response):
+        return response['HyperParameterTuningJobStatus']
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
index 6887a5b484bed..8bb56cc8e7d12 100644
--- a/tests/contrib/hooks/test_sagemaker_hook.py
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -212,17 +212,23 @@ def setUp(self):
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(S3Hook, 'check_for_key')
     @mock.patch.object(S3Hook, 'check_for_bucket')
+    @mock.patch.object(S3Hook, 'check_for_prefix')
     def test_check_for_url(self,
-                           mock_check_bucket, mock_check_key, mock_client):
+                           mock_check_prefix,
+                           mock_check_bucket,
+                           mock_check_key,
+                           mock_client):
         mock_client.return_value = None
         hook = SageMakerHook()
-        mock_check_bucket.side_effect = [False, True, True]
-        mock_check_key.side_effect = [False, True]
+        mock_check_bucket.side_effect = [False, True, True, True]
+        mock_check_key.side_effect = [False, True, False]
+        mock_check_prefix.side_effect = [False, True, True]
         self.assertRaises(AirflowException,
                           hook.check_for_url, data_url)
         self.assertRaises(AirflowException,
                           hook.check_for_url, data_url)
         self.assertEqual(hook.check_for_url(data_url), True)
+        self.assertEqual(hook.check_for_url(data_url), True)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, 'check_for_url')
@@ -362,7 +368,8 @@ def test_create_tuning_job(self, mock_client, mock_check_tuning):
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
         hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
-        response = hook.create_tuning_job(create_tuning_params)
+        response = hook.create_tuning_job(create_tuning_params,
+                                          wait_for_completion=False)
         mock_session.create_hyper_parameter_tuning_job.\
             assert_called_once_with(**create_tuning_params)
         self.assertEqual(response, test_arn_return)
@@ -378,7 +385,8 @@ def test_create_tuning_job_db_config(self, mock_client, mock_check_tuning):
         mock_client.return_value = mock_session
         hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
                              use_db_config=True)
-        response = hook.create_tuning_job(create_tuning_params)
+        response = hook.create_tuning_job(create_tuning_params,
+                                          wait_for_completion=False)
         updated_config = copy.deepcopy(create_tuning_params)
         updated_config.update(db_config)
         mock_session.create_hyper_parameter_tuning_job. \
diff --git a/tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py b/tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py
new file mode 100644
index 0000000000000..d317cff6f2289
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py
@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_create_tuning_job_operator \
+    import SageMakerCreateTuningJobOperator
+from airflow.exceptions import AirflowException
+
+role = 'test-role'
+
+bucket = 'test-bucket'
+
+key = 'test/data'
+data_url = 's3://{}/{}'.format(bucket, key)
+
+job_name = 'test-job-name'
+
+image = 'test-image'
+
+output_url = 's3://{}/test/output'.format(bucket)
+
+create_tuning_params = {'HyperParameterTuningJobName': job_name,
+                        'HyperParameterTuningJobConfig': {
+                            'Strategy': 'Bayesian',
+                            'HyperParameterTuningJobObjective': {
+                                'Type': 'Maximize',
+                                'MetricName': 'test_metric'
+                            },
+                            'ResourceLimits': {
+                                'MaxNumberOfTrainingJobs': 123,
+                                'MaxParallelTrainingJobs': 123
+                            },
+                            'ParameterRanges': {
+                                'IntegerParameterRanges': [
+                                    {
+                                        'Name': 'k',
+                                        'MinValue': '2',
+                                        'MaxValue': '10'
+                                    },
+                                ]
+                            }
+                        },
+                        'TrainingJobDefinition': {
+                            'StaticHyperParameters':
+                                {
+                                    'k': '10',
+                                    'feature_dim': '784',
+                                    'mini_batch_size': '500',
+                                    'force_dense': 'True'
+                                },
+                            'AlgorithmSpecification':
+                                {
+                                    'TrainingImage': image,
+                                    'TrainingInputMode': 'File'
+                                },
+                            'RoleArn': 'string',
+                            'InputDataConfig':
+                                [
+                                    {
+                                        'ChannelName': 'train',
+                                        'DataSource': {
+                                            'S3DataSource': {
+                                                'S3DataType': 'S3Prefix',
+                                                'S3Uri': data_url,
+                                                'S3DataDistributionType':
+                                                    'FullyReplicated'
+                                            }
+                                        },
+                                        'CompressionType': 'None',
+                                        'RecordWrapperType': 'None'
+                                    }
+                                ],
+                            'OutputDataConfig':
+                                {
+                                    'S3OutputPath': output_url
+                                },
+                            'ResourceConfig':
+                                {
+                                    'InstanceCount': 2,
+                                    'InstanceType': 'ml.c4.8xlarge',
+                                    'VolumeSizeInGB': 50
+                                },
+                            'StoppingCondition': dict(MaxRuntimeInSeconds=60 * 60)
+                        }
+                        }
+
+
+class TestSageMakerTrainingOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerCreateTuningJobOperator(
+            task_id='test_sagemaker_operator',
+            sagemaker_conn_id='sagemaker_test_conn',
+            tuning_job_config=create_tuning_params,
+            region_name='us-east-1',
+            use_db_config=False,
+            wait_for_completion=False,
+            check_interval=5
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_tuning_job')
+    @mock.patch.object(SageMakerHook, '__init__')
+    def test_hook_init(self, hook_init, mock_tuning, mock_client):
+        mock_tuning.return_value = {'TrainingJobArn': 'testarn',
+                                    'ResponseMetadata':
+                                    {'HTTPStatusCode': 200}}
+        hook_init.return_value = None
+        self.sagemaker.execute(None)
+        hook_init.assert_called_once_with(
+            sagemaker_conn_id='sagemaker_test_conn',
+            region_name='us-east-1',
+            use_db_config=False,
+            check_interval=5,
+            max_ingestion_time=None
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_tuning_job')
+    def test_execute_without_failure(self, mock_tuning, mock_client):
+        mock_tuning.return_value = {'TrainingJobArn': 'testarn',
+                                    'ResponseMetadata':
+                                    {'HTTPStatusCode': 200}}
+        self.sagemaker.execute(None)
+        mock_tuning.assert_called_once_with(create_tuning_params,
+                                            wait_for_completion=False)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_tuning_job')
+    def test_execute_with_failure(self, mock_tuning, mock_client):
+        mock_tuning.return_value = {'TrainingJobArn': 'testarn',
+                                    'ResponseMetadata':
+                                    {'HTTPStatusCode': 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
new file mode 100644
index 0000000000000..49f9b41b07c89
--- /dev/null
+++ b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.sensors.sagemaker_tuning_sensor \
+    import SageMakerTuningSensor
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.exceptions import AirflowException
+
+DESCRIBE_TUNING_INPROGRESS_RETURN = {
+    'HyperParameterTuningJobStatus': 'InProgress',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TUNING_COMPELETED_RETURN = {
+    'HyperParameterTuningJobStatus': 'Compeleted',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TUNING_FAILED_RETURN = {
+    'HyperParameterTuningJobStatus': 'Failed',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    },
+    'FailureReason': 'Unknown'
+}
+DESCRIBE_TUNING_STOPPING_RETURN = {
+    'HyperParameterTuningJobStatus': 'Stopping',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TUNING_STOPPED_RETURN = {
+    'HyperParameterTuningJobStatus': 'Stopped',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+
+class TestSageMakerTuningSensor(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'describe_tuning_job')
+    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
+        mock_describe_job.side_effect = [DESCRIBE_TUNING_FAILED_RETURN]
+        sensor = SageMakerTuningSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name'
+        )
+        self.assertRaises(AirflowException, sensor.execute, None)
+        mock_describe_job.assert_called_once_with('test_job_name')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
+    @mock.patch.object(SageMakerHook, 'describe_tuning_job')
+    def test_calls_until_a_terminal_state(self,
+                                          mock_describe_job, hook_init, mock_client):
+        hook_init.return_value = None
+
+        mock_describe_job.side_effect = [
+            DESCRIBE_TUNING_INPROGRESS_RETURN,
+            DESCRIBE_TUNING_STOPPING_RETURN,
+            DESCRIBE_TUNING_STOPPED_RETURN,
+            DESCRIBE_TUNING_COMPELETED_RETURN
+        ]
+        sensor = SageMakerTuningSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name',
+            region_name='us-east-1'
+        )
+
+        sensor.execute(None)
+
+        # make sure we called 4 times(terminated when its compeleted)
+        self.assertEqual(mock_describe_job.call_count, 4)
+
+        # make sure the hook was initialized with the specific params
+        hook_init.assert_called_with(aws_conn_id='aws_test',
+                                     region_name='us-east-1')
+
+
+if __name__ == '__main__':
+    unittest.main()

From 9a347253771100c955dc3b911c971777679b7a15 Mon Sep 17 00:00:00 2001
From: Keliang Chen <troychen728@gmail.com>
Date: Fri, 14 Sep 2018 02:19:25 -0500
Subject: [PATCH 054/808] [AIRFLOW-2524] Add SageMaker Batch Inference (#3767)

* Fix for comments
* Fix sensor test
* Update non_terminal_states and failed_states to static variables of SageMakerHook

Add SageMaker Transform Operator & Sensor
Co-authored-by: srrajeev-aws <srrajeev@amazon.com>
---
 airflow/contrib/hooks/sagemaker_hook.py       |  79 ++++++++--
 .../sagemaker_create_training_job_operator.py |   2 +-
 ...sagemaker_create_transform_job_operator.py | 132 +++++++++++++++++
 .../sagemaker_create_tuning_job_operator.py   |   2 +-
 .../sensors/sagemaker_training_sensor.py      |   4 +-
 .../sensors/sagemaker_transform_sensor.py     |  69 +++++++++
 .../sensors/sagemaker_tuning_sensor.py        |   4 +-
 tests/contrib/hooks/test_sagemaker_hook.py    |  93 ++++++++++++
 .../test_sagemaker_transform_sensor.py        | 118 +++++++++++++++
 ...sagemaker_create_transform_job_operator.py | 140 ++++++++++++++++++
 10 files changed, 627 insertions(+), 16 deletions(-)
 create mode 100644 airflow/contrib/operators/sagemaker_create_transform_job_operator.py
 create mode 100644 airflow/contrib/sensors/sagemaker_transform_sensor.py
 create mode 100644 tests/contrib/sensors/test_sagemaker_transform_sensor.py
 create mode 100644 tests/operators/test_sagemaker_create_transform_job_operator.py

diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index 09993f96d8738..ebab5d83e4099 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -31,6 +31,8 @@ class SageMakerHook(AwsHook):
     sagemaker_conn_id is required for using
     the config stored in db for training/tuning
     """
+    non_terminal_states = {'InProgress', 'Stopping', 'Stopped'}
+    failed_states = {'Failed'}
 
     def __init__(self,
                  sagemaker_conn_id=None,
@@ -96,9 +98,9 @@ def check_status(self, non_terminal_states,
                      describe_function, *args):
         """
         :param non_terminal_states: the set of non_terminal states
-        :type non_terminal_states: dict
+        :type non_terminal_states: set
         :param failed_state: the set of failed states
-        :type failed_state: dict
+        :type failed_state: set
         :param key: the key of the response dict
         that points to the state
         :type key: string
@@ -177,7 +179,7 @@ def create_training_job(self, training_job_config, wait_for_completion=True):
         :param training_job_config: the config for training
         :type training_job_config: dict
         :param wait_for_completion: if the program should keep running until job finishes
-        :param wait_for_completion: bool
+        :type wait_for_completion: bool
         :return: A dict that contains ARN of the training job.
         """
         if self.use_db_config:
@@ -194,8 +196,8 @@ def create_training_job(self, training_job_config, wait_for_completion=True):
         response = self.conn.create_training_job(
             **training_job_config)
         if wait_for_completion:
-            self.check_status(['InProgress', 'Stopping', 'Stopped'],
-                              ['Failed'],
+            self.check_status(SageMakerHook.non_terminal_states,
+                              SageMakerHook.failed_states,
                               'TrainingJobStatus',
                               self.describe_training_job,
                               training_job_config['TrainingJobName'])
@@ -213,8 +215,8 @@ def create_tuning_job(self, tuning_job_config, wait_for_completion=True):
         if self.use_db_config:
             if not self.sagemaker_conn_id:
                 raise AirflowException(
-                    "sagemaker connection id must be present to \
-                    read sagemaker tunning job configuration.")
+                    "SageMaker connection id must be present to \
+                    read SageMaker tunning job configuration.")
 
             sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
 
@@ -226,13 +228,59 @@ def create_tuning_job(self, tuning_job_config, wait_for_completion=True):
         response = self.conn.create_hyper_parameter_tuning_job(
             **tuning_job_config)
         if wait_for_completion:
-            self.check_status(['InProgress', 'Stopping', 'Stopped'],
-                              ['Failed'],
+            self.check_status(SageMakerHook.non_terminal_states,
+                              SageMakerHook.failed_states,
                               'HyperParameterTuningJobStatus',
                               self.describe_tuning_job,
                               tuning_job_config['HyperParameterTuningJobName'])
         return response
 
+    def create_transform_job(self, transform_job_config, wait_for_completion=True):
+        """
+        Create a transform job
+        :param transform_job_config: the config for transform job
+        :type transform_job_config: dict
+        :param wait_for_completion:
+        if the program should keep running until job finishes
+        :type wait_for_completion: bool
+        :return: A dict that contains ARN of the transform job.
+        """
+        if self.use_db_config:
+            if not self.sagemaker_conn_id:
+                raise AirflowException(
+                    "SageMaker connection id must be present to \
+                    read SageMaker transform job configuration.")
+
+            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
+
+            config = sagemaker_conn.extra_dejson.copy()
+            transform_job_config.update(config)
+
+        self.check_for_url(transform_job_config
+                           ['TransformInput']['DataSource']
+                           ['S3DataSource']['S3Uri'])
+
+        response = self.conn.create_transform_job(
+            **transform_job_config)
+        if wait_for_completion:
+            self.check_status(SageMakerHook.non_terminal_states,
+                              SageMakerHook.failed_states,
+                              'TransformJobStatus',
+                              self.describe_transform_job,
+                              transform_job_config['TransformJobName'])
+        return response
+
+    def create_model(self, model_config):
+        """
+        Create a model job
+        :param model_config: the config for model
+        :type model_config: dict
+        :return: A dict that contains ARN of the model.
+        """
+
+        return self.conn.create_model(
+            **model_config)
+
     def describe_training_job(self, training_job_name):
         """
         :param training_job_name: the name of the training job
@@ -245,7 +293,7 @@ def describe_training_job(self, training_job_name):
 
     def describe_tuning_job(self, tuning_job_name):
         """
-        :param tuning_job_name: the name of the training job
+        :param tuning_job_name: the name of the tuning job
         :type tuning_job_name: string
         Return the tuning job info associated with the current job_name
         :return: A dict contains all the tuning job info
@@ -253,3 +301,14 @@ def describe_tuning_job(self, tuning_job_name):
         return self.conn\
             .describe_hyper_parameter_tuning_job(
                 HyperParameterTuningJobName=tuning_job_name)
+
+    def describe_transform_job(self, transform_job_name):
+        """
+        :param transform_job_name: the name of the transform job
+        :type transform_job_name: string
+        Return the transform job info associated with the current job_name
+        :return: A dict contains all the transform job info
+        """
+        return self.conn\
+            .describe_transform_job(
+                TransformJobName=transform_job_name)
diff --git a/airflow/contrib/operators/sagemaker_create_training_job_operator.py b/airflow/contrib/operators/sagemaker_create_training_job_operator.py
index 409c5f6aa936a..fdd935fc2931b 100644
--- a/airflow/contrib/operators/sagemaker_create_training_job_operator.py
+++ b/airflow/contrib/operators/sagemaker_create_training_job_operator.py
@@ -50,7 +50,7 @@ class SageMakerCreateTrainingJobOperator(BaseOperator):
        until training job finishes
        :type wait_for_completion: bool
        :param check_interval: if wait is set to be true, this is the time interval
-       which the operator will check the status of the training job
+       in seconds which the operator will check the status of the training job
        :type check_interval: int
        :param max_ingestion_time: if wait is set to be true, the operator will fail
        if the training job hasn't finish within the max_ingestion_time
diff --git a/airflow/contrib/operators/sagemaker_create_transform_job_operator.py b/airflow/contrib/operators/sagemaker_create_transform_job_operator.py
new file mode 100644
index 0000000000000..22c8c2b4ba297
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_create_transform_job_operator.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerCreateTransformJobOperator(BaseOperator):
+    """
+       Initiate a SageMaker transform
+
+       This operator returns The ARN of the model created in Amazon SageMaker
+
+       :param sagemaker_conn_id: The SageMaker connection ID to use.
+       :type sagemaker_conn_id: string
+       :param transform_job_config:
+       The configuration necessary to start a transform job (templated)
+       :type transform_job_config: dict
+       :param model_config:
+       The configuration necessary to create a model, the default is none
+       which means that user should provide a created model in transform_job_config
+       If given, will be used to create a model before creating transform job
+       :type model_config: dict
+       :param use_db_config: Whether or not to use db config
+       associated with sagemaker_conn_id.
+       If set to true, will automatically update the transform config
+       with what's in db, so the db config doesn't need to
+       included everything, but what's there does replace the ones
+       in the transform_job_config, so be careful
+       :type use_db_config: bool
+       :param region_name: The AWS region_name
+       :type region_name: string
+       :param wait_for_completion: if the program should keep running until job finishes
+       :type wait_for_completion: bool
+       :param check_interval: if wait is set to be true, this is the time interval
+       in seconds which the operator will check the status of the transform job
+       :type check_interval: int
+       :param max_ingestion_time: if wait is set to be true, the operator will fail
+       if the transform job hasn't finish within the max_ingestion_time
+       (Caution: be careful to set this parameters because transform can take very long)
+       :type max_ingestion_time: int
+       :param aws_conn_id: The AWS connection ID to use.
+       :type aws_conn_id: string
+
+       **Example**:
+           The following operator would start a transform job when executed
+
+            sagemaker_transform =
+               SageMakerCreateTransformJobOperator(
+                   task_id='sagemaker_transform',
+                   transform_job_config=config_transform,
+                   model_config=config_model,
+                   region_name='us-west-2'
+                   sagemaker_conn_id='sagemaker_customers_conn',
+                   use_db_config=True,
+                   aws_conn_id='aws_customers_conn'
+               )
+       """
+
+    template_fields = ['transform_job_config']
+    template_ext = ()
+    ui_color = '#ededed'
+
+    @apply_defaults
+    def __init__(self,
+                 sagemaker_conn_id=None,
+                 transform_job_config=None,
+                 model_config=None,
+                 use_db_config=False,
+                 region_name=None,
+                 wait_for_completion=True,
+                 check_interval=2,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerCreateTransformJobOperator, self).__init__(*args, **kwargs)
+
+        self.sagemaker_conn_id = sagemaker_conn_id
+        self.transform_job_config = transform_job_config
+        self.model_config = model_config
+        self.use_db_config = use_db_config
+        self.region_name = region_name
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+
+    def execute(self, context):
+        sagemaker = SageMakerHook(
+            sagemaker_conn_id=self.sagemaker_conn_id,
+            use_db_config=self.use_db_config,
+            region_name=self.region_name,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time
+        )
+
+        if self.model_config:
+            self.log.info(
+                "Creating SageMaker Model %s for transform job"
+                % self.model_config['ModelName']
+            )
+            sagemaker.create_model(self.model_config)
+
+        self.log.info(
+            "Creating SageMaker transform Job %s."
+            % self.transform_job_config['TransformJobName']
+        )
+        response = sagemaker.create_transform_job(
+            self.transform_job_config,
+            wait_for_completion=self.wait_for_completion)
+        if not response['ResponseMetadata']['HTTPStatusCode'] \
+           == 200:
+            raise AirflowException(
+                'Sagemaker transform Job creation failed: %s' % response)
+        else:
+            return response
diff --git a/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py b/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
index 0c40a9adc93f4..46ccb2a201144 100644
--- a/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
+++ b/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
@@ -48,7 +48,7 @@ class SageMakerCreateTuningJobOperator(BaseOperator):
        until tuning job finishes
        :type wait_for_completion: bool
        :param check_interval: if wait is set to be true, this is the time interval
-       which the operator will check the status of the tuning job
+       in seconds which the operator will check the status of the tuning job
        :type check_interval: int
        :param max_ingestion_time: if wait is set to be true, the operator will fail
        if the tuning job hasn't finish within the max_ingestion_time
diff --git a/airflow/contrib/sensors/sagemaker_training_sensor.py b/airflow/contrib/sensors/sagemaker_training_sensor.py
index 90c62ce988fbf..449de44c0819c 100644
--- a/airflow/contrib/sensors/sagemaker_training_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_training_sensor.py
@@ -45,10 +45,10 @@ def __init__(self,
         self.region_name = region_name
 
     def non_terminal_states(self):
-        return ['InProgress', 'Stopping', 'Stopped']
+        return SageMakerHook.non_terminal_states
 
     def failed_states(self):
-        return ['Failed']
+        return SageMakerHook.failed_states
 
     def get_sagemaker_response(self):
         sagemaker = SageMakerHook(
diff --git a/airflow/contrib/sensors/sagemaker_transform_sensor.py b/airflow/contrib/sensors/sagemaker_transform_sensor.py
new file mode 100644
index 0000000000000..68ef1d8dd7b05
--- /dev/null
+++ b/airflow/contrib/sensors/sagemaker_transform_sensor.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
+from airflow.utils.decorators import apply_defaults
+
+
+class SageMakerTransformSensor(SageMakerBaseSensor):
+    """
+    Asks for the state of the transform state until it reaches a terminal state.
+    The sensor will error if the job errors, throwing a AirflowException
+    containing the failure reason.
+
+    :param job_name: job_name of the transform job instance to check the state of
+    :type job_name: string
+    :param region_name: The AWS region_name
+    :type region_name: string
+    """
+
+    template_fields = ['job_name']
+    template_ext = ()
+
+    @apply_defaults
+    def __init__(self,
+                 job_name,
+                 region_name=None,
+                 *args,
+                 **kwargs):
+        super(SageMakerTransformSensor, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.region_name = region_name
+
+    def non_terminal_states(self):
+        return SageMakerHook.non_terminal_states
+
+    def failed_states(self):
+        return SageMakerHook.failed_states
+
+    def get_sagemaker_response(self):
+        sagemaker = SageMakerHook(
+            aws_conn_id=self.aws_conn_id,
+            region_name=self.region_name
+        )
+
+        self.log.info('Poking Sagemaker Transform Job %s', self.job_name)
+        return sagemaker.describe_transform_job(self.job_name)
+
+    def get_failed_reason_from_response(self, response):
+        return response['FailureReason']
+
+    def state_from_response(self, response):
+        return response['TransformJobStatus']
diff --git a/airflow/contrib/sensors/sagemaker_tuning_sensor.py b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
index bc74e3a5c5461..1f081100e2c69 100644
--- a/airflow/contrib/sensors/sagemaker_tuning_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
@@ -48,10 +48,10 @@ def __init__(self,
         self.region_name = region_name
 
     def non_terminal_states(self):
-        return ['InProgress', 'Stopping', 'Stopped']
+        return SageMakerHook.non_terminal_states
 
     def failed_states(self):
-        return ['Failed']
+        return SageMakerHook.failed_states
 
     def get_sagemaker_response(self):
         sagemaker = SageMakerHook(
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
index 8bb56cc8e7d12..3a863b3cb0dc7 100644
--- a/tests/contrib/hooks/test_sagemaker_hook.py
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -47,6 +47,8 @@
 
 job_name = 'test-job-name'
 
+model_name = 'test-model-name'
+
 image = 'test-image'
 
 test_arn_return = {'TrainingJobArn': 'testarn'}
@@ -152,6 +154,38 @@
         }
     }
 
+create_transform_params = \
+    {
+        'TransformJobName': job_name,
+        'ModelName': model_name,
+        'BatchStrategy': 'MultiRecord',
+        'TransformInput': {
+            'DataSource': {
+                'S3DataSource': {
+                    'S3DataType': 'S3Prefix',
+                    'S3Uri': data_url
+                }
+            }
+        },
+        'TransformOutput': {
+            'S3OutputPath': output_url,
+        },
+        'TransformResources': {
+            'InstanceType': 'ml.m4.xlarge',
+            'InstanceCount': 123
+        }
+    }
+
+create_model_params = \
+    {
+        'ModelName': model_name,
+        'PrimaryContainer': {
+            'Image': image,
+            'ModelDataUrl': output_url,
+        },
+        'ExecutionRoleArn': role
+    }
+
 db_config = {
     'Tags': [
         {
@@ -393,6 +427,52 @@ def test_create_tuning_job_db_config(self, mock_client, mock_check_tuning):
             assert_called_once_with(**updated_config)
         self.assertEqual(response, test_arn_return)
 
+    @mock.patch.object(SageMakerHook, 'check_for_url')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_transform_job(self, mock_client, mock_check_url):
+        mock_check_url.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_transform_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.create_transform_job(create_transform_params,
+                                             wait_for_completion=False)
+        mock_session.create_transform_job.assert_called_once_with(
+            **create_transform_params)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'check_for_url')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_transform_job_db_config(self, mock_client, mock_check_url):
+        mock_check_url.return_value = True
+        mock_session = mock.Mock()
+        attrs = {'create_transform_job.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook_use_db_config = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
+                                           use_db_config=True)
+        response = hook_use_db_config.create_transform_job(
+            create_transform_params, wait_for_completion=False)
+        updated_config = copy.deepcopy(create_transform_params)
+        updated_config.update(db_config)
+        mock_session.create_transform_job.assert_called_once_with(**updated_config)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_model(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'create_model.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.create_model(create_model_params)
+        mock_session.create_model.assert_called_once_with(**create_model_params)
+        self.assertEqual(response, test_arn_return)
+
     @mock.patch.object(SageMakerHook, 'get_conn')
     def test_describe_training_job(self, mock_client):
         mock_session = mock.Mock()
@@ -418,6 +498,19 @@ def test_describe_tuning_job(self, mock_client):
             assert_called_once_with(HyperParameterTuningJobName=job_name)
         self.assertEqual(response, 'InProgress')
 
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_transform_job(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_transform_job.return_value':
+                 'InProgress'}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_transform_job(job_name)
+        mock_session.describe_transform_job.\
+            assert_called_once_with(TransformJobName=job_name)
+        self.assertEqual(response, 'InProgress')
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_transform_sensor.py b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
new file mode 100644
index 0000000000000..bb4a184bb2797
--- /dev/null
+++ b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.sensors.sagemaker_transform_sensor \
+    import SageMakerTransformSensor
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.exceptions import AirflowException
+
+DESCRIBE_TRANSFORM_INPROGRESS_RETURN = {
+    'TransformJobStatus': 'InProgress',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRANSFORM_COMPELETED_RETURN = {
+    'TransformJobStatus': 'Compeleted',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRANSFORM_FAILED_RETURN = {
+    'TransformJobStatus': 'Failed',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    },
+    'FailureReason': 'Unknown'
+}
+DESCRIBE_TRANSFORM_STOPPING_RETURN = {
+    'TransformJobStatus': 'Stopping',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_TRANSFORM_STOPPED_RETURN = {
+    'TransformJobStatus': 'Stopped',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+
+class TestSageMakerTransformSensor(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'describe_transform_job')
+    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
+        mock_describe_job.side_effect = [DESCRIBE_TRANSFORM_FAILED_RETURN]
+        sensor = SageMakerTransformSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name'
+        )
+        self.assertRaises(AirflowException, sensor.execute, None)
+        mock_describe_job.assert_called_once_with('test_job_name')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
+    @mock.patch.object(SageMakerHook, 'describe_transform_job')
+    def test_calls_until_a_terminal_state(self,
+                                          mock_describe_job, hook_init, mock_client):
+        hook_init.return_value = None
+
+        mock_describe_job.side_effect = [
+            DESCRIBE_TRANSFORM_INPROGRESS_RETURN,
+            DESCRIBE_TRANSFORM_STOPPING_RETURN,
+            DESCRIBE_TRANSFORM_STOPPED_RETURN,
+            DESCRIBE_TRANSFORM_COMPELETED_RETURN
+        ]
+        sensor = SageMakerTransformSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name',
+            region_name='us-east-1'
+        )
+
+        sensor.execute(None)
+
+        # make sure we called 4 times(terminated when its compeleted)
+        self.assertEqual(mock_describe_job.call_count, 4)
+
+        # make sure the hook was initialized with the specific params
+        hook_init.assert_called_with(aws_conn_id='aws_test',
+                                     region_name='us-east-1')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/operators/test_sagemaker_create_transform_job_operator.py b/tests/operators/test_sagemaker_create_transform_job_operator.py
new file mode 100644
index 0000000000000..a8701530d9daa
--- /dev/null
+++ b/tests/operators/test_sagemaker_create_transform_job_operator.py
@@ -0,0 +1,140 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_create_transform_job_operator \
+    import SageMakerCreateTransformJobOperator
+from airflow.exceptions import AirflowException
+
+role = 'test-role'
+
+bucket = 'test-bucket'
+
+key = 'test/data'
+data_url = 's3://{}/{}'.format(bucket, key)
+
+job_name = 'test-job-name'
+
+model_name = 'test-model-name'
+
+image = 'test-image'
+
+output_url = 's3://{}/test/output'.format(bucket)
+
+create_transform_params = \
+    {
+        'TransformJobName': job_name,
+        'ModelName': model_name,
+        'BatchStrategy': 'MultiRecord',
+        'TransformInput': {
+            'DataSource': {
+                'S3DataSource': {
+                    'S3DataType': 'S3Prefix',
+                    'S3Uri': data_url
+                }
+            }
+        },
+        'TransformOutput': {
+            'S3OutputPath': output_url,
+        },
+        'TransformResources': {
+            'InstanceType': 'ml.m4.xlarge',
+            'InstanceCount': 123
+        }
+    }
+
+create_model_params = \
+    {
+        'ModelName': model_name,
+        'PrimaryContainer': {
+            'Image': image,
+            'ModelDataUrl': output_url,
+        },
+        'ExecutionRoleArn': role
+    }
+
+
+class TestSageMakertransformOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerCreateTransformJobOperator(
+            task_id='test_sagemaker_operator',
+            sagemaker_conn_id='sagemaker_test_id',
+            transform_job_config=create_transform_params,
+            model_config=create_model_params,
+            region_name='us-west-2',
+            use_db_config=True,
+            wait_for_completion=False,
+            check_interval=5
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_transform_job')
+    @mock.patch.object(SageMakerHook, '__init__')
+    def test_hook_init(self, hook_init, mock_transform, mock_model, mock_client):
+        mock_transform.return_value = {"TransformJobArn": "testarn",
+                                       "ResponseMetadata":
+                                       {"HTTPStatusCode": 200}}
+        hook_init.return_value = None
+        self.sagemaker.execute(None)
+        hook_init.assert_called_once_with(
+            sagemaker_conn_id='sagemaker_test_id',
+            region_name='us-west-2',
+            use_db_config=True,
+            check_interval=5,
+            max_ingestion_time=None
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_transform_job')
+    def test_execute_without_failure(self, mock_transform, mock_model, mock_client):
+        mock_transform.return_value = {"TransformJobArn": "testarn",
+                                       "ResponseMetadata":
+                                       {"HTTPStatusCode": 200}}
+        self.sagemaker.execute(None)
+        mock_model.assert_called_once_with(create_model_params)
+        mock_transform.assert_called_once_with(create_transform_params,
+                                               wait_for_completion=False
+                                               )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_transform_job')
+    def test_execute_with_failure(self, mock_transform, mock_model, mock_client):
+        mock_transform.return_value = {"TransformJobArn": "testarn",
+                                       "ResponseMetadata":
+                                       {"HTTPStatusCode": 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()

From dde50e4413c2c8accce75609cfd4cb1fe51dfab0 Mon Sep 17 00:00:00 2001
From: Aishwarya Mohan <aimohan@paypal.com>
Date: Thu, 9 Aug 2018 14:42:35 -0700
Subject: [PATCH 055/808] [AIRFLOW-2763] Add check to validate worker
 connectivity to metadata Database

---
 airflow/bin/cli.py                           |  5 ++
 airflow/config_templates/default_airflow.cfg |  3 +
 airflow/config_templates/default_test.cfg    |  1 +
 airflow/settings.py                          | 22 +++++-
 tests/cli/test_worker_initialisation.py      | 73 ++++++++++++++++++++
 5 files changed, 103 insertions(+), 1 deletion(-)
 create mode 100644 tests/cli/test_worker_initialisation.py

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index ac52a42664caf..a84ede16fcb5f 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -951,6 +951,11 @@ def worker(args):
     env = os.environ.copy()
     env['AIRFLOW_HOME'] = settings.AIRFLOW_HOME
 
+    if not settings.validate_session():
+        log = LoggingMixin().log
+        log.error("Worker exiting... database connection precheck failed! ")
+        sys.exit(1)
+
     # Celery worker
     from airflow.executors.celery_executor import app as celery_app
     from celery.bin import worker
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index deb67bb96ca25..7ea81487aa99a 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -173,6 +173,9 @@ killed_task_cleanup_time = 60
 # `airflow trigger_dag -c`, the key-value pairs will override the existing ones in params.
 dag_run_conf_overrides_params = False
 
+# Worker initialisation check to validate Metadata Database connection
+worker_precheck = False
+
 [cli]
 # In what way should the cli access the API. The LocalClient will use the
 # database directly, while the json_client will use the api running on the
diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index cd4bd32e68fe9..9dc1ef94ec044 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -51,6 +51,7 @@ enable_xcom_pickling = False
 killed_task_cleanup_time = 5
 secure_mode = False
 hostname_callable = socket:getfqdn
+worker_precheck = False
 
 [cli]
 api_client = airflow.api.client.local_client
diff --git a/airflow/settings.py b/airflow/settings.py
index 7c0376d12f9b5..984c52ea5d206 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -27,7 +27,7 @@
 import os
 import pendulum
 
-from sqlalchemy import create_engine
+from sqlalchemy import create_engine, exc
 from sqlalchemy.orm import scoped_session, sessionmaker
 from sqlalchemy.pool import NullPool
 
@@ -211,6 +211,26 @@ def configure_adapters():
         pass
 
 
+def validate_session():
+    try:
+        worker_precheck = conf.getboolean('core', 'worker_precheck')
+    except conf.AirflowConfigException:
+        worker_precheck = False
+    if not worker_precheck:
+        return True
+    else:
+        check_session = sessionmaker(bind=engine)
+        session = check_session()
+        try:
+            session.execute("select 1")
+            conn_status = True
+        except exc.DBAPIError as err:
+            log.error(err)
+            conn_status = False
+        session.close()
+        return conn_status
+
+
 def configure_action_logging():
     """
     Any additional configuration (register callback) for airflow.utils.action_loggers
diff --git a/tests/cli/test_worker_initialisation.py b/tests/cli/test_worker_initialisation.py
new file mode 100644
index 0000000000000..477221693abe1
--- /dev/null
+++ b/tests/cli/test_worker_initialisation.py
@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+import sqlalchemy
+import airflow
+from argparse import Namespace
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+from mock import patch
+
+patch('airflow.utils.cli.action_logging', lambda x: x).start()
+from airflow.bin import cli # noqa
+mock_args = Namespace(queues=1, concurrency=1)
+
+
+class TestWorkerPrecheck(unittest.TestCase):
+
+    def setUp(self):
+        airflow.configuration.load_test_config()
+
+    @mock.patch('airflow.settings.validate_session')
+    def test_error(self, mock_validate_session):
+        """
+        Test to verify the exit mechanism of airflow-worker cli
+        by mocking validate_session method
+        """
+        mock_validate_session.return_value = False
+        with self.assertRaises(SystemExit) as cm:
+            # airflow.bin.cli.worker(mock_args)
+            cli.worker(mock_args)
+        self.assertEqual(cm.exception.code, 1)
+
+    @mock.patch('airflow.configuration.getboolean')
+    def test_worker_precheck_exception(self, mock_getboolean):
+        """
+        Test to check the behaviour of validate_session method
+        when worker_precheck is absent in airflow configuration
+        """
+        mock_getboolean.side_effect = airflow.configuration.AirflowConfigException
+        self.assertEqual(airflow.settings.validate_session(), True)
+
+    @mock.patch('sqlalchemy.orm.session.Session.execute')
+    @mock.patch('airflow.configuration.getboolean')
+    def test_validate_session_dbapi_exception(self, mock_getboolean, mock_session):
+        """
+        Test to validate connection failure scenario on SELECT 1 query
+        """
+        mock_getboolean.return_value = True
+        mock_session.side_effect = sqlalchemy.exc.OperationalError("m1", "m2", "m3", "m4")
+        self.assertEquals(airflow.settings.validate_session(), False)

From 97b63bc6845014fbecc1062d9b3852fc8de06e2f Mon Sep 17 00:00:00 2001
From: Yuliya Volkova <xnuinside@gmail.com>
Date: Fri, 10 Aug 2018 05:43:50 -0500
Subject: [PATCH 056/808] [AIRFLOW-1874] use_legacy_sql added to BigQueryCheck
 operators (#3717)

---
 .../operators/bigquery_check_operator.py      | 50 ++++++++++++-------
 1 file changed, 32 insertions(+), 18 deletions(-)

diff --git a/airflow/contrib/operators/bigquery_check_operator.py b/airflow/contrib/operators/bigquery_check_operator.py
index 59ef5d377d182..a9c493f4fd418 100644
--- a/airflow/contrib/operators/bigquery_check_operator.py
+++ b/airflow/contrib/operators/bigquery_check_operator.py
@@ -55,21 +55,25 @@ class BigQueryCheckOperator(CheckOperator):
     :type sql: string
     :param bigquery_conn_id: reference to the BigQuery database
     :type bigquery_conn_id: string
+    :param use_legacy_sql: Whether to use legacy SQL (true)
+    or standard SQL (false).
+    :type use_legacy_sql: boolean
     """
 
     @apply_defaults
-    def __init__(
-            self,
-            sql,
-            bigquery_conn_id='bigquery_default',
-            *args,
-            **kwargs):
+    def __init__(self,
+                 sql,
+                 bigquery_conn_id='bigquery_default',
+                 use_legacy_sql=True,
+                 *args, **kwargs):
         super(BigQueryCheckOperator, self).__init__(sql=sql, *args, **kwargs)
         self.bigquery_conn_id = bigquery_conn_id
         self.sql = sql
+        self.use_legacy_sql = use_legacy_sql
 
     def get_db_hook(self):
-        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id)
+        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
+                            use_legacy_sql=self.use_legacy_sql)
 
 
 class BigQueryValueCheckOperator(ValueCheckOperator):
@@ -78,20 +82,27 @@ class BigQueryValueCheckOperator(ValueCheckOperator):
 
     :param sql: the sql to be executed
     :type sql: string
+    :param use_legacy_sql: Whether to use legacy SQL (true)
+    or standard SQL (false).
+    :type use_legacy_sql: boolean
     """
 
     @apply_defaults
-    def __init__(
-            self, sql, pass_value, tolerance=None,
-            bigquery_conn_id='bigquery_default',
-            *args, **kwargs):
+    def __init__(self, sql,
+                 pass_value,
+                 tolerance=None,
+                 bigquery_conn_id='bigquery_default',
+                 use_legacy_sql=True,
+                 *args, **kwargs):
         super(BigQueryValueCheckOperator, self).__init__(
             sql=sql, pass_value=pass_value, tolerance=tolerance,
             *args, **kwargs)
         self.bigquery_conn_id = bigquery_conn_id
+        self.use_legacy_sql = use_legacy_sql
 
     def get_db_hook(self):
-        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id)
+        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
+                            use_legacy_sql=self.use_legacy_sql)
 
 
 class BigQueryIntervalCheckOperator(IntervalCheckOperator):
@@ -113,19 +124,22 @@ class BigQueryIntervalCheckOperator(IntervalCheckOperator):
         example 'COUNT(*)': 1.5 would require a 50 percent or less difference
         between the current day, and the prior days_back.
     :type metrics_threshold: dict
+    :param use_legacy_sql: Whether to use legacy SQL (true)
+    or standard SQL (false).
+    :type use_legacy_sql: boolean
     """
 
     @apply_defaults
-    def __init__(
-            self, table, metrics_thresholds,
-            date_filter_column='ds', days_back=-7,
-            bigquery_conn_id='bigquery_default',
-            *args, **kwargs):
+    def __init__(self, table, metrics_thresholds, date_filter_column='ds',
+                 days_back=-7, bigquery_conn_id='bigquery_default',
+                 use_legacy_sql=True, *args, **kwargs):
         super(BigQueryIntervalCheckOperator, self).__init__(
             table=table, metrics_thresholds=metrics_thresholds,
             date_filter_column=date_filter_column, days_back=days_back,
             *args, **kwargs)
         self.bigquery_conn_id = bigquery_conn_id
+        self.use_legacy_sql = use_legacy_sql
 
     def get_db_hook(self):
-        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id)
+        return BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
+                            use_legacy_sql=self.use_legacy_sql)

From c4b9ba97eabcf813786535cc4de1bda6d0760375 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@gmail.com>
Date: Fri, 10 Aug 2018 09:25:33 -0700
Subject: [PATCH 057/808] [AIRFLOW-2786] Gracefully handle Variable import
 errors (#3648)

Variables that are added through a file are not
checked as explicity as creating a Variable in the
web UI. This handles exceptions that could be caused
by improper keys or values.
---
 airflow/www/utils.py         |  9 +++++--
 airflow/www/views.py         | 15 +++++++++--
 airflow/www_rbac/utils.py    |  9 +++++--
 airflow/www_rbac/views.py    | 13 +++++++--
 tests/www/test_utils.py      |  4 +++
 tests/www/test_views.py      | 52 +++++++++++++++++++++++++++---------
 tests/www_rbac/test_utils.py |  4 +++
 tests/www_rbac/test_views.py | 20 ++++++++++++++
 8 files changed, 105 insertions(+), 21 deletions(-)

diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 09ac465c52d1b..03ba1f775b001 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -58,8 +58,13 @@
 
 
 def should_hide_value_for_key(key_name):
-    return any(s in key_name.lower() for s in DEFAULT_SENSITIVE_VARIABLE_FIELDS) \
-        and configuration.conf.getboolean('admin', 'hide_sensitive_variable_fields')
+    # It is possible via importing variables from file that a key is empty.
+    if key_name:
+        config_set = configuration.conf.getboolean('admin',
+                                                   'hide_sensitive_variable_fields')
+        field_comp = any(s in key_name.lower() for s in DEFAULT_SENSITIVE_VARIABLE_FIELDS)
+        return config_set and field_comp
+    return False
 
 
 class LoginMixin(object):
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 851ad90cb2770..ccbaafbbeb5a5 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1903,9 +1903,20 @@ def varimport(self):
         except Exception as e:
             flash("Missing file or syntax error: {}.".format(e))
         else:
+            suc_count = fail_count = 0
             for k, v in d.items():
-                models.Variable.set(k, v, serialize_json=isinstance(v, dict))
-            flash("{} variable(s) successfully updated.".format(len(d)))
+                try:
+                    models.Variable.set(k, v, serialize_json=isinstance(v, dict))
+                except Exception as e:
+                    logging.info('Variable import failed: {}'.format(repr(e)))
+                    fail_count += 1
+                else:
+                    suc_count += 1
+            flash("{} variable(s) successfully updated.".format(suc_count), 'info')
+            if fail_count:
+                flash(
+                    "{} variables(s) failed to be updated.".format(fail_count), 'error')
+
         return redirect('/admin/variable')
 
 
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index 14e18f8bc30e7..0176a5312c373 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -58,8 +58,13 @@
 
 
 def should_hide_value_for_key(key_name):
-    return any(s in key_name.lower() for s in DEFAULT_SENSITIVE_VARIABLE_FIELDS) \
-        and configuration.getboolean('admin', 'hide_sensitive_variable_fields')
+    # It is possible via importing variables from file that a key is empty.
+    if key_name:
+        config_set = configuration.conf.getboolean('admin',
+                                                   'hide_sensitive_variable_fields')
+        field_comp = any(s in key_name.lower() for s in DEFAULT_SENSITIVE_VARIABLE_FIELDS)
+        return config_set and field_comp
+    return False
 
 
 def get_params(**kwargs):
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index a65e1d26e3995..34bdbc6ecb09a 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1866,9 +1866,18 @@ def varimport(self):
         except Exception:
             flash("Missing file or syntax error.")
         else:
+            suc_count = fail_count = 0
             for k, v in d.items():
-                models.Variable.set(k, v, serialize_json=isinstance(v, dict))
-            flash("{} variable(s) successfully updated.".format(len(d)))
+                try:
+                    models.Variable.set(k, v, serialize_json=isinstance(v, dict))
+                except Exception as e:
+                    logging.info('Variable import failed: {}'.format(repr(e)))
+                    fail_count += 1
+                else:
+                    suc_count += 1
+            flash("{} variable(s) successfully updated.".format(suc_count), 'info')
+            if fail_count:
+                flash("{} variables(s) failed to be updated.".format(fail_count), 'error')
             self.update_redirect()
             return redirect(self.get_redirect())
 
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index f5c3f01fb916d..904853bac156d 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -31,6 +31,10 @@ class UtilsTest(unittest.TestCase):
     def setUp(self):
         super(UtilsTest, self).setUp()
 
+    def test_empty_variable_should_not_be_hidden(self):
+        self.assertFalse(utils.should_hide_value_for_key(""))
+        self.assertFalse(utils.should_hide_value_for_key(None))
+
     def test_normal_variable_should_not_be_hidden(self):
         self.assertFalse(utils.should_hide_value_for_key("key"))
 
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index f59470ea3de11..bb183d4a649b7 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -20,6 +20,7 @@
 import io
 import copy
 import logging.config
+import mock
 import os
 import shutil
 import tempfile
@@ -450,6 +451,28 @@ def tearDownClass(cls):
         session.close()
         super(TestVarImportView, cls).tearDownClass()
 
+    def test_import_variable_fail(self):
+        with mock.patch('airflow.models.Variable.set') as set_mock:
+            set_mock.side_effect = UnicodeEncodeError
+            content = '{"fail_key": "fail_val"}'
+
+            try:
+                # python 3+
+                bytes_content = io.BytesIO(bytes(content, encoding='utf-8'))
+            except TypeError:
+                # python 2.7
+                bytes_content = io.BytesIO(bytes(content))
+            response = self.app.post(
+                self.IMPORT_ENDPOINT,
+                data={'file': (bytes_content, 'test.json')},
+                follow_redirects=True
+            )
+            self.assertEqual(response.status_code, 200)
+            session = Session()
+            db_dict = {x.key: x.get_val() for x in session.query(models.Variable).all()}
+            session.close()
+            self.assertNotIn('fail_key', db_dict)
+
     def test_import_variables(self):
         content = ('{"str_key": "str_value", "int_key": 60,'
                    '"list_key": [1, 2], "dict_key": {"k_a": 2, "k_b": 3}}')
@@ -465,21 +488,24 @@ def test_import_variables(self):
             follow_redirects=True
         )
         self.assertEqual(response.status_code, 200)
-        body = response.data.decode('utf-8')
-        self.assertIn('str_key', body)
-        self.assertIn('int_key', body)
-        self.assertIn('list_key', body)
-        self.assertIn('dict_key', body)
-        self.assertIn('str_value', body)
-        self.assertIn('60', body)
-        self.assertIn('[1, 2]', body)
-        # As dicts are not ordered, we may get any of the following cases.
-        case_a_dict = '{&#34;k_a&#34;: 2, &#34;k_b&#34;: 3}'
-        case_b_dict = '{&#34;k_b&#34;: 3, &#34;k_a&#34;: 2}'
+        session = Session()
+        # Extract values from Variable
+        db_dict = {x.key: x.get_val() for x in session.query(models.Variable).all()}
+        session.close()
+        self.assertIn('str_key', db_dict)
+        self.assertIn('int_key', db_dict)
+        self.assertIn('list_key', db_dict)
+        self.assertIn('dict_key', db_dict)
+        self.assertEquals('str_value', db_dict['str_key'])
+        self.assertEquals('60', db_dict['int_key'])
+        self.assertEquals('[1, 2]', db_dict['list_key'])
+
+        case_a_dict = '{"k_a": 2, "k_b": 3}'
+        case_b_dict = '{"k_b": 3, "k_a": 2}'
         try:
-            self.assertIn(case_a_dict, body)
+            self.assertEquals(case_a_dict, db_dict['dict_key'])
         except AssertionError:
-            self.assertIn(case_b_dict, body)
+            self.assertEquals(case_b_dict, db_dict['dict_key'])
 
 
 class TestMountPoint(unittest.TestCase):
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index c7179fa3a421d..68d1744ab8fa8 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -29,6 +29,10 @@ class UtilsTest(unittest.TestCase):
     def setUp(self):
         super(UtilsTest, self).setUp()
 
+    def test_empty_variable_should_not_be_hidden(self):
+        self.assertFalse(utils.should_hide_value_for_key(""))
+        self.assertFalse(utils.should_hide_value_for_key(None))
+
     def test_normal_variable_should_not_be_hidden(self):
         self.assertFalse(utils.should_hide_value_for_key("key"))
 
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 71dcab0d073a6..0a4eb7c03d16c 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -21,6 +21,7 @@
 import io
 import json
 import logging.config
+import mock
 import os
 import shutil
 import sys
@@ -168,6 +169,25 @@ def test_xss_prevention(self):
         self.assertNotIn("<img src='' onerror='alert(1);'>",
                          resp.data.decode("utf-8"))
 
+    def test_import_variables(self):
+        content = '{"str_key": "str_value"}'
+
+        with mock.patch('airflow.models.Variable.set') as set_mock:
+            set_mock.side_effect = UnicodeEncodeError
+            self.assertEqual(self.session.query(models.Variable).count(), 0)
+
+            try:
+                # python 3+
+                bytes_content = io.BytesIO(bytes(content, encoding='utf-8'))
+            except TypeError:
+                # python 2.7
+                bytes_content = io.BytesIO(bytes(content))
+
+            resp = self.client.post('/variable/varimport',
+                                    data={'file': (bytes_content, 'test.json')},
+                                    follow_redirects=True)
+            self.check_content_in_response('1 variable(s) failed to be updated.', resp)
+
     def test_import_variables(self):
         self.assertEqual(self.session.query(models.Variable).count(), 0)
 

From 26f97c230e87b58dc3616086187228a6d83015ca Mon Sep 17 00:00:00 2001
From: awelsh93 <32643586+awelsh93@users.noreply.github.com>
Date: Mon, 13 Aug 2018 17:42:04 +0100
Subject: [PATCH 058/808] [AIRFLOW-2860] DruidHook: time check is wrong (#3745)

---
 airflow/hooks/druid_hook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index ef4f2338d29dc..50cee8a2259b1 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -81,8 +81,6 @@ def submit_indexing_job(self, json_index_spec):
 
             self.log.info("Job still running for %s seconds...", sec)
 
-            sec = sec + 1
-
             if self.max_ingestion_time and sec > self.max_ingestion_time:
                 # ensure that the job gets killed if the max ingestion time is exceeded
                 requests.post("{0}/{1}/shutdown".format(url, druid_task_id))
@@ -91,6 +89,8 @@ def submit_indexing_job(self, json_index_spec):
 
             time.sleep(self.timeout)
 
+            sec = sec + self.timeout
+
             status = req_status.json()['status']['status']
             if status == 'RUNNING':
                 running = True

From 7bbde14655506d5041271db704b78fd7131b2bb6 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 23 Jul 2018 13:09:14 +0200
Subject: [PATCH 059/808] [AIRFLOW-2773] Validates Dataflow Job Name

Closes #3623 from kaxil/AIRFLOW-2773
---
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 35 +++++----
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 71 ++++++++++++++++++-
 2 files changed, 91 insertions(+), 15 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 7abb413a1afcf..f24bdce5986bc 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 import json
+import re
 import select
 import subprocess
 import time
@@ -166,7 +167,7 @@ def __init__(self,
 
     def get_conn(self):
         """
-        Returns a Google Cloud Storage service object.
+        Returns a Google Cloud Dataflow service object.
         """
         http_authorized = self._authorize()
         return build(
@@ -191,10 +192,7 @@ def _set_variables(variables):
 
     def start_java_dataflow(self, task_id, variables, dataflow, job_class=None,
                             append_job_name=True):
-        if append_job_name:
-            name = task_id + "-" + str(uuid.uuid1())[:8]
-        else:
-            name = task_id
+        name = self._build_dataflow_job_name(task_id, append_job_name)
         variables['jobName'] = name
 
         def label_formatter(labels_dict):
@@ -207,19 +205,13 @@ def label_formatter(labels_dict):
 
     def start_template_dataflow(self, task_id, variables, parameters, dataflow_template,
                                 append_job_name=True):
-        if append_job_name:
-            name = task_id + "-" + str(uuid.uuid1())[:8]
-        else:
-            name = task_id
+        name = self._build_dataflow_job_name(task_id, append_job_name)
         self._start_template_dataflow(
             name, variables, parameters, dataflow_template)
 
     def start_python_dataflow(self, task_id, variables, dataflow, py_options,
                               append_job_name=True):
-        if append_job_name:
-            name = task_id + "-" + str(uuid.uuid1())[:8]
-        else:
-            name = task_id
+        name = self._build_dataflow_job_name(task_id, append_job_name)
         variables['job_name'] = name
 
         def label_formatter(labels_dict):
@@ -229,6 +221,23 @@ def label_formatter(labels_dict):
                              ["python"] + py_options + [dataflow],
                              label_formatter)
 
+    @staticmethod
+    def _build_dataflow_job_name(task_id, append_job_name=True):
+        task_id = str(task_id).replace('_', '-')
+
+        assert re.match(r"^[a-z]([-a-z0-9]*[a-z0-9])?$", task_id), \
+            'Invalid job_name ({}); the name must consist of ' \
+            'only the characters [-a-z0-9], starting with a ' \
+            'letter and ending with a letter or number '.format(
+                task_id)
+
+        if append_job_name:
+            job_name = task_id + "-" + str(uuid.uuid1())[:8]
+        else:
+            job_name = task_id
+
+        return job_name
+
     def _build_cmd(self, task_id, variables, label_formatter):
         command = ["--runner=DataflowRunner"]
         if variables is not None:
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index f16dcdfcbc1e1..90714c6ee4f62 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -172,6 +172,73 @@ def poll_resp_error():
       self.assertRaises(Exception, dataflow.wait_for_done)
       mock_logging.warning.assert_has_calls([call('test'), call('error')])
 
+    def test_valid_dataflow_job_name(self):
+        job_name = self.dataflow_hook._build_dataflow_job_name(
+            task_id=TASK_ID, append_job_name=False
+        )
+
+        self.assertEquals(job_name, TASK_ID)
+
+    def test_fix_underscore_in_task_id(self):
+        task_id_with_underscore = 'test_example'
+        fixed_job_name = task_id_with_underscore.replace(
+            '_', '-'
+        )
+        job_name = self.dataflow_hook._build_dataflow_job_name(
+            task_id=task_id_with_underscore, append_job_name=False
+        )
+
+        self.assertEquals(job_name, fixed_job_name)
+
+    def test_invalid_dataflow_job_name(self):
+        invalid_job_name = '9test_invalid_name'
+        fixed_name = invalid_job_name.replace(
+            '_', '-')
+
+        with self.assertRaises(AssertionError) as e:
+            self.dataflow_hook._build_dataflow_job_name(
+                task_id=invalid_job_name, append_job_name=False
+            )
+        #   Test whether the job_name is present in the Error msg
+        self.assertIn('Invalid job_name ({})'.format(fixed_name),
+                      str(e.exception))
+
+    def test_dataflow_job_regex_check(self):
+
+        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+            task_id='df-job-1', append_job_name=False
+        ), 'df-job-1')
+
+        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+            task_id='df-job', append_job_name=False
+        ), 'df-job')
+
+        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+            task_id='dfjob', append_job_name=False
+        ), 'dfjob')
+
+        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+            task_id='dfjob1', append_job_name=False
+        ), 'dfjob1')
+
+        self.assertRaises(
+            AssertionError,
+            self.dataflow_hook._build_dataflow_job_name,
+            task_id='1dfjob', append_job_name=False
+        )
+
+        self.assertRaises(
+            AssertionError,
+            self.dataflow_hook._build_dataflow_job_name,
+            task_id='dfjob@', append_job_name=False
+        )
+
+        self.assertRaises(
+            AssertionError,
+            self.dataflow_hook._build_dataflow_job_name,
+            task_id='df^jo', append_job_name=False
+        )
+
 
 class DataFlowTemplateHookTest(unittest.TestCase):
 

From b1041cf7d93db64345bc86228afa368f27f93a17 Mon Sep 17 00:00:00 2001
From: Paul Woods <pwoods25443@gmail.com>
Date: Sat, 21 Jul 2018 13:04:23 +0100
Subject: [PATCH 060/808] [AIRFLOW-2769] Increase num_retries polling value on
 Dataflow hook

Closes #3617 from pwoods25443/2769-dataflow-num-
retries
---
 airflow/contrib/hooks/gcp_dataflow_hook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index f24bdce5986bc..279b9dd21a862 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -47,7 +47,7 @@ def _get_job_id_from_name(self):
         jobs = self._dataflow.projects().locations().jobs().list(
             projectId=self._project_number,
             location=self._job_location
-        ).execute()
+        ).execute(num_retries=5)
         for job in jobs['jobs']:
             if job['name'] == self._job_name:
                 self._job_id = job['id']
@@ -61,7 +61,7 @@ def _get_job(self):
             job = self._dataflow.projects().jobs().get(
                 projectId=self._project_number,
                 jobId=self._job_id
-            ).execute()
+            ).execute(num_retries=5)
 
         if job and 'currentState' in job:
             self.log.info(

From 133c02cbd571e36f0c89f150c377ba23f13a5870 Mon Sep 17 00:00:00 2001
From: Ivan Arozamena <you@example.com>
Date: Tue, 17 Jul 2018 13:56:05 +0100
Subject: [PATCH 061/808] [AIRFLOW-2749] Add feature to delete BQ Dataset

Closes #3598 from MENA1717/Add-bq-op
---
 airflow/contrib/hooks/bigquery_hook.py        | 29 +++++++++++
 .../contrib/operators/bigquery_operator.py    | 52 +++++++++++++++++++
 docs/code.rst                                 |  1 +
 docs/integration.rst                          | 14 +++--
 .../operators/test_bigquery_operator.py       | 22 +++++++-
 5 files changed, 114 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index b452f51c22c69..90513d81fa25d 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1255,6 +1255,35 @@ def run_grant_dataset_view_access(self,
                 source_dataset)
             return source_dataset_resource
 
+    def delete_dataset(self,
+                       project_id,
+                       dataset_id
+                       ):
+        """
+        Delete a dataset of Big query in your project.
+        :param project_id: The name of the project where we have the dataset .
+        :type project_id: str
+        :param dataset_id: The dataset to be delete.
+        :type dataset_id: str
+        :return:
+        """
+        project_id = project_id if project_id is not None else self.project_id
+        self.log.info('Deleting from project: %s  Dataset:%s',
+                      project_id, dataset_id)
+
+        try:
+            self.service.datasets().delete(
+                projectId=project_id,
+                datasetId=dataset_id).execute()
+
+            self.log.info('Dataset deleted successfully: In project %s Dataset %s',
+                          project_id, dataset_id)
+
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content)
+            )
+
 
 class BigQueryCursor(BigQueryBaseCursor):
     """
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index b36efbd6bfd43..ca2efb55abad9 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -481,3 +481,55 @@ def execute(self, context):
             allow_jagged_rows=self.allow_jagged_rows,
             src_fmt_configs=self.src_fmt_configs
         )
+
+
+class BigQueryDeleteDatasetOperator(BaseOperator):
+    """"
+    This operator deletes an existing dataset from your Project in Big query.
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/delete
+    :param project_id: The project id of the dataset.
+    :type project_id: string
+    :param dataset_id: The dataset to be deleted.
+    :type dataset_id: string
+
+    **Example**: ::
+
+        delete_temp_data = BigQueryDeleteDatasetOperator(
+                                        dataset_id = 'temp-dataset',
+                                        project_id = 'temp-project',
+                                        bigquery_conn_id='_my_gcp_conn_',
+                                        task_id='Deletetemp',
+                                        dag=dag)
+    """
+
+    template_fields = ('dataset_id', 'project_id')
+    ui_color = '#f00004'
+
+    @apply_defaults
+    def __init__(self,
+                 dataset_id,
+                 project_id=None,
+                 bigquery_conn_id='bigquery_default',
+                 delegate_to=None,
+                 *args, **kwargs):
+        self.dataset_id = dataset_id
+        self.project_id = project_id
+        self.bigquery_conn_id = bigquery_conn_id
+        self.delegate_to = delegate_to
+
+        self.log.info('Dataset id: %s', self.dataset_id)
+        self.log.info('Project id: %s', self.project_id)
+
+        super(BigQueryDeleteDatasetOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
+                               delegate_to=self.delegate_to)
+
+        conn = bq_hook.get_conn()
+        cursor = conn.cursor()
+
+        cursor.delete_dataset(
+            project_id=self.project_id,
+            dataset_id=self.dataset_id
+        )
diff --git a/docs/code.rst b/docs/code.rst
index f055fc60cffe6..521b55f9d41ce 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -117,6 +117,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
 .. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index 660b2163d9849..99dbafbd2bc58 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -118,9 +118,9 @@ WasbHook
 Azure File Share
 ''''''''''''''''
 
-Cloud variant of a SMB file share. Make sure that a Airflow connection of 
-type `wasb` exists. Authorization can be done by supplying a login (=Storage account name) 
-and password (=Storage account key), or login and SAS token in the extra field 
+Cloud variant of a SMB file share. Make sure that a Airflow connection of
+type `wasb` exists. Authorization can be done by supplying a login (=Storage account name)
+and password (=Storage account key), or login and SAS token in the extra field
 (see connection `wasb_default` for an example).
 
 AzureFileShareHook
@@ -349,6 +349,7 @@ BigQuery Operators
 - :ref:`BigQueryIntervalCheckOperator` : Checks that the values of metrics given as SQL expressions are within a certain tolerance of the ones from days_back before.
 - :ref:`BigQueryCreateEmptyTableOperator` : Creates a new, empty table in the specified BigQuery dataset optionally with schema.
 - :ref:`BigQueryCreateExternalTableOperator` : Creates a new, external table in the dataset with the data in Google Cloud Storage.
+- :ref:`BigQueryDeleteDatasetOperator` : Deletes an existing BigQuery dataset.
 - :ref:`BigQueryOperator` : Executes BigQuery SQL queries in a specific BigQuery database.
 - :ref:`BigQueryToBigQueryOperator` : Copy a BigQuery table to another BigQuery table.
 - :ref:`BigQueryToCloudStorageOperator` : Transfers a BigQuery table to a Google Cloud Storage bucket
@@ -396,6 +397,13 @@ BigQueryCreateExternalTableOperator
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
 
+.. _BigQueryDeleteDatasetOperator:
+
+BigQueryDeleteDatasetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
+
 .. _BigQueryOperator:
 
 BigQueryOperator
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 6a51d0c46d294..21a42d3ef8f46 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -23,7 +23,7 @@
 from airflow.contrib.operators.bigquery_operator import \
     BigQueryCreateExternalTableOperator, \
     BigQueryOperator, \
-    BigQueryCreateEmptyTableOperator
+    BigQueryCreateEmptyTableOperator, BigQueryDeleteDatasetOperator
 
 try:
     from unittest import mock
@@ -114,3 +114,23 @@ def test_execute(self, mock_hook):
                 allow_jagged_rows=False,
                 src_fmt_configs={}
             )
+
+
+class BigQueryDeleteDatasetOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
+    def test_execute(self, mock_hook):
+        operator = BigQueryDeleteDatasetOperator(
+            task_id=TASK_ID,
+            dataset_id=TEST_DATASET,
+            project_id=TEST_PROJECT_ID
+        )
+
+        operator.execute(None)
+        mock_hook.return_value \
+            .get_conn() \
+            .cursor() \
+            .delete_dataset \
+            .assert_called_once_with(
+                dataset_id=TEST_DATASET,
+                project_id=TEST_PROJECT_ID
+            )

From 77aa239f982a38f4b5e1fa883868d99bb394cd0f Mon Sep 17 00:00:00 2001
From: Tomas Jansson <tomas.jansson@unacast.com>
Date: Tue, 17 Jul 2018 13:59:41 +0100
Subject: [PATCH 062/808] [AIRFLOW-2704] Add support for labels in the
 bigquery_operator

[AIRFLOW-2704]Add support for labels in the
bigquery_operator

Adds support for bigquery labels in the bigquery
operator and hook.

Make labels template fields

Closes #3573 from mastoj/AIRFLOW-2704
---
 airflow/contrib/hooks/bigquery_hook.py        | 41 +++++++++++++++++--
 .../contrib/operators/bigquery_operator.py    | 27 +++++++++---
 .../contrib/operators/bigquery_to_bigquery.py | 10 ++++-
 airflow/contrib/operators/bigquery_to_gcs.py  | 11 ++++-
 tests/contrib/hooks/test_bigquery_hook.py     | 27 +++++++++++-
 .../operators/test_bigquery_operator.py       |  6 ++-
 6 files changed, 105 insertions(+), 17 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 90513d81fa25d..f4c1a3b520217 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -206,7 +206,8 @@ def create_empty_table(self,
                            dataset_id,
                            table_id,
                            schema_fields=None,
-                           time_partitioning={}
+                           time_partitioning={},
+                           labels=None
                            ):
         """
         Creates a new, empty table in the dataset.
@@ -219,6 +220,8 @@ def create_empty_table(self,
         :type table_id: str
         :param schema_fields: If set, the schema field list as defined here:
         https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
+        :param labels: a dictionary containing labels for the table, passed to BigQuery
+        :type labels: dict
 
         **Example**: ::
 
@@ -249,6 +252,9 @@ def create_empty_table(self,
         if time_partitioning:
             table_resource['timePartitioning'] = time_partitioning
 
+        if labels:
+            table_resource['labels'] = labels
+
         self.log.info('Creating Table %s:%s.%s',
                       project_id, dataset_id, table_id)
 
@@ -280,7 +286,8 @@ def create_external_table(self,
                               quote_character=None,
                               allow_quoted_newlines=False,
                               allow_jagged_rows=False,
-                              src_fmt_configs={}
+                              src_fmt_configs={},
+                              labels=None
                               ):
         """
         Creates a new external table in the dataset with the data in Google
@@ -341,6 +348,8 @@ def create_external_table(self,
         :type allow_jagged_rows: bool
         :param src_fmt_configs: configure optional fields specific to the source format
         :type src_fmt_configs: dict
+        :param labels: a dictionary containing labels for the table, passed to BigQuery
+        :type labels: dict
         """
 
         project_id, dataset_id, external_table_id = \
@@ -439,6 +448,9 @@ def create_external_table(self,
             table_resource['externalDataConfiguration'][src_fmt_to_param_mapping[
                 source_format]] = src_fmt_configs
 
+        if labels:
+            table_resource['labels'] = labels
+
         try:
             self.service.tables().insert(
                 projectId=project_id,
@@ -467,6 +479,7 @@ def run_query(self,
                   maximum_bytes_billed=None,
                   create_disposition='CREATE_IF_NEEDED',
                   query_params=None,
+                  labels=None,
                   schema_update_options=(),
                   priority='INTERACTIVE',
                   time_partitioning={}):
@@ -516,6 +529,9 @@ def run_query(self,
         :param query_params a dictionary containing query parameter types and
             values, passed to BigQuery
         :type query_params: dict
+        :param labels a dictionary containing labels for the job/query,
+            passed to BigQuery
+        :type labels: dict
         :param schema_update_options: Allows the schema of the desitination
             table to be updated as a side effect of the query job.
         :type schema_update_options: tuple
@@ -606,6 +622,9 @@ def run_query(self,
             else:
                 configuration['query']['queryParameters'] = query_params
 
+        if labels:
+            configuration['labels'] = labels
+
         time_partitioning = _cleanse_time_partitioning(
             destination_dataset_table,
             time_partitioning
@@ -636,7 +655,8 @@ def run_extract(  # noqa
             compression='NONE',
             export_format='CSV',
             field_delimiter=',',
-            print_header=True):
+            print_header=True,
+            labels=None):
         """
         Executes a BigQuery extract command to copy data from BigQuery to
         Google Cloud Storage. See here:
@@ -661,6 +681,9 @@ def run_extract(  # noqa
         :type field_delimiter: string
         :param print_header: Whether to print a header for a CSV file extract.
         :type print_header: boolean
+        :param labels: a dictionary containing labels for the job/query,
+            passed to BigQuery
+        :type labels: dict
         """
 
         source_project, source_dataset, source_table = \
@@ -681,6 +704,9 @@ def run_extract(  # noqa
             }
         }
 
+        if labels:
+            configuration['labels'] = labels
+
         if export_format == 'CSV':
             # Only set fieldDelimiter and printHeader fields if using CSV.
             # Google does not like it if you set these fields for other export
@@ -694,7 +720,8 @@ def run_copy(self,
                  source_project_dataset_tables,
                  destination_project_dataset_table,
                  write_disposition='WRITE_EMPTY',
-                 create_disposition='CREATE_IF_NEEDED'):
+                 create_disposition='CREATE_IF_NEEDED',
+                 labels=None):
         """
         Executes a BigQuery copy command to copy data from one BigQuery table
         to another. See here:
@@ -717,6 +744,9 @@ def run_copy(self,
         :type write_disposition: string
         :param create_disposition: The create disposition if the table doesn't exist.
         :type create_disposition: string
+        :param labels a dictionary containing labels for the job/query,
+            passed to BigQuery
+        :type labels: dict
         """
         source_project_dataset_tables = ([
             source_project_dataset_tables
@@ -754,6 +784,9 @@ def run_copy(self,
             }
         }
 
+        if labels:
+            configuration['labels'] = labels
+
         return self.run_with_configuration(configuration)
 
     def run_load(self,
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index ca2efb55abad9..09f442ae7b1a6 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -81,6 +81,9 @@ class BigQueryOperator(BaseOperator):
     :param query_params: a dictionary containing query parameter types and
         values, passed to BigQuery.
     :type query_params: dict
+    :param labels: a dictionary containing labels for the job/query,
+        passed to BigQuery
+    :type labels: dict
     :param priority: Specifies a priority for the query.
         Possible values include INTERACTIVE and BATCH.
         The default value is INTERACTIVE.
@@ -92,7 +95,7 @@ class BigQueryOperator(BaseOperator):
     :type time_partitioning: dict
     """
 
-    template_fields = ('bql', 'sql', 'destination_dataset_table')
+    template_fields = ('bql', 'sql', 'destination_dataset_table', 'labels')
     template_ext = ('.sql', )
     ui_color = '#e4f0e8'
 
@@ -113,6 +116,7 @@ def __init__(self,
                  create_disposition='CREATE_IF_NEEDED',
                  schema_update_options=(),
                  query_params=None,
+                 labels=None,
                  priority='INTERACTIVE',
                  time_partitioning={},
                  *args,
@@ -133,6 +137,7 @@ def __init__(self,
         self.maximum_bytes_billed = maximum_bytes_billed
         self.schema_update_options = schema_update_options
         self.query_params = query_params
+        self.labels = labels
         self.bq_cursor = None
         self.priority = priority
         self.time_partitioning = time_partitioning
@@ -171,6 +176,7 @@ def execute(self, context):
             maximum_bytes_billed=self.maximum_bytes_billed,
             create_disposition=self.create_disposition,
             query_params=self.query_params,
+            labels=self.labels,
             schema_update_options=self.schema_update_options,
             priority=self.priority,
             time_partitioning=self.time_partitioning
@@ -228,6 +234,8 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
         work, the service account making the request must have domain-wide
         delegation enabled.
     :type delegate_to: string
+    :param labels a dictionary containing labels for the table, passed to BigQuery
+    :type labels: dict
 
     **Example (with schema JSON in GCS)**: ::
 
@@ -270,7 +278,8 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
         )
 
     """
-    template_fields = ('dataset_id', 'table_id', 'project_id', 'gcs_schema_object')
+    template_fields = ('dataset_id', 'table_id', 'project_id',
+                       'gcs_schema_object', 'labels')
     ui_color = '#f0eee4'
 
     @apply_defaults
@@ -284,6 +293,7 @@ def __init__(self,
                  bigquery_conn_id='bigquery_default',
                  google_cloud_storage_conn_id='google_cloud_default',
                  delegate_to=None,
+                 labels=None,
                  *args, **kwargs):
 
         super(BigQueryCreateEmptyTableOperator, self).__init__(*args, **kwargs)
@@ -297,6 +307,7 @@ def __init__(self,
         self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
         self.delegate_to = delegate_to
         self.time_partitioning = time_partitioning
+        self.labels = labels
 
     def execute(self, context):
         bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
@@ -323,7 +334,8 @@ def execute(self, context):
             dataset_id=self.dataset_id,
             table_id=self.table_id,
             schema_fields=schema_fields,
-            time_partitioning=self.time_partitioning
+            time_partitioning=self.time_partitioning,
+            labels=self.labels
         )
 
 
@@ -396,9 +408,11 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :type delegate_to: string
     :param src_fmt_configs: configure optional fields specific to the source format
     :type src_fmt_configs: dict
+    :param labels a dictionary containing labels for the table, passed to BigQuery
+    :type labels: dict
     """
     template_fields = ('bucket', 'source_objects',
-                       'schema_object', 'destination_project_dataset_table')
+                       'schema_object', 'destination_project_dataset_table', 'labels')
     ui_color = '#f0eee4'
 
     @apply_defaults
@@ -420,6 +434,7 @@ def __init__(self,
                  google_cloud_storage_conn_id='google_cloud_default',
                  delegate_to=None,
                  src_fmt_configs={},
+                 labels=None,
                  *args, **kwargs):
 
         super(BigQueryCreateExternalTableOperator, self).__init__(*args, **kwargs)
@@ -446,6 +461,7 @@ def __init__(self,
         self.delegate_to = delegate_to
 
         self.src_fmt_configs = src_fmt_configs
+        self.labels = labels
 
     def execute(self, context):
         bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
@@ -479,7 +495,8 @@ def execute(self, context):
             quote_character=self.quote_character,
             allow_quoted_newlines=self.allow_quoted_newlines,
             allow_jagged_rows=self.allow_jagged_rows,
-            src_fmt_configs=self.src_fmt_configs
+            src_fmt_configs=self.src_fmt_configs,
+            labels=self.labels
         )
 
 
diff --git a/airflow/contrib/operators/bigquery_to_bigquery.py b/airflow/contrib/operators/bigquery_to_bigquery.py
index 93a52b31020ce..3a0b44db60580 100644
--- a/airflow/contrib/operators/bigquery_to_bigquery.py
+++ b/airflow/contrib/operators/bigquery_to_bigquery.py
@@ -49,9 +49,12 @@ class BigQueryToBigQueryOperator(BaseOperator):
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
     :type delegate_to: string
+    :param labels: a dictionary containing labels for the job/query,
+        passed to BigQuery
+    :type labels: dict
     """
     template_fields = ('source_project_dataset_tables',
-                       'destination_project_dataset_table')
+                       'destination_project_dataset_table', 'labels')
     template_ext = ('.sql',)
     ui_color = '#e6f0e4'
 
@@ -63,6 +66,7 @@ def __init__(self,
                  create_disposition='CREATE_IF_NEEDED',
                  bigquery_conn_id='bigquery_default',
                  delegate_to=None,
+                 labels=None,
                  *args,
                  **kwargs):
         super(BigQueryToBigQueryOperator, self).__init__(*args, **kwargs)
@@ -72,6 +76,7 @@ def __init__(self,
         self.create_disposition = create_disposition
         self.bigquery_conn_id = bigquery_conn_id
         self.delegate_to = delegate_to
+        self.labels = labels
 
     def execute(self, context):
         self.log.info(
@@ -86,4 +91,5 @@ def execute(self, context):
             self.source_project_dataset_tables,
             self.destination_project_dataset_table,
             self.write_disposition,
-            self.create_disposition)
+            self.create_disposition,
+            self.labels)
diff --git a/airflow/contrib/operators/bigquery_to_gcs.py b/airflow/contrib/operators/bigquery_to_gcs.py
index e2ce93068f433..278b20804747c 100644
--- a/airflow/contrib/operators/bigquery_to_gcs.py
+++ b/airflow/contrib/operators/bigquery_to_gcs.py
@@ -54,8 +54,12 @@ class BigQueryToCloudStorageOperator(BaseOperator):
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
     :type delegate_to: string
+    :param labels: a dictionary containing labels for the job/query,
+        passed to BigQuery
+    :type labels: dict
     """
-    template_fields = ('source_project_dataset_table', 'destination_cloud_storage_uris')
+    template_fields = ('source_project_dataset_table',
+                       'destination_cloud_storage_uris', 'labels')
     template_ext = ('.sql',)
     ui_color = '#e4e6f0'
 
@@ -69,6 +73,7 @@ def __init__(self,
                  print_header=True,
                  bigquery_conn_id='bigquery_default',
                  delegate_to=None,
+                 labels=None,
                  *args,
                  **kwargs):
         super(BigQueryToCloudStorageOperator, self).__init__(*args, **kwargs)
@@ -80,6 +85,7 @@ def __init__(self,
         self.print_header = print_header
         self.bigquery_conn_id = bigquery_conn_id
         self.delegate_to = delegate_to
+        self.labels = labels
 
     def execute(self, context):
         self.log.info('Executing extract of %s into: %s',
@@ -95,4 +101,5 @@ def execute(self, context):
             self.compression,
             self.export_format,
             self.field_delimiter,
-            self.print_header)
+            self.print_header,
+            self.labels)
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 37ad32d7ec036..2f39bd9bce24a 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -58,7 +58,8 @@ def test_suceeds_with_explicit_legacy_query(self):
 
     @unittest.skipIf(not bq_available, 'BQ is not available to run tests')
     def test_suceeds_with_explicit_std_query(self):
-        df = self.instance.get_pandas_df('select * except(b) from (select 1 a, 2 b)', dialect='standard')
+        df = self.instance.get_pandas_df(
+            'select * except(b) from (select 1 a, 2 b)', dialect='standard')
         self.assertEqual(df.iloc(0)[0][0], 1)
 
     @unittest.skipIf(not bq_available, 'BQ is not available to run tests')
@@ -281,6 +282,27 @@ def test_run_query_sql_dialect_override(self, run_with_config):
             self.assertIs(args[0]['query']['useLegacySql'], bool_val)
 
 
+class TestLabelsInRunJob(unittest.TestCase):
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_query_with_arg(self, mocked_rwc):
+        project_id = 12345
+
+        def run_with_config(config):
+            self.assertEqual(
+                config['labels'], {'label1': 'test1', 'label2': 'test2'}
+            )
+        mocked_rwc.side_effect = run_with_config
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        bq_hook.run_query(
+            sql='select 1',
+            destination_dataset_table='my_dataset.my_table',
+            labels={'label1': 'test1', 'label2': 'test2'}
+        )
+
+        mocked_rwc.assert_called_once()
+
+
 class TestTimePartitioningInRunJob(unittest.TestCase):
 
     @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
@@ -365,7 +387,8 @@ def run_with_config(config):
         bq_hook.run_query(
             sql='select 1',
             destination_dataset_table='my_dataset.my_table',
-            time_partitioning={'type': 'DAY', 'field': 'test_field', 'expirationMs': 1000}
+            time_partitioning={'type': 'DAY',
+                               'field': 'test_field', 'expirationMs': 1000}
         )
 
         mocked_rwc.assert_called_once()
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 21a42d3ef8f46..7c76ab73fec81 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -73,7 +73,8 @@ def test_execute(self, mock_hook):
                 project_id=TEST_PROJECT_ID,
                 table_id=TEST_TABLE_ID,
                 schema_fields=None,
-                time_partitioning={}
+                time_partitioning={},
+                labels=None
             )
 
 
@@ -112,7 +113,8 @@ def test_execute(self, mock_hook):
                 quote_character=None,
                 allow_quoted_newlines=False,
                 allow_jagged_rows=False,
-                src_fmt_configs={}
+                src_fmt_configs={},
+                labels=None
             )
 
 

From bde5bffd497bc1035b52f109dd16198bef86af4c Mon Sep 17 00:00:00 2001
From: Yuliya Volkova <xnuinside@gmail.com>
Date: Mon, 6 Aug 2018 04:23:17 -0500
Subject: [PATCH 063/808] [AIRFLOW-2845] Asserts in contrib package code are
 changed on raise ValueError and TypeError (#3690)

---
 airflow/contrib/hooks/bigquery_hook.py        | 55 ++++++++++---------
 airflow/contrib/hooks/databricks_hook.py      |  3 +-
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 24 ++++----
 airflow/contrib/hooks/gcp_mlengine_hook.py    | 11 +++-
 airflow/contrib/hooks/gcs_hook.py             | 15 ++---
 .../contrib/operators/mlengine_operator.py    |  4 +-
 tests/contrib/hooks/test_bigquery_hook.py     |  2 +-
 tests/contrib/hooks/test_databricks_hook.py   |  6 +-
 tests/contrib/hooks/test_gcp_dataflow_hook.py |  8 +--
 tests/contrib/hooks/test_gcs_hook.py          |  4 +-
 10 files changed, 74 insertions(+), 58 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index f4c1a3b520217..aa8fc382a6a67 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -592,9 +592,11 @@ def run_query(self,
         }
 
         if destination_dataset_table:
-            assert '.' in destination_dataset_table, (
-                'Expected destination_dataset_table in the format of '
-                '<dataset>.<table>. Got: {}').format(destination_dataset_table)
+            if '.' not in destination_dataset_table:
+                raise ValueError(
+                    'Expected destination_dataset_table name in the format of '
+                    '<dataset>.<table>. Got: {}'.format(
+                        destination_dataset_table))
             destination_project, destination_dataset, destination_table = \
                 _split_tablename(table_input=destination_dataset_table,
                                  default_project_id=self.project_id)
@@ -610,7 +612,9 @@ def run_query(self,
                 }
             })
         if udf_config:
-            assert isinstance(udf_config, list)
+            if not isinstance(udf_config, list):
+                raise TypeError("udf_config argument must have a type 'list'"
+                                " not {}".format(type(udf_config)))
             configuration['query'].update({
                 'userDefinedFunctionResources': udf_config
             })
@@ -1153,10 +1157,10 @@ def run_table_delete(self, deletion_dataset_table,
         :type ignore_if_missing: boolean
         :return:
         """
-
-        assert '.' in deletion_dataset_table, (
-            'Expected deletion_dataset_table in the format of '
-            '<dataset>.<table>. Got: {}').format(deletion_dataset_table)
+        if '.' not in deletion_dataset_table:
+            raise ValueError(
+                'Expected deletion_dataset_table name in the format of '
+                '<dataset>.<table>. Got: {}'.format(deletion_dataset_table))
         deletion_project, deletion_dataset, deletion_table = \
             _split_tablename(table_input=deletion_dataset_table,
                              default_project_id=self.project_id)
@@ -1284,14 +1288,10 @@ def run_grant_dataset_view_access(self,
             # if view is already in access, do nothing.
             self.log.info(
                 'Table %s:%s.%s already has authorized view access to %s:%s dataset.',
-                view_project, view_dataset, view_table, source_project,
-                source_dataset)
+                view_project, view_dataset, view_table, source_project, source_dataset)
             return source_dataset_resource
 
-    def delete_dataset(self,
-                       project_id,
-                       dataset_id
-                       ):
+    def delete_dataset(self, project_id, dataset_id):
         """
         Delete a dataset of Big query in your project.
         :param project_id: The name of the project where we have the dataset .
@@ -1308,9 +1308,8 @@ def delete_dataset(self,
             self.service.datasets().delete(
                 projectId=project_id,
                 datasetId=dataset_id).execute()
-
-            self.log.info('Dataset deleted successfully: In project %s Dataset %s',
-                          project_id, dataset_id)
+            self.log.info('Dataset deleted successfully: In project %s '
+                          'Dataset %s', project_id, dataset_id)
 
         except HttpError as err:
             raise AirflowException(
@@ -1518,14 +1517,17 @@ def _bq_cast(string_field, bq_type):
     elif bq_type == 'FLOAT' or bq_type == 'TIMESTAMP':
         return float(string_field)
     elif bq_type == 'BOOLEAN':
-        assert string_field in set(['true', 'false'])
+        if string_field not in ['true', 'false']:
+            raise ValueError("{} must have value 'true' or 'false'".format(
+                string_field))
         return string_field == 'true'
     else:
         return string_field
 
 
 def _split_tablename(table_input, default_project_id, var_name=None):
-    assert default_project_id is not None, "INTERNAL: No default project is specified"
+    if not default_project_id:
+        raise ValueError("INTERNAL: No default project is specified")
 
     def var_print(var_name):
         if var_name is None:
@@ -1537,7 +1539,6 @@ def var_print(var_name):
         raise Exception(('{var}Use either : or . to specify project '
                          'got {input}').format(
                              var=var_print(var_name), input=table_input))
-
     cmpt = table_input.rsplit(':', 1)
     project_id = None
     rest = table_input
@@ -1555,8 +1556,10 @@ def var_print(var_name):
 
     cmpt = rest.split('.')
     if len(cmpt) == 3:
-        assert project_id is None, ("{var}Use either : or . to specify project"
-                                    ).format(var=var_print(var_name))
+        if project_id:
+            raise ValueError(
+                "{var}Use either : or . to specify project".format(
+                    var=var_print(var_name)))
         project_id = cmpt[0]
         dataset_id = cmpt[1]
         table_id = cmpt[2]
@@ -1586,10 +1589,10 @@ def _cleanse_time_partitioning(destination_dataset_table, time_partitioning_in):
     # if it is a partitioned table ($ is in the table name) add partition load option
     time_partitioning_out = {}
     if destination_dataset_table and '$' in destination_dataset_table:
-        assert not time_partitioning_in.get('field'), (
-            "Cannot specify field partition and partition name "
-            "(dataset.table$partition) at the same time"
-        )
+        if time_partitioning_in.get('field'):
+            raise ValueError(
+                "Cannot specify field partition and partition name"
+                "(dataset.table$partition) at the same time")
         time_partitioning_out['type'] = 'DAY'
 
     time_partitioning_out.update(time_partitioning_in)
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index 1443ff4740b94..2e5f1399b4765 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -61,7 +61,8 @@ def __init__(
         self.databricks_conn_id = databricks_conn_id
         self.databricks_conn = self.get_connection(databricks_conn_id)
         self.timeout_seconds = timeout_seconds
-        assert retry_limit >= 1, 'Retry limit must be greater than equal to 1'
+        if retry_limit < 1:
+            raise ValueError('Retry limit must be greater than equal to 1')
         self.retry_limit = retry_limit
 
     def _parse_host(self, host):
diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 279b9dd21a862..ee3b510ed706a 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -225,11 +225,11 @@ def label_formatter(labels_dict):
     def _build_dataflow_job_name(task_id, append_job_name=True):
         task_id = str(task_id).replace('_', '-')
 
-        assert re.match(r"^[a-z]([-a-z0-9]*[a-z0-9])?$", task_id), \
-            'Invalid job_name ({}); the name must consist of ' \
-            'only the characters [-a-z0-9], starting with a ' \
-            'letter and ending with a letter or number '.format(
-                task_id)
+        if not re.match(r"^[a-z]([-a-z0-9]*[a-z0-9])?$", task_id):
+            raise ValueError(
+                'Invalid job_name ({}); the name must consist of'
+                'only the characters [-a-z0-9], starting with a '
+                'letter and ending with a letter or number '.format(task_id))
 
         if append_job_name:
             job_name = task_id + "-" + str(uuid.uuid1())[:8]
@@ -238,7 +238,8 @@ def _build_dataflow_job_name(task_id, append_job_name=True):
 
         return job_name
 
-    def _build_cmd(self, task_id, variables, label_formatter):
+    @staticmethod
+    def _build_cmd(task_id, variables, label_formatter):
         command = ["--runner=DataflowRunner"]
         if variables is not None:
             for attr, value in variables.items():
@@ -250,7 +251,8 @@ def _build_cmd(self, task_id, variables, label_formatter):
                     command.append("--" + attr + "=" + value)
         return command
 
-    def _start_template_dataflow(self, name, variables, parameters, dataflow_template):
+    def _start_template_dataflow(self, name, variables, parameters,
+                                 dataflow_template):
         # Builds RuntimeEnvironment from variables dictionary
         # https://cloud.google.com/dataflow/docs/reference/rest/v1b3/RuntimeEnvironment
         environment = {}
@@ -262,9 +264,11 @@ def _start_template_dataflow(self, name, variables, parameters, dataflow_templat
                 "parameters": parameters,
                 "environment": environment}
         service = self.get_conn()
-        request = service.projects().templates().launch(projectId=variables['project'],
-                                                        gcsPath=dataflow_template,
-                                                        body=body)
+        request = service.projects().templates().launch(
+            projectId=variables['project'],
+            gcsPath=dataflow_template,
+            body=body
+        )
         response = request.execute()
         variables = self._set_variables(variables)
         _DataflowJob(self.get_conn(), variables['project'], name, variables['region'],
diff --git a/airflow/contrib/hooks/gcp_mlengine_hook.py b/airflow/contrib/hooks/gcp_mlengine_hook.py
index 66f392b1564c9..b9f1008fa7fde 100644
--- a/airflow/contrib/hooks/gcp_mlengine_hook.py
+++ b/airflow/contrib/hooks/gcp_mlengine_hook.py
@@ -152,7 +152,8 @@ def _wait_for_job_done(self, project_id, job_id, interval=30):
             apiclient.errors.HttpError: if HTTP error is returned when getting
             the job
         """
-        assert interval > 0
+        if interval <= 0:
+            raise ValueError("Interval must be > 0")
         while True:
             job = self._get_job(project_id, job_id)
             if job['state'] in ['SUCCEEDED', 'FAILED', 'CANCELLED']:
@@ -242,7 +243,9 @@ def create_model(self, project_id, model):
         """
         Create a Model. Blocks until finished.
         """
-        assert model['name'] is not None and model['name'] is not ''
+        if not model['name']:
+            raise ValueError("Model name must be provided and "
+                             "could not be an empty string")
         project = 'projects/{}'.format(project_id)
 
         request = self._mlengine.projects().models().create(
@@ -253,7 +256,9 @@ def get_model(self, project_id, model_name):
         """
         Gets a Model. Blocks until finished.
         """
-        assert model_name is not None and model_name is not ''
+        if not model_name:
+            raise ValueError("Model name must be provided and "
+                             "it could not be an empty string")
         full_model_name = 'projects/{}/models/{}'.format(
             project_id, model_name)
         request = self._mlengine.projects().models().get(name=full_model_name)
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index c5e356f41cfc0..08d44ce7faf92 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -477,15 +477,16 @@ def create_bucket(self,
 
         self.log.info('Creating Bucket: %s; Location: %s; Storage Class: %s',
                       bucket_name, location, storage_class)
-        assert storage_class in storage_classes, \
-            'Invalid value ({}) passed to storage_class. Value should be ' \
-            'one of {}'.format(storage_class, storage_classes)
+        if storage_class not in storage_classes:
+            raise ValueError(
+                'Invalid value ({}) passed to storage_class. Value should be '
+                'one of {}'.format(storage_class, storage_classes))
 
-        assert re.match('[a-zA-Z0-9]+', bucket_name[0]), \
-            'Bucket names must start with a number or letter.'
+        if not re.match('[a-zA-Z0-9]+', bucket_name[0]):
+            raise ValueError('Bucket names must start with a number or letter.')
 
-        assert re.match('[a-zA-Z0-9]+', bucket_name[-1]), \
-            'Bucket names must end with a number or letter.'
+        if not re.match('[a-zA-Z0-9]+', bucket_name[-1]):
+            raise ValueError('Bucket names must end with a number or letter.')
 
         service = self.get_conn()
         bucket_resource = {
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 9fe966d387ab1..8e75b3c608238 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -427,7 +427,9 @@ def execute(self, context):
             gcp_conn_id=self._gcp_conn_id, delegate_to=self._delegate_to)
 
         if self._operation == 'create':
-            assert self._version is not None
+            if not self._version:
+                raise ValueError("version attribute of {} could not "
+                                 "be empty".format(self.__class__.__name__))
             return hook.create_version(self._project_id, self._model_name,
                                        self._version)
         elif self._operation == 'set_default':
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 2f39bd9bce24a..39435f0c4ec63 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -414,7 +414,7 @@ def test_extra_time_partitioning_options(self):
         self.assertEqual(tp_out, expect)
 
     def test_cant_add_dollar_and_field_name(self):
-        with self.assertRaises(AssertionError):
+        with self.assertRaises(ValueError):
             _cleanse_time_partitioning(
                 'test.teast$20170101',
                 {'type': 'DAY', 'field': 'test_field', 'expirationMs': 1000}
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 6052a6d54f1f8..aca8dd96004b4 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -110,7 +110,7 @@ def test_parse_host_with_scheme(self):
         self.assertEquals(host, HOST)
 
     def test_init_bad_retry_limit(self):
-        with self.assertRaises(AssertionError):
+        with self.assertRaises(ValueError):
             DatabricksHook(retry_limit = 0)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 90714c6ee4f62..bc7c587135b9b 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -195,7 +195,7 @@ def test_invalid_dataflow_job_name(self):
         fixed_name = invalid_job_name.replace(
             '_', '-')
 
-        with self.assertRaises(AssertionError) as e:
+        with self.assertRaises(ValueError) as e:
             self.dataflow_hook._build_dataflow_job_name(
                 task_id=invalid_job_name, append_job_name=False
             )
@@ -222,19 +222,19 @@ def test_dataflow_job_regex_check(self):
         ), 'dfjob1')
 
         self.assertRaises(
-            AssertionError,
+            ValueError,
             self.dataflow_hook._build_dataflow_job_name,
             task_id='1dfjob', append_job_name=False
         )
 
         self.assertRaises(
-            AssertionError,
+            ValueError,
             self.dataflow_hook._build_dataflow_job_name,
             task_id='dfjob@', append_job_name=False
         )
 
         self.assertRaises(
-            AssertionError,
+            ValueError,
             self.dataflow_hook._build_dataflow_job_name,
             task_id='df^jo', append_job_name=False
         )
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index fb65938fd9afe..eedceff1f7790 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -66,14 +66,14 @@ class TestGCSBucket(unittest.TestCase):
     def test_bucket_name_value(self):
 
         bad_start_bucket_name = '/testing123'
-        with self.assertRaises(AssertionError):
+        with self.assertRaises(ValueError):
 
             gcs_hook.GoogleCloudStorageHook().create_bucket(
                 bucket_name=bad_start_bucket_name
             )
 
         bad_end_bucket_name = 'testing123/'
-        with self.assertRaises(AssertionError):
+        with self.assertRaises(ValueError):
             gcs_hook.GoogleCloudStorageHook().create_bucket(
                 bucket_name=bad_end_bucket_name
             )

From e7f73d20462964bf104c7508d3f3d669e7797e49 Mon Sep 17 00:00:00 2001
From: Chris Riccomini <criccomini@users.noreply.github.com>
Date: Fri, 31 Aug 2018 12:42:43 -0700
Subject: [PATCH 064/808] [AIRFLOW-2994] Fix flatten_results for
 BigQueryOperator (#3829)

---
 airflow/contrib/hooks/bigquery_hook.py         | 2 +-
 airflow/contrib/operators/bigquery_operator.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index aa8fc382a6a67..6db0c00bdd9d2 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -472,7 +472,7 @@ def run_query(self,
                   destination_dataset_table=False,
                   write_disposition='WRITE_EMPTY',
                   allow_large_results=False,
-                  flatten_results=False,
+                  flatten_results=None,
                   udf_config=False,
                   use_legacy_sql=None,
                   maximum_billing_tier=None,
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 09f442ae7b1a6..9ec1f992c11d8 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -106,7 +106,7 @@ def __init__(self,
                  destination_dataset_table=False,
                  write_disposition='WRITE_EMPTY',
                  allow_large_results=False,
-                 flatten_results=False,
+                 flatten_results=None,
                  bigquery_conn_id='bigquery_default',
                  delegate_to=None,
                  udf_config=False,

From 7603042361d3aef18bf774c34d0fabed4279d0c0 Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Fri, 14 Sep 2018 12:53:52 +0300
Subject: [PATCH 065/808] [AIRFLOW-2772] Fix Bug in BigQuery hook for
 Partitioned Table  (#3901)

---
 airflow/contrib/hooks/bigquery_hook.py         | 13 ++-----------
 airflow/contrib/operators/bigquery_operator.py |  4 +---
 tests/contrib/hooks/test_bigquery_hook.py      |  7 -------
 3 files changed, 3 insertions(+), 21 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 6db0c00bdd9d2..f9abdbaaacdab 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -540,9 +540,7 @@ def run_query(self,
             The default value is INTERACTIVE.
         :type priority: string
         :param time_partitioning: configure optional time partitioning fields i.e.
-            partition by field, type and
-            expiration as per API specifications. Note that 'field' is not available in
-            conjunction with dataset.table$partition.
+            partition by field, type and expiration as per API specifications.
         :type time_partitioning: dict
 
         """
@@ -869,9 +867,7 @@ def run_load(self,
         :param src_fmt_configs: configure optional fields specific to the source format
         :type src_fmt_configs: dict
         :param time_partitioning: configure optional time partitioning fields i.e.
-            partition by field, type and
-            expiration as per API specifications. Note that 'field' is not available in
-            conjunction with dataset.table$partition.
+            partition by field, type and  expiration as per API specifications.
         :type time_partitioning: dict
         """
 
@@ -1589,11 +1585,6 @@ def _cleanse_time_partitioning(destination_dataset_table, time_partitioning_in):
     # if it is a partitioned table ($ is in the table name) add partition load option
     time_partitioning_out = {}
     if destination_dataset_table and '$' in destination_dataset_table:
-        if time_partitioning_in.get('field'):
-            raise ValueError(
-                "Cannot specify field partition and partition name"
-                "(dataset.table$partition) at the same time")
         time_partitioning_out['type'] = 'DAY'
-
     time_partitioning_out.update(time_partitioning_in)
     return time_partitioning_out
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 9ec1f992c11d8..2eadd04f003d9 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -89,9 +89,7 @@ class BigQueryOperator(BaseOperator):
         The default value is INTERACTIVE.
     :type priority: string
     :param time_partitioning: configure optional time partitioning fields i.e.
-        partition by field, type and
-        expiration as per API specifications. Note that 'field' is not available in
-        conjunction with dataset.table$partition.
+        partition by field, type and expiration as per API specifications.
     :type time_partitioning: dict
     """
 
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 39435f0c4ec63..74e3af452bf6f 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -413,13 +413,6 @@ def test_extra_time_partitioning_options(self):
         }
         self.assertEqual(tp_out, expect)
 
-    def test_cant_add_dollar_and_field_name(self):
-        with self.assertRaises(ValueError):
-            _cleanse_time_partitioning(
-                'test.teast$20170101',
-                {'type': 'DAY', 'field': 'test_field', 'expirationMs': 1000}
-            )
-
 
 class TestBigQueryHookLegacySql(unittest.TestCase):
     """Ensure `use_legacy_sql` param in `BigQueryHook` propagates properly."""

From 06e09689ff6179f3597fe99983d8cde8a8e816c7 Mon Sep 17 00:00:00 2001
From: fenglu-g <fenglu@google.com>
Date: Wed, 15 Aug 2018 01:42:57 -0700
Subject: [PATCH 066/808] [AIRFLOW-2893] fix stuck dataflow job due to name
 mismatch (#3744)

---
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 52 ++++++++----
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 83 ++++++++++++++-----
 2 files changed, 97 insertions(+), 38 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index ee3b510ed706a..3a8eb28cee77b 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -34,12 +34,13 @@
 
 
 class _DataflowJob(LoggingMixin):
-    def __init__(self, dataflow, project_number, name, location, poll_sleep=10):
+    def __init__(self, dataflow, project_number, name, location, poll_sleep=10,
+                 job_id=None):
         self._dataflow = dataflow
         self._project_number = project_number
         self._job_name = name
         self._job_location = location
-        self._job_id = None
+        self._job_id = job_id
         self._job = self._get_job()
         self._poll_sleep = poll_sleep
 
@@ -55,13 +56,15 @@ def _get_job_id_from_name(self):
         return None
 
     def _get_job(self):
-        if self._job_name:
-            job = self._get_job_id_from_name()
-        else:
+        if self._job_id:
             job = self._dataflow.projects().jobs().get(
                 projectId=self._project_number,
                 jobId=self._job_id
             ).execute(num_retries=5)
+        elif self._job_name:
+            job = self._get_job_id_from_name()
+        else:
+            raise Exception('Missing both dataflow job ID and name.')
 
         if job and 'currentState' in job:
             self.log.info(
@@ -124,36 +127,50 @@ def __init__(self, cmd):
 
     def _line(self, fd):
         if fd == self._proc.stderr.fileno():
-            lines = self._proc.stderr.readlines()
-            for line in lines:
+            line = b''.join(self._proc.stderr.readlines())
+            if line:
                 self.log.warning(line[:-1])
-            if lines:
-                return lines[-1]
+            return line
         if fd == self._proc.stdout.fileno():
-            line = self._proc.stdout.readline()
+            line = b''.join(self._proc.stdout.readlines())
+            if line:
+                self.log.info(line[:-1])
             return line
 
     @staticmethod
     def _extract_job(line):
-        if line is not None:
-            if line.startswith("Submitted job: "):
-                return line[15:-1]
+        # Job id info: https://goo.gl/SE29y9.
+        job_id_pattern = re.compile(
+            b'.*console.cloud.google.com/dataflow.*/jobs/([a-z|0-9|A-Z|\-|\_]+).*')
+        matched_job = job_id_pattern.search(line or '')
+        if matched_job:
+            return matched_job.group(1).decode()
 
     def wait_for_done(self):
         reads = [self._proc.stderr.fileno(), self._proc.stdout.fileno()]
         self.log.info("Start waiting for DataFlow process to complete.")
-        while self._proc.poll() is None:
+        job_id = None
+        # Make sure logs are processed regardless whether the subprocess is
+        # terminated.
+        process_ends = False
+        while True:
             ret = select.select(reads, [], [], 5)
             if ret is not None:
                 for fd in ret[0]:
                     line = self._line(fd)
                     if line:
-                        self.log.debug(line[:-1])
+                        job_id = job_id or self._extract_job(line)
             else:
                 self.log.info("Waiting for DataFlow process to complete.")
+            if process_ends:
+                break
+            if self._proc.poll() is not None:
+                # Mark process completion but allows its outputs to be consumed.
+                process_ends = True
         if self._proc.returncode is not 0:
             raise Exception("DataFlow failed with return code {}".format(
                 self._proc.returncode))
+        return job_id
 
 
 class DataFlowHook(GoogleCloudBaseHook):
@@ -178,9 +195,10 @@ def _start_dataflow(self, task_id, variables, name,
         variables = self._set_variables(variables)
         cmd = command_prefix + self._build_cmd(task_id, variables,
                                                label_formatter)
-        _Dataflow(cmd).wait_for_done()
+        job_id = _Dataflow(cmd).wait_for_done()
         _DataflowJob(self.get_conn(), variables['project'], name,
-                     variables['region'], self.poll_sleep).wait_for_done()
+                     variables['region'],
+                     self.poll_sleep, job_id).wait_for_done()
 
     @staticmethod
     def _set_variables(variables):
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index bc7c587135b9b..686db10e5c305 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -22,8 +22,8 @@
 from mock import call
 from mock import MagicMock
 
-from airflow.contrib.hooks.gcp_dataflow_hook import DataFlowHook
-from airflow.contrib.hooks.gcp_dataflow_hook import _Dataflow
+from airflow.contrib.hooks.gcp_dataflow_hook import DataFlowHook,\
+    _Dataflow, _DataflowJob
 
 try:
     from unittest import mock
@@ -62,6 +62,10 @@
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
 DATAFLOW_STRING = 'airflow.contrib.hooks.gcp_dataflow_hook.{}'
 MOCK_UUID = '12345678'
+TEST_PROJECT = 'test-project'
+TEST_JOB_NAME = 'test-job-name'
+TEST_JOB_ID = 'test-job-id'
+TEST_LOCATION = 'us-central1'
 
 
 def mock_init(self, gcp_conn_id, delegate_to=None):
@@ -152,25 +156,25 @@ def test_start_java_dataflow_with_job_class(
     @mock.patch('subprocess.Popen')
     @mock.patch('select.select')
     def test_dataflow_wait_for_done_logging(self, mock_select, mock_popen, mock_logging):
-      mock_logging.info = MagicMock()
-      mock_logging.warning = MagicMock()
-      mock_proc = MagicMock()
-      mock_proc.stderr = MagicMock()
-      mock_proc.stderr.readlines = MagicMock(return_value=['test\n','error\n'])
-      mock_stderr_fd = MagicMock()
-      mock_proc.stderr.fileno = MagicMock(return_value=mock_stderr_fd)
-      mock_proc_poll = MagicMock()
-      mock_select.return_value = [[mock_stderr_fd]]
-      def poll_resp_error():
-        mock_proc.return_code = 1
-        return True
-      mock_proc_poll.side_effect=[None, poll_resp_error]
-      mock_proc.poll = mock_proc_poll
-      mock_popen.return_value = mock_proc
-      dataflow = _Dataflow(['test', 'cmd'])
-      mock_logging.info.assert_called_with('Running command: %s', 'test cmd')
-      self.assertRaises(Exception, dataflow.wait_for_done)
-      mock_logging.warning.assert_has_calls([call('test'), call('error')])
+        mock_logging.info = MagicMock()
+        mock_logging.warning = MagicMock()
+        mock_proc = MagicMock()
+        mock_proc.stderr = MagicMock()
+        mock_proc.stderr.readlines = MagicMock(return_value=['test\n', 'error\n'])
+        mock_stderr_fd = MagicMock()
+        mock_proc.stderr.fileno = MagicMock(return_value=mock_stderr_fd)
+        mock_proc_poll = MagicMock()
+        mock_select.return_value = [[mock_stderr_fd]]
+
+        def poll_resp_error():
+            mock_proc.return_code = 1
+            return True
+        mock_proc_poll.side_effect = [None, poll_resp_error]
+        mock_proc.poll = mock_proc_poll
+        mock_popen.return_value = mock_proc
+        dataflow = _Dataflow(['test', 'cmd'])
+        mock_logging.info.assert_called_with('Running command: %s', 'test cmd')
+        self.assertRaises(Exception, dataflow.wait_for_done)
 
     def test_valid_dataflow_job_name(self):
         job_name = self.dataflow_hook._build_dataflow_job_name(
@@ -254,3 +258,40 @@ def test_start_template_dataflow(self, internal_dataflow_mock):
             dataflow_template=TEMPLATE)
         internal_dataflow_mock.assert_called_once_with(
             mock.ANY, DATAFLOW_OPTIONS_TEMPLATE, PARAMETERS, TEMPLATE)
+
+
+class DataFlowJobTest(unittest.TestCase):
+
+    def setUp(self):
+        self.mock_dataflow = MagicMock()
+
+    def test_dataflow_job_init_with_job_id(self):
+        mock_jobs = MagicMock()
+        self.mock_dataflow.projects.return_value.\
+            jobs.return_value = mock_jobs
+        _DataflowJob(self.mock_dataflow, TEST_PROJECT, TEST_JOB_NAME,
+                     TEST_LOCATION, 10, TEST_JOB_ID)
+        mock_jobs.get.assert_called_with(projectId=TEST_PROJECT, jobId=TEST_JOB_ID)
+
+    def test_dataflow_job_init_without_job_id(self):
+        mock_jobs = MagicMock()
+        self.mock_dataflow.projects.return_value.locations.return_value.\
+            jobs.return_value = mock_jobs
+        _DataflowJob(self.mock_dataflow, TEST_PROJECT, TEST_JOB_NAME,
+                     TEST_LOCATION, 10)
+        mock_jobs.list.assert_called_with(projectId=TEST_PROJECT,
+                                          location=TEST_LOCATION)
+
+
+class DataflowTest(unittest.TestCase):
+
+    def test_data_flow_valid_job_id(self):
+        cmd = ['echo', 'additional unit test lines.\n' +
+               'INFO: the Dataflow monitoring console, please navigate to' +
+               'https://console.cloud.google.com/dataflow/jobsDetail/locations/' +
+               '{}/jobs/{}?project={}'.format(TEST_LOCATION, TEST_JOB_ID, TEST_PROJECT)]
+        self.assertEqual(_Dataflow(cmd).wait_for_done(), TEST_JOB_ID)
+
+    def test_data_flow_missing_job_id(self):
+        cmd = ['echo', 'unit testing']
+        self.assertEqual(_Dataflow(cmd).wait_for_done(), None)

From c9767f893ca0839259d4bb0197dc2788d42caaa0 Mon Sep 17 00:00:00 2001
From: fenglu-g <fenglu@google.com>
Date: Mon, 20 Aug 2018 16:55:44 -0700
Subject: [PATCH 067/808] [AIRFLOW-2905] Fix get job API endpoint (#3755)

---
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 6 +++---
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 5 +++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 3a8eb28cee77b..8c9b7423e0e6d 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -57,10 +57,10 @@ def _get_job_id_from_name(self):
 
     def _get_job(self):
         if self._job_id:
-            job = self._dataflow.projects().jobs().get(
+            job = self._dataflow.projects().locations().jobs().get(
                 projectId=self._project_number,
-                jobId=self._job_id
-            ).execute(num_retries=5)
+                location=self._job_location,
+                jobId=self._job_id).execute(num_retries=5)
         elif self._job_name:
             job = self._get_job_id_from_name()
         else:
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 686db10e5c305..7811e4aabd59f 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -267,11 +267,12 @@ def setUp(self):
 
     def test_dataflow_job_init_with_job_id(self):
         mock_jobs = MagicMock()
-        self.mock_dataflow.projects.return_value.\
+        self.mock_dataflow.projects.return_value.locations.return_value.\
             jobs.return_value = mock_jobs
         _DataflowJob(self.mock_dataflow, TEST_PROJECT, TEST_JOB_NAME,
                      TEST_LOCATION, 10, TEST_JOB_ID)
-        mock_jobs.get.assert_called_with(projectId=TEST_PROJECT, jobId=TEST_JOB_ID)
+        mock_jobs.get.assert_called_with(projectId=TEST_PROJECT, location=TEST_LOCATION,
+                                         jobId=TEST_JOB_ID)
 
     def test_dataflow_job_init_without_job_id(self):
         mock_jobs = MagicMock()

From bcd1b42c2dfe602e1ff25af0aca5778a324fcddf Mon Sep 17 00:00:00 2001
From: Leo Gallucci <elgalu3@gmail.com>
Date: Mon, 20 Aug 2018 11:41:27 +0200
Subject: [PATCH 068/808] [AIRFLOW-2907] Fix Sendgrid attachments bytes err
 (#3757)

[AIRFLOW-2907] Fix Sendgrid Attachments

Object of type 'bytes' is not JSON serializable
Attempting to attach files via Sendgrid operator always gives:
    Sendgrid - Attachments - ERROR - Object of type 'bytes' is not JSON serializable
---
 airflow/contrib/utils/sendgrid.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/utils/sendgrid.py b/airflow/contrib/utils/sendgrid.py
index 9055c97879e17..d628097159904 100644
--- a/airflow/contrib/utils/sendgrid.py
+++ b/airflow/contrib/utils/sendgrid.py
@@ -88,7 +88,7 @@ def send_email(to, subject, html_content, files=None,
         basename = os.path.basename(fname)
         attachment = Attachment()
         with open(fname, "rb") as f:
-            attachment.content = base64.b64encode(f.read())
+            attachment.content = str(base64.b64encode(f.read()), 'utf-8')
             attachment.type = mimetypes.guess_type(basename)[0]
             attachment.filename = basename
             attachment.disposition = "attachment"

From ff454a7b1648a519fa8108f83c634281f0aceb2a Mon Sep 17 00:00:00 2001
From: "Taylor D. Edmiston" <tedmiston@gmail.com>
Date: Tue, 21 Aug 2018 18:01:25 -0400
Subject: [PATCH 069/808] [AIRFLOW-XXX] Fix some operator names in the docs
 (#3778)

---
 docs/concepts.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/concepts.rst b/docs/concepts.rst
index 9b10224a817d8..fcaaf99214ae0 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -113,13 +113,12 @@ Airflow provides operators for many common tasks, including:
 - ``BashOperator`` - executes a bash command
 - ``PythonOperator`` - calls an arbitrary Python function
 - ``EmailOperator`` - sends an email
-- ``HTTPOperator`` - sends an HTTP request
+- ``SimpleHttpOperator`` - sends an HTTP request
 - ``MySqlOperator``, ``SqliteOperator``, ``PostgresOperator``, ``MsSqlOperator``, ``OracleOperator``, ``JdbcOperator``, etc. - executes a SQL command
 - ``Sensor`` - waits for a certain time, file, database row, S3 key, etc...
 
-
 In addition to these basic building blocks, there are many more specific
-operators: ``DockerOperator``, ``HiveOperator``, ``S3FileTransferOperator``,
+operators: ``DockerOperator``, ``HiveOperator``, ``S3FileTransformOperator``,
 ``PrestoToMysqlOperator``, ``SlackOperator``... you get the idea!
 
 The ``airflow/contrib/`` directory contains yet more operators built by the

From cdf29af564ce99b5a3ab4680196da857dfd3380c Mon Sep 17 00:00:00 2001
From: PointyShinyBurning <PointyShinyBurning@gmail.com>
Date: Thu, 23 Aug 2018 13:05:36 +0100
Subject: [PATCH 070/808] [AIRFLOW-XXX] Replaces incorrect env var name in
 INSTALL (#3788)

INSTALL mis-named AIRFLOW_GPL_UNIDECODE environment variable.
---
 INSTALL | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/INSTALL b/INSTALL
index 596ce25814088..b018839ab1a5c 100644
--- a/INSTALL
+++ b/INSTALL
@@ -20,7 +20,7 @@ source my_env/bin/activate
 # To make sure not to install the GPL dependency:
 #   export SLUGIFY_USES_TEXT_UNIDECODE=yes
 # In case you do not mind:
-#   export GPL_UNIDECODE=yes
+#   export AIRFLOW_GPL_UNIDECODE=yes
 
 # [required] building and installing
 # by pip (preferred)

From 1357641ea1c150f063f29ba166c5ca474975310a Mon Sep 17 00:00:00 2001
From: William Pursell <william.r.pursell@gmail.com>
Date: Thu, 23 Aug 2018 15:44:09 -0700
Subject: [PATCH 071/808] [AIRFLOW-2938] Handle improperly formatted extra
 field in connection gracefully (#3785)

---
 airflow/hooks/http_hook.py | 6 +++++-
 airflow/www_rbac/views.py  | 5 +++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/airflow/hooks/http_hook.py b/airflow/hooks/http_hook.py
index c449fe0c15ffb..caa89d3142e9b 100644
--- a/airflow/hooks/http_hook.py
+++ b/airflow/hooks/http_hook.py
@@ -70,7 +70,11 @@ def get_conn(self, headers=None):
         if conn.login:
             session.auth = (conn.login, conn.password)
         if conn.extra:
-            session.headers.update(conn.extra_dejson)
+            try:
+                session.headers.update(conn.extra_dejson)
+            except TypeError:
+                self.log.warn('Connection to {} has invalid extra field.'.format(
+                    conn.host))
         if headers:
             session.headers.update(headers)
 
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 34bdbc6ecb09a..d42cc6fbab33e 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1725,6 +1725,11 @@ def prefill_form(self, form, pk):
         except Exception:
             d = {}
 
+        if not hasattr(d, 'get'):
+            logging.warning('extra field for {} is not iterable'.format(
+                form.data.get('conn_id', '<unknown>')))
+            return
+
         for field in self.extra_fields:
             value = d.get(field, '')
             if value:

From ebf2260472c67edb8c4b95b0fbc21e3351fd365b Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 10 Sep 2018 10:19:22 +0100
Subject: [PATCH 072/808] [AIRFLOW-3030] Fix CLI docs (#3872)

---
 airflow/bin/cli.py | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index a84ede16fcb5f..5a45a4595dd67 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -80,6 +80,11 @@
 
 log = LoggingMixin().log
 
+DAGS_FOLDER = settings.DAGS_FOLDER
+
+if "BUILDING_AIRFLOW_DOCS" in os.environ:
+    DAGS_FOLDER = '[AIRFLOW_HOME]/dags'
+
 
 def sigint_handler(sig, frame):
     sys.exit(0)
@@ -133,7 +138,7 @@ def setup_locations(process, pid=None, stdout=None, stderr=None, log=None):
 
 def process_subdir(subdir):
     if subdir:
-        subdir = subdir.replace('DAGS_FOLDER', settings.DAGS_FOLDER)
+        subdir = subdir.replace('DAGS_FOLDER', DAGS_FOLDER)
         subdir = os.path.abspath(os.path.expanduser(subdir))
         return subdir
 
@@ -1310,8 +1315,10 @@ class CLIFactory(object):
             "The regex to filter specific task_ids to backfill (optional)"),
         'subdir': Arg(
             ("-sd", "--subdir"),
-            "File location or directory from which to look for the dag",
-            default=settings.DAGS_FOLDER),
+            "File location or directory from which to look for the dag. "
+            "Defaults to '[AIRFLOW_HOME]/dags' where [AIRFLOW_HOME] is the "
+            "value you set for 'AIRFLOW_HOME' config you set in 'airflow.cfg' ",
+            default=DAGS_FOLDER),
         'start_date': Arg(
             ("-s", "--start_date"), "Override start_date YYYY-MM-DD",
             type=parsedate),
@@ -1711,7 +1718,7 @@ class CLIFactory(object):
                     "If reset_dag_run option is used,"
                     " backfill will first prompt users whether airflow "
                     "should clear all the previous dag_run and task_instances "
-                    "within the backfill date range."
+                    "within the backfill date range. "
                     "If rerun_failed_tasks is used, backfill "
                     "will auto re-run the previous failed task instances"
                     " within the backfill date range.",

From 98fd9b545d8fa0854843f6fce75de13d769f3fbd Mon Sep 17 00:00:00 2001
From: Juhwi Lee <sohappyhwi@gmail.com>
Date: Tue, 24 Jul 2018 11:24:31 +0200
Subject: [PATCH 073/808] [AIRFLOW-2792] change parameter in post requests.

Closes #3633 from happyjulie/AIRFLOW-2792
---
 airflow/hooks/druid_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index 50cee8a2259b1..e5fb6a7a26d91 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -64,7 +64,7 @@ def get_conn_url(self):
     def submit_indexing_job(self, json_index_spec):
         url = self.get_conn_url()
 
-        req_index = requests.post(url, data=json_index_spec, headers=self.header)
+        req_index = requests.post(url, json=json_index_spec, headers=self.header)
         if (req_index.status_code != 200):
             raise AirflowException('Did not get 200 when '
                                    'submitting the Druid job to {}'.format(url))

From 96a6c296c1c65ed4a42723522a9fe065045d4536 Mon Sep 17 00:00:00 2001
From: awelsh93 <32643586+awelsh93@users.noreply.github.com>
Date: Tue, 7 Aug 2018 15:43:54 +0100
Subject: [PATCH 074/808] [AIRFLOW-2860] Raise ValueError if timeout < 1 in
 druid hook

---
 airflow/hooks/druid_hook.py    | 6 +++++-
 tests/hooks/test_druid_hook.py | 4 ++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index e5fb6a7a26d91..fbd74e8e47d39 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -37,7 +37,8 @@ class DruidHook(BaseHook):
                                  which accepts index jobs
     :type druid_ingest_conn_id: string
     :param timeout: The interval between polling
-                    the Druid job for the status of the ingestion job
+                    the Druid job for the status of the ingestion job.
+                    Must be greater than or equal to 1
     :type timeout: int
     :param max_ingestion_time: The maximum ingestion time before assuming the job failed
     :type max_ingestion_time: int
@@ -53,6 +54,9 @@ def __init__(
         self.max_ingestion_time = max_ingestion_time
         self.header = {'content-type': 'application/json'}
 
+        if self.timeout < 1:
+            raise ValueError("Druid timeout should be equal or greater than 1")
+
     def get_conn_url(self):
         conn = self.get_connection(self.druid_ingest_conn_id)
         host = conn.host
diff --git a/tests/hooks/test_druid_hook.py b/tests/hooks/test_druid_hook.py
index 6fd7b3cc76552..4243343b88227 100644
--- a/tests/hooks/test_druid_hook.py
+++ b/tests/hooks/test_druid_hook.py
@@ -98,7 +98,7 @@ def test_submit_unknown_response(self, m):
 
     @requests_mock.mock()
     def test_submit_timeout(self, m):
-        self.db_hook.timeout = 0
+        self.db_hook.timeout = 1
         self.db_hook.max_ingestion_time = 5
         task_post = m.post(
             'http://druid-overlord:8081/druid/indexer/v1/task',
@@ -131,7 +131,7 @@ def test_get_conn_url(self, mock_get_connection):
         get_conn_value.port = '1'
         get_conn_value.extra_dejson = {'endpoint': 'ingest'}
         mock_get_connection.return_value = get_conn_value
-        hook = DruidHook(timeout=0, max_ingestion_time=5)
+        hook = DruidHook(timeout=1, max_ingestion_time=5)
         self.assertEquals(hook.get_conn_url(), 'https://test_host:1/ingest')
 
 

From d47c15cfd2c1ed393dfd9d5d35b29f3794831d33 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 15 Sep 2018 18:54:26 +0100
Subject: [PATCH 075/808] [AIRFLOW-2707] Validate task_log_reader on upgrade
 from <=1.9 (#3881)

We changed the default logging config and config from 1.9 to 1.10, but
anyone who upgrades and has an existing airflow.cfg won't know they need
to change this value - instead they will get nothing displayed in the UI
(ajax request fails) and see "'NoneType' object has no attribute 'read'"
in the error log.

This validates that config section at start up, and seamlessly upgrades
the old previous value.
---
 airflow/logging_config.py    | 33 +++++++++++++++++++++++++++++
 tests/test_logging_config.py | 41 ++++++++++++++++++++++++++++++------
 2 files changed, 68 insertions(+), 6 deletions(-)

diff --git a/airflow/logging_config.py b/airflow/logging_config.py
index 33c2dc82e1be5..84850b4f8244b 100644
--- a/airflow/logging_config.py
+++ b/airflow/logging_config.py
@@ -18,6 +18,7 @@
 # under the License.
 #
 import logging
+import warnings
 from logging.config import dictConfig
 
 from airflow import configuration as conf
@@ -70,4 +71,36 @@ def configure_logging():
         # otherwise Airflow would silently fall back on the default config
         raise e
 
+    validate_logging_config(logging_config)
+
     return logging_config
+
+
+def validate_logging_config(logging_config):
+    # Now lets validate the other logging-related settings
+    task_log_reader = conf.get('core', 'task_log_reader')
+
+    logger = logging.getLogger('airflow.task')
+
+    def _get_handler(name):
+        return next((h for h in logger.handlers if h.name == name), None)
+
+    if _get_handler(task_log_reader) is None:
+        # Check for pre 1.10 setting that might be in deployed airflow.cfg files
+        if task_log_reader == "file.task" and _get_handler("task"):
+            warnings.warn(
+                "task_log_reader setting in [core] has a deprecated value of "
+                "{!r}, but no handler with this name was found. Please update "
+                "your config to use {!r}. Running config has been adjusted to "
+                "match".format(
+                    task_log_reader,
+                    "task",
+                ),
+                DeprecationWarning,
+            )
+            conf.set('core', 'task_log_reader', 'task')
+        else:
+            raise AirflowConfigException(
+                "Configured task_log_reader {!r} was not a handler of the 'airflow.task' "
+                "logger.".format(task_log_reader)
+            )
diff --git a/tests/test_logging_config.py b/tests/test_logging_config.py
index d6f1194f75d67..b568a88cb2422 100644
--- a/tests/test_logging_config.py
+++ b/tests/test_logging_config.py
@@ -17,16 +17,22 @@
 # specific language governing permissions and limitations
 # under the License.
 import os
-import shutil
+import six
 import sys
 import tempfile
-import unittest
 from mock import patch, mock
 
 from airflow import configuration as conf
 from airflow.configuration import mkdir_p
 from airflow.exceptions import AirflowConfigException
 
+
+if six.PY2:
+    # Need `assertWarns` back-ported from unittest2
+    import unittest2 as unittest
+else:
+    import unittest
+
 SETTINGS_FILE_VALID = """
 LOGGING_CONFIG = {
     'version': 1,
@@ -41,14 +47,24 @@
             'class': 'logging.StreamHandler',
             'formatter': 'airflow.task',
             'stream': 'ext://sys.stdout'
-        }
+        },
+        'task': {
+            'class': 'logging.StreamHandler',
+            'formatter': 'airflow.task',
+            'stream': 'ext://sys.stdout'
+        },
     },
     'loggers': {
         'airflow': {
             'handlers': ['console'],
             'level': 'INFO',
             'propagate': False
-        }
+        },
+        'airflow.task': {
+            'handlers': ['task'],
+            'level': 'INFO',
+            'propagate': False,
+        },
     }
 }
 """
@@ -200,18 +216,21 @@ def test_loading_no_local_settings(self):
     # When the key is not available in the configuration
     def test_when_the_config_key_does_not_exists(self):
         from airflow import logging_config
+        conf_get = conf.get
 
         def side_effect(*args):
             if args[1] == 'logging_config_class':
                 raise AirflowConfigException
             else:
-                return "bla_bla_from_test"
+                return conf_get(*args)
 
         logging_config.conf.get = mock.Mock(side_effect=side_effect)
 
         with patch.object(logging_config.log, 'debug') as mock_debug:
             logging_config.configure_logging()
-            mock_debug.assert_any_call('Could not find key logging_config_class in config')
+            mock_debug.assert_any_call(
+                'Could not find key logging_config_class in config'
+            )
 
     # Just default
     def test_loading_local_settings_without_logging_config(self):
@@ -222,6 +241,16 @@ def test_loading_local_settings_without_logging_config(self):
                 'Unable to load custom logging, using default config instead'
             )
 
+    def test_1_9_config(self):
+        from airflow.logging_config import configure_logging
+        conf.set('core', 'task_log_reader', 'file.task')
+        try:
+            with self.assertWarnsRegex(DeprecationWarning, r'file.task'):
+                configure_logging()
+                self.assertEqual(conf.get('core', 'task_log_reader'), 'task')
+        finally:
+            conf.remove_option('core', 'task_log_reader', remove_default=False)
+
 
 if __name__ == '__main__':
     unittest.main()

From af776e034ee6e9279f7e808776b73fae29ddac64 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 17 Sep 2018 20:10:04 +0100
Subject: [PATCH 076/808] [AIRFLOW-1195] Add feature to clear tasks in Parent
 Dag (#3907)

---
 airflow/bin/cli.py        | 10 ++++++--
 airflow/models.py         | 26 +++++++++++++++++++
 airflow/www/views.py      |  8 ++++--
 airflow/www_rbac/views.py |  8 ++++--
 tests/core.py             | 40 ++++++++++++++++++++++++++++-
 tests/jobs.py             | 53 +++++++++++++++++++++++++++++++++++++++
 6 files changed, 138 insertions(+), 7 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 5a45a4595dd67..c1c74af136ce9 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -634,7 +634,9 @@ def clear(args):
         only_failed=args.only_failed,
         only_running=args.only_running,
         confirm_prompt=not args.no_confirm,
-        include_subdags=not args.exclude_subdags)
+        include_subdags=not args.exclude_subdags,
+        include_parentdag=not args.exclude_parentdag,
+    )
 
 
 def get_num_ready_workers_running(gunicorn_master_proc):
@@ -1420,6 +1422,10 @@ class CLIFactory(object):
         'exclude_subdags': Arg(
             ("-x", "--exclude_subdags"),
             "Exclude subdags", "store_true"),
+        'exclude_parentdag': Arg(
+            ("-xp", "--exclude_parentdag"),
+            "Exclude ParentDAGS if the task cleared is a part of a SubDAG",
+            "store_true"),
         'dag_regex': Arg(
             ("-dx", "--dag_regex"),
             "Search dag_id as regex instead of exact string", "store_true"),
@@ -1739,7 +1745,7 @@ class CLIFactory(object):
             'args': (
                 'dag_id', 'task_regex', 'start_date', 'end_date', 'subdir',
                 'upstream', 'downstream', 'no_confirm', 'only_failed',
-                'only_running', 'exclude_subdags', 'dag_regex'),
+                'only_running', 'exclude_subdags', 'exclude_parentdag', 'dag_regex'),
         }, {
             'func': pause,
             'help': "Pause a DAG",
diff --git a/airflow/models.py b/airflow/models.py
index f586139bb1145..8fc259d1b5a29 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -3762,9 +3762,11 @@ def clear(
             only_running=False,
             confirm_prompt=False,
             include_subdags=True,
+            include_parentdag=True,
             reset_dag_runs=True,
             dry_run=False,
             session=None,
+            get_tis=False,
     ):
         """
         Clears a set of task instances associated with the current dag for
@@ -3785,6 +3787,25 @@ def clear(
             tis = session.query(TI).filter(TI.dag_id == self.dag_id)
             tis = tis.filter(TI.task_id.in_(self.task_ids))
 
+        if include_parentdag and self.is_subdag:
+
+            p_dag = self.parent_dag.sub_dag(
+                task_regex=self.dag_id.split('.')[1],
+                include_upstream=False,
+                include_downstream=True)
+
+            tis = tis.union(p_dag.clear(
+                start_date=start_date, end_date=end_date,
+                only_failed=only_failed,
+                only_running=only_running,
+                confirm_prompt=confirm_prompt,
+                include_subdags=include_subdags,
+                include_parentdag=False,
+                reset_dag_runs=reset_dag_runs,
+                get_tis=True,
+                session=session,
+            ))
+
         if start_date:
             tis = tis.filter(TI.execution_date >= start_date)
         if end_date:
@@ -3794,6 +3815,9 @@ def clear(
         if only_running:
             tis = tis.filter(TI.state == State.RUNNING)
 
+        if get_tis:
+            return tis
+
         if dry_run:
             tis = tis.all()
             session.expunge_all()
@@ -3837,6 +3861,7 @@ def clear_dags(
             only_running=False,
             confirm_prompt=False,
             include_subdags=True,
+            include_parentdag=False,
             reset_dag_runs=True,
             dry_run=False,
     ):
@@ -3849,6 +3874,7 @@ def clear_dags(
                 only_running=only_running,
                 confirm_prompt=False,
                 include_subdags=include_subdags,
+                include_parentdag=include_parentdag,
                 reset_dag_runs=reset_dag_runs,
                 dry_run=True)
             all_tis.extend(tis)
diff --git a/airflow/www/views.py b/airflow/www/views.py
index ccbaafbbeb5a5..bdfaa525366c7 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1085,7 +1085,9 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
             count = dag.clear(
                 start_date=start_date,
                 end_date=end_date,
-                include_subdags=recursive)
+                include_subdags=recursive,
+                include_parentdag=recursive,
+            )
 
             flash("{0} task instances have been cleared".format(count))
             return redirect(origin)
@@ -1094,7 +1096,9 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
             start_date=start_date,
             end_date=end_date,
             include_subdags=recursive,
-            dry_run=True)
+            dry_run=True,
+            include_parentdag=recursive,
+        )
         if not tis:
             flash("No task instances to clear", 'error')
             response = redirect(origin)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index d42cc6fbab33e..3f5ccab5cbdd9 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -768,7 +768,9 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
             count = dag.clear(
                 start_date=start_date,
                 end_date=end_date,
-                include_subdags=recursive)
+                include_subdags=recursive,
+                include_parentdag=recursive,
+            )
 
             flash("{0} task instances have been cleared".format(count))
             return redirect(origin)
@@ -777,7 +779,9 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
             start_date=start_date,
             end_date=end_date,
             include_subdags=recursive,
-            dry_run=True)
+            include_parentdag=recursive,
+            dry_run=True,
+        )
         if not tis:
             flash("No task instances to clear", 'error')
             response = redirect(origin)
diff --git a/tests/core.py b/tests/core.py
index db17008c6cc51..f00c9aeead2cd 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1316,8 +1316,18 @@ def test_subdag_clear(self):
             'clear', 'example_subdag_operator', '--no_confirm', '--exclude_subdags'])
         cli.clear(args)
 
+    def test_parentdag_downstream_clear(self):
+        args = self.parser.parse_args([
+            'clear', 'example_subdag_operator.section-1', '--no_confirm'])
+        cli.clear(args)
+        args = self.parser.parse_args([
+            'clear', 'example_subdag_operator.section-1', '--no_confirm',
+            '--exclude_parentdag'])
+        cli.clear(args)
+
     def test_get_dags(self):
-        dags = cli.get_dags(self.parser.parse_args(['clear', 'example_subdag_operator', '-c']))
+        dags = cli.get_dags(self.parser.parse_args(['clear', 'example_subdag_operator',
+                                                    '-c']))
         self.assertEqual(len(dags), 1)
 
         dags = cli.get_dags(self.parser.parse_args(['clear', 'subdag', '-dx', '-c']))
@@ -1793,6 +1803,34 @@ def test_dag_views(self):
         response = self.app.get(url)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         response = self.app.get(url + "&confirmed=true")
+        url = (
+            "/admin/airflow/clear?task_id=section-1-task-1&"
+            "dag_id=example_subdag_operator.section-1&future=false&past=false&"
+            "upstream=false&downstream=true&recursive=true&"
+            "execution_date={}&"
+            "origin=/admin".format(DEFAULT_DATE_DS))
+        response = self.app.get(url)
+        self.assertIn("Wait a minute", response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.end",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-1.section-1-task-1",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-1",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2.section-2-task-1",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2.section-2-task-2",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2.section-2-task-3",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2.section-2-task-4",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.section-2.section-2-task-5",
+                      response.data.decode('utf-8'))
+        self.assertIn("example_subdag_operator.some-other-task",
+                      response.data.decode('utf-8'))
         url = (
             "/admin/airflow/run?task_id=runme_0&"
             "dag_id=example_bash_operator&ignore_all_deps=false&ignore_ti_state=true&"
diff --git a/tests/jobs.py b/tests/jobs.py
index 5dd6ff3efda9e..cb82ad1800603 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -899,6 +899,59 @@ def test_backfill_execute_subdag(self):
         subdag.clear()
         dag.clear()
 
+    def test_subdag_clear_parentdag_downstream_clear(self):
+        dag = self.dagbag.get_dag('example_subdag_operator')
+        subdag_op_task = dag.get_task('section-1')
+
+        subdag = subdag_op_task.subdag
+        subdag.schedule_interval = '@daily'
+
+        executor = TestExecutor(do_update=True)
+        job = BackfillJob(dag=subdag,
+                          start_date=DEFAULT_DATE,
+                          end_date=DEFAULT_DATE,
+                          executor=executor,
+                          donot_pickle=True)
+
+        with timeout(seconds=30):
+            job.run()
+
+        ti0 = TI(
+            task=subdag.get_task('section-1-task-1'),
+            execution_date=DEFAULT_DATE)
+        ti0.refresh_from_db()
+        self.assertEqual(ti0.state, State.SUCCESS)
+
+        sdag = subdag.sub_dag(
+            task_regex='section-1-task-1',
+            include_downstream=True,
+            include_upstream=False)
+
+        sdag.clear(
+            start_date=DEFAULT_DATE,
+            end_date=DEFAULT_DATE,
+            include_parentdag=True)
+
+        ti0.refresh_from_db()
+        self.assertEquals(State.NONE, ti0.state)
+
+        ti1 = TI(
+            task=dag.get_task('some-other-task'),
+            execution_date=DEFAULT_DATE)
+        self.assertEquals(State.NONE, ti1.state)
+
+        # Checks that all the Downstream tasks for Parent DAG
+        # have been cleared
+        for task in subdag_op_task.downstream_list:
+            ti = TI(
+                task=dag.get_task(task.task_id),
+                execution_date=DEFAULT_DATE
+            )
+            self.assertEquals(State.NONE, ti.state)
+
+        subdag.clear()
+        dag.clear()
+
     def test_backfill_execute_subdag_with_removed_task(self):
         """
         Ensure that subdag operators execute properly in the case where

From 25bb0dff64687948f73b3fb86fae4e8476f4f9ce Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 21 Sep 2018 23:30:04 +0100
Subject: [PATCH 077/808] [AIRFLOW-3099] Stop Missing Section Errors for
 optional sections (#3934)

---
 airflow/bin/cli.py | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index c1c74af136ce9..4226d7e6df859 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -464,9 +464,18 @@ def run(args, dag=None):
                 try:
                     conf.set(section, option, value)
                 except NoSectionError:
-                    log.error('Section {section} Option {option} '
-                              'does not exist in the config!'.format(section=section,
-                                                                     option=option))
+                    optional_sections = [
+                        'atlas', 'mesos', 'elasticsearch', 'kubernetes',
+                        'lineage', 'hive'
+                    ]
+                    if section in optional_sections:
+                        log.debug('Section {section} Option {option} '
+                                  'does not exist in the config!'.format(section=section,
+                                                                         option=option))
+                    else:
+                        log.error('Section {section} Option {option} '
+                                  'does not exist in the config!'.format(section=section,
+                                                                         option=option))
 
         settings.configure_vars()
 

From 79d2406dab638be758060a0b076590d00f2fc044 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 4 Sep 2018 10:26:17 +0100
Subject: [PATCH 078/808] [AIRFLOW-XXX] Fix python3 and flake8 errors in
 dev/airflow-jira

This is a script that checks if the Jira's marked as fixed in a release
are actually merged in - getting this working is helpful to me in
preparing 1.10.1
---
 dev/airflow-jira | 61 ++++++++++++++++++++++++------------------------
 1 file changed, 31 insertions(+), 30 deletions(-)

diff --git a/dev/airflow-jira b/dev/airflow-jira
index 4c9b947a0d49c..27ec99191426f 100755
--- a/dev/airflow-jira
+++ b/dev/airflow-jira
@@ -39,10 +39,6 @@ TMP_CREDENTIALS = {}
 PROJECT = "AIRFLOW"
 
 # Python 3 compatibility
-try:
-    import urllib2 as urllib
-except ImportError:
-    import urllib.request as urllib
 if sys.version_info[0] == 3:
     raw_input = input
 
@@ -52,12 +48,6 @@ except ImportError:
     print("Could not find the click library. Run 'sudo pip install click' to install.")
     sys.exit(-1)
 
-try:
-    import keyring
-except ImportError:
-    print("Could not find the keyring library. Run 'sudo pip install keyring' to install.")
-    sys.exit(-1)
-
 try:
     import git
 except ImportError:
@@ -73,11 +63,11 @@ GIT_LOG_FORMAT = '%x1f'.join(GIT_LOG_FORMAT) + '%x1e'
 
 
 def get_jiras_for_version(version):
-    asf_jira = jira.client.JIRA(
-            {'server': JIRA_API_BASE})
+    asf_jira = jira.client.JIRA({'server': JIRA_API_BASE})
 
-    issues = asf_jira.search_issues('PROJECT={} and fixVersion={}'.format(PROJECT, version))
-    return issues
+    return asf_jira.search_issues(
+        'PROJECT={} and fixVersion={}'.format(PROJECT, version)
+    )
 
 
 def get_merged_issues(version):
@@ -97,7 +87,7 @@ def get_merged_issues(version):
         match = issue_re.match(log_item['subject'])
         if match:
             issue_id = match.group(1)
-        if log_item.has_key('body'):
+        if 'body' in log_item:
             match = pr_re.match(log_item['body'])
             if match:
                 log_item['pull_request'] = match.group(2)
@@ -111,6 +101,7 @@ def get_merged_issues(version):
 
     return merges
 
+
 @click.group()
 def cli():
     r"""
@@ -127,22 +118,34 @@ def compare(target_version):
     merges = get_merged_issues(target_version)
     issues = get_jiras_for_version(target_version)
 
-    print("{:<18}|{:<12}||{:<10}||{:<10}|{:<50}|{:<6}|{:<6}|{:<40}"
-          .format("ISSUE ID", "TYPE", "PRIORITY",
-                  "STATUS", "DESCRIPTION", "MERGED",
-                  "PR", "COMMIT"))
+    # :<18 says left align, pad to 18
+    # :<50.50 truncates after 50 chars
+    # !s forces as string - some of the Jira objects have a string method, but
+    #    Py3 doesn't call by default
+    formatstr = "{id:<18}|{typ!s:<12}||{priority!s:<10}||{status!s:<10}|" \
+                "{description:<50.50}|{merged:<6}|{pr:<6}|{commit:<40}"
+
+    print(formatstr.format(
+        id="ISSUE ID",
+        typ="TYPE",
+        priority="PRIORITY",
+        status="STATUS",
+        description="DESCRIPTION",
+        merged="MERGED",
+        pr="PR",
+        commit="COMMIT"))
 
     for issue in issues:
         is_merged = issue.key in merges
-        print("{:<18}|{:<12}||{:<10}||{:<10}|{:<50}|{:<6}|{:<6}|{:<40}"
-              .format(issue.key,
-                      issue.fields.issuetype,
-                      issue.fields.priority,
-                      issue.fields.status,
-                      issue.fields.summary[:50],
-                      is_merged,
-                      merges[issue.key]['pull_request'] if is_merged else "-",
-                      merges[issue.key]['id'] if is_merged else "-"))
+        print(formatstr.format(
+            id=issue.key,
+            typ=issue.fields.issuetype,
+            priority=issue.fields.priority,
+            status=issue.fields.status,
+            description=issue.fields.summary,
+            merged=is_merged,
+            pr=merges[issue.key]['pull_request'] if is_merged else "-",
+            commit=merges[issue.key]['id'] if is_merged else "-"))
 
 
 if __name__ == "__main__":
@@ -154,5 +157,3 @@ if __name__ == "__main__":
         cli()
     except:
         raise
-
-

From 17381aeaa29769dc8a2bcd92f442d5fb70034efb Mon Sep 17 00:00:00 2001
From: Trevor Edwards <TrevorEdwards@users.noreply.github.com>
Date: Wed, 19 Sep 2018 11:46:59 -0700
Subject: [PATCH 079/808] [AIRFLOW-1441] Fix inconsistent tutorial code (#2466)

---
 docs/tutorial.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index 1c2dfd69b7c41..0ea58d2784e65 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -37,7 +37,7 @@ complicated, a line by line explanation follows below.
         # 'end_date': datetime(2016, 1, 1),
     }
 
-    dag = DAG('tutorial', default_args=default_args)
+    dag = DAG('tutorial', default_args=default_args, schedule_interval=timedelta(days=1))
 
     # t1, t2 and t3 are examples of tasks created by instantiating operators
     t1 = BashOperator(
@@ -147,7 +147,7 @@ define a ``schedule_interval`` of 1 day for the DAG.
 .. code:: python
 
     dag = DAG(
-        'tutorial', default_args=default_args, schedule_interval=timedelta(1))
+        'tutorial', default_args=default_args, schedule_interval=timedelta(days=1))
 
 Tasks
 -----
@@ -277,8 +277,8 @@ something like this:
 .. code:: python
 
     """
-    Code that goes along with the Airflow located at:
-    http://airflow.readthedocs.org/en/latest/tutorial.html
+    Code that goes along with the Airflow tutorial located at:
+    https://github.com/apache/incubator-airflow/blob/master/airflow/example_dags/tutorial.py
     """
     from airflow import DAG
     from airflow.operators.bash_operator import BashOperator
@@ -301,7 +301,7 @@ something like this:
     }
 
     dag = DAG(
-        'tutorial', default_args=default_args, schedule_interval=timedelta(1))
+        'tutorial', default_args=default_args, schedule_interval=timedelta(days=1))
 
     # t1, t2 and t3 are examples of tasks created by instantiating operators
     t1 = BashOperator(

From 85c6f300cd4500b44c13ead3d7b35137e28fc893 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Mon, 10 Sep 2018 01:00:54 +0800
Subject: [PATCH 080/808] [AIRFLOW-1917] Trim extra newline and trailing
 whitespace from log (#3862)

---
 airflow/utils/log/logging_mixin.py | 2 +-
 tests/utils/test_logging_mixin.py  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/utils/log/logging_mixin.py b/airflow/utils/log/logging_mixin.py
index 3f696931c955b..85c03f77abe81 100644
--- a/airflow/utils/log/logging_mixin.py
+++ b/airflow/utils/log/logging_mixin.py
@@ -92,7 +92,7 @@ def write(self, message):
             self._buffer += message
         else:
             self._buffer += message
-            self.logger.log(self.level, self._buffer)
+            self.logger.log(self.level, self._buffer.rstrip())
             self._buffer = str()
 
     def flush(self):
diff --git a/tests/utils/test_logging_mixin.py b/tests/utils/test_logging_mixin.py
index 74da742891c3c..6d795584d9bfd 100644
--- a/tests/utils/test_logging_mixin.py
+++ b/tests/utils/test_logging_mixin.py
@@ -86,8 +86,8 @@ def test_write(self):
 
         self.assertEqual(log._buffer, msg)
 
-        log.write("\n")
-        logger.log.assert_called_once_with(1, msg + "\n")
+        log.write(" \n")
+        logger.log.assert_called_once_with(1, msg)
 
         self.assertEqual(log._buffer, "")
 

From 08dc5b201601d75bf77e432ec14599d0580f8184 Mon Sep 17 00:00:00 2001
From: XD-DENG <xd_deng@hotmail.com>
Date: Tue, 31 Jul 2018 10:30:36 +0800
Subject: [PATCH 081/808] [AIRFLOW-2825]Fix S3ToHiveTransfer bug due to case

Because upper/lower case was not considered
in the file extension check, S3ToHiveTransfer
operator may mistakenly think a GZIP file with
uppercase ext ".GZ" is not a GZIP file and
raise exception.
---
 airflow/operators/s3_to_hive_operator.py |  2 +-
 tests/operators/s3_to_hive_operator.py   | 20 +++++++++++++++-----
 2 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/airflow/operators/s3_to_hive_operator.py b/airflow/operators/s3_to_hive_operator.py
index 09eb8363c0dc5..5faaf916b7417 100644
--- a/airflow/operators/s3_to_hive_operator.py
+++ b/airflow/operators/s3_to_hive_operator.py
@@ -153,7 +153,7 @@ def execute(self, context):
 
         root, file_ext = os.path.splitext(s3_key_object.key)
         if (self.select_expression and self.input_compressed and
-                file_ext != '.gz'):
+                file_ext.lower() != '.gz'):
             raise AirflowException("GZIP is the only compression " +
                                    "format Amazon S3 Select supports")
 
diff --git a/tests/operators/s3_to_hive_operator.py b/tests/operators/s3_to_hive_operator.py
index 482e7fefc82ff..6ca6274a2c173 100644
--- a/tests/operators/s3_to_hive_operator.py
+++ b/tests/operators/s3_to_hive_operator.py
@@ -89,6 +89,11 @@ def setUp(self):
                                mode="wb") as f_gz_h:
                 self._set_fn(fn_gz, '.gz', True)
                 f_gz_h.writelines([header, line1, line2])
+            fn_gz_upper = self._get_fn('.txt', True) + ".GZ"
+            with gzip.GzipFile(filename=fn_gz_upper,
+                               mode="wb") as f_gz_upper_h:
+                self._set_fn(fn_gz_upper, '.GZ', True)
+                f_gz_upper_h.writelines([header, line1, line2])
             fn_bz2 = self._get_fn('.txt', True) + '.bz2'
             with bz2.BZ2File(filename=fn_bz2,
                              mode="wb") as f_bz2_h:
@@ -105,6 +110,11 @@ def setUp(self):
                                mode="wb") as f_gz_nh:
                 self._set_fn(fn_gz, '.gz', False)
                 f_gz_nh.writelines([line1, line2])
+            fn_gz_upper = self._get_fn('.txt', False) + ".GZ"
+            with gzip.GzipFile(filename=fn_gz_upper,
+                               mode="wb") as f_gz_upper_nh:
+                self._set_fn(fn_gz_upper, '.GZ', False)
+                f_gz_upper_nh.writelines([line1, line2])
             fn_bz2 = self._get_fn('.txt', False) + '.bz2'
             with bz2.BZ2File(filename=fn_bz2,
                              mode="wb") as f_bz2_nh:
@@ -143,7 +153,7 @@ def _check_file_equality(self, fn_1, fn_2, ext):
         # gz files contain mtime and filename in the header that
         # causes filecmp to return False even if contents are identical
         # Hence decompress to test for equality
-        if(ext == '.gz'):
+        if(ext.lower() == '.gz'):
             with gzip.GzipFile(fn_1, 'rb') as f_1,\
                  NamedTemporaryFile(mode='wb') as f_txt_1,\
                  gzip.GzipFile(fn_2, 'rb') as f_2,\
@@ -220,14 +230,14 @@ def test_execute(self, mock_hiveclihook):
         conn.create_bucket(Bucket='bucket')
 
         # Testing txt, zip, bz2 files with and without header row
-        for (ext, has_header) in product(['.txt', '.gz', '.bz2'], [True, False]):
+        for (ext, has_header) in product(['.txt', '.gz', '.bz2', '.GZ'], [True, False]):
             self.kwargs['headers'] = has_header
             self.kwargs['check_headers'] = has_header
             logging.info("Testing {0} format {1} header".
                          format(ext,
                                 ('with' if has_header else 'without'))
                          )
-            self.kwargs['input_compressed'] = ext != '.txt'
+            self.kwargs['input_compressed'] = ext.lower() != '.txt'
             self.kwargs['s3_key'] = 's3://bucket/' + self.s3_key + ext
             ip_fn = self._get_fn(ext, self.kwargs['headers'])
             op_fn = self._get_fn(ext, False)
@@ -260,8 +270,8 @@ def test_execute_with_select_expression(self, mock_hiveclihook):
         # Only testing S3ToHiveTransfer calls S3Hook.select_key with
         # the right parameters and its execute method succeeds here,
         # since Moto doesn't support select_object_content as of 1.3.2.
-        for (ext, has_header) in product(['.txt', '.gz'], [True, False]):
-            input_compressed = ext != '.txt'
+        for (ext, has_header) in product(['.txt', '.gz', '.GZ'], [True, False]):
+            input_compressed = ext.lower() != '.txt'
             key = self.s3_key + ext
 
             self.kwargs['check_headers'] = False

From b2ac815fcbc9fa8e14aa9aa6b59141ee34ae01a1 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 5 Aug 2018 11:54:14 +0800
Subject: [PATCH 082/808] [AIRFLOW-2848] Ensure dag_id in metadata "job" for
 LocalTaskJob (#3693)

dag_id is missing for all entries in metadata
table "job" with job_type "LocalTaskJob".

This is due to that dag_id was not specified
within class LocalTaskJob.

A test is added to check if essential
attributes of LocalTaskJob can be assigned
with proper values without intervention.
---
 airflow/jobs.py |  1 +
 tests/jobs.py   | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 88aa643c50152..27d6d120d23f6 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -2568,6 +2568,7 @@ def __init__(
             pool=None,
             *args, **kwargs):
         self.task_instance = task_instance
+        self.dag_id = task_instance.dag_id
         self.ignore_all_deps = ignore_all_deps
         self.ignore_depends_on_past = ignore_depends_on_past
         self.ignore_task_deps = ignore_task_deps
diff --git a/tests/jobs.py b/tests/jobs.py
index cb82ad1800603..67717acc2b654 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1099,6 +1099,39 @@ class LocalTaskJobTest(unittest.TestCase):
     def setUp(self):
         pass
 
+    def test_localtaskjob_essential_attr(self):
+        """
+        Check whether essential attributes
+        of LocalTaskJob can be assigned with
+        proper values without intervention
+        """
+        dag = DAG(
+            'test_localtaskjob_essential_attr',
+            start_date=DEFAULT_DATE,
+            default_args={'owner': 'owner1'})
+
+        with dag:
+            op1 = DummyOperator(task_id='op1')
+
+        dag.clear()
+        dr = dag.create_dagrun(run_id="test",
+                               state=State.SUCCESS,
+                               execution_date=DEFAULT_DATE,
+                               start_date=DEFAULT_DATE)
+        ti = dr.get_task_instance(task_id=op1.task_id)
+
+        job1 = LocalTaskJob(task_instance=ti,
+                            ignore_ti_state=True,
+                            executor=SequentialExecutor())
+
+        essential_attr = ["dag_id", "job_type", "start_date", "hostname"]
+
+        check_result_1 = [hasattr(job1, attr) for attr in essential_attr]
+        self.assertTrue(all(check_result_1))
+
+        check_result_2 = [getattr(job1, attr) is not None for attr in essential_attr]
+        self.assertTrue(all(check_result_2))
+
     @patch('os.getpid')
     def test_localtaskjob_heartbeat(self, mock_pid):
         session = settings.Session()

From cf067267827ce534463475f721f650c20409cd93 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Thu, 27 Sep 2018 13:10:03 +0100
Subject: [PATCH 083/808] [AIRFLOW-XXX] Pin Click to 6.7 to Fix CI (#3962)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 481c94c8f27e4..f92d3f6463906 100644
--- a/setup.py
+++ b/setup.py
@@ -221,7 +221,7 @@ def write_version(filename=os.path.join(*['airflow',
     + cassandra + mongo
 
 devel = [
-    'click',
+    'click==6.7',
     'freezegun',
     'jira',
     'lxml>=3.3.4',

From 8807071d2b0c09ab816d3008aba042b14b8b755e Mon Sep 17 00:00:00 2001
From: Christian Trebing <christian.trebing@blue-yonder.com>
Date: Wed, 20 Jun 2018 20:19:21 +0200
Subject: [PATCH 084/808] [AIRFLOW-2592] Bump bleach dependency

Bleach dependency is updated to 2.1.3 to address
CVE-2018-7753

Closes #3524 from ctrebing/AIRFLOW-2592-bump-
bleach-dependency
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index f92d3f6463906..ab6d06e8ff64b 100644
--- a/setup.py
+++ b/setup.py
@@ -270,7 +270,7 @@ def do_setup():
         scripts=['airflow/bin/airflow'],
         install_requires=[
             'alembic>=0.8.3, <0.9',
-            'bleach==2.1.2',
+            'bleach~=2.1.3',
             'configparser>=3.5.0, <3.6.0',
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',

From 13a30ac215e248a25bf0373c548c8fe9f2c285d3 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 21 Sep 2018 18:24:13 +0800
Subject: [PATCH 085/808] [AIRFLOW-XXX] Fix a wrong sample bash command, a
 display issue & a few typos (#3924)

---
 docs/concepts.rst                  | 6 +++---
 docs/howto/executor/use-celery.rst | 2 +-
 docs/howto/manage-connections.rst  | 6 +++---
 docs/howto/secure-connections.rst  | 2 +-
 docs/kubernetes.rst                | 3 ++-
 docs/ui.rst                        | 2 +-
 6 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/docs/concepts.rst b/docs/concepts.rst
index fcaaf99214ae0..f8f5d742f5fcf 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -316,7 +316,7 @@ Connections
 ===========
 
 The connection information to external systems is stored in the Airflow
-metadata database and managed in the UI (``Menu -> Admin -> Connections``)
+metadata database and managed in the UI (``Menu -> Admin -> Connections``).
 A ``conn_id`` is defined there and hostname / login / password / schema
 information attached to it. Airflow pipelines can simply refer to the
 centrally managed ``conn_id`` without having to hard code any of this
@@ -338,7 +338,7 @@ See :doc:`howto/manage-connections` for how to create and manage connections.
 Queues
 ======
 
-When using the CeleryExecutor, the celery queues that tasks are sent to
+When using the CeleryExecutor, the Celery queues that tasks are sent to
 can be specified. ``queue`` is an attribute of BaseOperator, so any
 task can be assigned to any queue. The default queue for the environment
 is defined in the ``airflow.cfg``'s ``celery -> default_queue``. This defines
@@ -346,7 +346,7 @@ the queue that tasks get assigned to when not specified, as well as which
 queue Airflow workers listen to when started.
 
 Workers can listen to one or multiple queues of tasks. When a worker is
-started (using the command ``airflow worker``), a set of comma delimited
+started (using the command ``airflow worker``), a set of comma-delimited
 queue names can be specified (e.g. ``airflow worker -q spark``). This worker
 will then only pick up tasks wired to the specified queue(s).
 
diff --git a/docs/howto/executor/use-celery.rst b/docs/howto/executor/use-celery.rst
index fd6db96a95872..0e1bab060b0b2 100644
--- a/docs/howto/executor/use-celery.rst
+++ b/docs/howto/executor/use-celery.rst
@@ -44,4 +44,4 @@ Some caveats:
 
 - Make sure to use a database backed result backend
 - Make sure to set a visibility timeout in [celery_broker_transport_options] that exceeds the ETA of your longest running task
-- Tasks can and consume resources, make sure your worker as enough resources to run `worker_concurrency` tasks
+- Tasks can consume resources. Make sure your worker has enough resources to run `worker_concurrency` tasks
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index f5203157aca8d..f869a08b3c061 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -3,7 +3,7 @@ Managing Connections
 
 Airflow needs to know how to connect to your environment. Information
 such as hostname, port, login and passwords to other systems and services is
-handled in the ``Admin->Connection`` section of the UI. The pipeline code you
+handled in the ``Admin->Connections`` section of the UI. The pipeline code you
 will author will reference the 'conn_id' of the Connection objects.
 
 .. image:: ../img/connections.png
@@ -17,7 +17,7 @@ more information.
 Creating a Connection with the UI
 ---------------------------------
 
-Open the ``Admin->Connection`` section of the UI. Click the ``Create`` link
+Open the ``Admin->Connections`` section of the UI. Click the ``Create`` link
 to create a new connection.
 
 .. image:: ../img/connection_create.png
@@ -34,7 +34,7 @@ to create a new connection.
 Editing a Connection with the UI
 --------------------------------
 
-Open the ``Admin->Connection`` section of the UI. Click the pencil icon next
+Open the ``Admin->Connections`` section of the UI. Click the pencil icon next
 to the connection you wish to edit in the connection list.
 
 .. image:: ../img/connection_edit.png
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index f9e252c4c365a..bb13b1bb08bba 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -26,7 +26,7 @@ variable over the value in ``airflow.cfg``:
 .. code-block:: bash
 
   # Note the double underscores
-  EXPORT AIRFLOW__CORE__FERNET_KEY = your_fernet_key
+  export AIRFLOW__CORE__FERNET_KEY=your_fernet_key
 
 4. Restart Airflow webserver.
 5. For existing connections (the ones that you had defined before installing ``airflow[crypto]`` and creating a Fernet key), you need to open each connection in the connection admin UI, re-type the password, and save it.
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index a4916858fc15e..3fe9bd38f690d 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -4,7 +4,8 @@ Kubernetes Executor
 The kubernetes executor is introduced in Apache Airflow 1.10.0. The Kubernetes executor will create a new pod for every task instance.
 
 Example helm charts are available at `scripts/ci/kubernetes/kube/{airflow,volumes,postgres}.yaml` in the source distribution. The volumes are optional and depend on your configuration. There are two volumes available:
-- Dags: by storing all the dags onto the persistent disks, all the workers can read the dags from there. Another option is using git-sync, before starting the container, a git pull of the dags repository will be performed and used throughout the lifecycle of the pod/
+
+- Dags: by storing all the dags onto the persistent disks, all the workers can read the dags from there. Another option is using git-sync, before starting the container, a git pull of the dags repository will be performed and used throughout the lifecycle of the pod.
 - Logs: by storing the logs onto a persistent disk, all the logs will be available for all the workers and the webserver itself. If you don't configure this, the logs will be lost after the worker pods shuts down. Another option is to use S3/GCS/etc to store the logs.
 
 
diff --git a/docs/ui.rst b/docs/ui.rst
index 4b232fa1aea18..5a09ce5aa0a92 100644
--- a/docs/ui.rst
+++ b/docs/ui.rst
@@ -1,6 +1,6 @@
 UI / Screenshots
 =================
-The Airflow UI make it easy to monitor and troubleshoot your data pipelines.
+The Airflow UI makes it easy to monitor and troubleshoot your data pipelines.
 Here's a quick overview of some of the features and visualizations you
 can find in the Airflow UI.
 

From 9c1030eaa34033e041136e6f9029f274a156a1bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Bili=C5=84ski?= <szymon.bilinski@gmail.com>
Date: Wed, 19 Sep 2018 16:25:45 +0200
Subject: [PATCH 086/808] [AIRFLOW-XXX] Fix SlackWebhookOperator docs (#3915)

The docs refer to `conn_id` while the actual argument is `http_conn_id`.
---
 airflow/contrib/operators/slack_webhook_operator.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/operators/slack_webhook_operator.py b/airflow/contrib/operators/slack_webhook_operator.py
index bab3e90856d34..5263b5c0f2b3f 100644
--- a/airflow/contrib/operators/slack_webhook_operator.py
+++ b/airflow/contrib/operators/slack_webhook_operator.py
@@ -31,8 +31,8 @@ class SlackWebhookOperator(SimpleHttpOperator):
     Each Slack webhook token can be pre-configured to use a specific channel, username and
     icon. You can override these defaults in this hook.
 
-    :param conn_id: connection that has Slack webhook token in the extra field
-    :type conn_id: str
+    :param http_conn_id: connection that has Slack webhook token in the extra field
+    :type http_conn_id: str
     :param webhook_token: Slack webhook token
     :type webhook_token: str
     :param message: The message you want to send on Slack

From 0f6755361f8cafa2caba5b0a49e9aa3a2ce475ae Mon Sep 17 00:00:00 2001
From: Andy Cooper <andycooper.s@gmail.com>
Date: Tue, 24 Jul 2018 15:57:36 -0400
Subject: [PATCH 087/808] [AIRFLOW-2800] Remove low-hanging linting errors

---
 airflow/__init__.py                           | 13 ++---
 airflow/contrib/auth/backends/ldap_auth.py    |  4 +-
 airflow/contrib/hooks/aws_hook.py             |  2 +-
 .../contrib/operators/awsbatch_operator.py    |  2 +-
 .../operators/mlengine_prediction_summary.py  | 14 +++---
 airflow/jobs.py                               | 50 ++++++++++++-------
 airflow/migrations/__init__.py                |  5 +-
 airflow/migrations/env.py                     |  4 +-
 ...add_dag_id_state_index_on_dag_run_table.py |  5 +-
 .../13eb55f81627_for_compatibility.py         |  4 +-
 .../1507a7289a2f_create_is_encrypted.py       |  4 +-
 ...e3_add_is_encrypted_column_to_variable_.py |  4 +-
 .../versions/1b38cef5b76e_add_dagrun.py       |  4 +-
 .../211e584da130_add_ti_state_index.py        |  4 +-
 .../versions/2e541a1dcfed_task_duration.py    |  4 +-
 .../2e82aab8ef20_rename_user_table.py         |  5 +-
 ...0f54d61_more_logging_into_task_isntance.py |  4 +-
 .../versions/40e67319e3a9_dagrun_config.py    |  4 +-
 .../versions/4446e08588_dagrun_start_end.py   |  4 +-
 ..._add_fractional_seconds_to_mysql_tables.py |  4 +-
 .../502898887f84_adding_extra_to_log.py       |  4 +-
 .../versions/52d714495f0_job_id_indices.py    |  4 +-
 ...61833c1c74b_add_password_column_to_user.py |  4 +-
 ...d17757c7a_add_pid_field_to_taskinstance.py |  4 +-
 ...de9cddf6c9_add_task_fails_journal_table.py |  4 +-
 .../8504051e801b_xcom_dag_task_indices.py     |  4 +-
 .../947454bf1dff_add_ti_job_id_index.py       |  4 +-
 airflow/migrations/versions/__init__.py       |  5 +-
 ...6_add_a_column_to_track_the_encryption_.py |  4 +-
 ...dd_notification_sent_column_to_sla_miss.py |  4 +-
 ...6_make_xcom_value_column_a_large_binary.py |  6 +--
 ...7_add_max_tries_column_to_task_instance.py |  4 +-
 ...ae31099d61_increase_text_size_for_mysql.py |  4 +-
 .../versions/e3a246e0dc1_current_schema.py    |  4 +-
 .../f2ca10b85618_add_dag_stats_table.py       |  4 +-
 airflow/plugins_manager.py                    |  6 ++-
 airflow/settings.py                           |  6 +--
 airflow/utils/__init__.py                     |  4 +-
 airflow/utils/asciiart.py                     |  4 +-
 airflow/utils/cli_action_loggers.py           |  4 +-
 airflow/utils/compression.py                  |  4 +-
 airflow/utils/dag_processing.py               |  4 +-
 airflow/utils/dates.py                        | 20 ++++----
 airflow/utils/db.py                           |  2 +-
 airflow/utils/decorators.py                   |  4 +-
 airflow/utils/file.py                         |  4 +-
 airflow/utils/helpers.py                      |  4 +-
 airflow/utils/json.py                         |  4 +-
 airflow/utils/log/__init__.py                 |  4 +-
 airflow/utils/log/es_task_handler.py          |  4 +-
 airflow/utils/log/file_processor_handler.py   |  4 +-
 airflow/utils/log/file_task_handler.py        |  4 +-
 airflow/utils/log/logging_mixin.py            |  4 +-
 airflow/utils/log/s3_task_handler.py          |  6 +--
 airflow/utils/net.py                          |  4 +-
 airflow/utils/operator_resources.py           |  4 +-
 airflow/utils/sqlalchemy.py                   |  4 +-
 airflow/utils/state.py                        |  4 +-
 airflow/utils/tests.py                        |  4 +-
 airflow/utils/timeout.py                      |  4 +-
 airflow/utils/trigger_rule.py                 |  4 +-
 airflow/utils/weight_rule.py                  |  4 +-
 airflow/www/__init__.py                       |  5 +-
 airflow/www/api/__init__.py                   |  4 +-
 airflow/www/api/experimental/__init__.py      |  4 +-
 airflow/www/blueprints.py                     |  4 +-
 airflow/www/gunicorn_config.py                |  4 +-
 airflow/www/validators.py                     | 11 ++--
 airflow/www/views.py                          | 44 ++++++++--------
 airflow/www_rbac/__init__.py                  |  4 +-
 airflow/www_rbac/api/__init__.py              |  4 +-
 airflow/www_rbac/api/experimental/__init__.py |  4 +-
 airflow/www_rbac/blueprints.py                |  4 +-
 airflow/www_rbac/validators.py                |  4 +-
 airflow/www_rbac/widgets.py                   |  4 +-
 75 files changed, 226 insertions(+), 209 deletions(-)

diff --git a/airflow/__init__.py b/airflow/__init__.py
index f40b08aab5e77..bc6a7bbe19f36 100644
--- a/airflow/__init__.py
+++ b/airflow/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -80,11 +80,12 @@ class AirflowMacroPlugin(object):
     def __init__(self, namespace):
         self.namespace = namespace
 
-from airflow import operators
+
+from airflow import operators  # noqa: E402
 from airflow import sensors  # noqa: E402
-from airflow import hooks
-from airflow import executors
-from airflow import macros
+from airflow import hooks  # noqa: E402
+from airflow import executors  # noqa: E402
+from airflow import macros  # noqa: E402
 
 operators._integrate_plugins()
 sensors._integrate_plugins()  # noqa: E402
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index eefaa1263b250..516e121c9b26d 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -62,7 +62,7 @@ def get_ldap_connection(dn=None, password=None):
         cacert = configuration.conf.get("ldap", "cacert")
         tls_configuration = Tls(validate=ssl.CERT_REQUIRED, ca_certs_file=cacert)
         use_ssl = True
-    except:
+    except Exception:
         pass
 
     server = Server(configuration.conf.get("ldap", "uri"), use_ssl, tls_configuration)
@@ -94,7 +94,7 @@ def groups_user(conn, search_base, user_filter, user_name_att, username):
     search_filter = "(&({0})({1}={2}))".format(user_filter, user_name_att, username)
     try:
         memberof_attr = configuration.conf.get("ldap", "group_member_attr")
-    except:
+    except Exception:
         memberof_attr = "memberOf"
     res = conn.search(native(search_base), native(search_filter),
                       attributes=[native(memberof_attr)])
diff --git a/airflow/contrib/hooks/aws_hook.py b/airflow/contrib/hooks/aws_hook.py
index c712d2de7910b..5d515d91bbab2 100644
--- a/airflow/contrib/hooks/aws_hook.py
+++ b/airflow/contrib/hooks/aws_hook.py
@@ -72,7 +72,7 @@ def _parse_s3_config(config_file_name, config_format='boto', profile=None):
         try:
             access_key = config.get(cred_section, key_id_option)
             secret_key = config.get(cred_section, secret_key_option)
-        except:
+        except Exception:
             logging.warning("Option Error in parsing s3 config file")
             raise
         return access_key, secret_key
diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index d23b44e0d4471..ed7f1ebf36cce 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -139,7 +139,7 @@ def _wait_for_task_ended(self):
                 if response['jobs'][-1]['status'] in ['SUCCEEDED', 'FAILED']:
                     retry = False
 
-                sleep( 1 + pow(retries * 0.1, 2))
+                sleep(1 + pow(retries * 0.1, 2))
                 retries += 1
 
     def _check_success_task(self):
diff --git a/airflow/contrib/operators/mlengine_prediction_summary.py b/airflow/contrib/operators/mlengine_prediction_summary.py
index 17fc2c090379e..4efe81e64151f 100644
--- a/airflow/contrib/operators/mlengine_prediction_summary.py
+++ b/airflow/contrib/operators/mlengine_prediction_summary.py
@@ -112,14 +112,14 @@ def decode(self, x):
 @beam.ptransform_fn
 def MakeSummary(pcoll, metric_fn, metric_keys):  # pylint: disable=invalid-name
     return (
-        pcoll
-        | "ApplyMetricFnPerInstance" >> beam.Map(metric_fn)
-        | "PairWith1" >> beam.Map(lambda tup: tup + (1,))
-        | "SumTuple" >> beam.CombineGlobally(beam.combiners.TupleCombineFn(
-            *([sum] * (len(metric_keys) + 1))))
-        | "AverageAndMakeDict" >> beam.Map(
+        pcoll |
+        "ApplyMetricFnPerInstance" >> beam.Map(metric_fn) |
+        "PairWith1" >> beam.Map(lambda tup: tup + (1,)) |
+        "SumTuple" >> beam.CombineGlobally(beam.combiners.TupleCombineFn(
+            *([sum] * (len(metric_keys) + 1)))) |
+        "AverageAndMakeDict" >> beam.Map(
             lambda tup: dict(
-                [(name, tup[i]/tup[-1]) for i, name in enumerate(metric_keys)] +
+                [(name, tup[i] / tup[-1]) for i, name in enumerate(metric_keys)] +
                 [("count", tup[-1])])))
 
 
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 27d6d120d23f6..69471fd64f890 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -173,7 +173,8 @@ def heartbeat(self):
         if job.latest_heartbeat:
             sleep_for = max(
                 0,
-                self.heartrate - (timezone.utcnow() - job.latest_heartbeat).total_seconds())
+                self.heartrate - (
+                    timezone.utcnow() - job.latest_heartbeat).total_seconds())
 
         sleep(sleep_for)
 
@@ -391,7 +392,7 @@ def helper():
                 log.info(
                     "Processing %s took %.3f seconds", file_path, end_time - start_time
                 )
-            except:
+            except Exception:
                 # Log exceptions through the logging framework.
                 log.exception("Got an exception! Propagating...")
                 raise
@@ -1087,17 +1088,18 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
             session
             .query(TI)
             .filter(TI.dag_id.in_(simple_dag_bag.dag_ids))
-            .outerjoin(DR,
-                and_(DR.dag_id == TI.dag_id,
-                     DR.execution_date == TI.execution_date))
-            .filter(or_(DR.run_id == None,
+            .outerjoin(
+                DR,
+                and_(DR.dag_id == TI.dag_id, DR.execution_date == TI.execution_date)
+            )
+            .filter(or_(DR.run_id == None,  # noqa E711
                     not_(DR.run_id.like(BackfillJob.ID_PREFIX + '%'))))
-            .outerjoin(DM, DM.dag_id==TI.dag_id)
-            .filter(or_(DM.dag_id == None,
+            .outerjoin(DM, DM.dag_id == TI.dag_id)
+            .filter(or_(DM.dag_id == None,  # noqa E711
                     not_(DM.is_paused)))
         )
         if None in states:
-            ti_query = ti_query.filter(or_(TI.state == None, TI.state.in_(states)))
+            ti_query = ti_query.filter(or_(TI.state == None, TI.state.in_(states))) # noqa E711
         else:
             ti_query = ti_query.filter(TI.state.in_(states))
 
@@ -1119,7 +1121,8 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         for task_instance in task_instances_to_examine:
             pool_to_task_instances[task_instance.pool].append(task_instance)
 
-        task_concurrency_map = self.__get_task_concurrency_map(states=states_to_count_as_running, session=session)
+        task_concurrency_map = self.__get_task_concurrency_map(
+            states=states_to_count_as_running, session=session)
 
         # Go through each pool, and queue up a task for execution if there are
         # any open slots in the pool.
@@ -1190,9 +1193,14 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                     )
                     continue
 
-                task_concurrency = simple_dag.get_task_special_arg(task_instance.task_id, 'task_concurrency')
+                task_concurrency = simple_dag.get_task_special_arg(
+                    task_instance.task_id,
+                    'task_concurrency')
                 if task_concurrency is not None:
-                    num_running = task_concurrency_map[((task_instance.dag_id, task_instance.task_id))]
+                    num_running = task_concurrency_map[
+                        ((task_instance.dag_id, task_instance.task_id))
+                    ]
+
                     if num_running >= task_concurrency:
                         self.log.info("Not executing %s since the task concurrency for"
                                       " this task has been reached.", task_instance)
@@ -1212,7 +1220,8 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
 
         task_instance_str = "\n\t".join(
             ["{}".format(x) for x in executable_tis])
-        self.log.info("Setting the follow tasks to queued state:\n\t%s", task_instance_str)
+        self.log.info(
+            "Setting the follow tasks to queued state:\n\t%s", task_instance_str)
         # so these dont expire on commit
         for ti in executable_tis:
             copy_dag_id = ti.dag_id
@@ -1254,7 +1263,9 @@ def _change_state_for_executable_task_instances(self, task_instances,
             .filter(or_(*filter_for_ti_state_change)))
 
         if None in acceptable_states:
-            ti_query = ti_query.filter(or_(TI.state == None, TI.state.in_(acceptable_states)))
+            ti_query = ti_query.filter(
+                or_(TI.state == None, TI.state.in_(acceptable_states)) # noqa E711
+            )
         else:
             ti_query = ti_query.filter(TI.state.in_(acceptable_states))
 
@@ -1600,7 +1611,8 @@ def processor_factory(file_path):
                     child.terminate()
                 # TODO: Remove magic number
                 timeout = 5
-                self.log.info("Waiting up to %s seconds for processes to exit...", timeout)
+                self.log.info(
+                    "Waiting up to %s seconds for processes to exit...", timeout)
                 try:
                     psutil.wait_procs(
                         child_processes, timeout=timeout,
@@ -1657,7 +1669,9 @@ def _execute_helper(self, processor_manager):
                 self.log.info("Searching for files in %s", self.subdir)
                 known_file_paths = list_py_file_paths(self.subdir)
                 last_dag_dir_refresh_time = timezone.utcnow()
-                self.log.info("There are %s files in %s", len(known_file_paths), self.subdir)
+                self.log.info(
+                    "There are %s files in %s", len(known_file_paths), self.subdir)
+
                 processor_manager.set_file_paths(known_file_paths)
 
                 self.log.debug("Removing old import errors")
@@ -1670,7 +1684,9 @@ def _execute_helper(self, processor_manager):
             if self.using_sqlite:
                 # For the sqlite case w/ 1 thread, wait until the processor
                 # is finished to avoid concurrent access to the DB.
-                self.log.debug("Waiting for processors to finish since we're using sqlite")
+                self.log.debug(
+                    "Waiting for processors to finish since we're using sqlite")
+
                 processor_manager.wait_until_finished()
 
             # Send tasks for execution if available
diff --git a/airflow/migrations/__init__.py b/airflow/migrations/__init__.py
index f0f8b68337da6..114d189da14ab 100644
--- a/airflow/migrations/__init__.py
+++ b/airflow/migrations/__init__.py
@@ -7,13 +7,12 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/airflow/migrations/env.py b/airflow/migrations/env.py
index 828cacf0e0fd6..97ebe4257f2c4 100644
--- a/airflow/migrations/env.py
+++ b/airflow/migrations/env.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py b/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
index 58517256949ab..6ee50aa94da81 100644
--- a/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
+++ b/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -39,4 +39,3 @@ def upgrade():
 
 def downgrade():
     op.drop_index('dag_id_state', table_name='dag_run')
-
diff --git a/airflow/migrations/versions/13eb55f81627_for_compatibility.py b/airflow/migrations/versions/13eb55f81627_for_compatibility.py
index a14e195bbefe1..b9e88bd01becd 100644
--- a/airflow/migrations/versions/13eb55f81627_for_compatibility.py
+++ b/airflow/migrations/versions/13eb55f81627_for_compatibility.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py b/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
index 47bdf13d672d3..3db0d41190408 100644
--- a/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
+++ b/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py b/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
index 57ee27aeb4bfb..aaf938a0355ee 100644
--- a/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
+++ b/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py b/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
index a0af7fa7ad6c2..79fcff454114a 100644
--- a/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
+++ b/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/211e584da130_add_ti_state_index.py b/airflow/migrations/versions/211e584da130_add_ti_state_index.py
index 93347a2649214..afc600d58aca1 100644
--- a/airflow/migrations/versions/211e584da130_add_ti_state_index.py
+++ b/airflow/migrations/versions/211e584da130_add_ti_state_index.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/2e541a1dcfed_task_duration.py b/airflow/migrations/versions/2e541a1dcfed_task_duration.py
index 7b540430a5dd0..6b24ef66e4ab2 100644
--- a/airflow/migrations/versions/2e541a1dcfed_task_duration.py
+++ b/airflow/migrations/versions/2e541a1dcfed_task_duration.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py b/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
index 03266679279f9..75db27cdb3a8c 100644
--- a/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
+++ b/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -41,4 +41,3 @@ def upgrade():
 
 def downgrade():
     op.rename_table('users', 'user')
-
diff --git a/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py b/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
index c101e4a477230..4f1364b971a57 100644
--- a/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
+++ b/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/40e67319e3a9_dagrun_config.py b/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
index ecfe58cfc3d1b..02ea51501c49f 100644
--- a/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
+++ b/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/4446e08588_dagrun_start_end.py b/airflow/migrations/versions/4446e08588_dagrun_start_end.py
index dc546f8c77750..101f2ad9055bf 100644
--- a/airflow/migrations/versions/4446e08588_dagrun_start_end.py
+++ b/airflow/migrations/versions/4446e08588_dagrun_start_end.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py b/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
index 80af57836771a..c3898e95969b2 100644
--- a/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
+++ b/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/502898887f84_adding_extra_to_log.py b/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
index f5cded7ea5776..333b18e8d200d 100644
--- a/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
+++ b/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/52d714495f0_job_id_indices.py b/airflow/migrations/versions/52d714495f0_job_id_indices.py
index 43893dba8a081..13f561cffb77f 100644
--- a/airflow/migrations/versions/52d714495f0_job_id_indices.py
+++ b/airflow/migrations/versions/52d714495f0_job_id_indices.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py b/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
index ad82c9378b2f1..d92db9f891b6b 100644
--- a/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
+++ b/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py b/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
index 5e2963f060665..e23a0a8b2f742 100644
--- a/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
+++ b/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py b/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
index be747383289a9..6dda5df43b146 100644
--- a/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
+++ b/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py b/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
index 47473e318d625..d6a4514ae2883 100644
--- a/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
+++ b/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py b/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
index 4c8bce9b471e7..b821cacedc400 100644
--- a/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
+++ b/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/__init__.py b/airflow/migrations/versions/__init__.py
index f0f8b68337da6..114d189da14ab 100644
--- a/airflow/migrations/versions/__init__.py
+++ b/airflow/migrations/versions/__init__.py
@@ -7,13 +7,12 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py b/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
index c780e5830dce6..a19eb58eb5c8d 100644
--- a/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
+++ b/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py b/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
index 84c54fad7157a..04cdc22d6cdab 100644
--- a/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
+++ b/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py b/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
index 5e06766182f6d..a02eea5519cc6 100644
--- a/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
+++ b/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -36,7 +36,7 @@
 
 
 def upgrade():
-    # There can be data truncation here as LargeBinary can be smaller than the pickle 
+    # There can be data truncation here as LargeBinary can be smaller than the pickle
     # type.
 
     # use batch_alter_table to support SQLite workaround
diff --git a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
index 3c56f0707b57b..68228f7219a87 100644
--- a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
+++ b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py b/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
index ff67b4fb16d3a..5ecb0d5c72357 100644
--- a/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
+++ b/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/e3a246e0dc1_current_schema.py b/airflow/migrations/versions/e3a246e0dc1_current_schema.py
index 6c63d0a9dd337..cfa4147dd925d 100644
--- a/airflow/migrations/versions/e3a246e0dc1_current_schema.py
+++ b/airflow/migrations/versions/e3a246e0dc1_current_schema.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py b/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
index 7c23d507127a2..3e3d40abc4384 100644
--- a/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
+++ b/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index 735f2de1e8c79..ad630701dec90 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -34,6 +34,7 @@
 
 log = LoggingMixin().log
 
+
 class AirflowPluginException(Exception):
     pass
 
@@ -107,6 +108,7 @@ def make_module(name, objects):
     module.__dict__.update((o.__name__, o) for o in objects)
     return module
 
+
 # Plugin components to integrate as modules
 operators_modules = []
 sensors_modules = []
diff --git a/airflow/settings.py b/airflow/settings.py
index 984c52ea5d206..9646f035a26be 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -46,7 +46,7 @@
         TIMEZONE = pendulum.local_timezone()
     else:
         TIMEZONE = pendulum.timezone(tz)
-except:
+except Exception:
     pass
 log.info("Configured default timezone %s" % TIMEZONE)
 
@@ -241,9 +241,9 @@ def configure_action_logging():
 
 
 try:
-    from airflow_local_settings import *
+    from airflow_local_settings import *  # noqa F403 F401
     log.info("Loaded airflow_local_settings.")
-except:
+except Exception:
     pass
 
 configure_logging()
diff --git a/airflow/utils/__init__.py b/airflow/utils/__init__.py
index cc4e12be8033a..e8e889c59b7a5 100644
--- a/airflow/utils/__init__.py
+++ b/airflow/utils/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/asciiart.py b/airflow/utils/asciiart.py
index faf796c18d4fd..952ebfe1e00c9 100644
--- a/airflow/utils/asciiart.py
+++ b/airflow/utils/asciiart.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/cli_action_loggers.py b/airflow/utils/cli_action_loggers.py
index e61642d30012c..8b8cda538fdd6 100644
--- a/airflow/utils/cli_action_loggers.py
+++ b/airflow/utils/cli_action_loggers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/compression.py b/airflow/utils/compression.py
index f6e923a15619f..2565299175bb0 100644
--- a/airflow/utils/compression.py
+++ b/airflow/utils/compression.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 43948837065e3..89e5701cf15bf 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/dates.py b/airflow/utils/dates.py
index c147a65430da2..216b2ed62667f 100644
--- a/airflow/utils/dates.py
+++ b/airflow/utils/dates.py
@@ -160,7 +160,7 @@ def round_time(dt, delta, start_date=timezone.make_aware(datetime.min)):
     # We first search an upper limit for i for which start_date + upper * delta
     # exceeds dt.
     upper = 1
-    while start_date + upper*delta < dt:
+    while start_date + upper * delta < dt:
         # To speed up finding an upper limit we grow this exponentially by a
         # factor of 2
         upper *= 2
@@ -177,20 +177,20 @@ def round_time(dt, delta, start_date=timezone.make_aware(datetime.min)):
         # Invariant: start + lower * delta < dt <= start + upper * delta
         # If start_date + (lower + 1)*delta exceeds dt, then either lower or
         # lower+1 has to be the solution we are searching for
-        if start_date + (lower + 1)*delta >= dt:
+        if start_date + (lower + 1) * delta >= dt:
             # Check if start_date + (lower + 1)*delta or
             # start_date + lower*delta is closer to dt and return the solution
             if (
                     (start_date + (lower + 1) * delta) - dt <=
                     dt - (start_date + lower * delta)):
-                return start_date + (lower + 1)*delta
+                return start_date + (lower + 1) * delta
             else:
                 return start_date + lower * delta
 
         # We intersect the interval and either replace the lower or upper
         # limit with the candidate
         candidate = lower + (upper - lower) // 2
-        if start_date + candidate*delta >= dt:
+        if start_date + candidate * delta >= dt:
             upper = candidate
         else:
             lower = candidate
@@ -209,11 +209,11 @@ def infer_time_unit(time_seconds_arr):
     if len(time_seconds_arr) == 0:
         return 'hours'
     max_time_seconds = max(time_seconds_arr)
-    if max_time_seconds <= 60*2:
+    if max_time_seconds <= 60 * 2:
         return 'seconds'
-    elif max_time_seconds <= 60*60*2:
+    elif max_time_seconds <= 60 * 60 * 2:
         return 'minutes'
-    elif max_time_seconds <= 24*60*60*2:
+    elif max_time_seconds <= 24 * 60 * 60 * 2:
         return 'hours'
     else:
         return 'days'
@@ -224,11 +224,11 @@ def scale_time_units(time_seconds_arr, unit):
     Convert an array of time durations in seconds to the specified time unit.
     """
     if unit == 'minutes':
-        return list(map(lambda x: x*1.0/60, time_seconds_arr))
+        return list(map(lambda x: x * 1.0 / 60, time_seconds_arr))
     elif unit == 'hours':
-        return list(map(lambda x: x*1.0/(60*60), time_seconds_arr))
+        return list(map(lambda x: x * 1.0 / (60 * 60), time_seconds_arr))
     elif unit == 'days':
-        return list(map(lambda x: x*1.0/(24*60*60), time_seconds_arr))
+        return list(map(lambda x: x * 1.0 / (24 * 60 * 60), time_seconds_arr))
     return time_seconds_arr
 
 
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index b5e0c49c61d33..93458c6f61a7b 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -43,7 +43,7 @@ def create_session():
         yield session
         session.expunge_all()
         session.commit()
-    except:
+    except Exception:
         session.rollback()
         raise
     finally:
diff --git a/airflow/utils/decorators.py b/airflow/utils/decorators.py
index 966d27e30aeae..f1f0ea9a425e9 100644
--- a/airflow/utils/decorators.py
+++ b/airflow/utils/decorators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/file.py b/airflow/utils/file.py
index 88938d422b3af..918375fe5e5b5 100644
--- a/airflow/utils/file.py
+++ b/airflow/utils/file.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 911890dc30ab5..db58e650d8ce9 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/json.py b/airflow/utils/json.py
index 434926f9d2be8..1767c523d6a3f 100644
--- a/airflow/utils/json.py
+++ b/airflow/utils/json.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/__init__.py b/airflow/utils/log/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/airflow/utils/log/__init__.py
+++ b/airflow/utils/log/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/es_task_handler.py b/airflow/utils/log/es_task_handler.py
index 04682318655b1..d74aabfbaead6 100644
--- a/airflow/utils/log/es_task_handler.py
+++ b/airflow/utils/log/es_task_handler.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/file_processor_handler.py b/airflow/utils/log/file_processor_handler.py
index 5e637440a1fda..f39dffe0c9333 100644
--- a/airflow/utils/log/file_processor_handler.py
+++ b/airflow/utils/log/file_processor_handler.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/file_task_handler.py b/airflow/utils/log/file_task_handler.py
index 627c8755707ef..113bd254ad0b2 100644
--- a/airflow/utils/log/file_task_handler.py
+++ b/airflow/utils/log/file_task_handler.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/logging_mixin.py b/airflow/utils/log/logging_mixin.py
index 85c03f77abe81..442fecd0363c8 100644
--- a/airflow/utils/log/logging_mixin.py
+++ b/airflow/utils/log/logging_mixin.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/log/s3_task_handler.py b/airflow/utils/log/s3_task_handler.py
index 07b9b3ec11e8b..bdbf94b6bbbbd 100644
--- a/airflow/utils/log/s3_task_handler.py
+++ b/airflow/utils/log/s3_task_handler.py
@@ -42,7 +42,7 @@ def _build_hook(self):
         try:
             from airflow.hooks.S3_hook import S3Hook
             return S3Hook(remote_conn_id)
-        except:
+        except Exception:
             self.log.error(
                 'Could not create an S3Hook with connection id "%s". '
                 'Please make sure that airflow[s3] is installed and '
@@ -139,7 +139,7 @@ def s3_read(self, remote_log_location, return_error=False):
         """
         try:
             return self.hook.read_key(remote_log_location)
-        except:
+        except Exception:
             msg = 'Could not read logs from {}'.format(remote_log_location)
             self.log.exception(msg)
             # return error if needed
@@ -169,5 +169,5 @@ def s3_write(self, log, remote_log_location, append=True):
                 replace=True,
                 encrypt=configuration.conf.getboolean('core', 'ENCRYPT_S3_LOGS'),
             )
-        except:
+        except Exception:
             self.log.exception('Could not write logs to %s', remote_log_location)
diff --git a/airflow/utils/net.py b/airflow/utils/net.py
index 03e8fde9c90cb..c435496ffc76a 100644
--- a/airflow/utils/net.py
+++ b/airflow/utils/net.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/operator_resources.py b/airflow/utils/operator_resources.py
index 47ff336991b95..649961340eb42 100644
--- a/airflow/utils/operator_resources.py
+++ b/airflow/utils/operator_resources.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index 46f4f86eface8..76c112785f852 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/state.py b/airflow/utils/state.py
index 70dbc5ca048e8..a351df07b9654 100644
--- a/airflow/utils/state.py
+++ b/airflow/utils/state.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/tests.py b/airflow/utils/tests.py
index 6f29ffc25b2eb..954ac35f786c6 100644
--- a/airflow/utils/tests.py
+++ b/airflow/utils/tests.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/timeout.py b/airflow/utils/timeout.py
index c5ca5e2f1724f..a86b9d357b5c6 100644
--- a/airflow/utils/timeout.py
+++ b/airflow/utils/timeout.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/trigger_rule.py b/airflow/utils/trigger_rule.py
index 7bad8ecb78ab5..ae51d6a30134d 100644
--- a/airflow/utils/trigger_rule.py
+++ b/airflow/utils/trigger_rule.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/utils/weight_rule.py b/airflow/utils/weight_rule.py
index 745cc76970cea..b920ef40229a1 100644
--- a/airflow/utils/weight_rule.py
+++ b/airflow/utils/weight_rule.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www/__init__.py b/airflow/www/__init__.py
index f0f8b68337da6..114d189da14ab 100644
--- a/airflow/www/__init__.py
+++ b/airflow/www/__init__.py
@@ -7,13 +7,12 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/airflow/www/api/__init__.py b/airflow/www/api/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/airflow/www/api/__init__.py
+++ b/airflow/www/api/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www/api/experimental/__init__.py b/airflow/www/api/experimental/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/airflow/www/api/experimental/__init__.py
+++ b/airflow/www/api/experimental/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www/blueprints.py b/airflow/www/blueprints.py
index ec719b96d2f6a..eb92837fe3b7e 100644
--- a/airflow/www/blueprints.py
+++ b/airflow/www/blueprints.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www/gunicorn_config.py b/airflow/www/gunicorn_config.py
index 7cf12c56c778e..db76b6de0c5af 100644
--- a/airflow/www/gunicorn_config.py
+++ b/airflow/www/gunicorn_config.py
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www/validators.py b/airflow/www/validators.py
index 6eee76a32a8ad..3db8b2850e0ad 100644
--- a/airflow/www/validators.py
+++ b/airflow/www/validators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -45,8 +45,11 @@ def __call__(self, form, field):
 
         if field.data < other.data:
             d = {
-                'other_label': hasattr(other, 'label') and other.label.text
-                               or self.fieldname,
+                'other_label': (
+                    hasattr(other, 'label') and
+                    other.label.text or
+                    self.fieldname
+                ),
                 'other_name': self.fieldname,
             }
             message = self.message
diff --git a/airflow/www/views.py b/airflow/www/views.py
index bdfaa525366c7..cfd46b871aa7e 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -206,7 +206,7 @@ def nobr_f(v, c, m, p):
 def label_link(v, c, m, p):
     try:
         default_params = ast.literal_eval(m.default_params)
-    except:
+    except Exception:
         default_params = {}
     url = url_for(
         'airflow.chart', chart_id=m.id, iteration_no=m.iteration_no,
@@ -404,9 +404,9 @@ def chart_data(self):
         # Processing templated fields
         try:
             args = ast.literal_eval(chart.default_params)
-            if type(args) is not type(dict()):
+            if not isinstance(args, dict):
                 raise AirflowException('Not a dict')
-        except:
+        except Exception:
             args = {}
             payload['error'] += (
                 "Default params is not valid, string has to evaluate as "
@@ -448,15 +448,15 @@ def chart_data(self):
         if not payload['error'] and len(df) == 0:
             payload['error'] += "Empty result set. "
         elif (
-                        not payload['error'] and
-                            chart.sql_layout == 'series' and
-                        chart.chart_type != "datatable" and
-                    len(df.columns) < 3):
+                not payload['error'] and
+                chart.sql_layout == 'series' and
+                chart.chart_type != "datatable" and
+                len(df.columns) < 3):
             payload['error'] += "SQL needs to return at least 3 columns. "
         elif (
-                    not payload['error'] and
-                        chart.sql_layout == 'columns' and
-                    len(df.columns) < 2):
+                not payload['error'] and
+                chart.sql_layout == 'columns' and
+                len(df.columns) < 2):
             payload['error'] += "SQL needs to return at least 2 columns. "
         elif not payload['error']:
             import numpy as np
@@ -622,13 +622,13 @@ def task_stats(self, session=None):
         # If no dag_run is active, return task instances from most recent dag_run.
         LastTI = (
             session.query(TI.dag_id.label('dag_id'), TI.state.label('state'))
-                .join(LastDagRun, and_(
+            .join(LastDagRun, and_(
                 LastDagRun.c.dag_id == TI.dag_id,
                 LastDagRun.c.execution_date == TI.execution_date))
         )
         RunningTI = (
             session.query(TI.dag_id.label('dag_id'), TI.state.label('state'))
-                .join(RunningDagRun, and_(
+            .join(RunningDagRun, and_(
                 RunningDagRun.c.dag_id == TI.dag_id,
                 RunningDagRun.c.execution_date == TI.execution_date))
         )
@@ -636,7 +636,7 @@ def task_stats(self, session=None):
         UnionTI = union_all(LastTI, RunningTI).alias('union_ti')
         qry = (
             session.query(UnionTI.c.dag_id, UnionTI.c.state, sqla.func.count())
-                .group_by(UnionTI.c.dag_id, UnionTI.c.state)
+            .group_by(UnionTI.c.dag_id, UnionTI.c.state)
         )
 
         data = {}
@@ -652,7 +652,7 @@ def task_stats(self, session=None):
             for state in State.task_states:
                 try:
                     count = data[dag.dag_id][state]
-                except:
+                except Exception:
                     count = 0
                 d = {
                     'state': state,
@@ -1540,13 +1540,13 @@ def duration(self, session=None):
         TF = models.TaskFail
         ti_fails = (
             session
-                .query(TF)
-                .filter(
+            .query(TF)
+            .filter(
                 TF.dag_id == dag.dag_id,
                 TF.execution_date >= min_date,
                 TF.execution_date <= base_date,
                 TF.task_id.in_([t.task_id for t in dag.tasks]))
-                .all()
+            .all()
         )
 
         fails_totals = defaultdict(int)
@@ -1892,7 +1892,7 @@ def variables(self, form):
                 return self.render(
                     'airflow/variables/{}.html'.format(form)
                 )
-        except:
+        except Exception:
             # prevent XSS
             form = escape(form)
             return ("Error: form airflow/variables/{}.html "
@@ -2463,7 +2463,7 @@ def action_varexport(self, ids, session=None):
             val = None
             try:
                 val = d.decode(var.val)
-            except:
+            except Exception:
                 val = var.val
             var_dict[var.key] = val
 
@@ -2802,7 +2802,7 @@ def alert_fernet_key(cls):
         fk = None
         try:
             fk = conf.get('core', 'fernet_key')
-        except:
+        except Exception:
             pass
         return fk is None
 
@@ -2814,10 +2814,10 @@ def is_secure(cls):
         """
         is_secure = False
         try:
-            import cryptography
+            import cryptography  # noqa F401
             conf.get('core', 'fernet_key')
             is_secure = True
-        except:
+        except Exception:
             pass
         return is_secure
 
diff --git a/airflow/www_rbac/__init__.py b/airflow/www_rbac/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/airflow/www_rbac/__init__.py
+++ b/airflow/www_rbac/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www_rbac/api/__init__.py b/airflow/www_rbac/api/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/airflow/www_rbac/api/__init__.py
+++ b/airflow/www_rbac/api/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www_rbac/api/experimental/__init__.py b/airflow/www_rbac/api/experimental/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/airflow/www_rbac/api/experimental/__init__.py
+++ b/airflow/www_rbac/api/experimental/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www_rbac/blueprints.py b/airflow/www_rbac/blueprints.py
index 35a5badb6ad1e..75bbb93aeadc9 100644
--- a/airflow/www_rbac/blueprints.py
+++ b/airflow/www_rbac/blueprints.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www_rbac/validators.py b/airflow/www_rbac/validators.py
index 7746e74338023..62b7db82523bc 100644
--- a/airflow/www_rbac/validators.py
+++ b/airflow/www_rbac/validators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/airflow/www_rbac/widgets.py b/airflow/www_rbac/widgets.py
index 3bca3869ce7ee..ea61d3ff94004 100644
--- a/airflow/www_rbac/widgets.py
+++ b/airflow/www_rbac/widgets.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

From 9541e7c48fc602f0acc5ffe3b1170eb0d7081f58 Mon Sep 17 00:00:00 2001
From: Dan Fowler <fowler.dn@gmail.com>
Date: Tue, 31 Jul 2018 13:25:04 -0700
Subject: [PATCH 088/808] [AIRFLOW-1104] Update jobs.py so Airflow does not
 over schedule tasks (#3568)

This change will prevent tasks from getting scheduled and queued over
the concurrency limits set for the dag
---
 airflow/jobs.py |  5 +----
 tests/jobs.py   | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 69471fd64f890..f2caeda137721 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1073,9 +1073,6 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         :type states: Tuple[State]
         :return: List[TaskInstance]
         """
-        # TODO(saguziel): Change this to include QUEUED, for concurrency
-        # purposes we may want to count queued tasks
-        states_to_count_as_running = [State.RUNNING]
         executable_tis = []
 
         # Get all the queued task instances from associated with scheduled
@@ -1121,6 +1118,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         for task_instance in task_instances_to_examine:
             pool_to_task_instances[task_instance.pool].append(task_instance)
 
+        states_to_count_as_running = [State.RUNNING, State.QUEUED]
         task_concurrency_map = self.__get_task_concurrency_map(
             states=states_to_count_as_running, session=session)
 
@@ -1171,7 +1169,6 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                 simple_dag = simple_dag_bag.get_dag(dag_id)
 
                 if dag_id not in dag_id_to_possibly_running_task_count:
-                    # TODO(saguziel): also check against QUEUED state, see AIRFLOW-1104
                     dag_id_to_possibly_running_task_count[dag_id] = \
                         DAG.get_num_task_instances(
                             dag_id,
diff --git a/tests/jobs.py b/tests/jobs.py
index 67717acc2b654..c6297af2459f8 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1575,6 +1575,39 @@ def test_find_executable_task_instances_concurrency(self):
 
         self.assertEqual(0, len(res))
 
+    def test_find_executable_task_instances_concurrency_queued(self):
+        dag_id = 'SchedulerJobTest.test_find_executable_task_instances_concurrency_queued'
+        dag = DAG(dag_id=dag_id, start_date=DEFAULT_DATE, concurrency=3)
+        task1 = DummyOperator(dag=dag, task_id='dummy1')
+        task2 = DummyOperator(dag=dag, task_id='dummy2')
+        task3 = DummyOperator(dag=dag, task_id='dummy3')
+        dagbag = self._make_simple_dag_bag([dag])
+
+        scheduler = SchedulerJob()
+        session = settings.Session()
+        dag_run = scheduler.create_dag_run(dag)
+
+        ti1 = TI(task1, dag_run.execution_date)
+        ti2 = TI(task2, dag_run.execution_date)
+        ti3 = TI(task3, dag_run.execution_date)
+        ti1.state = State.RUNNING
+        ti2.state = State.QUEUED
+        ti3.state = State.SCHEDULED
+
+        session.merge(ti1)
+        session.merge(ti2)
+        session.merge(ti3)
+
+        session.commit()
+
+        res = scheduler._find_executable_task_instances(
+            dagbag,
+            states=[State.SCHEDULED],
+            session=session)
+
+        self.assertEqual(1, len(res))
+        self.assertEqual(res[0].key, ti3.key)
+
     def test_find_executable_task_instances_task_concurrency(self):
         dag_id = 'SchedulerJobTest.test_find_executable_task_instances_task_concurrency'
         task_id_1 = 'dummy'

From 630b1c13f6363a2199165eaece9fae11d9f9d559 Mon Sep 17 00:00:00 2001
From: Yingbo Wang <ybwang@gmail.com>
Date: Wed, 3 Oct 2018 06:32:55 -0700
Subject: [PATCH 089/808] [AIRFLOW-2951] Update dag_run table end_date when
 state change (#3990)

The existing airflow only change dag_run table end_date value when
a user teminate a dag in web UI. The end_date will not be updated
if airflow detected a dag finished and updated its state.

This commit add end_date update in DagRun's set_state function to
make up tho problem mentioned above.
---
 airflow/models.py |  10 ++--
 tests/models.py   | 118 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 124 insertions(+), 4 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 8fc259d1b5a29..428923ff9e73f 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4845,6 +4845,8 @@ def get_state(self):
     def set_state(self, state):
         if self._state != state:
             self._state = state
+            self.end_date = timezone.utcnow() if self._state in State.finished() else None
+
             if self.dag_id is not None:
                 # FIXME: Due to the scoped_session factor we we don't get a clean
                 # session here, so something really weird goes on:
@@ -5068,7 +5070,7 @@ def update_state(self, session=None):
             if (not unfinished_tasks and
                     any(r.state in (State.FAILED, State.UPSTREAM_FAILED) for r in roots)):
                 self.log.info('Marking run %s failed', self)
-                self.state = State.FAILED
+                self.set_state(State.FAILED)
                 dag.handle_callback(self, success=False, reason='task_failure',
                                     session=session)
 
@@ -5076,20 +5078,20 @@ def update_state(self, session=None):
             elif not unfinished_tasks and all(r.state in (State.SUCCESS, State.SKIPPED)
                                               for r in roots):
                 self.log.info('Marking run %s successful', self)
-                self.state = State.SUCCESS
+                self.set_state(State.SUCCESS)
                 dag.handle_callback(self, success=True, reason='success', session=session)
 
             # if *all tasks* are deadlocked, the run failed
             elif (unfinished_tasks and none_depends_on_past and
                   none_task_concurrency and no_dependencies_met):
                 self.log.info('Deadlock; marking run %s failed', self)
-                self.state = State.FAILED
+                self.set_state(State.FAILED)
                 dag.handle_callback(self, success=False, reason='all_tasks_deadlocked',
                                     session=session)
 
             # finally, if the roots aren't done, the dag is still running
             else:
-                self.state = State.RUNNING
+                self.set_state(State.RUNNING)
 
         # todo: determine we want to use with_for_update to make sure to lock the run
         session.merge(self)
diff --git a/tests/models.py b/tests/models.py
index 60aee3c84fcb1..55fa41bd90bab 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -915,6 +915,124 @@ def on_failure_callable(context):
         updated_dag_state = dag_run.update_state()
         self.assertEqual(State.FAILED, updated_dag_state)
 
+    def test_dagrun_set_state_end_date(self):
+        session = settings.Session()
+
+        dag = DAG(
+            'test_dagrun_set_state_end_date',
+            start_date=DEFAULT_DATE,
+            default_args={'owner': 'owner1'})
+
+        dag.clear()
+
+        now = timezone.utcnow()
+        dr = dag.create_dagrun(run_id='test_dagrun_set_state_end_date',
+                               state=State.RUNNING,
+                               execution_date=now,
+                               start_date=now)
+
+        # Initial end_date should be NULL
+        # State.SUCCESS and State.FAILED are all ending state and should set end_date
+        # State.RUNNING set end_date back to NULL
+        session.add(dr)
+        session.commit()
+        self.assertIsNone(dr.end_date)
+
+        dr.set_state(State.SUCCESS)
+        session.merge(dr)
+        session.commit()
+
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_set_state_end_date'
+        ).one()
+        self.assertIsNotNone(dr_database.end_date)
+        self.assertEqual(dr.end_date, dr_database.end_date)
+
+        dr.set_state(State.RUNNING)
+        session.merge(dr)
+        session.commit()
+
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_set_state_end_date'
+        ).one()
+
+        self.assertIsNone(dr_database.end_date)
+
+        dr.set_state(State.FAILED)
+        session.merge(dr)
+        session.commit()
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_set_state_end_date'
+        ).one()
+
+        self.assertIsNotNone(dr_database.end_date)
+        self.assertEqual(dr.end_date, dr_database.end_date)
+
+    def test_dagrun_update_state_end_date(self):
+        session = settings.Session()
+
+        dag = DAG(
+            'test_dagrun_update_state_end_date',
+            start_date=DEFAULT_DATE,
+            default_args={'owner': 'owner1'})
+
+        # A -> B
+        with dag:
+            op1 = DummyOperator(task_id='A')
+            op2 = DummyOperator(task_id='B')
+            op1.set_upstream(op2)
+
+        dag.clear()
+
+        now = timezone.utcnow()
+        dr = dag.create_dagrun(run_id='test_dagrun_update_state_end_date',
+                               state=State.RUNNING,
+                               execution_date=now,
+                               start_date=now)
+
+        # Initial end_date should be NULL
+        # State.SUCCESS and State.FAILED are all ending state and should set end_date
+        # State.RUNNING set end_date back to NULL
+        session.merge(dr)
+        session.commit()
+        self.assertIsNone(dr.end_date)
+
+        ti_op1 = dr.get_task_instance(task_id=op1.task_id)
+        ti_op1.set_state(state=State.SUCCESS, session=session)
+        ti_op2 = dr.get_task_instance(task_id=op2.task_id)
+        ti_op2.set_state(state=State.SUCCESS, session=session)
+
+        dr.update_state()
+
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_update_state_end_date'
+        ).one()
+        self.assertIsNotNone(dr_database.end_date)
+        self.assertEqual(dr.end_date, dr_database.end_date)
+
+        ti_op1.set_state(state=State.RUNNING, session=session)
+        ti_op2.set_state(state=State.RUNNING, session=session)
+        dr.update_state()
+
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_update_state_end_date'
+        ).one()
+
+        self.assertEqual(dr._state, State.RUNNING)
+        self.assertIsNone(dr.end_date)
+        self.assertIsNone(dr_database.end_date)
+
+        ti_op1.set_state(state=State.FAILED, session=session)
+        ti_op2.set_state(state=State.FAILED, session=session)
+        dr.update_state()
+
+        dr_database = session.query(DagRun).filter(
+            DagRun.run_id == 'test_dagrun_update_state_end_date'
+        ).one()
+
+        self.assertIsNotNone(dr_database.end_date)
+        self.assertEqual(dr.end_date, dr_database.end_date)
+
     def test_get_task_instance_on_empty_dagrun(self):
         """
         Make sure that a proper value is returned when a dagrun has no task instances

From 3dfb5b8c2dfe63576b2d2b848d7a4aef2d58efab Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 8 Aug 2018 09:07:43 +0800
Subject: [PATCH 090/808] [AIRFLOW-2855] Check Cron Expression Validity in
 DagBag.process_file() (#3698)

A DAG can be imported as a .py script properly,
but the Cron expression inside as "schedule_interval" may be
invalid, like "0 100 * * *".

This commit helps check the validity of Cron expression in DAG
files (.py) and packaged DAG files (.zip), and help show
exception messages in web UI by add these exceptions into
metadata "import_error".
---
 airflow/models.py                    |  14 ++++++++++-
 tests/dags/test_invalid_cron.py      |  35 +++++++++++++++++++++++++++
 tests/dags/test_zip_invalid_cron.zip | Bin 0 -> 1389 bytes
 tests/models.py                      |  15 +++++++++++-
 4 files changed, 62 insertions(+), 2 deletions(-)
 create mode 100755 tests/dags/test_invalid_cron.py
 create mode 100644 tests/dags/test_zip_invalid_cron.zip

diff --git a/airflow/models.py b/airflow/models.py
index 428923ff9e73f..0207ac25252dc 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -61,7 +61,9 @@
 from sqlalchemy.ext.declarative import declarative_base, declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
 
-from croniter import croniter
+from croniter import (
+    croniter, CroniterBadCronError, CroniterBadDateError, CroniterNotAlphaError
+)
 import six
 
 from airflow import settings, utils
@@ -413,8 +415,18 @@ def process_file(self, filepath, only_if_updated=True, safe_mode=True):
                     try:
                         dag.is_subdag = False
                         self.bag_dag(dag, parent_dag=dag, root_dag=dag)
+                        if isinstance(dag._schedule_interval, six.string_types):
+                            croniter(dag._schedule_interval)
                         found_dags.append(dag)
                         found_dags += dag.subdags
+                    except (CroniterBadCronError,
+                            CroniterBadDateError,
+                            CroniterNotAlphaError) as cron_e:
+                        self.log.exception("Failed to bag_dag: %s", dag.full_filepath)
+                        self.import_errors[dag.full_filepath] = \
+                            "Invalid Cron expression: " + str(cron_e)
+                        self.file_last_changed[dag.full_filepath] = \
+                            file_last_changed_on_disk
                     except AirflowDagCycleException as cycle_exception:
                         self.log.exception("Failed to bag_dag: %s", dag.full_filepath)
                         self.import_errors[dag.full_filepath] = str(cycle_exception)
diff --git a/tests/dags/test_invalid_cron.py b/tests/dags/test_invalid_cron.py
new file mode 100755
index 0000000000000..51a0e43cb500a
--- /dev/null
+++ b/tests/dags/test_invalid_cron.py
@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import DAG
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.utils.timezone import datetime
+
+# The schedule_interval specified here is an INVALID
+# Cron expression. This invalid DAG will be used to
+# test whether dagbag.process_file() can identify
+# invalid Cron expression.
+dag1 = DAG(
+    dag_id='test_invalid_cron',
+    start_date=datetime(2015, 1, 1),
+    schedule_interval="0 100 * * *")
+dag1_task1 = DummyOperator(
+    task_id='task1',
+    dag=dag1,
+    owner='airflow')
diff --git a/tests/dags/test_zip_invalid_cron.zip b/tests/dags/test_zip_invalid_cron.zip
new file mode 100644
index 0000000000000000000000000000000000000000..fe45153abe85a1b22026bc3f3c36b09d6b06d585
GIT binary patch
literal 1389
zcmWIWW@Zs#-~hr?ovgkLNI--^fT1L{xFkL^uPiYqGbKK`C_hiHpfWUqhk@llTJ-Dv
zY0));&!?w`#OB{}5UBaSK4K!f0u%E@t<aSf1<o03-4u?h1kSsVIRC8Xx4G5jea`i@
z&;MMU5TdZ~_U)T<XWo6>v}}5CSEy1-neSBJ<?*pcc7M=&;ddlPYTks<l>RwQlaBuA
z49Ut~X1O+0RXDA6k_p$MuQLjs%$o9qLEE?0DQL}-tB(RASw3x3*yvLnSCHB3FH(3f
z<bF>1!?U_emC8T3%n)n)wsnL15)S9Bm-MGB67m*$D7AS`i_3zH42I>E$F>MJAA9QA
z{U*cn>ZI&q5!GF9=k#UV4K~cZyH2xYUdYvx7QuHU4Hvp!DJ)w5$Fg?<!<hxUWqS6T
zK4_Zjq2)dG;rp$f`;YF~@_;MKbtbo3GW)wJe_t~+osZ=$-N5s5%|%BoTYu#=#$(f8
zWaL)b&c0guc5~aB^(AJnubzFE@KSBp+@^x=iV2qHY-WGgwX|(-7v3n;l2pcUcFxtj
zg0nTVHa0u1eYoX}8pG_mPtPw`mak4{zxbT<L-)>$JWU;kG92zVYxJmn5qVdaCtvnO
z<j#He*|8PU7r)KR+crCN2lsaAIoCvT<}v;e%?lHL^nt7QNA$|MOczAXdCr^jHsJh$
zwI0@T!Ji_QD7Bf)4Apr&Wo7ufrMD+cdhH}(9>CnjS++=ETcir}llomX=e@UTb#Tso
zw(1-A)DL$o#Jr-TSnciNw5O!ssCuj(8aU_M-=FdaT(`%5P~Ngh$$XzE>;LBCSC~Is
z+0k7ocVnlmnM8Te(;EFHPk)K#FAV0soEU1%p{9AqhOPV|*8=I@$PzZErTtnSf<gfk
zEm$K?*equ*zy12z`+F?r(_Sg(pYe|<OPCp-CA#>?y|v#md<<uGu$+%vqOS0(YX0s@
z2mOqfzj|!etXsWJ{AAIKs5jPE?AWp_GT-&4-g-CpP3rpE64UsanHQMu7f%0jv*l@m
zU-!>BdUw+e@^-z`HP-iiUwk=Q?A@xR4~uqPW6+h|U~5{ha5~X^-oqQexdXh}Ij+|}
zRJ+c^z+lG8zz_h;C|uy|!P|wJQ8<AaB|hHQ(b+#ZLLZbnvVge*gh9Cjqz!xil1J92
z7f(!9OHL3?PESZm_~7dk_JKdFBcOq4f&{a=fHdPrT?MvJl9du2Onr)qjsjv4#~BsA
zIR+nM5fx8JnBaBp{8euqjT4?%PkZX<Y3lm<dV1=3hVpT=t=h|Q#Ege$5l3n3(oWaT
zO4XT_D|!0AFL7-a5#>Dos`-UeEi*H>bM|EwW8-4w(<<4|dlvn<6OygYY%Cn^?(7`P
zt!|tgD_oo|9?Pw4>>eBLZqCgeY_80mt}e_53^R6)=<QMr8-U@)!w3pPMkY~aL~tO7
zuLuJVtnhJo+X!M}4-pP{;R7)ZSDYYB`|GI5%zzw29Pk)IcM!5;<&hk;q%i^62wbs+
T>^4?5kRO<V@D-5GWdZR3t7;WI

literal 0
HcmV?d00001

diff --git a/tests/models.py b/tests/models.py
index 55fa41bd90bab..5b31a634f4a7f 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -56,7 +56,7 @@
 from airflow.utils.trigger_rule import TriggerRule
 from mock import patch, ANY
 from parameterized import parameterized
-from tempfile import NamedTemporaryFile
+from tempfile import mkdtemp, NamedTemporaryFile
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 TEST_DAGS_FOLDER = os.path.join(
@@ -1175,6 +1175,19 @@ def test_zip(self):
         dagbag.process_file(os.path.join(TEST_DAGS_FOLDER, "test_zip.zip"))
         self.assertTrue(dagbag.get_dag("test_zip_dag"))
 
+    def test_process_file_cron_validity_check(self):
+        """
+        test if an invalid cron expression
+        as schedule interval can be identified
+        """
+        invalid_dag_files = ["test_invalid_cron.py", "test_zip_invalid_cron.zip"]
+        dagbag = models.DagBag(dag_folder=mkdtemp())
+
+        self.assertEqual(len(dagbag.import_errors), 0)
+        for d in invalid_dag_files:
+            dagbag.process_file(os.path.join(TEST_DAGS_FOLDER, d))
+        self.assertEqual(len(dagbag.import_errors), len(invalid_dag_files))
+
     @patch.object(DagModel,'get_current')
     def test_get_dag_without_refresh(self, mock_dagmodel):
         """

From 4f756f89532449e3dc41014cf317501be55f1fc0 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 19 Aug 2018 22:44:56 +0800
Subject: [PATCH 091/808] [AIRFLOW-2904] Remove unnecessary line in
 celery_executor (#3753)

Clean an unnecessary line in celery_executor.py
---
 airflow/executors/celery_executor.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 6ada005ab77d2..7916eda122c57 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -31,8 +31,6 @@
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.module_loading import import_string
 
-PARALLELISM = configuration.conf.get('core', 'PARALLELISM')
-
 '''
 To start the celery worker, run the command:
 airflow worker

From e098dec8050b5f82e8980cb60640fc16eac77f37 Mon Sep 17 00:00:00 2001
From: Victor Jimenez <betabandido@gmail.com>
Date: Wed, 29 Aug 2018 09:26:29 +0200
Subject: [PATCH 092/808] [AIRFLOW-2709] Improve error handling in Databricks
 hook (#3570)

* Use float for default value
* Use status code to determine whether an error is retryable
* Fix wrong type in assertion
* Fix style to prevent lines from exceeding 90 characters
* Fix wrong way of checking exception type
---
 airflow/contrib/hooks/databricks_hook.py      |  49 ++++--
 .../contrib/operators/databricks_operator.py  |   8 +-
 tests/contrib/hooks/test_databricks_hook.py   | 144 ++++++++++++++----
 .../operators/test_databricks_operator.py     |  10 +-
 4 files changed, 162 insertions(+), 49 deletions(-)

diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index 2e5f1399b4765..802b8efb87842 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -24,6 +24,7 @@
 from airflow.hooks.base_hook import BaseHook
 from requests import exceptions as requests_exceptions
 from requests.auth import AuthBase
+from time import sleep
 
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -47,7 +48,8 @@ def __init__(
             self,
             databricks_conn_id='databricks_default',
             timeout_seconds=180,
-            retry_limit=3):
+            retry_limit=3,
+            retry_delay=1.0):
         """
         :param databricks_conn_id: The name of the databricks connection to use.
         :type databricks_conn_id: string
@@ -57,6 +59,9 @@ def __init__(
         :param retry_limit: The number of times to retry the connection in case of
             service outages.
         :type retry_limit: int
+        :param retry_delay: The number of seconds to wait between retries (it
+            might be a floating point number).
+        :type retry_delay: float
         """
         self.databricks_conn_id = databricks_conn_id
         self.databricks_conn = self.get_connection(databricks_conn_id)
@@ -64,6 +69,7 @@ def __init__(
         if retry_limit < 1:
             raise ValueError('Retry limit must be greater than equal to 1')
         self.retry_limit = retry_limit
+        self.retry_delay = retry_delay
 
     def _parse_host(self, host):
         """
@@ -118,7 +124,8 @@ def _do_api_call(self, endpoint_info, json):
         else:
             raise AirflowException('Unexpected HTTP Method: ' + method)
 
-        for attempt_num in range(1, self.retry_limit + 1):
+        attempt_num = 1
+        while True:
             try:
                 response = request_func(
                     url,
@@ -126,21 +133,29 @@ def _do_api_call(self, endpoint_info, json):
                     auth=auth,
                     headers=USER_AGENT_HEADER,
                     timeout=self.timeout_seconds)
-                if response.status_code == requests.codes.ok:
-                    return response.json()
-                else:
+                response.raise_for_status()
+                return response.json()
+            except requests_exceptions.RequestException as e:
+                if not _retryable_error(e):
                     # In this case, the user probably made a mistake.
                     # Don't retry.
                     raise AirflowException('Response: {0}, Status Code: {1}'.format(
-                        response.content, response.status_code))
-            except (requests_exceptions.ConnectionError,
-                    requests_exceptions.Timeout) as e:
-                self.log.error(
-                    'Attempt %s API Request to Databricks failed with reason: %s',
-                    attempt_num, e
-                )
-        raise AirflowException(('API requests to Databricks failed {} times. ' +
-                               'Giving up.').format(self.retry_limit))
+                        e.response.content, e.response.status_code))
+
+                self._log_request_error(attempt_num, e)
+
+            if attempt_num == self.retry_limit:
+                raise AirflowException(('API requests to Databricks failed {} times. ' +
+                                        'Giving up.').format(self.retry_limit))
+
+            attempt_num += 1
+            sleep(self.retry_delay)
+
+    def _log_request_error(self, attempt_num, error):
+        self.log.error(
+            'Attempt %s API Request to Databricks failed with reason: %s',
+            attempt_num, error
+        )
 
     def submit_run(self, json):
         """
@@ -174,6 +189,12 @@ def cancel_run(self, run_id):
         self._do_api_call(CANCEL_RUN_ENDPOINT, json)
 
 
+def _retryable_error(exception):
+    return isinstance(exception, requests_exceptions.ConnectionError) \
+        or isinstance(exception, requests_exceptions.Timeout) \
+        or exception.response is not None and exception.response.status_code >= 500
+
+
 RUN_LIFE_CYCLE_STATES = [
     'PENDING',
     'RUNNING',
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 7b8d522dba85b..3245a99256502 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -146,6 +146,9 @@ class DatabricksSubmitRunOperator(BaseOperator):
     :param databricks_retry_limit: Amount of times retry if the Databricks backend is
         unreachable. Its value must be greater than or equal to 1.
     :type databricks_retry_limit: int
+    :param databricks_retry_delay: Number of seconds to wait between retries (it
+            might be a floating point number).
+    :type databricks_retry_delay: float
     :param do_xcom_push: Whether we should push run_id and run_page_url to xcom.
     :type do_xcom_push: boolean
     """
@@ -168,6 +171,7 @@ def __init__(
             databricks_conn_id='databricks_default',
             polling_period_seconds=30,
             databricks_retry_limit=3,
+            databricks_retry_delay=1,
             do_xcom_push=False,
             **kwargs):
         """
@@ -178,6 +182,7 @@ def __init__(
         self.databricks_conn_id = databricks_conn_id
         self.polling_period_seconds = polling_period_seconds
         self.databricks_retry_limit = databricks_retry_limit
+        self.databricks_retry_delay = databricks_retry_delay
         if spark_jar_task is not None:
             self.json['spark_jar_task'] = spark_jar_task
         if notebook_task is not None:
@@ -232,7 +237,8 @@ def _log_run_page_url(self, url):
     def get_hook(self):
         return DatabricksHook(
             self.databricks_conn_id,
-            retry_limit=self.databricks_retry_limit)
+            retry_limit=self.databricks_retry_limit,
+            retry_delay=self.databricks_retry_delay)
 
     def execute(self, context):
         hook = self.get_hook()
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index aca8dd96004b4..a022431899b4d 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -18,15 +18,21 @@
 # under the License.
 #
 
+import itertools
 import json
 import unittest
 
+from requests import exceptions as requests_exceptions
+
 from airflow import __version__
-from airflow.contrib.hooks.databricks_hook import DatabricksHook, RunState, SUBMIT_RUN_ENDPOINT, _TokenAuth
+from airflow.contrib.hooks.databricks_hook import (
+    DatabricksHook,
+    RunState,
+    SUBMIT_RUN_ENDPOINT
+)
 from airflow.exceptions import AirflowException
 from airflow.models import Connection
 from airflow.utils import db
-from requests import exceptions as requests_exceptions
 
 try:
     from unittest import mock
@@ -79,12 +85,48 @@ def get_run_endpoint(host):
     """
     return 'https://{}/api/2.0/jobs/runs/get'.format(host)
 
+
 def cancel_run_endpoint(host):
     """
     Utility function to generate the get run endpoint given the host.
     """
     return 'https://{}/api/2.0/jobs/runs/cancel'.format(host)
 
+
+def create_valid_response_mock(content):
+    response = mock.MagicMock()
+    response.json.return_value = content
+    return response
+
+
+def create_post_side_effect(exception, status_code=500):
+    if exception != requests_exceptions.HTTPError:
+        return exception()
+    else:
+        response = mock.MagicMock()
+        response.status_code = status_code
+        response.raise_for_status.side_effect = exception(response=response)
+        return response
+
+
+def setup_mock_requests(
+        mock_requests,
+        exception,
+        status_code=500,
+        error_count=None,
+        response_content=None):
+
+    side_effect = create_post_side_effect(exception, status_code)
+
+    if error_count is None:
+        # POST requests will fail indefinitely
+        mock_requests.post.side_effect = itertools.repeat(side_effect)
+    else:
+        # POST requests will fail 'error_count' times, and then they will succeed (once)
+        mock_requests.post.side_effect = \
+            [side_effect] * error_count + [create_valid_response_mock(response_content)]
+
+
 class DatabricksHookTest(unittest.TestCase):
     """
     Tests for DatabricksHook.
@@ -99,7 +141,7 @@ def setUp(self, session=None):
         conn.password = PASSWORD
         session.commit()
 
-        self.hook = DatabricksHook()
+        self.hook = DatabricksHook(retry_delay=0)
 
     def test_parse_host_with_proper_host(self):
         host = self.hook._parse_host(HOST)
@@ -111,34 +153,85 @@ def test_parse_host_with_scheme(self):
 
     def test_init_bad_retry_limit(self):
         with self.assertRaises(ValueError):
-            DatabricksHook(retry_limit = 0)
-
-    @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
-    def test_do_api_call_with_error_retry(self, mock_requests):
-        for exception in [requests_exceptions.ConnectionError, requests_exceptions.Timeout]:
-            with mock.patch.object(self.hook.log, 'error') as mock_errors:
-                mock_requests.reset_mock()
-                mock_requests.post.side_effect = exception()
+            DatabricksHook(retry_limit=0)
+
+    def test_do_api_call_retries_with_retryable_error(self):
+        for exception in [
+                requests_exceptions.ConnectionError,
+                requests_exceptions.SSLError,
+                requests_exceptions.Timeout,
+                requests_exceptions.ConnectTimeout,
+                requests_exceptions.HTTPError]:
+            with mock.patch(
+                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
+                    mock.patch.object(self.hook.log, 'error') as mock_errors:
+                setup_mock_requests(mock_requests, exception)
 
                 with self.assertRaises(AirflowException):
                     self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
 
-                self.assertEquals(len(mock_errors.mock_calls), self.hook.retry_limit)
+                self.assertEquals(mock_errors.call_count, self.hook.retry_limit)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
-    def test_do_api_call_with_bad_status_code(self, mock_requests):
-        mock_requests.codes.ok = 200
-        status_code_mock = mock.PropertyMock(return_value=500)
-        type(mock_requests.post.return_value).status_code = status_code_mock
-        with self.assertRaises(AirflowException):
-            self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+    def test_do_api_call_does_not_retry_with_non_retryable_error(self, mock_requests):
+        setup_mock_requests(
+            mock_requests, requests_exceptions.HTTPError, status_code=400
+        )
+
+        with mock.patch.object(self.hook.log, 'error') as mock_errors:
+            with self.assertRaises(AirflowException):
+                self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+
+            mock_errors.assert_not_called()
+
+    def test_do_api_call_succeeds_after_retrying(self):
+        for exception in [
+                requests_exceptions.ConnectionError,
+                requests_exceptions.SSLError,
+                requests_exceptions.Timeout,
+                requests_exceptions.ConnectTimeout,
+                requests_exceptions.HTTPError]:
+            with mock.patch(
+                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
+                    mock.patch.object(self.hook.log, 'error') as mock_errors:
+                setup_mock_requests(
+                    mock_requests,
+                    exception,
+                    error_count=2,
+                    response_content={'run_id': '1'}
+                )
+
+                response = self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+
+                self.assertEquals(mock_errors.call_count, 2)
+                self.assertEquals(response, {'run_id': '1'})
+
+    @mock.patch('airflow.contrib.hooks.databricks_hook.sleep')
+    def test_do_api_call_waits_between_retries(self, mock_sleep):
+        retry_delay = 5
+        self.hook = DatabricksHook(retry_delay=retry_delay)
+
+        for exception in [
+                requests_exceptions.ConnectionError,
+                requests_exceptions.SSLError,
+                requests_exceptions.Timeout,
+                requests_exceptions.ConnectTimeout,
+                requests_exceptions.HTTPError]:
+            with mock.patch(
+                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
+                    mock.patch.object(self.hook.log, 'error'):
+                mock_sleep.reset_mock()
+                setup_mock_requests(mock_requests, exception)
+
+                with self.assertRaises(AirflowException):
+                    self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+
+                self.assertEquals(len(mock_sleep.mock_calls), self.hook.retry_limit - 1)
+                mock_sleep.assert_called_with(retry_delay)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_submit_run(self, mock_requests):
-        mock_requests.codes.ok = 200
         mock_requests.post.return_value.json.return_value = {'run_id': '1'}
-        status_code_mock = mock.PropertyMock(return_value=200)
-        type(mock_requests.post.return_value).status_code = status_code_mock
         json = {
           'notebook_task': NOTEBOOK_TASK,
           'new_cluster': NEW_CLUSTER
@@ -158,10 +251,7 @@ def test_submit_run(self, mock_requests):
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_get_run_page_url(self, mock_requests):
-        mock_requests.codes.ok = 200
         mock_requests.get.return_value.json.return_value = GET_RUN_RESPONSE
-        status_code_mock = mock.PropertyMock(return_value=200)
-        type(mock_requests.get.return_value).status_code = status_code_mock
 
         run_page_url = self.hook.get_run_page_url(RUN_ID)
 
@@ -175,10 +265,7 @@ def test_get_run_page_url(self, mock_requests):
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_get_run_state(self, mock_requests):
-        mock_requests.codes.ok = 200
         mock_requests.get.return_value.json.return_value = GET_RUN_RESPONSE
-        status_code_mock = mock.PropertyMock(return_value=200)
-        type(mock_requests.get.return_value).status_code = status_code_mock
 
         run_state = self.hook.get_run_state(RUN_ID)
 
@@ -195,10 +282,7 @@ def test_get_run_state(self, mock_requests):
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_cancel_run(self, mock_requests):
-        mock_requests.codes.ok = 200
         mock_requests.post.return_value.json.return_value = GET_RUN_RESPONSE
-        status_code_mock = mock.PropertyMock(return_value=200)
-        type(mock_requests.post.return_value).status_code = status_code_mock
 
         self.hook.cancel_run(RUN_ID)
 
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index f77da2ec18eda..afe1a92f28d9e 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -190,8 +190,9 @@ def test_exec_success(self, db_mock_class):
           'run_name': TASK_ID
         })
         db_mock_class.assert_called_once_with(
-                DEFAULT_CONN_ID,
-                retry_limit=op.databricks_retry_limit)
+            DEFAULT_CONN_ID,
+            retry_limit=op.databricks_retry_limit,
+            retry_delay=op.databricks_retry_delay)
         db_mock.submit_run.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
@@ -220,8 +221,9 @@ def test_exec_failure(self, db_mock_class):
           'run_name': TASK_ID,
         })
         db_mock_class.assert_called_once_with(
-                DEFAULT_CONN_ID,
-                retry_limit=op.databricks_retry_limit)
+            DEFAULT_CONN_ID,
+            retry_limit=op.databricks_retry_limit,
+            retry_delay=op.databricks_retry_delay)
         db_mock.submit_run.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)

From a3ecc0ac3cafc9440e875a61d9ac670079b9d2fa Mon Sep 17 00:00:00 2001
From: wmorris75 <waynemorris75@gmail.com>
Date: Fri, 31 Aug 2018 03:33:22 -0400
Subject: [PATCH 093/808] [AIRFLOW-2974] Extended Databricks hook with clusters
 operation (#3817)

Add hooks for:
- cluster start,
- restart,
- terminate.
Add unit tests for the added hooks.
Add hooks for cluster start, restart and terminate.
Add unit tests for the added hooks.
Add cluster_id variable for performing cluster operation tests.
---
 airflow/contrib/hooks/databricks_hook.py    | 12 ++++
 setup.cfg                                   |  2 +-
 tests/contrib/hooks/test_databricks_hook.py | 70 +++++++++++++++++++++
 3 files changed, 83 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index 802b8efb87842..4e05ddb0b1af4 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -33,6 +33,9 @@
 except ImportError:
     import urlparse
 
+RESTART_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/restart")
+START_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/start")
+TERMINATE_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/delete")
 
 SUBMIT_RUN_ENDPOINT = ('POST', 'api/2.0/jobs/runs/submit')
 GET_RUN_ENDPOINT = ('GET', 'api/2.0/jobs/runs/get')
@@ -188,6 +191,15 @@ def cancel_run(self, run_id):
         json = {'run_id': run_id}
         self._do_api_call(CANCEL_RUN_ENDPOINT, json)
 
+    def restart_cluster(self, json):
+        self._do_api_call(RESTART_CLUSTER_ENDPOINT, json)
+
+    def start_cluster(self, json):
+        self._do_api_call(START_CLUSTER_ENDPOINT, json)
+
+    def terminate_cluster(self, json):
+        self._do_api_call(TERMINATE_CLUSTER_ENDPOINT, json)
+
 
 def _retryable_error(exception):
     return isinstance(exception, requests_exceptions.ConnectionError) \
diff --git a/setup.cfg b/setup.cfg
index 622cc1303a173..881fe0107d9b2 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -14,6 +14,7 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+
 [metadata]
 name = Airflow
 summary = Airflow is a system to programmatically author, schedule and monitor data pipelines.
@@ -34,4 +35,3 @@ all_files = 1
 upload-dir = docs/_build/html
 
 [easy_install]
-
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index a022431899b4d..5c1d7876d2f32 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -52,6 +52,7 @@
     'node_type_id': 'r3.xlarge',
     'num_workers': 1
 }
+CLUSTER_ID = 'cluster_id'
 RUN_ID = 1
 HOST = 'xx.cloud.databricks.com'
 HOST_WITH_SCHEME = 'https://xx.cloud.databricks.com'
@@ -93,6 +94,27 @@ def cancel_run_endpoint(host):
     return 'https://{}/api/2.0/jobs/runs/cancel'.format(host)
 
 
+def start_cluster_endpoint(host):
+    """
+    Utility function to generate the get run endpoint given the host.
+    """
+    return 'https://{}/api/2.0/clusters/start'.format(host)
+
+
+def restart_cluster_endpoint(host):
+    """
+    Utility function to generate the get run endpoint given the host.
+    """
+    return 'https://{}/api/2.0/clusters/restart'.format(host)
+
+
+def terminate_cluster_endpoint(host):
+    """
+    Utility function to generate the get run endpoint given the host.
+    """
+    return 'https://{}/api/2.0/clusters/delete'.format(host)
+
+
 def create_valid_response_mock(content):
     response = mock.MagicMock()
     response.json.return_value = content
@@ -293,6 +315,54 @@ def test_cancel_run(self, mock_requests):
             headers=USER_AGENT_HEADER,
             timeout=self.hook.timeout_seconds)
 
+    @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
+    def test_start_cluster(self, mock_requests):
+        mock_requests.codes.ok = 200
+        mock_requests.post.return_value.json.return_value = {}
+        status_code_mock = mock.PropertyMock(return_value=200)
+        type(mock_requests.post.return_value).status_code = status_code_mock
+
+        self.hook.start_cluster({"cluster_id": CLUSTER_ID})
+
+        mock_requests.post.assert_called_once_with(
+            start_cluster_endpoint(HOST),
+            json={'cluster_id': CLUSTER_ID},
+            auth=(LOGIN, PASSWORD),
+            headers=USER_AGENT_HEADER,
+            timeout=self.hook.timeout_seconds)
+
+    @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
+    def test_restart_cluster(self, mock_requests):
+        mock_requests.codes.ok = 200
+        mock_requests.post.return_value.json.return_value = {}
+        status_code_mock = mock.PropertyMock(return_value=200)
+        type(mock_requests.post.return_value).status_code = status_code_mock
+
+        self.hook.restart_cluster({"cluster_id": CLUSTER_ID})
+
+        mock_requests.post.assert_called_once_with(
+            restart_cluster_endpoint(HOST),
+            json={'cluster_id': CLUSTER_ID},
+            auth=(LOGIN, PASSWORD),
+            headers=USER_AGENT_HEADER,
+            timeout=self.hook.timeout_seconds)
+
+    @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
+    def test_terminate_cluster(self, mock_requests):
+        mock_requests.codes.ok = 200
+        mock_requests.post.return_value.json.return_value = {}
+        status_code_mock = mock.PropertyMock(return_value=200)
+        type(mock_requests.post.return_value).status_code = status_code_mock
+
+        self.hook.terminate_cluster({"cluster_id": CLUSTER_ID})
+
+        mock_requests.post.assert_called_once_with(
+            terminate_cluster_endpoint(HOST),
+            json={'cluster_id': CLUSTER_ID},
+            auth=(LOGIN, PASSWORD),
+            headers=USER_AGENT_HEADER,
+            timeout=self.hook.timeout_seconds)
+
 
 class DatabricksHookTokenTest(unittest.TestCase):
     """

From abb72481557ff0c8a3b20a6bc1d36f970ae9a343 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 1 Sep 2018 11:33:48 +0100
Subject: [PATCH 094/808] [AIRFLOW-2981] Fix TypeError in dataflow operators
 (#3831)

- Fix TypeError in dataflow operators when using GCS jar or py_file
---
 .../contrib/operators/dataflow_operator.py    |  6 ++--
 .../operators/test_dataflow_operator.py       | 29 +++++++++++++++++--
 2 files changed, 29 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index e3c8c1fff1572..99d10199d9703 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -16,7 +16,7 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
+import os
 import re
 import uuid
 import copy
@@ -358,7 +358,7 @@ def google_cloud_to_local(self, file_name):
         # Extracts bucket_id and object_id by first removing 'gs://' prefix and
         # then split the remaining by path delimiter '/'.
         path_components = file_name[self.GCS_PREFIX_LENGTH:].split('/')
-        if path_components < 2:
+        if len(path_components) < 2:
             raise Exception(
                 'Invalid Google Cloud Storage (GCS) object path: {}.'
                 .format(file_name))
@@ -369,7 +369,7 @@ def google_cloud_to_local(self, file_name):
                                                  path_components[-1])
         file_size = self._gcs_hook.download(bucket_id, object_id, local_file)
 
-        if file_size > 0:
+        if os.stat(file_size).st_size > 0:
             return local_file
         raise Exception(
             'Failed to download Google Cloud Storage GCS object: {}'
diff --git a/tests/contrib/operators/test_dataflow_operator.py b/tests/contrib/operators/test_dataflow_operator.py
index 4ea5f65698f03..a373126b24e4b 100644
--- a/tests/contrib/operators/test_dataflow_operator.py
+++ b/tests/contrib/operators/test_dataflow_operator.py
@@ -20,9 +20,10 @@
 
 import unittest
 
-from airflow.contrib.operators.dataflow_operator import DataFlowPythonOperator, \
-    DataFlowJavaOperator, DataflowTemplateOperator
-from airflow.contrib.operators.dataflow_operator import DataFlowPythonOperator
+from airflow.contrib.operators.dataflow_operator import \
+    DataFlowPythonOperator, DataFlowJavaOperator, \
+    DataflowTemplateOperator, GoogleCloudBucketHelper
+
 from airflow.version import version
 
 try:
@@ -186,3 +187,25 @@ def test_exec(self, dataflow_mock):
         }
         start_template_hook.assert_called_once_with(TASK_ID, expected_options,
                                                     PARAMETERS, TEMPLATE)
+
+
+class GoogleCloudBucketHelperTest(unittest.TestCase):
+
+    @mock.patch(
+        'airflow.contrib.operators.dataflow_operator.GoogleCloudBucketHelper.__init__'
+    )
+    def test_invalid_object_path(self, mock_parent_init):
+
+        # This is just the path of a bucket hence invalid filename
+        file_name = 'gs://test-bucket'
+        mock_parent_init.return_value = None
+
+        gcs_bucket_helper = GoogleCloudBucketHelper()
+        gcs_bucket_helper._gcs_hook = mock.Mock()
+
+        with self.assertRaises(Exception) as context:
+            gcs_bucket_helper.google_cloud_to_local(file_name)
+
+        self.assertEquals(
+            'Invalid Google Cloud Storage (GCS) object path: {}.'.format(file_name),
+            str(context.exception))

From d9af846e8e07874318d85f3c82a0216c3956249e Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 31 Aug 2018 08:25:05 +0100
Subject: [PATCH 095/808] [AIRFLOW-2989] Add param to set bootDiskType in
 Dataproc Op (#3825)

Add param to set bootDiskType for master and
worker nodes in `DataprocClusterCreateOperator`
---
 .../contrib/operators/dataproc_operator.py    | 19 ++++++++++++++++++-
 .../operators/test_dataproc_operator.py       |  6 ++++++
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index e72a66569d5b6..6954133b51ac1 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -75,10 +75,20 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type properties: dict
     :param master_machine_type: Compute engine machine type to use for the master node
     :type master_machine_type: string
+    :param master_disk_type: Type of the boot disk for the master node
+        (default is ``pd-standard``).
+        Valid values: ``pd-ssd`` (Persistent Disk Solid State Drive) or
+        ``pd-standard`` (Persistent Disk Hard Disk Drive).
+    :type master_disk_type: string
     :param master_disk_size: Disk size for the master node
     :type master_disk_size: int
     :param worker_machine_type: Compute engine machine type to use for the worker nodes
     :type worker_machine_type: string
+    :param worker_disk_type: Type of the boot disk for the worker node
+        (default is ``pd-standard``).
+        Valid values: ``pd-ssd`` (Persistent Disk Solid State Drive) or
+        ``pd-standard`` (Persistent Disk Hard Disk Drive).
+    :type worker_disk_type: string
     :param worker_disk_size: Disk size for the worker nodes
     :type worker_disk_size: int
     :param num_preemptible_workers: The # of preemptible worker nodes to spin up
@@ -141,8 +151,10 @@ def __init__(self,
                  image_version=None,
                  properties=None,
                  master_machine_type='n1-standard-4',
+                 master_disk_type='pd-standard',
                  master_disk_size=500,
                  worker_machine_type='n1-standard-4',
+                 worker_disk_type='pd-standard',
                  worker_disk_size=500,
                  num_preemptible_workers=0,
                  labels=None,
@@ -171,8 +183,10 @@ def __init__(self,
         self.image_version = image_version
         self.properties = properties
         self.master_machine_type = master_machine_type
+        self.master_disk_type = master_disk_type
         self.master_disk_size = master_disk_size
         self.worker_machine_type = worker_machine_type
+        self.worker_disk_type = worker_disk_type
         self.worker_disk_size = worker_disk_size
         self.labels = labels
         self.zone = zone
@@ -272,6 +286,7 @@ def _build_cluster_data(self):
                     'numInstances': 1,
                     'machineTypeUri': master_type_uri,
                     'diskConfig': {
+                        'bootDiskType': self.master_disk_type,
                         'bootDiskSizeGb': self.master_disk_size
                     }
                 },
@@ -279,6 +294,7 @@ def _build_cluster_data(self):
                     'numInstances': self.num_workers,
                     'machineTypeUri': worker_type_uri,
                     'diskConfig': {
+                        'bootDiskType': self.worker_disk_type,
                         'bootDiskSizeGb': self.worker_disk_size
                     }
                 },
@@ -292,6 +308,7 @@ def _build_cluster_data(self):
                 'numInstances': self.num_preemptible_workers,
                 'machineTypeUri': worker_type_uri,
                 'diskConfig': {
+                    'bootDiskType': self.worker_disk_type,
                     'bootDiskSizeGb': self.worker_disk_size
                 },
                 'isPreemptible': True
@@ -401,7 +418,7 @@ class DataprocClusterScaleOperator(BaseOperator):
             cluster_name='cluster-1',
             num_workers=10,
             num_preemptible_workers=10,
-            graceful_decommission_timeout='1h'
+            graceful_decommission_timeout='1h',
             dag=dag)
 
     .. seealso::
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index aea130349bdea..ab191f3c32760 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -61,8 +61,10 @@
 IMAGE_VERSION = '1.1'
 MASTER_MACHINE_TYPE = 'n1-standard-2'
 MASTER_DISK_SIZE = 100
+MASTER_DISK_TYPE = 'pd-standard'
 WORKER_MACHINE_TYPE = 'n1-standard-2'
 WORKER_DISK_SIZE = 100
+WORKER_DISK_TYPE = 'pd-standard'
 NUM_PREEMPTIBLE_WORKERS = 2
 GET_INIT_ACTION_TIMEOUT = "600s"  # 10m
 LABEL1 = {}
@@ -104,8 +106,10 @@ def setUp(self):
                     storage_bucket=STORAGE_BUCKET,
                     image_version=IMAGE_VERSION,
                     master_machine_type=MASTER_MACHINE_TYPE,
+                    master_disk_type=MASTER_DISK_TYPE,
                     master_disk_size=MASTER_DISK_SIZE,
                     worker_machine_type=WORKER_MACHINE_TYPE,
+                    worker_disk_type=WORKER_DISK_TYPE,
                     worker_disk_size=WORKER_DISK_SIZE,
                     num_preemptible_workers=NUM_PREEMPTIBLE_WORKERS,
                     labels=deepcopy(labels),
@@ -138,8 +142,10 @@ def test_init(self):
             self.assertEqual(dataproc_operator.image_version, IMAGE_VERSION)
             self.assertEqual(dataproc_operator.master_machine_type, MASTER_MACHINE_TYPE)
             self.assertEqual(dataproc_operator.master_disk_size, MASTER_DISK_SIZE)
+            self.assertEqual(dataproc_operator.master_disk_type, MASTER_DISK_TYPE)
             self.assertEqual(dataproc_operator.worker_machine_type, WORKER_MACHINE_TYPE)
             self.assertEqual(dataproc_operator.worker_disk_size, WORKER_DISK_SIZE)
+            self.assertEqual(dataproc_operator.worker_disk_type, WORKER_DISK_TYPE)
             self.assertEqual(dataproc_operator.num_preemptible_workers,
                              NUM_PREEMPTIBLE_WORKERS)
             self.assertEqual(dataproc_operator.labels, self.labels[suffix])

From 4f6f496b763f202fcca0de5fdc71f5655d9474f8 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 31 Aug 2018 09:36:24 +0100
Subject: [PATCH 096/808] [AIRFLOW-2990] Fix Docstrings for Operators (#3820)

---
 airflow/contrib/hooks/gcp_container_hook.py   |  4 +
 .../contrib/operators/awsbatch_operator.py    | 16 ++--
 .../operators/bigquery_check_operator.py      |  6 +-
 .../contrib/operators/bigquery_operator.py    | 82 +++++++++----------
 .../contrib/operators/dataflow_operator.py    | 63 +++++++-------
 .../contrib/operators/dataproc_operator.py    | 16 ++--
 airflow/contrib/operators/ecs_operator.py     | 13 +--
 airflow/models.py                             | 19 +++--
 airflow/sensors/s3_prefix_sensor.py           |  2 +
 9 files changed, 117 insertions(+), 104 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index d36d796d764a5..3cc3744c03686 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -47,6 +47,7 @@ def __init__(self, project_id, location):
     def _dict_to_proto(self, py_dict, proto):
         """
         Converts a python dictionary to the proto supplied
+
         :param py_dict: The dictionary to convert
         :type py_dict: dict
         :param proto: The proto object to merge with dictionary
@@ -62,6 +63,7 @@ def wait_for_operation(self, operation):
         """
         Given an operation, continuously fetches the status from Google Cloud until either
         completion or an error occurring
+
         :param operation: The Operation to wait for
         :type operation: A google.cloud.container_V1.gapic.enums.Operator
         :return: A new, updated operation fetched from Google Cloud
@@ -82,6 +84,7 @@ def wait_for_operation(self, operation):
     def get_operation(self, operation_name):
         """
         Fetches the operation from Google Cloud
+
         :param operation_name: Name of operation to fetch
         :type operation_name: str
         :return: The new, updated operation from Google Cloud
@@ -194,6 +197,7 @@ def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
     def get_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
         """
         Gets details of specified cluster
+
         :param name: The name of the cluster to retrieve
         :type name: str
         :param retry: A retry object used to retry requests. If None is specified,
diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index ed7f1ebf36cce..89dd4940b51e9 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -42,18 +42,20 @@ class AWSBatchOperator(BaseOperator):
     :type job_definition: str
     :param job_queue: the queue name on AWS Batch
     :type job_queue: str
-    :param: overrides: the same parameter that boto3 will receive on
-            containerOverrides (templated):
-            http://boto3.readthedocs.io/en/latest/reference/services/batch.html#submit_job
-    :type: overrides: dict
-    :param max_retries: exponential backoff retries while waiter is not merged, 4200 = 48 hours
+    :param overrides: the same parameter that boto3 will receive on
+        containerOverrides (templated).
+        http://boto3.readthedocs.io/en/latest/reference/services/batch.html#submit_job
+    :type overrides: dict
+    :param max_retries: exponential backoff retries while waiter is not merged,
+        4200 = 48 hours
     :type max_retries: int
     :param aws_conn_id: connection id of AWS credentials / region name. If None,
-            credential boto3 strategy will be used
-            (http://boto3.readthedocs.io/en/latest/guide/configuration.html).
+        credential boto3 strategy will be used
+        (http://boto3.readthedocs.io/en/latest/guide/configuration.html).
     :type aws_conn_id: str
     :param region_name: region name to use in AWS Hook.
         Override the region_name in connection (if provided)
+    :type region_name: str
     """
 
     ui_color = '#c3dae0'
diff --git a/airflow/contrib/operators/bigquery_check_operator.py b/airflow/contrib/operators/bigquery_check_operator.py
index a9c493f4fd418..3eba0771db91b 100644
--- a/airflow/contrib/operators/bigquery_check_operator.py
+++ b/airflow/contrib/operators/bigquery_check_operator.py
@@ -56,7 +56,7 @@ class BigQueryCheckOperator(CheckOperator):
     :param bigquery_conn_id: reference to the BigQuery database
     :type bigquery_conn_id: string
     :param use_legacy_sql: Whether to use legacy SQL (true)
-    or standard SQL (false).
+        or standard SQL (false).
     :type use_legacy_sql: boolean
     """
 
@@ -83,7 +83,7 @@ class BigQueryValueCheckOperator(ValueCheckOperator):
     :param sql: the sql to be executed
     :type sql: string
     :param use_legacy_sql: Whether to use legacy SQL (true)
-    or standard SQL (false).
+        or standard SQL (false).
     :type use_legacy_sql: boolean
     """
 
@@ -125,7 +125,7 @@ class BigQueryIntervalCheckOperator(IntervalCheckOperator):
         between the current day, and the prior days_back.
     :type metrics_threshold: dict
     :param use_legacy_sql: Whether to use legacy SQL (true)
-    or standard SQL (false).
+        or standard SQL (false).
     :type use_legacy_sql: boolean
     """
 
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 2eadd04f003d9..037b9fc43e631 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -232,49 +232,49 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
         work, the service account making the request must have domain-wide
         delegation enabled.
     :type delegate_to: string
-    :param labels a dictionary containing labels for the table, passed to BigQuery
+    :param labels: a dictionary containing labels for the table, passed to BigQuery
+
+        **Example (with schema JSON in GCS)**: ::
+
+            CreateTable = BigQueryCreateEmptyTableOperator(
+                task_id='BigQueryCreateEmptyTableOperator_task',
+                dataset_id='ODS',
+                table_id='Employees',
+                project_id='internal-gcp-project',
+                gcs_schema_object='gs://schema-bucket/employee_schema.json',
+                bigquery_conn_id='airflow-service-account',
+                google_cloud_storage_conn_id='airflow-service-account'
+            )
+
+        **Corresponding Schema file** (``employee_schema.json``): ::
+
+            [
+              {
+                "mode": "NULLABLE",
+                "name": "emp_name",
+                "type": "STRING"
+              },
+              {
+                "mode": "REQUIRED",
+                "name": "salary",
+                "type": "INTEGER"
+              }
+            ]
+
+        **Example (with schema in the DAG)**: ::
+
+            CreateTable = BigQueryCreateEmptyTableOperator(
+                task_id='BigQueryCreateEmptyTableOperator_task',
+                dataset_id='ODS',
+                table_id='Employees',
+                project_id='internal-gcp-project',
+                schema_fields=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
+                               {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}],
+                bigquery_conn_id='airflow-service-account',
+                google_cloud_storage_conn_id='airflow-service-account'
+            )
     :type labels: dict
 
-    **Example (with schema JSON in GCS)**: ::
-
-        CreateTable = BigQueryCreateEmptyTableOperator(
-            task_id='BigQueryCreateEmptyTableOperator_task',
-            dataset_id='ODS',
-            table_id='Employees',
-            project_id='internal-gcp-project',
-            gcs_schema_object='gs://schema-bucket/employee_schema.json',
-            bigquery_conn_id='airflow-service-account',
-            google_cloud_storage_conn_id='airflow-service-account'
-        )
-
-    **Corresponding Schema file** (``employee_schema.json``): ::
-
-        [
-          {
-            "mode": "NULLABLE",
-            "name": "emp_name",
-            "type": "STRING"
-          },
-          {
-            "mode": "REQUIRED",
-            "name": "salary",
-            "type": "INTEGER"
-          }
-        ]
-
-    **Example (with schema in the DAG)**: ::
-
-        CreateTable = BigQueryCreateEmptyTableOperator(
-            task_id='BigQueryCreateEmptyTableOperator_task',
-            dataset_id='ODS',
-            table_id='Employees',
-            project_id='internal-gcp-project',
-            schema_fields=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
-                           {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}],
-            bigquery_conn_id='airflow-service-account',
-            google_cloud_storage_conn_id='airflow-service-account'
-        )
-
     """
     template_fields = ('dataset_id', 'table_id', 'project_id',
                        'gcs_schema_object', 'labels')
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 99d10199d9703..cd289f546ad3c 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -252,6 +252,38 @@ def execute(self, context):
 
 
 class DataFlowPythonOperator(BaseOperator):
+    """
+    Create a new DataFlowPythonOperator. Note that both
+    dataflow_default_options and options will be merged to specify pipeline
+    execution parameter, and dataflow_default_options is expected to save
+    high-level options, for instances, project and zone information, which
+    apply to all dataflow operators in the DAG.
+
+    .. seealso::
+        For more detail on job submission have a look at the reference:
+        https://cloud.google.com/dataflow/pipelines/specifying-exec-params
+
+    :param py_file: Reference to the python dataflow pipleline file.py, e.g.,
+        /some/local/file/path/to/your/python/pipeline/file.
+    :type py_file: string
+    :param py_options: Additional python options.
+    :type pyt_options: list of strings, e.g., ["-m", "-v"].
+    :param dataflow_default_options: Map of default job options.
+    :type dataflow_default_options: dict
+    :param options: Map of job specific options.
+    :type options: dict
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud
+        Platform.
+    :type gcp_conn_id: string
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide  delegation enabled.
+    :type delegate_to: string
+    :param poll_sleep: The time in seconds to sleep between polling Google
+        Cloud Platform for the dataflow job status while the job is in the
+        JOB_STATE_RUNNING state.
+    :type poll_sleep: int
+    """
 
     template_fields = ['options', 'dataflow_default_options']
 
@@ -267,38 +299,7 @@ def __init__(
             poll_sleep=10,
             *args,
             **kwargs):
-        """
-        Create a new DataFlowPythonOperator. Note that both
-        dataflow_default_options and options will be merged to specify pipeline
-        execution parameter, and dataflow_default_options is expected to save
-        high-level options, for instances, project and zone information, which
-        apply to all dataflow operators in the DAG.
-
-        .. seealso::
-            For more detail on job submission have a look at the reference:
-            https://cloud.google.com/dataflow/pipelines/specifying-exec-params
 
-        :param py_file: Reference to the python dataflow pipleline file.py, e.g.,
-            /some/local/file/path/to/your/python/pipeline/file.
-        :type py_file: string
-        :param py_options: Additional python options.
-        :type pyt_options: list of strings, e.g., ["-m", "-v"].
-        :param dataflow_default_options: Map of default job options.
-        :type dataflow_default_options: dict
-        :param options: Map of job specific options.
-        :type options: dict
-        :param gcp_conn_id: The connection ID to use connecting to Google Cloud
-            Platform.
-        :type gcp_conn_id: string
-        :param delegate_to: The account to impersonate, if any.
-            For this to work, the service account making the request must have
-            domain-wide  delegation enabled.
-        :type delegate_to: string
-        :param poll_sleep: The time in seconds to sleep between polling Google
-            Cloud Platform for the dataflow job status while the job is in the
-            JOB_STATE_RUNNING state.
-        :type poll_sleep: int
-        """
         super(DataFlowPythonOperator, self).__init__(*args, **kwargs)
 
         self.py_file = py_file
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 6954133b51ac1..957a1b89e6b07 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -412,14 +412,14 @@ class DataprocClusterScaleOperator(BaseOperator):
 
     **Example**: ::
 
-    t1 = DataprocClusterScaleOperator(
-            task_id='dataproc_scale',
-            project_id='my-project',
-            cluster_name='cluster-1',
-            num_workers=10,
-            num_preemptible_workers=10,
-            graceful_decommission_timeout='1h',
-            dag=dag)
+        t1 = DataprocClusterScaleOperator(
+                task_id='dataproc_scale',
+                project_id='my-project',
+                cluster_name='cluster-1',
+                num_workers=10,
+                num_preemptible_workers=10,
+                graceful_decommission_timeout='1h',
+                dag=dag)
 
     .. seealso::
         For more detail on about scaling clusters have a look at the reference:
diff --git a/airflow/contrib/operators/ecs_operator.py b/airflow/contrib/operators/ecs_operator.py
index 60540f5e289d6..84bc2a3c91a2f 100644
--- a/airflow/contrib/operators/ecs_operator.py
+++ b/airflow/contrib/operators/ecs_operator.py
@@ -33,17 +33,18 @@ class ECSOperator(BaseOperator):
     :type task_definition: str
     :param cluster: the cluster name on EC2 Container Service
     :type cluster: str
-    :param: overrides: the same parameter that boto3 will receive (templated):
-            http://boto3.readthedocs.org/en/latest/reference/services/ecs.html#ECS.Client.run_task
-    :type: overrides: dict
+    :param overrides: the same parameter that boto3 will receive (templated):
+        http://boto3.readthedocs.org/en/latest/reference/services/ecs.html#ECS.Client.run_task
+    :type overrides: dict
     :param aws_conn_id: connection id of AWS credentials / region name. If None,
-            credential boto3 strategy will be used
-            (http://boto3.readthedocs.io/en/latest/guide/configuration.html).
+        credential boto3 strategy will be used
+        (http://boto3.readthedocs.io/en/latest/guide/configuration.html).
     :type aws_conn_id: str
     :param region_name: region name to use in AWS Hook.
         Override the region_name in connection (if provided)
+    :type region_name: str
     :param launch_type: the launch type on which to run your task ('EC2' or 'FARGATE')
-    :type: launch_type: str
+    :type launch_type: str
     """
 
     ui_color = '#f0ede4'
diff --git a/airflow/models.py b/airflow/models.py
index 0207ac25252dc..6597dac4f0d35 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2324,14 +2324,17 @@ class derived from this one results in the creation of a task object,
     :param executor_config: Additional task-level configuration parameters that are
         interpreted by a specific executor. Parameters are namespaced by the name of
         executor.
-        ``example: to run this task in a specific docker container through
-        the KubernetesExecutor
-        MyOperator(...,
-            executor_config={
-            "KubernetesExecutor":
-                {"image": "myCustomDockerImage"}
-                }
-        )``
+
+        **Example**: to run this task in a specific docker container through
+        the KubernetesExecutor ::
+
+            MyOperator(...,
+                executor_config={
+                "KubernetesExecutor":
+                    {"image": "myCustomDockerImage"}
+                    }
+            )
+
     :type executor_config: dict
     """
 
diff --git a/airflow/sensors/s3_prefix_sensor.py b/airflow/sensors/s3_prefix_sensor.py
index 917dd46e26c28..42e574c5ee2b8 100644
--- a/airflow/sensors/s3_prefix_sensor.py
+++ b/airflow/sensors/s3_prefix_sensor.py
@@ -38,6 +38,8 @@ class S3PrefixSensor(BaseSensorOperator):
     :param delimiter: The delimiter intended to show hierarchy.
         Defaults to '/'.
     :type delimiter: str
+    :param aws_conn_id: a reference to the s3 connection
+    :type aws_conn_id: str
     """
     template_fields = ('prefix', 'bucket_name')
 

From bc27aace7d23baad145c75171d105e8cd902ece6 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 4 Sep 2018 23:47:41 +0100
Subject: [PATCH 097/808] [AIRFLOW-3006] Add note on using None for
 schedule_interval

---
 airflow/models.py  | 1 +
 docs/scheduler.rst | 2 ++
 tests/models.py    | 7 +++++--
 3 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 6597dac4f0d35..14c08e7092532 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2302,6 +2302,7 @@ class derived from this one results in the creation of a task object,
     :type on_failure_callback: callable
     :param on_retry_callback: much like the ``on_failure_callback`` except
         that it is executed when retries occur.
+    :type on_retry_callback: callable
     :param on_success_callback: much like the ``on_failure_callback`` except
         that it is executed when the task succeeds.
     :type on_success_callback: callable
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index dfa0a4275770a..84dcc4a7f9db4 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -63,6 +63,8 @@ use one of these cron "preset":
 | ``@yearly``  | Run once a year at midnight of January 1                       | ``0 0 1 1 *`` |
 +--------------+----------------------------------------------------------------+---------------+
 
+**Note**: Use ``schedule_interval=None`` and not ``schedule_interval='None'`` when
+you don't want to schedule your DAG.
 
 Your DAG will be instantiated
 for each schedule, while creating a ``DAG Run`` entry for each schedule.
diff --git a/tests/models.py b/tests/models.py
index 5b31a634f4a7f..abb726f7a9e6a 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -65,7 +65,7 @@
 
 class DagTest(unittest.TestCase):
 
-    def test_parms_not_passed_is_empty_dict(self):
+    def test_params_not_passed_is_empty_dict(self):
         """
         Test that when 'params' is _not_ passed to a new Dag, that the params
         attribute is set to an empty dictionary.
@@ -311,7 +311,6 @@ def test_dag_task_priority_weight_total(self):
             with self.assertRaises(AirflowException):
                 DummyOperator(task_id='should_fail', weight_rule='no rule')
 
-
     def test_get_num_task_instances(self):
         test_dag_id = 'test_get_num_task_instances_dag'
         test_task_id = 'task_1'
@@ -595,6 +594,7 @@ def test_dagstats_crud(self):
         for stat in res:
             self.assertFalse(stat.dirty)
 
+
 class DagRunTest(unittest.TestCase):
 
     def create_dag_run(self, dag,
@@ -1113,6 +1113,7 @@ def with_all_tasks_removed(dag):
         flaky_ti.refresh_from_db()
         self.assertEquals(State.NONE, flaky_ti.state)
 
+
 class DagBagTest(unittest.TestCase):
 
     def test_get_existing_dag(self):
@@ -1585,6 +1586,7 @@ def test_kill_zombies(self, mock_ti):
                                    configuration.getboolean('core', 'unit_test_mode'),
                                    ANY)
 
+
 class TaskInstanceTest(unittest.TestCase):
 
     def test_set_task_dates(self):
@@ -2602,6 +2604,7 @@ def test_xcom_get_many(self):
         for result in results:
             self.assertEqual(result.value, json_obj)
 
+
 class ConnectionTest(unittest.TestCase):
     @patch.object(configuration, 'get')
     def test_connection_extra_no_encryption(self, mock_get):

From bc97e6ee0b6136368d6aebc5c30df848420bb6b6 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 5 Sep 2018 00:46:41 +0100
Subject: [PATCH 098/808] [AIRFLOW-3008] Move Kubernetes example DAGs to
 contrib

---
 .../{ => contrib}/example_dags/example_kubernetes_executor.py   | 0
 .../{ => contrib}/example_dags/example_kubernetes_operator.py   | 0
 tests/core.py                                                   | 2 +-
 3 files changed, 1 insertion(+), 1 deletion(-)
 rename airflow/{ => contrib}/example_dags/example_kubernetes_executor.py (100%)
 rename airflow/{ => contrib}/example_dags/example_kubernetes_operator.py (100%)

diff --git a/airflow/example_dags/example_kubernetes_executor.py b/airflow/contrib/example_dags/example_kubernetes_executor.py
similarity index 100%
rename from airflow/example_dags/example_kubernetes_executor.py
rename to airflow/contrib/example_dags/example_kubernetes_executor.py
diff --git a/airflow/example_dags/example_kubernetes_operator.py b/airflow/contrib/example_dags/example_kubernetes_operator.py
similarity index 100%
rename from airflow/example_dags/example_kubernetes_operator.py
rename to airflow/contrib/example_dags/example_kubernetes_operator.py
diff --git a/tests/core.py b/tests/core.py
index f00c9aeead2cd..8cd69dc4ee1fb 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -73,7 +73,7 @@
 
 import six
 
-NUM_EXAMPLE_DAGS = 20
+NUM_EXAMPLE_DAGS = 18
 DEV_NULL = '/dev/null'
 TEST_DAG_FOLDER = os.path.join(
     os.path.dirname(os.path.realpath(__file__)), 'dags')

From 35f996b65a2e68f4e168e3f466f3a939e4fb904a Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Thu, 4 Oct 2018 03:20:24 -0400
Subject: [PATCH 099/808] [AIRFLOW-3103][AIRFLOW-3147] Update flask-appbuilder
 (#3937)

---
 UPDATING.md                                   | 23 +++++++++++++------
 .../auth/backends/github_enterprise_auth.py   |  3 +++
 airflow/contrib/auth/backends/google_auth.py  |  3 +++
 .../contrib/auth/backends/kerberos_auth.py    |  5 +++-
 airflow/contrib/auth/backends/ldap_auth.py    |  5 +++-
 .../contrib/auth/backends/password_auth.py    |  5 +++-
 airflow/default_login.py                      |  3 +++
 airflow/www/utils.py                          |  8 +++----
 airflow/www/views.py                          |  2 +-
 airflow/www_rbac/decorators.py                |  2 +-
 airflow/www_rbac/security.py                  |  2 +-
 .../templates/appbuilder/navbar_right.html    |  2 +-
 setup.py                                      |  4 ++--
 tests/www/test_utils.py                       |  6 ++---
 14 files changed, 50 insertions(+), 23 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index d00e4f8742f26..130df60530c4c 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -3,13 +3,6 @@
 This file documents any backwards-incompatible changes in Airflow and
 assists users migrating to a new version.
 
-## Airflow Master
-
-### min_file_parsing_loop_time config option temporarily disabled
-
-The scheduler.min_file_parsing_loop_time config option has been temporarily removed due to
-some bugs.
-
 ## Airflow 1.10
 
 Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
@@ -119,6 +112,22 @@ elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_
 elasticsearch_end_of_log_mark = end_of_log
 ```
 
+### Custom auth backends interface change
+
+We have updated the version of flask-login we depend upon, and as a result any
+custom auth backends might need a small change: `is_active`,
+`is_authenticated`, and `is_anonymous` should now be properties. What this means is if
+previously you had this in your user class
+
+    def is_active(self):
+      return self.active
+
+then you need to change it like this
+
+    @property
+    def is_active(self):
+      return self.active
+
 ## Airflow 1.9
 
 ### SSH Hook updates, along with new SSH Operator & SFTP Operator
diff --git a/airflow/contrib/auth/backends/github_enterprise_auth.py b/airflow/contrib/auth/backends/github_enterprise_auth.py
index 641b81e46da63..78afee46078dc 100644
--- a/airflow/contrib/auth/backends/github_enterprise_auth.py
+++ b/airflow/contrib/auth/backends/github_enterprise_auth.py
@@ -47,14 +47,17 @@ class GHEUser(models.User):
     def __init__(self, user):
         self.user = user
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
diff --git a/airflow/contrib/auth/backends/google_auth.py b/airflow/contrib/auth/backends/google_auth.py
index e41934b926c31..32ad6962a0a82 100644
--- a/airflow/contrib/auth/backends/google_auth.py
+++ b/airflow/contrib/auth/backends/google_auth.py
@@ -46,14 +46,17 @@ class GoogleUser(models.User):
     def __init__(self, user):
         self.user = user
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
diff --git a/airflow/contrib/auth/backends/kerberos_auth.py b/airflow/contrib/auth/backends/kerberos_auth.py
index 08be299a197dd..4b5bb295d9685 100644
--- a/airflow/contrib/auth/backends/kerberos_auth.py
+++ b/airflow/contrib/auth/backends/kerberos_auth.py
@@ -73,14 +73,17 @@ def authenticate(username, password):
 
         return
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
@@ -110,7 +113,7 @@ def load_user(userid, session=None):
 
 @provide_session
 def login(self, request, session=None):
-    if current_user.is_authenticated():
+    if current_user.is_authenticated:
         flash("You are already logged in")
         return redirect(url_for('index'))
 
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index 516e121c9b26d..cb4675757b75a 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -236,14 +236,17 @@ def try_login(username, password):
             log.info("Password incorrect for user %s", username)
             raise AuthenticationError("Invalid username or password")
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
@@ -274,7 +277,7 @@ def load_user(userid, session=None):
 
 @provide_session
 def login(self, request, session=None):
-    if current_user.is_authenticated():
+    if current_user.is_authenticated:
         flash("You are already logged in")
         return redirect(url_for('admin.index'))
 
diff --git a/airflow/contrib/auth/backends/password_auth.py b/airflow/contrib/auth/backends/password_auth.py
index 879aaa142a4db..55f5daf8fdf76 100644
--- a/airflow/contrib/auth/backends/password_auth.py
+++ b/airflow/contrib/auth/backends/password_auth.py
@@ -71,14 +71,17 @@ def password(self, plaintext):
     def authenticate(self, plaintext):
         return check_password_hash(self._password, plaintext)
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
@@ -137,7 +140,7 @@ def authenticate(session, username, password):
 
 @provide_session
 def login(self, request, session=None):
-    if current_user.is_authenticated():
+    if current_user.is_authenticated:
         flash("You are already logged in")
         return redirect(url_for('admin.index'))
 
diff --git a/airflow/default_login.py b/airflow/default_login.py
index d44dbf39ea9b3..b6453c55d0c69 100644
--- a/airflow/default_login.py
+++ b/airflow/default_login.py
@@ -44,14 +44,17 @@ class DefaultUser(object):
     def __init__(self, user):
         self.user = user
 
+    @property
     def is_active(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_authenticated(self):
         """Required by flask_login"""
         return True
 
+    @property
     def is_anonymous(self):
         """Required by flask_login"""
         return False
diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 03ba1f775b001..1566faa91ac1e 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -71,8 +71,8 @@ class LoginMixin(object):
     def is_accessible(self):
         return (
             not AUTHENTICATE or (
-                not current_user.is_anonymous() and
-                current_user.is_authenticated()
+                not current_user.is_anonymous and
+                current_user.is_authenticated
             )
         )
 
@@ -81,7 +81,7 @@ class SuperUserMixin(object):
     def is_accessible(self):
         return (
             not AUTHENTICATE or
-            (not current_user.is_anonymous() and current_user.is_superuser())
+            (not current_user.is_anonymous and current_user.is_superuser())
         )
 
 
@@ -89,7 +89,7 @@ class DataProfilingMixin(object):
     def is_accessible(self):
         return (
             not AUTHENTICATE or
-            (not current_user.is_anonymous() and current_user.data_profiling())
+            (not current_user.is_anonymous and current_user.data_profiling())
         )
 
 
diff --git a/airflow/www/views.py b/airflow/www/views.py
index cfd46b871aa7e..540980baa602c 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -266,7 +266,7 @@ def data_profiling_required(f):
     def decorated_function(*args, **kwargs):
         if (
                 current_app.config['LOGIN_DISABLED'] or
-                (not current_user.is_anonymous() and current_user.data_profiling())
+                (not current_user.is_anonymous and current_user.data_profiling())
         ):
             return f(*args, **kwargs)
         else:
diff --git a/airflow/www_rbac/decorators.py b/airflow/www_rbac/decorators.py
index 2dd1af45df09d..41be4eb4be597 100644
--- a/airflow/www_rbac/decorators.py
+++ b/airflow/www_rbac/decorators.py
@@ -32,7 +32,7 @@ def action_logging(f):
     @functools.wraps(f)
     def wrapper(*args, **kwargs):
         session = settings.Session()
-        if g.user.is_anonymous():
+        if g.user.is_anonymous:
             user = 'anonymous'
         else:
             user = g.user.username
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index d2271f822a47e..ae21029dd182b 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -171,7 +171,7 @@ def init_roles(appbuilder):
 
 
 def is_view_only(user, appbuilder):
-    if user.is_anonymous():
+    if user.is_anonymous:
         anonymous_role = appbuilder.sm.auth_role_public
         return anonymous_role == 'Viewer'
 
diff --git a/airflow/www_rbac/templates/appbuilder/navbar_right.html b/airflow/www_rbac/templates/appbuilder/navbar_right.html
index bf5aa43221884..d42f8e2e8a82c 100644
--- a/airflow/www_rbac/templates/appbuilder/navbar_right.html
+++ b/airflow/www_rbac/templates/appbuilder/navbar_right.html
@@ -47,7 +47,7 @@
 <!-- clock -->
 <li><a id="clock"></a></li>
 
-{% if not current_user.is_anonymous() %}
+{% if not current_user.is_anonymous %}
     <li class="dropdown">
         <a class="dropdown-toggle" data-toggle="dropdown" href="#">
            <span class="fa fa-user"></span> {{g.user.get_full_name()}}<b class="caret"></b>
diff --git a/setup.py b/setup.py
index ab6d06e8ff64b..ba5cb94c7cb93 100644
--- a/setup.py
+++ b/setup.py
@@ -275,10 +275,10 @@ def do_setup():
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
             'flask>=0.12.4, <0.13',
-            'flask-appbuilder>=1.11.1, <2.0.0',
+            'flask-appbuilder>=1.12, <2.0.0',
             'flask-admin==1.4.1',
             'flask-caching>=1.3.3, <1.4.0',
-            'flask-login==0.2.11',
+            'flask-login>=0.3, <0.5',
             'flask-swagger==0.2.13',
             'flask-wtf>=0.14.2, <0.15',
             'funcsigs==1.0.0',
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index 904853bac156d..30a293e50cdeb 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -116,8 +116,8 @@ def test_params_all(self):
         self.assertEqual('page=3&search=bash_&showPaused=False',
                          utils.get_params(showPaused=False, page=3, search='bash_'))
 
-    # flask_login is loaded by calling flask_login._get_user.
-    @mock.patch("flask_login._get_user")
+    # flask_login is loaded by calling flask_login.utils._get_user.
+    @mock.patch("flask_login.utils._get_user")
     @mock.patch("airflow.settings.Session")
     def test_action_logging_with_login_user(self, mocked_session, mocked_get_user):
         fake_username = 'someone'
@@ -142,7 +142,7 @@ def some_func():
                 self.assertEqual(fake_username, kwargs['owner'])
                 mocked_session_instance.add.assert_called_once()
 
-    @mock.patch("flask_login._get_user")
+    @mock.patch("flask_login.utils._get_user")
     @mock.patch("airflow.settings.Session")
     def test_action_logging_with_invalid_user(self, mocked_session, mocked_get_user):
         anonymous_username = 'anonymous'

From 040707b5d830acb96fc6c9a367039ed96aba7231 Mon Sep 17 00:00:00 2001
From: Eric Chang <ericchang2017@u.northwestern.edu>
Date: Sun, 7 Oct 2018 07:42:15 -0700
Subject: [PATCH 100/808] [AIRFLOW-3162] Fix HttpHook URL parse error when port
 is specified (#4001)

---
 airflow/hooks/http_hook.py    |  6 +++++-
 tests/hooks/test_http_hook.py | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/airflow/hooks/http_hook.py b/airflow/hooks/http_hook.py
index caa89d3142e9b..1e0c7b3058147 100644
--- a/airflow/hooks/http_hook.py
+++ b/airflow/hooks/http_hook.py
@@ -98,7 +98,11 @@ def run(self, endpoint, data=None, headers=None, extra_options=None):
 
         session = self.get_conn(headers)
 
-        url = self.base_url + endpoint
+        if not self.base_url.endswith('/') and not endpoint.startswith('/'):
+            url = self.base_url + '/' + endpoint
+        else:
+            url = self.base_url + endpoint
+
         req = None
         if self.method == 'GET':
             # GET uses params
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index c8163322f942b..e64e59fbcae64 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -42,6 +42,15 @@ def get_airflow_connection(conn_id=None):
     )
 
 
+def get_airflow_connection_with_port(conn_id=None):
+    return models.Connection(
+        conn_id='http_default',
+        conn_type='http',
+        host='test.com',
+        port=1234
+    )
+
+
 class TestHttpHook(unittest.TestCase):
     """Test get, post and raise_for_status"""
     def setUp(self):
@@ -69,6 +78,32 @@ def test_raise_for_status_with_200(self, m):
             resp = self.get_hook.run('v1/test')
             self.assertEquals(resp.text, '{"status":{"status": 200}}')
 
+    @requests_mock.mock()
+    @mock.patch('requests.Request')
+    def test_get_request_with_port(self, m, request_mock):
+        from requests.exceptions import MissingSchema
+
+        with mock.patch(
+            'airflow.hooks.base_hook.BaseHook.get_connection',
+            side_effect=get_airflow_connection_with_port
+        ):
+            expected_url = 'http://test.com:1234/some/endpoint'
+            for endpoint in ['some/endpoint', '/some/endpoint']:
+
+                try:
+                    self.get_hook.run(endpoint)
+                except MissingSchema:
+                    pass
+
+                request_mock.assert_called_once_with(
+                    mock.ANY,
+                    expected_url,
+                    headers=mock.ANY,
+                    params=mock.ANY
+                )
+
+                request_mock.reset_mock()
+
     @requests_mock.mock()
     def test_get_request_do_not_raise_for_status_if_check_response_is_false(self, m):
 

From e2a238c3a55be5fcb17b5ec64e7165dd954a4bc0 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 10 Oct 2018 10:46:28 +0100
Subject: [PATCH 101/808] [AIRFLOW-3173] Add _cmd options for password config
 options (#4024)

There were a few more "password" config options added over the last few
months that didn't have _cmd options. Any config option that is a
password should be able to be provided via a _cmd version.
---
 airflow/configuration.py  |  4 ++++
 docs/howto/set-config.rst | 20 +++++++++++++++++---
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 4f88a6fee3c43..8a056bc4f1cf5 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -129,6 +129,10 @@ class AirflowConfigParser(ConfigParser):
         ('celery', 'result_backend'),
         # Todo: remove this in Airflow 1.11
         ('celery', 'celery_result_backend'),
+        ('atlas', 'password'),
+        ('smtp', 'smtp_password'),
+        ('ldap', 'bind_password'),
+        ('kubernetes', 'git_password'),
     }
 
     # A two-level mapping of (section -> new_name -> old_name). When reading
diff --git a/docs/howto/set-config.rst b/docs/howto/set-config.rst
index 2caf5d5eb7275..fc8d59da189ee 100644
--- a/docs/howto/set-config.rst
+++ b/docs/howto/set-config.rst
@@ -20,16 +20,30 @@ or by creating a corresponding environment variable:
 
     AIRFLOW__CORE__SQL_ALCHEMY_CONN=my_conn_string
 
-You can also derive the connection string at run time by appending ``_cmd`` to the key like this:
+You can also derive the connection string at run time by appending ``_cmd`` to
+the key like this:
 
 .. code-block:: bash
 
     [core]
     sql_alchemy_conn_cmd = bash_command_to_run
 
--But only three such configuration elements namely sql_alchemy_conn, broker_url and result_backend can be fetched as a command. The idea behind this is to not store passwords on boxes in plain text files. The order of precedence is as follows -
+The following config options support this ``_cmd`` version:
+
+* ``sql_alchemy_conn`` in ``[core]`` section
+* ``fernet_key`` in ``[core]`` section
+* ``broker_url`` in ``[celery]`` section
+* ``result_backend`` in ``[celery]`` section
+* ``password`` in ``[atlas]`` section
+* ``smtp_password`` in ``[smtp]`` section
+* ``bind_password`` in ``[ldap]`` section
+* ``git_password`` in ``[kubernetes]`` section
+
+The idea behind this is to not store passwords on boxes in plain text files.
+
+The order of precedence for all connfig options is as follows -
 
 1. environment variable
 2. configuration in airflow.cfg
 3. command in airflow.cfg
-4. default
+4. Airflow's built in defaults

From 9ce0c226e002a0518849d8aa9c51d882b68c9bc6 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 29 Sep 2018 09:49:31 +0200
Subject: [PATCH 102/808] [AIRFLOW-2912] Add Deploy and Delete operators for
 GCF (#3969)

Both Deploy and Delete operators interact with Google
Cloud Functions to manage functions. Both are idempotent
and make use of GcfHook - hook that encapsulates
communication with GCP over GCP API.
---
 .../example_gcp_function_delete.py            |  58 ++
 .../example_gcp_function_deploy_delete.py     | 113 ++++
 airflow/contrib/hooks/gcp_function_hook.py    | 195 ++++++
 .../operators/gcp_function_operator.py        | 563 ++++++++++++++++
 docs/howto/operator.rst                       | 223 +++++++
 docs/integration.rst                          |  34 +
 .../operators/test_gcp_function_operator.py   | 624 ++++++++++++++++++
 7 files changed, 1810 insertions(+)
 create mode 100644 airflow/contrib/example_dags/example_gcp_function_delete.py
 create mode 100644 airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
 create mode 100644 airflow/contrib/hooks/gcp_function_hook.py
 create mode 100644 airflow/contrib/operators/gcp_function_operator.py
 create mode 100644 docs/howto/operator.rst
 create mode 100644 tests/contrib/operators/test_gcp_function_operator.py

diff --git a/airflow/contrib/example_dags/example_gcp_function_delete.py b/airflow/contrib/example_dags/example_gcp_function_delete.py
new file mode 100644
index 0000000000000..30f5369af60ef
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_function_delete.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that deletes a Google Cloud Function.
+This DAG relies on the following Airflow variables
+https://airflow.apache.org/concepts.html#variables
+* PROJECT_ID - Google Cloud Project where the Cloud Function exists.
+* LOCATION - Google Cloud Functions region where the function exists.
+* ENTRYPOINT - Name of the executable function in the source code.
+"""
+
+import datetime
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_function_operator import GcfFunctionDeleteOperator
+
+# [START howto_operator_gcf_delete_args]
+PROJECT_ID = models.Variable.get('PROJECT_ID', '')
+LOCATION = models.Variable.get('LOCATION', '')
+ENTRYPOINT = models.Variable.get('ENTRYPOINT', '')
+# A fully-qualified name of the function to delete
+
+FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
+                                                               ENTRYPOINT)
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+# [END howto_operator_gcf_delete_args]
+
+with models.DAG(
+    'example_gcp_function_delete',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_gcf_delete]
+    t1 = GcfFunctionDeleteOperator(
+        task_id="gcf_delete_task",
+        name=FUNCTION_NAME
+    )
+    # [END howto_operator_gcf_delete]
diff --git a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
new file mode 100644
index 0000000000000..a0e44957b9204
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that creates a Google Cloud Function and then deletes it.
+
+This DAG relies on the following Airflow variables
+https://airflow.apache.org/concepts.html#variables
+* PROJECT_ID - Google Cloud Project to use for the Cloud Function.
+* LOCATION - Google Cloud Functions region where the function should be
+  created.
+* SOURCE_ARCHIVE_URL - Path to the zipped source in Google Cloud Storage
+or
+    * SOURCE_UPLOAD_URL - Generated upload URL for the zipped source
+    or
+    * ZIP_PATH - Local path to the zipped source archive
+or
+* SOURCE_REPOSITORY - The URL pointing to the hosted repository where the function is
+defined in a supported Cloud Source Repository URL format
+https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#SourceRepository
+* ENTRYPOINT - Name of the executable function in the source code.
+"""
+
+import datetime
+
+from airflow import models
+from airflow.contrib.operators.gcp_function_operator \
+    import GcfFunctionDeployOperator, GcfFunctionDeleteOperator
+from airflow.utils import dates
+
+# [START howto_operator_gcf_deploy_variables]
+PROJECT_ID = models.Variable.get('PROJECT_ID', '')
+LOCATION = models.Variable.get('LOCATION', '')
+SOURCE_ARCHIVE_URL = models.Variable.get('SOURCE_ARCHIVE_URL', '')
+SOURCE_UPLOAD_URL = models.Variable.get('SOURCE_UPLOAD_URL', '')
+SOURCE_REPOSITORY = models.Variable.get('SOURCE_REPOSITORY', '')
+ZIP_PATH = models.Variable.get('ZIP_PATH', '')
+ENTRYPOINT = models.Variable.get('ENTRYPOINT', '')
+FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
+                                                               ENTRYPOINT)
+RUNTIME = 'nodejs6'
+VALIDATE_BODY = models.Variable.get('VALIDATE_BODY', True)
+
+# [END howto_operator_gcf_deploy_variables]
+
+# [START howto_operator_gcf_deploy_body]
+body = {
+    "name": FUNCTION_NAME,
+    "entryPoint": ENTRYPOINT,
+    "runtime": RUNTIME,
+    "httpsTrigger": {}
+}
+# [END howto_operator_gcf_deploy_body]
+
+# [START howto_operator_gcf_deploy_args]
+default_args = {
+    'start_date': dates.days_ago(1),
+    'project_id': PROJECT_ID,
+    'location': LOCATION,
+    'body': body,
+    'validate_body': VALIDATE_BODY
+}
+# [END howto_operator_gcf_deploy_args]
+
+# [START howto_operator_gcf_deploy_variants]
+if SOURCE_ARCHIVE_URL:
+    body['sourceArchiveUrl'] = SOURCE_ARCHIVE_URL
+elif SOURCE_REPOSITORY:
+    body['sourceRepository'] = {
+        'url': SOURCE_REPOSITORY
+    }
+elif ZIP_PATH:
+    body['sourceUploadUrl'] = ''
+    default_args['zip_path'] = ZIP_PATH
+elif SOURCE_UPLOAD_URL:
+    body['sourceUploadUrl'] = SOURCE_UPLOAD_URL
+else:
+    raise Exception("Please provide one of the source_code parameters")
+# [END howto_operator_gcf_deploy_variants]
+
+
+with models.DAG(
+    'example_gcp_function_deploy_delete',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_gcf_deploy]
+    deploy_task = GcfFunctionDeployOperator(
+        task_id="gcf_deploy_task",
+        name=FUNCTION_NAME
+    )
+    # [END howto_operator_gcf_deploy]
+    delete_task = GcfFunctionDeleteOperator(
+        task_id="gcf_delete_task",
+        name=FUNCTION_NAME
+    )
+    deploy_task >> delete_task
diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
new file mode 100644
index 0000000000000..d2da19285ab13
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -0,0 +1,195 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import time
+import requests
+from googleapiclient.discovery import build
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+# Number of retries - used by googleapiclient method calls to perform retries
+# For requests that are "retriable"
+NUM_RETRIES = 5
+
+# Time to sleep between active checks of the operation results
+TIME_TO_SLEEP_IN_SECONDS = 1
+
+
+# noinspection PyAbstractClass
+class GcfHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud Functions APIs.
+    """
+    _conn = None
+
+    def __init__(self,
+                 api_version,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(GcfHook, self).__init__(gcp_conn_id, delegate_to)
+        self.api_version = api_version
+
+    def get_conn(self):
+        """
+        Retrieves connection to cloud functions.
+
+        :return: Google Cloud Function services object
+        :rtype: dict
+        """
+        if not self._conn:
+            http_authorized = self._authorize()
+            self._conn = build('cloudfunctions', self.api_version,
+                               http=http_authorized, cache_discovery=False)
+        return self._conn
+
+    def get_function(self, name):
+        """
+        Returns the function with a given name.
+
+        :param name: name of the function
+        :type name: str
+        :return: a CloudFunction object representing the function
+        :rtype: dict
+        """
+        return self.get_conn().projects().locations().functions().get(
+            name=name).execute(num_retries=NUM_RETRIES)
+
+    def list_functions(self, full_location):
+        """
+        Lists all functions created in the location.
+
+        :param full_location: full location including project. On the form
+            of /projects/<PROJECT>/location/<LOCATION>
+        :type full_location: str
+        :return: array of CloudFunction objects - representing functions in the location
+        :rtype: [dict]
+        """
+        list_response = self.get_conn().projects().locations().functions().list(
+            parent=full_location).execute(num_retries=NUM_RETRIES)
+        return list_response.get("functions", [])
+
+    def create_new_function(self, full_location, body):
+        """
+        Creates new cloud function in location given with body specified.
+
+        :param full_location: full location including project. On the form
+            of /projects/<PROJECT>/location/<LOCATION>
+        :type full_location: str
+        :param body: body required by the cloud function insert API
+        :type body: dict
+        :return: response returned by the operation
+        :rtype: dict
+        """
+        response = self.get_conn().projects().locations().functions().create(
+            location=full_location,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(operation_name)
+
+    def update_function(self, name, body, update_mask):
+        """
+        Updates cloud function according to the update mask specified.
+
+        :param name: name of the function
+        :type name: str
+        :param body: body required by the cloud function patch API
+        :type body: str
+        :param update_mask: update mask - array of fields that should be patched
+        :type update_mask: [str]
+        :return: response returned by the operation
+        :rtype: dict
+        """
+        response = self.get_conn().projects().locations().functions().patch(
+            updateMask=",".join(update_mask),
+            name=name,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(operation_name)
+
+    def upload_function_zip(self, parent, zip_path):
+        """
+        Uploads zip file with sources.
+
+        :param parent: project and location in which signed upload URL should be generated
+           in the form of /projects/<PROJECT>/location/<LOCATION>
+        :type parent: str
+        :param zip_path: path of the file to upload (should point to valid .zip file)
+        :type zip_path: str
+        :return: Upload URL that was returned by generateUploadUrl method
+        """
+        response = self.get_conn().projects().locations().functions().generateUploadUrl(
+            parent=parent
+        ).execute(num_retries=NUM_RETRIES)
+        upload_url = response.get('uploadUrl')
+        with open(zip_path, 'rb') as fp:
+            requests.put(
+                url=upload_url,
+                data=fp.read(),
+                # Those two headers needs to be specified according to:
+                # https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/generateUploadUrl
+                # nopep8
+                headers={
+                    'Content-type': 'application/zip',
+                    'x-goog-content-length-range': '0,104857600',
+                }
+            )
+        return upload_url
+
+    def delete_function(self, name):
+        """
+        Deletes cloud function specified by name.
+
+        :param name: name of the function
+        :type name: str
+        :return: response returned by the operation
+        :rtype: dict
+        """
+        response = self.get_conn().projects().locations().functions().delete(
+            name=name).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(operation_name)
+
+    def _wait_for_operation_to_complete(self, operation_name):
+        """
+        Waits for the named operation to complete - checks status of the
+        asynchronous call.
+
+        :param operation_name: name of the operation
+        :type operation_name: str
+        :return: response  returned by the operation
+        :rtype: dict
+        :exception: AirflowException in case error is returned
+        """
+        service = self.get_conn()
+        while True:
+            operation_response = service.operations().get(
+                name=operation_name,
+            ).execute(num_retries=NUM_RETRIES)
+            if operation_response.get("done"):
+                response = operation_response.get("response")
+                error = operation_response.get("error")
+                # Note, according to documentation always either response or error is
+                # set when "done" == True
+                if error:
+                    raise AirflowException(str(error))
+                return response
+            time.sleep(TIME_TO_SLEEP_IN_SECONDS)
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
new file mode 100644
index 0000000000000..4455307c93259
--- /dev/null
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -0,0 +1,563 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import re
+
+from googleapiclient.errors import HttpError
+
+from airflow import AirflowException, LoggingMixin
+from airflow.version import version
+from airflow.models import BaseOperator
+from airflow.contrib.hooks.gcp_function_hook import GcfHook
+from airflow.utils.decorators import apply_defaults
+
+# TODO: This whole section should be extracted later to contrib/tools/field_validator.py
+
+COMPOSITE_FIELD_TYPES = ['union', 'dict']
+
+
+class FieldValidationException(AirflowException):
+    """
+    Thrown when validation finds dictionary field not valid according to specification.
+    """
+
+    def __init__(self, message):
+        super(FieldValidationException, self).__init__(message)
+
+
+class ValidationSpecificationException(AirflowException):
+    """
+    Thrown when validation specification is wrong
+    (rather than dictionary being validated).
+    This should only happen during development as ideally
+     specification itself should not be invalid ;) .
+    """
+
+    def __init__(self, message):
+        super(ValidationSpecificationException, self).__init__(message)
+
+
+# TODO: make better description, add some examples
+# TODO: move to contrib/utils folder when we reuse it.
+class BodyFieldValidator(LoggingMixin):
+    """
+    Validates correctness of request body according to specification.
+    The specification can describe various type of
+    fields including custom validation, and union of fields. This validator is meant
+    to be reusable by various operators
+    in the near future, but for now it is left as part of the Google Cloud Function,
+    so documentation about the
+    validator is not yet complete. To see what kind of specification can be used,
+    please take a look at
+    gcp_function_operator.CLOUD_FUNCTION_VALIDATION which specifies validation
+    for GCF deploy operator.
+
+    :param validation_specs: dictionary describing validation specification
+    :type validation_specs: [dict]
+    :param api_version: Version of the api used (for example v1)
+    :type api_version: str
+
+    """
+    def __init__(self, validation_specs, api_version):
+        # type: ([dict], str) -> None
+        super(BodyFieldValidator, self).__init__()
+        self._validation_specs = validation_specs
+        self._api_version = api_version
+
+    @staticmethod
+    def _get_field_name_with_parent(field_name, parent):
+        if parent:
+            return parent + '.' + field_name
+        return field_name
+
+    @staticmethod
+    def _sanity_checks(children_validation_specs, field_type, full_field_path,
+                       regexp, custom_validation, value):
+        # type: (dict, str, str, str, function, object) -> None
+        if value is None and field_type != 'union':
+            raise FieldValidationException(
+                "The required body field '{}' is missing. Please add it.".
+                format(full_field_path))
+        if regexp and field_type:
+            raise ValidationSpecificationException(
+                "The validation specification entry '{}' has both type and regexp. "
+                "The regexp is only allowed without type (i.e. assume type is 'str' "
+                "that can be validated with regexp)".format(full_field_path))
+        if children_validation_specs and field_type not in COMPOSITE_FIELD_TYPES:
+            raise ValidationSpecificationException(
+                "Nested fields are specified in field '{}' of type '{}'. "
+                "Nested fields are only allowed for fields of those types: ('{}').".
+                format(full_field_path, field_type, COMPOSITE_FIELD_TYPES))
+        if custom_validation and field_type:
+            raise ValidationSpecificationException(
+                "The validation specification field '{}' has both type and "
+                "custom_validation. Custom validation is only allowed without type.".
+                format(full_field_path))
+
+    @staticmethod
+    def _validate_regexp(full_field_path, regexp, value):
+        # type: (str, str, str) -> None
+        if not re.match(regexp, value):
+            # Note matching of only the beginning as we assume the regexps all-or-nothing
+            raise FieldValidationException(
+                "The body field '{}' of value '{}' does not match the field "
+                "specification regexp: '{}'.".
+                format(full_field_path, value, regexp))
+
+    def _validate_dict(self, children_validation_specs, full_field_path, value):
+        # type: (dict, str, dict) -> None
+        for child_validation_spec in children_validation_specs:
+            self._validate_field(validation_spec=child_validation_spec,
+                                 dictionary_to_validate=value,
+                                 parent=full_field_path)
+        for field_name in value.keys():
+            if field_name not in [spec['name'] for spec in children_validation_specs]:
+                self.log.warning(
+                    "The field '{}' is in the body, but is not specified in the "
+                    "validation specification '{}'. "
+                    "This might be because you are using newer API version and "
+                    "new field names defined for that version. Then the warning "
+                    "can be safely ignored, or you might want to upgrade the operator"
+                    "to the version that supports the new API version.".format(
+                        self._get_field_name_with_parent(field_name, full_field_path),
+                        children_validation_specs))
+
+    def _validate_union(self, children_validation_specs, full_field_path,
+                        dictionary_to_validate):
+        # type: (dict, str, dict) -> None
+        field_found = False
+        found_field_name = None
+        for child_validation_spec in children_validation_specs:
+            # Forcing optional so that we do not have to type optional = True
+            # in specification for all union fields
+            new_field_found = self._validate_field(
+                validation_spec=child_validation_spec,
+                dictionary_to_validate=dictionary_to_validate,
+                parent=full_field_path,
+                force_optional=True)
+            field_name = child_validation_spec['name']
+            if new_field_found and field_found:
+                raise FieldValidationException(
+                    "The mutually exclusive fields '{}' and '{}' belonging to the "
+                    "union '{}' are both present. Please remove one".
+                    format(field_name, found_field_name, full_field_path))
+            if new_field_found:
+                field_found = True
+                found_field_name = field_name
+        if not field_found:
+            self.log.warning(
+                "There is no '{}' union defined in the body {}. "
+                "Validation expected one of '{}' but could not find any. It's possible "
+                "that you are using newer API version and there is another union variant "
+                "defined for that version. Then the warning can be safely ignored, "
+                "or you might want to upgrade the operator to the version that "
+                "supports the new API version.".format(
+                    full_field_path,
+                    dictionary_to_validate,
+                    [field['name'] for field in children_validation_specs]))
+
+    def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
+                        force_optional=False):
+        """
+        Validates if field is OK.
+        :param validation_spec: specification of the field
+        :type validation_spec: dict
+        :param dictionary_to_validate: dictionary where the field should be present
+        :type dictionary_to_validate: dict
+        :param parent: full path of parent field
+        :type parent: str
+        :param force_optional: forces the field to be optional
+          (all union fields have force_optional set to True)
+        :type force_optional: bool
+        :return: True if the field is present
+        """
+        field_name = validation_spec['name']
+        field_type = validation_spec.get('type')
+        optional = validation_spec.get('optional')
+        regexp = validation_spec.get('regexp')
+        children_validation_specs = validation_spec.get('fields')
+        required_api_version = validation_spec.get('api_version')
+        custom_validation = validation_spec.get('custom_validation')
+
+        full_field_path = self._get_field_name_with_parent(field_name=field_name,
+                                                           parent=parent)
+        if required_api_version and required_api_version != self._api_version:
+            self.log.debug(
+                "Skipping validation of the field '{}' for API version '{}' "
+                "as it is only valid for API version '{}'".
+                format(field_name, self._api_version, required_api_version))
+            return False
+        value = dictionary_to_validate.get(field_name)
+
+        if (optional or force_optional) and value is None:
+            self.log.debug("The optional field '{}' is missing. That's perfectly OK.".
+                           format(full_field_path))
+            return False
+
+        # Certainly down from here the field is present (value is not None)
+        # so we should only return True from now on
+
+        self._sanity_checks(children_validation_specs=children_validation_specs,
+                            field_type=field_type,
+                            full_field_path=full_field_path,
+                            regexp=regexp,
+                            custom_validation=custom_validation,
+                            value=value)
+
+        if regexp:
+            self._validate_regexp(full_field_path, regexp, value)
+        elif field_type == 'dict':
+            if not isinstance(value, dict):
+                raise FieldValidationException(
+                    "The field '{}' should be dictionary type according to "
+                    "specification '{}' but it is '{}'".
+                    format(full_field_path, validation_spec, value))
+            if children_validation_specs is None:
+                self.log.debug(
+                    "The dict field '{}' has no nested fields defined in the "
+                    "specification '{}'. That's perfectly ok - it's content will "
+                    "not be validated."
+                        .format(full_field_path, validation_spec))
+            else:
+                self._validate_dict(children_validation_specs, full_field_path, value)
+        elif field_type == 'union':
+            if not children_validation_specs:
+                raise ValidationSpecificationException(
+                    "The union field '{}' has no nested fields "
+                    "defined in specification '{}'. Unions should have at least one "
+                    "nested field defined.".format(full_field_path, validation_spec))
+            self._validate_union(children_validation_specs, full_field_path,
+                                 dictionary_to_validate)
+        elif custom_validation:
+            try:
+                custom_validation(value)
+            except Exception as e:
+                raise FieldValidationException(
+                    "Error while validating custom field '{}' specified by '{}': '{}'".
+                    format(full_field_path, validation_spec, e))
+        elif field_type is None:
+            self.log.debug("The type of field '{}' is not specified in '{}'. "
+                           "Not validating its content.".
+                           format(full_field_path, validation_spec))
+        else:
+            raise ValidationSpecificationException(
+                "The field '{}' is of type '{}' in specification '{}'."
+                "This type is unknown to validation!".format(
+                    full_field_path, field_type, validation_spec))
+        return True
+
+    def validate(self, body_to_validate):
+        """
+        Validates if the body (dictionary) follows specification that the validator was
+        instantiated with. Raises ValidationSpecificationException or
+        ValidationFieldException in case of problems with specification or the
+        body not conforming to the specification respectively.
+        :param body_to_validate: body that must follow the specification
+        :type body_to_validate: dict
+        :return: None
+        """
+        try:
+            for validation_spec in self._validation_specs:
+                self._validate_field(validation_spec=validation_spec,
+                                     dictionary_to_validate=body_to_validate)
+        except FieldValidationException as e:
+            raise FieldValidationException(
+                "There was an error when validating: field '{}': '{}'".
+                format(body_to_validate, e))
+
+# TODO End of field validator to be extracted
+
+
+def _validate_available_memory_in_mb(value):
+    if int(value) <= 0:
+        raise FieldValidationException("The available memory has to be greater than 0")
+
+
+def _validate_max_instances(value):
+    if int(value) <= 0:
+        raise FieldValidationException(
+            "The max instances parameter has to be greater than 0")
+
+
+CLOUD_FUNCTION_VALIDATION = [
+    dict(name="name", regexp="^.+$"),
+    dict(name="description", regexp="^.+$", optional=True),
+    dict(name="entryPoint", regexp=r'^.+$', optional=True),
+    dict(name="runtime", regexp=r'^.+$', optional=True),
+    dict(name="timeout", regexp=r'^.+$', optional=True),
+    dict(name="availableMemoryMb", custom_validation=_validate_available_memory_in_mb,
+         optional=True),
+    dict(name="labels", optional=True),
+    dict(name="environmentVariables", optional=True),
+    dict(name="network", regexp=r'^.+$', optional=True),
+    dict(name="maxInstances", optional=True, custom_validation=_validate_max_instances),
+
+    dict(name="source_code", type="union", fields=[
+        dict(name="sourceArchiveUrl", regexp=r'^.+$'),
+        dict(name="sourceRepositoryUrl", regexp=r'^.+$', api_version='v1beta2'),
+        dict(name="sourceRepository", type="dict", fields=[
+            dict(name="url", regexp=r'^.+$')
+        ]),
+        dict(name="sourceUploadUrl")
+    ]),
+
+    dict(name="trigger", type="union", fields=[
+        dict(name="httpsTrigger", type="dict", fields=[
+            # This dict should be empty at input (url is added at output)
+        ]),
+        dict(name="eventTrigger", type="dict", fields=[
+            dict(name="eventType", regexp=r'^.+$'),
+            dict(name="resource", regexp=r'^.+$'),
+            dict(name="service", regexp=r'^.+$', optional=True),
+            dict(name="failurePolicy", type="dict", optional=True, fields=[
+                dict(name="retry", type="dict", optional=True)
+            ])
+        ])
+    ]),
+]
+
+
+class GcfFunctionDeployOperator(BaseOperator):
+    """
+    Create a function in Google Cloud Functions.
+
+    :param project_id: Project ID that the operator works on
+    :type project_id: str
+    :param location: Region where the operator operates on
+    :type location: str
+    :param body: Body of the cloud function definition. The body must be a CloudFunction
+        dictionary as described in:
+        https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions
+        (note that different API versions require different
+        variants of the CloudFunction dictionary)
+    :type body: dict or google.cloud.functions.v1.CloudFunction
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: Version of the API used (for example v1).
+    :type api_version: str
+    :param zip_path: Path to zip file containing source code of the function. If it is
+        set, then sourceUploadUrl should not be specified in the body (or it should
+        be empty), then the zip file will be uploaded using upload URL generated
+        via generateUploadUrl from cloud functions API
+    :type zip_path: str
+    :param validate_body: If set to False, no body validation is performed.
+    :type validate_body: bool
+    """
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 location,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 zip_path=None,
+                 validate_body=True,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.location = location
+        self.full_location = 'projects/{}/locations/{}'.format(self.project_id,
+                                                               self.location)
+        self.body = body
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self.zip_path = zip_path
+        self.zip_path_preprocessor = ZipPathPreprocessor(body, zip_path)
+        self.validate_body = validate_body
+        self._field_validator = BodyFieldValidator(CLOUD_FUNCTION_VALIDATION,
+                                                   api_version=api_version)
+        self._hook = GcfHook(gcp_conn_id=self.gcp_conn_id, api_version=self.api_version)
+        self._validate_inputs()
+        super(GcfFunctionDeployOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is missing")
+        if not self.location:
+            raise AirflowException("The required parameter 'location' is missing")
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is missing")
+        self.zip_path_preprocessor.preprocess_body()
+
+    def _validate_all_body_fields(self):
+        self._field_validator.validate(self.body)
+
+    def _create_new_function(self):
+        self._hook.create_new_function(self.full_location, self.body)
+
+    def _update_function(self):
+        self._hook.update_function(self.body['name'], self.body, self.body.keys())
+
+    def _check_if_function_exists(self):
+        name = self.body.get('name')
+        if not name:
+            raise FieldValidationException("The 'name' field should be present in "
+                                           "body: '{}'.".format(self.body))
+        try:
+            self._hook.get_function(name)
+        except HttpError as e:
+            status = e.resp.status
+            if status == 404:
+                return False
+            raise e
+        return True
+
+    def _upload_source_code(self):
+        return self._hook.upload_function_zip(parent=self.full_location,
+                                              zip_path=self.zip_path)
+
+    def _set_airflow_version_label(self):
+        if 'labels' not in self.body.keys():
+            self.body['labels'] = {}
+        self.body['labels'].update(
+            {'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')})
+
+    def execute(self, context):
+        if self.zip_path_preprocessor.should_upload_function():
+            self.body[SOURCE_UPLOAD_URL] = self._upload_source_code()
+        if self.validate_body:
+            self._validate_all_body_fields()
+        self._set_airflow_version_label()
+        if not self._check_if_function_exists():
+            self._create_new_function()
+        else:
+            self._update_function()
+
+
+SOURCE_ARCHIVE_URL = 'sourceArchiveUrl'
+SOURCE_UPLOAD_URL = 'sourceUploadUrl'
+SOURCE_REPOSITORY = 'sourceRepository'
+ZIP_PATH = 'zip_path'
+
+
+class ZipPathPreprocessor:
+    """
+    Pre-processes zip path parameter.
+
+    Responsible for checking if the zip path parameter is correctly specified in
+    relation with source_code body fields. Non empty zip path parameter is special because
+    it is mutually exclusive with sourceArchiveUrl and sourceRepository body fields.
+    It is also mutually exclusive with non-empty sourceUploadUrl.
+    The pre-process modifies sourceUploadUrl body field in special way when zip_path
+    is not empty. An extra step is run when execute method is called and sourceUploadUrl
+    field value is set in the body with the value returned by generateUploadUrl Cloud
+    Function API method.
+
+    :param body: Body passed to the create/update method calls.
+    :type body: dict
+    :param zip_path: path to the zip file containing source code.
+    :type body: dict
+
+    """
+    upload_function = None
+
+    def __init__(self, body, zip_path):
+        self.body = body
+        self.zip_path = zip_path
+
+    @staticmethod
+    def _is_present_and_empty(dictionary, field):
+        return field in dictionary and not dictionary[field]
+
+    def _verify_upload_url_and_no_zip_path(self):
+        if self._is_present_and_empty(self.body, SOURCE_UPLOAD_URL):
+            if not self.zip_path:
+                raise AirflowException(
+                    "Parameter '{}' is empty in the body and argument '{}' "
+                    "is missing or empty. You need to have non empty '{}' "
+                    "when '{}' is present and empty.".
+                    format(SOURCE_UPLOAD_URL, ZIP_PATH, ZIP_PATH, SOURCE_UPLOAD_URL))
+
+    def _verify_upload_url_and_zip_path(self):
+        if SOURCE_UPLOAD_URL in self.body and self.zip_path:
+            if not self.body[SOURCE_UPLOAD_URL]:
+                self.upload_function = True
+            else:
+                raise AirflowException("Only one of '{}' in body or '{}' argument "
+                                       "allowed. Found both."
+                                       .format(SOURCE_UPLOAD_URL, ZIP_PATH))
+
+    def _verify_archive_url_and_zip_path(self):
+        if SOURCE_ARCHIVE_URL in self.body and self.zip_path:
+            raise AirflowException("Only one of '{}' in body or '{}' argument "
+                                   "allowed. Found both."
+                                   .format(SOURCE_ARCHIVE_URL, ZIP_PATH))
+
+    def should_upload_function(self):
+        if self.upload_function is None:
+            raise AirflowException('validate() method has to be invoked before '
+                                   'should_upload_function')
+        return self.upload_function
+
+    def preprocess_body(self):
+        self._verify_archive_url_and_zip_path()
+        self._verify_upload_url_and_zip_path()
+        self._verify_upload_url_and_no_zip_path()
+        if self.upload_function is None:
+            self.upload_function = False
+
+
+FUNCTION_NAME_PATTERN = '^projects/[^/]+/locations/[^/]+/functions/[^/]+$'
+FUNCTION_NAME_COMPILED_PATTERN = re.compile(FUNCTION_NAME_PATTERN)
+
+
+class GcfFunctionDeleteOperator(BaseOperator):
+    """
+    Delete a function with specified name from Google Cloud Functions.
+
+    :param name: A fully-qualified function name, matching
+        the pattern: `^projects/[^/]+/locations/[^/]+/functions/[^/]+$`
+    :type name: str
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: Version of the API used (for example v1).
+    :type api_version: str
+    """
+
+    @apply_defaults
+    def __init__(self,
+                 name,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 *args, **kwargs):
+        self.name = name
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+        self.hook = GcfHook(gcp_conn_id=self.gcp_conn_id, api_version=self.api_version)
+        super(GcfFunctionDeleteOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.name:
+            raise AttributeError('Empty parameter: name')
+        else:
+            pattern = FUNCTION_NAME_COMPILED_PATTERN
+            if not pattern.match(self.name):
+                raise AttributeError(
+                    'Parameter name must match pattern: {}'.format(FUNCTION_NAME_PATTERN))
+
+    def execute(self, context):
+        try:
+            return self.hook.delete_function(self.name)
+        except HttpError as e:
+            status = e.resp.status
+            if status == 404:
+                self.log.info('The function does not exist in this project')
+            else:
+                self.log.error('An error occurred. Exiting.')
+                raise e
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
new file mode 100644
index 0000000000000..0d973a391cc7b
--- /dev/null
+++ b/docs/howto/operator.rst
@@ -0,0 +1,223 @@
+Using Operators
+===============
+
+An operator represents a single, ideally idempotent, task. Operators
+determine what actually executes when your DAG runs.
+
+See the :ref:`Operators Concepts <concepts-operators>` documentation and the
+:ref:`Operators API Reference <api-reference-operators>` for more
+information.
+
+.. contents:: :local:
+
+BashOperator
+------------
+
+Use the :class:`~airflow.operators.bash_operator.BashOperator` to execute
+commands in a `Bash <https://www.gnu.org/software/bash/>`__ shell.
+
+.. literalinclude:: ../../airflow/example_dags/example_bash_operator.py
+    :language: python
+    :start-after: [START howto_operator_bash]
+    :end-before: [END howto_operator_bash]
+
+Templating
+^^^^^^^^^^
+
+You can use :ref:`Jinja templates <jinja-templating>` to parameterize the
+``bash_command`` argument.
+
+.. literalinclude:: ../../airflow/example_dags/example_bash_operator.py
+    :language: python
+    :start-after: [START howto_operator_bash_template]
+    :end-before: [END howto_operator_bash_template]
+
+Troubleshooting
+^^^^^^^^^^^^^^^
+
+Jinja template not found
+""""""""""""""""""""""""
+
+Add a space after the script name when directly calling a Bash script with
+the ``bash_command`` argument. This is because Airflow tries to apply a Jinja
+template to it, which will fail.
+
+.. code-block:: python
+
+    t2 = BashOperator(
+        task_id='bash_example',
+
+        # This fails with `Jinja template not found` error
+        # bash_command="/home/batcher/test.sh",
+
+        # This works (has a space after)
+        bash_command="/home/batcher/test.sh ",
+        dag=dag)
+
+PythonOperator
+--------------
+
+Use the :class:`~airflow.operators.python_operator.PythonOperator` to execute
+Python callables.
+
+.. literalinclude:: ../../airflow/example_dags/example_python_operator.py
+    :language: python
+    :start-after: [START howto_operator_python]
+    :end-before: [END howto_operator_python]
+
+Passing in arguments
+^^^^^^^^^^^^^^^^^^^^
+
+Use the ``op_args`` and ``op_kwargs`` arguments to pass additional arguments
+to the Python callable.
+
+.. literalinclude:: ../../airflow/example_dags/example_python_operator.py
+    :language: python
+    :start-after: [START howto_operator_python_kwargs]
+    :end-before: [END howto_operator_python_kwargs]
+
+Templating
+^^^^^^^^^^
+
+When you set the ``provide_context`` argument to ``True``, Airflow passes in
+an additional set of keyword arguments: one for each of the :ref:`Jinja
+template variables <macros>` and a ``templates_dict`` argument.
+
+The ``templates_dict`` argument is templated, so each value in the dictionary
+is evaluated as a :ref:`Jinja template <jinja-templating>`.
+
+Google Cloud Platform Operators
+-------------------------------
+
+GoogleCloudStorageToBigQueryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the
+:class:`~airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator`
+to execute a BigQuery load job.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_to_bq_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcs_to_bq]
+    :end-before: [END howto_operator_gcs_to_bq]
+
+GcfFunctionDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the ``default_args`` dict to pass arguments to the operator.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_delete_args]
+    :end-before: [END howto_operator_gcf_delete_args]
+
+
+Use the :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`
+to delete a function from Google Cloud Functions.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_delete]
+    :end-before: [END howto_operator_gcf_delete]
+
+Troubleshooting
+"""""""""""""""
+
+In case you want to run deploy operator using a service account and get "forbidden 403"
+errors, it means that your service account has not enough permissions set via IAM.
+
+* First you need to Assign your Service Account "Cloud Functions Developer" role
+* Make sure you grant the user the IAM Service Account User role on the Cloud Functions
+Runtime service account. Typical way of doing it with gcloud is shown below - just
+replace PROJECT_ID with ID of your project and SERVICE_ACCOUNT_EMAIL with the email id
+of your service account.
+
+.. code-block:: bash
+
+  gcloud iam service-accounts add-iam-policy-binding \
+    PROJECT_ID@appspot.gserviceaccount.com \
+    --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
+    --role="roles/iam.serviceAccountUser"
+
+
+See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
+
+GcfFunctionDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`
+to deploy a function from Google Cloud Functions.
+
+The examples below use Airflow variables defined in order to show various variants and
+combinations of default_args you can use. The variables are defined as follows:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_variables]
+    :end-before: [END howto_operator_gcf_deploy_variables]
+
+With those variables one can define body of the request:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_body]
+    :end-before: [END howto_operator_gcf_deploy_body]
+
+The default_args dictionary when you create DAG can be used to pass body and other
+arguments:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_args]
+    :end-before: [END howto_operator_gcf_deploy_args]
+
+Note that the neither the body nor default args are complete in the above examples.
+Depending on the variables set there might be different variants on how to pass
+source code related fields. Currently you can pass either
+`sourceArchiveUrl`, `sourceRepository` or `sourceUploadUrl` as described in
+`CloudFunction API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
+Additionally default_args might contain `zip_path` parameter to run extra step
+of uploading the source code before deploying it. In the last case you also need to
+provide an empty `sourceUploadUrl` parameter in the body.
+
+Example logic of setting the source code related fields based on variables defined above
+is shown here:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_variants]
+    :end-before: [END howto_operator_gcf_deploy_variants]
+
+The code to create the operator:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy]
+    :end-before: [END howto_operator_gcf_deploy]
+
+Troubleshooting
+"""""""""""""""
+
+In case you want to run deploy operator using a service account and get "forbidden 403"
+errors, it means that your service account has not enough permissions set via IAM.
+
+* First you need to Assign your Service Account "Cloud Functions Developer" role
+* Make sure you grant the user the IAM Service Account User role on the Cloud Functions
+Runtime service account. Typical way of doing it with gcloud is shown below - just
+replace PROJECT_ID with ID of your project and SERVICE_ACCOUNT_EMAIL with the email id
+of your service account.
+
+.. code-block:: bash
+
+  gcloud iam service-accounts add-iam-policy-binding \
+    PROJECT_ID@appspot.gserviceaccount.com \
+    --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
+    --role="roles/iam.serviceAccountUser"
+
+
+See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
+
+Also make sure that your service account has access to the source code of function
+in case it should be downloaded. It might mean that you add Source Repository Viewer
+role to the service account in case the source code is in Google Source Repository.
diff --git a/docs/integration.rst b/docs/integration.rst
index 99dbafbd2bc58..c7778650e0c8c 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -440,6 +440,40 @@ BigQueryHook
     :members:
 
 
+Cloud Functions
+'''''''''''''''
+
+Cloud Functions Operators
+"""""""""""""""""""""""""
+
+- :ref:`GcfFunctionDeployOperator` : deploy Google Cloud Function to the cloud.
+- :ref:`GcfFunctionDeleteOperator` : delete Google Cloud Function in the cloud.
+
+.. autoclass:: airflow.contrib.operators.gcp_operator.GCP
+
+.. _GcfFunctionDeployOperator:
+
+GcfFunctionDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
+
+
+.. _GcfFunctionDeleteOperator:
+
+GcfFunctionDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
+
+
+Cloud Functions Hook
+""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
+    :members:
+
+
 Cloud DataFlow
 ''''''''''''''
 
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
new file mode 100644
index 0000000000000..d7585ae66fdef
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -0,0 +1,624 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from googleapiclient.errors import HttpError
+from parameterized import parameterized
+
+from airflow.contrib.operators.gcp_function_operator import \
+    GcfFunctionDeployOperator, GcfFunctionDeleteOperator, FUNCTION_NAME_PATTERN
+from airflow import AirflowException
+from airflow.version import version
+
+from copy import deepcopy
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+EMPTY_CONTENT = ''.encode('utf8')
+MOCK_RESP_404 = type('', (object,), {"status": 404})()
+
+PROJECT_ID = 'test_project_id'
+LOCATION = 'test_region'
+SOURCE_ARCHIVE_URL = 'gs://folder/file.zip'
+ENTRYPOINT = 'helloWorld'
+FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
+                                                               ENTRYPOINT)
+RUNTIME = 'nodejs6'
+VALID_RUNTIMES = ['nodejs6', 'nodejs8', 'python37']
+VALID_BODY = {
+    "name": FUNCTION_NAME,
+    "entryPoint": ENTRYPOINT,
+    "runtime": RUNTIME,
+    "httpsTrigger": {},
+    "sourceArchiveUrl": SOURCE_ARCHIVE_URL
+}
+
+
+def _prepare_test_bodies():
+    body_no_name = deepcopy(VALID_BODY)
+    body_no_name.pop('name', None)
+    body_empty_entry_point = deepcopy(VALID_BODY)
+    body_empty_entry_point['entryPoint'] = ''
+    body_empty_runtime = deepcopy(VALID_BODY)
+    body_empty_runtime['runtime'] = ''
+    body_values = [
+        ({}, "The required parameter 'body' is missing"),
+        (body_no_name, "The required body field 'name' is missing"),
+        (body_empty_entry_point,
+         "The body field 'entryPoint' of value '' does not match"),
+        (body_empty_runtime, "The body field 'runtime' of value '' does not match"),
+    ]
+    return body_values
+
+
+class GcfFunctionDeployTest(unittest.TestCase):
+    @parameterized.expand(_prepare_test_bodies())
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_body_empty_or_missing_fields(self, body, message, mock_hook):
+        mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
+        with self.assertRaises(AirflowException) as cm:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn(message, str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_deploy_execute(self, mock_hook):
+        mock_hook.return_value.get_function.side_effect = mock.Mock(
+            side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
+        mock_hook.return_value.create_new_function.return_value = True
+        op = GcfFunctionDeployOperator(
+            project_id=PROJECT_ID,
+            location=LOCATION,
+            body=deepcopy(VALID_BODY),
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.get_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region/functions/helloWorld'
+        )
+        expected_body = deepcopy(VALID_BODY)
+        expected_body['labels'] = {
+            'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')
+        }
+        mock_hook.return_value.create_new_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region',
+            expected_body
+        )
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_update_function_if_exists(self, mock_hook):
+        mock_hook.return_value.get_function.return_value = True
+        mock_hook.return_value.update_function.return_value = True
+        op = GcfFunctionDeployOperator(
+            project_id=PROJECT_ID,
+            location=LOCATION,
+            body=deepcopy(VALID_BODY),
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.get_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region/functions/helloWorld'
+        )
+        expected_body = deepcopy(VALID_BODY)
+        expected_body['labels'] = {
+            'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')
+        }
+        mock_hook.return_value.update_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region/functions/helloWorld',
+            expected_body, expected_body.keys())
+        mock_hook.return_value.create_new_function.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_empty_project_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            GcfFunctionDeployOperator(
+                project_id="",
+                location="test_region",
+                body=None,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter 'project_id' is missing", str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_empty_location(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="",
+                body=None,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter 'location' is missing", str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_empty_body(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=None,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter 'body' is missing", str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+    @parameterized.expand([
+        (runtime,) for runtime in VALID_RUNTIMES
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_correct_runtime_field(self, runtime, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body['runtime'] = runtime
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        (network,) for network in [
+            "network-01",
+            "n-0-2-3-4",
+            "projects/PROJECT/global/networks/network-01"
+            "projects/PRÓJECT/global/networks/netwórk-01"
+        ]
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_valid_network_field(self, network, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body['network'] = network
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        (labels,) for labels in [
+            {},
+            {"label": 'value-01'},
+            {"label_324234_a_b_c": 'value-01_93'},
+        ]
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_valid_labels_field(self, labels, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body['labels'] = labels
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_validation_disabled(self, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = {
+            "name": "function_name",
+            "some_invalid_body_field": "some_invalid_body_field_value"
+        }
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            validate_body=False,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_body_validation_simple(self, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body['name'] = ''
+        with self.assertRaises(AirflowException) as cm:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The body field 'name' of value '' does not match",
+                      str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        ('name', '',
+         "The body field 'name' of value '' does not match"),
+        ('description', '', "The body field 'description' of value '' does not match"),
+        ('entryPoint', '', "The body field 'entryPoint' of value '' does not match"),
+        ('availableMemoryMb', '0',
+         "The available memory has to be greater than 0"),
+        ('availableMemoryMb', '-1',
+         "The available memory has to be greater than 0"),
+        ('availableMemoryMb', 'ss',
+         "invalid literal for int() with base 10: 'ss'"),
+        ('network', '', "The body field 'network' of value '' does not match"),
+        ('maxInstances', '0', "The max instances parameter has to be greater than 0"),
+        ('maxInstances', '-1', "The max instances parameter has to be greater than 0"),
+        ('maxInstances', 'ss', "invalid literal for int() with base 10: 'ss'"),
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_invalid_field_values(self, key, value, message, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body[key] = value
+        with self.assertRaises(AirflowException) as cm:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn(message, str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        ({'sourceArchiveUrl': ''},
+         "The body field 'source_code.sourceArchiveUrl' of value '' does not match"),
+        ({'sourceArchiveUrl': '', 'zip_path': '/path/to/file'},
+         "Only one of 'sourceArchiveUrl' in body or 'zip_path' argument allowed."),
+        ({'sourceArchiveUrl': 'gs://url', 'zip_path': '/path/to/file'},
+         "Only one of 'sourceArchiveUrl' in body or 'zip_path' argument allowed."),
+        ({'sourceArchiveUrl': '', 'sourceUploadUrl': ''},
+         "Parameter 'sourceUploadUrl' is empty in the body and argument "
+         "'zip_path' is missing or empty."),
+        ({'sourceArchiveUrl': 'gs://adasda', 'sourceRepository': ''},
+         "The field 'source_code.sourceRepository' should be dictionary type"),
+        ({'sourceUploadUrl': '', 'sourceRepository': ''},
+         "Parameter 'sourceUploadUrl' is empty in the body and argument 'zip_path' "
+         "is missing or empty."),
+        ({'sourceArchiveUrl': '', 'sourceUploadUrl': '', 'sourceRepository': ''},
+         "Parameter 'sourceUploadUrl' is empty in the body and argument 'zip_path' "
+         "is missing or empty."),
+        ({'sourceArchiveUrl': 'gs://url', 'sourceUploadUrl': 'https://url'},
+         "The mutually exclusive fields 'sourceUploadUrl' and 'sourceArchiveUrl' "
+         "belonging to the union 'source_code' are both present. Please remove one"),
+        ({'sourceUploadUrl': 'https://url', 'zip_path': '/path/to/file'},
+         "Only one of 'sourceUploadUrl' in body "
+         "or 'zip_path' argument allowed. Found both."),
+        ({'sourceUploadUrl': ''}, "Parameter 'sourceUploadUrl' is empty in the body "
+                                  "and argument 'zip_path' is missing or empty."),
+        ({'sourceRepository': ''}, "The field 'source_code.sourceRepository' "
+                                   "should be dictionary type"),
+        ({'sourceRepository': {}}, "The required body field "
+                                   "'source_code.sourceRepository.url' is missing"),
+        ({'sourceRepository': {'url': ''}},
+         "The body field 'source_code.sourceRepository.url' of value '' does not match"),
+    ]
+    )
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_invalid_source_code_union_field(self, source_code, message, mock_hook):
+        mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
+        body = deepcopy(VALID_BODY)
+        body.pop('sourceUploadUrl', None)
+        body.pop('sourceArchiveUrl', None)
+        zip_path = source_code.pop('zip_path', None)
+        body.update(source_code)
+        with self.assertRaises(AirflowException) as cm:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id",
+                zip_path=zip_path
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn(message, str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        ({'sourceArchiveUrl': 'gs://url'},),
+        ({'zip_path': '/path/to/file', 'sourceUploadUrl': None},),
+        ({'sourceUploadUrl':
+         'https://source.developers.google.com/projects/a/repos/b/revisions/c/paths/d'},),
+        ({'sourceRepository':
+         {'url': 'https://source.developers.google.com/projects/a/'
+          'repos/b/revisions/c/paths/d'}},),
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_valid_source_code_union_field(self, source_code, mock_hook):
+        mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
+        mock_hook.return_value.get_function.side_effect = mock.Mock(
+            side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body.pop('sourceUploadUrl', None)
+        body.pop('sourceArchiveUrl', None)
+        body.pop('sourceRepository', None)
+        body.pop('sourceRepositoryUrl', None)
+        zip_path = source_code.pop('zip_path', None)
+        body.update(source_code)
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id",
+            zip_path=zip_path
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        if zip_path:
+            mock_hook.return_value.upload_function_zip.assert_called_once_with(
+                parent='projects/test_project_id/locations/test_region',
+                zip_path='/path/to/file'
+            )
+        mock_hook.return_value.get_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region/functions/helloWorld'
+        )
+        mock_hook.return_value.create_new_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region',
+            body
+        )
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        ({'eventTrigger': {}},
+         "The required body field 'trigger.eventTrigger.eventType' is missing"),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b'}},
+         "The required body field 'trigger.eventTrigger.resource' is missing"),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b', 'resource': ''}},
+         "The body field 'trigger.eventTrigger.resource' of value '' does not match"),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b',
+                           'resource': 'res',
+                           'service': ''}},
+         "The body field 'trigger.eventTrigger.service' of value '' does not match"),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b',
+                           'resource': 'res',
+                           'service': 'service_name',
+                           'failurePolicy': {'retry': ''}}},
+         "The field 'trigger.eventTrigger.failurePolicy.retry' "
+         "should be dictionary type")
+    ]
+    )
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_invalid_trigger_union_field(self, trigger, message, mock_hook):
+        mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
+        body = deepcopy(VALID_BODY)
+        body.pop('httpsTrigger', None)
+        body.pop('eventTrigger', None)
+        body.update(trigger)
+        with self.assertRaises(AirflowException) as cm:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id",
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn(message, str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
+    @parameterized.expand([
+        ({'httpsTrigger': {}},),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b',
+                           'resource': 'res'}},),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b',
+                           'resource': 'res',
+                           'service': 'service_name'}},),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/ą.b',
+                           'resource': 'reś',
+                           'service': 'service_namę'}},),
+        ({'eventTrigger': {'eventType': 'providers/test/eventTypes/a.b',
+                           'resource': 'res',
+                           'service': 'service_name',
+                           'failurePolicy': {'retry': {}}}},)
+    ])
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_valid_trigger_union_field(self, trigger, mock_hook):
+        mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
+        mock_hook.return_value.get_function.side_effect = mock.Mock(
+            side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body.pop('httpsTrigger', None)
+        body.pop('eventTrigger', None)
+        body.update(trigger)
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id",
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.get_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region/functions/helloWorld'
+        )
+        mock_hook.return_value.create_new_function.assert_called_once_with(
+            'projects/test_project_id/locations/test_region',
+            body
+        )
+        mock_hook.reset_mock()
+
+
+class GcfFunctionDeleteTest(unittest.TestCase):
+    _FUNCTION_NAME = 'projects/project_name/locations/project_location/functions' \
+                     '/function_name'
+    _DELETE_FUNCTION_EXPECTED = {
+        '@type': 'type.googleapis.com/google.cloud.functions.v1.CloudFunction',
+        'name': _FUNCTION_NAME,
+        'sourceArchiveUrl': 'gs://functions/hello.zip',
+        'httpsTrigger': {
+            'url': 'https://project_location-project_name.cloudfunctions.net'
+                   '/function_name'},
+        'status': 'ACTIVE', 'entryPoint': 'entry_point', 'timeout': '60s',
+        'availableMemoryMb': 256,
+        'serviceAccountEmail': 'project_name@appspot.gserviceaccount.com',
+        'updateTime': '2018-08-23T00:00:00Z',
+        'versionId': '1', 'runtime': 'nodejs6'}
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_delete_execute(self, mock_hook):
+        mock_hook.return_value.delete_function.return_value = \
+            self._DELETE_FUNCTION_EXPECTED
+        op = GcfFunctionDeleteOperator(
+            name=self._FUNCTION_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.delete_function.assert_called_once_with(
+            'projects/project_name/locations/project_location/functions/function_name'
+        )
+        self.assertEqual(result['name'], self._FUNCTION_NAME)
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_correct_name(self, mock_hook):
+        op = GcfFunctionDeleteOperator(
+            name="projects/project_name/locations/project_location/functions"
+                 "/function_name",
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_invalid_name(self, mock_hook):
+        with self.assertRaises(AttributeError) as cm:
+            op = GcfFunctionDeleteOperator(
+                name="invalid_name",
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertEqual(str(err), 'Parameter name must match pattern: {}'.format(
+            FUNCTION_NAME_PATTERN))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_empty_name(self, mock_hook):
+        mock_hook.return_value.delete_function.return_value = \
+            self._DELETE_FUNCTION_EXPECTED
+        with self.assertRaises(AttributeError) as cm:
+            GcfFunctionDeleteOperator(
+                name="",
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertEqual(str(err), 'Empty parameter: name')
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_gcf_error_silenced_when_function_doesnt_exist(self, mock_hook):
+        op = GcfFunctionDeleteOperator(
+            name=self._FUNCTION_NAME,
+            task_id="id"
+        )
+        mock_hook.return_value.delete_function.side_effect = mock.Mock(
+            side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.delete_function.assert_called_once_with(
+            'projects/project_name/locations/project_location/functions/function_name'
+        )
+
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_non_404_gcf_error_bubbled_up(self, mock_hook):
+        op = GcfFunctionDeleteOperator(
+            name=self._FUNCTION_NAME,
+            task_id="id"
+        )
+        resp = type('', (object,), {"status": 500})()
+        mock_hook.return_value.delete_function.side_effect = mock.Mock(
+            side_effect=HttpError(resp=resp, content=b'error'))
+
+        with self.assertRaises(HttpError):
+            op.execute(None)
+
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.delete_function.assert_called_once_with(
+            'projects/project_name/locations/project_location/functions/function_name'
+        )

From 6aeda0fcb2ecbba647a6cede992bf23556c1b05c Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szym1000@gmail.com>
Date: Wed, 10 Oct 2018 11:49:57 +0200
Subject: [PATCH 103/808] [AIRFLOW-3078] Basic operators for Google Compute
 Engine (#4022)

Add GceInstanceStartOperator, GceInstanceStopOperator and GceSetMachineTypeOperator.

Each operator includes:
- core logic
- input params validation
- unit tests
- presence in the example DAG
- docstrings
- How-to and Integration documentation

Additionally, in GceHook error checking if response is 200 OK was added:

Some types of errors are only visible in the response's "error" field
and the overall HTTP response is 200 OK.

That is why apart from checking if status is "done" we also check
if "error" is empty, and if not an exception is raised with error
message extracted from the "error" field of the response.

In this commit we also separated out Body Field Validator to
separate module in tools - this way it can be reused between
various GCP operators, it has proven to be usable in at least
two of them now.

Co-authored-by: sprzedwojski <szymon.przedwojski@polidea.com>
Co-authored-by: potiuk <jarek.potiuk@polidea.com>
---
 .../example_dags/example_gcp_compute.py       | 108 +++++
 airflow/contrib/hooks/gcp_compute_hook.py     | 167 +++++++
 .../contrib/operators/gcp_compute_operator.py | 183 ++++++++
 .../operators/gcp_function_operator.py        | 281 +-----------
 airflow/contrib/utils/gcp_field_validator.py  | 417 ++++++++++++++++++
 docs/howto/operator.rst                       |  56 +++
 docs/integration.rst                          |  31 ++
 .../operators/test_gcp_compute_operator.py    | 377 ++++++++++++++++
 .../operators/test_gcp_function_operator.py   |  17 +
 9 files changed, 1370 insertions(+), 267 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_compute.py
 create mode 100644 airflow/contrib/hooks/gcp_compute_hook.py
 create mode 100644 airflow/contrib/operators/gcp_compute_operator.py
 create mode 100644 airflow/contrib/utils/gcp_field_validator.py
 create mode 100644 tests/contrib/operators/test_gcp_compute_operator.py

diff --git a/airflow/contrib/example_dags/example_gcp_compute.py b/airflow/contrib/example_dags/example_gcp_compute.py
new file mode 100644
index 0000000000000..e4abe2e152a00
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_compute.py
@@ -0,0 +1,108 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that starts, stops and sets the machine type of a Google Compute
+Engine instance.
+
+This DAG relies on the following Airflow variables
+https://airflow.apache.org/concepts.html#variables
+* PROJECT_ID - Google Cloud Platform project where the Compute Engine instance exists.
+* LOCATION - Google Cloud Platform zone where the instance exists.
+* INSTANCE - Name of the Compute Engine instance.
+* SHORT_MACHINE_TYPE_NAME - Machine type resource name to set, e.g. 'n1-standard-1'.
+    See https://cloud.google.com/compute/docs/machine-types
+"""
+
+import datetime
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_compute_operator import GceInstanceStartOperator, \
+    GceInstanceStopOperator, GceSetMachineTypeOperator
+
+# [START howto_operator_gce_args]
+PROJECT_ID = models.Variable.get('PROJECT_ID', '')
+LOCATION = models.Variable.get('LOCATION', '')
+INSTANCE = models.Variable.get('INSTANCE', '')
+SHORT_MACHINE_TYPE_NAME = models.Variable.get('SHORT_MACHINE_TYPE_NAME', '')
+SET_MACHINE_TYPE_BODY = {
+    'machineType': 'zones/{}/machineTypes/{}'.format(LOCATION, SHORT_MACHINE_TYPE_NAME)
+}
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+# [END howto_operator_gce_args]
+
+with models.DAG(
+    'example_gcp_compute',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_gce_start]
+    gce_instance_start = GceInstanceStartOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        task_id='gcp_compute_start_task'
+    )
+    # [END howto_operator_gce_start]
+    # Duplicate start for idempotence testing
+    gce_instance_start2 = GceInstanceStartOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        task_id='gcp_compute_start_task2'
+    )
+    # [START howto_operator_gce_stop]
+    gce_instance_stop = GceInstanceStopOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        task_id='gcp_compute_stop_task'
+    )
+    # [END howto_operator_gce_stop]
+    # Duplicate stop for idempotence testing
+    gce_instance_stop2 = GceInstanceStopOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        task_id='gcp_compute_stop_task2'
+    )
+    # [START howto_operator_gce_set_machine_type]
+    gce_set_machine_type = GceSetMachineTypeOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        body=SET_MACHINE_TYPE_BODY,
+        task_id='gcp_compute_set_machine_type'
+    )
+    # [END howto_operator_gce_set_machine_type]
+    # Duplicate set machine type for idempotence testing
+    gce_set_machine_type2 = GceSetMachineTypeOperator(
+        project_id=PROJECT_ID,
+        zone=LOCATION,
+        resource_id=INSTANCE,
+        body=SET_MACHINE_TYPE_BODY,
+        task_id='gcp_compute_set_machine_type2'
+    )
+
+    gce_instance_start >> gce_instance_start2 >> gce_instance_stop >> \
+        gce_instance_stop2 >> gce_set_machine_type >> gce_set_machine_type2
diff --git a/airflow/contrib/hooks/gcp_compute_hook.py b/airflow/contrib/hooks/gcp_compute_hook.py
new file mode 100644
index 0000000000000..5fa088942b706
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_compute_hook.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import time
+from googleapiclient.discovery import build
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+# Number of retries - used by googleapiclient method calls to perform retries
+# For requests that are "retriable"
+NUM_RETRIES = 5
+
+# Time to sleep between active checks of the operation results
+TIME_TO_SLEEP_IN_SECONDS = 1
+
+
+class GceOperationStatus:
+    PENDING = "PENDING"
+    RUNNING = "RUNNING"
+    DONE = "DONE"
+
+
+# noinspection PyAbstractClass
+class GceHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Compute Engine APIs.
+    """
+    _conn = None
+
+    def __init__(self,
+                 api_version,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(GceHook, self).__init__(gcp_conn_id, delegate_to)
+        self.api_version = api_version
+
+    def get_conn(self):
+        """
+        Retrieves connection to Google Compute Engine.
+
+        :return: Google Compute Engine services object
+        :rtype: dict
+        """
+        if not self._conn:
+            http_authorized = self._authorize()
+            self._conn = build('compute', self.api_version,
+                               http=http_authorized, cache_discovery=False)
+        return self._conn
+
+    def start_instance(self, project_id, zone, resource_id):
+        """
+        Starts an existing instance defined by project_id, zone and resource_id.
+
+        :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+        :type project_id: str
+        :param zone: Google Cloud Platform zone where the instance exists.
+        :type zone: str
+        :param resource_id: Name of the Compute Engine instance resource.
+        :type resource_id: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().instances().start(
+            project=project_id,
+            zone=zone,
+            instance=resource_id
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+
+    def stop_instance(self, project_id, zone, resource_id):
+        """
+        Stops an instance defined by project_id, zone and resource_id.
+
+        :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+        :type project_id: str
+        :param zone: Google Cloud Platform zone where the instance exists.
+        :type zone: str
+        :param resource_id: Name of the Compute Engine instance resource.
+        :type resource_id: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().instances().stop(
+            project=project_id,
+            zone=zone,
+            instance=resource_id
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+
+    def set_machine_type(self, project_id, zone, resource_id, body):
+        """
+        Sets machine type of an instance defined by project_id, zone and resource_id.
+
+        :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+        :type project_id: str
+        :param zone: Google Cloud Platform zone where the instance exists.
+        :type zone: str
+        :param resource_id: Name of the Compute Engine instance resource.
+        :type resource_id: str
+        :param body: Body required by the Compute Engine setMachineType API,
+        as described in
+        https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self._execute_set_machine_type(project_id, zone, resource_id, body)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+
+    def _execute_set_machine_type(self, project_id, zone, resource_id, body):
+        return self.get_conn().instances().setMachineType(
+            project=project_id, zone=zone, instance=resource_id, body=body)\
+            .execute(num_retries=NUM_RETRIES)
+
+    def _wait_for_operation_to_complete(self, project_id, zone, operation_name):
+        """
+        Waits for the named operation to complete - checks status of the
+        asynchronous call.
+
+        :param operation_name: name of the operation
+        :type operation_name: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        service = self.get_conn()
+        while True:
+            operation_response = self._check_operation_status(
+                service, operation_name, project_id, zone)
+            if operation_response.get("status") == GceOperationStatus.DONE:
+                error = operation_response.get("error")
+                if error:
+                    code = operation_response.get("httpErrorStatusCode")
+                    msg = operation_response.get("httpErrorMessage")
+                    # Extracting the errors list as string and trimming square braces
+                    error_msg = str(error.get("errors"))[1:-1]
+                    raise AirflowException("{} {}: ".format(code, msg) + error_msg)
+                # No meaningful info to return from the response in case of success
+                return True
+            time.sleep(TIME_TO_SLEEP_IN_SECONDS)
+
+    def _check_operation_status(self, service, operation_name, project_id, zone):
+        return service.zoneOperations().get(
+            project=project_id, zone=zone, operation=operation_name).execute(
+            num_retries=NUM_RETRIES)
diff --git a/airflow/contrib/operators/gcp_compute_operator.py b/airflow/contrib/operators/gcp_compute_operator.py
new file mode 100644
index 0000000000000..a2fd54529429c
--- /dev/null
+++ b/airflow/contrib/operators/gcp_compute_operator.py
@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_compute_hook import GceHook
+from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class GceBaseOperator(BaseOperator):
+    """
+    Abstract base operator for Google Compute Engine operators to inherit from.
+    """
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 zone,
+                 resource_id,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.zone = zone
+        self.full_location = 'projects/{}/zones/{}'.format(self.project_id,
+                                                           self.zone)
+        self.resource_id = resource_id
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+        self._hook = GceHook(gcp_conn_id=self.gcp_conn_id, api_version=self.api_version)
+        super(GceBaseOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is missing")
+        if not self.zone:
+            raise AirflowException("The required parameter 'zone' is missing")
+        if not self.resource_id:
+            raise AirflowException("The required parameter 'resource_id' is missing")
+
+    def execute(self, context):
+        pass
+
+
+class GceInstanceStartOperator(GceBaseOperator):
+    """
+    Start an instance in Google Compute Engine.
+
+    :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+    :type project_id: str
+    :param zone: Google Cloud Platform zone where the instance exists.
+    :type zone: str
+    :param resource_id: Name of the Compute Engine instance resource.
+    :type resource_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 zone,
+                 resource_id,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 *args, **kwargs):
+        super(GceInstanceStartOperator, self).__init__(
+            project_id=project_id, zone=zone, resource_id=resource_id,
+            gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
+
+    def execute(self, context):
+        return self._hook.start_instance(self.project_id, self.zone, self.resource_id)
+
+
+class GceInstanceStopOperator(GceBaseOperator):
+    """
+    Stop an instance in Google Compute Engine.
+
+    :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+    :type project_id: str
+    :param zone: Google Cloud Platform zone where the instance exists.
+    :type zone: str
+    :param resource_id: Name of the Compute Engine instance resource.
+    :type resource_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 zone,
+                 resource_id,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 *args, **kwargs):
+        super(GceInstanceStopOperator, self).__init__(
+            project_id=project_id, zone=zone, resource_id=resource_id,
+            gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
+
+    def execute(self, context):
+        return self._hook.stop_instance(self.project_id, self.zone, self.resource_id)
+
+
+SET_MACHINE_TYPE_VALIDATION_SPECIFICATION = [
+    dict(name="machineType", regexp="^.+$"),
+]
+
+
+class GceSetMachineTypeOperator(GceBaseOperator):
+    """
+    Changes the machine type for a stopped instance to the machine type specified in
+    the request.
+
+    :param project_id: Google Cloud Platform project where the Compute Engine
+        instance exists.
+    :type project_id: str
+    :param zone: Google Cloud Platform zone where the instance exists.
+    :type zone: str
+    :param resource_id: Name of the Compute Engine instance resource.
+    :type resource_id: str
+    :param body: Body required by the Compute Engine setMachineType API, as described in
+        https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType#request-body
+    :type body: dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 zone,
+                 resource_id,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body = body
+        self._field_validator = None
+        if validate_body:
+            self._field_validator = GcpBodyFieldValidator(
+                SET_MACHINE_TYPE_VALIDATION_SPECIFICATION, api_version=api_version)
+        super(GceSetMachineTypeOperator, self).__init__(
+            project_id=project_id, zone=zone, resource_id=resource_id,
+            gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
+
+    def _validate_all_body_fields(self):
+        if self._field_validator:
+            self._field_validator.validate(self.body)
+
+    def execute(self, context):
+        self._validate_all_body_fields()
+        return self._hook.set_machine_type(self.project_id, self.zone,
+                                           self.resource_id, self.body)
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index 4455307c93259..8207b9d084f89 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -20,277 +20,23 @@
 
 from googleapiclient.errors import HttpError
 
-from airflow import AirflowException, LoggingMixin
+from airflow import AirflowException
+from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator, \
+    GcpFieldValidationException
 from airflow.version import version
 from airflow.models import BaseOperator
 from airflow.contrib.hooks.gcp_function_hook import GcfHook
 from airflow.utils.decorators import apply_defaults
 
-# TODO: This whole section should be extracted later to contrib/tools/field_validator.py
-
-COMPOSITE_FIELD_TYPES = ['union', 'dict']
-
-
-class FieldValidationException(AirflowException):
-    """
-    Thrown when validation finds dictionary field not valid according to specification.
-    """
-
-    def __init__(self, message):
-        super(FieldValidationException, self).__init__(message)
-
-
-class ValidationSpecificationException(AirflowException):
-    """
-    Thrown when validation specification is wrong
-    (rather than dictionary being validated).
-    This should only happen during development as ideally
-     specification itself should not be invalid ;) .
-    """
-
-    def __init__(self, message):
-        super(ValidationSpecificationException, self).__init__(message)
-
-
-# TODO: make better description, add some examples
-# TODO: move to contrib/utils folder when we reuse it.
-class BodyFieldValidator(LoggingMixin):
-    """
-    Validates correctness of request body according to specification.
-    The specification can describe various type of
-    fields including custom validation, and union of fields. This validator is meant
-    to be reusable by various operators
-    in the near future, but for now it is left as part of the Google Cloud Function,
-    so documentation about the
-    validator is not yet complete. To see what kind of specification can be used,
-    please take a look at
-    gcp_function_operator.CLOUD_FUNCTION_VALIDATION which specifies validation
-    for GCF deploy operator.
-
-    :param validation_specs: dictionary describing validation specification
-    :type validation_specs: [dict]
-    :param api_version: Version of the api used (for example v1)
-    :type api_version: str
-
-    """
-    def __init__(self, validation_specs, api_version):
-        # type: ([dict], str) -> None
-        super(BodyFieldValidator, self).__init__()
-        self._validation_specs = validation_specs
-        self._api_version = api_version
-
-    @staticmethod
-    def _get_field_name_with_parent(field_name, parent):
-        if parent:
-            return parent + '.' + field_name
-        return field_name
-
-    @staticmethod
-    def _sanity_checks(children_validation_specs, field_type, full_field_path,
-                       regexp, custom_validation, value):
-        # type: (dict, str, str, str, function, object) -> None
-        if value is None and field_type != 'union':
-            raise FieldValidationException(
-                "The required body field '{}' is missing. Please add it.".
-                format(full_field_path))
-        if regexp and field_type:
-            raise ValidationSpecificationException(
-                "The validation specification entry '{}' has both type and regexp. "
-                "The regexp is only allowed without type (i.e. assume type is 'str' "
-                "that can be validated with regexp)".format(full_field_path))
-        if children_validation_specs and field_type not in COMPOSITE_FIELD_TYPES:
-            raise ValidationSpecificationException(
-                "Nested fields are specified in field '{}' of type '{}'. "
-                "Nested fields are only allowed for fields of those types: ('{}').".
-                format(full_field_path, field_type, COMPOSITE_FIELD_TYPES))
-        if custom_validation and field_type:
-            raise ValidationSpecificationException(
-                "The validation specification field '{}' has both type and "
-                "custom_validation. Custom validation is only allowed without type.".
-                format(full_field_path))
-
-    @staticmethod
-    def _validate_regexp(full_field_path, regexp, value):
-        # type: (str, str, str) -> None
-        if not re.match(regexp, value):
-            # Note matching of only the beginning as we assume the regexps all-or-nothing
-            raise FieldValidationException(
-                "The body field '{}' of value '{}' does not match the field "
-                "specification regexp: '{}'.".
-                format(full_field_path, value, regexp))
-
-    def _validate_dict(self, children_validation_specs, full_field_path, value):
-        # type: (dict, str, dict) -> None
-        for child_validation_spec in children_validation_specs:
-            self._validate_field(validation_spec=child_validation_spec,
-                                 dictionary_to_validate=value,
-                                 parent=full_field_path)
-        for field_name in value.keys():
-            if field_name not in [spec['name'] for spec in children_validation_specs]:
-                self.log.warning(
-                    "The field '{}' is in the body, but is not specified in the "
-                    "validation specification '{}'. "
-                    "This might be because you are using newer API version and "
-                    "new field names defined for that version. Then the warning "
-                    "can be safely ignored, or you might want to upgrade the operator"
-                    "to the version that supports the new API version.".format(
-                        self._get_field_name_with_parent(field_name, full_field_path),
-                        children_validation_specs))
-
-    def _validate_union(self, children_validation_specs, full_field_path,
-                        dictionary_to_validate):
-        # type: (dict, str, dict) -> None
-        field_found = False
-        found_field_name = None
-        for child_validation_spec in children_validation_specs:
-            # Forcing optional so that we do not have to type optional = True
-            # in specification for all union fields
-            new_field_found = self._validate_field(
-                validation_spec=child_validation_spec,
-                dictionary_to_validate=dictionary_to_validate,
-                parent=full_field_path,
-                force_optional=True)
-            field_name = child_validation_spec['name']
-            if new_field_found and field_found:
-                raise FieldValidationException(
-                    "The mutually exclusive fields '{}' and '{}' belonging to the "
-                    "union '{}' are both present. Please remove one".
-                    format(field_name, found_field_name, full_field_path))
-            if new_field_found:
-                field_found = True
-                found_field_name = field_name
-        if not field_found:
-            self.log.warning(
-                "There is no '{}' union defined in the body {}. "
-                "Validation expected one of '{}' but could not find any. It's possible "
-                "that you are using newer API version and there is another union variant "
-                "defined for that version. Then the warning can be safely ignored, "
-                "or you might want to upgrade the operator to the version that "
-                "supports the new API version.".format(
-                    full_field_path,
-                    dictionary_to_validate,
-                    [field['name'] for field in children_validation_specs]))
-
-    def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
-                        force_optional=False):
-        """
-        Validates if field is OK.
-        :param validation_spec: specification of the field
-        :type validation_spec: dict
-        :param dictionary_to_validate: dictionary where the field should be present
-        :type dictionary_to_validate: dict
-        :param parent: full path of parent field
-        :type parent: str
-        :param force_optional: forces the field to be optional
-          (all union fields have force_optional set to True)
-        :type force_optional: bool
-        :return: True if the field is present
-        """
-        field_name = validation_spec['name']
-        field_type = validation_spec.get('type')
-        optional = validation_spec.get('optional')
-        regexp = validation_spec.get('regexp')
-        children_validation_specs = validation_spec.get('fields')
-        required_api_version = validation_spec.get('api_version')
-        custom_validation = validation_spec.get('custom_validation')
-
-        full_field_path = self._get_field_name_with_parent(field_name=field_name,
-                                                           parent=parent)
-        if required_api_version and required_api_version != self._api_version:
-            self.log.debug(
-                "Skipping validation of the field '{}' for API version '{}' "
-                "as it is only valid for API version '{}'".
-                format(field_name, self._api_version, required_api_version))
-            return False
-        value = dictionary_to_validate.get(field_name)
-
-        if (optional or force_optional) and value is None:
-            self.log.debug("The optional field '{}' is missing. That's perfectly OK.".
-                           format(full_field_path))
-            return False
-
-        # Certainly down from here the field is present (value is not None)
-        # so we should only return True from now on
-
-        self._sanity_checks(children_validation_specs=children_validation_specs,
-                            field_type=field_type,
-                            full_field_path=full_field_path,
-                            regexp=regexp,
-                            custom_validation=custom_validation,
-                            value=value)
-
-        if regexp:
-            self._validate_regexp(full_field_path, regexp, value)
-        elif field_type == 'dict':
-            if not isinstance(value, dict):
-                raise FieldValidationException(
-                    "The field '{}' should be dictionary type according to "
-                    "specification '{}' but it is '{}'".
-                    format(full_field_path, validation_spec, value))
-            if children_validation_specs is None:
-                self.log.debug(
-                    "The dict field '{}' has no nested fields defined in the "
-                    "specification '{}'. That's perfectly ok - it's content will "
-                    "not be validated."
-                        .format(full_field_path, validation_spec))
-            else:
-                self._validate_dict(children_validation_specs, full_field_path, value)
-        elif field_type == 'union':
-            if not children_validation_specs:
-                raise ValidationSpecificationException(
-                    "The union field '{}' has no nested fields "
-                    "defined in specification '{}'. Unions should have at least one "
-                    "nested field defined.".format(full_field_path, validation_spec))
-            self._validate_union(children_validation_specs, full_field_path,
-                                 dictionary_to_validate)
-        elif custom_validation:
-            try:
-                custom_validation(value)
-            except Exception as e:
-                raise FieldValidationException(
-                    "Error while validating custom field '{}' specified by '{}': '{}'".
-                    format(full_field_path, validation_spec, e))
-        elif field_type is None:
-            self.log.debug("The type of field '{}' is not specified in '{}'. "
-                           "Not validating its content.".
-                           format(full_field_path, validation_spec))
-        else:
-            raise ValidationSpecificationException(
-                "The field '{}' is of type '{}' in specification '{}'."
-                "This type is unknown to validation!".format(
-                    full_field_path, field_type, validation_spec))
-        return True
-
-    def validate(self, body_to_validate):
-        """
-        Validates if the body (dictionary) follows specification that the validator was
-        instantiated with. Raises ValidationSpecificationException or
-        ValidationFieldException in case of problems with specification or the
-        body not conforming to the specification respectively.
-        :param body_to_validate: body that must follow the specification
-        :type body_to_validate: dict
-        :return: None
-        """
-        try:
-            for validation_spec in self._validation_specs:
-                self._validate_field(validation_spec=validation_spec,
-                                     dictionary_to_validate=body_to_validate)
-        except FieldValidationException as e:
-            raise FieldValidationException(
-                "There was an error when validating: field '{}': '{}'".
-                format(body_to_validate, e))
-
-# TODO End of field validator to be extracted
-
 
 def _validate_available_memory_in_mb(value):
     if int(value) <= 0:
-        raise FieldValidationException("The available memory has to be greater than 0")
+        raise GcpFieldValidationException("The available memory has to be greater than 0")
 
 
 def _validate_max_instances(value):
     if int(value) <= 0:
-        raise FieldValidationException(
+        raise GcpFieldValidationException(
             "The max instances parameter has to be greater than 0")
 
 
@@ -378,9 +124,10 @@ def __init__(self,
         self.api_version = api_version
         self.zip_path = zip_path
         self.zip_path_preprocessor = ZipPathPreprocessor(body, zip_path)
-        self.validate_body = validate_body
-        self._field_validator = BodyFieldValidator(CLOUD_FUNCTION_VALIDATION,
-                                                   api_version=api_version)
+        self._field_validator = None
+        if validate_body:
+            self._field_validator = GcpBodyFieldValidator(CLOUD_FUNCTION_VALIDATION,
+                                                          api_version=api_version)
         self._hook = GcfHook(gcp_conn_id=self.gcp_conn_id, api_version=self.api_version)
         self._validate_inputs()
         super(GcfFunctionDeployOperator, self).__init__(*args, **kwargs)
@@ -395,7 +142,8 @@ def _validate_inputs(self):
         self.zip_path_preprocessor.preprocess_body()
 
     def _validate_all_body_fields(self):
-        self._field_validator.validate(self.body)
+        if self._field_validator:
+            self._field_validator.validate(self.body)
 
     def _create_new_function(self):
         self._hook.create_new_function(self.full_location, self.body)
@@ -406,8 +154,8 @@ def _update_function(self):
     def _check_if_function_exists(self):
         name = self.body.get('name')
         if not name:
-            raise FieldValidationException("The 'name' field should be present in "
-                                           "body: '{}'.".format(self.body))
+            raise GcpFieldValidationException("The 'name' field should be present in "
+                                              "body: '{}'.".format(self.body))
         try:
             self._hook.get_function(name)
         except HttpError as e:
@@ -430,8 +178,7 @@ def _set_airflow_version_label(self):
     def execute(self, context):
         if self.zip_path_preprocessor.should_upload_function():
             self.body[SOURCE_UPLOAD_URL] = self._upload_source_code()
-        if self.validate_body:
-            self._validate_all_body_fields()
+        self._validate_all_body_fields()
         self._set_airflow_version_label()
         if not self._check_if_function_exists():
             self._create_new_function()
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
new file mode 100644
index 0000000000000..20f72d94b813a
--- /dev/null
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -0,0 +1,417 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+"""Validator for body fields sent via GCP API.
+
+The validator performs validation of the body (being dictionary of fields) that
+is sent in the API request to Google Cloud (via googleclient API usually).
+
+Context
+-------
+The specification mostly focuses on helping Airflow DAG developers in the development
+phase. You can build your own GCP operator (such as GcfDeployOperator for example) which
+can have built-in validation specification for the particular API. It's super helpful
+when developer plays with different fields and their values at the initial phase of
+DAG development. Most of the Google Cloud APIs perform their own validation on the
+server side, but most of the requests are asynchronous and you need to wait for result
+of the operation. This takes precious times and slows
+down iteration over the API. BodyFieldValidator is meant to be used on the client side
+and it should therefore provide an instant feedback to the developer on misspelled or
+wrong type of parameters.
+
+The validation should be performed in "execute()" method call in order to allow
+template parameters to be expanded before validation is performed.
+
+Types of fields
+---------------
+
+Specification is an array of dictionaries - each dictionary describes field, its type,
+validation, optionality, api_version supported and nested fields (for unions and dicts).
+
+Typically (for clarity and in order to aid syntax highlighting) the array of
+dicts should be defined as series of dict() executions. Fragment of example
+specification might look as follows:
+
+```
+SPECIFICATION =[
+   dict(name="an_union", type="union", optional=True, fields=[
+       dict(name="variant_1", type="dict"),
+       dict(name="variant_2", regexp=r'^.+$', api_version='v1beta2'),
+   ),
+   dict(name="an_union", type="dict", fields=[
+       dict(name="field_1", type="dict"),
+       dict(name="field_2", regexp=r'^.+$'),
+   ),
+   ...
+]
+```
+
+Each field should have key = "name" indicating field name. The field can be of one of the
+following types:
+
+* Dict fields: (key = "type", value="dict"):
+  Field of this type should contain nested fields in form of an array of dicts.
+  Each of the fields in the array is then expected (unless marked as optional)
+  and validated recursively. If an extra field is present in the dictionary, warning is
+  printed in log file (but the validation succeeds - see the Forward-compatibility notes)
+* Union fields (key = "type", value="union"): field of this type should contain nested
+  fields in form of an array of dicts. One of the fields (and only one) should be
+  present (unless the union is marked as optional). If more than one union field is
+  present, FieldValidationException is raised. If none of the union fields is
+  present - warning is printed in the log (see below Forward-compatibility notes).
+* Regexp-validated fields: (key = "regexp") - fields of this type are assumed to be
+  strings and they are validated with the regexp specified. Remember that the regexps
+  should ideally contain ^ at the beginning and $ at the end to make sure that
+  the whole field content is validated. Typically such regexp
+  validations should be used carefully and sparingly (see Forward-compatibility
+  notes below). Most of regexp validation should be at most r'^.+$'.
+* Custom-validated fields: (key = "custom_validation") - fields of this type are validated
+  using method specified via custom_validation field. Any exception thrown in the custom
+  validation will be turned into FieldValidationException and will cause validation to
+  fail. Such custom validations might be used to check numeric fields (including
+  ranges of values), booleans or any other types of fields.
+* API version: (key="api_version") if API version is specified, then the field will only
+  be validated when api_version used at field validator initialization matches exactly the
+  the version specified. If you want to declare fields that are available in several
+  versions of the APIs, you should specify the field as many times as many API versions
+  should be supported (each time with different API version).
+* if none of the keys ("type", "regexp", "custom_validation" - the field is not validated
+
+You can see some of the field examples in EXAMPLE_VALIDATION_SPECIFICATION.
+
+
+Forward-compatibility notes
+---------------------------
+Certain decisions are crucial to allow the client APIs to work also with future API
+versions. Since body attached is passed to the API’s call, this is entirely
+possible to pass-through any new fields in the body (for future API versions) -
+albeit without validation on the client side - they can and will still be validated
+on the server side usually.
+
+Here are the guidelines that you should follow to make validation forward-compatible:
+
+* most of the fields are not validated for their content. It's possible to use regexp
+  in some specific cases that are guaranteed not to change in the future, but for most
+  fields regexp validation should be r'^.+$' indicating check for non-emptiness
+* api_version is not validated - user can pass any future version of the api here. The API
+  version is only used to filter parameters that are marked as present in this api version
+  any new (not present in the specification) fields in the body are allowed (not verified)
+  For dictionaries, new fields can be added to dictionaries by future calls. However if an
+  unknown field in dictionary is added, a warning is logged by the client (but validation
+  remains successful). This is very nice feature to protect against typos in names.
+* For unions, newly added union variants can be added by future calls and they will
+  pass validation, however the content or presence of those fields will not be validated.
+  This means that it’s possible to send a new non-validated union field together with an
+  old validated field and this problem will not be detected by the client. In such case
+  warning will be printed.
+* When you add validator to an operator, you should also add ``validate_body`` parameter
+  (default = True) to __init__ of such operators - when it is set to False,
+  no validation should be performed. This is a safeguard for totally unpredicted and
+  backwards-incompatible changes that might sometimes occur in the APIs.
+
+"""
+
+import re
+
+from airflow import LoggingMixin, AirflowException
+
+COMPOSITE_FIELD_TYPES = ['union', 'dict']
+
+
+class GcpFieldValidationException(AirflowException):
+    """Thrown when validation finds dictionary field not valid according to specification.
+    """
+
+    def __init__(self, message):
+        super(GcpFieldValidationException, self).__init__(message)
+
+
+class GcpValidationSpecificationException(AirflowException):
+    """Thrown when validation specification is wrong.
+
+    This should only happen during development as ideally
+     specification itself should not be invalid ;) .
+    """
+
+    def __init__(self, message):
+        super(GcpValidationSpecificationException, self).__init__(message)
+
+
+def _int_greater_than_zero(value):
+    if int(value) <= 0:
+        raise GcpFieldValidationException("The available memory has to be greater than 0")
+
+
+EXAMPLE_VALIDATION_SPECIFICATION = [
+    dict(name="name", regexp="^.+$"),
+    dict(name="description", regexp="^.+$", optional=True),
+    dict(name="availableMemoryMb", custom_validation=_int_greater_than_zero,
+         optional=True),
+    dict(name="labels", optional=True, type="dict"),
+    dict(name="an_union", type="union", fields=[
+        dict(name="variant_1", regexp=r'^.+$'),
+        dict(name="variant_2", regexp=r'^.+$', api_version='v1beta2'),
+        dict(name="variant_3", type="dict", fields=[
+            dict(name="url", regexp=r'^.+$')
+        ]),
+        dict(name="variant_4")
+    ]),
+]
+
+
+class GcpBodyFieldValidator(LoggingMixin):
+    """Validates correctness of request body according to specification.
+
+    The specification can describe various type of
+    fields including custom validation, and union of fields. This validator is
+    to be reusable by various operators. See the EXAMPLE_VALIDATION_SPECIFICATION
+    for some examples and explanations of how to create specification.
+
+    :param validation_specs: dictionary describing validation specification
+    :type validation_specs: [dict]
+    :param api_version: Version of the api used (for example v1)
+    :type api_version: str
+
+    """
+    def __init__(self, validation_specs, api_version):
+        # type: ([dict], str) -> None
+        super(GcpBodyFieldValidator, self).__init__()
+        self._validation_specs = validation_specs
+        self._api_version = api_version
+
+    @staticmethod
+    def _get_field_name_with_parent(field_name, parent):
+        if parent:
+            return parent + '.' + field_name
+        return field_name
+
+    @staticmethod
+    def _sanity_checks(children_validation_specs, field_type, full_field_path,
+                       regexp, custom_validation, value):
+        # type: (dict, str, str, str, function, object) -> None
+        if value is None and field_type != 'union':
+            raise GcpFieldValidationException(
+                "The required body field '{}' is missing. Please add it.".
+                format(full_field_path))
+        if regexp and field_type:
+            raise GcpValidationSpecificationException(
+                "The validation specification entry '{}' has both type and regexp. "
+                "The regexp is only allowed without type (i.e. assume type is 'str' "
+                "that can be validated with regexp)".format(full_field_path))
+        if children_validation_specs and field_type not in COMPOSITE_FIELD_TYPES:
+            raise GcpValidationSpecificationException(
+                "Nested fields are specified in field '{}' of type '{}'. "
+                "Nested fields are only allowed for fields of those types: ('{}').".
+                format(full_field_path, field_type, COMPOSITE_FIELD_TYPES))
+        if custom_validation and field_type:
+            raise GcpValidationSpecificationException(
+                "The validation specification field '{}' has both type and "
+                "custom_validation. Custom validation is only allowed without type.".
+                format(full_field_path))
+
+    @staticmethod
+    def _validate_regexp(full_field_path, regexp, value):
+        # type: (str, str, str) -> None
+        if not re.match(regexp, value):
+            # Note matching of only the beginning as we assume the regexps all-or-nothing
+            raise GcpFieldValidationException(
+                "The body field '{}' of value '{}' does not match the field "
+                "specification regexp: '{}'.".
+                format(full_field_path, value, regexp))
+
+    def _validate_dict(self, children_validation_specs, full_field_path, value):
+        # type: (dict, str, dict) -> None
+        for child_validation_spec in children_validation_specs:
+            self._validate_field(validation_spec=child_validation_spec,
+                                 dictionary_to_validate=value,
+                                 parent=full_field_path)
+        all_dict_keys = [spec['name'] for spec in children_validation_specs]
+        for field_name in value.keys():
+            if field_name not in all_dict_keys:
+                self.log.warning(
+                    "The field '{}' is in the body, but is not specified in the "
+                    "validation specification '{}'. "
+                    "This might be because you are using newer API version and "
+                    "new field names defined for that version. Then the warning "
+                    "can be safely ignored, or you might want to upgrade the operator"
+                    "to the version that supports the new API version.".format(
+                        self._get_field_name_with_parent(field_name, full_field_path),
+                        children_validation_specs))
+
+    def _validate_union(self, children_validation_specs, full_field_path,
+                        dictionary_to_validate):
+        # type: (dict, str, dict) -> None
+        field_found = False
+        found_field_name = None
+        for child_validation_spec in children_validation_specs:
+            # Forcing optional so that we do not have to type optional = True
+            # in specification for all union fields
+            new_field_found = self._validate_field(
+                validation_spec=child_validation_spec,
+                dictionary_to_validate=dictionary_to_validate,
+                parent=full_field_path,
+                force_optional=True)
+            field_name = child_validation_spec['name']
+            if new_field_found and field_found:
+                raise GcpFieldValidationException(
+                    "The mutually exclusive fields '{}' and '{}' belonging to the "
+                    "union '{}' are both present. Please remove one".
+                    format(field_name, found_field_name, full_field_path))
+            if new_field_found:
+                field_found = True
+                found_field_name = field_name
+        if not field_found:
+            self.log.warning(
+                "There is no '{}' union defined in the body {}. "
+                "Validation expected one of '{}' but could not find any. It's possible "
+                "that you are using newer API version and there is another union variant "
+                "defined for that version. Then the warning can be safely ignored, "
+                "or you might want to upgrade the operator to the version that "
+                "supports the new API version.".format(
+                    full_field_path,
+                    dictionary_to_validate,
+                    [field['name'] for field in children_validation_specs]))
+
+    def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
+                        force_optional=False):
+        """
+        Validates if field is OK.
+        :param validation_spec: specification of the field
+        :type validation_spec: dict
+        :param dictionary_to_validate: dictionary where the field should be present
+        :type dictionary_to_validate: dict
+        :param parent: full path of parent field
+        :type parent: str
+        :param force_optional: forces the field to be optional
+          (all union fields have force_optional set to True)
+        :type force_optional: bool
+        :return: True if the field is present
+        """
+        field_name = validation_spec['name']
+        field_type = validation_spec.get('type')
+        optional = validation_spec.get('optional')
+        regexp = validation_spec.get('regexp')
+        children_validation_specs = validation_spec.get('fields')
+        required_api_version = validation_spec.get('api_version')
+        custom_validation = validation_spec.get('custom_validation')
+
+        full_field_path = self._get_field_name_with_parent(field_name=field_name,
+                                                           parent=parent)
+        if required_api_version and required_api_version != self._api_version:
+            self.log.debug(
+                "Skipping validation of the field '{}' for API version '{}' "
+                "as it is only valid for API version '{}'".
+                format(field_name, self._api_version, required_api_version))
+            return False
+        value = dictionary_to_validate.get(field_name)
+
+        if (optional or force_optional) and value is None:
+            self.log.debug("The optional field '{}' is missing. That's perfectly OK.".
+                           format(full_field_path))
+            return False
+
+        # Certainly down from here the field is present (value is not None)
+        # so we should only return True from now on
+
+        self._sanity_checks(children_validation_specs=children_validation_specs,
+                            field_type=field_type,
+                            full_field_path=full_field_path,
+                            regexp=regexp,
+                            custom_validation=custom_validation,
+                            value=value)
+
+        if regexp:
+            self._validate_regexp(full_field_path, regexp, value)
+        elif field_type == 'dict':
+            if not isinstance(value, dict):
+                raise GcpFieldValidationException(
+                    "The field '{}' should be dictionary type according to "
+                    "specification '{}' but it is '{}'".
+                    format(full_field_path, validation_spec, value))
+            if children_validation_specs is None:
+                self.log.debug(
+                    "The dict field '{}' has no nested fields defined in the "
+                    "specification '{}'. That's perfectly ok - it's content will "
+                    "not be validated."
+                        .format(full_field_path, validation_spec))
+            else:
+                self._validate_dict(children_validation_specs, full_field_path, value)
+        elif field_type == 'union':
+            if not children_validation_specs:
+                raise GcpValidationSpecificationException(
+                    "The union field '{}' has no nested fields "
+                    "defined in specification '{}'. Unions should have at least one "
+                    "nested field defined.".format(full_field_path, validation_spec))
+            self._validate_union(children_validation_specs, full_field_path,
+                                 dictionary_to_validate)
+        elif custom_validation:
+            try:
+                custom_validation(value)
+            except Exception as e:
+                raise GcpFieldValidationException(
+                    "Error while validating custom field '{}' specified by '{}': '{}'".
+                    format(full_field_path, validation_spec, e))
+        elif field_type is None:
+            self.log.debug("The type of field '{}' is not specified in '{}'. "
+                           "Not validating its content.".
+                           format(full_field_path, validation_spec))
+        else:
+            raise GcpValidationSpecificationException(
+                "The field '{}' is of type '{}' in specification '{}'."
+                "This type is unknown to validation!".format(
+                    full_field_path, field_type, validation_spec))
+        return True
+
+    def validate(self, body_to_validate):
+        """
+        Validates if the body (dictionary) follows specification that the validator was
+        instantiated with. Raises ValidationSpecificationException or
+        ValidationFieldException in case of problems with specification or the
+        body not conforming to the specification respectively.
+        :param body_to_validate: body that must follow the specification
+        :type body_to_validate: dict
+        :return: None
+        """
+        try:
+            for validation_spec in self._validation_specs:
+                self._validate_field(validation_spec=validation_spec,
+                                     dictionary_to_validate=body_to_validate)
+        except GcpFieldValidationException as e:
+            raise GcpFieldValidationException(
+                "There was an error when validating: body '{}': '{}'".
+                format(body_to_validate, e))
+        all_field_names = [spec['name'] for spec in self._validation_specs
+                           if spec.get('type') != 'union' and
+                           spec.get('api_version') != self._api_version]
+        all_union_fields = [spec for spec in self._validation_specs
+                            if spec.get('type') == 'union']
+        for union_field in all_union_fields:
+            all_field_names.extend(
+                [nested_union_spec['name'] for nested_union_spec in union_field['fields']
+                 if nested_union_spec.get('type') != 'union' and
+                 nested_union_spec.get('api_version') != self._api_version])
+        for field_name in body_to_validate.keys():
+            if field_name not in all_field_names:
+                self.log.warning(
+                    "The field '{}' is in the body, but is not specified in the "
+                    "validation specification '{}'. "
+                    "This might be because you are using newer API version and "
+                    "new field names defined for that version. Then the warning "
+                    "can be safely ignored, or you might want to upgrade the operator"
+                    "to the version that supports the new API version.".format(
+                        field_name, self._validation_specs))
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 0d973a391cc7b..549d67757049f 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -102,6 +102,62 @@ to execute a BigQuery load job.
     :start-after: [START howto_operator_gcs_to_bq]
     :end-before: [END howto_operator_gcs_to_bq]
 
+GceInstanceStartOperator
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Allows to start an existing Google Compute Engine instance.
+
+In this example parameter values are extracted from Airflow variables.
+Moreover, the ``default_args`` dict is used to pass common arguments to all operators in a single DAG.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args]
+    :end-before: [END howto_operator_gce_args]
+
+
+Define the :class:`~airflow.contrib.operators.gcp_compute_operator
+.GceInstanceStartOperator` by passing the required arguments to the constructor.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_start]
+    :end-before: [END howto_operator_gce_start]
+
+GceInstanceStopOperator
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Allows to stop an existing Google Compute Engine instance.
+
+For parameter definition take a look at :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator` above.
+
+Define the :class:`~airflow.contrib.operators.gcp_compute_operator
+.GceInstanceStopOperator` by passing the required arguments to the constructor.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_stop]
+    :end-before: [END howto_operator_gce_stop]
+
+GceSetMachineTypeOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Allows to change the machine type for a stopped instance to the specified machine type.
+
+For parameter definition take a look at :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator` above.
+
+Define the :class:`~airflow.contrib.operators.gcp_compute_operator
+.GceSetMachineTypeOperator` by passing the required arguments to the constructor.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_set_machine_type]
+    :end-before: [END howto_operator_gce_set_machine_type]
+
+
 GcfFunctionDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/integration.rst b/docs/integration.rst
index c7778650e0c8c..dd65ebbe81f81 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -439,6 +439,37 @@ BigQueryHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
     :members:
 
+Compute Engine
+''''''''''''''
+
+Compute Engine Operators
+""""""""""""""""""""""""
+
+- :ref:`GceInstanceStartOperator` : start an existing Google Compute Engine instance.
+- :ref:`GceInstanceStopOperator` : stop an existing Google Compute Engine instance.
+- :ref:`GceSetMachineTypeOperator` : change the machine type for a stopped instance.
+
+.. _GceInstanceStartOperator:
+
+GceInstanceStartOperator
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
+
+.. _GceInstanceStopOperator:
+
+GceInstanceStopOperator
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
+
+.. _GceSetMachineTypeOperator:
+
+GceSetMachineTypeOperator
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
+
 
 Cloud Functions
 '''''''''''''''
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
new file mode 100644
index 0000000000000..449c4e015fdda
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -0,0 +1,377 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import ast
+import unittest
+
+from airflow import AirflowException, configuration
+from airflow.contrib.operators.gcp_compute_operator import GceInstanceStartOperator, \
+    GceInstanceStopOperator, GceSetMachineTypeOperator
+from airflow.models import TaskInstance, DAG
+from airflow.utils import timezone
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PROJECT_ID = 'project-id'
+LOCATION = 'zone'
+RESOURCE_ID = 'resource-id'
+SHORT_MACHINE_TYPE_NAME = 'n1-machine-type'
+SET_MACHINE_TYPE_BODY = {
+    'machineType': 'zones/{}/machineTypes/{}'.format(LOCATION, SHORT_MACHINE_TYPE_NAME)
+}
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+
+class GceInstanceStartTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_instance_start(self, mock_hook):
+        mock_hook.return_value.start_instance.return_value = True
+        op = GceInstanceStartOperator(
+            project_id=PROJECT_ID,
+            zone=LOCATION,
+            resource_id=RESOURCE_ID,
+            task_id='id'
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.start_instance.assert_called_once_with(
+            PROJECT_ID, LOCATION, RESOURCE_ID
+        )
+        self.assertTrue(result)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all fields
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_instance_start_with_templates(self, mock_hook):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG(dag_id, default_args=args)
+        op = GceInstanceStartOperator(
+            project_id='{{ dag.dag_id }}',
+            zone='{{ dag.dag_id }}',
+            resource_id='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id='id',
+            dag=self.dag
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'project_id'))
+        self.assertEqual(dag_id, getattr(op, 'zone'))
+        self.assertEqual(dag_id, getattr(op, 'resource_id'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_start_should_throw_ex_when_missing_project_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStartOperator(
+                project_id="",
+                zone=LOCATION,
+                resource_id=RESOURCE_ID,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'project_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_start_should_throw_ex_when_missing_zone(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStartOperator(
+                project_id=PROJECT_ID,
+                zone="",
+                resource_id=RESOURCE_ID,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'zone' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_start_should_throw_ex_when_missing_resource_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStartOperator(
+                project_id=PROJECT_ID,
+                zone=LOCATION,
+                resource_id="",
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'resource_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_instance_stop(self, mock_hook):
+        mock_hook.return_value.stop_instance.return_value = True
+        op = GceInstanceStopOperator(
+            project_id=PROJECT_ID,
+            zone=LOCATION,
+            resource_id=RESOURCE_ID,
+            task_id='id'
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.stop_instance.assert_called_once_with(
+            PROJECT_ID, LOCATION, RESOURCE_ID
+        )
+        self.assertTrue(result)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all fields
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_instance_stop_with_templates(self, mock_hook):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG(dag_id, default_args=args)
+        op = GceInstanceStopOperator(
+            project_id='{{ dag.dag_id }}',
+            zone='{{ dag.dag_id }}',
+            resource_id='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id='id',
+            dag=self.dag
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'project_id'))
+        self.assertEqual(dag_id, getattr(op, 'zone'))
+        self.assertEqual(dag_id, getattr(op, 'resource_id'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_stop_should_throw_ex_when_missing_project_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStopOperator(
+                project_id="",
+                zone=LOCATION,
+                resource_id=RESOURCE_ID,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'project_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_stop_should_throw_ex_when_missing_zone(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStopOperator(
+                project_id=PROJECT_ID,
+                zone="",
+                resource_id=RESOURCE_ID,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'zone' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_stop_should_throw_ex_when_missing_resource_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceStopOperator(
+                project_id=PROJECT_ID,
+                zone=LOCATION,
+                resource_id="",
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'resource_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type(self, mock_hook):
+        mock_hook.return_value.set_machine_type.return_value = True
+        op = GceSetMachineTypeOperator(
+            project_id=PROJECT_ID,
+            zone=LOCATION,
+            resource_id=RESOURCE_ID,
+            body=SET_MACHINE_TYPE_BODY,
+            task_id='id'
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.set_machine_type.assert_called_once_with(
+            PROJECT_ID, LOCATION, RESOURCE_ID, SET_MACHINE_TYPE_BODY
+        )
+        self.assertTrue(result)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all fields
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_with_templates(self, mock_hook):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG(dag_id, default_args=args)
+        op = GceSetMachineTypeOperator(
+            project_id='{{ dag.dag_id }}',
+            zone='{{ dag.dag_id }}',
+            resource_id='{{ dag.dag_id }}',
+            body={},
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id='id',
+            dag=self.dag
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'project_id'))
+        self.assertEqual(dag_id, getattr(op, 'zone'))
+        self.assertEqual(dag_id, getattr(op, 'resource_id'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_should_throw_ex_when_missing_project_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceSetMachineTypeOperator(
+                project_id="",
+                zone=LOCATION,
+                resource_id=RESOURCE_ID,
+                body=SET_MACHINE_TYPE_BODY,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'project_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_should_throw_ex_when_missing_zone(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceSetMachineTypeOperator(
+                project_id=PROJECT_ID,
+                zone="",
+                resource_id=RESOURCE_ID,
+                body=SET_MACHINE_TYPE_BODY,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'zone' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_should_throw_ex_when_missing_resource_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceSetMachineTypeOperator(
+                project_id=PROJECT_ID,
+                zone=LOCATION,
+                resource_id="",
+                body=SET_MACHINE_TYPE_BODY,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'resource_id' is missing", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GceSetMachineTypeOperator(
+                project_id=PROJECT_ID,
+                zone=LOCATION,
+                resource_id=RESOURCE_ID,
+                body={},
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn(
+            "The required body field 'machineType' is missing. Please add it.", str(err))
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+    MOCK_OP_RESPONSE = "{'kind': 'compute#operation', 'id': '8529919847974922736', " \
+                       "'name': " \
+                       "'operation-1538578207537-577542784f769-7999ab71-94f9ec1d', " \
+                       "'zone': 'https://www.googleapis.com/compute/v1/projects/polidea" \
+                       "-airflow/zones/europe-west3-b', 'operationType': " \
+                       "'setMachineType', 'targetLink': " \
+                       "'https://www.googleapis.com/compute/v1/projects/polidea-airflow" \
+                       "/zones/europe-west3-b/instances/pa-1', 'targetId': " \
+                       "'2480086944131075860', 'status': 'DONE', 'user': " \
+                       "'uberdarek@polidea-airflow.iam.gserviceaccount.com', " \
+                       "'progress': 100, 'insertTime': '2018-10-03T07:50:07.951-07:00', "\
+                       "'startTime': '2018-10-03T07:50:08.324-07:00', 'endTime': " \
+                       "'2018-10-03T07:50:08.484-07:00', 'error': {'errors': [{'code': " \
+                       "'UNSUPPORTED_OPERATION', 'message': \"Machine type with name " \
+                       "'machine-type-1' does not exist in zone 'europe-west3-b'.\"}]}, "\
+                       "'httpErrorStatusCode': 400, 'httpErrorMessage': 'BAD REQUEST', " \
+                       "'selfLink': " \
+                       "'https://www.googleapis.com/compute/v1/projects/polidea-airflow" \
+                       "/zones/europe-west3-b/operations/operation-1538578207537" \
+                       "-577542784f769-7999ab71-94f9ec1d'} "
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook'
+                '._check_operation_status')
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook'
+                '._execute_set_machine_type')
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook.get_conn')
+    def test_set_machine_type_should_handle_and_trim_gce_error(
+            self, get_conn, _execute_set_machine_type, _check_operation_status):
+        get_conn.return_value = {}
+        _execute_set_machine_type.return_value = {"name": "test-operation"}
+        _check_operation_status.return_value = ast.literal_eval(self.MOCK_OP_RESPONSE)
+        with self.assertRaises(AirflowException) as cm:
+            op = GceSetMachineTypeOperator(
+                project_id=PROJECT_ID,
+                zone=LOCATION,
+                resource_id=RESOURCE_ID,
+                body=SET_MACHINE_TYPE_BODY,
+                task_id='id'
+            )
+            op.execute(None)
+        err = cm.exception
+        _check_operation_status.assert_called_once_with(
+            {}, "test-operation", PROJECT_ID, LOCATION)
+        _execute_set_machine_type.assert_called_once_with(
+            PROJECT_ID, LOCATION, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
+        # Checking the full message was sometimes failing due to different order
+        # of keys in the serialized JSON
+        self.assertIn("400 BAD REQUEST: {", str(err))  # checking the square bracket trim
+        self.assertIn("UNSUPPORTED_OPERATION", str(err))
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
index d7585ae66fdef..4192560dd984c 100644
--- a/tests/contrib/operators/test_gcp_function_operator.py
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -519,6 +519,23 @@ def test_valid_trigger_union_field(self, trigger, mock_hook):
         )
         mock_hook.reset_mock()
 
+    @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
+    def test_extra_parameter(self, mock_hook):
+        mock_hook.return_value.list_functions.return_value = []
+        mock_hook.return_value.create_new_function.return_value = True
+        body = deepcopy(VALID_BODY)
+        body['extra_parameter'] = 'extra'
+        op = GcfFunctionDeployOperator(
+            project_id="test_project_id",
+            location="test_region",
+            body=body,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.reset_mock()
+
 
 class GcfFunctionDeleteTest(unittest.TestCase):
     _FUNCTION_NAME = 'projects/project_name/locations/project_location/functions' \

From cab121bc036be24bcb1e397f48ca1672e1f73692 Mon Sep 17 00:00:00 2001
From: Greg Neiheisel <greg@astronomer.io>
Date: Fri, 12 Oct 2018 01:51:13 -0400
Subject: [PATCH 104/808] [AIRFLOW-3177] Change scheduler_heartbeat from gauge
 to counter (#4027)

This updates the scheduler_heartbeat metric from a gauge to a counter to
better support the statsd_exporter for usage with Prometheus. A counter
allows users to track the rate of the heartbeat, and integrates with the
exporter better. A crashing or down scheduler will no longer emit the
metric, but the statsd_exporter will continue to show a 1 for the metric
value. This fixes that issue because a counter will continually change,
and the lack of change indicates an issue with the scheduler.

Add statsd change notice in UPDATING.md
---
 UPDATING.md     | 62 +++++++++++++++++++++++++++++++++++++++++++++++++
 airflow/jobs.py |  2 +-
 2 files changed, 63 insertions(+), 1 deletion(-)

diff --git a/UPDATING.md b/UPDATING.md
index 130df60530c4c..f1a76aeda0948 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -21,6 +21,68 @@ that he has permissions on. If a new role wants to access all the dags, the admi
 
 We also provide a new cli command(``sync_perm``) to allow admin to auto sync permissions.
 
+
+### min_file_parsing_loop_time config option temporarily disabled
+
+The scheduler.min_file_parsing_loop_time config option has been temporarily removed due to
+some bugs.
+
+### new `sync_parallelism` config option in celery section
+
+The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
+fetch celery task state in parallel. Default value is max(1, number of cores - 1)
+
+### CLI Changes
+
+The ability to manipulate users from the command line has been changed. 'airflow create_user' and 'airflow delete_user' and 'airflow list_users' has been grouped to a single command `airflow users` with optional flags `--create`, `--list` and `--delete`.
+
+Example Usage:
+
+To create a new user:
+```bash
+airflow users --create --username jondoe --lastname doe --firstname jon --email jdoe@apache.org --role Viewer --password test
+```
+
+To list users:
+```bash
+airflow users --list
+```
+
+To delete a user:
+```bash
+airflow users --delete --username jondoe
+```
+
+### StatsD Metrics
+
+The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
+
+### Custom auth backends interface change
+
+We have updated the version of flask-login we depend upon, and as a result any
+custom auth backends might need a small change: `is_active`,
+`is_authenticated`, and `is_anonymous` should now be properties. What this means is if
+previously you had this in your user class
+
+    def is_active(self):
+      return self.active
+
+then you need to change it like this
+
+    @property
+    def is_active(self):
+      return self.active
+
+## Airflow 1.10
+
+Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
+`AIRFLOW_GPL_UNIDECODE=yes`. In case of the latter a GPL runtime dependency will be installed due to a
+dependency (python-nvd3 -> python-slugify -> unidecode).
+
+### Replace DataProcHook.await calls to DataProcHook.wait
+
+The method name was changed to be compatible with the Python 3.7 async/await keywords
+
 ### Setting UTF-8 as default mime_charset in email utils
 
 ### Add a configuration variable(default_dag_run_display_number) to control numbers of dag run for display
diff --git a/airflow/jobs.py b/airflow/jobs.py
index f2caeda137721..21d7c498a25b8 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1892,7 +1892,7 @@ def process_file(self, file_path, pickle_dags=False, session=None):
 
     @provide_session
     def heartbeat_callback(self, session=None):
-        Stats.gauge('scheduler_heartbeat', 1, 1)
+        Stats.incr('scheduler_heartbeat', 1, 1)
 
 
 class BackfillJob(BaseJob):

From 2f87ccfc154d1587dc3496feb303b5280d901c05 Mon Sep 17 00:00:00 2001
From: pengchen <pengchen@xiaohongshu.com>
Date: Mon, 25 Jun 2018 13:09:14 +0200
Subject: [PATCH 105/808] [AIRFLOW-2662][AIRFLOW-2397] Add k8s node_selectors
 and affinity

Add the ability to set the node selection and the affinity
for the k8s executor

Closes #3535 from Cplo/affinity
---
 airflow/config_templates/default_airflow.cfg  |  5 ++
 .../contrib/executors/kubernetes_executor.py  | 19 ++++++--
 .../kubernetes_request_factory.py             |  5 +-
 airflow/contrib/kubernetes/pod.py             |  2 +-
 .../kubernetes/worker_configuration.py        |  5 +-
 .../operators/kubernetes_pod_operator.py      |  5 ++
 scripts/ci/kubernetes/kube/configmaps.yaml    |  5 ++
 .../minikube/test_kubernetes_pod_operator.py  | 48 +++++++++++++++++++
 8 files changed, 85 insertions(+), 9 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 7ea81487aa99a..33257261c3aad 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -611,6 +611,11 @@ gcp_service_account_keys =
 # It will raise an exception if called from a process not running in a kubernetes environment.
 in_cluster = True
 
+[kubernetes_node_selectors]
+# The Key-value pairs to be given to worker pods.
+# The worker pods will be scheduled to the nodes of the specified key-value pairs.
+# Should be supplied in the format: key = value
+
 [kubernetes_secrets]
 # The scheduler mounts the following secrets into your workers as they are launched by the
 # scheduler. You may define as many secrets as needed and the kubernetes launcher will parse the
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 65053bd56b2a2..4ea52c42ff604 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -39,7 +39,7 @@
 class KubernetesExecutorConfig:
     def __init__(self, image=None, image_pull_policy=None, request_memory=None,
                  request_cpu=None, limit_memory=None, limit_cpu=None,
-                 gcp_service_account_key=None):
+                 gcp_service_account_key=None, node_selectors=None, affinity=None):
         self.image = image
         self.image_pull_policy = image_pull_policy
         self.request_memory = request_memory
@@ -47,13 +47,17 @@ def __init__(self, image=None, image_pull_policy=None, request_memory=None,
         self.limit_memory = limit_memory
         self.limit_cpu = limit_cpu
         self.gcp_service_account_key = gcp_service_account_key
+        self.node_selectors = node_selectors
+        self.affinity = affinity
 
     def __repr__(self):
         return "{}(image={}, image_pull_policy={}, request_memory={}, request_cpu={}, " \
-               "limit_memory={}, limit_cpu={}, gcp_service_account_key={})" \
+               "limit_memory={}, limit_cpu={}, gcp_service_account_key={}, " \
+               "node_selectors={}, affinity={})" \
             .format(KubernetesExecutorConfig.__name__, self.image, self.image_pull_policy,
                     self.request_memory, self.request_cpu, self.limit_memory,
-                    self.limit_cpu, self.gcp_service_account_key)
+                    self.limit_cpu, self.gcp_service_account_key, self.node_selectors,
+                    self.affinity)
 
     @staticmethod
     def from_dict(obj):
@@ -73,7 +77,9 @@ def from_dict(obj):
             request_cpu=namespaced.get('request_cpu', None),
             limit_memory=namespaced.get('limit_memory', None),
             limit_cpu=namespaced.get('limit_cpu', None),
-            gcp_service_account_key=namespaced.get('gcp_service_account_key', None)
+            gcp_service_account_key=namespaced.get('gcp_service_account_key', None),
+            node_selectors=namespaced.get('node_selectors', None),
+            affinity=namespaced.get('affinity', None)
         )
 
     def as_dict(self):
@@ -84,7 +90,9 @@ def as_dict(self):
             'request_cpu': self.request_cpu,
             'limit_memory': self.limit_memory,
             'limit_cpu': self.limit_cpu,
-            'gcp_service_account_key': self.gcp_service_account_key
+            'gcp_service_account_key': self.gcp_service_account_key,
+            'node_selectors': self.node_selectors,
+            'affinity': self.affinity
         }
 
 
@@ -108,6 +116,7 @@ def __init__(self):
         self.kube_image_pull_policy = configuration.get(
             self.kubernetes_section, "worker_container_image_pull_policy"
         )
+        self.kube_node_selectors = configuration_dict.get('kubernetes_node_selectors', {})
         self.delete_worker_pods = conf.getboolean(
             self.kubernetes_section, 'delete_worker_pods')
 
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index 7133125ab14e3..27e0ebd29c0a3 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -85,8 +85,9 @@ def extract_args(pod, req):
 
     @staticmethod
     def extract_node_selector(pod, req):
-        if len(pod.node_selectors) > 0:
-            req['spec']['nodeSelector'] = pod.node_selectors
+        req['spec']['nodeSelector'] = req['spec'].get('nodeSelector', {})
+        for k, v in six.iteritems(pod.node_selectors):
+            req['spec']['nodeSelector'][k] = v
 
     @staticmethod
     def attach_volumes(pod, req):
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index c42221482ff88..6fcf354459b80 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -89,7 +89,7 @@ def __init__(
         self.name = name
         self.volumes = volumes or []
         self.volume_mounts = volume_mounts or []
-        self.node_selectors = node_selectors or []
+        self.node_selectors = node_selectors or {}
         self.namespace = namespace
         self.image_pull_policy = image_pull_policy
         self.image_pull_secrets = image_pull_secrets
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 26540856f980d..8421e05b69f67 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -208,5 +208,8 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             volumes=volumes,
             volume_mounts=volume_mounts,
             resources=resources,
-            annotations=annotations
+            annotations=annotations,
+            node_selectors=(kube_executor_config.node_selectors or
+                            self.kube_config.kube_node_selectors),
+            affinity=kube_executor_config.affinity
         )
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index bf656f12fbb88..fb905622d8a47 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -70,6 +70,8 @@ class KubernetesPodOperator(BaseOperator):
     :type get_logs: bool
     :param affinity: A dict containing a group of affinity scheduling rules
     :type affinity: dict
+    :param node_selectors: A dict containing a group of scheduling rules
+    :type node_selectors: dict
     :param config_file: The path to the Kubernetes config file
     :type config_file: str
     :param xcom_push: If xcom_push is True, the content of the file
@@ -106,6 +108,7 @@ def execute(self, context):
             pod.annotations = self.annotations
             pod.resources = self.resources
             pod.affinity = self.affinity
+            pod.node_selectors = self.node_selectors
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
@@ -144,6 +147,7 @@ def __init__(self,
                  affinity=None,
                  config_file=None,
                  xcom_push=False,
+                 node_selectors=None,
                  *args,
                  **kwargs):
         super(KubernetesPodOperator, self).__init__(*args, **kwargs)
@@ -162,6 +166,7 @@ def __init__(self,
         self.cluster_context = cluster_context
         self.get_logs = get_logs
         self.image_pull_policy = image_pull_policy
+        self.node_selectors = node_selectors or {}
         self.annotations = annotations or {}
         self.affinity = affinity or {}
         self.xcom_push = xcom_push
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index 1673c3e54b577..45e641835da8f 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -195,6 +195,11 @@ data:
     git_sync_container_tag = v2.0.5
     git_sync_init_container_name = git-sync-clone
 
+    [kubernetes_node_selectors]
+    # The Key-value pairs to be given to worker pods.
+    # The worker pods will be scheduled to the nodes of the specified key-value pairs.
+    # Should be supplied in the format: key = value
+
     [kubernetes_secrets]
     SQL_ALCHEMY_CONN = airflow-secrets=sql_alchemy_conn
 
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 5c799f40f98ed..531343e674da9 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -91,6 +91,54 @@ def test_working_pod(self):
         )
         k.execute(None)
 
+    def test_pod_node_selectors(self):
+        node_selectors = {
+            'beta.kubernetes.io/os': 'linux'
+        }
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo", "10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            node_selectors=node_selectors,
+            executor_config={'KubernetesExecutor': {'node_selectors': node_selectors}}
+        )
+        k.execute(None)
+
+    def test_pod_affinity(self):
+        affinity = {
+            'nodeAffinity': {
+                'requiredDuringSchedulingIgnoredDuringExecution': {
+                    'nodeSelectorTerms': [
+                        {
+                            'matchExpressions': [
+                                {
+                                    'key': 'beta.kubernetes.io/os',
+                                    'operator': 'In',
+                                    'values': ['linux']
+                                }
+                            ]
+                        }
+                    ]
+                }
+            }
+        }
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo", "10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            affinity=affinity,
+            executor_config={'KubernetesExecutor': {'affinity': affinity}}
+        )
+        k.execute(None)
+
     def test_logging(self):
         with mock.patch.object(PodLauncher, 'log') as mock_logger:
             k = KubernetesPodOperator(

From c6931b5d44562de60370b22cd0cc49d7b1295da9 Mon Sep 17 00:00:00 2001
From: pengc <348707924@qq.com>
Date: Wed, 29 Aug 2018 15:41:08 +0800
Subject: [PATCH 106/808] [AIRFLOW-2854] kubernetes_pod_operator add more
 configuration items (#3697)

* kubernetes_pod_operator add more configuration items
* fix test_kubernetes_pod_operator test_faulty_service_account failure case
* fix review comment issues
* pod_operator add hostnetwork config
* add doc example
---
 .../example_kubernetes_operator.py            |  3 +-
 .../kubernetes_request_factory.py             |  5 ++
 .../pod_request_factory.py                    |  2 +
 airflow/contrib/kubernetes/pod.py             |  4 +-
 airflow/contrib/kubernetes/pod_launcher.py    | 11 +++-
 .../operators/kubernetes_pod_operator.py      | 14 +++++
 docs/kubernetes.rst                           |  4 +-
 .../minikube/test_kubernetes_pod_operator.py  | 52 +++++++++++++++++--
 8 files changed, 87 insertions(+), 8 deletions(-)

diff --git a/airflow/contrib/example_dags/example_kubernetes_operator.py b/airflow/contrib/example_dags/example_kubernetes_operator.py
index 92d73c5d3369d..f1be4f8fbcb3c 100644
--- a/airflow/contrib/example_dags/example_kubernetes_operator.py
+++ b/airflow/contrib/example_dags/example_kubernetes_operator.py
@@ -48,7 +48,8 @@
         in_cluster=False,
         task_id="task",
         get_logs=True,
-        dag=dag)
+        dag=dag,
+        is_delete_operator_pod=False)
 
 except ImportError as e:
     log.warn("Could not import KubernetesPodOperator: " + str(e))
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index 27e0ebd29c0a3..97bcdf2abc9ea 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -175,6 +175,11 @@ def extract_service_account_name(pod, req):
         if pod.service_account_name:
             req['spec']['serviceAccountName'] = pod.service_account_name
 
+    @staticmethod
+    def extract_hostnetwork(pod, req):
+        if pod.hostnetwork:
+            req['spec']['hostNetwork'] = pod.hostnetwork
+
     @staticmethod
     def extract_image_pull_secrets(pod, req):
         if pod.image_pull_secrets:
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index 95d6c829dec59..877d7aafe2b2e 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -59,6 +59,7 @@ def create(self, pod):
         self.extract_image_pull_secrets(pod, req)
         self.extract_annotations(pod, req)
         self.extract_affinity(pod, req)
+        self.extract_hostnetwork(pod, req)
         return req
 
 
@@ -116,4 +117,5 @@ def create(self, pod):
         self.extract_image_pull_secrets(pod, req)
         self.extract_annotations(pod, req)
         self.extract_affinity(pod, req)
+        self.extract_hostnetwork(pod, req)
         return req
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 6fcf354459b80..221c8f4180ef8 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -77,7 +77,8 @@ def __init__(
             service_account_name=None,
             resources=None,
             annotations=None,
-            affinity=None
+            affinity=None,
+            hostnetwork=False
     ):
         self.image = image
         self.envs = envs or {}
@@ -98,3 +99,4 @@ def __init__(
         self.resources = resources or Resources()
         self.annotations = annotations or {}
         self.affinity = affinity or {}
+        self.hostnetwork = hostnetwork or False
diff --git a/airflow/contrib/kubernetes/pod_launcher.py b/airflow/contrib/kubernetes/pod_launcher.py
index 8ac5108507345..f34de419ae02f 100644
--- a/airflow/contrib/kubernetes/pod_launcher.py
+++ b/airflow/contrib/kubernetes/pod_launcher.py
@@ -22,7 +22,7 @@
 from datetime import datetime as dt
 from airflow.contrib.kubernetes.kubernetes_request_factory import \
     pod_request_factory as pod_factory
-from kubernetes import watch
+from kubernetes import watch, client
 from kubernetes.client.rest import ApiException
 from kubernetes.stream import stream as kubernetes_stream
 from airflow import AirflowException
@@ -59,6 +59,15 @@ def run_pod_async(self, pod):
             raise
         return resp
 
+    def delete_pod(self, pod):
+        try:
+            self._client.delete_namespaced_pod(
+                pod.name, pod.namespace, body=client.V1DeleteOptions())
+        except ApiException as e:
+            # If the pod is already deleted
+            if e.status != 404:
+                raise
+
     def run_pod(self, pod, startup_timeout=120, get_logs=True):
         # type: (Pod) -> (State, result)
         """
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index fb905622d8a47..bb4bf7fca1e33 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -102,6 +102,7 @@ def execute(self, context):
                 labels=self.labels,
             )
 
+            pod.service_account_name = self.service_account_name
             pod.secrets = self.secrets
             pod.envs = self.env_vars
             pod.image_pull_policy = self.image_pull_policy
@@ -109,6 +110,7 @@ def execute(self, context):
             pod.resources = self.resources
             pod.affinity = self.affinity
             pod.node_selectors = self.node_selectors
+            pod.hostnetwork = self.hostnetwork
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
@@ -116,6 +118,10 @@ def execute(self, context):
                 pod,
                 startup_timeout=self.startup_timeout_seconds,
                 get_logs=self.get_logs)
+
+            if self.is_delete_operator_pod:
+                launcher.delete_pod(pod)
+
             if final_state != State.SUCCESS:
                 raise AirflowException(
                     'Pod returned a failure: {state}'.format(state=final_state)
@@ -148,6 +154,10 @@ def __init__(self,
                  config_file=None,
                  xcom_push=False,
                  node_selectors=None,
+                 image_pull_secrets=None,
+                 service_account_name="default",
+                 is_delete_operator_pod=False,
+                 hostnetwork=False,
                  *args,
                  **kwargs):
         super(KubernetesPodOperator, self).__init__(*args, **kwargs)
@@ -172,3 +182,7 @@ def __init__(self,
         self.xcom_push = xcom_push
         self.resources = resources or Resources()
         self.config_file = config_file
+        self.image_pull_secrets = image_pull_secrets
+        self.service_account_name = service_account_name
+        self.is_delete_operator_pod = is_delete_operator_pod
+        self.hostnetwork = hostnetwork
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 3fe9bd38f690d..dd02ac8d10689 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -92,7 +92,9 @@ Kubernetes Operator
                               volume_mounts=[volume_mount]
                               name="test",
                               task_id="task",
-                              affinity=affinity
+                              affinity=affinity,
+                              is_delete_operator_pod=True,
+                              hostnetwork=False
                               )
 
 
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 531343e674da9..2cf615f83cf33 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -20,6 +20,7 @@
 import shutil
 from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
 from airflow import AirflowException
+from kubernetes.client.rest import ApiException
 from subprocess import check_call
 import mock
 import json
@@ -91,7 +92,36 @@ def test_working_pod(self):
         )
         k.execute(None)
 
-    def test_pod_node_selectors(self):
+    @staticmethod
+    def test_delete_operator_pod():
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            is_delete_operator_pod=True
+        )
+        k.execute(None)
+
+    @staticmethod
+    def test_pod_hostnetwork():
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            hostnetwork=True
+        )
+        k.execute(None)
+
+    @staticmethod
+    def test_pod_node_selectors():
         node_selectors = {
             'beta.kubernetes.io/os': 'linux'
         }
@@ -194,10 +224,24 @@ def test_faulty_image(self):
             task_id="task",
             startup_timeout_seconds=5
         )
-        with self.assertRaises(AirflowException) as cm:
-            k.execute(None),
+        with self.assertRaises(AirflowException):
+            k.execute(None)
 
-        print("exception: {}".format(cm))
+    def test_faulty_service_account(self):
+        bad_service_account_name = "foobar"
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            startup_timeout_seconds=5,
+            service_account_name=bad_service_account_name
+        )
+        with self.assertRaises(ApiException):
+            k.execute(None)
 
     def test_pod_failure(self):
         """

From d26617240d8eb25abce72d1bf9a47d57d6c9e6af Mon Sep 17 00:00:00 2001
From: Justin Holmes <justinholmes@users.noreply.github.com>
Date: Fri, 12 Oct 2018 07:06:13 +0100
Subject: [PATCH 107/808] [AIRFLOW-2956] Add kubernetes tolerations (#3806)

---
 .../example_dags/example_kubernetes_operator.py      | 12 +++++++++++-
 .../kubernetes_request_factory.py                    |  5 +++++
 .../pod_request_factory.py                           |  2 ++
 airflow/contrib/kubernetes/pod.py                    |  4 +++-
 airflow/contrib/operators/kubernetes_pod_operator.py |  5 +++++
 docs/kubernetes.rst                                  | 12 ++++++++++--
 6 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/example_dags/example_kubernetes_operator.py b/airflow/contrib/example_dags/example_kubernetes_operator.py
index f1be4f8fbcb3c..53517b1c46b72 100644
--- a/airflow/contrib/example_dags/example_kubernetes_operator.py
+++ b/airflow/contrib/example_dags/example_kubernetes_operator.py
@@ -38,6 +38,14 @@
         default_args=args,
         schedule_interval=None)
 
+    tolerations = [
+        {
+            'key': "key",
+            'operator': 'Equal',
+            'value': 'value'
+        }
+    ]
+
     k = KubernetesPodOperator(
         namespace='default',
         image="ubuntu:16.04",
@@ -49,7 +57,9 @@
         task_id="task",
         get_logs=True,
         dag=dag,
-        is_delete_operator_pod=False)
+        is_delete_operator_pod=False,
+        tolerations=tolerations
+    )
 
 except ImportError as e:
     log.warn("Could not import KubernetesPodOperator: " + str(e))
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index 97bcdf2abc9ea..bc424d57abf9e 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -186,3 +186,8 @@ def extract_image_pull_secrets(pod, req):
             req['spec']['imagePullSecrets'] = [{
                 'name': pull_secret
             } for pull_secret in pod.image_pull_secrets.split(',')]
+
+    @staticmethod
+    def extract_tolerations(pod, req):
+        if pod.tolerations:
+            req['spec']['tolerations'] = pod.tolerations
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index 877d7aafe2b2e..059026b320240 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -60,6 +60,7 @@ def create(self, pod):
         self.extract_annotations(pod, req)
         self.extract_affinity(pod, req)
         self.extract_hostnetwork(pod, req)
+        self.extract_tolerations(pod, req)
         return req
 
 
@@ -118,4 +119,5 @@ def create(self, pod):
         self.extract_annotations(pod, req)
         self.extract_affinity(pod, req)
         self.extract_hostnetwork(pod, req)
+        self.extract_tolerations(pod, req)
         return req
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 221c8f4180ef8..5de23ff5bdf81 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -78,7 +78,8 @@ def __init__(
             resources=None,
             annotations=None,
             affinity=None,
-            hostnetwork=False
+            hostnetwork=False,
+            tolerations=None,
     ):
         self.image = image
         self.envs = envs or {}
@@ -100,3 +101,4 @@ def __init__(
         self.annotations = annotations or {}
         self.affinity = affinity or {}
         self.hostnetwork = hostnetwork or False
+        self.tolerations = tolerations or []
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index bb4bf7fca1e33..91e73e0c53df3 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -78,6 +78,8 @@ class KubernetesPodOperator(BaseOperator):
         /airflow/xcom/return.json in the container will also be pushed to an
         XCom when the container completes.
     :type xcom_push: bool
+    :param tolerations: Kubernetes tolerations
+    :type list of tolerations
     """
     template_fields = ('cmds', 'arguments', 'env_vars', 'config_file')
 
@@ -111,6 +113,7 @@ def execute(self, context):
             pod.affinity = self.affinity
             pod.node_selectors = self.node_selectors
             pod.hostnetwork = self.hostnetwork
+            pod.tolerations = self.tolerations
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
@@ -158,6 +161,7 @@ def __init__(self,
                  service_account_name="default",
                  is_delete_operator_pod=False,
                  hostnetwork=False,
+                 tolerations=None,
                  *args,
                  **kwargs):
         super(KubernetesPodOperator, self).__init__(*args, **kwargs)
@@ -186,3 +190,4 @@ def __init__(self,
         self.service_account_name = service_account_name
         self.is_delete_operator_pod = is_delete_operator_pod
         self.hostnetwork = hostnetwork
+        self.tolerations = tolerations or []
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index dd02ac8d10689..0c8b956ce2317 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -82,6 +82,14 @@ Kubernetes Operator
         }
     }
 
+    tolerations = [
+        {
+            'key': "key",
+            'operator': 'Equal',
+            'value': 'value'
+         }
+    ]
+
     k = KubernetesPodOperator(namespace='default',
                               image="ubuntu:16.04",
                               cmds=["bash", "-cx"],
@@ -94,11 +102,11 @@ Kubernetes Operator
                               task_id="task",
                               affinity=affinity,
                               is_delete_operator_pod=True,
-                              hostnetwork=False
+                              hostnetwork=False,
+                              tolerations=tolerations
                               )
 
 
 .. autoclass:: airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator
 
 .. autoclass:: airflow.contrib.kubernetes.secret.Secret
-

From 0e98c60268c805639be8cd8c1cdf9a8909f966bb Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 12 Oct 2018 14:09:02 +0800
Subject: [PATCH 108/808] [AIRFLOW-3183] Fix bug in
 DagFileProcessorManager.max_runs_reached() (#4031)

The condition is intended to ensure the function
will return False if any file's run_count is still smaller
than max_run. But the operator used here is "!=".
Instead, it should be "<".

This is because in DagFileProcessorManager,
there is no statement helping limit the upper
limit of run_count. It's possible that
files' run_count will be bigger than max_run.
In such case, max_runs_reached() method
may fail its purpose.
---
 airflow/utils/dag_processing.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 89e5701cf15bf..d30c6aeacb5be 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -578,7 +578,7 @@ def max_runs_reached(self):
         if self._max_runs == -1:  # Unlimited runs.
             return False
         for file_path in self._file_paths:
-            if self._run_count[file_path] != self._max_runs:
+            if self._run_count[file_path] < self._max_runs:
                 return False
         if self._run_count[self._heart_beat_key] < self._max_runs:
             return False

From 2ad664d2456ea97f937f6d27bb331224dcf2dd4d Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 12 Oct 2018 07:34:30 +0100
Subject: [PATCH 109/808] [AIRFLOW-3099] Don't ever warn about missing sections
 of config (#4028)

Rather than looping through and setting each config variable
individually, and having to know which sections are optional and which
aren't, instead we can just call a single function on ConfigParser and
it will read the config from the dict, and more importantly here, never
error about missing sections - it will just create them as needed.
---
 airflow/bin/cli.py       | 24 +-----------------------
 airflow/configuration.py |  4 ++++
 2 files changed, 5 insertions(+), 23 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 4226d7e6df859..949a453c9eb87 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -19,7 +19,6 @@
 # under the License.
 
 from __future__ import print_function
-from backports.configparser import NoSectionError
 import logging
 
 import os
@@ -455,28 +454,7 @@ def run(args, dag=None):
         if os.path.exists(args.cfg_path):
             os.remove(args.cfg_path)
 
-        # Do not log these properties since some may contain passwords.
-        # This may also set default values for database properties like
-        # core.sql_alchemy_pool_size
-        # core.sql_alchemy_pool_recycle
-        for section, config in conf_dict.items():
-            for option, value in config.items():
-                try:
-                    conf.set(section, option, value)
-                except NoSectionError:
-                    optional_sections = [
-                        'atlas', 'mesos', 'elasticsearch', 'kubernetes',
-                        'lineage', 'hive'
-                    ]
-                    if section in optional_sections:
-                        log.debug('Section {section} Option {option} '
-                                  'does not exist in the config!'.format(section=section,
-                                                                         option=option))
-                    else:
-                        log.error('Section {section} Option {option} '
-                                  'does not exist in the config!'.format(section=section,
-                                                                         option=option))
-
+        conf.conf.read_dict(conf_dict, source=args.cfg_path)
         settings.configure_vars()
 
     # IMPORTANT, have to use the NullPool, otherwise, each "run" command may leave
diff --git a/airflow/configuration.py b/airflow/configuration.py
index 8a056bc4f1cf5..a9a68124cab58 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -285,6 +285,10 @@ def read(self, filenames):
         super(AirflowConfigParser, self).read(filenames)
         self._validate()
 
+    def read_dict(self, *args, **kwargs):
+        super(AirflowConfigParser, self).read_dict(*args, **kwargs)
+        self._validate()
+
     def has_option(self, section, option):
         try:
             # Using self.get() to avoid reimplementing the priority order

From b81a3c6e794ecd00f93f4307ad8e949c3a08a4f1 Mon Sep 17 00:00:00 2001
From: dima-asana <42555784+dima-asana@users.noreply.github.com>
Date: Fri, 12 Oct 2018 00:14:47 -0700
Subject: [PATCH 110/808] [AIRFLOW-1837] Respect task start_date when different
 from dag's (#4010)

Currently task instances get created and scheduled based on the DAG's
start date rather than their own.  This commit adds a check before
creating a task instance to see that the start date is not after
the execution date.
---
 airflow/models.py                 |  2 ++
 tests/core.py                     | 29 +++++++++++++++--------------
 tests/dags/test_scheduler_dags.py | 22 +++++++++++++++++++---
 tests/jobs.py                     | 23 ++++++++++++++++++++++-
 tests/www_rbac/test_views.py      | 24 ++++++++++++------------
 5 files changed, 70 insertions(+), 30 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 14c08e7092532..ad9365c782ceb 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -5153,6 +5153,8 @@ def verify_integrity(self, session=None):
         for task in six.itervalues(dag.task_dict):
             if task.adhoc:
                 continue
+            if task.start_date > self.execution_date and not self.is_backfill:
+                continue
 
             if task.task_id not in task_ids:
                 ti = TaskInstance(task, self.execution_date)
diff --git a/tests/core.py b/tests/core.py
index 8cd69dc4ee1fb..0448058b3b3fb 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -63,7 +63,7 @@
 from airflow.utils import timezone
 from airflow.utils.timezone import datetime
 from airflow.utils.state import State
-from airflow.utils.dates import infer_time_unit, round_time, scale_time_units
+from airflow.utils.dates import days_ago, infer_time_unit, round_time, scale_time_units
 from lxml import html
 from airflow.exceptions import AirflowException
 from airflow.configuration import AirflowConfigException, run_command
@@ -81,6 +81,7 @@
 DEFAULT_DATE_ISO = DEFAULT_DATE.isoformat()
 DEFAULT_DATE_DS = DEFAULT_DATE_ISO[:10]
 TEST_DAG_ID = 'unit_tests'
+EXAMPLE_DAG_DEFAULT_DATE = days_ago(2)
 
 try:
     import cPickle as pickle
@@ -1651,21 +1652,21 @@ def setUp(self):
 
         self.dagrun_python = self.dag_python.create_dagrun(
             run_id="test_{}".format(models.DagRun.id_for_date(timezone.utcnow())),
-            execution_date=DEFAULT_DATE,
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING
         )
 
         self.sub_dag.create_dagrun(
             run_id="test_{}".format(models.DagRun.id_for_date(timezone.utcnow())),
-            execution_date=DEFAULT_DATE,
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING
         )
 
         self.example_xcom.create_dagrun(
             run_id="test_{}".format(models.DagRun.id_for_date(timezone.utcnow())),
-            execution_date=DEFAULT_DATE,
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING
         )
@@ -1758,7 +1759,7 @@ def test_dag_views(self):
         response = self.app.get(
             '/admin/airflow/task?'
             'task_id=runme_0&dag_id=example_bash_operator&'
-            'execution_date={}'.format(DEFAULT_DATE_DS))
+            'execution_date={}'.format(EXAMPLE_DAG_DEFAULT_DATE))
         self.assertIn("Attributes", response.data.decode('utf-8'))
         response = self.app.get(
             '/admin/airflow/dag_stats')
@@ -1770,22 +1771,21 @@ def test_dag_views(self):
             "/admin/airflow/success?task_id=print_the_context&"
             "dag_id=example_python_operator&upstream=false&downstream=false&"
             "future=false&past=false&execution_date={}&"
-            "origin=/admin".format(DEFAULT_DATE_DS))
+            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
-        response = self.app.get(url + "&confirmed=true")
         response = self.app.get(
             '/admin/airflow/clear?task_id=print_the_context&'
             'dag_id=example_python_operator&future=true&past=false&'
             'upstream=true&downstream=false&'
             'execution_date={}&'
-            'origin=/admin'.format(DEFAULT_DATE_DS))
+            'origin=/admin'.format(EXAMPLE_DAG_DEFAULT_DATE))
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         url = (
             "/admin/airflow/success?task_id=section-1&"
             "dag_id=example_subdag_operator&upstream=true&downstream=true&"
             "future=false&past=false&execution_date={}&"
-            "origin=/admin".format(DEFAULT_DATE_DS))
+            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         self.assertIn("section-1-task-1", response.data.decode('utf-8'))
@@ -1799,7 +1799,7 @@ def test_dag_views(self):
             "dag_id=example_python_operator&future=false&past=false&"
             "upstream=false&downstream=true&"
             "execution_date={}&"
-            "origin=/admin".format(DEFAULT_DATE_DS))
+            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         response = self.app.get(url + "&confirmed=true")
@@ -1808,7 +1808,7 @@ def test_dag_views(self):
             "dag_id=example_subdag_operator.section-1&future=false&past=false&"
             "upstream=false&downstream=true&recursive=true&"
             "execution_date={}&"
-            "origin=/admin".format(DEFAULT_DATE_DS))
+            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         self.assertIn("example_subdag_operator.end",
@@ -1835,7 +1835,7 @@ def test_dag_views(self):
             "/admin/airflow/run?task_id=runme_0&"
             "dag_id=example_bash_operator&ignore_all_deps=false&ignore_ti_state=true&"
             "ignore_task_deps=true&execution_date={}&"
-            "origin=/admin".format(DEFAULT_DATE_DS))
+            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         response = self.app.get(
             "/admin/airflow/refresh?dag_id=example_bash_operator")
@@ -1870,13 +1870,14 @@ def test_fetch_task_instance(self):
         url = (
             "/admin/airflow/object/task_instances?"
             "dag_id=example_python_operator&"
-            "execution_date={}".format(DEFAULT_DATE_DS))
+            "execution_date={}".format(EXAMPLE_DAG_DEFAULT_DATE))
         response = self.app.get(url)
         self.assertIn("print_the_context", response.data.decode('utf-8'))
 
     def tearDown(self):
         configuration.conf.set("webserver", "expose_config", "False")
-        self.dag_bash.clear(start_date=DEFAULT_DATE, end_date=timezone.utcnow())
+        self.dag_bash.clear(start_date=EXAMPLE_DAG_DEFAULT_DATE,
+                            end_date=timezone.utcnow())
         session = Session()
         session.query(models.DagRun).delete()
         session.query(models.TaskInstance).delete()
diff --git a/tests/dags/test_scheduler_dags.py b/tests/dags/test_scheduler_dags.py
index 990086693771a..4febbb1f55dcc 100644
--- a/tests/dags/test_scheduler_dags.py
+++ b/tests/dags/test_scheduler_dags.py
@@ -17,18 +17,34 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from datetime import datetime
+from datetime import datetime, timedelta
 
 from airflow.models import DAG
 from airflow.operators.dummy_operator import DummyOperator
-DEFAULT_DATE = datetime(2100, 1, 1)
+DEFAULT_DATE = datetime(2016, 1, 1)
 
 # DAG tests backfill with pooled tasks
 # Previously backfill would queue the task but never run it
 dag1 = DAG(
     dag_id='test_start_date_scheduling',
-    start_date=datetime(2100, 1, 1))
+    start_date=datetime.utcnow() + timedelta(days=1))
 dag1_task1 = DummyOperator(
     task_id='dummy',
     dag=dag1,
     owner='airflow')
+
+dag2 = DAG(
+    dag_id='test_task_start_date_scheduling',
+    start_date=DEFAULT_DATE
+)
+dag2_task1 = DummyOperator(
+    task_id='dummy1',
+    dag=dag2,
+    owner='airflow',
+    start_date=DEFAULT_DATE + timedelta(days=3)
+)
+dag2_task2 = DummyOperator(
+    task_id='dummy2',
+    dag=dag2,
+    owner='airflow'
+)
diff --git a/tests/jobs.py b/tests/jobs.py
index c6297af2459f8..5bd3a00451a1b 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -2209,7 +2209,7 @@ def test_scheduler_start_date(self):
         dag_id = 'test_start_date_scheduling'
         dag = self.dagbag.get_dag(dag_id)
         dag.clear()
-        self.assertTrue(dag.start_date > DEFAULT_DATE)
+        self.assertTrue(dag.start_date > datetime.datetime.utcnow())
 
         scheduler = SchedulerJob(dag_id,
                                  num_runs=2)
@@ -2244,6 +2244,27 @@ def test_scheduler_start_date(self):
         self.assertEqual(
             len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
 
+    def test_scheduler_task_start_date(self):
+        """
+        Test that the scheduler respects task start dates that are different
+        from DAG start dates
+        """
+        dag_id = 'test_task_start_date_scheduling'
+        dag = self.dagbag.get_dag(dag_id)
+        dag.clear()
+        scheduler = SchedulerJob(dag_id,
+                                 num_runs=2)
+        scheduler.run()
+
+        session = settings.Session()
+        tiq = session.query(TI).filter(TI.dag_id == dag_id)
+        ti1s = tiq.filter(TI.task_id == 'dummy1').all()
+        ti2s = tiq.filter(TI.task_id == 'dummy2').all()
+        self.assertEqual(len(ti1s), 0)
+        self.assertEqual(len(ti2s), 2)
+        for t in ti2s:
+            self.assertEqual(t.state, State.SUCCESS)
+
     def test_scheduler_multiprocessing(self):
         """
         Test that the scheduler can successfully queue multiple dags in parallel
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 0a4eb7c03d16c..6f37f44e54614 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -40,7 +40,7 @@
 from airflow.models import DAG, DagRun, TaskInstance
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.settings import Session
-from airflow.utils import timezone
+from airflow.utils import dates, timezone
 from airflow.utils.state import State
 from airflow.utils.timezone import datetime
 from airflow.www_rbac import app as application
@@ -263,8 +263,8 @@ def test_mount(self):
 
 
 class TestAirflowBaseViews(TestBase):
-    default_date = timezone.datetime(2018, 3, 1)
-    run_id = "test_{}".format(models.DagRun.id_for_date(default_date))
+    EXAMPLE_DAG_DEFAULT_DATE = dates.days_ago(2)
+    run_id = "test_{}".format(models.DagRun.id_for_date(EXAMPLE_DAG_DEFAULT_DATE))
 
     def setUp(self):
         super(TestAirflowBaseViews, self).setUp()
@@ -291,19 +291,19 @@ def prepare_dagruns(self):
 
         self.bash_dagrun = self.bash_dag.create_dagrun(
             run_id=self.run_id,
-            execution_date=self.default_date,
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING)
 
         self.sub_dagrun = self.sub_dag.create_dagrun(
             run_id=self.run_id,
-            execution_date=self.default_date,
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING)
 
         self.xcom_dagrun = self.xcom_dag.create_dagrun(
             run_id=self.run_id,
-            execution_date=self.default_date,
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
             start_date=timezone.utcnow(),
             state=State.RUNNING)
 
@@ -321,19 +321,19 @@ def test_home(self):
 
     def test_task(self):
         url = ('task?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('Task Instance Details', resp)
 
     def test_xcom(self):
         url = ('xcom?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('XCom', resp)
 
     def test_rendered(self):
         url = ('rendered?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('Rendered Template', resp)
 
@@ -404,21 +404,21 @@ def test_success(self):
 
         url = ('success?task_id=run_this_last&dag_id=example_bash_operator&'
                'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url)
         self.check_content_in_response('Wait a minute', resp)
 
     def test_clear(self):
         url = ('clear?task_id=runme_1&dag_id=example_bash_operator&'
                'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url)
         self.check_content_in_response(['example_bash_operator', 'Wait a minute'], resp)
 
     def test_run(self):
         url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
                'ignore_ti_state=true&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url)
         self.check_content_in_response('', resp, resp_code=302)
 

From bd7510094de25f2c2bce2a49a3febae28899f3b6 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 12 Oct 2018 04:37:29 -0400
Subject: [PATCH 111/808] [AIRFLOW-3089] Drop hard-coded url scheme in google
 auth redirect. (#3919)

The google auth provider hard-codes the `_scheme` in the callback url to
`https` so that airflow generates correct urls when run behind a proxy
that terminates tls. But this means that google auth can't be used when
running without https--for example, during local development. Also,
hard-coding `_scheme` isn't the correct solution to the problem of
running behind a proxy. Instead, the proxy should be configured to set
the `X-Forwarded-Proto` header to `https`; Flask interprets this header
and generates the appropriate callback url without hard-coding the
scheme.
---
 airflow/contrib/auth/backends/google_auth.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/airflow/contrib/auth/backends/google_auth.py b/airflow/contrib/auth/backends/google_auth.py
index 32ad6962a0a82..131e3d6adb8f5 100644
--- a/airflow/contrib/auth/backends/google_auth.py
+++ b/airflow/contrib/auth/backends/google_auth.py
@@ -116,8 +116,7 @@ def login(self, request):
         log.debug('Redirecting user to Google login')
         return self.google_oauth.authorize(callback=url_for(
             'google_oauth_callback',
-            _external=True,
-            _scheme='https'),
+            _external=True),
             state=request.args.get('next') or request.referrer or None)
 
     def get_google_user_profile_info(self, google_token):

From 5bc4cfa4a7908818877828ed3db1090b71e65b93 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 12 Oct 2018 10:13:05 +0100
Subject: [PATCH 112/808] [AIRFLOW-3178] Handle percents signs in configs for
 airflow run (#4029)

* [AIRFLOW-3178] Don't mask defaults() function from ConfigParser

ConfigParser (the base class for AirflowConfigParser) expects defaults()
to be a function - so when we re-assign it to be a property some of the
methods from ConfigParser no longer work.

* [AIRFLOW-3178] Correctly escape percent signs when creating temp config

Otherwise we have a problem when we come to use those values.

* [AIRFLOW-3178] Use os.chmod instead of shelling out

There's no need to run another process for a built in Python function.

This also removes a possible race condition that would make temporary
config file be readable by more than the airflow or run-as user
The exact behaviour would depend on the umask we run under, and the
primary group of our user, likely this would mean the file was readably
by members of the airflow group (which in most cases would be just the
airflow user). To remove any such possibility we chmod the file
before we write to it
---
 airflow/configuration.py                     | 74 ++++++++-------
 airflow/task/task_runner/base_task_runner.py |  6 --
 airflow/utils/configuration.py               |  6 +-
 docs/security.rst                            |  7 ++
 run_unit_tests.sh                            |  7 --
 scripts/ci/5-run-tests.sh                    | 95 ++++++++++++++++++++
 tests/configuration.py                       | 34 ++++++-
 7 files changed, 179 insertions(+), 50 deletions(-)
 create mode 100755 scripts/ci/5-run-tests.sh

diff --git a/airflow/configuration.py b/airflow/configuration.py
index a9a68124cab58..b92e93f3feaa5 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -157,9 +157,9 @@ class AirflowConfigParser(ConfigParser):
     def __init__(self, default_config=None, *args, **kwargs):
         super(AirflowConfigParser, self).__init__(*args, **kwargs)
 
-        self.defaults = ConfigParser(*args, **kwargs)
+        self.airflow_defaults = ConfigParser(*args, **kwargs)
         if default_config is not None:
-            self.defaults.read_string(default_config)
+            self.airflow_defaults.read_string(default_config)
 
         self.is_validated = False
 
@@ -249,9 +249,9 @@ def get(self, section, key, **kwargs):
                 return option
 
         # ...then the default config
-        if self.defaults.has_option(section, key):
+        if self.airflow_defaults.has_option(section, key):
             return expand_env_var(
-                self.defaults.get(section, key, **kwargs))
+                self.airflow_defaults.get(section, key, **kwargs))
 
         else:
             log.warning(
@@ -307,8 +307,8 @@ def remove_option(self, section, option, remove_default=True):
         if super(AirflowConfigParser, self).has_option(section, option):
             super(AirflowConfigParser, self).remove_option(section, option)
 
-        if self.defaults.has_option(section, option) and remove_default:
-            self.defaults.remove_option(section, option)
+        if self.airflow_defaults.has_option(section, option) and remove_default:
+            self.airflow_defaults.remove_option(section, option)
 
     def getsection(self, section):
         """
@@ -317,10 +317,11 @@ def getsection(self, section):
         :param section: section from the config
         :return: dict
         """
-        if section not in self._sections and section not in self.defaults._sections:
+        if (section not in self._sections and
+                section not in self.airflow_defaults._sections):
             return None
 
-        _section = copy.deepcopy(self.defaults._sections[section])
+        _section = copy.deepcopy(self.airflow_defaults._sections[section])
 
         if section in self._sections:
             _section.update(copy.deepcopy(self._sections[section]))
@@ -339,30 +340,35 @@ def getsection(self, section):
             _section[key] = val
         return _section
 
-    def as_dict(self, display_source=False, display_sensitive=False):
+    def as_dict(
+            self, display_source=False, display_sensitive=False, raw=False):
         """
         Returns the current configuration as an OrderedDict of OrderedDicts.
         :param display_source: If False, the option value is returned. If True,
             a tuple of (option_value, source) is returned. Source is either
-            'airflow.cfg' or 'default'.
+            'airflow.cfg', 'default', 'env var', or 'cmd'.
         :type display_source: bool
         :param display_sensitive: If True, the values of options set by env
             vars and bash commands will be displayed. If False, those options
             are shown as '< hidden >'
         :type display_sensitive: bool
+        :param raw: Should the values be output as interpolated values, or the
+            "raw" form that can be fed back in to ConfigParser
+        :type raw: bool
         """
-        cfg = copy.deepcopy(self.defaults._sections)
-        cfg.update(copy.deepcopy(self._sections))
-
-        # remove __name__ (affects Python 2 only)
-        for options in cfg.values():
-            options.pop('__name__', None)
-
-        # add source
-        if display_source:
-            for section in cfg:
-                for k, v in cfg[section].items():
-                    cfg[section][k] = (v, 'airflow config')
+        cfg = {}
+        configs = [
+            ('default', self.airflow_defaults),
+            ('airflow.cfg', self),
+        ]
+
+        for (source_name, config) in configs:
+            for section in config.sections():
+                sect = cfg.setdefault(section, OrderedDict())
+                for (k, val) in config.items(section=section, raw=raw):
+                    if display_source:
+                        val = (val, source_name)
+                    sect[k] = val
 
         # add env vars and overwrite because they have priority
         for ev in [ev for ev in os.environ if ev.startswith('AIRFLOW__')]:
@@ -370,16 +376,15 @@ def as_dict(self, display_source=False, display_sensitive=False):
                 _, section, key = ev.split('__')
                 opt = self._get_env_var_option(section, key)
             except ValueError:
-                opt = None
-            if opt:
-                if (
-                    not display_sensitive and
-                        ev != 'AIRFLOW__CORE__UNIT_TEST_MODE'):
-                    opt = '< hidden >'
-                if display_source:
-                    opt = (opt, 'env var')
-                cfg.setdefault(section.lower(), OrderedDict()).update(
-                    {key.lower(): opt})
+                continue
+            if (not display_sensitive and ev != 'AIRFLOW__CORE__UNIT_TEST_MODE'):
+                opt = '< hidden >'
+            elif raw:
+                opt = opt.replace('%', '%%')
+            if display_source:
+                opt = (opt, 'env var')
+            cfg.setdefault(section.lower(), OrderedDict()).update(
+                {key.lower(): opt})
 
         # add bash commands
         for (section, key) in self.as_command_stdout:
@@ -388,8 +393,11 @@ def as_dict(self, display_source=False, display_sensitive=False):
                 if not display_sensitive:
                     opt = '< hidden >'
                 if display_source:
-                    opt = (opt, 'bash cmd')
+                    opt = (opt, 'cmd')
+                elif raw:
+                    opt = opt.replace('%', '%%')
                 cfg.setdefault(section, OrderedDict()).update({key: opt})
+                del cfg[section][key + '_cmd']
 
         return cfg
 
diff --git a/airflow/task/task_runner/base_task_runner.py b/airflow/task/task_runner/base_task_runner.py
index 337f6a63baec6..646182ace04e1 100644
--- a/airflow/task/task_runner/base_task_runner.py
+++ b/airflow/task/task_runner/base_task_runner.py
@@ -60,12 +60,6 @@ def __init__(self, local_task_job):
 
         # Always provide a copy of the configuration file settings
         cfg_path = tmp_configuration_copy()
-        # The following command should always work since the user doing chmod is the same
-        # as the one who just created the file.
-        subprocess.call(
-            ['chmod', '600', cfg_path],
-            close_fds=True
-        )
 
         # Add sudo commands to change user if we need to. Needed to handle SubDagOperator
         # case using a SequentialExecutor.
diff --git a/airflow/utils/configuration.py b/airflow/utils/configuration.py
index 18a338c23f6ff..6a621d5fa9c18 100644
--- a/airflow/utils/configuration.py
+++ b/airflow/utils/configuration.py
@@ -26,16 +26,18 @@
 from airflow import configuration as conf
 
 
-def tmp_configuration_copy():
+def tmp_configuration_copy(chmod=0o600):
     """
     Returns a path for a temporary file including a full copy of the configuration
     settings.
     :return: a path to a temporary file
     """
-    cfg_dict = conf.as_dict(display_sensitive=True)
+    cfg_dict = conf.as_dict(display_sensitive=True, raw=True)
     temp_fd, cfg_path = mkstemp()
 
     with os.fdopen(temp_fd, 'w') as temp_file:
+        if chmod is not None:
+            os.fchmod(temp_fd, chmod)
         json.dump(cfg_dict, temp_file)
 
     return cfg_path
diff --git a/docs/security.rst b/docs/security.rst
index 3c328d829c03d..f8b747eb0f752 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -10,6 +10,13 @@ backends or creating your own.
 
 Be sure to checkout :doc:`api` for securing the API.
 
+.. note::
+
+   Airflow uses the config parser of Python. This config parser interpolates
+   '%'-signs.  Make sure escape any ``%`` signs in your config file (but not
+   environment variables) as ``%%``, otherwise Airflow might leak these
+   passwords on a config parser exception to a log.
+
 Web Authentication
 ------------------
 
diff --git a/run_unit_tests.sh b/run_unit_tests.sh
index 27e4d08af1416..124abff44a844 100755
--- a/run_unit_tests.sh
+++ b/run_unit_tests.sh
@@ -24,12 +24,6 @@ set -x
 export AIRFLOW_HOME=${AIRFLOW_HOME:=~/airflow}
 export AIRFLOW__CORE__UNIT_TEST_MODE=True
 
-# configuration test
-export AIRFLOW__TESTSECTION__TESTKEY=testvalue
-
-# use Airflow 2.0-style imports
-export AIRFLOW_USE_NEW_IMPORTS=1
-
 # add test/contrib to PYTHONPATH
 DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 export PYTHONPATH=$PYTHONPATH:${DIR}/tests/test_utils
@@ -91,4 +85,3 @@ nosetests $nose_args
 
 # To run individual tests:
 # nosetests tests.core:CoreTest.test_scheduler_job
-
diff --git a/scripts/ci/5-run-tests.sh b/scripts/ci/5-run-tests.sh
new file mode 100755
index 0000000000000..8a74d824efa29
--- /dev/null
+++ b/scripts/ci/5-run-tests.sh
@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+
+#
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing,
+#  software distributed under the License is distributed on an
+#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+#  specific language governing permissions and limitations
+#  under the License.
+
+set -o verbose
+
+if [ -z "$HADOOP_HOME" ]; then
+    echo "HADOOP_HOME not set - abort" >&2
+    exit 1
+fi
+
+echo "Using ${HADOOP_DISTRO} distribution of Hadoop from ${HADOOP_HOME}"
+
+pwd
+
+echo "Using travis airflow.cfg"
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+cp -f ${DIR}/airflow_travis.cfg ~/unittests.cfg
+
+ROOTDIR="$(dirname $(dirname $DIR))"
+export AIRFLOW__CORE__DAGS_FOLDER="$ROOTDIR/tests/dags"
+
+# add test/contrib to PYTHONPATH
+export PYTHONPATH=${PYTHONPATH:-$ROOTDIR/tests/test_utils}
+
+echo Backend: $AIRFLOW__CORE__SQL_ALCHEMY_CONN
+
+# environment
+export AIRFLOW_HOME=${AIRFLOW_HOME:=~}
+export AIRFLOW__CORE__UNIT_TEST_MODE=True
+
+# any argument received is overriding the default nose execution arguments:
+nose_args=$@
+
+# Generate the `airflow` executable if needed
+which airflow > /dev/null || python setup.py develop
+
+# For impersonation tests on Travis, make airflow accessible to other users via the global PATH
+# (which contains /usr/local/bin)
+sudo ln -sf "${VIRTUAL_ENV}/bin/airflow" /usr/local/bin/
+
+if [ -z "$KUBERNETES_VERSION" ]; then
+  echo "Initializing the DB"
+  yes | airflow initdb
+  yes | airflow resetdb
+fi
+
+if [ -z "$nose_args" ]; then
+  nose_args="--with-coverage \
+  --cover-erase \
+  --cover-html \
+  --cover-package=airflow \
+  --cover-html-dir=airflow/www/static/coverage \
+  --with-ignore-docstrings \
+  --rednose \
+  --with-timer \
+  -v \
+  --logging-level=DEBUG"
+fi
+
+if [ -z "$KUBERNETES_VERSION" ]; then
+  # kdc init happens in setup_kdc.sh
+  kinit -kt ${KRB5_KTNAME} airflow
+fi
+
+# For impersonation tests running on SQLite on Travis, make the database world readable so other
+# users can update it
+AIRFLOW_DB="$HOME/airflow.db"
+
+if [ -f "${AIRFLOW_DB}" ]; then
+  chmod a+rw "${AIRFLOW_DB}"
+  chmod g+rwx "${AIRFLOW_HOME}"
+fi
+
+echo "Starting the unit tests with the following nose arguments: "$nose_args
+nosetests $nose_args
+
+# To run individual tests:
+# nosetests tests.core:CoreTest.test_scheduler_job
diff --git a/tests/configuration.py b/tests/configuration.py
index ac6f7b7db7746..08f57fd523d3b 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -37,38 +37,64 @@
 
 class ConfTest(unittest.TestCase):
 
-    def setup(self):
+    @classmethod
+    def setUpClass(cls):
+        os.environ['AIRFLOW__TESTSECTION__TESTKEY'] = 'testvalue'
+        os.environ['AIRFLOW__TESTSECTION__TESTPERCENT'] = 'with%percent'
         configuration.load_test_config()
+        conf.set('core', 'percent', 'with%%inside')
+
+    @classmethod
+    def tearDownClass(cls):
+        del os.environ['AIRFLOW__TESTSECTION__TESTKEY']
+        del os.environ['AIRFLOW__TESTSECTION__TESTPERCENT']
 
     def test_env_var_config(self):
         opt = conf.get('testsection', 'testkey')
         self.assertEqual(opt, 'testvalue')
 
+        opt = conf.get('testsection', 'testpercent')
+        self.assertEqual(opt, 'with%percent')
+
     def test_conf_as_dict(self):
         cfg_dict = conf.as_dict()
 
         # test that configs are picked up
         self.assertEqual(cfg_dict['core']['unit_test_mode'], 'True')
 
+        self.assertEqual(cfg_dict['core']['percent'], 'with%inside')
+
         # test env vars
         self.assertEqual(cfg_dict['testsection']['testkey'], '< hidden >')
 
+    def test_conf_as_dict_source(self):
         # test display_source
         cfg_dict = conf.as_dict(display_source=True)
         self.assertEqual(
-            cfg_dict['core']['load_examples'][1], 'airflow config')
+            cfg_dict['core']['load_examples'][1], 'airflow.cfg')
         self.assertEqual(
             cfg_dict['testsection']['testkey'], ('< hidden >', 'env var'))
 
+    def test_conf_as_dict_sensitive(self):
         # test display_sensitive
         cfg_dict = conf.as_dict(display_sensitive=True)
         self.assertEqual(cfg_dict['testsection']['testkey'], 'testvalue')
+        self.assertEqual(cfg_dict['testsection']['testpercent'], 'with%percent')
 
         # test display_source and display_sensitive
         cfg_dict = conf.as_dict(display_sensitive=True, display_source=True)
         self.assertEqual(
             cfg_dict['testsection']['testkey'], ('testvalue', 'env var'))
 
+    def test_conf_as_dict_raw(self):
+        # test display_sensitive
+        cfg_dict = conf.as_dict(raw=True, display_sensitive=True)
+        self.assertEqual(cfg_dict['testsection']['testkey'], 'testvalue')
+
+        # Values with '%' in them should be escaped
+        self.assertEqual(cfg_dict['testsection']['testpercent'], 'with%%percent')
+        self.assertEqual(cfg_dict['core']['percent'], 'with%%inside')
+
     def test_command_config(self):
         TEST_CONFIG = '''[test]
 key1 = hello
@@ -104,6 +130,10 @@ def test_command_config(self):
         self.assertFalse(test_conf.has_option('test', 'key5'))
         self.assertTrue(test_conf.has_option('another', 'key6'))
 
+        cfg_dict = test_conf.as_dict(display_sensitive=True)
+        self.assertEqual('cmd_result', cfg_dict['test']['key2'])
+        self.assertNotIn('key2_cmd', cfg_dict['test'])
+
     def test_remove_option(self):
         TEST_CONFIG = '''[test]
 key1 = hello

From 12a9bfe5338638953c17c1aa09d6a5b3b2e50404 Mon Sep 17 00:00:00 2001
From: Daniel Sakuma <dsakuma@gmail.com>
Date: Fri, 12 Oct 2018 06:24:06 -0300
Subject: [PATCH 113/808] [AIRFLOW-2216] Use profile for AWS hook if S3 config
 file provided in aws_default connection extra parameters (#4011)

Use profile for AWS hook if S3 config file provided in
aws_default connection extra parameters
Add test to validate profile set
---
 airflow/contrib/hooks/aws_hook.py    | 53 +++++++++++++++++-----------
 tests/contrib/hooks/test_aws_hook.py | 21 +++++++++++
 2 files changed, 54 insertions(+), 20 deletions(-)

diff --git a/airflow/contrib/hooks/aws_hook.py b/airflow/contrib/hooks/aws_hook.py
index 5d515d91bbab2..dc945e3ada091 100644
--- a/airflow/contrib/hooks/aws_hook.py
+++ b/airflow/contrib/hooks/aws_hook.py
@@ -96,32 +96,36 @@ def _get_credentials(self, region_name):
         if self.aws_conn_id:
             try:
                 connection_object = self.get_connection(self.aws_conn_id)
+                extra_config = connection_object.extra_dejson
                 if connection_object.login:
                     aws_access_key_id = connection_object.login
                     aws_secret_access_key = connection_object.password
 
-                elif 'aws_secret_access_key' in connection_object.extra_dejson:
-                    aws_access_key_id = connection_object.extra_dejson[
+                elif 'aws_secret_access_key' in extra_config:
+                    aws_access_key_id = extra_config[
                         'aws_access_key_id']
-                    aws_secret_access_key = connection_object.extra_dejson[
+                    aws_secret_access_key = extra_config[
                         'aws_secret_access_key']
 
-                elif 's3_config_file' in connection_object.extra_dejson:
+                elif 's3_config_file' in extra_config:
                     aws_access_key_id, aws_secret_access_key = \
                         _parse_s3_config(
-                            connection_object.extra_dejson['s3_config_file'],
-                            connection_object.extra_dejson.get('s3_config_format'))
+                            extra_config['s3_config_file'],
+                            extra_config.get('s3_config_format'),
+                            extra_config.get('profile'))
 
                 if region_name is None:
-                    region_name = connection_object.extra_dejson.get('region_name')
+                    region_name = extra_config.get('region_name')
 
-                role_arn = connection_object.extra_dejson.get('role_arn')
-                aws_account_id = connection_object.extra_dejson.get('aws_account_id')
-                aws_iam_role = connection_object.extra_dejson.get('aws_iam_role')
+                role_arn = extra_config.get('role_arn')
+                external_id = extra_config.get('external_id')
+                aws_account_id = extra_config.get('aws_account_id')
+                aws_iam_role = extra_config.get('aws_iam_role')
 
                 if role_arn is None and aws_account_id is not None and \
                         aws_iam_role is not None:
-                    role_arn = "arn:aws:iam::" + aws_account_id + ":role/" + aws_iam_role
+                    role_arn = "arn:aws:iam::{}:role/{}" \
+                        .format(aws_account_id, aws_iam_role)
 
                 if role_arn is not None:
                     sts_session = boto3.session.Session(
@@ -130,14 +134,23 @@ def _get_credentials(self, region_name):
                         region_name=region_name)
 
                     sts_client = sts_session.client('sts')
-                    sts_response = sts_client.assume_role(
-                        RoleArn=role_arn,
-                        RoleSessionName='Airflow_' + self.aws_conn_id)
-                    aws_access_key_id = sts_response['Credentials']['AccessKeyId']
-                    aws_secret_access_key = sts_response['Credentials']['SecretAccessKey']
-                    aws_session_token = sts_response['Credentials']['SessionToken']
 
-                endpoint_url = connection_object.extra_dejson.get('host')
+                    if external_id is None:
+                        sts_response = sts_client.assume_role(
+                            RoleArn=role_arn,
+                            RoleSessionName='Airflow_' + self.aws_conn_id)
+                    else:
+                        sts_response = sts_client.assume_role(
+                            RoleArn=role_arn,
+                            RoleSessionName='Airflow_' + self.aws_conn_id,
+                            ExternalId=external_id)
+
+                    credentials = sts_response['Credentials']
+                    aws_access_key_id = credentials['AccessKeyId']
+                    aws_secret_access_key = credentials['SecretAccessKey']
+                    aws_session_token = credentials['SessionToken']
+
+                endpoint_url = extra_config.get('host')
 
             except AirflowException:
                 # No connection found: fallback on boto3 credential strategy
@@ -171,7 +184,7 @@ def get_credentials(self, region_name=None):
         This contains the attributes: access_key, secret_key and token.
         """
         session, _ = self._get_credentials(region_name)
-        # Credentials are refreshable, so accessing your access key / secret key
-        # separately can lead to a race condition.
+        # Credentials are refreshable, so accessing your access key and
+        # secret key separately can lead to a race condition.
         # See https://stackoverflow.com/a/36291428/8283373
         return session.get_credentials().get_frozen_credentials()
diff --git a/tests/contrib/hooks/test_aws_hook.py b/tests/contrib/hooks/test_aws_hook.py
index 719d6d17372b0..b92e594c10369 100644
--- a/tests/contrib/hooks/test_aws_hook.py
+++ b/tests/contrib/hooks/test_aws_hook.py
@@ -19,6 +19,7 @@
 #
 
 import unittest
+
 import boto3
 
 from airflow import configuration
@@ -146,6 +147,26 @@ def test_get_credentials_from_extra(self, mock_get_connection):
         self.assertEqual(credentials_from_hook.secret_key, 'aws_secret_access_key')
         self.assertIsNone(credentials_from_hook.token)
 
+    @mock.patch('airflow.contrib.hooks.aws_hook._parse_s3_config',
+                return_value=('aws_access_key_id', 'aws_secret_access_key'))
+    @mock.patch.object(AwsHook, 'get_connection')
+    def test_get_credentials_from_extra_with_s3_config_and_profile(
+        self, mock_get_connection, mock_parse_s3_config
+    ):
+        mock_connection = Connection(
+            extra='{"s3_config_format": "aws", '
+                  '"profile": "test", '
+                  '"s3_config_file": "aws-credentials", '
+                  '"region_name": "us-east-1"}')
+        mock_get_connection.return_value = mock_connection
+        hook = AwsHook()
+        hook._get_credentials(region_name=None)
+        mock_parse_s3_config.assert_called_with(
+            'aws-credentials',
+            'aws',
+            'test'
+        )
+
     @unittest.skipIf(mock_sts is None, 'mock_sts package not present')
     @mock.patch.object(AwsHook, 'get_connection')
     @mock_sts

From 8ce9b7ab7e7e9ccbee4b243618c7db8250d85970 Mon Sep 17 00:00:00 2001
From: bart-eijk <bart.eijk@gmail.com>
Date: Fri, 12 Oct 2018 11:56:46 +0200
Subject: [PATCH 114/808] [AIRFLOW-2794] Add WasbDeleteBlobOperator (#3961)

Deleting Azure blob is now supported. Either single blobs can be
deleted, or one can choose to supply a prefix, in which case one
can match multiple blobs to be deleted.
---
 airflow/contrib/hooks/wasb_hook.py            | 41 +++++++++
 .../operators/wasb_delete_blob_operator.py    | 71 +++++++++++++++
 tests/contrib/hooks/test_wasb_hook.py         | 56 +++++++++++-
 .../test_wasb_delete_blob_operator.py         | 91 +++++++++++++++++++
 4 files changed, 258 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/operators/wasb_delete_blob_operator.py
 create mode 100644 tests/contrib/operators/test_wasb_delete_blob_operator.py

diff --git a/airflow/contrib/hooks/wasb_hook.py b/airflow/contrib/hooks/wasb_hook.py
index 1d73abd78b3dd..4d4d123b40af6 100644
--- a/airflow/contrib/hooks/wasb_hook.py
+++ b/airflow/contrib/hooks/wasb_hook.py
@@ -18,6 +18,7 @@
 # under the License.
 #
 
+from airflow import AirflowException
 from airflow.hooks.base_hook import BaseHook
 
 from azure.storage.blob import BlockBlobService
@@ -148,3 +149,43 @@ def read_file(self, container_name, blob_name, **kwargs):
         return self.connection.get_blob_to_text(container_name,
                                                 blob_name,
                                                 **kwargs).content
+
+    def delete_file(self, container_name, blob_name, is_prefix=False,
+                    ignore_if_missing=False, **kwargs):
+        """
+        Delete a file from Azure Blob Storage.
+
+        :param container_name: Name of the container.
+        :type container_name: str
+        :param blob_name: Name of the blob.
+        :type blob_name: str
+        :param is_prefix: If blob_name is a prefix, delete all matching files
+        :type is_prefix: bool
+        :param ignore_if_missing: if True, then return success even if the
+        blob does not exist.
+        :type ignore_if_missing: bool
+        :param kwargs: Optional keyword arguments that
+            `BlockBlobService.create_blob_from_path()` takes.
+        :type kwargs: object
+        """
+
+        if is_prefix:
+            blobs_to_delete = [
+                blob.name for blob in self.connection.list_blobs(
+                    container_name, prefix=blob_name, **kwargs
+                )
+            ]
+        elif self.check_for_blob(container_name, blob_name):
+            blobs_to_delete = [blob_name]
+        else:
+            blobs_to_delete = []
+
+        if not ignore_if_missing and len(blobs_to_delete) == 0:
+            raise AirflowException('Blob(s) not found: {}'.format(blob_name))
+
+        for blob_uri in blobs_to_delete:
+            self.log.info("Deleting blob: " + blob_uri)
+            self.connection.delete_blob(container_name,
+                                        blob_uri,
+                                        delete_snapshots='include',
+                                        **kwargs)
diff --git a/airflow/contrib/operators/wasb_delete_blob_operator.py b/airflow/contrib/operators/wasb_delete_blob_operator.py
new file mode 100644
index 0000000000000..4634741d8b824
--- /dev/null
+++ b/airflow/contrib/operators/wasb_delete_blob_operator.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+from airflow.contrib.hooks.wasb_hook import WasbHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class WasbDeleteBlobOperator(BaseOperator):
+    """
+    Deletes blob(s) on Azure Blob Storage.
+
+    :param container_name: Name of the container. (templated)
+    :type container_name: str
+    :param blob_name: Name of the blob. (templated)
+    :type blob_name: str
+    :param wasb_conn_id: Reference to the wasb connection.
+    :type wasb_conn_id: str
+    :param check_options: Optional keyword arguments that
+        `WasbHook.check_for_blob()` takes.
+    :param is_prefix: If blob_name is a prefix, delete all files matching prefix.
+    :type is_prefix: bool
+    :param ignore_if_missing: if True, then return success even if the
+    blob does not exist.
+    :type ignore_if_missing: bool
+    """
+
+    template_fields = ('container_name', 'blob_name')
+
+    @apply_defaults
+    def __init__(self, container_name, blob_name,
+                 wasb_conn_id='wasb_default', check_options=None,
+                 is_prefix=False, ignore_if_missing=False,
+                 *args,
+                 **kwargs):
+        super(WasbDeleteBlobOperator, self).__init__(*args, **kwargs)
+        if check_options is None:
+            check_options = {}
+        self.wasb_conn_id = wasb_conn_id
+        self.container_name = container_name
+        self.blob_name = blob_name
+        self.check_options = check_options
+        self.is_prefix = is_prefix
+        self.ignore_if_missing = ignore_if_missing
+
+    def execute(self, context):
+        self.log.info(
+            'Deleting blob: {self.blob_name}\n'
+            'in wasb://{self.container_name}'.format(**locals())
+        )
+        hook = WasbHook(wasb_conn_id=self.wasb_conn_id)
+
+        hook.delete_file(self.container_name, self.blob_name,
+                         self.is_prefix, self.ignore_if_missing,
+                         **self.check_options)
diff --git a/tests/contrib/hooks/test_wasb_hook.py b/tests/contrib/hooks/test_wasb_hook.py
index 7a81512835a76..db2b69b4ed99b 100644
--- a/tests/contrib/hooks/test_wasb_hook.py
+++ b/tests/contrib/hooks/test_wasb_hook.py
@@ -21,8 +21,9 @@
 
 import json
 import unittest
+from collections import namedtuple
 
-from airflow import configuration
+from airflow import configuration, AirflowException
 from airflow import models
 from airflow.contrib.hooks.wasb_hook import WasbHook
 from airflow.utils import db
@@ -143,6 +144,59 @@ def test_read_file(self, mock_service):
             'container', 'blob', max_connections=1
         )
 
+    @mock.patch('airflow.contrib.hooks.wasb_hook.BlockBlobService',
+                autospec=True)
+    def test_delete_single_blob(self, mock_service):
+        mock_instance = mock_service.return_value
+        hook = WasbHook(wasb_conn_id='wasb_test_sas_token')
+        hook.delete_file('container', 'blob', is_prefix=False)
+        mock_instance.delete_blob.assert_called_once_with(
+            'container', 'blob', delete_snapshots='include'
+        )
+
+    @mock.patch('airflow.contrib.hooks.wasb_hook.BlockBlobService',
+                autospec=True)
+    def test_delete_multiple_blobs(self, mock_service):
+        mock_instance = mock_service.return_value
+        Blob = namedtuple('Blob', ['name'])
+        mock_instance.list_blobs.return_value = iter(
+            [Blob('blob_prefix/blob1'), Blob('blob_prefix/blob2')]
+        )
+        hook = WasbHook(wasb_conn_id='wasb_test_sas_token')
+        hook.delete_file('container', 'blob_prefix', is_prefix=True)
+        mock_instance.delete_blob.assert_any_call(
+            'container', 'blob_prefix/blob1', delete_snapshots='include'
+        )
+        mock_instance.delete_blob.assert_any_call(
+            'container', 'blob_prefix/blob2', delete_snapshots='include'
+        )
+
+    @mock.patch('airflow.contrib.hooks.wasb_hook.BlockBlobService',
+                autospec=True)
+    def test_delete_nonexisting_blob_fails(self, mock_service):
+        mock_instance = mock_service.return_value
+        mock_instance.exists.return_value = False
+        hook = WasbHook(wasb_conn_id='wasb_test_sas_token')
+        with self.assertRaises(Exception) as context:
+            hook.delete_file(
+                'container', 'nonexisting_blob',
+                is_prefix=False, ignore_if_missing=False
+            )
+        self.assertIsInstance(context.exception, AirflowException)
+
+    @mock.patch('airflow.contrib.hooks.wasb_hook.BlockBlobService',
+                autospec=True)
+    def test_delete_multiple_nonexisting_blobs_fails(self, mock_service):
+        mock_instance = mock_service.return_value
+        mock_instance.list_blobs.return_value = iter([])
+        hook = WasbHook(wasb_conn_id='wasb_test_sas_token')
+        with self.assertRaises(Exception) as context:
+            hook.delete_file(
+                'container', 'nonexisting_blob_prefix',
+                is_prefix=True, ignore_if_missing=False
+            )
+        self.assertIsInstance(context.exception, AirflowException)
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/operators/test_wasb_delete_blob_operator.py b/tests/contrib/operators/test_wasb_delete_blob_operator.py
new file mode 100644
index 0000000000000..7c3ed0bd630ad
--- /dev/null
+++ b/tests/contrib/operators/test_wasb_delete_blob_operator.py
@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import datetime
+import unittest
+
+from airflow import DAG, configuration
+from airflow.contrib.operators.wasb_delete_blob_operator import WasbDeleteBlobOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestWasbDeleteBlobOperator(unittest.TestCase):
+
+    _config = {
+        'container_name': 'container',
+        'blob_name': 'blob',
+    }
+
+    def setUp(self):
+        configuration.load_test_config()
+        args = {
+            'owner': 'airflow',
+            'start_date': datetime.datetime(2017, 1, 1)
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+
+    def test_init(self):
+        operator = WasbDeleteBlobOperator(
+            task_id='wasb_operator',
+            dag=self.dag,
+            **self._config
+        )
+        self.assertEqual(operator.container_name,
+                         self._config['container_name'])
+        self.assertEqual(operator.blob_name, self._config['blob_name'])
+        self.assertEqual(operator.is_prefix, False)
+        self.assertEqual(operator.ignore_if_missing, False)
+
+        operator = WasbDeleteBlobOperator(
+            task_id='wasb_operator',
+            dag=self.dag,
+            is_prefix=True,
+            ignore_if_missing=True,
+            **self._config
+        )
+        self.assertEqual(operator.is_prefix, True)
+        self.assertEqual(operator.ignore_if_missing, True)
+
+    @mock.patch('airflow.contrib.operators.wasb_delete_blob_operator.WasbHook',
+                autospec=True)
+    def test_execute(self, mock_hook):
+        mock_instance = mock_hook.return_value
+        operator = WasbDeleteBlobOperator(
+            task_id='wasb_operator',
+            dag=self.dag,
+            is_prefix=True,
+            ignore_if_missing=True,
+            **self._config
+        )
+        operator.execute(None)
+        mock_instance.delete_file.assert_called_once_with(
+            'container', 'blob', True, True
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

From 1234af2995780327517c770bd09daf684563527d Mon Sep 17 00:00:00 2001
From: noronham <michelle.j.noronha@gmail.com>
Date: Fri, 12 Oct 2018 07:06:46 -0400
Subject: [PATCH 115/808] [AIRFLOW-3138] Use current data type for migrations
 (#3985)

* Use timestamp instead of timestamp with timezone for migration.
---
 .../cc1e65623dc7_add_max_tries_column_to_task_instance.py      | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
index 68228f7219a87..61ad3ef57069d 100644
--- a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
+++ b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
@@ -35,7 +35,6 @@
 import sqlalchemy as sa
 from airflow import settings
 from airflow.models import DagBag
-from airflow.utils.sqlalchemy import UtcDateTime
 
 from sqlalchemy import (
     Column, Integer, String)
@@ -52,7 +51,7 @@ class TaskInstance(Base):
 
     task_id = Column(String(ID_LEN), primary_key=True)
     dag_id = Column(String(ID_LEN), primary_key=True)
-    execution_date = Column(UtcDateTime, primary_key=True)
+    execution_date = Column(sa.DateTime, primary_key=True)
     max_tries = Column(Integer)
     try_number = Column(Integer, default=0)
 

From 59b360b3adf1eb184305b4504dc9ed3b4c478df9 Mon Sep 17 00:00:00 2001
From: akosel <aaronjkosel@gmail.com>
Date: Fri, 12 Oct 2018 04:30:41 -0700
Subject: [PATCH 116/808] [AIRFLOW-393] Add callback for FTP downloads (#2372)

---
 airflow/contrib/hooks/ftp_hook.py    | 68 +++++++++++++++++++++++++---
 tests/contrib/hooks/test_ftp_hook.py | 23 ++++++++++
 2 files changed, 85 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/hooks/ftp_hook.py b/airflow/contrib/hooks/ftp_hook.py
index 8beefb372916c..03849012a3d5b 100644
--- a/airflow/contrib/hooks/ftp_hook.py
+++ b/airflow/contrib/hooks/ftp_hook.py
@@ -148,7 +148,11 @@ def delete_directory(self, path):
         conn = self.get_conn()
         conn.rmd(path)
 
-    def retrieve_file(self, remote_full_path, local_full_path_or_buffer):
+    def retrieve_file(
+            self,
+            remote_full_path,
+            local_full_path_or_buffer,
+            callback=None):
         """
         Transfers the remote file to a local location.
 
@@ -161,23 +165,59 @@ def retrieve_file(self, remote_full_path, local_full_path_or_buffer):
         :param local_full_path_or_buffer: full path to the local file or a
             file-like buffer
         :type local_full_path_or_buffer: str or file-like buffer
+        :param callback: callback which is called each time a block of data
+            is read. if you do not use a callback, these blocks will be written
+            to the file or buffer passed in. if you do pass in a callback, note
+            that writing to a file or buffer will need to be handled inside the
+            callback.
+            [default: output_handle.write()]
+        :type callback: callable
+
+        Example::
+            hook = FTPHook(ftp_conn_id='my_conn')
+
+            remote_path = '/path/to/remote/file'
+            local_path = '/path/to/local/file'
+
+            # with a custom callback (in this case displaying progress on each read)
+            def print_progress(percent_progress):
+                self.log.info('Percent Downloaded: %s%%' % percent_progress)
+
+            total_downloaded = 0
+            total_file_size = hook.get_size(remote_path)
+            output_handle = open(local_path, 'wb')
+            def write_to_file_with_progress(data):
+                total_downloaded += len(data)
+                output_handle.write(data)
+                percent_progress = (total_downloaded / total_file_size) * 100
+                print_progress(percent_progress)
+            hook.retrieve_file(remote_path, None, callback=write_to_file_with_progress)
+
+            # without a custom callback data is written to the local_path
+            hook.retrieve_file(remote_path, local_path)
         """
         conn = self.get_conn()
 
         is_path = isinstance(local_full_path_or_buffer, basestring)
 
-        if is_path:
-            output_handle = open(local_full_path_or_buffer, 'wb')
+        # without a callback, default to writing to a user-provided file or
+        # file-like buffer
+        if not callback:
+            if is_path:
+                output_handle = open(local_full_path_or_buffer, 'wb')
+            else:
+                output_handle = local_full_path_or_buffer
+            callback = output_handle.write
         else:
-            output_handle = local_full_path_or_buffer
+            output_handle = None
 
         remote_path, remote_file_name = os.path.split(remote_full_path)
         conn.cwd(remote_path)
         self.log.info('Retrieving file from FTP: %s', remote_full_path)
-        conn.retrbinary('RETR %s' % remote_file_name, output_handle.write)
+        conn.retrbinary('RETR %s' % remote_file_name, callback)
         self.log.info('Finished retrieving file from FTP: %s', remote_full_path)
 
-        if is_path:
+        if is_path and output_handle:
             output_handle.close()
 
     def store_file(self, remote_full_path, local_full_path_or_buffer):
@@ -230,6 +270,12 @@ def rename(self, from_name, to_name):
         return conn.rename(from_name, to_name)
 
     def get_mod_time(self, path):
+        """
+        Returns a datetime object representing the last time the file was modified
+
+        :param path: remote file path
+        :type path: string
+        """
         conn = self.get_conn()
         ftp_mdtm = conn.sendcmd('MDTM ' + path)
         time_val = ftp_mdtm[4:]
@@ -239,6 +285,16 @@ def get_mod_time(self, path):
         except ValueError:
             return datetime.datetime.strptime(time_val, '%Y%m%d%H%M%S')
 
+    def get_size(self, path):
+        """
+        Returns the size of a file (in bytes)
+
+        :param path: remote file path
+        :type path: string
+        """
+        conn = self.get_conn()
+        return conn.size(path)
+
 
 class FTPSHook(FTPHook):
 
diff --git a/tests/contrib/hooks/test_ftp_hook.py b/tests/contrib/hooks/test_ftp_hook.py
index ac5db561c32f6..e735217ad3609 100644
--- a/tests/contrib/hooks/test_ftp_hook.py
+++ b/tests/contrib/hooks/test_ftp_hook.py
@@ -19,6 +19,7 @@
 #
 
 import mock
+import six
 import unittest
 
 from airflow.contrib.hooks import ftp_hook as fh
@@ -101,6 +102,28 @@ def test_mod_time_micro(self):
 
         self.conn_mock.sendcmd.assert_called_once_with('MDTM ' + path)
 
+    def test_get_size(self):
+        self.conn_mock.size.return_value = 1942
+
+        path = '/path/file'
+        with fh.FTPHook() as ftp_hook:
+            ftp_hook.get_size(path)
+
+        self.conn_mock.size.assert_called_once_with(path)
+
+    def test_retrieve_file(self):
+        _buffer = six.StringIO('buffer')
+        with fh.FTPHook() as ftp_hook:
+            ftp_hook.retrieve_file(self.path, _buffer)
+        self.conn_mock.retrbinary.assert_called_once_with('RETR path', _buffer.write)
+
+    def test_retrieve_file_with_callback(self):
+        func = mock.Mock()
+        _buffer = six.StringIO('buffer')
+        with fh.FTPHook() as ftp_hook:
+            ftp_hook.retrieve_file(self.path, _buffer, callback=func)
+        self.conn_mock.retrbinary.assert_called_once_with('RETR path', func)
+
 
 if __name__ == '__main__':
     unittest.main()

From 23be2a30cd28f236722433a07c536cb17c8515ee Mon Sep 17 00:00:00 2001
From: Luke Bodeen <luke_bodeen@yahoo.com>
Date: Fri, 12 Oct 2018 06:44:28 -0500
Subject: [PATCH 117/808] [AIRFLOW-3119] Enable debugging with Celery(#3950)

This will enable --loglevel when launching a
celery worker and inherit that LOGGING_LEVEL
setting from airflow.cfg
---
 airflow/bin/cli.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 949a453c9eb87..4b2732049756c 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -961,6 +961,7 @@ def worker(args):
         'queues': args.queues,
         'concurrency': args.concurrency,
         'hostname': args.celery_hostname,
+        'loglevel': conf.get('core', 'LOGGING_LEVEL'),
     }
 
     if args.daemon:

From fc9a5b759346e2cd99f38e95df09982553ab3b3c Mon Sep 17 00:00:00 2001
From: niels <niels@zeilemaker.nl>
Date: Tue, 24 Jul 2018 10:44:00 +0200
Subject: [PATCH 118/808] [AIRFLOW-1762] Implement key_file support in ssh_hook
 create_tunnel

Switched to using sshtunnel package instead of
popen approach

Closes #3473 from NielsZeilemaker/ssh_hook
---
 airflow/contrib/hooks/ssh_hook.py          | 290 +++++++++++----------
 airflow/contrib/operators/sftp_operator.py |  26 +-
 airflow/contrib/operators/ssh_operator.py  | 139 +++++-----
 setup.py                                   |   2 +-
 tests/contrib/hooks/test_ssh_hook.py       | 156 ++++++++---
 5 files changed, 354 insertions(+), 259 deletions(-)

diff --git a/airflow/contrib/hooks/ssh_hook.py b/airflow/contrib/hooks/ssh_hook.py
index b4de5e08eef00..c496762187435 100755
--- a/airflow/contrib/hooks/ssh_hook.py
+++ b/airflow/contrib/hooks/ssh_hook.py
@@ -19,11 +19,12 @@
 
 import getpass
 import os
+import warnings
 
 import paramiko
 from paramiko.config import SSH_PORT
+from sshtunnel import SSHTunnelForwarder
 
-from contextlib import contextmanager
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -62,7 +63,7 @@ def __init__(self,
                  username=None,
                  password=None,
                  key_file=None,
-                 port=SSH_PORT,
+                 port=None,
                  timeout=10,
                  keepalive_interval=30
                  ):
@@ -72,162 +73,167 @@ def __init__(self,
         self.username = username
         self.password = password
         self.key_file = key_file
+        self.port = port
         self.timeout = timeout
         self.keepalive_interval = keepalive_interval
+
         # Default values, overridable from Connection
         self.compress = True
         self.no_host_key_check = True
+        self.host_proxy = None
+
+        # Placeholder for deprecated __enter__
         self.client = None
-        self.port = port
+
+        # Use connection to override defaults
+        if self.ssh_conn_id is not None:
+            conn = self.get_connection(self.ssh_conn_id)
+            if self.username is None:
+                self.username = conn.login
+            if self.password is None:
+                self.password = conn.password
+            if self.remote_host is None:
+                self.remote_host = conn.host
+            if self.port is None:
+                self.port = conn.port
+            if conn.extra is not None:
+                extra_options = conn.extra_dejson
+                self.key_file = extra_options.get("key_file")
+
+                if "timeout" in extra_options:
+                    self.timeout = int(extra_options["timeout"], 10)
+
+                if "compress" in extra_options\
+                        and str(extra_options["compress"]).lower() == 'false':
+                    self.compress = False
+                if "no_host_key_check" in extra_options\
+                        and\
+                        str(extra_options["no_host_key_check"]).lower() == 'false':
+                    self.no_host_key_check = False
+
+        if not self.remote_host:
+            raise AirflowException("Missing required param: remote_host")
+
+        # Auto detecting username values from system
+        if not self.username:
+            self.log.debug(
+                "username to ssh to host: %s is not specified for connection id"
+                " %s. Using system's default provided by getpass.getuser()",
+                self.remote_host, self.ssh_conn_id
+            )
+            self.username = getpass.getuser()
+
+        user_ssh_config_filename = os.path.expanduser('~/.ssh/config')
+        if os.path.isfile(user_ssh_config_filename):
+            ssh_conf = paramiko.SSHConfig()
+            ssh_conf.parse(open(user_ssh_config_filename))
+            host_info = ssh_conf.lookup(self.remote_host)
+            if host_info and host_info.get('proxycommand'):
+                self.host_proxy = paramiko.ProxyCommand(host_info.get('proxycommand'))
+
+            if not (self.password or self.key_file):
+                if host_info and host_info.get('identityfile'):
+                    self.key_file = host_info.get('identityfile')[0]
+
+        self.port = self.port or SSH_PORT
 
     def get_conn(self):
-        if not self.client:
-            self.log.debug('Creating SSH client for conn_id: %s', self.ssh_conn_id)
-            if self.ssh_conn_id is not None:
-                conn = self.get_connection(self.ssh_conn_id)
-                if self.username is None:
-                    self.username = conn.login
-                if self.password is None:
-                    self.password = conn.password
-                if self.remote_host is None:
-                    self.remote_host = conn.host
-                if conn.port is not None:
-                    self.port = conn.port
-                if conn.extra is not None:
-                    extra_options = conn.extra_dejson
-                    self.key_file = extra_options.get("key_file")
-
-                    if "timeout" in extra_options:
-                        self.timeout = int(extra_options["timeout"], 10)
-
-                    if "compress" in extra_options \
-                            and str(extra_options["compress"]).lower() == 'false':
-                        self.compress = False
-                    if "no_host_key_check" in extra_options \
-                            and \
-                            str(extra_options["no_host_key_check"]).lower() == 'false':
-                        self.no_host_key_check = False
-
-            if not self.remote_host:
-                raise AirflowException("Missing required param: remote_host")
-
-            # Auto detecting username values from system
-            if not self.username:
-                self.log.debug(
-                    "username to ssh to host: %s is not specified for connection id"
-                    " %s. Using system's default provided by getpass.getuser()",
-                    self.remote_host, self.ssh_conn_id
-                )
-                self.username = getpass.getuser()
-
-            host_proxy = None
-            user_ssh_config_filename = os.path.expanduser('~/.ssh/config')
-            if os.path.isfile(user_ssh_config_filename):
-                ssh_conf = paramiko.SSHConfig()
-                ssh_conf.parse(open(user_ssh_config_filename))
-                host_info = ssh_conf.lookup(self.remote_host)
-                if host_info and host_info.get('proxycommand'):
-                    host_proxy = paramiko.ProxyCommand(host_info.get('proxycommand'))
-
-                if not (self.password or self.key_file):
-                    if host_info and host_info.get('identityfile'):
-                        self.key_file = host_info.get('identityfile')[0]
-
-            try:
-                client = paramiko.SSHClient()
-                client.load_system_host_keys()
-                if self.no_host_key_check:
-                    # Default is RejectPolicy
-                    client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
-
-                if self.password and self.password.strip():
-                    client.connect(hostname=self.remote_host,
-                                   username=self.username,
-                                   password=self.password,
-                                   timeout=self.timeout,
-                                   compress=self.compress,
-                                   port=self.port,
-                                   sock=host_proxy)
-                else:
-                    client.connect(hostname=self.remote_host,
-                                   username=self.username,
-                                   key_filename=self.key_file,
-                                   timeout=self.timeout,
-                                   compress=self.compress,
-                                   port=self.port,
-                                   sock=host_proxy)
-
-                if self.keepalive_interval:
-                    client.get_transport().set_keepalive(self.keepalive_interval)
-
-                self.client = client
-            except paramiko.AuthenticationException as auth_error:
-                self.log.error(
-                    "Auth failed while connecting to host: %s, error: %s",
-                    self.remote_host, auth_error
-                )
-            except paramiko.SSHException as ssh_error:
-                self.log.error(
-                    "Failed connecting to host: %s, error: %s",
-                    self.remote_host, ssh_error
-                )
-            except Exception as error:
-                self.log.error(
-                    "Error connecting to host: %s, error: %s",
-                    self.remote_host, error
-                )
-        return self.client
-
-    @contextmanager
-    def create_tunnel(self, local_port, remote_port=None, remote_host="localhost"):
         """
-        Creates a tunnel between two hosts. Like ssh -L <LOCAL_PORT>:host:<REMOTE_PORT>.
-        Remember to close() the returned "tunnel" object in order to clean up
-        after yourself when you are done with the tunnel.
+        Opens a ssh connection to the remote host.
 
-        :param local_port:
-        :type local_port: int
-        :param remote_port:
-        :type remote_port: int
-        :param remote_host:
-        :type remote_host: str
-        :return:
+        :return paramiko.SSHClient object
         """
 
-        import subprocess
-        # this will ensure the connection to the ssh.remote_host from where the tunnel
-        # is getting created
-        self.get_conn()
-
-        tunnel_host = "{0}:{1}:{2}".format(local_port, remote_host, remote_port)
-
-        ssh_cmd = ["ssh", "{0}@{1}".format(self.username, self.remote_host),
-                   "-o", "ControlMaster=no",
-                   "-o", "UserKnownHostsFile=/dev/null",
-                   "-o", "StrictHostKeyChecking=no"]
-
-        ssh_tunnel_cmd = ["-L", tunnel_host,
-                          "echo -n ready && cat"
-                          ]
-
-        ssh_cmd += ssh_tunnel_cmd
-        self.log.debug("Creating tunnel with cmd: %s", ssh_cmd)
-
-        proc = subprocess.Popen(ssh_cmd,
-                                stdin=subprocess.PIPE,
-                                stdout=subprocess.PIPE,
-                                close_fds=True)
-        ready = proc.stdout.read(5)
-        assert ready == b"ready", \
-            "Did not get 'ready' from remote, got '{0}' instead".format(ready)
-        yield
-        proc.communicate()
-        assert proc.returncode == 0, \
-            "Tunnel process did unclean exit (returncode {}".format(proc.returncode)
+        self.log.debug('Creating SSH client for conn_id: %s', self.ssh_conn_id)
+        client = paramiko.SSHClient()
+        client.load_system_host_keys()
+        if self.no_host_key_check:
+            # Default is RejectPolicy
+            client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+
+        if self.password and self.password.strip():
+            client.connect(hostname=self.remote_host,
+                           username=self.username,
+                           password=self.password,
+                           key_filename=self.key_file,
+                           timeout=self.timeout,
+                           compress=self.compress,
+                           port=self.port,
+                           sock=self.host_proxy)
+        else:
+            client.connect(hostname=self.remote_host,
+                           username=self.username,
+                           key_filename=self.key_file,
+                           timeout=self.timeout,
+                           compress=self.compress,
+                           port=self.port,
+                           sock=self.host_proxy)
+
+        if self.keepalive_interval:
+            client.get_transport().set_keepalive(self.keepalive_interval)
+
+        self.client = client
+        return client
 
     def __enter__(self):
+        warnings.warn('The contextmanager of SSHHook is deprecated.'
+                      'Please use get_conn() as a contextmanager instead.'
+                      'This method will be removed in Airflow 2.0',
+                      category=DeprecationWarning)
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
         if self.client is not None:
             self.client.close()
+            self.client = None
+
+    def get_tunnel(self, remote_port, remote_host="localhost", local_port=None):
+        """
+        Creates a tunnel between two hosts. Like ssh -L <LOCAL_PORT>:host:<REMOTE_PORT>.
+
+        :param remote_port: The remote port to create a tunnel to
+        :type remote_port: int
+        :param remote_host: The remote host to create a tunnel to (default localhost)
+        :type remote_host: str
+        :param local_port:  The local port to attach the tunnel to
+        :type local_port: int
+
+        :return: sshtunnel.SSHTunnelForwarder object
+        """
+
+        if local_port:
+            local_bind_address = ('localhost', local_port)
+        else:
+            local_bind_address = ('localhost',)
+
+        if self.password and self.password.strip():
+            client = SSHTunnelForwarder(self.remote_host,
+                                        ssh_port=self.port,
+                                        ssh_username=self.username,
+                                        ssh_password=self.password,
+                                        ssh_pkey=self.key_file,
+                                        ssh_proxy=self.host_proxy,
+                                        local_bind_address=local_bind_address,
+                                        remote_bind_address=(remote_host, remote_port),
+                                        logger=self.log)
+        else:
+            client = SSHTunnelForwarder(self.remote_host,
+                                        ssh_port=self.port,
+                                        ssh_username=self.username,
+                                        ssh_pkey=self.key_file,
+                                        ssh_proxy=self.host_proxy,
+                                        local_bind_address=local_bind_address,
+                                        remote_bind_address=(remote_host, remote_port),
+                                        host_pkey_directories=[],
+                                        logger=self.log)
+
+        return client
+
+    def create_tunnel(self, local_port, remote_port=None, remote_host="localhost"):
+        warnings.warn('SSHHook.create_tunnel is deprecated, Please'
+                      'use get_tunnel() instead. But please note that the'
+                      'order of the parameters have changed'
+                      'This method will be removed in Airflow 2.0',
+                      category=DeprecationWarning)
+
+        return self.get_tunnel(remote_port, remote_host, local_port)
diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 153f440d41186..64a0a341563b7 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -82,18 +82,20 @@ def execute(self, context):
             if self.remote_host is not None:
                 self.ssh_hook.remote_host = self.remote_host
 
-            ssh_client = self.ssh_hook.get_conn()
-            sftp_client = ssh_client.open_sftp()
-            if self.operation.lower() == SFTPOperation.GET:
-                file_msg = "from {0} to {1}".format(self.remote_filepath,
-                                                    self.local_filepath)
-                self.log.debug("Starting to transfer %s", file_msg)
-                sftp_client.get(self.remote_filepath, self.local_filepath)
-            else:
-                file_msg = "from {0} to {1}".format(self.local_filepath,
-                                                    self.remote_filepath)
-                self.log.debug("Starting to transfer file %s", file_msg)
-                sftp_client.put(self.local_filepath, self.remote_filepath)
+            with self.ssh_hook.get_conn() as ssh_client:
+                sftp_client = ssh_client.open_sftp()
+                if self.operation.lower() == SFTPOperation.GET:
+                    file_msg = "from {0} to {1}".format(self.remote_filepath,
+                                                        self.local_filepath)
+                    self.log.debug("Starting to transfer %s", file_msg)
+                    sftp_client.get(self.remote_filepath, self.local_filepath)
+                else:
+                    file_msg = "from {0} to {1}".format(self.local_filepath,
+                                                        self.remote_filepath)
+                    self.log.debug("Starting to transfer file %s", file_msg)
+                    sftp_client.put(self.local_filepath,
+                                    self.remote_filepath,
+                                    confirm=self.confirm)
 
         except Exception as e:
             raise AirflowException("Error while transferring {0}, error: {1}"
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index d246800953341..2e890f463ea88 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -77,79 +77,78 @@ def execute(self, context):
             if self.remote_host is not None:
                 self.ssh_hook.remote_host = self.remote_host
 
-            ssh_client = self.ssh_hook.get_conn()
-
             if not self.command:
                 raise AirflowException("no command specified so nothing to execute here.")
 
-            # Auto apply tty when its required in case of sudo
-            get_pty = False
-            if self.command.startswith('sudo'):
-                get_pty = True
-
-            # set timeout taken as params
-            stdin, stdout, stderr = ssh_client.exec_command(command=self.command,
-                                                            get_pty=get_pty,
-                                                            timeout=self.timeout
-                                                            )
-            # get channels
-            channel = stdout.channel
-
-            # closing stdin
-            stdin.close()
-            channel.shutdown_write()
-
-            agg_stdout = b''
-            agg_stderr = b''
-
-            # capture any initial output in case channel is closed already
-            stdout_buffer_length = len(stdout.channel.in_buffer)
-
-            if stdout_buffer_length > 0:
-                agg_stdout += stdout.channel.recv(stdout_buffer_length)
-
-            # read from both stdout and stderr
-            while not channel.closed or \
-                    channel.recv_ready() or \
-                    channel.recv_stderr_ready():
-                readq, _, _ = select([channel], [], [], self.timeout)
-                for c in readq:
-                    if c.recv_ready():
-                        line = stdout.channel.recv(len(c.in_buffer))
-                        line = line
-                        agg_stdout += line
-                        self.log.info(line.decode('utf-8').strip('\n'))
-                    if c.recv_stderr_ready():
-                        line = stderr.channel.recv_stderr(len(c.in_stderr_buffer))
-                        line = line
-                        agg_stderr += line
-                        self.log.warning(line.decode('utf-8').strip('\n'))
-                if stdout.channel.exit_status_ready()\
-                        and not stderr.channel.recv_stderr_ready()\
-                        and not stdout.channel.recv_ready():
-                    stdout.channel.shutdown_read()
-                    stdout.channel.close()
-                    break
-
-            stdout.close()
-            stderr.close()
-
-            exit_status = stdout.channel.recv_exit_status()
-            if exit_status is 0:
-                # returning output if do_xcom_push is set
-                if self.do_xcom_push:
-                    enable_pickling = configuration.conf.getboolean(
-                        'core', 'enable_xcom_pickling'
-                    )
-                    if enable_pickling:
-                        return agg_stdout
-                    else:
-                        return b64encode(agg_stdout).decode('utf-8')
-
-            else:
-                error_msg = agg_stderr.decode('utf-8')
-                raise AirflowException("error running cmd: {0}, error: {1}"
-                                       .format(self.command, error_msg))
+            with self.ssh_hook.get_conn() as ssh_client:
+                # Auto apply tty when its required in case of sudo
+                get_pty = False
+                if self.command.startswith('sudo'):
+                    get_pty = True
+
+                # set timeout taken as params
+                stdin, stdout, stderr = ssh_client.exec_command(command=self.command,
+                                                                get_pty=get_pty,
+                                                                timeout=self.timeout
+                                                                )
+                # get channels
+                channel = stdout.channel
+
+                # closing stdin
+                stdin.close()
+                channel.shutdown_write()
+
+                agg_stdout = b''
+                agg_stderr = b''
+
+                # capture any initial output in case channel is closed already
+                stdout_buffer_length = len(stdout.channel.in_buffer)
+
+                if stdout_buffer_length > 0:
+                    agg_stdout += stdout.channel.recv(stdout_buffer_length)
+
+                # read from both stdout and stderr
+                while not channel.closed or \
+                        channel.recv_ready() or \
+                        channel.recv_stderr_ready():
+                    readq, _, _ = select([channel], [], [], self.timeout)
+                    for c in readq:
+                        if c.recv_ready():
+                            line = stdout.channel.recv(len(c.in_buffer))
+                            line = line
+                            agg_stdout += line
+                            self.log.info(line.decode('utf-8').strip('\n'))
+                        if c.recv_stderr_ready():
+                            line = stderr.channel.recv_stderr(len(c.in_stderr_buffer))
+                            line = line
+                            agg_stderr += line
+                            self.log.warning(line.decode('utf-8').strip('\n'))
+                    if stdout.channel.exit_status_ready()\
+                            and not stderr.channel.recv_stderr_ready()\
+                            and not stdout.channel.recv_ready():
+                        stdout.channel.shutdown_read()
+                        stdout.channel.close()
+                        break
+
+                stdout.close()
+                stderr.close()
+
+                exit_status = stdout.channel.recv_exit_status()
+                if exit_status is 0:
+                    # returning output if do_xcom_push is set
+                    if self.do_xcom_push:
+                        enable_pickling = configuration.conf.getboolean(
+                            'core', 'enable_xcom_pickling'
+                        )
+                        if enable_pickling:
+                            return agg_stdout
+                        else:
+                            return b64encode(agg_stdout).decode('utf-8')
+
+                else:
+                    error_msg = agg_stderr.decode('utf-8')
+                    raise AirflowException("error running cmd: {0}, error: {1}"
+                                           .format(self.command, error_msg))
 
         except Exception as e:
             raise AirflowException("SSH operator error: {0}".format(str(e)))
diff --git a/setup.py b/setup.py
index ba5cb94c7cb93..0abe23c6823fe 100644
--- a/setup.py
+++ b/setup.py
@@ -210,7 +210,7 @@ def write_version(filename=os.path.join(*['airflow',
 mongo = ['pymongo>=3.6.0']
 snowflake = ['snowflake-connector-python>=1.5.2',
              'snowflake-sqlalchemy>=1.1.0']
-ssh = ['paramiko>=2.1.1', 'pysftp>=0.2.9']
+ssh = ['paramiko>=2.1.1', 'pysftp>=0.2.9', 'sshtunnel>=0.1.4,<0.2']
 statsd = ['statsd>=3.0.1, <4.0']
 vertica = ['vertica-python>=0.5.1']
 webhdfs = ['hdfs[dataframe,avro,kerberos]>=2.0.4']
diff --git a/tests/contrib/hooks/test_ssh_hook.py b/tests/contrib/hooks/test_ssh_hook.py
index b185a565c2f69..ad5621fe92357 100644
--- a/tests/contrib/hooks/test_ssh_hook.py
+++ b/tests/contrib/hooks/test_ssh_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -22,6 +22,17 @@
 from airflow.utils import db
 from airflow import models
 
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow.contrib.hooks.ssh_hook import SSHHook
+
+
 HELLO_SERVER_CMD = """
 import socket, sys
 listener = socket.socket()
@@ -36,43 +47,90 @@
 
 
 class SSHHookTest(unittest.TestCase):
+
     def setUp(self):
         configuration.load_test_config()
-        from airflow.contrib.hooks.ssh_hook import SSHHook
-        self.hook = SSHHook(ssh_conn_id='ssh_default', keepalive_interval=10)
-        self.hook.no_host_key_check = True
 
-    def test_ssh_connection(self):
-        ssh_hook = self.hook.get_conn()
-        self.assertIsNotNone(ssh_hook)
+    @mock.patch('airflow.contrib.hooks.ssh_hook.paramiko.SSHClient')
+    def test_ssh_connection_with_password(self, ssh_mock):
+        hook = SSHHook(remote_host='remote_host',
+                       port='port',
+                       username='username',
+                       password='password',
+                       timeout=10,
+                       key_file='fake.file')
 
-    def test_tunnel(self):
-        print("Setting up remote listener")
-        import subprocess
-        import socket
+        with hook.get_conn():
+            ssh_mock.return_value.connect.assert_called_once_with(
+                hostname='remote_host',
+                username='username',
+                password='password',
+                key_filename='fake.file',
+                timeout=10,
+                compress=True,
+                port='port',
+                sock=None
+            )
 
-        self.server_handle = subprocess.Popen(["python", "-c", HELLO_SERVER_CMD],
-                                              stdout=subprocess.PIPE)
-        print("Setting up tunnel")
-        with self.hook.create_tunnel(2135, 2134):
-            print("Tunnel up")
-            server_output = self.server_handle.stdout.read(5)
-            self.assertEqual(server_output, b"ready")
-            print("Connecting to server via tunnel")
-            s = socket.socket()
-            s.connect(("localhost", 2135))
-            print("Receiving...",)
-            response = s.recv(5)
-            self.assertEqual(response, b"hello")
-            print("Closing connection")
-            s.close()
-            print("Waiting for listener...")
-            output, _ = self.server_handle.communicate()
-            self.assertEqual(self.server_handle.returncode, 0)
-            print("Closing tunnel")
+    @mock.patch('airflow.contrib.hooks.ssh_hook.paramiko.SSHClient')
+    def test_ssh_connection_without_password(self, ssh_mock):
+        hook = SSHHook(remote_host='remote_host',
+                       port='port',
+                       username='username',
+                       timeout=10,
+                       key_file='fake.file')
+
+        with hook.get_conn():
+            ssh_mock.return_value.connect.assert_called_once_with(
+                hostname='remote_host',
+                username='username',
+                key_filename='fake.file',
+                timeout=10,
+                compress=True,
+                port='port',
+                sock=None
+            )
+
+    @mock.patch('airflow.contrib.hooks.ssh_hook.SSHTunnelForwarder')
+    def test_tunnel_with_password(self, ssh_mock):
+        hook = SSHHook(remote_host='remote_host',
+                       port='port',
+                       username='username',
+                       password='password',
+                       timeout=10,
+                       key_file='fake.file')
+
+        with hook.get_tunnel(1234):
+            ssh_mock.assert_called_once_with('remote_host',
+                                             ssh_port='port',
+                                             ssh_username='username',
+                                             ssh_password='password',
+                                             ssh_pkey='fake.file',
+                                             ssh_proxy=None,
+                                             local_bind_address=('localhost', ),
+                                             remote_bind_address=('localhost', 1234),
+                                             logger=hook.log)
+
+    @mock.patch('airflow.contrib.hooks.ssh_hook.SSHTunnelForwarder')
+    def test_tunnel_without_password(self, ssh_mock):
+        hook = SSHHook(remote_host='remote_host',
+                       port='port',
+                       username='username',
+                       timeout=10,
+                       key_file='fake.file')
+
+        with hook.get_tunnel(1234):
+            ssh_mock.assert_called_once_with('remote_host',
+                                             ssh_port='port',
+                                             ssh_username='username',
+                                             ssh_pkey='fake.file',
+                                             ssh_proxy=None,
+                                             local_bind_address=('localhost', ),
+                                             remote_bind_address=('localhost', 1234),
+                                             host_pkey_directories=[],
+                                             logger=hook.log)
 
     def test_conn_with_extra_parameters(self):
-        from airflow.contrib.hooks.ssh_hook import SSHHook
         db.merge_conn(
             models.Connection(conn_id='ssh_with_extra',
                               host='localhost',
@@ -80,11 +138,41 @@ def test_conn_with_extra_parameters(self):
                               extra='{"compress" : true, "no_host_key_check" : "true"}'
                               )
         )
-        ssh_hook = SSHHook(ssh_conn_id='ssh_with_extra', keepalive_interval=10)
-        ssh_hook.get_conn()
+        ssh_hook = SSHHook(ssh_conn_id='ssh_with_extra')
         self.assertEqual(ssh_hook.compress, True)
         self.assertEqual(ssh_hook.no_host_key_check, True)
 
+    def test_ssh_connection(self):
+        hook = SSHHook(ssh_conn_id='ssh_default')
+        with hook.get_conn() as client:
+            (_, stdout, _) = client.exec_command('ls')
+            self.assertIsNotNone(stdout.read())
+
+    def test_ssh_connection_old_cm(self):
+        with SSHHook(ssh_conn_id='ssh_default') as hook:
+            client = hook.get_conn()
+            (_, stdout, _) = client.exec_command('ls')
+            self.assertIsNotNone(stdout.read())
+
+    def test_tunnel(self):
+        hook = SSHHook(ssh_conn_id='ssh_default')
+
+        import subprocess
+        import socket
+
+        server_handle = subprocess.Popen(["python", "-c", HELLO_SERVER_CMD],
+                                         stdout=subprocess.PIPE)
+        with hook.create_tunnel(2135, 2134):
+            server_output = server_handle.stdout.read(5)
+            self.assertEqual(server_output, b"ready")
+            s = socket.socket()
+            s.connect(("localhost", 2135))
+            response = s.recv(5)
+            self.assertEqual(response, b"hello")
+            s.close()
+            output, _ = server_handle.communicate()
+            self.assertEqual(server_handle.returncode, 0)
+
 
 if __name__ == '__main__':
     unittest.main()

From 35969a426822e5fc9bc2b941b4fe5c5098a5ee52 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Fri, 12 Oct 2018 20:06:19 +0800
Subject: [PATCH 119/808] [AIRFLOW-3112] Make SFTP hook to inherit SSH hook
 (#3945)

This is to aline the arguments of SFTP hook with SSH hook
---
 airflow/contrib/hooks/sftp_hook.py | 69 +++++++++++++++++++++++-------
 1 file changed, 53 insertions(+), 16 deletions(-)

diff --git a/airflow/contrib/hooks/sftp_hook.py b/airflow/contrib/hooks/sftp_hook.py
index 33c8b19e0a732..3cb32ab8ba93b 100644
--- a/airflow/contrib/hooks/sftp_hook.py
+++ b/airflow/contrib/hooks/sftp_hook.py
@@ -21,11 +21,14 @@
 import pysftp
 import logging
 import datetime
-from airflow.hooks.base_hook import BaseHook
+from airflow.contrib.hooks.ssh_hook import SSHHook
 
 
-class SFTPHook(BaseHook):
+class SFTPHook(SSHHook):
     """
+    This hook is inherited from SSH hook. Please refer to SSH hook for the input
+    arguments.
+
     Interact with SFTP. Aims to be interchangeable with FTPHook.
 
     Pitfalls: - In contrast with FTPHook describe_directory only returns size, type and
@@ -39,32 +42,66 @@ class SFTPHook(BaseHook):
     Errors that may occur throughout but should be handled downstream.
     """
 
-    def __init__(self, ftp_conn_id='sftp_default'):
-        self.ftp_conn_id = ftp_conn_id
+    def __init__(self, ftp_conn_id='sftp_default', *args, **kwargs):
+        kwargs['ssh_conn_id'] = ftp_conn_id
+        super(SFTPHook, self).__init__(*args, **kwargs)
+
         self.conn = None
+        self.private_key_pass = None
+
+        if self.ssh_conn_id is not None:
+            conn = self.get_connection(self.ssh_conn_id)
+            if conn.extra is not None:
+                extra_options = conn.extra_dejson
+                if 'private_key_pass' in extra_options:
+                    self.private_key_pass = extra_options.get('private_key_pass', None)
+
+                # For backward compatibility
+                # TODO: remove in Airflow 2.1
+                import warnings
+                if 'ignore_hostkey_verification' in extra_options \
+                        and str(extra_options["ignore_hostkey_verification"])\
+                        .lower() == 'false':
+                    warnings.warn(
+                        'Extra option `ignore_hostkey_verification` is deprecated.'
+                        'Please use `no_host_key_check` instead.'
+                        'This option will be removed in Airflow 2.1',
+                        DeprecationWarning,
+                        stacklevel=2,
+                    )
+                    self.no_host_key_check = False
+                if 'private_key' in extra_options:
+                    warnings.warn(
+                        'Extra option `private_key` is deprecated.'
+                        'Please use `key_file` instead.'
+                        'This option will be removed in Airflow 2.1',
+                        DeprecationWarning,
+                        stacklevel=2,
+                    )
+                    self.key_file = extra_options.get('private_key')
 
     def get_conn(self):
         """
         Returns an SFTP connection object
         """
         if self.conn is None:
-            params = self.get_connection(self.ftp_conn_id)
             cnopts = pysftp.CnOpts()
-            if ('ignore_hostkey_verification' in params.extra_dejson and
-                    params.extra_dejson['ignore_hostkey_verification']):
+            if self.no_host_key_check:
                 cnopts.hostkeys = None
+            cnopts.compression = self.compress
             conn_params = {
-                'host': params.host,
-                'port': params.port,
-                'username': params.login,
+                'host': self.remote_host,
+                'port': self.port,
+                'username': self.username,
                 'cnopts': cnopts
             }
-            if params.password is not None:
-                conn_params['password'] = params.password
-            if 'private_key' in params.extra_dejson:
-                conn_params['private_key'] = params.extra_dejson['private_key']
-            if 'private_key_pass' in params.extra_dejson:
-                conn_params['private_key_pass'] = params.extra_dejson['private_key_pass']
+            if self.password and self.password.strip():
+                conn_params['password'] = self.password
+            if self.key_file:
+                conn_params['private_key'] = self.key_file
+            if self.private_key_pass:
+                conn_params['private_key_pass'] = self.private_key_pass
+
             self.conn = pysftp.Connection(**conn_params)
         return self.conn
 

From 916e98a24e10a9e54c4cace87d166cf97851f021 Mon Sep 17 00:00:00 2001
From: Dave Cavaletto <dave.cavaletto@healthmine.com>
Date: Fri, 6 Jul 2018 22:36:03 +0200
Subject: [PATCH 120/808] [AIRFLOW-2622] add confirm option to SFTPOperator[]

surfaces the confirm option in the SFTPOperator
provided by the
underlying parmiko library, useful for when the
receiving server
moves the incoming file before the confirmation
step can be completed

Closes #3542 from caddac/master
---
 airflow/contrib/operators/sftp_operator.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 64a0a341563b7..def54c3fbadc9 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -43,8 +43,10 @@ class SFTPOperator(BaseOperator):
     :type local_filepath: str
     :param remote_filepath: remote file path to get or put. (templated)
     :type remote_filepath: str
-    :param operation: specify operation 'get' or 'put', defaults to get
+    :param operation: specify operation 'get' or 'put', defaults to put
     :type get: bool
+    :param confirm: specify if the SFTP operation should be confirmed, defaults to True
+    :type confirm: bool
     """
     template_fields = ('local_filepath', 'remote_filepath')
 
@@ -56,6 +58,7 @@ def __init__(self,
                  local_filepath=None,
                  remote_filepath=None,
                  operation=SFTPOperation.PUT,
+                 confirm=True,
                  *args,
                  **kwargs):
         super(SFTPOperator, self).__init__(*args, **kwargs)
@@ -65,6 +68,7 @@ def __init__(self,
         self.local_filepath = local_filepath
         self.remote_filepath = remote_filepath
         self.operation = operation
+        self.confirm = confirm
         if not (self.operation.lower() == SFTPOperation.GET or
                 self.operation.lower() == SFTPOperation.PUT):
             raise TypeError("unsupported operation value {0}, expected {1} or {2}"

From 8e55b499b2dcc6e4dc4d86f8225d1424f6886a0c Mon Sep 17 00:00:00 2001
From: awelsh93 <32643586+awelsh93@users.noreply.github.com>
Date: Fri, 12 Oct 2018 13:11:16 +0100
Subject: [PATCH 121/808] [AIRFLOW-3195] Log query and task_id in druid-hook
 (#4018)

Log query and task_id in druid-hook
---
 airflow/hooks/druid_hook.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index fbd74e8e47d39..48a09e67b20df 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -68,6 +68,7 @@ def get_conn_url(self):
     def submit_indexing_job(self, json_index_spec):
         url = self.get_conn_url()
 
+        self.log.info("Druid ingestion spec: {}".format(json_index_spec))
         req_index = requests.post(url, json=json_index_spec, headers=self.header)
         if (req_index.status_code != 200):
             raise AirflowException('Did not get 200 when '
@@ -76,6 +77,7 @@ def submit_indexing_job(self, json_index_spec):
         req_json = req_index.json()
         # Wait until the job is completed
         druid_task_id = req_json['task']
+        self.log.info("Druid indexing task-id: {}".format(druid_task_id))
 
         running = True
 

From 3e3efda34272c27bee05cdb61c7b9a562e6bcdce Mon Sep 17 00:00:00 2001
From: Jarek <exploy@users.noreply.github.com>
Date: Wed, 12 Sep 2018 10:29:12 +0200
Subject: [PATCH 122/808] [AIRFLOW-2797] Create Google Dataproc cluster with
 custom image (#3871)

---
 .../contrib/operators/dataproc_operator.py    | 14 ++++++++
 .../operators/test_dataproc_operator.py       | 34 +++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 957a1b89e6b07..2638b60e516bd 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -68,6 +68,9 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type metadata: dict
     :param image_version: the version of software inside the Dataproc cluster
     :type image_version: string
+    :param custom_image: custom Dataproc image for more info see
+        https://cloud.google.com/dataproc/docs/guides/dataproc-images
+    :type: custom_image: string
     :param properties: dict of properties to set on
         config files (e.g. spark-defaults.conf), see
         https://cloud.google.com/dataproc/docs/reference/rest/v1/ \
@@ -148,6 +151,7 @@ def __init__(self,
                  init_actions_uris=None,
                  init_action_timeout="10m",
                  metadata=None,
+                 custom_image=None,
                  image_version=None,
                  properties=None,
                  master_machine_type='n1-standard-4',
@@ -180,6 +184,7 @@ def __init__(self,
         self.init_actions_uris = init_actions_uris
         self.init_action_timeout = init_action_timeout
         self.metadata = metadata
+        self.custom_image = custom_image
         self.image_version = image_version
         self.properties = properties
         self.master_machine_type = master_machine_type
@@ -201,6 +206,9 @@ def __init__(self,
         self.auto_delete_time = auto_delete_time
         self.auto_delete_ttl = auto_delete_ttl
 
+        assert not (self.custom_image and self.image_version), \
+            "custom_image and image_version can't be both set"
+
     def _get_cluster_list_for_project(self, service):
         result = service.projects().regions().clusters().list(
             projectId=self.project_id,
@@ -338,6 +346,12 @@ def _build_cluster_data(self):
             cluster_data['config']['gceClusterConfig']['tags'] = self.tags
         if self.image_version:
             cluster_data['config']['softwareConfig']['imageVersion'] = self.image_version
+        elif self.custom_image:
+            custom_image_url = 'https://www.googleapis.com/compute/beta/projects/' \
+                               '{}/global/images/{}'.format(self.project_id,
+                                                            self.custom_image)
+            cluster_data['config']['masterConfig']['imageUri'] = custom_image_url
+            cluster_data['config']['workerConfig']['imageUri'] = custom_image_url
         if self.properties:
             cluster_data['config']['softwareConfig']['properties'] = self.properties
         if self.idle_delete_ttl:
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index ab191f3c32760..bb1e0dfb7eb11 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -59,6 +59,7 @@
 TAGS = ['tag1', 'tag2']
 STORAGE_BUCKET = 'gs://airflow-test-bucket/'
 IMAGE_VERSION = '1.1'
+CUSTOM_IMAGE = 'test-custom-image'
 MASTER_MACHINE_TYPE = 'n1-standard-2'
 MASTER_DISK_SIZE = 100
 MASTER_DISK_TYPE = 'pd-standard'
@@ -243,6 +244,39 @@ def test_build_cluster_data_with_autoDeleteTime_and_autoDeleteTtl(self):
         self.assertEqual(cluster_data['config']['lifecycleConfig']['autoDeleteTime'],
                          "2017-06-07T00:00:00.000000Z")
 
+    def test_init_with_image_version_and_custom_image_both_set(self):
+        with self.assertRaises(AssertionError):
+            DataprocClusterCreateOperator(
+                task_id=TASK_ID,
+                cluster_name=CLUSTER_NAME,
+                project_id=PROJECT_ID,
+                num_workers=NUM_WORKERS,
+                zone=ZONE,
+                dag=self.dag,
+                image_version=IMAGE_VERSION,
+                custom_image=CUSTOM_IMAGE
+            )
+
+    def test_init_with_custom_image(self):
+        dataproc_operator = DataprocClusterCreateOperator(
+            task_id=TASK_ID,
+            cluster_name=CLUSTER_NAME,
+            project_id=PROJECT_ID,
+            num_workers=NUM_WORKERS,
+            zone=ZONE,
+            dag=self.dag,
+            custom_image=CUSTOM_IMAGE
+        )
+
+        cluster_data = dataproc_operator._build_cluster_data()
+        expected_custom_image_url = \
+            'https://www.googleapis.com/compute/beta/projects/' \
+            '{}/global/images/{}'.format(PROJECT_ID, CUSTOM_IMAGE)
+        self.assertEqual(cluster_data['config']['masterConfig']['imageUri'],
+                         expected_custom_image_url)
+        self.assertEqual(cluster_data['config']['workerConfig']['imageUri'],
+                         expected_custom_image_url)
+
     def test_cluster_name_log_no_sub(self):
         with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') \
                 as mock_hook:

From 62ab4efe6547b45dd4827ac4e0353e552a294fd4 Mon Sep 17 00:00:00 2001
From: Jarek <exploy@users.noreply.github.com>
Date: Fri, 12 Oct 2018 16:47:12 +0200
Subject: [PATCH 123/808] [AIRFLOW-2789] Create single node DataProc cluster
 (#4015)

Create single node cluster - infer from num_workers
---
 .../contrib/operators/dataproc_operator.py    | 24 +++++++++++++---
 .../operators/test_dataproc_operator.py       | 28 +++++++++++++++++++
 2 files changed, 48 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 2638b60e516bd..cc7ff21b0df2a 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -51,8 +51,9 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type cluster_name: string
     :param project_id: The ID of the google cloud project in which
         to create the cluster. (templated)
-    :type project_id: string
-    :param num_workers: The # of workers to spin up
+    :type project_id: str
+    :param num_workers: The # of workers to spin up. If set to zero will
+        spin up cluster in a single node mode
     :type num_workers: int
     :param storage_bucket: The storage bucket to use, setting to None lets dataproc
         generate a custom one for you
@@ -186,7 +187,7 @@ def __init__(self,
         self.metadata = metadata
         self.custom_image = custom_image
         self.image_version = image_version
-        self.properties = properties
+        self.properties = properties or dict()
         self.master_machine_type = master_machine_type
         self.master_disk_type = master_disk_type
         self.master_disk_size = master_disk_size
@@ -205,6 +206,16 @@ def __init__(self,
         self.idle_delete_ttl = idle_delete_ttl
         self.auto_delete_time = auto_delete_time
         self.auto_delete_ttl = auto_delete_ttl
+        self.single_node = num_workers == 0
+
+        assert not (self.custom_image and self.image_version), \
+            "custom_image and image_version can't be both set"
+
+        assert (
+            not self.single_node or (
+                self.single_node and self.num_preemptible_workers == 0
+            )
+        ), "num_workers == 0 means single node mode - no preemptibles allowed"
 
         assert not (self.custom_image and self.image_version), \
             "custom_image and image_version can't be both set"
@@ -351,7 +362,12 @@ def _build_cluster_data(self):
                                '{}/global/images/{}'.format(self.project_id,
                                                             self.custom_image)
             cluster_data['config']['masterConfig']['imageUri'] = custom_image_url
-            cluster_data['config']['workerConfig']['imageUri'] = custom_image_url
+            if not self.single_node:
+                cluster_data['config']['workerConfig']['imageUri'] = custom_image_url
+
+        if self.single_node:
+            self.properties["dataproc:dataproc.allow.zero.workers"] = "true"
+
         if self.properties:
             cluster_data['config']['softwareConfig']['properties'] = self.properties
         if self.idle_delete_ttl:
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index bb1e0dfb7eb11..4d8540eb86202 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -277,6 +277,34 @@ def test_init_with_custom_image(self):
         self.assertEqual(cluster_data['config']['workerConfig']['imageUri'],
                          expected_custom_image_url)
 
+    def test_build_single_node_cluster(self):
+        dataproc_operator = DataprocClusterCreateOperator(
+            task_id=TASK_ID,
+            cluster_name=CLUSTER_NAME,
+            project_id=PROJECT_ID,
+            num_workers=0,
+            num_preemptible_workers=0,
+            zone=ZONE,
+            dag=self.dag
+        )
+        cluster_data = dataproc_operator._build_cluster_data()
+        self.assertEqual(
+            cluster_data['config']['softwareConfig']['properties']
+            ['dataproc:dataproc.allow.zero.workers'], "true")
+
+    def test_init_cluster_with_zero_workers_and_not_non_zero_preemtibles(self):
+        with self.assertRaises(AssertionError):
+            DataprocClusterCreateOperator(
+                task_id=TASK_ID,
+                cluster_name=CLUSTER_NAME,
+                project_id=PROJECT_ID,
+                num_workers=0,
+                num_preemptible_workers=2,
+                zone=ZONE,
+                dag=self.dag,
+                image_version=IMAGE_VERSION,
+            )
+
     def test_cluster_name_log_no_sub(self):
         with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') \
                 as mock_hook:

From 80d113e23fcdb0aadf339dfb83ceffdeb2792911 Mon Sep 17 00:00:00 2001
From: neil90 <neilpatel90@gmail.com>
Date: Fri, 12 Oct 2018 23:02:20 -0700
Subject: [PATCH 124/808] [AIRFLOW-2932] GoogleCloudStorageHook - allow
 compression of file (#3893)

- Add gzip functionality to GoogleCloudStorageHook.upload
- Resolve docstring mistype, added additional information to
  tell user that there is option to compress
- Add test case for file_to_gcs
---
 airflow/contrib/hooks/gcs_hook.py           | 24 +++++++-
 airflow/contrib/operators/file_to_gcs.py    | 13 +++-
 tests/contrib/operators/test_file_to_gcs.py | 66 +++++++++++++++++++++
 3 files changed, 98 insertions(+), 5 deletions(-)
 create mode 100644 tests/contrib/operators/test_file_to_gcs.py

diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 08d44ce7faf92..b70825eb61f39 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -24,7 +24,10 @@
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.exceptions import AirflowException
 
+import gzip as gz
+import shutil
 import re
+import os
 
 
 class GoogleCloudStorageHook(GoogleCloudBaseHook):
@@ -171,7 +174,8 @@ def download(self, bucket, object, filename=None):
         return downloaded_file_bytes
 
     # pylint:disable=redefined-builtin
-    def upload(self, bucket, object, filename, mime_type='application/octet-stream'):
+    def upload(self, bucket, object, filename,
+               mime_type='application/octet-stream', gzip=False):
         """
         Uploads a local file to Google Cloud Storage.
 
@@ -182,15 +186,31 @@ def upload(self, bucket, object, filename, mime_type='application/octet-stream')
         :param filename: The local file path to the file to be uploaded.
         :type filename: string
         :param mime_type: The MIME type to set when uploading the file.
-        :type mime_type: string
+        :type mime_type: str
+        :param gzip: Option to compress file for upload
+        :type gzip: bool
         """
         service = self.get_conn()
+
+        if gzip:
+            filename_gz = filename + '.gz'
+
+            with open(filename, 'rb') as f_in:
+                with gz.open(filename_gz, 'wb') as f_out:
+                    shutil.copyfileobj(f_in, f_out)
+                    filename = filename_gz
+
         media = MediaFileUpload(filename, mime_type)
+
         try:
             service \
                 .objects() \
                 .insert(bucket=bucket, name=object, media_body=media) \
                 .execute()
+
+            # Clean up gzip file
+            if gzip:
+                os.remove(filename)
             return True
         except errors.HttpError as ex:
             if ex.resp['status'] == '404':
diff --git a/airflow/contrib/operators/file_to_gcs.py b/airflow/contrib/operators/file_to_gcs.py
index 807385b43c3a7..b750e0fc4879e 100644
--- a/airflow/contrib/operators/file_to_gcs.py
+++ b/airflow/contrib/operators/file_to_gcs.py
@@ -25,7 +25,8 @@
 
 class FileToGoogleCloudStorageOperator(BaseOperator):
     """
-    Uploads a file to Google Cloud Storage
+    Uploads a file to Google Cloud Storage.
+    Optionally can compress the file for upload.
 
     :param src: Path to the local file. (templated)
     :type src: string
@@ -38,7 +39,9 @@ class FileToGoogleCloudStorageOperator(BaseOperator):
     :param mime_type: The mime-type string
     :type mime_type: string
     :param delegate_to: The account to impersonate, if any
-    :type delegate_to: string
+    :type delegate_to: str
+    :param gzip: Allows for file to be compressed and uploaded as gzip
+    :type gzip: bool
     """
     template_fields = ('src', 'dst', 'bucket')
 
@@ -50,6 +53,7 @@ def __init__(self,
                  google_cloud_storage_conn_id='google_cloud_default',
                  mime_type='application/octet-stream',
                  delegate_to=None,
+                 gzip=False,
                  *args,
                  **kwargs):
         super(FileToGoogleCloudStorageOperator, self).__init__(*args, **kwargs)
@@ -59,6 +63,7 @@ def __init__(self,
         self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
         self.mime_type = mime_type
         self.delegate_to = delegate_to
+        self.gzip = gzip
 
     def execute(self, context):
         """
@@ -72,4 +77,6 @@ def execute(self, context):
             bucket=self.bucket,
             object=self.dst,
             mime_type=self.mime_type,
-            filename=self.src)
+            filename=self.src,
+            gzip=self.gzip,
+        )
diff --git a/tests/contrib/operators/test_file_to_gcs.py b/tests/contrib/operators/test_file_to_gcs.py
new file mode 100644
index 0000000000000..590267a319e96
--- /dev/null
+++ b/tests/contrib/operators/test_file_to_gcs.py
@@ -0,0 +1,66 @@
+import datetime
+import unittest
+
+from airflow import DAG, configuration
+from airflow.contrib.operators.file_to_gcs import FileToGoogleCloudStorageOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestFileToGcsOperator(unittest.TestCase):
+
+    _config = {
+        'src': '/tmp/fake.csv',
+        'dst': 'fake.csv',
+        'bucket': 'dummy',
+        'mime_type': 'application/octet-stream',
+        'gzip': False
+    }
+
+    def setUp(self):
+        configuration.load_test_config()
+        args = {
+            'owner': 'airflow',
+            'start_date': datetime.datetime(2017, 1, 1)
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+
+    def test_init(self):
+        operator = FileToGoogleCloudStorageOperator(
+            task_id='file_to_gcs_operator',
+            dag=self.dag,
+            **self._config
+        )
+        self.assertEqual(operator.src, self._config['src'])
+        self.assertEqual(operator.dst, self._config['dst'])
+        self.assertEqual(operator.bucket, self._config['bucket'])
+        self.assertEqual(operator.mime_type, self._config['mime_type'])
+        self.assertEqual(operator.gzip, self._config['gzip'])
+
+    @mock.patch('airflow.contrib.operators.file_to_gcs.GoogleCloudStorageHook',
+                autospec=True)
+    def test_execute(self, mock_hook):
+        mock_instance = mock_hook.return_value
+        operator = FileToGoogleCloudStorageOperator(
+            task_id='gcs_to_file_sensor',
+            dag=self.dag,
+            **self._config
+        )
+        operator.execute(None)
+        mock_instance.upload.assert_called_once_with(
+            bucket=self._config['bucket'],
+            filename=self._config['src'],
+            gzip=self._config['gzip'],
+            mime_type=self._config['mime_type'],
+            object=self._config['dst']
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

From 079b0ee95e4a1d37bdb31c477b531db264242bf7 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 13 Oct 2018 07:25:57 +0100
Subject: [PATCH 125/808] [AIRFLOW-3197] EMRHook is missing new parameters of
 the AWS API (#4044)

Allow passing any params to the CreateJobFlow API, so that we don't have
to stay up to date with AWS api changes.
---
 UPDATING.md                          | 10 +++++++++
 airflow/contrib/hooks/emr_hook.py    | 15 +-------------
 airflow/utils/db.py                  | 10 ++++-----
 tests/contrib/hooks/test_emr_hook.py | 31 +++++++++++++++++++++++-----
 4 files changed, 42 insertions(+), 24 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index f1a76aeda0948..27fbc7444d732 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -73,6 +73,16 @@ then you need to change it like this
     def is_active(self):
       return self.active
 
+### EMRHook now passes all of connection's extra to CreateJobFlow API
+
+EMRHook.create_job_flow has been changed to pass all keys to the create_job_flow API, rather than
+just specific known keys for greater flexibility.
+
+However prior to this release the "emr_default" sample connection that was created had invalid
+configuration, so creating EMR clusters might fail until your connection is updated. (Ec2KeyName,
+Ec2SubnetId, TerminationProtection and KeepJobFlowAliveWhenNoSteps were all top-level keys when they
+should be inside the "Instances" dict)
+
 ## Airflow 1.10
 
 Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
diff --git a/airflow/contrib/hooks/emr_hook.py b/airflow/contrib/hooks/emr_hook.py
index 6cd92c6d85874..f9fd3f04de114 100644
--- a/airflow/contrib/hooks/emr_hook.py
+++ b/airflow/contrib/hooks/emr_hook.py
@@ -51,19 +51,6 @@ def create_job_flow(self, job_flow_overrides):
         config = emr_conn.extra_dejson.copy()
         config.update(job_flow_overrides)
 
-        response = self.get_conn().run_job_flow(
-            Name=config.get('Name'),
-            LogUri=config.get('LogUri'),
-            ReleaseLabel=config.get('ReleaseLabel'),
-            Instances=config.get('Instances'),
-            Steps=config.get('Steps', []),
-            BootstrapActions=config.get('BootstrapActions', []),
-            Applications=config.get('Applications'),
-            Configurations=config.get('Configurations', []),
-            VisibleToAllUsers=config.get('VisibleToAllUsers'),
-            JobFlowRole=config.get('JobFlowRole'),
-            ServiceRole=config.get('ServiceRole'),
-            Tags=config.get('Tags')
-        )
+        response = self.get_conn().run_job_flow(**config)
 
         return response
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 93458c6f61a7b..c09aea4eef602 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -225,6 +225,8 @@ def initdb(rbac=False):
                     "LogUri": "s3://my-emr-log-bucket/default_job_flow_location",
                     "ReleaseLabel": "emr-4.6.0",
                     "Instances": {
+                        "Ec2KeyName": "mykey",
+                        "Ec2SubnetId": "somesubnet",
                         "InstanceGroups": [
                             {
                                 "Name": "Master nodes",
@@ -240,12 +242,10 @@ def initdb(rbac=False):
                                 "InstanceType": "r3.2xlarge",
                                 "InstanceCount": 1
                             }
-                        ]
+                        ],
+                        "TerminationProtected": false,
+                        "KeepJobFlowAliveWhenNoSteps": false
                     },
-                    "Ec2KeyName": "mykey",
-                    "KeepJobFlowAliveWhenNoSteps": false,
-                    "TerminationProtected": false,
-                    "Ec2SubnetId": "somesubnet",
                     "Applications":[
                         { "Name": "Spark" }
                     ],
diff --git a/tests/contrib/hooks/test_emr_hook.py b/tests/contrib/hooks/test_emr_hook.py
index dc981ba093b3c..814b4b317feae 100644
--- a/tests/contrib/hooks/test_emr_hook.py
+++ b/tests/contrib/hooks/test_emr_hook.py
@@ -31,28 +31,49 @@
     mock_emr = None
 
 
+@unittest.skipIf(mock_emr is None, 'moto package not present')
 class TestEmrHook(unittest.TestCase):
     @mock_emr
     def setUp(self):
         configuration.load_test_config()
 
-    @unittest.skipIf(mock_emr is None, 'mock_emr package not present')
     @mock_emr
     def test_get_conn_returns_a_boto3_connection(self):
         hook = EmrHook(aws_conn_id='aws_default')
         self.assertIsNotNone(hook.get_conn().list_clusters())
 
-    @unittest.skipIf(mock_emr is None, 'mock_emr package not present')
     @mock_emr
     def test_create_job_flow_uses_the_emr_config_to_create_a_cluster(self):
         client = boto3.client('emr', region_name='us-east-1')
-        if len(client.list_clusters()['Clusters']):
-            raise ValueError('AWS not properly mocked')
 
         hook = EmrHook(aws_conn_id='aws_default', emr_conn_id='emr_default')
         cluster = hook.create_job_flow({'Name': 'test_cluster'})
 
-        self.assertEqual(client.list_clusters()['Clusters'][0]['Id'], cluster['JobFlowId'])
+        self.assertEqual(client.list_clusters()['Clusters'][0]['Id'],
+                         cluster['JobFlowId'])
+
+    @mock_emr
+    def test_create_job_flow_extra_args(self):
+        """
+        Test that we can add extra arguments to the launch call.
+
+        This is useful for when AWS add new options, such as
+        "SecurityConfiguration" so that we don't have to change our code
+        """
+        client = boto3.client('emr', region_name='us-east-1')
+
+        hook = EmrHook(aws_conn_id='aws_default', emr_conn_id='emr_default')
+        # AmiVersion is really old and almost no one will use it anymore, but
+        # it's one of the "optional" request params that moto supports - it's
+        # coverage of EMR isn't 100% it turns out.
+        cluster = hook.create_job_flow({'Name': 'test_cluster',
+                                        'ReleaseLabel': '',
+                                        'AmiVersion': '3.2'})
+
+        cluster = client.describe_cluster(ClusterId=cluster['JobFlowId'])['Cluster']
+
+        # The AmiVersion comes back as {Requested,Running}AmiVersion fields.
+        self.assertEqual(cluster['RequestedAmiVersion'], '3.2')
 
 if __name__ == '__main__':
     unittest.main()

From 47ab0401d9a7c369151cc1800fee6adfe0efde53 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 17 Oct 2018 19:32:58 +0100
Subject: [PATCH 126/808] [AIRFLOW-XXX] Switch to openjdk8 in Travis tests

This is what we use (via our docker container) on master now, and either
Oracle are having problems with their download servers, or they are
playing silly games and have removed old versions for download.
---
 .travis.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index ebc1893b1b551..defad4f8ebd9c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -20,7 +20,7 @@ sudo: true
 dist: trusty
 language: python
 jdk:
-  - oraclejdk8
+  - openjdk8
 services:
   - cassandra
   - mysql
@@ -92,7 +92,7 @@ before_install:
   - cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
   - ln -s ~/.ssh/authorized_keys ~/.ssh/authorized_keys2
   - chmod 600 ~/.ssh/*
-  - jdk_switcher use oraclejdk8
+  - jdk_switcher use openjdk8
 install:
   - pip install --upgrade pip
   - pip install tox

From f9988147999b73f10978f74d37f704dae8e4f012 Mon Sep 17 00:00:00 2001
From: akosel <aaronjkosel@gmail.com>
Date: Fri, 28 Sep 2018 12:10:00 -0500
Subject: [PATCH 127/808] [AIRFLOW-3124] Fix RBAC webserver debug mode (#3958)

---
 airflow/bin/cli.py    |  8 ++++++--
 tests/cli/test_cli.py | 16 +++++++++++++++-
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 4b2732049756c..74b304e403826 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -777,8 +777,12 @@ def webserver(args):
         print(
             "Starting the web server on port {0} and host {1}.".format(
                 args.port, args.hostname))
-        app = create_app_rbac(conf) if settings.RBAC else create_app(conf)
-        app.run(debug=True, port=args.port, host=args.hostname,
+        if settings.RBAC:
+            app, _ = create_app_rbac(conf, testing=conf.get('core', 'unit_test_mode'))
+        else:
+            app = create_app(conf, testing=conf.get('core', 'unit_test_mode'))
+        app.run(debug=True, use_reloader=False if app.config['TESTING'] else True,
+                port=args.port, host=args.hostname,
                 ssl_context=(ssl_cert, ssl_key) if ssl_cert and ssl_key else None)
     else:
         app = cached_app_rbac(conf) if settings.RBAC else cached_app(conf)
diff --git a/tests/cli/test_cli.py b/tests/cli/test_cli.py
index 34c82bcf9b683..c3eee0c1674ab 100644
--- a/tests/cli/test_cli.py
+++ b/tests/cli/test_cli.py
@@ -134,7 +134,21 @@ def test_ready_prefix_on_cmdline_dead_process(self):
             self.assertEqual(get_num_ready_workers_running(self.gunicorn_master_proc), 0)
 
     def test_cli_webserver_debug(self):
-        p = psutil.Popen(["airflow", "webserver", "-d"])
+        env = os.environ.copy()
+        p = psutil.Popen(["airflow", "webserver", "-d"], env=env)
+        sleep(3)  # wait for webserver to start
+        return_code = p.poll()
+        self.assertEqual(
+            None,
+            return_code,
+            "webserver terminated with return code {} in debug mode".format(return_code))
+        p.terminate()
+        p.wait()
+
+    def test_cli_rbac_webserver_debug(self):
+        env = os.environ.copy()
+        env['AIRFLOW__WEBSERVER__RBAC'] = 'True'
+        p = psutil.Popen(["airflow", "webserver", "-d"], env=env)
         sleep(3)  # wait for webserver to start
         return_code = p.poll()
         self.assertEqual(

From 769c5b3ed20de75489a76d3282f62b748fe8c910 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 9 Sep 2018 15:41:34 +0100
Subject: [PATCH 128/808] [AIRFLOW-3012] Fix Bug when passing emails for SLA

---
 airflow/jobs.py           | 19 +++++++----------
 airflow/utils/email.py    |  7 +++++--
 tests/utils/test_email.py | 44 +++++++++++++++++++++++++++++++++++++++
 3 files changed, 57 insertions(+), 13 deletions(-)
 create mode 100644 tests/utils/test_email.py

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 21d7c498a25b8..d17ab262e6d76 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -58,7 +58,7 @@
                                           SimpleDagBag,
                                           list_py_file_paths)
 from airflow.utils.db import create_session, provide_session
-from airflow.utils.email import send_email
+from airflow.utils.email import send_email, get_email_address_list
 from airflow.utils.log.logging_mixin import LoggingMixin, set_context, StreamLogWriter
 from airflow.utils.net import get_hostname
 from airflow.utils.state import State
@@ -708,16 +708,13 @@ def manage_slas(self, dag, session=None):
             Blocking tasks:
             <pre><code>{blocking_task_list}\n{bug}<code></pre>
             """.format(bug=asciiart.bug, **locals())
-            emails = []
-            for t in dag.tasks:
-                if t.email:
-                    if isinstance(t.email, basestring):
-                        l = [t.email]
-                    elif isinstance(t.email, (list, tuple)):
-                        l = t.email
-                    for email in l:
-                        if email not in emails:
-                            emails.append(email)
+            emails = set()
+            for task in dag.tasks:
+                if task.email:
+                    if isinstance(task.email, basestring):
+                        emails |= set(get_email_address_list(task.email))
+                    elif isinstance(task.email, (list, tuple)):
+                        emails |= set(task.email)
             if emails and len(slas):
                 try:
                     send_email(
diff --git a/airflow/utils/email.py b/airflow/utils/email.py
index b37e3d471a413..195c9c5c11b61 100644
--- a/airflow/utils/email.py
+++ b/airflow/utils/email.py
@@ -48,6 +48,9 @@ def send_email(to, subject, html_content,
     path, attr = configuration.conf.get('email', 'EMAIL_BACKEND').rsplit('.', 1)
     module = importlib.import_module(path)
     backend = getattr(module, attr)
+    to = get_email_address_list(to)
+    to = ", ".join(to)
+
     return backend(to, subject, html_content, files=files,
                    dryrun=dryrun, cc=cc, bcc=bcc,
                    mime_subtype=mime_subtype, mime_charset=mime_charset, **kwargs)
@@ -129,9 +132,9 @@ def send_MIME_email(e_from, e_to, mime_msg, dryrun=False):
 def get_email_address_list(address_string):
     if isinstance(address_string, basestring):
         if ',' in address_string:
-            address_string = address_string.split(',')
+            address_string = [address.strip() for address in address_string.split(',')]
         elif ';' in address_string:
-            address_string = address_string.split(';')
+            address_string = [address.strip() for address in address_string.split(';')]
         else:
             address_string = [address_string]
 
diff --git a/tests/utils/test_email.py b/tests/utils/test_email.py
new file mode 100644
index 0000000000000..1666ef5c627cc
--- /dev/null
+++ b/tests/utils/test_email.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow.utils.email import get_email_address_list
+
+EMAILS = ['test1@example.com', 'test2@example.com']
+
+
+class EmailTest(unittest.TestCase):
+
+    def test_get_email_address_comma_sep_string(self):
+        emails_string = 'test1@example.com, test2@example.com'
+
+        self.assertEquals(
+            get_email_address_list(emails_string), EMAILS)
+
+    def test_get_email_address_colon_sep_string(self):
+        emails_string = 'test1@example.com; test2@example.com'
+
+        self.assertEquals(
+            get_email_address_list(emails_string), EMAILS)
+
+    def test_get_email_address_list(self):
+        emails_list = ['test1@example.com', 'test2@example.com']
+
+        self.assertEquals(
+            get_email_address_list(emails_list), EMAILS)

From db3bcc624667f1d1be25bdbde903b1fcee996ae0 Mon Sep 17 00:00:00 2001
From: kodieg <goluchowski@so1.net>
Date: Sat, 15 Sep 2018 21:45:00 +0200
Subject: [PATCH 129/808] [AIRFLOW-3025] Enable specifying dns and dns_search
 options for DockerOperator (#3860)

Enable specifying dns and dns_search options for DockerOperator
---
 airflow/operators/docker_operator.py | 12 +++++++++++-
 tests/operators/docker_operator.py   |  4 +++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index 69dc1ebef71e6..517199be513cb 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -53,6 +53,10 @@ class DockerOperator(BaseOperator):
         This value gets multiplied with 1024. See
         https://docs.docker.com/engine/reference/run/#cpu-share-constraint
     :type cpus: float
+    :param dns: Docker custom DNS servers
+    :type dns: list of strings
+    :param dns_search: Docker custom DNS search domain
+    :type dns_search: list of strings
     :param docker_url: URL of the host running the docker daemon.
         Default is unix://var/run/docker.sock
     :type docker_url: str
@@ -127,6 +131,8 @@ def __init__(
             xcom_push=False,
             xcom_all=False,
             docker_conn_id=None,
+            dns=None,
+            dns_search=None,
             *args,
             **kwargs):
 
@@ -134,6 +140,8 @@ def __init__(
         self.api_version = api_version
         self.command = command
         self.cpus = cpus
+        self.dns = dns
+        self.dns_search = dns_search
         self.docker_url = docker_url
         self.environment = environment or {}
         self.force_pull = force_pull
@@ -203,7 +211,9 @@ def execute(self, context):
                 host_config=self.cli.create_host_config(
                     binds=self.volumes,
                     network_mode=self.network_mode,
-                    shm_size=self.shm_size),
+                    shm_size=self.shm_size,
+                    dns=self.dns,
+                    dns_search=self.dns_search),
                 image=image,
                 mem_limit=self.mem_limit,
                 user=self.user,
diff --git a/tests/operators/docker_operator.py b/tests/operators/docker_operator.py
index 78a920c30cc13..7e59de9e222c6 100644
--- a/tests/operators/docker_operator.py
+++ b/tests/operators/docker_operator.py
@@ -77,7 +77,9 @@ def test_execute(self, client_class_mock, mkdtemp_mock):
         client_mock.create_host_config.assert_called_with(binds=['/host/path:/container/path',
                                                                  '/mkdtemp:/tmp/airflow'],
                                                           network_mode='bridge',
-                                                          shm_size=1000)
+                                                          shm_size=1000,
+                                                          dns=None,
+                                                          dns_search=None)
         client_mock.images.assert_called_with(name='ubuntu:latest')
         client_mock.logs.assert_called_with(container='some_id', stream=True)
         client_mock.pull.assert_called_with('ubuntu:latest', stream=True)

From 3dfc9562d3df127ca8337edb600ab6a0259521ac Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 21 Oct 2018 01:59:14 +0800
Subject: [PATCH 130/808] [AIRFLOW-3203] Fix DockerOperator & some operator
 test (#4049)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- For argument `image`, no need to explicitly
  add "latest" if tag is omitted.
  "latest" will be used by default if no
  tag provided. This is handled by `docker` package itself.

- Intermediate variable `cpu_shares` is not needed.

- Fix wrong usage of `cpu_shares` and `cpu_shares`.
  Based on
  https://docker-py.readthedocs.io/en/stable/api.html#docker.api.container.ContainerApiMixin.create_host_config,
  They should be an arguments of
  self.cli.create_host_config()
  rather than
  APIClient.create_container().

- Change name of the corresponding test script,
  to ensure it can be discovered.

- Fix the test itself.

- Some other test scripts are not named properly,
  which result in failure of test discovery.
---
 airflow/operators/docker_operator.py          | 24 ++++-----
 tests/operators/__init__.py                   | 13 +----
 ...er_operator.py => test_docker_operator.py} | 11 ++--
 ...hive_operator.py => test_hive_operator.py} | 53 +++++++++----------
 ...erator.py => test_latest_only_operator.py} | 20 ++++---
 ...on_operator.py => test_python_operator.py} | 16 +++---
 ...perator.py => test_s3_to_hive_operator.py} | 10 ++--
 ...ack_operator.py => test_slack_operator.py} |  4 +-
 ...ag_operator.py => test_subdag_operator.py} |  5 +-
 tox.ini                                       |  2 +-
 10 files changed, 69 insertions(+), 89 deletions(-)
 rename tests/operators/{docker_operator.py => test_docker_operator.py} (97%)
 rename tests/operators/{hive_operator.py => test_hive_operator.py} (87%)
 rename tests/operators/{latest_only_operator.py => test_latest_only_operator.py} (94%)
 rename tests/operators/{python_operator.py => test_python_operator.py} (96%)
 rename tests/operators/{s3_to_hive_operator.py => test_s3_to_hive_operator.py} (98%)
 rename tests/operators/{slack_operator.py => test_slack_operator.py} (99%)
 rename tests/operators/{subdag_operator.py => test_subdag_operator.py} (96%)

diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index 517199be513cb..07ad5f5c74d38 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -43,6 +43,7 @@ class DockerOperator(BaseOperator):
     be provided with the parameter ``docker_conn_id``.
 
     :param image: Docker image from which to create the container.
+        If image tag is omitted, "latest" will be used.
     :type image: str
     :param api_version: Remote API version. Set to ``auto`` to automatically
         detect the server's version.
@@ -62,7 +63,7 @@ class DockerOperator(BaseOperator):
     :type docker_url: str
     :param environment: Environment variables to set in the container. (templated)
     :type environment: dict
-    :param force_pull: Pull the docker image on every run. Default is false.
+    :param force_pull: Pull the docker image on every run. Default is False.
     :type force_pull: bool
     :param mem_limit: Maximum amount of memory the container can use.
         Either a float value, which represents the limit in bytes,
@@ -187,35 +188,28 @@ def execute(self, context):
                 tls=tls_config
             )
 
-        if ':' not in self.image:
-            image = self.image + ':latest'
-        else:
-            image = self.image
-
-        if self.force_pull or len(self.cli.images(name=image)) == 0:
-            self.log.info('Pulling docker image %s', image)
-            for l in self.cli.pull(image, stream=True):
+        if self.force_pull or len(self.cli.images(name=self.image)) == 0:
+            self.log.info('Pulling docker image %s', self.image)
+            for l in self.cli.pull(self.image, stream=True):
                 output = json.loads(l.decode('utf-8'))
                 self.log.info("%s", output['status'])
 
-        cpu_shares = int(round(self.cpus * 1024))
-
         with TemporaryDirectory(prefix='airflowtmp') as host_tmp_dir:
             self.environment['AIRFLOW_TMP_DIR'] = self.tmp_dir
             self.volumes.append('{0}:{1}'.format(host_tmp_dir, self.tmp_dir))
 
             self.container = self.cli.create_container(
                 command=self.get_command(),
-                cpu_shares=cpu_shares,
                 environment=self.environment,
                 host_config=self.cli.create_host_config(
                     binds=self.volumes,
                     network_mode=self.network_mode,
                     shm_size=self.shm_size,
                     dns=self.dns,
-                    dns_search=self.dns_search),
-                image=image,
-                mem_limit=self.mem_limit,
+                    dns_search=self.dns_search,
+                    cpu_shares=int(round(self.cpus * 1024)),
+                    mem_limit=self.mem_limit),
+                image=self.image,
                 user=self.user,
                 working_dir=self.working_dir
             )
diff --git a/tests/operators/__init__.py b/tests/operators/__init__.py
index b94e5a9b6ac4a..114d189da14ab 100644
--- a/tests/operators/__init__.py
+++ b/tests/operators/__init__.py
@@ -7,21 +7,12 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
-from .docker_operator import *
-from .subdag_operator import *
-from .operators import *
-from .hive_operator import *
-from .s3_to_hive_operator import *
-from .python_operator import *
-from .latest_only_operator import *
-
diff --git a/tests/operators/docker_operator.py b/tests/operators/test_docker_operator.py
similarity index 97%
rename from tests/operators/docker_operator.py
rename to tests/operators/test_docker_operator.py
index 7e59de9e222c6..d57a7cd132a16 100644
--- a/tests/operators/docker_operator.py
+++ b/tests/operators/test_docker_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -64,20 +64,22 @@ def test_execute(self, client_class_mock, mkdtemp_mock):
         client_class_mock.assert_called_with(base_url='unix://var/run/docker.sock', tls=None,
                                              version='1.19')
 
-        client_mock.create_container.assert_called_with(command='env', cpu_shares=1024,
+        client_mock.create_container.assert_called_with(command='env',
                                                         environment={
                                                             'AIRFLOW_TMP_DIR': '/tmp/airflow',
                                                             'UNIT': 'TEST'
                                                         },
                                                         host_config=host_config,
                                                         image='ubuntu:latest',
-                                                        mem_limit=None, user=None,
+                                                        user=None,
                                                         working_dir='/container/path'
                                                         )
         client_mock.create_host_config.assert_called_with(binds=['/host/path:/container/path',
                                                                  '/mkdtemp:/tmp/airflow'],
                                                           network_mode='bridge',
                                                           shm_size=1000,
+                                                          cpu_shares=1024,
+                                                          mem_limit=None,
                                                           dns=None,
                                                           dns_search=None)
         client_mock.images.assert_called_with(name='ubuntu:latest')
@@ -236,5 +238,6 @@ def test_execute_with_docker_conn_id_use_hook(self, operator_client_mock,
             'Image was not pulled using operator client'
         )
 
+
 if __name__ == "__main__":
     unittest.main()
diff --git a/tests/operators/hive_operator.py b/tests/operators/test_hive_operator.py
similarity index 87%
rename from tests/operators/hive_operator.py
rename to tests/operators/test_hive_operator.py
index 1569e7f7e9538..9f13ab43942f8 100644
--- a/tests/operators/hive_operator.py
+++ b/tests/operators/test_hive_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -22,11 +22,10 @@
 import datetime
 import os
 import unittest
-import mock
 import nose
-import six
 
-from airflow import DAG, configuration, operators
+from airflow import DAG, configuration
+import airflow.operators.hive_operator
 configuration.load_test_config()
 
 
@@ -61,7 +60,7 @@ def setUp(self):
 class HiveOperatorConfigTest(HiveEnvironmentTest):
 
     def test_hive_airflow_default_config_queue(self):
-        t = operators.hive_operator.HiveOperator(
+        t = airflow.operators.hive_operator.HiveOperator(
             task_id='test_default_config_queue',
             hql=self.hql,
             mapred_queue_priority='HIGH',
@@ -77,7 +76,7 @@ def test_hive_airflow_default_config_queue(self):
 
     def test_hive_airflow_default_config_queue_override(self):
         specific_mapred_queue = 'default'
-        t = operators.hive_operator.HiveOperator(
+        t = airflow.operators.hive_operator.HiveOperator(
             task_id='test_default_config_queue',
             hql=self.hql,
             mapred_queue=specific_mapred_queue,
@@ -92,7 +91,7 @@ class HiveOperatorTest(HiveEnvironmentTest):
 
     def test_hiveconf_jinja_translate(self):
         hql = "SELECT ${num_col} FROM ${hiveconf:table};"
-        t = operators.hive_operator.HiveOperator(
+        t = airflow.operators.hive_operator.HiveOperator(
             hiveconf_jinja_translate=True,
             task_id='dry_run_basic_hql', hql=hql, dag=self.dag)
         t.prepare_template()
@@ -100,7 +99,7 @@ def test_hiveconf_jinja_translate(self):
 
     def test_hiveconf(self):
         hql = "SELECT * FROM ${hiveconf:table} PARTITION (${hiveconf:day});"
-        t = operators.hive_operator.HiveOperator(
+        t = airflow.operators.hive_operator.HiveOperator(
             hiveconfs={'table': 'static_babynames', 'day': '{{ ds }}'},
             task_id='dry_run_basic_hql', hql=hql, dag=self.dag)
         t.prepare_template()
@@ -117,13 +116,13 @@ def test_hiveconf(self):
     class HivePrestoTest(HiveEnvironmentTest):
 
         def test_hive(self):
-            t = operators.hive_operator.HiveOperator(
+            t = airflow.operators.hive_operator.HiveOperator(
                 task_id='basic_hql', hql=self.hql, dag=self.dag)
             t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE,
                   ignore_ti_state=True)
 
         def test_hive_queues(self):
-            t = operators.hive_operator.HiveOperator(
+            t = airflow.operators.hive_operator.HiveOperator(
                 task_id='test_hive_queues', hql=self.hql,
                 mapred_queue='default', mapred_queue_priority='HIGH',
                 mapred_job_name='airflow.test_hive_queues',
@@ -132,12 +131,12 @@ def test_hive_queues(self):
                   ignore_ti_state=True)
 
         def test_hive_dryrun(self):
-            t = operators.hive_operator.HiveOperator(
+            t = airflow.operators.hive_operator.HiveOperator(
                 task_id='dry_run_basic_hql', hql=self.hql, dag=self.dag)
             t.dry_run()
 
         def test_beeline(self):
-            t = operators.hive_operator.HiveOperator(
+            t = airflow.operators.hive_operator.HiveOperator(
                 task_id='beeline_hql', hive_cli_conn_id='beeline_default',
                 hql=self.hql, dag=self.dag)
             t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE,
@@ -147,13 +146,13 @@ def test_presto(self):
             sql = """
             SELECT count(1) FROM airflow.static_babynames_partitioned;
             """
-            t = operators.presto_check_operator.PrestoCheckOperator(
+            t = airflow.operators.presto_check_operator.PrestoCheckOperator(
                 task_id='presto_check', sql=sql, dag=self.dag)
             t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE,
                   ignore_ti_state=True)
 
         def test_presto_to_mysql(self):
-            t = operators.presto_to_mysql.PrestoToMySqlTransfer(
+            t = airflow.operators.presto_to_mysql.PrestoToMySqlTransfer(
                 task_id='presto_to_mysql_check',
                 sql="""
                 SELECT name, count(*) as ccount
@@ -167,7 +166,7 @@ def test_presto_to_mysql(self):
                   ignore_ti_state=True)
 
         def test_hdfs_sensor(self):
-            t = operators.sensors.HdfsSensor(
+            t = airflow.operators.sensors.HdfsSensor(
                 task_id='hdfs_sensor_check',
                 filepath='hdfs://user/hive/warehouse/airflow.db/static_babynames',
                 dag=self.dag)
@@ -175,7 +174,7 @@ def test_hdfs_sensor(self):
                   ignore_ti_state=True)
 
         def test_webhdfs_sensor(self):
-            t = operators.sensors.WebHdfsSensor(
+            t = airflow.operators.sensors.WebHdfsSensor(
                 task_id='webhdfs_sensor_check',
                 filepath='hdfs://user/hive/warehouse/airflow.db/static_babynames',
                 timeout=120,
@@ -184,7 +183,7 @@ def test_webhdfs_sensor(self):
                   ignore_ti_state=True)
 
         def test_sql_sensor(self):
-            t = operators.sensors.SqlSensor(
+            t = airflow.operators.sensors.SqlSensor(
                 task_id='hdfs_sensor_check',
                 conn_id='presto_default',
                 sql="SELECT 'x' FROM airflow.static_babynames LIMIT 1;",
@@ -193,7 +192,7 @@ def test_sql_sensor(self):
                   ignore_ti_state=True)
 
         def test_hive_stats(self):
-            t = operators.hive_stats_operator.HiveStatsCollectionOperator(
+            t = airflow.operators.hive_stats_operator.HiveStatsCollectionOperator(
                 task_id='hive_stats_check',
                 table="airflow.static_babynames_partitioned",
                 partition={'ds': DEFAULT_DATE_DS},
@@ -202,7 +201,7 @@ def test_hive_stats(self):
                   ignore_ti_state=True)
 
         def test_named_hive_partition_sensor(self):
-            t = operators.sensors.NamedHivePartitionSensor(
+            t = airflow.operators.sensors.NamedHivePartitionSensor(
                 task_id='hive_partition_check',
                 partition_names=[
                     "airflow.static_babynames_partitioned/ds={{ds}}"
@@ -212,7 +211,7 @@ def test_named_hive_partition_sensor(self):
                   ignore_ti_state=True)
 
         def test_named_hive_partition_sensor_succeeds_on_multiple_partitions(self):
-            t = operators.sensors.NamedHivePartitionSensor(
+            t = airflow.operators.sensors.NamedHivePartitionSensor(
                 task_id='hive_partition_check',
                 partition_names=[
                     "airflow.static_babynames_partitioned/ds={{ds}}",
@@ -223,7 +222,7 @@ def test_named_hive_partition_sensor_succeeds_on_multiple_partitions(self):
                   ignore_ti_state=True)
 
         def test_named_hive_partition_sensor_parses_partitions_with_periods(self):
-            t = operators.sensors.NamedHivePartitionSensor.parse_partition_name(
+            t = airflow.operators.sensors.NamedHivePartitionSensor.parse_partition_name(
                 partition="schema.table/part1=this.can.be.an.issue/part2=ok")
             self.assertEqual(t[0], "schema")
             self.assertEqual(t[1], "table")
@@ -231,7 +230,7 @@ def test_named_hive_partition_sensor_parses_partitions_with_periods(self):
 
         @nose.tools.raises(airflow.exceptions.AirflowSensorTimeout)
         def test_named_hive_partition_sensor_times_out_on_nonexistent_partition(self):
-            t = operators.sensors.NamedHivePartitionSensor(
+            t = airflow.operators.sensors.NamedHivePartitionSensor(
                 task_id='hive_partition_check',
                 partition_names=[
                     "airflow.static_babynames_partitioned/ds={{ds}}",
@@ -244,7 +243,7 @@ def test_named_hive_partition_sensor_times_out_on_nonexistent_partition(self):
                   ignore_ti_state=True)
 
         def test_hive_partition_sensor(self):
-            t = operators.sensors.HivePartitionSensor(
+            t = airflow.operators.sensors.HivePartitionSensor(
                 task_id='hive_partition_check',
                 table='airflow.static_babynames_partitioned',
                 dag=self.dag)
@@ -252,7 +251,7 @@ def test_hive_partition_sensor(self):
                   ignore_ti_state=True)
 
         def test_hive_metastore_sql_sensor(self):
-            t = operators.sensors.MetastorePartitionSensor(
+            t = airflow.operators.sensors.MetastorePartitionSensor(
                 task_id='hive_partition_check',
                 table='airflow.static_babynames_partitioned',
                 partition_name='ds={}'.format(DEFAULT_DATE_DS),
@@ -261,7 +260,7 @@ def test_hive_metastore_sql_sensor(self):
                   ignore_ti_state=True)
 
         def test_hive2samba(self):
-            t = operators.hive_to_samba_operator.Hive2SambaOperator(
+            t = airflow.operators.hive_to_samba_operator.Hive2SambaOperator(
                 task_id='hive2samba_check',
                 samba_conn_id='tableau_samba',
                 hql="SELECT * FROM airflow.static_babynames LIMIT 10000",
@@ -271,7 +270,7 @@ def test_hive2samba(self):
                   ignore_ti_state=True)
 
         def test_hive_to_mysql(self):
-            t = operators.hive_to_mysql.HiveToMySqlTransfer(
+            t = airflow.operators.hive_to_mysql.HiveToMySqlTransfer(
                 mysql_conn_id='airflow_db',
                 task_id='hive_to_mysql_check',
                 create=True,
diff --git a/tests/operators/latest_only_operator.py b/tests/operators/test_latest_only_operator.py
similarity index 94%
rename from tests/operators/latest_only_operator.py
rename to tests/operators/test_latest_only_operator.py
index 3c21831f05789..1ed040765d041 100644
--- a/tests/operators/latest_only_operator.py
+++ b/tests/operators/test_latest_only_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -20,11 +20,9 @@
 from __future__ import print_function, unicode_literals
 
 import datetime
-import logging
 import unittest
 
 from airflow import configuration, DAG, settings
-from airflow.jobs import BackfillJob
 from airflow.models import TaskInstance
 from airflow.operators.latest_only_operator import LatestOnlyOperator
 from airflow.operators.dummy_operator import DummyOperator
@@ -102,7 +100,7 @@ def test_skipping(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'skipped',
             timezone.datetime(2016, 1, 1, 12): 'skipped',
-            timezone.datetime(2016, 1, 2): 'success',},
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_downstream_state)
 
         downstream_instances = get_task_instances('downstream_2')
@@ -111,7 +109,7 @@ def test_skipping(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'skipped',
             timezone.datetime(2016, 1, 1, 12): 'skipped',
-            timezone.datetime(2016, 1, 2): 'success',},
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_downstream_state)
 
     def test_skipping_dagrun(self):
@@ -128,21 +126,21 @@ def test_skipping_dagrun(self):
         downstream_task.set_upstream(latest_task)
         downstream_task2.set_upstream(downstream_task)
 
-        dr1 = self.dag.create_dagrun(
+        self.dag.create_dagrun(
             run_id="manual__1",
             start_date=timezone.utcnow(),
             execution_date=DEFAULT_DATE,
             state=State.RUNNING
         )
 
-        dr2 = self.dag.create_dagrun(
+        self.dag.create_dagrun(
             run_id="manual__2",
             start_date=timezone.utcnow(),
             execution_date=timezone.datetime(2016, 1, 1, 12),
             state=State.RUNNING
         )
 
-        dr2 = self.dag.create_dagrun(
+        self.dag.create_dagrun(
             run_id="manual__3",
             start_date=timezone.utcnow(),
             execution_date=END_DATE,
@@ -168,7 +166,7 @@ def test_skipping_dagrun(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'skipped',
             timezone.datetime(2016, 1, 1, 12): 'skipped',
-            timezone.datetime(2016, 1, 2): 'success',},
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_downstream_state)
 
         downstream_instances = get_task_instances('downstream_2')
@@ -177,5 +175,5 @@ def test_skipping_dagrun(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'skipped',
             timezone.datetime(2016, 1, 1, 12): 'skipped',
-            timezone.datetime(2016, 1, 2): 'success',},
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_downstream_state)
diff --git a/tests/operators/python_operator.py b/tests/operators/test_python_operator.py
similarity index 96%
rename from tests/operators/python_operator.py
rename to tests/operators/test_python_operator.py
index e44cfa42027b3..713ddfc3caadd 100644
--- a/tests/operators/python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -157,10 +157,8 @@ def test_without_dag_run(self):
         """This checks the defensive against non existent tasks in a dag run"""
         value = False
         dag = DAG('shortcircuit_operator_test_without_dag_run',
-                  default_args={
-                       'owner': 'airflow',
-                       'start_date': DEFAULT_DATE
-                  },
+                  default_args={'owner': 'airflow',
+                                'start_date': DEFAULT_DATE},
                   schedule_interval=INTERVAL)
         short_op = ShortCircuitOperator(task_id='make_choice',
                                         dag=dag,
@@ -212,10 +210,8 @@ def test_without_dag_run(self):
     def test_with_dag_run(self):
         value = False
         dag = DAG('shortcircuit_operator_test_with_dag_run',
-                  default_args={
-                       'owner': 'airflow',
-                       'start_date': DEFAULT_DATE
-                  },
+                  default_args={'owner': 'airflow',
+                                'start_date': DEFAULT_DATE},
                   schedule_interval=INTERVAL)
         short_op = ShortCircuitOperator(task_id='make_choice',
                                         dag=dag,
diff --git a/tests/operators/s3_to_hive_operator.py b/tests/operators/test_s3_to_hive_operator.py
similarity index 98%
rename from tests/operators/s3_to_hive_operator.py
rename to tests/operators/test_s3_to_hive_operator.py
index 6ca6274a2c173..2f8628c621abe 100644
--- a/tests/operators/s3_to_hive_operator.py
+++ b/tests/operators/test_s3_to_hive_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -155,9 +155,9 @@ def _check_file_equality(self, fn_1, fn_2, ext):
         # Hence decompress to test for equality
         if(ext.lower() == '.gz'):
             with gzip.GzipFile(fn_1, 'rb') as f_1,\
-                 NamedTemporaryFile(mode='wb') as f_txt_1,\
-                 gzip.GzipFile(fn_2, 'rb') as f_2,\
-                 NamedTemporaryFile(mode='wb') as f_txt_2:
+                    NamedTemporaryFile(mode='wb') as f_txt_1,\
+                    gzip.GzipFile(fn_2, 'rb') as f_2,\
+                    NamedTemporaryFile(mode='wb') as f_txt_2:
                 shutil.copyfileobj(f_1, f_txt_1)
                 shutil.copyfileobj(f_2, f_txt_2)
                 f_txt_1.flush()
diff --git a/tests/operators/slack_operator.py b/tests/operators/test_slack_operator.py
similarity index 99%
rename from tests/operators/slack_operator.py
rename to tests/operators/test_slack_operator.py
index ad916429772a0..d29f7c8236ff3 100644
--- a/tests/operators/slack_operator.py
+++ b/tests/operators/test_slack_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/subdag_operator.py b/tests/operators/test_subdag_operator.py
similarity index 96%
rename from tests/operators/subdag_operator.py
rename to tests/operators/test_subdag_operator.py
index af47c5cfd56f5..bba6f17194de2 100644
--- a/tests/operators/subdag_operator.py
+++ b/tests/operators/test_subdag_operator.py
@@ -85,7 +85,7 @@ def test_subdag_pools(self):
         session.add(pool_10)
         session.commit()
 
-        dummy_1 = DummyOperator(task_id='dummy', dag=subdag, pool='test_pool_1')
+        DummyOperator(task_id='dummy', dag=subdag, pool='test_pool_1')
 
         self.assertRaises(
             AirflowException,
@@ -116,8 +116,7 @@ def test_subdag_pools_no_possible_conflict(self):
         session.add(pool_10)
         session.commit()
 
-        dummy_1 = DummyOperator(
-            task_id='dummy', dag=subdag, pool='test_pool_10')
+        DummyOperator(task_id='dummy', dag=subdag, pool='test_pool_10')
 
         mock_session = Mock()
         SubDagOperator(
diff --git a/tox.ini b/tox.ini
index a20d2c5546040..4f558be2d9bf9 100644
--- a/tox.ini
+++ b/tox.ini
@@ -27,7 +27,7 @@ find_links =
     {homedir}/.pip-cache
 
 [flake8]
-max-line-length = 90
+max-line-length = 110
 ignore = E731,W503
 
 [testenv]

From 1eeb0a4a24fa8541763a67f84ec9f4b034f66475 Mon Sep 17 00:00:00 2001
From: Jason Shao <38264421+jason-udacity@users.noreply.github.com>
Date: Sun, 21 Oct 2018 13:52:13 -0700
Subject: [PATCH 131/808] [AIRFLOW-3238] Fix models.DAG to deactivate unknown
 DAGs on initdb (#4073)

Unknown dags are now deactivated on initdb
---
 airflow/models.py |  1 +
 tests/models.py   | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/airflow/models.py b/airflow/models.py
index ad9365c782ceb..9ec7a472aa840 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4268,6 +4268,7 @@ def deactivate_unknown_dags(active_dag_ids, session=None):
                 DagModel).filter(~DagModel.dag_id.in_(active_dag_ids)).all():
             dag.is_active = False
             session.merge(dag)
+        session.commit()
 
     @staticmethod
     @provide_session
diff --git a/tests/models.py b/tests/models.py
index abb726f7a9e6a..1e6787927b339 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1586,6 +1586,31 @@ def test_kill_zombies(self, mock_ti):
                                    configuration.getboolean('core', 'unit_test_mode'),
                                    ANY)
 
+    def test_deactivate_unknown_dags(self):
+        """
+        Test that dag_ids not passed into deactivate_unknown_dags
+        are deactivated when function is invoked
+        """
+        dagbag = models.DagBag(include_examples=True)
+        expected_active_dags = dagbag.dags.keys()
+
+        session = settings.Session
+        session.add(DagModel(dag_id='test_deactivate_unknown_dags', is_active=True))
+        session.commit()
+
+        models.DAG.deactivate_unknown_dags(expected_active_dags)
+
+        for dag in session.query(DagModel).all():
+            if dag.dag_id in expected_active_dags:
+                self.assertTrue(dag.is_active)
+            else:
+                self.assertEquals(dag.dag_id, 'test_deactivate_unknown_dags')
+                self.assertFalse(dag.is_active)
+
+        # clean up
+        session.query(DagModel).filter(DagModel.dag_id == 'test_deactivate_unknown_dags').delete()
+        session.commit()
+
 
 class TaskInstanceTest(unittest.TestCase):
 

From 33488451b76b2a28e06fa98ec0c730f1e2c0109b Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 22 Oct 2018 19:06:18 +0100
Subject: [PATCH 132/808] [AIRFLOW-XXX] Fix up license headers

---
 .rat-excludes                               |  3 +++
 tests/contrib/operators/test_file_to_gcs.py | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/.rat-excludes b/.rat-excludes
index e5373aacd5fbc..c9487dd8c49c1 100644
--- a/.rat-excludes
+++ b/.rat-excludes
@@ -37,3 +37,6 @@ bootstrap-toggle.min.js
 bootstrap-toggle.min.css
 d3.v3.min.js
 ace.js
+airflow/www/static/coverage/*
+airflow/git_version
+scripts/ci/flake8_diff.sh
diff --git a/tests/contrib/operators/test_file_to_gcs.py b/tests/contrib/operators/test_file_to_gcs.py
index 590267a319e96..7e20579ecda92 100644
--- a/tests/contrib/operators/test_file_to_gcs.py
+++ b/tests/contrib/operators/test_file_to_gcs.py
@@ -1,3 +1,23 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
 import datetime
 import unittest
 

From 2023e4f6034e5c99386d86367dba587466788f2e Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 23 Oct 2018 10:24:18 +0100
Subject: [PATCH 133/808] [AIRFLOW-520] Fix Version Info in Flask UI (#4072)

---
 airflow/www/views.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 540980baa602c..3112c081acc47 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2845,7 +2845,7 @@ class VersionView(wwwutils.SuperUserMixin, BaseView):
     def version(self):
         # Look at the version from setup.py
         try:
-            airflow_version = pkg_resources.require("apache-airflow")[0].version
+            airflow_version = airflow.__version__
         except Exception as e:
             airflow_version = None
             logging.error(e)

From 836fac314068e48378b85328d565dc3aa8b81d97 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Thu, 25 Oct 2018 15:42:50 +0200
Subject: [PATCH 134/808] [AIRFLOW-3257] Pin flake8 version to avoid checks
 changing over time (#4092)

Flake8 3.6.0 was just released and it introduced some new checks that
didn't exist before. As a result all of our CI pipelines are now failing.

To avoid this happening in future we should pin the version of flake8
to 3.5.0 (currently this is in tox.ini, and setup.py)
---
 scripts/ci/requirements.txt | 2 +-
 tox.ini                     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/scripts/ci/requirements.txt b/scripts/ci/requirements.txt
index 837c43f2f711e..bf3a89b36f4be 100644
--- a/scripts/ci/requirements.txt
+++ b/scripts/ci/requirements.txt
@@ -31,7 +31,7 @@ dill
 distributed
 docker-py
 filechunkio
-flake8
+flake8==3.5.0
 flask
 flask-admin
 flask-bcrypt
diff --git a/tox.ini b/tox.ini
index 4f558be2d9bf9..eba94a89e577d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -81,7 +81,7 @@ commands =
 basepython = python3
 
 deps =
-    flake8
+    flake8==3.5.0
 
 commands =
     {toxinidir}/scripts/ci/flake8_diff.sh

From c0650c2b3d58a0bd83de8dd61b7b5c0a335a93f9 Mon Sep 17 00:00:00 2001
From: Alfredo Luque <me@aluque.io>
Date: Fri, 26 Oct 2018 01:41:44 -0700
Subject: [PATCH 135/808] [AIRFLOW-839] Fix status logging for docker operator
 (#4095)

---
 airflow/operators/docker_operator.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index 07ad5f5c74d38..727507b270c42 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -192,7 +192,8 @@ def execute(self, context):
             self.log.info('Pulling docker image %s', self.image)
             for l in self.cli.pull(self.image, stream=True):
                 output = json.loads(l.decode('utf-8'))
-                self.log.info("%s", output['status'])
+                if 'status' in output:
+                    self.log.info("%s", output['status'])
 
         with TemporaryDirectory(prefix='airflowtmp') as host_tmp_dir:
             self.environment['AIRFLOW_TMP_DIR'] = self.tmp_dir

From 8aa9e2ee0c9a75279e5979bc9f4e8d50fb57962e Mon Sep 17 00:00:00 2001
From: Tim Swast <swast@google.com>
Date: Fri, 29 Jun 2018 14:15:16 +0200
Subject: [PATCH 136/808] [AIRFLOW-2682] Add how-to guides for bash and python
 operators

Closes #3552 from tswast/airflow-2682-bash-python-
how-to
---
 airflow/example_dags/example_bash_operator.py   |  4 ++++
 airflow/example_dags/example_python_operator.py | 16 +++++++++++-----
 docs/code.rst                                   |  2 ++
 docs/concepts.rst                               |  4 ++++
 docs/howto/index.rst                            |  1 +
 5 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/airflow/example_dags/example_bash_operator.py b/airflow/example_dags/example_bash_operator.py
index b2d9d14610dfc..a5ff651d6a5f4 100644
--- a/airflow/example_dags/example_bash_operator.py
+++ b/airflow/example_dags/example_bash_operator.py
@@ -38,8 +38,10 @@
 cmd = 'ls -l'
 run_this_last = DummyOperator(task_id='run_this_last', dag=dag)
 
+# [START howto_operator_bash]
 run_this = BashOperator(
     task_id='run_after_loop', bash_command='echo 1', dag=dag)
+# [END howto_operator_bash]
 run_this.set_downstream(run_this_last)
 
 for i in range(3):
@@ -50,10 +52,12 @@
         dag=dag)
     task.set_downstream(run_this)
 
+# [START howto_operator_bash_template]
 task = BashOperator(
     task_id='also_run_this',
     bash_command='echo "run_id={{ run_id }} | dag_run={{ dag_run }}"',
     dag=dag)
+# [END howto_operator_bash_template]
 task.set_downstream(run_this_last)
 
 if __name__ == "__main__":
diff --git a/airflow/example_dags/example_python_operator.py b/airflow/example_dags/example_python_operator.py
index 0ecf099e7b01c..6c4874fc872a4 100644
--- a/airflow/example_dags/example_python_operator.py
+++ b/airflow/example_dags/example_python_operator.py
@@ -26,6 +26,7 @@
 import time
 from pprint import pprint
 
+
 args = {
     'owner': 'airflow',
     'start_date': airflow.utils.dates.days_ago(2)
@@ -36,11 +37,7 @@
     schedule_interval=None)
 
 
-def my_sleeping_function(random_base):
-    """This is a function that will run within the DAG execution"""
-    time.sleep(random_base)
-
-
+# [START howto_operator_python]
 def print_context(ds, **kwargs):
     pprint(kwargs)
     print(ds)
@@ -52,6 +49,14 @@ def print_context(ds, **kwargs):
     provide_context=True,
     python_callable=print_context,
     dag=dag)
+# [END howto_operator_python]
+
+
+# [START howto_operator_python_kwargs]
+def my_sleeping_function(random_base):
+    """This is a function that will run within the DAG execution"""
+    time.sleep(random_base)
+
 
 # Generate 10 sleeping tasks, sleeping from 0 to 4 seconds respectively
 for i in range(5):
@@ -62,3 +67,4 @@ def print_context(ds, **kwargs):
         dag=dag)
 
     task.set_upstream(run_this)
+# [END howto_operator_python_kwargs]
diff --git a/docs/code.rst b/docs/code.rst
index 521b55f9d41ce..f4a91e00ba24e 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -1,6 +1,8 @@
 API Reference
 =============
 
+.. _api-reference-operators:
+
 Operators
 ---------
 Operators allow for generation of certain types of tasks that become nodes in
diff --git a/docs/concepts.rst b/docs/concepts.rst
index f8f5d742f5fcf..d28921134f3d6 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -90,6 +90,8 @@ DAGs can be used as context managers to automatically assign new operators to th
 
     op.dag is dag # True
 
+.. _concepts-operators:
+
 Operators
 =========
 
@@ -128,6 +130,8 @@ the platform.
 
 Operators are only loaded by Airflow if they are assigned to a DAG.
 
+See :doc:`howto/operator` for how to use Airflow operators.
+
 DAG Assignment
 --------------
 
diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index 1342ed85eb757..f9f160e6bdbea 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -12,6 +12,7 @@ configuring an Airflow environment.
 
     set-config
     initialize-database
+    operator
     manage-connections
     secure-connections
     write-logs

From fdfb359e4b95dfadfa3973d43025f61f4aa3b96a Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Fri, 26 Oct 2018 10:19:52 +0200
Subject: [PATCH 137/808] [AIRFLOW-3237] Refactor example DAGs (#4071)

---
 airflow/example_dags/example_bash_operator.py | 45 +++++++++++--------
 .../example_dags/example_branch_operator.py   | 42 ++++++++++-------
 .../example_branch_python_dop_operator_3.py   | 29 ++++++------
 airflow/example_dags/example_http_operator.py | 24 +++++-----
 airflow/example_dags/example_latest_only.py   |  4 +-
 .../example_latest_only_with_trigger.py       | 11 ++---
 ...example_passing_params_via_test_command.py | 27 ++++++-----
 .../example_dags/example_python_operator.py   | 24 +++++-----
 .../example_short_circuit_operator.py         | 20 +++++----
 airflow/example_dags/example_skip_dag.py      | 23 ++++------
 .../example_dags/example_subdag_operator.py   | 10 +----
 .../example_trigger_controller_dag.py         | 32 +++++++------
 .../example_trigger_target_dag.py             | 17 ++++---
 airflow/example_dags/example_xcom.py          | 29 +++++++-----
 airflow/example_dags/test_utils.py            | 10 ++---
 airflow/example_dags/tutorial.py              | 23 +++++-----
 docs/tutorial.rst                             | 31 +++++++++----
 17 files changed, 221 insertions(+), 180 deletions(-)

diff --git a/airflow/example_dags/example_bash_operator.py b/airflow/example_dags/example_bash_operator.py
index a5ff651d6a5f4..68accc6317bbf 100644
--- a/airflow/example_dags/example_bash_operator.py
+++ b/airflow/example_dags/example_bash_operator.py
@@ -17,48 +17,57 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import airflow
 from builtins import range
-from airflow.operators.bash_operator import BashOperator
-from airflow.operators.dummy_operator import DummyOperator
-from airflow.models import DAG
 from datetime import timedelta
 
+import airflow
+from airflow.models import DAG
+from airflow.operators.bash_operator import BashOperator
+from airflow.operators.dummy_operator import DummyOperator
 
 args = {
     'owner': 'airflow',
-    'start_date': airflow.utils.dates.days_ago(2)
+    'start_date': airflow.utils.dates.days_ago(2),
 }
 
 dag = DAG(
-    dag_id='example_bash_operator', default_args=args,
+    dag_id='example_bash_operator',
+    default_args=args,
     schedule_interval='0 0 * * *',
-    dagrun_timeout=timedelta(minutes=60))
+    dagrun_timeout=timedelta(minutes=60),
+)
 
-cmd = 'ls -l'
-run_this_last = DummyOperator(task_id='run_this_last', dag=dag)
+run_this_last = DummyOperator(
+    task_id='run_this_last',
+    dag=dag,
+)
 
 # [START howto_operator_bash]
 run_this = BashOperator(
-    task_id='run_after_loop', bash_command='echo 1', dag=dag)
+    task_id='run_after_loop',
+    bash_command='echo 1',
+    dag=dag,
+)
 # [END howto_operator_bash]
-run_this.set_downstream(run_this_last)
+
+run_this >> run_this_last
 
 for i in range(3):
-    i = str(i)
     task = BashOperator(
-        task_id='runme_' + i,
+        task_id='runme_' + str(i),
         bash_command='echo "{{ task_instance_key_str }}" && sleep 1',
-        dag=dag)
-    task.set_downstream(run_this)
+        dag=dag,
+    )
+    task >> run_this
 
 # [START howto_operator_bash_template]
-task = BashOperator(
+also_run_this = BashOperator(
     task_id='also_run_this',
     bash_command='echo "run_id={{ run_id }} | dag_run={{ dag_run }}"',
-    dag=dag)
+    dag=dag,
+)
 # [END howto_operator_bash_template]
-task.set_downstream(run_this_last)
+also_run_this >> run_this_last
 
 if __name__ == "__main__":
     dag.cli()
diff --git a/airflow/example_dags/example_branch_operator.py b/airflow/example_dags/example_branch_operator.py
index 45bf11f30139c..197d7d7a73bad 100644
--- a/airflow/example_dags/example_branch_operator.py
+++ b/airflow/example_dags/example_branch_operator.py
@@ -17,43 +17,53 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import airflow
-from airflow.operators.python_operator import BranchPythonOperator
-from airflow.operators.dummy_operator import DummyOperator
-from airflow.models import DAG
 import random
 
+import airflow
+from airflow.models import DAG
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.operators.python_operator import BranchPythonOperator
 
 args = {
     'owner': 'airflow',
-    'start_date': airflow.utils.dates.days_ago(2)
+    'start_date': airflow.utils.dates.days_ago(2),
 }
 
 dag = DAG(
     dag_id='example_branch_operator',
     default_args=args,
-    schedule_interval="@daily")
+    schedule_interval="@daily",
+)
 
-cmd = 'ls -l'
-run_this_first = DummyOperator(task_id='run_this_first', dag=dag)
+run_this_first = DummyOperator(
+    task_id='run_this_first',
+    dag=dag,
+)
 
 options = ['branch_a', 'branch_b', 'branch_c', 'branch_d']
 
 branching = BranchPythonOperator(
     task_id='branching',
     python_callable=lambda: random.choice(options),
-    dag=dag)
-branching.set_upstream(run_this_first)
+    dag=dag,
+)
+run_this_first >> branching
 
 join = DummyOperator(
     task_id='join',
     trigger_rule='one_success',
-    dag=dag
+    dag=dag,
 )
 
 for option in options:
-    t = DummyOperator(task_id=option, dag=dag)
-    t.set_upstream(branching)
-    dummy_follow = DummyOperator(task_id='follow_' + option, dag=dag)
-    t.set_downstream(dummy_follow)
-    dummy_follow.set_downstream(join)
+    t = DummyOperator(
+        task_id=option,
+        dag=dag,
+    )
+
+    dummy_follow = DummyOperator(
+        task_id='follow_' + option,
+        dag=dag,
+    )
+
+    branching >> t >> dummy_follow >> join
diff --git a/airflow/example_dags/example_branch_python_dop_operator_3.py b/airflow/example_dags/example_branch_python_dop_operator_3.py
index 7be55a5f36915..950d5c1ae253b 100644
--- a/airflow/example_dags/example_branch_python_dop_operator_3.py
+++ b/airflow/example_dags/example_branch_python_dop_operator_3.py
@@ -18,9 +18,9 @@
 # under the License.
 
 import airflow
-from airflow.operators.python_operator import BranchPythonOperator
-from airflow.operators.dummy_operator import DummyOperator
 from airflow.models import DAG
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.operators.python_operator import BranchPythonOperator
 
 args = {
     'owner': 'airflow',
@@ -31,12 +31,14 @@
 # BranchPython operator that depends on past
 # and where tasks may run or be skipped on
 # alternating runs
-dag = DAG(dag_id='example_branch_dop_operator_v3',
-          schedule_interval='*/1 * * * *', default_args=args)
-
+dag = DAG(
+    dag_id='example_branch_dop_operator_v3',
+    schedule_interval='*/1 * * * *',
+    default_args=args,
+)
 
-def should_run(ds, **kwargs):
 
+def should_run(**kwargs):
     print('------------- exec dttm = {} and minute = {}'.
           format(kwargs['execution_date'], kwargs['execution_date'].minute))
     if kwargs['execution_date'].minute % 2 == 0:
@@ -49,14 +51,9 @@ def should_run(ds, **kwargs):
     task_id='condition',
     provide_context=True,
     python_callable=should_run,
-    dag=dag)
-
-oper_1 = DummyOperator(
-    task_id='oper_1',
-    dag=dag)
-oper_1.set_upstream(cond)
+    dag=dag,
+)
 
-oper_2 = DummyOperator(
-    task_id='oper_2',
-    dag=dag)
-oper_2.set_upstream(cond)
+dummy_task_1 = DummyOperator(task_id='dummy_task_1', dag=dag)
+dummy_task_2 = DummyOperator(task_id='dummy_task_2', dag=dag)
+cond >> [dummy_task_1, dummy_task_2]
diff --git a/airflow/example_dags/example_http_operator.py b/airflow/example_dags/example_http_operator.py
index da7ea3f2187e3..eca528e89965a 100644
--- a/airflow/example_dags/example_http_operator.py
+++ b/airflow/example_dags/example_http_operator.py
@@ -49,14 +49,16 @@
     data=json.dumps({"priority": 5}),
     headers={"Content-Type": "application/json"},
     response_check=lambda response: True if len(response.json()) == 0 else False,
-    dag=dag)
+    dag=dag,
+)
 
 t5 = SimpleHttpOperator(
     task_id='post_op_formenc',
     endpoint='nodes/url',
     data="name=Joe",
     headers={"Content-Type": "application/x-www-form-urlencoded"},
-    dag=dag)
+    dag=dag,
+)
 
 t2 = SimpleHttpOperator(
     task_id='get_op',
@@ -64,7 +66,8 @@
     endpoint='api/v1.0/nodes',
     data={"param1": "value1", "param2": "value2"},
     headers={},
-    dag=dag)
+    dag=dag,
+)
 
 t3 = SimpleHttpOperator(
     task_id='put_op',
@@ -72,7 +75,8 @@
     endpoint='api/v1.0/nodes',
     data=json.dumps({"priority": 5}),
     headers={"Content-Type": "application/json"},
-    dag=dag)
+    dag=dag,
+)
 
 t4 = SimpleHttpOperator(
     task_id='del_op',
@@ -80,7 +84,8 @@
     endpoint='api/v1.0/nodes',
     data="some=data",
     headers={"Content-Type": "application/x-www-form-urlencoded"},
-    dag=dag)
+    dag=dag,
+)
 
 sensor = HttpSensor(
     task_id='http_sensor_check',
@@ -89,10 +94,7 @@
     request_params={},
     response_check=lambda response: True if "Google" in response.content else False,
     poke_interval=5,
-    dag=dag)
+    dag=dag,
+)
 
-t1.set_upstream(sensor)
-t2.set_upstream(t1)
-t3.set_upstream(t2)
-t4.set_upstream(t3)
-t5.set_upstream(t4)
+sensor >> t1 >> t2 >> t3 >> t4 >> t5
diff --git a/airflow/example_dags/example_latest_only.py b/airflow/example_dags/example_latest_only.py
index fdb2dca490fbf..635a7641983c0 100644
--- a/airflow/example_dags/example_latest_only.py
+++ b/airflow/example_dags/example_latest_only.py
@@ -33,6 +33,6 @@
 )
 
 latest_only = LatestOnlyOperator(task_id='latest_only', dag=dag)
-
 task1 = DummyOperator(task_id='task1', dag=dag)
-task1.set_upstream(latest_only)
+
+latest_only >> task1
diff --git a/airflow/example_dags/example_latest_only_with_trigger.py b/airflow/example_dags/example_latest_only_with_trigger.py
index b8f4811c1a529..3559afb0c85b9 100644
--- a/airflow/example_dags/example_latest_only_with_trigger.py
+++ b/airflow/example_dags/example_latest_only_with_trigger.py
@@ -34,15 +34,10 @@
 )
 
 latest_only = LatestOnlyOperator(task_id='latest_only', dag=dag)
-
 task1 = DummyOperator(task_id='task1', dag=dag)
-task1.set_upstream(latest_only)
-
 task2 = DummyOperator(task_id='task2', dag=dag)
-
 task3 = DummyOperator(task_id='task3', dag=dag)
-task3.set_upstream([task1, task2])
+task4 = DummyOperator(task_id='task4', dag=dag, trigger_rule=TriggerRule.ALL_DONE)
 
-task4 = DummyOperator(task_id='task4', dag=dag,
-                      trigger_rule=TriggerRule.ALL_DONE)
-task4.set_upstream([task1, task2])
+latest_only >> task1 >> [task3, task4]
+task2 >> [task3, task4]
diff --git a/airflow/example_dags/example_passing_params_via_test_command.py b/airflow/example_dags/example_passing_params_via_test_command.py
index 7efca2f3b0ef2..2aef593abfd8b 100644
--- a/airflow/example_dags/example_passing_params_via_test_command.py
+++ b/airflow/example_dags/example_passing_params_via_test_command.py
@@ -18,18 +18,21 @@
 # under the License.
 
 from datetime import timedelta
+
 import airflow
 from airflow import DAG
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.python_operator import PythonOperator
 
-
-dag = DAG("example_passing_params_via_test_command",
-          default_args={"owner": "airflow",
-                        "start_date": airflow.utils.dates.days_ago(1)},
-          schedule_interval='*/1 * * * *',
-          dagrun_timeout=timedelta(minutes=4)
-          )
+dag = DAG(
+    "example_passing_params_via_test_command",
+    default_args={
+        "owner": "airflow",
+        "start_date": airflow.utils.dates.days_ago(1),
+    },
+    schedule_interval='*/1 * * * *',
+    dagrun_timeout=timedelta(minutes=4),
+)
 
 
 def my_py_command(ds, **kwargs):
@@ -54,12 +57,14 @@ def my_py_command(ds, **kwargs):
     provide_context=True,
     python_callable=my_py_command,
     params={"miff": "agg"},
-    dag=dag)
-
+    dag=dag,
+)
 
 also_run_this = BashOperator(
     task_id='also_run_this',
     bash_command=my_templated_command,
     params={"miff": "agg"},
-    dag=dag)
-also_run_this.set_upstream(run_this)
+    dag=dag,
+)
+
+run_this >> also_run_this
diff --git a/airflow/example_dags/example_python_operator.py b/airflow/example_dags/example_python_operator.py
index 6c4874fc872a4..254fb3e26cea5 100644
--- a/airflow/example_dags/example_python_operator.py
+++ b/airflow/example_dags/example_python_operator.py
@@ -18,23 +18,25 @@
 # under the License.
 
 from __future__ import print_function
-from builtins import range
-import airflow
-from airflow.operators.python_operator import PythonOperator
-from airflow.models import DAG
 
 import time
+from builtins import range
 from pprint import pprint
 
+import airflow
+from airflow.models import DAG
+from airflow.operators.python_operator import PythonOperator
 
 args = {
     'owner': 'airflow',
-    'start_date': airflow.utils.dates.days_ago(2)
+    'start_date': airflow.utils.dates.days_ago(2),
 }
 
 dag = DAG(
-    dag_id='example_python_operator', default_args=args,
-    schedule_interval=None)
+    dag_id='example_python_operator',
+    default_args=args,
+    schedule_interval=None,
+)
 
 
 # [START howto_operator_python]
@@ -48,7 +50,8 @@ def print_context(ds, **kwargs):
     task_id='print_the_context',
     provide_context=True,
     python_callable=print_context,
-    dag=dag)
+    dag=dag,
+)
 # [END howto_operator_python]
 
 
@@ -64,7 +67,8 @@ def my_sleeping_function(random_base):
         task_id='sleep_for_' + str(i),
         python_callable=my_sleeping_function,
         op_kwargs={'random_base': float(i) / 10},
-        dag=dag)
+        dag=dag,
+    )
 
-    task.set_upstream(run_this)
+    run_this >> task
 # [END howto_operator_python_kwargs]
diff --git a/airflow/example_dags/example_short_circuit_operator.py b/airflow/example_dags/example_short_circuit_operator.py
index 8e9565df917da..1093dab616779 100644
--- a/airflow/example_dags/example_short_circuit_operator.py
+++ b/airflow/example_dags/example_short_circuit_operator.py
@@ -17,25 +17,29 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import airflow
-from airflow.operators.python_operator import ShortCircuitOperator
-from airflow.operators.dummy_operator import DummyOperator
-from airflow.models import DAG
 import airflow.utils.helpers
-
+from airflow.models import DAG
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.operators.python_operator import ShortCircuitOperator
 
 args = {
     'owner': 'airflow',
-    'start_date': airflow.utils.dates.days_ago(2)
+    'start_date': airflow.utils.dates.days_ago(2),
 }
 
 dag = DAG(dag_id='example_short_circuit_operator', default_args=args)
 
 cond_true = ShortCircuitOperator(
-    task_id='condition_is_True', python_callable=lambda: True, dag=dag)
+    task_id='condition_is_True',
+    python_callable=lambda: True,
+    dag=dag,
+)
 
 cond_false = ShortCircuitOperator(
-    task_id='condition_is_False', python_callable=lambda: False, dag=dag)
+    task_id='condition_is_False',
+    python_callable=lambda: False,
+    dag=dag,
+)
 
 ds_true = [DummyOperator(task_id='true_' + str(i), dag=dag) for i in [1, 2]]
 ds_false = [DummyOperator(task_id='false_' + str(i), dag=dag) for i in [1, 2]]
diff --git a/airflow/example_dags/example_skip_dag.py b/airflow/example_dags/example_skip_dag.py
index f11ca59338a0a..456eb911dcaa1 100644
--- a/airflow/example_dags/example_skip_dag.py
+++ b/airflow/example_dags/example_skip_dag.py
@@ -18,14 +18,13 @@
 # under the License.
 
 import airflow
-from airflow.operators.dummy_operator import DummyOperator
-from airflow.models import DAG
 from airflow.exceptions import AirflowSkipException
-
+from airflow.models import DAG
+from airflow.operators.dummy_operator import DummyOperator
 
 args = {
     'owner': 'airflow',
-    'start_date': airflow.utils.dates.days_ago(2)
+    'start_date': airflow.utils.dates.days_ago(2),
 }
 
 
@@ -37,23 +36,17 @@ def execute(self, context):
         raise AirflowSkipException
 
 
-dag = DAG(dag_id='example_skip_dag', default_args=args)
-
-
 def create_test_pipeline(suffix, trigger_rule, dag):
-
     skip_operator = DummySkipOperator(task_id='skip_operator_{}'.format(suffix), dag=dag)
-
     always_true = DummyOperator(task_id='always_true_{}'.format(suffix), dag=dag)
-
     join = DummyOperator(task_id=trigger_rule, dag=dag, trigger_rule=trigger_rule)
-
-    join.set_upstream(skip_operator)
-    join.set_upstream(always_true)
-
     final = DummyOperator(task_id='final_{}'.format(suffix), dag=dag)
-    final.set_upstream(join)
+
+    skip_operator >> join
+    always_true >> join
+    join >> final
 
 
+dag = DAG(dag_id='example_skip_dag', default_args=args)
 create_test_pipeline('1', 'all_success', dag)
 create_test_pipeline('2', 'one_success', dag)
diff --git a/airflow/example_dags/example_subdag_operator.py b/airflow/example_dags/example_subdag_operator.py
index ffd254b19a845..98386ba4545e2 100644
--- a/airflow/example_dags/example_subdag_operator.py
+++ b/airflow/example_dags/example_subdag_operator.py
@@ -18,14 +18,11 @@
 # under the License.
 
 import airflow
-
+from airflow.example_dags.subdags.subdag import subdag
 from airflow.models import DAG
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.subdag_operator import SubDagOperator
 
-from airflow.example_dags.subdags.subdag import subdag
-
-
 DAG_NAME = 'example_subdag_operator'
 
 args = {
@@ -71,7 +68,4 @@
     dag=dag,
 )
 
-start.set_downstream(section_1)
-section_1.set_downstream(some_other_task)
-some_other_task.set_downstream(section_2)
-section_2.set_downstream(end)
+start >> section_1 >> some_other_task >> section_2 >> end
diff --git a/airflow/example_dags/example_trigger_controller_dag.py b/airflow/example_dags/example_trigger_controller_dag.py
index f5c7218239150..35e7184f76cf0 100644
--- a/airflow/example_dags/example_trigger_controller_dag.py
+++ b/airflow/example_dags/example_trigger_controller_dag.py
@@ -33,11 +33,11 @@
 2. A Target DAG : c.f. example_trigger_target_dag.py
 """
 
-from airflow import DAG
-from airflow.operators.dagrun_operator import TriggerDagRunOperator
+import pprint
 from datetime import datetime
 
-import pprint
+from airflow import DAG
+from airflow.operators.dagrun_operator import TriggerDagRunOperator
 
 pp = pprint.PrettyPrinter(indent=4)
 
@@ -53,16 +53,20 @@ def conditionally_trigger(context, dag_run_obj):
 
 
 # Define the DAG
-dag = DAG(dag_id='example_trigger_controller_dag',
-          default_args={"owner": "airflow",
-                        "start_date": datetime.utcnow()},
-          schedule_interval='@once')
-
+dag = DAG(
+    dag_id='example_trigger_controller_dag',
+    default_args={
+        "owner": "airflow",
+        "start_date": datetime.utcnow(),
+    },
+    schedule_interval='@once',
+)
 
 # Define the single task in this controller example DAG
-trigger = TriggerDagRunOperator(task_id='test_trigger_dagrun',
-                                trigger_dag_id="example_trigger_target_dag",
-                                python_callable=conditionally_trigger,
-                                params={'condition_param': True,
-                                        'message': 'Hello World'},
-                                dag=dag)
+trigger = TriggerDagRunOperator(
+    task_id='test_trigger_dagrun',
+    trigger_dag_id="example_trigger_target_dag",
+    python_callable=conditionally_trigger,
+    params={'condition_param': True, 'message': 'Hello World'},
+    dag=dag,
+)
diff --git a/airflow/example_dags/example_trigger_target_dag.py b/airflow/example_dags/example_trigger_target_dag.py
index 7a656f285964e..c1403a60e1c00 100644
--- a/airflow/example_dags/example_trigger_target_dag.py
+++ b/airflow/example_dags/example_trigger_target_dag.py
@@ -17,12 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import pprint
+from datetime import datetime
+
+from airflow.models import DAG
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.python_operator import PythonOperator
-from airflow.models import DAG
-from datetime import datetime
 
-import pprint
 pp = pprint.PrettyPrinter(indent=4)
 
 # This example illustrates the use of the TriggerDagRunOperator. There are 2
@@ -50,7 +51,8 @@
 dag = DAG(
     dag_id='example_trigger_target_dag',
     default_args=args,
-    schedule_interval=None)
+    schedule_interval=None,
+)
 
 
 def run_this_func(ds, **kwargs):
@@ -62,12 +64,13 @@ def run_this_func(ds, **kwargs):
     task_id='run_this',
     provide_context=True,
     python_callable=run_this_func,
-    dag=dag)
-
+    dag=dag,
+)
 
 # You can also access the DagRun object in templates
 bash_task = BashOperator(
     task_id="bash_task",
     bash_command='echo "Here is the message: '
                  '{{ dag_run.conf["message"] if dag_run else "" }}" ',
-    dag=dag)
+    dag=dag,
+)
diff --git a/airflow/example_dags/example_xcom.py b/airflow/example_dags/example_xcom.py
index 66bec9a780285..f2b7627aca2f7 100644
--- a/airflow/example_dags/example_xcom.py
+++ b/airflow/example_dags/example_xcom.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 from __future__ import print_function
+
 import airflow
 from airflow import DAG
 from airflow.operators.python_operator import PythonOperator
@@ -24,25 +25,22 @@
 args = {
     'owner': 'airflow',
     'start_date': airflow.utils.dates.days_ago(2),
-    'provide_context': True
+    'provide_context': True,
 }
 
-dag = DAG(
-    'example_xcom',
-    schedule_interval="@once",
-    default_args=args)
+dag = DAG('example_xcom', schedule_interval="@once", default_args=args)
 
 value_1 = [1, 2, 3]
 value_2 = {'a': 'b'}
 
 
 def push(**kwargs):
-    # pushes an XCom without a specific target
+    """Pushes an XCom without a specific target"""
     kwargs['ti'].xcom_push(key='value from pusher 1', value=value_1)
 
 
 def push_by_returning(**kwargs):
-    # pushes an XCom without a specific target, just by returning it
+    """Pushes an XCom without a specific target, just by returning it"""
     return value_2
 
 
@@ -63,12 +61,21 @@ def puller(**kwargs):
 
 
 push1 = PythonOperator(
-    task_id='push', dag=dag, python_callable=push)
+    task_id='push',
+    dag=dag,
+    python_callable=push,
+)
 
 push2 = PythonOperator(
-    task_id='push_by_returning', dag=dag, python_callable=push_by_returning)
+    task_id='push_by_returning',
+    dag=dag,
+    python_callable=push_by_returning,
+)
 
 pull = PythonOperator(
-    task_id='puller', dag=dag, python_callable=puller)
+    task_id='puller',
+    dag=dag,
+    python_callable=puller,
+)
 
-pull.set_upstream([push1, push2])
+pull << [push1, push2]
diff --git a/airflow/example_dags/test_utils.py b/airflow/example_dags/test_utils.py
index fb8792a1bf2bc..3fc8af1dada06 100644
--- a/airflow/example_dags/test_utils.py
+++ b/airflow/example_dags/test_utils.py
@@ -18,17 +18,15 @@
 # under the License.
 """Used for unit tests"""
 import airflow
-from airflow.operators.bash_operator import BashOperator
 from airflow.models import DAG
+from airflow.operators.bash_operator import BashOperator
 
-dag = DAG(
-    dag_id='test_utils',
-    schedule_interval=None,
-)
+dag = DAG(dag_id='test_utils', schedule_interval=None)
 
 task = BashOperator(
     task_id='sleeps_forever',
     dag=dag,
     bash_command="sleep 10000000000",
     start_date=airflow.utils.dates.days_ago(2),
-    owner='airflow')
+    owner='airflow',
+)
diff --git a/airflow/example_dags/tutorial.py b/airflow/example_dags/tutorial.py
index ad817338ef2aa..ccf2e6e2ee235 100644
--- a/airflow/example_dags/tutorial.py
+++ b/airflow/example_dags/tutorial.py
@@ -22,14 +22,14 @@
 Documentation that goes along with the Airflow tutorial located
 [here](https://airflow.incubator.apache.org/tutorial.html)
 """
+from datetime import timedelta
+
 import airflow
 from airflow import DAG
 from airflow.operators.bash_operator import BashOperator
-from datetime import timedelta
-
 
-# these args will get passed on to each operator
-# you can override them on a per-task basis during operator initialization
+# These args will get passed on to each operator
+# You can override them on a per-task basis during operator initialization
 default_args = {
     'owner': 'airflow',
     'depends_on_past': False,
@@ -58,13 +58,15 @@
     'tutorial',
     default_args=default_args,
     description='A simple tutorial DAG',
-    schedule_interval=timedelta(days=1))
+    schedule_interval=timedelta(days=1),
+)
 
 # t1, t2 and t3 are examples of tasks created by instantiating operators
 t1 = BashOperator(
     task_id='print_date',
     bash_command='date',
-    dag=dag)
+    dag=dag,
+)
 
 t1.doc_md = """\
 #### Task Documentation
@@ -80,7 +82,8 @@
     task_id='sleep',
     depends_on_past=False,
     bash_command='sleep 5',
-    dag=dag)
+    dag=dag,
+)
 
 templated_command = """
 {% for i in range(5) %}
@@ -95,7 +98,7 @@
     depends_on_past=False,
     bash_command=templated_command,
     params={'my_param': 'Parameter I passed in'},
-    dag=dag)
+    dag=dag,
+)
 
-t2.set_upstream(t1)
-t3.set_upstream(t1)
+t1 >> [t2, t3]
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index 0ea58d2784e65..570cd75c809d9 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -247,23 +247,36 @@ in templates, make sure to read through the :ref:`macros` section
 
 Setting up Dependencies
 -----------------------
-We have two simple tasks that do not depend on each other. Here's a few ways
+We have tasks `t1`, `t2` and `t3` that do not depend on each other. Here's a few ways
 you can define dependencies between them:
 
 .. code:: python
 
-    t2.set_upstream(t1)
+    t1.set_downstream(t2)
 
     # This means that t2 will depend on t1
-    # running successfully to run
-    # It is equivalent to
-    # t1.set_downstream(t2)
+    # running successfully to run.
+    # It is equivalent to:
+    t2.set_upstream(t1)
 
-    t3.set_upstream(t1)
+    # The bit shift operator can also be
+    # used to chain operations:
+    t1 >> t2
+
+    # And the upstream dependency with the
+    # bit shift operator:
+    t2 << t1
+
+    # Chaining multiple dependencies becomes
+    # concise with the bit shift operator:
+    t1 >> t2 >> t3
 
-    # all of this is equivalent to
-    # dag.set_dependency('print_date', 'sleep')
-    # dag.set_dependency('print_date', 'templated')
+    # A list of tasks can also be set as
+    # dependencies. These operations
+    # all have the same effect:
+    t1.set_downstream([t2, t3])
+    t1 >> [t2, t3]
+    [t2, t3] << t1
 
 Note that when executing your script, Airflow will raise exceptions when
 it finds cycles in your DAG or when a dependency is referenced more

From d4dff076a6eaf169424822c0010c802f4af80c6a Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Thu, 18 Oct 2018 18:49:08 +0200
Subject: [PATCH 138/808] [AIRFLOW-3232] More readable GCF operator
 documentation (#4067)

---
 airflow/contrib/hooks/gcp_function_hook.py    | 26 ++++----
 .../operators/gcp_function_operator.py        | 35 +++++-----
 docs/howto/operator.rst                       | 66 ++++++++++---------
 docs/integration.rst                          |  4 +-
 4 files changed, 69 insertions(+), 62 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
index d2da19285ab13..d89b5b0ec80d2 100644
--- a/airflow/contrib/hooks/gcp_function_hook.py
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -35,7 +35,7 @@
 # noinspection PyAbstractClass
 class GcfHook(GoogleCloudBaseHook):
     """
-    Hook for Google Cloud Functions APIs.
+    Hook for the Google Cloud Functions APIs.
     """
     _conn = None
 
@@ -48,7 +48,7 @@ def __init__(self,
 
     def get_conn(self):
         """
-        Retrieves connection to cloud functions.
+        Retrieves the connection to Cloud Functions.
 
         :return: Google Cloud Function services object
         :rtype: dict
@@ -61,7 +61,7 @@ def get_conn(self):
 
     def get_function(self, name):
         """
-        Returns the function with a given name.
+        Returns the Cloud Function with the given name.
 
         :param name: name of the function
         :type name: str
@@ -73,9 +73,9 @@ def get_function(self, name):
 
     def list_functions(self, full_location):
         """
-        Lists all functions created in the location.
+        Lists all Cloud Functions created in the location.
 
-        :param full_location: full location including project. On the form
+        :param full_location: full location including the project in the form of
             of /projects/<PROJECT>/location/<LOCATION>
         :type full_location: str
         :return: array of CloudFunction objects - representing functions in the location
@@ -87,12 +87,12 @@ def list_functions(self, full_location):
 
     def create_new_function(self, full_location, body):
         """
-        Creates new cloud function in location given with body specified.
+        Creates a new function in Cloud Function in the location specified in the body.
 
-        :param full_location: full location including project. On the form
+        :param full_location: full location including the project in the form of
             of /projects/<PROJECT>/location/<LOCATION>
         :type full_location: str
-        :param body: body required by the cloud function insert API
+        :param body: body required by the Cloud Functions insert API
         :type body: dict
         :return: response returned by the operation
         :rtype: dict
@@ -106,7 +106,7 @@ def create_new_function(self, full_location, body):
 
     def update_function(self, name, body, update_mask):
         """
-        Updates cloud function according to the update mask specified.
+        Updates Cloud Functions according to the specified update mask.
 
         :param name: name of the function
         :type name: str
@@ -129,10 +129,10 @@ def upload_function_zip(self, parent, zip_path):
         """
         Uploads zip file with sources.
 
-        :param parent: project and location in which signed upload URL should be generated
-           in the form of /projects/<PROJECT>/location/<LOCATION>
+        :param parent: Google Cloud Platform project id and region where zip file should
+         be uploaded in the form of /projects/<PROJECT>/location/<LOCATION>
         :type parent: str
-        :param zip_path: path of the file to upload (should point to valid .zip file)
+        :param zip_path: path of the valid .zip file to upload
         :type zip_path: str
         :return: Upload URL that was returned by generateUploadUrl method
         """
@@ -156,7 +156,7 @@ def upload_function_zip(self, parent, zip_path):
 
     def delete_function(self, name):
         """
-        Deletes cloud function specified by name.
+        Deletes the specified Cloud Function.
 
         :param name: name of the function
         :type name: str
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index 8207b9d084f89..c0013aaea9bf6 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -80,28 +80,29 @@ def _validate_max_instances(value):
 
 class GcfFunctionDeployOperator(BaseOperator):
     """
-    Create a function in Google Cloud Functions.
+    Creates a function in Google Cloud Functions.
 
-    :param project_id: Project ID that the operator works on
+    :param project_id: Google Cloud Platform Project ID where the function should
+        be created.
     :type project_id: str
-    :param location: Region where the operator operates on
+    :param location: Google Cloud Platform region where the function should be created.
     :type location: str
-    :param body: Body of the cloud function definition. The body must be a CloudFunction
-        dictionary as described in:
+    :param body: Body of the Cloud Functions definition. The body must be a
+        Cloud Functions dictionary as described in:
         https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions
-        (note that different API versions require different
-        variants of the CloudFunction dictionary)
+        . Different API versions require different variants of the Cloud Functions
+        dictionary.
     :type body: dict or google.cloud.functions.v1.CloudFunction
-    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :param gcp_conn_id: The connection ID to use to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: Version of the API used (for example v1).
+    :param api_version: API version used (for example v1 or v1beta1).
     :type api_version: str
-    :param zip_path: Path to zip file containing source code of the function. If it is
-        set, then sourceUploadUrl should not be specified in the body (or it should
-        be empty), then the zip file will be uploaded using upload URL generated
-        via generateUploadUrl from cloud functions API
+    :param zip_path: Path to zip file containing source code of the function. If the path
+        is set, the sourceUploadUrl should not be specified in the body or it should
+        be empty. Then the zip file will be uploaded using the upload URL generated
+        via generateUploadUrl from the Cloud Functions API.
     :type zip_path: str
-    :param validate_body: If set to False, no body validation is performed.
+    :param validate_body: If set to False, body validation is not performed.
     :type validate_body: bool
     """
 
@@ -265,14 +266,14 @@ def preprocess_body(self):
 
 class GcfFunctionDeleteOperator(BaseOperator):
     """
-    Delete a function with specified name from Google Cloud Functions.
+    Deletes the specified function from Google Cloud Functions.
 
     :param name: A fully-qualified function name, matching
         the pattern: `^projects/[^/]+/locations/[^/]+/functions/[^/]+$`
     :type name: str
-    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :param gcp_conn_id: The connection ID to use to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: Version of the API used (for example v1).
+    :param api_version: API version used (for example v1 or v1beta1).
     :type api_version: str
     """
 
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 549d67757049f..6138d5eca71e1 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -179,15 +179,18 @@ to delete a function from Google Cloud Functions.
 
 Troubleshooting
 """""""""""""""
+If you want to run or deploy an operator using a service account and get “forbidden 403”
+errors, it means that your service account does not have the correct
+Cloud IAM permissions.
 
-In case you want to run deploy operator using a service account and get "forbidden 403"
-errors, it means that your service account has not enough permissions set via IAM.
+1. Assign your Service Account the Cloud Functions Developer role.
+2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
+   service account.
+
+The typical way of assigning Cloud IAM permissions with `gcloud` is
+shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
+and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
 
-* First you need to Assign your Service Account "Cloud Functions Developer" role
-* Make sure you grant the user the IAM Service Account User role on the Cloud Functions
-Runtime service account. Typical way of doing it with gcloud is shown below - just
-replace PROJECT_ID with ID of your project and SERVICE_ACCOUNT_EMAIL with the email id
-of your service account.
 
 .. code-block:: bash
 
@@ -205,40 +208,40 @@ GcfFunctionDeployOperator
 Use the :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`
 to deploy a function from Google Cloud Functions.
 
-The examples below use Airflow variables defined in order to show various variants and
-combinations of default_args you can use. The variables are defined as follows:
+The following examples of Airflow variables show various variants and combinations
+of default_args that you can use. The variables are defined as follows:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_variables]
     :end-before: [END howto_operator_gcf_deploy_variables]
 
-With those variables one can define body of the request:
+With those variables you can define the body of the request:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_body]
     :end-before: [END howto_operator_gcf_deploy_body]
 
-The default_args dictionary when you create DAG can be used to pass body and other
-arguments:
+When you create a DAG, the default_args dictionary can be used to pass the body and
+other arguments:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_args]
     :end-before: [END howto_operator_gcf_deploy_args]
 
-Note that the neither the body nor default args are complete in the above examples.
-Depending on the variables set there might be different variants on how to pass
-source code related fields. Currently you can pass either
-`sourceArchiveUrl`, `sourceRepository` or `sourceUploadUrl` as described in
+Note that the neither the body nor the default args are complete in the above examples.
+Depending on the set variables, there might be different variants on how to pass source
+code related fields. Currently, you can pass either sourceArchiveUrl, sourceRepository
+or sourceUploadUrl as described in the
 `CloudFunction API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
-Additionally default_args might contain `zip_path` parameter to run extra step
-of uploading the source code before deploying it. In the last case you also need to
+Additionally, default_args might contain zip_path parameter to run the extra step of
+uploading the source code before deploying it. In the last case, you also need to
 provide an empty `sourceUploadUrl` parameter in the body.
 
-Example logic of setting the source code related fields based on variables defined above
-is shown here:
+Based on the variables defined above, example logic of setting the source code
+related fields is shown here:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
@@ -255,14 +258,17 @@ The code to create the operator:
 Troubleshooting
 """""""""""""""
 
-In case you want to run deploy operator using a service account and get "forbidden 403"
-errors, it means that your service account has not enough permissions set via IAM.
+If you want to run or deploy an operator using a service account and get “forbidden 403”
+errors, it means that your service account does not have the correct
+Cloud IAM permissions.
+
+1. Assign your Service Account the Cloud Functions Developer role.
+2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
+   service account.
 
-* First you need to Assign your Service Account "Cloud Functions Developer" role
-* Make sure you grant the user the IAM Service Account User role on the Cloud Functions
-Runtime service account. Typical way of doing it with gcloud is shown below - just
-replace PROJECT_ID with ID of your project and SERVICE_ACCOUNT_EMAIL with the email id
-of your service account.
+The typical way of assigning Cloud IAM permissions with `gcloud` is
+shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
+and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
 
 .. code-block:: bash
 
@@ -274,6 +280,6 @@ of your service account.
 
 See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
 
-Also make sure that your service account has access to the source code of function
-in case it should be downloaded. It might mean that you add Source Repository Viewer
-role to the service account in case the source code is in Google Source Repository.
+If the source code for your function is in Google Source Repository, make sure that
+your service account has the Source Repository Viewer role so that the source code
+can be downloaded if necessary.
diff --git a/docs/integration.rst b/docs/integration.rst
index dd65ebbe81f81..cd63d60b64c95 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -477,8 +477,8 @@ Cloud Functions
 Cloud Functions Operators
 """""""""""""""""""""""""
 
-- :ref:`GcfFunctionDeployOperator` : deploy Google Cloud Function to the cloud.
-- :ref:`GcfFunctionDeleteOperator` : delete Google Cloud Function in the cloud.
+- :ref:`GcfFunctionDeployOperator` : deploy Google Cloud Function to Google Cloud Platform
+- :ref:`GcfFunctionDeleteOperator` : delete Google Cloud Function in Google Cloud Platform
 
 .. autoclass:: airflow.contrib.operators.gcp_operator.GCP
 

From 9ec863ae24c060daabceb74dc32cad1300bb8a32 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@google.com>
Date: Fri, 22 Jun 2018 23:18:36 +0100
Subject: [PATCH 139/808] [AIRFLOW-2657] Add ability to delete dag from web UI

Closes #3531 from Noremac201/master
---
 airflow/www/templates/airflow/dag.html       | 13 +++++++++
 airflow/www/templates/airflow/dags.html      | 12 ++++++++
 airflow/www/views.py                         | 30 ++++++++++++++++++++
 airflow/www_rbac/templates/airflow/dag.html  | 13 +++++++++
 airflow/www_rbac/templates/airflow/dags.html | 11 +++++++
 airflow/www_rbac/views.py                    | 30 ++++++++++++++++++++
 6 files changed, 109 insertions(+)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index adb2d387da443..9ef4cce5c1c46 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -100,6 +100,13 @@ <h4 class="pull-right">
           Refresh
         </a>
       </li>
+      <li>
+        <a href="{{ url_for("airflow.delete", dag_id=dag.dag_id, root=root) }}"
+        onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+        <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true"></span>
+        Delete
+        </a>
+      </li>
     </ul>
   </div>
   <hr>
@@ -302,6 +309,12 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
+    function confirmDeleteDag(dag_id){
+        return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          This cannot be undone.");
+    }
+
     $("#btn_rendered").click(function(){
       url = "{{ url_for('airflow.rendered') }}" +
         "?task_id=" + encodeURIComponent(task_id) +
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 217b39dcbb4b7..0a7a6ec2a4791 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -190,6 +190,12 @@ <h2>DAGs</h2>
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
+                <!-- Delete -->
+                <a href="{{ url_for('airflow.delete', dag_id=dag.dag_id) }}"
+                  onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+                   <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
+                </a>
+
                 </td>
             </tr>
         {% endfor %}
@@ -244,6 +250,12 @@ <h2>DAGs</h2>
       function confirmTriggerDag(dag_id){
           return confirm("Are you sure you want to run '"+dag_id+"' now?");
       }
+
+      function confirmDeleteDag(dag_id){
+          return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          This cannot be undone.");
+      }
       all_dags = $("[id^=toggle]");
       $.each(all_dags, function(i,v) {
         $(v).change (function() {
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 3112c081acc47..40fc2d6838406 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1043,6 +1043,32 @@ def run(self):
             "it should start any moment now.".format(ti))
         return redirect(origin)
 
+    @expose('/delete')
+    @login_required
+    @wwwutils.action_logging
+    @wwwutils.notify_owner
+    def delete(self):
+        from airflow.api.common.experimental import delete_dag
+        from airflow.exceptions import DagNotFound, DagFileExists
+
+        dag_id = request.args.get('dag_id')
+        origin = request.args.get('origin') or "/admin/"
+
+        try:
+            delete_dag.delete_dag(dag_id)
+        except DagNotFound:
+            flash("DAG with id {} not found. Cannot delete".format(dag_id))
+            return redirect(request.referrer)
+        except DagFileExists:
+            flash("Dag id {} is still in DagBag. "
+                  "Remove the DAG file first.".format(dag_id))
+            return redirect(request.referrer)
+
+        flash("Deleting DAG with id {}. May take a couple minutes to fully"
+              " disappear.".format(dag_id))
+        # Upon successful delete return to origin
+        return redirect(origin)
+
     @expose('/trigger')
     @login_required
     @wwwutils.action_logging
@@ -1286,6 +1312,10 @@ def tree(self, session=None):
         dag_id = request.args.get('dag_id')
         blur = conf.getboolean('webserver', 'demo_mode')
         dag = dagbag.get_dag(dag_id)
+        if dag_id not in dagbag.dags:
+            flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
+            return redirect('/admin/')
+
         root = request.args.get('root')
         if root:
             dag = dag.sub_dag(
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index eb449085023b9..e6495fe4be9da 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -99,6 +99,13 @@ <h4 class="pull-right">
           Refresh
         </a>
       </li>
+      <li>
+        <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id, root=root) }}"
+        onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+        <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true"></span>
+        Delete
+        </a>
+      </li>
     </ul>
   </div>
   <hr>
@@ -300,6 +307,12 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
+    function confirmDeleteDag(dag_id){
+        return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          This cannot be undone.");
+    }
+
     $("#btn_rendered").click(function(){
       url = "{{ url_for('Airflow.rendered') }}" +
         "?task_id=" + encodeURIComponent(task_id) +
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index a7a7467de1f68..c7aa33801488f 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -191,6 +191,11 @@ <h2>DAGs</h2>
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
+                <!-- Delete -->
+                <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id) }}"
+                   onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+                  <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
+                </a>
                 </td>
             </tr>
         {% endfor %}
@@ -242,6 +247,12 @@ <h2>DAGs</h2>
         window.location = DAGS_INDEX + "?page_size=" + p_size;
       });
 
+      function confirmDeleteDag(dag_id){
+          return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          This cannot be undone.");
+      }
+
       function confirmTriggerDag(dag_id){
           return confirm("Are you sure you want to run '"+dag_id+"' now?");
       }
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 3f5ccab5cbdd9..69e2079059889 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -727,6 +727,32 @@ def run(self):
             "it should start any moment now.".format(ti))
         return redirect(origin)
 
+    @expose('/delete')
+    @action_logging
+    @has_access
+    def delete(self):
+        from airflow.api.common.experimental import delete_dag
+        from airflow.exceptions import DagNotFound, DagFileExists
+
+        dag_id = request.args.get('dag_id')
+        origin = request.args.get('origin') or "/"
+
+        try:
+            delete_dag.delete_dag(dag_id)
+        except DagNotFound:
+            flash("DAG with id {} not found. Cannot delete".format(dag_id))
+            return redirect(request.referrer)
+        except DagFileExists:
+            flash("Dag id {} is still in DagBag. "
+                  "Remove the DAG file first.".format(dag_id))
+            return redirect(request.referrer)
+
+        flash("Deleting DAG with id {}. May take a couple minutes to fully"
+              " disappear.".format(dag_id))
+
+        # Upon success return to origin.
+        return redirect(origin)
+
     @expose('/trigger')
     @has_access
     @action_logging
@@ -964,6 +990,10 @@ def tree(self, session=None):
         dag_id = request.args.get('dag_id')
         blur = conf.getboolean('webserver', 'demo_mode')
         dag = dagbag.get_dag(dag_id)
+        if dag_id not in dagbag.dags:
+            flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
+            return redirect('/')
+
         root = request.args.get('root')
         if root:
             dag = dag.sub_dag(

From 3be8ce724f2eb59929a5bfdacd66c761c96e2858 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Thu, 1 Nov 2018 00:00:46 +0100
Subject: [PATCH 140/808] [AIRFLOW-3231] Basic operators for Google Cloud SQL
 (#4097)

Add CloudSqlInstanceInsertOperator, CloudSqlInstancePatchOperator and CloudSqlInstanceDeleteOperator.

Each operator includes:
- core logic
- input params validation
- unit tests
- presence in the example DAG
- docstrings
- How-to and Integration documentation

Additionally, small improvements to GcpBodyFieldValidator were made:
- add simple list validation capability (type="list")
- introduced parameter allow_empty, which can be set to False
	to test for non-emptiness of a string instead of specifying
	a regexp.

Co-authored-by: sprzedwojski <szymon.przedwojski@polidea.com>
Co-authored-by: potiuk <jarek.potiuk@polidea.com>
---
 .../contrib/example_dags/example_gcp_sql.py   | 134 ++++++++
 airflow/contrib/hooks/gcp_sql_hook.py         | 173 ++++++++++
 airflow/contrib/operators/gcp_sql_operator.py | 297 +++++++++++++++++
 airflow/contrib/utils/gcp_field_validator.py  |  41 ++-
 docs/howto/operator.rst                       | 152 +++++++++
 docs/integration.rst                          |  37 +++
 .../operators/test_gcp_function_operator.py   |   6 +-
 .../operators/test_gcp_sql_operator.py        | 314 ++++++++++++++++++
 8 files changed, 1145 insertions(+), 9 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_sql.py
 create mode 100644 airflow/contrib/hooks/gcp_sql_hook.py
 create mode 100644 airflow/contrib/operators/gcp_sql_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_sql_operator.py

diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
new file mode 100644
index 0000000000000..a484456f6e6d9
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that deploys, updates, patches and deletes a Cloud SQL instance
+in Google Cloud Platform.
+
+This DAG relies on the following Airflow variables
+https://airflow.apache.org/concepts.html#variables
+* PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance.
+* INSTANCE_NAME - Name of the Cloud SQL instance.
+"""
+
+import datetime
+
+import airflow
+from airflow import models
+
+from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
+    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator
+
+# [START howto_operator_cloudsql_arguments]
+PROJECT_ID = models.Variable.get('PROJECT_ID', '')
+INSTANCE_NAME = models.Variable.get('INSTANCE_NAME', '')
+# [END howto_operator_cloudsql_arguments]
+
+# Bodies below represent Cloud SQL instance resources:
+# https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances
+
+# [START howto_operator_cloudsql_create_body]
+body = {
+    "name": INSTANCE_NAME,
+    "settings": {
+        "tier": "db-n1-standard-1",
+        "backupConfiguration": {
+            "binaryLogEnabled": True,
+            "enabled": True,
+            "startTime": "05:00"
+        },
+        "activationPolicy": "ALWAYS",
+        "dataDiskSizeGb": 30,
+        "dataDiskType": "PD_SSD",
+        "databaseFlags": [],
+        "ipConfiguration": {
+            "ipv4Enabled": True,
+            "requireSsl": True,
+        },
+        "locationPreference": {
+            "zone": "europe-west4-a"
+        },
+        "maintenanceWindow": {
+            "hour": 5,
+            "day": 7,
+            "updateTrack": "canary"
+        },
+        "pricingPlan": "PER_USE",
+        "replicationType": "ASYNCHRONOUS",
+        "storageAutoResize": False,
+        "storageAutoResizeLimit": 0,
+        "userLabels": {
+            "my-key": "my-value"
+        }
+    },
+    "databaseVersion": "MYSQL_5_7",
+    "region": "europe-west4",
+}
+# [END howto_operator_cloudsql_create_body]
+# [START howto_operator_cloudsql_patch_body]
+patch_body = {
+    "name": INSTANCE_NAME,
+    "settings": {
+        "dataDiskSizeGb": 35,
+        "maintenanceWindow": {
+            "hour": 3,
+            "day": 6,
+            "updateTrack": "canary"
+        },
+        "userLabels": {
+            "my-key-patch": "my-value-patch"
+        }
+    }
+}
+# [END howto_operator_cloudsql_patch_body]
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+
+with models.DAG(
+    'example_gcp_sql',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_cloudsql_create]
+    sql_instance_create_task = CloudSqlInstanceCreateOperator(
+        project_id=PROJECT_ID,
+        body=body,
+        instance=INSTANCE_NAME,
+        task_id='sql_instance_create_task'
+    )
+    # [END howto_operator_cloudsql_create]
+    # [START howto_operator_cloudsql_patch]
+    sql_instance_patch_task = CloudSqlInstancePatchOperator(
+        project_id=PROJECT_ID,
+        body=patch_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_instance_patch_task'
+    )
+    # [END howto_operator_cloudsql_patch]
+    # [START howto_operator_cloudsql_delete]
+    sql_instance_delete_task = CloudSqlInstanceDeleteOperator(
+        project_id=PROJECT_ID,
+        instance=INSTANCE_NAME,
+        task_id='sql_instance_delete_task'
+    )
+    # [END howto_operator_cloudsql_delete]
+
+    sql_instance_create_task >> sql_instance_patch_task >> sql_instance_delete_task
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
new file mode 100644
index 0000000000000..e0b3f92d8f20e
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -0,0 +1,173 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import time
+from googleapiclient.discovery import build
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+# Number of retries - used by googleapiclient method calls to perform retries
+# For requests that are "retriable"
+NUM_RETRIES = 5
+
+# Time to sleep between active checks of the operation results
+TIME_TO_SLEEP_IN_SECONDS = 1
+
+
+class CloudSqlOperationStatus:
+    PENDING = "PENDING"
+    RUNNING = "RUNNING"
+    DONE = "DONE"
+    UNKNOWN = "UNKNOWN"
+
+
+# noinspection PyAbstractClass
+class CloudSqlHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud SQL APIs.
+    """
+    _conn = None
+
+    def __init__(self,
+                 api_version,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(CloudSqlHook, self).__init__(gcp_conn_id, delegate_to)
+        self.api_version = api_version
+
+    def get_conn(self):
+        """
+        Retrieves connection to Cloud SQL.
+
+        :return: Google Cloud SQL services object.
+        :rtype: dict
+        """
+        if not self._conn:
+            http_authorized = self._authorize()
+            self._conn = build('sqladmin', self.api_version,
+                               http=http_authorized, cache_discovery=False)
+        return self._conn
+
+    def get_instance(self, project_id, instance):
+        """
+        Retrieves a resource containing information about a Cloud SQL instance.
+
+        :param project_id: Project ID of the project that contains the instance.
+        :type project_id: str
+        :param instance: Database instance ID. This does not include the project ID.
+        :type instance: str
+        :return: A Cloud SQL instance resource.
+        :rtype: dict
+        """
+        return self.get_conn().instances().get(
+            project=project_id,
+            instance=instance
+        ).execute(num_retries=NUM_RETRIES)
+
+    def create_instance(self, project_id, body):
+        """
+        Creates a new Cloud SQL instance.
+
+        :param project_id: Project ID of the project to which the newly created
+            Cloud SQL instances should belong.
+        :type project_id: str
+        :param body: Body required by the Cloud SQL insert API, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert#request-body
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().instances().insert(
+            project=project_id,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, operation_name)
+
+    def patch_instance(self, project_id, body, instance):
+        """
+        Updates settings of a Cloud SQL instance.
+
+        Caution: This is not a partial update, so you must include values for
+        all the settings that you want to retain.
+
+        :param project_id: Project ID of the project that contains the instance.
+        :type project_id: str
+        :param body: Body required by the Cloud SQL patch API, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
+        :type body: dict
+        :param instance: Cloud SQL instance ID. This does not include the project ID.
+        :type instance: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().instances().patch(
+            project=project_id,
+            instance=instance,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, operation_name)
+
+    def delete_instance(self, project_id, instance):
+        """
+        Deletes a Cloud SQL instance.
+
+        :param project_id: Project ID of the project that contains the instance.
+        :type project_id: str
+        :param instance: Cloud SQL instance ID. This does not include the project ID.
+        :type instance: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().instances().delete(
+            project=project_id,
+            instance=instance,
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project_id, operation_name)
+
+    def _wait_for_operation_to_complete(self, project_id, operation_name):
+        """
+        Waits for the named operation to complete - checks status of the
+        asynchronous call.
+
+        :param project_id: Project ID of the project that contains the instance.
+        :type project_id: str
+        :param operation_name: name of the operation
+        :type operation_name: str
+        :return: response returned by the operation
+        :rtype: dict
+        """
+        service = self.get_conn()
+        while True:
+            operation_response = service.operations().get(
+                project=project_id,
+                operation=operation_name,
+            ).execute(num_retries=NUM_RETRIES)
+            if operation_response.get("status") == CloudSqlOperationStatus.DONE:
+                error = operation_response.get("error")
+                if error:
+                    # Extracting the errors list as string and trimming square braces
+                    error_msg = str(error.get("errors"))[1:-1]
+                    raise AirflowException(error_msg)
+                # No meaningful info to return from the response in case of success
+                return True
+            time.sleep(TIME_TO_SLEEP_IN_SECONDS)
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
new file mode 100644
index 0000000000000..0ba7a300c9e41
--- /dev/null
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -0,0 +1,297 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from googleapiclient.errors import HttpError
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook
+from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+SETTINGS = 'settings'
+SETTINGS_VERSION = 'settingsVersion'
+
+CLOUD_SQL_VALIDATION = [
+    dict(name="name", allow_empty=False),
+    dict(name="settings", type="dict", fields=[
+        dict(name="tier", allow_empty=False),
+        dict(name="backupConfiguration", type="dict", fields=[
+            dict(name="binaryLogEnabled", optional=True),
+            dict(name="enabled", optional=True),
+            dict(name="replicationLogArchivingEnabled", optional=True),
+            dict(name="startTime", allow_empty=False, optional=True)
+        ], optional=True),
+        dict(name="activationPolicy", allow_empty=False, optional=True),
+        dict(name="authorizedGaeApplications", type="list", optional=True),
+        dict(name="crashSafeReplicationEnabled", optional=True),
+        dict(name="dataDiskSizeGb", optional=True),
+        dict(name="dataDiskType", allow_empty=False, optional=True),
+        dict(name="databaseFlags", type="list", optional=True),
+        dict(name="ipConfiguration", type="dict", fields=[
+            dict(name="authorizedNetworks", type="list", fields=[
+                dict(name="expirationTime", optional=True),
+                dict(name="name", allow_empty=False, optional=True),
+                dict(name="value", allow_empty=False, optional=True)
+            ], optional=True),
+            dict(name="ipv4Enabled", optional=True),
+            dict(name="privateNetwork", allow_empty=False, optional=True),
+            dict(name="requireSsl", optional=True),
+        ], optional=True),
+        dict(name="locationPreference", type="dict", fields=[
+            dict(name="followGaeApplication", allow_empty=False, optional=True),
+            dict(name="zone", allow_empty=False, optional=True),
+        ], optional=True),
+        dict(name="maintenanceWindow", type="dict", fields=[
+            dict(name="hour", optional=True),
+            dict(name="day", optional=True),
+            dict(name="updateTrack", allow_empty=False, optional=True),
+        ], optional=True),
+        dict(name="pricingPlan", allow_empty=False, optional=True),
+        dict(name="replicationType", allow_empty=False, optional=True),
+        dict(name="storageAutoResize", optional=True),
+        dict(name="storageAutoResizeLimit", optional=True),
+        dict(name="userLabels", type="dict", optional=True),
+    ]),
+    dict(name="databaseVersion", allow_empty=False, optional=True),
+    dict(name="failoverReplica", type="dict", fields=[
+        dict(name="name", allow_empty=False)
+    ], optional=True),
+    dict(name="masterInstanceName", allow_empty=False, optional=True),
+    dict(name="onPremisesConfiguration", type="dict", optional=True),
+    dict(name="region", allow_empty=False, optional=True),
+    dict(name="replicaConfiguration", type="dict", fields=[
+        dict(name="failoverTarget", optional=True),
+        dict(name="mysqlReplicaConfiguration", type="dict", fields=[
+            dict(name="caCertificate", allow_empty=False, optional=True),
+            dict(name="clientCertificate", allow_empty=False, optional=True),
+            dict(name="clientKey", allow_empty=False, optional=True),
+            dict(name="connectRetryInterval", optional=True),
+            dict(name="dumpFilePath", allow_empty=False, optional=True),
+            dict(name="masterHeartbeatPeriod", optional=True),
+            dict(name="password", allow_empty=False, optional=True),
+            dict(name="sslCipher", allow_empty=False, optional=True),
+            dict(name="username", allow_empty=False, optional=True),
+            dict(name="verifyServerCertificate", optional=True)
+        ], optional=True),
+    ], optional=True)
+]
+
+
+class CloudSqlBaseOperator(BaseOperator):
+    """
+    Abstract base operator for Google Cloud SQL operators to inherit from.
+
+    :param project_id: Project ID of the Google Cloud Platform project to operate it.
+    :type project_id: str
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance = instance
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+        self._hook = CloudSqlHook(gcp_conn_id=self.gcp_conn_id,
+                                  api_version=self.api_version)
+        super(CloudSqlBaseOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance:
+            raise AirflowException("The required parameter 'instance' is empty")
+
+    def _check_if_instance_exists(self, instance):
+        try:
+            return self._hook.get_instance(self.project_id, instance)
+        except HttpError as e:
+            status = e.resp.status
+            if status == 404:
+                return False
+            raise e
+
+    def execute(self, context):
+        pass
+
+    @staticmethod
+    def _get_settings_version(instance):
+        return instance.get(SETTINGS).get(SETTINGS_VERSION)
+
+
+class CloudSqlInstanceCreateOperator(CloudSqlBaseOperator):
+    """
+    Creates a new Cloud SQL instance.
+    If an instance with the same name exists, no action will be taken and
+    the operator will succeed.
+
+    :param project_id: Project ID of the project to which the newly created Cloud SQL
+        instances should belong.
+    :type project_id: str
+    :param body: Body required by the Cloud SQL insert API, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert
+        #request-body
+    :type body: dict
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    :param validate_body: True if body should be validated, False otherwise.
+    :type validate_body: bool
+    """
+    # [START gcp_sql_create_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_create_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 body,
+                 instance,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body = body
+        self.validate_body = validate_body
+        super(CloudSqlInstanceCreateOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceCreateOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+
+    def _validate_body_fields(self):
+        if self.validate_body:
+            GcpBodyFieldValidator(CLOUD_SQL_VALIDATION,
+                                  api_version=self.api_version).validate(self.body)
+
+    def execute(self, context):
+        self._validate_body_fields()
+        if not self._check_if_instance_exists(self.instance):
+            return self._hook.create_instance(self.project_id, self.body)
+        else:
+            self.log.info("Cloud SQL instance with ID {} already exists. "
+                          "Aborting create.".format(self.instance))
+            return True
+
+
+class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
+    """
+    Updates settings of a Cloud SQL instance.
+
+    Caution: This is a partial update, so only included values for the settings will be
+    updated.
+
+    In the request body, supply the relevant portions of an instance resource, according
+    to the rules of patch semantics.
+    https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+
+    :param project_id: Project ID of the project that contains the instance.
+    :type project_id: str
+    :param body: Body required by the Cloud SQL patch API, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
+    :type body: dict
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    # [START gcp_sql_patch_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_patch_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 body,
+                 instance,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 *args, **kwargs):
+        self.body = body
+        super(CloudSqlInstancePatchOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstancePatchOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+
+    def execute(self, context):
+        if not self._check_if_instance_exists(self.instance):
+            raise AirflowException('Cloud SQL instance with ID {} does not exist. '
+                                   'Please specify another instance to patch.'
+                                   .format(self.instance))
+        else:
+            return self._hook.patch_instance(self.project_id, self.body, self.instance)
+
+
+class CloudSqlInstanceDeleteOperator(CloudSqlBaseOperator):
+    """
+    Deletes a Cloud SQL instance.
+
+    :param project_id: Project ID of the project that contains the instance to be deleted.
+    :type project_id: str
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+    # [START gcp_sql_delete_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_delete_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 *args, **kwargs):
+        super(CloudSqlInstanceDeleteOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def execute(self, context):
+        if not self._check_if_instance_exists(self.instance):
+            print("Cloud SQL instance with ID {} does not exist. Aborting delete."
+                  .format(self.instance))
+            return True
+        else:
+            return self._hook.delete_instance(self.project_id, self.instance)
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index 20f72d94b813a..e8b59c855e27c 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -69,17 +69,23 @@
   Each of the fields in the array is then expected (unless marked as optional)
   and validated recursively. If an extra field is present in the dictionary, warning is
   printed in log file (but the validation succeeds - see the Forward-compatibility notes)
+* List fields: (key = "type", value="list"):
+  Field of this type should be a list. Only the type correctness is validated.
+  The contents of a list are not subject to validation.
 * Union fields (key = "type", value="union"): field of this type should contain nested
   fields in form of an array of dicts. One of the fields (and only one) should be
   present (unless the union is marked as optional). If more than one union field is
   present, FieldValidationException is raised. If none of the union fields is
   present - warning is printed in the log (see below Forward-compatibility notes).
+* Fields validated for non-emptiness: (key = "allow_empty") - this applies only to
+  fields the value of which is a string, and it allows to check for non-emptiness of
+  the field (allow_empty=False).
 * Regexp-validated fields: (key = "regexp") - fields of this type are assumed to be
   strings and they are validated with the regexp specified. Remember that the regexps
   should ideally contain ^ at the beginning and $ at the end to make sure that
   the whole field content is validated. Typically such regexp
   validations should be used carefully and sparingly (see Forward-compatibility
-  notes below). Most of regexp validation should be at most r'^.+$'.
+  notes below).
 * Custom-validated fields: (key = "custom_validation") - fields of this type are validated
   using method specified via custom_validation field. Any exception thrown in the custom
   validation will be turned into FieldValidationException and will cause validation to
@@ -130,7 +136,7 @@
 
 from airflow import LoggingMixin, AirflowException
 
-COMPOSITE_FIELD_TYPES = ['union', 'dict']
+COMPOSITE_FIELD_TYPES = ['union', 'dict', 'list']
 
 
 class GcpFieldValidationException(AirflowException):
@@ -158,8 +164,8 @@ def _int_greater_than_zero(value):
 
 
 EXAMPLE_VALIDATION_SPECIFICATION = [
-    dict(name="name", regexp="^.+$"),
-    dict(name="description", regexp="^.+$", optional=True),
+    dict(name="name", allow_empty=False),
+    dict(name="description", allow_empty=False, optional=True),
     dict(name="availableMemoryMb", custom_validation=_int_greater_than_zero,
          optional=True),
     dict(name="labels", optional=True, type="dict"),
@@ -202,7 +208,7 @@ def _get_field_name_with_parent(field_name, parent):
 
     @staticmethod
     def _sanity_checks(children_validation_specs, field_type, full_field_path,
-                       regexp, custom_validation, value):
+                       regexp, allow_empty, custom_validation, value):
         # type: (dict, str, str, str, function, object) -> None
         if value is None and field_type != 'union':
             raise GcpFieldValidationException(
@@ -213,6 +219,11 @@ def _sanity_checks(children_validation_specs, field_type, full_field_path,
                 "The validation specification entry '{}' has both type and regexp. "
                 "The regexp is only allowed without type (i.e. assume type is 'str' "
                 "that can be validated with regexp)".format(full_field_path))
+        if allow_empty is not None and field_type:
+            raise GcpValidationSpecificationException(
+                "The validation specification entry '{}' has both type and allow_empty. "
+                "The allow_empty is only allowed without type (i.e. assume type is 'str' "
+                "that can be validated with allow_empty)".format(full_field_path))
         if children_validation_specs and field_type not in COMPOSITE_FIELD_TYPES:
             raise GcpValidationSpecificationException(
                 "Nested fields are specified in field '{}' of type '{}'. "
@@ -234,6 +245,14 @@ def _validate_regexp(full_field_path, regexp, value):
                 "specification regexp: '{}'.".
                 format(full_field_path, value, regexp))
 
+    @staticmethod
+    def _validate_is_empty(full_field_path, value):
+        # type: (str, str) -> None
+        if not value:
+            raise GcpFieldValidationException(
+                "The body field '{}' can't be empty. Please provide a value."
+                .format(full_field_path, value))
+
     def _validate_dict(self, children_validation_specs, full_field_path, value):
         # type: (dict, str, dict) -> None
         for child_validation_spec in children_validation_specs:
@@ -306,6 +325,7 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
         field_type = validation_spec.get('type')
         optional = validation_spec.get('optional')
         regexp = validation_spec.get('regexp')
+        allow_empty = validation_spec.get('allow_empty')
         children_validation_specs = validation_spec.get('fields')
         required_api_version = validation_spec.get('api_version')
         custom_validation = validation_spec.get('custom_validation')
@@ -332,15 +352,18 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                             field_type=field_type,
                             full_field_path=full_field_path,
                             regexp=regexp,
+                            allow_empty=allow_empty,
                             custom_validation=custom_validation,
                             value=value)
 
+        if allow_empty is False:
+            self._validate_is_empty(full_field_path, value)
         if regexp:
             self._validate_regexp(full_field_path, regexp, value)
         elif field_type == 'dict':
             if not isinstance(value, dict):
                 raise GcpFieldValidationException(
-                    "The field '{}' should be dictionary type according to "
+                    "The field '{}' should be of dictionary type according to the "
                     "specification '{}' but it is '{}'".
                     format(full_field_path, validation_spec, value))
             if children_validation_specs is None:
@@ -359,6 +382,12 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                     "nested field defined.".format(full_field_path, validation_spec))
             self._validate_union(children_validation_specs, full_field_path,
                                  dictionary_to_validate)
+        elif field_type == 'list':
+            if not isinstance(value, list):
+                raise GcpFieldValidationException(
+                    "The field '{}' should be of list type according to the "
+                    "specification '{}' but it is '{}'".
+                    format(full_field_path, validation_spec, value))
         elif custom_validation:
             try:
                 custom_validation(value)
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 6138d5eca71e1..025274a5a41ae 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -283,3 +283,155 @@ See `Adding the IAM service agent user role to the runtime service <https://clou
 If the source code for your function is in Google Source Repository, make sure that
 your service account has the Source Repository Viewer role so that the source code
 can be downloaded if necessary.
+
+CloudSqlInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Deletes a Cloud SQL instance in Google Cloud Platform.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_delete]
+    :end-before: [END howto_operator_cloudsql_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_delete_template_fields]
+  :end-before: [END gcp_sql_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for delete
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
+
+.. _CloudSqlInstanceCreateOperator:
+
+CloudSqlInstanceCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new Cloud SQL instance in Google Cloud Platform.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`.
+
+If an instance with the same name exists, no action will be taken and the operator
+will succeed.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Example body defining the instance:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_body]
+    :end-before: [END howto_operator_cloudsql_create_body]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_create]
+    :end-before: [END howto_operator_cloudsql_create]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_create_template_fields]
+  :end-before: [END gcp_sql_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for insert <https://cloud.google
+.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
+
+
+.. _CloudSqlInstancePatchOperator:
+
+CloudSqlInstancePatchOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Updates settings of a Cloud SQL instance in Google Cloud Platform (partial update).
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator`.
+
+This is a partial update, so only values for the settings specified in the body
+will be set / updated. The rest of the existing instance's configuration will remain
+unchanged.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Example body defining the instance:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_patch_body]
+    :end-before: [END howto_operator_cloudsql_patch_body]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_patch]
+    :end-before: [END howto_operator_cloudsql_patch]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_patch_template_fields]
+  :end-before: [END gcp_sql_patch_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for patch <https://cloud.google
+.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
diff --git a/docs/integration.rst b/docs/integration.rst
index cd63d60b64c95..e72f687151de5 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -439,6 +439,43 @@ BigQueryHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
     :members:
 
+Cloud SQL
+'''''''''
+
+Cloud SQL Operators
+"""""""""""""""""""
+
+- :ref:`CloudSqlInstanceDeleteOperator` : delete a Cloud SQL instance.
+- :ref:`CloudSqlInstanceCreateOperator` : create a new Cloud SQL instance.
+- :ref:`CloudSqlInstancePatchOperator` : patch a Cloud SQL instance.
+
+.. CloudSqlInstanceDeleteOperator:
+
+CloudSqlInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
+
+.. CloudSqlInstanceCreateOperator:
+
+CloudSqlInstanceCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
+
+.. CloudSqlInstancePatchOperator:
+
+CloudSqlInstancePatchOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
+
+Cloud SQL Hook
+""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
+    :members:
+
 Compute Engine
 ''''''''''''''
 
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
index 4192560dd984c..46d599bf7d35f 100644
--- a/tests/contrib/operators/test_gcp_function_operator.py
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -344,7 +344,7 @@ def test_invalid_field_values(self, key, value, message, mock_hook):
          "Parameter 'sourceUploadUrl' is empty in the body and argument "
          "'zip_path' is missing or empty."),
         ({'sourceArchiveUrl': 'gs://adasda', 'sourceRepository': ''},
-         "The field 'source_code.sourceRepository' should be dictionary type"),
+         "The field 'source_code.sourceRepository' should be of dictionary type"),
         ({'sourceUploadUrl': '', 'sourceRepository': ''},
          "Parameter 'sourceUploadUrl' is empty in the body and argument 'zip_path' "
          "is missing or empty."),
@@ -360,7 +360,7 @@ def test_invalid_field_values(self, key, value, message, mock_hook):
         ({'sourceUploadUrl': ''}, "Parameter 'sourceUploadUrl' is empty in the body "
                                   "and argument 'zip_path' is missing or empty."),
         ({'sourceRepository': ''}, "The field 'source_code.sourceRepository' "
-                                   "should be dictionary type"),
+                                   "should be of dictionary type"),
         ({'sourceRepository': {}}, "The required body field "
                                    "'source_code.sourceRepository.url' is missing"),
         ({'sourceRepository': {'url': ''}},
@@ -452,7 +452,7 @@ def test_valid_source_code_union_field(self, source_code, mock_hook):
                            'service': 'service_name',
                            'failurePolicy': {'retry': ''}}},
          "The field 'trigger.eventTrigger.failurePolicy.retry' "
-         "should be dictionary type")
+         "should be of dictionary type")
     ]
     )
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
new file mode 100644
index 0000000000000..245631808a223
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -0,0 +1,314 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import AirflowException
+from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
+    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PROJECT_ID = "project-id"
+INSTANCE_NAME = "test-name"
+CREATE_BODY = {
+    "name": INSTANCE_NAME,
+    "settings": {
+        "tier": "db-n1-standard-1",
+        "backupConfiguration": {
+            "binaryLogEnabled": True,
+            "enabled": True,
+            "replicationLogArchivingEnabled": True,
+            "startTime": "05:00"
+        },
+        "activationPolicy": "ALWAYS",
+        "authorizedGaeApplications": [],
+        "crashSafeReplicationEnabled": True,
+        "dataDiskSizeGb": 30,
+        "dataDiskType": "PD_SSD",
+        "databaseFlags": [],
+        "ipConfiguration": {
+            "ipv4Enabled": True,
+            "authorizedNetworks": [
+                {
+                    "value": "192.168.100.0/24",
+                    "name": "network1",
+                    "expirationTime": "2012-11-15T16:19:00.094Z"
+                },
+            ],
+            "privateNetwork": "/vpc/resource/link",
+            "requireSsl": True
+        },
+        "locationPreference": {
+            "zone": "europe-west4-a",
+            "followGaeApplication": "/app/engine/application/to/follow"
+        },
+        "maintenanceWindow": {
+            "hour": 5,
+            "day": 7,
+            "updateTrack": "canary"
+        },
+        "pricingPlan": "PER_USE",
+        "replicationType": "ASYNCHRONOUS",
+        "storageAutoResize": False,
+        "storageAutoResizeLimit": 0,
+        "userLabels": {
+            "my-key": "my-value"
+        }
+    },
+    "databaseVersion": "MYSQL_5_7",
+    "failoverReplica": {
+        "name": "replica-1"
+    },
+    "masterInstanceName": "master-instance-1",
+    "onPremisesConfiguration": {},
+    "region": "europe-west4",
+    "replicaConfiguration": {
+        "mysqlReplicaConfiguration": {
+            "caCertificate": "cert-pem",
+            "clientCertificate": "cert-pem",
+            "clientKey": "cert-pem",
+            "connectRetryInterval": 30,
+            "dumpFilePath": "/path/to/dump",
+            "masterHeartbeatPeriod": 100,
+            "password": "secret_pass",
+            "sslCipher": "list-of-ciphers",
+            "username": "user",
+            "verifyServerCertificate": True
+        },
+    }
+}
+PATCH_BODY = {
+    "name": INSTANCE_NAME,
+    "settings": {
+        "tier": "db-n1-standard-2",
+        "dataDiskType": "PD_HDD"
+    },
+    "region": "europe-west4"
+}
+
+
+class CloudSqlTest(unittest.TestCase):
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceCreateOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_create(self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = False
+        mock_hook.return_value.create_instance.return_value = True
+        op = CloudSqlInstanceCreateOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=CREATE_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_called_once_with(
+            PROJECT_ID, CREATE_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceCreateOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_create_idempotent(self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = True
+        mock_hook.return_value.create_instance.return_value = True
+        op = CloudSqlInstanceCreateOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=CREATE_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_not_called()
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_create_should_throw_ex_when_empty_project_id(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceCreateOperator(
+                project_id="",
+                body=CREATE_BODY,
+                instance=INSTANCE_NAME,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'project_id' is empty", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_create_should_throw_ex_when_empty_body(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceCreateOperator(
+                project_id=PROJECT_ID,
+                body={},
+                instance=INSTANCE_NAME,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'body' is empty", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_create_should_throw_ex_when_empty_instance(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceCreateOperator(
+                project_id=PROJECT_ID,
+                body=CREATE_BODY,
+                instance="",
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'instance' is empty", str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_create_should_validate_list_type(self, mock_hook):
+        wrong_list_type_body = {
+            "name": INSTANCE_NAME,
+            "settings": {
+                "tier": "db-n1-standard-1",
+                "ipConfiguration": {
+                    "authorizedNetworks": {}  # Should be a list, not a dict.
+                                              # Testing if the validation catches this.
+                }
+            }
+        }
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceCreateOperator(
+                project_id=PROJECT_ID,
+                body=wrong_list_type_body,
+                instance=INSTANCE_NAME,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The field 'settings.ipConfiguration.authorizedNetworks' "
+                      "should be of list type according to the specification", str(err))
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_create_should_validate_non_empty_fields(self, mock_hook):
+        empty_tier_body = {
+            "name": INSTANCE_NAME,
+            "settings": {
+                "tier": "",  # Field can't be empty (defined in CLOUD_SQL_VALIDATION).
+                             # Testing if the validation catches this.
+            }
+        }
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceCreateOperator(
+                project_id=PROJECT_ID,
+                body=empty_tier_body,
+                instance=INSTANCE_NAME,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The body field 'settings.tier' can't be empty. "
+                      "Please provide a value.", str(err))
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_patch(self, mock_hook):
+        mock_hook.return_value.patch_instance.return_value = True
+        op = CloudSqlInstancePatchOperator(
+            project_id=PROJECT_ID,
+            body=PATCH_BODY,
+            instance=INSTANCE_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_instance.assert_called_once_with(
+            PROJECT_ID, PATCH_BODY, INSTANCE_NAME
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstancePatchOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_patch_should_bubble_up_ex_if_not_exists(self, mock_hook,
+                                                              _check_if_instance_exists):
+        _check_if_instance_exists.return_value = False
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstancePatchOperator(
+                project_id=PROJECT_ID,
+                body=PATCH_BODY,
+                instance=INSTANCE_NAME,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn('specify another instance to patch', str(err))
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_instance.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDeleteOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_delete(self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = True
+        op = CloudSqlInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME
+        )
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDeleteOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_delete_should_abort_and_succeed_if_not_exists(
+            self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = False
+        op = CloudSqlInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_not_called()

From ae39df5101e4e6f2c22568d87c1a42a87658eba8 Mon Sep 17 00:00:00 2001
From: yangaws <31293788+yangaws@users.noreply.github.com>
Date: Thu, 1 Nov 2018 13:31:59 -0700
Subject: [PATCH 141/808] [AIRFLOW-2524] Update SageMaker hook and operators
 (#4091)

This re-works the SageMaker functionality in Airflow to be more complete, and more useful for the kinds of operations that SageMaker supports.

We removed some files and operators here, but these were only added after the last release so we don't need to worry about any sort of back-compat.
---
 airflow/contrib/hooks/aws_hook.py             |  24 +-
 airflow/contrib/hooks/sagemaker_hook.py       | 825 ++++++++++++++----
 .../operators/sagemaker_base_operator.py      | 100 +++
 .../sagemaker_create_training_job_operator.py | 119 ---
 ...sagemaker_create_transform_job_operator.py | 132 ---
 .../sagemaker_create_tuning_job_operator.py   | 121 ---
 .../operators/sagemaker_training_operator.py  |  97 ++
 .../operators/sagemaker_transform_operator.py | 112 +++
 .../operators/sagemaker_tuning_operator.py    |  97 ++
 .../contrib/sensors/sagemaker_base_sensor.py  |  14 +-
 .../sensors/sagemaker_training_sensor.py      |  58 +-
 .../sensors/sagemaker_transform_sensor.py     |   9 +-
 .../sensors/sagemaker_tuning_sensor.py        |  11 +-
 airflow/hooks/S3_hook.py                      | 141 +++
 docs/code.rst                                 |   9 +
 tests/contrib/hooks/test_aws_hook.py          |  32 +-
 tests/contrib/hooks/test_sagemaker_hook.py    | 748 +++++++++-------
 .../operators/test_sagemaker_base_operator.py |  84 ++
 ..._sagemaker_create_training_job_operator.py | 141 ---
 .../test_sagemaker_training_operator.py       | 134 +++
 .../test_sagemaker_transform_operator.py      | 136 +++
 ...r.py => test_sagemaker_tuning_operator.py} |  67 +-
 .../sensors/test_sagemaker_base_sensor.py     |  12 +-
 .../sensors/test_sagemaker_training_sensor.py | 104 ++-
 .../test_sagemaker_transform_sensor.py        |  36 +-
 .../sensors/test_sagemaker_tuning_sensor.py   |  39 +-
 tests/hooks/test_s3_hook.py                   |  41 +
 ...sagemaker_create_transform_job_operator.py | 140 ---
 28 files changed, 2279 insertions(+), 1304 deletions(-)
 create mode 100644 airflow/contrib/operators/sagemaker_base_operator.py
 delete mode 100644 airflow/contrib/operators/sagemaker_create_training_job_operator.py
 delete mode 100644 airflow/contrib/operators/sagemaker_create_transform_job_operator.py
 delete mode 100644 airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
 create mode 100644 airflow/contrib/operators/sagemaker_training_operator.py
 create mode 100644 airflow/contrib/operators/sagemaker_transform_operator.py
 create mode 100644 airflow/contrib/operators/sagemaker_tuning_operator.py
 create mode 100644 tests/contrib/operators/test_sagemaker_base_operator.py
 delete mode 100644 tests/contrib/operators/test_sagemaker_create_training_job_operator.py
 create mode 100644 tests/contrib/operators/test_sagemaker_training_operator.py
 create mode 100644 tests/contrib/operators/test_sagemaker_transform_operator.py
 rename tests/contrib/operators/{test_sagemaker_create_tuning_job_operator.py => test_sagemaker_tuning_operator.py} (71%)
 delete mode 100644 tests/operators/test_sagemaker_create_transform_job_operator.py

diff --git a/airflow/contrib/hooks/aws_hook.py b/airflow/contrib/hooks/aws_hook.py
index dc945e3ada091..44f33d49ab9e4 100644
--- a/airflow/contrib/hooks/aws_hook.py
+++ b/airflow/contrib/hooks/aws_hook.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-
 import boto3
 import configparser
 import logging
@@ -163,15 +162,17 @@ def _get_credentials(self, region_name):
             aws_session_token=aws_session_token,
             region_name=region_name), endpoint_url
 
-    def get_client_type(self, client_type, region_name=None):
+    def get_client_type(self, client_type, region_name=None, config=None):
         session, endpoint_url = self._get_credentials(region_name)
 
-        return session.client(client_type, endpoint_url=endpoint_url)
+        return session.client(client_type, endpoint_url=endpoint_url,
+                              config=config)
 
-    def get_resource_type(self, resource_type, region_name=None):
+    def get_resource_type(self, resource_type, region_name=None, config=None):
         session, endpoint_url = self._get_credentials(region_name)
 
-        return session.resource(resource_type, endpoint_url=endpoint_url)
+        return session.resource(resource_type, endpoint_url=endpoint_url,
+                                config=config)
 
     def get_session(self, region_name=None):
         """Get the underlying boto3.session."""
@@ -188,3 +189,16 @@ def get_credentials(self, region_name=None):
         # secret key separately can lead to a race condition.
         # See https://stackoverflow.com/a/36291428/8283373
         return session.get_credentials().get_frozen_credentials()
+
+    def expand_role(self, role):
+        """
+        Expand an IAM role name to an IAM role ARN. If role is already an IAM ARN,
+        no change is made.
+
+        :param role: IAM role name or ARN
+        :return: IAM role ARN
+        """
+        if '/' in role:
+            return role
+        else:
+            return self.get_client_type('iam').get_role(RoleName=role)['Role']['Arn']
diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index ebab5d83e4099..823f430db994f 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -16,299 +16,746 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-import copy
+import tarfile
+import tempfile
 import time
+import os
+import collections
+
+import botocore.config
 from botocore.exceptions import ClientError
 
 from airflow.exceptions import AirflowException
 from airflow.contrib.hooks.aws_hook import AwsHook
 from airflow.hooks.S3_hook import S3Hook
+from airflow.utils import timezone
+
+
+class LogState(object):
+    STARTING = 1
+    WAIT_IN_PROGRESS = 2
+    TAILING = 3
+    JOB_COMPLETE = 4
+    COMPLETE = 5
+
+
+# Position is a tuple that includes the last read timestamp and the number of items that were read
+# at that time. This is used to figure out which event to start with on the next read.
+Position = collections.namedtuple('Position', ['timestamp', 'skip'])
+
+
+def argmin(arr, f):
+    """Return the index, i, in arr that minimizes f(arr[i])"""
+    m = None
+    i = None
+    for idx, item in enumerate(arr):
+        if item is not None:
+            if m is None or f(item) < m:
+                m = f(item)
+                i = idx
+    return i
+
+
+def secondary_training_status_changed(current_job_description, prev_job_description):
+    """
+    Returns true if training job's secondary status message has changed.
+
+    :param current_job_description: Current job description, returned from DescribeTrainingJob call.
+    :type current_job_description: dict
+    :param prev_job_description: Previous job description, returned from DescribeTrainingJob call.
+    :type prev_job_description: dict
+
+    :return: Whether the secondary status message of a training job changed or not.
+    """
+    current_secondary_status_transitions = current_job_description.get('SecondaryStatusTransitions')
+    if current_secondary_status_transitions is None or len(current_secondary_status_transitions) == 0:
+        return False
+
+    prev_job_secondary_status_transitions = prev_job_description.get('SecondaryStatusTransitions') \
+        if prev_job_description is not None else None
+
+    last_message = prev_job_secondary_status_transitions[-1]['StatusMessage'] \
+        if prev_job_secondary_status_transitions is not None \
+        and len(prev_job_secondary_status_transitions) > 0 else ''
+
+    message = current_job_description['SecondaryStatusTransitions'][-1]['StatusMessage']
+
+    return message != last_message
+
+
+def secondary_training_status_message(job_description, prev_description):
+    """
+    Returns a string contains start time and the secondary training job status message.
+
+    :param job_description: Returned response from DescribeTrainingJob call
+    :type job_description: dict
+    :param prev_description: Previous job description from DescribeTrainingJob call
+    :type prev_description: dict
+
+    :return: Job status string to be printed.
+    """
+
+    if job_description is None or job_description.get('SecondaryStatusTransitions') is None\
+            or len(job_description.get('SecondaryStatusTransitions')) == 0:
+        return ''
+
+    prev_description_secondary_transitions = prev_description.get('SecondaryStatusTransitions')\
+        if prev_description is not None else None
+    prev_transitions_num = len(prev_description['SecondaryStatusTransitions'])\
+        if prev_description_secondary_transitions is not None else 0
+    current_transitions = job_description['SecondaryStatusTransitions']
+
+    transitions_to_print = current_transitions[-1:] if len(current_transitions) == prev_transitions_num else \
+        current_transitions[prev_transitions_num - len(current_transitions):]
+
+    status_strs = []
+    for transition in transitions_to_print:
+        message = transition['StatusMessage']
+        time_str = timezone.convert_to_utc(job_description['LastModifiedTime']).strftime('%Y-%m-%d %H:%M:%S')
+        status_strs.append('{} {} - {}'.format(time_str, transition['Status'], message))
+
+    return '\n'.join(status_strs)
 
 
 class SageMakerHook(AwsHook):
     """
     Interact with Amazon SageMaker.
-    sagemaker_conn_id is required for using
-    the config stored in db for training/tuning
     """
-    non_terminal_states = {'InProgress', 'Stopping', 'Stopped'}
+    non_terminal_states = {'InProgress', 'Stopping'}
+    endpoint_non_terminal_states = {'Creating', 'Updating', 'SystemUpdating',
+                                    'RollingBack', 'Deleting'}
     failed_states = {'Failed'}
 
     def __init__(self,
-                 sagemaker_conn_id=None,
-                 use_db_config=False,
-                 region_name=None,
-                 check_interval=5,
-                 max_ingestion_time=None,
                  *args, **kwargs):
         super(SageMakerHook, self).__init__(*args, **kwargs)
-        self.sagemaker_conn_id = sagemaker_conn_id
-        self.use_db_config = use_db_config
-        self.region_name = region_name
-        self.check_interval = check_interval
-        self.max_ingestion_time = max_ingestion_time
-        self.conn = self.get_conn()
+        self.s3_hook = S3Hook(aws_conn_id=self.aws_conn_id)
+
+    def tar_and_s3_upload(self, path, key, bucket):
+        """
+        Tar the local file or directory and upload to s3
+
+        :param path: local file or directory
+        :type path: str
+        :param key: s3 key
+        :type key: str
+        :param bucket: s3 bucket
+        :type bucket: str
+        :return: None
+        """
+        with tempfile.TemporaryFile() as temp_file:
+            if os.path.isdir(path):
+                files = [os.path.join(path, name) for name in os.listdir(path)]
+            else:
+                files = [path]
+            with tarfile.open(mode='w:gz', fileobj=temp_file) as tar_file:
+                for f in files:
+                    tar_file.add(f, arcname=os.path.basename(f))
+            temp_file.seek(0)
+            self.s3_hook.load_file_obj(temp_file, key, bucket, replace=True)
+
+    def configure_s3_resources(self, config):
+        """
+        Extract the S3 operations from the configuration and execute them.
 
-    def check_for_url(self, s3url):
+        :param config: config of SageMaker operation
+        :type config: dict
+        :return: dict
+        """
+        s3_operations = config.pop('S3Operations', None)
+
+        if s3_operations is not None:
+            create_bucket_ops = s3_operations.get('S3CreateBucket', [])
+            upload_ops = s3_operations.get('S3Upload', [])
+            for op in create_bucket_ops:
+                self.s3_hook.create_bucket(bucket_name=op['Bucket'])
+            for op in upload_ops:
+                if op['Tar']:
+                    self.tar_and_s3_upload(op['Path'], op['Key'],
+                                           op['Bucket'])
+                else:
+                    self.s3_hook.load_file(op['Path'], op['Key'],
+                                           op['Bucket'])
+
+    def check_s3_url(self, s3url):
         """
-        check if the s3url exists
+        Check if an S3 URL exists
+
         :param s3url: S3 url
         :type s3url:str
         :return: bool
         """
         bucket, key = S3Hook.parse_s3_url(s3url)
-        s3hook = S3Hook(aws_conn_id=self.aws_conn_id)
-        if not s3hook.check_for_bucket(bucket_name=bucket):
+        if not self.s3_hook.check_for_bucket(bucket_name=bucket):
             raise AirflowException(
                 "The input S3 Bucket {} does not exist ".format(bucket))
-        if key and not s3hook.check_for_key(key=key, bucket_name=bucket)\
-           and not s3hook.check_for_prefix(
+        if key and not self.s3_hook.check_for_key(key=key, bucket_name=bucket)\
+           and not self.s3_hook.check_for_prefix(
                 prefix=key, bucket_name=bucket, delimiter='/'):
             # check if s3 key exists in the case user provides a single file
-            # or if s3 prefix exists in the case user provides a prefix for files
+            # or if s3 prefix exists in the case user provides multiple files in
+            # a prefix
             raise AirflowException("The input S3 Key "
                                    "or Prefix {} does not exist in the Bucket {}"
                                    .format(s3url, bucket))
         return True
 
-    def check_valid_training_input(self, training_config):
+    def check_training_config(self, training_config):
         """
-        Run checks before a training starts
+        Check if a training configuration is valid
+
         :param training_config: training_config
         :type training_config: dict
         :return: None
         """
         for channel in training_config['InputDataConfig']:
-            self.check_for_url(channel['DataSource']
-                               ['S3DataSource']['S3Uri'])
+            self.check_s3_url(channel['DataSource']['S3DataSource']['S3Uri'])
 
-    def check_valid_tuning_input(self, tuning_config):
+    def check_tuning_config(self, tuning_config):
         """
-        Run checks before a tuning job starts
+        Check if a tuning configuration is valid
+
         :param tuning_config: tuning_config
         :type tuning_config: dict
         :return: None
         """
         for channel in tuning_config['TrainingJobDefinition']['InputDataConfig']:
-            self.check_for_url(channel['DataSource']
-                               ['S3DataSource']['S3Uri'])
+            self.check_s3_url(channel['DataSource']['S3DataSource']['S3Uri'])
 
-    def check_status(self, non_terminal_states,
-                     failed_state, key,
-                     describe_function, *args):
-        """
-        :param non_terminal_states: the set of non_terminal states
-        :type non_terminal_states: set
-        :param failed_state: the set of failed states
-        :type failed_state: set
-        :param key: the key of the response dict
-        that points to the state
-        :type key: string
-        :param describe_function: the function used to retrieve the status
-        :type describe_function: python callable
-        :param args: the arguments for the function
-        :return: None
+    def get_conn(self):
         """
-        sec = 0
-        running = True
-
-        while running:
-
-            sec = sec + self.check_interval
-
-            if self.max_ingestion_time and sec > self.max_ingestion_time:
-                # ensure that the job gets killed if the max ingestion time is exceeded
-                raise AirflowException("SageMaker job took more than "
-                                       "%s seconds", self.max_ingestion_time)
-
-            time.sleep(self.check_interval)
-            try:
-                response = describe_function(*args)
-                status = response[key]
-                self.log.info("Job still running for %s seconds... "
-                              "current status is %s" % (sec, status))
-            except KeyError:
-                raise AirflowException("Could not get status of the SageMaker job")
-            except ClientError:
-                raise AirflowException("AWS request failed, check log for more info")
+        Establish an AWS connection for SageMaker
 
-            if status in non_terminal_states:
-                running = True
-            elif status in failed_state:
-                raise AirflowException("SageMaker job failed because %s"
-                                       % response['FailureReason'])
-            else:
-                running = False
-
-        self.log.info('SageMaker Job Compeleted')
+        :return: a boto3 SageMaker client
+        """
+        return self.get_client_type('sagemaker')
 
-    def get_conn(self):
+    def get_log_conn(self):
         """
-        Establish an AWS connection
-        :return: a boto3 SageMaker client
+        Establish an AWS connection for retrieving logs during training
+
+        :return: a boto3 CloudWatchLog client
         """
-        return self.get_client_type('sagemaker', region_name=self.region_name)
+        config = botocore.config.Config(retries={'max_attempts': 15})
+        return self.get_client_type('logs', config=config)
 
-    def list_training_job(self, name_contains=None, status_equals=None):
+    def log_stream(self, log_group, stream_name, start_time=0, skip=0):
         """
-        List the training jobs associated with the given input
-        :param name_contains: A string in the training job name
-        :type name_contains: str
-        :param status_equals: 'InProgress'|'Completed'
-        |'Failed'|'Stopping'|'Stopped'
-        :return:dict
+        A generator for log items in a single stream. This will yield all the
+        items that are available at the current moment.
+
+        :param log_group: The name of the log group.
+        :type log_group: str
+        :param stream_name: The name of the specific stream.
+        :type stream_name: str
+        :param start_time: The time stamp value to start reading the logs from (default: 0).
+        :type start_time: int
+        :param skip: The number of log entries to skip at the start (default: 0).
+            This is for when there are multiple entries at the same timestamp.
+        :type skip: int
+        :return:A CloudWatch log event with the following key-value pairs:
+            'timestamp' (int): The time in milliseconds of the event.
+            'message' (str): The log event data.
+            'ingestionTime' (int): The time in milliseconds the event was ingested.
         """
-        return self.conn.list_training_jobs(
-            NameContains=name_contains, StatusEquals=status_equals)
 
-    def list_tuning_job(self, name_contains=None, status_equals=None):
+        next_token = None
+
+        event_count = 1
+        while event_count > 0:
+            if next_token is not None:
+                token_arg = {'nextToken': next_token}
+            else:
+                token_arg = {}
+
+            response = self.get_log_conn().get_log_events(logGroupName=log_group,
+                                                          logStreamName=stream_name,
+                                                          startTime=start_time,
+                                                          startFromHead=True,
+                                                          **token_arg)
+            next_token = response['nextForwardToken']
+            events = response['events']
+            event_count = len(events)
+            if event_count > skip:
+                events = events[skip:]
+                skip = 0
+            else:
+                skip = skip - event_count
+                events = []
+            for ev in events:
+                yield ev
+
+    def multi_stream_iter(self, log_group, streams, positions=None):
         """
-        List the tuning jobs associated with the given input
-        :param name_contains: A string in the training job name
-        :type name_contains: str
-        :param status_equals: 'InProgress'|'Completed'
-        |'Failed'|'Stopping'|'Stopped'
-        :return:dict
+        Iterate over the available events coming from a set of log streams in a single log group
+        interleaving the events from each stream so they're yielded in timestamp order.
+
+        :param log_group: The name of the log group.
+        :type log_group: str
+        :param streams: A list of the log stream names. The position of the stream in this list is
+            the stream number.
+        :type streams: list
+        :param positions: A list of pairs of (timestamp, skip) which represents the last record
+            read from each stream.
+        :type positions: list
+        :return: A tuple of (stream number, cloudwatch log event).
         """
-        return self.conn.list_hyper_parameter_tuning_job(
-            NameContains=name_contains, StatusEquals=status_equals)
+        positions = positions or {s: Position(timestamp=0, skip=0) for s in streams}
+        event_iters = [self.log_stream(log_group, s, positions[s].timestamp, positions[s].skip)
+                       for s in streams]
+        events = [next(s) if s else None for s in event_iters]
+
+        while any(events):
+            i = argmin(events, lambda x: x['timestamp'] if x else 9999999999)
+            yield (i, events[i])
+            try:
+                events[i] = next(event_iters[i])
+            except StopIteration:
+                events[i] = None
 
-    def create_training_job(self, training_job_config, wait_for_completion=True):
+    def create_training_job(self, config, wait_for_completion=True, print_log=True,
+                            check_interval=30, max_ingestion_time=None):
         """
         Create a training job
-        :param training_job_config: the config for training
-        :type training_job_config: dict
+
+        :param config: the config for training
+        :type config: dict
         :param wait_for_completion: if the program should keep running until job finishes
         :type wait_for_completion: bool
-        :return: A dict that contains ARN of the training job.
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: A response to training job creation
         """
-        if self.use_db_config:
-            if not self.sagemaker_conn_id:
-                raise AirflowException("SageMaker connection id must be present to read \
-                                        SageMaker training jobs configuration.")
-            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
-
-            config = copy.deepcopy(sagemaker_conn.extra_dejson)
-            training_job_config.update(config)
 
-        self.check_valid_training_input(training_job_config)
+        self.check_training_config(config)
+
+        response = self.get_conn().create_training_job(**config)
+        if print_log:
+            self.check_training_status_with_log(config['TrainingJobName'],
+                                                self.non_terminal_states,
+                                                self.failed_states,
+                                                wait_for_completion,
+                                                check_interval, max_ingestion_time
+                                                )
+        elif wait_for_completion:
+            describe_response = self.check_status(config['TrainingJobName'],
+                                                  'TrainingJobStatus',
+                                                  self.describe_training_job,
+                                                  check_interval, max_ingestion_time
+                                                  )
+
+            billable_time = \
+                (describe_response['TrainingEndTime'] - describe_response['TrainingStartTime']) * \
+                describe_response['ResourceConfig']['InstanceCount']
+            self.log.info('Billable seconds:{}'.format(int(billable_time.total_seconds()) + 1))
 
-        response = self.conn.create_training_job(
-            **training_job_config)
-        if wait_for_completion:
-            self.check_status(SageMakerHook.non_terminal_states,
-                              SageMakerHook.failed_states,
-                              'TrainingJobStatus',
-                              self.describe_training_job,
-                              training_job_config['TrainingJobName'])
         return response
 
-    def create_tuning_job(self, tuning_job_config, wait_for_completion=True):
+    def create_tuning_job(self, config, wait_for_completion=True,
+                          check_interval=30, max_ingestion_time=None):
         """
         Create a tuning job
-        :param tuning_job_config: the config for tuning
-        :type tuning_job_config: dict
+
+        :param config: the config for tuning
+        :type config: dict
         :param wait_for_completion: if the program should keep running until job finishes
         :param wait_for_completion: bool
-        :return: A dict that contains ARN of the tuning job.
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: A response to tuning job creation
         """
-        if self.use_db_config:
-            if not self.sagemaker_conn_id:
-                raise AirflowException(
-                    "SageMaker connection id must be present to \
-                    read SageMaker tunning job configuration.")
-
-            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
 
-            config = sagemaker_conn.extra_dejson.copy()
-            tuning_job_config.update(config)
+        self.check_tuning_config(config)
 
-        self.check_valid_tuning_input(tuning_job_config)
-
-        response = self.conn.create_hyper_parameter_tuning_job(
-            **tuning_job_config)
+        response = self.get_conn().create_hyper_parameter_tuning_job(**config)
         if wait_for_completion:
-            self.check_status(SageMakerHook.non_terminal_states,
-                              SageMakerHook.failed_states,
+            self.check_status(config['HyperParameterTuningJobName'],
                               'HyperParameterTuningJobStatus',
                               self.describe_tuning_job,
-                              tuning_job_config['HyperParameterTuningJobName'])
+                              check_interval, max_ingestion_time
+                              )
         return response
 
-    def create_transform_job(self, transform_job_config, wait_for_completion=True):
+    def create_transform_job(self, config, wait_for_completion=True,
+                             check_interval=30, max_ingestion_time=None):
         """
         Create a transform job
-        :param transform_job_config: the config for transform job
-        :type transform_job_config: dict
-        :param wait_for_completion:
-        if the program should keep running until job finishes
+
+        :param config: the config for transform job
+        :type config: dict
+        :param wait_for_completion: if the program should keep running until job finishes
         :type wait_for_completion: bool
-        :return: A dict that contains ARN of the transform job.
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: A response to transform job creation
         """
-        if self.use_db_config:
-            if not self.sagemaker_conn_id:
-                raise AirflowException(
-                    "SageMaker connection id must be present to \
-                    read SageMaker transform job configuration.")
 
-            sagemaker_conn = self.get_connection(self.sagemaker_conn_id)
+        self.check_s3_url(config['TransformInput']['DataSource']['S3DataSource']['S3Uri'])
 
-            config = sagemaker_conn.extra_dejson.copy()
-            transform_job_config.update(config)
-
-        self.check_for_url(transform_job_config
-                           ['TransformInput']['DataSource']
-                           ['S3DataSource']['S3Uri'])
-
-        response = self.conn.create_transform_job(
-            **transform_job_config)
+        response = self.get_conn().create_transform_job(**config)
         if wait_for_completion:
-            self.check_status(SageMakerHook.non_terminal_states,
-                              SageMakerHook.failed_states,
+            self.check_status(config['TransformJobName'],
                               'TransformJobStatus',
                               self.describe_transform_job,
-                              transform_job_config['TransformJobName'])
+                              check_interval, max_ingestion_time
+                              )
         return response
 
-    def create_model(self, model_config):
+    def create_model(self, config):
         """
         Create a model job
-        :param model_config: the config for model
-        :type model_config: dict
-        :return: A dict that contains ARN of the model.
+
+        :param config: the config for model
+        :type config: dict
+        :return: A response to model creation
         """
 
-        return self.conn.create_model(
-            **model_config)
+        return self.get_conn().create_model(**config)
+
+    def create_endpoint_config(self, config):
+        """
+        Create an endpoint config
 
-    def describe_training_job(self, training_job_name):
+        :param config: the config for endpoint-config
+        :type config: dict
+        :return: A response to endpoint config creation
         """
-        :param training_job_name: the name of the training job
-        :type training_job_name: string
-        Return the training job info associated with the current job_name
+
+        return self.get_conn().create_endpoint_config(**config)
+
+    def create_endpoint(self, config, wait_for_completion=True,
+                        check_interval=30, max_ingestion_time=None):
+        """
+        Create an endpoint
+
+        :param config: the config for endpoint
+        :type config: dict
+        :param wait_for_completion: if the program should keep running until job finishes
+        :type wait_for_completion: bool
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: A response to endpoint creation
+        """
+
+        response = self.get_conn().create_endpoint(**config)
+        if wait_for_completion:
+            self.check_status(config['EndpointName'],
+                              'EndpointStatus',
+                              self.describe_endpoint,
+                              check_interval, max_ingestion_time,
+                              non_terminal_states=self.endpoint_non_terminal_states
+                              )
+        return response
+
+    def update_endpoint(self, config, wait_for_completion=True,
+                        check_interval=30, max_ingestion_time=None):
+        """
+        Update an endpoint
+
+        :param config: the config for endpoint
+        :type config: dict
+        :param wait_for_completion: if the program should keep running until job finishes
+        :type wait_for_completion: bool
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: A response to endpoint update
+        """
+
+        response = self.get_conn().update_endpoint(**config)
+        if wait_for_completion:
+            self.check_status(config['EndpointName'],
+                              'EndpointStatus',
+                              self.describe_endpoint,
+                              check_interval, max_ingestion_time,
+                              non_terminal_states=self.endpoint_non_terminal_states
+                              )
+        return response
+
+    def describe_training_job(self, name):
+        """
+        Return the training job info associated with the name
+
+        :param name: the name of the training job
+        :type name: str
         :return: A dict contains all the training job info
         """
-        return self.conn\
-                   .describe_training_job(TrainingJobName=training_job_name)
 
-    def describe_tuning_job(self, tuning_job_name):
+        return self.get_conn().describe_training_job(TrainingJobName=name)
+
+    def describe_training_job_with_log(self, job_name, positions, stream_names,
+                                       instance_count, state, last_description,
+                                       last_describe_job_call):
+        """
+        Return the training job info associated with job_name and print CloudWatch logs
+        """
+        log_group = '/aws/sagemaker/TrainingJobs'
+
+        if len(stream_names) < instance_count:
+            # Log streams are created whenever a container starts writing to stdout/err, so this list
+            # may be dynamic until we have a stream for every instance.
+            logs_conn = self.get_log_conn()
+            try:
+                streams = logs_conn.describe_log_streams(
+                    logGroupName=log_group,
+                    logStreamNamePrefix=job_name + '/',
+                    orderBy='LogStreamName',
+                    limit=instance_count
+                )
+                stream_names = [s['logStreamName'] for s in streams['logStreams']]
+                positions.update([(s, Position(timestamp=0, skip=0))
+                                  for s in stream_names if s not in positions])
+            except logs_conn.exceptions.ResourceNotFoundException:
+                # On the very first training job run on an account, there's no log group until
+                # the container starts logging, so ignore any errors thrown about that
+                pass
+
+        if len(stream_names) > 0:
+            for idx, event in self.multi_stream_iter(log_group, stream_names, positions):
+                self.log.info(event['message'])
+                ts, count = positions[stream_names[idx]]
+                if event['timestamp'] == ts:
+                    positions[stream_names[idx]] = Position(timestamp=ts, skip=count + 1)
+                else:
+                    positions[stream_names[idx]] = Position(timestamp=event['timestamp'], skip=1)
+
+        if state == LogState.COMPLETE:
+            return state, last_description, last_describe_job_call
+
+        if state == LogState.JOB_COMPLETE:
+            state = LogState.COMPLETE
+        elif time.time() - last_describe_job_call >= 30:
+            description = self.describe_training_job(job_name)
+            last_describe_job_call = time.time()
+
+            if secondary_training_status_changed(description, last_description):
+                self.log.info(secondary_training_status_message(description, last_description))
+                last_description = description
+
+            status = description['TrainingJobStatus']
+
+            if status not in self.non_terminal_states:
+                state = LogState.JOB_COMPLETE
+        return state, last_description, last_describe_job_call
+
+    def describe_tuning_job(self, name):
         """
-        :param tuning_job_name: the name of the tuning job
-        :type tuning_job_name: string
-        Return the tuning job info associated with the current job_name
+        Return the tuning job info associated with the name
+
+        :param name: the name of the tuning job
+        :type name: string
         :return: A dict contains all the tuning job info
         """
-        return self.conn\
-            .describe_hyper_parameter_tuning_job(
-                HyperParameterTuningJobName=tuning_job_name)
 
-    def describe_transform_job(self, transform_job_name):
+        return self.get_conn().describe_hyper_parameter_tuning_job(HyperParameterTuningJobName=name)
+
+    def describe_model(self, name):
+        """
+        Return the SageMaker model info associated with the name
+
+        :param name: the name of the SageMaker model
+        :type name: string
+        :return: A dict contains all the model info
+        """
+
+        return self.get_conn().describe_model(ModelName=name)
+
+    def describe_transform_job(self, name):
         """
-        :param transform_job_name: the name of the transform job
-        :type transform_job_name: string
-        Return the transform job info associated with the current job_name
+        Return the transform job info associated with the name
+
+        :param name: the name of the transform job
+        :type name: string
         :return: A dict contains all the transform job info
         """
-        return self.conn\
-            .describe_transform_job(
-                TransformJobName=transform_job_name)
+
+        return self.get_conn().describe_transform_job(TransformJobName=name)
+
+    def describe_endpoint_config(self, name):
+        """
+        Return the endpoint config info associated with the name
+
+        :param name: the name of the endpoint config
+        :type name: string
+        :return: A dict contains all the endpoint config info
+        """
+
+        return self.get_conn().describe_endpoint_config(EndpointConfigName=name)
+
+    def describe_endpoint(self, name):
+        """
+        :param name: the name of the endpoint
+        :type name: string
+        :return: A dict contains all the endpoint info
+        """
+
+        return self.get_conn().describe_endpoint(EndpointName=name)
+
+    def check_status(self, job_name, key,
+                     describe_function, check_interval,
+                     max_ingestion_time,
+                     non_terminal_states=None):
+        """
+        Check status of a SageMaker job
+
+        :param job_name: name of the job to check status
+        :type job_name: str
+        :param key: the key of the response dict
+            that points to the state
+        :type key: str
+        :param describe_function: the function used to retrieve the status
+        :type describe_function: python callable
+        :param args: the arguments for the function
+        :param check_interval: the time interval in seconds which the operator
+            will check the status of any SageMaker job
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :param non_terminal_states: the set of nonterminal states
+        :type non_terminal_states: set
+        :return: response of describe call after job is done
+        """
+        if not non_terminal_states:
+            non_terminal_states = self.non_terminal_states
+
+        sec = 0
+        running = True
+
+        while running:
+            time.sleep(check_interval)
+            sec = sec + check_interval
+
+            try:
+                response = describe_function(job_name)
+                status = response[key]
+                self.log.info('Job still running for %s seconds... '
+                              'current status is %s' % (sec, status))
+            except KeyError:
+                raise AirflowException('Could not get status of the SageMaker job')
+            except ClientError:
+                raise AirflowException('AWS request failed, check logs for more info')
+
+            if status in non_terminal_states:
+                running = True
+            elif status in self.failed_states:
+                raise AirflowException('SageMaker job failed because %s' % response['FailureReason'])
+            else:
+                running = False
+
+            if max_ingestion_time and sec > max_ingestion_time:
+                # ensure that the job gets killed if the max ingestion time is exceeded
+                raise AirflowException('SageMaker job took more than %s seconds', max_ingestion_time)
+
+        self.log.info('SageMaker Job Compeleted')
+        response = describe_function(job_name)
+        return response
+
+    def check_training_status_with_log(self, job_name, non_terminal_states, failed_states,
+                                       wait_for_completion, check_interval, max_ingestion_time):
+        """
+        Display the logs for a given training job, optionally tailing them until the
+        job is complete.
+
+        :param job_name: name of the training job to check status and display logs for
+        :type job_name: str
+        :param non_terminal_states: the set of non_terminal states
+        :type non_terminal_states: set
+        :param failed_states: the set of failed states
+        :type failed_states: set
+        :param wait_for_completion: Whether to keep looking for new log entries
+            until the job completes
+        :type wait_for_completion: bool
+        :param check_interval: The interval in seconds between polling for new log entries and job completion
+        :type check_interval: int
+        :param max_ingestion_time: the maximum ingestion time in seconds. Any
+            SageMaker jobs that run longer than this will fail. Setting this to
+            None implies no timeout for any SageMaker job.
+        :type max_ingestion_time: int
+        :return: None
+        """
+
+        sec = 0
+        description = self.describe_training_job(job_name)
+        self.log.info(secondary_training_status_message(description, None))
+        instance_count = description['ResourceConfig']['InstanceCount']
+        status = description['TrainingJobStatus']
+
+        stream_names = []  # The list of log streams
+        positions = {}     # The current position in each stream, map of stream name -> position
+
+        job_already_completed = status not in non_terminal_states
+
+        state = LogState.TAILING if wait_for_completion and not job_already_completed else LogState.COMPLETE
+
+        # The loop below implements a state machine that alternates between checking the job status and
+        # reading whatever is available in the logs at this point. Note, that if we were called with
+        # wait_for_completion == False, we never check the job status.
+        #
+        # If wait_for_completion == TRUE and job is not completed, the initial state is TAILING
+        # If wait_for_completion == FALSE, the initial state is COMPLETE
+        # (doesn't matter if the job really is complete).
+        #
+        # The state table:
+        #
+        # STATE               ACTIONS                        CONDITION             NEW STATE
+        # ----------------    ----------------               -----------------     ----------------
+        # TAILING             Read logs, Pause, Get status   Job complete          JOB_COMPLETE
+        #                                                    Else                  TAILING
+        # JOB_COMPLETE        Read logs, Pause               Any                   COMPLETE
+        # COMPLETE            Read logs, Exit                                      N/A
+        #
+        # Notes:
+        # - The JOB_COMPLETE state forces us to do an extra pause and read any items that
+        # got to Cloudwatch after the job was marked complete.
+        last_describe_job_call = time.time()
+        last_description = description
+
+        while True:
+            time.sleep(check_interval)
+            sec = sec + check_interval
+
+            state, last_description, last_describe_job_call = \
+                self.describe_training_job_with_log(job_name, positions, stream_names,
+                                                    instance_count, state, last_description,
+                                                    last_describe_job_call)
+            if state == LogState.COMPLETE:
+                break
+
+            if max_ingestion_time and sec > max_ingestion_time:
+                # ensure that the job gets killed if the max ingestion time is exceeded
+                raise AirflowException('SageMaker job took more than %s seconds', max_ingestion_time)
+
+        if wait_for_completion:
+            status = last_description['TrainingJobStatus']
+            if status in failed_states:
+                reason = last_description.get('FailureReason', '(No reason provided)')
+                raise AirflowException('Error training {}: {} Reason: {}'.format(job_name, status, reason))
+            billable_time = (last_description['TrainingEndTime'] - last_description['TrainingStartTime']) \
+                * instance_count
+            self.log.info('Billable seconds:{}'.format(int(billable_time.total_seconds()) + 1))
diff --git a/airflow/contrib/operators/sagemaker_base_operator.py b/airflow/contrib/operators/sagemaker_base_operator.py
new file mode 100644
index 0000000000000..cf1e59387a784
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_base_operator.py
@@ -0,0 +1,100 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class SageMakerBaseOperator(BaseOperator):
+    """
+    This is the base operator for all SageMaker operators.
+
+    :param config: The configuration necessary to start a training job (templated)
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    """
+
+    template_fields = ['config']
+    template_ext = ()
+    ui_color = '#ededed'
+
+    integer_fields = []
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 aws_conn_id='aws_default',
+                 *args, **kwargs):
+        super(SageMakerBaseOperator, self).__init__(*args, **kwargs)
+
+        self.aws_conn_id = aws_conn_id
+        self.config = config
+        self.hook = None
+
+    def parse_integer(self, config, field):
+        if len(field) == 1:
+            if isinstance(config, list):
+                for sub_config in config:
+                    self.parse_integer(sub_config, field)
+                return
+            head = field[0]
+            if head in config:
+                config[head] = int(config[head])
+            return
+
+        if isinstance(config, list):
+            for sub_config in config:
+                self.parse_integer(sub_config, field)
+            return
+
+        head, tail = field[0], field[1:]
+        if head in config:
+            self.parse_integer(config[head], tail)
+        return
+
+    def parse_config_integers(self):
+        # Parse the integer fields of training config to integers
+        # in case the config is rendered by Jinja and all fields are str
+        for field in self.integer_fields:
+            self.parse_integer(self.config, field)
+
+    def expand_role(self):
+        raise NotImplementedError('Please implement expand_role() in sub class!')
+
+    def preprocess_config(self):
+        self.log.info(
+            'Preprocessing the config and doing required s3_operations'
+        )
+        self.hook = SageMakerHook(aws_conn_id=self.aws_conn_id)
+
+        self.hook.configure_s3_resources(self.config)
+        self.parse_config_integers()
+        self.expand_role()
+
+        self.log.info(
+            'After preprocessing the config is:\n {}'.format(
+                json.dumps(self.config, sort_keys=True, indent=4, separators=(',', ': ')))
+        )
+
+    def execute(self, context):
+        raise NotImplementedError('Please implement execute() in sub class!')
diff --git a/airflow/contrib/operators/sagemaker_create_training_job_operator.py b/airflow/contrib/operators/sagemaker_create_training_job_operator.py
deleted file mode 100644
index fdd935fc2931b..0000000000000
--- a/airflow/contrib/operators/sagemaker_create_training_job_operator.py
+++ /dev/null
@@ -1,119 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.models import BaseOperator
-from airflow.utils.decorators import apply_defaults
-from airflow.exceptions import AirflowException
-
-
-class SageMakerCreateTrainingJobOperator(BaseOperator):
-
-    """
-       Initiate a SageMaker training
-
-       This operator returns The ARN of the model created in Amazon SageMaker
-
-       :param training_job_config:
-       The configuration necessary to start a training job (templated)
-       :type training_job_config: dict
-       :param region_name: The AWS region_name
-       :type region_name: string
-       :param sagemaker_conn_id: The SageMaker connection ID to use.
-       :type sagemaker_conn_id: string
-       :param use_db_config: Whether or not to use db config
-       associated with sagemaker_conn_id.
-       If set to true, will automatically update the training config
-       with what's in db, so the db config doesn't need to
-       included everything, but what's there does replace the ones
-       in the training_job_config, so be careful
-       :type use_db_config: bool
-       :param aws_conn_id: The AWS connection ID to use.
-       :type aws_conn_id: string
-       :param wait_for_completion: if the operator should block
-       until training job finishes
-       :type wait_for_completion: bool
-       :param check_interval: if wait is set to be true, this is the time interval
-       in seconds which the operator will check the status of the training job
-       :type check_interval: int
-       :param max_ingestion_time: if wait is set to be true, the operator will fail
-       if the training job hasn't finish within the max_ingestion_time
-       (Caution: be careful to set this parameters because training can take very long)
-       :type max_ingestion_time: int
-
-       **Example**:
-           The following operator would start a training job when executed
-
-            sagemaker_training =
-               SageMakerCreateTrainingJobOperator(
-                   task_id='sagemaker_training',
-                   training_job_config=config,
-                   region_name='us-west-2'
-                   sagemaker_conn_id='sagemaker_customers_conn',
-                   use_db_config=True,
-                   aws_conn_id='aws_customers_conn'
-               )
-    """
-
-    template_fields = ['training_job_config']
-    template_ext = ()
-    ui_color = '#ededed'
-
-    @apply_defaults
-    def __init__(self,
-                 training_job_config=None,
-                 region_name=None,
-                 sagemaker_conn_id=None,
-                 use_db_config=False,
-                 wait_for_completion=True,
-                 check_interval=5,
-                 max_ingestion_time=None,
-                 *args, **kwargs):
-        super(SageMakerCreateTrainingJobOperator, self).__init__(*args, **kwargs)
-
-        self.sagemaker_conn_id = sagemaker_conn_id
-        self.training_job_config = training_job_config
-        self.use_db_config = use_db_config
-        self.region_name = region_name
-        self.wait_for_completion = wait_for_completion
-        self.check_interval = check_interval
-        self.max_ingestion_time = max_ingestion_time
-
-    def execute(self, context):
-        sagemaker = SageMakerHook(
-            sagemaker_conn_id=self.sagemaker_conn_id,
-            use_db_config=self.use_db_config,
-            region_name=self.region_name,
-            check_interval=self.check_interval,
-            max_ingestion_time=self.max_ingestion_time
-        )
-
-        self.log.info(
-            "Creating SageMaker Training Job %s."
-            % self.training_job_config['TrainingJobName']
-        )
-        response = sagemaker.create_training_job(
-            self.training_job_config,
-            wait_for_completion=self.wait_for_completion)
-        if not response['ResponseMetadata']['HTTPStatusCode'] \
-           == 200:
-            raise AirflowException(
-                'Sagemaker Training Job creation failed: %s' % response)
-        else:
-            return response
diff --git a/airflow/contrib/operators/sagemaker_create_transform_job_operator.py b/airflow/contrib/operators/sagemaker_create_transform_job_operator.py
deleted file mode 100644
index 22c8c2b4ba297..0000000000000
--- a/airflow/contrib/operators/sagemaker_create_transform_job_operator.py
+++ /dev/null
@@ -1,132 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.models import BaseOperator
-from airflow.utils.decorators import apply_defaults
-from airflow.exceptions import AirflowException
-
-
-class SageMakerCreateTransformJobOperator(BaseOperator):
-    """
-       Initiate a SageMaker transform
-
-       This operator returns The ARN of the model created in Amazon SageMaker
-
-       :param sagemaker_conn_id: The SageMaker connection ID to use.
-       :type sagemaker_conn_id: string
-       :param transform_job_config:
-       The configuration necessary to start a transform job (templated)
-       :type transform_job_config: dict
-       :param model_config:
-       The configuration necessary to create a model, the default is none
-       which means that user should provide a created model in transform_job_config
-       If given, will be used to create a model before creating transform job
-       :type model_config: dict
-       :param use_db_config: Whether or not to use db config
-       associated with sagemaker_conn_id.
-       If set to true, will automatically update the transform config
-       with what's in db, so the db config doesn't need to
-       included everything, but what's there does replace the ones
-       in the transform_job_config, so be careful
-       :type use_db_config: bool
-       :param region_name: The AWS region_name
-       :type region_name: string
-       :param wait_for_completion: if the program should keep running until job finishes
-       :type wait_for_completion: bool
-       :param check_interval: if wait is set to be true, this is the time interval
-       in seconds which the operator will check the status of the transform job
-       :type check_interval: int
-       :param max_ingestion_time: if wait is set to be true, the operator will fail
-       if the transform job hasn't finish within the max_ingestion_time
-       (Caution: be careful to set this parameters because transform can take very long)
-       :type max_ingestion_time: int
-       :param aws_conn_id: The AWS connection ID to use.
-       :type aws_conn_id: string
-
-       **Example**:
-           The following operator would start a transform job when executed
-
-            sagemaker_transform =
-               SageMakerCreateTransformJobOperator(
-                   task_id='sagemaker_transform',
-                   transform_job_config=config_transform,
-                   model_config=config_model,
-                   region_name='us-west-2'
-                   sagemaker_conn_id='sagemaker_customers_conn',
-                   use_db_config=True,
-                   aws_conn_id='aws_customers_conn'
-               )
-       """
-
-    template_fields = ['transform_job_config']
-    template_ext = ()
-    ui_color = '#ededed'
-
-    @apply_defaults
-    def __init__(self,
-                 sagemaker_conn_id=None,
-                 transform_job_config=None,
-                 model_config=None,
-                 use_db_config=False,
-                 region_name=None,
-                 wait_for_completion=True,
-                 check_interval=2,
-                 max_ingestion_time=None,
-                 *args, **kwargs):
-        super(SageMakerCreateTransformJobOperator, self).__init__(*args, **kwargs)
-
-        self.sagemaker_conn_id = sagemaker_conn_id
-        self.transform_job_config = transform_job_config
-        self.model_config = model_config
-        self.use_db_config = use_db_config
-        self.region_name = region_name
-        self.wait_for_completion = wait_for_completion
-        self.check_interval = check_interval
-        self.max_ingestion_time = max_ingestion_time
-
-    def execute(self, context):
-        sagemaker = SageMakerHook(
-            sagemaker_conn_id=self.sagemaker_conn_id,
-            use_db_config=self.use_db_config,
-            region_name=self.region_name,
-            check_interval=self.check_interval,
-            max_ingestion_time=self.max_ingestion_time
-        )
-
-        if self.model_config:
-            self.log.info(
-                "Creating SageMaker Model %s for transform job"
-                % self.model_config['ModelName']
-            )
-            sagemaker.create_model(self.model_config)
-
-        self.log.info(
-            "Creating SageMaker transform Job %s."
-            % self.transform_job_config['TransformJobName']
-        )
-        response = sagemaker.create_transform_job(
-            self.transform_job_config,
-            wait_for_completion=self.wait_for_completion)
-        if not response['ResponseMetadata']['HTTPStatusCode'] \
-           == 200:
-            raise AirflowException(
-                'Sagemaker transform Job creation failed: %s' % response)
-        else:
-            return response
diff --git a/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py b/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
deleted file mode 100644
index 46ccb2a201144..0000000000000
--- a/airflow/contrib/operators/sagemaker_create_tuning_job_operator.py
+++ /dev/null
@@ -1,121 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.models import BaseOperator
-from airflow.utils.decorators import apply_defaults
-from airflow.exceptions import AirflowException
-
-
-class SageMakerCreateTuningJobOperator(BaseOperator):
-
-    """
-       Initiate a SageMaker HyperParameter Tuning Job
-
-       This operator returns The ARN of the model created in Amazon SageMaker
-
-       :param sagemaker_conn_id: The SageMaker connection ID to use.
-       :type sagemaker_conn_id: string
-       :param region_name: The AWS region_name
-       :type region_name: string
-       :param tuning_job_config:
-       The configuration necessary to start a tuning job (templated)
-       :type tuning_job_config: dict
-       :param use_db_config: Whether or not to use db config
-       associated with sagemaker_conn_id.
-       If set to true, will automatically update the tuning config
-       with what's in db, so the db config doesn't need to
-       included everything, but what's there does replace the ones
-       in the tuning_job_config, so be careful
-       :type use_db_config: bool
-       :param wait_for_completion: if the operator should block
-       until tuning job finishes
-       :type wait_for_completion: bool
-       :param check_interval: if wait is set to be true, this is the time interval
-       in seconds which the operator will check the status of the tuning job
-       :type check_interval: int
-       :param max_ingestion_time: if wait is set to be true, the operator will fail
-       if the tuning job hasn't finish within the max_ingestion_time
-       (Caution: be careful to set this parameters because tuning can take very long)
-       :type max_ingestion_time: int
-       :param aws_conn_id: The AWS connection ID to use.
-       :type aws_conn_id: string
-
-       **Example**:
-           The following operator would start a tuning job when executed
-
-            sagemaker_tuning =
-               SageMakerCreateTuningJobOperator(
-                   task_id='sagemaker_tuning',
-                   sagemaker_conn_id='sagemaker_customers_conn',
-                   tuning_job_config=config,
-                   check_interval=2,
-                   max_ingestion_time=3600,
-                   aws_conn_id='aws_customers_conn',
-               )
-       """
-
-    template_fields = ['tuning_job_config']
-    template_ext = ()
-    ui_color = '#ededed'
-
-    @apply_defaults
-    def __init__(self,
-                 sagemaker_conn_id=None,
-                 region_name=None,
-                 tuning_job_config=None,
-                 use_db_config=False,
-                 wait_for_completion=True,
-                 check_interval=5,
-                 max_ingestion_time=None,
-                 *args, **kwargs):
-        super(SageMakerCreateTuningJobOperator, self)\
-            .__init__(*args, **kwargs)
-
-        self.sagemaker_conn_id = sagemaker_conn_id
-        self.region_name = region_name
-        self.tuning_job_config = tuning_job_config
-        self.use_db_config = use_db_config
-        self.wait_for_completion = wait_for_completion
-        self.check_interval = check_interval
-        self.max_ingestion_time = max_ingestion_time
-
-    def execute(self, context):
-        sagemaker = SageMakerHook(sagemaker_conn_id=self.sagemaker_conn_id,
-                                  region_name=self.region_name,
-                                  use_db_config=self.use_db_config,
-                                  check_interval=self.check_interval,
-                                  max_ingestion_time=self.max_ingestion_time
-                                  )
-
-        self.log.info(
-            "Creating SageMaker Hyper Parameter Tunning Job %s"
-            % self.tuning_job_config['HyperParameterTuningJobName']
-        )
-
-        response = sagemaker.create_tuning_job(
-            self.tuning_job_config,
-            wait_for_completion=self.wait_for_completion
-        )
-        if not response['ResponseMetadata']['HTTPStatusCode'] \
-           == 200:
-            raise AirflowException(
-                "Sagemaker Tuning Job creation failed: %s" % response)
-        else:
-            return response
diff --git a/airflow/contrib/operators/sagemaker_training_operator.py b/airflow/contrib/operators/sagemaker_training_operator.py
new file mode 100644
index 0000000000000..69036925f34f7
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_training_operator.py
@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerTrainingOperator(SageMakerBaseOperator):
+    """
+    Initiate a SageMaker training job.
+
+    This operator returns The ARN of the training job created in Amazon SageMaker.
+
+    :param config: The configuration necessary to start a training job (templated)
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    :param wait_for_completion: if the operator should block until training job finishes
+    :type wait_for_completion: bool
+    :param print_log: if the operator should print the cloudwatch log during training
+    :type print_log: bool
+    :param check_interval: if wait is set to be true, this is the time interval
+        in seconds which the operator will check the status of the training job
+    :type check_interval: int
+    :param max_ingestion_time: if wait is set to be true, the operator will fail
+        if the training job hasn't finish within the max_ingestion_time in seconds
+        (Caution: be careful to set this parameters because training can take very long)
+        Setting it to None implies no timeout.
+    :type max_ingestion_time: int
+    """
+
+    integer_fields = [
+        ['ResourceConfig', 'InstanceCount'],
+        ['ResourceConfig', 'VolumeSizeInGB'],
+        ['StoppingCondition', 'MaxRuntimeInSeconds']
+    ]
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 wait_for_completion=True,
+                 print_log=True,
+                 check_interval=30,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerTrainingOperator, self).__init__(config=config,
+                                                        *args, **kwargs)
+
+        self.wait_for_completion = wait_for_completion
+        self.print_log = print_log
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+
+    def expand_role(self):
+        if 'RoleArn' in self.config:
+            hook = AwsHook(self.aws_conn_id)
+            self.config['RoleArn'] = hook.expand_role(self.config['RoleArn'])
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        self.log.info('Creating SageMaker Training Job %s.', self.config['TrainingJobName'])
+
+        response = self.hook.create_training_job(
+            self.config,
+            wait_for_completion=self.wait_for_completion,
+            print_log=self.print_log,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time
+        )
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException(
+                'Sagemaker Training Job creation failed: %s' % response)
+        else:
+            return {
+                'Training': self.hook.describe_training_job(
+                    self.config['TrainingJobName']
+                )
+            }
diff --git a/airflow/contrib/operators/sagemaker_transform_operator.py b/airflow/contrib/operators/sagemaker_transform_operator.py
new file mode 100644
index 0000000000000..7be570cdacd6f
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_transform_operator.py
@@ -0,0 +1,112 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerTransformOperator(SageMakerBaseOperator):
+    """
+    Initiate a SageMaker transform job.
+
+    This operator returns The ARN of the model created in Amazon SageMaker.
+
+    :param config: The configuration necessary to start a transform job (templated)
+    :type config: dict
+    :param model_config:
+        The configuration necessary to create a SageMaker model, the default is none
+        which means the SageMaker model used for the SageMaker transform job already exists.
+        If given, it will be used to create a SageMaker model before creating
+        the SageMaker transform job
+    :type model_config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: string
+    :param wait_for_completion: if the program should keep running until job finishes
+    :type wait_for_completion: bool
+    :param check_interval: if wait is set to be true, this is the time interval
+        in seconds which the operator will check the status of the transform job
+    :type check_interval: int
+    :param max_ingestion_time: if wait is set to be true, the operator will fail
+        if the transform job hasn't finish within the max_ingestion_time in seconds
+        (Caution: be careful to set this parameters because transform can take very long)
+    :type max_ingestion_time: int
+    """
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 wait_for_completion=True,
+                 check_interval=30,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerTransformOperator, self).__init__(config=config,
+                                                         *args, **kwargs)
+        self.config = config
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+        self.create_integer_fields()
+
+    def create_integer_fields(self):
+        self.integer_fields = [
+            ['Transform', 'TransformResources', 'InstanceCount'],
+            ['Transform', 'MaxConcurrentTransforms'],
+            ['Transform', 'MaxPayloadInMB']
+        ]
+        if 'Transform' not in self.config:
+            for field in self.integer_fields:
+                field.pop(0)
+
+    def expand_role(self):
+        if 'Model' not in self.config:
+            return
+        config = self.config['Model']
+        if 'ExecutionRoleArn' in config:
+            hook = AwsHook(self.aws_conn_id)
+            config['ExecutionRoleArn'] = hook.expand_role(config['ExecutionRoleArn'])
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        model_config = self.config.get('Model')
+        transform_config = self.config.get('Transform', self.config)
+
+        if model_config:
+            self.log.info('Creating SageMaker Model %s for transform job', model_config['ModelName'])
+            self.hook.create_model(model_config)
+
+        self.log.info('Creating SageMaker transform Job %s.', transform_config['TransformJobName'])
+        response = self.hook.create_transform_job(
+            transform_config,
+            wait_for_completion=self.wait_for_completion,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time)
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException('Sagemaker transform Job creation failed: %s' % response)
+        else:
+            return {
+                'Model': self.hook.describe_model(
+                    transform_config['ModelName']
+                ),
+                'Transform': self.hook.describe_transform_job(
+                    transform_config['TransformJobName']
+                )
+            }
diff --git a/airflow/contrib/operators/sagemaker_tuning_operator.py b/airflow/contrib/operators/sagemaker_tuning_operator.py
new file mode 100644
index 0000000000000..94c995072a8da
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_tuning_operator.py
@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerTuningOperator(SageMakerBaseOperator):
+    """
+    Initiate a SageMaker hyper-parameter tuning job.
+
+    This operator returns The ARN of the tuning job created in Amazon SageMaker.
+
+    :param config: The configuration necessary to start a tuning job (templated)
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    :param wait_for_completion: if the operator should block until tuning job finishes
+    :type wait_for_completion: bool
+    :param check_interval: if wait is set to be true, this is the time interval
+        in seconds which the operator will check the status of the tuning job
+    :type check_interval: int
+    :param max_ingestion_time: if wait is set to be true, the operator will fail
+        if the tuning job hasn't finish within the max_ingestion_time in seconds
+        (Caution: be careful to set this parameters because tuning can take very long)
+    :type max_ingestion_time: int
+    """
+
+    integer_fields = [
+        ['HyperParameterTuningJobConfig', 'ResourceLimits', 'MaxNumberOfTrainingJobs'],
+        ['HyperParameterTuningJobConfig', 'ResourceLimits', 'MaxParallelTrainingJobs'],
+        ['TrainingJobDefinition', 'ResourceConfig', 'InstanceCount'],
+        ['TrainingJobDefinition', 'ResourceConfig', 'VolumeSizeInGB'],
+        ['TrainingJobDefinition', 'StoppingCondition', 'MaxRuntimeInSeconds']
+    ]
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 wait_for_completion=True,
+                 check_interval=30,
+                 max_ingestion_time=None,
+                 *args, **kwargs):
+        super(SageMakerTuningOperator, self).__init__(config=config,
+                                                      *args, **kwargs)
+        self.config = config
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+
+    def expand_role(self):
+        if 'TrainingJobDefinition' in self.config:
+            config = self.config['TrainingJobDefinition']
+            if 'RoleArn' in config:
+                hook = AwsHook(self.aws_conn_id)
+                config['RoleArn'] = hook.expand_role(config['RoleArn'])
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        self.log.info(
+            'Creating SageMaker Hyper-Parameter Tuning Job %s', self.config['HyperParameterTuningJobName']
+        )
+
+        response = self.hook.create_tuning_job(
+            self.config,
+            wait_for_completion=self.wait_for_completion,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time
+        )
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException(
+                'Sagemaker Tuning Job creation failed: %s' % response)
+        else:
+            return {
+                'Tuning': self.hook.describe_tuning_job(
+                    self.config['HyperParameterTuningJobName']
+                )
+            }
diff --git a/airflow/contrib/sensors/sagemaker_base_sensor.py b/airflow/contrib/sensors/sagemaker_base_sensor.py
index 149c2a1aab124..10dd6b2357a66 100644
--- a/airflow/contrib/sensors/sagemaker_base_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_base_sensor.py
@@ -28,7 +28,7 @@ class SageMakerBaseSensor(BaseSensorOperator):
     and state_from_response() methods.
     Subclasses should also implement NON_TERMINAL_STATES and FAILED_STATE methods.
     """
-    ui_color = '#66c3ff'
+    ui_color = '#ededed'
 
     @apply_defaults
     def __init__(
@@ -54,23 +54,21 @@ def poke(self, context):
 
         if state in self.failed_states():
             failed_reason = self.get_failed_reason_from_response(response)
-            raise AirflowException("Sagemaker job failed for the following reason: %s"
+            raise AirflowException('Sagemaker job failed for the following reason: %s'
                                    % failed_reason)
         return True
 
     def non_terminal_states(self):
-        raise AirflowException("Non Terminal States need to be specified in subclass")
+        raise NotImplementedError('Please implement non_terminal_states() in subclass')
 
     def failed_states(self):
-        raise AirflowException("Failed States need to be specified in subclass")
+        raise NotImplementedError('Please implement failed_states() in subclass')
 
     def get_sagemaker_response(self):
-        raise AirflowException(
-            "Method get_sagemaker_response()not implemented.")
+        raise NotImplementedError('Please implement get_sagemaker_response() in subclass')
 
     def get_failed_reason_from_response(self, response):
         return 'Unknown'
 
     def state_from_response(self, response):
-        raise AirflowException(
-            "Method state_from_response()not implemented.")
+        raise NotImplementedError('Please implement state_from_response() in subclass')
diff --git a/airflow/contrib/sensors/sagemaker_training_sensor.py b/airflow/contrib/sensors/sagemaker_training_sensor.py
index 449de44c0819c..2d820111a08c8 100644
--- a/airflow/contrib/sensors/sagemaker_training_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_training_sensor.py
@@ -17,7 +17,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+import time
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook, LogState
 from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
 from airflow.utils.decorators import apply_defaults
 
@@ -27,8 +29,10 @@ class SageMakerTrainingSensor(SageMakerBaseSensor):
     Asks for the state of the training state until it reaches a terminal state.
     If it fails the sensor errors, failing the task.
 
-    :param job_name: job_name of the training instance to check the state of
-    :type job_name: string
+    :param job_name: name of the SageMaker training job to check the state of
+    :type job_name: str
+    :param print_log: if the operator should print the cloudwatch log
+    :type print_log: bool
     """
 
     template_fields = ['job_name']
@@ -37,12 +41,30 @@ class SageMakerTrainingSensor(SageMakerBaseSensor):
     @apply_defaults
     def __init__(self,
                  job_name,
-                 region_name=None,
+                 print_log=True,
                  *args,
                  **kwargs):
         super(SageMakerTrainingSensor, self).__init__(*args, **kwargs)
         self.job_name = job_name
-        self.region_name = region_name
+        self.print_log = print_log
+        self.positions = {}
+        self.stream_names = []
+        self.instance_count = None
+        self.state = None
+        self.last_description = None
+        self.last_describe_job_call = None
+        self.log_resource_inited = False
+
+    def init_log_resource(self, hook):
+        description = hook.describe_training_job(self.job_name)
+        self.instance_count = description['ResourceConfig']['InstanceCount']
+
+        status = description['TrainingJobStatus']
+        job_already_completed = status not in self.non_terminal_states()
+        self.state = LogState.TAILING if not job_already_completed else LogState.COMPLETE
+        self.last_description = description
+        self.last_describe_job_call = time.time()
+        self.log_resource_inited = True
 
     def non_terminal_states(self):
         return SageMakerHook.non_terminal_states
@@ -51,13 +73,27 @@ def failed_states(self):
         return SageMakerHook.failed_states
 
     def get_sagemaker_response(self):
-        sagemaker = SageMakerHook(
-            aws_conn_id=self.aws_conn_id,
-            region_name=self.region_name
-        )
+        sagemaker_hook = SageMakerHook(aws_conn_id=self.aws_conn_id)
+        if self.print_log:
+            if not self.log_resource_inited:
+                self.init_log_resource(sagemaker_hook)
+            self.state, self.last_description, self.last_describe_job_call = \
+                sagemaker_hook.describe_training_job_with_log(self.job_name,
+                                                              self.positions, self.stream_names,
+                                                              self.instance_count, self.state,
+                                                              self.last_description,
+                                                              self.last_describe_job_call)
+        else:
+            self.last_description = sagemaker_hook.describe_training_job(self.job_name)
+
+        status = self.state_from_response(self.last_description)
+        if status not in self.non_terminal_states() and status not in self.failed_states():
+            billable_time = \
+                (self.last_description['TrainingEndTime'] - self.last_description['TrainingStartTime']) * \
+                self.last_description['ResourceConfig']['InstanceCount']
+            self.log.info('Billable seconds:{}'.format(int(billable_time.total_seconds()) + 1))
 
-        self.log.info('Poking Sagemaker Training Job %s', self.job_name)
-        return sagemaker.describe_training_job(self.job_name)
+        return self.last_description
 
     def get_failed_reason_from_response(self, response):
         return response['FailureReason']
diff --git a/airflow/contrib/sensors/sagemaker_transform_sensor.py b/airflow/contrib/sensors/sagemaker_transform_sensor.py
index 68ef1d8dd7b05..f64724bde9b24 100644
--- a/airflow/contrib/sensors/sagemaker_transform_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_transform_sensor.py
@@ -30,8 +30,6 @@ class SageMakerTransformSensor(SageMakerBaseSensor):
 
     :param job_name: job_name of the transform job instance to check the state of
     :type job_name: string
-    :param region_name: The AWS region_name
-    :type region_name: string
     """
 
     template_fields = ['job_name']
@@ -40,12 +38,10 @@ class SageMakerTransformSensor(SageMakerBaseSensor):
     @apply_defaults
     def __init__(self,
                  job_name,
-                 region_name=None,
                  *args,
                  **kwargs):
         super(SageMakerTransformSensor, self).__init__(*args, **kwargs)
         self.job_name = job_name
-        self.region_name = region_name
 
     def non_terminal_states(self):
         return SageMakerHook.non_terminal_states
@@ -54,10 +50,7 @@ def failed_states(self):
         return SageMakerHook.failed_states
 
     def get_sagemaker_response(self):
-        sagemaker = SageMakerHook(
-            aws_conn_id=self.aws_conn_id,
-            region_name=self.region_name
-        )
+        sagemaker = SageMakerHook(aws_conn_id=self.aws_conn_id)
 
         self.log.info('Poking Sagemaker Transform Job %s', self.job_name)
         return sagemaker.describe_transform_job(self.job_name)
diff --git a/airflow/contrib/sensors/sagemaker_tuning_sensor.py b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
index 1f081100e2c69..8c835216d6bb3 100644
--- a/airflow/contrib/sensors/sagemaker_tuning_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_tuning_sensor.py
@@ -29,9 +29,7 @@ class SageMakerTuningSensor(SageMakerBaseSensor):
     containing the failure reason.
 
     :param job_name: job_name of the tuning instance to check the state of
-    :type job_name: string
-    :param region_name: The AWS region_name
-    :type region_name: string
+    :type job_name: str
     """
 
     template_fields = ['job_name']
@@ -40,12 +38,10 @@ class SageMakerTuningSensor(SageMakerBaseSensor):
     @apply_defaults
     def __init__(self,
                  job_name,
-                 region_name=None,
                  *args,
                  **kwargs):
         super(SageMakerTuningSensor, self).__init__(*args, **kwargs)
         self.job_name = job_name
-        self.region_name = region_name
 
     def non_terminal_states(self):
         return SageMakerHook.non_terminal_states
@@ -54,10 +50,7 @@ def failed_states(self):
         return SageMakerHook.failed_states
 
     def get_sagemaker_response(self):
-        sagemaker = SageMakerHook(
-            aws_conn_id=self.aws_conn_id,
-            region_name=self.region_name
-        )
+        sagemaker = SageMakerHook(aws_conn_id=self.aws_conn_id)
 
         self.log.info('Poking Sagemaker Tuning Job %s', self.job_name)
         return sagemaker.describe_tuning_job(self.job_name)
diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index b4f3ac3b030e8..a64c331cdd09e 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -67,6 +67,26 @@ def get_bucket(self, bucket_name):
         s3 = self.get_resource_type('s3')
         return s3.Bucket(bucket_name)
 
+    def create_bucket(self, bucket_name, region_name=None):
+        """
+        Creates a boto3.S3.Bucket object
+
+        :param bucket_name: the name of the bucket
+        :type bucket_name: str
+        :param region__name: the name of the aws region
+        :type region_name: str
+        """
+        s3_conn = self.get_conn()
+        if not region_name:
+            region_name = s3_conn.meta.region_name
+        if region_name == 'us-east-1':
+            self.get_conn().create_bucket(Bucket=bucket_name)
+        else:
+            self.get_conn().create_bucket(Bucket=bucket_name,
+                                          CreateBucketConfiguration={
+                                              'LocationConstraint': region_name
+                                          })
+
     def check_for_prefix(self, bucket_name, prefix, delimiter):
         """
         Checks that a prefix exists in a bucket
@@ -377,3 +397,124 @@ def load_bytes(self,
 
         client = self.get_conn()
         client.upload_fileobj(filelike_buffer, bucket_name, key, ExtraArgs=extra_args)
+
+    def load_file_obj(self,
+                      file_obj,
+                      key,
+                      bucket_name=None,
+                      replace=False,
+                      encrypt=False):
+        """
+        Loads file object to S3
+
+        :param file_obj: file-like object to set as content for the key.
+        :type file_obj: file-like object
+        :param key: S3 key that will point to the file
+        :type key: str
+        :param bucket_name: Name of the bucket in which to store the file
+        :type bucket_name: str
+        :param replace: A flag to decide whether or not to overwrite the key
+            if it already exists
+        :type replace: bool
+        :param encrypt: If True, the file will be encrypted on the server-side
+            by S3 and will be stored in an encrypted form while at rest in S3.
+        :type encrypt: bool
+        """
+        if not bucket_name:
+            (bucket_name, key) = self.parse_s3_url(key)
+
+        if not replace and self.check_for_key(key, bucket_name):
+            raise ValueError("The key {key} already exists.".format(key=key))
+
+        extra_args = {}
+        if encrypt:
+            extra_args['ServerSideEncryption'] = "AES256"
+
+        client = self.get_conn()
+        client.upload_fileobj(file_obj, bucket_name, key, ExtraArgs=extra_args)
+
+    def copy_object(self,
+                    source_bucket_key,
+                    dest_bucket_key,
+                    source_bucket_name=None,
+                    dest_bucket_name=None,
+                    source_version_id=None):
+        """
+        Creates a copy of an object that is already stored in S3.
+
+        Note: the S3 connection used here needs to have access to both
+        source and destination bucket/key.
+
+        :param source_bucket_key: The key of the source object.
+
+            It can be either full s3:// style url or relative path from root level.
+
+            When it's specified as a full s3:// url, please omit source_bucket_name.
+        :type source_bucket_key: str
+        :param dest_bucket_key: The key of the object to copy to.
+
+            The convention to specify `dest_bucket_key` is the same
+            as `source_bucket_key`.
+        :type dest_bucket_key: str
+        :param source_bucket_name: Name of the S3 bucket where the source object is in.
+
+            It should be omitted when `source_bucket_key` is provided as a full s3:// url.
+        :type source_bucket_name: str
+        :param dest_bucket_name: Name of the S3 bucket to where the object is copied.
+
+            It should be omitted when `dest_bucket_key` is provided as a full s3:// url.
+        :type dest_bucket_name: str
+        :param source_version_id: Version ID of the source object (OPTIONAL)
+        :type source_version_id: str
+        """
+
+        if dest_bucket_name is None:
+            dest_bucket_name, dest_bucket_key = self.parse_s3_url(dest_bucket_key)
+        else:
+            parsed_url = urlparse(dest_bucket_key)
+            if parsed_url.scheme != '' or parsed_url.netloc != '':
+                raise AirflowException('If dest_bucket_name is provided, ' +
+                                       'dest_bucket_key should be relative path ' +
+                                       'from root level, rather than a full s3:// url')
+
+        if source_bucket_name is None:
+            source_bucket_name, source_bucket_key = self.parse_s3_url(source_bucket_key)
+        else:
+            parsed_url = urlparse(source_bucket_key)
+            if parsed_url.scheme != '' or parsed_url.netloc != '':
+                raise AirflowException('If source_bucket_name is provided, ' +
+                                       'source_bucket_key should be relative path ' +
+                                       'from root level, rather than a full s3:// url')
+
+        CopySource = {'Bucket': source_bucket_name,
+                      'Key': source_bucket_key,
+                      'VersionId': source_version_id}
+        response = self.get_conn().copy_object(Bucket=dest_bucket_name,
+                                               Key=dest_bucket_key,
+                                               CopySource=CopySource)
+        return response
+
+    def delete_objects(self,
+                       bucket,
+                       keys):
+        """
+        :param bucket: Name of the bucket in which you are going to delete object(s)
+        :type bucket: str
+        :param keys: The key(s) to delete from S3 bucket.
+
+            When ``keys`` is a string, it's supposed to be the key name of
+            the single object to delete.
+
+            When ``keys`` is a list, it's supposed to be the list of the
+            keys to delete.
+        :type keys: str or list
+        """
+        if isinstance(keys, list):
+            keys = keys
+        else:
+            keys = [keys]
+
+        delete_dict = {"Objects": [{"Key": k} for k in keys]}
+        response = self.get_conn().delete_objects(Bucket=bucket,
+                                                  Delete=delete_dict)
+        return response
diff --git a/docs/code.rst b/docs/code.rst
index f4a91e00ba24e..d577b768eb79c 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -182,6 +182,10 @@ Operators
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SagemakerTuningOperator
 .. autoclass:: airflow.contrib.operators.segment_track_event_operator.SegmentTrackEventOperator
 .. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
 .. autoclass:: airflow.contrib.operators.slack_webhook_operator.SlackWebhookOperator
@@ -218,6 +222,10 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.pubsub_sensor.PubSubPullSensor
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleSensor
 .. autoclass:: airflow.contrib.sensors.redis_key_sensor.RedisKeySensor
+.. autoclass:: airflow.contrib.sensors.sagemaker_base_sensor.SageMakerBaseSensor
+.. autoclass:: airflow.contrib.sensors.sagemaker_training_sensor.SageMakerTrainingSensor
+.. autoclass:: airflow.contrib.sensors.sagemaker_transform_sensor.SageMakerTransformSensor
+.. autoclass:: airflow.contrib.sensors.sagemaker_tuning_sensor.SageMakerTuningSensor
 .. autoclass:: airflow.contrib.sensors.sftp_sensor.SFTPSensor
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
 
@@ -396,6 +404,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.qubole_hook.QuboleHook
 .. autoclass:: airflow.contrib.hooks.redis_hook.RedisHook
 .. autoclass:: airflow.contrib.hooks.redshift_hook.RedshiftHook
+.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
 .. autoclass:: airflow.contrib.hooks.salesforce_hook.SalesforceHook
 .. autoclass:: airflow.contrib.hooks.segment_hook.SegmentHook
 .. autoclass:: airflow.contrib.hooks.sftp_hook.SFTPHook
diff --git a/tests/contrib/hooks/test_aws_hook.py b/tests/contrib/hooks/test_aws_hook.py
index b92e594c10369..57814b43d9038 100644
--- a/tests/contrib/hooks/test_aws_hook.py
+++ b/tests/contrib/hooks/test_aws_hook.py
@@ -35,11 +35,12 @@
         mock = None
 
 try:
-    from moto import mock_emr, mock_dynamodb2, mock_sts
+    from moto import mock_emr, mock_dynamodb2, mock_sts, mock_iam
 except ImportError:
     mock_emr = None
     mock_dynamodb2 = None
     mock_sts = None
+    mock_iam = None
 
 
 class TestAwsHook(unittest.TestCase):
@@ -185,6 +186,35 @@ def test_get_credentials_from_role_arn(self, mock_get_connection):
                          'gRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4OlgkBN9bkUDNCJiBeb/AXlzBBko7b15'
                          'fjrBs2+cTQtpZ3CYWFXG8C5zqx37wnOE49mRl/+OtkIKGO7fAE')
 
+    @unittest.skipIf(mock_sts is None, 'mock_sts package not present')
+    @mock.patch.object(AwsHook, 'get_connection')
+    @mock_sts
+    def test_get_credentials_from_role_arn_with_external_id(self, mock_get_connection):
+        mock_connection = Connection(
+            extra='{"role_arn":"arn:aws:iam::123456:role/role_arn",'
+                  ' "external_id":"external_id"}')
+        mock_get_connection.return_value = mock_connection
+        hook = AwsHook()
+        credentials_from_hook = hook.get_credentials()
+        self.assertEqual(credentials_from_hook.access_key, 'AKIAIOSFODNN7EXAMPLE')
+        self.assertEqual(credentials_from_hook.secret_key,
+                         'aJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY')
+        self.assertEqual(credentials_from_hook.token,
+                         'BQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh'
+                         '3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4I'
+                         'gRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4OlgkBN9bkUDNCJiBeb/AXlzBBko7b15'
+                         'fjrBs2+cTQtpZ3CYWFXG8C5zqx37wnOE49mRl/+OtkIKGO7fAE')
+
+    @unittest.skipIf(mock_iam is None, 'mock_iam package not present')
+    @mock_iam
+    def test_expand_role(self):
+        conn = boto3.client('iam', region_name='us-east-1')
+        conn.create_role(RoleName='test-role', AssumeRolePolicyDocument='some policy')
+        hook = AwsHook()
+        arn = hook.expand_role('test-role')
+        expect_arn = conn.get_role(RoleName='test-role').get('Role').get('Arn')
+        self.assertEqual(arn, expect_arn)
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
index 3a863b3cb0dc7..bec00bf601a8f 100644
--- a/tests/contrib/hooks/test_sagemaker_hook.py
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -18,10 +18,11 @@
 # under the License.
 #
 
-
-import json
 import unittest
-import copy
+import time
+from datetime import datetime
+from tzlocal import get_localzone
+
 try:
     from unittest import mock
 except ImportError:
@@ -31,200 +32,221 @@
         mock = None
 
 from airflow import configuration
-from airflow import models
-from airflow.utils import db
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.hooks.sagemaker_hook import (SageMakerHook, secondary_training_status_changed,
+                                                  secondary_training_status_message, LogState)
 from airflow.hooks.S3_hook import S3Hook
 from airflow.exceptions import AirflowException
 
 
-role = 'test-role'
+role = 'arn:aws:iam:role/test-role'
 
+path = 'local/data'
 bucket = 'test-bucket'
-
 key = 'test/data'
 data_url = 's3://{}/{}'.format(bucket, key)
 
-job_name = 'test-job-name'
-
-model_name = 'test-model-name'
+job_name = 'test-job'
+model_name = 'test-model'
+config_name = 'test-endpoint-config'
+endpoint_name = 'test-endpoint'
 
 image = 'test-image'
+test_arn_return = {'Arn': 'testarn'}
+output_url = 's3://{}/test/output'.format(bucket)
 
-test_arn_return = {'TrainingJobArn': 'testarn'}
-
-test_list_training_job_return = {
-    'TrainingJobSummaries': [
-        {
-            'TrainingJobName': job_name,
-            'TrainingJobStatus': 'InProgress'
-        },
-    ],
-    'NextToken': 'test-token'
-}
-
-test_list_tuning_job_return = {
-    'TrainingJobSummaries': [
+create_training_params = {
+    'AlgorithmSpecification': {
+        'TrainingImage': image,
+        'TrainingInputMode': 'File'
+    },
+    'RoleArn': role,
+    'OutputDataConfig': {
+        'S3OutputPath': output_url
+    },
+    'ResourceConfig': {
+        'InstanceCount': 2,
+        'InstanceType': 'ml.c4.8xlarge',
+        'VolumeSizeInGB': 50
+    },
+    'TrainingJobName': job_name,
+    'HyperParameters': {
+        'k': '10',
+        'feature_dim': '784',
+        'mini_batch_size': '500',
+        'force_dense': 'True'
+    },
+    'StoppingCondition': {
+        'MaxRuntimeInSeconds': 60 * 60
+    },
+    'InputDataConfig': [
         {
-            'TrainingJobName': job_name,
-            'TrainingJobArn': 'testarn',
-            'TunedHyperParameters': {
-                'k': '3'
+            'ChannelName': 'train',
+            'DataSource': {
+                'S3DataSource': {
+                    'S3DataType': 'S3Prefix',
+                    'S3Uri': data_url,
+                    'S3DataDistributionType': 'FullyReplicated'
+                }
             },
-            'TrainingJobStatus': 'InProgress'
-        },
-    ],
-    'NextToken': 'test-token'
+            'CompressionType': 'None',
+            'RecordWrapperType': 'None'
+        }
+    ]
 }
 
-output_url = 's3://{}/test/output'.format(bucket)
-create_training_params = \
-    {
-        'AlgorithmSpecification': {
-            'TrainingImage': image,
-            'TrainingInputMode': 'File'
+create_tuning_params = {
+    'HyperParameterTuningJobName': job_name,
+    'HyperParameterTuningJobConfig': {
+        'Strategy': 'Bayesian',
+        'HyperParameterTuningJobObjective': {
+            'Type': 'Maximize',
+            'MetricName': 'test_metric'
         },
-        'RoleArn': role,
-        'OutputDataConfig': {
-            'S3OutputPath': output_url
+        'ResourceLimits': {
+            'MaxNumberOfTrainingJobs': 123,
+            'MaxParallelTrainingJobs': 123
         },
-        'ResourceConfig': {
-            'InstanceCount': 2,
-            'InstanceType': 'ml.c4.8xlarge',
-            'VolumeSizeInGB': 50
-        },
-        'TrainingJobName': job_name,
-        'HyperParameters': {
-            'k': '10',
-            'feature_dim': '784',
-            'mini_batch_size': '500',
-            'force_dense': 'True'
-        },
-        'StoppingCondition': {
-            'MaxRuntimeInSeconds': 60 * 60
-        },
-        'InputDataConfig': [
-            {
-                'ChannelName': 'train',
-                'DataSource': {
-                    'S3DataSource': {
-                        'S3DataType': 'S3Prefix',
-                        'S3Uri': data_url,
-                        'S3DataDistributionType': 'FullyReplicated'
-                    }
+        'ParameterRanges': {
+            'IntegerParameterRanges': [
+                {
+                    'Name': 'k',
+                    'MinValue': '2',
+                    'MaxValue': '10'
                 },
-                'CompressionType': 'None',
-                'RecordWrapperType': 'None'
-            }
-        ]
-    }
 
-create_tuning_params = \
-    {
-        'HyperParameterTuningJobName': job_name,
-        'HyperParameterTuningJobConfig': {
-            'Strategy': 'Bayesian',
-            'HyperParameterTuningJobObjective': {
-                'Type': 'Maximize',
-                'MetricName': 'test_metric'
-            },
-            'ResourceLimits': {
-                'MaxNumberOfTrainingJobs': 123,
-                'MaxParallelTrainingJobs': 123
-            },
-            'ParameterRanges': {
-                'IntegerParameterRanges': [
-                    {
-                        'Name': 'k',
-                        'MinValue': '2',
-                        'MaxValue': '10'
-                    },
-
-                ]
-            }
-        },
-        'TrainingJobDefinition': {
-            'StaticHyperParameters': create_training_params['HyperParameters'],
-            'AlgorithmSpecification': create_training_params['AlgorithmSpecification'],
-            'RoleArn': 'string',
-            'InputDataConfig': create_training_params['InputDataConfig'],
-            'OutputDataConfig': create_training_params['OutputDataConfig'],
-            'ResourceConfig': create_training_params['ResourceConfig'],
-            'StoppingCondition': dict(MaxRuntimeInSeconds=60 * 60)
+            ]
         }
+    },
+    'TrainingJobDefinition': {
+        'StaticHyperParameters': create_training_params['HyperParameters'],
+        'AlgorithmSpecification': create_training_params['AlgorithmSpecification'],
+        'RoleArn': 'string',
+        'InputDataConfig': create_training_params['InputDataConfig'],
+        'OutputDataConfig': create_training_params['OutputDataConfig'],
+        'ResourceConfig': create_training_params['ResourceConfig'],
+        'StoppingCondition': dict(MaxRuntimeInSeconds=60 * 60)
     }
+}
 
-create_transform_params = \
-    {
-        'TransformJobName': job_name,
-        'ModelName': model_name,
-        'BatchStrategy': 'MultiRecord',
-        'TransformInput': {
-            'DataSource': {
-                'S3DataSource': {
-                    'S3DataType': 'S3Prefix',
-                    'S3Uri': data_url
-                }
+create_transform_params = {
+    'TransformJobName': job_name,
+    'ModelName': model_name,
+    'BatchStrategy': 'MultiRecord',
+    'TransformInput': {
+        'DataSource': {
+            'S3DataSource': {
+                'S3DataType': 'S3Prefix',
+                'S3Uri': data_url
             }
-        },
-        'TransformOutput': {
-            'S3OutputPath': output_url,
-        },
-        'TransformResources': {
-            'InstanceType': 'ml.m4.xlarge',
-            'InstanceCount': 123
         }
+    },
+    'TransformOutput': {
+        'S3OutputPath': output_url,
+    },
+    'TransformResources': {
+        'InstanceType': 'ml.m4.xlarge',
+        'InstanceCount': 123
     }
+}
 
-create_model_params = \
-    {
-        'ModelName': model_name,
-        'PrimaryContainer': {
-            'Image': image,
-            'ModelDataUrl': output_url,
-        },
-        'ExecutionRoleArn': role
-    }
+create_model_params = {
+    'ModelName': model_name,
+    'PrimaryContainer': {
+        'Image': image,
+        'ModelDataUrl': output_url,
+    },
+    'ExecutionRoleArn': role
+}
 
-db_config = {
-    'Tags': [
+create_endpoint_config_params = {
+    'EndpointConfigName': config_name,
+    'ProductionVariants': [
         {
-            'Key': 'test-db-key',
-            'Value': 'test-db-value',
-
-        },
+            'VariantName': 'AllTraffic',
+            'ModelName': model_name,
+            'InitialInstanceCount': 1,
+            'InstanceType': 'ml.c4.xlarge'
+        }
     ]
 }
 
-DESCRIBE_TRAINING_INPROGRESS_RETURN = {
-    'TrainingJobStatus': 'InProgress',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
+create_endpoint_params = {
+    'EndpointName': endpoint_name,
+    'EndpointConfigName': config_name
 }
+
+update_endpoint_params = create_endpoint_params
+
 DESCRIBE_TRAINING_COMPELETED_RETURN = {
-    'TrainingJobStatus': 'Compeleted',
+    'TrainingJobStatus': 'Completed',
+    'ResourceConfig': {
+        'InstanceCount': 1,
+        'InstanceType': 'ml.c4.xlarge',
+        'VolumeSizeInGB': 10
+    },
+    'TrainingStartTime': datetime(2018, 2, 17, 7, 15, 0, 103000),
+    'TrainingEndTime': datetime(2018, 2, 17, 7, 19, 34, 953000),
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TRAINING_FAILED_RETURN = {
-    'TrainingJobStatus': 'Failed',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    },
-    'FailureReason': 'Unknown'
+
+DESCRIBE_TRAINING_INPROGRESS_RETURN = dict(DESCRIBE_TRAINING_COMPELETED_RETURN)
+DESCRIBE_TRAINING_INPROGRESS_RETURN.update({'TrainingJobStatus': 'InProgress'})
+
+DESCRIBE_TRAINING_FAILED_RETURN = dict(DESCRIBE_TRAINING_COMPELETED_RETURN)
+DESCRIBE_TRAINING_FAILED_RETURN.update({'TrainingJobStatus': 'Failed',
+                                        'FailureReason': 'Unknown'})
+
+DESCRIBE_TRAINING_STOPPING_RETURN = dict(DESCRIBE_TRAINING_COMPELETED_RETURN)
+DESCRIBE_TRAINING_STOPPING_RETURN.update({'TrainingJobStatus': 'Stopping'})
+
+message = 'message'
+status = 'status'
+SECONDARY_STATUS_DESCRIPTION_1 = {
+    'SecondaryStatusTransitions': [{'StatusMessage': message, 'Status': status}]
 }
-DESCRIBE_TRAINING_STOPPING_RETURN = {
-    'TrainingJobStatus': 'Stopping',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
+SECONDARY_STATUS_DESCRIPTION_2 = {
+    'SecondaryStatusTransitions': [{'StatusMessage': 'different message', 'Status': status}]
 }
-DESCRIBE_TRAINING_STOPPED_RETURN = {
-    'TrainingJobStatus': 'Stopped',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
+
+DEFAULT_LOG_STREAMS = {'logStreams': [{'logStreamName': job_name + '/xxxxxxxxx'}]}
+LIFECYCLE_LOG_STREAMS = [DEFAULT_LOG_STREAMS,
+                         DEFAULT_LOG_STREAMS,
+                         DEFAULT_LOG_STREAMS,
+                         DEFAULT_LOG_STREAMS,
+                         DEFAULT_LOG_STREAMS,
+                         DEFAULT_LOG_STREAMS]
+
+DEFAULT_LOG_EVENTS = [{'nextForwardToken': None, 'events': [{'timestamp': 1, 'message': 'hi there #1'}]},
+                      {'nextForwardToken': None, 'events': []}]
+STREAM_LOG_EVENTS = [{'nextForwardToken': None, 'events': [{'timestamp': 1, 'message': 'hi there #1'}]},
+                     {'nextForwardToken': None, 'events': []},
+                     {'nextForwardToken': None, 'events': [{'timestamp': 1, 'message': 'hi there #1'},
+                                                           {'timestamp': 2, 'message': 'hi there #2'}]},
+                     {'nextForwardToken': None, 'events': []},
+                     {'nextForwardToken': None, 'events': [{'timestamp': 2, 'message': 'hi there #2'},
+                                                           {'timestamp': 2, 'message': 'hi there #2a'},
+                                                           {'timestamp': 3, 'message': 'hi there #3'}]},
+                     {'nextForwardToken': None, 'events': []}]
+
+test_evaluation_config = {
+    'Image': image,
+    'Role': role,
+    'S3Operations': {
+        'S3CreateBucket': [
+            {
+                'Bucket': bucket
+            }
+        ],
+        'S3Upload': [
+            {
+                'Path': path,
+                'Bucket': bucket,
+                'Key': key,
+                'Tar': False
+            }
+        ]
     }
 }
 
@@ -233,94 +255,63 @@ class TestSageMakerHook(unittest.TestCase):
 
     def setUp(self):
         configuration.load_test_config()
-        db.merge_conn(
-            models.Connection(
-                conn_id='sagemaker_test_conn_id',
-                conn_type='sagemaker',
-                login='access_id',
-                password='access_key',
-                extra=json.dumps(db_config)
-            )
-        )
+
+    @mock.patch.object(S3Hook, 'create_bucket')
+    @mock.patch.object(S3Hook, 'load_file')
+    def test_configure_s3_resources(self, mock_load_file, mock_create_bucket):
+        hook = SageMakerHook()
+        evaluation_result = {
+            'Image': image,
+            'Role': role
+        }
+        hook.configure_s3_resources(test_evaluation_config)
+        self.assertEqual(test_evaluation_config, evaluation_result)
+        mock_create_bucket.assert_called_once_with(bucket_name=bucket)
+        mock_load_file.assert_called_once_with(path, key, bucket)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(S3Hook, 'check_for_key')
     @mock.patch.object(S3Hook, 'check_for_bucket')
     @mock.patch.object(S3Hook, 'check_for_prefix')
-    def test_check_for_url(self,
-                           mock_check_prefix,
-                           mock_check_bucket,
-                           mock_check_key,
-                           mock_client):
+    def test_check_s3_url(self,
+                          mock_check_prefix,
+                          mock_check_bucket,
+                          mock_check_key,
+                          mock_client):
         mock_client.return_value = None
         hook = SageMakerHook()
         mock_check_bucket.side_effect = [False, True, True, True]
         mock_check_key.side_effect = [False, True, False]
         mock_check_prefix.side_effect = [False, True, True]
         self.assertRaises(AirflowException,
-                          hook.check_for_url, data_url)
+                          hook.check_s3_url, data_url)
         self.assertRaises(AirflowException,
-                          hook.check_for_url, data_url)
-        self.assertEqual(hook.check_for_url(data_url), True)
-        self.assertEqual(hook.check_for_url(data_url), True)
+                          hook.check_s3_url, data_url)
+        self.assertEqual(hook.check_s3_url(data_url), True)
+        self.assertEqual(hook.check_s3_url(data_url), True)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'check_for_url')
+    @mock.patch.object(SageMakerHook, 'check_s3_url')
     def test_check_valid_training(self, mock_check_url, mock_client):
         mock_client.return_value = None
         hook = SageMakerHook()
-        hook.check_valid_training_input(create_training_params)
+        hook.check_training_config(create_training_params)
         mock_check_url.assert_called_once_with(data_url)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'check_for_url')
+    @mock.patch.object(SageMakerHook, 'check_s3_url')
     def test_check_valid_tuning(self, mock_check_url, mock_client):
         mock_client.return_value = None
         hook = SageMakerHook()
-        hook.check_valid_tuning_input(create_tuning_params)
+        hook.check_tuning_config(create_tuning_params)
         mock_check_url.assert_called_once_with(data_url)
 
     @mock.patch.object(SageMakerHook, 'get_client_type')
     def test_conn(self, mock_get_client):
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
-                             region_name='us-east-1'
-                             )
-        self.assertEqual(hook.sagemaker_conn_id, 'sagemaker_test_conn_id')
-        mock_get_client.assert_called_once_with('sagemaker',
-                                                region_name='us-east-1'
-                                                )
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        self.assertEqual(hook.aws_conn_id, 'sagemaker_test_conn_id')
 
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_list_training_job(self, mock_client):
-        mock_session = mock.Mock()
-        attrs = {'list_training_jobs.return_value':
-                 test_list_training_job_return}
-        mock_session.configure_mock(**attrs)
-        mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
-        response = hook.list_training_job(name_contains=job_name,
-                                          status_equals='InProgress')
-        mock_session.list_training_jobs. \
-            assert_called_once_with(NameContains=job_name,
-                                    StatusEquals='InProgress')
-        self.assertEqual(response, test_list_training_job_return)
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_list_tuning_job(self, mock_client):
-        mock_session = mock.Mock()
-        attrs = {'list_hyper_parameter_tuning_job.return_value':
-                 test_list_tuning_job_return}
-        mock_session.configure_mock(**attrs)
-        mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
-        response = hook.list_tuning_job(name_contains=job_name,
-                                        status_equals='InProgress')
-        mock_session.list_hyper_parameter_tuning_job. \
-            assert_called_once_with(NameContains=job_name,
-                                    StatusEquals='InProgress')
-        self.assertEqual(response, test_list_tuning_job_return)
-
-    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'check_training_config')
     @mock.patch.object(SageMakerHook, 'get_conn')
     def test_create_training_job(self, mock_client, mock_check_training):
         mock_check_training.return_value = True
@@ -329,71 +320,56 @@ def test_create_training_job(self, mock_client, mock_check_training):
                  test_arn_return}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.create_training_job(create_training_params,
-                                            wait_for_completion=False)
+                                            wait_for_completion=False,
+                                            print_log=False)
         mock_session.create_training_job.assert_called_once_with(**create_training_params)
         self.assertEqual(response, test_arn_return)
 
-    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_create_training_job_db_config(self, mock_client, mock_check_training):
-        mock_check_training.return_value = True
-        mock_session = mock.Mock()
-        attrs = {'create_training_job.return_value':
-                 test_arn_return}
-        mock_session.configure_mock(**attrs)
-        mock_client.return_value = mock_session
-        hook_use_db_config = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
-                                           use_db_config=True)
-        response = hook_use_db_config.create_training_job(create_training_params,
-                                                          wait_for_completion=False)
-        updated_config = copy.deepcopy(create_training_params)
-        updated_config.update(db_config)
-        mock_session.create_training_job.assert_called_once_with(**updated_config)
-        self.assertEqual(response, test_arn_return)
-
-    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'check_training_config')
     @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_training_ends_with_wait_on(self, mock_client, mock_check_training):
+    def test_training_ends_with_wait(self, mock_client, mock_check_training):
         mock_check_training.return_value = True
         mock_session = mock.Mock()
         attrs = {'create_training_job.return_value':
                  test_arn_return,
                  'describe_training_job.side_effect':
-                     [DESCRIBE_TRAINING_INPROGRESS_RETURN,
-                      DESCRIBE_TRAINING_STOPPING_RETURN,
-                      DESCRIBE_TRAINING_STOPPED_RETURN,
-                      DESCRIBE_TRAINING_COMPELETED_RETURN]
+                 [DESCRIBE_TRAINING_INPROGRESS_RETURN,
+                  DESCRIBE_TRAINING_STOPPING_RETURN,
+                  DESCRIBE_TRAINING_COMPELETED_RETURN,
+                  DESCRIBE_TRAINING_COMPELETED_RETURN]
                  }
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id_1')
-        hook.create_training_job(create_training_params, wait_for_completion=True)
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id_1')
+        hook.create_training_job(create_training_params, wait_for_completion=True,
+                                 print_log=False, check_interval=1)
         self.assertEqual(mock_session.describe_training_job.call_count, 4)
 
-    @mock.patch.object(SageMakerHook, 'check_valid_training_input')
+    @mock.patch.object(SageMakerHook, 'check_training_config')
     @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_training_throws_error_when_failed_with_wait_on(
+    def test_training_throws_error_when_failed_with_wait(
             self, mock_client, mock_check_training):
         mock_check_training.return_value = True
         mock_session = mock.Mock()
         attrs = {'create_training_job.return_value':
                  test_arn_return,
                  'describe_training_job.side_effect':
-                     [DESCRIBE_TRAINING_INPROGRESS_RETURN,
-                      DESCRIBE_TRAINING_STOPPING_RETURN,
-                      DESCRIBE_TRAINING_STOPPED_RETURN,
-                      DESCRIBE_TRAINING_FAILED_RETURN]
+                 [DESCRIBE_TRAINING_INPROGRESS_RETURN,
+                  DESCRIBE_TRAINING_STOPPING_RETURN,
+                  DESCRIBE_TRAINING_FAILED_RETURN,
+                  DESCRIBE_TRAINING_COMPELETED_RETURN]
                  }
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id_1')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id_1')
         self.assertRaises(AirflowException, hook.create_training_job,
-                          create_training_params, wait_for_completion=True)
-        self.assertEqual(mock_session.describe_training_job.call_count, 4)
+                          create_training_params, wait_for_completion=True,
+                          print_log=False, check_interval=1)
+        self.assertEqual(mock_session.describe_training_job.call_count, 3)
 
-    @mock.patch.object(SageMakerHook, 'check_valid_tuning_input')
+    @mock.patch.object(SageMakerHook, 'check_tuning_config')
     @mock.patch.object(SageMakerHook, 'get_conn')
     def test_create_tuning_job(self, mock_client, mock_check_tuning):
         mock_session = mock.Mock()
@@ -401,33 +377,14 @@ def test_create_tuning_job(self, mock_client, mock_check_tuning):
                  test_arn_return}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.create_tuning_job(create_tuning_params,
                                           wait_for_completion=False)
         mock_session.create_hyper_parameter_tuning_job.\
             assert_called_once_with(**create_tuning_params)
         self.assertEqual(response, test_arn_return)
 
-    @mock.patch.object(SageMakerHook, 'check_valid_tuning_input')
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_create_tuning_job_db_config(self, mock_client, mock_check_tuning):
-        mock_check_tuning.return_value = True
-        mock_session = mock.Mock()
-        attrs = {'create_hyper_parameter_tuning_job.return_value':
-                 test_arn_return}
-        mock_session.configure_mock(**attrs)
-        mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
-                             use_db_config=True)
-        response = hook.create_tuning_job(create_tuning_params,
-                                          wait_for_completion=False)
-        updated_config = copy.deepcopy(create_tuning_params)
-        updated_config.update(db_config)
-        mock_session.create_hyper_parameter_tuning_job. \
-            assert_called_once_with(**updated_config)
-        self.assertEqual(response, test_arn_return)
-
-    @mock.patch.object(SageMakerHook, 'check_for_url')
+    @mock.patch.object(SageMakerHook, 'check_s3_url')
     @mock.patch.object(SageMakerHook, 'get_conn')
     def test_create_transform_job(self, mock_client, mock_check_url):
         mock_check_url.return_value = True
@@ -436,41 +393,64 @@ def test_create_transform_job(self, mock_client, mock_check_url):
                  test_arn_return}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.create_transform_job(create_transform_params,
                                              wait_for_completion=False)
         mock_session.create_transform_job.assert_called_once_with(
             **create_transform_params)
         self.assertEqual(response, test_arn_return)
 
-    @mock.patch.object(SageMakerHook, 'check_for_url')
     @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_create_transform_job_db_config(self, mock_client, mock_check_url):
-        mock_check_url.return_value = True
+    def test_create_model(self, mock_client):
         mock_session = mock.Mock()
-        attrs = {'create_transform_job.return_value':
+        attrs = {'create_model.return_value':
                  test_arn_return}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook_use_db_config = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id',
-                                           use_db_config=True)
-        response = hook_use_db_config.create_transform_job(
-            create_transform_params, wait_for_completion=False)
-        updated_config = copy.deepcopy(create_transform_params)
-        updated_config.update(db_config)
-        mock_session.create_transform_job.assert_called_once_with(**updated_config)
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.create_model(create_model_params)
+        mock_session.create_model.assert_called_once_with(**create_model_params)
         self.assertEqual(response, test_arn_return)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
-    def test_create_model(self, mock_client):
+    def test_create_endpoint_config(self, mock_client):
         mock_session = mock.Mock()
-        attrs = {'create_model.return_value':
+        attrs = {'create_endpoint_config.return_value':
                  test_arn_return}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
-        response = hook.create_model(create_model_params)
-        mock_session.create_model.assert_called_once_with(**create_model_params)
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.create_endpoint_config(create_endpoint_config_params)
+        mock_session.create_endpoint_config\
+            .assert_called_once_with(**create_endpoint_config_params)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_create_endpoint(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'create_endpoint.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.create_endpoint(create_endpoint_params,
+                                        wait_for_completion=False)
+        mock_session.create_endpoint\
+            .assert_called_once_with(**create_endpoint_params)
+        self.assertEqual(response, test_arn_return)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_update_endpoint(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'update_endpoint.return_value':
+                 test_arn_return}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.update_endpoint(update_endpoint_params,
+                                        wait_for_completion=False)
+        mock_session.update_endpoint\
+            .assert_called_once_with(**update_endpoint_params)
         self.assertEqual(response, test_arn_return)
 
     @mock.patch.object(SageMakerHook, 'get_conn')
@@ -479,7 +459,7 @@ def test_describe_training_job(self, mock_client):
         attrs = {'describe_training_job.return_value': 'InProgress'}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.describe_training_job(job_name)
         mock_session.describe_training_job.\
             assert_called_once_with(TrainingJobName=job_name)
@@ -492,7 +472,7 @@ def test_describe_tuning_job(self, mock_client):
                  'InProgress'}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.describe_tuning_job(job_name)
         mock_session.describe_hyper_parameter_tuning_job.\
             assert_called_once_with(HyperParameterTuningJobName=job_name)
@@ -505,12 +485,188 @@ def test_describe_transform_job(self, mock_client):
                  'InProgress'}
         mock_session.configure_mock(**attrs)
         mock_client.return_value = mock_session
-        hook = SageMakerHook(sagemaker_conn_id='sagemaker_test_conn_id')
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
         response = hook.describe_transform_job(job_name)
         mock_session.describe_transform_job.\
             assert_called_once_with(TransformJobName=job_name)
         self.assertEqual(response, 'InProgress')
 
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_model(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_model.return_value':
+                 model_name}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_model(model_name)
+        mock_session.describe_model.\
+            assert_called_once_with(ModelName=model_name)
+        self.assertEqual(response, model_name)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_endpoint_config(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_endpoint_config.return_value':
+                 config_name}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_endpoint_config(config_name)
+        mock_session.describe_endpoint_config.\
+            assert_called_once_with(EndpointConfigName=config_name)
+        self.assertEqual(response, config_name)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_endpoint(self, mock_client):
+        mock_session = mock.Mock()
+        attrs = {'describe_endpoint.return_value':
+                 'InProgress'}
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_endpoint(endpoint_name)
+        mock_session.describe_endpoint.\
+            assert_called_once_with(EndpointName=endpoint_name)
+        self.assertEqual(response, 'InProgress')
+
+    def test_secondary_training_status_changed_true(self):
+        changed = secondary_training_status_changed(SECONDARY_STATUS_DESCRIPTION_1,
+                                                    SECONDARY_STATUS_DESCRIPTION_2)
+        self.assertTrue(changed)
+
+    def test_secondary_training_status_changed_false(self):
+        changed = secondary_training_status_changed(SECONDARY_STATUS_DESCRIPTION_1,
+                                                    SECONDARY_STATUS_DESCRIPTION_1)
+        self.assertFalse(changed)
+
+    def test_secondary_training_status_message_status_changed(self):
+        now = datetime.now(get_localzone())
+        SECONDARY_STATUS_DESCRIPTION_1['LastModifiedTime'] = now
+        expected = '{} {} - {}'.format(
+            datetime.utcfromtimestamp(time.mktime(now.timetuple())).strftime('%Y-%m-%d %H:%M:%S'),
+            status,
+            message
+        )
+        self.assertEqual(
+            secondary_training_status_message(SECONDARY_STATUS_DESCRIPTION_1, SECONDARY_STATUS_DESCRIPTION_2),
+            expected)
+
+    @mock.patch.object(SageMakerHook, 'get_log_conn')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(time, 'time')
+    def test_describe_training_job_with_logs_in_progress(self, mock_time, mock_client, mock_log_client):
+        mock_session = mock.Mock()
+        mock_log_session = mock.Mock()
+        attrs = {'describe_training_job.return_value':
+                 DESCRIBE_TRAINING_COMPELETED_RETURN
+                 }
+        log_attrs = {'describe_log_streams.side_effect':
+                     LIFECYCLE_LOG_STREAMS,
+                     'get_log_events.side_effect':
+                     STREAM_LOG_EVENTS
+                     }
+        mock_time.return_value = 50
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        mock_log_session.configure_mock(**log_attrs)
+        mock_log_client.return_value = mock_log_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_training_job_with_log(job_name=job_name,
+                                                       positions={},
+                                                       stream_names=[],
+                                                       instance_count=1,
+                                                       state=LogState.WAIT_IN_PROGRESS,
+                                                       last_description={},
+                                                       last_describe_job_call=0)
+        self.assertEqual(response, (LogState.JOB_COMPLETE, {}, 50))
+
+    @mock.patch.object(SageMakerHook, 'get_log_conn')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_training_job_with_logs_job_complete(self, mock_client, mock_log_client):
+        mock_session = mock.Mock()
+        mock_log_session = mock.Mock()
+        attrs = {'describe_training_job.return_value':
+                 DESCRIBE_TRAINING_COMPELETED_RETURN
+                 }
+        log_attrs = {'describe_log_streams.side_effect':
+                     LIFECYCLE_LOG_STREAMS,
+                     'get_log_events.side_effect':
+                     STREAM_LOG_EVENTS
+                     }
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        mock_log_session.configure_mock(**log_attrs)
+        mock_log_client.return_value = mock_log_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_training_job_with_log(job_name=job_name,
+                                                       positions={},
+                                                       stream_names=[],
+                                                       instance_count=1,
+                                                       state=LogState.JOB_COMPLETE,
+                                                       last_description={},
+                                                       last_describe_job_call=0)
+        self.assertEqual(response, (LogState.COMPLETE, {}, 0))
+
+    @mock.patch.object(SageMakerHook, 'get_log_conn')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    def test_describe_training_job_with_logs_complete(self, mock_client, mock_log_client):
+        mock_session = mock.Mock()
+        mock_log_session = mock.Mock()
+        attrs = {'describe_training_job.return_value':
+                 DESCRIBE_TRAINING_COMPELETED_RETURN
+                 }
+        log_attrs = {'describe_log_streams.side_effect':
+                     LIFECYCLE_LOG_STREAMS,
+                     'get_log_events.side_effect':
+                     STREAM_LOG_EVENTS
+                     }
+        mock_session.configure_mock(**attrs)
+        mock_client.return_value = mock_session
+        mock_log_session.configure_mock(**log_attrs)
+        mock_log_client.return_value = mock_log_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id')
+        response = hook.describe_training_job_with_log(job_name=job_name,
+                                                       positions={},
+                                                       stream_names=[],
+                                                       instance_count=1,
+                                                       state=LogState.COMPLETE,
+                                                       last_description={},
+                                                       last_describe_job_call=0)
+        self.assertEqual(response, (LogState.COMPLETE, {}, 0))
+
+    @mock.patch.object(SageMakerHook, 'check_training_config')
+    @mock.patch.object(SageMakerHook, 'get_log_conn')
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'describe_training_job_with_log')
+    def test_training_with_logs(self, mock_describe, mock_client, mock_log_client, mock_check_training):
+        mock_check_training.return_value = True
+        mock_describe.side_effect = \
+            [(LogState.WAIT_IN_PROGRESS, DESCRIBE_TRAINING_INPROGRESS_RETURN, 0),
+             (LogState.JOB_COMPLETE, DESCRIBE_TRAINING_STOPPING_RETURN, 0),
+             (LogState.COMPLETE, DESCRIBE_TRAINING_COMPELETED_RETURN, 0)]
+        mock_session = mock.Mock()
+        mock_log_session = mock.Mock()
+        attrs = {'create_training_job.return_value':
+                 test_arn_return,
+                 'describe_training_job.return_value':
+                     DESCRIBE_TRAINING_COMPELETED_RETURN
+                 }
+        log_attrs = {'describe_log_streams.side_effect':
+                     LIFECYCLE_LOG_STREAMS,
+                     'get_log_events.side_effect':
+                     STREAM_LOG_EVENTS
+                     }
+        mock_session.configure_mock(**attrs)
+        mock_log_session.configure_mock(**log_attrs)
+        mock_client.return_value = mock_session
+        mock_log_client.return_value = mock_log_session
+        hook = SageMakerHook(aws_conn_id='sagemaker_test_conn_id_1')
+        hook.create_training_job(create_training_params, wait_for_completion=True,
+                                 print_log=True, check_interval=1)
+        self.assertEqual(mock_describe.call_count, 3)
+        self.assertEqual(mock_session.describe_training_job.call_count, 1)
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_base_operator.py b/tests/contrib/operators/test_sagemaker_base_operator.py
new file mode 100644
index 0000000000000..996e61e20f2d1
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_base_operator.py
@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# 'License'); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+
+config = {
+    'key1': '1',
+    'key2': {
+        'key3': '3',
+        'key4': '4'
+    },
+    'key5': [
+        {
+            'key6': '6'
+        },
+        {
+            'key6': '7'
+        }
+    ]
+}
+
+parsed_config = {
+    'key1': 1,
+    'key2': {
+        'key3': 3,
+        'key4': 4
+    },
+    'key5': [
+        {
+            'key6': 6
+        },
+        {
+            'key6': 7
+        }
+    ]
+}
+
+
+class TestSageMakerBaseOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerBaseOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=config
+        )
+
+    def test_parse_integer(self):
+        self.sagemaker.integer_fields = [
+            ['key1'], ['key2', 'key3'], ['key2', 'key4'], ['key5', 'key6']
+        ]
+        self.sagemaker.parse_config_integers()
+        self.assertEqual(self.sagemaker.config, parsed_config)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_create_training_job_operator.py b/tests/contrib/operators/test_sagemaker_create_training_job_operator.py
deleted file mode 100644
index 156c9d74c79ec..0000000000000
--- a/tests/contrib/operators/test_sagemaker_create_training_job_operator.py
+++ /dev/null
@@ -1,141 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-from airflow import configuration
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.contrib.operators.sagemaker_create_training_job_operator \
-    import SageMakerCreateTrainingJobOperator
-from airflow.exceptions import AirflowException
-
-role = "test-role"
-
-bucket = "test-bucket"
-
-key = "test/data"
-data_url = "s3://{}/{}".format(bucket, key)
-
-job_name = "test-job-name"
-
-image = "test-image"
-
-output_url = "s3://{}/test/output".format(bucket)
-create_training_params = \
-    {
-        "AlgorithmSpecification": {
-            "TrainingImage": image,
-            "TrainingInputMode": "File"
-        },
-        "RoleArn": role,
-        "OutputDataConfig": {
-            "S3OutputPath": output_url
-        },
-        "ResourceConfig": {
-            "InstanceCount": 2,
-            "InstanceType": "ml.c4.8xlarge",
-            "VolumeSizeInGB": 50
-        },
-        "TrainingJobName": job_name,
-        "HyperParameters": {
-            "k": "10",
-            "feature_dim": "784",
-            "mini_batch_size": "500",
-            "force_dense": "True"
-        },
-        "StoppingCondition": {
-            "MaxRuntimeInSeconds": 60 * 60
-        },
-        "InputDataConfig": [
-            {
-                "ChannelName": "train",
-                "DataSource": {
-                    "S3DataSource": {
-                        "S3DataType": "S3Prefix",
-                        "S3Uri": data_url,
-                        "S3DataDistributionType": "FullyReplicated"
-                    }
-                },
-                "CompressionType": "None",
-                "RecordWrapperType": "None"
-            }
-        ]
-    }
-
-
-class TestSageMakerTrainingOperator(unittest.TestCase):
-
-    def setUp(self):
-        configuration.load_test_config()
-        self.sagemaker = SageMakerCreateTrainingJobOperator(
-            task_id='test_sagemaker_operator',
-            sagemaker_conn_id='sagemaker_test_id',
-            training_job_config=create_training_params,
-            region_name='us-west-2',
-            use_db_config=True,
-            wait_for_completion=False,
-            check_interval=5
-        )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_training_job')
-    @mock.patch.object(SageMakerHook, '__init__')
-    def test_hook_init(self, hook_init, mock_training, mock_client):
-        mock_training.return_value = {"TrainingJobArn": "testarn",
-                                      "ResponseMetadata":
-                                          {"HTTPStatusCode": 200}}
-        hook_init.return_value = None
-        self.sagemaker.execute(None)
-        hook_init.assert_called_once_with(
-            sagemaker_conn_id='sagemaker_test_id',
-            region_name='us-west-2',
-            use_db_config=True,
-            check_interval=5,
-            max_ingestion_time=None
-        )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_training_job')
-    def test_execute_without_failure(self, mock_training, mock_client):
-        mock_training.return_value = {"TrainingJobArn": "testarn",
-                                      "ResponseMetadata":
-                                          {"HTTPStatusCode": 200}}
-        self.sagemaker.execute(None)
-        mock_training.assert_called_once_with(create_training_params,
-                                              wait_for_completion=False
-                                              )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_training_job')
-    def test_execute_with_failure(self, mock_training, mock_client):
-        mock_training.return_value = {"TrainingJobArn": "testarn",
-                                      "ResponseMetadata":
-                                          {"HTTPStatusCode": 404}}
-        self.assertRaises(AirflowException, self.sagemaker.execute, None)
-
-
-if __name__ == '__main__':
-    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_training_operator.py b/tests/contrib/operators/test_sagemaker_training_operator.py
new file mode 100644
index 0000000000000..147b7f1bb7fac
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_training_operator.py
@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# 'License'); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_training_operator \
+    import SageMakerTrainingOperator
+from airflow.exceptions import AirflowException
+
+role = 'arn:aws:iam:role/test-role'
+
+bucket = 'test-bucket'
+
+key = 'test/data'
+data_url = 's3://{}/{}'.format(bucket, key)
+
+job_name = 'test-job-name'
+
+image = 'test-image'
+
+output_url = 's3://{}/test/output'.format(bucket)
+create_training_params = \
+    {
+        'AlgorithmSpecification': {
+            'TrainingImage': image,
+            'TrainingInputMode': 'File'
+        },
+        'RoleArn': role,
+        'OutputDataConfig': {
+            'S3OutputPath': output_url
+        },
+        'ResourceConfig': {
+            'InstanceCount': '2',
+            'InstanceType': 'ml.c4.8xlarge',
+            'VolumeSizeInGB': '50'
+        },
+        'TrainingJobName': job_name,
+        'HyperParameters': {
+            'k': '10',
+            'feature_dim': '784',
+            'mini_batch_size': '500',
+            'force_dense': 'True'
+        },
+        'StoppingCondition': {
+            'MaxRuntimeInSeconds': '3600'
+        },
+        'InputDataConfig': [
+            {
+                'ChannelName': 'train',
+                'DataSource': {
+                    'S3DataSource': {
+                        'S3DataType': 'S3Prefix',
+                        'S3Uri': data_url,
+                        'S3DataDistributionType': 'FullyReplicated'
+                    }
+                },
+                'CompressionType': 'None',
+                'RecordWrapperType': 'None'
+            }
+        ]
+    }
+
+
+class TestSageMakerTrainingOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerTrainingOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=create_training_params,
+            wait_for_completion=False,
+            check_interval=5
+        )
+
+    def test_parse_config_integers(self):
+        self.sagemaker.parse_config_integers()
+        self.assertEqual(self.sagemaker.config['ResourceConfig']['InstanceCount'],
+                         int(self.sagemaker.config['ResourceConfig']['InstanceCount']))
+        self.assertEqual(self.sagemaker.config['ResourceConfig']['VolumeSizeInGB'],
+                         int(self.sagemaker.config['ResourceConfig']['VolumeSizeInGB']))
+        self.assertEqual(self.sagemaker.config['StoppingCondition']['MaxRuntimeInSeconds'],
+                         int(self.sagemaker.config['StoppingCondition']['MaxRuntimeInSeconds']))
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_training_job')
+    def test_execute(self, mock_training, mock_client):
+        mock_training.return_value = {'TrainingJobArn': 'testarn',
+                                      'ResponseMetadata':
+                                          {'HTTPStatusCode': 200}}
+        self.sagemaker.execute(None)
+        mock_training.assert_called_once_with(create_training_params,
+                                              wait_for_completion=False,
+                                              print_log=True,
+                                              check_interval=5,
+                                              max_ingestion_time=None
+                                              )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_training_job')
+    def test_execute_with_failure(self, mock_training, mock_client):
+        mock_training.return_value = {'TrainingJobArn': 'testarn',
+                                      'ResponseMetadata':
+                                          {'HTTPStatusCode': 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_transform_operator.py b/tests/contrib/operators/test_sagemaker_transform_operator.py
new file mode 100644
index 0000000000000..e6bc4272b1cb0
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_transform_operator.py
@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_transform_operator \
+    import SageMakerTransformOperator
+from airflow.exceptions import AirflowException
+
+role = 'arn:aws:iam:role/test-role'
+
+bucket = 'test-bucket'
+
+key = 'test/data'
+data_url = 's3://{}/{}'.format(bucket, key)
+
+job_name = 'test-job-name'
+
+model_name = 'test-model-name'
+
+image = 'test-image'
+
+output_url = 's3://{}/test/output'.format(bucket)
+
+create_transform_params = {
+    'TransformJobName': job_name,
+    'ModelName': model_name,
+    'MaxConcurrentTransforms': '12',
+    'MaxPayloadInMB': '6',
+    'BatchStrategy': 'MultiRecord',
+    'TransformInput': {
+        'DataSource': {
+            'S3DataSource': {
+                'S3DataType': 'S3Prefix',
+                'S3Uri': data_url
+            }
+        }
+    },
+    'TransformOutput': {
+        'S3OutputPath': output_url,
+    },
+    'TransformResources': {
+        'InstanceType': 'ml.m4.xlarge',
+        'InstanceCount': '3'
+    }
+}
+
+create_model_params = {
+    'ModelName': model_name,
+    'PrimaryContainer': {
+        'Image': image,
+        'ModelDataUrl': output_url,
+    },
+    'ExecutionRoleArn': role
+}
+
+config = {
+    'Model': create_model_params,
+    'Transform': create_transform_params
+}
+
+
+class TestSageMakerTransformOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerTransformOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=config,
+            wait_for_completion=False,
+            check_interval=5
+        )
+
+    def test_parse_config_integers(self):
+        self.sagemaker.parse_config_integers()
+        test_config = self.sagemaker.config['Transform']
+        self.assertEqual(test_config['TransformResources']['InstanceCount'],
+                         int(test_config['TransformResources']['InstanceCount']))
+        self.assertEqual(test_config['MaxConcurrentTransforms'],
+                         int(test_config['MaxConcurrentTransforms']))
+        self.assertEqual(test_config['MaxPayloadInMB'],
+                         int(test_config['MaxPayloadInMB']))
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_transform_job')
+    def test_execute(self, mock_transform, mock_model, mock_client):
+        mock_transform.return_value = {'TransformJobArn': 'testarn',
+                                       'ResponseMetadata':
+                                       {'HTTPStatusCode': 200}}
+        self.sagemaker.execute(None)
+        mock_model.assert_called_once_with(create_model_params)
+        mock_transform.assert_called_once_with(create_transform_params,
+                                               wait_for_completion=False,
+                                               check_interval=5,
+                                               max_ingestion_time=None
+                                               )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_transform_job')
+    def test_execute_with_failure(self, mock_transform, mock_model, mock_client):
+        mock_transform.return_value = {'TransformJobArn': 'testarn',
+                                       'ResponseMetadata':
+                                       {'HTTPStatusCode': 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py b/tests/contrib/operators/test_sagemaker_tuning_operator.py
similarity index 71%
rename from tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py
rename to tests/contrib/operators/test_sagemaker_tuning_operator.py
index d317cff6f2289..9ec533fa869b4 100644
--- a/tests/contrib/operators/test_sagemaker_create_tuning_job_operator.py
+++ b/tests/contrib/operators/test_sagemaker_tuning_operator.py
@@ -28,11 +28,11 @@
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.contrib.operators.sagemaker_create_tuning_job_operator \
-    import SageMakerCreateTuningJobOperator
+from airflow.contrib.operators.sagemaker_tuning_operator \
+    import SageMakerTuningOperator
 from airflow.exceptions import AirflowException
 
-role = 'test-role'
+role = 'arn:aws:iam:role/test-role'
 
 bucket = 'test-bucket'
 
@@ -53,8 +53,8 @@
                                 'MetricName': 'test_metric'
                             },
                             'ResourceLimits': {
-                                'MaxNumberOfTrainingJobs': 123,
-                                'MaxParallelTrainingJobs': 123
+                                'MaxNumberOfTrainingJobs': '123',
+                                'MaxParallelTrainingJobs': '123'
                             },
                             'ParameterRanges': {
                                 'IntegerParameterRanges': [
@@ -79,7 +79,7 @@
                                     'TrainingImage': image,
                                     'TrainingInputMode': 'File'
                                 },
-                            'RoleArn': 'string',
+                            'RoleArn': role,
                             'InputDataConfig':
                                 [
                                     {
@@ -102,55 +102,58 @@
                                 },
                             'ResourceConfig':
                                 {
-                                    'InstanceCount': 2,
+                                    'InstanceCount': '2',
                                     'InstanceType': 'ml.c4.8xlarge',
-                                    'VolumeSizeInGB': 50
+                                    'VolumeSizeInGB': '50'
                                 },
                             'StoppingCondition': dict(MaxRuntimeInSeconds=60 * 60)
                         }
                         }
 
 
-class TestSageMakerTrainingOperator(unittest.TestCase):
+class TestSageMakerTuningOperator(unittest.TestCase):
 
     def setUp(self):
         configuration.load_test_config()
-        self.sagemaker = SageMakerCreateTuningJobOperator(
+        self.sagemaker = SageMakerTuningOperator(
             task_id='test_sagemaker_operator',
-            sagemaker_conn_id='sagemaker_test_conn',
-            tuning_job_config=create_tuning_params,
-            region_name='us-east-1',
-            use_db_config=False,
+            aws_conn_id='sagemaker_test_conn',
+            config=create_tuning_params,
             wait_for_completion=False,
             check_interval=5
         )
 
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_tuning_job')
-    @mock.patch.object(SageMakerHook, '__init__')
-    def test_hook_init(self, hook_init, mock_tuning, mock_client):
-        mock_tuning.return_value = {'TrainingJobArn': 'testarn',
-                                    'ResponseMetadata':
-                                    {'HTTPStatusCode': 200}}
-        hook_init.return_value = None
-        self.sagemaker.execute(None)
-        hook_init.assert_called_once_with(
-            sagemaker_conn_id='sagemaker_test_conn',
-            region_name='us-east-1',
-            use_db_config=False,
-            check_interval=5,
-            max_ingestion_time=None
-        )
+    def test_parse_config_integers(self):
+        self.sagemaker.parse_config_integers()
+        self.assertEqual(self.sagemaker.config['TrainingJobDefinition']['ResourceConfig']
+                         ['InstanceCount'],
+                         int(self.sagemaker.config['TrainingJobDefinition']['ResourceConfig']
+                             ['InstanceCount']))
+        self.assertEqual(self.sagemaker.config['TrainingJobDefinition']['ResourceConfig']
+                         ['VolumeSizeInGB'],
+                         int(self.sagemaker.config['TrainingJobDefinition']['ResourceConfig']
+                             ['VolumeSizeInGB']))
+        self.assertEqual(self.sagemaker.config['HyperParameterTuningJobConfig']['ResourceLimits']
+                         ['MaxNumberOfTrainingJobs'],
+                         int(self.sagemaker.config['HyperParameterTuningJobConfig']['ResourceLimits']
+                             ['MaxNumberOfTrainingJobs']))
+        self.assertEqual(self.sagemaker.config['HyperParameterTuningJobConfig']['ResourceLimits']
+                         ['MaxParallelTrainingJobs'],
+                         int(self.sagemaker.config['HyperParameterTuningJobConfig']['ResourceLimits']
+                             ['MaxParallelTrainingJobs']))
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, 'create_tuning_job')
-    def test_execute_without_failure(self, mock_tuning, mock_client):
+    def test_execute(self, mock_tuning, mock_client):
         mock_tuning.return_value = {'TrainingJobArn': 'testarn',
                                     'ResponseMetadata':
                                     {'HTTPStatusCode': 200}}
         self.sagemaker.execute(None)
         mock_tuning.assert_called_once_with(create_tuning_params,
-                                            wait_for_completion=False)
+                                            wait_for_completion=False,
+                                            check_interval=5,
+                                            max_ingestion_time=None
+                                            )
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, 'create_tuning_job')
diff --git a/tests/contrib/sensors/test_sagemaker_base_sensor.py b/tests/contrib/sensors/test_sagemaker_base_sensor.py
index bc8cbe349858f..5870544838033 100644
--- a/tests/contrib/sensors/test_sagemaker_base_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_base_sensor.py
@@ -28,7 +28,7 @@ class TestSagemakerBaseSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
 
-    def test_subclasses_succeed_when_response_is_good(self):
+    def test_execute(self):
         class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
             def non_terminal_states(self):
                 return ['PENDING', 'RUNNING', 'CONTINUE']
@@ -53,7 +53,7 @@ def state_from_response(self, response):
 
         sensor.execute(None)
 
-    def test_poke_returns_false_when_state_is_a_non_terminal_state(self):
+    def test_poke_with_unfinished_job(self):
         class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
             def non_terminal_states(self):
                 return ['PENDING', 'RUNNING', 'CONTINUE']
@@ -78,7 +78,7 @@ def state_from_response(self, response):
 
         self.assertEqual(sensor.poke(None), False)
 
-    def test_poke_raise_exception_when_method_not_implemented(self):
+    def test_poke_with_not_implemented_method(self):
         class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
             def non_terminal_states(self):
                 return ['PENDING', 'RUNNING', 'CONTINUE']
@@ -92,9 +92,9 @@ def failed_states(self):
             aws_conn_id='aws_test'
         )
 
-        self.assertRaises(AirflowException, sensor.poke, None)
+        self.assertRaises(NotImplementedError, sensor.poke, None)
 
-    def test_poke_returns_false_when_http_response_is_bad(self):
+    def test_poke_with_bad_response(self):
         class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
             def non_terminal_states(self):
                 return ['PENDING', 'RUNNING', 'CONTINUE']
@@ -119,7 +119,7 @@ def state_from_response(self, response):
 
         self.assertEqual(sensor.poke(None), False)
 
-    def test_poke_raises_error_when_job_has_failed(self):
+    def test_poke_with_job_failure(self):
         class SageMakerBaseSensorSubclass(SageMakerBaseSensor):
             def non_terminal_states(self):
                 return ['PENDING', 'RUNNING', 'CONTINUE']
diff --git a/tests/contrib/sensors/test_sagemaker_training_sensor.py b/tests/contrib/sensors/test_sagemaker_training_sensor.py
index fb966f60afbf0..5861d7a6fdb15 100644
--- a/tests/contrib/sensors/test_sagemaker_training_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_training_sensor.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import unittest
+from datetime import datetime
 
 try:
     from unittest import mock
@@ -30,55 +31,51 @@
 from airflow import configuration
 from airflow.contrib.sensors.sagemaker_training_sensor \
     import SageMakerTrainingSensor
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook, LogState
 from airflow.exceptions import AirflowException
 
-DESCRIBE_TRAINING_INPROGRESS_RETURN = {
-    'TrainingJobStatus': 'InProgress',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
-}
-DESCRIBE_TRAINING_COMPELETED_RETURN = {
-    'TrainingJobStatus': 'Compeleted',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
-}
-DESCRIBE_TRAINING_FAILED_RETURN = {
-    'TrainingJobStatus': 'Failed',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
+DESCRIBE_TRAINING_COMPELETED_RESPONSE = {
+    'TrainingJobStatus': 'Completed',
+    'ResourceConfig': {
+        'InstanceCount': 1,
+        'InstanceType': 'ml.c4.xlarge',
+        'VolumeSizeInGB': 10
     },
-    'FailureReason': 'Unknown'
-}
-DESCRIBE_TRAINING_STOPPING_RETURN = {
-    'TrainingJobStatus': 'Stopping',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
-}
-DESCRIBE_TRAINING_STOPPED_RETURN = {
-    'TrainingJobStatus': 'Stopped',
+    'TrainingStartTime': datetime(2018, 2, 17, 7, 15, 0, 103000),
+    'TrainingEndTime': datetime(2018, 2, 17, 7, 19, 34, 953000),
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
 
+DESCRIBE_TRAINING_INPROGRESS_RESPONSE = dict(DESCRIBE_TRAINING_COMPELETED_RESPONSE)
+DESCRIBE_TRAINING_INPROGRESS_RESPONSE.update({'TrainingJobStatus': 'InProgress'})
+
+DESCRIBE_TRAINING_FAILED_RESPONSE = dict(DESCRIBE_TRAINING_COMPELETED_RESPONSE)
+DESCRIBE_TRAINING_FAILED_RESPONSE.update({'TrainingJobStatus': 'Failed',
+                                          'FailureReason': 'Unknown'})
+
+DESCRIBE_TRAINING_STOPPING_RESPONSE = dict(DESCRIBE_TRAINING_COMPELETED_RESPONSE)
+DESCRIBE_TRAINING_STOPPING_RESPONSE.update({'TrainingJobStatus': 'Stopping'})
+
 
 class TestSageMakerTrainingSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
 
     @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
     @mock.patch.object(SageMakerHook, 'describe_training_job')
-    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
-        mock_describe_job.side_effect = [DESCRIBE_TRAINING_FAILED_RETURN]
+    def test_sensor_with_failure(self, mock_describe_job, hook_init, mock_client):
+        hook_init.return_value = None
+
+        mock_describe_job.side_effect = [DESCRIBE_TRAINING_FAILED_RESPONSE]
         sensor = SageMakerTrainingSensor(
             task_id='test_task',
             poke_interval=2,
             aws_conn_id='aws_test',
-            job_name='test_job_name'
+            job_name='test_job_name',
+            print_log=False
         )
         self.assertRaises(AirflowException, sensor.execute, None)
         mock_describe_job.assert_called_once_with('test_job_name')
@@ -86,32 +83,59 @@ def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, '__init__')
     @mock.patch.object(SageMakerHook, 'describe_training_job')
-    def test_calls_until_a_terminal_state(self,
-                                          mock_describe_job, hook_init, mock_client):
+    def test_sensor(self, mock_describe_job, hook_init, mock_client):
         hook_init.return_value = None
 
         mock_describe_job.side_effect = [
-            DESCRIBE_TRAINING_INPROGRESS_RETURN,
-            DESCRIBE_TRAINING_STOPPING_RETURN,
-            DESCRIBE_TRAINING_STOPPED_RETURN,
-            DESCRIBE_TRAINING_COMPELETED_RETURN
+            DESCRIBE_TRAINING_INPROGRESS_RESPONSE,
+            DESCRIBE_TRAINING_STOPPING_RESPONSE,
+            DESCRIBE_TRAINING_COMPELETED_RESPONSE
         ]
         sensor = SageMakerTrainingSensor(
             task_id='test_task',
             poke_interval=2,
             aws_conn_id='aws_test',
             job_name='test_job_name',
-            region_name='us-east-1'
+            print_log=False
         )
 
         sensor.execute(None)
 
         # make sure we called 4 times(terminated when its compeleted)
-        self.assertEqual(mock_describe_job.call_count, 4)
+        self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params
-        hook_init.assert_called_with(aws_conn_id='aws_test',
-                                     region_name='us-east-1')
+        hook_init.assert_called_with(aws_conn_id='aws_test')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'get_log_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
+    @mock.patch.object(SageMakerHook, 'describe_training_job_with_log')
+    @mock.patch.object(SageMakerHook, 'describe_training_job')
+    def test_sensor_with_log(self, mock_describe_job, mock_describe_job_with_log,
+                             hook_init, mock_log_client, mock_client):
+        hook_init.return_value = None
+
+        mock_describe_job.return_value = DESCRIBE_TRAINING_COMPELETED_RESPONSE
+        mock_describe_job_with_log.side_effect = [
+            (LogState.WAIT_IN_PROGRESS, DESCRIBE_TRAINING_INPROGRESS_RESPONSE, 0),
+            (LogState.JOB_COMPLETE, DESCRIBE_TRAINING_STOPPING_RESPONSE, 0),
+            (LogState.COMPLETE, DESCRIBE_TRAINING_COMPELETED_RESPONSE, 0)
+        ]
+        sensor = SageMakerTrainingSensor(
+            task_id='test_task',
+            poke_interval=2,
+            aws_conn_id='aws_test',
+            job_name='test_job_name',
+            print_log=True
+        )
+
+        sensor.execute(None)
+
+        self.assertEqual(mock_describe_job_with_log.call_count, 3)
+        self.assertEqual(mock_describe_job.call_count, 1)
+
+        hook_init.assert_called_with(aws_conn_id='aws_test')
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/sensors/test_sagemaker_transform_sensor.py b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
index bb4a184bb2797..1394920d5dc3d 100644
--- a/tests/contrib/sensors/test_sagemaker_transform_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
@@ -33,37 +33,31 @@
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.exceptions import AirflowException
 
-DESCRIBE_TRANSFORM_INPROGRESS_RETURN = {
+DESCRIBE_TRANSFORM_INPROGRESS_RESPONSE = {
     'TransformJobStatus': 'InProgress',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TRANSFORM_COMPELETED_RETURN = {
+DESCRIBE_TRANSFORM_COMPELETED_RESPONSE = {
     'TransformJobStatus': 'Compeleted',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TRANSFORM_FAILED_RETURN = {
+DESCRIBE_TRANSFORM_FAILED_RESPONSE = {
     'TransformJobStatus': 'Failed',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     },
     'FailureReason': 'Unknown'
 }
-DESCRIBE_TRANSFORM_STOPPING_RETURN = {
+DESCRIBE_TRANSFORM_STOPPING_RESPONSE = {
     'TransformJobStatus': 'Stopping',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TRANSFORM_STOPPED_RETURN = {
-    'TransformJobStatus': 'Stopped',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
-}
 
 
 class TestSageMakerTransformSensor(unittest.TestCase):
@@ -72,8 +66,8 @@ def setUp(self):
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, 'describe_transform_job')
-    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
-        mock_describe_job.side_effect = [DESCRIBE_TRANSFORM_FAILED_RETURN]
+    def test_sensor_with_failure(self, mock_describe_job, mock_client):
+        mock_describe_job.side_effect = [DESCRIBE_TRANSFORM_FAILED_RESPONSE]
         sensor = SageMakerTransformSensor(
             task_id='test_task',
             poke_interval=2,
@@ -86,32 +80,28 @@ def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, '__init__')
     @mock.patch.object(SageMakerHook, 'describe_transform_job')
-    def test_calls_until_a_terminal_state(self,
-                                          mock_describe_job, hook_init, mock_client):
+    def test_sensor(self, mock_describe_job, hook_init, mock_client):
         hook_init.return_value = None
 
         mock_describe_job.side_effect = [
-            DESCRIBE_TRANSFORM_INPROGRESS_RETURN,
-            DESCRIBE_TRANSFORM_STOPPING_RETURN,
-            DESCRIBE_TRANSFORM_STOPPED_RETURN,
-            DESCRIBE_TRANSFORM_COMPELETED_RETURN
+            DESCRIBE_TRANSFORM_INPROGRESS_RESPONSE,
+            DESCRIBE_TRANSFORM_STOPPING_RESPONSE,
+            DESCRIBE_TRANSFORM_COMPELETED_RESPONSE
         ]
         sensor = SageMakerTransformSensor(
             task_id='test_task',
             poke_interval=2,
             aws_conn_id='aws_test',
-            job_name='test_job_name',
-            region_name='us-east-1'
+            job_name='test_job_name'
         )
 
         sensor.execute(None)
 
         # make sure we called 4 times(terminated when its compeleted)
-        self.assertEqual(mock_describe_job.call_count, 4)
+        self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params
-        hook_init.assert_called_with(aws_conn_id='aws_test',
-                                     region_name='us-east-1')
+        hook_init.assert_called_with(aws_conn_id='aws_test')
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
index 49f9b41b07c89..8c0ba11380c1a 100644
--- a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
@@ -33,37 +33,34 @@
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.exceptions import AirflowException
 
-DESCRIBE_TUNING_INPROGRESS_RETURN = {
+DESCRIBE_TUNING_INPROGRESS_RESPONSE = {
     'HyperParameterTuningJobStatus': 'InProgress',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TUNING_COMPELETED_RETURN = {
+
+DESCRIBE_TUNING_COMPELETED_RESPONSE = {
     'HyperParameterTuningJobStatus': 'Compeleted',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TUNING_FAILED_RETURN = {
+
+DESCRIBE_TUNING_FAILED_RESPONSE = {
     'HyperParameterTuningJobStatus': 'Failed',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     },
     'FailureReason': 'Unknown'
 }
-DESCRIBE_TUNING_STOPPING_RETURN = {
+
+DESCRIBE_TUNING_STOPPING_RESPONSE = {
     'HyperParameterTuningJobStatus': 'Stopping',
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
     }
 }
-DESCRIBE_TUNING_STOPPED_RETURN = {
-    'HyperParameterTuningJobStatus': 'Stopped',
-    'ResponseMetadata': {
-        'HTTPStatusCode': 200,
-    }
-}
 
 
 class TestSageMakerTuningSensor(unittest.TestCase):
@@ -72,8 +69,8 @@ def setUp(self):
 
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, 'describe_tuning_job')
-    def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
-        mock_describe_job.side_effect = [DESCRIBE_TUNING_FAILED_RETURN]
+    def test_sensor_with_failure(self, mock_describe_job, mock_client):
+        mock_describe_job.side_effect = [DESCRIBE_TUNING_FAILED_RESPONSE]
         sensor = SageMakerTuningSensor(
             task_id='test_task',
             poke_interval=2,
@@ -86,32 +83,28 @@ def test_raises_errors_failed_state(self, mock_describe_job, mock_client):
     @mock.patch.object(SageMakerHook, 'get_conn')
     @mock.patch.object(SageMakerHook, '__init__')
     @mock.patch.object(SageMakerHook, 'describe_tuning_job')
-    def test_calls_until_a_terminal_state(self,
-                                          mock_describe_job, hook_init, mock_client):
+    def test_sensor(self, mock_describe_job, hook_init, mock_client):
         hook_init.return_value = None
 
         mock_describe_job.side_effect = [
-            DESCRIBE_TUNING_INPROGRESS_RETURN,
-            DESCRIBE_TUNING_STOPPING_RETURN,
-            DESCRIBE_TUNING_STOPPED_RETURN,
-            DESCRIBE_TUNING_COMPELETED_RETURN
+            DESCRIBE_TUNING_INPROGRESS_RESPONSE,
+            DESCRIBE_TUNING_STOPPING_RESPONSE,
+            DESCRIBE_TUNING_COMPELETED_RESPONSE
         ]
         sensor = SageMakerTuningSensor(
             task_id='test_task',
             poke_interval=2,
             aws_conn_id='aws_test',
-            job_name='test_job_name',
-            region_name='us-east-1'
+            job_name='test_job_name'
         )
 
         sensor.execute(None)
 
         # make sure we called 4 times(terminated when its compeleted)
-        self.assertEqual(mock_describe_job.call_count, 4)
+        self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params
-        hook_init.assert_called_with(aws_conn_id='aws_test',
-                                     region_name='us-east-1')
+        hook_init.assert_called_with(aws_conn_id='aws_test')
 
 
 if __name__ == '__main__':
diff --git a/tests/hooks/test_s3_hook.py b/tests/hooks/test_s3_hook.py
index baac20386feb9..8553e3b6471e9 100644
--- a/tests/hooks/test_s3_hook.py
+++ b/tests/hooks/test_s3_hook.py
@@ -19,6 +19,7 @@
 #
 
 import mock
+import tempfile
 import unittest
 
 from airflow import configuration
@@ -66,6 +67,31 @@ def test_get_bucket(self):
         b = hook.get_bucket('bucket')
         self.assertIsNotNone(b)
 
+    @mock_s3
+    def test_create_bucket_default_region(self):
+        hook = S3Hook(aws_conn_id=None)
+        hook.create_bucket(bucket_name='new_bucket')
+        b = hook.get_bucket('new_bucket')
+        self.assertIsNotNone(b)
+
+    @mock_s3
+    def test_create_bucket_us_standard_region(self):
+        hook = S3Hook(aws_conn_id=None)
+        hook.create_bucket(bucket_name='new_bucket', region_name='us-east-1')
+        b = hook.get_bucket('new_bucket')
+        self.assertIsNotNone(b)
+        region = b.meta.client.get_bucket_location(Bucket=b.name).get('LocationConstraint', None)
+        self.assertEqual(region, 'us-east-1')
+
+    @mock_s3
+    def test_create_bucket_other_region(self):
+        hook = S3Hook(aws_conn_id=None)
+        hook.create_bucket(bucket_name='new_bucket', region_name='us-east-2')
+        b = hook.get_bucket('new_bucket')
+        self.assertIsNotNone(b)
+        region = b.meta.client.get_bucket_location(Bucket=b.name).get('LocationConstraint', None)
+        self.assertEqual(region, 'us-east-2')
+
     @mock_s3
     def test_check_for_prefix(self):
         hook = S3Hook(aws_conn_id=None)
@@ -241,6 +267,21 @@ def test_load_bytes(self):
 
         self.assertEqual(body, b'Content')
 
+    @mock_s3
+    def test_load_fileobj(self):
+        hook = S3Hook(aws_conn_id=None)
+        conn = hook.get_conn()
+        # We need to create the bucket since this is all in Moto's 'virtual'
+        # AWS account
+        conn.create_bucket(Bucket="mybucket")
+        with tempfile.TemporaryFile() as temp_file:
+            temp_file.write(b"Content")
+            temp_file.seek(0)
+            hook.load_file_obj(temp_file, "my_key", "mybucket")
+            body = boto3.resource('s3').Object('mybucket', 'my_key').get()['Body'].read()
+
+            self.assertEqual(body, b'Content')
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/operators/test_sagemaker_create_transform_job_operator.py b/tests/operators/test_sagemaker_create_transform_job_operator.py
deleted file mode 100644
index a8701530d9daa..0000000000000
--- a/tests/operators/test_sagemaker_create_transform_job_operator.py
+++ /dev/null
@@ -1,140 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-from airflow import configuration
-from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
-from airflow.contrib.operators.sagemaker_create_transform_job_operator \
-    import SageMakerCreateTransformJobOperator
-from airflow.exceptions import AirflowException
-
-role = 'test-role'
-
-bucket = 'test-bucket'
-
-key = 'test/data'
-data_url = 's3://{}/{}'.format(bucket, key)
-
-job_name = 'test-job-name'
-
-model_name = 'test-model-name'
-
-image = 'test-image'
-
-output_url = 's3://{}/test/output'.format(bucket)
-
-create_transform_params = \
-    {
-        'TransformJobName': job_name,
-        'ModelName': model_name,
-        'BatchStrategy': 'MultiRecord',
-        'TransformInput': {
-            'DataSource': {
-                'S3DataSource': {
-                    'S3DataType': 'S3Prefix',
-                    'S3Uri': data_url
-                }
-            }
-        },
-        'TransformOutput': {
-            'S3OutputPath': output_url,
-        },
-        'TransformResources': {
-            'InstanceType': 'ml.m4.xlarge',
-            'InstanceCount': 123
-        }
-    }
-
-create_model_params = \
-    {
-        'ModelName': model_name,
-        'PrimaryContainer': {
-            'Image': image,
-            'ModelDataUrl': output_url,
-        },
-        'ExecutionRoleArn': role
-    }
-
-
-class TestSageMakertransformOperator(unittest.TestCase):
-
-    def setUp(self):
-        configuration.load_test_config()
-        self.sagemaker = SageMakerCreateTransformJobOperator(
-            task_id='test_sagemaker_operator',
-            sagemaker_conn_id='sagemaker_test_id',
-            transform_job_config=create_transform_params,
-            model_config=create_model_params,
-            region_name='us-west-2',
-            use_db_config=True,
-            wait_for_completion=False,
-            check_interval=5
-        )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_model')
-    @mock.patch.object(SageMakerHook, 'create_transform_job')
-    @mock.patch.object(SageMakerHook, '__init__')
-    def test_hook_init(self, hook_init, mock_transform, mock_model, mock_client):
-        mock_transform.return_value = {"TransformJobArn": "testarn",
-                                       "ResponseMetadata":
-                                       {"HTTPStatusCode": 200}}
-        hook_init.return_value = None
-        self.sagemaker.execute(None)
-        hook_init.assert_called_once_with(
-            sagemaker_conn_id='sagemaker_test_id',
-            region_name='us-west-2',
-            use_db_config=True,
-            check_interval=5,
-            max_ingestion_time=None
-        )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_model')
-    @mock.patch.object(SageMakerHook, 'create_transform_job')
-    def test_execute_without_failure(self, mock_transform, mock_model, mock_client):
-        mock_transform.return_value = {"TransformJobArn": "testarn",
-                                       "ResponseMetadata":
-                                       {"HTTPStatusCode": 200}}
-        self.sagemaker.execute(None)
-        mock_model.assert_called_once_with(create_model_params)
-        mock_transform.assert_called_once_with(create_transform_params,
-                                               wait_for_completion=False
-                                               )
-
-    @mock.patch.object(SageMakerHook, 'get_conn')
-    @mock.patch.object(SageMakerHook, 'create_model')
-    @mock.patch.object(SageMakerHook, 'create_transform_job')
-    def test_execute_with_failure(self, mock_transform, mock_model, mock_client):
-        mock_transform.return_value = {"TransformJobArn": "testarn",
-                                       "ResponseMetadata":
-                                       {"HTTPStatusCode": 404}}
-        self.assertRaises(AirflowException, self.sagemaker.execute, None)
-
-
-if __name__ == '__main__':
-    unittest.main()

From 805a35b150b8f0b2fdc194e37c415d947cf44815 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 2 Nov 2018 13:33:09 +0000
Subject: [PATCH 142/808] [AIRFLOW-3262] Add param to log response when using
 SimpleHttpOperator (#4102)

* [AIRFLOW-3262] Add param to log response when using SimpleHttpOperator
---
 airflow/operators/http_operator.py    | 11 ++++-
 tests/operators/test_http_operator.py | 63 +++++++++++++++++++++++++++
 2 files changed, 73 insertions(+), 1 deletion(-)
 create mode 100644 tests/operators/test_http_operator.py

diff --git a/airflow/operators/http_operator.py b/airflow/operators/http_operator.py
index 2cfc9c0057c7c..40fba453db9d1 100644
--- a/airflow/operators/http_operator.py
+++ b/airflow/operators/http_operator.py
@@ -46,6 +46,10 @@ class SimpleHttpOperator(BaseOperator):
         'requests' documentation (options to modify timeout, ssl, etc.)
     :type extra_options: A dictionary of options, where key is string and value
         depends on the option that's being modified.
+    :param xcom_push: Push the response to Xcom (default: False)
+    :type xcom_push: bool
+    :param log_response: Log the response (default: False)
+    :type log_response: bool
     """
 
     template_fields = ('endpoint', 'data',)
@@ -61,7 +65,9 @@ def __init__(self,
                  response_check=None,
                  extra_options=None,
                  xcom_push=False,
-                 http_conn_id='http_default', *args, **kwargs):
+                 http_conn_id='http_default',
+                 log_response=False,
+                 *args, **kwargs):
         """
         If xcom_push is True, response of an HTTP request will also
         be pushed to an XCom.
@@ -75,6 +81,7 @@ def __init__(self,
         self.response_check = response_check
         self.extra_options = extra_options or {}
         self.xcom_push_flag = xcom_push
+        self.log_response = log_response
 
     def execute(self, context):
         http = HttpHook(self.method, http_conn_id=self.http_conn_id)
@@ -90,3 +97,5 @@ def execute(self, context):
                 raise AirflowException("Response check returned False.")
         if self.xcom_push_flag:
             return response.text
+        if self.log_response:
+            self.log.info(response.text)
diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
new file mode 100644
index 0000000000000..6ab2c03bb5f47
--- /dev/null
+++ b/tests/operators/test_http_operator.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import os
+import unittest
+
+from mock import patch
+from airflow.operators.http_operator import SimpleHttpOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class AnyStringWith(str):
+    """
+    Helper class to check if a substring is a part of a string
+    """
+    def __eq__(self, other):
+        return self in other
+
+
+class SimpleHttpOpTests(unittest.TestCase):
+    def setUp(self):
+        # Creating a local Http connection to Airflow Webserver
+        os.environ['AIRFLOW_CONN_HTTP_GOOGLE'] = 'http://www.google.com'
+
+    def test_response_in_logs(self):
+        """
+        Test that when using SimpleHttpOperator with 'GET' on localhost:8080,
+        the log contains 'Google' in it
+        """
+        operator = SimpleHttpOperator(
+            task_id='test_HTTP_op',
+            method='GET',
+            endpoint='/',
+            http_conn_id='HTTP_GOOGLE',
+            log_response=True,
+        )
+
+        with patch.object(operator.log, 'info') as mock_info:
+            operator.execute(None)
+            mock_info.assert_called_with(AnyStringWith('Google'))

From e77cd5fb77e324eb01391a7419fd1eca658b4ce0 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Fri, 2 Nov 2018 14:38:31 +0100
Subject: [PATCH 143/808] [AIRFLOW-3276] Cloud SQL: database create / patch /
 delete operators (#4124)

---
 .../contrib/example_dags/example_gcp_sql.py   |  60 ++++-
 airflow/contrib/hooks/gcp_sql_hook.py         |  90 +++++++
 airflow/contrib/operators/gcp_sql_operator.py | 235 +++++++++++++++++-
 docs/howto/operator.rst                       | 148 ++++++++++-
 docs/integration.rst                          |  35 ++-
 .../operators/test_gcp_sql_operator.py        | 152 ++++++++++-
 6 files changed, 701 insertions(+), 19 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index a484456f6e6d9..136c88c843014 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -18,26 +18,30 @@
 # under the License.
 
 """
-Example Airflow DAG that deploys, updates, patches and deletes a Cloud SQL instance
-in Google Cloud Platform.
+Example Airflow DAG that creates, patches and deletes a Cloud SQL instance, and also
+creates, patches and deletes a database inside the instance, in Google Cloud Platform.
 
-This DAG relies on the following Airflow variables
-https://airflow.apache.org/concepts.html#variables
+This DAG relies on the following environment variables
 * PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance.
 * INSTANCE_NAME - Name of the Cloud SQL instance.
+* DB_NAME - Name of the database inside a Cloud SQL instance.
 """
 
+import os
 import datetime
 
 import airflow
 from airflow import models
 
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
-    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator
+    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
+    CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
+    CloudSqlInstanceDatabaseDeleteOperator
 
 # [START howto_operator_cloudsql_arguments]
-PROJECT_ID = models.Variable.get('PROJECT_ID', '')
-INSTANCE_NAME = models.Variable.get('INSTANCE_NAME', '')
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'testinstance')
+DB_NAME = os.environ.get('DB_NAME', 'testdb')
 # [END howto_operator_cloudsql_arguments]
 
 # Bodies below represent Cloud SQL instance resources:
@@ -97,6 +101,19 @@
     }
 }
 # [END howto_operator_cloudsql_patch_body]
+# [START howto_operator_cloudsql_db_create_body]
+db_create_body = {
+    "instance": INSTANCE_NAME,
+    "name": DB_NAME,
+    "project": PROJECT_ID
+}
+# [END howto_operator_cloudsql_db_create_body]
+# [START howto_operator_cloudsql_db_patch_body]
+db_patch_body = {
+    "charset": "utf16",
+    "collation": "utf16_general_ci"
+}
+# [END howto_operator_cloudsql_db_patch_body]
 
 default_args = {
     'start_date': airflow.utils.dates.days_ago(1)
@@ -123,6 +140,31 @@
         task_id='sql_instance_patch_task'
     )
     # [END howto_operator_cloudsql_patch]
+    # [START howto_operator_cloudsql_db_create]
+    sql_db_create_task = CloudSqlInstanceDatabaseCreateOperator(
+        project_id=PROJECT_ID,
+        body=db_create_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_db_create_task'
+    )
+    # [END howto_operator_cloudsql_db_create]
+    # [START howto_operator_cloudsql_db_patch]
+    sql_db_patch_task = CloudSqlInstanceDatabasePatchOperator(
+        project_id=PROJECT_ID,
+        body=db_patch_body,
+        instance=INSTANCE_NAME,
+        database=DB_NAME,
+        task_id='sql_db_patch_task'
+    )
+    # [END howto_operator_cloudsql_db_patch]
+    # [START howto_operator_cloudsql_db_delete]
+    sql_db_delete_task = CloudSqlInstanceDatabaseDeleteOperator(
+        project_id=PROJECT_ID,
+        instance=INSTANCE_NAME,
+        database=DB_NAME,
+        task_id='sql_db_delete_task'
+    )
+    # [END howto_operator_cloudsql_db_delete]
     # [START howto_operator_cloudsql_delete]
     sql_instance_delete_task = CloudSqlInstanceDeleteOperator(
         project_id=PROJECT_ID,
@@ -131,4 +173,6 @@
     )
     # [END howto_operator_cloudsql_delete]
 
-    sql_instance_create_task >> sql_instance_patch_task >> sql_instance_delete_task
+    sql_instance_create_task >> sql_instance_patch_task \
+        >> sql_db_create_task >> sql_db_patch_task \
+        >> sql_db_delete_task >> sql_instance_delete_task
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index e0b3f92d8f20e..549ceaf49cec3 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -144,6 +144,96 @@ def delete_instance(self, project_id, instance):
         operation_name = response["name"]
         return self._wait_for_operation_to_complete(project_id, operation_name)
 
+    def get_database(self, project_id, instance, database):
+        """
+        Retrieves a database resource from a Cloud SQL instance.
+
+        :param project_id: Project ID of the project that contains the instance.
+        :type project_id: str
+        :param instance: Database instance ID. This does not include the project ID.
+        :type instance: str
+        :param database: Name of the database in the instance.
+        :type database: str
+        :return: A Cloud SQL database resource, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases#resource
+        :rtype: dict
+        """
+        return self.get_conn().databases().get(
+            project=project_id,
+            instance=instance,
+            database=database
+        ).execute(num_retries=NUM_RETRIES)
+
+    def create_database(self, project, instance, body):
+        """
+        Creates a new database inside a Cloud SQL instance.
+
+        :param project: Project ID of the project that contains the instance.
+        :type project: str
+        :param instance: Database instance ID. This does not include the project ID.
+        :type instance: str
+        :param body: The request body, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().databases().insert(
+            project=project,
+            instance=instance,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project, operation_name)
+
+    def patch_database(self, project, instance, database, body):
+        """
+        Updates a database resource inside a Cloud SQL instance.
+        This method supports patch semantics.
+        See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+
+        :param project: Project ID of the project that contains the instance.
+        :type project: str
+        :param instance: Database instance ID. This does not include the project ID.
+        :type instance: str
+        :param database: Name of the database to be updated in the instance.
+        :type database: str
+        :param body: The request body, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().databases().patch(
+            project=project,
+            instance=instance,
+            database=database,
+            body=body
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project, operation_name)
+
+    def delete_database(self, project, instance, database):
+        """
+        Deletes a database from a Cloud SQL instance.
+
+        :param project: Project ID of the project that contains the instance.
+        :type project: str
+        :param instance: Database instance ID. This does not include the project ID.
+        :type instance: str
+        :param database: Name of the database to be deleted in the instance.
+        :type database: str
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        response = self.get_conn().databases().delete(
+            project=project,
+            instance=instance,
+            database=database
+        ).execute(num_retries=NUM_RETRIES)
+        operation_name = response["name"]
+        return self._wait_for_operation_to_complete(project, operation_name)
+
     def _wait_for_operation_to_complete(self, project_id, operation_name):
         """
         Waits for the named operation to complete - checks status of the
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index 0ba7a300c9e41..aca2e8ad40a34 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -91,6 +91,45 @@
         ], optional=True),
     ], optional=True)
 ]
+CLOUD_SQL_EXPORT_VALIDATION = [
+    dict(name="exportContext", type="dict", fields=[
+        dict(name="fileType", allow_empty=False),
+        dict(name="uri", allow_empty=False),
+        dict(name="databases", type="list"),
+        dict(name="sqlExportOptions", type="dict", optional=True, fields=[
+            dict(name="tables", type="list"),
+            dict(name="schemaOnly")
+        ]),
+        dict(name="csvExportOptions", type="dict", optional=True, fields=[
+            dict(name="selectQuery")
+        ])
+    ])
+]
+CLOUD_SQL_IMPORT_VALIDATION = [
+    dict(name="importContext", type="dict", fields=[
+        dict(name="fileType", allow_empty=False),
+        dict(name="uri", allow_empty=False),
+        dict(name="database", optional=True, allow_empty=False),
+        dict(name="importUser", optional=True),
+        dict(name="csvImportOptions", type="dict", optional=True, fields=[
+            dict(name="table"),
+            dict(name="columns", type="list", optional=True)
+        ])
+    ])
+]
+CLOUD_SQL_DATABASE_INSERT_VALIDATION = [
+    dict(name="instance", allow_empty=False),
+    dict(name="name", allow_empty=False),
+    dict(name="project", allow_empty=False),
+]
+CLOUD_SQL_DATABASE_PATCH_VALIDATION = [
+    dict(name="instance", optional=True),
+    dict(name="name", optional=True),
+    dict(name="project", optional=True),
+    dict(name="etag", optional=True),
+    dict(name="charset", optional=True),
+    dict(name="collation", optional=True),
+]
 
 
 class CloudSqlBaseOperator(BaseOperator):
@@ -137,6 +176,15 @@ def _check_if_instance_exists(self, instance):
                 return False
             raise e
 
+    def _check_if_db_exists(self, db_name):
+        try:
+            return self._hook.get_database(self.project_id, self.instance, db_name)
+        except HttpError as e:
+            status = e.resp.status
+            if status == 404:
+                return False
+            raise e
+
     def execute(self, context):
         pass
 
@@ -162,7 +210,7 @@ class CloudSqlInstanceCreateOperator(CloudSqlBaseOperator):
     :type instance: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (e.g. v1beta4).
     :type api_version: str
     :param validate_body: True if body should be validated, False otherwise.
     :type validate_body: bool
@@ -226,7 +274,7 @@ class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
     :type instance: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (e.g. v1beta4).
     :type api_version: str
     """
     # [START gcp_sql_patch_template_fields]
@@ -270,7 +318,7 @@ class CloudSqlInstanceDeleteOperator(CloudSqlBaseOperator):
     :type instance: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (e.g. v1beta4).
     :type api_version: str
     """
     # [START gcp_sql_delete_template_fields]
@@ -295,3 +343,184 @@ def execute(self, context):
             return True
         else:
             return self._hook.delete_instance(self.project_id, self.instance)
+
+
+class CloudSqlInstanceDatabaseCreateOperator(CloudSqlBaseOperator):
+    """
+    Creates a new database inside a Cloud SQL instance.
+
+    :param project_id: Project ID of the project that contains the instance.
+    :type project_id: str
+    :param instance: Database instance ID. This does not include the project ID.
+    :type instance: str
+    :param body: The request body, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
+    :type body: dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1beta4).
+    :type api_version: str
+    :param validate_body: Whether the body should be validated. Defaults to True.
+    :type validate_body: bool
+    """
+    # [START gcp_sql_db_create_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_db_create_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body = body
+        self.validate_body = validate_body
+        super(CloudSqlInstanceDatabaseCreateOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceDatabaseCreateOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+
+    def _validate_body_fields(self):
+        if self.validate_body:
+            GcpBodyFieldValidator(CLOUD_SQL_DATABASE_INSERT_VALIDATION,
+                                  api_version=self.api_version).validate(self.body)
+
+    def execute(self, context):
+        self._validate_body_fields()
+        database = self.body.get("name")
+        if not database:
+            self.log.error("Body doesn't contain 'name'. Cannot check if the"
+                           " database already exists in the instance {}."
+                           .format(self.instance))
+            return False
+        if self._check_if_db_exists(database):
+            self.log.info("Cloud SQL instance with ID {} already contains database"
+                          " '{}'. Aborting database insert."
+                          .format(self.instance, database))
+            return True
+        else:
+            return self._hook.create_database(self.project_id, self.instance, self.body)
+
+
+class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
+    """
+    Updates a resource containing information about a database inside a Cloud SQL
+    instance using patch semantics.
+    See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+
+    :param project_id: Project ID of the project that contains the instance.
+    :type project_id: str
+    :param instance: Database instance ID. This does not include the project ID.
+    :type instance: str
+    :param database: Name of the database to be updated in the instance.
+    :type database: str
+    :param body: The request body, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch#request-body
+    :type body: dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1beta4).
+    :type api_version: str
+    :param validate_body: Whether the body should be validated. Defaults to True.
+    :type validate_body: bool
+    """
+    # [START gcp_sql_db_patch_template_fields]
+    template_fields = ('project_id', 'instance', 'database', 'gcp_conn_id',
+                       'api_version')
+    # [END gcp_sql_db_patch_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 database,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.database = database
+        self.body = body
+        self.validate_body = validate_body
+        super(CloudSqlInstanceDatabasePatchOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceDatabasePatchOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+        if not self.database:
+            raise AirflowException("The required parameter 'database' is empty")
+
+    def _validate_body_fields(self):
+        if self.validate_body:
+            GcpBodyFieldValidator(CLOUD_SQL_DATABASE_PATCH_VALIDATION,
+                                  api_version=self.api_version).validate(self.body)
+
+    def execute(self, context):
+        self._validate_body_fields()
+        if not self._check_if_db_exists(self.database):
+            raise AirflowException("Cloud SQL instance with ID {} does not contain "
+                                   "database '{}'. "
+                                   "Please specify another database to patch."
+                                   .format(self.instance, self.database))
+        else:
+            return self._hook.patch_database(self.project_id, self.instance,
+                                             self.database, self.body)
+
+
+class CloudSqlInstanceDatabaseDeleteOperator(CloudSqlBaseOperator):
+    """
+    Deletes a database from a Cloud SQL instance.
+
+    :param project_id: Project ID of the project that contains the instance.
+    :type project_id: str
+    :param instance: Database instance ID. This does not include the project ID.
+    :type instance: str
+    :param database: Name of the database to be deleted in the instance.
+    :type database: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1beta4).
+    :type api_version: str
+    """
+    # [START gcp_sql_db_delete_template_fields]
+    template_fields = ('project_id', 'instance', 'database', 'gcp_conn_id',
+                       'api_version')
+    # [END gcp_sql_db_delete_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 database,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 *args, **kwargs):
+        self.database = database
+        super(CloudSqlInstanceDatabaseDeleteOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceDatabaseDeleteOperator, self)._validate_inputs()
+        if not self.database:
+            raise AirflowException("The required parameter 'database' is empty")
+
+    def execute(self, context):
+        if not self._check_if_db_exists(self.database):
+            print("Cloud SQL instance with ID {} does not contain database '{}'. "
+                  "Aborting database delete."
+                  .format(self.instance, self.database))
+            return True
+        else:
+            return self._hook.delete_database(self.project_id, self.instance,
+                                              self.database)
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 025274a5a41ae..6333e32dd7d67 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -284,6 +284,148 @@ If the source code for your function is in Google Source Repository, make sure t
 your service account has the Source Repository Viewer role so that the source code
 can be downloaded if necessary.
 
+CloudSqlInstanceDatabaseCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new database inside a Cloud SQL instance.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_create]
+    :end-before: [END howto_operator_cloudsql_db_create]
+
+Example request body:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_db_create_body]
+    :end-before: [END howto_operator_cloudsql_db_create_body]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_db_create_template_fields]
+  :end-before: [END gcp_sql_db_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database insert
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert>`_.
+
+CloudSqlInstanceDatabaseDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Deletes a database from a Cloud SQL instance.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_delete]
+    :end-before: [END howto_operator_cloudsql_db_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_db_delete_template_fields]
+  :end-before: [END gcp_sql_db_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database delete
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/delete>`_.
+
+CloudSqlInstanceDatabasePatchOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Updates a resource containing information about a database inside a Cloud SQL instance
+using patch semantics.
+See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_patch]
+    :end-before: [END howto_operator_cloudsql_db_patch]
+
+Example request body:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_db_patch_body]
+    :end-before: [END howto_operator_cloudsql_db_patch_body]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_sql_db_patch_template_fields]
+  :end-before: [END gcp_sql_db_patch_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database patch
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch>`_.
+
 CloudSqlInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -295,7 +437,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from Airflow variables:
+Some arguments in the example DAG are taken from environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
@@ -342,7 +484,7 @@ will succeed.
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from Airflow variables:
+Some arguments in the example DAG are taken from environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
@@ -398,7 +540,7 @@ unchanged.
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from Airflow variables:
+Some arguments in the example DAG are taken from environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
diff --git a/docs/integration.rst b/docs/integration.rst
index e72f687151de5..49c383541f191 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -445,10 +445,37 @@ Cloud SQL
 Cloud SQL Operators
 """""""""""""""""""
 
+- :ref:`CloudSqlInstanceDatabaseDeleteOperator` : deletes a database from a Cloud SQL
+instance.
+- :ref:`CloudSqlInstanceDatabaseCreateOperator` : creates a new database inside a Cloud
+SQL instance.
+- :ref:`CloudSqlInstanceDatabasePatchOperator` : updates a database inside a Cloud
+SQL instance.
 - :ref:`CloudSqlInstanceDeleteOperator` : delete a Cloud SQL instance.
 - :ref:`CloudSqlInstanceCreateOperator` : create a new Cloud SQL instance.
 - :ref:`CloudSqlInstancePatchOperator` : patch a Cloud SQL instance.
 
+.. CloudSqlInstanceDatabaseDeleteOperator:
+
+CloudSqlInstanceDatabaseDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
+
+.. CloudSqlInstanceDatabaseCreateOperator:
+
+CloudSqlInstanceDatabaseCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
+
+.. CloudSqlInstanceDatabasePatchOperator:
+
+CloudSqlInstanceDatabasePatchOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
+
 .. CloudSqlInstanceDeleteOperator:
 
 CloudSqlInstanceDeleteOperator
@@ -466,12 +493,12 @@ CloudSqlInstanceCreateOperator
 .. CloudSqlInstancePatchOperator:
 
 CloudSqlInstancePatchOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
 
 Cloud SQL Hook
-""""""""""""""""""""
+""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
     :members:
@@ -496,14 +523,14 @@ GceInstanceStartOperator
 .. _GceInstanceStopOperator:
 
 GceInstanceStopOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
 
 .. _GceSetMachineTypeOperator:
 
 GceSetMachineTypeOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 245631808a223..31ed3d37c3c52 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -21,7 +21,9 @@
 
 from airflow import AirflowException
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
-    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator
+    CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
+    CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
+    CloudSqlInstanceDatabaseDeleteOperator
 
 try:
     # noinspection PyProtectedMember
@@ -34,6 +36,7 @@
 
 PROJECT_ID = "project-id"
 INSTANCE_NAME = "test-name"
+DB_NAME = "db1"
 CREATE_BODY = {
     "name": INSTANCE_NAME,
     "settings": {
@@ -109,6 +112,21 @@
     },
     "region": "europe-west4"
 }
+DATABASE_INSERT_BODY = {
+    "name": DB_NAME,            # The name of the database in the Cloud SQL instance.
+                                # This does not include the project ID or instance name.
+
+    "project": PROJECT_ID,      # The project ID of the project containing the Cloud SQL
+                                # database. The Google apps domain is prefixed if
+                                # applicable.
+
+    "instance": INSTANCE_NAME,  # The name of the Cloud SQL instance.
+                                # This does not include the project ID.
+}
+DATABASE_PATCH_BODY = {
+    "charset": "utf16",
+    "collation": "utf16_general_ci"
+}
 
 
 class CloudSqlTest(unittest.TestCase):
@@ -312,3 +330,135 @@ def test_instance_delete_should_abort_and_succeed_if_not_exists(
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_instance.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseCreateOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_create(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = False
+        op = CloudSqlInstanceDatabaseCreateOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=DATABASE_INSERT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME, DATABASE_INSERT_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseCreateOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_create_should_abort_and_succeed_if_exists(
+            self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = True
+        op = CloudSqlInstanceDatabaseCreateOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=DATABASE_INSERT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabasePatchOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_patch(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = True
+        op = CloudSqlInstanceDatabasePatchOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            body=DATABASE_PATCH_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_database.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME, DB_NAME, DATABASE_PATCH_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabasePatchOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_patch_should_throw_ex_if_not_exists(
+            self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = False
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceDatabasePatchOperator(
+                project_id=PROJECT_ID,
+                instance=INSTANCE_NAME,
+                database=DB_NAME,
+                body=DATABASE_PATCH_BODY,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("Cloud SQL instance with ID", str(err))
+        self.assertIn("does not contain database", str(err))
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_database.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_patch_should_throw_ex_when_empty_database(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSqlInstanceDatabasePatchOperator(
+                project_id=PROJECT_ID,
+                instance=INSTANCE_NAME,
+                database="",
+                body=DATABASE_INSERT_BODY,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'database' is empty", str(err))
+        mock_hook.assert_not_called()
+        mock_hook.return_value.patch_database.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseDeleteOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_delete(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = True
+        op = CloudSqlInstanceDatabaseDeleteOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME, DB_NAME
+        )
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseDeleteOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_delete_should_abort_and_succeed_if_not_exists(
+            self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = False
+        op = CloudSqlInstanceDatabaseDeleteOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_not_called()

From cb65b1998b9290d71a20a35151c416847cc9a699 Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Mon, 5 Nov 2018 12:16:20 +0100
Subject: [PATCH 144/808] [AIRFLOW-3277] Correctly observe DST transitions for
 cron (#4117)

`following_schedule` converts to naive time by using the
local time zone. In case of a DST transition, say 3AM -> 2AM
("summer time to winter time") we incorrectly re-applied
the timezone information which meant that a "CEST -> CEST"
could happen instead of a "CEST -> CET". This resulted
in infinite loops.
---
 airflow/models.py | 64 +++++++++++++++++++++++++++------
 tests/models.py   | 90 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 144 insertions(+), 10 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 9ec7a472aa840..93114cce2f438 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -41,6 +41,7 @@
 import logging
 import numbers
 import os
+import pendulum
 import pickle
 import re
 import signal
@@ -3340,34 +3341,77 @@ def date_range(self, start_date, num=None, end_date=timezone.utcnow()):
             start_date=start_date, end_date=end_date,
             num=num, delta=self._schedule_interval)
 
+    def is_fixed_time_schedule(self):
+        """
+        Figures out if the DAG schedule has a fixed time (e.g. 3 AM).
+
+        :return: True if the schedule has a fixed time, False if not.
+        """
+        now = datetime.now()
+        cron = croniter(self._schedule_interval, now)
+
+        start = cron.get_next(datetime)
+        cron_next = cron.get_next(datetime)
+
+        if cron_next.minute == start.minute and cron_next.hour == start.hour:
+            return True
+
+        return False
+
     def following_schedule(self, dttm):
         """
-        Calculates the following schedule for this dag in local time
+        Calculates the following schedule for this dag in UTC.
 
         :param dttm: utc datetime
         :return: utc datetime
         """
         if isinstance(self._schedule_interval, six.string_types):
-            dttm = timezone.make_naive(dttm, self.timezone)
-            cron = croniter(self._schedule_interval, dttm)
-            following = timezone.make_aware(cron.get_next(datetime), self.timezone)
+            # we don't want to rely on the transitions created by
+            # croniter as they are not always correct
+            dttm = pendulum.instance(dttm)
+            naive = timezone.make_naive(dttm, self.timezone)
+            cron = croniter(self._schedule_interval, naive)
+
+            # We assume that DST transitions happen on the minute/hour
+            if not self.is_fixed_time_schedule():
+                # relative offset (eg. every 5 minutes)
+                delta = cron.get_next(datetime) - naive
+                following = dttm.in_timezone(self.timezone).add_timedelta(delta)
+            else:
+                # absolute (e.g. 3 AM)
+                naive = cron.get_next(datetime)
+                tz = pendulum.timezone(self.timezone.name)
+                following = timezone.make_aware(naive, tz)
             return timezone.convert_to_utc(following)
         elif isinstance(self._schedule_interval, timedelta):
             return dttm + self._schedule_interval
 
     def previous_schedule(self, dttm):
         """
-        Calculates the previous schedule for this dag in local time
+        Calculates the previous schedule for this dag in UTC
 
         :param dttm: utc datetime
         :return: utc datetime
         """
         if isinstance(self._schedule_interval, six.string_types):
-            dttm = timezone.make_naive(dttm, self.timezone)
-            cron = croniter(self._schedule_interval, dttm)
-            prev = timezone.make_aware(cron.get_prev(datetime), self.timezone)
-            return timezone.convert_to_utc(prev)
-        elif isinstance(self._schedule_interval, timedelta):
+            # we don't want to rely on the transitions created by
+            # croniter as they are not always correct
+            dttm = pendulum.instance(dttm)
+            naive = timezone.make_naive(dttm, self.timezone)
+            cron = croniter(self._schedule_interval, naive)
+
+            # We assume that DST transitions happen on the minute/hour
+            if not self.is_fixed_time_schedule():
+                # relative offset (eg. every 5 minutes)
+                delta = naive - cron.get_prev(datetime)
+                previous = dttm.in_timezone(self.timezone).subtract_timedelta(delta)
+            else:
+                # absolute (e.g. 3 AM)
+                naive = cron.get_prev(datetime)
+                tz = pendulum.timezone(self.timezone.name)
+                previous = timezone.make_aware(naive, tz)
+            return timezone.convert_to_utc(previous)
+        elif self._schedule_interval is not None:
             return dttm - self._schedule_interval
 
     def get_run_dates(self, start_date, end_date=None):
diff --git a/tests/models.py b/tests/models.py
index 1e6787927b339..16a8d6a3e1b76 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -544,6 +544,96 @@ def test_cycle(self):
         with self.assertRaises(AirflowDagCycleException):
             dag.test_cycle()
 
+    def test_following_previous_schedule(self):
+        """
+        Make sure DST transitions are properly observed
+        """
+        local_tz = pendulum.timezone('Europe/Zurich')
+        start = local_tz.convert(datetime.datetime(2018, 10, 28, 2, 55),
+                                 dst_rule=pendulum.PRE_TRANSITION)
+        self.assertEqual(start.isoformat(), "2018-10-28T02:55:00+02:00",
+                         "Pre-condition: start date is in DST")
+
+        utc = timezone.convert_to_utc(start)
+
+        dag = DAG('tz_dag', start_date=start, schedule_interval='*/5 * * * *')
+        _next = dag.following_schedule(utc)
+        next_local = local_tz.convert(_next)
+
+        self.assertEqual(_next.isoformat(), "2018-10-28T01:00:00+00:00")
+        self.assertEqual(next_local.isoformat(), "2018-10-28T02:00:00+01:00")
+
+        prev = dag.previous_schedule(utc)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-10-28T02:50:00+02:00")
+
+        prev = dag.previous_schedule(_next)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-10-28T02:55:00+02:00")
+        self.assertEqual(prev, utc)
+
+    def test_following_previous_schedule_daily_dag_CEST_to_CET(self):
+        """
+        Make sure DST transitions are properly observed
+        """
+        local_tz = pendulum.timezone('Europe/Zurich')
+        start = local_tz.convert(datetime.datetime(2018, 10, 27, 3),
+                                 dst_rule=pendulum.PRE_TRANSITION)
+
+        utc = timezone.convert_to_utc(start)
+
+        dag = DAG('tz_dag', start_date=start, schedule_interval='0 3 * * *')
+
+        prev = dag.previous_schedule(utc)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-10-26T03:00:00+02:00")
+        self.assertEqual(prev.isoformat(), "2018-10-26T01:00:00+00:00")
+
+        _next = dag.following_schedule(utc)
+        next_local = local_tz.convert(_next)
+
+        self.assertEqual(next_local.isoformat(), "2018-10-28T03:00:00+01:00")
+        self.assertEqual(_next.isoformat(), "2018-10-28T02:00:00+00:00")
+
+        prev = dag.previous_schedule(_next)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-10-27T03:00:00+02:00")
+        self.assertEqual(prev.isoformat(), "2018-10-27T01:00:00+00:00")
+
+    def test_following_previous_schedule_daily_dag_CET_to_CEST(self):
+        """
+        Make sure DST transitions are properly observed
+        """
+        local_tz = pendulum.timezone('Europe/Zurich')
+        start = local_tz.convert(datetime.datetime(2018, 3, 25, 2),
+                                 dst_rule=pendulum.PRE_TRANSITION)
+
+        utc = timezone.convert_to_utc(start)
+
+        dag = DAG('tz_dag', start_date=start, schedule_interval='0 3 * * *')
+
+        prev = dag.previous_schedule(utc)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-03-24T03:00:00+01:00")
+        self.assertEqual(prev.isoformat(), "2018-03-24T02:00:00+00:00")
+
+        _next = dag.following_schedule(utc)
+        next_local = local_tz.convert(_next)
+
+        self.assertEqual(next_local.isoformat(), "2018-03-25T03:00:00+02:00")
+        self.assertEqual(_next.isoformat(), "2018-03-25T01:00:00+00:00")
+
+        prev = dag.previous_schedule(_next)
+        prev_local = local_tz.convert(prev)
+
+        self.assertEqual(prev_local.isoformat(), "2018-03-24T03:00:00+01:00")
+        self.assertEqual(prev.isoformat(), "2018-03-24T02:00:00+00:00")
+
 
 class DagStatTest(unittest.TestCase):
     def test_dagstats_crud(self):

From 8910def43be0ab3d5fa001aa91b9c39140f7153d Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 28 Sep 2018 13:09:01 -0400
Subject: [PATCH 145/808] [AIRFLOW-3129] Backfill mysql hook unit tests.
 (#3970)

---
 tests/hooks/test_mysql_hook.py | 86 ++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/tests/hooks/test_mysql_hook.py b/tests/hooks/test_mysql_hook.py
index d112f880e9e3a..415d430fc4b77 100644
--- a/tests/hooks/test_mysql_hook.py
+++ b/tests/hooks/test_mysql_hook.py
@@ -18,12 +18,81 @@
 # under the License.
 #
 
+import json
 import mock
 import unittest
 
+import MySQLdb.cursors
+
+from airflow import models
 from airflow.hooks.mysql_hook import MySqlHook
 
 
+class TestMySqlHookConn(unittest.TestCase):
+
+    def setUp(self):
+        super(TestMySqlHookConn, self).setUp()
+
+        self.connection = models.Connection(
+            login='login',
+            password='password',
+            host='host',
+            schema='schema',
+        )
+
+        self.db_hook = MySqlHook()
+        self.db_hook.get_connection = mock.Mock()
+        self.db_hook.get_connection.return_value = self.connection
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn(self, mock_connect):
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['user'], 'login')
+        self.assertEqual(kwargs['passwd'], 'password')
+        self.assertEqual(kwargs['host'], 'host')
+        self.assertEqual(kwargs['db'], 'schema')
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_port(self, mock_connect):
+        self.connection.port = 3307
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['port'], 3307)
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_charset(self, mock_connect):
+        self.connection.extra = json.dumps({'charset': 'utf-8'})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['charset'], 'utf-8')
+        self.assertEqual(kwargs['use_unicode'], True)
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_cursor(self, mock_connect):
+        self.connection.extra = json.dumps({'cursor': 'sscursor'})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['cursorclass'], MySQLdb.cursors.SSCursor)
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_local_infile(self, mock_connect):
+        self.connection.extra = json.dumps({'local_infile': True})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['local_infile'], 1)
+
+
 class TestMySqlHook(unittest.TestCase):
 
     def setUp(self):
@@ -85,3 +154,20 @@ def test_run_multi_queries(self):
             self.assertEqual(kwargs, {})
         self.cur.execute.assert_called_with(sql[1])
         self.conn.commit.assert_not_called()
+
+    def test_bulk_load(self):
+        self.db_hook.bulk_load('table', '/tmp/file')
+        self.cur.execute.assert_called_once_with("""
+            LOAD DATA LOCAL INFILE '/tmp/file'
+            INTO TABLE table
+            """)
+
+    def test_bulk_dump(self):
+        self.db_hook.bulk_dump('table', '/tmp/file')
+        self.cur.execute.assert_called_once_with("""
+            SELECT * INTO OUTFILE '/tmp/file'
+            FROM table
+            """)
+
+    def test_serialize_cell(self):
+        self.assertEqual('foo', self.db_hook._serialize_cell('foo', None))

From 6cedc453e0ccb41d4c8737c88132da9a7f07cf11 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sun, 28 Oct 2018 19:27:21 +0100
Subject: [PATCH 146/808] [AIRFLOW-3265] Support for "unix_socket" extra for
 MySQL hook (#4110)

MySQL hook does not support "unix_socket" extra - which allows
to specify a different location of Linux socket than the default one.
This is a blocker for tools like cloud-sql-proxy that
creates sockets in an arbitrary place:
https://mysqlclient.readthedocs.io/user_guide.html
---
 airflow/hooks/mysql_hook.py    | 2 ++
 tests/hooks/test_mysql_hook.py | 9 +++++++++
 2 files changed, 11 insertions(+)

diff --git a/airflow/hooks/mysql_hook.py b/airflow/hooks/mysql_hook.py
index c02c0f43b5e37..9fe162626bafc 100644
--- a/airflow/hooks/mysql_hook.py
+++ b/airflow/hooks/mysql_hook.py
@@ -88,6 +88,8 @@ def get_conn(self):
         local_infile = conn.extra_dejson.get('local_infile', False)
         if conn.extra_dejson.get('ssl', False):
             conn_config['ssl'] = conn.extra_dejson['ssl']
+        if conn.extra_dejson.get('unix_socket'):
+            conn_config['unix_socket'] = conn.extra_dejson['unix_socket']
         if local_infile:
             conn_config["local_infile"] = 1
         conn = MySQLdb.connect(**conn_config)
diff --git a/tests/hooks/test_mysql_hook.py b/tests/hooks/test_mysql_hook.py
index 415d430fc4b77..e6c64f7c5ca4f 100644
--- a/tests/hooks/test_mysql_hook.py
+++ b/tests/hooks/test_mysql_hook.py
@@ -92,6 +92,15 @@ def test_get_conn_local_infile(self, mock_connect):
         self.assertEqual(args, ())
         self.assertEqual(kwargs['local_infile'], 1)
 
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_con_unix_socket(self, mock_connect):
+        self.connection.extra = json.dumps({'unix_socket': "/tmp/socket"})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['unix_socket'], '/tmp/socket')
+
 
 class TestMySqlHook(unittest.TestCase):
 

From 317cbdf72c0f7d3201366e36d4dc98760e69aa6c Mon Sep 17 00:00:00 2001
From: ron819 <40163787+ron819@users.noreply.github.com>
Date: Mon, 8 Oct 2018 18:59:59 +0300
Subject: [PATCH 147/808] [AIRFLOW-XXX] Update manage-connections.rst (#4020)

Explain how to connect with MySQL
---
 docs/howto/manage-connections.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index f869a08b3c061..a79fe0bc30b1e 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -133,3 +133,26 @@ Scopes (comma separated)
         Scopes are ignored when using application default credentials. See
         issue `AIRFLOW-2522
         <https://issues.apache.org/jira/browse/AIRFLOW-2522>`_.
+MySQL
+~~~~~~~~~~~~~~~~~~~~~
+The MySQL connect type allows to connect with MySQL database.
+
+Configuring the Connection
+''''''''''''''''''''''''''
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+    
+Password (required)
+    Specify the password to connect.    
+    
+Extra (optional)
+    Specify the charset. Example: {"charset": "utf8"}
+    
+    .. note::
+        If encounter UnicodeDecodeError while working with MySQL connection check the charset defined is matched to the database charset.

From f53fd2dcc0a9b1e28d92a73a4a1de3e9d02691a6 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Mon, 5 Nov 2018 17:22:17 +0100
Subject: [PATCH 148/808] [AIRFLOW-3268] Better handling of extras field in
 MySQL connection (#4113)

---
 airflow/hooks/mysql_hook.py       | 10 ++++-
 docs/howto/manage-connections.rst | 63 +++++++++++++++++++++++++++++--
 tests/hooks/test_mysql_hook.py    | 24 ++++++++++++
 3 files changed, 92 insertions(+), 5 deletions(-)

diff --git a/airflow/hooks/mysql_hook.py b/airflow/hooks/mysql_hook.py
index 9fe162626bafc..57f577c261353 100644
--- a/airflow/hooks/mysql_hook.py
+++ b/airflow/hooks/mysql_hook.py
@@ -19,6 +19,8 @@
 
 import MySQLdb
 import MySQLdb.cursors
+import json
+import six
 
 from airflow.hooks.dbapi_hook import DbApiHook
 
@@ -87,7 +89,13 @@ def get_conn(self):
                 conn_config["cursorclass"] = MySQLdb.cursors.SSDictCursor
         local_infile = conn.extra_dejson.get('local_infile', False)
         if conn.extra_dejson.get('ssl', False):
-            conn_config['ssl'] = conn.extra_dejson['ssl']
+            # SSL parameter for MySQL has to be a dictionary and in case
+            # of extra/dejson we can get string if extra is passed via
+            # URL parameters
+            dejson_ssl = conn.extra_dejson['ssl']
+            if isinstance(dejson_ssl, six.string_types):
+                dejson_ssl = json.loads(dejson_ssl)
+            conn_config['ssl'] = dejson_ssl
         if conn.extra_dejson.get('unix_socket'):
             conn_config['unix_socket'] = conn.extra_dejson['unix_socket']
         if local_infile:
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index a79fe0bc30b1e..4d0adfb1009dc 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -133,8 +133,9 @@ Scopes (comma separated)
         Scopes are ignored when using application default credentials. See
         issue `AIRFLOW-2522
         <https://issues.apache.org/jira/browse/AIRFLOW-2522>`_.
+
 MySQL
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~
 The MySQL connect type allows to connect with MySQL database.
 
 Configuring the Connection
@@ -152,7 +153,61 @@ Password (required)
     Specify the password to connect.    
     
 Extra (optional)
-    Specify the charset. Example: {"charset": "utf8"}
-    
+    Specify the extra parameters (as json dictionary) that can be used in mysql
+    connection. The following parameters are supported:
+
+    * **charset**: specify charset of the connection
+    * **cursor**: one of "sscursor", "dictcursor, "ssdictcursor" - specifies cursor class to be
+      used
+    * **local_infile**: controls MySQL's LOCAL capability (permitting local data loading by
+      clients). See `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_
+      for details.
+    * **unix_socket**: UNIX socket used instead of the default socket
+    * **ssl**: Dictionary of SSL parameters that control connecting using SSL (those
+      parameters are server specific and should contain "ca", "cert", "key", "capath",
+      "cipher" parameters. See
+      `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_ for details.
+      Note that in order to be useful in URL notation, this parameter might also be
+      a string where the SSL dictionary is a string-encoded JSON dictionary.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "charset": "utf8",
+          "cursorclass": "sscursor",
+          "local_infile": true,
+          "unix_socket": "/var/socket",
+          "ssl": {
+            "cert": "/tmp/client-cert.pem",
+            "ca": "/tmp/server-ca.pem'",
+            "key": "/tmp/client-key.pem"
+          }
+       }
+
+    or
+
+    .. code-block:: json
+
+       {
+          "charset": "utf8",
+          "cursorclass": "sscursor",
+          "local_infile": true,
+          "unix_socket": "/var/socket",
+          "ssl": "{\"cert\": \"/tmp/client-cert.pem\", \"ca\": \"/tmp/server-ca.pem\", \"key\": \"/tmp/client-key.pem\"}"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras as passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+       mysql://mysql_user:XXXXXXXXXXXX@1.1.1.1:3306/mysqldb?ssl=%7B%22cert%22%3A+%22%2Ftmp%2Fclient-cert.pem%22%2C+%22ca%22%3A+%22%2Ftmp%2Fserver-ca.pem%22%2C+%22key%22%3A+%22%2Ftmp%2Fclient-key.pem%22%7D
+
     .. note::
-        If encounter UnicodeDecodeError while working with MySQL connection check the charset defined is matched to the database charset.
+        If encounter UnicodeDecodeError while working with MySQL connection check
+        the charset defined is matched to the database charset.
diff --git a/tests/hooks/test_mysql_hook.py b/tests/hooks/test_mysql_hook.py
index e6c64f7c5ca4f..22e1874ed2f36 100644
--- a/tests/hooks/test_mysql_hook.py
+++ b/tests/hooks/test_mysql_hook.py
@@ -27,6 +27,12 @@
 from airflow import models
 from airflow.hooks.mysql_hook import MySqlHook
 
+SSL_DICT = {
+    'cert': '/tmp/client-cert.pem',
+    'ca': '/tmp/server-ca.pem',
+    'key': '/tmp/client-key.pem'
+}
+
 
 class TestMySqlHookConn(unittest.TestCase):
 
@@ -101,6 +107,24 @@ def test_get_con_unix_socket(self, mock_connect):
         self.assertEqual(args, ())
         self.assertEqual(kwargs['unix_socket'], '/tmp/socket')
 
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_ssl_as_dictionary(self, mock_connect):
+        self.connection.extra = json.dumps({'ssl': SSL_DICT})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['ssl'], SSL_DICT)
+
+    @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
+    def test_get_conn_ssl_as_string(self, mock_connect):
+        self.connection.extra = json.dumps({'ssl': json.dumps(SSL_DICT)})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['ssl'], SSL_DICT)
+
 
 class TestMySqlHook(unittest.TestCase):
 

From f3d5a70abccc57fe1f77b83d53d83015574511d5 Mon Sep 17 00:00:00 2001
From: Gwildor Sok <gwildorsok@gmail.com>
Date: Mon, 29 Oct 2018 15:21:37 +0100
Subject: [PATCH 149/808] [AIRFLOW-3112] Fix SFTPHook not validating hosts by
 default (#4085)

---
 airflow/contrib/hooks/sftp_hook.py    | 16 +++++--
 airflow/utils/db.py                   |  2 +-
 tests/contrib/hooks/test_sftp_hook.py | 60 ++++++++++++++++++++++++++-
 3 files changed, 72 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/hooks/sftp_hook.py b/airflow/contrib/hooks/sftp_hook.py
index 3cb32ab8ba93b..c23bd3012ba32 100644
--- a/airflow/contrib/hooks/sftp_hook.py
+++ b/airflow/contrib/hooks/sftp_hook.py
@@ -49,6 +49,9 @@ def __init__(self, ftp_conn_id='sftp_default', *args, **kwargs):
         self.conn = None
         self.private_key_pass = None
 
+        # Fail for unverified hosts, unless this is explicitly allowed
+        self.no_host_key_check = False
+
         if self.ssh_conn_id is not None:
             conn = self.get_connection(self.ssh_conn_id)
             if conn.extra is not None:
@@ -59,9 +62,7 @@ def __init__(self, ftp_conn_id='sftp_default', *args, **kwargs):
                 # For backward compatibility
                 # TODO: remove in Airflow 2.1
                 import warnings
-                if 'ignore_hostkey_verification' in extra_options \
-                        and str(extra_options["ignore_hostkey_verification"])\
-                        .lower() == 'false':
+                if 'ignore_hostkey_verification' in extra_options:
                     warnings.warn(
                         'Extra option `ignore_hostkey_verification` is deprecated.'
                         'Please use `no_host_key_check` instead.'
@@ -69,7 +70,14 @@ def __init__(self, ftp_conn_id='sftp_default', *args, **kwargs):
                         DeprecationWarning,
                         stacklevel=2,
                     )
-                    self.no_host_key_check = False
+                    self.no_host_key_check = str(
+                        extra_options['ignore_hostkey_verification']
+                    ).lower() == 'true'
+
+                if 'no_host_key_check' in extra_options:
+                    self.no_host_key_check = str(
+                        extra_options['no_host_key_check']).lower() == 'true'
+
                 if 'private_key' in extra_options:
                     warnings.warn(
                         'Extra option `private_key` is deprecated.'
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index c09aea4eef602..ef2dcf181762d 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -186,7 +186,7 @@ def initdb(rbac=False):
             conn_id='sftp_default', conn_type='sftp',
             host='localhost', port=22, login='travis',
             extra='''
-                {"private_key": "~/.ssh/id_rsa", "ignore_hostkey_verification": true}
+                {"key_file": "~/.ssh/id_rsa", "no_host_key_check": true}
             '''))
     merge_conn(
         models.Connection(
diff --git a/tests/contrib/hooks/test_sftp_hook.py b/tests/contrib/hooks/test_sftp_hook.py
index 105b6b81d8478..7715161adb08a 100644
--- a/tests/contrib/hooks/test_sftp_hook.py
+++ b/tests/contrib/hooks/test_sftp_hook.py
@@ -19,12 +19,13 @@
 
 from __future__ import print_function
 
+import mock
 import unittest
 import shutil
 import os
 import pysftp
 
-from airflow import configuration
+from airflow import configuration, models
 from airflow.contrib.hooks.sftp_hook import SFTPHook
 
 TMP_PATH = '/tmp'
@@ -105,6 +106,63 @@ def test_get_mod_time(self):
             TMP_PATH, TMP_DIR_FOR_TESTS, TMP_FILE_FOR_TESTS))
         self.assertEqual(len(output), 14)
 
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_default(self, get_connection):
+        connection = models.Connection(login='login', host='host')
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, False)
+
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_enabled(self, get_connection):
+        connection = models.Connection(
+            login='login', host='host',
+            extra='{"no_host_key_check": true}')
+
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, True)
+
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_disabled(self, get_connection):
+        connection = models.Connection(
+            login='login', host='host',
+            extra='{"no_host_key_check": false}')
+
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, False)
+
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_disabled_for_all_but_true(self, get_connection):
+        connection = models.Connection(
+            login='login', host='host',
+            extra='{"no_host_key_check": "foo"}')
+
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, False)
+
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_ignore(self, get_connection):
+        connection = models.Connection(
+            login='login', host='host',
+            extra='{"ignore_hostkey_verification": true}')
+
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, True)
+
+    @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
+    def test_no_host_key_check_no_ignore(self, get_connection):
+        connection = models.Connection(
+            login='login', host='host',
+            extra='{"ignore_hostkey_verification": false}')
+
+        get_connection.return_value = connection
+        hook = SFTPHook()
+        self.assertEqual(hook.no_host_key_check, False)
+
     def tearDown(self):
         shutil.rmtree(os.path.join(TMP_PATH, TMP_DIR_FOR_TESTS))
         os.remove(os.path.join(TMP_PATH, TMP_FILE_FOR_TESTS))

From d5be5e8d2c8908417460114fe05c23b26d4997ec Mon Sep 17 00:00:00 2001
From: Holden Karau <holden@pigscanfly.ca>
Date: Mon, 5 Nov 2018 10:55:31 -0800
Subject: [PATCH 150/808] [AIRFLOW-2192] Allow non-latin1 usernames with MySQL
 backend by adding a SQL_ENGINE_ENCODING param and default to UTF-8 (#4087)

Compromised of:

Since we have unicode_literals importred and the engine arguments must be strings in Python2 explicitly make 'utf-8' a string.

replace bare exception with conf.AirflowConfigException for missing value.

It's just got for strings apparently.

Add utf-8 to default_airflow.cfg - question do I still need the try try/except block or can we depend on defaults (I note some have both).

Get rid of try/except block and depend on default_airflow.cfg

Use __str__ since calling str just gives us back a newstr as well.

Test that a panda user can be saved.
---
 airflow/config_templates/default_airflow.cfg |  3 +++
 airflow/settings.py                          | 12 +++++++++++-
 tests/core.py                                |  5 +++++
 3 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 33257261c3aad..3d0b2444ed505 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -87,6 +87,9 @@ executor = SequentialExecutor
 # their website
 sql_alchemy_conn = sqlite:///{AIRFLOW_HOME}/airflow.db
 
+# The encoding for the databases
+sql_engine_encoding = utf-8
+
 # If SqlAlchemy should pool database connections.
 sql_alchemy_pool_enabled = True
 
diff --git a/airflow/settings.py b/airflow/settings.py
index 9646f035a26be..26d0ba983f09b 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -153,7 +153,7 @@ def configure_orm(disable_connection_pool=False):
         engine_args['poolclass'] = NullPool
         log.debug("settings.configure_orm(): Using NullPool")
     elif 'sqlite' not in SQL_ALCHEMY_CONN:
-        # Engine args not supported by sqlite.
+        # Pool size engine args not supported by sqlite.
         # If no config value is defined for the pool size, select a reasonable value.
         # 0 means no limit, which could lead to exceeding the Database connection limit.
         try:
@@ -175,6 +175,16 @@ def configure_orm(disable_connection_pool=False):
         engine_args['pool_size'] = pool_size
         engine_args['pool_recycle'] = pool_recycle
 
+    try:
+        # Allow the user to specify an encoding for their DB otherwise default
+        # to utf-8 so jobs & users with non-latin1 characters can still use
+        # us.
+        engine_args['encoding'] = conf.get('core', 'SQL_ENGINE_ENCODING')
+    except conf.AirflowConfigException:
+        engine_args['encoding'] = 'utf-8'
+    # For Python2 we get back a newstr and need a str
+    engine_args['encoding'] = engine_args['encoding'].__str__()
+
     engine = create_engine(SQL_ALCHEMY_CONN, **engine_args)
     reconnect_timeout = conf.getint('core', 'SQL_ALCHEMY_RECONNECT_TIMEOUT')
     setup_event_handlers(engine, reconnect_timeout)
diff --git a/tests/core.py b/tests/core.py
index 0448058b3b3fb..6585d1742ca36 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1930,6 +1930,11 @@ def test_password_user_authenticate(self):
         self.password_user.password = "secure_password"
         self.assertTrue(self.password_user.authenticate("secure_password"))
 
+    def test_password_unicode_user_authenticate(self):
+        self.password_user.username = u"🐼"  # This is a panda
+        self.password_user.password = "secure_password"
+        self.assertTrue(self.password_user.authenticate("secure_password"))
+
     def test_password_authenticate_session(self):
         from airflow.contrib.auth.backends.password_auth import PasswordUser
         self.password_user.password = 'test_password'

From a632dade29b63467ed14852a3223195674933440 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 5 Nov 2018 19:36:48 +0000
Subject: [PATCH 151/808] [AIRFLOW-3262] Update SimpleHttpOpTests to check
 Example.com (#4135)

Update SimpleHttpOpTests to check Example.com instead of Google.com so that the ip doesn't get banned.
---
 tests/operators/test_http_operator.py | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
index 6ab2c03bb5f47..5e87d06f28c80 100644
--- a/tests/operators/test_http_operator.py
+++ b/tests/operators/test_http_operator.py
@@ -42,22 +42,21 @@ def __eq__(self, other):
 
 class SimpleHttpOpTests(unittest.TestCase):
     def setUp(self):
-        # Creating a local Http connection to Airflow Webserver
-        os.environ['AIRFLOW_CONN_HTTP_GOOGLE'] = 'http://www.google.com'
+        os.environ['AIRFLOW_CONN_HTTP_EXAMPLE'] = 'http://www.example.com'
 
     def test_response_in_logs(self):
         """
-        Test that when using SimpleHttpOperator with 'GET' on localhost:8080,
-        the log contains 'Google' in it
+        Test that when using SimpleHttpOperator with 'GET',
+        the log contains 'Example Domain' in it
         """
         operator = SimpleHttpOperator(
             task_id='test_HTTP_op',
             method='GET',
             endpoint='/',
-            http_conn_id='HTTP_GOOGLE',
+            http_conn_id='HTTP_EXAMPLE',
             log_response=True,
         )
 
         with patch.object(operator.log, 'info') as mock_info:
             operator.execute(None)
-            mock_info.assert_called_with(AnyStringWith('Google'))
+            mock_info.assert_called_with(AnyStringWith('Example Domain'))

From 40649867abe9775c5000d441a9a174df59102a9d Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 6 Nov 2018 14:54:26 +0000
Subject: [PATCH 152/808] [AIRFLOW-XXX] Use mocking in SimpleHttpOperator tests
 (#4144)

This changes the tests in [AIRFLOW-3262]/(#4135) to use requests_mock
rather than making actual HTTP requests as we have had this test fail on
Travis with connection refused.
---
 tests/operators/test_http_operator.py | 25 +++++++++----------------
 1 file changed, 9 insertions(+), 16 deletions(-)

diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
index 5e87d06f28c80..4252867669dd1 100644
--- a/tests/operators/test_http_operator.py
+++ b/tests/operators/test_http_operator.py
@@ -20,35 +20,28 @@
 import os
 import unittest
 
-from mock import patch
+import requests
+import requests_mock
 from airflow.operators.http_operator import SimpleHttpOperator
 
 try:
     from unittest import mock
 except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-
-class AnyStringWith(str):
-    """
-    Helper class to check if a substring is a part of a string
-    """
-    def __eq__(self, other):
-        return self in other
+    import mock
 
 
 class SimpleHttpOpTests(unittest.TestCase):
     def setUp(self):
         os.environ['AIRFLOW_CONN_HTTP_EXAMPLE'] = 'http://www.example.com'
 
-    def test_response_in_logs(self):
+    @requests_mock.mock()
+    def test_response_in_logs(self, m):
         """
         Test that when using SimpleHttpOperator with 'GET',
         the log contains 'Example Domain' in it
         """
+
+        m.get('http://www.example.com', text='Example.com fake response')
         operator = SimpleHttpOperator(
             task_id='test_HTTP_op',
             method='GET',
@@ -57,6 +50,6 @@ def test_response_in_logs(self):
             log_response=True,
         )
 
-        with patch.object(operator.log, 'info') as mock_info:
+        with mock.patch.object(operator.log, 'info') as mock_info:
             operator.execute(None)
-            mock_info.assert_called_with(AnyStringWith('Example Domain'))
+            mock_info.assert_called_with('Example.com fake response')

From ec26c13c2d0f8f5f6ec115e75d4b71f093ec7d7b Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sat, 3 Nov 2018 15:36:25 +0800
Subject: [PATCH 153/808] [AIRFLOW-3295] Fix potential security issue in
 DaskExecutor (#4128)

When user decides to use TLS/SSL encryption
for DaskExecutor communications,
`Distributed.Security` object will be created.

However, argument `require_encryption` is missed
to be set to `True` (its default value is `False`).

This may fail the TLS/SSL encryption setting-up.
---
 airflow/executors/dask_executor.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/executors/dask_executor.py b/airflow/executors/dask_executor.py
index a6ba677f8bd7c..afdf3ad2d198f 100644
--- a/airflow/executors/dask_executor.py
+++ b/airflow/executors/dask_executor.py
@@ -49,6 +49,7 @@ def start(self):
                 tls_client_key=self.tls_key,
                 tls_client_cert=self.tls_cert,
                 tls_ca_file=self.tls_ca,
+                require_encryption=True,
             )
         else:
             security = None

From 04f5745fa490c8f618373f925b9811fa83697d20 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 6 Nov 2018 15:33:32 +0000
Subject: [PATCH 154/808] [AIRFLOW-XXX] Fix flake8 errors from #4144

---
 tests/operators/test_http_operator.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
index 4252867669dd1..e6033155e9b46 100644
--- a/tests/operators/test_http_operator.py
+++ b/tests/operators/test_http_operator.py
@@ -20,7 +20,6 @@
 import os
 import unittest
 
-import requests
 import requests_mock
 from airflow.operators.http_operator import SimpleHttpOperator
 

From 0990b84653e2d85a14a25ecee25a9a1bbbb74170 Mon Sep 17 00:00:00 2001
From: Eric Chang <ericchang00@gmail.com>
Date: Thu, 4 Oct 2018 17:36:40 -0700
Subject: [PATCH 155/808] [AIRFLOW-3161] fix TaskInstance log link in RBAC UI

---
 airflow/models.py |  8 ++++----
 tests/models.py   | 14 ++++++++++++++
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 93114cce2f438..a4a6a165cf91a 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1121,10 +1121,10 @@ def log_url(self):
         BASE_URL = configuration.conf.get('webserver', 'BASE_URL')
         if settings.RBAC:
             return BASE_URL + (
-                "/log/list/"
-                "?_flt_3_dag_id={self.dag_id}"
-                "&_flt_3_task_id={self.task_id}"
-                "&_flt_3_execution_date={iso}"
+                "/log?"
+                "execution_date={iso}"
+                "&task_id={self.task_id}"
+                "&dag_id={self.dag_id}"
             ).format(**locals())
         else:
             return BASE_URL + (
diff --git a/tests/models.py b/tests/models.py
index 16a8d6a3e1b76..aee32c1646a67 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -2369,6 +2369,20 @@ def test_log_url(self):
         self.assertEqual(d['task_id'][0], 'op')
         self.assertEqual(pendulum.parse(d['execution_date'][0]), now)
 
+    @patch('airflow.settings.RBAC', True)
+    def test_log_url_rbac(self):
+        dag = DAG('dag', start_date=DEFAULT_DATE)
+        task = DummyOperator(task_id='op', dag=dag)
+        ti = TI(task=task, execution_date=datetime.datetime(2018, 1, 1))
+
+        expected_url = (
+            'http://localhost:8080/log?'
+            'execution_date=2018-01-01T00%3A00%3A00%2B00%3A00'
+            '&task_id=op'
+            '&dag_id=dag'
+        )
+        self.assertEqual(ti.log_url, expected_url)
+
     def test_mark_success_url(self):
         now = pendulum.now('Europe/Brussels')
         dag = DAG('dag', start_date=DEFAULT_DATE)

From 3e06f035955884d382cd9f36b558fc365c1cd4e4 Mon Sep 17 00:00:00 2001
From: Scott Kruger <scott@chojin.org>
Date: Tue, 16 Oct 2018 04:16:28 -0500
Subject: [PATCH 156/808] [AIRFLOW-843] Exception availabe in context for
 on_failure_callback (#2135)

Store exceptions encountered executing a task in the context dict,
making it available for on_failure_callback handlers.
---
 airflow/models.py |  3 +++
 tests/core.py     | 20 ++++++++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/airflow/models.py b/airflow/models.py
index a4a6a165cf91a..f9e3c6a7e96c2 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1759,6 +1759,9 @@ def handle_failure(self, error, test_mode=False, context=None, session=None):
         # Log failure duration
         session.add(TaskFail(task, self.execution_date, self.start_date, self.end_date))
 
+        if context is not None:
+            context['exception'] = error
+
         # Let's go deeper
         try:
             # Since this function is called only when the TI state is running,
diff --git a/tests/core.py b/tests/core.py
index 6585d1742ca36..f466c4c4f94db 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -442,6 +442,26 @@ def test_bash_operator_kill(self):
             os.kill(pid, signal.SIGTERM)
             self.fail("BashOperator's subprocess still running after stopping on timeout!")
 
+    def test_on_failure_callback(self):
+        # Annoying workaround for nonlocal not existing in python 2
+        data = {'called': False}
+
+        def check_failure(context, test_case=self):
+            data['called'] = True
+            error = context.get('exception')
+            test_case.assertIsInstance(error, AirflowException)
+
+        t = BashOperator(
+            task_id='check_on_failure_callback',
+            bash_command="exit 1",
+            dag=self.dag,
+            on_failure_callback=check_failure)
+        self.assertRaises(
+            exceptions.AirflowException,
+            t.run,
+            start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+        self.assertTrue(data['called'])
+
     def test_trigger_dagrun(self):
         def trigga(context, obj):
             if True:

From aa9244ff21c64b4443aea2ae3b6f65598f92ff78 Mon Sep 17 00:00:00 2001
From: Camilo Aguilar <camilo.aguilar@enigma.com>
Date: Fri, 6 Jul 2018 22:14:20 +0200
Subject: [PATCH 157/808] [AIRFLOW-1163][AIRFLOW-XXX] Add support for
 x-forwarded-* headers

When running Airflow behind a L7 proxy that sends
x-fowarded-* headers, the Flask app miscontructs
redirect URIs.

Closes #3580 from c4milo/master
---
 airflow/www/app.py      | 6 ++++--
 airflow/www_rbac/app.py | 6 ++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/airflow/www/app.py b/airflow/www/app.py
index e9b101db37689..6eea5d2d0ffd5 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -25,6 +25,7 @@
 from flask_wtf.csrf import CSRFProtect
 from six.moves.urllib.parse import urlparse
 from werkzeug.wsgi import DispatcherMiddleware
+from werkzeug.contrib.fixers import ProxyFix
 
 import airflow
 from airflow import configuration as conf
@@ -43,6 +44,7 @@
 
 def create_app(config=None, testing=False):
     app = Flask(__name__)
+    app.wsgi_app = ProxyFix(app.wsgi_app)
     app.secret_key = configuration.conf.get('webserver', 'SECRET_KEY')
     app.config['LOGIN_DISABLED'] = not configuration.conf.getboolean(
         'webserver', 'AUTHENTICATE')
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 85125c6eb06b8..1004764459e39 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -26,6 +26,7 @@
 from flask_wtf.csrf import CSRFProtect
 from six.moves.urllib.parse import urlparse
 from werkzeug.wsgi import DispatcherMiddleware
+from werkzeug.contrib.fixers import ProxyFix
 
 from airflow import settings
 from airflow import configuration as conf
@@ -40,6 +41,7 @@
 def create_app(config=None, testing=False, app_name="Airflow"):
     global app, appbuilder
     app = Flask(__name__)
+    app.wsgi_app = ProxyFix(app.wsgi_app)
     app.secret_key = conf.get('webserver', 'SECRET_KEY')
 
     airflow_home_path = conf.get('core', 'AIRFLOW_HOME')

From c0f6cd1231df4d68bd0d6012791446ffb58e8d85 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Tue, 2 Oct 2018 11:16:55 -0400
Subject: [PATCH 158/808] [AIRFLOW-3137] Make ProxyFix middleware optional.
 (#3983)

The ProxyFix middleware should only be used when airflow is running
behind a trusted proxy. This patch adds a `USE_PROXY_FIX` flag that
defaults to `False`.
---
 airflow/config_templates/default_airflow.cfg | 3 +++
 airflow/www/app.py                           | 3 ++-
 airflow/www_rbac/app.py                      | 3 ++-
 docs/integration.rst                         | 9 +++++++++
 4 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 3d0b2444ed505..1a3768ff74603 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -312,6 +312,9 @@ navbar_color = #007A87
 # Default dagrun to show in UI
 default_dag_run_display_number = 25
 
+# Enable werkzeug `ProxyFix` middleware
+enable_proxy_fix = False
+
 
 [email]
 email_backend = airflow.utils.email.send_email_smtp
diff --git a/airflow/www/app.py b/airflow/www/app.py
index 6eea5d2d0ffd5..1140be9aa06e3 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -44,7 +44,8 @@
 
 def create_app(config=None, testing=False):
     app = Flask(__name__)
-    app.wsgi_app = ProxyFix(app.wsgi_app)
+    if configuration.conf.getboolean('webserver', 'ENABLE_PROXY_FIX'):
+        app.wsgi_app = ProxyFix(app.wsgi_app)
     app.secret_key = configuration.conf.get('webserver', 'SECRET_KEY')
     app.config['LOGIN_DISABLED'] = not configuration.conf.getboolean(
         'webserver', 'AUTHENTICATE')
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 1004764459e39..bdf500d590add 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -41,7 +41,8 @@
 def create_app(config=None, testing=False, app_name="Airflow"):
     global app, appbuilder
     app = Flask(__name__)
-    app.wsgi_app = ProxyFix(app.wsgi_app)
+    if conf.getboolean('webserver', 'ENABLE_PROXY_FIX'):
+        app.wsgi_app = ProxyFix(app.wsgi_app)
     app.secret_key = conf.get('webserver', 'SECRET_KEY')
 
     airflow_home_path = conf.get('core', 'AIRFLOW_HOME')
diff --git a/docs/integration.rst b/docs/integration.rst
index 49c383541f191..2d9bc84c35928 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -64,6 +64,15 @@ Your reverse proxy (ex: nginx) should be configured as follow:
           }
       }
 
+To ensure that Airflow generates URLs with the correct scheme when
+running behind a TLS-terminating proxy, you should configure the proxy
+to set the `X-Forwarded-Proto` header, and enable the `ProxyFix`
+middleware in your `airflow.cfg`::
+
+    enable_proxy_fix = True
+
+Note: you should only enable the `ProxyFix` middleware when running
+Airflow behind a trusted proxy (AWS ELB, nginx, etc.).
 
 .. _Azure:
 

From e68544e42679c2ee04c38f66d124eaa1632bfdcf Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Thu, 25 Oct 2018 06:33:21 -0400
Subject: [PATCH 159/808] [AIRFLOW-1508] Add SKIPPED to task states. (#4059)

---
 airflow/models.py         |  2 +-
 airflow/utils/state.py    |  9 +++------
 airflow/www/views.py      | 20 ++++++--------------
 airflow/www_rbac/views.py | 20 ++++++--------------
 4 files changed, 16 insertions(+), 35 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index f9e3c6a7e96c2..f5052231c7d24 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4852,7 +4852,7 @@ def create(dag_id, session=None):
         """
         # unfortunately sqlalchemy does not know upsert
         qry = session.query(DagStat).filter(DagStat.dag_id == dag_id).all()
-        states = [dag_stat.state for dag_stat in qry]
+        states = {dag_stat.state for dag_stat in qry}
         for state in State.dag_states:
             if state not in states:
                 try:
diff --git a/airflow/utils/state.py b/airflow/utils/state.py
index a351df07b9654..b73aaa12a087a 100644
--- a/airflow/utils/state.py
+++ b/airflow/utils/state.py
@@ -51,6 +51,7 @@ class State(object):
         RUNNING,
         FAILED,
         UPSTREAM_FAILED,
+        SKIPPED,
         UP_FOR_RETRY,
         QUEUED,
         NONE,
@@ -79,18 +80,14 @@ class State(object):
 
     @classmethod
     def color(cls, state):
-        if state in cls.state_color:
-            return cls.state_color[state]
-        else:
-            return 'white'
+        return cls.state_color.get(state, 'white')
 
     @classmethod
     def color_fg(cls, state):
         color = cls.color(state)
         if color in ['green', 'red']:
             return 'white'
-        else:
-            return 'black'
+        return 'black'
 
     @classmethod
     def finished(cls):
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 40fc2d6838406..40bb8e577e88e 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -579,17 +579,13 @@ def dag_stats(self, session=None):
         for dag in dagbag.dags.values():
             payload[dag.safe_dag_id] = []
             for state in State.dag_states:
-                try:
-                    count = data[dag.dag_id][state]
-                except Exception:
-                    count = 0
-                d = {
+                count = data.get(dag.dag_id, {}).get(state, 0)
+                payload[dag.safe_dag_id].append({
                     'state': state,
                     'count': count,
                     'dag_id': dag.dag_id,
                     'color': State.color(state)
-                }
-                payload[dag.safe_dag_id].append(d)
+                })
         return wwwutils.json_response(payload)
 
     @expose('/task_stats')
@@ -650,17 +646,13 @@ def task_stats(self, session=None):
         for dag in dagbag.dags.values():
             payload[dag.safe_dag_id] = []
             for state in State.task_states:
-                try:
-                    count = data[dag.dag_id][state]
-                except Exception:
-                    count = 0
-                d = {
+                count = data.get(dag.dag_id, {}).get(state, 0)
+                payload[dag.safe_dag_id].append({
                     'state': state,
                     'count': count,
                     'dag_id': dag.dag_id,
                     'color': State.color(state)
-                }
-                payload[dag.safe_dag_id].append(d)
+                })
         return wwwutils.json_response(payload)
 
     @expose('/code')
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 69e2079059889..199904ce5419a 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -288,17 +288,13 @@ def dag_stats(self, session=None):
         for dag in dagbag.dags.values():
             payload[dag.safe_dag_id] = []
             for state in State.dag_states:
-                try:
-                    count = data[dag.dag_id][state]
-                except Exception:
-                    count = 0
-                d = {
+                count = data.get(dag.dag_id, {}).get(state, 0)
+                payload[dag.safe_dag_id].append({
                     'state': state,
                     'count': count,
                     'dag_id': dag.dag_id,
                     'color': State.color(state)
-                }
-                payload[dag.safe_dag_id].append(d)
+                })
         return wwwutils.json_response(payload)
 
     @expose('/task_stats')
@@ -359,17 +355,13 @@ def task_stats(self, session=None):
         for dag in dagbag.dags.values():
             payload[dag.safe_dag_id] = []
             for state in State.task_states:
-                try:
-                    count = data[dag.dag_id][state]
-                except Exception:
-                    count = 0
-                d = {
+                count = data.get(dag.dag_id, {}).get(state, 0)
+                payload[dag.safe_dag_id].append({
                     'state': state,
                     'count': count,
                     'dag_id': dag.dag_id,
                     'color': State.color(state)
-                }
-                payload[dag.safe_dag_id].append(d)
+                })
         return wwwutils.json_response(payload)
 
     @expose('/code')

From a59bbbffcb19b429ac03bff5618f2de5ebc8726b Mon Sep 17 00:00:00 2001
From: Jarek <exploy@users.noreply.github.com>
Date: Fri, 26 Oct 2018 14:29:00 +0200
Subject: [PATCH 160/808] [AIRFLOW-1970] Let empty Fernet key or special `no
 encryption` phrase. (#4038)

Once the user has installed Fernet package then the application enforces setting valid Fernet key.
This change will alter this behavior into letting empty Fernet key or special `no encryption` phrase and interpreting those two cases as no encryption desirable.
---
 airflow/configuration.py          |  9 +++------
 airflow/models.py                 | 22 ++++++++++++++++------
 docs/howto/secure-connections.rst |  9 +++++----
 tests/models.py                   |  1 -
 4 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index b92e93f3feaa5..1caea93a6cbbb 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -56,12 +56,9 @@ def generate_fernet_key():
     try:
         from cryptography.fernet import Fernet
     except ImportError:
-        pass
-    try:
-        key = Fernet.generate_key().decode()
-    except NameError:
-        key = "cryptography_not_found_storing_passwords_in_plain_text"
-    return key
+        return ''
+    else:
+        return Fernet.generate_key().decode()
 
 
 def expand_env_var(env_var):
diff --git a/airflow/models.py b/airflow/models.py
index f5052231c7d24..d9c63adb09d10 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -144,6 +144,8 @@ def get_fernet():
     :raises: AirflowException if there's a problem trying to load Fernet
     """
     global _fernet
+    log = LoggingMixin().log
+
     if _fernet:
         return _fernet
     try:
@@ -152,19 +154,27 @@ def get_fernet():
         InvalidFernetToken = InvalidToken
 
     except BuiltinImportError:
-        LoggingMixin().log.warn("cryptography not found - values will not be stored "
-                                "encrypted.",
-                                exc_info=1)
+        log.warning(
+            "cryptography not found - values will not be stored encrypted."
+        )
         _fernet = NullFernet()
         return _fernet
 
     try:
-        _fernet = Fernet(configuration.conf.get('core', 'FERNET_KEY').encode('utf-8'))
-        _fernet.is_encrypted = True
-        return _fernet
+        fernet_key = configuration.conf.get('core', 'FERNET_KEY')
+        if not fernet_key:
+            log.warning(
+                "empty cryptography key - values will not be stored encrypted."
+            )
+            _fernet = NullFernet()
+        else:
+            _fernet = Fernet(fernet_key.encode('utf-8'))
+            _fernet.is_encrypted = True
     except (ValueError, TypeError) as ve:
         raise AirflowException("Could not create Fernet object: {}".format(ve))
 
+    return _fernet
+
 
 # Used by DAG context_managers
 _CONTEXT_MANAGER_DAG = None
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index bb13b1bb08bba..b3b9ba193d295 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -4,13 +4,14 @@ Securing Connections
 By default, Airflow will save the passwords for the connection in plain text
 within the metadata database. The ``crypto`` package is highly recommended
 during installation. The ``crypto`` package does require that your operating
-system have libffi-dev installed.
+system has ``libffi-dev`` installed.
 
-If ``crypto`` package was not installed initially, you can still enable encryption for
-connections by following steps below:
+If ``crypto`` package was not installed initially, it means that your Fernet key in ``airflow.cfg`` is empty.
+
+You can still enable encryption for passwords within connections by following below steps:
 
 1. Install crypto package ``pip install apache-airflow[crypto]``
-2. Generate fernet_key, using this code snippet below. fernet_key must be a base64-encoded 32-byte key.
+2. Generate fernet_key, using this code snippet below. ``fernet_key`` must be a base64-encoded 32-byte key.
 
 .. code:: python
 
diff --git a/tests/models.py b/tests/models.py
index aee32c1646a67..51b8363454054 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -2742,7 +2742,6 @@ def test_connection_extra_no_encryption(self, mock_get):
         is set to a non-base64-encoded string and the extra is stored without
         encryption.
         """
-        mock_get.return_value = 'cryptography_not_found_storing_passwords_in_plain_text'
         test_connection = Connection(extra='testextra')
         self.assertEqual(test_connection.extra, 'testextra')
 

From 50cdcdbeda0abd3bbe4c877e28ad30e86ad93093 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 1 Oct 2018 21:44:27 +0100
Subject: [PATCH 161/808] [AIRFLOW-2574] Cope with '%' in SQLA DSN when running
 migrations (#3787)

Alembic uses a ConfigParser like Airflow does, and "%% is a special
value in there, so we need to escape it. As per the Alembic docs:

> Note that this value is passed to ConfigParser.set, which supports
> variable interpolation using pyformat (e.g. `%(some_value)s`). A raw
> percent sign not part of an interpolation symbol must therefore be
> escaped, e.g. `%%`
---
 airflow/utils/db.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index ef2dcf181762d..4697605815682 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -341,8 +341,8 @@ def upgradedb():
     package_dir = os.path.normpath(os.path.join(current_dir, '..'))
     directory = os.path.join(package_dir, 'migrations')
     config = Config(os.path.join(package_dir, 'alembic.ini'))
-    config.set_main_option('script_location', directory)
-    config.set_main_option('sqlalchemy.url', settings.SQL_ALCHEMY_CONN)
+    config.set_main_option('script_location', directory.replace('%', '%%'))
+    config.set_main_option('sqlalchemy.url', settings.SQL_ALCHEMY_CONN.replace('%', '%%'))
     command.upgrade(config, 'heads')
 
 

From e207eb0e25f12860029c8f74a9d512c317c17ac8 Mon Sep 17 00:00:00 2001
From: Olivier Morissette <olivier.morissette@gmail.com>
Date: Tue, 23 Oct 2018 12:21:30 -0400
Subject: [PATCH 162/808] [AIRFLOW-2744] Allow RBAC to accept plugins for views
 and links. (#4036)

Airflow Users that wish to create plugins for the new www_rbac UI
can not add plugin views or links. This PR fixes that by letting
a user specify their plugins for www_rbac and maintains backwards
compatibility with the existing plugins system.
---
 airflow/plugins_manager.py   |  6 ++++++
 airflow/www_rbac/app.py      | 20 ++++++++++++++++++
 docs/plugins.rst             | 35 ++++++++++++++++++++++++++++--
 tests/plugins/test_plugin.py | 30 ++++++++++++++++++++++++--
 tests/plugins_manager.py     | 41 ++++++++++++++++++++++++++++++++++++
 5 files changed, 128 insertions(+), 4 deletions(-)

diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index ad630701dec90..c589e9b5a91ea 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -49,6 +49,8 @@ class AirflowPlugin(object):
     admin_views = []
     flask_blueprints = []
     menu_links = []
+    appbuilder_views = []
+    appbuilder_menu_items = []
 
     @classmethod
     def validate(cls):
@@ -120,6 +122,8 @@ def make_module(name, objects):
 admin_views = []
 flask_blueprints = []
 menu_links = []
+flask_appbuilder_views = []
+flask_appbuilder_menu_links = []
 
 for p in plugins:
     operators_modules.append(
@@ -135,3 +139,5 @@ def make_module(name, objects):
     admin_views.extend(p.admin_views)
     flask_blueprints.extend(p.flask_blueprints)
     menu_links.extend(p.menu_links)
+    flask_appbuilder_views.extend(p.appbuilder_views)
+    flask_appbuilder_menu_links.extend(p.appbuilder_menu_items)
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index bdf500d590add..82f1b37c7c423 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import logging
 import socket
 import six
 
@@ -37,6 +38,7 @@
 appbuilder = None
 csrf = CSRFProtect()
 
+log = logging.getLogger(__name__)
 
 def create_app(config=None, testing=False, app_name="Airflow"):
     global app, appbuilder
@@ -123,6 +125,24 @@ def init_views(appbuilder):
                                 category='About',
                                 category_icon='fa-th')
 
+            def integrate_plugins():
+                """Integrate plugins to the context"""
+                from airflow.plugins_manager import (
+                    flask_appbuilder_views, flask_appbuilder_menu_links)
+
+                for v in flask_appbuilder_views:
+                    log.debug("Adding view %s", v["name"])
+                    appbuilder.add_view(v["view"],
+                                        v["name"],
+                                        category=v["category"])
+                for ml in sorted(flask_appbuilder_menu_links, key=lambda x: x["name"]):
+                    log.debug("Adding menu link %s", ml["name"])
+                    appbuilder.add_link(ml["name"],
+                                        href=ml["href"],
+                                        category=ml["category"],
+                                        category_icon=ml["category_icon"])
+
+            integrate_plugins()
             # Garbage collect old permissions/views after they have been modified.
             # Otherwise, when the name of a view or menu is changed, the framework
             # will add the new Views and Menus names to the backend, but will not
diff --git a/docs/plugins.rst b/docs/plugins.rst
index a21f1007ff686..8173e632e5f3f 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -72,10 +72,15 @@ looks like:
         # A list of objects created from a class derived
         # from flask_admin.BaseView
         admin_views = []
-        # A list of Blueprint object created from flask.Blueprint
+        # A list of Blueprint object created from flask.Blueprint. For use with the flask_admin based GUI
         flask_blueprints = []
-        # A list of menu links (flask_admin.base.MenuLink)
+        # A list of menu links (flask_admin.base.MenuLink). For use with the flask_admin based GUI
         menu_links = []
+        # A list of dictionaries containing FlaskAppBuilder BaseView object and some metadata. See example below
+        appbuilder_views = []
+        # A list of dictionaries containing FlaskAppBuilder BaseView object and some metadata. See example below
+        appbuilder_menu_items = []
+
 
 
 Example
@@ -139,6 +144,22 @@ definitions in Airflow.
         name='Test Menu Link',
         url='https://airflow.incubator.apache.org/')
 
+    # Creating a flask appbuilder BaseView
+    class TestAppBuilderBaseView(AppBuilderBaseView):
+        @expose("/")
+        def test(self):
+            return self.render("test_plugin/test.html", content="Hello galaxy!")
+    v_appbuilder_view = TestAppBuilderBaseView()
+    v_appbuilder_package = {"name": "Test View",
+                            "category": "Test Plugin",
+                            "view": v_appbuilder_view}
+
+    # Creating a flask appbuilder Menu Item
+    appbuilder_mitem = {"name": "Google",
+                        "category": "Search",
+                        "category_icon": "fa-th",
+                        "href": "https://www.google.com"}
+
     # Defining the plugin class
     class AirflowTestPlugin(AirflowPlugin):
         name = "test_plugin"
@@ -150,3 +171,13 @@ definitions in Airflow.
         admin_views = [v]
         flask_blueprints = [bp]
         menu_links = [ml]
+        appbuilder_views = [v_appbuilder_package]
+        appbuilder_menu_items = [appbuilder_mitem]
+
+
+Note on role based views
+------------------------
+
+Airflow 1.10 introduced role based views using FlaskAppBuilder. You can configure which UI is used by setting
+rbac = True. To support plugin views and links for both versions of the UI and maintain backwards compatibility,
+the fields appbuilder_views and appbuilder_menu_items were added to the AirflowTestPlugin class.
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index d4c7f27b1c573..0770da120bc4c 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -23,6 +23,7 @@
 from flask import Blueprint
 from flask_admin import BaseView, expose
 from flask_admin.base import MenuLink
+from flask_appbuilder import BaseView as AppBuilderBaseView
 
 # Importing base classes that we need to derive
 from airflow.hooks.base_hook import BaseHook
@@ -60,6 +61,28 @@ def test(self):
         return self.render("test_plugin/test.html", content="Hello galaxy!")
 v = TestView(category="Test Plugin", name="Test View")
 
+
+# Creating a flask appbuilder BaseView
+class TestAppBuilderBaseView(AppBuilderBaseView):
+    default_view = "test"
+
+    @expose("/")
+    def test(self):
+        return self.render("test_plugin/test.html", content="Hello galaxy!")
+
+
+v_appbuilder_view = TestAppBuilderBaseView()
+v_appbuilder_package = {"name": "Test View",
+                        "category": "Test Plugin",
+                        "view": v_appbuilder_view}
+
+# Creating a flask appbuilder Menu Item
+appbuilder_mitem = {"name": "Google",
+                    "category": "Search",
+                    "category_icon": "fa-th",
+                    "href": "https://www.google.com"}
+
+
 # Creating a flask blueprint to intergrate the templates and static folder
 bp = Blueprint(
     "test_plugin", __name__,
@@ -67,10 +90,11 @@ def test(self):
     static_folder='static',
     static_url_path='/static/test_plugin')
 
+
 ml = MenuLink(
     category='Test Plugin',
-    name='Test Menu Link',
-    url='https://airflow.incubator.apache.org/')
+    name="Test Menu Link",
+    url="https://airflow.incubator.apache.org/")
 
 
 # Defining the plugin class
@@ -84,3 +108,5 @@ class AirflowTestPlugin(AirflowPlugin):
     admin_views = [v]
     flask_blueprints = [bp]
     menu_links = [ml]
+    appbuilder_views = [v_appbuilder_package]
+    appbuilder_menu_items = [appbuilder_mitem]
diff --git a/tests/plugins_manager.py b/tests/plugins_manager.py
index f9d093f16284e..0013d9f641f3c 100644
--- a/tests/plugins_manager.py
+++ b/tests/plugins_manager.py
@@ -30,11 +30,13 @@
 from flask_admin import BaseView
 from flask_admin.menu import MenuLink, MenuView
 
+from airflow.configuration import conf
 from airflow.hooks.base_hook import BaseHook
 from airflow.models import  BaseOperator
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.executors.base_executor import BaseExecutor
 from airflow.www.app import cached_app
+from airflow.www_rbac import app as application
 
 
 class PluginsTest(unittest.TestCase):
@@ -86,3 +88,42 @@ def test_menu_links(self):
         [menu_link] = [ml for ml in category.get_children()
                        if isinstance(ml, MenuLink)]
         self.assertEqual('Test Menu Link', menu_link.name)
+
+
+class PluginsTestRBAC(unittest.TestCase):
+    def setUp(self):
+        conf.load_test_config()
+        self.app, self.appbuilder = application.create_app(testing=True)
+
+    def test_flaskappbuilder_views(self):
+        from tests.plugins.test_plugin import v_appbuilder_package
+        appbuilder_class_name = str(v_appbuilder_package['view'].__class__.__name__)
+        plugin_views = [view for view in self.appbuilder.baseviews
+                        if view.blueprint.name == appbuilder_class_name]
+
+        self.assertTrue(len(plugin_views) == 1)
+
+        # view should have a menu item matching category of v_appbuilder_package
+        links = [menu_item for menu_item in self.appbuilder.menu.menu
+                 if menu_item.name == v_appbuilder_package['category']]
+
+        self.assertTrue(len(links) == 1)
+
+        # menu link should also have a link matching the name of the package.
+        link = links[0]
+        self.assertEqual(link.name, v_appbuilder_package['category'])
+        self.assertEqual(link.childs[0].name, v_appbuilder_package['name'])
+
+    def test_flaskappbuilder_menu_links(self):
+        from tests.plugins.test_plugin import appbuilder_mitem
+
+        # menu item should exist matching appbuilder_mitem
+        links = [menu_item for menu_item in self.appbuilder.menu.menu
+                 if menu_item.name == appbuilder_mitem['category']]
+
+        self.assertTrue(len(links) == 1)
+
+        # menu link should also have a link matching the name of the package.
+        link = links[0]
+        self.assertEqual(link.name, appbuilder_mitem['category'])
+        self.assertEqual(link.childs[0].name, appbuilder_mitem['name'])

From 24d83fa5dd268f90aec39483f630e147b6b08cb2 Mon Sep 17 00:00:00 2001
From: Ethan Vizitei <ethan.vizitei@gmail.com>
Date: Mon, 5 Nov 2018 11:24:55 -0600
Subject: [PATCH 163/808] [AIRFLOW-2865] Call success_callback before updating
 task state (#4082)

In cases where the success callback takes variable
time, it's possible for it to interrupted by the heartbeat process.
This is because the heartbeat process looks for tasks that are no
longer in the "running" state but are still executing and reaps them.

This commit reverses the order of callback invocation and state
updating so that the "SUCCESS" state for the task isn't committed
to the database until after the success callback has finished.
---
 airflow/models.py | 14 ++++++--------
 tests/models.py   | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index d9c63adb09d10..c397e3f5d39bb 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1697,14 +1697,6 @@ def signal_handler(signum, frame):
             self.handle_failure(e, test_mode, context)
             raise
 
-        # Recording SUCCESS
-        self.end_date = timezone.utcnow()
-        self.set_duration()
-        if not test_mode:
-            session.add(Log(self.state, self))
-            session.merge(self)
-        session.commit()
-
         # Success callback
         try:
             if task.on_success_callback:
@@ -1713,6 +1705,12 @@ def signal_handler(signum, frame):
             self.log.error("Failed when executing success callback")
             self.log.exception(e3)
 
+        # Recording SUCCESS
+        self.end_date = timezone.utcnow()
+        self.set_duration()
+        if not test_mode:
+            session.add(Log(self.state, self))
+            session.merge(self)
         session.commit()
 
     @provide_session
diff --git a/tests/models.py b/tests/models.py
index 51b8363454054..0c34878ee5696 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -2425,6 +2425,40 @@ def test_overwrite_params_with_dag_run_conf_none(self):
 
         self.assertEqual(False, params["override"])
 
+    def test_success_callbak_no_race_condition(self):
+        class CallbackWrapper(object):
+            def wrap_task_instance(self, ti):
+                self.task_id = ti.task_id
+                self.dag_id = ti.dag_id
+                self.execution_date = ti.execution_date
+                self.task_state_in_callback = ""
+                self.callback_ran = False
+
+            def success_handler(self, context):
+                self.callback_ran = True
+                session = settings.Session()
+                temp_instance = session.query(TI).filter(
+                    TI.task_id == self.task_id).filter(
+                    TI.dag_id == self.dag_id).filter(
+                    TI.execution_date == self.execution_date).one()
+                self.task_state_in_callback = temp_instance.state
+        cw = CallbackWrapper()
+        dag = DAG('test_success_callbak_no_race_condition', start_date=DEFAULT_DATE,
+                  end_date=DEFAULT_DATE + datetime.timedelta(days=10))
+        task = DummyOperator(task_id='op', email='test@test.test',
+                             on_success_callback=cw.success_handler, dag=dag)
+        ti = TI(task=task, execution_date=datetime.datetime.now())
+        ti.state = State.RUNNING
+        session = settings.Session()
+        session.merge(ti)
+        session.commit()
+        cw.wrap_task_instance(ti)
+        ti._run_raw_task()
+        self.assertTrue(cw.callback_ran)
+        self.assertEqual(cw.task_state_in_callback, State.RUNNING)
+        ti.refresh_from_db()
+        self.assertEqual(ti.state, State.SUCCESS)
+
 
 class ClearTasksTest(unittest.TestCase):
 

From 5895c7d2578eba74cddc689b24a4be8bd882ab5d Mon Sep 17 00:00:00 2001
From: Jeff Payne <jeffkpayne@gmail.com>
Date: Wed, 5 Sep 2018 01:45:44 -0700
Subject: [PATCH 164/808] [AIRFLOW-3002] Fix variable & tests in
 GoogleCloudBucketHelper (#3843)

---
 .../contrib/operators/dataflow_operator.py    |  8 +--
 .../operators/test_dataflow_operator.py       | 54 +++++++++++++++++--
 2 files changed, 55 insertions(+), 7 deletions(-)

diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index cd289f546ad3c..792488156dcf3 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -361,17 +361,17 @@ def google_cloud_to_local(self, file_name):
         path_components = file_name[self.GCS_PREFIX_LENGTH:].split('/')
         if len(path_components) < 2:
             raise Exception(
-                'Invalid Google Cloud Storage (GCS) object path: {}.'
+                'Invalid Google Cloud Storage (GCS) object path: {}'
                 .format(file_name))
 
         bucket_id = path_components[0]
         object_id = '/'.join(path_components[1:])
         local_file = '/tmp/dataflow{}-{}'.format(str(uuid.uuid1())[:8],
                                                  path_components[-1])
-        file_size = self._gcs_hook.download(bucket_id, object_id, local_file)
+        self._gcs_hook.download(bucket_id, object_id, local_file)
 
-        if os.stat(file_size).st_size > 0:
+        if os.stat(local_file).st_size > 0:
             return local_file
         raise Exception(
-            'Failed to download Google Cloud Storage GCS object: {}'
+            'Failed to download Google Cloud Storage (GCS) object: {}'
             .format(file_name))
diff --git a/tests/contrib/operators/test_dataflow_operator.py b/tests/contrib/operators/test_dataflow_operator.py
index a373126b24e4b..8ed4583255733 100644
--- a/tests/contrib/operators/test_dataflow_operator.py
+++ b/tests/contrib/operators/test_dataflow_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -207,5 +207,53 @@ def test_invalid_object_path(self, mock_parent_init):
             gcs_bucket_helper.google_cloud_to_local(file_name)
 
         self.assertEquals(
-            'Invalid Google Cloud Storage (GCS) object path: {}.'.format(file_name),
+            'Invalid Google Cloud Storage (GCS) object path: {}'.format(file_name),
+            str(context.exception))
+
+    @mock.patch(
+        'airflow.contrib.operators.dataflow_operator.GoogleCloudBucketHelper.__init__'
+    )
+    def test_valid_object(self, mock_parent_init):
+
+        file_name = 'gs://test-bucket/path/to/obj.jar'
+        mock_parent_init.return_value = None
+
+        gcs_bucket_helper = GoogleCloudBucketHelper()
+        gcs_bucket_helper._gcs_hook = mock.Mock()
+
+        def _mock_download(bucket, object, filename=None):
+            text_file_contents = 'text file contents'
+            with open(filename, 'w') as text_file:
+                text_file.write(text_file_contents)
+            return text_file_contents
+
+        gcs_bucket_helper._gcs_hook.download.side_effect = _mock_download
+
+        local_file = gcs_bucket_helper.google_cloud_to_local(file_name)
+        self.assertIn('obj.jar', local_file)
+
+    @mock.patch(
+        'airflow.contrib.operators.dataflow_operator.GoogleCloudBucketHelper.__init__'
+    )
+    def test_empty_object(self, mock_parent_init):
+
+        file_name = 'gs://test-bucket/path/to/obj.jar'
+        mock_parent_init.return_value = None
+
+        gcs_bucket_helper = GoogleCloudBucketHelper()
+        gcs_bucket_helper._gcs_hook = mock.Mock()
+
+        def _mock_download(bucket, object, filename=None):
+            text_file_contents = ''
+            with open(filename, 'w') as text_file:
+                text_file.write(text_file_contents)
+            return text_file_contents
+
+        gcs_bucket_helper._gcs_hook.download.side_effect = _mock_download
+
+        with self.assertRaises(Exception) as context:
+            gcs_bucket_helper.google_cloud_to_local(file_name)
+
+        self.assertEquals(
+            'Failed to download Google Cloud Storage (GCS) object: {}'.format(file_name),
             str(context.exception))

From d44013abb081a28ebb1ccb4bd2a71a56c24f8409 Mon Sep 17 00:00:00 2001
From: Dan MacTough <danmactough@gmail.com>
Date: Wed, 17 Oct 2018 14:42:01 -0400
Subject: [PATCH 165/808] [AIRFLOW-3046] Report fail from ECS Operator when
 host terminates (#4039)

Add check for host termination to ECS Operator

If an ECS task fails to complete because the host it's running on is terminated, we need to raise an exception so it can be retried.
---
 airflow/contrib/operators/ecs_operator.py    | 10 ++++
 tests/contrib/operators/test_ecs_operator.py | 52 +++++++++++++++++---
 2 files changed, 56 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/operators/ecs_operator.py b/airflow/contrib/operators/ecs_operator.py
index 84bc2a3c91a2f..34a5e0b7694f5 100644
--- a/airflow/contrib/operators/ecs_operator.py
+++ b/airflow/contrib/operators/ecs_operator.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 import sys
+import re
 
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
@@ -116,6 +117,15 @@ def _check_success_task(self):
             raise AirflowException(response)
 
         for task in response['tasks']:
+            # This is a `stoppedReason` that indicates a task has not
+            # successfully finished, but there is no other indication of failure
+            # in the response.
+            # See, https://docs.aws.amazon.com/AmazonECS/latest/developerguide/stopped-task-errors.html # noqa E501
+            if re.match(r'Host EC2 \(instance .+?\) (stopped|terminated)\.',
+                        task.get('stoppedReason', '')):
+                raise AirflowException(
+                    'The task was stopped because the host instance terminated: {}'.
+                    format(task.get('stoppedReason', '')))
             containers = task['containers']
             for container in containers:
                 if container.get('lastStatus') == 'STOPPED' and \
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index b5d3141ec86ce..1467fff0b43eb 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -134,8 +134,10 @@ def test_wait_end_tasks(self):
 
         self.ecs._wait_for_task_ended()
         client_mock.get_waiter.assert_called_once_with('tasks_stopped')
-        client_mock.get_waiter.return_value.wait.assert_called_once_with(cluster='c', tasks=['arn'])
-        self.assertEquals(sys.maxsize, client_mock.get_waiter.return_value.config.max_attempts)
+        client_mock.get_waiter.return_value.wait.assert_called_once_with(
+            cluster='c', tasks=['arn'])
+        self.assertEquals(
+            sys.maxsize, client_mock.get_waiter.return_value.config.max_attempts)
 
     def test_check_success_tasks_raises(self):
         client_mock = mock.Mock()
@@ -159,7 +161,8 @@ def test_check_success_tasks_raises(self):
         self.assertIn("'name': 'foo'", str(e.exception))
         self.assertIn("'lastStatus': 'STOPPED'", str(e.exception))
         self.assertIn("'exitCode': 1", str(e.exception))
-        client_mock.describe_tasks.assert_called_once_with(cluster='c', tasks=['arn'])
+        client_mock.describe_tasks.assert_called_once_with(
+            cluster='c', tasks=['arn'])
 
     def test_check_success_tasks_raises_pending(self):
         client_mock = mock.Mock()
@@ -179,7 +182,8 @@ def test_check_success_tasks_raises_pending(self):
         self.assertIn("This task is still pending ", str(e.exception))
         self.assertIn("'name': 'container-name'", str(e.exception))
         self.assertIn("'lastStatus': 'PENDING'", str(e.exception))
-        client_mock.describe_tasks.assert_called_once_with(cluster='c', tasks=['arn'])
+        client_mock.describe_tasks.assert_called_once_with(
+            cluster='c', tasks=['arn'])
 
     def test_check_success_tasks_raises_mutliple(self):
         client_mock = mock.Mock()
@@ -198,7 +202,42 @@ def test_check_success_tasks_raises_mutliple(self):
             }]
         }
         self.ecs._check_success_task()
-        client_mock.describe_tasks.assert_called_once_with(cluster='c', tasks=['arn'])
+        client_mock.describe_tasks.assert_called_once_with(
+            cluster='c', tasks=['arn'])
+
+    def test_host_terminated_raises(self):
+        client_mock = mock.Mock()
+        self.ecs.client = client_mock
+        self.ecs.arn = 'arn'
+        client_mock.describe_tasks.return_value = {
+            'tasks': [{
+                'stoppedReason': 'Host EC2 (instance i-1234567890abcdef) terminated.',
+                "containers": [
+                    {
+                        "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e1ed7aac-d9b2-4315-8726-d2432bf11868",  # noqa: E501
+                        "lastStatus": "RUNNING",
+                        "name": "wordpress",
+                        "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55"  # noqa: E501
+                    }
+                ],
+                "desiredStatus": "STOPPED",
+                "lastStatus": "STOPPED",
+                "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55",  # noqa: E501
+                "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:11"  # noqa: E501
+
+            }]
+        }
+
+        with self.assertRaises(AirflowException) as e:
+            self.ecs._check_success_task()
+
+        self.assertIn(
+            "The task was stopped because the host instance terminated:",
+            str(e.exception))
+        self.assertIn("Host EC2 (", str(e.exception))
+        self.assertIn(") terminated", str(e.exception))
+        client_mock.describe_tasks.assert_called_once_with(
+            cluster='c', tasks=['arn'])
 
     def test_check_success_task_not_raises(self):
         client_mock = mock.Mock()
@@ -214,7 +253,8 @@ def test_check_success_task_not_raises(self):
             }]
         }
         self.ecs._check_success_task()
-        client_mock.describe_tasks.assert_called_once_with(cluster='c', tasks=['arn'])
+        client_mock.describe_tasks.assert_called_once_with(
+            cluster='c', tasks=['arn'])
 
 
 if __name__ == '__main__':

From d13e943484a8bb28e68f26f5ffc9de6c6f20bb57 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sun, 14 Oct 2018 17:24:45 +0100
Subject: [PATCH 166/808] [AIRFLOW-3064] Show logs/output from operators in
 `airflow test` command (#4051)

The logging rejig we did a for 1.10 ened with us the output from
operators/tasks when running `airflow test` not going anywhere (because
we have call `ti.init_run_context()` the FileTaskHandler doens't have a
filename, so logs don't go anywhere)
---
 airflow/bin/cli.py    |  5 +++++
 tests/cli/test_cli.py | 26 ++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 74b304e403826..2940d2e1232d1 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -570,6 +570,11 @@ def list_tasks(args, dag=None):
 
 @cli_utils.action_logging
 def test(args, dag=None):
+    # We want log outout from operators etc to show up here. Normally
+    # airflow.task would redirect to a file, but here we want it to propagate
+    # up to the normal airflow handler.
+    logging.getLogger('airflow.task').propagate = True
+
     dag = dag or get_dag(args)
 
     task = dag.get_task(task_id=args.task_id)
diff --git a/tests/cli/test_cli.py b/tests/cli/test_cli.py
index c3eee0c1674ab..944ee16fad167 100644
--- a/tests/cli/test_cli.py
+++ b/tests/cli/test_cli.py
@@ -18,6 +18,8 @@
 # under the License.
 #
 
+from six import StringIO
+import sys
 import unittest
 
 from mock import patch, Mock, MagicMock
@@ -25,6 +27,7 @@
 import psutil
 from argparse import Namespace
 from airflow import settings
+import airflow.bin.cli as cli
 from airflow.bin.cli import get_num_ready_workers_running, run, get_dag
 from airflow.models import TaskInstance
 from airflow.utils import timezone
@@ -177,3 +180,26 @@ def test_local_run(self):
             ti.refresh_from_db()
             state = ti.current_state()
             self.assertEqual(state, State.SUCCESS)
+
+    def test_test(self):
+        """Test the `airflow test` command"""
+        args = create_mock_args(
+            task_id='print_the_context',
+            dag_id='example_python_operator',
+            subdir=None,
+            execution_date=timezone.parse('2018-01-01')
+        )
+
+        saved_stdout = sys.stdout
+        try:
+            sys.stdout = out = StringIO()
+            cli.test(args)
+
+            output = out.getvalue()
+            # Check that prints, and log messages, are shown
+            self.assertIn('Done. Returned value was: Whatever you return gets printed in the logs',
+                          output)
+            self.assertIn("'example_python_operator__print_the_context__20180101'",
+                          output)
+        finally:
+            sys.stdout = saved_stdout

From c28b0cf9e165ca12fda96641b443866edec0bc37 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 25 Sep 2018 02:20:17 +0800
Subject: [PATCH 167/808] [AIRFLOW-3067] Display www_rbac Flask flash msg
 properly (#3903)

The Flask flash messages are not displayed properly.

When we don't give a category for a flash message, defautl
value will be 'message'. In some cases, we specify 'error'
category.

Using Flask-AppBuilder, the flash message will be given
a CSS class 'alert-[category]'. But We don't have
'alert-message' or 'alert-error' in the current
'bootstrap-theme.css' file.

This makes the the flash messages in www_rbac UI come with
no background color.

This commit addresses this issue by adding 'alert-message'
(using specs of existing CSS class 'alert-info') and
'alert-error' (using specs of existing CSS class 'alert-danger')
into 'bootstrap-theme.css'.
---
 airflow/www_rbac/static/bootstrap-theme.css | 22 +++++++++++++++++++++
 airflow/www_rbac/views.py                   |  9 +++++----
 2 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/airflow/www_rbac/static/bootstrap-theme.css b/airflow/www_rbac/static/bootstrap-theme.css
index 734f940feed61..3adaec1d3b80d 100644
--- a/airflow/www_rbac/static/bootstrap-theme.css
+++ b/airflow/www_rbac/static/bootstrap-theme.css
@@ -4949,6 +4949,28 @@ a.thumbnail.active {
 .alert-danger .alert-link {
   color: #843534;
 }
+.alert-message {
+  background-color: #d9edf7;
+  border-color: #bce8f1;
+  color: #31708f;
+}
+.alert-message hr {
+  border-top-color: #a6e1ec;
+}
+.alert-message .alert-link {
+  color: #245269;
+}
+.alert-error {
+  background-color: #f2dede;
+  border-color: #ebccd1;
+  color: #a94442;
+}
+.alert-error hr {
+  border-top-color: #e4b9c0;
+}
+.alert-error .alert-link {
+  color: #843534;
+}
 @-webkit-keyframes progress-bar-stripes {
   from {
     background-position: 40px 0;
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 199904ce5419a..50f30649039bf 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -732,11 +732,12 @@ def delete(self):
         try:
             delete_dag.delete_dag(dag_id)
         except DagNotFound:
-            flash("DAG with id {} not found. Cannot delete".format(dag_id))
+            flash("DAG with id {} not found. Cannot delete".format(dag_id), 'error')
             return redirect(request.referrer)
         except DagFileExists:
             flash("Dag id {} is still in DagBag. "
-                  "Remove the DAG file first.".format(dag_id))
+                  "Remove the DAG file first.".format(dag_id),
+                  'error')
             return redirect(request.referrer)
 
         flash("Deleting DAG with id {}. May take a couple minutes to fully"
@@ -1895,7 +1896,7 @@ def varimport(self):
             else:
                 d = json.loads(out)
         except Exception:
-            flash("Missing file or syntax error.")
+            flash("Missing file or syntax error.", 'error')
         else:
             suc_count = fail_count = 0
             for k, v in d.items():
@@ -1906,7 +1907,7 @@ def varimport(self):
                     fail_count += 1
                 else:
                     suc_count += 1
-            flash("{} variable(s) successfully updated.".format(suc_count), 'info')
+            flash("{} variable(s) successfully updated.".format(suc_count))
             if fail_count:
                 flash("{} variables(s) failed to be updated.".format(fail_count), 'error')
             self.update_redirect()

From 47d5447c323b3811705ff7817a316deece423371 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Bili=C5=84ski?= <szymon.bilinski@gmail.com>
Date: Mon, 15 Oct 2018 07:41:35 +0200
Subject: [PATCH 168/808] [AIRFLOW-3069] Log all output of the S3 file
 transform script (#3914)

The output of the process spawned by S3FileTransformOperator is not
properly decoded, which makes reading logs rather difficult. Additonally,
the stderr stream is only shown when process exit code is not equal to 0.

- Send both output streams (stdout & stderr) to the logger.
- Decode the output, so that new lines can be displayed correctly.
- Include process exit code in the exception message, if the process fails.
- Remove a potential deadlock, caused by `stderr=subprocess.PIPE`.
- Don't load all output into memory.
---
 .../operators/s3_file_transform_operator.py   | 24 +++++++---
 .../test_s3_file_transform_operator.py        | 48 +++++++++++++++++--
 2 files changed, 61 insertions(+), 11 deletions(-)

diff --git a/airflow/operators/s3_file_transform_operator.py b/airflow/operators/s3_file_transform_operator.py
index 84a6eda0c8101..5111d455a832c 100644
--- a/airflow/operators/s3_file_transform_operator.py
+++ b/airflow/operators/s3_file_transform_operator.py
@@ -19,6 +19,7 @@
 
 from tempfile import NamedTemporaryFile
 import subprocess
+import sys
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.S3_hook import S3Hook
@@ -82,6 +83,7 @@ def __init__(
         self.replace = replace
         self.transform_script = transform_script
         self.select_expression = select_expression
+        self.output_encoding = sys.getdefaultencoding()
 
     def execute(self, context):
         if self.transform_script is None and self.select_expression is None:
@@ -114,15 +116,23 @@ def execute(self, context):
             f_source.flush()
 
             if self.transform_script is not None:
-                transform_script_process = subprocess.Popen(
+                process = subprocess.Popen(
                     [self.transform_script, f_source.name, f_dest.name],
-                    stdout=subprocess.PIPE, stderr=subprocess.PIPE, close_fds=True)
-                (transform_script_stdoutdata, transform_script_stderrdata) = \
-                    transform_script_process.communicate()
-                self.log.info("Transform script stdout %s", transform_script_stdoutdata)
-                if transform_script_process.returncode > 0:
+                    stdout=subprocess.PIPE,
+                    stderr=subprocess.STDOUT,
+                    close_fds=True
+                )
+
+                self.log.info("Output:")
+                for line in iter(process.stdout.readline, b''):
+                    self.log.info(line.decode(self.output_encoding).rstrip())
+
+                process.wait()
+
+                if process.returncode > 0:
                     raise AirflowException(
-                        "Transform script failed %s", transform_script_stderrdata)
+                        "Transform script failed: {0}".format(process.returncode)
+                    )
                 else:
                     self.log.info(
                         "Transform script successful. Output temporarily located at %s",
diff --git a/tests/operators/test_s3_file_transform_operator.py b/tests/operators/test_s3_file_transform_operator.py
index 6b72c58f7857f..af00a4bcf5f75 100644
--- a/tests/operators/test_s3_file_transform_operator.py
+++ b/tests/operators/test_s3_file_transform_operator.py
@@ -22,6 +22,7 @@
 import io
 import os
 import shutil
+import sys
 import unittest
 from tempfile import mkdtemp
 
@@ -29,6 +30,7 @@
 import mock
 from moto import mock_s3
 
+from airflow.exceptions import AirflowException
 from airflow.operators.s3_file_transform_operator import S3FileTransformOperator
 
 
@@ -48,11 +50,15 @@ def tearDown(self):
                 raise e
 
     @mock.patch('subprocess.Popen')
+    @mock.patch.object(S3FileTransformOperator, 'log')
     @mock_s3
-    def test_execute_with_transform_script(self, mock_Popen):
-        transform_script_process = mock_Popen.return_value
-        transform_script_process.communicate.return_value = [None, None]
-        transform_script_process.returncode = 0
+    def test_execute_with_transform_script(self, mock_log, mock_Popen):
+        process_output = [b"Foo", b"Bar", b"Baz"]
+
+        process = mock_Popen.return_value
+        process.stdout.readline.side_effect = process_output
+        process.wait.return_value = None
+        process.returncode = 0
 
         bucket = "bucket"
         input_key = "foo"
@@ -72,6 +78,40 @@ def test_execute_with_transform_script(self, mock_Popen):
             task_id="task_id")
         t.execute(None)
 
+        mock_log.info.assert_has_calls([
+            mock.call(line.decode(sys.getdefaultencoding())) for line in process_output
+        ])
+
+    @mock.patch('subprocess.Popen')
+    @mock_s3
+    def test_execute_with_failing_transform_script(self, mock_Popen):
+        process = mock_Popen.return_value
+        process.stdout.readline.side_effect = []
+        process.wait.return_value = None
+        process.returncode = 42
+
+        bucket = "bucket"
+        input_key = "foo"
+        output_key = "bar"
+        bio = io.BytesIO(b"input")
+
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=bucket)
+        conn.upload_fileobj(Bucket=bucket, Key=input_key, Fileobj=bio)
+
+        s3_url = "s3://{0}/{1}"
+        t = S3FileTransformOperator(
+            source_s3_key=s3_url.format(bucket, input_key),
+            dest_s3_key=s3_url.format(bucket, output_key),
+            transform_script=self.transform_script,
+            replace=True,
+            task_id="task_id")
+
+        with self.assertRaises(AirflowException) as e:
+            t.execute(None)
+
+        self.assertEqual('Transform script failed: 42', str(e.exception))
+
     @mock.patch('airflow.hooks.S3_hook.S3Hook.select_key', return_value="input")
     @mock_s3
     def test_execute_with_select_expression(self, mock_select_key):

From 6b1859849f2fa760eb67b12083046418f584724b Mon Sep 17 00:00:00 2001
From: Brad Holmes <holmesbr@ncbi.nlm.nih.gov>
Date: Sat, 29 Sep 2018 13:17:43 -0400
Subject: [PATCH 169/808] [AIRFLOW-3079] Improve migration scripts to support
 MSSQL Server (#3964)

There were two problems for MSSQL.  First, 'timestamp' data type in MSSQL Server
is essentially a row-id, and not a timezone enabled date/time stamp. Second, alembic
creates invalid SQL when applying the 0/1 constraint to boolean values. MSSQL should
enforce this constraint by simply asserting a boolean value.
---
 .../0e2a74e0fc9f_add_time_zone_awareness.py     |  6 +++---
 ...ff4_add_kubernetes_resource_checkpointing.py | 17 ++++++++++++++---
 ...215c0_add_kubernetes_scheduler_uniqueness.py | 17 ++++++++++++++---
 3 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py b/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
index 64ee41c44d9e2..ad10c76ab8bc6 100644
--- a/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
+++ b/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
@@ -84,8 +84,8 @@ def upgrade():
         op.alter_column(table_name='xcom', column_name='timestamp', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='xcom', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6))
     else:
-        # sqlite datetime is fine as is not converting
-        if conn.dialect.name == 'sqlite':
+        # sqlite and mssql datetime are fine as is.  Therefore, not converting
+        if conn.dialect.name in ('sqlite', 'mssql'):
             return
 
         # we try to be database agnostic, but not every db (e.g. sqlserver)
@@ -176,7 +176,7 @@ def downgrade():
         op.alter_column(table_name='xcom', column_name='DATETIME', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='xcom', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
     else:
-        if conn.dialect.name == 'sqlite':
+        if conn.dialect.name in ('sqlite', 'mssql'):
             return
 
         # we try to be database agnostic, but not every db (e.g. sqlserver)
diff --git a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
index c489c05f7ea39..4eb056892ac5f 100644
--- a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
+++ b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
@@ -40,12 +40,23 @@
 
 
 def upgrade():
+
+    columns_and_constraints = [
+        sa.Column("one_row_id", sa.Boolean, server_default=sa.true(), primary_key=True),
+        sa.Column("resource_version", sa.String(255))
+    ]
+
+    conn = op.get_bind()
+
+    # alembic creates an invalid SQL for mssql dialect
+    if conn.dialect.name not in ('mssql'):
+        columns_and_constraints.append(sa.CheckConstraint("one_row_id", name="kube_resource_version_one_row_id"))
+
     table = op.create_table(
         RESOURCE_TABLE,
-        sa.Column("one_row_id", sa.Boolean, server_default=sa.true(), primary_key=True),
-        sa.Column("resource_version", sa.String(255)),
-        sa.CheckConstraint("one_row_id", name="kube_resource_version_one_row_id")
+        *columns_and_constraints
     )
+
     op.bulk_insert(table, [
         {"resource_version": ""}
     ])
diff --git a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
index 5c921c6a98aaf..ea1e9ac4bf837 100644
--- a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
+++ b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
@@ -40,12 +40,23 @@
 
 
 def upgrade():
+
+    columns_and_constraints = [
+        sa.Column("one_row_id", sa.Boolean, server_default=sa.true(), primary_key=True),
+        sa.Column("worker_uuid", sa.String(255))
+    ]
+
+    conn = op.get_bind()
+
+    # alembic creates an invalid SQL for mssql dialect
+    if conn.dialect.name not in ('mssql'):
+        columns_and_constraints.append(sa.CheckConstraint("one_row_id", name="kube_worker_one_row_id"))
+
     table = op.create_table(
         RESOURCE_TABLE,
-        sa.Column("one_row_id", sa.Boolean, server_default=sa.true(), primary_key=True),
-        sa.Column("worker_uuid", sa.String(255)),
-        sa.CheckConstraint("one_row_id", name="kube_worker_one_row_id")
+        *columns_and_constraints
     )
+
     op.bulk_insert(table, [
         {"worker_uuid": ""}
     ])

From 4f6698146bfd00fac4180dcd179daa463ddfb54b Mon Sep 17 00:00:00 2001
From: William Pursell <william.r.pursell@gmail.com>
Date: Thu, 20 Sep 2018 13:35:03 -0600
Subject: [PATCH 170/808] [AIRFLOW-3090] Demote dag start/stop log messages to
 debug (#3920)

---
 airflow/utils/dag_processing.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index d30c6aeacb5be..8b77c796d2030 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -487,7 +487,7 @@ def heartbeat(self):
 
         for file_path, processor in self._processors.items():
             if processor.done:
-                self.log.info("Processor for %s finished", file_path)
+                self.log.debug("Processor for %s finished", file_path)
                 now = timezone.utcnow()
                 finished_processors[file_path] = processor
                 self._last_runtime[file_path] = (now -
@@ -560,7 +560,7 @@ def heartbeat(self):
             processor = self._processor_factory(file_path)
 
             processor.start()
-            self.log.info(
+            self.log.debug(
                 "Started a process (PID: %s) to generate tasks for %s",
                 processor.pid, file_path
             )

From d77b43c3236294db25d8a14e79cea157f3969513 Mon Sep 17 00:00:00 2001
From: William Pursell <william.r.pursell@gmail.com>
Date: Fri, 21 Sep 2018 05:34:27 -0700
Subject: [PATCH 171/808] [AIRFLOW-3090] Make No tasks to consider for
 execution debug (#3923)

During normal operation, it is not necessary to see the message.  This
can only be useful when debugging an issue.
---
 airflow/jobs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index d17ab262e6d76..1e5478b9d7955 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1100,7 +1100,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         task_instances_to_examine = ti_query.all()
 
         if len(task_instances_to_examine) == 0:
-            self.log.info("No tasks to consider for execution.")
+            self.log.debug("No tasks to consider for execution.")
             return executable_tis
 
         # Put one task instance on each line

From 7b24b00f0d0d673949352086dabc4b8983d00d6e Mon Sep 17 00:00:00 2001
From: William Pursell <william.r.pursell@gmail.com>
Date: Sat, 22 Sep 2018 06:33:50 -0700
Subject: [PATCH 172/808] [AIRFLOW-3090] Specify path of key file in log
 message (#3921)

---
 airflow/contrib/hooks/gcp_api_base_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 053494743f064..70523ffadcc92 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -87,7 +87,7 @@ def _get_credentials(self):
         elif key_path:
             # Get credentials from a JSON file.
             if key_path.endswith('.json'):
-                self.log.info('Getting connection using a JSON key file.')
+                self.log.debug('Getting connection using JSON key file %s' % key_path)
                 credentials = (
                     google.oauth2.service_account.Credentials.from_service_account_file(
                         key_path, scopes=scopes)

From e8b2feb3da885bfd3571206dcbef550d9d13c938 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 28 Sep 2018 20:43:55 +0800
Subject: [PATCH 173/808] [AIRFLOW-3104] Add .airflowignore info into doc
 (#3939)

.airflowignore is a nice feature, but it was not mentioned at all in the documentation.
---
 airflow/models.py |  8 +++++---
 docs/concepts.rst | 29 +++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index c397e3f5d39bb..de9b06d124623 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -532,10 +532,12 @@ def collect_dags(
         Given a file path or a folder, this method looks for python modules,
         imports them and adds them to the dagbag collection.
 
-        Note that if a .airflowignore file is found while processing,
-        the directory, it will behaves much like a .gitignore does,
+        Note that if a ``.airflowignore`` file is found while processing
+        the directory, it will behave much like a ``.gitignore``,
         ignoring files that match any of the regex patterns specified
-        in the file. **Note**: The patterns in .airflowignore are treated as
+        in the file.
+
+        **Note**: The patterns in .airflowignore are treated as
         un-anchored regexes, not shell-like glob patterns.
         """
         start_dttm = timezone.utcnow()
diff --git a/docs/concepts.rst b/docs/concepts.rst
index d28921134f3d6..f1fd14f5b187b 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -852,3 +852,32 @@ do the same, but then it is more to use a virtualenv and pip.
    to be available on the system if a module needs those. In other words only
    pure python modules can be packaged.
 
+
+.airflowignore
+''''''''''''''
+
+A ``.airflowignore`` file specifies the directories or files in ``DAG_FOLDER``
+that Airflow should intentionally ignore. Each line in ``.airflowignore``
+specifies a regular expression pattern, and directories or files whose names
+(not DAG id) match any of the patterns would be ignored (under the hood,
+``re.findall()`` is used to match the pattern). Overall it works like a
+``.gitignore`` file.
+
+``.airflowignore`` file should be put in your ``DAG_FOLDER``.
+For example, you can prepare a ``.airflowignore`` file with contents
+
+.. code::
+
+    project_a
+    tenant_[\d]
+
+
+Then files like "project_a_dag_1.py", "TESTING_project_a.py", "tenant_1.py",
+"project_a/dag_1.py", and "tenant_1/dag_1.py" in your ``DAG_FOLDER`` would be ignored
+(If a directory's name matches any of the patterns, this directory and all its subfolders
+would not be scanned by Airflow at all. This improves efficiency of DAG finding).
+
+The scope of a ``.airflowignore`` file is the directory it is in plus all its subfolders.
+You can also prepare ``.airflowignore`` file for a subfolder in ``DAG_FOLDER`` and it
+would only be applicable for that subfolder.
+

From 1329b987f82b359e46b0049f06fce109b6fea688 Mon Sep 17 00:00:00 2001
From: Joy Gao <Joygao@apache.org>
Date: Mon, 24 Sep 2018 15:27:29 -0700
Subject: [PATCH 174/808] [AIRFLOW-3109] Bugfix to allow user/op roles to clear
 task intance via UI by default

---
 airflow/www_rbac/security.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index ae21029dd182b..2405aa8f803de 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -105,6 +105,7 @@
     'set_running',
     'set_success',
     'clear',
+    'can_clear',
 ]
 
 op_perms = [

From be28af62c5989cfcaa183a32637daa2bd36a0005 Mon Sep 17 00:00:00 2001
From: Eric Chang <ericchang2017@u.northwestern.edu>
Date: Tue, 25 Sep 2018 09:26:41 -0700
Subject: [PATCH 175/808] [AIRFLOW-3111] Fix instructions in UPDATING.md and
 remove comment (#3944)

artifacts in default_airflow.cfg

- fixed incorrect instructions in UPDATING.md regarding core.log_filename_template and elasticsearch.elasticsearch_log_id_template
- removed comments referencing "additional curly braces" from
default_airflow.cfg since they're irrelevant to the rendered airflow.cfg
---
 UPDATING.md                                  | 2 +-
 airflow/config_templates/default_airflow.cfg | 3 ---
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 27fbc7444d732..6fde229a2038d 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -180,7 +180,7 @@ log_filename_template = {{ ti.dag_id }}/{{ ti.task_id }}/{{ ts }}/{{ try_number
 log_processor_filename_template = {{ filename }}.log
 
 [elasticsearch]
-elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_number}}
+elasticsearch_log_id_template = {dag_id}-{task_id}-{execution_date}-{try_number}
 elasticsearch_end_of_log_mark = end_of_log
 ```
 
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 1a3768ff74603..07a9458073dae 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -62,12 +62,10 @@ fab_logging_level = WARN
 logging_config_class =
 
 # Log format
-# we need to escape the curly braces by adding an additional curly brace
 log_format = [%%(asctime)s] {{%%(filename)s:%%(lineno)d}} %%(levelname)s - %%(message)s
 simple_log_format = %%(asctime)s %%(levelname)s - %%(message)s
 
 # Log filename format
-# we need to escape the curly braces by adding an additional curly brace
 log_filename_template = {{{{ ti.dag_id }}}}/{{{{ ti.task_id }}}}/{{{{ ts }}}}/{{{{ try_number }}}}.log
 log_processor_filename_template = {{{{ filename }}}}.log
 
@@ -556,7 +554,6 @@ hide_sensitive_variable_fields = True
 
 [elasticsearch]
 elasticsearch_host =
-# we need to escape the curly braces by adding an additional curly brace
 elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_number}}
 elasticsearch_end_of_log_mark = end_of_log
 

From 38680e2dde47543d46511e436d7d42b33d908a19 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 28 Sep 2018 16:56:43 +0800
Subject: [PATCH 176/808] [AIRFLOW-3127] Fix out-dated doc for Celery SSL
 (#3967)

Now in `airflow.cfg`, for Celery-SSL, the item names are
"ssl_active", "ssl_key", "ssl_cert", and "ssl_cacert".
(since PR https://github.com/apache/incubator-airflow/pull/2806/files)

But in the documentation
https://airflow.incubator.apache.org/security.html?highlight=celery
or
https://github.com/apache/incubator-airflow/blob/master/docs/security.rst,
it's "CELERY_SSL_ACTIVE", "CELERY_SSL_KEY", "CELERY_SSL_CERT", and
"CELERY_SSL_CACERT", which is out-dated and may confuse readers.
---
 docs/security.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/security.rst b/docs/security.rst
index f8b747eb0f752..b47a58f7418f0 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -344,10 +344,10 @@ certs and keys.
 .. code-block:: bash
 
     [celery]
-    CELERY_SSL_ACTIVE = True
-    CELERY_SSL_KEY = <path to key>
-    CELERY_SSL_CERT = <path to cert>
-    CELERY_SSL_CACERT = <path to cacert>
+    ssl_active = True
+    ssl_key = <path to key>
+    ssl_cert = <path to cert>
+    ssl_cacert = <path to cacert>
 
 Impersonation
 -------------

From 32e9cd8f1d74f4b947a22a1750c7559be804324e Mon Sep 17 00:00:00 2001
From: Vardan Gupta <vardanguptacse@gmail.com>
Date: Thu, 1 Nov 2018 02:10:31 +0530
Subject: [PATCH 177/808] [AIRFLOW-3136] Add retry_number to TaskInstance.key
 to avoid race condition (#3994)

 We were seeing an intermittent issue where executor reports task instance finished while task says it's in queue state, it was due to a race condition between scheduler which was clearing event_buffer in _process_executor_events method in jobs.py executor was about to put next_retry task's status as running which was failed in previous try. So, we thought to add retry_number as the member of TaskInstance key property.
---
 airflow/contrib/executors/kubernetes_executor.py |  7 ++++---
 airflow/executors/base_executor.py               |  2 +-
 airflow/jobs.py                                  |  8 ++++----
 airflow/models.py                                |  2 +-
 tests/executors/test_base_executor.py            |  8 ++++----
 tests/jobs.py                                    | 13 +++++++++----
 6 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 4ea52c42ff604..5b02c4d40923b 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -326,7 +326,7 @@ def run_next(self, next_job):
         """
         self.log.info('Kubernetes job is %s', str(next_job))
         key, command, kube_executor_config = next_job
-        dag_id, task_id, execution_date = key
+        dag_id, task_id, execution_date, try_number = key
         self.log.debug("Kubernetes running for command %s", command)
         self.log.debug("Kubernetes launching image %s", self.kube_config.kube_image)
         pod = self.worker_configuration.make_pod(
@@ -447,7 +447,8 @@ def _labels_to_key(self, labels):
         try:
             return (
                 labels['dag_id'], labels['task_id'],
-                self._label_safe_datestring_to_datetime(labels['execution_date']))
+                self._label_safe_datestring_to_datetime(labels['execution_date']),
+                labels['try_number'])
         except Exception as e:
             self.log.warn(
                 'Error while converting labels to key; labels: %s; exception: %s',
@@ -606,7 +607,7 @@ def _change_state(self, key, state, pod_id):
                 self.log.debug('Could not find key: %s', str(key))
                 pass
         self.event_buffer[key] = state
-        (dag_id, task_id, ex_time) = key
+        (dag_id, task_id, ex_time, try_number) = key
         item = self._session.query(TaskInstance).filter_by(
             dag_id=dag_id,
             task_id=task_id,
diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index 701ac66f8b72d..3522f7c449790 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -175,7 +175,7 @@ def get_event_buffer(self, dag_ids=None):
             self.event_buffer = dict()
         else:
             for key in list(self.event_buffer.keys()):
-                dag_id, _, _ = key
+                dag_id, _, _, _ = key
                 if dag_id in dag_ids:
                     cleared_events[key] = self.event_buffer.pop(key)
 
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 1e5478b9d7955..03610bd983607 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1441,10 +1441,10 @@ def _process_executor_events(self, simple_dag_bag, session=None):
         TI = models.TaskInstance
         for key, state in list(self.executor.get_event_buffer(simple_dag_bag.dag_ids)
                                    .items()):
-            dag_id, task_id, execution_date = key
+            dag_id, task_id, execution_date, try_number = key
             self.log.info(
-                "Executor reports %s.%s execution_date=%s as %s",
-                dag_id, task_id, execution_date, state
+                "Executor reports %s.%s execution_date=%s as %s for try_number %s",
+                dag_id, task_id, execution_date, state, try_number
             )
             if state == State.FAILED or state == State.SUCCESS:
                 qry = session.query(TI).filter(TI.dag_id == dag_id,
@@ -1456,7 +1456,7 @@ def _process_executor_events(self, simple_dag_bag, session=None):
                     continue
 
                 # TODO: should we fail RUNNING as well, as we do in Backfills?
-                if ti.state == State.QUEUED:
+                if ti.try_number == try_number and ti.state == State.QUEUED:
                     msg = ("Executor reports task instance {} finished ({}) "
                            "although the task says its {}. Was the task "
                            "killed externally?".format(ti, state, ti.state))
diff --git a/airflow/models.py b/airflow/models.py
index de9b06d124623..1536b37df906f 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1249,7 +1249,7 @@ def key(self):
         """
         Returns a tuple that identifies the task instance uniquely
         """
-        return self.dag_id, self.task_id, self.execution_date
+        return self.dag_id, self.task_id, self.execution_date, self.try_number
 
     @provide_session
     def set_state(self, state, session=None):
diff --git a/tests/executors/test_base_executor.py b/tests/executors/test_base_executor.py
index f349355d32efa..06a47541e404c 100644
--- a/tests/executors/test_base_executor.py
+++ b/tests/executors/test_base_executor.py
@@ -30,10 +30,10 @@ def test_get_event_buffer(self):
         executor = BaseExecutor()
 
         date = datetime.utcnow()
-
-        key1 = ("my_dag1", "my_task1", date)
-        key2 = ("my_dag2", "my_task1", date)
-        key3 = ("my_dag2", "my_task2", date)
+        try_number = 1
+        key1 = ("my_dag1", "my_task1", date, try_number)
+        key2 = ("my_dag2", "my_task1", date, try_number)
+        key3 = ("my_dag2", "my_task2", date, try_number)
         state = State.SUCCESS
         executor.event_buffer[key1] = state
         executor.event_buffer[key2] = state
diff --git a/tests/jobs.py b/tests/jobs.py
index 5bd3a00451a1b..db2374c13d8c5 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -72,7 +72,7 @@
 
 DEV_NULL = '/dev/null'
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
-
+TRY_NUMBER = 1
 # Include the words "airflow" and "dag" in the file contents,
 # tricking airflow into thinking these
 # files contain a DAG (otherwise Airflow will skip them)
@@ -2329,7 +2329,7 @@ def test_scheduler_process_task_instances(self):
         scheduler._process_task_instances(dag, queue=queue)
 
         queue.append.assert_called_with(
-            (dag.dag_id, dag_task1.task_id, DEFAULT_DATE)
+            (dag.dag_id, dag_task1.task_id, DEFAULT_DATE, TRY_NUMBER)
         )
 
     def test_scheduler_do_not_schedule_removed_task(self):
@@ -2597,7 +2597,7 @@ def test_scheduler_max_active_runs_respected_after_clear(self):
         scheduler._process_task_instances(dag, queue=queue)
 
         queue.append.assert_called_with(
-            (dag.dag_id, dag_task1.task_id, DEFAULT_DATE)
+            (dag.dag_id, dag_task1.task_id, DEFAULT_DATE, TRY_NUMBER)
         )
 
     @patch.object(TI, 'pool_full')
@@ -2950,13 +2950,18 @@ def run_with_error(task):
         do_schedule()
         self.assertTrue(executor.has_task(ti))
         ti.refresh_from_db()
-        self.assertEqual(ti.state, State.SCHEDULED)
+        # removing self.assertEqual(ti.state, State.SCHEDULED)
+        # as scheduler will move state from SCHEDULED to QUEUED
 
         # now the executor has cleared and it should be allowed the re-queue
         executor.queued_tasks.clear()
         do_schedule()
         ti.refresh_from_db()
         self.assertEqual(ti.state, State.QUEUED)
+        # calling below again in order to ensure with try_number 2,
+        # scheduler doesn't put task in queue
+        do_schedule()
+        self.assertEquals(1, len(executor.queued_tasks))
 
     @unittest.skipUnless("INTEGRATION" in os.environ, "Can only run end to end")
     def test_retry_handling_job(self):

From ca33a6e2abdacd6c0b7619a462f307a59ea8be76 Mon Sep 17 00:00:00 2001
From: akshayi1 <akshayi1@users.noreply.github.com>
Date: Fri, 5 Oct 2018 04:47:48 -0400
Subject: [PATCH 178/808] [AIRFLOW-3159] Update GCS logging docs for latest
 code (#3952)

---
 docs/howto/write-logs.rst | 67 ++++++++-------------------------------
 1 file changed, 14 insertions(+), 53 deletions(-)

diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index a29f6069ca089..44fefc64809f3 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -89,54 +89,22 @@ Writing Logs to Google Cloud Storage
 
 Follow the steps below to enable Google Cloud Storage logging.
 
-#. Airflow's logging system requires a custom .py file to be located in the ``PYTHONPATH``, so that it's importable from Airflow. Start by creating a directory to store the config file. ``$AIRFLOW_HOME/config`` is recommended.
-#. Create empty files called ``$AIRFLOW_HOME/config/log_config.py`` and ``$AIRFLOW_HOME/config/__init__.py``.
-#. Copy the contents of ``airflow/config_templates/airflow_local_settings.py`` into the ``log_config.py`` file that was just created in the step above.
-#. Customize the following portions of the template:
-
-    .. code-block:: bash
-
-        # Add this variable to the top of the file. Note the trailing slash.
-        GCS_LOG_FOLDER = 'gs://<bucket where logs should be persisted>/'
-
-        # Rename DEFAULT_LOGGING_CONFIG to LOGGING CONFIG
-        LOGGING_CONFIG = ...
-
-        # Add a GCSTaskHandler to the 'handlers' block of the LOGGING_CONFIG variable
-        'gcs.task': {
-            'class': 'airflow.utils.log.gcs_task_handler.GCSTaskHandler',
-            'formatter': 'airflow.task',
-            'base_log_folder': os.path.expanduser(BASE_LOG_FOLDER),
-            'gcs_log_folder': GCS_LOG_FOLDER,
-            'filename_template': FILENAME_TEMPLATE,
-        },
-
-        # Update the airflow.task and airflow.tas_runner blocks to be 'gcs.task' instead of 'file.task'.
-        'loggers': {
-            'airflow.task': {
-                'handlers': ['gcs.task'],
-                ...
-            },
-            'airflow.task_runner': {
-                'handlers': ['gcs.task'],
-                ...
-            },
-            'airflow': {
-                'handlers': ['console'],
-                ...
-            },
-        }
-
-#. Make sure a Google Cloud Platform connection hook has been defined in Airflow. The hook should have read and write access to the Google Cloud Storage bucket defined above in ``GCS_LOG_FOLDER``.
-
-#. Update ``$AIRFLOW_HOME/airflow.cfg`` to contain:
-
-    .. code-block:: bash
+To enable this feature, ``airflow.cfg`` must be configured as in this
+example:
 
-        task_log_reader = gcs.task
-        logging_config_class = log_config.LOGGING_CONFIG
-        remote_log_conn_id = <name of the Google cloud platform hook>
+.. code-block:: bash
 
+    [core]
+    # Airflow can store logs remotely in AWS S3, Google Cloud Storage or Elastic Search.
+    # Users must supply an Airflow connection id that provides access to the storage
+    # location. If remote_logging is set to true, see UPDATING.md for additional
+    # configuration requirements.
+    remote_logging = True
+    remote_base_log_folder = gs://my-bucket/path/to/logs
+    remote_log_conn_id = MyGCSConn
+
+#. Install the ``gcp_api`` package first, like so: ``pip install apache-airflow[gcp_api]``.
+#. Make sure a Google Cloud Platform connection hook has been defined in Airflow. The hook should have read and write access to the Google Cloud Storage bucket defined above in ``remote_base_log_folder``.
 #. Restart the Airflow webserver and scheduler, and trigger (or wait for) a new task execution.
 #. Verify that logs are showing up for newly executed tasks in the bucket you've defined.
 #. Verify that the Google Cloud Storage viewer is working in the UI. Pull up a newly executed task, and verify that you see something like:
@@ -150,10 +118,3 @@ Follow the steps below to enable Google Cloud Storage logging.
         [2017-10-03 21:57:51,306] {base_task_runner.py:98} INFO - Subtask: [2017-10-03 21:57:51,306] {models.py:186} INFO - Filling up the DagBag from /airflow/dags/example_dags/example_bash_operator.py
 
 Note the top line that says it's reading from the remote log file.
-
-Please be aware that if you were persisting logs to Google Cloud Storage
-using the old-style airflow.cfg configuration method, the old logs will no
-longer be visible in the Airflow UI, though they'll still exist in Google
-Cloud Storage. This is a backwards incompatbile change. If you are unhappy
-with it, you can change the ``FILENAME_TEMPLATE`` to reflect the old-style
-log filename format.

From dd68a28e8b904017738d7fe5f667655e500a39dd Mon Sep 17 00:00:00 2001
From: PaulVelthuis93 <paulvelthuis93@gmail.com>
Date: Fri, 12 Oct 2018 14:13:58 +0200
Subject: [PATCH 179/808] [AIRFLOW-3187] Update airflow.gif file with a slower
 version (#4033)

---
 docs/img/airflow.gif | Bin 622963 -> 622832 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/docs/img/airflow.gif b/docs/img/airflow.gif
index 1889b868f708aaaa9a29a3ef2613c8436b8de384..7646e37f35ed5fbe0ad3f65d612ff3aa1a1e531f 100644
GIT binary patch
delta 580462
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%0D4-&*g%3WuBU!VV*B@WT@K+VI4+RxEJEl=R@+
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%0DL<PgLD=jT9r>-Rl
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
EJJG_;$^ZZW

delta 580724
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%0DI&-
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
OG*wk~Rox>X002AC0QV;V


From 7e03a36f072475b29526234b634001e47352ac3a Mon Sep 17 00:00:00 2001
From: Guoqiang Ding <dgq8211@gmail.com>
Date: Tue, 6 Nov 2018 03:21:20 +0800
Subject: [PATCH 180/808] [AIRFLOW-3193] Pin docker requirement version (#4130)

Since the change of AIRFLOW-3203, the dockerpy client has upgraded
actually. Therefore, the requirements config should upgrade also to
avoid potentially misleading.
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 0abe23c6823fe..c187b9b7ff51a 100644
--- a/setup.py
+++ b/setup.py
@@ -157,7 +157,7 @@ def write_version(filename=os.path.join(*['airflow',
     'sphinx-rtd-theme>=0.1.6',
     'Sphinx-PyPI-upload>=0.2.1'
 ]
-docker = ['docker>=2.0.0']
+docker = ['docker>=3.0.0']
 druid = ['pydruid>=0.4.1']
 elasticsearch = [
     'elasticsearch>=5.0.0,<6.0.0',

From 412985dc6f7f5af4440dc91dbef1770603a0071a Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 8 Nov 2018 14:34:41 +0000
Subject: [PATCH 181/808] [AIRFLOW-2799] Fix filtering UI objects by datetime
 (#4061)

Our conversion to Timezone-aware date times in 1.10 missed this case -
any filter on a date time would blow up with `naive datetime is
disallowed` - this makes our datetime filters timezone aware now (they
respect the default_timezone, and they accept timezones in input even
though the UI won't let you craft those.)

I manually tested this by changing query parameters - a value of
`2018-10-30+01%3A05%3A00%2B01:00` matched against an execution date of
00:05:00+00:00
---
 airflow/utils/timezone.py    |  4 +-
 airflow/www/utils.py         | 42 +++++++++++++++++++--
 airflow/www_rbac/utils.py    | 71 +++++++++++++++++++++++++++++++++++-
 airflow/www_rbac/views.py    | 24 +-----------
 tests/www/test_views.py      | 18 +++++++++
 tests/www_rbac/test_views.py | 13 +++++++
 6 files changed, 143 insertions(+), 29 deletions(-)

diff --git a/airflow/utils/timezone.py b/airflow/utils/timezone.py
index 6d49fbcbb3e85..5adaa2f5c4a5a 100644
--- a/airflow/utils/timezone.py
+++ b/airflow/utils/timezone.py
@@ -164,9 +164,9 @@ def datetime(*args, **kwargs):
     return dt.datetime(*args, **kwargs)
 
 
-def parse(string):
+def parse(string, timezone=None):
     """
     Parse a time string and return an aware datetime
     :param string: time string
     """
-    return pendulum.parse(string, tz=TIMEZONE)
+    return pendulum.parse(string, tz=timezone or TIMEZONE)
diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 1566faa91ac1e..3f869e625180f 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -33,8 +33,8 @@
 import zipfile
 
 from flask import after_this_request, request, Response
-from flask_admin.contrib.sqla.filters import FilterConverter
 from flask_admin.model import filters
+import flask_admin.contrib.sqla.filters as sqlafilters
 from flask_login import current_user
 import wtforms
 from wtforms.compat import text_type
@@ -419,7 +419,43 @@ def __call__(self, field, **kwargs):
         return wtforms.widgets.core.HTMLString(html)
 
 
-class UtcFilterConverter(FilterConverter):
+class UtcDateTimeFilterMixin(object):
+    def clean(self, value):
+        dt = super(UtcDateTimeFilterMixin, self).clean(value)
+        return timezone.make_aware(dt, timezone=timezone.utc)
+
+
+class UtcDateTimeEqualFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeEqualFilter):
+    pass
+
+
+class UtcDateTimeNotEqualFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeNotEqualFilter):
+    pass
+
+
+class UtcDateTimeGreaterFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeGreaterFilter):
+    pass
+
+
+class UtcDateTimeSmallerFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeSmallerFilter):
+    pass
+
+
+class UtcDateTimeBetweenFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeBetweenFilter):
+    pass
+
+
+class UtcDateTimeNotBetweenFilter(UtcDateTimeFilterMixin, sqlafilters.DateTimeNotBetweenFilter):
+    pass
+
+
+class UtcFilterConverter(sqlafilters.FilterConverter):
+
+    utcdatetime_filters = (UtcDateTimeEqualFilter, UtcDateTimeNotEqualFilter,
+                           UtcDateTimeGreaterFilter, UtcDateTimeSmallerFilter,
+                           UtcDateTimeBetweenFilter, UtcDateTimeNotBetweenFilter,
+                           sqlafilters.FilterEmpty)
+
     @filters.convert('utcdatetime')
     def conv_utcdatetime(self, column, name, **kwargs):
-        return self.conv_datetime(column, name, **kwargs)
+        return [f(column, name, **kwargs) for f in self.utcdatetime_filters]
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index 0176a5312c373..b25e1541abd85 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -37,7 +37,10 @@
 from pygments import highlight, lexers
 from pygments.formatters import HtmlFormatter
 from flask import request, Response, Markup, url_for
-from airflow import configuration
+from flask_appbuilder.models.sqla.interface import SQLAInterface
+import flask_appbuilder.models.sqla.filters as fab_sqlafilters
+import sqlalchemy as sqla
+from airflow import configuration, settings
 from airflow.models import BaseOperator
 from airflow.operators.subdag_operator import SubDagOperator
 from airflow.utils import timezone
@@ -378,3 +381,69 @@ def get_chart_height(dag):
     charts, that is charts that take up space based on the size of the components within.
     """
     return 600 + len(dag.tasks) * 10
+
+
+class UtcAwareFilterMixin(object):
+    def apply(self, query, value):
+        value = timezone.parse(value, timezone=timezone.utc)
+
+        return super(UtcAwareFilterMixin, self).apply(query, value)
+
+
+class UtcAwareFilterEqual(UtcAwareFilterMixin, fab_sqlafilters.FilterEqual):
+    pass
+
+
+class UtcAwareFilterGreater(UtcAwareFilterMixin, fab_sqlafilters.FilterGreater):
+    pass
+
+
+class UtcAwareFilterSmaller(UtcAwareFilterMixin, fab_sqlafilters.FilterSmaller):
+    pass
+
+
+class UtcAwareFilterNotEqual(UtcAwareFilterMixin, fab_sqlafilters.FilterNotEqual):
+    pass
+
+
+class UtcAwareFilterConverter(fab_sqlafilters.SQLAFilterConverter):
+
+    conversion_table = (
+        (('is_utcdatetime', [UtcAwareFilterEqual,
+                             UtcAwareFilterGreater,
+                             UtcAwareFilterSmaller,
+                             UtcAwareFilterNotEqual]),) +
+        fab_sqlafilters.SQLAFilterConverter.conversion_table
+    )
+
+
+class CustomSQLAInterface(SQLAInterface):
+    """
+    FAB does not know how to handle columns with leading underscores because
+    they are not supported by WTForm. This hack will remove the leading
+    '_' from the key to lookup the column names.
+
+    """
+    def __init__(self, obj):
+        super(CustomSQLAInterface, self).__init__(obj)
+
+        self.session = settings.Session()
+
+        def clean_column_names():
+            if self.list_properties:
+                self.list_properties = dict(
+                    (k.lstrip('_'), v) for k, v in self.list_properties.items())
+            if self.list_columns:
+                self.list_columns = dict(
+                    (k.lstrip('_'), v) for k, v in self.list_columns.items())
+
+        clean_column_names()
+
+    def is_utcdatetime(self, col_name):
+        from airflow.utils.sqlalchemy import UtcDateTime
+        obj = self.list_columns[col_name].type
+        return isinstance(obj, UtcDateTime) or \
+            isinstance(obj, sqla.types.TypeDecorator) and \
+            isinstance(obj.impl, UtcDateTime)
+
+    filter_converter_class = UtcAwareFilterConverter
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 50f30649039bf..51af6c0e2a415 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -42,9 +42,7 @@
 from flask._compat import PY2
 
 from flask_appbuilder import BaseView, ModelView, expose, has_access
-from flask_appbuilder.models.sqla.interface import SQLAInterface
 from flask_appbuilder.actions import action
-
 from flask_babel import lazy_gettext
 
 from wtforms import Form, SelectField, validators
@@ -1645,27 +1643,7 @@ class AirflowModelView(ModelView):
     list_widget = AirflowModelListWidget
     page_size = PAGE_SIZE
 
-    class CustomSQLAInterface(SQLAInterface):
-        """
-        FAB does not know how to handle columns with leading underscores because
-        they are not supported by WTForm. This hack will remove the leading
-        '_' from the key to lookup the column names.
-
-        """
-        def __init__(self, obj):
-            super(AirflowModelView.CustomSQLAInterface, self).__init__(obj)
-
-            self.session = settings.Session()
-
-            def clean_column_names():
-                if self.list_properties:
-                    self.list_properties = dict(
-                        (k.lstrip('_'), v) for k, v in self.list_properties.items())
-                if self.list_columns:
-                    self.list_columns = dict(
-                        (k.lstrip('_'), v) for k, v in self.list_columns.items())
-
-            clean_column_names()
+    CustomSQLAInterface = wwwutils.CustomSQLAInterface
 
 
 class SlaMissModelView(AirflowModelView):
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index bb183d4a649b7..4075f91d537a6 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -772,5 +772,23 @@ def test_dt_nr_dr_form_with_base_date_and_num_runs_and_execution_date_within(sel
         self.tester.test_with_base_date_and_num_runs_and_execution_date_within()
 
 
+class TestTaskInstanceView(unittest.TestCase):
+    TI_ENDPOINT = '/admin/taskinstance/?flt2_execution_date_greater_than={}'
+
+    def setUp(self):
+        super(TestTaskInstanceView, self).setUp()
+        configuration.load_test_config()
+        app = application.create_app(testing=True)
+        app.config['WTF_CSRF_METHODS'] = []
+        self.app = app.test_client()
+
+    def test_start_date_filter(self):
+        resp = self.app.get(self.TI_ENDPOINT.format('2018-10-09+22:44:31'))
+        # We aren't checking the logic of the date filter itself (that is built
+        # in to flask-admin) but simply that our UTC conversion was run - i.e. it
+        # doesn't blow up!
+        self.assertEqual(resp.status_code, 200)
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 6f37f44e54614..d7f099d6be23b 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -773,5 +773,18 @@ def test_dt_nr_dr_form_with_base_date_and_num_runs_and_execution_date_within(sel
         self.tester.test_with_base_date_and_num_runs_and_execution_date_within()
 
 
+class TestTaskInstanceView(TestBase):
+    TI_ENDPOINT = '/taskinstance/list/?_flt_0_execution_date={}'
+
+    def test_start_date_filter(self):
+        resp = self.client.get(self.TI_ENDPOINT.format(
+            self.percent_encode('2018-10-09 22:44:31')))
+        # We aren't checking the logic of the date filter itself (that is built
+        # in to FAB) but simply that our UTC conversion was run - i.e. it
+        # doesn't blow up!
+        self.check_content_in_response('List Task Instance', resp)
+        pass
+
+
 if __name__ == '__main__':
     unittest.main()

From 7e1cd4212c91bd3cc82dc7b7620e7ffc6eaad197 Mon Sep 17 00:00:00 2001
From: yangaws <31293788+yangaws@users.noreply.github.com>
Date: Thu, 8 Nov 2018 13:59:38 -0800
Subject: [PATCH 182/808] [AIRFLOW-2524] More AWS SageMaker operators, sensors
 for model, endpoint-config and endpoint (#4126)

---
 airflow/contrib/hooks/aws_hook.py             |   6 +-
 .../operators/sagemaker_base_operator.py      |   2 +-
 .../sagemaker_endpoint_config_operator.py     |  67 ++++++++
 .../operators/sagemaker_endpoint_operator.py  | 151 ++++++++++++++++++
 .../operators/sagemaker_model_operator.py     |  68 ++++++++
 .../operators/sagemaker_training_operator.py  |  20 +--
 .../operators/sagemaker_transform_operator.py |  41 +++--
 .../operators/sagemaker_tuning_operator.py    |  24 +--
 .../sensors/sagemaker_endpoint_sensor.py      |  61 +++++++
 airflow/hooks/S3_hook.py                      |  18 +--
 docs/code.rst                                 |   6 +-
 ...test_sagemaker_endpoint_config_operator.py |  92 +++++++++++
 .../test_sagemaker_endpoint_operator.py       | 126 +++++++++++++++
 .../test_sagemaker_model_operator.py          |  83 ++++++++++
 .../sensors/test_sagemaker_endpoint_sensor.py | 110 +++++++++++++
 .../sensors/test_sagemaker_training_sensor.py |   2 +-
 .../test_sagemaker_transform_sensor.py        |   2 +-
 .../sensors/test_sagemaker_tuning_sensor.py   |   2 +-
 18 files changed, 830 insertions(+), 51 deletions(-)
 create mode 100644 airflow/contrib/operators/sagemaker_endpoint_config_operator.py
 create mode 100644 airflow/contrib/operators/sagemaker_endpoint_operator.py
 create mode 100644 airflow/contrib/operators/sagemaker_model_operator.py
 create mode 100644 airflow/contrib/sensors/sagemaker_endpoint_sensor.py
 create mode 100644 tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
 create mode 100644 tests/contrib/operators/test_sagemaker_endpoint_operator.py
 create mode 100644 tests/contrib/operators/test_sagemaker_model_operator.py
 create mode 100644 tests/contrib/sensors/test_sagemaker_endpoint_sensor.py

diff --git a/airflow/contrib/hooks/aws_hook.py b/airflow/contrib/hooks/aws_hook.py
index 44f33d49ab9e4..5716eb3c0305e 100644
--- a/airflow/contrib/hooks/aws_hook.py
+++ b/airflow/contrib/hooks/aws_hook.py
@@ -182,7 +182,7 @@ def get_session(self, region_name=None):
     def get_credentials(self, region_name=None):
         """Get the underlying `botocore.Credentials` object.
 
-        This contains the attributes: access_key, secret_key and token.
+        This contains the following authentication attributes: access_key, secret_key and token.
         """
         session, _ = self._get_credentials(region_name)
         # Credentials are refreshable, so accessing your access key and
@@ -192,8 +192,8 @@ def get_credentials(self, region_name=None):
 
     def expand_role(self, role):
         """
-        Expand an IAM role name to an IAM role ARN. If role is already an IAM ARN,
-        no change is made.
+        If the IAM role is a role name, get the Amazon Resource Name (ARN) for the role.
+        If IAM role is already an IAM role ARN, no change is made.
 
         :param role: IAM role name or ARN
         :return: IAM role ARN
diff --git a/airflow/contrib/operators/sagemaker_base_operator.py b/airflow/contrib/operators/sagemaker_base_operator.py
index cf1e59387a784..08d6d0eb6a83c 100644
--- a/airflow/contrib/operators/sagemaker_base_operator.py
+++ b/airflow/contrib/operators/sagemaker_base_operator.py
@@ -79,7 +79,7 @@ def parse_config_integers(self):
             self.parse_integer(self.config, field)
 
     def expand_role(self):
-        raise NotImplementedError('Please implement expand_role() in sub class!')
+        pass
 
     def preprocess_config(self):
         self.log.info(
diff --git a/airflow/contrib/operators/sagemaker_endpoint_config_operator.py b/airflow/contrib/operators/sagemaker_endpoint_config_operator.py
new file mode 100644
index 0000000000000..a94cf3022904b
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_endpoint_config_operator.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerEndpointConfigOperator(SageMakerBaseOperator):
+
+    """
+    Create a SageMaker endpoint config.
+
+    This operator returns The ARN of the endpoint config created in Amazon SageMaker
+
+    :param config: The configuration necessary to create an endpoint config.
+
+        For details of the configuration parameter, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint_config
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    """  # noqa: E501
+
+    integer_fields = [
+        ['ProductionVariants', 'InitialInstanceCount']
+    ]
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 *args, **kwargs):
+        super(SageMakerEndpointConfigOperator, self).__init__(config=config,
+                                                              *args, **kwargs)
+
+        self.config = config
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        self.log.info('Creating SageMaker Endpoint Config %s.', self.config['EndpointConfigName'])
+        response = self.hook.create_endpoint_config(self.config)
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException(
+                'Sagemaker endpoint config creation failed: %s' % response)
+        else:
+            return {
+                'EndpointConfig': self.hook.describe_endpoint_config(
+                    self.config['EndpointConfigName']
+                )
+            }
diff --git a/airflow/contrib/operators/sagemaker_endpoint_operator.py b/airflow/contrib/operators/sagemaker_endpoint_operator.py
new file mode 100644
index 0000000000000..4094fbe59e2b8
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_endpoint_operator.py
@@ -0,0 +1,151 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerEndpointOperator(SageMakerBaseOperator):
+
+    """
+    Create a SageMaker endpoint.
+
+    This operator returns The ARN of the endpoint created in Amazon SageMaker
+
+    :param config:
+        The configuration necessary to create an endpoint.
+
+        If you need to create a SageMaker endpoint based on an existed SageMaker model and an existed SageMaker
+        endpoint config,
+
+            config = endpoint_configuration;
+
+        If you need to create all of SageMaker model, SageMaker endpoint-config and SageMaker endpoint,
+
+            config = {
+                'Model': model_configuration,
+
+                'EndpointConfig': endpoint_config_configuration,
+
+                'Endpoint': endpoint_configuration
+            }
+
+        For details of the configuration parameter of model_configuration, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+
+        For details of the configuration parameter of endpoint_config_configuration, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint_config
+
+        For details of the configuration parameter of endpoint_configuration, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    :param wait_for_completion: Whether the operator should wait until the endpoint creation finishes.
+    :type wait_for_completion: bool
+    :param check_interval: If wait is set to True, this is the time interval, in seconds, that this operation waits
+        before polling the status of the endpoint creation.
+    :type check_interval: int
+    :param max_ingestion_time: If wait is set to True, this operation fails if the endpoint creation doesn't finish
+        within max_ingestion_time seconds. If you set this parameter to None it never times out.
+    :type max_ingestion_time: int
+    :param operation: Whether to create an endpoint or update an endpoint. Must be either 'create or 'update'.
+    :type operation: str
+    """  # noqa: E501
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 wait_for_completion=True,
+                 check_interval=30,
+                 max_ingestion_time=None,
+                 operation='create',
+                 *args, **kwargs):
+        super(SageMakerEndpointOperator, self).__init__(config=config,
+                                                        *args, **kwargs)
+
+        self.config = config
+        self.wait_for_completion = wait_for_completion
+        self.check_interval = check_interval
+        self.max_ingestion_time = max_ingestion_time
+        self.operation = operation.lower()
+        if self.operation not in ['create', 'update']:
+            raise ValueError('Invalid value! Argument operation has to be one of "create" and "update"')
+        self.create_integer_fields()
+
+    def create_integer_fields(self):
+        if 'EndpointConfig' in self.config:
+            self.integer_fields = [
+                ['EndpointConfig', 'ProductionVariants', 'InitialInstanceCount']
+            ]
+
+    def expand_role(self):
+        if 'Model' not in self.config:
+            return
+        hook = AwsHook(self.aws_conn_id)
+        config = self.config['Model']
+        if 'ExecutionRoleArn' in config:
+            config['ExecutionRoleArn'] = hook.expand_role(config['ExecutionRoleArn'])
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        model_info = self.config.get('Model')
+        endpoint_config_info = self.config.get('EndpointConfig')
+        endpoint_info = self.config.get('Endpoint', self.config)
+
+        if model_info:
+            self.log.info('Creating SageMaker model %s.', model_info['ModelName'])
+            self.hook.create_model(model_info)
+
+        if endpoint_config_info:
+            self.log.info('Creating endpoint config %s.', endpoint_config_info['EndpointConfigName'])
+            self.hook.create_endpoint_config(endpoint_config_info)
+
+        if self.operation == 'create':
+            sagemaker_operation = self.hook.create_endpoint
+            log_str = 'Creating'
+        elif self.operation == 'update':
+            sagemaker_operation = self.hook.update_endpoint
+            log_str = 'Updating'
+        else:
+            raise ValueError('Invalid value! Argument operation has to be one of "create" and "update"')
+
+        self.log.info('{} SageMaker endpoint {}.'.format(log_str, endpoint_info['EndpointName']))
+
+        response = sagemaker_operation(
+            endpoint_info,
+            wait_for_completion=self.wait_for_completion,
+            check_interval=self.check_interval,
+            max_ingestion_time=self.max_ingestion_time
+        )
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException(
+                'Sagemaker endpoint creation failed: %s' % response)
+        else:
+            return {
+                'EndpointConfig': self.hook.describe_endpoint_config(
+                    endpoint_info['EndpointConfigName']
+                ),
+                'Endpoint': self.hook.describe_endpoint(
+                    endpoint_info['EndpointName']
+                )
+            }
diff --git a/airflow/contrib/operators/sagemaker_model_operator.py b/airflow/contrib/operators/sagemaker_model_operator.py
new file mode 100644
index 0000000000000..4332daa9db341
--- /dev/null
+++ b/airflow/contrib/operators/sagemaker_model_operator.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.exceptions import AirflowException
+
+
+class SageMakerModelOperator(SageMakerBaseOperator):
+
+    """
+    Create a SageMaker model.
+
+    This operator returns The ARN of the model created in Amazon SageMaker
+
+    :param config: The configuration necessary to create a model.
+
+        For details of the configuration parameter, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+    :type config: dict
+    :param aws_conn_id: The AWS connection ID to use.
+    :type aws_conn_id: str
+    """  # noqa: E501
+
+    @apply_defaults
+    def __init__(self,
+                 config,
+                 *args, **kwargs):
+        super(SageMakerModelOperator, self).__init__(config=config,
+                                                     *args, **kwargs)
+
+        self.config = config
+
+    def expand_role(self):
+        if 'ExecutionRoleArn' in self.config:
+            hook = AwsHook(self.aws_conn_id)
+            self.config['ExecutionRoleArn'] = hook.expand_role(self.config['ExecutionRoleArn'])
+
+    def execute(self, context):
+        self.preprocess_config()
+
+        self.log.info('Creating SageMaker Model %s.', self.config['ModelName'])
+        response = self.hook.create_model(self.config)
+        if response['ResponseMetadata']['HTTPStatusCode'] != 200:
+            raise AirflowException('Sagemaker model creation failed: %s' % response)
+        else:
+            return {
+                'Model': self.hook.describe_model(
+                    self.config['ModelName']
+                )
+            }
diff --git a/airflow/contrib/operators/sagemaker_training_operator.py b/airflow/contrib/operators/sagemaker_training_operator.py
index 69036925f34f7..d90f7e6555697 100644
--- a/airflow/contrib/operators/sagemaker_training_operator.py
+++ b/airflow/contrib/operators/sagemaker_training_operator.py
@@ -29,23 +29,26 @@ class SageMakerTrainingOperator(SageMakerBaseOperator):
 
     This operator returns The ARN of the training job created in Amazon SageMaker.
 
-    :param config: The configuration necessary to start a training job (templated)
+    :param config: The configuration necessary to start a training job (templated).
+
+        For details of the configuration parameter, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_training_job
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
-    :param wait_for_completion: if the operator should block until training job finishes
+    :param wait_for_completion: If wait is set to True, the time interval, in seconds,
+        that the operation waits to check the status of the training job.
     :type wait_for_completion: bool
     :param print_log: if the operator should print the cloudwatch log during training
     :type print_log: bool
     :param check_interval: if wait is set to be true, this is the time interval
         in seconds which the operator will check the status of the training job
     :type check_interval: int
-    :param max_ingestion_time: if wait is set to be true, the operator will fail
-        if the training job hasn't finish within the max_ingestion_time in seconds
-        (Caution: be careful to set this parameters because training can take very long)
-        Setting it to None implies no timeout.
+    :param max_ingestion_time: If wait is set to True, the operation fails if the training job
+        doesn't finish within max_ingestion_time seconds. If you set this parameter to None,
+        the operation does not timeout.
     :type max_ingestion_time: int
-    """
+    """  # noqa: E501
 
     integer_fields = [
         ['ResourceConfig', 'InstanceCount'],
@@ -87,8 +90,7 @@ def execute(self, context):
             max_ingestion_time=self.max_ingestion_time
         )
         if response['ResponseMetadata']['HTTPStatusCode'] != 200:
-            raise AirflowException(
-                'Sagemaker Training Job creation failed: %s' % response)
+            raise AirflowException('Sagemaker Training Job creation failed: %s' % response)
         else:
             return {
                 'Training': self.hook.describe_training_job(
diff --git a/airflow/contrib/operators/sagemaker_transform_operator.py b/airflow/contrib/operators/sagemaker_transform_operator.py
index 7be570cdacd6f..9d1c665f9eea5 100644
--- a/airflow/contrib/operators/sagemaker_transform_operator.py
+++ b/airflow/contrib/operators/sagemaker_transform_operator.py
@@ -29,26 +29,39 @@ class SageMakerTransformOperator(SageMakerBaseOperator):
 
     This operator returns The ARN of the model created in Amazon SageMaker.
 
-    :param config: The configuration necessary to start a transform job (templated)
+    :param config: The configuration necessary to start a transform job (templated).
+
+        If you need to create a SageMaker transform job based on an existed SageMaker model,
+
+            config = transform_config;
+
+        If you need to create both SageMaker model and SageMaker Transform job,
+
+            config = {
+                'Model': model_config,
+
+                'Transform': transform_config
+            }
+
+        For details of the configuration parameter of transform_config, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_transform_job
+
+        For details of the configuration parameter of model_config, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+
     :type config: dict
-    :param model_config:
-        The configuration necessary to create a SageMaker model, the default is none
-        which means the SageMaker model used for the SageMaker transform job already exists.
-        If given, it will be used to create a SageMaker model before creating
-        the SageMaker transform job
-    :type model_config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: string
-    :param wait_for_completion: if the program should keep running until job finishes
+    :param wait_for_completion: Set to True to wait until the transform job finishes.
     :type wait_for_completion: bool
-    :param check_interval: if wait is set to be true, this is the time interval
-        in seconds which the operator will check the status of the transform job
+    :param check_interval: If wait is set to True, the time interval, in seconds,
+        that this operation waits to check the status of the transform job.
     :type check_interval: int
-    :param max_ingestion_time: if wait is set to be true, the operator will fail
-        if the transform job hasn't finish within the max_ingestion_time in seconds
-        (Caution: be careful to set this parameters because transform can take very long)
+    :param max_ingestion_time: If wait is set to True, the operation fails
+        if the transform job doesn't finish within max_ingestion_time seconds. If you
+        set this parameter to None, the operation does not timeout.
     :type max_ingestion_time: int
-    """
+    """  # noqa: E501
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/operators/sagemaker_tuning_operator.py b/airflow/contrib/operators/sagemaker_tuning_operator.py
index 94c995072a8da..dc1282b5b8273 100644
--- a/airflow/contrib/operators/sagemaker_tuning_operator.py
+++ b/airflow/contrib/operators/sagemaker_tuning_operator.py
@@ -25,24 +25,27 @@
 
 class SageMakerTuningOperator(SageMakerBaseOperator):
     """
-    Initiate a SageMaker hyper-parameter tuning job.
+    Initiate a SageMaker hyperparameter tuning job.
 
     This operator returns The ARN of the tuning job created in Amazon SageMaker.
 
-    :param config: The configuration necessary to start a tuning job (templated)
+    :param config: The configuration necessary to start a tuning job (templated).
+
+        For details of the configuration parameter, See:
+        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_hyper_parameter_tuning_job
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
-    :param wait_for_completion: if the operator should block until tuning job finishes
+    :param wait_for_completion: Set to True to wait until the tuning job finishes.
     :type wait_for_completion: bool
-    :param check_interval: if wait is set to be true, this is the time interval
-        in seconds which the operator will check the status of the tuning job
+    :param check_interval: If wait is set to True, the time interval, in seconds,
+        that this operation waits to check the status of the tuning job.
     :type check_interval: int
-    :param max_ingestion_time: if wait is set to be true, the operator will fail
-        if the tuning job hasn't finish within the max_ingestion_time in seconds
-        (Caution: be careful to set this parameters because tuning can take very long)
+    :param max_ingestion_time: If wait is set to True, the operation fails
+        if the tuning job doesn't finish within max_ingestion_time seconds. If you
+        set this parameter to None, the operation does not timeout.
     :type max_ingestion_time: int
-    """
+    """  # noqa: E501
 
     integer_fields = [
         ['HyperParameterTuningJobConfig', 'ResourceLimits', 'MaxNumberOfTrainingJobs'],
@@ -87,8 +90,7 @@ def execute(self, context):
             max_ingestion_time=self.max_ingestion_time
         )
         if response['ResponseMetadata']['HTTPStatusCode'] != 200:
-            raise AirflowException(
-                'Sagemaker Tuning Job creation failed: %s' % response)
+            raise AirflowException('Sagemaker Tuning Job creation failed: %s' % response)
         else:
             return {
                 'Tuning': self.hook.describe_tuning_job(
diff --git a/airflow/contrib/sensors/sagemaker_endpoint_sensor.py b/airflow/contrib/sensors/sagemaker_endpoint_sensor.py
new file mode 100644
index 0000000000000..ceed9c10097d9
--- /dev/null
+++ b/airflow/contrib/sensors/sagemaker_endpoint_sensor.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.sensors.sagemaker_base_sensor import SageMakerBaseSensor
+from airflow.utils.decorators import apply_defaults
+
+
+class SageMakerEndpointSensor(SageMakerBaseSensor):
+    """
+    Asks for the state of the endpoint state until it reaches a terminal state.
+    If it fails the sensor errors, the task fails.
+
+    :param job_name: job_name of the endpoint instance to check the state of
+    :type job_name: str
+    """
+
+    template_fields = ['endpoint_name']
+    template_ext = ()
+
+    @apply_defaults
+    def __init__(self,
+                 endpoint_name,
+                 *args,
+                 **kwargs):
+        super(SageMakerEndpointSensor, self).__init__(*args, **kwargs)
+        self.endpoint_name = endpoint_name
+
+    def non_terminal_states(self):
+        return SageMakerHook.endpoint_non_terminal_states
+
+    def failed_states(self):
+        return SageMakerHook.failed_states
+
+    def get_sagemaker_response(self):
+        sagemaker = SageMakerHook(aws_conn_id=self.aws_conn_id)
+
+        self.log.info('Poking Sagemaker Endpoint %s', self.endpoint_name)
+        return sagemaker.describe_endpoint(self.endpoint_name)
+
+    def get_failed_reason_from_response(self, response):
+        return response['FailureReason']
+
+    def state_from_response(self, response):
+        return response['EndpointStatus']
diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index a64c331cdd09e..ff3b98b6a91da 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -69,11 +69,11 @@ def get_bucket(self, bucket_name):
 
     def create_bucket(self, bucket_name, region_name=None):
         """
-        Creates a boto3.S3.Bucket object
+        Creates an Amazon S3 bucket.
 
-        :param bucket_name: the name of the bucket
+        :param bucket_name: The name of the bucket
         :type bucket_name: str
-        :param region__name: the name of the aws region
+        :param region_name: The name of the aws region in which to create the bucket.
         :type region_name: str
         """
         s3_conn = self.get_conn()
@@ -405,19 +405,19 @@ def load_file_obj(self,
                       replace=False,
                       encrypt=False):
         """
-        Loads file object to S3
+        Loads a file object to S3
 
-        :param file_obj: file-like object to set as content for the key.
+        :param file_obj: The file-like object to set as the content for the S3 key.
         :type file_obj: file-like object
         :param key: S3 key that will point to the file
         :type key: str
         :param bucket_name: Name of the bucket in which to store the file
         :type bucket_name: str
-        :param replace: A flag to decide whether or not to overwrite the key
-            if it already exists
+        :param replace: A flag that indicates whether to overwrite the key
+            if it already exists.
         :type replace: bool
-        :param encrypt: If True, the file will be encrypted on the server-side
-            by S3 and will be stored in an encrypted form while at rest in S3.
+        :param encrypt: If True, S3 encrypts the file on the server,
+            and the file is stored in encrypted form at rest in S3.
         :type encrypt: bool
         """
         if not bucket_name:
diff --git a/docs/code.rst b/docs/code.rst
index d577b768eb79c..ca6ca593ca345 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -183,9 +183,12 @@ Operators
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SagemakerTuningOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
 .. autoclass:: airflow.contrib.operators.segment_track_event_operator.SegmentTrackEventOperator
 .. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
 .. autoclass:: airflow.contrib.operators.slack_webhook_operator.SlackWebhookOperator
@@ -223,6 +226,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleSensor
 .. autoclass:: airflow.contrib.sensors.redis_key_sensor.RedisKeySensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_base_sensor.SageMakerBaseSensor
+.. autoclass:: airflow.contrib.sensors.sagemaker_endpoint_sensor.SageMakerEndpointSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_training_sensor.SageMakerTrainingSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_transform_sensor.SageMakerTransformSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_tuning_sensor.SageMakerTuningSensor
diff --git a/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py b/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
new file mode 100644
index 0000000000000..658fd813df73e
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_endpoint_config_operator \
+    import SageMakerEndpointConfigOperator
+from airflow.exceptions import AirflowException
+
+model_name = 'test-model-name'
+config_name = 'test-config-name'
+
+create_endpoint_config_params = {
+    'EndpointConfigName': config_name,
+    'ProductionVariants': [
+        {
+            'VariantName': 'AllTraffic',
+            'ModelName': model_name,
+            'InitialInstanceCount': '1',
+            'InstanceType': 'ml.c4.xlarge'
+        }
+    ]
+}
+
+
+class TestSageMakerEndpointConfigOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerEndpointConfigOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=create_endpoint_config_params
+        )
+
+    def test_parse_config_integers(self):
+        self.sagemaker.parse_config_integers()
+        for variant in self.sagemaker.config['ProductionVariants']:
+            self.assertEqual(variant['InitialInstanceCount'],
+                             int(variant['InitialInstanceCount']))
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_endpoint_config')
+    def test_execute(self, mock_model, mock_client):
+        mock_model.return_value = {
+            'EndpointConfigArn': 'testarn',
+            'ResponseMetadata': {
+                'HTTPStatusCode': 200
+            }
+        }
+        self.sagemaker.execute(None)
+        mock_model.assert_called_once_with(create_endpoint_config_params)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    def test_execute_with_failure(self, mock_model, mock_client):
+        mock_model.return_value = {
+            'EndpointConfigArn': 'testarn',
+            'ResponseMetadata': {
+                'HTTPStatusCode': 200
+            }
+        }
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_endpoint_operator.py b/tests/contrib/operators/test_sagemaker_endpoint_operator.py
new file mode 100644
index 0000000000000..710daceff5b57
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_endpoint_operator.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_endpoint_operator \
+    import SageMakerEndpointOperator
+from airflow.exceptions import AirflowException
+
+role = 'arn:aws:iam:role/test-role'
+bucket = 'test-bucket'
+image = 'test-image'
+output_url = 's3://{}/test/output'.format(bucket)
+model_name = 'test-model-name'
+config_name = 'test-endpoint-config-name'
+endpoint_name = 'test-endpoint-name'
+
+create_model_params = {
+    'ModelName': model_name,
+    'PrimaryContainer': {
+        'Image': image,
+        'ModelDataUrl': output_url,
+    },
+    'ExecutionRoleArn': role
+}
+
+create_endpoint_config_params = {
+    'EndpointConfigName': config_name,
+    'ProductionVariants': [
+        {
+            'VariantName': 'AllTraffic',
+            'ModelName': model_name,
+            'InitialInstanceCount': '1',
+            'InstanceType': 'ml.c4.xlarge'
+        }
+    ]
+}
+
+create_endpoint_params = {
+    'EndpointName': endpoint_name,
+    'EndpointConfigName': config_name
+}
+
+config = {
+    'Model': create_model_params,
+    'EndpointConfig': create_endpoint_config_params,
+    'Endpoint': create_endpoint_params
+}
+
+
+class TestSageMakerEndpointOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerEndpointOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=config,
+            wait_for_completion=False,
+            check_interval=5,
+            operation='create'
+        )
+
+    def test_parse_config_integers(self):
+        self.sagemaker.parse_config_integers()
+        for variant in self.sagemaker.config['EndpointConfig']['ProductionVariants']:
+            self.assertEqual(variant['InitialInstanceCount'],
+                             int(variant['InitialInstanceCount']))
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_endpoint_config')
+    @mock.patch.object(SageMakerHook, 'create_endpoint')
+    def test_execute(self, mock_endpoint, mock_endpoint_config,
+                     mock_model, mock_client):
+        mock_endpoint.return_value = {'EndpointArn': 'testarn',
+                                      'ResponseMetadata':
+                                      {'HTTPStatusCode': 200}}
+        self.sagemaker.execute(None)
+        mock_model.assert_called_once_with(create_model_params)
+        mock_endpoint_config.assert_called_once_with(create_endpoint_config_params)
+        mock_endpoint.assert_called_once_with(create_endpoint_params,
+                                              wait_for_completion=False,
+                                              check_interval=5,
+                                              max_ingestion_time=None
+                                              )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    @mock.patch.object(SageMakerHook, 'create_endpoint_config')
+    @mock.patch.object(SageMakerHook, 'create_endpoint')
+    def test_execute_with_failure(self, mock_endpoint, mock_endpoint_config,
+                                  mock_model, mock_client):
+        mock_endpoint.return_value = {'EndpointArn': 'testarn',
+                                      'ResponseMetadata':
+                                      {'HTTPStatusCode': 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sagemaker_model_operator.py b/tests/contrib/operators/test_sagemaker_model_operator.py
new file mode 100644
index 0000000000000..6b6d12de10264
--- /dev/null
+++ b/tests/contrib/operators/test_sagemaker_model_operator.py
@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.contrib.operators.sagemaker_model_operator \
+    import SageMakerModelOperator
+from airflow.exceptions import AirflowException
+
+role = 'arn:aws:iam:role/test-role'
+
+bucket = 'test-bucket'
+
+model_name = 'test-model-name'
+
+image = 'test-image'
+
+output_url = 's3://{}/test/output'.format(bucket)
+create_model_params = {
+    'ModelName': model_name,
+    'PrimaryContainer': {
+        'Image': image,
+        'ModelDataUrl': output_url,
+    },
+    'ExecutionRoleArn': role
+}
+
+
+class TestSageMakerModelOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.sagemaker = SageMakerModelOperator(
+            task_id='test_sagemaker_operator',
+            aws_conn_id='sagemaker_test_id',
+            config=create_model_params
+        )
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    def test_execute(self, mock_model, mock_client):
+        mock_model.return_value = {'ModelArn': 'testarn',
+                                   'ResponseMetadata':
+                                       {'HTTPStatusCode': 200}}
+        self.sagemaker.execute(None)
+        mock_model.assert_called_once_with(create_model_params)
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'create_model')
+    def test_execute_with_failure(self, mock_model, mock_client):
+        mock_model.return_value = {'ModelArn': 'testarn',
+                                   'ResponseMetadata':
+                                       {'HTTPStatusCode': 404}}
+        self.assertRaises(AirflowException, self.sagemaker.execute, None)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py b/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py
new file mode 100644
index 0000000000000..2e438e4e193ae
--- /dev/null
+++ b/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py
@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import configuration
+from airflow.contrib.sensors.sagemaker_endpoint_sensor \
+    import SageMakerEndpointSensor
+from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
+from airflow.exceptions import AirflowException
+
+DESCRIBE_ENDPOINT_CREATING_RESPONSE = {
+    'EndpointStatus': 'Creating',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+DESCRIBE_ENDPOINT_INSERVICE_RESPONSE = {
+    'EndpointStatus': 'InService',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+DESCRIBE_ENDPOINT_FAILED_RESPONSE = {
+    'EndpointStatus': 'Failed',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    },
+    'FailureReason': 'Unknown'
+}
+
+DESCRIBE_ENDPOINT_UPDATING_RESPONSE = {
+    'EndpointStatus': 'Updating',
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+    }
+}
+
+
+class TestSageMakerEndpointSensor(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, 'describe_endpoint')
+    def test_sensor_with_failure(self, mock_describe, mock_client):
+        mock_describe.side_effect = [DESCRIBE_ENDPOINT_FAILED_RESPONSE]
+        sensor = SageMakerEndpointSensor(
+            task_id='test_task',
+            poke_interval=1,
+            aws_conn_id='aws_test',
+            endpoint_name='test_job_name'
+        )
+        self.assertRaises(AirflowException, sensor.execute, None)
+        mock_describe.assert_called_once_with('test_job_name')
+
+    @mock.patch.object(SageMakerHook, 'get_conn')
+    @mock.patch.object(SageMakerHook, '__init__')
+    @mock.patch.object(SageMakerHook, 'describe_endpoint')
+    def test_sensor(self, mock_describe, hook_init, mock_client):
+        hook_init.return_value = None
+
+        mock_describe.side_effect = [
+            DESCRIBE_ENDPOINT_CREATING_RESPONSE,
+            DESCRIBE_ENDPOINT_UPDATING_RESPONSE,
+            DESCRIBE_ENDPOINT_INSERVICE_RESPONSE
+        ]
+        sensor = SageMakerEndpointSensor(
+            task_id='test_task',
+            poke_interval=1,
+            aws_conn_id='aws_test',
+            endpoint_name='test_job_name'
+        )
+
+        sensor.execute(None)
+
+        # make sure we called 3 times(terminated when its completed)
+        self.assertEqual(mock_describe.call_count, 3)
+
+        # make sure the hook was initialized with the specific params
+        hook_init.assert_called_with(aws_conn_id='aws_test')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_sagemaker_training_sensor.py b/tests/contrib/sensors/test_sagemaker_training_sensor.py
index 5861d7a6fdb15..6642449c6a795 100644
--- a/tests/contrib/sensors/test_sagemaker_training_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_training_sensor.py
@@ -101,7 +101,7 @@ def test_sensor(self, mock_describe_job, hook_init, mock_client):
 
         sensor.execute(None)
 
-        # make sure we called 4 times(terminated when its compeleted)
+        # make sure we called 3 times(terminated when its compeleted)
         self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params
diff --git a/tests/contrib/sensors/test_sagemaker_transform_sensor.py b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
index 1394920d5dc3d..810680683cde3 100644
--- a/tests/contrib/sensors/test_sagemaker_transform_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
@@ -97,7 +97,7 @@ def test_sensor(self, mock_describe_job, hook_init, mock_client):
 
         sensor.execute(None)
 
-        # make sure we called 4 times(terminated when its compeleted)
+        # make sure we called 3 times(terminated when its compeleted)
         self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params
diff --git a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
index 8c0ba11380c1a..beb62dc47b1d1 100644
--- a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
@@ -100,7 +100,7 @@ def test_sensor(self, mock_describe_job, hook_init, mock_client):
 
         sensor.execute(None)
 
-        # make sure we called 4 times(terminated when its compeleted)
+        # make sure we called 3 times(terminated when its compeleted)
         self.assertEqual(mock_describe_job.call_count, 3)
 
         # make sure the hook was initialized with the specific params

From c39c961d8d0e9443eac0d3e65854c3e3bda2e750 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Mon, 5 Nov 2018 19:41:14 +0100
Subject: [PATCH 183/808] [AIRFLOW-2780] Add IMAP Hook to retrieve email
 attachments (#4119)

[AIRFLOW-2780] Add IMAP Hook to retrieve email attachments
- Add has_mail_attachments to check if there are mail attachments in the given mailbox with the given attachment name
- Add retrieve_mail_attachments to download the attachments to a local directory
- Add some test cases but more are coming
- Add license header
- Change retrieve_mail_attachments to download_mail_attachments
- Add retrieve_mail_attachments that return a list of tuple containing the attachments found
- Change IMAP4_SSL close() method to be called after retrieving the attachments and not before logging out
- Change test_connect to not check for close method because no mail folder will be opened when only connecting
- Add some test cases that are still in WIP
- Fixes a bug causing multiple attachments in a single mail not being correctly added to the all mails attachments
- Fixes a bug where MailPart is_attachment always returns None
- Add logging when an attachment has been found that matches the name
- Add more test cases with sample mail
---
 airflow/contrib/hooks/imap_hook.py    | 280 ++++++++++++++++++++++++++
 docs/code.rst                         |   1 +
 tests/contrib/hooks/test_imap_hook.py | 266 ++++++++++++++++++++++++
 3 files changed, 547 insertions(+)
 create mode 100644 airflow/contrib/hooks/imap_hook.py
 create mode 100644 tests/contrib/hooks/test_imap_hook.py

diff --git a/airflow/contrib/hooks/imap_hook.py b/airflow/contrib/hooks/imap_hook.py
new file mode 100644
index 0000000000000..c0b3126a8f382
--- /dev/null
+++ b/airflow/contrib/hooks/imap_hook.py
@@ -0,0 +1,280 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import email
+import imaplib
+import os
+import re
+
+from airflow import LoggingMixin
+from airflow.hooks.base_hook import BaseHook
+
+
+class ImapHook(BaseHook):
+    """
+    This hook connects to a mail server by using the imap protocol.
+
+    :param imap_conn_id: The connection id that contains the information
+                         used to authenticate the client.
+                         The default value is 'imap_default'.
+    :type imap_conn_id: str
+    """
+
+    def __init__(self, imap_conn_id='imap_default'):
+        super(ImapHook, self).__init__(imap_conn_id)
+        self.conn = self.get_connection(imap_conn_id)
+        self.mail_client = imaplib.IMAP4_SSL(self.conn.host)
+
+    def __enter__(self):
+        self.mail_client.login(self.conn.login, self.conn.password)
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.mail_client.logout()
+
+    def has_mail_attachment(self, name, mail_folder='INBOX', check_regex=False):
+        """
+        Checks the mail folder for mails containing attachments with the given name.
+
+        :param name: The name of the attachment that will be searched for.
+        :type name: str
+        :param mail_folder: The mail folder where to look at.
+                            The default value is 'INBOX'.
+        :type mail_folder: str
+        :param check_regex: Checks the name for a regular expression.
+                            The default value is False.
+        :type check_regex: bool
+        :returns: True if there is an attachment with the given name and False if not.
+        :rtype: bool
+        """
+        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
+                                                                    check_regex,
+                                                                    latest_only=True)
+        return len(mail_attachments) > 0
+
+    def retrieve_mail_attachments(self, name, mail_folder='INBOX', check_regex=False,
+                                  latest_only=False):
+        """
+        Retrieves mail's attachments in the mail folder by its name.
+
+        :param name: The name of the attachment that will be downloaded.
+        :type name: str
+        :param mail_folder: The mail folder where to look at.
+                            The default value is 'INBOX'.
+        :type mail_folder: str
+        :param check_regex: Checks the name for a regular expression.
+                            The default value is False.
+        :type check_regex: bool
+        :param latest_only: If set to True it will only retrieve
+                            the first matched attachment.
+                            The default value is False.
+        :type latest_only: bool
+        :returns: a list of tuple each containing the attachment filename and its payload.
+        :rtype: a list of tuple
+        """
+        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
+                                                                    check_regex,
+                                                                    latest_only)
+        return mail_attachments
+
+    def download_mail_attachments(self, name, local_output_directory, mail_folder='INBOX',
+                                  check_regex=False, latest_only=False):
+        """
+        Downloads mail's attachments in the mail folder by its name
+        to the local directory.
+
+        :param name: The name of the attachment that will be downloaded.
+        :type name: str
+        :param local_output_directory: The output directory on the local machine
+                                       where the files will be downloaded to.
+        :type local_output_directory: str
+        :param mail_folder: The mail folder where to look at.
+                            The default value is 'INBOX'.
+        :type mail_folder: str
+        :param check_regex: Checks the name for a regular expression.
+                            The default value is False.
+        :type check_regex: bool
+        :param latest_only: If set to True it will only download
+                            the first matched attachment.
+                            The default value is False.
+        :type latest_only: bool
+        """
+        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
+                                                                    check_regex, latest_only)
+        self._create_files(mail_attachments, local_output_directory)
+
+    def _retrieve_mails_attachments_by_name(self, name, mail_folder, check_regex,
+                                            latest_only):
+        all_matching_attachments = []
+
+        self.mail_client.select(mail_folder)
+
+        for mail_id in self._list_mail_ids_desc():
+            response_mail_body = self._fetch_mail_body(mail_id)
+            matching_attachments = self._check_mail_body(response_mail_body, name, check_regex, latest_only)
+
+            if matching_attachments:
+                all_matching_attachments.extend(matching_attachments)
+                if latest_only:
+                    break
+
+        self.mail_client.close()
+
+        return all_matching_attachments
+
+    def _list_mail_ids_desc(self):
+        result, data = self.mail_client.search(None, 'All')
+        mail_ids = data[0].split()
+        return reversed(mail_ids)
+
+    def _fetch_mail_body(self, mail_id):
+        result, data = self.mail_client.fetch(mail_id, '(RFC822)')
+        mail_body = data[0][1]  # The mail body is always in this specific location
+        mail_body_str = mail_body.decode('utf-8')
+        return mail_body_str
+
+    def _check_mail_body(self, response_mail_body, name, check_regex, latest_only):
+        mail = Mail(response_mail_body)
+        if mail.has_attachments():
+            return mail.get_attachments_by_name(name, check_regex, find_first=latest_only)
+
+    def _create_files(self, mail_attachments, local_output_directory):
+        for name, payload in mail_attachments:
+            if self._is_symlink(name):
+                self.log.error('Can not create file because it is a symlink!')
+            elif self._is_escaping_current_directory(name):
+                self.log.error('Can not create file because it is escaping the current directory!')
+            else:
+                self._create_file(name, payload, local_output_directory)
+
+    def _is_symlink(self, name):
+        return os.path.islink(name)
+
+    def _is_escaping_current_directory(self, name):
+        return '../' in name
+
+    def _correct_path(self, name, local_output_directory):
+        return local_output_directory + name if local_output_directory.endswith('/') \
+            else local_output_directory + '/' + name
+
+    def _create_file(self, name, payload, local_output_directory):
+        file_path = self._correct_path(name, local_output_directory)
+
+        with open(file_path, 'wb') as file:
+            file.write(payload)
+
+
+class Mail(LoggingMixin):
+    """
+    This class simplifies working with mails returned by the imaplib client.
+
+    :param mail_body: The mail body of a mail received from imaplib client.
+    :type mail_body: str
+    """
+
+    def __init__(self, mail_body):
+        super(Mail, self).__init__()
+        self.mail = email.message_from_string(mail_body)
+
+    def has_attachments(self):
+        """
+        Checks the mail for a attachments.
+
+        :returns: True if it has attachments and False if not.
+        :rtype: bool
+        """
+        return self.mail.get_content_maintype() == 'multipart'
+
+    def get_attachments_by_name(self, name, check_regex, find_first=False):
+        """
+        Gets all attachments by name for the mail.
+
+        :param name: The name of the attachment to look for.
+        :type name: str
+        :param check_regex: Checks the name for a regular expression.
+        :type check_regex: bool
+        :param find_first: If set to True it will only find the first match and then quit.
+                           The default value is False.
+        :type find_first: bool
+        :returns: a list of tuples each containing name and payload
+                  where the attachments name matches the given name.
+        :rtype: list of tuple
+        """
+        attachments = []
+
+        for part in self.mail.walk():
+            mail_part = MailPart(part)
+            if mail_part.is_attachment():
+                found_attachment = mail_part.has_matching_name(name) if check_regex \
+                    else mail_part.has_equal_name(name)
+                if found_attachment:
+                    file_name, file_payload = mail_part.get_file()
+                    self.log.info('Found attachment: {}'.format(file_name))
+                    attachments.append((file_name, file_payload))
+                    if find_first:
+                        break
+
+        return attachments
+
+
+class MailPart:
+    """
+    This class is a wrapper for a Mail object's part and gives it more features.
+
+    :param part: The mail part in a Mail object.
+    :type part: any
+    """
+
+    def __init__(self, part):
+        self.part = part
+
+    def is_attachment(self):
+        """
+        Checks if the part is a valid mail attachment.
+
+        :returns: True if it is an attachment and False if not.
+        :rtype: bool
+        """
+        return self.part.get_content_maintype() != 'multipart' and self.part.get('Content-Disposition')
+
+    def has_matching_name(self, name):
+        """
+        Checks if the given name matches the part's name.
+
+        :param name: The name to look for.
+        :type name: str
+        :returns: True if it matches the name (including regular expression).
+        :rtype: tuple
+        """
+        return re.match(name, self.part.get_filename())
+
+    def has_equal_name(self, name):
+        """
+        Checks if the given name is equal to the part's name.
+
+        :param name: The name to look for.
+        :type name: str
+        :returns: True if it is equal to the given name.
+        :rtype: bool
+        """
+        return self.part.get_filename() == name
+
+    def get_file(self):
+        """
+        Gets the file including name and payload.
+
+        :returns: the part's name and payload.
+        :rtype: tuple
+        """
+        return self.part.get_filename(), self.part.get_payload(decode=True)
diff --git a/docs/code.rst b/docs/code.rst
index ca6ca593ca345..12db9b71b136d 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -401,6 +401,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
 .. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
+.. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
 .. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook
 .. autoclass:: airflow.contrib.hooks.mongo_hook.MongoHook
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
new file mode 100644
index 0000000000000..63dc13a874e63
--- /dev/null
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -0,0 +1,266 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import imaplib
+import unittest
+
+from mock import Mock, patch, mock_open
+
+from airflow import configuration, models
+from airflow.contrib.hooks.imap_hook import ImapHook
+from airflow.utils import db
+
+imaplib_string = 'airflow.contrib.hooks.imap_hook.imaplib'
+open_string = 'airflow.contrib.hooks.imap_hook.open'
+
+
+def _create_fake_imap(mock_imaplib, with_mail=False, attachment_name='test1.csv'):
+    mock_conn = Mock(spec=imaplib.IMAP4_SSL)
+    mock_imaplib.IMAP4_SSL.return_value = mock_conn
+
+    mock_conn.login.return_value = ('OK', [])
+
+    if with_mail:
+        mock_conn.select.return_value = ('OK', [])
+        mock_conn.search.return_value = ('OK', [b'1'])
+        mail_string = \
+            'Content-Type: multipart/mixed; boundary=123\r\n--123\r\n' \
+            'Content-Disposition: attachment; filename="{}";' \
+            'Content-Transfer-Encoding: base64\r\nSWQsTmFtZQoxLEZlbGl4\r\n--123--'.format(attachment_name)
+        mock_conn.fetch.return_value = ('OK', [(b'', mail_string.encode('utf-8'))])
+        mock_conn.close.return_value = ('OK', [])
+
+    mock_conn.logout.return_value = ('OK', [])
+
+    return mock_conn
+
+
+class TestImapHook(unittest.TestCase):
+    def setUp(self):
+        configuration.load_test_config()
+
+        db.merge_conn(
+            models.Connection(
+                conn_id='imap_default',
+                host='imap_server_address',
+                login='imap_user',
+                password='imap_password'
+            )
+        )
+
+    @patch(imaplib_string)
+    def test_connect_and_disconnect(self, mock_imaplib):
+        mock_conn = _create_fake_imap(mock_imaplib)
+
+        with ImapHook():
+            pass
+
+        mock_imaplib.IMAP4_SSL.assert_called_once_with('imap_server_address')
+        mock_conn.login.assert_called_once_with('imap_user', 'imap_password')
+        mock_conn.logout.assert_called_once()
+
+    @patch(imaplib_string)
+    def test_has_mail_attachments_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            has_attachment_in_inbox = imap_hook.has_mail_attachment('test1.csv')
+
+        self.assertTrue(has_attachment_in_inbox)
+
+    @patch(imaplib_string)
+    def test_has_mail_attachments_not_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            has_attachment_in_inbox = imap_hook.has_mail_attachment('test1.txt')
+
+        self.assertFalse(has_attachment_in_inbox)
+
+    @patch(imaplib_string)
+    def test_has_mail_attachments_with_regex_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            has_attachment_in_inbox = imap_hook.has_mail_attachment(
+                name='test(\d+).csv',
+                check_regex=True
+            )
+
+        self.assertTrue(has_attachment_in_inbox)
+
+    @patch(imaplib_string)
+    def test_has_mail_attachments_with_regex_not_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            has_attachment_in_inbox = imap_hook.has_mail_attachment(
+                name='test_(\d+).csv',
+                check_regex=True
+            )
+
+        self.assertFalse(has_attachment_in_inbox)
+
+    @patch(imaplib_string)
+    def test_retrieve_mail_attachments_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            attachments_in_inbox = imap_hook.retrieve_mail_attachments('test1.csv')
+
+        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+
+    @patch(imaplib_string)
+    def test_retrieve_mail_attachments_not_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            attachments_in_inbox = imap_hook.retrieve_mail_attachments('test1.txt')
+
+        self.assertEquals(attachments_in_inbox, [])
+
+    @patch(imaplib_string)
+    def test_retrieve_mail_attachments_with_regex_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            attachments_in_inbox = imap_hook.retrieve_mail_attachments(
+                name='test(\d+).csv',
+                check_regex=True
+            )
+
+        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+
+    @patch(imaplib_string)
+    def test_retrieve_mail_attachments_with_regex_not_found(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            attachments_in_inbox = imap_hook.retrieve_mail_attachments(
+                name='test_(\d+).csv',
+                check_regex=True
+            )
+
+        self.assertEquals(attachments_in_inbox, [])
+
+    @patch(imaplib_string)
+    def test_retrieve_mail_attachments_latest_only(self, mock_imaplib):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            attachments_in_inbox = imap_hook.retrieve_mail_attachments(
+                name='test1.csv',
+                latest_only=True
+            )
+
+        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_found(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments('test1.csv', 'test_directory')
+
+        mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
+        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_not_found(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments('test1.txt', 'test_directory')
+
+        mock_open_method.assert_not_called()
+        mock_open_method().write.assert_not_called()
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_with_regex_found(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments(
+                name='test(\d+).csv',
+                local_output_directory='test_directory',
+                check_regex=True
+            )
+
+        mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
+        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_with_regex_not_found(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments(
+                name='test_(\d+).csv',
+                local_output_directory='test_directory',
+                check_regex=True
+            )
+
+        mock_open_method.assert_not_called()
+        mock_open_method().write.assert_not_called()
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_with_latest_only(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True)
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments(
+                name='test1.csv',
+                local_output_directory='test_directory',
+                latest_only=True
+            )
+
+        mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
+        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_with_escaping_chars(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True, attachment_name='../test1.csv')
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments(
+                name='test1.csv',
+                local_output_directory='test_directory'
+            )
+
+        mock_open_method.assert_not_called()
+        mock_open_method().write.assert_not_called()
+
+    @patch(open_string, new_callable=mock_open)
+    @patch(imaplib_string)
+    def test_download_mail_attachments_with_symlink(self, mock_imaplib, mock_open_method):
+        _create_fake_imap(mock_imaplib, with_mail=True, attachment_name='initrd.img')
+
+        with ImapHook() as imap_hook:
+            imap_hook.download_mail_attachments(
+                name='test1.csv',
+                local_output_directory='test_directory'
+            )
+
+        mock_open_method.assert_not_called()
+        mock_open_method().write.assert_not_called()
+
+
+if __name__ == '__main__':
+    unittest.main()

From 66d0d05ea0802aec407e0ef5435a962080db0926 Mon Sep 17 00:00:00 2001
From: Bolke de Bruin <bolke@xs4all.nl>
Date: Fri, 5 Oct 2018 20:03:22 +0200
Subject: [PATCH 184/808] [AIRFLOW-3164] Verify server certificate when
 connecting to LDAP (#4006)

Misconfiguration and improper checking of exceptions disabled
server certificate checking. We now only support TLS connections
and do not support insecure connections anymore.
---
 UPDATING.md                                | 11 +++++++++++
 airflow/contrib/auth/backends/ldap_auth.py | 14 ++++++++------
 docs/security.rst                          |  3 +--
 setup.py                                   |  2 +-
 4 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 6fde229a2038d..0f108ffadc1ba 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -83,6 +83,17 @@ configuration, so creating EMR clusters might fail until your connection is upda
 Ec2SubnetId, TerminationProtection and KeepJobFlowAliveWhenNoSteps were all top-level keys when they
 should be inside the "Instances" dict)
 
+### LDAP Auth Backend now requires TLS
+
+Connecting to an LDAP serever over plain text is not supported anymore. The
+certificate presented by the LDAP server must be signed by a trusted
+certificiate, or you must provide the `cacert` option under `[ldap]` in the
+config file.
+
+If you want to use LDAP auth backend without TLS then you will habe to create a
+custom-auth backend based on
+https://github.com/apache/incubator-airflow/blob/1.10.0/airflow/contrib/auth/backends/ldap_auth.py
+
 ## Airflow 1.10
 
 Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index cb4675757b75a..dc17dab5124cd 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -56,16 +56,18 @@ class LdapException(Exception):
 
 
 def get_ldap_connection(dn=None, password=None):
-    tls_configuration = None
-    use_ssl = False
     try:
         cacert = configuration.conf.get("ldap", "cacert")
-        tls_configuration = Tls(validate=ssl.CERT_REQUIRED, ca_certs_file=cacert)
-        use_ssl = True
-    except Exception:
+    except AirflowConfigException:
         pass
 
-    server = Server(configuration.conf.get("ldap", "uri"), use_ssl, tls_configuration)
+    tls_configuration = Tls(validate=ssl.CERT_REQUIRED,
+                            ca_certs_file=cacert)
+
+    server = Server(configuration.conf.get("ldap", "uri"),
+                    use_ssl=True,
+                    tls=tls_configuration)
+
     conn = Connection(server, native(dn), native(password))
 
     if not conn.bind():
diff --git a/docs/security.rst b/docs/security.rst
index b47a58f7418f0..1ecc958d52ab4 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -61,8 +61,7 @@ LDAP
 ''''
 
 To turn on LDAP authentication configure your ``airflow.cfg`` as follows. Please note that the example uses
-an encrypted connection to the ldap server as you probably do not want passwords be readable on the network level.
-It is however possible to configure without encryption if you really want to.
+an encrypted connection to the ldap server as we do not want passwords be readable on the network level.
 
 Additionally, if you are using Active Directory, and are not explicitly specifying an OU that your users are in,
 you will need to change ``search_scope`` to "SUBTREE".
diff --git a/setup.py b/setup.py
index c187b9b7ff51a..49de5e6205423 100644
--- a/setup.py
+++ b/setup.py
@@ -188,7 +188,7 @@ def write_version(filename=os.path.join(*['airflow',
             'snakebite[kerberos]>=2.7.8']
 kubernetes = ['kubernetes>=3.0.0',
               'cryptography>=2.0.0']
-ldap = ['ldap3>=0.9.9.1']
+ldap = ['ldap3>=2.5.1']
 mssql = ['pymssql>=2.1.1']
 mysql = ['mysqlclient>=1.3.6']
 oracle = ['cx_Oracle>=5.1.2']

From c75b6eb9178ae54054789d448677147a5a1c422c Mon Sep 17 00:00:00 2001
From: Dana Assa <dana.assa@nielsen.com>
Date: Wed, 7 Nov 2018 17:08:42 +0200
Subject: [PATCH 185/808] [AIRFLOW-3297] added more failure states to the EMR
 step sensor (#4152)

Previously, the states 'PENDING_CANCELLED' and 'INTERRUPTED' resulted in the
Airflow task being marked as successful. This PR fixed this by mentioning those states
as NON_TERMINAL_STATES and as FAILED_STATE, accordingly.
---
 airflow/contrib/sensors/emr_step_sensor.py    |  4 +-
 tests/contrib/sensors/test_emr_step_sensor.py | 40 +++++++++++++++++++
 2 files changed, 42 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/sensors/emr_step_sensor.py b/airflow/contrib/sensors/emr_step_sensor.py
index 3dddf01bd83a5..44aaea410dd1e 100644
--- a/airflow/contrib/sensors/emr_step_sensor.py
+++ b/airflow/contrib/sensors/emr_step_sensor.py
@@ -32,8 +32,8 @@ class EmrStepSensor(EmrBaseSensor):
     :type step_id: string
     """
 
-    NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE']
-    FAILED_STATE = ['CANCELLED', 'FAILED']
+    NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE', 'CANCEL_PENDING']
+    FAILED_STATE = ['CANCELLED', 'FAILED', 'INTERRUPTED']
     template_fields = ['job_flow_id', 'step_id']
     template_ext = ()
 
diff --git a/tests/contrib/sensors/test_emr_step_sensor.py b/tests/contrib/sensors/test_emr_step_sensor.py
index 7f72c73befd03..ad0b2469e861b 100644
--- a/tests/contrib/sensors/test_emr_step_sensor.py
+++ b/tests/contrib/sensors/test_emr_step_sensor.py
@@ -83,6 +83,35 @@
     }
 }
 
+DESCRIBE_JOB_STEP_INTERRUPTED_RETURN = {
+    'ResponseMetadata': {
+        'HTTPStatusCode': 200,
+        'RequestId': '8dee8db2-3719-11e6-9e20-35b2f861a2a6'
+    },
+    'Step': {
+        'ActionOnFailure': 'CONTINUE',
+        'Config': {
+            'Args': [
+                '/usr/lib/spark/bin/run-example',
+                'SparkPi',
+                '10'
+            ],
+            'Jar': 'command-runner.jar',
+            'Properties': {}
+        },
+        'Id': 's-VK57YR1Z9Z5N',
+        'Name': 'calculate_pi',
+        'Status': {
+            'State': 'INTERRUPTED',
+            'StateChangeReason': {},
+            'Timeline': {
+                'CreationDateTime': datetime(2016, 6, 20, 19, 0, 18, tzinfo=tzlocal()),
+                'StartDateTime': datetime(2016, 6, 20, 19, 2, 34, tzinfo=tzlocal())
+            }
+        }
+    }
+}
+
 DESCRIBE_JOB_STEP_COMPLETED_RETURN = {
     'ResponseMetadata': {
         'HTTPStatusCode': 200,
@@ -158,6 +187,17 @@ def test_step_cancelled(self):
         with patch('boto3.session.Session', self.boto3_session_mock):
             self.assertRaises(AirflowException, self.sensor.execute, None)
 
+    def test_step_interrupted(self):
+        self.emr_client_mock.describe_step.side_effect = [
+            DESCRIBE_JOB_STEP_RUNNING_RETURN,
+            DESCRIBE_JOB_STEP_INTERRUPTED_RETURN
+        ]
+
+        self.boto3_client_mock = MagicMock(return_value=self.emr_client_mock)
+
+        with patch('boto3.session.Session', self.boto3_session_mock):
+            self.assertRaises(AirflowException, self.sensor.execute, None)
+
 
 if __name__ == '__main__':
     unittest.main()

From fa9088699696d89a7d00f3cdadc9b1360978a86c Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 8 Nov 2018 23:07:03 +0000
Subject: [PATCH 186/808] Version 1.10.1b1

---
 CHANGELOG.txt      | 129 +++++++++++++++++++++++++++++++++++++++++++++
 airflow/version.py |   2 +-
 2 files changed, 130 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index b4ee1755b467a..f10de13cf35d3 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,3 +1,132 @@
+AIRFLOW 1.10.1b1, 2018-11-09
+
+New features:
+
+[AIRFLOW-2524] Airflow integration with AWS Sagemaker
+[AIRFLOW-2657] Add ability to delete DAG from web ui
+[AIRFLOW-2780] Adds IMAP Hook to interact with a mail server
+[AIRFLOW-2794] Add delete support for Azure blob
+[AIRFLOW-2912] Add operators for Google Cloud Functions
+[AIRFLOW-2974] Add Start/Restart/Terminate methods Databricks Hook
+[AIRFLOW-2989] No Parameter to change bootDiskType for DataprocClusterCreateOperator
+[AIRFLOW-3078] Basic operators for Google Compute Engine
+[AIRFLOW-3147] Update Flask-AppBuilder version
+[AIRFLOW-3231] Basic operators for Google Cloud SQL (deploy / patch / delete)
+[AIRFLOW-3276] Google Cloud SQL database create / patch / delete operators
+
+Improvements:
+
+[AIRFLOW-393] Add progress callbacks for FTP downloads
+[AIRFLOW-520] Show Airflow version on web page
+[AIRFLOW-843] Excpetions now available in context durint on_failure_callback
+[AIRFLOW-2476] Update tabulate dependency to v0.8.2
+[AIRFLOW-2592] Bump Bleach dependency
+[AIRFLOW-2622] Add "confirm=False" option to SFTPOperator
+[AIRFLOW-2662] support affinity & nodeSelector policies for kubernetes executor/operator
+[AIRFLOW-2709] Improve error handling in Databricks hook
+[AIRFLOW-2763] No precheck mechanism in place during worker initialisation for the connection to metadata database
+[AIRFLOW-2789] Add ability to create single node cluster to DataprocClusterCreateOperator
+[AIRFLOW-2797] Add ability to create Google Dataproc cluster with custom image
+[AIRFLOW-2854] kubernetes_pod_operator add more configuration items
+[AIRFLOW-2855] Need to Check Validity of Cron Expression When Process DAG File/Zip File
+[AIRFLOW-2904] Clean an unnecessary line in airflow/executors/celery_executor.py
+[AIRFLOW-2921] A trivial incorrectness in CeleryExecutor()
+[AIRFLOW-2922] Potential deal-lock bug in CeleryExecutor()
+[AIRFLOW-2932] GoogleCloudStorageHook - allow compression of file
+[AIRFLOW-2949] Syntax Highlight for Single Quote
+[AIRFLOW-2951] dag_run end_date Null after a dag is finished
+[AIRFLOW-2956] Kubernetes tolerations for pod operator
+[AIRFLOW-2997] Support for clustered tables in Bigquery hooks/operators
+[AIRFLOW-3006] Fix rrror when schedule_interval="None"
+[AIRFLOW-3008] Move Kubernetes related example DAGs to contribe/example_dags
+[AIRFLOW-3025] Allow to specify dns and dns-search parameters for DockerOperator
+[AIRFLOW-3067] (www_rbac) Flask flash messages are not displayed properly (no background color)
+[AIRFLOW-3069] Decode output of S3 file transform operator
+[AIRFLOW-3090] INFO logs are too verbose
+[AIRFLOW-3103] Update Flask-Login
+[AIRFLOW-3112] Align SFTP hook with SSH hook
+[AIRFLOW-3119] Enable loglevel on celery worker and inherit from airflow.cfg
+[AIRFLOW-3137] Make ProxyFix middleware optional
+[AIRFLOW-3173] Add _cmd options for more password config options
+[AIRFLOW-3177] Change scheduler_heartbeat metric from gauge to counter
+[AIRFLOW-3195] Druid Hook: Log ingestion spec and task id
+[AIRFLOW-3197] EMR Hook is missing some parameters to valid on the AWS API
+[AIRFLOW-3232] Make documentation for GCF Functions operator more readable
+[AIRFLOW-3262] Can't get log containing Response when using SimpleHttpOperator
+[AIRFLOW-3265] Add support for "unix_socket" in connection extra for Mysql Hook
+
+Doc-only changes:
+
+[AIRFLOW-1441] Tutorial Inconsistencies Between Example Pipeline Definition and Recap
+[AIRFLOW-2682] Add how-to guide(s) for how to use basic operators like BashOperator and PythonOperator
+[AIRFLOW-3104] .airflowignore feature is not mentioned at all in documentation
+[AIRFLOW-3237] Refactor example DAGs
+[AIRFLOW-3187] Update airflow.gif file with a slower version
+[AIRFLOW-3159] Update Airflow documentation on GCP Logging
+[AIRFLOW-3030] Command Line docs incorrect subdir
+[AIRFLOW-2990] Docstrings for Hooks/Operators are in incorrect format
+[AIRFLOW-3127] Celery SSL Documentation is out-dated
+
+Bug fixes:
+
+[AIRFLOW-839] docker_operator.py attempts to log status key without first checking existence
+[AIRFLOW-1104] Concurrency check in scheduler should count queued tasks as well as running
+[AIRFLOW-1163] Add support for x-forwarded-* headers to support access behind AWS ELB
+[AIRFLOW-1195] Cleared tasks in SubDagOperator do not trigger Parent dag_runs
+[AIRFLOW-1508] Skipped state not part of State.task_states
+[AIRFLOW-1762] Use key_file in SSHHook.create_tunnel()
+[AIRFLOW-1837] Differing start_dates on tasks not respected by scheduler.
+[AIRFLOW-1874] Support standard SQL in Check, ValueCheck and IntervalCheck BigQuery operators
+[AIRFLOW-1917] print() from python operators end up with extra new line
+[AIRFLOW-1970] Database cannot be initialized if an invalid fernet key is provided
+[AIRFLOW-2145] Deadlock after clearing a running task
+[AIRFLOW-2216] Cannot specify a profile for AWS Hook to load with s3 config file
+[AIRFLOW-2574] initdb fails when mysql password contains percent sign
+[AIRFLOW-2707] Error accessing log files from web UI
+[AIRFLOW-2716] Replace new Python 3.7 keywords
+[AIRFLOW-2744] RBAC app doesn't integrate plugins (blueprints etc)
+[AIRFLOW-2772] BigQuery hook does not allow specifying both the partition field name and table name at the same time
+[AIRFLOW-2778] Bad Import in collect_dag in DagBag
+[AIRFLOW-2786] Variables view fails to render if a variable has an empty key
+[AIRFLOW-2799] Filtering UI objects by datetime is broken
+[AIRFLOW-2800] Remove airflow/ low-hanging linting errors
+[AIRFLOW-2825] S3ToHiveTransfer operator may not may able to handle GZIP file with uppercase ext in S3
+[AIRFLOW-2848] dag_id is missing in metadata table "job" for LocalTaskJob
+[AIRFLOW-2860] DruidHook: time variable is not updated correctly when checking for timeout
+[AIRFLOW-2865] Race condition between on_success_callback and LocalTaskJob's cleanup
+[AIRFLOW-2893] Stuck dataflow job due to jobName mismatch.
+[AIRFLOW-2895] Prevent scheduler from spamming heartbeats/logs
+[AIRFLOW-2900] Code not visible for Packaged DAGs
+[AIRFLOW-2905] Switch to regional dataflow job service.
+[AIRFLOW-2907] Sendgrid - Attachments - ERROR - Object of type 'bytes' is not JSON serializable
+[AIRFLOW-2938] Invalid 'extra' field in connection can raise an AttributeError when attempting to edit
+[AIRFLOW-2979] Deprecated Celery Option not in Options list
+[AIRFLOW-2981] TypeError in dataflow operators when using GCS jar or py_file
+[AIRFLOW-2984] Cannot convert naive_datetime when task has a naive start_date/end_date
+[AIRFLOW-2994] flatten_results in BigQueryOperator/BigQueryHook should default to None
+[AIRFLOW-3002] ValueError in dataflow operators when using GCS jar or py_file
+[AIRFLOW-3012] Email on sla miss is send only to first address on the list
+[AIRFLOW-3046] ECS Operator mistakenly reports success when task is killed due to EC2 host termination
+[AIRFLOW-3064] No output from `airflow test` due to default logging config
+[AIRFLOW-3072] Only admin can view logs in RBAC UI
+[AIRFLOW-3079] Improve initdb to support MSSQL Server
+[AIRFLOW-3089] Google auth doesn't work under http
+[AIRFLOW-3099] Errors raised when some blocs are missing in airflow.cfg
+[AIRFLOW-3109] Default user permission should contain 'can_clear'
+[AIRFLOW-3111] Confusing comments and instructions for log templates in UPDATING.md and default_airflow.cfg
+[AIRFLOW-3124] Broken webserver debug mode (RBAC)
+[AIRFLOW-3136] Scheduler Failing the Task retries run while processing Executor Events
+[AIRFLOW-3138] Migration cc1e65623dc7 creates issues with postgres
+[AIRFLOW-3161] Log Url link does not link to task instance logs in RBAC UI
+[AIRFLOW-3162] HttpHook fails to parse URL when port is specified
+[AIRFLOW-3183] Potential Bug in utils/dag_processing/DagFileProcessorManager.max_runs_reached()
+[AIRFLOW-3203] Bugs in DockerOperator & Some operator test scripts were named incorrectly
+[AIRFLOW-3238] Dags, removed from the filesystem, are not deactivated on initdb
+[AIRFLOW-3268] Cannot pass SSL dictionary to mysql connection via URL
+[AIRFLOW-3277] Invalid timezone transition handling for cron schedules
+[AIRFLOW-3295] Require encryption in DaskExecutor when certificates are configured.
+[AIRFLOW-3297] EmrStepSensor marks cancelled step as successful
+
 AIRFLOW 1.10.0, 2018-08-03
 --------------------------
 [AIRFLOW-2870] Use abstract TaskInstance for migration
diff --git a/airflow/version.py b/airflow/version.py
index be4038b4af24d..1080bf44f6953 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.0'
+version = '1.10.1b1'

From 0586c2e83aa6d7f41e0e0650eaf5017fbccf097b Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 9 Nov 2018 22:36:51 +0800
Subject: [PATCH 187/808] [AIRFLOW-XXX] Fix a few typos in CHANGELOG (#4169)

For 843 and 3006, the original JIRA subjects are actually ok.

For 3008, understand you copied the original JIRA subject. But may be good to fix it here.
---
 CHANGELOG.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index f10de13cf35d3..db77cc2903110 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -18,7 +18,7 @@ Improvements:
 
 [AIRFLOW-393] Add progress callbacks for FTP downloads
 [AIRFLOW-520] Show Airflow version on web page
-[AIRFLOW-843] Excpetions now available in context durint on_failure_callback
+[AIRFLOW-843] Exceptions now available in context during on_failure_callback
 [AIRFLOW-2476] Update tabulate dependency to v0.8.2
 [AIRFLOW-2592] Bump Bleach dependency
 [AIRFLOW-2622] Add "confirm=False" option to SFTPOperator
@@ -37,8 +37,8 @@ Improvements:
 [AIRFLOW-2951] dag_run end_date Null after a dag is finished
 [AIRFLOW-2956] Kubernetes tolerations for pod operator
 [AIRFLOW-2997] Support for clustered tables in Bigquery hooks/operators
-[AIRFLOW-3006] Fix rrror when schedule_interval="None"
-[AIRFLOW-3008] Move Kubernetes related example DAGs to contribe/example_dags
+[AIRFLOW-3006] Fix error when schedule_interval="None"
+[AIRFLOW-3008] Move Kubernetes related example DAGs to contrib/example_dags
 [AIRFLOW-3025] Allow to specify dns and dns-search parameters for DockerOperator
 [AIRFLOW-3067] (www_rbac) Flask flash messages are not displayed properly (no background color)
 [AIRFLOW-3069] Decode output of S3 file transform operator

From 0e1a18352761a5a558cc21a96fcdf64021a1ab25 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 9 Nov 2018 14:42:43 +0000
Subject: [PATCH 188/808] [AIRFLOW-XXX] Update Updating instructions for
 changes in 1.10.1

A cherry-pick went awry causing some thing to be duplicated
---
 UPDATING.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 0f108ffadc1ba..ace0bdae60f9b 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -3,15 +3,7 @@
 This file documents any backwards-incompatible changes in Airflow and
 assists users migrating to a new version.
 
-## Airflow 1.10
-
-Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
-`AIRFLOW_GPL_UNIDECODE=yes`. In case of the latter a GPL runtime dependency will be installed due to a
-dependency (python-nvd3 -> python-slugify -> unidecode).
-
-### Replace DataProcHook.await calls to DataProcHook.wait
-
-The method name was changed to be compatible with the Python 3.7 async/await keywords
+## Airflow Master
 
 ### DAG level Access Control for new RBAC UI
 
@@ -53,6 +45,12 @@ To delete a user:
 airflow users --delete --username jondoe
 ```
 
+## Airflow 1.10.1
+
+### Replace DataProcHook.await calls to DataProcHook.wait
+
+The method name was changed to be compatible with the Python 3.7 async/await keywords
+
 ### StatsD Metrics
 
 The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.

From c71e078e03be0618630d7e7d87ae875a043a13a3 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 13 Nov 2018 00:56:09 +0800
Subject: [PATCH 189/808] [AIRFLOW-3325] Fix UI Page DAGs-column 'Recent Tasks'
 display issue (#4173)

A new task state "Skipped" was added while UI was not updated accordingly.

This makes the last circle in column "Recent Tasks" not displayed completely.

Fixed both www/ and www_raac/
---
 airflow/www/templates/airflow/dags.html      | 2 +-
 airflow/www_rbac/templates/airflow/dags.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 0a7a6ec2a4791..5473189d439dd 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -402,7 +402,7 @@ <h2>DAGs</h2>
             states = json[dag_id];
             g = d3.select('svg#task-run-' + dag_id)
               .attr('height', diameter + (stroke_width_hover * 2))
-              .attr('width', '240px')
+              .attr('width', '270px')
               .selectAll("g")
               .data(states)
               .enter()
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index c7aa33801488f..bba0d191dde35 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -401,7 +401,7 @@ <h2>DAGs</h2>
             states = json[dag_id];
             g = d3.select('svg#task-run-' + dag_id)
               .attr('height', diameter + (stroke_width_hover * 2))
-              .attr('width', '240px')
+              .attr('width', '270px')
               .selectAll("g")
               .data(states)
               .enter()

From ab5f5438d7787ec0f6b839ed528317276e2dac50 Mon Sep 17 00:00:00 2001
From: Neil Patel <npatel@blizzard.com>
Date: Fri, 13 Jul 2018 12:12:39 +0200
Subject: [PATCH 190/808] [AIRFLOW-2723] Update lxml dependancy to >= 4.0.0

Closes #3583 from neil90/master
---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index 49de5e6205423..fca659689958c 100644
--- a/setup.py
+++ b/setup.py
@@ -224,7 +224,7 @@ def write_version(filename=os.path.join(*['airflow',
     'click==6.7',
     'freezegun',
     'jira',
-    'lxml>=3.3.4',
+    'lxml>=4.0.0',
     'mock',
     'mongomock',
     'moto==1.1.19',
@@ -287,7 +287,7 @@ def do_setup():
             'gunicorn>=19.4.0, <20.0',
             'iso8601>=0.1.12',
             'jinja2>=2.7.3, <2.9.0',
-            'lxml>=3.6.0, <4.0',
+            'lxml>=4.0.0',
             'markdown>=2.5.2, <3.0',
             'pandas>=0.17.1, <1.0.0',
             'pendulum==1.4.4',

From b5b9287a75596a617557798f1286cf7b89c55350 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Mon, 12 Nov 2018 18:29:53 +0100
Subject: [PATCH 191/808] [AIRFLOW-3072] Assign permission
 get_logs_with_metadata to viewer role (#4175)

---
 airflow/www_rbac/security.py |   1 +
 tests/www_rbac/test_views.py | 107 +++++++++++++++++++++++++++++++++++
 2 files changed, 108 insertions(+)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 2405aa8f803de..72691565e64be 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -75,6 +75,7 @@
     'can_task_stats',
     'can_code',
     'can_log',
+    'can_get_logs_with_metadata',
     'can_tries',
     'can_graph',
     'can_tree',
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index d7f099d6be23b..f378783e90a42 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -786,5 +786,112 @@ def test_start_date_filter(self):
         pass
 
 
+class TestLogViewPermission(TestBase):
+    """
+    Test Airflow DAG acl
+    """
+    default_date = timezone.datetime(2018, 6, 1)
+    run_id = "test_{}".format(models.DagRun.id_for_date(default_date))
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestLogViewPermission, cls).setUpClass()
+
+    def cleanup_dagruns(self):
+        DR = models.DagRun
+        dag_ids = ['example_bash_operator',
+                   'example_subdag_operator']
+        (self.session
+             .query(DR)
+             .filter(DR.dag_id.in_(dag_ids))
+             .filter(DR.run_id == self.run_id)
+             .delete(synchronize_session='fetch'))
+        self.session.commit()
+
+    def prepare_dagruns(self):
+        dagbag = models.DagBag(include_examples=True)
+        self.bash_dag = dagbag.dags['example_bash_operator']
+        self.sub_dag = dagbag.dags['example_subdag_operator']
+
+        self.bash_dagrun = self.bash_dag.create_dagrun(
+            run_id=self.run_id,
+            execution_date=self.default_date,
+            start_date=timezone.utcnow(),
+            state=State.RUNNING)
+
+        self.sub_dagrun = self.sub_dag.create_dagrun(
+            run_id=self.run_id,
+            execution_date=self.default_date,
+            start_date=timezone.utcnow(),
+            state=State.RUNNING)
+
+    def setUp(self):
+        super(TestLogViewPermission, self).setUp()
+        self.cleanup_dagruns()
+        self.prepare_dagruns()
+        self.logout()
+
+    def login(self, username=None, password=None):
+        role_admin = self.appbuilder.sm.find_role('Admin')
+        tester = self.appbuilder.sm.find_user(username='test_admin')
+        if not tester:
+            self.appbuilder.sm.add_user(
+                username='test_admin',
+                first_name='test_admin',
+                last_name='test_admin',
+                email='test_admin@fab.org',
+                role=role_admin,
+                password='test_admin')
+
+        role_user = self.appbuilder.sm.find_role('User')
+        test_user = self.appbuilder.sm.find_user(username='test_user')
+        if not test_user:
+            self.appbuilder.sm.add_user(
+                username='test_user',
+                first_name='test_user',
+                last_name='test_user',
+                email='test_user@fab.org',
+                role=role_user,
+                password='test_user')
+
+        return self.client.post('/login/', data=dict(
+            username=username,
+            password=password
+        ))
+
+    def logout(self):
+        return self.client.get('/logout/')
+
+    def test_log_success_for_admin(self):
+        self.logout()
+        self.login(username='test_admin',
+                   password='test_admin')
+        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Log by attempts', resp)
+        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
+               'execution_date={}&try_number=1&metadata=null'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('"message":', resp)
+        self.check_content_in_response('"metadata":', resp)
+
+    def test_log_success_for_user(self):
+        self.logout()
+        self.login(username='test_user',
+                   password='test_user')
+        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Log by attempts', resp)
+        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
+               'execution_date={}&try_number=1&metadata=null'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('"message":', resp)
+        self.check_content_in_response('"metadata":', resp)
+
+
 if __name__ == '__main__':
     unittest.main()

From a01be426721bbebf0ed477f512e719569b69d43b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Bili=C5=84ski?= <szymon.bilinski@gmail.com>
Date: Sun, 11 Nov 2018 23:26:29 +0100
Subject: [PATCH 192/808] [AIRFLOW-XXX] Add missing docs for SNS classes
 (#4155)

---
 docs/code.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/code.rst b/docs/code.rst
index 12db9b71b136d..0bf04cfb8f956 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -193,6 +193,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
 .. autoclass:: airflow.contrib.operators.slack_webhook_operator.SlackWebhookOperator
 .. autoclass:: airflow.contrib.operators.snowflake_operator.SnowflakeOperator
+.. autoclass:: airflow.contrib.operators.sns_publish_operator.SnsPublishOperator
 .. autoclass:: airflow.contrib.operators.spark_jdbc_operator.SparkJDBCOperator
 .. autoclass:: airflow.contrib.operators.spark_sql_operator.SparkSqlOperator
 .. autoclass:: airflow.contrib.operators.spark_submit_operator.SparkSubmitOperator
@@ -379,8 +380,10 @@ Community contributed hooks
 '''''''''''''''''''''''''''
 .. Alphabetize this list
 .. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
+.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
 .. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
+.. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
 .. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
 .. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook

From 24dfbd22c08aa5ba90e0c95dace68a1a91008338 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 12 Nov 2018 18:23:49 +0000
Subject: [PATCH 193/808] [AIRFLOW-XXX] Sync changelog between release and
 master branch

---
 UPDATING.md | 130 ++++++++++++++++++++++------------------------------
 1 file changed, 56 insertions(+), 74 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index ace0bdae60f9b..200266bf33d1a 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -3,54 +3,8 @@
 This file documents any backwards-incompatible changes in Airflow and
 assists users migrating to a new version.
 
-## Airflow Master
-
-### DAG level Access Control for new RBAC UI
-
-Extend and enhance new Airflow RBAC UI to support DAG level ACL. Each dag now has two permissions(one for write, one for read) associated('can_dag_edit', 'can_dag_read').
-The admin will create new role, associate the dag permission with the target dag and assign that role to users. That user can only access / view the certain dags on the UI
-that he has permissions on. If a new role wants to access all the dags, the admin could associate dag permissions on an artificial view(``all_dags``) with that role.
-
-We also provide a new cli command(``sync_perm``) to allow admin to auto sync permissions.
-
-
-### min_file_parsing_loop_time config option temporarily disabled
-
-The scheduler.min_file_parsing_loop_time config option has been temporarily removed due to
-some bugs.
-
-### new `sync_parallelism` config option in celery section
-
-The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
-fetch celery task state in parallel. Default value is max(1, number of cores - 1)
-
-### CLI Changes
-
-The ability to manipulate users from the command line has been changed. 'airflow create_user' and 'airflow delete_user' and 'airflow list_users' has been grouped to a single command `airflow users` with optional flags `--create`, `--list` and `--delete`.
-
-Example Usage:
-
-To create a new user:
-```bash
-airflow users --create --username jondoe --lastname doe --firstname jon --email jdoe@apache.org --role Viewer --password test
-```
-
-To list users:
-```bash
-airflow users --list
-```
-
-To delete a user:
-```bash
-airflow users --delete --username jondoe
-```
-
 ## Airflow 1.10.1
 
-### Replace DataProcHook.await calls to DataProcHook.wait
-
-The method name was changed to be compatible with the Python 3.7 async/await keywords
-
 ### StatsD Metrics
 
 The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
@@ -105,6 +59,7 @@ The method name was changed to be compatible with the Python 3.7 async/await key
 ### Setting UTF-8 as default mime_charset in email utils
 
 ### Add a configuration variable(default_dag_run_display_number) to control numbers of dag run for display
+
 Add a configuration variable(default_dag_run_display_number) under webserver section to control num of dag run to show in UI.
 
 ### Default executor for SubDagOperator is changed to SequentialExecutor
@@ -134,11 +89,13 @@ Run `airflow webserver` to start the new UI. This will bring up a log in page, e
 There are five roles created for Airflow by default: Admin, User, Op, Viewer, and Public. To configure roles/permissions, go to the `Security` tab and click `List Roles` in the new UI.
 
 #### Breaking changes
+
 - AWS Batch Operator renamed property queue to job_queue to prevent conflict with the internal queue from CeleryExecutor - AIRFLOW-2542
 - Users created and stored in the old users table will not be migrated automatically. FAB's built-in authentication support must be reconfigured.
 - Airflow dag home page is now `/home` (instead of `/admin`).
 - All ModelViews in Flask-AppBuilder follow a different pattern from Flask-Admin. The `/admin` part of the url path will no longer exist. For example: `/admin/connection` becomes `/connection/list`, `/admin/connection/new` becomes `/connection/add`, `/admin/connection/edit` becomes `/connection/edit`, etc.
 - Due to security concerns, the new webserver will no longer support the features in the `Data Profiling` menu of old UI, including `Ad Hoc Query`, `Charts`, and `Known Events`.
+- HiveServer2Hook.get_results() always returns a list of tuples, even when a single column is queried, as per Python API 2.
 
 ### airflow.contrib.sensors.hdfs_sensors renamed to airflow.contrib.sensors.hdfs_sensor
 
@@ -152,6 +109,7 @@ to have specified `explicit_defaults_for_timestamp=1` in your my.cnf under `[mys
 ### Celery config
 
 To make the config of Airflow compatible with Celery, some properties have been renamed:
+
 ```
 celeryd_concurrency -> worker_concurrency
 celery_result_backend -> result_backend
@@ -159,73 +117,76 @@ celery_ssl_active -> ssl_active
 celery_ssl_cert -> ssl_cert
 celery_ssl_key -> ssl_key
 ```
+
 Resulting in the same config parameters as Celery 4, with more transparency.
 
 ### GCP Dataflow Operators
+
 Dataflow job labeling is now supported in Dataflow{Java,Python}Operator with a default
 "airflow-version" label, please upgrade your google-cloud-dataflow or apache-beam version
 to 2.2.0 or greater.
 
 ### BigQuery Hooks and Operator
+
 The `bql` parameter passed to `BigQueryOperator` and `BigQueryBaseCursor.run_query` has been deprecated and renamed to `sql` for consistency purposes. Using `bql` will still work (and raise a `DeprecationWarning`), but is no longer
 supported and will be removed entirely in Airflow 2.0
 
 ### Redshift to S3 Operator
+
 With Airflow 1.9 or lower, Unload operation always included header row. In order to include header row,
 we need to turn off parallel unload. It is preferred to perform unload operation using all nodes so that it is
 faster for larger tables. So, parameter called `include_header` is added and default is set to False.
-Header row will be added only if this parameter is set True and also in that case parallel will be automatically turned off (`PARALLEL OFF`)  
+Header row will be added only if this parameter is set True and also in that case parallel will be automatically turned off (`PARALLEL OFF`)
 
 ### Google cloud connection string
 
 With Airflow 1.9 or lower, there were two connection strings for the Google Cloud operators, both `google_cloud_storage_default` and `google_cloud_default`. This can be confusing and therefore the `google_cloud_storage_default` connection id has been replaced with `google_cloud_default` to make the connection id consistent across Airflow.
 
 ### Logging Configuration
+
 With Airflow 1.9 or lower, `FILENAME_TEMPLATE`, `PROCESSOR_FILENAME_TEMPLATE`, `LOG_ID_TEMPLATE`, `END_OF_LOG_MARK` were configured in `airflow_local_settings.py`. These have been moved into the configuration file, and hence if you were using a custom configuration file the following defaults need to be added.
+
 ```
 [core]
 fab_logging_level = WARN
-log_filename_template = {{ ti.dag_id }}/{{ ti.task_id }}/{{ ts }}/{{ try_number }}.log
-log_processor_filename_template = {{ filename }}.log
+log_filename_template = {{{{ ti.dag_id }}}}/{{{{ ti.task_id }}}}/{{{{ ts }}}}/{{{{ try_number }}}}.log
+log_processor_filename_template = {{{{ filename }}}}.log
 
 [elasticsearch]
-elasticsearch_log_id_template = {dag_id}-{task_id}-{execution_date}-{try_number}
+elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_number}}
 elasticsearch_end_of_log_mark = end_of_log
 ```
 
-### Custom auth backends interface change
+The previous setting of `log_task_reader` is not needed in many cases now when using the default logging config with remote storages. (Previously it needed to be set to `s3.task` or similar. This is not needed with the default config anymore)
 
-We have updated the version of flask-login we depend upon, and as a result any
-custom auth backends might need a small change: `is_active`,
-`is_authenticated`, and `is_anonymous` should now be properties. What this means is if
-previously you had this in your user class
+#### Change of per-task log path
 
-    def is_active(self):
-      return self.active
-
-then you need to change it like this
+With the change to Airflow core to be timezone aware the default log path for task instances will now include timezone information. This will by default mean all previous task logs won't be found. You can get the old behaviour back by setting the following config options:
 
-    @property
-    def is_active(self):
-      return self.active
+```
+[core]
+log_filename_template = {{ ti.dag_id }}/{{ ti.task_id }}/{{ execution_date.strftime("%%Y-%%m-%%dT%%H:%%M:%%S") }}/{{ try_number }}.log
+```
 
 ## Airflow 1.9
 
 ### SSH Hook updates, along with new SSH Operator & SFTP Operator
 
 SSH Hook now uses the Paramiko library to create an ssh client connection, instead of the sub-process based ssh command execution previously (<1.9.0), so this is backward incompatible.
-  - update SSHHook constructor
-  - use SSHOperator class in place of SSHExecuteOperator which is removed now. Refer to test_ssh_operator.py for usage info.
-  - SFTPOperator is added to perform secure file transfer from serverA to serverB. Refer to test_sftp_operator.py.py for usage info.
-  - No updates are required if you are using ftpHook, it will continue to work as is.
+
+- update SSHHook constructor
+- use SSHOperator class in place of SSHExecuteOperator which is removed now. Refer to test_ssh_operator.py for usage info.
+- SFTPOperator is added to perform secure file transfer from serverA to serverB. Refer to test_sftp_operator.py.py for usage info.
+- No updates are required if you are using ftpHook, it will continue to work as is.
 
 ### S3Hook switched to use Boto3
 
 The airflow.hooks.S3_hook.S3Hook has been switched to use boto3 instead of the older boto (a.k.a. boto2). This results in a few backwards incompatible changes to the following classes: S3Hook:
-  - the constructors no longer accepts `s3_conn_id`. It is now called `aws_conn_id`.
-  - the default connection is now "aws_default" instead of "s3_default"
-  - the return type of objects returned by `get_bucket` is now boto3.s3.Bucket
-  - the return type of `get_key`, and `get_wildcard_key` is now an boto3.S3.Object.
+
+- the constructors no longer accepts `s3_conn_id`. It is now called `aws_conn_id`.
+- the default connection is now "aws_default" instead of "s3_default"
+- the return type of objects returned by `get_bucket` is now boto3.s3.Bucket
+- the return type of `get_key`, and `get_wildcard_key` is now an boto3.S3.Object.
 
 If you are using any of these in your DAGs and specify a connection ID you will need to update the parameter name for the connection to "aws_conn_id": S3ToHiveTransfer, S3PrefixSensor, S3KeySensor, RedshiftToS3Transfer.
 
@@ -401,10 +362,11 @@ The `file_task_handler` logger has been made more flexible. The default format c
 If you are logging to Google cloud storage, please see the [Google cloud platform documentation](https://airflow.incubator.apache.org/integration.html#gcp-google-cloud-platform) for logging instructions.
 
 If you are using S3, the instructions should be largely the same as the Google cloud platform instructions above. You will need a custom logging config. The `REMOTE_BASE_LOG_FOLDER` configuration key in your airflow config has been removed, therefore you will need to take the following steps:
- - Copy the logging configuration from [`airflow/config_templates/airflow_logging_settings.py`](https://github.com/apache/incubator-airflow/blob/master/airflow/config_templates/airflow_local_settings.py).
- - Place it in a directory inside the Python import path `PYTHONPATH`. If you are using Python 2.7, ensuring that any `__init__.py` files exist so that it is importable.
- - Update the config by setting the path of `REMOTE_BASE_LOG_FOLDER` explicitly in the config. The `REMOTE_BASE_LOG_FOLDER` key is not used anymore.
- - Set the `logging_config_class` to the filename and dict. For example, if you place `custom_logging_config.py` on the base of your pythonpath, you will need to set `logging_config_class = custom_logging_config.LOGGING_CONFIG` in your config as Airflow 1.8.
+
+- Copy the logging configuration from [`airflow/config_templates/airflow_logging_settings.py`](https://github.com/apache/incubator-airflow/blob/master/airflow/config_templates/airflow_local_settings.py).
+- Place it in a directory inside the Python import path `PYTHONPATH`. If you are using Python 2.7, ensuring that any `__init__.py` files exist so that it is importable.
+- Update the config by setting the path of `REMOTE_BASE_LOG_FOLDER` explicitly in the config. The `REMOTE_BASE_LOG_FOLDER` key is not used anymore.
+- Set the `logging_config_class` to the filename and dict. For example, if you place `custom_logging_config.py` on the base of your pythonpath, you will need to set `logging_config_class = custom_logging_config.LOGGING_CONFIG` in your config as Airflow 1.8.
 
 ### New Features
 
@@ -413,8 +375,10 @@ If you are using S3, the instructions should be largely the same as the Google c
 A new DaskExecutor allows Airflow tasks to be run in Dask Distributed clusters.
 
 ### Deprecated Features
+
 These features are marked for deprecation. They may still work (and raise a `DeprecationWarning`), but are no longer
 supported and will be removed entirely in Airflow 2.0
+
 - If you're using the `google_cloud_conn_id` or `dataproc_cluster` argument names explicitly in `contrib.operators.Dataproc{*}Operator`(s), be sure to rename them to `gcp_conn_id` or `cluster_name`, respectively. We've renamed these arguments for consistency. (AIRFLOW-1323)
 
 - `post_execute()` hooks now take two arguments, `context` and `result`
@@ -438,30 +402,36 @@ a previously installed version of Airflow before installing 1.8.1.
 ## Airflow 1.8
 
 ### Database
+
 The database schema needs to be upgraded. Make sure to shutdown Airflow and make a backup of your database. To
 upgrade the schema issue `airflow upgradedb`.
 
 ### Upgrade systemd unit files
+
 Systemd unit files have been updated. If you use systemd please make sure to update these.
 
 > Please note that the webserver does not detach properly, this will be fixed in a future version.
 
 ### Tasks not starting although dependencies are met due to stricter pool checking
+
 Airflow 1.7.1 has issues with being able to over subscribe to a pool, ie. more slots could be used than were
 available. This is fixed in Airflow 1.8.0, but due to past issue jobs may fail to start although their
 dependencies are met after an upgrade. To workaround either temporarily increase the amount of slots above
 the amount of queued tasks or use a new pool.
 
 ### Less forgiving scheduler on dynamic start_date
+
 Using a dynamic start_date (e.g. `start_date = datetime.now()`) is not considered a best practice. The 1.8.0 scheduler
 is less forgiving in this area. If you encounter DAGs not being scheduled you can try using a fixed start_date and
 renaming your DAG. The last step is required to make sure you start with a clean slate, otherwise the old schedule can
 interfere.
 
 ### New and updated scheduler options
+
 Please read through the new scheduler options, defaults have changed since 1.7.1.
 
 #### child_process_log_directory
+
 In order to increase the robustness of the scheduler, DAGS are now processed in their own process. Therefore each
 DAG has its own log file for the scheduler. These log files are placed in `child_process_log_directory` which defaults to
 `<AIRFLOW_HOME>/scheduler/latest`. You will need to make sure these log files are removed.
@@ -469,15 +439,18 @@ DAG has its own log file for the scheduler. These log files are placed in `child
 > DAG logs or processor logs ignore and command line settings for log file locations.
 
 #### run_duration
+
 Previously the command line option `num_runs` was used to let the scheduler terminate after a certain amount of
 loops. This is now time bound and defaults to `-1`, which means run continuously. See also num_runs.
 
 #### num_runs
+
 Previously `num_runs` was used to let the scheduler terminate after a certain amount of loops. Now num_runs specifies
 the number of times to try to schedule each DAG file within `run_duration` time. Defaults to `-1`, which means try
 indefinitely. This is only available on the command line.
 
 #### min_file_process_interval
+
 After how much time should an updated DAG be picked up from the filesystem.
 
 #### min_file_parsing_loop_time
@@ -485,9 +458,11 @@ CURRENTLY DISABLED DUE TO A BUG
 How many seconds to wait between file-parsing loops to prevent the logs from being spammed.
 
 #### dag_dir_list_interval
+
 The frequency with which the scheduler should relist the contents of the DAG directory. If while developing +dags, they are not being picked up, have a look at this number and decrease it when necessary.
 
 #### catchup_by_default
+
 By default the scheduler will fill any missing interval DAG Runs between the last execution date and the current date.
 This setting changes that behavior to only execute the latest interval. This can also be specified per DAG as
 `catchup = False / True`. Command line backfills will still work.
@@ -518,6 +493,7 @@ required to whitelist these variables by adding the following to your configurat
      <value>airflow\.ctx\..*</value>
 </property>
 ```
+
 ### Google Cloud Operator and Hook alignment
 
 All Google Cloud Operators and Hooks are aligned and use the same client library. Now you have a single connection
@@ -529,6 +505,7 @@ Also the old P12 key file type is not supported anymore and only the new JSON ke
 account.
 
 ### Deprecated Features
+
 These features are marked for deprecation. They may still work (and raise a `DeprecationWarning`), but are no longer
 supported and will be removed entirely in Airflow 2.0
 
@@ -545,6 +522,7 @@ supported and will be removed entirely in Airflow 2.0
 - The config value secure_mode will default to True which will disable some insecure endpoints/features
 
 ### Known Issues
+
 There is a report that the default of "-1" for num_runs creates an issue where errors are reported while parsing tasks.
 It was not confirmed, but a workaround was found by changing the default back to `None`.
 
@@ -571,7 +549,9 @@ To continue using the default smtp email backend, change the email_backend line
 [email]
 email_backend = airflow.utils.send_email_smtp
 ```
+
 to:
+
 ```
 [email]
 email_backend = airflow.utils.email.send_email_smtp
@@ -584,7 +564,9 @@ To continue using S3 logging, update your config file so:
 ```
 s3_log_folder = s3://my-airflow-log-bucket/logs
 ```
+
 becomes:
+
 ```
 remote_base_log_folder = s3://my-airflow-log-bucket/logs
 remote_log_conn_id = <your desired s3 connection>

From 6c9683cd4a24a5ec57ec3eaffdfa2a962346a764 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 12 Nov 2018 20:49:55 +0000
Subject: [PATCH 194/808] [AIRFLOW-2779] Add project version to license (#4177)

The Incubator PMC requested that we add version information to the
license declarations to cope with the possibility of projects changing
licenses on us in the future.

Where possible I have worked out the version we are actually using, but
where that hasn't been possible and the project is still on the same
license (they all were) I have taken the latest version as of right now

[ci-skip]
---
 LICENSE | 37 +++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/LICENSE b/LICENSE
index 2288b870b4239..7f2532df77c07 100644
--- a/LICENSE
+++ b/LICENSE
@@ -217,9 +217,10 @@ The following components are provided under the Apache 2.0 License.
 See project link for details. The text of each license is also included
 at licenses/LICENSE-[project].txt.
 
-    (ALv2 License) hue (https://github.com/cloudera/hue/)
-    (ALv2 License) jqclock (https://github.com/JohnRDOrazio/jQuery-Clock-Plugin)
-    (ALv2 License) bootstrap3-typeahead (https://github.com/bassjobsen/Bootstrap-3-Typeahead)
+    (ALv2 License) hue v4.3.0 (https://github.com/cloudera/hue/)
+    (ALv2 License) jqclock v2.3.0 (https://github.com/JohnRDOrazio/jQuery-Clock-Plugin)
+    (ALv2 License) bootstrap3-typeahead v4.0.2 (https://github.com/bassjobsen/Bootstrap-3-Typeahead)
+    (ALv2 License) airflow.contrib.auth.backends.github_enterprise_auth
 
 ========================================================================
 MIT licenses
@@ -228,16 +229,16 @@ MIT licenses
 The following components are provided under the MIT License. See project link for details.
 The text of each license is also included at licenses/LICENSE-[project].txt.
 
-    (MIT License) jquery (https://jquery.org/license/)
-    (MIT License) dagre-d3 (https://github.com/cpettitt/dagre-d3)
-    (MIT License) bootstrap (https://github.com/twbs/bootstrap/)
-    (MIT License) d3-tip (https://github.com/Caged/d3-tip)
-    (MIT License) dataTables (https://datatables.net)
-    (MIT License) WebGL-2D (https://github.com/gameclosure/webgl-2d)
-    (MIT License) Underscorejs (http://underscorejs.org)
-    (MIT License) Bootstrap Toggle (http://www.bootstraptoggle.com)
-    (MIT License) normalize.css (http://necolas.github.io/normalize.css/)
-    (MIT License) ElasticMock (https://github.com/vrcmarcos/elasticmock)
+    (MIT License) jquery v2.1.4 (https://jquery.org/license/)
+    (MIT License) dagre-d3 v0.6.1 (https://github.com/cpettitt/dagre-d3)
+    (MIT License) bootstrap v3.2 (https://github.com/twbs/bootstrap/)
+    (MIT License) d3-tip v0.6.3 (https://github.com/Caged/d3-tip)
+    (MIT License) dataTables v1.10.10 (https://datatables.net)
+    (MIT License) WebGL-2D (git-commit 9a7ec26) (https://github.com/gameclosure/webgl-2d)
+    (MIT License) Underscorejs v1.5.0 (http://underscorejs.org)
+    (MIT License) Bootstrap Toggle v2.2.0 (http://www.bootstraptoggle.com)
+    (MIT License) normalize.css v3.0.2 (http://necolas.github.io/normalize.css/)
+    (MIT License) ElasticMock v1.3.2 (https://github.com/vrcmarcos/elasticmock)
 
 ========================================================================
 BSD 2-Clause licenses
@@ -246,7 +247,7 @@ The following components are provided under the BSD 2-Clause license.
 See file headers and project links for details.
 The text of each license is also included at licenses/LICENSE-[project].txt.
 
-    (BSD 2 License) flask-kerberos (https://github.com/mkomitee/flask-kerberos)
+    (BSD 2 License) flask-kerberos v1.0.4 (https://github.com/mkomitee/flask-kerberos)
 
 ========================================================================
 BSD 3-Clause licenses
@@ -254,8 +255,8 @@ BSD 3-Clause licenses
 The following components are provided under the BSD 3-Clause license. See project links for details.
 The text of each license is also included at licenses/LICENSE-[project].txt.
 
-    (BSD 3 License) Ace (https://github.com/ajaxorg/ace)
-    (BSD 3 License) d3js (https://d3js.org)
-    (BSD 3 License) parallel-coordinates (http://syntagmatic.github.com/parallel-coordinates/)
-    (BSD 3 License) scikit-learn (https://github.com/scikit-learn/scikit-learn)
+    (BSD 3 License) Ace v1.1.8 (https://github.com/ajaxorg/ace)
+    (BSD 3 License) d3js v3.5.17 (https://d3js.org)
+    (BSD 3 License) parallel-coordinates v0.7.0 (http://syntagmatic.github.com/parallel-coordinates/)
+    (BSD 3 License) scikit-learn v0.19.1 (https://github.com/scikit-learn/scikit-learn)
 

From 8b4a3038043bd61d4fd22eaecea2ec155d8ba20e Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 12 Nov 2018 21:18:32 +0000
Subject: [PATCH 195/808] [AIRFLOW-2779] Add license headers to doc files
 (#4178)

This adds ASF license headers to all the .rst and .md files with the
exception of the Pull Request template (as that is included verbatim
when opening a Pull Request on Github which would be messy)
---
 CONTRIBUTING.md                               | 19 +++++++++++++++
 README.md                                     | 21 ++++++++++++++++-
 TODO.md                                       | 19 +++++++++++++++
 UPDATING.md                                   | 19 +++++++++++++++
 .../example_dags/example_twitter_README.md    | 19 +++++++++++++++
 .../www/templates/airflow/variables/README.md | 23 +++++++++++++++++--
 dev/README.md                                 | 19 +++++++++++++++
 docs/api.rst                                  | 17 ++++++++++++++
 docs/cli.rst                                  | 17 ++++++++++++++
 docs/code.rst                                 | 17 ++++++++++++++
 docs/concepts.rst                             | 17 ++++++++++++++
 docs/faq.rst                                  | 17 ++++++++++++++
 docs/howto/executor/use-celery.rst            | 17 ++++++++++++++
 docs/howto/executor/use-dask.rst              | 17 ++++++++++++++
 docs/howto/executor/use-mesos.rst             | 17 ++++++++++++++
 docs/howto/index.rst                          | 17 ++++++++++++++
 docs/howto/initialize-database.rst            | 17 ++++++++++++++
 docs/howto/manage-connections.rst             | 17 ++++++++++++++
 docs/howto/operator.rst                       | 17 ++++++++++++++
 docs/howto/run-with-systemd.rst               | 17 ++++++++++++++
 docs/howto/run-with-upstart.rst               | 17 ++++++++++++++
 docs/howto/secure-connections.rst             | 17 ++++++++++++++
 docs/howto/set-config.rst                     | 17 ++++++++++++++
 docs/howto/use-test-config.rst                | 17 ++++++++++++++
 docs/howto/write-logs.rst                     | 17 ++++++++++++++
 docs/index.rst                                | 17 ++++++++++++++
 docs/installation.rst                         | 17 ++++++++++++++
 docs/integration.rst                          | 17 ++++++++++++++
 docs/kubernetes.rst                           | 17 ++++++++++++++
 docs/license.rst                              | 17 ++++++++++++++
 docs/lineage.rst                              | 17 ++++++++++++++
 docs/plugins.rst                              | 17 ++++++++++++++
 docs/profiling.rst                            | 19 +++++++++++++++
 docs/project.rst                              | 17 ++++++++++++++
 docs/scheduler.rst                            | 17 ++++++++++++++
 docs/security.rst                             | 17 ++++++++++++++
 docs/start.rst                                | 17 ++++++++++++++
 docs/timezone.rst                             | 17 ++++++++++++++
 docs/tutorial.rst                             | 17 ++++++++++++++
 docs/ui.rst                                   | 17 ++++++++++++++
 scripts/ci/kubernetes/README.md               | 19 +++++++++++++++
 tests/dags/README.md                          | 19 +++++++++++++++
 tests/test_utils/README.md                    | 21 ++++++++++++++++-
 43 files changed, 757 insertions(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 21cbd5010c4ee..194aaa7b277ca 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Contributing
 
 Contributions are welcome and are greatly appreciated! Every
diff --git a/README.md b/README.md
index f5fe2e1bdcd4c..c1893cfba8013 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,23 @@
-# Airflow
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Apache Airflow (Incubating)
 
 [![PyPI version](https://badge.fury.io/py/apache-airflow.svg)](https://badge.fury.io/py/apache-airflow)
 [![Build Status](https://travis-ci.org/apache/incubator-airflow.svg?branch=master)](https://travis-ci.org/apache/incubator-airflow)
diff --git a/TODO.md b/TODO.md
index cf19035e1b995..1e4e6ed249e1a 100644
--- a/TODO.md
+++ b/TODO.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 #### Roadmap items
 * UI page answering "Why isn't this task instance running?"
 * Attempt removing DagBag caching for the web server
diff --git a/UPDATING.md b/UPDATING.md
index 200266bf33d1a..8336d73cc9337 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Updating Airflow
 
 This file documents any backwards-incompatible changes in Airflow and
diff --git a/airflow/contrib/example_dags/example_twitter_README.md b/airflow/contrib/example_dags/example_twitter_README.md
index 319eac39f6953..28ae9826f1f06 100644
--- a/airflow/contrib/example_dags/example_twitter_README.md
+++ b/airflow/contrib/example_dags/example_twitter_README.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Example Twitter DAG
 
 ***Introduction:*** This example dag depicts a typical ETL process and is a perfect use case automation scenario for Airflow. Please note that the main scripts associated with the tasks are returning None. The purpose of this DAG is to demonstrate how to write a functional DAG within Airflow.
diff --git a/airflow/www/templates/airflow/variables/README.md b/airflow/www/templates/airflow/variables/README.md
index 3fd539f8b54fb..e3b30a1a64b93 100644
--- a/airflow/www/templates/airflow/variables/README.md
+++ b/airflow/www/templates/airflow/variables/README.md
@@ -1,5 +1,24 @@
-## Variable Editor
-----
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Variable Editor
+
 This folder contains forms used to edit values in the "Variable" key-value
 store.  This data can be edited under the "Admin" admin tab, but sometimes
 it is preferable to use a form that can perform checking and provide a nicer
diff --git a/dev/README.md b/dev/README.md
index 084020cfabb66..cd4a932adb468 100755
--- a/dev/README.md
+++ b/dev/README.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Development Tools
 
 ## Airflow Pull Request Tool
diff --git a/docs/api.rst b/docs/api.rst
index 4ea19c8969f92..194809abc6330 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Experimental Rest API
 =====================
 
diff --git a/docs/cli.rst b/docs/cli.rst
index f05cbfbe27ed2..4d68d0eef3b8d 100644
--- a/docs/cli.rst
+++ b/docs/cli.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Command Line Interface
 ======================
 
diff --git a/docs/code.rst b/docs/code.rst
index 0bf04cfb8f956..afa0dc4c112bc 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 API Reference
 =============
 
diff --git a/docs/concepts.rst b/docs/concepts.rst
index f1fd14f5b187b..95f6e6a7a60ae 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Concepts
 ########
 
diff --git a/docs/faq.rst b/docs/faq.rst
index 46212084c58fd..42dfb278f832a 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 FAQ
 ========
 
diff --git a/docs/howto/executor/use-celery.rst b/docs/howto/executor/use-celery.rst
index 0e1bab060b0b2..71cae66a6f5b9 100644
--- a/docs/howto/executor/use-celery.rst
+++ b/docs/howto/executor/use-celery.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Scaling Out with Celery
 =======================
 
diff --git a/docs/howto/executor/use-dask.rst b/docs/howto/executor/use-dask.rst
index 769ce17e01a02..6d3efcb349a76 100644
--- a/docs/howto/executor/use-dask.rst
+++ b/docs/howto/executor/use-dask.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Scaling Out with Dask
 =====================
 
diff --git a/docs/howto/executor/use-mesos.rst b/docs/howto/executor/use-mesos.rst
index c3bf95a63aa36..d67579ddcb96b 100644
--- a/docs/howto/executor/use-mesos.rst
+++ b/docs/howto/executor/use-mesos.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Scaling Out with Mesos (community contributed)
 ==============================================
 
diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index f9f160e6bdbea..8a19a9ecb40a2 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 How-to Guides
 =============
 
diff --git a/docs/howto/initialize-database.rst b/docs/howto/initialize-database.rst
index c85142f35b1c2..fad75be46d25a 100644
--- a/docs/howto/initialize-database.rst
+++ b/docs/howto/initialize-database.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Initializing a Database Backend
 ===============================
 
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 4d0adfb1009dc..9c324d259d776 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Managing Connections
 =====================
 
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 6333e32dd7d67..2c84a7f88e888 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Using Operators
 ===============
 
diff --git a/docs/howto/run-with-systemd.rst b/docs/howto/run-with-systemd.rst
index 1dc138347c37a..131fc3ddc0612 100644
--- a/docs/howto/run-with-systemd.rst
+++ b/docs/howto/run-with-systemd.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Running Airflow with systemd
 ============================
 
diff --git a/docs/howto/run-with-upstart.rst b/docs/howto/run-with-upstart.rst
index c18a203f17b31..adfb85a31effc 100644
--- a/docs/howto/run-with-upstart.rst
+++ b/docs/howto/run-with-upstart.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Running Airflow with upstart
 ============================
 
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index b3b9ba193d295..719db2f3f9655 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Securing Connections
 ====================
 
diff --git a/docs/howto/set-config.rst b/docs/howto/set-config.rst
index fc8d59da189ee..cedce11324124 100644
--- a/docs/howto/set-config.rst
+++ b/docs/howto/set-config.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Setting Configuration Options
 =============================
 
diff --git a/docs/howto/use-test-config.rst b/docs/howto/use-test-config.rst
index 5cb4790287992..4f272afe96f35 100644
--- a/docs/howto/use-test-config.rst
+++ b/docs/howto/use-test-config.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Using the Test Mode Configuration
 =================================
 
diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index 44fefc64809f3..935e79717c971 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Writing Logs
 ============
 
diff --git a/docs/index.rst b/docs/index.rst
index 4cd96eaa74e43..4c18ce5ce6df9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 
 .. image:: img/pin_large.png
     :width: 100
diff --git a/docs/installation.rst b/docs/installation.rst
index 9e9ab3edc289d..5faca5efe4d20 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Installation
 ------------
 
diff --git a/docs/integration.rst b/docs/integration.rst
index 2d9bc84c35928..1ab8e609d0dc2 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Integration
 ===========
 
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 0c8b956ce2317..372b27c009acc 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Kubernetes Executor
 ^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/license.rst b/docs/license.rst
index 3c53035713267..bcb2b76bf3de6 100644
--- a/docs/license.rst
+++ b/docs/license.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 License
 =======
 
diff --git a/docs/lineage.rst b/docs/lineage.rst
index 719ef0115eb0c..c94fe70e045c9 100644
--- a/docs/lineage.rst
+++ b/docs/lineage.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Lineage
 =======
 
diff --git a/docs/plugins.rst b/docs/plugins.rst
index 8173e632e5f3f..61b49577c7eed 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Plugins
 =======
 
diff --git a/docs/profiling.rst b/docs/profiling.rst
index 09102334b1c29..c4f1c0b4869af 100644
--- a/docs/profiling.rst
+++ b/docs/profiling.rst
@@ -1,3 +1,22 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+.. TODO: This section would be removed after we migrate to www_rbac completely.
+
 Data Profiling
 ==============
 
diff --git a/docs/project.rst b/docs/project.rst
index d1f2cc010c939..6e4074f0918ba 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Project
 =======
 
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 84dcc4a7f9db4..72a3d8f7a5cb2 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Scheduling & Triggers
 =====================
 
diff --git a/docs/security.rst b/docs/security.rst
index 1ecc958d52ab4..0be3609073495 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Security
 ========
 
diff --git a/docs/start.rst b/docs/start.rst
index a3e21f93f68de..e3b16b28f7fab 100644
--- a/docs/start.rst
+++ b/docs/start.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Quick Start
 -----------
 
diff --git a/docs/timezone.rst b/docs/timezone.rst
index fe44ecfbb9f62..078f948c4f903 100644
--- a/docs/timezone.rst
+++ b/docs/timezone.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 Time zones
 ==========
 
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index 570cd75c809d9..69670d7b025cf 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 
 Tutorial
 ================
diff --git a/docs/ui.rst b/docs/ui.rst
index 5a09ce5aa0a92..a2f6b8514c89a 100644
--- a/docs/ui.rst
+++ b/docs/ui.rst
@@ -1,3 +1,20 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
 UI / Screenshots
 =================
 The Airflow UI makes it easy to monitor and troubleshoot your data pipelines.
diff --git a/scripts/ci/kubernetes/README.md b/scripts/ci/kubernetes/README.md
index 5d1f9c195c0be..675be9fc4a042 100644
--- a/scripts/ci/kubernetes/README.md
+++ b/scripts/ci/kubernetes/README.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Airflow on Kubernetes
 
 If you don't have minikube installed, please run `./minikube/start_minikube.sh` to start a k8s-instance on your local machine. Make sure that your `kubectl` is pointing to the local k8s instance.
diff --git a/tests/dags/README.md b/tests/dags/README.md
index c5d6acb0f4c2b..615e8ab7f6968 100644
--- a/tests/dags/README.md
+++ b/tests/dags/README.md
@@ -1,3 +1,22 @@
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
 # Unit Tests DAGs Folder
 
 This folder contains DAGs for Airflow unit testing.
diff --git a/tests/test_utils/README.md b/tests/test_utils/README.md
index 8a5c90dfd25f4..a93a0aa34c13c 100644
--- a/tests/test_utils/README.md
+++ b/tests/test_utils/README.md
@@ -1 +1,20 @@
-Utilities for use in tests.
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Utilities for use in tests.

From cc12b35b7797a21706b42dd68d19f53017c1bbe1 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 12 Nov 2018 22:11:33 +0000
Subject: [PATCH 196/808] [AIRFLOW-XXX] Changelog and version for 1.10.1

---
 CHANGELOG.txt      | 4 ++++
 airflow/version.py | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index db77cc2903110..92e62698132b1 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -24,6 +24,7 @@ Improvements:
 [AIRFLOW-2622] Add "confirm=False" option to SFTPOperator
 [AIRFLOW-2662] support affinity & nodeSelector policies for kubernetes executor/operator
 [AIRFLOW-2709] Improve error handling in Databricks hook
+[AIRFLOW-2723] Update lxml dependancy to >= 4.0.
 [AIRFLOW-2763] No precheck mechanism in place during worker initialisation for the connection to metadata database
 [AIRFLOW-2789] Add ability to create single node cluster to DataprocClusterCreateOperator
 [AIRFLOW-2797] Add ability to create Google Dataproc cluster with custom image
@@ -42,6 +43,7 @@ Improvements:
 [AIRFLOW-3025] Allow to specify dns and dns-search parameters for DockerOperator
 [AIRFLOW-3067] (www_rbac) Flask flash messages are not displayed properly (no background color)
 [AIRFLOW-3069] Decode output of S3 file transform operator
+[AIRFLOW-3072] Assign permission get_logs_with_metadata to viewer role
 [AIRFLOW-3090] INFO logs are too verbose
 [AIRFLOW-3103] Update Flask-Login
 [AIRFLOW-3112] Align SFTP hook with SSH hook
@@ -66,6 +68,8 @@ Doc-only changes:
 [AIRFLOW-3030] Command Line docs incorrect subdir
 [AIRFLOW-2990] Docstrings for Hooks/Operators are in incorrect format
 [AIRFLOW-3127] Celery SSL Documentation is out-dated
+[AIRFLOW-2779] Add license headers to doc files
+[AIRFLOW-2779] Add project version to license
 
 Bug fixes:
 
diff --git a/airflow/version.py b/airflow/version.py
index 1080bf44f6953..5521427e4c327 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.1b1'
+version = '1.10.1'

From 7b9911eb9a60ab5423b9f651654d2e066874b439 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 13 Nov 2018 14:01:44 +0000
Subject: [PATCH 197/808] [AIRFLOW-2779] Add license headers to doc files
 (#4178)

This adds ASF license headers to all the .rst and .md files with the
exception of the Pull Request template (as that is included verbatim
when opening a Pull Request on Github which would be messy)
---
 .rat-excludes               | 30 ++++++++++++++++++++++++------
 docs/conf.py                | 20 ++++++++++++++++++++
 scripts/ci/check-license.sh | 24 ++++++------------------
 3 files changed, 50 insertions(+), 24 deletions(-)

diff --git a/.rat-excludes b/.rat-excludes
index c9487dd8c49c1..05f7b98000f89 100644
--- a/.rat-excludes
+++ b/.rat-excludes
@@ -1,16 +1,21 @@
+# Note: these patterns are applied to single files or directories, not full paths
+# coverage/* will ignore any coverage dir, but airflow/www/static/coverage/* will match nothing
+
 .gitignore
 .gitattributes
+.airflowignore
 .coverage
 .coveragerc
 .codecov.yml
+.eslintrc
+.eslintignore
+.flake8
 .rat-excludes
 requirements.txt
 .*log
 .travis.yml
 .*pyc
 .*lock
-docs
-.*md
 dist
 build
 airflow.egg-info
@@ -18,16 +23,23 @@ apache_airflow.egg-info
 .idea
 metastore_db
 .*sql
+.*svg
 .*csv
 CHANGELOG.txt
 .*zip
 .*lock
+# Generated doc files
+.*html
+_build/*
+_static/*
+.buildinfo
+searchindex.js
+
 # Apache Rat does not detect BSD-2 clause properly
 # it is compatible according to http://www.apache.org/legal/resolved.html#category-a
 kerberos_auth.py
 airflow_api_auth_backend_kerberos_auth_py.html
 licenses/*
-airflow/www/static/docs
 parallel.js
 underscore.js
 jquery.dataTables.min.js
@@ -37,6 +49,12 @@ bootstrap-toggle.min.js
 bootstrap-toggle.min.css
 d3.v3.min.js
 ace.js
-airflow/www/static/coverage/*
-airflow/git_version
-scripts/ci/flake8_diff.sh
+node_modules/*
+.*json
+coverage/*
+git_version
+flake8_diff.sh
+
+rat-results.txt
+apache-airflow-.*\+incubating-source.tar.gz.*
+apache-airflow-.*\+incubating-bin.tar.gz.*
diff --git a/docs/conf.py b/docs/conf.py
index 8b5d8305bbb15..fa2a3d2274acb 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,5 +1,25 @@
 # -*- coding: utf-8 -*-
 #
+# flake8: noqa
+# Disable Flake8 because of all the sphinx imports
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 # Airflow documentation build configuration file, created by
 # sphinx-quickstart on Thu Oct  9 20:50:01 2014.
 #
diff --git a/scripts/ci/check-license.sh b/scripts/ci/check-license.sh
index 83c942a0a4f12..035283f9061b5 100755
--- a/scripts/ci/check-license.sh
+++ b/scripts/ci/check-license.sh
@@ -73,6 +73,9 @@ mkdir -p ${TRAVIS_CACHE}/lib
     exit 1
 }
 
+# This is the target of a symlink in airflow/www/static/docs - and rat exclude doesn't cope with the symlink target doesn't exist
+mkdir -p docs/_build/html/
+
 echo "Running license checks. This can take a while."
 $java_cmd -jar "$rat_jar" -E "$FWDIR"/.rat-excludes  -d "$FWDIR" > rat-results.txt
 
@@ -84,24 +87,9 @@ fi
 ERRORS="$(cat rat-results.txt | grep -e "??")"
 
 if test ! -z "$ERRORS"; then
-    echo "Could not find Apache license headers in the following files:"
-    echo "$ERRORS"
-    COUNT=`echo "${ERRORS}" | wc -l`
-    # due to old builds can be removed later
-    rm -rf ${TRAVIS_CACHE}/rat-error-count
-    if [ ! -f ${TRAVIS_CACHE}/rat-error-count-builds ]; then
-        [ "${TRAVIS_PULL_REQUEST}" = "false" ] && echo ${COUNT} > ${TRAVIS_CACHE}/rat-error-count-builds
-        OLD_COUNT=${COUNT}
-    else
-        typeset -i OLD_COUNT=$(cat ${TRAVIS_CACHE}/rat-error-count-builds)
-    fi
-    if [ ${COUNT} -gt ${OLD_COUNT} ]; then
-        echo "New missing licenses (${COUNT} vs ${OLD_COUNT}) detected. Please correct them by adding them to to header of your files"
-        exit 1
-    else
-        [ "${TRAVIS_PULL_REQUEST}" = "false" ] && echo ${COUNT} > ${TRAVIS_CACHE}/rat-error-count-builds
-    fi
-    exit 0
+    echo >&2 "Could not find Apache license headers in the following files:"
+    echo >&2 "$ERRORS"
+    exit 1
 else
     echo -e "RAT checks passed."
 fi

From 456584f7ad64c8d40d18aff0932fe92d84a0b2f9 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 13 Nov 2018 15:17:56 +0000
Subject: [PATCH 198/808] [AIRFLOW-XXX] Correct date and version in Changelog

---
 CHANGELOG.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 92e62698132b1..f7b419177bbd2 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,4 @@
-AIRFLOW 1.10.1b1, 2018-11-09
+AIRFLOW 1.10.1, 2018-11-13
 
 New features:
 

From 17034eed465c8b4ab1ddb25acfba15f8a94f6b75 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 14 Nov 2018 21:35:03 +0000
Subject: [PATCH 199/808] [AIRFLOW-3339] Correctly get DAG timezone when
 start_date in default_args (#4186)

---
 airflow/models.py | 3 ++-
 tests/models.py   | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 1536b37df906f..81d179ba246a3 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -3249,7 +3249,8 @@ def __init__(
                     timezone.parse(self.default_args['start_date'])
                 )
             self.timezone = self.default_args['start_date'].tzinfo
-        else:
+
+        if not hasattr(self, 'timezone') or not self.timezone:
             self.timezone = settings.TIMEZONE
 
         self.start_date = timezone.convert_to_utc(start_date)
diff --git a/tests/models.py b/tests/models.py
index 0c34878ee5696..46b273ddd4665 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -214,6 +214,12 @@ def test_dag_topological_sort(self):
 
         self.assertEquals(tuple(), dag.topological_sort())
 
+    def test_dag_naive_default_args_start_date(self):
+        dag = DAG('DAG', default_args={'start_date': datetime.datetime(2018, 1, 1)})
+        self.assertEqual(dag.timezone, settings.TIMEZONE)
+        dag = DAG('DAG', start_date=datetime.datetime(2018, 1, 1))
+        self.assertEqual(dag.timezone, settings.TIMEZONE)
+
     def test_dag_none_default_args_start_date(self):
         """
         Tests if a start_date of None in default_args

From 31f6775007d5d025dba74753a58209488de58511 Mon Sep 17 00:00:00 2001
From: Bumsoo Kim <bskim45@gmail.com>
Date: Wed, 14 Nov 2018 01:22:52 +0900
Subject: [PATCH 200/808] [AIRFLOW-XXX] Remove duplicated line in Changelog
 (#4181)

---
 CHANGELOG.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index f7b419177bbd2..030a8194cb18a 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -144,7 +144,6 @@ AIRFLOW 1.10.0, 2018-08-03
 [AIRFLOW-2710] Clarify fernet key value in documentation
 [AIRFLOW-2606] Fix DB schema and SQLAlchemy model
 [AIRFLOW-2646] Fix setup.py not to install snakebite on Python3
-[AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead of oauth2client
 [AIRFLOW-2604] Add index to task_fail
 [AIRFLOW-2650] Mark SchedulerJob as succeed when hitting Ctrl-c
 [AIRFLOW-2678] Fix db schema unit test to remove checking fab models

From 52e00329aaf80fa8248f56405a2bf6abfa00da53 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 14 Nov 2018 22:03:45 +0000
Subject: [PATCH 201/808] [AIRFLOW-XXX] Include 3193 in the changelog

---
 CHANGELOG.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 030a8194cb18a..abb0563d71771 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -51,6 +51,7 @@ Improvements:
 [AIRFLOW-3137] Make ProxyFix middleware optional
 [AIRFLOW-3173] Add _cmd options for more password config options
 [AIRFLOW-3177] Change scheduler_heartbeat metric from gauge to counter
+[AIRFLOW-3193] Pin docker requirement version to v3
 [AIRFLOW-3195] Druid Hook: Log ingestion spec and task id
 [AIRFLOW-3197] EMR Hook is missing some parameters to valid on the AWS API
 [AIRFLOW-3232] Make documentation for GCF Functions operator more readable

From 76a5fc4d2eb3c214ca25406f03b4a0c5d7250f71 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 14 Nov 2018 22:06:03 +0000
Subject: [PATCH 202/808] [AIRFLOW-3343] Update DockerOperator for Docker-py
 3.0.0 API changes (#4187)

The API of `wait()` changed to return a dict, not just a number so this
Operator wasn't actually working, but the tests were passing because the
return was mocked in-correctly.

I also removed `shm_size` from kwargs passed to BaseOperator to avoid
the deprecation warning about unknown args.
---
 airflow/operators/docker_operator.py    | 14 +++++++++-----
 setup.py                                |  2 +-
 tests/operators/test_docker_operator.py | 12 ++++++------
 3 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index 727507b270c42..04dbcab5691cf 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -104,6 +104,9 @@ class DockerOperator(BaseOperator):
     :type xcom_all: bool
     :param docker_conn_id: ID of the Airflow connection to use
     :type docker_conn_id: str
+    :param shm_size: Size of ``/dev/shm`` in bytes. The size must be
+        greater than 0. If omitted uses system default.
+    :type shm_size: int
     """
     template_fields = ('command', 'environment',)
     template_ext = ('.sh', '.bash',)
@@ -134,6 +137,7 @@ def __init__(
             docker_conn_id=None,
             dns=None,
             dns_search=None,
+            shm_size=None,
             *args,
             **kwargs):
 
@@ -161,7 +165,7 @@ def __init__(
         self.xcom_push_flag = xcom_push
         self.xcom_all = xcom_all
         self.docker_conn_id = docker_conn_id
-        self.shm_size = kwargs.get('shm_size')
+        self.shm_size = shm_size
 
         self.cli = None
         self.container = None
@@ -191,7 +195,7 @@ def execute(self, context):
         if self.force_pull or len(self.cli.images(name=self.image)) == 0:
             self.log.info('Pulling docker image %s', self.image)
             for l in self.cli.pull(self.image, stream=True):
-                output = json.loads(l.decode('utf-8'))
+                output = json.loads(l.decode('utf-8').strip())
                 if 'status' in output:
                     self.log.info("%s", output['status'])
 
@@ -223,9 +227,9 @@ def execute(self, context):
                     line = line.decode('utf-8')
                 self.log.info(line)
 
-            exit_code = self.cli.wait(self.container['Id'])
-            if exit_code != 0:
-                raise AirflowException('docker container failed')
+            result = self.cli.wait(self.container['Id'])
+            if result['StatusCode'] != 0:
+                raise AirflowException('docker container failed: ' + repr(result))
 
             if self.xcom_push_flag:
                 return self.cli.logs(container=self.container['Id']) \
diff --git a/setup.py b/setup.py
index fca659689958c..ee3935b76c271 100644
--- a/setup.py
+++ b/setup.py
@@ -157,7 +157,7 @@ def write_version(filename=os.path.join(*['airflow',
     'sphinx-rtd-theme>=0.1.6',
     'Sphinx-PyPI-upload>=0.2.1'
 ]
-docker = ['docker>=3.0.0']
+docker = ['docker~=3.0']
 druid = ['pydruid>=0.4.1']
 elasticsearch = [
     'elasticsearch>=5.0.0,<6.0.0',
diff --git a/tests/operators/test_docker_operator.py b/tests/operators/test_docker_operator.py
index d57a7cd132a16..b9154456b9b31 100644
--- a/tests/operators/test_docker_operator.py
+++ b/tests/operators/test_docker_operator.py
@@ -51,7 +51,7 @@ def test_execute(self, client_class_mock, mkdtemp_mock):
         client_mock.images.return_value = []
         client_mock.logs.return_value = ['container log']
         client_mock.pull.return_value = [b'{"status":"pull log"}']
-        client_mock.wait.return_value = 0
+        client_mock.wait.return_value = {"StatusCode": 0}
 
         client_class_mock.return_value = client_mock
 
@@ -96,7 +96,7 @@ def test_execute_tls(self, client_class_mock, tls_class_mock):
         client_mock.images.return_value = []
         client_mock.logs.return_value = []
         client_mock.pull.return_value = []
-        client_mock.wait.return_value = 0
+        client_mock.wait.return_value = {"StatusCode": 0}
 
         client_class_mock.return_value = client_mock
         tls_mock = mock.Mock()
@@ -122,7 +122,7 @@ def test_execute_unicode_logs(self, client_class_mock):
         client_mock.images.return_value = []
         client_mock.logs.return_value = ['unicode container log 😁']
         client_mock.pull.return_value = []
-        client_mock.wait.return_value = 0
+        client_mock.wait.return_value = {"StatusCode": 0}
 
         client_class_mock.return_value = client_mock
 
@@ -144,7 +144,7 @@ def test_execute_container_fails(self, client_class_mock):
         client_mock.images.return_value = []
         client_mock.logs.return_value = []
         client_mock.pull.return_value = []
-        client_mock.wait.return_value = 1
+        client_mock.wait.return_value = {"StatusCode": 1}
 
         client_class_mock.return_value = client_mock
 
@@ -172,7 +172,7 @@ def test_execute_no_docker_conn_id_no_hook(self, operator_client_mock):
         client_mock.create_container.return_value = {'Id': 'some_id'}
         client_mock.logs.return_value = []
         client_mock.pull.return_value = []
-        client_mock.wait.return_value = 0
+        client_mock.wait.return_value = {"StatusCode": 0}
         operator_client_mock.return_value = client_mock
 
         # Create the DockerOperator
@@ -207,7 +207,7 @@ def test_execute_with_docker_conn_id_use_hook(self, operator_client_mock,
         client_mock.create_container.return_value = {'Id': 'some_id'}
         client_mock.logs.return_value = []
         client_mock.pull.return_value = []
-        client_mock.wait.return_value = 0
+        client_mock.wait.return_value = {"StatusCode": 0}
         operator_client_mock.return_value = client_mock
 
         # Create the DockerOperator

From 2ff994fd9efca5243933559a0bedac784121c1b5 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 9 Oct 2018 23:01:58 +0800
Subject: [PATCH 203/808] [AIRFLOW-3175] Fix docstring format in
 airflow/jobs.py (#4025)

These docstrings could not parsed properly in Sphinx syntax
---
 airflow/jobs.py | 35 +++++++++++++++++++++++------------
 1 file changed, 23 insertions(+), 12 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 03610bd983607..1faf9e2d034b7 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -349,10 +349,10 @@ def _launch_process(result_queue,
         :param file_path: the file to process
         :type file_path: unicode
         :param pickle_dags: whether to pickle the DAGs found in the file and
-        save them to the DB
+            save them to the DB
         :type pickle_dags: bool
         :param dag_id_white_list: if specified, only examine DAG ID's that are
-        in this list
+            in this list
         :type dag_id_white_list: list[unicode]
         :param thread_name: the name to use for the process that is launched
         :type thread_name: unicode
@@ -424,6 +424,7 @@ def start(self):
     def terminate(self, sigkill=False):
         """
         Terminate (and then kill) the process launched to process the file.
+        
         :param sigkill: whether to issue a SIGKILL if SIGTERM doesn't work.
         :type sigkill: bool
         """
@@ -452,6 +453,7 @@ def pid(self):
     def exit_code(self):
         """
         After the process is finished, this can be called to get the return code
+        
         :return: the exit code of the process
         :rtype: int
         """
@@ -463,6 +465,7 @@ def exit_code(self):
     def done(self):
         """
         Check if the process launched to process this file is done.
+        
         :return: whether the process is finished running
         :rtype: bool
         """
@@ -544,16 +547,18 @@ def __init__(
         :param dag_ids: if specified, only schedule tasks with these DAG IDs
         :type dag_ids: list[unicode]
         :param subdir: directory containing Python files with Airflow DAG
-        definitions, or a specific path to a file
+            definitions, or a specific path to a file
         :type subdir: unicode
         :param num_runs: The number of times to try to schedule each DAG file.
-        -1 for unlimited within the run_duration.
+            -1 for unlimited within the run_duration.
+        :type num_runs: int
         :param processor_poll_interval: The number of seconds to wait between
-        polls of running processors
+            polls of running processors
+        :type processor_poll_interval: int
         :param run_duration: how long to run (in seconds) before exiting
         :type run_duration: int
         :param do_pickle: once a DAG object is obtained by executing the Python
-        file, whether to serialize the DAG object to the DB
+            file, whether to serialize the DAG object to the DB
         :type do_pickle: bool
         """
         # for BaseJob compatibility
@@ -783,7 +788,7 @@ def update_import_errors(session, dagbag):
     def create_dag_run(self, dag, session=None):
         """
         This method checks whether a new DagRun needs to be created
-        for a DAG based on scheduling interval
+        for a DAG based on scheduling interval.
         Returns DagRun if one is scheduled. Otherwise returns None.
         """
         if dag.schedule_interval:
@@ -991,7 +996,7 @@ def _change_state_for_tis_without_dagrun(self,
         :param new_state: set TaskInstances to this state
         :type new_state: State
         :param simple_dag_bag: TaskInstances associated with DAGs in the
-        simple_dag_bag and with states in the old_state will be examined
+            simple_dag_bag and with states in the old_state will be examined
         :type simple_dag_bag: SimpleDagBag
         """
         tis_changed = 0
@@ -1062,7 +1067,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         dag concurrency, executor state, and priority.
 
         :param simple_dag_bag: TaskInstances associated with DAGs in the
-        simple_dag_bag will be fetched from the DB and executed
+            simple_dag_bag will be fetched from the DB and executed
         :type simple_dag_bag: SimpleDagBag
         :param executor: the executor that runs task instances
         :type executor: BaseExecutor
@@ -1373,7 +1378,7 @@ def _execute_task_instances(self,
         3. Enqueue the TIs in the executor.
 
         :param simple_dag_bag: TaskInstances associated with DAGs in the
-        simple_dag_bag will be fetched from the DB and executed
+            simple_dag_bag will be fetched from the DB and executed
         :type simple_dag_bag: SimpleDagBag
         :param states: Execute TaskInstances in these states
         :type states: Tuple[State]
@@ -1482,7 +1487,7 @@ def _log_file_processing_stats(self,
         Print out stats about how files are getting processed.
 
         :param known_file_paths: a list of file paths that may contain Airflow
-        DAG definitions
+            DAG definitions
         :type known_file_paths: list[unicode]
         :param processor_manager: manager for the file processors
         :type stats: DagFileProcessorManager
@@ -1788,7 +1793,7 @@ def process_file(self, file_path, pickle_dags=False, session=None):
         :param file_path: the path to the Python file that should be executed
         :type file_path: unicode
         :param pickle_dags: whether serialize the DAGs found in the file and
-        save them to the db
+            save them to the db
         :type pickle_dags: bool
         :return: a list of SimpleDags made from the Dags found in the file
         :rtype: list[SimpleDag]
@@ -2027,6 +2032,7 @@ def _update_counters(self, ti_status):
         """
         Updates the counters per state of the tasks that were running. Can re-add
         to tasks to run in case required.
+        
         :param ti_status: the internal status of the backfill job tasks
         :type ti_status: BackfillJob._DagRunTaskStatus
         """
@@ -2071,6 +2077,7 @@ def _manage_executor_state(self, running):
         """
         Checks if the executor agrees with the state of task instances
         that are running
+        
         :param running: dict of key, task to verify
         """
         executor = self.executor
@@ -2102,6 +2109,7 @@ def _get_dag_run(self, run_date, session=None):
         Returns a dag run for the given run date, which will be matched to an existing
         dag run if available or create a new dag run otherwise. If the max_active_runs
         limit is reached, this function will return None.
+        
         :param run_date: the execution date for the dag run
         :type run_date: datetime
         :param session: the database session object
@@ -2161,6 +2169,7 @@ def _task_instances_for_dag_run(self, dag_run, session=None):
         """
         Returns a map of task instance key to task instance object for the tasks to
         run in the given dag run.
+        
         :param dag_run: the dag run to get the tasks from
         :type dag_run: models.DagRun
         :param session: the database session object
@@ -2226,6 +2235,7 @@ def _process_backfill_task_instances(self,
         Process a set of task instances from a set of dag runs. Special handling is done
         to account for different task instance states that could be present when running
         them in a backfill process.
+        
         :param ti_status: the internal status of the job
         :type ti_status: BackfillJob._DagRunTaskStatus
         :param executor: the executor to run the task instances
@@ -2463,6 +2473,7 @@ def _execute_for_run_dates(self, run_dates, ti_status, executor, pickle_id,
         Computes the dag runs and their respective task instances for
         the given run dates and executes the task instances.
         Returns a list of execution dates of the dag runs that were executed.
+        
         :param run_dates: Execution dates for dag runs
         :type run_dates: list
         :param ti_status: internal BackfillJob status structure to tis track progress

From 0c28b60dfba53eccf69fc99cab25c57d6aded7ad Mon Sep 17 00:00:00 2001
From: Jacob Greenfield <xales@naveria.com>
Date: Wed, 3 Oct 2018 18:16:20 -0400
Subject: [PATCH 204/808] [AIRFLOW-3004] Add config disabling scheduler cron
 (#3899)

---
 airflow/config_templates/default_airflow.cfg | 4 ++++
 airflow/jobs.py                              | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 07a9458073dae..ae09f26adec38 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -480,6 +480,10 @@ max_threads = 2
 
 authenticate = False
 
+# Turn off scheduler use of cron intervals by setting this to False.
+# DAGs submitted manually in the web UI or with trigger_dag will still run.
+use_job_schedule = True
+
 [ldap]
 # set this to ldaps://<your.ldap.server>:<port>
 uri =
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 1faf9e2d034b7..e94eedef8d686 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -791,7 +791,7 @@ def create_dag_run(self, dag, session=None):
         for a DAG based on scheduling interval.
         Returns DagRun if one is scheduled. Otherwise returns None.
         """
-        if dag.schedule_interval:
+        if dag.schedule_interval and conf.getboolean('scheduler', 'USE_JOB_SCHEDULE'):
             active_runs = DagRun.find(
                 dag_id=dag.dag_id,
                 state=State.RUNNING,

From 5cb7fa599f81d1545c98821bfa861b447495ccbb Mon Sep 17 00:00:00 2001
From: Chengzhi Zhao <chengzhizhao@meetup.com>
Date: Thu, 9 Aug 2018 21:24:48 -0400
Subject: [PATCH 205/808] [AIRFLOW-2882] Add import and export for pool cli
 using JSON

---
 airflow/bin/cli.py | 56 +++++++++++++++++++++++++++++++++++++++++++++-
 tests/core.py      | 36 +++++++++++++++++++++++++++++
 2 files changed, 91 insertions(+), 1 deletion(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 2940d2e1232d1..1b0bf936279f0 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -271,6 +271,7 @@ def _tabulate(pools):
                                  tablefmt="fancy_grid")
 
     try:
+        imp = getattr(args, 'import')
         if args.get is not None:
             pools = [api_client.get_pool(name=args.get)]
         elif args.set:
@@ -279,6 +280,14 @@ def _tabulate(pools):
                                             description=args.set[2])]
         elif args.delete:
             pools = [api_client.delete_pool(name=args.delete)]
+        elif imp:
+            if os.path.exists(imp):
+                pools = pool_import_helper(imp)
+            else:
+                print("Missing pools file.")
+                pools = api_client.get_pools()
+        elif args.export:
+            pools = pool_export_helper(args.export)
         else:
             pools = api_client.get_pools()
     except (AirflowException, IOError) as err:
@@ -287,6 +296,43 @@ def _tabulate(pools):
         log.info(_tabulate(pools=pools))
 
 
+def pool_import_helper(filepath):
+    with open(filepath, 'r') as poolfile:
+        pl = poolfile.read()
+    try:
+        d = json.loads(pl)
+    except Exception as e:
+        print("Please check the validity of the json file: " + str(e))
+    else:
+        try:
+            pools = []
+            n = 0
+            for k, v in d.items():
+                if isinstance(v, dict) and len(v) == 2:
+                    pools.append(api_client.create_pool(name=k,
+                                                        slots=v["slots"],
+                                                        description=v["description"]))
+                    n += 1
+                else:
+                    pass
+        except Exception:
+            pass
+        finally:
+            print("{} of {} pool(s) successfully updated.".format(n, len(d)))
+            return pools
+
+
+def pool_export_helper(filepath):
+    pool_dict = {}
+    pools = api_client.get_pools()
+    for pool in pools:
+        pool_dict[pool[0]] = {"slots": pool[1], "description": pool[2]}
+    with open(filepath, 'w') as poolfile:
+        poolfile.write(json.dumps(pool_dict, sort_keys=True, indent=4))
+    print("{} pools successfully exported to {}".format(len(pool_dict), filepath))
+    return pools
+
+
 @cli_utils.action_logging
 def variables(args):
     if args.get:
@@ -1448,6 +1494,14 @@ class CLIFactory(object):
             ("-x", "--delete"),
             metavar="NAME",
             help="Delete a pool"),
+        'pool_import': Arg(
+            ("-i", "--import"),
+            metavar="FILEPATH",
+            help="Import pool from JSON file"),
+        'pool_export': Arg(
+            ("-e", "--export"),
+            metavar="FILEPATH",
+            help="Export pool to JSON file"),
         # variables
         'set': Arg(
             ("-s", "--set"),
@@ -1762,7 +1816,7 @@ class CLIFactory(object):
         }, {
             'func': pool,
             'help': "CRUD operations on pools",
-            "args": ('pool_set', 'pool_get', 'pool_delete'),
+            "args": ('pool_set', 'pool_get', 'pool_delete', 'pool_import', 'pool_export'),
         }, {
             'func': variables,
             'help': "CRUD operations on variables",
diff --git a/tests/core.py b/tests/core.py
index f466c4c4f94db..60bfee69df7dd 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1430,6 +1430,42 @@ def test_pool_no_args(self):
         except Exception as e:
             self.fail("The 'pool' command raised unexpectedly: %s" % e)
 
+    def test_pool_import_export(self):
+        # Create two pools first
+        pool_config_input = {
+            "foo": {
+                "description": "foo_test",
+                "slots": 1
+            },
+            "baz": {
+                "description": "baz_test",
+                "slots": 2
+            }
+        }
+        with open('pools_import.json', mode='w') as f:
+            json.dump(pool_config_input, f)
+
+        # Import json
+        try:
+            cli.pool(self.parser.parse_args(['pool', '-i', 'pools_import.json']))
+        except Exception as e:
+            self.fail("The 'pool -i pools_import.json' failed: %s" % e)
+
+        # Export json
+        try:
+            cli.pool(self.parser.parse_args(['pool', '-e', 'pools_export.json']))
+        except Exception as e:
+            self.fail("The 'pool -e pools_export.json' failed: %s" % e)
+
+        with open('pools_export.json', mode='r') as f:
+            pool_config_output = json.load(f)
+            self.assertEqual(
+                pool_config_input,
+                pool_config_output,
+                "Input and output pool files are not same")
+        os.remove('pools_import.json')
+        os.remove('pools_export.json')
+
     def test_variables(self):
         # Checks if all subcommands are properly received
         cli.variables(self.parser.parse_args([

From a521266851d450bbea97d7e9d0d22247573d676d Mon Sep 17 00:00:00 2001
From: XD-DENG <xd_deng@hotmail.com>
Date: Sat, 28 Jul 2018 20:48:17 +0100
Subject: [PATCH 206/808] [AIRFLOW-2814] Fix inconsistent default config

value of min_file_process_interval in config
template is 0
However it's supposed to be 180 according to
airflow/jobs.py line 592

Closes #3659 from XD-DENG/patch-3
---
 airflow/config_templates/default_airflow.cfg | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index ae09f26adec38..150ac5673aba5 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -432,8 +432,8 @@ scheduler_heartbeat_sec = 5
 # -1 indicates to run continuously (see also num_runs)
 run_duration = -1
 
-# after how much time a new DAGs should be picked up from the filesystem
-min_file_process_interval = 0
+# after how much time (seconds) a new DAGs should be picked up from the filesystem
+min_file_process_interval = 180
 
 # How often (in seconds) to scan the DAGs directory for new files. Default to 5 minutes.
 dag_dir_list_interval = 300

From 2d386cd4aef0cb795fc374b7cf31c5a898cec96d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 3 Aug 2018 09:27:06 +0100
Subject: [PATCH 207/808] Revert [AIRFLOW-2814] - Change
 `min_file_process_interval` to 0 (#3669)

- Change the time (in seconds) after which a new DAG should be picked up from the filesystem
---
 airflow/config_templates/default_airflow.cfg | 2 +-
 airflow/jobs.py                              | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 150ac5673aba5..d8a05e5c8cd84 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -433,7 +433,7 @@ scheduler_heartbeat_sec = 5
 run_duration = -1
 
 # after how much time (seconds) a new DAGs should be picked up from the filesystem
-min_file_process_interval = 180
+min_file_process_interval = 0
 
 # How often (in seconds) to scan the DAGs directory for new files. Default to 5 minutes.
 dag_dir_list_interval = 300
diff --git a/airflow/jobs.py b/airflow/jobs.py
index e94eedef8d686..4d74648bbab55 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -596,8 +596,7 @@ def __init__(
         # 30 seconds.
         self.print_stats_interval = conf.getint('scheduler',
                                                 'print_stats_interval')
-        # Parse and schedule each file no faster than this interval. Default
-        # to 3 minutes.
+
         self.file_process_interval = file_process_interval
 
         self.max_tis_per_query = conf.getint('scheduler', 'max_tis_per_query')

From e43c14a0a2987f8616bec86cd533c24c6c34aaff Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 1 Oct 2018 06:15:20 -0400
Subject: [PATCH 208/808] [AIRFLOW-3129] Improve test coverage of
 airflow.models. (#3982)

---
 airflow/models.py |  25 -------
 tests/models.py   | 181 +++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 180 insertions(+), 26 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 81d179ba246a3..0a03ea979223a 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -594,21 +594,6 @@ def dagbag_report(self):
             table=pprinttable(stats),
         )
 
-    @provide_session
-    def deactivate_inactive_dags(self, session=None):
-        active_dag_ids = [dag.dag_id for dag in list(self.dags.values())]
-        for dag in session.query(
-                DagModel).filter(~DagModel.dag_id.in_(active_dag_ids)).all():
-            dag.is_active = False
-            session.merge(dag)
-        session.commit()
-
-    @provide_session
-    def paused_dags(self, session=None):
-        dag_ids = [dp.dag_id for dp in session.query(DagModel).filter(
-            DagModel.is_paused.__eq__(True))]
-        return dag_ids
-
 
 class User(Base):
     __tablename__ = "users"
@@ -4135,16 +4120,6 @@ def add_tasks(self, tasks):
         for task in tasks:
             self.add_task(task)
 
-    @provide_session
-    def db_merge(self, session=None):
-        BO = BaseOperator
-        tasks = session.query(BO).filter(BO.dag_id == self.dag_id).all()
-        for t in tasks:
-            session.delete(t)
-        session.commit()
-        session.merge(self)
-        session.commit()
-
     def run(
             self,
             start_date=None,
diff --git a/tests/models.py b/tests/models.py
index 46b273ddd4665..8375a95a30760 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -44,17 +44,20 @@
 from airflow.models import clear_task_instances
 from airflow.models import XCom
 from airflow.models import Connection
+from airflow.models import SkipMixin
+from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.jobs import LocalTaskJob
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.python_operator import PythonOperator
 from airflow.operators.python_operator import ShortCircuitOperator
+from airflow.operators.subdag_operator import SubDagOperator
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
 from airflow.utils import timezone
 from airflow.utils.weight_rule import WeightRule
 from airflow.utils.state import State
 from airflow.utils.trigger_rule import TriggerRule
-from mock import patch, ANY
+from mock import patch, Mock, ANY
 from parameterized import parameterized
 from tempfile import mkdtemp, NamedTemporaryFile
 
@@ -640,6 +643,38 @@ def test_following_previous_schedule_daily_dag_CET_to_CEST(self):
         self.assertEqual(prev_local.isoformat(), "2018-03-24T03:00:00+01:00")
         self.assertEqual(prev.isoformat(), "2018-03-24T02:00:00+00:00")
 
+    @patch('airflow.models.timezone.utcnow')
+    def test_sync_to_db(self, mock_now):
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+        )
+        with dag:
+            DummyOperator(task_id='task', owner='owner1')
+            SubDagOperator(
+                task_id='subtask',
+                owner='owner2',
+                subdag=DAG(
+                    'dag.subtask',
+                    start_date=DEFAULT_DATE,
+                )
+            )
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        session = settings.Session()
+        dag.sync_to_db(session=session)
+
+        orm_dag = session.query(DagModel).filter(DagModel.dag_id == 'dag').one()
+        self.assertEqual(set(orm_dag.owners.split(', ')), {'owner1', 'owner2'})
+        self.assertEqual(orm_dag.last_scheduler_run, now)
+        self.assertTrue(orm_dag.is_active)
+
+        orm_subdag = session.query(DagModel).filter(
+            DagModel.dag_id == 'dag.subtask').one()
+        self.assertEqual(set(orm_subdag.owners.split(', ')), {'owner1', 'owner2'})
+        self.assertEqual(orm_subdag.last_scheduler_run, now)
+        self.assertTrue(orm_subdag.is_active)
+
 
 class DagStatTest(unittest.TestCase):
     def test_dagstats_crud(self):
@@ -690,6 +725,25 @@ def test_dagstats_crud(self):
         for stat in res:
             self.assertFalse(stat.dirty)
 
+    def test_update_exception(self):
+        session = Mock()
+        (session.query.return_value
+            .filter.return_value
+            .with_for_update.return_value
+            .all.side_effect) = RuntimeError('it broke')
+        DagStat.update(session=session)
+        session.rollback.assert_called()
+
+    def test_set_dirty_exception(self):
+        session = Mock()
+        session.query.return_value.filter.return_value.all.return_value = []
+        (session.query.return_value
+            .filter.return_value
+            .with_for_update.return_value
+            .all.side_effect) = RuntimeError('it broke')
+        DagStat.set_dirty('dag', session)
+        session.rollback.assert_called()
+
 
 class DagRunTest(unittest.TestCase):
 
@@ -2465,6 +2519,35 @@ def success_handler(self, context):
         ti.refresh_from_db()
         self.assertEqual(ti.state, State.SUCCESS)
 
+    @patch('airflow.models.send_email')
+    def test_email_alert(self, mock_send_email):
+        task = DummyOperator(task_id='op', email='test@test.test')
+        ti = TI(task=task, execution_date=datetime.datetime.now())
+        ti.email_alert(RuntimeError('it broke'))
+
+        self.assertTrue(mock_send_email.called)
+        (email, title, body), _ = mock_send_email.call_args
+        self.assertEqual(email, 'test@test.test')
+        self.assertIn(repr(ti), title)
+        self.assertIn('it broke', body)
+
+    def test_set_duration(self):
+        task = DummyOperator(task_id='op', email='test@test.test')
+        ti = TI(
+            task=task,
+            execution_date=datetime.datetime.now(),
+        )
+        ti.start_date = datetime.datetime(2018, 10, 1, 1)
+        ti.end_date = datetime.datetime(2018, 10, 1, 2)
+        ti.set_duration()
+        self.assertEqual(ti.duration, 3600)
+
+    def test_set_duration_empty_dates(self):
+        task = DummyOperator(task_id='op', email='test@test.test')
+        ti = TI(task=task, execution_date=datetime.datetime.now())
+        ti.set_duration()
+        self.assertIsNone(ti.duration)
+
 
 class ClearTasksTest(unittest.TestCase):
 
@@ -2819,3 +2902,99 @@ def test_connection_from_uri_with_extras(self):
         self.assertEqual(connection.port, 1234)
         self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
                                                        'extra2': '/path/'})
+
+
+class TestSkipMixin(unittest.TestCase):
+
+    @patch('airflow.models.timezone.utcnow')
+    def test_skip(self, mock_now):
+        session = settings.Session()
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+        )
+        with dag:
+            tasks = [DummyOperator(task_id='task')]
+        dag_run = dag.create_dagrun(
+            run_id='manual__' + now.isoformat(),
+            state=State.FAILED,
+        )
+        SkipMixin().skip(
+            dag_run=dag_run,
+            execution_date=now,
+            tasks=tasks,
+            session=session)
+
+        session.query(TI).filter(
+            TI.dag_id == 'dag',
+            TI.task_id == 'task',
+            TI.state == State.SKIPPED,
+            TI.start_date == now,
+            TI.end_date == now,
+        ).one()
+
+    @patch('airflow.models.timezone.utcnow')
+    def test_skip_none_dagrun(self, mock_now):
+        session = settings.Session()
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+        )
+        with dag:
+            tasks = [DummyOperator(task_id='task')]
+        SkipMixin().skip(
+            dag_run=None,
+            execution_date=now,
+            tasks=tasks,
+            session=session)
+
+        session.query(TI).filter(
+            TI.dag_id == 'dag',
+            TI.task_id == 'task',
+            TI.state == State.SKIPPED,
+            TI.start_date == now,
+            TI.end_date == now,
+        ).one()
+
+    def test_skip_none_tasks(self):
+        session = Mock()
+        SkipMixin().skip(dag_run=None, execution_date=None, tasks=[], session=session)
+        self.assertFalse(session.query.called)
+        self.assertFalse(session.commit.called)
+
+
+class TestKubeResourceVersion(unittest.TestCase):
+
+    def test_checkpoint_resource_version(self):
+        session = settings.Session()
+        KubeResourceVersion.checkpoint_resource_version('7', session)
+        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '7')
+
+    def test_reset_resource_version(self):
+        session = settings.Session()
+        version = KubeResourceVersion.reset_resource_version(session)
+        self.assertEqual(version, '0')
+        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '0')
+
+
+class TestKubeWorkerIdentifier(unittest.TestCase):
+
+    @patch('airflow.models.uuid.uuid4')
+    def test_get_or_create_not_exist(self, mock_uuid):
+        session = settings.Session()
+        session.query(KubeWorkerIdentifier).update({
+            KubeWorkerIdentifier.worker_uuid: ''
+        })
+        mock_uuid.return_value = 'abcde'
+        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
+        self.assertEqual(worker_uuid, 'abcde')
+
+    def test_get_or_create_exist(self):
+        session = settings.Session()
+        KubeWorkerIdentifier.checkpoint_kube_worker_uuid('fghij', session)
+        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
+        self.assertEqual(worker_uuid, 'fghij')

From 2a37694121b4646e055ded5a7d56fccea232fbe5 Mon Sep 17 00:00:00 2001
From: Kevin Yang <yrqls21@gmail.com>
Date: Fri, 26 Oct 2018 01:37:10 -0700
Subject: [PATCH 209/808] [Airflow-2760] Decouple DAG parsing loop from
 scheduler loop (#3873)

---
 UPDATING.md                                   |  10 +
 .../airflow_local_settings.py                 |  43 +-
 airflow/config_templates/default_airflow.cfg  |   1 +
 airflow/config_templates/default_test.cfg     |   1 +
 airflow/executors/base_executor.py            |   2 +-
 airflow/jobs.py                               | 378 ++++------
 airflow/models.py                             |  53 +-
 airflow/utils/dag_processing.py               | 676 +++++++++++++++++-
 docs/img/scheduler_loop.jpg                   | Bin 0 -> 46864 bytes
 docs/scheduler.rst                            |   5 +-
 tests/jobs.py                                 | 148 ++--
 tests/models.py                               |  78 +-
 tests/utils/test_dag_processing.py            | 137 +++-
 13 files changed, 1108 insertions(+), 424 deletions(-)
 create mode 100644 docs/img/scheduler_loop.jpg

diff --git a/UPDATING.md b/UPDATING.md
index 8336d73cc9337..618888ea95a29 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -24,6 +24,16 @@ assists users migrating to a new version.
 
 ## Airflow 1.10.1
 
+### New `dag_processor_manager_log_location` config option
+
+The DAG parsing manager log now by default will be log into a file, where its location is
+controlled by the new `dag_processor_manager_log_location` config option in core section.
+
+### new `sync_parallelism` config option in celery section
+
+The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
+fetch celery task state in parallel. Default value is max(1, number of cores - 1)
+
 ### StatsD Metrics
 
 The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
diff --git a/airflow/config_templates/airflow_local_settings.py b/airflow/config_templates/airflow_local_settings.py
index 95150ab3bbbef..45a2f2923c058 100644
--- a/airflow/config_templates/airflow_local_settings.py
+++ b/airflow/config_templates/airflow_local_settings.py
@@ -20,6 +20,7 @@
 import os
 
 from airflow import configuration as conf
+from airflow.utils.file import mkdirs
 
 # TODO: Logging format and level should be configured
 # in this file instead of from airflow.cfg. Currently
@@ -38,7 +39,11 @@
 
 PROCESSOR_LOG_FOLDER = conf.get('scheduler', 'CHILD_PROCESS_LOG_DIRECTORY')
 
+DAG_PROCESSOR_MANAGER_LOG_LOCATION = \
+    conf.get('core', 'DAG_PROCESSOR_MANAGER_LOG_LOCATION')
+
 FILENAME_TEMPLATE = conf.get('core', 'LOG_FILENAME_TEMPLATE')
+
 PROCESSOR_FILENAME_TEMPLATE = conf.get('core', 'LOG_PROCESSOR_FILENAME_TEMPLATE')
 
 # Storage bucket url for remote logging
@@ -79,7 +84,7 @@
             'formatter': 'airflow',
             'base_log_folder': os.path.expanduser(PROCESSOR_LOG_FOLDER),
             'filename_template': PROCESSOR_FILENAME_TEMPLATE,
-        },
+        }
     },
     'loggers': {
         'airflow.processor': {
@@ -104,6 +109,26 @@
     }
 }
 
+DEFAULT_DAG_PARSING_LOGGING_CONFIG = {
+    'handlers': {
+        'processor_manager': {
+            'class': 'logging.handlers.RotatingFileHandler',
+            'formatter': 'airflow',
+            'filename': DAG_PROCESSOR_MANAGER_LOG_LOCATION,
+            'mode': 'a',
+            'maxBytes': 104857600,  # 100MB
+            'backupCount': 5
+        }
+    },
+    'loggers': {
+        'airflow.processor_manager': {
+            'handlers': ['processor_manager'],
+            'level': LOG_LEVEL,
+            'propagate': False,
+        }
+    }
+}
+
 REMOTE_HANDLERS = {
     's3': {
         'task': {
@@ -172,6 +197,22 @@
 
 REMOTE_LOGGING = conf.get('core', 'remote_logging')
 
+# Only update the handlers and loggers when CONFIG_PROCESSOR_MANAGER_LOGGER is set.
+# This is to avoid exceptions when initializing RotatingFileHandler multiple times
+# in multiple processes.
+if os.environ.get('CONFIG_PROCESSOR_MANAGER_LOGGER') == 'True':
+    DEFAULT_LOGGING_CONFIG['handlers'] \
+        .update(DEFAULT_DAG_PARSING_LOGGING_CONFIG['handlers'])
+    DEFAULT_LOGGING_CONFIG['loggers'] \
+        .update(DEFAULT_DAG_PARSING_LOGGING_CONFIG['loggers'])
+
+    # Manually create log directory for processor_manager handler as RotatingFileHandler
+    # will only create file but not the directory.
+    processor_manager_handler_config = DEFAULT_DAG_PARSING_LOGGING_CONFIG['handlers'][
+        'processor_manager']
+    directory = os.path.dirname(processor_manager_handler_config['filename'])
+    mkdirs(directory, 0o755)
+
 if REMOTE_LOGGING and REMOTE_BASE_LOG_FOLDER.startswith('s3://'):
         DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['s3'])
 elif REMOTE_LOGGING and REMOTE_BASE_LOG_FOLDER.startswith('gs://'):
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index d8a05e5c8cd84..01d975d5ab6cb 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -68,6 +68,7 @@ simple_log_format = %%(asctime)s %%(levelname)s - %%(message)s
 # Log filename format
 log_filename_template = {{{{ ti.dag_id }}}}/{{{{ ti.task_id }}}}/{{{{ ts }}}}/{{{{ try_number }}}}.log
 log_processor_filename_template = {{{{ filename }}}}.log
+dag_processor_manager_log_location = {AIRFLOW_HOME}/logs/dag_processor_manager/dag_processor_manager.log
 
 # Hostname by providing a path to a callable, which will resolve the hostname
 hostname_callable = socket:getfqdn
diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index 9dc1ef94ec044..7d8347efa2341 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -39,6 +39,7 @@ logging_level = INFO
 fab_logging_level = WARN
 log_filename_template = {{{{ ti.dag_id }}}}/{{{{ ti.task_id }}}}/{{{{ ts }}}}/{{{{ try_number }}}}.log
 log_processor_filename_template = {{{{ filename }}}}.log
+dag_processor_manager_log_location = {AIRFLOW_HOME}/logs/dag_processor_manager/dag_processor_manager.log
 executor = SequentialExecutor
 sql_alchemy_conn = sqlite:///{AIRFLOW_HOME}/unittests.db
 load_examples = True
diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index 3522f7c449790..25bfe3cd91064 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -141,7 +141,7 @@ def heartbeat(self):
                                    queue=queue,
                                    executor_config=ti.executor_config)
             else:
-                self.logger.info(
+                self.log.info(
                     'Task is already running, not sending to '
                     'executor: {}'.format(key))
 
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 4d74648bbab55..48726733982ff 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -26,22 +26,18 @@
 import logging
 import multiprocessing
 import os
-import psutil
 import signal
-import six
 import sys
 import threading
 import time
-import datetime
-
 from collections import defaultdict
+from time import sleep
+
+import six
 from past.builtins import basestring
-from sqlalchemy import (
-    Column, Integer, String, func, Index, or_, and_, not_)
+from sqlalchemy import (Column, Index, Integer, String, and_, func, not_, or_)
 from sqlalchemy.exc import OperationalError
 from sqlalchemy.orm.session import make_transient
-from tabulate import tabulate
-from time import sleep
 
 from airflow import configuration as conf
 from airflow import executors, models, settings
@@ -53,16 +49,16 @@
 from airflow.utils import asciiart, helpers, timezone
 from airflow.utils.configuration import tmp_configuration_copy
 from airflow.utils.dag_processing import (AbstractDagFileProcessor,
-                                          DagFileProcessorManager,
+                                          DagFileProcessorAgent,
                                           SimpleDag,
                                           SimpleDagBag,
                                           list_py_file_paths)
 from airflow.utils.db import create_session, provide_session
-from airflow.utils.email import send_email, get_email_address_list
-from airflow.utils.log.logging_mixin import LoggingMixin, set_context, StreamLogWriter
+from airflow.utils.email import get_email_address_list, send_email
+from airflow.utils.log.logging_mixin import LoggingMixin, StreamLogWriter, set_context
 from airflow.utils.net import get_hostname
-from airflow.utils.state import State
 from airflow.utils.sqlalchemy import UtcDateTime
+from airflow.utils.state import State
 
 Base = models.Base
 ID_LEN = models.ID_LEN
@@ -304,7 +300,7 @@ class DagFileProcessor(AbstractDagFileProcessor, LoggingMixin):
     # Counter that increments everytime an instance of this class is created
     class_creation_counter = 0
 
-    def __init__(self, file_path, pickle_dags, dag_id_white_list):
+    def __init__(self, file_path, pickle_dags, dag_id_white_list, zombies):
         """
         :param file_path: a Python file containing Airflow DAG definitions
         :type file_path: unicode
@@ -312,6 +308,8 @@ def __init__(self, file_path, pickle_dags, dag_id_white_list):
         :type pickle_dags: bool
         :param dag_id_whitelist: If specified, only look at these DAG ID's
         :type dag_id_whitelist: list[unicode]
+        :param zombies: zombie task instances to kill
+        :type zombies: list[SimpleTaskInstance]
         """
         self._file_path = file_path
         # Queue that's used to pass results from the child process.
@@ -320,6 +318,7 @@ def __init__(self, file_path, pickle_dags, dag_id_white_list):
         self._process = None
         self._dag_id_white_list = dag_id_white_list
         self._pickle_dags = pickle_dags
+        self._zombies = zombies
         # The result of Scheduler.process_file(file_path).
         self._result = None
         # Whether the process is done running.
@@ -340,7 +339,8 @@ def _launch_process(result_queue,
                         file_path,
                         pickle_dags,
                         dag_id_white_list,
-                        thread_name):
+                        thread_name,
+                        zombies):
         """
         Launch a process to process the given file.
 
@@ -358,6 +358,8 @@ def _launch_process(result_queue,
         :type thread_name: unicode
         :return: the process that was launched
         :rtype: multiprocessing.Process
+        :param zombies: zombie task instances to kill
+        :type zombies: list[SimpleTaskInstance]
         """
         def helper():
             # This helper runs in the newly created process
@@ -386,6 +388,7 @@ def helper():
                          os.getpid(), file_path)
                 scheduler_job = SchedulerJob(dag_ids=dag_id_white_list, log=log)
                 result = scheduler_job.process_file(file_path,
+                                                    zombies,
                                                     pickle_dags)
                 result_queue.put(result)
                 end_time = time.time()
@@ -418,7 +421,8 @@ def start(self):
             self.file_path,
             self._pickle_dags,
             self._dag_id_white_list,
-            "DagFileProcessor{}".format(self._instance_id))
+            "DagFileProcessor{}".format(self._instance_id),
+            self._zombies)
         self._start_time = timezone.utcnow()
 
     def terminate(self, sigkill=False):
@@ -475,7 +479,8 @@ def done(self):
         if self._done:
             return True
 
-        if not self._result_queue.empty():
+        # In case result queue is corrupted.
+        if self._result_queue and not self._result_queue.empty():
             self._result = self._result_queue.get_nowait()
             self._done = True
             self.log.debug("Waiting for %s", self._process)
@@ -483,7 +488,7 @@ def done(self):
             return True
 
         # Potential error case when process dies
-        if not self._process.is_alive():
+        if self._result_queue and not self._process.is_alive():
             self._done = True
             # Get the object from the queue or else join() can hang.
             if not self._result_queue.empty():
@@ -534,8 +539,6 @@ def __init__(
             dag_ids=None,
             subdir=settings.DAGS_FOLDER,
             num_runs=-1,
-            file_process_interval=conf.getint('scheduler',
-                                              'min_file_process_interval'),
             processor_poll_interval=1.0,
             run_duration=None,
             do_pickle=False,
@@ -584,26 +587,27 @@ def __init__(
 
         self.using_sqlite = False
         if 'sqlite' in conf.get('core', 'sql_alchemy_conn'):
-            if self.max_threads > 1:
-                self.log.error("Cannot use more than 1 thread when using sqlite. Setting max_threads to 1")
-            self.max_threads = 1
             self.using_sqlite = True
 
-        # How often to scan the DAGs directory for new files. Default to 5 minutes.
-        self.dag_dir_list_interval = conf.getint('scheduler',
-                                                 'dag_dir_list_interval')
-        # How often to print out DAG file processing stats to the log. Default to
-        # 30 seconds.
-        self.print_stats_interval = conf.getint('scheduler',
-                                                'print_stats_interval')
-
-        self.file_process_interval = file_process_interval
-
         self.max_tis_per_query = conf.getint('scheduler', 'max_tis_per_query')
         if run_duration is None:
             self.run_duration = conf.getint('scheduler',
                                             'run_duration')
 
+        self.processor_agent = None
+
+        signal.signal(signal.SIGINT, self._exit_gracefully)
+        signal.signal(signal.SIGTERM, self._exit_gracefully)
+
+    def _exit_gracefully(self, signum, frame):
+        """
+        Helper method to clean up processor_agent to avoid leaving orphan processes.
+        """
+        self.log.info("Exiting gracefully upon receiving signal {}".format(signum))
+        if self.processor_agent:
+            self.processor_agent.end()
+        sys.exit(os.EX_OK)
+
     @provide_session
     def manage_slas(self, dag, session=None):
         """
@@ -739,25 +743,6 @@ def manage_slas(self, dag, session=None):
                     session.merge(sla)
             session.commit()
 
-    @staticmethod
-    @provide_session
-    def clear_nonexistent_import_errors(session, known_file_paths):
-        """
-        Clears import errors for files that no longer exist.
-
-        :param session: session for ORM operations
-        :type session: sqlalchemy.orm.session.Session
-        :param known_file_paths: The list of existing files that are parsed for DAGs
-        :type known_file_paths: list[unicode]
-        """
-        query = session.query(models.ImportError)
-        if known_file_paths:
-            query = query.filter(
-                ~models.ImportError.filename.in_(known_file_paths)
-            )
-        query.delete(synchronize_session='fetch')
-        session.commit()
-
     @staticmethod
     def update_import_errors(session, dagbag):
         """
@@ -1110,7 +1095,9 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         # Put one task instance on each line
         task_instance_str = "\n\t".join(
             ["{}".format(x) for x in task_instances_to_examine])
-        self.log.info("Tasks up for execution:\n\t%s", task_instance_str)
+        self.log.info("{} tasks up for execution:\n\t{}"
+                      .format(len(task_instances_to_examine),
+                              task_instance_str))
 
         # Get the pool settings
         pools = {p.pool: p for p in session.query(models.Pool).all()}
@@ -1301,8 +1288,9 @@ def query(result, items):
                 .all())
             task_instance_str = "\n\t".join(
                 ["{}".format(x) for x in tis_to_be_queued])
-            self.log.info("Setting the follow tasks to queued state:\n\t%s",
-                          task_instance_str)
+            self.log.info("Setting the following {} tasks to queued state:\n\t{}"
+                          .format(len(tis_to_be_queued),
+                                  task_instance_str))
             return result + tis_to_be_queued
 
         tis_to_be_queued = helpers.reduce_in_chunks(query,
@@ -1479,72 +1467,6 @@ def _process_executor_events(self, simple_dag_bag, session=None):
                         session.merge(ti)
                         session.commit()
 
-    def _log_file_processing_stats(self,
-                                   known_file_paths,
-                                   processor_manager):
-        """
-        Print out stats about how files are getting processed.
-
-        :param known_file_paths: a list of file paths that may contain Airflow
-            DAG definitions
-        :type known_file_paths: list[unicode]
-        :param processor_manager: manager for the file processors
-        :type stats: DagFileProcessorManager
-        :return: None
-        """
-
-        # File Path: Path to the file containing the DAG definition
-        # PID: PID associated with the process that's processing the file. May
-        # be empty.
-        # Runtime: If the process is currently running, how long it's been
-        # running for in seconds.
-        # Last Runtime: If the process ran before, how long did it take to
-        # finish in seconds
-        # Last Run: When the file finished processing in the previous run.
-        headers = ["File Path",
-                   "PID",
-                   "Runtime",
-                   "Last Runtime",
-                   "Last Run"]
-
-        rows = []
-        for file_path in known_file_paths:
-            last_runtime = processor_manager.get_last_runtime(file_path)
-            processor_pid = processor_manager.get_pid(file_path)
-            processor_start_time = processor_manager.get_start_time(file_path)
-            runtime = ((timezone.utcnow() - processor_start_time).total_seconds()
-                       if processor_start_time else None)
-            last_run = processor_manager.get_last_finish_time(file_path)
-
-            rows.append((file_path,
-                         processor_pid,
-                         runtime,
-                         last_runtime,
-                         last_run))
-
-        # Sort by longest last runtime. (Can't sort None values in python3)
-        rows = sorted(rows, key=lambda x: x[3] or 0.0)
-
-        formatted_rows = []
-        for file_path, pid, runtime, last_runtime, last_run in rows:
-            formatted_rows.append((file_path,
-                                   pid,
-                                   "{:.2f}s".format(runtime)
-                                   if runtime else None,
-                                   "{:.2f}s".format(last_runtime)
-                                   if last_runtime else None,
-                                   last_run.strftime("%Y-%m-%dT%H:%M:%S")
-                                   if last_run else None))
-        log_str = ("\n" +
-                   "=" * 80 +
-                   "\n" +
-                   "DAG File Processing Stats\n\n" +
-                   tabulate(formatted_rows, headers=headers) +
-                   "\n" +
-                   "=" * 80)
-
-        self.log.info(log_str)
-
     def _execute(self):
         self.log.info("Starting the scheduler")
 
@@ -1554,84 +1476,51 @@ def _execute(self):
                 (executors.LocalExecutor, executors.SequentialExecutor):
             pickle_dags = True
 
-        # Use multiple processes to parse and generate tasks for the
-        # DAGs in parallel. By processing them in separate processes,
-        # we can get parallelism and isolation from potentially harmful
-        # user code.
-        self.log.info(
-            "Processing files using up to %s processes at a time",
-            self.max_threads)
         self.log.info("Running execute loop for %s seconds", self.run_duration)
         self.log.info("Processing each file at most %s times", self.num_runs)
-        self.log.info(
-            "Process each file at most once every %s seconds",
-            self.file_process_interval)
-        self.log.info(
-            "Checking for new files in %s every %s seconds",
-            self.subdir,
-            self.dag_dir_list_interval)
 
         # Build up a list of Python files that could contain DAGs
         self.log.info("Searching for files in %s", self.subdir)
         known_file_paths = list_py_file_paths(self.subdir)
         self.log.info("There are %s files in %s", len(known_file_paths), self.subdir)
 
-        def processor_factory(file_path):
+        def processor_factory(file_path, zombies):
             return DagFileProcessor(file_path,
                                     pickle_dags,
-                                    self.dag_ids)
+                                    self.dag_ids,
+                                    zombies)
+
+        # When using sqlite, we do not use async_mode
+        # so the scheduler job and DAG parser don't access the DB at the same time.
+        async_mode = not self.using_sqlite
 
-        processor_manager = DagFileProcessorManager(self.subdir,
-                                                    known_file_paths,
-                                                    self.max_threads,
-                                                    self.file_process_interval,
-                                                    self.num_runs,
-                                                    processor_factory)
+        self.processor_agent = DagFileProcessorAgent(self.subdir,
+                                                     known_file_paths,
+                                                     self.num_runs,
+                                                     processor_factory,
+                                                     async_mode)
 
         try:
-            self._execute_helper(processor_manager)
+            self._execute_helper()
         finally:
+            self.processor_agent.end()
             self.log.info("Exited execute loop")
 
-            # Kill all child processes on exit since we don't want to leave
-            # them as orphaned.
-            pids_to_kill = processor_manager.get_all_pids()
-            if len(pids_to_kill) > 0:
-                # First try SIGTERM
-                this_process = psutil.Process(os.getpid())
-                # Only check child processes to ensure that we don't have a case
-                # where we kill the wrong process because a child process died
-                # but the PID got reused.
-                child_processes = [x for x in this_process.children(recursive=True)
-                                   if x.is_running() and x.pid in pids_to_kill]
-                for child in child_processes:
-                    self.log.info("Terminating child PID: %s", child.pid)
-                    child.terminate()
-                # TODO: Remove magic number
-                timeout = 5
-                self.log.info(
-                    "Waiting up to %s seconds for processes to exit...", timeout)
-                try:
-                    psutil.wait_procs(
-                        child_processes, timeout=timeout,
-                        callback=lambda x: self.log.info('Terminated PID %s', x.pid))
-                except psutil.TimeoutExpired:
-                    self.log.debug("Ran out of time while waiting for processes to exit")
-
-                # Then SIGKILL
-                child_processes = [x for x in this_process.children(recursive=True)
-                                   if x.is_running() and x.pid in pids_to_kill]
-                if len(child_processes) > 0:
-                    self.log.info("SIGKILL processes that did not terminate gracefully")
-                    for child in child_processes:
-                        self.log.info("Killing child PID: %s", child.pid)
-                        child.kill()
-                        child.wait()
-
-    def _execute_helper(self, processor_manager):
-        """
-        :param processor_manager: manager to use
-        :type processor_manager: DagFileProcessorManager
+    def _execute_helper(self):
+        """
+        The actual scheduler loop. The main steps in the loop are:
+            #. Harvest DAG parsing results through DagFileProcessorAgent
+            #. Find and queue executable tasks
+                #. Change task instance state in DB
+                #. Queue tasks in executor
+            #. Heartbeat executor
+                #. Execute queued tasks in executor asynchronously
+                #. Sync on the states of running tasks
+
+        Following is a graphic representation of these steps.
+
+        .. image:: ../docs/img/scheduler_loop.jpg
+
         :return: None
         """
         self.executor.start()
@@ -1639,17 +1528,13 @@ def _execute_helper(self, processor_manager):
         self.log.info("Resetting orphaned tasks for active dag runs")
         self.reset_state_for_orphaned_tasks()
 
+        # Start after resetting orphaned tasks to avoid stressing out DB.
+        self.processor_agent.start()
+
         execute_start_time = timezone.utcnow()
 
-        # Last time stats were printed
-        last_stat_print_time = datetime.datetime(2000, 1, 1, tzinfo=timezone.utc)
         # Last time that self.heartbeat() was called.
         last_self_heartbeat_time = timezone.utcnow()
-        # Last time that the DAG dir was traversed to look for files
-        last_dag_dir_refresh_time = timezone.utcnow()
-
-        # Use this value initially
-        known_file_paths = processor_manager.file_paths
 
         # For the execute duration, parse and schedule DAGs
         while (timezone.utcnow() - execute_start_time).total_seconds() < \
@@ -1657,60 +1542,47 @@ def _execute_helper(self, processor_manager):
             self.log.debug("Starting Loop...")
             loop_start_time = time.time()
 
-            # Traverse the DAG directory for Python files containing DAGs
-            # periodically
-            elapsed_time_since_refresh = (timezone.utcnow() -
-                                          last_dag_dir_refresh_time).total_seconds()
-
-            if elapsed_time_since_refresh > self.dag_dir_list_interval:
-                # Build up a list of Python files that could contain DAGs
-                self.log.info("Searching for files in %s", self.subdir)
-                known_file_paths = list_py_file_paths(self.subdir)
-                last_dag_dir_refresh_time = timezone.utcnow()
-                self.log.info(
-                    "There are %s files in %s", len(known_file_paths), self.subdir)
-
-                processor_manager.set_file_paths(known_file_paths)
-
-                self.log.debug("Removing old import errors")
-                self.clear_nonexistent_import_errors(known_file_paths=known_file_paths)
-
-            # Kick of new processes and collect results from finished ones
-            self.log.debug("Heartbeating the process manager")
-            simple_dags = processor_manager.heartbeat()
-
             if self.using_sqlite:
+                self.processor_agent.heartbeat()
                 # For the sqlite case w/ 1 thread, wait until the processor
                 # is finished to avoid concurrent access to the DB.
                 self.log.debug(
                     "Waiting for processors to finish since we're using sqlite")
+                self.processor_agent.wait_until_finished()
 
-                processor_manager.wait_until_finished()
+            self.log.info("Harvesting DAG parsing results")
+            simple_dags = self.processor_agent.harvest_simple_dags()
 
             # Send tasks for execution if available
             simple_dag_bag = SimpleDagBag(simple_dags)
             if len(simple_dags) > 0:
-
-                # Handle cases where a DAG run state is set (perhaps manually) to
-                # a non-running state. Handle task instances that belong to
-                # DAG runs in those states
-
-                # If a task instance is up for retry but the corresponding DAG run
-                # isn't running, mark the task instance as FAILED so we don't try
-                # to re-run it.
-                self._change_state_for_tis_without_dagrun(simple_dag_bag,
-                                                          [State.UP_FOR_RETRY],
-                                                          State.FAILED)
-                # If a task instance is scheduled or queued, but the corresponding
-                # DAG run isn't running, set the state to NONE so we don't try to
-                # re-run it.
-                self._change_state_for_tis_without_dagrun(simple_dag_bag,
-                                                          [State.QUEUED,
-                                                           State.SCHEDULED],
-                                                          State.NONE)
-
-                self._execute_task_instances(simple_dag_bag,
-                                             (State.SCHEDULED,))
+                try:
+                    simple_dag_bag = SimpleDagBag(simple_dags)
+
+                    # Handle cases where a DAG run state is set (perhaps manually) to
+                    # a non-running state. Handle task instances that belong to
+                    # DAG runs in those states
+
+                    # If a task instance is up for retry but the corresponding DAG run
+                    # isn't running, mark the task instance as FAILED so we don't try
+                    # to re-run it.
+                    self._change_state_for_tis_without_dagrun(simple_dag_bag,
+                                                              [State.UP_FOR_RETRY],
+                                                              State.FAILED)
+                    # If a task instance is scheduled or queued, but the corresponding
+                    # DAG run isn't running, set the state to NONE so we don't try to
+                    # re-run it.
+                    self._change_state_for_tis_without_dagrun(simple_dag_bag,
+                                                              [State.QUEUED,
+                                                               State.SCHEDULED],
+                                                              State.NONE)
+
+                    self._execute_task_instances(simple_dag_bag,
+                                                 (State.SCHEDULED,))
+                except Exception as e:
+                    self.log.error("Error queuing tasks")
+                    self.log.exception(e)
+                    continue
 
             # Call heartbeats
             self.log.debug("Heartbeating the executor")
@@ -1727,40 +1599,34 @@ def _execute_helper(self, processor_manager):
                 self.heartbeat()
                 last_self_heartbeat_time = timezone.utcnow()
 
-            # Occasionally print out stats about how fast the files are getting processed
-            if ((timezone.utcnow() - last_stat_print_time).total_seconds() >
-                    self.print_stats_interval):
-                if len(known_file_paths) > 0:
-                    self._log_file_processing_stats(known_file_paths,
-                                                    processor_manager)
-                last_stat_print_time = timezone.utcnow()
-
             loop_end_time = time.time()
+            loop_duration = loop_end_time - loop_start_time
             self.log.debug(
                 "Ran scheduling loop in %.2f seconds",
-                loop_end_time - loop_start_time)
+                loop_duration)
             self.log.debug("Sleeping for %.2f seconds", self._processor_poll_interval)
             time.sleep(self._processor_poll_interval)
 
             # Exit early for a test mode
-            if processor_manager.max_runs_reached():
-                self.log.info(
-                    "Exiting loop as all files have been processed %s times",
-                    self.num_runs)
+            if self.processor_agent.done:
+                self.log.info("Exiting scheduler loop as all files"
+                              " have been processed {} times".format(self.num_runs))
                 break
 
+            if loop_duration < 1:
+                sleep_length = 1 - loop_duration
+                self.log.debug(
+                    "Sleeping for {0:.2f} seconds to prevent excessive logging"
+                    .format(sleep_length))
+                sleep(sleep_length)
+
         # Stop any processors
-        processor_manager.terminate()
+        self.processor_agent.terminate()
 
         # Verify that all files were processed, and if so, deactivate DAGs that
         # haven't been touched by the scheduler as they likely have been
         # deleted.
-        all_files_processed = True
-        for file_path in known_file_paths:
-            if processor_manager.get_last_finish_time(file_path) is None:
-                all_files_processed = False
-                break
-        if all_files_processed:
+        if self.processor_agent.all_files_processed:
             self.log.info(
                 "Deactivating DAGs that haven't been touched since %s",
                 execute_start_time.isoformat()
@@ -1772,7 +1638,7 @@ def _execute_helper(self, processor_manager):
         settings.Session.remove()
 
     @provide_session
-    def process_file(self, file_path, pickle_dags=False, session=None):
+    def process_file(self, file_path, zombies, pickle_dags=False, session=None):
         """
         Process a Python file containing Airflow DAGs.
 
@@ -1791,6 +1657,8 @@ def process_file(self, file_path, pickle_dags=False, session=None):
 
         :param file_path: the path to the Python file that should be executed
         :type file_path: unicode
+        :param zombies: zombie task instances to kill.
+        :type zombies: list[SimpleTaskInstance]
         :param pickle_dags: whether serialize the DAGs found in the file and
             save them to the db
         :type pickle_dags: bool
@@ -1885,7 +1753,7 @@ def process_file(self, file_path, pickle_dags=False, session=None):
         except Exception:
             self.log.exception("Error logging import errors!")
         try:
-            dagbag.kill_zombies()
+            dagbag.kill_zombies(zombies)
         except Exception:
             self.log.exception("Error killing zombies!")
 
diff --git a/airflow/models.py b/airflow/models.py
index 0a03ea979223a..5248c76e07ea1 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -448,39 +448,28 @@ def process_file(self, filepath, only_if_updated=True, safe_mode=True):
         return found_dags
 
     @provide_session
-    def kill_zombies(self, session=None):
-        """
-        Fails tasks that haven't had a heartbeat in too long
-        """
-        from airflow.jobs import LocalTaskJob as LJ
-        self.log.info("Finding 'running' jobs without a recent heartbeat")
-        TI = TaskInstance
-        secs = configuration.conf.getint('scheduler', 'scheduler_zombie_task_threshold')
-        limit_dttm = timezone.utcnow() - timedelta(seconds=secs)
-        self.log.info("Failing jobs without heartbeat after %s", limit_dttm)
-
-        tis = (
-            session.query(TI)
-            .join(LJ, TI.job_id == LJ.id)
-            .filter(TI.state == State.RUNNING)
-            .filter(
-                or_(
-                    LJ.state != State.RUNNING,
-                    LJ.latest_heartbeat < limit_dttm,
-                ))
-            .all()
-        )
-
-        for ti in tis:
-            if ti and ti.dag_id in self.dags:
-                dag = self.dags[ti.dag_id]
-                if ti.task_id in dag.task_ids:
-                    task = dag.get_task(ti.task_id)
-
-                    # now set non db backed vars on ti
-                    ti.task = task
+    def kill_zombies(self, zombies, session=None):
+        """
+        Fail given zombie tasks, which are tasks that haven't
+        had a heartbeat for too long, in the current DagBag.
+
+        :param zombies: zombie task instances to kill.
+        :type zombies: SimpleTaskInstance
+        :param session: DB session.
+        :type Session.
+        """
+        for zombie in zombies:
+            if zombie.dag_id in self.dags:
+                dag = self.dags[zombie.dag_id]
+                if zombie.task_id in dag.task_ids:
+                    task = dag.get_task(zombie.task_id)
+                    ti = TaskInstance(task, zombie.execution_date)
+                    # Get properties needed for failure handling from SimpleTaskInstance.
+                    ti.start_date = zombie.start_date
+                    ti.end_date = zombie.end_date
+                    ti.try_number = zombie.try_number
+                    ti.state = zombie.state
                     ti.test_mode = configuration.getboolean('core', 'unit_test_mode')
-
                     ti.handle_failure("{} detected as zombie".format(ti),
                                       ti.test_mode, ti.get_template_context())
                     self.log.info(
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 8b77c796d2030..47f473e9aa3d3 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -22,17 +22,33 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
+import logging
+import multiprocessing
 import os
 import re
+import signal
+import sys
 import time
 import zipfile
 from abc import ABCMeta, abstractmethod
 from collections import defaultdict
+from collections import namedtuple
+from datetime import timedelta
 
+import psutil
+from six.moves import range, reload_module
+from sqlalchemy import or_
+from tabulate import tabulate
+
+# To avoid circular imports
+import airflow.models
+from airflow import configuration as conf
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.exceptions import AirflowException
 from airflow.utils import timezone
+from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
+from airflow.utils.state import State
 
 
 class SimpleDag(BaseDag):
@@ -121,6 +137,45 @@ def get_task_special_arg(self, task_id, special_arg_name):
             return None
 
 
+class SimpleTaskInstance(object):
+    def __init__(self, ti):
+        self._dag_id = ti.dag_id
+        self._task_id = ti.task_id
+        self._execution_date = ti.execution_date
+        self._start_date = ti.start_date
+        self._end_date = ti.end_date
+        self._try_number = ti.try_number
+        self._state = ti.state
+
+    @property
+    def dag_id(self):
+        return self._dag_id
+
+    @property
+    def task_id(self):
+        return self._task_id
+
+    @property
+    def execution_date(self):
+        return self._execution_date
+
+    @property
+    def start_date(self):
+        return self._start_date
+
+    @property
+    def end_date(self):
+        return self._end_date
+
+    @property
+    def try_number(self):
+        return self._try_number
+
+    @property
+    def state(self):
+        return self._state
+
+
 class SimpleDagBag(BaseDagBag):
     """
     A collection of SimpleDag objects with some convenience methods.
@@ -308,10 +363,243 @@ def file_path(self):
         raise NotImplementedError()
 
 
+DagParsingStat = namedtuple('DagParsingStat',
+                            ['file_paths', 'all_pids', 'done',
+                             'all_files_processed', 'result_count'])
+
+
+DagParsingSignal = namedtuple(
+    'DagParsingSignal',
+    ['AGENT_HEARTBEAT', 'MANAGER_DONE', 'TERMINATE_MANAGER', 'END_MANAGER'])(
+    'agent_heartbeat', 'manager_done', 'terminate_manager', 'end_manager')
+
+
+class DagFileProcessorAgent(LoggingMixin):
+    """
+    Agent for DAG file processing. It is responsible for all DAG parsing
+    related jobs in scheduler process. Mainly it can spin up DagFileProcessorManager
+    in a subprocess, collect DAG parsing results from it and communicate
+    signal/DAG parsing stat with it.
+    """
+
+    def __init__(self,
+                 dag_directory,
+                 file_paths,
+                 max_runs,
+                 processor_factory,
+                 async_mode):
+        """
+        :param dag_directory: Directory where DAG definitions are kept. All
+        files in file_paths should be under this directory
+        :type dag_directory: unicode
+        :param file_paths: list of file paths that contain DAG definitions
+        :type file_paths: list[unicode]
+        :param max_runs: The number of times to parse and schedule each file. -1
+        for unlimited.
+        :type max_runs: int
+        :param processor_factory: function that creates processors for DAG
+        definition files. Arguments are (dag_definition_path, log_file_path)
+        :type processor_factory: (unicode, unicode, list) -> (AbstractDagFileProcessor)
+        :param async_mode: Whether to start agent in async mode
+        :type async_mode: bool
+        """
+        self._file_paths = file_paths
+        self._file_path_queue = []
+        self._dag_directory = dag_directory
+        self._max_runs = max_runs
+        self._processor_factory = processor_factory
+        self._async_mode = async_mode
+        # Map from file path to the processor
+        self._processors = {}
+        # Map from file path to the last runtime
+        self._last_runtime = {}
+        # Map from file path to the last finish time
+        self._last_finish_time = {}
+        # Map from file path to the number of runs
+        self._run_count = defaultdict(int)
+        # Pids of DAG parse
+        self._all_pids = []
+        # Pipe for communicating signals
+        self._parent_signal_conn, self._child_signal_conn = multiprocessing.Pipe()
+        # Pipe for communicating DagParsingStat
+        self._stat_queue = multiprocessing.Queue()
+        self._result_queue = multiprocessing.Queue()
+        self._process = None
+        self._done = False
+        # Initialized as true so we do not deactivate w/o any actual DAG parsing.
+        self._all_files_processed = True
+        self._result_count = 0
+
+    def start(self):
+        """
+        Launch DagFileProcessorManager processor and start DAG parsing loop in manager.
+        """
+        self._process = self._launch_process(self._dag_directory,
+                                             self._file_paths,
+                                             self._max_runs,
+                                             self._processor_factory,
+                                             self._child_signal_conn,
+                                             self._stat_queue,
+                                             self._result_queue,
+                                             self._async_mode)
+        self.log.info("Launched DagFileProcessorManager with pid: {}"
+                      .format(self._process.pid))
+
+    def heartbeat(self):
+        """
+        Should only be used when launched DAG file processor manager in sync mode.
+        Send agent heartbeat signal to the manager.
+        """
+        self._parent_signal_conn.send(DagParsingSignal.AGENT_HEARTBEAT)
+
+    def wait_until_finished(self):
+        """
+        Should only be used when launched DAG file processor manager in sync mode.
+        Wait for done signal from the manager.
+        """
+        while True:
+            if self._parent_signal_conn.recv() == DagParsingSignal.MANAGER_DONE:
+                break
+
+    @staticmethod
+    def _launch_process(dag_directory,
+                        file_paths,
+                        max_runs,
+                        processor_factory,
+                        signal_conn,
+                        _stat_queue,
+                        result_queue,
+                        async_mode):
+        def helper():
+            # Reload configurations and settings to avoid collision with parent process.
+            # Because this process may need custom configurations that cannot be shared,
+            # e.g. RotatingFileHandler. And it can cause connection corruption if we
+            # do not recreate the SQLA connection pool.
+            os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER'] = 'True'
+            reload_module(airflow.config_templates.airflow_local_settings)
+            reload_module(airflow.settings)
+            del os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER']
+            processor_manager = DagFileProcessorManager(dag_directory,
+                                                        file_paths,
+                                                        max_runs,
+                                                        processor_factory,
+                                                        signal_conn,
+                                                        _stat_queue,
+                                                        result_queue,
+                                                        async_mode)
+
+            processor_manager.start()
+
+        p = multiprocessing.Process(target=helper,
+                                    args=(),
+                                    name="DagFileProcessorManager")
+        p.start()
+        return p
+
+    def harvest_simple_dags(self):
+        """
+        Harvest DAG parsing results from result queue and sync metadata from stat queue.
+        :return: List of parsing result in SimpleDag format.
+        """
+        # Metadata and results to be harvested can be inconsistent,
+        # but it should not be a big problem.
+        self._sync_metadata()
+        # Heartbeating after syncing metadata so we do not restart manager
+        # if it processed all files for max_run times and exit normally.
+        self._heartbeat_manager()
+        simple_dags = []
+        # multiprocessing.Queue().qsize will not work on MacOS.
+        if sys.platform == "darwin":
+            qsize = self._result_count
+        else:
+            qsize = self._result_queue.qsize()
+        for _ in range(qsize):
+            simple_dags.append(self._result_queue.get())
+
+        self._result_count = 0
+
+        return simple_dags
+
+    def _heartbeat_manager(self):
+        """
+        Heartbeat DAG file processor and start it if it is not alive.
+        :return:
+        """
+        if self._process and not self._process.is_alive() and not self.done:
+            self.start()
+
+    def _sync_metadata(self):
+        """
+        Sync metadata from stat queue and only keep the latest stat.
+        :return:
+        """
+        while not self._stat_queue.empty():
+            stat = self._stat_queue.get()
+            self._file_paths = stat.file_paths
+            self._all_pids = stat.all_pids
+            self._done = stat.done
+            self._all_files_processed = stat.all_files_processed
+            self._result_count += stat.result_count
+
+    @property
+    def file_paths(self):
+        return self._file_paths
+
+    @property
+    def done(self):
+        return self._done
+
+    @property
+    def all_files_processed(self):
+        return self._all_files_processed
+
+    def terminate(self):
+        """
+        Send termination signal to DAG parsing processor manager
+        and expect it to terminate all DAG file processors.
+        """
+        self.log.info("Sending termination message to manager.")
+        self._child_signal_conn.send(DagParsingSignal.TERMINATE_MANAGER)
+
+    def end(self):
+        """
+        Terminate (and then kill) the manager process launched.
+        :return:
+        """
+        if not self._process or not self._process.is_alive():
+            self.log.warn('Ending without manager process.')
+            return
+        this_process = psutil.Process(os.getpid())
+        manager_process = psutil.Process(self._process.pid)
+        # First try SIGTERM
+        if manager_process.is_running() \
+                and manager_process.pid in [x.pid for x in this_process.children()]:
+            self.log.info(
+                "Terminating manager process: {}".format(manager_process.pid))
+            manager_process.terminate()
+            # TODO: Remove magic number
+            timeout = 5
+            self.log.info("Waiting up to {}s for manager process to exit..."
+                          .format(timeout))
+            try:
+                psutil.wait_procs({manager_process}, timeout)
+            except psutil.TimeoutExpired:
+                self.log.debug("Ran out of time while waiting for "
+                               "processes to exit")
+
+        # Then SIGKILL
+        if manager_process.is_running() \
+                and manager_process.pid in [x.pid for x in this_process.children()]:
+            self.log.info("Killing manager process: {}".format(manager_process.pid))
+            manager_process.kill()
+            manager_process.wait()
+
+
 class DagFileProcessorManager(LoggingMixin):
     """
     Given a list of DAG definition files, this kicks off several processors
-    in parallel to process them. The parallelism is limited and as the
+    in parallel to process them and put the results to a multiprocessing.Queue
+    for DagFileProcessorAgent to harvest. The parallelism is limited and as the
     processors finish, more are launched. The files are processed over and
     over again, but no more often than the specified interval.
 
@@ -324,48 +612,320 @@ class DagFileProcessorManager(LoggingMixin):
     def __init__(self,
                  dag_directory,
                  file_paths,
-                 parallelism,
-                 process_file_interval,
                  max_runs,
-                 processor_factory):
+                 processor_factory,
+                 signal_conn,
+                 stat_queue,
+                 result_queue,
+                 async_mode=True):
         """
         :param dag_directory: Directory where DAG definitions are kept. All
         files in file_paths should be under this directory
         :type dag_directory: unicode
         :param file_paths: list of file paths that contain DAG definitions
         :type file_paths: list[unicode]
-        :param parallelism: maximum number of simultaneous process to run at once
-        :type parallelism: int
-        :param process_file_interval: process a file at most once every this
-        many seconds
-        :type process_file_interval: float
         :param max_runs: The number of times to parse and schedule each file. -1
         for unlimited.
         :type max_runs: int
-        :type process_file_interval: float
         :param processor_factory: function that creates processors for DAG
         definition files. Arguments are (dag_definition_path)
-        :type processor_factory: (unicode, unicode) -> (AbstractDagFileProcessor)
-
+        :type processor_factory: (unicode, unicode, list) -> (AbstractDagFileProcessor)
+        :param signal_conn: connection to communicate signal with processor agent.
+        :type signal_conn: Connection
+        :param stat_queue: the queue to use for passing back parsing stat to agent.
+        :type stat_queue: multiprocessing.Queue
+        :param result_queue: the queue to use for passing back the result to agent.
+        :type result_queue: multiprocessing.Queue
+        :param async_mode: whether to start the manager in async mode
+        :type async_mode: bool
         """
         self._file_paths = file_paths
         self._file_path_queue = []
-        self._parallelism = parallelism
         self._dag_directory = dag_directory
         self._max_runs = max_runs
-        self._process_file_interval = process_file_interval
         self._processor_factory = processor_factory
+        self._signal_conn = signal_conn
+        self._stat_queue = stat_queue
+        self._result_queue = result_queue
+        self._async_mode = async_mode
+
+        self._parallelism = conf.getint('scheduler', 'max_threads')
+        if 'sqlite' in conf.get('core', 'sql_alchemy_conn') and self._parallelism > 1:
+            self.log.error("Cannot use more than 1 thread when using sqlite. "
+                           "Setting parallelism to 1")
+            self._parallelism = 1
+
+        # Parse and schedule each file no faster than this interval.
+        self._file_process_interval = conf.getint('scheduler',
+                                                  'min_file_process_interval')
+        # How often to print out DAG file processing stats to the log. Default to
+        # 30 seconds.
+        self.print_stats_interval = conf.getint('scheduler',
+                                                'print_stats_interval')
+        # How many seconds do we wait for tasks to heartbeat before mark them as zombies.
+        self._zombie_threshold_secs = (
+            conf.getint('scheduler', 'scheduler_zombie_task_threshold'))
         # Map from file path to the processor
         self._processors = {}
         # Map from file path to the last runtime
         self._last_runtime = {}
         # Map from file path to the last finish time
         self._last_finish_time = {}
+        self._last_zombie_query_time = timezone.utcnow()
+        # Last time that the DAG dir was traversed to look for files
+        self.last_dag_dir_refresh_time = timezone.utcnow()
+        # Last time stats were printed
+        self.last_stat_print_time = timezone.datetime(2000, 1, 1)
+        # TODO: Remove magic number
+        self._zombie_query_interval = 10
         # Map from file path to the number of runs
         self._run_count = defaultdict(int)
-        # Scheduler heartbeat key.
+        # Manager heartbeat key.
         self._heart_beat_key = 'heart-beat'
 
+        # How often to scan the DAGs directory for new files. Default to 5 minutes.
+        self.dag_dir_list_interval = conf.getint('scheduler',
+                                                 'dag_dir_list_interval')
+
+        self._log = logging.getLogger('airflow.processor_manager')
+
+        signal.signal(signal.SIGINT, self._exit_gracefully)
+        signal.signal(signal.SIGTERM, self._exit_gracefully)
+
+    def _exit_gracefully(self, signum, frame):
+        """
+        Helper method to clean up DAG file processors to avoid leaving orphan processes.
+        """
+        self.log.info("Exiting gracefully upon receiving signal {}".format(signum))
+        self.terminate()
+        self.end()
+        self.log.debug("Finished terminating DAG processors.")
+        sys.exit(os.EX_OK)
+
+    def start(self):
+        """
+        Use multiple processes to parse and generate tasks for the
+        DAGs in parallel. By processing them in separate processes,
+        we can get parallelism and isolation from potentially harmful
+        user code.
+        :return:
+        """
+
+        self.log.info("Processing files using up to {} processes at a time "
+                      .format(self._parallelism))
+        self.log.info("Process each file at most once every {} seconds"
+                      .format(self._file_process_interval))
+        self.log.info("Checking for new files in {} every {} seconds"
+                      .format(self._dag_directory, self.dag_dir_list_interval))
+
+        if self._async_mode:
+            self.log.debug("Starting DagFileProcessorManager in async mode")
+            self.start_in_async()
+        else:
+            self.log.debug("Starting DagFileProcessorManager in sync mode")
+            self.start_in_sync()
+
+    def start_in_async(self):
+        """
+        Parse DAG files repeatedly in a standalone loop.
+        """
+        while True:
+            loop_start_time = time.time()
+
+            if self._signal_conn.poll():
+                agent_signal = self._signal_conn.recv()
+                if agent_signal == DagParsingSignal.TERMINATE_MANAGER:
+                    self.terminate()
+                    break
+                elif agent_signal == DagParsingSignal.END_MANAGER:
+                    self.end()
+                    sys.exit(os.EX_OK)
+
+            self._refresh_dag_dir()
+
+            simple_dags = self.heartbeat()
+            for simple_dag in simple_dags:
+                self._result_queue.put(simple_dag)
+
+            self._print_stat()
+
+            all_files_processed = all(self.get_last_finish_time(x) is not None
+                                      for x in self.file_paths)
+            max_runs_reached = self.max_runs_reached()
+
+            dag_parsing_stat = DagParsingStat(self._file_paths,
+                                              self.get_all_pids(),
+                                              max_runs_reached,
+                                              all_files_processed,
+                                              len(simple_dags))
+            self._stat_queue.put(dag_parsing_stat)
+
+            if max_runs_reached:
+                self.log.info("Exiting dag parsing loop as all files "
+                              "have been processed %s times", self._max_runs)
+                break
+
+            loop_duration = time.time() - loop_start_time
+            if loop_duration < 1:
+                sleep_length = 1 - loop_duration
+                self.log.debug("Sleeping for {0:.2f} seconds "
+                               "to prevent excessive logging".format(sleep_length))
+                time.sleep(sleep_length)
+
+    def start_in_sync(self):
+        """
+        Parse DAG files in a loop controlled by DagParsingSignal.
+        Actual DAG parsing loop will run once upon receiving one
+        agent heartbeat message and will report done when finished the loop.
+        """
+        while True:
+            agent_signal = self._signal_conn.recv()
+            if agent_signal == DagParsingSignal.TERMINATE_MANAGER:
+                self.terminate()
+                break
+            elif agent_signal == DagParsingSignal.END_MANAGER:
+                self.end()
+                sys.exit(os.EX_OK)
+            elif agent_signal == DagParsingSignal.AGENT_HEARTBEAT:
+
+                self._refresh_dag_dir()
+
+                simple_dags = self.heartbeat()
+                for simple_dag in simple_dags:
+                    self._result_queue.put(simple_dag)
+
+                self._print_stat()
+
+                all_files_processed = all(self.get_last_finish_time(x) is not None
+                                          for x in self.file_paths)
+                max_runs_reached = self.max_runs_reached()
+
+                dag_parsing_stat = DagParsingStat(self._file_paths,
+                                                  self.get_all_pids(),
+                                                  self.max_runs_reached(),
+                                                  all_files_processed,
+                                                  len(simple_dags))
+                self._stat_queue.put(dag_parsing_stat)
+
+                self.wait_until_finished()
+                self._signal_conn.send(DagParsingSignal.MANAGER_DONE)
+
+                if max_runs_reached:
+                    self.log.info("Exiting dag parsing loop as all files "
+                                  "have been processed %s times", self._max_runs)
+                    self._signal_conn.send(DagParsingSignal.MANAGER_DONE)
+                    break
+
+    def _refresh_dag_dir(self):
+        """
+        Refresh file paths from dag dir if we haven't done it for too long.
+        """
+        elapsed_time_since_refresh = (timezone.utcnow() -
+                                      self.last_dag_dir_refresh_time).total_seconds()
+        if elapsed_time_since_refresh > self.dag_dir_list_interval:
+            # Build up a list of Python files that could contain DAGs
+            self.log.info(
+                "Searching for files in {}".format(self._dag_directory))
+            self._file_paths = list_py_file_paths(self._dag_directory)
+            self.last_dag_dir_refresh_time = timezone.utcnow()
+            self.log.info("There are {} files in {}"
+                          .format(len(self._file_paths),
+                                  self._dag_directory))
+            self.set_file_paths(self._file_paths)
+
+            try:
+                self.log.debug("Removing old import errors")
+                self.clear_nonexistent_import_errors()
+            except Exception:
+                self.log.exception("Error removing old import errors")
+
+    def _print_stat(self):
+        """
+        Occasionally print out stats about how fast the files are getting processed
+        :return:
+        """
+        if ((timezone.utcnow() - self.last_stat_print_time).total_seconds() >
+                self.print_stats_interval):
+            if len(self._file_paths) > 0:
+                self._log_file_processing_stats(self._file_paths)
+            self.last_stat_print_time = timezone.utcnow()
+
+    @provide_session
+    def clear_nonexistent_import_errors(self, session):
+        """
+        Clears import errors for files that no longer exist.
+        :param session: session for ORM operations
+        :type session: sqlalchemy.orm.session.Session
+        """
+        query = session.query(airflow.models.ImportError)
+        if self._file_paths:
+            query = query.filter(
+                ~airflow.models.ImportError.filename.in_(self._file_paths)
+            )
+        query.delete(synchronize_session='fetch')
+        session.commit()
+
+    def _log_file_processing_stats(self, known_file_paths):
+        """
+        Print out stats about how files are getting processed.
+        :param known_file_paths: a list of file paths that may contain Airflow
+            DAG definitions
+        :type known_file_paths: list[unicode]
+        :return: None
+        """
+
+        # File Path: Path to the file containing the DAG definition
+        # PID: PID associated with the process that's processing the file. May
+        # be empty.
+        # Runtime: If the process is currently running, how long it's been
+        # running for in seconds.
+        # Last Runtime: If the process ran before, how long did it take to
+        # finish in seconds
+        # Last Run: When the file finished processing in the previous run.
+        headers = ["File Path",
+                   "PID",
+                   "Runtime",
+                   "Last Runtime",
+                   "Last Run"]
+
+        rows = []
+        for file_path in known_file_paths:
+            last_runtime = self.get_last_runtime(file_path)
+            processor_pid = self.get_pid(file_path)
+            processor_start_time = self.get_start_time(file_path)
+            runtime = ((timezone.utcnow() - processor_start_time).total_seconds()
+                       if processor_start_time else None)
+            last_run = self.get_last_finish_time(file_path)
+
+            rows.append((file_path,
+                         processor_pid,
+                         runtime,
+                         last_runtime,
+                         last_run))
+
+        # Sort by longest last runtime. (Can't sort None values in python3)
+        rows = sorted(rows, key=lambda x: x[3] or 0.0)
+
+        formatted_rows = []
+        for file_path, pid, runtime, last_runtime, last_run in rows:
+            formatted_rows.append((file_path,
+                                   pid,
+                                   "{:.2f}s".format(runtime)
+                                   if runtime else None,
+                                   "{:.2f}s".format(last_runtime)
+                                   if last_runtime else None,
+                                   last_run.strftime("%Y-%m-%dT%H:%M:%S")
+                                   if last_run else None))
+        log_str = ("\n" +
+                   "=" * 80 +
+                   "\n" +
+                   "DAG File Processing Stats\n\n" +
+                   tabulate(formatted_rows, headers=headers) +
+                   "\n" +
+                   "=" * 80)
+
+        self.log.info(log_str)
+
     @property
     def file_paths(self):
         return self._file_paths
@@ -472,7 +1032,7 @@ def wait_until_finished(self):
 
     def heartbeat(self):
         """
-        This should be periodically called by the scheduler. This method will
+        This should be periodically called by the manager loop. This method will
         kick off new processes to process DAG definition files and read the
         results from the finished processors.
 
@@ -498,7 +1058,7 @@ def heartbeat(self):
                 running_processors[file_path] = processor
         self._processors = running_processors
 
-        self.log.debug("%s/%s scheduler processes running",
+        self.log.debug("%s/%s DAG parsing processes running",
                        len(self._processors), self._parallelism)
 
         self.log.debug("%s file paths queued for processing",
@@ -528,7 +1088,7 @@ def heartbeat(self):
                 last_finish_time = self.get_last_finish_time(file_path)
                 if (last_finish_time is not None and
                     (now - last_finish_time).total_seconds() <
-                        self._process_file_interval):
+                        self._file_process_interval):
                     file_paths_recently_processed.append(file_path)
 
             files_paths_at_run_limit = [file_path
@@ -553,11 +1113,13 @@ def heartbeat(self):
 
             self._file_path_queue.extend(files_paths_to_queue)
 
+        zombies = self._find_zombies()
+
         # Start more processors if we have enough slots and files to process
         while (self._parallelism - len(self._processors) > 0 and
                len(self._file_path_queue) > 0):
             file_path = self._file_path_queue.pop(0)
-            processor = self._processor_factory(file_path)
+            processor = self._processor_factory(file_path, zombies)
 
             processor.start()
             self.log.debug(
@@ -566,11 +1128,47 @@ def heartbeat(self):
             )
             self._processors[file_path] = processor
 
-        # Update scheduler heartbeat count.
+        # Update heartbeat count.
         self._run_count[self._heart_beat_key] += 1
 
         return simple_dags
 
+    @provide_session
+    def _find_zombies(self, session):
+        """
+        Find zombie task instances, which are tasks haven't heartbeated for too long.
+        :return: Zombie task instances in SimpleTaskInstance format.
+        """
+        now = timezone.utcnow()
+        zombies = []
+        if (now - self._last_zombie_query_time).total_seconds() \
+                > self._zombie_query_interval:
+            # to avoid circular imports
+            from airflow.jobs import LocalTaskJob as LJ
+            self.log.info("Finding 'running' jobs without a recent heartbeat")
+            TI = airflow.models.TaskInstance
+            limit_dttm = timezone.utcnow() - timedelta(
+                seconds=self._zombie_threshold_secs)
+            self.log.info(
+                "Failing jobs without heartbeat after {}".format(limit_dttm))
+
+            tis = (
+                session.query(TI)
+                .join(LJ, TI.job_id == LJ.id)
+                .filter(TI.state == State.RUNNING)
+                .filter(
+                    or_(
+                        LJ.state != State.RUNNING,
+                        LJ.latest_heartbeat < limit_dttm,
+                    )
+                ).all()
+            )
+            self._last_zombie_query_time = timezone.utcnow()
+            for ti in tis:
+                zombies.append(SimpleTaskInstance(ti))
+
+        return zombies
+
     def max_runs_reached(self):
         """
         :return: whether all file paths have been processed max_runs times
@@ -591,3 +1189,41 @@ def terminate(self):
         """
         for processor in self._processors.values():
             processor.terminate()
+
+    def end(self):
+        """
+        Kill all child processes on exit since we don't want to leave
+        them as orphaned.
+        """
+        pids_to_kill = self.get_all_pids()
+        if len(pids_to_kill) > 0:
+            # First try SIGTERM
+            this_process = psutil.Process(os.getpid())
+            # Only check child processes to ensure that we don't have a case
+            # where we kill the wrong process because a child process died
+            # but the PID got reused.
+            child_processes = [x for x in this_process.children(recursive=True)
+                               if x.is_running() and x.pid in pids_to_kill]
+            for child in child_processes:
+                self.log.info("Terminating child PID: {}".format(child.pid))
+                child.terminate()
+            # TODO: Remove magic number
+            timeout = 5
+            self.log.info(
+                "Waiting up to %s seconds for processes to exit...", timeout)
+            try:
+                psutil.wait_procs(
+                    child_processes, timeout=timeout,
+                    callback=lambda x: self.log.info('Terminated PID %s', x.pid))
+            except psutil.TimeoutExpired:
+                self.log.debug("Ran out of time while waiting for processes to exit")
+
+            # Then SIGKILL
+            child_processes = [x for x in this_process.children(recursive=True)
+                               if x.is_running() and x.pid in pids_to_kill]
+            if len(child_processes) > 0:
+                self.log.info("SIGKILL processes that did not terminate gracefully")
+                for child in child_processes:
+                    self.log.info("Killing child PID: {}".format(child.pid))
+                    child.kill()
+                    child.wait()
diff --git a/docs/img/scheduler_loop.jpg b/docs/img/scheduler_loop.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a4a5e285e54403afdbb6eebc4d0328b8ab677775
GIT binary patch
literal 46864
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
bL-x~TBC)dM1AFk}-<GiafAKx++vxuX!32J7

literal 0
HcmV?d00001

diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 72a3d8f7a5cb2..4f539be2dd6f3 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -20,8 +20,9 @@ Scheduling & Triggers
 
 The Airflow scheduler monitors all tasks and all DAGs, and triggers the
 task instances whose dependencies have been met. Behind the scenes,
-it monitors and stays in sync with a folder for all DAG objects it may contain,
-and periodically (every minute or so) inspects active tasks to see whether
+it spins up a subprocess, which monitors and stays in sync with a folder
+for all DAG objects it may contain, and periodically (every minute or so)
+collects DAG parsing results and inspects active tasks to see whether
 they can be triggered.
 
 The Airflow scheduler is designed to run as a persistent service in an
diff --git a/tests/jobs.py b/tests/jobs.py
index db2374c13d8c5..f106bafaabcd3 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -28,37 +28,36 @@
 import multiprocessing
 import os
 import shutil
-import six
 import threading
 import time
 import unittest
 from tempfile import mkdtemp
 
+import psutil
+import six
 import sqlalchemy
+from mock import Mock, patch, MagicMock, PropertyMock
 
+from airflow.utils.db import create_session
 from airflow import AirflowException, settings, models
+from airflow import configuration
 from airflow.bin import cli
 from airflow.executors import BaseExecutor, SequentialExecutor
 from airflow.jobs import BaseJob, BackfillJob, SchedulerJob, LocalTaskJob
 from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI
-from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.bash_operator import BashOperator
+from airflow.operators.dummy_operator import DummyOperator
 from airflow.task.task_runner.base_task_runner import BaseTaskRunner
 from airflow.utils import timezone
-
+from airflow.utils.dag_processing import SimpleDag, SimpleDagBag, list_py_file_paths
 from airflow.utils.dates import days_ago
 from airflow.utils.db import provide_session
+from airflow.utils.net import get_hostname
 from airflow.utils.state import State
 from airflow.utils.timeout import timeout
-from airflow.utils.dag_processing import SimpleDag, SimpleDagBag, list_py_file_paths
-from airflow.utils.net import get_hostname
-
-from mock import Mock, patch, MagicMock, PropertyMock
-from tests.executors.test_executor import TestExecutor
-
 from tests.core import TEST_DAG_FOLDER
+from tests.executors.test_executor import TestExecutor
 
-from airflow import configuration
 configuration.load_test_config()
 
 
@@ -1254,10 +1253,10 @@ class SchedulerJobTest(unittest.TestCase):
 
     def setUp(self):
         self.dagbag = DagBag()
-        session = settings.Session()
-        session.query(models.DagRun).delete()
-        session.query(models.ImportError).delete()
-        session.commit()
+        with create_session() as session:
+            session.query(models.DagRun).delete()
+            session.query(models.ImportError).delete()
+            session.commit()
 
     @staticmethod
     def run_single_scheduler_loop_with_no_dags(dags_folder):
@@ -1280,6 +1279,21 @@ def run_single_scheduler_loop_with_no_dags(dags_folder):
     def _make_simple_dag_bag(self, dags):
         return SimpleDagBag([SimpleDag(dag) for dag in dags])
 
+    def test_no_orphan_process_will_be_left(self):
+        empty_dir = mkdtemp()
+        current_process = psutil.Process()
+        old_children = current_process.children(recursive=True)
+        scheduler = SchedulerJob(subdir=empty_dir,
+                                 num_runs=1)
+        scheduler.executor = TestExecutor()
+        scheduler.run()
+        shutil.rmtree(empty_dir)
+
+        # Remove potential noise created by previous tests.
+        current_children = set(current_process.children(recursive=True)) - set(
+            old_children)
+        self.assertFalse(current_children)
+
     def test_process_executor_events(self):
         dag_id = "test_process_executor_events"
         dag_id2 = "test_process_executor_events_2"
@@ -2047,13 +2061,13 @@ def test_execute_helper_reset_orphaned_tasks(self):
         session.commit()
 
         processor = mock.MagicMock()
-        processor.get_last_finish_time.return_value = None
 
         scheduler = SchedulerJob(num_runs=0, run_duration=0)
         executor = TestExecutor()
         scheduler.executor = executor
+        scheduler.processor_agent = processor
 
-        scheduler._execute_helper(processor_manager=processor)
+        scheduler._execute_helper()
 
         ti = dr.get_task_instance(task_id=op1.task_id, session=session)
         self.assertEqual(ti.state, State.NONE)
@@ -2160,10 +2174,10 @@ def test_dagrun_root_fail_unfinished(self):
 
         # Mark the successful task as never having run since we want to see if the
         # dagrun will be in a running state despite haveing an unfinished task.
-        session = settings.Session()
-        ti = dr.get_task_instance('test_dagrun_unfinished', session=session)
-        ti.state = State.NONE
-        session.commit()
+        with create_session() as session:
+            ti = dr.get_task_instance('test_dagrun_unfinished', session=session)
+            ti.state = State.NONE
+            session.commit()
         dr_state = dr.update_state()
         self.assertEqual(dr_state, State.RUNNING)
 
@@ -2205,44 +2219,44 @@ def test_scheduler_start_date(self):
         """
         Test that the scheduler respects start_dates, even when DAGS have run
         """
+        with create_session() as session:
+            dag_id = 'test_start_date_scheduling'
+            dag = self.dagbag.get_dag(dag_id)
+            dag.clear()
+            self.assertTrue(dag.start_date > datetime.datetime.utcnow())
 
-        dag_id = 'test_start_date_scheduling'
-        dag = self.dagbag.get_dag(dag_id)
-        dag.clear()
-        self.assertTrue(dag.start_date > datetime.datetime.utcnow())
-
-        scheduler = SchedulerJob(dag_id,
-                                 num_runs=2)
-        scheduler.run()
+            scheduler = SchedulerJob(dag_id,
+                                     num_runs=2)
+            scheduler.run()
 
-        # zero tasks ran
-        session = settings.Session()
-        self.assertEqual(
-            len(session.query(TI).filter(TI.dag_id == dag_id).all()), 0)
+            # zero tasks ran
+            self.assertEqual(
+                len(session.query(TI).filter(TI.dag_id == dag_id).all()), 0)
+            session.commit()
 
-        # previously, running this backfill would kick off the Scheduler
-        # because it would take the most recent run and start from there
-        # That behavior still exists, but now it will only do so if after the
-        # start date
-        backfill = BackfillJob(
-            dag=dag,
-            start_date=DEFAULT_DATE,
-            end_date=DEFAULT_DATE)
-        backfill.run()
+            # previously, running this backfill would kick off the Scheduler
+            # because it would take the most recent run and start from there
+            # That behavior still exists, but now it will only do so if after the
+            # start date
+            backfill = BackfillJob(
+                dag=dag,
+                start_date=DEFAULT_DATE,
+                end_date=DEFAULT_DATE)
+            backfill.run()
 
-        # one task ran
-        session = settings.Session()
-        self.assertEqual(
-            len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
+            # one task ran
+            self.assertEqual(
+                len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
+            session.commit()
 
-        scheduler = SchedulerJob(dag_id,
-                                 num_runs=2)
-        scheduler.run()
+            scheduler = SchedulerJob(dag_id,
+                                     num_runs=2)
+            scheduler.run()
 
-        # still one task
-        session = settings.Session()
-        self.assertEqual(
-            len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
+            # still one task
+            self.assertEqual(
+                len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
+            session.commit()
 
     def test_scheduler_task_start_date(self):
         """
@@ -3006,7 +3020,9 @@ def test_scheduler_run_duration(self):
         logging.info("Test ran in %.2fs, expected %.2fs",
                      run_duration,
                      expected_run_duration)
-        self.assertLess(run_duration - expected_run_duration, 5.0)
+        # 5s to wait for child process to exit and 1s dummy sleep
+        # in scheduler loop to prevent excessive logs.
+        self.assertLess(run_duration - expected_run_duration, 6.0)
 
     def test_dag_with_system_exit(self):
         """
@@ -3030,9 +3046,9 @@ def test_dag_with_system_exit(self):
                                  subdir=dag_directory,
                                  num_runs=1)
         scheduler.run()
-        session = settings.Session()
-        self.assertEqual(
-            len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
+        with create_session() as session:
+            self.assertEqual(
+                len(session.query(TI).filter(TI.dag_id == dag_id).all()), 1)
 
     def test_dag_get_active_runs(self):
         """
@@ -3168,8 +3184,8 @@ def setup_dag(dag_id, schedule_interval, start_date, catchup):
 
 
     def test_add_unparseable_file_before_sched_start_creates_import_error(self):
+        dags_folder = mkdtemp()
         try:
-            dags_folder = mkdtemp()
             unparseable_filename = os.path.join(dags_folder, TEMP_DAG_FILENAME)
             with open(unparseable_filename, 'w') as unparseable_file:
                 unparseable_file.writelines(UNPARSEABLE_DAG_FILE_CONTENTS)
@@ -3177,8 +3193,8 @@ def test_add_unparseable_file_before_sched_start_creates_import_error(self):
         finally:
             shutil.rmtree(dags_folder)
 
-        session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        with create_session() as session:
+            import_errors = session.query(models.ImportError).all()
 
         self.assertEqual(len(import_errors), 1)
         import_error = import_errors[0]
@@ -3188,8 +3204,8 @@ def test_add_unparseable_file_before_sched_start_creates_import_error(self):
                          "invalid syntax ({}, line 1)".format(TEMP_DAG_FILENAME))
 
     def test_add_unparseable_file_after_sched_start_creates_import_error(self):
+        dags_folder = mkdtemp()
         try:
-            dags_folder = mkdtemp()
             unparseable_filename = os.path.join(dags_folder, TEMP_DAG_FILENAME)
             self.run_single_scheduler_loop_with_no_dags(dags_folder)
 
@@ -3199,8 +3215,8 @@ def test_add_unparseable_file_after_sched_start_creates_import_error(self):
         finally:
             shutil.rmtree(dags_folder)
 
-        session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        with create_session() as session:
+            import_errors = session.query(models.ImportError).all()
 
         self.assertEqual(len(import_errors), 1)
         import_error = import_errors[0]
@@ -3220,8 +3236,8 @@ def test_no_import_errors_with_parseable_dag(self):
         finally:
             shutil.rmtree(dags_folder)
 
-        session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        with create_session() as session:
+            import_errors = session.query(models.ImportError).all()
 
         self.assertEqual(len(import_errors), 0)
 
@@ -3293,8 +3309,8 @@ def test_remove_file_clears_import_error(self):
         # Rerun the scheduler once the dag file has been removed
         self.run_single_scheduler_loop_with_no_dags(dags_folder)
 
-        session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        with create_session() as session:
+            import_errors = session.query(models.ImportError).all()
 
         self.assertEqual(len(import_errors), 0)
 
diff --git a/tests/models.py b/tests/models.py
index 8375a95a30760..9e09f76a43900 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -23,43 +23,44 @@
 from __future__ import unicode_literals
 
 import datetime
+import inspect
 import logging
 import os
-import pendulum
-import unittest
-import time
-import six
 import re
-import urllib
 import textwrap
-import inspect
+import time
+import unittest
+import urllib
+from tempfile import NamedTemporaryFile, mkdtemp
 
-from airflow import configuration, models, settings, AirflowException
+import pendulum
+import six
+from mock import ANY, Mock, patch
+from parameterized import parameterized
+
+from airflow import AirflowException, configuration, models, settings
 from airflow.exceptions import AirflowDagCycleException, AirflowSkipException
 from airflow.jobs import BackfillJob
+from airflow.models import Connection
 from airflow.models import DAG, TaskInstance as TI
-from airflow.models import DagRun
-from airflow.models import State as ST
 from airflow.models import DagModel, DagRun, DagStat
-from airflow.models import clear_task_instances
-from airflow.models import XCom
-from airflow.models import Connection
-from airflow.models import SkipMixin
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
-from airflow.jobs import LocalTaskJob
-from airflow.operators.dummy_operator import DummyOperator
+from airflow.models import SkipMixin
+from airflow.models import State as ST
+from airflow.models import XCom
+from airflow.models import clear_task_instances
 from airflow.operators.bash_operator import BashOperator
+from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import PythonOperator
 from airflow.operators.python_operator import ShortCircuitOperator
 from airflow.operators.subdag_operator import SubDagOperator
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
 from airflow.utils import timezone
-from airflow.utils.weight_rule import WeightRule
+from airflow.utils.dag_processing import SimpleTaskInstance
+from airflow.utils.db import create_session
 from airflow.utils.state import State
 from airflow.utils.trigger_rule import TriggerRule
-from mock import patch, Mock, ANY
-from parameterized import parameterized
-from tempfile import mkdtemp, NamedTemporaryFile
+from airflow.utils.weight_rule import WeightRule
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 TEST_DAGS_FOLDER = os.path.join(
@@ -1710,31 +1711,28 @@ def test_process_file_with_none(self):
         self.assertEqual([], dagbag.process_file(None))
 
     @patch.object(TI, 'handle_failure')
-    def test_kill_zombies(self, mock_ti):
+    def test_kill_zombies(self, mock_ti_handle_failure):
         """
         Test that kill zombies call TIs failure handler with proper context
         """
         dagbag = models.DagBag()
-        session = settings.Session
-        dag = dagbag.get_dag('example_branch_operator')
-        task = dag.get_task(task_id='run_this_first')
-
-        ti = TI(task, datetime.datetime.now() - datetime.timedelta(1), 'running')
-        lj = LocalTaskJob(ti)
-        lj.state = State.SHUTDOWN
-
-        session.add(lj)
-        session.commit()
-
-        ti.job_id = lj.id
-
-        session.add(ti)
-        session.commit()
-
-        dagbag.kill_zombies()
-        mock_ti.assert_called_with(ANY,
-                                   configuration.getboolean('core', 'unit_test_mode'),
-                                   ANY)
+        with create_session() as session:
+            session.query(TI).delete()
+            dag = dagbag.get_dag('example_branch_operator')
+            task = dag.get_task(task_id='run_this_first')
+
+            ti = TI(task, DEFAULT_DATE, State.RUNNING)
+
+            session.add(ti)
+            session.commit()
+
+            zombies = [SimpleTaskInstance(ti)]
+            dagbag.kill_zombies(zombies)
+            mock_ti_handle_failure \
+                .assert_called_with(ANY,
+                                    configuration.getboolean('core',
+                                                             'unit_test_mode'),
+                                    ANY)
 
     def test_deactivate_unknown_dags(self):
         """
diff --git a/tests/utils/test_dag_processing.py b/tests/utils/test_dag_processing.py
index f29e384b8c657..94c39feb4eede 100644
--- a/tests/utils/test_dag_processing.py
+++ b/tests/utils/test_dag_processing.py
@@ -17,11 +17,26 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import os
 import unittest
+from datetime import timedelta
 
 from mock import MagicMock
 
-from airflow.utils.dag_processing import DagFileProcessorManager
+from airflow import configuration as conf
+from airflow.jobs import DagFileProcessor
+from airflow.jobs import LocalTaskJob as LJ
+from airflow.models import DagBag, TaskInstance as TI
+from airflow.utils import timezone
+from airflow.utils.dag_processing import (DagFileProcessorAgent, DagFileProcessorManager,
+                                          SimpleTaskInstance)
+from airflow.utils.db import create_session
+from airflow.utils.state import State
+
+TEST_DAG_FOLDER = os.path.join(
+    os.path.dirname(os.path.realpath(__file__)), os.pardir, 'dags')
+
+DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 
 
 class TestDagFileProcessorManager(unittest.TestCase):
@@ -29,10 +44,12 @@ def test_set_file_paths_when_processor_file_path_not_in_new_file_paths(self):
         manager = DagFileProcessorManager(
             dag_directory='directory',
             file_paths=['abc.txt'],
-            parallelism=1,
-            process_file_interval=1,
             max_runs=1,
-            processor_factory=MagicMock().return_value)
+            processor_factory=MagicMock().return_value,
+            signal_conn=MagicMock(),
+            stat_queue=MagicMock(),
+            result_queue=MagicMock,
+            async_mode=True)
 
         mock_processor = MagicMock()
         mock_processor.stop.side_effect = AttributeError(
@@ -48,10 +65,12 @@ def test_set_file_paths_when_processor_file_path_is_in_new_file_paths(self):
         manager = DagFileProcessorManager(
             dag_directory='directory',
             file_paths=['abc.txt'],
-            parallelism=1,
-            process_file_interval=1,
             max_runs=1,
-            processor_factory=MagicMock().return_value)
+            processor_factory=MagicMock().return_value,
+            signal_conn=MagicMock(),
+            stat_queue=MagicMock(),
+            result_queue=MagicMock,
+            async_mode=True)
 
         mock_processor = MagicMock()
         mock_processor.stop.side_effect = AttributeError(
@@ -62,3 +81,107 @@ def test_set_file_paths_when_processor_file_path_is_in_new_file_paths(self):
 
         manager.set_file_paths(['abc.txt'])
         self.assertDictEqual(manager._processors, {'abc.txt': mock_processor})
+
+    def test_find_zombies(self):
+        manager = DagFileProcessorManager(
+            dag_directory='directory',
+            file_paths=['abc.txt'],
+            max_runs=1,
+            processor_factory=MagicMock().return_value,
+            signal_conn=MagicMock(),
+            stat_queue=MagicMock(),
+            result_queue=MagicMock,
+            async_mode=True)
+
+        dagbag = DagBag(TEST_DAG_FOLDER)
+        with create_session() as session:
+            session.query(LJ).delete()
+            dag = dagbag.get_dag('example_branch_operator')
+            task = dag.get_task(task_id='run_this_first')
+
+            ti = TI(task, DEFAULT_DATE, State.RUNNING)
+            lj = LJ(ti)
+            lj.state = State.SHUTDOWN
+            lj.id = 1
+            ti.job_id = lj.id
+
+            session.add(lj)
+            session.add(ti)
+            session.commit()
+
+            manager._last_zombie_query_time = timezone.utcnow() - timedelta(
+                seconds=manager._zombie_threshold_secs + 1)
+            zombies = manager._find_zombies()
+            self.assertEquals(1, len(zombies))
+            self.assertIsInstance(zombies[0], SimpleTaskInstance)
+            self.assertEquals(ti.dag_id, zombies[0].dag_id)
+            self.assertEquals(ti.task_id, zombies[0].task_id)
+            self.assertEquals(ti.execution_date, zombies[0].execution_date)
+
+            session.query(TI).delete()
+            session.query(LJ).delete()
+
+
+class TestDagFileProcessorAgent(unittest.TestCase):
+    def test_parse_once(self):
+        def processor_factory(file_path, zombies):
+            return DagFileProcessor(file_path,
+                                    False,
+                                    [],
+                                    zombies)
+
+        test_dag_path = os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py')
+        async_mode = 'sqlite' not in conf.get('core', 'sql_alchemy_conn')
+        processor_agent = DagFileProcessorAgent(test_dag_path,
+                                                [test_dag_path],
+                                                1,
+                                                processor_factory,
+                                                async_mode)
+        processor_agent.start()
+        parsing_result = []
+        while not processor_agent.done:
+            if not async_mode:
+                processor_agent.heartbeat()
+                processor_agent.wait_until_finished()
+            parsing_result.extend(processor_agent.harvest_simple_dags())
+
+        dag_ids = [result.dag_id for result in parsing_result]
+        self.assertEqual(dag_ids.count('test_start_date_scheduling'), 1)
+
+    def test_launch_process(self):
+        def processor_factory(file_path, zombies):
+            return DagFileProcessor(file_path,
+                                    False,
+                                    [],
+                                    zombies)
+
+        test_dag_path = os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py')
+        async_mode = 'sqlite' not in conf.get('core', 'sql_alchemy_conn')
+
+        log_file_loc = conf.get('core', 'DAG_PROCESSOR_MANAGER_LOG_LOCATION')
+        try:
+            os.remove(log_file_loc)
+        except OSError:
+            pass
+
+        # Starting dag processing with 0 max_runs to avoid redundent operations.
+        processor_agent = DagFileProcessorAgent(test_dag_path,
+                                                [],
+                                                0,
+                                                processor_factory,
+                                                async_mode)
+        manager_process = \
+            processor_agent._launch_process(processor_agent._dag_directory,
+                                            processor_agent._file_paths,
+                                            processor_agent._max_runs,
+                                            processor_agent._processor_factory,
+                                            processor_agent._child_signal_conn,
+                                            processor_agent._stat_queue,
+                                            processor_agent._result_queue,
+                                            processor_agent._async_mode)
+        if not async_mode:
+            processor_agent.heartbeat()
+
+        manager_process.join()
+
+        self.assertTrue(os.path.isfile(log_file_loc))

From fa8ffdde364c6ad4a47b71d5d0d46f50d85d664f Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 7 Nov 2018 11:07:15 +0000
Subject: [PATCH 210/808] [AIRFLOW-XXX] Pin Flask App Builder to Fix CI (#4150)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index ee3935b76c271..3af146d5a301d 100644
--- a/setup.py
+++ b/setup.py
@@ -275,7 +275,7 @@ def do_setup():
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
             'flask>=0.12.4, <0.13',
-            'flask-appbuilder>=1.12, <2.0.0',
+            'flask-appbuilder==1.12.1',
             'flask-admin==1.4.1',
             'flask-caching>=1.3.3, <1.4.0',
             'flask-login>=0.3, <0.5',

From c4a7159ac126d66c4a8e06bec5b13c7b1683a3b1 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Tue, 13 Nov 2018 00:32:19 +0100
Subject: [PATCH 211/808] [AIRFLOW-3220] Add Instance Group Manager Operators
 for GCE (#4167)

---
 .gitignore                                    |   6 +
 .../example_dags/example_gcp_compute.py       |  36 +-
 .../example_dags/example_gcp_compute_igm.py   | 143 ++++
 .../example_gcp_function_delete.py            |   6 +-
 .../example_gcp_function_deploy_delete.py     |  23 +-
 airflow/contrib/hooks/gcp_compute_hook.py     | 198 ++++-
 airflow/contrib/hooks/gcp_function_hook.py    |   4 +-
 .../contrib/operators/gcp_compute_operator.py | 276 ++++++-
 .../operators/gcp_function_operator.py        |   8 +-
 airflow/contrib/utils/gcp_field_sanitizer.py  | 162 ++++
 docs/howto/operator.rst                       | 298 +++++++-
 docs/integration.rst                          |  46 +-
 setup.py                                      |   1 +
 .../operators/test_gcp_compute_operator.py    | 718 +++++++++++++++++-
 14 files changed, 1790 insertions(+), 135 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_compute_igm.py
 create mode 100644 airflow/contrib/utils/gcp_field_sanitizer.py

diff --git a/.gitignore b/.gitignore
index 0e53aaded07b6..5712aee6c549a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -138,3 +138,9 @@ rat-results.txt
 *.generated
 *.tar.gz
 scripts/ci/kubernetes/kube/.generated/airflow.yaml
+
+# Airflow log files when airflow is run locally
+airflow-*.err
+airflow-*.out
+airflow-*.log
+airflow-*.pid
diff --git a/airflow/contrib/example_dags/example_gcp_compute.py b/airflow/contrib/example_dags/example_gcp_compute.py
index e4abe2e152a00..51a55b6a99053 100644
--- a/airflow/contrib/example_dags/example_gcp_compute.py
+++ b/airflow/contrib/example_dags/example_gcp_compute.py
@@ -24,7 +24,7 @@
 This DAG relies on the following Airflow variables
 https://airflow.apache.org/concepts.html#variables
 * PROJECT_ID - Google Cloud Platform project where the Compute Engine instance exists.
-* LOCATION - Google Cloud Platform zone where the instance exists.
+* ZONE - Google Cloud Platform zone where the instance exists.
 * INSTANCE - Name of the Compute Engine instance.
 * SHORT_MACHINE_TYPE_NAME - Machine type resource name to set, e.g. 'n1-standard-1'.
     See https://cloud.google.com/compute/docs/machine-types
@@ -37,19 +37,23 @@
 from airflow.contrib.operators.gcp_compute_operator import GceInstanceStartOperator, \
     GceInstanceStopOperator, GceSetMachineTypeOperator
 
-# [START howto_operator_gce_args]
-PROJECT_ID = models.Variable.get('PROJECT_ID', '')
-LOCATION = models.Variable.get('LOCATION', '')
-INSTANCE = models.Variable.get('INSTANCE', '')
-SHORT_MACHINE_TYPE_NAME = models.Variable.get('SHORT_MACHINE_TYPE_NAME', '')
-SET_MACHINE_TYPE_BODY = {
-    'machineType': 'zones/{}/machineTypes/{}'.format(LOCATION, SHORT_MACHINE_TYPE_NAME)
-}
+# [START howto_operator_gce_args_common]
+PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
+ZONE = models.Variable.get('ZONE', 'europe-west1-b')
+INSTANCE = models.Variable.get('INSTANCE', 'test-instance')
 
 default_args = {
     'start_date': airflow.utils.dates.days_ago(1)
 }
-# [END howto_operator_gce_args]
+# [END howto_operator_gce_args_common]
+
+# [START howto_operator_gce_args_set_machine_type]
+SHORT_MACHINE_TYPE_NAME = models.Variable.get('SHORT_MACHINE_TYPE_NAME', 'n1-standard-1')
+SET_MACHINE_TYPE_BODY = {
+    'machineType': 'zones/{}/machineTypes/{}'.format(ZONE, SHORT_MACHINE_TYPE_NAME)
+}
+# [END howto_operator_gce_args_set_machine_type]
+
 
 with models.DAG(
     'example_gcp_compute',
@@ -59,7 +63,7 @@
     # [START howto_operator_gce_start]
     gce_instance_start = GceInstanceStartOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         task_id='gcp_compute_start_task'
     )
@@ -67,14 +71,14 @@
     # Duplicate start for idempotence testing
     gce_instance_start2 = GceInstanceStartOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         task_id='gcp_compute_start_task2'
     )
     # [START howto_operator_gce_stop]
     gce_instance_stop = GceInstanceStopOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         task_id='gcp_compute_stop_task'
     )
@@ -82,14 +86,14 @@
     # Duplicate stop for idempotence testing
     gce_instance_stop2 = GceInstanceStopOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         task_id='gcp_compute_stop_task2'
     )
     # [START howto_operator_gce_set_machine_type]
     gce_set_machine_type = GceSetMachineTypeOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         body=SET_MACHINE_TYPE_BODY,
         task_id='gcp_compute_set_machine_type'
@@ -98,7 +102,7 @@
     # Duplicate set machine type for idempotence testing
     gce_set_machine_type2 = GceSetMachineTypeOperator(
         project_id=PROJECT_ID,
-        zone=LOCATION,
+        zone=ZONE,
         resource_id=INSTANCE,
         body=SET_MACHINE_TYPE_BODY,
         task_id='gcp_compute_set_machine_type2'
diff --git a/airflow/contrib/example_dags/example_gcp_compute_igm.py b/airflow/contrib/example_dags/example_gcp_compute_igm.py
new file mode 100644
index 0000000000000..dc24259f9f119
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_compute_igm.py
@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that uses IGM-type compute operations:
+* copy of Instance Template
+* update template in Instance Group Manager
+
+This DAG relies on the following OS environment variables
+
+* PROJECT_ID - the Google Cloud Platform project where the Compute Engine instance exists
+* ZONE - the zone where the Compute Engine instance exists
+
+Variables for copy template operator:
+* TEMPLATE_NAME - name of the template to copy
+* NEW_TEMPLATE_NAME - name of the new template
+* NEW_DESCRIPTION - description added to the template
+
+Variables for update template in Group Manager:
+
+* INSTANCE_GROUP_MANAGER_NAME - name of the Instance Group Manager
+* SOURCE_TEMPLATE_URL - url of the template to replace in the Instance Group Manager
+* DESTINATION_TEMPLATE_URL - url of the new template to set in the Instance Group Manager
+"""
+
+import os
+import datetime
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_compute_operator import \
+    GceInstanceTemplateCopyOperator, GceInstanceGroupManagerUpdateTemplateOperator
+
+# [START howto_operator_compute_igm_common_args]
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+ZONE = os.environ.get('ZONE', 'europe-west1-b')
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+# [END howto_operator_compute_igm_common_args]
+
+# [START howto_operator_compute_template_copy_args]
+TEMPLATE_NAME = os.environ.get('TEMPLATE_NAME', 'instance-template-test')
+NEW_TEMPLATE_NAME = os.environ.get('NEW_TEMPLATE_NAME',
+                                   'instance-template-test-new')
+NEW_DESCRIPTION = os.environ.get('NEW_DESCRIPTION', 'Test new description')
+GCE_INSTANCE_TEMPLATE_BODY_UPDATE = {
+    "name": NEW_TEMPLATE_NAME,
+    "description": NEW_DESCRIPTION,
+    "properties": {
+        "machineType": "n1-standard-2"
+    }
+}
+# [END howto_operator_compute_template_copy_args]
+
+# [START howto_operator_compute_igm_update_template_args]
+INSTANCE_GROUP_MANAGER_NAME = os.environ.get('INSTANCE_GROUP_MANAGER_NAME',
+                                             'instance-group-test')
+
+SOURCE_TEMPLATE_URL = os.environ.get(
+    'SOURCE_TEMPLATE_URL',
+    "https://www.googleapis.com/compute/beta/projects/"
+    "example-project/global/instanceTemplates/instance-template-test")
+
+DESTINATION_TEMPLATE_URL = os.environ.get(
+    'DESTINATION_TEMPLATE_URL',
+    "https://www.googleapis.com/compute/beta/projects/"
+    "example-airflow/global/instanceTemplates/" + NEW_TEMPLATE_NAME)
+
+UPDATE_POLICY = {
+    "type": "OPPORTUNISTIC",
+    "minimalAction": "RESTART",
+    "maxSurge": {
+        "fixed": 1
+    },
+    "minReadySec": 1800
+}
+
+# [END howto_operator_compute_igm_update_template_args]
+
+
+with models.DAG(
+    'example_gcp_compute_igm',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_gce_igm_copy_template]
+    gce_instance_template_copy = GceInstanceTemplateCopyOperator(
+        project_id=PROJECT_ID,
+        resource_id=TEMPLATE_NAME,
+        body_patch=GCE_INSTANCE_TEMPLATE_BODY_UPDATE,
+        task_id='gcp_compute_igm_copy_template_task'
+    )
+    # [END howto_operator_gce_igm_copy_template]
+    # Added to check for idempotence
+    gce_instance_template_copy2 = GceInstanceTemplateCopyOperator(
+        project_id=PROJECT_ID,
+        resource_id=TEMPLATE_NAME,
+        body_patch=GCE_INSTANCE_TEMPLATE_BODY_UPDATE,
+        task_id='gcp_compute_igm_copy_template_task_2'
+    )
+    # [START howto_operator_gce_igm_update_template]
+    gce_instance_group_manager_update_template = \
+        GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            resource_id=INSTANCE_GROUP_MANAGER_NAME,
+            zone=ZONE,
+            source_template=SOURCE_TEMPLATE_URL,
+            destination_template=DESTINATION_TEMPLATE_URL,
+            update_policy=UPDATE_POLICY,
+            task_id='gcp_compute_igm_group_manager_update_template'
+        )
+    # [END howto_operator_gce_igm_update_template]
+    # Added to check for idempotence (and without UPDATE_POLICY)
+    gce_instance_group_manager_update_template2 = \
+        GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            resource_id=INSTANCE_GROUP_MANAGER_NAME,
+            zone=ZONE,
+            source_template=SOURCE_TEMPLATE_URL,
+            destination_template=DESTINATION_TEMPLATE_URL,
+            task_id='gcp_compute_igm_group_manager_update_template_2'
+        )
+    gce_instance_template_copy >> gce_instance_template_copy2 >> \
+        gce_instance_group_manager_update_template >> \
+        gce_instance_group_manager_update_template2
diff --git a/airflow/contrib/example_dags/example_gcp_function_delete.py b/airflow/contrib/example_dags/example_gcp_function_delete.py
index 30f5369af60ef..d87eed39c530f 100644
--- a/airflow/contrib/example_dags/example_gcp_function_delete.py
+++ b/airflow/contrib/example_dags/example_gcp_function_delete.py
@@ -33,9 +33,9 @@
 from airflow.contrib.operators.gcp_function_operator import GcfFunctionDeleteOperator
 
 # [START howto_operator_gcf_delete_args]
-PROJECT_ID = models.Variable.get('PROJECT_ID', '')
-LOCATION = models.Variable.get('LOCATION', '')
-ENTRYPOINT = models.Variable.get('ENTRYPOINT', '')
+PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
+LOCATION = models.Variable.get('LOCATION', 'europe-west1')
+ENTRYPOINT = models.Variable.get('ENTRYPOINT', 'helloWorld')
 # A fully-qualified name of the function to delete
 
 FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
diff --git a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
index a0e44957b9204..606cc181b0ca4 100644
--- a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+++ b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
@@ -45,11 +45,14 @@
 from airflow.utils import dates
 
 # [START howto_operator_gcf_deploy_variables]
-PROJECT_ID = models.Variable.get('PROJECT_ID', '')
-LOCATION = models.Variable.get('LOCATION', '')
+PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
+LOCATION = models.Variable.get('LOCATION', 'europe-west1')
 SOURCE_ARCHIVE_URL = models.Variable.get('SOURCE_ARCHIVE_URL', '')
 SOURCE_UPLOAD_URL = models.Variable.get('SOURCE_UPLOAD_URL', '')
-SOURCE_REPOSITORY = models.Variable.get('SOURCE_REPOSITORY', '')
+SOURCE_REPOSITORY = models.Variable.get('SOURCE_REPOSITORY',
+                                        'https://source.developers.google.com/'
+                                        'projects/example-airflow/'
+                                        'repos/hello-world/moveable-aliases/master')
 ZIP_PATH = models.Variable.get('ZIP_PATH', '')
 ENTRYPOINT = models.Variable.get('ENTRYPOINT', '')
 FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
@@ -70,11 +73,7 @@
 
 # [START howto_operator_gcf_deploy_args]
 default_args = {
-    'start_date': dates.days_ago(1),
-    'project_id': PROJECT_ID,
-    'location': LOCATION,
-    'body': body,
-    'validate_body': VALIDATE_BODY
+    'start_date': dates.days_ago(1)
 }
 # [END howto_operator_gcf_deploy_args]
 
@@ -103,11 +102,15 @@
     # [START howto_operator_gcf_deploy]
     deploy_task = GcfFunctionDeployOperator(
         task_id="gcf_deploy_task",
-        name=FUNCTION_NAME
+        name=FUNCTION_NAME,
+        project_id=PROJECT_ID,
+        location=LOCATION,
+        body=body,
+        validate_body=VALIDATE_BODY
     )
     # [END howto_operator_gcf_deploy]
     delete_task = GcfFunctionDeleteOperator(
         task_id="gcf_delete_task",
-        name=FUNCTION_NAME
+        name=FUNCTION_NAME,
     )
     deploy_task >> delete_task
diff --git a/airflow/contrib/hooks/gcp_compute_hook.py b/airflow/contrib/hooks/gcp_compute_hook.py
index 5fa088942b706..617e39cb4006e 100644
--- a/airflow/contrib/hooks/gcp_compute_hook.py
+++ b/airflow/contrib/hooks/gcp_compute_hook.py
@@ -68,14 +68,14 @@ def start_instance(self, project_id, zone, resource_id):
         """
         Starts an existing instance defined by project_id, zone and resource_id.
 
-        :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance exists
         :type project_id: str
-        :param zone: Google Cloud Platform zone where the instance exists.
+        :param zone: Google Cloud Platform zone where the instance exists
         :type zone: str
-        :param resource_id: Name of the Compute Engine instance resource.
+        :param resource_id: Name of the Compute Engine instance resource
         :type resource_id: str
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().instances().start(
@@ -83,21 +83,26 @@ def start_instance(self, project_id, zone, resource_id):
             zone=zone,
             instance=resource_id
         ).execute(num_retries=NUM_RETRIES)
-        operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+        try:
+            operation_name = response["name"]
+        except KeyError:
+            raise AirflowException(
+                "Wrong response '{}' returned - it should contain "
+                "'name' field".format(response))
+        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
 
     def stop_instance(self, project_id, zone, resource_id):
         """
-        Stops an instance defined by project_id, zone and resource_id.
+        Stops an instance defined by project_id, zone and resource_id
 
-        :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance exists
         :type project_id: str
-        :param zone: Google Cloud Platform zone where the instance exists.
+        :param zone: Google Cloud Platform zone where the instance exists
         :type zone: str
-        :param resource_id: Name of the Compute Engine instance resource.
+        :param resource_id: Name of the Compute Engine instance resource
         :type resource_id: str
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().instances().stop(
@@ -105,50 +110,178 @@ def stop_instance(self, project_id, zone, resource_id):
             zone=zone,
             instance=resource_id
         ).execute(num_retries=NUM_RETRIES)
-        operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+        try:
+            operation_name = response["name"]
+        except KeyError:
+            raise AirflowException(
+                "Wrong response '{}' returned - it should contain "
+                "'name' field".format(response))
+        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
 
     def set_machine_type(self, project_id, zone, resource_id, body):
         """
         Sets machine type of an instance defined by project_id, zone and resource_id.
 
-        :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance exists
         :type project_id: str
         :param zone: Google Cloud Platform zone where the instance exists.
         :type zone: str
-        :param resource_id: Name of the Compute Engine instance resource.
+        :param resource_id: Name of the Compute Engine instance resource
         :type resource_id: str
         :param body: Body required by the Compute Engine setMachineType API,
-        as described in
-        https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType
+            as described in
+            https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self._execute_set_machine_type(project_id, zone, resource_id, body)
-        operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, zone, operation_name)
+        try:
+            operation_name = response["name"]
+        except KeyError:
+            raise AirflowException(
+                "Wrong response '{}' returned - it should contain "
+                "'name' field".format(response))
+        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
 
     def _execute_set_machine_type(self, project_id, zone, resource_id, body):
         return self.get_conn().instances().setMachineType(
             project=project_id, zone=zone, instance=resource_id, body=body)\
             .execute(num_retries=NUM_RETRIES)
 
-    def _wait_for_operation_to_complete(self, project_id, zone, operation_name):
+    def get_instance_template(self, project_id, resource_id):
         """
-        Waits for the named operation to complete - checks status of the
-        asynchronous call.
+        Retrieves instance template by project_id and resource_id.
+
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance template exists
+        :type project_id: str
+        :param resource_id: Name of the instance template
+        :type resource_id: str
+        :return: Instance template representation as object according to
+            https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates
+        :rtype: dict
+        """
+        response = self.get_conn().instanceTemplates().get(
+            project=project_id,
+            instanceTemplate=resource_id
+        ).execute(num_retries=NUM_RETRIES)
+        return response
+
+    def insert_instance_template(self, project_id, body, request_id=None):
+        """
+        Inserts instance template using body specified
+
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance exists
+        :type project_id: str
+        :param body: Instance template representation as object according to
+            https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates
+        :type body: dict
+        :param request_id: Optional, unique request_id that you might add to achieve
+            full idempotence (for example when client call times out repeating the request
+            with the same request id will not create a new instance template again)
+            It should be in UUID format as defined in RFC 4122
+        :type request_id: str
+        :return: True if the operation succeeded
+        :rtype: bool
+        """
+        response = self.get_conn().instanceTemplates().insert(
+            project=project_id,
+            body=body,
+            requestId=request_id
+        ).execute(num_retries=NUM_RETRIES)
+        try:
+            operation_name = response["name"]
+        except KeyError:
+            raise AirflowException(
+                "Wrong response '{}' returned - it should contain "
+                "'name' field".format(response))
+        return self._wait_for_operation_to_complete(project_id, operation_name)
+
+    def get_instance_group_manager(self, project_id, zone, resource_id):
+        """
+        Retrieves Instance Group Manager by project_id, zone and resource_id.
+
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance Group Manager exists
+        :type project_id: str
+        :param zone: Google Cloud Platform zone where the Instance Group Manager exists
+        :type zone: str
+        :param resource_id: Name of the Instance Group Manager
+        :type resource_id: str
+        :return: Instance group manager representation as object according to
+            https://cloud.google.com/compute/docs/reference/rest/beta/instanceGroupManagers
+        :rtype: dict
+        """
+        response = self.get_conn().instanceGroupManagers().get(
+            project=project_id,
+            zone=zone,
+            instanceGroupManager=resource_id
+        ).execute(num_retries=NUM_RETRIES)
+        return response
+
+    def patch_instance_group_manager(self, project_id, zone, resource_id,
+                                     body, request_id=None):
+        """
+        Patches Instance Group Manager with the specified body.
+
+        :param project_id: Google Cloud Platform project ID where the Compute Engine
+            Instance Group Manager exists
+        :type project_id: str
+        :param zone: Google Cloud Platform zone where the Instance Group Manager exists
+        :type zone: str
+        :param resource_id: Name of the Instance Group Manager
+        :type resource_id: str
+        :param body: Instance Group Manager representation as json-merge-patch object
+            according to
+            https://cloud.google.com/compute/docs/reference/rest/beta/instanceTemplates/patch
+        :type body: dict
+        :param request_id: Optional, unique request_id that you might add to achieve
+            full idempotence (for example when client call times out repeating the request
+            with the same request id will not create a new instance template again).
+            It should be in UUID format as defined in RFC 4122
+        :type request_id: str
+        :return: True if the operation succeeded
+        :rtype: bool
+        """
+        response = self.get_conn().instanceGroupManagers().patch(
+            project=project_id,
+            zone=zone,
+            instanceGroupManager=resource_id,
+            body=body,
+            requestId=request_id
+        ).execute(num_retries=NUM_RETRIES)
+        try:
+            operation_name = response["name"]
+        except KeyError:
+            raise AirflowException(
+                "Wrong response '{}' returned - it should contain "
+                "'name' field".format(response))
+        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
+
+    def _wait_for_operation_to_complete(self, project_id, operation_name, zone=None):
+        """
+        Waits for the named operation to complete - checks status of the async call.
 
         :param operation_name: name of the operation
         :type operation_name: str
+        :param zone: optional region of the request (might be None for global operations)
+        :type zone: str
         :return: True if the operation succeeded, raises an error otherwise
         :rtype: bool
         """
         service = self.get_conn()
         while True:
-            operation_response = self._check_operation_status(
-                service, operation_name, project_id, zone)
+            if zone is None:
+                # noinspection PyTypeChecker
+                operation_response = self._check_global_operation_status(
+                    service, operation_name, project_id)
+            else:
+                # noinspection PyTypeChecker
+                operation_response = self._check_zone_operation_status(
+                    service, operation_name, project_id, zone)
             if operation_response.get("status") == GceOperationStatus.DONE:
                 error = operation_response.get("error")
                 if error:
@@ -161,7 +294,14 @@ def _wait_for_operation_to_complete(self, project_id, zone, operation_name):
                 return True
             time.sleep(TIME_TO_SLEEP_IN_SECONDS)
 
-    def _check_operation_status(self, service, operation_name, project_id, zone):
+    @staticmethod
+    def _check_zone_operation_status(service, operation_name, project_id, zone):
         return service.zoneOperations().get(
             project=project_id, zone=zone, operation=operation_name).execute(
             num_retries=NUM_RETRIES)
+
+    @staticmethod
+    def _check_global_operation_status(service, operation_name, project_id):
+        return service.globalOperations().get(
+            project=project_id, operation=operation_name).execute(
+            num_retries=NUM_RETRIES)
diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
index d89b5b0ec80d2..29cef1716c327 100644
--- a/airflow/contrib/hooks/gcp_function_hook.py
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -65,7 +65,7 @@ def get_function(self, name):
 
         :param name: name of the function
         :type name: str
-        :return: a CloudFunction object representing the function
+        :return: a Cloud Functions object representing the function
         :rtype: dict
         """
         return self.get_conn().projects().locations().functions().get(
@@ -78,7 +78,7 @@ def list_functions(self, full_location):
         :param full_location: full location including the project in the form of
             of /projects/<PROJECT>/location/<LOCATION>
         :type full_location: str
-        :return: array of CloudFunction objects - representing functions in the location
+        :return: array of Cloud Functions objects - representing functions in the location
         :rtype: [dict]
         """
         list_response = self.get_conn().projects().locations().functions().list(
diff --git a/airflow/contrib/operators/gcp_compute_operator.py b/airflow/contrib/operators/gcp_compute_operator.py
index a2fd54529429c..a872c17227ddf 100644
--- a/airflow/contrib/operators/gcp_compute_operator.py
+++ b/airflow/contrib/operators/gcp_compute_operator.py
@@ -16,18 +16,24 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+from copy import deepcopy
+
+from googleapiclient.errors import HttpError
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_compute_hook import GceHook
+from airflow.contrib.utils.gcp_field_sanitizer import GcpBodyFieldSanitizer
 from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
+from json_merge_patch import merge
 
 
 class GceBaseOperator(BaseOperator):
     """
     Abstract base operator for Google Compute Engine operators to inherit from.
     """
+
     @apply_defaults
     def __init__(self,
                  project_id,
@@ -61,10 +67,10 @@ def execute(self, context):
 
 class GceInstanceStartOperator(GceBaseOperator):
     """
-    Start an instance in Google Compute Engine.
+    Starts an instance in Google Compute Engine.
 
-    :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+    :param project_id: Google Cloud Platform Project ID where the Compute Engine
+        Instance exists.
     :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
@@ -72,10 +78,12 @@ class GceInstanceStartOperator(GceBaseOperator):
     :type resource_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (for example v1 or beta).
     :type api_version: str
     """
+    # [START gce_instance_start_template_fields]
     template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+    # [END gce_instance_start_template_fields]
 
     @apply_defaults
     def __init__(self,
@@ -95,10 +103,10 @@ def execute(self, context):
 
 class GceInstanceStopOperator(GceBaseOperator):
     """
-    Stop an instance in Google Compute Engine.
+    Stops an instance in Google Compute Engine.
 
-    :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+    :param project_id: Google Cloud Platform Project ID where the Compute Engine
+        Instance exists.
     :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
@@ -106,10 +114,12 @@ class GceInstanceStopOperator(GceBaseOperator):
     :type resource_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (for example v1 or beta).
     :type api_version: str
     """
+    # [START gce_instance_stop_template_fields]
     template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+    # [END gce_instance_stop_template_fields]
 
     @apply_defaults
     def __init__(self,
@@ -135,10 +145,10 @@ def execute(self, context):
 class GceSetMachineTypeOperator(GceBaseOperator):
     """
     Changes the machine type for a stopped instance to the machine type specified in
-    the request.
+        the request.
 
-    :param project_id: Google Cloud Platform project where the Compute Engine
-        instance exists.
+    :param project_id: Google Cloud Platform Project ID where the Compute Engine
+        Instance exists.
     :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
@@ -149,10 +159,14 @@ class GceSetMachineTypeOperator(GceBaseOperator):
     :type body: dict
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (for example v1 or beta).
     :type api_version: str
+    :param validate_body: If set to False, body validation is not performed.
+    :type validate_body: bool
     """
+    # [START gce_instance_set_machine_type_template_fields]
     template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
+    # [END gce_instance_set_machine_type_template_fields]
 
     @apply_defaults
     def __init__(self,
@@ -181,3 +195,241 @@ def execute(self, context):
         self._validate_all_body_fields()
         return self._hook.set_machine_type(self.project_id, self.zone,
                                            self.resource_id, self.body)
+
+
+GCE_INSTANCE_TEMPLATE_VALIDATION_PATCH_SPECIFICATION = [
+    dict(name="name", regexp="^.+$"),
+    dict(name="description", optional=True),
+    dict(name="properties", type='dict', optional=True, fields=[
+        dict(name="description", optional=True),
+        dict(name="tags", optional=True, fields=[
+            dict(name="items", optional=True)
+        ]),
+        dict(name="machineType", optional=True),
+        dict(name="canIpForward", optional=True),
+        dict(name="networkInterfaces", optional=True),  # not validating deeper
+        dict(name="disks", optional=True),  # not validating the array deeper
+        dict(name="metadata", optional=True, fields=[
+            dict(name="fingerprint", optional=True),
+            dict(name="items", optional=True),
+            dict(name="kind", optional=True),
+        ]),
+        dict(name="serviceAccounts", optional=True),  # not validating deeper
+        dict(name="scheduling", optional=True, fields=[
+            dict(name="onHostMaintenance", optional=True),
+            dict(name="automaticRestart", optional=True),
+            dict(name="preemptible", optional=True),
+            dict(name="nodeAffinitites", optional=True),  # not validating deeper
+        ]),
+        dict(name="labels", optional=True),
+        dict(name="guestAccelerators", optional=True),  # not validating deeper
+        dict(name="minCpuPlatform", optional=True),
+    ]),
+]
+
+GCE_INSTANCE_TEMPLATE_FIELDS_TO_SANITIZE = [
+    "kind",
+    "id",
+    "name",
+    "creationTimestamp",
+    "properties.disks.sha256",
+    "properties.disks.kind",
+    "properties.disks.sourceImageEncryptionKey.sha256",
+    "properties.disks.index",
+    "properties.disks.licenses",
+    "properties.networkInterfaces.kind",
+    "properties.networkInterfaces.accessConfigs.kind",
+    "properties.networkInterfaces.name",
+    "properties.metadata.kind",
+    "selfLink"
+]
+
+
+class GceInstanceTemplateCopyOperator(GceBaseOperator):
+    """
+    Copies the instance template, applying specified changes.
+
+    :param project_id: Google Cloud Platform Project ID where the Compute Engine
+        instance exists.
+    :type project_id: str
+    :param resource_id: Name of the Instance Template
+    :type resource_id: str
+    :param body_patch: Patch to the body of instanceTemplates object following rfc7386
+        PATCH semantics. The body_patch content follows
+        https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates
+        Name field is required as we need to rename the template,
+        all the other fields are optional. It is important to follow PATCH semantics
+        - arrays are replaced fully, so if you need to update an array you should
+        provide the whole target array as patch element.
+    :type body_patch: dict
+    :param request_id: Optional, unique request_id that you might add to achieve
+        full idempotence (for example when client call times out repeating the request
+        with the same request id will not create a new instance template again).
+        It should be in UUID format as defined in RFC 4122.
+    :type request_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (for example v1 or beta).
+    :type api_version: str
+    :param validate_body: If set to False, body validation is not performed.
+    :type validate_body: bool
+    """
+    # [START gce_instance_template_copy_operator_template_fields]
+    template_fields = ('project_id', 'resource_id', 'request_id',
+                       'gcp_conn_id', 'api_version')
+    # [END gce_instance_template_copy_operator_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 resource_id,
+                 body_patch,
+                 request_id=None,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body_patch = body_patch
+        self.request_id = request_id
+        self._field_validator = None
+        if 'name' not in self.body_patch:
+            raise AirflowException("The body '{}' should contain at least "
+                                   "name for the new operator in the 'name' field".
+                                   format(body_patch))
+        if validate_body:
+            self._field_validator = GcpBodyFieldValidator(
+                GCE_INSTANCE_TEMPLATE_VALIDATION_PATCH_SPECIFICATION, api_version=api_version)
+        self._field_sanitizer = GcpBodyFieldSanitizer(
+            GCE_INSTANCE_TEMPLATE_FIELDS_TO_SANITIZE)
+        super(GceInstanceTemplateCopyOperator, self).__init__(
+            project_id=project_id, zone='global', resource_id=resource_id,
+            gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
+
+    def _validate_all_body_fields(self):
+        if self._field_validator:
+            self._field_validator.validate(self.body_patch)
+
+    def execute(self, context):
+        self._validate_all_body_fields()
+        try:
+            # Idempotence check (sort of) - we want to check if the new template
+            # is already created and if is, then we assume it was created by previous run
+            # of CopyTemplate operator - we do not check if content of the template
+            # is as expected. Templates are immutable so we cannot update it anyway
+            # and deleting/recreating is not worth the hassle especially
+            # that we cannot delete template if it is already used in some Instance
+            # Group Manager. We assume success if the template is simply present
+            existing_template = self._hook.get_instance_template(
+                project_id=self.project_id, resource_id=self.body_patch['name'])
+            self.log.info("The {} template already existed. It was likely "
+                          "created by previous run of the operator. Assuming success.")
+            return existing_template
+        except HttpError as e:
+            # We actually expect to get 404 / Not Found here as the template should
+            # not yet exist
+            if not e.resp.status == 404:
+                raise e
+        old_body = self._hook.get_instance_template(project_id=self.project_id,
+                                                    resource_id=self.resource_id)
+        new_body = deepcopy(old_body)
+        self._field_sanitizer.sanitize(new_body)
+        new_body = merge(new_body, self.body_patch)
+        self.log.info("Calling insert instance template with updated body: {}".
+                      format(new_body))
+        self._hook.insert_instance_template(project_id=self.project_id,
+                                            body=new_body,
+                                            request_id=self.request_id)
+        return self._hook.get_instance_template(project_id=self.project_id,
+                                                resource_id=self.body_patch['name'])
+
+
+class GceInstanceGroupManagerUpdateTemplateOperator(GceBaseOperator):
+    """
+    Patches the Instance Group Manager, replacing source template URL with the
+    destination one. API V1 does not have update/patch operations for Instance
+    Group Manager, so you must use beta or newer API version. Beta is the default.
+
+    :param project_id: Google Cloud Platform Project ID where the Compute Engine
+        Instance exists.
+    :type project_id: str
+    :param resource_id: Name of the Instance Group Manager
+    :type resource_id: str
+    :param zone: Google Cloud Platform zone where the Instance Group Manager exists.
+    :type zone: str
+    :param request_id: Optional, unique request_id that you might add to achieve
+        full idempotence (for example when client call times out repeating the request
+        with the same request id will not create a new instance template again).
+        It should be in UUID format as defined in RFC 4122
+    :type request_id: str
+    :param update_policy: The update policy for this managed instance group. See
+        https://cloud.google.com/compute/docs/reference/rest/beta/instanceGroupManagers/patch
+        for details of the updatePolicy fields. It's an optional field.
+    :type dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (for example beta).
+    :type api_version: str
+    """
+    # [START gce_igm_update_template_operator_template_fields]
+    template_fields = ('project_id', 'resource_id', 'zone', 'request_id',
+                       'source_template', 'destination_template',
+                       'gcp_conn_id', 'api_version')
+    # [END gce_igm_update_template_operator_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 resource_id,
+                 zone,
+                 source_template,
+                 destination_template,
+                 update_policy=None,
+                 request_id=None,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='beta',
+                 *args, **kwargs):
+        self.zone = zone
+        self.source_template = source_template
+        self.destination_template = destination_template
+        self.request_id = request_id
+        self.update_policy = update_policy
+        self._change_performed = False
+        if api_version == 'v1':
+            raise AirflowException("Api version v1 does not have update/patch "
+                                   "operations for Instance Group Managers. Use beta"
+                                   " api version or above")
+        super(GceInstanceGroupManagerUpdateTemplateOperator, self).__init__(
+            project_id=project_id, zone=self.zone, resource_id=resource_id,
+            gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
+
+    def _possibly_replace_template(self, dictionary):
+        # type: (dict) -> None
+        if dictionary.get('instanceTemplate') == self.source_template:
+            dictionary['instanceTemplate'] = self.destination_template
+            self._change_performed = True
+
+    def execute(self, context):
+        old_instance_group_manager = self._hook.get_instance_group_manager(
+            project_id=self.project_id,
+            zone=self.zone,
+            resource_id=self.resource_id)
+        patch_body = {}
+        if 'versions' in old_instance_group_manager:
+            patch_body['versions'] = old_instance_group_manager['versions']
+        if 'instanceTemplate' in old_instance_group_manager:
+            patch_body['instanceTemplate'] = old_instance_group_manager['instanceTemplate']
+        if self.update_policy:
+            patch_body['updatePolicy'] = self.update_policy
+        self._possibly_replace_template(patch_body)
+        if 'versions' in patch_body:
+            for version in patch_body['versions']:
+                self._possibly_replace_template(version)
+        if self._change_performed or self.update_policy:
+            self.log.info("Calling patch instance template with updated body: {}".
+                          format(patch_body))
+            return self._hook.patch_instance_group_manager(
+                project_id=self.project_id, zone=self.zone, resource_id=self.resource_id,
+                body=patch_body, request_id=self.request_id)
+        else:
+            # Idempotence achieved
+            return True
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index c0013aaea9bf6..7f7da1d3ec5eb 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -93,7 +93,7 @@ class GcfFunctionDeployOperator(BaseOperator):
         . Different API versions require different variants of the Cloud Functions
         dictionary.
     :type body: dict or google.cloud.functions.v1.CloudFunction
-    :param gcp_conn_id: The connection ID to use to connect to Google Cloud Platform.
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (for example v1 or v1beta1).
     :type api_version: str
@@ -105,6 +105,9 @@ class GcfFunctionDeployOperator(BaseOperator):
     :param validate_body: If set to False, body validation is not performed.
     :type validate_body: bool
     """
+    # [START gce_function_deploy_template_operator_template_fields]
+    template_fields = ('project_id', 'location', 'gcp_conn_id', 'api_version')
+    # [END gce_function_deploy_template_operator_template_fields]
 
     @apply_defaults
     def __init__(self,
@@ -276,6 +279,9 @@ class GcfFunctionDeleteOperator(BaseOperator):
     :param api_version: API version used (for example v1 or v1beta1).
     :type api_version: str
     """
+    # [START gce_function_delete_template_operator_template_fields]
+    template_fields = ('name', 'gcp_conn_id', 'api_version')
+    # [END gce_function_delete_template_operator_template_fields]
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/utils/gcp_field_sanitizer.py b/airflow/contrib/utils/gcp_field_sanitizer.py
new file mode 100644
index 0000000000000..c0a8985281e1a
--- /dev/null
+++ b/airflow/contrib/utils/gcp_field_sanitizer.py
@@ -0,0 +1,162 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+"""Sanitizer for body fields sent via GCP API.
+
+The sanitizer removes fields specified from the body.
+
+Context
+-------
+In some cases where GCP operation requires modification of existing resources (such
+as instances or instance templates) we need to sanitize body of the resources returned
+via GCP APIs. This is in the case when we retrieve information from GCP first,
+modify the body and either update the existing resource or create a new one with the
+modified body. Usually when you retrieve resource from GCP you get some extra fields which
+are Output-only, and we need to delete those fields if we want to use
+the body as input for subsequent create/insert type operation.
+
+
+Field specification
+-------------------
+
+Specification of fields is an array of strings which denote names of fields to be removed.
+The field can be either direct field name to remove from the body or the full
+specification of the path you should delete - separated with '.'
+
+
+>>> FIELDS_TO_SANITIZE = [
+>>>    "kind",
+>>>    "properties.disks.kind",
+>>>    "properties.metadata.kind",
+>>>]
+>>> body = {
+>>>     "kind": "compute#instanceTemplate",
+>>>     "name": "instance",
+>>>     "properties": {
+>>>         "disks": [
+>>>             {
+>>>                 "name": "a",
+>>>                 "kind": "compute#attachedDisk",
+>>>                 "type": "PERSISTENT",
+>>>                 "mode": "READ_WRITE",
+>>>             },
+>>>             {
+>>>                 "name": "b",
+>>>                 "kind": "compute#attachedDisk",
+>>>                 "type": "PERSISTENT",
+>>>                 "mode": "READ_WRITE",
+>>>             }
+>>>         ],
+>>>         "metadata": {
+>>>             "kind": "compute#metadata",
+>>>             "fingerprint": "GDPUYxlwHe4="
+>>>         },
+>>>     }
+>>> }
+>>> sanitizer=GcpBodyFieldSanitizer(FIELDS_TO_SANITIZE)
+>>> SANITIZED_BODY = sanitizer.sanitize(body)
+>>> json.dumps(SANITIZED_BODY, indent=2)
+{
+    "name":  "instance",
+    "properties": {
+        "disks": [
+            {
+                "name": "a",
+                "type": "PERSISTENT",
+                "mode": "READ_WRITE",
+            },
+            {
+                "name": "b",
+                "type": "PERSISTENT",
+                "mode": "READ_WRITE",
+            }
+        ],
+        "metadata": {
+            "fingerprint": "GDPUYxlwHe4="
+        },
+    }
+}
+
+Note that the components of the path can be either dictionaries or arrays of dictionaries.
+In case  they are dictionaries, subsequent component names key of the field, in case of
+arrays - the sanitizer iterates through all dictionaries in the array and searches
+components in all elements of the array.
+"""
+
+from airflow import LoggingMixin, AirflowException
+
+
+class GcpFieldSanitizerException(AirflowException):
+    """Thrown when sanitizer finds unexpected field type in the path
+    (other than dict or array).
+    """
+
+    def __init__(self, message):
+        super(GcpFieldSanitizerException, self).__init__(message)
+
+
+class GcpBodyFieldSanitizer(LoggingMixin):
+    """Sanitizes the body according to specification.
+
+    :param sanitize_specs: array of strings that specifies which fields to remove
+    :type sanitize_specs: [string]
+
+    """
+    def __init__(self, sanitize_specs):
+        # type: ([str]) -> None
+        super(GcpBodyFieldSanitizer, self).__init__()
+        self._sanitize_specs = sanitize_specs
+
+    def _sanitize(self, dictionary, remaining_field_spec, current_path):
+        field_split = remaining_field_spec.split(".", 1)
+        if len(field_split) == 1:
+            field_name = field_split[0]
+            if field_name in dictionary:
+                self.log.info("Deleted {} [{}]".format(field_name, current_path))
+                del dictionary[field_name]
+            else:
+                self.log.debug("The field {} is missing in {} at the path {}.".
+                               format(field_name, dictionary, current_path))
+        else:
+            field_name = field_split[0]
+            remaining_path = field_split[1]
+            child = dictionary.get(field_name)
+            if child is None:
+                self.log.debug("The field {} is missing in {} at the path {}. ".
+                               format(field_name, dictionary, current_path))
+            elif isinstance(child, dict):
+                self._sanitize(child, remaining_path, "{}.{}".format(
+                    current_path, field_name))
+            elif isinstance(child, list):
+                for index, elem in enumerate(child):
+                    if not isinstance(elem, dict):
+                        self.log.warn(
+                            "The field {} element at index {} is of wrong type. "
+                            "It should be dict and is {}. Skipping it.".
+                            format(current_path, index, elem))
+                    self._sanitize(elem, remaining_path, "{}.{}[{}]".format(
+                        current_path, field_name, index))
+            else:
+                self.log.warn(
+                    "The field {} is of wrong type. "
+                    "It should be dict or list and it is {}. Skipping it.".
+                    format(current_path, child))
+
+    def sanitize(self, body):
+        for elem in self._sanitize_specs:
+            self._sanitize(body, elem, "")
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 2c84a7f88e888..41fc6fd1e5904 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -103,8 +103,8 @@ template variables <macros>` and a ``templates_dict`` argument.
 The ``templates_dict`` argument is templated, so each value in the dictionary
 is evaluated as a :ref:`Jinja template <jinja-templating>`.
 
-Google Cloud Platform Operators
--------------------------------
+Google Cloud Storage Operators
+------------------------------
 
 GoogleCloudStorageToBigQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -119,22 +119,31 @@ to execute a BigQuery load job.
     :start-after: [START howto_operator_gcs_to_bq]
     :end-before: [END howto_operator_gcs_to_bq]
 
+
+Google Compute Engine Operators
+-------------------------------
+
 GceInstanceStartOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
-Allows to start an existing Google Compute Engine instance.
+Use the
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator`
+to start an existing Google Compute Engine instance.
 
-In this example parameter values are extracted from Airflow variables.
-Moreover, the ``default_args`` dict is used to pass common arguments to all operators in a single DAG.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build function name
+to use in the operator and build default args to pass them to multiple tasks:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
-    :start-after: [START howto_operator_gce_args]
-    :end-before: [END howto_operator_gce_args]
+    :start-after: [START howto_operator_gce_args_common]
+    :end-before: [END howto_operator_gce_args_common]
 
-
-Define the :class:`~airflow.contrib.operators.gcp_compute_operator
-.GceInstanceStartOperator` by passing the required arguments to the constructor.
+Using the operator
+""""""""""""""""""
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
@@ -142,15 +151,42 @@ Define the :class:`~airflow.contrib.operators.gcp_compute_operator
     :start-after: [START howto_operator_gce_start]
     :end-before: [END howto_operator_gce_start]
 
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_start_template_fields]
+    :end-before: [END gce_instance_start_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_
+
+
 GceInstanceStopOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
-Allows to stop an existing Google Compute Engine instance.
+Use the operator to stop Google Compute Engine instance.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator`
 
-For parameter definition take a look at :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator` above.
+Arguments
+"""""""""
 
-Define the :class:`~airflow.contrib.operators.gcp_compute_operator
-.GceInstanceStopOperator` by passing the required arguments to the constructor.
+The following examples of OS environment variables show how you can build function name
+to use in the operator and build default args to pass them to multiple tasks:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+   :language: python
+   :start-after: [START howto_operator_gce_args_common]
+   :end-before: [END howto_operator_gce_args_common]
+
+Using the operator
+""""""""""""""""""
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
@@ -158,15 +194,48 @@ Define the :class:`~airflow.contrib.operators.gcp_compute_operator
     :start-after: [START howto_operator_gce_stop]
     :end-before: [END howto_operator_gce_stop]
 
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_stop_template_fields]
+    :end-before: [END gce_instance_stop_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_
+
+
 GceSetMachineTypeOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Allows to change the machine type for a stopped instance to the specified machine type.
+Use the operator to change machine type of a Google Compute Engine instance.
 
-For parameter definition take a look at :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator` above.
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`
 
-Define the :class:`~airflow.contrib.operators.gcp_compute_operator
-.GceSetMachineTypeOperator` by passing the required arguments to the constructor.
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build function name
+to use in the operator and build default args to pass them to multiple tasks:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args_common]
+    :end-before: [END howto_operator_gce_args_common]
+
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args_set_machine_type]
+    :end-before: [END howto_operator_gce_args_set_machine_type]
+
+Using the operator
+""""""""""""""""""
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
@@ -174,26 +243,163 @@ Define the :class:`~airflow.contrib.operators.gcp_compute_operator
     :start-after: [START howto_operator_gce_set_machine_type]
     :end-before: [END howto_operator_gce_set_machine_type]
 
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_set_machine_type_template_fields]
+    :end-before: [END gce_instance_set_machine_type_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_
+
+
+GceInstanceTemplateCopyOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the operator to copy an existing Google Compute Engine instance template
+applying a patch to it.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build parameters
+passed to the operator and build default args to pass them to multiple tasks:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_common_args]
+    :end-before: [END howto_operator_compute_igm_common_args]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_template_copy_args]
+    :end-before: [END howto_operator_compute_template_copy_args]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_copy_template]
+    :end-before: [END howto_operator_gce_igm_copy_template]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_template_copy_operator_template_fields]
+    :end-before: [END gce_instance_template_copy_operator_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_
+
+GceInstanceGroupManagerUpdateTemplateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the operator to update template in Google Compute Engine Instance Group Manager.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build parameters
+passed to the operator and build default args to pass them to multiple tasks:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_common_args]
+    :end-before: [END howto_operator_compute_igm_common_args]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_update_template_args]
+    :end-before: [END howto_operator_compute_igm_update_template_args]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_update_template]
+    :end-before: [END howto_operator_gce_igm_update_template]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_igm_update_template_operator_template_fields]
+    :end-before: [END gce_igm_update_template_operator_template_fields]
+
+Troubleshooting
+"""""""""""""""
+
+You might find that your GceInstanceGroupManagerUpdateTemplateOperator fails with
+missing permissions. The service account has to have Service Account User role assigned
+via IAM permissions in order to execute the operation.
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_
+
+Google Cloud Functions Operators
+--------------------------------
 
 GcfFunctionDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Use the ``default_args`` dict to pass arguments to the operator.
+Use the operator to delete a function from Google Cloud Functions.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build function name
+to use in the operator and build default args to pass them to multiple tasks:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
     :language: python
     :start-after: [START howto_operator_gcf_delete_args]
     :end-before: [END howto_operator_gcf_delete_args]
 
-
-Use the :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`
-to delete a function from Google Cloud Functions.
+Using the operator
+""""""""""""""""""
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
     :language: python
+    :dedent: 4
     :start-after: [START howto_operator_gcf_delete]
     :end-before: [END howto_operator_gcf_delete]
 
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_function_delete_template_operator_template_fields]
+    :end-before: [END gce_function_delete_template_operator_template_fields]
+
 Troubleshooting
 """""""""""""""
 If you want to run or deploy an operator using a service account and get “forbidden 403”
@@ -208,7 +414,6 @@ The typical way of assigning Cloud IAM permissions with `gcloud` is
 shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
 and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
 
-
 .. code-block:: bash
 
   gcloud iam service-accounts add-iam-policy-binding \
@@ -219,13 +424,24 @@ and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
 
 See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
 
+More information
+""""""""""""""""
+
+See `Google Cloud Functions API documentation <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_
+
 GcfFunctionDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Use the :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`
-to deploy a function from Google Cloud Functions.
+Use the operator to deploy a function to Google Cloud Functions.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`.
+
 
-The following examples of Airflow variables show various variants and combinations
+Arguments
+"""""""""
+
+The following examples of OS environment variables show various variants and combinations
 of default_args that you can use. The variables are defined as follows:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
@@ -240,11 +456,12 @@ With those variables you can define the body of the request:
     :start-after: [START howto_operator_gcf_deploy_body]
     :end-before: [END howto_operator_gcf_deploy_body]
 
-When you create a DAG, the default_args dictionary can be used to pass the body and
-other arguments:
+When you create a DAG, the default_args dictionary can be used to pass
+arguments common with other tasks:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
+    :dedent: 4
     :start-after: [START howto_operator_gcf_deploy_args]
     :end-before: [END howto_operator_gcf_deploy_args]
 
@@ -252,11 +469,14 @@ Note that the neither the body nor the default args are complete in the above ex
 Depending on the set variables, there might be different variants on how to pass source
 code related fields. Currently, you can pass either sourceArchiveUrl, sourceRepository
 or sourceUploadUrl as described in the
-`CloudFunction API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
+`Cloud Functions API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
 Additionally, default_args might contain zip_path parameter to run the extra step of
 uploading the source code before deploying it. In the last case, you also need to
 provide an empty `sourceUploadUrl` parameter in the body.
 
+Using the operator
+""""""""""""""""""
+
 Based on the variables defined above, example logic of setting the source code
 related fields is shown here:
 
@@ -269,9 +489,20 @@ The code to create the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
+    :dedent: 4
     :start-after: [START howto_operator_gcf_deploy]
     :end-before: [END howto_operator_gcf_deploy]
 
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_function_deploy_template_operator_template_fields]
+    :end-before: [END gce_function_deploy_template_operator_template_fields]
+
+
 Troubleshooting
 """""""""""""""
 
@@ -294,13 +525,20 @@ and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
     --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
     --role="roles/iam.serviceAccountUser"
 
-
 See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
 
 If the source code for your function is in Google Source Repository, make sure that
 your service account has the Source Repository Viewer role so that the source code
 can be downloaded if necessary.
 
+More information
+""""""""""""""""
+
+See `Google Cloud Functions API documentation <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_
+
+Google Cloud Sql Operators
+--------------------------
+
 CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/integration.rst b/docs/integration.rst
index 1ab8e609d0dc2..9d3e6c9828f59 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -116,28 +116,28 @@ field (see connection `wasb_default` for an example).
 .. _WasbBlobSensor:
 
 WasbBlobSensor
-"""""""""""""""
+""""""""""""""
 
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
 
 .. _WasbPrefixSensor:
 
 WasbPrefixSensor
-"""""""""""""""""
+""""""""""""""""
 
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor
 
 .. _FileToWasbOperator:
 
 FileToWasbOperator
-"""""""""""""""""""
+""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
 
 .. _WasbHook:
 
 WasbHook
-"""""""""
+""""""""
 
 .. autoclass:: airflow.contrib.hooks.wasb_hook.WasbHook
 
@@ -538,6 +538,16 @@ Compute Engine Operators
 - :ref:`GceInstanceStartOperator` : start an existing Google Compute Engine instance.
 - :ref:`GceInstanceStopOperator` : stop an existing Google Compute Engine instance.
 - :ref:`GceSetMachineTypeOperator` : change the machine type for a stopped instance.
+- :ref:`GceInstanceTemplateCopyOperator` : copy the Instance Template, applying
+  specified changes.
+- :ref:`GceInstanceGroupManagerUpdateTemplateOperator` : patch the Instance Group Manager,
+  replacing source Instance Template URL with the destination one.
+
+The operators have common base operator:
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
+
+They also use :ref:`GceHook` hook to communicate with Google Cloud Platform.
 
 .. _GceInstanceStartOperator:
 
@@ -560,6 +570,28 @@ GceSetMachineTypeOperator
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 
+.. _GceInstanceTemplateCopyOperator:
+
+GceInstanceTemplateCopyOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
+
+.. _GceInstanceGroupManagerUpdateTemplateOperator:
+
+GceInstanceGroupManagerUpdateTemplateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
+
+.. _GceHook:
+
+Compute Engine Hook
+"""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_compute_hook.GceHook
+:members:
+
 
 Cloud Functions
 '''''''''''''''
@@ -572,6 +604,8 @@ Cloud Functions Operators
 
 .. autoclass:: airflow.contrib.operators.gcp_operator.GCP
 
+They also use :ref:`GcfHook` hook to communicate with Google Cloud Platform.
+
 .. _GcfFunctionDeployOperator:
 
 GcfFunctionDeployOperator
@@ -588,6 +622,8 @@ GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 
 
+.. _GcfHook:
+
 Cloud Functions Hook
 """"""""""""""""""""
 
@@ -697,7 +733,7 @@ DataprocClusterCreateOperator
 .. _DataprocClusterScaleOperator:
 
 DataprocClusterScaleOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
 
diff --git a/setup.py b/setup.py
index 3af146d5a301d..b519e77a3610b 100644
--- a/setup.py
+++ b/setup.py
@@ -286,6 +286,7 @@ def do_setup():
             'gitpython>=2.0.2',
             'gunicorn>=19.4.0, <20.0',
             'iso8601>=0.1.12',
+            'json-merge-patch==0.2',
             'jinja2>=2.7.3, <2.9.0',
             'lxml>=4.0.0',
             'markdown>=2.5.2, <3.0',
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
index 449c4e015fdda..e8f9bf01656b8 100644
--- a/tests/contrib/operators/test_gcp_compute_operator.py
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -18,10 +18,15 @@
 # under the License.
 import ast
 import unittest
+from copy import deepcopy
+
+import httplib2
+from googleapiclient.errors import HttpError
 
 from airflow import AirflowException, configuration
 from airflow.contrib.operators.gcp_compute_operator import GceInstanceStartOperator, \
-    GceInstanceStopOperator, GceSetMachineTypeOperator
+    GceInstanceStopOperator, GceSetMachineTypeOperator, GceInstanceTemplateCopyOperator, \
+    GceInstanceGroupManagerUpdateTemplateOperator
 from airflow.models import TaskInstance, DAG
 from airflow.utils import timezone
 
@@ -34,12 +39,14 @@
     except ImportError:
         mock = None
 
+EMPTY_CONTENT = ''.encode('utf8')
+
 PROJECT_ID = 'project-id'
-LOCATION = 'zone'
+ZONE = 'zone'
 RESOURCE_ID = 'resource-id'
 SHORT_MACHINE_TYPE_NAME = 'n1-machine-type'
 SET_MACHINE_TYPE_BODY = {
-    'machineType': 'zones/{}/machineTypes/{}'.format(LOCATION, SHORT_MACHINE_TYPE_NAME)
+    'machineType': 'zones/{}/machineTypes/{}'.format(ZONE, SHORT_MACHINE_TYPE_NAME)
 }
 
 DEFAULT_DATE = timezone.datetime(2017, 1, 1)
@@ -51,7 +58,7 @@ def test_instance_start(self, mock_hook):
         mock_hook.return_value.start_instance.return_value = True
         op = GceInstanceStartOperator(
             project_id=PROJECT_ID,
-            zone=LOCATION,
+            zone=ZONE,
             resource_id=RESOURCE_ID,
             task_id='id'
         )
@@ -59,11 +66,11 @@ def test_instance_start(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.start_instance.assert_called_once_with(
-            PROJECT_ID, LOCATION, RESOURCE_ID
+            PROJECT_ID, ZONE, RESOURCE_ID
         )
         self.assertTrue(result)
 
-    # Setting all of the operator's input parameters as templated dag_ids
+    # Setting all of the operator's input parameters as template dag_ids
     # (could be anything else) just to test if the templating works for all fields
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_instance_start_with_templates(self, mock_hook):
@@ -95,7 +102,7 @@ def test_start_should_throw_ex_when_missing_project_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStartOperator(
                 project_id="",
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id=RESOURCE_ID,
                 task_id='id'
             )
@@ -123,7 +130,7 @@ def test_start_should_throw_ex_when_missing_resource_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStartOperator(
                 project_id=PROJECT_ID,
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id="",
                 task_id='id'
             )
@@ -132,12 +139,14 @@ def test_start_should_throw_ex_when_missing_resource_id(self, mock_hook):
         self.assertIn("The required parameter 'resource_id' is missing", str(err))
         mock_hook.assert_not_called()
 
+
+class GceInstanceStopTest(unittest.TestCase):
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_instance_stop(self, mock_hook):
         mock_hook.return_value.stop_instance.return_value = True
         op = GceInstanceStopOperator(
             project_id=PROJECT_ID,
-            zone=LOCATION,
+            zone=ZONE,
             resource_id=RESOURCE_ID,
             task_id='id'
         )
@@ -145,7 +154,7 @@ def test_instance_stop(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.stop_instance.assert_called_once_with(
-            PROJECT_ID, LOCATION, RESOURCE_ID
+            PROJECT_ID, ZONE, RESOURCE_ID
         )
         self.assertTrue(result)
 
@@ -181,7 +190,7 @@ def test_stop_should_throw_ex_when_missing_project_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStopOperator(
                 project_id="",
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id=RESOURCE_ID,
                 task_id='id'
             )
@@ -209,7 +218,7 @@ def test_stop_should_throw_ex_when_missing_resource_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStopOperator(
                 project_id=PROJECT_ID,
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id="",
                 task_id='id'
             )
@@ -218,12 +227,14 @@ def test_stop_should_throw_ex_when_missing_resource_id(self, mock_hook):
         self.assertIn("The required parameter 'resource_id' is missing", str(err))
         mock_hook.assert_not_called()
 
+
+class GceInstanceSetMachineTypeTest(unittest.TestCase):
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_set_machine_type(self, mock_hook):
         mock_hook.return_value.set_machine_type.return_value = True
         op = GceSetMachineTypeOperator(
             project_id=PROJECT_ID,
-            zone=LOCATION,
+            zone=ZONE,
             resource_id=RESOURCE_ID,
             body=SET_MACHINE_TYPE_BODY,
             task_id='id'
@@ -232,7 +243,7 @@ def test_set_machine_type(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.set_machine_type.assert_called_once_with(
-            PROJECT_ID, LOCATION, RESOURCE_ID, SET_MACHINE_TYPE_BODY
+            PROJECT_ID, ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY
         )
         self.assertTrue(result)
 
@@ -269,7 +280,7 @@ def test_set_machine_type_should_throw_ex_when_missing_project_id(self, mock_hoo
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
                 project_id="",
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id=RESOURCE_ID,
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
@@ -299,7 +310,7 @@ def test_set_machine_type_should_throw_ex_when_missing_resource_id(self, mock_ho
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
                 project_id=PROJECT_ID,
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id="",
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
@@ -314,7 +325,7 @@ def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_h
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
                 project_id=PROJECT_ID,
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id=RESOURCE_ID,
                 body={},
                 task_id='id'
@@ -332,10 +343,10 @@ def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_h
                        "'zone': 'https://www.googleapis.com/compute/v1/projects/polidea" \
                        "-airflow/zones/europe-west3-b', 'operationType': " \
                        "'setMachineType', 'targetLink': " \
-                       "'https://www.googleapis.com/compute/v1/projects/polidea-airflow" \
+                       "'https://www.googleapis.com/compute/v1/projects/example-airflow" \
                        "/zones/europe-west3-b/instances/pa-1', 'targetId': " \
                        "'2480086944131075860', 'status': 'DONE', 'user': " \
-                       "'uberdarek@polidea-airflow.iam.gserviceaccount.com', " \
+                       "'uberdarek@example-airflow.iam.gserviceaccount.com', " \
                        "'progress': 100, 'insertTime': '2018-10-03T07:50:07.951-07:00', "\
                        "'startTime': '2018-10-03T07:50:08.324-07:00', 'endTime': " \
                        "'2018-10-03T07:50:08.484-07:00', 'error': {'errors': [{'code': " \
@@ -343,35 +354,688 @@ def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_h
                        "'machine-type-1' does not exist in zone 'europe-west3-b'.\"}]}, "\
                        "'httpErrorStatusCode': 400, 'httpErrorMessage': 'BAD REQUEST', " \
                        "'selfLink': " \
-                       "'https://www.googleapis.com/compute/v1/projects/polidea-airflow" \
+                       "'https://www.googleapis.com/compute/v1/projects/example-airflow" \
                        "/zones/europe-west3-b/operations/operation-1538578207537" \
                        "-577542784f769-7999ab71-94f9ec1d'} "
 
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook'
-                '._check_operation_status')
+                '._check_zone_operation_status')
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook'
                 '._execute_set_machine_type')
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook.get_conn')
     def test_set_machine_type_should_handle_and_trim_gce_error(
-            self, get_conn, _execute_set_machine_type, _check_operation_status):
+            self, get_conn, _execute_set_machine_type, _check_zone_operation_status):
         get_conn.return_value = {}
         _execute_set_machine_type.return_value = {"name": "test-operation"}
-        _check_operation_status.return_value = ast.literal_eval(self.MOCK_OP_RESPONSE)
+        _check_zone_operation_status.return_value = ast.literal_eval(self.MOCK_OP_RESPONSE)
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
                 project_id=PROJECT_ID,
-                zone=LOCATION,
+                zone=ZONE,
                 resource_id=RESOURCE_ID,
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
             )
             op.execute(None)
         err = cm.exception
-        _check_operation_status.assert_called_once_with(
-            {}, "test-operation", PROJECT_ID, LOCATION)
+        _check_zone_operation_status.assert_called_once_with(
+            {}, "test-operation", PROJECT_ID, ZONE)
         _execute_set_machine_type.assert_called_once_with(
-            PROJECT_ID, LOCATION, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
+            PROJECT_ID, ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
         # Checking the full message was sometimes failing due to different order
         # of keys in the serialized JSON
         self.assertIn("400 BAD REQUEST: {", str(err))  # checking the square bracket trim
         self.assertIn("UNSUPPORTED_OPERATION", str(err))
+
+
+GCE_INSTANCE_TEMPLATE_NAME = "instance-template-test"
+GCE_INSTANCE_TEMPLATE_NEW_NAME = "instance-template-test-new"
+GCE_INSTANCE_TEMPLATE_REQUEST_ID = "e12d5b48-4826-4ba9-ada6-0cff1e0b36a6"
+
+GCE_INSTANCE_TEMPLATE_BODY_GET = {
+    "kind": "compute#instanceTemplate",
+    "id": "6950321349997439715",
+    "creationTimestamp": "2018-10-15T06:20:12.777-07:00",
+    "name": GCE_INSTANCE_TEMPLATE_NAME,
+    "description": "",
+    "properties": {
+        "machineType": "n1-standard-1",
+        "networkInterfaces": [
+            {
+                "kind": "compute#networkInterface",
+                "network": "https://www.googleapis.com/compute/v1/"
+                           "projects/project/global/networks/default",
+                "accessConfigs": [
+                    {
+                        "kind": "compute#accessConfig",
+                        "type": "ONE_TO_ONE_NAT",
+                    }
+                ]
+            },
+            {
+                "network": "https://www.googleapis.com/compute/v1/"
+                           "projects/project/global/networks/default",
+                "accessConfigs": [
+                    {
+                        "kind": "compute#accessConfig",
+                        "networkTier": "PREMIUM"
+                    }
+                ]
+            }
+        ],
+        "disks": [
+            {
+                "kind": "compute#attachedDisk",
+                "type": "PERSISTENT",
+                "licenses": [
+                    "A String",
+                ]
+            }
+        ],
+        "metadata": {
+            "kind": "compute#metadata",
+            "fingerprint": "GDPUYxlwHe4="
+        },
+    },
+    "selfLink": "https://www.googleapis.com/compute/v1/projects/project"
+                "/global/instanceTemplates/instance-template-test"
+}
+
+GCE_INSTANCE_TEMPLATE_BODY_INSERT = {
+    "name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+    "description": "",
+    "properties": {
+        "machineType": "n1-standard-1",
+        "networkInterfaces": [
+            {
+                "network": "https://www.googleapis.com/compute/v1/"
+                           "projects/project/global/networks/default",
+                "accessConfigs": [
+                    {
+                        "type": "ONE_TO_ONE_NAT",
+                    }
+                ]
+            },
+            {
+                "network": "https://www.googleapis.com/compute/v1/"
+                           "projects/project/global/networks/default",
+                "accessConfigs": [
+                    {
+                        "networkTier": "PREMIUM"
+                    }
+                ]
+            }
+        ],
+        "disks": [
+            {
+                "type": "PERSISTENT",
+            }
+        ],
+        "metadata": {
+            "fingerprint": "GDPUYxlwHe4="
+        },
+    },
+}
+
+GCE_INSTANCE_TEMPLATE_BODY_GET_NEW = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_GET)
+GCE_INSTANCE_TEMPLATE_BODY_GET_NEW['name'] = GCE_INSTANCE_TEMPLATE_NEW_NAME
+
+
+class GceInstanceTemplateCopyTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=GCE_INSTANCE_TEMPLATE_BODY_INSERT,
+            request_id=None
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_idempotent_copy_template_when_already_copied(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.insert_instance_template.assert_not_called()
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_with_request_id(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=GCE_INSTANCE_TEMPLATE_BODY_INSERT,
+            request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_with_description_fields(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+                        "description": "New description"}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+        body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
+        body_insert["description"] = "New description"
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=body_insert,
+            request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_copy_with_some_validation_warnings(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+                        "some_wrong_field": "test",
+                        "properties": {
+                            "some_other_wrong_field": "test"
+                        }}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
+        body_insert["some_wrong_field"] = "test"
+        body_insert["properties"]["some_other_wrong_field"] = "test"
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=body_insert,
+            request_id=None,
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_with_updated_nested_fields(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={
+                "name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+                "properties": {
+                    "machineType": "n1-standard-2",
+                }
+            }
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
+        body_insert["properties"]["machineType"] = "n1-standard-2"
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=body_insert,
+            request_id=None
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_with_smaller_array_fields(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={
+                "name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+                "properties": {
+                    "machineType": "n1-standard-1",
+                    "networkInterfaces": [
+                        {
+                            "network": "https://www.googleapis.com/compute/v1/"
+                                       "projects/project/global/networks/default",
+                            "accessConfigs": [
+                                {
+                                    "type": "ONE_TO_ONE_NAT",
+                                    "natIP": "8.8.8.8"
+                                }
+                            ]
+                        }
+                    ]
+                }
+            }
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
+        body_insert["properties"]["networkInterfaces"] = [
+            {
+                "network": "https://www.googleapis.com/compute/v1/"
+                           "projects/project/global/networks/default",
+                "accessConfigs": [
+                    {
+                        "type": "ONE_TO_ONE_NAT",
+                        "natIP": "8.8.8.8"
+                    }
+                ]
+            }
+        ]
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=body_insert,
+            request_id=None
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_with_bigger_array_fields(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            project_id=PROJECT_ID,
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={
+                "name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
+                "properties": {
+                    "disks": [
+                        {
+                            "kind": "compute#attachedDisk",
+                            "type": "SCRATCH",
+                            "licenses": [
+                                "Updated String",
+                            ]
+                        },
+                        {
+                            "kind": "compute#attachedDisk",
+                            "type": "PERSISTENT",
+                            "licenses": [
+                                "Another String",
+                            ]
+                        }
+                    ],
+                }
+            }
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+
+        body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
+        body_insert["properties"]["disks"] = [
+            {
+                "kind": "compute#attachedDisk",
+                "type": "SCRATCH",
+                "licenses": [
+                    "Updated String",
+                ]
+            },
+            {
+                "kind": "compute#attachedDisk",
+                "type": "PERSISTENT",
+                "licenses": [
+                    "Another String",
+                ]
+            }
+        ]
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=PROJECT_ID,
+            body=body_insert,
+            request_id=None,
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_missing_name(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        with self.assertRaises(AirflowException) as cm:
+            op = GceInstanceTemplateCopyOperator(
+                project_id=PROJECT_ID,
+                resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+                request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
+                task_id='id',
+                body_patch={"description": "New description"}
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("should contain at least name for the new operator "
+                      "in the 'name' field", str(err))
+        mock_hook.assert_not_called()
+
+
+GCE_INSTANCE_GROUP_MANAGER_NAME = "instance-group-test"
+GCE_INSTANCE_TEMPLATE_SOURCE_URL = \
+    "https://www.googleapis.com/compute/beta/projects/project" \
+    "/global/instanceTemplates/instance-template-test"
+
+GCE_INSTANCE_TEMPLATE_OTHER_URL = \
+    "https://www.googleapis.com/compute/beta/projects/project" \
+    "/global/instanceTemplates/instance-template-other"
+
+GCE_INSTANCE_TEMPLATE_NON_EXISTING_URL = \
+    "https://www.googleapis.com/compute/beta/projects/project" \
+    "/global/instanceTemplates/instance-template-non-existing"
+
+GCE_INSTANCE_TEMPLATE_DESTINATION_URL = \
+    "https://www.googleapis.com/compute/beta/projects/project" \
+    "/global/instanceTemplates/instance-template-new"
+
+GCE_INSTANCE_GROUP_MANAGER_GET = {
+    "kind": "compute#instanceGroupManager",
+    "id": "2822359583810032488",
+    "creationTimestamp": "2018-10-17T05:39:35.793-07:00",
+    "name": GCE_INSTANCE_GROUP_MANAGER_NAME,
+    "zone": "https://www.googleapis.com/compute/beta/projects/project/zones/zone",
+    "instanceTemplate": GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+    "versions": [
+        {
+            "name": "v1",
+            "instanceTemplate": GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            "targetSize": {
+                "calculated": 1
+            }
+        },
+        {
+            "name": "v2",
+            "instanceTemplate": GCE_INSTANCE_TEMPLATE_OTHER_URL,
+        }
+    ],
+    "instanceGroup": GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+    "baseInstanceName": GCE_INSTANCE_GROUP_MANAGER_NAME,
+    "fingerprint": "BKWB_igCNbQ=",
+    "currentActions": {
+        "none": 1,
+        "creating": 0,
+        "creatingWithoutRetries": 0,
+        "verifying": 0,
+        "recreating": 0,
+        "deleting": 0,
+        "abandoning": 0,
+        "restarting": 0,
+        "refreshing": 0
+    },
+    "pendingActions": {
+        "creating": 0,
+        "deleting": 0,
+        "recreating": 0,
+        "restarting": 0
+    },
+    "targetSize": 1,
+    "selfLink": "https://www.googleapis.com/compute/beta/projects/project/zones/"
+                "zone/instanceGroupManagers/" + GCE_INSTANCE_GROUP_MANAGER_NAME,
+    "autoHealingPolicies": [
+        {
+            "initialDelaySec": 300
+        }
+    ],
+    "serviceAccount": "198907790164@cloudservices.gserviceaccount.com"
+}
+
+GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH = {
+    "instanceTemplate": GCE_INSTANCE_TEMPLATE_DESTINATION_URL,
+    "versions": [
+        {
+            "name": "v1",
+            "instanceTemplate": GCE_INSTANCE_TEMPLATE_DESTINATION_URL,
+            "targetSize": {
+                "calculated": 1
+            }
+        },
+        {
+            "name": "v2",
+            "instanceTemplate": GCE_INSTANCE_TEMPLATE_OTHER_URL,
+        }
+    ],
+}
+
+GCE_INSTANCE_GROUP_MANAGER_REQUEST_ID = "e12d5b48-4826-4ba9-ada6-0cff1e0b36a6"
+
+GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY = {
+    "type": "OPPORTUNISTIC",
+    "minimalAction": "RESTART",
+    "maxSurge": {
+        "fixed": 1
+    },
+    "maxUnavailable": {
+        "percent": 10
+    },
+    "minReadySec": 1800
+}
+
+
+class GceInstanceGroupManagerUpdateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update(self, mock_hook):
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH,
+            request_id=None
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update_no_instance_template_field(self, mock_hook):
+        instance_group_manager_no_template = deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        del instance_group_manager_no_template['instanceTemplate']
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            instance_group_manager_no_template
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        expected_patch_no_instance_template = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
+        del expected_patch_no_instance_template['instanceTemplate']
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=expected_patch_no_instance_template,
+            request_id=None
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update_no_versions_field(self, mock_hook):
+        instance_group_manager_no_versions = deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        del instance_group_manager_no_versions['versions']
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            instance_group_manager_no_versions
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        expected_patch_no_versions = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
+        del expected_patch_no_versions['versions']
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=expected_patch_no_versions,
+            request_id=None
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update_with_update_policy(self, mock_hook):
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            update_policy=GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY,
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        expected_patch_with_update_policy = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
+        expected_patch_with_update_policy['updatePolicy'] = \
+            GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=expected_patch_with_update_policy,
+            request_id=None
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update_with_request_id(self, mock_hook):
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            request_id=GCE_INSTANCE_GROUP_MANAGER_REQUEST_ID,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH,
+            request_id=GCE_INSTANCE_GROUP_MANAGER_REQUEST_ID
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_try_to_use_api_v1(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            GceInstanceGroupManagerUpdateTemplateOperator(
+                project_id=PROJECT_ID,
+                zone=ZONE,
+                resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+                task_id='id',
+                api_version='v1',
+                source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+                destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+            )
+        err = cm.exception
+        self.assertIn("Use beta api version or above", str(err))
+
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_try_to_use_non_existing_template(self, mock_hook):
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            project_id=PROJECT_ID,
+            zone=ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_NON_EXISTING_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.patch_instance_group_manager.assert_not_called()
+        self.assertTrue(result)

From 3dd1d5b55bfdfbfa67557fa9f86799d7187389d2 Mon Sep 17 00:00:00 2001
From: Jose Luis Ricon <jose@aiden.ai>
Date: Wed, 28 Nov 2018 09:57:23 +0000
Subject: [PATCH 212/808] [AIRFLOW-3384] Allow higher versions of Sqlalchemy
 and Jinja2 (#4227)

* [AIRFLOW-3384] Allow higher versions of SQLAlchemy and Jinja2
---
 setup.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup.py b/setup.py
index b519e77a3610b..d6324cf5d9449 100644
--- a/setup.py
+++ b/setup.py
@@ -276,7 +276,7 @@ def do_setup():
             'dill>=0.2.2, <0.3',
             'flask>=0.12.4, <0.13',
             'flask-appbuilder==1.12.1',
-            'flask-admin==1.4.1',
+            'flask-admin==1.5.2',
             'flask-caching>=1.3.3, <1.4.0',
             'flask-login>=0.3, <0.5',
             'flask-swagger==0.2.13',
@@ -287,7 +287,7 @@ def do_setup():
             'gunicorn>=19.4.0, <20.0',
             'iso8601>=0.1.12',
             'json-merge-patch==0.2',
-            'jinja2>=2.7.3, <2.9.0',
+            'jinja2>=2.7.3, <=2.10.0',
             'lxml>=4.0.0',
             'markdown>=2.5.2, <3.0',
             'pandas>=0.17.1, <1.0.0',
@@ -299,7 +299,7 @@ def do_setup():
             'python-nvd3==0.15.0',
             'requests>=2.5.1, <3',
             'setproctitle>=1.1.8, <2',
-            'sqlalchemy>=1.1.15, <1.2.0',
+            'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
             'thrift>=0.9.2',

From b887603bc57250074a83aaa231c64e2995efb222 Mon Sep 17 00:00:00 2001
From: phanindhra <phani8996@gmail.com>
Date: Sat, 17 Nov 2018 05:23:09 +0530
Subject: [PATCH 213/808] [AIRFLOW-3352] Fix expose_config not honoured on RBAC
 UI (#4194)

---
 airflow/www_rbac/views.py    | 17 ++++++++++++-----
 tests/www_rbac/test_views.py | 15 ++++++++++++++-
 2 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 51af6c0e2a415..e2f439d20e037 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1611,11 +1611,18 @@ def conf(self):
         raw = request.args.get('raw') == "true"
         title = "Airflow Configuration"
         subtitle = conf.AIRFLOW_CONFIG
-        with open(conf.AIRFLOW_CONFIG, 'r') as f:
-            config = f.read()
-        table = [(section, key, value, source)
-                 for section, parameters in conf.as_dict(True, True).items()
-                 for key, (value, source) in parameters.items()]
+        # Don't show config when expose_config variable is False in airflow config
+        if conf.getboolean("webserver", "expose_config"):
+            with open(conf.AIRFLOW_CONFIG, 'r') as f:
+                config = f.read()
+            table = [(section, key, value, source)
+                     for section, parameters in conf.as_dict(True, True).items()
+                     for key, (value, source) in parameters.items()]
+        else:
+            config = (
+                "# Your Airflow administrator chose not to expose the "
+                "configuration, most likely for security reasons.")
+            table = None
 
         if raw:
             return Response(
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index f378783e90a42..5e9e51c8160a9 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -428,7 +428,20 @@ def test_refresh(self):
 
 
 class TestConfigurationView(TestBase):
-    def test_configuration(self):
+
+    def test_configuration_do_not_expose_config(self):
+        self.logout()
+        self.login()
+        conf.set("webserver", "expose_config", "False")
+        resp = self.client.get('configuration', follow_redirects=True)
+        self.check_content_in_response(
+            ['Airflow Configuration', '# Your Airflow administrator chose not to expose the configuration, '
+                                      'most likely for security reasons.'], resp)
+
+    def test_configuration_expose_config(self):
+        self.logout()
+        self.login()
+        conf.set("webserver", "expose_config", "True")
         resp = self.client.get('configuration', follow_redirects=True)
         self.check_content_in_response(
             ['Airflow Configuration', 'Running Configuration'], resp)

From 5d50e9b56ecf761e77f880108a14850cbc8fe39d Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 29 Sep 2018 15:14:18 +0100
Subject: [PATCH 214/808] [AIRFLOW-XXX] Don't spam test logs with "bad cron
 expression" messages (#3973)

We needed these test dags to check the behaviour of invalid cron
expressions, but by default we were loading them every time we create a
DagBag (which many, many tests to).

Instead we ignore these known-bad dags by default, and the test checking
those (tests/models.py:DagBagTest.test_process_file_cron_validity_check)
is already explicitly processing those DAGs directly, so it remains
tested.
---
 tests/dags/.airflowignore |  1 +
 tests/jobs.py             | 18 ++++++++++++------
 2 files changed, 13 insertions(+), 6 deletions(-)
 create mode 100644 tests/dags/.airflowignore

diff --git a/tests/dags/.airflowignore b/tests/dags/.airflowignore
new file mode 100644
index 0000000000000..93361c17e24d8
--- /dev/null
+++ b/tests/dags/.airflowignore
@@ -0,0 +1 @@
+.*_invalid.*
diff --git a/tests/jobs.py b/tests/jobs.py
index f106bafaabcd3..062a69661f787 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -3319,16 +3319,22 @@ def test_list_py_file_paths(self):
         [JIRA-1357] Test the 'list_py_file_paths' function used by the
         scheduler to list and load DAGs.
         """
-        detected_files = []
-        expected_files = []
+        detected_files = set()
+        expected_files = set()
+        # No_dags is empty, _invalid_ is ignored by .airflowignore
+        ignored_files = [
+            'no_dags.py',
+            'test_invalid_cron.py',
+            'test_zip_invalid_cron.zip',
+        ]
         for file_name in os.listdir(TEST_DAGS_FOLDER):
             if file_name.endswith('.py') or file_name.endswith('.zip'):
-                if file_name not in ['no_dags.py']:
-                    expected_files.append(
+                if file_name not in ignored_files:
+                    expected_files.add(
                         '{}/{}'.format(TEST_DAGS_FOLDER, file_name))
         for file_path in list_py_file_paths(TEST_DAGS_FOLDER):
-            detected_files.append(file_path)
-        self.assertEqual(sorted(detected_files), sorted(expected_files))
+            detected_files.add(file_path)
+        self.assertEqual(detected_files, expected_files)
 
     def test_reset_orphaned_tasks_nothing(self):
         """Try with nothing. """

From 5600c2bf43ac3ebefb2d48aaefc265f16faff2c1 Mon Sep 17 00:00:00 2001
From: Shintaro Murakami <mrkm4ntr@gmail.com>
Date: Mon, 26 Nov 2018 06:48:11 +0900
Subject: [PATCH 215/808] [AIRFLOW-1561] Fix scheduler to pick up example DAGs
 without other DAGs (#2635)

---
 airflow/jobs.py                 |  2 +-
 airflow/models.py               | 12 ++++--------
 airflow/utils/dag_processing.py |  7 ++++++-
 tests/jobs.py                   | 14 +++++++++++++-
 4 files changed, 24 insertions(+), 11 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 48726733982ff..bf4d12c50db01 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1670,7 +1670,7 @@ def process_file(self, file_path, zombies, pickle_dags=False, session=None):
         simple_dags = []
 
         try:
-            dagbag = models.DagBag(file_path)
+            dagbag = models.DagBag(file_path, include_examples=False)
         except Exception:
             self.log.exception("Failed at reloading the DAG file %s", file_path)
             Stats.incr('dag_file_refresh_error', 1, 1)
diff --git a/airflow/models.py b/airflow/models.py
index 5248c76e07ea1..4745c771c8d28 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -277,12 +277,7 @@ def __init__(
         self.import_errors = {}
         self.has_logged = False
 
-        if include_examples:
-            example_dag_folder = os.path.join(
-                os.path.dirname(__file__),
-                'example_dags')
-            self.collect_dags(example_dag_folder)
-        self.collect_dags(dag_folder)
+        self.collect_dags(dag_folder, include_examples)
 
     def size(self):
         """
@@ -516,7 +511,8 @@ def bag_dag(self, dag, parent_dag, root_dag):
     def collect_dags(
             self,
             dag_folder=None,
-            only_if_updated=True):
+            only_if_updated=True,
+            include_examples=configuration.conf.getboolean('core', 'LOAD_EXAMPLES')):
         """
         Given a file path or a folder, this method looks for python modules,
         imports them and adds them to the dagbag collection.
@@ -536,7 +532,7 @@ def collect_dags(
         stats = []
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
-        for filepath in list_py_file_paths(dag_folder):
+        for filepath in list_py_file_paths(dag_folder, include_examples):
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 47f473e9aa3d3..1b2eeeff2aa79 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -215,7 +215,8 @@ def get_dag(self, dag_id):
         return self.dag_id_to_simple_dag[dag_id]
 
 
-def list_py_file_paths(directory, safe_mode=True):
+def list_py_file_paths(directory, safe_mode=True,
+                       include_examples=conf.getboolean('core', 'LOAD_EXAMPLES')):
     """
     Traverse a directory and look for Python files.
 
@@ -284,6 +285,10 @@ def list_py_file_paths(directory, safe_mode=True):
                 except Exception:
                     log = LoggingMixin().log
                     log.exception("Error while examining %s", f)
+    if include_examples:
+        import airflow.example_dags
+        example_dag_folder = airflow.example_dags.__path__[0]
+        file_paths.extend(list_py_file_paths(example_dag_folder, safe_mode, False))
     return file_paths
 
 
diff --git a/tests/jobs.py b/tests/jobs.py
index 062a69661f787..231944de3e8f5 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -42,6 +42,7 @@
 from airflow import AirflowException, settings, models
 from airflow import configuration
 from airflow.bin import cli
+import airflow.example_dags
 from airflow.executors import BaseExecutor, SequentialExecutor
 from airflow.jobs import BaseJob, BackfillJob, SchedulerJob, LocalTaskJob
 from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI
@@ -3332,7 +3333,18 @@ def test_list_py_file_paths(self):
                 if file_name not in ignored_files:
                     expected_files.add(
                         '{}/{}'.format(TEST_DAGS_FOLDER, file_name))
-        for file_path in list_py_file_paths(TEST_DAGS_FOLDER):
+        for file_path in list_py_file_paths(TEST_DAGS_FOLDER, include_examples=False):
+            detected_files.add(file_path)
+        self.assertEqual(detected_files, expected_files)
+
+        example_dag_folder = airflow.example_dags.__path__[0]
+        for root, dirs, files in os.walk(example_dag_folder):
+            for file_name in files:
+                if file_name.endswith('.py') or file_name.endswith('.zip'):
+                    if file_name not in ['__init__.py']:
+                        expected_files.add(os.path.join(root, file_name))
+        detected_files.clear()
+        for file_path in list_py_file_paths(TEST_DAGS_FOLDER, include_examples=True):
             detected_files.add(file_path)
         self.assertEqual(detected_files, expected_files)
 

From dccb8f8bb83c27d16676be7b259980bd29246534 Mon Sep 17 00:00:00 2001
From: George Leslie-Waksman <george@cloverhealth.com>
Date: Sat, 21 Jul 2018 13:42:29 +0100
Subject: [PATCH 216/808] [AIRFLOW-2731] Raise psutil restriction to <6.0.0

Closes #3585 from gwax/upgrade_psutil
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index d6324cf5d9449..a76d768c2284d 100644
--- a/setup.py
+++ b/setup.py
@@ -292,7 +292,7 @@ def do_setup():
             'markdown>=2.5.2, <3.0',
             'pandas>=0.17.1, <1.0.0',
             'pendulum==1.4.4',
-            'psutil>=4.2.0, <5.0.0',
+            'psutil>=4.2.0, <6.0.0',
             'pygments>=2.0.1, <3.0',
             'python-daemon>=2.1.1, <2.2',
             'python-dateutil>=2.3, <3',

From 4e2f80975bd2e3c3232b261d71a0541fbeff2fcc Mon Sep 17 00:00:00 2001
From: Jon Davies <jpds@protonmail.com>
Date: Mon, 20 Aug 2018 23:41:11 +0100
Subject: [PATCH 217/808] [AIRFLOW-2908] Allow retries with KubernetesExecutor.
 (#3758)

---
 airflow/www/views.py      | 23 ++++++++++++++++-------
 airflow/www_rbac/views.py | 23 ++++++++++++++++-------
 2 files changed, 32 insertions(+), 14 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 40bb8e577e88e..483e12f66f284 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -993,16 +993,25 @@ def run(self):
         ignore_task_deps = request.args.get('ignore_task_deps') == "true"
         ignore_ti_state = request.args.get('ignore_ti_state') == "true"
 
+        from airflow.executors import GetDefaultExecutor
+        executor = GetDefaultExecutor()
+        valid_celery_config = False
+        valid_kubernetes_config = False
+
         try:
-            from airflow.executors import GetDefaultExecutor
             from airflow.executors.celery_executor import CeleryExecutor
-            executor = GetDefaultExecutor()
-            if not isinstance(executor, CeleryExecutor):
-                flash("Only works with the CeleryExecutor, sorry", "error")
-                return redirect(origin)
+            valid_celery_config = isinstance(executor, CeleryExecutor)
         except ImportError:
-            # in case CeleryExecutor cannot be imported it is not active either
-            flash("Only works with the CeleryExecutor, sorry", "error")
+            pass
+
+        try:
+            from airflow.contrib.executors.kubernetes_executor import KubernetesExecutor
+            valid_kubernetes_config = isinstance(executor, KubernetesExecutor)
+        except ImportError:
+            pass
+
+        if not valid_celery_config and not valid_kubernetes_config:
+            flash("Only works with the Celery or Kubernetes executors, sorry", "error")
             return redirect(origin)
 
         ti = models.TaskInstance(task=task, execution_date=execution_date)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index e2f439d20e037..2bfca2770621a 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -675,16 +675,25 @@ def run(self):
         ignore_task_deps = request.args.get('ignore_task_deps') == "true"
         ignore_ti_state = request.args.get('ignore_ti_state') == "true"
 
+        from airflow.executors import GetDefaultExecutor
+        executor = GetDefaultExecutor()
+        valid_celery_config = False
+        valid_kubernetes_config = False
+
         try:
-            from airflow.executors import GetDefaultExecutor
             from airflow.executors.celery_executor import CeleryExecutor
-            executor = GetDefaultExecutor()
-            if not isinstance(executor, CeleryExecutor):
-                flash("Only works with the CeleryExecutor, sorry", "error")
-                return redirect(origin)
+            valid_celery_config = isinstance(executor, CeleryExecutor)
         except ImportError:
-            # in case CeleryExecutor cannot be imported it is not active either
-            flash("Only works with the CeleryExecutor, sorry", "error")
+            pass
+
+        try:
+            from airflow.contrib.executors.kubernetes_executor import KubernetesExecutor
+            valid_kubernetes_config = isinstance(executor, KubernetesExecutor)
+        except ImportError:
+            pass
+
+        if not valid_celery_config and not valid_kubernetes_config:
+            flash("Only works with the Celery or Kubernetes executors, sorry", "error")
             return redirect(origin)
 
         ti = models.TaskInstance(task=task, execution_date=execution_date)

From 52601433e57d758c6b9d4934fe93ad186e4e3f66 Mon Sep 17 00:00:00 2001
From: Guoqiang Ding <dgq8211@gmail.com>
Date: Tue, 6 Nov 2018 03:25:03 +0800
Subject: [PATCH 218/808] [AIRFLOW-3132] Enable specifying auto_remove option
 for DockerOperator (#3977)

---
 airflow/operators/docker_operator.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index 04dbcab5691cf..cf9838593fe18 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -48,6 +48,10 @@ class DockerOperator(BaseOperator):
     :param api_version: Remote API version. Set to ``auto`` to automatically
         detect the server's version.
     :type api_version: str
+    :param auto_remove: Auto-removal of the container on daemon side when the
+        container's process exits.
+        The default is False.
+    :type auto_remove: bool
     :param command: Command to be run in the container. (templated)
     :type command: str or list
     :param cpus: Number of CPUs to assign to the container.
@@ -137,12 +141,14 @@ def __init__(
             docker_conn_id=None,
             dns=None,
             dns_search=None,
+            auto_remove=False,
             shm_size=None,
             *args,
             **kwargs):
 
         super(DockerOperator, self).__init__(*args, **kwargs)
         self.api_version = api_version
+        self.auto_remove = auto_remove
         self.command = command
         self.cpus = cpus
         self.dns = dns
@@ -207,6 +213,7 @@ def execute(self, context):
                 command=self.get_command(),
                 environment=self.environment,
                 host_config=self.cli.create_host_config(
+                    auto_remove=self.auto_remove,
                     binds=self.volumes,
                     network_mode=self.network_mode,
                     shm_size=self.shm_size,

From 775a466429b238a335df6f24a87f4cfcd87b5794 Mon Sep 17 00:00:00 2001
From: aoen <aoen@users.noreply.github.com>
Date: Sat, 17 Nov 2018 06:35:37 -0500
Subject: [PATCH 219/808] [AIRFLOW-3233] Fix deletion of DAGs in the UI (#4069)

---
 airflow/www/templates/airflow/dags.html      | 6 +++---
 airflow/www_rbac/templates/airflow/dags.html | 7 ++++---
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 5473189d439dd..a34c6720f6520 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -191,11 +191,11 @@ <h2>DAGs</h2>
                 </a>
 
                 <!-- Delete -->
-                <a href="{{ url_for('airflow.delete', dag_id=dag.dag_id) }}"
-                  onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+                <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
+                <a href="{{ url_for('airflow.delete', dag_id=dag_id) }}"
+                  onclick="return confirmDeleteDag('{{ dag_id }}')">
                    <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
-
                 </td>
             </tr>
         {% endfor %}
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index bba0d191dde35..cf23e3fe75195 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -192,9 +192,10 @@ <h2>DAGs</h2>
                 </a>
 
                 <!-- Delete -->
-                <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id) }}"
-                   onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
-                  <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
+                <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
+                <a href="{{ url_for('Airflow.delete', dag_id=dag_id) }}"
+                  onclick="return confirmDeleteDag('{{ dag_id }}')">
+                   <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
                 </td>
             </tr>

From a5aeb1c4d12ce6ec297bc590695f644240646b4d Mon Sep 17 00:00:00 2001
From: Marcus Rehm <marcus.rehm@gmail.com>
Date: Fri, 20 Jul 2018 22:46:59 +0200
Subject: [PATCH 220/808] [AIRFLOW-2596] Add Oracle to Azure Datalake Transfer
 Operator

Closes #3613 from
marcusrehm/oracle_to_azure_datalake_transfer
---
 .../oracle_to_azure_data_lake_transfer.py     | 113 +++++++++++++++
 docs/code.rst                                 |   1 +
 ...test_oracle_to_azure_data_lake_transfer.py | 135 ++++++++++++++++++
 3 files changed, 249 insertions(+)
 create mode 100644 airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
 create mode 100644 tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py

diff --git a/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
new file mode 100644
index 0000000000000..06a3998defa49
--- /dev/null
+++ b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.oracle_hook import OracleHook
+from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.utils.file import TemporaryDirectory
+
+import unicodecsv as csv
+import os
+
+
+class OracleToAzureDataLakeTransfer(BaseOperator):
+    """
+    Moves data from Oracle to Azure Data Lake. The operator runs the query against
+    Oracle and stores the file locally before loading it into Azure Data Lake.
+
+
+    :param filename: file name to be used by the csv file.
+    :type filename: str
+    :param azure_data_lake_conn_id: destination azure data lake connection.
+    :type azure_data_lake_conn_id: str
+    :param azure_data_lake_path: destination path in azure data lake to put the file.
+    :type azure_data_lake_path: str
+    :param oracle_conn_id: source Oracle connection.
+    :type oracle_conn_id: str
+    :param sql: SQL query to execute against the Oracle database. (templated)
+    :type sql: str
+    :param sql_params: Parameters to use in sql query. (templated)
+    :type sql_params: str
+    :param delimiter: field delimiter in the file.
+    :type delimiter: str
+    :param encoding: enconding type for the file.
+    :type encoding: str
+    :param quotechar: Character to use in quoting.
+    :type quotechar: str
+    :param quoting: Quoting strategy. See unicodecsv quoting for more information.
+    :type quoting: str
+    """
+
+    template_fields = ('filename', 'sql', 'sql_params')
+    ui_color = '#e08c8c'
+
+    @apply_defaults
+    def __init__(
+            self,
+            filename,
+            azure_data_lake_conn_id,
+            azure_data_lake_path,
+            oracle_conn_id,
+            sql,
+            sql_params={},
+            delimiter=",",
+            encoding="utf-8",
+            quotechar='"',
+            quoting=csv.QUOTE_MINIMAL,
+            *args, **kwargs):
+        super(OracleToAzureDataLakeTransfer, self).__init__(*args, **kwargs)
+        self.filename = filename
+        self.oracle_conn_id = oracle_conn_id
+        self.sql = sql
+        self.sql_params = sql_params
+        self.azure_data_lake_conn_id = azure_data_lake_conn_id
+        self.azure_data_lake_path = azure_data_lake_path
+        self.delimiter = delimiter
+        self.encoding = encoding
+        self.quotechar = quotechar
+        self.quoting = quoting
+
+    def _write_temp_file(self, cursor, path_to_save):
+        with open(path_to_save, 'wb') as csvfile:
+            csv_writer = csv.writer(csvfile, delimiter=self.delimiter,
+                                    encoding=self.encoding, quotechar=self.quotechar,
+                                    quoting=self.quoting)
+            csv_writer.writerow(map(lambda field: field[0], cursor.description))
+            csv_writer.writerows(cursor)
+            csvfile.flush()
+
+    def execute(self, context):
+        oracle_hook = OracleHook(oracle_conn_id=self.oracle_conn_id)
+        azure_data_lake_hook = AzureDataLakeHook(
+            azure_data_lake_conn_id=self.azure_data_lake_conn_id)
+
+        self.log.info("Dumping Oracle query results to local file")
+        conn = oracle_hook.get_conn()
+        cursor = conn.cursor()
+        cursor.execute(self.sql, self.sql_params)
+
+        with TemporaryDirectory(prefix='airflow_oracle_to_azure_op_') as temp:
+            self._write_temp_file(cursor, os.path.join(temp, self.filename))
+            self.log.info("Uploading local file to Azure Data Lake")
+            azure_data_lake_hook.upload_file(os.path.join(temp, self.filename),
+                                             os.path.join(self.azure_data_lake_path,
+                                                          self.filename))
+        cursor.close()
+        conn.close()
diff --git a/docs/code.rst b/docs/code.rst
index afa0dc4c112bc..b9b4923e2c4c0 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -188,6 +188,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator
 .. autoclass:: airflow.contrib.operators.mongo_to_s3.MongoToS3Operator
 .. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.oracle_to_azure_data_lake_transfer.OracleToAzureDataLakeTransfer
 .. autoclass:: airflow.contrib.operators.postgres_to_gcs_operator.PostgresToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
diff --git a/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py b/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py
new file mode 100644
index 0000000000000..e02e6312fb740
--- /dev/null
+++ b/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py
@@ -0,0 +1,135 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow.contrib.operators.oracle_to_azure_data_lake_transfer \
+    import OracleToAzureDataLakeTransfer
+from airflow.utils.file import TemporaryDirectory
+import unicodecsv as csv
+import os
+
+try:
+    from unittest import mock
+    from unittest.mock import MagicMock
+except ImportError:
+    try:
+        import mock
+        from mock import MagicMock
+    except ImportError:
+        mock = None
+
+
+class OracleToAzureDataLakeTransferTest(unittest.TestCase):
+
+    mock_module_path = 'airflow.contrib.operators.oracle_to_azure_data_lake_transfer'
+
+    def test_write_temp_file(self):
+        task_id = "some_test_id"
+        sql = "some_sql"
+        sql_params = {':p_data': "2018-01-01"}
+        oracle_conn_id = "oracle_conn_id"
+        filename = "some_filename"
+        azure_data_lake_conn_id = 'azure_data_lake_conn_id'
+        azure_data_lake_path = 'azure_data_lake_path'
+        delimiter = '|'
+        encoding = 'utf-8'
+        cursor_description = [
+            ('id', "<class 'cx_Oracle.NUMBER'>", 39, None, 38, 0, 0),
+            ('description', "<class 'cx_Oracle.STRING'>", 60, 240, None, None, 1)
+        ]
+        cursor_rows = [[1, 'description 1'], [2, 'description 2']]
+        mock_cursor = MagicMock()
+        mock_cursor.description = cursor_description
+        mock_cursor.__iter__.return_value = cursor_rows
+
+        op = OracleToAzureDataLakeTransfer(
+            task_id=task_id,
+            filename=filename,
+            oracle_conn_id=oracle_conn_id,
+            sql=sql,
+            sql_params=sql_params,
+            azure_data_lake_conn_id=azure_data_lake_conn_id,
+            azure_data_lake_path=azure_data_lake_path,
+            delimiter=delimiter,
+            encoding=encoding)
+
+        with TemporaryDirectory(prefix='airflow_oracle_to_azure_op_') as temp:
+            op._write_temp_file(mock_cursor, os.path.join(temp, filename))
+
+            assert os.path.exists(os.path.join(temp, filename)) == 1
+
+            with open(os.path.join(temp, filename), 'rb') as csvfile:
+                temp_file = csv.reader(csvfile, delimiter=delimiter, encoding=encoding)
+
+                rownum = 0
+                for row in temp_file:
+                    if rownum == 0:
+                        self.assertEqual(row[0], 'id')
+                        self.assertEqual(row[1], 'description')
+                    else:
+                        self.assertEqual(row[0], str(cursor_rows[rownum - 1][0]))
+                        self.assertEqual(row[1], cursor_rows[rownum - 1][1])
+                    rownum = rownum + 1
+
+    @mock.patch(mock_module_path + '.OracleHook',
+                autospec=True)
+    @mock.patch(mock_module_path + '.AzureDataLakeHook',
+                autospec=True)
+    def test_execute(self, mock_data_lake_hook, mock_oracle_hook):
+        task_id = "some_test_id"
+        sql = "some_sql"
+        sql_params = {':p_data': "2018-01-01"}
+        oracle_conn_id = "oracle_conn_id"
+        filename = "some_filename"
+        azure_data_lake_conn_id = 'azure_data_lake_conn_id'
+        azure_data_lake_path = 'azure_data_lake_path'
+        delimiter = '|'
+        encoding = 'latin-1'
+        cursor_description = [
+            ('id', "<class 'cx_Oracle.NUMBER'>", 39, None, 38, 0, 0),
+            ('description', "<class 'cx_Oracle.STRING'>", 60, 240, None, None, 1)
+        ]
+        cursor_rows = [[1, 'description 1'], [2, 'description 2']]
+        cursor_mock = MagicMock()
+        cursor_mock.description.return_value = cursor_description
+        cursor_mock.__iter__.return_value = cursor_rows
+        mock_oracle_conn = MagicMock()
+        mock_oracle_conn.cursor().return_value = cursor_mock
+        mock_oracle_hook.get_conn().return_value = mock_oracle_conn
+
+        op = OracleToAzureDataLakeTransfer(
+            task_id=task_id,
+            filename=filename,
+            oracle_conn_id=oracle_conn_id,
+            sql=sql,
+            sql_params=sql_params,
+            azure_data_lake_conn_id=azure_data_lake_conn_id,
+            azure_data_lake_path=azure_data_lake_path,
+            delimiter=delimiter,
+            encoding=encoding)
+
+        op.execute(None)
+
+        mock_oracle_hook.assert_called_once_with(oracle_conn_id=oracle_conn_id)
+        mock_data_lake_hook.assert_called_once_with(
+            azure_data_lake_conn_id=azure_data_lake_conn_id)
+
+
+if __name__ == '__main__':
+    unittest.main()

From 7f1095f23477e13c76b7e74aa760faa16e7c8d78 Mon Sep 17 00:00:00 2001
From: Marcus Rehm <marcusrehm@users.noreply.github.com>
Date: Tue, 31 Jul 2018 16:22:40 -0300
Subject: [PATCH 221/808] [AIRFLOW-2795] Oracle to Oracle Transfer Operator
 (#3639)

---
 .../operators/oracle_to_oracle_transfer.py    | 90 +++++++++++++++++++
 docs/code.rst                                 |  1 +
 .../test_oracle_to_oracle_transfer.py         | 80 +++++++++++++++++
 3 files changed, 171 insertions(+)
 create mode 100644 airflow/contrib/operators/oracle_to_oracle_transfer.py
 create mode 100644 tests/contrib/operators/test_oracle_to_oracle_transfer.py

diff --git a/airflow/contrib/operators/oracle_to_oracle_transfer.py b/airflow/contrib/operators/oracle_to_oracle_transfer.py
new file mode 100644
index 0000000000000..31eb89b7dded2
--- /dev/null
+++ b/airflow/contrib/operators/oracle_to_oracle_transfer.py
@@ -0,0 +1,90 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.oracle_hook import OracleHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class OracleToOracleTransfer(BaseOperator):
+    """
+    Moves data from Oracle to Oracle.
+
+
+    :param oracle_destination_conn_id: destination Oracle connection.
+    :type oracle_destination_conn_id: str
+    :param destination_table: destination table to insert rows.
+    :type destination_table: str
+    :param oracle_source_conn_id: source Oracle connection.
+    :type oracle_source_conn_id: str
+    :param source_sql: SQL query to execute against the source Oracle
+        database. (templated)
+    :type source_sql: str
+    :param source_sql_params: Parameters to use in sql query. (templated)
+    :type source_sql_params: dict
+    :param rows_chunk: number of rows per chunk to commit.
+    :type rows_chunk: int
+    """
+
+    template_fields = ('source_sql', 'source_sql_params')
+    ui_color = '#e08c8c'
+
+    @apply_defaults
+    def __init__(
+            self,
+            oracle_destination_conn_id,
+            destination_table,
+            oracle_source_conn_id,
+            source_sql,
+            source_sql_params={},
+            rows_chunk=5000,
+            *args, **kwargs):
+        super(OracleToOracleTransfer, self).__init__(*args, **kwargs)
+        self.oracle_destination_conn_id = oracle_destination_conn_id
+        self.destination_table = destination_table
+        self.oracle_source_conn_id = oracle_source_conn_id
+        self.source_sql = source_sql
+        self.source_sql_params = source_sql_params
+        self.rows_chunk = rows_chunk
+
+    def _execute(self, src_hook, dest_hook, context):
+        with src_hook.get_conn() as src_conn:
+            cursor = src_conn.cursor()
+            self.log.info("Querying data from source: {0}".format(
+                self.oracle_source_conn_id))
+            cursor.execute(self.source_sql, self.source_sql_params)
+            target_fields = list(map(lambda field: field[0], cursor.description))
+
+            rows_total = 0
+            rows = cursor.fetchmany(self.rows_chunk)
+            while len(rows) > 0:
+                rows_total = rows_total + len(rows)
+                dest_hook.bulk_insert_rows(self.destination_table, rows,
+                                           target_fields=target_fields,
+                                           commit_every=self.rows_chunk)
+                rows = cursor.fetchmany(self.rows_chunk)
+                self.log.info("Total inserted: {0} rows".format(rows_total))
+
+            self.log.info("Finished data transfer.")
+            cursor.close()
+
+    def execute(self, context):
+        src_hook = OracleHook(oracle_conn_id=self.oracle_source_conn_id)
+        dest_hook = OracleHook(oracle_conn_id=self.oracle_destination_conn_id)
+        self._execute(src_hook, dest_hook, context)
diff --git a/docs/code.rst b/docs/code.rst
index b9b4923e2c4c0..30cef507e1e85 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -189,6 +189,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.mongo_to_s3.MongoToS3Operator
 .. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.oracle_to_azure_data_lake_transfer.OracleToAzureDataLakeTransfer
+.. autoclass:: airflow.contrib.operators.oracle_to_oracle_transfer.OracleToOracleTransfer
 .. autoclass:: airflow.contrib.operators.postgres_to_gcs_operator.PostgresToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
diff --git a/tests/contrib/operators/test_oracle_to_oracle_transfer.py b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
new file mode 100644
index 0000000000000..83d25e05a30f0
--- /dev/null
+++ b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow.contrib.operators.oracle_to_oracle_transfer \
+    import OracleToOracleTransfer
+
+try:
+    from unittest import mock
+    from unittest.mock import MagicMock
+except ImportError:
+    try:
+        import mock
+        from mock import MagicMock
+    except ImportError:
+        mock = None
+
+
+class OracleToOracleTransferTest(unittest.TestCase):
+
+    def test_execute(self):
+        oracle_destination_conn_id = 'oracle_destination_conn_id'
+        destination_table = 'destination_table'
+        oracle_source_conn_id = 'oracle_source_conn_id'
+        source_sql = "select sysdate from dual where trunc(sysdate) = :p_data"
+        source_sql_params = {':p_data': "2018-01-01"}
+        rows_chunk = 5000
+        cursor_description = [
+            ('id', "<class 'cx_Oracle.NUMBER'>", 39, None, 38, 0, 0),
+            ('description', "<class 'cx_Oracle.STRING'>", 60, 240, None, None, 1)
+        ]
+        cursor_rows = [[1, 'description 1'], [2, 'description 2']]
+
+        mock_dest_hook = MagicMock()
+        mock_src_hook = MagicMock()
+        mock_src_conn = mock_src_hook.get_conn.return_value.__enter__.return_value
+        mock_cursor = mock_src_conn.cursor.return_value
+        mock_cursor.description.__iter__.return_value = cursor_description
+        mock_cursor.fetchmany.side_effect = [cursor_rows, []]
+
+        op = OracleToOracleTransfer(
+            task_id='copy_data',
+            oracle_destination_conn_id=oracle_destination_conn_id,
+            destination_table=destination_table,
+            oracle_source_conn_id=oracle_source_conn_id,
+            source_sql=source_sql,
+            source_sql_params=source_sql_params,
+            rows_chunk=rows_chunk)
+
+        op._execute(mock_src_hook, mock_dest_hook, None)
+
+        assert mock_src_hook.get_conn.called
+        assert mock_src_conn.cursor.called
+        mock_cursor.execute.assert_called_with(source_sql, source_sql_params)
+        mock_cursor.fetchmany.assert_called_with(rows_chunk)
+        mock_dest_hook.bulk_insert_rows.assert_called_once_with(
+            destination_table,
+            cursor_rows,
+            commit_every=rows_chunk,
+            target_fields=['id', 'description'])
+
+
+if __name__ == '__main__':
+    unittest.main()

From 488717b90a1046f47c2b0f0801c7b524410177e2 Mon Sep 17 00:00:00 2001
From: Jeffrey Scott Keone Payne <jpayne@bombora.com>
Date: Sun, 22 Jul 2018 21:54:21 +0100
Subject: [PATCH 222/808] [AIRFLOW-2753] Add dataproc_job_id instance var
 holding actual DP jobId

Closes #3622 from jeffkpayne/master
---
 .../contrib/operators/dataproc_operator.py    | 61 ++++++++++++--
 .../operators/test_dataproc_operator.py       | 79 ++++++++++++++++---
 2 files changed, 125 insertions(+), 15 deletions(-)

diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index cc7ff21b0df2a..82d0654c64ff2 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -716,6 +716,11 @@ class DataProcPigOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.pg', '.pig',)
@@ -763,7 +768,10 @@ def execute(self, context):
         job.add_jar_file_uris(self.dataproc_jars)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataProcHiveOperator(BaseOperator):
@@ -796,6 +804,11 @@ class DataProcHiveOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.q',)
@@ -844,7 +857,10 @@ def execute(self, context):
         job.add_jar_file_uris(self.dataproc_jars)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataProcSparkSqlOperator(BaseOperator):
@@ -878,6 +894,11 @@ class DataProcSparkSqlOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.q',)
@@ -926,7 +947,10 @@ def execute(self, context):
         job.add_jar_file_uris(self.dataproc_jars)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataProcSparkOperator(BaseOperator):
@@ -967,6 +991,11 @@ class DataProcSparkOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1017,7 +1046,10 @@ def execute(self, context):
         job.add_file_uris(self.files)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataProcHadoopOperator(BaseOperator):
@@ -1058,6 +1090,11 @@ class DataProcHadoopOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1108,10 +1145,14 @@ def execute(self, context):
         job.add_file_uris(self.files)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataProcPySparkOperator(BaseOperator):
+    # TODO Add docs around dataproc_job_id.
     """
     Start a PySpark Job on a Cloud DataProc cluster.
 
@@ -1149,6 +1190,11 @@ class DataProcPySparkOperator(BaseOperator):
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
     :type region: string
+    :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
+        This is useful for identifying or linking to the job in the Google Cloud Console
+        Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
+        an 8 character random string.
+    :vartype dataproc_job_id: string
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1239,7 +1285,10 @@ def execute(self, context):
         job.add_python_file_uris(self.pyfiles)
         job.set_job_name(self.job_name)
 
-        hook.submit(hook.project_id, job.build(), self.region)
+        job_to_submit = job.build()
+        self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
+
+        hook.submit(hook.project_id, job_to_submit, self.region)
 
 
 class DataprocWorkflowTemplateBaseOperator(BaseOperator):
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 4d8540eb86202..aea74a7abfc71 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -45,7 +45,7 @@
     except ImportError:
         mock = None
 
-from mock import Mock
+from mock import MagicMock, Mock
 from mock import patch
 
 TASK_ID = 'test-dataproc-operator'
@@ -83,6 +83,27 @@
 TEMPLATE_ID = 'template-id'
 
 HOOK = 'airflow.contrib.operators.dataproc_operator.DataProcHook'
+DATAPROC_JOB_ID = 'dataproc_job_id'
+DATAPROC_JOB_TO_SUBMIT = {
+    'job': {
+        'reference': {
+            'projectId': PROJECT_ID,
+            'jobId': DATAPROC_JOB_ID,
+        },
+        'placement': {
+            'clusterName': CLUSTER_NAME
+        }
+    }
+}
+
+
+def _assert_dataproc_job_id(mock_hook, dataproc_task):
+    hook = mock_hook.return_value
+    job = MagicMock()
+    job.build.return_value = DATAPROC_JOB_TO_SUBMIT
+    hook.create_job_template.return_value = job
+    dataproc_task.execute(None)
+    assert dataproc_task.dataproc_job_id == DATAPROC_JOB_ID
 
 
 class DataprocClusterCreateOperatorTest(unittest.TestCase):
@@ -502,31 +523,51 @@ def test_cluster_name_log_sub(self):
 class DataProcHadoopOperatorTest(unittest.TestCase):
     # Unit test for the DataProcHadoopOperator
     def test_hook_correct_region(self):
-       with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
+        with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHadoopOperator(
                 task_id=TASK_ID,
                 region=REGION
             )
 
             dataproc_task.execute(None)
-            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY, REGION)
+            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
+                                                                  REGION)
+
+    def test_dataproc_job_id_is_set(self):
+        with patch(HOOK) as mock_hook:
+            dataproc_task = DataProcHadoopOperator(
+                task_id=TASK_ID
+            )
+
+            _assert_dataproc_job_id(mock_hook, dataproc_task)
+
 
 class DataProcHiveOperatorTest(unittest.TestCase):
     # Unit test for the DataProcHiveOperator
     def test_hook_correct_region(self):
-       with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
+        with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHiveOperator(
                 task_id=TASK_ID,
                 region=REGION
             )
 
             dataproc_task.execute(None)
-            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY, REGION)
+            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
+                                                                  REGION)
+
+    def test_dataproc_job_id_is_set(self):
+        with patch(HOOK) as mock_hook:
+            dataproc_task = DataProcHiveOperator(
+                task_id=TASK_ID
+            )
+
+            _assert_dataproc_job_id(mock_hook, dataproc_task)
+
 
 class DataProcPySparkOperatorTest(unittest.TestCase):
     # Unit test for the DataProcPySparkOperator
     def test_hook_correct_region(self):
-       with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
+        with patch(HOOK) as mock_hook:
             dataproc_task = DataProcPySparkOperator(
                 task_id=TASK_ID,
                 main=MAIN_URI,
@@ -534,19 +575,39 @@ def test_hook_correct_region(self):
             )
 
             dataproc_task.execute(None)
-            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY, REGION)
+            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
+                                                                  REGION)
+
+    def test_dataproc_job_id_is_set(self):
+        with patch(HOOK) as mock_hook:
+            dataproc_task = DataProcPySparkOperator(
+                task_id=TASK_ID,
+                main=MAIN_URI
+            )
+
+            _assert_dataproc_job_id(mock_hook, dataproc_task)
+
 
 class DataProcSparkOperatorTest(unittest.TestCase):
     # Unit test for the DataProcSparkOperator
     def test_hook_correct_region(self):
-       with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
+        with patch(HOOK) as mock_hook:
             dataproc_task = DataProcSparkOperator(
                 task_id=TASK_ID,
                 region=REGION
             )
 
             dataproc_task.execute(None)
-            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY, REGION)
+            mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
+                                                                  REGION)
+
+    def test_dataproc_job_id_is_set(self):
+        with patch(HOOK) as mock_hook:
+            dataproc_task = DataProcSparkOperator(
+                task_id=TASK_ID
+            )
+
+            _assert_dataproc_job_id(mock_hook, dataproc_task)
 
 
 class DataprocWorkflowTemplateInstantiateOperatorTest(unittest.TestCase):

From 2e9615949c001829ae36c0875e7d5db6d4fd4882 Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Wed, 18 Jul 2018 08:54:19 -0700
Subject: [PATCH 223/808] [AIRFLOW-2705] Move class-level moto decorator to
 method-level

Moto decorators at class-level make other
tests that sends HTTP request fail.
This PR moves them to method-level
so as to fix this problem.

Closes #3565 from sekikn/AIRFLOW-2705
---
 tests/contrib/hooks/test_redshift_hook.py         | 15 ++++++++++++++-
 .../sensors/test_aws_redshift_cluster_sensor.py   |  9 ++++++++-
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/tests/contrib/hooks/test_redshift_hook.py b/tests/contrib/hooks/test_redshift_hook.py
index d5e791b4b7c80..c69ed8a9dca2a 100644
--- a/tests/contrib/hooks/test_redshift_hook.py
+++ b/tests/contrib/hooks/test_redshift_hook.py
@@ -31,10 +31,11 @@
     mock_redshift = None
 
 
-@mock_redshift
 class TestRedshiftHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
+
+    def _create_clusters(self):
         client = boto3.client('redshift', region_name='us-east-1')
         client.create_cluster(
             ClusterIdentifier='test_cluster',
@@ -52,7 +53,9 @@ def setUp(self):
             raise ValueError('AWS not properly mocked')
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_get_client_type_returns_a_boto3_client_of_the_requested_type(self):
+        self._create_clusters()
         hook = AwsHook(aws_conn_id='aws_default')
         client_from_hook = hook.get_client_type('redshift')
 
@@ -60,7 +63,9 @@ def test_get_client_type_returns_a_boto3_client_of_the_requested_type(self):
         self.assertEqual(len(clusters), 2)
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_restore_from_cluster_snapshot_returns_dict_with_cluster_data(self):
+        self._create_clusters()
         hook = RedshiftHook(aws_conn_id='aws_default')
         hook.create_cluster_snapshot('test_snapshot', 'test_cluster')
         self.assertEqual(
@@ -70,27 +75,35 @@ def test_restore_from_cluster_snapshot_returns_dict_with_cluster_data(self):
             'test_cluster_3')
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_delete_cluster_returns_a_dict_with_cluster_data(self):
+        self._create_clusters()
         hook = RedshiftHook(aws_conn_id='aws_default')
 
         cluster = hook.delete_cluster('test_cluster_2')
         self.assertNotEqual(cluster, None)
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_create_cluster_snapshot_returns_snapshot_data(self):
+        self._create_clusters()
         hook = RedshiftHook(aws_conn_id='aws_default')
 
         snapshot = hook.create_cluster_snapshot('test_snapshot_2', 'test_cluster')
         self.assertNotEqual(snapshot, None)
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_cluster_status_returns_cluster_not_found(self):
+        self._create_clusters()
         hook = RedshiftHook(aws_conn_id='aws_default')
         status = hook.cluster_status('test_cluster_not_here')
         self.assertEqual(status, 'cluster_not_found')
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_cluster_status_returns_available_cluster(self):
+        self._create_clusters()
         hook = RedshiftHook(aws_conn_id='aws_default')
         status = hook.cluster_status('test_cluster')
         self.assertEqual(status, 'available')
diff --git a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
index 5bee24aeda548..921b2dac1fae9 100644
--- a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
+++ b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
@@ -31,10 +31,11 @@
     mock_redshift = None
 
 
-@mock_redshift
 class TestAwsRedshiftClusterSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
+
+    def _create_cluster(self):
         client = boto3.client('redshift', region_name='us-east-1')
         client.create_cluster(
             ClusterIdentifier='test_cluster',
@@ -46,7 +47,9 @@ def setUp(self):
             raise ValueError('AWS not properly mocked')
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_poke(self):
+        self._create_cluster()
         op = AwsRedshiftClusterSensor(task_id='test_cluster_sensor',
                                       poke_interval=1,
                                       timeout=5,
@@ -56,7 +59,9 @@ def test_poke(self):
         self.assertTrue(op.poke(None))
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_poke_false(self):
+        self._create_cluster()
         op = AwsRedshiftClusterSensor(task_id='test_cluster_sensor',
                                       poke_interval=1,
                                       timeout=5,
@@ -67,7 +72,9 @@ def test_poke_false(self):
         self.assertFalse(op.poke(None))
 
     @unittest.skipIf(mock_redshift is None, 'mock_redshift package not present')
+    @mock_redshift
     def test_poke_cluster_not_found(self):
+        self._create_cluster()
         op = AwsRedshiftClusterSensor(task_id='test_cluster_sensor',
                                       poke_interval=1,
                                       timeout=5,

From e0f7cb3bc06bcb1dac2f560ca84a9d66bffe1849 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 8 Aug 2018 00:18:42 +0100
Subject: [PATCH 224/808] [AIRFLOW-2867] Refactor Code to conform standards
 (#3714)

---
 airflow/contrib/hooks/bigquery_hook.py        |  32 ++-
 airflow/contrib/hooks/databricks_hook.py      |   3 +-
 airflow/contrib/hooks/datastore_hook.py       |   4 +-
 airflow/contrib/hooks/gcp_container_hook.py   |   6 +-
 airflow/contrib/hooks/gcs_hook.py             |   2 +-
 airflow/contrib/hooks/salesforce_hook.py      |   3 +-
 airflow/contrib/hooks/vertica_hook.py         |   2 +-
 airflow/contrib/kubernetes/pod_launcher.py    |   2 +-
 .../contrib/operators/dataflow_operator.py    |   2 +-
 .../contrib/operators/dataproc_operator.py    |   6 +-
 .../operators/gcp_container_operator.py       |   4 +-
 airflow/contrib/operators/gcs_to_bq.py        |   8 +-
 .../operators/mlengine_prediction_summary.py  |   6 +-
 airflow/contrib/operators/mongo_to_s3.py      |   6 +-
 airflow/contrib/operators/mysql_to_gcs.py     |   3 +-
 .../oracle_to_azure_data_lake_transfer.py     | 228 +++++++++---------
 .../operators/oracle_to_oracle_transfer.py    |   4 +-
 .../contrib/operators/s3_to_gcs_operator.py   |   3 +-
 .../contrib/sensors/emr_job_flow_sensor.py    |   3 +-
 airflow/contrib/sensors/emr_step_sensor.py    |   3 +-
 .../contrib/task_runner/cgroup_task_runner.py |   3 +-
 airflow/executors/dask_executor.py            |   2 +-
 airflow/hooks/S3_hook.py                      |  10 +-
 airflow/hooks/druid_hook.py                   |   2 +-
 airflow/hooks/hive_hooks.py                   |   3 +-
 airflow/hooks/presto_hook.py                  |   3 +-
 airflow/jobs.py                               |   2 +-
 airflow/operators/check_operator.py           |   2 +-
 airflow/operators/hive_stats_operator.py      |   3 +-
 airflow/operators/python_operator.py          |   3 +-
 airflow/operators/s3_to_hive_operator.py      |   4 +-
 airflow/sensors/hdfs_sensor.py                |   4 +-
 airflow/utils/cli.py                          |   6 +-
 airflow/utils/helpers.py                      |   2 +-
 airflow/utils/log/gcs_task_handler.py         |   3 +-
 airflow/www/views.py                          |   2 +-
 airflow/www_rbac/forms.py                     |   2 +-
 airflow/www_rbac/views.py                     |   2 +-
 dev/airflow-pr                                |   2 +-
 scripts/perf/scheduler_ops_metrics.py         |   2 +-
 tests/cli/test_cli.py                         |   4 +-
 .../executors/test_kubernetes_executor.py     |   6 +-
 tests/contrib/hooks/test_aws_lambda_hook.py   |   3 +-
 tests/contrib/hooks/test_gcp_mlengine_hook.py |   3 +-
 tests/contrib/hooks/test_mongo_hook.py        |   4 +-
 tests/contrib/hooks/test_redshift_hook.py     |   3 +-
 .../minikube/test_kubernetes_executor.py      |   3 +-
 .../minikube/test_kubernetes_pod_operator.py  |  15 +-
 .../operators/test_dataproc_operator.py       |  24 +-
 .../test_hive_to_dynamodb_operator.py         |   3 +-
 .../operators/test_mysql_to_gcs_operator.py   |  11 +-
 .../test_oracle_to_oracle_transfer.py         |   3 +-
 .../test_aws_redshift_cluster_sensor.py       |   3 +-
 tests/contrib/sensors/test_emr_base_sensor.py |  24 +-
 tests/core.py                                 |   2 +-
 tests/models.py                               |   6 +-
 tests/operators/test_docker_operator.py       |   3 +-
 tests/operators/test_s3_to_hive_operator.py   |   8 +-
 tests/operators/test_virtualenv_operator.py   |   3 +-
 .../experimental/test_kerberos_endpoints.py   |   2 +-
 .../experimental/test_kerberos_endpoints.py   |   2 +-
 61 files changed, 302 insertions(+), 225 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index f9abdbaaacdab..b255bb1686b7f 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -206,7 +206,7 @@ def create_empty_table(self,
                            dataset_id,
                            table_id,
                            schema_fields=None,
-                           time_partitioning={},
+                           time_partitioning=None,
                            labels=None
                            ):
         """
@@ -238,6 +238,8 @@ def create_empty_table(self,
 
         :return:
         """
+        if time_partitioning is None:
+            time_partitioning = dict()
         project_id = project_id if project_id is not None else self.project_id
 
         table_resource = {
@@ -286,7 +288,7 @@ def create_external_table(self,
                               quote_character=None,
                               allow_quoted_newlines=False,
                               allow_jagged_rows=False,
-                              src_fmt_configs={},
+                              src_fmt_configs=None,
                               labels=None
                               ):
         """
@@ -352,6 +354,8 @@ def create_external_table(self,
         :type labels: dict
         """
 
+        if src_fmt_configs is None:
+            src_fmt_configs = {}
         project_id, dataset_id, external_table_id = \
             _split_tablename(table_input=external_project_dataset_table,
                              default_project_id=self.project_id,
@@ -482,7 +486,7 @@ def run_query(self,
                   labels=None,
                   schema_update_options=(),
                   priority='INTERACTIVE',
-                  time_partitioning={}):
+                  time_partitioning=None):
         """
         Executes a BigQuery SQL query. Optionally persists results in a BigQuery
         table. See here:
@@ -546,6 +550,8 @@ def run_query(self,
         """
 
         # TODO remove `bql` in Airflow 2.0 - Jira: [AIRFLOW-2513]
+        if time_partitioning is None:
+            time_partitioning = {}
         sql = bql if sql is None else sql
 
         if bql:
@@ -806,8 +812,8 @@ def run_load(self,
                  allow_quoted_newlines=False,
                  allow_jagged_rows=False,
                  schema_update_options=(),
-                 src_fmt_configs={},
-                 time_partitioning={}):
+                 src_fmt_configs=None,
+                 time_partitioning=None):
         """
         Executes a BigQuery load command to load data from Google Cloud Storage
         to BigQuery. See here:
@@ -876,6 +882,10 @@ def run_load(self,
         # if it's not, we raise a ValueError
         # Refer to this link for more details:
         #   https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).sourceFormat
+        if src_fmt_configs is None:
+            src_fmt_configs = {}
+        if time_partitioning is None:
+            time_partitioning = {}
         source_format = source_format.upper()
         allowed_formats = [
             "CSV", "NEWLINE_DELIMITED_JSON", "AVRO", "GOOGLE_SHEETS",
@@ -1007,12 +1017,12 @@ def run_with_configuration(self, configuration):
 
         # Wait for query to finish.
         keep_polling_job = True
-        while (keep_polling_job):
+        while keep_polling_job:
             try:
                 job = jobs.get(
                     projectId=self.project_id,
                     jobId=self.running_job_id).execute()
-                if (job['status']['state'] == 'DONE'):
+                if job['status']['state'] == 'DONE':
                     keep_polling_job = False
                     # Check if job had errors.
                     if 'errorResult' in job['status']:
@@ -1041,7 +1051,7 @@ def poll_job_complete(self, job_id):
         jobs = self.service.jobs()
         try:
             job = jobs.get(projectId=self.project_id, jobId=job_id).execute()
-            if (job['status']['state'] == 'DONE'):
+            if job['status']['state'] == 'DONE':
                 return True
         except HttpError as err:
             if err.resp.status in [500, 503]:
@@ -1075,13 +1085,13 @@ def cancel_query(self):
         polling_attempts = 0
 
         job_complete = False
-        while (polling_attempts < max_polling_attempts and not job_complete):
+        while polling_attempts < max_polling_attempts and not job_complete:
             polling_attempts = polling_attempts + 1
             job_complete = self.poll_job_complete(self.running_job_id)
-            if (job_complete):
+            if job_complete:
                 self.log.info('Job successfully canceled: %s, %s',
                               self.project_id, self.running_job_id)
-            elif (polling_attempts == max_polling_attempts):
+            elif polling_attempts == max_polling_attempts:
                 self.log.info(
                     "Stopping polling due to timeout. Job with id %s "
                     "has not completed cancel and may or may not finish.",
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index 4e05ddb0b1af4..cb2ba9bd00fd7 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -74,7 +74,8 @@ def __init__(
         self.retry_limit = retry_limit
         self.retry_delay = retry_delay
 
-    def _parse_host(self, host):
+    @staticmethod
+    def _parse_host(host):
         """
         The purpose of this function is to be robust to improper connections
         settings provided by users, specifically in the host field.
diff --git a/airflow/contrib/hooks/datastore_hook.py b/airflow/contrib/hooks/datastore_hook.py
index 5e54cf2a65384..b8c3ca00a0f46 100644
--- a/airflow/contrib/hooks/datastore_hook.py
+++ b/airflow/contrib/hooks/datastore_hook.py
@@ -172,7 +172,7 @@ def export_to_storage_bucket(self, bucket, namespace=None,
         """
         Export entities from Cloud Datastore to Cloud Storage for backup
         """
-        output_uri_prefix = 'gs://' + ('/').join(filter(None, [bucket, namespace]))
+        output_uri_prefix = 'gs://' + '/'.join(filter(None, [bucket, namespace]))
         if not entity_filter:
             entity_filter = {}
         if not labels:
@@ -191,7 +191,7 @@ def import_from_storage_bucket(self, bucket, file,
         """
         Import a backup from Cloud Storage to Cloud Datastore
         """
-        input_url = 'gs://' + ('/').join(filter(None, [bucket, namespace, file]))
+        input_url = 'gs://' + '/'.join(filter(None, [bucket, namespace, file]))
         if not entity_filter:
             entity_filter = {}
         if not labels:
diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 3cc3744c03686..970d4ec8992c0 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -44,7 +44,8 @@ def __init__(self, project_id, location):
         client_info = ClientInfo(client_library_version='airflow_v' + version.version)
         self.client = container_v1.ClusterManagerClient(client_info=client_info)
 
-    def _dict_to_proto(self, py_dict, proto):
+    @staticmethod
+    def _dict_to_proto(py_dict, proto):
         """
         Converts a python dictionary to the proto supplied
 
@@ -93,7 +94,8 @@ def get_operation(self, operation_name):
                                          zone=self.location,
                                          operation_id=operation_name)
 
-    def _append_label(self, cluster_proto, key, val):
+    @staticmethod
+    def _append_label(cluster_proto, key, val):
         """
         Append labels to provided Cluster Protobuf
 
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index b70825eb61f39..7b5b7194c004d 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -326,7 +326,7 @@ def list(self, bucket, versions=None, maxResults=None, prefix=None, delimiter=No
 
         ids = list()
         pageToken = None
-        while(True):
+        while True:
             response = service.objects().list(
                 bucket=bucket,
                 versions=versions,
diff --git a/airflow/contrib/hooks/salesforce_hook.py b/airflow/contrib/hooks/salesforce_hook.py
index ee18b353d2e82..24b67f49fc402 100644
--- a/airflow/contrib/hooks/salesforce_hook.py
+++ b/airflow/contrib/hooks/salesforce_hook.py
@@ -135,7 +135,8 @@ def get_available_fields(self, obj):
 
         return [f['name'] for f in desc['fields']]
 
-    def _build_field_list(self, fields):
+    @staticmethod
+    def _build_field_list(fields):
         # join all of the fields in a comma separated list
         return ",".join(fields)
 
diff --git a/airflow/contrib/hooks/vertica_hook.py b/airflow/contrib/hooks/vertica_hook.py
index f3411de994d7f..e6b36b51d5937 100644
--- a/airflow/contrib/hooks/vertica_hook.py
+++ b/airflow/contrib/hooks/vertica_hook.py
@@ -41,9 +41,9 @@ def get_conn(self):
             "user": conn.login,
             "password": conn.password or '',
             "database": conn.schema,
+            "host": conn.host or 'localhost'
         }
 
-        conn_config["host"] = conn.host or 'localhost'
         if not conn.port:
             conn_config["port"] = 5433
         else:
diff --git a/airflow/contrib/kubernetes/pod_launcher.py b/airflow/contrib/kubernetes/pod_launcher.py
index f34de419ae02f..8c8d949107494 100644
--- a/airflow/contrib/kubernetes/pod_launcher.py
+++ b/airflow/contrib/kubernetes/pod_launcher.py
@@ -113,7 +113,7 @@ def _monitor_pod(self, pod, get_logs):
         while self.pod_is_running(pod):
             self.log.info('Pod %s has state %s', pod.name, State.RUNNING)
             time.sleep(2)
-        return (self._task_status(self.read_pod(pod)), result)
+        return self._task_status(self.read_pod(pod)), result
 
     def _task_status(self, event):
         self.log.info(
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 792488156dcf3..4a1be8c918027 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -332,7 +332,7 @@ def execute(self, context):
             self.py_file, self.py_options)
 
 
-class GoogleCloudBucketHelper():
+class GoogleCloudBucketHelper(object):
     """GoogleCloudStorageHook helper class to download GCS object."""
     GCS_PREFIX_LENGTH = 5
 
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 82d0654c64ff2..f8b515961115c 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -538,7 +538,8 @@ def _build_scale_cluster_data(self):
         }
         return scale_data
 
-    def _get_graceful_decommission_timeout(self, timeout):
+    @staticmethod
+    def _get_graceful_decommission_timeout(timeout):
         match = re.match(r"^(\d+)(s|m|h|d)$", timeout)
         if match:
             if match.group(2) == "s":
@@ -622,7 +623,8 @@ def __init__(self,
         self.project_id = project_id
         self.region = region
 
-    def _wait_for_done(self, service, operation_name):
+    @staticmethod
+    def _wait_for_done(service, operation_name):
         time.sleep(15)
         while True:
             response = service.projects().regions().operations().get(
diff --git a/airflow/contrib/operators/gcp_container_operator.py b/airflow/contrib/operators/gcp_container_operator.py
index 5648b4d8a01b3..9c1eb12d7275c 100644
--- a/airflow/contrib/operators/gcp_container_operator.py
+++ b/airflow/contrib/operators/gcp_container_operator.py
@@ -94,7 +94,7 @@ class GKEClusterCreateOperator(BaseOperator):
     def __init__(self,
                  project_id,
                  location,
-                 body={},
+                 body=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v2',
                  *args,
@@ -143,6 +143,8 @@ def __init__(self,
         """
         super(GKEClusterCreateOperator, self).__init__(*args, **kwargs)
 
+        if body is None:
+            body = {}
         self.project_id = project_id
         self.gcp_conn_id = gcp_conn_id
         self.location = location
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 3a7798030cf49..533cf01de5666 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -143,14 +143,18 @@ def __init__(self,
                  google_cloud_storage_conn_id='google_cloud_default',
                  delegate_to=None,
                  schema_update_options=(),
-                 src_fmt_configs={},
+                 src_fmt_configs=None,
                  external_table=False,
-                 time_partitioning={},
+                 time_partitioning=None,
                  *args, **kwargs):
 
         super(GoogleCloudStorageToBigQueryOperator, self).__init__(*args, **kwargs)
 
         # GCS config
+        if src_fmt_configs is None:
+            src_fmt_configs = {}
+        if time_partitioning is None:
+            time_partitioning = {}
         self.bucket = bucket
         self.source_objects = source_objects
         self.schema_object = schema_object
diff --git a/airflow/contrib/operators/mlengine_prediction_summary.py b/airflow/contrib/operators/mlengine_prediction_summary.py
index 4efe81e64151f..5dac0a44a9dcb 100644
--- a/airflow/contrib/operators/mlengine_prediction_summary.py
+++ b/airflow/contrib/operators/mlengine_prediction_summary.py
@@ -102,10 +102,12 @@ def metric_fn(inst):
 
 
 class JsonCoder(object):
-    def encode(self, x):
+    @staticmethod
+    def encode(x):
         return json.dumps(x)
 
-    def decode(self, x):
+    @staticmethod
+    def decode(x):
         return json.loads(x)
 
 
diff --git a/airflow/contrib/operators/mongo_to_s3.py b/airflow/contrib/operators/mongo_to_s3.py
index 43b5d8b6c357a..8bfa7a52f80bb 100644
--- a/airflow/contrib/operators/mongo_to_s3.py
+++ b/airflow/contrib/operators/mongo_to_s3.py
@@ -96,7 +96,8 @@ def execute(self, context):
 
         return True
 
-    def _stringify(self, iterable, joinable='\n'):
+    @staticmethod
+    def _stringify(iterable, joinable='\n'):
         """
         Takes an iterable (pymongo Cursor or Array) containing dictionaries and
         returns a stringified version using python join
@@ -105,7 +106,8 @@ def _stringify(self, iterable, joinable='\n'):
             [json.dumps(doc, default=json_util.default) for doc in iterable]
         )
 
-    def transform(self, docs):
+    @staticmethod
+    def transform(docs):
         """
         Processes pyMongo cursor and returns an iterable with each element being
                 a JSON serializable dictionary
diff --git a/airflow/contrib/operators/mysql_to_gcs.py b/airflow/contrib/operators/mysql_to_gcs.py
index 4d1bb7b329e6c..eb47465e8e8ec 100644
--- a/airflow/contrib/operators/mysql_to_gcs.py
+++ b/airflow/contrib/operators/mysql_to_gcs.py
@@ -218,7 +218,8 @@ def _upload_to_gcs(self, files_to_upload):
         for object, tmp_file_handle in files_to_upload.items():
             hook.upload(self.bucket, object, tmp_file_handle.name, 'application/json')
 
-    def _convert_types(self, schema, col_type_dict, row):
+    @staticmethod
+    def _convert_types(schema, col_type_dict, row):
         """
         Takes a value from MySQLdb, and converts it to a value that's safe for
         JSON/Google cloud storage/BigQuery. Dates are converted to UTC seconds.
diff --git a/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
index 06a3998defa49..80cec8f462d9a 100644
--- a/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
+++ b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
@@ -1,113 +1,115 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from airflow.hooks.oracle_hook import OracleHook
-from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
-from airflow.models import BaseOperator
-from airflow.utils.decorators import apply_defaults
-from airflow.utils.file import TemporaryDirectory
-
-import unicodecsv as csv
-import os
-
-
-class OracleToAzureDataLakeTransfer(BaseOperator):
-    """
-    Moves data from Oracle to Azure Data Lake. The operator runs the query against
-    Oracle and stores the file locally before loading it into Azure Data Lake.
-
-
-    :param filename: file name to be used by the csv file.
-    :type filename: str
-    :param azure_data_lake_conn_id: destination azure data lake connection.
-    :type azure_data_lake_conn_id: str
-    :param azure_data_lake_path: destination path in azure data lake to put the file.
-    :type azure_data_lake_path: str
-    :param oracle_conn_id: source Oracle connection.
-    :type oracle_conn_id: str
-    :param sql: SQL query to execute against the Oracle database. (templated)
-    :type sql: str
-    :param sql_params: Parameters to use in sql query. (templated)
-    :type sql_params: str
-    :param delimiter: field delimiter in the file.
-    :type delimiter: str
-    :param encoding: enconding type for the file.
-    :type encoding: str
-    :param quotechar: Character to use in quoting.
-    :type quotechar: str
-    :param quoting: Quoting strategy. See unicodecsv quoting for more information.
-    :type quoting: str
-    """
-
-    template_fields = ('filename', 'sql', 'sql_params')
-    ui_color = '#e08c8c'
-
-    @apply_defaults
-    def __init__(
-            self,
-            filename,
-            azure_data_lake_conn_id,
-            azure_data_lake_path,
-            oracle_conn_id,
-            sql,
-            sql_params={},
-            delimiter=",",
-            encoding="utf-8",
-            quotechar='"',
-            quoting=csv.QUOTE_MINIMAL,
-            *args, **kwargs):
-        super(OracleToAzureDataLakeTransfer, self).__init__(*args, **kwargs)
-        self.filename = filename
-        self.oracle_conn_id = oracle_conn_id
-        self.sql = sql
-        self.sql_params = sql_params
-        self.azure_data_lake_conn_id = azure_data_lake_conn_id
-        self.azure_data_lake_path = azure_data_lake_path
-        self.delimiter = delimiter
-        self.encoding = encoding
-        self.quotechar = quotechar
-        self.quoting = quoting
-
-    def _write_temp_file(self, cursor, path_to_save):
-        with open(path_to_save, 'wb') as csvfile:
-            csv_writer = csv.writer(csvfile, delimiter=self.delimiter,
-                                    encoding=self.encoding, quotechar=self.quotechar,
-                                    quoting=self.quoting)
-            csv_writer.writerow(map(lambda field: field[0], cursor.description))
-            csv_writer.writerows(cursor)
-            csvfile.flush()
-
-    def execute(self, context):
-        oracle_hook = OracleHook(oracle_conn_id=self.oracle_conn_id)
-        azure_data_lake_hook = AzureDataLakeHook(
-            azure_data_lake_conn_id=self.azure_data_lake_conn_id)
-
-        self.log.info("Dumping Oracle query results to local file")
-        conn = oracle_hook.get_conn()
-        cursor = conn.cursor()
-        cursor.execute(self.sql, self.sql_params)
-
-        with TemporaryDirectory(prefix='airflow_oracle_to_azure_op_') as temp:
-            self._write_temp_file(cursor, os.path.join(temp, self.filename))
-            self.log.info("Uploading local file to Azure Data Lake")
-            azure_data_lake_hook.upload_file(os.path.join(temp, self.filename),
-                                             os.path.join(self.azure_data_lake_path,
-                                                          self.filename))
-        cursor.close()
-        conn.close()
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.oracle_hook import OracleHook
+from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.utils.file import TemporaryDirectory
+
+import unicodecsv as csv
+import os
+
+
+class OracleToAzureDataLakeTransfer(BaseOperator):
+    """
+    Moves data from Oracle to Azure Data Lake. The operator runs the query against
+    Oracle and stores the file locally before loading it into Azure Data Lake.
+
+
+    :param filename: file name to be used by the csv file.
+    :type filename: str
+    :param azure_data_lake_conn_id: destination azure data lake connection.
+    :type azure_data_lake_conn_id: str
+    :param azure_data_lake_path: destination path in azure data lake to put the file.
+    :type azure_data_lake_path: str
+    :param oracle_conn_id: source Oracle connection.
+    :type oracle_conn_id: str
+    :param sql: SQL query to execute against the Oracle database. (templated)
+    :type sql: str
+    :param sql_params: Parameters to use in sql query. (templated)
+    :type sql_params: str
+    :param delimiter: field delimiter in the file.
+    :type delimiter: str
+    :param encoding: enconding type for the file.
+    :type encoding: str
+    :param quotechar: Character to use in quoting.
+    :type quotechar: str
+    :param quoting: Quoting strategy. See unicodecsv quoting for more information.
+    :type quoting: str
+    """
+
+    template_fields = ('filename', 'sql', 'sql_params')
+    ui_color = '#e08c8c'
+
+    @apply_defaults
+    def __init__(
+            self,
+            filename,
+            azure_data_lake_conn_id,
+            azure_data_lake_path,
+            oracle_conn_id,
+            sql,
+            sql_params=None,
+            delimiter=",",
+            encoding="utf-8",
+            quotechar='"',
+            quoting=csv.QUOTE_MINIMAL,
+            *args, **kwargs):
+        super(OracleToAzureDataLakeTransfer, self).__init__(*args, **kwargs)
+        if sql_params is None:
+            sql_params = {}
+        self.filename = filename
+        self.oracle_conn_id = oracle_conn_id
+        self.sql = sql
+        self.sql_params = sql_params
+        self.azure_data_lake_conn_id = azure_data_lake_conn_id
+        self.azure_data_lake_path = azure_data_lake_path
+        self.delimiter = delimiter
+        self.encoding = encoding
+        self.quotechar = quotechar
+        self.quoting = quoting
+
+    def _write_temp_file(self, cursor, path_to_save):
+        with open(path_to_save, 'wb') as csvfile:
+            csv_writer = csv.writer(csvfile, delimiter=self.delimiter,
+                                    encoding=self.encoding, quotechar=self.quotechar,
+                                    quoting=self.quoting)
+            csv_writer.writerow(map(lambda field: field[0], cursor.description))
+            csv_writer.writerows(cursor)
+            csvfile.flush()
+
+    def execute(self, context):
+        oracle_hook = OracleHook(oracle_conn_id=self.oracle_conn_id)
+        azure_data_lake_hook = AzureDataLakeHook(
+            azure_data_lake_conn_id=self.azure_data_lake_conn_id)
+
+        self.log.info("Dumping Oracle query results to local file")
+        conn = oracle_hook.get_conn()
+        cursor = conn.cursor()
+        cursor.execute(self.sql, self.sql_params)
+
+        with TemporaryDirectory(prefix='airflow_oracle_to_azure_op_') as temp:
+            self._write_temp_file(cursor, os.path.join(temp, self.filename))
+            self.log.info("Uploading local file to Azure Data Lake")
+            azure_data_lake_hook.upload_file(os.path.join(temp, self.filename),
+                                             os.path.join(self.azure_data_lake_path,
+                                                          self.filename))
+        cursor.close()
+        conn.close()
diff --git a/airflow/contrib/operators/oracle_to_oracle_transfer.py b/airflow/contrib/operators/oracle_to_oracle_transfer.py
index 31eb89b7dded2..1db95f7520bb1 100644
--- a/airflow/contrib/operators/oracle_to_oracle_transfer.py
+++ b/airflow/contrib/operators/oracle_to_oracle_transfer.py
@@ -52,10 +52,12 @@ def __init__(
             destination_table,
             oracle_source_conn_id,
             source_sql,
-            source_sql_params={},
+            source_sql_params=None,
             rows_chunk=5000,
             *args, **kwargs):
         super(OracleToOracleTransfer, self).__init__(*args, **kwargs)
+        if source_sql_params is None:
+            source_sql_params = {}
         self.oracle_destination_conn_id = oracle_destination_conn_id
         self.destination_table = destination_table
         self.oracle_source_conn_id = oracle_source_conn_id
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index 2898af1071773..64d7dc7cab976 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -184,7 +184,8 @@ def execute(self, context):
 
     # Following functionality may be better suited in
     # airflow/contrib/hooks/gcs_hook.py
-    def _gcs_object_is_directory(self, object):
+    @staticmethod
+    def _gcs_object_is_directory(object):
         bucket, blob = _parse_gcs_url(object)
 
         return len(blob) == 0 or blob.endswith('/')
diff --git a/airflow/contrib/sensors/emr_job_flow_sensor.py b/airflow/contrib/sensors/emr_job_flow_sensor.py
index 31d16a066b241..4193c2d53ed4e 100644
--- a/airflow/contrib/sensors/emr_job_flow_sensor.py
+++ b/airflow/contrib/sensors/emr_job_flow_sensor.py
@@ -50,5 +50,6 @@ def get_emr_response(self):
         self.log.info('Poking cluster %s', self.job_flow_id)
         return emr.describe_cluster(ClusterId=self.job_flow_id)
 
-    def state_from_response(self, response):
+    @staticmethod
+    def state_from_response(response):
         return response['Cluster']['Status']['State']
diff --git a/airflow/contrib/sensors/emr_step_sensor.py b/airflow/contrib/sensors/emr_step_sensor.py
index 44aaea410dd1e..fc37a5ddb6ea2 100644
--- a/airflow/contrib/sensors/emr_step_sensor.py
+++ b/airflow/contrib/sensors/emr_step_sensor.py
@@ -53,5 +53,6 @@ def get_emr_response(self):
         self.log.info('Poking step %s on cluster %s', self.step_id, self.job_flow_id)
         return emr.describe_step(ClusterId=self.job_flow_id, StepId=self.step_id)
 
-    def state_from_response(self, response):
+    @staticmethod
+    def state_from_response(response):
         return response['Step']['Status']['State']
diff --git a/airflow/contrib/task_runner/cgroup_task_runner.py b/airflow/contrib/task_runner/cgroup_task_runner.py
index a97eac2af88ef..faa2407f09a97 100644
--- a/airflow/contrib/task_runner/cgroup_task_runner.py
+++ b/airflow/contrib/task_runner/cgroup_task_runner.py
@@ -193,7 +193,8 @@ def on_finish(self):
         if self._created_cpu_cgroup:
             self._delete_cgroup(self.cpu_cgroup_name)
 
-    def _get_cgroup_names(self):
+    @staticmethod
+    def _get_cgroup_names():
         """
         :return: a mapping between the subsystem name to the cgroup name
         :rtype: dict[str, str]
diff --git a/airflow/executors/dask_executor.py b/airflow/executors/dask_executor.py
index afdf3ad2d198f..80527a2512545 100644
--- a/airflow/executors/dask_executor.py
+++ b/airflow/executors/dask_executor.py
@@ -43,7 +43,7 @@ def __init__(self, cluster_address=None):
         super(DaskExecutor, self).__init__(parallelism=0)
 
     def start(self):
-        if (self.tls_ca) or (self.tls_key) or (self.tls_cert):
+        if self.tls_ca or self.tls_key or self.tls_cert:
             from distributed.security import Security
             security = Security(
                 tls_client_key=self.tls_key,
diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index ff3b98b6a91da..76188f109c244 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -42,7 +42,7 @@ def parse_s3_url(s3url):
         else:
             bucket_name = parsed_url.netloc
             key = parsed_url.path.strip('/')
-            return (bucket_name, key)
+            return bucket_name, key
 
     def check_for_bucket(self, bucket_name):
         """
@@ -223,8 +223,8 @@ def read_key(self, key, bucket_name=None):
     def select_key(self, key, bucket_name=None,
                    expression='SELECT * FROM S3Object',
                    expression_type='SQL',
-                   input_serialization={'CSV': {}},
-                   output_serialization={'CSV': {}}):
+                   input_serialization=None,
+                   output_serialization=None):
         """
         Reads a key with S3 Select.
 
@@ -247,6 +247,10 @@ def select_key(self, key, bucket_name=None,
             For more details about S3 Select parameters:
             http://boto3.readthedocs.io/en/latest/reference/services/s3.html#S3.Client.select_object_content
         """
+        if input_serialization is None:
+            input_serialization = {'CSV': {}}
+        if output_serialization is None:
+            output_serialization = {'CSV': {}}
         if not bucket_name:
             (bucket_name, key) = self.parse_s3_url(key)
 
diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index 48a09e67b20df..817295e89609d 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -70,7 +70,7 @@ def submit_indexing_job(self, json_index_spec):
 
         self.log.info("Druid ingestion spec: {}".format(json_index_spec))
         req_index = requests.post(url, json=json_index_spec, headers=self.header)
-        if (req_index.status_code != 200):
+        if req_index.status_code != 200:
             raise AirflowException('Did not get 200 when '
                                    'submitting the Druid job to {}'.format(url))
 
diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index 93e1f45fe6402..db6df226d06b2 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -137,7 +137,8 @@ def _prepare_cli_cmd(self):
 
         return [hive_bin] + cmd_extra + hive_params_list
 
-    def _prepare_hiveconf(self, d):
+    @staticmethod
+    def _prepare_hiveconf(d):
         """
         This function prepares a list of hiveconf params
         from a dictionary of key value pairs.
diff --git a/airflow/hooks/presto_hook.py b/airflow/hooks/presto_hook.py
index d6b5293fc0f97..c7ebd8f5dcb70 100644
--- a/airflow/hooks/presto_hook.py
+++ b/airflow/hooks/presto_hook.py
@@ -56,7 +56,8 @@ def get_conn(self):
     def _strip_sql(sql):
         return sql.strip().rstrip(';')
 
-    def _get_pretty_exception_message(self, e):
+    @staticmethod
+    def _get_pretty_exception_message(e):
         """
         Parses some DatabaseError to provide a better error message
         """
diff --git a/airflow/jobs.py b/airflow/jobs.py
index bf4d12c50db01..7a45056905523 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1183,7 +1183,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                     'task_concurrency')
                 if task_concurrency is not None:
                     num_running = task_concurrency_map[
-                        ((task_instance.dag_id, task_instance.task_id))
+                        (task_instance.dag_id, task_instance.task_id)
                     ]
 
                     if num_running >= task_concurrency:
diff --git a/airflow/operators/check_operator.py b/airflow/operators/check_operator.py
index 5a31737fd5a6c..a0d213cf6619c 100644
--- a/airflow/operators/check_operator.py
+++ b/airflow/operators/check_operator.py
@@ -147,7 +147,7 @@ def execute(self, context=None):
         is_numeric_value_check = isinstance(pass_value_conv, float)
 
         tolerance_pct_str = None
-        if (self.tol is not None):
+        if self.tol is not None:
             tolerance_pct_str = str(self.tol * 100) + '%'
 
         except_temp = ("Test failed.\nPass value:{pass_value_conv}\n"
diff --git a/airflow/operators/hive_stats_operator.py b/airflow/operators/hive_stats_operator.py
index fe83284193757..b0bb874956a92 100644
--- a/airflow/operators/hive_stats_operator.py
+++ b/airflow/operators/hive_stats_operator.py
@@ -91,8 +91,7 @@ def __init__(
     def get_default_exprs(self, col, col_type):
         if col in self.col_blacklist:
             return {}
-        d = {}
-        d[(col, 'non_null')] = "COUNT({col})"
+        d = {(col, 'non_null'): "COUNT({col})"}
         if col_type in ['double', 'int', 'bigint', 'float', 'double']:
             d[(col, 'sum')] = 'SUM({col})'
             d[(col, 'min')] = 'MIN({col})'
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 88f3b1a8a6347..a75f3a0207e41 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -351,7 +351,8 @@ def _generate_pip_install_cmd(self, tmp_dir):
             cmd = ['{}/bin/pip'.format(tmp_dir), 'install']
             return cmd + self.requirements
 
-    def _generate_python_cmd(self, tmp_dir, script_filename,
+    @staticmethod
+    def _generate_python_cmd(tmp_dir, script_filename,
                              input_filename, output_filename, string_args_filename):
         # direct path alleviates need to activate
         return ['{}/bin/python'.format(tmp_dir), script_filename,
diff --git a/airflow/operators/s3_to_hive_operator.py b/airflow/operators/s3_to_hive_operator.py
index 5faaf916b7417..b82ebce6fa295 100644
--- a/airflow/operators/s3_to_hive_operator.py
+++ b/airflow/operators/s3_to_hive_operator.py
@@ -261,8 +261,8 @@ def _match_headers(self, header_list):
         else:
             return True
 
+    @staticmethod
     def _delete_top_row_and_compress(
-            self,
             input_file_name,
             output_file_ext,
             dest_dir):
@@ -275,7 +275,7 @@ def _delete_top_row_and_compress(
 
         os_fh_output, fn_output = \
             tempfile.mkstemp(suffix=output_file_ext, dir=dest_dir)
-        with open(input_file_name, 'rb') as f_in,\
+        with open(input_file_name, 'rb') as f_in, \
                 open_fn(fn_output, 'wb') as f_out:
             f_in.seek(0)
             next(f_in)
diff --git a/airflow/sensors/hdfs_sensor.py b/airflow/sensors/hdfs_sensor.py
index c9bac08ecbfe7..d05adef71c276 100644
--- a/airflow/sensors/hdfs_sensor.py
+++ b/airflow/sensors/hdfs_sensor.py
@@ -39,13 +39,15 @@ class HdfsSensor(BaseSensorOperator):
     def __init__(self,
                  filepath,
                  hdfs_conn_id='hdfs_default',
-                 ignored_ext=['_COPYING_'],
+                 ignored_ext=None,
                  ignore_copying=True,
                  file_size=None,
                  hook=HDFSHook,
                  *args,
                  **kwargs):
         super(HdfsSensor, self).__init__(*args, **kwargs)
+        if ignored_ext is None:
+            ignored_ext = ['_COPYING_']
         self.filepath = filepath
         self.hdfs_conn_id = hdfs_conn_id
         self.file_size = file_size
diff --git a/airflow/utils/cli.py b/airflow/utils/cli.py
index 4a1e57a062b4b..32303cd90bd8d 100644
--- a/airflow/utils/cli.py
+++ b/airflow/utils/cli.py
@@ -94,10 +94,8 @@ def _build_metrics(func_name, namespace):
     :return: dict with metrics
     """
 
-    metrics = {'sub_command': func_name}
-    metrics['start_datetime'] = datetime.utcnow()
-    metrics['full_command'] = '{}'.format(list(sys.argv))
-    metrics['user'] = getpass.getuser()
+    metrics = {'sub_command': func_name, 'start_datetime': datetime.utcnow(),
+               'full_command': '{}'.format(list(sys.argv)), 'user': getpass.getuser()}
 
     assert isinstance(namespace, Namespace)
     tmp_dic = vars(namespace)
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index db58e650d8ce9..45d0217e230ae 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -127,7 +127,7 @@ def chunks(items, chunk_size):
     """
     Yield successive chunks of a given size from a list of items
     """
-    if (chunk_size <= 0):
+    if chunk_size <= 0:
         raise ValueError('Chunk size must be a positive integer')
     for i in range(0, len(items), chunk_size):
         yield items[i:i + chunk_size]
diff --git a/airflow/utils/log/gcs_task_handler.py b/airflow/utils/log/gcs_task_handler.py
index 8c34792bb2138..e768882ac5df3 100644
--- a/airflow/utils/log/gcs_task_handler.py
+++ b/airflow/utils/log/gcs_task_handler.py
@@ -164,7 +164,8 @@ def gcs_write(self, log, remote_log_location, append=True):
         except Exception as e:
             self.log.error('Could not write logs to %s: %s', remote_log_location, e)
 
-    def parse_gcs_url(self, gsurl):
+    @staticmethod
+    def parse_gcs_url(gsurl):
         """
         Given a Google Cloud Storage URL (gs://<bucket>/<blob>), returns a
         tuple containing the corresponding bucket and blob.
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 483e12f66f284..6bf60d63878fc 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1898,7 +1898,7 @@ def task_instances(self, session=None):
         if dttm:
             dttm = pendulum.parse(dttm)
         else:
-            return ("Error: Invalid execution_date")
+            return "Error: Invalid execution_date"
 
         task_instances = {
             ti.task_id: alchemy_to_dict(ti)
diff --git a/airflow/www_rbac/forms.py b/airflow/www_rbac/forms.py
index da9d12c7adfd9..61c34888e3568 100644
--- a/airflow/www_rbac/forms.py
+++ b/airflow/www_rbac/forms.py
@@ -93,7 +93,7 @@ class ConnectionForm(DynamicForm):
         widget=BS3TextFieldWidget())
     conn_type = SelectField(
         lazy_gettext('Conn Type'),
-        choices=(models.Connection._types),
+        choices=models.Connection._types,
         widget=Select2Widget())
     host = StringField(
         lazy_gettext('Host'),
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 2bfca2770621a..39d9fb58a3633 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1577,7 +1577,7 @@ def task_instances(self, session=None):
         if dttm:
             dttm = pendulum.parse(dttm)
         else:
-            return ("Error: Invalid execution_date")
+            return "Error: Invalid execution_date"
 
         task_instances = {
             ti.task_id: alchemy_to_dict(ti)
diff --git a/dev/airflow-pr b/dev/airflow-pr
index 65243ddf876ae..c7cea6446b61d 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -757,7 +757,7 @@ def standardize_jira_ref(text, only_jira=False):
 
     # Cleanup any remaining symbols:
     pattern = re.compile(r'^\W+(.*)', re.IGNORECASE)
-    if (pattern.search(text) is not None):
+    if pattern.search(text) is not None:
         text = pattern.search(text).groups()[0]
 
     def unique(seq):
diff --git a/scripts/perf/scheduler_ops_metrics.py b/scripts/perf/scheduler_ops_metrics.py
index d4e472d34feca..def829e7cdc3f 100644
--- a/scripts/perf/scheduler_ops_metrics.py
+++ b/scripts/perf/scheduler_ops_metrics.py
@@ -123,7 +123,7 @@ def heartbeat(self):
         if (len(successful_tis) == num_task_instances or
                 (datetime.now()-self.start_date).total_seconds() >
                 MAX_RUNTIME_SECS):
-            if (len(successful_tis) == num_task_instances):
+            if len(successful_tis) == num_task_instances:
                 self.log.info("All tasks processed! Printing stats.")
             else:
                 self.log.info("Test timeout reached. "
diff --git a/tests/cli/test_cli.py b/tests/cli/test_cli.py
index 944ee16fad167..81a0a16bda2e9 100644
--- a/tests/cli/test_cli.py
+++ b/tests/cli/test_cli.py
@@ -70,12 +70,14 @@ def create_mock_args(
     ignore_dependencies=False,
     force=False,
     run_as_user=None,
-    executor_config={},
+    executor_config=None,
     cfg_path=None,
     pickle=None,
     raw=None,
     interactive=None,
 ):
+    if executor_config is None:
+        executor_config = {}
     args = MagicMock(spec=Namespace)
     args.task_id = task_id
     args.dag_id = dag_id
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 0a389204b4d6c..a42a87dd17996 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -26,7 +26,8 @@
 
 
 class TestAirflowKubernetesScheduler(unittest.TestCase):
-    def _gen_random_string(self, str_len):
+    @staticmethod
+    def _gen_random_string(str_len):
         return ''.join([random.choice(string.printable) for _ in range(str_len)])
 
     def _cases(self):
@@ -45,7 +46,8 @@ def _cases(self):
 
         return cases
 
-    def _is_valid_name(self, name):
+    @staticmethod
+    def _is_valid_name(name):
         regex = "^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$"
         return (
             len(name) <= 253 and
diff --git a/tests/contrib/hooks/test_aws_lambda_hook.py b/tests/contrib/hooks/test_aws_lambda_hook.py
index a35a8fcd1e269..0b9744cd22285 100644
--- a/tests/contrib/hooks/test_aws_lambda_hook.py
+++ b/tests/contrib/hooks/test_aws_lambda_hook.py
@@ -42,7 +42,8 @@ def test_get_conn_returns_a_boto3_connection(self):
                              function_name="test_function", region_name="us-east-1")
         self.assertIsNotNone(hook.get_conn())
 
-    def lambda_function(self):
+    @staticmethod
+    def lambda_function():
         code = textwrap.dedent("""
 def lambda_handler(event, context):
     return event
diff --git a/tests/contrib/hooks/test_gcp_mlengine_hook.py b/tests/contrib/hooks/test_gcp_mlengine_hook.py
index bb3c5b62586db..c3bc7a9c0da0a 100644
--- a/tests/contrib/hooks/test_gcp_mlengine_hook.py
+++ b/tests/contrib/hooks/test_gcp_mlengine_hook.py
@@ -61,7 +61,8 @@ def __init__(self, test_cls, responses, expected_requests):
             for x in expected_requests]
         self._actual_requests = []
 
-    def _normalize_requests_for_comparison(self, uri, http_method, body):
+    @staticmethod
+    def _normalize_requests_for_comparison(uri, http_method, body):
         parts = urlparse(uri)
         return (
             parts._replace(query=set(parse_qsl(parts.query))),
diff --git a/tests/contrib/hooks/test_mongo_hook.py b/tests/contrib/hooks/test_mongo_hook.py
index 7696edea05a30..2d4c28f013426 100644
--- a/tests/contrib/hooks/test_mongo_hook.py
+++ b/tests/contrib/hooks/test_mongo_hook.py
@@ -23,10 +23,10 @@
 
 
 class MongoHookTest(MongoHook):
-    '''
+    """
     Extending hook so that a mockmongo collection object can be passed in
     to get_collection()
-    '''
+    """
     def __init__(self, conn_id='mongo_default', *args, **kwargs):
         super(MongoHookTest, self).__init__(conn_id=conn_id, *args, **kwargs)
 
diff --git a/tests/contrib/hooks/test_redshift_hook.py b/tests/contrib/hooks/test_redshift_hook.py
index c69ed8a9dca2a..029dfd38016c5 100644
--- a/tests/contrib/hooks/test_redshift_hook.py
+++ b/tests/contrib/hooks/test_redshift_hook.py
@@ -35,7 +35,8 @@ class TestRedshiftHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
 
-    def _create_clusters(self):
+    @staticmethod
+    def _create_clusters():
         client = boto3.client('redshift', region_name='us-east-1')
         client.create_cluster(
             ClusterIdentifier='test_cluster',
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index fe38efb81bec6..2d1105111b5b2 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -42,7 +42,8 @@ def get_minikube_host():
 
 
 class KubernetesExecutorTest(unittest.TestCase):
-    def _delete_airflow_pod(self):
+    @staticmethod
+    def _delete_airflow_pod():
         air_pod = check_output(['kubectl', 'get', 'pods']).decode()
         air_pod = air_pod.split('\n')
         names = [re.compile('\s+').split(x)[0] for x in air_pod if 'airflow' in x]
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 2cf615f83cf33..595d7aa8b43e5 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -39,7 +39,8 @@
 
 class KubernetesPodOperatorTest(unittest.TestCase):
 
-    def test_config_path_move(self):
+    @staticmethod
+    def test_config_path_move():
         new_config_path = '/tmp/kube_config'
         old_config_path = os.path.expanduser('~/.kube/config')
         shutil.copy(old_config_path, new_config_path)
@@ -80,7 +81,8 @@ def test_config_path(self, client_mock, launcher_mock):
                                        cluster_context='default',
                                        config_file=file_path)
 
-    def test_working_pod(self):
+    @staticmethod
+    def test_working_pod():
         k = KubernetesPodOperator(
             namespace='default',
             image="ubuntu:16.04",
@@ -138,7 +140,8 @@ def test_pod_node_selectors():
         )
         k.execute(None)
 
-    def test_pod_affinity(self):
+    @staticmethod
+    def test_pod_affinity():
         affinity = {
             'nodeAffinity': {
                 'requiredDuringSchedulingIgnoredDuringExecution': {
@@ -169,7 +172,8 @@ def test_pod_affinity(self):
         )
         k.execute(None)
 
-    def test_logging(self):
+    @staticmethod
+    def test_logging():
         with mock.patch.object(PodLauncher, 'log') as mock_logger:
             k = KubernetesPodOperator(
                 namespace='default',
@@ -184,7 +188,8 @@ def test_logging(self):
             k.execute(None)
             mock_logger.info.assert_any_call(b"+ echo 10\n")
 
-    def test_volume_mount(self):
+    @staticmethod
+    def test_volume_mount():
         with mock.patch.object(PodLauncher, 'log') as mock_logger:
             volume_mount = VolumeMount('test-volume',
                                        mount_path='/root/mount_file',
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index aea74a7abfc71..173752d722ecb 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -522,7 +522,8 @@ def test_cluster_name_log_sub(self):
 
 class DataProcHadoopOperatorTest(unittest.TestCase):
     # Unit test for the DataProcHadoopOperator
-    def test_hook_correct_region(self):
+    @staticmethod
+    def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHadoopOperator(
                 task_id=TASK_ID,
@@ -533,7 +534,8 @@ def test_hook_correct_region(self):
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
                                                                   REGION)
 
-    def test_dataproc_job_id_is_set(self):
+    @staticmethod
+    def test_dataproc_job_id_is_set():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHadoopOperator(
                 task_id=TASK_ID
@@ -544,7 +546,8 @@ def test_dataproc_job_id_is_set(self):
 
 class DataProcHiveOperatorTest(unittest.TestCase):
     # Unit test for the DataProcHiveOperator
-    def test_hook_correct_region(self):
+    @staticmethod
+    def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHiveOperator(
                 task_id=TASK_ID,
@@ -555,7 +558,8 @@ def test_hook_correct_region(self):
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
                                                                   REGION)
 
-    def test_dataproc_job_id_is_set(self):
+    @staticmethod
+    def test_dataproc_job_id_is_set():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHiveOperator(
                 task_id=TASK_ID
@@ -566,7 +570,8 @@ def test_dataproc_job_id_is_set(self):
 
 class DataProcPySparkOperatorTest(unittest.TestCase):
     # Unit test for the DataProcPySparkOperator
-    def test_hook_correct_region(self):
+    @staticmethod
+    def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcPySparkOperator(
                 task_id=TASK_ID,
@@ -578,7 +583,8 @@ def test_hook_correct_region(self):
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
                                                                   REGION)
 
-    def test_dataproc_job_id_is_set(self):
+    @staticmethod
+    def test_dataproc_job_id_is_set():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcPySparkOperator(
                 task_id=TASK_ID,
@@ -590,7 +596,8 @@ def test_dataproc_job_id_is_set(self):
 
 class DataProcSparkOperatorTest(unittest.TestCase):
     # Unit test for the DataProcSparkOperator
-    def test_hook_correct_region(self):
+    @staticmethod
+    def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcSparkOperator(
                 task_id=TASK_ID,
@@ -601,7 +608,8 @@ def test_hook_correct_region(self):
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
                                                                   REGION)
 
-    def test_dataproc_job_id_is_set(self):
+    @staticmethod
+    def test_dataproc_job_id_is_set():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcSparkOperator(
                 task_id=TASK_ID
diff --git a/tests/contrib/operators/test_hive_to_dynamodb_operator.py b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
index d1f75b50c40eb..e5b2c3e65a257 100644
--- a/tests/contrib/operators/test_hive_to_dynamodb_operator.py
+++ b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
@@ -52,7 +52,8 @@ def setUp(self):
         self.hook = AwsDynamoDBHook(
             aws_conn_id='aws_default', region_name='us-east-1')
 
-    def process_data(self, data, *args, **kwargs):
+    @staticmethod
+    def process_data(data, *args, **kwargs):
         return json.loads(data.to_json(orient='records'))
 
     @unittest.skipIf(mock_dynamodb2 is None, 'mock_dynamodb2 package not present')
diff --git a/tests/contrib/operators/test_mysql_to_gcs_operator.py b/tests/contrib/operators/test_mysql_to_gcs_operator.py
index 6e2e3f90dfb95..f0eb709500ca0 100644
--- a/tests/contrib/operators/test_mysql_to_gcs_operator.py
+++ b/tests/contrib/operators/test_mysql_to_gcs_operator.py
@@ -27,7 +27,8 @@
 
 class MySqlToGoogleCloudStorageOperatorTest(unittest.TestCase):
 
-    def test_write_local_data_files(self):
+    @staticmethod
+    def test_write_local_data_files():
 
         # Configure
         task_id = "some_test_id"
@@ -35,17 +36,15 @@ def test_write_local_data_files(self):
         bucket = "some_bucket"
         filename = "some_filename"
         row_iter = [[1, b'byte_str_1'], [2, b'byte_str_2']]
-        schema = []
-        schema.append({
+        schema = [{
             'name': 'location',
             'type': 'STRING',
             'mode': 'nullable',
-        })
-        schema.append({
+        }, {
             'name': 'uuid',
             'type': 'BYTES',
             'mode': 'nullable',
-        })
+        }]
         schema_str = json.dumps(schema)
 
         op = MySqlToGoogleCloudStorageOperator(
diff --git a/tests/contrib/operators/test_oracle_to_oracle_transfer.py b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
index 83d25e05a30f0..9c738dc8f76da 100644
--- a/tests/contrib/operators/test_oracle_to_oracle_transfer.py
+++ b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
@@ -34,7 +34,8 @@
 
 class OracleToOracleTransferTest(unittest.TestCase):
 
-    def test_execute(self):
+    @staticmethod
+    def test_execute():
         oracle_destination_conn_id = 'oracle_destination_conn_id'
         destination_table = 'destination_table'
         oracle_source_conn_id = 'oracle_source_conn_id'
diff --git a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
index 921b2dac1fae9..95064c2655ac0 100644
--- a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
+++ b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
@@ -35,7 +35,8 @@ class TestAwsRedshiftClusterSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
 
-    def _create_cluster(self):
+    @staticmethod
+    def _create_cluster():
         client = boto3.client('redshift', region_name='us-east-1')
         client.create_cluster(
             ClusterIdentifier='test_cluster',
diff --git a/tests/contrib/sensors/test_emr_base_sensor.py b/tests/contrib/sensors/test_emr_base_sensor.py
index 8d00db713fb2d..2215edd09e0f6 100644
--- a/tests/contrib/sensors/test_emr_base_sensor.py
+++ b/tests/contrib/sensors/test_emr_base_sensor.py
@@ -33,13 +33,15 @@ class EmrBaseSensorSubclass(EmrBaseSensor):
             NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE']
             FAILED_STATE = ['FAILED']
 
-            def get_emr_response(self):
+            @staticmethod
+            def get_emr_response():
                 return {
                     'SomeKey': {'State': 'COMPLETED'},
                     'ResponseMetadata': {'HTTPStatusCode': 200}
                 }
 
-            def state_from_response(self, response):
+            @staticmethod
+            def state_from_response(response):
                 return response['SomeKey']['State']
 
         operator = EmrBaseSensorSubclass(
@@ -56,13 +58,15 @@ class EmrBaseSensorSubclass(EmrBaseSensor):
             NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE']
             FAILED_STATE = ['FAILED']
 
-            def get_emr_response(self):
+            @staticmethod
+            def get_emr_response():
                 return {
                     'SomeKey': {'State': 'PENDING'},
                     'ResponseMetadata': {'HTTPStatusCode': 200}
                 }
 
-            def state_from_response(self, response):
+            @staticmethod
+            def state_from_response(response):
                 return response['SomeKey']['State']
 
         operator = EmrBaseSensorSubclass(
@@ -79,13 +83,15 @@ class EmrBaseSensorSubclass(EmrBaseSensor):
             NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE']
             FAILED_STATE = ['FAILED']
 
-            def get_emr_response(self):
+            @staticmethod
+            def get_emr_response():
                 return {
                     'SomeKey': {'State': 'COMPLETED'},
                     'ResponseMetadata': {'HTTPStatusCode': 400}
                 }
 
-            def state_from_response(self, response):
+            @staticmethod
+            def state_from_response(response):
                 return response['SomeKey']['State']
 
         operator = EmrBaseSensorSubclass(
@@ -102,13 +108,15 @@ class EmrBaseSensorSubclass(EmrBaseSensor):
             NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE']
             FAILED_STATE = ['FAILED']
 
-            def get_emr_response(self):
+            @staticmethod
+            def get_emr_response():
                 return {
                     'SomeKey': {'State': 'FAILED'},
                     'ResponseMetadata': {'HTTPStatusCode': 200}
                 }
 
-            def state_from_response(self, response):
+            @staticmethod
+            def state_from_response(response):
                 return response['SomeKey']['State']
 
         operator = EmrBaseSensorSubclass(
diff --git a/tests/core.py b/tests/core.py
index 60bfee69df7dd..156b5a9ec6244 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -2467,7 +2467,7 @@ def test_init_proxy_user(self):
 class HDFSHookTest(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
-        os.environ['AIRFLOW_CONN_HDFS_DEFAULT'] = ('hdfs://localhost:8020')
+        os.environ['AIRFLOW_CONN_HDFS_DEFAULT'] = 'hdfs://localhost:8020'
 
     def test_get_client(self):
         client = HDFSHook(proxy_user='foo').get_conn()
diff --git a/tests/models.py b/tests/models.py
index 9e09f76a43900..c6b6b5e075f2a 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -284,7 +284,7 @@ def test_dag_task_priority_weight_total(self):
                 match = pattern.match(task.task_id)
                 task_depth = int(match.group(1))
                 # the sum of each stages after this task + itself
-                correct_weight = ((task_depth) * width + 1) * weight
+                correct_weight = (task_depth * width + 1) * weight
 
                 calculated_weight = task.priority_weight_total
                 self.assertEquals(calculated_weight, correct_weight)
@@ -1398,7 +1398,7 @@ def process_dag(self, create_dag):
 
         dagbag = models.DagBag(include_examples=False)
         found_dags = dagbag.process_file(f.name)
-        return (dagbag, found_dags, f.name)
+        return dagbag, found_dags, f.name
 
     def validate_dags(self, expected_parent_dag, actual_found_dags, actual_dagbag,
                       should_be_found=True):
@@ -2814,7 +2814,7 @@ def test_xcom_enable_pickle_type(self):
     def test_xcom_disable_pickle_type_fail_on_non_json(self):
         class PickleRce(object):
             def __reduce__(self):
-                return (os.system, ("ls -alt",))
+                return os.system, ("ls -alt",)
 
         configuration.set("core", "xcom_enable_pickling", "False")
 
diff --git a/tests/operators/test_docker_operator.py b/tests/operators/test_docker_operator.py
index b9154456b9b31..ae076eb2e3a53 100644
--- a/tests/operators/test_docker_operator.py
+++ b/tests/operators/test_docker_operator.py
@@ -153,7 +153,8 @@ def test_execute_container_fails(self, client_class_mock):
         with self.assertRaises(AirflowException):
             operator.execute(None)
 
-    def test_on_kill(self):
+    @staticmethod
+    def test_on_kill():
         client_mock = mock.Mock(spec=APIClient)
 
         operator = DockerOperator(image='ubuntu', owner='unittest', task_id='unittest')
diff --git a/tests/operators/test_s3_to_hive_operator.py b/tests/operators/test_s3_to_hive_operator.py
index 2f8628c621abe..426566c40c7e5 100644
--- a/tests/operators/test_s3_to_hive_operator.py
+++ b/tests/operators/test_s3_to_hive_operator.py
@@ -145,15 +145,17 @@ def _get_fn(self, ext, header):
         key = self._get_key(ext, header)
         return self.fn[key]
 
-    def _get_key(self, ext, header):
+    @staticmethod
+    def _get_key(ext, header):
         key = ext + "_" + ('h' if header else 'nh')
         return key
 
-    def _check_file_equality(self, fn_1, fn_2, ext):
+    @staticmethod
+    def _check_file_equality(fn_1, fn_2, ext):
         # gz files contain mtime and filename in the header that
         # causes filecmp to return False even if contents are identical
         # Hence decompress to test for equality
-        if(ext.lower() == '.gz'):
+        if ext.lower() == '.gz':
             with gzip.GzipFile(fn_1, 'rb') as f_1,\
                     NamedTemporaryFile(mode='wb') as f_txt_1,\
                     gzip.GzipFile(fn_2, 'rb') as f_2,\
diff --git a/tests/operators/test_virtualenv_operator.py b/tests/operators/test_virtualenv_operator.py
index 82abe9c8098de..8196d636f4c1f 100644
--- a/tests/operators/test_virtualenv_operator.py
+++ b/tests/operators/test_virtualenv_operator.py
@@ -140,7 +140,8 @@ def f():
             raise Exception
         self._run_as_operator(f, python_version=3, use_dill=False, requirements=['dill'])
 
-    def _invert_python_major_version(self):
+    @staticmethod
+    def _invert_python_major_version():
         if sys.version_info[0] == 2:
             return 3
         else:
diff --git a/tests/www/api/experimental/test_kerberos_endpoints.py b/tests/www/api/experimental/test_kerberos_endpoints.py
index 9179cdecc027a..1cf30635fa407 100644
--- a/tests/www/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www/api/experimental/test_kerberos_endpoints.py
@@ -65,7 +65,7 @@ def test_trigger_dag(self):
 
             response.url = 'http://{}'.format(get_hostname())
 
-            class Request():
+            class Request:
                 headers = {}
 
             response.request = Request()
diff --git a/tests/www_rbac/api/experimental/test_kerberos_endpoints.py b/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
index 69a8117868f3e..54bbd865b3724 100644
--- a/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
@@ -64,7 +64,7 @@ def test_trigger_dag(self):
 
             response.url = 'http://{}'.format(socket.getfqdn())
 
-            class Request():
+            class Request(object):
                 headers = {}
 
             response.request = Request()

From 5f0b400f17a04b58784946986a899ee4ec307d62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Victor=20No=C3=ABl?= <victornoel@users.noreply.github.com>
Date: Fri, 16 Nov 2018 14:20:42 +0100
Subject: [PATCH 225/808] [AIRFLOW-3251] KubernetesPodOperator now uses
 'image_pull_secrets' argument when creating Pods (#4188)

---
 airflow/contrib/kubernetes/pod.py             |  4 ++++
 .../operators/kubernetes_pod_operator.py      |  7 ++++++
 .../minikube/test_kubernetes_pod_operator.py  | 23 +++++++++++++++++++
 3 files changed, 34 insertions(+)

diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 5de23ff5bdf81..bad5caa738e1b 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -54,6 +54,10 @@ class Pod:
     :type result: any
     :param image_pull_policy: Specify a policy to cache or always pull an image
     :type image_pull_policy: str
+    :param image_pull_secrets: Any image pull secrets to be given to the pod.
+                               If more than one secret is required, provide a
+                               comma separated list: secret_a,secret_b
+    :type image_pull_secrets: str
     :param affinity: A dict containing a group of affinity scheduling rules
     :type affinity: dict
     """
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 91e73e0c53df3..a29b61998d181 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -45,6 +45,12 @@ class KubernetesPodOperator(BaseOperator):
     :param arguments: arguments of to the entrypoint. (templated)
         The docker image's CMD is used if this is not provided.
     :type arguments: list of str
+    :param image_pull_policy: Specify a policy to cache or always pull an image
+    :type image_pull_policy: str
+    :param image_pull_secrets: Any image pull secrets to be given to the pod.
+                               If more than one secret is required, provide a
+                               comma separated list: secret_a,secret_b
+    :type image_pull_secrets: str
     :param volume_mounts: volumeMounts for launched pod
     :type volume_mounts: list of VolumeMount
     :param volumes: volumes for launched pod. Includes ConfigMaps and PersistentVolumes
@@ -108,6 +114,7 @@ def execute(self, context):
             pod.secrets = self.secrets
             pod.envs = self.env_vars
             pod.image_pull_policy = self.image_pull_policy
+            pod.image_pull_secrets = self.image_pull_secrets
             pod.annotations = self.annotations
             pod.resources = self.resources
             pod.affinity = self.affinity
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 595d7aa8b43e5..6ab69f31c6927 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -81,6 +81,29 @@ def test_config_path(self, client_mock, launcher_mock):
                                        cluster_context='default',
                                        config_file=file_path)
 
+    @mock.patch("airflow.contrib.kubernetes.pod_launcher.PodLauncher.run_pod")
+    @mock.patch("airflow.contrib.kubernetes.kube_client.get_kube_client")
+    def test_image_pull_secrets_correctly_set(self, client_mock, launcher_mock):
+        from airflow.utils.state import State
+
+        fake_pull_secrets = "fakeSecret"
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            image_pull_secrets=fake_pull_secrets,
+            in_cluster=False,
+            cluster_context='default'
+        )
+        launcher_mock.return_value = (State.SUCCESS, None)
+        k.execute(None)
+        self.assertEqual(launcher_mock.call_args[0][0].image_pull_secrets,
+                         fake_pull_secrets)
+
     @staticmethod
     def test_working_pod():
         k = KubernetesPodOperator(

From 0cc7178d3a1e7d47bdfe922b2cf0be6b8f415678 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 12 Nov 2018 12:02:39 -0500
Subject: [PATCH 226/808] [AIRFLOW-3306] Disable flask-sqlalchemy modification
 tracking. (#4146)

By default, flask-sqlalchemy tracks model changes for its event system, which
adds some overhead. Since I don't think we're using the flask-sqlalchemy
event system, we should be able to turn off modification tracking and improve
performance.
---
 airflow/www_rbac/app.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 82f1b37c7c423..55ce6856e656a 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -50,6 +50,7 @@ def create_app(config=None, testing=False, app_name="Airflow"):
     airflow_home_path = conf.get('core', 'AIRFLOW_HOME')
     webserver_config_path = airflow_home_path + '/webserver_config.py'
     app.config.from_pyfile(webserver_config_path, silent=True)
+    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
     app.config['APP_NAME'] = app_name
     app.config['TESTING'] = testing
 

From 8ddaf0874c3ef5abf7f5c8f610fdd633876865fd Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Thu, 15 Nov 2018 20:36:11 +0300
Subject: [PATCH 227/808] [AIRFLOW-3353] Pin redis verison (#4195)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index a76d768c2284d..05c85c4f674fd 100644
--- a/setup.py
+++ b/setup.py
@@ -200,7 +200,7 @@ def write_version(filename=os.path.join(*['airflow',
 postgres = ['psycopg2-binary>=2.7.4']
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']
-redis = ['redis>=2.10.5']
+redis = ['redis>=2.10.5,<3.0.0']
 s3 = ['boto3>=1.7.0, <1.8.0']
 salesforce = ['simple-salesforce>=0.72']
 samba = ['pysmbclient>=0.1.3']

From ed4fa75014005bf05b987f97567c332a0ecaa2c0 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 6 Nov 2018 18:54:18 +0800
Subject: [PATCH 228/808] [AIRFLOW-3301] Update DockerOperator CI test for PR
 #3977 (#4138)

---
 tests/operators/test_docker_operator.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/operators/test_docker_operator.py b/tests/operators/test_docker_operator.py
index ae076eb2e3a53..23577d7a2830f 100644
--- a/tests/operators/test_docker_operator.py
+++ b/tests/operators/test_docker_operator.py
@@ -80,6 +80,7 @@ def test_execute(self, client_class_mock, mkdtemp_mock):
                                                           shm_size=1000,
                                                           cpu_shares=1024,
                                                           mem_limit=None,
+                                                          auto_remove=False,
                                                           dns=None,
                                                           dns_search=None)
         client_mock.images.assert_called_with(name='ubuntu:latest')

From d584ede109688c45a9e6f48f09b8e6e946966d20 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Fri, 30 Nov 2018 22:52:29 +0000
Subject: [PATCH 229/808] Fix flake8 issues

---
 airflow/jobs.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 7a45056905523..4daafc22ada18 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -428,7 +428,7 @@ def start(self):
     def terminate(self, sigkill=False):
         """
         Terminate (and then kill) the process launched to process the file.
-        
+
         :param sigkill: whether to issue a SIGKILL if SIGTERM doesn't work.
         :type sigkill: bool
         """
@@ -457,7 +457,7 @@ def pid(self):
     def exit_code(self):
         """
         After the process is finished, this can be called to get the return code
-        
+
         :return: the exit code of the process
         :rtype: int
         """
@@ -469,7 +469,7 @@ def exit_code(self):
     def done(self):
         """
         Check if the process launched to process this file is done.
-        
+
         :return: whether the process is finished running
         :rtype: bool
         """
@@ -1899,7 +1899,7 @@ def _update_counters(self, ti_status):
         """
         Updates the counters per state of the tasks that were running. Can re-add
         to tasks to run in case required.
-        
+
         :param ti_status: the internal status of the backfill job tasks
         :type ti_status: BackfillJob._DagRunTaskStatus
         """
@@ -1944,7 +1944,7 @@ def _manage_executor_state(self, running):
         """
         Checks if the executor agrees with the state of task instances
         that are running
-        
+
         :param running: dict of key, task to verify
         """
         executor = self.executor
@@ -1976,7 +1976,7 @@ def _get_dag_run(self, run_date, session=None):
         Returns a dag run for the given run date, which will be matched to an existing
         dag run if available or create a new dag run otherwise. If the max_active_runs
         limit is reached, this function will return None.
-        
+
         :param run_date: the execution date for the dag run
         :type run_date: datetime
         :param session: the database session object
@@ -2036,7 +2036,7 @@ def _task_instances_for_dag_run(self, dag_run, session=None):
         """
         Returns a map of task instance key to task instance object for the tasks to
         run in the given dag run.
-        
+
         :param dag_run: the dag run to get the tasks from
         :type dag_run: models.DagRun
         :param session: the database session object
@@ -2102,7 +2102,7 @@ def _process_backfill_task_instances(self,
         Process a set of task instances from a set of dag runs. Special handling is done
         to account for different task instance states that could be present when running
         them in a backfill process.
-        
+
         :param ti_status: the internal status of the job
         :type ti_status: BackfillJob._DagRunTaskStatus
         :param executor: the executor to run the task instances
@@ -2340,7 +2340,7 @@ def _execute_for_run_dates(self, run_dates, ti_status, executor, pickle_id,
         Computes the dag runs and their respective task instances for
         the given run dates and executes the task instances.
         Returns a list of execution dates of the dag runs that were executed.
-        
+
         :param run_dates: Execution dates for dag runs
         :type run_dates: list
         :param ti_status: internal BackfillJob status structure to tis track progress

From 8e26b75e1660d7d75b1c9279c6433cfa6e4b536a Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Sun, 22 Jul 2018 09:23:57 +0200
Subject: [PATCH 230/808] [AIRFLOW-2691] Manage JS dependencies via npm

---
 .gitignore                                    |     8 +
 CONTRIBUTING.md                               |    57 +
 MANIFEST.in                                   |     6 +-
 airflow/www_rbac/app.py                       |     3 +-
 airflow/www_rbac/compile_assets.sh            |    23 +
 airflow/www_rbac/package-lock.json            | 12408 ++++++++++++++
 airflow/www_rbac/package.json                 |    55 +
 .../www_rbac/static/bootstrap-toggle.min.css  |    28 -
 .../www_rbac/static/bootstrap-toggle.min.js   |     9 -
 .../static/bootstrap3-typeahead.min.js        |    26 -
 airflow/www_rbac/static/connection_form.js    |    78 -
 .../static/{ => css}/bootstrap-theme.css      |     0
 airflow/www_rbac/static/{ => css}/gantt.css   |     0
 airflow/www_rbac/static/{ => css}/graph.css   |    20 +
 airflow/www_rbac/static/{ => css}/main.css    |     6 +-
 airflow/www_rbac/static/{ => css}/tree.css    |     0
 airflow/www_rbac/static/d3.tip.v0.6.3.js      |   302 -
 airflow/www_rbac/static/d3.v3.min.js          |     5 -
 airflow/www_rbac/static/dagre-d3.min.js       |     2 -
 airflow/www_rbac/static/dagre.css             |    38 -
 .../www_rbac/static/dataTables.bootstrap.css  |   333 -
 airflow/www_rbac/static/jquery.dataTables.css |   495 -
 .../www_rbac/static/jquery.dataTables.min.js  |   189 -
 airflow/www_rbac/static/js/clock.js           |    41 +
 airflow/www_rbac/static/js/connection_form.js |    80 +
 airflow/www_rbac/static/{ => js}/dagre-d3.js  |     0
 .../static/{ => js}/gantt-chart-d3v2.js       |     0
 .../www_rbac/static/{ => js}/jqClock.min.js   |     0
 airflow/www_rbac/static/nv.d3.css             |   788 -
 airflow/www_rbac/static/nv.d3.js              | 14260 ----------------
 airflow/www_rbac/static_config.py             |    63 +
 airflow/www_rbac/templates/airflow/chart.html |    11 +-
 .../www_rbac/templates/airflow/circles.html   |     8 +-
 .../templates/airflow/conn_create.html        |     8 +-
 .../www_rbac/templates/airflow/conn_edit.html |     8 +-
 airflow/www_rbac/templates/airflow/dag.html   |    23 +-
 airflow/www_rbac/templates/airflow/dags.html  |    17 +-
 .../templates/airflow/duration_chart.html     |    11 +-
 airflow/www_rbac/templates/airflow/gantt.html |    10 +-
 airflow/www_rbac/templates/airflow/graph.html |    10 +-
 airflow/www_rbac/templates/airflow/tree.html  |     7 +-
 .../templates/appbuilder/baselayout.html      |    35 +-
 airflow/www_rbac/webpack.config.js            |   128 +
 dev/README.md                                 |    15 +-
 setup.py                                      |    19 +
 45 files changed, 12990 insertions(+), 16643 deletions(-)
 create mode 100755 airflow/www_rbac/compile_assets.sh
 create mode 100644 airflow/www_rbac/package-lock.json
 create mode 100644 airflow/www_rbac/package.json
 delete mode 100644 airflow/www_rbac/static/bootstrap-toggle.min.css
 delete mode 100644 airflow/www_rbac/static/bootstrap-toggle.min.js
 delete mode 100644 airflow/www_rbac/static/bootstrap3-typeahead.min.js
 delete mode 100644 airflow/www_rbac/static/connection_form.js
 rename airflow/www_rbac/static/{ => css}/bootstrap-theme.css (100%)
 rename airflow/www_rbac/static/{ => css}/gantt.css (100%)
 rename airflow/www_rbac/static/{ => css}/graph.css (87%)
 rename airflow/www_rbac/static/{ => css}/main.css (97%)
 rename airflow/www_rbac/static/{ => css}/tree.css (100%)
 delete mode 100644 airflow/www_rbac/static/d3.tip.v0.6.3.js
 delete mode 100644 airflow/www_rbac/static/d3.v3.min.js
 delete mode 100644 airflow/www_rbac/static/dagre-d3.min.js
 delete mode 100644 airflow/www_rbac/static/dagre.css
 delete mode 100644 airflow/www_rbac/static/dataTables.bootstrap.css
 delete mode 100644 airflow/www_rbac/static/jquery.dataTables.css
 delete mode 100644 airflow/www_rbac/static/jquery.dataTables.min.js
 create mode 100644 airflow/www_rbac/static/js/clock.js
 create mode 100644 airflow/www_rbac/static/js/connection_form.js
 rename airflow/www_rbac/static/{ => js}/dagre-d3.js (100%)
 rename airflow/www_rbac/static/{ => js}/gantt-chart-d3v2.js (100%)
 rename airflow/www_rbac/static/{ => js}/jqClock.min.js (100%)
 delete mode 100644 airflow/www_rbac/static/nv.d3.css
 delete mode 100644 airflow/www_rbac/static/nv.d3.js
 create mode 100644 airflow/www_rbac/static_config.py
 create mode 100644 airflow/www_rbac/webpack.config.js

diff --git a/.gitignore b/.gitignore
index 5712aee6c549a..114236d467885 100644
--- a/.gitignore
+++ b/.gitignore
@@ -139,6 +139,14 @@ rat-results.txt
 *.tar.gz
 scripts/ci/kubernetes/kube/.generated/airflow.yaml
 
+# Node & Webpack Stuff
+*.entry.js
+node_modules
+npm-debug.log*
+static/dist
+derby.log
+metastore_db
+
 # Airflow log files when airflow is run locally
 airflow-*.err
 airflow-*.out
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 194aaa7b277ca..481ded4e4ee58 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -258,3 +258,60 @@ $ alembic revision -m "add new field to db"
   Generating
 ~/airflow/airflow/migrations/versions/12341123_add_new_field_to_db.py
 ```
+
+## Setting up the node / npm javascript environment (ONLY FOR www_rbac)
+
+`airflow/www_rbac/` contains all npm-managed, front end assets.
+Flask-Appbuilder itself comes bundled with jQuery and bootstrap.
+While these may be phased out over time, these packages are currently not
+managed with npm.
+
+### Node/npm versions
+Make sure you are using recent versions of node and npm. No problems have been found with node>=8.11.3 and npm>=6.1.3
+
+### Using npm to generate bundled files
+
+#### npm
+First, npm must be available in your environment. If it is not you can run the following commands
+(taken from [this source](https://gist.github.com/DanHerbert/9520689))
+```
+brew install node --without-npm
+echo prefix=~/.npm-packages >> ~/.npmrc
+curl -L https://www.npmjs.com/install.sh | sh
+```
+
+The final step is to add `~/.npm-packages/bin` to your `PATH` so commands you install globally are usable.
+Add something like this to your `.bashrc` file, then `source ~/.bashrc` to reflect the change.
+```
+export PATH="$HOME/.npm-packages/bin:$PATH"
+```
+
+#### npm packages
+To install third party libraries defined in `package.json`, run the
+following within the `airflow/www_rbac/` directory which will install them in a
+new `node_modules/` folder within `www_rbac/`.
+
+```bash
+# from the root of the repository, move to where our JS package.json lives
+cd airflow/www_rbac/
+# run npm install to fetch all the dependencies
+npm install
+```
+
+To parse and generate bundled files for airflow, run either of the
+following commands. The `dev` flag will keep the npm script running and
+re-run it upon any changes within the assets directory.
+
+```
+# Compiles the production / optimized js & css
+npm run prod
+
+# Start a web server that manages and updates your assets as you modify them
+npm run dev
+```
+
+#### Upgrading npm packages
+
+Should you add or upgrade a npm package, which involves changing `package.json`, you'll need to re-run `npm install` 
+and push the newly generated `package-lock.json` file so we get the reproducible build.
+
diff --git a/MANIFEST.in b/MANIFEST.in
index b069194984511..ec99c1f6b2b1e 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -24,6 +24,7 @@ include README.md
 graft licenses/
 graft airflow/www/templates
 graft airflow/www/static
+graft airflow/www_rbac
 graft airflow/www_rbac/static
 graft airflow/www_rbac/templates
 graft airflow/www_rbac/translations
@@ -31,3 +32,4 @@ include airflow/alembic.ini
 graft scripts/systemd
 graft scripts/upstart
 graft airflow/config_templates
+recursive-exclude airflow/www_rbac/node_modules *
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 55ce6856e656a..7a2b18418cd1c 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -32,7 +32,7 @@
 from airflow import settings
 from airflow import configuration as conf
 from airflow.logging_config import configure_logging
-
+from airflow.www_rbac.static_config import configure_manifest_files
 
 app = None
 appbuilder = None
@@ -68,6 +68,7 @@ def create_app(config=None, testing=False, app_name="Airflow"):
     app.register_blueprint(routes)
 
     configure_logging()
+    configure_manifest_files(app)
 
     with app.app_context():
         appbuilder = AppBuilder(
diff --git a/airflow/www_rbac/compile_assets.sh b/airflow/www_rbac/compile_assets.sh
new file mode 100755
index 0000000000000..2c115a44a528f
--- /dev/null
+++ b/airflow/www_rbac/compile_assets.sh
@@ -0,0 +1,23 @@
+#!/bin/sh
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# first bump up package.json manually, commit and tag
+rm airflow/www_rbac/static/dist/*
+cd airflow/www_rbac/
+npm install
+npm run build
+cd ../..
diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
new file mode 100644
index 0000000000000..90d94cd0054f6
--- /dev/null
+++ b/airflow/www_rbac/package-lock.json
@@ -0,0 +1,12408 @@
+{
+  "requires": true,
+  "lockfileVersion": 1,
+  "dependencies": {
+    "@webassemblyjs/ast": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.5.13.tgz",
+      "integrity": "sha512-49nwvW/Hx9i+OYHg+mRhKZfAlqThr11Dqz8TsrvqGKMhdI2ijy3KBJOun2Z4770TPjrIJhR6KxChQIDaz8clDA==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/helper-module-context": "1.5.13",
+        "@webassemblyjs/helper-wasm-bytecode": "1.5.13",
+        "@webassemblyjs/wast-parser": "1.5.13",
+        "debug": "^3.1.0",
+        "mamacro": "^0.0.3"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/floating-point-hex-parser": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.5.13.tgz",
+      "integrity": "sha512-vrvvB18Kh4uyghSKb0NTv+2WZx871WL2NzwMj61jcq2bXkyhRC+8Q0oD7JGVf0+5i/fKQYQSBCNMMsDMRVAMqA==",
+      "dev": true
+    },
+    "@webassemblyjs/helper-api-error": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.5.13.tgz",
+      "integrity": "sha512-dBh2CWYqjaDlvMmRP/kudxpdh30uXjIbpkLj9HQe+qtYlwvYjPRjdQXrq1cTAAOUSMTtzqbXIxEdEZmyKfcwsg==",
+      "dev": true
+    },
+    "@webassemblyjs/helper-buffer": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.5.13.tgz",
+      "integrity": "sha512-v7igWf1mHcpJNbn4m7e77XOAWXCDT76Xe7Is1VQFXc4K5jRcFrl9D0NrqM4XifQ0bXiuTSkTKMYqDxu5MhNljA==",
+      "dev": true,
+      "requires": {
+        "debug": "^3.1.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/helper-code-frame": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-code-frame/-/helper-code-frame-1.5.13.tgz",
+      "integrity": "sha512-yN6ScQQDFCiAXnVctdVO/J5NQRbwyTbQzsGzEgXsAnrxhjp0xihh+nNHQTMrq5UhOqTb5LykpJAvEv9AT0jnAQ==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/wast-printer": "1.5.13"
+      }
+    },
+    "@webassemblyjs/helper-fsm": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-fsm/-/helper-fsm-1.5.13.tgz",
+      "integrity": "sha512-hSIKzbXjVMRvy3Jzhgu+vDd/aswJ+UMEnLRCkZDdknZO3Z9e6rp1DAs0tdLItjCFqkz9+0BeOPK/mk3eYvVzZg==",
+      "dev": true
+    },
+    "@webassemblyjs/helper-module-context": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-module-context/-/helper-module-context-1.5.13.tgz",
+      "integrity": "sha512-zxJXULGPLB7r+k+wIlvGlXpT4CYppRz8fLUM/xobGHc9Z3T6qlmJD9ySJ2jknuktuuiR9AjnNpKYDECyaiX+QQ==",
+      "dev": true,
+      "requires": {
+        "debug": "^3.1.0",
+        "mamacro": "^0.0.3"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/helper-wasm-bytecode": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.5.13.tgz",
+      "integrity": "sha512-0n3SoNGLvbJIZPhtMFq0XmmnA/YmQBXaZKQZcW8maGKwLpVcgjNrxpFZHEOLKjXJYVN5Il8vSfG7nRX50Zn+aw==",
+      "dev": true
+    },
+    "@webassemblyjs/helper-wasm-section": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.5.13.tgz",
+      "integrity": "sha512-IJ/goicOZ5TT1axZFSnlAtz4m8KEjYr12BNOANAwGFPKXM4byEDaMNXYowHMG0yKV9a397eU/NlibFaLwr1fbw==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-buffer": "1.5.13",
+        "@webassemblyjs/helper-wasm-bytecode": "1.5.13",
+        "@webassemblyjs/wasm-gen": "1.5.13",
+        "debug": "^3.1.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/ieee754": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.5.13.tgz",
+      "integrity": "sha512-TseswvXEPpG5TCBKoLx9tT7+/GMACjC1ruo09j46ULRZWYm8XHpDWaosOjTnI7kr4SRJFzA6MWoUkAB+YCGKKg==",
+      "dev": true,
+      "requires": {
+        "ieee754": "^1.1.11"
+      }
+    },
+    "@webassemblyjs/leb128": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.5.13.tgz",
+      "integrity": "sha512-0NRMxrL+GG3eISGZBmLBLAVjphbN8Si15s7jzThaw1UE9e5BY1oH49/+MA1xBzxpf1OW5sf9OrPDOclk9wj2yg==",
+      "dev": true,
+      "requires": {
+        "long": "4.0.0"
+      },
+      "dependencies": {
+        "long": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/long/-/long-4.0.0.tgz",
+          "integrity": "sha512-XsP+KhQif4bjX1kbuSiySJFNAehNxgLb6hPRGJ9QsUr8ajHkuXGdrHmFUTUUXhDwVX2R5bY4JNZEwbUiMhV+MA==",
+          "dev": true
+        }
+      }
+    },
+    "@webassemblyjs/utf8": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.5.13.tgz",
+      "integrity": "sha512-Ve1ilU2N48Ew0lVGB8FqY7V7hXjaC4+PeZM+vDYxEd+R2iQ0q+Wb3Rw8v0Ri0+rxhoz6gVGsnQNb4FjRiEH/Ng==",
+      "dev": true
+    },
+    "@webassemblyjs/wasm-edit": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.5.13.tgz",
+      "integrity": "sha512-X7ZNW4+Hga4f2NmqENnHke2V/mGYK/xnybJSIXImt1ulxbCOEs/A+ZK/Km2jgihjyVxp/0z0hwIcxC6PrkWtgw==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-buffer": "1.5.13",
+        "@webassemblyjs/helper-wasm-bytecode": "1.5.13",
+        "@webassemblyjs/helper-wasm-section": "1.5.13",
+        "@webassemblyjs/wasm-gen": "1.5.13",
+        "@webassemblyjs/wasm-opt": "1.5.13",
+        "@webassemblyjs/wasm-parser": "1.5.13",
+        "@webassemblyjs/wast-printer": "1.5.13",
+        "debug": "^3.1.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/wasm-gen": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.5.13.tgz",
+      "integrity": "sha512-yfv94Se8R73zmr8GAYzezFHc3lDwE/lBXQddSiIZEKZFuqy7yWtm3KMwA1uGbv5G1WphimJxboXHR80IgX1hQA==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-wasm-bytecode": "1.5.13",
+        "@webassemblyjs/ieee754": "1.5.13",
+        "@webassemblyjs/leb128": "1.5.13",
+        "@webassemblyjs/utf8": "1.5.13"
+      }
+    },
+    "@webassemblyjs/wasm-opt": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.5.13.tgz",
+      "integrity": "sha512-IkXSkgzVhQ0QYAdIayuCWMmXSYx0dHGU8Ah/AxJf1gBvstMWVnzJnBwLsXLyD87VSBIcsqkmZ28dVb0mOC3oBg==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-buffer": "1.5.13",
+        "@webassemblyjs/wasm-gen": "1.5.13",
+        "@webassemblyjs/wasm-parser": "1.5.13",
+        "debug": "^3.1.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        }
+      }
+    },
+    "@webassemblyjs/wasm-parser": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.5.13.tgz",
+      "integrity": "sha512-XnYoIcu2iqq8/LrtmdnN3T+bRjqYFjRHqWbqK3osD/0r/Fcv4d9ecRzjVtC29ENEuNTK4mQ9yyxCBCbK8S/cpg==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-api-error": "1.5.13",
+        "@webassemblyjs/helper-wasm-bytecode": "1.5.13",
+        "@webassemblyjs/ieee754": "1.5.13",
+        "@webassemblyjs/leb128": "1.5.13",
+        "@webassemblyjs/utf8": "1.5.13"
+      }
+    },
+    "@webassemblyjs/wast-parser": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-parser/-/wast-parser-1.5.13.tgz",
+      "integrity": "sha512-Lbz65T0LQ1LgzKiUytl34CwuhMNhaCLgrh0JW4rJBN6INnBB8NMwUfQM+FxTnLY9qJ+lHJL/gCM5xYhB9oWi4A==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/floating-point-hex-parser": "1.5.13",
+        "@webassemblyjs/helper-api-error": "1.5.13",
+        "@webassemblyjs/helper-code-frame": "1.5.13",
+        "@webassemblyjs/helper-fsm": "1.5.13",
+        "long": "^3.2.0",
+        "mamacro": "^0.0.3"
+      }
+    },
+    "@webassemblyjs/wast-printer": {
+      "version": "1.5.13",
+      "resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.5.13.tgz",
+      "integrity": "sha512-QcwogrdqcBh8Z+eUF8SG+ag5iwQSXxQJELBEHmLkk790wgQgnIMmntT2sMAMw53GiFNckArf5X0bsCA44j3lWQ==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/wast-parser": "1.5.13",
+        "long": "^3.2.0"
+      }
+    },
+    "@webpack-contrib/schema-utils": {
+      "version": "1.0.0-beta.0",
+      "resolved": "https://registry.npmjs.org/@webpack-contrib/schema-utils/-/schema-utils-1.0.0-beta.0.tgz",
+      "integrity": "sha512-LonryJP+FxQQHsjGBi6W786TQB1Oym+agTpY0c+Kj8alnIw+DLUJb6SI8Y1GHGhLCH1yPRrucjObUmxNICQ1pg==",
+      "dev": true,
+      "requires": {
+        "ajv": "^6.1.0",
+        "ajv-keywords": "^3.1.0",
+        "chalk": "^2.3.2",
+        "strip-ansi": "^4.0.0",
+        "text-table": "^0.2.0",
+        "webpack-log": "^1.1.2"
+      },
+      "dependencies": {
+        "ansi-regex": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz",
+          "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=",
+          "dev": true
+        },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
+          "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          }
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "abbrev": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.0.9.tgz",
+      "integrity": "sha1-kbR5JYinc4wl813W9jdSovh3YTU=",
+      "dev": true
+    },
+    "acorn": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-5.7.1.tgz",
+      "integrity": "sha512-d+nbxBUGKg7Arpsvbnlq61mc12ek3EY8EQldM3GPAhWJ1UVxC6TDGbIvUMNU6obBX3i1+ptCIzV4vq0gFPEGVQ==",
+      "dev": true
+    },
+    "acorn-dynamic-import": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/acorn-dynamic-import/-/acorn-dynamic-import-3.0.0.tgz",
+      "integrity": "sha512-zVWV8Z8lislJoOKKqdNMOB+s6+XV5WERty8MnKBeFgwA+19XJjJHs2RP5dzM57FftIs+jQnRToLiWazKr6sSWg==",
+      "dev": true,
+      "requires": {
+        "acorn": "^5.0.0"
+      }
+    },
+    "ajv": {
+      "version": "6.5.2",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.5.2.tgz",
+      "integrity": "sha512-hOs7GfvI6tUI1LfZddH82ky6mOMyTuY0mk7kE2pWpmhhUSkumzaTO5vbVwij39MdwPQWCV4Zv57Eo06NtL/GVA==",
+      "dev": true,
+      "requires": {
+        "fast-deep-equal": "^2.0.1",
+        "fast-json-stable-stringify": "^2.0.0",
+        "json-schema-traverse": "^0.4.1",
+        "uri-js": "^4.2.1"
+      }
+    },
+    "ajv-keywords": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-3.2.0.tgz",
+      "integrity": "sha1-6GuBnGAs+IIa1jdBNpjx3sAhhHo=",
+      "dev": true
+    },
+    "align-text": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/align-text/-/align-text-0.1.4.tgz",
+      "integrity": "sha1-DNkKVhCT810KmSVsIrcGlDP60Rc=",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.0.2",
+        "longest": "^1.0.1",
+        "repeat-string": "^1.5.2"
+      }
+    },
+    "alphanum-sort": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/alphanum-sort/-/alphanum-sort-1.0.2.tgz",
+      "integrity": "sha1-l6ERlkmyEa0zaR2fn0hqjsn74KM=",
+      "dev": true
+    },
+    "amdefine": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/amdefine/-/amdefine-1.0.1.tgz",
+      "integrity": "sha1-SlKCrBZHKek2Gbz9OtFR+BfOkfU=",
+      "dev": true
+    },
+    "ansi-escapes": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-3.1.0.tgz",
+      "integrity": "sha512-UgAb8H9D41AQnu/PbWlCofQVcnV4Gs2bBJi9eZPxfU/hgglFh3SMDMENRIqdr7H6XFnXdoknctFByVsCOotTVw==",
+      "dev": true
+    },
+    "ansi-regex": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-2.1.1.tgz",
+      "integrity": "sha1-w7M6te42DYbg5ijwRorn7yfWVN8=",
+      "dev": true
+    },
+    "ansi-styles": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz",
+      "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=",
+      "dev": true
+    },
+    "anymatch": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-2.0.0.tgz",
+      "integrity": "sha512-5teOsQWABXHHBFP9y3skS5P3d/WfWXpv3FUpy+LorMrNYaT9pI4oLMQX7jzQ2KklNpGpWHzdCXTDT2Y3XGlZBw==",
+      "dev": true,
+      "requires": {
+        "micromatch": "^3.1.4",
+        "normalize-path": "^2.1.1"
+      }
+    },
+    "aproba": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/aproba/-/aproba-1.2.0.tgz",
+      "integrity": "sha512-Y9J6ZjXtoYh8RnXVCMOU/ttDmk1aBjunq9vO0ta5x85WDQiQfUF9sIPBITdbiiIVcBo03Hi3jMxigBtsddlXRw==",
+      "dev": true
+    },
+    "argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "dev": true,
+      "requires": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "arr-diff": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/arr-diff/-/arr-diff-4.0.0.tgz",
+      "integrity": "sha1-1kYQdP6/7HHn4VI1dhoyml3HxSA=",
+      "dev": true
+    },
+    "arr-flatten": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz",
+      "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg==",
+      "dev": true
+    },
+    "arr-union": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/arr-union/-/arr-union-3.1.0.tgz",
+      "integrity": "sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ=",
+      "dev": true
+    },
+    "array-union": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/array-union/-/array-union-1.0.2.tgz",
+      "integrity": "sha1-mjRBDk9OPaI96jdb5b5w8kd47Dk=",
+      "dev": true,
+      "requires": {
+        "array-uniq": "^1.0.1"
+      }
+    },
+    "array-uniq": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/array-uniq/-/array-uniq-1.0.3.tgz",
+      "integrity": "sha1-r2rId6Jcx/dOBYiUdThY39sk/bY=",
+      "dev": true
+    },
+    "array-unique": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/array-unique/-/array-unique-0.3.2.tgz",
+      "integrity": "sha1-qJS3XUvE9s1nnvMkSp/Y9Gri1Cg=",
+      "dev": true
+    },
+    "arrify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz",
+      "integrity": "sha1-iYUI2iIm84DfkEcoRWhJwVAaSw0=",
+      "dev": true
+    },
+    "asn1.js": {
+      "version": "4.10.1",
+      "resolved": "https://registry.npmjs.org/asn1.js/-/asn1.js-4.10.1.tgz",
+      "integrity": "sha512-p32cOF5q0Zqs9uBiONKYLm6BClCoBCM5O9JfeUSlnQLBTxYdTK+pW+nXflm8UkKd2UYlEbYz5qEi0JuZR9ckSw==",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.0.0",
+        "inherits": "^2.0.1",
+        "minimalistic-assert": "^1.0.0"
+      }
+    },
+    "assert": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/assert/-/assert-1.4.1.tgz",
+      "integrity": "sha1-mZEtWRg2tab1s0XA8H7vwI/GXZE=",
+      "dev": true,
+      "requires": {
+        "util": "0.10.3"
+      },
+      "dependencies": {
+        "inherits": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.1.tgz",
+          "integrity": "sha1-sX0I0ya0Qj5Wjv9xn5GwscvfafE=",
+          "dev": true
+        },
+        "util": {
+          "version": "0.10.3",
+          "resolved": "https://registry.npmjs.org/util/-/util-0.10.3.tgz",
+          "integrity": "sha1-evsa/lCAUkZInj23/g7TeTNqwPk=",
+          "dev": true,
+          "requires": {
+            "inherits": "2.0.1"
+          }
+        }
+      }
+    },
+    "assign-symbols": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/assign-symbols/-/assign-symbols-1.0.0.tgz",
+      "integrity": "sha1-WWZ/QfrdTyDMvCu5a41Pf3jsA2c=",
+      "dev": true
+    },
+    "async": {
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+      "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo=",
+      "dev": true
+    },
+    "async-each": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/async-each/-/async-each-1.0.1.tgz",
+      "integrity": "sha1-GdOGodntxufByF04iu28xW0zYC0=",
+      "dev": true
+    },
+    "atob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.1.tgz",
+      "integrity": "sha1-ri1acpR38onWDdf5amMUoi3Wwio=",
+      "dev": true
+    },
+    "autoprefixer": {
+      "version": "6.7.7",
+      "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-6.7.7.tgz",
+      "integrity": "sha1-Hb0cg1ZY41zj+ZhAmdsAWFx4IBQ=",
+      "dev": true,
+      "requires": {
+        "browserslist": "^1.7.6",
+        "caniuse-db": "^1.0.30000634",
+        "normalize-range": "^0.1.2",
+        "num2fraction": "^1.2.2",
+        "postcss": "^5.2.16",
+        "postcss-value-parser": "^3.2.3"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "babel": {
+      "version": "6.23.0",
+      "resolved": "https://registry.npmjs.org/babel/-/babel-6.23.0.tgz",
+      "integrity": "sha1-0NHn2APpdHZb7qMjLU4VPA77kPQ=",
+      "dev": true
+    },
+    "babel-code-frame": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-code-frame/-/babel-code-frame-6.26.0.tgz",
+      "integrity": "sha1-Y/1D99weO7fONZR9uP42mj9Yx0s=",
+      "dev": true,
+      "requires": {
+        "chalk": "^1.1.3",
+        "esutils": "^2.0.2",
+        "js-tokens": "^3.0.2"
+      }
+    },
+    "babel-core": {
+      "version": "6.26.3",
+      "resolved": "https://registry.npmjs.org/babel-core/-/babel-core-6.26.3.tgz",
+      "integrity": "sha512-6jyFLuDmeidKmUEb3NM+/yawG0M2bDZ9Z1qbZP59cyHLz8kYGKYwpJP0UwUKKUiTRNvxfLesJnTedqczP7cTDA==",
+      "dev": true,
+      "requires": {
+        "babel-code-frame": "^6.26.0",
+        "babel-generator": "^6.26.0",
+        "babel-helpers": "^6.24.1",
+        "babel-messages": "^6.23.0",
+        "babel-register": "^6.26.0",
+        "babel-runtime": "^6.26.0",
+        "babel-template": "^6.26.0",
+        "babel-traverse": "^6.26.0",
+        "babel-types": "^6.26.0",
+        "babylon": "^6.18.0",
+        "convert-source-map": "^1.5.1",
+        "debug": "^2.6.9",
+        "json5": "^0.5.1",
+        "lodash": "^4.17.4",
+        "minimatch": "^3.0.4",
+        "path-is-absolute": "^1.0.1",
+        "private": "^0.1.8",
+        "slash": "^1.0.0",
+        "source-map": "^0.5.7"
+      }
+    },
+    "babel-generator": {
+      "version": "6.26.1",
+      "resolved": "https://registry.npmjs.org/babel-generator/-/babel-generator-6.26.1.tgz",
+      "integrity": "sha512-HyfwY6ApZj7BYTcJURpM5tznulaBvyio7/0d4zFOeMPUmfxkCjHocCuoLa2SAGzBI8AREcH3eP3758F672DppA==",
+      "dev": true,
+      "requires": {
+        "babel-messages": "^6.23.0",
+        "babel-runtime": "^6.26.0",
+        "babel-types": "^6.26.0",
+        "detect-indent": "^4.0.0",
+        "jsesc": "^1.3.0",
+        "lodash": "^4.17.4",
+        "source-map": "^0.5.7",
+        "trim-right": "^1.0.1"
+      }
+    },
+    "babel-helpers": {
+      "version": "6.24.1",
+      "resolved": "https://registry.npmjs.org/babel-helpers/-/babel-helpers-6.24.1.tgz",
+      "integrity": "sha1-NHHenK7DiOXIUOWX5Yom3fN2ArI=",
+      "dev": true,
+      "requires": {
+        "babel-runtime": "^6.22.0",
+        "babel-template": "^6.24.1"
+      }
+    },
+    "babel-istanbul": {
+      "version": "0.12.2",
+      "resolved": "https://registry.npmjs.org/babel-istanbul/-/babel-istanbul-0.12.2.tgz",
+      "integrity": "sha1-5yPwfJokMtiAVVILwi519cI5Fhw=",
+      "dev": true,
+      "requires": {
+        "abbrev": "1.0.x",
+        "async": "1.x",
+        "escodegen": "1.8.x",
+        "esprima": "2.7.x",
+        "handlebars": "^4.0.1",
+        "js-yaml": "3.x",
+        "mkdirp": "0.5.x",
+        "multi-glob": "^1.0.1",
+        "nopt": "3.x",
+        "object-assign": "^4.0.1",
+        "once": "1.x",
+        "resolve": "^1.1.0",
+        "source-map": "0.4.x",
+        "supports-color": "3.1.x",
+        "which": "1.2.x",
+        "wordwrap": "1.0.x"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.4.4",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz",
+          "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=",
+          "dev": true,
+          "requires": {
+            "amdefine": ">=0.0.4"
+          }
+        },
+        "supports-color": {
+          "version": "3.1.2",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.1.2.tgz",
+          "integrity": "sha1-cqJiiU2dQIuVbKBf83su2KbiotU=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "babel-loader": {
+      "version": "7.1.5",
+      "resolved": "https://registry.npmjs.org/babel-loader/-/babel-loader-7.1.5.tgz",
+      "integrity": "sha512-iCHfbieL5d1LfOQeeVJEUyD9rTwBcP/fcEbRCfempxTDuqrKpu0AZjLAQHEQa3Yqyj9ORKe2iHfoj4rHLf7xpw==",
+      "dev": true,
+      "requires": {
+        "find-cache-dir": "^1.0.0",
+        "loader-utils": "^1.0.2",
+        "mkdirp": "^0.5.1"
+      }
+    },
+    "babel-messages": {
+      "version": "6.23.0",
+      "resolved": "https://registry.npmjs.org/babel-messages/-/babel-messages-6.23.0.tgz",
+      "integrity": "sha1-8830cDhYA1sqKVHG7F7fbGLyYw4=",
+      "dev": true,
+      "requires": {
+        "babel-runtime": "^6.22.0"
+      }
+    },
+    "babel-plugin-css-modules-transform": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/babel-plugin-css-modules-transform/-/babel-plugin-css-modules-transform-1.6.1.tgz",
+      "integrity": "sha512-Iv98dKRgQnhuHFcn2heHH1OpHo9LGyoKjlsAkj6/Q3wkwpVyHrNfVua/WHnrwe2f7EHy1KANnOSg+q4AJ6ZzaQ==",
+      "dev": true,
+      "requires": {
+        "css-modules-require-hook": "^4.0.6",
+        "mkdirp": "^0.5.1"
+      }
+    },
+    "babel-polyfill": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-polyfill/-/babel-polyfill-6.26.0.tgz",
+      "integrity": "sha1-N5k3q8Z9eJWXCtxiHyhM2WbPIVM=",
+      "dev": true,
+      "requires": {
+        "babel-runtime": "^6.26.0",
+        "core-js": "^2.5.0",
+        "regenerator-runtime": "^0.10.5"
+      },
+      "dependencies": {
+        "regenerator-runtime": {
+          "version": "0.10.5",
+          "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.10.5.tgz",
+          "integrity": "sha1-M2w+/BIgrc7dosn6tntaeVWjNlg=",
+          "dev": true
+        }
+      }
+    },
+    "babel-register": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-register/-/babel-register-6.26.0.tgz",
+      "integrity": "sha1-btAhFz4vy0htestFxgCahW9kcHE=",
+      "dev": true,
+      "requires": {
+        "babel-core": "^6.26.0",
+        "babel-runtime": "^6.26.0",
+        "core-js": "^2.5.0",
+        "home-or-tmp": "^2.0.0",
+        "lodash": "^4.17.4",
+        "mkdirp": "^0.5.1",
+        "source-map-support": "^0.4.15"
+      }
+    },
+    "babel-runtime": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-runtime/-/babel-runtime-6.26.0.tgz",
+      "integrity": "sha1-llxwWGaOgrVde/4E/yM3vItWR/4=",
+      "dev": true,
+      "requires": {
+        "core-js": "^2.4.0",
+        "regenerator-runtime": "^0.11.0"
+      }
+    },
+    "babel-template": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-template/-/babel-template-6.26.0.tgz",
+      "integrity": "sha1-3gPi0WOWsGn0bdn/+FIfsaDjXgI=",
+      "dev": true,
+      "requires": {
+        "babel-runtime": "^6.26.0",
+        "babel-traverse": "^6.26.0",
+        "babel-types": "^6.26.0",
+        "babylon": "^6.18.0",
+        "lodash": "^4.17.4"
+      }
+    },
+    "babel-traverse": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-traverse/-/babel-traverse-6.26.0.tgz",
+      "integrity": "sha1-RqnL1+3MYsjlwGTi0tjQ9ANXZu4=",
+      "dev": true,
+      "requires": {
+        "babel-code-frame": "^6.26.0",
+        "babel-messages": "^6.23.0",
+        "babel-runtime": "^6.26.0",
+        "babel-types": "^6.26.0",
+        "babylon": "^6.18.0",
+        "debug": "^2.6.8",
+        "globals": "^9.18.0",
+        "invariant": "^2.2.2",
+        "lodash": "^4.17.4"
+      }
+    },
+    "babel-types": {
+      "version": "6.26.0",
+      "resolved": "https://registry.npmjs.org/babel-types/-/babel-types-6.26.0.tgz",
+      "integrity": "sha1-o7Bz+Uq0nrb6Vc1lInozQ4BjJJc=",
+      "dev": true,
+      "requires": {
+        "babel-runtime": "^6.26.0",
+        "esutils": "^2.0.2",
+        "lodash": "^4.17.4",
+        "to-fast-properties": "^1.0.3"
+      }
+    },
+    "babylon": {
+      "version": "6.18.0",
+      "resolved": "https://registry.npmjs.org/babylon/-/babylon-6.18.0.tgz",
+      "integrity": "sha512-q/UEjfGJ2Cm3oKV71DJz9d25TPnq5rhBVL2Q4fA5wcC3jcrdn7+SssEybFIxwAvvP+YCsCYNKughoF33GxgycQ==",
+      "dev": true
+    },
+    "balanced-match": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz",
+      "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c=",
+      "dev": true
+    },
+    "base": {
+      "version": "0.11.2",
+      "resolved": "https://registry.npmjs.org/base/-/base-0.11.2.tgz",
+      "integrity": "sha512-5T6P4xPgpp0YDFvSWwEZ4NoE3aM4QBQXDzmVbraCkFj8zHM+mba8SyqB5DbZWyR7mYHo6Y7BdQo3MoA4m0TeQg==",
+      "dev": true,
+      "requires": {
+        "cache-base": "^1.0.1",
+        "class-utils": "^0.3.5",
+        "component-emitter": "^1.2.1",
+        "define-property": "^1.0.0",
+        "isobject": "^3.0.1",
+        "mixin-deep": "^1.2.0",
+        "pascalcase": "^0.1.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
+        },
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "dev": true,
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        },
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "base64-js": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.3.0.tgz",
+      "integrity": "sha512-ccav/yGvoa80BQDljCxsmmQ3Xvx60/UpBIij5QN21W3wBi/hhIC9OoO+KLpu9IJTS9j4DRVJ3aDDF9cMSoa2lw==",
+      "dev": true
+    },
+    "big.js": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/big.js/-/big.js-3.2.0.tgz",
+      "integrity": "sha512-+hN/Zh2D08Mx65pZ/4g5bsmNiZUuChDiQfTUQ7qJr4/kuopCr88xZsAXv6mBoZEsUI4OuGHlX59qE94K2mMW8Q==",
+      "dev": true
+    },
+    "binary-extensions": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-1.11.0.tgz",
+      "integrity": "sha1-RqoXUftqL5PuXmibsQh9SxTGwgU=",
+      "dev": true
+    },
+    "bluebird": {
+      "version": "3.5.1",
+      "resolved": "https://registry.npmjs.org/bluebird/-/bluebird-3.5.1.tgz",
+      "integrity": "sha512-MKiLiV+I1AA596t9w1sQJ8jkiSr5+ZKi0WKrYGUn6d1Fx+Ij4tIj+m2WMQSGczs5jZVxV339chE8iwk6F64wjA==",
+      "dev": true
+    },
+    "bn.js": {
+      "version": "4.11.8",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.11.8.tgz",
+      "integrity": "sha512-ItfYfPLkWHUjckQCk8xC+LwxgK8NYcXywGigJgSwOP8Y2iyWT4f2vsZnoOXTTbo+o5yXmIUJ4gn5538SO5S3gA==",
+      "dev": true
+    },
+    "bootstrap-3-typeahead": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/bootstrap-3-typeahead/-/bootstrap-3-typeahead-4.0.2.tgz",
+      "integrity": "sha1-yxyWkESFaGIJb8jHHMIbOsu1BBI="
+    },
+    "bootstrap-toggle": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/bootstrap-toggle/-/bootstrap-toggle-2.2.2.tgz",
+      "integrity": "sha1-K4hTT8G5mGdPh3+Yug2LW3Q+lv4="
+    },
+    "brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "requires": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "braces": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-2.3.2.tgz",
+      "integrity": "sha512-aNdbnj9P8PjdXU4ybaWLK2IF3jc/EoDYbC7AazW6to3TRsfXxscC9UXOB5iDiEQrkyIbWp2SLQda4+QAa7nc3w==",
+      "dev": true,
+      "requires": {
+        "arr-flatten": "^1.1.0",
+        "array-unique": "^0.3.2",
+        "extend-shallow": "^2.0.1",
+        "fill-range": "^4.0.0",
+        "isobject": "^3.0.1",
+        "repeat-element": "^1.1.2",
+        "snapdragon": "^0.8.1",
+        "snapdragon-node": "^2.0.1",
+        "split-string": "^3.0.2",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "brorand": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
+      "integrity": "sha1-EsJe/kCkXjwyPrhnWgoM5XsiNx8=",
+      "dev": true
+    },
+    "browserify-aes": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
+      "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
+      "dev": true,
+      "requires": {
+        "buffer-xor": "^1.0.3",
+        "cipher-base": "^1.0.0",
+        "create-hash": "^1.1.0",
+        "evp_bytestokey": "^1.0.3",
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "browserify-cipher": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/browserify-cipher/-/browserify-cipher-1.0.1.tgz",
+      "integrity": "sha512-sPhkz0ARKbf4rRQt2hTpAHqn47X3llLkUGn+xEJzLjwY8LRs2p0v7ljvI5EyoRO/mexrNunNECisZs+gw2zz1w==",
+      "dev": true,
+      "requires": {
+        "browserify-aes": "^1.0.4",
+        "browserify-des": "^1.0.0",
+        "evp_bytestokey": "^1.0.0"
+      }
+    },
+    "browserify-des": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.1.tgz",
+      "integrity": "sha512-zy0Cobe3hhgpiOM32Tj7KQ3Vl91m0njwsjzZQK1L+JDf11dzP9qIvjreVinsvXrgfjhStXwUWAEpB9D7Gwmayw==",
+      "dev": true,
+      "requires": {
+        "cipher-base": "^1.0.1",
+        "des.js": "^1.0.0",
+        "inherits": "^2.0.1"
+      }
+    },
+    "browserify-rsa": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/browserify-rsa/-/browserify-rsa-4.0.1.tgz",
+      "integrity": "sha1-IeCr+vbyApzy+vsTNWenAdQTVSQ=",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.1.0",
+        "randombytes": "^2.0.1"
+      }
+    },
+    "browserify-sign": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/browserify-sign/-/browserify-sign-4.0.4.tgz",
+      "integrity": "sha1-qk62jl17ZYuqa/alfmMMvXqT0pg=",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.1.1",
+        "browserify-rsa": "^4.0.0",
+        "create-hash": "^1.1.0",
+        "create-hmac": "^1.1.2",
+        "elliptic": "^6.0.0",
+        "inherits": "^2.0.1",
+        "parse-asn1": "^5.0.0"
+      }
+    },
+    "browserify-zlib": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/browserify-zlib/-/browserify-zlib-0.2.0.tgz",
+      "integrity": "sha512-Z942RysHXmJrhqk88FmKBVq/v5tqmSkDz7p54G/MGyjMnCFFnC79XWNbg+Vta8W6Wb2qtSZTSxIGkJrRpCFEiA==",
+      "dev": true,
+      "requires": {
+        "pako": "~1.0.5"
+      }
+    },
+    "browserslist": {
+      "version": "1.7.7",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-1.7.7.tgz",
+      "integrity": "sha1-C9dnBCWL6CmyOYu1Dkti0aFmsLk=",
+      "dev": true,
+      "requires": {
+        "caniuse-db": "^1.0.30000639",
+        "electron-to-chromium": "^1.2.7"
+      }
+    },
+    "buffer": {
+      "version": "4.9.1",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-4.9.1.tgz",
+      "integrity": "sha1-bRu2AbB6TvztlwlBMgkwJ8lbwpg=",
+      "dev": true,
+      "requires": {
+        "base64-js": "^1.0.2",
+        "ieee754": "^1.1.4",
+        "isarray": "^1.0.0"
+      }
+    },
+    "buffer-from": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.0.tgz",
+      "integrity": "sha512-c5mRlguI/Pe2dSZmpER62rSCu0ryKmWddzRYsuXc50U2/g8jMOulc31VZMa4mYx31U5xsmSOpDCgH88Vl9cDGQ==",
+      "dev": true
+    },
+    "buffer-xor": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
+      "integrity": "sha1-JuYe0UIvtw3ULm42cp7VHYVf6Nk=",
+      "dev": true
+    },
+    "builtin-status-codes": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/builtin-status-codes/-/builtin-status-codes-3.0.0.tgz",
+      "integrity": "sha1-hZgoeOIbmOHGZCXgPQF0eI9Wnug=",
+      "dev": true
+    },
+    "cacache": {
+      "version": "10.0.4",
+      "resolved": "https://registry.npmjs.org/cacache/-/cacache-10.0.4.tgz",
+      "integrity": "sha512-Dph0MzuH+rTQzGPNT9fAnrPmMmjKfST6trxJeK7NQuHRaVw24VzPRWTmg9MpcwOVQZO0E1FBICUlFeNaKPIfHA==",
+      "dev": true,
+      "requires": {
+        "bluebird": "^3.5.1",
+        "chownr": "^1.0.1",
+        "glob": "^7.1.2",
+        "graceful-fs": "^4.1.11",
+        "lru-cache": "^4.1.1",
+        "mississippi": "^2.0.0",
+        "mkdirp": "^0.5.1",
+        "move-concurrently": "^1.0.1",
+        "promise-inflight": "^1.0.1",
+        "rimraf": "^2.6.2",
+        "ssri": "^5.2.4",
+        "unique-filename": "^1.1.0",
+        "y18n": "^4.0.0"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "7.1.2",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
+          "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+          "dev": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        }
+      }
+    },
+    "cache-base": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/cache-base/-/cache-base-1.0.1.tgz",
+      "integrity": "sha512-AKcdTnFSWATd5/GCPRxr2ChwIJ85CeyrEyjRHlKxQ56d4XJMGym0uAiKn0xbLOGOl3+yRpOTi484dVCEc5AUzQ==",
+      "dev": true,
+      "requires": {
+        "collection-visit": "^1.0.0",
+        "component-emitter": "^1.2.1",
+        "get-value": "^2.0.6",
+        "has-value": "^1.0.0",
+        "isobject": "^3.0.1",
+        "set-value": "^2.0.0",
+        "to-object-path": "^0.3.0",
+        "union-value": "^1.0.0",
+        "unset-value": "^1.0.0"
+      }
+    },
+    "camelcase": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-1.2.1.tgz",
+      "integrity": "sha1-m7UwTS4LVmmLLHWLCKPqqdqlijk=",
+      "dev": true,
+      "optional": true
+    },
+    "caniuse-api": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/caniuse-api/-/caniuse-api-1.6.1.tgz",
+      "integrity": "sha1-tTTnxzTE+B7F++isoq0kNUuWLGw=",
+      "dev": true,
+      "requires": {
+        "browserslist": "^1.3.6",
+        "caniuse-db": "^1.0.30000529",
+        "lodash.memoize": "^4.1.2",
+        "lodash.uniq": "^4.5.0"
+      }
+    },
+    "caniuse-db": {
+      "version": "1.0.30000865",
+      "resolved": "https://registry.npmjs.org/caniuse-db/-/caniuse-db-1.0.30000865.tgz",
+      "integrity": "sha1-gv+2TUD3VnYgqsAtOmMgeWiavGs=",
+      "dev": true
+    },
+    "center-align": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/center-align/-/center-align-0.1.3.tgz",
+      "integrity": "sha1-qg0yYptu6XIgBBHL1EYckHvCt60=",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "align-text": "^0.1.3",
+        "lazy-cache": "^1.0.3"
+      }
+    },
+    "chalk": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz",
+      "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=",
+      "dev": true,
+      "requires": {
+        "ansi-styles": "^2.2.1",
+        "escape-string-regexp": "^1.0.2",
+        "has-ansi": "^2.0.0",
+        "strip-ansi": "^3.0.0",
+        "supports-color": "^2.0.0"
+      }
+    },
+    "chardet": {
+      "version": "0.5.0",
+      "resolved": "https://registry.npmjs.org/chardet/-/chardet-0.5.0.tgz",
+      "integrity": "sha512-9ZTaoBaePSCFvNlNGrsyI8ZVACP2svUtq0DkM7t4K2ClAa96sqOIRjAzDTc8zXzFt1cZR46rRzLTiHFSJ+Qw0g==",
+      "dev": true
+    },
+    "chokidar": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-2.0.4.tgz",
+      "integrity": "sha512-z9n7yt9rOvIJrMhvDtDictKrkFHeihkNl6uWMmZlmL6tJtX9Cs+87oK+teBx+JIgzvbX3yZHT3eF8vpbDxHJXQ==",
+      "dev": true,
+      "requires": {
+        "anymatch": "^2.0.0",
+        "async-each": "^1.0.0",
+        "braces": "^2.3.0",
+        "fsevents": "^1.2.2",
+        "glob-parent": "^3.1.0",
+        "inherits": "^2.0.1",
+        "is-binary-path": "^1.0.0",
+        "is-glob": "^4.0.0",
+        "lodash.debounce": "^4.0.8",
+        "normalize-path": "^2.1.1",
+        "path-is-absolute": "^1.0.0",
+        "readdirp": "^2.0.0",
+        "upath": "^1.0.5"
+      }
+    },
+    "chownr": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-1.0.1.tgz",
+      "integrity": "sha1-4qdQQqlVGQi+vSW4Uj1fl2nXkYE=",
+      "dev": true
+    },
+    "chrome-trace-event": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.0.tgz",
+      "integrity": "sha512-xDbVgyfDTT2piup/h8dK/y4QZfJRSa73bw1WZ8b4XM1o7fsFubUVGYcE+1ANtOzJJELGpYoG2961z0Z6OAld9A==",
+      "dev": true,
+      "requires": {
+        "tslib": "^1.9.0"
+      }
+    },
+    "cipher-base": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.4.tgz",
+      "integrity": "sha512-Kkht5ye6ZGmwv40uUDZztayT2ThLQGfnj/T71N/XzeZeo3nf8foyW7zGTsPYkEya3m5f3cAypH+qe7YOrM1U2Q==",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "clap": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/clap/-/clap-1.2.3.tgz",
+      "integrity": "sha512-4CoL/A3hf90V3VIEjeuhSvlGFEHKzOz+Wfc2IVZc+FaUgU0ZQafJTP49fvnULipOPcAfqhyI2duwQyns6xqjYA==",
+      "dev": true,
+      "requires": {
+        "chalk": "^1.1.3"
+      }
+    },
+    "class-utils": {
+      "version": "0.3.6",
+      "resolved": "https://registry.npmjs.org/class-utils/-/class-utils-0.3.6.tgz",
+      "integrity": "sha512-qOhPa/Fj7s6TY8H8esGu5QNpMMQxz79h+urzrNYN6mn+9BnxlDGf5QZ+XeCDsxSjPqsSR56XOZOJmpeurnLMeg==",
+      "dev": true,
+      "requires": {
+        "arr-union": "^3.1.0",
+        "define-property": "^0.2.5",
+        "isobject": "^3.0.0",
+        "static-extend": "^0.1.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        }
+      }
+    },
+    "clean-webpack-plugin": {
+      "version": "0.1.19",
+      "resolved": "https://registry.npmjs.org/clean-webpack-plugin/-/clean-webpack-plugin-0.1.19.tgz",
+      "integrity": "sha512-M1Li5yLHECcN2MahoreuODul5LkjohJGFxLPTjl3j1ttKrF5rgjZET1SJduuqxLAuT1gAPOdkhg03qcaaU1KeA==",
+      "dev": true,
+      "requires": {
+        "rimraf": "^2.6.1"
+      }
+    },
+    "cli-cursor": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-2.1.0.tgz",
+      "integrity": "sha1-s12sN2R5+sw+lHR9QdDQ9SOP/LU=",
+      "dev": true,
+      "requires": {
+        "restore-cursor": "^2.0.0"
+      }
+    },
+    "cli-width": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/cli-width/-/cli-width-2.2.0.tgz",
+      "integrity": "sha1-/xnt6Kml5XkyQUewwR8PvLq+1jk=",
+      "dev": true
+    },
+    "cliui": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-2.1.0.tgz",
+      "integrity": "sha1-S0dXYP+AJkx2LDoXGQMukcf+oNE=",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "center-align": "^0.1.1",
+        "right-align": "^0.1.1",
+        "wordwrap": "0.0.2"
+      },
+      "dependencies": {
+        "wordwrap": {
+          "version": "0.0.2",
+          "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.2.tgz",
+          "integrity": "sha1-t5Zpu0LstAn4PVg8rVLKF+qhZD8=",
+          "dev": true,
+          "optional": true
+        }
+      }
+    },
+    "clone": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/clone/-/clone-1.0.4.tgz",
+      "integrity": "sha1-2jCcwmPfFZlMaIypAheco8fNfH4=",
+      "dev": true
+    },
+    "coa": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/coa/-/coa-1.0.4.tgz",
+      "integrity": "sha1-qe8VNmDWqGqL3sAomlxoTSF0Mv0=",
+      "dev": true,
+      "requires": {
+        "q": "^1.1.2"
+      }
+    },
+    "code-point-at": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/code-point-at/-/code-point-at-1.1.0.tgz",
+      "integrity": "sha1-DQcLTQQ6W+ozovGkDi7bPZpMz3c=",
+      "dev": true
+    },
+    "collection-visit": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz",
+      "integrity": "sha1-S8A3PBZLwykbTTaMgpzxqApZ3KA=",
+      "dev": true,
+      "requires": {
+        "map-visit": "^1.0.0",
+        "object-visit": "^1.0.0"
+      }
+    },
+    "color": {
+      "version": "0.11.4",
+      "resolved": "https://registry.npmjs.org/color/-/color-0.11.4.tgz",
+      "integrity": "sha1-bXtcdPtl6EHNSHkq0e1eB7kE12Q=",
+      "dev": true,
+      "requires": {
+        "clone": "^1.0.2",
+        "color-convert": "^1.3.0",
+        "color-string": "^0.3.0"
+      }
+    },
+    "color-convert": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.2.tgz",
+      "integrity": "sha512-3NUJZdhMhcdPn8vJ9v2UQJoH0qqoGUkYTgFEPZaPjEtwmmKUfNV46zZmgB2M5M4DCEQHMaCfWHCxiBflLm04Tg==",
+      "dev": true,
+      "requires": {
+        "color-name": "1.1.1"
+      }
+    },
+    "color-name": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.1.tgz",
+      "integrity": "sha1-SxQVMEz1ACjqgWQ2Q72C6gWANok=",
+      "dev": true
+    },
+    "color-string": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/color-string/-/color-string-0.3.0.tgz",
+      "integrity": "sha1-J9RvtnAlxcL6JZk7+/V55HhBuZE=",
+      "dev": true,
+      "requires": {
+        "color-name": "^1.0.0"
+      }
+    },
+    "colormin": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/colormin/-/colormin-1.1.2.tgz",
+      "integrity": "sha1-6i90IKcrlogaOKrlnsEkpvcpgTM=",
+      "dev": true,
+      "requires": {
+        "color": "^0.11.0",
+        "css-color-names": "0.0.4",
+        "has": "^1.0.1"
+      }
+    },
+    "colors": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/colors/-/colors-1.1.2.tgz",
+      "integrity": "sha1-FopHAXVran9RoSzgyXv6KMCE7WM=",
+      "dev": true
+    },
+    "commander": {
+      "version": "2.13.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-2.13.0.tgz",
+      "integrity": "sha512-MVuS359B+YzaWqjCL/c+22gfryv+mCBPHAv3zyVI2GN8EY6IRP8VwtasXn8jyyhvvq84R4ImN1OKRtcbIasjYA==",
+      "dev": true
+    },
+    "commondir": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/commondir/-/commondir-1.0.1.tgz",
+      "integrity": "sha1-3dgA2gxmEnOTzKWVDqloo6rxJTs=",
+      "dev": true
+    },
+    "component-emitter": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/component-emitter/-/component-emitter-1.2.1.tgz",
+      "integrity": "sha1-E3kY1teCg/ffemt8WmPhQOaUJeY=",
+      "dev": true
+    },
+    "concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=",
+      "dev": true
+    },
+    "concat-stream": {
+      "version": "1.6.2",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-1.6.2.tgz",
+      "integrity": "sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==",
+      "dev": true,
+      "requires": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^2.2.2",
+        "typedarray": "^0.0.6"
+      }
+    },
+    "console-browserify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/console-browserify/-/console-browserify-1.1.0.tgz",
+      "integrity": "sha1-8CQcRXMKn8YyOyBtvzjtx0HQuxA=",
+      "dev": true,
+      "requires": {
+        "date-now": "^0.1.4"
+      }
+    },
+    "constants-browserify": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/constants-browserify/-/constants-browserify-1.0.0.tgz",
+      "integrity": "sha1-wguW2MYXdIqvHBYCF2DNJ/y4y3U=",
+      "dev": true
+    },
+    "convert-source-map": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.5.1.tgz",
+      "integrity": "sha1-uCeAl7m8IpNl3lxiz1/K7YtVmeU=",
+      "dev": true
+    },
+    "copy-concurrently": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/copy-concurrently/-/copy-concurrently-1.0.5.tgz",
+      "integrity": "sha512-f2domd9fsVDFtaFcbaRZuYXwtdmnzqbADSwhSWYxYB/Q8zsdUUFMXVRwXGDMWmbEzAn1kdRrtI1T/KTFOL4X2A==",
+      "dev": true,
+      "requires": {
+        "aproba": "^1.1.1",
+        "fs-write-stream-atomic": "^1.0.8",
+        "iferr": "^0.1.5",
+        "mkdirp": "^0.5.1",
+        "rimraf": "^2.5.4",
+        "run-queue": "^1.0.0"
+      }
+    },
+    "copy-descriptor": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/copy-descriptor/-/copy-descriptor-0.1.1.tgz",
+      "integrity": "sha1-Z29us8OZl8LuGsOpJP1hJHSPV40=",
+      "dev": true
+    },
+    "copy-webpack-plugin": {
+      "version": "4.5.2",
+      "resolved": "https://registry.npmjs.org/copy-webpack-plugin/-/copy-webpack-plugin-4.5.2.tgz",
+      "integrity": "sha512-zmC33E8FFSq3AbflTvqvPvBo621H36Afsxlui91d+QyZxPIuXghfnTsa1CuqiAaCPgJoSUWfTFbKJnadZpKEbQ==",
+      "dev": true,
+      "requires": {
+        "cacache": "^10.0.4",
+        "find-cache-dir": "^1.0.0",
+        "globby": "^7.1.1",
+        "is-glob": "^4.0.0",
+        "loader-utils": "^1.1.0",
+        "minimatch": "^3.0.4",
+        "p-limit": "^1.0.0",
+        "serialize-javascript": "^1.4.0"
+      }
+    },
+    "core-js": {
+      "version": "2.5.7",
+      "resolved": "https://registry.npmjs.org/core-js/-/core-js-2.5.7.tgz",
+      "integrity": "sha512-RszJCAxg/PP6uzXVXL6BsxSXx/B05oJAQ2vkJRjyjrEcNVycaqOmNb5OTxZPE3xa5gwZduqza6L9JOCenh/Ecw==",
+      "dev": true
+    },
+    "core-util-is": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
+      "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac=",
+      "dev": true
+    },
+    "create-ecdh": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/create-ecdh/-/create-ecdh-4.0.3.tgz",
+      "integrity": "sha512-GbEHQPMOswGpKXM9kCWVrremUcBmjteUaQ01T9rkKCPDXfUHX0IoP9LpHYo2NPFampa4e+/pFDc3jQdxrxQLaw==",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.1.0",
+        "elliptic": "^6.0.0"
+      }
+    },
+    "create-hash": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
+      "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
+      "dev": true,
+      "requires": {
+        "cipher-base": "^1.0.1",
+        "inherits": "^2.0.1",
+        "md5.js": "^1.3.4",
+        "ripemd160": "^2.0.1",
+        "sha.js": "^2.4.0"
+      }
+    },
+    "create-hmac": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
+      "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
+      "dev": true,
+      "requires": {
+        "cipher-base": "^1.0.3",
+        "create-hash": "^1.1.0",
+        "inherits": "^2.0.1",
+        "ripemd160": "^2.0.0",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      }
+    },
+    "cross-spawn": {
+      "version": "6.0.5",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-6.0.5.tgz",
+      "integrity": "sha512-eTVLrBSt7fjbDygz805pMnstIs2VTBNkRm0qxZd+M7A5XDdxVRWO5MxGBXZhjY4cqLYLdtrGqRf8mBPmzwSpWQ==",
+      "dev": true,
+      "requires": {
+        "nice-try": "^1.0.4",
+        "path-key": "^2.0.1",
+        "semver": "^5.5.0",
+        "shebang-command": "^1.2.0",
+        "which": "^1.2.9"
+      }
+    },
+    "crypto-browserify": {
+      "version": "3.12.0",
+      "resolved": "https://registry.npmjs.org/crypto-browserify/-/crypto-browserify-3.12.0.tgz",
+      "integrity": "sha512-fz4spIh+znjO2VjL+IdhEpRJ3YN6sMzITSBijk6FK2UvTqruSQW+/cCZTSNsMiZNvUeq0CqurF+dAbyiGOY6Wg==",
+      "dev": true,
+      "requires": {
+        "browserify-cipher": "^1.0.0",
+        "browserify-sign": "^4.0.0",
+        "create-ecdh": "^4.0.0",
+        "create-hash": "^1.1.0",
+        "create-hmac": "^1.1.0",
+        "diffie-hellman": "^5.0.0",
+        "inherits": "^2.0.1",
+        "pbkdf2": "^3.0.3",
+        "public-encrypt": "^4.0.0",
+        "randombytes": "^2.0.0",
+        "randomfill": "^1.0.3"
+      }
+    },
+    "css-color-names": {
+      "version": "0.0.4",
+      "resolved": "https://registry.npmjs.org/css-color-names/-/css-color-names-0.0.4.tgz",
+      "integrity": "sha1-gIrcLnnPhHOAabZGyyDsJ762KeA=",
+      "dev": true
+    },
+    "css-loader": {
+      "version": "0.28.11",
+      "resolved": "https://registry.npmjs.org/css-loader/-/css-loader-0.28.11.tgz",
+      "integrity": "sha512-wovHgjAx8ZIMGSL8pTys7edA1ClmzxHeY6n/d97gg5odgsxEgKjULPR0viqyC+FWMCL9sfqoC/QCUBo62tLvPg==",
+      "dev": true,
+      "requires": {
+        "babel-code-frame": "^6.26.0",
+        "css-selector-tokenizer": "^0.7.0",
+        "cssnano": "^3.10.0",
+        "icss-utils": "^2.1.0",
+        "loader-utils": "^1.0.2",
+        "lodash.camelcase": "^4.3.0",
+        "object-assign": "^4.1.1",
+        "postcss": "^5.0.6",
+        "postcss-modules-extract-imports": "^1.2.0",
+        "postcss-modules-local-by-default": "^1.2.0",
+        "postcss-modules-scope": "^1.1.0",
+        "postcss-modules-values": "^1.3.0",
+        "postcss-value-parser": "^3.3.0",
+        "source-list-map": "^2.0.0"
+      },
+      "dependencies": {
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "icss-utils": {
+          "version": "2.1.0",
+          "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-2.1.0.tgz",
+          "integrity": "sha1-g/Cg7DeL8yRheLbCrZE28TWxyWI=",
+          "dev": true,
+          "requires": {
+            "postcss": "^6.0.1"
+          },
+          "dependencies": {
+            "postcss": {
+              "version": "6.0.23",
+              "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.23.tgz",
+              "integrity": "sha512-soOk1h6J3VMTZtVeVpv15/Hpdl2cBLX3CAw4TAbkpTJiNPk9YP/zWcD1ND+xEtvyuuvKzbxliTOIyvkSeSJ6ag==",
+              "dev": true,
+              "requires": {
+                "chalk": "^2.4.1",
+                "source-map": "^0.6.1",
+                "supports-color": "^5.4.0"
+              }
+            }
+          }
+        },
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          },
+          "dependencies": {
+            "ansi-styles": {
+              "version": "2.2.1",
+              "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-2.2.1.tgz",
+              "integrity": "sha1-tDLdM1i2NM914eRmQ2gkBTPB3b4=",
+              "dev": true
+            },
+            "chalk": {
+              "version": "1.1.3",
+              "resolved": "https://registry.npmjs.org/chalk/-/chalk-1.1.3.tgz",
+              "integrity": "sha1-qBFcVeSnAv5NFQq9OHKCKn4J/Jg=",
+              "dev": true,
+              "requires": {
+                "ansi-styles": "^2.2.1",
+                "escape-string-regexp": "^1.0.2",
+                "has-ansi": "^2.0.0",
+                "strip-ansi": "^3.0.0",
+                "supports-color": "^2.0.0"
+              },
+              "dependencies": {
+                "supports-color": {
+                  "version": "2.0.0",
+                  "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz",
+                  "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=",
+                  "dev": true
+                }
+              }
+            },
+            "has-flag": {
+              "version": "1.0.0",
+              "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz",
+              "integrity": "sha1-nZ55MWXOAXoA8AQYxD+UKnsdEfo=",
+              "dev": true
+            },
+            "source-map": {
+              "version": "0.5.7",
+              "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz",
+              "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=",
+              "dev": true
+            },
+            "supports-color": {
+              "version": "3.2.3",
+              "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+              "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+              "dev": true,
+              "requires": {
+                "has-flag": "^1.0.0"
+              }
+            }
+          }
+        },
+        "postcss-modules-extract-imports": {
+          "version": "1.2.0",
+          "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-1.2.0.tgz",
+          "integrity": "sha1-ZhQOzs447wa/DT41XWm/WdFB6oU=",
+          "dev": true,
+          "requires": {
+            "postcss": "^6.0.1"
+          },
+          "dependencies": {
+            "postcss": {
+              "version": "6.0.23",
+              "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.23.tgz",
+              "integrity": "sha512-soOk1h6J3VMTZtVeVpv15/Hpdl2cBLX3CAw4TAbkpTJiNPk9YP/zWcD1ND+xEtvyuuvKzbxliTOIyvkSeSJ6ag==",
+              "dev": true,
+              "requires": {
+                "chalk": "^2.4.1",
+                "source-map": "^0.6.1",
+                "supports-color": "^5.4.0"
+              }
+            }
+          }
+        },
+        "source-map": {
+          "version": "0.6.1",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+          "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "css-modules-require-hook": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/css-modules-require-hook/-/css-modules-require-hook-4.2.3.tgz",
+      "integrity": "sha1-Z5LKQSsV4j5vm+agfc739Xf/kE0=",
+      "dev": true,
+      "requires": {
+        "debug": "^2.2.0",
+        "generic-names": "^1.0.1",
+        "glob-to-regexp": "^0.3.0",
+        "icss-replace-symbols": "^1.0.2",
+        "lodash": "^4.3.0",
+        "postcss": "^6.0.1",
+        "postcss-modules-extract-imports": "^1.0.0",
+        "postcss-modules-local-by-default": "^1.0.1",
+        "postcss-modules-resolve-imports": "^1.3.0",
+        "postcss-modules-scope": "^1.0.0",
+        "postcss-modules-values": "^1.1.1",
+        "seekout": "^1.0.1"
+      }
+    },
+    "css-selector-tokenizer": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/css-selector-tokenizer/-/css-selector-tokenizer-0.7.0.tgz",
+      "integrity": "sha1-5piEdK6MlTR3v15+/s/OzNnPTIY=",
+      "dev": true,
+      "requires": {
+        "cssesc": "^0.1.0",
+        "fastparse": "^1.1.1",
+        "regexpu-core": "^1.0.0"
+      }
+    },
+    "cssesc": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-0.1.0.tgz",
+      "integrity": "sha1-yBSQPkViM3GgR3tAEJqq++6t27Q=",
+      "dev": true
+    },
+    "cssnano": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/cssnano/-/cssnano-3.10.0.tgz",
+      "integrity": "sha1-Tzj2zqK5sX+gFJDyPx3GjqZcHDg=",
+      "dev": true,
+      "requires": {
+        "autoprefixer": "^6.3.1",
+        "decamelize": "^1.1.2",
+        "defined": "^1.0.0",
+        "has": "^1.0.1",
+        "object-assign": "^4.0.1",
+        "postcss": "^5.0.14",
+        "postcss-calc": "^5.2.0",
+        "postcss-colormin": "^2.1.8",
+        "postcss-convert-values": "^2.3.4",
+        "postcss-discard-comments": "^2.0.4",
+        "postcss-discard-duplicates": "^2.0.1",
+        "postcss-discard-empty": "^2.0.1",
+        "postcss-discard-overridden": "^0.1.1",
+        "postcss-discard-unused": "^2.2.1",
+        "postcss-filter-plugins": "^2.0.0",
+        "postcss-merge-idents": "^2.1.5",
+        "postcss-merge-longhand": "^2.0.1",
+        "postcss-merge-rules": "^2.0.3",
+        "postcss-minify-font-values": "^1.0.2",
+        "postcss-minify-gradients": "^1.0.1",
+        "postcss-minify-params": "^1.0.4",
+        "postcss-minify-selectors": "^2.0.4",
+        "postcss-normalize-charset": "^1.1.0",
+        "postcss-normalize-url": "^3.0.7",
+        "postcss-ordered-values": "^2.1.0",
+        "postcss-reduce-idents": "^2.2.2",
+        "postcss-reduce-initial": "^1.0.0",
+        "postcss-reduce-transforms": "^1.0.3",
+        "postcss-svgo": "^2.1.1",
+        "postcss-unique-selectors": "^2.0.2",
+        "postcss-value-parser": "^3.2.3",
+        "postcss-zindex": "^2.0.1"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "csso": {
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/csso/-/csso-2.3.2.tgz",
+      "integrity": "sha1-3dUsWHAz9J6Utx/FVWnyUuj/X4U=",
+      "dev": true,
+      "requires": {
+        "clap": "^1.0.9",
+        "source-map": "^0.5.3"
+      }
+    },
+    "cyclist": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/cyclist/-/cyclist-0.2.2.tgz",
+      "integrity": "sha1-GzN5LhHpFKL9bW7WRHRkRE5fpkA=",
+      "dev": true
+    },
+    "d": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/d/-/d-1.0.0.tgz",
+      "integrity": "sha1-dUu1v+VUUdpppYuU1F9MWwRi1Y8=",
+      "dev": true,
+      "requires": {
+        "es5-ext": "^0.10.9"
+      }
+    },
+    "d3": {
+      "version": "3.5.17",
+      "resolved": "https://registry.npmjs.org/d3/-/d3-3.5.17.tgz",
+      "integrity": "sha1-vEZ0gAQ3iyGjYMn8fPUjF5B2L7g="
+    },
+    "d3-collection": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/d3-collection/-/d3-collection-1.0.4.tgz",
+      "integrity": "sha1-NC39EoN8kJdPM/HMCnha6lcNzcI="
+    },
+    "d3-selection": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/d3-selection/-/d3-selection-1.3.0.tgz",
+      "integrity": "sha512-qgpUOg9tl5CirdqESUAu0t9MU/t3O9klYfGfyKsXEmhyxyzLpzpeh08gaxBUTQw1uXIOkr/30Ut2YRjSSxlmHA=="
+    },
+    "d3-tip": {
+      "version": "0.9.1",
+      "resolved": "https://registry.npmjs.org/d3-tip/-/d3-tip-0.9.1.tgz",
+      "integrity": "sha512-EVBfG9d+HnjIoyVXfhpytWxlF59JaobwizqMX9EBXtsFmJytjwHeYiUs74ldHQjE7S9vzfKTx2LCtvUrIbuFYg==",
+      "requires": {
+        "d3-collection": "^1.0.4",
+        "d3-selection": "^1.3.0"
+      }
+    },
+    "datatables.net": {
+      "version": "1.10.19",
+      "resolved": "https://registry.npmjs.org/datatables.net/-/datatables.net-1.10.19.tgz",
+      "integrity": "sha512-+ljXcI6Pj3PTGy5pesp3E5Dr3x3AV45EZe0o1r0gKENN2gafBKXodVnk2ypKwl2tTmivjxbkiqoWnipTefyBTA==",
+      "requires": {
+        "jquery": ">=1.7"
+      }
+    },
+    "datatables.net-bs": {
+      "version": "1.10.19",
+      "resolved": "https://registry.npmjs.org/datatables.net-bs/-/datatables.net-bs-1.10.19.tgz",
+      "integrity": "sha512-5gxoI2n+duZP06+4xVC2TtH6zcY369/TRKTZ1DdSgDcDUl4OYQsrXCuaLJmbVzna/5Y5lrMmK7CxgvYgIynICA==",
+      "requires": {
+        "datatables.net": "1.10.19",
+        "jquery": ">=1.7"
+      }
+    },
+    "date-now": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/date-now/-/date-now-0.1.4.tgz",
+      "integrity": "sha1-6vQ5/U1ISK105cx9vvIAZyueNFs=",
+      "dev": true
+    },
+    "debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "dev": true,
+      "requires": {
+        "ms": "2.0.0"
+      }
+    },
+    "decamelize": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+      "integrity": "sha1-9lNNFRSCabIDUue+4m9QH5oZEpA=",
+      "dev": true
+    },
+    "decode-uri-component": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.0.tgz",
+      "integrity": "sha1-6zkTMzRYd1y4TNGh+uBiEGu4dUU=",
+      "dev": true
+    },
+    "deep-is": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.3.tgz",
+      "integrity": "sha1-s2nW+128E+7PUk+RsHD+7cNXzzQ=",
+      "dev": true
+    },
+    "define-properties": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.1.2.tgz",
+      "integrity": "sha1-g6c/L+pWmJj7c3GTyPhzyvbUXJQ=",
+      "dev": true,
+      "requires": {
+        "foreach": "^2.0.5",
+        "object-keys": "^1.0.8"
+      }
+    },
+    "define-property": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/define-property/-/define-property-2.0.2.tgz",
+      "integrity": "sha512-jwK2UV4cnPpbcG7+VRARKTZPUWowwXA8bzH5NP6ud0oeAxyYPuGZUAC7hMugpCdz4BeSZl2Dl9k66CHJ/46ZYQ==",
+      "dev": true,
+      "requires": {
+        "is-descriptor": "^1.0.2",
+        "isobject": "^3.0.1"
+      },
+      "dependencies": {
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "dev": true,
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        },
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "defined": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/defined/-/defined-1.0.0.tgz",
+      "integrity": "sha1-yY2bzvdWdBiOEQlpFRGZ45sfppM=",
+      "dev": true
+    },
+    "des.js": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.0.tgz",
+      "integrity": "sha1-wHTS4qpqipoH29YfmhXCzYPsjsw=",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "minimalistic-assert": "^1.0.0"
+      }
+    },
+    "detect-indent": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/detect-indent/-/detect-indent-4.0.0.tgz",
+      "integrity": "sha1-920GQ1LN9Docts5hnE7jqUdd4gg=",
+      "dev": true,
+      "requires": {
+        "repeating": "^2.0.0"
+      }
+    },
+    "diffie-hellman": {
+      "version": "5.0.3",
+      "resolved": "https://registry.npmjs.org/diffie-hellman/-/diffie-hellman-5.0.3.tgz",
+      "integrity": "sha512-kqag/Nl+f3GwyK25fhUMYj81BUOrZ9IuJsjIcDE5icNM9FJHAVm3VcUDxdLPoQtTuUylWm6ZIknYJwwaPxsUzg==",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.1.0",
+        "miller-rabin": "^4.0.0",
+        "randombytes": "^2.0.0"
+      }
+    },
+    "dir-glob": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-2.0.0.tgz",
+      "integrity": "sha512-37qirFDz8cA5fimp9feo43fSuRo2gHwaIn6dXL8Ber1dGwUosDrGZeCCXq57WnIqE4aQ+u3eQZzsk1yOzhdwag==",
+      "dev": true,
+      "requires": {
+        "arrify": "^1.0.1",
+        "path-type": "^3.0.0"
+      }
+    },
+    "domain-browser": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/domain-browser/-/domain-browser-1.2.0.tgz",
+      "integrity": "sha512-jnjyiM6eRyZl2H+W8Q/zLMA481hzi0eszAaBUzIVnmYVDBbnLxVNnfu1HgEBvCbL+71FrxMl3E6lpKH7Ge3OXA==",
+      "dev": true
+    },
+    "duplexify": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/duplexify/-/duplexify-3.6.0.tgz",
+      "integrity": "sha512-fO3Di4tBKJpYTFHAxTU00BcfWMY9w24r/x21a6rZRbsD/ToUgGxsMbiGRmB7uVAXeGKXD9MwiLZa5E97EVgIRQ==",
+      "dev": true,
+      "requires": {
+        "end-of-stream": "^1.0.0",
+        "inherits": "^2.0.1",
+        "readable-stream": "^2.0.0",
+        "stream-shift": "^1.0.0"
+      }
+    },
+    "electron-to-chromium": {
+      "version": "1.3.51",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.3.51.tgz",
+      "integrity": "sha1-akK0nar38ipbN7mR2vlJ8029ubU=",
+      "dev": true
+    },
+    "elliptic": {
+      "version": "6.4.0",
+      "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.4.0.tgz",
+      "integrity": "sha1-ysmvh2LIWDYYcAPI3+GT5eLq5d8=",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.4.0",
+        "brorand": "^1.0.1",
+        "hash.js": "^1.0.0",
+        "hmac-drbg": "^1.0.0",
+        "inherits": "^2.0.1",
+        "minimalistic-assert": "^1.0.0",
+        "minimalistic-crypto-utils": "^1.0.0"
+      }
+    },
+    "emojis-list": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/emojis-list/-/emojis-list-2.1.0.tgz",
+      "integrity": "sha1-TapNnbAPmBmIDHn6RXrlsJof04k=",
+      "dev": true
+    },
+    "end-of-stream": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/end-of-stream/-/end-of-stream-1.4.1.tgz",
+      "integrity": "sha512-1MkrZNvWTKCaigbn+W15elq2BB/L22nqrSY5DKlo3X6+vclJm8Bb5djXJBmEX6fS3+zCh/F4VBK5Z2KxJt4s2Q==",
+      "dev": true,
+      "requires": {
+        "once": "^1.4.0"
+      }
+    },
+    "enhanced-resolve": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-4.1.0.tgz",
+      "integrity": "sha512-F/7vkyTtyc/llOIn8oWclcB25KdRaiPBpZYDgJHgh/UHtpgT2p2eldQgtQnLtUvfMKPKxbRaQM/hHkvLHt1Vng==",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "memory-fs": "^0.4.0",
+        "tapable": "^1.0.0"
+      }
+    },
+    "errno": {
+      "version": "0.1.7",
+      "resolved": "https://registry.npmjs.org/errno/-/errno-0.1.7.tgz",
+      "integrity": "sha512-MfrRBDWzIWifgq6tJj60gkAwtLNb6sQPlcFrSOflcP1aFmmruKQ2wRnze/8V6kgyz7H3FF8Npzv78mZ7XLLflg==",
+      "dev": true,
+      "requires": {
+        "prr": "~1.0.1"
+      }
+    },
+    "es5-ext": {
+      "version": "0.10.45",
+      "resolved": "https://registry.npmjs.org/es5-ext/-/es5-ext-0.10.45.tgz",
+      "integrity": "sha512-FkfM6Vxxfmztilbxxz5UKSD4ICMf5tSpRFtDNtkAhOxZ0EKtX6qwmXNyH/sFyIbX2P/nU5AMiA9jilWsUGJzCQ==",
+      "dev": true,
+      "requires": {
+        "es6-iterator": "~2.0.3",
+        "es6-symbol": "~3.1.1",
+        "next-tick": "1"
+      }
+    },
+    "es6-iterator": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/es6-iterator/-/es6-iterator-2.0.3.tgz",
+      "integrity": "sha1-p96IkUGgWpSwhUQDstCg+/qY87c=",
+      "dev": true,
+      "requires": {
+        "d": "1",
+        "es5-ext": "^0.10.35",
+        "es6-symbol": "^3.1.1"
+      }
+    },
+    "es6-symbol": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/es6-symbol/-/es6-symbol-3.1.1.tgz",
+      "integrity": "sha1-vwDvT9q2uhtG7Le2KbTH7VcVzHc=",
+      "dev": true,
+      "requires": {
+        "d": "1",
+        "es5-ext": "~0.10.14"
+      }
+    },
+    "escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=",
+      "dev": true
+    },
+    "escodegen": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-1.8.1.tgz",
+      "integrity": "sha1-WltTr0aTEQvrsIZ6o0MN07cKEBg=",
+      "dev": true,
+      "requires": {
+        "esprima": "^2.7.1",
+        "estraverse": "^1.9.1",
+        "esutils": "^2.0.2",
+        "optionator": "^0.8.1",
+        "source-map": "~0.2.0"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.2.0",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.2.0.tgz",
+          "integrity": "sha1-2rc/vPwrqBm03gO9b26qSBZLP50=",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "amdefine": ">=0.0.4"
+          }
+        }
+      }
+    },
+    "eslint-scope": {
+      "version": "3.7.1",
+      "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-3.7.1.tgz",
+      "integrity": "sha1-PWPD7f2gLgbgGkUq2IyqzHzctug=",
+      "dev": true,
+      "requires": {
+        "esrecurse": "^4.1.0",
+        "estraverse": "^4.1.1"
+      },
+      "dependencies": {
+        "estraverse": {
+          "version": "4.2.0",
+          "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.2.0.tgz",
+          "integrity": "sha1-De4/7TH81GlhjOc0IJn8GvoL2xM=",
+          "dev": true
+        }
+      }
+    },
+    "esprima": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz",
+      "integrity": "sha1-luO3DVd59q1JzQMmc9HDEnZ7pYE=",
+      "dev": true
+    },
+    "esrecurse": {
+      "version": "4.2.1",
+      "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.2.1.tgz",
+      "integrity": "sha512-64RBB++fIOAXPw3P9cy89qfMlvZEXZkqqJkjqqXIvzP5ezRZjW+lPWjw35UX/3EhUPFYbg5ER4JYgDw4007/DQ==",
+      "dev": true,
+      "requires": {
+        "estraverse": "^4.1.0"
+      },
+      "dependencies": {
+        "estraverse": {
+          "version": "4.2.0",
+          "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.2.0.tgz",
+          "integrity": "sha1-De4/7TH81GlhjOc0IJn8GvoL2xM=",
+          "dev": true
+        }
+      }
+    },
+    "estraverse": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-1.9.3.tgz",
+      "integrity": "sha1-r2fy3JIlgkFZUJJgkaQAXSnJu0Q=",
+      "dev": true
+    },
+    "esutils": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.2.tgz",
+      "integrity": "sha1-Cr9PHKpbyx96nYrMbepPqqBLrJs=",
+      "dev": true
+    },
+    "events": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/events/-/events-1.1.1.tgz",
+      "integrity": "sha1-nr23Y1rQmccNzEwqH1AEKI6L2SQ=",
+      "dev": true
+    },
+    "evp_bytestokey": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
+      "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
+      "dev": true,
+      "requires": {
+        "md5.js": "^1.3.4",
+        "safe-buffer": "^5.1.1"
+      }
+    },
+    "execa": {
+      "version": "0.7.0",
+      "resolved": "https://registry.npmjs.org/execa/-/execa-0.7.0.tgz",
+      "integrity": "sha1-lEvs00zEHuMqY6n68nrVpl/Fl3c=",
+      "dev": true,
+      "requires": {
+        "cross-spawn": "^5.0.1",
+        "get-stream": "^3.0.0",
+        "is-stream": "^1.1.0",
+        "npm-run-path": "^2.0.0",
+        "p-finally": "^1.0.0",
+        "signal-exit": "^3.0.0",
+        "strip-eof": "^1.0.0"
+      },
+      "dependencies": {
+        "cross-spawn": {
+          "version": "5.1.0",
+          "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-5.1.0.tgz",
+          "integrity": "sha1-6L0O/uWPz/b4+UUQoKVUu/ojVEk=",
+          "dev": true,
+          "requires": {
+            "lru-cache": "^4.0.1",
+            "shebang-command": "^1.2.0",
+            "which": "^1.2.9"
+          }
+        }
+      }
+    },
+    "expand-brackets": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/expand-brackets/-/expand-brackets-2.1.4.tgz",
+      "integrity": "sha1-t3c14xXOMPa27/D4OwQVGiJEliI=",
+      "dev": true,
+      "requires": {
+        "debug": "^2.3.3",
+        "define-property": "^0.2.5",
+        "extend-shallow": "^2.0.1",
+        "posix-character-classes": "^0.1.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        },
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "extend-shallow": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-3.0.2.tgz",
+      "integrity": "sha1-Jqcarwc7OfshJxcnRhMcJwQCjbg=",
+      "dev": true,
+      "requires": {
+        "assign-symbols": "^1.0.0",
+        "is-extendable": "^1.0.1"
+      },
+      "dependencies": {
+        "is-extendable": {
+          "version": "1.0.1",
+          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
+          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
+          "dev": true,
+          "requires": {
+            "is-plain-object": "^2.0.4"
+          }
+        }
+      }
+    },
+    "external-editor": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/external-editor/-/external-editor-3.0.0.tgz",
+      "integrity": "sha512-mpkfj0FEdxrIhOC04zk85X7StNtr0yXnG7zCb+8ikO8OJi2jsHh5YGoknNTyXgsbHOf1WOOcVU3kPFWT2WgCkQ==",
+      "dev": true,
+      "requires": {
+        "chardet": "^0.5.0",
+        "iconv-lite": "^0.4.22",
+        "tmp": "^0.0.33"
+      }
+    },
+    "extglob": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/extglob/-/extglob-2.0.4.tgz",
+      "integrity": "sha512-Nmb6QXkELsuBr24CJSkilo6UHHgbekK5UiZgfE6UHD3Eb27YC6oD+bhcT+tJ6cl8dmsgdQxnWlcry8ksBIBLpw==",
+      "dev": true,
+      "requires": {
+        "array-unique": "^0.3.2",
+        "define-property": "^1.0.0",
+        "expand-brackets": "^2.1.4",
+        "extend-shallow": "^2.0.1",
+        "fragment-cache": "^0.2.1",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
+        },
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        },
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "dev": true,
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        },
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "fast-deep-equal": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-2.0.1.tgz",
+      "integrity": "sha1-ewUhjd+WZ79/Nwv3/bLLFf3Qqkk=",
+      "dev": true
+    },
+    "fast-json-stable-stringify": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.0.0.tgz",
+      "integrity": "sha1-1RQsDK7msRifh9OnYREGT4bIu/I=",
+      "dev": true
+    },
+    "fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha1-PYpcZog6FqMMqGQ+hR8Zuqd5eRc=",
+      "dev": true
+    },
+    "fastparse": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/fastparse/-/fastparse-1.1.1.tgz",
+      "integrity": "sha1-0eJkOzipTXWDtHkGDmxK/8lAcfg=",
+      "dev": true
+    },
+    "figures": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/figures/-/figures-2.0.0.tgz",
+      "integrity": "sha1-OrGi0qYsi/tDGgyUy3l6L84nyWI=",
+      "dev": true,
+      "requires": {
+        "escape-string-regexp": "^1.0.5"
+      }
+    },
+    "file-loader": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-1.1.11.tgz",
+      "integrity": "sha512-TGR4HU7HUsGg6GCOPJnFk06RhWgEWFLAGWiT6rcD+GRC2keU3s9RGJ+b3Z6/U73jwwNb2gKLJ7YCrp+jvU4ALg==",
+      "dev": true,
+      "requires": {
+        "loader-utils": "^1.0.2",
+        "schema-utils": "^0.4.5"
+      }
+    },
+    "fill-range": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-4.0.0.tgz",
+      "integrity": "sha1-1USBHUKPmOsGpj3EAtJAPDKMOPc=",
+      "dev": true,
+      "requires": {
+        "extend-shallow": "^2.0.1",
+        "is-number": "^3.0.0",
+        "repeat-string": "^1.6.1",
+        "to-regex-range": "^2.1.0"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "find-cache-dir": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/find-cache-dir/-/find-cache-dir-1.0.0.tgz",
+      "integrity": "sha1-kojj6ePMN0hxfTnq3hfPcfww7m8=",
+      "dev": true,
+      "requires": {
+        "commondir": "^1.0.1",
+        "make-dir": "^1.0.0",
+        "pkg-dir": "^2.0.0"
+      }
+    },
+    "find-up": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz",
+      "integrity": "sha1-RdG35QbHF93UgndaK3eSCjwMV6c=",
+      "dev": true,
+      "requires": {
+        "locate-path": "^2.0.0"
+      }
+    },
+    "flatten": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/flatten/-/flatten-1.0.2.tgz",
+      "integrity": "sha1-2uRqnXj74lKSJYzB54CkHZXAN4I=",
+      "dev": true
+    },
+    "flush-write-stream": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/flush-write-stream/-/flush-write-stream-1.0.3.tgz",
+      "integrity": "sha512-calZMC10u0FMUqoiunI2AiGIIUtUIvifNwkHhNupZH4cbNnW1Itkoh/Nf5HFYmDrwWPjrUxpkZT0KhuCq0jmGw==",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "readable-stream": "^2.0.4"
+      }
+    },
+    "for-in": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/for-in/-/for-in-1.0.2.tgz",
+      "integrity": "sha1-gQaNKVqBQuwKxybG4iAMMPttXoA=",
+      "dev": true
+    },
+    "foreach": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/foreach/-/foreach-2.0.5.tgz",
+      "integrity": "sha1-C+4AUBiusmDQo6865ljdATbsG5k=",
+      "dev": true
+    },
+    "fragment-cache": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz",
+      "integrity": "sha1-QpD60n8T6Jvn8zeZxrxaCr//DRk=",
+      "dev": true,
+      "requires": {
+        "map-cache": "^0.2.2"
+      }
+    },
+    "from2": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/from2/-/from2-2.3.0.tgz",
+      "integrity": "sha1-i/tVAr3kpNNs/e6gB/zKIdfjgq8=",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "readable-stream": "^2.0.0"
+      }
+    },
+    "fs-extra": {
+      "version": "0.30.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-0.30.0.tgz",
+      "integrity": "sha1-8jP/zAjU2n1DLapEl3aYnbHfk/A=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^2.1.0",
+        "klaw": "^1.0.0",
+        "path-is-absolute": "^1.0.0",
+        "rimraf": "^2.2.8"
+      }
+    },
+    "fs-write-stream-atomic": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/fs-write-stream-atomic/-/fs-write-stream-atomic-1.0.10.tgz",
+      "integrity": "sha1-tH31NJPvkR33VzHnCp3tAYnbQMk=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "iferr": "^0.1.5",
+        "imurmurhash": "^0.1.4",
+        "readable-stream": "1 || 2"
+      }
+    },
+    "fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=",
+      "dev": true
+    },
+    "fsevents": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-1.2.4.tgz",
+      "integrity": "sha512-z8H8/diyk76B7q5wg+Ud0+CqzcAF3mBBI/bA5ne5zrRUUIvNkJY//D3BqyH571KuAC4Nr7Rw7CjWX4r0y9DvNg==",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "nan": "^2.9.2",
+        "node-pre-gyp": "^0.10.0"
+      },
+      "dependencies": {
+        "abbrev": {
+          "version": "1.1.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "ansi-regex": {
+          "version": "2.1.1",
+          "bundled": true,
+          "dev": true
+        },
+        "aproba": {
+          "version": "1.2.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "are-we-there-yet": {
+          "version": "1.1.4",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "delegates": "^1.0.0",
+            "readable-stream": "^2.0.6"
+          }
+        },
+        "balanced-match": {
+          "version": "1.0.0",
+          "bundled": true,
+          "dev": true
+        },
+        "brace-expansion": {
+          "version": "1.1.11",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "balanced-match": "^1.0.0",
+            "concat-map": "0.0.1"
+          }
+        },
+        "chownr": {
+          "version": "1.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "code-point-at": {
+          "version": "1.1.0",
+          "bundled": true,
+          "dev": true
+        },
+        "concat-map": {
+          "version": "0.0.1",
+          "bundled": true,
+          "dev": true
+        },
+        "console-control-strings": {
+          "version": "1.1.0",
+          "bundled": true,
+          "dev": true
+        },
+        "core-util-is": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "debug": {
+          "version": "2.6.9",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "deep-extend": {
+          "version": "0.5.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "delegates": {
+          "version": "1.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "detect-libc": {
+          "version": "1.0.3",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "fs-minipass": {
+          "version": "1.2.5",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "minipass": "^2.2.1"
+          }
+        },
+        "fs.realpath": {
+          "version": "1.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "gauge": {
+          "version": "2.7.4",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "aproba": "^1.0.3",
+            "console-control-strings": "^1.0.0",
+            "has-unicode": "^2.0.0",
+            "object-assign": "^4.1.0",
+            "signal-exit": "^3.0.0",
+            "string-width": "^1.0.1",
+            "strip-ansi": "^3.0.1",
+            "wide-align": "^1.1.0"
+          }
+        },
+        "glob": {
+          "version": "7.1.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        },
+        "has-unicode": {
+          "version": "2.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "iconv-lite": {
+          "version": "0.4.21",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "safer-buffer": "^2.1.0"
+          }
+        },
+        "ignore-walk": {
+          "version": "3.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "minimatch": "^3.0.4"
+          }
+        },
+        "inflight": {
+          "version": "1.0.6",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "once": "^1.3.0",
+            "wrappy": "1"
+          }
+        },
+        "inherits": {
+          "version": "2.0.3",
+          "bundled": true,
+          "dev": true
+        },
+        "ini": {
+          "version": "1.3.5",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "is-fullwidth-code-point": {
+          "version": "1.0.0",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "number-is-nan": "^1.0.0"
+          }
+        },
+        "isarray": {
+          "version": "1.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "minimatch": {
+          "version": "3.0.4",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "brace-expansion": "^1.1.7"
+          }
+        },
+        "minimist": {
+          "version": "0.0.8",
+          "bundled": true,
+          "dev": true
+        },
+        "minipass": {
+          "version": "2.2.4",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "safe-buffer": "^5.1.1",
+            "yallist": "^3.0.0"
+          }
+        },
+        "minizlib": {
+          "version": "1.1.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "minipass": "^2.2.1"
+          }
+        },
+        "mkdirp": {
+          "version": "0.5.1",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "minimist": "0.0.8"
+          }
+        },
+        "ms": {
+          "version": "2.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "needle": {
+          "version": "2.2.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "debug": "^2.1.2",
+            "iconv-lite": "^0.4.4",
+            "sax": "^1.2.4"
+          }
+        },
+        "node-pre-gyp": {
+          "version": "0.10.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "detect-libc": "^1.0.2",
+            "mkdirp": "^0.5.1",
+            "needle": "^2.2.0",
+            "nopt": "^4.0.1",
+            "npm-packlist": "^1.1.6",
+            "npmlog": "^4.0.2",
+            "rc": "^1.1.7",
+            "rimraf": "^2.6.1",
+            "semver": "^5.3.0",
+            "tar": "^4"
+          }
+        },
+        "nopt": {
+          "version": "4.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "abbrev": "1",
+            "osenv": "^0.1.4"
+          }
+        },
+        "npm-bundled": {
+          "version": "1.0.3",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "npm-packlist": {
+          "version": "1.1.10",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "ignore-walk": "^3.0.1",
+            "npm-bundled": "^1.0.1"
+          }
+        },
+        "npmlog": {
+          "version": "4.1.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "are-we-there-yet": "~1.1.2",
+            "console-control-strings": "~1.1.0",
+            "gauge": "~2.7.3",
+            "set-blocking": "~2.0.0"
+          }
+        },
+        "number-is-nan": {
+          "version": "1.0.1",
+          "bundled": true,
+          "dev": true
+        },
+        "object-assign": {
+          "version": "4.1.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "once": {
+          "version": "1.4.0",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "wrappy": "1"
+          }
+        },
+        "os-homedir": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "os-tmpdir": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "osenv": {
+          "version": "0.1.5",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "os-homedir": "^1.0.0",
+            "os-tmpdir": "^1.0.0"
+          }
+        },
+        "path-is-absolute": {
+          "version": "1.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "process-nextick-args": {
+          "version": "2.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "rc": {
+          "version": "1.2.7",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "deep-extend": "^0.5.1",
+            "ini": "~1.3.0",
+            "minimist": "^1.2.0",
+            "strip-json-comments": "~2.0.1"
+          },
+          "dependencies": {
+            "minimist": {
+              "version": "1.2.0",
+              "bundled": true,
+              "dev": true,
+              "optional": true
+            }
+          }
+        },
+        "readable-stream": {
+          "version": "2.3.6",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "core-util-is": "~1.0.0",
+            "inherits": "~2.0.3",
+            "isarray": "~1.0.0",
+            "process-nextick-args": "~2.0.0",
+            "safe-buffer": "~5.1.1",
+            "string_decoder": "~1.1.1",
+            "util-deprecate": "~1.0.1"
+          }
+        },
+        "rimraf": {
+          "version": "2.6.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "glob": "^7.0.5"
+          }
+        },
+        "safe-buffer": {
+          "version": "5.1.1",
+          "bundled": true,
+          "dev": true
+        },
+        "safer-buffer": {
+          "version": "2.1.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "sax": {
+          "version": "1.2.4",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "semver": {
+          "version": "5.5.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "set-blocking": {
+          "version": "2.0.0",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "signal-exit": {
+          "version": "3.0.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "string-width": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "code-point-at": "^1.0.0",
+            "is-fullwidth-code-point": "^1.0.0",
+            "strip-ansi": "^3.0.0"
+          }
+        },
+        "string_decoder": {
+          "version": "1.1.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "safe-buffer": "~5.1.0"
+          }
+        },
+        "strip-ansi": {
+          "version": "3.0.1",
+          "bundled": true,
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^2.0.0"
+          }
+        },
+        "strip-json-comments": {
+          "version": "2.0.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "tar": {
+          "version": "4.4.1",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "chownr": "^1.0.1",
+            "fs-minipass": "^1.2.5",
+            "minipass": "^2.2.4",
+            "minizlib": "^1.1.0",
+            "mkdirp": "^0.5.0",
+            "safe-buffer": "^5.1.1",
+            "yallist": "^3.0.2"
+          }
+        },
+        "util-deprecate": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true
+        },
+        "wide-align": {
+          "version": "1.1.2",
+          "bundled": true,
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "string-width": "^1.0.2"
+          }
+        },
+        "wrappy": {
+          "version": "1.0.2",
+          "bundled": true,
+          "dev": true
+        },
+        "yallist": {
+          "version": "3.0.2",
+          "bundled": true,
+          "dev": true
+        }
+      }
+    },
+    "function-bind": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.1.tgz",
+      "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==",
+      "dev": true
+    },
+    "generic-names": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/generic-names/-/generic-names-1.0.3.tgz",
+      "integrity": "sha1-LXhqEhruUIh2eWk56OO/+DbCCRc=",
+      "dev": true,
+      "requires": {
+        "loader-utils": "^0.2.16"
+      },
+      "dependencies": {
+        "loader-utils": {
+          "version": "0.2.17",
+          "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-0.2.17.tgz",
+          "integrity": "sha1-+G5jdNQyBabmxg6RlvF8Apm/s0g=",
+          "dev": true,
+          "requires": {
+            "big.js": "^3.1.3",
+            "emojis-list": "^2.0.0",
+            "json5": "^0.5.0",
+            "object-assign": "^4.0.1"
+          }
+        }
+      }
+    },
+    "get-caller-file": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-1.0.2.tgz",
+      "integrity": "sha1-9wLmMSfn4jHBYKgMFVSstw1QR+U=",
+      "dev": true
+    },
+    "get-stream": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-3.0.0.tgz",
+      "integrity": "sha1-jpQ9E1jcN1VQVOy+LtsFqhdO3hQ=",
+      "dev": true
+    },
+    "get-value": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/get-value/-/get-value-2.0.6.tgz",
+      "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg=",
+      "dev": true
+    },
+    "glob": {
+      "version": "5.0.15",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
+      "integrity": "sha1-G8k2ueAvSmA/zCIuz3Yz0wuLk7E=",
+      "dev": true,
+      "requires": {
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "2 || 3",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      }
+    },
+    "glob-parent": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-3.1.0.tgz",
+      "integrity": "sha1-nmr2KZ2NO9K9QEMIMr0RPfkGxa4=",
+      "dev": true,
+      "requires": {
+        "is-glob": "^3.1.0",
+        "path-dirname": "^1.0.0"
+      },
+      "dependencies": {
+        "is-glob": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-3.1.0.tgz",
+          "integrity": "sha1-e6WuJCF4BKxwcHuWkiVnSGzD6Eo=",
+          "dev": true,
+          "requires": {
+            "is-extglob": "^2.1.0"
+          }
+        }
+      }
+    },
+    "glob-to-regexp": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.3.0.tgz",
+      "integrity": "sha1-jFoUlNIGbFcMw7/kSWF1rMTVAqs=",
+      "dev": true
+    },
+    "global-modules-path": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/global-modules-path/-/global-modules-path-2.1.0.tgz",
+      "integrity": "sha512-3DrmGj2TP+96cABk9TfMp6f3knH/Y46dqvWznTU3Tf6/bDGLDAn15tFluQ7BcloykOcdY16U0WGq0BQblYOxJQ==",
+      "dev": true
+    },
+    "globals": {
+      "version": "9.18.0",
+      "resolved": "https://registry.npmjs.org/globals/-/globals-9.18.0.tgz",
+      "integrity": "sha512-S0nG3CLEQiY/ILxqtztTWH/3iRRdyBLw6KMDxnKMchrtbj2OFmehVh0WUCfW3DUrIgx/qFrJPICrq4Z4sTR9UQ==",
+      "dev": true
+    },
+    "globby": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/globby/-/globby-7.1.1.tgz",
+      "integrity": "sha1-+yzP+UAfhgCUXfral0QMypcrhoA=",
+      "dev": true,
+      "requires": {
+        "array-union": "^1.0.1",
+        "dir-glob": "^2.0.0",
+        "glob": "^7.1.2",
+        "ignore": "^3.3.5",
+        "pify": "^3.0.0",
+        "slash": "^1.0.0"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "7.1.2",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
+          "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+          "dev": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        }
+      }
+    },
+    "graceful-fs": {
+      "version": "4.1.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.1.11.tgz",
+      "integrity": "sha1-Dovf5NHduIVNZOBOp8AOKgJuVlg=",
+      "dev": true
+    },
+    "handlebars": {
+      "version": "4.0.11",
+      "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.11.tgz",
+      "integrity": "sha1-Ywo13+ApS8KB7a5v/F0yn8eYLcw=",
+      "dev": true,
+      "requires": {
+        "async": "^1.4.0",
+        "optimist": "^0.6.1",
+        "source-map": "^0.4.4",
+        "uglify-js": "^2.6"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.4.4",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.4.4.tgz",
+          "integrity": "sha1-66T12pwNyZneaAMti092FzZSA2s=",
+          "dev": true,
+          "requires": {
+            "amdefine": ">=0.0.4"
+          }
+        }
+      }
+    },
+    "has": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz",
+      "integrity": "sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==",
+      "dev": true,
+      "requires": {
+        "function-bind": "^1.1.1"
+      }
+    },
+    "has-ansi": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/has-ansi/-/has-ansi-2.0.0.tgz",
+      "integrity": "sha1-NPUEnOHs3ysGSa8+8k5F7TVBbZE=",
+      "dev": true,
+      "requires": {
+        "ansi-regex": "^2.0.0"
+      }
+    },
+    "has-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz",
+      "integrity": "sha1-nZ55MWXOAXoA8AQYxD+UKnsdEfo=",
+      "dev": true
+    },
+    "has-symbols": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.0.0.tgz",
+      "integrity": "sha1-uhqPGvKg/DllD1yFA2dwQSIGO0Q=",
+      "dev": true
+    },
+    "has-value": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-value/-/has-value-1.0.0.tgz",
+      "integrity": "sha1-GLKB2lhbHFxR3vJMkw7SmgvmsXc=",
+      "dev": true,
+      "requires": {
+        "get-value": "^2.0.6",
+        "has-values": "^1.0.0",
+        "isobject": "^3.0.0"
+      }
+    },
+    "has-values": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-values/-/has-values-1.0.0.tgz",
+      "integrity": "sha1-lbC2P+whRmGab+V/51Yo1aOe/k8=",
+      "dev": true,
+      "requires": {
+        "is-number": "^3.0.0",
+        "kind-of": "^4.0.0"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-4.0.0.tgz",
+          "integrity": "sha1-IIE989cSkosgc3hpGkUGb65y3Vc=",
+          "dev": true,
+          "requires": {
+            "is-buffer": "^1.1.5"
+          }
+        }
+      }
+    },
+    "hash-base": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.0.4.tgz",
+      "integrity": "sha1-X8hoaEfs1zSZQDMZprCj8/auSRg=",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "hash.js": {
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.5.tgz",
+      "integrity": "sha512-eWI5HG9Np+eHV1KQhisXWwM+4EPPYe5dFX1UZZH7k/E3JzDEazVH+VGlZi6R94ZqImq+A3D1mCEtrFIfg/E7sA==",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.3",
+        "minimalistic-assert": "^1.0.1"
+      }
+    },
+    "hmac-drbg": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
+      "integrity": "sha1-0nRXAQJabHdabFRXk+1QL8DGSaE=",
+      "dev": true,
+      "requires": {
+        "hash.js": "^1.0.3",
+        "minimalistic-assert": "^1.0.0",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "home-or-tmp": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/home-or-tmp/-/home-or-tmp-2.0.0.tgz",
+      "integrity": "sha1-42w/LSyufXRqhX440Y1fMqeILbg=",
+      "dev": true,
+      "requires": {
+        "os-homedir": "^1.0.0",
+        "os-tmpdir": "^1.0.1"
+      }
+    },
+    "html-comment-regex": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/html-comment-regex/-/html-comment-regex-1.1.1.tgz",
+      "integrity": "sha1-ZouTd26q5V696POtRkswekljYl4=",
+      "dev": true
+    },
+    "https-browserify": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/https-browserify/-/https-browserify-1.0.0.tgz",
+      "integrity": "sha1-7AbBDgo0wPL68Zn3/X/Hj//QPHM=",
+      "dev": true
+    },
+    "iconv-lite": {
+      "version": "0.4.23",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.23.tgz",
+      "integrity": "sha512-neyTUVFtahjf0mB3dZT77u+8O0QB89jFdnBkd5P1JgYPbPaia3gXXOVL2fq8VyU2gMMD7SaN7QukTB/pmXYvDA==",
+      "dev": true,
+      "requires": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      }
+    },
+    "icss-replace-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/icss-replace-symbols/-/icss-replace-symbols-1.1.0.tgz",
+      "integrity": "sha1-Bupvg2ead0njhs/h/oEq5dsiPe0=",
+      "dev": true
+    },
+    "icss-utils": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/icss-utils/-/icss-utils-3.0.1.tgz",
+      "integrity": "sha1-7nDTroysOMa+XtkehRsn7tNDrQ8=",
+      "dev": true,
+      "requires": {
+        "postcss": "^6.0.2"
+      }
+    },
+    "ieee754": {
+      "version": "1.1.12",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.1.12.tgz",
+      "integrity": "sha512-GguP+DRY+pJ3soyIiGPTvdiVXjZ+DbXOxGpXn3eMvNW4x4irjqXm4wHKscC+TfxSJ0yw/S1F24tqdMNsMZTiLA==",
+      "dev": true
+    },
+    "iferr": {
+      "version": "0.1.5",
+      "resolved": "https://registry.npmjs.org/iferr/-/iferr-0.1.5.tgz",
+      "integrity": "sha1-xg7taebY/bazEEofy8ocGS3FtQE=",
+      "dev": true
+    },
+    "ignore": {
+      "version": "3.3.10",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-3.3.10.tgz",
+      "integrity": "sha512-Pgs951kaMm5GXP7MOvxERINe3gsaVjUWFm+UZPSq9xYriQAksyhg0csnS0KXSNRD5NmNdapXEpjxG49+AKh/ug==",
+      "dev": true
+    },
+    "import-local": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/import-local/-/import-local-1.0.0.tgz",
+      "integrity": "sha512-vAaZHieK9qjGo58agRBg+bhHX3hoTZU/Oa3GESWLz7t1U62fk63aHuDJJEteXoDeTCcPmUT+z38gkHPZkkmpmQ==",
+      "dev": true,
+      "requires": {
+        "pkg-dir": "^2.0.0",
+        "resolve-cwd": "^2.0.0"
+      }
+    },
+    "imports-loader": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/imports-loader/-/imports-loader-0.8.0.tgz",
+      "integrity": "sha512-kXWL7Scp8KQ4552ZcdVTeaQCZSLW+e6nJfp3cwUMB673T7Hr98Xjx5JK+ql7ADlJUvj1JS5O01RLbKoutN5QDQ==",
+      "dev": true,
+      "requires": {
+        "loader-utils": "^1.0.2",
+        "source-map": "^0.6.1"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.6.1",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+          "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+          "dev": true
+        }
+      }
+    },
+    "imurmurhash": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz",
+      "integrity": "sha1-khi5srkoojixPcT7a21XbyMUU+o=",
+      "dev": true
+    },
+    "indexes-of": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/indexes-of/-/indexes-of-1.0.1.tgz",
+      "integrity": "sha1-8w9xbI4r00bHtn0985FVZqfAVgc=",
+      "dev": true
+    },
+    "indexof": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/indexof/-/indexof-0.0.1.tgz",
+      "integrity": "sha1-gtwzbSMrkGIXnQWrMpOmYFn9Q10=",
+      "dev": true
+    },
+    "inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=",
+      "dev": true,
+      "requires": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "inherits": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
+      "integrity": "sha1-Yzwsg+PaQqUC9SRmAiSA9CCCYd4=",
+      "dev": true
+    },
+    "inquirer": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-6.0.0.tgz",
+      "integrity": "sha512-tISQWRwtcAgrz+SHPhTH7d3e73k31gsOy6i1csonLc0u1dVK/wYvuOnFeiWqC5OXFIYbmrIFInef31wbT8MEJg==",
+      "dev": true,
+      "requires": {
+        "ansi-escapes": "^3.0.0",
+        "chalk": "^2.0.0",
+        "cli-cursor": "^2.1.0",
+        "cli-width": "^2.0.0",
+        "external-editor": "^3.0.0",
+        "figures": "^2.0.0",
+        "lodash": "^4.3.0",
+        "mute-stream": "0.0.7",
+        "run-async": "^2.2.0",
+        "rxjs": "^6.1.0",
+        "string-width": "^2.1.0",
+        "strip-ansi": "^4.0.0",
+        "through": "^2.3.6"
+      },
+      "dependencies": {
+        "ansi-regex": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz",
+          "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=",
+          "dev": true
+        },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
+          "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          }
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "interpret": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/interpret/-/interpret-1.1.0.tgz",
+      "integrity": "sha1-ftGxQQxqDg94z5XTuEQMY/eLhhQ=",
+      "dev": true
+    },
+    "invariant": {
+      "version": "2.2.4",
+      "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",
+      "integrity": "sha512-phJfQVBuaJM5raOpJjSfkiD6BpbCE4Ns//LaXl6wGYtUBY83nWS6Rf9tXm2e8VaK60JEjYldbPif/A2B1C2gNA==",
+      "dev": true,
+      "requires": {
+        "loose-envify": "^1.0.0"
+      }
+    },
+    "invert-kv": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/invert-kv/-/invert-kv-1.0.0.tgz",
+      "integrity": "sha1-EEqOSqym09jNFXqO+L+rLXo//bY=",
+      "dev": true
+    },
+    "is-absolute-url": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-absolute-url/-/is-absolute-url-2.1.0.tgz",
+      "integrity": "sha1-UFMN+4T8yap9vnhS6Do3uTufKqY=",
+      "dev": true
+    },
+    "is-accessor-descriptor": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-0.1.6.tgz",
+      "integrity": "sha1-qeEss66Nh2cn7u84Q/igiXtcmNY=",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.0.2"
+      }
+    },
+    "is-binary-path": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-1.0.1.tgz",
+      "integrity": "sha1-dfFmQrSA8YenEcgUFh/TpKdlWJg=",
+      "dev": true,
+      "requires": {
+        "binary-extensions": "^1.0.0"
+      }
+    },
+    "is-buffer": {
+      "version": "1.1.6",
+      "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-1.1.6.tgz",
+      "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
+      "dev": true
+    },
+    "is-data-descriptor": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz",
+      "integrity": "sha1-C17mSDiOLIYCgueT8YVv7D8wG1Y=",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.0.2"
+      }
+    },
+    "is-descriptor": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz",
+      "integrity": "sha512-avDYr0SB3DwO9zsMov0gKCESFYqCnE4hq/4z3TdUlukEy5t9C0YRq7HLrsN52NAcqXKaepeCD0n+B0arnVG3Hg==",
+      "dev": true,
+      "requires": {
+        "is-accessor-descriptor": "^0.1.6",
+        "is-data-descriptor": "^0.1.4",
+        "kind-of": "^5.0.0"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "5.1.0",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-5.1.0.tgz",
+          "integrity": "sha512-NGEErnH6F2vUuXDh+OlbcKW7/wOcfdRHaZ7VWtqCztfHri/++YKmP51OdWeGPuqCOba6kk2OTe5d02VmTB80Pw==",
+          "dev": true
+        }
+      }
+    },
+    "is-extendable": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
+      "integrity": "sha1-YrEQ4omkcUGOPsNqYX1HLjAd/Ik=",
+      "dev": true
+    },
+    "is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha1-qIwCU1eR8C7TfHahueqXc8gz+MI=",
+      "dev": true
+    },
+    "is-finite": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz",
+      "integrity": "sha1-zGZ3aVYCvlUO8R6LSqYwU0K20Ko=",
+      "dev": true,
+      "requires": {
+        "number-is-nan": "^1.0.0"
+      }
+    },
+    "is-fullwidth-code-point": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-2.0.0.tgz",
+      "integrity": "sha1-o7MKXE8ZkYMWeqq5O+764937ZU8=",
+      "dev": true
+    },
+    "is-glob": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.0.tgz",
+      "integrity": "sha1-lSHHaEXMJhCoUgPd8ICpWML/q8A=",
+      "dev": true,
+      "requires": {
+        "is-extglob": "^2.1.1"
+      }
+    },
+    "is-number": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-3.0.0.tgz",
+      "integrity": "sha1-JP1iAaR4LPUFYcgQJ2r8fRLXEZU=",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.0.2"
+      }
+    },
+    "is-plain-obj": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz",
+      "integrity": "sha1-caUMhCnfync8kqOQpKA7OfzVHT4=",
+      "dev": true
+    },
+    "is-plain-object": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/is-plain-object/-/is-plain-object-2.0.4.tgz",
+      "integrity": "sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og==",
+      "dev": true,
+      "requires": {
+        "isobject": "^3.0.1"
+      }
+    },
+    "is-promise": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-2.1.0.tgz",
+      "integrity": "sha1-eaKp7OfwlugPNtKy87wWwf9L8/o=",
+      "dev": true
+    },
+    "is-stream": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-1.1.0.tgz",
+      "integrity": "sha1-EtSj3U5o4Lec6428hBc66A2RykQ=",
+      "dev": true
+    },
+    "is-svg": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-svg/-/is-svg-2.1.0.tgz",
+      "integrity": "sha1-z2EJDaDZ77yrhyLeum8DIgjbsOk=",
+      "dev": true,
+      "requires": {
+        "html-comment-regex": "^1.1.0"
+      }
+    },
+    "is-windows": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
+      "integrity": "sha512-eXK1UInq2bPmjyX6e3VHIzMLobc4J94i4AWn+Hpq3OU5KkrRC96OAcR3PRJ/pGu6m8TRnBHP9dkXQVsT/COVIA==",
+      "dev": true
+    },
+    "isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE=",
+      "dev": true
+    },
+    "isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=",
+      "dev": true
+    },
+    "isobject": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/isobject/-/isobject-3.0.1.tgz",
+      "integrity": "sha1-TkMekrEalzFjaqH5yNHMvP2reN8=",
+      "dev": true
+    },
+    "jquery": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/jquery/-/jquery-3.3.1.tgz",
+      "integrity": "sha512-Ubldcmxp5np52/ENotGxlLe6aGMvmF4R8S6tZjsP6Knsaxd/xp3Zrh50cG93lR6nPXyUFwzN3ZSOQI0wRJNdGg=="
+    },
+    "js-base64": {
+      "version": "2.4.5",
+      "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-2.4.5.tgz",
+      "integrity": "sha512-aUnNwqMOXw3yvErjMPSQu6qIIzUmT1e5KcU1OZxRDU1g/am6mzBvcrmLAYwzmB59BHPrh5/tKaiF4OPhqRWESQ==",
+      "dev": true
+    },
+    "js-tokens": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-3.0.2.tgz",
+      "integrity": "sha1-mGbfOVECEw449/mWvOtlRDIJwls=",
+      "dev": true
+    },
+    "js-yaml": {
+      "version": "3.12.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.12.0.tgz",
+      "integrity": "sha512-PIt2cnwmPfL4hKNwqeiuz4bKfnzHTBv6HyVgjahA6mPLwPDzjDWrplJBMjHUFxku/N3FlmrbyPclad+I+4mJ3A==",
+      "dev": true,
+      "requires": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "dependencies": {
+        "esprima": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.0.tgz",
+          "integrity": "sha512-oftTcaMu/EGrEIu904mWteKIv8vMuOgGYo7EhVJJN00R/EED9DCua/xxHRdYnKtcECzVg7xOWhflvJMnqcFZjw==",
+          "dev": true
+        }
+      }
+    },
+    "jsesc": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-1.3.0.tgz",
+      "integrity": "sha1-RsP+yMGJKxKwgz25vHYiF226s0s=",
+      "dev": true
+    },
+    "json-parse-better-errors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/json-parse-better-errors/-/json-parse-better-errors-1.0.2.tgz",
+      "integrity": "sha512-mrqyZKfX5EhL7hvqcV6WG1yYjnjeuYDzDhhcAAUrq8Po85NBQBJP+ZDUT75qZQ98IkUoBqdkExkukOU7Ts2wrw==",
+      "dev": true
+    },
+    "json-schema-traverse": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true
+    },
+    "json5": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-0.5.1.tgz",
+      "integrity": "sha1-Hq3nrMASA0rYTiOWdn6tn6VJWCE=",
+      "dev": true
+    },
+    "jsonfile": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-2.4.0.tgz",
+      "integrity": "sha1-NzaitCi4e72gzIO1P6PWM6NcKug=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "kind-of": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-3.2.2.tgz",
+      "integrity": "sha1-MeohpzS6ubuw8yRm2JOupR5KPGQ=",
+      "dev": true,
+      "requires": {
+        "is-buffer": "^1.1.5"
+      }
+    },
+    "klaw": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/klaw/-/klaw-1.3.1.tgz",
+      "integrity": "sha1-QIhDO0azsbolnXh4XY6W9zugJDk=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.9"
+      }
+    },
+    "lazy-cache": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/lazy-cache/-/lazy-cache-1.0.4.tgz",
+      "integrity": "sha1-odePw6UEdMuAhF07O24dpJpEbo4=",
+      "dev": true,
+      "optional": true
+    },
+    "lcid": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/lcid/-/lcid-1.0.0.tgz",
+      "integrity": "sha1-MIrMr6C8SDo4Z7S28rlQYlHRuDU=",
+      "dev": true,
+      "requires": {
+        "invert-kv": "^1.0.0"
+      }
+    },
+    "levn": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.3.0.tgz",
+      "integrity": "sha1-OwmSTt+fCDwEkP3UwLxEIeBHZO4=",
+      "dev": true,
+      "requires": {
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2"
+      }
+    },
+    "loader-runner": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-2.3.0.tgz",
+      "integrity": "sha1-9IKuqC1UPgeSFwDVpG7yb9rGuKI=",
+      "dev": true
+    },
+    "loader-utils": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-1.1.0.tgz",
+      "integrity": "sha1-yYrvSIvM7aL/teLeZG1qdUQp9c0=",
+      "dev": true,
+      "requires": {
+        "big.js": "^3.1.3",
+        "emojis-list": "^2.0.0",
+        "json5": "^0.5.0"
+      }
+    },
+    "locate-path": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-2.0.0.tgz",
+      "integrity": "sha1-K1aLJl7slExtnA3pw9u7ygNUzY4=",
+      "dev": true,
+      "requires": {
+        "p-locate": "^2.0.0",
+        "path-exists": "^3.0.0"
+      }
+    },
+    "lodash": {
+      "version": "4.17.10",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.10.tgz",
+      "integrity": "sha512-UejweD1pDoXu+AD825lWwp4ZGtSwgnpZxb3JDViD7StjQz+Nb/6l093lx4OQ0foGWNRoc19mWy7BzL+UAK2iVg==",
+      "dev": true
+    },
+    "lodash.camelcase": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz",
+      "integrity": "sha1-soqmKIorn8ZRA1x3EfZathkDMaY=",
+      "dev": true
+    },
+    "lodash.debounce": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
+      "integrity": "sha1-gteb/zCmfEAF/9XiUVMArZyk168=",
+      "dev": true
+    },
+    "lodash.memoize": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/lodash.memoize/-/lodash.memoize-4.1.2.tgz",
+      "integrity": "sha1-vMbEmkKihA7Zl/Mj6tpezRguC/4=",
+      "dev": true
+    },
+    "lodash.uniq": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.uniq/-/lodash.uniq-4.5.0.tgz",
+      "integrity": "sha1-0CJTc662Uq3BvILklFM5qEJ1R3M=",
+      "dev": true
+    },
+    "log-symbols": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-2.2.0.tgz",
+      "integrity": "sha512-VeIAFslyIerEJLXHziedo2basKbMKtTw3vfn5IzG0XTjhAVEJyNHnL2p7vc+wBDSdQuUpNw3M2u6xb9QsAY5Eg==",
+      "dev": true,
+      "requires": {
+        "chalk": "^2.0.1"
+      },
+      "dependencies": {
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "loglevelnext": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/loglevelnext/-/loglevelnext-1.0.5.tgz",
+      "integrity": "sha512-V/73qkPuJmx4BcBF19xPBr+0ZRVBhc4POxvZTZdMeXpJ4NItXSJ/MSwuFT0kQJlCbXvdlZoQQ/418bS1y9Jh6A==",
+      "dev": true,
+      "requires": {
+        "es6-symbol": "^3.1.1",
+        "object.assign": "^4.1.0"
+      }
+    },
+    "long": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/long/-/long-3.2.0.tgz",
+      "integrity": "sha1-2CG3E4yhy1gcFymQ7xTbIAtcR0s=",
+      "dev": true
+    },
+    "longest": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/longest/-/longest-1.0.1.tgz",
+      "integrity": "sha1-MKCy2jj3N3DoKUoNIuZiXtd9AJc=",
+      "dev": true
+    },
+    "loose-envify": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.3.1.tgz",
+      "integrity": "sha1-0aitM/qc4OcT1l/dCsi3SNR4yEg=",
+      "dev": true,
+      "requires": {
+        "js-tokens": "^3.0.0"
+      }
+    },
+    "lru-cache": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-4.1.3.tgz",
+      "integrity": "sha512-fFEhvcgzuIoJVUF8fYr5KR0YqxD238zgObTps31YdADwPPAp82a4M8TrckkWyx7ekNlf9aBcVn81cFwwXngrJA==",
+      "dev": true,
+      "requires": {
+        "pseudomap": "^1.0.2",
+        "yallist": "^2.1.2"
+      }
+    },
+    "make-dir": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/make-dir/-/make-dir-1.3.0.tgz",
+      "integrity": "sha512-2w31R7SJtieJJnQtGc7RVL2StM2vGYVfqUOvUDxH6bC6aJTxPxTF0GnIgCyu7tjockiUWAYQRbxa7vKn34s5sQ==",
+      "dev": true,
+      "requires": {
+        "pify": "^3.0.0"
+      }
+    },
+    "mamacro": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/mamacro/-/mamacro-0.0.3.tgz",
+      "integrity": "sha512-qMEwh+UujcQ+kbz3T6V+wAmO2U8veoq2w+3wY8MquqwVA3jChfwY+Tk52GZKDfACEPjuZ7r2oJLejwpt8jtwTA==",
+      "dev": true
+    },
+    "map-cache": {
+      "version": "0.2.2",
+      "resolved": "https://registry.npmjs.org/map-cache/-/map-cache-0.2.2.tgz",
+      "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8=",
+      "dev": true
+    },
+    "map-visit": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz",
+      "integrity": "sha1-7Nyo8TFE5mDxtb1B8S80edmN+48=",
+      "dev": true,
+      "requires": {
+        "object-visit": "^1.0.0"
+      }
+    },
+    "math-expression-evaluator": {
+      "version": "1.2.17",
+      "resolved": "https://registry.npmjs.org/math-expression-evaluator/-/math-expression-evaluator-1.2.17.tgz",
+      "integrity": "sha1-3oGf282E3M2PrlnGrreWFbnSZqw=",
+      "dev": true
+    },
+    "md5.js": {
+      "version": "1.3.4",
+      "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.4.tgz",
+      "integrity": "sha1-6b296UogpawYsENA/Fdk1bCdkB0=",
+      "dev": true,
+      "requires": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1"
+      }
+    },
+    "mem": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/mem/-/mem-1.1.0.tgz",
+      "integrity": "sha1-Xt1StIXKHZAP5kiVUFOZoN+kX3Y=",
+      "dev": true,
+      "requires": {
+        "mimic-fn": "^1.0.0"
+      }
+    },
+    "memory-fs": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/memory-fs/-/memory-fs-0.4.1.tgz",
+      "integrity": "sha1-OpoguEYlI+RHz7x+i7gO1me/xVI=",
+      "dev": true,
+      "requires": {
+        "errno": "^0.1.3",
+        "readable-stream": "^2.0.1"
+      }
+    },
+    "micromatch": {
+      "version": "3.1.10",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz",
+      "integrity": "sha512-MWikgl9n9M3w+bpsY3He8L+w9eF9338xRl8IAO5viDizwSzziFEyUzo2xrrloB64ADbTf8uA8vRqqttDTOmccg==",
+      "dev": true,
+      "requires": {
+        "arr-diff": "^4.0.0",
+        "array-unique": "^0.3.2",
+        "braces": "^2.3.1",
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "extglob": "^2.0.4",
+        "fragment-cache": "^0.2.1",
+        "kind-of": "^6.0.2",
+        "nanomatch": "^1.2.9",
+        "object.pick": "^1.3.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "miller-rabin": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/miller-rabin/-/miller-rabin-4.0.1.tgz",
+      "integrity": "sha512-115fLhvZVqWwHPbClyntxEVfVDfl9DLLTuJvq3g2O/Oxi8AiNouAHvDSzHS0viUJc+V5vm3eq91Xwqn9dp4jRA==",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.0.0",
+        "brorand": "^1.0.1"
+      }
+    },
+    "mime": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-2.3.1.tgz",
+      "integrity": "sha512-OEUllcVoydBHGN1z84yfQDimn58pZNNNXgZlHXSboxMlFvgI6MXSWpWKpFRra7H1HxpVhHTkrghfRW49k6yjeg==",
+      "dev": true
+    },
+    "mimic-fn": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-1.2.0.tgz",
+      "integrity": "sha512-jf84uxzwiuiIVKiOLpfYk7N46TSy8ubTonmneY9vrpHNAnp0QBt2BxWV9dO3/j+BoVAb+a5G6YDPW3M5HOdMWQ==",
+      "dev": true
+    },
+    "mini-css-extract-plugin": {
+      "version": "0.4.1",
+      "resolved": "https://registry.npmjs.org/mini-css-extract-plugin/-/mini-css-extract-plugin-0.4.1.tgz",
+      "integrity": "sha512-XWuB3G61Rtasq/gLe7cp5cuozehE6hN+E4sxCamRR/WDiHTg+f7ZIAS024r8UJQffY+e2gGELXQZgQoFDfNDCg==",
+      "dev": true,
+      "requires": {
+        "@webpack-contrib/schema-utils": "^1.0.0-beta.0",
+        "loader-utils": "^1.1.0",
+        "webpack-sources": "^1.1.0"
+      }
+    },
+    "minimalistic-assert": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
+      "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
+      "dev": true
+    },
+    "minimalistic-crypto-utils": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
+      "integrity": "sha1-9sAMHAsIIkblxNmd+4x8CDsrWCo=",
+      "dev": true
+    },
+    "minimatch": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
+      "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==",
+      "dev": true,
+      "requires": {
+        "brace-expansion": "^1.1.7"
+      }
+    },
+    "minimist": {
+      "version": "0.0.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
+      "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=",
+      "dev": true
+    },
+    "mississippi": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/mississippi/-/mississippi-2.0.0.tgz",
+      "integrity": "sha512-zHo8v+otD1J10j/tC+VNoGK9keCuByhKovAvdn74dmxJl9+mWHnx6EMsDN4lgRoMI/eYo2nchAxniIbUPb5onw==",
+      "dev": true,
+      "requires": {
+        "concat-stream": "^1.5.0",
+        "duplexify": "^3.4.2",
+        "end-of-stream": "^1.1.0",
+        "flush-write-stream": "^1.0.0",
+        "from2": "^2.1.0",
+        "parallel-transform": "^1.1.0",
+        "pump": "^2.0.1",
+        "pumpify": "^1.3.3",
+        "stream-each": "^1.1.0",
+        "through2": "^2.0.0"
+      }
+    },
+    "mixin-deep": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/mixin-deep/-/mixin-deep-1.3.1.tgz",
+      "integrity": "sha512-8ZItLHeEgaqEvd5lYBXfm4EZSFCX29Jb9K+lAHhDKzReKBQKj3R+7NOF6tjqYi9t4oI8VUfaWITJQm86wnXGNQ==",
+      "dev": true,
+      "requires": {
+        "for-in": "^1.0.2",
+        "is-extendable": "^1.0.1"
+      },
+      "dependencies": {
+        "is-extendable": {
+          "version": "1.0.1",
+          "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-1.0.1.tgz",
+          "integrity": "sha512-arnXMxT1hhoKo9k1LZdmlNyJdDDfy2v0fXjFlmok4+i8ul/6WlbVge9bhM74OpNPQPMGUToDtz+KXa1PneJxOA==",
+          "dev": true,
+          "requires": {
+            "is-plain-object": "^2.0.4"
+          }
+        }
+      }
+    },
+    "mkdirp": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
+      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
+      "dev": true,
+      "requires": {
+        "minimist": "0.0.8"
+      }
+    },
+    "move-concurrently": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/move-concurrently/-/move-concurrently-1.0.1.tgz",
+      "integrity": "sha1-viwAX9oy4LKa8fBdfEszIUxwH5I=",
+      "dev": true,
+      "requires": {
+        "aproba": "^1.1.1",
+        "copy-concurrently": "^1.0.0",
+        "fs-write-stream-atomic": "^1.0.8",
+        "mkdirp": "^0.5.1",
+        "rimraf": "^2.5.4",
+        "run-queue": "^1.0.3"
+      }
+    },
+    "ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=",
+      "dev": true
+    },
+    "multi-glob": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/multi-glob/-/multi-glob-1.0.1.tgz",
+      "integrity": "sha1-5n0qtEKdJ2BubrTbNQlK/JF4h1A=",
+      "dev": true,
+      "requires": {
+        "async": "1.x",
+        "glob": "5.x",
+        "lodash": "3.x"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y=",
+          "dev": true
+        }
+      }
+    },
+    "mute-stream": {
+      "version": "0.0.7",
+      "resolved": "https://registry.npmjs.org/mute-stream/-/mute-stream-0.0.7.tgz",
+      "integrity": "sha1-MHXOk7whuPq0PhvE2n6BFe0ee6s=",
+      "dev": true
+    },
+    "nan": {
+      "version": "2.10.0",
+      "resolved": "https://registry.npmjs.org/nan/-/nan-2.10.0.tgz",
+      "integrity": "sha512-bAdJv7fBLhWC+/Bls0Oza+mvTaNQtP+1RyhhhvD95pgUJz6XM5IzgmxOkItJ9tkoCiplvAnXI1tNmmUD/eScyA==",
+      "dev": true,
+      "optional": true
+    },
+    "nanomatch": {
+      "version": "1.2.13",
+      "resolved": "https://registry.npmjs.org/nanomatch/-/nanomatch-1.2.13.tgz",
+      "integrity": "sha512-fpoe2T0RbHwBTBUOftAfBPaDEi06ufaUai0mE6Yn1kacc3SnTErfb/h+X94VXzI64rKFHYImXSvdwGGCmwOqCA==",
+      "dev": true,
+      "requires": {
+        "arr-diff": "^4.0.0",
+        "array-unique": "^0.3.2",
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "fragment-cache": "^0.2.1",
+        "is-windows": "^1.0.2",
+        "kind-of": "^6.0.2",
+        "object.pick": "^1.3.0",
+        "regex-not": "^1.0.0",
+        "snapdragon": "^0.8.1",
+        "to-regex": "^3.0.1"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "neo-async": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.5.1.tgz",
+      "integrity": "sha512-3KL3fvuRkZ7s4IFOMfztb7zJp3QaVWnBeGoJlgB38XnCRPj/0tLzzLG5IB8NYOHbJ8g8UGrgZv44GLDk6CxTxA==",
+      "dev": true
+    },
+    "next-tick": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/next-tick/-/next-tick-1.0.0.tgz",
+      "integrity": "sha1-yobR/ogoFpsBICCOPchCS524NCw=",
+      "dev": true
+    },
+    "nice-try": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/nice-try/-/nice-try-1.0.4.tgz",
+      "integrity": "sha512-2NpiFHqC87y/zFke0fC0spBXL3bBsoh/p5H1EFhshxjCR5+0g2d6BiXbUFz9v1sAcxsk2htp2eQnNIci2dIYcA==",
+      "dev": true
+    },
+    "node-libs-browser": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/node-libs-browser/-/node-libs-browser-2.1.0.tgz",
+      "integrity": "sha512-5AzFzdoIMb89hBGMZglEegffzgRg+ZFoUmisQ8HI4j1KDdpx13J0taNp2y9xPbur6W61gepGDDotGBVQ7mfUCg==",
+      "dev": true,
+      "requires": {
+        "assert": "^1.1.1",
+        "browserify-zlib": "^0.2.0",
+        "buffer": "^4.3.0",
+        "console-browserify": "^1.1.0",
+        "constants-browserify": "^1.0.0",
+        "crypto-browserify": "^3.11.0",
+        "domain-browser": "^1.1.1",
+        "events": "^1.0.0",
+        "https-browserify": "^1.0.0",
+        "os-browserify": "^0.3.0",
+        "path-browserify": "0.0.0",
+        "process": "^0.11.10",
+        "punycode": "^1.2.4",
+        "querystring-es3": "^0.2.0",
+        "readable-stream": "^2.3.3",
+        "stream-browserify": "^2.0.1",
+        "stream-http": "^2.7.2",
+        "string_decoder": "^1.0.0",
+        "timers-browserify": "^2.0.4",
+        "tty-browserify": "0.0.0",
+        "url": "^0.11.0",
+        "util": "^0.10.3",
+        "vm-browserify": "0.0.4"
+      },
+      "dependencies": {
+        "punycode": {
+          "version": "1.4.1",
+          "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.4.1.tgz",
+          "integrity": "sha1-wNWmOycYgArY4esPpSachN1BhF4=",
+          "dev": true
+        }
+      }
+    },
+    "nopt": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
+      "integrity": "sha1-xkZdvwirzU2zWTF/eaxopkayj/k=",
+      "dev": true,
+      "requires": {
+        "abbrev": "1"
+      }
+    },
+    "normalize-path": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-2.1.1.tgz",
+      "integrity": "sha1-GrKLVW4Zg2Oowab35vogE3/mrtk=",
+      "dev": true,
+      "requires": {
+        "remove-trailing-separator": "^1.0.1"
+      }
+    },
+    "normalize-range": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",
+      "integrity": "sha1-LRDAa9/TEuqXd2laTShDlFa3WUI=",
+      "dev": true
+    },
+    "normalize-url": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/normalize-url/-/normalize-url-1.9.1.tgz",
+      "integrity": "sha1-LMDWazHqIwNkWENuNiDYWVTGbDw=",
+      "dev": true,
+      "requires": {
+        "object-assign": "^4.0.1",
+        "prepend-http": "^1.0.0",
+        "query-string": "^4.1.0",
+        "sort-keys": "^1.0.0"
+      }
+    },
+    "npm": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/npm/-/npm-6.1.0.tgz",
+      "integrity": "sha512-e38cCtJ0lEjLXXpc4twEfj8Xw5hDLolc2Py87ueWnUhJfZ8GA/5RVIeD+XbSr1+aVRGsRsdtLdzUNO63PvQJ1w==",
+      "requires": {
+        "JSONStream": "^1.3.2",
+        "abbrev": "~1.1.1",
+        "ansi-regex": "~3.0.0",
+        "ansicolors": "~0.3.2",
+        "ansistyles": "~0.1.3",
+        "aproba": "~1.2.0",
+        "archy": "~1.0.0",
+        "bin-links": "^1.1.2",
+        "bluebird": "~3.5.1",
+        "byte-size": "^4.0.3",
+        "cacache": "^11.0.2",
+        "call-limit": "~1.1.0",
+        "chownr": "~1.0.1",
+        "cli-columns": "^3.1.2",
+        "cli-table2": "~0.2.0",
+        "cmd-shim": "~2.0.2",
+        "columnify": "~1.5.4",
+        "config-chain": "~1.1.11",
+        "debuglog": "*",
+        "detect-indent": "~5.0.0",
+        "detect-newline": "^2.1.0",
+        "dezalgo": "~1.0.3",
+        "editor": "~1.0.0",
+        "figgy-pudding": "^3.1.0",
+        "find-npm-prefix": "^1.0.2",
+        "fs-vacuum": "~1.2.10",
+        "fs-write-stream-atomic": "~1.0.10",
+        "gentle-fs": "^2.0.1",
+        "glob": "~7.1.2",
+        "graceful-fs": "~4.1.11",
+        "has-unicode": "~2.0.1",
+        "hosted-git-info": "^2.6.0",
+        "iferr": "^1.0.0",
+        "imurmurhash": "*",
+        "inflight": "~1.0.6",
+        "inherits": "~2.0.3",
+        "ini": "^1.3.5",
+        "init-package-json": "^1.10.3",
+        "is-cidr": "^2.0.5",
+        "json-parse-better-errors": "^1.0.2",
+        "lazy-property": "~1.0.0",
+        "libcipm": "^1.6.2",
+        "libnpmhook": "^4.0.1",
+        "libnpx": "^10.2.0",
+        "lock-verify": "^2.0.2",
+        "lockfile": "^1.0.4",
+        "lodash._baseindexof": "*",
+        "lodash._baseuniq": "~4.6.0",
+        "lodash._bindcallback": "*",
+        "lodash._cacheindexof": "*",
+        "lodash._createcache": "*",
+        "lodash._getnative": "*",
+        "lodash.clonedeep": "~4.5.0",
+        "lodash.restparam": "*",
+        "lodash.union": "~4.6.0",
+        "lodash.uniq": "~4.5.0",
+        "lodash.without": "~4.4.0",
+        "lru-cache": "^4.1.3",
+        "meant": "~1.0.1",
+        "mississippi": "^3.0.0",
+        "mkdirp": "~0.5.1",
+        "move-concurrently": "^1.0.1",
+        "node-gyp": "^3.6.2",
+        "nopt": "~4.0.1",
+        "normalize-package-data": "~2.4.0",
+        "npm-audit-report": "^1.2.1",
+        "npm-cache-filename": "~1.0.2",
+        "npm-install-checks": "~3.0.0",
+        "npm-lifecycle": "^2.0.3",
+        "npm-package-arg": "^6.1.0",
+        "npm-packlist": "~1.1.10",
+        "npm-pick-manifest": "^2.1.0",
+        "npm-profile": "^3.0.1",
+        "npm-registry-client": "^8.5.1",
+        "npm-registry-fetch": "^1.1.0",
+        "npm-user-validate": "~1.0.0",
+        "npmlog": "~4.1.2",
+        "once": "~1.4.0",
+        "opener": "~1.4.3",
+        "osenv": "^0.1.5",
+        "pacote": "^8.1.5",
+        "path-is-inside": "~1.0.2",
+        "promise-inflight": "~1.0.1",
+        "qrcode-terminal": "^0.12.0",
+        "query-string": "^6.1.0",
+        "qw": "~1.0.1",
+        "read": "~1.0.7",
+        "read-cmd-shim": "~1.0.1",
+        "read-installed": "~4.0.3",
+        "read-package-json": "^2.0.13",
+        "read-package-tree": "^5.2.1",
+        "readable-stream": "^2.3.6",
+        "readdir-scoped-modules": "*",
+        "request": "^2.86.0",
+        "retry": "^0.12.0",
+        "rimraf": "~2.6.2",
+        "safe-buffer": "^5.1.2",
+        "semver": "^5.5.0",
+        "sha": "~2.0.1",
+        "slide": "~1.1.6",
+        "sorted-object": "~2.0.1",
+        "sorted-union-stream": "~2.1.3",
+        "ssri": "^6.0.0",
+        "strip-ansi": "~4.0.0",
+        "tar": "^4.4.1",
+        "text-table": "~0.2.0",
+        "tiny-relative-date": "^1.3.0",
+        "uid-number": "0.0.6",
+        "umask": "~1.1.0",
+        "unique-filename": "~1.1.0",
+        "unpipe": "~1.0.0",
+        "update-notifier": "^2.5.0",
+        "uuid": "^3.2.1",
+        "validate-npm-package-license": "^3.0.3",
+        "validate-npm-package-name": "~3.0.0",
+        "which": "~1.3.0",
+        "worker-farm": "^1.6.0",
+        "wrappy": "~1.0.2",
+        "write-file-atomic": "^2.3.0"
+      },
+      "dependencies": {
+        "JSONStream": {
+          "version": "1.3.2",
+          "bundled": true,
+          "requires": {
+            "jsonparse": "^1.2.0",
+            "through": ">=2.2.7 <3"
+          },
+          "dependencies": {
+            "jsonparse": {
+              "version": "1.3.1",
+              "bundled": true
+            },
+            "through": {
+              "version": "2.3.8",
+              "bundled": true
+            }
+          }
+        },
+        "abbrev": {
+          "version": "1.1.1",
+          "bundled": true
+        },
+        "ansi-regex": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "ansicolors": {
+          "version": "0.3.2",
+          "bundled": true
+        },
+        "ansistyles": {
+          "version": "0.1.3",
+          "bundled": true
+        },
+        "aproba": {
+          "version": "1.2.0",
+          "bundled": true
+        },
+        "archy": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "bin-links": {
+          "version": "1.1.2",
+          "bundled": true,
+          "requires": {
+            "bluebird": "^3.5.0",
+            "cmd-shim": "^2.0.2",
+            "gentle-fs": "^2.0.0",
+            "graceful-fs": "^4.1.11",
+            "write-file-atomic": "^2.3.0"
+          }
+        },
+        "bluebird": {
+          "version": "3.5.1",
+          "bundled": true
+        },
+        "byte-size": {
+          "version": "4.0.3",
+          "bundled": true
+        },
+        "cacache": {
+          "version": "11.0.2",
+          "bundled": true,
+          "requires": {
+            "bluebird": "^3.5.1",
+            "chownr": "^1.0.1",
+            "figgy-pudding": "^3.1.0",
+            "glob": "^7.1.2",
+            "graceful-fs": "^4.1.11",
+            "lru-cache": "^4.1.2",
+            "mississippi": "^3.0.0",
+            "mkdirp": "^0.5.1",
+            "move-concurrently": "^1.0.1",
+            "promise-inflight": "^1.0.1",
+            "rimraf": "^2.6.2",
+            "ssri": "^6.0.0",
+            "unique-filename": "^1.1.0",
+            "y18n": "^4.0.0"
+          },
+          "dependencies": {
+            "y18n": {
+              "version": "4.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "call-limit": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "chownr": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "cli-columns": {
+          "version": "3.1.2",
+          "bundled": true,
+          "requires": {
+            "string-width": "^2.0.0",
+            "strip-ansi": "^3.0.1"
+          },
+          "dependencies": {
+            "string-width": {
+              "version": "2.1.1",
+              "bundled": true,
+              "requires": {
+                "is-fullwidth-code-point": "^2.0.0",
+                "strip-ansi": "^4.0.0"
+              },
+              "dependencies": {
+                "is-fullwidth-code-point": {
+                  "version": "2.0.0",
+                  "bundled": true
+                },
+                "strip-ansi": {
+                  "version": "4.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "ansi-regex": "^3.0.0"
+                  }
+                }
+              }
+            },
+            "strip-ansi": {
+              "version": "3.0.1",
+              "bundled": true,
+              "requires": {
+                "ansi-regex": "^2.0.0"
+              },
+              "dependencies": {
+                "ansi-regex": {
+                  "version": "2.1.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "cli-table2": {
+          "version": "0.2.0",
+          "bundled": true,
+          "requires": {
+            "colors": "^1.1.2",
+            "lodash": "^3.10.1",
+            "string-width": "^1.0.1"
+          },
+          "dependencies": {
+            "colors": {
+              "version": "1.1.2",
+              "bundled": true,
+              "optional": true
+            },
+            "lodash": {
+              "version": "3.10.1",
+              "bundled": true
+            },
+            "string-width": {
+              "version": "1.0.2",
+              "bundled": true,
+              "requires": {
+                "code-point-at": "^1.0.0",
+                "is-fullwidth-code-point": "^1.0.0",
+                "strip-ansi": "^3.0.0"
+              },
+              "dependencies": {
+                "code-point-at": {
+                  "version": "1.1.0",
+                  "bundled": true
+                },
+                "is-fullwidth-code-point": {
+                  "version": "1.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "number-is-nan": "^1.0.0"
+                  },
+                  "dependencies": {
+                    "number-is-nan": {
+                      "version": "1.0.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "strip-ansi": {
+                  "version": "3.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "ansi-regex": "^2.0.0"
+                  },
+                  "dependencies": {
+                    "ansi-regex": {
+                      "version": "2.1.1",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "cmd-shim": {
+          "version": "2.0.2",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2",
+            "mkdirp": "~0.5.0"
+          }
+        },
+        "columnify": {
+          "version": "1.5.4",
+          "bundled": true,
+          "requires": {
+            "strip-ansi": "^3.0.0",
+            "wcwidth": "^1.0.0"
+          },
+          "dependencies": {
+            "strip-ansi": {
+              "version": "3.0.1",
+              "bundled": true,
+              "requires": {
+                "ansi-regex": "^2.0.0"
+              },
+              "dependencies": {
+                "ansi-regex": {
+                  "version": "2.1.1",
+                  "bundled": true
+                }
+              }
+            },
+            "wcwidth": {
+              "version": "1.0.1",
+              "bundled": true,
+              "requires": {
+                "defaults": "^1.0.3"
+              },
+              "dependencies": {
+                "defaults": {
+                  "version": "1.0.3",
+                  "bundled": true,
+                  "requires": {
+                    "clone": "^1.0.2"
+                  },
+                  "dependencies": {
+                    "clone": {
+                      "version": "1.0.2",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "config-chain": {
+          "version": "1.1.11",
+          "bundled": true,
+          "requires": {
+            "ini": "^1.3.4",
+            "proto-list": "~1.2.1"
+          },
+          "dependencies": {
+            "proto-list": {
+              "version": "1.2.4",
+              "bundled": true
+            }
+          }
+        },
+        "debuglog": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "detect-indent": {
+          "version": "5.0.0",
+          "bundled": true
+        },
+        "detect-newline": {
+          "version": "2.1.0",
+          "bundled": true
+        },
+        "dezalgo": {
+          "version": "1.0.3",
+          "bundled": true,
+          "requires": {
+            "asap": "^2.0.0",
+            "wrappy": "1"
+          },
+          "dependencies": {
+            "asap": {
+              "version": "2.0.5",
+              "bundled": true
+            }
+          }
+        },
+        "editor": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "figgy-pudding": {
+          "version": "3.1.0",
+          "bundled": true
+        },
+        "find-npm-prefix": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "fs-vacuum": {
+          "version": "1.2.10",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2",
+            "path-is-inside": "^1.0.1",
+            "rimraf": "^2.5.2"
+          }
+        },
+        "fs-write-stream-atomic": {
+          "version": "1.0.10",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2",
+            "iferr": "^0.1.5",
+            "imurmurhash": "^0.1.4",
+            "readable-stream": "1 || 2"
+          },
+          "dependencies": {
+            "iferr": {
+              "version": "0.1.5",
+              "bundled": true
+            }
+          }
+        },
+        "gentle-fs": {
+          "version": "2.0.1",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.1.2",
+            "fs-vacuum": "^1.2.10",
+            "graceful-fs": "^4.1.11",
+            "iferr": "^0.1.5",
+            "mkdirp": "^0.5.1",
+            "path-is-inside": "^1.0.2",
+            "read-cmd-shim": "^1.0.1",
+            "slide": "^1.1.6"
+          },
+          "dependencies": {
+            "iferr": {
+              "version": "0.1.5",
+              "bundled": true
+            }
+          }
+        },
+        "glob": {
+          "version": "7.1.2",
+          "bundled": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          },
+          "dependencies": {
+            "fs.realpath": {
+              "version": "1.0.0",
+              "bundled": true
+            },
+            "minimatch": {
+              "version": "3.0.4",
+              "bundled": true,
+              "requires": {
+                "brace-expansion": "^1.1.7"
+              },
+              "dependencies": {
+                "brace-expansion": {
+                  "version": "1.1.8",
+                  "bundled": true,
+                  "requires": {
+                    "balanced-match": "^1.0.0",
+                    "concat-map": "0.0.1"
+                  },
+                  "dependencies": {
+                    "balanced-match": {
+                      "version": "1.0.0",
+                      "bundled": true
+                    },
+                    "concat-map": {
+                      "version": "0.0.1",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "path-is-absolute": {
+              "version": "1.0.1",
+              "bundled": true
+            }
+          }
+        },
+        "graceful-fs": {
+          "version": "4.1.11",
+          "bundled": true
+        },
+        "has-unicode": {
+          "version": "2.0.1",
+          "bundled": true
+        },
+        "hosted-git-info": {
+          "version": "2.6.0",
+          "bundled": true
+        },
+        "iferr": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "imurmurhash": {
+          "version": "0.1.4",
+          "bundled": true
+        },
+        "inflight": {
+          "version": "1.0.6",
+          "bundled": true,
+          "requires": {
+            "once": "^1.3.0",
+            "wrappy": "1"
+          }
+        },
+        "inherits": {
+          "version": "2.0.3",
+          "bundled": true
+        },
+        "ini": {
+          "version": "1.3.5",
+          "bundled": true
+        },
+        "init-package-json": {
+          "version": "1.10.3",
+          "bundled": true,
+          "requires": {
+            "glob": "^7.1.1",
+            "npm-package-arg": "^4.0.0 || ^5.0.0 || ^6.0.0",
+            "promzard": "^0.3.0",
+            "read": "~1.0.1",
+            "read-package-json": "1 || 2",
+            "semver": "2.x || 3.x || 4 || 5",
+            "validate-npm-package-license": "^3.0.1",
+            "validate-npm-package-name": "^3.0.0"
+          },
+          "dependencies": {
+            "promzard": {
+              "version": "0.3.0",
+              "bundled": true,
+              "requires": {
+                "read": "1"
+              }
+            }
+          }
+        },
+        "is-cidr": {
+          "version": "2.0.5",
+          "bundled": true,
+          "requires": {
+            "cidr-regex": "^2.0.8"
+          },
+          "dependencies": {
+            "cidr-regex": {
+              "version": "2.0.8",
+              "bundled": true,
+              "requires": {
+                "ip-regex": "^2.1.0"
+              },
+              "dependencies": {
+                "ip-regex": {
+                  "version": "2.1.0",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "json-parse-better-errors": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "lazy-property": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "libcipm": {
+          "version": "1.6.2",
+          "bundled": true,
+          "requires": {
+            "bin-links": "^1.1.0",
+            "bluebird": "^3.5.1",
+            "find-npm-prefix": "^1.0.2",
+            "graceful-fs": "^4.1.11",
+            "lock-verify": "^2.0.0",
+            "npm-lifecycle": "^2.0.0",
+            "npm-logical-tree": "^1.2.1",
+            "npm-package-arg": "^6.0.0",
+            "pacote": "^7.5.1",
+            "protoduck": "^5.0.0",
+            "read-package-json": "^2.0.12",
+            "rimraf": "^2.6.2",
+            "worker-farm": "^1.5.4"
+          },
+          "dependencies": {
+            "npm-logical-tree": {
+              "version": "1.2.1",
+              "bundled": true
+            },
+            "pacote": {
+              "version": "7.6.1",
+              "bundled": true,
+              "requires": {
+                "bluebird": "^3.5.1",
+                "cacache": "^10.0.4",
+                "get-stream": "^3.0.0",
+                "glob": "^7.1.2",
+                "lru-cache": "^4.1.1",
+                "make-fetch-happen": "^2.6.0",
+                "minimatch": "^3.0.4",
+                "mississippi": "^3.0.0",
+                "mkdirp": "^0.5.1",
+                "normalize-package-data": "^2.4.0",
+                "npm-package-arg": "^6.0.0",
+                "npm-packlist": "^1.1.10",
+                "npm-pick-manifest": "^2.1.0",
+                "osenv": "^0.1.5",
+                "promise-inflight": "^1.0.1",
+                "promise-retry": "^1.1.1",
+                "protoduck": "^5.0.0",
+                "rimraf": "^2.6.2",
+                "safe-buffer": "^5.1.1",
+                "semver": "^5.5.0",
+                "ssri": "^5.2.4",
+                "tar": "^4.4.0",
+                "unique-filename": "^1.1.0",
+                "which": "^1.3.0"
+              },
+              "dependencies": {
+                "cacache": {
+                  "version": "10.0.4",
+                  "bundled": true,
+                  "requires": {
+                    "bluebird": "^3.5.1",
+                    "chownr": "^1.0.1",
+                    "glob": "^7.1.2",
+                    "graceful-fs": "^4.1.11",
+                    "lru-cache": "^4.1.1",
+                    "mississippi": "^2.0.0",
+                    "mkdirp": "^0.5.1",
+                    "move-concurrently": "^1.0.1",
+                    "promise-inflight": "^1.0.1",
+                    "rimraf": "^2.6.2",
+                    "ssri": "^5.2.4",
+                    "unique-filename": "^1.1.0",
+                    "y18n": "^4.0.0"
+                  },
+                  "dependencies": {
+                    "mississippi": {
+                      "version": "2.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "concat-stream": "^1.5.0",
+                        "duplexify": "^3.4.2",
+                        "end-of-stream": "^1.1.0",
+                        "flush-write-stream": "^1.0.0",
+                        "from2": "^2.1.0",
+                        "parallel-transform": "^1.1.0",
+                        "pump": "^2.0.1",
+                        "pumpify": "^1.3.3",
+                        "stream-each": "^1.1.0",
+                        "through2": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "concat-stream": {
+                          "version": "1.6.2",
+                          "bundled": true,
+                          "requires": {
+                            "buffer-from": "^1.0.0",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.2.2",
+                            "typedarray": "^0.0.6"
+                          },
+                          "dependencies": {
+                            "buffer-from": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            },
+                            "typedarray": {
+                              "version": "0.0.6",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "duplexify": {
+                          "version": "3.5.4",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.0.0",
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "end-of-stream": {
+                          "version": "1.4.1",
+                          "bundled": true,
+                          "requires": {
+                            "once": "^1.4.0"
+                          }
+                        },
+                        "flush-write-stream": {
+                          "version": "1.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.4"
+                          }
+                        },
+                        "from2": {
+                          "version": "2.3.0",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0"
+                          }
+                        },
+                        "parallel-transform": {
+                          "version": "1.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "cyclist": "~0.2.2",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.1.5"
+                          },
+                          "dependencies": {
+                            "cyclist": {
+                              "version": "0.2.2",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "pump": {
+                          "version": "2.0.1",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "once": "^1.3.1"
+                          }
+                        },
+                        "pumpify": {
+                          "version": "1.4.0",
+                          "bundled": true,
+                          "requires": {
+                            "duplexify": "^3.5.3",
+                            "inherits": "^2.0.3",
+                            "pump": "^2.0.0"
+                          }
+                        },
+                        "stream-each": {
+                          "version": "1.2.2",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "through2": {
+                          "version": "2.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "readable-stream": "^2.1.5",
+                            "xtend": "~4.0.1"
+                          },
+                          "dependencies": {
+                            "xtend": {
+                              "version": "4.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "y18n": {
+                      "version": "4.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "get-stream": {
+                  "version": "3.0.0",
+                  "bundled": true
+                },
+                "make-fetch-happen": {
+                  "version": "2.6.0",
+                  "bundled": true,
+                  "requires": {
+                    "agentkeepalive": "^3.3.0",
+                    "cacache": "^10.0.0",
+                    "http-cache-semantics": "^3.8.0",
+                    "http-proxy-agent": "^2.0.0",
+                    "https-proxy-agent": "^2.1.0",
+                    "lru-cache": "^4.1.1",
+                    "mississippi": "^1.2.0",
+                    "node-fetch-npm": "^2.0.2",
+                    "promise-retry": "^1.1.1",
+                    "socks-proxy-agent": "^3.0.1",
+                    "ssri": "^5.0.0"
+                  },
+                  "dependencies": {
+                    "agentkeepalive": {
+                      "version": "3.4.1",
+                      "bundled": true,
+                      "requires": {
+                        "humanize-ms": "^1.2.1"
+                      },
+                      "dependencies": {
+                        "humanize-ms": {
+                          "version": "1.2.1",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.1.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "http-cache-semantics": {
+                      "version": "3.8.1",
+                      "bundled": true
+                    },
+                    "http-proxy-agent": {
+                      "version": "2.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "4",
+                        "debug": "3.1.0"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.2.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "debug": {
+                          "version": "3.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.0.0",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "https-proxy-agent": {
+                      "version": "2.2.1",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "^4.1.0",
+                        "debug": "^3.1.0"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.2.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "debug": {
+                          "version": "3.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.0.0",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "mississippi": {
+                      "version": "1.3.1",
+                      "bundled": true,
+                      "requires": {
+                        "concat-stream": "^1.5.0",
+                        "duplexify": "^3.4.2",
+                        "end-of-stream": "^1.1.0",
+                        "flush-write-stream": "^1.0.0",
+                        "from2": "^2.1.0",
+                        "parallel-transform": "^1.1.0",
+                        "pump": "^1.0.0",
+                        "pumpify": "^1.3.3",
+                        "stream-each": "^1.1.0",
+                        "through2": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "concat-stream": {
+                          "version": "1.6.2",
+                          "bundled": true,
+                          "requires": {
+                            "buffer-from": "^1.0.0",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.2.2",
+                            "typedarray": "^0.0.6"
+                          },
+                          "dependencies": {
+                            "buffer-from": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            },
+                            "typedarray": {
+                              "version": "0.0.6",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "duplexify": {
+                          "version": "3.5.4",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.0.0",
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "end-of-stream": {
+                          "version": "1.4.1",
+                          "bundled": true,
+                          "requires": {
+                            "once": "^1.4.0"
+                          }
+                        },
+                        "flush-write-stream": {
+                          "version": "1.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.4"
+                          }
+                        },
+                        "from2": {
+                          "version": "2.3.0",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0"
+                          }
+                        },
+                        "parallel-transform": {
+                          "version": "1.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "cyclist": "~0.2.2",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.1.5"
+                          },
+                          "dependencies": {
+                            "cyclist": {
+                              "version": "0.2.2",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "pump": {
+                          "version": "1.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "once": "^1.3.1"
+                          }
+                        },
+                        "pumpify": {
+                          "version": "1.4.0",
+                          "bundled": true,
+                          "requires": {
+                            "duplexify": "^3.5.3",
+                            "inherits": "^2.0.3",
+                            "pump": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "pump": {
+                              "version": "2.0.1",
+                              "bundled": true,
+                              "requires": {
+                                "end-of-stream": "^1.1.0",
+                                "once": "^1.3.1"
+                              }
+                            }
+                          }
+                        },
+                        "stream-each": {
+                          "version": "1.2.2",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "through2": {
+                          "version": "2.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "readable-stream": "^2.1.5",
+                            "xtend": "~4.0.1"
+                          },
+                          "dependencies": {
+                            "xtend": {
+                              "version": "4.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "node-fetch-npm": {
+                      "version": "2.0.2",
+                      "bundled": true,
+                      "requires": {
+                        "encoding": "^0.1.11",
+                        "json-parse-better-errors": "^1.0.0",
+                        "safe-buffer": "^5.1.1"
+                      },
+                      "dependencies": {
+                        "encoding": {
+                          "version": "0.1.12",
+                          "bundled": true,
+                          "requires": {
+                            "iconv-lite": "~0.4.13"
+                          },
+                          "dependencies": {
+                            "iconv-lite": {
+                              "version": "0.4.21",
+                              "bundled": true,
+                              "requires": {
+                                "safer-buffer": "^2.1.0"
+                              },
+                              "dependencies": {
+                                "safer-buffer": {
+                                  "version": "2.1.2",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "socks-proxy-agent": {
+                      "version": "3.0.1",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "^4.1.0",
+                        "socks": "^1.1.10"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.2.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "socks": {
+                          "version": "1.1.10",
+                          "bundled": true,
+                          "requires": {
+                            "ip": "^1.1.4",
+                            "smart-buffer": "^1.0.13"
+                          },
+                          "dependencies": {
+                            "ip": {
+                              "version": "1.1.5",
+                              "bundled": true
+                            },
+                            "smart-buffer": {
+                              "version": "1.1.15",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "minimatch": {
+                  "version": "3.0.4",
+                  "bundled": true,
+                  "requires": {
+                    "brace-expansion": "^1.1.7"
+                  },
+                  "dependencies": {
+                    "brace-expansion": {
+                      "version": "1.1.11",
+                      "bundled": true,
+                      "requires": {
+                        "balanced-match": "^1.0.0",
+                        "concat-map": "0.0.1"
+                      },
+                      "dependencies": {
+                        "balanced-match": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        },
+                        "concat-map": {
+                          "version": "0.0.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "promise-retry": {
+                  "version": "1.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "err-code": "^1.0.0",
+                    "retry": "^0.10.0"
+                  },
+                  "dependencies": {
+                    "err-code": {
+                      "version": "1.1.2",
+                      "bundled": true
+                    },
+                    "retry": {
+                      "version": "0.10.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "ssri": {
+                  "version": "5.3.0",
+                  "bundled": true,
+                  "requires": {
+                    "safe-buffer": "^5.1.1"
+                  }
+                }
+              }
+            },
+            "protoduck": {
+              "version": "5.0.0",
+              "bundled": true,
+              "requires": {
+                "genfun": "^4.0.1"
+              },
+              "dependencies": {
+                "genfun": {
+                  "version": "4.0.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "libnpmhook": {
+          "version": "4.0.1",
+          "bundled": true,
+          "requires": {
+            "figgy-pudding": "^3.1.0",
+            "npm-registry-fetch": "^3.0.0"
+          },
+          "dependencies": {
+            "npm-registry-fetch": {
+              "version": "3.1.1",
+              "bundled": true,
+              "requires": {
+                "bluebird": "^3.5.1",
+                "figgy-pudding": "^3.1.0",
+                "lru-cache": "^4.1.2",
+                "make-fetch-happen": "^4.0.0",
+                "npm-package-arg": "^6.0.0"
+              },
+              "dependencies": {
+                "make-fetch-happen": {
+                  "version": "4.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "agentkeepalive": "^3.4.1",
+                    "cacache": "^11.0.1",
+                    "http-cache-semantics": "^3.8.1",
+                    "http-proxy-agent": "^2.1.0",
+                    "https-proxy-agent": "^2.2.1",
+                    "lru-cache": "^4.1.2",
+                    "mississippi": "^3.0.0",
+                    "node-fetch-npm": "^2.0.2",
+                    "promise-retry": "^1.1.1",
+                    "socks-proxy-agent": "^4.0.0",
+                    "ssri": "^6.0.0"
+                  },
+                  "dependencies": {
+                    "agentkeepalive": {
+                      "version": "3.4.1",
+                      "bundled": true,
+                      "requires": {
+                        "humanize-ms": "^1.2.1"
+                      },
+                      "dependencies": {
+                        "humanize-ms": {
+                          "version": "1.2.1",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.1.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "http-cache-semantics": {
+                      "version": "3.8.1",
+                      "bundled": true
+                    },
+                    "http-proxy-agent": {
+                      "version": "2.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "4",
+                        "debug": "3.1.0"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.2.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "debug": {
+                          "version": "3.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.0.0",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "https-proxy-agent": {
+                      "version": "2.2.1",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "^4.1.0",
+                        "debug": "^3.1.0"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.2.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "debug": {
+                          "version": "3.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "ms": "2.0.0"
+                          },
+                          "dependencies": {
+                            "ms": {
+                              "version": "2.0.0",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "node-fetch-npm": {
+                      "version": "2.0.2",
+                      "bundled": true,
+                      "requires": {
+                        "encoding": "^0.1.11",
+                        "json-parse-better-errors": "^1.0.0",
+                        "safe-buffer": "^5.1.1"
+                      },
+                      "dependencies": {
+                        "encoding": {
+                          "version": "0.1.12",
+                          "bundled": true,
+                          "requires": {
+                            "iconv-lite": "~0.4.13"
+                          },
+                          "dependencies": {
+                            "iconv-lite": {
+                              "version": "0.4.21",
+                              "bundled": true,
+                              "requires": {
+                                "safer-buffer": "^2.1.0"
+                              },
+                              "dependencies": {
+                                "safer-buffer": {
+                                  "version": "2.1.2",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "promise-retry": {
+                      "version": "1.1.1",
+                      "bundled": true,
+                      "requires": {
+                        "err-code": "^1.0.0",
+                        "retry": "^0.10.0"
+                      },
+                      "dependencies": {
+                        "err-code": {
+                          "version": "1.1.2",
+                          "bundled": true
+                        },
+                        "retry": {
+                          "version": "0.10.1",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "socks-proxy-agent": {
+                      "version": "4.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "agent-base": "~4.1.0",
+                        "socks": "~2.1.6"
+                      },
+                      "dependencies": {
+                        "agent-base": {
+                          "version": "4.1.2",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promisify": "^5.0.0"
+                          },
+                          "dependencies": {
+                            "es6-promisify": {
+                              "version": "5.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "es6-promise": "^4.0.3"
+                              },
+                              "dependencies": {
+                                "es6-promise": {
+                                  "version": "4.2.4",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "socks": {
+                          "version": "2.1.6",
+                          "bundled": true,
+                          "requires": {
+                            "ip": "^1.1.5",
+                            "smart-buffer": "^4.0.1"
+                          },
+                          "dependencies": {
+                            "ip": {
+                              "version": "1.1.5",
+                              "bundled": true
+                            },
+                            "smart-buffer": {
+                              "version": "4.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "libnpx": {
+          "version": "10.2.0",
+          "bundled": true,
+          "requires": {
+            "dotenv": "^5.0.1",
+            "npm-package-arg": "^6.0.0",
+            "rimraf": "^2.6.2",
+            "safe-buffer": "^5.1.0",
+            "update-notifier": "^2.3.0",
+            "which": "^1.3.0",
+            "y18n": "^4.0.0",
+            "yargs": "^11.0.0"
+          },
+          "dependencies": {
+            "dotenv": {
+              "version": "5.0.1",
+              "bundled": true
+            },
+            "y18n": {
+              "version": "4.0.0",
+              "bundled": true
+            },
+            "yargs": {
+              "version": "11.0.0",
+              "bundled": true,
+              "requires": {
+                "cliui": "^4.0.0",
+                "decamelize": "^1.1.1",
+                "find-up": "^2.1.0",
+                "get-caller-file": "^1.0.1",
+                "os-locale": "^2.0.0",
+                "require-directory": "^2.1.1",
+                "require-main-filename": "^1.0.1",
+                "set-blocking": "^2.0.0",
+                "string-width": "^2.0.0",
+                "which-module": "^2.0.0",
+                "y18n": "^3.2.1",
+                "yargs-parser": "^9.0.2"
+              },
+              "dependencies": {
+                "cliui": {
+                  "version": "4.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "string-width": "^2.1.1",
+                    "strip-ansi": "^4.0.0",
+                    "wrap-ansi": "^2.0.0"
+                  },
+                  "dependencies": {
+                    "wrap-ansi": {
+                      "version": "2.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "string-width": "^1.0.1",
+                        "strip-ansi": "^3.0.1"
+                      },
+                      "dependencies": {
+                        "string-width": {
+                          "version": "1.0.2",
+                          "bundled": true,
+                          "requires": {
+                            "code-point-at": "^1.0.0",
+                            "is-fullwidth-code-point": "^1.0.0",
+                            "strip-ansi": "^3.0.0"
+                          },
+                          "dependencies": {
+                            "code-point-at": {
+                              "version": "1.1.0",
+                              "bundled": true
+                            },
+                            "is-fullwidth-code-point": {
+                              "version": "1.0.0",
+                              "bundled": true,
+                              "requires": {
+                                "number-is-nan": "^1.0.0"
+                              },
+                              "dependencies": {
+                                "number-is-nan": {
+                                  "version": "1.0.1",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "strip-ansi": {
+                          "version": "3.0.1",
+                          "bundled": true,
+                          "requires": {
+                            "ansi-regex": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "ansi-regex": {
+                              "version": "2.1.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "decamelize": {
+                  "version": "1.2.0",
+                  "bundled": true
+                },
+                "find-up": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "locate-path": "^2.0.0"
+                  },
+                  "dependencies": {
+                    "locate-path": {
+                      "version": "2.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "p-locate": "^2.0.0",
+                        "path-exists": "^3.0.0"
+                      },
+                      "dependencies": {
+                        "p-locate": {
+                          "version": "2.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "p-limit": "^1.1.0"
+                          },
+                          "dependencies": {
+                            "p-limit": {
+                              "version": "1.2.0",
+                              "bundled": true,
+                              "requires": {
+                                "p-try": "^1.0.0"
+                              },
+                              "dependencies": {
+                                "p-try": {
+                                  "version": "1.0.0",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "path-exists": {
+                          "version": "3.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "get-caller-file": {
+                  "version": "1.0.2",
+                  "bundled": true
+                },
+                "os-locale": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "execa": "^0.7.0",
+                    "lcid": "^1.0.0",
+                    "mem": "^1.1.0"
+                  },
+                  "dependencies": {
+                    "execa": {
+                      "version": "0.7.0",
+                      "bundled": true,
+                      "requires": {
+                        "cross-spawn": "^5.0.1",
+                        "get-stream": "^3.0.0",
+                        "is-stream": "^1.1.0",
+                        "npm-run-path": "^2.0.0",
+                        "p-finally": "^1.0.0",
+                        "signal-exit": "^3.0.0",
+                        "strip-eof": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "cross-spawn": {
+                          "version": "5.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "lru-cache": "^4.0.1",
+                            "shebang-command": "^1.2.0",
+                            "which": "^1.2.9"
+                          },
+                          "dependencies": {
+                            "shebang-command": {
+                              "version": "1.2.0",
+                              "bundled": true,
+                              "requires": {
+                                "shebang-regex": "^1.0.0"
+                              },
+                              "dependencies": {
+                                "shebang-regex": {
+                                  "version": "1.0.0",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "get-stream": {
+                          "version": "3.0.0",
+                          "bundled": true
+                        },
+                        "is-stream": {
+                          "version": "1.1.0",
+                          "bundled": true
+                        },
+                        "npm-run-path": {
+                          "version": "2.0.2",
+                          "bundled": true,
+                          "requires": {
+                            "path-key": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "path-key": {
+                              "version": "2.0.1",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "p-finally": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        },
+                        "signal-exit": {
+                          "version": "3.0.2",
+                          "bundled": true
+                        },
+                        "strip-eof": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "lcid": {
+                      "version": "1.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "invert-kv": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "invert-kv": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "mem": {
+                      "version": "1.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "mimic-fn": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "mimic-fn": {
+                          "version": "1.2.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "require-directory": {
+                  "version": "2.1.1",
+                  "bundled": true
+                },
+                "require-main-filename": {
+                  "version": "1.0.1",
+                  "bundled": true
+                },
+                "set-blocking": {
+                  "version": "2.0.0",
+                  "bundled": true
+                },
+                "string-width": {
+                  "version": "2.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "is-fullwidth-code-point": "^2.0.0",
+                    "strip-ansi": "^4.0.0"
+                  },
+                  "dependencies": {
+                    "is-fullwidth-code-point": {
+                      "version": "2.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "which-module": {
+                  "version": "2.0.0",
+                  "bundled": true
+                },
+                "y18n": {
+                  "version": "3.2.1",
+                  "bundled": true
+                },
+                "yargs-parser": {
+                  "version": "9.0.2",
+                  "bundled": true,
+                  "requires": {
+                    "camelcase": "^4.1.0"
+                  },
+                  "dependencies": {
+                    "camelcase": {
+                      "version": "4.1.0",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "lock-verify": {
+          "version": "2.0.2",
+          "bundled": true,
+          "requires": {
+            "npm-package-arg": "^5.1.2 || 6",
+            "semver": "^5.4.1"
+          }
+        },
+        "lockfile": {
+          "version": "1.0.4",
+          "bundled": true,
+          "requires": {
+            "signal-exit": "^3.0.2"
+          },
+          "dependencies": {
+            "signal-exit": {
+              "version": "3.0.2",
+              "bundled": true
+            }
+          }
+        },
+        "lodash._baseindexof": {
+          "version": "3.1.0",
+          "bundled": true
+        },
+        "lodash._baseuniq": {
+          "version": "4.6.0",
+          "bundled": true,
+          "requires": {
+            "lodash._createset": "~4.0.0",
+            "lodash._root": "~3.0.0"
+          },
+          "dependencies": {
+            "lodash._createset": {
+              "version": "4.0.3",
+              "bundled": true
+            },
+            "lodash._root": {
+              "version": "3.0.1",
+              "bundled": true
+            }
+          }
+        },
+        "lodash._bindcallback": {
+          "version": "3.0.1",
+          "bundled": true
+        },
+        "lodash._cacheindexof": {
+          "version": "3.0.2",
+          "bundled": true
+        },
+        "lodash._createcache": {
+          "version": "3.1.2",
+          "bundled": true,
+          "requires": {
+            "lodash._getnative": "^3.0.0"
+          }
+        },
+        "lodash._getnative": {
+          "version": "3.9.1",
+          "bundled": true
+        },
+        "lodash.clonedeep": {
+          "version": "4.5.0",
+          "bundled": true
+        },
+        "lodash.restparam": {
+          "version": "3.6.1",
+          "bundled": true
+        },
+        "lodash.union": {
+          "version": "4.6.0",
+          "bundled": true
+        },
+        "lodash.uniq": {
+          "version": "4.5.0",
+          "bundled": true
+        },
+        "lodash.without": {
+          "version": "4.4.0",
+          "bundled": true
+        },
+        "lru-cache": {
+          "version": "4.1.3",
+          "bundled": true,
+          "requires": {
+            "pseudomap": "^1.0.2",
+            "yallist": "^2.1.2"
+          },
+          "dependencies": {
+            "pseudomap": {
+              "version": "1.0.2",
+              "bundled": true
+            },
+            "yallist": {
+              "version": "2.1.2",
+              "bundled": true
+            }
+          }
+        },
+        "meant": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "mississippi": {
+          "version": "3.0.0",
+          "bundled": true,
+          "requires": {
+            "concat-stream": "^1.5.0",
+            "duplexify": "^3.4.2",
+            "end-of-stream": "^1.1.0",
+            "flush-write-stream": "^1.0.0",
+            "from2": "^2.1.0",
+            "parallel-transform": "^1.1.0",
+            "pump": "^3.0.0",
+            "pumpify": "^1.3.3",
+            "stream-each": "^1.1.0",
+            "through2": "^2.0.0"
+          },
+          "dependencies": {
+            "concat-stream": {
+              "version": "1.6.1",
+              "bundled": true,
+              "requires": {
+                "inherits": "^2.0.3",
+                "readable-stream": "^2.2.2",
+                "typedarray": "^0.0.6"
+              },
+              "dependencies": {
+                "typedarray": {
+                  "version": "0.0.6",
+                  "bundled": true
+                }
+              }
+            },
+            "duplexify": {
+              "version": "3.5.4",
+              "bundled": true,
+              "requires": {
+                "end-of-stream": "^1.0.0",
+                "inherits": "^2.0.1",
+                "readable-stream": "^2.0.0",
+                "stream-shift": "^1.0.0"
+              },
+              "dependencies": {
+                "stream-shift": {
+                  "version": "1.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "end-of-stream": {
+              "version": "1.4.1",
+              "bundled": true,
+              "requires": {
+                "once": "^1.4.0"
+              }
+            },
+            "flush-write-stream": {
+              "version": "1.0.2",
+              "bundled": true,
+              "requires": {
+                "inherits": "^2.0.1",
+                "readable-stream": "^2.0.4"
+              }
+            },
+            "from2": {
+              "version": "2.3.0",
+              "bundled": true,
+              "requires": {
+                "inherits": "^2.0.1",
+                "readable-stream": "^2.0.0"
+              }
+            },
+            "parallel-transform": {
+              "version": "1.1.0",
+              "bundled": true,
+              "requires": {
+                "cyclist": "~0.2.2",
+                "inherits": "^2.0.3",
+                "readable-stream": "^2.1.5"
+              },
+              "dependencies": {
+                "cyclist": {
+                  "version": "0.2.2",
+                  "bundled": true
+                }
+              }
+            },
+            "pump": {
+              "version": "3.0.0",
+              "bundled": true,
+              "requires": {
+                "end-of-stream": "^1.1.0",
+                "once": "^1.3.1"
+              }
+            },
+            "pumpify": {
+              "version": "1.4.0",
+              "bundled": true,
+              "requires": {
+                "duplexify": "^3.5.3",
+                "inherits": "^2.0.3",
+                "pump": "^2.0.0"
+              },
+              "dependencies": {
+                "pump": {
+                  "version": "2.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "end-of-stream": "^1.1.0",
+                    "once": "^1.3.1"
+                  }
+                }
+              }
+            },
+            "stream-each": {
+              "version": "1.2.2",
+              "bundled": true,
+              "requires": {
+                "end-of-stream": "^1.1.0",
+                "stream-shift": "^1.0.0"
+              },
+              "dependencies": {
+                "stream-shift": {
+                  "version": "1.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "through2": {
+              "version": "2.0.3",
+              "bundled": true,
+              "requires": {
+                "readable-stream": "^2.1.5",
+                "xtend": "~4.0.1"
+              },
+              "dependencies": {
+                "xtend": {
+                  "version": "4.0.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "mkdirp": {
+          "version": "0.5.1",
+          "bundled": true,
+          "requires": {
+            "minimist": "0.0.8"
+          },
+          "dependencies": {
+            "minimist": {
+              "version": "0.0.8",
+              "bundled": true
+            }
+          }
+        },
+        "move-concurrently": {
+          "version": "1.0.1",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.1.1",
+            "copy-concurrently": "^1.0.0",
+            "fs-write-stream-atomic": "^1.0.8",
+            "mkdirp": "^0.5.1",
+            "rimraf": "^2.5.4",
+            "run-queue": "^1.0.3"
+          },
+          "dependencies": {
+            "copy-concurrently": {
+              "version": "1.0.5",
+              "bundled": true,
+              "requires": {
+                "aproba": "^1.1.1",
+                "fs-write-stream-atomic": "^1.0.8",
+                "iferr": "^0.1.5",
+                "mkdirp": "^0.5.1",
+                "rimraf": "^2.5.4",
+                "run-queue": "^1.0.0"
+              },
+              "dependencies": {
+                "iferr": {
+                  "version": "0.1.5",
+                  "bundled": true
+                }
+              }
+            },
+            "run-queue": {
+              "version": "1.0.3",
+              "bundled": true,
+              "requires": {
+                "aproba": "^1.1.1"
+              }
+            }
+          }
+        },
+        "node-gyp": {
+          "version": "3.6.2",
+          "bundled": true,
+          "requires": {
+            "fstream": "^1.0.0",
+            "glob": "^7.0.3",
+            "graceful-fs": "^4.1.2",
+            "minimatch": "^3.0.2",
+            "mkdirp": "^0.5.0",
+            "nopt": "2 || 3",
+            "npmlog": "0 || 1 || 2 || 3 || 4",
+            "osenv": "0",
+            "request": "2",
+            "rimraf": "2",
+            "semver": "~5.3.0",
+            "tar": "^2.0.0",
+            "which": "1"
+          },
+          "dependencies": {
+            "fstream": {
+              "version": "1.0.11",
+              "bundled": true,
+              "requires": {
+                "graceful-fs": "^4.1.2",
+                "inherits": "~2.0.0",
+                "mkdirp": ">=0.5 0",
+                "rimraf": "2"
+              }
+            },
+            "minimatch": {
+              "version": "3.0.4",
+              "bundled": true,
+              "requires": {
+                "brace-expansion": "^1.1.7"
+              },
+              "dependencies": {
+                "brace-expansion": {
+                  "version": "1.1.11",
+                  "bundled": true,
+                  "requires": {
+                    "balanced-match": "^1.0.0",
+                    "concat-map": "0.0.1"
+                  },
+                  "dependencies": {
+                    "balanced-match": {
+                      "version": "1.0.0",
+                      "bundled": true
+                    },
+                    "concat-map": {
+                      "version": "0.0.1",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "nopt": {
+              "version": "3.0.6",
+              "bundled": true,
+              "requires": {
+                "abbrev": "1"
+              }
+            },
+            "semver": {
+              "version": "5.3.0",
+              "bundled": true
+            },
+            "tar": {
+              "version": "2.2.1",
+              "bundled": true,
+              "requires": {
+                "block-stream": "*",
+                "fstream": "^1.0.2",
+                "inherits": "2"
+              },
+              "dependencies": {
+                "block-stream": {
+                  "version": "0.0.9",
+                  "bundled": true,
+                  "requires": {
+                    "inherits": "~2.0.0"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "nopt": {
+          "version": "4.0.1",
+          "bundled": true,
+          "requires": {
+            "abbrev": "1",
+            "osenv": "^0.1.4"
+          }
+        },
+        "normalize-package-data": {
+          "version": "2.4.0",
+          "bundled": true,
+          "requires": {
+            "hosted-git-info": "^2.1.4",
+            "is-builtin-module": "^1.0.0",
+            "semver": "2 || 3 || 4 || 5",
+            "validate-npm-package-license": "^3.0.1"
+          },
+          "dependencies": {
+            "is-builtin-module": {
+              "version": "1.0.0",
+              "bundled": true,
+              "requires": {
+                "builtin-modules": "^1.0.0"
+              },
+              "dependencies": {
+                "builtin-modules": {
+                  "version": "1.1.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "npm-audit-report": {
+          "version": "1.2.1",
+          "bundled": true,
+          "requires": {
+            "cli-table2": "^0.2.0",
+            "console-control-strings": "^1.1.0"
+          },
+          "dependencies": {
+            "console-control-strings": {
+              "version": "1.1.0",
+              "bundled": true
+            }
+          }
+        },
+        "npm-cache-filename": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "npm-install-checks": {
+          "version": "3.0.0",
+          "bundled": true,
+          "requires": {
+            "semver": "^2.3.0 || 3.x || 4 || 5"
+          }
+        },
+        "npm-lifecycle": {
+          "version": "2.0.3",
+          "bundled": true,
+          "requires": {
+            "byline": "^5.0.0",
+            "graceful-fs": "^4.1.11",
+            "node-gyp": "^3.6.2",
+            "resolve-from": "^4.0.0",
+            "slide": "^1.1.6",
+            "uid-number": "0.0.6",
+            "umask": "^1.1.0",
+            "which": "^1.3.0"
+          },
+          "dependencies": {
+            "byline": {
+              "version": "5.0.0",
+              "bundled": true
+            },
+            "resolve-from": {
+              "version": "4.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "npm-package-arg": {
+          "version": "6.1.0",
+          "bundled": true,
+          "requires": {
+            "hosted-git-info": "^2.6.0",
+            "osenv": "^0.1.5",
+            "semver": "^5.5.0",
+            "validate-npm-package-name": "^3.0.0"
+          }
+        },
+        "npm-packlist": {
+          "version": "1.1.10",
+          "bundled": true,
+          "requires": {
+            "ignore-walk": "^3.0.1",
+            "npm-bundled": "^1.0.1"
+          },
+          "dependencies": {
+            "ignore-walk": {
+              "version": "3.0.1",
+              "bundled": true,
+              "requires": {
+                "minimatch": "^3.0.4"
+              },
+              "dependencies": {
+                "minimatch": {
+                  "version": "3.0.4",
+                  "bundled": true,
+                  "requires": {
+                    "brace-expansion": "^1.1.7"
+                  },
+                  "dependencies": {
+                    "brace-expansion": {
+                      "version": "1.1.8",
+                      "bundled": true,
+                      "requires": {
+                        "balanced-match": "^1.0.0",
+                        "concat-map": "0.0.1"
+                      },
+                      "dependencies": {
+                        "balanced-match": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        },
+                        "concat-map": {
+                          "version": "0.0.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "npm-bundled": {
+              "version": "1.0.3",
+              "bundled": true
+            }
+          }
+        },
+        "npm-pick-manifest": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "npm-package-arg": "^6.0.0",
+            "semver": "^5.4.1"
+          }
+        },
+        "npm-profile": {
+          "version": "3.0.1",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.1.2",
+            "make-fetch-happen": "^2.5.0"
+          },
+          "dependencies": {
+            "make-fetch-happen": {
+              "version": "2.6.0",
+              "bundled": true,
+              "requires": {
+                "agentkeepalive": "^3.3.0",
+                "cacache": "^10.0.0",
+                "http-cache-semantics": "^3.8.0",
+                "http-proxy-agent": "^2.0.0",
+                "https-proxy-agent": "^2.1.0",
+                "lru-cache": "^4.1.1",
+                "mississippi": "^1.2.0",
+                "node-fetch-npm": "^2.0.2",
+                "promise-retry": "^1.1.1",
+                "socks-proxy-agent": "^3.0.1",
+                "ssri": "^5.0.0"
+              },
+              "dependencies": {
+                "agentkeepalive": {
+                  "version": "3.3.0",
+                  "bundled": true,
+                  "requires": {
+                    "humanize-ms": "^1.2.1"
+                  },
+                  "dependencies": {
+                    "humanize-ms": {
+                      "version": "1.2.1",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.1.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "cacache": {
+                  "version": "10.0.4",
+                  "bundled": true,
+                  "requires": {
+                    "bluebird": "^3.5.1",
+                    "chownr": "^1.0.1",
+                    "glob": "^7.1.2",
+                    "graceful-fs": "^4.1.11",
+                    "lru-cache": "^4.1.1",
+                    "mississippi": "^2.0.0",
+                    "mkdirp": "^0.5.1",
+                    "move-concurrently": "^1.0.1",
+                    "promise-inflight": "^1.0.1",
+                    "rimraf": "^2.6.2",
+                    "ssri": "^5.2.4",
+                    "unique-filename": "^1.1.0",
+                    "y18n": "^4.0.0"
+                  },
+                  "dependencies": {
+                    "mississippi": {
+                      "version": "2.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "concat-stream": "^1.5.0",
+                        "duplexify": "^3.4.2",
+                        "end-of-stream": "^1.1.0",
+                        "flush-write-stream": "^1.0.0",
+                        "from2": "^2.1.0",
+                        "parallel-transform": "^1.1.0",
+                        "pump": "^2.0.1",
+                        "pumpify": "^1.3.3",
+                        "stream-each": "^1.1.0",
+                        "through2": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "concat-stream": {
+                          "version": "1.6.2",
+                          "bundled": true,
+                          "requires": {
+                            "buffer-from": "^1.0.0",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.2.2",
+                            "typedarray": "^0.0.6"
+                          },
+                          "dependencies": {
+                            "buffer-from": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            },
+                            "typedarray": {
+                              "version": "0.0.6",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "duplexify": {
+                          "version": "3.5.4",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.0.0",
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "end-of-stream": {
+                          "version": "1.4.1",
+                          "bundled": true,
+                          "requires": {
+                            "once": "^1.4.0"
+                          }
+                        },
+                        "flush-write-stream": {
+                          "version": "1.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.4"
+                          }
+                        },
+                        "from2": {
+                          "version": "2.3.0",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0"
+                          }
+                        },
+                        "parallel-transform": {
+                          "version": "1.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "cyclist": "~0.2.2",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.1.5"
+                          },
+                          "dependencies": {
+                            "cyclist": {
+                              "version": "0.2.2",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "pump": {
+                          "version": "2.0.1",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "once": "^1.3.1"
+                          }
+                        },
+                        "pumpify": {
+                          "version": "1.4.0",
+                          "bundled": true,
+                          "requires": {
+                            "duplexify": "^3.5.3",
+                            "inherits": "^2.0.3",
+                            "pump": "^2.0.0"
+                          }
+                        },
+                        "stream-each": {
+                          "version": "1.2.2",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "through2": {
+                          "version": "2.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "readable-stream": "^2.1.5",
+                            "xtend": "~4.0.1"
+                          },
+                          "dependencies": {
+                            "xtend": {
+                              "version": "4.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "y18n": {
+                      "version": "4.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "http-cache-semantics": {
+                  "version": "3.8.1",
+                  "bundled": true
+                },
+                "http-proxy-agent": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "4",
+                    "debug": "3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "https-proxy-agent": {
+                  "version": "2.2.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "^4.1.0",
+                    "debug": "^3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "mississippi": {
+                  "version": "1.3.1",
+                  "bundled": true,
+                  "requires": {
+                    "concat-stream": "^1.5.0",
+                    "duplexify": "^3.4.2",
+                    "end-of-stream": "^1.1.0",
+                    "flush-write-stream": "^1.0.0",
+                    "from2": "^2.1.0",
+                    "parallel-transform": "^1.1.0",
+                    "pump": "^1.0.0",
+                    "pumpify": "^1.3.3",
+                    "stream-each": "^1.1.0",
+                    "through2": "^2.0.0"
+                  },
+                  "dependencies": {
+                    "concat-stream": {
+                      "version": "1.6.0",
+                      "bundled": true,
+                      "requires": {
+                        "inherits": "^2.0.3",
+                        "readable-stream": "^2.2.2",
+                        "typedarray": "^0.0.6"
+                      },
+                      "dependencies": {
+                        "typedarray": {
+                          "version": "0.0.6",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "duplexify": {
+                      "version": "3.5.3",
+                      "bundled": true,
+                      "requires": {
+                        "end-of-stream": "^1.0.0",
+                        "inherits": "^2.0.1",
+                        "readable-stream": "^2.0.0",
+                        "stream-shift": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "stream-shift": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "end-of-stream": {
+                      "version": "1.4.1",
+                      "bundled": true,
+                      "requires": {
+                        "once": "^1.4.0"
+                      }
+                    },
+                    "flush-write-stream": {
+                      "version": "1.0.2",
+                      "bundled": true,
+                      "requires": {
+                        "inherits": "^2.0.1",
+                        "readable-stream": "^2.0.4"
+                      }
+                    },
+                    "from2": {
+                      "version": "2.3.0",
+                      "bundled": true,
+                      "requires": {
+                        "inherits": "^2.0.1",
+                        "readable-stream": "^2.0.0"
+                      }
+                    },
+                    "parallel-transform": {
+                      "version": "1.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "cyclist": "~0.2.2",
+                        "inherits": "^2.0.3",
+                        "readable-stream": "^2.1.5"
+                      },
+                      "dependencies": {
+                        "cyclist": {
+                          "version": "0.2.2",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "pump": {
+                      "version": "1.0.3",
+                      "bundled": true,
+                      "requires": {
+                        "end-of-stream": "^1.1.0",
+                        "once": "^1.3.1"
+                      }
+                    },
+                    "pumpify": {
+                      "version": "1.4.0",
+                      "bundled": true,
+                      "requires": {
+                        "duplexify": "^3.5.3",
+                        "inherits": "^2.0.3",
+                        "pump": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "pump": {
+                          "version": "2.0.1",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "once": "^1.3.1"
+                          }
+                        }
+                      }
+                    },
+                    "stream-each": {
+                      "version": "1.2.2",
+                      "bundled": true,
+                      "requires": {
+                        "end-of-stream": "^1.1.0",
+                        "stream-shift": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "stream-shift": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "through2": {
+                      "version": "2.0.3",
+                      "bundled": true,
+                      "requires": {
+                        "readable-stream": "^2.1.5",
+                        "xtend": "~4.0.1"
+                      },
+                      "dependencies": {
+                        "xtend": {
+                          "version": "4.0.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "node-fetch-npm": {
+                  "version": "2.0.2",
+                  "bundled": true,
+                  "requires": {
+                    "encoding": "^0.1.11",
+                    "json-parse-better-errors": "^1.0.0",
+                    "safe-buffer": "^5.1.1"
+                  },
+                  "dependencies": {
+                    "encoding": {
+                      "version": "0.1.12",
+                      "bundled": true,
+                      "requires": {
+                        "iconv-lite": "~0.4.13"
+                      },
+                      "dependencies": {
+                        "iconv-lite": {
+                          "version": "0.4.19",
+                          "bundled": true
+                        }
+                      }
+                    },
+                    "json-parse-better-errors": {
+                      "version": "1.0.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "promise-retry": {
+                  "version": "1.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "err-code": "^1.0.0",
+                    "retry": "^0.10.0"
+                  },
+                  "dependencies": {
+                    "err-code": {
+                      "version": "1.1.2",
+                      "bundled": true
+                    },
+                    "retry": {
+                      "version": "0.10.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "socks-proxy-agent": {
+                  "version": "3.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "^4.1.0",
+                    "socks": "^1.1.10"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "socks": {
+                      "version": "1.1.10",
+                      "bundled": true,
+                      "requires": {
+                        "ip": "^1.1.4",
+                        "smart-buffer": "^1.0.13"
+                      },
+                      "dependencies": {
+                        "ip": {
+                          "version": "1.1.5",
+                          "bundled": true
+                        },
+                        "smart-buffer": {
+                          "version": "1.1.15",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "ssri": {
+                  "version": "5.3.0",
+                  "bundled": true,
+                  "requires": {
+                    "safe-buffer": "^5.1.1"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "npm-registry-client": {
+          "version": "8.5.1",
+          "bundled": true,
+          "requires": {
+            "concat-stream": "^1.5.2",
+            "graceful-fs": "^4.1.6",
+            "normalize-package-data": "~1.0.1 || ^2.0.0",
+            "npm-package-arg": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0",
+            "npmlog": "2 || ^3.1.0 || ^4.0.0",
+            "once": "^1.3.3",
+            "request": "^2.74.0",
+            "retry": "^0.10.0",
+            "safe-buffer": "^5.1.1",
+            "semver": "2 >=2.2.1 || 3.x || 4 || 5",
+            "slide": "^1.1.3",
+            "ssri": "^5.2.4"
+          },
+          "dependencies": {
+            "concat-stream": {
+              "version": "1.6.1",
+              "bundled": true,
+              "requires": {
+                "inherits": "^2.0.3",
+                "readable-stream": "^2.2.2",
+                "typedarray": "^0.0.6"
+              },
+              "dependencies": {
+                "typedarray": {
+                  "version": "0.0.6",
+                  "bundled": true
+                }
+              }
+            },
+            "retry": {
+              "version": "0.10.1",
+              "bundled": true
+            },
+            "ssri": {
+              "version": "5.3.0",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "^5.1.1"
+              }
+            }
+          }
+        },
+        "npm-registry-fetch": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "bluebird": "^3.5.1",
+            "figgy-pudding": "^2.0.1",
+            "lru-cache": "^4.1.2",
+            "make-fetch-happen": "^3.0.0",
+            "npm-package-arg": "^6.0.0",
+            "safe-buffer": "^5.1.1"
+          },
+          "dependencies": {
+            "figgy-pudding": {
+              "version": "2.0.1",
+              "bundled": true
+            },
+            "make-fetch-happen": {
+              "version": "3.0.0",
+              "bundled": true,
+              "requires": {
+                "agentkeepalive": "^3.4.1",
+                "cacache": "^10.0.4",
+                "http-cache-semantics": "^3.8.1",
+                "http-proxy-agent": "^2.1.0",
+                "https-proxy-agent": "^2.2.0",
+                "lru-cache": "^4.1.2",
+                "mississippi": "^3.0.0",
+                "node-fetch-npm": "^2.0.2",
+                "promise-retry": "^1.1.1",
+                "socks-proxy-agent": "^3.0.1",
+                "ssri": "^5.2.4"
+              },
+              "dependencies": {
+                "agentkeepalive": {
+                  "version": "3.4.1",
+                  "bundled": true,
+                  "requires": {
+                    "humanize-ms": "^1.2.1"
+                  },
+                  "dependencies": {
+                    "humanize-ms": {
+                      "version": "1.2.1",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.1.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "cacache": {
+                  "version": "10.0.4",
+                  "bundled": true,
+                  "requires": {
+                    "bluebird": "^3.5.1",
+                    "chownr": "^1.0.1",
+                    "glob": "^7.1.2",
+                    "graceful-fs": "^4.1.11",
+                    "lru-cache": "^4.1.1",
+                    "mississippi": "^2.0.0",
+                    "mkdirp": "^0.5.1",
+                    "move-concurrently": "^1.0.1",
+                    "promise-inflight": "^1.0.1",
+                    "rimraf": "^2.6.2",
+                    "ssri": "^5.2.4",
+                    "unique-filename": "^1.1.0",
+                    "y18n": "^4.0.0"
+                  },
+                  "dependencies": {
+                    "mississippi": {
+                      "version": "2.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "concat-stream": "^1.5.0",
+                        "duplexify": "^3.4.2",
+                        "end-of-stream": "^1.1.0",
+                        "flush-write-stream": "^1.0.0",
+                        "from2": "^2.1.0",
+                        "parallel-transform": "^1.1.0",
+                        "pump": "^2.0.1",
+                        "pumpify": "^1.3.3",
+                        "stream-each": "^1.1.0",
+                        "through2": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "concat-stream": {
+                          "version": "1.6.2",
+                          "bundled": true,
+                          "requires": {
+                            "buffer-from": "^1.0.0",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.2.2",
+                            "typedarray": "^0.0.6"
+                          },
+                          "dependencies": {
+                            "buffer-from": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            },
+                            "typedarray": {
+                              "version": "0.0.6",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "duplexify": {
+                          "version": "3.5.4",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.0.0",
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "end-of-stream": {
+                          "version": "1.4.1",
+                          "bundled": true,
+                          "requires": {
+                            "once": "^1.4.0"
+                          }
+                        },
+                        "flush-write-stream": {
+                          "version": "1.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.4"
+                          }
+                        },
+                        "from2": {
+                          "version": "2.3.0",
+                          "bundled": true,
+                          "requires": {
+                            "inherits": "^2.0.1",
+                            "readable-stream": "^2.0.0"
+                          }
+                        },
+                        "parallel-transform": {
+                          "version": "1.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "cyclist": "~0.2.2",
+                            "inherits": "^2.0.3",
+                            "readable-stream": "^2.1.5"
+                          },
+                          "dependencies": {
+                            "cyclist": {
+                              "version": "0.2.2",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "pump": {
+                          "version": "2.0.1",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "once": "^1.3.1"
+                          }
+                        },
+                        "pumpify": {
+                          "version": "1.4.0",
+                          "bundled": true,
+                          "requires": {
+                            "duplexify": "^3.5.3",
+                            "inherits": "^2.0.3",
+                            "pump": "^2.0.0"
+                          }
+                        },
+                        "stream-each": {
+                          "version": "1.2.2",
+                          "bundled": true,
+                          "requires": {
+                            "end-of-stream": "^1.1.0",
+                            "stream-shift": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "stream-shift": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "through2": {
+                          "version": "2.0.3",
+                          "bundled": true,
+                          "requires": {
+                            "readable-stream": "^2.1.5",
+                            "xtend": "~4.0.1"
+                          },
+                          "dependencies": {
+                            "xtend": {
+                              "version": "4.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "y18n": {
+                      "version": "4.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "http-cache-semantics": {
+                  "version": "3.8.1",
+                  "bundled": true
+                },
+                "http-proxy-agent": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "4",
+                    "debug": "3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "https-proxy-agent": {
+                  "version": "2.2.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "^4.1.0",
+                    "debug": "^3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "node-fetch-npm": {
+                  "version": "2.0.2",
+                  "bundled": true,
+                  "requires": {
+                    "encoding": "^0.1.11",
+                    "json-parse-better-errors": "^1.0.0",
+                    "safe-buffer": "^5.1.1"
+                  },
+                  "dependencies": {
+                    "encoding": {
+                      "version": "0.1.12",
+                      "bundled": true,
+                      "requires": {
+                        "iconv-lite": "~0.4.13"
+                      },
+                      "dependencies": {
+                        "iconv-lite": {
+                          "version": "0.4.21",
+                          "bundled": true,
+                          "requires": {
+                            "safer-buffer": "^2.1.0"
+                          },
+                          "dependencies": {
+                            "safer-buffer": {
+                              "version": "2.1.2",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "promise-retry": {
+                  "version": "1.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "err-code": "^1.0.0",
+                    "retry": "^0.10.0"
+                  },
+                  "dependencies": {
+                    "err-code": {
+                      "version": "1.1.2",
+                      "bundled": true
+                    },
+                    "retry": {
+                      "version": "0.10.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "socks-proxy-agent": {
+                  "version": "3.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "^4.1.0",
+                    "socks": "^1.1.10"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "socks": {
+                      "version": "1.1.10",
+                      "bundled": true,
+                      "requires": {
+                        "ip": "^1.1.4",
+                        "smart-buffer": "^1.0.13"
+                      },
+                      "dependencies": {
+                        "ip": {
+                          "version": "1.1.5",
+                          "bundled": true
+                        },
+                        "smart-buffer": {
+                          "version": "1.1.15",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "ssri": {
+                  "version": "5.3.0",
+                  "bundled": true,
+                  "requires": {
+                    "safe-buffer": "^5.1.1"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "npm-user-validate": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "npmlog": {
+          "version": "4.1.2",
+          "bundled": true,
+          "requires": {
+            "are-we-there-yet": "~1.1.2",
+            "console-control-strings": "~1.1.0",
+            "gauge": "~2.7.3",
+            "set-blocking": "~2.0.0"
+          },
+          "dependencies": {
+            "are-we-there-yet": {
+              "version": "1.1.4",
+              "bundled": true,
+              "requires": {
+                "delegates": "^1.0.0",
+                "readable-stream": "^2.0.6"
+              },
+              "dependencies": {
+                "delegates": {
+                  "version": "1.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "console-control-strings": {
+              "version": "1.1.0",
+              "bundled": true
+            },
+            "gauge": {
+              "version": "2.7.4",
+              "bundled": true,
+              "requires": {
+                "aproba": "^1.0.3",
+                "console-control-strings": "^1.0.0",
+                "has-unicode": "^2.0.0",
+                "object-assign": "^4.1.0",
+                "signal-exit": "^3.0.0",
+                "string-width": "^1.0.1",
+                "strip-ansi": "^3.0.1",
+                "wide-align": "^1.1.0"
+              },
+              "dependencies": {
+                "object-assign": {
+                  "version": "4.1.1",
+                  "bundled": true
+                },
+                "signal-exit": {
+                  "version": "3.0.2",
+                  "bundled": true
+                },
+                "string-width": {
+                  "version": "1.0.2",
+                  "bundled": true,
+                  "requires": {
+                    "code-point-at": "^1.0.0",
+                    "is-fullwidth-code-point": "^1.0.0",
+                    "strip-ansi": "^3.0.0"
+                  },
+                  "dependencies": {
+                    "code-point-at": {
+                      "version": "1.1.0",
+                      "bundled": true
+                    },
+                    "is-fullwidth-code-point": {
+                      "version": "1.0.0",
+                      "bundled": true,
+                      "requires": {
+                        "number-is-nan": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "number-is-nan": {
+                          "version": "1.0.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "strip-ansi": {
+                  "version": "3.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "ansi-regex": "^2.0.0"
+                  },
+                  "dependencies": {
+                    "ansi-regex": {
+                      "version": "2.1.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "wide-align": {
+                  "version": "1.1.2",
+                  "bundled": true,
+                  "requires": {
+                    "string-width": "^1.0.2"
+                  }
+                }
+              }
+            },
+            "set-blocking": {
+              "version": "2.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "once": {
+          "version": "1.4.0",
+          "bundled": true,
+          "requires": {
+            "wrappy": "1"
+          }
+        },
+        "opener": {
+          "version": "1.4.3",
+          "bundled": true
+        },
+        "osenv": {
+          "version": "0.1.5",
+          "bundled": true,
+          "requires": {
+            "os-homedir": "^1.0.0",
+            "os-tmpdir": "^1.0.0"
+          },
+          "dependencies": {
+            "os-homedir": {
+              "version": "1.0.2",
+              "bundled": true
+            },
+            "os-tmpdir": {
+              "version": "1.0.2",
+              "bundled": true
+            }
+          }
+        },
+        "pacote": {
+          "version": "8.1.5",
+          "bundled": true,
+          "requires": {
+            "bluebird": "^3.5.1",
+            "cacache": "^11.0.2",
+            "get-stream": "^3.0.0",
+            "glob": "^7.1.2",
+            "lru-cache": "^4.1.3",
+            "make-fetch-happen": "^4.0.1",
+            "minimatch": "^3.0.4",
+            "minipass": "^2.3.3",
+            "mississippi": "^3.0.0",
+            "mkdirp": "^0.5.1",
+            "normalize-package-data": "^2.4.0",
+            "npm-package-arg": "^6.1.0",
+            "npm-packlist": "^1.1.10",
+            "npm-pick-manifest": "^2.1.0",
+            "osenv": "^0.1.5",
+            "promise-inflight": "^1.0.1",
+            "promise-retry": "^1.1.1",
+            "protoduck": "^5.0.0",
+            "rimraf": "^2.6.2",
+            "safe-buffer": "^5.1.2",
+            "semver": "^5.5.0",
+            "ssri": "^6.0.0",
+            "tar": "4.4.1",
+            "unique-filename": "^1.1.0",
+            "which": "^1.3.0"
+          },
+          "dependencies": {
+            "get-stream": {
+              "version": "3.0.0",
+              "bundled": true
+            },
+            "make-fetch-happen": {
+              "version": "4.0.1",
+              "bundled": true,
+              "requires": {
+                "agentkeepalive": "^3.4.1",
+                "cacache": "^11.0.1",
+                "http-cache-semantics": "^3.8.1",
+                "http-proxy-agent": "^2.1.0",
+                "https-proxy-agent": "^2.2.1",
+                "lru-cache": "^4.1.2",
+                "mississippi": "^3.0.0",
+                "node-fetch-npm": "^2.0.2",
+                "promise-retry": "^1.1.1",
+                "socks-proxy-agent": "^4.0.0",
+                "ssri": "^6.0.0"
+              },
+              "dependencies": {
+                "agentkeepalive": {
+                  "version": "3.4.1",
+                  "bundled": true,
+                  "requires": {
+                    "humanize-ms": "^1.2.1"
+                  },
+                  "dependencies": {
+                    "humanize-ms": {
+                      "version": "1.2.1",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "^2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.1.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "http-cache-semantics": {
+                  "version": "3.8.1",
+                  "bundled": true
+                },
+                "http-proxy-agent": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "4",
+                    "debug": "3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "https-proxy-agent": {
+                  "version": "2.2.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "^4.1.0",
+                    "debug": "^3.1.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "debug": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "ms": "2.0.0"
+                      },
+                      "dependencies": {
+                        "ms": {
+                          "version": "2.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "node-fetch-npm": {
+                  "version": "2.0.2",
+                  "bundled": true,
+                  "requires": {
+                    "encoding": "^0.1.11",
+                    "json-parse-better-errors": "^1.0.0",
+                    "safe-buffer": "^5.1.1"
+                  },
+                  "dependencies": {
+                    "encoding": {
+                      "version": "0.1.12",
+                      "bundled": true,
+                      "requires": {
+                        "iconv-lite": "~0.4.13"
+                      },
+                      "dependencies": {
+                        "iconv-lite": {
+                          "version": "0.4.23",
+                          "bundled": true,
+                          "requires": {
+                            "safer-buffer": ">= 2.1.2 < 3"
+                          },
+                          "dependencies": {
+                            "safer-buffer": {
+                              "version": "2.1.2",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                },
+                "socks-proxy-agent": {
+                  "version": "4.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "agent-base": "~4.2.0",
+                    "socks": "~2.2.0"
+                  },
+                  "dependencies": {
+                    "agent-base": {
+                      "version": "4.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "es6-promisify": "^5.0.0"
+                      },
+                      "dependencies": {
+                        "es6-promisify": {
+                          "version": "5.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "es6-promise": "^4.0.3"
+                          },
+                          "dependencies": {
+                            "es6-promise": {
+                              "version": "4.2.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "socks": {
+                      "version": "2.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "ip": "^1.1.5",
+                        "smart-buffer": "^4.0.1"
+                      },
+                      "dependencies": {
+                        "ip": {
+                          "version": "1.1.5",
+                          "bundled": true
+                        },
+                        "smart-buffer": {
+                          "version": "4.0.1",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "minimatch": {
+              "version": "3.0.4",
+              "bundled": true,
+              "requires": {
+                "brace-expansion": "^1.1.7"
+              },
+              "dependencies": {
+                "brace-expansion": {
+                  "version": "1.1.11",
+                  "bundled": true,
+                  "requires": {
+                    "balanced-match": "^1.0.0",
+                    "concat-map": "0.0.1"
+                  },
+                  "dependencies": {
+                    "balanced-match": {
+                      "version": "1.0.0",
+                      "bundled": true
+                    },
+                    "concat-map": {
+                      "version": "0.0.1",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "minipass": {
+              "version": "2.3.3",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "^5.1.2",
+                "yallist": "^3.0.0"
+              },
+              "dependencies": {
+                "yallist": {
+                  "version": "3.0.2",
+                  "bundled": true
+                }
+              }
+            },
+            "promise-retry": {
+              "version": "1.1.1",
+              "bundled": true,
+              "requires": {
+                "err-code": "^1.0.0",
+                "retry": "^0.10.0"
+              },
+              "dependencies": {
+                "err-code": {
+                  "version": "1.1.2",
+                  "bundled": true
+                },
+                "retry": {
+                  "version": "0.10.1",
+                  "bundled": true
+                }
+              }
+            },
+            "protoduck": {
+              "version": "5.0.0",
+              "bundled": true,
+              "requires": {
+                "genfun": "^4.0.1"
+              },
+              "dependencies": {
+                "genfun": {
+                  "version": "4.0.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "path-is-inside": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "promise-inflight": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "qrcode-terminal": {
+          "version": "0.12.0",
+          "bundled": true
+        },
+        "query-string": {
+          "version": "6.1.0",
+          "bundled": true,
+          "requires": {
+            "decode-uri-component": "^0.2.0",
+            "strict-uri-encode": "^2.0.0"
+          },
+          "dependencies": {
+            "decode-uri-component": {
+              "version": "0.2.0",
+              "bundled": true
+            },
+            "strict-uri-encode": {
+              "version": "2.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "qw": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "read": {
+          "version": "1.0.7",
+          "bundled": true,
+          "requires": {
+            "mute-stream": "~0.0.4"
+          },
+          "dependencies": {
+            "mute-stream": {
+              "version": "0.0.7",
+              "bundled": true
+            }
+          }
+        },
+        "read-cmd-shim": {
+          "version": "1.0.1",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2"
+          }
+        },
+        "read-installed": {
+          "version": "4.0.3",
+          "bundled": true,
+          "requires": {
+            "debuglog": "^1.0.1",
+            "graceful-fs": "^4.1.2",
+            "read-package-json": "^2.0.0",
+            "readdir-scoped-modules": "^1.0.0",
+            "semver": "2 || 3 || 4 || 5",
+            "slide": "~1.1.3",
+            "util-extend": "^1.0.1"
+          },
+          "dependencies": {
+            "util-extend": {
+              "version": "1.0.3",
+              "bundled": true
+            }
+          }
+        },
+        "read-package-json": {
+          "version": "2.0.13",
+          "bundled": true,
+          "requires": {
+            "glob": "^7.1.1",
+            "graceful-fs": "^4.1.2",
+            "json-parse-better-errors": "^1.0.1",
+            "normalize-package-data": "^2.0.0",
+            "slash": "^1.0.0"
+          },
+          "dependencies": {
+            "json-parse-better-errors": {
+              "version": "1.0.1",
+              "bundled": true
+            },
+            "slash": {
+              "version": "1.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "read-package-tree": {
+          "version": "5.2.1",
+          "bundled": true,
+          "requires": {
+            "debuglog": "^1.0.1",
+            "dezalgo": "^1.0.0",
+            "once": "^1.3.0",
+            "read-package-json": "^2.0.0",
+            "readdir-scoped-modules": "^1.0.0"
+          }
+        },
+        "readable-stream": {
+          "version": "2.3.6",
+          "bundled": true,
+          "requires": {
+            "core-util-is": "~1.0.0",
+            "inherits": "~2.0.3",
+            "isarray": "~1.0.0",
+            "process-nextick-args": "~2.0.0",
+            "safe-buffer": "~5.1.1",
+            "string_decoder": "~1.1.1",
+            "util-deprecate": "~1.0.1"
+          },
+          "dependencies": {
+            "core-util-is": {
+              "version": "1.0.2",
+              "bundled": true
+            },
+            "isarray": {
+              "version": "1.0.0",
+              "bundled": true
+            },
+            "process-nextick-args": {
+              "version": "2.0.0",
+              "bundled": true
+            },
+            "string_decoder": {
+              "version": "1.1.1",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "~5.1.0"
+              }
+            },
+            "util-deprecate": {
+              "version": "1.0.2",
+              "bundled": true
+            }
+          }
+        },
+        "readdir-scoped-modules": {
+          "version": "1.0.2",
+          "bundled": true,
+          "requires": {
+            "debuglog": "^1.0.1",
+            "dezalgo": "^1.0.0",
+            "graceful-fs": "^4.1.2",
+            "once": "^1.3.0"
+          }
+        },
+        "request": {
+          "version": "2.86.0",
+          "bundled": true,
+          "requires": {
+            "aws-sign2": "~0.7.0",
+            "aws4": "^1.6.0",
+            "caseless": "~0.12.0",
+            "combined-stream": "~1.0.5",
+            "extend": "~3.0.1",
+            "forever-agent": "~0.6.1",
+            "form-data": "~2.3.1",
+            "har-validator": "~5.0.3",
+            "hawk": "~6.0.2",
+            "http-signature": "~1.2.0",
+            "is-typedarray": "~1.0.0",
+            "isstream": "~0.1.2",
+            "json-stringify-safe": "~5.0.1",
+            "mime-types": "~2.1.17",
+            "oauth-sign": "~0.8.2",
+            "performance-now": "^2.1.0",
+            "qs": "~6.5.1",
+            "safe-buffer": "^5.1.1",
+            "tough-cookie": "~2.3.3",
+            "tunnel-agent": "^0.6.0",
+            "uuid": "^3.1.0"
+          },
+          "dependencies": {
+            "aws-sign2": {
+              "version": "0.7.0",
+              "bundled": true
+            },
+            "aws4": {
+              "version": "1.7.0",
+              "bundled": true
+            },
+            "caseless": {
+              "version": "0.12.0",
+              "bundled": true
+            },
+            "combined-stream": {
+              "version": "1.0.6",
+              "bundled": true,
+              "requires": {
+                "delayed-stream": "~1.0.0"
+              },
+              "dependencies": {
+                "delayed-stream": {
+                  "version": "1.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "extend": {
+              "version": "3.0.1",
+              "bundled": true
+            },
+            "forever-agent": {
+              "version": "0.6.1",
+              "bundled": true
+            },
+            "form-data": {
+              "version": "2.3.2",
+              "bundled": true,
+              "requires": {
+                "asynckit": "^0.4.0",
+                "combined-stream": "1.0.6",
+                "mime-types": "^2.1.12"
+              },
+              "dependencies": {
+                "asynckit": {
+                  "version": "0.4.0",
+                  "bundled": true
+                }
+              }
+            },
+            "har-validator": {
+              "version": "5.0.3",
+              "bundled": true,
+              "requires": {
+                "ajv": "^5.1.0",
+                "har-schema": "^2.0.0"
+              },
+              "dependencies": {
+                "ajv": {
+                  "version": "5.5.2",
+                  "bundled": true,
+                  "requires": {
+                    "co": "^4.6.0",
+                    "fast-deep-equal": "^1.0.0",
+                    "fast-json-stable-stringify": "^2.0.0",
+                    "json-schema-traverse": "^0.3.0"
+                  },
+                  "dependencies": {
+                    "co": {
+                      "version": "4.6.0",
+                      "bundled": true
+                    },
+                    "fast-deep-equal": {
+                      "version": "1.1.0",
+                      "bundled": true
+                    },
+                    "fast-json-stable-stringify": {
+                      "version": "2.0.0",
+                      "bundled": true
+                    },
+                    "json-schema-traverse": {
+                      "version": "0.3.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "har-schema": {
+                  "version": "2.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "hawk": {
+              "version": "6.0.2",
+              "bundled": true,
+              "requires": {
+                "boom": "4.x.x",
+                "cryptiles": "3.x.x",
+                "hoek": "4.x.x",
+                "sntp": "2.x.x"
+              },
+              "dependencies": {
+                "boom": {
+                  "version": "4.3.1",
+                  "bundled": true,
+                  "requires": {
+                    "hoek": "4.x.x"
+                  }
+                },
+                "cryptiles": {
+                  "version": "3.1.2",
+                  "bundled": true,
+                  "requires": {
+                    "boom": "5.x.x"
+                  },
+                  "dependencies": {
+                    "boom": {
+                      "version": "5.2.0",
+                      "bundled": true,
+                      "requires": {
+                        "hoek": "4.x.x"
+                      }
+                    }
+                  }
+                },
+                "hoek": {
+                  "version": "4.2.1",
+                  "bundled": true
+                },
+                "sntp": {
+                  "version": "2.1.0",
+                  "bundled": true,
+                  "requires": {
+                    "hoek": "4.x.x"
+                  }
+                }
+              }
+            },
+            "http-signature": {
+              "version": "1.2.0",
+              "bundled": true,
+              "requires": {
+                "assert-plus": "^1.0.0",
+                "jsprim": "^1.2.2",
+                "sshpk": "^1.7.0"
+              },
+              "dependencies": {
+                "assert-plus": {
+                  "version": "1.0.0",
+                  "bundled": true
+                },
+                "jsprim": {
+                  "version": "1.4.1",
+                  "bundled": true,
+                  "requires": {
+                    "assert-plus": "1.0.0",
+                    "extsprintf": "1.3.0",
+                    "json-schema": "0.2.3",
+                    "verror": "1.10.0"
+                  },
+                  "dependencies": {
+                    "extsprintf": {
+                      "version": "1.3.0",
+                      "bundled": true
+                    },
+                    "json-schema": {
+                      "version": "0.2.3",
+                      "bundled": true
+                    },
+                    "verror": {
+                      "version": "1.10.0",
+                      "bundled": true,
+                      "requires": {
+                        "assert-plus": "^1.0.0",
+                        "core-util-is": "1.0.2",
+                        "extsprintf": "^1.2.0"
+                      },
+                      "dependencies": {
+                        "core-util-is": {
+                          "version": "1.0.2",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "sshpk": {
+                  "version": "1.14.1",
+                  "bundled": true,
+                  "requires": {
+                    "asn1": "~0.2.3",
+                    "assert-plus": "^1.0.0",
+                    "bcrypt-pbkdf": "^1.0.0",
+                    "dashdash": "^1.12.0",
+                    "ecc-jsbn": "~0.1.1",
+                    "getpass": "^0.1.1",
+                    "jsbn": "~0.1.0",
+                    "tweetnacl": "~0.14.0"
+                  },
+                  "dependencies": {
+                    "asn1": {
+                      "version": "0.2.3",
+                      "bundled": true
+                    },
+                    "bcrypt-pbkdf": {
+                      "version": "1.0.1",
+                      "bundled": true,
+                      "optional": true,
+                      "requires": {
+                        "tweetnacl": "^0.14.3"
+                      }
+                    },
+                    "dashdash": {
+                      "version": "1.14.1",
+                      "bundled": true,
+                      "requires": {
+                        "assert-plus": "^1.0.0"
+                      }
+                    },
+                    "ecc-jsbn": {
+                      "version": "0.1.1",
+                      "bundled": true,
+                      "optional": true,
+                      "requires": {
+                        "jsbn": "~0.1.0"
+                      }
+                    },
+                    "getpass": {
+                      "version": "0.1.7",
+                      "bundled": true,
+                      "requires": {
+                        "assert-plus": "^1.0.0"
+                      }
+                    },
+                    "jsbn": {
+                      "version": "0.1.1",
+                      "bundled": true,
+                      "optional": true
+                    },
+                    "tweetnacl": {
+                      "version": "0.14.5",
+                      "bundled": true,
+                      "optional": true
+                    }
+                  }
+                }
+              }
+            },
+            "is-typedarray": {
+              "version": "1.0.0",
+              "bundled": true
+            },
+            "isstream": {
+              "version": "0.1.2",
+              "bundled": true
+            },
+            "json-stringify-safe": {
+              "version": "5.0.1",
+              "bundled": true
+            },
+            "mime-types": {
+              "version": "2.1.18",
+              "bundled": true,
+              "requires": {
+                "mime-db": "~1.33.0"
+              },
+              "dependencies": {
+                "mime-db": {
+                  "version": "1.33.0",
+                  "bundled": true
+                }
+              }
+            },
+            "oauth-sign": {
+              "version": "0.8.2",
+              "bundled": true
+            },
+            "performance-now": {
+              "version": "2.1.0",
+              "bundled": true
+            },
+            "qs": {
+              "version": "6.5.2",
+              "bundled": true
+            },
+            "tough-cookie": {
+              "version": "2.3.4",
+              "bundled": true,
+              "requires": {
+                "punycode": "^1.4.1"
+              },
+              "dependencies": {
+                "punycode": {
+                  "version": "1.4.1",
+                  "bundled": true
+                }
+              }
+            },
+            "tunnel-agent": {
+              "version": "0.6.0",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "^5.0.1"
+              }
+            }
+          }
+        },
+        "retry": {
+          "version": "0.12.0",
+          "bundled": true
+        },
+        "rimraf": {
+          "version": "2.6.2",
+          "bundled": true,
+          "requires": {
+            "glob": "^7.0.5"
+          }
+        },
+        "safe-buffer": {
+          "version": "5.1.2",
+          "bundled": true
+        },
+        "semver": {
+          "version": "5.5.0",
+          "bundled": true
+        },
+        "sha": {
+          "version": "2.0.1",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2",
+            "readable-stream": "^2.0.2"
+          }
+        },
+        "slide": {
+          "version": "1.1.6",
+          "bundled": true
+        },
+        "sorted-object": {
+          "version": "2.0.1",
+          "bundled": true
+        },
+        "sorted-union-stream": {
+          "version": "2.1.3",
+          "bundled": true,
+          "requires": {
+            "from2": "^1.3.0",
+            "stream-iterate": "^1.1.0"
+          },
+          "dependencies": {
+            "from2": {
+              "version": "1.3.0",
+              "bundled": true,
+              "requires": {
+                "inherits": "~2.0.1",
+                "readable-stream": "~1.1.10"
+              },
+              "dependencies": {
+                "readable-stream": {
+                  "version": "1.1.14",
+                  "bundled": true,
+                  "requires": {
+                    "core-util-is": "~1.0.0",
+                    "inherits": "~2.0.1",
+                    "isarray": "0.0.1",
+                    "string_decoder": "~0.10.x"
+                  },
+                  "dependencies": {
+                    "core-util-is": {
+                      "version": "1.0.2",
+                      "bundled": true
+                    },
+                    "isarray": {
+                      "version": "0.0.1",
+                      "bundled": true
+                    },
+                    "string_decoder": {
+                      "version": "0.10.31",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "stream-iterate": {
+              "version": "1.2.0",
+              "bundled": true,
+              "requires": {
+                "readable-stream": "^2.1.5",
+                "stream-shift": "^1.0.0"
+              },
+              "dependencies": {
+                "stream-shift": {
+                  "version": "1.0.0",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "ssri": {
+          "version": "6.0.0",
+          "bundled": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "bundled": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          },
+          "dependencies": {
+            "ansi-regex": {
+              "version": "3.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "tar": {
+          "version": "4.4.1",
+          "bundled": true,
+          "requires": {
+            "chownr": "^1.0.1",
+            "fs-minipass": "^1.2.5",
+            "minipass": "^2.2.4",
+            "minizlib": "^1.1.0",
+            "mkdirp": "^0.5.0",
+            "safe-buffer": "^5.1.1",
+            "yallist": "^3.0.2"
+          },
+          "dependencies": {
+            "fs-minipass": {
+              "version": "1.2.5",
+              "bundled": true,
+              "requires": {
+                "minipass": "^2.2.1"
+              }
+            },
+            "minipass": {
+              "version": "2.3.1",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "^5.1.1",
+                "yallist": "^3.0.0"
+              }
+            },
+            "minizlib": {
+              "version": "1.1.0",
+              "bundled": true,
+              "requires": {
+                "minipass": "^2.2.1"
+              }
+            },
+            "yallist": {
+              "version": "3.0.2",
+              "bundled": true
+            }
+          }
+        },
+        "text-table": {
+          "version": "0.2.0",
+          "bundled": true
+        },
+        "tiny-relative-date": {
+          "version": "1.3.0",
+          "bundled": true
+        },
+        "uid-number": {
+          "version": "0.0.6",
+          "bundled": true
+        },
+        "umask": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "unique-filename": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "unique-slug": "^2.0.0"
+          },
+          "dependencies": {
+            "unique-slug": {
+              "version": "2.0.0",
+              "bundled": true,
+              "requires": {
+                "imurmurhash": "^0.1.4"
+              }
+            }
+          }
+        },
+        "unpipe": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "update-notifier": {
+          "version": "2.5.0",
+          "bundled": true,
+          "requires": {
+            "boxen": "^1.2.1",
+            "chalk": "^2.0.1",
+            "configstore": "^3.0.0",
+            "import-lazy": "^2.1.0",
+            "is-ci": "^1.0.10",
+            "is-installed-globally": "^0.1.0",
+            "is-npm": "^1.0.0",
+            "latest-version": "^3.0.0",
+            "semver-diff": "^2.0.0",
+            "xdg-basedir": "^3.0.0"
+          },
+          "dependencies": {
+            "boxen": {
+              "version": "1.3.0",
+              "bundled": true,
+              "requires": {
+                "ansi-align": "^2.0.0",
+                "camelcase": "^4.0.0",
+                "chalk": "^2.0.1",
+                "cli-boxes": "^1.0.0",
+                "string-width": "^2.0.0",
+                "term-size": "^1.2.0",
+                "widest-line": "^2.0.0"
+              },
+              "dependencies": {
+                "ansi-align": {
+                  "version": "2.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "string-width": "^2.0.0"
+                  }
+                },
+                "camelcase": {
+                  "version": "4.1.0",
+                  "bundled": true
+                },
+                "cli-boxes": {
+                  "version": "1.0.0",
+                  "bundled": true
+                },
+                "string-width": {
+                  "version": "2.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "is-fullwidth-code-point": "^2.0.0",
+                    "strip-ansi": "^4.0.0"
+                  },
+                  "dependencies": {
+                    "is-fullwidth-code-point": {
+                      "version": "2.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "term-size": {
+                  "version": "1.2.0",
+                  "bundled": true,
+                  "requires": {
+                    "execa": "^0.7.0"
+                  },
+                  "dependencies": {
+                    "execa": {
+                      "version": "0.7.0",
+                      "bundled": true,
+                      "requires": {
+                        "cross-spawn": "^5.0.1",
+                        "get-stream": "^3.0.0",
+                        "is-stream": "^1.1.0",
+                        "npm-run-path": "^2.0.0",
+                        "p-finally": "^1.0.0",
+                        "signal-exit": "^3.0.0",
+                        "strip-eof": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "cross-spawn": {
+                          "version": "5.1.0",
+                          "bundled": true,
+                          "requires": {
+                            "lru-cache": "^4.0.1",
+                            "shebang-command": "^1.2.0",
+                            "which": "^1.2.9"
+                          },
+                          "dependencies": {
+                            "shebang-command": {
+                              "version": "1.2.0",
+                              "bundled": true,
+                              "requires": {
+                                "shebang-regex": "^1.0.0"
+                              },
+                              "dependencies": {
+                                "shebang-regex": {
+                                  "version": "1.0.0",
+                                  "bundled": true
+                                }
+                              }
+                            }
+                          }
+                        },
+                        "get-stream": {
+                          "version": "3.0.0",
+                          "bundled": true
+                        },
+                        "is-stream": {
+                          "version": "1.1.0",
+                          "bundled": true
+                        },
+                        "npm-run-path": {
+                          "version": "2.0.2",
+                          "bundled": true,
+                          "requires": {
+                            "path-key": "^2.0.0"
+                          },
+                          "dependencies": {
+                            "path-key": {
+                              "version": "2.0.1",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "p-finally": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        },
+                        "signal-exit": {
+                          "version": "3.0.2",
+                          "bundled": true
+                        },
+                        "strip-eof": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "widest-line": {
+                  "version": "2.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "string-width": "^2.1.1"
+                  }
+                }
+              }
+            },
+            "chalk": {
+              "version": "2.4.1",
+              "bundled": true,
+              "requires": {
+                "ansi-styles": "^3.2.1",
+                "escape-string-regexp": "^1.0.5",
+                "supports-color": "^5.3.0"
+              },
+              "dependencies": {
+                "ansi-styles": {
+                  "version": "3.2.1",
+                  "bundled": true,
+                  "requires": {
+                    "color-convert": "^1.9.0"
+                  },
+                  "dependencies": {
+                    "color-convert": {
+                      "version": "1.9.1",
+                      "bundled": true,
+                      "requires": {
+                        "color-name": "^1.1.1"
+                      },
+                      "dependencies": {
+                        "color-name": {
+                          "version": "1.1.3",
+                          "bundled": true
+                        }
+                      }
+                    }
+                  }
+                },
+                "escape-string-regexp": {
+                  "version": "1.0.5",
+                  "bundled": true
+                },
+                "supports-color": {
+                  "version": "5.4.0",
+                  "bundled": true,
+                  "requires": {
+                    "has-flag": "^3.0.0"
+                  },
+                  "dependencies": {
+                    "has-flag": {
+                      "version": "3.0.0",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "configstore": {
+              "version": "3.1.2",
+              "bundled": true,
+              "requires": {
+                "dot-prop": "^4.1.0",
+                "graceful-fs": "^4.1.2",
+                "make-dir": "^1.0.0",
+                "unique-string": "^1.0.0",
+                "write-file-atomic": "^2.0.0",
+                "xdg-basedir": "^3.0.0"
+              },
+              "dependencies": {
+                "dot-prop": {
+                  "version": "4.2.0",
+                  "bundled": true,
+                  "requires": {
+                    "is-obj": "^1.0.0"
+                  },
+                  "dependencies": {
+                    "is-obj": {
+                      "version": "1.0.1",
+                      "bundled": true
+                    }
+                  }
+                },
+                "make-dir": {
+                  "version": "1.2.0",
+                  "bundled": true,
+                  "requires": {
+                    "pify": "^3.0.0"
+                  },
+                  "dependencies": {
+                    "pify": {
+                      "version": "3.0.0",
+                      "bundled": true
+                    }
+                  }
+                },
+                "unique-string": {
+                  "version": "1.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "crypto-random-string": "^1.0.0"
+                  },
+                  "dependencies": {
+                    "crypto-random-string": {
+                      "version": "1.0.0",
+                      "bundled": true
+                    }
+                  }
+                }
+              }
+            },
+            "import-lazy": {
+              "version": "2.1.0",
+              "bundled": true
+            },
+            "is-ci": {
+              "version": "1.1.0",
+              "bundled": true,
+              "requires": {
+                "ci-info": "^1.0.0"
+              },
+              "dependencies": {
+                "ci-info": {
+                  "version": "1.1.3",
+                  "bundled": true
+                }
+              }
+            },
+            "is-installed-globally": {
+              "version": "0.1.0",
+              "bundled": true,
+              "requires": {
+                "global-dirs": "^0.1.0",
+                "is-path-inside": "^1.0.0"
+              },
+              "dependencies": {
+                "global-dirs": {
+                  "version": "0.1.1",
+                  "bundled": true,
+                  "requires": {
+                    "ini": "^1.3.4"
+                  }
+                },
+                "is-path-inside": {
+                  "version": "1.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "path-is-inside": "^1.0.1"
+                  }
+                }
+              }
+            },
+            "is-npm": {
+              "version": "1.0.0",
+              "bundled": true
+            },
+            "latest-version": {
+              "version": "3.1.0",
+              "bundled": true,
+              "requires": {
+                "package-json": "^4.0.0"
+              },
+              "dependencies": {
+                "package-json": {
+                  "version": "4.0.1",
+                  "bundled": true,
+                  "requires": {
+                    "got": "^6.7.1",
+                    "registry-auth-token": "^3.0.1",
+                    "registry-url": "^3.0.3",
+                    "semver": "^5.1.0"
+                  },
+                  "dependencies": {
+                    "got": {
+                      "version": "6.7.1",
+                      "bundled": true,
+                      "requires": {
+                        "create-error-class": "^3.0.0",
+                        "duplexer3": "^0.1.4",
+                        "get-stream": "^3.0.0",
+                        "is-redirect": "^1.0.0",
+                        "is-retry-allowed": "^1.0.0",
+                        "is-stream": "^1.0.0",
+                        "lowercase-keys": "^1.0.0",
+                        "safe-buffer": "^5.0.1",
+                        "timed-out": "^4.0.0",
+                        "unzip-response": "^2.0.1",
+                        "url-parse-lax": "^1.0.0"
+                      },
+                      "dependencies": {
+                        "create-error-class": {
+                          "version": "3.0.2",
+                          "bundled": true,
+                          "requires": {
+                            "capture-stack-trace": "^1.0.0"
+                          },
+                          "dependencies": {
+                            "capture-stack-trace": {
+                              "version": "1.0.0",
+                              "bundled": true
+                            }
+                          }
+                        },
+                        "duplexer3": {
+                          "version": "0.1.4",
+                          "bundled": true
+                        },
+                        "get-stream": {
+                          "version": "3.0.0",
+                          "bundled": true
+                        },
+                        "is-redirect": {
+                          "version": "1.0.0",
+                          "bundled": true
+                        },
+                        "is-retry-allowed": {
+                          "version": "1.1.0",
+                          "bundled": true
+                        },
+                        "is-stream": {
+                          "version": "1.1.0",
+                          "bundled": true
+                        },
+                        "lowercase-keys": {
+                          "version": "1.0.1",
+                          "bundled": true
+                        },
+                        "timed-out": {
+                          "version": "4.0.1",
+                          "bundled": true
+                        },
+                        "unzip-response": {
+                          "version": "2.0.1",
+                          "bundled": true
+                        },
+                        "url-parse-lax": {
+                          "version": "1.0.0",
+                          "bundled": true,
+                          "requires": {
+                            "prepend-http": "^1.0.1"
+                          },
+                          "dependencies": {
+                            "prepend-http": {
+                              "version": "1.0.4",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "registry-auth-token": {
+                      "version": "3.3.2",
+                      "bundled": true,
+                      "requires": {
+                        "rc": "^1.1.6",
+                        "safe-buffer": "^5.0.1"
+                      },
+                      "dependencies": {
+                        "rc": {
+                          "version": "1.2.7",
+                          "bundled": true,
+                          "requires": {
+                            "deep-extend": "^0.5.1",
+                            "ini": "~1.3.0",
+                            "minimist": "^1.2.0",
+                            "strip-json-comments": "~2.0.1"
+                          },
+                          "dependencies": {
+                            "deep-extend": {
+                              "version": "0.5.1",
+                              "bundled": true
+                            },
+                            "minimist": {
+                              "version": "1.2.0",
+                              "bundled": true
+                            },
+                            "strip-json-comments": {
+                              "version": "2.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    },
+                    "registry-url": {
+                      "version": "3.1.0",
+                      "bundled": true,
+                      "requires": {
+                        "rc": "^1.0.1"
+                      },
+                      "dependencies": {
+                        "rc": {
+                          "version": "1.2.7",
+                          "bundled": true,
+                          "requires": {
+                            "deep-extend": "^0.5.1",
+                            "ini": "~1.3.0",
+                            "minimist": "^1.2.0",
+                            "strip-json-comments": "~2.0.1"
+                          },
+                          "dependencies": {
+                            "deep-extend": {
+                              "version": "0.5.1",
+                              "bundled": true
+                            },
+                            "minimist": {
+                              "version": "1.2.0",
+                              "bundled": true
+                            },
+                            "strip-json-comments": {
+                              "version": "2.0.1",
+                              "bundled": true
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "semver-diff": {
+              "version": "2.1.0",
+              "bundled": true,
+              "requires": {
+                "semver": "^5.0.3"
+              }
+            },
+            "xdg-basedir": {
+              "version": "3.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "uuid": {
+          "version": "3.2.1",
+          "bundled": true
+        },
+        "validate-npm-package-license": {
+          "version": "3.0.3",
+          "bundled": true,
+          "requires": {
+            "spdx-correct": "^3.0.0",
+            "spdx-expression-parse": "^3.0.0"
+          },
+          "dependencies": {
+            "spdx-correct": {
+              "version": "3.0.0",
+              "bundled": true,
+              "requires": {
+                "spdx-expression-parse": "^3.0.0",
+                "spdx-license-ids": "^3.0.0"
+              },
+              "dependencies": {
+                "spdx-license-ids": {
+                  "version": "3.0.0",
+                  "bundled": true
+                }
+              }
+            },
+            "spdx-expression-parse": {
+              "version": "3.0.0",
+              "bundled": true,
+              "requires": {
+                "spdx-exceptions": "^2.1.0",
+                "spdx-license-ids": "^3.0.0"
+              },
+              "dependencies": {
+                "spdx-exceptions": {
+                  "version": "2.1.0",
+                  "bundled": true
+                },
+                "spdx-license-ids": {
+                  "version": "3.0.0",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "validate-npm-package-name": {
+          "version": "3.0.0",
+          "bundled": true,
+          "requires": {
+            "builtins": "^1.0.3"
+          },
+          "dependencies": {
+            "builtins": {
+              "version": "1.0.3",
+              "bundled": true
+            }
+          }
+        },
+        "which": {
+          "version": "1.3.0",
+          "bundled": true,
+          "requires": {
+            "isexe": "^2.0.0"
+          },
+          "dependencies": {
+            "isexe": {
+              "version": "2.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "worker-farm": {
+          "version": "1.6.0",
+          "bundled": true,
+          "requires": {
+            "errno": "~0.1.7"
+          },
+          "dependencies": {
+            "errno": {
+              "version": "0.1.7",
+              "bundled": true,
+              "requires": {
+                "prr": "~1.0.1"
+              },
+              "dependencies": {
+                "prr": {
+                  "version": "1.0.1",
+                  "bundled": true
+                }
+              }
+            }
+          }
+        },
+        "wrappy": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "write-file-atomic": {
+          "version": "2.3.0",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.11",
+            "imurmurhash": "^0.1.4",
+            "signal-exit": "^3.0.2"
+          },
+          "dependencies": {
+            "signal-exit": {
+              "version": "3.0.2",
+              "bundled": true
+            }
+          }
+        }
+      }
+    },
+    "npm-run-path": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-2.0.2.tgz",
+      "integrity": "sha1-NakjLfo11wZ7TLLd8jV7GHFTbF8=",
+      "dev": true,
+      "requires": {
+        "path-key": "^2.0.0"
+      }
+    },
+    "num2fraction": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/num2fraction/-/num2fraction-1.2.2.tgz",
+      "integrity": "sha1-b2gragJ6Tp3fpFZM0lidHU5mnt4=",
+      "dev": true
+    },
+    "number-is-nan": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/number-is-nan/-/number-is-nan-1.0.1.tgz",
+      "integrity": "sha1-CXtgK1NCKlIsGvuHkDGDNpQaAR0=",
+      "dev": true
+    },
+    "nvd3": {
+      "version": "1.8.6",
+      "resolved": "https://registry.npmjs.org/nvd3/-/nvd3-1.8.6.tgz",
+      "integrity": "sha1-LT66dL8zNjtRAevx0JPFmlOuc8Q="
+    },
+    "object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha1-IQmtx5ZYh8/AXLvUQsrIv7s2CGM=",
+      "dev": true
+    },
+    "object-copy": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/object-copy/-/object-copy-0.1.0.tgz",
+      "integrity": "sha1-fn2Fi3gb18mRpBupde04EnVOmYw=",
+      "dev": true,
+      "requires": {
+        "copy-descriptor": "^0.1.0",
+        "define-property": "^0.2.5",
+        "kind-of": "^3.0.3"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        }
+      }
+    },
+    "object-keys": {
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.0.12.tgz",
+      "integrity": "sha512-FTMyFUm2wBcGHnH2eXmz7tC6IwlqQZ6mVZ+6dm6vZ4IQIHjs6FdNsQBuKGPuUUUY6NfJw2PshC08Tn6LzLDOag==",
+      "dev": true
+    },
+    "object-visit": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/object-visit/-/object-visit-1.0.1.tgz",
+      "integrity": "sha1-95xEk68MU3e1n+OdOV5BBC3QRbs=",
+      "dev": true,
+      "requires": {
+        "isobject": "^3.0.0"
+      }
+    },
+    "object.assign": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/object.assign/-/object.assign-4.1.0.tgz",
+      "integrity": "sha512-exHJeq6kBKj58mqGyTQ9DFvrZC/eR6OwxzoM9YRoGBqrXYonaFyGiFMuc9VZrXf7DarreEwMpurG3dd+CNyW5w==",
+      "dev": true,
+      "requires": {
+        "define-properties": "^1.1.2",
+        "function-bind": "^1.1.1",
+        "has-symbols": "^1.0.0",
+        "object-keys": "^1.0.11"
+      }
+    },
+    "object.pick": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/object.pick/-/object.pick-1.3.0.tgz",
+      "integrity": "sha1-h6EKxMFpS9Lhy/U1kaZhQftd10c=",
+      "dev": true,
+      "requires": {
+        "isobject": "^3.0.1"
+      }
+    },
+    "once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=",
+      "dev": true,
+      "requires": {
+        "wrappy": "1"
+      }
+    },
+    "onetime": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/onetime/-/onetime-2.0.1.tgz",
+      "integrity": "sha1-BnQoIw/WdEOyeUsiu6UotoZ5YtQ=",
+      "dev": true,
+      "requires": {
+        "mimic-fn": "^1.0.0"
+      }
+    },
+    "optimist": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/optimist/-/optimist-0.6.1.tgz",
+      "integrity": "sha1-2j6nRob6IaGaERwybpDrFaAZZoY=",
+      "dev": true,
+      "requires": {
+        "minimist": "~0.0.1",
+        "wordwrap": "~0.0.2"
+      },
+      "dependencies": {
+        "wordwrap": {
+          "version": "0.0.3",
+          "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-0.0.3.tgz",
+          "integrity": "sha1-o9XabNXAvAAI03I0u68b7WMFkQc=",
+          "dev": true
+        }
+      }
+    },
+    "optionator": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.8.2.tgz",
+      "integrity": "sha1-NkxeQJ0/TWMB1sC0wFu6UBgK62Q=",
+      "dev": true,
+      "requires": {
+        "deep-is": "~0.1.3",
+        "fast-levenshtein": "~2.0.4",
+        "levn": "~0.3.0",
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2",
+        "wordwrap": "~1.0.0"
+      }
+    },
+    "os-browserify": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/os-browserify/-/os-browserify-0.3.0.tgz",
+      "integrity": "sha1-hUNzx/XCMVkU/Jv8a9gjj92h7Cc=",
+      "dev": true
+    },
+    "os-homedir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz",
+      "integrity": "sha1-/7xJiDNuDoM94MFox+8VISGqf7M=",
+      "dev": true
+    },
+    "os-locale": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/os-locale/-/os-locale-2.1.0.tgz",
+      "integrity": "sha512-3sslG3zJbEYcaC4YVAvDorjGxc7tv6KVATnLPZONiljsUncvihe9BQoVCEs0RZ1kmf4Hk9OBqlZfJZWI4GanKA==",
+      "dev": true,
+      "requires": {
+        "execa": "^0.7.0",
+        "lcid": "^1.0.0",
+        "mem": "^1.1.0"
+      }
+    },
+    "os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha1-u+Z0BseaqFxc/sdm/lc0VV36EnQ=",
+      "dev": true
+    },
+    "p-finally": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/p-finally/-/p-finally-1.0.0.tgz",
+      "integrity": "sha1-P7z7FbiZpEEjs0ttzBi3JDNqLK4=",
+      "dev": true
+    },
+    "p-limit": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-1.3.0.tgz",
+      "integrity": "sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==",
+      "dev": true,
+      "requires": {
+        "p-try": "^1.0.0"
+      }
+    },
+    "p-locate": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-2.0.0.tgz",
+      "integrity": "sha1-IKAQOyIqcMj9OcwuWAaA893l7EM=",
+      "dev": true,
+      "requires": {
+        "p-limit": "^1.1.0"
+      }
+    },
+    "p-try": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/p-try/-/p-try-1.0.0.tgz",
+      "integrity": "sha1-y8ec26+P1CKOE/Yh8rGiN8GyB7M=",
+      "dev": true
+    },
+    "pako": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/pako/-/pako-1.0.6.tgz",
+      "integrity": "sha512-lQe48YPsMJAig+yngZ87Lus+NF+3mtu7DVOBu6b/gHO1YpKwIj5AWjZ/TOS7i46HD/UixzWb1zeWDZfGZ3iYcg==",
+      "dev": true
+    },
+    "parallel-transform": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/parallel-transform/-/parallel-transform-1.1.0.tgz",
+      "integrity": "sha1-1BDwZbBdojCB/NEPKIVMKb2jOwY=",
+      "dev": true,
+      "requires": {
+        "cyclist": "~0.2.2",
+        "inherits": "^2.0.3",
+        "readable-stream": "^2.1.5"
+      }
+    },
+    "parse-asn1": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/parse-asn1/-/parse-asn1-5.1.1.tgz",
+      "integrity": "sha512-KPx7flKXg775zZpnp9SxJlz00gTd4BmJ2yJufSc44gMCRrRQ7NSzAcSJQfifuOLgW6bEi+ftrALtsgALeB2Adw==",
+      "dev": true,
+      "requires": {
+        "asn1.js": "^4.0.0",
+        "browserify-aes": "^1.0.0",
+        "create-hash": "^1.1.0",
+        "evp_bytestokey": "^1.0.0",
+        "pbkdf2": "^3.0.3"
+      }
+    },
+    "pascalcase": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz",
+      "integrity": "sha1-s2PlXoAGym/iF4TS2yK9FdeRfxQ=",
+      "dev": true
+    },
+    "path-browserify": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-0.0.0.tgz",
+      "integrity": "sha1-oLhwcpquIUAFt9UDLsLLuw+0RRo=",
+      "dev": true
+    },
+    "path-dirname": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/path-dirname/-/path-dirname-1.0.2.tgz",
+      "integrity": "sha1-zDPSTVJeCZpTiMAzbG4yuRYGCeA=",
+      "dev": true
+    },
+    "path-exists": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-3.0.0.tgz",
+      "integrity": "sha1-zg6+ql94yxiSXqfYENe1mwEP1RU=",
+      "dev": true
+    },
+    "path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=",
+      "dev": true
+    },
+    "path-key": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-2.0.1.tgz",
+      "integrity": "sha1-QRyttXTFoUDTpLGRDUDYDMn0C0A=",
+      "dev": true
+    },
+    "path-parse": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.5.tgz",
+      "integrity": "sha1-PBrfhx6pzWyUMbbqK9dKD/BVxME=",
+      "dev": true
+    },
+    "path-type": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/path-type/-/path-type-3.0.0.tgz",
+      "integrity": "sha512-T2ZUsdZFHgA3u4e5PfPbjd7HDDpxPnQb5jN0SrDsjNSuVXHJqtwTnWqG0B1jZrgmJ/7lj1EmVIByWt1gxGkWvg==",
+      "dev": true,
+      "requires": {
+        "pify": "^3.0.0"
+      }
+    },
+    "pbkdf2": {
+      "version": "3.0.16",
+      "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.0.16.tgz",
+      "integrity": "sha512-y4CXP3thSxqf7c0qmOF+9UeOTrifiVTIM+u7NWlq+PRsHbr7r7dpCmvzrZxa96JJUNi0Y5w9VqG5ZNeCVMoDcA==",
+      "dev": true,
+      "requires": {
+        "create-hash": "^1.1.2",
+        "create-hmac": "^1.1.4",
+        "ripemd160": "^2.0.1",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      }
+    },
+    "pify": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz",
+      "integrity": "sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=",
+      "dev": true
+    },
+    "pkg-dir": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-2.0.0.tgz",
+      "integrity": "sha1-9tXREJ4Z1j7fQo4L1X4Sd3YVM0s=",
+      "dev": true,
+      "requires": {
+        "find-up": "^2.1.0"
+      }
+    },
+    "posix-character-classes": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz",
+      "integrity": "sha1-AerA/jta9xoqbAL+q7jB/vfgDqs=",
+      "dev": true
+    },
+    "postcss": {
+      "version": "6.0.23",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-6.0.23.tgz",
+      "integrity": "sha512-soOk1h6J3VMTZtVeVpv15/Hpdl2cBLX3CAw4TAbkpTJiNPk9YP/zWcD1ND+xEtvyuuvKzbxliTOIyvkSeSJ6ag==",
+      "dev": true,
+      "requires": {
+        "chalk": "^2.4.1",
+        "source-map": "^0.6.1",
+        "supports-color": "^5.4.0"
+      },
+      "dependencies": {
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "source-map": {
+          "version": "0.6.1",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+          "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "postcss-calc": {
+      "version": "5.3.1",
+      "resolved": "https://registry.npmjs.org/postcss-calc/-/postcss-calc-5.3.1.tgz",
+      "integrity": "sha1-d7rnypKK2FcW4v2kLyYb98HWW14=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.2",
+        "postcss-message-helpers": "^2.0.0",
+        "reduce-css-calc": "^1.2.6"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-colormin": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/postcss-colormin/-/postcss-colormin-2.2.2.tgz",
+      "integrity": "sha1-ZjFBfV8OkJo9fsJrJMio0eT5bks=",
+      "dev": true,
+      "requires": {
+        "colormin": "^1.0.5",
+        "postcss": "^5.0.13",
+        "postcss-value-parser": "^3.2.3"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-convert-values": {
+      "version": "2.6.1",
+      "resolved": "https://registry.npmjs.org/postcss-convert-values/-/postcss-convert-values-2.6.1.tgz",
+      "integrity": "sha1-u9hZPFwf0uPRwyK7kl3K6Nrk1i0=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.11",
+        "postcss-value-parser": "^3.1.2"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-discard-comments": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/postcss-discard-comments/-/postcss-discard-comments-2.0.4.tgz",
+      "integrity": "sha1-vv6J+v1bPazlzM5Rt2uBUUvgDj0=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.14"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-discard-duplicates": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/postcss-discard-duplicates/-/postcss-discard-duplicates-2.1.0.tgz",
+      "integrity": "sha1-uavye4isGIFYpesSq8riAmO5GTI=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-discard-empty": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/postcss-discard-empty/-/postcss-discard-empty-2.1.0.tgz",
+      "integrity": "sha1-0rS9nVztXr2Nyt52QMfXzX9PkrU=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.14"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-discard-overridden": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-discard-overridden/-/postcss-discard-overridden-0.1.1.tgz",
+      "integrity": "sha1-ix6vVU9ob7KIzYdMVWZ7CqNmjVg=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.16"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-discard-unused": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/postcss-discard-unused/-/postcss-discard-unused-2.2.3.tgz",
+      "integrity": "sha1-vOMLLMWR/8Y0Mitfs0ZLbZNPRDM=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.14",
+        "uniqs": "^2.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-filter-plugins": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/postcss-filter-plugins/-/postcss-filter-plugins-2.0.3.tgz",
+      "integrity": "sha512-T53GVFsdinJhgwm7rg1BzbeBRomOg9y5MBVhGcsV0CxurUdVj1UlPdKtn7aqYA/c/QVkzKMjq2bSV5dKG5+AwQ==",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-merge-idents": {
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/postcss-merge-idents/-/postcss-merge-idents-2.1.7.tgz",
+      "integrity": "sha1-TFUwMTwI4dWzu/PSu8dH4njuonA=",
+      "dev": true,
+      "requires": {
+        "has": "^1.0.1",
+        "postcss": "^5.0.10",
+        "postcss-value-parser": "^3.1.1"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-merge-longhand": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/postcss-merge-longhand/-/postcss-merge-longhand-2.0.2.tgz",
+      "integrity": "sha1-I9kM0Sewp3mUkVMyc5A0oaTz1lg=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-merge-rules": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/postcss-merge-rules/-/postcss-merge-rules-2.1.2.tgz",
+      "integrity": "sha1-0d9d+qexrMO+VT8OnhDofGG19yE=",
+      "dev": true,
+      "requires": {
+        "browserslist": "^1.5.2",
+        "caniuse-api": "^1.5.2",
+        "postcss": "^5.0.4",
+        "postcss-selector-parser": "^2.2.2",
+        "vendors": "^1.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-message-helpers": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/postcss-message-helpers/-/postcss-message-helpers-2.0.0.tgz",
+      "integrity": "sha1-pPL0+rbk/gAvCu0ABHjN9S+bpg4=",
+      "dev": true
+    },
+    "postcss-minify-font-values": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/postcss-minify-font-values/-/postcss-minify-font-values-1.0.5.tgz",
+      "integrity": "sha1-S1jttWZB66fIR0qzUmyv17vey2k=",
+      "dev": true,
+      "requires": {
+        "object-assign": "^4.0.1",
+        "postcss": "^5.0.4",
+        "postcss-value-parser": "^3.0.2"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-minify-gradients": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/postcss-minify-gradients/-/postcss-minify-gradients-1.0.5.tgz",
+      "integrity": "sha1-Xb2hE3NwP4PPtKPqOIHY11/15uE=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.12",
+        "postcss-value-parser": "^3.3.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-minify-params": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/postcss-minify-params/-/postcss-minify-params-1.2.2.tgz",
+      "integrity": "sha1-rSzgcTc7lDs9kwo/pZo1jCjW8fM=",
+      "dev": true,
+      "requires": {
+        "alphanum-sort": "^1.0.1",
+        "postcss": "^5.0.2",
+        "postcss-value-parser": "^3.0.2",
+        "uniqs": "^2.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-minify-selectors": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-minify-selectors/-/postcss-minify-selectors-2.1.1.tgz",
+      "integrity": "sha1-ssapjAByz5G5MtGkllCBFDEXNb8=",
+      "dev": true,
+      "requires": {
+        "alphanum-sort": "^1.0.2",
+        "has": "^1.0.1",
+        "postcss": "^5.0.14",
+        "postcss-selector-parser": "^2.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-modules-extract-imports": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/postcss-modules-extract-imports/-/postcss-modules-extract-imports-1.1.0.tgz",
+      "integrity": "sha1-thTJcgvmgW6u41+zpfqh26agXds=",
+      "dev": true,
+      "requires": {
+        "postcss": "^6.0.1"
+      }
+    },
+    "postcss-modules-local-by-default": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/postcss-modules-local-by-default/-/postcss-modules-local-by-default-1.2.0.tgz",
+      "integrity": "sha1-99gMOYxaOT+nlkRmvRlQCn1hwGk=",
+      "dev": true,
+      "requires": {
+        "css-selector-tokenizer": "^0.7.0",
+        "postcss": "^6.0.1"
+      }
+    },
+    "postcss-modules-resolve-imports": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/postcss-modules-resolve-imports/-/postcss-modules-resolve-imports-1.3.0.tgz",
+      "integrity": "sha1-OY0wALla6WlCDN9M2D+oBn8cXq4=",
+      "dev": true,
+      "requires": {
+        "css-selector-tokenizer": "^0.7.0",
+        "icss-utils": "^3.0.1",
+        "minimist": "^1.2.0"
+      },
+      "dependencies": {
+        "minimist": {
+          "version": "1.2.0",
+          "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
+          "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=",
+          "dev": true
+        }
+      }
+    },
+    "postcss-modules-scope": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/postcss-modules-scope/-/postcss-modules-scope-1.1.0.tgz",
+      "integrity": "sha1-1upkmUx5+XtipytCb75gVqGUu5A=",
+      "dev": true,
+      "requires": {
+        "css-selector-tokenizer": "^0.7.0",
+        "postcss": "^6.0.1"
+      }
+    },
+    "postcss-modules-values": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/postcss-modules-values/-/postcss-modules-values-1.3.0.tgz",
+      "integrity": "sha1-7P+p1+GSUYOJ9CrQ6D9yrsRW6iA=",
+      "dev": true,
+      "requires": {
+        "icss-replace-symbols": "^1.1.0",
+        "postcss": "^6.0.1"
+      }
+    },
+    "postcss-normalize-charset": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-charset/-/postcss-normalize-charset-1.1.1.tgz",
+      "integrity": "sha1-757nEhLX/nWceO0WL2HtYrXLk/E=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.5"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-normalize-url": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/postcss-normalize-url/-/postcss-normalize-url-3.0.8.tgz",
+      "integrity": "sha1-EI90s/L82viRov+j6kWSJ5/HgiI=",
+      "dev": true,
+      "requires": {
+        "is-absolute-url": "^2.0.0",
+        "normalize-url": "^1.4.0",
+        "postcss": "^5.0.14",
+        "postcss-value-parser": "^3.2.3"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-ordered-values": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/postcss-ordered-values/-/postcss-ordered-values-2.2.3.tgz",
+      "integrity": "sha1-7sbCpntsQSqNsgQud/6NpD+VwR0=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4",
+        "postcss-value-parser": "^3.0.1"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-reduce-idents": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/postcss-reduce-idents/-/postcss-reduce-idents-2.4.0.tgz",
+      "integrity": "sha1-wsbSDMlYKE9qv75j92Cb9AkFmtM=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4",
+        "postcss-value-parser": "^3.0.2"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-reduce-initial": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/postcss-reduce-initial/-/postcss-reduce-initial-1.0.1.tgz",
+      "integrity": "sha1-aPgGlfBF0IJjqHmtJA343WT2ROo=",
+      "dev": true,
+      "requires": {
+        "postcss": "^5.0.4"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-reduce-transforms": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/postcss-reduce-transforms/-/postcss-reduce-transforms-1.0.4.tgz",
+      "integrity": "sha1-/3b02CEkN7McKYpC0uFEQCV3GuE=",
+      "dev": true,
+      "requires": {
+        "has": "^1.0.1",
+        "postcss": "^5.0.8",
+        "postcss-value-parser": "^3.0.1"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-selector-parser": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-2.2.3.tgz",
+      "integrity": "sha1-+UN3iGBsPJrO4W/+jYsWKX8nu5A=",
+      "dev": true,
+      "requires": {
+        "flatten": "^1.0.2",
+        "indexes-of": "^1.0.1",
+        "uniq": "^1.0.1"
+      }
+    },
+    "postcss-svgo": {
+      "version": "2.1.6",
+      "resolved": "https://registry.npmjs.org/postcss-svgo/-/postcss-svgo-2.1.6.tgz",
+      "integrity": "sha1-tt8YqmE7Zm4TPwittSGcJoSsEI0=",
+      "dev": true,
+      "requires": {
+        "is-svg": "^2.0.0",
+        "postcss": "^5.0.14",
+        "postcss-value-parser": "^3.2.3",
+        "svgo": "^0.7.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-unique-selectors": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/postcss-unique-selectors/-/postcss-unique-selectors-2.0.2.tgz",
+      "integrity": "sha1-mB1X0p3csz57Hf4f1DuGSfkzyh0=",
+      "dev": true,
+      "requires": {
+        "alphanum-sort": "^1.0.1",
+        "postcss": "^5.0.4",
+        "uniqs": "^2.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "postcss-value-parser": {
+      "version": "3.3.0",
+      "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-3.3.0.tgz",
+      "integrity": "sha1-h/OPnxj3dKSrTIojL1xc6IcqnRU=",
+      "dev": true
+    },
+    "postcss-zindex": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/postcss-zindex/-/postcss-zindex-2.2.0.tgz",
+      "integrity": "sha1-0hCd3AVbka9n/EyzsCWUZjnSryI=",
+      "dev": true,
+      "requires": {
+        "has": "^1.0.1",
+        "postcss": "^5.0.4",
+        "uniqs": "^2.0.0"
+      },
+      "dependencies": {
+        "postcss": {
+          "version": "5.2.18",
+          "resolved": "https://registry.npmjs.org/postcss/-/postcss-5.2.18.tgz",
+          "integrity": "sha512-zrUjRRe1bpXKsX1qAJNJjqZViErVuyEkMTRrwu4ud4sbTtIBRmtaYDrHmcGgmrbsW3MHfmtIf+vJumgQn+PrXg==",
+          "dev": true,
+          "requires": {
+            "chalk": "^1.1.3",
+            "js-base64": "^2.1.9",
+            "source-map": "^0.5.6",
+            "supports-color": "^3.2.3"
+          }
+        },
+        "supports-color": {
+          "version": "3.2.3",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+          "integrity": "sha1-ZawFBLOVQXHYpklGsq48u4pfVPY=",
+          "dev": true,
+          "requires": {
+            "has-flag": "^1.0.0"
+          }
+        }
+      }
+    },
+    "prelude-ls": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.1.2.tgz",
+      "integrity": "sha1-IZMqVJ9eUv/ZqCf1cOBL5iqX2lQ=",
+      "dev": true
+    },
+    "prepend-http": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/prepend-http/-/prepend-http-1.0.4.tgz",
+      "integrity": "sha1-1PRWKwzjaW5BrFLQ4ALlemNdxtw=",
+      "dev": true
+    },
+    "private": {
+      "version": "0.1.8",
+      "resolved": "https://registry.npmjs.org/private/-/private-0.1.8.tgz",
+      "integrity": "sha512-VvivMrbvd2nKkiG38qjULzlc+4Vx4wm/whI9pQD35YrARNnhxeiRktSOhSukRLFNlzg6Br/cJPet5J/u19r/mg==",
+      "dev": true
+    },
+    "process": {
+      "version": "0.11.10",
+      "resolved": "https://registry.npmjs.org/process/-/process-0.11.10.tgz",
+      "integrity": "sha1-czIwDoQBYb2j5podHZGn1LwW8YI=",
+      "dev": true
+    },
+    "process-nextick-args": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.0.tgz",
+      "integrity": "sha512-MtEC1TqN0EU5nephaJ4rAtThHtC86dNN9qCuEhtshvpVBkAW5ZO7BASN9REnF9eoXGcRub+pFuKEpOHE+HbEMw==",
+      "dev": true
+    },
+    "promise-inflight": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/promise-inflight/-/promise-inflight-1.0.1.tgz",
+      "integrity": "sha1-mEcocL8igTL8vdhoEputEsPAKeM=",
+      "dev": true
+    },
+    "prr": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/prr/-/prr-1.0.1.tgz",
+      "integrity": "sha1-0/wRS6BplaRexok/SEzrHXj19HY=",
+      "dev": true
+    },
+    "pseudomap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/pseudomap/-/pseudomap-1.0.2.tgz",
+      "integrity": "sha1-8FKijacOYYkX7wqKw0wa5aaChrM=",
+      "dev": true
+    },
+    "public-encrypt": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/public-encrypt/-/public-encrypt-4.0.2.tgz",
+      "integrity": "sha512-4kJ5Esocg8X3h8YgJsKAuoesBgB7mqH3eowiDzMUPKiRDDE7E/BqqZD1hnTByIaAFiwAw246YEltSq7tdrOH0Q==",
+      "dev": true,
+      "requires": {
+        "bn.js": "^4.1.0",
+        "browserify-rsa": "^4.0.0",
+        "create-hash": "^1.1.0",
+        "parse-asn1": "^5.0.0",
+        "randombytes": "^2.0.1"
+      }
+    },
+    "pump": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/pump/-/pump-2.0.1.tgz",
+      "integrity": "sha512-ruPMNRkN3MHP1cWJc9OWr+T/xDP0jhXYCLfJcBuX54hhfIBnaQmAUMfDcG4DM5UMWByBbJY69QSphm3jtDKIkA==",
+      "dev": true,
+      "requires": {
+        "end-of-stream": "^1.1.0",
+        "once": "^1.3.1"
+      }
+    },
+    "pumpify": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/pumpify/-/pumpify-1.5.1.tgz",
+      "integrity": "sha512-oClZI37HvuUJJxSKKrC17bZ9Cu0ZYhEAGPsPUy9KlMUmv9dKX2o77RUmq7f3XjIxbwyGwYzbzQ1L2Ks8sIradQ==",
+      "dev": true,
+      "requires": {
+        "duplexify": "^3.6.0",
+        "inherits": "^2.0.3",
+        "pump": "^2.0.0"
+      }
+    },
+    "punycode": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz",
+      "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==",
+      "dev": true
+    },
+    "q": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/q/-/q-1.5.1.tgz",
+      "integrity": "sha1-fjL3W0E4EpHQRhHxvxQQmsAGUdc=",
+      "dev": true
+    },
+    "query-string": {
+      "version": "4.3.4",
+      "resolved": "https://registry.npmjs.org/query-string/-/query-string-4.3.4.tgz",
+      "integrity": "sha1-u7aTucqRXCMlFbIosaArYJBD2+s=",
+      "dev": true,
+      "requires": {
+        "object-assign": "^4.1.0",
+        "strict-uri-encode": "^1.0.0"
+      }
+    },
+    "querystring": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/querystring/-/querystring-0.2.0.tgz",
+      "integrity": "sha1-sgmEkgO7Jd+CDadW50cAWHhSFiA=",
+      "dev": true
+    },
+    "querystring-es3": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/querystring-es3/-/querystring-es3-0.2.1.tgz",
+      "integrity": "sha1-nsYfeQSYdXB9aUFFlv2Qek1xHnM=",
+      "dev": true
+    },
+    "randombytes": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.0.6.tgz",
+      "integrity": "sha512-CIQ5OFxf4Jou6uOKe9t1AOgqpeU5fd70A8NPdHSGeYXqXsPe6peOwI0cUl88RWZ6sP1vPMV3avd/R6cZ5/sP1A==",
+      "dev": true,
+      "requires": {
+        "safe-buffer": "^5.1.0"
+      }
+    },
+    "randomfill": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/randomfill/-/randomfill-1.0.4.tgz",
+      "integrity": "sha512-87lcbR8+MhcWcUiQ+9e+Rwx8MyR2P7qnt15ynUlbm3TU/fjbgz4GsvfSUDTemtCCtVCqb4ZcEFlyPNTh9bBTLw==",
+      "dev": true,
+      "requires": {
+        "randombytes": "^2.0.5",
+        "safe-buffer": "^5.1.0"
+      }
+    },
+    "readable-stream": {
+      "version": "2.3.6",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.6.tgz",
+      "integrity": "sha512-tQtKA9WIAhBF3+VLAseyMqZeBjW0AHJoxOtYqSUZNJxauErmLbVm2FW1y+J/YA9dUrAC39ITejlZWhVIwawkKw==",
+      "dev": true,
+      "requires": {
+        "core-util-is": "~1.0.0",
+        "inherits": "~2.0.3",
+        "isarray": "~1.0.0",
+        "process-nextick-args": "~2.0.0",
+        "safe-buffer": "~5.1.1",
+        "string_decoder": "~1.1.1",
+        "util-deprecate": "~1.0.1"
+      }
+    },
+    "readdirp": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-2.1.0.tgz",
+      "integrity": "sha1-TtCtBg3zBzMAxIRANz9y0cxkLXg=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "minimatch": "^3.0.2",
+        "readable-stream": "^2.0.2",
+        "set-immediate-shim": "^1.0.1"
+      }
+    },
+    "reduce-css-calc": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/reduce-css-calc/-/reduce-css-calc-1.3.0.tgz",
+      "integrity": "sha1-dHyRTgSWFKTJz7umKYca0dKSdxY=",
+      "dev": true,
+      "requires": {
+        "balanced-match": "^0.4.2",
+        "math-expression-evaluator": "^1.2.14",
+        "reduce-function-call": "^1.0.1"
+      },
+      "dependencies": {
+        "balanced-match": {
+          "version": "0.4.2",
+          "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-0.4.2.tgz",
+          "integrity": "sha1-yz8+PHMtwPAe5wtAPzAuYddwmDg=",
+          "dev": true
+        }
+      }
+    },
+    "reduce-function-call": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/reduce-function-call/-/reduce-function-call-1.0.2.tgz",
+      "integrity": "sha1-WiAL+S4ON3UXUv5FsKszD9S2vpk=",
+      "dev": true,
+      "requires": {
+        "balanced-match": "^0.4.2"
+      },
+      "dependencies": {
+        "balanced-match": {
+          "version": "0.4.2",
+          "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-0.4.2.tgz",
+          "integrity": "sha1-yz8+PHMtwPAe5wtAPzAuYddwmDg=",
+          "dev": true
+        }
+      }
+    },
+    "regenerate": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/regenerate/-/regenerate-1.4.0.tgz",
+      "integrity": "sha512-1G6jJVDWrt0rK99kBjvEtziZNCICAuvIPkSiUFIQxVP06RCVpq3dmDo2oi6ABpYaDYaTRr67BEhL8r1wgEZZKg==",
+      "dev": true
+    },
+    "regenerator-runtime": {
+      "version": "0.11.1",
+      "resolved": "https://registry.npmjs.org/regenerator-runtime/-/regenerator-runtime-0.11.1.tgz",
+      "integrity": "sha512-MguG95oij0fC3QV3URf4V2SDYGJhJnJGqvIIgdECeODCT98wSWDAJ94SSuVpYQUoTcGUIL6L4yNB7j1DFFHSBg==",
+      "dev": true
+    },
+    "regex-not": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/regex-not/-/regex-not-1.0.2.tgz",
+      "integrity": "sha512-J6SDjUgDxQj5NusnOtdFxDwN/+HWykR8GELwctJ7mdqhcyy1xEc4SRFHUXvxTp661YaVKAjfRLZ9cCqS6tn32A==",
+      "dev": true,
+      "requires": {
+        "extend-shallow": "^3.0.2",
+        "safe-regex": "^1.1.0"
+      }
+    },
+    "regexpu-core": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-1.0.0.tgz",
+      "integrity": "sha1-hqdj9Y7k18L2sQLkdkBQ3n7ZDGs=",
+      "dev": true,
+      "requires": {
+        "regenerate": "^1.2.1",
+        "regjsgen": "^0.2.0",
+        "regjsparser": "^0.1.4"
+      }
+    },
+    "regjsgen": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/regjsgen/-/regjsgen-0.2.0.tgz",
+      "integrity": "sha1-bAFq3qxVT3WCP+N6wFuS1aTtsfc=",
+      "dev": true
+    },
+    "regjsparser": {
+      "version": "0.1.5",
+      "resolved": "https://registry.npmjs.org/regjsparser/-/regjsparser-0.1.5.tgz",
+      "integrity": "sha1-fuj4Tcb6eS0/0K4ijSS9lJ6tIFw=",
+      "dev": true,
+      "requires": {
+        "jsesc": "~0.5.0"
+      },
+      "dependencies": {
+        "jsesc": {
+          "version": "0.5.0",
+          "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-0.5.0.tgz",
+          "integrity": "sha1-597mbjXW/Bb3EP6R1c9p9w8IkR0=",
+          "dev": true
+        }
+      }
+    },
+    "remove-trailing-separator": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/remove-trailing-separator/-/remove-trailing-separator-1.1.0.tgz",
+      "integrity": "sha1-wkvOKig62tW8P1jg1IJJuSN52O8=",
+      "dev": true
+    },
+    "repeat-element": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/repeat-element/-/repeat-element-1.1.2.tgz",
+      "integrity": "sha1-7wiaF40Ug7quTZPrmLT55OEdmQo=",
+      "dev": true
+    },
+    "repeat-string": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
+      "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc=",
+      "dev": true
+    },
+    "repeating": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz",
+      "integrity": "sha1-UhTFOpJtNVJwdSf7q0FdvAjQbdo=",
+      "dev": true,
+      "requires": {
+        "is-finite": "^1.0.0"
+      }
+    },
+    "require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha1-jGStX9MNqxyXbiNE/+f3kqam30I=",
+      "dev": true
+    },
+    "require-main-filename": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-1.0.1.tgz",
+      "integrity": "sha1-l/cXtp1IeE9fUmpsWqj/3aBVpNE=",
+      "dev": true
+    },
+    "resolve": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.8.1.tgz",
+      "integrity": "sha512-AicPrAC7Qu1JxPCZ9ZgCZlY35QgFnNqc+0LtbRNxnVw4TXvjQ72wnuL9JQcEBgXkI9JM8MsT9kaQoHcpCRJOYA==",
+      "dev": true,
+      "requires": {
+        "path-parse": "^1.0.5"
+      }
+    },
+    "resolve-cwd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-cwd/-/resolve-cwd-2.0.0.tgz",
+      "integrity": "sha1-AKn3OHVW4nA46uIyyqNypqWbZlo=",
+      "dev": true,
+      "requires": {
+        "resolve-from": "^3.0.0"
+      }
+    },
+    "resolve-from": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-3.0.0.tgz",
+      "integrity": "sha1-six699nWiBvItuZTM17rywoYh0g=",
+      "dev": true
+    },
+    "resolve-url": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/resolve-url/-/resolve-url-0.2.1.tgz",
+      "integrity": "sha1-LGN/53yJOv0qZj/iGqkIAGjiBSo=",
+      "dev": true
+    },
+    "restore-cursor": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-2.0.0.tgz",
+      "integrity": "sha1-n37ih/gv0ybU/RYpI9YhKe7g368=",
+      "dev": true,
+      "requires": {
+        "onetime": "^2.0.0",
+        "signal-exit": "^3.0.2"
+      }
+    },
+    "ret": {
+      "version": "0.1.15",
+      "resolved": "https://registry.npmjs.org/ret/-/ret-0.1.15.tgz",
+      "integrity": "sha512-TTlYpa+OL+vMMNG24xSlQGEJ3B/RzEfUlLct7b5G/ytav+wPrplCpVMFuwzXbkecJrb6IYo1iFb0S9v37754mg==",
+      "dev": true
+    },
+    "right-align": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/right-align/-/right-align-0.1.3.tgz",
+      "integrity": "sha1-YTObci/mo1FWiSENJOFMlhSGE+8=",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "align-text": "^0.1.1"
+      }
+    },
+    "rimraf": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.6.2.tgz",
+      "integrity": "sha512-lreewLK/BlghmxtfH36YYVg1i8IAce4TI7oao75I1g245+6BctqTVQiBP3YUJ9C6DQOXJmkYR9X9fCLtCOJc5w==",
+      "dev": true,
+      "requires": {
+        "glob": "^7.0.5"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "7.1.2",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
+          "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+          "dev": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        }
+      }
+    },
+    "ripemd160": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
+      "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
+      "dev": true,
+      "requires": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1"
+      }
+    },
+    "run-async": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/run-async/-/run-async-2.3.0.tgz",
+      "integrity": "sha1-A3GrSuC91yDUFm19/aZP96RFpsA=",
+      "dev": true,
+      "requires": {
+        "is-promise": "^2.1.0"
+      }
+    },
+    "run-queue": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/run-queue/-/run-queue-1.0.3.tgz",
+      "integrity": "sha1-6Eg5bwV9Ij8kOGkkYY4laUFh7Ec=",
+      "dev": true,
+      "requires": {
+        "aproba": "^1.1.1"
+      }
+    },
+    "rxjs": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-6.2.1.tgz",
+      "integrity": "sha512-OwMxHxmnmHTUpgO+V7dZChf3Tixf4ih95cmXjzzadULziVl/FKhHScGLj4goEw9weePVOH2Q0+GcCBUhKCZc/g==",
+      "dev": true,
+      "requires": {
+        "tslib": "^1.9.0"
+      }
+    },
+    "safe-buffer": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
+      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
+      "dev": true
+    },
+    "safe-regex": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/safe-regex/-/safe-regex-1.1.0.tgz",
+      "integrity": "sha1-QKNmnzsHfR6UPURinhV91IAjvy4=",
+      "dev": true,
+      "requires": {
+        "ret": "~0.1.10"
+      }
+    },
+    "safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "dev": true
+    },
+    "sax": {
+      "version": "1.2.4",
+      "resolved": "https://registry.npmjs.org/sax/-/sax-1.2.4.tgz",
+      "integrity": "sha512-NqVDv9TpANUjFm0N8uM5GxL36UgKi9/atZw+x7YFnQ8ckwFGKrl4xX4yWtrey3UJm5nP1kUbnYgLopqWNSRhWw==",
+      "dev": true
+    },
+    "schema-utils": {
+      "version": "0.4.5",
+      "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-0.4.5.tgz",
+      "integrity": "sha512-yYrjb9TX2k/J1Y5UNy3KYdZq10xhYcF8nMpAW6o3hy6Q8WSIEf9lJHG/ePnOBfziPM3fvQwfOwa13U/Fh8qTfA==",
+      "dev": true,
+      "requires": {
+        "ajv": "^6.1.0",
+        "ajv-keywords": "^3.1.0"
+      }
+    },
+    "seekout": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/seekout/-/seekout-1.0.2.tgz",
+      "integrity": "sha1-CbqfG9W0b7sTRxjrGaaDgsuxuck=",
+      "dev": true
+    },
+    "semver": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.5.0.tgz",
+      "integrity": "sha512-4SJ3dm0WAwWy/NVeioZh5AntkdJoWKxHxcmyP622fOkgHa4z3R0TdBJICINyaSDE6uNwVc8gZr+ZinwZAH4xIA==",
+      "dev": true
+    },
+    "serialize-javascript": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-1.5.0.tgz",
+      "integrity": "sha512-Ga8c8NjAAp46Br4+0oZ2WxJCwIzwP60Gq1YPgU+39PiTVxyed/iKE/zyZI6+UlVYH5Q4PaQdHhcegIFPZTUfoQ==",
+      "dev": true
+    },
+    "set-blocking": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
+      "integrity": "sha1-BF+XgtARrppoA93TgrJDkrPYkPc=",
+      "dev": true
+    },
+    "set-immediate-shim": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/set-immediate-shim/-/set-immediate-shim-1.0.1.tgz",
+      "integrity": "sha1-SysbJ+uAip+NzEgaWOXlb1mfP2E=",
+      "dev": true
+    },
+    "set-value": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/set-value/-/set-value-2.0.0.tgz",
+      "integrity": "sha512-hw0yxk9GT/Hr5yJEYnHNKYXkIA8mVJgd9ditYZCe16ZczcaELYYcfvaXesNACk2O8O0nTiPQcQhGUQj8JLzeeg==",
+      "dev": true,
+      "requires": {
+        "extend-shallow": "^2.0.1",
+        "is-extendable": "^0.1.1",
+        "is-plain-object": "^2.0.3",
+        "split-string": "^3.0.1"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha1-KQy7Iy4waULX1+qbg3Mqt4VvgoU=",
+      "dev": true
+    },
+    "sha.js": {
+      "version": "2.4.11",
+      "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
+      "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
+      "dev": true,
+      "requires": {
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "shebang-command": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-1.2.0.tgz",
+      "integrity": "sha1-RKrGW2lbAzmJaMOfNj/uXer98eo=",
+      "dev": true,
+      "requires": {
+        "shebang-regex": "^1.0.0"
+      }
+    },
+    "shebang-regex": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-1.0.0.tgz",
+      "integrity": "sha1-2kL0l0DAtC2yypcoVxyxkMmO/qM=",
+      "dev": true
+    },
+    "signal-exit": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.2.tgz",
+      "integrity": "sha1-tf3AjxKH6hF4Yo5BXiUTK3NkbG0=",
+      "dev": true
+    },
+    "slash": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-1.0.0.tgz",
+      "integrity": "sha1-xB8vbDn8FtHNF61LXYlhFK5HDVU=",
+      "dev": true
+    },
+    "snapdragon": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz",
+      "integrity": "sha512-FtyOnWN/wCHTVXOMwvSv26d+ko5vWlIDD6zoUJ7LW8vh+ZBC8QdljveRP+crNrtBwioEUWy/4dMtbBjA4ioNlg==",
+      "dev": true,
+      "requires": {
+        "base": "^0.11.1",
+        "debug": "^2.2.0",
+        "define-property": "^0.2.5",
+        "extend-shallow": "^2.0.1",
+        "map-cache": "^0.2.2",
+        "source-map": "^0.5.6",
+        "source-map-resolve": "^0.5.0",
+        "use": "^3.1.0"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        },
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        }
+      }
+    },
+    "snapdragon-node": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/snapdragon-node/-/snapdragon-node-2.1.1.tgz",
+      "integrity": "sha512-O27l4xaMYt/RSQ5TR3vpWCAB5Kb/czIcqUFOM/C4fYcLnbZUc1PkjTAMjof2pBWaSTwOUd6qUHcFGVGj7aIwnw==",
+      "dev": true,
+      "requires": {
+        "define-property": "^1.0.0",
+        "isobject": "^3.0.0",
+        "snapdragon-util": "^3.0.1"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-1.0.0.tgz",
+          "integrity": "sha1-dp66rz9KY6rTr56NMEybvnm/sOY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^1.0.0"
+          }
+        },
+        "is-accessor-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-accessor-descriptor/-/is-accessor-descriptor-1.0.0.tgz",
+          "integrity": "sha512-m5hnHTkcVsPfqx3AKlyttIPb7J+XykHvJP2B9bZDjlhLIoEq4XoK64Vg7boZlVWYK6LUY94dYPEE7Lh0ZkZKcQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-data-descriptor": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-1.0.0.tgz",
+          "integrity": "sha512-jbRXy1FmtAoCjQkVmIVYwuuqDFUbaOeDjmed1tOGPrsMhtJA4rD9tkgA0F1qJ3gRFRXcHYVkdeaP50Q5rE/jLQ==",
+          "dev": true,
+          "requires": {
+            "kind-of": "^6.0.0"
+          }
+        },
+        "is-descriptor": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-1.0.2.tgz",
+          "integrity": "sha512-2eis5WqQGV7peooDyLmNEPUrps9+SXX5c9pL3xEB+4e9HnGuDa7mB7kHxHw4CbqS9k1T2hOH3miL8n8WtiYVtg==",
+          "dev": true,
+          "requires": {
+            "is-accessor-descriptor": "^1.0.0",
+            "is-data-descriptor": "^1.0.0",
+            "kind-of": "^6.0.2"
+          }
+        },
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "snapdragon-util": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/snapdragon-util/-/snapdragon-util-3.0.1.tgz",
+      "integrity": "sha512-mbKkMdQKsjX4BAL4bRYTj21edOf8cN7XHdYUJEe+Zn99hVEYcMvKPct1IqNe7+AZPirn8BCDOQBHQZknqmKlZQ==",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.2.0"
+      }
+    },
+    "sort-keys": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/sort-keys/-/sort-keys-1.1.2.tgz",
+      "integrity": "sha1-RBttTTRnmPG05J6JIK37oOVD+a0=",
+      "dev": true,
+      "requires": {
+        "is-plain-obj": "^1.0.0"
+      }
+    },
+    "source-list-map": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/source-list-map/-/source-list-map-2.0.0.tgz",
+      "integrity": "sha512-I2UmuJSRr/T8jisiROLU3A3ltr+swpniSmNPI4Ml3ZCX6tVnDsuZzK7F2hl5jTqbZBWCEKlj5HRQiPExXLgE8A==",
+      "dev": true
+    },
+    "source-map": {
+      "version": "0.5.7",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.5.7.tgz",
+      "integrity": "sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=",
+      "dev": true
+    },
+    "source-map-resolve": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/source-map-resolve/-/source-map-resolve-0.5.2.tgz",
+      "integrity": "sha512-MjqsvNwyz1s0k81Goz/9vRBe9SZdB09Bdw+/zYyO+3CuPk6fouTaxscHkgtE8jKvf01kVfl8riHzERQ/kefaSA==",
+      "dev": true,
+      "requires": {
+        "atob": "^2.1.1",
+        "decode-uri-component": "^0.2.0",
+        "resolve-url": "^0.2.1",
+        "source-map-url": "^0.4.0",
+        "urix": "^0.1.0"
+      }
+    },
+    "source-map-support": {
+      "version": "0.4.18",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.4.18.tgz",
+      "integrity": "sha512-try0/JqxPLF9nOjvSta7tVondkP5dwgyLDjVoyMDlmjugT2lRZ1OfsrYTkCd2hkDnJTKRbO/Rl3orm8vlsUzbA==",
+      "dev": true,
+      "requires": {
+        "source-map": "^0.5.6"
+      }
+    },
+    "source-map-url": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/source-map-url/-/source-map-url-0.4.0.tgz",
+      "integrity": "sha1-PpNdfd1zYxuXZZlW1VEo6HtQhKM=",
+      "dev": true
+    },
+    "split-string": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz",
+      "integrity": "sha512-NzNVhJDYpwceVVii8/Hu6DKfD2G+NrQHlS/V/qgv763EYudVwEcMQNxd2lh+0VrUByXN/oJkl5grOhYWvQUYiw==",
+      "dev": true,
+      "requires": {
+        "extend-shallow": "^3.0.0"
+      }
+    },
+    "sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw=",
+      "dev": true
+    },
+    "ssri": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/ssri/-/ssri-5.3.0.tgz",
+      "integrity": "sha512-XRSIPqLij52MtgoQavH/x/dU1qVKtWUAAZeOHsR9c2Ddi4XerFy3mc1alf+dLJKl9EUIm/Ht+EowFkTUOA6GAQ==",
+      "dev": true,
+      "requires": {
+        "safe-buffer": "^5.1.1"
+      }
+    },
+    "static-extend": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/static-extend/-/static-extend-0.1.2.tgz",
+      "integrity": "sha1-YICcOcv/VTNyJv1eC1IPNB8ftcY=",
+      "dev": true,
+      "requires": {
+        "define-property": "^0.2.5",
+        "object-copy": "^0.1.0"
+      },
+      "dependencies": {
+        "define-property": {
+          "version": "0.2.5",
+          "resolved": "https://registry.npmjs.org/define-property/-/define-property-0.2.5.tgz",
+          "integrity": "sha1-w1se+RjsPJkPmlvFe+BKrOxcgRY=",
+          "dev": true,
+          "requires": {
+            "is-descriptor": "^0.1.0"
+          }
+        }
+      }
+    },
+    "stream-browserify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/stream-browserify/-/stream-browserify-2.0.1.tgz",
+      "integrity": "sha1-ZiZu5fm9uZQKTkUUyvtDu3Hlyds=",
+      "dev": true,
+      "requires": {
+        "inherits": "~2.0.1",
+        "readable-stream": "^2.0.2"
+      }
+    },
+    "stream-each": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/stream-each/-/stream-each-1.2.2.tgz",
+      "integrity": "sha512-mc1dbFhGBxvTM3bIWmAAINbqiuAk9TATcfIQC8P+/+HJefgaiTlMn2dHvkX8qlI12KeYKSQ1Ua9RrIqrn1VPoA==",
+      "dev": true,
+      "requires": {
+        "end-of-stream": "^1.1.0",
+        "stream-shift": "^1.0.0"
+      }
+    },
+    "stream-http": {
+      "version": "2.8.3",
+      "resolved": "https://registry.npmjs.org/stream-http/-/stream-http-2.8.3.tgz",
+      "integrity": "sha512-+TSkfINHDo4J+ZobQLWiMouQYB+UVYFttRA94FpEzzJ7ZdqcL4uUUQ7WkdkI4DSozGmgBUE/a47L+38PenXhUw==",
+      "dev": true,
+      "requires": {
+        "builtin-status-codes": "^3.0.0",
+        "inherits": "^2.0.1",
+        "readable-stream": "^2.3.6",
+        "to-arraybuffer": "^1.0.0",
+        "xtend": "^4.0.0"
+      }
+    },
+    "stream-shift": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/stream-shift/-/stream-shift-1.0.0.tgz",
+      "integrity": "sha1-1cdSgl5TZ+eG944Y5EXqIjoVWVI=",
+      "dev": true
+    },
+    "strict-uri-encode": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/strict-uri-encode/-/strict-uri-encode-1.1.0.tgz",
+      "integrity": "sha1-J5siXfHVgrH1TmWt3UNS4Y+qBxM=",
+      "dev": true
+    },
+    "string-width": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-2.1.1.tgz",
+      "integrity": "sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==",
+      "dev": true,
+      "requires": {
+        "is-fullwidth-code-point": "^2.0.0",
+        "strip-ansi": "^4.0.0"
+      },
+      "dependencies": {
+        "ansi-regex": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz",
+          "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=",
+          "dev": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
+          "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          }
+        }
+      }
+    },
+    "string_decoder": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
+      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
+      "dev": true,
+      "requires": {
+        "safe-buffer": "~5.1.0"
+      }
+    },
+    "strip-ansi": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-3.0.1.tgz",
+      "integrity": "sha1-ajhfuIU9lS1f8F0Oiq+UJ43GPc8=",
+      "dev": true,
+      "requires": {
+        "ansi-regex": "^2.0.0"
+      }
+    },
+    "strip-eof": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-eof/-/strip-eof-1.0.0.tgz",
+      "integrity": "sha1-u0P/VZim6wXYm1n80SnJgzE2Br8=",
+      "dev": true
+    },
+    "style-loader": {
+      "version": "0.21.0",
+      "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-0.21.0.tgz",
+      "integrity": "sha512-T+UNsAcl3Yg+BsPKs1vd22Fr8sVT+CJMtzqc6LEw9bbJZb43lm9GoeIfUcDEefBSWC0BhYbcdupV1GtI4DGzxg==",
+      "dev": true,
+      "requires": {
+        "loader-utils": "^1.1.0",
+        "schema-utils": "^0.4.5"
+      }
+    },
+    "supports-color": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-2.0.0.tgz",
+      "integrity": "sha1-U10EXOa2Nj+kARcIRimZXp3zJMc=",
+      "dev": true
+    },
+    "svgo": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/svgo/-/svgo-0.7.2.tgz",
+      "integrity": "sha1-n1dyQTlSE1xv779Ar+ak+qiLS7U=",
+      "dev": true,
+      "requires": {
+        "coa": "~1.0.1",
+        "colors": "~1.1.2",
+        "csso": "~2.3.1",
+        "js-yaml": "~3.7.0",
+        "mkdirp": "~0.5.1",
+        "sax": "~1.2.1",
+        "whet.extend": "~0.9.9"
+      },
+      "dependencies": {
+        "js-yaml": {
+          "version": "3.7.0",
+          "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.7.0.tgz",
+          "integrity": "sha1-XJZ93YN6m/3KXy3oQlOr6KHAO4A=",
+          "dev": true,
+          "requires": {
+            "argparse": "^1.0.7",
+            "esprima": "^2.6.0"
+          }
+        }
+      }
+    },
+    "tapable": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/tapable/-/tapable-1.0.0.tgz",
+      "integrity": "sha512-dQRhbNQkRnaqauC7WqSJ21EEksgT0fYZX2lqXzGkpo8JNig9zGZTYoMGvyI2nWmXlE2VSVXVDu7wLVGu/mQEsg==",
+      "dev": true
+    },
+    "text-table": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz",
+      "integrity": "sha1-f17oI66AUgfACvLfSoTsP8+lcLQ=",
+      "dev": true
+    },
+    "through": {
+      "version": "2.3.8",
+      "resolved": "https://registry.npmjs.org/through/-/through-2.3.8.tgz",
+      "integrity": "sha1-DdTJ/6q8NXlgsbckEV1+Doai4fU=",
+      "dev": true
+    },
+    "through2": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.3.tgz",
+      "integrity": "sha1-AARWmzfHx0ujnEPzzteNGtlBQL4=",
+      "dev": true,
+      "requires": {
+        "readable-stream": "^2.1.5",
+        "xtend": "~4.0.1"
+      }
+    },
+    "timers-browserify": {
+      "version": "2.0.10",
+      "resolved": "https://registry.npmjs.org/timers-browserify/-/timers-browserify-2.0.10.tgz",
+      "integrity": "sha512-YvC1SV1XdOUaL6gx5CoGroT3Gu49pK9+TZ38ErPldOWW4j49GI1HKs9DV+KGq/w6y+LZ72W1c8cKz2vzY+qpzg==",
+      "dev": true,
+      "requires": {
+        "setimmediate": "^1.0.4"
+      }
+    },
+    "tmp": {
+      "version": "0.0.33",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
+      "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==",
+      "dev": true,
+      "requires": {
+        "os-tmpdir": "~1.0.2"
+      }
+    },
+    "to-arraybuffer": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",
+      "integrity": "sha1-fSKbH8xjfkZsoIEYCDanqr/4P0M=",
+      "dev": true
+    },
+    "to-fast-properties": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-1.0.3.tgz",
+      "integrity": "sha1-uDVx+k2MJbguIxsG46MFXeTKGkc=",
+      "dev": true
+    },
+    "to-object-path": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/to-object-path/-/to-object-path-0.3.0.tgz",
+      "integrity": "sha1-KXWIt7Dn4KwI4E5nL4XB9JmeF68=",
+      "dev": true,
+      "requires": {
+        "kind-of": "^3.0.2"
+      }
+    },
+    "to-regex": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/to-regex/-/to-regex-3.0.2.tgz",
+      "integrity": "sha512-FWtleNAtZ/Ki2qtqej2CXTOayOH9bHDQF+Q48VpWyDXjbYxA4Yz8iDB31zXOBUlOHHKidDbqGVrTUvQMPmBGBw==",
+      "dev": true,
+      "requires": {
+        "define-property": "^2.0.2",
+        "extend-shallow": "^3.0.2",
+        "regex-not": "^1.0.2",
+        "safe-regex": "^1.1.0"
+      }
+    },
+    "to-regex-range": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-2.1.1.tgz",
+      "integrity": "sha1-fIDBe53+vlmeJzZ+DU3VWQFB2zg=",
+      "dev": true,
+      "requires": {
+        "is-number": "^3.0.0",
+        "repeat-string": "^1.6.1"
+      }
+    },
+    "trim-right": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/trim-right/-/trim-right-1.0.1.tgz",
+      "integrity": "sha1-yy4SAwZ+DI3h9hQJS5/kVwTqYAM=",
+      "dev": true
+    },
+    "tslib": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.9.3.tgz",
+      "integrity": "sha512-4krF8scpejhaOgqzBEcGM7yDIEfi0/8+8zDRZhNZZ2kjmHJ4hv3zCbQWxoJGz1iw5U0Jl0nma13xzHXcncMavQ==",
+      "dev": true
+    },
+    "tty-browserify": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/tty-browserify/-/tty-browserify-0.0.0.tgz",
+      "integrity": "sha1-oVe6QC2iTpv5V/mqadUk7tQpAaY=",
+      "dev": true
+    },
+    "type-check": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.3.2.tgz",
+      "integrity": "sha1-WITKtRLPHTVeP7eE8wgEsrUg23I=",
+      "dev": true,
+      "requires": {
+        "prelude-ls": "~1.1.2"
+      }
+    },
+    "typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha1-hnrHTjhkGHsdPUfZlqeOxciDB3c=",
+      "dev": true
+    },
+    "uglify-js": {
+      "version": "2.8.29",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-2.8.29.tgz",
+      "integrity": "sha1-KcVzMUgFe7Th913zW3qcty5qWd0=",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "source-map": "~0.5.1",
+        "uglify-to-browserify": "~1.0.0",
+        "yargs": "~3.10.0"
+      }
+    },
+    "uglify-to-browserify": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/uglify-to-browserify/-/uglify-to-browserify-1.0.2.tgz",
+      "integrity": "sha1-bgkk1r2mta/jSeOabWMoUKD4grc=",
+      "dev": true,
+      "optional": true
+    },
+    "uglifyjs-webpack-plugin": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/uglifyjs-webpack-plugin/-/uglifyjs-webpack-plugin-1.2.7.tgz",
+      "integrity": "sha512-1VicfKhCYHLS8m1DCApqBhoulnASsEoJ/BvpUpP4zoNAPpKzdH+ghk0olGJMmwX2/jprK2j3hAHdUbczBSy2FA==",
+      "dev": true,
+      "requires": {
+        "cacache": "^10.0.4",
+        "find-cache-dir": "^1.0.0",
+        "schema-utils": "^0.4.5",
+        "serialize-javascript": "^1.4.0",
+        "source-map": "^0.6.1",
+        "uglify-es": "^3.3.4",
+        "webpack-sources": "^1.1.0",
+        "worker-farm": "^1.5.2"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.6.1",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+          "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+          "dev": true
+        },
+        "uglify-es": {
+          "version": "3.3.9",
+          "resolved": "https://registry.npmjs.org/uglify-es/-/uglify-es-3.3.9.tgz",
+          "integrity": "sha512-r+MU0rfv4L/0eeW3xZrd16t4NZfK8Ld4SWVglYBb7ez5uXFWHuVRs6xCTrf1yirs9a4j4Y27nn7SRfO6v67XsQ==",
+          "dev": true,
+          "requires": {
+            "commander": "~2.13.0",
+            "source-map": "~0.6.1"
+          }
+        }
+      }
+    },
+    "union-value": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.0.tgz",
+      "integrity": "sha1-XHHDTLW61dzr4+oM0IIHulqhrqQ=",
+      "dev": true,
+      "requires": {
+        "arr-union": "^3.1.0",
+        "get-value": "^2.0.6",
+        "is-extendable": "^0.1.1",
+        "set-value": "^0.4.3"
+      },
+      "dependencies": {
+        "extend-shallow": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+          "integrity": "sha1-Ua99YUrZqfYQ6huvu5idaxxWiQ8=",
+          "dev": true,
+          "requires": {
+            "is-extendable": "^0.1.0"
+          }
+        },
+        "set-value": {
+          "version": "0.4.3",
+          "resolved": "https://registry.npmjs.org/set-value/-/set-value-0.4.3.tgz",
+          "integrity": "sha1-fbCPnT0i3H945Trzw79GZuzfzPE=",
+          "dev": true,
+          "requires": {
+            "extend-shallow": "^2.0.1",
+            "is-extendable": "^0.1.1",
+            "is-plain-object": "^2.0.1",
+            "to-object-path": "^0.3.0"
+          }
+        }
+      }
+    },
+    "uniq": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/uniq/-/uniq-1.0.1.tgz",
+      "integrity": "sha1-sxxa6CVIRKOoKBVBzisEuGWnNP8=",
+      "dev": true
+    },
+    "uniqs": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/uniqs/-/uniqs-2.0.0.tgz",
+      "integrity": "sha1-/+3ks2slKQaW5uFl1KWe25mOawI=",
+      "dev": true
+    },
+    "unique-filename": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/unique-filename/-/unique-filename-1.1.0.tgz",
+      "integrity": "sha1-0F8v5AMlYIcfMOk8vnNe6iAVFPM=",
+      "dev": true,
+      "requires": {
+        "unique-slug": "^2.0.0"
+      }
+    },
+    "unique-slug": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/unique-slug/-/unique-slug-2.0.0.tgz",
+      "integrity": "sha1-22Z258fMBimHj/GWCXx4hVrp9Ks=",
+      "dev": true,
+      "requires": {
+        "imurmurhash": "^0.1.4"
+      }
+    },
+    "unset-value": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unset-value/-/unset-value-1.0.0.tgz",
+      "integrity": "sha1-g3aHP30jNRef+x5vw6jtDfyKtVk=",
+      "dev": true,
+      "requires": {
+        "has-value": "^0.3.1",
+        "isobject": "^3.0.0"
+      },
+      "dependencies": {
+        "has-value": {
+          "version": "0.3.1",
+          "resolved": "https://registry.npmjs.org/has-value/-/has-value-0.3.1.tgz",
+          "integrity": "sha1-ex9YutpiyoJ+wKIHgCVlSEWZXh8=",
+          "dev": true,
+          "requires": {
+            "get-value": "^2.0.3",
+            "has-values": "^0.1.4",
+            "isobject": "^2.0.0"
+          },
+          "dependencies": {
+            "isobject": {
+              "version": "2.1.0",
+              "resolved": "https://registry.npmjs.org/isobject/-/isobject-2.1.0.tgz",
+              "integrity": "sha1-8GVWEJaj8dou9GJy+BXIQNh+DIk=",
+              "dev": true,
+              "requires": {
+                "isarray": "1.0.0"
+              }
+            }
+          }
+        },
+        "has-values": {
+          "version": "0.1.4",
+          "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz",
+          "integrity": "sha1-bWHeldkd/Km5oCCJrThL/49it3E=",
+          "dev": true
+        }
+      }
+    },
+    "upath": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/upath/-/upath-1.1.0.tgz",
+      "integrity": "sha512-bzpH/oBhoS/QI/YtbkqCg6VEiPYjSZtrHQM6/QnJS6OL9pKUFLqb3aFh4Scvwm45+7iAgiMkLhSbaZxUqmrprw==",
+      "dev": true
+    },
+    "uri-js": {
+      "version": "4.2.2",
+      "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.2.2.tgz",
+      "integrity": "sha512-KY9Frmirql91X2Qgjry0Wd4Y+YTdrdZheS8TFwvkbLWf/G5KNJDCh6pKL5OZctEW4+0Baa5idK2ZQuELRwPznQ==",
+      "dev": true,
+      "requires": {
+        "punycode": "^2.1.0"
+      }
+    },
+    "urix": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/urix/-/urix-0.1.0.tgz",
+      "integrity": "sha1-2pN/emLiH+wf0Y1Js1wpNQZ6bHI=",
+      "dev": true
+    },
+    "url": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/url/-/url-0.11.0.tgz",
+      "integrity": "sha1-ODjpfPxgUh63PFJajlW/3Z4uKPE=",
+      "dev": true,
+      "requires": {
+        "punycode": "1.3.2",
+        "querystring": "0.2.0"
+      },
+      "dependencies": {
+        "punycode": {
+          "version": "1.3.2",
+          "resolved": "https://registry.npmjs.org/punycode/-/punycode-1.3.2.tgz",
+          "integrity": "sha1-llOgNvt8HuQjQvIyXM7v6jkmxI0=",
+          "dev": true
+        }
+      }
+    },
+    "url-loader": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/url-loader/-/url-loader-1.0.1.tgz",
+      "integrity": "sha512-rAonpHy7231fmweBKUFe0bYnlGDty77E+fm53NZdij7j/YOpyGzc7ttqG1nAXl3aRs0k41o0PC3TvGXQiw2Zvw==",
+      "dev": true,
+      "requires": {
+        "loader-utils": "^1.1.0",
+        "mime": "^2.0.3",
+        "schema-utils": "^0.4.3"
+      }
+    },
+    "use": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/use/-/use-3.1.0.tgz",
+      "integrity": "sha512-6UJEQM/L+mzC3ZJNM56Q4DFGLX/evKGRg15UJHGB9X5j5Z3AFbgZvjUh2yq/UJUY4U5dh7Fal++XbNg1uzpRAw==",
+      "dev": true,
+      "requires": {
+        "kind-of": "^6.0.2"
+      },
+      "dependencies": {
+        "kind-of": {
+          "version": "6.0.2",
+          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
+          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
+          "dev": true
+        }
+      }
+    },
+    "util": {
+      "version": "0.10.4",
+      "resolved": "https://registry.npmjs.org/util/-/util-0.10.4.tgz",
+      "integrity": "sha512-0Pm9hTQ3se5ll1XihRic3FDIku70C+iHUdT/W926rSgHV5QgXsYbKZN8MSC3tJtSkhuROzvsQjAaFENRXr+19A==",
+      "dev": true,
+      "requires": {
+        "inherits": "2.0.3"
+      }
+    },
+    "util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=",
+      "dev": true
+    },
+    "uuid": {
+      "version": "3.3.2",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-3.3.2.tgz",
+      "integrity": "sha512-yXJmeNaw3DnnKAOKJE51sL/ZaYfWJRl1pK9dr19YFCu0ObS231AB1/LbqTKRAQ5kw8A90rA6fr4riOUpTZvQZA==",
+      "dev": true
+    },
+    "v8-compile-cache": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/v8-compile-cache/-/v8-compile-cache-2.0.0.tgz",
+      "integrity": "sha512-qNdTUMaCjPs4eEnM3W9H94R3sU70YCuT+/ST7nUf+id1bVOrdjrpUaeZLqPBPRph3hsgn4a4BvwpxhHZx+oSDg==",
+      "dev": true
+    },
+    "vendors": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/vendors/-/vendors-1.0.2.tgz",
+      "integrity": "sha512-w/hry/368nO21AN9QljsaIhb9ZiZtZARoVH5f3CsFbawdLdayCgKRPup7CggujvySMxx0I91NOyxdVENohprLQ==",
+      "dev": true
+    },
+    "vm-browserify": {
+      "version": "0.0.4",
+      "resolved": "https://registry.npmjs.org/vm-browserify/-/vm-browserify-0.0.4.tgz",
+      "integrity": "sha1-XX6kW7755Kb/ZflUOOCofDV9WnM=",
+      "dev": true,
+      "requires": {
+        "indexof": "0.0.1"
+      }
+    },
+    "watchpack": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-1.6.0.tgz",
+      "integrity": "sha512-i6dHe3EyLjMmDlU1/bGQpEw25XSjkJULPuAVKCbNRefQVq48yXKUpwg538F7AZTf9kyr57zj++pQFltUa5H7yA==",
+      "dev": true,
+      "requires": {
+        "chokidar": "^2.0.2",
+        "graceful-fs": "^4.1.2",
+        "neo-async": "^2.5.0"
+      }
+    },
+    "webpack": {
+      "version": "4.15.1",
+      "resolved": "https://registry.npmjs.org/webpack/-/webpack-4.15.1.tgz",
+      "integrity": "sha512-UwfFQ2plA5EMhhzwi/hl5xpLk7mNK7p0853Ml04z1Bqw553pY+oS8Xke3funcVy7eG/yMpZPvnlFTUyGKyKoyw==",
+      "dev": true,
+      "requires": {
+        "@webassemblyjs/ast": "1.5.13",
+        "@webassemblyjs/helper-module-context": "1.5.13",
+        "@webassemblyjs/wasm-edit": "1.5.13",
+        "@webassemblyjs/wasm-opt": "1.5.13",
+        "@webassemblyjs/wasm-parser": "1.5.13",
+        "acorn": "^5.6.2",
+        "acorn-dynamic-import": "^3.0.0",
+        "ajv": "^6.1.0",
+        "ajv-keywords": "^3.1.0",
+        "chrome-trace-event": "^1.0.0",
+        "enhanced-resolve": "^4.1.0",
+        "eslint-scope": "^3.7.1",
+        "json-parse-better-errors": "^1.0.2",
+        "loader-runner": "^2.3.0",
+        "loader-utils": "^1.1.0",
+        "memory-fs": "~0.4.1",
+        "micromatch": "^3.1.8",
+        "mkdirp": "~0.5.0",
+        "neo-async": "^2.5.0",
+        "node-libs-browser": "^2.0.0",
+        "schema-utils": "^0.4.4",
+        "tapable": "^1.0.0",
+        "uglifyjs-webpack-plugin": "^1.2.4",
+        "watchpack": "^1.5.0",
+        "webpack-sources": "^1.0.1"
+      }
+    },
+    "webpack-cli": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-3.0.8.tgz",
+      "integrity": "sha512-KnRLJ0BUaYRqrhAMb9dv3gzdmhmgIMKo0FmdsnmfqbPGtLnnZ6tORZAvmmKfr+A0VgiVpqC60Gv7Ofg0R2CHtQ==",
+      "dev": true,
+      "requires": {
+        "chalk": "^2.4.1",
+        "cross-spawn": "^6.0.5",
+        "enhanced-resolve": "^4.0.0",
+        "global-modules-path": "^2.1.0",
+        "import-local": "^1.0.0",
+        "inquirer": "^6.0.0",
+        "interpret": "^1.1.0",
+        "loader-utils": "^1.1.0",
+        "supports-color": "^5.4.0",
+        "v8-compile-cache": "^2.0.0",
+        "yargs": "^11.1.0"
+      },
+      "dependencies": {
+        "ansi-regex": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz",
+          "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=",
+          "dev": true
+        },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "cliui": {
+          "version": "4.1.0",
+          "resolved": "https://registry.npmjs.org/cliui/-/cliui-4.1.0.tgz",
+          "integrity": "sha512-4FG+RSG9DL7uEwRUZXZn3SS34DiDPfzP0VOiEwtUWlE+AR2EIg+hSyvrIgUUfhdgR/UkAeW2QHgeP+hWrXs7jQ==",
+          "dev": true,
+          "requires": {
+            "string-width": "^2.1.1",
+            "strip-ansi": "^4.0.0",
+            "wrap-ansi": "^2.0.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
+          "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          }
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        },
+        "y18n": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/y18n/-/y18n-3.2.1.tgz",
+          "integrity": "sha1-bRX7qITAhnnA136I53WegR4H+kE=",
+          "dev": true
+        },
+        "yargs": {
+          "version": "11.1.0",
+          "resolved": "https://registry.npmjs.org/yargs/-/yargs-11.1.0.tgz",
+          "integrity": "sha512-NwW69J42EsCSanF8kyn5upxvjp5ds+t3+udGBeTbFnERA+lF541DDpMawzo4z6W/QrzNM18D+BPMiOBibnFV5A==",
+          "dev": true,
+          "requires": {
+            "cliui": "^4.0.0",
+            "decamelize": "^1.1.1",
+            "find-up": "^2.1.0",
+            "get-caller-file": "^1.0.1",
+            "os-locale": "^2.0.0",
+            "require-directory": "^2.1.1",
+            "require-main-filename": "^1.0.1",
+            "set-blocking": "^2.0.0",
+            "string-width": "^2.0.0",
+            "which-module": "^2.0.0",
+            "y18n": "^3.2.1",
+            "yargs-parser": "^9.0.2"
+          }
+        }
+      }
+    },
+    "webpack-log": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/webpack-log/-/webpack-log-1.2.0.tgz",
+      "integrity": "sha512-U9AnICnu50HXtiqiDxuli5gLB5PGBo7VvcHx36jRZHwK4vzOYLbImqT4lwWwoMHdQWwEKw736fCHEekokTEKHA==",
+      "dev": true,
+      "requires": {
+        "chalk": "^2.1.0",
+        "log-symbols": "^2.1.0",
+        "loglevelnext": "^1.0.1",
+        "uuid": "^3.1.0"
+      },
+      "dependencies": {
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "webpack-manifest-plugin": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/webpack-manifest-plugin/-/webpack-manifest-plugin-2.0.3.tgz",
+      "integrity": "sha512-FZcnB3MMQ0CT0aU1+LItwywXWAixLTGUEAtN0fw15dScf2LudQwheLPUCj+QMhDlwZT+9ysfKqUFTcfUGc8bXg==",
+      "dev": true,
+      "requires": {
+        "fs-extra": "^0.30.0",
+        "lodash": ">=3.5 <5",
+        "tapable": "^1.0.0"
+      }
+    },
+    "webpack-sources": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-1.1.0.tgz",
+      "integrity": "sha512-aqYp18kPphgoO5c/+NaUvEeACtZjMESmDChuD3NBciVpah3XpMEU9VAAtIaB1BsfJWWTSdv8Vv1m3T0aRk2dUw==",
+      "dev": true,
+      "requires": {
+        "source-list-map": "^2.0.0",
+        "source-map": "~0.6.1"
+      },
+      "dependencies": {
+        "source-map": {
+          "version": "0.6.1",
+          "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+          "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+          "dev": true
+        }
+      }
+    },
+    "whet.extend": {
+      "version": "0.9.9",
+      "resolved": "https://registry.npmjs.org/whet.extend/-/whet.extend-0.9.9.tgz",
+      "integrity": "sha1-+HfVv2SMl+WqVC+twW1qJZucEaE=",
+      "dev": true
+    },
+    "which": {
+      "version": "1.2.14",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.2.14.tgz",
+      "integrity": "sha1-mofEN48D6CfOyvGs31bHNsAcFOU=",
+      "dev": true,
+      "requires": {
+        "isexe": "^2.0.0"
+      }
+    },
+    "which-module": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/which-module/-/which-module-2.0.0.tgz",
+      "integrity": "sha1-2e8H3Od7mQK4o6j6SzHD4/fm6Ho=",
+      "dev": true
+    },
+    "window-size": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/window-size/-/window-size-0.1.0.tgz",
+      "integrity": "sha1-VDjNLqk7IC76Ohn+iIeu58lPnJ0=",
+      "dev": true,
+      "optional": true
+    },
+    "wordwrap": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz",
+      "integrity": "sha1-J1hIEIkUVqQXHI0CJkQa3pDLyus=",
+      "dev": true
+    },
+    "worker-farm": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/worker-farm/-/worker-farm-1.6.0.tgz",
+      "integrity": "sha512-6w+3tHbM87WnSWnENBUvA2pxJPLhQUg5LKwUQHq3r+XPhIM+Gh2R5ycbwPCyuGbNg+lPgdcnQUhuC02kJCvffQ==",
+      "dev": true,
+      "requires": {
+        "errno": "~0.1.7"
+      }
+    },
+    "wrap-ansi": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-2.1.0.tgz",
+      "integrity": "sha1-2Pw9KE3QV5T+hJc8rs3Rz4JP3YU=",
+      "dev": true,
+      "requires": {
+        "string-width": "^1.0.1",
+        "strip-ansi": "^3.0.1"
+      },
+      "dependencies": {
+        "is-fullwidth-code-point": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz",
+          "integrity": "sha1-754xOG8DGn8NZDr4L95QxFfvAMs=",
+          "dev": true,
+          "requires": {
+            "number-is-nan": "^1.0.0"
+          }
+        },
+        "string-width": {
+          "version": "1.0.2",
+          "resolved": "https://registry.npmjs.org/string-width/-/string-width-1.0.2.tgz",
+          "integrity": "sha1-EYvfW4zcUaKn5w0hHgfisLmxB9M=",
+          "dev": true,
+          "requires": {
+            "code-point-at": "^1.0.0",
+            "is-fullwidth-code-point": "^1.0.0",
+            "strip-ansi": "^3.0.0"
+          }
+        }
+      }
+    },
+    "wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=",
+      "dev": true
+    },
+    "xtend": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz",
+      "integrity": "sha1-pcbVMr5lbiPbgg77lDofBJmNY68=",
+      "dev": true
+    },
+    "y18n": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-4.0.0.tgz",
+      "integrity": "sha512-r9S/ZyXu/Xu9q1tYlpsLIsa3EeLXXk0VwlxqTcFRfg9EhMW+17kbt9G0NrgCmhGb5vT2hyhJZLfDGx+7+5Uj/w==",
+      "dev": true
+    },
+    "yallist": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-2.1.2.tgz",
+      "integrity": "sha1-HBH5IY8HYImkfdUS+TxmmaaoHVI=",
+      "dev": true
+    },
+    "yargs": {
+      "version": "3.10.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-3.10.0.tgz",
+      "integrity": "sha1-9+572FfdfB0tOMDnTvvWgdFDH9E=",
+      "dev": true,
+      "optional": true,
+      "requires": {
+        "camelcase": "^1.0.2",
+        "cliui": "^2.1.0",
+        "decamelize": "^1.0.0",
+        "window-size": "0.1.0"
+      }
+    },
+    "yargs-parser": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-9.0.2.tgz",
+      "integrity": "sha1-nM9qQ0YP5O1Aqbto9I1DuKaMwHc=",
+      "dev": true,
+      "requires": {
+        "camelcase": "^4.1.0"
+      },
+      "dependencies": {
+        "camelcase": {
+          "version": "4.1.0",
+          "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-4.1.0.tgz",
+          "integrity": "sha1-1UVjW+HjPFQmScaRc+Xeas+uNN0=",
+          "dev": true
+        }
+      }
+    }
+  }
+}
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
new file mode 100644
index 0000000000000..5f0c4bc592d49
--- /dev/null
+++ b/airflow/www_rbac/package.json
@@ -0,0 +1,55 @@
+{
+  "description": "Apache Airflow is a platform to programmatically author, schedule and monitor workflows.",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "NODE_ENV=dev webpack --watch --colors --progress --debug --output-pathinfo --devtool eval-cheap-source-map --mode development",
+    "prod": "NODE_ENV=production node --max_old_space_size=4096 ./node_modules/webpack/bin/webpack.js -p --colors --progress",
+    "build": "NODE_ENV=production webpack --colors --progress"
+  },
+  "author": "Apache",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/apache/incubator-airflow.git"
+  },
+  "homepage": "http://airflow.apache.org/",
+  "keywords": [
+    "big",
+    "data",
+    "workflow",
+    "airflow",
+    "d3",
+    "nerds",
+    "database",
+    "flask"
+  ],
+  "devDependencies": {
+    "babel": "^6.23.0",
+    "babel-core": "^6.26.3",
+    "babel-istanbul": "^0.12.2",
+    "babel-loader": "^7.1.4",
+    "babel-plugin-css-modules-transform": "^1.6.1",
+    "babel-polyfill": "^6.26.0",
+    "clean-webpack-plugin": "^0.1.19",
+    "copy-webpack-plugin": "^4.5.2",
+    "css-loader": "^0.28.11",
+    "file-loader": "^1.1.11",
+    "imports-loader": "^0.8.0",
+    "mini-css-extract-plugin": "^0.4.1",
+    "style-loader": "^0.21.0",
+    "url-loader": "^1.0.1",
+    "webpack": "^4.12.2",
+    "webpack-cli": "^3.0.8",
+    "webpack-manifest-plugin": "^2.0.3"
+  },
+  "dependencies": {
+    "bootstrap-3-typeahead": "^4.0.2",
+    "bootstrap-toggle": "^2.2.2",
+    "d3": "^3.4.4",
+    "d3-tip": "^0.9.1",
+    "datatables.net": "^1.10.19",
+    "datatables.net-bs": "^1.10.19",
+    "npm": "^6.1.0",
+    "nvd3": "^1.8.6"
+  }
+}
diff --git a/airflow/www_rbac/static/bootstrap-toggle.min.css b/airflow/www_rbac/static/bootstrap-toggle.min.css
deleted file mode 100644
index 0d42ed09cdaa3..0000000000000
--- a/airflow/www_rbac/static/bootstrap-toggle.min.css
+++ /dev/null
@@ -1,28 +0,0 @@
-/*! ========================================================================
- * Bootstrap Toggle: bootstrap-toggle.css v2.2.0
- * http://www.bootstraptoggle.com
- * ========================================================================
- * Copyright 2014 Min Hur, The New York Times Company
- * Licensed under MIT
- * ======================================================================== */
-.checkbox label .toggle,.checkbox-inline .toggle{margin-left:-20px;margin-right:5px}
-.toggle{position:relative;overflow:hidden}
-.toggle input[type=checkbox]{display:none}
-.toggle-group{position:absolute;width:200%;top:0;bottom:0;left:0;transition:left .35s;-webkit-transition:left .35s;-moz-user-select:none;-webkit-user-select:none}
-.toggle.off .toggle-group{left:-100%}
-.toggle-on{position:absolute;top:0;bottom:0;left:0;right:50%;margin:0;border:0;border-radius:0}
-.toggle-off{position:absolute;top:0;bottom:0;left:50%;right:0;margin:0;border:0;border-radius:0}
-.toggle-handle{position:relative;margin:0 auto;padding-top:0;padding-bottom:0;height:100%;width:0;border-width:0 1px}
-.toggle.btn{min-width:59px;min-height:34px}
-.toggle-on.btn{padding-right:24px}
-.toggle-off.btn{padding-left:24px}
-.toggle.btn-lg{min-width:79px;min-height:45px}
-.toggle-on.btn-lg{padding-right:31px}
-.toggle-off.btn-lg{padding-left:31px}
-.toggle-handle.btn-lg{width:40px}
-.toggle.btn-sm{min-width:50px;min-height:30px}
-.toggle-on.btn-sm{padding-right:20px}
-.toggle-off.btn-sm{padding-left:20px}
-.toggle.btn-xs{min-width:35px;min-height:22px}
-.toggle-on.btn-xs{padding-right:12px}
-.toggle-off.btn-xs{padding-left:12px}
\ No newline at end of file
diff --git a/airflow/www_rbac/static/bootstrap-toggle.min.js b/airflow/www_rbac/static/bootstrap-toggle.min.js
deleted file mode 100644
index 37113200bff5c..0000000000000
--- a/airflow/www_rbac/static/bootstrap-toggle.min.js
+++ /dev/null
@@ -1,9 +0,0 @@
-/*! ========================================================================
- * Bootstrap Toggle: bootstrap-toggle.js v2.2.0
- * http://www.bootstraptoggle.com
- * ========================================================================
- * Copyright 2014 Min Hur, The New York Times Company
- * Licensed under MIT
- * ======================================================================== */
-+function(a){"use strict";function b(b){return this.each(function(){var d=a(this),e=d.data("bs.toggle"),f="object"==typeof b&&b;e||d.data("bs.toggle",e=new c(this,f)),"string"==typeof b&&e[b]&&e[b]()})}var c=function(b,c){this.$element=a(b),this.options=a.extend({},this.defaults(),c),this.render()};c.VERSION="2.2.0",c.DEFAULTS={on:"On",off:"Off",onstyle:"primary",offstyle:"default",size:"normal",style:"",width:null,height:null},c.prototype.defaults=function(){return{on:this.$element.attr("data-on")||c.DEFAULTS.on,off:this.$element.attr("data-off")||c.DEFAULTS.off,onstyle:this.$element.attr("data-onstyle")||c.DEFAULTS.onstyle,offstyle:this.$element.attr("data-offstyle")||c.DEFAULTS.offstyle,size:this.$element.attr("data-size")||c.DEFAULTS.size,style:this.$element.attr("data-style")||c.DEFAULTS.style,width:this.$element.attr("data-width")||c.DEFAULTS.width,height:this.$element.attr("data-height")||c.DEFAULTS.height}},c.prototype.render=function(){this._onstyle="btn-"+this.options.onstyle,this._offstyle="btn-"+this.options.offstyle;var b="large"===this.options.size?"btn-lg":"small"===this.options.size?"btn-sm":"mini"===this.options.size?"btn-xs":"",c=a('<label class="btn">').html(this.options.on).addClass(this._onstyle+" "+b),d=a('<label class="btn">').html(this.options.off).addClass(this._offstyle+" "+b+" active"),e=a('<span class="toggle-handle btn btn-default">').addClass(b),f=a('<div class="toggle-group">').append(c,d,e),g=a('<div class="toggle btn" data-toggle="toggle">').addClass(this.$element.prop("checked")?this._onstyle:this._offstyle+" off").addClass(b).addClass(this.options.style);this.$element.wrap(g),a.extend(this,{$toggle:this.$element.parent(),$toggleOn:c,$toggleOff:d,$toggleGroup:f}),this.$toggle.append(f);var h=this.options.width||Math.max(c.outerWidth(),d.outerWidth())+e.outerWidth()/2,i=this.options.height||Math.max(c.outerHeight(),d.outerHeight());c.addClass("toggle-on"),d.addClass("toggle-off"),this.$toggle.css({width:h,height:i}),this.options.height&&(c.css("line-height",c.height()+"px"),d.css("line-height",d.height()+"px")),this.update(!0),this.trigger(!0)},c.prototype.toggle=function(){this.$element.prop("checked")?this.off():this.on()},c.prototype.on=function(a){return this.$element.prop("disabled")?!1:(this.$toggle.removeClass(this._offstyle+" off").addClass(this._onstyle),this.$element.prop("checked",!0),void(a||this.trigger()))},c.prototype.off=function(a){return this.$element.prop("disabled")?!1:(this.$toggle.removeClass(this._onstyle).addClass(this._offstyle+" off"),this.$element.prop("checked",!1),void(a||this.trigger()))},c.prototype.enable=function(){this.$toggle.removeAttr("disabled"),this.$element.prop("disabled",!1)},c.prototype.disable=function(){this.$toggle.attr("disabled","disabled"),this.$element.prop("disabled",!0)},c.prototype.update=function(a){this.$element.prop("disabled")?this.disable():this.enable(),this.$element.prop("checked")?this.on(a):this.off(a)},c.prototype.trigger=function(b){this.$element.off("change.bs.toggle"),b||this.$element.change(),this.$element.on("change.bs.toggle",a.proxy(function(){this.update()},this))},c.prototype.destroy=function(){this.$element.off("change.bs.toggle"),this.$toggleGroup.remove(),this.$element.removeData("bs.toggle"),this.$element.unwrap()};var d=a.fn.bootstrapToggle;a.fn.bootstrapToggle=b,a.fn.bootstrapToggle.Constructor=c,a.fn.toggle.noConflict=function(){return a.fn.bootstrapToggle=d,this},a(function(){a("input[type=checkbox][data-toggle^=toggle]").bootstrapToggle()}),a(document).on("click.bs.toggle","div[data-toggle^=toggle]",function(b){var c=a(this).find("input[type=checkbox]");c.bootstrapToggle("toggle"),b.preventDefault()})}(jQuery);
-//# sourceMappingURL=bootstrap-toggle.min.js.map
\ No newline at end of file
diff --git a/airflow/www_rbac/static/bootstrap3-typeahead.min.js b/airflow/www_rbac/static/bootstrap3-typeahead.min.js
deleted file mode 100644
index be0703db33581..0000000000000
--- a/airflow/www_rbac/static/bootstrap3-typeahead.min.js
+++ /dev/null
@@ -1,26 +0,0 @@
-/* =============================================================
- * bootstrap3-typeahead.js v4.0.2
- * https://github.com/bassjobsen/Bootstrap-3-Typeahead
- * =============================================================
- * Original written by @mdo and @fat
- * =============================================================
- * Copyright 2014 Bass Jobsen @bassjobsen
- *
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- * 
- *   http://www.apache.org/licenses/LICENSE-2.0
- * 
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- * ============================================================ */
-!function(a,b){"use strict";"undefined"!=typeof module&&module.exports?module.exports=b(require("jquery")):"function"==typeof define&&define.amd?define(["jquery"],function(a){return b(a)}):b(a.jQuery)}(this,function(a){"use strict";var b=function(c,d){this.$element=a(c),this.options=a.extend({},b.defaults,d),this.matcher=this.options.matcher||this.matcher,this.sorter=this.options.sorter||this.sorter,this.select=this.options.select||this.select,this.autoSelect="boolean"!=typeof this.options.autoSelect||this.options.autoSelect,this.highlighter=this.options.highlighter||this.highlighter,this.render=this.options.render||this.render,this.updater=this.options.updater||this.updater,this.displayText=this.options.displayText||this.displayText,this.source=this.options.source,this.delay=this.options.delay,this.$menu=a(this.options.menu),this.$appendTo=this.options.appendTo?a(this.options.appendTo):null,this.fitToElement="boolean"==typeof this.options.fitToElement&&this.options.fitToElement,this.shown=!1,this.listen(),this.showHintOnFocus=("boolean"==typeof this.options.showHintOnFocus||"all"===this.options.showHintOnFocus)&&this.options.showHintOnFocus,this.afterSelect=this.options.afterSelect,this.addItem=!1,this.value=this.$element.val()||this.$element.text()};b.prototype={constructor:b,select:function(){var a=this.$menu.find(".active").data("value");if(this.$element.data("active",a),this.autoSelect||a){var b=this.updater(a);b||(b=""),this.$element.val(this.displayText(b)||b).text(this.displayText(b)||b).change(),this.afterSelect(b)}return this.hide()},updater:function(a){return a},setSource:function(a){this.source=a},show:function(){var d,b=a.extend({},this.$element.position(),{height:this.$element[0].offsetHeight}),c="function"==typeof this.options.scrollHeight?this.options.scrollHeight.call():this.options.scrollHeight;if(this.shown?d=this.$menu:this.$appendTo?(d=this.$menu.appendTo(this.$appendTo),this.hasSameParent=this.$appendTo.is(this.$element.parent())):(d=this.$menu.insertAfter(this.$element),this.hasSameParent=!0),!this.hasSameParent){d.css("position","fixed");var e=this.$element.offset();b.top=e.top,b.left=e.left}var f=a(d).parent().hasClass("dropup"),g=f?"auto":b.top+b.height+c,h=a(d).hasClass("dropdown-menu-right"),i=h?"auto":b.left;return d.css({top:g,left:i}).show(),this.options.fitToElement===!0&&d.css("width",this.$element.outerWidth()+"px"),this.shown=!0,this},hide:function(){return this.$menu.hide(),this.shown=!1,this},lookup:function(b){if("undefined"!=typeof b&&null!==b?this.query=b:this.query=this.$element.val()||this.$element.text()||"",this.query.length<this.options.minLength&&!this.options.showHintOnFocus)return this.shown?this.hide():this;var d=a.proxy(function(){a.isFunction(this.source)?this.source(this.query,a.proxy(this.process,this)):this.source&&this.process(this.source)},this);clearTimeout(this.lookupWorker),this.lookupWorker=setTimeout(d,this.delay)},process:function(b){var c=this;return b=a.grep(b,function(a){return c.matcher(a)}),b=this.sorter(b),b.length||this.options.addItem?(b.length>0?this.$element.data("active",b[0]):this.$element.data("active",null),this.options.addItem&&b.push(this.options.addItem),"all"==this.options.items?this.render(b).show():this.render(b.slice(0,this.options.items)).show()):this.shown?this.hide():this},matcher:function(a){var b=this.displayText(a);return~b.toLowerCase().indexOf(this.query.toLowerCase())},sorter:function(a){for(var e,b=[],c=[],d=[];e=a.shift();){var f=this.displayText(e);f.toLowerCase().indexOf(this.query.toLowerCase())?~f.indexOf(this.query)?c.push(e):d.push(e):b.push(e)}return b.concat(c,d)},highlighter:function(a){var b=this.query;if(""===b)return a;var f,c=a.match(/(>)([^<]*)(<)/g),d=[],e=[];if(c&&c.length)for(f=0;f<c.length;++f)c[f].length>2&&d.push(c[f]);else d=[],d.push(a);b = b.replace((/[\(\)\/\.\*\+\?\[\]]/g), function(m) {return '\\'+m;});var h,g=new RegExp(b,"g");for(f=0;f<d.length;++f)h=d[f].match(g),h&&h.length>0&&e.push(d[f]);for(f=0;f<e.length;++f)a=a.replace(e[f],e[f].replace(g,"<strong>$&</strong>"));return a},render:function(b){var c=this,d=this,e=!1,f=[],g=c.options.separator;return a.each(b,function(a,c){a>0&&c[g]!==b[a-1][g]&&f.push({__type:"divider"}),!c[g]||0!==a&&c[g]===b[a-1][g]||f.push({__type:"category",name:c[g]}),f.push(c)}),b=a(f).map(function(b,f){if("category"==(f.__type||!1))return a(c.options.headerHtml).text(f.name)[0];if("divider"==(f.__type||!1))return a(c.options.headerDivider)[0];var g=d.displayText(f);return b=a(c.options.item).data("value",f),b.find("a").html(c.highlighter(g,f)),g==d.$element.val()&&(b.addClass("active"),d.$element.data("active",f),e=!0),b[0]}),this.autoSelect&&!e&&(b.filter(":not(.dropdown-header)").first().addClass("active"),this.$element.data("active",b.first().data("value"))),this.$menu.html(b),this},displayText:function(a){return"undefined"!=typeof a&&"undefined"!=typeof a.name?a.name:a},next:function(b){var c=this.$menu.find(".active").removeClass("active"),d=c.next();d.length||(d=a(this.$menu.find("li")[0])),d.addClass("active")},prev:function(a){var b=this.$menu.find(".active").removeClass("active"),c=b.prev();c.length||(c=this.$menu.find("li").last()),c.addClass("active")},listen:function(){this.$element.on("focus",a.proxy(this.focus,this)).on("blur",a.proxy(this.blur,this)).on("keypress",a.proxy(this.keypress,this)).on("input",a.proxy(this.input,this)).on("keyup",a.proxy(this.keyup,this)),this.eventSupported("keydown")&&this.$element.on("keydown",a.proxy(this.keydown,this)),this.$menu.on("click",a.proxy(this.click,this)).on("mouseenter","li",a.proxy(this.mouseenter,this)).on("mouseleave","li",a.proxy(this.mouseleave,this)).on("mousedown",a.proxy(this.mousedown,this))},destroy:function(){this.$element.data("typeahead",null),this.$element.data("active",null),this.$element.off("focus").off("blur").off("keypress").off("input").off("keyup"),this.eventSupported("keydown")&&this.$element.off("keydown"),this.$menu.remove(),this.destroyed=!0},eventSupported:function(a){var b=a in this.$element;return b||(this.$element.setAttribute(a,"return;"),b="function"==typeof this.$element[a]),b},move:function(a){if(this.shown)switch(a.keyCode){case 9:case 13:case 27:a.preventDefault();break;case 38:if(a.shiftKey)return;a.preventDefault(),this.prev();break;case 40:if(a.shiftKey)return;a.preventDefault(),this.next()}},keydown:function(b){this.suppressKeyPressRepeat=~a.inArray(b.keyCode,[40,38,9,13,27]),this.shown||40!=b.keyCode?this.move(b):this.lookup()},keypress:function(a){this.suppressKeyPressRepeat||this.move(a)},input:function(a){var b=this.$element.val()||this.$element.text();this.value!==b&&(this.value=b,this.lookup())},keyup:function(a){if(!this.destroyed)switch(a.keyCode){case 40:case 38:case 16:case 17:case 18:break;case 9:case 13:if(!this.shown)return;this.select();break;case 27:if(!this.shown)return;this.hide()}},focus:function(a){this.focused||(this.focused=!0,this.options.showHintOnFocus&&this.skipShowHintOnFocus!==!0&&("all"===this.options.showHintOnFocus?this.lookup(""):this.lookup())),this.skipShowHintOnFocus&&(this.skipShowHintOnFocus=!1)},blur:function(a){this.mousedover||this.mouseddown||!this.shown?this.mouseddown&&(this.skipShowHintOnFocus=!0,this.$element.focus(),this.mouseddown=!1):(this.hide(),this.focused=!1)},click:function(a){a.preventDefault(),this.skipShowHintOnFocus=!0,this.select(),this.$element.focus(),this.hide()},mouseenter:function(b){this.mousedover=!0,this.$menu.find(".active").removeClass("active"),a(b.currentTarget).addClass("active")},mouseleave:function(a){this.mousedover=!1,!this.focused&&this.shown&&this.hide()},mousedown:function(a){this.mouseddown=!0,this.$menu.one("mouseup",function(a){this.mouseddown=!1}.bind(this))}};var c=a.fn.typeahead;a.fn.typeahead=function(c){var d=arguments;return"string"==typeof c&&"getActive"==c?this.data("active"):this.each(function(){var e=a(this),f=e.data("typeahead"),g="object"==typeof c&&c;f||e.data("typeahead",f=new b(this,g)),"string"==typeof c&&f[c]&&(d.length>1?f[c].apply(f,Array.prototype.slice.call(d,1)):f[c]())})},b.defaults={source:[],items:8,menu:'<ul class="typeahead dropdown-menu" role="listbox"></ul>',item:'<li><a class="dropdown-item" href="#" role="option"></a></li>',minLength:1,scrollHeight:0,autoSelect:!0,afterSelect:a.noop,addItem:!1,delay:0,separator:"category",headerHtml:'<li class="dropdown-header"></li>',headerDivider:'<li class="divider" role="separator"></li>'},a.fn.typeahead.Constructor=b,a.fn.typeahead.noConflict=function(){return a.fn.typeahead=c,this},a(document).on("focus.typeahead.data-api",'[data-provide="typeahead"]',function(b){var c=a(this);c.data("typeahead")||c.typeahead(c.data())})});
diff --git a/airflow/www_rbac/static/connection_form.js b/airflow/www_rbac/static/connection_form.js
deleted file mode 100644
index b78d1d60eeb86..0000000000000
--- a/airflow/www_rbac/static/connection_form.js
+++ /dev/null
@@ -1,78 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-/**
- * Created by janomar on 23/07/15.
- */
-
-  $(document).ready(function() {
-      var config = {
-        jdbc: {
-            hidden_fields: ['port', 'schema', 'extra'],
-            relabeling: {'host': 'Connection URL'},
-        },
-        google_cloud_platform: {
-            hidden_fields: ['host', 'schema', 'login', 'password', 'port', 'extra'],
-            relabeling: {},
-        },
-        cloudant: {
-            hidden_fields: ['port', 'extra'],
-            relabeling: {
-                'host': 'Account',
-                'login': 'Username (or API Key)',
-                'schema': 'Database'
-            }
-        },
-        docker: {
-            hidden_fields: ['port', 'schema'],
-            relabeling: {
-                'host': 'Registry URL',
-                'login': 'Username',
-            },
-        },
-      }
-      function connTypeChange(connectionType) {
-        $(".hide").removeClass("hide");
-        $.each($("[id^='extra__']"), function() {
-            $(this).parent().parent().addClass('hide')
-        });
-        $.each($("[id^='extra__"+connectionType+"']"), function() {
-            $(this).parent().parent().removeClass('hide')
-        });
-        $("label[orig_text]").each(function(){
-            $(this).text($(this).attr("orig_text"));
-        });
-        if (config[connectionType] != undefined){
-          $.each(config[connectionType].hidden_fields, function(i, field){
-            $("#" + field).parent().parent().addClass('hide')
-          });
-          $.each(config[connectionType].relabeling, function(k, v){
-            lbl = $("label[for='" + k + "']")
-            lbl.attr("orig_text", lbl.text());
-            $("label[for='" + k + "']").text(v);
-          });
-        }
-      }
-      var connectionType=$("#conn_type").val();
-      $("#conn_type").on('change', function(e) {
-        connectionType = $("#conn_type").val();
-        connTypeChange(connectionType);
-      });
-      connTypeChange(connectionType);
-});
diff --git a/airflow/www_rbac/static/bootstrap-theme.css b/airflow/www_rbac/static/css/bootstrap-theme.css
similarity index 100%
rename from airflow/www_rbac/static/bootstrap-theme.css
rename to airflow/www_rbac/static/css/bootstrap-theme.css
diff --git a/airflow/www_rbac/static/gantt.css b/airflow/www_rbac/static/css/gantt.css
similarity index 100%
rename from airflow/www_rbac/static/gantt.css
rename to airflow/www_rbac/static/css/gantt.css
diff --git a/airflow/www_rbac/static/graph.css b/airflow/www_rbac/static/css/graph.css
similarity index 87%
rename from airflow/www_rbac/static/graph.css
rename to airflow/www_rbac/static/css/graph.css
index f1d34800612fa..fa055b9e1bb2a 100644
--- a/airflow/www_rbac/static/graph.css
+++ b/airflow/www_rbac/static/css/graph.css
@@ -17,6 +17,26 @@
 * under the License.
 */
 
+svg {
+    overflow: hidden;
+}
+
+.node rect {
+    stroke: #333;
+    stroke-width: 1px;
+    fill: #fff;
+}
+
+.edgeLabel rect {
+    fill: #fff;
+}
+
+.edgePath {
+    stroke: #333;
+    stroke-width: 1px;
+    fill: none;
+}
+
 g.node rect {
     stroke-width: 3;
     stroke: white;
diff --git a/airflow/www_rbac/static/main.css b/airflow/www_rbac/static/css/main.css
similarity index 97%
rename from airflow/www_rbac/static/main.css
rename to airflow/www_rbac/static/css/main.css
index ab39d44d9e1a7..d3d198356e8db 100644
--- a/airflow/www_rbac/static/main.css
+++ b/airflow/www_rbac/static/css/main.css
@@ -162,13 +162,13 @@ table.dataframe.dataTable thead > tr > th {
     padding: 10px 20px 10px 10px;
 }
 table.dataTable.dataframe thead .sorting {
-    background: url('sort_both.png') no-repeat center right
+    background: url('./../sort_both.png') no-repeat center right
 }
 table.dataTable.dataframe thead .sorting_desc {
-    background: url('sort_desc.png') no-repeat center right
+    background: url('./../sort_desc.png') no-repeat center right
 }
 table.dataTable.dataframe thead .sorting_asc {
-    background: url('sort_asc.png') no-repeat center right
+    background: url('./../sort_asc.png') no-repeat center right
 }
 .no-wrap {
     white-space: nowrap;
diff --git a/airflow/www_rbac/static/tree.css b/airflow/www_rbac/static/css/tree.css
similarity index 100%
rename from airflow/www_rbac/static/tree.css
rename to airflow/www_rbac/static/css/tree.css
diff --git a/airflow/www_rbac/static/d3.tip.v0.6.3.js b/airflow/www_rbac/static/d3.tip.v0.6.3.js
deleted file mode 100644
index b2b48fbfeb0c0..0000000000000
--- a/airflow/www_rbac/static/d3.tip.v0.6.3.js
+++ /dev/null
@@ -1,302 +0,0 @@
-/**
- * The MIT License (MIT)
- * Copyright (c) 2013 Justin Palmer
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy of
- * this software and associated documentation files (the "Software"), to deal in
- * the Software without restriction, including without limitation the rights to
- * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
- * of the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in all
- * copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
- * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
- * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
- * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
- * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
- * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-*/
-
-// d3.tip
-// Copyright (c) 2013 Justin Palmer
-//
-// Tooltips for d3.js SVG visualizations
-
-// Public - contructs a new tooltip
-//
-// Returns a tip
-d3.tip = function() {
-  var direction = d3_tip_direction,
-      offset    = d3_tip_offset,
-      html      = d3_tip_html,
-      node      = initNode(),
-      svg       = null,
-      point     = null,
-      target    = null
-
-  function tip(vis) {
-    svg = getSVGNode(vis)
-    point = svg.createSVGPoint()
-    document.body.appendChild(node)
-  }
-
-  // Public - show the tooltip on the screen
-  //
-  // Returns a tip
-  tip.show = function() {
-    var args = Array.prototype.slice.call(arguments)
-    if(args[args.length - 1] instanceof SVGElement) target = args.pop()
-
-    var content = html.apply(this, args),
-        poffset = offset.apply(this, args),
-        dir     = direction.apply(this, args),
-        nodel   = d3.select(node), i = 0,
-        coords
-
-    nodel.html(content)
-      .style({ opacity: 1, 'pointer-events': 'all' })
-
-    while(i--) nodel.classed(directions[i], false)
-    coords = direction_callbacks.get(dir).apply(this)
-    nodel.classed(dir, true).style({
-      top: (coords.top +  poffset[0]) + 'px',
-      left: (coords.left + poffset[1]) + 'px'
-    })
-
-    return tip
-  }
-
-  // Public - hide the tooltip
-  //
-  // Returns a tip
-  tip.hide = function() {
-    nodel = d3.select(node)
-    nodel.style({ opacity: 0, 'pointer-events': 'none' })
-    return tip
-  }
-
-  // Public: Proxy attr calls to the d3 tip container.  Sets or gets attribute value.
-  //
-  // n - name of the attribute
-  // v - value of the attribute
-  //
-  // Returns tip or attribute value
-  tip.attr = function(n, v) {
-    if (arguments.length < 2 && typeof n === 'string') {
-      return d3.select(node).attr(n)
-    } else {
-      var args =  Array.prototype.slice.call(arguments)
-      d3.selection.prototype.attr.apply(d3.select(node), args)
-    }
-
-    return tip
-  }
-
-  // Public: Proxy style calls to the d3 tip container.  Sets or gets a style value.
-  //
-  // n - name of the property
-  // v - value of the property
-  //
-  // Returns tip or style property value
-  tip.style = function(n, v) {
-    if (arguments.length < 2 && typeof n === 'string') {
-      return d3.select(node).style(n)
-    } else {
-      var args =  Array.prototype.slice.call(arguments)
-      d3.selection.prototype.style.apply(d3.select(node), args)
-    }
-
-    return tip
-  }
-
-  // Public: Set or get the direction of the tooltip
-  //
-  // v - One of n(north), s(south), e(east), or w(west), nw(northwest),
-  //     sw(southwest), ne(northeast) or se(southeast)
-  //
-  // Returns tip or direction
-  tip.direction = function(v) {
-    if (!arguments.length) return direction
-    direction = v == null ? v : d3.functor(v)
-
-    return tip
-  }
-
-  // Public: Sets or gets the offset of the tip
-  //
-  // v - Array of [x, y] offset
-  //
-  // Returns offset or
-  tip.offset = function(v) {
-    if (!arguments.length) return offset
-    offset = v == null ? v : d3.functor(v)
-
-    return tip
-  }
-
-  // Public: sets or gets the html value of the tooltip
-  //
-  // v - String value of the tip
-  //
-  // Returns html value or tip
-  tip.html = function(v) {
-    if (!arguments.length) return html
-    html = v == null ? v : d3.functor(v)
-
-    return tip
-  }
-
-  function d3_tip_direction() { return 'n' }
-  function d3_tip_offset() { return [0, 0] }
-  function d3_tip_html() { return ' ' }
-
-  var direction_callbacks = d3.map({
-    n:  direction_n,
-    s:  direction_s,
-    e:  direction_e,
-    w:  direction_w,
-    nw: direction_nw,
-    ne: direction_ne,
-    sw: direction_sw,
-    se: direction_se
-  }),
-
-  directions = direction_callbacks.keys()
-
-  function direction_n() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.n.y - node.offsetHeight,
-      left: bbox.n.x - node.offsetWidth / 2
-    }
-  }
-
-  function direction_s() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.s.y,
-      left: bbox.s.x - node.offsetWidth / 2
-    }
-  }
-
-  function direction_e() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.e.y - node.offsetHeight / 2,
-      left: bbox.e.x
-    }
-  }
-
-  function direction_w() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.w.y - node.offsetHeight / 2,
-      left: bbox.w.x - node.offsetWidth
-    }
-  }
-
-  function direction_nw() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.nw.y - node.offsetHeight,
-      left: bbox.nw.x - node.offsetWidth
-    }
-  }
-
-  function direction_ne() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.ne.y - node.offsetHeight,
-      left: bbox.ne.x
-    }
-  }
-
-  function direction_sw() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.sw.y,
-      left: bbox.sw.x - node.offsetWidth
-    }
-  }
-
-  function direction_se() {
-    var bbox = getScreenBBox()
-    return {
-      top:  bbox.se.y,
-      left: bbox.e.x
-    }
-  }
-
-  function initNode() {
-    var node = d3.select(document.createElement('div'))
-    node.style({
-      position: 'absolute',
-      opacity: 0,
-      pointerEvents: 'none',
-      boxSizing: 'border-box'
-    })
-
-    return node.node()
-  }
-
-  function getSVGNode(el) {
-    el = el.node()
-    if(el.tagName.toLowerCase() == 'svg')
-      return el
-
-    return el.ownerSVGElement
-  }
-
-  // Private - gets the screen coordinates of a shape
-  //
-  // Given a shape on the screen, will return an SVGPoint for the directions
-  // n(north), s(south), e(east), w(west), ne(northeast), se(southeast), nw(northwest),
-  // sw(southwest).
-  //
-  //    +-+-+
-  //    |   |
-  //    +   +
-  //    |   |
-  //    +-+-+
-  //
-  // Returns an Object {n, s, e, w, nw, sw, ne, se}
-  function getScreenBBox() {
-    var targetel   = target || d3.event.target,
-        bbox       = {},
-        matrix     = targetel.getScreenCTM(),
-        tbbox      = targetel.getBBox(),
-        width      = tbbox.width,
-        height     = tbbox.height,
-        x          = tbbox.x,
-        y          = tbbox.y,
-        scrollTop  = document.documentElement.scrollTop || document.body.scrollTop,
-        scrollLeft = document.documentElement.scrollLeft || document.body.scrollLeft
-
-
-    point.x = x + scrollLeft
-    point.y = y + scrollTop
-    bbox.nw = point.matrixTransform(matrix)
-    point.x += width
-    bbox.ne = point.matrixTransform(matrix)
-    point.y += height
-    bbox.se = point.matrixTransform(matrix)
-    point.x -= width
-    bbox.sw = point.matrixTransform(matrix)
-    point.y -= height / 2
-    bbox.w  = point.matrixTransform(matrix)
-    point.x += width
-    bbox.e = point.matrixTransform(matrix)
-    point.x -= width / 2
-    point.y -= height / 2
-    bbox.n = point.matrixTransform(matrix)
-    point.y += height
-    bbox.s = point.matrixTransform(matrix)
-
-    return bbox
-  }
-
-  return tip
-};
diff --git a/airflow/www_rbac/static/d3.v3.min.js b/airflow/www_rbac/static/d3.v3.min.js
deleted file mode 100644
index 77615c0cf1c4c..0000000000000
--- a/airflow/www_rbac/static/d3.v3.min.js
+++ /dev/null
@@ -1,5 +0,0 @@
-d3=function(){function n(n){return null!=n&&!isNaN(n)}function t(n){return n.length}function e(n){for(var t=1;n*t%1;)t*=10;return t}function r(n,t){try{for(var e in t)Object.defineProperty(n.prototype,e,{value:t[e],enumerable:!1})}catch(r){n.prototype=t}}function u(){}function i(){}function o(n,t,e){return function(){var r=e.apply(t,arguments);return r===t?n:r}}function a(n,t){if(t in n)return t;t=t.charAt(0).toUpperCase()+t.substring(1);for(var e=0,r=Do.length;r>e;++e){var u=Do[e]+t;if(u in n)return u}}function c(){}function l(){}function s(n){function t(){for(var t,r=e,u=-1,i=r.length;++u<i;)(t=r[u].on)&&t.apply(this,arguments);return n}var e=[],r=new u;return t.on=function(t,u){var i,o=r.get(t);return arguments.length<2?o&&o.on:(o&&(o.on=null,e=e.slice(0,i=e.indexOf(o)).concat(e.slice(i+1)),r.remove(t)),u&&e.push(r.set(t,{on:u})),n)},t}function f(){mo.event.preventDefault()}function h(){for(var n,t=mo.event;n=t.sourceEvent;)t=n;return t}function g(n){for(var t=new l,e=0,r=arguments.length;++e<r;)t[arguments[e]]=s(t);return t.of=function(e,r){return function(u){try{var i=u.sourceEvent=mo.event;u.target=n,mo.event=u,t[u.type].apply(e,r)}finally{mo.event=i}}},t}function p(n){return Lo(n,Ro),n}function d(n){return"function"==typeof n?n:function(){return Ho(n,this)}}function v(n){return"function"==typeof n?n:function(){return Fo(n,this)}}function m(n,t){function e(){this.removeAttribute(n)}function r(){this.removeAttributeNS(n.space,n.local)}function u(){this.setAttribute(n,t)}function i(){this.setAttributeNS(n.space,n.local,t)}function o(){var e=t.apply(this,arguments);null==e?this.removeAttribute(n):this.setAttribute(n,e)}function a(){var e=t.apply(this,arguments);null==e?this.removeAttributeNS(n.space,n.local):this.setAttributeNS(n.space,n.local,e)}return n=mo.ns.qualify(n),null==t?n.local?r:e:"function"==typeof t?n.local?a:o:n.local?i:u}function y(n){return n.trim().replace(/\s+/g," ")}function M(n){return new RegExp("(?:^|\\s+)"+mo.requote(n)+"(?:\\s+|$)","g")}function x(n,t){function e(){for(var e=-1;++e<u;)n[e](this,t)}function r(){for(var e=-1,r=t.apply(this,arguments);++e<u;)n[e](this,r)}n=n.trim().split(/\s+/).map(b);var u=n.length;return"function"==typeof t?r:e}function b(n){var t=M(n);return function(e,r){if(u=e.classList)return r?u.add(n):u.remove(n);var u=e.getAttribute("class")||"";r?(t.lastIndex=0,t.test(u)||e.setAttribute("class",y(u+" "+n))):e.setAttribute("class",y(u.replace(t," ")))}}function _(n,t,e){function r(){this.style.removeProperty(n)}function u(){this.style.setProperty(n,t,e)}function i(){var r=t.apply(this,arguments);null==r?this.style.removeProperty(n):this.style.setProperty(n,r,e)}return null==t?r:"function"==typeof t?i:u}function w(n,t){function e(){delete this[n]}function r(){this[n]=t}function u(){var e=t.apply(this,arguments);null==e?delete this[n]:this[n]=e}return null==t?e:"function"==typeof t?u:r}function S(n){return"function"==typeof n?n:(n=mo.ns.qualify(n)).local?function(){return xo.createElementNS(n.space,n.local)}:function(){return xo.createElementNS(this.namespaceURI,n)}}function E(n){return{__data__:n}}function k(n){return function(){return Oo(this,n)}}function A(n){return arguments.length||(n=mo.ascending),function(t,e){return t&&e?n(t.__data__,e.__data__):!t-!e}}function N(n,t){for(var e=0,r=n.length;r>e;e++)for(var u,i=n[e],o=0,a=i.length;a>o;o++)(u=i[o])&&t(u,o,e);return n}function T(n){return Lo(n,Io),n}function q(n){var t,e;return function(r,u,i){var o,a=n[i].update,c=a.length;for(i!=e&&(e=i,t=0),u>=t&&(t=u+1);!(o=a[t])&&++t<c;);return o}}function z(){var n=this.__transition__;n&&++n.active}function C(n,t,e){function r(){var t=this[o];t&&(this.removeEventListener(n,t,t.$),delete this[o])}function u(){var u=l(t,Mo(arguments));r.call(this),this.addEventListener(n,this[o]=u,u.$=e),u._=t}function i(){var t,e=new RegExp("^__on([^.]+)"+mo.requote(n)+"$");for(var r in this)if(t=r.match(e)){var u=this[r];this.removeEventListener(t[1],u,u.$),delete this[r]}}var o="__on"+n,a=n.indexOf("."),l=D;a>0&&(n=n.substring(0,a));var s=Zo.get(n);return s&&(n=s,l=j),a?t?u:r:t?c:i}function D(n,t){return function(e){var r=mo.event;mo.event=e,t[0]=this.__data__;try{n.apply(this,t)}finally{mo.event=r}}}function j(n,t){var e=D(n,t);return function(n){var t=this,r=n.relatedTarget;r&&(r===t||8&r.compareDocumentPosition(t))||e.call(t,n)}}function L(){var n=".dragsuppress-"+ ++Xo,t="touchmove"+n,e="selectstart"+n,r="dragstart"+n,u="click"+n,i=mo.select(_o).on(t,f).on(e,f).on(r,f),o=bo.style,a=o[Vo];return o[Vo]="none",function(t){function e(){i.on(u,null)}i.on(n,null),o[Vo]=a,t&&(i.on(u,function(){f(),e()},!0),setTimeout(e,0))}}function H(n,t){t.changedTouches&&(t=t.changedTouches[0]);var e=n.ownerSVGElement||n;if(e.createSVGPoint){var r=e.createSVGPoint();if(0>$o&&(_o.scrollX||_o.scrollY)){e=mo.select("body").append("svg").style({position:"absolute",top:0,left:0,margin:0,padding:0,border:"none"},"important");var u=e[0][0].getScreenCTM();$o=!(u.f||u.e),e.remove()}return $o?(r.x=t.pageX,r.y=t.pageY):(r.x=t.clientX,r.y=t.clientY),r=r.matrixTransform(n.getScreenCTM().inverse()),[r.x,r.y]}var i=n.getBoundingClientRect();return[t.clientX-i.left-n.clientLeft,t.clientY-i.top-n.clientTop]}function F(n){return n>0?1:0>n?-1:0}function P(n){return n>1?0:-1>n?Bo:Math.acos(n)}function O(n){return n>1?Jo:-1>n?-Jo:Math.asin(n)}function R(n){return((n=Math.exp(n))-1/n)/2}function Y(n){return((n=Math.exp(n))+1/n)/2}function I(n){return((n=Math.exp(2*n))-1)/(n+1)}function U(n){return(n=Math.sin(n/2))*n}function Z(){}function V(n,t,e){return new X(n,t,e)}function X(n,t,e){this.h=n,this.s=t,this.l=e}function $(n,t,e){function r(n){return n>360?n-=360:0>n&&(n+=360),60>n?i+(o-i)*n/60:180>n?o:240>n?i+(o-i)*(240-n)/60:i}function u(n){return Math.round(255*r(n))}var i,o;return n=isNaN(n)?0:(n%=360)<0?n+360:n,t=isNaN(t)?0:0>t?0:t>1?1:t,e=0>e?0:e>1?1:e,o=.5>=e?e*(1+t):e+t-e*t,i=2*e-o,ot(u(n+120),u(n),u(n-120))}function B(n,t,e){return new W(n,t,e)}function W(n,t,e){this.h=n,this.c=t,this.l=e}function J(n,t,e){return isNaN(n)&&(n=0),isNaN(t)&&(t=0),G(e,Math.cos(n*=Qo)*t,Math.sin(n)*t)}function G(n,t,e){return new K(n,t,e)}function K(n,t,e){this.l=n,this.a=t,this.b=e}function Q(n,t,e){var r=(n+16)/116,u=r+t/500,i=r-e/200;return u=tt(u)*sa,r=tt(r)*fa,i=tt(i)*ha,ot(rt(3.2404542*u-1.5371385*r-.4985314*i),rt(-.969266*u+1.8760108*r+.041556*i),rt(.0556434*u-.2040259*r+1.0572252*i))}function nt(n,t,e){return n>0?B(Math.atan2(e,t)*na,Math.sqrt(t*t+e*e),n):B(0/0,0/0,n)}function tt(n){return n>.206893034?n*n*n:(n-4/29)/7.787037}function et(n){return n>.008856?Math.pow(n,1/3):7.787037*n+4/29}function rt(n){return Math.round(255*(.00304>=n?12.92*n:1.055*Math.pow(n,1/2.4)-.055))}function ut(n){return ot(n>>16,255&n>>8,255&n)}function it(n){return ut(n)+""}function ot(n,t,e){return new at(n,t,e)}function at(n,t,e){this.r=n,this.g=t,this.b=e}function ct(n){return 16>n?"0"+Math.max(0,n).toString(16):Math.min(255,n).toString(16)}function lt(n,t,e){var r,u,i,o=0,a=0,c=0;if(r=/([a-z]+)\((.*)\)/i.exec(n))switch(u=r[2].split(","),r[1]){case"hsl":return e(parseFloat(u[0]),parseFloat(u[1])/100,parseFloat(u[2])/100);case"rgb":return t(gt(u[0]),gt(u[1]),gt(u[2]))}return(i=da.get(n))?t(i.r,i.g,i.b):(null!=n&&"#"===n.charAt(0)&&(4===n.length?(o=n.charAt(1),o+=o,a=n.charAt(2),a+=a,c=n.charAt(3),c+=c):7===n.length&&(o=n.substring(1,3),a=n.substring(3,5),c=n.substring(5,7)),o=parseInt(o,16),a=parseInt(a,16),c=parseInt(c,16)),t(o,a,c))}function st(n,t,e){var r,u,i=Math.min(n/=255,t/=255,e/=255),o=Math.max(n,t,e),a=o-i,c=(o+i)/2;return a?(u=.5>c?a/(o+i):a/(2-o-i),r=n==o?(t-e)/a+(e>t?6:0):t==o?(e-n)/a+2:(n-t)/a+4,r*=60):(r=0/0,u=c>0&&1>c?0:r),V(r,u,c)}function ft(n,t,e){n=ht(n),t=ht(t),e=ht(e);var r=et((.4124564*n+.3575761*t+.1804375*e)/sa),u=et((.2126729*n+.7151522*t+.072175*e)/fa),i=et((.0193339*n+.119192*t+.9503041*e)/ha);return G(116*u-16,500*(r-u),200*(u-i))}function ht(n){return(n/=255)<=.04045?n/12.92:Math.pow((n+.055)/1.055,2.4)}function gt(n){var t=parseFloat(n);return"%"===n.charAt(n.length-1)?Math.round(2.55*t):t}function pt(n){return"function"==typeof n?n:function(){return n}}function dt(n){return n}function vt(n){return function(t,e,r){return 2===arguments.length&&"function"==typeof e&&(r=e,e=null),mt(t,e,n,r)}}function mt(n,t,e,r){function u(){var n,t=c.status;if(!t&&c.responseText||t>=200&&300>t||304===t){try{n=e.call(i,c)}catch(r){return o.error.call(i,r),void 0}o.load.call(i,n)}else o.error.call(i,c)}var i={},o=mo.dispatch("beforesend","progress","load","error"),a={},c=new XMLHttpRequest,l=null;return!_o.XDomainRequest||"withCredentials"in c||!/^(http(s)?:)?\/\//.test(n)||(c=new XDomainRequest),"onload"in c?c.onload=c.onerror=u:c.onreadystatechange=function(){c.readyState>3&&u()},c.onprogress=function(n){var t=mo.event;mo.event=n;try{o.progress.call(i,c)}finally{mo.event=t}},i.header=function(n,t){return n=(n+"").toLowerCase(),arguments.length<2?a[n]:(null==t?delete a[n]:a[n]=t+"",i)},i.mimeType=function(n){return arguments.length?(t=null==n?null:n+"",i):t},i.responseType=function(n){return arguments.length?(l=n,i):l},i.response=function(n){return e=n,i},["get","post"].forEach(function(n){i[n]=function(){return i.send.apply(i,[n].concat(Mo(arguments)))}}),i.send=function(e,r,u){if(2===arguments.length&&"function"==typeof r&&(u=r,r=null),c.open(e,n,!0),null==t||"accept"in a||(a.accept=t+",*/*"),c.setRequestHeader)for(var s in a)c.setRequestHeader(s,a[s]);return null!=t&&c.overrideMimeType&&c.overrideMimeType(t),null!=l&&(c.responseType=l),null!=u&&i.on("error",u).on("load",function(n){u(null,n)}),o.beforesend.call(i,c),c.send(null==r?null:r),i},i.abort=function(){return c.abort(),i},mo.rebind(i,o,"on"),null==r?i:i.get(yt(r))}function yt(n){return 1===n.length?function(t,e){n(null==t?e:null)}:n}function Mt(){var n=bt(),t=_t()-n;t>24?(isFinite(t)&&(clearTimeout(Ma),Ma=setTimeout(Mt,t)),ya=0):(ya=1,ba(Mt))}function xt(n,t,e){var r=arguments.length;2>r&&(t=0),3>r&&(e=Date.now()),xa.callback=n,xa.time=e+t}function bt(){var n=Date.now();for(xa=va;xa;)n>=xa.time&&(xa.flush=xa.callback(n-xa.time)),xa=xa.next;return n}function _t(){for(var n,t=va,e=1/0;t;)t.flush?t=n?n.next=t.next:va=t.next:(t.time<e&&(e=t.time),t=(n=t).next);return ma=n,e}function wt(n,t){var e=Math.pow(10,3*Math.abs(8-t));return{scale:t>8?function(n){return n/e}:function(n){return n*e},symbol:n}}function St(n,t){return t-(n?Math.ceil(Math.log(n)/Math.LN10):1)}function Et(n){return n+""}function kt(){}function At(n,t,e){var r=e.s=n+t,u=r-n,i=r-u;e.t=n-i+(t-u)}function Nt(n,t){n&&Da.hasOwnProperty(n.type)&&Da[n.type](n,t)}function Tt(n,t,e){var r,u=-1,i=n.length-e;for(t.lineStart();++u<i;)r=n[u],t.point(r[0],r[1],r[2]);t.lineEnd()}function qt(n,t){var e=-1,r=n.length;for(t.polygonStart();++e<r;)Tt(n[e],t,1);t.polygonEnd()}function zt(){function n(n,t){n*=Qo,t=t*Qo/2+Bo/4;var e=n-r,o=Math.cos(t),a=Math.sin(t),c=i*a,l=u*o+c*Math.cos(e),s=c*Math.sin(e);La.add(Math.atan2(s,l)),r=n,u=o,i=a}var t,e,r,u,i;Ha.point=function(o,a){Ha.point=n,r=(t=o)*Qo,u=Math.cos(a=(e=a)*Qo/2+Bo/4),i=Math.sin(a)},Ha.lineEnd=function(){n(t,e)}}function Ct(n){var t=n[0],e=n[1],r=Math.cos(e);return[r*Math.cos(t),r*Math.sin(t),Math.sin(e)]}function Dt(n,t){return n[0]*t[0]+n[1]*t[1]+n[2]*t[2]}function jt(n,t){return[n[1]*t[2]-n[2]*t[1],n[2]*t[0]-n[0]*t[2],n[0]*t[1]-n[1]*t[0]]}function Lt(n,t){n[0]+=t[0],n[1]+=t[1],n[2]+=t[2]}function Ht(n,t){return[n[0]*t,n[1]*t,n[2]*t]}function Ft(n){var t=Math.sqrt(n[0]*n[0]+n[1]*n[1]+n[2]*n[2]);n[0]/=t,n[1]/=t,n[2]/=t}function Pt(n){return[Math.atan2(n[1],n[0]),O(n[2])]}function Ot(n,t){return Math.abs(n[0]-t[0])<Go&&Math.abs(n[1]-t[1])<Go}function Rt(n,t){n*=Qo;var e=Math.cos(t*=Qo);Yt(e*Math.cos(n),e*Math.sin(n),Math.sin(t))}function Yt(n,t,e){++Fa,Oa+=(n-Oa)/Fa,Ra+=(t-Ra)/Fa,Ya+=(e-Ya)/Fa}function It(){function n(n,u){n*=Qo;var i=Math.cos(u*=Qo),o=i*Math.cos(n),a=i*Math.sin(n),c=Math.sin(u),l=Math.atan2(Math.sqrt((l=e*c-r*a)*l+(l=r*o-t*c)*l+(l=t*a-e*o)*l),t*o+e*a+r*c);Pa+=l,Ia+=l*(t+(t=o)),Ua+=l*(e+(e=a)),Za+=l*(r+(r=c)),Yt(t,e,r)}var t,e,r;Ba.point=function(u,i){u*=Qo;var o=Math.cos(i*=Qo);t=o*Math.cos(u),e=o*Math.sin(u),r=Math.sin(i),Ba.point=n,Yt(t,e,r)}}function Ut(){Ba.point=Rt}function Zt(){function n(n,t){n*=Qo;var e=Math.cos(t*=Qo),o=e*Math.cos(n),a=e*Math.sin(n),c=Math.sin(t),l=u*c-i*a,s=i*o-r*c,f=r*a-u*o,h=Math.sqrt(l*l+s*s+f*f),g=r*o+u*a+i*c,p=h&&-P(g)/h,d=Math.atan2(h,g);Va+=p*l,Xa+=p*s,$a+=p*f,Pa+=d,Ia+=d*(r+(r=o)),Ua+=d*(u+(u=a)),Za+=d*(i+(i=c)),Yt(r,u,i)}var t,e,r,u,i;Ba.point=function(o,a){t=o,e=a,Ba.point=n,o*=Qo;var c=Math.cos(a*=Qo);r=c*Math.cos(o),u=c*Math.sin(o),i=Math.sin(a),Yt(r,u,i)},Ba.lineEnd=function(){n(t,e),Ba.lineEnd=Ut,Ba.point=Rt}}function Vt(){return!0}function Xt(n,t,e,r,u){var i=[],o=[];if(n.forEach(function(n){if(!((t=n.length-1)<=0)){var t,e=n[0],r=n[t];if(Ot(e,r)){u.lineStart();for(var a=0;t>a;++a)u.point((e=n[a])[0],e[1]);return u.lineEnd(),void 0}var c={point:e,points:n,other:null,visited:!1,entry:!0,subject:!0},l={point:e,points:[e],other:c,visited:!1,entry:!1,subject:!1};c.other=l,i.push(c),o.push(l),c={point:r,points:[r],other:null,visited:!1,entry:!1,subject:!0},l={point:r,points:[r],other:c,visited:!1,entry:!0,subject:!1},c.other=l,i.push(c),o.push(l)}}),o.sort(t),$t(i),$t(o),i.length){for(var a=0,c=e,l=o.length;l>a;++a)o[a].entry=c=!c;for(var s,f,h,g=i[0];;){for(s=g;s.visited;)if((s=s.next)===g)return;f=s.points,u.lineStart();do{if(s.visited=s.other.visited=!0,s.entry){if(s.subject)for(var a=0;a<f.length;a++)u.point((h=f[a])[0],h[1]);else r(s.point,s.next.point,1,u);s=s.next}else{if(s.subject){f=s.prev.points;for(var a=f.length;--a>=0;)u.point((h=f[a])[0],h[1])}else r(s.point,s.prev.point,-1,u);s=s.prev}s=s.other,f=s.points}while(!s.visited);u.lineEnd()}}}function $t(n){if(t=n.length){for(var t,e,r=0,u=n[0];++r<t;)u.next=e=n[r],e.prev=u,u=e;u.next=e=n[0],e.prev=u}}function Bt(n,t,e,r){return function(u,i){function o(t,e){var r=u(t,e);n(t=r[0],e=r[1])&&i.point(t,e)}function a(n,t){var e=u(n,t);v.point(e[0],e[1])}function c(){y.point=a,v.lineStart()}function l(){y.point=o,v.lineEnd()}function s(n,t){d.push([n,t]);var e=u(n,t);x.point(e[0],e[1])}function f(){x.lineStart(),d=[]}function h(){s(d[0][0],d[0][1]),x.lineEnd();var n,t=x.clean(),e=M.buffer(),r=e.length;if(d.pop(),p.push(d),d=null,r){if(1&t){n=e[0];var u,r=n.length-1,o=-1;for(i.lineStart();++o<r;)i.point((u=n[o])[0],u[1]);return i.lineEnd(),void 0}r>1&&2&t&&e.push(e.pop().concat(e.shift())),g.push(e.filter(Wt))}}var g,p,d,v=t(i),m=u.invert(r[0],r[1]),y={point:o,lineStart:c,lineEnd:l,polygonStart:function(){y.point=s,y.lineStart=f,y.lineEnd=h,g=[],p=[],i.polygonStart()},polygonEnd:function(){y.point=o,y.lineStart=c,y.lineEnd=l,g=mo.merge(g);var n=Kt(m,p);g.length?Xt(g,Gt,n,e,i):n&&(i.lineStart(),e(null,null,1,i),i.lineEnd()),i.polygonEnd(),g=p=null},sphere:function(){i.polygonStart(),i.lineStart(),e(null,null,1,i),i.lineEnd(),i.polygonEnd()}},M=Jt(),x=t(M);return y}}function Wt(n){return n.length>1}function Jt(){var n,t=[];return{lineStart:function(){t.push(n=[])},point:function(t,e){n.push([t,e])},lineEnd:c,buffer:function(){var e=t;return t=[],n=null,e},rejoin:function(){t.length>1&&t.push(t.pop().concat(t.shift()))}}}function Gt(n,t){return((n=n.point)[0]<0?n[1]-Jo-Go:Jo-n[1])-((t=t.point)[0]<0?t[1]-Jo-Go:Jo-t[1])}function Kt(n,t){var e=n[0],r=n[1],u=[Math.sin(e),-Math.cos(e),0],i=0,o=0;La.reset();for(var a=0,c=t.length;c>a;++a){var l=t[a],s=l.length;if(s)for(var f=l[0],h=f[0],g=f[1]/2+Bo/4,p=Math.sin(g),d=Math.cos(g),v=1;;){v===s&&(v=0),n=l[v];var m=n[0],y=n[1]/2+Bo/4,M=Math.sin(y),x=Math.cos(y),b=m-h,_=Math.abs(b)>Bo,w=p*M;if(La.add(Math.atan2(w*Math.sin(b),d*x+w*Math.cos(b))),i+=_?b+(b>=0?2:-2)*Bo:b,_^h>=e^m>=e){var S=jt(Ct(f),Ct(n));Ft(S);var E=jt(u,S);Ft(E);var k=(_^b>=0?-1:1)*O(E[2]);(r>k||r===k&&(S[0]||S[1]))&&(o+=_^b>=0?1:-1)}if(!v++)break;h=m,p=M,d=x,f=n}}return(-Go>i||Go>i&&0>La)^1&o}function Qt(n){var t,e=0/0,r=0/0,u=0/0;return{lineStart:function(){n.lineStart(),t=1},point:function(i,o){var a=i>0?Bo:-Bo,c=Math.abs(i-e);Math.abs(c-Bo)<Go?(n.point(e,r=(r+o)/2>0?Jo:-Jo),n.point(u,r),n.lineEnd(),n.lineStart(),n.point(a,r),n.point(i,r),t=0):u!==a&&c>=Bo&&(Math.abs(e-u)<Go&&(e-=u*Go),Math.abs(i-a)<Go&&(i-=a*Go),r=ne(e,r,i,o),n.point(u,r),n.lineEnd(),n.lineStart(),n.point(a,r),t=0),n.point(e=i,r=o),u=a},lineEnd:function(){n.lineEnd(),e=r=0/0},clean:function(){return 2-t}}}function ne(n,t,e,r){var u,i,o=Math.sin(n-e);return Math.abs(o)>Go?Math.atan((Math.sin(t)*(i=Math.cos(r))*Math.sin(e)-Math.sin(r)*(u=Math.cos(t))*Math.sin(n))/(u*i*o)):(t+r)/2}function te(n,t,e,r){var u;if(null==n)u=e*Jo,r.point(-Bo,u),r.point(0,u),r.point(Bo,u),r.point(Bo,0),r.point(Bo,-u),r.point(0,-u),r.point(-Bo,-u),r.point(-Bo,0),r.point(-Bo,u);else if(Math.abs(n[0]-t[0])>Go){var i=(n[0]<t[0]?1:-1)*Bo;u=e*i/2,r.point(-i,u),r.point(0,u),r.point(i,u)}else r.point(t[0],t[1])}function ee(n){function t(n,t){return Math.cos(n)*Math.cos(t)>i}function e(n){var e,i,c,l,s;return{lineStart:function(){l=c=!1,s=1},point:function(f,h){var g,p=[f,h],d=t(f,h),v=o?d?0:u(f,h):d?u(f+(0>f?Bo:-Bo),h):0;if(!e&&(l=c=d)&&n.lineStart(),d!==c&&(g=r(e,p),(Ot(e,g)||Ot(p,g))&&(p[0]+=Go,p[1]+=Go,d=t(p[0],p[1]))),d!==c)s=0,d?(n.lineStart(),g=r(p,e),n.point(g[0],g[1])):(g=r(e,p),n.point(g[0],g[1]),n.lineEnd()),e=g;else if(a&&e&&o^d){var m;v&i||!(m=r(p,e,!0))||(s=0,o?(n.lineStart(),n.point(m[0][0],m[0][1]),n.point(m[1][0],m[1][1]),n.lineEnd()):(n.point(m[1][0],m[1][1]),n.lineEnd(),n.lineStart(),n.point(m[0][0],m[0][1])))}!d||e&&Ot(e,p)||n.point(p[0],p[1]),e=p,c=d,i=v},lineEnd:function(){c&&n.lineEnd(),e=null},clean:function(){return s|(l&&c)<<1}}}function r(n,t,e){var r=Ct(n),u=Ct(t),o=[1,0,0],a=jt(r,u),c=Dt(a,a),l=a[0],s=c-l*l;if(!s)return!e&&n;var f=i*c/s,h=-i*l/s,g=jt(o,a),p=Ht(o,f),d=Ht(a,h);Lt(p,d);var v=g,m=Dt(p,v),y=Dt(v,v),M=m*m-y*(Dt(p,p)-1);if(!(0>M)){var x=Math.sqrt(M),b=Ht(v,(-m-x)/y);if(Lt(b,p),b=Pt(b),!e)return b;var _,w=n[0],S=t[0],E=n[1],k=t[1];w>S&&(_=w,w=S,S=_);var A=S-w,N=Math.abs(A-Bo)<Go,T=N||Go>A;if(!N&&E>k&&(_=E,E=k,k=_),T?N?E+k>0^b[1]<(Math.abs(b[0]-w)<Go?E:k):E<=b[1]&&b[1]<=k:A>Bo^(w<=b[0]&&b[0]<=S)){var q=Ht(v,(-m+x)/y);return Lt(q,p),[b,Pt(q)]}}}function u(t,e){var r=o?n:Bo-n,u=0;return-r>t?u|=1:t>r&&(u|=2),-r>e?u|=4:e>r&&(u|=8),u}var i=Math.cos(n),o=i>0,a=Math.abs(i)>Go,c=Te(n,6*Qo);return Bt(t,e,c,o?[0,-n]:[-Bo,n-Bo])}function re(n,t,e,r){function u(r,u){return Math.abs(r[0]-n)<Go?u>0?0:3:Math.abs(r[0]-e)<Go?u>0?2:1:Math.abs(r[1]-t)<Go?u>0?1:0:u>0?3:2}function i(n,t){return o(n.point,t.point)}function o(n,t){var e=u(n,1),r=u(t,1);return e!==r?e-r:0===e?t[1]-n[1]:1===e?n[0]-t[0]:2===e?n[1]-t[1]:t[0]-n[0]}function a(u,i){var o=i[0]-u[0],a=i[1]-u[1],c=[0,1];return Math.abs(o)<Go&&Math.abs(a)<Go?n<=u[0]&&u[0]<=e&&t<=u[1]&&u[1]<=r:ue(n-u[0],o,c)&&ue(u[0]-e,-o,c)&&ue(t-u[1],a,c)&&ue(u[1]-r,-a,c)?(c[1]<1&&(i[0]=u[0]+c[1]*o,i[1]=u[1]+c[1]*a),c[0]>0&&(u[0]+=c[0]*o,u[1]+=c[0]*a),!0):!1}return function(c){function l(n){for(var t=0,e=y.length,r=n[1],u=0;e>u;++u)for(var i,o=1,a=y[u],c=a.length,l=a[0];c>o;++o)i=a[o],l[1]<=r?i[1]>r&&s(l,i,n)>0&&++t:i[1]<=r&&s(l,i,n)<0&&--t,l=i;return 0!==t}function s(n,t,e){return(t[0]-n[0])*(e[1]-n[1])-(e[0]-n[0])*(t[1]-n[1])}function f(i,a,c,l){var s=0,f=0;if(null==i||(s=u(i,c))!==(f=u(a,c))||o(i,a)<0^c>0){do l.point(0===s||3===s?n:e,s>1?r:t);while((s=(s+c+4)%4)!==f)}else l.point(a[0],a[1])}function h(u,i){return u>=n&&e>=u&&i>=t&&r>=i}function g(n,t){h(n,t)&&c.point(n,t)}function p(){q.point=v,y&&y.push(M=[]),k=!0,E=!1,w=S=0/0}function d(){m&&(v(x,b),_&&E&&T.rejoin(),m.push(T.buffer())),q.point=g,E&&c.lineEnd()}function v(n,t){n=Math.max(-Ja,Math.min(Ja,n)),t=Math.max(-Ja,Math.min(Ja,t));var e=h(n,t);if(y&&M.push([n,t]),k)x=n,b=t,_=e,k=!1,e&&(c.lineStart(),c.point(n,t));else if(e&&E)c.point(n,t);else{var r=[w,S],u=[n,t];a(r,u)?(E||(c.lineStart(),c.point(r[0],r[1])),c.point(u[0],u[1]),e||c.lineEnd(),A=!1):e&&(c.lineStart(),c.point(n,t),A=!1)}w=n,S=t,E=e}var m,y,M,x,b,_,w,S,E,k,A,N=c,T=Jt(),q={point:g,lineStart:p,lineEnd:d,polygonStart:function(){c=T,m=[],y=[],A=!0},polygonEnd:function(){c=N,m=mo.merge(m);var t=l([n,r]),e=A&&t,u=m.length;(e||u)&&(c.polygonStart(),e&&(c.lineStart(),f(null,null,1,c),c.lineEnd()),u&&Xt(m,i,t,f,c),c.polygonEnd()),m=y=M=null}};return q}}function ue(n,t,e){if(Math.abs(t)<Go)return 0>=n;var r=n/t;if(t>0){if(r>e[1])return!1;r>e[0]&&(e[0]=r)}else{if(r<e[0])return!1;r<e[1]&&(e[1]=r)}return!0}function ie(n,t){function e(e,r){return e=n(e,r),t(e[0],e[1])}return n.invert&&t.invert&&(e.invert=function(e,r){return e=t.invert(e,r),e&&n.invert(e[0],e[1])}),e}function oe(n){var t=0,e=Bo/3,r=be(n),u=r(t,e);return u.parallels=function(n){return arguments.length?r(t=n[0]*Bo/180,e=n[1]*Bo/180):[180*(t/Bo),180*(e/Bo)]},u}function ae(n,t){function e(n,t){var e=Math.sqrt(i-2*u*Math.sin(t))/u;return[e*Math.sin(n*=u),o-e*Math.cos(n)]}var r=Math.sin(n),u=(r+Math.sin(t))/2,i=1+r*(2*u-r),o=Math.sqrt(i)/u;return e.invert=function(n,t){var e=o-t;return[Math.atan2(n,e)/u,O((i-(n*n+e*e)*u*u)/(2*u))]},e}function ce(){function n(n,t){Ka+=u*n-r*t,r=n,u=t}var t,e,r,u;rc.point=function(i,o){rc.point=n,t=r=i,e=u=o},rc.lineEnd=function(){n(t,e)}}function le(n,t){Qa>n&&(Qa=n),n>tc&&(tc=n),nc>t&&(nc=t),t>ec&&(ec=t)}function se(){function n(n,t){o.push("M",n,",",t,i)}function t(n,t){o.push("M",n,",",t),a.point=e}function e(n,t){o.push("L",n,",",t)}function r(){a.point=n}function u(){o.push("Z")}var i=fe(4.5),o=[],a={point:n,lineStart:function(){a.point=t},lineEnd:r,polygonStart:function(){a.lineEnd=u},polygonEnd:function(){a.lineEnd=r,a.point=n},pointRadius:function(n){return i=fe(n),a},result:function(){if(o.length){var n=o.join("");return o=[],n}}};return a}function fe(n){return"m0,"+n+"a"+n+","+n+" 0 1,1 0,"+-2*n+"a"+n+","+n+" 0 1,1 0,"+2*n+"z"}function he(n,t){Oa+=n,Ra+=t,++Ya}function ge(){function n(n,r){var u=n-t,i=r-e,o=Math.sqrt(u*u+i*i);Ia+=o*(t+n)/2,Ua+=o*(e+r)/2,Za+=o,he(t=n,e=r)}var t,e;ic.point=function(r,u){ic.point=n,he(t=r,e=u)}}function pe(){ic.point=he}function de(){function n(n,t){var e=n-r,i=t-u,o=Math.sqrt(e*e+i*i);Ia+=o*(r+n)/2,Ua+=o*(u+t)/2,Za+=o,o=u*n-r*t,Va+=o*(r+n),Xa+=o*(u+t),$a+=3*o,he(r=n,u=t)}var t,e,r,u;ic.point=function(i,o){ic.point=n,he(t=r=i,e=u=o)},ic.lineEnd=function(){n(t,e)}}function ve(n){function t(t,e){n.moveTo(t,e),n.arc(t,e,o,0,Wo)}function e(t,e){n.moveTo(t,e),a.point=r}function r(t,e){n.lineTo(t,e)}function u(){a.point=t}function i(){n.closePath()}var o=4.5,a={point:t,lineStart:function(){a.point=e},lineEnd:u,polygonStart:function(){a.lineEnd=i},polygonEnd:function(){a.lineEnd=u,a.point=t},pointRadius:function(n){return o=n,a},result:c};return a}function me(n){function t(t){function r(e,r){e=n(e,r),t.point(e[0],e[1])}function u(){M=0/0,S.point=o,t.lineStart()}function o(r,u){var o=Ct([r,u]),a=n(r,u);e(M,x,y,b,_,w,M=a[0],x=a[1],y=r,b=o[0],_=o[1],w=o[2],i,t),t.point(M,x)}function a(){S.point=r,t.lineEnd()}function c(){u(),S.point=l,S.lineEnd=s}function l(n,t){o(f=n,h=t),g=M,p=x,d=b,v=_,m=w,S.point=o}function s(){e(M,x,y,b,_,w,g,p,f,d,v,m,i,t),S.lineEnd=a,a()}var f,h,g,p,d,v,m,y,M,x,b,_,w,S={point:r,lineStart:u,lineEnd:a,polygonStart:function(){t.polygonStart(),S.lineStart=c},polygonEnd:function(){t.polygonEnd(),S.lineStart=u}};return S}function e(t,i,o,a,c,l,s,f,h,g,p,d,v,m){var y=s-t,M=f-i,x=y*y+M*M;if(x>4*r&&v--){var b=a+g,_=c+p,w=l+d,S=Math.sqrt(b*b+_*_+w*w),E=Math.asin(w/=S),k=Math.abs(Math.abs(w)-1)<Go?(o+h)/2:Math.atan2(_,b),A=n(k,E),N=A[0],T=A[1],q=N-t,z=T-i,C=M*q-y*z;(C*C/x>r||Math.abs((y*q+M*z)/x-.5)>.3||u>a*g+c*p+l*d)&&(e(t,i,o,a,c,l,N,T,k,b/=S,_/=S,w,v,m),m.point(N,T),e(N,T,k,b,_,w,s,f,h,g,p,d,v,m))}}var r=.5,u=Math.cos(30*Qo),i=16;return t.precision=function(n){return arguments.length?(i=(r=n*n)>0&&16,t):Math.sqrt(r)},t}function ye(n){this.stream=n}function Me(n){var t=me(function(t,e){return n([t*na,e*na])});return function(n){var e=new ye(n=t(n));return e.point=function(t,e){n.point(t*Qo,e*Qo)},e}}function xe(n){return be(function(){return n})()}function be(n){function t(n){return n=a(n[0]*Qo,n[1]*Qo),[n[0]*h+c,l-n[1]*h]}function e(n){return n=a.invert((n[0]-c)/h,(l-n[1])/h),n&&[n[0]*na,n[1]*na]}function r(){a=ie(o=Ee(m,y,M),i);var n=i(d,v);return c=g-n[0]*h,l=p+n[1]*h,u()}function u(){return s&&(s.valid=!1,s=null),t}var i,o,a,c,l,s,f=me(function(n,t){return n=i(n,t),[n[0]*h+c,l-n[1]*h]}),h=150,g=480,p=250,d=0,v=0,m=0,y=0,M=0,x=Wa,b=dt,_=null,w=null;return t.stream=function(n){return s&&(s.valid=!1),s=_e(x(o,f(b(n)))),s.valid=!0,s},t.clipAngle=function(n){return arguments.length?(x=null==n?(_=n,Wa):ee((_=+n)*Qo),u()):_},t.clipExtent=function(n){return arguments.length?(w=n,b=n?re(n[0][0],n[0][1],n[1][0],n[1][1]):dt,u()):w},t.scale=function(n){return arguments.length?(h=+n,r()):h},t.translate=function(n){return arguments.length?(g=+n[0],p=+n[1],r()):[g,p]},t.center=function(n){return arguments.length?(d=n[0]%360*Qo,v=n[1]%360*Qo,r()):[d*na,v*na]},t.rotate=function(n){return arguments.length?(m=n[0]%360*Qo,y=n[1]%360*Qo,M=n.length>2?n[2]%360*Qo:0,r()):[m*na,y*na,M*na]},mo.rebind(t,f,"precision"),function(){return i=n.apply(this,arguments),t.invert=i.invert&&e,r()}}function _e(n){var t=new ye(n);return t.point=function(t,e){n.point(t*Qo,e*Qo)},t}function we(n,t){return[n,t]}function Se(n,t){return[n>Bo?n-Wo:-Bo>n?n+Wo:n,t]}function Ee(n,t,e){return n?t||e?ie(Ae(n),Ne(t,e)):Ae(n):t||e?Ne(t,e):Se}function ke(n){return function(t,e){return t+=n,[t>Bo?t-Wo:-Bo>t?t+Wo:t,e]}}function Ae(n){var t=ke(n);return t.invert=ke(-n),t}function Ne(n,t){function e(n,t){var e=Math.cos(t),a=Math.cos(n)*e,c=Math.sin(n)*e,l=Math.sin(t),s=l*r+a*u;return[Math.atan2(c*i-s*o,a*r-l*u),O(s*i+c*o)]}var r=Math.cos(n),u=Math.sin(n),i=Math.cos(t),o=Math.sin(t);return e.invert=function(n,t){var e=Math.cos(t),a=Math.cos(n)*e,c=Math.sin(n)*e,l=Math.sin(t),s=l*i-c*o;return[Math.atan2(c*i+l*o,a*r+s*u),O(s*r-a*u)]},e}function Te(n,t){var e=Math.cos(n),r=Math.sin(n);return function(u,i,o,a){var c=o*t;null!=u?(u=qe(e,u),i=qe(e,i),(o>0?i>u:u>i)&&(u+=o*Wo)):(u=n+o*Wo,i=n-.5*c);for(var l,s=u;o>0?s>i:i>s;s-=c)a.point((l=Pt([e,-r*Math.cos(s),-r*Math.sin(s)]))[0],l[1])}}function qe(n,t){var e=Ct(t);e[0]-=n,Ft(e);var r=P(-e[1]);return((-e[2]<0?-r:r)+2*Math.PI-Go)%(2*Math.PI)}function ze(n,t,e){var r=mo.range(n,t-Go,e).concat(t);return function(n){return r.map(function(t){return[n,t]})}}function Ce(n,t,e){var r=mo.range(n,t-Go,e).concat(t);return function(n){return r.map(function(t){return[t,n]})}}function De(n){return n.source}function je(n){return n.target}function Le(n,t,e,r){var u=Math.cos(t),i=Math.sin(t),o=Math.cos(r),a=Math.sin(r),c=u*Math.cos(n),l=u*Math.sin(n),s=o*Math.cos(e),f=o*Math.sin(e),h=2*Math.asin(Math.sqrt(U(r-t)+u*o*U(e-n))),g=1/Math.sin(h),p=h?function(n){var t=Math.sin(n*=h)*g,e=Math.sin(h-n)*g,r=e*c+t*s,u=e*l+t*f,o=e*i+t*a;return[Math.atan2(u,r)*na,Math.atan2(o,Math.sqrt(r*r+u*u))*na]}:function(){return[n*na,t*na]};return p.distance=h,p}function He(){function n(n,u){var i=Math.sin(u*=Qo),o=Math.cos(u),a=Math.abs((n*=Qo)-t),c=Math.cos(a);oc+=Math.atan2(Math.sqrt((a=o*Math.sin(a))*a+(a=r*i-e*o*c)*a),e*i+r*o*c),t=n,e=i,r=o}var t,e,r;ac.point=function(u,i){t=u*Qo,e=Math.sin(i*=Qo),r=Math.cos(i),ac.point=n},ac.lineEnd=function(){ac.point=ac.lineEnd=c}}function Fe(n,t){function e(t,e){var r=Math.cos(t),u=Math.cos(e),i=n(r*u);return[i*u*Math.sin(t),i*Math.sin(e)]}return e.invert=function(n,e){var r=Math.sqrt(n*n+e*e),u=t(r),i=Math.sin(u),o=Math.cos(u);return[Math.atan2(n*i,r*o),Math.asin(r&&e*i/r)]},e}function Pe(n,t){function e(n,t){var e=Math.abs(Math.abs(t)-Jo)<Go?0:o/Math.pow(u(t),i);return[e*Math.sin(i*n),o-e*Math.cos(i*n)]}var r=Math.cos(n),u=function(n){return Math.tan(Bo/4+n/2)},i=n===t?Math.sin(n):Math.log(r/Math.cos(t))/Math.log(u(t)/u(n)),o=r*Math.pow(u(n),i)/i;return i?(e.invert=function(n,t){var e=o-t,r=F(i)*Math.sqrt(n*n+e*e);return[Math.atan2(n,e)/i,2*Math.atan(Math.pow(o/r,1/i))-Jo]},e):Re}function Oe(n,t){function e(n,t){var e=i-t;return[e*Math.sin(u*n),i-e*Math.cos(u*n)]}var r=Math.cos(n),u=n===t?Math.sin(n):(r-Math.cos(t))/(t-n),i=r/u+n;return Math.abs(u)<Go?we:(e.invert=function(n,t){var e=i-t;return[Math.atan2(n,e)/u,i-F(u)*Math.sqrt(n*n+e*e)]},e)}function Re(n,t){return[n,Math.log(Math.tan(Bo/4+t/2))]}function Ye(n){var t,e=xe(n),r=e.scale,u=e.translate,i=e.clipExtent;return e.scale=function(){var n=r.apply(e,arguments);return n===e?t?e.clipExtent(null):e:n},e.translate=function(){var n=u.apply(e,arguments);return n===e?t?e.clipExtent(null):e:n},e.clipExtent=function(n){var o=i.apply(e,arguments);if(o===e){if(t=null==n){var a=Bo*r(),c=u();i([[c[0]-a,c[1]-a],[c[0]+a,c[1]+a]])}}else t&&(o=null);return o},e.clipExtent(null)}function Ie(n,t){var e=Math.cos(t)*Math.sin(n);return[Math.log((1+e)/(1-e))/2,Math.atan2(Math.tan(t),Math.cos(n))]}function Ue(n){function t(t){function o(){l.push("M",i(n(s),a))}for(var c,l=[],s=[],f=-1,h=t.length,g=pt(e),p=pt(r);++f<h;)u.call(this,c=t[f],f)?s.push([+g.call(this,c,f),+p.call(this,c,f)]):s.length&&(o(),s=[]);return s.length&&o(),l.length?l.join(""):null}var e=Ze,r=Ve,u=Vt,i=Xe,o=i.key,a=.7;return t.x=function(n){return arguments.length?(e=n,t):e},t.y=function(n){return arguments.length?(r=n,t):r},t.defined=function(n){return arguments.length?(u=n,t):u},t.interpolate=function(n){return arguments.length?(o="function"==typeof n?i=n:(i=gc.get(n)||Xe).key,t):o},t.tension=function(n){return arguments.length?(a=n,t):a},t}function Ze(n){return n[0]}function Ve(n){return n[1]}function Xe(n){return n.join("L")}function $e(n){return Xe(n)+"Z"}function Be(n){for(var t=0,e=n.length,r=n[0],u=[r[0],",",r[1]];++t<e;)u.push("H",(r[0]+(r=n[t])[0])/2,"V",r[1]);return e>1&&u.push("H",r[0]),u.join("")}function We(n){for(var t=0,e=n.length,r=n[0],u=[r[0],",",r[1]];++t<e;)u.push("V",(r=n[t])[1],"H",r[0]);return u.join("")}function Je(n){for(var t=0,e=n.length,r=n[0],u=[r[0],",",r[1]];++t<e;)u.push("H",(r=n[t])[0],"V",r[1]);return u.join("")}function Ge(n,t){return n.length<4?Xe(n):n[1]+nr(n.slice(1,n.length-1),tr(n,t))}function Ke(n,t){return n.length<3?Xe(n):n[0]+nr((n.push(n[0]),n),tr([n[n.length-2]].concat(n,[n[1]]),t))}function Qe(n,t){return n.length<3?Xe(n):n[0]+nr(n,tr(n,t))}function nr(n,t){if(t.length<1||n.length!=t.length&&n.length!=t.length+2)return Xe(n);var e=n.length!=t.length,r="",u=n[0],i=n[1],o=t[0],a=o,c=1;if(e&&(r+="Q"+(i[0]-2*o[0]/3)+","+(i[1]-2*o[1]/3)+","+i[0]+","+i[1],u=n[1],c=2),t.length>1){a=t[1],i=n[c],c++,r+="C"+(u[0]+o[0])+","+(u[1]+o[1])+","+(i[0]-a[0])+","+(i[1]-a[1])+","+i[0]+","+i[1];for(var l=2;l<t.length;l++,c++)i=n[c],a=t[l],r+="S"+(i[0]-a[0])+","+(i[1]-a[1])+","+i[0]+","+i[1]}if(e){var s=n[c];r+="Q"+(i[0]+2*a[0]/3)+","+(i[1]+2*a[1]/3)+","+s[0]+","+s[1]}return r}function tr(n,t){for(var e,r=[],u=(1-t)/2,i=n[0],o=n[1],a=1,c=n.length;++a<c;)e=i,i=o,o=n[a],r.push([u*(o[0]-e[0]),u*(o[1]-e[1])]);return r}function er(n){if(n.length<3)return Xe(n);var t=1,e=n.length,r=n[0],u=r[0],i=r[1],o=[u,u,u,(r=n[1])[0]],a=[i,i,i,r[1]],c=[u,",",i,"L",or(vc,o),",",or(vc,a)];for(n.push(n[e-1]);++t<=e;)r=n[t],o.shift(),o.push(r[0]),a.shift(),a.push(r[1]),ar(c,o,a);return n.pop(),c.push("L",r),c.join("")}function rr(n){if(n.length<4)return Xe(n);for(var t,e=[],r=-1,u=n.length,i=[0],o=[0];++r<3;)t=n[r],i.push(t[0]),o.push(t[1]);for(e.push(or(vc,i)+","+or(vc,o)),--r;++r<u;)t=n[r],i.shift(),i.push(t[0]),o.shift(),o.push(t[1]),ar(e,i,o);return e.join("")}function ur(n){for(var t,e,r=-1,u=n.length,i=u+4,o=[],a=[];++r<4;)e=n[r%u],o.push(e[0]),a.push(e[1]);for(t=[or(vc,o),",",or(vc,a)],--r;++r<i;)e=n[r%u],o.shift(),o.push(e[0]),a.shift(),a.push(e[1]),ar(t,o,a);return t.join("")}function ir(n,t){var e=n.length-1;if(e)for(var r,u,i=n[0][0],o=n[0][1],a=n[e][0]-i,c=n[e][1]-o,l=-1;++l<=e;)r=n[l],u=l/e,r[0]=t*r[0]+(1-t)*(i+u*a),r[1]=t*r[1]+(1-t)*(o+u*c);return er(n)}function or(n,t){return n[0]*t[0]+n[1]*t[1]+n[2]*t[2]+n[3]*t[3]}function ar(n,t,e){n.push("C",or(pc,t),",",or(pc,e),",",or(dc,t),",",or(dc,e),",",or(vc,t),",",or(vc,e))}function cr(n,t){return(t[1]-n[1])/(t[0]-n[0])}function lr(n){for(var t=0,e=n.length-1,r=[],u=n[0],i=n[1],o=r[0]=cr(u,i);++t<e;)r[t]=(o+(o=cr(u=i,i=n[t+1])))/2;return r[t]=o,r
-}function sr(n){for(var t,e,r,u,i=[],o=lr(n),a=-1,c=n.length-1;++a<c;)t=cr(n[a],n[a+1]),Math.abs(t)<Go?o[a]=o[a+1]=0:(e=o[a]/t,r=o[a+1]/t,u=e*e+r*r,u>9&&(u=3*t/Math.sqrt(u),o[a]=u*e,o[a+1]=u*r));for(a=-1;++a<=c;)u=(n[Math.min(c,a+1)][0]-n[Math.max(0,a-1)][0])/(6*(1+o[a]*o[a])),i.push([u||0,o[a]*u||0]);return i}function fr(n){return n.length<3?Xe(n):n[0]+nr(n,sr(n))}function hr(n,t,e,r){var u,i,o,a,c,l,s;return u=r[n],i=u[0],o=u[1],u=r[t],a=u[0],c=u[1],u=r[e],l=u[0],s=u[1],(s-o)*(a-i)-(c-o)*(l-i)>0}function gr(n,t,e){return(e[0]-t[0])*(n[1]-t[1])<(e[1]-t[1])*(n[0]-t[0])}function pr(n,t,e,r){var u=n[0],i=e[0],o=t[0]-u,a=r[0]-i,c=n[1],l=e[1],s=t[1]-c,f=r[1]-l,h=(a*(c-l)-f*(u-i))/(f*o-a*s);return[u+h*o,c+h*s]}function dr(n){var t=n[0],e=n[n.length-1];return!(t[0]-e[0]||t[1]-e[1])}function vr(n,t){var e={list:n.map(function(n,t){return{index:t,x:n[0],y:n[1]}}).sort(function(n,t){return n.y<t.y?-1:n.y>t.y?1:n.x<t.x?-1:n.x>t.x?1:0}),bottomSite:null},r={list:[],leftEnd:null,rightEnd:null,init:function(){r.leftEnd=r.createHalfEdge(null,"l"),r.rightEnd=r.createHalfEdge(null,"l"),r.leftEnd.r=r.rightEnd,r.rightEnd.l=r.leftEnd,r.list.unshift(r.leftEnd,r.rightEnd)},createHalfEdge:function(n,t){return{edge:n,side:t,vertex:null,l:null,r:null}},insert:function(n,t){t.l=n,t.r=n.r,n.r.l=t,n.r=t},leftBound:function(n){var t=r.leftEnd;do t=t.r;while(t!=r.rightEnd&&u.rightOf(t,n));return t=t.l},del:function(n){n.l.r=n.r,n.r.l=n.l,n.edge=null},right:function(n){return n.r},left:function(n){return n.l},leftRegion:function(n){return null==n.edge?e.bottomSite:n.edge.region[n.side]},rightRegion:function(n){return null==n.edge?e.bottomSite:n.edge.region[yc[n.side]]}},u={bisect:function(n,t){var e={region:{l:n,r:t},ep:{l:null,r:null}},r=t.x-n.x,u=t.y-n.y,i=r>0?r:-r,o=u>0?u:-u;return e.c=n.x*r+n.y*u+.5*(r*r+u*u),i>o?(e.a=1,e.b=u/r,e.c/=r):(e.b=1,e.a=r/u,e.c/=u),e},intersect:function(n,t){var e=n.edge,r=t.edge;if(!e||!r||e.region.r==r.region.r)return null;var u=e.a*r.b-e.b*r.a;if(Math.abs(u)<1e-10)return null;var i,o,a=(e.c*r.b-r.c*e.b)/u,c=(r.c*e.a-e.c*r.a)/u,l=e.region.r,s=r.region.r;l.y<s.y||l.y==s.y&&l.x<s.x?(i=n,o=e):(i=t,o=r);var f=a>=o.region.r.x;return f&&"l"===i.side||!f&&"r"===i.side?null:{x:a,y:c}},rightOf:function(n,t){var e=n.edge,r=e.region.r,u=t.x>r.x;if(u&&"l"===n.side)return 1;if(!u&&"r"===n.side)return 0;if(1===e.a){var i=t.y-r.y,o=t.x-r.x,a=0,c=0;if(!u&&e.b<0||u&&e.b>=0?c=a=i>=e.b*o:(c=t.x+t.y*e.b>e.c,e.b<0&&(c=!c),c||(a=1)),!a){var l=r.x-e.region.l.x;c=e.b*(o*o-i*i)<l*i*(1+2*o/l+e.b*e.b),e.b<0&&(c=!c)}}else{var s=e.c-e.a*t.x,f=t.y-s,h=t.x-r.x,g=s-r.y;c=f*f>h*h+g*g}return"l"===n.side?c:!c},endPoint:function(n,e,r){n.ep[e]=r,n.ep[yc[e]]&&t(n)},distance:function(n,t){var e=n.x-t.x,r=n.y-t.y;return Math.sqrt(e*e+r*r)}},i={list:[],insert:function(n,t,e){n.vertex=t,n.ystar=t.y+e;for(var r=0,u=i.list,o=u.length;o>r;r++){var a=u[r];if(!(n.ystar>a.ystar||n.ystar==a.ystar&&t.x>a.vertex.x))break}u.splice(r,0,n)},del:function(n){for(var t=0,e=i.list,r=e.length;r>t&&e[t]!=n;++t);e.splice(t,1)},empty:function(){return 0===i.list.length},nextEvent:function(n){for(var t=0,e=i.list,r=e.length;r>t;++t)if(e[t]==n)return e[t+1];return null},min:function(){var n=i.list[0];return{x:n.vertex.x,y:n.ystar}},extractMin:function(){return i.list.shift()}};r.init(),e.bottomSite=e.list.shift();for(var o,a,c,l,s,f,h,g,p,d,v,m,y,M=e.list.shift();;)if(i.empty()||(o=i.min()),M&&(i.empty()||M.y<o.y||M.y==o.y&&M.x<o.x))a=r.leftBound(M),c=r.right(a),h=r.rightRegion(a),m=u.bisect(h,M),f=r.createHalfEdge(m,"l"),r.insert(a,f),d=u.intersect(a,f),d&&(i.del(a),i.insert(a,d,u.distance(d,M))),a=f,f=r.createHalfEdge(m,"r"),r.insert(a,f),d=u.intersect(f,c),d&&i.insert(f,d,u.distance(d,M)),M=e.list.shift();else{if(i.empty())break;a=i.extractMin(),l=r.left(a),c=r.right(a),s=r.right(c),h=r.leftRegion(a),g=r.rightRegion(c),v=a.vertex,u.endPoint(a.edge,a.side,v),u.endPoint(c.edge,c.side,v),r.del(a),i.del(c),r.del(c),y="l",h.y>g.y&&(p=h,h=g,g=p,y="r"),m=u.bisect(h,g),f=r.createHalfEdge(m,y),r.insert(l,f),u.endPoint(m,yc[y],v),d=u.intersect(l,f),d&&(i.del(l),i.insert(l,d,u.distance(d,h))),d=u.intersect(f,s),d&&i.insert(f,d,u.distance(d,h))}for(a=r.right(r.leftEnd);a!=r.rightEnd;a=r.right(a))t(a.edge)}function mr(n){return n.x}function yr(n){return n.y}function Mr(){return{leaf:!0,nodes:[],point:null,x:null,y:null}}function xr(n,t,e,r,u,i){if(!n(t,e,r,u,i)){var o=.5*(e+u),a=.5*(r+i),c=t.nodes;c[0]&&xr(n,c[0],e,r,o,a),c[1]&&xr(n,c[1],o,r,u,a),c[2]&&xr(n,c[2],e,a,o,i),c[3]&&xr(n,c[3],o,a,u,i)}}function br(n,t){n=mo.rgb(n),t=mo.rgb(t);var e=n.r,r=n.g,u=n.b,i=t.r-e,o=t.g-r,a=t.b-u;return function(n){return"#"+ct(Math.round(e+i*n))+ct(Math.round(r+o*n))+ct(Math.round(u+a*n))}}function _r(n,t){var e,r={},u={};for(e in n)e in t?r[e]=Er(n[e],t[e]):u[e]=n[e];for(e in t)e in n||(u[e]=t[e]);return function(n){for(e in r)u[e]=r[e](n);return u}}function wr(n,t){return t-=n=+n,function(e){return n+t*e}}function Sr(n,t){var e,r,u,i,o,a=0,c=0,l=[],s=[];for(n+="",t+="",Mc.lastIndex=0,r=0;e=Mc.exec(t);++r)e.index&&l.push(t.substring(a,c=e.index)),s.push({i:l.length,x:e[0]}),l.push(null),a=Mc.lastIndex;for(a<t.length&&l.push(t.substring(a)),r=0,i=s.length;(e=Mc.exec(n))&&i>r;++r)if(o=s[r],o.x==e[0]){if(o.i)if(null==l[o.i+1])for(l[o.i-1]+=o.x,l.splice(o.i,1),u=r+1;i>u;++u)s[u].i--;else for(l[o.i-1]+=o.x+l[o.i+1],l.splice(o.i,2),u=r+1;i>u;++u)s[u].i-=2;else if(null==l[o.i+1])l[o.i]=o.x;else for(l[o.i]=o.x+l[o.i+1],l.splice(o.i+1,1),u=r+1;i>u;++u)s[u].i--;s.splice(r,1),i--,r--}else o.x=wr(parseFloat(e[0]),parseFloat(o.x));for(;i>r;)o=s.pop(),null==l[o.i+1]?l[o.i]=o.x:(l[o.i]=o.x+l[o.i+1],l.splice(o.i+1,1)),i--;return 1===l.length?null==l[0]?(o=s[0].x,function(n){return o(n)+""}):function(){return t}:function(n){for(r=0;i>r;++r)l[(o=s[r]).i]=o.x(n);return l.join("")}}function Er(n,t){for(var e,r=mo.interpolators.length;--r>=0&&!(e=mo.interpolators[r](n,t)););return e}function kr(n,t){var e,r=[],u=[],i=n.length,o=t.length,a=Math.min(n.length,t.length);for(e=0;a>e;++e)r.push(Er(n[e],t[e]));for(;i>e;++e)u[e]=n[e];for(;o>e;++e)u[e]=t[e];return function(n){for(e=0;a>e;++e)u[e]=r[e](n);return u}}function Ar(n){return function(t){return 0>=t?0:t>=1?1:n(t)}}function Nr(n){return function(t){return 1-n(1-t)}}function Tr(n){return function(t){return.5*(.5>t?n(2*t):2-n(2-2*t))}}function qr(n){return n*n}function zr(n){return n*n*n}function Cr(n){if(0>=n)return 0;if(n>=1)return 1;var t=n*n,e=t*n;return 4*(.5>n?e:3*(n-t)+e-.75)}function Dr(n){return function(t){return Math.pow(t,n)}}function jr(n){return 1-Math.cos(n*Jo)}function Lr(n){return Math.pow(2,10*(n-1))}function Hr(n){return 1-Math.sqrt(1-n*n)}function Fr(n,t){var e;return arguments.length<2&&(t=.45),arguments.length?e=t/Wo*Math.asin(1/n):(n=1,e=t/4),function(r){return 1+n*Math.pow(2,-10*r)*Math.sin((r-e)*Wo/t)}}function Pr(n){return n||(n=1.70158),function(t){return t*t*((n+1)*t-n)}}function Or(n){return 1/2.75>n?7.5625*n*n:2/2.75>n?7.5625*(n-=1.5/2.75)*n+.75:2.5/2.75>n?7.5625*(n-=2.25/2.75)*n+.9375:7.5625*(n-=2.625/2.75)*n+.984375}function Rr(n,t){n=mo.hcl(n),t=mo.hcl(t);var e=n.h,r=n.c,u=n.l,i=t.h-e,o=t.c-r,a=t.l-u;return isNaN(o)&&(o=0,r=isNaN(r)?t.c:r),isNaN(i)?(i=0,e=isNaN(e)?t.h:e):i>180?i-=360:-180>i&&(i+=360),function(n){return J(e+i*n,r+o*n,u+a*n)+""}}function Yr(n,t){n=mo.hsl(n),t=mo.hsl(t);var e=n.h,r=n.s,u=n.l,i=t.h-e,o=t.s-r,a=t.l-u;return isNaN(o)&&(o=0,r=isNaN(r)?t.s:r),isNaN(i)?(i=0,e=isNaN(e)?t.h:e):i>180?i-=360:-180>i&&(i+=360),function(n){return $(e+i*n,r+o*n,u+a*n)+""}}function Ir(n,t){n=mo.lab(n),t=mo.lab(t);var e=n.l,r=n.a,u=n.b,i=t.l-e,o=t.a-r,a=t.b-u;return function(n){return Q(e+i*n,r+o*n,u+a*n)+""}}function Ur(n,t){return t-=n,function(e){return Math.round(n+t*e)}}function Zr(n){var t=[n.a,n.b],e=[n.c,n.d],r=Xr(t),u=Vr(t,e),i=Xr($r(e,t,-u))||0;t[0]*e[1]<e[0]*t[1]&&(t[0]*=-1,t[1]*=-1,r*=-1,u*=-1),this.rotate=(r?Math.atan2(t[1],t[0]):Math.atan2(-e[0],e[1]))*na,this.translate=[n.e,n.f],this.scale=[r,i],this.skew=i?Math.atan2(u,i)*na:0}function Vr(n,t){return n[0]*t[0]+n[1]*t[1]}function Xr(n){var t=Math.sqrt(Vr(n,n));return t&&(n[0]/=t,n[1]/=t),t}function $r(n,t,e){return n[0]+=e*t[0],n[1]+=e*t[1],n}function Br(n,t){var e,r=[],u=[],i=mo.transform(n),o=mo.transform(t),a=i.translate,c=o.translate,l=i.rotate,s=o.rotate,f=i.skew,h=o.skew,g=i.scale,p=o.scale;return a[0]!=c[0]||a[1]!=c[1]?(r.push("translate(",null,",",null,")"),u.push({i:1,x:wr(a[0],c[0])},{i:3,x:wr(a[1],c[1])})):c[0]||c[1]?r.push("translate("+c+")"):r.push(""),l!=s?(l-s>180?s+=360:s-l>180&&(l+=360),u.push({i:r.push(r.pop()+"rotate(",null,")")-2,x:wr(l,s)})):s&&r.push(r.pop()+"rotate("+s+")"),f!=h?u.push({i:r.push(r.pop()+"skewX(",null,")")-2,x:wr(f,h)}):h&&r.push(r.pop()+"skewX("+h+")"),g[0]!=p[0]||g[1]!=p[1]?(e=r.push(r.pop()+"scale(",null,",",null,")"),u.push({i:e-4,x:wr(g[0],p[0])},{i:e-2,x:wr(g[1],p[1])})):(1!=p[0]||1!=p[1])&&r.push(r.pop()+"scale("+p+")"),e=u.length,function(n){for(var t,i=-1;++i<e;)r[(t=u[i]).i]=t.x(n);return r.join("")}}function Wr(n,t){return t=t-(n=+n)?1/(t-n):0,function(e){return(e-n)*t}}function Jr(n,t){return t=t-(n=+n)?1/(t-n):0,function(e){return Math.max(0,Math.min(1,(e-n)*t))}}function Gr(n){for(var t=n.source,e=n.target,r=Qr(t,e),u=[t];t!==r;)t=t.parent,u.push(t);for(var i=u.length;e!==r;)u.splice(i,0,e),e=e.parent;return u}function Kr(n){for(var t=[],e=n.parent;null!=e;)t.push(n),n=e,e=e.parent;return t.push(n),t}function Qr(n,t){if(n===t)return n;for(var e=Kr(n),r=Kr(t),u=e.pop(),i=r.pop(),o=null;u===i;)o=u,u=e.pop(),i=r.pop();return o}function nu(n){n.fixed|=2}function tu(n){n.fixed&=-7}function eu(n){n.fixed|=4,n.px=n.x,n.py=n.y}function ru(n){n.fixed&=-5}function uu(n,t,e){var r=0,u=0;if(n.charge=0,!n.leaf)for(var i,o=n.nodes,a=o.length,c=-1;++c<a;)i=o[c],null!=i&&(uu(i,t,e),n.charge+=i.charge,r+=i.charge*i.cx,u+=i.charge*i.cy);if(n.point){n.leaf||(n.point.x+=Math.random()-.5,n.point.y+=Math.random()-.5);var l=t*e[n.point.index];n.charge+=n.pointCharge=l,r+=l*n.point.x,u+=l*n.point.y}n.cx=r/n.charge,n.cy=u/n.charge}function iu(n,t){return mo.rebind(n,t,"sort","children","value"),n.nodes=n,n.links=lu,n}function ou(n){return n.children}function au(n){return n.value}function cu(n,t){return t.value-n.value}function lu(n){return mo.merge(n.map(function(n){return(n.children||[]).map(function(t){return{source:n,target:t}})}))}function su(n){return n.x}function fu(n){return n.y}function hu(n,t,e){n.y0=t,n.y=e}function gu(n){return mo.range(n.length)}function pu(n){for(var t=-1,e=n[0].length,r=[];++t<e;)r[t]=0;return r}function du(n){for(var t,e=1,r=0,u=n[0][1],i=n.length;i>e;++e)(t=n[e][1])>u&&(r=e,u=t);return r}function vu(n){return n.reduce(mu,0)}function mu(n,t){return n+t[1]}function yu(n,t){return Mu(n,Math.ceil(Math.log(t.length)/Math.LN2+1))}function Mu(n,t){for(var e=-1,r=+n[0],u=(n[1]-r)/t,i=[];++e<=t;)i[e]=u*e+r;return i}function xu(n){return[mo.min(n),mo.max(n)]}function bu(n,t){return n.parent==t.parent?1:2}function _u(n){var t=n.children;return t&&t.length?t[0]:n._tree.thread}function wu(n){var t,e=n.children;return e&&(t=e.length)?e[t-1]:n._tree.thread}function Su(n,t){var e=n.children;if(e&&(u=e.length))for(var r,u,i=-1;++i<u;)t(r=Su(e[i],t),n)>0&&(n=r);return n}function Eu(n,t){return n.x-t.x}function ku(n,t){return t.x-n.x}function Au(n,t){return n.depth-t.depth}function Nu(n,t){function e(n,r){var u=n.children;if(u&&(o=u.length))for(var i,o,a=null,c=-1;++c<o;)i=u[c],e(i,a),a=i;t(n,r)}e(n,null)}function Tu(n){for(var t,e=0,r=0,u=n.children,i=u.length;--i>=0;)t=u[i]._tree,t.prelim+=e,t.mod+=e,e+=t.shift+(r+=t.change)}function qu(n,t,e){n=n._tree,t=t._tree;var r=e/(t.number-n.number);n.change+=r,t.change-=r,t.shift+=e,t.prelim+=e,t.mod+=e}function zu(n,t,e){return n._tree.ancestor.parent==t.parent?n._tree.ancestor:e}function Cu(n,t){return n.value-t.value}function Du(n,t){var e=n._pack_next;n._pack_next=t,t._pack_prev=n,t._pack_next=e,e._pack_prev=t}function ju(n,t){n._pack_next=t,t._pack_prev=n}function Lu(n,t){var e=t.x-n.x,r=t.y-n.y,u=n.r+t.r;return.999*u*u>e*e+r*r}function Hu(n){function t(n){s=Math.min(n.x-n.r,s),f=Math.max(n.x+n.r,f),h=Math.min(n.y-n.r,h),g=Math.max(n.y+n.r,g)}if((e=n.children)&&(l=e.length)){var e,r,u,i,o,a,c,l,s=1/0,f=-1/0,h=1/0,g=-1/0;if(e.forEach(Fu),r=e[0],r.x=-r.r,r.y=0,t(r),l>1&&(u=e[1],u.x=u.r,u.y=0,t(u),l>2))for(i=e[2],Ru(r,u,i),t(i),Du(r,i),r._pack_prev=i,Du(i,u),u=r._pack_next,o=3;l>o;o++){Ru(r,u,i=e[o]);var p=0,d=1,v=1;for(a=u._pack_next;a!==u;a=a._pack_next,d++)if(Lu(a,i)){p=1;break}if(1==p)for(c=r._pack_prev;c!==a._pack_prev&&!Lu(c,i);c=c._pack_prev,v++);p?(v>d||d==v&&u.r<r.r?ju(r,u=a):ju(r=c,u),o--):(Du(r,i),u=i,t(i))}var m=(s+f)/2,y=(h+g)/2,M=0;for(o=0;l>o;o++)i=e[o],i.x-=m,i.y-=y,M=Math.max(M,i.r+Math.sqrt(i.x*i.x+i.y*i.y));n.r=M,e.forEach(Pu)}}function Fu(n){n._pack_next=n._pack_prev=n}function Pu(n){delete n._pack_next,delete n._pack_prev}function Ou(n,t,e,r){var u=n.children;if(n.x=t+=r*n.x,n.y=e+=r*n.y,n.r*=r,u)for(var i=-1,o=u.length;++i<o;)Ou(u[i],t,e,r)}function Ru(n,t,e){var r=n.r+e.r,u=t.x-n.x,i=t.y-n.y;if(r&&(u||i)){var o=t.r+e.r,a=u*u+i*i;o*=o,r*=r;var c=.5+(r-o)/(2*a),l=Math.sqrt(Math.max(0,2*o*(r+a)-(r-=a)*r-o*o))/(2*a);e.x=n.x+c*u+l*i,e.y=n.y+c*i-l*u}else e.x=n.x+r,e.y=n.y}function Yu(n){return 1+mo.max(n,function(n){return n.y})}function Iu(n){return n.reduce(function(n,t){return n+t.x},0)/n.length}function Uu(n){var t=n.children;return t&&t.length?Uu(t[0]):n}function Zu(n){var t,e=n.children;return e&&(t=e.length)?Zu(e[t-1]):n}function Vu(n){return{x:n.x,y:n.y,dx:n.dx,dy:n.dy}}function Xu(n,t){var e=n.x+t[3],r=n.y+t[0],u=n.dx-t[1]-t[3],i=n.dy-t[0]-t[2];return 0>u&&(e+=u/2,u=0),0>i&&(r+=i/2,i=0),{x:e,y:r,dx:u,dy:i}}function $u(n){var t=n[0],e=n[n.length-1];return e>t?[t,e]:[e,t]}function Bu(n){return n.rangeExtent?n.rangeExtent():$u(n.range())}function Wu(n,t,e,r){var u=e(n[0],n[1]),i=r(t[0],t[1]);return function(n){return i(u(n))}}function Ju(n,t){var e,r=0,u=n.length-1,i=n[r],o=n[u];return i>o&&(e=r,r=u,u=e,e=i,i=o,o=e),n[r]=t.floor(i),n[u]=t.ceil(o),n}function Gu(n){return n?{floor:function(t){return Math.floor(t/n)*n},ceil:function(t){return Math.ceil(t/n)*n}}:Tc}function Ku(n,t,e,r){var u=[],i=[],o=0,a=Math.min(n.length,t.length)-1;for(n[a]<n[0]&&(n=n.slice().reverse(),t=t.slice().reverse());++o<=a;)u.push(e(n[o-1],n[o])),i.push(r(t[o-1],t[o]));return function(t){var e=mo.bisect(n,t,1,a)-1;return i[e](u[e](t))}}function Qu(n,t,e,r){function u(){var u=Math.min(n.length,t.length)>2?Ku:Wu,c=r?Jr:Wr;return o=u(n,t,c,e),a=u(t,n,c,Er),i}function i(n){return o(n)}var o,a;return i.invert=function(n){return a(n)},i.domain=function(t){return arguments.length?(n=t.map(Number),u()):n},i.range=function(n){return arguments.length?(t=n,u()):t},i.rangeRound=function(n){return i.range(n).interpolate(Ur)},i.clamp=function(n){return arguments.length?(r=n,u()):r},i.interpolate=function(n){return arguments.length?(e=n,u()):e},i.ticks=function(t){return ri(n,t)},i.tickFormat=function(t,e){return ui(n,t,e)},i.nice=function(t){return ti(n,t),u()},i.copy=function(){return Qu(n,t,e,r)},u()}function ni(n,t){return mo.rebind(n,t,"range","rangeRound","interpolate","clamp")}function ti(n,t){return Ju(n,Gu(ei(n,t)[2]))}function ei(n,t){null==t&&(t=10);var e=$u(n),r=e[1]-e[0],u=Math.pow(10,Math.floor(Math.log(r/t)/Math.LN10)),i=t/r*u;return.15>=i?u*=10:.35>=i?u*=5:.75>=i&&(u*=2),e[0]=Math.ceil(e[0]/u)*u,e[1]=Math.floor(e[1]/u)*u+.5*u,e[2]=u,e}function ri(n,t){return mo.range.apply(mo,ei(n,t))}function ui(n,t,e){var r=-Math.floor(Math.log(ei(n,t)[2])/Math.LN10+.01);return mo.format(e?e.replace(Aa,function(n,t,e,u,i,o,a,c,l,s){return[t,e,u,i,o,a,c,l||"."+(r-2*("%"===s)),s].join("")}):",."+r+"f")}function ii(n,t,e,r){function u(n){return(e?Math.log(0>n?0:n):-Math.log(n>0?0:-n))/Math.log(t)}function i(n){return e?Math.pow(t,n):-Math.pow(t,-n)}function o(t){return n(u(t))}return o.invert=function(t){return i(n.invert(t))},o.domain=function(t){return arguments.length?(e=t[0]>=0,n.domain((r=t.map(Number)).map(u)),o):r},o.base=function(e){return arguments.length?(t=+e,n.domain(r.map(u)),o):t},o.nice=function(){var t=Ju(r.map(u),e?Math:zc);return n.domain(t),r=t.map(i),o},o.ticks=function(){var n=$u(r),o=[],a=n[0],c=n[1],l=Math.floor(u(a)),s=Math.ceil(u(c)),f=t%1?2:t;if(isFinite(s-l)){if(e){for(;s>l;l++)for(var h=1;f>h;h++)o.push(i(l)*h);o.push(i(l))}else for(o.push(i(l));l++<s;)for(var h=f-1;h>0;h--)o.push(i(l)*h);for(l=0;o[l]<a;l++);for(s=o.length;o[s-1]>c;s--);o=o.slice(l,s)}return o},o.tickFormat=function(n,t){if(!arguments.length)return qc;arguments.length<2?t=qc:"function"!=typeof t&&(t=mo.format(t));var r,a=Math.max(.1,n/o.ticks().length),c=e?(r=1e-12,Math.ceil):(r=-1e-12,Math.floor);return function(n){return n/i(c(u(n)+r))<=a?t(n):""}},o.copy=function(){return ii(n.copy(),t,e,r)},ni(o,n)}function oi(n,t,e){function r(t){return n(u(t))}var u=ai(t),i=ai(1/t);return r.invert=function(t){return i(n.invert(t))},r.domain=function(t){return arguments.length?(n.domain((e=t.map(Number)).map(u)),r):e},r.ticks=function(n){return ri(e,n)},r.tickFormat=function(n,t){return ui(e,n,t)},r.nice=function(n){return r.domain(ti(e,n))},r.exponent=function(o){return arguments.length?(u=ai(t=o),i=ai(1/t),n.domain(e.map(u)),r):t},r.copy=function(){return oi(n.copy(),t,e)},ni(r,n)}function ai(n){return function(t){return 0>t?-Math.pow(-t,n):Math.pow(t,n)}}function ci(n,t){function e(e){return o[((i.get(e)||"range"===t.t&&i.set(e,n.push(e)))-1)%o.length]}function r(t,e){return mo.range(n.length).map(function(n){return t+e*n})}var i,o,a;return e.domain=function(r){if(!arguments.length)return n;n=[],i=new u;for(var o,a=-1,c=r.length;++a<c;)i.has(o=r[a])||i.set(o,n.push(o));return e[t.t].apply(e,t.a)},e.range=function(n){return arguments.length?(o=n,a=0,t={t:"range",a:arguments},e):o},e.rangePoints=function(u,i){arguments.length<2&&(i=0);var c=u[0],l=u[1],s=(l-c)/(Math.max(1,n.length-1)+i);return o=r(n.length<2?(c+l)/2:c+s*i/2,s),a=0,t={t:"rangePoints",a:arguments},e},e.rangeBands=function(u,i,c){arguments.length<2&&(i=0),arguments.length<3&&(c=i);var l=u[1]<u[0],s=u[l-0],f=u[1-l],h=(f-s)/(n.length-i+2*c);return o=r(s+h*c,h),l&&o.reverse(),a=h*(1-i),t={t:"rangeBands",a:arguments},e},e.rangeRoundBands=function(u,i,c){arguments.length<2&&(i=0),arguments.length<3&&(c=i);var l=u[1]<u[0],s=u[l-0],f=u[1-l],h=Math.floor((f-s)/(n.length-i+2*c)),g=f-s-(n.length-i)*h;return o=r(s+Math.round(g/2),h),l&&o.reverse(),a=Math.round(h*(1-i)),t={t:"rangeRoundBands",a:arguments},e},e.rangeBand=function(){return a},e.rangeExtent=function(){return $u(t.a[0])},e.copy=function(){return ci(n,t)},e.domain(n)}function li(n,t){function e(){var e=0,i=t.length;for(u=[];++e<i;)u[e-1]=mo.quantile(n,e/i);return r}function r(n){return isNaN(n=+n)?void 0:t[mo.bisect(u,n)]}var u;return r.domain=function(t){return arguments.length?(n=t.filter(function(n){return!isNaN(n)}).sort(mo.ascending),e()):n},r.range=function(n){return arguments.length?(t=n,e()):t},r.quantiles=function(){return u},r.invertExtent=function(e){return e=t.indexOf(e),0>e?[0/0,0/0]:[e>0?u[e-1]:n[0],e<u.length?u[e]:n[n.length-1]]},r.copy=function(){return li(n,t)},e()}function si(n,t,e){function r(t){return e[Math.max(0,Math.min(o,Math.floor(i*(t-n))))]}function u(){return i=e.length/(t-n),o=e.length-1,r}var i,o;return r.domain=function(e){return arguments.length?(n=+e[0],t=+e[e.length-1],u()):[n,t]},r.range=function(n){return arguments.length?(e=n,u()):e},r.invertExtent=function(t){return t=e.indexOf(t),t=0>t?0/0:t/i+n,[t,t+1/i]},r.copy=function(){return si(n,t,e)},u()}function fi(n,t){function e(e){return e>=e?t[mo.bisect(n,e)]:void 0}return e.domain=function(t){return arguments.length?(n=t,e):n},e.range=function(n){return arguments.length?(t=n,e):t},e.invertExtent=function(e){return e=t.indexOf(e),[n[e-1],n[e]]},e.copy=function(){return fi(n,t)},e}function hi(n){function t(n){return+n}return t.invert=t,t.domain=t.range=function(e){return arguments.length?(n=e.map(t),t):n},t.ticks=function(t){return ri(n,t)},t.tickFormat=function(t,e){return ui(n,t,e)},t.copy=function(){return hi(n)},t}function gi(n){return n.innerRadius}function pi(n){return n.outerRadius}function di(n){return n.startAngle}function vi(n){return n.endAngle}function mi(n){for(var t,e,r,u=-1,i=n.length;++u<i;)t=n[u],e=t[0],r=t[1]+Hc,t[0]=e*Math.cos(r),t[1]=e*Math.sin(r);return n}function yi(n){function t(t){function c(){d.push("M",a(n(m),f),s,l(n(v.reverse()),f),"Z")}for(var h,g,p,d=[],v=[],m=[],y=-1,M=t.length,x=pt(e),b=pt(u),_=e===r?function(){return g}:pt(r),w=u===i?function(){return p}:pt(i);++y<M;)o.call(this,h=t[y],y)?(v.push([g=+x.call(this,h,y),p=+b.call(this,h,y)]),m.push([+_.call(this,h,y),+w.call(this,h,y)])):v.length&&(c(),v=[],m=[]);return v.length&&c(),d.length?d.join(""):null}var e=Ze,r=Ze,u=0,i=Ve,o=Vt,a=Xe,c=a.key,l=a,s="L",f=.7;return t.x=function(n){return arguments.length?(e=r=n,t):r},t.x0=function(n){return arguments.length?(e=n,t):e},t.x1=function(n){return arguments.length?(r=n,t):r},t.y=function(n){return arguments.length?(u=i=n,t):i},t.y0=function(n){return arguments.length?(u=n,t):u},t.y1=function(n){return arguments.length?(i=n,t):i},t.defined=function(n){return arguments.length?(o=n,t):o},t.interpolate=function(n){return arguments.length?(c="function"==typeof n?a=n:(a=gc.get(n)||Xe).key,l=a.reverse||a,s=a.closed?"M":"L",t):c},t.tension=function(n){return arguments.length?(f=n,t):f},t}function Mi(n){return n.radius}function xi(n){return[n.x,n.y]}function bi(n){return function(){var t=n.apply(this,arguments),e=t[0],r=t[1]+Hc;return[e*Math.cos(r),e*Math.sin(r)]}}function _i(){return 64}function wi(){return"circle"}function Si(n){var t=Math.sqrt(n/Bo);return"M0,"+t+"A"+t+","+t+" 0 1,1 0,"+-t+"A"+t+","+t+" 0 1,1 0,"+t+"Z"}function Ei(n,t){return Lo(n,Uc),n.id=t,n}function ki(n,t,e,r){var u=n.id;return N(n,"function"==typeof e?function(n,i,o){n.__transition__[u].tween.set(t,r(e.call(n,n.__data__,i,o)))}:(e=r(e),function(n){n.__transition__[u].tween.set(t,e)}))}function Ai(n){return null==n&&(n=""),function(){this.textContent=n}}function Ni(n,t,e,r){var i=n.__transition__||(n.__transition__={active:0,count:0}),o=i[e];if(!o){var a=r.time;o=i[e]={tween:new u,time:a,ease:r.ease,delay:r.delay,duration:r.duration},++i.count,mo.timer(function(r){function u(r){return i.active>e?l():(i.active=e,o.event&&o.event.start.call(n,s,t),o.tween.forEach(function(e,r){(r=r.call(n,s,t))&&p.push(r)}),c(r||1)?1:(xt(c,h,a),void 0))}function c(r){if(i.active!==e)return l();for(var u=r/g,a=f(u),c=p.length;c>0;)p[--c].call(n,a);return u>=1?(o.event&&o.event.end.call(n,s,t),l()):void 0}function l(){return--i.count?delete i[e]:delete n.__transition__,1}var s=n.__data__,f=o.ease,h=o.delay,g=o.duration,p=[];return r>=h?u(r-h):(xt(u,h,a),void 0)},0,a)}}function Ti(n,t){n.attr("transform",function(n){return"translate("+t(n)+",0)"})}function qi(n,t){n.attr("transform",function(n){return"translate(0,"+t(n)+")"})}function zi(){this._=new Date(arguments.length>1?Date.UTC.apply(this,arguments):arguments[0])}function Ci(n,t,e){function r(t){var e=n(t),r=i(e,1);return r-t>t-e?e:r}function u(e){return t(e=n(new Jc(e-1)),1),e}function i(n,e){return t(n=new Jc(+n),e),n}function o(n,r,i){var o=u(n),a=[];if(i>1)for(;r>o;)e(o)%i||a.push(new Date(+o)),t(o,1);else for(;r>o;)a.push(new Date(+o)),t(o,1);return a}function a(n,t,e){try{Jc=zi;var r=new zi;return r._=n,o(r,t,e)}finally{Jc=Date}}n.floor=n,n.round=r,n.ceil=u,n.offset=i,n.range=o;var c=n.utc=Di(n);return c.floor=c,c.round=Di(r),c.ceil=Di(u),c.offset=Di(i),c.range=a,n}function Di(n){return function(t,e){try{Jc=zi;var r=new zi;return r._=t,n(r,e)._}finally{Jc=Date}}}function ji(n){function t(t){for(var r,u,i,o=[],a=-1,c=0;++a<e;)37===n.charCodeAt(a)&&(o.push(n.substring(c,a)),null!=(u=dl[r=n.charAt(++a)])&&(r=n.charAt(++a)),(i=vl[r])&&(r=i(t,null==u?"e"===r?" ":"0":u)),o.push(r),c=a+1);return o.push(n.substring(c,a)),o.join("")}var e=n.length;return t.parse=function(t){var e={y:1900,m:0,d:1,H:0,M:0,S:0,L:0,Z:null},r=Li(e,n,t,0);if(r!=t.length)return null;"p"in e&&(e.H=e.H%12+12*e.p);var u=null!=e.Z&&Jc!==zi,i=new(u?zi:Jc);return"j"in e?i.setFullYear(e.y,0,e.j):"w"in e&&("W"in e||"U"in e)?(i.setFullYear(e.y,0,1),i.setFullYear(e.y,0,"W"in e?(e.w+6)%7+7*e.W-(i.getDay()+5)%7:e.w+7*e.U-(i.getDay()+6)%7)):i.setFullYear(e.y,e.m,e.d),i.setHours(e.H+Math.floor(e.Z/100),e.M+e.Z%100,e.S,e.L),u?i._:i},t.toString=function(){return n},t}function Li(n,t,e,r){for(var u,i,o,a=0,c=t.length,l=e.length;c>a;){if(r>=l)return-1;if(u=t.charCodeAt(a++),37===u){if(o=t.charAt(a++),i=ml[o in dl?t.charAt(a++):o],!i||(r=i(n,e,r))<0)return-1}else if(u!=e.charCodeAt(r++))return-1}return r}function Hi(n){return new RegExp("^(?:"+n.map(mo.requote).join("|")+")","i")}function Fi(n){for(var t=new u,e=-1,r=n.length;++e<r;)t.set(n[e].toLowerCase(),e);return t}function Pi(n,t,e){var r=0>n?"-":"",u=(r?-n:n)+"",i=u.length;return r+(e>i?new Array(e-i+1).join(t)+u:u)}function Oi(n,t,e){cl.lastIndex=0;var r=cl.exec(t.substring(e));return r?(n.w=ll.get(r[0].toLowerCase()),e+r[0].length):-1}function Ri(n,t,e){ol.lastIndex=0;var r=ol.exec(t.substring(e));return r?(n.w=al.get(r[0].toLowerCase()),e+r[0].length):-1}function Yi(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+1));return r?(n.w=+r[0],e+r[0].length):-1}function Ii(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e));return r?(n.U=+r[0],e+r[0].length):-1}function Ui(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e));return r?(n.W=+r[0],e+r[0].length):-1}function Zi(n,t,e){hl.lastIndex=0;var r=hl.exec(t.substring(e));return r?(n.m=gl.get(r[0].toLowerCase()),e+r[0].length):-1}function Vi(n,t,e){sl.lastIndex=0;var r=sl.exec(t.substring(e));return r?(n.m=fl.get(r[0].toLowerCase()),e+r[0].length):-1}function Xi(n,t,e){return Li(n,vl.c.toString(),t,e)}function $i(n,t,e){return Li(n,vl.x.toString(),t,e)}function Bi(n,t,e){return Li(n,vl.X.toString(),t,e)}function Wi(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+4));return r?(n.y=+r[0],e+r[0].length):-1}function Ji(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.y=Ki(+r[0]),e+r[0].length):-1}function Gi(n,t,e){return/^[+-]\d{4}$/.test(t=t.substring(e,e+5))?(n.Z=+t,e+5):-1}function Ki(n){return n+(n>68?1900:2e3)}function Qi(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.m=r[0]-1,e+r[0].length):-1}function no(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.d=+r[0],e+r[0].length):-1}function to(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+3));return r?(n.j=+r[0],e+r[0].length):-1}function eo(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.H=+r[0],e+r[0].length):-1}function ro(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.M=+r[0],e+r[0].length):-1}function uo(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+2));return r?(n.S=+r[0],e+r[0].length):-1}function io(n,t,e){yl.lastIndex=0;var r=yl.exec(t.substring(e,e+3));return r?(n.L=+r[0],e+r[0].length):-1}function oo(n,t,e){var r=Ml.get(t.substring(e,e+=2).toLowerCase());return null==r?-1:(n.p=r,e)}function ao(n){var t=n.getTimezoneOffset(),e=t>0?"-":"+",r=~~(Math.abs(t)/60),u=Math.abs(t)%60;return e+Pi(r,"0",2)+Pi(u,"0",2)}function co(n,t,e){pl.lastIndex=0;var r=pl.exec(t.substring(e,e+1));return r?e+r[0].length:-1}function lo(n){function t(n){try{Jc=zi;var t=new Jc;return t._=n,e(t)}finally{Jc=Date}}var e=ji(n);return t.parse=function(n){try{Jc=zi;var t=e.parse(n);return t&&t._}finally{Jc=Date}},t.toString=e.toString,t}function so(n){return n.toISOString()}function fo(n,t,e){function r(t){return n(t)}function u(n,e){var r=n[1]-n[0],u=r/e,i=mo.bisect(bl,u);return i==bl.length?[t.year,ei(n.map(function(n){return n/31536e6}),e)[2]]:i?t[u/bl[i-1]<bl[i]/u?i-1:i]:[El,ei(n,e)[2]]}return r.invert=function(t){return ho(n.invert(t))},r.domain=function(t){return arguments.length?(n.domain(t),r):n.domain().map(ho)},r.nice=function(n,t){function e(e){return!isNaN(e)&&!n.range(e,ho(+e+1),t).length}var i=r.domain(),o=$u(i),a=null==n?u(o,10):"number"==typeof n&&u(o,n);return a&&(n=a[0],t=a[1]),r.domain(Ju(i,t>1?{floor:function(t){for(;e(t=n.floor(t));)t=ho(t-1);return t},ceil:function(t){for(;e(t=n.ceil(t));)t=ho(+t+1);return t}}:n))},r.ticks=function(n,t){var e=$u(r.domain()),i=null==n?u(e,10):"number"==typeof n?u(e,n):!n.range&&[{range:n},t];return i&&(n=i[0],t=i[1]),n.range(e[0],ho(+e[1]+1),1>t?1:t)},r.tickFormat=function(){return e},r.copy=function(){return fo(n.copy(),t,e)},ni(r,n)}function ho(n){return new Date(n)}function go(n){return function(t){for(var e=n.length-1,r=n[e];!r[1](t);)r=n[--e];return r[0](t)}}function po(n){return JSON.parse(n.responseText)}function vo(n){var t=xo.createRange();return t.selectNode(xo.body),t.createContextualFragment(n.responseText)}var mo={version:"3.3.6"};Date.now||(Date.now=function(){return+new Date});var yo=[].slice,Mo=function(n){return yo.call(n)},xo=document,bo=xo.documentElement,_o=window;try{Mo(bo.childNodes)[0].nodeType}catch(wo){Mo=function(n){for(var t=n.length,e=new Array(t);t--;)e[t]=n[t];return e}}try{xo.createElement("div").style.setProperty("opacity",0,"")}catch(So){var Eo=_o.Element.prototype,ko=Eo.setAttribute,Ao=Eo.setAttributeNS,No=_o.CSSStyleDeclaration.prototype,To=No.setProperty;Eo.setAttribute=function(n,t){ko.call(this,n,t+"")},Eo.setAttributeNS=function(n,t,e){Ao.call(this,n,t,e+"")},No.setProperty=function(n,t,e){To.call(this,n,t+"",e)}}mo.ascending=function(n,t){return t>n?-1:n>t?1:n>=t?0:0/0},mo.descending=function(n,t){return n>t?-1:t>n?1:t>=n?0:0/0},mo.min=function(n,t){var e,r,u=-1,i=n.length;if(1===arguments.length){for(;++u<i&&!(null!=(e=n[u])&&e>=e);)e=void 0;for(;++u<i;)null!=(r=n[u])&&e>r&&(e=r)}else{for(;++u<i&&!(null!=(e=t.call(n,n[u],u))&&e>=e);)e=void 0;for(;++u<i;)null!=(r=t.call(n,n[u],u))&&e>r&&(e=r)}return e},mo.max=function(n,t){var e,r,u=-1,i=n.length;if(1===arguments.length){for(;++u<i&&!(null!=(e=n[u])&&e>=e);)e=void 0;for(;++u<i;)null!=(r=n[u])&&r>e&&(e=r)}else{for(;++u<i&&!(null!=(e=t.call(n,n[u],u))&&e>=e);)e=void 0;for(;++u<i;)null!=(r=t.call(n,n[u],u))&&r>e&&(e=r)}return e},mo.extent=function(n,t){var e,r,u,i=-1,o=n.length;if(1===arguments.length){for(;++i<o&&!(null!=(e=u=n[i])&&e>=e);)e=u=void 0;for(;++i<o;)null!=(r=n[i])&&(e>r&&(e=r),r>u&&(u=r))}else{for(;++i<o&&!(null!=(e=u=t.call(n,n[i],i))&&e>=e);)e=void 0;for(;++i<o;)null!=(r=t.call(n,n[i],i))&&(e>r&&(e=r),r>u&&(u=r))}return[e,u]},mo.sum=function(n,t){var e,r=0,u=n.length,i=-1;if(1===arguments.length)for(;++i<u;)isNaN(e=+n[i])||(r+=e);else for(;++i<u;)isNaN(e=+t.call(n,n[i],i))||(r+=e);return r},mo.mean=function(t,e){var r,u=t.length,i=0,o=-1,a=0;if(1===arguments.length)for(;++o<u;)n(r=t[o])&&(i+=(r-i)/++a);else for(;++o<u;)n(r=e.call(t,t[o],o))&&(i+=(r-i)/++a);return a?i:void 0},mo.quantile=function(n,t){var e=(n.length-1)*t+1,r=Math.floor(e),u=+n[r-1],i=e-r;return i?u+i*(n[r]-u):u},mo.median=function(t,e){return arguments.length>1&&(t=t.map(e)),t=t.filter(n),t.length?mo.quantile(t.sort(mo.ascending),.5):void 0},mo.bisector=function(n){return{left:function(t,e,r,u){for(arguments.length<3&&(r=0),arguments.length<4&&(u=t.length);u>r;){var i=r+u>>>1;n.call(t,t[i],i)<e?r=i+1:u=i}return r},right:function(t,e,r,u){for(arguments.length<3&&(r=0),arguments.length<4&&(u=t.length);u>r;){var i=r+u>>>1;e<n.call(t,t[i],i)?u=i:r=i+1}return r}}};var qo=mo.bisector(function(n){return n});mo.bisectLeft=qo.left,mo.bisect=mo.bisectRight=qo.right,mo.shuffle=function(n){for(var t,e,r=n.length;r;)e=0|Math.random()*r--,t=n[r],n[r]=n[e],n[e]=t;return n},mo.permute=function(n,t){for(var e=t.length,r=new Array(e);e--;)r[e]=n[t[e]];return r},mo.pairs=function(n){for(var t,e=0,r=n.length-1,u=n[0],i=new Array(0>r?0:r);r>e;)i[e]=[t=u,u=n[++e]];return i},mo.zip=function(){if(!(u=arguments.length))return[];for(var n=-1,e=mo.min(arguments,t),r=new Array(e);++n<e;)for(var u,i=-1,o=r[n]=new Array(u);++i<u;)o[i]=arguments[i][n];return r},mo.transpose=function(n){return mo.zip.apply(mo,n)},mo.keys=function(n){var t=[];for(var e in n)t.push(e);return t},mo.values=function(n){var t=[];for(var e in n)t.push(n[e]);return t},mo.entries=function(n){var t=[];
-for(var e in n)t.push({key:e,value:n[e]});return t},mo.merge=function(n){return Array.prototype.concat.apply([],n)},mo.range=function(n,t,r){if(arguments.length<3&&(r=1,arguments.length<2&&(t=n,n=0)),1/0===(t-n)/r)throw new Error("infinite range");var u,i=[],o=e(Math.abs(r)),a=-1;if(n*=o,t*=o,r*=o,0>r)for(;(u=n+r*++a)>t;)i.push(u/o);else for(;(u=n+r*++a)<t;)i.push(u/o);return i},mo.map=function(n){var t=new u;if(n instanceof u)n.forEach(function(n,e){t.set(n,e)});else for(var e in n)t.set(e,n[e]);return t},r(u,{has:function(n){return zo+n in this},get:function(n){return this[zo+n]},set:function(n,t){return this[zo+n]=t},remove:function(n){return n=zo+n,n in this&&delete this[n]},keys:function(){var n=[];return this.forEach(function(t){n.push(t)}),n},values:function(){var n=[];return this.forEach(function(t,e){n.push(e)}),n},entries:function(){var n=[];return this.forEach(function(t,e){n.push({key:t,value:e})}),n},forEach:function(n){for(var t in this)t.charCodeAt(0)===Co&&n.call(this,t.substring(1),this[t])}});var zo="\x00",Co=zo.charCodeAt(0);mo.nest=function(){function n(t,a,c){if(c>=o.length)return r?r.call(i,a):e?a.sort(e):a;for(var l,s,f,h,g=-1,p=a.length,d=o[c++],v=new u;++g<p;)(h=v.get(l=d(s=a[g])))?h.push(s):v.set(l,[s]);return t?(s=t(),f=function(e,r){s.set(e,n(t,r,c))}):(s={},f=function(e,r){s[e]=n(t,r,c)}),v.forEach(f),s}function t(n,e){if(e>=o.length)return n;var r=[],u=a[e++];return n.forEach(function(n,u){r.push({key:n,values:t(u,e)})}),u?r.sort(function(n,t){return u(n.key,t.key)}):r}var e,r,i={},o=[],a=[];return i.map=function(t,e){return n(e,t,0)},i.entries=function(e){return t(n(mo.map,e,0),0)},i.key=function(n){return o.push(n),i},i.sortKeys=function(n){return a[o.length-1]=n,i},i.sortValues=function(n){return e=n,i},i.rollup=function(n){return r=n,i},i},mo.set=function(n){var t=new i;if(n)for(var e=0,r=n.length;r>e;++e)t.add(n[e]);return t},r(i,{has:function(n){return zo+n in this},add:function(n){return this[zo+n]=!0,n},remove:function(n){return n=zo+n,n in this&&delete this[n]},values:function(){var n=[];return this.forEach(function(t){n.push(t)}),n},forEach:function(n){for(var t in this)t.charCodeAt(0)===Co&&n.call(this,t.substring(1))}}),mo.behavior={},mo.rebind=function(n,t){for(var e,r=1,u=arguments.length;++r<u;)n[e=arguments[r]]=o(n,t,t[e]);return n};var Do=["webkit","ms","moz","Moz","o","O"];mo.dispatch=function(){for(var n=new l,t=-1,e=arguments.length;++t<e;)n[arguments[t]]=s(n);return n},l.prototype.on=function(n,t){var e=n.indexOf("."),r="";if(e>=0&&(r=n.substring(e+1),n=n.substring(0,e)),n)return arguments.length<2?this[n].on(r):this[n].on(r,t);if(2===arguments.length){if(null==t)for(n in this)this.hasOwnProperty(n)&&this[n].on(r,null);return this}},mo.event=null,mo.requote=function(n){return n.replace(jo,"\\$&")};var jo=/[\\\^\$\*\+\?\|\[\]\(\)\.\{\}]/g,Lo={}.__proto__?function(n,t){n.__proto__=t}:function(n,t){for(var e in t)n[e]=t[e]},Ho=function(n,t){return t.querySelector(n)},Fo=function(n,t){return t.querySelectorAll(n)},Po=bo[a(bo,"matchesSelector")],Oo=function(n,t){return Po.call(n,t)};"function"==typeof Sizzle&&(Ho=function(n,t){return Sizzle(n,t)[0]||null},Fo=function(n,t){return Sizzle.uniqueSort(Sizzle(n,t))},Oo=Sizzle.matchesSelector),mo.selection=function(){return Uo};var Ro=mo.selection.prototype=[];Ro.select=function(n){var t,e,r,u,i=[];n=d(n);for(var o=-1,a=this.length;++o<a;){i.push(t=[]),t.parentNode=(r=this[o]).parentNode;for(var c=-1,l=r.length;++c<l;)(u=r[c])?(t.push(e=n.call(u,u.__data__,c,o)),e&&"__data__"in u&&(e.__data__=u.__data__)):t.push(null)}return p(i)},Ro.selectAll=function(n){var t,e,r=[];n=v(n);for(var u=-1,i=this.length;++u<i;)for(var o=this[u],a=-1,c=o.length;++a<c;)(e=o[a])&&(r.push(t=Mo(n.call(e,e.__data__,a,u))),t.parentNode=e);return p(r)};var Yo={svg:"http://www.w3.org/2000/svg",xhtml:"http://www.w3.org/1999/xhtml",xlink:"http://www.w3.org/1999/xlink",xml:"http://www.w3.org/XML/1998/namespace",xmlns:"http://www.w3.org/2000/xmlns/"};mo.ns={prefix:Yo,qualify:function(n){var t=n.indexOf(":"),e=n;return t>=0&&(e=n.substring(0,t),n=n.substring(t+1)),Yo.hasOwnProperty(e)?{space:Yo[e],local:n}:n}},Ro.attr=function(n,t){if(arguments.length<2){if("string"==typeof n){var e=this.node();return n=mo.ns.qualify(n),n.local?e.getAttributeNS(n.space,n.local):e.getAttribute(n)}for(t in n)this.each(m(t,n[t]));return this}return this.each(m(n,t))},Ro.classed=function(n,t){if(arguments.length<2){if("string"==typeof n){var e=this.node(),r=(n=n.trim().split(/^|\s+/g)).length,u=-1;if(t=e.classList){for(;++u<r;)if(!t.contains(n[u]))return!1}else for(t=e.getAttribute("class");++u<r;)if(!M(n[u]).test(t))return!1;return!0}for(t in n)this.each(x(t,n[t]));return this}return this.each(x(n,t))},Ro.style=function(n,t,e){var r=arguments.length;if(3>r){if("string"!=typeof n){2>r&&(t="");for(e in n)this.each(_(e,n[e],t));return this}if(2>r)return _o.getComputedStyle(this.node(),null).getPropertyValue(n);e=""}return this.each(_(n,t,e))},Ro.property=function(n,t){if(arguments.length<2){if("string"==typeof n)return this.node()[n];for(t in n)this.each(w(t,n[t]));return this}return this.each(w(n,t))},Ro.text=function(n){return arguments.length?this.each("function"==typeof n?function(){var t=n.apply(this,arguments);this.textContent=null==t?"":t}:null==n?function(){this.textContent=""}:function(){this.textContent=n}):this.node().textContent},Ro.html=function(n){return arguments.length?this.each("function"==typeof n?function(){var t=n.apply(this,arguments);this.innerHTML=null==t?"":t}:null==n?function(){this.innerHTML=""}:function(){this.innerHTML=n}):this.node().innerHTML},Ro.append=function(n){return n=S(n),this.select(function(){return this.appendChild(n.apply(this,arguments))})},Ro.insert=function(n,t){return n=S(n),t=d(t),this.select(function(){return this.insertBefore(n.apply(this,arguments),t.apply(this,arguments))})},Ro.remove=function(){return this.each(function(){var n=this.parentNode;n&&n.removeChild(this)})},Ro.data=function(n,t){function e(n,e){var r,i,o,a=n.length,f=e.length,h=Math.min(a,f),g=new Array(f),p=new Array(f),d=new Array(a);if(t){var v,m=new u,y=new u,M=[];for(r=-1;++r<a;)v=t.call(i=n[r],i.__data__,r),m.has(v)?d[r]=i:m.set(v,i),M.push(v);for(r=-1;++r<f;)v=t.call(e,o=e[r],r),(i=m.get(v))?(g[r]=i,i.__data__=o):y.has(v)||(p[r]=E(o)),y.set(v,o),m.remove(v);for(r=-1;++r<a;)m.has(M[r])&&(d[r]=n[r])}else{for(r=-1;++r<h;)i=n[r],o=e[r],i?(i.__data__=o,g[r]=i):p[r]=E(o);for(;f>r;++r)p[r]=E(e[r]);for(;a>r;++r)d[r]=n[r]}p.update=g,p.parentNode=g.parentNode=d.parentNode=n.parentNode,c.push(p),l.push(g),s.push(d)}var r,i,o=-1,a=this.length;if(!arguments.length){for(n=new Array(a=(r=this[0]).length);++o<a;)(i=r[o])&&(n[o]=i.__data__);return n}var c=T([]),l=p([]),s=p([]);if("function"==typeof n)for(;++o<a;)e(r=this[o],n.call(r,r.parentNode.__data__,o));else for(;++o<a;)e(r=this[o],n);return l.enter=function(){return c},l.exit=function(){return s},l},Ro.datum=function(n){return arguments.length?this.property("__data__",n):this.property("__data__")},Ro.filter=function(n){var t,e,r,u=[];"function"!=typeof n&&(n=k(n));for(var i=0,o=this.length;o>i;i++){u.push(t=[]),t.parentNode=(e=this[i]).parentNode;for(var a=0,c=e.length;c>a;a++)(r=e[a])&&n.call(r,r.__data__,a)&&t.push(r)}return p(u)},Ro.order=function(){for(var n=-1,t=this.length;++n<t;)for(var e,r=this[n],u=r.length-1,i=r[u];--u>=0;)(e=r[u])&&(i&&i!==e.nextSibling&&i.parentNode.insertBefore(e,i),i=e);return this},Ro.sort=function(n){n=A.apply(this,arguments);for(var t=-1,e=this.length;++t<e;)this[t].sort(n);return this.order()},Ro.each=function(n){return N(this,function(t,e,r){n.call(t,t.__data__,e,r)})},Ro.call=function(n){var t=Mo(arguments);return n.apply(t[0]=this,t),this},Ro.empty=function(){return!this.node()},Ro.node=function(){for(var n=0,t=this.length;t>n;n++)for(var e=this[n],r=0,u=e.length;u>r;r++){var i=e[r];if(i)return i}return null},Ro.size=function(){var n=0;return this.each(function(){++n}),n};var Io=[];mo.selection.enter=T,mo.selection.enter.prototype=Io,Io.append=Ro.append,Io.empty=Ro.empty,Io.node=Ro.node,Io.call=Ro.call,Io.size=Ro.size,Io.select=function(n){for(var t,e,r,u,i,o=[],a=-1,c=this.length;++a<c;){r=(u=this[a]).update,o.push(t=[]),t.parentNode=u.parentNode;for(var l=-1,s=u.length;++l<s;)(i=u[l])?(t.push(r[l]=e=n.call(u.parentNode,i.__data__,l,a)),e.__data__=i.__data__):t.push(null)}return p(o)},Io.insert=function(n,t){return arguments.length<2&&(t=q(this)),Ro.insert.call(this,n,t)},Ro.transition=function(){for(var n,t,e=Oc||++Zc,r=[],u=Rc||{time:Date.now(),ease:Cr,delay:0,duration:250},i=-1,o=this.length;++i<o;){r.push(n=[]);for(var a=this[i],c=-1,l=a.length;++c<l;)(t=a[c])&&Ni(t,c,e,u),n.push(t)}return Ei(r,e)},Ro.interrupt=function(){return this.each(z)},mo.select=function(n){var t=["string"==typeof n?Ho(n,xo):n];return t.parentNode=bo,p([t])},mo.selectAll=function(n){var t=Mo("string"==typeof n?Fo(n,xo):n);return t.parentNode=bo,p([t])};var Uo=mo.select(bo);Ro.on=function(n,t,e){var r=arguments.length;if(3>r){if("string"!=typeof n){2>r&&(t=!1);for(e in n)this.each(C(e,n[e],t));return this}if(2>r)return(r=this.node()["__on"+n])&&r._;e=!1}return this.each(C(n,t,e))};var Zo=mo.map({mouseenter:"mouseover",mouseleave:"mouseout"});Zo.forEach(function(n){"on"+n in xo&&Zo.remove(n)});var Vo=a(bo.style,"userSelect"),Xo=0;mo.mouse=function(n){return H(n,h())};var $o=/WebKit/.test(_o.navigator.userAgent)?-1:0;mo.touches=function(n,t){return arguments.length<2&&(t=h().touches),t?Mo(t).map(function(t){var e=H(n,t);return e.identifier=t.identifier,e}):[]},mo.behavior.drag=function(){function n(){this.on("mousedown.drag",o).on("touchstart.drag",a)}function t(){return mo.event.changedTouches[0].identifier}function e(n,t){return mo.touches(n).filter(function(n){return n.identifier===t})[0]}function r(n,t,e,r){return function(){function o(){var n=t(s,g),e=n[0]-d[0],r=n[1]-d[1];v|=e|r,d=n,f({type:"drag",x:n[0]+c[0],y:n[1]+c[1],dx:e,dy:r})}function a(){m.on(e+"."+p,null).on(r+"."+p,null),y(v&&mo.event.target===h),f({type:"dragend"})}var c,l=this,s=l.parentNode,f=u.of(l,arguments),h=mo.event.target,g=n(),p=null==g?"drag":"drag-"+g,d=t(s,g),v=0,m=mo.select(_o).on(e+"."+p,o).on(r+"."+p,a),y=L();i?(c=i.apply(l,arguments),c=[c.x-d[0],c.y-d[1]]):c=[0,0],f({type:"dragstart"})}}var u=g(n,"drag","dragstart","dragend"),i=null,o=r(c,mo.mouse,"mousemove","mouseup"),a=r(t,e,"touchmove","touchend");return n.origin=function(t){return arguments.length?(i=t,n):i},mo.rebind(n,u,"on")};var Bo=Math.PI,Wo=2*Bo,Jo=Bo/2,Go=1e-6,Ko=Go*Go,Qo=Bo/180,na=180/Bo,ta=Math.SQRT2,ea=2,ra=4;mo.interpolateZoom=function(n,t){function e(n){var t=n*y;if(m){var e=Y(d),o=i/(ea*h)*(e*I(ta*t+d)-R(d));return[r+o*l,u+o*s,i*e/Y(ta*t+d)]}return[r+n*l,u+n*s,i*Math.exp(ta*t)]}var r=n[0],u=n[1],i=n[2],o=t[0],a=t[1],c=t[2],l=o-r,s=a-u,f=l*l+s*s,h=Math.sqrt(f),g=(c*c-i*i+ra*f)/(2*i*ea*h),p=(c*c-i*i-ra*f)/(2*c*ea*h),d=Math.log(Math.sqrt(g*g+1)-g),v=Math.log(Math.sqrt(p*p+1)-p),m=v-d,y=(m||Math.log(c/i))/ta;return e.duration=1e3*y,e},mo.behavior.zoom=function(){function n(n){n.on(A,l).on(oa+".zoom",h).on(N,p).on("dblclick.zoom",d).on(q,s)}function t(n){return[(n[0]-S.x)/S.k,(n[1]-S.y)/S.k]}function e(n){return[n[0]*S.k+S.x,n[1]*S.k+S.y]}function r(n){S.k=Math.max(k[0],Math.min(k[1],n))}function u(n,t){t=e(t),S.x+=n[0]-t[0],S.y+=n[1]-t[1]}function i(){b&&b.domain(x.range().map(function(n){return(n-S.x)/S.k}).map(x.invert)),w&&w.domain(_.range().map(function(n){return(n-S.y)/S.k}).map(_.invert))}function o(n){n({type:"zoomstart"})}function a(n){i(),n({type:"zoom",scale:S.k,translate:[S.x,S.y]})}function c(n){n({type:"zoomend"})}function l(){function n(){s=1,u(mo.mouse(r),h),a(i)}function e(){f.on(N,_o===r?p:null).on(T,null),g(s&&mo.event.target===l),c(i)}var r=this,i=C.of(r,arguments),l=mo.event.target,s=0,f=mo.select(_o).on(N,n).on(T,e),h=t(mo.mouse(r)),g=L();z.call(r),o(i)}function s(){function n(){var n=mo.touches(p);return g=S.k,n.forEach(function(n){n.identifier in v&&(v[n.identifier]=t(n))}),n}function e(){for(var t=mo.event.changedTouches,e=0,i=t.length;i>e;++e)v[t[e].identifier]=null;var o=n(),c=Date.now();if(1===o.length){if(500>c-M){var l=o[0],s=v[l.identifier];r(2*S.k),u(l,s),f(),a(d)}M=c}else if(o.length>1){var l=o[0],h=o[1],g=l[0]-h[0],p=l[1]-h[1];m=g*g+p*p}}function i(){for(var n,t,e,i,o=mo.touches(p),c=0,l=o.length;l>c;++c,i=null)if(e=o[c],i=v[e.identifier]){if(t)break;n=e,t=i}if(i){var s=(s=e[0]-n[0])*s+(s=e[1]-n[1])*s,f=m&&Math.sqrt(s/m);n=[(n[0]+e[0])/2,(n[1]+e[1])/2],t=[(t[0]+i[0])/2,(t[1]+i[1])/2],r(f*g)}M=null,u(n,t),a(d)}function h(){if(mo.event.touches.length){for(var t=mo.event.changedTouches,e=0,r=t.length;r>e;++e)delete v[t[e].identifier];for(var u in v)return void n()}_.on(x,null).on(b,null),w.on(A,l).on(q,s),E(),c(d)}var g,p=this,d=C.of(p,arguments),v={},m=0,y=mo.event.changedTouches[0].identifier,x="touchmove.zoom-"+y,b="touchend.zoom-"+y,_=mo.select(_o).on(x,i).on(b,h),w=mo.select(p).on(A,null).on(q,e),E=L();z.call(p),e(),o(d)}function h(){var n=C.of(this,arguments);y?clearTimeout(y):(z.call(this),o(n)),y=setTimeout(function(){y=null,c(n)},50),f();var e=m||mo.mouse(this);v||(v=t(e)),r(Math.pow(2,.002*ua())*S.k),u(e,v),a(n)}function p(){v=null}function d(){var n=C.of(this,arguments),e=mo.mouse(this),i=t(e),l=Math.log(S.k)/Math.LN2;o(n),r(Math.pow(2,mo.event.shiftKey?Math.ceil(l)-1:Math.floor(l)+1)),u(e,i),a(n),c(n)}var v,m,y,M,x,b,_,w,S={x:0,y:0,k:1},E=[960,500],k=ia,A="mousedown.zoom",N="mousemove.zoom",T="mouseup.zoom",q="touchstart.zoom",C=g(n,"zoomstart","zoom","zoomend");return n.event=function(n){n.each(function(){var n=C.of(this,arguments),t=S;Oc?mo.select(this).transition().each("start.zoom",function(){S=this.__chart__||{x:0,y:0,k:1},o(n)}).tween("zoom:zoom",function(){var e=E[0],r=E[1],u=e/2,i=r/2,o=mo.interpolateZoom([(u-S.x)/S.k,(i-S.y)/S.k,e/S.k],[(u-t.x)/t.k,(i-t.y)/t.k,e/t.k]);return function(t){var r=o(t),c=e/r[2];this.__chart__=S={x:u-r[0]*c,y:i-r[1]*c,k:c},a(n)}}).each("end.zoom",function(){c(n)}):(this.__chart__=S,o(n),a(n),c(n))})},n.translate=function(t){return arguments.length?(S={x:+t[0],y:+t[1],k:S.k},i(),n):[S.x,S.y]},n.scale=function(t){return arguments.length?(S={x:S.x,y:S.y,k:+t},i(),n):S.k},n.scaleExtent=function(t){return arguments.length?(k=null==t?ia:[+t[0],+t[1]],n):k},n.center=function(t){return arguments.length?(m=t&&[+t[0],+t[1]],n):m},n.size=function(t){return arguments.length?(E=t&&[+t[0],+t[1]],n):E},n.x=function(t){return arguments.length?(b=t,x=t.copy(),S={x:0,y:0,k:1},n):b},n.y=function(t){return arguments.length?(w=t,_=t.copy(),S={x:0,y:0,k:1},n):w},mo.rebind(n,C,"on")};var ua,ia=[0,1/0],oa="onwheel"in xo?(ua=function(){return-mo.event.deltaY*(mo.event.deltaMode?120:1)},"wheel"):"onmousewheel"in xo?(ua=function(){return mo.event.wheelDelta},"mousewheel"):(ua=function(){return-mo.event.detail},"MozMousePixelScroll");Z.prototype.toString=function(){return this.rgb()+""},mo.hsl=function(n,t,e){return 1===arguments.length?n instanceof X?V(n.h,n.s,n.l):lt(""+n,st,V):V(+n,+t,+e)};var aa=X.prototype=new Z;aa.brighter=function(n){return n=Math.pow(.7,arguments.length?n:1),V(this.h,this.s,this.l/n)},aa.darker=function(n){return n=Math.pow(.7,arguments.length?n:1),V(this.h,this.s,n*this.l)},aa.rgb=function(){return $(this.h,this.s,this.l)},mo.hcl=function(n,t,e){return 1===arguments.length?n instanceof W?B(n.h,n.c,n.l):n instanceof K?nt(n.l,n.a,n.b):nt((n=ft((n=mo.rgb(n)).r,n.g,n.b)).l,n.a,n.b):B(+n,+t,+e)};var ca=W.prototype=new Z;ca.brighter=function(n){return B(this.h,this.c,Math.min(100,this.l+la*(arguments.length?n:1)))},ca.darker=function(n){return B(this.h,this.c,Math.max(0,this.l-la*(arguments.length?n:1)))},ca.rgb=function(){return J(this.h,this.c,this.l).rgb()},mo.lab=function(n,t,e){return 1===arguments.length?n instanceof K?G(n.l,n.a,n.b):n instanceof W?J(n.l,n.c,n.h):ft((n=mo.rgb(n)).r,n.g,n.b):G(+n,+t,+e)};var la=18,sa=.95047,fa=1,ha=1.08883,ga=K.prototype=new Z;ga.brighter=function(n){return G(Math.min(100,this.l+la*(arguments.length?n:1)),this.a,this.b)},ga.darker=function(n){return G(Math.max(0,this.l-la*(arguments.length?n:1)),this.a,this.b)},ga.rgb=function(){return Q(this.l,this.a,this.b)},mo.rgb=function(n,t,e){return 1===arguments.length?n instanceof at?ot(n.r,n.g,n.b):lt(""+n,ot,$):ot(~~n,~~t,~~e)};var pa=at.prototype=new Z;pa.brighter=function(n){n=Math.pow(.7,arguments.length?n:1);var t=this.r,e=this.g,r=this.b,u=30;return t||e||r?(t&&u>t&&(t=u),e&&u>e&&(e=u),r&&u>r&&(r=u),ot(Math.min(255,~~(t/n)),Math.min(255,~~(e/n)),Math.min(255,~~(r/n)))):ot(u,u,u)},pa.darker=function(n){return n=Math.pow(.7,arguments.length?n:1),ot(~~(n*this.r),~~(n*this.g),~~(n*this.b))},pa.hsl=function(){return st(this.r,this.g,this.b)},pa.toString=function(){return"#"+ct(this.r)+ct(this.g)+ct(this.b)};var da=mo.map({aliceblue:15792383,antiquewhite:16444375,aqua:65535,aquamarine:8388564,azure:15794175,beige:16119260,bisque:16770244,black:0,blanchedalmond:16772045,blue:255,blueviolet:9055202,brown:10824234,burlywood:14596231,cadetblue:6266528,chartreuse:8388352,chocolate:13789470,coral:16744272,cornflowerblue:6591981,cornsilk:16775388,crimson:14423100,cyan:65535,darkblue:139,darkcyan:35723,darkgoldenrod:12092939,darkgray:11119017,darkgreen:25600,darkgrey:11119017,darkkhaki:12433259,darkmagenta:9109643,darkolivegreen:5597999,darkorange:16747520,darkorchid:10040012,darkred:9109504,darksalmon:15308410,darkseagreen:9419919,darkslateblue:4734347,darkslategray:3100495,darkslategrey:3100495,darkturquoise:52945,darkviolet:9699539,deeppink:16716947,deepskyblue:49151,dimgray:6908265,dimgrey:6908265,dodgerblue:2003199,firebrick:11674146,floralwhite:16775920,forestgreen:2263842,fuchsia:16711935,gainsboro:14474460,ghostwhite:16316671,gold:16766720,goldenrod:14329120,gray:8421504,green:32768,greenyellow:11403055,grey:8421504,honeydew:15794160,hotpink:16738740,indianred:13458524,indigo:4915330,ivory:16777200,khaki:15787660,lavender:15132410,lavenderblush:16773365,lawngreen:8190976,lemonchiffon:16775885,lightblue:11393254,lightcoral:15761536,lightcyan:14745599,lightgoldenrodyellow:16448210,lightgray:13882323,lightgreen:9498256,lightgrey:13882323,lightpink:16758465,lightsalmon:16752762,lightseagreen:2142890,lightskyblue:8900346,lightslategray:7833753,lightslategrey:7833753,lightsteelblue:11584734,lightyellow:16777184,lime:65280,limegreen:3329330,linen:16445670,magenta:16711935,maroon:8388608,mediumaquamarine:6737322,mediumblue:205,mediumorchid:12211667,mediumpurple:9662683,mediumseagreen:3978097,mediumslateblue:8087790,mediumspringgreen:64154,mediumturquoise:4772300,mediumvioletred:13047173,midnightblue:1644912,mintcream:16121850,mistyrose:16770273,moccasin:16770229,navajowhite:16768685,navy:128,oldlace:16643558,olive:8421376,olivedrab:7048739,orange:16753920,orangered:16729344,orchid:14315734,palegoldenrod:15657130,palegreen:10025880,paleturquoise:11529966,palevioletred:14381203,papayawhip:16773077,peachpuff:16767673,peru:13468991,pink:16761035,plum:14524637,powderblue:11591910,purple:8388736,red:16711680,rosybrown:12357519,royalblue:4286945,saddlebrown:9127187,salmon:16416882,sandybrown:16032864,seagreen:3050327,seashell:16774638,sienna:10506797,silver:12632256,skyblue:8900331,slateblue:6970061,slategray:7372944,slategrey:7372944,snow:16775930,springgreen:65407,steelblue:4620980,tan:13808780,teal:32896,thistle:14204888,tomato:16737095,turquoise:4251856,violet:15631086,wheat:16113331,white:16777215,whitesmoke:16119285,yellow:16776960,yellowgreen:10145074});da.forEach(function(n,t){da.set(n,ut(t))}),mo.functor=pt,mo.xhr=vt(dt),mo.dsv=function(n,t){function e(n,e,i){arguments.length<3&&(i=e,e=null);var o=mo.xhr(n,t,i);return o.row=function(n){return arguments.length?o.response(null==(e=n)?r:u(n)):e},o.row(e)}function r(n){return e.parse(n.responseText)}function u(n){return function(t){return e.parse(t.responseText,n)}}function o(t){return t.map(a).join(n)}function a(n){return c.test(n)?'"'+n.replace(/\"/g,'""')+'"':n}var c=new RegExp('["'+n+"\n]"),l=n.charCodeAt(0);return e.parse=function(n,t){var r;return e.parseRows(n,function(n,e){if(r)return r(n,e-1);var u=new Function("d","return {"+n.map(function(n,t){return JSON.stringify(n)+": d["+t+"]"}).join(",")+"}");r=t?function(n,e){return t(u(n),e)}:u})},e.parseRows=function(n,t){function e(){if(s>=c)return o;if(u)return u=!1,i;var t=s;if(34===n.charCodeAt(t)){for(var e=t;e++<c;)if(34===n.charCodeAt(e)){if(34!==n.charCodeAt(e+1))break;++e}s=e+2;var r=n.charCodeAt(e+1);return 13===r?(u=!0,10===n.charCodeAt(e+2)&&++s):10===r&&(u=!0),n.substring(t+1,e).replace(/""/g,'"')}for(;c>s;){var r=n.charCodeAt(s++),a=1;if(10===r)u=!0;else if(13===r)u=!0,10===n.charCodeAt(s)&&(++s,++a);else if(r!==l)continue;return n.substring(t,s-a)}return n.substring(t)}for(var r,u,i={},o={},a=[],c=n.length,s=0,f=0;(r=e())!==o;){for(var h=[];r!==i&&r!==o;)h.push(r),r=e();(!t||(h=t(h,f++)))&&a.push(h)}return a},e.format=function(t){if(Array.isArray(t[0]))return e.formatRows(t);var r=new i,u=[];return t.forEach(function(n){for(var t in n)r.has(t)||u.push(r.add(t))}),[u.map(a).join(n)].concat(t.map(function(t){return u.map(function(n){return a(t[n])}).join(n)})).join("\n")},e.formatRows=function(n){return n.map(o).join("\n")},e},mo.csv=mo.dsv(",","text/csv"),mo.tsv=mo.dsv("	","text/tab-separated-values");var va,ma,ya,Ma,xa,ba=_o[a(_o,"requestAnimationFrame")]||function(n){setTimeout(n,17)};mo.timer=function(n,t,e){var r=arguments.length;2>r&&(t=0),3>r&&(e=Date.now());var u=e+t,i={callback:n,time:u,next:null};ma?ma.next=i:va=i,ma=i,ya||(Ma=clearTimeout(Ma),ya=1,ba(Mt))},mo.timer.flush=function(){bt(),_t()};var _a=".",wa=",",Sa=[3,3],Ea="$",ka=["y","z","a","f","p","n","\xb5","m","","k","M","G","T","P","E","Z","Y"].map(wt);mo.formatPrefix=function(n,t){var e=0;return n&&(0>n&&(n*=-1),t&&(n=mo.round(n,St(n,t))),e=1+Math.floor(1e-12+Math.log(n)/Math.LN10),e=Math.max(-24,Math.min(24,3*Math.floor((0>=e?e+1:e-1)/3)))),ka[8+e/3]},mo.round=function(n,t){return t?Math.round(n*(t=Math.pow(10,t)))/t:Math.round(n)},mo.format=function(n){var t=Aa.exec(n),e=t[1]||" ",r=t[2]||">",u=t[3]||"",i=t[4]||"",o=t[5],a=+t[6],c=t[7],l=t[8],s=t[9],f=1,h="",g=!1;switch(l&&(l=+l.substring(1)),(o||"0"===e&&"="===r)&&(o=e="0",r="=",c&&(a-=Math.floor((a-1)/4))),s){case"n":c=!0,s="g";break;case"%":f=100,h="%",s="f";break;case"p":f=100,h="%",s="r";break;case"b":case"o":case"x":case"X":"#"===i&&(i="0"+s.toLowerCase());case"c":case"d":g=!0,l=0;break;case"s":f=-1,s="r"}"#"===i?i="":"$"===i&&(i=Ea),"r"!=s||l||(s="g"),null!=l&&("g"==s?l=Math.max(1,Math.min(21,l)):("e"==s||"f"==s)&&(l=Math.max(0,Math.min(20,l)))),s=Na.get(s)||Et;var p=o&&c;return function(n){if(g&&n%1)return"";var t=0>n||0===n&&0>1/n?(n=-n,"-"):u;if(0>f){var d=mo.formatPrefix(n,l);n=d.scale(n),h=d.symbol}else n*=f;n=s(n,l);var v=n.lastIndexOf("."),m=0>v?n:n.substring(0,v),y=0>v?"":_a+n.substring(v+1);!o&&c&&(m=Ta(m));var M=i.length+m.length+y.length+(p?0:t.length),x=a>M?new Array(M=a-M+1).join(e):"";return p&&(m=Ta(x+m)),t+=i,n=m+y,("<"===r?t+n+x:">"===r?x+t+n:"^"===r?x.substring(0,M>>=1)+t+n+x.substring(M):t+(p?n:x+n))+h}};var Aa=/(?:([^{])?([<>=^]))?([+\- ])?([$#])?(0)?(\d+)?(,)?(\.-?\d+)?([a-z%])?/i,Na=mo.map({b:function(n){return n.toString(2)},c:function(n){return String.fromCharCode(n)},o:function(n){return n.toString(8)},x:function(n){return n.toString(16)},X:function(n){return n.toString(16).toUpperCase()},g:function(n,t){return n.toPrecision(t)},e:function(n,t){return n.toExponential(t)},f:function(n,t){return n.toFixed(t)},r:function(n,t){return(n=mo.round(n,St(n,t))).toFixed(Math.max(0,Math.min(20,St(n*(1+1e-15),t))))}}),Ta=dt;if(Sa){var qa=Sa.length;Ta=function(n){for(var t=n.length,e=[],r=0,u=Sa[0];t>0&&u>0;)e.push(n.substring(t-=u,t+u)),u=Sa[r=(r+1)%qa];return e.reverse().join(wa)}}mo.geo={},kt.prototype={s:0,t:0,add:function(n){At(n,this.t,za),At(za.s,this.s,this),this.s?this.t+=za.t:this.s=za.t},reset:function(){this.s=this.t=0},valueOf:function(){return this.s}};var za=new kt;mo.geo.stream=function(n,t){n&&Ca.hasOwnProperty(n.type)?Ca[n.type](n,t):Nt(n,t)};var Ca={Feature:function(n,t){Nt(n.geometry,t)},FeatureCollection:function(n,t){for(var e=n.features,r=-1,u=e.length;++r<u;)Nt(e[r].geometry,t)}},Da={Sphere:function(n,t){t.sphere()},Point:function(n,t){n=n.coordinates,t.point(n[0],n[1],n[2])},MultiPoint:function(n,t){for(var e=n.coordinates,r=-1,u=e.length;++r<u;)n=e[r],t.point(n[0],n[1],n[2])},LineString:function(n,t){Tt(n.coordinates,t,0)},MultiLineString:function(n,t){for(var e=n.coordinates,r=-1,u=e.length;++r<u;)Tt(e[r],t,0)},Polygon:function(n,t){qt(n.coordinates,t)},MultiPolygon:function(n,t){for(var e=n.coordinates,r=-1,u=e.length;++r<u;)qt(e[r],t)},GeometryCollection:function(n,t){for(var e=n.geometries,r=-1,u=e.length;++r<u;)Nt(e[r],t)}};mo.geo.area=function(n){return ja=0,mo.geo.stream(n,Ha),ja};var ja,La=new kt,Ha={sphere:function(){ja+=4*Bo},point:c,lineStart:c,lineEnd:c,polygonStart:function(){La.reset(),Ha.lineStart=zt},polygonEnd:function(){var n=2*La;ja+=0>n?4*Bo+n:n,Ha.lineStart=Ha.lineEnd=Ha.point=c}};mo.geo.bounds=function(){function n(n,t){M.push(x=[s=n,h=n]),f>t&&(f=t),t>g&&(g=t)}function t(t,e){var r=Ct([t*Qo,e*Qo]);if(m){var u=jt(m,r),i=[u[1],-u[0],0],o=jt(i,u);Ft(o),o=Pt(o);var c=t-p,l=c>0?1:-1,d=o[0]*na*l,v=Math.abs(c)>180;if(v^(d>l*p&&l*t>d)){var y=o[1]*na;y>g&&(g=y)}else if(d=(d+360)%360-180,v^(d>l*p&&l*t>d)){var y=-o[1]*na;f>y&&(f=y)}else f>e&&(f=e),e>g&&(g=e);v?p>t?a(s,t)>a(s,h)&&(h=t):a(t,h)>a(s,h)&&(s=t):h>=s?(s>t&&(s=t),t>h&&(h=t)):t>p?a(s,t)>a(s,h)&&(h=t):a(t,h)>a(s,h)&&(s=t)}else n(t,e);m=r,p=t}function e(){b.point=t}function r(){x[0]=s,x[1]=h,b.point=n,m=null}function u(n,e){if(m){var r=n-p;y+=Math.abs(r)>180?r+(r>0?360:-360):r}else d=n,v=e;Ha.point(n,e),t(n,e)}function i(){Ha.lineStart()}function o(){u(d,v),Ha.lineEnd(),Math.abs(y)>Go&&(s=-(h=180)),x[0]=s,x[1]=h,m=null}function a(n,t){return(t-=n)<0?t+360:t}function c(n,t){return n[0]-t[0]}function l(n,t){return t[0]<=t[1]?t[0]<=n&&n<=t[1]:n<t[0]||t[1]<n}var s,f,h,g,p,d,v,m,y,M,x,b={point:n,lineStart:e,lineEnd:r,polygonStart:function(){b.point=u,b.lineStart=i,b.lineEnd=o,y=0,Ha.polygonStart()},polygonEnd:function(){Ha.polygonEnd(),b.point=n,b.lineStart=e,b.lineEnd=r,0>La?(s=-(h=180),f=-(g=90)):y>Go?g=90:-Go>y&&(f=-90),x[0]=s,x[1]=h}};return function(n){g=h=-(s=f=1/0),M=[],mo.geo.stream(n,b);var t=M.length;if(t){M.sort(c);for(var e,r=1,u=M[0],i=[u];t>r;++r)e=M[r],l(e[0],u)||l(e[1],u)?(a(u[0],e[1])>a(u[0],u[1])&&(u[1]=e[1]),a(e[0],u[1])>a(u[0],u[1])&&(u[0]=e[0])):i.push(u=e);for(var o,e,p=-1/0,t=i.length-1,r=0,u=i[t];t>=r;u=e,++r)e=i[r],(o=a(u[1],e[0]))>p&&(p=o,s=e[0],h=u[1])}return M=x=null,1/0===s||1/0===f?[[0/0,0/0],[0/0,0/0]]:[[s,f],[h,g]]}}(),mo.geo.centroid=function(n){Fa=Pa=Oa=Ra=Ya=Ia=Ua=Za=Va=Xa=$a=0,mo.geo.stream(n,Ba);var t=Va,e=Xa,r=$a,u=t*t+e*e+r*r;return Ko>u&&(t=Ia,e=Ua,r=Za,Go>Pa&&(t=Oa,e=Ra,r=Ya),u=t*t+e*e+r*r,Ko>u)?[0/0,0/0]:[Math.atan2(e,t)*na,O(r/Math.sqrt(u))*na]};var Fa,Pa,Oa,Ra,Ya,Ia,Ua,Za,Va,Xa,$a,Ba={sphere:c,point:Rt,lineStart:It,lineEnd:Ut,polygonStart:function(){Ba.lineStart=Zt},polygonEnd:function(){Ba.lineStart=It}},Wa=Bt(Vt,Qt,te,[-Bo,-Bo/2]),Ja=1e9;mo.geo.clipExtent=function(){var n,t,e,r,u,i,o={stream:function(n){return u&&(u.valid=!1),u=i(n),u.valid=!0,u},extent:function(a){return arguments.length?(i=re(n=+a[0][0],t=+a[0][1],e=+a[1][0],r=+a[1][1]),u&&(u.valid=!1,u=null),o):[[n,t],[e,r]]}};return o.extent([[0,0],[960,500]])},(mo.geo.conicEqualArea=function(){return oe(ae)}).raw=ae,mo.geo.albers=function(){return mo.geo.conicEqualArea().rotate([96,0]).center([-.6,38.7]).parallels([29.5,45.5]).scale(1070)},mo.geo.albersUsa=function(){function n(n){var i=n[0],o=n[1];return t=null,e(i,o),t||(r(i,o),t)||u(i,o),t}var t,e,r,u,i=mo.geo.albers(),o=mo.geo.conicEqualArea().rotate([154,0]).center([-2,58.5]).parallels([55,65]),a=mo.geo.conicEqualArea().rotate([157,0]).center([-3,19.9]).parallels([8,18]),c={point:function(n,e){t=[n,e]}};return n.invert=function(n){var t=i.scale(),e=i.translate(),r=(n[0]-e[0])/t,u=(n[1]-e[1])/t;return(u>=.12&&.234>u&&r>=-.425&&-.214>r?o:u>=.166&&.234>u&&r>=-.214&&-.115>r?a:i).invert(n)},n.stream=function(n){var t=i.stream(n),e=o.stream(n),r=a.stream(n);return{point:function(n,u){t.point(n,u),e.point(n,u),r.point(n,u)},sphere:function(){t.sphere(),e.sphere(),r.sphere()},lineStart:function(){t.lineStart(),e.lineStart(),r.lineStart()},lineEnd:function(){t.lineEnd(),e.lineEnd(),r.lineEnd()},polygonStart:function(){t.polygonStart(),e.polygonStart(),r.polygonStart()},polygonEnd:function(){t.polygonEnd(),e.polygonEnd(),r.polygonEnd()}}},n.precision=function(t){return arguments.length?(i.precision(t),o.precision(t),a.precision(t),n):i.precision()},n.scale=function(t){return arguments.length?(i.scale(t),o.scale(.35*t),a.scale(t),n.translate(i.translate())):i.scale()},n.translate=function(t){if(!arguments.length)return i.translate();var l=i.scale(),s=+t[0],f=+t[1];return e=i.translate(t).clipExtent([[s-.455*l,f-.238*l],[s+.455*l,f+.238*l]]).stream(c).point,r=o.translate([s-.307*l,f+.201*l]).clipExtent([[s-.425*l+Go,f+.12*l+Go],[s-.214*l-Go,f+.234*l-Go]]).stream(c).point,u=a.translate([s-.205*l,f+.212*l]).clipExtent([[s-.214*l+Go,f+.166*l+Go],[s-.115*l-Go,f+.234*l-Go]]).stream(c).point,n},n.scale(1070)};var Ga,Ka,Qa,nc,tc,ec,rc={point:c,lineStart:c,lineEnd:c,polygonStart:function(){Ka=0,rc.lineStart=ce},polygonEnd:function(){rc.lineStart=rc.lineEnd=rc.point=c,Ga+=Math.abs(Ka/2)}},uc={point:le,lineStart:c,lineEnd:c,polygonStart:c,polygonEnd:c},ic={point:he,lineStart:ge,lineEnd:pe,polygonStart:function(){ic.lineStart=de},polygonEnd:function(){ic.point=he,ic.lineStart=ge,ic.lineEnd=pe}};mo.geo.transform=function(n){return{stream:function(t){var e=new ye(t);for(var r in n)e[r]=n[r];return e}}},ye.prototype={point:function(n,t){this.stream.point(n,t)},sphere:function(){this.stream.sphere()},lineStart:function(){this.stream.lineStart()},lineEnd:function(){this.stream.lineEnd()},polygonStart:function(){this.stream.polygonStart()},polygonEnd:function(){this.stream.polygonEnd()}},mo.geo.path=function(){function n(n){return n&&("function"==typeof a&&i.pointRadius(+a.apply(this,arguments)),o&&o.valid||(o=u(i)),mo.geo.stream(n,o)),i.result()}function t(){return o=null,n}var e,r,u,i,o,a=4.5;return n.area=function(n){return Ga=0,mo.geo.stream(n,u(rc)),Ga},n.centroid=function(n){return Oa=Ra=Ya=Ia=Ua=Za=Va=Xa=$a=0,mo.geo.stream(n,u(ic)),$a?[Va/$a,Xa/$a]:Za?[Ia/Za,Ua/Za]:Ya?[Oa/Ya,Ra/Ya]:[0/0,0/0]},n.bounds=function(n){return tc=ec=-(Qa=nc=1/0),mo.geo.stream(n,u(uc)),[[Qa,nc],[tc,ec]]},n.projection=function(n){return arguments.length?(u=(e=n)?n.stream||Me(n):dt,t()):e},n.context=function(n){return arguments.length?(i=null==(r=n)?new se:new ve(n),"function"!=typeof a&&i.pointRadius(a),t()):r},n.pointRadius=function(t){return arguments.length?(a="function"==typeof t?t:(i.pointRadius(+t),+t),n):a},n.projection(mo.geo.albersUsa()).context(null)},mo.geo.projection=xe,mo.geo.projectionMutator=be,(mo.geo.equirectangular=function(){return xe(we)}).raw=we.invert=we,mo.geo.rotation=function(n){function t(t){return t=n(t[0]*Qo,t[1]*Qo),t[0]*=na,t[1]*=na,t}return n=Ee(n[0]%360*Qo,n[1]*Qo,n.length>2?n[2]*Qo:0),t.invert=function(t){return t=n.invert(t[0]*Qo,t[1]*Qo),t[0]*=na,t[1]*=na,t},t},Se.invert=we,mo.geo.circle=function(){function n(){var n="function"==typeof r?r.apply(this,arguments):r,t=Ee(-n[0]*Qo,-n[1]*Qo,0).invert,u=[];return e(null,null,1,{point:function(n,e){u.push(n=t(n,e)),n[0]*=na,n[1]*=na}}),{type:"Polygon",coordinates:[u]}}var t,e,r=[0,0],u=6;return n.origin=function(t){return arguments.length?(r=t,n):r},n.angle=function(r){return arguments.length?(e=Te((t=+r)*Qo,u*Qo),n):t},n.precision=function(r){return arguments.length?(e=Te(t*Qo,(u=+r)*Qo),n):u},n.angle(90)},mo.geo.distance=function(n,t){var e,r=(t[0]-n[0])*Qo,u=n[1]*Qo,i=t[1]*Qo,o=Math.sin(r),a=Math.cos(r),c=Math.sin(u),l=Math.cos(u),s=Math.sin(i),f=Math.cos(i);return Math.atan2(Math.sqrt((e=f*o)*e+(e=l*s-c*f*a)*e),c*s+l*f*a)},mo.geo.graticule=function(){function n(){return{type:"MultiLineString",coordinates:t()}}function t(){return mo.range(Math.ceil(i/v)*v,u,v).map(h).concat(mo.range(Math.ceil(l/m)*m,c,m).map(g)).concat(mo.range(Math.ceil(r/p)*p,e,p).filter(function(n){return Math.abs(n%v)>Go
-}).map(s)).concat(mo.range(Math.ceil(a/d)*d,o,d).filter(function(n){return Math.abs(n%m)>Go}).map(f))}var e,r,u,i,o,a,c,l,s,f,h,g,p=10,d=p,v=90,m=360,y=2.5;return n.lines=function(){return t().map(function(n){return{type:"LineString",coordinates:n}})},n.outline=function(){return{type:"Polygon",coordinates:[h(i).concat(g(c).slice(1),h(u).reverse().slice(1),g(l).reverse().slice(1))]}},n.extent=function(t){return arguments.length?n.majorExtent(t).minorExtent(t):n.minorExtent()},n.majorExtent=function(t){return arguments.length?(i=+t[0][0],u=+t[1][0],l=+t[0][1],c=+t[1][1],i>u&&(t=i,i=u,u=t),l>c&&(t=l,l=c,c=t),n.precision(y)):[[i,l],[u,c]]},n.minorExtent=function(t){return arguments.length?(r=+t[0][0],e=+t[1][0],a=+t[0][1],o=+t[1][1],r>e&&(t=r,r=e,e=t),a>o&&(t=a,a=o,o=t),n.precision(y)):[[r,a],[e,o]]},n.step=function(t){return arguments.length?n.majorStep(t).minorStep(t):n.minorStep()},n.majorStep=function(t){return arguments.length?(v=+t[0],m=+t[1],n):[v,m]},n.minorStep=function(t){return arguments.length?(p=+t[0],d=+t[1],n):[p,d]},n.precision=function(t){return arguments.length?(y=+t,s=ze(a,o,90),f=Ce(r,e,y),h=ze(l,c,90),g=Ce(i,u,y),n):y},n.majorExtent([[-180,-90+Go],[180,90-Go]]).minorExtent([[-180,-80-Go],[180,80+Go]])},mo.geo.greatArc=function(){function n(){return{type:"LineString",coordinates:[t||r.apply(this,arguments),e||u.apply(this,arguments)]}}var t,e,r=De,u=je;return n.distance=function(){return mo.geo.distance(t||r.apply(this,arguments),e||u.apply(this,arguments))},n.source=function(e){return arguments.length?(r=e,t="function"==typeof e?null:e,n):r},n.target=function(t){return arguments.length?(u=t,e="function"==typeof t?null:t,n):u},n.precision=function(){return arguments.length?n:0},n},mo.geo.interpolate=function(n,t){return Le(n[0]*Qo,n[1]*Qo,t[0]*Qo,t[1]*Qo)},mo.geo.length=function(n){return oc=0,mo.geo.stream(n,ac),oc};var oc,ac={sphere:c,point:c,lineStart:He,lineEnd:c,polygonStart:c,polygonEnd:c},cc=Fe(function(n){return Math.sqrt(2/(1+n))},function(n){return 2*Math.asin(n/2)});(mo.geo.azimuthalEqualArea=function(){return xe(cc)}).raw=cc;var lc=Fe(function(n){var t=Math.acos(n);return t&&t/Math.sin(t)},dt);(mo.geo.azimuthalEquidistant=function(){return xe(lc)}).raw=lc,(mo.geo.conicConformal=function(){return oe(Pe)}).raw=Pe,(mo.geo.conicEquidistant=function(){return oe(Oe)}).raw=Oe;var sc=Fe(function(n){return 1/n},Math.atan);(mo.geo.gnomonic=function(){return xe(sc)}).raw=sc,Re.invert=function(n,t){return[n,2*Math.atan(Math.exp(t))-Jo]},(mo.geo.mercator=function(){return Ye(Re)}).raw=Re;var fc=Fe(function(){return 1},Math.asin);(mo.geo.orthographic=function(){return xe(fc)}).raw=fc;var hc=Fe(function(n){return 1/(1+n)},function(n){return 2*Math.atan(n)});(mo.geo.stereographic=function(){return xe(hc)}).raw=hc,Ie.invert=function(n,t){return[Math.atan2(R(n),Math.cos(t)),O(Math.sin(t)/Y(n))]},(mo.geo.transverseMercator=function(){return Ye(Ie)}).raw=Ie,mo.geom={},mo.svg={},mo.svg.line=function(){return Ue(dt)};var gc=mo.map({linear:Xe,"linear-closed":$e,step:Be,"step-before":We,"step-after":Je,basis:er,"basis-open":rr,"basis-closed":ur,bundle:ir,cardinal:Qe,"cardinal-open":Ge,"cardinal-closed":Ke,monotone:fr});gc.forEach(function(n,t){t.key=n,t.closed=/-closed$/.test(n)});var pc=[0,2/3,1/3,0],dc=[0,1/3,2/3,0],vc=[0,1/6,2/3,1/6];mo.geom.hull=function(n){function t(n){if(n.length<3)return[];var t,u,i,o,a,c,l,s,f,h,g,p,d=pt(e),v=pt(r),m=n.length,y=m-1,M=[],x=[],b=0;if(d===Ze&&r===Ve)t=n;else for(i=0,t=[];m>i;++i)t.push([+d.call(this,u=n[i],i),+v.call(this,u,i)]);for(i=1;m>i;++i)(t[i][1]<t[b][1]||t[i][1]==t[b][1]&&t[i][0]<t[b][0])&&(b=i);for(i=0;m>i;++i)i!==b&&(c=t[i][1]-t[b][1],a=t[i][0]-t[b][0],M.push({angle:Math.atan2(c,a),index:i}));for(M.sort(function(n,t){return n.angle-t.angle}),g=M[0].angle,h=M[0].index,f=0,i=1;y>i;++i){if(o=M[i].index,g==M[i].angle){if(a=t[h][0]-t[b][0],c=t[h][1]-t[b][1],l=t[o][0]-t[b][0],s=t[o][1]-t[b][1],a*a+c*c>=l*l+s*s){M[i].index=-1;continue}M[f].index=-1}g=M[i].angle,f=i,h=o}for(x.push(b),i=0,o=0;2>i;++o)M[o].index>-1&&(x.push(M[o].index),i++);for(p=x.length;y>o;++o)if(!(M[o].index<0)){for(;!hr(x[p-2],x[p-1],M[o].index,t);)--p;x[p++]=M[o].index}var _=[];for(i=p-1;i>=0;--i)_.push(n[x[i]]);return _}var e=Ze,r=Ve;return arguments.length?t(n):(t.x=function(n){return arguments.length?(e=n,t):e},t.y=function(n){return arguments.length?(r=n,t):r},t)},mo.geom.polygon=function(n){return Lo(n,mc),n};var mc=mo.geom.polygon.prototype=[];mc.area=function(){for(var n,t=-1,e=this.length,r=this[e-1],u=0;++t<e;)n=r,r=this[t],u+=n[1]*r[0]-n[0]*r[1];return.5*u},mc.centroid=function(n){var t,e,r=-1,u=this.length,i=0,o=0,a=this[u-1];for(arguments.length||(n=-1/(6*this.area()));++r<u;)t=a,a=this[r],e=t[0]*a[1]-a[0]*t[1],i+=(t[0]+a[0])*e,o+=(t[1]+a[1])*e;return[i*n,o*n]},mc.clip=function(n){for(var t,e,r,u,i,o,a=dr(n),c=-1,l=this.length-dr(this),s=this[l-1];++c<l;){for(t=n.slice(),n.length=0,u=this[c],i=t[(r=t.length-a)-1],e=-1;++e<r;)o=t[e],gr(o,s,u)?(gr(i,s,u)||n.push(pr(i,o,s,u)),n.push(o)):gr(i,s,u)&&n.push(pr(i,o,s,u)),i=o;a&&n.push(n[0]),s=u}return n},mo.geom.delaunay=function(n){var t=n.map(function(){return[]}),e=[];return vr(n,function(e){t[e.region.l.index].push(n[e.region.r.index])}),t.forEach(function(t,r){var u=n[r],i=u[0],o=u[1];t.forEach(function(n){n.angle=Math.atan2(n[0]-i,n[1]-o)}),t.sort(function(n,t){return n.angle-t.angle});for(var a=0,c=t.length-1;c>a;a++)e.push([u,t[a],t[a+1]])}),e},mo.geom.voronoi=function(n){function t(n){var t,i,o,a=n.map(function(){return[]}),c=pt(e),l=pt(r),s=n.length,f=1e6;if(c===Ze&&l===Ve)t=n;else for(t=new Array(s),o=0;s>o;++o)t[o]=[+c.call(this,i=n[o],o),+l.call(this,i,o)];if(vr(t,function(n){var t,e,r,u,i,o;1===n.a&&n.b>=0?(t=n.ep.r,e=n.ep.l):(t=n.ep.l,e=n.ep.r),1===n.a?(i=t?t.y:-f,r=n.c-n.b*i,o=e?e.y:f,u=n.c-n.b*o):(r=t?t.x:-f,i=n.c-n.a*r,u=e?e.x:f,o=n.c-n.a*u);var c=[r,i],l=[u,o];a[n.region.l.index].push(c,l),a[n.region.r.index].push(c,l)}),a=a.map(function(n,e){var r=t[e][0],u=t[e][1],i=n.map(function(n){return Math.atan2(n[0]-r,n[1]-u)}),o=mo.range(n.length).sort(function(n,t){return i[n]-i[t]});return o.filter(function(n,t){return!t||i[n]-i[o[t-1]]>Go}).map(function(t){return n[t]})}),a.forEach(function(n,e){var r=n.length;if(!r)return n.push([-f,-f],[-f,f],[f,f],[f,-f]);if(!(r>2)){var u=t[e],i=n[0],o=n[1],a=u[0],c=u[1],l=i[0],s=i[1],h=o[0],g=o[1],p=Math.abs(h-l),d=g-s;if(Math.abs(d)<Go){var v=s>c?-f:f;n.push([-f,v],[f,v])}else if(Go>p){var m=l>a?-f:f;n.push([m,-f],[m,f])}else{var v=(l-a)*(g-s)>(h-l)*(s-c)?f:-f,y=Math.abs(d)-p;Math.abs(y)<Go?n.push([0>d?v:-v,v]):(y>0&&(v*=-1),n.push([-f,v],[f,v]))}}}),u)for(o=0;s>o;++o)u.clip(a[o]);for(o=0;s>o;++o)a[o].point=n[o];return a}var e=Ze,r=Ve,u=null;return arguments.length?t(n):(t.x=function(n){return arguments.length?(e=n,t):e},t.y=function(n){return arguments.length?(r=n,t):r},t.clipExtent=function(n){if(!arguments.length)return u&&[u[0],u[2]];if(null==n)u=null;else{var e=+n[0][0],r=+n[0][1],i=+n[1][0],o=+n[1][1];u=mo.geom.polygon([[e,r],[e,o],[i,o],[i,r]])}return t},t.size=function(n){return arguments.length?t.clipExtent(n&&[[0,0],n]):u&&u[2]},t.links=function(n){var t,u,i,o=n.map(function(){return[]}),a=[],c=pt(e),l=pt(r),s=n.length;if(c===Ze&&l===Ve)t=n;else for(t=new Array(s),i=0;s>i;++i)t[i]=[+c.call(this,u=n[i],i),+l.call(this,u,i)];return vr(t,function(t){var e=t.region.l.index,r=t.region.r.index;o[e][r]||(o[e][r]=o[r][e]=!0,a.push({source:n[e],target:n[r]}))}),a},t.triangles=function(n){if(e===Ze&&r===Ve)return mo.geom.delaunay(n);for(var t,u=new Array(c),i=pt(e),o=pt(r),a=-1,c=n.length;++a<c;)(u[a]=[+i.call(this,t=n[a],a),+o.call(this,t,a)]).data=t;return mo.geom.delaunay(u).map(function(n){return n.map(function(n){return n.data})})},t)};var yc={l:"r",r:"l"};mo.geom.quadtree=function(n,t,e,r,u){function i(n){function i(n,t,e,r,u,i,o,a){if(!isNaN(e)&&!isNaN(r))if(n.leaf){var c=n.x,s=n.y;if(null!=c)if(Math.abs(c-e)+Math.abs(s-r)<.01)l(n,t,e,r,u,i,o,a);else{var f=n.point;n.x=n.y=n.point=null,l(n,f,c,s,u,i,o,a),l(n,t,e,r,u,i,o,a)}else n.x=e,n.y=r,n.point=t}else l(n,t,e,r,u,i,o,a)}function l(n,t,e,r,u,o,a,c){var l=.5*(u+a),s=.5*(o+c),f=e>=l,h=r>=s,g=(h<<1)+f;n.leaf=!1,n=n.nodes[g]||(n.nodes[g]=Mr()),f?u=l:a=l,h?o=s:c=s,i(n,t,e,r,u,o,a,c)}var s,f,h,g,p,d,v,m,y,M=pt(a),x=pt(c);if(null!=t)d=t,v=e,m=r,y=u;else if(m=y=-(d=v=1/0),f=[],h=[],p=n.length,o)for(g=0;p>g;++g)s=n[g],s.x<d&&(d=s.x),s.y<v&&(v=s.y),s.x>m&&(m=s.x),s.y>y&&(y=s.y),f.push(s.x),h.push(s.y);else for(g=0;p>g;++g){var b=+M(s=n[g],g),_=+x(s,g);d>b&&(d=b),v>_&&(v=_),b>m&&(m=b),_>y&&(y=_),f.push(b),h.push(_)}var w=m-d,S=y-v;w>S?y=v+w:m=d+S;var E=Mr();if(E.add=function(n){i(E,n,+M(n,++g),+x(n,g),d,v,m,y)},E.visit=function(n){xr(n,E,d,v,m,y)},g=-1,null==t){for(;++g<p;)i(E,n[g],f[g],h[g],d,v,m,y);--g}else n.forEach(E.add);return f=h=n=s=null,E}var o,a=Ze,c=Ve;return(o=arguments.length)?(a=mr,c=yr,3===o&&(u=e,r=t,e=t=0),i(n)):(i.x=function(n){return arguments.length?(a=n,i):a},i.y=function(n){return arguments.length?(c=n,i):c},i.extent=function(n){return arguments.length?(null==n?t=e=r=u=null:(t=+n[0][0],e=+n[0][1],r=+n[1][0],u=+n[1][1]),i):null==t?null:[[t,e],[r,u]]},i.size=function(n){return arguments.length?(null==n?t=e=r=u=null:(t=e=0,r=+n[0],u=+n[1]),i):null==t?null:[r-t,u-e]},i)},mo.interpolateRgb=br,mo.interpolateObject=_r,mo.interpolateNumber=wr,mo.interpolateString=Sr;var Mc=/[-+]?(?:\d+\.?\d*|\.?\d+)(?:[eE][-+]?\d+)?/g;mo.interpolate=Er,mo.interpolators=[function(n,t){var e=typeof t;return("string"===e?da.has(t)||/^(#|rgb\(|hsl\()/.test(t)?br:Sr:t instanceof Z?br:"object"===e?Array.isArray(t)?kr:_r:wr)(n,t)}],mo.interpolateArray=kr;var xc=function(){return dt},bc=mo.map({linear:xc,poly:Dr,quad:function(){return qr},cubic:function(){return zr},sin:function(){return jr},exp:function(){return Lr},circle:function(){return Hr},elastic:Fr,back:Pr,bounce:function(){return Or}}),_c=mo.map({"in":dt,out:Nr,"in-out":Tr,"out-in":function(n){return Tr(Nr(n))}});mo.ease=function(n){var t=n.indexOf("-"),e=t>=0?n.substring(0,t):n,r=t>=0?n.substring(t+1):"in";return e=bc.get(e)||xc,r=_c.get(r)||dt,Ar(r(e.apply(null,Array.prototype.slice.call(arguments,1))))},mo.interpolateHcl=Rr,mo.interpolateHsl=Yr,mo.interpolateLab=Ir,mo.interpolateRound=Ur,mo.transform=function(n){var t=xo.createElementNS(mo.ns.prefix.svg,"g");return(mo.transform=function(n){if(null!=n){t.setAttribute("transform",n);var e=t.transform.baseVal.consolidate()}return new Zr(e?e.matrix:wc)})(n)},Zr.prototype.toString=function(){return"translate("+this.translate+")rotate("+this.rotate+")skewX("+this.skew+")scale("+this.scale+")"};var wc={a:1,b:0,c:0,d:1,e:0,f:0};mo.interpolateTransform=Br,mo.layout={},mo.layout.bundle=function(){return function(n){for(var t=[],e=-1,r=n.length;++e<r;)t.push(Gr(n[e]));return t}},mo.layout.chord=function(){function n(){var n,l,f,h,g,p={},d=[],v=mo.range(i),m=[];for(e=[],r=[],n=0,h=-1;++h<i;){for(l=0,g=-1;++g<i;)l+=u[h][g];d.push(l),m.push(mo.range(i)),n+=l}for(o&&v.sort(function(n,t){return o(d[n],d[t])}),a&&m.forEach(function(n,t){n.sort(function(n,e){return a(u[t][n],u[t][e])})}),n=(Wo-s*i)/n,l=0,h=-1;++h<i;){for(f=l,g=-1;++g<i;){var y=v[h],M=m[y][g],x=u[y][M],b=l,_=l+=x*n;p[y+"-"+M]={index:y,subindex:M,startAngle:b,endAngle:_,value:x}}r[y]={index:y,startAngle:f,endAngle:l,value:(l-f)/n},l+=s}for(h=-1;++h<i;)for(g=h-1;++g<i;){var w=p[h+"-"+g],S=p[g+"-"+h];(w.value||S.value)&&e.push(w.value<S.value?{source:S,target:w}:{source:w,target:S})}c&&t()}function t(){e.sort(function(n,t){return c((n.source.value+n.target.value)/2,(t.source.value+t.target.value)/2)})}var e,r,u,i,o,a,c,l={},s=0;return l.matrix=function(n){return arguments.length?(i=(u=n)&&u.length,e=r=null,l):u},l.padding=function(n){return arguments.length?(s=n,e=r=null,l):s},l.sortGroups=function(n){return arguments.length?(o=n,e=r=null,l):o},l.sortSubgroups=function(n){return arguments.length?(a=n,e=null,l):a},l.sortChords=function(n){return arguments.length?(c=n,e&&t(),l):c},l.chords=function(){return e||n(),e},l.groups=function(){return r||n(),r},l},mo.layout.force=function(){function n(n){return function(t,e,r,u){if(t.point!==n){var i=t.cx-n.x,o=t.cy-n.y,a=1/Math.sqrt(i*i+o*o);if(d>(u-e)*a){var c=t.charge*a*a;return n.px-=i*c,n.py-=o*c,!0}if(t.point&&isFinite(a)){var c=t.pointCharge*a*a;n.px-=i*c,n.py-=o*c}}return!t.charge}}function t(n){n.px=mo.event.x,n.py=mo.event.y,a.resume()}var e,r,u,i,o,a={},c=mo.dispatch("start","tick","end"),l=[1,1],s=.9,f=Sc,h=Ec,g=-30,p=.1,d=.8,v=[],m=[];return a.tick=function(){if((r*=.99)<.005)return c.end({type:"end",alpha:r=0}),!0;var t,e,a,f,h,d,y,M,x,b=v.length,_=m.length;for(e=0;_>e;++e)a=m[e],f=a.source,h=a.target,M=h.x-f.x,x=h.y-f.y,(d=M*M+x*x)&&(d=r*i[e]*((d=Math.sqrt(d))-u[e])/d,M*=d,x*=d,h.x-=M*(y=f.weight/(h.weight+f.weight)),h.y-=x*y,f.x+=M*(y=1-y),f.y+=x*y);if((y=r*p)&&(M=l[0]/2,x=l[1]/2,e=-1,y))for(;++e<b;)a=v[e],a.x+=(M-a.x)*y,a.y+=(x-a.y)*y;if(g)for(uu(t=mo.geom.quadtree(v),r,o),e=-1;++e<b;)(a=v[e]).fixed||t.visit(n(a));for(e=-1;++e<b;)a=v[e],a.fixed?(a.x=a.px,a.y=a.py):(a.x-=(a.px-(a.px=a.x))*s,a.y-=(a.py-(a.py=a.y))*s);c.tick({type:"tick",alpha:r})},a.nodes=function(n){return arguments.length?(v=n,a):v},a.links=function(n){return arguments.length?(m=n,a):m},a.size=function(n){return arguments.length?(l=n,a):l},a.linkDistance=function(n){return arguments.length?(f="function"==typeof n?n:+n,a):f},a.distance=a.linkDistance,a.linkStrength=function(n){return arguments.length?(h="function"==typeof n?n:+n,a):h},a.friction=function(n){return arguments.length?(s=+n,a):s},a.charge=function(n){return arguments.length?(g="function"==typeof n?n:+n,a):g},a.gravity=function(n){return arguments.length?(p=+n,a):p},a.theta=function(n){return arguments.length?(d=+n,a):d},a.alpha=function(n){return arguments.length?(n=+n,r?r=n>0?n:0:n>0&&(c.start({type:"start",alpha:r=n}),mo.timer(a.tick)),a):r},a.start=function(){function n(n,r){for(var u,i=t(e),o=-1,a=i.length;++o<a;)if(!isNaN(u=i[o][n]))return u;return Math.random()*r}function t(){if(!c){for(c=[],r=0;p>r;++r)c[r]=[];for(r=0;d>r;++r){var n=m[r];c[n.source.index].push(n.target),c[n.target.index].push(n.source)}}return c[e]}var e,r,c,s,p=v.length,d=m.length,y=l[0],M=l[1];for(e=0;p>e;++e)(s=v[e]).index=e,s.weight=0;for(e=0;d>e;++e)s=m[e],"number"==typeof s.source&&(s.source=v[s.source]),"number"==typeof s.target&&(s.target=v[s.target]),++s.source.weight,++s.target.weight;for(e=0;p>e;++e)s=v[e],isNaN(s.x)&&(s.x=n("x",y)),isNaN(s.y)&&(s.y=n("y",M)),isNaN(s.px)&&(s.px=s.x),isNaN(s.py)&&(s.py=s.y);if(u=[],"function"==typeof f)for(e=0;d>e;++e)u[e]=+f.call(this,m[e],e);else for(e=0;d>e;++e)u[e]=f;if(i=[],"function"==typeof h)for(e=0;d>e;++e)i[e]=+h.call(this,m[e],e);else for(e=0;d>e;++e)i[e]=h;if(o=[],"function"==typeof g)for(e=0;p>e;++e)o[e]=+g.call(this,v[e],e);else for(e=0;p>e;++e)o[e]=g;return a.resume()},a.resume=function(){return a.alpha(.1)},a.stop=function(){return a.alpha(0)},a.drag=function(){return e||(e=mo.behavior.drag().origin(dt).on("dragstart.force",nu).on("drag.force",t).on("dragend.force",tu)),arguments.length?(this.on("mouseover.force",eu).on("mouseout.force",ru).call(e),void 0):e},mo.rebind(a,c,"on")};var Sc=20,Ec=1;mo.layout.hierarchy=function(){function n(t,o,a){var c=u.call(e,t,o);if(t.depth=o,a.push(t),c&&(l=c.length)){for(var l,s,f=-1,h=t.children=[],g=0,p=o+1;++f<l;)s=n(c[f],p,a),s.parent=t,h.push(s),g+=s.value;r&&h.sort(r),i&&(t.value=g)}else i&&(t.value=+i.call(e,t,o)||0);return t}function t(n,r){var u=n.children,o=0;if(u&&(a=u.length))for(var a,c=-1,l=r+1;++c<a;)o+=t(u[c],l);else i&&(o=+i.call(e,n,r)||0);return i&&(n.value=o),o}function e(t){var e=[];return n(t,0,e),e}var r=cu,u=ou,i=au;return e.sort=function(n){return arguments.length?(r=n,e):r},e.children=function(n){return arguments.length?(u=n,e):u},e.value=function(n){return arguments.length?(i=n,e):i},e.revalue=function(n){return t(n,0),n},e},mo.layout.partition=function(){function n(t,e,r,u){var i=t.children;if(t.x=e,t.y=t.depth*u,t.dx=r,t.dy=u,i&&(o=i.length)){var o,a,c,l=-1;for(r=t.value?r/t.value:0;++l<o;)n(a=i[l],e,c=a.value*r,u),e+=c}}function t(n){var e=n.children,r=0;if(e&&(u=e.length))for(var u,i=-1;++i<u;)r=Math.max(r,t(e[i]));return 1+r}function e(e,i){var o=r.call(this,e,i);return n(o[0],0,u[0],u[1]/t(o[0])),o}var r=mo.layout.hierarchy(),u=[1,1];return e.size=function(n){return arguments.length?(u=n,e):u},iu(e,r)},mo.layout.pie=function(){function n(i){var o=i.map(function(e,r){return+t.call(n,e,r)}),a=+("function"==typeof r?r.apply(this,arguments):r),c=(("function"==typeof u?u.apply(this,arguments):u)-a)/mo.sum(o),l=mo.range(i.length);null!=e&&l.sort(e===kc?function(n,t){return o[t]-o[n]}:function(n,t){return e(i[n],i[t])});var s=[];return l.forEach(function(n){var t;s[n]={data:i[n],value:t=o[n],startAngle:a,endAngle:a+=t*c}}),s}var t=Number,e=kc,r=0,u=Wo;return n.value=function(e){return arguments.length?(t=e,n):t},n.sort=function(t){return arguments.length?(e=t,n):e},n.startAngle=function(t){return arguments.length?(r=t,n):r},n.endAngle=function(t){return arguments.length?(u=t,n):u},n};var kc={};mo.layout.stack=function(){function n(a,c){var l=a.map(function(e,r){return t.call(n,e,r)}),s=l.map(function(t){return t.map(function(t,e){return[i.call(n,t,e),o.call(n,t,e)]})}),f=e.call(n,s,c);l=mo.permute(l,f),s=mo.permute(s,f);var h,g,p,d=r.call(n,s,c),v=l.length,m=l[0].length;for(g=0;m>g;++g)for(u.call(n,l[0][g],p=d[g],s[0][g][1]),h=1;v>h;++h)u.call(n,l[h][g],p+=s[h-1][g][1],s[h][g][1]);return a}var t=dt,e=gu,r=pu,u=hu,i=su,o=fu;return n.values=function(e){return arguments.length?(t=e,n):t},n.order=function(t){return arguments.length?(e="function"==typeof t?t:Ac.get(t)||gu,n):e},n.offset=function(t){return arguments.length?(r="function"==typeof t?t:Nc.get(t)||pu,n):r},n.x=function(t){return arguments.length?(i=t,n):i},n.y=function(t){return arguments.length?(o=t,n):o},n.out=function(t){return arguments.length?(u=t,n):u},n};var Ac=mo.map({"inside-out":function(n){var t,e,r=n.length,u=n.map(du),i=n.map(vu),o=mo.range(r).sort(function(n,t){return u[n]-u[t]}),a=0,c=0,l=[],s=[];for(t=0;r>t;++t)e=o[t],c>a?(a+=i[e],l.push(e)):(c+=i[e],s.push(e));return s.reverse().concat(l)},reverse:function(n){return mo.range(n.length).reverse()},"default":gu}),Nc=mo.map({silhouette:function(n){var t,e,r,u=n.length,i=n[0].length,o=[],a=0,c=[];for(e=0;i>e;++e){for(t=0,r=0;u>t;t++)r+=n[t][e][1];r>a&&(a=r),o.push(r)}for(e=0;i>e;++e)c[e]=(a-o[e])/2;return c},wiggle:function(n){var t,e,r,u,i,o,a,c,l,s=n.length,f=n[0],h=f.length,g=[];for(g[0]=c=l=0,e=1;h>e;++e){for(t=0,u=0;s>t;++t)u+=n[t][e][1];for(t=0,i=0,a=f[e][0]-f[e-1][0];s>t;++t){for(r=0,o=(n[t][e][1]-n[t][e-1][1])/(2*a);t>r;++r)o+=(n[r][e][1]-n[r][e-1][1])/a;i+=o*n[t][e][1]}g[e]=c-=u?i/u*a:0,l>c&&(l=c)}for(e=0;h>e;++e)g[e]-=l;return g},expand:function(n){var t,e,r,u=n.length,i=n[0].length,o=1/u,a=[];for(e=0;i>e;++e){for(t=0,r=0;u>t;t++)r+=n[t][e][1];if(r)for(t=0;u>t;t++)n[t][e][1]/=r;else for(t=0;u>t;t++)n[t][e][1]=o}for(e=0;i>e;++e)a[e]=0;return a},zero:pu});mo.layout.histogram=function(){function n(n,i){for(var o,a,c=[],l=n.map(e,this),s=r.call(this,l,i),f=u.call(this,s,l,i),i=-1,h=l.length,g=f.length-1,p=t?1:1/h;++i<g;)o=c[i]=[],o.dx=f[i+1]-(o.x=f[i]),o.y=0;if(g>0)for(i=-1;++i<h;)a=l[i],a>=s[0]&&a<=s[1]&&(o=c[mo.bisect(f,a,1,g)-1],o.y+=p,o.push(n[i]));return c}var t=!0,e=Number,r=xu,u=yu;return n.value=function(t){return arguments.length?(e=t,n):e},n.range=function(t){return arguments.length?(r=pt(t),n):r},n.bins=function(t){return arguments.length?(u="number"==typeof t?function(n){return Mu(n,t)}:pt(t),n):u},n.frequency=function(e){return arguments.length?(t=!!e,n):t},n},mo.layout.tree=function(){function n(n,i){function o(n,t){var r=n.children,u=n._tree;if(r&&(i=r.length)){for(var i,a,l,s=r[0],f=s,h=-1;++h<i;)l=r[h],o(l,a),f=c(l,a,f),a=l;Tu(n);var g=.5*(s._tree.prelim+l._tree.prelim);t?(u.prelim=t._tree.prelim+e(n,t),u.mod=u.prelim-g):u.prelim=g}else t&&(u.prelim=t._tree.prelim+e(n,t))}function a(n,t){n.x=n._tree.prelim+t;var e=n.children;if(e&&(r=e.length)){var r,u=-1;for(t+=n._tree.mod;++u<r;)a(e[u],t)}}function c(n,t,r){if(t){for(var u,i=n,o=n,a=t,c=n.parent.children[0],l=i._tree.mod,s=o._tree.mod,f=a._tree.mod,h=c._tree.mod;a=wu(a),i=_u(i),a&&i;)c=_u(c),o=wu(o),o._tree.ancestor=n,u=a._tree.prelim+f-i._tree.prelim-l+e(a,i),u>0&&(qu(zu(a,n,r),n,u),l+=u,s+=u),f+=a._tree.mod,l+=i._tree.mod,h+=c._tree.mod,s+=o._tree.mod;a&&!wu(o)&&(o._tree.thread=a,o._tree.mod+=f-s),i&&!_u(c)&&(c._tree.thread=i,c._tree.mod+=l-h,r=n)}return r}var l=t.call(this,n,i),s=l[0];Nu(s,function(n,t){n._tree={ancestor:n,prelim:0,mod:0,change:0,shift:0,number:t?t._tree.number+1:0}}),o(s),a(s,-s._tree.prelim);var f=Su(s,ku),h=Su(s,Eu),g=Su(s,Au),p=f.x-e(f,h)/2,d=h.x+e(h,f)/2,v=g.depth||1;return Nu(s,u?function(n){n.x*=r[0],n.y=n.depth*r[1],delete n._tree}:function(n){n.x=(n.x-p)/(d-p)*r[0],n.y=n.depth/v*r[1],delete n._tree}),l}var t=mo.layout.hierarchy().sort(null).value(null),e=bu,r=[1,1],u=!1;return n.separation=function(t){return arguments.length?(e=t,n):e},n.size=function(t){return arguments.length?(u=null==(r=t),n):u?null:r},n.nodeSize=function(t){return arguments.length?(u=null!=(r=t),n):u?r:null},iu(n,t)},mo.layout.pack=function(){function n(n,i){var o=e.call(this,n,i),a=o[0],c=u[0],l=u[1],s=null==t?Math.sqrt:"function"==typeof t?t:function(){return t};if(a.x=a.y=0,Nu(a,function(n){n.r=+s(n.value)}),Nu(a,Hu),r){var f=r*(t?1:Math.max(2*a.r/c,2*a.r/l))/2;Nu(a,function(n){n.r+=f}),Nu(a,Hu),Nu(a,function(n){n.r-=f})}return Ou(a,c/2,l/2,t?1:1/Math.max(2*a.r/c,2*a.r/l)),o}var t,e=mo.layout.hierarchy().sort(Cu),r=0,u=[1,1];return n.size=function(t){return arguments.length?(u=t,n):u},n.radius=function(e){return arguments.length?(t=null==e||"function"==typeof e?e:+e,n):t},n.padding=function(t){return arguments.length?(r=+t,n):r},iu(n,e)},mo.layout.cluster=function(){function n(n,i){var o,a=t.call(this,n,i),c=a[0],l=0;Nu(c,function(n){var t=n.children;t&&t.length?(n.x=Iu(t),n.y=Yu(t)):(n.x=o?l+=e(n,o):0,n.y=0,o=n)});var s=Uu(c),f=Zu(c),h=s.x-e(s,f)/2,g=f.x+e(f,s)/2;return Nu(c,u?function(n){n.x=(n.x-c.x)*r[0],n.y=(c.y-n.y)*r[1]}:function(n){n.x=(n.x-h)/(g-h)*r[0],n.y=(1-(c.y?n.y/c.y:1))*r[1]}),a}var t=mo.layout.hierarchy().sort(null).value(null),e=bu,r=[1,1],u=!1;return n.separation=function(t){return arguments.length?(e=t,n):e},n.size=function(t){return arguments.length?(u=null==(r=t),n):u?null:r},n.nodeSize=function(t){return arguments.length?(u=null!=(r=t),n):u?r:null},iu(n,t)},mo.layout.treemap=function(){function n(n,t){for(var e,r,u=-1,i=n.length;++u<i;)r=(e=n[u]).value*(0>t?0:t),e.area=isNaN(r)||0>=r?0:r}function t(e){var i=e.children;if(i&&i.length){var o,a,c,l=f(e),s=[],h=i.slice(),p=1/0,d="slice"===g?l.dx:"dice"===g?l.dy:"slice-dice"===g?1&e.depth?l.dy:l.dx:Math.min(l.dx,l.dy);for(n(h,l.dx*l.dy/e.value),s.area=0;(c=h.length)>0;)s.push(o=h[c-1]),s.area+=o.area,"squarify"!==g||(a=r(s,d))<=p?(h.pop(),p=a):(s.area-=s.pop().area,u(s,d,l,!1),d=Math.min(l.dx,l.dy),s.length=s.area=0,p=1/0);s.length&&(u(s,d,l,!0),s.length=s.area=0),i.forEach(t)}}function e(t){var r=t.children;if(r&&r.length){var i,o=f(t),a=r.slice(),c=[];for(n(a,o.dx*o.dy/t.value),c.area=0;i=a.pop();)c.push(i),c.area+=i.area,null!=i.z&&(u(c,i.z?o.dx:o.dy,o,!a.length),c.length=c.area=0);r.forEach(e)}}function r(n,t){for(var e,r=n.area,u=0,i=1/0,o=-1,a=n.length;++o<a;)(e=n[o].area)&&(i>e&&(i=e),e>u&&(u=e));return r*=r,t*=t,r?Math.max(t*u*p/r,r/(t*i*p)):1/0}function u(n,t,e,r){var u,i=-1,o=n.length,a=e.x,l=e.y,s=t?c(n.area/t):0;if(t==e.dx){for((r||s>e.dy)&&(s=e.dy);++i<o;)u=n[i],u.x=a,u.y=l,u.dy=s,a+=u.dx=Math.min(e.x+e.dx-a,s?c(u.area/s):0);u.z=!0,u.dx+=e.x+e.dx-a,e.y+=s,e.dy-=s}else{for((r||s>e.dx)&&(s=e.dx);++i<o;)u=n[i],u.x=a,u.y=l,u.dx=s,l+=u.dy=Math.min(e.y+e.dy-l,s?c(u.area/s):0);u.z=!1,u.dy+=e.y+e.dy-l,e.x+=s,e.dx-=s}}function i(r){var u=o||a(r),i=u[0];return i.x=0,i.y=0,i.dx=l[0],i.dy=l[1],o&&a.revalue(i),n([i],i.dx*i.dy/i.value),(o?e:t)(i),h&&(o=u),u}var o,a=mo.layout.hierarchy(),c=Math.round,l=[1,1],s=null,f=Vu,h=!1,g="squarify",p=.5*(1+Math.sqrt(5));return i.size=function(n){return arguments.length?(l=n,i):l},i.padding=function(n){function t(t){var e=n.call(i,t,t.depth);return null==e?Vu(t):Xu(t,"number"==typeof e?[e,e,e,e]:e)}function e(t){return Xu(t,n)}if(!arguments.length)return s;var r;return f=null==(s=n)?Vu:"function"==(r=typeof n)?t:"number"===r?(n=[n,n,n,n],e):e,i},i.round=function(n){return arguments.length?(c=n?Math.round:Number,i):c!=Number},i.sticky=function(n){return arguments.length?(h=n,o=null,i):h},i.ratio=function(n){return arguments.length?(p=n,i):p},i.mode=function(n){return arguments.length?(g=n+"",i):g},iu(i,a)},mo.random={normal:function(n,t){var e=arguments.length;return 2>e&&(t=1),1>e&&(n=0),function(){var e,r,u;do e=2*Math.random()-1,r=2*Math.random()-1,u=e*e+r*r;while(!u||u>1);return n+t*e*Math.sqrt(-2*Math.log(u)/u)}},logNormal:function(){var n=mo.random.normal.apply(mo,arguments);return function(){return Math.exp(n())}},irwinHall:function(n){return function(){for(var t=0,e=0;n>e;e++)t+=Math.random();return t/n}}},mo.scale={};var Tc={floor:dt,ceil:dt};mo.scale.linear=function(){return Qu([0,1],[0,1],Er,!1)},mo.scale.log=function(){return ii(mo.scale.linear().domain([0,1]),10,!0,[1,10])};var qc=mo.format(".0e"),zc={floor:function(n){return-Math.ceil(-n)},ceil:function(n){return-Math.floor(-n)}};mo.scale.pow=function(){return oi(mo.scale.linear(),1,[0,1])},mo.scale.sqrt=function(){return mo.scale.pow().exponent(.5)},mo.scale.ordinal=function(){return ci([],{t:"range",a:[[]]})},mo.scale.category10=function(){return mo.scale.ordinal().range(Cc)},mo.scale.category20=function(){return mo.scale.ordinal().range(Dc)},mo.scale.category20b=function(){return mo.scale.ordinal().range(jc)},mo.scale.category20c=function(){return mo.scale.ordinal().range(Lc)};var Cc=[2062260,16744206,2924588,14034728,9725885,9197131,14907330,8355711,12369186,1556175].map(it),Dc=[2062260,11454440,16744206,16759672,2924588,10018698,14034728,16750742,9725885,12955861,9197131,12885140,14907330,16234194,8355711,13092807,12369186,14408589,1556175,10410725].map(it),jc=[3750777,5395619,7040719,10264286,6519097,9216594,11915115,13556636,9202993,12426809,15186514,15190932,8666169,11356490,14049643,15177372,8077683,10834324,13528509,14589654].map(it),Lc=[3244733,7057110,10406625,13032431,15095053,16616764,16625259,16634018,3253076,7652470,10607003,13101504,7695281,10394312,12369372,14342891,6513507,9868950,12434877,14277081].map(it);mo.scale.quantile=function(){return li([],[])},mo.scale.quantize=function(){return si(0,1,[0,1])},mo.scale.threshold=function(){return fi([.5],[0,1])},mo.scale.identity=function(){return hi([0,1])},mo.svg.arc=function(){function n(){var n=t.apply(this,arguments),i=e.apply(this,arguments),o=r.apply(this,arguments)+Hc,a=u.apply(this,arguments)+Hc,c=(o>a&&(c=o,o=a,a=c),a-o),l=Bo>c?"0":"1",s=Math.cos(o),f=Math.sin(o),h=Math.cos(a),g=Math.sin(a);return c>=Fc?n?"M0,"+i+"A"+i+","+i+" 0 1,1 0,"+-i+"A"+i+","+i+" 0 1,1 0,"+i+"M0,"+n+"A"+n+","+n+" 0 1,0 0,"+-n+"A"+n+","+n+" 0 1,0 0,"+n+"Z":"M0,"+i+"A"+i+","+i+" 0 1,1 0,"+-i+"A"+i+","+i+" 0 1,1 0,"+i+"Z":n?"M"+i*s+","+i*f+"A"+i+","+i+" 0 "+l+",1 "+i*h+","+i*g+"L"+n*h+","+n*g+"A"+n+","+n+" 0 "+l+",0 "+n*s+","+n*f+"Z":"M"+i*s+","+i*f+"A"+i+","+i+" 0 "+l+",1 "+i*h+","+i*g+"L0,0"+"Z"}var t=gi,e=pi,r=di,u=vi;return n.innerRadius=function(e){return arguments.length?(t=pt(e),n):t},n.outerRadius=function(t){return arguments.length?(e=pt(t),n):e},n.startAngle=function(t){return arguments.length?(r=pt(t),n):r},n.endAngle=function(t){return arguments.length?(u=pt(t),n):u},n.centroid=function(){var n=(t.apply(this,arguments)+e.apply(this,arguments))/2,i=(r.apply(this,arguments)+u.apply(this,arguments))/2+Hc;return[Math.cos(i)*n,Math.sin(i)*n]},n};var Hc=-Jo,Fc=Wo-Go;mo.svg.line.radial=function(){var n=Ue(mi);return n.radius=n.x,delete n.x,n.angle=n.y,delete n.y,n},We.reverse=Je,Je.reverse=We,mo.svg.area=function(){return yi(dt)},mo.svg.area.radial=function(){var n=yi(mi);return n.radius=n.x,delete n.x,n.innerRadius=n.x0,delete n.x0,n.outerRadius=n.x1,delete n.x1,n.angle=n.y,delete n.y,n.startAngle=n.y0,delete n.y0,n.endAngle=n.y1,delete n.y1,n},mo.svg.chord=function(){function n(n,a){var c=t(this,i,n,a),l=t(this,o,n,a);return"M"+c.p0+r(c.r,c.p1,c.a1-c.a0)+(e(c,l)?u(c.r,c.p1,c.r,c.p0):u(c.r,c.p1,l.r,l.p0)+r(l.r,l.p1,l.a1-l.a0)+u(l.r,l.p1,c.r,c.p0))+"Z"}function t(n,t,e,r){var u=t.call(n,e,r),i=a.call(n,u,r),o=c.call(n,u,r)+Hc,s=l.call(n,u,r)+Hc;return{r:i,a0:o,a1:s,p0:[i*Math.cos(o),i*Math.sin(o)],p1:[i*Math.cos(s),i*Math.sin(s)]}}function e(n,t){return n.a0==t.a0&&n.a1==t.a1}function r(n,t,e){return"A"+n+","+n+" 0 "+ +(e>Bo)+",1 "+t}function u(n,t,e,r){return"Q 0,0 "+r}var i=De,o=je,a=Mi,c=di,l=vi;return n.radius=function(t){return arguments.length?(a=pt(t),n):a},n.source=function(t){return arguments.length?(i=pt(t),n):i},n.target=function(t){return arguments.length?(o=pt(t),n):o},n.startAngle=function(t){return arguments.length?(c=pt(t),n):c},n.endAngle=function(t){return arguments.length?(l=pt(t),n):l},n},mo.svg.diagonal=function(){function n(n,u){var i=t.call(this,n,u),o=e.call(this,n,u),a=(i.y+o.y)/2,c=[i,{x:i.x,y:a},{x:o.x,y:a},o];return c=c.map(r),"M"+c[0]+"C"+c[1]+" "+c[2]+" "+c[3]}var t=De,e=je,r=xi;return n.source=function(e){return arguments.length?(t=pt(e),n):t},n.target=function(t){return arguments.length?(e=pt(t),n):e},n.projection=function(t){return arguments.length?(r=t,n):r},n},mo.svg.diagonal.radial=function(){var n=mo.svg.diagonal(),t=xi,e=n.projection;return n.projection=function(n){return arguments.length?e(bi(t=n)):t},n},mo.svg.symbol=function(){function n(n,r){return(Pc.get(t.call(this,n,r))||Si)(e.call(this,n,r))}var t=wi,e=_i;return n.type=function(e){return arguments.length?(t=pt(e),n):t},n.size=function(t){return arguments.length?(e=pt(t),n):e},n};var Pc=mo.map({circle:Si,cross:function(n){var t=Math.sqrt(n/5)/2;return"M"+-3*t+","+-t+"H"+-t+"V"+-3*t+"H"+t+"V"+-t+"H"+3*t+"V"+t+"H"+t+"V"+3*t+"H"+-t+"V"+t+"H"+-3*t+"Z"},diamond:function(n){var t=Math.sqrt(n/(2*Ic)),e=t*Ic;return"M0,"+-t+"L"+e+",0"+" 0,"+t+" "+-e+",0"+"Z"},square:function(n){var t=Math.sqrt(n)/2;return"M"+-t+","+-t+"L"+t+","+-t+" "+t+","+t+" "+-t+","+t+"Z"},"triangle-down":function(n){var t=Math.sqrt(n/Yc),e=t*Yc/2;return"M0,"+e+"L"+t+","+-e+" "+-t+","+-e+"Z"},"triangle-up":function(n){var t=Math.sqrt(n/Yc),e=t*Yc/2;return"M0,"+-e+"L"+t+","+e+" "+-t+","+e+"Z"}});mo.svg.symbolTypes=Pc.keys();var Oc,Rc,Yc=Math.sqrt(3),Ic=Math.tan(30*Qo),Uc=[],Zc=0;Uc.call=Ro.call,Uc.empty=Ro.empty,Uc.node=Ro.node,Uc.size=Ro.size,mo.transition=function(n){return arguments.length?Oc?n.transition():n:Uo.transition()},mo.transition.prototype=Uc,Uc.select=function(n){var t,e,r,u=this.id,i=[];n=d(n);for(var o=-1,a=this.length;++o<a;){i.push(t=[]);for(var c=this[o],l=-1,s=c.length;++l<s;)(r=c[l])&&(e=n.call(r,r.__data__,l,o))?("__data__"in r&&(e.__data__=r.__data__),Ni(e,l,u,r.__transition__[u]),t.push(e)):t.push(null)}return Ei(i,u)},Uc.selectAll=function(n){var t,e,r,u,i,o=this.id,a=[];n=v(n);for(var c=-1,l=this.length;++c<l;)for(var s=this[c],f=-1,h=s.length;++f<h;)if(r=s[f]){i=r.__transition__[o],e=n.call(r,r.__data__,f,c),a.push(t=[]);for(var g=-1,p=e.length;++g<p;)(u=e[g])&&Ni(u,g,o,i),t.push(u)}return Ei(a,o)},Uc.filter=function(n){var t,e,r,u=[];"function"!=typeof n&&(n=k(n));for(var i=0,o=this.length;o>i;i++){u.push(t=[]);for(var e=this[i],a=0,c=e.length;c>a;a++)(r=e[a])&&n.call(r,r.__data__,a)&&t.push(r)}return Ei(u,this.id)},Uc.tween=function(n,t){var e=this.id;return arguments.length<2?this.node().__transition__[e].tween.get(n):N(this,null==t?function(t){t.__transition__[e].tween.remove(n)}:function(r){r.__transition__[e].tween.set(n,t)})},Uc.attr=function(n,t){function e(){this.removeAttribute(a)}function r(){this.removeAttributeNS(a.space,a.local)}function u(n){return null==n?e:(n+="",function(){var t,e=this.getAttribute(a);return e!==n&&(t=o(e,n),function(n){this.setAttribute(a,t(n))})})}function i(n){return null==n?r:(n+="",function(){var t,e=this.getAttributeNS(a.space,a.local);return e!==n&&(t=o(e,n),function(n){this.setAttributeNS(a.space,a.local,t(n))
-})})}if(arguments.length<2){for(t in n)this.attr(t,n[t]);return this}var o="transform"==n?Br:Er,a=mo.ns.qualify(n);return ki(this,"attr."+n,t,a.local?i:u)},Uc.attrTween=function(n,t){function e(n,e){var r=t.call(this,n,e,this.getAttribute(u));return r&&function(n){this.setAttribute(u,r(n))}}function r(n,e){var r=t.call(this,n,e,this.getAttributeNS(u.space,u.local));return r&&function(n){this.setAttributeNS(u.space,u.local,r(n))}}var u=mo.ns.qualify(n);return this.tween("attr."+n,u.local?r:e)},Uc.style=function(n,t,e){function r(){this.style.removeProperty(n)}function u(t){return null==t?r:(t+="",function(){var r,u=_o.getComputedStyle(this,null).getPropertyValue(n);return u!==t&&(r=Er(u,t),function(t){this.style.setProperty(n,r(t),e)})})}var i=arguments.length;if(3>i){if("string"!=typeof n){2>i&&(t="");for(e in n)this.style(e,n[e],t);return this}e=""}return ki(this,"style."+n,t,u)},Uc.styleTween=function(n,t,e){function r(r,u){var i=t.call(this,r,u,_o.getComputedStyle(this,null).getPropertyValue(n));return i&&function(t){this.style.setProperty(n,i(t),e)}}return arguments.length<3&&(e=""),this.tween("style."+n,r)},Uc.text=function(n){return ki(this,"text",n,Ai)},Uc.remove=function(){return this.each("end.transition",function(){var n;this.__transition__.count<2&&(n=this.parentNode)&&n.removeChild(this)})},Uc.ease=function(n){var t=this.id;return arguments.length<1?this.node().__transition__[t].ease:("function"!=typeof n&&(n=mo.ease.apply(mo,arguments)),N(this,function(e){e.__transition__[t].ease=n}))},Uc.delay=function(n){var t=this.id;return N(this,"function"==typeof n?function(e,r,u){e.__transition__[t].delay=+n.call(e,e.__data__,r,u)}:(n=+n,function(e){e.__transition__[t].delay=n}))},Uc.duration=function(n){var t=this.id;return N(this,"function"==typeof n?function(e,r,u){e.__transition__[t].duration=Math.max(1,n.call(e,e.__data__,r,u))}:(n=Math.max(1,n),function(e){e.__transition__[t].duration=n}))},Uc.each=function(n,t){var e=this.id;if(arguments.length<2){var r=Rc,u=Oc;Oc=e,N(this,function(t,r,u){Rc=t.__transition__[e],n.call(t,t.__data__,r,u)}),Rc=r,Oc=u}else N(this,function(r){var u=r.__transition__[e];(u.event||(u.event=mo.dispatch("start","end"))).on(n,t)});return this},Uc.transition=function(){for(var n,t,e,r,u=this.id,i=++Zc,o=[],a=0,c=this.length;c>a;a++){o.push(n=[]);for(var t=this[a],l=0,s=t.length;s>l;l++)(e=t[l])&&(r=Object.create(e.__transition__[u]),r.delay+=r.duration,Ni(e,l,i,r)),n.push(e)}return Ei(o,i)},mo.svg.axis=function(){function n(n){n.each(function(){var n,l=mo.select(this),s=this.__chart__||e,f=this.__chart__=e.copy(),h=null==c?f.ticks?f.ticks.apply(f,a):f.domain():c,g=null==t?f.tickFormat?f.tickFormat.apply(f,a):dt:t,p=l.selectAll(".tick").data(h,f),d=p.enter().insert("g",".domain").attr("class","tick").style("opacity",Go),v=mo.transition(p.exit()).style("opacity",Go).remove(),m=mo.transition(p).style("opacity",1),y=Bu(f),M=l.selectAll(".domain").data([0]),x=(M.enter().append("path").attr("class","domain"),mo.transition(M));d.append("line"),d.append("text");var b=d.select("line"),_=m.select("line"),w=p.select("text").text(g),S=d.select("text"),E=m.select("text");switch(r){case"bottom":n=Ti,b.attr("y2",u),S.attr("y",Math.max(u,0)+o),_.attr("x2",0).attr("y2",u),E.attr("x",0).attr("y",Math.max(u,0)+o),w.attr("dy",".71em").style("text-anchor","middle"),x.attr("d","M"+y[0]+","+i+"V0H"+y[1]+"V"+i);break;case"top":n=Ti,b.attr("y2",-u),S.attr("y",-(Math.max(u,0)+o)),_.attr("x2",0).attr("y2",-u),E.attr("x",0).attr("y",-(Math.max(u,0)+o)),w.attr("dy","0em").style("text-anchor","middle"),x.attr("d","M"+y[0]+","+-i+"V0H"+y[1]+"V"+-i);break;case"left":n=qi,b.attr("x2",-u),S.attr("x",-(Math.max(u,0)+o)),_.attr("x2",-u).attr("y2",0),E.attr("x",-(Math.max(u,0)+o)).attr("y",0),w.attr("dy",".32em").style("text-anchor","end"),x.attr("d","M"+-i+","+y[0]+"H0V"+y[1]+"H"+-i);break;case"right":n=qi,b.attr("x2",u),S.attr("x",Math.max(u,0)+o),_.attr("x2",u).attr("y2",0),E.attr("x",Math.max(u,0)+o).attr("y",0),w.attr("dy",".32em").style("text-anchor","start"),x.attr("d","M"+i+","+y[0]+"H0V"+y[1]+"H"+i)}if(f.rangeBand){var k=f.rangeBand()/2,A=function(n){return f(n)+k};d.call(n,A),m.call(n,A)}else d.call(n,s),m.call(n,f),v.call(n,f)})}var t,e=mo.scale.linear(),r=Vc,u=6,i=6,o=3,a=[10],c=null;return n.scale=function(t){return arguments.length?(e=t,n):e},n.orient=function(t){return arguments.length?(r=t in Xc?t+"":Vc,n):r},n.ticks=function(){return arguments.length?(a=arguments,n):a},n.tickValues=function(t){return arguments.length?(c=t,n):c},n.tickFormat=function(e){return arguments.length?(t=e,n):t},n.tickSize=function(t){var e=arguments.length;return e?(u=+t,i=+arguments[e-1],n):u},n.innerTickSize=function(t){return arguments.length?(u=+t,n):u},n.outerTickSize=function(t){return arguments.length?(i=+t,n):i},n.tickPadding=function(t){return arguments.length?(o=+t,n):o},n.tickSubdivide=function(){return arguments.length&&n},n};var Vc="bottom",Xc={top:1,right:1,bottom:1,left:1};mo.svg.brush=function(){function n(i){i.each(function(){var i=mo.select(this).style("pointer-events","all").style("-webkit-tap-highlight-color","rgba(0,0,0,0)").on("mousedown.brush",u).on("touchstart.brush",u),o=i.selectAll(".background").data([0]);o.enter().append("rect").attr("class","background").style("visibility","hidden").style("cursor","crosshair"),i.selectAll(".extent").data([0]).enter().append("rect").attr("class","extent").style("cursor","move");var a=i.selectAll(".resize").data(v,dt);a.exit().remove(),a.enter().append("g").attr("class",function(n){return"resize "+n}).style("cursor",function(n){return $c[n]}).append("rect").attr("x",function(n){return/[ew]$/.test(n)?-3:null}).attr("y",function(n){return/^[ns]/.test(n)?-3:null}).attr("width",6).attr("height",6).style("visibility","hidden"),a.style("display",n.empty()?"none":null);var s,f=mo.transition(i),h=mo.transition(o);c&&(s=Bu(c),h.attr("x",s[0]).attr("width",s[1]-s[0]),e(f)),l&&(s=Bu(l),h.attr("y",s[0]).attr("height",s[1]-s[0]),r(f)),t(f)})}function t(n){n.selectAll(".resize").attr("transform",function(n){return"translate("+s[+/e$/.test(n)]+","+h[+/^s/.test(n)]+")"})}function e(n){n.select(".extent").attr("x",s[0]),n.selectAll(".extent,.n>rect,.s>rect").attr("width",s[1]-s[0])}function r(n){n.select(".extent").attr("y",h[0]),n.selectAll(".extent,.e>rect,.w>rect").attr("height",h[1]-h[0])}function u(){function u(){32==mo.event.keyCode&&(N||(M=null,q[0]-=s[1],q[1]-=h[1],N=2),f())}function g(){32==mo.event.keyCode&&2==N&&(q[0]+=s[1],q[1]+=h[1],N=0,f())}function v(){var n=mo.mouse(b),u=!1;x&&(n[0]+=x[0],n[1]+=x[1]),N||(mo.event.altKey?(M||(M=[(s[0]+s[1])/2,(h[0]+h[1])/2]),q[0]=s[+(n[0]<M[0])],q[1]=h[+(n[1]<M[1])]):M=null),k&&m(n,c,0)&&(e(S),u=!0),A&&m(n,l,1)&&(r(S),u=!0),u&&(t(S),w({type:"brush",mode:N?"move":"resize"}))}function m(n,t,e){var r,u,a=Bu(t),c=a[0],l=a[1],f=q[e],g=e?h:s,v=g[1]-g[0];return N&&(c-=f,l-=v+f),r=(e?d:p)?Math.max(c,Math.min(l,n[e])):n[e],N?u=(r+=f)+v:(M&&(f=Math.max(c,Math.min(l,2*M[e]-r))),r>f?(u=r,r=f):u=f),g[0]!=r||g[1]!=u?(e?o=null:i=null,g[0]=r,g[1]=u,!0):void 0}function y(){v(),S.style("pointer-events","all").selectAll(".resize").style("display",n.empty()?"none":null),mo.select("body").style("cursor",null),z.on("mousemove.brush",null).on("mouseup.brush",null).on("touchmove.brush",null).on("touchend.brush",null).on("keydown.brush",null).on("keyup.brush",null),T(),w({type:"brushend"})}var M,x,b=this,_=mo.select(mo.event.target),w=a.of(b,arguments),S=mo.select(b),E=_.datum(),k=!/^(n|s)$/.test(E)&&c,A=!/^(e|w)$/.test(E)&&l,N=_.classed("extent"),T=L(),q=mo.mouse(b),z=mo.select(_o).on("keydown.brush",u).on("keyup.brush",g);if(mo.event.changedTouches?z.on("touchmove.brush",v).on("touchend.brush",y):z.on("mousemove.brush",v).on("mouseup.brush",y),S.interrupt().selectAll("*").interrupt(),N)q[0]=s[0]-q[0],q[1]=h[0]-q[1];else if(E){var C=+/w$/.test(E),D=+/^n/.test(E);x=[s[1-C]-q[0],h[1-D]-q[1]],q[0]=s[C],q[1]=h[D]}else mo.event.altKey&&(M=q.slice());S.style("pointer-events","none").selectAll(".resize").style("display",null),mo.select("body").style("cursor",_.style("cursor")),w({type:"brushstart"}),v()}var i,o,a=g(n,"brushstart","brush","brushend"),c=null,l=null,s=[0,0],h=[0,0],p=!0,d=!0,v=Bc[0];return n.event=function(n){n.each(function(){var n=a.of(this,arguments),t={x:s,y:h,i:i,j:o},e=this.__chart__||t;this.__chart__=t,Oc?mo.select(this).transition().each("start.brush",function(){i=e.i,o=e.j,s=e.x,h=e.y,n({type:"brushstart"})}).tween("brush:brush",function(){var e=kr(s,t.x),r=kr(h,t.y);return i=o=null,function(u){s=t.x=e(u),h=t.y=r(u),n({type:"brush",mode:"resize"})}}).each("end.brush",function(){i=t.i,o=t.j,n({type:"brush",mode:"resize"}),n({type:"brushend"})}):(n({type:"brushstart"}),n({type:"brush",mode:"resize"}),n({type:"brushend"}))})},n.x=function(t){return arguments.length?(c=t,v=Bc[!c<<1|!l],n):c},n.y=function(t){return arguments.length?(l=t,v=Bc[!c<<1|!l],n):l},n.clamp=function(t){return arguments.length?(c&&l?(p=!!t[0],d=!!t[1]):c?p=!!t:l&&(d=!!t),n):c&&l?[p,d]:c?p:l?d:null},n.extent=function(t){var e,r,u,a,f;return arguments.length?(c&&(e=t[0],r=t[1],l&&(e=e[0],r=r[0]),i=[e,r],c.invert&&(e=c(e),r=c(r)),e>r&&(f=e,e=r,r=f),(e!=s[0]||r!=s[1])&&(s=[e,r])),l&&(u=t[0],a=t[1],c&&(u=u[1],a=a[1]),o=[u,a],l.invert&&(u=l(u),a=l(a)),u>a&&(f=u,u=a,a=f),(u!=h[0]||a!=h[1])&&(h=[u,a])),n):(c&&(i?(e=i[0],r=i[1]):(e=s[0],r=s[1],c.invert&&(e=c.invert(e),r=c.invert(r)),e>r&&(f=e,e=r,r=f))),l&&(o?(u=o[0],a=o[1]):(u=h[0],a=h[1],l.invert&&(u=l.invert(u),a=l.invert(a)),u>a&&(f=u,u=a,a=f))),c&&l?[[e,u],[r,a]]:c?[e,r]:l&&[u,a])},n.clear=function(){return n.empty()||(s=[0,0],h=[0,0],i=o=null),n},n.empty=function(){return!!c&&s[0]==s[1]||!!l&&h[0]==h[1]},mo.rebind(n,a,"on")};var $c={n:"ns-resize",e:"ew-resize",s:"ns-resize",w:"ew-resize",nw:"nwse-resize",ne:"nesw-resize",se:"nwse-resize",sw:"nesw-resize"},Bc=[["n","e","s","w","nw","ne","se","sw"],["e","w"],["n","s"],[]],Wc=mo.time={},Jc=Date,Gc=["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"];zi.prototype={getDate:function(){return this._.getUTCDate()},getDay:function(){return this._.getUTCDay()},getFullYear:function(){return this._.getUTCFullYear()},getHours:function(){return this._.getUTCHours()},getMilliseconds:function(){return this._.getUTCMilliseconds()},getMinutes:function(){return this._.getUTCMinutes()},getMonth:function(){return this._.getUTCMonth()},getSeconds:function(){return this._.getUTCSeconds()},getTime:function(){return this._.getTime()},getTimezoneOffset:function(){return 0},valueOf:function(){return this._.valueOf()},setDate:function(){Kc.setUTCDate.apply(this._,arguments)},setDay:function(){Kc.setUTCDay.apply(this._,arguments)},setFullYear:function(){Kc.setUTCFullYear.apply(this._,arguments)},setHours:function(){Kc.setUTCHours.apply(this._,arguments)},setMilliseconds:function(){Kc.setUTCMilliseconds.apply(this._,arguments)},setMinutes:function(){Kc.setUTCMinutes.apply(this._,arguments)},setMonth:function(){Kc.setUTCMonth.apply(this._,arguments)},setSeconds:function(){Kc.setUTCSeconds.apply(this._,arguments)},setTime:function(){Kc.setTime.apply(this._,arguments)}};var Kc=Date.prototype,Qc="%a %b %e %X %Y",nl="%m/%d/%Y",tl="%H:%M:%S",el=["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],rl=["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],ul=["January","February","March","April","May","June","July","August","September","October","November","December"],il=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];Wc.year=Ci(function(n){return n=Wc.day(n),n.setMonth(0,1),n},function(n,t){n.setFullYear(n.getFullYear()+t)},function(n){return n.getFullYear()}),Wc.years=Wc.year.range,Wc.years.utc=Wc.year.utc.range,Wc.day=Ci(function(n){var t=new Jc(2e3,0);return t.setFullYear(n.getFullYear(),n.getMonth(),n.getDate()),t},function(n,t){n.setDate(n.getDate()+t)},function(n){return n.getDate()-1}),Wc.days=Wc.day.range,Wc.days.utc=Wc.day.utc.range,Wc.dayOfYear=function(n){var t=Wc.year(n);return Math.floor((n-t-6e4*(n.getTimezoneOffset()-t.getTimezoneOffset()))/864e5)},Gc.forEach(function(n,t){n=n.toLowerCase(),t=7-t;var e=Wc[n]=Ci(function(n){return(n=Wc.day(n)).setDate(n.getDate()-(n.getDay()+t)%7),n},function(n,t){n.setDate(n.getDate()+7*Math.floor(t))},function(n){var e=Wc.year(n).getDay();return Math.floor((Wc.dayOfYear(n)+(e+t)%7)/7)-(e!==t)});Wc[n+"s"]=e.range,Wc[n+"s"].utc=e.utc.range,Wc[n+"OfYear"]=function(n){var e=Wc.year(n).getDay();return Math.floor((Wc.dayOfYear(n)+(e+t)%7)/7)}}),Wc.week=Wc.sunday,Wc.weeks=Wc.sunday.range,Wc.weeks.utc=Wc.sunday.utc.range,Wc.weekOfYear=Wc.sundayOfYear,Wc.format=ji;var ol=Hi(el),al=Fi(el),cl=Hi(rl),ll=Fi(rl),sl=Hi(ul),fl=Fi(ul),hl=Hi(il),gl=Fi(il),pl=/^%/,dl={"-":"",_:" ",0:"0"},vl={a:function(n){return rl[n.getDay()]},A:function(n){return el[n.getDay()]},b:function(n){return il[n.getMonth()]},B:function(n){return ul[n.getMonth()]},c:ji(Qc),d:function(n,t){return Pi(n.getDate(),t,2)},e:function(n,t){return Pi(n.getDate(),t,2)},H:function(n,t){return Pi(n.getHours(),t,2)},I:function(n,t){return Pi(n.getHours()%12||12,t,2)},j:function(n,t){return Pi(1+Wc.dayOfYear(n),t,3)},L:function(n,t){return Pi(n.getMilliseconds(),t,3)},m:function(n,t){return Pi(n.getMonth()+1,t,2)},M:function(n,t){return Pi(n.getMinutes(),t,2)},p:function(n){return n.getHours()>=12?"PM":"AM"},S:function(n,t){return Pi(n.getSeconds(),t,2)},U:function(n,t){return Pi(Wc.sundayOfYear(n),t,2)},w:function(n){return n.getDay()},W:function(n,t){return Pi(Wc.mondayOfYear(n),t,2)},x:ji(nl),X:ji(tl),y:function(n,t){return Pi(n.getFullYear()%100,t,2)},Y:function(n,t){return Pi(n.getFullYear()%1e4,t,4)},Z:ao,"%":function(){return"%"}},ml={a:Oi,A:Ri,b:Zi,B:Vi,c:Xi,d:no,e:no,H:eo,I:eo,j:to,L:io,m:Qi,M:ro,p:oo,S:uo,U:Ii,w:Yi,W:Ui,x:$i,X:Bi,y:Ji,Y:Wi,Z:Gi,"%":co},yl=/^\s*\d+/,Ml=mo.map({am:0,pm:1});ji.utc=lo;var xl=lo("%Y-%m-%dT%H:%M:%S.%LZ");ji.iso=Date.prototype.toISOString&&+new Date("2000-01-01T00:00:00.000Z")?so:xl,so.parse=function(n){var t=new Date(n);return isNaN(t)?null:t},so.toString=xl.toString,Wc.second=Ci(function(n){return new Jc(1e3*Math.floor(n/1e3))},function(n,t){n.setTime(n.getTime()+1e3*Math.floor(t))},function(n){return n.getSeconds()}),Wc.seconds=Wc.second.range,Wc.seconds.utc=Wc.second.utc.range,Wc.minute=Ci(function(n){return new Jc(6e4*Math.floor(n/6e4))},function(n,t){n.setTime(n.getTime()+6e4*Math.floor(t))},function(n){return n.getMinutes()}),Wc.minutes=Wc.minute.range,Wc.minutes.utc=Wc.minute.utc.range,Wc.hour=Ci(function(n){var t=n.getTimezoneOffset()/60;return new Jc(36e5*(Math.floor(n/36e5-t)+t))},function(n,t){n.setTime(n.getTime()+36e5*Math.floor(t))},function(n){return n.getHours()}),Wc.hours=Wc.hour.range,Wc.hours.utc=Wc.hour.utc.range,Wc.month=Ci(function(n){return n=Wc.day(n),n.setDate(1),n},function(n,t){n.setMonth(n.getMonth()+t)},function(n){return n.getMonth()}),Wc.months=Wc.month.range,Wc.months.utc=Wc.month.utc.range;var bl=[1e3,5e3,15e3,3e4,6e4,3e5,9e5,18e5,36e5,108e5,216e5,432e5,864e5,1728e5,6048e5,2592e6,7776e6,31536e6],_l=[[Wc.second,1],[Wc.second,5],[Wc.second,15],[Wc.second,30],[Wc.minute,1],[Wc.minute,5],[Wc.minute,15],[Wc.minute,30],[Wc.hour,1],[Wc.hour,3],[Wc.hour,6],[Wc.hour,12],[Wc.day,1],[Wc.day,2],[Wc.week,1],[Wc.month,1],[Wc.month,3],[Wc.year,1]],wl=[[ji("%Y"),Vt],[ji("%B"),function(n){return n.getMonth()}],[ji("%b %d"),function(n){return 1!=n.getDate()}],[ji("%a %d"),function(n){return n.getDay()&&1!=n.getDate()}],[ji("%I %p"),function(n){return n.getHours()}],[ji("%I:%M"),function(n){return n.getMinutes()}],[ji(":%S"),function(n){return n.getSeconds()}],[ji(".%L"),function(n){return n.getMilliseconds()}]],Sl=go(wl);_l.year=Wc.year,Wc.scale=function(){return fo(mo.scale.linear(),_l,Sl)};var El={range:function(n,t,e){return mo.range(+n,+t,e).map(ho)}},kl=_l.map(function(n){return[n[0].utc,n[1]]}),Al=[[lo("%Y"),Vt],[lo("%B"),function(n){return n.getUTCMonth()}],[lo("%b %d"),function(n){return 1!=n.getUTCDate()}],[lo("%a %d"),function(n){return n.getUTCDay()&&1!=n.getUTCDate()}],[lo("%I %p"),function(n){return n.getUTCHours()}],[lo("%I:%M"),function(n){return n.getUTCMinutes()}],[lo(":%S"),function(n){return n.getUTCSeconds()}],[lo(".%L"),function(n){return n.getUTCMilliseconds()}]],Nl=go(Al);return kl.year=Wc.year.utc,Wc.scale.utc=function(){return fo(mo.scale.linear(),kl,Nl)},mo.text=vt(function(n){return n.responseText}),mo.json=function(n,t){return mt(n,"application/json",po,t)},mo.html=function(n,t){return mt(n,"text/html",vo,t)},mo.xml=vt(function(n){return n.responseXML}),mo}();
\ No newline at end of file
diff --git a/airflow/www_rbac/static/dagre-d3.min.js b/airflow/www_rbac/static/dagre-d3.min.js
deleted file mode 100644
index 8d9ec3a5e31f6..0000000000000
--- a/airflow/www_rbac/static/dagre-d3.min.js
+++ /dev/null
@@ -1,2 +0,0 @@
-(function a(b,c,d){function e(g,h){if(!c[g]){if(!b[g]){var j=typeof require=="function"&&require;if(!h&&j)return j(g,!0);if(f)return f(g,!0);throw new Error("Cannot find module '"+g+"'")}var k=c[g]={exports:{}};b[g][0].call(k.exports,function(a){var c=b[g][1][a];return e(c?c:a)},k,k.exports,a,b,c,d)}return c[g].exports}var f=typeof require=="function"&&require;for(var g=0;g<d.length;g++)e(d[g]);return e})({1:[function(a,b,c){var d=self;d.dagreD3=a("./index")},{"./index":2}],2:[function(a,b,c){b.exports={Digraph:a("graphlib").Digraph,Graph:a("graphlib").Graph,Renderer:a("./lib/Renderer"),json:a("graphlib").converter.json,layout:a("dagre").layout,version:a("./lib/version"),debug:a("dagre").debug}},{"./lib/Renderer":3,"./lib/version":4,dagre:11,graphlib:29}],3:[function(a,b,c){function g(){this._layout=d(),this.drawNodes(l),this.drawEdgeLabels(m),this.drawEdgePaths(n),this.positionNodes(o),this.positionEdgeLabels(p),this.positionEdgePaths(u),this.zoomSetup(w),this.zoom(x),this.transition(v),this.postLayout(y),this.postRender(z),this.edgeInterpolate("bundle"),this.edgeTension(.95)}function h(a){var b=a.copy();return b.graph()===undefined&&b.graph({}),"arrowheadFix"in b.graph()||(b.graph().arrowheadFix=!0),b.nodes().forEach(function(a){var c=i(b.node(a));b.node(a,c),"label"in c||(c.label="")}),b.edges().forEach(function(a){var c=i(b.edge(a));b.edge(a,c),"label"in c||(c.label="")}),b}function i(a){var b={};for(var c in a)b[c]=a[c];return b}function j(a,b){var c=a.getBBox();b.width=c.width,b.height=c.height}function k(a,b){var c=b.run(a);return a.eachNode(function(a,b){c.node(a).label=b.label}),a.eachEdge(function(a,b,d,e){c.edge(a).label=e.label}),c}function l(a,b){var c=a.nodes().filter(function(b){return!M(a,b)}),d=b.selectAll("g.node").classed("enter",!1).data(c,function(a){return a});return d.selectAll("*").remove(),d.enter().append("g").style("opacity",0).attr("class","node enter"),d.each(function(b){var c=a.node(b),d=e.select(this);B(c,d,!0,10,10)}),this._transition(d.exit()).style("opacity",0).remove(),d}function m(a,b){var c=b.selectAll("g.edgeLabel").classed("enter",!1).data(a.edges(),function(a){return a});return c.selectAll("*").remove(),c.enter().append("g").style("opacity",0).attr("class","edgeLabel enter"),c.each(function(b){B(a.edge(b),e.select(this),!1,0,0)}),this._transition(c.exit()).style("opacity",0).remove(),c}function o(a,b){function c(b){var c=a.node(b);return"translate("+c.x+","+c.y+")"}b.filter(".enter").attr("transform",c),this._transition(b).style("opacity",1).attr("transform",c)}function p(a,b){function c(b){var c=a.edge(b),d=F(c.points);return"translate("+d.x+","+d.y+")"}b.filter(".enter").attr("transform",c),this._transition(b).style("opacity",1).attr("transform",c)}function q(a){return Object.prototype.toString.call(a)==="[object SVGEllipseElement]"}function r(a){return Object.prototype.toString.call(a)==="[object SVGCircleElement]"}function s(a){return Object.prototype.toString.call(a)==="[object SVGPolygonElement]"}function t(a,b,c){if(a.useDef){var d=c.select("defs #"+a.useDef).node();if(d){var e=d.childNodes[0];if(r(e)||q(e))return H(a,e,b);if(s(e))return L(a,e,b)}}return G(a,b)}function u(a,b,c){function g(b){var g=a.edge(b),h=a.node(a.incidentNodes(b)[0]),i=a.node(a.incidentNodes(b)[1]),j=g.points.slice(),k=j.length===0?i:j[0],l=j.length===0?h:j[j.length-1];return j.unshift(t(h,k,c)),j.push(t(i,l,c)),e.svg.line().x(function(a){return a.x}).y(function(a){return a.y}).interpolate(d).tension(f)(j)}var d=this._edgeInterpolate,f=this._edgeTension;b.filter(".enter").selectAll("path").attr("d",g),this._transition(b.selectAll("path")).attr("d",g).style("opacity",1)}function v(a){return a}function w(a,b){var c=b.property("ownerSVGElement");return c?c=e.select(c):c=b,c.select("rect.overlay").empty()&&(c.insert("rect",":first-child").attr("class","overlay").attr("width","100%").attr("height","100%").style("fill","none").style("pointer-events","all"),b=b.append("g").attr("class","zoom"),this._zoom&&c.call(this._zoom(a,b))),b}function x(a,b){return e.behavior.zoom().on("zoom",function(){b.attr("transform","translate("+e.event.translate+")scale("+e.event.scale+")")})}function y(){}function z(a,b){a.isDirected()&&A(b,"arrowhead").attr("fill","#333")}function A(a,b){var c=a.select("#"+b);if(!c.empty())return c;var d=a.select("defs");d.empty()&&(d=a.append("svg:defs"));var e=d.append("svg:marker").attr("id",b).attr("viewBox","0 0 10 10").attr("refX",8).attr("refY",5).attr("markerUnits","strokeWidth").attr("markerWidth",8).attr("markerHeight",5).attr("orient","auto");return e.append("svg:path").attr("d","M 0 0 L 10 5 L 0 10 z"),e}function B(a,b,c,d,e){if(a.useDef){b.append("use").attr("xlink:href","#"+a.useDef);return}var f=a.label,g=b.append("rect");a.width&&g.attr("width",a.width),a.height&&g.attr("height",a.height);var h=b.append("g"),i;f[0]==="<"?(C(f,h),d=e=0):(i=D(f,h,Math.floor(a.labelCols),a.labelCut),O(a.labelStyle,i));var j=h.node().getBBox();h.attr("transform","translate("+ -j.width/2+","+ -j.height/2+")");var k=b.node().getBBox();g.attr("rx",a.rx?a.rx:5).attr("ry",a.ry?a.ry:5).attr("x",-(k.width/2+d)).attr("y",-(k.height/2+e)).attr("width",k.width+2*d).attr("height",k.height+2*e).attr("fill","#fff"),c&&(O(a.style,g),a.fill&&g.style("fill",a.fill),a.stroke&&g.style("stroke",a.stroke),a["stroke-width"]&&g.style("stroke-width",a["stroke-width"]+"px"),a["stroke-dasharray"]&&g.style("stroke-dasharray",a["stroke-dasharray"]),a.href&&b.attr("class",b.attr("class")+" clickable").on("click",function(){window.open(a.href)}))}function C(a,b){var c=b.append("foreignObject").attr("width","100000"),d,e;c.append("xhtml:div").style("float","left").html(function(){return a}).each(function(){d=this.clientWidth,e=this.clientHeight}),c.attr("width",d).attr("height",e)}function D(a,b,c,d){d===undefined&&(d="false"),d=d.toString().toLowerCase()==="true";var e=b.append("text").attr("text-anchor","left");a=a.replace(/\\n/g,"\n");var f=c?E(a,c,d):a;f=f.split("\n");for(var g=0;g<f.length;g++)e.append("tspan").attr("dy","1em").attr("x","1").text(f[g]);return e}function E(a,b,c,d){d=d||"\n",b=b||75,c=c||!1;if(!a)return a;var e=".{1,"+b+"}(\\s|$)"+(c?"|.{"+b+"}|.+$":"|\\S+?(\\s|$)");return a.match(new RegExp(e,"g")).join(d)}function F(a){var b=a.length/2;if(a.length%2)return a[Math.floor(b)];var c=a[b-1],d=a[b];return{x:(c.x+d.x)/2,y:(c.y+d.y)/2}}function G(a,b){var c=a.x,d=a.y,e=b.x-c,f=b.y-d,g=a.width/2,h=a.height/2,i,j;return Math.abs(f)*g>Math.abs(e)*h?(f<0&&(h=-h),i=f===0?0:h*e/f,j=h):(e<0&&(g=-g),i=g,j=e===0?0:g*f/e),{x:c+i,y:d+j}}function H(a,b,c){var d=a.x,e=a.y,f,g;r(b)?f=g=b.r.baseVal.value:(f=b.rx.baseVal.value,g=b.ry.baseVal.value);var h=d-c.x,i=e-c.y,j=Math.sqrt(f*f*i*i+g*g*h*h),k=Math.abs(f*g*h/j);c.x<d&&(k=-k);var l=Math.abs(f*g*i/j);return c.y<e&&(l=-l),{x:d+k,y:e+l}}function I(a,b){return a*b>0}function J(a,b,c){c.some(function(c){return c[0]===a&&c[1]===b})||c.push([a,b])}function K(a,b,c,d,e,f,g,h,i){var j,k,l,m,n,o,p,q,r,s,t,u,v,w,x;j=d-b,l=a-c,n=c*b-a*d,r=j*e+l*f+n,s=j*g+l*h+n;if(r!==0&&s!==0&&I(r,s))return;k=h-f,m=e-g,o=g*f-e*h,p=k*a+m*b+o,q=k*c+m*d+o;if(p!==0&&q!==0&&I(p,q))return;t=j*m-k*l;if(t===0)return;u=Math.abs(t/2),v=l*o-m*n,w=v<0?(v-u)/t:(v+u)/t,v=k*n-j*o,x=v<0?(v-u)/t:(v+u)/t,J(w,x,i)}function L(a,b,c){var d=a.x,e=a.y,f=c.x,g=c.y,h=[],i=b.points,j=1e5,k=1e5;for(var l=0;l<i.numberOfItems;l++){var m=i.getItem(l);j=Math.min(j,m.x),k=Math.min(k,m.y)}var n=d-a.width/2-j,o=e-a.height/2-k;for(var p=0;p<i.numberOfItems;p++){var q=i.getItem(p),r=i.getItem(p<i.numberOfItems-1?p+1:0);K(d,e,f,g,n+q.x,o+q.y,n+r.x,o+r.y,h)}return h.length===1?{x:h[0][0],y:h[0][1]}:h.length>1?(h.sort(function(a,b){var d=a[0]-c.x,e=a[1]-c.y,f=Math.sqrt(d*d+e*e),g=b[0]-c.x,h=b[1]-c.y,i=Math.sqrt(g*g+h*h);return f<i?-1:f===i?0:1}),{x:h[0][0],y:h[0][1]}):(console.log("NO INTERSECTION FOUND, RETURN NODE CENTER",a),a)}function M(a,b){return"children"in a&&a.children(b).length}function N(a,b){return a.bind?a.bind(b):function(){return a.apply(b,arguments)}}function O(a,b){if(a){var c=b.attr("style")||"";b.attr("style",c+"; "+a)}}var d=a("dagre").layout,e;try{e=a("d3")}catch(f){e=window.d3}b.exports=g,g.prototype.layout=function(a){return arguments.length?(this._layout=a,this):this._layout},g.prototype.drawNodes=function(a){return arguments.length?(this._drawNodes=N(a,this),this):this._drawNodes},g.prototype.drawEdgeLabels=function(a){return arguments.length?(this._drawEdgeLabels=N(a,this),this):this._drawEdgeLabels},g.prototype.drawEdgePaths=function(a){return arguments.length?(this._drawEdgePaths=N(a,this),this):this._drawEdgePaths},g.prototype.positionNodes=function(a){return arguments.length?(this._positionNodes=N(a,this),this):this._positionNodes},g.prototype.positionEdgeLabels=function(a){return arguments.length?(this._positionEdgeLabels=N(a,this),this):this._positionEdgeLabels},g.prototype.positionEdgePaths=function(a){return arguments.length?(this._positionEdgePaths=N(a,this),this):this._positionEdgePaths},g.prototype.transition=function(a){return arguments.length?(this._transition=N(a,this),this):this._transition},g.prototype.zoomSetup=function(a){return arguments.length?(this._zoomSetup=N(a,this),this):this._zoomSetup},g.prototype.zoom=function(a){return arguments.length?(a?this._zoom=N(a,this):delete this._zoom,this):this._zoom},g.prototype.postLayout=function(a){return arguments.length?(this._postLayout=N(a,this),this):this._postLayout},g.prototype.postRender=function(a){return arguments.length?(this._postRender=N(a,this),this):this._postRender},g.prototype.edgeInterpolate=function(a){return arguments.length?(this._edgeInterpolate=a,this):this._edgeInterpolate},g.prototype.edgeTension=function(a){return arguments.length?(this._edgeTension=a,this):this._edgeTension},g.prototype.run=function(a,b){a=h(a);var c=this._zoomSetup(a,b);c.selectAll("g.edgePaths, g.edgeLabels, g.nodes").data(["edgePaths","edgeLabels","nodes"]).enter().append("g").attr("class",function(a){return a});var d=this._drawNodes(a,c.select("g.nodes")),e=this._drawEdgeLabels(a,c.select("g.edgeLabels"));d.each(function(b){j(this,a.node(b))}),e.each(function(b){j(this,a.edge(b))});var f=k(a,this._layout);a.eachNode(function(a,b){b.useDef&&(f.node(a).useDef=b.useDef)}),this._postLayout(f,c);var g=this._drawEdgePaths(a,c.select("g.edgePaths"));return this._positionNodes(f,d),this._positionEdgeLabels(f,e),this._positionEdgePaths(f,g,b),this._postRender(f,c),f};var n=function(a,b){var c=b.selectAll("g.edgePath").classed("enter",!1).data(a.edges(),function(a){return a}),d="url(#arrowhead)",f=d;return a.isDirected()?a.graph().arrowheadFix!=="false"&&a.graph().arrowheadFix!==!1&&(f=function(){var a=e.select(this).style("stroke");if(a){var c="arrowhead-"+a.replace(/[^a-zA-Z0-9]/g,"_");return A(b,c).style("fill",a),"url(#"+c+")"}return d}):f=null,c.enter().append("g").attr("class","edgePath enter").append("path").style("opacity",0),c.selectAll("path").each(function(b){O(a.edge(b).style,e.select(this))}).attr("marker-end",f),this._transition(c.exit()).style("opacity",0).remove(),c}},{d3:10,dagre:11}],4:[function(a,b,c){b.exports="0.2.9"},{}],5:[function(a,b,c){c.Set=a("./lib/Set"),c.PriorityQueue=a("./lib/PriorityQueue"),c.version=a("./lib/version")},{"./lib/PriorityQueue":6,"./lib/Set":7,"./lib/version":9}],6:[function(a,b,c){function d(){this._arr=[],this._keyIndices={}}b.exports=d,d.prototype.size=function(){return this._arr.length},d.prototype.keys=function(){return this._arr.map(function(a){return a.key})},d.prototype.has=function(a){return a in this._keyIndices},d.prototype.priority=function(a){var b=this._keyIndices[a];if(b!==undefined)return this._arr[b].priority},d.prototype.min=function(){if(this.size()===0)throw new Error("Queue underflow");return this._arr[0].key},d.prototype.add=function(a,b){var c=this._keyIndices;if(a in c)return!1;var d=this._arr,e=d.length;return c[a]=e,d.push({key:a,priority:b}),this._decrease(e),!0},d.prototype.removeMin=function(){this._swap(0,this._arr.length-1);var a=this._arr.pop();return delete this._keyIndices[a.key],this._heapify(0),a.key},d.prototype.decrease=function(a,b){var c=this._keyIndices[a];if(b>this._arr[c].priority)throw new Error("New priority is greater than current priority. Key: "+a+" Old: "+this._arr[c].priority+" New: "+b);this._arr[c].priority=b,this._decrease(c)},d.prototype._heapify=function(a){var b=this._arr,c=2*a,d=c+1,e=a;c<b.length&&(e=b[c].priority<b[e].priority?c:e,d<b.length&&(e=b[d].priority<b[e].priority?d:e),e!==a&&(this._swap(a,e),this._heapify(e)))},d.prototype._decrease=function(a){var b=this._arr,c=b[a].priority,d;while(a!==0){d=a>>1;if(b[d].priority<c)break;this._swap(a,d),a=d}},d.prototype._swap=function(a,b){var c=this._arr,d=this._keyIndices,e=c[a],f=c[b];c[a]=f,c[b]=e,d[f.key]=a,d[e.key]=b}},{}],7:[function(a,b,c){function e(a){this._size=0,this._keys={};if(a)for(var b=0,c=a.length;b<c;++b)this.add(a[b])}function f(a){var b=Object.keys(a),c=b.length,d=new Array(c),e;for(e=0;e<c;++e)d[e]=a[b[e]];return d}var d=a("./util");b.exports=e,e.intersect=function(a){if(a.length===0)return new e;var b=new e(d.isArray(a[0])?a[0]:a[0].keys());for(var c=1,f=a.length;c<f;++c){var g=b.keys(),h=d.isArray(a[c])?new e(a[c]):a[c];for(var i=0,j=g.length;i<j;++i){var k=g[i];h.has(k)||b.remove(k)}}return b},e.union=function(a){var b=d.reduce(a,function(a,b){return a+(b.size?b.size():b.length)},0),c=new Array(b),f=0;for(var g=0,h=a.length;g<h;++g){var i=a[g],j=d.isArray(i)?i:i.keys();for(var k=0,l=j.length;k<l;++k)c[f++]=j[k]}return new e(c)},e.prototype.size=function(){return this._size},e.prototype.keys=function(){return f(this._keys)},e.prototype.has=function(a){return a in this._keys},e.prototype.add=function(a){return a in this._keys?!1:(this._keys[a]=a,++this._size,!0)},e.prototype.remove=function(a){return a in this._keys?(delete this._keys[a],--this._size,!0):!1}},{"./util":8}],8:[function(a,b,c){Array.isArray?c.isArray=Array.isArray:c.isArray=function(a){return Object.prototype.toString.call(a)==="[object Array]"},"function"!=typeof Array.prototype.reduce?c.reduce=function(a,b,c){"use strict";if(null===a||"undefined"==typeof a)throw new TypeError("Array.prototype.reduce called on null or undefined");if("function"!=typeof b)throw new TypeError(b+" is not a function");var d,e,f=a.length>>>0,g=!1;1<arguments.length&&(e=c,g=!0);for(d=0;f>d;++d)a.hasOwnProperty(d)&&(g?e=b(e,a[d],d,a):(e=a[d],g=!0));if(!g)throw new TypeError("Reduce of empty array with no initial value");return e}:c.reduce=function(a,b,c){return a.reduce(b,c)}},{}],9:[function(a,b,c){b.exports="1.1.3"},{}],10:[function(a,b,c){a("./d3"),b.exports=d3,function(){delete this.d3}()},{}],11:[function(a,b,c){c.Digraph=a("graphlib").Digraph,c.Graph=a("graphlib").Graph,c.layout=a("./lib/layout"),c.version=a("./lib/version"),c.debug=a("./lib/debug")},{"./lib/debug":12,"./lib/layout":13,"./lib/version":28,graphlib:29}],12:[function(a,b,c){"use strict";var d=a("./util");c.dotOrdering=function(a){function e(b){var d=a.children(b);d.length?(c+="subgraph cluster_"+b+" {",c+='label="'+b+'";',d.forEach(function(a){e(a)}),c+="}"):(c+=b,a.node(b).dummy&&(c+=" [shape=diamond]"),c+=";")}var b=d.ordering(a.filterNodes(d.filterNonSubgraphs(a))),c="digraph {";return a.children(null).forEach(e),b.forEach(function(a){c+='subgraph { rank=same; edge [style="invis"];',c+=a.join("->"),c+="}"}),a.eachEdge(function(a,b,d){c+=b+"->"+d+";"}),c+="}",c}},{"./util":27}],13:[function(a,b,c){"use strict";var d=a("./util"),e=a("./rank"),f=a("./order"),g=a("graphlib").CGraph,h=a("graphlib").CDigraph;b.exports=function(){function j(a){var c=new h;a.eachNode(function(a,b){b===undefined&&(b={}),c.addNode(a,{width:b.width,height:b.height}),b.hasOwnProperty("rank")&&(c.node(a).prefRank=b.rank)}),a.parent&&a.nodes().forEach(function(b){c.parent(b,a.parent(b))}),a.eachEdge(function(a,b,d,e){e===undefined&&(e={});var f={e:a,minLen:e.minLen||1,width:e.width||0,height:e.height||0,points:[]};c.addEdge(null,b,d,f)});var d=a.graph()||{};return c.graph({rankDir:d.rankDir||b.rankDir,orderRestarts:d.orderRestarts}),c}function k(a){var g=i.rankSep(),h;try{return h=d.time("initLayoutGraph",j)(a),h.order()===0?h:(h.eachEdge(function(a,b,c,d){d.minLen*=2}),i.rankSep(g/2),d.time("rank.run",e.run)(h,b.rankSimplex),d.time("normalize",l)(h),d.time("order",f)(h,b.orderMaxSweeps),d.time("position",c.run)(h),d.time("undoNormalize",m)(h),d.time("fixupEdgePoints",n)(h),d.time("rank.restoreEdges",e.restoreEdges)(h),d.time("createFinalGraph",o)(h,a.isDirected()))}finally{i.rankSep(g)}}function l(a){var b=0;a.eachEdge(function(c,d,e,f){var g=a.node(d).rank,h=a.node(e).rank;if(g+1<h){for(var i=d,j=g+1,k=0;j<h;++j,++k){var l="_D"+ ++b,m={width:f.width,height:f.height,edge:{id:c,source:d,target:e,attrs:f},rank:j,dummy:!0};k===0?m.index=0:j+1===h&&(m.index=1),a.addNode(l,m),a.addEdge(null,i,l,{}),i=l}a.addEdge(null,i,e,{}),a.delEdge(c)}})}function m(a){a.eachNode(function(b,c){if(c.dummy){if("index"in c){var d=c.edge;a.hasEdge(d.id)||a.addEdge(d.id,d.source,d.target,d.attrs);var e=a.edge(d.id).points;e[c.index]={x:c.x,y:c.y,ul:c.ul,ur:c.ur,dl:c.dl,dr:c.dr}}a.delNode(b)}})}function n(a){a.eachEdge(function(a,b,c,d){d.reversed&&d.points.reverse()})}function o(a,b){var c=b?new h:new g;c.graph(a.graph()),a.eachNode(function(a,b){c.addNode(a,b)}),a.eachNode(function(b){c.parent(b,a.parent(b))}),a.eachEdge(function(a,b,d,e){c.addEdge(e.e,b,d,e)});var d=0,e=0;return a.eachNode(function(b,c){a.children(b).length||(d=Math.max(d,c.x+c.width/2),e=Math.max(e,c.y+c.height/2))}),a.eachEdge(function(a,b,c,f){var g=Math.max.apply(Math,f.points.map(function(a){return a.x})),h=Math.max.apply(Math,f.points.map(function(a){return a.y}));d=Math.max(d,g+f.width/2),e=Math.max(e,h+f.height/2)}),c.graph().width=d,c.graph().height=e,c}function p(a){return function(){return arguments.length?(a.apply(null,arguments),i):a()}}var b={debugLevel:0,orderMaxSweeps:f.DEFAULT_MAX_SWEEPS,rankSimplex:!1,rankDir:"TB"},c=a("./position")(),i={};return i.orderIters=d.propertyAccessor(i,b,"orderMaxSweeps"),i.rankSimplex=d.propertyAccessor(i,b,"rankSimplex"),i.nodeSep=p(c.nodeSep),i.edgeSep=p(c.edgeSep),i.universalSep=p(c.universalSep),i.rankSep=p(c.rankSep),i.rankDir=d.propertyAccessor(i,b,"rankDir"),i.debugAlignment=p(c.debugAlignment),i.debugLevel=d.propertyAccessor(i,b,"debugLevel",function(a){d.log.level=a,c.debugLevel(a)}),i.run=d.time("Total layout",k),i._normalize=l,i}},{"./order":14,"./position":19,"./rank":20,"./util":27,graphlib:29}],14:[function(a,b,c){function j(a,b){function o(){a.eachNode(function(a,b){n[a]=b.order})}arguments.length<2&&(b=i);var c=a.graph().orderRestarts||0,h=f(a);h.forEach(function(b){b=b.filterNodes(function(b){return!a.children(b).length})});var j=0,k,l=Number.MAX_VALUE,n={};for(var p=0;p<Number(c)+1&&l!==0;++p){k=Number.MAX_VALUE,g(a,c>0),d.log(2,"Order phase start cross count: "+a.graph().orderInitCC);var q,r,s;for(q=0,r=0;r<4&&q<b&&k>0;++q,++r,++j)m(a,h,q),s=e(a),s<k&&(r=0,k=s,s<l&&(o(),l=s)),d.log(3,"Order phase start "+p+" iter "+q+" cross count: "+s)}Object.keys(n).forEach(function(b){if(!a.children||!a.children(b).length)a.node(b).order=n[b]}),a.graph().orderCC=l,d.log(2,"Order iterations: "+j),d.log(2,"Order phase best cross count: "+a.graph().orderCC)}function k(a,b){var c={};return b.forEach(function(b){c[b]=a.inEdges(b).map(function(b){return a.node(a.source(b)).order})}),c}function l(a,b){var c={};return b.forEach(function(b){c[b]=a.outEdges(b).map(function(b){return a.node(a.target(b)).order})}),c}function m(a,b,c){c%2===0?n(a,b,c):o(a,b,c)}function n(a,b){var c;for(var d=1;d<b.length;++d)c=h(b[d],c,k(a,b[d].nodes()))}function o(a,b){var c;for(var d=b.length-2;d>=0;--d)h(b[d],c,l(a,b[d].nodes()))}"use strict";var d=a("./util"),e=a("./order/crossCount"),f=a("./order/initLayerGraphs"),g=a("./order/initOrder"),h=a("./order/sortLayer");b.exports=j;var i=24;j.DEFAULT_MAX_SWEEPS=i},{"./order/crossCount":15,"./order/initLayerGraphs":16,"./order/initOrder":17,"./order/sortLayer":18,"./util":27}],15:[function(a,b,c){function e(a){var b=0,c=d.ordering(a);for(var e=1;e<c.length;++e)b+=f(a,c[e-1],c[e]);return b}function f(a,b,c){var d=[];b.forEach(function(b){var c=[];a.outEdges(b).forEach(function(b){c.push(a.node(a.target(b)).order)}),c.sort(function(a,b){return a-b}),d=d.concat(c)});var e=1;while(e<c.length)e<<=1;var f=2*e-1;e-=1;var g=[];for(var h=0;h<f;++h)g[h]=0;var i=0;return d.forEach(function(a){var b=a+e;++g[b];while(b>0)b%2&&(i+=g[b+1]),b=b-1>>1,++g[b]}),i}"use strict";var d=a("../util");b.exports=e},{"../util":27}],16:[function(a,b,c){function f(a){function c(d){if(d===null){a.children(d).forEach(function(a){c(a)});return}var f=a.node(d);f.minRank="rank"in f?f.rank:Number.MAX_VALUE,f.maxRank="rank"in f?f.rank:Number.MIN_VALUE;var h=new e;return a.children(d).forEach(function(b){var d=c(b);h=e.union([h,d]),f.minRank=Math.min(f.minRank,a.node(b).minRank),f.maxRank=Math.max(f.maxRank,a.node(b).maxRank)}),"rank"in f&&h.add(f.rank),h.keys().forEach(function(a){a in b||(b[a]=[]),b[a].push(d)}),h}var b=[];c(null);var f=[];return b.forEach(function(b,c){f[c]=a.filterNodes(d(b))}),f}"use strict";var d=a("graphlib").filter.nodesFromList,e=a("cp-data").Set;b.exports=f},{"cp-data":5,graphlib:29}],17:[function(a,b,c){function f(a,b){var c=[];a.eachNode(function(b,d){var e=c[d.rank];if(a.children&&a.children(b).length>0)return;e||(e=c[d.rank]=[]),e.push(b)}),c.forEach(function(c){b&&e.shuffle(c),c.forEach(function(b,c){a.node(b).order=c})});var f=d(a);a.graph().orderInitCC=f,a.graph().orderCC=Number.MAX_VALUE}"use strict";var d=a("./crossCount"),e=a("../util");b.exports=f},{"../util":27,"./crossCount":15}],18:[function(a,b,c){function h(a,b,c){c=n(a,c);var d=i(a,null,b,c);return d.list.forEach(function(b,c){a.node(b).order=c}),d.constraintGraph}function i(a,b,c,f){c=c?c.filterNodes(g(a.children(b))):new e;var h={};a.children(b).forEach(function(b){if(a.children(b).length)h[b]=i(a,b,c,f),h[b].firstSG=b,h[b].lastSG=b;else{var e=f[b];h[b]={degree:e.length,barycenter:d.sum(e)/e.length,order:a.node(b).order,orderCount:1,list:[b]}}}),l(a,c,h);var k=Object.keys(h);k.sort(function(a,b){return h[a].barycenter-h[b].barycenter||h[a].order-h[b].order});var m=k.map(function(a){return h[a]}).reduce(function(b,c){return j(a,b,c)});return m}function j(a,b,c){var d=k(b.constraintGraph,c.constraintGraph);return b.lastSG!==undefined&&c.firstSG!==undefined&&(d===undefined&&(d=new e),d.hasNode(b.lastSG)||d.addNode(b.lastSG),d.addNode(c.firstSG),d.addEdge(null,b.lastSG,c.firstSG)),{degree:b.degree+c.degree,barycenter:(b.barycenter*b.degree+c.barycenter*c.degree)/(b.degree+c.degree),order:(b.order*b.orderCount+c.order*c.orderCount)/(b.orderCount+c.orderCount),orderCount:b.orderCount+c.orderCount,list:b.list.concat(c.list),firstSG:b.firstSG!==undefined?b.firstSG:c.firstSG,lastSG:c.lastSG!==undefined?c.lastSG:b.lastSG,constraintGraph:d}}function k(a,b){return a===undefined?b:b===undefined?a:(a=a.copy(),b.nodes().forEach(function(b){a.addNode(b)}),b.edges().forEach(function(b,c,d){a.addEdge(null,c,d)}),a)}function l(a,b,c){function d(a,c,d){b.inEdges(a).forEach(function(a){b.delEdge(a),b.addEdge(null,b.source(a),d)}),b.outEdges(c).forEach(function(a){b.delEdge(a),b.addEdge(null,d,b.target(a))}),b.delNode(a),b.delNode(c)}var e;while((e=m(b,c))!==undefined){var f=b.source(e),g=b.target(e),h;while((h=b.addNode(null))&&a.hasNode(h))b.delNode(h);c[h]=j(a,c[f],c[g]),delete c[f],delete c[g],d(f,g,h),b.incidentEdges(h).length===0&&b.delNode(h)}}function m(a,b){var c=f(a);for(var d=0;d<c.length;++d){var e=c[d],g=a.inEdges(e);for(var h=0;h<g.length;++h){var i=g[h];if(b[a.source(i)].barycenter>=b[e].barycenter)return i}}}function n(a,b){var c=Number.MAX_VALUE,e=0,f={};a.eachNode(function(f){if(a.children(f).length)return;var g=b[f];g.length&&(c=Math.min(c,d.min(g)),e=Math.max(e,d.max(g)))});var g=e-c;return a.eachNode(function(d){if(a.children(d).length)return;var e=b[d];e.length?f[d]=e.map(function(b){return g?(b-c)*(a.order()-1)/g:a.order()-.5}):f[d]=[a.node(d).order]}),f}"use strict";var d=a("../util"),e=a("graphlib").Digraph,f=a("graphlib").alg.topsort,g=a("graphlib").filter.nodesFromList;b.exports=h},{"../util":27,graphlib:29}],19:[function(a,b,c){"use strict";var d=a("./util");b.exports=function(){function c(b){b=b.filterNodes(d.filterNonSubgraphs(b));var c=d.ordering(b),e=f(b,c),i={};["u","d"].forEach(function(d){d==="d"&&c.reverse(),["l","r"].forEach(function(f){f==="r"&&m(c);var j=d+f,k=g(b,c,e,d==="u"?"predecessors":"successors");i[j]=h(b,c,k.pos,k.root,k.align),a.debugLevel>=3&&t(d+f,b,c,i[j]),f==="r"&&l(i[j]),f==="r"&&m(c)}),d==="d"&&c.reverse()}),k(b,c,i),b.eachNode(function(a){var c=[];for(var d in i){var e=i[d][a];r(d,b,a,e),c.push(e)}c.sort(function(a,b){return a-b}),q(b,a,(c[1]+c[2])/2)});var j=0,p=b.graph().rankDir==="BT"||b.graph().rankDir==="RL";c.forEach(function(c){var e=d.max(c.map(function(a){return o(b,a)}));j+=e/2,c.forEach(function(a){s(b,a,p?-j:j)}),j+=e/2+a.rankSep});var u=d.min(b.nodes().map(function(a){return q(b,a)-n(b,a)/2})),v=d.min(b.nodes().map(function(a){return s(b,a)-o(b,a)/2}));b.eachNode(function(a){q(b,a,q(b,a)-u),s(b,a,s(b,a)-v)})}function e(a,b){return a<b?a.toString().length+":"+a+"-"+b:b.toString().length+":"+b+"-"+a}function f(a,b){function k(a){var b=d[a];if(b<h||b>j)c[e(g[i],a)]=!0}var c={},d={},f,g,h,i,j;if(b.length<=2)return c;b[1].forEach(function(a,b){d[a]=b});for(var l=1;l<b.length-1;++l){f=b[l],g=b[l+1],h=0,i=0;for(var m=0;m<g.length;++m){var n=g[m];d[n]=m,j=undefined;if(a.node(n).dummy){var o=a.predecessors(n)[0];o!==undefined&&a.node(o).dummy&&(j=d[o])}j===undefined&&m===g.length-1&&(j=f.length-1);if(j!==undefined){for(;i<=m;++i)a.predecessors(g[i]).forEach(k);h=j}}}return c}function g(a,b,c,d){var f={},g={},h={};return b.forEach(function(a){a.forEach(function(a,b){g[a]=a,h[a]=a,f[a]=b})}),b.forEach(function(b){var i=-1;b.forEach(function(b){var j=a[d](b),k;j.length>0&&(j.sort(function(a,b){return f[a]-f[b]}),k=(j.length-1)/2,j.slice(Math.floor(k),Math.ceil(k)+1).forEach(function(a){h[b]===b&&!c[e(a,b)]&&i<f[a]&&(h[a]=b,h[b]=g[b]=g[a],i=f[a])}))})}),{pos:f,root:g,align:h}}function h(a,b,c,e,f){function l(a,b,c){b in h[a]?h[a][b]=Math.min(h[a][b],c):h[a][b]=c}function m(b){if(!(b in k)){k[b]=0;var d=b;do{if(c[d]>0){var h=e[j[d]];m(h),g[b]===b&&(g[b]=g[h]);var i=p(a,j[d])+p(a,d);g[b]!==g[h]?l(g[h],g[b],k[b]-k[h]-i):k[b]=Math.max(k[b],k[h]+i)}d=f[d]}while(d!==b)}}var g={},h={},i={},j={},k={};return b.forEach(function(a){a.forEach(function(b,c){g[b]=b,h[b]={},c>0&&(j[b]=a[c-1])})}),d.values(e).forEach(function(a){m(a)}),b.forEach(function(a){a.forEach(function(a){k[a]=k[e[a]];if(a===e[a]&&a===g[a]){var b=0;a in h&&Object.keys(h[a]).length>0&&(b=d.min(Object.keys(h[a]).map(function(b){return h[a][b]+(b in i?i[b]:0)}))),i[a]=b}})}),b.forEach(function(a){a.forEach(function(a){k[a]+=i[g[e[a]]]||0})}),k}function i(a,b,c){return d.min(b.map(function(a){var b=a[0];return c[b]}))}function j(a,b,c){return d.max(b.map(function(a){var b=a[a.length-1];return c[b]}))}function k(a,b,c){function h(a){c[l][a]+=g[l]}var d={},e={},f,g={},k=Number.POSITIVE_INFINITY;for(var l in c){var m=c[l];d[l]=i(a,b,m),e[l]=j(a,b,m);var n=e[l]-d[l];n<k&&(k=n,f=l)}["u","d"].forEach(function(a){["l","r"].forEach(function(b){var c=a+b;g[c]=b==="l"?d[f]-d[c]:e[f]-e[c]})});for(l in c)a.eachNode(h)}function l(a){for(var b in a)a[b]=-a[b]}function m(a){a.forEach(function(a){a.reverse()})}function n(a,b){switch(a.graph().rankDir){case"LR":return a.node(b).height;case"RL":return a.node(b).height;default:return a.node(b).width}}function o(a,b){switch(a.graph().rankDir){case"LR":return a.node(b).width;case"RL":return a.node(b).width;default:return a.node(b).height}}function p(b,c){if(a.universalSep!==null)return a.universalSep;var d=n(b,c),e=b.node(c).dummy?a.edgeSep:a.nodeSep;return(d+e)/2}function q(a,b,c){if(a.graph().rankDir==="LR"||a.graph().rankDir==="RL"){if(arguments.length<3)return a.node(b).y;a.node(b).y=c}else{if(arguments.length<3)return a.node(b).x;a.node(b).x=c}}function r(a,b,c,d){if(b.graph().rankDir==="LR"||b.graph().rankDir==="RL"){if(arguments.length<3)return b.node(c)[a];b.node(c)[a]=d}else{if(arguments.length<3)return b.node(c)[a];b.node(c)[a]=d}}function s(a,b,c){if(a.graph().rankDir==="LR"||a.graph().rankDir==="RL"){if(arguments.length<3)return a.node(b).x;a.node(b).x=c}else{if(arguments.length<3)return a.node(b).y;a.node(b).y=c}}function t(a,b,c,d){c.forEach(function(c,e){var f,g;c.forEach(function(c){var h=d[c];if(f){var i=p(b,f)+p(b,c);h-g<i&&console.log("Position phase: sep violation. Align: "+a+". Layer: "+e+". "+"U: "+f+" V: "+c+". Actual sep: "+(h-g)+" Expected sep: "+i)}f=c,g=h})})}var a={nodeSep:50,edgeSep:10,universalSep:null,rankSep:30},b={};return b.nodeSep=d.propertyAccessor(b,a,"nodeSep"),b.edgeSep=d.propertyAccessor(b,a,"edgeSep"),b.universalSep=d.propertyAccessor(b,a,"universalSep"),b.rankSep=d.propertyAccessor(b,a,"rankSep"),b.debugLevel=d.propertyAccessor(b,a,"debugLevel"),b.run=c,b}},{"./util":27}],20:[function(a,b,c){function l(a,b){n(a),d.time("constraints.apply",h.apply)(a),o(a),d.time("acyclic",e)(a);var c=a.filterNodes(d.filterNonSubgraphs(a));f(c),j(c).forEach(function(a){var d=c.filterNodes(k.nodesFromList(a));r(d,b)}),d.time("constraints.relax",h.relax(a)),d.time("reorientEdges",q)(a)}function m(a){e.undo(a)}function n(a){a.eachEdge(function(b,c,d,e){if(c===d){var f=p(a,b,c,d,e,0,!1),g=p(a,b,c,d,e,1,!0),h=p(a,b,c,d,e,2,!1);a.addEdge(null,f,c,{minLen:1,selfLoop:!0}),a.addEdge(null,f,g,{minLen:1,selfLoop:!0}),a.addEdge(null,c,h,{minLen:1,selfLoop:!0}),a.addEdge(null,g,h,{minLen:1,selfLoop:!0}),a.delEdge(b)}})}function o(a){a.eachEdge(function(b,c,d,e){if(c===d){var f=e.originalEdge,g=p(a,f.e,f.u,f.v,f.value,0,!0);a.addEdge(null,c,g,{minLen:1}),a.addEdge(null,g,d,{minLen:1}),a.delEdge(b)}})}function p(a,b,c,d,e,f,g){return a.addNode(null,{width:g?e.width:0,height:g?e.height:0,edge:{id:b,source:c,target:d,attrs:e},dummy:!0,index:f})}function q(a){a.eachEdge(function(b,c,d,e){a.node(c).rank>a.node(d).rank&&(a.delEdge(b),e.reversed=!0,a.addEdge(b,d,c,e))})}function r(a,b){var c=g(a);b&&(d.log(1,"Using network simplex for ranking"),i(a,c)),s(a)}function s(a){var b=d.min(a.nodes().map(function(b){return a.node(b).rank}));a.eachNode(function(a,c){c.rank-=b})}"use strict";var d=a("./util"),e=a("./rank/acyclic"),f=a("./rank/initRank"),g=a("./rank/feasibleTree"),h=a("./rank/constraints"),i=a("./rank/simplex"),j=a("graphlib").alg.components,k=a("graphlib").filter;c.run=l,c.restoreEdges=m},{"./rank/acyclic":21,"./rank/constraints":22,"./rank/feasibleTree":23,"./rank/initRank":24,"./rank/simplex":26,"./util":27,graphlib:29}],21:[function(a,b,c){function e(a){function f(d){if(d in c)return;c[d]=b[d]=!0,a.outEdges(d).forEach(function(c){var h=a.target(c),i;d===h?console.error('Warning: found self loop "'+c+'" for node "'+d+'"'):h in b?(i=a.edge(c),a.delEdge(c),i.reversed=!0,++e,a.addEdge(c,h,d,i)):f(h)}),delete b[d]}var b={},c={},e=0;return a.eachNode(function(a){f(a)}),d.log(2,"Acyclic Phase: reversed "+e+" edge(s)"),e}function f(a){a.eachEdge(function(b,c,d,e){e.reversed&&(delete e.reversed,a.delEdge(b),a.addEdge(b,d,c,e))})}"use strict";var d=a("../util");b.exports=e,b.exports.undo=f},{"../util":27}],22:[function(a,b,c){function d(a){return a!=="min"&&a!=="max"&&a.indexOf("same_")!==0?(console.error("Unsupported rank type: "+a),!1):!0}function e(a,b,c,d){a.inEdges(b).forEach(function(b){var e=a.edge(b),f;e.originalEdge?f=e:f={originalEdge:{e:b,u:a.source(b),v:a.target(b),value:e},minLen:a.edge(b).minLen},e.selfLoop&&(d=!1),d?(a.addEdge(null,c,a.source(b),f),f.reversed=!0):a.addEdge(null,a.source(b),c,f)})}function f(a,b,c,d){a.outEdges(b).forEach(function(b){var e=a.edge(b),f;e.originalEdge?f=e:f={originalEdge:{e:b,u:a.source(b),v:a.target(b),value:e},minLen:a.edge(b).minLen},e.selfLoop&&(d=!1),d?(a.addEdge(null,a.target(b),c,f),f.reversed=!0):a.addEdge(null,c,a.target(b),f)})}function g(a,b,c){c!==undefined&&a.children(b).forEach(function(b){b!==c&&!a.outEdges(c,b).length&&!a.node(b).dummy&&a.addEdge(null,c,b,{minLen:0})})}function h(a,b,c){c!==undefined&&a.children(b).forEach(function(b){b!==c&&!a.outEdges(b,c).length&&!a.node(b).dummy&&a.addEdge(null,b,c,{minLen:0})})}"use strict",c.apply=function(a){function b(c){var i={};a.children(c).forEach(function(g){if(a.children(g).length){b(g);return}var h=a.node(g),j=h.prefRank;if(j!==undefined){if(!d(j))return;j in i?i.prefRank.push(g):i.prefRank=[g];var k=i[j];k===undefined&&(k=i[j]=a.addNode(null,{originalNodes:[]}),a.parent(k,c)),e(a,g,k,j==="min"),f(a,g,k,j==="max"),a.node(k).originalNodes.push({u:g,value:h,parent:c}),a.delNode(g)}}),g(a,c,i.min),h(a,c,i.max)}b(null)},c.relax=function(a){var b=[];a.eachEdge(function(a,c,d,e){var f=e.originalEdge;f&&b.push(f)}),a.eachNode(function(
-b,c){var d=c.originalNodes;d&&(d.forEach(function(b){b.value.rank=c.rank,a.addNode(b.u,b.value),a.parent(b.u,b.parent)}),a.delNode(b))}),b.forEach(function(b){a.addEdge(b.e,b.u,b.v,b.value)})}},{}],23:[function(a,b,c){function g(a){function g(d){var e=!0;return a.predecessors(d).forEach(function(f){b.has(f)&&!h(a,f,d)&&(b.has(d)&&(c.addNode(d,{}),b.remove(d),c.graph({root:d})),c.addNode(f,{}),c.addEdge(null,f,d,{reversed:!0}),b.remove(f),g(f),e=!1)}),a.successors(d).forEach(function(f){b.has(f)&&!h(a,d,f)&&(b.has(d)&&(c.addNode(d,{}),b.remove(d),c.graph({root:d})),c.addNode(f,{}),c.addEdge(null,d,f,{}),b.remove(f),g(f),e=!1)}),e}function i(){var d=Number.MAX_VALUE;b.keys().forEach(function(c){a.predecessors(c).forEach(function(e){if(!b.has(e)){var f=h(a,e,c);Math.abs(f)<Math.abs(d)&&(d=-f)}}),a.successors(c).forEach(function(e){if(!b.has(e)){var f=h(a,c,e);Math.abs(f)<Math.abs(d)&&(d=f)}})}),c.eachNode(function(b){a.node(b).rank-=d})}var b=new d(a.nodes()),c=new e;if(b.size()===1){var f=a.nodes()[0];return c.addNode(f,{}),c.graph({root:f}),c}while(b.size()){var j=c.order()?c.nodes():b.keys();for(var k=0,l=j.length;k<l&&g(j[k]);++k);b.size()&&i()}return c}function h(a,b,c){var d=a.node(c).rank-a.node(b).rank,e=f.max(a.outEdges(b,c).map(function(b){return a.edge(b).minLen}));return d-e}"use strict";var d=a("cp-data").Set,e=a("graphlib").Digraph,f=a("../util");b.exports=g},{"../util":27,"cp-data":5,graphlib:29}],24:[function(a,b,c){function f(a){var b=e(a);b.forEach(function(b){var c=a.inEdges(b);if(c.length===0){a.node(b).rank=0;return}var e=c.map(function(b){return a.node(a.source(b)).rank+a.edge(b).minLen});a.node(b).rank=d.max(e)})}"use strict";var d=a("../util"),e=a("graphlib").alg.topsort;b.exports=f},{"../util":27,graphlib:29}],25:[function(a,b,c){function d(a,b,c,d){return Math.abs(a.node(b).rank-a.node(c).rank)-d}"use strict",b.exports={slack:d}},{}],26:[function(a,b,c){function f(a,b){g(a,b);for(;;){var c=k(b);if(c===null)break;var d=l(a,b,c);m(a,b,c,d)}}function g(a,b){function c(d){var e=b.successors(d);for(var f in e){var g=e[f];c(g)}d!==b.graph().root&&i(a,b,d)}h(b),b.eachEdge(function(a,b,c,d){d.cutValue=0}),c(b.graph().root)}function h(a){function c(d){var e=a.successors(d),f=b;for(var g in e){var h=e[g];c(h),f=Math.min(f,a.node(h).low)}a.node(d).low=f,a.node(d).lim=b++}var b=0;c(a.graph().root)}function i(a,b,c){var d=b.inEdges(c)[0],e=[],f=b.outEdges(c);for(var g in f)e.push(b.target(f[g]));var h=0,i=0,k=0,l=0,m=0,n=a.outEdges(c),o;for(var p in n){var q=a.target(n[p]);for(o in e)j(b,q,e[o])&&i++;j(b,q,c)||l++}var r=a.inEdges(c);for(var s in r){var t=a.source(r[s]);for(o in e)j(b,t,e[o])&&k++;j(b,t,c)||m++}var u=0;for(o in e){var v=b.edge(f[o]).cutValue;b.edge(f[o]).reversed?u-=v:u+=v}b.edge(d).reversed?h-=u-i+k-l+m:h+=u-i+k-l+m,b.edge(d).cutValue=h}function j(a,b,c){return a.node(c).low<=a.node(b).lim&&a.node(b).lim<=a.node(c).lim}function k(a){var b=a.edges();for(var c in b){var d=b[c],e=a.edge(d);if(e.cutValue<0)return d}return null}function l(a,b,c){var d=b.source(c),f=b.target(c),g=b.node(f).lim<b.node(d).lim?f:d,h=!b.edge(c).reversed,i=Number.POSITIVE_INFINITY,k;h?a.eachEdge(function(d,f,h,l){if(d!==c&&j(b,f,g)&&!j(b,h,g)){var m=e.slack(a,f,h,l.minLen);m<i&&(i=m,k=d)}}):a.eachEdge(function(d,f,h,l){if(d!==c&&!j(b,f,g)&&j(b,h,g)){var m=e.slack(a,f,h,l.minLen);m<i&&(i=m,k=d)}});if(k===undefined){var l=[],m=[];throw a.eachNode(function(a){j(b,a,g)?m.push(a):l.push(a)}),new Error("No edge found from outside of tree to inside")}return k}function m(a,b,c,d){function h(a){var c=b.inEdges(a);for(var d in c){var e=c[d],f=b.source(e),g=b.edge(e);h(f),b.delEdge(e),g.reversed=!g.reversed,b.addEdge(e,a,f,g)}}b.delEdge(c);var e=a.source(d),f=a.target(d);h(f);var i=e,j=b.inEdges(i);while(j.length>0)i=b.source(j[0]),j=b.inEdges(i);b.graph().root=i,b.addEdge(null,e,f,{cutValue:0}),g(a,b),n(a,b)}function n(a,b){function c(d){var e=b.successors(d);e.forEach(function(b){var e=o(a,d,b);a.node(b).rank=a.node(d).rank+e,c(b)})}c(b.graph().root)}function o(a,b,c){var e=a.outEdges(b,c);if(e.length>0)return d.max(e.map(function(b){return a.edge(b).minLen}));var f=a.inEdges(b,c);if(f.length>0)return-d.max(f.map(function(b){return a.edge(b).minLen}))}"use strict";var d=a("../util"),e=a("./rankUtil");b.exports=f},{"../util":27,"./rankUtil":25}],27:[function(a,b,c){function d(a,b){return function(){var c=(new Date).getTime();try{return b.apply(null,arguments)}finally{e(1,a+" time: "+((new Date).getTime()-c)+"ms")}}}function e(a){e.level>=a&&console.log.apply(console,Array.prototype.slice.call(arguments,1))}"use strict",c.min=function(a){return Math.min.apply(Math,a)},c.max=function(a){return Math.max.apply(Math,a)},c.all=function(a,b){for(var c=0;c<a.length;++c)if(!b(a[c]))return!1;return!0},c.sum=function(a){return a.reduce(function(a,b){return a+b},0)},c.values=function(a){return Object.keys(a).map(function(b){return a[b]})},c.shuffle=function(a){for(var b=a.length-1;b>0;--b){var c=Math.floor(Math.random()*(b+1)),d=a[c];a[c]=a[b],a[b]=d}},c.propertyAccessor=function(a,b,c,d){return function(e){return arguments.length?(b[c]=e,d&&d(e),a):b[c]}},c.ordering=function(a){var b=[];return a.eachNode(function(a,c){var d=b[c.rank]||(b[c.rank]=[]);d[c.order]=a}),b},c.filterNonSubgraphs=function(a){return function(b){return a.children(b).length===0}},d.enabled=!1,c.time=d,e.level=0,c.log=e},{}],28:[function(a,b,c){b.exports="0.4.6"},{}],29:[function(a,b,c){c.Graph=a("./lib/Graph"),c.Digraph=a("./lib/Digraph"),c.CGraph=a("./lib/CGraph"),c.CDigraph=a("./lib/CDigraph"),a("./lib/graph-converters"),c.alg={isAcyclic:a("./lib/alg/isAcyclic"),components:a("./lib/alg/components"),dijkstra:a("./lib/alg/dijkstra"),dijkstraAll:a("./lib/alg/dijkstraAll"),findCycles:a("./lib/alg/findCycles"),floydWarshall:a("./lib/alg/floydWarshall"),postorder:a("./lib/alg/postorder"),preorder:a("./lib/alg/preorder"),prim:a("./lib/alg/prim"),tarjan:a("./lib/alg/tarjan"),topsort:a("./lib/alg/topsort")},c.converter={json:a("./lib/converter/json.js")};var d=a("./lib/filter");c.filter={all:d.all,nodesFromList:d.nodesFromList},c.version=a("./lib/version")},{"./lib/CDigraph":31,"./lib/CGraph":32,"./lib/Digraph":33,"./lib/Graph":34,"./lib/alg/components":35,"./lib/alg/dijkstra":36,"./lib/alg/dijkstraAll":37,"./lib/alg/findCycles":38,"./lib/alg/floydWarshall":39,"./lib/alg/isAcyclic":40,"./lib/alg/postorder":41,"./lib/alg/preorder":42,"./lib/alg/prim":43,"./lib/alg/tarjan":44,"./lib/alg/topsort":45,"./lib/converter/json.js":47,"./lib/filter":48,"./lib/graph-converters":49,"./lib/version":51}],30:[function(a,b,c){function e(){this._value=undefined,this._nodes={},this._edges={},this._nextId=0}function f(a,b,c){(a[b]||(a[b]=new d)).add(c)}function g(a,b,c){var d=a[b];d.remove(c),d.size()===0&&delete a[b]}var d=a("cp-data").Set;b.exports=e,e.prototype.order=function(){return Object.keys(this._nodes).length},e.prototype.size=function(){return Object.keys(this._edges).length},e.prototype.graph=function(a){if(arguments.length===0)return this._value;this._value=a},e.prototype.hasNode=function(a){return a in this._nodes},e.prototype.node=function(a,b){var c=this._strictGetNode(a);if(arguments.length===1)return c.value;c.value=b},e.prototype.nodes=function(){var a=[];return this.eachNode(function(b){a.push(b)}),a},e.prototype.eachNode=function(a){for(var b in this._nodes){var c=this._nodes[b];a(c.id,c.value)}},e.prototype.hasEdge=function(a){return a in this._edges},e.prototype.edge=function(a,b){var c=this._strictGetEdge(a);if(arguments.length===1)return c.value;c.value=b},e.prototype.edges=function(){var a=[];return this.eachEdge(function(b){a.push(b)}),a},e.prototype.eachEdge=function(a){for(var b in this._edges){var c=this._edges[b];a(c.id,c.u,c.v,c.value)}},e.prototype.incidentNodes=function(a){var b=this._strictGetEdge(a);return[b.u,b.v]},e.prototype.addNode=function(a,b){if(a===undefined||a===null){do a="_"+ ++this._nextId;while(this.hasNode(a))}else if(this.hasNode(a))throw new Error("Graph already has node '"+a+"'");return this._nodes[a]={id:a,value:b},a},e.prototype.delNode=function(a){this._strictGetNode(a),this.incidentEdges(a).forEach(function(a){this.delEdge(a)},this),delete this._nodes[a]},e.prototype._addEdge=function(a,b,c,d,e,g){this._strictGetNode(b),this._strictGetNode(c);if(a===undefined||a===null){do a="_"+ ++this._nextId;while(this.hasEdge(a))}else if(this.hasEdge(a))throw new Error("Graph already has edge '"+a+"'");return this._edges[a]={id:a,u:b,v:c,value:d},f(e[c],b,a),f(g[b],c,a),a},e.prototype._delEdge=function(a,b,c){var d=this._strictGetEdge(a);g(b[d.v],d.u,a),g(c[d.u],d.v,a),delete this._edges[a]},e.prototype.copy=function(){var a=new this.constructor;return a.graph(this.graph()),this.eachNode(function(b,c){a.addNode(b,c)}),this.eachEdge(function(b,c,d,e){a.addEdge(b,c,d,e)}),a._nextId=this._nextId,a},e.prototype.filterNodes=function(a){var b=new this.constructor;return b.graph(this.graph()),this.eachNode(function(c,d){a(c)&&b.addNode(c,d)}),this.eachEdge(function(a,c,d,e){b.hasNode(c)&&b.hasNode(d)&&b.addEdge(a,c,d,e)}),b},e.prototype._strictGetNode=function(a){var b=this._nodes[a];if(b===undefined)throw new Error("Node '"+a+"' is not in graph");return b},e.prototype._strictGetEdge=function(a){var b=this._edges[a];if(b===undefined)throw new Error("Edge '"+a+"' is not in graph");return b}},{"cp-data":5}],31:[function(a,b,c){var d=a("./Digraph"),e=a("./compoundify"),f=e(d);b.exports=f,f.fromDigraph=function(a){var b=new f,c=a.graph();return c!==undefined&&b.graph(c),a.eachNode(function(a,c){c===undefined?b.addNode(a):b.addNode(a,c)}),a.eachEdge(function(a,c,d,e){e===undefined?b.addEdge(null,c,d):b.addEdge(null,c,d,e)}),b},f.prototype.toString=function(){return"CDigraph "+JSON.stringify(this,null,2)}},{"./Digraph":33,"./compoundify":46}],32:[function(a,b,c){var d=a("./Graph"),e=a("./compoundify"),f=e(d);b.exports=f,f.fromGraph=function(a){var b=new f,c=a.graph();return c!==undefined&&b.graph(c),a.eachNode(function(a,c){c===undefined?b.addNode(a):b.addNode(a,c)}),a.eachEdge(function(a,c,d,e){e===undefined?b.addEdge(null,c,d):b.addEdge(null,c,d,e)}),b},f.prototype.toString=function(){return"CGraph "+JSON.stringify(this,null,2)}},{"./Graph":34,"./compoundify":46}],33:[function(a,b,c){function g(){e.call(this),this._inEdges={},this._outEdges={}}var d=a("./util"),e=a("./BaseGraph"),f=a("cp-data").Set;b.exports=g,g.prototype=new e,g.prototype.constructor=g,g.prototype.isDirected=function(){return!0},g.prototype.successors=function(a){return this._strictGetNode(a),Object.keys(this._outEdges[a]).map(function(a){return this._nodes[a].id},this)},g.prototype.predecessors=function(a){return this._strictGetNode(a),Object.keys(this._inEdges[a]).map(function(a){return this._nodes[a].id},this)},g.prototype.neighbors=function(a){return f.union([this.successors(a),this.predecessors(a)]).keys()},g.prototype.sources=function(){var a=this;return this._filterNodes(function(b){return a.inEdges(b).length===0})},g.prototype.sinks=function(){var a=this;return this._filterNodes(function(b){return a.outEdges(b).length===0})},g.prototype.source=function(a){return this._strictGetEdge(a).u},g.prototype.target=function(a){return this._strictGetEdge(a).v},g.prototype.inEdges=function(a,b){this._strictGetNode(a);var c=f.union(d.values(this._inEdges[a])).keys();return arguments.length>1&&(this._strictGetNode(b),c=c.filter(function(a){return this.source(a)===b},this)),c},g.prototype.outEdges=function(a,b){this._strictGetNode(a);var c=f.union(d.values(this._outEdges[a])).keys();return arguments.length>1&&(this._strictGetNode(b),c=c.filter(function(a){return this.target(a)===b},this)),c},g.prototype.incidentEdges=function(a,b){return arguments.length>1?f.union([this.outEdges(a,b),this.outEdges(b,a)]).keys():f.union([this.inEdges(a),this.outEdges(a)]).keys()},g.prototype.toString=function(){return"Digraph "+JSON.stringify(this,null,2)},g.prototype.addNode=function(a,b){return a=e.prototype.addNode.call(this,a,b),this._inEdges[a]={},this._outEdges[a]={},a},g.prototype.delNode=function(a){e.prototype.delNode.call(this,a),delete this._inEdges[a],delete this._outEdges[a]},g.prototype.addEdge=function(a,b,c,d){return e.prototype._addEdge.call(this,a,b,c,d,this._inEdges,this._outEdges)},g.prototype.delEdge=function(a){e.prototype._delEdge.call(this,a,this._inEdges,this._outEdges)},g.prototype._filterNodes=function(a){var b=[];return this.eachNode(function(c){a(c)&&b.push(c)}),b}},{"./BaseGraph":30,"./util":50,"cp-data":5}],34:[function(a,b,c){function g(){e.call(this),this._incidentEdges={}}var d=a("./util"),e=a("./BaseGraph"),f=a("cp-data").Set;b.exports=g,g.prototype=new e,g.prototype.constructor=g,g.prototype.isDirected=function(){return!1},g.prototype.neighbors=function(a){return this._strictGetNode(a),Object.keys(this._incidentEdges[a]).map(function(a){return this._nodes[a].id},this)},g.prototype.incidentEdges=function(a,b){return this._strictGetNode(a),arguments.length>1?(this._strictGetNode(b),b in this._incidentEdges[a]?this._incidentEdges[a][b].keys():[]):f.union(d.values(this._incidentEdges[a])).keys()},g.prototype.toString=function(){return"Graph "+JSON.stringify(this,null,2)},g.prototype.addNode=function(a,b){return a=e.prototype.addNode.call(this,a,b),this._incidentEdges[a]={},a},g.prototype.delNode=function(a){e.prototype.delNode.call(this,a),delete this._incidentEdges[a]},g.prototype.addEdge=function(a,b,c,d){return e.prototype._addEdge.call(this,a,b,c,d,this._incidentEdges,this._incidentEdges)},g.prototype.delEdge=function(a){e.prototype._delEdge.call(this,a,this._incidentEdges,this._incidentEdges)}},{"./BaseGraph":30,"./util":50,"cp-data":5}],35:[function(a,b,c){function e(a){function e(b,d){c.has(b)||(c.add(b),d.push(b),a.neighbors(b).forEach(function(a){e(a,d)}))}var b=[],c=new d;return a.nodes().forEach(function(a){var c=[];e(a,c),c.length>0&&b.push(c)}),b}var d=a("cp-data").Set;b.exports=e},{"cp-data":5}],36:[function(a,b,c){function e(a,b,c,e){function h(b){var d=a.incidentNodes(b),e=d[0]!==i?d[0]:d[1],h=f[e],k=c(b),l=j.distance+k;if(k<0)throw new Error("dijkstra does not allow negative edge weights. Bad edge: "+b+" Weight: "+k);l<h.distance&&(h.distance=l,h.predecessor=i,g.decrease(e,l))}var f={},g=new d;c=c||function(){return 1},e=e||(a.isDirected()?function(b){return a.outEdges(b)}:function(b){return a.incidentEdges(b)}),a.eachNode(function(a){var c=a===b?0:Number.POSITIVE_INFINITY;f[a]={distance:c},g.add(a,c)});var i,j;while(g.size()>0){i=g.removeMin(),j=f[i];if(j.distance===Number.POSITIVE_INFINITY)break;e(i).forEach(h)}return f}var d=a("cp-data").PriorityQueue;b.exports=e},{"cp-data":5}],37:[function(a,b,c){function e(a,b,c){var e={};return a.eachNode(function(f){e[f]=d(a,f,b,c)}),e}var d=a("./dijkstra");b.exports=e},{"./dijkstra":36}],38:[function(a,b,c){function e(a){return d(a).filter(function(a){return a.length>1})}var d=a("./tarjan");b.exports=e},{"./tarjan":44}],39:[function(a,b,c){function d(a,b,c){var d={},e=a.nodes();return b=b||function(){return 1},c=c||(a.isDirected()?function(b){return a.outEdges(b)}:function(b){return a.incidentEdges(b)}),e.forEach(function(f){d[f]={},d[f][f]={distance:0},e.forEach(function(a){f!==a&&(d[f][a]={distance:Number.POSITIVE_INFINITY})}),c(f).forEach(function(c){var e=a.incidentNodes(c),h=e[0]!==f?e[0]:e[1],i=b(c);i<d[f][h].distance&&(d[f][h]={distance:i,predecessor:f})})}),e.forEach(function(a){var b=d[a];e.forEach(function(c){var f=d[c];e.forEach(function(c){var d=f[a],e=b[c],g=f[c],h=d.distance+e.distance;h<g.distance&&(g.distance=h,g.predecessor=e.predecessor)})})}),d}b.exports=d},{}],40:[function(a,b,c){function e(a){try{d(a)}catch(b){if(b instanceof d.CycleException)return!1;throw b}return!0}var d=a("./topsort");b.exports=e},{"./topsort":45}],41:[function(a,b,c){function e(a,b,c){function f(b,d){if(e.has(b))throw new Error("The input graph is not a tree: "+a);e.add(b),a.neighbors(b).forEach(function(a){a!==d&&f(a,b)}),c(b)}var e=new d;if(a.isDirected())throw new Error("This function only works for undirected graphs");f(b)}var d=a("cp-data").Set;b.exports=e},{"cp-data":5}],42:[function(a,b,c){function e(a,b,c){function f(b,d){if(e.has(b))throw new Error("The input graph is not a tree: "+a);e.add(b),c(b),a.neighbors(b).forEach(function(a){a!==d&&f(a,b)})}var e=new d;if(a.isDirected())throw new Error("This function only works for undirected graphs");f(b)}var d=a("cp-data").Set;b.exports=e},{"cp-data":5}],43:[function(a,b,c){function f(a,b){function i(c){var d=a.incidentNodes(c),e=d[0]!==h?d[0]:d[1],i=g.priority(e);if(i!==undefined){var j=b(c);j<i&&(f[e]=h,g.decrease(e,j))}}var c=new d,f={},g=new e,h;if(a.order()===0)return c;a.eachNode(function(a){g.add(a,Number.POSITIVE_INFINITY),c.addNode(a)}),g.decrease(a.nodes()[0],0);var j=!1;while(g.size()>0){h=g.removeMin();if(h in f)c.addEdge(null,h,f[h]);else{if(j)throw new Error("Input graph is not connected: "+a);j=!0}a.incidentEdges(h).forEach(i)}return c}var d=a("../Graph"),e=a("cp-data").PriorityQueue;b.exports=f},{"../Graph":34,"cp-data":5}],44:[function(a,b,c){function d(a){function f(h){var i=d[h]={onStack:!0,lowlink:b,index:b++};c.push(h),a.successors(h).forEach(function(a){a in d?d[a].onStack&&(i.lowlink=Math.min(i.lowlink,d[a].index)):(f(a),i.lowlink=Math.min(i.lowlink,d[a].lowlink))});if(i.lowlink===i.index){var j=[],k;do k=c.pop(),d[k].onStack=!1,j.push(k);while(h!==k);e.push(j)}}if(!a.isDirected())throw new Error("tarjan can only be applied to a directed graph. Bad input: "+a);var b=0,c=[],d={},e=[];return a.nodes().forEach(function(a){a in d||f(a)}),e}b.exports=d},{}],45:[function(a,b,c){function d(a){function f(g){if(g in c)throw new e;g in b||(c[g]=!0,b[g]=!0,a.predecessors(g).forEach(function(a){f(a)}),delete c[g],d.push(g))}if(!a.isDirected())throw new Error("topsort can only be applied to a directed graph. Bad input: "+a);var b={},c={},d=[],g=a.sinks();if(a.order()!==0&&g.length===0)throw new e;return a.sinks().forEach(function(a){f(a)}),d}function e(){}b.exports=d,d.CycleException=e,e.prototype.toString=function(){return"Graph has at least one cycle"}},{}],46:[function(a,b,c){function e(a){function b(){a.call(this),this._parents={},this._children={},this._children[null]=new d}return b.prototype=new a,b.prototype.constructor=b,b.prototype.parent=function(a,b){this._strictGetNode(a);if(arguments.length<2)return this._parents[a];if(a===b)throw new Error("Cannot make "+a+" a parent of itself");b!==null&&this._strictGetNode(b),this._children[this._parents[a]].remove(a),this._parents[a]=b,this._children[b].add(a)},b.prototype.children=function(a){return a!==null&&this._strictGetNode(a),this._children[a].keys()},b.prototype.addNode=function(b,c){return b=a.prototype.addNode.call(this,b,c),this._parents[b]=null,this._children[b]=new d,this._children[null].add(b),b},b.prototype.delNode=function(b){var c=this.parent(b);return this._children[b].keys().forEach(function(a){this.parent(a,c)},this),this._children[c].remove(b),delete this._parents[b],delete this._children[b],a.prototype.delNode.call(this,b)},b.prototype.copy=function(){var b=a.prototype.copy.call(this);return this.nodes().forEach(function(a){b.parent(a,this.parent(a))},this),b},b.prototype.filterNodes=function(b){function f(a){var b=c.parent(a);return b===null||d.hasNode(b)?(e[a]=b,b):b in e?e[b]:f(b)}var c=this,d=a.prototype.filterNodes.call(this,b),e={};return d.eachNode(function(a){d.parent(a,f(a))}),d},b}var d=a("cp-data").Set;b.exports=e},{"cp-data":5}],47:[function(a,b,c){function h(a){return Object.prototype.toString.call(a).slice(8,-1)}var d=a("../Graph"),e=a("../Digraph"),f=a("../CGraph"),g=a("../CDigraph");c.decode=function(a,b,c){c=c||e;if(h(a)!=="Array")throw new Error("nodes is not an Array");if(h(b)!=="Array")throw new Error("edges is not an Array");if(typeof c=="string")switch(c){case"graph":c=d;break;case"digraph":c=e;break;case"cgraph":c=f;break;case"cdigraph":c=g;break;default:throw new Error("Unrecognized graph type: "+c)}var i=new c;return a.forEach(function(a){i.addNode(a.id,a.value)}),i.parent&&a.forEach(function(a){a.children&&a.children.forEach(function(b){i.parent(b,a.id)})}),b.forEach(function(a){i.addEdge(a.id,a.u,a.v,a.value)}),i},c.encode=function(a){var b=[],c=[];a.eachNode(function(c,d){var e={id:c,value:d};if(a.children){var f=a.children(c);f.length&&(e.children=f)}b.push(e)}),a.eachEdge(function(a,b,d,e){c.push({id:a,u:b,v:d,value:e})});var h;if(a instanceof g)h="cdigraph";else if(a instanceof f)h="cgraph";else if(a instanceof e)h="digraph";else if(a instanceof d)h="graph";else throw new Error("Couldn't determine type of graph: "+a);return{nodes:b,edges:c,type:h}}},{"../CDigraph":31,"../CGraph":32,"../Digraph":33,"../Graph":34}],48:[function(a,b,c){var d=a("cp-data").Set;c.all=function(){return function(){return!0}},c.nodesFromList=function(a){var b=new d(a);return function(a){return b.has(a)}}},{"cp-data":5}],49:[function(a,b,c){var d=a("./Graph"),e=a("./Digraph");d.prototype.toDigraph=d.prototype.asDirected=function(){var a=new e;return this.eachNode(function(b,c){a.addNode(b,c)}),this.eachEdge(function(b,c,d,e){a.addEdge(null,c,d,e),a.addEdge(null,d,c,e)}),a},e.prototype.toGraph=e.prototype.asUndirected=function(){var a=new d;return this.eachNode(function(b,c){a.addNode(b,c)}),this.eachEdge(function(b,c,d,e){a.addEdge(b,c,d,e)}),a}},{"./Digraph":33,"./Graph":34}],50:[function(a,b,c){c.values=function(a){var b=Object.keys(a),c=b.length,d=new Array(c),e;for(e=0;e<c;++e)d[e]=a[b[e]];return d}},{}],51:[function(a,b,c){b.exports="0.7.4"},{}]},{},[1]);
\ No newline at end of file
diff --git a/airflow/www_rbac/static/dagre.css b/airflow/www_rbac/static/dagre.css
deleted file mode 100644
index acf4ff5facbc8..0000000000000
--- a/airflow/www_rbac/static/dagre.css
+++ /dev/null
@@ -1,38 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-svg {
-    overflow: hidden;
-}
-
-.node rect {
-    stroke: #333;
-    stroke-width: 1px;
-    fill: #fff;
-}
-
-.edgeLabel rect {
-    fill: #fff;
-}
-
-.edgePath {
-    stroke: #333;
-    stroke-width: 1px;
-    fill: none;
-}
diff --git a/airflow/www_rbac/static/dataTables.bootstrap.css b/airflow/www_rbac/static/dataTables.bootstrap.css
deleted file mode 100644
index 8ca39c3e009e2..0000000000000
--- a/airflow/www_rbac/static/dataTables.bootstrap.css
+++ /dev/null
@@ -1,333 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-div.dataTables_length label {
-	font-weight: normal;
-	text-align: left;
-	white-space: nowrap;
-}
-
-div.dataTables_length select {
-	width: 75px;
-	display: inline-block;
-}
-
-div.dataTables_filter {
-	text-align: right;
-}
-
-div.dataTables_filter label {
-	font-weight: normal;
-	white-space: nowrap;
-	text-align: left;
-}
-
-div.dataTables_filter input {
-	margin-left: 0.5em;
-	display: inline-block;
-}
-
-div.dataTables_info {
-	padding-top: 8px;
-	white-space: nowrap;
-}
-
-div.dataTables_paginate {
-	margin: 0;
-	white-space: nowrap;
-	text-align: right;
-}
-
-div.dataTables_paginate ul.pagination {
-	margin: 2px 0;
-	white-space: nowrap;
-}
-
-@media screen and (max-width: 767px) {
-	div.dataTables_length,
-	div.dataTables_filter,
-	div.dataTables_info,
-	div.dataTables_paginate {
-		text-align: center;
-	}
-}
-
-
-table.dataTable td,
-table.dataTable th {
-	-webkit-box-sizing: content-box;
-	-moz-box-sizing: content-box;
-	box-sizing: content-box;
-}
-
-
-table.dataTable {
-	clear: both;
-	margin-top: 6px !important;
-	margin-bottom: 6px !important;
-	max-width: none !important;
-}
-
-table.dataTable thead .sorting,
-table.dataTable thead .sorting_asc,
-table.dataTable thead .sorting_desc,
-table.dataTable thead .sorting_asc_disabled,
-table.dataTable thead .sorting_desc_disabled {
-	cursor: pointer;
-}
-
-table.dataTable thead .sorting { background: url('../images/sort_both.png') no-repeat center right; }
-table.dataTable thead .sorting_asc { background: url('../images/sort_asc.png') no-repeat center right; }
-table.dataTable thead .sorting_desc { background: url('../images/sort_desc.png') no-repeat center right; }
-
-table.dataTable thead .sorting_asc_disabled { background: url('../images/sort_asc_disabled.png') no-repeat center right; }
-table.dataTable thead .sorting_desc_disabled { background: url('../images/sort_desc_disabled.png') no-repeat center right; }
-
-table.dataTable thead > tr > th {
-	padding-left: 18px;
-	padding-right: 18px;
-}
-
-table.dataTable th:active {
-	outline: none;
-}
-
-/* Scrolling */
-div.dataTables_scrollHead table {
-	margin-bottom: 0 !important;
-	border-bottom-left-radius: 0;
-	border-bottom-right-radius: 0;
-}
-
-div.dataTables_scrollHead table thead tr:last-child th:first-child,
-div.dataTables_scrollHead table thead tr:last-child td:first-child {
-	border-bottom-left-radius: 0 !important;
-	border-bottom-right-radius: 0 !important;
-}
-
-div.dataTables_scrollBody table {
-	border-top: none;
-	margin-top: 0 !important;
-	margin-bottom: 0 !important;
-}
-
-div.dataTables_scrollBody tbody tr:first-child th,
-div.dataTables_scrollBody tbody tr:first-child td {
-	border-top: none;
-}
-
-div.dataTables_scrollFoot table {
-	margin-top: 0 !important;
-	border-top: none;
-}
-
-/* Frustratingly the border-collapse:collapse used by Bootstrap makes the column
-   width calculations when using scrolling impossible to align columns. We have
-   to use separate
- */
-table.table-bordered.dataTable {
-	border-collapse: separate !important;
-}
-table.table-bordered thead th,
-table.table-bordered thead td {
-	border-left-width: 0;
-	border-top-width: 0;
-}
-table.table-bordered tbody th,
-table.table-bordered tbody td {
-	border-left-width: 0;
-	border-bottom-width: 0;
-}
-table.table-bordered th:last-child,
-table.table-bordered td:last-child {
-	border-right-width: 0;
-}
-div.dataTables_scrollHead table.table-bordered {
-	border-bottom-width: 0;
-}
-
-
-
-
-/*
- * TableTools styles
- */
-.table.dataTable tbody tr.active td,
-.table.dataTable tbody tr.active th {
-	background-color: #08C;
-	color: white;
-}
-
-.table.dataTable tbody tr.active:hover td,
-.table.dataTable tbody tr.active:hover th {
-	background-color: #0075b0 !important;
-}
-
-.table.dataTable tbody tr.active th > a,
-.table.dataTable tbody tr.active td > a {
-	color: white;
-}
-
-.table-striped.dataTable tbody tr.active:nth-child(odd) td,
-.table-striped.dataTable tbody tr.active:nth-child(odd) th {
-	background-color: #017ebc;
-}
-
-table.DTTT_selectable tbody tr {
-	cursor: pointer;
-}
-
-div.DTTT .btn:hover {
-	text-decoration: none !important;
-}
-
-ul.DTTT_dropdown.dropdown-menu {
-  z-index: 2003;
-}
-
-ul.DTTT_dropdown.dropdown-menu a {
-	color: #333 !important; /* needed only when demo_page.css is included */
-}
-
-ul.DTTT_dropdown.dropdown-menu li {
-	position: relative;
-}
-
-ul.DTTT_dropdown.dropdown-menu li:hover a {
-	background-color: #0088cc;
-	color: white !important;
-}
-
-div.DTTT_collection_background {
-	z-index: 2002;
-}
-
-/* TableTools information display */
-div.DTTT_print_info {
-	position: fixed;
-	top: 50%;
-	left: 50%;
-	width: 400px;
-	height: 150px;
-	margin-left: -200px;
-	margin-top: -75px;
-	text-align: center;
-	color: #333;
-	padding: 10px 30px;
-	opacity: 0.95;
-
-	background-color: white;
-	border: 1px solid rgba(0, 0, 0, 0.2);
-	border-radius: 6px;
-
-	-webkit-box-shadow: 0 3px 7px rgba(0, 0, 0, 0.5);
-	        box-shadow: 0 3px 7px rgba(0, 0, 0, 0.5);
-}
-
-div.DTTT_print_info h6 {
-	font-weight: normal;
-	font-size: 28px;
-	line-height: 28px;
-	margin: 1em;
-}
-
-div.DTTT_print_info p {
-	font-size: 14px;
-	line-height: 20px;
-}
-
-div.dataTables_processing {
-    position: absolute;
-    top: 50%;
-    left: 50%;
-    width: 100%;
-    height: 60px;
-    margin-left: -50%;
-    margin-top: -25px;
-    padding-top: 20px;
-    padding-bottom: 20px;
-    text-align: center;
-    font-size: 1.2em;
-    background-color: white;
-    background: -webkit-gradient(linear, left top, right top, color-stop(0%, rgba(255,255,255,0)), color-stop(25%, rgba(255,255,255,0.9)), color-stop(75%, rgba(255,255,255,0.9)), color-stop(100%, rgba(255,255,255,0)));
-    background: -webkit-linear-gradient(left, rgba(255,255,255,0) 0%, rgba(255,255,255,0.9) 25%, rgba(255,255,255,0.9) 75%, rgba(255,255,255,0) 100%);
-    background: -moz-linear-gradient(left, rgba(255,255,255,0) 0%, rgba(255,255,255,0.9) 25%, rgba(255,255,255,0.9) 75%, rgba(255,255,255,0) 100%);
-    background: -ms-linear-gradient(left, rgba(255,255,255,0) 0%, rgba(255,255,255,0.9) 25%, rgba(255,255,255,0.9) 75%, rgba(255,255,255,0) 100%);
-    background: -o-linear-gradient(left, rgba(255,255,255,0) 0%, rgba(255,255,255,0.9) 25%, rgba(255,255,255,0.9) 75%, rgba(255,255,255,0) 100%);
-    background: linear-gradient(to right, rgba(255,255,255,0) 0%, rgba(255,255,255,0.9) 25%, rgba(255,255,255,0.9) 75%, rgba(255,255,255,0) 100%);
-}
-
-
-
-/*
- * FixedColumns styles
- */
-div.DTFC_LeftHeadWrapper table,
-div.DTFC_LeftFootWrapper table,
-div.DTFC_RightHeadWrapper table,
-div.DTFC_RightFootWrapper table,
-table.DTFC_Cloned tr.even {
-    background-color: white;
-    margin-bottom: 0;
-}
-
-div.DTFC_RightHeadWrapper table ,
-div.DTFC_LeftHeadWrapper table {
-	border-bottom: none !important;
-    margin-bottom: 0 !important;
-    border-top-right-radius: 0 !important;
-    border-bottom-left-radius: 0 !important;
-    border-bottom-right-radius: 0 !important;
-}
-
-div.DTFC_RightHeadWrapper table thead tr:last-child th:first-child,
-div.DTFC_RightHeadWrapper table thead tr:last-child td:first-child,
-div.DTFC_LeftHeadWrapper table thead tr:last-child th:first-child,
-div.DTFC_LeftHeadWrapper table thead tr:last-child td:first-child {
-    border-bottom-left-radius: 0 !important;
-    border-bottom-right-radius: 0 !important;
-}
-
-div.DTFC_RightBodyWrapper table,
-div.DTFC_LeftBodyWrapper table {
-    border-top: none;
-    margin: 0 !important;
-}
-
-div.DTFC_RightBodyWrapper tbody tr:first-child th,
-div.DTFC_RightBodyWrapper tbody tr:first-child td,
-div.DTFC_LeftBodyWrapper tbody tr:first-child th,
-div.DTFC_LeftBodyWrapper tbody tr:first-child td {
-    border-top: none;
-}
-
-div.DTFC_RightFootWrapper table,
-div.DTFC_LeftFootWrapper table {
-    border-top: none;
-    margin-top: 0 !important;
-}
-
-
-/*
- * FixedHeader styles
- */
-div.FixedHeader_Cloned table {
-	margin: 0 !important
-}
-
diff --git a/airflow/www_rbac/static/jquery.dataTables.css b/airflow/www_rbac/static/jquery.dataTables.css
deleted file mode 100644
index 6a2e88d942260..0000000000000
--- a/airflow/www_rbac/static/jquery.dataTables.css
+++ /dev/null
@@ -1,495 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-/*
- * Table styles
- */
-table.dataTable {
-  width: 100%;
-  margin: 0 auto;
-  clear: both;
-  border-collapse: separate;
-  border-spacing: 0;
-  /*
-   * Header and footer styles
-   */
-  /*
-   * Body styles
-   */
-}
-table.dataTable thead th,
-table.dataTable tfoot th {
-  font-weight: bold;
-}
-table.dataTable thead th,
-table.dataTable thead td {
-  padding: 10px 18px;
-  border-bottom: 1px solid #111111;
-}
-table.dataTable thead th:active,
-table.dataTable thead td:active {
-  outline: none;
-}
-table.dataTable tfoot th,
-table.dataTable tfoot td {
-  padding: 10px 18px 6px 18px;
-  border-top: 1px solid #111111;
-}
-table.dataTable thead .sorting_asc,
-table.dataTable thead .sorting_desc,
-table.dataTable thead .sorting {
-  cursor: pointer;
-  *cursor: hand;
-}
-table.dataTable thead .sorting {
-  background: url("../images/sort_both.png") no-repeat center right;
-}
-table.dataTable thead .sorting_asc {
-  background: url("../images/sort_asc.png") no-repeat center right;
-}
-table.dataTable thead .sorting_desc {
-  background: url("../images/sort_desc.png") no-repeat center right;
-}
-table.dataTable thead .sorting_asc_disabled {
-  background: url("../images/sort_asc_disabled.png") no-repeat center right;
-}
-table.dataTable thead .sorting_desc_disabled {
-  background: url("../images/sort_desc_disabled.png") no-repeat center right;
-}
-table.dataTable tbody tr {
-  background-color: white;
-}
-table.dataTable tbody tr.selected {
-  background-color: #b0bed9;
-}
-table.dataTable tbody th,
-table.dataTable tbody td {
-  padding: 8px 10px;
-}
-table.dataTable.row-border tbody th, table.dataTable.row-border tbody td, table.dataTable.display tbody th, table.dataTable.display tbody td {
-  border-top: 1px solid #dddddd;
-}
-table.dataTable.row-border tbody tr:first-child th,
-table.dataTable.row-border tbody tr:first-child td, table.dataTable.display tbody tr:first-child th,
-table.dataTable.display tbody tr:first-child td {
-  border-top: none;
-}
-table.dataTable.cell-border tbody th, table.dataTable.cell-border tbody td {
-  border-top: 1px solid #dddddd;
-  border-right: 1px solid #dddddd;
-}
-table.dataTable.cell-border tbody tr th:first-child,
-table.dataTable.cell-border tbody tr td:first-child {
-  border-left: 1px solid #dddddd;
-}
-table.dataTable.cell-border tbody tr:first-child th,
-table.dataTable.cell-border tbody tr:first-child td {
-  border-top: none;
-}
-table.dataTable.stripe tbody tr.odd, table.dataTable.display tbody tr.odd {
-  background-color: #f9f9f9;
-}
-table.dataTable.stripe tbody tr.odd.selected, table.dataTable.display tbody tr.odd.selected {
-  background-color: #abb9d3;
-}
-table.dataTable.hover tbody tr:hover,
-table.dataTable.hover tbody tr.odd:hover,
-table.dataTable.hover tbody tr.even:hover, table.dataTable.display tbody tr:hover,
-table.dataTable.display tbody tr.odd:hover,
-table.dataTable.display tbody tr.even:hover {
-  background-color: whitesmoke;
-}
-table.dataTable.hover tbody tr:hover.selected,
-table.dataTable.hover tbody tr.odd:hover.selected,
-table.dataTable.hover tbody tr.even:hover.selected, table.dataTable.display tbody tr:hover.selected,
-table.dataTable.display tbody tr.odd:hover.selected,
-table.dataTable.display tbody tr.even:hover.selected {
-  background-color: #a9b7d1;
-}
-table.dataTable.order-column tbody tr > .sorting_1,
-table.dataTable.order-column tbody tr > .sorting_2,
-table.dataTable.order-column tbody tr > .sorting_3, table.dataTable.display tbody tr > .sorting_1,
-table.dataTable.display tbody tr > .sorting_2,
-table.dataTable.display tbody tr > .sorting_3 {
-  background-color: #f9f9f9;
-}
-table.dataTable.order-column tbody tr.selected > .sorting_1,
-table.dataTable.order-column tbody tr.selected > .sorting_2,
-table.dataTable.order-column tbody tr.selected > .sorting_3, table.dataTable.display tbody tr.selected > .sorting_1,
-table.dataTable.display tbody tr.selected > .sorting_2,
-table.dataTable.display tbody tr.selected > .sorting_3 {
-  background-color: #acbad4;
-}
-table.dataTable.display tbody tr.odd > .sorting_1, table.dataTable.order-column.stripe tbody tr.odd > .sorting_1 {
-  background-color: #f1f1f1;
-}
-table.dataTable.display tbody tr.odd > .sorting_2, table.dataTable.order-column.stripe tbody tr.odd > .sorting_2 {
-  background-color: #f3f3f3;
-}
-table.dataTable.display tbody tr.odd > .sorting_3, table.dataTable.order-column.stripe tbody tr.odd > .sorting_3 {
-  background-color: whitesmoke;
-}
-table.dataTable.display tbody tr.odd.selected > .sorting_1, table.dataTable.order-column.stripe tbody tr.odd.selected > .sorting_1 {
-  background-color: #a6b3cd;
-}
-table.dataTable.display tbody tr.odd.selected > .sorting_2, table.dataTable.order-column.stripe tbody tr.odd.selected > .sorting_2 {
-  background-color: #a7b5ce;
-}
-table.dataTable.display tbody tr.odd.selected > .sorting_3, table.dataTable.order-column.stripe tbody tr.odd.selected > .sorting_3 {
-  background-color: #a9b6d0;
-}
-table.dataTable.display tbody tr.even > .sorting_1, table.dataTable.order-column.stripe tbody tr.even > .sorting_1 {
-  background-color: #f9f9f9;
-}
-table.dataTable.display tbody tr.even > .sorting_2, table.dataTable.order-column.stripe tbody tr.even > .sorting_2 {
-  background-color: #fbfbfb;
-}
-table.dataTable.display tbody tr.even > .sorting_3, table.dataTable.order-column.stripe tbody tr.even > .sorting_3 {
-  background-color: #fdfdfd;
-}
-table.dataTable.display tbody tr.even.selected > .sorting_1, table.dataTable.order-column.stripe tbody tr.even.selected > .sorting_1 {
-  background-color: #acbad4;
-}
-table.dataTable.display tbody tr.even.selected > .sorting_2, table.dataTable.order-column.stripe tbody tr.even.selected > .sorting_2 {
-  background-color: #adbbd6;
-}
-table.dataTable.display tbody tr.even.selected > .sorting_3, table.dataTable.order-column.stripe tbody tr.even.selected > .sorting_3 {
-  background-color: #afbdd8;
-}
-table.dataTable.display tbody tr:hover > .sorting_1,
-table.dataTable.display tbody tr.odd:hover > .sorting_1,
-table.dataTable.display tbody tr.even:hover > .sorting_1, table.dataTable.order-column.hover tbody tr:hover > .sorting_1,
-table.dataTable.order-column.hover tbody tr.odd:hover > .sorting_1,
-table.dataTable.order-column.hover tbody tr.even:hover > .sorting_1 {
-  background-color: #eaeaea;
-}
-table.dataTable.display tbody tr:hover > .sorting_2,
-table.dataTable.display tbody tr.odd:hover > .sorting_2,
-table.dataTable.display tbody tr.even:hover > .sorting_2, table.dataTable.order-column.hover tbody tr:hover > .sorting_2,
-table.dataTable.order-column.hover tbody tr.odd:hover > .sorting_2,
-table.dataTable.order-column.hover tbody tr.even:hover > .sorting_2 {
-  background-color: #ebebeb;
-}
-table.dataTable.display tbody tr:hover > .sorting_3,
-table.dataTable.display tbody tr.odd:hover > .sorting_3,
-table.dataTable.display tbody tr.even:hover > .sorting_3, table.dataTable.order-column.hover tbody tr:hover > .sorting_3,
-table.dataTable.order-column.hover tbody tr.odd:hover > .sorting_3,
-table.dataTable.order-column.hover tbody tr.even:hover > .sorting_3 {
-  background-color: #eeeeee;
-}
-table.dataTable.display tbody tr:hover.selected > .sorting_1,
-table.dataTable.display tbody tr.odd:hover.selected > .sorting_1,
-table.dataTable.display tbody tr.even:hover.selected > .sorting_1, table.dataTable.order-column.hover tbody tr:hover.selected > .sorting_1,
-table.dataTable.order-column.hover tbody tr.odd:hover.selected > .sorting_1,
-table.dataTable.order-column.hover tbody tr.even:hover.selected > .sorting_1 {
-  background-color: #a1aec7;
-}
-table.dataTable.display tbody tr:hover.selected > .sorting_2,
-table.dataTable.display tbody tr.odd:hover.selected > .sorting_2,
-table.dataTable.display tbody tr.even:hover.selected > .sorting_2, table.dataTable.order-column.hover tbody tr:hover.selected > .sorting_2,
-table.dataTable.order-column.hover tbody tr.odd:hover.selected > .sorting_2,
-table.dataTable.order-column.hover tbody tr.even:hover.selected > .sorting_2 {
-  background-color: #a2afc8;
-}
-table.dataTable.display tbody tr:hover.selected > .sorting_3,
-table.dataTable.display tbody tr.odd:hover.selected > .sorting_3,
-table.dataTable.display tbody tr.even:hover.selected > .sorting_3, table.dataTable.order-column.hover tbody tr:hover.selected > .sorting_3,
-table.dataTable.order-column.hover tbody tr.odd:hover.selected > .sorting_3,
-table.dataTable.order-column.hover tbody tr.even:hover.selected > .sorting_3 {
-  background-color: #a4b2cb;
-}
-table.dataTable.no-footer {
-  border-bottom: 1px solid #111111;
-}
-table.dataTable.nowrap th, table.dataTable.nowrap td {
-  white-space: nowrap;
-}
-table.dataTable.compact thead th,
-table.dataTable.compact thead td {
-  padding: 5px 9px;
-}
-table.dataTable.compact tfoot th,
-table.dataTable.compact tfoot td {
-  padding: 5px 9px 3px 9px;
-}
-table.dataTable.compact tbody th,
-table.dataTable.compact tbody td {
-  padding: 4px 5px;
-}
-table.dataTable th.dt-left,
-table.dataTable td.dt-left {
-  text-align: left;
-}
-table.dataTable th.dt-center,
-table.dataTable td.dt-center,
-table.dataTable td.dataTables_empty {
-  text-align: center;
-}
-table.dataTable th.dt-right,
-table.dataTable td.dt-right {
-  text-align: right;
-}
-table.dataTable th.dt-justify,
-table.dataTable td.dt-justify {
-  text-align: justify;
-}
-table.dataTable th.dt-nowrap,
-table.dataTable td.dt-nowrap {
-  white-space: nowrap;
-}
-table.dataTable thead th.dt-head-left,
-table.dataTable thead td.dt-head-left,
-table.dataTable tfoot th.dt-head-left,
-table.dataTable tfoot td.dt-head-left {
-  text-align: left;
-}
-table.dataTable thead th.dt-head-center,
-table.dataTable thead td.dt-head-center,
-table.dataTable tfoot th.dt-head-center,
-table.dataTable tfoot td.dt-head-center {
-  text-align: center;
-}
-table.dataTable thead th.dt-head-right,
-table.dataTable thead td.dt-head-right,
-table.dataTable tfoot th.dt-head-right,
-table.dataTable tfoot td.dt-head-right {
-  text-align: right;
-}
-table.dataTable thead th.dt-head-justify,
-table.dataTable thead td.dt-head-justify,
-table.dataTable tfoot th.dt-head-justify,
-table.dataTable tfoot td.dt-head-justify {
-  text-align: justify;
-}
-table.dataTable thead th.dt-head-nowrap,
-table.dataTable thead td.dt-head-nowrap,
-table.dataTable tfoot th.dt-head-nowrap,
-table.dataTable tfoot td.dt-head-nowrap {
-  white-space: nowrap;
-}
-table.dataTable tbody th.dt-body-left,
-table.dataTable tbody td.dt-body-left {
-  text-align: left;
-}
-table.dataTable tbody th.dt-body-center,
-table.dataTable tbody td.dt-body-center {
-  text-align: center;
-}
-table.dataTable tbody th.dt-body-right,
-table.dataTable tbody td.dt-body-right {
-  text-align: right;
-}
-table.dataTable tbody th.dt-body-justify,
-table.dataTable tbody td.dt-body-justify {
-  text-align: justify;
-}
-table.dataTable tbody th.dt-body-nowrap,
-table.dataTable tbody td.dt-body-nowrap {
-  white-space: nowrap;
-}
-
-table.dataTable,
-table.dataTable th,
-table.dataTable td {
-  -webkit-box-sizing: content-box;
-  -moz-box-sizing: content-box;
-  box-sizing: content-box;
-}
-
-/*
- * Control feature layout
- */
-.dataTables_wrapper {
-  position: relative;
-  clear: both;
-  *zoom: 1;
-  zoom: 1;
-}
-.dataTables_wrapper .dataTables_length {
-  float: left;
-}
-.dataTables_wrapper .dataTables_filter {
-  float: right;
-  text-align: right;
-}
-.dataTables_wrapper .dataTables_filter input {
-  margin-left: 0.5em;
-}
-.dataTables_wrapper .dataTables_info {
-  clear: both;
-  float: left;
-  padding-top: 0.755em;
-}
-.dataTables_wrapper .dataTables_paginate {
-  float: right;
-  text-align: right;
-  padding-top: 0.25em;
-}
-.dataTables_wrapper .dataTables_paginate .paginate_button {
-  box-sizing: border-box;
-  display: inline-block;
-  min-width: 1.5em;
-  padding: 0.5em 1em;
-  margin-left: 2px;
-  text-align: center;
-  text-decoration: none !important;
-  cursor: pointer;
-  *cursor: hand;
-  color: #333333 !important;
-  border: 1px solid transparent;
-}
-.dataTables_wrapper .dataTables_paginate .paginate_button.current, .dataTables_wrapper .dataTables_paginate .paginate_button.current:hover {
-  color: #333333 !important;
-  border: 1px solid #cacaca;
-  background-color: white;
-  background: -webkit-gradient(linear, left top, left bottom, color-stop(0%, white), color-stop(100%, gainsboro));
-  /* Chrome,Safari4+ */
-  background: -webkit-linear-gradient(top, white 0%, gainsboro 100%);
-  /* Chrome10+,Safari5.1+ */
-  background: -moz-linear-gradient(top, white 0%, gainsboro 100%);
-  /* FF3.6+ */
-  background: -ms-linear-gradient(top, white 0%, gainsboro 100%);
-  /* IE10+ */
-  background: -o-linear-gradient(top, white 0%, gainsboro 100%);
-  /* Opera 11.10+ */
-  background: linear-gradient(to bottom, white 0%, gainsboro 100%);
-  /* W3C */
-}
-.dataTables_wrapper .dataTables_paginate .paginate_button.disabled, .dataTables_wrapper .dataTables_paginate .paginate_button.disabled:hover, .dataTables_wrapper .dataTables_paginate .paginate_button.disabled:active {
-  cursor: default;
-  color: #666 !important;
-  border: 1px solid transparent;
-  background: transparent;
-  box-shadow: none;
-}
-.dataTables_wrapper .dataTables_paginate .paginate_button:hover {
-  color: white !important;
-  border: 1px solid #111111;
-  background-color: #585858;
-  background: -webkit-gradient(linear, left top, left bottom, color-stop(0%, #585858), color-stop(100%, #111111));
-  /* Chrome,Safari4+ */
-  background: -webkit-linear-gradient(top, #585858 0%, #111111 100%);
-  /* Chrome10+,Safari5.1+ */
-  background: -moz-linear-gradient(top, #585858 0%, #111111 100%);
-  /* FF3.6+ */
-  background: -ms-linear-gradient(top, #585858 0%, #111111 100%);
-  /* IE10+ */
-  background: -o-linear-gradient(top, #585858 0%, #111111 100%);
-  /* Opera 11.10+ */
-  background: linear-gradient(to bottom, #585858 0%, #111111 100%);
-  /* W3C */
-}
-.dataTables_wrapper .dataTables_paginate .paginate_button:active {
-  outline: none;
-  background-color: #2b2b2b;
-  background: -webkit-gradient(linear, left top, left bottom, color-stop(0%, #2b2b2b), color-stop(100%, #0c0c0c));
-  /* Chrome,Safari4+ */
-  background: -webkit-linear-gradient(top, #2b2b2b 0%, #0c0c0c 100%);
-  /* Chrome10+,Safari5.1+ */
-  background: -moz-linear-gradient(top, #2b2b2b 0%, #0c0c0c 100%);
-  /* FF3.6+ */
-  background: -ms-linear-gradient(top, #2b2b2b 0%, #0c0c0c 100%);
-  /* IE10+ */
-  background: -o-linear-gradient(top, #2b2b2b 0%, #0c0c0c 100%);
-  /* Opera 11.10+ */
-  background: linear-gradient(to bottom, #2b2b2b 0%, #0c0c0c 100%);
-  /* W3C */
-  box-shadow: inset 0 0 3px #111;
-}
-.dataTables_wrapper .dataTables_processing {
-  position: absolute;
-  top: 50%;
-  left: 50%;
-  width: 100%;
-  height: 40px;
-  margin-left: -50%;
-  margin-top: -25px;
-  padding-top: 20px;
-  text-align: center;
-  font-size: 1.2em;
-  background-color: white;
-  background: -webkit-gradient(linear, left top, right top, color-stop(0%, rgba(255, 255, 255, 0)), color-stop(25%, rgba(255, 255, 255, 0.9)), color-stop(75%, rgba(255, 255, 255, 0.9)), color-stop(100%, rgba(255, 255, 255, 0)));
-  /* Chrome,Safari4+ */
-  background: -webkit-linear-gradient(left, rgba(255, 255, 255, 0) 0%, rgba(255, 255, 255, 0.9) 25%, rgba(255, 255, 255, 0.9) 75%, rgba(255, 255, 255, 0) 100%);
-  /* Chrome10+,Safari5.1+ */
-  background: -moz-linear-gradient(left, rgba(255, 255, 255, 0) 0%, rgba(255, 255, 255, 0.9) 25%, rgba(255, 255, 255, 0.9) 75%, rgba(255, 255, 255, 0) 100%);
-  /* FF3.6+ */
-  background: -ms-linear-gradient(left, rgba(255, 255, 255, 0) 0%, rgba(255, 255, 255, 0.9) 25%, rgba(255, 255, 255, 0.9) 75%, rgba(255, 255, 255, 0) 100%);
-  /* IE10+ */
-  background: -o-linear-gradient(left, rgba(255, 255, 255, 0) 0%, rgba(255, 255, 255, 0.9) 25%, rgba(255, 255, 255, 0.9) 75%, rgba(255, 255, 255, 0) 100%);
-  /* Opera 11.10+ */
-  background: linear-gradient(to right, rgba(255, 255, 255, 0) 0%, rgba(255, 255, 255, 0.9) 25%, rgba(255, 255, 255, 0.9) 75%, rgba(255, 255, 255, 0) 100%);
-  /* W3C */
-}
-.dataTables_wrapper .dataTables_length,
-.dataTables_wrapper .dataTables_filter,
-.dataTables_wrapper .dataTables_info,
-.dataTables_wrapper .dataTables_processing,
-.dataTables_wrapper .dataTables_paginate {
-  color: #333333;
-}
-.dataTables_wrapper .dataTables_scroll {
-  clear: both;
-}
-.dataTables_wrapper .dataTables_scroll div.dataTables_scrollBody {
-  *margin-top: -1px;
-  -webkit-overflow-scrolling: touch;
-}
-.dataTables_wrapper .dataTables_scroll div.dataTables_scrollBody th > div.dataTables_sizing,
-.dataTables_wrapper .dataTables_scroll div.dataTables_scrollBody td > div.dataTables_sizing {
-  height: 0;
-  overflow: hidden;
-  margin: 0 !important;
-  padding: 0 !important;
-}
-.dataTables_wrapper.no-footer .dataTables_scrollBody {
-  border-bottom: 1px solid #111111;
-}
-.dataTables_wrapper.no-footer div.dataTables_scrollHead table,
-.dataTables_wrapper.no-footer div.dataTables_scrollBody table {
-  border-bottom: none;
-}
-.dataTables_wrapper:after {
-  visibility: hidden;
-  display: block;
-  content: "";
-  clear: both;
-  height: 0;
-}
-
-@media screen and (max-width: 767px) {
-  .dataTables_wrapper .dataTables_info,
-  .dataTables_wrapper .dataTables_paginate {
-    float: none;
-    text-align: center;
-  }
-  .dataTables_wrapper .dataTables_paginate {
-    margin-top: 0.5em;
-  }
-}
-@media screen and (max-width: 640px) {
-  .dataTables_wrapper .dataTables_length,
-  .dataTables_wrapper .dataTables_filter {
-    float: none;
-    text-align: center;
-  }
-  .dataTables_wrapper .dataTables_filter {
-    margin-top: 0.5em;
-  }
-}
diff --git a/airflow/www_rbac/static/jquery.dataTables.min.js b/airflow/www_rbac/static/jquery.dataTables.min.js
deleted file mode 100644
index 59d4dac21f531..0000000000000
--- a/airflow/www_rbac/static/jquery.dataTables.min.js
+++ /dev/null
@@ -1,189 +0,0 @@
-/*
- * This combined file was created by the DataTables downloader builder:
- *   https://datatables.net/download
- *
- * To rebuild or modify this file with the latest versions of the included
- * software please visit:
- *   https://datatables.net/download/#bs/dt-1.10.10
- *
- * Included libraries:
- *   DataTables 1.10.10
- */
-
-/*!
- DataTables 1.10.10
- ©2008-2015 SpryMedia Ltd - datatables.net/license
-*/
-(function(h){"function"===typeof define&&define.amd?define(["jquery"],function(E){return h(E,window,document)}):"object"===typeof exports?module.exports=function(E,H){E||(E=window);H||(H="undefined"!==typeof window?require("jquery"):require("jquery")(E));return h(H,E,E.document)}:h(jQuery,window,document)})(function(h,E,H,k){function Y(a){var b,c,d={};h.each(a,function(e){if((b=e.match(/^([^A-Z]+?)([A-Z])/))&&-1!=="a aa ai ao as b fn i m o s ".indexOf(b[1]+" "))c=e.replace(b[0],b[2].toLowerCase()),
-d[c]=e,"o"===b[1]&&Y(a[e])});a._hungarianMap=d}function J(a,b,c){a._hungarianMap||Y(a);var d;h.each(b,function(e){d=a._hungarianMap[e];if(d!==k&&(c||b[d]===k))"o"===d.charAt(0)?(b[d]||(b[d]={}),h.extend(!0,b[d],b[e]),J(a[d],b[d],c)):b[d]=b[e]})}function Fa(a){var b=m.defaults.oLanguage,c=a.sZeroRecords;!a.sEmptyTable&&(c&&"No data available in table"===b.sEmptyTable)&&F(a,a,"sZeroRecords","sEmptyTable");!a.sLoadingRecords&&(c&&"Loading..."===b.sLoadingRecords)&&F(a,a,"sZeroRecords","sLoadingRecords");
-a.sInfoThousands&&(a.sThousands=a.sInfoThousands);(a=a.sDecimal)&&db(a)}function eb(a){A(a,"ordering","bSort");A(a,"orderMulti","bSortMulti");A(a,"orderClasses","bSortClasses");A(a,"orderCellsTop","bSortCellsTop");A(a,"order","aaSorting");A(a,"orderFixed","aaSortingFixed");A(a,"paging","bPaginate");A(a,"pagingType","sPaginationType");A(a,"pageLength","iDisplayLength");A(a,"searching","bFilter");"boolean"===typeof a.sScrollX&&(a.sScrollX=a.sScrollX?"100%":"");"boolean"===typeof a.scrollX&&(a.scrollX=
-a.scrollX?"100%":"");if(a=a.aoSearchCols)for(var b=0,c=a.length;b<c;b++)a[b]&&J(m.models.oSearch,a[b])}function fb(a){A(a,"orderable","bSortable");A(a,"orderData","aDataSort");A(a,"orderSequence","asSorting");A(a,"orderDataType","sortDataType");var b=a.aDataSort;b&&!h.isArray(b)&&(a.aDataSort=[b])}function gb(a){if(!m.__browser){var b={};m.__browser=b;var c=h("<div/>").css({position:"fixed",top:0,left:0,height:1,width:1,overflow:"hidden"}).append(h("<div/>").css({position:"absolute",top:1,left:1,
-width:100,overflow:"scroll"}).append(h("<div/>").css({width:"100%",height:10}))).appendTo("body"),d=c.children(),e=d.children();b.barWidth=d[0].offsetWidth-d[0].clientWidth;b.bScrollOversize=100===e[0].offsetWidth&&100!==d[0].clientWidth;b.bScrollbarLeft=1!==Math.round(e.offset().left);b.bBounding=c[0].getBoundingClientRect().width?!0:!1;c.remove()}h.extend(a.oBrowser,m.__browser);a.oScroll.iBarWidth=m.__browser.barWidth}function hb(a,b,c,d,e,f){var g,j=!1;c!==k&&(g=c,j=!0);for(;d!==e;)a.hasOwnProperty(d)&&
-(g=j?b(g,a[d],d,a):a[d],j=!0,d+=f);return g}function Ga(a,b){var c=m.defaults.column,d=a.aoColumns.length,c=h.extend({},m.models.oColumn,c,{nTh:b?b:H.createElement("th"),sTitle:c.sTitle?c.sTitle:b?b.innerHTML:"",aDataSort:c.aDataSort?c.aDataSort:[d],mData:c.mData?c.mData:d,idx:d});a.aoColumns.push(c);c=a.aoPreSearchCols;c[d]=h.extend({},m.models.oSearch,c[d]);la(a,d,h(b).data())}function la(a,b,c){var b=a.aoColumns[b],d=a.oClasses,e=h(b.nTh);if(!b.sWidthOrig){b.sWidthOrig=e.attr("width")||null;var f=
-(e.attr("style")||"").match(/width:\s*(\d+[pxem%]+)/);f&&(b.sWidthOrig=f[1])}c!==k&&null!==c&&(fb(c),J(m.defaults.column,c),c.mDataProp!==k&&!c.mData&&(c.mData=c.mDataProp),c.sType&&(b._sManualType=c.sType),c.className&&!c.sClass&&(c.sClass=c.className),h.extend(b,c),F(b,c,"sWidth","sWidthOrig"),c.iDataSort!==k&&(b.aDataSort=[c.iDataSort]),F(b,c,"aDataSort"));var g=b.mData,j=Q(g),i=b.mRender?Q(b.mRender):null,c=function(a){return"string"===typeof a&&-1!==a.indexOf("@")};b._bAttrSrc=h.isPlainObject(g)&&
-(c(g.sort)||c(g.type)||c(g.filter));b.fnGetData=function(a,b,c){var d=j(a,b,k,c);return i&&b?i(d,b,a,c):d};b.fnSetData=function(a,b,c){return R(g)(a,b,c)};"number"!==typeof g&&(a._rowReadObject=!0);a.oFeatures.bSort||(b.bSortable=!1,e.addClass(d.sSortableNone));a=-1!==h.inArray("asc",b.asSorting);c=-1!==h.inArray("desc",b.asSorting);!b.bSortable||!a&&!c?(b.sSortingClass=d.sSortableNone,b.sSortingClassJUI=""):a&&!c?(b.sSortingClass=d.sSortableAsc,b.sSortingClassJUI=d.sSortJUIAscAllowed):!a&&c?(b.sSortingClass=
-d.sSortableDesc,b.sSortingClassJUI=d.sSortJUIDescAllowed):(b.sSortingClass=d.sSortable,b.sSortingClassJUI=d.sSortJUI)}function U(a){if(!1!==a.oFeatures.bAutoWidth){var b=a.aoColumns;Ha(a);for(var c=0,d=b.length;c<d;c++)b[c].nTh.style.width=b[c].sWidth}b=a.oScroll;(""!==b.sY||""!==b.sX)&&Z(a);v(a,null,"column-sizing",[a])}function $(a,b){var c=aa(a,"bVisible");return"number"===typeof c[b]?c[b]:null}function ba(a,b){var c=aa(a,"bVisible"),c=h.inArray(b,c);return-1!==c?c:null}function ca(a){return aa(a,
-"bVisible").length}function aa(a,b){var c=[];h.map(a.aoColumns,function(a,e){a[b]&&c.push(e)});return c}function Ia(a){var b=a.aoColumns,c=a.aoData,d=m.ext.type.detect,e,f,g,j,i,h,l,q,u;e=0;for(f=b.length;e<f;e++)if(l=b[e],u=[],!l.sType&&l._sManualType)l.sType=l._sManualType;else if(!l.sType){g=0;for(j=d.length;g<j;g++){i=0;for(h=c.length;i<h;i++){u[i]===k&&(u[i]=B(a,i,e,"type"));q=d[g](u[i],a);if(!q&&g!==d.length-1)break;if("html"===q)break}if(q){l.sType=q;break}}l.sType||(l.sType="string")}}function ib(a,
-b,c,d){var e,f,g,j,i,o,l=a.aoColumns;if(b)for(e=b.length-1;0<=e;e--){o=b[e];var q=o.targets!==k?o.targets:o.aTargets;h.isArray(q)||(q=[q]);f=0;for(g=q.length;f<g;f++)if("number"===typeof q[f]&&0<=q[f]){for(;l.length<=q[f];)Ga(a);d(q[f],o)}else if("number"===typeof q[f]&&0>q[f])d(l.length+q[f],o);else if("string"===typeof q[f]){j=0;for(i=l.length;j<i;j++)("_all"==q[f]||h(l[j].nTh).hasClass(q[f]))&&d(j,o)}}if(c){e=0;for(a=c.length;e<a;e++)d(e,c[e])}}function N(a,b,c,d){var e=a.aoData.length,f=h.extend(!0,
-{},m.models.oRow,{src:c?"dom":"data",idx:e});f._aData=b;a.aoData.push(f);for(var g=a.aoColumns,j=0,i=g.length;j<i;j++)g[j].sType=null;a.aiDisplayMaster.push(e);b=a.rowIdFn(b);b!==k&&(a.aIds[b]=f);(c||!a.oFeatures.bDeferRender)&&Ja(a,e,c,d);return e}function ma(a,b){var c;b instanceof h||(b=h(b));return b.map(function(b,e){c=Ka(a,e);return N(a,c.data,e,c.cells)})}function B(a,b,c,d){var e=a.iDraw,f=a.aoColumns[c],g=a.aoData[b]._aData,j=f.sDefaultContent,i=f.fnGetData(g,d,{settings:a,row:b,col:c});
-if(i===k)return a.iDrawError!=e&&null===j&&(K(a,0,"Requested unknown parameter "+("function"==typeof f.mData?"{function}":"'"+f.mData+"'")+" for row "+b+", column "+c,4),a.iDrawError=e),j;if((i===g||null===i)&&null!==j)i=j;else if("function"===typeof i)return i.call(g);return null===i&&"display"==d?"":i}function jb(a,b,c,d){a.aoColumns[c].fnSetData(a.aoData[b]._aData,d,{settings:a,row:b,col:c})}function La(a){return h.map(a.match(/(\\.|[^\.])+/g)||[""],function(a){return a.replace(/\\./g,".")})}function Q(a){if(h.isPlainObject(a)){var b=
-{};h.each(a,function(a,c){c&&(b[a]=Q(c))});return function(a,c,f,g){var j=b[c]||b._;return j!==k?j(a,c,f,g):a}}if(null===a)return function(a){return a};if("function"===typeof a)return function(b,c,f,g){return a(b,c,f,g)};if("string"===typeof a&&(-1!==a.indexOf(".")||-1!==a.indexOf("[")||-1!==a.indexOf("("))){var c=function(a,b,f){var g,j;if(""!==f){j=La(f);for(var i=0,o=j.length;i<o;i++){f=j[i].match(da);g=j[i].match(V);if(f){j[i]=j[i].replace(da,"");""!==j[i]&&(a=a[j[i]]);g=[];j.splice(0,i+1);j=
-j.join(".");if(h.isArray(a)){i=0;for(o=a.length;i<o;i++)g.push(c(a[i],b,j))}a=f[0].substring(1,f[0].length-1);a=""===a?g:g.join(a);break}else if(g){j[i]=j[i].replace(V,"");a=a[j[i]]();continue}if(null===a||a[j[i]]===k)return k;a=a[j[i]]}}return a};return function(b,e){return c(b,e,a)}}return function(b){return b[a]}}function R(a){if(h.isPlainObject(a))return R(a._);if(null===a)return function(){};if("function"===typeof a)return function(b,d,e){a(b,"set",d,e)};if("string"===typeof a&&(-1!==a.indexOf(".")||
--1!==a.indexOf("[")||-1!==a.indexOf("("))){var b=function(a,d,e){var e=La(e),f;f=e[e.length-1];for(var g,j,i=0,o=e.length-1;i<o;i++){g=e[i].match(da);j=e[i].match(V);if(g){e[i]=e[i].replace(da,"");a[e[i]]=[];f=e.slice();f.splice(0,i+1);g=f.join(".");if(h.isArray(d)){j=0;for(o=d.length;j<o;j++)f={},b(f,d[j],g),a[e[i]].push(f)}else a[e[i]]=d;return}j&&(e[i]=e[i].replace(V,""),a=a[e[i]](d));if(null===a[e[i]]||a[e[i]]===k)a[e[i]]={};a=a[e[i]]}if(f.match(V))a[f.replace(V,"")](d);else a[f.replace(da,"")]=
-d};return function(c,d){return b(c,d,a)}}return function(b,d){b[a]=d}}function Ma(a){return D(a.aoData,"_aData")}function na(a){a.aoData.length=0;a.aiDisplayMaster.length=0;a.aiDisplay.length=0;a.aIds={}}function oa(a,b,c){for(var d=-1,e=0,f=a.length;e<f;e++)a[e]==b?d=e:a[e]>b&&a[e]--; -1!=d&&c===k&&a.splice(d,1)}function ea(a,b,c,d){var e=a.aoData[b],f,g=function(c,d){for(;c.childNodes.length;)c.removeChild(c.firstChild);c.innerHTML=B(a,b,d,"display")};if("dom"===c||(!c||"auto"===c)&&"dom"===e.src)e._aData=
-Ka(a,e,d,d===k?k:e._aData).data;else{var j=e.anCells;if(j)if(d!==k)g(j[d],d);else{c=0;for(f=j.length;c<f;c++)g(j[c],c)}}e._aSortData=null;e._aFilterData=null;g=a.aoColumns;if(d!==k)g[d].sType=null;else{c=0;for(f=g.length;c<f;c++)g[c].sType=null;Na(a,e)}}function Ka(a,b,c,d){var e=[],f=b.firstChild,g,j,i=0,o,l=a.aoColumns,q=a._rowReadObject,d=d!==k?d:q?{}:[],u=function(a,b){if("string"===typeof a){var c=a.indexOf("@");-1!==c&&(c=a.substring(c+1),R(a)(d,b.getAttribute(c)))}},S=function(a){if(c===k||
-c===i)j=l[i],o=h.trim(a.innerHTML),j&&j._bAttrSrc?(R(j.mData._)(d,o),u(j.mData.sort,a),u(j.mData.type,a),u(j.mData.filter,a)):q?(j._setter||(j._setter=R(j.mData)),j._setter(d,o)):d[i]=o;i++};if(f)for(;f;){g=f.nodeName.toUpperCase();if("TD"==g||"TH"==g)S(f),e.push(f);f=f.nextSibling}else{e=b.anCells;f=0;for(g=e.length;f<g;f++)S(e[f])}if(b=b.firstChild?b:b.nTr)(b=b.getAttribute("id"))&&R(a.rowId)(d,b);return{data:d,cells:e}}function Ja(a,b,c,d){var e=a.aoData[b],f=e._aData,g=[],j,i,h,l,q;if(null===
-e.nTr){j=c||H.createElement("tr");e.nTr=j;e.anCells=g;j._DT_RowIndex=b;Na(a,e);l=0;for(q=a.aoColumns.length;l<q;l++){h=a.aoColumns[l];i=c?d[l]:H.createElement(h.sCellType);i._DT_CellIndex={row:b,column:l};g.push(i);if(!c||h.mRender||h.mData!==l)i.innerHTML=B(a,b,l,"display");h.sClass&&(i.className+=" "+h.sClass);h.bVisible&&!c?j.appendChild(i):!h.bVisible&&c&&i.parentNode.removeChild(i);h.fnCreatedCell&&h.fnCreatedCell.call(a.oInstance,i,B(a,b,l),f,b,l)}v(a,"aoRowCreatedCallback",null,[j,f,b])}e.nTr.setAttribute("role",
-"row")}function Na(a,b){var c=b.nTr,d=b._aData;if(c){var e=a.rowIdFn(d);e&&(c.id=e);d.DT_RowClass&&(e=d.DT_RowClass.split(" "),b.__rowc=b.__rowc?pa(b.__rowc.concat(e)):e,h(c).removeClass(b.__rowc.join(" ")).addClass(d.DT_RowClass));d.DT_RowAttr&&h(c).attr(d.DT_RowAttr);d.DT_RowData&&h(c).data(d.DT_RowData)}}function kb(a){var b,c,d,e,f,g=a.nTHead,j=a.nTFoot,i=0===h("th, td",g).length,o=a.oClasses,l=a.aoColumns;i&&(e=h("<tr/>").appendTo(g));b=0;for(c=l.length;b<c;b++)f=l[b],d=h(f.nTh).addClass(f.sClass),
-i&&d.appendTo(e),a.oFeatures.bSort&&(d.addClass(f.sSortingClass),!1!==f.bSortable&&(d.attr("tabindex",a.iTabIndex).attr("aria-controls",a.sTableId),Oa(a,f.nTh,b))),f.sTitle!=d[0].innerHTML&&d.html(f.sTitle),Pa(a,"header")(a,d,f,o);i&&fa(a.aoHeader,g);h(g).find(">tr").attr("role","row");h(g).find(">tr>th, >tr>td").addClass(o.sHeaderTH);h(j).find(">tr>th, >tr>td").addClass(o.sFooterTH);if(null!==j){a=a.aoFooter[0];b=0;for(c=a.length;b<c;b++)f=l[b],f.nTf=a[b].cell,f.sClass&&h(f.nTf).addClass(f.sClass)}}
-function ga(a,b,c){var d,e,f,g=[],j=[],i=a.aoColumns.length,o;if(b){c===k&&(c=!1);d=0;for(e=b.length;d<e;d++){g[d]=b[d].slice();g[d].nTr=b[d].nTr;for(f=i-1;0<=f;f--)!a.aoColumns[f].bVisible&&!c&&g[d].splice(f,1);j.push([])}d=0;for(e=g.length;d<e;d++){if(a=g[d].nTr)for(;f=a.firstChild;)a.removeChild(f);f=0;for(b=g[d].length;f<b;f++)if(o=i=1,j[d][f]===k){a.appendChild(g[d][f].cell);for(j[d][f]=1;g[d+i]!==k&&g[d][f].cell==g[d+i][f].cell;)j[d+i][f]=1,i++;for(;g[d][f+o]!==k&&g[d][f].cell==g[d][f+o].cell;){for(c=
-0;c<i;c++)j[d+c][f+o]=1;o++}h(g[d][f].cell).attr("rowspan",i).attr("colspan",o)}}}}function O(a){var b=v(a,"aoPreDrawCallback","preDraw",[a]);if(-1!==h.inArray(!1,b))C(a,!1);else{var b=[],c=0,d=a.asStripeClasses,e=d.length,f=a.oLanguage,g=a.iInitDisplayStart,j="ssp"==y(a),i=a.aiDisplay;a.bDrawing=!0;g!==k&&-1!==g&&(a._iDisplayStart=j?g:g>=a.fnRecordsDisplay()?0:g,a.iInitDisplayStart=-1);var g=a._iDisplayStart,o=a.fnDisplayEnd();if(a.bDeferLoading)a.bDeferLoading=!1,a.iDraw++,C(a,!1);else if(j){if(!a.bDestroying&&
-!lb(a))return}else a.iDraw++;if(0!==i.length){f=j?a.aoData.length:o;for(j=j?0:g;j<f;j++){var l=i[j],q=a.aoData[l];null===q.nTr&&Ja(a,l);l=q.nTr;if(0!==e){var u=d[c%e];q._sRowStripe!=u&&(h(l).removeClass(q._sRowStripe).addClass(u),q._sRowStripe=u)}v(a,"aoRowCallback",null,[l,q._aData,c,j]);b.push(l);c++}}else c=f.sZeroRecords,1==a.iDraw&&"ajax"==y(a)?c=f.sLoadingRecords:f.sEmptyTable&&0===a.fnRecordsTotal()&&(c=f.sEmptyTable),b[0]=h("<tr/>",{"class":e?d[0]:""}).append(h("<td />",{valign:"top",colSpan:ca(a),
-"class":a.oClasses.sRowEmpty}).html(c))[0];v(a,"aoHeaderCallback","header",[h(a.nTHead).children("tr")[0],Ma(a),g,o,i]);v(a,"aoFooterCallback","footer",[h(a.nTFoot).children("tr")[0],Ma(a),g,o,i]);d=h(a.nTBody);d.children().detach();d.append(h(b));v(a,"aoDrawCallback","draw",[a]);a.bSorted=!1;a.bFiltered=!1;a.bDrawing=!1}}function T(a,b){var c=a.oFeatures,d=c.bFilter;c.bSort&&mb(a);d?ha(a,a.oPreviousSearch):a.aiDisplay=a.aiDisplayMaster.slice();!0!==b&&(a._iDisplayStart=0);a._drawHold=b;O(a);a._drawHold=
-!1}function nb(a){var b=a.oClasses,c=h(a.nTable),c=h("<div/>").insertBefore(c),d=a.oFeatures,e=h("<div/>",{id:a.sTableId+"_wrapper","class":b.sWrapper+(a.nTFoot?"":" "+b.sNoFooter)});a.nHolding=c[0];a.nTableWrapper=e[0];a.nTableReinsertBefore=a.nTable.nextSibling;for(var f=a.sDom.split(""),g,j,i,o,l,q,u=0;u<f.length;u++){g=null;j=f[u];if("<"==j){i=h("<div/>")[0];o=f[u+1];if("'"==o||'"'==o){l="";for(q=2;f[u+q]!=o;)l+=f[u+q],q++;"H"==l?l=b.sJUIHeader:"F"==l&&(l=b.sJUIFooter);-1!=l.indexOf(".")?(o=l.split("."),
-i.id=o[0].substr(1,o[0].length-1),i.className=o[1]):"#"==l.charAt(0)?i.id=l.substr(1,l.length-1):i.className=l;u+=q}e.append(i);e=h(i)}else if(">"==j)e=e.parent();else if("l"==j&&d.bPaginate&&d.bLengthChange)g=ob(a);else if("f"==j&&d.bFilter)g=pb(a);else if("r"==j&&d.bProcessing)g=qb(a);else if("t"==j)g=rb(a);else if("i"==j&&d.bInfo)g=sb(a);else if("p"==j&&d.bPaginate)g=tb(a);else if(0!==m.ext.feature.length){i=m.ext.feature;q=0;for(o=i.length;q<o;q++)if(j==i[q].cFeature){g=i[q].fnInit(a);break}}g&&
-(i=a.aanFeatures,i[j]||(i[j]=[]),i[j].push(g),e.append(g))}c.replaceWith(e);a.nHolding=null}function fa(a,b){var c=h(b).children("tr"),d,e,f,g,j,i,o,l,q,u;a.splice(0,a.length);f=0;for(i=c.length;f<i;f++)a.push([]);f=0;for(i=c.length;f<i;f++){d=c[f];for(e=d.firstChild;e;){if("TD"==e.nodeName.toUpperCase()||"TH"==e.nodeName.toUpperCase()){l=1*e.getAttribute("colspan");q=1*e.getAttribute("rowspan");l=!l||0===l||1===l?1:l;q=!q||0===q||1===q?1:q;g=0;for(j=a[f];j[g];)g++;o=g;u=1===l?!0:!1;for(j=0;j<l;j++)for(g=
-0;g<q;g++)a[f+g][o+j]={cell:e,unique:u},a[f+g].nTr=d}e=e.nextSibling}}}function qa(a,b,c){var d=[];c||(c=a.aoHeader,b&&(c=[],fa(c,b)));for(var b=0,e=c.length;b<e;b++)for(var f=0,g=c[b].length;f<g;f++)if(c[b][f].unique&&(!d[f]||!a.bSortCellsTop))d[f]=c[b][f].cell;return d}function ra(a,b,c){v(a,"aoServerParams","serverParams",[b]);if(b&&h.isArray(b)){var d={},e=/(.*?)\[\]$/;h.each(b,function(a,b){var c=b.name.match(e);c?(c=c[0],d[c]||(d[c]=[]),d[c].push(b.value)):d[b.name]=b.value});b=d}var f,g=a.ajax,
-j=a.oInstance,i=function(b){v(a,null,"xhr",[a,b,a.jqXHR]);c(b)};if(h.isPlainObject(g)&&g.data){f=g.data;var o=h.isFunction(f)?f(b,a):f,b=h.isFunction(f)&&o?o:h.extend(!0,b,o);delete g.data}o={data:b,success:function(b){var c=b.error||b.sError;c&&K(a,0,c);a.json=b;i(b)},dataType:"json",cache:!1,type:a.sServerMethod,error:function(b,c){var d=v(a,null,"xhr",[a,null,a.jqXHR]);-1===h.inArray(!0,d)&&("parsererror"==c?K(a,0,"Invalid JSON response",1):4===b.readyState&&K(a,0,"Ajax error",7));C(a,!1)}};a.oAjaxData=
-b;v(a,null,"preXhr",[a,b]);a.fnServerData?a.fnServerData.call(j,a.sAjaxSource,h.map(b,function(a,b){return{name:b,value:a}}),i,a):a.sAjaxSource||"string"===typeof g?a.jqXHR=h.ajax(h.extend(o,{url:g||a.sAjaxSource})):h.isFunction(g)?a.jqXHR=g.call(j,b,i,a):(a.jqXHR=h.ajax(h.extend(o,g)),g.data=f)}function lb(a){return a.bAjaxDataGet?(a.iDraw++,C(a,!0),ra(a,ub(a),function(b){vb(a,b)}),!1):!0}function ub(a){var b=a.aoColumns,c=b.length,d=a.oFeatures,e=a.oPreviousSearch,f=a.aoPreSearchCols,g,j=[],i,o,
-l,q=W(a);g=a._iDisplayStart;i=!1!==d.bPaginate?a._iDisplayLength:-1;var k=function(a,b){j.push({name:a,value:b})};k("sEcho",a.iDraw);k("iColumns",c);k("sColumns",D(b,"sName").join(","));k("iDisplayStart",g);k("iDisplayLength",i);var S={draw:a.iDraw,columns:[],order:[],start:g,length:i,search:{value:e.sSearch,regex:e.bRegex}};for(g=0;g<c;g++)o=b[g],l=f[g],i="function"==typeof o.mData?"function":o.mData,S.columns.push({data:i,name:o.sName,searchable:o.bSearchable,orderable:o.bSortable,search:{value:l.sSearch,
-regex:l.bRegex}}),k("mDataProp_"+g,i),d.bFilter&&(k("sSearch_"+g,l.sSearch),k("bRegex_"+g,l.bRegex),k("bSearchable_"+g,o.bSearchable)),d.bSort&&k("bSortable_"+g,o.bSortable);d.bFilter&&(k("sSearch",e.sSearch),k("bRegex",e.bRegex));d.bSort&&(h.each(q,function(a,b){S.order.push({column:b.col,dir:b.dir});k("iSortCol_"+a,b.col);k("sSortDir_"+a,b.dir)}),k("iSortingCols",q.length));b=m.ext.legacy.ajax;return null===b?a.sAjaxSource?j:S:b?j:S}function vb(a,b){var c=sa(a,b),d=b.sEcho!==k?b.sEcho:b.draw,e=
-b.iTotalRecords!==k?b.iTotalRecords:b.recordsTotal,f=b.iTotalDisplayRecords!==k?b.iTotalDisplayRecords:b.recordsFiltered;if(d){if(1*d<a.iDraw)return;a.iDraw=1*d}na(a);a._iRecordsTotal=parseInt(e,10);a._iRecordsDisplay=parseInt(f,10);d=0;for(e=c.length;d<e;d++)N(a,c[d]);a.aiDisplay=a.aiDisplayMaster.slice();a.bAjaxDataGet=!1;O(a);a._bInitComplete||ta(a,b);a.bAjaxDataGet=!0;C(a,!1)}function sa(a,b){var c=h.isPlainObject(a.ajax)&&a.ajax.dataSrc!==k?a.ajax.dataSrc:a.sAjaxDataProp;return"data"===c?b.aaData||
-b[c]:""!==c?Q(c)(b):b}function pb(a){var b=a.oClasses,c=a.sTableId,d=a.oLanguage,e=a.oPreviousSearch,f=a.aanFeatures,g='<input type="search" class="'+b.sFilterInput+'"/>',j=d.sSearch,j=j.match(/_INPUT_/)?j.replace("_INPUT_",g):j+g,b=h("<div/>",{id:!f.f?c+"_filter":null,"class":b.sFilter}).append(h("<label/>").append(j)),f=function(){var b=!this.value?"":this.value;b!=e.sSearch&&(ha(a,{sSearch:b,bRegex:e.bRegex,bSmart:e.bSmart,bCaseInsensitive:e.bCaseInsensitive}),a._iDisplayStart=0,O(a))},g=null!==
-a.searchDelay?a.searchDelay:"ssp"===y(a)?400:0,i=h("input",b).val(e.sSearch).attr("placeholder",d.sSearchPlaceholder).bind("keyup.DT search.DT input.DT paste.DT cut.DT",g?ua(f,g):f).bind("keypress.DT",function(a){if(13==a.keyCode)return!1}).attr("aria-controls",c);h(a.nTable).on("search.dt.DT",function(b,c){if(a===c)try{i[0]!==H.activeElement&&i.val(e.sSearch)}catch(d){}});return b[0]}function ha(a,b,c){var d=a.oPreviousSearch,e=a.aoPreSearchCols,f=function(a){d.sSearch=a.sSearch;d.bRegex=a.bRegex;
-d.bSmart=a.bSmart;d.bCaseInsensitive=a.bCaseInsensitive};Ia(a);if("ssp"!=y(a)){wb(a,b.sSearch,c,b.bEscapeRegex!==k?!b.bEscapeRegex:b.bRegex,b.bSmart,b.bCaseInsensitive);f(b);for(b=0;b<e.length;b++)xb(a,e[b].sSearch,b,e[b].bEscapeRegex!==k?!e[b].bEscapeRegex:e[b].bRegex,e[b].bSmart,e[b].bCaseInsensitive);yb(a)}else f(b);a.bFiltered=!0;v(a,null,"search",[a])}function yb(a){for(var b=m.ext.search,c=a.aiDisplay,d,e,f=0,g=b.length;f<g;f++){for(var j=[],i=0,o=c.length;i<o;i++)e=c[i],d=a.aoData[e],b[f](a,
-d._aFilterData,e,d._aData,i)&&j.push(e);c.length=0;h.merge(c,j)}}function xb(a,b,c,d,e,f){if(""!==b)for(var g=a.aiDisplay,d=Qa(b,d,e,f),e=g.length-1;0<=e;e--)b=a.aoData[g[e]]._aFilterData[c],d.test(b)||g.splice(e,1)}function wb(a,b,c,d,e,f){var d=Qa(b,d,e,f),e=a.oPreviousSearch.sSearch,f=a.aiDisplayMaster,g;0!==m.ext.search.length&&(c=!0);g=zb(a);if(0>=b.length)a.aiDisplay=f.slice();else{if(g||c||e.length>b.length||0!==b.indexOf(e)||a.bSorted)a.aiDisplay=f.slice();b=a.aiDisplay;for(c=b.length-1;0<=
-c;c--)d.test(a.aoData[b[c]]._sFilterRow)||b.splice(c,1)}}function Qa(a,b,c,d){a=b?a:va(a);c&&(a="^(?=.*?"+h.map(a.match(/"[^"]+"|[^ ]+/g)||[""],function(a){if('"'===a.charAt(0))var b=a.match(/^"(.*)"$/),a=b?b[1]:a;return a.replace('"',"")}).join(")(?=.*?")+").*$");return RegExp(a,d?"i":"")}function va(a){return a.replace(Yb,"\\$1")}function zb(a){var b=a.aoColumns,c,d,e,f,g,j,i,h,l=m.ext.type.search;c=!1;d=0;for(f=a.aoData.length;d<f;d++)if(h=a.aoData[d],!h._aFilterData){j=[];e=0;for(g=b.length;e<
-g;e++)c=b[e],c.bSearchable?(i=B(a,d,e,"filter"),l[c.sType]&&(i=l[c.sType](i)),null===i&&(i=""),"string"!==typeof i&&i.toString&&(i=i.toString())):i="",i.indexOf&&-1!==i.indexOf("&")&&(wa.innerHTML=i,i=Zb?wa.textContent:wa.innerText),i.replace&&(i=i.replace(/[\r\n]/g,"")),j.push(i);h._aFilterData=j;h._sFilterRow=j.join("  ");c=!0}return c}function Ab(a){return{search:a.sSearch,smart:a.bSmart,regex:a.bRegex,caseInsensitive:a.bCaseInsensitive}}function Bb(a){return{sSearch:a.search,bSmart:a.smart,bRegex:a.regex,
-bCaseInsensitive:a.caseInsensitive}}function sb(a){var b=a.sTableId,c=a.aanFeatures.i,d=h("<div/>",{"class":a.oClasses.sInfo,id:!c?b+"_info":null});c||(a.aoDrawCallback.push({fn:Cb,sName:"information"}),d.attr("role","status").attr("aria-live","polite"),h(a.nTable).attr("aria-describedby",b+"_info"));return d[0]}function Cb(a){var b=a.aanFeatures.i;if(0!==b.length){var c=a.oLanguage,d=a._iDisplayStart+1,e=a.fnDisplayEnd(),f=a.fnRecordsTotal(),g=a.fnRecordsDisplay(),j=g?c.sInfo:c.sInfoEmpty;g!==f&&
-(j+=" "+c.sInfoFiltered);j+=c.sInfoPostFix;j=Db(a,j);c=c.fnInfoCallback;null!==c&&(j=c.call(a.oInstance,a,d,e,f,g,j));h(b).html(j)}}function Db(a,b){var c=a.fnFormatNumber,d=a._iDisplayStart+1,e=a._iDisplayLength,f=a.fnRecordsDisplay(),g=-1===e;return b.replace(/_START_/g,c.call(a,d)).replace(/_END_/g,c.call(a,a.fnDisplayEnd())).replace(/_MAX_/g,c.call(a,a.fnRecordsTotal())).replace(/_TOTAL_/g,c.call(a,f)).replace(/_PAGE_/g,c.call(a,g?1:Math.ceil(d/e))).replace(/_PAGES_/g,c.call(a,g?1:Math.ceil(f/
-e)))}function ia(a){var b,c,d=a.iInitDisplayStart,e=a.aoColumns,f;c=a.oFeatures;var g=a.bDeferLoading;if(a.bInitialised){nb(a);kb(a);ga(a,a.aoHeader);ga(a,a.aoFooter);C(a,!0);c.bAutoWidth&&Ha(a);b=0;for(c=e.length;b<c;b++)f=e[b],f.sWidth&&(f.nTh.style.width=w(f.sWidth));v(a,null,"preInit",[a]);T(a);e=y(a);if("ssp"!=e||g)"ajax"==e?ra(a,[],function(c){var f=sa(a,c);for(b=0;b<f.length;b++)N(a,f[b]);a.iInitDisplayStart=d;T(a);C(a,!1);ta(a,c)},a):(C(a,!1),ta(a))}else setTimeout(function(){ia(a)},200)}
-function ta(a,b){a._bInitComplete=!0;(b||a.oInit.aaData)&&U(a);v(a,null,"plugin-init",[a,b]);v(a,"aoInitComplete","init",[a,b])}function Ra(a,b){var c=parseInt(b,10);a._iDisplayLength=c;Sa(a);v(a,null,"length",[a,c])}function ob(a){for(var b=a.oClasses,c=a.sTableId,d=a.aLengthMenu,e=h.isArray(d[0]),f=e?d[0]:d,d=e?d[1]:d,e=h("<select/>",{name:c+"_length","aria-controls":c,"class":b.sLengthSelect}),g=0,j=f.length;g<j;g++)e[0][g]=new Option(d[g],f[g]);var i=h("<div><label/></div>").addClass(b.sLength);
-a.aanFeatures.l||(i[0].id=c+"_length");i.children().append(a.oLanguage.sLengthMenu.replace("_MENU_",e[0].outerHTML));h("select",i).val(a._iDisplayLength).bind("change.DT",function(){Ra(a,h(this).val());O(a)});h(a.nTable).bind("length.dt.DT",function(b,c,d){a===c&&h("select",i).val(d)});return i[0]}function tb(a){var b=a.sPaginationType,c=m.ext.pager[b],d="function"===typeof c,e=function(a){O(a)},b=h("<div/>").addClass(a.oClasses.sPaging+b)[0],f=a.aanFeatures;d||c.fnInit(a,b,e);f.p||(b.id=a.sTableId+
-"_paginate",a.aoDrawCallback.push({fn:function(a){if(d){var b=a._iDisplayStart,i=a._iDisplayLength,h=a.fnRecordsDisplay(),l=-1===i,b=l?0:Math.ceil(b/i),i=l?1:Math.ceil(h/i),h=c(b,i),k,l=0;for(k=f.p.length;l<k;l++)Pa(a,"pageButton")(a,f.p[l],l,h,b,i)}else c.fnUpdate(a,e)},sName:"pagination"}));return b}function Ta(a,b,c){var d=a._iDisplayStart,e=a._iDisplayLength,f=a.fnRecordsDisplay();0===f||-1===e?d=0:"number"===typeof b?(d=b*e,d>f&&(d=0)):"first"==b?d=0:"previous"==b?(d=0<=e?d-e:0,0>d&&(d=0)):"next"==
-b?d+e<f&&(d+=e):"last"==b?d=Math.floor((f-1)/e)*e:K(a,0,"Unknown paging action: "+b,5);b=a._iDisplayStart!==d;a._iDisplayStart=d;b&&(v(a,null,"page",[a]),c&&O(a));return b}function qb(a){return h("<div/>",{id:!a.aanFeatures.r?a.sTableId+"_processing":null,"class":a.oClasses.sProcessing}).html(a.oLanguage.sProcessing).insertBefore(a.nTable)[0]}function C(a,b){a.oFeatures.bProcessing&&h(a.aanFeatures.r).css("display",b?"block":"none");v(a,null,"processing",[a,b])}function rb(a){var b=h(a.nTable);b.attr("role",
-"grid");var c=a.oScroll;if(""===c.sX&&""===c.sY)return a.nTable;var d=c.sX,e=c.sY,f=a.oClasses,g=b.children("caption"),j=g.length?g[0]._captionSide:null,i=h(b[0].cloneNode(!1)),o=h(b[0].cloneNode(!1)),l=b.children("tfoot");l.length||(l=null);i=h("<div/>",{"class":f.sScrollWrapper}).append(h("<div/>",{"class":f.sScrollHead}).css({overflow:"hidden",position:"relative",border:0,width:d?!d?null:w(d):"100%"}).append(h("<div/>",{"class":f.sScrollHeadInner}).css({"box-sizing":"content-box",width:c.sXInner||
-"100%"}).append(i.removeAttr("id").css("margin-left",0).append("top"===j?g:null).append(b.children("thead"))))).append(h("<div/>",{"class":f.sScrollBody}).css({position:"relative",overflow:"auto",width:!d?null:w(d)}).append(b));l&&i.append(h("<div/>",{"class":f.sScrollFoot}).css({overflow:"hidden",border:0,width:d?!d?null:w(d):"100%"}).append(h("<div/>",{"class":f.sScrollFootInner}).append(o.removeAttr("id").css("margin-left",0).append("bottom"===j?g:null).append(b.children("tfoot")))));var b=i.children(),
-k=b[0],f=b[1],u=l?b[2]:null;if(d)h(f).on("scroll.DT",function(){var a=this.scrollLeft;k.scrollLeft=a;l&&(u.scrollLeft=a)});h(f).css(e&&c.bCollapse?"max-height":"height",e);a.nScrollHead=k;a.nScrollBody=f;a.nScrollFoot=u;a.aoDrawCallback.push({fn:Z,sName:"scrolling"});return i[0]}function Z(a){var b=a.oScroll,c=b.sX,d=b.sXInner,e=b.sY,b=b.iBarWidth,f=h(a.nScrollHead),g=f[0].style,j=f.children("div"),i=j[0].style,o=j.children("table"),j=a.nScrollBody,l=h(j),q=j.style,u=h(a.nScrollFoot).children("div"),
-m=u.children("table"),n=h(a.nTHead),p=h(a.nTable),t=p[0],v=t.style,r=a.nTFoot?h(a.nTFoot):null,Eb=a.oBrowser,Ua=Eb.bScrollOversize,s,L,P,x,y=[],z=[],A=[],B,C=function(a){a=a.style;a.paddingTop="0";a.paddingBottom="0";a.borderTopWidth="0";a.borderBottomWidth="0";a.height=0};L=j.scrollHeight>j.clientHeight;if(a.scrollBarVis!==L&&a.scrollBarVis!==k)a.scrollBarVis=L,U(a);else{a.scrollBarVis=L;p.children("thead, tfoot").remove();x=n.clone().prependTo(p);n=n.find("tr");L=x.find("tr");x.find("th, td").removeAttr("tabindex");
-r&&(P=r.clone().prependTo(p),s=r.find("tr"),P=P.find("tr"));c||(q.width="100%",f[0].style.width="100%");h.each(qa(a,x),function(b,c){B=$(a,b);c.style.width=a.aoColumns[B].sWidth});r&&I(function(a){a.style.width=""},P);f=p.outerWidth();if(""===c){v.width="100%";if(Ua&&(p.find("tbody").height()>j.offsetHeight||"scroll"==l.css("overflow-y")))v.width=w(p.outerWidth()-b);f=p.outerWidth()}else""!==d&&(v.width=w(d),f=p.outerWidth());I(C,L);I(function(a){A.push(a.innerHTML);y.push(w(h(a).css("width")))},
-L);I(function(a,b){a.style.width=y[b]},n);h(L).height(0);r&&(I(C,P),I(function(a){z.push(w(h(a).css("width")))},P),I(function(a,b){a.style.width=z[b]},s),h(P).height(0));I(function(a,b){a.innerHTML='<div class="dataTables_sizing" style="height:0;overflow:hidden;">'+A[b]+"</div>";a.style.width=y[b]},L);r&&I(function(a,b){a.innerHTML="";a.style.width=z[b]},P);if(p.outerWidth()<f){s=j.scrollHeight>j.offsetHeight||"scroll"==l.css("overflow-y")?f+b:f;if(Ua&&(j.scrollHeight>j.offsetHeight||"scroll"==l.css("overflow-y")))v.width=
-w(s-b);(""===c||""!==d)&&K(a,1,"Possible column misalignment",6)}else s="100%";q.width=w(s);g.width=w(s);r&&(a.nScrollFoot.style.width=w(s));!e&&Ua&&(q.height=w(t.offsetHeight+b));c=p.outerWidth();o[0].style.width=w(c);i.width=w(c);d=p.height()>j.clientHeight||"scroll"==l.css("overflow-y");e="padding"+(Eb.bScrollbarLeft?"Left":"Right");i[e]=d?b+"px":"0px";r&&(m[0].style.width=w(c),u[0].style.width=w(c),u[0].style[e]=d?b+"px":"0px");l.scroll();if((a.bSorted||a.bFiltered)&&!a._drawHold)j.scrollTop=
-0}}function I(a,b,c){for(var d=0,e=0,f=b.length,g,j;e<f;){g=b[e].firstChild;for(j=c?c[e].firstChild:null;g;)1===g.nodeType&&(c?a(g,j,d):a(g,d),d++),g=g.nextSibling,j=c?j.nextSibling:null;e++}}function Ha(a){var b=a.nTable,c=a.aoColumns,d=a.oScroll,e=d.sY,f=d.sX,g=d.sXInner,j=c.length,i=aa(a,"bVisible"),o=h("th",a.nTHead),l=b.getAttribute("width"),k=b.parentNode,u=!1,m,n,p=a.oBrowser,d=p.bScrollOversize;(m=b.style.width)&&-1!==m.indexOf("%")&&(l=m);for(m=0;m<i.length;m++)n=c[i[m]],null!==n.sWidth&&
-(n.sWidth=Fb(n.sWidthOrig,k),u=!0);if(d||!u&&!f&&!e&&j==ca(a)&&j==o.length)for(m=0;m<j;m++)i=$(a,m),null!==i&&(c[i].sWidth=w(o.eq(m).width()));else{j=h(b).clone().css("visibility","hidden").removeAttr("id");j.find("tbody tr").remove();var t=h("<tr/>").appendTo(j.find("tbody"));j.find("thead, tfoot").remove();j.append(h(a.nTHead).clone()).append(h(a.nTFoot).clone());j.find("tfoot th, tfoot td").css("width","");o=qa(a,j.find("thead")[0]);for(m=0;m<i.length;m++)n=c[i[m]],o[m].style.width=null!==n.sWidthOrig&&
-""!==n.sWidthOrig?w(n.sWidthOrig):"",n.sWidthOrig&&f&&h(o[m]).append(h("<div/>").css({width:n.sWidthOrig,margin:0,padding:0,border:0,height:1}));if(a.aoData.length)for(m=0;m<i.length;m++)u=i[m],n=c[u],h(Gb(a,u)).clone(!1).append(n.sContentPadding).appendTo(t);n=h("<div/>").css(f||e?{position:"absolute",top:0,left:0,height:1,right:0,overflow:"hidden"}:{}).append(j).appendTo(k);f&&g?j.width(g):f?(j.css("width","auto"),j.removeAttr("width"),j.width()<k.clientWidth&&l&&j.width(k.clientWidth)):e?j.width(k.clientWidth):
-l&&j.width(l);for(m=e=0;m<i.length;m++)k=h(o[m]),g=k.outerWidth()-k.width(),k=p.bBounding?Math.ceil(o[m].getBoundingClientRect().width):k.outerWidth(),e+=k,c[i[m]].sWidth=w(k-g);b.style.width=w(e);n.remove()}l&&(b.style.width=w(l));if((l||f)&&!a._reszEvt)b=function(){h(E).bind("resize.DT-"+a.sInstance,ua(function(){U(a)}))},d?setTimeout(b,1E3):b(),a._reszEvt=!0}function ua(a,b){var c=b!==k?b:200,d,e;return function(){var b=this,g=+new Date,j=arguments;d&&g<d+c?(clearTimeout(e),e=setTimeout(function(){d=
-k;a.apply(b,j)},c)):(d=g,a.apply(b,j))}}function Fb(a,b){if(!a)return 0;var c=h("<div/>").css("width",w(a)).appendTo(b||H.body),d=c[0].offsetWidth;c.remove();return d}function Gb(a,b){var c=Hb(a,b);if(0>c)return null;var d=a.aoData[c];return!d.nTr?h("<td/>").html(B(a,c,b,"display"))[0]:d.anCells[b]}function Hb(a,b){for(var c,d=-1,e=-1,f=0,g=a.aoData.length;f<g;f++)c=B(a,f,b,"display")+"",c=c.replace($b,""),c=c.replace(/&nbsp;/g," "),c.length>d&&(d=c.length,e=f);return e}function w(a){return null===
-a?"0px":"number"==typeof a?0>a?"0px":a+"px":a.match(/\d$/)?a+"px":a}function W(a){var b,c,d=[],e=a.aoColumns,f,g,j,i;b=a.aaSortingFixed;c=h.isPlainObject(b);var o=[];f=function(a){a.length&&!h.isArray(a[0])?o.push(a):h.merge(o,a)};h.isArray(b)&&f(b);c&&b.pre&&f(b.pre);f(a.aaSorting);c&&b.post&&f(b.post);for(a=0;a<o.length;a++){i=o[a][0];f=e[i].aDataSort;b=0;for(c=f.length;b<c;b++)g=f[b],j=e[g].sType||"string",o[a]._idx===k&&(o[a]._idx=h.inArray(o[a][1],e[g].asSorting)),d.push({src:i,col:g,dir:o[a][1],
-index:o[a]._idx,type:j,formatter:m.ext.type.order[j+"-pre"]})}return d}function mb(a){var b,c,d=[],e=m.ext.type.order,f=a.aoData,g=0,j,i=a.aiDisplayMaster,h;Ia(a);h=W(a);b=0;for(c=h.length;b<c;b++)j=h[b],j.formatter&&g++,Ib(a,j.col);if("ssp"!=y(a)&&0!==h.length){b=0;for(c=i.length;b<c;b++)d[i[b]]=b;g===h.length?i.sort(function(a,b){var c,e,g,j,i=h.length,k=f[a]._aSortData,m=f[b]._aSortData;for(g=0;g<i;g++)if(j=h[g],c=k[j.col],e=m[j.col],c=c<e?-1:c>e?1:0,0!==c)return"asc"===j.dir?c:-c;c=d[a];e=d[b];
-return c<e?-1:c>e?1:0}):i.sort(function(a,b){var c,g,j,i,k=h.length,m=f[a]._aSortData,p=f[b]._aSortData;for(j=0;j<k;j++)if(i=h[j],c=m[i.col],g=p[i.col],i=e[i.type+"-"+i.dir]||e["string-"+i.dir],c=i(c,g),0!==c)return c;c=d[a];g=d[b];return c<g?-1:c>g?1:0})}a.bSorted=!0}function Jb(a){for(var b,c,d=a.aoColumns,e=W(a),a=a.oLanguage.oAria,f=0,g=d.length;f<g;f++){c=d[f];var j=c.asSorting;b=c.sTitle.replace(/<.*?>/g,"");var i=c.nTh;i.removeAttribute("aria-sort");c.bSortable&&(0<e.length&&e[0].col==f?(i.setAttribute("aria-sort",
-"asc"==e[0].dir?"ascending":"descending"),c=j[e[0].index+1]||j[0]):c=j[0],b+="asc"===c?a.sSortAscending:a.sSortDescending);i.setAttribute("aria-label",b)}}function Va(a,b,c,d){var e=a.aaSorting,f=a.aoColumns[b].asSorting,g=function(a,b){var c=a._idx;c===k&&(c=h.inArray(a[1],f));return c+1<f.length?c+1:b?null:0};"number"===typeof e[0]&&(e=a.aaSorting=[e]);c&&a.oFeatures.bSortMulti?(c=h.inArray(b,D(e,"0")),-1!==c?(b=g(e[c],!0),null===b&&1===e.length&&(b=0),null===b?e.splice(c,1):(e[c][1]=f[b],e[c]._idx=
-b)):(e.push([b,f[0],0]),e[e.length-1]._idx=0)):e.length&&e[0][0]==b?(b=g(e[0]),e.length=1,e[0][1]=f[b],e[0]._idx=b):(e.length=0,e.push([b,f[0]]),e[0]._idx=0);T(a);"function"==typeof d&&d(a)}function Oa(a,b,c,d){var e=a.aoColumns[c];Wa(b,{},function(b){!1!==e.bSortable&&(a.oFeatures.bProcessing?(C(a,!0),setTimeout(function(){Va(a,c,b.shiftKey,d);"ssp"!==y(a)&&C(a,!1)},0)):Va(a,c,b.shiftKey,d))})}function xa(a){var b=a.aLastSort,c=a.oClasses.sSortColumn,d=W(a),e=a.oFeatures,f,g;if(e.bSort&&e.bSortClasses){e=
-0;for(f=b.length;e<f;e++)g=b[e].src,h(D(a.aoData,"anCells",g)).removeClass(c+(2>e?e+1:3));e=0;for(f=d.length;e<f;e++)g=d[e].src,h(D(a.aoData,"anCells",g)).addClass(c+(2>e?e+1:3))}a.aLastSort=d}function Ib(a,b){var c=a.aoColumns[b],d=m.ext.order[c.sSortDataType],e;d&&(e=d.call(a.oInstance,a,b,ba(a,b)));for(var f,g=m.ext.type.order[c.sType+"-pre"],j=0,i=a.aoData.length;j<i;j++)if(c=a.aoData[j],c._aSortData||(c._aSortData=[]),!c._aSortData[b]||d)f=d?e[j]:B(a,j,b,"sort"),c._aSortData[b]=g?g(f):f}function ya(a){if(a.oFeatures.bStateSave&&
-!a.bDestroying){var b={time:+new Date,start:a._iDisplayStart,length:a._iDisplayLength,order:h.extend(!0,[],a.aaSorting),search:Ab(a.oPreviousSearch),columns:h.map(a.aoColumns,function(b,d){return{visible:b.bVisible,search:Ab(a.aoPreSearchCols[d])}})};v(a,"aoStateSaveParams","stateSaveParams",[a,b]);a.oSavedState=b;a.fnStateSaveCallback.call(a.oInstance,a,b)}}function Kb(a){var b,c,d=a.aoColumns;if(a.oFeatures.bStateSave){var e=a.fnStateLoadCallback.call(a.oInstance,a);if(e&&e.time&&(b=v(a,"aoStateLoadParams",
-"stateLoadParams",[a,e]),-1===h.inArray(!1,b)&&(b=a.iStateDuration,!(0<b&&e.time<+new Date-1E3*b)&&d.length===e.columns.length))){a.oLoadedState=h.extend(!0,{},e);e.start!==k&&(a._iDisplayStart=e.start,a.iInitDisplayStart=e.start);e.length!==k&&(a._iDisplayLength=e.length);e.order!==k&&(a.aaSorting=[],h.each(e.order,function(b,c){a.aaSorting.push(c[0]>=d.length?[0,c[1]]:c)}));e.search!==k&&h.extend(a.oPreviousSearch,Bb(e.search));b=0;for(c=e.columns.length;b<c;b++){var f=e.columns[b];f.visible!==
-k&&(d[b].bVisible=f.visible);f.search!==k&&h.extend(a.aoPreSearchCols[b],Bb(f.search))}v(a,"aoStateLoaded","stateLoaded",[a,e])}}}function za(a){var b=m.settings,a=h.inArray(a,D(b,"nTable"));return-1!==a?b[a]:null}function K(a,b,c,d){c="DataTables warning: "+(a?"table id="+a.sTableId+" - ":"")+c;d&&(c+=". For more information about this error, please see http://datatables.net/tn/"+d);if(b)E.console&&console.log&&console.log(c);else if(b=m.ext,b=b.sErrMode||b.errMode,a&&v(a,null,"error",[a,d,c]),"alert"==
-b)alert(c);else{if("throw"==b)throw Error(c);"function"==typeof b&&b(a,d,c)}}function F(a,b,c,d){h.isArray(c)?h.each(c,function(c,d){h.isArray(d)?F(a,b,d[0],d[1]):F(a,b,d)}):(d===k&&(d=c),b[c]!==k&&(a[d]=b[c]))}function Lb(a,b,c){var d,e;for(e in b)b.hasOwnProperty(e)&&(d=b[e],h.isPlainObject(d)?(h.isPlainObject(a[e])||(a[e]={}),h.extend(!0,a[e],d)):a[e]=c&&"data"!==e&&"aaData"!==e&&h.isArray(d)?d.slice():d);return a}function Wa(a,b,c){h(a).bind("click.DT",b,function(b){a.blur();c(b)}).bind("keypress.DT",
-b,function(a){13===a.which&&(a.preventDefault(),c(a))}).bind("selectstart.DT",function(){return!1})}function z(a,b,c,d){c&&a[b].push({fn:c,sName:d})}function v(a,b,c,d){var e=[];b&&(e=h.map(a[b].slice().reverse(),function(b){return b.fn.apply(a.oInstance,d)}));null!==c&&(b=h.Event(c+".dt"),h(a.nTable).trigger(b,d),e.push(b.result));return e}function Sa(a){var b=a._iDisplayStart,c=a.fnDisplayEnd(),d=a._iDisplayLength;b>=c&&(b=c-d);b-=b%d;if(-1===d||0>b)b=0;a._iDisplayStart=b}function Pa(a,b){var c=
-a.renderer,d=m.ext.renderer[b];return h.isPlainObject(c)&&c[b]?d[c[b]]||d._:"string"===typeof c?d[c]||d._:d._}function y(a){return a.oFeatures.bServerSide?"ssp":a.ajax||a.sAjaxSource?"ajax":"dom"}function Aa(a,b){var c=[],c=Mb.numbers_length,d=Math.floor(c/2);b<=c?c=X(0,b):a<=d?(c=X(0,c-2),c.push("ellipsis"),c.push(b-1)):(a>=b-1-d?c=X(b-(c-2),b):(c=X(a-d+2,a+d-1),c.push("ellipsis"),c.push(b-1)),c.splice(0,0,"ellipsis"),c.splice(0,0,0));c.DT_el="span";return c}function db(a){h.each({num:function(b){return Ba(b,
-a)},"num-fmt":function(b){return Ba(b,a,Xa)},"html-num":function(b){return Ba(b,a,Ca)},"html-num-fmt":function(b){return Ba(b,a,Ca,Xa)}},function(b,c){s.type.order[b+a+"-pre"]=c;b.match(/^html\-/)&&(s.type.search[b+a]=s.type.search.html)})}function Nb(a){return function(){var b=[za(this[m.ext.iApiIndex])].concat(Array.prototype.slice.call(arguments));return m.ext.internal[a].apply(this,b)}}var m,s,t,p,r,Ya={},Ob=/[\r\n]/g,Ca=/<.*?>/g,ac=/^[\w\+\-]/,bc=/[\w\+\-]$/,Yb=RegExp("(\\/|\\.|\\*|\\+|\\?|\\||\\(|\\)|\\[|\\]|\\{|\\}|\\\\|\\$|\\^|\\-)",
-"g"),Xa=/[',$£€¥%\u2009\u202F\u20BD\u20a9\u20BArfk]/gi,M=function(a){return!a||!0===a||"-"===a?!0:!1},Pb=function(a){var b=parseInt(a,10);return!isNaN(b)&&isFinite(a)?b:null},Qb=function(a,b){Ya[b]||(Ya[b]=RegExp(va(b),"g"));return"string"===typeof a&&"."!==b?a.replace(/\./g,"").replace(Ya[b],"."):a},Za=function(a,b,c){var d="string"===typeof a;if(M(a))return!0;b&&d&&(a=Qb(a,b));c&&d&&(a=a.replace(Xa,""));return!isNaN(parseFloat(a))&&isFinite(a)},Rb=function(a,b,c){return M(a)?!0:!(M(a)||"string"===
-typeof a)?null:Za(a.replace(Ca,""),b,c)?!0:null},D=function(a,b,c){var d=[],e=0,f=a.length;if(c!==k)for(;e<f;e++)a[e]&&a[e][b]&&d.push(a[e][b][c]);else for(;e<f;e++)a[e]&&d.push(a[e][b]);return d},ja=function(a,b,c,d){var e=[],f=0,g=b.length;if(d!==k)for(;f<g;f++)a[b[f]][c]&&e.push(a[b[f]][c][d]);else for(;f<g;f++)e.push(a[b[f]][c]);return e},X=function(a,b){var c=[],d;b===k?(b=0,d=a):(d=b,b=a);for(var e=b;e<d;e++)c.push(e);return c},Sb=function(a){for(var b=[],c=0,d=a.length;c<d;c++)a[c]&&b.push(a[c]);
-return b},pa=function(a){var b=[],c,d,e=a.length,f,g=0;d=0;a:for(;d<e;d++){c=a[d];for(f=0;f<g;f++)if(b[f]===c)continue a;b.push(c);g++}return b},A=function(a,b,c){a[b]!==k&&(a[c]=a[b])},da=/\[.*?\]$/,V=/\(\)$/,wa=h("<div>")[0],Zb=wa.textContent!==k,$b=/<.*?>/g;m=function(a){this.$=function(a,b){return this.api(!0).$(a,b)};this._=function(a,b){return this.api(!0).rows(a,b).data()};this.api=function(a){return a?new t(za(this[s.iApiIndex])):new t(this)};this.fnAddData=function(a,b){var c=this.api(!0),
-d=h.isArray(a)&&(h.isArray(a[0])||h.isPlainObject(a[0]))?c.rows.add(a):c.row.add(a);(b===k||b)&&c.draw();return d.flatten().toArray()};this.fnAdjustColumnSizing=function(a){var b=this.api(!0).columns.adjust(),c=b.settings()[0],d=c.oScroll;a===k||a?b.draw(!1):(""!==d.sX||""!==d.sY)&&Z(c)};this.fnClearTable=function(a){var b=this.api(!0).clear();(a===k||a)&&b.draw()};this.fnClose=function(a){this.api(!0).row(a).child.hide()};this.fnDeleteRow=function(a,b,c){var d=this.api(!0),a=d.rows(a),e=a.settings()[0],
-h=e.aoData[a[0][0]];a.remove();b&&b.call(this,e,h);(c===k||c)&&d.draw();return h};this.fnDestroy=function(a){this.api(!0).destroy(a)};this.fnDraw=function(a){this.api(!0).draw(a)};this.fnFilter=function(a,b,c,d,e,h){e=this.api(!0);null===b||b===k?e.search(a,c,d,h):e.column(b).search(a,c,d,h);e.draw()};this.fnGetData=function(a,b){var c=this.api(!0);if(a!==k){var d=a.nodeName?a.nodeName.toLowerCase():"";return b!==k||"td"==d||"th"==d?c.cell(a,b).data():c.row(a).data()||null}return c.data().toArray()};
-this.fnGetNodes=function(a){var b=this.api(!0);return a!==k?b.row(a).node():b.rows().nodes().flatten().toArray()};this.fnGetPosition=function(a){var b=this.api(!0),c=a.nodeName.toUpperCase();return"TR"==c?b.row(a).index():"TD"==c||"TH"==c?(a=b.cell(a).index(),[a.row,a.columnVisible,a.column]):null};this.fnIsOpen=function(a){return this.api(!0).row(a).child.isShown()};this.fnOpen=function(a,b,c){return this.api(!0).row(a).child(b,c).show().child()[0]};this.fnPageChange=function(a,b){var c=this.api(!0).page(a);
-(b===k||b)&&c.draw(!1)};this.fnSetColumnVis=function(a,b,c){a=this.api(!0).column(a).visible(b);(c===k||c)&&a.columns.adjust().draw()};this.fnSettings=function(){return za(this[s.iApiIndex])};this.fnSort=function(a){this.api(!0).order(a).draw()};this.fnSortListener=function(a,b,c){this.api(!0).order.listener(a,b,c)};this.fnUpdate=function(a,b,c,d,e){var h=this.api(!0);c===k||null===c?h.row(b).data(a):h.cell(b,c).data(a);(e===k||e)&&h.columns.adjust();(d===k||d)&&h.draw();return 0};this.fnVersionCheck=
-s.fnVersionCheck;var b=this,c=a===k,d=this.length;c&&(a={});this.oApi=this.internal=s.internal;for(var e in m.ext.internal)e&&(this[e]=Nb(e));this.each(function(){var e={},e=1<d?Lb(e,a,!0):a,g=0,j,i=this.getAttribute("id"),o=!1,l=m.defaults,q=h(this);if("table"!=this.nodeName.toLowerCase())K(null,0,"Non-table node initialisation ("+this.nodeName+")",2);else{eb(l);fb(l.column);J(l,l,!0);J(l.column,l.column,!0);J(l,h.extend(e,q.data()));var u=m.settings,g=0;for(j=u.length;g<j;g++){var p=u[g];if(p.nTable==
-this||p.nTHead.parentNode==this||p.nTFoot&&p.nTFoot.parentNode==this){g=e.bRetrieve!==k?e.bRetrieve:l.bRetrieve;if(c||g)return p.oInstance;if(e.bDestroy!==k?e.bDestroy:l.bDestroy){p.oInstance.fnDestroy();break}else{K(p,0,"Cannot reinitialise DataTable",3);return}}if(p.sTableId==this.id){u.splice(g,1);break}}if(null===i||""===i)this.id=i="DataTables_Table_"+m.ext._unique++;var n=h.extend(!0,{},m.models.oSettings,{sDestroyWidth:q[0].style.width,sInstance:i,sTableId:i});n.nTable=this;n.oApi=b.internal;
-n.oInit=e;u.push(n);n.oInstance=1===b.length?b:q.dataTable();eb(e);e.oLanguage&&Fa(e.oLanguage);e.aLengthMenu&&!e.iDisplayLength&&(e.iDisplayLength=h.isArray(e.aLengthMenu[0])?e.aLengthMenu[0][0]:e.aLengthMenu[0]);e=Lb(h.extend(!0,{},l),e);F(n.oFeatures,e,"bPaginate bLengthChange bFilter bSort bSortMulti bInfo bProcessing bAutoWidth bSortClasses bServerSide bDeferRender".split(" "));F(n,e,["asStripeClasses","ajax","fnServerData","fnFormatNumber","sServerMethod","aaSorting","aaSortingFixed","aLengthMenu",
-"sPaginationType","sAjaxSource","sAjaxDataProp","iStateDuration","sDom","bSortCellsTop","iTabIndex","fnStateLoadCallback","fnStateSaveCallback","renderer","searchDelay","rowId",["iCookieDuration","iStateDuration"],["oSearch","oPreviousSearch"],["aoSearchCols","aoPreSearchCols"],["iDisplayLength","_iDisplayLength"],["bJQueryUI","bJUI"]]);F(n.oScroll,e,[["sScrollX","sX"],["sScrollXInner","sXInner"],["sScrollY","sY"],["bScrollCollapse","bCollapse"]]);F(n.oLanguage,e,"fnInfoCallback");z(n,"aoDrawCallback",
-e.fnDrawCallback,"user");z(n,"aoServerParams",e.fnServerParams,"user");z(n,"aoStateSaveParams",e.fnStateSaveParams,"user");z(n,"aoStateLoadParams",e.fnStateLoadParams,"user");z(n,"aoStateLoaded",e.fnStateLoaded,"user");z(n,"aoRowCallback",e.fnRowCallback,"user");z(n,"aoRowCreatedCallback",e.fnCreatedRow,"user");z(n,"aoHeaderCallback",e.fnHeaderCallback,"user");z(n,"aoFooterCallback",e.fnFooterCallback,"user");z(n,"aoInitComplete",e.fnInitComplete,"user");z(n,"aoPreDrawCallback",e.fnPreDrawCallback,
-"user");n.rowIdFn=Q(e.rowId);gb(n);i=n.oClasses;e.bJQueryUI?(h.extend(i,m.ext.oJUIClasses,e.oClasses),e.sDom===l.sDom&&"lfrtip"===l.sDom&&(n.sDom='<"H"lfr>t<"F"ip>'),n.renderer)?h.isPlainObject(n.renderer)&&!n.renderer.header&&(n.renderer.header="jqueryui"):n.renderer="jqueryui":h.extend(i,m.ext.classes,e.oClasses);q.addClass(i.sTable);n.iInitDisplayStart===k&&(n.iInitDisplayStart=e.iDisplayStart,n._iDisplayStart=e.iDisplayStart);null!==e.iDeferLoading&&(n.bDeferLoading=!0,g=h.isArray(e.iDeferLoading),
-n._iRecordsDisplay=g?e.iDeferLoading[0]:e.iDeferLoading,n._iRecordsTotal=g?e.iDeferLoading[1]:e.iDeferLoading);var t=n.oLanguage;h.extend(!0,t,e.oLanguage);""!==t.sUrl&&(h.ajax({dataType:"json",url:t.sUrl,success:function(a){Fa(a);J(l.oLanguage,a);h.extend(true,t,a);ia(n)},error:function(){ia(n)}}),o=!0);null===e.asStripeClasses&&(n.asStripeClasses=[i.sStripeOdd,i.sStripeEven]);var g=n.asStripeClasses,r=q.children("tbody").find("tr").eq(0);-1!==h.inArray(!0,h.map(g,function(a){return r.hasClass(a)}))&&
-(h("tbody tr",this).removeClass(g.join(" ")),n.asDestroyStripes=g.slice());u=[];g=this.getElementsByTagName("thead");0!==g.length&&(fa(n.aoHeader,g[0]),u=qa(n));if(null===e.aoColumns){p=[];g=0;for(j=u.length;g<j;g++)p.push(null)}else p=e.aoColumns;g=0;for(j=p.length;g<j;g++)Ga(n,u?u[g]:null);ib(n,e.aoColumnDefs,p,function(a,b){la(n,a,b)});if(r.length){var s=function(a,b){return a.getAttribute("data-"+b)!==null?b:null};h(r[0]).children("th, td").each(function(a,b){var c=n.aoColumns[a];if(c.mData===
-a){var d=s(b,"sort")||s(b,"order"),e=s(b,"filter")||s(b,"search");if(d!==null||e!==null){c.mData={_:a+".display",sort:d!==null?a+".@data-"+d:k,type:d!==null?a+".@data-"+d:k,filter:e!==null?a+".@data-"+e:k};la(n,a)}}})}var w=n.oFeatures;e.bStateSave&&(w.bStateSave=!0,Kb(n,e),z(n,"aoDrawCallback",ya,"state_save"));if(e.aaSorting===k){u=n.aaSorting;g=0;for(j=u.length;g<j;g++)u[g][1]=n.aoColumns[g].asSorting[0]}xa(n);w.bSort&&z(n,"aoDrawCallback",function(){if(n.bSorted){var a=W(n),b={};h.each(a,function(a,
-c){b[c.src]=c.dir});v(n,null,"order",[n,a,b]);Jb(n)}});z(n,"aoDrawCallback",function(){(n.bSorted||y(n)==="ssp"||w.bDeferRender)&&xa(n)},"sc");g=q.children("caption").each(function(){this._captionSide=q.css("caption-side")});j=q.children("thead");0===j.length&&(j=h("<thead/>").appendTo(this));n.nTHead=j[0];j=q.children("tbody");0===j.length&&(j=h("<tbody/>").appendTo(this));n.nTBody=j[0];j=q.children("tfoot");if(0===j.length&&0<g.length&&(""!==n.oScroll.sX||""!==n.oScroll.sY))j=h("<tfoot/>").appendTo(this);
-0===j.length||0===j.children().length?q.addClass(i.sNoFooter):0<j.length&&(n.nTFoot=j[0],fa(n.aoFooter,n.nTFoot));if(e.aaData)for(g=0;g<e.aaData.length;g++)N(n,e.aaData[g]);else(n.bDeferLoading||"dom"==y(n))&&ma(n,h(n.nTBody).children("tr"));n.aiDisplay=n.aiDisplayMaster.slice();n.bInitialised=!0;!1===o&&ia(n)}});b=null;return this};var Tb=[],x=Array.prototype,cc=function(a){var b,c,d=m.settings,e=h.map(d,function(a){return a.nTable});if(a){if(a.nTable&&a.oApi)return[a];if(a.nodeName&&"table"===a.nodeName.toLowerCase())return b=
-h.inArray(a,e),-1!==b?[d[b]]:null;if(a&&"function"===typeof a.settings)return a.settings().toArray();"string"===typeof a?c=h(a):a instanceof h&&(c=a)}else return[];if(c)return c.map(function(){b=h.inArray(this,e);return-1!==b?d[b]:null}).toArray()};t=function(a,b){if(!(this instanceof t))return new t(a,b);var c=[],d=function(a){(a=cc(a))&&(c=c.concat(a))};if(h.isArray(a))for(var e=0,f=a.length;e<f;e++)d(a[e]);else d(a);this.context=pa(c);b&&h.merge(this,b);this.selector={rows:null,cols:null,opts:null};
-t.extend(this,this,Tb)};m.Api=t;h.extend(t.prototype,{any:function(){return 0!==this.count()},concat:x.concat,context:[],count:function(){return this.flatten().length},each:function(a){for(var b=0,c=this.length;b<c;b++)a.call(this,this[b],b,this);return this},eq:function(a){var b=this.context;return b.length>a?new t(b[a],this[a]):null},filter:function(a){var b=[];if(x.filter)b=x.filter.call(this,a,this);else for(var c=0,d=this.length;c<d;c++)a.call(this,this[c],c,this)&&b.push(this[c]);return new t(this.context,
-b)},flatten:function(){var a=[];return new t(this.context,a.concat.apply(a,this.toArray()))},join:x.join,indexOf:x.indexOf||function(a,b){for(var c=b||0,d=this.length;c<d;c++)if(this[c]===a)return c;return-1},iterator:function(a,b,c,d){var e=[],f,g,h,i,o,l=this.context,m,p,r=this.selector;"string"===typeof a&&(d=c,c=b,b=a,a=!1);g=0;for(h=l.length;g<h;g++){var n=new t(l[g]);if("table"===b)f=c.call(n,l[g],g),f!==k&&e.push(f);else if("columns"===b||"rows"===b)f=c.call(n,l[g],this[g],g),f!==k&&e.push(f);
-else if("column"===b||"column-rows"===b||"row"===b||"cell"===b){p=this[g];"column-rows"===b&&(m=Da(l[g],r.opts));i=0;for(o=p.length;i<o;i++)f=p[i],f="cell"===b?c.call(n,l[g],f.row,f.column,g,i):c.call(n,l[g],f,g,i,m),f!==k&&e.push(f)}}return e.length||d?(a=new t(l,a?e.concat.apply([],e):e),b=a.selector,b.rows=r.rows,b.cols=r.cols,b.opts=r.opts,a):this},lastIndexOf:x.lastIndexOf||function(a,b){return this.indexOf.apply(this.toArray.reverse(),arguments)},length:0,map:function(a){var b=[];if(x.map)b=
-x.map.call(this,a,this);else for(var c=0,d=this.length;c<d;c++)b.push(a.call(this,this[c],c));return new t(this.context,b)},pluck:function(a){return this.map(function(b){return b[a]})},pop:x.pop,push:x.push,reduce:x.reduce||function(a,b){return hb(this,a,b,0,this.length,1)},reduceRight:x.reduceRight||function(a,b){return hb(this,a,b,this.length-1,-1,-1)},reverse:x.reverse,selector:null,shift:x.shift,sort:x.sort,splice:x.splice,toArray:function(){return x.slice.call(this)},to$:function(){return h(this)},
-toJQuery:function(){return h(this)},unique:function(){return new t(this.context,pa(this))},unshift:x.unshift});t.extend=function(a,b,c){if(c.length&&b&&(b instanceof t||b.__dt_wrapper)){var d,e,f,g=function(a,b,c){return function(){var d=b.apply(a,arguments);t.extend(d,d,c.methodExt);return d}};d=0;for(e=c.length;d<e;d++)f=c[d],b[f.name]="function"===typeof f.val?g(a,f.val,f):h.isPlainObject(f.val)?{}:f.val,b[f.name].__dt_wrapper=!0,t.extend(a,b[f.name],f.propExt)}};t.register=p=function(a,b){if(h.isArray(a))for(var c=
-0,d=a.length;c<d;c++)t.register(a[c],b);else for(var e=a.split("."),f=Tb,g,j,c=0,d=e.length;c<d;c++){g=(j=-1!==e[c].indexOf("()"))?e[c].replace("()",""):e[c];var i;a:{i=0;for(var k=f.length;i<k;i++)if(f[i].name===g){i=f[i];break a}i=null}i||(i={name:g,val:{},methodExt:[],propExt:[]},f.push(i));c===d-1?i.val=b:f=j?i.methodExt:i.propExt}};t.registerPlural=r=function(a,b,c){t.register(a,c);t.register(b,function(){var a=c.apply(this,arguments);return a===this?this:a instanceof t?a.length?h.isArray(a[0])?
-new t(a.context,a[0]):a[0]:k:a})};p("tables()",function(a){var b;if(a){b=t;var c=this.context;if("number"===typeof a)a=[c[a]];else var d=h.map(c,function(a){return a.nTable}),a=h(d).filter(a).map(function(){var a=h.inArray(this,d);return c[a]}).toArray();b=new b(a)}else b=this;return b});p("table()",function(a){var a=this.tables(a),b=a.context;return b.length?new t(b[0]):a});r("tables().nodes()","table().node()",function(){return this.iterator("table",function(a){return a.nTable},1)});r("tables().body()",
-"table().body()",function(){return this.iterator("table",function(a){return a.nTBody},1)});r("tables().header()","table().header()",function(){return this.iterator("table",function(a){return a.nTHead},1)});r("tables().footer()","table().footer()",function(){return this.iterator("table",function(a){return a.nTFoot},1)});r("tables().containers()","table().container()",function(){return this.iterator("table",function(a){return a.nTableWrapper},1)});p("draw()",function(a){return this.iterator("table",
-function(b){"page"===a?O(b):("string"===typeof a&&(a="full-hold"===a?!1:!0),T(b,!1===a))})});p("page()",function(a){return a===k?this.page.info().page:this.iterator("table",function(b){Ta(b,a)})});p("page.info()",function(){if(0===this.context.length)return k;var a=this.context[0],b=a._iDisplayStart,c=a.oFeatures.bPaginate?a._iDisplayLength:-1,d=a.fnRecordsDisplay(),e=-1===c;return{page:e?0:Math.floor(b/c),pages:e?1:Math.ceil(d/c),start:b,end:a.fnDisplayEnd(),length:c,recordsTotal:a.fnRecordsTotal(),
-recordsDisplay:d,serverSide:"ssp"===y(a)}});p("page.len()",function(a){return a===k?0!==this.context.length?this.context[0]._iDisplayLength:k:this.iterator("table",function(b){Ra(b,a)})});var Ub=function(a,b,c){if(c){var d=new t(a);d.one("draw",function(){c(d.ajax.json())})}if("ssp"==y(a))T(a,b);else{C(a,!0);var e=a.jqXHR;e&&4!==e.readyState&&e.abort();ra(a,[],function(c){na(a);for(var c=sa(a,c),d=0,e=c.length;d<e;d++)N(a,c[d]);T(a,b);C(a,!1)})}};p("ajax.json()",function(){var a=this.context;if(0<
-a.length)return a[0].json});p("ajax.params()",function(){var a=this.context;if(0<a.length)return a[0].oAjaxData});p("ajax.reload()",function(a,b){return this.iterator("table",function(c){Ub(c,!1===b,a)})});p("ajax.url()",function(a){var b=this.context;if(a===k){if(0===b.length)return k;b=b[0];return b.ajax?h.isPlainObject(b.ajax)?b.ajax.url:b.ajax:b.sAjaxSource}return this.iterator("table",function(b){h.isPlainObject(b.ajax)?b.ajax.url=a:b.ajax=a})});p("ajax.url().load()",function(a,b){return this.iterator("table",
-function(c){Ub(c,!1===b,a)})});var $a=function(a,b,c,d,e){var f=[],g,j,i,o,l,m;i=typeof b;if(!b||"string"===i||"function"===i||b.length===k)b=[b];i=0;for(o=b.length;i<o;i++){j=b[i]&&b[i].split?b[i].split(","):[b[i]];l=0;for(m=j.length;l<m;l++)(g=c("string"===typeof j[l]?h.trim(j[l]):j[l]))&&g.length&&(f=f.concat(g))}a=s.selector[a];if(a.length){i=0;for(o=a.length;i<o;i++)f=a[i](d,e,f)}return pa(f)},ab=function(a){a||(a={});a.filter&&a.search===k&&(a.search=a.filter);return h.extend({search:"none",
-order:"current",page:"all"},a)},bb=function(a){for(var b=0,c=a.length;b<c;b++)if(0<a[b].length)return a[0]=a[b],a[0].length=1,a.length=1,a.context=[a.context[b]],a;a.length=0;return a},Da=function(a,b){var c,d,e,f=[],g=a.aiDisplay;c=a.aiDisplayMaster;var j=b.search;d=b.order;e=b.page;if("ssp"==y(a))return"removed"===j?[]:X(0,c.length);if("current"==e){c=a._iDisplayStart;for(d=a.fnDisplayEnd();c<d;c++)f.push(g[c])}else if("current"==d||"applied"==d)f="none"==j?c.slice():"applied"==j?g.slice():h.map(c,
-function(a){return-1===h.inArray(a,g)?a:null});else if("index"==d||"original"==d){c=0;for(d=a.aoData.length;c<d;c++)"none"==j?f.push(c):(e=h.inArray(c,g),(-1===e&&"removed"==j||0<=e&&"applied"==j)&&f.push(c))}return f};p("rows()",function(a,b){a===k?a="":h.isPlainObject(a)&&(b=a,a="");var b=ab(b),c=this.iterator("table",function(c){var e=b;return $a("row",a,function(a){var b=Pb(a);if(b!==null&&!e)return[b];var j=Da(c,e);if(b!==null&&h.inArray(b,j)!==-1)return[b];if(!a)return j;if(typeof a==="function")return h.map(j,
-function(b){var e=c.aoData[b];return a(b,e._aData,e.nTr)?b:null});b=Sb(ja(c.aoData,j,"nTr"));if(a.nodeName&&h.inArray(a,b)!==-1)return[a._DT_RowIndex];if(typeof a==="string"&&a.charAt(0)==="#"){j=c.aIds[a.replace(/^#/,"")];if(j!==k)return[j.idx]}return h(b).filter(a).map(function(){return this._DT_RowIndex}).toArray()},c,e)},1);c.selector.rows=a;c.selector.opts=b;return c});p("rows().nodes()",function(){return this.iterator("row",function(a,b){return a.aoData[b].nTr||k},1)});p("rows().data()",function(){return this.iterator(!0,
-"rows",function(a,b){return ja(a.aoData,b,"_aData")},1)});r("rows().cache()","row().cache()",function(a){return this.iterator("row",function(b,c){var d=b.aoData[c];return"search"===a?d._aFilterData:d._aSortData},1)});r("rows().invalidate()","row().invalidate()",function(a){return this.iterator("row",function(b,c){ea(b,c,a)})});r("rows().indexes()","row().index()",function(){return this.iterator("row",function(a,b){return b},1)});r("rows().ids()","row().id()",function(a){for(var b=[],c=this.context,
-d=0,e=c.length;d<e;d++)for(var f=0,g=this[d].length;f<g;f++){var h=c[d].rowIdFn(c[d].aoData[this[d][f]]._aData);b.push((!0===a?"#":"")+h)}return new t(c,b)});r("rows().remove()","row().remove()",function(){var a=this;this.iterator("row",function(b,c,d){var e=b.aoData,f=e[c],g,h,i,o,l;e.splice(c,1);g=0;for(h=e.length;g<h;g++)if(i=e[g],l=i.anCells,null!==i.nTr&&(i.nTr._DT_RowIndex=g),null!==l){i=0;for(o=l.length;i<o;i++)l[i]._DT_CellIndex.row=g}oa(b.aiDisplayMaster,c);oa(b.aiDisplay,c);oa(a[d],c,!1);
-Sa(b);c=b.rowIdFn(f._aData);c!==k&&delete b.aIds[c]});this.iterator("table",function(a){for(var c=0,d=a.aoData.length;c<d;c++)a.aoData[c].idx=c});return this});p("rows.add()",function(a){var b=this.iterator("table",function(b){var c,f,g,h=[];f=0;for(g=a.length;f<g;f++)c=a[f],c.nodeName&&"TR"===c.nodeName.toUpperCase()?h.push(ma(b,c)[0]):h.push(N(b,c));return h},1),c=this.rows(-1);c.pop();h.merge(c,b);return c});p("row()",function(a,b){return bb(this.rows(a,b))});p("row().data()",function(a){var b=
-this.context;if(a===k)return b.length&&this.length?b[0].aoData[this[0]]._aData:k;b[0].aoData[this[0]]._aData=a;ea(b[0],this[0],"data");return this});p("row().node()",function(){var a=this.context;return a.length&&this.length?a[0].aoData[this[0]].nTr||null:null});p("row.add()",function(a){a instanceof h&&a.length&&(a=a[0]);var b=this.iterator("table",function(b){return a.nodeName&&"TR"===a.nodeName.toUpperCase()?ma(b,a)[0]:N(b,a)});return this.row(b[0])});var cb=function(a,b){var c=a.context;if(c.length&&
-(c=c[0].aoData[b!==k?b:a[0]])&&c._details)c._details.remove(),c._detailsShow=k,c._details=k},Vb=function(a,b){var c=a.context;if(c.length&&a.length){var d=c[0].aoData[a[0]];if(d._details){(d._detailsShow=b)?d._details.insertAfter(d.nTr):d._details.detach();var e=c[0],f=new t(e),g=e.aoData;f.off("draw.dt.DT_details column-visibility.dt.DT_details destroy.dt.DT_details");0<D(g,"_details").length&&(f.on("draw.dt.DT_details",function(a,b){e===b&&f.rows({page:"current"}).eq(0).each(function(a){a=g[a];
-a._detailsShow&&a._details.insertAfter(a.nTr)})}),f.on("column-visibility.dt.DT_details",function(a,b){if(e===b)for(var c,d=ca(b),f=0,h=g.length;f<h;f++)c=g[f],c._details&&c._details.children("td[colspan]").attr("colspan",d)}),f.on("destroy.dt.DT_details",function(a,b){if(e===b)for(var c=0,d=g.length;c<d;c++)g[c]._details&&cb(f,c)}))}}};p("row().child()",function(a,b){var c=this.context;if(a===k)return c.length&&this.length?c[0].aoData[this[0]]._details:k;if(!0===a)this.child.show();else if(!1===
-a)cb(this);else if(c.length&&this.length){var d=c[0],c=c[0].aoData[this[0]],e=[],f=function(a,b){if(h.isArray(a)||a instanceof h)for(var c=0,k=a.length;c<k;c++)f(a[c],b);else a.nodeName&&"tr"===a.nodeName.toLowerCase()?e.push(a):(c=h("<tr><td/></tr>").addClass(b),h("td",c).addClass(b).html(a)[0].colSpan=ca(d),e.push(c[0]))};f(a,b);c._details&&c._details.remove();c._details=h(e);c._detailsShow&&c._details.insertAfter(c.nTr)}return this});p(["row().child.show()","row().child().show()"],function(){Vb(this,
-!0);return this});p(["row().child.hide()","row().child().hide()"],function(){Vb(this,!1);return this});p(["row().child.remove()","row().child().remove()"],function(){cb(this);return this});p("row().child.isShown()",function(){var a=this.context;return a.length&&this.length?a[0].aoData[this[0]]._detailsShow||!1:!1});var dc=/^(.+):(name|visIdx|visible)$/,Wb=function(a,b,c,d,e){for(var c=[],d=0,f=e.length;d<f;d++)c.push(B(a,e[d],b));return c};p("columns()",function(a,b){a===k?a="":h.isPlainObject(a)&&
-(b=a,a="");var b=ab(b),c=this.iterator("table",function(c){var e=a,f=b,g=c.aoColumns,j=D(g,"sName"),i=D(g,"nTh");return $a("column",e,function(a){var b=Pb(a);if(a==="")return X(g.length);if(b!==null)return[b>=0?b:g.length+b];if(typeof a==="function"){var e=Da(c,f);return h.map(g,function(b,f){return a(f,Wb(c,f,0,0,e),i[f])?f:null})}var k=typeof a==="string"?a.match(dc):"";if(k)switch(k[2]){case "visIdx":case "visible":b=parseInt(k[1],10);if(b<0){var m=h.map(g,function(a,b){return a.bVisible?b:null});
-return[m[m.length+b]]}return[$(c,b)];case "name":return h.map(j,function(a,b){return a===k[1]?b:null})}else return h(i).filter(a).map(function(){return h.inArray(this,i)}).toArray()},c,f)},1);c.selector.cols=a;c.selector.opts=b;return c});r("columns().header()","column().header()",function(){return this.iterator("column",function(a,b){return a.aoColumns[b].nTh},1)});r("columns().footer()","column().footer()",function(){return this.iterator("column",function(a,b){return a.aoColumns[b].nTf},1)});r("columns().data()",
-"column().data()",function(){return this.iterator("column-rows",Wb,1)});r("columns().dataSrc()","column().dataSrc()",function(){return this.iterator("column",function(a,b){return a.aoColumns[b].mData},1)});r("columns().cache()","column().cache()",function(a){return this.iterator("column-rows",function(b,c,d,e,f){return ja(b.aoData,f,"search"===a?"_aFilterData":"_aSortData",c)},1)});r("columns().nodes()","column().nodes()",function(){return this.iterator("column-rows",function(a,b,c,d,e){return ja(a.aoData,
-e,"anCells",b)},1)});r("columns().visible()","column().visible()",function(a,b){return this.iterator("column",function(c,d){if(a===k)return c.aoColumns[d].bVisible;var e=c.aoColumns,f=e[d],g=c.aoData,j,i,m;if(a!==k&&f.bVisible!==a){if(a){var l=h.inArray(!0,D(e,"bVisible"),d+1);j=0;for(i=g.length;j<i;j++)m=g[j].nTr,e=g[j].anCells,m&&m.insertBefore(e[d],e[l]||null)}else h(D(c.aoData,"anCells",d)).detach();f.bVisible=a;ga(c,c.aoHeader);ga(c,c.aoFooter);if(b===k||b)U(c),(c.oScroll.sX||c.oScroll.sY)&&
-Z(c);v(c,null,"column-visibility",[c,d,a,b]);ya(c)}})});r("columns().indexes()","column().index()",function(a){return this.iterator("column",function(b,c){return"visible"===a?ba(b,c):c},1)});p("columns.adjust()",function(){return this.iterator("table",function(a){U(a)},1)});p("column.index()",function(a,b){if(0!==this.context.length){var c=this.context[0];if("fromVisible"===a||"toData"===a)return $(c,b);if("fromData"===a||"toVisible"===a)return ba(c,b)}});p("column()",function(a,b){return bb(this.columns(a,
-b))});p("cells()",function(a,b,c){h.isPlainObject(a)&&(a.row===k?(c=a,a=null):(c=b,b=null));h.isPlainObject(b)&&(c=b,b=null);if(null===b||b===k)return this.iterator("table",function(b){var d=a,e=ab(c),f=b.aoData,g=Da(b,e),j=Sb(ja(f,g,"anCells")),i=h([].concat.apply([],j)),l,m=b.aoColumns.length,o,p,t,r,s,v;return $a("cell",d,function(a){var c=typeof a==="function";if(a===null||a===k||c){o=[];p=0;for(t=g.length;p<t;p++){l=g[p];for(r=0;r<m;r++){s={row:l,column:r};if(c){v=f[l];a(s,B(b,l,r),v.anCells?
-v.anCells[r]:null)&&o.push(s)}else o.push(s)}}return o}return h.isPlainObject(a)?[a]:i.filter(a).map(function(a,b){return{row:b._DT_CellIndex.row,column:b._DT_CellIndex.column}}).toArray()},b,e)});var d=this.columns(b,c),e=this.rows(a,c),f,g,j,i,m,l=this.iterator("table",function(a,b){f=[];g=0;for(j=e[b].length;g<j;g++){i=0;for(m=d[b].length;i<m;i++)f.push({row:e[b][g],column:d[b][i]})}return f},1);h.extend(l.selector,{cols:b,rows:a,opts:c});return l});r("cells().nodes()","cell().node()",function(){return this.iterator("cell",
-function(a,b,c){return(a=a.aoData[b].anCells)?a[c]:k},1)});p("cells().data()",function(){return this.iterator("cell",function(a,b,c){return B(a,b,c)},1)});r("cells().cache()","cell().cache()",function(a){a="search"===a?"_aFilterData":"_aSortData";return this.iterator("cell",function(b,c,d){return b.aoData[c][a][d]},1)});r("cells().render()","cell().render()",function(a){return this.iterator("cell",function(b,c,d){return B(b,c,d,a)},1)});r("cells().indexes()","cell().index()",function(){return this.iterator("cell",
-function(a,b,c){return{row:b,column:c,columnVisible:ba(a,c)}},1)});r("cells().invalidate()","cell().invalidate()",function(a){return this.iterator("cell",function(b,c,d){ea(b,c,a,d)})});p("cell()",function(a,b,c){return bb(this.cells(a,b,c))});p("cell().data()",function(a){var b=this.context,c=this[0];if(a===k)return b.length&&c.length?B(b[0],c[0].row,c[0].column):k;jb(b[0],c[0].row,c[0].column,a);ea(b[0],c[0].row,"data",c[0].column);return this});p("order()",function(a,b){var c=this.context;if(a===
-k)return 0!==c.length?c[0].aaSorting:k;"number"===typeof a?a=[[a,b]]:h.isArray(a[0])||(a=Array.prototype.slice.call(arguments));return this.iterator("table",function(b){b.aaSorting=a.slice()})});p("order.listener()",function(a,b,c){return this.iterator("table",function(d){Oa(d,a,b,c)})});p("order.fixed()",function(a){if(!a){var b=this.context,b=b.length?b[0].aaSortingFixed:k;return h.isArray(b)?{pre:b}:b}return this.iterator("table",function(b){b.aaSortingFixed=h.extend(!0,{},a)})});p(["columns().order()",
-"column().order()"],function(a){var b=this;return this.iterator("table",function(c,d){var e=[];h.each(b[d],function(b,c){e.push([c,a])});c.aaSorting=e})});p("search()",function(a,b,c,d){var e=this.context;return a===k?0!==e.length?e[0].oPreviousSearch.sSearch:k:this.iterator("table",function(e){e.oFeatures.bFilter&&ha(e,h.extend({},e.oPreviousSearch,{sSearch:a+"",bRegex:null===b?!1:b,bSmart:null===c?!0:c,bCaseInsensitive:null===d?!0:d}),1)})});r("columns().search()","column().search()",function(a,
-b,c,d){return this.iterator("column",function(e,f){var g=e.aoPreSearchCols;if(a===k)return g[f].sSearch;e.oFeatures.bFilter&&(h.extend(g[f],{sSearch:a+"",bRegex:null===b?!1:b,bSmart:null===c?!0:c,bCaseInsensitive:null===d?!0:d}),ha(e,e.oPreviousSearch,1))})});p("state()",function(){return this.context.length?this.context[0].oSavedState:null});p("state.clear()",function(){return this.iterator("table",function(a){a.fnStateSaveCallback.call(a.oInstance,a,{})})});p("state.loaded()",function(){return this.context.length?
-this.context[0].oLoadedState:null});p("state.save()",function(){return this.iterator("table",function(a){ya(a)})});m.versionCheck=m.fnVersionCheck=function(a){for(var b=m.version.split("."),a=a.split("."),c,d,e=0,f=a.length;e<f;e++)if(c=parseInt(b[e],10)||0,d=parseInt(a[e],10)||0,c!==d)return c>d;return!0};m.isDataTable=m.fnIsDataTable=function(a){var b=h(a).get(0),c=!1;h.each(m.settings,function(a,e){var f=e.nScrollHead?h("table",e.nScrollHead)[0]:null,g=e.nScrollFoot?h("table",e.nScrollFoot)[0]:
-null;if(e.nTable===b||f===b||g===b)c=!0});return c};m.tables=m.fnTables=function(a){var b=!1;h.isPlainObject(a)&&(b=a.api,a=a.visible);var c=h.map(m.settings,function(b){if(!a||a&&h(b.nTable).is(":visible"))return b.nTable});return b?new t(c):c};m.util={throttle:ua,escapeRegex:va};m.camelToHungarian=J;p("$()",function(a,b){var c=this.rows(b).nodes(),c=h(c);return h([].concat(c.filter(a).toArray(),c.find(a).toArray()))});h.each(["on","one","off"],function(a,b){p(b+"()",function(){var a=Array.prototype.slice.call(arguments);
-a[0].match(/\.dt\b/)||(a[0]+=".dt");var d=h(this.tables().nodes());d[b].apply(d,a);return this})});p("clear()",function(){return this.iterator("table",function(a){na(a)})});p("settings()",function(){return new t(this.context,this.context)});p("init()",function(){var a=this.context;return a.length?a[0].oInit:null});p("data()",function(){return this.iterator("table",function(a){return D(a.aoData,"_aData")}).flatten()});p("destroy()",function(a){a=a||!1;return this.iterator("table",function(b){var c=
-b.nTableWrapper.parentNode,d=b.oClasses,e=b.nTable,f=b.nTBody,g=b.nTHead,j=b.nTFoot,i=h(e),f=h(f),k=h(b.nTableWrapper),l=h.map(b.aoData,function(a){return a.nTr}),p;b.bDestroying=!0;v(b,"aoDestroyCallback","destroy",[b]);a||(new t(b)).columns().visible(!0);k.unbind(".DT").find(":not(tbody *)").unbind(".DT");h(E).unbind(".DT-"+b.sInstance);e!=g.parentNode&&(i.children("thead").detach(),i.append(g));j&&e!=j.parentNode&&(i.children("tfoot").detach(),i.append(j));b.aaSorting=[];b.aaSortingFixed=[];xa(b);
-h(l).removeClass(b.asStripeClasses.join(" "));h("th, td",g).removeClass(d.sSortable+" "+d.sSortableAsc+" "+d.sSortableDesc+" "+d.sSortableNone);b.bJUI&&(h("th span."+d.sSortIcon+", td span."+d.sSortIcon,g).detach(),h("th, td",g).each(function(){var a=h("div."+d.sSortJUIWrapper,this);h(this).append(a.contents());a.detach()}));f.children().detach();f.append(l);g=a?"remove":"detach";i[g]();k[g]();!a&&c&&(c.insertBefore(e,b.nTableReinsertBefore),i.css("width",b.sDestroyWidth).removeClass(d.sTable),(p=
-b.asDestroyStripes.length)&&f.children().each(function(a){h(this).addClass(b.asDestroyStripes[a%p])}));c=h.inArray(b,m.settings);-1!==c&&m.settings.splice(c,1)})});h.each(["column","row","cell"],function(a,b){p(b+"s().every()",function(a){var d=this.selector.opts,e=this;return this.iterator(b,function(f,g,h,i,m){a.call(e[b](g,"cell"===b?h:d,"cell"===b?d:k),g,h,i,m)})})});p("i18n()",function(a,b,c){var d=this.context[0],a=Q(a)(d.oLanguage);a===k&&(a=b);c!==k&&h.isPlainObject(a)&&(a=a[c]!==k?a[c]:a._);
-return a.replace("%d",c)});m.version="1.10.10";m.settings=[];m.models={};m.models.oSearch={bCaseInsensitive:!0,sSearch:"",bRegex:!1,bSmart:!0};m.models.oRow={nTr:null,anCells:null,_aData:[],_aSortData:null,_aFilterData:null,_sFilterRow:null,_sRowStripe:"",src:null,idx:-1};m.models.oColumn={idx:null,aDataSort:null,asSorting:null,bSearchable:null,bSortable:null,bVisible:null,_sManualType:null,_bAttrSrc:!1,fnCreatedCell:null,fnGetData:null,fnSetData:null,mData:null,mRender:null,nTh:null,nTf:null,sClass:null,
-sContentPadding:null,sDefaultContent:null,sName:null,sSortDataType:"std",sSortingClass:null,sSortingClassJUI:null,sTitle:null,sType:null,sWidth:null,sWidthOrig:null};m.defaults={aaData:null,aaSorting:[[0,"asc"]],aaSortingFixed:[],ajax:null,aLengthMenu:[10,25,50,100],aoColumns:null,aoColumnDefs:null,aoSearchCols:[],asStripeClasses:null,bAutoWidth:!0,bDeferRender:!1,bDestroy:!1,bFilter:!0,bInfo:!0,bJQueryUI:!1,bLengthChange:!0,bPaginate:!0,bProcessing:!1,bRetrieve:!1,bScrollCollapse:!1,bServerSide:!1,
-bSort:!0,bSortMulti:!0,bSortCellsTop:!1,bSortClasses:!0,bStateSave:!1,fnCreatedRow:null,fnDrawCallback:null,fnFooterCallback:null,fnFormatNumber:function(a){return a.toString().replace(/\B(?=(\d{3})+(?!\d))/g,this.oLanguage.sThousands)},fnHeaderCallback:null,fnInfoCallback:null,fnInitComplete:null,fnPreDrawCallback:null,fnRowCallback:null,fnServerData:null,fnServerParams:null,fnStateLoadCallback:function(a){try{return JSON.parse((-1===a.iStateDuration?sessionStorage:localStorage).getItem("DataTables_"+
-a.sInstance+"_"+location.pathname))}catch(b){}},fnStateLoadParams:null,fnStateLoaded:null,fnStateSaveCallback:function(a,b){try{(-1===a.iStateDuration?sessionStorage:localStorage).setItem("DataTables_"+a.sInstance+"_"+location.pathname,JSON.stringify(b))}catch(c){}},fnStateSaveParams:null,iStateDuration:7200,iDeferLoading:null,iDisplayLength:10,iDisplayStart:0,iTabIndex:0,oClasses:{},oLanguage:{oAria:{sSortAscending:": activate to sort column ascending",sSortDescending:": activate to sort column descending"},
-oPaginate:{sFirst:"First",sLast:"Last",sNext:"Next",sPrevious:"Previous"},sEmptyTable:"No data available in table",sInfo:"Showing _START_ to _END_ of _TOTAL_ entries",sInfoEmpty:"Showing 0 to 0 of 0 entries",sInfoFiltered:"(filtered from _MAX_ total entries)",sInfoPostFix:"",sDecimal:"",sThousands:",",sLengthMenu:"Show _MENU_ entries",sLoadingRecords:"Loading...",sProcessing:"Processing...",sSearch:"Search:",sSearchPlaceholder:"",sUrl:"",sZeroRecords:"No matching records found"},oSearch:h.extend({},
-m.models.oSearch),sAjaxDataProp:"data",sAjaxSource:null,sDom:"lfrtip",searchDelay:null,sPaginationType:"simple_numbers",sScrollX:"",sScrollXInner:"",sScrollY:"",sServerMethod:"GET",renderer:null,rowId:"DT_RowId"};Y(m.defaults);m.defaults.column={aDataSort:null,iDataSort:-1,asSorting:["asc","desc"],bSearchable:!0,bSortable:!0,bVisible:!0,fnCreatedCell:null,mData:null,mRender:null,sCellType:"td",sClass:"",sContentPadding:"",sDefaultContent:null,sName:"",sSortDataType:"std",sTitle:null,sType:null,sWidth:null};
-Y(m.defaults.column);m.models.oSettings={oFeatures:{bAutoWidth:null,bDeferRender:null,bFilter:null,bInfo:null,bLengthChange:null,bPaginate:null,bProcessing:null,bServerSide:null,bSort:null,bSortMulti:null,bSortClasses:null,bStateSave:null},oScroll:{bCollapse:null,iBarWidth:0,sX:null,sXInner:null,sY:null},oLanguage:{fnInfoCallback:null},oBrowser:{bScrollOversize:!1,bScrollbarLeft:!1,bBounding:!1,barWidth:0},ajax:null,aanFeatures:[],aoData:[],aiDisplay:[],aiDisplayMaster:[],aIds:{},aoColumns:[],aoHeader:[],
-aoFooter:[],oPreviousSearch:{},aoPreSearchCols:[],aaSorting:null,aaSortingFixed:[],asStripeClasses:null,asDestroyStripes:[],sDestroyWidth:0,aoRowCallback:[],aoHeaderCallback:[],aoFooterCallback:[],aoDrawCallback:[],aoRowCreatedCallback:[],aoPreDrawCallback:[],aoInitComplete:[],aoStateSaveParams:[],aoStateLoadParams:[],aoStateLoaded:[],sTableId:"",nTable:null,nTHead:null,nTFoot:null,nTBody:null,nTableWrapper:null,bDeferLoading:!1,bInitialised:!1,aoOpenRows:[],sDom:null,searchDelay:null,sPaginationType:"two_button",
-iStateDuration:0,aoStateSave:[],aoStateLoad:[],oSavedState:null,oLoadedState:null,sAjaxSource:null,sAjaxDataProp:null,bAjaxDataGet:!0,jqXHR:null,json:k,oAjaxData:k,fnServerData:null,aoServerParams:[],sServerMethod:null,fnFormatNumber:null,aLengthMenu:null,iDraw:0,bDrawing:!1,iDrawError:-1,_iDisplayLength:10,_iDisplayStart:0,_iRecordsTotal:0,_iRecordsDisplay:0,bJUI:null,oClasses:{},bFiltered:!1,bSorted:!1,bSortCellsTop:null,oInit:null,aoDestroyCallback:[],fnRecordsTotal:function(){return"ssp"==y(this)?
-1*this._iRecordsTotal:this.aiDisplayMaster.length},fnRecordsDisplay:function(){return"ssp"==y(this)?1*this._iRecordsDisplay:this.aiDisplay.length},fnDisplayEnd:function(){var a=this._iDisplayLength,b=this._iDisplayStart,c=b+a,d=this.aiDisplay.length,e=this.oFeatures,f=e.bPaginate;return e.bServerSide?!1===f||-1===a?b+d:Math.min(b+a,this._iRecordsDisplay):!f||c>d||-1===a?d:c},oInstance:null,sInstance:null,iTabIndex:0,nScrollHead:null,nScrollFoot:null,aLastSort:[],oPlugins:{},rowIdFn:null,rowId:null};
-m.ext=s={buttons:{},classes:{},build:"bs/dt-1.10.10",errMode:"alert",feature:[],search:[],selector:{cell:[],column:[],row:[]},internal:{},legacy:{ajax:null},pager:{},renderer:{pageButton:{},header:{}},order:{},type:{detect:[],search:{},order:{}},_unique:0,fnVersionCheck:m.fnVersionCheck,iApiIndex:0,oJUIClasses:{},sVersion:m.version};h.extend(s,{afnFiltering:s.search,aTypes:s.type.detect,ofnSearch:s.type.search,oSort:s.type.order,afnSortData:s.order,aoFeatures:s.feature,oApi:s.internal,oStdClasses:s.classes,
-oPagination:s.pager});h.extend(m.ext.classes,{sTable:"dataTable",sNoFooter:"no-footer",sPageButton:"paginate_button",sPageButtonActive:"current",sPageButtonDisabled:"disabled",sStripeOdd:"odd",sStripeEven:"even",sRowEmpty:"dataTables_empty",sWrapper:"dataTables_wrapper",sFilter:"dataTables_filter",sInfo:"dataTables_info",sPaging:"dataTables_paginate paging_",sLength:"dataTables_length",sProcessing:"dataTables_processing",sSortAsc:"sorting_asc",sSortDesc:"sorting_desc",sSortable:"sorting",sSortableAsc:"sorting_asc_disabled",
-sSortableDesc:"sorting_desc_disabled",sSortableNone:"sorting_disabled",sSortColumn:"sorting_",sFilterInput:"",sLengthSelect:"",sScrollWrapper:"dataTables_scroll",sScrollHead:"dataTables_scrollHead",sScrollHeadInner:"dataTables_scrollHeadInner",sScrollBody:"dataTables_scrollBody",sScrollFoot:"dataTables_scrollFoot",sScrollFootInner:"dataTables_scrollFootInner",sHeaderTH:"",sFooterTH:"",sSortJUIAsc:"",sSortJUIDesc:"",sSortJUI:"",sSortJUIAscAllowed:"",sSortJUIDescAllowed:"",sSortJUIWrapper:"",sSortIcon:"",
-sJUIHeader:"",sJUIFooter:""});var Ea="",Ea="",G=Ea+"ui-state-default",ka=Ea+"css_right ui-icon ui-icon-",Xb=Ea+"fg-toolbar ui-toolbar ui-widget-header ui-helper-clearfix";h.extend(m.ext.oJUIClasses,m.ext.classes,{sPageButton:"fg-button ui-button "+G,sPageButtonActive:"ui-state-disabled",sPageButtonDisabled:"ui-state-disabled",sPaging:"dataTables_paginate fg-buttonset ui-buttonset fg-buttonset-multi ui-buttonset-multi paging_",sSortAsc:G+" sorting_asc",sSortDesc:G+" sorting_desc",sSortable:G+" sorting",
-sSortableAsc:G+" sorting_asc_disabled",sSortableDesc:G+" sorting_desc_disabled",sSortableNone:G+" sorting_disabled",sSortJUIAsc:ka+"triangle-1-n",sSortJUIDesc:ka+"triangle-1-s",sSortJUI:ka+"carat-2-n-s",sSortJUIAscAllowed:ka+"carat-1-n",sSortJUIDescAllowed:ka+"carat-1-s",sSortJUIWrapper:"DataTables_sort_wrapper",sSortIcon:"DataTables_sort_icon",sScrollHead:"dataTables_scrollHead "+G,sScrollFoot:"dataTables_scrollFoot "+G,sHeaderTH:G,sFooterTH:G,sJUIHeader:Xb+" ui-corner-tl ui-corner-tr",sJUIFooter:Xb+
-" ui-corner-bl ui-corner-br"});var Mb=m.ext.pager;h.extend(Mb,{simple:function(){return["previous","next"]},full:function(){return["first","previous","next","last"]},numbers:function(a,b){return[Aa(a,b)]},simple_numbers:function(a,b){return["previous",Aa(a,b),"next"]},full_numbers:function(a,b){return["first","previous",Aa(a,b),"next","last"]},_numbers:Aa,numbers_length:7});h.extend(!0,m.ext.renderer,{pageButton:{_:function(a,b,c,d,e,f){var g=a.oClasses,j=a.oLanguage.oPaginate,i=a.oLanguage.oAria.paginate||
-{},k,l,m=0,p=function(b,d){var n,r,t,s,v=function(b){Ta(a,b.data.action,true)};n=0;for(r=d.length;n<r;n++){s=d[n];if(h.isArray(s)){t=h("<"+(s.DT_el||"div")+"/>").appendTo(b);p(t,s)}else{k=null;l="";switch(s){case "ellipsis":b.append('<span class="ellipsis">&#x2026;</span>');break;case "first":k=j.sFirst;l=s+(e>0?"":" "+g.sPageButtonDisabled);break;case "previous":k=j.sPrevious;l=s+(e>0?"":" "+g.sPageButtonDisabled);break;case "next":k=j.sNext;l=s+(e<f-1?"":" "+g.sPageButtonDisabled);break;case "last":k=
-j.sLast;l=s+(e<f-1?"":" "+g.sPageButtonDisabled);break;default:k=s+1;l=e===s?g.sPageButtonActive:""}if(k!==null){t=h("<a>",{"class":g.sPageButton+" "+l,"aria-controls":a.sTableId,"aria-label":i[s],"data-dt-idx":m,tabindex:a.iTabIndex,id:c===0&&typeof s==="string"?a.sTableId+"_"+s:null}).html(k).appendTo(b);Wa(t,{action:s},v);m++}}}},r;try{r=h(b).find(H.activeElement).data("dt-idx")}catch(n){}p(h(b).empty(),d);r&&h(b).find("[data-dt-idx="+r+"]").focus()}}});h.extend(m.ext.type.detect,[function(a,b){var c=
-b.oLanguage.sDecimal;return Za(a,c)?"num"+c:null},function(a){if(a&&!(a instanceof Date)&&(!ac.test(a)||!bc.test(a)))return null;var b=Date.parse(a);return null!==b&&!isNaN(b)||M(a)?"date":null},function(a,b){var c=b.oLanguage.sDecimal;return Za(a,c,!0)?"num-fmt"+c:null},function(a,b){var c=b.oLanguage.sDecimal;return Rb(a,c)?"html-num"+c:null},function(a,b){var c=b.oLanguage.sDecimal;return Rb(a,c,!0)?"html-num-fmt"+c:null},function(a){return M(a)||"string"===typeof a&&-1!==a.indexOf("<")?"html":
-null}]);h.extend(m.ext.type.search,{html:function(a){return M(a)?a:"string"===typeof a?a.replace(Ob," ").replace(Ca,""):""},string:function(a){return M(a)?a:"string"===typeof a?a.replace(Ob," "):a}});var Ba=function(a,b,c,d){if(0!==a&&(!a||"-"===a))return-Infinity;b&&(a=Qb(a,b));a.replace&&(c&&(a=a.replace(c,"")),d&&(a=a.replace(d,"")));return 1*a};h.extend(s.type.order,{"date-pre":function(a){return Date.parse(a)||0},"html-pre":function(a){return M(a)?"":a.replace?a.replace(/<.*?>/g,"").toLowerCase():
-a+""},"string-pre":function(a){return M(a)?"":"string"===typeof a?a.toLowerCase():!a.toString?"":a.toString()},"string-asc":function(a,b){return a<b?-1:a>b?1:0},"string-desc":function(a,b){return a<b?1:a>b?-1:0}});db("");h.extend(!0,m.ext.renderer,{header:{_:function(a,b,c,d){h(a.nTable).on("order.dt.DT",function(e,f,g,h){if(a===f){e=c.idx;b.removeClass(c.sSortingClass+" "+d.sSortAsc+" "+d.sSortDesc).addClass(h[e]=="asc"?d.sSortAsc:h[e]=="desc"?d.sSortDesc:c.sSortingClass)}})},jqueryui:function(a,
-b,c,d){h("<div/>").addClass(d.sSortJUIWrapper).append(b.contents()).append(h("<span/>").addClass(d.sSortIcon+" "+c.sSortingClassJUI)).appendTo(b);h(a.nTable).on("order.dt.DT",function(e,f,g,h){if(a===f){e=c.idx;b.removeClass(d.sSortAsc+" "+d.sSortDesc).addClass(h[e]=="asc"?d.sSortAsc:h[e]=="desc"?d.sSortDesc:c.sSortingClass);b.find("span."+d.sSortIcon).removeClass(d.sSortJUIAsc+" "+d.sSortJUIDesc+" "+d.sSortJUI+" "+d.sSortJUIAscAllowed+" "+d.sSortJUIDescAllowed).addClass(h[e]=="asc"?d.sSortJUIAsc:
-h[e]=="desc"?d.sSortJUIDesc:c.sSortingClassJUI)}})}}});m.render={number:function(a,b,c,d,e){return{display:function(f){if("number"!==typeof f&&"string"!==typeof f)return f;var g=0>f?"-":"",h=parseFloat(f);if(isNaN(h))return f;f=Math.abs(h);h=parseInt(f,10);f=c?b+(f-h).toFixed(c).substring(2):"";return g+(d||"")+h.toString().replace(/\B(?=(\d{3})+(?!\d))/g,a)+f+(e||"")}}},text:function(){return{display:function(a){return"string"===typeof a?a.replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;"):
-a}}}};h.extend(m.ext.internal,{_fnExternApiFunc:Nb,_fnBuildAjax:ra,_fnAjaxUpdate:lb,_fnAjaxParameters:ub,_fnAjaxUpdateDraw:vb,_fnAjaxDataSrc:sa,_fnAddColumn:Ga,_fnColumnOptions:la,_fnAdjustColumnSizing:U,_fnVisibleToColumnIndex:$,_fnColumnIndexToVisible:ba,_fnVisbleColumns:ca,_fnGetColumns:aa,_fnColumnTypes:Ia,_fnApplyColumnDefs:ib,_fnHungarianMap:Y,_fnCamelToHungarian:J,_fnLanguageCompat:Fa,_fnBrowserDetect:gb,_fnAddData:N,_fnAddTr:ma,_fnNodeToDataIndex:function(a,b){return b._DT_RowIndex!==k?b._DT_RowIndex:
-null},_fnNodeToColumnIndex:function(a,b,c){return h.inArray(c,a.aoData[b].anCells)},_fnGetCellData:B,_fnSetCellData:jb,_fnSplitObjNotation:La,_fnGetObjectDataFn:Q,_fnSetObjectDataFn:R,_fnGetDataMaster:Ma,_fnClearTable:na,_fnDeleteIndex:oa,_fnInvalidate:ea,_fnGetRowElements:Ka,_fnCreateTr:Ja,_fnBuildHead:kb,_fnDrawHead:ga,_fnDraw:O,_fnReDraw:T,_fnAddOptionsHtml:nb,_fnDetectHeader:fa,_fnGetUniqueThs:qa,_fnFeatureHtmlFilter:pb,_fnFilterComplete:ha,_fnFilterCustom:yb,_fnFilterColumn:xb,_fnFilter:wb,_fnFilterCreateSearch:Qa,
-_fnEscapeRegex:va,_fnFilterData:zb,_fnFeatureHtmlInfo:sb,_fnUpdateInfo:Cb,_fnInfoMacros:Db,_fnInitialise:ia,_fnInitComplete:ta,_fnLengthChange:Ra,_fnFeatureHtmlLength:ob,_fnFeatureHtmlPaginate:tb,_fnPageChange:Ta,_fnFeatureHtmlProcessing:qb,_fnProcessingDisplay:C,_fnFeatureHtmlTable:rb,_fnScrollDraw:Z,_fnApplyToChildren:I,_fnCalculateColumnWidths:Ha,_fnThrottle:ua,_fnConvertToWidth:Fb,_fnGetWidestNode:Gb,_fnGetMaxLenString:Hb,_fnStringToCss:w,_fnSortFlatten:W,_fnSort:mb,_fnSortAria:Jb,_fnSortListener:Va,
-_fnSortAttachListener:Oa,_fnSortingClasses:xa,_fnSortData:Ib,_fnSaveState:ya,_fnLoadState:Kb,_fnSettingsFromNode:za,_fnLog:K,_fnMap:F,_fnBindAction:Wa,_fnCallbackReg:z,_fnCallbackFire:v,_fnLengthOverflow:Sa,_fnRenderer:Pa,_fnDataSource:y,_fnRowAttributes:Na,_fnCalculateEnd:function(){}});h.fn.dataTable=m;m.$=h;h.fn.dataTableSettings=m.settings;h.fn.dataTableExt=m.ext;h.fn.DataTable=function(a){return h(this).dataTable(a).api()};h.each(m,function(a,b){h.fn.DataTable[a]=b});return h.fn.dataTable});
-
-
-/*!
- DataTables Bootstrap 3 integration
- ©2011-2015 SpryMedia Ltd - datatables.net/license
-*/
-(function(b){"function"===typeof define&&define.amd?define(["jquery","datatables.net"],function(a){return b(a,window,document)}):"object"===typeof exports?module.exports=function(a,e){a||(a=window);if(!e||!e.fn.dataTable)e=require("datatables.net")(a,e).$;return b(e,a,a.document)}:b(jQuery,window,document)})(function(b,a,e){var d=b.fn.dataTable;b.extend(!0,d.defaults,{dom:"<'row'<'col-sm-6'l><'col-sm-6'f>><'row'<'col-sm-12'tr>><'row'<'col-sm-5'i><'col-sm-7'p>>",renderer:"bootstrap"});b.extend(d.ext.classes,
-{sWrapper:"dataTables_wrapper form-inline dt-bootstrap",sFilterInput:"form-control input-sm",sLengthSelect:"form-control input-sm",sProcessing:"dataTables_processing panel panel-default"});d.ext.renderer.pageButton.bootstrap=function(a,h,r,m,j,n){var o=new d.Api(a),s=a.oClasses,k=a.oLanguage.oPaginate,t=a.oLanguage.oAria.paginate||{},f,g,p=0,q=function(d,e){var l,h,i,c,m=function(a){a.preventDefault();!b(a.currentTarget).hasClass("disabled")&&o.page()!=a.data.action&&o.page(a.data.action).draw("page")};
-l=0;for(h=e.length;l<h;l++)if(c=e[l],b.isArray(c))q(d,c);else{g=f="";switch(c){case "ellipsis":f="&#x2026;";g="disabled";break;case "first":f=k.sFirst;g=c+(0<j?"":" disabled");break;case "previous":f=k.sPrevious;g=c+(0<j?"":" disabled");break;case "next":f=k.sNext;g=c+(j<n-1?"":" disabled");break;case "last":f=k.sLast;g=c+(j<n-1?"":" disabled");break;default:f=c+1,g=j===c?"active":""}f&&(i=b("<li>",{"class":s.sPageButton+" "+g,id:0===r&&"string"===typeof c?a.sTableId+"_"+c:null}).append(b("<a>",{href:"#",
-"aria-controls":a.sTableId,"aria-label":t[c],"data-dt-idx":p,tabindex:a.iTabIndex}).html(f)).appendTo(d),a.oApi._fnBindAction(i,{action:c},m),p++)}},i;try{i=b(h).find(e.activeElement).data("dt-idx")}catch(u){}q(b(h).empty().html('<ul class="pagination"/>').children("ul"),m);i&&b(h).find("[data-dt-idx="+i+"]").focus()};d.TableTools&&(b.extend(!0,d.TableTools.classes,{container:"DTTT btn-group",buttons:{normal:"btn btn-default",disabled:"disabled"},collection:{container:"DTTT_dropdown dropdown-menu",
-buttons:{normal:"",disabled:"disabled"}},print:{info:"DTTT_print_info"},select:{row:"active"}}),b.extend(!0,d.TableTools.DEFAULTS.oTags,{collection:{container:"ul",button:"li",liner:"a"}}));return d});
-
-
diff --git a/airflow/www_rbac/static/js/clock.js b/airflow/www_rbac/static/js/clock.js
new file mode 100644
index 0000000000000..9842e3bfebfdc
--- /dev/null
+++ b/airflow/www_rbac/static/js/clock.js
@@ -0,0 +1,41 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+require('./jqClock.min');
+
+$(document).ready(function () {
+  x = new Date();
+  const UTCseconds = (x.getTime() + x.getTimezoneOffset() * 60 * 1000);
+  $("#clock").clock({
+    "dateFormat": "Y-m-d ",
+    "timeFormat": "H:i:s %UTC%",
+    "timestamp": UTCseconds
+  }).click(function () {
+    alert(hostName); // Declared in baselayout.html
+  });
+  $('span').tooltip();
+
+  $.ajaxSetup({
+    beforeSend: function (xhr, settings) {
+      if (!/^(GET|HEAD|OPTIONS|TRACE)$/i.test(settings.type) && !this.crossDomain) {
+        // csrfToken declared in baselayout.html
+        xhr.setRequestHeader("X-CSRFToken", csrfToken);
+      }
+    }
+  });
+});
diff --git a/airflow/www_rbac/static/js/connection_form.js b/airflow/www_rbac/static/js/connection_form.js
new file mode 100644
index 0000000000000..e40f4df584253
--- /dev/null
+++ b/airflow/www_rbac/static/js/connection_form.js
@@ -0,0 +1,80 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * Created by janomar on 23/07/15.
+ */
+
+$(document).ready(function () {
+  var config = {
+    jdbc: {
+      hidden_fields: ['port', 'schema', 'extra'],
+      relabeling: {'host': 'Connection URL'},
+    },
+    google_cloud_platform: {
+      hidden_fields: ['host', 'schema', 'login', 'password', 'port', 'extra'],
+      relabeling: {},
+    },
+    cloudant: {
+      hidden_fields: ['port', 'extra'],
+      relabeling: {
+        'host': 'Account',
+        'login': 'Username (or API Key)',
+        'schema': 'Database'
+      }
+    },
+    docker: {
+      hidden_fields: ['port', 'schema'],
+      relabeling: {
+        'host': 'Registry URL',
+        'login': 'Username',
+      },
+    },
+  };
+
+  function connTypeChange(connectionType) {
+    $(".hide").removeClass("hide");
+    $.each($("[id^='extra__']"), function () {
+      $(this).parent().parent().addClass('hide')
+    });
+    $.each($("[id^='extra__" + connectionType + "']"), function () {
+      $(this).parent().parent().removeClass('hide')
+    });
+    $("label[orig_text]").each(function () {
+      $(this).text($(this).attr("orig_text"));
+    });
+    if (config[connectionType] != undefined) {
+      $.each(config[connectionType].hidden_fields, function (i, field) {
+        $("#" + field).parent().parent().addClass('hide')
+      });
+      $.each(config[connectionType].relabeling, function (k, v) {
+        lbl = $("label[for='" + k + "']");
+        lbl.attr("orig_text", lbl.text());
+        $("label[for='" + k + "']").text(v);
+      });
+    }
+  }
+
+  var connectionType = $("#conn_type").val();
+  $("#conn_type").on('change', function (e) {
+    connectionType = $("#conn_type").val();
+    connTypeChange(connectionType);
+  });
+  connTypeChange(connectionType);
+});
diff --git a/airflow/www_rbac/static/dagre-d3.js b/airflow/www_rbac/static/js/dagre-d3.js
similarity index 100%
rename from airflow/www_rbac/static/dagre-d3.js
rename to airflow/www_rbac/static/js/dagre-d3.js
diff --git a/airflow/www_rbac/static/gantt-chart-d3v2.js b/airflow/www_rbac/static/js/gantt-chart-d3v2.js
similarity index 100%
rename from airflow/www_rbac/static/gantt-chart-d3v2.js
rename to airflow/www_rbac/static/js/gantt-chart-d3v2.js
diff --git a/airflow/www_rbac/static/jqClock.min.js b/airflow/www_rbac/static/js/jqClock.min.js
similarity index 100%
rename from airflow/www_rbac/static/jqClock.min.js
rename to airflow/www_rbac/static/js/jqClock.min.js
diff --git a/airflow/www_rbac/static/nv.d3.css b/airflow/www_rbac/static/nv.d3.css
deleted file mode 100644
index 7ca7555ec000b..0000000000000
--- a/airflow/www_rbac/static/nv.d3.css
+++ /dev/null
@@ -1,788 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-
-/********************
- * HTML CSS
- */
-
-
-.chartWrap {
-  margin: 0;
-  padding: 0;
-  overflow: hidden;
-}
-
-/********************
-  Box shadow and border radius styling
-*/
-.nvtooltip.with-3d-shadow, .with-3d-shadow .nvtooltip {
-  -moz-box-shadow: 0 5px 10px rgba(0,0,0,.2);
-  -webkit-box-shadow: 0 5px 10px rgba(0,0,0,.2);
-  box-shadow: 0 5px 10px rgba(0,0,0,.2);
-
-  -webkit-border-radius: 6px;
-  -moz-border-radius: 6px;
-  border-radius: 6px;
-}
-
-/********************
- * TOOLTIP CSS
- */
-
-.nvtooltip {
-  position: absolute;
-  background-color: rgba(255,255,255,1.0);
-  padding: 1px;
-  border: 1px solid rgba(0,0,0,.2);
-  z-index: 10000;
-
-  font-family: Arial;
-  font-size: 13px;
-  text-align: left;
-  pointer-events: none;
-
-  white-space: nowrap;
-
-  -webkit-touch-callout: none;
-  -webkit-user-select: none;
-  -khtml-user-select: none;
-  -moz-user-select: none;
-  -ms-user-select: none;
-  user-select: none;
-}
-
-/*Give tooltips that old fade in transition by
-    putting a "with-transitions" class on the container div.
-*/
-.nvtooltip.with-transitions, .with-transitions .nvtooltip {
-  transition: opacity 250ms linear;
-  -moz-transition: opacity 250ms linear;
-  -webkit-transition: opacity 250ms linear;
-
-  transition-delay: 250ms;
-  -moz-transition-delay: 250ms;
-  -webkit-transition-delay: 250ms;
-}
-
-.nvtooltip.x-nvtooltip,
-.nvtooltip.y-nvtooltip {
-  padding: 8px;
-}
-
-.nvtooltip h3 {
-  margin: 0;
-  padding: 4px 14px;
-  line-height: 18px;
-  font-weight: normal;
-  background-color: rgba(247,247,247,0.75);
-  text-align: center;
-
-  border-bottom: 1px solid #ebebeb;
-
-  -webkit-border-radius: 5px 5px 0 0;
-  -moz-border-radius: 5px 5px 0 0;
-  border-radius: 5px 5px 0 0;
-}
-
-.nvtooltip p {
-  margin: 0;
-  padding: 5px 14px;
-  text-align: center;
-}
-
-.nvtooltip span {
-  display: inline-block;
-  margin: 2px 0;
-}
-
-.nvtooltip table {
-  margin: 6px;
-  border-spacing:0;
-}
-
-
-.nvtooltip table td {
-  padding: 2px 9px 2px 0;
-  vertical-align: middle;
-}
-
-.nvtooltip table td.key {
-  font-weight:normal;
-}
-.nvtooltip table td.value {
-  text-align: right;
-  font-weight: bold;
-}
-
-.nvtooltip table tr.highlight td {
-  padding: 1px 9px 1px 0;
-  border-bottom-style: solid;
-  border-bottom-width: 1px;
-  border-top-style: solid;
-  border-top-width: 1px;
-}
-
-.nvtooltip table td.legend-color-guide div {
-  width: 8px;
-  height: 8px;
-  vertical-align: middle;
-}
-
-.nvtooltip .footer {
-  padding: 3px;
-  text-align: center;
-}
-
-
-.nvtooltip-pending-removal {
-  position: absolute;
-  pointer-events: none;
-}
-
-
-/********************
- * SVG CSS
- */
-
-
-svg {
-  -webkit-touch-callout: none;
-  -webkit-user-select: none;
-  -khtml-user-select: none;
-  -moz-user-select: none;
-  -ms-user-select: none;
-  user-select: none;
-  /* Trying to get SVG to act like a greedy block in all browsers */
-  display: block;
-  width:100%;
-  height:100%;
-}
-
-
-svg text {
-  font: normal 12px Arial;
-}
-
-svg .title {
- font: bold 14px Arial;
-}
-
-.nvd3 .nv-background {
-  fill: white;
-  fill-opacity: 0;
-  /*
-  pointer-events: none;
-  */
-}
-
-.nvd3.nv-noData {
-  font-size: 18px;
-  font-weight: bold;
-}
-
-
-/**********
-*  Brush
-*/
-
-.nv-brush .extent {
-  fill-opacity: .125;
-  shape-rendering: crispEdges;
-}
-
-
-
-/**********
-*  Legend
-*/
-
-.nvd3 .nv-legend .nv-series {
-  cursor: pointer;
-}
-
-.nvd3 .nv-legend .disabled circle {
-  fill-opacity: 0;
-}
-
-
-
-/**********
-*  Axes
-*/
-.nvd3 .nv-axis {
-  pointer-events:none;
-}
-
-.nvd3 .nv-axis path {
-  fill: none;
-  stroke: #000;
-  stroke-opacity: .75;
-  shape-rendering: crispEdges;
-}
-
-.nvd3 .nv-axis path.domain {
-  stroke-opacity: .75;
-}
-
-.nvd3 .nv-axis.nv-x path.domain {
-  stroke-opacity: 0;
-}
-
-.nvd3 .nv-axis line {
-  fill: none;
-  stroke: #e5e5e5;
-  shape-rendering: crispEdges;
-}
-
-.nvd3 .nv-axis .zero line,
-/*this selector may not be necessary*/ .nvd3 .nv-axis line.zero {
-  stroke-opacity: .75;
-}
-
-.nvd3 .nv-axis .nv-axisMaxMin text {
-  font-weight: bold;
-}
-
-.nvd3 .x  .nv-axis .nv-axisMaxMin text,
-.nvd3 .x2 .nv-axis .nv-axisMaxMin text,
-.nvd3 .x3 .nv-axis .nv-axisMaxMin text {
-  text-anchor: middle
-}
-
-
-
-/**********
-*  Brush
-*/
-
-.nv-brush .resize path {
-  fill: #eee;
-  stroke: #666;
-}
-
-
-
-/**********
-*  Bars
-*/
-
-.nvd3 .nv-bars .negative rect {
-    zfill: brown;
-}
-
-.nvd3 .nv-bars rect {
-  zfill: steelblue;
-  fill-opacity: .75;
-
-  transition: fill-opacity 250ms linear;
-  -moz-transition: fill-opacity 250ms linear;
-  -webkit-transition: fill-opacity 250ms linear;
-}
-
-.nvd3 .nv-bars rect.hover {
-  fill-opacity: 1;
-}
-
-.nvd3 .nv-bars .hover rect {
-  fill: lightblue;
-}
-
-.nvd3 .nv-bars text {
-  fill: rgba(0,0,0,0);
-}
-
-.nvd3 .nv-bars .hover text {
-  fill: rgba(0,0,0,1);
-}
-
-
-/**********
-*  Bars
-*/
-
-.nvd3 .nv-multibar .nv-groups rect,
-.nvd3 .nv-multibarHorizontal .nv-groups rect,
-.nvd3 .nv-discretebar .nv-groups rect {
-  stroke-opacity: 0;
-
-  transition: fill-opacity 250ms linear;
-  -moz-transition: fill-opacity 250ms linear;
-  -webkit-transition: fill-opacity 250ms linear;
-}
-
-.nvd3 .nv-multibar .nv-groups rect:hover,
-.nvd3 .nv-multibarHorizontal .nv-groups rect:hover,
-.nvd3 .nv-discretebar .nv-groups rect:hover {
-  fill-opacity: 1;
-}
-
-.nvd3 .nv-discretebar .nv-groups text,
-.nvd3 .nv-multibarHorizontal .nv-groups text {
-  font-weight: bold;
-  fill: rgba(0,0,0,1);
-  stroke: rgba(0,0,0,0);
-}
-
-/***********
-*  Pie Chart
-*/
-
-.nvd3.nv-pie path {
-  stroke-opacity: 0;
-  transition: fill-opacity 250ms linear, stroke-width 250ms linear, stroke-opacity 250ms linear;
-  -moz-transition: fill-opacity 250ms linear, stroke-width 250ms linear, stroke-opacity 250ms linear;
-  -webkit-transition: fill-opacity 250ms linear, stroke-width 250ms linear, stroke-opacity 250ms linear;
-
-}
-
-.nvd3.nv-pie .nv-slice text {
-  stroke: #000;
-  stroke-width: 0;
-}
-
-.nvd3.nv-pie path {
-  stroke: #fff;
-  stroke-width: 1px;
-  stroke-opacity: 1;
-}
-
-.nvd3.nv-pie .hover path {
-  fill-opacity: .7;
-}
-.nvd3.nv-pie .nv-label {
-  pointer-events: none;
-}
-.nvd3.nv-pie .nv-label rect {
-  fill-opacity: 0;
-  stroke-opacity: 0;
-}
-
-/**********
-* Lines
-*/
-
-.nvd3 .nv-groups path.nv-line {
-  fill: none;
-  stroke-width: 1.5px;
-  /*
-  stroke-linecap: round;
-  shape-rendering: geometricPrecision;
-
-  transition: stroke-width 250ms linear;
-  -moz-transition: stroke-width 250ms linear;
-  -webkit-transition: stroke-width 250ms linear;
-
-  transition-delay: 250ms
-  -moz-transition-delay: 250ms;
-  -webkit-transition-delay: 250ms;
-  */
-}
-
-.nvd3 .nv-groups path.nv-line.nv-thin-line {
-  stroke-width: 1px;
-}
-
-
-.nvd3 .nv-groups path.nv-area {
-  stroke: none;
-  /*
-  stroke-linecap: round;
-  shape-rendering: geometricPrecision;
-
-  stroke-width: 2.5px;
-  transition: stroke-width 250ms linear;
-  -moz-transition: stroke-width 250ms linear;
-  -webkit-transition: stroke-width 250ms linear;
-
-  transition-delay: 250ms
-  -moz-transition-delay: 250ms;
-  -webkit-transition-delay: 250ms;
-  */
-}
-
-.nvd3 .nv-line.hover path {
-  stroke-width: 6px;
-}
-
-/*
-.nvd3.scatter .groups .point {
-  fill-opacity: 0.1;
-  stroke-opacity: 0.1;
-}
-  */
-
-.nvd3.nv-line .nvd3.nv-scatter .nv-groups .nv-point {
-  fill-opacity: 0;
-  stroke-opacity: 0;
-}
-
-.nvd3.nv-scatter.nv-single-point .nv-groups .nv-point {
-  fill-opacity: .5 !important;
-  stroke-opacity: .5 !important;
-}
-
-
-.with-transitions .nvd3 .nv-groups .nv-point {
-  transition: stroke-width 250ms linear, stroke-opacity 250ms linear;
-  -moz-transition: stroke-width 250ms linear, stroke-opacity 250ms linear;
-  -webkit-transition: stroke-width 250ms linear, stroke-opacity 250ms linear;
-
-}
-
-.nvd3.nv-scatter .nv-groups .nv-point.hover,
-.nvd3 .nv-groups .nv-point.hover {
-  stroke-width: 7px;
-  fill-opacity: .95 !important;
-  stroke-opacity: .95 !important;
-}
-
-
-.nvd3 .nv-point-paths path {
-  stroke: #aaa;
-  stroke-opacity: 0;
-  fill: #eee;
-  fill-opacity: 0;
-}
-
-
-
-.nvd3 .nv-indexLine {
-  cursor: ew-resize;
-}
-
-
-/**********
-* Distribution
-*/
-
-.nvd3 .nv-distribution {
-  pointer-events: none;
-}
-
-
-
-/**********
-*  Scatter
-*/
-
-/* **Attempting to remove this for useVoronoi(false), need to see if it's required anywhere
-.nvd3 .nv-groups .nv-point {
-  pointer-events: none;
-}
-*/
-
-.nvd3 .nv-groups .nv-point.hover {
-  stroke-width: 20px;
-  stroke-opacity: .5;
-}
-
-.nvd3 .nv-scatter .nv-point.hover {
-  fill-opacity: 1;
-}
-
-/*
-.nv-group.hover .nv-point {
-  fill-opacity: 1;
-}
-*/
-
-
-/**********
-*  Stacked Area
-*/
-
-.nvd3.nv-stackedarea path.nv-area {
-  fill-opacity: .7;
-  /*
-  stroke-opacity: .65;
-  fill-opacity: 1;
-  */
-  stroke-opacity: 0;
-
-  transition: fill-opacity 250ms linear, stroke-opacity 250ms linear;
-  -moz-transition: fill-opacity 250ms linear, stroke-opacity 250ms linear;
-  -webkit-transition: fill-opacity 250ms linear, stroke-opacity 250ms linear;
-
-  /*
-  transition-delay: 500ms;
-  -moz-transition-delay: 500ms;
-  -webkit-transition-delay: 500ms;
-  */
-
-}
-
-.nvd3.nv-stackedarea path.nv-area.hover {
-  fill-opacity: .9;
-  /*
-  stroke-opacity: .85;
-  */
-}
-/*
-.d3stackedarea .groups path {
-  stroke-opacity: 0;
-}
-  */
-
-
-
-.nvd3.nv-stackedarea .nv-groups .nv-point {
-  stroke-opacity: 0;
-  fill-opacity: 0;
-}
-
-/*
-.nvd3.nv-stackedarea .nv-groups .nv-point.hover {
-  stroke-width: 20px;
-  stroke-opacity: .75;
-  fill-opacity: 1;
-}*/
-
-
-
-/**********
-*  Line Plus Bar
-*/
-
-.nvd3.nv-linePlusBar .nv-bar rect {
-  fill-opacity: .75;
-}
-
-.nvd3.nv-linePlusBar .nv-bar rect:hover {
-  fill-opacity: 1;
-}
-
-
-/**********
-*  Bullet
-*/
-
-.nvd3.nv-bullet { font: 10px sans-serif; }
-.nvd3.nv-bullet .nv-measure { fill-opacity: .8; }
-.nvd3.nv-bullet .nv-measure:hover { fill-opacity: 1; }
-.nvd3.nv-bullet .nv-marker { stroke: #000; stroke-width: 2px; }
-.nvd3.nv-bullet .nv-markerTriangle { stroke: #000; fill: #fff; stroke-width: 1.5px; }
-.nvd3.nv-bullet .nv-tick line { stroke: #666; stroke-width: .5px; }
-.nvd3.nv-bullet .nv-range.nv-s0 { fill: #eee; }
-.nvd3.nv-bullet .nv-range.nv-s1 { fill: #ddd; }
-.nvd3.nv-bullet .nv-range.nv-s2 { fill: #ccc; }
-.nvd3.nv-bullet .nv-title { font-size: 14px; font-weight: bold; }
-.nvd3.nv-bullet .nv-subtitle { fill: #999; }
-
-
-.nvd3.nv-bullet .nv-range {
-  fill: #bababa;
-  fill-opacity: .4;
-}
-.nvd3.nv-bullet .nv-range:hover {
-  fill-opacity: .7;
-}
-
-
-
-/**********
-* Sparkline
-*/
-
-.nvd3.nv-sparkline path {
-  fill: none;
-}
-
-.nvd3.nv-sparklineplus g.nv-hoverValue {
-  pointer-events: none;
-}
-
-.nvd3.nv-sparklineplus .nv-hoverValue line {
-  stroke: #333;
-  stroke-width: 1.5px;
- }
-
-.nvd3.nv-sparklineplus,
-.nvd3.nv-sparklineplus g {
-  pointer-events: all;
-}
-
-.nvd3 .nv-hoverArea {
-  fill-opacity: 0;
-  stroke-opacity: 0;
-}
-
-.nvd3.nv-sparklineplus .nv-xValue,
-.nvd3.nv-sparklineplus .nv-yValue {
-  /*
-  stroke: #666;
-  */
-  stroke-width: 0;
-  font-size: .9em;
-  font-weight: normal;
-}
-
-.nvd3.nv-sparklineplus .nv-yValue {
-  stroke: #f66;
-}
-
-.nvd3.nv-sparklineplus .nv-maxValue {
-  stroke: #2ca02c;
-  fill: #2ca02c;
-}
-
-.nvd3.nv-sparklineplus .nv-minValue {
-  stroke: #d62728;
-  fill: #d62728;
-}
-
-.nvd3.nv-sparklineplus .nv-currentValue {
-  /*
-  stroke: #444;
-  fill: #000;
-  */
-  font-weight: bold;
-  font-size: 1.1em;
-}
-
-/**********
-* historical stock
-*/
-
-.nvd3.nv-ohlcBar .nv-ticks .nv-tick {
-  stroke-width: 2px;
-}
-
-.nvd3.nv-ohlcBar .nv-ticks .nv-tick.hover {
-  stroke-width: 4px;
-}
-
-.nvd3.nv-ohlcBar .nv-ticks .nv-tick.positive {
- stroke: #2ca02c;
-}
-
-.nvd3.nv-ohlcBar .nv-ticks .nv-tick.negative {
- stroke: #d62728;
-}
-
-.nvd3.nv-historicalStockChart .nv-axis .nv-axislabel {
-  font-weight: bold;
-}
-
-.nvd3.nv-historicalStockChart .nv-dragTarget {
-  fill-opacity: 0;
-  stroke: none;
-  cursor: move;
-}
-
-.nvd3 .nv-brush .extent {
-  /*
-  cursor: ew-resize !important;
-  */
-  fill-opacity: 0 !important;
-}
-
-.nvd3 .nv-brushBackground rect {
-  stroke: #000;
-  stroke-width: .4;
-  fill: #fff;
-  fill-opacity: .7;
-}
-
-
-
-/**********
-* Indented Tree
-*/
-
-
-/**
- * TODO: the following 3 selectors are based on classes used in the example.  I should either make them standard and leave them here, or move to a CSS file not included in the library
- */
-.nvd3.nv-indentedtree .name {
-  margin-left: 5px;
-}
-
-.nvd3.nv-indentedtree .clickable {
-  color: #08C;
-  cursor: pointer;
-}
-
-.nvd3.nv-indentedtree span.clickable:hover {
-  color: #005580;
-  text-decoration: underline;
-}
-
-
-.nvd3.nv-indentedtree .nv-childrenCount {
-  display: inline-block;
-  margin-left: 5px;
-}
-
-.nvd3.nv-indentedtree .nv-treeicon {
-  cursor: pointer;
-  /*
-  cursor: n-resize;
-  */
-}
-
-.nvd3.nv-indentedtree .nv-treeicon.nv-folded {
-  cursor: pointer;
-  /*
-  cursor: s-resize;
-  */
-}
-
-/**********
-* Parallel Coordinates
-*/
-
-.nvd3 .background path {
-  fill: none;
-  stroke: #ccc;
-  stroke-opacity: .4;
-  shape-rendering: crispEdges;
-}
-
-.nvd3 .foreground path {
-  fill: none;
-  stroke: steelblue;
-  stroke-opacity: .7;
-}
-
-.nvd3 .brush .extent {
-  fill-opacity: .3;
-  stroke: #fff;
-  shape-rendering: crispEdges;
-}
-
-.nvd3 .axis line, .axis path {
-  fill: none;
-  stroke: #000;
-  shape-rendering: crispEdges;
-}
-
-.nvd3 .axis text {
-  text-shadow: 0 1px 0 #fff;
-}
-
-/****
-Interactive Layer
-*/
-.nvd3 .nv-interactiveGuideLine {
-  pointer-events:none;
-}
-.nvd3 line.nv-guideline {
-  stroke: #ccc;
-}
\ No newline at end of file
diff --git a/airflow/www_rbac/static/nv.d3.js b/airflow/www_rbac/static/nv.d3.js
deleted file mode 100644
index faa9a00ad1b0f..0000000000000
--- a/airflow/www_rbac/static/nv.d3.js
+++ /dev/null
@@ -1,14260 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-(function(){
-
-var nv = window.nv || {};
-
-
-nv.version = '1.1.11b';
-nv.dev = true //set false when in production
-
-window.nv = nv;
-
-nv.tooltip = {}; // For the tooltip system
-nv.utils = {}; // Utility subsystem
-nv.models = {}; //stores all the possible models/components
-nv.charts = {}; //stores all the ready to use charts
-nv.graphs = []; //stores all the graphs currently on the page
-nv.logs = {}; //stores some statistics and potential error messages
-
-nv.dispatch = d3.dispatch('render_start', 'render_end');
-
-// *************************************************************************
-//  Development render timers - disabled if dev = false
-
-if (nv.dev) {
-  nv.dispatch.on('render_start', function(e) {
-    nv.logs.startTime = +new Date();
-  });
-
-  nv.dispatch.on('render_end', function(e) {
-    nv.logs.endTime = +new Date();
-    nv.logs.totalTime = nv.logs.endTime - nv.logs.startTime;
-    nv.log('total', nv.logs.totalTime); // used for development, to keep track of graph generation times
-  });
-}
-
-// ********************************************
-//  Public Core NV functions
-
-// Logs all arguments, and returns the last so you can test things in place
-// Note: in IE8 console.log is an object not a function, and if modernizr is used
-// then calling Function.prototype.bind with with anything other than a function
-// causes a TypeError to be thrown.
-nv.log = function() {
-  if (nv.dev && console.log && console.log.apply)
-    console.log.apply(console, arguments)
-  else if (nv.dev && typeof console.log == "function" && Function.prototype.bind) {
-    var log = Function.prototype.bind.call(console.log, console);
-    log.apply(console, arguments);
-  }
-  return arguments[arguments.length - 1];
-};
-
-
-nv.render = function render(step) {
-  step = step || 1; // number of graphs to generate in each timeout loop
-
-  nv.render.active = true;
-  nv.dispatch.render_start();
-
-  setTimeout(function() {
-    var chart, graph;
-
-    for (var i = 0; i < step && (graph = nv.render.queue[i]); i++) {
-      chart = graph.generate();
-      if (typeof graph.callback == typeof(Function)) graph.callback(chart);
-      nv.graphs.push(chart);
-    }
-
-    nv.render.queue.splice(0, i);
-
-    if (nv.render.queue.length) setTimeout(arguments.callee, 0);
-    else { nv.render.active = false; nv.dispatch.render_end(); }
-  }, 0);
-};
-
-nv.render.active = false;
-nv.render.queue = [];
-
-nv.addGraph = function(obj) {
-  if (typeof arguments[0] === typeof(Function))
-    obj = {generate: arguments[0], callback: arguments[1]};
-
-  nv.render.queue.push(obj);
-
-  if (!nv.render.active) nv.render();
-};
-
-nv.identity = function(d) { return d; };
-
-nv.strip = function(s) { return s.replace(/(\s|&)/g,''); };
-
-function daysInMonth(month,year) {
-  return (new Date(year, month+1, 0)).getDate();
-}
-
-function d3_time_range(floor, step, number) {
-  return function(t0, t1, dt) {
-    var time = floor(t0), times = [];
-    if (time < t0) step(time);
-    if (dt > 1) {
-      while (time < t1) {
-        var date = new Date(+time);
-        if ((number(date) % dt === 0)) times.push(date);
-        step(time);
-      }
-    } else {
-      while (time < t1) { times.push(new Date(+time)); step(time); }
-    }
-    return times;
-  };
-}
-
-d3.time.monthEnd = function(date) {
-  return new Date(date.getFullYear(), date.getMonth(), 0);
-};
-
-d3.time.monthEnds = d3_time_range(d3.time.monthEnd, function(date) {
-    date.setUTCDate(date.getUTCDate() + 1);
-    date.setDate(daysInMonth(date.getMonth() + 1, date.getFullYear()));
-  }, function(date) {
-    return date.getMonth();
-  }
-);
-
-/* Utility class to handle creation of an interactive layer.
-This places a rectangle on top of the chart. When you mouse move over it, it sends a dispatch
-containing the X-coordinate. It can also render a vertical line where the mouse is located.
-
-dispatch.elementMousemove is the important event to latch onto.  It is fired whenever the mouse moves over
-the rectangle. The dispatch is given one object which contains the mouseX/Y location.
-It also has 'pointXValue', which is the conversion of mouseX to the x-axis scale.
-*/
-nv.interactiveGuideline = function() {
-	"use strict";
-	var tooltip = nv.models.tooltip();
-	//Public settings
-	var width = null
-	, height = null
-    //Please pass in the bounding chart's top and left margins
-    //This is important for calculating the correct mouseX/Y positions.
-	, margin = {left: 0, top: 0}
-	, xScale = d3.scale.linear()
-	, yScale = d3.scale.linear()
-	, dispatch = d3.dispatch('elementMousemove', 'elementMouseout','elementDblclick')
-	, showGuideLine = true
-	, svgContainer = null  
-    //Must pass in the bounding chart's <svg> container.
-    //The mousemove event is attached to this container.
-	;
-
-	//Private variables
-	var isMSIE = navigator.userAgent.indexOf("MSIE") !== -1  //Check user-agent for Microsoft Internet Explorer.
-	;
-
-
-	function layer(selection) {
-		selection.each(function(data) {
-				var container = d3.select(this);
-				
-				var availableWidth = (width || 960), availableHeight = (height || 400);
-
-				var wrap = container.selectAll("g.nv-wrap.nv-interactiveLineLayer").data([data]);
-				var wrapEnter = wrap.enter()
-								.append("g").attr("class", " nv-wrap nv-interactiveLineLayer");
-								
-				
-				wrapEnter.append("g").attr("class","nv-interactiveGuideLine");
-				
-				if (!svgContainer) {
-					return;
-				}
-
-                function mouseHandler() {
-                      var d3mouse = d3.mouse(this);
-                      var mouseX = d3mouse[0];
-                      var mouseY = d3mouse[1];
-                      var subtractMargin = true;
-                      var mouseOutAnyReason = false;
-                      if (isMSIE) {
-                         /*
-                            D3.js (or maybe SVG.getScreenCTM) has a nasty bug in Internet Explorer 10.
-                            d3.mouse() returns incorrect X,Y mouse coordinates when mouse moving
-                            over a rect in IE 10.
-                            However, d3.event.offsetX/Y also returns the mouse coordinates
-                            relative to the triggering <rect>. So we use offsetX/Y on IE.  
-                         */
-                         mouseX = d3.event.offsetX;
-                         mouseY = d3.event.offsetY;
-
-                         /*
-                            On IE, if you attach a mouse event listener to the <svg> container,
-                            it will actually trigger it for all the child elements (like <path>, <circle>, etc).
-                            When this happens on IE, the offsetX/Y is set to where ever the child element
-                            is located.
-                            As a result, we do NOT need to subtract margins to figure out the mouse X/Y
-                            position under this scenario. Removing the line below *will* cause 
-                            the interactive layer to not work right on IE.
-                         */
-                         if(d3.event.target.tagName !== "svg")
-                            subtractMargin = false;
-
-                         if (d3.event.target.className.baseVal.match("nv-legend"))
-                         	mouseOutAnyReason = true;
-                          
-                      }
-
-                      if(subtractMargin) {
-                         mouseX -= margin.left;
-                         mouseY -= margin.top;
-                      }
-
-                      /* If mouseX/Y is outside of the chart's bounds,
-                      trigger a mouseOut event.
-                      */
-                      if (mouseX < 0 || mouseY < 0 
-                        || mouseX > availableWidth || mouseY > availableHeight
-                        || (d3.event.relatedTarget && d3.event.relatedTarget.ownerSVGElement === undefined)
-                        || mouseOutAnyReason
-                        ) 
-                      {
-                      		if (isMSIE) {
-                      			if (d3.event.relatedTarget 
-                      				&& d3.event.relatedTarget.ownerSVGElement === undefined
-                      				&& d3.event.relatedTarget.className.match(tooltip.nvPointerEventsClass)) {
-                      				return;
-                      			}
-                      		}
-                            dispatch.elementMouseout({
-                               mouseX: mouseX,
-                               mouseY: mouseY
-                            });
-                            layer.renderGuideLine(null); //hide the guideline
-                            return;
-                      }
-                      
-                      var pointXValue = xScale.invert(mouseX);
-                      dispatch.elementMousemove({
-                            mouseX: mouseX,
-                            mouseY: mouseY,
-                            pointXValue: pointXValue
-                      });
-
-                      //If user double clicks the layer, fire a elementDblclick dispatch.
-                      if (d3.event.type === "dblclick") {
-                        dispatch.elementDblclick({
-                            mouseX: mouseX,
-                            mouseY: mouseY,
-                            pointXValue: pointXValue
-                        });
-                      }
-                }
-
-				svgContainer
-				      .on("mousemove",mouseHandler, true)
-				      .on("mouseout" ,mouseHandler,true)
-                      .on("dblclick" ,mouseHandler)
-				      ;
-
-				 //Draws a vertical guideline at the given X postion.
-				layer.renderGuideLine = function(x) {
-				 	if (!showGuideLine) return;
-				 	var line = wrap.select(".nv-interactiveGuideLine")
-				 	      .selectAll("line")
-				 	      .data((x != null) ? [nv.utils.NaNtoZero(x)] : [], String);
-
-				 	line.enter()
-				 		.append("line")
-				 		.attr("class", "nv-guideline")
-				 		.attr("x1", function(d) { return d;})
-				 		.attr("x2", function(d) { return d;})
-				 		.attr("y1", availableHeight)
-				 		.attr("y2",0)
-				 		;
-				 	line.exit().remove();
-
-				}
-		});
-	}
-
-	layer.dispatch = dispatch;
-	layer.tooltip = tooltip;
-
-	layer.margin = function(_) {
-	    if (!arguments.length) return margin;
-	    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-	    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-	    return layer;
-    };
-
-	layer.width = function(_) {
-		if (!arguments.length) return width;
-		width = _;
-		return layer;
-	};
-
-	layer.height = function(_) {
-		if (!arguments.length) return height;
-		height = _;
-		return layer;
-	};
-
-	layer.xScale = function(_) {
-		if (!arguments.length) return xScale;
-		xScale = _;
-		return layer;
-	};
-
-	layer.showGuideLine = function(_) {
-		if (!arguments.length) return showGuideLine;
-		showGuideLine = _;
-		return layer;
-	};
-
-	layer.svgContainer = function(_) {
-		if (!arguments.length) return svgContainer;
-		svgContainer = _;
-		return layer;
-	};
-
-
-	return layer;
-};
-
-/* Utility class that uses d3.bisect to find the index in a given array, where a search value can be inserted.
-This is different from normal bisectLeft; this function finds the nearest index to insert the search value.
-
-For instance, lets say your array is [1,2,3,5,10,30], and you search for 28. 
-Normal d3.bisectLeft will return 4, because 28 is inserted after the number 10.  But interactiveBisect will return 5
-because 28 is closer to 30 than 10.
-
-Unit tests can be found in: interactiveBisectTest.html
-
-Has the following known issues:
-   * Will not work if the data points move backwards (ie, 10,9,8,7, etc) or if the data points are in random order.
-   * Won't work if there are duplicate x coordinate values.
-*/
-nv.interactiveBisect = function (values, searchVal, xAccessor) {
-	  "use strict";
-      if (! values instanceof Array) return null;
-      if (typeof xAccessor !== 'function') xAccessor = function(d,i) { return d.x;}
-
-      var bisect = d3.bisector(xAccessor).left;
-      var index = d3.max([0, bisect(values,searchVal) - 1]);
-      var currentValue = xAccessor(values[index], index);
-      if (typeof currentValue === 'undefined') currentValue = index;
-
-      if (currentValue === searchVal) return index;  //found exact match
-
-      var nextIndex = d3.min([index+1, values.length - 1]);
-      var nextValue = xAccessor(values[nextIndex], nextIndex);
-      if (typeof nextValue === 'undefined') nextValue = nextIndex;
-
-      if (Math.abs(nextValue - searchVal) >= Math.abs(currentValue - searchVal))
-          return index;
-      else
-          return nextIndex
-};/* Tooltip rendering model for nvd3 charts.
-window.nv.models.tooltip is the updated,new way to render tooltips.
-
-window.nv.tooltip.show is the old tooltip code.
-window.nv.tooltip.* also has various helper methods.
-*/
-(function() {
-  "use strict";
-  window.nv.tooltip = {};
-
-  /* Model which can be instantiated to handle tooltip rendering.
-    Example usage: 
-    var tip = nv.models.tooltip().gravity('w').distance(23)
-                .data(myDataObject);
-
-        tip();    //just invoke the returned function to render tooltip.
-  */
-  window.nv.models.tooltip = function() {
-        var content = null    //HTML contents of the tooltip.  If null, the content is generated via the data variable.
-        ,   data = null     /* Tooltip data. If data is given in the proper format, a consistent tooltip is generated.
-        Format of data:
-        {
-            key: "Date",
-            value: "August 2009", 
-            series: [
-                    {
-                        key: "Series 1",
-                        value: "Value 1",
-                        color: "#000"
-                    },
-                    {
-                        key: "Series 2",
-                        value: "Value 2",
-                        color: "#00f"
-                    }
-            ]
-
-        }
-
-        */
-        ,   gravity = 'w'   //Can be 'n','s','e','w'. Determines how tooltip is positioned.
-        ,   distance = 50   //Distance to offset tooltip from the mouse location.
-        ,   snapDistance = 25   //Tolerance allowed before tooltip is moved from its current position (creates 'snapping' effect)
-        ,   fixedTop = null //If not null, this fixes the top position of the tooltip.
-        ,   classes = null  //Attaches additional CSS classes to the tooltip DIV that is created.
-        ,   chartContainer = null   //Parent DIV, of the SVG Container that holds the chart.
-        ,   tooltipElem = null  //actual DOM element representing the tooltip.
-        ,   position = {left: null, top: null}      //Relative position of the tooltip inside chartContainer.
-        ,   enabled = true  //True -> tooltips are rendered. False -> don't render tooltips.
-        //Generates a unique id when you create a new tooltip() object
-        ,   id = "nvtooltip-" + Math.floor(Math.random() * 100000)
-        ;
-
-        //CSS class to specify whether element should not have mouse events.
-        var  nvPointerEventsClass = "nv-pointer-events-none";
-
-        //Format function for the tooltip values column
-        var valueFormatter = function(d,i) {
-            return d;
-        };
-
-        //Format function for the tooltip header value.
-        var headerFormatter = function(d) {
-            return d;
-        };
-
-        //By default, the tooltip model renders a beautiful table inside a DIV.
-        //You can override this function if a custom tooltip is desired.
-        var contentGenerator = function(d) {
-            if (content != null) return content;
-
-            if (d == null) return '';
-
-            var table = d3.select(document.createElement("table"));
-            var theadEnter = table.selectAll("thead")
-                .data([d])
-                .enter().append("thead");
-            theadEnter.append("tr")
-                .append("td")
-                .attr("colspan",3)
-                .append("strong")
-                    .classed("x-value",true)
-                    .text(headerFormatter(d.value));
-
-            var tbodyEnter = table.selectAll("tbody")
-                .data([d])
-                .enter().append("tbody");
-            var trowEnter = tbodyEnter.selectAll("tr")
-                .data(function(p) { return p.series})
-                .enter()
-                .append("tr")
-                .classed("highlight", function(p) { return p.highlight})
-                ;
-
-            trowEnter.append("td")
-                .classed("legend-color-guide",true)
-                .append("div")
-                    .style("background-color", function(p) { return p.color});
-            trowEnter.append("td")
-                .classed("key",true)
-                .text(function(p) {return p.key});
-            trowEnter.append("td")
-                .classed("value",true)
-                .text(function(p,i) { return valueFormatter(p.value,i) });
-
-            trowEnter.selectAll("td").each(function(p) {
-                if (p.highlight)
-                    d3.select(this)
-                        .style("border-bottom","solid 1px " + p.color)
-                        .style("border-top","solid 1px " + p.color)
-                        ;
-            });
-
-            var html = table.node().outerHTML;
-            if (d.footer !== undefined)
-                html += "<div class='footer'>" + d.footer + "</div>";
-            return html;
-
-        };
-
-        var dataSeriesExists = function(d) {
-            if (d && d.series && d.series.length > 0) return true;
-
-            return false;
-        };
-
-        //In situations where the chart is in a 'viewBox', re-position the tooltip based on how far chart is zoomed.
-        function convertViewBoxRatio() {
-            if (chartContainer) {
-              var svg = d3.select(chartContainer);
-              if (svg.node().tagName !== "svg") {
-                 svg = svg.select("svg");
-              }
-              var viewBox = (svg.node()) ? svg.attr('viewBox') : null;
-              if (viewBox) {
-                viewBox = viewBox.split(' ');
-                var ratio = parseInt(svg.style('width')) / viewBox[2];
-                
-                position.left = position.left * ratio;
-                position.top  = position.top * ratio;
-              }
-            }
-        }
-
-        //Creates new tooltip container, or uses existing one on DOM.
-        function getTooltipContainer(newContent) {
-            var body;
-            if (chartContainer)
-                body = d3.select(chartContainer);
-            else
-                body = d3.select("body");
-
-            var container = body.select(".nvtooltip");
-            if (container.node() === null) {
-                //Create new tooltip div if it doesn't exist on DOM.
-                container = body.append("div")
-                    .attr("class", "nvtooltip " + (classes? classes: "xy-tooltip"))
-                    .attr("id",id)
-                    ;
-            }
-        
-
-            container.node().innerHTML = newContent;
-            container.style("top",0).style("left",0).style("opacity",0);
-            container.selectAll("div, table, td, tr").classed(nvPointerEventsClass,true)
-            container.classed(nvPointerEventsClass,true);
-            return container.node();
-        }
-
-        
-
-        //Draw the tooltip onto the DOM.
-        function nvtooltip() {
-            if (!enabled) return;
-            if (!dataSeriesExists(data)) return;
-
-            convertViewBoxRatio();
-
-            var left = position.left;
-            var top = (fixedTop != null) ? fixedTop : position.top;
-            var container = getTooltipContainer(contentGenerator(data));
-            tooltipElem = container;
-            if (chartContainer) {
-                var svgComp = chartContainer.getElementsByTagName("svg")[0];
-                var boundRect = (svgComp) ? svgComp.getBoundingClientRect() : chartContainer.getBoundingClientRect();
-                var svgOffset = {left:0,top:0};
-                if (svgComp) {
-                    var svgBound = svgComp.getBoundingClientRect();
-                    var chartBound = chartContainer.getBoundingClientRect();
-                    var svgBoundTop = svgBound.top;
-                    
-                    //Defensive code. Sometimes, svgBoundTop can be a really negative
-                    //  number, like -134254. That's a bug. 
-                    //  If such a number is found, use zero instead. FireFox bug only
-                    if (svgBoundTop < 0) {
-                        var containerBound = chartContainer.getBoundingClientRect();
-                        svgBoundTop = (Math.abs(svgBoundTop) > containerBound.height) ? 0 : svgBoundTop;
-                    } 
-                    svgOffset.top = Math.abs(svgBoundTop - chartBound.top);
-                    svgOffset.left = Math.abs(svgBound.left - chartBound.left);
-                }
-                //If the parent container is an overflow <div> with scrollbars, subtract the scroll offsets.
-                //You need to also add any offset between the <svg> element and its containing <div>
-                //Finally, add any offset of the containing <div> on the whole page.
-                left += chartContainer.offsetLeft + svgOffset.left - 2*chartContainer.scrollLeft;
-                top += chartContainer.offsetTop + svgOffset.top - 2*chartContainer.scrollTop;
-            }
-
-            if (snapDistance && snapDistance > 0) {
-                top = Math.floor(top/snapDistance) * snapDistance;
-            }
-
-            nv.tooltip.calcTooltipPosition([left,top], gravity, distance, container);
-            return nvtooltip;
-        };
-
-        nvtooltip.nvPointerEventsClass = nvPointerEventsClass;
-        
-        nvtooltip.content = function(_) {
-            if (!arguments.length) return content;
-            content = _;
-            return nvtooltip;
-        };
-
-        //Returns tooltipElem...not able to set it.
-        nvtooltip.tooltipElem = function() {
-            return tooltipElem;
-        };
-
-        nvtooltip.contentGenerator = function(_) {
-            if (!arguments.length) return contentGenerator;
-            if (typeof _ === 'function') {
-                contentGenerator = _;
-            }
-            return nvtooltip;
-        };
-
-        nvtooltip.data = function(_) {
-            if (!arguments.length) return data;
-            data = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.gravity = function(_) {
-            if (!arguments.length) return gravity;
-            gravity = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.distance = function(_) {
-            if (!arguments.length) return distance;
-            distance = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.snapDistance = function(_) {
-            if (!arguments.length) return snapDistance;
-            snapDistance = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.classes = function(_) {
-            if (!arguments.length) return classes;
-            classes = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.chartContainer = function(_) {
-            if (!arguments.length) return chartContainer;
-            chartContainer = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.position = function(_) {
-            if (!arguments.length) return position;
-            position.left = (typeof _.left !== 'undefined') ? _.left : position.left;
-            position.top = (typeof _.top !== 'undefined') ? _.top : position.top;
-            return nvtooltip;
-        };
-
-        nvtooltip.fixedTop = function(_) {
-            if (!arguments.length) return fixedTop;
-            fixedTop = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.enabled = function(_) {
-            if (!arguments.length) return enabled;
-            enabled = _;
-            return nvtooltip;
-        };
-
-        nvtooltip.valueFormatter = function(_) {
-            if (!arguments.length) return valueFormatter;
-            if (typeof _ === 'function') {
-                valueFormatter = _;
-            }
-            return nvtooltip;
-        };
-
-        nvtooltip.headerFormatter = function(_) {
-            if (!arguments.length) return headerFormatter;
-            if (typeof _ === 'function') {
-                headerFormatter = _;
-            }
-            return nvtooltip;
-        };
-
-        //id() is a read-only function. You can't use it to set the id.
-        nvtooltip.id = function() {
-            return id;
-        };
-
-
-        return nvtooltip;
-  };
-
-
-  //Original tooltip.show function. Kept for backward compatibility.
-  // pos = [left,top]
-  nv.tooltip.show = function(pos, content, gravity, dist, parentContainer, classes) {
-      
-        //Create new tooltip div if it doesn't exist on DOM.
-        var   container = document.createElement('div');
-        container.className = 'nvtooltip ' + (classes ? classes : 'xy-tooltip');
-
-        var body = parentContainer;
-        if ( !parentContainer || parentContainer.tagName.match(/g|svg/i)) {
-            //If the parent element is an SVG element, place tooltip in the <body> element.
-            body = document.getElementsByTagName('body')[0];
-        }
-   
-        container.style.left = 0;
-        container.style.top = 0;
-        container.style.opacity = 0;
-        container.innerHTML = content;
-        body.appendChild(container);
-        
-        //If the parent container is an overflow <div> with scrollbars, subtract the scroll offsets.
-        if (parentContainer) {
-           pos[0] = pos[0] - parentContainer.scrollLeft;
-           pos[1] = pos[1] - parentContainer.scrollTop;
-        }
-        nv.tooltip.calcTooltipPosition(pos, gravity, dist, container);
-  };
-
-  //Looks up the ancestry of a DOM element, and returns the first NON-svg node.
-  nv.tooltip.findFirstNonSVGParent = function(Elem) {
-            while(Elem.tagName.match(/^g|svg$/i) !== null) {
-                Elem = Elem.parentNode;
-            }
-            return Elem;
-  };
-
-  //Finds the total offsetTop of a given DOM element.
-  //Looks up the entire ancestry of an element, up to the first relatively positioned element.
-  nv.tooltip.findTotalOffsetTop = function ( Elem, initialTop ) {
-                var offsetTop = initialTop;
-                
-                do {
-                    if( !isNaN( Elem.offsetTop ) ) {
-                        offsetTop += (Elem.offsetTop);
-                    }
-                } while( Elem = Elem.offsetParent );
-                return offsetTop;
-  };
-
-  //Finds the total offsetLeft of a given DOM element.
-  //Looks up the entire ancestry of an element, up to the first relatively positioned element.
-  nv.tooltip.findTotalOffsetLeft = function ( Elem, initialLeft) {
-                var offsetLeft = initialLeft;
-                
-                do {
-                    if( !isNaN( Elem.offsetLeft ) ) {
-                        offsetLeft += (Elem.offsetLeft);
-                    }
-                } while( Elem = Elem.offsetParent );
-                return offsetLeft;
-  };
-
-  //Global utility function to render a tooltip on the DOM.
-  //pos = [left,top] coordinates of where to place the tooltip, relative to the SVG chart container.
-  //gravity = how to orient the tooltip
-  //dist = how far away from the mouse to place tooltip
-  //container = tooltip DIV
-  nv.tooltip.calcTooltipPosition = function(pos, gravity, dist, container) {
-
-            var height = parseInt(container.offsetHeight),
-                width = parseInt(container.offsetWidth),
-                windowWidth = nv.utils.windowSize().width,
-                windowHeight = nv.utils.windowSize().height,
-                scrollTop = window.pageYOffset,
-                scrollLeft = window.pageXOffset,
-                left, top;
-
-            windowHeight = window.innerWidth >= document.body.scrollWidth ? windowHeight : windowHeight - 16;
-            windowWidth = window.innerHeight >= document.body.scrollHeight ? windowWidth : windowWidth - 16;
-
-            gravity = gravity || 's';
-            dist = dist || 20;
-
-            var tooltipTop = function ( Elem ) {
-                return nv.tooltip.findTotalOffsetTop(Elem, top);
-            };
-
-            var tooltipLeft = function ( Elem ) {
-                return nv.tooltip.findTotalOffsetLeft(Elem,left);
-            };
-
-            switch (gravity) {
-              case 'e':
-                left = pos[0] - width - dist;
-                top = pos[1] - (height / 2);
-                var tLeft = tooltipLeft(container);
-                var tTop = tooltipTop(container);
-                if (tLeft < scrollLeft) left = pos[0] + dist > scrollLeft ? pos[0] + dist : scrollLeft - tLeft + left;
-                if (tTop < scrollTop) top = scrollTop - tTop + top;
-                if (tTop + height > scrollTop + windowHeight) top = scrollTop + windowHeight - tTop + top - height;
-                break;
-              case 'w':
-                left = pos[0] + dist;
-                top = pos[1] - (height / 2);
-                var tLeft = tooltipLeft(container);
-                var tTop = tooltipTop(container);
-                if (tLeft + width > windowWidth) left = pos[0] - width - dist;
-                if (tTop < scrollTop) top = scrollTop + 5;
-                if (tTop + height > scrollTop + windowHeight) top = scrollTop + windowHeight - tTop + top - height;
-                break;
-              case 'n':
-                left = pos[0] - (width / 2) - 5;
-                top = pos[1] + dist;
-                var tLeft = tooltipLeft(container);
-                var tTop = tooltipTop(container);
-                if (tLeft < scrollLeft) left = scrollLeft + 5;
-                if (tLeft + width > windowWidth) left = left - width/2 + 5;
-                if (tTop + height > scrollTop + windowHeight) top = scrollTop + windowHeight - tTop + top - height;
-                break;
-              case 's':
-                left = pos[0] - (width / 2);
-                top = pos[1] - height - dist;
-                var tLeft = tooltipLeft(container);
-                var tTop = tooltipTop(container);
-                if (tLeft < scrollLeft) left = scrollLeft + 5;
-                if (tLeft + width > windowWidth) left = left - width/2 + 5;
-                if (scrollTop > tTop) top = scrollTop;
-                break;
-              case 'none':
-                left = pos[0];
-                top = pos[1] - dist;
-                var tLeft = tooltipLeft(container);
-                var tTop = tooltipTop(container);
-                break;
-            }
-
-
-            container.style.left = left+'px';
-            container.style.top = top+'px';
-            container.style.opacity = 1;
-            container.style.position = 'absolute'; 
-
-            return container;
-    };
-
-    //Global utility function to remove tooltips from the DOM.
-    nv.tooltip.cleanup = function() {
-
-              // Find the tooltips, mark them for removal by this class (so others cleanups won't find it)
-              var tooltips = document.getElementsByClassName('nvtooltip');
-              var purging = [];
-              while(tooltips.length) {
-                purging.push(tooltips[0]);
-                tooltips[0].style.transitionDelay = '0 !important';
-                tooltips[0].style.opacity = 0;
-                tooltips[0].className = 'nvtooltip-pending-removal';
-              }
-
-              setTimeout(function() {
-
-                  while (purging.length) {
-                     var removeMe = purging.pop();
-                      removeMe.parentNode.removeChild(removeMe);
-                  }
-            }, 500);
-    };
-
-})();
-
-nv.utils.windowSize = function() {
-    // Sane defaults
-    var size = {width: 640, height: 480};
-
-    // Earlier IE uses Doc.body
-    if (document.body && document.body.offsetWidth) {
-        size.width = document.body.offsetWidth;
-        size.height = document.body.offsetHeight;
-    }
-
-    // IE can use depending on mode it is in
-    if (document.compatMode=='CSS1Compat' &&
-        document.documentElement &&
-        document.documentElement.offsetWidth ) {
-        size.width = document.documentElement.offsetWidth;
-        size.height = document.documentElement.offsetHeight;
-    }
-
-    // Most recent browsers use
-    if (window.innerWidth && window.innerHeight) {
-        size.width = window.innerWidth;
-        size.height = window.innerHeight;
-    }
-    return (size);
-};
-
-
-
-// Easy way to bind multiple functions to window.onresize
-// TODO: give a way to remove a function after its bound, other than removing all of them
-nv.utils.windowResize = function(fun){
-  if (fun === undefined) return;
-  var oldresize = window.onresize;
-
-  window.onresize = function(e) {
-    if (typeof oldresize == 'function') oldresize(e);
-    fun(e);
-  }
-}
-
-// Backwards compatible way to implement more d3-like coloring of graphs.
-// If passed an array, wrap it in a function which implements the old default
-// behavior
-nv.utils.getColor = function(color) {
-    if (!arguments.length) return nv.utils.defaultColor(); //if you pass in nothing, get default colors back
-
-    if( Object.prototype.toString.call( color ) === '[object Array]' )
-        return function(d, i) { return d.color || color[i % color.length]; };
-    else
-        return color;
-        //can't really help it if someone passes rubbish as color
-}
-
-// Default color chooser uses the index of an object as before.
-nv.utils.defaultColor = function() {
-    var colors = d3.scale.category20().range();
-    return function(d, i) { return d.color || colors[i % colors.length] };
-}
-
-
-// Returns a color function that takes the result of 'getKey' for each series and
-// looks for a corresponding color from the dictionary,
-nv.utils.customTheme = function(dictionary, getKey, defaultColors) {
-  getKey = getKey || function(series) { return series.key }; // use default series.key if getKey is undefined
-  defaultColors = defaultColors || d3.scale.category20().range(); //default color function
-
-  var defIndex = defaultColors.length; //current default color (going in reverse)
-
-  return function(series, index) {
-    var key = getKey(series);
-
-    if (!defIndex) defIndex = defaultColors.length; //used all the default colors, start over
-
-    if (typeof dictionary[key] !== "undefined")
-      return (typeof dictionary[key] === "function") ? dictionary[key]() : dictionary[key];
-    else
-      return defaultColors[--defIndex]; // no match in dictionary, use default color
-  }
-}
-
-
-
-// From the PJAX example on d3js.org, while this is not really directly needed
-// it's a very cool method for doing pjax, I may expand upon it a little bit,
-// open to suggestions on anything that may be useful
-nv.utils.pjax = function(links, content) {
-  d3.selectAll(links).on("click", function() {
-    history.pushState(this.href, this.textContent, this.href);
-    load(this.href);
-    d3.event.preventDefault();
-  });
-
-  function load(href) {
-    d3.html(href, function(fragment) {
-      var target = d3.select(content).node();
-      target.parentNode.replaceChild(d3.select(fragment).select(content).node(), target);
-      nv.utils.pjax(links, content);
-    });
-  }
-
-  d3.select(window).on("popstate", function() {
-    if (d3.event.state) load(d3.event.state);
-  });
-}
-
-/* For situations where we want to approximate the width in pixels for an SVG:text element.
-Most common instance is when the element is in a display:none; container. 
-Forumla is : text.length * font-size * constant_factor
-*/
-nv.utils.calcApproxTextWidth = function (svgTextElem) {
-    if (svgTextElem instanceof d3.selection) {
-        var fontSize = parseInt(svgTextElem.style("font-size").replace("px",""));
-        var textLength = svgTextElem.text().length;
-
-        return textLength * fontSize * 0.5; 
-    }
-    return 0;
-};
-
-/* Numbers that are undefined, null or NaN, convert them to zeros.
-*/
-nv.utils.NaNtoZero = function(n) {
-    if (typeof n !== 'number' 
-        || isNaN(n) 
-        || n === null
-        || n === Infinity) return 0;
-
-    return n;
-};
-
-/*
-Snippet of code you can insert into each nv.models.* to give you the ability to
-do things like:
-chart.options({
-  showXAxis: true,
-  tooltips: true
-});
-
-To enable in the chart:
-chart.options = nv.utils.optionsFunc.bind(chart);
-*/
-nv.utils.optionsFunc = function(args) {
-    if (args) {
-      d3.map(args).forEach((function(key,value) {
-        if (typeof this[key] === "function") {
-           this[key](value);
-        }
-      }).bind(this));
-    }
-    return this;
-};nv.models.axis = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var axis = d3.svg.axis()
-    ;
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 75 //only used for tickLabel currently
-    , height = 60 //only used for tickLabel currently
-    , scale = d3.scale.linear()
-    , axisLabelText = null
-    , showMaxMin = true //TODO: showMaxMin should be disabled on all ordinal scaled axes
-    , highlightZero = true
-    , rotateLabels = 0
-    , rotateYLabel = true
-    , staggerLabels = false
-    , isOrdinal = false
-    , ticks = null
-    , axisLabelDistance = 12 //The larger this number is, the closer the axis label is to the axis.
-    ;
-
-  axis
-    .scale(scale)
-    .orient('bottom')
-    .tickFormat(function(d) { return d })
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var scale0;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-axis').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-axis');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g')
-
-      //------------------------------------------------------------
-
-
-      if (ticks !== null)
-        axis.ticks(ticks);
-      else if (axis.orient() == 'top' || axis.orient() == 'bottom')
-        axis.ticks(Math.abs(scale.range()[1] - scale.range()[0]) / 100);
-
-
-      //TODO: consider calculating width/height based on whether or not label is added, for reference in charts using this component
-
-
-      g.transition().call(axis);
-
-      scale0 = scale0 || axis.scale();
-
-      var fmt = axis.tickFormat();
-      if (fmt == null) {
-        fmt = scale0.tickFormat();
-      }
-
-      var axisLabel = g.selectAll('text.nv-axislabel')
-          .data([axisLabelText || null]);
-      axisLabel.exit().remove();
-      switch (axis.orient()) {
-        case 'top':
-          axisLabel.enter().append('text').attr('class', 'nv-axislabel');
-          var w = (scale.range().length==2) ? scale.range()[1] : (scale.range()[scale.range().length-1]+(scale.range()[1]-scale.range()[0]));
-          axisLabel
-              .attr('text-anchor', 'middle')
-              .attr('y', 0)
-              .attr('x', w/2);
-          if (showMaxMin) {
-            var axisMaxMin = wrap.selectAll('g.nv-axisMaxMin')
-                           .data(scale.domain());
-            axisMaxMin.enter().append('g').attr('class', 'nv-axisMaxMin').append('text');
-            axisMaxMin.exit().remove();
-            axisMaxMin
-                .attr('transform', function(d,i) {
-                  return 'translate(' + scale(d) + ',0)'
-                })
-              .select('text')
-                .attr('dy', '0em')
-                .attr('y', -axis.tickPadding())
-                .attr('text-anchor', 'middle')
-                .text(function(d,i) {
-                  var v = fmt(d);
-                  return ('' + v).match('NaN') ? '' : v;
-                });
-            axisMaxMin.transition()
-                .attr('transform', function(d,i) {
-                  return 'translate(' + scale.range()[i] + ',0)'
-                });
-          }
-          break;
-        case 'bottom':
-          var xLabelMargin = 36;
-          var maxTextWidth = 30;
-          var xTicks = g.selectAll('g').select("text");
-          if (rotateLabels%360) {
-            //Calculate the longest xTick width
-            xTicks.each(function(d,i){
-              var width = this.getBBox().width;
-              if(width > maxTextWidth) maxTextWidth = width;
-            });
-            //Convert to radians before calculating sin. Add 30 to margin for healthy padding.
-            var sin = Math.abs(Math.sin(rotateLabels*Math.PI/180));
-            var xLabelMargin = (sin ? sin*maxTextWidth : maxTextWidth)+30;
-            //Rotate all xTicks
-            xTicks
-              .attr('transform', function(d,i,j) { return 'rotate(' + rotateLabels + ' 0,0)' })
-              .style('text-anchor', rotateLabels%360 > 0 ? 'start' : 'end');
-          }
-          axisLabel.enter().append('text').attr('class', 'nv-axislabel');
-          var w = (scale.range().length==2) ? scale.range()[1] : (scale.range()[scale.range().length-1]+(scale.range()[1]-scale.range()[0]));
-          axisLabel
-              .attr('text-anchor', 'middle')
-              .attr('y', xLabelMargin)
-              .attr('x', w/2);
-          if (showMaxMin) {
-          //if (showMaxMin && !isOrdinal) {
-            var axisMaxMin = wrap.selectAll('g.nv-axisMaxMin')
-                           //.data(scale.domain())
-                           .data([scale.domain()[0], scale.domain()[scale.domain().length - 1]]);
-            axisMaxMin.enter().append('g').attr('class', 'nv-axisMaxMin').append('text');
-            axisMaxMin.exit().remove();
-            axisMaxMin
-                .attr('transform', function(d,i) {
-                  return 'translate(' + (scale(d) + (isOrdinal ? scale.rangeBand() / 2 : 0)) + ',0)'
-                })
-              .select('text')
-                .attr('dy', '.71em')
-                .attr('y', axis.tickPadding())
-                .attr('transform', function(d,i,j) { return 'rotate(' + rotateLabels + ' 0,0)' })
-                .style('text-anchor', rotateLabels ? (rotateLabels%360 > 0 ? 'start' : 'end') : 'middle')
-                .text(function(d,i) {
-                  var v = fmt(d);
-                  return ('' + v).match('NaN') ? '' : v;
-                });
-            axisMaxMin.transition()
-                .attr('transform', function(d,i) {
-                  //return 'translate(' + scale.range()[i] + ',0)'
-                  //return 'translate(' + scale(d) + ',0)'
-                  return 'translate(' + (scale(d) + (isOrdinal ? scale.rangeBand() / 2 : 0)) + ',0)'
-                });
-          }
-          if (staggerLabels)
-            xTicks
-                .attr('transform', function(d,i) { return 'translate(0,' + (i % 2 == 0 ? '0' : '12') + ')' });
-
-          break;
-        case 'right':
-          axisLabel.enter().append('text').attr('class', 'nv-axislabel');
-          axisLabel
-              .style('text-anchor', rotateYLabel ? 'middle' : 'begin')
-              .attr('transform', rotateYLabel ? 'rotate(90)' : '')
-              .attr('y', rotateYLabel ? (-Math.max(margin.right,width) + 12) : -10) //TODO: consider calculating this based on largest tick width... OR at least expose this on chart
-              .attr('x', rotateYLabel ? (scale.range()[0] / 2) : axis.tickPadding());
-          if (showMaxMin) {
-            var axisMaxMin = wrap.selectAll('g.nv-axisMaxMin')
-                           .data(scale.domain());
-            axisMaxMin.enter().append('g').attr('class', 'nv-axisMaxMin').append('text')
-                .style('opacity', 0);
-            axisMaxMin.exit().remove();
-            axisMaxMin
-                .attr('transform', function(d,i) {
-                  return 'translate(0,' + scale(d) + ')'
-                })
-              .select('text')
-                .attr('dy', '.32em')
-                .attr('y', 0)
-                .attr('x', axis.tickPadding())
-                .style('text-anchor', 'start')
-                .text(function(d,i) {
-                  var v = fmt(d);
-                  return ('' + v).match('NaN') ? '' : v;
-                });
-            axisMaxMin.transition()
-                .attr('transform', function(d,i) {
-                  return 'translate(0,' + scale.range()[i] + ')'
-                })
-              .select('text')
-                .style('opacity', 1);
-          }
-          break;
-        case 'left':
-          /*
-          //For dynamically placing the label. Can be used with dynamically-sized chart axis margins
-          var yTicks = g.selectAll('g').select("text");
-          yTicks.each(function(d,i){
-            var labelPadding = this.getBBox().width + axis.tickPadding() + 16;
-            if(labelPadding > width) width = labelPadding;
-          });
-          */
-          axisLabel.enter().append('text').attr('class', 'nv-axislabel');
-          axisLabel
-              .style('text-anchor', rotateYLabel ? 'middle' : 'end')
-              .attr('transform', rotateYLabel ? 'rotate(-90)' : '')
-              .attr('y', rotateYLabel ? (-Math.max(margin.left,width) + axisLabelDistance) : -10) //TODO: consider calculating this based on largest tick width... OR at least expose this on chart
-              .attr('x', rotateYLabel ? (-scale.range()[0] / 2) : -axis.tickPadding());
-          if (showMaxMin) {
-            var axisMaxMin = wrap.selectAll('g.nv-axisMaxMin')
-                           .data(scale.domain());
-            axisMaxMin.enter().append('g').attr('class', 'nv-axisMaxMin').append('text')
-                .style('opacity', 0);
-            axisMaxMin.exit().remove();
-            axisMaxMin
-                .attr('transform', function(d,i) {
-                  return 'translate(0,' + scale0(d) + ')'
-                })
-              .select('text')
-                .attr('dy', '.32em')
-                .attr('y', 0)
-                .attr('x', -axis.tickPadding())
-                .attr('text-anchor', 'end')
-                .text(function(d,i) {
-                  var v = fmt(d);
-                  return ('' + v).match('NaN') ? '' : v;
-                });
-            axisMaxMin.transition()
-                .attr('transform', function(d,i) {
-                  return 'translate(0,' + scale.range()[i] + ')'
-                })
-              .select('text')
-                .style('opacity', 1);
-          }
-          break;
-      }
-      axisLabel
-          .text(function(d) { return d });
-
-
-      if (showMaxMin && (axis.orient() === 'left' || axis.orient() === 'right')) {
-        //check if max and min overlap other values, if so, hide the values that overlap
-        g.selectAll('g') // the g's wrapping each tick
-            .each(function(d,i) {
-              d3.select(this).select('text').attr('opacity', 1);
-              if (scale(d) < scale.range()[1] + 10 || scale(d) > scale.range()[0] - 10) { // 10 is assuming text height is 16... if d is 0, leave it!
-                if (d > 1e-10 || d < -1e-10) // accounts for minor floating point errors... though could be problematic if the scale is EXTREMELY SMALL
-                  d3.select(this).attr('opacity', 0);
-                
-                d3.select(this).select('text').attr('opacity', 0); // Don't remove the ZERO line!!
-              }
-            });
-
-        //if Max and Min = 0 only show min, Issue #281
-        if (scale.domain()[0] == scale.domain()[1] && scale.domain()[0] == 0)
-          wrap.selectAll('g.nv-axisMaxMin')
-            .style('opacity', function(d,i) { return !i ? 1 : 0 });
-
-      }
-
-      if (showMaxMin && (axis.orient() === 'top' || axis.orient() === 'bottom')) {
-        var maxMinRange = [];
-        wrap.selectAll('g.nv-axisMaxMin')
-            .each(function(d,i) {
-              try {
-                  if (i) // i== 1, max position
-                      maxMinRange.push(scale(d) - this.getBBox().width - 4)  //assuming the max and min labels are as wide as the next tick (with an extra 4 pixels just in case)
-                  else // i==0, min position
-                      maxMinRange.push(scale(d) + this.getBBox().width + 4)
-              }catch (err) {
-                  if (i) // i== 1, max position
-                      maxMinRange.push(scale(d) - 4)  //assuming the max and min labels are as wide as the next tick (with an extra 4 pixels just in case)
-                  else // i==0, min position
-                      maxMinRange.push(scale(d) + 4)
-              }
-            });
-        g.selectAll('g') // the g's wrapping each tick
-            .each(function(d,i) {
-              if (scale(d) < maxMinRange[0] || scale(d) > maxMinRange[1]) {
-                if (d > 1e-10 || d < -1e-10) // accounts for minor floating point errors... though could be problematic if the scale is EXTREMELY SMALL
-                  d3.select(this).remove();
-                else
-                  d3.select(this).select('text').remove(); // Don't remove the ZERO line!!
-              }
-            });
-      }
-
-
-      //highlight zero line ... Maybe should not be an option and should just be in CSS?
-      if (highlightZero)
-        g.selectAll('.tick')
-          .filter(function(d) { return !parseFloat(Math.round(d.__data__*100000)/1000000) && (d.__data__ !== undefined) }) //this is because sometimes the 0 tick is a very small fraction, TODO: think of cleaner technique
-            .classed('zero', true);
-
-      //store old scales for use in transitions on update
-      scale0 = scale.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.axis = axis;
-
-  d3.rebind(chart, axis, 'orient', 'tickValues', 'tickSubdivide', 'tickSize', 'tickPadding', 'tickFormat');
-  d3.rebind(chart, scale, 'domain', 'range', 'rangeBand', 'rangeBands'); //these are also accessible by chart.scale(), but added common ones directly for ease of use
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if(!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  }
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.ticks = function(_) {
-    if (!arguments.length) return ticks;
-    ticks = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.axisLabel = function(_) {
-    if (!arguments.length) return axisLabelText;
-    axisLabelText = _;
-    return chart;
-  }
-
-  chart.showMaxMin = function(_) {
-    if (!arguments.length) return showMaxMin;
-    showMaxMin = _;
-    return chart;
-  }
-
-  chart.highlightZero = function(_) {
-    if (!arguments.length) return highlightZero;
-    highlightZero = _;
-    return chart;
-  }
-
-  chart.scale = function(_) {
-    if (!arguments.length) return scale;
-    scale = _;
-    axis.scale(scale);
-    isOrdinal = typeof scale.rangeBands === 'function';
-    d3.rebind(chart, scale, 'domain', 'range', 'rangeBand', 'rangeBands');
-    return chart;
-  }
-
-  chart.rotateYLabel = function(_) {
-    if(!arguments.length) return rotateYLabel;
-    rotateYLabel = _;
-    return chart;
-  }
-
-  chart.rotateLabels = function(_) {
-    if(!arguments.length) return rotateLabels;
-    rotateLabels = _;
-    return chart;
-  }
-
-  chart.staggerLabels = function(_) {
-    if (!arguments.length) return staggerLabels;
-    staggerLabels = _;
-    return chart;
-  };
-
-  chart.axisLabelDistance = function(_) {
-    if (!arguments.length) return axisLabelDistance;
-    axisLabelDistance = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-// Chart design based on the recommendations of Stephen Few. Implementation
-// based on the work of Clint Ivy, Jamie Love, and Jason Davies.
-// http://projects.instantcognition.com/protovis/bulletchart/
-
-nv.models.bullet = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , orient = 'left' // TODO top & bottom
-    , reverse = false
-    , ranges = function(d) { return d.ranges }
-    , markers = function(d) { return d.markers }
-    , measures = function(d) { return d.measures }
-    , rangeLabels = function(d) { return d.rangeLabels ? d.rangeLabels : [] }
-    , markerLabels = function(d) { return d.markerLabels ? d.markerLabels : []  }
-    , measureLabels = function(d) { return d.measureLabels ? d.measureLabels : []  }
-    , forceX = [0] // List of numbers to Force into the X scale (ie. 0, or a max / min, etc.)
-    , width = 380
-    , height = 30
-    , tickFormat = null
-    , color = nv.utils.getColor(['#1f77b4'])
-    , dispatch = d3.dispatch('elementMouseover', 'elementMouseout')
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(d, i) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-      var rangez = ranges.call(this, d, i).slice().sort(d3.descending),
-          markerz = markers.call(this, d, i).slice().sort(d3.descending),
-          measurez = measures.call(this, d, i).slice().sort(d3.descending),
-          rangeLabelz = rangeLabels.call(this, d, i).slice(),
-          markerLabelz = markerLabels.call(this, d, i).slice(),
-          measureLabelz = measureLabels.call(this, d, i).slice();
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      // Compute the new x-scale.
-      var x1 = d3.scale.linear()
-          .domain( d3.extent(d3.merge([forceX, rangez])) )
-          .range(reverse ? [availableWidth, 0] : [0, availableWidth]);
-
-      // Retrieve the old x-scale, if this is an update.
-      var x0 = this.__chart__ || d3.scale.linear()
-          .domain([0, Infinity])
-          .range(x1.range());
-
-      // Stash the new scale.
-      this.__chart__ = x1;
-
-
-      var rangeMin = d3.min(rangez), //rangez[2]
-          rangeMax = d3.max(rangez), //rangez[0]
-          rangeAvg = rangez[1];
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-bullet').data([d]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-bullet');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('rect').attr('class', 'nv-range nv-rangeMax');
-      gEnter.append('rect').attr('class', 'nv-range nv-rangeAvg');
-      gEnter.append('rect').attr('class', 'nv-range nv-rangeMin');
-      gEnter.append('rect').attr('class', 'nv-measure');
-      gEnter.append('path').attr('class', 'nv-markerTriangle');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-
-      var w0 = function(d) { return Math.abs(x0(d) - x0(0)) }, // TODO: could optimize by precalculating x0(0) and x1(0)
-          w1 = function(d) { return Math.abs(x1(d) - x1(0)) };
-      var xp0 = function(d) { return d < 0 ? x0(d) : x0(0) },
-          xp1 = function(d) { return d < 0 ? x1(d) : x1(0) };
-
-
-      g.select('rect.nv-rangeMax')
-          .attr('height', availableHeight)
-          .attr('width', w1(rangeMax > 0 ? rangeMax : rangeMin))
-          .attr('x', xp1(rangeMax > 0 ? rangeMax : rangeMin))
-          .datum(rangeMax > 0 ? rangeMax : rangeMin)
-          /*
-          .attr('x', rangeMin < 0 ?
-                         rangeMax > 0 ?
-                             x1(rangeMin)
-                           : x1(rangeMax)
-                       : x1(0))
-                      */
-
-      g.select('rect.nv-rangeAvg')
-          .attr('height', availableHeight)
-          .attr('width', w1(rangeAvg))
-          .attr('x', xp1(rangeAvg))
-          .datum(rangeAvg)
-          /*
-          .attr('width', rangeMax <= 0 ?
-                             x1(rangeMax) - x1(rangeAvg)
-                           : x1(rangeAvg) - x1(rangeMin))
-          .attr('x', rangeMax <= 0 ?
-                         x1(rangeAvg)
-                       : x1(rangeMin))
-                      */
-
-      g.select('rect.nv-rangeMin')
-          .attr('height', availableHeight)
-          .attr('width', w1(rangeMax))
-          .attr('x', xp1(rangeMax))
-          .attr('width', w1(rangeMax > 0 ? rangeMin : rangeMax))
-          .attr('x', xp1(rangeMax > 0 ? rangeMin : rangeMax))
-          .datum(rangeMax > 0 ? rangeMin : rangeMax)
-          /*
-          .attr('width', rangeMax <= 0 ?
-                             x1(rangeAvg) - x1(rangeMin)
-                           : x1(rangeMax) - x1(rangeAvg))
-          .attr('x', rangeMax <= 0 ?
-                         x1(rangeMin)
-                       : x1(rangeAvg))
-                      */
-
-      g.select('rect.nv-measure')
-          .style('fill', color)
-          .attr('height', availableHeight / 3)
-          .attr('y', availableHeight / 3)
-          .attr('width', measurez < 0 ?
-                             x1(0) - x1(measurez[0])
-                           : x1(measurez[0]) - x1(0))
-          .attr('x', xp1(measurez))
-          .on('mouseover', function() {
-              dispatch.elementMouseover({
-                value: measurez[0],
-                label: measureLabelz[0] || 'Current',
-                pos: [x1(measurez[0]), availableHeight/2]
-              })
-          })
-          .on('mouseout', function() {
-              dispatch.elementMouseout({
-                value: measurez[0],
-                label: measureLabelz[0] || 'Current'
-              })
-          })
-
-      var h3 =  availableHeight / 6;
-      if (markerz[0]) {
-        g.selectAll('path.nv-markerTriangle')
-            .attr('transform', function(d) { return 'translate(' + x1(markerz[0]) + ',' + (availableHeight / 2) + ')' })
-            .attr('d', 'M0,' + h3 + 'L' + h3 + ',' + (-h3) + ' ' + (-h3) + ',' + (-h3) + 'Z')
-            .on('mouseover', function() {
-              dispatch.elementMouseover({
-                value: markerz[0],
-                label: markerLabelz[0] || 'Previous',
-                pos: [x1(markerz[0]), availableHeight/2]
-              })
-            })
-            .on('mouseout', function() {
-              dispatch.elementMouseout({
-                value: markerz[0],
-                label: markerLabelz[0] || 'Previous'
-              })
-            });
-      } else {
-        g.selectAll('path.nv-markerTriangle').remove();
-      }
-
-
-      wrap.selectAll('.nv-range')
-          .on('mouseover', function(d,i) {
-            var label = rangeLabelz[i] || (!i ? "Maximum" : i == 1 ? "Mean" : "Minimum");
-
-            dispatch.elementMouseover({
-              value: d,
-              label: label,
-              pos: [x1(d), availableHeight/2]
-            })
-          })
-          .on('mouseout', function(d,i) {
-            var label = rangeLabelz[i] || (!i ? "Maximum" : i == 1 ? "Mean" : "Minimum");
-
-            dispatch.elementMouseout({
-              value: d,
-              label: label
-            })
-          })
-
-/* // THIS IS THE PREVIOUS BULLET IMPLEMENTATION, WILL REMOVE SHORTLY
-      // Update the range rects.
-      var range = g.selectAll('rect.nv-range')
-          .data(rangez);
-
-      range.enter().append('rect')
-          .attr('class', function(d, i) { return 'nv-range nv-s' + i; })
-          .attr('width', w0)
-          .attr('height', availableHeight)
-          .attr('x', reverse ? x0 : 0)
-          .on('mouseover', function(d,i) { 
-              dispatch.elementMouseover({
-                value: d,
-                label: (i <= 0) ? 'Maximum' : (i > 1) ? 'Minimum' : 'Mean', //TODO: make these labels a variable
-                pos: [x1(d), availableHeight/2]
-              })
-          })
-          .on('mouseout', function(d,i) { 
-              dispatch.elementMouseout({
-                value: d,
-                label: (i <= 0) ? 'Minimum' : (i >=1) ? 'Maximum' : 'Mean' //TODO: make these labels a variable
-              })
-          })
-
-      d3.transition(range)
-          .attr('x', reverse ? x1 : 0)
-          .attr('width', w1)
-          .attr('height', availableHeight);
-
-
-      // Update the measure rects.
-      var measure = g.selectAll('rect.nv-measure')
-          .data(measurez);
-
-      measure.enter().append('rect')
-          .attr('class', function(d, i) { return 'nv-measure nv-s' + i; })
-          .style('fill', function(d,i) { return color(d,i ) })
-          .attr('width', w0)
-          .attr('height', availableHeight / 3)
-          .attr('x', reverse ? x0 : 0)
-          .attr('y', availableHeight / 3)
-          .on('mouseover', function(d) { 
-              dispatch.elementMouseover({
-                value: d,
-                label: 'Current', //TODO: make these labels a variable
-                pos: [x1(d), availableHeight/2]
-              })
-          })
-          .on('mouseout', function(d) { 
-              dispatch.elementMouseout({
-                value: d,
-                label: 'Current' //TODO: make these labels a variable
-              })
-          })
-
-      d3.transition(measure)
-          .attr('width', w1)
-          .attr('height', availableHeight / 3)
-          .attr('x', reverse ? x1 : 0)
-          .attr('y', availableHeight / 3);
-
-
-
-      // Update the marker lines.
-      var marker = g.selectAll('path.nv-markerTriangle')
-          .data(markerz);
-
-      var h3 =  availableHeight / 6;
-      marker.enter().append('path')
-          .attr('class', 'nv-markerTriangle')
-          .attr('transform', function(d) { return 'translate(' + x0(d) + ',' + (availableHeight / 2) + ')' })
-          .attr('d', 'M0,' + h3 + 'L' + h3 + ',' + (-h3) + ' ' + (-h3) + ',' + (-h3) + 'Z')
-          .on('mouseover', function(d,i) {
-              dispatch.elementMouseover({
-                value: d,
-                label: 'Previous',
-                pos: [x1(d), availableHeight/2]
-              })
-          })
-          .on('mouseout', function(d,i) {
-              dispatch.elementMouseout({
-                value: d,
-                label: 'Previous'
-              })
-          });
-
-      d3.transition(marker)
-          .attr('transform', function(d) { return 'translate(' + (x1(d) - x1(0)) + ',' + (availableHeight / 2) + ')' });
-
-      marker.exit().remove();
-*/
-
-    });
-
-    // d3.timer.flush();  // Not needed?
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  // left, right, top, bottom
-  chart.orient = function(_) {
-    if (!arguments.length) return orient;
-    orient = _;
-    reverse = orient == 'right' || orient == 'bottom';
-    return chart;
-  };
-
-  // ranges (bad, satisfactory, good)
-  chart.ranges = function(_) {
-    if (!arguments.length) return ranges;
-    ranges = _;
-    return chart;
-  };
-
-  // markers (previous, goal)
-  chart.markers = function(_) {
-    if (!arguments.length) return markers;
-    markers = _;
-    return chart;
-  };
-
-  // measures (actual, forecast)
-  chart.measures = function(_) {
-    if (!arguments.length) return measures;
-    measures = _;
-    return chart;
-  };
-
-  chart.forceX = function(_) {
-    if (!arguments.length) return forceX;
-    forceX = _;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.tickFormat = function(_) {
-    if (!arguments.length) return tickFormat;
-    tickFormat = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-};
-
-
-
-// Chart design based on the recommendations of Stephen Few. Implementation
-// based on the work of Clint Ivy, Jamie Love, and Jason Davies.
-// http://projects.instantcognition.com/protovis/bulletchart/
-nv.models.bulletChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var bullet = nv.models.bullet()
-    ;
-
-  var orient = 'left' // TODO top & bottom
-    , reverse = false
-    , margin = {top: 5, right: 40, bottom: 20, left: 120}
-    , ranges = function(d) { return d.ranges }
-    , markers = function(d) { return d.markers }
-    , measures = function(d) { return d.measures }
-    , width = null
-    , height = 55
-    , tickFormat = null
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + x + '</h3>' +
-               '<p>' + y + '</p>'
-      }
-    , noData = 'No Data Available.'
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ) + margin.left,
-        top = e.pos[1] + ( offsetElement.offsetTop || 0) + margin.top,
-        content = tooltip(e.key, e.label, e.value, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'e' : 'w', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(d, i) {
-      var container = d3.select(this);
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          that = this;
-
-
-      chart.update = function() { chart(selection) };
-      chart.container = this;
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!d || !ranges.call(this, d, i)) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', 18 + margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-
-      var rangez = ranges.call(this, d, i).slice().sort(d3.descending),
-          markerz = markers.call(this, d, i).slice().sort(d3.descending),
-          measurez = measures.call(this, d, i).slice().sort(d3.descending);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-bulletChart').data([d]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-bulletChart');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-bulletWrap');
-      gEnter.append('g').attr('class', 'nv-titles');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      // Compute the new x-scale.
-      var x1 = d3.scale.linear()
-          .domain([0, Math.max(rangez[0], markerz[0], measurez[0])])  // TODO: need to allow forceX and forceY, and xDomain, yDomain
-          .range(reverse ? [availableWidth, 0] : [0, availableWidth]);
-
-      // Retrieve the old x-scale, if this is an update.
-      var x0 = this.__chart__ || d3.scale.linear()
-          .domain([0, Infinity])
-          .range(x1.range());
-
-      // Stash the new scale.
-      this.__chart__ = x1;
-
-      /*
-      // Derive width-scales from the x-scales.
-      var w0 = bulletWidth(x0),
-          w1 = bulletWidth(x1);
-
-      function bulletWidth(x) {
-        var x0 = x(0);
-        return function(d) {
-          return Math.abs(x(d) - x(0));
-        };
-      }
-
-      function bulletTranslate(x) {
-        return function(d) {
-          return 'translate(' + x(d) + ',0)';
-        };
-      }
-      */
-
-      var w0 = function(d) { return Math.abs(x0(d) - x0(0)) }, // TODO: could optimize by precalculating x0(0) and x1(0)
-          w1 = function(d) { return Math.abs(x1(d) - x1(0)) };
-
-
-      var title = gEnter.select('.nv-titles').append('g')
-          .attr('text-anchor', 'end')
-          .attr('transform', 'translate(-6,' + (height - margin.top - margin.bottom) / 2 + ')');
-      title.append('text')
-          .attr('class', 'nv-title')
-          .text(function(d) { return d.title; });
-
-      title.append('text')
-          .attr('class', 'nv-subtitle')
-          .attr('dy', '1em')
-          .text(function(d) { return d.subtitle; });
-
-
-
-      bullet
-        .width(availableWidth)
-        .height(availableHeight)
-
-      var bulletWrap = g.select('.nv-bulletWrap');
-
-      d3.transition(bulletWrap).call(bullet);
-
-
-
-      // Compute the tick format.
-      var format = tickFormat || x1.tickFormat( availableWidth / 100 );
-
-      // Update the tick groups.
-      var tick = g.selectAll('g.nv-tick')
-          .data(x1.ticks( availableWidth / 50 ), function(d) {
-            return this.textContent || format(d);
-          });
-
-      // Initialize the ticks with the old scale, x0.
-      var tickEnter = tick.enter().append('g')
-          .attr('class', 'nv-tick')
-          .attr('transform', function(d) { return 'translate(' + x0(d) + ',0)' })
-          .style('opacity', 1e-6);
-
-      tickEnter.append('line')
-          .attr('y1', availableHeight)
-          .attr('y2', availableHeight * 7 / 6);
-
-      tickEnter.append('text')
-          .attr('text-anchor', 'middle')
-          .attr('dy', '1em')
-          .attr('y', availableHeight * 7 / 6)
-          .text(format);
-
-
-      // Transition the updating ticks to the new scale, x1.
-      var tickUpdate = d3.transition(tick)
-          .attr('transform', function(d) { return 'translate(' + x1(d) + ',0)' })
-          .style('opacity', 1);
-
-      tickUpdate.select('line')
-          .attr('y1', availableHeight)
-          .attr('y2', availableHeight * 7 / 6);
-
-      tickUpdate.select('text')
-          .attr('y', availableHeight * 7 / 6);
-
-      // Transition the exiting ticks to the new scale, x1.
-      d3.transition(tick.exit())
-          .attr('transform', function(d) { return 'translate(' + x1(d) + ',0)' })
-          .style('opacity', 1e-6)
-          .remove();
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      dispatch.on('tooltipShow', function(e) {
-        e.key = d.title;
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      //============================================================
-
-    });
-
-    d3.timer.flush();
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  bullet.dispatch.on('elementMouseover.tooltip', function(e) {
-    dispatch.tooltipShow(e);
-  });
-
-  bullet.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.bullet = bullet;
-
-  d3.rebind(chart, bullet, 'color');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  // left, right, top, bottom
-  chart.orient = function(x) {
-    if (!arguments.length) return orient;
-    orient = x;
-    reverse = orient == 'right' || orient == 'bottom';
-    return chart;
-  };
-
-  // ranges (bad, satisfactory, good)
-  chart.ranges = function(x) {
-    if (!arguments.length) return ranges;
-    ranges = x;
-    return chart;
-  };
-
-  // markers (previous, goal)
-  chart.markers = function(x) {
-    if (!arguments.length) return markers;
-    markers = x;
-    return chart;
-  };
-
-  // measures (actual, forecast)
-  chart.measures = function(x) {
-    if (!arguments.length) return measures;
-    measures = x;
-    return chart;
-  };
-
-  chart.width = function(x) {
-    if (!arguments.length) return width;
-    width = x;
-    return chart;
-  };
-
-  chart.height = function(x) {
-    if (!arguments.length) return height;
-    height = x;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.tickFormat = function(x) {
-    if (!arguments.length) return tickFormat;
-    tickFormat = x;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-};
-
-
-
-nv.models.cumulativeLineChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var lines = nv.models.line()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend()
-    , controls = nv.models.legend()
-    , interactiveLayer = nv.interactiveGuideline()
-    ;
-
-  var margin = {top: 30, right: 30, bottom: 50, left: 60}
-    , color = nv.utils.defaultColor()
-    , width = null
-    , height = null
-    , showLegend = true
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , tooltips = true
-    , showControls = true
-    , useInteractiveGuideline = false
-    , rescaleY = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>'
-      }
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , id = lines.id()
-    , state = { index: 0, rescaleY: rescaleY }
-    , defaultState = null
-    , noData = 'No Data Available.'
-    , average = function(d) { return d.average }
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , transitionDuration = 250
-    ;
-
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    ;
-
-  //============================================================
-  controls.updateState(false);
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-   var dx = d3.scale.linear()
-     , index = {i: 0, x: 0}
-     ;
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(lines.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(lines.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, null, null, offsetElement);
-  };
-
-/*
-  //Moved to see if we can get better behavior to fix issue #315
-  var indexDrag = d3.behavior.drag()
-                    .on('dragstart', dragStart)
-                    .on('drag', dragMove)
-                    .on('dragend', dragEnd);
-
-  function dragStart(d,i) {
-    d3.select(chart.container)
-        .style('cursor', 'ew-resize');
-  }
-
-  function dragMove(d,i) {
-    d.x += d3.event.dx;
-    d.i = Math.round(dx.invert(d.x));
-
-    d3.select(this).attr('transform', 'translate(' + dx(d.i) + ',0)');
-    chart.update();
-  }
-
-  function dragEnd(d,i) {
-    d3.select(chart.container)
-        .style('cursor', 'auto');
-    chart.update();
-  }
-*/
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this).classed('nv-chart-' + id, true),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      var indexDrag = d3.behavior.drag()
-                        .on('dragstart', dragStart)
-                        .on('drag', dragMove)
-                        .on('dragend', dragEnd);
-
-
-      function dragStart(d,i) {
-        d3.select(chart.container)
-            .style('cursor', 'ew-resize');
-      }
-
-      function dragMove(d,i) {
-        index.x = d3.event.x;
-        index.i = Math.round(dx.invert(index.x));
-        updateZero();
-      }
-
-      function dragEnd(d,i) {
-        d3.select(chart.container)
-            .style('cursor', 'auto');
-
-        // update state and send stateChange with new index
-        state.index = index.i;
-        dispatch.stateChange(state);
-      }
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = lines.xScale();
-      y = lines.yScale();
-
-
-      if (!rescaleY) {
-        var seriesDomains = data
-          .filter(function(series) { return !series.disabled })
-          .map(function(series,i) {
-            var initialDomain = d3.extent(series.values, lines.y());
-
-            //account for series being disabled when losing 95% or more
-            if (initialDomain[0] < -.95) initialDomain[0] = -.95;
-
-            return [
-              (initialDomain[0] - initialDomain[1]) / (1 + initialDomain[1]),
-              (initialDomain[1] - initialDomain[0]) / (1 + initialDomain[0])
-            ];
-          });
-
-        var completeDomain = [
-          d3.min(seriesDomains, function(d) { return d[0] }),
-          d3.max(seriesDomains, function(d) { return d[1] })
-        ]
-
-        lines.yDomain(completeDomain);
-      } else {
-        lines.yDomain(null);
-      }
-
-
-      dx  .domain([0, data[0].values.length - 1]) //Assumes all series have same length
-          .range([0, availableWidth])
-          .clamp(true);
-
-      //------------------------------------------------------------
-
-
-      var data = indexify(index.i, data);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-      var interactivePointerEvents = (useInteractiveGuideline) ? "none" : "all";
-      var wrap = container.selectAll('g.nv-wrap.nv-cumulativeLine').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-cumulativeLine').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-interactive');
-      gEnter.append('g').attr('class', 'nv-x nv-axis').style("pointer-events","none");
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-background');
-      gEnter.append('g').attr('class', 'nv-linesWrap').style("pointer-events",interactivePointerEvents);
-      gEnter.append('g').attr('class', 'nv-avgLinesWrap').style("pointer-events","none");
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-      
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth);
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        var controlsData = [
-          { key: 'Re-scale y-axis', disabled: !rescaleY }
-        ];
-
-        controls.width(140).color(['#444', '#444', '#444']);
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-            .call(controls);
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      // Show error if series goes below 100%
-      var tempDisabled = data.filter(function(d) { return d.tempDisabled });
-
-      wrap.select('.tempDisabled').remove(); //clean-up and prevent duplicates
-      if (tempDisabled.length) {
-        wrap.append('text').attr('class', 'tempDisabled')
-            .attr('x', availableWidth / 2)
-            .attr('y', '-.71em')
-            .style('text-anchor', 'end')
-            .text(tempDisabled.map(function(d) { return d.key }).join(', ') + ' values cannot be calculated for this time period.');
-      }
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-      
-      //------------------------------------------------------------
-      //Set up interactive layer
-      if (useInteractiveGuideline) {
-        interactiveLayer
-          .width(availableWidth)
-          .height(availableHeight)
-          .margin({left:margin.left,top:margin.top})
-          .svgContainer(container)
-          .xScale(x);
-        wrap.select(".nv-interactive").call(interactiveLayer);
-      }
-
-      gEnter.select('.nv-background')
-        .append('rect');
-
-      g.select('.nv-background rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      lines
-        //.x(function(d) { return d.x })
-        .y(function(d) { return d.display.y })
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && !data[i].tempDisabled; }));
-
-
-
-      var linesWrap = g.select('.nv-linesWrap')
-          .datum(data.filter(function(d) { return  !d.disabled && !d.tempDisabled }));
-
-      //d3.transition(linesWrap).call(lines);
-      linesWrap.call(lines);
-
-      /*Handle average lines [AN-612] ----------------------------*/
-
-      //Store a series index number in the data array.
-      data.forEach(function(d,i) {
-            d.seriesIndex = i;
-      });
-
-      var avgLineData = data.filter(function(d) {
-          return !d.disabled && !!average(d);
-      });
-
-      var avgLines = g.select(".nv-avgLinesWrap").selectAll("line")
-              .data(avgLineData, function(d) { return d.key; });
-
-      var getAvgLineY = function(d) {
-          //If average lines go off the svg element, clamp them to the svg bounds.
-          var yVal = y(average(d));
-          if (yVal < 0) return 0;
-          if (yVal > availableHeight) return availableHeight;
-          return yVal;
-      };
-
-      avgLines.enter()
-              .append('line')
-              .style('stroke-width',2)
-              .style('stroke-dasharray','10,10')
-              .style('stroke',function (d,i) {
-                  return lines.color()(d,d.seriesIndex);
-              })
-              .attr('x1',0)
-              .attr('x2',availableWidth)
-              .attr('y1', getAvgLineY)
-              .attr('y2', getAvgLineY);
-
-      avgLines
-              .style('stroke-opacity',function(d){
-                  //If average lines go offscreen, make them transparent
-                  var yVal = y(average(d));
-                  if (yVal < 0 || yVal > availableHeight) return 0;
-                  return 1;
-              })
-              .attr('x1',0)
-              .attr('x2',availableWidth)
-              .attr('y1', getAvgLineY)
-              .attr('y2', getAvgLineY);
-
-      avgLines.exit().remove();
-
-      //Create index line -----------------------------------------
-
-      var indexLine = linesWrap.selectAll('.nv-indexLine')
-          .data([index]);
-      indexLine.enter().append('rect').attr('class', 'nv-indexLine')
-          .attr('width', 3)
-          .attr('x', -2)
-          .attr('fill', 'red')
-          .attr('fill-opacity', .5)
-          .style("pointer-events","all")
-          .call(indexDrag)
-
-      indexLine
-          .attr('transform', function(d) { return 'translate(' + dx(d.i) + ',0)' })
-          .attr('height', availableHeight)
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-        xAxis
-          .scale(x)
-          //Suggest how many ticks based on the chart width and D3 should listen (70 is the optimal number for MM/DD/YY dates)
-          .ticks( Math.min(data[0].values.length,availableWidth/70) )
-          .tickSize(-availableHeight, 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')');
-        d3.transition(g.select('.nv-x.nv-axis'))
-            .call(xAxis);
-      }
-
-
-      if (showYAxis) {
-        yAxis
-          .scale(y)
-          .ticks( availableHeight / 36 )
-          .tickSize( -availableWidth, 0);
-
-        d3.transition(g.select('.nv-y.nv-axis'))
-            .call(yAxis);
-      }
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-
-      function updateZero() {
-        indexLine
-          .data([index]);
-        
-        //When dragging the index line, turn off line transitions.
-        // Then turn them back on when done dragging.
-        var oldDuration = chart.transitionDuration();
-        chart.transitionDuration(0);
-        chart.update();
-        chart.transitionDuration(oldDuration);
-      }
-
-      g.select('.nv-background rect')
-          .on('click', function() {
-            index.x = d3.mouse(this)[0];
-            index.i = Math.round(dx.invert(index.x));
-
-            // update state and send stateChange with new index
-            state.index = index.i;
-            dispatch.stateChange(state);
-
-            updateZero();
-          });
-
-      lines.dispatch.on('elementClick', function(e) {
-        index.i = e.pointIndex;
-        index.x = dx(index.i);
-
-        // update state and send stateChange with new index
-        state.index = index.i;
-        dispatch.stateChange(state);
-
-        updateZero();
-      });
-
-      controls.dispatch.on('legendClick', function(d,i) { 
-        d.disabled = !d.disabled;
-        rescaleY = !d.disabled;
-
-        state.rescaleY = rescaleY;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-
-      legend.dispatch.on('stateChange', function(newState) {
-        state.disabled = newState.disabled; 
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      interactiveLayer.dispatch.on('elementMousemove', function(e) {
-          lines.clearHighlights();
-          var singlePoint, pointIndex, pointXLocation, allData = [];
-          
-          
-          data
-          .filter(function(series, i) { 
-            series.seriesIndex = i;
-            return !series.disabled; 
-          })
-          .forEach(function(series,i) {
-              pointIndex = nv.interactiveBisect(series.values, e.pointXValue, chart.x());
-              lines.highlightPoint(i, pointIndex, true);
-              var point = series.values[pointIndex];
-              if (typeof point === 'undefined') return;
-              if (typeof singlePoint === 'undefined') singlePoint = point;
-              if (typeof pointXLocation === 'undefined') pointXLocation = chart.xScale()(chart.x()(point,pointIndex));
-              allData.push({
-                  key: series.key,
-                  value: chart.y()(point, pointIndex),
-                  color: color(series,series.seriesIndex)
-              });
-          });
-
-          //Highlight the tooltip entry based on which point the mouse is closest to.
-          if (allData.length > 2) {
-            var yValue = chart.yScale().invert(e.mouseY);
-            var yDistMax = Infinity, indexToHighlight = null;
-            allData.forEach(function(series,i) {
-               var delta = Math.abs(yValue - series.value);
-               if ( delta < yDistMax) {
-                  yDistMax = delta;
-                  indexToHighlight = i;
-               }
-            });
-            allData[indexToHighlight].highlight = true;
-          }
-
-          var xValue = xAxis.tickFormat()(chart.x()(singlePoint,pointIndex), pointIndex);
-          interactiveLayer.tooltip
-                  .position({left: pointXLocation + margin.left, top: e.mouseY + margin.top})
-                  .chartContainer(that.parentNode)
-                  .enabled(tooltips)
-                  .valueFormatter(function(d,i) {
-                     return yAxis.tickFormat()(d);
-                  })
-                  .data(
-                      {
-                        value: xValue,
-                        series: allData
-                      }
-                  )();
-
-          interactiveLayer.renderGuideLine(pointXLocation);
-
-      });
-
-      interactiveLayer.dispatch.on("elementMouseout",function(e) {
-          dispatch.tooltipHide();
-          lines.clearHighlights();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-
-        if (typeof e.index !== 'undefined') {
-          index.i = e.index;
-          index.x = dx(index.i);
-
-          state.index = e.index;
-
-          indexLine
-            .data([index]);
-        }
-
-
-        if (typeof e.rescaleY !== 'undefined') {
-          rescaleY = e.rescaleY;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.lines = lines;
-  chart.legend = legend;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.interactiveLayer = interactiveLayer;
-
-  d3.rebind(chart, lines, 'defined', 'isArea', 'x', 'y', 'xScale','yScale', 'size', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi','useVoronoi',  'id');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.rescaleY = function(_) {
-    if (!arguments.length) return rescaleY;
-    rescaleY = _
-    return rescaleY;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.useInteractiveGuideline = function(_) {
-    if(!arguments.length) return useInteractiveGuideline;
-    useInteractiveGuideline = _;
-    if (_ === true) {
-       chart.interactive(false);
-       chart.useVoronoi(false);
-    }
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.average = function(_) {
-     if(!arguments.length) return average;
-     average = _;
-     return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  //============================================================
-  // Functions
-  //------------------------------------------------------------
-
-  /* Normalize the data according to an index point. */
-  function indexify(idx, data) {
-    return data.map(function(line, i) {
-      if (!line.values) {
-         return line;
-      }
-      var v = lines.y()(line.values[idx], idx);
-
-      //TODO: implement check below, and disable series if series loses 100% or more cause divide by 0 issue
-      if (v < -.95) {
-        //if a series loses more than 100%, calculations fail.. anything close can cause major distortion (but is mathematically correct till it hits 100)
-        line.tempDisabled = true;
-        return line;
-      }
-
-      line.tempDisabled = false;
-
-      line.values = line.values.map(function(point, pointIndex) {
-        point.display = {'y': (lines.y()(point, pointIndex) - v) / (1 + v) };
-        return point;
-      })
-
-      return line;
-    })
-  }
-
-  //============================================================
-
-
-  return chart;
-}
-//TODO: consider deprecating by adding necessary features to multiBar model
-nv.models.discreteBar = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , x = d3.scale.ordinal()
-    , y = d3.scale.linear()
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , forceY = [0] // 0 is forced by default.. this makes sense for the majority of bar graphs... user can always do chart.forceY([]) to remove
-    , color = nv.utils.defaultColor()
-    , showValues = false
-    , valueFormat = d3.format(',.2f')
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    , rectClass = 'discreteBar'
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-
-      //add series index to each data point for reference
-      data = data.map(function(series, i) {
-        series.values = series.values.map(function(point) {
-          point.series = i;
-          return point;
-        });
-        return series;
-      });
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      // remap and flatten the data for use in calculating the scales' domains
-      var seriesData = (xDomain && yDomain) ? [] : // if we know xDomain and yDomain, no need to calculate
-            data.map(function(d) {
-              return d.values.map(function(d,i) {
-                return { x: getX(d,i), y: getY(d,i), y0: d.y0 }
-              })
-            });
-
-      x   .domain(xDomain || d3.merge(seriesData).map(function(d) { return d.x }))
-          .rangeBands(xRange || [0, availableWidth], .1);
-
-      y   .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return d.y }).concat(forceY)));
-
-
-      // If showValues, pad the Y axis range to account for label height
-      if (showValues) y.range(yRange || [availableHeight - (y.domain()[0] < 0 ? 12 : 0), y.domain()[1] > 0 ? 12 : 0]);
-      else y.range(yRange || [availableHeight, 0]);
-
-      //store old scales if they exist
-      x0 = x0 || x;
-      y0 = y0 || y.copy().range([y(0),y(0)]);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-discretebar').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-discretebar');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-groups');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-
-      //TODO: by definition, the discrete bar should not have multiple groups, will modify/remove later
-      var groups = wrap.select('.nv-groups').selectAll('.nv-group')
-          .data(function(d) { return d }, function(d) { return d.key });
-      groups.enter().append('g')
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6);
-      groups.exit()
-          .transition()
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6)
-          .remove();
-      groups
-          .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
-          .classed('hover', function(d) { return d.hover });
-      groups
-          .transition()
-          .style('stroke-opacity', 1)
-          .style('fill-opacity', .75);
-
-
-      var bars = groups.selectAll('g.nv-bar')
-          .data(function(d) { return d.values });
-
-      bars.exit().remove();
-
-
-      var barsEnter = bars.enter().append('g')
-          .attr('transform', function(d,i,j) {
-              return 'translate(' + (x(getX(d,i)) + x.rangeBand() * .05 ) + ', ' + y(0) + ')' 
-          })
-          .on('mouseover', function(d,i) { //TODO: figure out why j works above, but not here
-            d3.select(this).classed('hover', true);
-            dispatch.elementMouseover({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (d.series + .5) / data.length), y(getY(d,i))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('mouseout', function(d,i) {
-            d3.select(this).classed('hover', false);
-            dispatch.elementMouseout({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('click', function(d,i) {
-            dispatch.elementClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (d.series + .5) / data.length), y(getY(d,i))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          })
-          .on('dblclick', function(d,i) {
-            dispatch.elementDblClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (d.series + .5) / data.length), y(getY(d,i))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          });
-
-      barsEnter.append('rect')
-          .attr('height', 0)
-          .attr('width', x.rangeBand() * .9 / data.length )
-
-      if (showValues) {
-        barsEnter.append('text')
-          .attr('text-anchor', 'middle')
-          ;
-
-        bars.select('text')
-          .text(function(d,i) { return valueFormat(getY(d,i)) })
-          .transition()
-          .attr('x', x.rangeBand() * .9 / 2)
-          .attr('y', function(d,i) { return getY(d,i) < 0 ? y(getY(d,i)) - y(0) + 12 : -4 })
-          
-          ;
-      } else {
-        bars.selectAll('text').remove();
-      }
-
-      bars
-          .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive' })
-          .style('fill', function(d,i) { return d.color || color(d,i) })
-          .style('stroke', function(d,i) { return d.color || color(d,i) })
-        .select('rect')
-          .attr('class', rectClass)
-          .transition()
-          .attr('width', x.rangeBand() * .9 / data.length);
-      bars.transition()
-        //.delay(function(d,i) { return i * 1200 / data[0].values.length })
-          .attr('transform', function(d,i) {
-            var left = x(getX(d,i)) + x.rangeBand() * .05,
-                top = getY(d,i) < 0 ?
-                        y(0) :
-                        y(0) - y(getY(d,i)) < 1 ?
-                          y(0) - 1 : //make 1 px positive bars show up above y=0
-                          y(getY(d,i));
-
-              return 'translate(' + left + ', ' + top + ')'
-          })
-        .select('rect')
-          .attr('height', function(d,i) {
-            return  Math.max(Math.abs(y(getY(d,i)) - y((yDomain && yDomain[0]) || 0)) || 1)
-          });
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.showValues = function(_) {
-    if (!arguments.length) return showValues;
-    showValues = _;
-    return chart;
-  };
-
-  chart.valueFormat= function(_) {
-    if (!arguments.length) return valueFormat;
-    valueFormat = _;
-    return chart;
-  };
-
-  chart.rectClass= function(_) {
-    if (!arguments.length) return rectClass;
-    rectClass = _;
-    return chart;
-  };
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.discreteBarChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var discretebar = nv.models.discreteBar()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    ;
-
-  var margin = {top: 15, right: 10, bottom: 50, left: 60}
-    , width = null
-    , height = null
-    , color = nv.utils.getColor()
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , staggerLabels = false
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + x + '</h3>' +
-               '<p>' +  y + '</p>'
-      }
-    , x
-    , y
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'beforeUpdate')
-    , transitionDuration = 250
-    ;
-
-  xAxis
-    .orient('bottom')
-    .highlightZero(false)
-    .showMaxMin(false)
-    .tickFormat(function(d) { return d })
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    .tickFormat(d3.format(',.1f'))
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(discretebar.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(discretebar.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-
-      chart.update = function() { 
-        dispatch.beforeUpdate(); 
-        container.transition().duration(transitionDuration).call(chart); 
-      };
-      chart.container = this;
-
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = discretebar.xScale();
-      y = discretebar.yScale().clamp(true);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-discreteBarWithAxes').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-discreteBarWithAxes').append('g');
-      var defsEnter = gEnter.append('defs');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-barsWrap');
-
-      g.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      discretebar
-        .width(availableWidth)
-        .height(availableHeight);
-
-
-      var barsWrap = g.select('.nv-barsWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      barsWrap.transition().call(discretebar);
-
-      //------------------------------------------------------------
-
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-x-label-clip-' + discretebar.id())
-        .append('rect');
-
-      g.select('#nv-x-label-clip-' + discretebar.id() + ' rect')
-          .attr('width', x.rangeBand() * (staggerLabels ? 2 : 1))
-          .attr('height', 16)
-          .attr('x', -x.rangeBand() / (staggerLabels ? 1 : 2 ));
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-          xAxis
-            .scale(x)
-            .ticks( availableWidth / 100 )
-            .tickSize(-availableHeight, 0);
-
-          g.select('.nv-x.nv-axis')
-              .attr('transform', 'translate(0,' + (y.range()[0] + ((discretebar.showValues() && y.domain()[0] < 0) ? 16 : 0)) + ')');
-          //d3.transition(g.select('.nv-x.nv-axis'))
-          g.select('.nv-x.nv-axis').transition()
-              .call(xAxis);
-
-
-          var xTicks = g.select('.nv-x.nv-axis').selectAll('g');
-
-          if (staggerLabels) {
-            xTicks
-                .selectAll('text')
-                .attr('transform', function(d,i,j) { return 'translate(0,' + (j % 2 == 0 ? '5' : '17') + ')' })
-          }
-      }
-
-      if (showYAxis) {
-          yAxis
-            .scale(y)
-            .ticks( availableHeight / 36 )
-            .tickSize( -availableWidth, 0);
-
-          g.select('.nv-y.nv-axis').transition()
-              .call(yAxis);
-      }
-
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  discretebar.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  discretebar.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.discretebar = discretebar;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-
-  d3.rebind(chart, discretebar, 'x', 'y', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'id', 'showValues', 'valueFormat');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    discretebar.color(color);
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.staggerLabels = function(_) {
-    if (!arguments.length) return staggerLabels;
-    staggerLabels = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.distribution = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 400 //technically width or height depending on x or y....
-    , size = 8
-    , axis = 'x' // 'x' or 'y'... horizontal or vertical
-    , getData = function(d) { return d[axis] }  // defaults d.x or d.y
-    , color = nv.utils.defaultColor()
-    , scale = d3.scale.linear()
-    , domain
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var scale0;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableLength = width - (axis === 'x' ? margin.left + margin.right : margin.top + margin.bottom),
-          naxis = axis == 'x' ? 'y' : 'x',
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      scale0 = scale0 || scale;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-distribution').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-distribution');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')')
-
-      //------------------------------------------------------------
-
-
-      var distWrap = g.selectAll('g.nv-dist')
-          .data(function(d) { return d }, function(d) { return d.key });
-
-      distWrap.enter().append('g');
-      distWrap
-          .attr('class', function(d,i) { return 'nv-dist nv-series-' + i })
-          .style('stroke', function(d,i) { return color(d, i) });
-
-      var dist = distWrap.selectAll('line.nv-dist' + axis)
-          .data(function(d) { return d.values })
-      dist.enter().append('line')
-          .attr(axis + '1', function(d,i) { return scale0(getData(d,i)) })
-          .attr(axis + '2', function(d,i) { return scale0(getData(d,i)) })
-      distWrap.exit().selectAll('line.nv-dist' + axis)
-          .transition()
-          .attr(axis + '1', function(d,i) { return scale(getData(d,i)) })
-          .attr(axis + '2', function(d,i) { return scale(getData(d,i)) })
-          .style('stroke-opacity', 0)
-          .remove();
-      dist
-          .attr('class', function(d,i) { return 'nv-dist' + axis + ' nv-dist' + axis + '-' + i })
-          .attr(naxis + '1', 0)
-          .attr(naxis + '2', size);
-      dist
-          .transition()
-          .attr(axis + '1', function(d,i) { return scale(getData(d,i)) })
-          .attr(axis + '2', function(d,i) { return scale(getData(d,i)) })
-
-
-      scale0 = scale.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.axis = function(_) {
-    if (!arguments.length) return axis;
-    axis = _;
-    return chart;
-  };
-
-  chart.size = function(_) {
-    if (!arguments.length) return size;
-    size = _;
-    return chart;
-  };
-
-  chart.getData = function(_) {
-    if (!arguments.length) return getData;
-    getData = d3.functor(_);
-    return chart;
-  };
-
-  chart.scale = function(_) {
-    if (!arguments.length) return scale;
-    scale = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-  //============================================================
-
-
-  return chart;
-}
-//TODO: consider deprecating and using multibar with single series for this
-nv.models.historicalBar = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , x = d3.scale.linear()
-    , y = d3.scale.linear()
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , forceX = []
-    , forceY = [0]
-    , padData = false
-    , clipEdge = true
-    , color = nv.utils.defaultColor()
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    , interactive = true
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x   .domain(xDomain || d3.extent(data[0].values.map(getX).concat(forceX) ))
-
-      if (padData)
-        x.range(xRange || [availableWidth * .5 / data[0].values.length, availableWidth * (data[0].values.length - .5)  / data[0].values.length ]);
-      else
-        x.range(xRange || [0, availableWidth]);
-
-      y   .domain(yDomain || d3.extent(data[0].values.map(getY).concat(forceY) ))
-          .range(yRange || [availableHeight, 0]);
-
-      // If scale's domain don't have a range, slightly adjust to make one... so a chart can show a single data point
-
-      if (x.domain()[0] === x.domain()[1])
-        x.domain()[0] ?
-            x.domain([x.domain()[0] - x.domain()[0] * 0.01, x.domain()[1] + x.domain()[1] * 0.01])
-          : x.domain([-1,1]);
-
-      if (y.domain()[0] === y.domain()[1])
-        y.domain()[0] ?
-            y.domain([y.domain()[0] + y.domain()[0] * 0.01, y.domain()[1] - y.domain()[1] * 0.01])
-          : y.domain([-1,1]);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-historicalBar-' + id).data([data[0].values]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-historicalBar-' + id);
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-bars');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      container
-          .on('click', function(d,i) {
-            dispatch.chartClick({
-                data: d,
-                index: i,
-                pos: d3.event,
-                id: id
-            });
-          });
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-chart-clip-path-' + id)
-        .append('rect');
-
-      wrap.select('#nv-chart-clip-path-' + id + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-chart-clip-path-' + id + ')' : '');
-
-
-
-      var bars = wrap.select('.nv-bars').selectAll('.nv-bar')
-          .data(function(d) { return d }, function(d,i) {return getX(d,i)});
-
-      bars.exit().remove();
-
-
-      var barsEnter = bars.enter().append('rect')
-          //.attr('class', function(d,i,j) { return (getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive') + ' nv-bar-' + j + '-' + i })
-          .attr('x', 0 )
-          .attr('y', function(d,i) {  return nv.utils.NaNtoZero(y(Math.max(0, getY(d,i)))) })
-          .attr('height', function(d,i) { return nv.utils.NaNtoZero(Math.abs(y(getY(d,i)) - y(0))) })
-          .attr('transform', function(d,i) { return 'translate(' + (x(getX(d,i)) - availableWidth / data[0].values.length * .45) + ',0)'; }) 
-          .on('mouseover', function(d,i) {
-            if (!interactive) return;
-            d3.select(this).classed('hover', true);
-            dispatch.elementMouseover({
-                point: d,
-                series: data[0],
-                pos: [x(getX(d,i)), y(getY(d,i))],  // TODO: Figure out why the value appears to be shifted
-                pointIndex: i,
-                seriesIndex: 0,
-                e: d3.event
-            });
-
-          })
-          .on('mouseout', function(d,i) {
-                if (!interactive) return;
-                d3.select(this).classed('hover', false);
-                dispatch.elementMouseout({
-                    point: d,
-                    series: data[0],
-                    pointIndex: i,
-                    seriesIndex: 0,
-                    e: d3.event
-                });
-          })
-          .on('click', function(d,i) {
-                if (!interactive) return;
-                dispatch.elementClick({
-                    //label: d[label],
-                    value: getY(d,i),
-                    data: d,
-                    index: i,
-                    pos: [x(getX(d,i)), y(getY(d,i))],
-                    e: d3.event,
-                    id: id
-                });
-              d3.event.stopPropagation();
-          })
-          .on('dblclick', function(d,i) {
-              if (!interactive) return;
-              dispatch.elementDblClick({
-                  //label: d[label],
-                  value: getY(d,i),
-                  data: d,
-                  index: i,
-                  pos: [x(getX(d,i)), y(getY(d,i))],
-                  e: d3.event,
-                  id: id
-              });
-              d3.event.stopPropagation();
-          });
-
-      bars
-          .attr('fill', function(d,i) { return color(d, i); })
-          .attr('class', function(d,i,j) { return (getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive') + ' nv-bar-' + j + '-' + i })
-          .transition()
-          .attr('transform', function(d,i) { return 'translate(' + (x(getX(d,i)) - availableWidth / data[0].values.length * .45) + ',0)'; }) 
-           //TODO: better width calculations that don't assume always uniform data spacing;w
-          .attr('width', (availableWidth / data[0].values.length) * .9 );
-
-
-      bars.transition()
-          .attr('y', function(d,i) {
-            var rval = getY(d,i) < 0 ?
-                    y(0) :
-                    y(0) - y(getY(d,i)) < 1 ?
-                      y(0) - 1 :
-                      y(getY(d,i));
-            return nv.utils.NaNtoZero(rval);
-          })
-          .attr('height', function(d,i) { return nv.utils.NaNtoZero(Math.max(Math.abs(y(getY(d,i)) - y(0)),1)) });
-
-    });
-
-    return chart;
-  }
-
-  //Create methods to allow outside functions to highlight a specific bar.
-  chart.highlightPoint = function(pointIndex, isHoverOver) {
-      d3.select(".nv-historicalBar-" + id)
-        .select(".nv-bars .nv-bar-0-" + pointIndex)
-              .classed("hover", isHoverOver)
-               ;
-  };
-
-  chart.clearHighlights = function() {
-      d3.select(".nv-historicalBar-" + id)
-        .select(".nv-bars .nv-bar.hover")
-              .classed("hover", false)
-               ;
-  };
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.forceX = function(_) {
-    if (!arguments.length) return forceX;
-    forceX = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.padData = function(_) {
-    if (!arguments.length) return padData;
-    padData = _;
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.interactive = function(_) {
-    if(!arguments.length) return interactive;
-    interactive = false;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.historicalBarChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var bars = nv.models.historicalBar()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend()
-    ;
-
-
-  var margin = {top: 30, right: 90, bottom: 50, left: 90}
-    , color = nv.utils.defaultColor()
-    , width = null
-    , height = null
-    , showLegend = false
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>'
-      }
-    , x
-    , y
-    , state = {}
-    , defaultState = null
-    , noData = 'No Data Available.'
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , transitionDuration = 250
-    ;
-
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    ;
-  yAxis
-    .orient( (rightAlignYAxis) ? 'right' : 'left')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-
-    // New addition to calculate position if SVG is scaled with viewBox, may move TODO: consider implementing everywhere else
-    if (offsetElement) {
-      var svg = d3.select(offsetElement).select('svg');
-      var viewBox = (svg.node()) ? svg.attr('viewBox') : null;
-      if (viewBox) {
-        viewBox = viewBox.split(' ');
-        var ratio = parseInt(svg.style('width')) / viewBox[2];
-        e.pos[0] = e.pos[0] * ratio;
-        e.pos[1] = e.pos[1] * ratio;
-      }
-    }
-
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(bars.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(bars.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, null, null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display noData message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = bars.xScale();
-      y = bars.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-historicalBarChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-historicalBarChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-barsWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth);
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        wrap.select('.nv-legendWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-      }
-
-      //------------------------------------------------------------
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-        g.select(".nv-y.nv-axis")
-            .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      bars
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled }));
-
-
-      var barsWrap = g.select('.nv-barsWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      barsWrap.transition().call(bars);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-        xAxis
-          .scale(x)
-          .tickSize(-availableHeight, 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')');
-        g.select('.nv-x.nv-axis')
-            .transition()
-            .call(xAxis);
-      }
-
-      if (showYAxis) {
-        yAxis
-          .scale(y)
-          .ticks( availableHeight / 36 )
-          .tickSize( -availableWidth, 0);
-
-        g.select('.nv-y.nv-axis')
-          .transition()
-            .call(yAxis);
-      }
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('legendClick', function(d,i) { 
-        d.disabled = !d.disabled;
-
-        if (!data.filter(function(d) { return !d.disabled }).length) {
-          data.map(function(d) {
-            d.disabled = false;
-            wrap.selectAll('.nv-series').classed('disabled', false);
-            return d;
-          });
-        }
-
-        state.disabled = data.map(function(d) { return !!d.disabled });
-        dispatch.stateChange(state);
-
-        selection.transition().call(chart);
-      });
-
-      legend.dispatch.on('legendDblclick', function(d) {
-          //Double clicking should always enable current series, and disabled all others.
-          data.forEach(function(d) {
-             d.disabled = true;
-          });
-          d.disabled = false;  
-
-          state.disabled = data.map(function(d) { return !!d.disabled });
-          dispatch.stateChange(state);
-          chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        selection.call(chart);
-      });
-
-      //============================================================
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  bars.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  bars.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.bars = bars;
-  chart.legend = legend;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-
-  d3.rebind(chart, bars, 'defined', 'isArea', 'x', 'y', 'size', 'xScale', 'yScale', 
-    'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi', 'id', 'interpolate','highlightPoint','clearHighlights', 'interactive');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-nv.models.indentedTree = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0} //TODO: implement, maybe as margin on the containing div
-    , width = 960
-    , height = 500
-    , color = nv.utils.defaultColor()
-    , id = Math.floor(Math.random() * 10000)
-    , header = true
-    , filterZero = false
-    , noData = "No Data Available."
-    , childIndent = 20
-    , columns = [{key:'key', label: 'Name', type:'text'}] //TODO: consider functions like chart.addColumn, chart.removeColumn, instead of a block like this
-    , tableClass = null
-    , iconOpen = 'images/grey-plus.png' //TODO: consider removing this and replacing with a '+' or '-' unless user defines images
-    , iconClose = 'images/grey-minus.png'
-    , dispatch = d3.dispatch('elementClick', 'elementDblclick', 'elementMouseover', 'elementMouseout')
-    , getUrl = function(d) { return d.url }
-    ;
-
-  //============================================================
-
-  var idx = 0;
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var depth = 1,
-          container = d3.select(this);
-
-      var tree = d3.layout.tree()
-          .children(function(d) { return d.values })
-          .size([height, childIndent]); //Not sure if this is needed now that the result is HTML
-
-      chart.update = function() { container.transition().duration(600).call(chart) };
-
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-      if (!data[0]) data[0] = {key: noData};
-
-      //------------------------------------------------------------
-
-
-      var nodes = tree.nodes(data[0]);
-
-      // nodes.map(function(d) {
-      //   d.id = i++;
-      // })
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = d3.select(this).selectAll('div').data([[nodes]]);
-      var wrapEnter = wrap.enter().append('div').attr('class', 'nvd3 nv-wrap nv-indentedtree');
-      var tableEnter = wrapEnter.append('table');
-      var table = wrap.select('table').attr('width', '100%').attr('class', tableClass);
-
-      //------------------------------------------------------------
-
-
-      if (header) {
-        var thead = tableEnter.append('thead');
-
-        var theadRow1 = thead.append('tr');
-
-        columns.forEach(function(column) {
-          theadRow1
-            .append('th')
-              .attr('width', column.width ? column.width : '10%')
-              .style('text-align', column.type == 'numeric' ? 'right' : 'left')
-            .append('span')
-              .text(column.label);
-        });
-      }
-
-
-      var tbody = table.selectAll('tbody')
-                    .data(function(d) { return d });
-      tbody.enter().append('tbody');
-
-
-
-      //compute max generations
-      depth = d3.max(nodes, function(node) { return node.depth });
-      tree.size([height, depth * childIndent]); //TODO: see if this is necessary at all
-
-
-      // Update the nodes…
-      var node = tbody.selectAll('tr')
-          // .data(function(d) { return d; }, function(d) { return d.id || (d.id == ++i)});
-          .data(function(d) { return d.filter(function(d) { return (filterZero && !d.children) ? filterZero(d) :  true; } )}, function(d,i) { return d.id || (d.id || ++idx)});
-          //.style('display', 'table-row'); //TODO: see if this does anything
-
-      node.exit().remove();
-
-      node.select('img.nv-treeicon')
-          .attr('src', icon)
-          .classed('folded', folded);
-
-      var nodeEnter = node.enter().append('tr');
-
-
-      columns.forEach(function(column, index) {
-
-        var nodeName = nodeEnter.append('td')
-            .style('padding-left', function(d) { return (index ? 0 : d.depth * childIndent + 12 + (icon(d) ? 0 : 16)) + 'px' }, 'important') //TODO: check why I did the ternary here
-            .style('text-align', column.type == 'numeric' ? 'right' : 'left');
-
-
-        if (index == 0) {
-          nodeName.append('img')
-              .classed('nv-treeicon', true)
-              .classed('nv-folded', folded)
-              .attr('src', icon)
-              .style('width', '14px')
-              .style('height', '14px')
-              .style('padding', '0 1px')
-              .style('display', function(d) { return icon(d) ? 'inline-block' : 'none'; })
-              .on('click', click);
-        }
-
-
-        nodeName.each(function(d) {
-          if (!index && getUrl(d))
-            d3.select(this)
-              .append('a')
-              .attr('href',getUrl)
-              .attr('class', d3.functor(column.classes))
-              .append('span')
-          else
-            d3.select(this)
-              .append('span')
-
-            d3.select(this).select('span')
-              .attr('class', d3.functor(column.classes) )
-              .text(function(d) { return column.format ? column.format(d) :
-                                        (d[column.key] || '-') });
-          });
-
-        if  (column.showCount) {
-          nodeName.append('span')
-              .attr('class', 'nv-childrenCount');
-
-          node.selectAll('span.nv-childrenCount').text(function(d) {
-                return ((d.values && d.values.length) || (d._values && d._values.length)) ?                                   //If this is a parent
-                    '(' + ((d.values && (d.values.filter(function(d) { return filterZero ? filterZero(d) :  true; }).length)) //If children are in values check its children and filter
-                    || (d._values && d._values.filter(function(d) { return filterZero ? filterZero(d) :  true; }).length)     //Otherwise, do the same, but with the other name, _values...
-                    || 0) + ')'                                                                                               //This is the catch-all in case there are no children after a filter
-                    : ''                                                                                                     //If this is not a parent, just give an empty string
-            });
-        }
-
-        // if (column.click)
-        //   nodeName.select('span').on('click', column.click);
-
-      });
-
-      node
-        .order()
-        .on('click', function(d) { 
-          dispatch.elementClick({
-            row: this, //TODO: decide whether or not this should be consistent with scatter/line events or should be an html link (a href)
-            data: d,
-            pos: [d.x, d.y]
-          });
-        })
-        .on('dblclick', function(d) { 
-          dispatch.elementDblclick({
-            row: this,
-            data: d,
-            pos: [d.x, d.y]
-          });
-        })
-        .on('mouseover', function(d) { 
-          dispatch.elementMouseover({
-            row: this,
-            data: d,
-            pos: [d.x, d.y]
-          });
-        })
-        .on('mouseout', function(d) { 
-          dispatch.elementMouseout({
-            row: this,
-            data: d,
-            pos: [d.x, d.y]
-          });
-        });
-
-
-
-
-      // Toggle children on click.
-      function click(d, _, unshift) {
-        d3.event.stopPropagation();
-
-        if(d3.event.shiftKey && !unshift) {
-          //If you shift-click, it'll toggle fold all the children, instead of itself
-          d3.event.shiftKey = false;
-          d.values && d.values.forEach(function(node){
-            if (node.values || node._values) {
-              click(node, 0, true);
-            }
-          });
-          return true;
-        }
-        if(!hasChildren(d)) {
-          //download file
-          //window.location.href = d.url;
-          return true;
-        }
-        if (d.values) {
-          d._values = d.values;
-          d.values = null;
-        } else {
-          d.values = d._values;
-          d._values = null;
-        }
-        chart.update();
-      }
-
-
-      function icon(d) {
-        return (d._values && d._values.length) ? iconOpen : (d.values && d.values.length) ? iconClose : '';
-      }
-
-      function folded(d) {
-        return (d._values && d._values.length);
-      }
-
-      function hasChildren(d) {
-        var values = d.values || d._values;
-
-        return (values && values.length);
-      }
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    scatter.color(color);
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.header = function(_) {
-    if (!arguments.length) return header;
-    header = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.filterZero = function(_) {
-    if (!arguments.length) return filterZero;
-    filterZero = _;
-    return chart;
-  };
-
-  chart.columns = function(_) {
-    if (!arguments.length) return columns;
-    columns = _;
-    return chart;
-  };
-
-  chart.tableClass = function(_) {
-    if (!arguments.length) return tableClass;
-    tableClass = _;
-    return chart;
-  };
-
-  chart.iconOpen = function(_){
-     if (!arguments.length) return iconOpen;
-    iconOpen = _;
-    return chart;
-  }
-
-  chart.iconClose = function(_){
-     if (!arguments.length) return iconClose;
-    iconClose = _;
-    return chart;
-  }
-
-  chart.getUrl = function(_){
-     if (!arguments.length) return getUrl;
-    getUrl = _;
-    return chart;
-  }
-
-  //============================================================
-
-
-  return chart;
-};nv.models.legend = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 5, right: 0, bottom: 5, left: 0}
-    , width = 400
-    , height = 20
-    , getKey = function(d) { return d.key }
-    , color = nv.utils.defaultColor()
-    , align = true
-    , rightAlign = true
-    , updateState = true   //If true, legend will update data.disabled and trigger a 'stateChange' dispatch.
-    , radioButtonMode = false   //If true, clicking legend items will cause it to behave like a radio button. (only one can be selected at a time)
-    , dispatch = d3.dispatch('legendClick', 'legendDblclick', 'legendMouseover', 'legendMouseout', 'stateChange')
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-legend').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-legend').append('g');
-      var g = wrap.select('g');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      var series = g.selectAll('.nv-series')
-          .data(function(d) { return d });
-      var seriesEnter = series.enter().append('g').attr('class', 'nv-series')
-          .on('mouseover', function(d,i) {
-            dispatch.legendMouseover(d,i);  //TODO: Make consistent with other event objects
-          })
-          .on('mouseout', function(d,i) {
-            dispatch.legendMouseout(d,i);
-          })
-          .on('click', function(d,i) {
-            dispatch.legendClick(d,i);
-            if (updateState) {
-               if (radioButtonMode) {
-                   //Radio button mode: set every series to disabled,
-                   //  and enable the clicked series.
-                   data.forEach(function(series) { series.disabled = true});
-                   d.disabled = false;
-               }
-               else {
-                   d.disabled = !d.disabled;
-                   if (data.every(function(series) { return series.disabled})) {
-                       //the default behavior of NVD3 legends is, if every single series
-                       // is disabled, turn all series' back on.
-                       data.forEach(function(series) { series.disabled = false});
-                   }
-               }
-               dispatch.stateChange({
-                  disabled: data.map(function(d) { return !!d.disabled })
-               });
-            }
-          })
-          .on('dblclick', function(d,i) {
-            dispatch.legendDblclick(d,i);
-            if (updateState) {
-                //the default behavior of NVD3 legends, when double clicking one,
-                // is to set all other series' to false, and make the double clicked series enabled.
-                data.forEach(function(series) {
-                   series.disabled = true;
-                });
-                d.disabled = false; 
-                dispatch.stateChange({
-                    disabled: data.map(function(d) { return !!d.disabled })
-                });
-            }
-          });
-      seriesEnter.append('circle')
-          .style('stroke-width', 2)
-          .attr('class','nv-legend-symbol')
-          .attr('r', 5);
-      seriesEnter.append('text')
-          .attr('text-anchor', 'start')
-          .attr('class','nv-legend-text')
-          .attr('dy', '.32em')
-          .attr('dx', '8');
-      series.classed('disabled', function(d) { return d.disabled });
-      series.exit().remove();
-      series.select('circle')
-          .style('fill', function(d,i) { return d.color || color(d,i)})
-          .style('stroke', function(d,i) { return d.color || color(d, i) });
-      series.select('text').text(getKey);
-
-
-      //TODO: implement fixed-width and max-width options (max-width is especially useful with the align option)
-
-      // NEW ALIGNING CODE, TODO: clean up
-      if (align) {
-
-        var seriesWidths = [];
-        series.each(function(d,i) {
-              var legendText = d3.select(this).select('text');
-              var nodeTextLength;
-              try {
-                nodeTextLength = legendText.node().getComputedTextLength();
-              }
-              catch(e) {
-                nodeTextLength = nv.utils.calcApproxTextWidth(legendText);
-              }
-             
-              seriesWidths.push(nodeTextLength + 28); // 28 is ~ the width of the circle plus some padding
-            });
-
-        var seriesPerRow = 0;
-        var legendWidth = 0;
-        var columnWidths = [];
-
-        while ( legendWidth < availableWidth && seriesPerRow < seriesWidths.length) {
-          columnWidths[seriesPerRow] = seriesWidths[seriesPerRow];
-          legendWidth += seriesWidths[seriesPerRow++];
-        }
-        if (seriesPerRow === 0) seriesPerRow = 1; //minimum of one series per row
-
-
-        while ( legendWidth > availableWidth && seriesPerRow > 1 ) {
-          columnWidths = [];
-          seriesPerRow--;
-
-          for (var k = 0; k < seriesWidths.length; k++) {
-            if (seriesWidths[k] > (columnWidths[k % seriesPerRow] || 0) )
-              columnWidths[k % seriesPerRow] = seriesWidths[k];
-          }
-
-          legendWidth = columnWidths.reduce(function(prev, cur, index, array) {
-                          return prev + cur;
-                        });
-        }
-
-        var xPositions = [];
-        for (var i = 0, curX = 0; i < seriesPerRow; i++) {
-            xPositions[i] = curX;
-            curX += columnWidths[i];
-        }
-
-        series
-            .attr('transform', function(d, i) {
-              return 'translate(' + xPositions[i % seriesPerRow] + ',' + (5 + Math.floor(i / seriesPerRow) * 20) + ')';
-            });
-
-        //position legend as far right as possible within the total width
-        if (rightAlign) {
-           g.attr('transform', 'translate(' + (width - margin.right - legendWidth) + ',' + margin.top + ')');
-        }
-        else {
-           g.attr('transform', 'translate(0' + ',' + margin.top + ')');
-        }
-
-        height = margin.top + margin.bottom + (Math.ceil(seriesWidths.length / seriesPerRow) * 20);
-
-      } else {
-
-        var ypos = 5,
-            newxpos = 5,
-            maxwidth = 0,
-            xpos;
-        series
-            .attr('transform', function(d, i) {
-              var length = d3.select(this).select('text').node().getComputedTextLength() + 28;
-              xpos = newxpos;
-
-              if (width < margin.left + margin.right + xpos + length) {
-                newxpos = xpos = 5;
-                ypos += 20;
-              }
-
-              newxpos += length;
-              if (newxpos > maxwidth) maxwidth = newxpos;
-
-              return 'translate(' + xpos + ',' + ypos + ')';
-            });
-
-        //position legend as far right as possible within the total width
-        g.attr('transform', 'translate(' + (width - margin.right - maxwidth) + ',' + margin.top + ')');
-
-        height = margin.top + margin.bottom + ypos + 15;
-
-      }
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.key = function(_) {
-    if (!arguments.length) return getKey;
-    getKey = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.align = function(_) {
-    if (!arguments.length) return align;
-    align = _;
-    return chart;
-  };
-
-  chart.rightAlign = function(_) {
-    if (!arguments.length) return rightAlign;
-    rightAlign = _;
-    return chart;
-  };
-
-  chart.updateState = function(_) {
-    if (!arguments.length) return updateState;
-    updateState = _;
-    return chart;
-  };
-
-  chart.radioButtonMode = function(_) {
-    if (!arguments.length) return radioButtonMode;
-    radioButtonMode = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.line = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var  scatter = nv.models.scatter()
-    ;
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , color = nv.utils.defaultColor() // a function that returns a color
-    , getX = function(d) { return d.x } // accessor to get the x value from a data point
-    , getY = function(d) { return d.y } // accessor to get the y value from a data point
-    , defined = function(d,i) { return !isNaN(getY(d,i)) && getY(d,i) !== null } // allows a line to be not continuous when it is not defined
-    , isArea = function(d) { return d.area } // decides if a line is an area or just a line
-    , clipEdge = false // if true, masks lines within x and y scale
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , interpolate = "linear" // controls the line interpolation
-    ;
-
-  scatter
-    .size(16) // default size
-    .sizeDomain([16,256]) //set to speed up calculation, needs to be unset if there is a custom size accessor
-    ;
-    
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0 //used to store previous scales
-      ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = scatter.xScale();
-      y = scatter.yScale();
-
-      x0 = x0 || x;
-      y0 = y0 || y;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-line').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-line');
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g')
-
-      gEnter.append('g').attr('class', 'nv-groups');
-      gEnter.append('g').attr('class', 'nv-scatterWrap');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-
-
-      scatter
-        .width(availableWidth)
-        .height(availableHeight)
-
-      var scatterWrap = wrap.select('.nv-scatterWrap');
-          //.datum(data); // Data automatically trickles down from the wrap
-
-      scatterWrap.transition().call(scatter);
-
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-edge-clip-' + scatter.id())
-        .append('rect');
-
-      wrap.select('#nv-edge-clip-' + scatter.id() + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + scatter.id() + ')' : '');
-      scatterWrap
-          .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + scatter.id() + ')' : '');
-
-
-
-
-      var groups = wrap.select('.nv-groups').selectAll('.nv-group')
-          .data(function(d) { return d }, function(d) { return d.key });
-      groups.enter().append('g')
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6);
-      groups.exit()
-          .transition()
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6)
-          .remove();
-      groups
-          .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
-          .classed('hover', function(d) { return d.hover })
-          .style('fill', function(d,i){ return color(d, i) })
-          .style('stroke', function(d,i){ return color(d, i)});
-      groups
-          .transition()
-          .style('stroke-opacity', 1)
-          .style('fill-opacity', .5);
-
-
-
-      var areaPaths = groups.selectAll('path.nv-area')
-          .data(function(d) { return isArea(d) ? [d] : [] }); // this is done differently than lines because I need to check if series is an area
-      areaPaths.enter().append('path')
-          .attr('class', 'nv-area')
-          .attr('d', function(d) {
-            return d3.svg.area()
-                .interpolate(interpolate)
-                .defined(defined)
-                .x(function(d,i) { return nv.utils.NaNtoZero(x0(getX(d,i))) })
-                .y0(function(d,i) { return nv.utils.NaNtoZero(y0(getY(d,i))) })
-                .y1(function(d,i) { return y0( y.domain()[0] <= 0 ? y.domain()[1] >= 0 ? 0 : y.domain()[1] : y.domain()[0] ) })
-                //.y1(function(d,i) { return y0(0) }) //assuming 0 is within y domain.. may need to tweak this
-                .apply(this, [d.values])
-          });
-      groups.exit().selectAll('path.nv-area')
-           .remove();
-           
-      areaPaths
-          .transition()
-          .attr('d', function(d) {
-            return d3.svg.area()
-                .interpolate(interpolate)
-                .defined(defined)
-                .x(function(d,i) { return nv.utils.NaNtoZero(x(getX(d,i))) })
-                .y0(function(d,i) { return nv.utils.NaNtoZero(y(getY(d,i))) })
-                .y1(function(d,i) { return y( y.domain()[0] <= 0 ? y.domain()[1] >= 0 ? 0 : y.domain()[1] : y.domain()[0] ) })
-                //.y1(function(d,i) { return y0(0) }) //assuming 0 is within y domain.. may need to tweak this
-                .apply(this, [d.values])
-          });
-
-
-
-      var linePaths = groups.selectAll('path.nv-line')
-          .data(function(d) { return [d.values] });
-      linePaths.enter().append('path')
-          .attr('class', 'nv-line')
-          .attr('d',
-            d3.svg.line()
-              .interpolate(interpolate)
-              .defined(defined)
-              .x(function(d,i) { return nv.utils.NaNtoZero(x0(getX(d,i))) })
-              .y(function(d,i) { return nv.utils.NaNtoZero(y0(getY(d,i))) })
-          );
-      groups.exit().selectAll('path.nv-line')
-          .transition()
-          .attr('d',
-            d3.svg.line()
-              .interpolate(interpolate)
-              .defined(defined)
-              .x(function(d,i) { return nv.utils.NaNtoZero(x(getX(d,i))) })
-              .y(function(d,i) { return nv.utils.NaNtoZero(y(getY(d,i))) })
-          );
-      linePaths
-          .transition()
-          .attr('d',
-            d3.svg.line()
-              .interpolate(interpolate)
-              .defined(defined)
-              .x(function(d,i) { return nv.utils.NaNtoZero(x(getX(d,i))) })
-              .y(function(d,i) { return nv.utils.NaNtoZero(y(getY(d,i))) })
-          );
-
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = scatter.dispatch;
-  chart.scatter = scatter;
-
-  d3.rebind(chart, scatter, 'id', 'interactive', 'size', 'xScale', 'yScale', 'zScale', 'xDomain', 'yDomain', 'xRange', 'yRange', 
-    'sizeDomain', 'forceX', 'forceY', 'forceSize', 'clipVoronoi', 'useVoronoi', 'clipRadius', 'padData','highlightPoint','clearHighlights');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    scatter.x(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    scatter.y(_);
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    scatter.color(color);
-    return chart;
-  };
-
-  chart.interpolate = function(_) {
-    if (!arguments.length) return interpolate;
-    interpolate = _;
-    return chart;
-  };
-
-  chart.defined = function(_) {
-    if (!arguments.length) return defined;
-    defined = _;
-    return chart;
-  };
-
-  chart.isArea = function(_) {
-    if (!arguments.length) return isArea;
-    isArea = d3.functor(_);
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.lineChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var lines = nv.models.line()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend()
-    , interactiveLayer = nv.interactiveGuideline()
-    ;
-
-  var margin = {top: 30, right: 20, bottom: 50, left: 60}
-    , color = nv.utils.defaultColor()
-    , width = null
-    , height = null
-    , showLegend = true
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , useInteractiveGuideline = false
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>'
-      }
-    , x
-    , y
-    , state = {}
-    , defaultState = null
-    , noData = 'No Data Available.'
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , transitionDuration = 250
-    ;
-
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(lines.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(lines.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, null, null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-    
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display noData message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = lines.xScale();
-      y = lines.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-lineChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-lineChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append("rect").style("opacity",0);
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-linesWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-interactive');
-
-      g.select("rect").attr("width",availableWidth).attr("height",availableHeight);
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth);
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        wrap.select('.nv-legendWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-      }
-
-      //------------------------------------------------------------
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      
-      //------------------------------------------------------------
-      //Set up interactive layer
-      if (useInteractiveGuideline) {
-        interactiveLayer
-           .width(availableWidth)
-           .height(availableHeight)
-           .margin({left:margin.left, top:margin.top})
-           .svgContainer(container)
-           .xScale(x);
-        wrap.select(".nv-interactive").call(interactiveLayer);
-      }
-
-
-      lines
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled }));
-
-
-      var linesWrap = g.select('.nv-linesWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      linesWrap.transition().call(lines);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-        xAxis
-          .scale(x)
-          .ticks( availableWidth / 100 )
-          .tickSize(-availableHeight, 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')');
-        g.select('.nv-x.nv-axis')
-            .transition()
-            .call(xAxis);
-      }
-
-      if (showYAxis) {
-        yAxis
-          .scale(y)
-          .ticks( availableHeight / 36 )
-          .tickSize( -availableWidth, 0);
-
-        g.select('.nv-y.nv-axis')
-            .transition()
-            .call(yAxis);
-      }
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) {
-          state = newState;
-          dispatch.stateChange(state);
-          chart.update();
-      });
-
-      interactiveLayer.dispatch.on('elementMousemove', function(e) {
-          lines.clearHighlights();
-          var singlePoint, pointIndex, pointXLocation, allData = [];
-          data
-          .filter(function(series, i) { 
-            series.seriesIndex = i;
-            return !series.disabled; 
-          })
-          .forEach(function(series,i) {
-              pointIndex = nv.interactiveBisect(series.values, e.pointXValue, chart.x());
-              lines.highlightPoint(i, pointIndex, true);
-              var point = series.values[pointIndex];
-              if (typeof point === 'undefined') return;
-              if (typeof singlePoint === 'undefined') singlePoint = point;
-              if (typeof pointXLocation === 'undefined') pointXLocation = chart.xScale()(chart.x()(point,pointIndex));
-              allData.push({
-                  key: series.key,
-                  value: chart.y()(point, pointIndex),
-                  color: color(series,series.seriesIndex)
-              });
-          });
-          //Highlight the tooltip entry based on which point the mouse is closest to.
-          if (allData.length > 2) {
-            var yValue = chart.yScale().invert(e.mouseY);
-            var yDistMax = Infinity, indexToHighlight = null;
-            allData.forEach(function(series,i) {
-               var delta = Math.abs(yValue - series.value);
-               if ( delta < yDistMax) {
-                  yDistMax = delta;
-                  indexToHighlight = i;
-               }
-            });
-            allData[indexToHighlight].highlight = true;
-          }
-
-          var xValue = xAxis.tickFormat()(chart.x()(singlePoint,pointIndex));
-          interactiveLayer.tooltip
-                  .position({left: pointXLocation + margin.left, top: e.mouseY + margin.top})
-                  .chartContainer(that.parentNode)
-                  .enabled(tooltips)
-                  .valueFormatter(function(d,i) {
-                     return yAxis.tickFormat()(d);
-                  })
-                  .data(
-                      {
-                        value: xValue,
-                        series: allData
-                      }
-                  )();
-
-          interactiveLayer.renderGuideLine(pointXLocation);
-
-      });
-
-      interactiveLayer.dispatch.on("elementMouseout",function(e) {
-          dispatch.tooltipHide();
-          lines.clearHighlights();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.lines = lines;
-  chart.legend = legend;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.interactiveLayer = interactiveLayer;
-
-  d3.rebind(chart, lines, 'defined', 'isArea', 'x', 'y', 'size', 'xScale', 'yScale', 'xDomain', 'yDomain', 'xRange', 'yRange'
-    , 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi', 'useVoronoi','id', 'interpolate');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.useInteractiveGuideline = function(_) {
-    if(!arguments.length) return useInteractiveGuideline;
-    useInteractiveGuideline = _;
-    if (_ === true) {
-       chart.interactive(false);
-       chart.useVoronoi(false);
-    }
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.linePlusBarChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var lines = nv.models.line()
-    , bars = nv.models.historicalBar()
-    , xAxis = nv.models.axis()
-    , y1Axis = nv.models.axis()
-    , y2Axis = nv.models.axis()
-    , legend = nv.models.legend()
-    ;
-
-  var margin = {top: 30, right: 60, bottom: 50, left: 60}
-    , width = null
-    , height = null
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , color = nv.utils.defaultColor()
-    , showLegend = true
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>';
-      }
-    , x
-    , y1
-    , y2
-    , state = {}
-    , defaultState = null
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    ;
-
-  bars
-    .padData(true)
-    ;
-  lines
-    .clipEdge(false)
-    .padData(true)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    .highlightZero(false)
-    ;
-  y1Axis
-    .orient('left')
-    ;
-  y2Axis
-    .orient('right')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-      var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-          top = e.pos[1] + ( offsetElement.offsetTop || 0),
-          x = xAxis.tickFormat()(lines.x()(e.point, e.pointIndex)),
-          y = (e.series.bar ? y1Axis : y2Axis).tickFormat()(lines.y()(e.point, e.pointIndex)),
-          content = tooltip(e.series.key, x, y, e, chart);
-
-      nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-    }
-    ;
-
-  //------------------------------------------------------------
-
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().call(chart); };
-      // chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      var dataBars = data.filter(function(d) { return !d.disabled && d.bar });
-      var dataLines = data.filter(function(d) { return !d.bar }); // removed the !d.disabled clause here to fix Issue #240
-
-      //x = xAxis.scale();
-       x = dataLines.filter(function(d) { return !d.disabled; }).length && dataLines.filter(function(d) { return !d.disabled; })[0].values.length ? lines.xScale() : bars.xScale();
-      //x = dataLines.filter(function(d) { return !d.disabled; }).length ? lines.xScale() : bars.xScale(); //old code before change above
-      y1 = bars.yScale();
-      y2 = lines.yScale();
-
-      //------------------------------------------------------------
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = d3.select(this).selectAll('g.nv-wrap.nv-linePlusBar').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-linePlusBar').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y1 nv-axis');
-      gEnter.append('g').attr('class', 'nv-y2 nv-axis');
-      gEnter.append('g').attr('class', 'nv-barsWrap');
-      gEnter.append('g').attr('class', 'nv-linesWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width( availableWidth / 2 );
-
-        g.select('.nv-legendWrap')
-            .datum(data.map(function(series) {
-              series.originalKey = series.originalKey === undefined ? series.key : series.originalKey;
-              series.key = series.originalKey + (series.bar ? ' (left axis)' : ' (right axis)');
-              return series;
-            }))
-          .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + ( availableWidth / 2 ) + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-
-      lines
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && !data[i].bar }))
-
-      bars
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && data[i].bar }))
-
-
-
-      var barsWrap = g.select('.nv-barsWrap')
-          .datum(dataBars.length ? dataBars : [{values:[]}])
-
-      var linesWrap = g.select('.nv-linesWrap')
-          .datum(dataLines[0] && !dataLines[0].disabled ? dataLines : [{values:[]}] );
-          //.datum(!dataLines[0].disabled ? dataLines : [{values:dataLines[0].values.map(function(d) { return [d[0], null] }) }] );
-
-      d3.transition(barsWrap).call(bars);
-      d3.transition(linesWrap).call(lines);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      xAxis
-        .scale(x)
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight, 0);
-
-      g.select('.nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + y1.range()[0] + ')');
-      d3.transition(g.select('.nv-x.nv-axis'))
-          .call(xAxis);
-
-
-      y1Axis
-        .scale(y1)
-        .ticks( availableHeight / 36 )
-        .tickSize(-availableWidth, 0);
-
-      d3.transition(g.select('.nv-y1.nv-axis'))
-          .style('opacity', dataBars.length ? 1 : 0)
-          .call(y1Axis);
-
-
-      y2Axis
-        .scale(y2)
-        .ticks( availableHeight / 36 )
-        .tickSize(dataBars.length ? 0 : -availableWidth, 0); // Show the y2 rules only if y1 has none
-
-      g.select('.nv-y2.nv-axis')
-          .style('opacity', dataLines.length ? 1 : 0)
-          .attr('transform', 'translate(' + availableWidth + ',0)');
-          //.attr('transform', 'translate(' + x.range()[1] + ',0)');
-
-      d3.transition(g.select('.nv-y2.nv-axis'))
-          .call(y2Axis);
-
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        state = newState;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  bars.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  bars.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.legend = legend;
-  chart.lines = lines;
-  chart.bars = bars;
-  chart.xAxis = xAxis;
-  chart.y1Axis = y1Axis;
-  chart.y2Axis = y2Axis;
-
-  d3.rebind(chart, lines, 'defined', 'size', 'clipVoronoi', 'interpolate');
-  //TODO: consider rebinding x, y and some other stuff, and simply do soemthign lile bars.x(lines.x()), etc.
-  //d3.rebind(chart, lines, 'x', 'y', 'size', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi', 'id');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    lines.x(_);
-    bars.x(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    lines.y(_);
-    bars.y(_);
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-nv.models.lineWithFocusChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var lines = nv.models.line()
-    , lines2 = nv.models.line()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , x2Axis = nv.models.axis()
-    , y2Axis = nv.models.axis()
-    , legend = nv.models.legend()
-    , brush = d3.svg.brush()
-    ;
-
-  var margin = {top: 30, right: 30, bottom: 30, left: 60}
-    , margin2 = {top: 0, right: 30, bottom: 20, left: 60}
-    , color = nv.utils.defaultColor()
-    , width = null
-    , height = null
-    , height2 = 100
-    , x
-    , y
-    , x2
-    , y2
-    , showLegend = true
-    , brushExtent = null
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>'
-      }
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'brush')
-    , transitionDuration = 250
-    ;
-
-  lines
-    .clipEdge(true)
-    ;
-  lines2
-    .interactive(false)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(5)
-    ;
-  yAxis
-    .orient('left')
-    ;
-  x2Axis
-    .orient('bottom')
-    .tickPadding(5)
-    ;
-  y2Axis
-    .orient('left')
-    ;
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(lines.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(lines.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, null, null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight1 = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom - height2,
-          availableHeight2 = height2 - margin2.top - margin2.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight1 / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = lines.xScale();
-      y = lines.yScale();
-      x2 = lines2.xScale();
-      y2 = lines2.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-lineWithFocusChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-lineWithFocusChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-
-      var focusEnter = gEnter.append('g').attr('class', 'nv-focus');
-      focusEnter.append('g').attr('class', 'nv-x nv-axis');
-      focusEnter.append('g').attr('class', 'nv-y nv-axis');
-      focusEnter.append('g').attr('class', 'nv-linesWrap');
-
-      var contextEnter = gEnter.append('g').attr('class', 'nv-context');
-      contextEnter.append('g').attr('class', 'nv-x nv-axis');
-      contextEnter.append('g').attr('class', 'nv-y nv-axis');
-      contextEnter.append('g').attr('class', 'nv-linesWrap');
-      contextEnter.append('g').attr('class', 'nv-brushBackground');
-      contextEnter.append('g').attr('class', 'nv-x nv-brush');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth);
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight1 = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom - height2;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      lines
-        .width(availableWidth)
-        .height(availableHeight1)
-        .color(
-          data
-            .map(function(d,i) {
-              return d.color || color(d, i);
-            })
-            .filter(function(d,i) {
-              return !data[i].disabled;
-          })
-        );
-
-      lines2
-        .defined(lines.defined())
-        .width(availableWidth)
-        .height(availableHeight2)
-        .color(
-          data
-            .map(function(d,i) {
-              return d.color || color(d, i);
-            })
-            .filter(function(d,i) {
-              return !data[i].disabled;
-          })
-        );
-
-      g.select('.nv-context')
-          .attr('transform', 'translate(0,' + ( availableHeight1 + margin.bottom + margin2.top) + ')')
-
-      var contextLinesWrap = g.select('.nv-context .nv-linesWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      d3.transition(contextLinesWrap).call(lines2);
-
-      //------------------------------------------------------------
-
-
-      /*
-      var focusLinesWrap = g.select('.nv-focus .nv-linesWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      d3.transition(focusLinesWrap).call(lines);
-     */
-
-
-      //------------------------------------------------------------
-      // Setup Main (Focus) Axes
-
-      xAxis
-        .scale(x)
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight1, 0);
-
-      yAxis
-        .scale(y)
-        .ticks( availableHeight1 / 36 )
-        .tickSize( -availableWidth, 0);
-
-      g.select('.nv-focus .nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + availableHeight1 + ')');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Brush
-
-      brush
-        .x(x2)
-        .on('brush', function() {
-            //When brushing, turn off transitions because chart needs to change immediately.
-            var oldTransition = chart.transitionDuration();
-            chart.transitionDuration(0); 
-            onBrush();
-            chart.transitionDuration(oldTransition);
-        });
-
-      if (brushExtent) brush.extent(brushExtent);
-
-      var brushBG = g.select('.nv-brushBackground').selectAll('g')
-          .data([brushExtent || brush.extent()])
-
-      var brushBGenter = brushBG.enter()
-          .append('g');
-
-      brushBGenter.append('rect')
-          .attr('class', 'left')
-          .attr('x', 0)
-          .attr('y', 0)
-          .attr('height', availableHeight2);
-
-      brushBGenter.append('rect')
-          .attr('class', 'right')
-          .attr('x', 0)
-          .attr('y', 0)
-          .attr('height', availableHeight2);
-
-      var gBrush = g.select('.nv-x.nv-brush')
-          .call(brush);
-      gBrush.selectAll('rect')
-          //.attr('y', -5)
-          .attr('height', availableHeight2);
-      gBrush.selectAll('.resize').append('path').attr('d', resizePath);
-
-      onBrush();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Secondary (Context) Axes
-
-      x2Axis
-        .scale(x2)
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight2, 0);
-
-      g.select('.nv-context .nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + y2.range()[0] + ')');
-      d3.transition(g.select('.nv-context .nv-x.nv-axis'))
-          .call(x2Axis);
-
-
-      y2Axis
-        .scale(y2)
-        .ticks( availableHeight2 / 36 )
-        .tickSize( -availableWidth, 0);
-
-      d3.transition(g.select('.nv-context .nv-y.nv-axis'))
-          .call(y2Axis);
-
-      g.select('.nv-context .nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + y2.range()[0] + ')');
-
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      //============================================================
-
-
-      //============================================================
-      // Functions
-      //------------------------------------------------------------
-
-      // Taken from crossfilter (http://square.github.com/crossfilter/)
-      function resizePath(d) {
-        var e = +(d == 'e'),
-            x = e ? 1 : -1,
-            y = availableHeight2 / 3;
-        return 'M' + (.5 * x) + ',' + y
-            + 'A6,6 0 0 ' + e + ' ' + (6.5 * x) + ',' + (y + 6)
-            + 'V' + (2 * y - 6)
-            + 'A6,6 0 0 ' + e + ' ' + (.5 * x) + ',' + (2 * y)
-            + 'Z'
-            + 'M' + (2.5 * x) + ',' + (y + 8)
-            + 'V' + (2 * y - 8)
-            + 'M' + (4.5 * x) + ',' + (y + 8)
-            + 'V' + (2 * y - 8);
-      }
-
-
-      function updateBrushBG() {
-        if (!brush.empty()) brush.extent(brushExtent);
-        brushBG
-            .data([brush.empty() ? x2.domain() : brushExtent])
-            .each(function(d,i) {
-              var leftWidth = x2(d[0]) - x.range()[0],
-                  rightWidth = x.range()[1] - x2(d[1]);
-              d3.select(this).select('.left')
-                .attr('width',  leftWidth < 0 ? 0 : leftWidth);
-
-              d3.select(this).select('.right')
-                .attr('x', x2(d[1]))
-                .attr('width', rightWidth < 0 ? 0 : rightWidth);
-            });
-      }
-
-
-      function onBrush() {
-        brushExtent = brush.empty() ? null : brush.extent();
-        var extent = brush.empty() ? x2.domain() : brush.extent();
-
-        //The brush extent cannot be less than one.  If it is, don't update the line chart.
-        if (Math.abs(extent[0] - extent[1]) <= 1) {
-          return;
-        }
-
-        dispatch.brush({extent: extent, brush: brush});
-
-
-        updateBrushBG();
-
-        // Update Main (Focus)
-        var focusLinesWrap = g.select('.nv-focus .nv-linesWrap')
-            .datum(
-              data
-                .filter(function(d) { return !d.disabled })
-                .map(function(d,i) {
-                  return {
-                    key: d.key,
-                    values: d.values.filter(function(d,i) {
-                      return lines.x()(d,i) >= extent[0] && lines.x()(d,i) <= extent[1];
-                    })
-                  }
-                })
-            );
-        focusLinesWrap.transition().duration(transitionDuration).call(lines);
-
-
-        // Update Main (Focus) Axes
-        g.select('.nv-focus .nv-x.nv-axis').transition().duration(transitionDuration)
-            .call(xAxis);
-        g.select('.nv-focus .nv-y.nv-axis').transition().duration(transitionDuration)
-            .call(yAxis);
-      }
-
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.legend = legend;
-  chart.lines = lines;
-  chart.lines2 = lines2;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.x2Axis = x2Axis;
-  chart.y2Axis = y2Axis;
-
-  d3.rebind(chart, lines, 'defined', 'isArea', 'size', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi', 'id');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return lines.x;
-    lines.x(_);
-    lines2.x(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return lines.y;
-    lines.y(_);
-    lines2.y(_);
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.margin2 = function(_) {
-    if (!arguments.length) return margin2;
-    margin2 = _;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.height2 = function(_) {
-    if (!arguments.length) return height2;
-    height2 = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color =nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.interpolate = function(_) {
-    if (!arguments.length) return lines.interpolate();
-    lines.interpolate(_);
-    lines2.interpolate(_);
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  // Chart has multiple similar Axes, to prevent code duplication, probably need to link all axis functions manually like below
-  chart.xTickFormat = function(_) {
-    if (!arguments.length) return xAxis.tickFormat();
-    xAxis.tickFormat(_);
-    x2Axis.tickFormat(_);
-    return chart;
-  };
-
-  chart.yTickFormat = function(_) {
-    if (!arguments.length) return yAxis.tickFormat();
-    yAxis.tickFormat(_);
-    y2Axis.tickFormat(_);
-    return chart;
-  };
-  
-  chart.brushExtent = function(_) {
-    if (!arguments.length) return brushExtent;
-    brushExtent = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.linePlusBarWithFocusChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var lines = nv.models.line()
-    , lines2 = nv.models.line()
-    , bars = nv.models.historicalBar()
-    , bars2 = nv.models.historicalBar()
-    , xAxis = nv.models.axis()
-    , x2Axis = nv.models.axis()
-    , y1Axis = nv.models.axis()
-    , y2Axis = nv.models.axis()
-    , y3Axis = nv.models.axis()
-    , y4Axis = nv.models.axis()
-    , legend = nv.models.legend()
-    , brush = d3.svg.brush()
-    ;
-
-  var margin = {top: 30, right: 30, bottom: 30, left: 60}
-    , margin2 = {top: 0, right: 30, bottom: 20, left: 60}
-    , width = null
-    , height = null
-    , height2 = 100
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , color = nv.utils.defaultColor()
-    , showLegend = true
-    , extent
-    , brushExtent = null
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>';
-      }
-    , x
-    , x2
-    , y1
-    , y2
-    , y3
-    , y4
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'brush')
-    , transitionDuration = 0
-    ;
-
-  lines
-    .clipEdge(true)
-    ;
-  lines2
-    .interactive(false)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(5)
-    ;
-  y1Axis
-    .orient('left')
-    ;
-  y2Axis
-    .orient('right')
-    ;
-  x2Axis
-    .orient('bottom')
-    .tickPadding(5)
-    ;
-  y3Axis
-    .orient('left')
-    ;
-  y4Axis
-    .orient('right')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    if (extent) {
-        e.pointIndex += Math.ceil(extent[0]);
-    }
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(lines.x()(e.point, e.pointIndex)),
-        y = (e.series.bar ? y1Axis : y2Axis).tickFormat()(lines.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  //------------------------------------------------------------
-
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight1 = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom - height2,
-          availableHeight2 = height2 - margin2.top - margin2.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart); };
-      chart.container = this;
-
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight1 / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      var dataBars = data.filter(function(d) { return !d.disabled && d.bar });
-      var dataLines = data.filter(function(d) { return !d.bar }); // removed the !d.disabled clause here to fix Issue #240
-
-      x = bars.xScale();
-      x2 = x2Axis.scale();
-      y1 = bars.yScale();
-      y2 = lines.yScale();
-      y3 = bars2.yScale();
-      y4 = lines2.yScale();
-
-      var series1 = data
-        .filter(function(d) { return !d.disabled && d.bar })
-        .map(function(d) {
-          return d.values.map(function(d,i) {
-            return { x: getX(d,i), y: getY(d,i) }
-          })
-        });
-
-      var series2 = data
-        .filter(function(d) { return !d.disabled && !d.bar })
-        .map(function(d) {
-          return d.values.map(function(d,i) {
-            return { x: getX(d,i), y: getY(d,i) }
-          })
-        });
-
-      x   .range([0, availableWidth]);
-      
-      x2  .domain(d3.extent(d3.merge(series1.concat(series2)), function(d) { return d.x } ))
-          .range([0, availableWidth]);
-
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-linePlusBar').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-linePlusBar').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      
-      var focusEnter = gEnter.append('g').attr('class', 'nv-focus');
-      focusEnter.append('g').attr('class', 'nv-x nv-axis');
-      focusEnter.append('g').attr('class', 'nv-y1 nv-axis');
-      focusEnter.append('g').attr('class', 'nv-y2 nv-axis');
-      focusEnter.append('g').attr('class', 'nv-barsWrap');
-      focusEnter.append('g').attr('class', 'nv-linesWrap');
-
-      var contextEnter = gEnter.append('g').attr('class', 'nv-context');
-      contextEnter.append('g').attr('class', 'nv-x nv-axis');
-      contextEnter.append('g').attr('class', 'nv-y1 nv-axis');
-      contextEnter.append('g').attr('class', 'nv-y2 nv-axis');
-      contextEnter.append('g').attr('class', 'nv-barsWrap');
-      contextEnter.append('g').attr('class', 'nv-linesWrap');
-      contextEnter.append('g').attr('class', 'nv-brushBackground');
-      contextEnter.append('g').attr('class', 'nv-x nv-brush');
-
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width( availableWidth / 2 );
-
-        g.select('.nv-legendWrap')
-            .datum(data.map(function(series) {
-              series.originalKey = series.originalKey === undefined ? series.key : series.originalKey;
-              series.key = series.originalKey + (series.bar ? ' (left axis)' : ' (right axis)');
-              return series;
-            }))
-          .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight1 = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom - height2;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + ( availableWidth / 2 ) + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      //------------------------------------------------------------
-      // Context Components
-
-      bars2
-        .width(availableWidth)
-        .height(availableHeight2)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && data[i].bar }));
-
-      lines2
-        .width(availableWidth)
-        .height(availableHeight2)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && !data[i].bar }));
-        
-      var bars2Wrap = g.select('.nv-context .nv-barsWrap')
-          .datum(dataBars.length ? dataBars : [{values:[]}]);
-
-      var lines2Wrap = g.select('.nv-context .nv-linesWrap')
-          .datum(!dataLines[0].disabled ? dataLines : [{values:[]}]);
-          
-      g.select('.nv-context')
-          .attr('transform', 'translate(0,' + ( availableHeight1 + margin.bottom + margin2.top) + ')')
-
-      bars2Wrap.transition().call(bars2);
-      lines2Wrap.transition().call(lines2);
-
-      //------------------------------------------------------------
-
-
-
-      //------------------------------------------------------------
-      // Setup Brush
-
-      brush
-        .x(x2)
-        .on('brush', onBrush);
-
-      if (brushExtent) brush.extent(brushExtent);
-
-      var brushBG = g.select('.nv-brushBackground').selectAll('g')
-          .data([brushExtent || brush.extent()])
-
-      var brushBGenter = brushBG.enter()
-          .append('g');
-
-      brushBGenter.append('rect')
-          .attr('class', 'left')
-          .attr('x', 0)
-          .attr('y', 0)
-          .attr('height', availableHeight2);
-
-      brushBGenter.append('rect')
-          .attr('class', 'right')
-          .attr('x', 0)
-          .attr('y', 0)
-          .attr('height', availableHeight2);
-
-      var gBrush = g.select('.nv-x.nv-brush')
-          .call(brush);
-      gBrush.selectAll('rect')
-          //.attr('y', -5)
-          .attr('height', availableHeight2);
-      gBrush.selectAll('.resize').append('path').attr('d', resizePath);
-
-      //------------------------------------------------------------
-
-      //------------------------------------------------------------
-      // Setup Secondary (Context) Axes
-
-      x2Axis
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight2, 0);
-
-      g.select('.nv-context .nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + y3.range()[0] + ')');
-      g.select('.nv-context .nv-x.nv-axis').transition()
-          .call(x2Axis);
-
-
-      y3Axis
-        .scale(y3)
-        .ticks( availableHeight2 / 36 )
-        .tickSize( -availableWidth, 0);
-
-      g.select('.nv-context .nv-y1.nv-axis')
-          .style('opacity', dataBars.length ? 1 : 0)
-          .attr('transform', 'translate(0,' + x2.range()[0] + ')');
-          
-      g.select('.nv-context .nv-y1.nv-axis').transition()
-          .call(y3Axis);
-          
-
-      y4Axis
-        .scale(y4)
-        .ticks( availableHeight2 / 36 )
-        .tickSize(dataBars.length ? 0 : -availableWidth, 0); // Show the y2 rules only if y1 has none
-
-      g.select('.nv-context .nv-y2.nv-axis')
-          .style('opacity', dataLines.length ? 1 : 0)
-          .attr('transform', 'translate(' + x2.range()[1] + ',0)');
-
-      g.select('.nv-context .nv-y2.nv-axis').transition()
-          .call(y4Axis);
-          
-      //------------------------------------------------------------
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      //============================================================
-
-
-      //============================================================
-      // Functions
-      //------------------------------------------------------------
-
-      // Taken from crossfilter (http://square.github.com/crossfilter/)
-      function resizePath(d) {
-        var e = +(d == 'e'),
-            x = e ? 1 : -1,
-            y = availableHeight2 / 3;
-        return 'M' + (.5 * x) + ',' + y
-            + 'A6,6 0 0 ' + e + ' ' + (6.5 * x) + ',' + (y + 6)
-            + 'V' + (2 * y - 6)
-            + 'A6,6 0 0 ' + e + ' ' + (.5 * x) + ',' + (2 * y)
-            + 'Z'
-            + 'M' + (2.5 * x) + ',' + (y + 8)
-            + 'V' + (2 * y - 8)
-            + 'M' + (4.5 * x) + ',' + (y + 8)
-            + 'V' + (2 * y - 8);
-      }
-
-
-      function updateBrushBG() {
-        if (!brush.empty()) brush.extent(brushExtent);
-        brushBG
-            .data([brush.empty() ? x2.domain() : brushExtent])
-            .each(function(d,i) {
-              var leftWidth = x2(d[0]) - x2.range()[0],
-                  rightWidth = x2.range()[1] - x2(d[1]);
-              d3.select(this).select('.left')
-                .attr('width',  leftWidth < 0 ? 0 : leftWidth);
-
-              d3.select(this).select('.right')
-                .attr('x', x2(d[1]))
-                .attr('width', rightWidth < 0 ? 0 : rightWidth);
-            });
-      }
-
-
-      function onBrush() {
-        brushExtent = brush.empty() ? null : brush.extent();
-        extent = brush.empty() ? x2.domain() : brush.extent();
-
-
-        dispatch.brush({extent: extent, brush: brush});
-
-        updateBrushBG();
-
-
-        //------------------------------------------------------------
-        // Prepare Main (Focus) Bars and Lines
-        
-        bars
-        .width(availableWidth)
-        .height(availableHeight1)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && data[i].bar }));
-
-
-        lines
-        .width(availableWidth)
-        .height(availableHeight1)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled && !data[i].bar }));
-
-        var focusBarsWrap = g.select('.nv-focus .nv-barsWrap')
-            .datum(!dataBars.length ? [{values:[]}] :
-              dataBars
-                .map(function(d,i) {
-                  return {
-                    key: d.key,
-                    values: d.values.filter(function(d,i) {
-                      return bars.x()(d,i) >= extent[0] && bars.x()(d,i) <= extent[1];
-                    })
-                  }
-                })
-            );
-        
-        var focusLinesWrap = g.select('.nv-focus .nv-linesWrap')
-            .datum(dataLines[0].disabled ? [{values:[]}] :
-              dataLines
-                .map(function(d,i) {
-                  return {
-                    key: d.key,
-                    values: d.values.filter(function(d,i) {
-                      return lines.x()(d,i) >= extent[0] && lines.x()(d,i) <= extent[1];
-                    })
-                  }
-                })
-             );
-                 
-        //------------------------------------------------------------
-        
-        
-        //------------------------------------------------------------
-        // Update Main (Focus) X Axis
-
-        if (dataBars.length) {
-            x = bars.xScale();
-        } else {
-            x = lines.xScale();
-        }
-        
-        xAxis
-        .scale(x)
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight1, 0);
-
-        xAxis.domain([Math.ceil(extent[0]), Math.floor(extent[1])]);
-        
-        g.select('.nv-x.nv-axis').transition().duration(transitionDuration)
-          .call(xAxis);
-        //------------------------------------------------------------
-        
-        
-        //------------------------------------------------------------
-        // Update Main (Focus) Bars and Lines
-
-        focusBarsWrap.transition().duration(transitionDuration).call(bars);
-        focusLinesWrap.transition().duration(transitionDuration).call(lines);
-        
-        //------------------------------------------------------------
-        
-          
-        //------------------------------------------------------------
-        // Setup and Update Main (Focus) Y Axes
-        
-        g.select('.nv-focus .nv-x.nv-axis')
-          .attr('transform', 'translate(0,' + y1.range()[0] + ')');
-
-
-        y1Axis
-        .scale(y1)
-        .ticks( availableHeight1 / 36 )
-        .tickSize(-availableWidth, 0);
-
-        g.select('.nv-focus .nv-y1.nv-axis')
-          .style('opacity', dataBars.length ? 1 : 0);
-
-
-        y2Axis
-        .scale(y2)
-        .ticks( availableHeight1 / 36 )
-        .tickSize(dataBars.length ? 0 : -availableWidth, 0); // Show the y2 rules only if y1 has none
-
-        g.select('.nv-focus .nv-y2.nv-axis')
-          .style('opacity', dataLines.length ? 1 : 0)
-          .attr('transform', 'translate(' + x.range()[1] + ',0)');
-
-        g.select('.nv-focus .nv-y1.nv-axis').transition().duration(transitionDuration)
-            .call(y1Axis);
-        g.select('.nv-focus .nv-y2.nv-axis').transition().duration(transitionDuration)
-            .call(y2Axis);
-      }
-
-      //============================================================
-
-      onBrush();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  bars.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  bars.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.legend = legend;
-  chart.lines = lines;
-  chart.lines2 = lines2;
-  chart.bars = bars;
-  chart.bars2 = bars2;
-  chart.xAxis = xAxis;
-  chart.x2Axis = x2Axis;
-  chart.y1Axis = y1Axis;
-  chart.y2Axis = y2Axis;
-  chart.y3Axis = y3Axis;
-  chart.y4Axis = y4Axis;
-
-  d3.rebind(chart, lines, 'defined', 'size', 'clipVoronoi', 'interpolate');
-  //TODO: consider rebinding x, y and some other stuff, and simply do soemthign lile bars.x(lines.x()), etc.
-  //d3.rebind(chart, lines, 'x', 'y', 'size', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'interactive', 'clipEdge', 'clipVoronoi', 'id');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    lines.x(_);
-    bars.x(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    lines.y(_);
-    bars.y(_);
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.brushExtent = function(_) {
-    if (!arguments.length) return brushExtent;
-    brushExtent = _;
-    return chart;
-  };
-
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.multiBar = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , x = d3.scale.ordinal()
-    , y = d3.scale.linear()
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , forceY = [0] // 0 is forced by default.. this makes sense for the majority of bar graphs... user can always do chart.forceY([]) to remove
-    , clipEdge = true
-    , stacked = false
-    , color = nv.utils.defaultColor()
-    , hideable = false
-    , barColor = null // adding the ability to set the color for each rather than the whole group
-    , disabled // used in conjunction with barColor to communicate from multiBarHorizontalChart what series are disabled
-    , delay = 1200
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    , groupSpacing = 0.1
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0 //used to store previous scales
-      ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-      if(hideable && data.length) hideable = [{
-        values: data[0].values.map(function(d) {
-        return {
-          x: d.x,
-          y: 0,
-          series: d.series,
-          size: 0.01
-        };}
-      )}];
-
-      if (stacked)
-        data = d3.layout.stack()
-                 .offset('zero')
-                 .values(function(d){ return d.values })
-                 .y(getY)
-                 (!data.length && hideable ? hideable : data);
-
-
-      //add series index to each data point for reference
-      data = data.map(function(series, i) {
-        series.values = series.values.map(function(point) {
-          point.series = i;
-          return point;
-        });
-        return series;
-      });
-
-
-      //------------------------------------------------------------
-      // HACK for negative value stacking
-      if (stacked)
-        data[0].values.map(function(d,i) {
-          var posBase = 0, negBase = 0;
-          data.map(function(d) {
-            var f = d.values[i]
-            f.size = Math.abs(f.y);
-            if (f.y<0)  {
-              f.y1 = negBase;
-              negBase = negBase - f.size;
-            } else
-            { 
-              f.y1 = f.size + posBase;
-              posBase = posBase + f.size;
-            }
-          });
-        });
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      // remap and flatten the data for use in calculating the scales' domains
-      var seriesData = (xDomain && yDomain) ? [] : // if we know xDomain and yDomain, no need to calculate
-            data.map(function(d) {
-              return d.values.map(function(d,i) {
-                return { x: getX(d,i), y: getY(d,i), y0: d.y0, y1: d.y1 }
-              })
-            });
-
-      x   .domain(xDomain || d3.merge(seriesData).map(function(d) { return d.x }))
-          .rangeBands(xRange || [0, availableWidth], groupSpacing);
-
-      //y   .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return d.y + (stacked ? d.y1 : 0) }).concat(forceY)))
-      y   .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return stacked ? (d.y > 0 ? d.y1 : d.y1 + d.y ) : d.y }).concat(forceY)))
-          .range(yRange || [availableHeight, 0]);
-
-      // If scale's domain don't have a range, slightly adjust to make one... so a chart can show a single data point
-      if (x.domain()[0] === x.domain()[1])
-        x.domain()[0] ?
-            x.domain([x.domain()[0] - x.domain()[0] * 0.01, x.domain()[1] + x.domain()[1] * 0.01])
-          : x.domain([-1,1]);
-
-      if (y.domain()[0] === y.domain()[1])
-        y.domain()[0] ?
-            y.domain([y.domain()[0] + y.domain()[0] * 0.01, y.domain()[1] - y.domain()[1] * 0.01])
-          : y.domain([-1,1]);
-
-
-      x0 = x0 || x;
-      y0 = y0 || y;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-multibar').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-multibar');
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g')
-
-      gEnter.append('g').attr('class', 'nv-groups');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-edge-clip-' + id)
-        .append('rect');
-      wrap.select('#nv-edge-clip-' + id + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + id + ')' : '');
-
-
-
-      var groups = wrap.select('.nv-groups').selectAll('.nv-group')
-          .data(function(d) { return d }, function(d,i) { return i });
-      groups.enter().append('g')
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6);
-      groups.exit()
-        .transition()
-        .selectAll('rect.nv-bar')
-        .delay(function(d,i) { 
-             return i * delay/ data[0].values.length;
-        })
-          .attr('y', function(d) { return stacked ? y0(d.y0) : y0(0) })
-          .attr('height', 0)
-          .remove();
-      groups
-          .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
-          .classed('hover', function(d) { return d.hover })
-          .style('fill', function(d,i){ return color(d, i) })
-          .style('stroke', function(d,i){ return color(d, i) });
-      groups
-          .transition()
-          .style('stroke-opacity', 1)
-          .style('fill-opacity', .75);
-
-
-      var bars = groups.selectAll('rect.nv-bar')
-          .data(function(d) { return (hideable && !data.length) ? hideable.values : d.values });
-
-      bars.exit().remove();
-
-
-      var barsEnter = bars.enter().append('rect')
-          .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive'})
-          .attr('x', function(d,i,j) {
-              return stacked ? 0 : (j * x.rangeBand() / data.length )
-          })
-          .attr('y', function(d) { return y0(stacked ? d.y0 : 0) })
-          .attr('height', 0)
-          .attr('width', x.rangeBand() / (stacked ? 1 : data.length) )
-          .attr('transform', function(d,i) { return 'translate(' + x(getX(d,i)) + ',0)'; })
-          ;
-      bars
-          .style('fill', function(d,i,j){ return color(d, j, i);  })
-          .style('stroke', function(d,i,j){ return color(d, j, i); })
-          .on('mouseover', function(d,i) { //TODO: figure out why j works above, but not here
-            d3.select(this).classed('hover', true);
-            dispatch.elementMouseover({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('mouseout', function(d,i) {
-            d3.select(this).classed('hover', false);
-            dispatch.elementMouseout({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('click', function(d,i) {
-            dispatch.elementClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          })
-          .on('dblclick', function(d,i) {
-            dispatch.elementDblClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          });
-      bars
-          .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive'})
-          .transition()
-          .attr('transform', function(d,i) { return 'translate(' + x(getX(d,i)) + ',0)'; })
-
-      if (barColor) {
-        if (!disabled) disabled = data.map(function() { return true });
-        bars
-          .style('fill', function(d,i,j) { return d3.rgb(barColor(d,i)).darker(  disabled.map(function(d,i) { return i }).filter(function(d,i){ return !disabled[i]  })[j]   ).toString(); })
-          .style('stroke', function(d,i,j) { return d3.rgb(barColor(d,i)).darker(  disabled.map(function(d,i) { return i }).filter(function(d,i){ return !disabled[i]  })[j]   ).toString(); });
-      }
-
-
-      if (stacked)
-          bars.transition()
-            .delay(function(d,i) { 
-
-                  return i * delay / data[0].values.length;
-            })
-            .attr('y', function(d,i) {
-
-              return y((stacked ? d.y1 : 0));
-            })
-            .attr('height', function(d,i) {
-              return Math.max(Math.abs(y(d.y + (stacked ? d.y0 : 0)) - y((stacked ? d.y0 : 0))),1);
-            })
-            .attr('x', function(d,i) {
-                  return stacked ? 0 : (d.series * x.rangeBand() / data.length )
-            })
-            .attr('width', x.rangeBand() / (stacked ? 1 : data.length) );
-      else
-          bars.transition()
-            .delay(function(d,i) { 
-                return i * delay/ data[0].values.length;
-            })
-            .attr('x', function(d,i) {
-              return d.series * x.rangeBand() / data.length
-            })
-            .attr('width', x.rangeBand() / data.length)
-            .attr('y', function(d,i) {
-                return getY(d,i) < 0 ?
-                        y(0) :
-                        y(0) - y(getY(d,i)) < 1 ?
-                          y(0) - 1 :
-                        y(getY(d,i)) || 0;
-            })
-            .attr('height', function(d,i) {
-                return Math.max(Math.abs(y(getY(d,i)) - y(0)),1) || 0;
-            });
-
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.stacked = function(_) {
-    if (!arguments.length) return stacked;
-    stacked = _;
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.barColor = function(_) {
-    if (!arguments.length) return barColor;
-    barColor = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.disabled = function(_) {
-    if (!arguments.length) return disabled;
-    disabled = _;
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.hideable = function(_) {
-    if (!arguments.length) return hideable;
-    hideable = _;
-    return chart;
-  };
-
-  chart.delay = function(_) {
-    if (!arguments.length) return delay;
-    delay = _;
-    return chart;
-  };
-
-  chart.groupSpacing = function(_) {
-    if (!arguments.length) return groupSpacing;
-    groupSpacing = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.multiBarChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var multibar = nv.models.multiBar()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend()
-    , controls = nv.models.legend()
-    ;
-
-  var margin = {top: 30, right: 20, bottom: 50, left: 60}
-    , width = null
-    , height = null
-    , color = nv.utils.defaultColor()
-    , showControls = true
-    , showLegend = true
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , reduceXTicks = true // if false a tick will show for every data point
-    , staggerLabels = false
-    , rotateLabels = 0
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' on ' + x + '</p>'
-      }
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , state = { stacked: false }
-    , defaultState = null
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , controlWidth = function() { return showControls ? 180 : 0 }
-    , transitionDuration = 250
-    ;
-
-  multibar
-    .stacked(false)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    .highlightZero(true)
-    .showMaxMin(false)
-    .tickFormat(function(d) { return d })
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    .tickFormat(d3.format(',.1f'))
-    ;
-
-  controls.updateState(false);
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(multibar.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(multibar.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-      //------------------------------------------------------------
-      // Display noData message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = multibar.xScale();
-      y = multibar.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-multiBarWithLegend').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-multiBarWithLegend').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-barsWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth - controlWidth());
-
-        if (multibar.barColor())
-          data.forEach(function(series,i) {
-            series.color = d3.rgb('#ccc').darker(i * 1.5).toString();
-          })
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + controlWidth() + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        var controlsData = [
-          { key: 'Grouped', disabled: multibar.stacked() },
-          { key: 'Stacked', disabled: !multibar.stacked() }
-        ];
-
-        controls.width(controlWidth()).color(['#444', '#444', '#444']);
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-            .call(controls);
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      multibar
-        .disabled(data.map(function(series) { return series.disabled }))
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled }))
-
-
-      var barsWrap = g.select('.nv-barsWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      barsWrap.transition().call(multibar);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-          xAxis
-            .scale(x)
-            .ticks( availableWidth / 100 )
-            .tickSize(-availableHeight, 0);
-
-          g.select('.nv-x.nv-axis')
-              .attr('transform', 'translate(0,' + y.range()[0] + ')');
-          g.select('.nv-x.nv-axis').transition()
-              .call(xAxis);
-
-          var xTicks = g.select('.nv-x.nv-axis > g').selectAll('g');
-
-          xTicks
-              .selectAll('line, text')
-              .style('opacity', 1)
-
-          if (staggerLabels) {
-              var getTranslate = function(x,y) {
-                  return "translate(" + x + "," + y + ")";
-              };
-
-              var staggerUp = 5, staggerDown = 17;  //pixels to stagger by
-              // Issue #140
-              xTicks
-                .selectAll("text")
-                .attr('transform', function(d,i,j) { 
-                    return  getTranslate(0, (j % 2 == 0 ? staggerUp : staggerDown));
-                  });
-
-              var totalInBetweenTicks = d3.selectAll(".nv-x.nv-axis .nv-wrap g g text")[0].length;
-              g.selectAll(".nv-x.nv-axis .nv-axisMaxMin text")
-                .attr("transform", function(d,i) {
-                    return getTranslate(0, (i === 0 || totalInBetweenTicks % 2 !== 0) ? staggerDown : staggerUp);
-                });
-          }
-
-          if (reduceXTicks)
-            xTicks
-              .filter(function(d,i) {
-                  return i % Math.ceil(data[0].values.length / (availableWidth / 100)) !== 0;
-                })
-              .selectAll('text, line')
-              .style('opacity', 0);
-
-          if(rotateLabels)
-            xTicks
-              .selectAll('.tick text')
-              .attr('transform', 'rotate(' + rotateLabels + ' 0,0)')
-              .style('text-anchor', rotateLabels > 0 ? 'start' : 'end');
-          
-          g.select('.nv-x.nv-axis').selectAll('g.nv-axisMaxMin text')
-              .style('opacity', 1);
-      }
-
-
-      if (showYAxis) {      
-          yAxis
-            .scale(y)
-            .ticks( availableHeight / 36 )
-            .tickSize( -availableWidth, 0);
-
-          g.select('.nv-y.nv-axis').transition()
-              .call(yAxis);
-      }
-
-
-      //------------------------------------------------------------
-
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        state = newState;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      controls.dispatch.on('legendClick', function(d,i) {
-        if (!d.disabled) return;
-        controlsData = controlsData.map(function(s) {
-          s.disabled = true;
-          return s;
-        });
-        d.disabled = false;
-
-        switch (d.key) {
-          case 'Grouped':
-            multibar.stacked(false);
-            break;
-          case 'Stacked':
-            multibar.stacked(true);
-            break;
-        }
-
-        state.stacked = multibar.stacked();
-        dispatch.stateChange(state);
-
-        chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode)
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        if (typeof e.stacked !== 'undefined') {
-          multibar.stacked(e.stacked);
-          state.stacked = e.stacked;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  multibar.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  multibar.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.multibar = multibar;
-  chart.legend = legend;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-
-  d3.rebind(chart, multibar, 'x', 'y', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'clipEdge',
-   'id', 'stacked', 'delay', 'barColor','groupSpacing');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.reduceXTicks= function(_) {
-    if (!arguments.length) return reduceXTicks;
-    reduceXTicks = _;
-    return chart;
-  };
-
-  chart.rotateLabels = function(_) {
-    if (!arguments.length) return rotateLabels;
-    rotateLabels = _;
-    return chart;
-  }
-
-  chart.staggerLabels = function(_) {
-    if (!arguments.length) return staggerLabels;
-    staggerLabels = _;
-    return chart;
-  };
-
-  chart.tooltip = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-  
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.multiBarHorizontal = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , x = d3.scale.ordinal()
-    , y = d3.scale.linear()
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , forceY = [0] // 0 is forced by default.. this makes sense for the majority of bar graphs... user can always do chart.forceY([]) to remove
-    , color = nv.utils.defaultColor()
-    , barColor = null // adding the ability to set the color for each rather than the whole group
-    , disabled // used in conjunction with barColor to communicate from multiBarHorizontalChart what series are disabled
-    , stacked = false
-    , showValues = false
-    , valuePadding = 60
-    , valueFormat = d3.format(',.2f')
-    , delay = 1200
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0 //used to store previous scales
-      ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-
-      if (stacked)
-        data = d3.layout.stack()
-                 .offset('zero')
-                 .values(function(d){ return d.values })
-                 .y(getY)
-                 (data);
-
-
-      //add series index to each data point for reference
-      data = data.map(function(series, i) {
-        series.values = series.values.map(function(point) {
-          point.series = i;
-          return point;
-        });
-        return series;
-      });
-
-
-
-      //------------------------------------------------------------
-      // HACK for negative value stacking
-      if (stacked)
-        data[0].values.map(function(d,i) {
-          var posBase = 0, negBase = 0;
-          data.map(function(d) {
-            var f = d.values[i]
-            f.size = Math.abs(f.y);
-            if (f.y<0)  {
-              f.y1 = negBase - f.size;
-              negBase = negBase - f.size;
-            } else
-            { 
-              f.y1 = posBase;
-              posBase = posBase + f.size;
-            }
-          });
-        });
-
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      // remap and flatten the data for use in calculating the scales' domains
-      var seriesData = (xDomain && yDomain) ? [] : // if we know xDomain and yDomain, no need to calculate
-            data.map(function(d) {
-              return d.values.map(function(d,i) {
-                return { x: getX(d,i), y: getY(d,i), y0: d.y0, y1: d.y1 }
-              })
-            });
-
-      x   .domain(xDomain || d3.merge(seriesData).map(function(d) { return d.x }))
-          .rangeBands(xRange || [0, availableHeight], .1);
-
-      //y   .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return d.y + (stacked ? d.y0 : 0) }).concat(forceY)))
-      y   .domain(yDomain || d3.extent(d3.merge(seriesData).map(function(d) { return stacked ? (d.y > 0 ? d.y1 + d.y : d.y1 ) : d.y }).concat(forceY)))
-
-      if (showValues && !stacked)
-        y.range(yRange || [(y.domain()[0] < 0 ? valuePadding : 0), availableWidth - (y.domain()[1] > 0 ? valuePadding : 0) ]);
-      else
-        y.range(yRange || [0, availableWidth]);
-
-      x0 = x0 || x;
-      y0 = y0 || d3.scale.linear().domain(y.domain()).range([y(0),y(0)]);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = d3.select(this).selectAll('g.nv-wrap.nv-multibarHorizontal').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-multibarHorizontal');
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-groups');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-
-      var groups = wrap.select('.nv-groups').selectAll('.nv-group')
-          .data(function(d) { return d }, function(d,i) { return i });
-      groups.enter().append('g')
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6);
-      groups.exit().transition()
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6)
-          .remove();
-      groups
-          .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
-          .classed('hover', function(d) { return d.hover })
-          .style('fill', function(d,i){ return color(d, i) })
-          .style('stroke', function(d,i){ return color(d, i) });
-      groups.transition()
-          .style('stroke-opacity', 1)
-          .style('fill-opacity', .75);
-
-
-      var bars = groups.selectAll('g.nv-bar')
-          .data(function(d) { return d.values });
-
-      bars.exit().remove();
-
-
-      var barsEnter = bars.enter().append('g')
-          .attr('transform', function(d,i,j) {
-              return 'translate(' + y0(stacked ? d.y0 : 0) + ',' + (stacked ? 0 : (j * x.rangeBand() / data.length ) + x(getX(d,i))) + ')'
-          });
-
-      barsEnter.append('rect')
-          .attr('width', 0)
-          .attr('height', x.rangeBand() / (stacked ? 1 : data.length) )
-
-      bars
-          .on('mouseover', function(d,i) { //TODO: figure out why j works above, but not here
-            d3.select(this).classed('hover', true);
-            dispatch.elementMouseover({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [ y(getY(d,i) + (stacked ? d.y0 : 0)), x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length) ],
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('mouseout', function(d,i) {
-            d3.select(this).classed('hover', false);
-            dispatch.elementMouseout({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-          })
-          .on('click', function(d,i) {
-            dispatch.elementClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          })
-          .on('dblclick', function(d,i) {
-            dispatch.elementDblClick({
-              value: getY(d,i),
-              point: d,
-              series: data[d.series],
-              pos: [x(getX(d,i)) + (x.rangeBand() * (stacked ? data.length / 2 : d.series + .5) / data.length), y(getY(d,i) + (stacked ? d.y0 : 0))],  // TODO: Figure out why the value appears to be shifted
-              pointIndex: i,
-              seriesIndex: d.series,
-              e: d3.event
-            });
-            d3.event.stopPropagation();
-          });
-
-
-      barsEnter.append('text');
-
-      if (showValues && !stacked) {
-        bars.select('text')
-            .attr('text-anchor', function(d,i) { return getY(d,i) < 0 ? 'end' : 'start' })
-            .attr('y', x.rangeBand() / (data.length * 2))
-            .attr('dy', '.32em')
-            .text(function(d,i) { return valueFormat(getY(d,i)) })
-        bars.transition()
-          .select('text')
-            .attr('x', function(d,i) { return getY(d,i) < 0 ? -4 : y(getY(d,i)) - y(0) + 4 })
-      } else {
-        bars.selectAll('text').text('');
-      }
-
-      bars
-          .attr('class', function(d,i) { return getY(d,i) < 0 ? 'nv-bar negative' : 'nv-bar positive'})
-
-      if (barColor) {
-        if (!disabled) disabled = data.map(function() { return true });
-        bars
-          .style('fill', function(d,i,j) { return d3.rgb(barColor(d,i)).darker(  disabled.map(function(d,i) { return i }).filter(function(d,i){ return !disabled[i]  })[j]   ).toString(); })
-          .style('stroke', function(d,i,j) { return d3.rgb(barColor(d,i)).darker(  disabled.map(function(d,i) { return i }).filter(function(d,i){ return !disabled[i]  })[j]   ).toString(); });
-      }
-
-      if (stacked)
-        bars.transition()
-            .attr('transform', function(d,i) {
-              return 'translate(' + y(d.y1) + ',' + x(getX(d,i)) + ')'
-            })
-          .select('rect')
-            .attr('width', function(d,i) {
-              return Math.abs(y(getY(d,i) + d.y0) - y(d.y0))
-            })
-            .attr('height', x.rangeBand() );
-      else
-        bars.transition()
-            .attr('transform', function(d,i) {
-              //TODO: stacked must be all positive or all negative, not both?
-              return 'translate(' + 
-              (getY(d,i) < 0 ? y(getY(d,i)) : y(0))
-              + ',' +
-              (d.series * x.rangeBand() / data.length
-              +
-              x(getX(d,i)) )
-              + ')'
-            })
-          .select('rect')
-            .attr('height', x.rangeBand() / data.length )
-            .attr('width', function(d,i) {
-              return Math.max(Math.abs(y(getY(d,i)) - y(0)),1)
-            });
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.stacked = function(_) {
-    if (!arguments.length) return stacked;
-    stacked = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.barColor = function(_) {
-    if (!arguments.length) return barColor;
-    barColor = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.disabled = function(_) {
-    if (!arguments.length) return disabled;
-    disabled = _;
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.delay = function(_) {
-    if (!arguments.length) return delay;
-    delay = _;
-    return chart;
-  };
-
-  chart.showValues = function(_) {
-    if (!arguments.length) return showValues;
-    showValues = _;
-    return chart;
-  };
-
-  chart.valueFormat= function(_) {
-    if (!arguments.length) return valueFormat;
-    valueFormat = _;
-    return chart;
-  };
-
-  chart.valuePadding = function(_) {
-    if (!arguments.length) return valuePadding;
-    valuePadding = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.multiBarHorizontalChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var multibar = nv.models.multiBarHorizontal()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend().height(30)
-    , controls = nv.models.legend().height(30)
-    ;
-
-  var margin = {top: 30, right: 20, bottom: 50, left: 60}
-    , width = null
-    , height = null
-    , color = nv.utils.defaultColor()
-    , showControls = true
-    , showLegend = true
-    , stacked = false
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + ' - ' + x + '</h3>' +
-               '<p>' +  y + '</p>'
-      }
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , state = { stacked: stacked }
-    , defaultState = null
-    , noData = 'No Data Available.'
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , controlWidth = function() { return showControls ? 180 : 0 }
-    , transitionDuration = 250
-    ;
-
-  multibar
-    .stacked(stacked)
-    ;
-  xAxis
-    .orient('left')
-    .tickPadding(5)
-    .highlightZero(false)
-    .showMaxMin(false)
-    .tickFormat(function(d) { return d })
-    ;
-  yAxis
-    .orient('bottom')
-    .tickFormat(d3.format(',.1f'))
-    ;
-
-  controls.updateState(false);
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(multibar.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(multibar.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'e' : 'w', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart) };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = multibar.xScale();
-      y = multibar.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-multiBarHorizontalChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-multiBarHorizontalChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-barsWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width(availableWidth - controlWidth());
-
-        if (multibar.barColor())
-          data.forEach(function(series,i) {
-            series.color = d3.rgb('#ccc').darker(i * 1.5).toString();
-          })
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + controlWidth() + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        var controlsData = [
-          { key: 'Grouped', disabled: multibar.stacked() },
-          { key: 'Stacked', disabled: !multibar.stacked() }
-        ];
-
-        controls.width(controlWidth()).color(['#444', '#444', '#444']);
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-            .call(controls);
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      multibar
-        .disabled(data.map(function(series) { return series.disabled }))
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color(d, i);
-        }).filter(function(d,i) { return !data[i].disabled }))
-
-
-      var barsWrap = g.select('.nv-barsWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-
-      barsWrap.transition().call(multibar);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      xAxis
-        .scale(x)
-        .ticks( availableHeight / 24 )
-        .tickSize(-availableWidth, 0);
-
-      g.select('.nv-x.nv-axis').transition()
-          .call(xAxis);
-
-      var xTicks = g.select('.nv-x.nv-axis').selectAll('g');
-
-      xTicks
-          .selectAll('line, text')
-          .style('opacity', 1)
-
-
-      yAxis
-        .scale(y)
-        .ticks( availableWidth / 100 )
-        .tickSize( -availableHeight, 0);
-
-      g.select('.nv-y.nv-axis')
-          .attr('transform', 'translate(0,' + availableHeight + ')');
-      g.select('.nv-y.nv-axis').transition()
-          .call(yAxis);
-
-      //------------------------------------------------------------
-
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        state = newState;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      controls.dispatch.on('legendClick', function(d,i) {
-        if (!d.disabled) return;
-        controlsData = controlsData.map(function(s) {
-          s.disabled = true;
-          return s;
-        });
-        d.disabled = false;
-
-        switch (d.key) {
-          case 'Grouped':
-            multibar.stacked(false);
-            break;
-          case 'Stacked':
-            multibar.stacked(true);
-            break;
-        }
-
-        state.stacked = multibar.stacked();
-        dispatch.stateChange(state);
-
-        chart.update();
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        if (typeof e.stacked !== 'undefined') {
-          multibar.stacked(e.stacked);
-          state.stacked = e.stacked;
-        }
-
-        selection.call(chart);
-      });
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  multibar.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  multibar.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.multibar = multibar;
-  chart.legend = legend;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-
-  d3.rebind(chart, multibar, 'x', 'y', 'xDomain', 'yDomain', 'xRange', 'yRange', 'forceX', 'forceY', 'clipEdge', 'id', 'delay', 'showValues', 'valueFormat', 'stacked', 'barColor');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    return chart;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltip = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-  //============================================================
-
-
-  return chart;
-}
-nv.models.multiChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 30, right: 20, bottom: 50, left: 60},
-      color = d3.scale.category20().range(),
-      width = null, 
-      height = null,
-      showLegend = true,
-      tooltips = true,
-      tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' at ' + x + '</p>'
-      },
-      x,
-      y,
-      yDomain1,
-      yDomain2
-      ; //can be accessed via chart.lines.[x/y]Scale()
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x = d3.scale.linear(),
-      yScale1 = d3.scale.linear(),
-      yScale2 = d3.scale.linear(),
-
-      lines1 = nv.models.line().yScale(yScale1),
-      lines2 = nv.models.line().yScale(yScale2),
-
-      bars1 = nv.models.multiBar().stacked(false).yScale(yScale1),
-      bars2 = nv.models.multiBar().stacked(false).yScale(yScale2),
-
-      stack1 = nv.models.stackedArea().yScale(yScale1),
-      stack2 = nv.models.stackedArea().yScale(yScale2),
-
-      xAxis = nv.models.axis().scale(x).orient('bottom').tickPadding(5),
-      yAxis1 = nv.models.axis().scale(yScale1).orient('left'),
-      yAxis2 = nv.models.axis().scale(yScale2).orient('right'),
-
-      legend = nv.models.legend().height(30),
-      dispatch = d3.dispatch('tooltipShow', 'tooltipHide');
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(lines1.x()(e.point, e.pointIndex)),
-        y = ((e.series.yAxis == 2) ? yAxis2 : yAxis1).tickFormat()(lines1.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, undefined, undefined, offsetElement.offsetParent);
-  };
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      chart.update = function() { container.transition().call(chart); };
-      chart.container = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      var dataLines1 = data.filter(function(d) {return !d.disabled && d.type == 'line' && d.yAxis == 1})
-      var dataLines2 = data.filter(function(d) {return !d.disabled && d.type == 'line' && d.yAxis == 2})
-      var dataBars1 = data.filter(function(d) {return !d.disabled && d.type == 'bar' && d.yAxis == 1})
-      var dataBars2 = data.filter(function(d) {return !d.disabled && d.type == 'bar' && d.yAxis == 2})
-      var dataStack1 = data.filter(function(d) {return !d.disabled && d.type == 'area' && d.yAxis == 1})
-      var dataStack2 = data.filter(function(d) {return !d.disabled && d.type == 'area' && d.yAxis == 2})
-
-      var series1 = data.filter(function(d) {return !d.disabled && d.yAxis == 1})
-            .map(function(d) {
-              return d.values.map(function(d,i) {
-                return { x: d.x, y: d.y }
-              })
-            })
-
-      var series2 = data.filter(function(d) {return !d.disabled && d.yAxis == 2})
-            .map(function(d) {
-              return d.values.map(function(d,i) {
-                return { x: d.x, y: d.y }
-              })
-            })
-
-      x   .domain(d3.extent(d3.merge(series1.concat(series2)), function(d) { return d.x } ))
-          .range([0, availableWidth]);
-
-      var wrap = container.selectAll('g.wrap.multiChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'wrap nvd3 multiChart').append('g');
-
-      gEnter.append('g').attr('class', 'x axis');
-      gEnter.append('g').attr('class', 'y1 axis');
-      gEnter.append('g').attr('class', 'y2 axis');
-      gEnter.append('g').attr('class', 'lines1Wrap');
-      gEnter.append('g').attr('class', 'lines2Wrap');
-      gEnter.append('g').attr('class', 'bars1Wrap');
-      gEnter.append('g').attr('class', 'bars2Wrap');
-      gEnter.append('g').attr('class', 'stack1Wrap');
-      gEnter.append('g').attr('class', 'stack2Wrap');
-      gEnter.append('g').attr('class', 'legendWrap');
-
-      var g = wrap.select('g');
-
-      if (showLegend) {
-        legend.width( availableWidth / 2 );
-
-        g.select('.legendWrap')
-            .datum(data.map(function(series) { 
-              series.originalKey = series.originalKey === undefined ? series.key : series.originalKey;
-              series.key = series.originalKey + (series.yAxis == 1 ? '' : ' (right axis)');
-              return series;
-            }))
-          .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.legendWrap')
-            .attr('transform', 'translate(' + ( availableWidth / 2 ) + ',' + (-margin.top) +')');
-      }
-
-
-      lines1
-        .width(availableWidth)
-        .height(availableHeight)
-        .interpolate("monotone")
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 1 && data[i].type == 'line'}));
-
-      lines2
-        .width(availableWidth)
-        .height(availableHeight)
-        .interpolate("monotone")
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 2 && data[i].type == 'line'}));
-
-      bars1
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 1 && data[i].type == 'bar'}));
-
-      bars2
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 2 && data[i].type == 'bar'}));
-
-      stack1
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 1 && data[i].type == 'area'}));
-
-      stack2
-        .width(availableWidth)
-        .height(availableHeight)
-        .color(data.map(function(d,i) {
-          return d.color || color[i % color.length];
-        }).filter(function(d,i) { return !data[i].disabled && data[i].yAxis == 2 && data[i].type == 'area'}));
-
-      g.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      var lines1Wrap = g.select('.lines1Wrap')
-          .datum(dataLines1)
-      var bars1Wrap = g.select('.bars1Wrap')
-          .datum(dataBars1)
-      var stack1Wrap = g.select('.stack1Wrap')
-          .datum(dataStack1)
-
-      var lines2Wrap = g.select('.lines2Wrap')
-          .datum(dataLines2)
-      var bars2Wrap = g.select('.bars2Wrap')
-          .datum(dataBars2)
-      var stack2Wrap = g.select('.stack2Wrap')
-          .datum(dataStack2)
-
-      var extraValue1 = dataStack1.length ? dataStack1.map(function(a){return a.values}).reduce(function(a,b){
-        return a.map(function(aVal,i){return {x: aVal.x, y: aVal.y + b[i].y}})
-      }).concat([{x:0, y:0}]) : []
-      var extraValue2 = dataStack2.length ? dataStack2.map(function(a){return a.values}).reduce(function(a,b){
-        return a.map(function(aVal,i){return {x: aVal.x, y: aVal.y + b[i].y}})
-      }).concat([{x:0, y:0}]) : []
-
-      yScale1 .domain(yDomain1 || d3.extent(d3.merge(series1).concat(extraValue1), function(d) { return d.y } ))
-              .range([0, availableHeight])
-
-      yScale2 .domain(yDomain2 || d3.extent(d3.merge(series2).concat(extraValue2), function(d) { return d.y } ))
-              .range([0, availableHeight])
-
-      lines1.yDomain(yScale1.domain())
-      bars1.yDomain(yScale1.domain())
-      stack1.yDomain(yScale1.domain())
-
-      lines2.yDomain(yScale2.domain())
-      bars2.yDomain(yScale2.domain())
-      stack2.yDomain(yScale2.domain())
-
-      if(dataStack1.length){d3.transition(stack1Wrap).call(stack1);}
-      if(dataStack2.length){d3.transition(stack2Wrap).call(stack2);}
-
-      if(dataBars1.length){d3.transition(bars1Wrap).call(bars1);}
-      if(dataBars2.length){d3.transition(bars2Wrap).call(bars2);}
-
-      if(dataLines1.length){d3.transition(lines1Wrap).call(lines1);}
-      if(dataLines2.length){d3.transition(lines2Wrap).call(lines2);}
-      
-
-
-      xAxis
-        .ticks( availableWidth / 100 )
-        .tickSize(-availableHeight, 0);
-
-      g.select('.x.axis')
-          .attr('transform', 'translate(0,' + availableHeight + ')');
-      d3.transition(g.select('.x.axis'))
-          .call(xAxis);
-
-      yAxis1
-        .ticks( availableHeight / 36 )
-        .tickSize( -availableWidth, 0);
-
-
-      d3.transition(g.select('.y1.axis'))
-          .call(yAxis1);
-
-      yAxis2
-        .ticks( availableHeight / 36 )
-        .tickSize( -availableWidth, 0);
-
-      d3.transition(g.select('.y2.axis'))
-          .call(yAxis2);
-
-      g.select('.y2.axis')
-          .style('opacity', series2.length ? 1 : 0)
-          .attr('transform', 'translate(' + x.range()[1] + ',0)');
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        chart.update();
-      });
-     
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  lines1.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines1.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  lines2.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines2.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  bars1.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  bars1.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  bars2.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  bars2.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  stack1.dispatch.on('tooltipShow', function(e) {
-    //disable tooltips when value ~= 0
-    //// TODO: consider removing points from voronoi that have 0 value instead of this hack
-    if (!Math.round(stack1.y()(e.point) * 100)) {  // 100 will not be good for very small numbers... will have to think about making this valu dynamic, based on data range
-      setTimeout(function() { d3.selectAll('.point.hover').classed('hover', false) }, 0);
-      return false;
-    }
-
-    e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top],
-    dispatch.tooltipShow(e);
-  });
-
-  stack1.dispatch.on('tooltipHide', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  stack2.dispatch.on('tooltipShow', function(e) {
-    //disable tooltips when value ~= 0
-    //// TODO: consider removing points from voronoi that have 0 value instead of this hack
-    if (!Math.round(stack2.y()(e.point) * 100)) {  // 100 will not be good for very small numbers... will have to think about making this valu dynamic, based on data range
-      setTimeout(function() { d3.selectAll('.point.hover').classed('hover', false) }, 0);
-      return false;
-    }
-
-    e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top],
-    dispatch.tooltipShow(e);
-  });
-
-  stack2.dispatch.on('tooltipHide', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-    lines1.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines1.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  lines2.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  lines2.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-
-
-  //============================================================
-  // Global getters and setters
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.lines1 = lines1;
-  chart.lines2 = lines2;
-  chart.bars1 = bars1;
-  chart.bars2 = bars2;
-  chart.stack1 = stack1;
-  chart.stack2 = stack2;
-  chart.xAxis = xAxis;
-  chart.yAxis1 = yAxis1;
-  chart.yAxis2 = yAxis2;
-  chart.options = nv.utils.optionsFunc.bind(chart);
-
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    lines1.x(_);
-    bars1.x(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    lines1.y(_);
-    bars1.y(_);
-    return chart;
-  };
-
-  chart.yDomain1 = function(_) {
-    if (!arguments.length) return yDomain1;
-    yDomain1 = _;
-    return chart;
-  };
-
-  chart.yDomain2 = function(_) {
-    if (!arguments.length) return yDomain2;
-    yDomain2 = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin = _;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = _;
-    legend.color(_);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  return chart;
-}
-
-
-nv.models.ohlcBar = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , x = d3.scale.linear()
-    , y = d3.scale.linear()
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , getOpen = function(d) { return d.open }
-    , getClose = function(d) { return d.close }
-    , getHigh = function(d) { return d.high }
-    , getLow = function(d) { return d.low }
-    , forceX = []
-    , forceY = []
-    , padData     = false // If true, adds half a data points width to front and back, for lining up a line chart with a bar chart
-    , clipEdge = true
-    , color = nv.utils.defaultColor()
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    ;
-
-  //============================================================
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  //TODO: store old scales for transitions
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x   .domain(xDomain || d3.extent(data[0].values.map(getX).concat(forceX) ));
-
-      if (padData)
-        x.range(xRange || [availableWidth * .5 / data[0].values.length, availableWidth * (data[0].values.length - .5)  / data[0].values.length ]);
-      else
-        x.range(xRange || [0, availableWidth]);
-
-      y   .domain(yDomain || [
-            d3.min(data[0].values.map(getLow).concat(forceY)),
-            d3.max(data[0].values.map(getHigh).concat(forceY))
-          ])
-          .range(yRange || [availableHeight, 0]);
-
-      // If scale's domain don't have a range, slightly adjust to make one... so a chart can show a single data point
-      if (x.domain()[0] === x.domain()[1] || y.domain()[0] === y.domain()[1]) singlePoint = true;
-      if (x.domain()[0] === x.domain()[1])
-        x.domain()[0] ?
-            x.domain([x.domain()[0] - x.domain()[0] * 0.01, x.domain()[1] + x.domain()[1] * 0.01])
-          : x.domain([-1,1]);
-
-      if (y.domain()[0] === y.domain()[1])
-        y.domain()[0] ?
-            y.domain([y.domain()[0] + y.domain()[0] * 0.01, y.domain()[1] - y.domain()[1] * 0.01])
-          : y.domain([-1,1]);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = d3.select(this).selectAll('g.nv-wrap.nv-ohlcBar').data([data[0].values]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-ohlcBar');
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-ticks');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      container
-          .on('click', function(d,i) {
-            dispatch.chartClick({
-                data: d,
-                index: i,
-                pos: d3.event,
-                id: id
-            });
-          });
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-chart-clip-path-' + id)
-        .append('rect');
-
-      wrap.select('#nv-chart-clip-path-' + id + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-chart-clip-path-' + id + ')' : '');
-
-
-
-      var ticks = wrap.select('.nv-ticks').selectAll('.nv-tick')
-          .data(function(d) { return d });
-
-      ticks.exit().remove();
-
-
-      var ticksEnter = ticks.enter().append('path')
-          .attr('class', function(d,i,j) { return (getOpen(d,i) > getClose(d,i) ? 'nv-tick negative' : 'nv-tick positive') + ' nv-tick-' + j + '-' + i })
-          .attr('d', function(d,i) {
-            var w = (availableWidth / data[0].values.length) * .9;
-            return 'm0,0l0,'
-                 + (y(getOpen(d,i))
-                 - y(getHigh(d,i)))
-                 + 'l'
-                 + (-w/2)
-                 + ',0l'
-                 + (w/2)
-                 + ',0l0,'
-                 + (y(getLow(d,i)) - y(getOpen(d,i)))
-                 + 'l0,'
-                 + (y(getClose(d,i))
-                 - y(getLow(d,i)))
-                 + 'l'
-                 + (w/2)
-                 + ',0l'
-                 + (-w/2)
-                 + ',0z';
-          })
-          .attr('transform', function(d,i) { return 'translate(' + x(getX(d,i)) + ',' + y(getHigh(d,i)) + ')'; })
-          //.attr('fill', function(d,i) { return color[0]; })
-          //.attr('stroke', function(d,i) { return color[0]; })
-          //.attr('x', 0 )
-          //.attr('y', function(d,i) {  return y(Math.max(0, getY(d,i))) })
-          //.attr('height', function(d,i) { return Math.abs(y(getY(d,i)) - y(0)) })
-          .on('mouseover', function(d,i) {
-            d3.select(this).classed('hover', true);
-            dispatch.elementMouseover({
-                point: d,
-                series: data[0],
-                pos: [x(getX(d,i)), y(getY(d,i))],  // TODO: Figure out why the value appears to be shifted
-                pointIndex: i,
-                seriesIndex: 0,
-                e: d3.event
-            });
-
-          })
-          .on('mouseout', function(d,i) {
-                d3.select(this).classed('hover', false);
-                dispatch.elementMouseout({
-                    point: d,
-                    series: data[0],
-                    pointIndex: i,
-                    seriesIndex: 0,
-                    e: d3.event
-                });
-          })
-          .on('click', function(d,i) {
-                dispatch.elementClick({
-                    //label: d[label],
-                    value: getY(d,i),
-                    data: d,
-                    index: i,
-                    pos: [x(getX(d,i)), y(getY(d,i))],
-                    e: d3.event,
-                    id: id
-                });
-              d3.event.stopPropagation();
-          })
-          .on('dblclick', function(d,i) {
-              dispatch.elementDblClick({
-                  //label: d[label],
-                  value: getY(d,i),
-                  data: d,
-                  index: i,
-                  pos: [x(getX(d,i)), y(getY(d,i))],
-                  e: d3.event,
-                  id: id
-              });
-              d3.event.stopPropagation();
-          });
-
-      ticks
-          .attr('class', function(d,i,j) { return (getOpen(d,i) > getClose(d,i) ? 'nv-tick negative' : 'nv-tick positive') + ' nv-tick-' + j + '-' + i })
-      d3.transition(ticks)
-          .attr('transform', function(d,i) { return 'translate(' + x(getX(d,i)) + ',' + y(getHigh(d,i)) + ')'; })
-          .attr('d', function(d,i) {
-            var w = (availableWidth / data[0].values.length) * .9;
-            return 'm0,0l0,'
-                 + (y(getOpen(d,i))
-                 - y(getHigh(d,i)))
-                 + 'l'
-                 + (-w/2)
-                 + ',0l'
-                 + (w/2)
-                 + ',0l0,'
-                 + (y(getLow(d,i))
-                 - y(getOpen(d,i)))
-                 + 'l0,'
-                 + (y(getClose(d,i))
-                 - y(getLow(d,i)))
-                 + 'l'
-                 + (w/2)
-                 + ',0l'
-                 + (-w/2)
-                 + ',0z';
-          })
-          //.attr('width', (availableWidth / data[0].values.length) * .9 )
-
-
-      //d3.transition(ticks)
-          //.attr('y', function(d,i) {  return y(Math.max(0, getY(d,i))) })
-          //.attr('height', function(d,i) { return Math.abs(y(getY(d,i)) - y(0)) });
-          //.order();  // not sure if this makes any sense for this model
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = _;
-    return chart;
-  };
-
-  chart.open = function(_) {
-    if (!arguments.length) return getOpen;
-    getOpen = _;
-    return chart;
-  };
-
-  chart.close = function(_) {
-    if (!arguments.length) return getClose;
-    getClose = _;
-    return chart;
-  };
-
-  chart.high = function(_) {
-    if (!arguments.length) return getHigh;
-    getHigh = _;
-    return chart;
-  };
-
-  chart.low = function(_) {
-    if (!arguments.length) return getLow;
-    getLow = _;
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.forceX = function(_) {
-    if (!arguments.length) return forceX;
-    forceX = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.padData = function(_) {
-    if (!arguments.length) return padData;
-    padData = _;
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-nv.models.pie = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 500
-    , height = 500
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , getDescription = function(d) { return d.description }
-    , id = Math.floor(Math.random() * 10000) //Create semi-unique ID in case user doesn't select one
-    , color = nv.utils.defaultColor()
-    , valueFormat = d3.format(',.2f')
-    , showLabels = true
-    , pieLabelsOutside = true
-    , donutLabelsOutside = false
-    , labelType = "key"
-    , labelThreshold = .02 //if slice percentage is under this, don't show label
-    , donut = false
-    , labelSunbeamLayout = false
-    , startAngle = false
-    , endAngle = false
-    , donutRatio = 0.5
-    , dispatch = d3.dispatch('chartClick', 'elementClick', 'elementDblClick', 'elementMouseover', 'elementMouseout')
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          radius = Math.min(availableWidth, availableHeight) / 2,
-          arcRadius = radius-(radius / 5),
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      //var wrap = container.selectAll('.nv-wrap.nv-pie').data([data]);
-      var wrap = container.selectAll('.nv-wrap.nv-pie').data(data);
-      var wrapEnter = wrap.enter().append('g').attr('class','nvd3 nv-wrap nv-pie nv-chart-' + id);
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-pie');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-      g.select('.nv-pie').attr('transform', 'translate(' + availableWidth / 2 + ',' + availableHeight / 2 + ')');
-
-      //------------------------------------------------------------
-
-
-      container
-          .on('click', function(d,i) {
-              dispatch.chartClick({
-                  data: d,
-                  index: i,
-                  pos: d3.event,
-                  id: id
-              });
-          });
-
-
-      var arc = d3.svg.arc()
-                  .outerRadius(arcRadius);
-
-      if (startAngle) arc.startAngle(startAngle)
-      if (endAngle) arc.endAngle(endAngle);
-      if (donut) arc.innerRadius(radius * donutRatio);
-
-      // Setup the Pie chart and choose the data element
-      var pie = d3.layout.pie()
-          .sort(null)
-          .value(function(d) { return d.disabled ? 0 : getY(d) });
-
-      var slices = wrap.select('.nv-pie').selectAll('.nv-slice')
-          .data(pie);
-
-      slices.exit().remove();
-
-      var ae = slices.enter().append('g')
-              .attr('class', 'nv-slice')
-              .on('mouseover', function(d,i){
-                d3.select(this).classed('hover', true);
-                dispatch.elementMouseover({
-                    label: getX(d.data),
-                    value: getY(d.data),
-                    point: d.data,
-                    pointIndex: i,
-                    pos: [d3.event.pageX, d3.event.pageY],
-                    id: id
-                });
-              })
-              .on('mouseout', function(d,i){
-                d3.select(this).classed('hover', false);
-                dispatch.elementMouseout({
-                    label: getX(d.data),
-                    value: getY(d.data),
-                    point: d.data,
-                    index: i,
-                    id: id
-                });
-              })
-              .on('click', function(d,i) {
-                dispatch.elementClick({
-                    label: getX(d.data),
-                    value: getY(d.data),
-                    point: d.data,
-                    index: i,
-                    pos: d3.event,
-                    id: id
-                });
-                d3.event.stopPropagation();
-              })
-              .on('dblclick', function(d,i) {
-                dispatch.elementDblClick({
-                    label: getX(d.data),
-                    value: getY(d.data),
-                    point: d.data,
-                    index: i,
-                    pos: d3.event,
-                    id: id
-                });
-                d3.event.stopPropagation();
-              });
-
-        slices
-            .attr('fill', function(d,i) { return color(d, i); })
-            .attr('stroke', function(d,i) { return color(d, i); });
-
-        var paths = ae.append('path')
-            .each(function(d) { this._current = d; });
-            //.attr('d', arc);
-
-        d3.transition(slices.select('path'))
-            .attr('d', arc)
-            .attrTween('d', arcTween);
-
-        if (showLabels) {
-          // This does the normal label
-          var labelsArc = d3.svg.arc().innerRadius(0);
-          
-          if (pieLabelsOutside){ labelsArc = arc; }
-
-          if (donutLabelsOutside) { labelsArc = d3.svg.arc().outerRadius(arc.outerRadius()); }
-
-          ae.append("g").classed("nv-label", true)
-            .each(function(d, i) {
-              var group = d3.select(this);
-
-              group
-                .attr('transform', function(d) {
-                     if (labelSunbeamLayout) {
-                       d.outerRadius = arcRadius + 10; // Set Outer Coordinate
-                       d.innerRadius = arcRadius + 15; // Set Inner Coordinate
-                       var rotateAngle = (d.startAngle + d.endAngle) / 2 * (180 / Math.PI);
-                       if ((d.startAngle+d.endAngle)/2 < Math.PI) {
-                       	 rotateAngle -= 90;
-                       } else {
-                       	 rotateAngle += 90;
-                       }
-                       return 'translate(' + labelsArc.centroid(d) + ') rotate(' + rotateAngle + ')';
-                     } else {
-                       d.outerRadius = radius + 10; // Set Outer Coordinate
-                       d.innerRadius = radius + 15; // Set Inner Coordinate
-                       return 'translate(' + labelsArc.centroid(d) + ')'
-                     }
-                });
-
-              group.append('rect')
-                  .style('stroke', '#fff')
-                  .style('fill', '#fff')
-                  .attr("rx", 3)
-                  .attr("ry", 3);
-
-              group.append('text')
-                  .style('text-anchor', labelSunbeamLayout ? ((d.startAngle + d.endAngle) / 2 < Math.PI ? 'start' : 'end') : 'middle') //center the text on it's origin or begin/end if orthogonal aligned
-                  .style('fill', '#000')
-
-
-          });
-
-          slices.select(".nv-label").transition()
-            .attr('transform', function(d) {
-            	if (labelSunbeamLayout) {
-                  d.outerRadius = arcRadius + 10; // Set Outer Coordinate
-                  d.innerRadius = arcRadius + 15; // Set Inner Coordinate
-                  var rotateAngle = (d.startAngle + d.endAngle) / 2 * (180 / Math.PI);
-                  if ((d.startAngle+d.endAngle)/2 < Math.PI) {
-                    rotateAngle -= 90;
-                  } else {
-                    rotateAngle += 90;
-                  }
-                  return 'translate(' + labelsArc.centroid(d) + ') rotate(' + rotateAngle + ')';
-                } else {
-                  d.outerRadius = radius + 10; // Set Outer Coordinate
-                  d.innerRadius = radius + 15; // Set Inner Coordinate
-                  return 'translate(' + labelsArc.centroid(d) + ')'
-                }
-            });
-
-          slices.each(function(d, i) {
-            var slice = d3.select(this);
-
-            slice
-              .select(".nv-label text")
-                .style('text-anchor', labelSunbeamLayout ? ((d.startAngle + d.endAngle) / 2 < Math.PI ? 'start' : 'end') : 'middle') //center the text on it's origin or begin/end if orthogonal aligned
-                .text(function(d, i) {
-                  var percent = (d.endAngle - d.startAngle) / (2 * Math.PI);
-                  var labelTypes = {
-                    "key" : getX(d.data),
-                    "value": getY(d.data),
-                    "percent": d3.format('%')(percent)
-                  };
-                  return (d.value && percent > labelThreshold) ? labelTypes[labelType] : '';
-                });
-
-            var textBox = slice.select('text').node().getBBox();
-            slice.select(".nv-label rect")
-              .attr("width", textBox.width + 10)
-              .attr("height", textBox.height + 10)
-              .attr("transform", function() {
-                return "translate(" + [textBox.x - 5, textBox.y - 5] + ")";
-              });
-          });
-        }
-
-
-        // Computes the angle of an arc, converting from radians to degrees.
-        function angle(d) {
-          var a = (d.startAngle + d.endAngle) * 90 / Math.PI - 90;
-          return a > 90 ? a - 180 : a;
-        }
-
-        function arcTween(a) {
-          a.endAngle = isNaN(a.endAngle) ? 0 : a.endAngle;
-          a.startAngle = isNaN(a.startAngle) ? 0 : a.startAngle;
-          if (!donut) a.innerRadius = 0;
-          var i = d3.interpolate(this._current, a);
-          this._current = i(0);
-          return function(t) {
-            return arc(i(t));
-          };
-        }
-
-        function tweenPie(b) {
-          b.innerRadius = 0;
-          var i = d3.interpolate({startAngle: 0, endAngle: 0}, b);
-          return function(t) {
-              return arc(i(t));
-          };
-        }
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.options = nv.utils.optionsFunc.bind(chart);
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.values = function(_) {
-    nv.log("pie.values() is no longer supported.");
-    return chart;
-  };
-
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = _;
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = d3.functor(_);
-    return chart;
-  };
-  
-  chart.description = function(_) {
-    if (!arguments.length) return getDescription;
-    getDescription = _;
-    return chart;
-  };
-
-  chart.showLabels = function(_) {
-    if (!arguments.length) return showLabels;
-    showLabels = _;
-    return chart;
-  };
-  
-  chart.labelSunbeamLayout = function(_) {
-    if (!arguments.length) return labelSunbeamLayout;
-    labelSunbeamLayout = _;
-    return chart;
-  };
-
-  chart.donutLabelsOutside = function(_) {
-    if (!arguments.length) return donutLabelsOutside;
-    donutLabelsOutside = _;
-    return chart;
-  };
-  
-  chart.pieLabelsOutside = function(_) {
-    if (!arguments.length) return pieLabelsOutside;
-    pieLabelsOutside = _;
-    return chart;
-  };
-
-  chart.labelType = function(_) {
-    if (!arguments.length) return labelType;
-    labelType = _;
-    labelType = labelType || "key";
-    return chart;
-  };
-
-  chart.donut = function(_) {
-    if (!arguments.length) return donut;
-    donut = _;
-    return chart;
-  };
-  
-  chart.donutRatio = function(_) {
-    if (!arguments.length) return donutRatio;
-    donutRatio = _;
-    return chart;
-  };
-
-  chart.startAngle = function(_) {
-    if (!arguments.length) return startAngle;
-    startAngle = _;
-    return chart;
-  };
-
-  chart.endAngle = function(_) {
-    if (!arguments.length) return endAngle;
-    endAngle = _;
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.valueFormat = function(_) {
-    if (!arguments.length) return valueFormat;
-    valueFormat = _;
-    return chart;
-  };
-
-  chart.labelThreshold = function(_) {
-    if (!arguments.length) return labelThreshold;
-    labelThreshold = _;
-    return chart;
-  };
-  //============================================================
-
-
-  return chart;
-}
-nv.models.pieChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var pie = nv.models.pie()
-    , legend = nv.models.legend()
-    ;
-
-  var margin = {top: 30, right: 20, bottom: 20, left: 20}
-    , width = null
-    , height = null
-    , showLegend = true
-    , color = nv.utils.defaultColor()
-    , tooltips = true
-    , tooltip = function(key, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + '</p>'
-      }
-    , state = {}
-    , defaultState = null
-    , noData = "No Data Available."
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var tooltipLabel = pie.description()(e.point) || pie.x()(e.point)
-    var left = e.pos[0] + ( (offsetElement && offsetElement.offsetLeft) || 0 ),
-        top = e.pos[1] + ( (offsetElement && offsetElement.offsetTop) || 0),
-        y = pie.valueFormat()(pie.y()(e.point)),
-        content = tooltip(tooltipLabel, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().call(chart); };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-pieChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-pieChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-pieWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend
-          .width( availableWidth )
-          .key(pie.x());
-
-        wrap.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        wrap.select('.nv-legendWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      pie
-        .width(availableWidth)
-        .height(availableHeight);
-
-
-      var pieWrap = g.select('.nv-pieWrap')
-          .datum([data]);
-
-      d3.transition(pieWrap).call(pie);
-
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      legend.dispatch.on('stateChange', function(newState) {
-        state = newState;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      pie.dispatch.on('elementMouseout.tooltip', function(e) {
-        dispatch.tooltipHide(e);
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-
-    });
-
-    return chart;
-  }
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  pie.dispatch.on('elementMouseover.tooltip', function(e) {
-    e.pos = [e.pos[0] +  margin.left, e.pos[1] + margin.top];
-    dispatch.tooltipShow(e);
-  });
-
-  dispatch.on('tooltipShow', function(e) {
-    if (tooltips) showTooltip(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.legend = legend;
-  chart.dispatch = dispatch;
-  chart.pie = pie;
-
-  d3.rebind(chart, pie, 'valueFormat', 'values', 'x', 'y', 'description', 'id', 'showLabels', 'donutLabelsOutside', 'pieLabelsOutside', 'labelType', 'donut', 'donutRatio', 'labelThreshold');
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    pie.color(color);
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.scatter = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin       = {top: 0, right: 0, bottom: 0, left: 0}
-    , width        = 960
-    , height       = 500
-    , color        = nv.utils.defaultColor() // chooses color
-    , id           = Math.floor(Math.random() * 100000) //Create semi-unique ID incase user doesn't select one
-    , x            = d3.scale.linear()
-    , y            = d3.scale.linear()
-    , z            = d3.scale.linear() //linear because d3.svg.shape.size is treated as area
-    , getX         = function(d) { return d.x } // accessor to get the x value
-    , getY         = function(d) { return d.y } // accessor to get the y value
-    , getSize      = function(d) { return d.size || 1} // accessor to get the point size
-    , getShape     = function(d) { return d.shape || 'circle' } // accessor to get point shape
-    , onlyCircles  = true // Set to false to use shapes
-    , forceX       = [] // List of numbers to Force into the X scale (ie. 0, or a max / min, etc.)
-    , forceY       = [] // List of numbers to Force into the Y scale
-    , forceSize    = [] // List of numbers to Force into the Size scale
-    , interactive  = true // If true, plots a voronoi overlay for advanced point intersection
-    , pointKey     = null
-    , pointActive  = function(d) { return !d.notActive } // any points that return false will be filtered out
-    , padData      = false // If true, adds half a data points width to front and back, for lining up a line chart with a bar chart
-    , padDataOuter = .1 //outerPadding to imitate ordinal scale outer padding
-    , clipEdge     = false // if true, masks points within x and y scale
-    , clipVoronoi  = true // if true, masks each point with a circle... can turn off to slightly increase performance
-    , clipRadius   = function() { return 25 } // function to get the radius for voronoi point clips
-    , xDomain      = null // Override x domain (skips the calculation from data)
-    , yDomain      = null // Override y domain
-    , xRange       = null // Override x range
-    , yRange       = null // Override y range
-    , sizeDomain   = null // Override point size domain
-    , sizeRange    = null
-    , singlePoint  = false
-    , dispatch     = d3.dispatch('elementClick', 'elementMouseover', 'elementMouseout')
-    , useVoronoi   = true
-    ;
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0, z0 // used to store previous scales
-    , timeoutID
-    , needsUpdate = false // Flag for when the points are visually updating, but the interactive layer is behind, to disable tooltips
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-      //add series index to each data point for reference
-      data = data.map(function(series, i) {
-        series.values = series.values.map(function(point) {
-          point.series = i;
-          return point;
-        });
-        return series;
-      });
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      // remap and flatten the data for use in calculating the scales' domains
-      var seriesData = (xDomain && yDomain && sizeDomain) ? [] : // if we know xDomain and yDomain and sizeDomain, no need to calculate.... if Size is constant remember to set sizeDomain to speed up performance
-            d3.merge(
-              data.map(function(d) {
-                return d.values.map(function(d,i) {
-                  return { x: getX(d,i), y: getY(d,i), size: getSize(d,i) }
-                })
-              })
-            );
-
-      x   .domain(xDomain || d3.extent(seriesData.map(function(d) { return d.x; }).concat(forceX)))
-
-      if (padData && data[0])
-        x.range(xRange || [(availableWidth * padDataOuter +  availableWidth) / (2 *data[0].values.length), availableWidth - availableWidth * (1 + padDataOuter) / (2 * data[0].values.length)  ]);
-        //x.range([availableWidth * .5 / data[0].values.length, availableWidth * (data[0].values.length - .5)  / data[0].values.length ]);
-      else
-        x.range(xRange || [0, availableWidth]);
-
-      y   .domain(yDomain || d3.extent(seriesData.map(function(d) { return d.y }).concat(forceY)))
-          .range(yRange || [availableHeight, 0]);
-
-      z   .domain(sizeDomain || d3.extent(seriesData.map(function(d) { return d.size }).concat(forceSize)))
-          .range(sizeRange || [16, 256]);
-
-      // If scale's domain don't have a range, slightly adjust to make one... so a chart can show a single data point
-      if (x.domain()[0] === x.domain()[1] || y.domain()[0] === y.domain()[1]) singlePoint = true;
-      if (x.domain()[0] === x.domain()[1])
-        x.domain()[0] ?
-            x.domain([x.domain()[0] - x.domain()[0] * 0.01, x.domain()[1] + x.domain()[1] * 0.01])
-          : x.domain([-1,1]);
-
-      if (y.domain()[0] === y.domain()[1])
-        y.domain()[0] ?
-            y.domain([y.domain()[0] - y.domain()[0] * 0.01, y.domain()[1] + y.domain()[1] * 0.01])
-          : y.domain([-1,1]);
-
-      if ( isNaN(x.domain()[0])) {
-          x.domain([-1,1]);
-      }
-
-      if ( isNaN(y.domain()[0])) {
-          y.domain([-1,1]);
-      }
-
-
-      x0 = x0 || x;
-      y0 = y0 || y;
-      z0 = z0 || z;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-scatter').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-scatter nv-chart-' + id + (singlePoint ? ' nv-single-point' : ''));
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-groups');
-      gEnter.append('g').attr('class', 'nv-point-paths');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-edge-clip-' + id)
-        .append('rect');
-
-      wrap.select('#nv-edge-clip-' + id + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + id + ')' : '');
-
-
-      function updateInteractiveLayer() {
-
-        if (!interactive) return false;
-
-        var eventElements;
-
-        var vertices = d3.merge(data.map(function(group, groupIndex) {
-            return group.values
-              .map(function(point, pointIndex) {
-                // *Adding noise to make duplicates very unlikely
-                // *Injecting series and point index for reference
-                /* *Adding a 'jitter' to the points, because there's an issue in d3.geom.voronoi.
-                */
-                var pX = getX(point,pointIndex);
-                var pY = getY(point,pointIndex);
-
-                return [x(pX)+ Math.random() * 1e-7, 
-                        y(pY)+ Math.random() * 1e-7, 
-                        groupIndex, 
-                        pointIndex, point]; //temp hack to add noise untill I think of a better way so there are no duplicates
-              })
-              .filter(function(pointArray, pointIndex) {
-                return pointActive(pointArray[4], pointIndex); // Issue #237.. move filter to after map, so pointIndex is correct!
-              })
-          })
-        );
-
-
-
-        //inject series and point index for reference into voronoi
-        if (useVoronoi === true) {
-
-          if (clipVoronoi) {
-            var pointClipsEnter = wrap.select('defs').selectAll('.nv-point-clips')
-                .data([id])
-              .enter();
-
-            pointClipsEnter.append('clipPath')
-                  .attr('class', 'nv-point-clips')
-                  .attr('id', 'nv-points-clip-' + id);
-
-            var pointClips = wrap.select('#nv-points-clip-' + id).selectAll('circle')
-                .data(vertices);
-            pointClips.enter().append('circle')
-                .attr('r', clipRadius);
-            pointClips.exit().remove();
-            pointClips
-                .attr('cx', function(d) { return d[0] })
-                .attr('cy', function(d) { return d[1] });
-
-            wrap.select('.nv-point-paths')
-                .attr('clip-path', 'url(#nv-points-clip-' + id + ')');
-          }
-
-
-          if(vertices.length) {
-            // Issue #283 - Adding 2 dummy points to the voronoi b/c voronoi requires min 3 points to work
-            vertices.push([x.range()[0] - 20, y.range()[0] - 20, null, null]);
-            vertices.push([x.range()[1] + 20, y.range()[1] + 20, null, null]);
-            vertices.push([x.range()[0] - 20, y.range()[0] + 20, null, null]);
-            vertices.push([x.range()[1] + 20, y.range()[1] - 20, null, null]);
-          }
-
-          var bounds = d3.geom.polygon([
-              [-10,-10],
-              [-10,height + 10],
-              [width + 10,height + 10],
-              [width + 10,-10]
-          ]);
-
-          var voronoi = d3.geom.voronoi(vertices).map(function(d, i) {
-              return {
-                'data': bounds.clip(d),
-                'series': vertices[i][2],
-                'point': vertices[i][3]
-              }
-            });
-
-
-          var pointPaths = wrap.select('.nv-point-paths').selectAll('path')
-              .data(voronoi);
-          pointPaths.enter().append('path')
-              .attr('class', function(d,i) { return 'nv-path-'+i; });
-          pointPaths.exit().remove();
-          pointPaths
-              .attr('d', function(d) {
-                if (d.data.length === 0) 
-                    return 'M 0 0'
-                else 
-                    return 'M' + d.data.join('L') + 'Z'; 
-              });
-
-          var mouseEventCallback = function(d,mDispatch) {
-                if (needsUpdate) return 0;
-                var series = data[d.series];
-                if (typeof series === 'undefined') return;
-                
-                var point  = series.values[d.point];
-
-                mDispatch({
-                  point: point,
-                  series: series,
-                  pos: [x(getX(point, d.point)) + margin.left, y(getY(point, d.point)) + margin.top],
-                  seriesIndex: d.series,
-                  pointIndex: d.point
-                });
-          };
-
-          pointPaths
-              .on('click', function(d) {
-                mouseEventCallback(d, dispatch.elementClick);
-              })
-              .on('mouseover', function(d) {
-                mouseEventCallback(d, dispatch.elementMouseover);
-              })
-              .on('mouseout', function(d, i) {
-                mouseEventCallback(d, dispatch.elementMouseout);
-              });
-
-
-        } else {
-          /*
-          // bring data in form needed for click handlers
-          var dataWithPoints = vertices.map(function(d, i) {
-              return {
-                'data': d,
-                'series': vertices[i][2],
-                'point': vertices[i][3]
-              }
-            });
-           */
-
-          // add event handlers to points instead voronoi paths
-          wrap.select('.nv-groups').selectAll('.nv-group')
-            .selectAll('.nv-point')
-              //.data(dataWithPoints)
-              //.style('pointer-events', 'auto') // recativate events, disabled by css
-              .on('click', function(d,i) { 
-                //nv.log('test', d, i);
-                if (needsUpdate || !data[d.series]) return 0; //check if this is a dummy point
-                var series = data[d.series],
-                    point  = series.values[i];
-
-                dispatch.elementClick({
-                  point: point,
-                  series: series,
-                  pos: [x(getX(point, i)) + margin.left, y(getY(point, i)) + margin.top],
-                  seriesIndex: d.series,
-                  pointIndex: i
-                });
-              })
-              .on('mouseover', function(d,i) {
-                if (needsUpdate || !data[d.series]) return 0; //check if this is a dummy point
-                var series = data[d.series],
-                    point  = series.values[i];
-
-                dispatch.elementMouseover({
-                  point: point,
-                  series: series,
-                  pos: [x(getX(point, i)) + margin.left, y(getY(point, i)) + margin.top],
-                  seriesIndex: d.series,
-                  pointIndex: i
-                });
-              })
-              .on('mouseout', function(d,i) {
-                if (needsUpdate || !data[d.series]) return 0; //check if this is a dummy point
-                var series = data[d.series],
-                    point  = series.values[i];
-
-                dispatch.elementMouseout({
-                  point: point,
-                  series: series,
-                  seriesIndex: d.series,
-                  pointIndex: i
-                });
-              });
-          }
-
-          needsUpdate = false;
-      }
-
-      needsUpdate = true;
-
-      var groups = wrap.select('.nv-groups').selectAll('.nv-group')
-          .data(function(d) { return d }, function(d) { return d.key });
-      groups.enter().append('g')
-          .style('stroke-opacity', 1e-6)
-          .style('fill-opacity', 1e-6);
-      groups.exit()
-          .remove();
-      groups
-          .attr('class', function(d,i) { return 'nv-group nv-series-' + i })
-          .classed('hover', function(d) { return d.hover });
-      groups
-          .transition()
-          .style('fill', function(d,i) { return color(d, i) })
-          .style('stroke', function(d,i) { return color(d, i) })
-          .style('stroke-opacity', 1)
-          .style('fill-opacity', .5);
-
-
-      if (onlyCircles) {
-
-        var points = groups.selectAll('circle.nv-point')
-            .data(function(d) { return d.values }, pointKey);
-        points.enter().append('circle')
-            .style('fill', function (d,i) { return d.color })
-            .style('stroke', function (d,i) { return d.color })
-            .attr('cx', function(d,i) { return nv.utils.NaNtoZero(x0(getX(d,i))) })
-            .attr('cy', function(d,i) { return nv.utils.NaNtoZero(y0(getY(d,i))) })
-            .attr('r', function(d,i) { return Math.sqrt(z(getSize(d,i))/Math.PI) });
-        points.exit().remove();
-        groups.exit().selectAll('path.nv-point').transition()
-            .attr('cx', function(d,i) { return nv.utils.NaNtoZero(x(getX(d,i))) })
-            .attr('cy', function(d,i) { return nv.utils.NaNtoZero(y(getY(d,i))) })
-            .remove();
-        points.each(function(d,i) {
-          d3.select(this)
-            .classed('nv-point', true)
-            .classed('nv-point-' + i, true)
-            .classed('hover',false)
-            ;
-        });
-        points.transition()
-            .attr('cx', function(d,i) { return nv.utils.NaNtoZero(x(getX(d,i))) })
-            .attr('cy', function(d,i) { return nv.utils.NaNtoZero(y(getY(d,i))) })
-            .attr('r', function(d,i) { return Math.sqrt(z(getSize(d,i))/Math.PI) });
-
-      } else {
-
-        var points = groups.selectAll('path.nv-point')
-            .data(function(d) { return d.values });
-        points.enter().append('path')
-            .style('fill', function (d,i) { return d.color })
-            .style('stroke', function (d,i) { return d.color })
-            .attr('transform', function(d,i) {
-              return 'translate(' + x0(getX(d,i)) + ',' + y0(getY(d,i)) + ')'
-            })
-            .attr('d',
-              d3.svg.symbol()
-                .type(getShape)
-                .size(function(d,i) { return z(getSize(d,i)) })
-            );
-        points.exit().remove();
-        groups.exit().selectAll('path.nv-point')
-            .transition()
-            .attr('transform', function(d,i) {
-              return 'translate(' + x(getX(d,i)) + ',' + y(getY(d,i)) + ')'
-            })
-            .remove();
-        points.each(function(d,i) {
-          d3.select(this)
-            .classed('nv-point', true)
-            .classed('nv-point-' + i, true)
-            .classed('hover',false)
-            ;
-        });
-        points.transition()
-            .attr('transform', function(d,i) {
-              //nv.log(d,i,getX(d,i), x(getX(d,i)));
-              return 'translate(' + x(getX(d,i)) + ',' + y(getY(d,i)) + ')'
-            })
-            .attr('d',
-              d3.svg.symbol()
-                .type(getShape)
-                .size(function(d,i) { return z(getSize(d,i)) })
-            );
-      }
-
-
-      // Delay updating the invisible interactive layer for smoother animation
-      clearTimeout(timeoutID); // stop repeat calls to updateInteractiveLayer
-      timeoutID = setTimeout(updateInteractiveLayer, 300);
-      //updateInteractiveLayer();
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-      z0 = z.copy();
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-  chart.clearHighlights = function() {
-      //Remove the 'hover' class from all highlighted points.
-      d3.selectAll(".nv-chart-" + id + " .nv-point.hover").classed("hover",false);
-  };
-
-  chart.highlightPoint = function(seriesIndex,pointIndex,isHoverOver) {
-      d3.select(".nv-chart-" + id + " .nv-series-" + seriesIndex + " .nv-point-" + pointIndex)
-          .classed("hover",isHoverOver); 
-  };
-
-
-  dispatch.on('elementMouseover.point', function(d) {
-     if (interactive) chart.highlightPoint(d.seriesIndex,d.pointIndex,true);
-  });
-
-  dispatch.on('elementMouseout.point', function(d) {
-     if (interactive) chart.highlightPoint(d.seriesIndex,d.pointIndex,false);
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = d3.functor(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = d3.functor(_);
-    return chart;
-  };
-
-  chart.size = function(_) {
-    if (!arguments.length) return getSize;
-    getSize = d3.functor(_);
-    return chart;
-  };
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.zScale = function(_) {
-    if (!arguments.length) return z;
-    z = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.sizeDomain = function(_) {
-    if (!arguments.length) return sizeDomain;
-    sizeDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.sizeRange = function(_) {
-    if (!arguments.length) return sizeRange;
-    sizeRange = _;
-    return chart;
-  };
-
-  chart.forceX = function(_) {
-    if (!arguments.length) return forceX;
-    forceX = _;
-    return chart;
-  };
-
-  chart.forceY = function(_) {
-    if (!arguments.length) return forceY;
-    forceY = _;
-    return chart;
-  };
-
-  chart.forceSize = function(_) {
-    if (!arguments.length) return forceSize;
-    forceSize = _;
-    return chart;
-  };
-
-  chart.interactive = function(_) {
-    if (!arguments.length) return interactive;
-    interactive = _;
-    return chart;
-  };
-
-  chart.pointKey = function(_) {
-    if (!arguments.length) return pointKey;
-    pointKey = _;
-    return chart;
-  };
-
-  chart.pointActive = function(_) {
-    if (!arguments.length) return pointActive;
-    pointActive = _;
-    return chart;
-  };
-
-  chart.padData = function(_) {
-    if (!arguments.length) return padData;
-    padData = _;
-    return chart;
-  };
-
-  chart.padDataOuter = function(_) {
-    if (!arguments.length) return padDataOuter;
-    padDataOuter = _;
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.clipVoronoi= function(_) {
-    if (!arguments.length) return clipVoronoi;
-    clipVoronoi = _;
-    return chart;
-  };
-
-  chart.useVoronoi= function(_) {
-    if (!arguments.length) return useVoronoi;
-    useVoronoi = _;
-    if (useVoronoi === false) {
-        clipVoronoi = false;
-    }
-    return chart;
-  };
-
-  chart.clipRadius = function(_) {
-    if (!arguments.length) return clipRadius;
-    clipRadius = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.shape = function(_) {
-    if (!arguments.length) return getShape;
-    getShape = _;
-    return chart;
-  };
-
-  chart.onlyCircles = function(_) {
-    if (!arguments.length) return onlyCircles;
-    onlyCircles = _;
-    return chart;
-  };
-
-  chart.id = function(_) {
-    if (!arguments.length) return id;
-    id = _;
-    return chart;
-  };
-
-  chart.singlePoint = function(_) {
-    if (!arguments.length) return singlePoint;
-    singlePoint = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-nv.models.scatterChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var scatter      = nv.models.scatter()
-    , xAxis        = nv.models.axis()
-    , yAxis        = nv.models.axis()
-    , legend       = nv.models.legend()
-    , controls     = nv.models.legend()
-    , distX        = nv.models.distribution()
-    , distY        = nv.models.distribution()
-    ;
-
-  var margin       = {top: 30, right: 20, bottom: 50, left: 75}
-    , width        = null
-    , height       = null
-    , color        = nv.utils.defaultColor()
-    , x            = d3.fisheye ? d3.fisheye.scale(d3.scale.linear).distortion(0) : scatter.xScale()
-    , y            = d3.fisheye ? d3.fisheye.scale(d3.scale.linear).distortion(0) : scatter.yScale()
-    , xPadding     = 0
-    , yPadding     = 0
-    , showDistX    = false
-    , showDistY    = false
-    , showLegend   = true
-    , showXAxis    = true
-    , showYAxis    = true
-    , rightAlignYAxis = false
-    , showControls = !!d3.fisheye
-    , fisheye      = 0
-    , pauseFisheye = false
-    , tooltips     = true
-    , tooltipX     = function(key, x, y) { return '<strong>' + x + '</strong>' }
-    , tooltipY     = function(key, x, y) { return '<strong>' + y + '</strong>' }
-    , tooltip      = null
-    , state = {}
-    , defaultState = null
-    , dispatch     = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , noData       = "No Data Available."
-    , transitionDuration = 250
-    ;
-
-  scatter
-    .xScale(x)
-    .yScale(y)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(10)
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    .tickPadding(10)
-    ;
-  distX
-    .axis('x')
-    ;
-  distY
-    .axis('y')
-    ;
-
-  controls.updateState(false);
-
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0;
-
-  var showTooltip = function(e, offsetElement) {
-    //TODO: make tooltip style an option between single or dual on axes (maybe on all charts with axes?)
-
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        leftX = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        topX = y.range()[0] + margin.top + ( offsetElement.offsetTop || 0),
-        leftY = x.range()[0] + margin.left + ( offsetElement.offsetLeft || 0 ),
-        topY = e.pos[1] + ( offsetElement.offsetTop || 0),
-        xVal = xAxis.tickFormat()(scatter.x()(e.point, e.pointIndex)),
-        yVal = yAxis.tickFormat()(scatter.y()(e.point, e.pointIndex));
-
-      if( tooltipX != null )
-          nv.tooltip.show([leftX, topX], tooltipX(e.series.key, xVal, yVal, e, chart), 'n', 1, offsetElement, 'x-nvtooltip');
-      if( tooltipY != null )
-          nv.tooltip.show([leftY, topY], tooltipY(e.series.key, xVal, yVal, e, chart), 'e', 1, offsetElement, 'y-nvtooltip');
-      if( tooltip != null )
-          nv.tooltip.show([left, top], tooltip(e.series.key, xVal, yVal, e, chart), e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  var controlsData = [
-    { key: 'Magnify', disabled: true }
-  ];
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart); };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display noData message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x0 = x0 || x;
-      y0 = y0 || y;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-scatterChart').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-scatterChart nv-chart-' + scatter.id());
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      // background for pointer events
-      gEnter.append('rect').attr('class', 'nvd3 nv-background');
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-scatterWrap');
-      gEnter.append('g').attr('class', 'nv-distWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        var legendWidth = (showControls) ? availableWidth / 2 : availableWidth;
-        legend.width(legendWidth);
-
-        wrap.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        wrap.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + (availableWidth - legendWidth) + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        controls.width(180).color(['#444']);
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-            .call(controls);
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      scatter
-          .width(availableWidth)
-          .height(availableHeight)
-          .color(data.map(function(d,i) {
-            return d.color || color(d, i);
-          }).filter(function(d,i) { return !data[i].disabled }));
-
-      if (xPadding !== 0)
-        scatter.xDomain(null);
-
-      if (yPadding !== 0)
-        scatter.yDomain(null);
-
-      wrap.select('.nv-scatterWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-          .call(scatter);
-
-      //Adjust for x and y padding
-      if (xPadding !== 0) {
-        var xRange = x.domain()[1] - x.domain()[0];
-        scatter.xDomain([x.domain()[0] - (xPadding * xRange), x.domain()[1] + (xPadding * xRange)]);
-      }
-
-      if (yPadding !== 0) {
-        var yRange = y.domain()[1] - y.domain()[0];
-        scatter.yDomain([y.domain()[0] - (yPadding * yRange), y.domain()[1] + (yPadding * yRange)]);
-      }
-
-      //Only need to update the scatter again if x/yPadding changed the domain.
-      if (yPadding !== 0 || xPadding !== 0) {
-        wrap.select('.nv-scatterWrap')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(scatter);
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-      if (showXAxis) {
-        xAxis
-            .scale(x)
-            .ticks( xAxis.ticks() && xAxis.ticks().length ? xAxis.ticks() : availableWidth / 100 )
-            .tickSize( -availableHeight , 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')')
-            .call(xAxis);
-
-      }
-
-      if (showYAxis) {
-        yAxis
-            .scale(y)
-            .ticks( yAxis.ticks() && yAxis.ticks().length ? yAxis.ticks() : availableHeight / 36 )
-            .tickSize( -availableWidth, 0);
-
-        g.select('.nv-y.nv-axis')
-            .call(yAxis);
-      }
-
-
-      if (showDistX) {
-        distX
-            .getData(scatter.x())
-            .scale(x)
-            .width(availableWidth)
-            .color(data.map(function(d,i) {
-              return d.color || color(d, i);
-            }).filter(function(d,i) { return !data[i].disabled }));
-        gEnter.select('.nv-distWrap').append('g')
-            .attr('class', 'nv-distributionX');
-        g.select('.nv-distributionX')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distX);
-      }
-
-      if (showDistY) {
-        distY
-            .getData(scatter.y())
-            .scale(y)
-            .width(availableHeight)
-            .color(data.map(function(d,i) {
-              return d.color || color(d, i);
-            }).filter(function(d,i) { return !data[i].disabled }));
-        gEnter.select('.nv-distWrap').append('g')
-            .attr('class', 'nv-distributionY');
-        g.select('.nv-distributionY')
-            .attr('transform', 
-              'translate(' + (rightAlignYAxis ? availableWidth : -distY.size() ) + ',0)')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distY);
-      }
-
-      //------------------------------------------------------------
-
-
-
-
-      if (d3.fisheye) {
-        g.select('.nv-background')
-            .attr('width', availableWidth)
-            .attr('height', availableHeight);
-
-        g.select('.nv-background').on('mousemove', updateFisheye);
-        g.select('.nv-background').on('click', function() { pauseFisheye = !pauseFisheye;});
-        scatter.dispatch.on('elementClick.freezeFisheye', function() {
-          pauseFisheye = !pauseFisheye;
-        });
-      }
-
-
-      function updateFisheye() {
-        if (pauseFisheye) {
-          g.select('.nv-point-paths').style('pointer-events', 'all');
-          return false;
-        }
-
-        g.select('.nv-point-paths').style('pointer-events', 'none' );
-
-        var mouse = d3.mouse(this);
-        x.distortion(fisheye).focus(mouse[0]);
-        y.distortion(fisheye).focus(mouse[1]);
-
-        g.select('.nv-scatterWrap')
-            .call(scatter);
-
-        if (showXAxis)
-          g.select('.nv-x.nv-axis').call(xAxis);
-        
-        if (showYAxis)
-          g.select('.nv-y.nv-axis').call(yAxis);
-        
-        g.select('.nv-distributionX')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distX);
-        g.select('.nv-distributionY')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distY);
-      }
-
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      controls.dispatch.on('legendClick', function(d,i) {
-        d.disabled = !d.disabled;
-
-        fisheye = d.disabled ? 0 : 2.5;
-        g.select('.nv-background') .style('pointer-events', d.disabled ? 'none' : 'all');
-        g.select('.nv-point-paths').style('pointer-events', d.disabled ? 'all' : 'none' );
-
-        if (d.disabled) {
-          x.distortion(fisheye).focus(0);
-          y.distortion(fisheye).focus(0);
-
-          g.select('.nv-scatterWrap').call(scatter);
-          g.select('.nv-x.nv-axis').call(xAxis);
-          g.select('.nv-y.nv-axis').call(yAxis);
-        } else {
-          pauseFisheye = false;
-        }
-
-        chart.update();
-      });
-
-      legend.dispatch.on('stateChange', function(newState) {
-        state.disabled = newState.disabled;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      scatter.dispatch.on('elementMouseover.tooltip', function(e) {
-        d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-distx-' + e.pointIndex)
-            .attr('y1', function(d,i) { return e.pos[1] - availableHeight;});
-        d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-disty-' + e.pointIndex)
-            .attr('x2', e.pos[0] + distX.size());
-
-        e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top];
-        dispatch.tooltipShow(e);
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  scatter.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-
-    d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-distx-' + e.pointIndex)
-        .attr('y1', 0);
-    d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-disty-' + e.pointIndex)
-        .attr('x2', distY.size());
-  });
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.scatter = scatter;
-  chart.legend = legend;
-  chart.controls = controls;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.distX = distX;
-  chart.distY = distY;
-
-  d3.rebind(chart, scatter, 'id', 'interactive', 'pointActive', 'x', 'y', 'shape', 'size', 'xScale', 'yScale', 'zScale', 'xDomain', 'yDomain', 'xRange', 'yRange', 'sizeDomain', 'sizeRange', 'forceX', 'forceY', 'forceSize', 'clipVoronoi', 'clipRadius', 'useVoronoi');
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    distX.color(color);
-    distY.color(color);
-    return chart;
-  };
-
-  chart.showDistX = function(_) {
-    if (!arguments.length) return showDistX;
-    showDistX = _;
-    return chart;
-  };
-
-  chart.showDistY = function(_) {
-    if (!arguments.length) return showDistY;
-    showDistY = _;
-    return chart;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-
-  chart.fisheye = function(_) {
-    if (!arguments.length) return fisheye;
-    fisheye = _;
-    return chart;
-  };
-
-  chart.xPadding = function(_) {
-    if (!arguments.length) return xPadding;
-    xPadding = _;
-    return chart;
-  };
-
-  chart.yPadding = function(_) {
-    if (!arguments.length) return yPadding;
-    yPadding = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.tooltipXContent = function(_) {
-    if (!arguments.length) return tooltipX;
-    tooltipX = _;
-    return chart;
-  };
-
-  chart.tooltipYContent = function(_) {
-    if (!arguments.length) return tooltipY;
-    tooltipY = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-  
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.scatterPlusLineChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var scatter      = nv.models.scatter()
-    , xAxis        = nv.models.axis()
-    , yAxis        = nv.models.axis()
-    , legend       = nv.models.legend()
-    , controls     = nv.models.legend()
-    , distX        = nv.models.distribution()
-    , distY        = nv.models.distribution()
-    ;
-
-  var margin       = {top: 30, right: 20, bottom: 50, left: 75}
-    , width        = null
-    , height       = null
-    , color        = nv.utils.defaultColor()
-    , x            = d3.fisheye ? d3.fisheye.scale(d3.scale.linear).distortion(0) : scatter.xScale()
-    , y            = d3.fisheye ? d3.fisheye.scale(d3.scale.linear).distortion(0) : scatter.yScale()
-    , showDistX    = false
-    , showDistY    = false
-    , showLegend   = true
-    , showXAxis    = true
-    , showYAxis    = true
-    , rightAlignYAxis = false
-    , showControls = !!d3.fisheye
-    , fisheye      = 0
-    , pauseFisheye = false
-    , tooltips     = true
-    , tooltipX     = function(key, x, y) { return '<strong>' + x + '</strong>' }
-    , tooltipY     = function(key, x, y) { return '<strong>' + y + '</strong>' }
-    , tooltip      = function(key, x, y, date) { return '<h3>' + key + '</h3>' 
-                                                      + '<p>' + date + '</p>' }
-    , state = {}
-    , defaultState = null
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , noData       = "No Data Available."
-    , transitionDuration = 250
-    ;
-
-  scatter
-    .xScale(x)
-    .yScale(y)
-    ;
-  xAxis
-    .orient('bottom')
-    .tickPadding(10)
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    .tickPadding(10)
-    ;
-  distX
-    .axis('x')
-    ;
-  distY
-    .axis('y')
-    ;
-  
-  controls.updateState(false);
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var x0, y0;
-
-  var showTooltip = function(e, offsetElement) {
-    //TODO: make tooltip style an option between single or dual on axes (maybe on all charts with axes?)
-
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        leftX = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        topX = y.range()[0] + margin.top + ( offsetElement.offsetTop || 0),
-        leftY = x.range()[0] + margin.left + ( offsetElement.offsetLeft || 0 ),
-        topY = e.pos[1] + ( offsetElement.offsetTop || 0),
-        xVal = xAxis.tickFormat()(scatter.x()(e.point, e.pointIndex)),
-        yVal = yAxis.tickFormat()(scatter.y()(e.point, e.pointIndex));
-
-      if( tooltipX != null )
-          nv.tooltip.show([leftX, topX], tooltipX(e.series.key, xVal, yVal, e, chart), 'n', 1, offsetElement, 'x-nvtooltip');
-      if( tooltipY != null )
-          nv.tooltip.show([leftY, topY], tooltipY(e.series.key, xVal, yVal, e, chart), 'e', 1, offsetElement, 'y-nvtooltip');
-      if( tooltip != null )
-          nv.tooltip.show([left, top], tooltip(e.series.key, xVal, yVal, e.point.tooltip, e, chart), e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  var controlsData = [
-    { key: 'Magnify', disabled: true }
-  ];
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart); };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display noData message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = scatter.xScale();
-      y = scatter.yScale();
-
-      x0 = x0 || x;
-      y0 = y0 || y;
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-scatterChart').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-scatterChart nv-chart-' + scatter.id());
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g')
-
-      // background for pointer events
-      gEnter.append('rect').attr('class', 'nvd3 nv-background').style("pointer-events","none");
-
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-scatterWrap');
-      gEnter.append('g').attr('class', 'nv-regressionLinesWrap');
-      gEnter.append('g').attr('class', 'nv-distWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        legend.width( availableWidth / 2 );
-
-        wrap.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        wrap.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + (availableWidth / 2) + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        controls.width(180).color(['#444']);
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .attr('transform', 'translate(0,' + (-margin.top) +')')
-            .call(controls);
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      scatter
-          .width(availableWidth)
-          .height(availableHeight)
-          .color(data.map(function(d,i) {
-            return d.color || color(d, i);
-          }).filter(function(d,i) { return !data[i].disabled }))
-
-      wrap.select('.nv-scatterWrap')
-          .datum(data.filter(function(d) { return !d.disabled }))
-          .call(scatter);
-
-      wrap.select('.nv-regressionLinesWrap')
-          .attr('clip-path', 'url(#nv-edge-clip-' + scatter.id() + ')');
-
-      var regWrap = wrap.select('.nv-regressionLinesWrap').selectAll('.nv-regLines')
-                      .data(function(d) {return d });
-      
-      regWrap.enter().append('g').attr('class', 'nv-regLines');
-
-      var regLine = regWrap.selectAll('.nv-regLine').data(function(d){return [d]});
-      var regLineEnter = regLine.enter()
-                       .append('line').attr('class', 'nv-regLine')
-                       .style('stroke-opacity', 0);
-
-      regLine
-          .transition()
-          .attr('x1', x.range()[0])
-          .attr('x2', x.range()[1])
-          .attr('y1', function(d,i) {return y(x.domain()[0] * d.slope + d.intercept) })
-          .attr('y2', function(d,i) { return y(x.domain()[1] * d.slope + d.intercept) })
-          .style('stroke', function(d,i,j) { return color(d,j) })
-          .style('stroke-opacity', function(d,i) {
-            return (d.disabled || typeof d.slope === 'undefined' || typeof d.intercept === 'undefined') ? 0 : 1 
-          });
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-        xAxis
-            .scale(x)
-            .ticks( xAxis.ticks() ? xAxis.ticks() : availableWidth / 100 )
-            .tickSize( -availableHeight , 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')')
-            .call(xAxis);
-      }
-
-      if (showYAxis) {
-        yAxis
-            .scale(y)
-            .ticks( yAxis.ticks() ? yAxis.ticks() : availableHeight / 36 )
-            .tickSize( -availableWidth, 0);
-
-        g.select('.nv-y.nv-axis')
-            .call(yAxis);
-      }
-
-
-      if (showDistX) {
-        distX
-            .getData(scatter.x())
-            .scale(x)
-            .width(availableWidth)
-            .color(data.map(function(d,i) {
-              return d.color || color(d, i);
-            }).filter(function(d,i) { return !data[i].disabled }));
-        gEnter.select('.nv-distWrap').append('g')
-            .attr('class', 'nv-distributionX');
-        g.select('.nv-distributionX')
-            .attr('transform', 'translate(0,' + y.range()[0] + ')')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distX);
-      }
-
-      if (showDistY) {
-        distY
-            .getData(scatter.y())
-            .scale(y)
-            .width(availableHeight)
-            .color(data.map(function(d,i) {
-              return d.color || color(d, i);
-            }).filter(function(d,i) { return !data[i].disabled }));
-        gEnter.select('.nv-distWrap').append('g')
-            .attr('class', 'nv-distributionY');
-        g.select('.nv-distributionY')
-            .attr('transform', 'translate(' + (rightAlignYAxis ? availableWidth : -distY.size() ) + ',0)')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distY);
-      }
-
-      //------------------------------------------------------------
-
-
-
-
-      if (d3.fisheye) {
-        g.select('.nv-background')
-            .attr('width', availableWidth)
-            .attr('height', availableHeight)
-            ;
-
-        g.select('.nv-background').on('mousemove', updateFisheye);
-        g.select('.nv-background').on('click', function() { pauseFisheye = !pauseFisheye;});
-        scatter.dispatch.on('elementClick.freezeFisheye', function() {
-          pauseFisheye = !pauseFisheye;
-        });
-      }
-
-
-      function updateFisheye() {
-        if (pauseFisheye) {
-          g.select('.nv-point-paths').style('pointer-events', 'all');
-          return false;
-        }
-
-        g.select('.nv-point-paths').style('pointer-events', 'none' );
-
-        var mouse = d3.mouse(this);
-        x.distortion(fisheye).focus(mouse[0]);
-        y.distortion(fisheye).focus(mouse[1]);
-
-        g.select('.nv-scatterWrap')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(scatter);
-
-        if (showXAxis)
-          g.select('.nv-x.nv-axis').call(xAxis);
-
-        if (showYAxis)
-          g.select('.nv-y.nv-axis').call(yAxis);
-        
-        g.select('.nv-distributionX')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distX);
-        g.select('.nv-distributionY')
-            .datum(data.filter(function(d) { return !d.disabled }))
-            .call(distY);
-      }
-
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      controls.dispatch.on('legendClick', function(d,i) {
-        d.disabled = !d.disabled;
-
-        fisheye = d.disabled ? 0 : 2.5;
-        g.select('.nv-background') .style('pointer-events', d.disabled ? 'none' : 'all');
-        g.select('.nv-point-paths').style('pointer-events', d.disabled ? 'all' : 'none' );
-
-        if (d.disabled) {
-          x.distortion(fisheye).focus(0);
-          y.distortion(fisheye).focus(0);
-
-          g.select('.nv-scatterWrap').call(scatter);
-          g.select('.nv-x.nv-axis').call(xAxis);
-          g.select('.nv-y.nv-axis').call(yAxis);
-        } else {
-          pauseFisheye = false;
-        }
-
-        chart.update();
-      });
-
-      legend.dispatch.on('stateChange', function(newState) { 
-        state = newState;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-
-      scatter.dispatch.on('elementMouseover.tooltip', function(e) {
-        d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-distx-' + e.pointIndex)
-            .attr('y1', e.pos[1] - availableHeight);
-        d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-disty-' + e.pointIndex)
-            .attr('x2', e.pos[0] + distX.size());
-
-        e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top];
-        dispatch.tooltipShow(e);
-      });
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        chart.update();
-      });
-
-      //============================================================
-
-
-      //store old scales for use in transitions on update
-      x0 = x.copy();
-      y0 = y.copy();
-
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  scatter.dispatch.on('elementMouseout.tooltip', function(e) {
-    dispatch.tooltipHide(e);
-
-    d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-distx-' + e.pointIndex)
-        .attr('y1', 0);
-    d3.select('.nv-chart-' + scatter.id() + ' .nv-series-' + e.seriesIndex + ' .nv-disty-' + e.pointIndex)
-        .attr('x2', distY.size());
-  });
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.scatter = scatter;
-  chart.legend = legend;
-  chart.controls = controls;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.distX = distX;
-  chart.distY = distY;
-
-  d3.rebind(chart, scatter, 'id', 'interactive', 'pointActive', 'x', 'y', 'shape', 'size', 'xScale', 'yScale', 'zScale', 'xDomain', 'yDomain', 'xRange', 'yRange', 'sizeDomain', 'sizeRange', 'forceX', 'forceY', 'forceSize', 'clipVoronoi', 'clipRadius', 'useVoronoi');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    distX.color(color);
-    distY.color(color);
-    return chart;
-  };
-
-  chart.showDistX = function(_) {
-    if (!arguments.length) return showDistX;
-    showDistX = _;
-    return chart;
-  };
-
-  chart.showDistY = function(_) {
-    if (!arguments.length) return showDistY;
-    showDistY = _;
-    return chart;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.fisheye = function(_) {
-    if (!arguments.length) return fisheye;
-    fisheye = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.tooltipXContent = function(_) {
-    if (!arguments.length) return tooltipX;
-    tooltipX = _;
-    return chart;
-  };
-
-  chart.tooltipYContent = function(_) {
-    if (!arguments.length) return tooltipY;
-    tooltipY = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.sparkline = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 2, right: 0, bottom: 2, left: 0}
-    , width = 400
-    , height = 32
-    , animate = true
-    , x = d3.scale.linear()
-    , y = d3.scale.linear()
-    , getX = function(d) { return d.x }
-    , getY = function(d) { return d.y }
-    , color = nv.utils.getColor(['#000'])
-    , xDomain
-    , yDomain
-    , xRange
-    , yRange
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x   .domain(xDomain || d3.extent(data, getX ))
-          .range(xRange || [0, availableWidth]);
-
-      y   .domain(yDomain || d3.extent(data, getY ))
-          .range(yRange || [availableHeight, 0]);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-sparkline').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-sparkline');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')')
-
-      //------------------------------------------------------------
-
-
-      var paths = wrap.selectAll('path')
-          .data(function(d) { return [d] });
-      paths.enter().append('path');
-      paths.exit().remove();
-      paths
-          .style('stroke', function(d,i) { return d.color || color(d, i) })
-          .attr('d', d3.svg.line()
-            .x(function(d,i) { return x(getX(d,i)) })
-            .y(function(d,i) { return y(getY(d,i)) })
-          );
-
-
-      // TODO: Add CURRENT data point (Need Min, Mac, Current / Most recent)
-      var points = wrap.selectAll('circle.nv-point')
-          .data(function(data) {
-              var yValues = data.map(function(d, i) { return getY(d,i); });
-              function pointIndex(index) {
-                  if (index != -1) {
-	              var result = data[index];
-                      result.pointIndex = index;
-                      return result;
-                  } else {
-                      return null;
-                  }
-              }
-              var maxPoint = pointIndex(yValues.lastIndexOf(y.domain()[1])),
-                  minPoint = pointIndex(yValues.indexOf(y.domain()[0])),
-                  currentPoint = pointIndex(yValues.length - 1);
-              return [minPoint, maxPoint, currentPoint].filter(function (d) {return d != null;});
-          });
-      points.enter().append('circle');
-      points.exit().remove();
-      points
-          .attr('cx', function(d,i) { return x(getX(d,d.pointIndex)) })
-          .attr('cy', function(d,i) { return y(getY(d,d.pointIndex)) })
-          .attr('r', 2)
-          .attr('class', function(d,i) {
-            return getX(d, d.pointIndex) == x.domain()[1] ? 'nv-point nv-currentValue' :
-                   getY(d, d.pointIndex) == y.domain()[0] ? 'nv-point nv-minValue' : 'nv-point nv-maxValue'
-          });
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = d3.functor(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = d3.functor(_);
-    return chart;
-  };
-
-  chart.xScale = function(_) {
-    if (!arguments.length) return x;
-    x = _;
-    return chart;
-  };
-
-  chart.yScale = function(_) {
-    if (!arguments.length) return y;
-    y = _;
-    return chart;
-  };
-
-  chart.xDomain = function(_) {
-    if (!arguments.length) return xDomain;
-    xDomain = _;
-    return chart;
-  };
-
-  chart.yDomain = function(_) {
-    if (!arguments.length) return yDomain;
-    yDomain = _;
-    return chart;
-  };
-
-  chart.xRange = function(_) {
-    if (!arguments.length) return xRange;
-    xRange = _;
-    return chart;
-  };
-
-  chart.yRange = function(_) {
-    if (!arguments.length) return yRange;
-    yRange = _;
-    return chart;
-  };
-
-  chart.animate = function(_) {
-    if (!arguments.length) return animate;
-    animate = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.sparklinePlus = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var sparkline = nv.models.sparkline();
-
-  var margin = {top: 15, right: 100, bottom: 10, left: 50}
-    , width = null
-    , height = null
-    , x
-    , y
-    , index = []
-    , paused = false
-    , xTickFormat = d3.format(',r')
-    , yTickFormat = d3.format(',.2f')
-    , showValue = true
-    , alignValue = true
-    , rightAlignValue = false
-    , noData = "No Data Available."
-    ;
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this);
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      
-
-      chart.update = function() { chart(selection) };
-      chart.container = this;
-
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      var currentValue = sparkline.y()(data[data.length-1], data.length-1);
-
-      //------------------------------------------------------------
-
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = sparkline.xScale();
-      y = sparkline.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-sparklineplus').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-sparklineplus');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-sparklineWrap');
-      gEnter.append('g').attr('class', 'nv-valueWrap');
-      gEnter.append('g').attr('class', 'nv-hoverArea');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      var sparklineWrap = g.select('.nv-sparklineWrap');
-
-      sparkline
-        .width(availableWidth)
-        .height(availableHeight);
-
-      sparklineWrap
-          .call(sparkline);
-
-      //------------------------------------------------------------
-
-
-      var valueWrap = g.select('.nv-valueWrap');
-      
-      var value = valueWrap.selectAll('.nv-currentValue')
-          .data([currentValue]);
-
-      value.enter().append('text').attr('class', 'nv-currentValue')
-          .attr('dx', rightAlignValue ? -8 : 8)
-          .attr('dy', '.9em')
-          .style('text-anchor', rightAlignValue ? 'end' : 'start');
-
-      value
-          .attr('x', availableWidth + (rightAlignValue ? margin.right : 0))
-          .attr('y', alignValue ? function(d) { return y(d) } : 0)
-          .style('fill', sparkline.color()(data[data.length-1], data.length-1))
-          .text(yTickFormat(currentValue));
-
-
-
-      gEnter.select('.nv-hoverArea').append('rect')
-          .on('mousemove', sparklineHover)
-          .on('click', function() { paused = !paused })
-          .on('mouseout', function() { index = []; updateValueLine(); });
-          //.on('mouseout', function() { index = null; updateValueLine(); });
-
-      g.select('.nv-hoverArea rect')
-          .attr('transform', function(d) { return 'translate(' + -margin.left + ',' + -margin.top + ')' })
-          .attr('width', availableWidth + margin.left + margin.right)
-          .attr('height', availableHeight + margin.top);
-
-
-
-      function updateValueLine() { //index is currently global (within the chart), may or may not keep it that way
-        if (paused) return;
-
-        var hoverValue = g.selectAll('.nv-hoverValue').data(index)
-
-        var hoverEnter = hoverValue.enter()
-          .append('g').attr('class', 'nv-hoverValue')
-            .style('stroke-opacity', 0)
-            .style('fill-opacity', 0);
-
-        hoverValue.exit()
-          .transition().duration(250)
-            .style('stroke-opacity', 0)
-            .style('fill-opacity', 0)
-            .remove();
-
-        hoverValue
-            .attr('transform', function(d) { return 'translate(' + x(sparkline.x()(data[d],d)) + ',0)' })
-          .transition().duration(250)
-            .style('stroke-opacity', 1)
-            .style('fill-opacity', 1);
-
-        if (!index.length) return;
-
-        hoverEnter.append('line')
-            .attr('x1', 0)
-            .attr('y1', -margin.top)
-            .attr('x2', 0)
-            .attr('y2', availableHeight);
-
-
-        hoverEnter.append('text').attr('class', 'nv-xValue')
-            .attr('x', -6)
-            .attr('y', -margin.top)
-            .attr('text-anchor', 'end')
-            .attr('dy', '.9em')
-
-
-        g.select('.nv-hoverValue .nv-xValue')
-            .text(xTickFormat(sparkline.x()(data[index[0]], index[0])));
-
-        hoverEnter.append('text').attr('class', 'nv-yValue')
-            .attr('x', 6)
-            .attr('y', -margin.top)
-            .attr('text-anchor', 'start')
-            .attr('dy', '.9em')
-
-        g.select('.nv-hoverValue .nv-yValue')
-            .text(yTickFormat(sparkline.y()(data[index[0]], index[0])));
-
-      }
-
-
-      function sparklineHover() {
-        if (paused) return;
-
-        var pos = d3.mouse(this)[0] - margin.left;
-
-        function getClosestIndex(data, x) {
-          var distance = Math.abs(sparkline.x()(data[0], 0) - x);
-          var closestIndex = 0;
-          for (var i = 0; i < data.length; i++){
-            if (Math.abs(sparkline.x()(data[i], i) - x) < distance) {
-              distance = Math.abs(sparkline.x()(data[i], i) - x);
-              closestIndex = i;
-            }
-          }
-          return closestIndex;
-        }
-
-        index = [getClosestIndex(data, Math.round(x.invert(pos)))];
-
-        updateValueLine();
-      }
-
-    });
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.sparkline = sparkline;
-
-  d3.rebind(chart, sparkline, 'x', 'y', 'xScale', 'yScale', 'color');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.xTickFormat = function(_) {
-    if (!arguments.length) return xTickFormat;
-    xTickFormat = _;
-    return chart;
-  };
-
-  chart.yTickFormat = function(_) {
-    if (!arguments.length) return yTickFormat;
-    yTickFormat = _;
-    return chart;
-  };
-
-  chart.showValue = function(_) {
-    if (!arguments.length) return showValue;
-    showValue = _;
-    return chart;
-  };
-
-  chart.alignValue = function(_) {
-    if (!arguments.length) return alignValue;
-    alignValue = _;
-    return chart;
-  };
-
-  chart.rightAlignValue = function(_) {
-    if (!arguments.length) return rightAlignValue;
-    rightAlignValue = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.stackedArea = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var margin = {top: 0, right: 0, bottom: 0, left: 0}
-    , width = 960
-    , height = 500
-    , color = nv.utils.defaultColor() // a function that computes the color
-    , id = Math.floor(Math.random() * 100000) //Create semi-unique ID incase user doesn't selet one
-    , getX = function(d) { return d.x } // accessor to get the x value from a data point
-    , getY = function(d) { return d.y } // accessor to get the y value from a data point
-    , style = 'stack'
-    , offset = 'zero'
-    , order = 'default'
-    , interpolate = 'linear'  // controls the line interpolation
-    , clipEdge = false // if true, masks lines within x and y scale
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , scatter = nv.models.scatter()
-    , dispatch =  d3.dispatch('tooltipShow', 'tooltipHide', 'areaClick', 'areaMouseover', 'areaMouseout')
-    ;
-
-  scatter
-    .size(2.2) // default size
-    .sizeDomain([2.2,2.2]) // all the same size by default
-    ;
-
-  /************************************
-   * offset:
-   *   'wiggle' (stream)
-   *   'zero' (stacked)
-   *   'expand' (normalize to 100%)
-   *   'silhouette' (simple centered)
-   *
-   * order:
-   *   'inside-out' (stream)
-   *   'default' (input order)
-   ************************************/
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var availableWidth = width - margin.left - margin.right,
-          availableHeight = height - margin.top - margin.bottom,
-          container = d3.select(this);
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = scatter.xScale();
-      y = scatter.yScale();
-
-      //------------------------------------------------------------
-
-
-      // Injecting point index into each point because d3.layout.stack().out does not give index
-      data = data.map(function(aseries, i) {
-               aseries.seriesIndex = i;
-               aseries.values = aseries.values.map(function(d, j) {
-                 d.index = j;
-                 d.seriesIndex = i;
-                 return d;
-               })
-               return aseries;
-             });
-
-      var dataFiltered = data.filter(function(series) {
-            return !series.disabled;
-      });
-
-      data = d3.layout.stack()
-               .order(order)
-               .offset(offset)
-               .values(function(d) { return d.values })  //TODO: make values customizeable in EVERY model in this fashion
-               .x(getX)
-               .y(getY)
-               .out(function(d, y0, y) {
-                    var yHeight = (getY(d) === 0) ? 0 : y;
-                    d.display = {
-                      y: yHeight,
-                     y0: y0
-                    };
-                })
-              (dataFiltered);
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-stackedarea').data([data]);
-      var wrapEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-stackedarea');
-      var defsEnter = wrapEnter.append('defs');
-      var gEnter = wrapEnter.append('g');
-      var g = wrap.select('g');
-
-      gEnter.append('g').attr('class', 'nv-areaWrap');
-      gEnter.append('g').attr('class', 'nv-scatterWrap');
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      //------------------------------------------------------------
-
-
-      scatter
-        .width(availableWidth)
-        .height(availableHeight)
-        .x(getX)
-        .y(function(d) { return d.display.y + d.display.y0 })
-        .forceY([0])
-        .color(data.map(function(d,i) {
-          return d.color || color(d, d.seriesIndex);
-        }));
-
-
-      var scatterWrap = g.select('.nv-scatterWrap')
-          .datum(data);
-
-      scatterWrap.call(scatter);
-
-      defsEnter.append('clipPath')
-          .attr('id', 'nv-edge-clip-' + id)
-        .append('rect');
-
-      wrap.select('#nv-edge-clip-' + id + ' rect')
-          .attr('width', availableWidth)
-          .attr('height', availableHeight);
-
-      g   .attr('clip-path', clipEdge ? 'url(#nv-edge-clip-' + id + ')' : '');
-
-      var area = d3.svg.area()
-          .x(function(d,i)  { return x(getX(d,i)) })
-          .y0(function(d) { 
-              return y(d.display.y0) 
-          })
-          .y1(function(d) { 
-              return y(d.display.y + d.display.y0) 
-          })
-          .interpolate(interpolate);
-
-      var zeroArea = d3.svg.area()
-          .x(function(d,i)  { return x(getX(d,i)) })
-          .y0(function(d) { return y(d.display.y0) })
-          .y1(function(d) { return y(d.display.y0) });
-
-
-      var path = g.select('.nv-areaWrap').selectAll('path.nv-area')
-          .data(function(d) { return d });
-
-      path.enter().append('path').attr('class', function(d,i) { return 'nv-area nv-area-' + i })
-          .attr('d', function(d,i){
-            return zeroArea(d.values, d.seriesIndex);
-          })
-          .on('mouseover', function(d,i) {
-            d3.select(this).classed('hover', true);
-            dispatch.areaMouseover({
-              point: d,
-              series: d.key,
-              pos: [d3.event.pageX, d3.event.pageY],
-              seriesIndex: i
-            });
-          })
-          .on('mouseout', function(d,i) {
-            d3.select(this).classed('hover', false);
-            dispatch.areaMouseout({
-              point: d,
-              series: d.key,
-              pos: [d3.event.pageX, d3.event.pageY],
-              seriesIndex: i
-            });
-          })
-          .on('click', function(d,i) {
-            d3.select(this).classed('hover', false);
-            dispatch.areaClick({
-              point: d,
-              series: d.key,
-              pos: [d3.event.pageX, d3.event.pageY],
-              seriesIndex: i
-            });
-          })
-      path.exit().transition()
-          .attr('d', function(d,i) { return zeroArea(d.values,i) })
-          .remove();
-      path
-          .style('fill', function(d,i){ 
-            return d.color || color(d, d.seriesIndex) 
-          })
-          .style('stroke', function(d,i){ return d.color || color(d, d.seriesIndex) });
-      path.transition()
-          .attr('d', function(d,i) { 
-            return area(d.values,i) 
-          });
-
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      scatter.dispatch.on('elementMouseover.area', function(e) {
-        g.select('.nv-chart-' + id + ' .nv-area-' + e.seriesIndex).classed('hover', true);
-      });
-      scatter.dispatch.on('elementMouseout.area', function(e) {
-        g.select('.nv-chart-' + id + ' .nv-area-' + e.seriesIndex).classed('hover', false);
-      });
-
-      //============================================================
-
-    });
-
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  scatter.dispatch.on('elementClick.area', function(e) {
-    dispatch.areaClick(e);
-  })
-  scatter.dispatch.on('elementMouseover.tooltip', function(e) {
-        e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top],
-        dispatch.tooltipShow(e);
-  });
-  scatter.dispatch.on('elementMouseout.tooltip', function(e) {
-        dispatch.tooltipHide(e);
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Global getters and setters
-  //------------------------------------------------------------
-
-  chart.dispatch = dispatch;
-  chart.scatter = scatter;
-
-  d3.rebind(chart, scatter, 'interactive', 'size', 'xScale', 'yScale', 'zScale', 'xDomain', 'yDomain', 'xRange', 'yRange', 
-    'sizeDomain', 'forceX', 'forceY', 'forceSize', 'clipVoronoi', 'useVoronoi','clipRadius','highlightPoint','clearHighlights');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.x = function(_) {
-    if (!arguments.length) return getX;
-    getX = d3.functor(_);
-    return chart;
-  };
-
-  chart.y = function(_) {
-    if (!arguments.length) return getY;
-    getY = d3.functor(_);
-    return chart;
-  }
-
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.clipEdge = function(_) {
-    if (!arguments.length) return clipEdge;
-    clipEdge = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    return chart;
-  };
-
-  chart.offset = function(_) {
-    if (!arguments.length) return offset;
-    offset = _;
-    return chart;
-  };
-
-  chart.order = function(_) {
-    if (!arguments.length) return order;
-    order = _;
-    return chart;
-  };
-
-  //shortcut for offset + order
-  chart.style = function(_) {
-    if (!arguments.length) return style;
-    style = _;
-
-    switch (style) {
-      case 'stack':
-        chart.offset('zero');
-        chart.order('default');
-        break;
-      case 'stream':
-        chart.offset('wiggle');
-        chart.order('inside-out');
-        break;
-      case 'stream-center':
-          chart.offset('silhouette');
-          chart.order('inside-out');
-          break;
-      case 'expand':
-        chart.offset('expand');
-        chart.order('default');
-        break;
-    }
-
-    return chart;
-  };
-
-  chart.interpolate = function(_) {
-	    if (!arguments.length) return interpolate;
-	    interpolate = _;
-	    return chart;
-  };
-  //============================================================
-
-
-  return chart;
-}
-
-nv.models.stackedAreaChart = function() {
-  "use strict";
-  //============================================================
-  // Public Variables with Default Settings
-  //------------------------------------------------------------
-
-  var stacked = nv.models.stackedArea()
-    , xAxis = nv.models.axis()
-    , yAxis = nv.models.axis()
-    , legend = nv.models.legend()
-    , controls = nv.models.legend()
-    , interactiveLayer = nv.interactiveGuideline()
-    ;
-
-  var margin = {top: 30, right: 25, bottom: 50, left: 60}
-    , width = null
-    , height = null
-    , color = nv.utils.defaultColor() // a function that takes in d, i and returns color
-    , showControls = true
-    , showLegend = true
-    , showXAxis = true
-    , showYAxis = true
-    , rightAlignYAxis = false
-    , useInteractiveGuideline = false
-    , tooltips = true
-    , tooltip = function(key, x, y, e, graph) {
-        return '<h3>' + key + '</h3>' +
-               '<p>' +  y + ' on ' + x + '</p>'
-      }
-    , x //can be accessed via chart.xScale()
-    , y //can be accessed via chart.yScale()
-    , yAxisTickFormat = d3.format(',.2f')
-    , state = { style: stacked.style() }
-    , defaultState = null
-    , noData = 'No Data Available.'
-    , dispatch = d3.dispatch('tooltipShow', 'tooltipHide', 'stateChange', 'changeState')
-    , controlWidth = 250
-    , cData = ['Stacked','Stream','Expanded']
-    , transitionDuration = 250
-    ;
-
-  xAxis
-    .orient('bottom')
-    .tickPadding(7)
-    ;
-  yAxis
-    .orient((rightAlignYAxis) ? 'right' : 'left')
-    ;
-
-  controls.updateState(false);
-  //============================================================
-
-
-  //============================================================
-  // Private Variables
-  //------------------------------------------------------------
-
-  var showTooltip = function(e, offsetElement) {
-    var left = e.pos[0] + ( offsetElement.offsetLeft || 0 ),
-        top = e.pos[1] + ( offsetElement.offsetTop || 0),
-        x = xAxis.tickFormat()(stacked.x()(e.point, e.pointIndex)),
-        y = yAxis.tickFormat()(stacked.y()(e.point, e.pointIndex)),
-        content = tooltip(e.series.key, x, y, e, chart);
-
-    nv.tooltip.show([left, top], content, e.value < 0 ? 'n' : 's', null, offsetElement);
-  };
-
-  //============================================================
-
-
-  function chart(selection) {
-    selection.each(function(data) {
-      var container = d3.select(this),
-          that = this;
-
-      var availableWidth = (width  || parseInt(container.style('width')) || 960)
-                             - margin.left - margin.right,
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-
-      chart.update = function() { container.transition().duration(transitionDuration).call(chart); };
-      chart.container = this;
-
-      //set state.disabled
-      state.disabled = data.map(function(d) { return !!d.disabled });
-
-      if (!defaultState) {
-        var key;
-        defaultState = {};
-        for (key in state) {
-          if (state[key] instanceof Array)
-            defaultState[key] = state[key].slice(0);
-          else
-            defaultState[key] = state[key];
-        }
-      }
-
-      //------------------------------------------------------------
-      // Display No Data message if there's nothing to show.
-
-      if (!data || !data.length || !data.filter(function(d) { return d.values.length }).length) {
-        var noDataText = container.selectAll('.nv-noData').data([noData]);
-
-        noDataText.enter().append('text')
-          .attr('class', 'nvd3 nv-noData')
-          .attr('dy', '-.7em')
-          .style('text-anchor', 'middle');
-
-        noDataText
-          .attr('x', margin.left + availableWidth / 2)
-          .attr('y', margin.top + availableHeight / 2)
-          .text(function(d) { return d });
-
-        return chart;
-      } else {
-        container.selectAll('.nv-noData').remove();
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Scales
-
-      x = stacked.xScale();
-      y = stacked.yScale();
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup containers and skeleton of chart
-
-      var wrap = container.selectAll('g.nv-wrap.nv-stackedAreaChart').data([data]);
-      var gEnter = wrap.enter().append('g').attr('class', 'nvd3 nv-wrap nv-stackedAreaChart').append('g');
-      var g = wrap.select('g');
-
-      gEnter.append("rect").style("opacity",0);
-      gEnter.append('g').attr('class', 'nv-x nv-axis');
-      gEnter.append('g').attr('class', 'nv-y nv-axis');
-      gEnter.append('g').attr('class', 'nv-stackedWrap');
-      gEnter.append('g').attr('class', 'nv-legendWrap');
-      gEnter.append('g').attr('class', 'nv-controlsWrap');
-      gEnter.append('g').attr('class', 'nv-interactive');
-
-      g.select("rect").attr("width",availableWidth).attr("height",availableHeight);
-      //------------------------------------------------------------
-      // Legend
-
-      if (showLegend) {
-        var legendWidth = (showControls) ? availableWidth - controlWidth : availableWidth;
-        legend
-          .width(legendWidth);
-
-        g.select('.nv-legendWrap')
-            .datum(data)
-            .call(legend);
-
-        if ( margin.top != legend.height()) {
-          margin.top = legend.height();
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-        g.select('.nv-legendWrap')
-            .attr('transform', 'translate(' + (availableWidth-legendWidth) + ',' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Controls
-
-      if (showControls) {
-        var controlsData = [
-          { key: 'Stacked', disabled: stacked.offset() != 'zero' },
-          { key: 'Stream', disabled: stacked.offset() != 'wiggle' },
-          { key: 'Expanded', disabled: stacked.offset() != 'expand' }
-        ];
-
-        controlWidth = (cData.length/3) * 260;
-
-        controlsData = controlsData.filter(function(d) {
-          return cData.indexOf(d.key) > -1;
-        })
-
-        controls
-          .width( controlWidth )
-          .color(['#444', '#444', '#444']);
-
-        g.select('.nv-controlsWrap')
-            .datum(controlsData)
-            .call(controls);
-
-
-        if ( margin.top != Math.max(controls.height(), legend.height()) ) {
-          margin.top = Math.max(controls.height(), legend.height());
-          availableHeight = (height || parseInt(container.style('height')) || 400)
-                             - margin.top - margin.bottom;
-        }
-
-
-        g.select('.nv-controlsWrap')
-            .attr('transform', 'translate(0,' + (-margin.top) +')');
-      }
-
-      //------------------------------------------------------------
-
-
-      wrap.attr('transform', 'translate(' + margin.left + ',' + margin.top + ')');
-
-      if (rightAlignYAxis) {
-          g.select(".nv-y.nv-axis")
-              .attr("transform", "translate(" + availableWidth + ",0)");
-      }
-
-      //------------------------------------------------------------
-      // Main Chart Component(s)
-
-      //------------------------------------------------------------
-      //Set up interactive layer
-      if (useInteractiveGuideline) {
-        interactiveLayer
-           .width(availableWidth)
-           .height(availableHeight)
-           .margin({left: margin.left, top: margin.top})
-           .svgContainer(container)
-           .xScale(x);
-        wrap.select(".nv-interactive").call(interactiveLayer);
-      }
-      
-      stacked
-        .width(availableWidth)
-        .height(availableHeight)
-
-      var stackedWrap = g.select('.nv-stackedWrap')
-          .datum(data);
-
-      stackedWrap.transition().call(stacked);
-
-      //------------------------------------------------------------
-
-
-      //------------------------------------------------------------
-      // Setup Axes
-
-      if (showXAxis) {
-        xAxis
-          .scale(x)
-          .ticks( availableWidth / 100 )
-          .tickSize( -availableHeight, 0);
-
-        g.select('.nv-x.nv-axis')
-            .attr('transform', 'translate(0,' + availableHeight + ')');
- 
-        g.select('.nv-x.nv-axis')
-          .transition().duration(0)
-            .call(xAxis);
-      }
-
-      if (showYAxis) {
-        yAxis
-          .scale(y)
-          .ticks(stacked.offset() == 'wiggle' ? 0 : availableHeight / 36)
-          .tickSize(-availableWidth, 0)
-          .setTickFormat(stacked.offset() == 'expand' ? d3.format('%') : yAxisTickFormat);
-
-        g.select('.nv-y.nv-axis')
-          .transition().duration(0)
-            .call(yAxis);
-      }
-
-      //------------------------------------------------------------
-
-
-      //============================================================
-      // Event Handling/Dispatching (in chart's scope)
-      //------------------------------------------------------------
-
-      stacked.dispatch.on('areaClick.toggle', function(e) {
-        if (data.filter(function(d) { return !d.disabled }).length === 1)
-          data = data.map(function(d) {
-            d.disabled = false;
-            return d
-          });
-        else
-          data = data.map(function(d,i) {
-            d.disabled = (i != e.seriesIndex);
-            return d
-          });
-
-        state.disabled = data.map(function(d) { return !!d.disabled });
-        dispatch.stateChange(state);
-
-        chart.update();
-      });
-
-      legend.dispatch.on('stateChange', function(newState) {
-        state.disabled = newState.disabled;
-        dispatch.stateChange(state);
-        chart.update();
-      });
-
-      controls.dispatch.on('legendClick', function(d,i) {
-        if (!d.disabled) return;
-
-        controlsData = controlsData.map(function(s) {
-          s.disabled = true;
-          return s;
-        });
-        d.disabled = false;
-
-        switch (d.key) {
-          case 'Stacked':
-            stacked.style('stack');
-            break;
-          case 'Stream':
-            stacked.style('stream');
-            break;
-          case 'Expanded':
-            stacked.style('expand');
-            break;
-        }
-
-        state.style = stacked.style();
-        dispatch.stateChange(state);
-
-        chart.update();
-      });
-
-
-      interactiveLayer.dispatch.on('elementMousemove', function(e) {
-          stacked.clearHighlights();
-          var singlePoint, pointIndex, pointXLocation, allData = [];
-          data
-          .filter(function(series, i) { 
-            series.seriesIndex = i;
-            return !series.disabled; 
-          })
-          .forEach(function(series,i) {
-              pointIndex = nv.interactiveBisect(series.values, e.pointXValue, chart.x());
-              stacked.highlightPoint(i, pointIndex, true);
-              var point = series.values[pointIndex];
-              if (typeof point === 'undefined') return;
-              if (typeof singlePoint === 'undefined') singlePoint = point;
-              if (typeof pointXLocation === 'undefined') pointXLocation = chart.xScale()(chart.x()(point,pointIndex));
-              allData.push({
-                  key: series.key,
-                  value: chart.y()(point, pointIndex),
-                  color: color(series,series.seriesIndex),
-                  stackedValue: point.display
-              });
-          });
-
-          allData.reverse();
-
-          //Highlight the tooltip entry based on which stack the mouse is closest to.
-          if (allData.length > 2) {
-            var yValue = chart.yScale().invert(e.mouseY);
-            var yDistMax = Infinity, indexToHighlight = null;
-            allData.forEach(function(series,i) {
-               if ( yValue >= series.stackedValue.y0 && yValue <= (series.stackedValue.y0 + series.stackedValue.y))
-               {
-                  indexToHighlight = i;
-                  return;
-               }
-            });
-            if (indexToHighlight != null)
-               allData[indexToHighlight].highlight = true;
-          }
-
-          var xValue = xAxis.tickFormat()(chart.x()(singlePoint,pointIndex));
-          interactiveLayer.tooltip
-                  .position({left: pointXLocation + margin.left, top: e.mouseY + margin.top})
-                  .chartContainer(that.parentNode)
-                  .enabled(tooltips)
-                  .valueFormatter(function(d,i) {
-                     return yAxis.tickFormat()(d);
-                  })
-                  .data(
-                      {
-                        value: xValue,
-                        series: allData
-                      }
-                  )();
-
-          interactiveLayer.renderGuideLine(pointXLocation);
-
-      });
-
-      interactiveLayer.dispatch.on("elementMouseout",function(e) {
-          dispatch.tooltipHide();
-          stacked.clearHighlights();
-      });
-
-
-      dispatch.on('tooltipShow', function(e) {
-        if (tooltips) showTooltip(e, that.parentNode);
-      });
-
-      // Update chart from a state object passed to event handler
-      dispatch.on('changeState', function(e) {
-
-        if (typeof e.disabled !== 'undefined') {
-          data.forEach(function(series,i) {
-            series.disabled = e.disabled[i];
-          });
-
-          state.disabled = e.disabled;
-        }
-
-        if (typeof e.style !== 'undefined') {
-          stacked.style(e.style);
-        }
-
-        chart.update();
-      });
-
-    });
-
-
-    return chart;
-  }
-
-
-  //============================================================
-  // Event Handling/Dispatching (out of chart's scope)
-  //------------------------------------------------------------
-
-  stacked.dispatch.on('tooltipShow', function(e) {
-    //disable tooltips when value ~= 0
-    //// TODO: consider removing points from voronoi that have 0 value instead of this hack
-    /*
-    if (!Math.round(stacked.y()(e.point) * 100)) {  // 100 will not be good for very small numbers... will have to think about making this valu dynamic, based on data range
-      setTimeout(function() { d3.selectAll('.point.hover').classed('hover', false) }, 0);
-      return false;
-    }
-   */
-
-    e.pos = [e.pos[0] + margin.left, e.pos[1] + margin.top],
-    dispatch.tooltipShow(e);
-  });
-
-  stacked.dispatch.on('tooltipHide', function(e) {
-    dispatch.tooltipHide(e);
-  });
-
-  dispatch.on('tooltipHide', function() {
-    if (tooltips) nv.tooltip.cleanup();
-  });
-
-  //============================================================
-
-
-  //============================================================
-  // Expose Public Variables
-  //------------------------------------------------------------
-
-  // expose chart's sub-components
-  chart.dispatch = dispatch;
-  chart.stacked = stacked;
-  chart.legend = legend;
-  chart.controls = controls;
-  chart.xAxis = xAxis;
-  chart.yAxis = yAxis;
-  chart.interactiveLayer = interactiveLayer;
-
-  d3.rebind(chart, stacked, 'x', 'y', 'size', 'xScale', 'yScale', 'xDomain', 'yDomain', 'xRange', 'yRange', 'sizeDomain', 'interactive', 'useVoronoi', 'offset', 'order', 'style', 'clipEdge', 'forceX', 'forceY', 'forceSize', 'interpolate');
-
-  chart.options = nv.utils.optionsFunc.bind(chart);
-  
-  chart.margin = function(_) {
-    if (!arguments.length) return margin;
-    margin.top    = typeof _.top    != 'undefined' ? _.top    : margin.top;
-    margin.right  = typeof _.right  != 'undefined' ? _.right  : margin.right;
-    margin.bottom = typeof _.bottom != 'undefined' ? _.bottom : margin.bottom;
-    margin.left   = typeof _.left   != 'undefined' ? _.left   : margin.left;
-    return chart;
-  };
-
-  chart.width = function(_) {
-    if (!arguments.length) return width;
-    width = _;
-    return chart;
-  };
-
-  chart.height = function(_) {
-    if (!arguments.length) return height;
-    height = _;
-    return chart;
-  };
-
-  chart.color = function(_) {
-    if (!arguments.length) return color;
-    color = nv.utils.getColor(_);
-    legend.color(color);
-    stacked.color(color);
-    return chart;
-  };
-
-  chart.showControls = function(_) {
-    if (!arguments.length) return showControls;
-    showControls = _;
-    return chart;
-  };
-
-  chart.showLegend = function(_) {
-    if (!arguments.length) return showLegend;
-    showLegend = _;
-    return chart;
-  };
-
-  chart.showXAxis = function(_) {
-    if (!arguments.length) return showXAxis;
-    showXAxis = _;
-    return chart;
-  };
-
-  chart.showYAxis = function(_) {
-    if (!arguments.length) return showYAxis;
-    showYAxis = _;
-    return chart;
-  };
-
-  chart.rightAlignYAxis = function(_) {
-    if(!arguments.length) return rightAlignYAxis;
-    rightAlignYAxis = _;
-    yAxis.orient( (_) ? 'right' : 'left');
-    return chart;
-  };
-
-  chart.useInteractiveGuideline = function(_) {
-    if(!arguments.length) return useInteractiveGuideline;
-    useInteractiveGuideline = _;
-    if (_ === true) {
-       chart.interactive(false);
-       chart.useVoronoi(false);
-    }
-    return chart;
-  };
-
-  chart.tooltip = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.tooltips = function(_) {
-    if (!arguments.length) return tooltips;
-    tooltips = _;
-    return chart;
-  };
-
-  chart.tooltipContent = function(_) {
-    if (!arguments.length) return tooltip;
-    tooltip = _;
-    return chart;
-  };
-
-  chart.state = function(_) {
-    if (!arguments.length) return state;
-    state = _;
-    return chart;
-  };
-
-  chart.defaultState = function(_) {
-    if (!arguments.length) return defaultState;
-    defaultState = _;
-    return chart;
-  };
-
-  chart.noData = function(_) {
-    if (!arguments.length) return noData;
-    noData = _;
-    return chart;
-  };
-
-  chart.transitionDuration = function(_) {
-    if (!arguments.length) return transitionDuration;
-    transitionDuration = _;
-    return chart;
-  };
-
-  chart.controlsData = function(_) {
-    if (!arguments.length) return cData;
-    cData = _;
-    return chart;
-  };
-
-  yAxis.setTickFormat = yAxis.tickFormat;
-
-  yAxis.tickFormat = function(_) {
-    if (!arguments.length) return yAxisTickFormat;
-    yAxisTickFormat = _;
-    return yAxis;
-  };
-
-
-  //============================================================
-
-  return chart;
-}
-})();
\ No newline at end of file
diff --git a/airflow/www_rbac/static_config.py b/airflow/www_rbac/static_config.py
new file mode 100644
index 0000000000000..278c499eee5e1
--- /dev/null
+++ b/airflow/www_rbac/static_config.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from __future__ import print_function
+
+import json
+import os
+
+manifest = dict()
+
+
+def configure_manifest_files(app):
+    """
+    Loads the manifest file and register the `url_for_asset_` template tag.
+    :param app:
+    :return:
+    """
+
+    def parse_manifest_json():
+        # noinspection PyBroadException
+        try:
+            global manifest
+            manifest_file = os.path.join(os.path.dirname(__file__),
+                                         'static/dist/manifest.json')
+            with open(manifest_file, 'r') as f:
+                manifest.update(json.load(f))
+        except Exception:
+            print("Please make sure to build the frontend in "
+                  "static/ directory and restart the server")
+            pass
+
+    def get_asset_url(filename):
+        if app.debug:
+            parse_manifest_json()
+        return '/static/dist/{}'.format(manifest.get(filename, ''))
+
+    parse_manifest_json()
+
+    @app.context_processor
+    def get_url_for_asset():
+        """
+        Template tag to return the asset URL.
+        WebPack renders the assets after minification and modification
+        under the static/dist folder.
+        This template tag reads the asset name in manifest.json and returns
+        the appropriate file.
+        """
+        return dict(url_for_asset=get_asset_url)
diff --git a/airflow/www_rbac/templates/airflow/chart.html b/airflow/www_rbac/templates/airflow/chart.html
index 983a8dc055ab1..82ce7a1096ce7 100644
--- a/airflow/www_rbac/templates/airflow/chart.html
+++ b/airflow/www_rbac/templates/airflow/chart.html
@@ -21,15 +21,14 @@
 {% block head_css %}
 {{ super() }}
 <link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='tree.css') }}">
+    href="{{ url_for('static', filename='css/tree.css') }}">
 <link rel="stylesheet" type="text/css"
     href="{{ url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.css')}}" >
+<link href="{{ url_for_asset('dataTables.bootstrap.min.css') }}" rel="stylesheet" type="text/css" >
 <link rel="stylesheet" type="text/css"
-      href="{{ url_for("static", filename="dataTables.bootstrap.css") }}">
-<link rel="stylesheet" type="text/css"
-      href="{{ url_for("static", filename="nv.d3.css") }}">
-<script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-<script src="{{ url_for('static', filename='nv.d3.js') }}"></script>
+      href="{{ url_for_asset('nv.d3.min.css') }}">
+<script src="{{ url_for_asset('d3.min.js') }}"></script>
+<script src="{{ url_for_asset('nv.d3.min.js') }}"></script>
 {% endblock %}
 
 {% block content %}
diff --git a/airflow/www_rbac/templates/airflow/circles.html b/airflow/www_rbac/templates/airflow/circles.html
index 027b4ff4e464e..3362540a84f2f 100644
--- a/airflow/www_rbac/templates/airflow/circles.html
+++ b/airflow/www_rbac/templates/airflow/circles.html
@@ -1,13 +1,13 @@
-{# 
+{#
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
-  
+
     http://www.apache.org/licenses/LICENSE-2.0
-  
+
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -26,7 +26,7 @@ <h1>Airflow 404 = lots of circles</h1>
         <svg></svg>
 
     </div>
-    <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
+    <script src="{{ url_for_asset('d3.min.js') }}"></script>
     <script>
     var height =700;
     var width = document.getElementById("div_svg").offsetWidth;
diff --git a/airflow/www_rbac/templates/airflow/conn_create.html b/airflow/www_rbac/templates/airflow/conn_create.html
index 5e6326cab2566..02bade6c4e803 100644
--- a/airflow/www_rbac/templates/airflow/conn_create.html
+++ b/airflow/www_rbac/templates/airflow/conn_create.html
@@ -1,13 +1,13 @@
-{# 
+{#
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
-  
+
     http://www.apache.org/licenses/LICENSE-2.0
-  
+
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -19,5 +19,5 @@
 
 {% block tail %}
   {{ super() }}
-    <script src="{{ url_for('static', filename='connection_form.js') }}"></script>
+    <script src="{{ url_for_asset('connectionForm.js') }}"></script>
 {% endblock %}
diff --git a/airflow/www_rbac/templates/airflow/conn_edit.html b/airflow/www_rbac/templates/airflow/conn_edit.html
index 2ff44be88dba2..b1cac51992fc9 100644
--- a/airflow/www_rbac/templates/airflow/conn_edit.html
+++ b/airflow/www_rbac/templates/airflow/conn_edit.html
@@ -1,13 +1,13 @@
-{# 
+{#
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
-  
+
     http://www.apache.org/licenses/LICENSE-2.0
-  
+
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -19,5 +19,5 @@
 
 {% block tail %}
   {{ super() }}
-    <script src="{{ url_for('static', filename='connection_form.js') }}"></script>
+    <script src="{{ url_for_asset('static', filename='connectionForm.js') }}"></script>
 {% endblock %}
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index e6495fe4be9da..7073d1795c29a 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -21,8 +21,7 @@
 
 {% block head_css %}
   {{ super() }}
-  <link href="{{ url_for('static', filename='main.css') }}" rel="stylesheet">
-  <link href="{{ url_for('static', filename='bootstrap-toggle.min.css') }}" rel="stylesheet" type="text/css">
+  <link href="{{ url_for_asset('bootstrap-toggle.min.css') }}" rel="stylesheet" type="text/css">
 {% endblock %}
 
 {% block content %}
@@ -53,48 +52,48 @@ <h4 class="pull-right">
               Back to {{ dag.parent_dag.dag_id }}</a>
           </li>
       {% endif %}
-      <li><a href="{{ url_for("Airflow.graph", dag_id=dag.dag_id, root=root) }}">
+      <li><a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, root=root) }}">
           <span class="glyphicon glyphicon-certificate" aria-hidden="true"></span>
         Graph View</a></li>
-      <li><a href="{{ url_for("Airflow.tree", dag_id=dag.dag_id, num_runs=num_runs, root=root) }}">
+      <li><a href="{{ url_for('Airflow.tree', dag_id=dag.dag_id, num_runs=num_runs, root=root) }}">
           <span class="glyphicon glyphicon-tree-deciduous" aria-hidden="true"></span>
         Tree View
       </a></li>
-      <li><a href="{{ url_for("Airflow.duration", dag_id=dag.dag_id, days=30, root=root) }}">
+      <li><a href="{{ url_for('Airflow.duration', dag_id=dag.dag_id, days=30, root=root) }}">
           <span class="glyphicon glyphicon-stats" aria-hidden="true"></span>
           Task Duration
       </a></li>
-      <li><a href="{{ url_for("Airflow.tries", dag_id=dag.dag_id, days=30, root=root) }}">
+      <li><a href="{{ url_for('Airflow.tries', dag_id=dag.dag_id, days=30, root=root) }}">
           <span class="glyphicon glyphicon-duplicate" aria-hidden="true"></span>
           Task Tries
       </a></li>
       <li>
-        <a href="{{ url_for("Airflow.landing_times", dag_id=dag.dag_id, days=30, root=root) }}">
+        <a href="{{ url_for('Airflow.landing_times', dag_id=dag.dag_id, days=30, root=root) }}">
           <span class="glyphicon glyphicon-plane" aria-hidden="true"></span>
           Landing Times
         </a>
       </li>
       <li>
-        <a href="{{ url_for("Airflow.gantt", dag_id=dag.dag_id, root=root) }}">
+        <a href="{{ url_for('Airflow.gantt', dag_id=dag.dag_id, root=root) }}">
           <span class="glyphicon glyphicon-align-left" aria-hidden="true"></span>
           <i class="icon-align-left"></i>
           Gantt
         </a>
       </li>
       <li>
-      <a href="{{ url_for("Airflow.dag_details", dag_id=dag.dag_id) }}">
+      <a href="{{ url_for('Airflow.dag_details', dag_id=dag.dag_id) }}">
           <span class="glyphicon glyphicon-list" aria-hidden="true"></span>
           Details
         </a>
       </li>
       <li>
-        <a href="{{ url_for("Airflow.code", dag_id=dag.dag_id, root=root) }}">
+        <a href="{{ url_for('Airflow.code', dag_id=dag.dag_id, root=root) }}">
           <span class="glyphicon glyphicon-file" aria-hidden="true"></span>
           Code
         </a>
       </li>
       <li>
-        <a href="{{ url_for("Airflow.refresh", dag_id=dag.dag_id) }}" title="Refresh">
+        <a href="{{ url_for('Airflow.refresh', dag_id=dag.dag_id) }}" title="Refresh">
           <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
           Refresh
         </a>
@@ -255,7 +254,7 @@ <h4 class="modal-title" id="dagModalLabel">
 {% endblock %}
 {% block tail %}
   {{ super() }}
-  <script src="{{ url_for('static', filename='bootstrap-toggle.min.js') }}"></script>
+  <script src="{{ url_for_asset('bootstrap-toggle.min.js') }}"></script>
   <script>
 function updateQueryStringParameter(uri, key, value) {
   var re = new RegExp("([?&])" + key + "=.*?(&|$)", "i");
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index cf23e3fe75195..d1aab0218f7ad 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -21,8 +21,8 @@
 
 {% block head_css %}
 {{ super() }}
-<link href="{{ url_for("static", filename="dataTables.bootstrap.css") }}" rel="stylesheet" type="text/css" >
-<link href="{{ url_for("static", filename="bootstrap-toggle.min.css") }}" rel="stylesheet" type="text/css">
+<link href="{{ url_for_asset('dataTables.bootstrap.min.css') }}" rel="stylesheet" type="text/css" >
+<link href="{{ url_for_asset('bootstrap-toggle.min.css') }}" rel="stylesheet" type="text/css">
 {% endblock %}
 
 {% block content %}
@@ -225,14 +225,15 @@ <h2>DAGs</h2>
 
 {% block tail %}
   {{ super() }}
-  <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-  <script src="{{ url_for('static', filename='jquery.dataTables.min.js') }}"></script>
-  <script src="{{ url_for('static', filename='bootstrap-toggle.min.js') }}"></script>
-  <script src="{{ url_for('static', filename='bootstrap3-typeahead.min.js') }}"></script>
+  <script src="{{ url_for_asset('d3.min.js') }}"></script>
+  <script src="{{ url_for_asset('jquery.dataTables.min.js') }}"></script>
+  <script src="{{ url_for_asset('dataTables.bootstrap.min.js') }}"></script>
+  <script src="{{ url_for_asset('bootstrap-toggle.min.js') }}"></script>
+  <script src="{{ url_for_asset('bootstrap3-typeahead.min.js') }}"></script>
   <script>
 
-      const DAGS_INDEX = "{{ url_for('Airflow.index') }}"
-      const ENTER_KEY_CODE = 13
+      const DAGS_INDEX = "{{ url_for('Airflow.index') }}";
+      const ENTER_KEY_CODE = 13;
 
       $('#dag_query').on('keypress', function (e) {
         // check for key press on ENTER (key code 13) to trigger the search
diff --git a/airflow/www_rbac/templates/airflow/duration_chart.html b/airflow/www_rbac/templates/airflow/duration_chart.html
index 89ddb946d3dfc..e2eafd4ea89b1 100644
--- a/airflow/www_rbac/templates/airflow/duration_chart.html
+++ b/airflow/www_rbac/templates/airflow/duration_chart.html
@@ -21,15 +21,14 @@
 {% block head_css %}
 {{ super() }}
 <link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='tree.css') }}">
+    href="{{ url_for('static', filename='css/tree.css') }}">
 <link rel="stylesheet" type="text/css"
     href="{{url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.css')}}" >
+<link href="{{ url_for_asset('dataTables.bootstrap.min.css') }}" rel="stylesheet" type="text/css" >
 <link rel="stylesheet" type="text/css"
-      href="{{ url_for("static", filename="dataTables.bootstrap.css") }}">
-<link rel="stylesheet" type="text/css"
-      href="{{ url_for("static", filename="nv.d3.css") }}">
-<script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-<script src="{{ url_for('static', filename='nv.d3.js') }}"></script>
+      href="{{ url_for_asset('nv.d3.min.css') }}">
+<script src="{{ url_for_asset('d3.min.js') }}"></script>
+<script src="{{ url_for_asset('nv.d3.min.js') }}"></script>
 {% endblock %}
 
 {% block content %}
diff --git a/airflow/www_rbac/templates/airflow/gantt.html b/airflow/www_rbac/templates/airflow/gantt.html
index 3a567ee2eb4cc..64212a5a3c246 100644
--- a/airflow/www_rbac/templates/airflow/gantt.html
+++ b/airflow/www_rbac/templates/airflow/gantt.html
@@ -21,8 +21,8 @@
 {{ super() }}
 <link rel="stylesheet" type="text/css"
     href="{{url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.css')}}" >
-<link type="text/css" href="{{ url_for('static', filename='gantt.css') }}" rel="stylesheet" />
-<link type="text/css" href="{{ url_for('static', filename='tree.css') }}" rel="stylesheet" />
+<link type="text/css" href="{{ url_for('static', filename='css/gantt.css') }}" rel="stylesheet" />
+<link type="text/css" href="{{ url_for('static', filename='css/tree.css') }}" rel="stylesheet" />
 {% endblock %}
 
 {% block content %}
@@ -47,9 +47,9 @@
 {% block tail %}
 {{ super() }}
 <script src="{{ url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.js') }}"></script>
-<script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-<script src="{{ url_for('static', filename='d3.tip.v0.6.3.js') }}"></script>/
-<script src="{{ url_for('static', filename='gantt-chart-d3v2.js') }}"></script>
+<script src="{{ url_for_asset('d3.min.js') }}"></script>
+<script src="{{ url_for_asset('d3-tip.js') }}"></script>/
+<script src="{{ url_for_asset('ganttChartD3v2.js') }}"></script>
 <script>
   $( document ).ready(function() {
     var dag_id = '{{ dag.dag_id }}';
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index d56c5b760336e..23744287dcedd 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -22,9 +22,7 @@
 {% block head_css %}
 {{ super() }}
 <link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='dagre.css') }}">
-<link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='graph.css') }}">
+      href="{{ url_for('static', filename='css/graph.css') }}">
 {% endblock %}
 
 {% block content %}
@@ -95,8 +93,10 @@
 {% block tail %}
     {{ super() }}
 
-    <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-    <script src="{{ url_for('static', filename='dagre-d3.js') }}"></script>
+    <script src="{{ url_for_asset('d3.min.js') }}"></script>
+    {# It's an old or custom dagre-d3 library not supported with webpack 4. #}
+    {# TODO: Fix this using NPM version #}
+    <script src="{{ url_for_asset('dagreD3.js') }}"></script>
     <script>
 
     var highlight_color = "#000000";
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index 10288619238ec..da886317ed06b 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -21,8 +21,9 @@
 {% block head_css %}
 {{ super() }}
 <link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='tree.css') }}">
-<link href="{{ url_for('static', filename='appbuilder/daterangepicker/bootstrap-datepicker.css') }}" rel="stylesheet">
+      href="{{ url_for('static', filename='css/tree.css') }}">
+<link rel="stylesheet" type="text/css"
+    href="{{url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.css')}}" >
 {% endblock %}
 
 {% block content %}
@@ -76,7 +77,7 @@
 
 {% block tail %}
   {{ super() }}
-  <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
+  <script src="{{ url_for_asset('d3.min.js') }}"></script>
   <script>
 $('span.status_square').tooltip({html: true});
 
diff --git a/airflow/www_rbac/templates/appbuilder/baselayout.html b/airflow/www_rbac/templates/appbuilder/baselayout.html
index eeb3d5c04032e..6b0c4416a92a0 100644
--- a/airflow/www_rbac/templates/appbuilder/baselayout.html
+++ b/airflow/www_rbac/templates/appbuilder/baselayout.html
@@ -20,9 +20,9 @@
 
 {% block head_css %}
   {{ super() }}
-  <link href="{{ url_for('static', filename='main.css') }}" rel="stylesheet">
-  <link href="{{ url_for('static', filename='bootstrap-theme.css') }}" rel="stylesheet">
-  <link rel="icon" type="image/png" href="{{ url_for("static", filename="pin_30.png") }}">
+  {# styleBundle.css file contains the styles from main.css and bootstrap-theme.css #}
+  <link href="{{ url_for_asset('styleBundle.css') }}" rel="stylesheet">
+  <link rel="icon" type="image/png" href="{{ url_for('static', filename='pin_30.png') }}">
 {% endblock %}
 
 
@@ -34,7 +34,7 @@
         {% include 'appbuilder/navbar.html' %}
         </header>
     {% endblock %}
-   
+
 
     <div class="container">
       <div class="row">
@@ -60,25 +60,10 @@
 
 {% block tail_js %}
 {{ super() }}
-<script src="{{ url_for('static', filename='jqClock.min.js') }}" type="text/javascript"></script>
-<script>
-    x = new Date()
-    var UTCseconds = (x.getTime() + x.getTimezoneOffset()*60*1000);
-    $("#clock").clock({
-        "dateFormat":"Y-m-d ",
-        "timeFormat":"H:i:s %UTC%",
-        "timestamp":UTCseconds
-    }).click(function(){
-        alert('{{ hostname }}');
-    });
-    $('span').tooltip();
-
-    $.ajaxSetup({
-      beforeSend: function(xhr, settings) {
-        if (!/^(GET|HEAD|OPTIONS|TRACE)$/i.test(settings.type) && !this.crossDomain) {
-          xhr.setRequestHeader("X-CSRFToken", "{{ csrf_token() }}");
-        }
-      }
-    });
+<script type="text/javascript">
+  // below variables are used in clock.js
+  var hostName = '{{ hostname }}';
+  var csrfToken = '{{ csrf_token() }}';
 </script>
-{% endblock %}
\ No newline at end of file
+<script src="{{ url_for_asset('clock.js') }}" type="text/javascript"></script>
+{% endblock %}
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
new file mode 100644
index 0000000000000..d20b0e24db4a4
--- /dev/null
+++ b/airflow/www_rbac/webpack.config.js
@@ -0,0 +1,128 @@
+/**
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an
+* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+* KIND, either express or implied. See the License for the
+* specific language governing permissions and limitations
+* under the License.
+*/
+
+const webpack = require('webpack');
+const path = require('path');
+const ManifestPlugin = require('webpack-manifest-plugin');
+const CleanWebpackPlugin = require('clean-webpack-plugin');
+const CopyWebpackPlugin = require('copy-webpack-plugin');
+const MiniCssExtractPlugin = require("mini-css-extract-plugin");
+
+// Input Directory (airflow/www_rbac)
+// noinspection JSUnresolvedVariable
+const STATIC_DIR = path.resolve(__dirname, './static');
+
+// Output Directory (airflow/www_rbac/static/dist)
+// noinspection JSUnresolvedVariable
+const BUILD_DIR = path.resolve(__dirname, './static/dist');
+
+const config = {
+  entry: {
+    connectionForm: STATIC_DIR + '/js/connection_form.js',
+    clock: STATIC_DIR + '/js/clock.js',
+    dagreD3: STATIC_DIR + '/js/dagre-d3.js',
+    ganttChartD3v2: STATIC_DIR + '/js/gantt-chart-d3v2.js',
+    styleBundle: [
+      STATIC_DIR + '/css/main.css',
+      STATIC_DIR + '/css/bootstrap-theme.css'
+      ]
+  },
+  output: {
+    path: BUILD_DIR,
+    filename: '[name].[chunkhash].js',
+    chunkFilename: '[name].[chunkhash].js',
+  },
+  resolve: {
+    extensions: [
+      '.js',
+      '.jsx',
+      '.css',
+    ],
+  },
+  module: {
+    rules: [
+      {
+        test: /datatables\.net.*/,
+        loader: 'imports-loader?define=>false',
+      },
+      {
+        test: /\.jsx?$/,
+        exclude: /node_modules/,
+        loader: 'babel-loader',
+      },
+      // Extract css files
+      {
+        test: /\.css$/,
+        include: STATIC_DIR,
+        use: [
+          MiniCssExtractPlugin.loader,
+          "css-loader"
+        ]
+      },
+      /* for css linking images */
+      {
+        test: /\.png$/,
+        loader: 'url-loader?limit=100000',
+      },
+      {
+        test: /\.jpg$/,
+        loader: 'file-loader',
+      },
+      {
+        test: /\.gif$/,
+        loader: 'file-loader',
+      },
+      /* for font-awesome */
+      {
+        test: /\.woff(2)?(\?v=[0-9]\.[0-9]\.[0-9])?$/,
+        loader: 'url-loader?limit=10000&mimetype=application/font-woff',
+      },
+      {
+        test: /\.(ttf|eot|svg)(\?v=[0-9]\.[0-9]\.[0-9])?$/,
+        loader: 'file-loader',
+      },
+    ]
+  },
+  plugins: [
+    new ManifestPlugin(),
+    new CleanWebpackPlugin(['static/dist']),
+    new MiniCssExtractPlugin({filename: '[name].[chunkhash].css'}),
+    new webpack.DefinePlugin({
+      'process.env': {
+        NODE_ENV: JSON.stringify(process.env.NODE_ENV),
+      },
+    }),
+    // Since we have all the dependencies separated from hard-coded JS within HTML,
+    // this seems like an efficient solution for now. Will update that once
+    // we'll have the dependencies imported within the custom JS
+    new CopyWebpackPlugin([
+      {from: 'node_modules/nvd3/build/\*.min.\*',flatten:true},
+      // Update this when upgrade d3 package, as the path in new D3 is different
+      {from: 'node_modules/d3/d3.min.\*', flatten:true},
+      {from: 'node_modules/d3-tip/dist/index.js', to:'d3-tip.js', flatten:true},
+      {from: 'node_modules/bootstrap-3-typeahead/\*min.\*', flatten:true},
+      {from: 'node_modules/bootstrap-toggle/**/*bootstrap-toggle.min.\*',
+        flatten:true},
+      {from: 'node_modules/datatables.net/**/*\*.min.\*',flatten:true},
+      {from: 'node_modules/datatables.net-bs/**/*\*.min.\*',flatten:true},
+    ], {copyUnmodified: true})
+  ],
+};
+
+module.exports = config;
diff --git a/dev/README.md b/dev/README.md
index cd4a932adb468..9f16b9f8fc032 100755
--- a/dev/README.md
+++ b/dev/README.md
@@ -100,5 +100,16 @@ Unauthenticated users can only make 60 requests/hour to the Github API. If you g
 The release signing tool can be used to create the SHA512/MD5 and ASC files that required for Apache releases.
 
 ### Execution
-To create a release tar ball execute `python setup.py sdist --formats=gztar` from Airflow's root. After that `cd dist` and
-execute `../dev/sign.sh <the_created_tar_ball.tar.gz`. Signing files will be created in the same directory.
+To create a release tar ball execute following command from Airflow's root. 
+
+`python setup.py compile_assets sdist --formats=gztar`
+
+*Note: `compile_assets` command build the frontend assets (JS and CSS) files for the 
+Web UI using webpack and npm. Please make sure you have `npm` installed on your local machine globally.
+Details on how to install `npm` can be found in CONTRIBUTING.md file.*
+
+After that navigate to relative directory i.e., `cd dist` and sign the release files.
+
+`../dev/sign.sh <the_created_tar_ball.tar.gz` 
+
+Signing files will be created in the same directory.
diff --git a/setup.py b/setup.py
index 05c85c4f674fd..f5f06b7316154 100644
--- a/setup.py
+++ b/setup.py
@@ -24,6 +24,7 @@
 import logging
 import os
 import sys
+import subprocess
 
 logger = logging.getLogger(__name__)
 
@@ -86,6 +87,23 @@ def run(self):
         os.system('rm -vrf ./build ./dist ./*.pyc ./*.tgz ./*.egg-info')
 
 
+class CompileAssets(Command):
+    """
+    Custom compile assets command to compile and build the frontend
+    assets using npm and webpack.
+    """
+    user_options = []
+
+    def initialize_options(self):
+        pass
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        subprocess.call('./airflow/www_rbac/compile_assets.sh')
+
+
 def git_version(version):
     """
     Return a version to identify the state of the underlying git repo. The version will
@@ -386,6 +404,7 @@ def do_setup():
         cmdclass={
             'test': Tox,
             'extra_clean': CleanCommand,
+            'compile_assets': CompileAssets
         },
         python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
     )

From 92c375a03ebfa03e120bc1a27b7881bfbeff1007 Mon Sep 17 00:00:00 2001
From: Sumit Maheshwari <sumeet.manit@gmail.com>
Date: Mon, 1 Oct 2018 11:58:27 +0530
Subject: [PATCH 231/808] [AIRFLOW-3062] Add Qubole in integration docs (#3946)

---
 airflow/contrib/sensors/qubole_sensor.py | 32 ++++++++++++++++++++++++
 docs/integration.rst                     | 26 +++++++++++++++++++
 2 files changed, 58 insertions(+)

diff --git a/airflow/contrib/sensors/qubole_sensor.py b/airflow/contrib/sensors/qubole_sensor.py
index d67fa8557e7ad..7065ae9262595 100644
--- a/airflow/contrib/sensors/qubole_sensor.py
+++ b/airflow/contrib/sensors/qubole_sensor.py
@@ -75,6 +75,22 @@ def poke(self, context):
 
 
 class QuboleFileSensor(QuboleSensor):
+    """
+    Wait for a file or folder to be present in cloud storage
+    and check for its presence via QDS APIs
+
+    :param qubole_conn_id: Connection id which consists of qds auth_token
+    :type qubole_conn_id: str
+    :param data: a JSON object containing payload, whose presence needs to be checked
+        Check this `example <https://github.com/apache/incubator-airflow/blob/master\
+        /airflow/contrib/example_dags/example_qubole_sensor.py>`_ for sample payload
+        structure.
+    :type data: a JSON object
+
+    .. note:: Both ``data`` and ``qubole_conn_id`` fields support templating. You can
+        also use ``.txt`` files for template-driven use cases.
+    """
+
     @apply_defaults
     def __init__(self, *args, **kwargs):
         self.sensor_class = FileSensor
@@ -82,6 +98,22 @@ def __init__(self, *args, **kwargs):
 
 
 class QubolePartitionSensor(QuboleSensor):
+    """
+    Wait for a Hive partition to show up in QHS (Qubole Hive Service)
+    and check for its presence via QDS APIs
+
+    :param qubole_conn_id: Connection id which consists of qds auth_token
+    :type qubole_conn_id: str
+    :param data: a JSON object containing payload, whose presence needs to be checked.
+        Check this `example <https://github.com/apache/incubator-airflow/blob/master\
+        /airflow/contrib/example_dags/example_qubole_sensor.py>`_ for sample payload
+        structure.
+    :type data: a JSON object
+
+    .. note:: Both ``data`` and ``qubole_conn_id`` fields support templating. You can
+        also use ``.txt`` files for template-driven use cases.
+    """
+
     @apply_defaults
     def __init__(self, *args, **kwargs):
         self.sensor_class = PartitionSensor
diff --git a/docs/integration.rst b/docs/integration.rst
index 9d3e6c9828f59..f3b878a3f9645 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -23,6 +23,7 @@ Integration
 - :ref:`AWS`
 - :ref:`Databricks`
 - :ref:`GCP`
+- :ref:`Qubole`
 
 .. _ReverseProxy:
 
@@ -972,3 +973,28 @@ Google Kubernetes Engine Hook
 
 .. autoclass:: airflow.contrib.hooks.gcp_container_hook.GKEClusterHook
     :members:
+
+
+.. _Qubole:
+
+Qubole
+------
+
+Apache Airflow has a native operator and hooks to talk to `Qubole <https://qubole.com/>`__,
+which lets you submit your big data jobs directly to Qubole from Apache Airflow.
+
+QuboleOperator
+''''''''''''''
+
+.. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
+
+QubolePartitionSensor
+'''''''''''''''''''''
+
+.. autoclass:: airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor
+
+
+QuboleFileSensor
+''''''''''''''''
+
+.. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor

From 57937fdb5ac7b0b6e899dd01978147c805b860bf Mon Sep 17 00:00:00 2001
From: Brandon Kvarda <bjkvarda@gmail.com>
Date: Wed, 31 Oct 2018 16:08:52 -0700
Subject: [PATCH 232/808] [AIRFLOW-3236] Create
 AzureDataLakeStorageListOperator (#4094)

---
 .../contrib/operators/adls_list_operator.py   | 70 +++++++++++++++++++
 docs/code.rst                                 |  1 +
 docs/integration.rst                          | 14 +++-
 .../operators/test_adls_list_operator.py      | 51 ++++++++++++++
 4 files changed, 133 insertions(+), 3 deletions(-)
 create mode 100644 airflow/contrib/operators/adls_list_operator.py
 create mode 100644 tests/contrib/operators/test_adls_list_operator.py

diff --git a/airflow/contrib/operators/adls_list_operator.py b/airflow/contrib/operators/adls_list_operator.py
new file mode 100644
index 0000000000000..7d03e86b176b1
--- /dev/null
+++ b/airflow/contrib/operators/adls_list_operator.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class AzureDataLakeStorageListOperator(BaseOperator):
+    """
+    List all files from the specified path
+
+    This operator returns a python list with the names of files which can be used by
+     `xcom` in the downstream tasks.
+
+    :param path: The Azure Data Lake path to find the objects. Supports glob
+        strings (templated)
+    :type path: str
+    :param azure_data_lake_conn_id: The connection ID to use when
+        connecting to Azure Data Lake Storage.
+    :type azure_data_lake_conn_id: str
+
+    **Example**:
+        The following Operator would list all the Parquet files from ``folder/output/``
+        folder in the specified ADLS account ::
+
+            adls_files = AzureDataLakeStorageListOperator(
+                task_id='adls_files',
+                path='folder/output/*.parquet',
+                azure_data_lake_conn_id='azure_data_lake_default'
+            )
+    """
+    template_fields = ('path',)
+    ui_color = '#901dd2'
+
+    @apply_defaults
+    def __init__(self,
+                 path,
+                 azure_data_lake_conn_id='azure_data_lake_default',
+                 *args,
+                 **kwargs):
+        super(AzureDataLakeStorageListOperator, self).__init__(*args, **kwargs)
+        self.path = path
+        self.azure_data_lake_conn_id = azure_data_lake_conn_id
+
+    def execute(self, context):
+
+        hook = AzureDataLakeHook(
+            azure_data_lake_conn_id=self.azure_data_lake_conn_id
+        )
+
+        self.log.info('Getting list of ADLS files in path: %s', self.path)
+
+        return hook.list(path=self.path)
diff --git a/docs/code.rst b/docs/code.rst
index 30cef507e1e85..82aba544c405f 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -129,6 +129,7 @@ Operators
 ^^^^^^^^^
 .. Alphabetize this list
 
+.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index f3b878a3f9645..9d2825ae1834a 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -162,7 +162,7 @@ Airflow can be configured to read and write task logs in Azure Blob Storage.
 See :ref:`write-logs-azure`.
 
 Azure Data Lake
-''''''''''''''''''
+'''''''''''''''
 
 AzureDataLakeHook communicates via a REST API compatible with WebHDFS. Make sure that a
 Airflow connection of type `azure_data_lake` exists. Authorization can be done by supplying a
@@ -170,14 +170,22 @@ login (=Client ID), password (=Client Secret) and extra fields tenant (Tenant) a
  (see connection `azure_data_lake_default` for an example).
 
 - :ref:`AzureDataLakeHook`: Interface with Azure Data Lake.
+- :ref:`AzureDataLakeStorageListOperator`: Lists the files located in a specified Azure Data Lake path.
 
 .. _AzureDataLakeHook:
 
 AzureDataLakeHook
-"""""""""
+"""""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
 
+.. _AzureDataLakeStorageListOperator:
+
+AzureDataLakeStorageListOperator
+""""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
+
 .. _AWS:
 
 AWS: Amazon Web Services
@@ -187,7 +195,7 @@ Airflow has extensive support for Amazon Web Services. But note that the Hooks,
 Operators are in the contrib section.
 
 AWS EMR
-''''''''
+'''''''
 
 - :ref:`EmrAddStepsOperator` : Adds steps to an existing EMR JobFlow.
 - :ref:`EmrCreateJobFlowOperator` : Creates an EMR JobFlow, reading the config from the EMR connection.
diff --git a/tests/contrib/operators/test_adls_list_operator.py b/tests/contrib/operators/test_adls_list_operator.py
new file mode 100644
index 0000000000000..52decd0cd2ccf
--- /dev/null
+++ b/tests/contrib/operators/test_adls_list_operator.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.operators.adls_list_operator import AzureDataLakeStorageListOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+TASK_ID = 'test-adls-list-operator'
+TEST_PATH = 'test/*'
+MOCK_FILES = ["test/TEST1.csv", "test/TEST2.csv", "test/path/TEST3.csv",
+              "test/path/PARQUET.parquet", "test/path/PIC.png"]
+
+
+class AzureDataLakeStorageListOperatorTest(unittest.TestCase):
+
+    @mock.patch('airflow.contrib.operators.adls_list_operator.AzureDataLakeHook')
+    def test_execute(self, mock_hook):
+        mock_hook.return_value.list.return_value = MOCK_FILES
+
+        operator = AzureDataLakeStorageListOperator(task_id=TASK_ID,
+                                                    path=TEST_PATH)
+
+        files = operator.execute(None)
+        mock_hook.return_value.list.assert_called_once_with(
+            path=TEST_PATH
+        )
+        self.assertEqual(sorted(files), sorted(MOCK_FILES))

From 64661f408a8dc604b62dbc5ac22025ab680f4180 Mon Sep 17 00:00:00 2001
From: Sumit Maheshwari <sumeet.manit@gmail.com>
Date: Mon, 5 Nov 2018 15:26:50 +0530
Subject: [PATCH 233/808] [AIRFLOW-3294] Update connections form and
 integration docs (#4129)

---
 airflow/models.py                             |  1 +
 airflow/www/static/connection_form.js         |  7 +++++++
 airflow/www_rbac/static/js/connection_form.js |  7 +++++++
 docs/integration.rst                          | 10 ++++++++++
 4 files changed, 25 insertions(+)

diff --git a/airflow/models.py b/airflow/models.py
index 4745c771c8d28..d55c7848545dd 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -653,6 +653,7 @@ class Connection(Base, LoggingMixin):
         ('segment', 'Segment',),
         ('azure_data_lake', 'Azure Data Lake'),
         ('cassandra', 'Cassandra',),
+        ('qubole', 'Qubole'),
     ]
 
     def __init__(
diff --git a/airflow/www/static/connection_form.js b/airflow/www/static/connection_form.js
index 902cf747e52b2..5a74813d5ba88 100644
--- a/airflow/www/static/connection_form.js
+++ b/airflow/www/static/connection_form.js
@@ -54,6 +54,13 @@
                 'login': 'Username',
             }
         },
+        qubole: {
+          hidden_fields: ['login', 'schema', 'port', 'extra'],
+          relabeling: {
+            'host': 'API Endpoint',
+            'password': 'Auth Token',
+          }
+        },
       }
       function connTypeChange(connectionType) {
         $("div.form-group").removeClass("hide");
diff --git a/airflow/www_rbac/static/js/connection_form.js b/airflow/www_rbac/static/js/connection_form.js
index e40f4df584253..dabd1f73592ef 100644
--- a/airflow/www_rbac/static/js/connection_form.js
+++ b/airflow/www_rbac/static/js/connection_form.js
@@ -46,6 +46,13 @@ $(document).ready(function () {
         'login': 'Username',
       },
     },
+    qubole: {
+      hidden_fields: ['login', 'schema', 'port', 'extra'],
+      relabeling: {
+        'host': 'API Endpoint',
+        'password': 'Auth Token',
+      }
+    },
   };
 
   function connTypeChange(connectionType) {
diff --git a/docs/integration.rst b/docs/integration.rst
index 9d2825ae1834a..db23c6cb25609 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1006,3 +1006,13 @@ QuboleFileSensor
 ''''''''''''''''
 
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor
+
+QuboleCheckOperator
+'''''''''''''''''''
+
+.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
+
+QuboleValueCheckOperator
+''''''''''''''''''''''''
+
+.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator

From 1df9e86e0a44bce2ad82bda6f24d9615b0919cfa Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Tue, 13 Nov 2018 10:43:36 +0100
Subject: [PATCH 234/808] [AIRFLOW-3275] Add Google Cloud SQL Query operator
 (#4170)

---
 .../example_dags/example_gcp_compute.py       |  16 +-
 .../example_dags/example_gcp_compute_igm.py   |   2 +-
 .../example_gcp_function_delete.py            |  13 +-
 .../example_gcp_function_deploy_delete.py     |  31 +-
 .../contrib/example_dags/example_gcp_sql.py   |   5 +-
 .../example_dags/example_gcp_sql_query.py     | 259 ++++++++
 airflow/contrib/hooks/gcp_sql_hook.py         | 616 +++++++++++++++++-
 airflow/contrib/operators/gcp_sql_operator.py |  80 ++-
 airflow/models.py                             |   5 +-
 docs/howto/manage-connections.rst             | 124 +++-
 docs/howto/operator.rst                       | 135 +++-
 docs/integration.rst                          |  42 +-
 tests/contrib/operators/test_gcp_base.py      | 174 +++++
 .../operators/test_gcp_compute_operator.py    |  10 +-
 .../operators/test_gcp_sql_operator.py        | 354 +++++++++-
 tests/dags/.gitignore                         |   5 +
 16 files changed, 1775 insertions(+), 96 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_sql_query.py
 create mode 100644 tests/contrib/operators/test_gcp_base.py
 create mode 100644 tests/dags/.gitignore

diff --git a/airflow/contrib/example_dags/example_gcp_compute.py b/airflow/contrib/example_dags/example_gcp_compute.py
index 51a55b6a99053..928e9744b62be 100644
--- a/airflow/contrib/example_dags/example_gcp_compute.py
+++ b/airflow/contrib/example_dags/example_gcp_compute.py
@@ -21,15 +21,15 @@
 Example Airflow DAG that starts, stops and sets the machine type of a Google Compute
 Engine instance.
 
-This DAG relies on the following Airflow variables
-https://airflow.apache.org/concepts.html#variables
+This DAG relies on the following OS environment variables
+
 * PROJECT_ID - Google Cloud Platform project where the Compute Engine instance exists.
 * ZONE - Google Cloud Platform zone where the instance exists.
 * INSTANCE - Name of the Compute Engine instance.
 * SHORT_MACHINE_TYPE_NAME - Machine type resource name to set, e.g. 'n1-standard-1'.
     See https://cloud.google.com/compute/docs/machine-types
 """
-
+import os
 import datetime
 
 import airflow
@@ -38,17 +38,17 @@
     GceInstanceStopOperator, GceSetMachineTypeOperator
 
 # [START howto_operator_gce_args_common]
-PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
-ZONE = models.Variable.get('ZONE', 'europe-west1-b')
-INSTANCE = models.Variable.get('INSTANCE', 'test-instance')
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+ZONE = os.environ.get('ZONE', 'europe-west1-b')
+INSTANCE = os.environ.get('INSTANCE', 'testinstance')
+# [END howto_operator_gce_args_common]
 
 default_args = {
     'start_date': airflow.utils.dates.days_ago(1)
 }
-# [END howto_operator_gce_args_common]
 
 # [START howto_operator_gce_args_set_machine_type]
-SHORT_MACHINE_TYPE_NAME = models.Variable.get('SHORT_MACHINE_TYPE_NAME', 'n1-standard-1')
+SHORT_MACHINE_TYPE_NAME = os.environ.get('SHORT_MACHINE_TYPE_NAME', 'n1-standard-1')
 SET_MACHINE_TYPE_BODY = {
     'machineType': 'zones/{}/machineTypes/{}'.format(ZONE, SHORT_MACHINE_TYPE_NAME)
 }
diff --git a/airflow/contrib/example_dags/example_gcp_compute_igm.py b/airflow/contrib/example_dags/example_gcp_compute_igm.py
index dc24259f9f119..3e4543c60d8ee 100644
--- a/airflow/contrib/example_dags/example_gcp_compute_igm.py
+++ b/airflow/contrib/example_dags/example_gcp_compute_igm.py
@@ -50,11 +50,11 @@
 # [START howto_operator_compute_igm_common_args]
 PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
 ZONE = os.environ.get('ZONE', 'europe-west1-b')
+# [END howto_operator_compute_igm_common_args]
 
 default_args = {
     'start_date': airflow.utils.dates.days_ago(1)
 }
-# [END howto_operator_compute_igm_common_args]
 
 # [START howto_operator_compute_template_copy_args]
 TEMPLATE_NAME = os.environ.get('TEMPLATE_NAME', 'instance-template-test')
diff --git a/airflow/contrib/example_dags/example_gcp_function_delete.py b/airflow/contrib/example_dags/example_gcp_function_delete.py
index d87eed39c530f..642e3a744c253 100644
--- a/airflow/contrib/example_dags/example_gcp_function_delete.py
+++ b/airflow/contrib/example_dags/example_gcp_function_delete.py
@@ -19,13 +19,13 @@
 
 """
 Example Airflow DAG that deletes a Google Cloud Function.
-This DAG relies on the following Airflow variables
-https://airflow.apache.org/concepts.html#variables
+This DAG relies on the following OS environment variables
 * PROJECT_ID - Google Cloud Project where the Cloud Function exists.
 * LOCATION - Google Cloud Functions region where the function exists.
 * ENTRYPOINT - Name of the executable function in the source code.
 """
 
+import os
 import datetime
 
 import airflow
@@ -33,17 +33,18 @@
 from airflow.contrib.operators.gcp_function_operator import GcfFunctionDeleteOperator
 
 # [START howto_operator_gcf_delete_args]
-PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
-LOCATION = models.Variable.get('LOCATION', 'europe-west1')
-ENTRYPOINT = models.Variable.get('ENTRYPOINT', 'helloWorld')
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+LOCATION = os.environ.get('LOCATION', 'europe-west1')
+ENTRYPOINT = os.environ.get('ENTRYPOINT', 'helloWorld')
 # A fully-qualified name of the function to delete
 
 FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
                                                                ENTRYPOINT)
+# [END howto_operator_gcf_delete_args]
+
 default_args = {
     'start_date': airflow.utils.dates.days_ago(1)
 }
-# [END howto_operator_gcf_delete_args]
 
 with models.DAG(
     'example_gcp_function_delete',
diff --git a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
index 606cc181b0ca4..76563d7596cd2 100644
--- a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+++ b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
@@ -20,7 +20,7 @@
 """
 Example Airflow DAG that creates a Google Cloud Function and then deletes it.
 
-This DAG relies on the following Airflow variables
+This DAG relies on the following OS environment variables
 https://airflow.apache.org/concepts.html#variables
 * PROJECT_ID - Google Cloud Project to use for the Cloud Function.
 * LOCATION - Google Cloud Functions region where the function should be
@@ -37,6 +37,7 @@
 * ENTRYPOINT - Name of the executable function in the source code.
 """
 
+import os
 import datetime
 
 from airflow import models
@@ -45,20 +46,20 @@
 from airflow.utils import dates
 
 # [START howto_operator_gcf_deploy_variables]
-PROJECT_ID = models.Variable.get('PROJECT_ID', 'example-airflow')
-LOCATION = models.Variable.get('LOCATION', 'europe-west1')
-SOURCE_ARCHIVE_URL = models.Variable.get('SOURCE_ARCHIVE_URL', '')
-SOURCE_UPLOAD_URL = models.Variable.get('SOURCE_UPLOAD_URL', '')
-SOURCE_REPOSITORY = models.Variable.get('SOURCE_REPOSITORY',
-                                        'https://source.developers.google.com/'
-                                        'projects/example-airflow/'
-                                        'repos/hello-world/moveable-aliases/master')
-ZIP_PATH = models.Variable.get('ZIP_PATH', '')
-ENTRYPOINT = models.Variable.get('ENTRYPOINT', '')
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+LOCATION = os.environ.get('LOCATION', 'europe-west1')
+SOURCE_ARCHIVE_URL = os.environ.get('SOURCE_ARCHIVE_URL', '')
+SOURCE_UPLOAD_URL = os.environ.get('SOURCE_UPLOAD_URL', '')
+SOURCE_REPOSITORY = os.environ.get(
+    'SOURCE_REPOSITORY',
+    'https://source.developers.google.com/'
+    'projects/example-project/repos/hello-world/moveable-aliases/master')
+ZIP_PATH = os.environ.get('ZIP_PATH', '')
+ENTRYPOINT = os.environ.get('ENTRYPOINT', 'helloWorld')
 FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
                                                                ENTRYPOINT)
 RUNTIME = 'nodejs6'
-VALIDATE_BODY = models.Variable.get('VALIDATE_BODY', True)
+VALIDATE_BODY = os.environ.get('VALIDATE_BODY', True)
 
 # [END howto_operator_gcf_deploy_variables]
 
@@ -71,11 +72,11 @@
 }
 # [END howto_operator_gcf_deploy_body]
 
-# [START howto_operator_gcf_deploy_args]
+# [START howto_operator_gcf_default_args]
 default_args = {
     'start_date': dates.days_ago(1)
 }
-# [END howto_operator_gcf_deploy_args]
+# [END howto_operator_gcf_default_args]
 
 # [START howto_operator_gcf_deploy_variants]
 if SOURCE_ARCHIVE_URL:
@@ -111,6 +112,6 @@
     # [END howto_operator_gcf_deploy]
     delete_task = GcfFunctionDeleteOperator(
         task_id="gcf_delete_task",
-        name=FUNCTION_NAME,
+        name=FUNCTION_NAME
     )
     deploy_task >> delete_task
diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index 136c88c843014..45c0895b0f569 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -21,7 +21,8 @@
 Example Airflow DAG that creates, patches and deletes a Cloud SQL instance, and also
 creates, patches and deletes a database inside the instance, in Google Cloud Platform.
 
-This DAG relies on the following environment variables
+This DAG relies on the following OS environment variables
+https://airflow.apache.org/concepts.html#variables
 * PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance.
 * INSTANCE_NAME - Name of the Cloud SQL instance.
 * DB_NAME - Name of the database inside a Cloud SQL instance.
@@ -40,7 +41,7 @@
 
 # [START howto_operator_cloudsql_arguments]
 PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'testinstance')
+INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'testpostgres')
 DB_NAME = os.environ.get('DB_NAME', 'testdb')
 # [END howto_operator_cloudsql_arguments]
 
diff --git a/airflow/contrib/example_dags/example_gcp_sql_query.py b/airflow/contrib/example_dags/example_gcp_sql_query.py
new file mode 100644
index 0000000000000..af7c5c24479fa
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_sql_query.py
@@ -0,0 +1,259 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that performs query in a Cloud SQL instance.
+
+This DAG relies on the following OS environment variables
+
+* PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance
+* LOCATION - Google Cloud location where the database is created
+*
+* POSTGRES_INSTANCE_NAME - Name of the postgres Cloud SQL instance
+* POSTGRES_USER - Name of the postgres database user
+* POSTGRES_PASSWORD - Password of the postgres database user
+* POSTGRES_PROXY_PORT - Local port number for proxy connections for postgres
+* POSTGRES_PUBLIC_IP - Public IP of the Postgres database
+* POSTGRES_PUBLIC_PORT - Port of the postgres database
+*
+* MYSQL_INSTANCE_NAME - Name of the postgres Cloud SQL instance
+* MYSQL_USER - Name of the mysql database user
+* MYSQL_PASSWORD - Password of the mysql database user
+* MYSQL_PROXY_PORT - Local port number for proxy connections for mysql
+* MYSQL_PUBLIC_IP - Public IP of the mysql database
+* MYSQL_PUBLIC_PORT - Port of the mysql database
+"""
+
+import os
+import subprocess
+
+from six.moves.urllib.parse import quote_plus
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_sql_operator import CloudSqlQueryOperator
+
+# [START howto_operator_cloudsql_query_arguments]
+
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+LOCATION = os.environ.get('REGION', 'europe-west-1')
+
+POSTGRES_INSTANCE_NAME = os.environ.get('POSTGRES_INSTANCE_NAME', 'testpostgres')
+POSTGRES_DATABASE_NAME = os.environ.get('POSTGRES_DATABASE_NAME', 'postgresdb')
+POSTGRES_USER = os.environ.get('POSTGRES_USER', 'postgres_user')
+POSTGRES_PASSWORD = os.environ.get('POSTGRES_PASSWORD', 'password')
+POSTGRES_PUBLIC_IP = os.environ.get('POSTGRES_PUBLIC_IP', '0.0.0.0')
+POSTGRES_PUBLIC_PORT = os.environ.get('POSTGRES_PUBLIC_PORT', 5432)
+POSTGRES_CLIENT_CERT_FILE = os.environ.get('POSTGRES_CLIENT_CERT_FILE',
+                                           "/tmp/client-cert.pem")
+POSTGRES_CLIENT_KEY_FILE = os.environ.get('POSTGRES_CLIENT_KEY_FILE',
+                                          "/tmp/client-key.pem")
+POSTGRES_SERVER_CA_FILE = os.environ.get('POSTGRES_SERVER_CA_FILE',
+                                         "/tmp/server-ca.pem")
+
+MYSQL_INSTANCE_NAME = os.environ.get('MYSQL_INSTANCE_NAME', 'testmysql')
+MYSQL_DATABASE_NAME = os.environ.get('MYSQL_DATABASE_NAME', 'mysqldb')
+MYSQL_USER = os.environ.get('MYSQL_USER', 'mysql_user')
+MYSQL_PASSWORD = os.environ.get('MYSQL_PASSWORD', 'password')
+MYSQL_PUBLIC_IP = os.environ.get('MYSQL_PUBLIC_IP', '0.0.0.0')
+MYSQL_PUBLIC_PORT = os.environ.get('MYSQL_PUBLIC_PORT', 3306)
+MYSQL_CLIENT_CERT_FILE = os.environ.get('MYSQL_CLIENT_CERT_FILE',
+                                        "/tmp/client-cert.pem")
+MYSQL_CLIENT_KEY_FILE = os.environ.get('MYSQL_CLIENT_KEY_FILE',
+                                       "/tmp/client-key.pem")
+MYSQL_SERVER_CA_FILE = os.environ.get('MYSQL_SERVER_CA_FILE',
+                                      "/tmp/server-ca.pem")
+
+SQL = [
+    'CREATE TABLE IF NOT EXISTS TABLE_TEST (I INTEGER)',
+    'CREATE TABLE IF NOT EXISTS TABLE_TEST (I INTEGER)',  # shows warnings logged
+    'INSERT INTO TABLE_TEST VALUES (0)',
+    'CREATE TABLE IF NOT EXISTS TABLE_TEST2 (I INTEGER)',
+    'DROP TABLE TABLE_TEST',
+    'DROP TABLE TABLE_TEST2',
+]
+
+# [END howto_operator_cloudsql_query_arguments]
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+
+
+# [START howto_operator_cloudsql_query_connections]
+
+postgres_kwargs = dict(
+    user=quote_plus(POSTGRES_USER),
+    password=quote_plus(POSTGRES_PASSWORD),
+    public_port=POSTGRES_PUBLIC_PORT,
+    public_ip=quote_plus(POSTGRES_PUBLIC_IP),
+    project_id=quote_plus(PROJECT_ID),
+    location=quote_plus(LOCATION),
+    instance=quote_plus(POSTGRES_INSTANCE_NAME),
+    database=quote_plus(POSTGRES_DATABASE_NAME),
+    client_cert_file=quote_plus(POSTGRES_CLIENT_CERT_FILE),
+    client_key_file=quote_plus(POSTGRES_CLIENT_KEY_FILE),
+    server_ca_file=quote_plus(POSTGRES_SERVER_CA_FILE)
+)
+
+# The connections below are created using one of the standard approaches - via environment
+# variables named AIRFLOW_CONN_* . The connections can also be created in the database
+# of AIRFLOW (using command line or UI).
+
+# Postgres: connect via proxy over TCP
+os.environ['AIRFLOW_CONN_PROXY_POSTGRES_TCP'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=postgres&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=True&" \
+    "sql_proxy_use_tcp=True".format(**postgres_kwargs)
+
+# Postgres: connect via proxy over UNIX socket (specific proxy version)
+os.environ['AIRFLOW_CONN_PROXY_POSTGRES_SOCKET'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=postgres&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=True&" \
+    "sql_proxy_version=v1.13&" \
+    "sql_proxy_use_tcp=False".format(**postgres_kwargs)
+
+# Postgres: connect directly via TCP (non-SSL)
+os.environ['AIRFLOW_CONN_PUBLIC_POSTGRES_TCP'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=postgres&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=False&" \
+    "use_ssl=False".format(**postgres_kwargs)
+
+# Postgres: connect directly via TCP (SSL)
+os.environ['AIRFLOW_CONN_PUBLIC_POSTGRES_TCP_SSL'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=postgres&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=False&" \
+    "use_ssl=True&" \
+    "sslcert={client_cert_file}&" \
+    "sslkey={client_key_file}&" \
+    "sslrootcert={server_ca_file}"\
+    .format(**postgres_kwargs)
+
+mysql_kwargs = dict(
+    user=quote_plus(MYSQL_USER),
+    password=quote_plus(MYSQL_PASSWORD),
+    public_port=MYSQL_PUBLIC_PORT,
+    public_ip=quote_plus(MYSQL_PUBLIC_IP),
+    project_id=quote_plus(PROJECT_ID),
+    location=quote_plus(LOCATION),
+    instance=quote_plus(MYSQL_INSTANCE_NAME),
+    database=quote_plus(MYSQL_DATABASE_NAME),
+    client_cert_file=quote_plus(MYSQL_CLIENT_CERT_FILE),
+    client_key_file=quote_plus(MYSQL_CLIENT_KEY_FILE),
+    server_ca_file=quote_plus(MYSQL_SERVER_CA_FILE)
+)
+
+# MySQL: connect via proxy over TCP (specific proxy version)
+os.environ['AIRFLOW_CONN_PROXY_MYSQL_TCP'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=mysql&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=True&" \
+    "sql_proxy_version=v1.13&" \
+    "sql_proxy_use_tcp=True".format(**mysql_kwargs)
+
+# MySQL: connect via proxy over UNIX socket using pre-downloaded Cloud Sql Proxy binary
+try:
+    sql_proxy_binary_path = subprocess.check_output(
+        ['which', 'cloud_sql_proxy']).rstrip()
+except subprocess.CalledProcessError:
+    sql_proxy_binary_path = "/tmp/anyhow_download_cloud_sql_proxy"
+
+os.environ['AIRFLOW_CONN_PROXY_MYSQL_SOCKET'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=mysql&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=True&" \
+    "sql_proxy_binary_path={sql_proxy_binary_path}&" \
+    "sql_proxy_use_tcp=False".format(
+        sql_proxy_binary_path=quote_plus(sql_proxy_binary_path), **mysql_kwargs)
+
+# MySQL: connect directly via TCP (non-SSL)
+os.environ['AIRFLOW_CONN_PUBLIC_MYSQL_TCP'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=mysql&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=False&" \
+    "use_ssl=False".format(**mysql_kwargs)
+
+# MySQL: connect directly via TCP (SSL) and with fixed Cloud Sql Proxy binary path
+os.environ['AIRFLOW_CONN_PUBLIC_MYSQL_TCP_SSL'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=mysql&" \
+    "project_id={project_id}&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=False&" \
+    "use_ssl=True&" \
+    "sslcert={client_cert_file}&" \
+    "sslkey={client_key_file}&" \
+    "sslrootcert={server_ca_file}".format(**mysql_kwargs)
+
+# [END howto_operator_cloudsql_query_connections]
+
+# [START howto_operator_cloudsql_query_operators]
+
+connection_names = [
+    "proxy_postgres_tcp",
+    "proxy_postgres_socket",
+    "public_postgres_tcp",
+    "public_postgres_tcp_ssl",
+    "proxy_mysql_tcp",
+    "proxy_mysql_socket",
+    "public_mysql_tcp",
+    "public_mysql_tcp_ssl"
+]
+
+tasks = []
+
+with models.DAG(
+    dag_id='example_gcp_sql_query',
+    default_args=default_args,
+    schedule_interval=None
+) as dag:
+    for connection_name in connection_names:
+        tasks.append(
+            CloudSqlQueryOperator(
+                gcp_cloudsql_conn_id=connection_name,
+                task_id="example_gcp_sql_task_" + connection_name,
+                sql=SQL
+            )
+        )
+# [END howto_operator_cloudsql_query_operators]
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 549ceaf49cec3..aee0098b07de5 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -16,15 +16,34 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
+import errno
+import json
+import os
+import re
+import shutil
+import socket
+import platform
+import subprocess
 import time
+import uuid
+from os.path import isfile
+from subprocess import Popen, PIPE
+from six.moves.urllib.parse import quote_plus
+
+import requests
 from googleapiclient.discovery import build
 
-from airflow import AirflowException
+from airflow import AirflowException, LoggingMixin, models
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 # Number of retries - used by googleapiclient method calls to perform retries
 # For requests that are "retriable"
+from airflow.hooks.base_hook import BaseHook
+from airflow.hooks.mysql_hook import MySqlHook
+from airflow.hooks.postgres_hook import PostgresHook
+from airflow.models import Connection
+from airflow.utils.db import provide_session
+
 NUM_RETRIES = 5
 
 # Time to sleep between active checks of the operation results
@@ -89,9 +108,9 @@ def create_instance(self, project_id, body):
             Cloud SQL instances should belong.
         :type project_id: str
         :param body: Body required by the Cloud SQL insert API, as described in
-            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert#request-body
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().instances().insert(
@@ -111,11 +130,11 @@ def patch_instance(self, project_id, body, instance):
         :param project_id: Project ID of the project that contains the instance.
         :type project_id: str
         :param body: Body required by the Cloud SQL patch API, as described in
-            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body.
         :type body: dict
         :param instance: Cloud SQL instance ID. This does not include the project ID.
         :type instance: str
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().instances().patch(
@@ -155,7 +174,7 @@ def get_database(self, project_id, instance, database):
         :param database: Name of the database in the instance.
         :type database: str
         :return: A Cloud SQL database resource, as described in
-            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases#resource
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases#resource.
         :rtype: dict
         """
         return self.get_conn().databases().get(
@@ -173,9 +192,9 @@ def create_database(self, project, instance, body):
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
         :param body: The request body, as described in
-            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().databases().insert(
@@ -189,6 +208,7 @@ def create_database(self, project, instance, body):
     def patch_database(self, project, instance, database, body):
         """
         Updates a database resource inside a Cloud SQL instance.
+
         This method supports patch semantics.
         See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
@@ -199,9 +219,9 @@ def patch_database(self, project, instance, database, body):
         :param database: Name of the database to be updated in the instance.
         :type database: str
         :param body: The request body, as described in
-            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().databases().patch(
@@ -223,7 +243,7 @@ def delete_database(self, project, instance, database):
         :type instance: str
         :param database: Name of the database to be deleted in the instance.
         :type database: str
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded, raises an error otherwise.
         :rtype: bool
         """
         response = self.get_conn().databases().delete(
@@ -241,9 +261,9 @@ def _wait_for_operation_to_complete(self, project_id, operation_name):
 
         :param project_id: Project ID of the project that contains the instance.
         :type project_id: str
-        :param operation_name: name of the operation
+        :param operation_name: Name of the operation.
         :type operation_name: str
-        :return: response returned by the operation
+        :return: Response returned by the operation.
         :rtype: dict
         """
         service = self.get_conn()
@@ -261,3 +281,571 @@ def _wait_for_operation_to_complete(self, project_id, operation_name):
                 # No meaningful info to return from the response in case of success
                 return True
             time.sleep(TIME_TO_SLEEP_IN_SECONDS)
+
+
+CLOUD_SQL_PROXY_DOWNLOAD_URL = "https://dl.google.com/cloudsql/cloud_sql_proxy.{}.{}"
+CLOUD_SQL_PROXY_VERSION_DOWNLOAD_URL = \
+    "https://storage.googleapis.com/cloudsql-proxy/{}/cloud_sql_proxy.{}.{}"
+
+GCP_CREDENTIALS_KEY_PATH = "extra__google_cloud_platform__key_path"
+GCP_CREDENTIALS_KEYFILE_DICT = "extra__google_cloud_platform__keyfile_dict"
+
+
+class CloudSqlProxyRunner(LoggingMixin):
+    """
+    Downloads and runs cloud-sql-proxy as subprocess of the python process.
+
+    The cloud-sql-proxy needs to be downloaded and started before we can connect
+    to the Google Cloud SQL instance via database connection. It establishes
+    secure tunnel connection to the database - it authorizes using the
+    GCP credentials that are passed by the configuration.
+
+    More details about the proxy can be found here:
+    https://cloud.google.com/sql/docs/mysql/sql-proxy
+
+    """
+    def __init__(self,
+                 path_prefix,
+                 instance_specification,
+                 gcp_conn_id='google_cloud_default',
+                 project_id=None,
+                 sql_proxy_version=None,
+                 sql_proxy_binary_path=None):
+        """
+        Creates the proxy runner class.
+
+        :param path_prefix: Unique path prefix where proxy will be downloaded and
+            directories created for unix sockets.
+        :type path_prefix: str
+        :param instance_specification: Specification of the instance to connect the
+            proxy to. It should be specified in the form that is described in
+            https://cloud.google.com/sql/docs/mysql/sql-proxy#multiple-instances in
+            -instances parameter (typically in the form of <project>:<region>:<instance>
+            for UNIX socket connections and in the form of
+            <project>:<region>:<instance>=tcp:<port> for TCP connections.
+        :type instance_specification: str
+        :param gcp_conn_id: Id of Google Cloud Platform connection to use for
+            authentication
+        :type: str
+        :param project_id: Optional id of the GCP project to connect to - it overwrites
+            default project id taken from the GCP connection
+        :type project_id: str
+        :param sql_proxy_version: Specific version of SQL proxy to download
+            (for example 'v1.13'). By default latest version is downloaded.
+        :type sql_proxy_version: str
+        :param sql_proxy_binary_path: If specified, then proxy will be
+            used from the path specified rather than dynamically generated. This means
+            that if the binary is not present in that path it will also be downloaded.
+        :type sql_proxy_binary_path: str
+        """
+        super(CloudSqlProxyRunner, self).__init__()
+        self.path_prefix = path_prefix
+        if not self.path_prefix:
+            raise AirflowException("The path_prefix must not be empty!")
+        self.sql_proxy_was_downloaded = False
+        self.sql_proxy_version = sql_proxy_version
+        self.download_sql_proxy_dir = None
+        self.sql_proxy_process = None
+        self.instance_specification = instance_specification
+        self.project_id = project_id
+        self.gcp_conn_id = gcp_conn_id
+        self.command_line_parameters = []
+        self.cloud_sql_proxy_socket_directory = self.path_prefix
+        self.sql_proxy_path = sql_proxy_binary_path if sql_proxy_binary_path \
+            else self.path_prefix + "_cloud_sql_proxy"
+        self.credentials_path = self.path_prefix + "_credentials.json"
+        self._build_command_line_parameters()
+
+    def _build_command_line_parameters(self):
+        self.command_line_parameters.extend(
+            ['-dir', self.cloud_sql_proxy_socket_directory])
+        self.command_line_parameters.extend(
+            ['-instances', self.instance_specification])
+
+    @staticmethod
+    def _is_os_64bit():
+        return platform.machine().endswith('64')
+
+    def _download_sql_proxy_if_needed(self):
+        if os.path.isfile(self.sql_proxy_path):
+            self.log.info("cloud-sql-proxy is already present")
+            return
+        system = platform.system().lower()
+        processor = "amd64" if CloudSqlProxyRunner._is_os_64bit() else "386"
+        if not self.sql_proxy_version:
+            download_url = CLOUD_SQL_PROXY_DOWNLOAD_URL.format(system, processor)
+        else:
+            download_url = CLOUD_SQL_PROXY_VERSION_DOWNLOAD_URL.format(
+                self.sql_proxy_version, system, processor)
+        proxy_path_tmp = self.sql_proxy_path + ".tmp"
+        self.log.info("Downloading cloud_sql_proxy from {} to {}".
+                      format(download_url, proxy_path_tmp))
+        r = requests.get(download_url, allow_redirects=True)
+        # Downloading to .tmp file first to avoid case where partially downloaded
+        # binary is used by parallel operator which uses the same fixed binary path
+        with open(proxy_path_tmp, 'wb') as f:
+            f.write(r.content)
+        if r.status_code != 200:
+            raise AirflowException(
+                "The cloud-sql-proxy could not be downloaded. Status code = {}. "
+                "Reason = {}".format(r.status_code, r.reason))
+        self.log.info("Moving sql_proxy binary from {} to {}".format(
+            proxy_path_tmp, self.sql_proxy_path
+        ))
+        shutil.move(proxy_path_tmp, self.sql_proxy_path)
+        os.chmod(self.sql_proxy_path, 0o744)  # Set executable bit
+        self.sql_proxy_was_downloaded = True
+
+    @provide_session
+    def _get_credential_parameters(self, session):
+        connection = session.query(models.Connection). \
+            filter(models.Connection.conn_id == self.gcp_conn_id).first()
+        session.expunge_all()
+        if GCP_CREDENTIALS_KEY_PATH in connection.extra_dejson:
+            credential_params = [
+                '-credential_file',
+                connection.extra_dejson[GCP_CREDENTIALS_KEY_PATH]
+            ]
+        elif GCP_CREDENTIALS_KEYFILE_DICT in connection.extra_dejson:
+            credential_file_content = json.loads(
+                connection.extra_dejson[GCP_CREDENTIALS_KEYFILE_DICT])
+            self.log.info("Saving credentials to {}".format(self.credentials_path))
+            with open(self.credentials_path, "w") as f:
+                json.dump(credential_file_content, f)
+            credential_params = [
+                '-credential_file',
+                self.credentials_path
+            ]
+        else:
+            self.log.info(
+                "The credentials are not supplied by neither key_path nor "
+                "keyfile_dict of the gcp connection {}. Falling back to "
+                "default activated account".format(self.gcp_conn_id))
+            credential_params = []
+
+        if not self.instance_specification:
+            project_id = connection.extra_dejson.get(
+                'extra__google_cloud_platform__project')
+            if self.project_id:
+                project_id = self.project_id
+            if not project_id:
+                raise AirflowException("For forwarding all instances, the project id "
+                                       "for GCP should be provided either "
+                                       "by project_id extra in the GCP connection or by "
+                                       "project_id provided in the operator.")
+            credential_params.extend(['-projects', project_id])
+        return credential_params
+
+    def start_proxy(self):
+        """
+        Starts Cloud Sql Proxy.
+
+        You have to remember to stop the proxy if you started it!
+        """
+        self._download_sql_proxy_if_needed()
+        if self.sql_proxy_process:
+            raise AirflowException("The sql proxy is already running: {}".format(
+                self.sql_proxy_process))
+        else:
+            command_to_run = [self.sql_proxy_path]
+            command_to_run.extend(self.command_line_parameters)
+            try:
+                self.log.info("Creating directory {}".format(
+                    self.cloud_sql_proxy_socket_directory))
+                os.makedirs(self.cloud_sql_proxy_socket_directory)
+            except OSError:
+                # Needed for python 2 compatibility (exists_ok missing)
+                pass
+            command_to_run.extend(self._get_credential_parameters())
+            self.log.info("Running the command: `{}`".format(" ".join(command_to_run)))
+            self.sql_proxy_process = Popen(command_to_run,
+                                           stdin=PIPE, stdout=PIPE, stderr=PIPE)
+            self.log.info("The pid of cloud_sql_proxy: {}".format(
+                self.sql_proxy_process.pid))
+            while True:
+                line = self.sql_proxy_process.stderr.readline()
+                return_code = self.sql_proxy_process.poll()
+                if line == '' and return_code is not None:
+                    self.sql_proxy_process = None
+                    raise AirflowException(
+                        "The cloud_sql_proxy finished early with return code {}!".format(
+                            return_code))
+                if line != '':
+                    self.log.info(line)
+                if "googleapi: Error" in line or "invalid instance name:" in line:
+                    self.stop_proxy()
+                    raise AirflowException(
+                        "Error when starting the cloud_sql_proxy {}!".format(
+                            line))
+                if "Ready for new connections" in line:
+                    return
+
+    def stop_proxy(self):
+        """
+        Stops running proxy.
+
+        You should stop the proxy after you stop using it.
+        """
+        if not self.sql_proxy_process:
+            raise AirflowException("The sql proxy is not started yet")
+        else:
+            self.log.info("Stopping the cloud_sql_proxy pid: {}".format(
+                self.sql_proxy_process.pid))
+            self.sql_proxy_process.kill()
+            self.sql_proxy_process = None
+        # Cleanup!
+        self.log.info("Removing the socket directory: {}".
+                      format(self.cloud_sql_proxy_socket_directory))
+        shutil.rmtree(self.cloud_sql_proxy_socket_directory, ignore_errors=True)
+        if self.sql_proxy_was_downloaded:
+            self.log.info("Removing downloaded proxy: {}".format(self.sql_proxy_path))
+            # Silently ignore if the file has already been removed (concurrency)
+            try:
+                os.remove(self.sql_proxy_path)
+            except OSError as e:
+                if not e.errno == errno.ENOENT:
+                    raise
+        else:
+            self.log.info("Skipped removing proxy - it was not downloaded: {}".
+                          format(self.sql_proxy_path))
+        if isfile(self.credentials_path):
+            self.log.info("Removing generated credentials file {}".
+                          format(self.credentials_path))
+            # Here file cannot be delete by concurrent task (each task has its own copy)
+            os.remove(self.credentials_path)
+
+    def get_proxy_version(self):
+        """
+        Returns version of the Cloud Sql Proxy.
+        """
+        self._download_sql_proxy_if_needed()
+        command_to_run = [self.sql_proxy_path]
+        command_to_run.extend(['--version'])
+        command_to_run.extend(self._get_credential_parameters())
+        result = subprocess.check_output(command_to_run)
+        pattern = re.compile("^.*[V|v]ersion ([^;]*);.*$")
+        m = pattern.match(result)
+        if m:
+            return m.group(1)
+        else:
+            return None
+
+    def get_socket_path(self):
+        """
+        Retrieves UNIX socket path used by Cloud Sql Proxy.
+
+        :return: The dynamically generated path for the socket created by the proxy.
+        :rtype: str
+        """
+        return self.cloud_sql_proxy_socket_directory + "/" + self.instance_specification
+
+
+CONNECTION_URIS = {
+    "postgres": {
+        "proxy": {
+            "tcp":
+                "postgresql://{user}:{password}@127.0.0.1:{proxy_port}/{database}",
+            "socket":
+                "postgresql://{user}:{password}@{socket_path}/{database}"
+        },
+        "public": {
+            "ssl":
+                "postgresql://{user}:{password}@{public_ip}:{public_port}/{database}?"
+                "sslmode=verify-ca&"
+                "sslcert={client_cert_file}&"
+                "sslkey={client_key_file}&"
+                "sslrootcert={server_ca_file}",
+            "non-ssl":
+                "postgresql://{user}:{password}@{public_ip}:{public_port}/{database}"
+        }
+    },
+    "mysql": {
+        "proxy": {
+            "tcp":
+                "mysql://{user}:{password}@127.0.0.1:{proxy_port}/{database}",
+            "socket":
+                "mysql://{user}:{password}@localhost/{database}?"
+                "unix_socket={socket_path}"
+        },
+        "public": {
+            "ssl":
+                "mysql://{user}:{password}@{public_ip}:{public_port}/{database}?"
+                "ssl={ssl_spec}",
+            "non-ssl":
+                "mysql://{user}:{password}@{public_ip}:{public_port}/{database}"
+        }
+    }
+}
+
+CLOUD_SQL_VALID_DATABASE_TYPES = ['postgres', 'mysql']
+
+
+# noinspection PyAbstractClass
+class CloudSqlDatabaseHook(BaseHook):
+    """
+    Serves DB connection configuration for CloudSQL (Connections
+    of *gcpcloudsql://* type).
+
+    The hook is a "meta" one - it does not perform an actual connection,
+    it is there to retrieve all the parameters configured in gcpcloudsql:// connection,
+    start/stop Cloud Sql Proxy if needed, dynamically generate Postgres or MySQL
+    connection in the database and return an actual Postgres or MySQL hook.
+    The returned Postgres/MySQL hooks are using direct connection or Cloud Sql
+    Proxy socket/tcp as configured.
+
+    Main parameters of the hook are retrieved from the standard URI components:
+
+    * **user** - User name to authenticate to the database (from login of the URI).
+    * **password** - Password to authenticate to the database (from password of the URI)
+    * **public_ip** - IP to connect to for public connection (from host of the URI)
+    * **public_port** - Port to connect to for public connection (from port of the URI)
+    * **database** - Database to connect to (from schema of the URI)
+
+    Remaining parameters are retrieved from the extras (URI query parameters):
+
+    * **project_id** - Google Cloud Platform project where the Cloud SQL instance exists.
+    * **instance** -  Name of the instance of the Cloud SQL database instance.
+    * **location** - The location of the cloud sql instance (for example europe-west1).
+    * **database_type** - The type of the database instance (mysql or postgres).
+    * **use_proxy** - (default False) Whether SQL proxy should be used to connect to Cloud
+      SQL DB.
+    * **use_ssl** - (default False) Whether SSL should be used to connect to Cloud SQL DB.
+      You cannot use proxy and ssl together.
+    * **sql_proxy_use_tcp** - (default False) If set to true, TCP is used to connect via
+      proxy, otherwise UNIX sockets are used.
+    * **sql_proxy_binary_path** - Optional path to sql proxy binary. If the binary is not
+      specified or the binary is not present, it is automatically downloaded.
+    * **sql_proxy_version** -  Specific version of the proxy to download (for example
+      v1.13). If not specified, the latest version is downloaded.
+    * **sslcert** - Path to client certificate to authenticate when SSL is used.
+    * **sslkey** - Path to client private key to authenticate when SSL is used.
+    * **sslrootcert** - Path to server's certificate to authenticate when SSL is used.
+    """
+    _conn = None
+
+    def __init__(self, gcp_cloudsql_conn_id='google_cloud_sql_default'):
+        super(CloudSqlDatabaseHook, self).__init__(source=None)
+        self.gcp_cloudsql_conn_id = gcp_cloudsql_conn_id
+        self.cloudsql_connection = self.get_connection(self.gcp_cloudsql_conn_id)
+        self.extras = self.cloudsql_connection.extra_dejson
+        self.project_id = self.extras.get('project_id')
+        self.instance = self.extras.get('instance')
+        self.database = self.cloudsql_connection.schema
+        self.location = self.extras.get('location')
+        self.database_type = self.extras.get('database_type')
+        self.use_proxy = self._get_bool(self.extras.get('use_proxy', 'False'))
+        self.use_ssl = self._get_bool(self.extras.get('use_ssl', 'False'))
+        self.sql_proxy_use_tcp = self._get_bool(
+            self.extras.get('sql_proxy_use_tcp', 'False'))
+        self.sql_proxy_version = self.extras.get('sql_proxy_version')
+        self.sql_proxy_binary_path = self.extras.get('sql_proxy_binary_path')
+        self.user = self.cloudsql_connection.login
+        self.password = self.cloudsql_connection.password
+        self.public_ip = self.cloudsql_connection.host
+        self.public_port = self.cloudsql_connection.port
+        self.sslcert = self.extras.get('sslcert')
+        self.sslkey = self.extras.get('sslkey')
+        self.sslrootcert = self.extras.get('sslrootcert')
+        # Port and socket path and db_hook are automatically generated
+        self.sql_proxy_tcp_port = None
+        self.sql_proxy_unique_path = None
+        self.db_hook = None
+        self.reserved_tcp_socket = None
+        # Generated based on clock + clock sequence. Unique per host (!).
+        # This is important as different hosts share the database
+        self.db_conn_id = str(uuid.uuid1())
+        self._validate_inputs()
+
+    @staticmethod
+    def _get_bool(val):
+        if val == 'False':
+            return False
+        return val
+
+    @staticmethod
+    def _check_ssl_file(file_to_check, name):
+        if not file_to_check:
+            raise AirflowException("SSL connections requires {name} to be set".
+                                   format(name=name))
+        if not isfile(file_to_check):
+            raise AirflowException("The {file_to_check} must be a readable file".
+                                   format(file_to_check=file_to_check))
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required extra 'project_id' is empty")
+        if not self.location:
+            raise AirflowException("The required extra 'location' is empty")
+        if not self.instance:
+            raise AirflowException("The required extra 'instance' is empty")
+        if self.database_type not in CLOUD_SQL_VALID_DATABASE_TYPES:
+            raise AirflowException("Invalid database type '{}'. Must be one of {}".format(
+                self.database_type, CLOUD_SQL_VALID_DATABASE_TYPES
+            ))
+        if self.use_proxy and self.use_ssl:
+            raise AirflowException("Cloud Sql Proxy does not support SSL connections."
+                                   " SSL is not needed as Cloud Sql Proxy "
+                                   "provides encryption on its own")
+        if self.use_ssl:
+            self._check_ssl_file(self.sslcert, "sslcert")
+            self._check_ssl_file(self.sslkey, "sslkey")
+            self._check_ssl_file(self.sslrootcert, "sslrootcert")
+
+    def _generate_unique_path(self):
+        # We are not using mkdtemp here as the path generated with mkdtemp
+        # can be close to 60 characters and there is a limitation in
+        # length of socket path to around 100 characters in total.
+        # We append project/location/instance to it later and postgres
+        # appends its own prefix, so we chose a shorter "/tmp/{uuid1}" - based
+        # on host name and clock + clock sequence. This should be fairly
+        # sufficient for our needs and should even work if the time is set back.
+        # We are using db_conn_id generated with uuid1 so that connection
+        # id matches the folder - for easier debugging.
+        return "/tmp/" + self.db_conn_id
+
+    @staticmethod
+    def _quote(value):
+        return quote_plus(value) if value else None
+
+    def _generate_connection_uri(self):
+        if self.use_proxy:
+            if self.sql_proxy_use_tcp:
+                if not self.sql_proxy_tcp_port:
+                    self.reserve_free_tcp_port()
+            if not self.sql_proxy_unique_path:
+                self.sql_proxy_unique_path = self._generate_unique_path()
+
+        database_uris = CONNECTION_URIS[self.database_type]
+        ssl_spec = None
+        socket_path = None
+        if self.use_proxy:
+            proxy_uris = database_uris['proxy']
+            if self.sql_proxy_use_tcp:
+                format_string = proxy_uris['tcp']
+            else:
+                format_string = proxy_uris['socket']
+                socket_path = \
+                    "{sql_proxy_socket_path}/{instance_socket_name}".format(
+                        sql_proxy_socket_path=self.sql_proxy_unique_path,
+                        instance_socket_name=self._get_instance_socket_name()
+                    )
+        else:
+            public_uris = database_uris['public']
+            if self.use_ssl:
+                format_string = public_uris['ssl']
+                ssl_spec = {
+                    'cert': self.sslcert,
+                    'key': self.sslkey,
+                    'ca': self.sslrootcert
+                }
+            else:
+                format_string = public_uris['non-ssl']
+
+        connection_uri = format_string.format(
+            user=quote_plus(self.user),
+            password=quote_plus(self.password),
+            database=quote_plus(self.database),
+            public_ip=self.public_ip,
+            public_port=self.public_port,
+            proxy_port=self.sql_proxy_tcp_port,
+            socket_path=self._quote(socket_path),
+            ssl_spec=self._quote(json.dumps(ssl_spec)) if ssl_spec else None,
+            client_cert_file=self._quote(self.sslcert),
+            client_key_file=self._quote(self.sslkey),
+            server_ca_file=self._quote(self.sslrootcert)
+        )
+        self.log.info("DB connection URI {}".format(connection_uri.replace(
+            quote_plus(self.password), 'XXXXXXXXXXXX')))
+        return connection_uri
+
+    def _get_instance_socket_name(self):
+        return self.project_id + ":" + self.location + ":" + self.instance
+
+    def _get_sqlproxy_instance_specification(self):
+        instance_specification = self._get_instance_socket_name()
+        if self.sql_proxy_use_tcp:
+            instance_specification += "=tcp:" + str(self.sql_proxy_tcp_port)
+        return instance_specification
+
+    @provide_session
+    def create_connection(self, session=None):
+        """
+        Create connection in the Connection table - according to whether it uses
+        proxy, TCP, UNIX sockets, SSL. Connection ID will be randomly generated.
+
+        :param session: Session of the SQL Alchemy ORM (automatically generated with
+                        decorator).
+        """
+        connection = Connection(conn_id=self.db_conn_id)
+        uri = self._generate_connection_uri()
+        self.log.info("Creating connection {}".format(self.db_conn_id))
+        connection.parse_from_uri(uri)
+        session.add(connection)
+        session.commit()
+
+    @provide_session
+    def delete_connection(self, session=None):
+        """
+        Delete the dynamically created connection from the Connection table.
+
+        :param session: Session of the SQL Alchemy ORM (automatically generated with
+                        decorator).
+        """
+        self.log.info("Deleting connection {}".format(self.db_conn_id))
+        connection = session.query(models.Connection).filter(
+            models.Connection.conn_id == self.db_conn_id)[0]
+        session.delete(connection)
+        session.commit()
+
+    def get_sqlproxy_runner(self):
+        """
+        Retrieve Cloud Sql Proxy runner. It is used to manage the proxy
+        lifecycle per task.
+
+        :return: The Cloud Sql Proxy runner.
+        :rtype: CloudSqlProxyRunner
+        """
+        return CloudSqlProxyRunner(
+            path_prefix=self.sql_proxy_unique_path,
+            instance_specification=self._get_sqlproxy_instance_specification(),
+            project_id=self.project_id,
+            sql_proxy_version=self.sql_proxy_version,
+            sql_proxy_binary_path=self.sql_proxy_binary_path
+        )
+
+    def get_database_hook(self):
+        """
+        Retrieve database hook - this is the actual Postgres or MySQL database hook
+        that uses proxy or connects directly to the Google Cloud Sql database.
+        """
+        if self.database_type == 'postgres':
+            self.db_hook = PostgresHook(postgres_conn_id=self.db_conn_id,
+                                        schema=self.database)
+        else:
+            self.db_hook = MySqlHook(mysql_conn_id=self.db_conn_id,
+                                     schema=self.database)
+        return self.db_hook
+
+    def cleanup_database_hook(self):
+        """
+        Clean up database hook after it was used.
+        """
+        if self.database_type == 'postgres':
+            for output in self.db_hook.conn.notices:
+                self.log.info(output)
+
+    def reserve_free_tcp_port(self):
+        """
+        Reserve free TCP port to be used by Cloud Sql Proxy
+        """
+        self.reserved_tcp_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self.reserved_tcp_socket.bind(('127.0.0.1', 0))
+        self.sql_proxy_tcp_port = self.reserved_tcp_socket.getsockname()[1]
+
+    def free_reserved_port(self):
+        """
+        Free TCP port - makes it immediately ready to be used by Cloud Sql Proxy.
+        """
+        if self.reserved_tcp_socket:
+            self.reserved_tcp_socket.close()
+            self.reserved_tcp_socket = None
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index aca2e8ad40a34..711f2c8d15ebb 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -19,7 +19,7 @@
 from googleapiclient.errors import HttpError
 
 from airflow import AirflowException
-from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook, CloudSqlDatabaseHook
 from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
@@ -524,3 +524,81 @@ def execute(self, context):
         else:
             return self._hook.delete_database(self.project_id, self.instance,
                                               self.database)
+
+
+class CloudSqlQueryOperator(BaseOperator):
+    """
+    Performs DML or DDL query on an existing Cloud Sql instance. It optionally uses
+    cloud-sql-proxy to establish secure connection with the database.
+
+    :param sql: SQL query or list of queries to run (should be DML or DDL query -
+        this operator does not return any data from the database,
+        so it is useless to pass it DQL queries. Note that it is responsibility of the
+        author of the queries to make sure that the queries are idempotent. For example
+        you can use CREATE TABLE IF NOT EXISTS to create a table.
+    :type sql: str or [str]
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform for
+        cloud-sql-proxy authentication.
+    :type gcp_conn_id: str
+    :param gcp_cloudsql_conn_id: The connection ID used to connect to Google Cloud SQL
+       its schema should be gcpcloudsql://.
+       See :class:`~airflow.contrib.hooks.gcp_sql_hooks.CloudSqlDatabaseHook` for
+       details on how to define gcpcloudsql:// connection.
+    :type gcp_cloudsql_conn_id: str
+    """
+    # [START gcp_sql_query_template_fields]
+    template_fields = ('sql', 'gcp_cloudsql_conn_id', 'gcp_conn_id')
+    template_ext = ('.sql',)
+    # [END gcp_sql_query_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 sql,
+                 autocommit=False,
+                 parameters=None,
+                 gcp_conn_id='google_cloud_default',
+                 gcp_cloudsql_conn_id='google_cloud_sql_default',
+                 *args, **kwargs):
+        super(CloudSqlQueryOperator, self).__init__(*args, **kwargs)
+        self.sql = sql
+        self.gcp_conn_id = gcp_conn_id
+        self.gcp_cloudsql_conn_id = gcp_cloudsql_conn_id
+        self.autocommit = autocommit
+        self.parameters = parameters
+        self.cloudsql_db_hook = CloudSqlDatabaseHook(
+            gcp_cloudsql_conn_id=gcp_cloudsql_conn_id)
+        self.cloud_sql_proxy_runner = None
+        self.database_hook = None
+
+    def pre_execute(self, context):
+        self.cloudsql_db_hook.create_connection()
+        self.database_hook = self.cloudsql_db_hook.get_database_hook()
+        if self.cloudsql_db_hook.use_proxy:
+            self.cloud_sql_proxy_runner = self.cloudsql_db_hook.get_sqlproxy_runner()
+            self.cloudsql_db_hook.free_reserved_port()
+            # There is very, very slim chance that the socket will be taken over
+            # here by another bind(0). It's quite unlikely to happen though!
+            self.cloud_sql_proxy_runner.start_proxy()
+
+    def execute(self, context):
+        self.log.info('Executing: "%s"', self.sql)
+        self.database_hook.run(self.sql, self.autocommit, parameters=self.parameters)
+
+    def post_execute(self, context, result=None):
+        # Make sure that all the cleanups happen, no matter if there are some
+        # exceptions thrown
+        try:
+            self.cloudsql_db_hook.cleanup_database_hook()
+        finally:
+            try:
+                if self.cloud_sql_proxy_runner:
+                    self.cloud_sql_proxy_runner.stop_proxy()
+                    self.cloud_sql_proxy_runner = None
+            finally:
+                self.cloudsql_db_hook.delete_connection()
+                self.cloudsql_db_hook = None
diff --git a/airflow/models.py b/airflow/models.py
index d55c7848545dd..92df225a394e8 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -654,6 +654,7 @@ class Connection(Base, LoggingMixin):
         ('azure_data_lake', 'Azure Data Lake'),
         ('cassandra', 'Cassandra',),
         ('qubole', 'Qubole'),
+        ('gcpcloudsql', 'Google Cloud SQL'),
     ]
 
     def __init__(
@@ -793,6 +794,9 @@ def get_hook(self):
             elif self.conn_type == 'cassandra':
                 from airflow.contrib.hooks.cassandra_hook import CassandraHook
                 return CassandraHook(cassandra_conn_id=self.conn_id)
+            elif self.conn_type == 'gcpcloudsql':
+                from airflow.contrib.hooks.gcp_sql_hook import CloudSqlDatabaseHook
+                return CloudSqlDatabaseHook(gcp_cloudsql_conn_id=self.conn_id)
         except Exception:
             pass
 
@@ -2382,7 +2386,6 @@ def __init__(
                     c=self.__class__.__name__, a=args, k=kwargs),
                 category=PendingDeprecationWarning
             )
-
         validate_key(task_id)
         self.task_id = task_id
         self.owner = owner
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 9c324d259d776..ec5cce189cebe 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -153,7 +153,7 @@ Scopes (comma separated)
 
 MySQL
 ~~~~~
-The MySQL connect type allows to connect with MySQL database.
+The MySQL connection type provides connection to a MySQL database.
 
 Configuring the Connection
 ''''''''''''''''''''''''''
@@ -228,3 +228,125 @@ Extra (optional)
     .. note::
         If encounter UnicodeDecodeError while working with MySQL connection check
         the charset defined is matched to the database charset.
+
+Postgres
+~~~~~~~~
+The Postgres connection type provides connection to a Postgres database.
+
+Configuring the Connection
+''''''''''''''''''''''''''
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in mysql
+    connection. The following parameters out of the standard python parameters
+    are supported:
+
+    * **sslmode** - This option determines whether or with what priority a secure SSL
+      TCP/IP connection will be negotiated with the server. There are six modes:
+      'disable', 'allow', 'prefer', 'require', 'verify-ca', 'verify-full'.
+    * **sslcert** - This parameter specifies the file name of the client SSL certificate,
+      replacing the default.
+    * **sslkey** - This parameter specifies the file name of the client SSL key,
+      replacing the default.
+    * **sslrootcert** - This parameter specifies the name of a file containing SSL
+      certificate authority (CA) certificate(s).
+    * **sslcrl** - This parameter specifies the file name of the SSL certificate
+      revocation list (CRL).
+    * **application_name** - Specifies a value for the application_name
+      configuration parameter.
+    * **keepalives_idle** - Controls the number of seconds of inactivity after which TCP
+      should send a keepalive message to the server.
+
+    More details on all Postgres parameters supported can be found in
+    `Postgres documentation <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING>`_
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "sslmode": "verify-ca",
+          "sslcert": "/tmp/client-cert.pem",
+          "sslca": "/tmp/server-ca.pem'",
+          "sslkey": "/tmp/client-key.pem"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras as passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        postgresql://postgres_user:XXXXXXXXXXXX@1.1.1.1:5432/postgresdb?sslmode=verify-ca&sslcert=%2Ftmp%2Fclient-cert.pem&sslkey=%2Ftmp%2Fclient-key.pem&sslrootcert=%2Ftmp%2Fserver-ca.pem
+
+Cloudsql
+~~~~~~~~
+The gcpcloudsql:// connection is used by
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator` to perform query
+on a Google Cloud SQL database. Google Cloud SQL database can be either
+Postgres or MySQL, so this is a "meta" connection type - it introduces common schema
+for both MySQL and Postgres, including what kind of connectivity should be used.
+Google Cloud SQL supports connecting via public IP or via Cloud Sql Proxy
+and in the latter case the
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` uses
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to automatically prepare
+and use temporary Postgres or MySQL connection that will use the proxy to connect
+(either via TCP or UNIX socket)
+
+Configuring the Connection
+''''''''''''''''''''''''''
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in mysql
+    connection.
+
+    Details of all the parameters supported in extra field can be found in
+    :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "database_type": "mysql",
+          "project_id": "example-project",
+          "location": "europe-west1",
+          "instance": "testinstance",
+          "use_proxy": true,
+          "sql_proxy_use_tcp": false
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras as passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        gcpcloudsql://user:XXXXXXXXX@1.1.1.1:3306/mydb?database_type=mysql&project_id=example-project&location=europe-west1&instance=testinstance&use_proxy=True&sql_proxy_use_tcp=False
+
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 41fc6fd1e5904..7d8053b41a83c 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -134,8 +134,7 @@ to start an existing Google Compute Engine instance.
 Arguments
 """""""""
 
-The following examples of OS environment variables show how you can build function name
-to use in the operator and build default args to pass them to multiple tasks:
+The following examples of OS environment variables used to pass arguments to the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
@@ -177,8 +176,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show how you can build function name
-to use in the operator and build default args to pass them to multiple tasks:
+The following examples of OS environment variables used to pass arguments to the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
    :language: python
@@ -220,8 +218,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show how you can build function name
-to use in the operator and build default args to pass them to multiple tasks:
+The following examples of OS environment variables used to pass arguments to the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
@@ -270,8 +267,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show how you can build parameters
-passed to the operator and build default args to pass them to multiple tasks:
+The following examples of OS environment variables used to pass arguments to the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
@@ -317,8 +313,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show how you can build parameters
-passed to the operator and build default args to pass them to multiple tasks:
+The following examples of OS environment variables used to pass arguments to the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
@@ -375,7 +370,7 @@ Arguments
 """""""""
 
 The following examples of OS environment variables show how you can build function name
-to use in the operator and build default args to pass them to multiple tasks:
+to use in the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
     :language: python
@@ -441,8 +436,8 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show various variants and combinations
-of default_args that you can use. The variables are defined as follows:
+The following examples of OS environment variables show several variants of args you can
+use with the operator:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
@@ -461,18 +456,19 @@ arguments common with other tasks:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
     :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcf_deploy_args]
-    :end-before: [END howto_operator_gcf_deploy_args]
+    :start-after: [START howto_operator_gcf_default_args]
+    :end-before: [END howto_operator_gcf_default_args]
 
 Note that the neither the body nor the default args are complete in the above examples.
-Depending on the set variables, there might be different variants on how to pass source
+Depending on the variables set, there might be different variants on how to pass source
 code related fields. Currently, you can pass either sourceArchiveUrl, sourceRepository
 or sourceUploadUrl as described in the
 `Cloud Functions API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
-Additionally, default_args might contain zip_path parameter to run the extra step of
-uploading the source code before deploying it. In the last case, you also need to
-provide an empty `sourceUploadUrl` parameter in the body.
+
+Additionally, default_args or direct operator args might contain zip_path parameter
+to run the extra step of uploading the source code before deploying it.
+In this case, you also need to provide an empty `sourceUploadUrl`
+parameter in the body.
 
 Using the operator
 """"""""""""""""""
@@ -692,7 +688,7 @@ For parameter definition take a look at
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from environment variables:
+Some arguments in the example DAG are taken from OS environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
@@ -739,7 +735,7 @@ will succeed.
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from environment variables:
+Some arguments in the example DAG are taken from OS environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
@@ -795,7 +791,7 @@ unchanged.
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from environment variables:
+Some arguments in the example DAG are taken from OS environment variables:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
@@ -832,3 +828,96 @@ More information
 
 See `Google Cloud SQL API documentation for patch <https://cloud.google
 .com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
+
+
+CloudSqlQueryOperator
+^^^^^^^^^^^^^^^^^^^^^
+
+Performs DDL or DML SQL queries in Google Cloud SQL instance. The DQL
+(retrieving data from Google Cloud SQL) is not supported - you might run the SELECT
+queries but results of those queries are discarded.
+
+You can specify various connectivity methods to connect to running instance -
+starting from public IP plain connection through public IP with SSL or both TCP and
+socket connection via Cloud Sql Proxy. The proxy is downloaded and started/stopped
+dynamically as needed by the operator.
+
+There is a *gcpcloudsql://* connection type that you should use to define what
+kind of connectivity you want the operator to use. The connection is a "meta"
+type of connection. It is not used to make an actual connectivity on its own, but it
+determines whether Cloud Sql Proxy should be started by `CloudSqlDatabaseHook`
+and what kind of the database connection (Postgres or MySQL) should be created
+dynamically - to either connect to Cloud SQL via public IP address or via the proxy.
+The 'CloudSqlDatabaseHook` uses
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to manage Cloud Sql
+Proxy lifecycle (each task has its own Cloud Sql Proxy)
+
+When you build connection, you should use connection parameters as described in
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`. You can see
+examples of connections below for all the possible types of connectivity. Such connection
+can be reused between different tasks (instances of `CloudSqlQueryOperator`) - each
+task will get their own proxy started if needed with their own TCP or UNIX socket.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator`.
+
+Since query operator can run arbitrary query - it cannot be guaranteed to be
+idempotent. SQL query designer should design the queries to be idempotent. For example
+both Postgres and MySql support CREATE TABLE IF NOT EXISTS statements that can be
+used to create tables in an idempotent way.
+
+Arguments
+"""""""""
+
+If you define connection via `AIRFLOW_CONN_*` URL defined in an environment
+variable, make sure the URL components in the URL are URL-encoded.
+See examples below for details.
+
+Note that in case of SSL connections you need to have a mechanism to make the
+certificate/key files available in predefined locations for all the workers on
+which the operator can run. This can be provided for example by mounting
+NFS-like volumes in the same path for all the workers.
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
+      :language: python
+      :start-after: [START howto_operator_cloudsql_query_arguments]
+      :end-before: [END howto_operator_cloudsql_query_arguments]
+
+Example connection definitions for all connectivity cases. Note that all the components
+of the connection URI should be URL-encoded:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
+      :language: python
+      :start-after: [START howto_operator_cloudsql_query_connections]
+      :end-before: [END howto_operator_cloudsql_query_connections]
+
+Using the operator
+""""""""""""""""""
+
+Example operators below are using all connectivity options (note connection id
+from the operator matches the `AIRFLOW_CONN_*` postfix uppercase - this is
+standard AIRFLOW notation for defining connection via environment variables):
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
+      :language: python
+      :start-after: [START howto_operator_cloudsql_query_operators]
+      :end-before: [END howto_operator_cloudsql_query_operators]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_query_template_fields]
+    :end-before: [END gcp_sql_query_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Sql Proxy documentation
+<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_
+for details about Cloud Sql Proxy.
+
diff --git a/docs/integration.rst b/docs/integration.rst
index db23c6cb25609..41cd932bebe61 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -481,63 +481,83 @@ Cloud SQL Operators
 """""""""""""""""""
 
 - :ref:`CloudSqlInstanceDatabaseDeleteOperator` : deletes a database from a Cloud SQL
-instance.
+  instance.
 - :ref:`CloudSqlInstanceDatabaseCreateOperator` : creates a new database inside a Cloud
-SQL instance.
+  SQL instance.
 - :ref:`CloudSqlInstanceDatabasePatchOperator` : updates a database inside a Cloud
-SQL instance.
+  SQL instance.
 - :ref:`CloudSqlInstanceDeleteOperator` : delete a Cloud SQL instance.
 - :ref:`CloudSqlInstanceCreateOperator` : create a new Cloud SQL instance.
 - :ref:`CloudSqlInstancePatchOperator` : patch a Cloud SQL instance.
+- :ref:`CloudSqlQueryOperator` : run query in a Cloud SQL instance.
 
-.. CloudSqlInstanceDatabaseDeleteOperator:
+.. _CloudSqlInstanceDatabaseDeleteOperator:
 
 CloudSqlInstanceDatabaseDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
 
-.. CloudSqlInstanceDatabaseCreateOperator:
+.. _CloudSqlInstanceDatabaseCreateOperator:
 
 CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
 
-.. CloudSqlInstanceDatabasePatchOperator:
+.. _CloudSqlInstanceDatabasePatchOperator:
 
 CloudSqlInstanceDatabasePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
 
-.. CloudSqlInstanceDeleteOperator:
+.. _CloudSqlInstanceDeleteOperator:
 
 CloudSqlInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
 
-.. CloudSqlInstanceCreateOperator:
+.. _CloudSqlInstanceCreateOperator:
 
 CloudSqlInstanceCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
 
-.. CloudSqlInstancePatchOperator:
+.. _CloudSqlInstancePatchOperator:
 
 CloudSqlInstancePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
 
-Cloud SQL Hook
-""""""""""""""
+.. _CloudSqlQueryOperator:
+
+CloudSqlQueryOperator
+^^^^^^^^^^^^^^^^^^^^^
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
+
+Cloud SQL Hooks
+"""""""""""""""
+
+.. _CloudSqlHook:
 
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
     :members:
 
+.. _CloudSqlDatabaseHook:
+
+.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
+    :members:
+
+.. _CloudSqlProxyRunner:
+
+.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner
+    :members:
+
+
 Compute Engine
 ''''''''''''''
 
diff --git a/tests/contrib/operators/test_gcp_base.py b/tests/contrib/operators/test_gcp_base.py
new file mode 100644
index 0000000000000..60e5abeb9f6e6
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_base.py
@@ -0,0 +1,174 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import json
+import os
+import subprocess
+import unittest
+
+from airflow import models, settings, configuration, AirflowException
+from airflow.utils.timezone import datetime
+
+DEFAULT_DATE = datetime(2015, 1, 1)
+
+KEYPATH_EXTRA = 'extra__google_cloud_platform__key_path'
+KEYFILE_DICT_EXTRA = 'extra__google_cloud_platform__keyfile_dict'
+SCOPE_EXTRA = 'extra__google_cloud_platform__scope'
+PROJECT_EXTRA = 'extra__google_cloud_platform__project'
+
+AIRFLOW_MAIN_FOLDER = os.path.realpath(os.path.join(
+    os.path.dirname(os.path.realpath(__file__)),
+    os.pardir, os.pardir, os.pardir))
+
+CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
+    AIRFLOW_MAIN_FOLDER, "airflow", "contrib", "example_dags")
+
+OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
+    AIRFLOW_MAIN_FOLDER, "airflow", "example_dags")
+
+TESTS_DAG_FOLDER = os.path.join(
+    AIRFLOW_MAIN_FOLDER, "tests", "dags")
+
+GCP_FOLDER_ENVIRONMENT_VARIABLE = "GCP_SERVICE_ACCOUNT_KEY_FOLDER"
+
+GCP_COMPUTE_KEY = 'gcp_compute.json'
+GCP_FUNCTION_KEY = 'gcp_function.json'
+GCP_CLOUDSQL_KEY = 'gcp_cloudsql.json'
+GCP_BIGTABLE_KEY = 'gcp_bigtable.json'
+GCP_SPANNER_KEY = 'gcp_spanner.json'
+
+SKIP_TEST_WARNING = """
+The test is only run when there is GCP connection available! "
+Set GCP_SERVICE_ACCOUNT_KEY_FOLDER environment variable if "
+you want to run them".
+"""
+
+
+class BaseGcpIntegrationTestCase(unittest.TestCase):
+    def __init__(self,
+                 method_name,
+                 dag_id,
+                 gcp_key,
+                 dag_name=None,
+                 example_dags_folder=CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER,
+                 project_extra=None):
+        super(BaseGcpIntegrationTestCase, self).__init__(method_name)
+        self.dag_id = dag_id
+        self.dag_name = self.dag_id + '.py' if not dag_name else dag_name
+        self.gcp_key = gcp_key
+        self.example_dags_folder = example_dags_folder
+        self.project_extra = project_extra
+        self.full_key_path = None
+
+    def _gcp_authenticate(self):
+        key_dir_path = os.environ['GCP_SERVICE_ACCOUNT_KEY_FOLDER']
+        self.full_key_path = os.path.join(key_dir_path, self.gcp_key)
+
+        if not os.path.isfile(self.full_key_path):
+            raise Exception("The key {} could not be found. Please copy it to the "
+                            "{} folder.".format(self.gcp_key, key_dir_path))
+        print("Setting the GCP key to {}".format(self.full_key_path))
+        # Checking if we can authenticate using service account credentials provided
+        retcode = subprocess.call(['gcloud', 'auth', 'activate-service-account',
+                                   '--key-file={}'.format(self.full_key_path)])
+        if retcode != 0:
+            raise AirflowException("The gcloud auth method was not successful!")
+        self.update_connection_with_key_path()
+        # Now we revoke all authentication here because we want to make sure
+        # that all works fine with the credentials retrieved from the gcp_connection
+        subprocess.call(['gcloud', 'auth', 'revoke'])
+
+    def update_connection_with_key_path(self):
+        session = settings.Session()
+        try:
+            conn = session.query(models.Connection).filter(
+                models.Connection.conn_id == 'google_cloud_default')[0]
+            extras = conn.extra_dejson
+            extras[KEYPATH_EXTRA] = self.full_key_path
+            if extras.get(KEYFILE_DICT_EXTRA):
+                del extras[KEYFILE_DICT_EXTRA]
+            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
+            extras[PROJECT_EXTRA] = self.project_extra
+            conn.extra = json.dumps(extras)
+            session.commit()
+        except BaseException as e:
+            print('Airflow DB Session error:' + str(e.message))
+            session.rollback()
+            raise
+        finally:
+            session.close()
+
+    def update_connection_with_dictionary(self):
+        session = settings.Session()
+        try:
+            conn = session.query(models.Connection).filter(
+                models.Connection.conn_id == 'google_cloud_default')[0]
+            extras = conn.extra_dejson
+            with open(self.full_key_path, "r") as f:
+                content = json.load(f)
+            extras[KEYFILE_DICT_EXTRA] = json.dumps(content)
+            if extras.get(KEYPATH_EXTRA):
+                del extras[KEYPATH_EXTRA]
+            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
+            extras[PROJECT_EXTRA] = self.project_extra
+            conn.extra = json.dumps(extras)
+            session.commit()
+        except BaseException as e:
+            print('Airflow DB Session error:' + str(e.message))
+            session.rollback()
+            raise
+        finally:
+            session.close()
+
+    def _symlink_dag(self):
+        target_path = os.path.join(TESTS_DAG_FOLDER, self.dag_name)
+        if os.path.exists(target_path):
+            os.remove(target_path)
+        os.symlink(
+            os.path.join(self.example_dags_folder, self.dag_name),
+            os.path.join(target_path))
+
+    def _rm_symlink_dag(self):
+        os.remove(os.path.join(TESTS_DAG_FOLDER, self.dag_name))
+
+    def _run_dag(self):
+        dag_bag = models.DagBag(dag_folder=TESTS_DAG_FOLDER, include_examples=False)
+        self.args = {'owner': 'airflow', 'start_date': DEFAULT_DATE}
+        dag = dag_bag.get_dag(self.dag_id)
+        dag.clear(reset_dag_runs=True)
+        dag.run(ignore_first_depends_on_past=True, verbose=True)
+
+    def setUp(self):
+        configuration.conf.load_test_config()
+        self._gcp_authenticate()
+        self._symlink_dag()
+
+    def tearDown(self):
+        self._rm_symlink_dag()
+
+    @staticmethod
+    def skip_check(key):
+        if GCP_FOLDER_ENVIRONMENT_VARIABLE not in os.environ:
+            return True
+        key_folder = os.environ[GCP_FOLDER_ENVIRONMENT_VARIABLE]
+        if not os.path.isdir(key_folder):
+            return True
+        key_path = os.path.join(key_folder, key)
+        if not os.path.isfile(key_path):
+            return True
+        return False
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
index e8f9bf01656b8..4a4e336b7c842 100644
--- a/tests/contrib/operators/test_gcp_compute_operator.py
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -340,13 +340,13 @@ def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_h
     MOCK_OP_RESPONSE = "{'kind': 'compute#operation', 'id': '8529919847974922736', " \
                        "'name': " \
                        "'operation-1538578207537-577542784f769-7999ab71-94f9ec1d', " \
-                       "'zone': 'https://www.googleapis.com/compute/v1/projects/polidea" \
-                       "-airflow/zones/europe-west3-b', 'operationType': " \
+                       "'zone': 'https://www.googleapis.com/compute/v1/projects/example" \
+                       "-project/zones/europe-west3-b', 'operationType': " \
                        "'setMachineType', 'targetLink': " \
-                       "'https://www.googleapis.com/compute/v1/projects/example-airflow" \
+                       "'https://www.googleapis.com/compute/v1/projects/example-project" \
                        "/zones/europe-west3-b/instances/pa-1', 'targetId': " \
                        "'2480086944131075860', 'status': 'DONE', 'user': " \
-                       "'uberdarek@example-airflow.iam.gserviceaccount.com', " \
+                       "'service-account@example-project.iam.gserviceaccount.com', " \
                        "'progress': 100, 'insertTime': '2018-10-03T07:50:07.951-07:00', "\
                        "'startTime': '2018-10-03T07:50:08.324-07:00', 'endTime': " \
                        "'2018-10-03T07:50:08.484-07:00', 'error': {'errors': [{'code': " \
@@ -354,7 +354,7 @@ def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_h
                        "'machine-type-1' does not exist in zone 'europe-west3-b'.\"}]}, "\
                        "'httpErrorStatusCode': 400, 'httpErrorMessage': 'BAD REQUEST', " \
                        "'selfLink': " \
-                       "'https://www.googleapis.com/compute/v1/projects/example-airflow" \
+                       "'https://www.googleapis.com/compute/v1/projects/example-project" \
                        "/zones/europe-west3-b/operations/operation-1538578207537" \
                        "-577542784f769-7999ab71-94f9ec1d'} "
 
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 31ed3d37c3c52..516fcef4aa85b 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -16,14 +16,23 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
+import json
+import os
+import time
 import unittest
+from uuid import uuid1
+
+from parameterized import parameterized
 
 from airflow import AirflowException
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlProxyRunner
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
     CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
     CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
-    CloudSqlInstanceDatabaseDeleteOperator
+    CloudSqlInstanceDatabaseDeleteOperator, CloudSqlQueryOperator
+from airflow.models import Connection
+from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
+    GCP_CLOUDSQL_KEY, SKIP_TEST_WARNING
 
 try:
     # noinspection PyProtectedMember
@@ -34,9 +43,10 @@
     except ImportError:
         mock = None
 
-PROJECT_ID = "project-id"
-INSTANCE_NAME = "test-name"
-DB_NAME = "db1"
+PROJECT_ID = os.environ.get('PROJECT_ID', 'project-id')
+INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'test-name')
+DB_NAME = os.environ.get('DB_NAME', 'db1')
+
 CREATE_BODY = {
     "name": INSTANCE_NAME,
     "settings": {
@@ -218,7 +228,7 @@ def test_create_should_validate_list_type(self, mock_hook):
                 "tier": "db-n1-standard-1",
                 "ipConfiguration": {
                     "authorizedNetworks": {}  # Should be a list, not a dict.
-                                              # Testing if the validation catches this.
+                    # Testing if the validation catches this.
                 }
             }
         }
@@ -242,7 +252,7 @@ def test_create_should_validate_non_empty_fields(self, mock_hook):
             "name": INSTANCE_NAME,
             "settings": {
                 "tier": "",  # Field can't be empty (defined in CLOUD_SQL_VALIDATION).
-                             # Testing if the validation catches this.
+                # Testing if the validation catches this.
             }
         }
         with self.assertRaises(AirflowException) as cm:
@@ -318,7 +328,9 @@ def test_instance_delete(self, mock_hook, _check_if_instance_exists):
                 ".CloudSqlInstanceDeleteOperator._check_if_instance_exists")
     @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
     def test_instance_delete_should_abort_and_succeed_if_not_exists(
-            self, mock_hook, _check_if_instance_exists):
+            self,
+            mock_hook,
+            _check_if_instance_exists):
         _check_if_instance_exists.return_value = False
         op = CloudSqlInstanceDeleteOperator(
             project_id=PROJECT_ID,
@@ -462,3 +474,329 @@ def test_instance_db_delete_should_abort_and_succeed_if_not_exists(
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_database.assert_not_called()
+
+
+class CloudSqlQueryValidationTest(unittest.TestCase):
+    @parameterized.expand([
+        ('', 'location', 'instance_name', 'postgres', False, False,
+         'SELECT * FROM TEST',
+         "The required extra 'project_id' is empty"),
+        ('project_id', '', 'instance_name', 'mysql', False, False,
+         'SELECT * FROM TEST',
+         "The required extra 'location' is empty"),
+        ('project_id', 'location', '', 'postgres', False, False,
+         'SELECT * FROM TEST',
+         "The required extra 'instance' is empty"),
+        ('project_id', 'location', 'instance_name', 'wrong', False, False,
+         'SELECT * FROM TEST',
+         "Invalid database type 'wrong'. Must be one of ['postgres', 'mysql']"),
+        ('project_id', 'location', 'instance_name', 'postgres', True, True,
+         'SELECT * FROM TEST',
+         "Cloud Sql Proxy does not support SSL connections. SSL is not needed as"
+         " Cloud Sql Proxy provides encryption on its own"),
+        ('project_id', 'location', 'instance_name', 'postgres', False, True,
+         'SELECT * FROM TEST',
+         "SSL connections requires sslcert to be set"),
+    ])
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_wrong_parameters(self,
+                                                   project_id,
+                                                   location,
+                                                   instance_name,
+                                                   database_type,
+                                                   use_proxy,
+                                                   use_ssl,
+                                                   sql,
+                                                   message,
+                                                   get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type={database_type}&"
+            "project_id={project_id}&location={location}&instance={instance_name}&"
+            "use_proxy={use_proxy}&use_ssl={use_ssl}".
+            format(database_type=database_type,
+                   project_id=project_id,
+                   location=location,
+                   instance_name=instance_name,
+                   use_proxy=use_proxy,
+                   use_ssl=use_ssl))
+        get_connections.return_value = [connection]
+        with self.assertRaises(AirflowException) as cm:
+            CloudSqlQueryOperator(
+                sql=sql,
+                task_id='task_id'
+            )
+        err = cm.exception
+        self.assertIn(message, str(err))
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_postgres(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=False&use_ssl=False")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.postgres_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('postgres', conn.conn_type)
+        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=False&use_ssl=True&sslcert=/bin/bash&"
+            "sslkey=/bin/bash&sslrootcert=/bin/bash")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.postgres_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('postgres', conn.conn_type)
+        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+        self.assertEqual('/bin/bash', conn.extra_dejson['sslkey'])
+        self.assertEqual('/bin/bash', conn.extra_dejson['sslcert'])
+        self.assertEqual('/bin/bash', conn.extra_dejson['sslrootcert'])
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_postgres_proxy_socket(
+            self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=True&sql_proxy_use_tcp=False")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.postgres_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('postgres', conn.conn_type)
+        self.assertIn('/tmp', conn.host)
+        self.assertIn('example-project:europe-west1:testdb', conn.host)
+        self.assertIsNone(conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_postgres_proxy_tcp(self,
+                                                                        get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=True&sql_proxy_use_tcp=True")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.postgres_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('postgres', conn.conn_type)
+        self.assertEqual('127.0.0.1', conn.host)
+        self.assertNotEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_mysql(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=False&use_ssl=False")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.mysql_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('mysql', conn.conn_type)
+        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=False&use_ssl=True&sslcert=/bin/bash&"
+            "sslkey=/bin/bash&sslrootcert=/bin/bash")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.mysql_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('mysql', conn.conn_type)
+        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+        self.assertEqual('/bin/bash', json.loads(conn.extra_dejson['ssl'])['cert'])
+        self.assertEqual('/bin/bash', json.loads(conn.extra_dejson['ssl'])['key'])
+        self.assertEqual('/bin/bash', json.loads(conn.extra_dejson['ssl'])['ca'])
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_mysql_proxy_socket(self,
+                                                                        get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=True&sql_proxy_use_tcp=False")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.mysql_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('mysql', conn.conn_type)
+        self.assertEqual('localhost', conn.host)
+        self.assertIn('/tmp', conn.extra_dejson['unix_socket'])
+        self.assertIn('example-project:europe-west1:testdb',
+                      conn.extra_dejson['unix_socket'])
+        self.assertIsNone(conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=True&sql_proxy_use_tcp=True")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.mysql_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('mysql', conn.conn_type)
+        self.assertEqual('127.0.0.1', conn.host)
+        self.assertNotEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+
+
+@unittest.skipIf(
+    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
+class CloudSqlProxyIntegrationTest(BaseGcpIntegrationTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlProxyIntegrationTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_sql_query',
+            gcp_key='gcp_cloudsql.json')
+
+    def test_start_proxy_fail_no_parameters(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
+                                     project_id=PROJECT_ID,
+                                     instance_specification='a')
+        with self.assertRaises(AirflowException) as cm:
+            runner.start_proxy()
+        err = cm.exception
+        self.assertIn("invalid instance name", str(err))
+        with self.assertRaises(AirflowException) as cm:
+            runner.start_proxy()
+        err = cm.exception
+        self.assertIn("invalid instance name", str(err))
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
+                                     project_id=PROJECT_ID,
+                                     instance_specification='')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances_generated_credential_file(self):
+        self.update_connection_with_dictionary()
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
+                                     project_id=PROJECT_ID,
+                                     instance_specification='')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances_specific_version(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
+                                     project_id=PROJECT_ID,
+                                     instance_specification='',
+                                     sql_proxy_version='v1.13')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+        self.assertEqual(runner.get_proxy_version(), "1.13")
+
+
+@unittest.skipIf(
+    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
+class CloudSqlQueryExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlQueryExampleDagsIntegrationTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_sql_query',
+            gcp_key=GCP_CLOUDSQL_KEY)
+
+    def test_run_example_dag_cloudsql_query(self):
+        self._run_dag()
diff --git a/tests/dags/.gitignore b/tests/dags/.gitignore
new file mode 100644
index 0000000000000..beddda487f386
--- /dev/null
+++ b/tests/dags/.gitignore
@@ -0,0 +1,5 @@
+# This line is to avoid accidental commits of example dags for integration testing
+# In order to test example dags easily we often create symbolic links in this directory
+# and run the Airflow with AIRFLOW__CORE__UNIT_TEST_MODE=True
+# this line prevents accidental commiting of such symbolic links
+example_*

From 3b9a041b7488ffd21b86a973a088751cd8cfdaeb Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 28 Nov 2018 16:52:15 +0000
Subject: [PATCH 235/808] [AIRFLOW-3410] Add feature to allow Host Key Change
 for SSH Op (#4249)

---
 airflow/contrib/hooks/ssh_hook.py             | 12 +++-
 airflow/www/static/connection_form.js         |  6 ++
 airflow/www_rbac/static/js/connection_form.js |  6 ++
 docs/howto/manage-connections.rst             | 60 +++++++++++++++++--
 tests/contrib/hooks/test_ssh_hook.py          | 13 ++--
 5 files changed, 85 insertions(+), 12 deletions(-)

diff --git a/airflow/contrib/hooks/ssh_hook.py b/airflow/contrib/hooks/ssh_hook.py
index c496762187435..97e93bbc603f9 100755
--- a/airflow/contrib/hooks/ssh_hook.py
+++ b/airflow/contrib/hooks/ssh_hook.py
@@ -80,6 +80,7 @@ def __init__(self,
         # Default values, overridable from Connection
         self.compress = True
         self.no_host_key_check = True
+        self.allow_host_key_change = False
         self.host_proxy = None
 
         # Placeholder for deprecated __enter__
@@ -110,6 +111,10 @@ def __init__(self,
                         and\
                         str(extra_options["no_host_key_check"]).lower() == 'false':
                     self.no_host_key_check = False
+                if "allow_host_key_change" in extra_options\
+                        and\
+                        str(extra_options["allow_host_key_change"]).lower() == 'true':
+                    self.allow_host_key_change = True
 
         if not self.remote_host:
             raise AirflowException("Missing required param: remote_host")
@@ -146,8 +151,13 @@ def get_conn(self):
 
         self.log.debug('Creating SSH client for conn_id: %s', self.ssh_conn_id)
         client = paramiko.SSHClient()
-        client.load_system_host_keys()
+        if not self.allow_host_key_change:
+            self.log.warning('Remote Identification Change is not verified. '
+                             'This wont protect against Man-In-The-Middle attacks')
+            client.load_system_host_keys()
         if self.no_host_key_check:
+            self.log.warning('No Host Key Verification. This wont protect '
+                             'against Man-In-The-Middle attacks')
             # Default is RejectPolicy
             client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
 
diff --git a/airflow/www/static/connection_form.js b/airflow/www/static/connection_form.js
index 5a74813d5ba88..8ed42c2dbed2e 100644
--- a/airflow/www/static/connection_form.js
+++ b/airflow/www/static/connection_form.js
@@ -61,6 +61,12 @@
             'password': 'Auth Token',
           }
         },
+        ssh: {
+          hidden_fields: ['schema'],
+          relabeling: {
+            'login': 'Username',
+          }
+        },
       }
       function connTypeChange(connectionType) {
         $("div.form-group").removeClass("hide");
diff --git a/airflow/www_rbac/static/js/connection_form.js b/airflow/www_rbac/static/js/connection_form.js
index dabd1f73592ef..09034f8785203 100644
--- a/airflow/www_rbac/static/js/connection_form.js
+++ b/airflow/www_rbac/static/js/connection_form.js
@@ -53,6 +53,12 @@ $(document).ready(function () {
         'password': 'Auth Token',
       }
     },
+    ssh: {
+      hidden_fields: ['schema'],
+      relabeling: {
+        'login': 'Username',
+      }
+    },
   };
 
   function connTypeChange(connectionType) {
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index ec5cce189cebe..35b5807c9ea96 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -216,7 +216,7 @@ Extra (optional)
        }
 
     When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras as passed as parameters
+    following the standard syntax of DB connections, where extras are passed as parameters
     of the URI (note that all components of the URI should be URL-encoded).
 
     For example:
@@ -248,7 +248,7 @@ Password (required)
     Specify the password to connect.
 
 Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in mysql
+    Specify the extra parameters (as json dictionary) that can be used in postgres
     connection. The following parameters out of the standard python parameters
     are supported:
 
@@ -278,12 +278,12 @@ Extra (optional)
        {
           "sslmode": "verify-ca",
           "sslcert": "/tmp/client-cert.pem",
-          "sslca": "/tmp/server-ca.pem'",
+          "sslca": "/tmp/server-ca.pem",
           "sslkey": "/tmp/client-key.pem"
        }
 
     When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras as passed as parameters
+    following the standard syntax of DB connections, where extras are passed as parameters
     of the URI (note that all components of the URI should be URL-encoded).
 
     For example:
@@ -321,7 +321,7 @@ Password (required)
     Specify the password to connect.
 
 Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in mysql
+    Specify the extra parameters (as json dictionary) that can be used in gcpcloudsql
     connection.
 
     Details of all the parameters supported in extra field can be found in
@@ -341,7 +341,7 @@ Extra (optional)
        }
 
     When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras as passed as parameters
+    following the standard syntax of DB connections, where extras are passed as parameters
     of the URI (note that all components of the URI should be URL-encoded).
 
     For example:
@@ -350,3 +350,51 @@ Extra (optional)
 
         gcpcloudsql://user:XXXXXXXXX@1.1.1.1:3306/mydb?database_type=mysql&project_id=example-project&location=europe-west1&instance=testinstance&use_proxy=True&sql_proxy_use_tcp=False
 
+SSH
+~~~
+The SSH connection type provides connection to use :class:`~airflow.contrib.hooks.ssh_hook.SSHHook` to run commands on a remote server using :class:`~airflow.contrib.operators.ssh_operator.SSHOperator` or transfer file from/to the remote server using :class:`~airflow.contrib.operators.ssh_operator.SFTPOperator`.
+
+Configuring the Connection
+''''''''''''''''''''''''''
+Host (required)
+    The Remote host to connect.
+
+Username (optional)
+    The Username to connect to the remote_host.
+
+Password (optional)
+    Specify the password of the username to connect to the remote_host.
+
+Port (optional)
+    Port of remote host to connect. Default is 22.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in ssh
+    connection. The following parameters out of the standard python parameters
+    are supported:
+
+    * **timeout** - An optional timeout (in seconds) for the TCP connect. Default is ``10``.
+    * **compress** - ``true`` to ask the remote client/server to compress traffic; `false` to refuse compression. Default is ``true``.
+    * **no_host_key_check** - Set to ``false`` to restrict connecting to hosts with no entries in ``~/.ssh/known_hosts`` (Hosts file). This provides maximum protection against trojan horse attacks, but can be troublesome when the ``/etc/ssh/ssh_known_hosts`` file is poorly maintained or connections to new hosts are frequently made. This option forces the user to manually add all new hosts. Default is ``true``, ssh will automatically add new host keys to the user known hosts files.
+    * **allow_host_key_change** - Set to ``true`` if you want to allow connecting to hosts that has host key changed or when you get 'REMOTE HOST IDENTIFICATION HAS CHANGED' error.  This wont protect against Man-In-The-Middle attacks. Other possible solution is to remove the host entry from ``~/.ssh/known_hosts`` file. Default is ``false``.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "timeout": "10",
+          "compress": "false",
+          "no_host_key_check": "false",
+          "allow_host_key_change": "false"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of connections, where extras are passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        ssh://user:pass@localhost:22?timeout=10&compress=false&no_host_key_check=false&allow_host_key_change=true
diff --git a/tests/contrib/hooks/test_ssh_hook.py b/tests/contrib/hooks/test_ssh_hook.py
index ad5621fe92357..64b015d09e5d7 100644
--- a/tests/contrib/hooks/test_ssh_hook.py
+++ b/tests/contrib/hooks/test_ssh_hook.py
@@ -132,15 +132,18 @@ def test_tunnel_without_password(self, ssh_mock):
 
     def test_conn_with_extra_parameters(self):
         db.merge_conn(
-            models.Connection(conn_id='ssh_with_extra',
-                              host='localhost',
-                              conn_type='ssh',
-                              extra='{"compress" : true, "no_host_key_check" : "true"}'
-                              )
+            models.Connection(
+                conn_id='ssh_with_extra',
+                host='localhost',
+                conn_type='ssh',
+                extra='{"compress" : true, "no_host_key_check" : "true", '
+                      '"allow_host_key_change": false}'
+            )
         )
         ssh_hook = SSHHook(ssh_conn_id='ssh_with_extra')
         self.assertEqual(ssh_hook.compress, True)
         self.assertEqual(ssh_hook.no_host_key_check, True)
+        self.assertEqual(ssh_hook.allow_host_key_change, False)
 
     def test_ssh_connection(self):
         hook = SSHHook(ssh_conn_id='ssh_default')

From c324d584989a63d097fe51a3b41e98130ed6a9b7 Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Mon, 26 Nov 2018 12:58:33 +0300
Subject: [PATCH 236/808] [AIRFLOW-3395] added the REST API endpoints to the
 doc (#4236)

---
 docs/api.rst | 70 +++++++++++++++++++++++++++++++++++++++++++++++++---
 docs/conf.py |  1 +
 setup.py     |  1 +
 3 files changed, 69 insertions(+), 3 deletions(-)

diff --git a/docs/api.rst b/docs/api.rst
index 194809abc6330..8ddfa8a4fdac7 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -24,10 +24,74 @@ available at /api/experimental/. Please note that we expect the endpoint definit
 Endpoints
 ---------
 
-This is a place holder until the swagger definitions are active
+.. http:post:: /api/experimental/dags/<DAG_ID>/dag_runs
+
+
+  Creates a dag_run for a given dag id.
+
+
+  **Trigger DAG with config, example:**
+
+  .. code-block:: bash
+
+    curl -X POST \
+      http://localhost:8080/api/experimental/dags/<DAG_ID>/dag_runs \
+      -H 'Cache-Control: no-cache' \
+      -H 'Content-Type: application/json' \
+      -d '{"conf":"{\"key\":\"value\"}"}'
+
+
+.. http:get:: /api/experimental/dags/<DAG_ID>/dag_runs
+
+  Returns a list of Dag Runs for a specific DAG ID.
+
+.. http:get:: /api/experimental/dags/<string:dag_id>/dag_runs/<string:execution_date>
+
+  Returns a JSON with a dag_run's public instance variables. The format for the <string:execution_date> is expected to be "YYYY-mm-DDTHH:MM:SS", for example: "2016-11-16T11:34:15".
+
+
+.. http:get:: /api/experimental/test
+
+  To check REST API server correct work. Return status 'OK'.
+
+
+.. http:get:: /api/experimental/dags/<DAG_ID>/tasks/<TASK_ID>
+
+  Returns info for a task.
+
+
+.. http:get:: /api/experimental/dags/<DAG_ID>/dag_runs/<string:execution_date>/tasks/<TASK_ID>
+
+  Returns a JSON with a task instance's public instance variables. The format for the <string:execution_date> is expected to be "YYYY-mm-DDTHH:MM:SS", for example: "2016-11-16T11:34:15".
+
+
+.. http:get:: /api/experimental/dags/<DAG_ID>/paused/<string:paused>
+
+  '<string:paused>' must be a 'true' to pause a DAG and 'false' to unpause.
+
+
+.. http:get:: /api/experimental/latest_runs
+
+  Returns the latest DagRun for each DAG formatted for the UI.
+
+
+.. http:get:: /api/experimental/pools
+
+  Get all pools.
+
+
+.. http:get:: /api/experimental/pools/<string:name>
+
+  Get pool by a given name.
+
+.. http:post:: /api/experimental/pools
+
+  Create a pool.
+
+.. http:delete:: /api/experimental/pools/<string:name>
+
+  Delete pool.
 
-* /api/experimental/dags/<DAG_ID>/tasks/<TASK_ID> returns info for a task (GET).
-* /api/experimental/dags/<DAG_ID>/dag_runs creates a dag_run for a given dag id (POST).
 
 CLI
 -----
diff --git a/docs/conf.py b/docs/conf.py
index fa2a3d2274acb..cc00a276413ae 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -76,6 +76,7 @@
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
     'sphinxarg.ext',
+    'sphinxcontrib.httpdomain'
 ]
 
 autodoc_default_flags = ['show-inheritance', 'members']
diff --git a/setup.py b/setup.py
index f5f06b7316154..f34985c943c04 100644
--- a/setup.py
+++ b/setup.py
@@ -173,6 +173,7 @@ def write_version(filename=os.path.join(*['airflow',
     'sphinx>=1.2.3',
     'sphinx-argparse>=0.1.13',
     'sphinx-rtd-theme>=0.1.6',
+    'sphinxcontrib-httpdomain>=1.7.0',
     'Sphinx-PyPI-upload>=0.2.1'
 ]
 docker = ['docker~=3.0']

From dd39c838d6012cf9ff3ea89366cb9bba24e734e0 Mon Sep 17 00:00:00 2001
From: pengc <348707924@qq.com>
Date: Mon, 26 Nov 2018 17:00:31 +0800
Subject: [PATCH 237/808] [AIRFLOW-2642] fix wrong value git-sync initcontainer
 env GIT_SYNC_ROOT (#3519)

---
 airflow/contrib/kubernetes/worker_configuration.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 8421e05b69f67..b21b6db9871b9 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -49,7 +49,10 @@ def _get_init_containers(self, volume_mounts):
             'value': self.kube_config.git_branch
         }, {
             'name': 'GIT_SYNC_ROOT',
-            'value': '/tmp'
+            'value': os.path.join(
+                self.worker_airflow_dags,
+                self.kube_config.git_subpath
+            )
         }, {
             'name': 'GIT_SYNC_DEST',
             'value': 'dags'

From d0538b86af643e10863e3b939885657957b66f94 Mon Sep 17 00:00:00 2001
From: Victor Villas <villasv@outlook.com>
Date: Sun, 25 Nov 2018 20:03:04 -0200
Subject: [PATCH 238/808] [AIRFLOW-3365][AIRFLOW-3366] Allow
 celery_broker_transport_options to be set with environment variables (#4211)

* [AIRFLOW-3365] Add visibility timeout by key

* [AIRFLOW-3366] Make getsection scan env variables
---
 airflow/config_templates/default_celery.py |  2 +-
 airflow/configuration.py                   |  6 ++++++
 tests/configuration.py                     | 12 ++++++------
 3 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/airflow/config_templates/default_celery.py b/airflow/config_templates/default_celery.py
index d44f2b3448aff..5e72134de1efe 100644
--- a/airflow/config_templates/default_celery.py
+++ b/airflow/config_templates/default_celery.py
@@ -37,7 +37,7 @@ def _broker_supports_visibility_timeout(url):
 )
 if 'visibility_timeout' not in broker_transport_options:
     if _broker_supports_visibility_timeout(broker_url):
-        broker_transport_options = {'visibility_timeout': 21600}
+        broker_transport_options['visibility_timeout'] = 21600
 
 DEFAULT_CELERY_CONFIG = {
     'accept_content': ['json', 'pickle'],
diff --git a/airflow/configuration.py b/airflow/configuration.py
index 1caea93a6cbbb..459e2a39b8e7b 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -323,6 +323,12 @@ def getsection(self, section):
         if section in self._sections:
             _section.update(copy.deepcopy(self._sections[section]))
 
+        section_prefix = 'AIRFLOW__{S}__'.format(S=section.upper())
+        for env_var in sorted(os.environ.keys()):
+            if env_var.startswith(section_prefix):
+                key = env_var.replace(section_prefix, '').lower()
+                _section[key] = self._get_env_var_option(section, key)
+
         for key, val in iteritems(_section):
             try:
                 val = int(val)
diff --git a/tests/configuration.py b/tests/configuration.py
index 08f57fd523d3b..d898ac6d40d58 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -165,7 +165,7 @@ def test_getsection(self):
 key1 = awesome
 key2 = airflow
 
-[another]
+[testsection]
 key3 = value3
 '''
         test_conf = AirflowConfigParser(
@@ -177,18 +177,18 @@ def test_getsection(self):
             test_conf.getsection('test')
         )
         self.assertEqual(
-            OrderedDict([('key3', 'value3')]),
-            test_conf.getsection('another')
+            OrderedDict([
+                ('key3', 'value3'),
+                ('testkey', 'testvalue'),
+                ('testpercent', 'with%percent')]),
+            test_conf.getsection('testsection')
         )
 
     def test_broker_transport_options(self):
         section_dict = conf.getsection("celery_broker_transport_options")
         self.assertTrue(isinstance(section_dict['visibility_timeout'], int))
-
         self.assertTrue(isinstance(section_dict['_test_only_bool'], bool))
-
         self.assertTrue(isinstance(section_dict['_test_only_float'], float))
-
         self.assertTrue(isinstance(section_dict['_test_only_string'], six.string_types))
 
     def test_deprecated_options(self):

From f7c4ec58cc21c67ad74255cade62247059f68261 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Mon, 29 Oct 2018 06:37:46 +0100
Subject: [PATCH 239/808] [AIRFLOW-3264] URL decoding when parsing URI for
 connection (#4109)

---
 airflow/hooks/base_hook.py |  2 +-
 airflow/models.py          | 26 ++++++++++++++-----
 tests/models.py            | 53 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 73 insertions(+), 8 deletions(-)

diff --git a/airflow/hooks/base_hook.py b/airflow/hooks/base_hook.py
index 103fa6260b564..ef44f6469dcb1 100644
--- a/airflow/hooks/base_hook.py
+++ b/airflow/hooks/base_hook.py
@@ -80,7 +80,7 @@ def get_connection(cls, conn_id):
         conn = random.choice(cls.get_connections(conn_id))
         if conn.host:
             log = LoggingMixin().log
-            log.info("Using connection to: %s", conn.host)
+            log.info("Using connection to: %s", conn.debug_info())
         return conn
 
     @classmethod
diff --git a/airflow/models.py b/airflow/models.py
index 92df225a394e8..2165656a8e966 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -53,7 +53,7 @@
 
 import uuid
 from datetime import datetime
-from urllib.parse import urlparse, quote, parse_qsl
+from urllib.parse import urlparse, quote, parse_qsl, unquote
 
 from sqlalchemy import (
     Column, Integer, String, DateTime, Text, Boolean, ForeignKey, PickleType,
@@ -677,16 +677,17 @@ def __init__(
     def parse_from_uri(self, uri):
         temp_uri = urlparse(uri)
         hostname = temp_uri.hostname or ''
-        if '%2f' in hostname:
-            hostname = hostname.replace('%2f', '/').replace('%2F', '/')
         conn_type = temp_uri.scheme
         if conn_type == 'postgresql':
             conn_type = 'postgres'
         self.conn_type = conn_type
-        self.host = hostname
-        self.schema = temp_uri.path[1:]
-        self.login = temp_uri.username
-        self.password = temp_uri.password
+        self.host = unquote(hostname) if hostname else hostname
+        quoted_schema = temp_uri.path[1:]
+        self.schema = unquote(quoted_schema) if quoted_schema else quoted_schema
+        self.login = unquote(temp_uri.username) \
+            if temp_uri.username else temp_uri.username
+        self.password = unquote(temp_uri.password) \
+            if temp_uri.password else temp_uri.password
         self.port = temp_uri.port
         if temp_uri.query:
             self.extra = json.dumps(dict(parse_qsl(temp_uri.query)))
@@ -803,6 +804,17 @@ def get_hook(self):
     def __repr__(self):
         return self.conn_id
 
+    def debug_info(self):
+        return ("id: {}. Host: {}, Port: {}, Schema: {}, "
+                "Login: {}, Password: {}, extra: {}".
+                format(self.conn_id,
+                       self.host,
+                       self.port,
+                       self.schema,
+                       self.login,
+                       "XXXXXXXX" if self.password else None,
+                       self.extra_dejson))
+
     @property
     def extra_dejson(self):
         """Returns the extra property by deserializing json."""
diff --git a/tests/models.py b/tests/models.py
index c6b6b5e075f2a..6c8fba070a4a2 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -2901,6 +2901,59 @@ def test_connection_from_uri_with_extras(self):
         self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
                                                        'extra2': '/path/'})
 
+    def test_connection_from_uri_with_colon_in_hostname(self):
+        uri = 'scheme://user:password@host%2flocation%3ax%3ay:1234/schema?' \
+              'extra1=a%20value&extra2=%2fpath%2f'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+        self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
+                                                       'extra2': '/path/'})
+
+    def test_connection_from_uri_with_encoded_password(self):
+        uri = 'scheme://user:password%20with%20space@host%2flocation%3ax%3ay:1234/schema'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_encoded_user(self):
+        uri = 'scheme://domain%2fuser:password@host%2flocation%3ax%3ay:1234/schema'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'domain/user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_encoded_schema(self):
+        uri = 'scheme://user:password%20with%20space@host:1234/schema%2ftest'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, 'schema/test')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_no_schema(self):
+        uri = 'scheme://user:password%20with%20space@host:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
 
 class TestSkipMixin(unittest.TestCase):
 

From f9066356854e57b9933c5e5e1a4287b908697389 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Thu, 22 Nov 2018 13:22:35 +0100
Subject: [PATCH 240/808] [AIRFLOW-3263] Ignore exception when 'run' kills
 already killed job (#4108)

Sometimes when you run tasks from command line you get exit code = 1 due
to race condition (job runner tries to get process group from the
process that has already been terminated in the meantime)
---
 airflow/utils/helpers.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 45d0217e230ae..b3d1768945281 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -22,6 +22,8 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
+import errno
+
 import psutil
 
 from builtins import input
@@ -237,7 +239,15 @@ def on_terminate(p):
     children = parent.children(recursive=True)
     children.append(parent)
 
-    log.info("Sending %s to GPID %s", sig, os.getpgid(pid))
+    try:
+        pg = os.getpgid(pid)
+    except OSError as err:
+        # Skip if not such process - we experience a race and it just terminated
+        if err.errno == errno.ESRCH:
+            return
+        raise
+
+    log.info("Sending %s to GPID %s", sig, pg)
     os.killpg(os.getpgid(pid), sig)
 
     gone, alive = psutil.wait_procs(children, timeout=timeout, callback=on_terminate)

From b834bb576367d706898be23b77138b5e56ff7daf Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 13 Nov 2018 22:48:23 +0800
Subject: [PATCH 241/808] [AIRFLOW-3323] Support HTTP basic authentication for
 Airflow Flower (#4166)

The current `airflow flower` doesn't come with any authentication.
This may make essential information exposed in an untrusted environment.

This commit add support to HTTP basic authentication for Airflow Flower

Ref:
https://flower.readthedocs.io/en/latest/auth.html
---
 airflow/bin/cli.py                           | 16 +++++++++++++---
 airflow/config_templates/default_airflow.cfg |  5 +++++
 docs/security.rst                            | 19 +++++++++++++++++++
 scripts/ci/kubernetes/kube/configmaps.yaml   |  5 +++++
 4 files changed, 42 insertions(+), 3 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 1b0bf936279f0..ef7d7e7f5ba8e 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1243,6 +1243,10 @@ def flower(args):
     if args.url_prefix:
         url_prefix = '--url-prefix=' + args.url_prefix
 
+    basic_auth = ''
+    if args.basic_auth:
+        basic_auth = '--basic_auth=' + args.basic_auth
+
     flower_conf = ''
     if args.flower_conf:
         flower_conf = '--conf=' + args.flower_conf
@@ -1264,7 +1268,7 @@ def flower(args):
 
         with ctx:
             os.execvp("flower", ['flower', '-b',
-                                 broka, address, port, api, flower_conf, url_prefix])
+                                 broka, address, port, api, flower_conf, url_prefix, basic_auth])
 
         stdout.close()
         stderr.close()
@@ -1273,7 +1277,7 @@ def flower(args):
         signal.signal(signal.SIGTERM, sigint_handler)
 
         os.execvp("flower", ['flower', '-b',
-                             broka, address, port, api, flower_conf, url_prefix])
+                             broka, address, port, api, flower_conf, url_prefix, basic_auth])
 
 
 @cli_utils.action_logging
@@ -1684,6 +1688,12 @@ class CLIFactory(object):
             ("-u", "--url_prefix"),
             default=conf.get('celery', 'FLOWER_URL_PREFIX'),
             help="URL prefix for Flower"),
+        'flower_basic_auth': Arg(
+            ("-ba", "--basic_auth"),
+            default=conf.get('celery', 'FLOWER_BASIC_AUTH'),
+            help=("Securing Flower with Basic Authentication. "
+                  "Accepts user:password pairs separated by a comma. "
+                  "Example: flower_basic_auth = user1:password1,user2:password2")),
         'task_params': Arg(
             ("-tp", "--task_params"),
             help="Sends a JSON params dict to the task"),
@@ -1904,7 +1914,7 @@ class CLIFactory(object):
             'func': flower,
             'help': "Start a Celery Flower",
             'args': ('flower_hostname', 'flower_port', 'flower_conf', 'flower_url_prefix',
-                     'broker_api', 'pid', 'daemon', 'stdout', 'stderr', 'log_file'),
+                     'flower_basic_auth', 'broker_api', 'pid', 'daemon', 'stdout', 'stderr', 'log_file'),
         }, {
             'func': version,
             'help': "Show the version",
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 01d975d5ab6cb..7159c137f4c25 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -378,6 +378,11 @@ flower_url_prefix =
 # This defines the port that Celery Flower runs on
 flower_port = 5555
 
+# Securing Flower with Basic Authentication
+# Accepts user:password pairs separated by a comma
+# Example: flower_basic_auth = user1:password1,user2:password2
+flower_basic_auth =
+
 # Default queue that tasks get assigned to and that worker listen on.
 default_queue = default
 
diff --git a/docs/security.rst b/docs/security.rst
index 0be3609073495..13f7eeb57dc7b 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -395,3 +395,22 @@ not set.
 
     [core]
     default_impersonation = airflow
+
+
+Flower Authentication
+---------------------
+
+Basic authentication for Celery Flower is supported.
+
+You can specify the details either as an optional argument in the Flower process launching
+command, or as a configuration item in your ``airflow.cfg``. For both cases, please provide
+`user:password` pairs separated by a comma.
+
+.. code-block:: bash
+
+    airflow flower --basic_auth=user1:password1,user2:password2
+
+.. code-block:: bash
+
+    [celery]
+    flower_basic_auth = user1:password1,user2:password2
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index 45e641835da8f..5796599683eb5 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -252,6 +252,11 @@ data:
     # This defines the port that Celery Flower runs on
     flower_port = 5555
 
+    # Securing Flower with Basic Authentication
+    # Accepts user:password pairs separated by a comma
+    # Example: flower_basic_auth = user1:password1,user2:password2
+    flower_basic_auth =
+
     # Default queue that tasks get assigned to and that worker listen on.
     default_queue = default
 

From 5e88829c68e609a6a7c7c61c6194b4a8c9034fe1 Mon Sep 17 00:00:00 2001
From: tal181 <tal181@gmail.com>
Date: Sat, 1 Dec 2018 23:14:20 +0200
Subject: [PATCH 242/808] [AIRFLOW-3403] Add AWS Athena Sensor (#4244)

---
 airflow/contrib/sensors/aws_athena_sensor.py | 79 ++++++++++++++++++++
 docs/code.rst                                |  1 +
 tests/contrib/sensors/test_athena_sensor.py  | 71 ++++++++++++++++++
 3 files changed, 151 insertions(+)
 create mode 100644 airflow/contrib/sensors/aws_athena_sensor.py
 create mode 100644 tests/contrib/sensors/test_athena_sensor.py

diff --git a/airflow/contrib/sensors/aws_athena_sensor.py b/airflow/contrib/sensors/aws_athena_sensor.py
new file mode 100644
index 0000000000000..af864d3a36694
--- /dev/null
+++ b/airflow/contrib/sensors/aws_athena_sensor.py
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+from airflow.exceptions import AirflowException
+from airflow.utils.decorators import apply_defaults
+from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+
+
+class AthenaSensor(BaseSensorOperator):
+    """
+    Asks for the state of the Query until it reaches a failure state or success state.
+    If it fails, failing the task.
+
+    :param query_execution_id: query_execution_id to check the state of
+    :type query_execution_id: str
+    :param max_retires: Number of times to poll for query state before
+        returning the current state, defaults to None
+    :type max_retires: int
+    :param aws_conn_id: aws connection to use, defaults to 'aws_default'
+    :type aws_conn_id: str
+    :param sleep_time: Time to wait between two consecutive call to
+        check query status on athena, defaults to 10
+    :type sleep_time: int
+    """
+
+    INTERMEDIATE_STATES = ('QUEUED', 'RUNNING',)
+    FAILURE_STATES = ('FAILED', 'CANCELLED',)
+    SUCCESS_STATES = ('SUCCEEDED',)
+
+    template_fields = ['query_execution_id']
+    template_ext = ()
+    ui_color = '#66c3ff'
+
+    @apply_defaults
+    def __init__(self,
+                 query_execution_id,
+                 max_retires=None,
+                 aws_conn_id='aws_default',
+                 sleep_time=10,
+                 *args, **kwargs):
+        super(BaseSensorOperator, self).__init__(*args, **kwargs)
+        self.aws_conn_id = aws_conn_id
+        self.query_execution_id = query_execution_id
+        self.hook = None
+        self.sleep_time = sleep_time
+        self.max_retires = max_retires
+
+    def poke(self, context):
+        self.hook = self.get_hook()
+        self.hook.get_conn()
+        state = self.hook.poll_query_status(self.query_execution_id, self.max_retires)
+
+        if state in self.FAILURE_STATES:
+            raise AirflowException('Athena sensor failed')
+
+        if state in self.INTERMEDIATE_STATES:
+            return False
+        return True
+
+    def get_hook(self):
+        return AWSAthenaHook(self.aws_conn_id, self.sleep_time)
diff --git a/docs/code.rst b/docs/code.rst
index 82aba544c405f..26a721a08d975 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -226,6 +226,7 @@ Operators
 Sensors
 ^^^^^^^
 
+.. autoclass:: airflow.contrib.sensors.aws_athena_sensor.AthenaSensor
 .. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
 .. autoclass:: airflow.contrib.sensors.bash_sensor.BashSensor
 .. autoclass:: airflow.contrib.sensors.bigquery_sensor.BigQueryTableSensor
diff --git a/tests/contrib/sensors/test_athena_sensor.py b/tests/contrib/sensors/test_athena_sensor.py
new file mode 100644
index 0000000000000..6a8d713e3f6a7
--- /dev/null
+++ b/tests/contrib/sensors/test_athena_sensor.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow import configuration, AirflowException
+from airflow.contrib.sensors.aws_athena_sensor import AthenaSensor
+from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestAthenaSensor(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+
+        self.sensor = AthenaSensor(task_id='test_athena_sensor',
+                                   query_execution_id='abc',
+                                   sleep_time=5,
+                                   max_retires=1,
+                                   aws_conn_id='aws_default')
+
+    @mock.patch.object(AWSAthenaHook, 'poll_query_status', side_effect=("SUCCEEDED",))
+    def test_poke_success(self, mock_poll_query_status):
+        self.assertTrue(self.sensor.poke(None))
+
+    @mock.patch.object(AWSAthenaHook, 'poll_query_status', side_effect=("RUNNING",))
+    def test_poke_running(self, mock_poll_query_status):
+        self.assertFalse(self.sensor.poke(None))
+
+    @mock.patch.object(AWSAthenaHook, 'poll_query_status', side_effect=("QUEUED",))
+    def test_poke_queued(self, mock_poll_query_status):
+        self.assertFalse(self.sensor.poke(None))
+
+    @mock.patch.object(AWSAthenaHook, 'poll_query_status', side_effect=("FAILED",))
+    def test_poke_failed(self, mock_poll_query_status):
+        with self.assertRaises(AirflowException) as context:
+            self.sensor.poke(None)
+        self.assertIn('Athena sensor failed', str(context.exception))
+
+    @mock.patch.object(AWSAthenaHook, 'poll_query_status', side_effect=("CANCELLED",))
+    def test_poke_cancelled(self, mock_poll_query_status):
+        with self.assertRaises(AirflowException) as context:
+            self.sensor.poke(None)
+        self.assertIn('Athena sensor failed', str(context.exception))
+
+
+if __name__ == '__main__':
+    unittest.main()

From cc821b22cf71e869863fa874144754ed3f0b61c3 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sun, 2 Dec 2018 12:09:29 +0100
Subject: [PATCH 243/808] [AIRFLOW-3416] Fixes Python 3 compatibility with
 CloudSqlQueryOperator (#4254)

Added several missing decodes on reading output from running
subprocess (cloud_sql_proxy)
---
 airflow/contrib/example_dags/example_gcp_sql_query.py | 2 +-
 airflow/contrib/hooks/gcp_sql_hook.py                 | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_sql_query.py b/airflow/contrib/example_dags/example_gcp_sql_query.py
index af7c5c24479fa..5439fb6afc7e8 100644
--- a/airflow/contrib/example_dags/example_gcp_sql_query.py
+++ b/airflow/contrib/example_dags/example_gcp_sql_query.py
@@ -188,7 +188,7 @@
 # MySQL: connect via proxy over UNIX socket using pre-downloaded Cloud Sql Proxy binary
 try:
     sql_proxy_binary_path = subprocess.check_output(
-        ['which', 'cloud_sql_proxy']).rstrip()
+        ['which', 'cloud_sql_proxy']).decode('utf-8').rstrip()
 except subprocess.CalledProcessError:
     sql_proxy_binary_path = "/tmp/anyhow_download_cloud_sql_proxy"
 
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index aee0098b07de5..43e664d15c857 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -463,7 +463,7 @@ def start_proxy(self):
             self.log.info("The pid of cloud_sql_proxy: {}".format(
                 self.sql_proxy_process.pid))
             while True:
-                line = self.sql_proxy_process.stderr.readline()
+                line = self.sql_proxy_process.stderr.readline().decode('utf-8')
                 return_code = self.sql_proxy_process.poll()
                 if line == '' and return_code is not None:
                     self.sql_proxy_process = None
@@ -522,7 +522,7 @@ def get_proxy_version(self):
         command_to_run = [self.sql_proxy_path]
         command_to_run.extend(['--version'])
         command_to_run.extend(self._get_credential_parameters())
-        result = subprocess.check_output(command_to_run)
+        result = subprocess.check_output(command_to_run).decode('utf-8')
         pattern = re.compile("^.*[V|v]ersion ([^;]*);.*$")
         m = pattern.match(result)
         if m:

From 02436580b7ee73f025d060e38b9d8fceb00215d8 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 17 Oct 2018 14:46:39 +0100
Subject: [PATCH 244/808] [AIRFLOW-XXX] Add `BigQueryGetDataOperator` to
 Integration Docs (#4063)

---
 docs/integration.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/integration.rst b/docs/integration.rst
index 41cd932bebe61..0cfd1149d898c 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -382,6 +382,7 @@ BigQuery Operators
 - :ref:`BigQueryCheckOperator` : Performs checks against a SQL query that will return a single row with different values.
 - :ref:`BigQueryValueCheckOperator` : Performs a simple value check using SQL code.
 - :ref:`BigQueryIntervalCheckOperator` : Checks that the values of metrics given as SQL expressions are within a certain tolerance of the ones from days_back before.
+- :ref:`BigQueryGetDataOperator` : Fetches the data from a BigQuery table and returns data in a python list
 - :ref:`BigQueryCreateEmptyTableOperator` : Creates a new, empty table in the specified BigQuery dataset optionally with schema.
 - :ref:`BigQueryCreateExternalTableOperator` : Creates a new, external table in the dataset with the data in Google Cloud Storage.
 - :ref:`BigQueryDeleteDatasetOperator` : Deletes an existing BigQuery dataset.

From 0323af1201c3edf075178c5c6df8de7a9b9a95eb Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Thu, 30 Aug 2018 20:01:28 -0700
Subject: [PATCH 245/808] [AIRFLOW-2983] Add prev_ds_nodash and next_ds_nodash
 macro (#3821)

---
 airflow/models.py |  6 ++++++
 docs/code.rst     | 10 ++++++----
 tests/core.py     | 29 +++++++++++++++++++++++++++++
 3 files changed, 41 insertions(+), 4 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 2165656a8e966..2688bd536060d 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1817,12 +1817,16 @@ def get_template_context(self, session=None):
         next_execution_date = task.dag.following_schedule(self.execution_date)
 
         next_ds = None
+        next_ds_nodash = None
         if next_execution_date:
             next_ds = next_execution_date.strftime('%Y-%m-%d')
+            next_ds_nodash = next_ds.replace('-', '')
 
         prev_ds = None
+        prev_ds_nodash = None
         if prev_execution_date:
             prev_ds = prev_execution_date.strftime('%Y-%m-%d')
+            prev_ds_nodash = prev_ds.replace('-', '')
 
         ds_nodash = ds.replace('-', '')
         ts_nodash = ts.replace('-', '').replace(':', '')
@@ -1889,7 +1893,9 @@ def __repr__(self):
             'dag': task.dag,
             'ds': ds,
             'next_ds': next_ds,
+            'next_ds_nodash': next_ds_nodash,
             'prev_ds': prev_ds,
+            'prev_ds_nodash': prev_ds_nodash,
             'ds_nodash': ds_nodash,
             'ts': ts,
             'ts_nodash': ts_nodash,
diff --git a/docs/code.rst b/docs/code.rst
index 26a721a08d975..b8271ceb1662a 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -272,12 +272,14 @@ Variable                            Description
 =================================   ====================================
 ``{{ ds }}``                        the execution date as ``YYYY-MM-DD``
 ``{{ ds_nodash }}``                 the execution date as ``YYYYMMDD``
-``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``.
+``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``
                                     if ``{{ ds }}`` is ``2016-01-08`` and ``schedule_interval`` is ``@weekly``,
-                                    ``{{ prev_ds }}`` will be ``2016-01-01``.
-``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``.
+                                    ``{{ prev_ds }}`` will be ``2016-01-01``
+``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None`
+``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``
                                     if ``{{ ds }}`` is ``2016-01-01`` and ``schedule_interval`` is ``@weekly``,
-                                    ``{{ prev_ds }}`` will be ``2016-01-08``.
+                                    ``{{ prev_ds }}`` will be ``2016-01-08``
+``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None`
 ``{{ yesterday_ds }}``              yesterday's date as ``YYYY-MM-DD``
 ``{{ yesterday_ds_nodash }}``       yesterday's date as ``YYYYMMDD``
 ``{{ tomorrow_ds }}``               tomorrow's date as ``YYYY-MM-DD``
diff --git a/tests/core.py b/tests/core.py
index 156b5a9ec6244..c38f5614cdb1b 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -607,6 +607,35 @@ def __bool__(self):
             dag=self.dag)
         t.resolve_template_files()
 
+    def test_task_get_template(self):
+        TI = models.TaskInstance
+        ti = TI(
+            task=self.runme_0, execution_date=DEFAULT_DATE)
+        ti.dag = self.dag_bash
+        ti.run(ignore_ti_state=True)
+        context = ti.get_template_context()
+
+        # DEFAULT DATE is 2015-01-01
+        self.assertEquals(context['ds'], '2015-01-01')
+        self.assertEquals(context['ds_nodash'], '20150101')
+
+        # next_ds is 2015-01-02 as the dag interval is daily
+        self.assertEquals(context['next_ds'], '2015-01-02')
+        self.assertEquals(context['next_ds_nodash'], '20150102')
+
+        # prev_ds is 2014-12-31 as the dag interval is daily
+        self.assertEquals(context['prev_ds'], '2014-12-31')
+        self.assertEquals(context['prev_ds_nodash'], '20141231')
+
+        self.assertEquals(context['ts'], '2015-01-01T00:00:00+00:00')
+        self.assertEquals(context['ts_nodash'], '20150101T000000+0000')
+
+        self.assertEquals(context['yesterday_ds'], '2014-12-31')
+        self.assertEquals(context['yesterday_ds_nodash'], '20141231')
+
+        self.assertEquals(context['tomorrow_ds'], '2015-01-02')
+        self.assertEquals(context['tomorrow_ds_nodash'], '20150102')
+
     def test_import_examples(self):
         self.assertEqual(len(self.dagbag.dags), NUM_EXAMPLE_DAGS)
 

From d32e9e160bc63f6e796a3e42423da6e3144786db Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 16 Nov 2018 18:54:50 -0500
Subject: [PATCH 246/808] [AIRFLOW-3346] Add hook and operator for GCP transfer
 service (#4189)

---
 airflow/contrib/hooks/gcp_transfer_hook.py    | 107 +++++++++++++++
 .../operators/s3_to_gcs_transfer_operator.py  | 124 ++++++++++++++++++
 docs/code.rst                                 |   2 +
 docs/integration.rst                          |  14 ++
 tests/contrib/hooks/test_gcp_transfer_hook.py | 111 ++++++++++++++++
 .../test_s3_to_gcs_transfer_operator.py       |  98 ++++++++++++++
 6 files changed, 456 insertions(+)
 create mode 100644 airflow/contrib/hooks/gcp_transfer_hook.py
 create mode 100644 airflow/contrib/operators/s3_to_gcs_transfer_operator.py
 create mode 100644 tests/contrib/hooks/test_gcp_transfer_hook.py
 create mode 100644 tests/contrib/operators/test_s3_to_gcs_transfer_operator.py

diff --git a/airflow/contrib/hooks/gcp_transfer_hook.py b/airflow/contrib/hooks/gcp_transfer_hook.py
new file mode 100644
index 0000000000000..88534a51039b5
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_transfer_hook.py
@@ -0,0 +1,107 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+import time
+import datetime
+from googleapiclient.discovery import build
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+# Time to sleep between active checks of the operation results
+TIME_TO_SLEEP_IN_SECONDS = 1
+
+
+# noinspection PyAbstractClass
+class GCPTransferServiceHook(GoogleCloudBaseHook):
+    """
+    Hook for GCP Storage Transfer Service.
+    """
+    _conn = None
+
+    def __init__(self,
+                 api_version='v1',
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(GCPTransferServiceHook, self).__init__(gcp_conn_id, delegate_to)
+        self.api_version = api_version
+
+    def get_conn(self):
+        """
+        Retrieves connection to Google Storage Transfer service.
+
+        :return: Google Storage Transfer service object
+        :rtype: dict
+        """
+        if not self._conn:
+            http_authorized = self._authorize()
+            self._conn = build('storagetransfer', self.api_version,
+                               http=http_authorized, cache_discovery=False)
+        return self._conn
+
+    def create_transfer_job(self, project_id, transfer_spec, **kwargs):
+        conn = self.get_conn()
+        now = datetime.datetime.utcnow()
+        transfer_job = {
+            'status': 'ENABLED',
+            'projectId': project_id,
+            'transferSpec': transfer_spec,
+            'schedule': {
+                'scheduleStartDate': {
+                    'day': now.day,
+                    'month': now.month,
+                    'year': now.year,
+                },
+                'scheduleEndDate': {
+                    'day': now.day,
+                    'month': now.month,
+                    'year': now.year,
+                }
+            }
+        }
+        transfer_job.update(kwargs)
+        result = conn.transferJobs().create(body=transfer_job).execute()
+        self.wait_for_transfer_job(result, conn=conn)
+
+    def wait_for_transfer_job(self, job, conn=None):
+        conn = conn or self.get_conn()
+        while True:
+            result = conn.transferOperations().list(
+                name='transferOperations',
+                filter=json.dumps({
+                    'project_id': job['projectId'],
+                    'job_names': [job['name']],
+                }),
+            ).execute()
+            if self._check_operations_result(result):
+                return True
+            time.sleep(TIME_TO_SLEEP_IN_SECONDS)
+
+    def _check_operations_result(self, result):
+        operations = result.get('operations', [])
+        if len(operations) == 0:
+            return False
+        for operation in operations:
+            if operation['metadata']['status'] in {'FAILED', 'ABORTED'}:
+                raise AirflowException('Operation {} {}'.format(
+                    operation['name'], operation['metadata']['status']))
+            if operation['metadata']['status'] != 'SUCCESS':
+                return False
+        return True
diff --git a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
new file mode 100644
index 0000000000000..e2fbf95b733c9
--- /dev/null
+++ b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import BaseOperator
+from airflow.hooks.S3_hook import S3Hook
+from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
+from airflow.utils.decorators import apply_defaults
+
+
+class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
+    """
+    Synchronizes an S3 bucket with a Google Cloud Storage bucket using the
+    GCP Storage Transfer Service.
+
+    :param s3_bucket: The S3 bucket where to find the objects. (templated)
+    :type s3_bucket: str
+    :param gcs_bucket: The destination Google Cloud Storage bucket
+        where you want to store the files. (templated)
+    :type gcs_bucket: str
+    :param project_id: The ID of the Google Cloud Platform Console project that
+        owns the job
+    :type project_id: str
+    :param aws_conn_id: The source S3 connection
+    :type aws_conn_id: str
+    :param gcp_conn_id: The destination connection ID to use
+        when connecting to Google Cloud Storage.
+    :type gcp_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+    :param object_conditions: Transfer service object conditions; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
+    :type object_conditions: dict
+    :param transfer_options: Transfer service transfer options; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
+    :type transfer_options: dict
+    :param job_kwargs: Additional transfer job options; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs
+    :type job_kwargs: dict
+
+    **Example**:
+
+    .. code-block:: python
+
+       s3_to_gcs_transfer_op = S3ToGoogleCloudStorageTransferOperator(
+            task_id='s3_to_gcs_transfer_example',
+            s3_bucket='my-s3-bucket',
+            project_id='my-gcp-project',
+            gcs_bucket='my-gcs-bucket',
+            dag=my_dag)
+    """
+
+    template_fields = ('s3_bucket', 'gcs_bucket')
+    ui_color = '#e09411'
+
+    @apply_defaults
+    def __init__(self,
+                 s3_bucket,
+                 gcs_bucket,
+                 project_id,
+                 aws_conn_id='aws_default',
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None,
+                 object_conditions=None,
+                 transfer_options=None,
+                 job_kwargs=None,
+                 *args,
+                 **kwargs):
+
+        super(S3ToGoogleCloudStorageTransferOperator, self).__init__(
+            *args,
+            **kwargs)
+        self.s3_bucket = s3_bucket
+        self.gcs_bucket = gcs_bucket
+        self.project_id = project_id
+        self.aws_conn_id = aws_conn_id
+        self.gcp_conn_id = gcp_conn_id
+        self.delegate_to = delegate_to
+        self.object_conditions = object_conditions or {}
+        self.transfer_options = transfer_options or {}
+        self.job_kwargs = job_kwargs or {}
+
+    def execute(self, context):
+        transfer_hook = GCPTransferServiceHook(
+            gcp_conn_id=self.gcp_conn_id,
+            delegate_to=self.delegate_to)
+
+        s3_creds = S3Hook(aws_conn_id=self.aws_conn_id).get_credentials()
+
+        transfer_hook.create_transfer_job(
+            project_id=self.project_id,
+            transfer_spec={
+                'awsS3DataSource': {
+                    'bucketName': self.s3_bucket,
+                    'awsAccessKey': {
+                        'accessKeyId': s3_creds.access_key,
+                        'secretAccessKey': s3_creds.secret_key,
+                    }
+                },
+                'gcsDataSink': {
+                    'bucketName': self.gcs_bucket,
+                },
+                'objectConditions': self.object_conditions,
+                'transferOptions': self.transfer_options,
+            },
+            **self.job_kwargs
+        )
diff --git a/docs/code.rst b/docs/code.rst
index b8271ceb1662a..ed2e7d4754886 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -202,6 +202,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
@@ -427,6 +428,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
 .. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
+.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
 .. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
 .. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook
diff --git a/docs/integration.rst b/docs/integration.rst
index 0cfd1149d898c..ba5638769bbb6 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -238,6 +238,7 @@ AWS S3
 - :ref:`S3FileTransformOperator` : Copies data from a source S3 location to a temporary location on the local filesystem.
 - :ref:`S3ListOperator` : Lists the files matching a key prefix from a S3 location.
 - :ref:`S3ToGoogleCloudStorageOperator` : Syncs an S3 location with a Google Cloud Storage bucket.
+- :ref:`S3ToGoogleCloudStorageTransferOperator` : Syncs an S3 bucket with a Google Cloud Storage bucket using the GCP Storage Transfer Service.
 - :ref:`S3ToHiveTransfer` : Moves data from S3 to Hive. The operator downloads a file from S3, stores the file locally before loading it into a Hive table.
 
 .. _S3Hook:
@@ -268,6 +269,13 @@ S3ToGoogleCloudStorageOperator
 
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
 
+.. _S3ToGoogleCloudStorageTransferOperator:
+
+S3ToGoogleCloudStorageTransferOperator
+""""""""""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageTransferOperator
+
 .. _S3ToHiveTransfer:
 
 S3ToHiveTransfer
@@ -976,6 +984,12 @@ GoogleCloudStorageHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
     :members:
 
+GCPTransferServiceHook
+""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
+    :members:
+
 Google Kubernetes Engine
 ''''''''''''''''''''''''
 
diff --git a/tests/contrib/hooks/test_gcp_transfer_hook.py b/tests/contrib/hooks/test_gcp_transfer_hook.py
new file mode 100644
index 0000000000000..a61716653a98f
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_transfer_hook.py
@@ -0,0 +1,111 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import json
+import datetime
+import unittest
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
+from airflow.contrib.hooks.gcp_transfer_hook import TIME_TO_SLEEP_IN_SECONDS
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestGCPTransferServiceHook(unittest.TestCase):
+    def setUp(self):
+        with mock.patch.object(GCPTransferServiceHook, '__init__', return_value=None):
+            self.conn = mock.Mock()
+            self.transfer_hook = GCPTransferServiceHook()
+            self.transfer_hook._conn = self.conn
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.wait_for_transfer_job')
+    def test_create_transfer_job(self, mock_wait):
+        mock_create = self.conn.transferJobs.return_value.create
+        mock_execute = mock_create.return_value.execute
+        mock_execute.return_value = {
+            'projectId': 'test-project',
+            'name': 'transferJobs/test-job',
+        }
+        now = datetime.datetime.utcnow()
+        transfer_spec = {
+            'awsS3DataSource': {'bucketName': 'test-s3-bucket'},
+            'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
+        }
+        self.transfer_hook.create_transfer_job('test-project', transfer_spec)
+        mock_create.assert_called_once_with(body={
+            'status': 'ENABLED',
+            'projectId': 'test-project',
+            'transferSpec': transfer_spec,
+            'schedule': {
+                'scheduleStartDate': {
+                    'day': now.day,
+                    'month': now.month,
+                    'year': now.year,
+                },
+                'scheduleEndDate': {
+                    'day': now.day,
+                    'month': now.month,
+                    'year': now.year,
+                }
+            }
+        })
+        mock_wait.assert_called_once_with(mock_execute.return_value, conn=self.conn)
+
+    @mock.patch('time.sleep')
+    def test_wait_for_transfer_job(self, mock_sleep):
+        mock_list = self.conn.transferOperations.return_value.list
+        mock_execute = mock_list.return_value.execute
+        mock_execute.side_effect = [
+            {'operations': [{'metadata': {'status': 'IN_PROGRESS'}}]},
+            {'operations': [{'metadata': {'status': 'SUCCESS'}}]},
+        ]
+        self.transfer_hook.wait_for_transfer_job({
+            'projectId': 'test-project',
+            'name': 'transferJobs/test-job',
+        })
+        self.assertTrue(mock_list.called)
+        list_args, list_kwargs = mock_list.call_args_list[0]
+        self.assertEqual(list_kwargs.get('name'), 'transferOperations')
+        self.assertEqual(
+            json.loads(list_kwargs.get('filter')),
+            {
+                'project_id': 'test-project',
+                'job_names': ['transferJobs/test-job']
+            },
+        )
+        mock_sleep.assert_called_once_with(TIME_TO_SLEEP_IN_SECONDS)
+
+    def test_wait_for_transfer_job_failed(self):
+        mock_list = self.conn.transferOperations.return_value.list
+        mock_execute = mock_list.return_value.execute
+        mock_execute.side_effect = [
+            {'operations': [{'name': 'test-job', 'metadata': {'status': 'FAILED'}}]},
+        ]
+        with self.assertRaises(AirflowException):
+            self.transfer_hook.wait_for_transfer_job({
+                'projectId': 'test-project',
+                'name': 'transferJobs/test-job',
+            })
diff --git a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
new file mode 100644
index 0000000000000..cc7bfd7a95834
--- /dev/null
+++ b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
@@ -0,0 +1,98 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+import collections
+
+from airflow.contrib.operators.s3_to_gcs_transfer_operator import \
+    S3ToGoogleCloudStorageTransferOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+TASK_ID = 'test-s3-gcs-transfer-operator'
+S3_BUCKET = 'test-s3-bucket'
+GCS_BUCKET = 'test-gcs-bucket'
+PROJECT_ID = 'test-project'
+ACCESS_KEY = 'test-access-key'
+SECRET_KEY = 'test-secret-key'
+
+
+Credentials = collections.namedtuple(
+    'Credentials', ['access_key', 'secret_key'])
+
+
+class S3ToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
+    def test_constructor(self):
+        """Test S3ToGoogleCloudStorageTransferOperator instance is properly initialized."""
+
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=S3_BUCKET,
+            gcs_bucket=GCS_BUCKET,
+            project_id=PROJECT_ID,
+        )
+
+        self.assertEqual(operator.task_id, TASK_ID)
+        self.assertEqual(operator.s3_bucket, S3_BUCKET)
+        self.assertEqual(operator.gcs_bucket, GCS_BUCKET)
+        self.assertEqual(operator.project_id, PROJECT_ID)
+
+    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')
+    def test_execute(self, mock_s3_hook, mock_transfer_hook):
+        """Test the execute function when the run is successful."""
+
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=S3_BUCKET,
+            gcs_bucket=GCS_BUCKET,
+            project_id=PROJECT_ID,
+        )
+
+        mock_s3_hook.return_value.get_credentials.return_value = Credentials(
+            access_key=ACCESS_KEY,
+            secret_key=SECRET_KEY,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            project_id=PROJECT_ID,
+            transfer_spec={
+                'awsS3DataSource': {
+                    'bucketName': S3_BUCKET,
+                    'awsAccessKey': {
+                        'accessKeyId': ACCESS_KEY,
+                        'secretAccessKey': SECRET_KEY,
+                    }
+                },
+                'gcsDataSink': {
+                    'bucketName': GCS_BUCKET,
+                },
+                'objectConditions': {},
+                'transferOptions': {}
+            }
+        )

From 5bb74a704d27b65894aed727a5d263e287b589df Mon Sep 17 00:00:00 2001
From: phanindhra <phani8996@gmail.com>
Date: Fri, 16 Nov 2018 18:38:37 +0530
Subject: [PATCH 247/808] [AIRFLOW-3266] Add AWS Athena Hook and Operator
 (#4111)

Provides AWS Athena hook and operator to submit Athena(presto) queries on AWS.

Authored-by: Phanindhra <phani8996@gmail.com>
---
 airflow/contrib/hooks/aws_athena_hook.py      | 150 ++++++++++++++++++
 .../contrib/operators/aws_athena_operator.py  |  98 ++++++++++++
 docs/code.rst                                 |   2 +
 .../operators/test_aws_athena_operator.py     | 107 +++++++++++++
 4 files changed, 357 insertions(+)
 create mode 100644 airflow/contrib/hooks/aws_athena_hook.py
 create mode 100644 airflow/contrib/operators/aws_athena_operator.py
 create mode 100644 tests/contrib/operators/test_aws_athena_operator.py

diff --git a/airflow/contrib/hooks/aws_athena_hook.py b/airflow/contrib/hooks/aws_athena_hook.py
new file mode 100644
index 0000000000000..f11ff23c515f4
--- /dev/null
+++ b/airflow/contrib/hooks/aws_athena_hook.py
@@ -0,0 +1,150 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from time import sleep
+from airflow.contrib.hooks.aws_hook import AwsHook
+
+
+class AWSAthenaHook(AwsHook):
+    """
+    Interact with AWS Athena to run, poll queries and return query results
+
+    :param aws_conn_id: aws connection to use.
+    :type aws_conn_id: str
+    :param sleep_time: Time to wait between two consecutive call to check query status on athena
+    :type sleep_time: int
+    """
+
+    INTERMEDIATE_STATES = ('QUEUED', 'RUNNING',)
+    FAILURE_STATES = ('FAILED', 'CANCELLED',)
+    SUCCESS_STATES = ('SUCCEEDED',)
+
+    def __init__(self, aws_conn_id='aws_default', sleep_time=30, *args, **kwargs):
+        super(AWSAthenaHook, self).__init__(aws_conn_id, **kwargs)
+        self.sleep_time = sleep_time
+        self.conn = None
+
+    def get_conn(self):
+        """
+        check if aws conn exists already or create one and return it
+
+        :return: boto3 session
+        """
+        if not self.conn:
+            self.conn = self.get_client_type('athena')
+        return self.conn
+
+    def run_query(self, query, query_context, result_configuration, client_request_token=None):
+        """
+        Run Presto query on athena with provided config and return submitted query_execution_id
+
+        :param query: Presto query to run
+        :type query: str
+        :param query_context: Context in which query need to be run
+        :type query_context: dict
+        :param result_configuration: Dict with path to store results in and config related to encryption
+        :type result_configuration: dict
+        :param client_request_token: Unique token created by user to avoid multiple executions of same query
+        :type client_request_token: str
+        :return: str
+        """
+        response = self.conn.start_query_execution(QueryString=query,
+                                                   ClientRequestToken=client_request_token,
+                                                   QueryExecutionContext=query_context,
+                                                   ResultConfiguration=result_configuration)
+        query_execution_id = response['QueryExecutionId']
+        return query_execution_id
+
+    def check_query_status(self, query_execution_id):
+        """
+        Fetch the status of submitted athena query. Returns None or one of valid query states.
+
+        :param query_execution_id: Id of submitted athena query
+        :type query_execution_id: str
+        :return: str
+        """
+        response = self.conn.get_query_execution(QueryExecutionId=query_execution_id)
+        state = None
+        try:
+            state = response['QueryExecution']['Status']['State']
+        except Exception as ex:
+            self.log.error('Exception while getting query state', ex)
+        finally:
+            return state
+
+    def get_query_results(self, query_execution_id):
+        """
+        Fetch submitted athena query results. returns none if query is in intermediate state or
+        failed/cancelled state else dict of query output
+
+        :param query_execution_id: Id of submitted athena query
+        :type query_execution_id: str
+        :return: dict
+        """
+        query_state = self.check_query_status(query_execution_id)
+        if query_state is None:
+            self.log.error('Invalid Query state')
+            return None
+        elif query_state in self.INTERMEDIATE_STATES or query_state in self.FAILURE_STATES:
+            self.log.error('Query is in {state} state. Cannot fetch results'.format(state=query_state))
+            return None
+        return self.conn.get_query_results(QueryExecutionId=query_execution_id)
+
+    def poll_query_status(self, query_execution_id, max_tries=None):
+        """
+        Poll the status of submitted athena query until query state reaches final state.
+        Returns one of the final states
+
+        :param query_execution_id: Id of submitted athena query
+        :type query_execution_id: str
+        :param max_tries: Number of times to poll for query state before function exits
+        :type max_tries: int
+        :return: str
+        """
+        try_number = 1
+        final_query_state = None  # Query state when query reaches final state or max_tries reached
+        while True:
+            query_state = self.check_query_status(query_execution_id)
+            if query_state is None:
+                self.log.info('Trial {try_number}: Invalid query state. Retrying again'.format(
+                    try_number=try_number))
+            elif query_state in self.INTERMEDIATE_STATES:
+                self.log.info('Trial {try_number}: Query is still in an intermediate state - {state}'
+                              .format(try_number=try_number, state=query_state))
+            else:
+                self.log.info('Trial {try_number}: Query execution completed. Final state is {state}'
+                              .format(try_number=try_number, state=query_state))
+                final_query_state = query_state
+                break
+            if max_tries and try_number >= max_tries:  # Break loop if max_tries reached
+                final_query_state = query_state
+                break
+            try_number += 1
+            sleep(self.sleep_time)
+        return final_query_state
+
+    def stop_query(self, query_execution_id):
+        """
+        Cancel the submitted athena query
+
+        :param query_execution_id: Id of submitted athena query
+        :type query_execution_id: str
+        :return: dict
+        """
+        return self.conn.stop_query_execution(QueryExecutionId=query_execution_id)
diff --git a/airflow/contrib/operators/aws_athena_operator.py b/airflow/contrib/operators/aws_athena_operator.py
new file mode 100644
index 0000000000000..432410e31100a
--- /dev/null
+++ b/airflow/contrib/operators/aws_athena_operator.py
@@ -0,0 +1,98 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from uuid import uuid4
+
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
+
+
+class AWSAthenaOperator(BaseOperator):
+    """
+    An operator that submit presto query to athena.
+
+    :param query: Presto to be run on athena. (templated)
+    :type query: str
+    :param database: Database to select. (templated)
+    :type database: str
+    :param output_location: s3 path to write the query results into. (templated)
+    :type output_location: str
+    :param aws_conn_id: aws connection to use
+    :type aws_conn_id: str
+    :param sleep_time: Time to wait between two consecutive call to check query status on athena
+    :type sleep_time: int
+    """
+
+    ui_color = '#44b5e2'
+    template_fields = ('query', 'database', 'output_location')
+
+    @apply_defaults
+    def __init__(self, query, database, output_location, aws_conn_id='aws_default', client_request_token=None,
+                 query_execution_context=None, result_configuration=None, sleep_time=30, *args, **kwargs):
+        super(AWSAthenaOperator, self).__init__(*args, **kwargs)
+        self.query = query
+        self.database = database
+        self.output_location = output_location
+        self.aws_conn_id = aws_conn_id
+        self.client_request_token = client_request_token or str(uuid4())
+        self.query_execution_context = query_execution_context or {}
+        self.result_configuration = result_configuration or {}
+        self.sleep_time = sleep_time
+        self.query_execution_id = None
+        self.hook = None
+
+    def get_hook(self):
+        return AWSAthenaHook(self.aws_conn_id, self.sleep_time)
+
+    def execute(self, context):
+        """
+        Run Presto Query on Athena
+        """
+        self.hook = self.get_hook()
+        self.hook.get_conn()
+
+        self.query_execution_context['Database'] = self.database
+        self.result_configuration['OutputLocation'] = self.output_location
+        self.query_execution_id = self.hook.run_query(self.query, self.query_execution_context,
+                                                      self.result_configuration, self.client_request_token)
+        self.hook.poll_query_status(self.query_execution_id)
+
+    def on_kill(self):
+        """
+        Cancel the submitted athena query
+        """
+        if self.query_execution_id:
+            self.log.info('⚰️⚰️⚰️ Received a kill Signal. Time to Die')
+            self.log.info('Stopping Query with executionId - {queryId}'.format(
+                queryId=self.query_execution_id))
+            response = self.hook.stop_query(self.query_execution_id)
+            http_status_code = None
+            try:
+                http_status_code = response['ResponseMetadata']['HTTPStatusCode']
+            except Exception as ex:
+                self.log.error('Exception while cancelling query', ex)
+            finally:
+                if http_status_code is None or http_status_code != 200:
+                    self.log.error('Unable to request query cancel on athena. Exiting')
+                else:
+                    self.log.info('Polling Athena for query with id {queryId} to reach final state'.format(
+                        queryId=self.query_execution_id))
+                    self.hook.poll_query_status(self.query_execution_id)
diff --git a/docs/code.rst b/docs/code.rst
index ed2e7d4754886..57aadee677bb3 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -130,6 +130,7 @@ Operators
 .. Alphabetize this list
 
 .. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
+.. autoclass:: airflow.contrib.operators.aws_athena_operator.AWSAthenaOperator
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
@@ -403,6 +404,7 @@ interface when possible and acting as building blocks for operators.
 Community contributed hooks
 '''''''''''''''''''''''''''
 .. Alphabetize this list
+.. autoclass:: airflow.contrib.hooks.aws_athena_hook.AWSAthenaHook
 .. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
 .. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
diff --git a/tests/contrib/operators/test_aws_athena_operator.py b/tests/contrib/operators/test_aws_athena_operator.py
new file mode 100644
index 0000000000000..ecfb0d2890100
--- /dev/null
+++ b/tests/contrib/operators/test_aws_athena_operator.py
@@ -0,0 +1,107 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# 'License'); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import unittest
+
+from airflow.contrib.operators.aws_athena_operator import AWSAthenaOperator
+from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
+from airflow import configuration
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+MOCK_DATA = {
+    'task_id': 'test_aws_athena_operator',
+    'query': 'SELECT * FROM TEST_TABLE',
+    'database': 'TEST_DATABASE',
+    'outputLocation': 's3://test_s3_bucket/',
+    'client_request_token': 'eac427d0-1c6d-4dfb-96aa-2835d3ac6595'
+}
+
+query_context = {
+    'Database': MOCK_DATA['database']
+}
+result_configuration = {
+    'OutputLocation': MOCK_DATA['outputLocation']
+}
+
+
+class TestAWSAthenaOperator(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+
+        self.athena = AWSAthenaOperator(task_id='test_aws_athena_operator', query='SELECT * FROM TEST_TABLE',
+                                        database='TEST_DATABASE', output_location='s3://test_s3_bucket/',
+                                        client_request_token='eac427d0-1c6d-4dfb-96aa-2835d3ac6595',
+                                        sleep_time=1)
+
+    def test_init(self):
+        self.assertEqual(self.athena.task_id, MOCK_DATA['task_id'])
+        self.assertEqual(self.athena.query, MOCK_DATA['query'])
+        self.assertEqual(self.athena.database, MOCK_DATA['database'])
+        self.assertEqual(self.athena.aws_conn_id, 'aws_default')
+        self.assertEqual(self.athena.client_request_token, MOCK_DATA['client_request_token'])
+        self.assertEqual(self.athena.sleep_time, 1)
+
+    @mock.patch.object(AWSAthenaHook, 'check_query_status', side_effect=("SUCCESS",))
+    @mock.patch.object(AWSAthenaHook, 'run_query', return_value='1234')
+    @mock.patch.object(AWSAthenaHook, 'get_conn')
+    def test_hook_run_small_success_query(self, mock_conn, mock_run_query, mock_check_query_status):
+        self.athena.execute(None)
+        mock_run_query.assert_called_once_with(MOCK_DATA['query'], query_context, result_configuration,
+                                               MOCK_DATA['client_request_token'])
+        self.assertEqual(mock_check_query_status.call_count, 1)
+
+    @mock.patch.object(AWSAthenaHook, 'check_query_status', side_effect=("RUNNING", "RUNNING", "SUCCESS",))
+    @mock.patch.object(AWSAthenaHook, 'run_query', return_value='1234')
+    @mock.patch.object(AWSAthenaHook, 'get_conn')
+    def test_hook_run_big_success_query(self, mock_conn, mock_run_query, mock_check_query_status):
+        self.athena.execute(None)
+        mock_run_query.assert_called_once_with(MOCK_DATA['query'], query_context, result_configuration,
+                                               MOCK_DATA['client_request_token'])
+        self.assertEqual(mock_check_query_status.call_count, 3)
+
+    @mock.patch.object(AWSAthenaHook, 'check_query_status', side_effect=("RUNNING", "FAILED",))
+    @mock.patch.object(AWSAthenaHook, 'run_query', return_value='1234')
+    @mock.patch.object(AWSAthenaHook, 'get_conn')
+    def test_hook_run_failure_query(self, mock_conn, mock_run_query, mock_check_query_status):
+        self.athena.execute(None)
+        mock_run_query.assert_called_once_with(MOCK_DATA['query'], query_context, result_configuration,
+                                               MOCK_DATA['client_request_token'])
+        self.assertEqual(mock_check_query_status.call_count, 2)
+
+    @mock.patch.object(AWSAthenaHook, 'check_query_status', side_effect=("RUNNING", "RUNNING", "CANCELLED",))
+    @mock.patch.object(AWSAthenaHook, 'run_query', return_value='1234')
+    @mock.patch.object(AWSAthenaHook, 'get_conn')
+    def test_hook_run_cancelled_query(self, mock_conn, mock_run_query, mock_check_query_status):
+        self.athena.execute(None)
+        mock_run_query.assert_called_once_with(MOCK_DATA['query'], query_context, result_configuration,
+                                               MOCK_DATA['client_request_token'])
+        self.assertEqual(mock_check_query_status.call_count, 3)
+
+
+if __name__ == '__main__':
+    unittest.main()

From e30825da8436b033d94c8a99d5598f2327ab0043 Mon Sep 17 00:00:00 2001
From: Brandon Kvarda <bjkvarda@gmail.com>
Date: Wed, 21 Nov 2018 15:18:40 -0800
Subject: [PATCH 248/808] [AIRFLOW-3213] Create ADLS to GCS operator (#4134)

---
 airflow/contrib/operators/adls_to_gcs.py      | 146 ++++++++++++++++++
 docs/code.rst                                 |   1 +
 docs/integration.rst                          |   8 +
 .../operators/test_adls_to_gcs_operator.py    | 102 ++++++++++++
 4 files changed, 257 insertions(+)
 create mode 100644 airflow/contrib/operators/adls_to_gcs.py
 create mode 100644 tests/contrib/operators/test_adls_to_gcs_operator.py

diff --git a/airflow/contrib/operators/adls_to_gcs.py b/airflow/contrib/operators/adls_to_gcs.py
new file mode 100644
index 0000000000000..affbd456260ff
--- /dev/null
+++ b/airflow/contrib/operators/adls_to_gcs.py
@@ -0,0 +1,146 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import os
+from tempfile import NamedTemporaryFile
+
+from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
+from airflow.contrib.operators.adls_list_operator import AzureDataLakeStorageListOperator
+from airflow.contrib.hooks.gcs_hook import GoogleCloudStorageHook, _parse_gcs_url
+from airflow.utils.decorators import apply_defaults
+
+
+class AdlsToGoogleCloudStorageOperator(AzureDataLakeStorageListOperator):
+    """
+    Synchronizes an Azure Data Lake Storage path with a GCS bucket
+
+    :param src_adls: The Azure Data Lake path to find the objects (templated)
+    :type src_adls: str
+    :param dest_gcs: The Google Cloud Storage bucket and prefix to
+        store the objects. (templated)
+    :type dest_gcs: str
+    :param replace: If true, replaces same-named files in GCS
+    :type replace: bool
+    :param azure_data_lake_conn_id: The connection ID to use when
+        connecting to Azure Data Lake Storage.
+    :type azure_data_lake_conn_id: str
+    :param google_cloud_storage_conn_id: The connection ID to use when
+        connecting to Google Cloud Storage.
+    :type google_cloud_storage_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+
+    **Examples**:
+        The following Operator would copy a single file named
+        ``hello/world.avro`` from ADLS to the GCS bucket ``mybucket``. Its full
+        resulting gcs path will be ``gs://mybucket/hello/world.avro`` ::
+            copy_single_file = AdlsToGoogleCloudStorageOperator(
+                task_id='copy_single_file',
+                src_adls='hello/world.avro',
+                dest_gcs='gs://mybucket',
+                replace=False,
+                azure_data_lake_conn_id='azure_data_lake_default',
+                google_cloud_storage_conn_id='google_cloud_default'
+            )
+
+        The following Operator would copy all parquet files from ADLS
+        to the GCS bucket ``mybucket``. ::
+            copy_all_files = AdlsToGoogleCloudStorageOperator(
+                task_id='copy_all_files',
+                src_adls='*.parquet',
+                dest_gcs='gs://mybucket',
+                replace=False,
+                azure_data_lake_conn_id='azure_data_lake_default',
+                google_cloud_storage_conn_id='google_cloud_default'
+            )
+
+         The following Operator would copy all parquet files from ADLS
+         path ``/hello/world``to the GCS bucket ``mybucket``. ::
+            copy_world_files = AdlsToGoogleCloudStorageOperator(
+                task_id='copy_world_files',
+                src_adls='hello/world/*.parquet',
+                dest_gcs='gs://mybucket',
+                replace=False,
+                azure_data_lake_conn_id='azure_data_lake_default',
+                google_cloud_storage_conn_id='google_cloud_default'
+            )
+    """
+    template_fields = ('src_adls', 'dest_gcs')
+    ui_color = '#f0eee4'
+
+    @apply_defaults
+    def __init__(self,
+                 src_adls,
+                 dest_gcs,
+                 azure_data_lake_conn_id,
+                 google_cloud_storage_conn_id,
+                 delegate_to=None,
+                 replace=False,
+                 *args,
+                 **kwargs):
+
+        super(AdlsToGoogleCloudStorageOperator, self).__init__(
+            path=src_adls,
+            azure_data_lake_conn_id=azure_data_lake_conn_id,
+            *args,
+            **kwargs
+        )
+        self.src_adls = src_adls
+        self.dest_gcs = dest_gcs
+        self.replace = replace
+        self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
+        self.delegate_to = delegate_to
+
+    def execute(self, context):
+        # use the super to list all files in an Azure Data Lake path
+        files = super(AdlsToGoogleCloudStorageOperator, self).execute(context)
+        g_hook = GoogleCloudStorageHook(
+            google_cloud_storage_conn_id=self.google_cloud_storage_conn_id,
+            delegate_to=self.delegate_to)
+
+        if not self.replace:
+            # if we are not replacing -> list all files in the ADLS path
+            # and only keep those files which are present in
+            # ADLS and not in Google Cloud Storage
+            bucket_name, prefix = _parse_gcs_url(self.dest_gcs)
+            existing_files = g_hook.list(bucket=bucket_name, prefix=prefix)
+            files = set(files) - set(existing_files)
+
+        if files:
+            hook = AzureDataLakeHook(
+                azure_data_lake_conn_id=self.azure_data_lake_conn_id
+            )
+
+            for obj in files:
+                with NamedTemporaryFile(mode='wb', delete=True) as f:
+                    hook.download_file(local_path=f.name, remote_path=obj)
+                    f.flush()
+                    dest_gcs_bucket, dest_gcs_prefix = _parse_gcs_url(self.dest_gcs)
+                    dest_path = os.path.join(dest_gcs_prefix, obj)
+                    self.log.info("Saving file to %s", dest_path)
+
+                    g_hook.upload(bucket=dest_gcs_bucket, object=dest_path, filename=f.name)
+
+            self.log.info("All done, uploaded %d files to GCS", len(files))
+        else:
+            self.log.info("In sync, no files needed to be uploaded to GCS")
+
+        return files
diff --git a/docs/code.rst b/docs/code.rst
index 57aadee677bb3..6619c43a25e63 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -130,6 +130,7 @@ Operators
 .. Alphabetize this list
 
 .. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
+.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.aws_athena_operator.AWSAthenaOperator
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index ba5638769bbb6..4f67b3e520c8a 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -171,6 +171,7 @@ login (=Client ID), password (=Client Secret) and extra fields tenant (Tenant) a
 
 - :ref:`AzureDataLakeHook`: Interface with Azure Data Lake.
 - :ref:`AzureDataLakeStorageListOperator`: Lists the files located in a specified Azure Data Lake path.
+- :ref:`AdlsToGoogleCloudStorageOperator`: Copies files from an Azure Data Lake path to a Google Cloud Storage bucket.
 
 .. _AzureDataLakeHook:
 
@@ -186,6 +187,13 @@ AzureDataLakeStorageListOperator
 
 .. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
 
+.. _AdlsToGoogleCloudStorageOperator:
+
+AdlsToGoogleCloudStorageOperator
+""""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
+
 .. _AWS:
 
 AWS: Amazon Web Services
diff --git a/tests/contrib/operators/test_adls_to_gcs_operator.py b/tests/contrib/operators/test_adls_to_gcs_operator.py
new file mode 100644
index 0000000000000..0277f55d55771
--- /dev/null
+++ b/tests/contrib/operators/test_adls_to_gcs_operator.py
@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.hooks.gcs_hook import _parse_gcs_url
+from airflow.contrib.operators.adls_to_gcs import \
+    AdlsToGoogleCloudStorageOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+TASK_ID = 'test-adls-gcs-operator'
+ADLS_PATH_1 = '*'
+GCS_PATH = 'gs://test/'
+MOCK_FILES = ["test/TEST1.csv", "test/TEST2.csv", "test/path/TEST3.csv",
+              "test/path/PARQUET.parquet", "test/path/PIC.png"]
+AZURE_CONN_ID = 'azure_data_lake_default'
+GCS_CONN_ID = 'google_cloud_default'
+
+
+class AdlsToGoogleCloudStorageOperatorTest(unittest.TestCase):
+    def test_init(self):
+        """Test AdlsToGoogleCloudStorageOperator instance is properly initialized."""
+
+        operator = AdlsToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            src_adls=ADLS_PATH_1,
+            dest_gcs=GCS_PATH,
+            replace=False,
+            azure_data_lake_conn_id=AZURE_CONN_ID,
+            google_cloud_storage_conn_id=GCS_CONN_ID
+        )
+
+        self.assertEqual(operator.task_id, TASK_ID)
+        self.assertEqual(operator.src_adls, ADLS_PATH_1)
+        self.assertEqual(operator.dest_gcs, GCS_PATH)
+        self.assertEqual(operator.replace, False)
+        self.assertEqual(operator.google_cloud_storage_conn_id, GCS_CONN_ID)
+        self.assertEqual(operator.azure_data_lake_conn_id, AZURE_CONN_ID)
+
+    @mock.patch('airflow.contrib.operators.adls_to_gcs.AzureDataLakeHook')
+    @mock.patch('airflow.contrib.operators.adls_list_operator.AzureDataLakeHook')
+    @mock.patch(
+        'airflow.contrib.operators.adls_to_gcs.GoogleCloudStorageHook')
+    def test_execute(self, gcs_mock_hook, adls_one_mock_hook, adls_two_mock_hook):
+        """Test the execute function when the run is successful."""
+
+        operator = AdlsToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            src_adls=ADLS_PATH_1,
+            dest_gcs=GCS_PATH,
+            replace=False,
+            azure_data_lake_conn_id=AZURE_CONN_ID,
+            google_cloud_storage_conn_id=GCS_CONN_ID
+        )
+
+        adls_one_mock_hook.return_value.list.return_value = MOCK_FILES
+        adls_two_mock_hook.return_value.list.return_value = MOCK_FILES
+
+        def _assert_upload(bucket, object, filename):
+            gcs_bucket, gcs_object_path = _parse_gcs_url(GCS_PATH)
+
+            self.assertEqual(gcs_bucket, 'test')
+            self.assertIn(object[len(gcs_object_path):], MOCK_FILES)
+
+        gcs_mock_hook.return_value.upload.side_effect = _assert_upload
+
+        uploaded_files = operator.execute(None)
+
+        adls_one_mock_hook.assert_called_once_with(azure_data_lake_conn_id=AZURE_CONN_ID)
+        adls_two_mock_hook.assert_called_once_with(azure_data_lake_conn_id=AZURE_CONN_ID)
+        gcs_mock_hook.assert_called_once_with(
+            google_cloud_storage_conn_id=GCS_CONN_ID, delegate_to=None)
+
+        # we expect MOCK_FILES to be uploaded
+        self.assertEqual(sorted(MOCK_FILES), sorted(uploaded_files))
+
+
+if __name__ == '__main__':
+    unittest.main()

From 23f41fff0cb9af7996a1ba3b80709fac5d2f517a Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Thu, 15 Nov 2018 21:27:37 +0100
Subject: [PATCH 249/808] [AIRFLOW-3345] Add Google Cloud Storage (GCS)
 operators for ACL (#4192)

Add 2 operators for adding ACL entries to GCS buckets and objects:
- GoogleCloudStorageBucketCreateAclEntryOperator
- GoogleCloudStorageObjectCreateAclEntryOperator
---
 .../contrib/example_dags/example_gcs_acl.py   |  76 ++++++++++
 airflow/contrib/hooks/gcs_hook.py             |  98 +++++++++++++
 airflow/contrib/operators/gcs_acl_operator.py | 138 ++++++++++++++++++
 docs/howto/operator.rst                       |  89 +++++++++++
 docs/integration.rst                          |  18 ++-
 tests/contrib/operators/test_gcp_base.py      |   1 +
 .../operators/test_gcs_acl_operator.py        |  87 +++++++++++
 7 files changed, 506 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/example_dags/example_gcs_acl.py
 create mode 100644 airflow/contrib/operators/gcs_acl_operator.py
 create mode 100644 tests/contrib/operators/test_gcs_acl_operator.py

diff --git a/airflow/contrib/example_dags/example_gcs_acl.py b/airflow/contrib/example_dags/example_gcs_acl.py
new file mode 100644
index 0000000000000..7247199a4f656
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcs_acl.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that creates a new ACL entry on the specified bucket and object.
+
+This DAG relies on the following OS environment variables
+
+* GCS_ACL_BUCKET - Name of a bucket.
+* GCS_ACL_OBJECT - Name of the object. For information about how to URL encode object
+    names to be path safe, see:
+    https://cloud.google.com/storage/docs/json_api/#encoding
+* GCS_ACL_ENTITY - The entity holding the permission.
+* GCS_ACL_BUCKET_ROLE - The access permission for the entity for the bucket.
+* GCS_ACL_OBJECT_ROLE - The access permission for the entity for the object.
+"""
+import os
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcs_acl_operator import \
+    GoogleCloudStorageBucketCreateAclEntryOperator, \
+    GoogleCloudStorageObjectCreateAclEntryOperator
+
+# [START howto_operator_gcs_acl_args_common]
+GCS_ACL_BUCKET = os.environ.get('GCS_ACL_BUCKET', 'example-bucket')
+GCS_ACL_OBJECT = os.environ.get('GCS_ACL_OBJECT', 'example-object')
+GCS_ACL_ENTITY = os.environ.get('GCS_ACL_ENTITY', 'example-entity')
+GCS_ACL_BUCKET_ROLE = os.environ.get('GCS_ACL_BUCKET_ROLE', 'example-bucket-role')
+GCS_ACL_OBJECT_ROLE = os.environ.get('GCS_ACL_OBJECT_ROLE', 'example-object-role')
+# [END howto_operator_gcs_acl_args_common]
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+
+with models.DAG(
+    'example_gcs_acl',
+    default_args=default_args,
+    schedule_interval=None  # Change to match your use case
+) as dag:
+    # [START howto_operator_gcs_bucket_create_acl_entry_task]
+    gcs_bucket_create_acl_entry_task = GoogleCloudStorageBucketCreateAclEntryOperator(
+        bucket=GCS_ACL_BUCKET,
+        entity=GCS_ACL_ENTITY,
+        role=GCS_ACL_BUCKET_ROLE,
+        task_id="gcs_bucket_create_acl_entry_task"
+    )
+    # [END howto_operator_gcs_bucket_create_acl_entry_task]
+    # [START howto_operator_gcs_object_create_acl_entry_task]
+    gcs_object_create_acl_entry_task = GoogleCloudStorageObjectCreateAclEntryOperator(
+        bucket=GCS_ACL_BUCKET,
+        object_name=GCS_ACL_OBJECT,
+        entity=GCS_ACL_ENTITY,
+        role=GCS_ACL_OBJECT_ROLE,
+        task_id="gcs_object_create_acl_entry_task"
+    )
+    # [END howto_operator_gcs_object_create_acl_entry_task]
+
+    gcs_bucket_create_acl_entry_task >> gcs_object_create_acl_entry_task
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 7b5b7194c004d..391336faf28fe 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -535,6 +535,104 @@ def create_bucket(self,
                 'Bucket creation failed. Error was: {}'.format(ex.content)
             )
 
+    def insert_bucket_acl(self, bucket, entity, role, user_project):
+        # type: (str, str, str, str) -> None
+        """
+        Creates a new ACL entry on the specified bucket.
+        See: https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert
+
+        :param bucket: Name of a bucket.
+        :type bucket: str
+        :param entity: The entity holding the permission, in one of the following forms:
+        - user-userId
+        - user-email
+        - group-groupId
+        - group-email
+        - domain-domain
+        - project-team-projectId
+        - allUsers
+        - allAuthenticatedUsers
+        :type entity: str
+        :param role: The access permission for the entity.
+            Acceptable values are: "OWNER", "READER", "WRITER".
+        :type role: str
+        :param user_project: (Optional) The project to be billed for this request.
+            Required for Requester Pays buckets.
+        :type user_project: str
+        """
+        self.log.info('Creating a new ACL entry in bucket: %s', bucket)
+        service = self.get_conn()
+        try:
+            response = service.bucketAccessControls().insert(
+                bucket=bucket,
+                body={
+                    "entity": entity,
+                    "role": role
+                },
+                userProject=user_project
+            ).execute()
+            if response:
+                self.log.info('A new ACL entry created in bucket: %s', bucket)
+        except errors.HttpError as ex:
+            raise AirflowException(
+                'Bucket ACL entry creation failed. Error was: {}'.format(ex.content)
+            )
+
+    def insert_object_acl(self, bucket, object_name, entity, role, generation,
+                          user_project):
+        # type: (str, str, str, str, str, str) -> None
+        """
+        Creates a new ACL entry on the specified object.
+        See: https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert
+
+        :param bucket: Name of a bucket.
+        :type bucket: str
+        :param object_name: Name of the object. For information about how to URL encode
+            object names to be path safe, see:
+            https://cloud.google.com/storage/docs/json_api/#encoding
+        :type object_name: str
+        :param entity: The entity holding the permission, in one of the following forms:
+            - user-userId
+            - user-email
+            - group-groupId
+            - group-email
+            - domain-domain
+            - project-team-projectId
+            - allUsers
+            - allAuthenticatedUsers
+        :type entity: str
+        :param role: The access permission for the entity.
+            Acceptable values are: "OWNER", "READER".
+        :type role: str
+        :param generation: (Optional) If present, selects a specific revision of this
+            object (as opposed to the latest version, the default).
+        :type generation: str
+        :param user_project: (Optional) The project to be billed for this request.
+            Required for Requester Pays buckets.
+        :type user_project: str
+        """
+        self.log.info('Creating a new ACL entry for object: %s in bucket: %s',
+                      object_name, bucket)
+        service = self.get_conn()
+        try:
+            response = service.objectAccessControls().insert(
+                bucket=bucket,
+                object=object_name,
+                body={
+                    "entity": entity,
+                    "role": role
+                },
+                generation=generation,
+                userProject=user_project
+            ).execute()
+            if response:
+                self.log.info('A new ACL entry created for object: %s in bucket: %s',
+                              object_name, bucket)
+        except errors.HttpError as ex:
+            raise AirflowException(
+                'Object ACL entry creation failed. Error was: {}'.format(ex.content)
+            )
+
 
 def _parse_gcs_url(gsurl):
     """
diff --git a/airflow/contrib/operators/gcs_acl_operator.py b/airflow/contrib/operators/gcs_acl_operator.py
new file mode 100644
index 0000000000000..d91844413199b
--- /dev/null
+++ b/airflow/contrib/operators/gcs_acl_operator.py
@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.gcs_hook import GoogleCloudStorageHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class GoogleCloudStorageBucketCreateAclEntryOperator(BaseOperator):
+    """
+    Creates a new ACL entry on the specified bucket.
+
+    :param bucket: Name of a bucket.
+    :type bucket: str
+    :param entity: The entity holding the permission, in one of the following forms:
+        - user-userId
+        - user-email
+        - group-groupId
+        - group-email
+        - domain-domain
+        - project-team-projectId
+        - allUsers
+        - allAuthenticatedUsers
+    :type entity: str
+    :param role: The access permission for the entity.
+        Acceptable values are: "OWNER", "READER", "WRITER".
+    :type role: str
+    :param user_project: (Optional) The project to be billed for this request.
+        Required for Requester Pays buckets.
+    :type user_project: str
+    :param google_cloud_storage_conn_id: The connection ID to use when
+        connecting to Google Cloud Storage.
+    :type google_cloud_storage_conn_id: str
+    """
+    # [START gcs_bucket_create_acl_template_fields]
+    template_fields = ('bucket', 'entity', 'role', 'user_project')
+    # [END gcs_bucket_create_acl_template_fields]
+
+    @apply_defaults
+    def __init__(self, bucket, entity, role, user_project=None,
+                 google_cloud_storage_conn_id='google_cloud_default', *args, **kwargs):
+        super(GoogleCloudStorageBucketCreateAclEntryOperator, self).__init__(*args,
+                                                                             **kwargs)
+        self.bucket = bucket
+        self.entity = entity
+        self.role = role
+        self.user_project = user_project
+        self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
+
+    def execute(self, context):
+        hook = GoogleCloudStorageHook(
+            google_cloud_storage_conn_id=self.google_cloud_storage_conn_id
+        )
+        hook.insert_bucket_acl(bucket=self.bucket, entity=self.entity, role=self.role,
+                               user_project=self.user_project)
+
+
+class GoogleCloudStorageObjectCreateAclEntryOperator(BaseOperator):
+    """
+    Creates a new ACL entry on the specified object.
+
+    :param bucket: Name of a bucket.
+    :type bucket: str
+    :param object_name: Name of the object. For information about how to URL encode object
+        names to be path safe, see:
+        https://cloud.google.com/storage/docs/json_api/#encoding
+    :type object_name: str
+    :param entity: The entity holding the permission, in one of the following forms:
+        - user-userId
+        - user-email
+        - group-groupId
+        - group-email
+        - domain-domain
+        - project-team-projectId
+        - allUsers
+        - allAuthenticatedUsers
+    :type entity: str
+    :param role: The access permission for the entity.
+        Acceptable values are: "OWNER", "READER".
+    :type role: str
+    :param generation: (Optional) If present, selects a specific revision of this object
+        (as opposed to the latest version, the default).
+    :type generation: str
+    :param user_project: (Optional) The project to be billed for this request.
+        Required for Requester Pays buckets.
+    :type user_project: str
+    :param google_cloud_storage_conn_id: The connection ID to use when
+        connecting to Google Cloud Storage.
+    :type google_cloud_storage_conn_id: str
+    """
+    # [START gcs_object_create_acl_template_fields]
+    template_fields = ('bucket', 'object_name', 'entity', 'role', 'generation',
+                       'user_project')
+    # [END gcs_object_create_acl_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 bucket,
+                 object_name,
+                 entity,
+                 role,
+                 generation=None,
+                 user_project=None,
+                 google_cloud_storage_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        super(GoogleCloudStorageObjectCreateAclEntryOperator, self).__init__(*args,
+                                                                             **kwargs)
+        self.bucket = bucket
+        self.object_name = object_name
+        self.entity = entity
+        self.role = role
+        self.generation = generation
+        self.user_project = user_project
+        self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
+
+    def execute(self, context):
+        hook = GoogleCloudStorageHook(
+            google_cloud_storage_conn_id=self.google_cloud_storage_conn_id
+        )
+        hook.insert_object_acl(bucket=self.bucket, object_name=self.object_name,
+                               entity=self.entity, role=self.role,
+                               generation=self.generation, user_project=self.user_project)
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 7d8053b41a83c..dc0f4c99d31ce 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -921,3 +921,92 @@ See `Google Cloud Sql Proxy documentation
 <https://cloud.google.com/sql/docs/postgres/sql-proxy>`_
 for details about Cloud Sql Proxy.
 
+Google Cloud Storage Operators
+------------------------------
+
+GoogleCloudStorageBucketCreateAclEntryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new ACL entry on the specified bucket.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
+      :language: python
+      :start-after: [START howto_operator_gcs_acl_args_common]
+      :end-before: [END howto_operator_gcs_acl_args_common]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcs_bucket_create_acl_entry_task]
+      :end-before: [END howto_operator_gcs_bucket_create_acl_entry_task]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcs_acl_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcs_bucket_create_acl_template_fields]
+    :end-before: [END gcs_bucket_create_acl_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Storage BucketAccessControls insert documentation
+<https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_
+for details.
+
+GoogleCloudStorageObjectCreateAclEntryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new ACL entry on the specified object.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
+      :language: python
+      :start-after: [START howto_operator_gcs_acl_args_common]
+      :end-before: [END howto_operator_gcs_acl_args_common]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcs_object_create_acl_entry_task]
+      :end-before: [END howto_operator_gcs_object_create_acl_entry_task]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcs_acl_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcs_object_create_acl_template_fields]
+    :end-before: [END gcs_object_create_acl_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Storage ObjectAccessControls insert documentation
+<https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_
+for details.
+
diff --git a/docs/integration.rst b/docs/integration.rst
index 4f67b3e520c8a..8fff6e48072a5 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -938,9 +938,11 @@ Storage Operators
 """""""""""""""""
 
 - :ref:`FileToGoogleCloudStorageOperator` : Uploads a file to Google Cloud Storage.
+- :ref:`GoogleCloudStorageBucketCreateAclEntryOperator` : Creates a new ACL entry on the specified bucket.
 - :ref:`GoogleCloudStorageCreateBucketOperator` : Creates a new cloud storage bucket.
-- :ref:`GoogleCloudStorageListOperator` : List all objects from the bucket with the give string prefix and delimiter in name.
 - :ref:`GoogleCloudStorageDownloadOperator` : Downloads a file from Google Cloud Storage.
+- :ref:`GoogleCloudStorageListOperator` : List all objects from the bucket with the give string prefix and delimiter in name.
+- :ref:`GoogleCloudStorageObjectCreateAclEntryOperator` : Creates a new ACL entry on the specified object.
 - :ref:`GoogleCloudStorageToBigQueryOperator` : Loads files from Google cloud storage into BigQuery.
 - :ref:`GoogleCloudStorageToGoogleCloudStorageOperator` : Copies objects from a bucket to another, with renaming if requested.
 
@@ -953,6 +955,13 @@ FileToGoogleCloudStorageOperator
 
 .. _GoogleCloudStorageCreateBucketOperator:
 
+GoogleCloudStorageBucketCreateAclEntryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
+
+.. _GoogleCloudStorageBucketCreateAclEntryOperator:
+
 GoogleCloudStorageCreateBucketOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -974,6 +983,13 @@ GoogleCloudStorageListOperator
 
 .. _GoogleCloudStorageToBigQueryOperator:
 
+GoogleCloudStorageObjectCreateAclEntryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
+
+.. _GoogleCloudStorageObjectCreateAclEntryOperator:
+
 GoogleCloudStorageToBigQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/tests/contrib/operators/test_gcp_base.py b/tests/contrib/operators/test_gcp_base.py
index 60e5abeb9f6e6..7e786c5b4b7c6 100644
--- a/tests/contrib/operators/test_gcp_base.py
+++ b/tests/contrib/operators/test_gcp_base.py
@@ -51,6 +51,7 @@
 GCP_CLOUDSQL_KEY = 'gcp_cloudsql.json'
 GCP_BIGTABLE_KEY = 'gcp_bigtable.json'
 GCP_SPANNER_KEY = 'gcp_spanner.json'
+GCP_GCS_KEY = 'gcp_gcs.json'
 
 SKIP_TEST_WARNING = """
 The test is only run when there is GCP connection available! "
diff --git a/tests/contrib/operators/test_gcs_acl_operator.py b/tests/contrib/operators/test_gcs_acl_operator.py
new file mode 100644
index 0000000000000..562c653574200
--- /dev/null
+++ b/tests/contrib/operators/test_gcs_acl_operator.py
@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.operators.gcs_acl_operator import \
+    GoogleCloudStorageBucketCreateAclEntryOperator, \
+    GoogleCloudStorageObjectCreateAclEntryOperator
+from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
+    SKIP_TEST_WARNING, GCP_GCS_KEY
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class GoogleCloudStorageAclTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageHook')
+    def test_bucket_create_acl(self, mock_hook):
+        operator = GoogleCloudStorageBucketCreateAclEntryOperator(
+            bucket="test-bucket",
+            entity="test-entity",
+            role="test-role",
+            user_project="test-user-project",
+            task_id="id"
+        )
+        operator.execute(None)
+        mock_hook.return_value.insert_bucket_acl.assert_called_once_with(
+            bucket="test-bucket",
+            entity="test-entity",
+            role="test-role",
+            user_project="test-user-project"
+        )
+
+    @mock.patch('airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageHook')
+    def test_object_create_acl(self, mock_hook):
+        operator = GoogleCloudStorageObjectCreateAclEntryOperator(
+            bucket="test-bucket",
+            object_name="test-object",
+            entity="test-entity",
+            role="test-role",
+            generation="test-generation",
+            user_project="test-user-project",
+            task_id="id"
+        )
+        operator.execute(None)
+        mock_hook.return_value.insert_object_acl.assert_called_once_with(
+            bucket="test-bucket",
+            object_name="test-object",
+            entity="test-entity",
+            role="test-role",
+            generation="test-generation",
+            user_project="test-user-project"
+        )
+
+
+@unittest.skipIf(
+    BaseGcpIntegrationTestCase.skip_check(GCP_GCS_KEY), SKIP_TEST_WARNING)
+class CloudStorageExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudStorageExampleDagsIntegrationTest, self).__init__(
+            method_name,
+            dag_id='example_gcs_acl',
+            gcp_key=GCP_GCS_KEY)
+
+    def test_run_example_dag_gcs_acl(self):
+        self._run_dag()

From 655cfdfde45b769d487380c564e3122beb36711c Mon Sep 17 00:00:00 2001
From: Alex Sokolov <alexander.sokolov@toptal.com>
Date: Sat, 1 Dec 2018 20:28:30 +0200
Subject: [PATCH 250/808] [AIRFLOW-3425] Fix setting default scope in hook
 (#4261)

---
 airflow/contrib/hooks/gcp_api_base_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 70523ffadcc92..90547579f0a69 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -75,7 +75,7 @@ def _get_credentials(self):
         key_path = self._get_field('key_path', False)
         keyfile_dict = self._get_field('keyfile_dict', False)
         scope = self._get_field('scope', None)
-        if scope is not None:
+        if scope:
             scopes = [s.strip() for s in scope.split(',')]
         else:
             scopes = _DEFAULT_SCOPES

From d9307f684f9a54a07b26269b00fa2ed46d1cfd4c Mon Sep 17 00:00:00 2001
From: Dr Martin Black <mblack@posteo.de>
Date: Sun, 18 Nov 2018 21:12:05 +0000
Subject: [PATCH 251/808] [AIRFLOW-3361] Log the task_id in the
 PendingDeprecationWarning from BaseOperator (#4030)

Log the task_id in the PendingDeprecationWarning when passing invalid arguments.
---
 airflow/models.py | 11 ++++++-----
 tests/core.py     |  3 ++-
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 2688bd536060d..02244cb187a96 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2397,12 +2397,13 @@ def __init__(
         if args or kwargs:
             # TODO remove *args and **kwargs in Airflow 2.0
             warnings.warn(
-                'Invalid arguments were passed to {c}. Support for '
-                'passing such arguments will be dropped in Airflow 2.0. '
-                'Invalid arguments were:'
+                'Invalid arguments were passed to {c} (task_id: {t}). '
+                'Support for passing such arguments will be dropped in '
+                'Airflow 2.0. Invalid arguments were:'
                 '\n*args: {a}\n**kwargs: {k}'.format(
-                    c=self.__class__.__name__, a=args, k=kwargs),
-                category=PendingDeprecationWarning
+                    c=self.__class__.__name__, a=args, k=kwargs, t=task_id),
+                category=PendingDeprecationWarning,
+                stacklevel=3
             )
         validate_key(task_id)
         self.task_id = task_id
diff --git a/tests/core.py b/tests/core.py
index c38f5614cdb1b..4172971f3fb16 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -403,7 +403,8 @@ def test_illegal_args(self):
             self.assertTrue(
                 issubclass(w[0].category, PendingDeprecationWarning))
             self.assertIn(
-                'Invalid arguments were passed to BashOperator.',
+                ('Invalid arguments were passed to BashOperator '
+                 '(task_id: test_illegal_args).'),
                 w[0].message.args[0])
 
     def test_bash_operator(self):

From 19235151c376f669434f1eb626336b1cac4ffa89 Mon Sep 17 00:00:00 2001
From: "Taylor D. Edmiston" <tedmiston@gmail.com>
Date: Tue, 14 Aug 2018 20:02:56 -0400
Subject: [PATCH 252/808] [AIRFLOW-XXX] Make pip install commands consistent
 (#3752)

- Replace airflow PyPI package name with apache-airflow
- Remove unnecessary quotes on pip install commands
- Make install extras commands consistent with pip docs [1] (e.g.,
alpha sort order without spaces or quotes)

[1]: https://pip.pypa.io/en/stable/reference/pip_install/#examples
---
 CONTRIBUTING.md                                             | 2 +-
 airflow/contrib/example_dags/example_kubernetes_operator.py | 4 ++--
 airflow/contrib/utils/sendgrid.py                           | 2 +-
 docs/installation.rst                                       | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 481ded4e4ee58..d991eb51fa641 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -108,7 +108,7 @@ docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=
 
 # Install Airflow with all the required dependencies,
 # including the devel which will provide the development tools
-pip install -e ".[hdfs,hive,druid,devel]"
+pip install -e .[devel,druid,hdfs,hive]
 
 # Init the database
 airflow initdb
diff --git a/airflow/contrib/example_dags/example_kubernetes_operator.py b/airflow/contrib/example_dags/example_kubernetes_operator.py
index 53517b1c46b72..ba1f4433a78cc 100644
--- a/airflow/contrib/example_dags/example_kubernetes_operator.py
+++ b/airflow/contrib/example_dags/example_kubernetes_operator.py
@@ -25,7 +25,7 @@
 
 try:
     # Kubernetes is optional, so not available in vanilla Airflow
-    # pip install airflow[kubernetes]
+    # pip install apache-airflow[kubernetes]
     from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
 
     args = {
@@ -64,4 +64,4 @@
 except ImportError as e:
     log.warn("Could not import KubernetesPodOperator: " + str(e))
     log.warn("Install kubernetes dependencies with: "
-             "    pip install airflow['kubernetes']")
+             "    pip install apache-airflow[kubernetes]")
diff --git a/airflow/contrib/utils/sendgrid.py b/airflow/contrib/utils/sendgrid.py
index d628097159904..ceb3718ff584d 100644
--- a/airflow/contrib/utils/sendgrid.py
+++ b/airflow/contrib/utils/sendgrid.py
@@ -42,7 +42,7 @@ def send_email(to, subject, html_content, files=None,
 
     To use this plugin:
     0. include sendgrid subpackage as part of your Airflow installation, e.g.,
-    pip install airflow[sendgrid]
+    pip install apache-airflow[sendgrid]
     1. update [email] backend in airflow.cfg, i.e.,
     [email]
     email_backend = airflow.contrib.utils.sendgrid.send_email
diff --git a/docs/installation.rst b/docs/installation.rst
index 5faca5efe4d20..78249df189960 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -31,7 +31,7 @@ You can also install Airflow with support for extra features like ``s3`` or ``po
 
 .. code-block:: bash
 
-    pip install "apache-airflow[s3, postgres]"
+    pip install apache-airflow[postgres,s3]
 
 .. note:: GPL dependency
 

From 7926ee576d069e569a427c1d9ed49996e53b743e Mon Sep 17 00:00:00 2001
From: Sergio Hg <sergio@sergiohgz.eu>
Date: Sun, 18 Nov 2018 18:34:19 +0100
Subject: [PATCH 253/808] [AIRFLOW-1252] API accept JSON when invoking a
 trigger dag (#2334)

---
 .../api/common/experimental/trigger_dag.py    |  5 ++-
 .../common/experimental/trigger_dag_tests.py  | 39 +++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/airflow/api/common/experimental/trigger_dag.py b/airflow/api/common/experimental/trigger_dag.py
index 86be6aa544089..3989de4ebd8f0 100644
--- a/airflow/api/common/experimental/trigger_dag.py
+++ b/airflow/api/common/experimental/trigger_dag.py
@@ -59,7 +59,10 @@ def _trigger_dag(
 
     run_conf = None
     if conf:
-        run_conf = json.loads(conf)
+        if type(conf) is dict:
+            run_conf = conf
+        else:
+            run_conf = json.loads(conf)
 
     triggers = list()
     dags_to_trigger = list()
diff --git a/tests/api/common/experimental/trigger_dag_tests.py b/tests/api/common/experimental/trigger_dag_tests.py
index d6354840e2da0..fc1d7cda8e55c 100644
--- a/tests/api/common/experimental/trigger_dag_tests.py
+++ b/tests/api/common/experimental/trigger_dag_tests.py
@@ -19,6 +19,7 @@
 
 import mock
 import unittest
+import json
 
 from airflow.exceptions import AirflowException
 from airflow.models import DAG, DagRun
@@ -88,6 +89,44 @@ def test_trigger_dag_include_subdags(self, dag_bag_mock, dag_run_mock, dag_mock)
 
         self.assertEqual(3, len(triggers))
 
+    @mock.patch('airflow.models.DagBag')
+    def test_trigger_dag_with_str_conf(self, dag_bag_mock):
+        dag_id = "trigger_dag_with_str_conf"
+        dag = DAG(dag_id)
+        dag_bag_mock.dags = [dag_id]
+        dag_bag_mock.get_dag.return_value = dag
+        conf = "{\"foo\": \"bar\"}"
+        dag_run = DagRun()
+        triggers = _trigger_dag(
+            dag_id,
+            dag_bag_mock,
+            dag_run,
+            run_id=None,
+            conf=conf,
+            execution_date=None,
+            replace_microseconds=True)
+
+        self.assertEquals(triggers[0].conf, json.loads(conf))
+
+    @mock.patch('airflow.models.DagBag')
+    def test_trigger_dag_with_dict_conf(self, dag_bag_mock):
+        dag_id = "trigger_dag_with_dict_conf"
+        dag = DAG(dag_id)
+        dag_bag_mock.dags = [dag_id]
+        dag_bag_mock.get_dag.return_value = dag
+        conf = dict(foo="bar")
+        dag_run = DagRun()
+        triggers = _trigger_dag(
+            dag_id,
+            dag_bag_mock,
+            dag_run,
+            run_id=None,
+            conf=conf,
+            execution_date=None,
+            replace_microseconds=True)
+
+        self.assertEquals(triggers[0].conf, conf)
+
 
 if __name__ == '__main__':
     unittest.main()

From 405155ab542e8d7c72b1b42de795cf8d90a70046 Mon Sep 17 00:00:00 2001
From: Gabriel Nicolas Avellaneda <avellaneda.gabriel@gmail.com>
Date: Tue, 20 Nov 2018 21:13:02 -0200
Subject: [PATCH 254/808] [AIRFLOW-XXX] Better instructions for airflow flower
 (#4214)

* Better instructions for airflow flower

It is not clear in the documentation that you need to have flower installed to successful run airflow flower. If you don't have flower installed, running airflow flower will show the following error which is not of much help:

airflow flower
[2018-11-20 17:01:14,836] {__init__.py:51} INFO - Using executor SequentialExecutor
Traceback (most recent call last):
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/bin/airflow", line 32, in <module>
    args.func(args)
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/lib/python3.6/site-packages/airflow/utils/cli.py", line
 74, in wrapper
    return f(*args, **kwargs)
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/lib/python3.6/site-packages/airflow/bin/cli.py", line 1
221, in flower
    broka, address, port, api, flower_conf, url_prefix])
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/lib/python3.6/os.py", line 559, in execvp
    _execvpe(file, args)
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/lib/python3.6/os.py", line 604, in _execvpe
    raise last_exc.with_traceback(tb)
  File "/mnt/secondary/workspace/f4/typo-backend/pipelines/model-pipeline/airflow/lib/python3.6/os.py", line 594, in _execvpe
    exec_func(fullname, *argrest)                                                                                                        FileNotFoundError: [Errno 2] No such file or directory

* Update use-celery.rst
---
 docs/howto/executor/use-celery.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/howto/executor/use-celery.rst b/docs/howto/executor/use-celery.rst
index 71cae66a6f5b9..ff05334fdc028 100644
--- a/docs/howto/executor/use-celery.rst
+++ b/docs/howto/executor/use-celery.rst
@@ -57,6 +57,13 @@ Note that you can also run "Celery Flower", a web UI built on top of Celery,
 to monitor your workers. You can use the shortcut command ``airflow flower``
 to start a Flower web server.
 
+Please note that you must have the ``flower`` python library already installed on your system. The recommend way is to install the airflow celery bundle.
+
+.. code-block:: bash
+
+    pip install 'apache-airflow[celery]'
+
+
 Some caveats:
 
 - Make sure to use a database backed result backend

From 721fc3c9da68cdd0c84f239dd0430b5487587c20 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 3 Dec 2018 00:54:23 +0800
Subject: [PATCH 255/808] [AIRFLOW-3432] Add test for feature "Delete DAG in
 UI" (#4266)

Related Commits:
1. [AIRFLOW-2657](PR #3531)
2. [AIRFLOW-3233](PR #4069)

Added for both www/ and www_rbac
---
 tests/www/test_views.py      | 33 +++++++++++++++++++++++++++++++++
 tests/www_rbac/test_views.py | 23 +++++++++++++++++++++++
 2 files changed, 56 insertions(+)

diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 4075f91d537a6..5805016a00e62 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -790,5 +790,38 @@ def test_start_date_filter(self):
         self.assertEqual(resp.status_code, 200)
 
 
+class TestDeleteDag(unittest.TestCase):
+
+    def setUp(self):
+        conf.load_test_config()
+        app = application.create_app(testing=True)
+        app.config['WTF_CSRF_METHODS'] = []
+        self.app = app.test_client()
+
+    def test_delete_dag_button_normal(self):
+        resp = self.app.get('/', follow_redirects=True)
+        self.assertIn('/delete?dag_id=example_bash_operator', resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+
+    def test_delete_dag_button_for_dag_on_scheduler_only(self):
+        # Test for JIRA AIRFLOW-3233 (PR 4069):
+        # The delete-dag URL should be generated correctly for DAGs
+        # that exist on the scheduler (DB) but not the webserver DagBag
+
+        test_dag_id = "non_existent_dag"
+
+        session = Session()
+        DM = models.DagModel
+        session.query(DM).filter(DM.dag_id == 'example_bash_operator').update({'dag_id': test_dag_id})
+        session.commit()
+
+        resp = self.app.get('/', follow_redirects=True)
+        self.assertIn('/delete?dag_id={}'.format(test_dag_id), resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag('{}')".format(test_dag_id), resp.data.decode('utf-8'))
+
+        session.query(DM).filter(DM.dag_id == test_dag_id).update({'dag_id': 'example_bash_operator'})
+        session.commit()
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 5e9e51c8160a9..6e5d9922e1d5d 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -426,6 +426,29 @@ def test_refresh(self):
         resp = self.client.get('refresh?dag_id=example_bash_operator')
         self.check_content_in_response('', resp, resp_code=302)
 
+    def test_delete_dag_button_normal(self):
+        resp = self.client.get('/', follow_redirects=True)
+        self.check_content_in_response('/delete?dag_id=example_bash_operator', resp)
+        self.check_content_in_response("return confirmDeleteDag('example_bash_operator')", resp)
+
+    def test_delete_dag_button_for_dag_on_scheduler_only(self):
+        # Test for JIRA AIRFLOW-3233 (PR 4069):
+        # The delete-dag URL should be generated correctly for DAGs
+        # that exist on the scheduler (DB) but not the webserver DagBag
+
+        test_dag_id = "non_existent_dag"
+
+        DM = models.DagModel
+        self.session.query(DM).filter(DM.dag_id == 'example_bash_operator').update({'dag_id': test_dag_id})
+        self.session.commit()
+
+        resp = self.client.get('/', follow_redirects=True)
+        self.check_content_in_response('/delete?dag_id={}'.format(test_dag_id), resp)
+        self.check_content_in_response("return confirmDeleteDag('{}')".format(test_dag_id), resp)
+
+        self.session.query(DM).filter(DM.dag_id == test_dag_id).update({'dag_id': 'example_bash_operator'})
+        self.session.commit()
+
 
 class TestConfigurationView(TestBase):
 

From d7649d660b0337db2ae71f320f3d966ebc26c6fb Mon Sep 17 00:00:00 2001
From: Kevin Yang <yrqls21@gmail.com>
Date: Sun, 2 Dec 2018 09:45:08 -0800
Subject: [PATCH 256/808] [AIRFLOW-3414] Fix reload_module in
 DagFileProcessorAgent (#4253)

---
 airflow/logging_config.py          |   8 +-
 airflow/settings.py                |   2 +-
 airflow/utils/dag_processing.py    |   6 +-
 tests/utils/test_dag_processing.py | 143 ++++++++++++++++++++++++++++-
 4 files changed, 152 insertions(+), 7 deletions(-)

diff --git a/airflow/logging_config.py b/airflow/logging_config.py
index 84850b4f8244b..4865f0567a571 100644
--- a/airflow/logging_config.py
+++ b/airflow/logging_config.py
@@ -57,9 +57,9 @@ def configure_logging():
                 .format(logging_class_path, err)
             )
     else:
-        from airflow.config_templates.airflow_local_settings import (
-            DEFAULT_LOGGING_CONFIG as logging_config
-        )
+        logging_class_path = 'airflow.config_templates.' \
+                             'airflow_local_settings.DEFAULT_LOGGING_CONFIG'
+        logging_config = import_string(logging_class_path)
         log.debug('Unable to load custom logging, using default config instead')
 
     try:
@@ -73,7 +73,7 @@ def configure_logging():
 
     validate_logging_config(logging_config)
 
-    return logging_config
+    return logging_class_path
 
 
 def validate_logging_config(logging_config):
diff --git a/airflow/settings.py b/airflow/settings.py
index 26d0ba983f09b..d98733718aa36 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -256,7 +256,7 @@ def configure_action_logging():
 except Exception:
     pass
 
-configure_logging()
+logging_class_path = configure_logging()
 configure_vars()
 configure_adapters()
 # The webservers import this file from models.py with the default settings.
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 1b2eeeff2aa79..a9bcdeb0eb5d1 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -34,6 +34,7 @@
 from collections import defaultdict
 from collections import namedtuple
 from datetime import timedelta
+from importlib import import_module
 
 import psutil
 from six.moves import range, reload_module
@@ -45,6 +46,7 @@
 from airflow import configuration as conf
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.exceptions import AirflowException
+from airflow.settings import logging_class_path
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -481,7 +483,9 @@ def helper():
             # e.g. RotatingFileHandler. And it can cause connection corruption if we
             # do not recreate the SQLA connection pool.
             os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER'] = 'True'
-            reload_module(airflow.config_templates.airflow_local_settings)
+            # Replicating the behavior of how logging module was loaded
+            # in logging_config.py
+            reload_module(import_module(logging_class_path.rsplit('.', 1)[0]))
             reload_module(airflow.settings)
             del os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER']
             processor_manager = DagFileProcessorManager(dag_directory,
diff --git a/tests/utils/test_dag_processing.py b/tests/utils/test_dag_processing.py
index 94c39feb4eede..d2307647ac14f 100644
--- a/tests/utils/test_dag_processing.py
+++ b/tests/utils/test_dag_processing.py
@@ -18,12 +18,15 @@
 # under the License.
 
 import os
+import sys
+import tempfile
 import unittest
 from datetime import timedelta
 
 from mock import MagicMock
 
 from airflow import configuration as conf
+from airflow.configuration import mkdir_p
 from airflow.jobs import DagFileProcessor
 from airflow.jobs import LocalTaskJob as LJ
 from airflow.models import DagBag, TaskInstance as TI
@@ -38,6 +41,96 @@
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 
+SETTINGS_FILE_VALID = """
+LOGGING_CONFIG = {
+    'version': 1,
+    'disable_existing_loggers': False,
+    'formatters': {
+        'airflow.task': {
+            'format': '[%%(asctime)s] {{%%(filename)s:%%(lineno)d}} %%(levelname)s - %%(message)s'
+        },
+    },
+    'handlers': {
+        'console': {
+            'class': 'logging.StreamHandler',
+            'formatter': 'airflow.task',
+            'stream': 'ext://sys.stdout'
+        },
+        'task': {
+            'class': 'logging.StreamHandler',
+            'formatter': 'airflow.task',
+            'stream': 'ext://sys.stdout'
+        },
+    },
+    'loggers': {
+        'airflow': {
+            'handlers': ['console'],
+            'level': 'INFO',
+            'propagate': False
+        },
+        'airflow.task': {
+            'handlers': ['task'],
+            'level': 'INFO',
+            'propagate': False,
+        },
+    }
+}
+"""
+
+SETTINGS_DEFAULT_NAME = 'custom_airflow_local_settings'
+
+
+class settings_context(object):
+    """
+    Sets a settings file and puts it in the Python classpath
+
+    :param content:
+          The content of the settings file
+    """
+
+    def __init__(self, content, dir=None, name='LOGGING_CONFIG'):
+        self.content = content
+        self.settings_root = tempfile.mkdtemp()
+        filename = "{}.py".format(SETTINGS_DEFAULT_NAME)
+
+        if dir:
+            # Replace slashes by dots
+            self.module = dir.replace('/', '.') + '.' + SETTINGS_DEFAULT_NAME + '.' + name
+
+            # Create the directory structure
+            dir_path = os.path.join(self.settings_root, dir)
+            mkdir_p(dir_path)
+
+            # Add the __init__ for the directories
+            # This is required for Python 2.7
+            basedir = self.settings_root
+            for part in dir.split('/'):
+                open(os.path.join(basedir, '__init__.py'), 'w').close()
+                basedir = os.path.join(basedir, part)
+            open(os.path.join(basedir, '__init__.py'), 'w').close()
+
+            self.settings_file = os.path.join(dir_path, filename)
+        else:
+            self.module = SETTINGS_DEFAULT_NAME + '.' + name
+            self.settings_file = os.path.join(self.settings_root, filename)
+
+    def __enter__(self):
+        with open(self.settings_file, 'w') as handle:
+            handle.writelines(self.content)
+        sys.path.append(self.settings_root)
+        conf.set(
+            'core',
+            'logging_config_class',
+            self.module
+        )
+        return self.settings_file
+
+    def __exit__(self, *exc_info):
+        # shutil.rmtree(self.settings_root)
+        # Reset config
+        conf.set('core', 'logging_config_class', '')
+        sys.path.remove(self.settings_root)
+
 
 class TestDagFileProcessorManager(unittest.TestCase):
     def test_set_file_paths_when_processor_file_path_not_in_new_file_paths(self):
@@ -123,6 +216,54 @@ def test_find_zombies(self):
 
 
 class TestDagFileProcessorAgent(unittest.TestCase):
+    def test_reload_module(self):
+        """
+        Configure the context to have core.logging_config_class set to a fake logging
+        class path, thus when reloading logging module the airflow.processor_manager
+        logger should not be configured.
+        """
+        with settings_context(SETTINGS_FILE_VALID):
+            # Launch a process through DagFileProcessorAgent, which will try
+            # reload the logging module.
+            def processor_factory(file_path, zombies):
+                return DagFileProcessor(file_path,
+                                        False,
+                                        [],
+                                        zombies)
+
+            test_dag_path = os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py')
+            async_mode = 'sqlite' not in conf.get('core', 'sql_alchemy_conn')
+
+            log_file_loc = conf.get('core', 'DAG_PROCESSOR_MANAGER_LOG_LOCATION')
+            try:
+                os.remove(log_file_loc)
+            except OSError:
+                pass
+
+            # Starting dag processing with 0 max_runs to avoid redundant operations.
+            processor_agent = DagFileProcessorAgent(test_dag_path,
+                                                    [],
+                                                    0,
+                                                    processor_factory,
+                                                    async_mode)
+            manager_process = \
+                processor_agent._launch_process(processor_agent._dag_directory,
+                                                processor_agent._file_paths,
+                                                processor_agent._max_runs,
+                                                processor_agent._processor_factory,
+                                                processor_agent._child_signal_conn,
+                                                processor_agent._stat_queue,
+                                                processor_agent._result_queue,
+                                                processor_agent._async_mode)
+            if not async_mode:
+                processor_agent.heartbeat()
+
+            manager_process.join()
+
+            # Since we are reloading logging config not creating this file,
+            # we should expect it to be nonexistent.
+            self.assertFalse(os.path.isfile(log_file_loc))
+
     def test_parse_once(self):
         def processor_factory(file_path, zombies):
             return DagFileProcessor(file_path,
@@ -164,7 +305,7 @@ def processor_factory(file_path, zombies):
         except OSError:
             pass
 
-        # Starting dag processing with 0 max_runs to avoid redundent operations.
+        # Starting dag processing with 0 max_runs to avoid redundant operations.
         processor_agent = DagFileProcessorAgent(test_dag_path,
                                                 [],
                                                 0,

From ed54e2e6144829638bc2e248a2cf975d765c0393 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bartosz=20=C5=81ugowski?=
 <blugowski@users.noreply.github.com>
Date: Wed, 21 Nov 2018 18:44:43 +0100
Subject: [PATCH 257/808] [AIRFLOW-3380] Add metrics documentation (#4219)

---
 docs/index.rst   |  1 +
 docs/metrics.rst | 67 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 68 insertions(+)
 create mode 100644 docs/metrics.rst

diff --git a/docs/index.rst b/docs/index.rst
index 4c18ce5ce6df9..efd0a8b78db4c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -103,6 +103,7 @@ Content
     timezone
     api
     integration
+    metrics
     lineage
     faq
     code
diff --git a/docs/metrics.rst b/docs/metrics.rst
new file mode 100644
index 0000000000000..29819c03e6ebe
--- /dev/null
+++ b/docs/metrics.rst
@@ -0,0 +1,67 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Metrics
+=======
+
+Configuration
+-------------
+Airflow can be set up to send metrics to `StatsD <https://github.com/etsy/statsd>`__:
+
+.. code-block:: bash
+
+    [scheduler]
+    statsd_on = True
+    statsd_host = localhost
+    statsd_port = 8125
+    statsd_prefix = airflow
+
+Counters
+--------
+
+=================================== ================================================================
+Name                                Description
+=================================== ================================================================
+<job_name>_start                    Number of started <job_name> job, ex. SchedulerJob, LocalTaskJob
+<job_name>_end                      Number of ended <job_name> job, ex. SchedulerJob, LocalTaskJob
+operator_failures_<operator_name>   Operator <operator_name> failures
+operator_successes_<operator_name>  Operator <operator_name> successes
+ti_failures                         Overall task instances failures
+ti_successes                        Overall task instances successes
+zombies_killed                      Zombie tasks killed
+scheduler_heartbeat                 Scheduler heartbeats
+=================================== ================================================================
+
+Gauges
+------
+
+===================== =====================================
+Name                  Description
+===================== =====================================
+collect_dags          Seconds taken to scan and import DAGs
+dagbag_import_errors  DAG import errors
+dagbag_size           DAG bag size
+===================== =====================================
+
+Timers
+------
+
+================================= =======================================
+Name                              Description
+================================= =======================================
+dagrun.dependency-check.<dag_id>  Seconds taken to check DAG dependencies
+================================= =======================================

From 1d2a3eb4ee1292773f2aa389d40f2609ea101457 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sun, 2 Dec 2018 20:51:30 +0000
Subject: [PATCH 258/808] [AIRFLOW-XXX] Fix display of SageMaker operators/hook
 docs (#4263)

---
 airflow/contrib/hooks/sagemaker_hook.py       | 19 ++++++------
 .../sagemaker_endpoint_config_operator.py     |  5 ++-
 .../operators/sagemaker_endpoint_operator.py  | 31 +++++++++----------
 .../operators/sagemaker_model_operator.py     |  5 ++-
 .../operators/sagemaker_training_operator.py  |  5 ++-
 .../operators/sagemaker_transform_operator.py | 15 +++++----
 .../operators/sagemaker_tuning_operator.py    |  6 ++--
 docs/conf.py                                  |  7 ++++-
 8 files changed, 47 insertions(+), 46 deletions(-)

diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index 823f430db994f..55e62a78e238f 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -160,7 +160,7 @@ def configure_s3_resources(self, config):
 
         :param config: config of SageMaker operation
         :type config: dict
-        :return: dict
+        :rtype: dict
         """
         s3_operations = config.pop('S3Operations', None)
 
@@ -182,8 +182,8 @@ def check_s3_url(self, s3url):
         Check if an S3 URL exists
 
         :param s3url: S3 url
-        :type s3url:str
-        :return: bool
+        :type s3url: str
+        :rtype: bool
         """
         bucket, key = S3Hook.parse_s3_url(s3url)
         if not self.s3_hook.check_for_bucket(bucket_name=bucket):
@@ -226,7 +226,7 @@ def get_conn(self):
         """
         Establish an AWS connection for SageMaker
 
-        :return: a boto3 SageMaker client
+        :rtype: :py:class:`SageMaker.Client`
         """
         return self.get_client_type('sagemaker')
 
@@ -234,7 +234,7 @@ def get_log_conn(self):
         """
         Establish an AWS connection for retrieving logs during training
 
-        :return: a boto3 CloudWatchLog client
+        :rtype: :py:class:`CloudWatchLog.Client`
         """
         config = botocore.config.Config(retries={'max_attempts': 15})
         return self.get_client_type('logs', config=config)
@@ -253,10 +253,11 @@ def log_stream(self, log_group, stream_name, start_time=0, skip=0):
         :param skip: The number of log entries to skip at the start (default: 0).
             This is for when there are multiple entries at the same timestamp.
         :type skip: int
-        :return:A CloudWatch log event with the following key-value pairs:
-            'timestamp' (int): The time in milliseconds of the event.
-            'message' (str): The log event data.
-            'ingestionTime' (int): The time in milliseconds the event was ingested.
+        :rtype: dict
+        :return: | A CloudWatch log event with the following key-value pairs:
+                 |   'timestamp' (int): The time in milliseconds of the event.
+                 |   'message' (str): The log event data.
+                 |   'ingestionTime' (int): The time in milliseconds the event was ingested.
         """
 
         next_token = None
diff --git a/airflow/contrib/operators/sagemaker_endpoint_config_operator.py b/airflow/contrib/operators/sagemaker_endpoint_config_operator.py
index a94cf3022904b..e4f8ce7c9103f 100644
--- a/airflow/contrib/operators/sagemaker_endpoint_config_operator.py
+++ b/airflow/contrib/operators/sagemaker_endpoint_config_operator.py
@@ -31,12 +31,11 @@ class SageMakerEndpointConfigOperator(SageMakerBaseOperator):
 
     :param config: The configuration necessary to create an endpoint config.
 
-        For details of the configuration parameter, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint_config
+        For details of the configuration parameter see :py:meth:`SageMaker.Client.create_endpoint_config`
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
-    """  # noqa: E501
+    """
 
     integer_fields = [
         ['ProductionVariants', 'InitialInstanceCount']
diff --git a/airflow/contrib/operators/sagemaker_endpoint_operator.py b/airflow/contrib/operators/sagemaker_endpoint_operator.py
index 4094fbe59e2b8..b3f17df128a35 100644
--- a/airflow/contrib/operators/sagemaker_endpoint_operator.py
+++ b/airflow/contrib/operators/sagemaker_endpoint_operator.py
@@ -33,43 +33,42 @@ class SageMakerEndpointOperator(SageMakerBaseOperator):
     :param config:
         The configuration necessary to create an endpoint.
 
-        If you need to create a SageMaker endpoint based on an existed SageMaker model and an existed SageMaker
-        endpoint config,
+        If you need to create a SageMaker endpoint based on an existed
+        SageMaker model and an existed SageMaker endpoint config::
 
             config = endpoint_configuration;
 
-        If you need to create all of SageMaker model, SageMaker endpoint-config and SageMaker endpoint,
+        If you need to create all of SageMaker model, SageMaker endpoint-config and SageMaker endpoint::
 
             config = {
                 'Model': model_configuration,
-
                 'EndpointConfig': endpoint_config_configuration,
-
                 'Endpoint': endpoint_configuration
             }
 
-        For details of the configuration parameter of model_configuration, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+        For details of the configuration parameter of model_configuration see
+        :py:meth:`SageMaker.Client.create_model`
 
-        For details of the configuration parameter of endpoint_config_configuration, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint_config
+        For details of the configuration parameter of endpoint_config_configuration see
+        :py:meth:`SageMaker.Client.create_endpoint_config`
+
+        For details of the configuration parameter of endpoint_configuration see
+        :py:meth:`SageMaker.Client.create_endpoint`
 
-        For details of the configuration parameter of endpoint_configuration, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_endpoint
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
     :param wait_for_completion: Whether the operator should wait until the endpoint creation finishes.
     :type wait_for_completion: bool
-    :param check_interval: If wait is set to True, this is the time interval, in seconds, that this operation waits
-        before polling the status of the endpoint creation.
+    :param check_interval: If wait is set to True, this is the time interval, in seconds, that this operation
+        waits before polling the status of the endpoint creation.
     :type check_interval: int
-    :param max_ingestion_time: If wait is set to True, this operation fails if the endpoint creation doesn't finish
-        within max_ingestion_time seconds. If you set this parameter to None it never times out.
+    :param max_ingestion_time: If wait is set to True, this operation fails if the endpoint creation doesn't
+        finish within max_ingestion_time seconds. If you set this parameter to None it never times out.
     :type max_ingestion_time: int
     :param operation: Whether to create an endpoint or update an endpoint. Must be either 'create or 'update'.
     :type operation: str
-    """  # noqa: E501
+    """
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/operators/sagemaker_model_operator.py b/airflow/contrib/operators/sagemaker_model_operator.py
index 4332daa9db341..5bfc1feb3149b 100644
--- a/airflow/contrib/operators/sagemaker_model_operator.py
+++ b/airflow/contrib/operators/sagemaker_model_operator.py
@@ -32,12 +32,11 @@ class SageMakerModelOperator(SageMakerBaseOperator):
 
     :param config: The configuration necessary to create a model.
 
-        For details of the configuration parameter, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+        For details of the configuration parameter see :py:meth:`SageMaker.Client.create_model`
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
-    """  # noqa: E501
+    """
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/operators/sagemaker_training_operator.py b/airflow/contrib/operators/sagemaker_training_operator.py
index d90f7e6555697..f10e13e9736c5 100644
--- a/airflow/contrib/operators/sagemaker_training_operator.py
+++ b/airflow/contrib/operators/sagemaker_training_operator.py
@@ -31,8 +31,7 @@ class SageMakerTrainingOperator(SageMakerBaseOperator):
 
     :param config: The configuration necessary to start a training job (templated).
 
-        For details of the configuration parameter, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_training_job
+        For details of the configuration parameter see :py:meth:`SageMaker.Client.create_training_job`
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
@@ -48,7 +47,7 @@ class SageMakerTrainingOperator(SageMakerBaseOperator):
         doesn't finish within max_ingestion_time seconds. If you set this parameter to None,
         the operation does not timeout.
     :type max_ingestion_time: int
-    """  # noqa: E501
+    """
 
     integer_fields = [
         ['ResourceConfig', 'InstanceCount'],
diff --git a/airflow/contrib/operators/sagemaker_transform_operator.py b/airflow/contrib/operators/sagemaker_transform_operator.py
index 9d1c665f9eea5..9dcf9ab32764e 100644
--- a/airflow/contrib/operators/sagemaker_transform_operator.py
+++ b/airflow/contrib/operators/sagemaker_transform_operator.py
@@ -31,23 +31,22 @@ class SageMakerTransformOperator(SageMakerBaseOperator):
 
     :param config: The configuration necessary to start a transform job (templated).
 
-        If you need to create a SageMaker transform job based on an existed SageMaker model,
+        If you need to create a SageMaker transform job based on an existed SageMaker model::
 
-            config = transform_config;
+            config = transform_config
 
-        If you need to create both SageMaker model and SageMaker Transform job,
+        If you need to create both SageMaker model and SageMaker Transform job::
 
             config = {
                 'Model': model_config,
-
                 'Transform': transform_config
             }
 
-        For details of the configuration parameter of transform_config, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_transform_job
+        For details of the configuration parameter of transform_config see
+        :py:meth:`SageMaker.Client.create_transform_job`
 
         For details of the configuration parameter of model_config, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model
+        :py:meth:`SageMaker.Client.create_model`
 
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
@@ -61,7 +60,7 @@ class SageMakerTransformOperator(SageMakerBaseOperator):
         if the transform job doesn't finish within max_ingestion_time seconds. If you
         set this parameter to None, the operation does not timeout.
     :type max_ingestion_time: int
-    """  # noqa: E501
+    """
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/operators/sagemaker_tuning_operator.py b/airflow/contrib/operators/sagemaker_tuning_operator.py
index dc1282b5b8273..2a92bf1b81cf7 100644
--- a/airflow/contrib/operators/sagemaker_tuning_operator.py
+++ b/airflow/contrib/operators/sagemaker_tuning_operator.py
@@ -31,8 +31,8 @@ class SageMakerTuningOperator(SageMakerBaseOperator):
 
     :param config: The configuration necessary to start a tuning job (templated).
 
-        For details of the configuration parameter, See:
-        https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_hyper_parameter_tuning_job
+        For details of the configuration parameter see
+        :py:meth:`SageMaker.Client.create_hyper_parameter_tuning_job`
     :type config: dict
     :param aws_conn_id: The AWS connection ID to use.
     :type aws_conn_id: str
@@ -45,7 +45,7 @@ class SageMakerTuningOperator(SageMakerBaseOperator):
         if the tuning job doesn't finish within max_ingestion_time seconds. If you
         set this parameter to None, the operation does not timeout.
     :type max_ingestion_time: int
-    """  # noqa: E501
+    """
 
     integer_fields = [
         ['HyperParameterTuningJobConfig', 'ResourceLimits', 'MaxNumberOfTrainingJobs'],
diff --git a/docs/conf.py b/docs/conf.py
index cc00a276413ae..7c17f97bf9086 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -76,7 +76,8 @@
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
     'sphinxarg.ext',
-    'sphinxcontrib.httpdomain'
+    'sphinxcontrib.httpdomain',
+    'sphinx.ext.intersphinx',
 ]
 
 autodoc_default_flags = ['show-inheritance', 'members']
@@ -147,6 +148,10 @@
 #keep_warnings = False
 
 
+intersphinx_mapping = {
+    'boto3': ('https://boto3.amazonaws.com/v1/documentation/api/latest', None),
+}
+
 # -- Options for HTML output ----------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for

From 2b04ace9febbb97ff29c8271dd0da669e5bcca77 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@gmail.com>
Date: Tue, 31 Jul 2018 15:24:34 -0400
Subject: [PATCH 259/808] [AIRFLOW-2670] Update SSH Operator's Hook to respect
 timeout (#3666)

---
 airflow/contrib/operators/ssh_operator.py    |  7 ++++---
 tests/contrib/operators/test_ssh_operator.py | 21 ++++++++++++++++++--
 2 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index 2e890f463ea88..747ad04ff0dad 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -69,16 +69,17 @@ def __init__(self,
     def execute(self, context):
         try:
             if self.ssh_conn_id and not self.ssh_hook:
-                self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id)
+                self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id,
+                                        timeout=self.timeout)
 
             if not self.ssh_hook:
-                raise AirflowException("can not operate without ssh_hook or ssh_conn_id")
+                raise AirflowException("Cannot operate without ssh_hook or ssh_conn_id.")
 
             if self.remote_host is not None:
                 self.ssh_hook.remote_host = self.remote_host
 
             if not self.command:
-                raise AirflowException("no command specified so nothing to execute here.")
+                raise AirflowException("SSH command not specified. Aborting.")
 
             with self.ssh_hook.get_conn() as ssh_client:
                 # Auto apply tty when its required in case of sudo
diff --git a/tests/contrib/operators/test_ssh_operator.py b/tests/contrib/operators/test_ssh_operator.py
index b97ba84a012a2..7ddd24b2ac2ca 100644
--- a/tests/contrib/operators/test_ssh_operator.py
+++ b/tests/contrib/operators/test_ssh_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -58,6 +58,23 @@ def setUp(self):
         self.hook = hook
         self.dag = dag
 
+    def test_hook_created_correctly(self):
+        TIMEOUT = 20
+        SSH_ID = "ssh_default"
+        task = SSHOperator(
+            task_id="test",
+            command="echo -n airflow",
+            dag=self.dag,
+            timeout=TIMEOUT,
+            ssh_conn_id="ssh_default"
+        )
+        self.assertIsNotNone(task)
+
+        task.execute(None)
+
+        self.assertEquals(TIMEOUT, task.ssh_hook.timeout)
+        self.assertEquals(SSH_ID, task.ssh_hook.ssh_conn_id)
+
     def test_json_command_execution(self):
         configuration.conf.set("core", "enable_xcom_pickling", "False")
         task = SSHOperator(

From 987ce8db6c61fe5b4b60d1d15cc47db6c4923147 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Sun, 19 Aug 2018 22:10:25 +0800
Subject: [PATCH 260/808] [AIRFLOW-2245] Add remote_host of SSH/SFTP operator
 as templated field (#3765)

It allows remote_host to be passed to operator with XCOM.
---
 airflow/contrib/operators/sftp_operator.py | 4 ++--
 airflow/contrib/operators/ssh_operator.py  | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index def54c3fbadc9..3c736c8b95101 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -37,7 +37,7 @@ class SFTPOperator(BaseOperator):
     :type ssh_hook: :class:`SSHHook`
     :param ssh_conn_id: connection id from airflow Connections
     :type ssh_conn_id: str
-    :param remote_host: remote host to connect
+    :param remote_host: remote host to connect (templated)
     :type remote_host: str
     :param local_filepath: local file path to get or put. (templated)
     :type local_filepath: str
@@ -48,7 +48,7 @@ class SFTPOperator(BaseOperator):
     :param confirm: specify if the SFTP operation should be confirmed, defaults to True
     :type confirm: bool
     """
-    template_fields = ('local_filepath', 'remote_filepath')
+    template_fields = ('local_filepath', 'remote_filepath', 'remote_host')
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index 747ad04ff0dad..c0e8953d2c344 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -35,7 +35,7 @@ class SSHOperator(BaseOperator):
     :type ssh_hook: :class:`SSHHook`
     :param ssh_conn_id: connection id from airflow Connections
     :type ssh_conn_id: str
-    :param remote_host: remote host to connect
+    :param remote_host: remote host to connect (templated)
     :type remote_host: str
     :param command: command to execute on remote host. (templated)
     :type command: str
@@ -45,7 +45,7 @@ class SSHOperator(BaseOperator):
     :type do_xcom_push: bool
     """
 
-    template_fields = ('command',)
+    template_fields = ('command', 'remote_host')
     template_ext = ('.sh',)
 
     @apply_defaults

From 255ecc6a5e3658c56f7a0f992333e442e1967bcc Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 30 Aug 2018 03:20:11 +0800
Subject: [PATCH 261/808] [AIRFLOW-2948] Arg check & better doc - SSHOperator &
 SFTPOperator (#3793)

There may be different combinations of arguments, and
some processings are being done 'silently', while users
may not be fully aware of them.

For example
- User only needs to provide either `ssh_hook`
  or `ssh_conn_id`, while this is not clear in doc
- if both provided, `ssh_conn_id` will be ignored.
- if `remote_host` is provided, it will replace
  the `remote_host` which wasndefined in `ssh_hook`
  or predefined in the connection of `ssh_conn_id`

These should be documented clearly to ensure it's
transparent to the users. log.info() should also be
used to remind users and provide clear logs.

In addition, add instance check for ssh_hook to ensure
it is of the correct type (SSHHook).

Tests are updated for this PR.
---
 airflow/contrib/operators/sftp_operator.py    | 22 ++++--
 airflow/contrib/operators/ssh_operator.py     | 22 ++++--
 tests/contrib/operators/test_sftp_operator.py | 76 +++++++++++++++++--
 tests/contrib/operators/test_ssh_operator.py  | 60 +++++++++++++++
 4 files changed, 165 insertions(+), 15 deletions(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 3c736c8b95101..a3b5c1f24492b 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -33,11 +33,15 @@ class SFTPOperator(BaseOperator):
     This operator uses ssh_hook to open sftp trasport channel that serve as basis
     for file transfer.
 
-    :param ssh_hook: predefined ssh_hook to use for remote execution
+    :param ssh_hook: predefined ssh_hook to use for remote execution.
+        Either `ssh_hook` or `ssh_conn_id` needs to be provided.
     :type ssh_hook: :class:`SSHHook`
-    :param ssh_conn_id: connection id from airflow Connections
+    :param ssh_conn_id: connection id from airflow Connections.
+        `ssh_conn_id` will be ingored if `ssh_hook` is provided.
     :type ssh_conn_id: str
     :param remote_host: remote host to connect (templated)
+        Nullable. If provided, it will replace the `remote_host` which was
+        defined in `ssh_hook` or predefined in the connection of `ssh_conn_id`.
     :type remote_host: str
     :param local_filepath: local file path to get or put. (templated)
     :type local_filepath: str
@@ -77,13 +81,21 @@ def __init__(self,
     def execute(self, context):
         file_msg = None
         try:
-            if self.ssh_conn_id and not self.ssh_hook:
-                self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id)
+            if self.ssh_conn_id:
+                if self.ssh_hook and isinstance(self.ssh_hook, SSHHook):
+                    self.log.info("ssh_conn_id is ignored when ssh_hook is provided.")
+                else:
+                    self.log.info("ssh_hook is not provided or invalid. " +
+                                  "Trying ssh_conn_id to create SSHHook.")
+                    self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id)
 
             if not self.ssh_hook:
-                raise AirflowException("can not operate without ssh_hook or ssh_conn_id")
+                raise AirflowException("Cannot operate without ssh_hook or ssh_conn_id.")
 
             if self.remote_host is not None:
+                self.log.info("remote_host is provided explicitly. " +
+                              "It will replace the remote_host which was defined " +
+                              "in ssh_hook or predefined in connection of ssh_conn_id.")
                 self.ssh_hook.remote_host = self.remote_host
 
             with self.ssh_hook.get_conn() as ssh_client:
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index c0e8953d2c344..2bf342935d60c 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -31,11 +31,15 @@ class SSHOperator(BaseOperator):
     """
     SSHOperator to execute commands on given remote host using the ssh_hook.
 
-    :param ssh_hook: predefined ssh_hook to use for remote execution
+    :param ssh_hook: predefined ssh_hook to use for remote execution.
+        Either `ssh_hook` or `ssh_conn_id` needs to be provided.
     :type ssh_hook: :class:`SSHHook`
-    :param ssh_conn_id: connection id from airflow Connections
+    :param ssh_conn_id: connection id from airflow Connections.
+        `ssh_conn_id` will be ingored if `ssh_hook` is provided.
     :type ssh_conn_id: str
     :param remote_host: remote host to connect (templated)
+        Nullable. If provided, it will replace the `remote_host` which was
+        defined in `ssh_hook` or predefined in the connection of `ssh_conn_id`.
     :type remote_host: str
     :param command: command to execute on remote host. (templated)
     :type command: str
@@ -68,14 +72,22 @@ def __init__(self,
 
     def execute(self, context):
         try:
-            if self.ssh_conn_id and not self.ssh_hook:
-                self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id,
-                                        timeout=self.timeout)
+            if self.ssh_conn_id:
+                if self.ssh_hook and isinstance(self.ssh_hook, SSHHook):
+                    self.log.info("ssh_conn_id is ignored when ssh_hook is provided.")
+                else:
+                    self.log.info("ssh_hook is not provided or invalid. " +
+                                  "Trying ssh_conn_id to create SSHHook.")
+                    self.ssh_hook = SSHHook(ssh_conn_id=self.ssh_conn_id,
+                                            timeout=self.timeout)
 
             if not self.ssh_hook:
                 raise AirflowException("Cannot operate without ssh_hook or ssh_conn_id.")
 
             if self.remote_host is not None:
+                self.log.info("remote_host is provided explicitly. " +
+                              "It will replace the remote_host which was defined " +
+                              "in ssh_hook or predefined in connection of ssh_conn_id.")
                 self.ssh_hook.remote_host = self.remote_host
 
             if not self.command:
diff --git a/tests/contrib/operators/test_sftp_operator.py b/tests/contrib/operators/test_sftp_operator.py
index 01446a6fddd49..5770c1b940eb5 100644
--- a/tests/contrib/operators/test_sftp_operator.py
+++ b/tests/contrib/operators/test_sftp_operator.py
@@ -20,6 +20,7 @@
 import os
 import unittest
 from base64 import b64encode
+import six
 
 from airflow import configuration
 from airflow import models
@@ -219,6 +220,71 @@ def test_json_file_transfer_get(self):
         self.assertEqual(content_received.strip(),
             test_remote_file_content.encode('utf-8').decode('utf-8'))
 
+    def test_arg_checking(self):
+        from airflow.exceptions import AirflowException
+        conn_id = "conn_id_for_testing"
+        os.environ['AIRFLOW_CONN_' + conn_id.upper()] = "ssh://test_id@localhost"
+
+        # Exception should be raised if neither ssh_hook nor ssh_conn_id is provided
+        if six.PY2:
+            self.assertRaisesRegex = self.assertRaisesRegexp
+        with self.assertRaisesRegex(AirflowException,
+                                    "Cannot operate without ssh_hook or ssh_conn_id."):
+            task_0 = SFTPOperator(
+                task_id="test_sftp",
+                local_filepath=self.test_local_filepath,
+                remote_filepath=self.test_remote_filepath,
+                operation=SFTPOperation.PUT,
+                dag=self.dag
+            )
+            task_0.execute(None)
+
+        # if ssh_hook is invalid/not provided, use ssh_conn_id to create SSHHook
+        task_1 = SFTPOperator(
+            task_id="test_sftp",
+            ssh_hook="string_rather_than_SSHHook",  # invalid ssh_hook
+            ssh_conn_id=conn_id,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.PUT,
+            dag=self.dag
+        )
+        try:
+            task_1.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_1.ssh_hook.ssh_conn_id, conn_id)
+
+        task_2 = SFTPOperator(
+            task_id="test_sftp",
+            ssh_conn_id=conn_id,  # no ssh_hook provided
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.PUT,
+            dag=self.dag
+        )
+        try:
+            task_2.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_2.ssh_hook.ssh_conn_id, conn_id)
+
+        # if both valid ssh_hook and ssh_conn_id are provided, ignore ssh_conn_id
+        task_3 = SFTPOperator(
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            ssh_conn_id=conn_id,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.PUT,
+            dag=self.dag
+        )
+        try:
+            task_3.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_3.ssh_hook.ssh_conn_id, self.hook.ssh_conn_id)
+
     def delete_local_resource(self):
         if os.path.exists(self.test_local_filepath):
             os.remove(self.test_local_filepath)
@@ -226,11 +292,11 @@ def delete_local_resource(self):
     def delete_remote_resource(self):
         # check the remote file content
         remove_file_task = SSHOperator(
-                task_id="test_check_file",
-                ssh_hook=self.hook,
-                command="rm {0}".format(self.test_remote_filepath),
-                do_xcom_push=True,
-                dag=self.dag
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="rm {0}".format(self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
         )
         self.assertIsNotNone(remove_file_task)
         ti3 = TaskInstance(task=remove_file_task, execution_date=timezone.utcnow())
diff --git a/tests/contrib/operators/test_ssh_operator.py b/tests/contrib/operators/test_ssh_operator.py
index 7ddd24b2ac2ca..1a2c788596671 100644
--- a/tests/contrib/operators/test_ssh_operator.py
+++ b/tests/contrib/operators/test_ssh_operator.py
@@ -19,6 +19,7 @@
 
 import unittest
 from base64 import b64encode
+import six
 
 from airflow import configuration
 from airflow import models
@@ -148,6 +149,65 @@ def test_no_output_command(self):
         self.assertIsNotNone(ti.duration)
         self.assertEqual(ti.xcom_pull(task_ids='test', key='return_value'), b'')
 
+    def test_arg_checking(self):
+        import os
+        from airflow.exceptions import AirflowException
+        conn_id = "conn_id_for_testing"
+        TIMEOUT = 5
+        os.environ['AIRFLOW_CONN_' + conn_id.upper()] = "ssh://test_id@localhost"
+
+        # Exception should be raised if neither ssh_hook nor ssh_conn_id is provided
+        if six.PY2:
+            self.assertRaisesRegex = self.assertRaisesRegexp
+        with self.assertRaisesRegex(AirflowException,
+                                    "Cannot operate without ssh_hook or ssh_conn_id."):
+            task_0 = SSHOperator(task_id="test", command="echo -n airflow",
+                                 timeout=TIMEOUT, dag=self.dag)
+            task_0.execute(None)
+
+        # if ssh_hook is invalid/not provided, use ssh_conn_id to create SSHHook
+        task_1 = SSHOperator(
+            task_id="test_1",
+            ssh_hook="string_rather_than_SSHHook",  # invalid ssh_hook
+            ssh_conn_id=conn_id,
+            command="echo -n airflow",
+            timeout=TIMEOUT,
+            dag=self.dag
+        )
+        try:
+            task_1.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_1.ssh_hook.ssh_conn_id, conn_id)
+
+        task_2 = SSHOperator(
+            task_id="test_2",
+            ssh_conn_id=conn_id,  # no ssh_hook provided
+            command="echo -n airflow",
+            timeout=TIMEOUT,
+            dag=self.dag
+        )
+        try:
+            task_2.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_2.ssh_hook.ssh_conn_id, conn_id)
+
+        # if both valid ssh_hook and ssh_conn_id are provided, ignore ssh_conn_id
+        task_3 = SSHOperator(
+            task_id="test_3",
+            ssh_hook=self.hook,
+            ssh_conn_id=conn_id,
+            command="echo -n airflow",
+            timeout=TIMEOUT,
+            dag=self.dag
+        )
+        try:
+            task_3.execute(None)
+        except Exception:
+            pass
+        self.assertEqual(task_3.ssh_hook.ssh_conn_id, self.hook.ssh_conn_id)
+
 
 if __name__ == '__main__':
     unittest.main()

From 61ec04895b806c6cf8e0cb5255d11cce2884eb44 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 3 Dec 2018 12:39:46 +0000
Subject: [PATCH 262/808] [AIRFLOW-3434] Allows creating intermediate dirs in
 SFTPOperator (#4270)

---
 airflow/contrib/operators/sftp_operator.py    |  62 +++++-
 tests/contrib/operators/test_sftp_operator.py | 195 ++++++++++++++++--
 2 files changed, 238 insertions(+), 19 deletions(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index a3b5c1f24492b..f04006a497d33 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -16,6 +16,8 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+import os
+
 from airflow.contrib.hooks.ssh_hook import SSHHook
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
@@ -48,9 +50,28 @@ class SFTPOperator(BaseOperator):
     :param remote_filepath: remote file path to get or put. (templated)
     :type remote_filepath: str
     :param operation: specify operation 'get' or 'put', defaults to put
-    :type get: bool
+    :type operation: str
     :param confirm: specify if the SFTP operation should be confirmed, defaults to True
     :type confirm: bool
+    :param create_intermediate_dirs: create missing intermediate directories when
+        copying from remote to local and vice-versa. Default is False.
+
+        Example: The following task would copy ``file.txt`` to the remote host
+        at ``/tmp/tmp1/tmp2/`` while creating ``tmp``,``tmp1`` and ``tmp2`` if they
+        don't exist. If the parameter is not passed it would error as the directory
+        does not exist. ::
+
+            put_file = SFTPOperator(
+                task_id="test_sftp",
+                ssh_conn="ssh_default",
+                local_filepath="/tmp/file.txt",
+                remote_filepath="/tmp/tmp1/tmp2/file.txt",
+                operation="put",
+                create_intermediate_dirs=True,
+                dag=dag
+            )
+
+    :type create_intermediate_dirs: bool
     """
     template_fields = ('local_filepath', 'remote_filepath', 'remote_host')
 
@@ -63,6 +84,7 @@ def __init__(self,
                  remote_filepath=None,
                  operation=SFTPOperation.PUT,
                  confirm=True,
+                 create_intermediate_dirs=False,
                  *args,
                  **kwargs):
         super(SFTPOperator, self).__init__(*args, **kwargs)
@@ -73,6 +95,7 @@ def __init__(self,
         self.remote_filepath = remote_filepath
         self.operation = operation
         self.confirm = confirm
+        self.create_intermediate_dirs = create_intermediate_dirs
         if not (self.operation.lower() == SFTPOperation.GET or
                 self.operation.lower() == SFTPOperation.PUT):
             raise TypeError("unsupported operation value {0}, expected {1} or {2}"
@@ -101,11 +124,25 @@ def execute(self, context):
             with self.ssh_hook.get_conn() as ssh_client:
                 sftp_client = ssh_client.open_sftp()
                 if self.operation.lower() == SFTPOperation.GET:
+                    local_folder = os.path.dirname(self.local_filepath)
+                    if self.create_intermediate_dirs:
+                        # Create Intermediate Directories if it doesn't exist
+                        try:
+                            os.makedirs(local_folder)
+                        except OSError:
+                            if not os.path.isdir(local_folder):
+                                raise
                     file_msg = "from {0} to {1}".format(self.remote_filepath,
                                                         self.local_filepath)
                     self.log.debug("Starting to transfer %s", file_msg)
                     sftp_client.get(self.remote_filepath, self.local_filepath)
                 else:
+                    remote_folder = os.path.dirname(self.remote_filepath)
+                    if self.create_intermediate_dirs:
+                        _make_intermediate_dirs(
+                            sftp_client=sftp_client,
+                            remote_directory=remote_folder,
+                        )
                     file_msg = "from {0} to {1}".format(self.local_filepath,
                                                         self.remote_filepath)
                     self.log.debug("Starting to transfer file %s", file_msg)
@@ -118,3 +155,26 @@ def execute(self, context):
                                    .format(file_msg, str(e)))
 
         return None
+
+
+def _make_intermediate_dirs(sftp_client, remote_directory):
+    """
+    Create all the intermediate directories in a remote host
+
+    :param sftp_client: A Paramiko SFTP client.
+    :param remote_directory: Absolute Path of the directory containing the file
+    :return:
+    """
+    if remote_directory == '/':
+        sftp_client.chdir('/')
+        return
+    if remote_directory == '':
+        return
+    try:
+        sftp_client.chdir(remote_directory)
+    except IOError:
+        dirname, basename = os.path.split(remote_directory.rstrip('/'))
+        _make_intermediate_dirs(sftp_client, dirname)
+        sftp_client.mkdir(basename)
+        sftp_client.chdir(basename)
+        return
diff --git a/tests/contrib/operators/test_sftp_operator.py b/tests/contrib/operators/test_sftp_operator.py
index 5770c1b940eb5..0877b216f60ab 100644
--- a/tests/contrib/operators/test_sftp_operator.py
+++ b/tests/contrib/operators/test_sftp_operator.py
@@ -61,12 +61,20 @@ def setUp(self):
         self.hook = hook
         self.dag = dag
         self.test_dir = "/tmp"
+        self.test_local_dir = "/tmp/tmp2"
+        self.test_remote_dir = "/tmp/tmp1"
         self.test_local_filename = 'test_local_file'
         self.test_remote_filename = 'test_remote_file'
         self.test_local_filepath = '{0}/{1}'.format(self.test_dir,
                                                     self.test_local_filename)
+        # Local Filepath with Intermediate Directory
+        self.test_local_filepath_int_dir = '{0}/{1}'.format(self.test_local_dir,
+                                                            self.test_local_filename)
         self.test_remote_filepath = '{0}/{1}'.format(self.test_dir,
                                                      self.test_remote_filename)
+        # Remote Filepath with Intermediate Directory
+        self.test_remote_filepath_int_dir = '{0}/{1}'.format(self.test_remote_dir,
+                                                             self.test_remote_filename)
 
     def test_pickle_file_transfer_put(self):
         configuration.conf.set("core", "enable_xcom_pickling", "True")
@@ -79,12 +87,13 @@ def test_pickle_file_transfer_put(self):
 
         # put test file to remote
         put_test_task = SFTPOperator(
-                task_id="test_sftp",
-                ssh_hook=self.hook,
-                local_filepath=self.test_local_filepath,
-                remote_filepath=self.test_remote_filepath,
-                operation=SFTPOperation.PUT,
-                dag=self.dag
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.PUT,
+            create_intermediate_dirs=True,
+            dag=self.dag
         )
         self.assertIsNotNone(put_test_task)
         ti2 = TaskInstance(task=put_test_task, execution_date=timezone.utcnow())
@@ -105,6 +114,71 @@ def test_pickle_file_transfer_put(self):
                 ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
                 test_local_file_content)
 
+    def test_file_transfer_no_intermediate_dir_error_put(self):
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_local_file_content = \
+            b"This is local file content \n which is multiline " \
+            b"continuing....with other character\nanother line here \n this is last line"
+        # create a test file locally
+        with open(self.test_local_filepath, 'wb') as f:
+            f.write(test_local_file_content)
+
+        # Try to put test file to remote
+        # This should raise an error with "No such file" as the directory
+        # does not exist
+        with self.assertRaises(Exception) as error:
+            put_test_task = SFTPOperator(
+                task_id="test_sftp",
+                ssh_hook=self.hook,
+                local_filepath=self.test_local_filepath,
+                remote_filepath=self.test_remote_filepath_int_dir,
+                operation=SFTPOperation.PUT,
+                create_intermediate_dirs=False,
+                dag=self.dag
+            )
+            self.assertIsNotNone(put_test_task)
+            ti2 = TaskInstance(task=put_test_task, execution_date=timezone.utcnow())
+            ti2.run()
+        self.assertIn('No such file', str(error.exception))
+
+    def test_file_transfer_with_intermediate_dir_put(self):
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_local_file_content = \
+            b"This is local file content \n which is multiline " \
+            b"continuing....with other character\nanother line here \n this is last line"
+        # create a test file locally
+        with open(self.test_local_filepath, 'wb') as f:
+            f.write(test_local_file_content)
+
+        # put test file to remote
+        put_test_task = SFTPOperator(
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath_int_dir,
+            operation=SFTPOperation.PUT,
+            create_intermediate_dirs=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(put_test_task)
+        ti2 = TaskInstance(task=put_test_task, execution_date=timezone.utcnow())
+        ti2.run()
+
+        # check the remote file content
+        check_file_task = SSHOperator(
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="cat {0}".format(self.test_remote_filepath_int_dir),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(check_file_task)
+        ti3 = TaskInstance(task=check_file_task, execution_date=timezone.utcnow())
+        ti3.run()
+        self.assertEqual(
+            ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
+            test_local_file_content)
+
     def test_json_file_transfer_put(self):
         configuration.conf.set("core", "enable_xcom_pickling", "False")
         test_local_file_content = \
@@ -220,6 +294,81 @@ def test_json_file_transfer_get(self):
         self.assertEqual(content_received.strip(),
             test_remote_file_content.encode('utf-8').decode('utf-8'))
 
+    def test_file_transfer_no_intermediate_dir_error_get(self):
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_remote_file_content = \
+            "This is remote file content \n which is also multiline " \
+            "another line here \n this is last line. EOF"
+
+        # create a test file remotely
+        create_file_task = SSHOperator(
+            task_id="test_create_file",
+            ssh_hook=self.hook,
+            command="echo '{0}' > {1}".format(test_remote_file_content,
+                                              self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(create_file_task)
+        ti1 = TaskInstance(task=create_file_task, execution_date=timezone.utcnow())
+        ti1.run()
+
+        # Try to GET test file from remote
+        # This should raise an error with "No such file" as the directory
+        # does not exist
+        with self.assertRaises(Exception) as error:
+            get_test_task = SFTPOperator(
+                task_id="test_sftp",
+                ssh_hook=self.hook,
+                local_filepath=self.test_local_filepath_int_dir,
+                remote_filepath=self.test_remote_filepath,
+                operation=SFTPOperation.GET,
+                dag=self.dag
+            )
+            self.assertIsNotNone(get_test_task)
+            ti2 = TaskInstance(task=get_test_task, execution_date=timezone.utcnow())
+            ti2.run()
+        self.assertIn('No such file', str(error.exception))
+
+    def test_file_transfer_with_intermediate_dir_error_get(self):
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_remote_file_content = \
+            "This is remote file content \n which is also multiline " \
+            "another line here \n this is last line. EOF"
+
+        # create a test file remotely
+        create_file_task = SSHOperator(
+            task_id="test_create_file",
+            ssh_hook=self.hook,
+            command="echo '{0}' > {1}".format(test_remote_file_content,
+                                              self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(create_file_task)
+        ti1 = TaskInstance(task=create_file_task, execution_date=timezone.utcnow())
+        ti1.run()
+
+        # get remote file to local
+        get_test_task = SFTPOperator(
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath_int_dir,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.GET,
+            create_intermediate_dirs=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(get_test_task)
+        ti2 = TaskInstance(task=get_test_task, execution_date=timezone.utcnow())
+        ti2.run()
+
+        # test the received content
+        content_received = None
+        with open(self.test_local_filepath_int_dir, 'r') as f:
+            content_received = f.read()
+        self.assertEqual(content_received.strip(), test_remote_file_content)
+
     def test_arg_checking(self):
         from airflow.exceptions import AirflowException
         conn_id = "conn_id_for_testing"
@@ -288,22 +437,32 @@ def test_arg_checking(self):
     def delete_local_resource(self):
         if os.path.exists(self.test_local_filepath):
             os.remove(self.test_local_filepath)
+        if os.path.exists(self.test_local_filepath_int_dir):
+            os.remove(self.test_local_filepath_int_dir)
+        if os.path.exists(self.test_local_dir):
+            os.rmdir(self.test_local_dir)
 
     def delete_remote_resource(self):
-        # check the remote file content
-        remove_file_task = SSHOperator(
-            task_id="test_check_file",
-            ssh_hook=self.hook,
-            command="rm {0}".format(self.test_remote_filepath),
-            do_xcom_push=True,
-            dag=self.dag
-        )
-        self.assertIsNotNone(remove_file_task)
-        ti3 = TaskInstance(task=remove_file_task, execution_date=timezone.utcnow())
-        ti3.run()
+        if os.path.exists(self.test_remote_filepath):
+            # check the remote file content
+            remove_file_task = SSHOperator(
+                task_id="test_check_file",
+                ssh_hook=self.hook,
+                command="rm {0}".format(self.test_remote_filepath),
+                do_xcom_push=True,
+                dag=self.dag
+            )
+            self.assertIsNotNone(remove_file_task)
+            ti3 = TaskInstance(task=remove_file_task, execution_date=timezone.utcnow())
+            ti3.run()
+        if os.path.exists(self.test_remote_filepath_int_dir):
+            os.remove(self.test_remote_filepath_int_dir)
+        if os.path.exists(self.test_remote_dir):
+            os.rmdir(self.test_remote_dir)
 
     def tearDown(self):
-        self.delete_local_resource() and self.delete_remote_resource()
+        self.delete_local_resource()
+        self.delete_remote_resource()
 
 
 if __name__ == '__main__':

From 742b60511365dd489416de7319c62c14a005d771 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Thu, 15 Nov 2018 06:16:08 +0800
Subject: [PATCH 263/808] [AIRFLOW-3309] Add MongoDB connection (#4154)

---
 airflow/contrib/hooks/mongo_hook.py | 2 +-
 airflow/models.py                   | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index 6ae71a8c8d461..f66ae54a1c523 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -27,7 +27,7 @@ class MongoHook(BaseHook):
     ex.
         {replicaSet: test, ssl: True, connectTimeoutMS: 30000}
     """
-    conn_type = 'MongoDb'
+    conn_type = 'mongo'
 
     def __init__(self, conn_id='mongo_default', *args, **kwargs):
         super(MongoHook, self).__init__(source='mongo')
diff --git a/airflow/models.py b/airflow/models.py
index 02244cb187a96..ce0f414d26803 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -654,6 +654,7 @@ class Connection(Base, LoggingMixin):
         ('azure_data_lake', 'Azure Data Lake'),
         ('cassandra', 'Cassandra',),
         ('qubole', 'Qubole'),
+        ('mongo', 'MongoDB'),
         ('gcpcloudsql', 'Google Cloud SQL'),
     ]
 
@@ -795,6 +796,9 @@ def get_hook(self):
             elif self.conn_type == 'cassandra':
                 from airflow.contrib.hooks.cassandra_hook import CassandraHook
                 return CassandraHook(cassandra_conn_id=self.conn_id)
+            elif self.conn_type == 'mongo':
+                from airflow.contrib.hooks.mongo_hook import MongoHook
+                return MongoHook(conn_id=self.conn_id)
             elif self.conn_type == 'gcpcloudsql':
                 from airflow.contrib.hooks.gcp_sql_hook import CloudSqlDatabaseHook
                 return CloudSqlDatabaseHook(gcp_cloudsql_conn_id=self.conn_id)

From b52576d7537543fb9007c32850b3b95e22a6e062 Mon Sep 17 00:00:00 2001
From: yangaws <31293788+yangaws@users.noreply.github.com>
Date: Thu, 6 Dec 2018 11:51:11 -0800
Subject: [PATCH 264/808] [AIRFLOW-2524] Add SageMaker doc to AWS integration
 section (#4278)

---
 docs/integration.rst | 64 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/docs/integration.rst b/docs/integration.rst
index 8fff6e48072a5..5f5fc89bde4fe 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -355,6 +355,70 @@ S3ToRedshiftTransfer
 .. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
 
 
+Amazon SageMaker
+''''''''''''''''
+
+For more instructions on using Amazon SageMaker in Airflow, please see `the SageMaker Python SDK README`_.
+
+.. _the SageMaker Python SDK README: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/workflow/README.rst
+
+- :ref:`SageMakerHook` : Interact with Amazon SageMaker.
+- :ref:`SageMakerTrainingOperator` : Create a SageMaker training job.
+- :ref:`SageMakerTuningOperator` : Create a SageMaker tuning job.
+- :ref:`SageMakerModelOperator` : Create a SageMaker model.
+- :ref:`SageMakerTransformOperator` : Create a SageMaker transform job.
+- :ref:`SageMakerEndpointConfigOperator` : Create a SageMaker endpoint config.
+- :ref:`SageMakerEndpointOperator` : Create a SageMaker endpoint.
+
+.. _SageMakerHook:
+
+SageMakerHook
+"""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
+
+.. _SageMakerTrainingOperator:
+
+SageMakerTrainingOperator
+"""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
+
+.. _SageMakerTuningOperator:
+
+SageMakerTuningOperator
+"""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
+
+.. _SageMakerModelOperator:
+
+SageMakerModelOperator
+""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
+
+.. _SageMakerTransformOperator:
+
+SageMakerTransformOperator
+""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
+
+.. _SageMakerEndpointConfigOperator:
+
+SageMakerEndpointConfigOperator
+"""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
+
+.. _SageMakerEndpointOperator:
+
+SageMakerEndpointOperator
+"""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
+
 .. _Databricks:
 
 Databricks

From bfb287ba1e5cd45e98b98e5c9a8ea079945a1db1 Mon Sep 17 00:00:00 2001
From: Tom Miller <tmiller@microsoft.com>
Date: Thu, 6 Dec 2018 10:18:44 -0800
Subject: [PATCH 265/808] [AIRFLOW-3406] Implement an Azure CosmosDB operator
 (#4265)

Add an operator and hook to manipulate and use Azure
CosmosDB documents, including creation, deletion, and
updating documents and collections.

Includes sensor to detect documents being added to a
collection.
---
 .../example_dags/example_cosmosdb_sensor.py   |  64 ++++
 airflow/contrib/hooks/azure_cosmos_hook.py    | 287 ++++++++++++++++++
 .../azure_cosmos_insertdocument_operator.py   |  69 +++++
 .../contrib/sensors/azure_cosmos_sensor.py    |  67 ++++
 airflow/models.py                             |   4 +
 airflow/utils/db.py                           |   4 +
 docs/integration.rst                          |  29 ++
 setup.py                                      |   6 +-
 tests/contrib/hooks/test_azure_cosmos_hook.py | 202 ++++++++++++
 ...st_azure_cosmos_insertdocument_operator.py |  84 +++++
 10 files changed, 815 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/example_dags/example_cosmosdb_sensor.py
 create mode 100644 airflow/contrib/hooks/azure_cosmos_hook.py
 create mode 100644 airflow/contrib/operators/azure_cosmos_insertdocument_operator.py
 create mode 100644 airflow/contrib/sensors/azure_cosmos_sensor.py
 create mode 100644 tests/contrib/hooks/test_azure_cosmos_hook.py
 create mode 100644 tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py

diff --git a/airflow/contrib/example_dags/example_cosmosdb_sensor.py b/airflow/contrib/example_dags/example_cosmosdb_sensor.py
new file mode 100644
index 0000000000000..a801d9f41ba23
--- /dev/null
+++ b/airflow/contrib/example_dags/example_cosmosdb_sensor.py
@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+This is only an example DAG to highlight usage of AzureCosmosDocumentSensor to detect
+if a document now exists.
+
+You can trigger this manually with `airflow trigger_dag example_cosmosdb_sensor`.
+
+*Note: Make sure that connection `azure_cosmos_default` is properly set before running
+this example.*
+"""
+
+from airflow import DAG
+from airflow.contrib.sensors.azure_cosmos_sensor import AzureCosmosDocumentSensor
+from airflow.contrib.operators.azure_cosmos_insertdocument_operator import AzureCosmosInsertDocumentOperator
+from airflow.utils import dates
+
+default_args = {
+    'owner': 'airflow',
+    'depends_on_past': False,
+    'start_date': dates.days_ago(2),
+    'email': ['airflow@example.com'],
+    'email_on_failure': False,
+    'email_on_retry': False
+}
+
+dag = DAG('example_cosmosdb_sensor', default_args=default_args)
+
+dag.doc_md = __doc__
+
+t1 = AzureCosmosDocumentSensor(
+    task_id='check_cosmos_file',
+    database_name='airflow_example_db',
+    collection_name='airflow_example_coll',
+    document_id='airflow_checkid',
+    azure_cosmos_conn_id='azure_cosmos_default',
+    dag=dag)
+
+t2 = AzureCosmosInsertDocumentOperator(
+    task_id='insert_cosmos_file',
+    dag=dag,
+    database_name='airflow_example_db',
+    collection_name='new-collection',
+    document={"id": "someuniqueid", "param1": "value1", "param2": "value2"},
+    azure_cosmos_conn_id='azure_cosmos_default')
+
+t2.set_upstream(t1)
diff --git a/airflow/contrib/hooks/azure_cosmos_hook.py b/airflow/contrib/hooks/azure_cosmos_hook.py
new file mode 100644
index 0000000000000..01b4007b0308f
--- /dev/null
+++ b/airflow/contrib/hooks/azure_cosmos_hook.py
@@ -0,0 +1,287 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import azure.cosmos.cosmos_client as cosmos_client
+from azure.cosmos.errors import HTTPFailure
+import uuid
+
+from airflow.exceptions import AirflowBadRequest
+from airflow.hooks.base_hook import BaseHook
+
+
+class AzureCosmosDBHook(BaseHook):
+    """
+    Interacts with Azure CosmosDB.
+
+    login should be the endpoint uri, password should be the master key
+    optionally, you can use the following extras to default these values
+    {"database_name": "<DATABASE_NAME>", "collection_name": "COLLECTION_NAME"}.
+
+    :param azure_cosmos_conn_id: Reference to the Azure CosmosDB connection.
+    :type azure_cosmos_conn_id: str
+    """
+
+    def __init__(self, azure_cosmos_conn_id='azure_cosmos_default'):
+        self.conn_id = azure_cosmos_conn_id
+        self.connection = self.get_connection(self.conn_id)
+        self.extras = self.connection.extra_dejson
+
+        self.endpoint_uri = self.connection.login
+        self.master_key = self.connection.password
+        self.default_database_name = self.extras.get('database_name')
+        self.default_collection_name = self.extras.get('collection_name')
+        self.cosmos_client = None
+
+    def get_conn(self):
+        """
+        Return a cosmos db client.
+        """
+        if self.cosmos_client is not None:
+            return self.cosmos_client
+
+        # Initialize the Python Azure Cosmos DB client
+        self.cosmos_client = cosmos_client.CosmosClient(self.endpoint_uri, {'masterKey': self.master_key})
+
+        return self.cosmos_client
+
+    def __get_database_name(self, database_name=None):
+        db_name = database_name
+        if db_name is None:
+            db_name = self.default_database_name
+
+        if db_name is None:
+            raise AirflowBadRequest("Database name must be specified")
+
+        return db_name
+
+    def __get_collection_name(self, collection_name=None):
+        coll_name = collection_name
+        if coll_name is None:
+            coll_name = self.default_collection_name
+
+        if coll_name is None:
+            raise AirflowBadRequest("Collection name must be specified")
+
+        return coll_name
+
+    def does_collection_exist(self, collection_name, database_name=None):
+        """
+        Checks if a collection exists in CosmosDB.
+        """
+        if collection_name is None:
+            raise AirflowBadRequest("Collection name cannot be None.")
+
+        existing_container = list(self.get_conn().QueryContainers(
+            get_database_link(self.__get_database_name(database_name)), {
+                "query": "SELECT * FROM r WHERE r.id=@id",
+                "parameters": [
+                    {"name": "@id", "value": collection_name}
+                ]
+            }))
+        if len(existing_container) == 0:
+            return False
+
+        return True
+
+    def create_collection(self, collection_name, database_name=None):
+        """
+        Creates a new collection in the CosmosDB database.
+        """
+        if collection_name is None:
+            raise AirflowBadRequest("Collection name cannot be None.")
+
+        # We need to check to see if this container already exists so we don't try
+        # to create it twice
+        existing_container = list(self.get_conn().QueryContainers(
+            get_database_link(self.__get_database_name(database_name)), {
+                "query": "SELECT * FROM r WHERE r.id=@id",
+                "parameters": [
+                    {"name": "@id", "value": collection_name}
+                ]
+            }))
+
+        # Only create if we did not find it already existing
+        if len(existing_container) == 0:
+            self.get_conn().CreateContainer(
+                get_database_link(self.__get_database_name(database_name)),
+                {"id": collection_name})
+
+    def does_database_exist(self, database_name):
+        """
+        Checks if a database exists in CosmosDB.
+        """
+        if database_name is None:
+            raise AirflowBadRequest("Database name cannot be None.")
+
+        existing_database = list(self.get_conn().QueryDatabases({
+            "query": "SELECT * FROM r WHERE r.id=@id",
+            "parameters": [
+                {"name": "@id", "value": database_name}
+            ]
+        }))
+        if len(existing_database) == 0:
+            return False
+
+        return True
+
+    def create_database(self, database_name):
+        """
+        Creates a new database in CosmosDB.
+        """
+        if database_name is None:
+            raise AirflowBadRequest("Database name cannot be None.")
+
+        # We need to check to see if this database already exists so we don't try
+        # to create it twice
+        existing_database = list(self.get_conn().QueryDatabases({
+            "query": "SELECT * FROM r WHERE r.id=@id",
+            "parameters": [
+                {"name": "@id", "value": database_name}
+            ]
+        }))
+
+        # Only create if we did not find it already existing
+        if len(existing_database) == 0:
+            self.get_conn().CreateDatabase({"id": database_name})
+
+    def delete_database(self, database_name):
+        """
+        Deletes an existing database in CosmosDB.
+        """
+        if database_name is None:
+            raise AirflowBadRequest("Database name cannot be None.")
+
+        self.get_conn().DeleteDatabase(get_database_link(database_name))
+
+    def delete_collection(self, collection_name, database_name=None):
+        """
+        Deletes an existing collection in the CosmosDB database.
+        """
+        if collection_name is None:
+            raise AirflowBadRequest("Collection name cannot be None.")
+
+        self.get_conn().DeleteContainer(
+            get_collection_link(self.__get_database_name(database_name), collection_name))
+
+    def upsert_document(self, document, database_name=None, collection_name=None, document_id=None):
+        """
+        Inserts a new document (or updates an existing one) into an existing
+        collection in the CosmosDB database.
+        """
+        # Assign unique ID if one isn't provided
+        if document_id is None:
+            document_id = str(uuid.uuid4())
+
+        if document is None:
+            raise AirflowBadRequest("You cannot insert a None document")
+
+        # Add document id if isn't found
+        if 'id' in document:
+            if document['id'] is None:
+                document['id'] = document_id
+        else:
+            document['id'] = document_id
+
+        created_document = self.get_conn().CreateItem(
+            get_collection_link(
+                self.__get_database_name(database_name),
+                self.__get_collection_name(collection_name)),
+            document)
+
+        return created_document
+
+    def insert_documents(self, documents, database_name=None, collection_name=None):
+        """
+        Insert a list of new documents into an existing collection in the CosmosDB database.
+        """
+        if documents is None:
+            raise AirflowBadRequest("You cannot insert empty documents")
+
+        created_documents = []
+        for single_document in documents:
+            created_documents.append(
+                self.get_conn().CreateItem(
+                    get_collection_link(
+                        self.__get_database_name(database_name),
+                        self.__get_collection_name(collection_name)),
+                    single_document))
+
+        return created_documents
+
+    def delete_document(self, document_id, database_name=None, collection_name=None):
+        """
+        Delete an existing document out of a collection in the CosmosDB database.
+        """
+        if document_id is None:
+            raise AirflowBadRequest("Cannot delete a document without an id")
+
+        self.get_conn().DeleteItem(
+            get_document_link(
+                self.__get_database_name(database_name),
+                self.__get_collection_name(collection_name),
+                document_id))
+
+    def get_document(self, document_id, database_name=None, collection_name=None):
+        """
+        Get a document from an existing collection in the CosmosDB database.
+        """
+        if document_id is None:
+            raise AirflowBadRequest("Cannot get a document without an id")
+
+        try:
+            return self.get_conn().ReadItem(
+                get_document_link(
+                    self.__get_database_name(database_name),
+                    self.__get_collection_name(collection_name),
+                    document_id))
+        except HTTPFailure:
+            return None
+
+    def get_documents(self, sql_string, database_name=None, collection_name=None, partition_key=None):
+        """
+        Get a list of documents from an existing collection in the CosmosDB database via SQL query.
+        """
+        if sql_string is None:
+            raise AirflowBadRequest("SQL query string cannot be None")
+
+        # Query them in SQL
+        query = {'query': sql_string}
+
+        try:
+            result_iterable = self.get_conn().QueryItems(
+                get_collection_link(
+                    self.__get_database_name(database_name),
+                    self.__get_collection_name(collection_name)),
+                query,
+                partition_key)
+
+            return list(result_iterable)
+        except HTTPFailure:
+            return None
+
+
+def get_database_link(database_id):
+    return "dbs/" + database_id
+
+
+def get_collection_link(database_id, collection_id):
+    return get_database_link(database_id) + "/colls/" + collection_id
+
+
+def get_document_link(database_id, collection_id, document_id):
+    return get_collection_link(database_id, collection_id) + "/docs/" + document_id
diff --git a/airflow/contrib/operators/azure_cosmos_insertdocument_operator.py b/airflow/contrib/operators/azure_cosmos_insertdocument_operator.py
new file mode 100644
index 0000000000000..930ff402d0507
--- /dev/null
+++ b/airflow/contrib/operators/azure_cosmos_insertdocument_operator.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class AzureCosmosInsertDocumentOperator(BaseOperator):
+    """
+    Inserts a new document into the specified Cosmos database and collection
+    It will create both the database and collection if they do not already exist
+
+    :param database_name: The name of the database. (templated)
+    :type database_name: str
+    :param collection_name: The name of the collection. (templated)
+    :type collection_name: str
+    :param document: The document to insert
+    :type document: json
+    :param azure_cosmos_conn_id: reference to a CosmosDB connection.
+    :type azure_cosmos_conn_id: str
+    """
+    template_fields = ('database_name', 'collection_name')
+    ui_color = '#e4f0e8'
+
+    @apply_defaults
+    def __init__(self,
+                 database_name,
+                 collection_name,
+                 document,
+                 azure_cosmos_conn_id='azure_cosmos_default',
+                 *args,
+                 **kwargs):
+        super(AzureCosmosInsertDocumentOperator, self).__init__(*args, **kwargs)
+        self.database_name = database_name
+        self.collection_name = collection_name
+        self.document = document
+        self.azure_cosmos_conn_id = azure_cosmos_conn_id
+
+    def execute(self, context):
+        # Create the hook
+        hook = AzureCosmosDBHook(azure_cosmos_conn_id=self.azure_cosmos_conn_id)
+
+        # Create the DB if it doesn't already exist
+        if (not hook.does_database_exist(self.database_name)):
+            hook.create_database(self.database_name)
+
+        # Create the collection as well
+        if (not hook.does_collection_exist(self.collection_name, self.database_name)):
+            hook.create_collection(self.collection_name, self.database_name)
+
+        # finally insert the document
+        hook.upsert_document(self.document, self.database_name, self.collection_name)
diff --git a/airflow/contrib/sensors/azure_cosmos_sensor.py b/airflow/contrib/sensors/azure_cosmos_sensor.py
new file mode 100644
index 0000000000000..78b340d4efe53
--- /dev/null
+++ b/airflow/contrib/sensors/azure_cosmos_sensor.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class AzureCosmosDocumentSensor(BaseSensorOperator):
+    """
+    Checks for the existence of a document which
+    matches the given query in CosmosDB. Example:
+
+    >>> azure_cosmos_sensor = AzureCosmosDocumentSensor(database_name="somedatabase_name",
+    ...                            collection_name="somecollection_name",
+    ...                            document_id="unique-doc-id",
+    ...                            azure_cosmos_conn_id="azure_cosmos_default",
+    ...                            task_id="azure_cosmos_sensor")
+    """
+    template_fields = ('database_name', 'collection_name', 'document_id')
+
+    @apply_defaults
+    def __init__(
+            self,
+            database_name,
+            collection_name,
+            document_id,
+            azure_cosmos_conn_id="azure_cosmos_default",
+            *args,
+            **kwargs):
+        """
+        Create a new AzureCosmosDocumentSensor
+
+        :param database_name: Target CosmosDB database_name.
+        :type database_name: str
+        :param collection_name: Target CosmosDB collection_name.
+        :type collection_name: str
+        :param document_id: The ID of the target document.
+        :type query: str
+        :param azure_cosmos_conn_id: Reference to the Azure CosmosDB connection.
+        :type azure_cosmos_conn_id: str
+        """
+        super(AzureCosmosDocumentSensor, self).__init__(*args, **kwargs)
+        self.azure_cosmos_conn_id = azure_cosmos_conn_id
+        self.database_name = database_name
+        self.collection_name = collection_name
+        self.document_id = document_id
+
+    def poke(self, context):
+        self.log.info("*** Intering poke")
+        hook = AzureCosmosDBHook(self.azure_cosmos_conn_id)
+        return hook.get_document(self.document_id, self.database_name, self.collection_name) is not None
diff --git a/airflow/models.py b/airflow/models.py
index ce0f414d26803..d2c955bc35010 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -652,6 +652,7 @@ class Connection(Base, LoggingMixin):
         ('snowflake', 'Snowflake',),
         ('segment', 'Segment',),
         ('azure_data_lake', 'Azure Data Lake'),
+        ('azure_cosmos', 'Azure CosmosDB'),
         ('cassandra', 'Cassandra',),
         ('qubole', 'Qubole'),
         ('mongo', 'MongoDB'),
@@ -793,6 +794,9 @@ def get_hook(self):
             elif self.conn_type == 'azure_data_lake':
                 from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
                 return AzureDataLakeHook(azure_data_lake_conn_id=self.conn_id)
+            elif self.conn_type == 'azure_cosmos':
+                from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+                return AzureCosmosDBHook(azure_cosmos_conn_id=self.conn_id)
             elif self.conn_type == 'cassandra':
                 from airflow.contrib.hooks.cassandra_hook import CassandraHook
                 return CassandraHook(cassandra_conn_id=self.conn_id)
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 4697605815682..74317a59c7a1f 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -280,6 +280,10 @@ def initdb(rbac=False):
         models.Connection(
             conn_id='azure_data_lake_default', conn_type='azure_data_lake',
             extra='{"tenant": "<TENANT>", "account_name": "<ACCOUNTNAME>" }'))
+    merge_conn(
+        models.Connection(
+            conn_id='azure_cosmos_default', conn_type='azure_cosmos',
+            extra='{"database_name": "<DATABASE_NAME>", "collection_name": "<COLLECTION_NAME>" }'))
     merge_conn(
         models.Connection(
             conn_id='cassandra_default', conn_type='cassandra',
diff --git a/docs/integration.rst b/docs/integration.rst
index 5f5fc89bde4fe..e98d047a58f0c 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -161,6 +161,35 @@ Logging
 Airflow can be configured to read and write task logs in Azure Blob Storage.
 See :ref:`write-logs-azure`.
 
+Azure CosmosDB 
+'''''''''''''''''' 
+ 
+AzureCosmosDBHook communicates via the Azure Cosmos library. Make sure that a 
+Airflow connection of type `azure_cosmos` exists. Authorization can be done by supplying a 
+login (=Endpoint uri), password (=secret key) and extra fields database_name and collection_name to specify the  
+default database and collection to use (see connection `azure_cosmos_default` for an example). 
+ 
+- :ref:`AzureCosmosDBHook`: Interface with Azure CosmosDB. 
+- :ref:`AzureCosmosInsertDocumentOperator`: Simple operator to insert document into CosmosDB. 
+- :ref:`AzureCosmosDocumentSensor`: Simple sensor to detect document existence in CosmosDB. 
+
+.. AzureCosmosDBHook: 
+ 
+AzureCosmosDBHook 
+""""""""" 
+ 
+.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook 
+ 
+AzureCosmosInsertDocumentOperator 
+""""""""" 
+ 
+.. autoclass:: airflow.contrib.operators.azure_cosmos_insertdocument_operator.AzureCosmosInsertDocumentOperator 
+ 
+AzureCosmosDocumentSensor 
+""""""""" 
+ 
+.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor 
+
 Azure Data Lake
 '''''''''''''''
 
diff --git a/setup.py b/setup.py
index f34985c943c04..8a223ee6cb6a1 100644
--- a/setup.py
+++ b/setup.py
@@ -152,6 +152,7 @@ def write_version(filename=os.path.join(*['airflow',
     'azure-mgmt-datalake-store==0.4.0',
     'azure-datalake-store==0.0.19'
 ]
+azure_cosmos = ['azure-cosmos>=3.0.1']
 cassandra = ['cassandra-driver>=3.13.0']
 celery = [
     'celery>=4.1.1, <4.2.0',
@@ -260,10 +261,11 @@ def write_version(filename=os.path.join(*['airflow',
 ]
 devel_minreq = devel + kubernetes + mysql + doc + password + s3 + cgroups
 devel_hadoop = devel_minreq + hive + hdfs + webhdfs + kerberos
+devel_azure = devel_minreq + azure_data_lake + azure_cosmos
 devel_all = (sendgrid + devel + all_dbs + doc + samba + s3 + slack + crypto + oracle +
              docker + ssh + kubernetes + celery + azure_blob_storage + redis + gcp_api +
              datadog + zendesk + jdbc + ldap + kerberos + password + webhdfs + jenkins +
-             druid + pinot + segment + snowflake + elasticsearch + azure_data_lake +
+             druid + pinot + segment + snowflake + elasticsearch + azure_data_lake + azure_cosmos +
              atlas)
 
 # Snakebite & Google Cloud Dataflow are not Python 3 compatible :'(
@@ -338,6 +340,7 @@ def do_setup():
             'async': async_packages,
             'azure_blob_storage': azure_blob_storage,
             'azure_data_lake': azure_data_lake,
+            'azure_cosmos': azure_cosmos,
             'cassandra': cassandra,
             'celery': celery,
             'cgroups': cgroups,
@@ -348,6 +351,7 @@ def do_setup():
             'datadog': datadog,
             'devel': devel_minreq,
             'devel_hadoop': devel_hadoop,
+            'devel_azure': devel_azure,
             'doc': doc,
             'docker': docker,
             'druid': druid,
diff --git a/tests/contrib/hooks/test_azure_cosmos_hook.py b/tests/contrib/hooks/test_azure_cosmos_hook.py
new file mode 100644
index 0000000000000..653242a34b48f
--- /dev/null
+++ b/tests/contrib/hooks/test_azure_cosmos_hook.py
@@ -0,0 +1,202 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+
+import json
+import unittest
+import uuid
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+
+from airflow import configuration
+from airflow import models
+from airflow.utils import db
+
+import logging
+
+try:
+    from unittest import mock
+
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestAzureCosmosDbHook(unittest.TestCase):
+
+    # Set up an environment to test with
+    def setUp(self):
+        # set up some test variables
+        self.test_end_point = 'https://test_endpoint:443'
+        self.test_master_key = 'magic_test_key'
+        self.test_database_name = 'test_database_name'
+        self.test_collection_name = 'test_collection_name'
+        self.test_database_default = 'test_database_default'
+        self.test_collection_default = 'test_collection_default'
+        configuration.load_test_config()
+        db.merge_conn(
+            models.Connection(
+                conn_id='azure_cosmos_test_key_id',
+                conn_type='azure_cosmos',
+                login=self.test_end_point,
+                password=self.test_master_key,
+                extra=json.dumps({'database_name': self.test_database_default,
+                                  'collection_name': self.test_collection_default})
+            )
+        )
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_database(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_database(self.test_database_name)
+        expected_calls = [mock.call().CreateDatabase({'id': self.test_database_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_database_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.create_database, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.create_collection, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_collection(self.test_collection_name, self.test_database_name)
+        expected_calls = [mock.call().CreateContainer(
+            'dbs/test_database_name',
+            {'id': self.test_collection_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container_default(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_collection(self.test_collection_name)
+        expected_calls = [mock.call().CreateContainer(
+            'dbs/test_database_default',
+            {'id': self.test_collection_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_upsert_document_default(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.upsert_document({'id': test_id})
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+            {'id': test_id})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+        logging.getLogger().info(returned_item)
+        self.assertEqual(returned_item['id'], test_id)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_upsert_document(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.upsert_document(
+            {'data1': 'somedata'},
+            database_name=self.test_database_name,
+            collection_name=self.test_collection_name,
+            document_id=test_id)
+
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
+            {'data1': 'somedata', 'id': test_id})]
+
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+        logging.getLogger().info(returned_item)
+        self.assertEqual(returned_item['id'], test_id)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_insert_documents(self, cosmos_mock):
+        test_id1 = str(uuid.uuid4())
+        test_id2 = str(uuid.uuid4())
+        test_id3 = str(uuid.uuid4())
+        documents = [
+            {'id': test_id1, 'data': 'data1'},
+            {'id': test_id2, 'data': 'data2'},
+            {'id': test_id3, 'data': 'data3'}]
+
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.insert_documents(documents)
+        expected_calls = [
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data1', 'id': test_id1}),
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data2', 'id': test_id2}),
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data3', 'id': test_id3})]
+        logging.getLogger().info(returned_item)
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_database(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_database(self.test_database_name)
+        expected_calls = [mock.call().DeleteDatabase('dbs/test_database_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_database_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.delete_database, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.delete_collection, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_collection(self.test_collection_name, self.test_database_name)
+        expected_calls = [mock.call().DeleteContainer('dbs/test_database_name/colls/test_collection_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container_default(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_collection(self.test_collection_name)
+        expected_calls = [mock.call().DeleteContainer('dbs/test_database_default/colls/test_collection_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
new file mode 100644
index 0000000000000..26099d0cb3b57
--- /dev/null
+++ b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+
+import json
+import unittest
+import uuid
+
+from airflow.contrib.operators.azure_cosmos_insertdocument_operator import AzureCosmosInsertDocumentOperator
+
+from airflow import configuration
+from airflow import models
+from airflow.utils import db
+
+try:
+    from unittest import mock
+
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestAzureCosmosDbHook(unittest.TestCase):
+
+    # Set up an environment to test with
+    def setUp(self):
+        # set up some test variables
+        self.test_end_point = 'https://test_endpoint:443'
+        self.test_master_key = 'magic_test_key'
+        self.test_database_name = 'test_database_name'
+        self.test_collection_name = 'test_collection_name'
+        configuration.load_test_config()
+        db.merge_conn(
+            models.Connection(
+                conn_id='azure_cosmos_test_key_id',
+                conn_type='azure_cosmos',
+                login=self.test_end_point,
+                password=self.test_master_key,
+                extra=json.dumps({'database_name': self.test_database_name,
+                                  'collection_name': self.test_collection_name})
+            )
+        )
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_insert_document(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosInsertDocumentOperator(
+            database_name=self.test_database_name,
+            collection_name=self.test_collection_name,
+            document={'id': test_id, 'data': 'sometestdata'},
+            azure_cosmos_conn_id='azure_cosmos_test_key_id',
+            task_id='azure_cosmos_sensor')
+
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
+            {'data': 'sometestdata', 'id': test_id})]
+
+        self.cosmos.execute(None)
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+
+if __name__ == '__main__':
+    unittest.main()

From 9853088632bab7639fc4375399625b728376b949 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 2 Sep 2018 22:27:19 +0100
Subject: [PATCH 266/808] [AIRFLOW-XXX] Fix typo in docstring of gcs_to_bq
 (#3833)

---
 airflow/contrib/operators/gcs_to_bq.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 533cf01de5666..17dfdb48a5b47 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -38,7 +38,7 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
     :type bucket: string
     :param source_objects: List of Google cloud storage URIs to load from. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
-    :type object: list
+    :type source_objects: list of str
     :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
         BigQuery table to load data into. If <project> is not included,
         project will be the project defined in the connection json. (templated)

From ca2c6b7389779f238b47e056e5a1fecd09f039ad Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sat, 8 Dec 2018 09:14:43 +0800
Subject: [PATCH 267/808] [AIRFLOW-3479] Keeps records in Log Table when DAG is
 deleted (#4287)

Users will use either API or web UI to delete DAG (after DAG file is
removed):

- Using API: provide one boolean parameter to let users
             decide if they want to keep records in Log table
             when they delete a DAG.
             Default value it True (to keep records in Log table).
- From UI: will keep records in the Log table when delete records for a
           specific DAG ID (pop-up message is updated accordingly).
---
 airflow/api/common/experimental/delete_dag.py |  12 +-
 airflow/www/templates/airflow/dag.html        |   2 +-
 .../common/experimental/test_delete_dag.py    | 141 ++++++++++++++++++
 3 files changed, 153 insertions(+), 2 deletions(-)
 create mode 100644 tests/api/common/experimental/test_delete_dag.py

diff --git a/airflow/api/common/experimental/delete_dag.py b/airflow/api/common/experimental/delete_dag.py
index b9ce736b48dfc..e7d15772c961f 100644
--- a/airflow/api/common/experimental/delete_dag.py
+++ b/airflow/api/common/experimental/delete_dag.py
@@ -23,7 +23,15 @@
 from airflow.exceptions import DagNotFound, DagFileExists
 
 
-def delete_dag(dag_id):
+def delete_dag(dag_id, keep_records_in_log=True):
+    """
+    :param dag_id: the dag_id of the DAG to delete
+    :type dag_id: str
+    :param keep_records_in_log: whether keep records of the given dag_id
+        in the Log table in the backend database (for reasons like auditing).
+        The default value is True.
+    :type keep_records_in_log: bool
+    """
     session = settings.Session()
 
     DM = models.DagModel
@@ -41,6 +49,8 @@ def delete_dag(dag_id):
     # noinspection PyUnresolvedReferences,PyProtectedMember
     for m in models.Base._decl_class_registry.values():
         if hasattr(m, "dag_id"):
+            if keep_records_in_log and m.__name__ == 'Log':
+                continue
             cond = or_(m.dag_id == dag_id, m.dag_id.like(dag_id + ".%"))
             count += session.query(m).filter(cond).delete(synchronize_session='fetch')
 
diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 9ef4cce5c1c46..d202a977ee56f 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -311,7 +311,7 @@ <h4 class="modal-title" id="dagModalLabel">
 
     function confirmDeleteDag(dag_id){
         return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
-          This option will delete ALL metadata, DAG runs, etc.\n\
+          This option will delete ALL metadata, DAG runs, etc., EXCEPT Log\n\
           This cannot be undone.");
     }
 
diff --git a/tests/api/common/experimental/test_delete_dag.py b/tests/api/common/experimental/test_delete_dag.py
new file mode 100644
index 0000000000000..a012e5d3d0edd
--- /dev/null
+++ b/tests/api/common/experimental/test_delete_dag.py
@@ -0,0 +1,141 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import models
+from airflow import settings
+from airflow.api.common.experimental.delete_dag import delete_dag
+from airflow.exceptions import DagNotFound, DagFileExists
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.utils.dates import days_ago
+from airflow.utils.state import State
+
+DM = models.DagModel
+DS = models.DagStat
+DR = models.DagRun
+TI = models.TaskInstance
+LOG = models.Log
+
+
+class TestDeleteDAGCatchError(unittest.TestCase):
+
+    def setUp(self):
+        self.session = settings.Session()
+        self.dagbag = models.DagBag(include_examples=True)
+        self.dag_id = 'example_bash_operator'
+        self.dag = self.dagbag.dags[self.dag_id]
+
+    def tearDown(self):
+        self.dag.clear()
+        self.session.close()
+
+    def test_delete_dag_non_existent_dag(self):
+        with self.assertRaises(DagNotFound):
+            delete_dag("non-existent DAG")
+
+    def test_delete_dag_dag_still_in_dagbag(self):
+        models_to_check = ['DagModel', 'DagStat', 'DagRun', 'TaskInstance']
+        record_counts = {}
+
+        for model_name in models_to_check:
+            m = getattr(models, model_name)
+            record_counts[model_name] = self.session.query(m).filter(m.dag_id == self.dag_id).count()
+
+        with self.assertRaises(DagFileExists):
+            delete_dag(self.dag_id)
+
+        # No change should happen in DB
+        for model_name in models_to_check:
+            m = getattr(models, model_name)
+            self.assertEqual(
+                self.session.query(m).filter(
+                    m.dag_id == self.dag_id
+                ).count(),
+                record_counts[model_name]
+            )
+
+
+class TestDeleteDAGSuccessfulDelete(unittest.TestCase):
+
+    def setUp(self):
+        self.session = settings.Session()
+        self.key = "test_dag_id"
+
+        task = DummyOperator(task_id='dummy',
+                             dag=models.DAG(dag_id=self.key,
+                                            default_args={'start_date': days_ago(2)}),
+                             owner='airflow')
+
+        self.session.add(DM(dag_id=self.key))
+        self.session.add(DS(dag_id=self.key, state=State.SUCCESS))
+        self.session.add(DR(dag_id=self.key))
+        self.session.add(TI(task=task,
+                            execution_date=days_ago(1),
+                            state=State.SUCCESS))
+        self.session.add(LOG(dag_id=self.key, task_id=None, task_instance=None,
+                             execution_date=days_ago(1), event="varimport"))
+
+        self.session.commit()
+
+    def tearDown(self):
+        self.session.query(DM).filter(DM.dag_id == self.key).delete()
+        self.session.query(DS).filter(DS.dag_id == self.key).delete()
+        self.session.query(DR).filter(DR.dag_id == self.key).delete()
+        self.session.query(TI).filter(TI.dag_id == self.key).delete()
+        self.session.query(LOG).filter(LOG.dag_id == self.key).delete()
+        self.session.commit()
+
+        self.session.close()
+
+    def test_delete_dag_successful_delete(self):
+
+        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+
+        delete_dag(dag_id=self.key)
+
+        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+
+    def test_delete_dag_successful_delete_not_keeping_records_in_log(self):
+
+        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 1)
+        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+
+        delete_dag(dag_id=self.key, keep_records_in_log=False)
+
+        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 0)
+        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 0)
+
+
+if __name__ == '__main__':
+    unittest.main()

From a2e6b44b296deb1840dba8f4639ade0c915dddde Mon Sep 17 00:00:00 2001
From: Daniel Imberman <daniel.imberman@gmail.com>
Date: Fri, 7 Dec 2018 15:39:47 -0800
Subject: [PATCH 268/808] [AIRFLOW-3484] Fix Over-logging in the k8s executor
 (#4296)

There are two log lines in the k8sexecutor that can cause schedulers to crash
due to too many logs.
---
 airflow/contrib/executors/kubernetes_executor.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 5b02c4d40923b..4021bce356a40 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -577,9 +577,9 @@ def execute_async(self, key, command, queue=None, executor_config=None):
 
     def sync(self):
         if self.running:
-            self.log.info('self.running: %s', self.running)
+            self.log.debug('self.running: %s', self.running)
         if self.queued_tasks:
-            self.log.info('self.queued: %s', self.queued_tasks)
+            self.log.debug('self.queued: %s', self.queued_tasks)
         self.kube_scheduler.sync()
 
         last_resource_version = None

From 0d7e8ba835b454505718a2c08162849bc62eb90b Mon Sep 17 00:00:00 2001
From: yangaws <31293788+yangaws@users.noreply.github.com>
Date: Thu, 6 Dec 2018 11:51:11 -0800
Subject: [PATCH 269/808] [AIRFLOW-2524] Add SageMaker doc to AWS integration
 section (#4278)

---
 docs/integration.rst | 64 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/docs/integration.rst b/docs/integration.rst
index e98d047a58f0c..07e9501f451be 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -384,6 +384,70 @@ S3ToRedshiftTransfer
 .. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
 
 
+Amazon SageMaker
+''''''''''''''''
+
+For more instructions on using Amazon SageMaker in Airflow, please see `the SageMaker Python SDK README`_.
+
+.. _the SageMaker Python SDK README: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/workflow/README.rst
+
+- :ref:`SageMakerHook` : Interact with Amazon SageMaker.
+- :ref:`SageMakerTrainingOperator` : Create a SageMaker training job.
+- :ref:`SageMakerTuningOperator` : Create a SageMaker tuning job.
+- :ref:`SageMakerModelOperator` : Create a SageMaker model.
+- :ref:`SageMakerTransformOperator` : Create a SageMaker transform job.
+- :ref:`SageMakerEndpointConfigOperator` : Create a SageMaker endpoint config.
+- :ref:`SageMakerEndpointOperator` : Create a SageMaker endpoint.
+
+.. _SageMakerHook:
+
+SageMakerHook
+"""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
+
+.. _SageMakerTrainingOperator:
+
+SageMakerTrainingOperator
+"""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
+
+.. _SageMakerTuningOperator:
+
+SageMakerTuningOperator
+"""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
+
+.. _SageMakerModelOperator:
+
+SageMakerModelOperator
+""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
+
+.. _SageMakerTransformOperator:
+
+SageMakerTransformOperator
+""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
+
+.. _SageMakerEndpointConfigOperator:
+
+SageMakerEndpointConfigOperator
+"""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
+
+.. _SageMakerEndpointOperator:
+
+SageMakerEndpointOperator
+"""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
+
 Amazon SageMaker
 ''''''''''''''''
 

From ed9999a3f87b0194e4938ef4ca03f31274091a69 Mon Sep 17 00:00:00 2001
From: Andy Cooper <andycooper.s@gmail.com>
Date: Tue, 24 Jul 2018 01:01:38 +0100
Subject: [PATCH 270/808] [AIRFLOW-2785] Add context manager entry points to
 mongoHook

Closes #3628 from andscoop/Add-connection-close-
to-mongo-hook
---
 airflow/contrib/hooks/mongo_hook.py    | 13 +++++++++++++
 tests/contrib/hooks/test_mongo_hook.py |  9 +++++++++
 2 files changed, 22 insertions(+)

diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index f66ae54a1c523..c1c15e4136c47 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -37,6 +37,13 @@ def __init__(self, conn_id='mongo_default', *args, **kwargs):
         self.extras = self.connection.extra_dejson
         self.client = None
 
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if self.client is not None:
+            self.close_conn()
+
     def get_conn(self):
         """
         Fetches PyMongo Client
@@ -67,6 +74,12 @@ def get_conn(self):
 
         return self.client
 
+    def close_conn(self):
+        client = self.client
+        if client is not None:
+            client.close()
+            self.client = None
+
     def get_collection(self, mongo_collection, mongo_db=None):
         """
         Fetches a mongo collection object for querying.
diff --git a/tests/contrib/hooks/test_mongo_hook.py b/tests/contrib/hooks/test_mongo_hook.py
index 2d4c28f013426..3b705f1a45fba 100644
--- a/tests/contrib/hooks/test_mongo_hook.py
+++ b/tests/contrib/hooks/test_mongo_hook.py
@@ -118,6 +118,15 @@ def test_aggregate(self):
         results = [result for result in results]
         self.assertEqual(len(results), 2)
 
+    def test_context_manager(self):
+        with MongoHook(conn_id='mongo_default', mongo_db='default') as ctxHook:
+            ctxHook.get_conn()
+
+            self.assertIsInstance(ctxHook, MongoHook)
+            self.assertIsNotNone(ctxHook.client)
+
+        self.assertIsNone(ctxHook.client)
+
 
 if __name__ == '__main__':
     unittest.main()

From b806a49c007df29dbd122ee4aa58bf142c403ad9 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Thu, 13 Dec 2018 02:15:43 +0100
Subject: [PATCH 271/808] [AIRFLOW-3310] Google Cloud Spanner deploy / delete
 operators (#4286)

---
 .../example_dags/example_gcp_spanner.py       |  92 +++++++++
 airflow/contrib/hooks/gcp_spanner_hook.py     | 183 ++++++++++++++++++
 .../contrib/operators/gcp_spanner_operator.py | 132 +++++++++++++
 docs/howto/operator.rst                       |  88 +++++++++
 docs/integration.rst                          |  24 +++
 setup.py                                      |   2 +
 .../operators/test_gcp_spanner_operator.py    | 178 +++++++++++++++++
 7 files changed, 699 insertions(+)
 create mode 100644 airflow/contrib/example_dags/example_gcp_spanner.py
 create mode 100644 airflow/contrib/hooks/gcp_spanner_hook.py
 create mode 100644 airflow/contrib/operators/gcp_spanner_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_spanner_operator.py

diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
new file mode 100644
index 0000000000000..dd8b8c52b9d61
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that creates, updates and deletes a Cloud Spanner instance.
+
+This DAG relies on the following environment variables
+* PROJECT_ID - Google Cloud Platform project for the Cloud Spanner instance.
+* INSTANCE_ID - Cloud Spanner instance ID.
+* CONFIG_NAME - The name of the instance's configuration. Values are of the form
+    projects/<project>/instanceConfigs/<configuration>.
+    See also:
+        https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs#InstanceConfig
+        https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list#google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
+* NODE_COUNT - Number of nodes allocated to the instance.
+* DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
+    Must be unique per project and between 4 and 30 characters in length.
+"""
+
+import os
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_spanner_operator import \
+    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator
+
+# [START howto_operator_spanner_arguments]
+PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
+INSTANCE_ID = os.environ.get('INSTANCE_ID', 'testinstance')
+CONFIG_NAME = os.environ.get('CONFIG_NAME',
+                             'projects/example-project/instanceConfigs/eur3')
+NODE_COUNT = os.environ.get('NODE_COUNT', '1')
+DISPLAY_NAME = os.environ.get('DISPLAY_NAME', 'Test Instance')
+# [END howto_operator_spanner_arguments]
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+
+with models.DAG(
+    'example_gcp_spanner',
+    default_args=default_args,
+    schedule_interval=None  # Override to match your needs
+) as dag:
+    # Create
+    # [START howto_operator_spanner_deploy]
+    spanner_instance_create_task = CloudSpannerInstanceDeployOperator(
+        project_id=PROJECT_ID,
+        instance_id=INSTANCE_ID,
+        configuration_name=CONFIG_NAME,
+        node_count=int(NODE_COUNT),
+        display_name=DISPLAY_NAME,
+        task_id='spanner_instance_create_task'
+    )
+    # [END howto_operator_spanner_deploy]
+
+    # Update
+    spanner_instance_update_task = CloudSpannerInstanceDeployOperator(
+        project_id=PROJECT_ID,
+        instance_id=INSTANCE_ID,
+        configuration_name=CONFIG_NAME,
+        node_count=int(NODE_COUNT) + 1,
+        display_name=DISPLAY_NAME + '_updated',
+        task_id='spanner_instance_update_task'
+    )
+
+    # [START howto_operator_spanner_delete]
+    spanner_instance_delete_task = CloudSpannerInstanceDeleteOperator(
+        project_id=PROJECT_ID,
+        instance_id=INSTANCE_ID,
+        task_id='spanner_instance_delete_task'
+    )
+    # [END howto_operator_spanner_delete]
+
+    spanner_instance_create_task >> spanner_instance_update_task \
+        >> spanner_instance_delete_task
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
new file mode 100644
index 0000000000000..fc73562e8b9fe
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -0,0 +1,183 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from google.longrunning.operations_grpc_pb2 import Operation  # noqa: F401
+from typing import Optional, Callable  # noqa: F401
+
+from google.api_core.exceptions import GoogleAPICallError
+from google.cloud.spanner_v1.client import Client
+from google.cloud.spanner_v1.instance import Instance  # noqa: F401
+
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+
+# noinspection PyAbstractClass
+class CloudSpannerHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud Spanner APIs.
+    """
+    _client = None
+
+    def __init__(self,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(CloudSpannerHook, self).__init__(gcp_conn_id, delegate_to)
+
+    def get_client(self, project_id):
+        # type: (str) -> Client
+        """
+        Provides a client for interacting with Cloud Spanner API.
+
+        :param project_id: The ID of the project which owns the instances, tables and data.
+        :type project_id: str
+        :return: Client for interacting with Cloud Spanner API. See:
+            https://googleapis.github.io/google-cloud-python/latest/spanner/client-api.html#google.cloud.spanner_v1.client.Client
+        :rtype: object
+        """
+        if not self._client:
+            self._client = Client(project=project_id, credentials=self._get_credentials())
+        return self._client
+
+    def get_instance(self, project_id, instance_id):
+        # type: (str, str) -> Optional[Instance]
+        """
+        Gets information about a particular instance.
+
+        :param project_id: The ID of the project which owns the instances, tables and data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :return: Representation of a Cloud Spanner Instance. See:
+            https://googleapis.github.io/google-cloud-python/latest/spanner/instance-api.html#google.cloud.spanner_v1.instance.Instance
+        :rtype: object
+        """
+        client = self.get_client(project_id)
+        instance = client.instance(instance_id)
+        if not instance.exists():
+            return None
+        return instance
+
+    def create_instance(self, project_id, instance_id, configuration_name, node_count,
+                        display_name):
+        # type: (str, str, str, int, str) -> bool
+        """
+        Creates a new Cloud Spanner instance.
+
+        :param project_id: The ID of the project which owns the instances, tables and
+            data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :param configuration_name: Name of the instance configuration defining how the
+            instance will be created. Required for instances which do not yet exist.
+        :type configuration_name: str
+        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :type node_count: int
+        :param display_name: (Optional) The display name for the instance in the Cloud
+            Console UI. (Must be between 4 and 30 characters.) If this value is not set
+            in the constructor, will fall back to the instance ID.
+        :type display_name: str
+        :return: True if the operation succeeded, raises an exception otherwise.
+        :rtype: bool
+        """
+        return self._apply_to_instance(project_id, instance_id, configuration_name,
+                                       node_count, display_name, lambda x: x.create())
+
+    def update_instance(self, project_id, instance_id, configuration_name, node_count,
+                        display_name):
+        # type: (str, str, str, int, str) -> bool
+        """
+        Updates an existing Cloud Spanner instance.
+
+        :param project_id: The ID of the project which owns the instances, tables and
+            data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :param configuration_name: Name of the instance configuration defining how the
+            instance will be created. Required for instances which do not yet exist.
+        :type configuration_name: str
+        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :type node_count: int
+        :param display_name: (Optional) The display name for the instance in the Cloud
+            Console UI. (Must be between 4 and 30 characters.) If this value is not set
+            in the constructor, will fall back to the instance ID.
+        :type display_name: str
+        :return: True if the operation succeeded, raises an exception otherwise.
+        :rtype: bool
+        """
+        return self._apply_to_instance(project_id, instance_id, configuration_name,
+                                       node_count, display_name, lambda x: x.update())
+
+    def _apply_to_instance(self, project_id, instance_id, configuration_name, node_count,
+                           display_name, func):
+        # type: (str, str, str, int, str, Callable[[Instance], Operation]) -> bool
+        """
+        Invokes a method on a given instance by applying a specified Callable.
+
+        :param project_id: The ID of the project which owns the instances, tables and
+            data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :param configuration_name: Name of the instance configuration defining how the
+            instance will be created. Required for instances which do not yet exist.
+        :type configuration_name: str
+        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :type node_count: int
+        :param display_name: (Optional) The display name for the instance in the Cloud
+            Console UI. (Must be between 4 and 30 characters.) If this value is not set
+            in the constructor, will fall back to the instance ID.
+        :type display_name: str
+        :param func: Method of the instance to be called.
+        :type func: Callable
+        """
+        client = self.get_client(project_id)
+        instance = client.instance(instance_id,
+                                   configuration_name=configuration_name,
+                                   node_count=node_count,
+                                   display_name=display_name)
+        try:
+            operation = func(instance)  # type: Operation
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Aborting.', e.message)
+            raise e
+
+        if operation:
+            result = operation.result()
+            self.log.info(result)
+        return True
+
+    def delete_instance(self, project_id, instance_id):
+        # type: (str, str) -> bool
+        """
+        Deletes an existing Cloud Spanner instance.
+
+        :param project_id: The ID of the project which owns the instances, tables and data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        """
+        client = self.get_client(project_id)
+        instance = client.instance(instance_id)
+        try:
+            instance.delete()
+            return True
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Aborting.', e.message)
+            raise e
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
new file mode 100644
index 0000000000000..7b329a38490bb
--- /dev/null
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_spanner_hook import CloudSpannerHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class CloudSpannerInstanceDeployOperator(BaseOperator):
+    """
+    Creates a new Cloud Spanner instance or, if an instance with the same instance_id
+    exists in the specified project, updates it.
+
+    :param project_id: The ID of the project which owns the instances, tables and data.
+    :type project_id: str
+    :param instance_id: Cloud Spanner instance ID.
+    :type instance_id: str
+    :param configuration_name: Name of the instance configuration defining
+        how the instance will be created. Required for instances which do not yet exist.
+    :type configuration_name: str
+    :param node_count: (Optional) Number of nodes allocated to the instance.
+    :type node_count: int
+    :param display_name: (Optional) The display name for the instance in the
+        Cloud Console UI. (Must be between 4 and 30 characters.) If this value is not
+        set in the constructor, will fall back to the instance ID.
+    :type display_name: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_deploy_template_fields]
+    template_fields = ('project_id', 'instance_id', 'configuration_name', 'display_name',
+                       'gcp_conn_id')
+    # [END gcp_spanner_deploy_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 configuration_name,
+                 node_count,
+                 display_name,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.configuration_name = configuration_name
+        self.node_count = node_count
+        self.display_name = display_name
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDeployOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+
+    def execute(self, context):
+        if not self._hook.get_instance(self.project_id, self.instance_id):
+            self.log.info("Creating Cloud Spanner instance '%s'", self.instance_id)
+            func = self._hook.create_instance
+        else:
+            self.log.info("Updating Cloud Spanner instance '%s'", self.instance_id)
+            func = self._hook.update_instance
+        return func(self.project_id,
+                    self.instance_id,
+                    self.configuration_name,
+                    self.node_count,
+                    self.display_name)
+
+
+class CloudSpannerInstanceDeleteOperator(BaseOperator):
+    """
+    Deletes a Cloud Spanner instance.
+    If an instance does not exist, no action will be taken and the operator will succeed.
+
+    :param project_id: The ID of the project which owns the instances, tables and data.
+    :type project_id: str
+    :param instance_id: Cloud Spanner instance ID.
+    :type instance_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_delete_template_fields]
+    template_fields = ('project_id', 'instance_id', 'gcp_conn_id')
+    # [END gcp_spanner_delete_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDeleteOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+
+    def execute(self, context):
+        if self._hook.get_instance(self.project_id, self.instance_id):
+            return self._hook.delete_instance(self.project_id,
+                                              self.instance_id)
+        else:
+            self.log.info("Instance '%s' does not exist in project '%s'. "
+                          "Aborting delete.", self.instance_id, self.project_id)
+            return True
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index dc0f4c99d31ce..61b6f2ac721ef 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -535,6 +535,94 @@ See `Google Cloud Functions API documentation <https://cloud.google.com/function
 Google Cloud Sql Operators
 --------------------------
 
+CloudSpannerInstanceDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new Cloud Spanner instance or, if an instance with the same name exists,
+updates it.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_deploy]
+    :end-before: [END howto_operator_spanner_deploy]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_spanner_deploy_template_fields]
+  :end-before: [END gcp_spanner_deploy_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for instance `create
+<https://cloud.google.com/spanner/docs/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance>`_
+and `update
+<https://cloud.google.com/spanner/docs/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance>`_.
+
+CloudSpannerInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Deletes a Cloud Spanner instance.
+If an instance does not exist, no action will be taken and the operator will succeed.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_delete]
+    :end-before: [END howto_operator_spanner_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_spanner_delete_template_fields]
+  :end-before: [END gcp_spanner_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Spanner API documentation for instance delete
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/delete>`_.
+
 CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/integration.rst b/docs/integration.rst
index 07e9501f451be..ecdd3d488c82b 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -648,6 +648,30 @@ BigQueryHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
     :members:
 
+Cloud Spanner
+'''''''''''''
+
+Cloud Spanner Operators
+"""""""""""""""""""""""
+
+- :ref:`CloudSpannerInstanceDeployOperator` : creates a new Cloud Spanner instance or,
+  if an instance with the same name exists, updates it.
+- :ref:`CloudSpannerInstanceDeleteOperator` : deletes a Cloud Spanner instance.
+
+.. _CloudSpannerInstanceDeployOperator:
+
+CloudSpannerInstanceDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
+
+.. _CloudSpannerInstanceDeleteOperator:
+
+CloudSpannerInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
+
 Cloud SQL
 '''''''''
 
diff --git a/setup.py b/setup.py
index 8a223ee6cb6a1..fb136ff69497f 100644
--- a/setup.py
+++ b/setup.py
@@ -190,6 +190,8 @@ def write_version(filename=os.path.join(*['airflow',
     'google-auth>=1.0.0, <2.0.0dev',
     'google-auth-httplib2>=0.0.1',
     'google-cloud-container>=0.1.1',
+    'google-cloud-spanner>=1.6.0',
+    'grpcio-gcp>=0.2.2',
     'PyOpenSSL',
     'pandas-gbq'
 ]
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
new file mode 100644
index 0000000000000..ff2b82fd16cc1
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -0,0 +1,178 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from parameterized import parameterized
+
+from airflow import AirflowException
+from airflow.contrib.operators.gcp_spanner_operator import \
+    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator
+from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
+    SKIP_TEST_WARNING, GCP_SPANNER_KEY
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PROJECT_ID = 'project-id'
+INSTANCE_ID = 'instance-id'
+DB_NAME = 'db1'
+CONFIG_NAME = 'projects/project-id/instanceConfigs/eur3'
+NODE_COUNT = '1'
+DISPLAY_NAME = 'Test Instance'
+
+
+class CloudSpannerTest(unittest.TestCase):
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_create(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+        op = CloudSpannerInstanceDeployOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, CONFIG_NAME, int(NODE_COUNT), DISPLAY_NAME
+        )
+        mock_hook.return_value.update_instance.assert_not_called()
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_update(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = {"name": INSTANCE_ID}
+        op = CloudSpannerInstanceDeployOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.update_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, CONFIG_NAME, int(NODE_COUNT), DISPLAY_NAME
+        )
+        mock_hook.return_value.create_instance.assert_not_called()
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_create_aborts_and_succeeds_if_instance_exists(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = {"name": INSTANCE_ID}
+        op = CloudSpannerInstanceDeployOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_not_called()
+        self.assertTrue(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, "project_id"),
+        (PROJECT_ID, "", "instance_id"),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_create_ex_if_param_missing(self, project_id, instance_id,
+                                                 exp_msg, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDeployOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                configuration_name=CONFIG_NAME,
+                node_count=int(NODE_COUNT),
+                display_name=DISPLAY_NAME,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_delete(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = {"name": INSTANCE_ID}
+        op = CloudSpannerInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_delete_aborts_and_succeeds_if_instance_does_not_exist(self,
+                                                                            mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+        op = CloudSpannerInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_not_called()
+        self.assertTrue(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, "project_id"),
+        (PROJECT_ID, "", "instance_id"),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_delete_ex_if_param_missing(self, project_id, instance_id, exp_msg,
+                                                 mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDeleteOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
+
+@unittest.skipIf(
+    BaseGcpIntegrationTestCase.skip_check(GCP_SPANNER_KEY), SKIP_TEST_WARNING)
+class CloudSpannerExampleDagsTest(BaseGcpIntegrationTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSpannerExampleDagsTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_spanner',
+            gcp_key=GCP_SPANNER_KEY)
+
+    def test_run_example_dag_cloudsql_query(self):
+        self._run_dag()

From f999632a3cd87a89d28ccd48f29e98e5cf253c6b Mon Sep 17 00:00:00 2001
From: tal181 <tal181@gmail.com>
Date: Thu, 13 Dec 2018 03:23:47 +0200
Subject: [PATCH 272/808] [AIRFLOW-3411]  Add OpenFaaS hook (#4267)

---
 airflow/contrib/hooks/openfaas_hook.py    |  99 ++++++++++++++++
 docs/code.rst                             |   1 +
 tests/contrib/hooks/test_openfaas_hook.py | 132 ++++++++++++++++++++++
 3 files changed, 232 insertions(+)
 create mode 100644 airflow/contrib/hooks/openfaas_hook.py
 create mode 100644 tests/contrib/hooks/test_openfaas_hook.py

diff --git a/airflow/contrib/hooks/openfaas_hook.py b/airflow/contrib/hooks/openfaas_hook.py
new file mode 100644
index 0000000000000..8f5062cbc708f
--- /dev/null
+++ b/airflow/contrib/hooks/openfaas_hook.py
@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.base_hook import BaseHook
+import requests
+from airflow import AirflowException
+
+OK_STATUS_CODE = 202
+
+
+class OpenFaasHook(BaseHook):
+    """
+    Interact with Openfaas to query, deploy, invoke and update function
+
+    :param function_name: Name of the function, Defaults to None
+    :type query: str
+    :param conn_id: openfass connection to use, Defaults to open_faas_default
+        for example host : http://openfaas.faas.com, Conn Type : Http
+    :type conn_id: str
+    """
+
+    GET_FUNCTION = "/system/function/"
+    INVOKE_ASYNC_FUNCTION = "/async-function/"
+    DEPLOY_FUNCTION = "/system/functions"
+    UPDATE_FUNCTION = "/system/functions"
+
+    def __init__(self,
+                 function_name=None,
+                 conn_id='open_faas_default',
+                 *args, **kwargs):
+        self.function_name = function_name
+        self.conn_id = conn_id
+        super(BaseHook, self).__init__(*args, **kwargs)
+
+    def get_conn(self):
+        conn = self.get_connection(self.conn_id)
+        return conn
+
+    def deploy_function(self, overwrite_function_if_exist, body):
+        if overwrite_function_if_exist:
+            self.log.info("Function already exist " + self.function_name + " going to update")
+            self.update_function(body)
+        else:
+            url = self.get_conn().host + self.DEPLOY_FUNCTION
+            self.log.info("Deploying function " + url)
+            response = requests.post(url, body)
+            if (response.status_code != OK_STATUS_CODE):
+                self.log.error("Response status " + str(response.status_code))
+                self.log.error("Failed to deploy")
+                raise AirflowException('failed to deploy')
+            else:
+                self.log.info("Function deployed " + self.function_name)
+
+    def invoke_async_function(self, body):
+        url = self.get_conn().host + self.INVOKE_ASYNC_FUNCTION + self.function_name
+        self.log.info("Invoking  function " + url)
+        response = requests.post(url, body)
+        if (response.ok):
+            self.log.info("Invoked " + self.function_name)
+        else:
+            self.log.error("Response status " + str(response.status_code))
+            raise AirflowException('failed to invoke function')
+
+    def update_function(self, body):
+        url = self.get_conn().host + self.UPDATE_FUNCTION
+        self.log.info("Updating function " + url)
+        response = requests.put(url, body)
+        if (response.status_code != OK_STATUS_CODE):
+            self.log.error("Response status " + str(response.status_code))
+            self.log.error("Failed to update response " + response.content.decode("utf-8"))
+            raise AirflowException('failed to update ' + self.function_name)
+        else:
+            self.log.info("Function was updated")
+
+    def does_function_exist(self):
+        url = self.get_conn().host + self.GET_FUNCTION + self.function_name
+
+        response = requests.get(url)
+        if (response.ok):
+            return True
+        else:
+            self.log.error("Failed to find function " + self.function_name)
+            return False
diff --git a/docs/code.rst b/docs/code.rst
index 6619c43a25e63..bf6eda059fbe1 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -436,6 +436,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
 .. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook
 .. autoclass:: airflow.contrib.hooks.mongo_hook.MongoHook
+.. autoclass:: airflow.contrib.hooks.openfaas_hook.OpenFaasHook
 .. autoclass:: airflow.contrib.hooks.pinot_hook.PinotDbApiHook
 .. autoclass:: airflow.contrib.hooks.qubole_hook.QuboleHook
 .. autoclass:: airflow.contrib.hooks.redis_hook.RedisHook
diff --git a/tests/contrib/hooks/test_openfaas_hook.py b/tests/contrib/hooks/test_openfaas_hook.py
new file mode 100644
index 0000000000000..28f1158fbf404
--- /dev/null
+++ b/tests/contrib/hooks/test_openfaas_hook.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import unittest
+import requests_mock
+from airflow.models import Connection
+from airflow.contrib.hooks.openfaas_hook import OpenFaasHook
+from airflow.hooks.base_hook import BaseHook
+from airflow import configuration, AirflowException
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+FUNCTION_NAME = "function_name"
+
+
+class TestOpenFaasHook(unittest.TestCase):
+    GET_FUNCTION = "/system/function/"
+    INVOKE_ASYNC_FUNCTION = "/async-function/"
+    DEPLOY_FUNCTION = "/system/functions"
+    UPDATE_FUNCTION = "/system/functions"
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.hook = OpenFaasHook(function_name=FUNCTION_NAME)
+        self.mock_response = {'ans': 'a'}
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_is_function_exist_false(self, mock_get_connection, m):
+        m.get("http://open-faas.io" + self.GET_FUNCTION + FUNCTION_NAME,
+              json=self.mock_response, status_code=404)
+        mock_connection = Connection(host="http://open-faas.io")
+
+        mock_get_connection.return_value = mock_connection
+        does_function_exist = self.hook.does_function_exist()
+        self.assertFalse(does_function_exist)
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_is_function_exist_true(self, mock_get_connection, m):
+        m.get("http://open-faas.io" + self.GET_FUNCTION + FUNCTION_NAME,
+              json=self.mock_response, status_code=202)
+        mock_connection = Connection(host="http://open-faas.io")
+
+        mock_get_connection.return_value = mock_connection
+        does_function_exist = self.hook.does_function_exist()
+        self.assertTrue(does_function_exist)
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_update_function_true(self, mock_get_connection, m):
+        m.put("http://open-faas.io" + self.UPDATE_FUNCTION, json=self.mock_response, status_code=202)
+        mock_connection = Connection(host="http://open-faas.io")
+
+        mock_get_connection.return_value = mock_connection
+        update_function_ans = self.hook.update_function({})
+        self.assertEqual(update_function_ans, None)
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_update_function_false(self, mock_get_connection, m):
+        m.put("http://open-faas.io" + self.UPDATE_FUNCTION, json=self.mock_response, status_code=400)
+        mock_connection = Connection(host="http://open-faas.io")
+        mock_get_connection.return_value = mock_connection
+
+        with self.assertRaises(AirflowException) as context:
+            self.hook.update_function({})
+        self.assertIn('failed to update ' + FUNCTION_NAME, str(context.exception))
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_invoke_async_function_false(self, mock_get_connection, m):
+        m.post("http://open-faas.io" + self.INVOKE_ASYNC_FUNCTION + FUNCTION_NAME, json=self.mock_response,
+               status_code=400)
+        mock_connection = Connection(host="http://open-faas.io")
+        mock_get_connection.return_value = mock_connection
+
+        with self.assertRaises(AirflowException) as context:
+            self.hook.invoke_async_function({})
+        self.assertIn('failed to invoke function', str(context.exception))
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_invoke_async_function_true(self, mock_get_connection, m):
+        m.post("http://open-faas.io" + self.INVOKE_ASYNC_FUNCTION + FUNCTION_NAME, json=self.mock_response,
+               status_code=202)
+        mock_connection = Connection(host="http://open-faas.io")
+        mock_get_connection.return_value = mock_connection
+        self.assertEqual(self.hook.invoke_async_function({}), None)
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_deploy_function_function_already_exist(self, mock_get_connection, m):
+        m.put("http://open-faas.io/" + self.UPDATE_FUNCTION, json=self.mock_response, status_code=202)
+        mock_connection = Connection(host="http://open-faas.io/")
+        mock_get_connection.return_value = mock_connection
+        self.assertEqual(self.hook.deploy_function(True, {}), None)
+
+    @mock.patch.object(BaseHook, 'get_connection')
+    @requests_mock.mock()
+    def test_deploy_function_function_not_exist(self, mock_get_connection, m):
+        m.post("http://open-faas.io" + self.DEPLOY_FUNCTION, json={}, status_code=202)
+        mock_connection = Connection(host="http://open-faas.io")
+        mock_get_connection.return_value = mock_connection
+        self.assertEqual(self.hook.deploy_function(False, {}), None)
+
+
+if __name__ == '__main__':
+    unittest.main()

From b367ff77deb0c3dbcab13eda4b0a19924fc2628a Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 14 Dec 2018 07:23:23 -0500
Subject: [PATCH 273/808] [AIRFLOW-3444] Explicitly set transfer operator
 description. (#4279)

---
 airflow/contrib/hooks/gcp_transfer_hook.py    | 42 ++++++-------
 .../operators/s3_to_gcs_transfer_operator.py  | 31 +++++++---
 tests/contrib/hooks/test_gcp_transfer_hook.py | 33 ++++++++--
 .../test_s3_to_gcs_transfer_operator.py       | 60 ++++++++++++++++++-
 4 files changed, 131 insertions(+), 35 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_transfer_hook.py b/airflow/contrib/hooks/gcp_transfer_hook.py
index 88534a51039b5..906dba786fb9c 100644
--- a/airflow/contrib/hooks/gcp_transfer_hook.py
+++ b/airflow/contrib/hooks/gcp_transfer_hook.py
@@ -56,34 +56,19 @@ def get_conn(self):
                                http=http_authorized, cache_discovery=False)
         return self._conn
 
-    def create_transfer_job(self, project_id, transfer_spec, **kwargs):
-        conn = self.get_conn()
-        now = datetime.datetime.utcnow()
+    def create_transfer_job(self, project_id, description, schedule, transfer_spec):
         transfer_job = {
             'status': 'ENABLED',
             'projectId': project_id,
+            'description': description,
             'transferSpec': transfer_spec,
-            'schedule': {
-                'scheduleStartDate': {
-                    'day': now.day,
-                    'month': now.month,
-                    'year': now.year,
-                },
-                'scheduleEndDate': {
-                    'day': now.day,
-                    'month': now.month,
-                    'year': now.year,
-                }
-            }
+            'schedule': schedule or self._schedule_once_now(),
         }
-        transfer_job.update(kwargs)
-        result = conn.transferJobs().create(body=transfer_job).execute()
-        self.wait_for_transfer_job(result, conn=conn)
+        return self.get_conn().transferJobs().create(body=transfer_job).execute()
 
-    def wait_for_transfer_job(self, job, conn=None):
-        conn = conn or self.get_conn()
+    def wait_for_transfer_job(self, job):
         while True:
-            result = conn.transferOperations().list(
+            result = self.get_conn().transferOperations().list(
                 name='transferOperations',
                 filter=json.dumps({
                     'project_id': job['projectId'],
@@ -105,3 +90,18 @@ def _check_operations_result(self, result):
             if operation['metadata']['status'] != 'SUCCESS':
                 return False
         return True
+
+    def _schedule_once_now(self):
+        now = datetime.datetime.utcnow()
+        return {
+            'scheduleStartDate': {
+                'day': now.day,
+                'month': now.month,
+                'year': now.year,
+            },
+            'scheduleEndDate': {
+                'day': now.day,
+                'month': now.month,
+                'year': now.year,
+            }
+        }
diff --git a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
index e2fbf95b733c9..b0cf2ae515572 100644
--- a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
@@ -45,15 +45,20 @@ class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
     :type delegate_to: str
+    :param description: Optional transfer service job description
+    :type description: str
+    :param schedule: Optional transfer service schedule; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
+        If not set, run transfer job once as soon as the operator runs
+    :type schedule: dict
     :param object_conditions: Transfer service object conditions; see
         https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
     :type object_conditions: dict
     :param transfer_options: Transfer service transfer options; see
         https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
     :type transfer_options: dict
-    :param job_kwargs: Additional transfer job options; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs
-    :type job_kwargs: dict
+    :param wait: Wait for transfer to finish
+    :type wait: bool
 
     **Example**:
 
@@ -67,7 +72,7 @@ class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
             dag=my_dag)
     """
 
-    template_fields = ('s3_bucket', 'gcs_bucket')
+    template_fields = ('s3_bucket', 'gcs_bucket', 'description', 'object_conditions')
     ui_color = '#e09411'
 
     @apply_defaults
@@ -78,9 +83,11 @@ def __init__(self,
                  aws_conn_id='aws_default',
                  gcp_conn_id='google_cloud_default',
                  delegate_to=None,
+                 description=None,
+                 schedule=None,
                  object_conditions=None,
                  transfer_options=None,
-                 job_kwargs=None,
+                 wait=True,
                  *args,
                  **kwargs):
 
@@ -93,9 +100,11 @@ def __init__(self,
         self.aws_conn_id = aws_conn_id
         self.gcp_conn_id = gcp_conn_id
         self.delegate_to = delegate_to
+        self.description = description
+        self.schedule = schedule
         self.object_conditions = object_conditions or {}
         self.transfer_options = transfer_options or {}
-        self.job_kwargs = job_kwargs or {}
+        self.wait = wait
 
     def execute(self, context):
         transfer_hook = GCPTransferServiceHook(
@@ -104,8 +113,10 @@ def execute(self, context):
 
         s3_creds = S3Hook(aws_conn_id=self.aws_conn_id).get_credentials()
 
-        transfer_hook.create_transfer_job(
+        job = transfer_hook.create_transfer_job(
             project_id=self.project_id,
+            description=self.description,
+            schedule=self.schedule,
             transfer_spec={
                 'awsS3DataSource': {
                     'bucketName': self.s3_bucket,
@@ -119,6 +130,8 @@ def execute(self, context):
                 },
                 'objectConditions': self.object_conditions,
                 'transferOptions': self.transfer_options,
-            },
-            **self.job_kwargs
+            }
         )
+
+        if self.wait:
+            transfer_hook.wait_for_transfer_job(job)
diff --git a/tests/contrib/hooks/test_gcp_transfer_hook.py b/tests/contrib/hooks/test_gcp_transfer_hook.py
index a61716653a98f..1107775f9170c 100644
--- a/tests/contrib/hooks/test_gcp_transfer_hook.py
+++ b/tests/contrib/hooks/test_gcp_transfer_hook.py
@@ -41,8 +41,7 @@ def setUp(self):
             self.transfer_hook = GCPTransferServiceHook()
             self.transfer_hook._conn = self.conn
 
-    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.wait_for_transfer_job')
-    def test_create_transfer_job(self, mock_wait):
+    def test_create_transfer_job(self):
         mock_create = self.conn.transferJobs.return_value.create
         mock_execute = mock_create.return_value.execute
         mock_execute.return_value = {
@@ -54,10 +53,12 @@ def test_create_transfer_job(self, mock_wait):
             'awsS3DataSource': {'bucketName': 'test-s3-bucket'},
             'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
         }
-        self.transfer_hook.create_transfer_job('test-project', transfer_spec)
+        self.transfer_hook.create_transfer_job(
+            'test-project', 'test-description', None, transfer_spec)
         mock_create.assert_called_once_with(body={
             'status': 'ENABLED',
             'projectId': 'test-project',
+            'description': 'test-description',
             'transferSpec': transfer_spec,
             'schedule': {
                 'scheduleStartDate': {
@@ -72,7 +73,31 @@ def test_create_transfer_job(self, mock_wait):
                 }
             }
         })
-        mock_wait.assert_called_once_with(mock_execute.return_value, conn=self.conn)
+
+    def test_create_transfer_job_custom_schedule(self):
+        mock_create = self.conn.transferJobs.return_value.create
+        mock_execute = mock_create.return_value.execute
+        mock_execute.return_value = {
+            'projectId': 'test-project',
+            'name': 'transferJobs/test-job',
+        }
+        schedule = {
+            'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
+            'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
+        }
+        transfer_spec = {
+            'awsS3DataSource': {'bucketName': 'test-s3-bucket'},
+            'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
+        }
+        self.transfer_hook.create_transfer_job(
+            'test-project', 'test-description', schedule, transfer_spec)
+        mock_create.assert_called_once_with(body={
+            'status': 'ENABLED',
+            'projectId': 'test-project',
+            'description': 'test-description',
+            'transferSpec': transfer_spec,
+            'schedule': schedule,
+        })
 
     @mock.patch('time.sleep')
     def test_wait_for_transfer_job(self, mock_sleep):
diff --git a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
index cc7bfd7a95834..2bf51c0707577 100644
--- a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
@@ -36,8 +36,13 @@
 S3_BUCKET = 'test-s3-bucket'
 GCS_BUCKET = 'test-gcs-bucket'
 PROJECT_ID = 'test-project'
+DESCRIPTION = 'test-description'
 ACCESS_KEY = 'test-access-key'
 SECRET_KEY = 'test-secret-key'
+SCHEDULE = {
+    'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
+    'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
+}
 
 
 Credentials = collections.namedtuple(
@@ -53,23 +58,27 @@ def test_constructor(self):
             s3_bucket=S3_BUCKET,
             gcs_bucket=GCS_BUCKET,
             project_id=PROJECT_ID,
+            description=DESCRIPTION,
         )
 
         self.assertEqual(operator.task_id, TASK_ID)
         self.assertEqual(operator.s3_bucket, S3_BUCKET)
         self.assertEqual(operator.gcs_bucket, GCS_BUCKET)
         self.assertEqual(operator.project_id, PROJECT_ID)
+        self.assertEqual(operator.description, DESCRIPTION)
 
     @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
     @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')
     def test_execute(self, mock_s3_hook, mock_transfer_hook):
-        """Test the execute function when the run is successful."""
+        """Test the execute function with a custom schedule."""
 
         operator = S3ToGoogleCloudStorageTransferOperator(
             task_id=TASK_ID,
             s3_bucket=S3_BUCKET,
             gcs_bucket=GCS_BUCKET,
             project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE,
         )
 
         mock_s3_hook.return_value.get_credentials.return_value = Credentials(
@@ -81,6 +90,8 @@ def test_execute(self, mock_s3_hook, mock_transfer_hook):
 
         mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
             project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE,
             transfer_spec={
                 'awsS3DataSource': {
                     'bucketName': S3_BUCKET,
@@ -96,3 +107,50 @@ def test_execute(self, mock_s3_hook, mock_transfer_hook):
                 'transferOptions': {}
             }
         )
+
+        mock_transfer_hook.return_value.wait_for_transfer_job.assert_called_once_with(
+            mock_transfer_hook.return_value.create_transfer_job.return_value
+        )
+
+    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')
+    def test_execute_skip_wait(self, mock_s3_hook, mock_transfer_hook):
+        """Test the execute function and wait until transfer is complete."""
+
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=S3_BUCKET,
+            gcs_bucket=GCS_BUCKET,
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            wait=False,
+        )
+
+        mock_s3_hook.return_value.get_credentials.return_value = Credentials(
+            access_key=ACCESS_KEY,
+            secret_key=SECRET_KEY,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=None,
+            transfer_spec={
+                'awsS3DataSource': {
+                    'bucketName': S3_BUCKET,
+                    'awsAccessKey': {
+                        'accessKeyId': ACCESS_KEY,
+                        'secretAccessKey': SECRET_KEY,
+                    }
+                },
+                'gcsDataSink': {
+                    'bucketName': GCS_BUCKET,
+                },
+                'objectConditions': {},
+                'transferOptions': {}
+            }
+        )
+
+        assert not mock_transfer_hook.return_value.wait_for_transfer_job.called

From fbf96d3219a6226c7931039b576676a1b82805ab Mon Sep 17 00:00:00 2001
From: Tao feng <tfeng@lyft.com>
Date: Wed, 20 Jun 2018 20:32:50 +0200
Subject: [PATCH 274/808] [AIRFLOW-1919] Add option to query for DAG runs given
 a DAG ID

Closes #3515 from feng-tao/airflow-1919
---
 airflow/bin/cli.py | 72 +++++++++++++++++++++++++++++++++++++++++++++-
 tests/core.py      |  8 ++++++
 2 files changed, 79 insertions(+), 1 deletion(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index ef7d7e7f5ba8e..86342869f1e27 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1346,6 +1346,58 @@ def create_user(args):
         raise SystemExit('Failed to create user.')
 
 
+@cli_utils.action_logging
+def list_dag_runs(args, dag=None):
+    if dag:
+        args.dag_id = dag.dag_id
+
+    dagbag = DagBag()
+
+    if args.dag_id not in dagbag.dags:
+        error_message = "Dag id {} not found".format(args.dag_id)
+        raise AirflowException(error_message)
+
+    dag_runs = list()
+    state = args.state.lower() if args.state else None
+    for run in DagRun.find(dag_id=args.dag_id,
+                           state=state,
+                           no_backfills=args.no_backfill):
+        dag_runs.append({
+            'id': run.id,
+            'run_id': run.run_id,
+            'state': run.state,
+            'dag_id': run.dag_id,
+            'execution_date': run.execution_date.isoformat(),
+            'start_date': ((run.start_date or '') and
+                           run.start_date.isoformat()),
+        })
+    if not dag_runs:
+        print('No dag runs for {dag_id}'.format(dag_id=args.dag_id))
+
+    s = textwrap.dedent("""\n
+    {line}
+    DAG RUNS
+    {line}
+    {dag_run_header}
+    """)
+
+    dag_runs.sort(key=lambda x: x['execution_date'], reverse=True)
+    dag_run_header = '%-3s | %-20s | %-10s | %-20s | %-20s |' % ('id',
+                                                                 'run_id',
+                                                                 'state',
+                                                                 'execution_date',
+                                                                 'state_date')
+    print(s.format(dag_run_header=dag_run_header,
+                   line='-' * 120))
+    for dag_run in dag_runs:
+        record = '%-3s | %-20s | %-10s | %-20s | %-20s |' % (dag_run['id'],
+                                                             dag_run['run_id'],
+                                                             dag_run['state'],
+                                                             dag_run['execution_date'],
+                                                             dag_run['start_date'])
+        print(record)
+
+
 Arg = namedtuple(
     'Arg', ['flags', 'help', 'action', 'default', 'nargs', 'type', 'choices', 'metavar'])
 Arg.__new__.__defaults__ = (None, None, None, None, None, None, None)
@@ -1395,6 +1447,15 @@ class CLIFactory(object):
             "store_true",
             default=False),
 
+        # list_dag_runs
+        'no_backfill': Arg(
+            ("--no_backfill",),
+            "filter all the backfill dagruns given the dag id", "store_true"),
+        'state': Arg(
+            ("--state",),
+            "Only list the dag runs corresponding to the state"
+        ),
+
         # backfill
         'mark_success': Arg(
             ("-m", "--mark_success"),
@@ -1796,6 +1857,15 @@ class CLIFactory(object):
                 'subdir', 'pool', 'delay_on_limit', 'dry_run', 'verbose', 'conf',
                 'reset_dag_run', 'rerun_failed_tasks',
             )
+        }, {
+            'func': list_dag_runs,
+            'help': "List dag runs given a DAG id. If state option is given, it will only"
+                    "search for all the dagruns with the given state. "
+                    "If no_backfill option is given, it will filter out"
+                    "all backfill dagruns for given dag id.",
+            'args': (
+                'dag_id', 'no_backfill', 'state'
+            )
         }, {
             'func': list_tasks,
             'help': "List the tasks within a DAG",
@@ -1933,7 +2003,7 @@ class CLIFactory(object):
     )
     subparsers_dict = {sp['func'].__name__: sp for sp in subparsers}
     dag_subparsers = (
-        'list_tasks', 'backfill', 'test', 'run', 'pause', 'unpause')
+        'list_tasks', 'backfill', 'test', 'run', 'pause', 'unpause', 'list_dag_runs')
 
     @classmethod
     def get_parser(cls, dag_parser=False):
diff --git a/tests/core.py b/tests/core.py
index 4172971f3fb16..0ac7380774252 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1057,6 +1057,14 @@ def test_cli_list_dags(self):
         args = self.parser.parse_args(['list_dags', '--report'])
         cli.list_dags(args)
 
+    def test_cli_list_dag_runs(self):
+        cli.trigger_dag(self.parser.parse_args([
+            'trigger_dag', 'example_bash_operator', ]))
+        args = self.parser.parse_args(['list_dag_runs',
+                                       'example_bash_operator',
+                                       '--no_backfill'])
+        cli.list_dag_runs(args)
+
     def test_cli_create_user_random_password(self):
         args = self.parser.parse_args([
             'create_user', '-u', 'test1', '-l', 'doe', '-f', 'jon',

From 4e616fd3cf7f612e9d7e710d775cf86c34406328 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 15 Dec 2018 11:50:22 +0000
Subject: [PATCH 275/808] [AIRFLOW-3521] Fetch more than 50 items in
 `airflow-jira compare` script (#4300)

---
 dev/airflow-jira | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/dev/airflow-jira b/dev/airflow-jira
index 27ec99191426f..5625654c19d76 100755
--- a/dev/airflow-jira
+++ b/dev/airflow-jira
@@ -65,9 +65,22 @@ GIT_LOG_FORMAT = '%x1f'.join(GIT_LOG_FORMAT) + '%x1e'
 def get_jiras_for_version(version):
     asf_jira = jira.client.JIRA({'server': JIRA_API_BASE})
 
-    return asf_jira.search_issues(
-        'PROJECT={} and fixVersion={}'.format(PROJECT, version)
-    )
+    start_at = 0
+    page_size = 50
+    while True:
+        results = asf_jira.search_issues(
+            'PROJECT={} and fixVersion={}'.format(PROJECT, version),
+            maxResults=page_size,
+            startAt=start_at,
+        )
+
+        for r in results:
+            yield r
+
+        if len(results) < page_size:
+            break
+
+        start_at += page_size
 
 
 def get_merged_issues(version):

From a6a4834076dbebe9b0a5703eee9ab0ac019e8609 Mon Sep 17 00:00:00 2001
From: Niels Zeilemaker <niels@zeilemaker.nl>
Date: Sat, 15 Dec 2018 16:11:26 +0100
Subject: [PATCH 276/808] [AIRFLOW-3518] Performance fixes for topological_sort
 of Tasks (#4322)

For larger DAGs topological_sort was found to be very inefficient. Made
some small changes to the code to improve the data structures used in the
method.
---
 airflow/models.py | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index d2c955bc35010..12110aa0736fb 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -26,7 +26,7 @@
 
 from builtins import str, object, bytes, ImportError as BuiltinImportError
 import copy
-from collections import namedtuple, defaultdict
+from collections import namedtuple, defaultdict, OrderedDict
 from datetime import timedelta
 
 import dill
@@ -2537,10 +2537,10 @@ def __init__(
         }
 
     def __eq__(self, other):
-        return (
-            type(self) == type(other) and
-            all(self.__dict__.get(c, None) == other.__dict__.get(c, None)
-                for c in self._comps))
+        if (type(self) == type(other) and
+                self.task_id == other.task_id):
+            return all(self.__dict__.get(c, None) == other.__dict__.get(c, None) for c in self._comps)
+        return False
 
     def __ne__(self, other):
         return not self == other
@@ -3307,12 +3307,13 @@ def __repr__(self):
         return "<DAG: {self.dag_id}>".format(self=self)
 
     def __eq__(self, other):
-        return (
-            type(self) == type(other) and
+        if (type(self) == type(other) and
+                self.dag_id == other.dag_id):
+
             # Use getattr() instead of __dict__ as __dict__ doesn't return
             # correct values for properties.
-            all(getattr(self, c, None) == getattr(other, c, None)
-                for c in self._comps))
+            return all(getattr(self, c, None) == getattr(other, c, None) for c in self._comps)
+        return False
 
     def __ne__(self, other):
         return not self == other
@@ -3769,8 +3770,8 @@ def topological_sort(self):
         :return: list of tasks in topological order
         """
 
-        # copy the the tasks so we leave it unmodified
-        graph_unsorted = self.tasks[:]
+        # convert into an OrderedDict to speedup lookup while keeping order the same
+        graph_unsorted = OrderedDict((task.task_id, task) for task in self.tasks)
 
         graph_sorted = []
 
@@ -3793,14 +3794,14 @@ def topological_sort(self):
             # not, we need to bail out as the graph therefore can't be
             # sorted.
             acyclic = False
-            for node in list(graph_unsorted):
+            for node in list(graph_unsorted.values()):
                 for edge in node.upstream_list:
-                    if edge in graph_unsorted:
+                    if edge.task_id in graph_unsorted:
                         break
                 # no edges in upstream tasks
                 else:
                     acyclic = True
-                    graph_unsorted.remove(node)
+                    del graph_unsorted[node.task_id]
                     graph_sorted.append(node)
 
             if not acyclic:

From c510b1286b3e5b2044defeab3d21c3ebbc2440a6 Mon Sep 17 00:00:00 2001
From: Vardan Gupta <vardanguptacse@gmail.com>
Date: Wed, 8 Aug 2018 22:43:53 +0530
Subject: [PATCH 277/808] [AIRFLOW-2861] Add index on log table (#3709)

---
 .../versions/dd25f486b8ea_add_idx_log_dag.py  | 41 +++++++++++++++++++
 airflow/models.py                             |  4 ++
 2 files changed, 45 insertions(+)
 create mode 100644 airflow/migrations/versions/dd25f486b8ea_add_idx_log_dag.py

diff --git a/airflow/migrations/versions/dd25f486b8ea_add_idx_log_dag.py b/airflow/migrations/versions/dd25f486b8ea_add_idx_log_dag.py
new file mode 100644
index 0000000000000..3249a2e0589cb
--- /dev/null
+++ b/airflow/migrations/versions/dd25f486b8ea_add_idx_log_dag.py
@@ -0,0 +1,41 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from alembic import op
+
+"""add idx_log_dag
+
+Revision ID: dd25f486b8ea
+Revises: 9635ae0956e7
+Create Date: 2018-08-07 06:41:41.028249
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = 'dd25f486b8ea'
+down_revision = '9635ae0956e7'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_index('idx_log_dag', 'log', ['dag_id'], unique=False)
+
+
+def downgrade():
+    op.drop_index('idx_log_dag', table_name='log')
diff --git a/airflow/models.py b/airflow/models.py
index 12110aa0736fb..bf298244f4e91 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2126,6 +2126,10 @@ class Log(Base):
     owner = Column(String(500))
     extra = Column(Text)
 
+    __table_args__ = (
+        Index('idx_log_dag', dag_id),
+    )
+
     def __init__(self, event, task_instance, owner=None, extra=None, **kwargs):
         self.dttm = timezone.utcnow()
         self.event = event

From c4fa7953ee22bece78a8cb848a4bf2df317d388e Mon Sep 17 00:00:00 2001
From: ubermen <kjh3477@gmail.com>
Date: Fri, 12 Oct 2018 18:38:51 +0900
Subject: [PATCH 278/808] [AIRFLOW-3001] Add index 'ti_dag_date' to
 taskinstance (#3885)

To optimize query performance
---
 .../bf00311e1990_add_index_to_taskinstance.py | 46 +++++++++++++++++++
 airflow/models.py                             |  1 +
 2 files changed, 47 insertions(+)
 create mode 100644 airflow/migrations/versions/bf00311e1990_add_index_to_taskinstance.py

diff --git a/airflow/migrations/versions/bf00311e1990_add_index_to_taskinstance.py b/airflow/migrations/versions/bf00311e1990_add_index_to_taskinstance.py
new file mode 100644
index 0000000000000..528bd53b366e5
--- /dev/null
+++ b/airflow/migrations/versions/bf00311e1990_add_index_to_taskinstance.py
@@ -0,0 +1,46 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""add index to taskinstance
+
+Revision ID: bf00311e1990
+Revises: dd25f486b8ea
+Create Date: 2018-09-12 09:53:52.007433
+
+"""
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = 'bf00311e1990'
+down_revision = 'dd25f486b8ea'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_index(
+        'ti_dag_date',
+        'task_instance',
+        ['dag_id', 'execution_date'],
+        unique=False
+    )
+
+
+def downgrade():
+    op.drop_index('ti_dag_date', table_name='task_instance')
diff --git a/airflow/models.py b/airflow/models.py
index bf298244f4e91..4d2385e25bedc 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -901,6 +901,7 @@ class TaskInstance(Base, LoggingMixin):
 
     __table_args__ = (
         Index('ti_dag_state', dag_id, state),
+        Index('ti_dag_date', dag_id, execution_date),
         Index('ti_state', state),
         Index('ti_state_lkp', dag_id, task_id, execution_date, state),
         Index('ti_pool', pool, state, priority_weight),

From be49368e8a83c4abef748948030c9bc952649f1c Mon Sep 17 00:00:00 2001
From: Kevin Yang <yrqls21@gmail.com>
Date: Mon, 26 Nov 2018 21:49:31 -0800
Subject: [PATCH 279/808] [AIRFLOW-3392] Add index on dag_id in sla_miss table
 (#4235)

The select queries on sla_miss table produce a great % of DB traffic and
thus made the DB CPU usage unnecessarily high. It would be a low hanging
fruit to add an index and reduce the load.
---
 .../versions/03bc53e68815_add_sm_dag_index.py | 40 +++++++++++++++++++
 airflow/models.py                             |  4 ++
 2 files changed, 44 insertions(+)
 create mode 100644 airflow/migrations/versions/03bc53e68815_add_sm_dag_index.py

diff --git a/airflow/migrations/versions/03bc53e68815_add_sm_dag_index.py b/airflow/migrations/versions/03bc53e68815_add_sm_dag_index.py
new file mode 100644
index 0000000000000..fc8468155c235
--- /dev/null
+++ b/airflow/migrations/versions/03bc53e68815_add_sm_dag_index.py
@@ -0,0 +1,40 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""merge_heads_2
+
+Revision ID: 03bc53e68815
+Revises: 0a2a5b66e19d, bf00311e1990
+Create Date: 2018-11-24 20:21:46.605414
+
+"""
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = '03bc53e68815'
+down_revision = ('0a2a5b66e19d', 'bf00311e1990')
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_index('sm_dag', 'sla_miss', ['dag_id'], unique=False)
+
+
+def downgrade():
+    op.drop_index('sm_dag', table_name='sla_miss')
diff --git a/airflow/models.py b/airflow/models.py
index 4d2385e25bedc..ca62100c35669 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -5336,6 +5336,10 @@ class SlaMiss(Base):
     description = Column(Text)
     notification_sent = Column(Boolean, default=False)
 
+    __table_args__ = (
+        Index('sm_dag', dag_id, unique=False),
+    )
+
     def __repr__(self):
         return str((
             self.dag_id, self.task_id, self.execution_date.isoformat()))

From 16629ce93fb320315a0055ab4469ce5eb689e47b Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Fri, 21 Sep 2018 07:00:29 +0200
Subject: [PATCH 280/808] [AIRFLOW-2747] Explicit re-schedule of sensors
 (#3596)

* [AIRFLOW-2747] Explicit re-schedule of sensors

Add `mode` property to sensors. If set to `reschedule` an
AirflowRescheduleException is raised instead of sleeping which sets
the task back to state `NONE`. Reschedules are recorded in new
`task_schedule` table and visualized in the Gantt view. New TI
dependency checks if a sensor task is ready to be re-scheduled.

* Reformat sqlalchemy imports

* Make `_handle_reschedule` private

* Remove print

* Add comment

* Add comment

* Don't record reschule request in test mode
---
 airflow/exceptions.py                         |  11 +
 .../0a2a5b66e19d_add_task_reschedule_table.py |  83 +++++
 airflow/models.py                             | 105 +++++-
 airflow/sensors/base_sensor_operator.py       |  56 +++-
 airflow/ti_deps/dep_context.py                |   4 +
 airflow/ti_deps/deps/ready_to_reschedule.py   |  69 ++++
 airflow/www/static/gantt-chart-d3v2.js        |   2 +-
 airflow/www/views.py                          |  55 +++-
 .../www_rbac/static/js/gantt-chart-d3v2.js    |   2 +-
 airflow/www_rbac/views.py                     |  58 +++-
 tests/sensors/test_base_sensor.py             | 303 +++++++++++++++++-
 .../deps/test_ready_to_reschedule_dep.py      |  94 ++++++
 12 files changed, 810 insertions(+), 32 deletions(-)
 create mode 100644 airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
 create mode 100644 airflow/ti_deps/deps/ready_to_reschedule.py
 create mode 100644 tests/ti_deps/deps/test_ready_to_reschedule_dep.py

diff --git a/airflow/exceptions.py b/airflow/exceptions.py
index 89f3d0e048da2..d4098c4a32435 100644
--- a/airflow/exceptions.py
+++ b/airflow/exceptions.py
@@ -47,6 +47,17 @@ class AirflowSensorTimeout(AirflowException):
     pass
 
 
+class AirflowRescheduleException(AirflowException):
+    """
+    Raise when the task should be re-scheduled at a later time.
+
+    :param reschedule_date: The date when the task should be rescheduled
+    :type reschedule: datetime
+    """
+    def __init__(self, reschedule_date):
+        self.reschedule_date = reschedule_date
+
+
 class AirflowTaskTimeout(AirflowException):
     pass
 
diff --git a/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py b/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
new file mode 100644
index 0000000000000..6eef6a9437544
--- /dev/null
+++ b/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
@@ -0,0 +1,83 @@
+# flake8: noqa
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""add task_reschedule table
+
+Revision ID: 0a2a5b66e19d
+Revises: 9635ae0956e7
+Create Date: 2018-06-17 22:50:00.053620
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = '0a2a5b66e19d'
+down_revision = '9635ae0956e7'
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import mysql
+
+
+TABLE_NAME = 'task_reschedule'
+INDEX_NAME = 'idx_' + TABLE_NAME + '_dag_task_date'
+
+def mysql_timestamp():
+    return mysql.TIMESTAMP(fsp=6)
+
+def sa_timestamp():
+    return sa.TIMESTAMP(timezone=True)
+
+def upgrade():
+    # See 0e2a74e0fc9f_add_time_zone_awareness
+    conn = op.get_bind()
+    if conn.dialect.name == 'mysql':
+        timestamp = mysql_timestamp
+    else:
+        timestamp = sa_timestamp
+
+    op.create_table(
+        TABLE_NAME,
+        sa.Column('id', sa.Integer(), nullable=False),
+        sa.Column('task_id', sa.String(length=250), nullable=False),
+        sa.Column('dag_id', sa.String(length=250), nullable=False),
+        # use explicit server_default=None otherwise mysql implies defaults for first timestamp column
+        sa.Column('execution_date', timestamp(), nullable=False, server_default=None),
+        sa.Column('try_number', sa.Integer(), nullable=False),
+        sa.Column('start_date', timestamp(), nullable=False),
+        sa.Column('end_date', timestamp(), nullable=False),
+        sa.Column('duration', sa.Integer(), nullable=False),
+        sa.Column('reschedule_date', timestamp(), nullable=False),
+        sa.PrimaryKeyConstraint('id'),
+        sa.ForeignKeyConstraint(['task_id', 'dag_id', 'execution_date'],
+                                ['task_instance.task_id', 'task_instance.dag_id','task_instance.execution_date'],
+                                name='task_reschedule_dag_task_date_fkey')
+    )
+    op.create_index(
+        INDEX_NAME,
+        TABLE_NAME,
+        ['dag_id', 'task_id', 'execution_date'],
+        unique=False
+    )
+
+
+def downgrade():
+    op.drop_index(INDEX_NAME, table_name=TABLE_NAME)
+    op.drop_table(TABLE_NAME)
diff --git a/airflow/models.py b/airflow/models.py
index ca62100c35669..f20f6057cde99 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -56,9 +56,10 @@
 from urllib.parse import urlparse, quote, parse_qsl, unquote
 
 from sqlalchemy import (
-    Column, Integer, String, DateTime, Text, Boolean, ForeignKey, PickleType,
-    Index, Float, LargeBinary, UniqueConstraint)
-from sqlalchemy import func, or_, and_, true as sqltrue
+    Boolean, Column, DateTime, Float, ForeignKey, ForeignKeyConstraint, Index,
+    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint,
+    and_, asc, func, or_, true as sqltrue
+)
 from sqlalchemy.ext.declarative import declarative_base, declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
 
@@ -71,7 +72,8 @@
 from airflow.executors import GetDefaultExecutor, LocalExecutor
 from airflow import configuration
 from airflow.exceptions import (
-    AirflowDagCycleException, AirflowException, AirflowSkipException, AirflowTaskTimeout
+    AirflowDagCycleException, AirflowException, AirflowSkipException, AirflowTaskTimeout,
+    AirflowRescheduleException
 )
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.lineage import apply_lineage, prepare_lineage
@@ -1682,6 +1684,10 @@ def signal_handler(signum, frame):
         except AirflowSkipException:
             self.refresh_from_db(lock_for_update=True)
             self.state = State.SKIPPED
+        except AirflowRescheduleException as reschedule_exception:
+            self.refresh_from_db()
+            self._handle_reschedule(reschedule_exception, test_mode, context)
+            return
         except AirflowException as e:
             self.refresh_from_db()
             # for case when task is marked as success externally
@@ -1751,6 +1757,32 @@ def dry_run(self):
         self.render_templates()
         task_copy.dry_run()
 
+    @provide_session
+    def _handle_reschedule(self, reschedule_exception, test_mode=False, context=None,
+                           session=None):
+        # Don't record reschedule request in test mode
+        if test_mode:
+            return
+
+        self.end_date = timezone.utcnow()
+        self.set_duration()
+
+        # Log reschedule request
+        session.add(TaskReschedule(self.task, self.execution_date, self._try_number,
+                    self.start_date, self.end_date,
+                    reschedule_exception.reschedule_date))
+
+        # set state
+        self.state = State.NONE
+
+        # Decrement try_number so subsequent runs will use the same try number and write
+        # to same log file.
+        self._try_number -= 1
+
+        session.merge(self)
+        session.commit()
+        self.log.info('Rescheduling task, marking task as NONE')
+
     @provide_session
     def handle_failure(self, error, test_mode=False, context=None, session=None):
         self.log.exception(error)
@@ -2111,6 +2143,66 @@ def __init__(self, task, execution_date, start_date, end_date):
             self.duration = None
 
 
+class TaskReschedule(Base):
+    """
+    TaskReschedule tracks rescheduled task instances.
+    """
+
+    __tablename__ = "task_reschedule"
+
+    id = Column(Integer, primary_key=True)
+    task_id = Column(String(ID_LEN), nullable=False)
+    dag_id = Column(String(ID_LEN), nullable=False)
+    execution_date = Column(UtcDateTime, nullable=False)
+    try_number = Column(Integer, nullable=False)
+    start_date = Column(UtcDateTime, nullable=False)
+    end_date = Column(UtcDateTime, nullable=False)
+    duration = Column(Integer, nullable=False)
+    reschedule_date = Column(UtcDateTime, nullable=False)
+
+    __table_args__ = (
+        Index('idx_task_reschedule_dag_task_date', dag_id, task_id, execution_date,
+              unique=False),
+        ForeignKeyConstraint([task_id, dag_id, execution_date],
+                             [TaskInstance.task_id, TaskInstance.dag_id,
+                              TaskInstance.execution_date],
+                             name='task_reschedule_dag_task_date_fkey')
+    )
+
+    def __init__(self, task, execution_date, try_number, start_date, end_date,
+                 reschedule_date):
+        self.dag_id = task.dag_id
+        self.task_id = task.task_id
+        self.execution_date = execution_date
+        self.try_number = try_number
+        self.start_date = start_date
+        self.end_date = end_date
+        self.reschedule_date = reschedule_date
+        self.duration = (self.end_date - self.start_date).total_seconds()
+
+    @staticmethod
+    @provide_session
+    def find_for_task_instance(task_instance, session):
+        """
+        Returns all task reschedules for the task instance and try number,
+        in ascending order.
+
+        :param task_instance: the task instance to find task reschedules for
+        :type task_instance: TaskInstance
+        """
+        TR = TaskReschedule
+        return (
+            session
+            .query(TR)
+            .filter(TR.dag_id == task_instance.dag_id,
+                    TR.task_id == task_instance.task_id,
+                    TR.execution_date == task_instance.execution_date,
+                    TR.try_number == task_instance.try_number)
+            .order_by(asc(TR.id))
+            .all()
+        )
+
+
 class Log(Base):
     """
     Used to actively log events to the database
@@ -5119,12 +5211,13 @@ def update_state(self, session=None):
             no_dependencies_met = True
             for ut in unfinished_tasks:
                 # We need to flag upstream and check for changes because upstream
-                # failures can result in deadlock false positives
+                # failures/re-schedules can result in deadlock false positives
                 old_state = ut.state
                 deps_met = ut.are_dependencies_met(
                     dep_context=DepContext(
                         flag_upstream_failed=True,
-                        ignore_in_retry_period=True),
+                        ignore_in_retry_period=True,
+                        ignore_in_reschedule_period=True),
                     session=session)
                 if deps_met or old_state != ut.current_state(session=session):
                     no_dependencies_met = False
diff --git a/airflow/sensors/base_sensor_operator.py b/airflow/sensors/base_sensor_operator.py
index 74b0e0fe1ca5b..1dc59dd230b0c 100644
--- a/airflow/sensors/base_sensor_operator.py
+++ b/airflow/sensors/base_sensor_operator.py
@@ -19,20 +19,22 @@
 
 
 from time import sleep
+from datetime import timedelta
 
 from airflow.exceptions import AirflowException, AirflowSensorTimeout, \
-    AirflowSkipException
-from airflow.models import BaseOperator, SkipMixin
+    AirflowSkipException, AirflowRescheduleException
+from airflow.models import BaseOperator, SkipMixin, TaskReschedule
 from airflow.utils import timezone
 from airflow.utils.decorators import apply_defaults
+from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
 
 
 class BaseSensorOperator(BaseOperator, SkipMixin):
     """
-    Sensor operators are derived from this class an inherit these attributes.
+    Sensor operators are derived from this class and inherit these attributes.
 
     Sensor operators keep executing at a time interval and succeed when
-        a criteria is met and fail if and when they time out.
+    a criteria is met and fail if and when they time out.
 
     :param soft_fail: Set to true to mark the task as SKIPPED on failure
     :type soft_fail: bool
@@ -41,20 +43,42 @@ class BaseSensorOperator(BaseOperator, SkipMixin):
     :type poke_interval: int
     :param timeout: Time, in seconds before the task times out and fails.
     :type timeout: int
+    :param mode: How the sensor operates.
+        Options are: ``{ poke | reschedule }``, default is ``poke``.
+        When set to ``poke`` the sensor is taking up a worker slot for its
+        whole execution time and sleeps between pokes. Use this mode if the
+        expected runtime of the sensor is short or if a short poke interval
+        is requried.
+        When set to ``reschedule`` the sensor task frees the worker slot when
+        the criteria is not yet met and it's rescheduled at a later time. Use
+        this mode if the expected time until the criteria is met is. The poke
+        inteval should be more than one minute to prevent too much load on
+        the scheduler.
+    :type mode: str
     """
     ui_color = '#e6f1f2'
+    valid_modes = ['poke', 'reschedule']
 
     @apply_defaults
     def __init__(self,
                  poke_interval=60,
                  timeout=60 * 60 * 24 * 7,
                  soft_fail=False,
+                 mode='poke',
                  *args,
                  **kwargs):
         super(BaseSensorOperator, self).__init__(*args, **kwargs)
         self.poke_interval = poke_interval
         self.soft_fail = soft_fail
         self.timeout = timeout
+        if mode not in self.valid_modes:
+            raise AirflowException(
+                "The mode must be one of {valid_modes},"
+                "'{d}.{t}'; received '{m}'."
+                .format(valid_modes=self.valid_modes,
+                        d=self.dag.dag_id if self.dag else "",
+                        t=self.task_id, m=mode))
+        self.mode = mode
 
     def poke(self, context):
         """
@@ -65,6 +89,11 @@ def poke(self, context):
 
     def execute(self, context):
         started_at = timezone.utcnow()
+        if self.reschedule:
+            # If reschedule, use first start date of current try
+            task_reschedules = TaskReschedule.find_for_task_instance(context['ti'])
+            if task_reschedules:
+                started_at = task_reschedules[0].start_date
         while not self.poke(context):
             if (timezone.utcnow() - started_at).total_seconds() > self.timeout:
                 # If sensor is in soft fail mode but will be retried then
@@ -75,7 +104,12 @@ def execute(self, context):
                     raise AirflowSkipException('Snap. Time is OUT.')
                 else:
                     raise AirflowSensorTimeout('Snap. Time is OUT.')
-            sleep(self.poke_interval)
+            if self.reschedule:
+                reschedule_date = timezone.utcnow() + timedelta(
+                    seconds=self.poke_interval)
+                raise AirflowRescheduleException(reschedule_date)
+            else:
+                sleep(self.poke_interval)
         self.log.info("Success criteria met. Exiting.")
 
     def _do_skip_downstream_tasks(self, context):
@@ -83,3 +117,15 @@ def _do_skip_downstream_tasks(self, context):
         self.log.debug("Downstream task_ids %s", downstream_tasks)
         if downstream_tasks:
             self.skip(context['dag_run'], context['ti'].execution_date, downstream_tasks)
+
+    @property
+    def reschedule(self):
+        return self.mode == 'reschedule'
+
+    @property
+    def deps(self):
+        """
+        Adds one additional dependency for all sensor operators that
+        checks if a sensor task instance can be rescheduled.
+        """
+        return BaseOperator.deps.fget(self) | {ReadyToRescheduleDep()}
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index 6d39998988f83..a347983f3b9f1 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -58,6 +58,8 @@ class DepContext(object):
     :type ignore_depends_on_past: boolean
     :param ignore_in_retry_period: Ignore the retry period for task instances
     :type ignore_in_retry_period: boolean
+    :param ignore_in_reschedule_period: Ignore the reschedule period for task instances
+    :type ignore_in_reschedule_period: boolean
     :param ignore_task_deps: Ignore task-specific dependencies such as depends_on_past and
         trigger rule
     :type ignore_task_deps: boolean
@@ -71,6 +73,7 @@ def __init__(
             ignore_all_deps=False,
             ignore_depends_on_past=False,
             ignore_in_retry_period=False,
+            ignore_in_reschedule_period=False,
             ignore_task_deps=False,
             ignore_ti_state=False):
         self.deps = deps or set()
@@ -78,6 +81,7 @@ def __init__(
         self.ignore_all_deps = ignore_all_deps
         self.ignore_depends_on_past = ignore_depends_on_past
         self.ignore_in_retry_period = ignore_in_retry_period
+        self.ignore_in_reschedule_period = ignore_in_reschedule_period
         self.ignore_task_deps = ignore_task_deps
         self.ignore_ti_state = ignore_ti_state
 
diff --git a/airflow/ti_deps/deps/ready_to_reschedule.py b/airflow/ti_deps/deps/ready_to_reschedule.py
new file mode 100644
index 0000000000000..e0f5f8fdfe410
--- /dev/null
+++ b/airflow/ti_deps/deps/ready_to_reschedule.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.ti_deps.deps.base_ti_dep import BaseTIDep
+from airflow.utils import timezone
+from airflow.utils.db import provide_session
+from airflow.utils.state import State
+
+
+class ReadyToRescheduleDep(BaseTIDep):
+    NAME = "Ready To Reschedule"
+    IGNOREABLE = True
+    IS_TASK_DEP = True
+
+    @provide_session
+    def _get_dep_statuses(self, ti, session, dep_context):
+        """
+        Determines whether a task is ready to be rescheduled. Only tasks in
+        NONE state with at least one row in task_reschedule table are
+        handled by this dependency class, otherwise this dependency is
+        considered as passed. This dependency fails if the latest reschedule
+        request's reschedule date is still in future.
+        """
+        if dep_context.ignore_in_reschedule_period:
+            yield self._passing_status(
+                reason="The context specified that being in a reschedule period was "
+                       "permitted.")
+            return
+
+        if ti.state != State.NONE:
+            yield self._passing_status(
+                reason="The task instance is not in NONE state.")
+            return
+
+        # Lazy import to avoid circular dependency
+        from airflow.models import TaskReschedule
+        task_reschedules = TaskReschedule.find_for_task_instance(task_instance=ti)
+        if not task_reschedules:
+            yield self._passing_status(
+                reason="There is no reschedule request for this task instance.")
+            return
+
+        now = timezone.utcnow()
+        next_reschedule_date = task_reschedules[-1].reschedule_date
+        if now >= next_reschedule_date:
+            yield self._passing_status(
+                reason="Task instance id ready for reschedule.")
+            return
+
+        yield self._failing_status(
+            reason="Task is not ready for reschedule yet but will be rescheduled "
+                   "automatically. Current date is {0} and task will be rescheduled "
+                   "at {1}.".format(now.isoformat(), next_reschedule_date.isoformat()))
diff --git a/airflow/www/static/gantt-chart-d3v2.js b/airflow/www/static/gantt-chart-d3v2.js
index d21311a1c541d..245a0147e9f72 100644
--- a/airflow/www/static/gantt-chart-d3v2.js
+++ b/airflow/www/static/gantt-chart-d3v2.js
@@ -129,7 +129,7 @@ d3.gantt = function() {
       call_modal(d.taskName, d.executionDate);
     })
     .attr("class", function(d){
-      if(taskStatus[d.status] == null){ return "bar";}
+      if(taskStatus[d.status] == null){ return "null";}
       return taskStatus[d.status];
     })
     .attr("y", 0)
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 6bf60d63878fc..41465c78c00b6 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -22,6 +22,7 @@
 
 import ast
 import datetime as dt
+import itertools
 import logging
 import os
 import pkg_resources
@@ -1851,19 +1852,57 @@ def gantt(self, session=None):
             ti for ti in dag.get_task_instances(session, dttm, dttm)
             if ti.start_date]
         tis = sorted(tis, key=lambda ti: ti.start_date)
+        TF = models.TaskFail
+        ti_fails = list(itertools.chain(*[(
+            session
+            .query(TF)
+            .filter(TF.dag_id == ti.dag_id,
+                    TF.task_id == ti.task_id,
+                    TF.execution_date == ti.execution_date)
+            .all()
+        ) for ti in tis]))
+        TR = models.TaskReschedule
+        ti_reschedules = list(itertools.chain(*[(
+            session
+            .query(TR)
+            .filter(TR.dag_id == ti.dag_id,
+                    TR.task_id == ti.task_id,
+                    TR.execution_date == ti.execution_date)
+            .all()
+        ) for ti in tis]))
+        # determine bars to show in the gantt chart
+        # all reschedules of one attempt are combinded into one bar
+        gantt_bar_items = []
+        for task_id, items in itertools.groupby(
+                sorted(tis + ti_fails + ti_reschedules, key=lambda ti: ti.task_id),
+                key=lambda ti: ti.task_id):
+            start_date = None
+            for i in sorted(items, key=lambda ti: ti.start_date):
+                start_date = start_date or i.start_date
+                end_date = i.end_date or timezone.utcnow()
+                if type(i) == models.TaskInstance:
+                    gantt_bar_items.append((task_id, start_date, end_date, i.state))
+                    start_date = None
+                elif type(i) == TF and (len(gantt_bar_items) == 0 or
+                                        end_date != gantt_bar_items[-1][2]):
+                    gantt_bar_items.append((task_id, start_date, end_date, State.FAILED))
+                    start_date = None
 
         tasks = []
-        for ti in tis:
-            end_date = ti.end_date if ti.end_date else timezone.utcnow()
+        for gantt_bar_item in gantt_bar_items:
+            task_id = gantt_bar_item[0]
+            start_date = gantt_bar_item[1]
+            end_date = gantt_bar_item[2]
+            state = gantt_bar_item[3]
             tasks.append({
-                'startDate': wwwutils.epoch(ti.start_date),
+                'startDate': wwwutils.epoch(start_date),
                 'endDate': wwwutils.epoch(end_date),
-                'isoStart': ti.start_date.isoformat()[:-4],
+                'isoStart': start_date.isoformat()[:-4],
                 'isoEnd': end_date.isoformat()[:-4],
-                'taskName': ti.task_id,
-                'duration': "{}".format(end_date - ti.start_date)[:-4],
-                'status': ti.state,
-                'executionDate': ti.execution_date.isoformat(),
+                'taskName': task_id,
+                'duration': "{}".format(end_date - start_date)[:-4],
+                'status': state,
+                'executionDate': dttm.isoformat(),
             })
         states = {ti.state: ti.state for ti in tis}
         data = {
diff --git a/airflow/www_rbac/static/js/gantt-chart-d3v2.js b/airflow/www_rbac/static/js/gantt-chart-d3v2.js
index d21311a1c541d..245a0147e9f72 100644
--- a/airflow/www_rbac/static/js/gantt-chart-d3v2.js
+++ b/airflow/www_rbac/static/js/gantt-chart-d3v2.js
@@ -129,7 +129,7 @@ d3.gantt = function() {
       call_modal(d.taskName, d.executionDate);
     })
     .attr("class", function(d){
-      if(taskStatus[d.status] == null){ return "bar";}
+      if(taskStatus[d.status] == null){ return "null";}
       return taskStatus[d.status];
     })
     .attr("y", 0)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 39d9fb58a3633..163377d8e9176 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -23,7 +23,8 @@
 import logging
 import os
 import socket
-from datetime import datetime, timedelta
+from datetime import timedelta
+import itertools
 import copy
 import math
 import json
@@ -1530,19 +1531,58 @@ def gantt(self, session=None):
             ti for ti in dag.get_task_instances(session, dttm, dttm)
             if ti.start_date]
         tis = sorted(tis, key=lambda ti: ti.start_date)
+        TF = models.TaskFail
+        ti_fails = list(itertools.chain(*[(
+            session
+            .query(TF)
+            .filter(TF.dag_id == ti.dag_id,
+                    TF.task_id == ti.task_id,
+                    TF.execution_date == ti.execution_date)
+            .all()
+        ) for ti in tis]))
+        TR = models.TaskReschedule
+        ti_reschedules = list(itertools.chain(*[(
+            session
+            .query(TR)
+            .filter(TR.dag_id == ti.dag_id,
+                    TR.task_id == ti.task_id,
+                    TR.execution_date == ti.execution_date)
+            .all()
+        ) for ti in tis]))
+
+        # determine bars to show in the gantt chart
+        # all reschedules of one attempt are combinded into one bar
+        gantt_bar_items = []
+        for task_id, items in itertools.groupby(
+                sorted(tis + ti_fails + ti_reschedules, key=lambda ti: ti.task_id),
+                key=lambda ti: ti.task_id):
+            start_date = None
+            for i in sorted(items, key=lambda ti: ti.start_date):
+                start_date = start_date or i.start_date
+                end_date = i.end_date or timezone.utcnow()
+                if type(i) == models.TaskInstance:
+                    gantt_bar_items.append((task_id, start_date, end_date, i.state))
+                    start_date = None
+                elif type(i) == TF and (len(gantt_bar_items) == 0 or
+                                        end_date != gantt_bar_items[-1][2]):
+                    gantt_bar_items.append((task_id, start_date, end_date, State.FAILED))
+                    start_date = None
 
         tasks = []
-        for ti in tis:
-            end_date = ti.end_date if ti.end_date else timezone.utcnow()
+        for gantt_bar_item in gantt_bar_items:
+            task_id = gantt_bar_item[0]
+            start_date = gantt_bar_item[1]
+            end_date = gantt_bar_item[2]
+            state = gantt_bar_item[3]
             tasks.append({
-                'startDate': wwwutils.epoch(ti.start_date),
+                'startDate': wwwutils.epoch(start_date),
                 'endDate': wwwutils.epoch(end_date),
-                'isoStart': ti.start_date.isoformat()[:-4],
+                'isoStart': start_date.isoformat()[:-4],
                 'isoEnd': end_date.isoformat()[:-4],
-                'taskName': ti.task_id,
-                'duration': "{}".format(end_date - ti.start_date)[:-4],
-                'status': ti.state,
-                'executionDate': ti.execution_date.isoformat(),
+                'taskName': task_id,
+                'duration': "{}".format(end_date - start_date)[:-4],
+                'status': state,
+                'executionDate': dttm.isoformat(),
             })
         states = {ti.state: ti.state for ti in tis}
         data = {
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index adb7a5d1e31f7..353f4447b1008 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -18,17 +18,21 @@
 # under the License.
 
 import unittest
+from mock import Mock
 
 from airflow import DAG, configuration, settings
-from airflow.exceptions import AirflowSensorTimeout
-from airflow.models import DagRun, TaskInstance
+from airflow.exceptions import (AirflowSensorTimeout, AirflowException,
+                                AirflowRescheduleException)
+from airflow.models import DagRun, TaskInstance, TaskReschedule
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
 from airflow.utils import timezone
 from airflow.utils.state import State
 from airflow.utils.timezone import datetime
 from datetime import timedelta
 from time import sleep
+from freezegun import freeze_time
 
 configuration.load_test_config()
 
@@ -57,6 +61,7 @@ def setUp(self):
         self.dag = DAG(TEST_DAG_ID, default_args=args)
 
         session = settings.Session()
+        session.query(TaskReschedule).delete()
         session.query(DagRun).delete()
         session.query(TaskInstance).delete()
         session.commit()
@@ -158,3 +163,297 @@ def test_soft_fail_with_retries(self):
         self.assertEquals(len(tis), 2)
         for ti in tis:
             self.assertEquals(ti.state, State.SKIPPED)
+
+    def test_ok_with_reschedule(self):
+        sensor = self._make_sensor(
+            return_value=None,
+            poke_interval=10,
+            timeout=25,
+            mode='reschedule')
+        sensor.poke = Mock(side_effect=[False, False, True])
+        dr = self._make_dag_run()
+
+        # first poke returns False and task is re-scheduled
+        date1 = timezone.utcnow()
+        with freeze_time(date1):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                # verify task is re-scheduled, i.e. state set to NONE
+                self.assertEquals(ti.state, State.NONE)
+                # verify one row in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 1)
+                self.assertEquals(task_reschedules[0].start_date, date1)
+                self.assertEquals(task_reschedules[0].reschedule_date,
+                                  date1 + timedelta(seconds=sensor.poke_interval))
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # second poke returns False and task is re-scheduled
+        date2 = date1 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date2):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                # verify task is re-scheduled, i.e. state set to NONE
+                self.assertEquals(ti.state, State.NONE)
+                # verify two rows in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 2)
+                self.assertEquals(task_reschedules[1].start_date, date2)
+                self.assertEquals(task_reschedules[1].reschedule_date,
+                                  date2 + timedelta(seconds=sensor.poke_interval))
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # third poke returns True and task succeeds
+        date3 = date2 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date3):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.SUCCESS)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+    def test_fail_with_reschedule(self):
+        sensor = self._make_sensor(
+            return_value=False,
+            poke_interval=10,
+            timeout=5,
+            mode='reschedule')
+        dr = self._make_dag_run()
+
+        # first poke returns False and task is re-scheduled
+        date1 = timezone.utcnow()
+        with freeze_time(date1):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.NONE)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # second poke returns False, timeout occurs
+        date2 = date1 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date2):
+            with self.assertRaises(AirflowSensorTimeout):
+                self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.FAILED)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+    def test_soft_fail_with_reschedule(self):
+        sensor = self._make_sensor(
+            return_value=False,
+            poke_interval=10,
+            timeout=5,
+            soft_fail=True,
+            mode='reschedule')
+        dr = self._make_dag_run()
+
+        # first poke returns False and task is re-scheduled
+        date1 = timezone.utcnow()
+        with freeze_time(date1):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.NONE)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # second poke returns False, timeout occurs
+        date2 = date1 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date2):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            self.assertEquals(ti.state, State.SKIPPED)
+
+    def test_ok_with_reschedule_and_retry(self):
+        sensor = self._make_sensor(
+            return_value=None,
+            poke_interval=10,
+            timeout=5,
+            retries=1,
+            retry_delay=timedelta(seconds=10),
+            mode='reschedule')
+        sensor.poke = Mock(side_effect=[False, False, False, True])
+        dr = self._make_dag_run()
+
+        # first poke returns False and task is re-scheduled
+        date1 = timezone.utcnow()
+        with freeze_time(date1):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.NONE)
+                # verify one row in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 1)
+                self.assertEquals(task_reschedules[0].start_date, date1)
+                self.assertEquals(task_reschedules[0].reschedule_date,
+                                  date1 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(task_reschedules[0].try_number, 1)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # second poke fails and task instance is marked up to retry
+        date2 = date1 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date2):
+            with self.assertRaises(AirflowSensorTimeout):
+                self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.UP_FOR_RETRY)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # third poke returns False and task is rescheduled again
+        date3 = date2 + timedelta(seconds=sensor.poke_interval) + sensor.retry_delay
+        with freeze_time(date3):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.NONE)
+                # verify one row in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 1)
+                self.assertEquals(task_reschedules[0].start_date, date3)
+                self.assertEquals(task_reschedules[0].reschedule_date,
+                                  date3 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(task_reschedules[0].try_number, 2)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # fourth poke return True and task succeeds
+        date4 = date3 + timedelta(seconds=sensor.poke_interval)
+        with freeze_time(date4):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.SUCCESS)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+    def test_should_include_ready_to_reschedule_dep(self):
+        sensor = self._make_sensor(True)
+        deps = sensor.deps
+        self.assertTrue(ReadyToRescheduleDep() in deps)
+
+    def test_invalid_mode(self):
+        with self.assertRaises(AirflowException):
+            self._make_sensor(
+                return_value=True,
+                mode='foo')
+
+    def test_ok_with_custom_reschedule_exception(self):
+        sensor = self._make_sensor(
+            return_value=None,
+            mode='reschedule')
+        date1 = timezone.utcnow()
+        date2 = date1 + timedelta(seconds=60)
+        date3 = date1 + timedelta(seconds=120)
+        sensor.poke = Mock(side_effect=[
+            AirflowRescheduleException(date2),
+            AirflowRescheduleException(date3),
+            True,
+        ])
+        dr = self._make_dag_run()
+
+        # first poke returns False and task is re-scheduled
+        with freeze_time(date1):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                # verify task is re-scheduled, i.e. state set to NONE
+                self.assertEquals(ti.state, State.NONE)
+                # verify one row in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 1)
+                self.assertEquals(task_reschedules[0].start_date, date1)
+                self.assertEquals(task_reschedules[0].reschedule_date, date2)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # second poke returns False and task is re-scheduled
+        with freeze_time(date2):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                # verify task is re-scheduled, i.e. state set to NONE
+                self.assertEquals(ti.state, State.NONE)
+                # verify two rows in task_reschedule table
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 2)
+                self.assertEquals(task_reschedules[1].start_date, date2)
+                self.assertEquals(task_reschedules[1].reschedule_date, date3)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+        # third poke returns True and task succeeds
+        with freeze_time(date3):
+            self._run(sensor)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                self.assertEquals(ti.state, State.SUCCESS)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
+
+    def test_reschedule_with_test_mode(self):
+        sensor = self._make_sensor(
+            return_value=None,
+            poke_interval=10,
+            timeout=25,
+            mode='reschedule')
+        sensor.poke = Mock(side_effect=[False])
+        dr = self._make_dag_run()
+
+        # poke returns False and AirflowRescheduleException is raised
+        date1 = timezone.utcnow()
+        with freeze_time(date1):
+            for dt in self.dag.date_range(DEFAULT_DATE, end_date=DEFAULT_DATE):
+                TaskInstance(sensor, dt).run(
+                    ignore_ti_state=True,
+                    test_mode=True)
+        tis = dr.get_task_instances()
+        self.assertEquals(len(tis), 2)
+        for ti in tis:
+            if ti.task_id == SENSOR_OP:
+                # in test mode state is not modified
+                self.assertEquals(ti.state, State.NONE)
+                # in test mode no reschedule request is recorded
+                task_reschedules = TaskReschedule.find_for_task_instance(ti)
+                self.assertEquals(len(task_reschedules), 0)
+            if ti.task_id == DUMMY_OP:
+                self.assertEquals(ti.state, State.NONE)
diff --git a/tests/ti_deps/deps/test_ready_to_reschedule_dep.py b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
new file mode 100644
index 0000000000000..898850f8b7bfb
--- /dev/null
+++ b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from datetime import timedelta
+from mock import Mock, patch
+
+from airflow.models import TaskInstance, DAG, TaskReschedule
+from airflow.ti_deps.dep_context import DepContext
+from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
+from airflow.utils.state import State
+from airflow.utils.timezone import utcnow
+
+
+class NotInReschedulePeriodDepTest(unittest.TestCase):
+
+    def _get_task_instance(self, state):
+        dag = DAG('test_dag')
+        task = Mock(dag=dag)
+        ti = TaskInstance(task=task, state=state, execution_date=None)
+        return ti
+
+    def _get_task_reschedule(self, reschedule_date):
+        task = Mock(dag_id='test_dag', task_id='test_task')
+        tr = TaskReschedule(task=task, execution_date=None, try_number=None,
+                            start_date=reschedule_date, end_date=reschedule_date,
+                            reschedule_date=reschedule_date)
+        return tr
+
+    def test_should_pass_if_ignore_in_reschedule_period_is_set(self):
+        ti = self._get_task_instance(State.NONE)
+        dep_context = DepContext(ignore_in_reschedule_period=True)
+        self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti, dep_context=dep_context))
+
+    def test_should_pass_if_not_in_none_state(self):
+        ti = self._get_task_instance(State.UP_FOR_RETRY)
+        self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
+
+    @patch('airflow.models.TaskReschedule.find_for_task_instance', return_value=[])
+    def test_should_pass_if_no_reschedule_record_exists(self, find_for_task_instance):
+        ti = self._get_task_instance(State.NONE)
+        self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
+
+    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    def test_should_pass_after_reschedule_date_one(self, find_for_task_instance):
+        find_for_task_instance.return_value = [
+            self._get_task_reschedule(utcnow() - timedelta(minutes=1)),
+        ]
+        ti = self._get_task_instance(State.NONE)
+        self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
+
+    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    def test_should_pass_after_reschedule_date_multiple(self, find_for_task_instance):
+        find_for_task_instance.return_value = [
+            self._get_task_reschedule(utcnow() - timedelta(minutes=21)),
+            self._get_task_reschedule(utcnow() - timedelta(minutes=11)),
+            self._get_task_reschedule(utcnow() - timedelta(minutes=1)),
+        ]
+        ti = self._get_task_instance(State.NONE)
+        self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
+
+    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    def test_should_fail_before_reschedule_date_one(self, find_for_task_instance):
+        find_for_task_instance.return_value = [
+            self._get_task_reschedule(utcnow() + timedelta(minutes=1)),
+        ]
+        ti = self._get_task_instance(State.NONE)
+        self.assertFalse(ReadyToRescheduleDep().is_met(ti=ti))
+
+    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    def test_should_fail_before_reschedule_date_multiple(self, find_for_task_instance):
+        find_for_task_instance.return_value = [
+            self._get_task_reschedule(utcnow() - timedelta(minutes=19)),
+            self._get_task_reschedule(utcnow() - timedelta(minutes=9)),
+            self._get_task_reschedule(utcnow() + timedelta(minutes=1)),
+        ]
+        ti = self._get_task_instance(State.NONE)
+        self.assertFalse(ReadyToRescheduleDep().is_met(ti=ti))

From 7f5da475b52fc9008d6880e92cd754725a0b461c Mon Sep 17 00:00:00 2001
From: thomasbrockmeier <thomas.brockmeier@gmail.com>
Date: Sat, 15 Dec 2018 16:27:10 +0100
Subject: [PATCH 281/808] [AIRFLOW-1552] Airflow Filter_by_owner not working
 with password_auth (#4276)

Local users were always a superuser, this adds a column to the DB (and defaults to false,
which is going to cause a bit of an upgrade pain for people, but defaulting to not being an
admin is the only secure default.)
---
 UPDATING.md                                   | 20 +++++++++
 .../contrib/auth/backends/password_auth.py    |  3 +-
 .../41f5f12752f8_add_superuser_field.py       | 42 +++++++++++++++++++
 airflow/models.py                             |  2 +-
 4 files changed, 64 insertions(+), 3 deletions(-)
 create mode 100644 airflow/migrations/versions/41f5f12752f8_add_superuser_field.py

diff --git a/UPDATING.md b/UPDATING.md
index 618888ea95a29..24a42c1aa2858 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -22,6 +22,26 @@ under the License.
 This file documents any backwards-incompatible changes in Airflow and
 assists users migrating to a new version.
 
+## Airflow 1.10.2
+
+### User model changes
+This patch changes the `User.superuser` field from a hardcoded boolean to a `Boolean()` database column. `User.superuser` will default to `False`, which means that this privilege will have to be granted manually to any users that may require it.
+
+For example, open a Python shell and
+```python
+from airflow import models, settings
+
+session = settings.Session()
+users = session.query(models.User).all()  # [admin, regular_user]
+
+users[1].superuser  # False
+
+admin = users[0]
+admin.superuser = True
+session.add(admin)
+session.commit()
+```
+
 ## Airflow 1.10.1
 
 ### New `dag_processor_manager_log_location` config option
diff --git a/airflow/contrib/auth/backends/password_auth.py b/airflow/contrib/auth/backends/password_auth.py
index 55f5daf8fdf76..dcdb1d1225d42 100644
--- a/airflow/contrib/auth/backends/password_auth.py
+++ b/airflow/contrib/auth/backends/password_auth.py
@@ -95,8 +95,7 @@ def data_profiling(self):
         return True
 
     def is_superuser(self):
-        """Access all the things"""
-        return True
+        return hasattr(self, 'user') and self.user.is_superuser()
 
 
 @login_manager.user_loader
diff --git a/airflow/migrations/versions/41f5f12752f8_add_superuser_field.py b/airflow/migrations/versions/41f5f12752f8_add_superuser_field.py
new file mode 100644
index 0000000000000..6e02582b7e840
--- /dev/null
+++ b/airflow/migrations/versions/41f5f12752f8_add_superuser_field.py
@@ -0,0 +1,42 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""add superuser field
+
+Revision ID: 41f5f12752f8
+Revises: 03bc53e68815
+Create Date: 2018-12-04 15:50:04.456875
+
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision = '41f5f12752f8'
+down_revision = '03bc53e68815'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.add_column('users', sa.Column('superuser', sa.Boolean(), default=False))
+
+
+def downgrade():
+    op.drop_column('users', 'superuser')
diff --git a/airflow/models.py b/airflow/models.py
index f20f6057cde99..9cc7b15a59b6a 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -588,7 +588,7 @@ class User(Base):
     id = Column(Integer, primary_key=True)
     username = Column(String(ID_LEN), unique=True)
     email = Column(String(500))
-    superuser = False
+    superuser = Column(Boolean(), default=False)
 
     def __repr__(self):
         return self.username

From 43556e42aff2fe93fc74678fcd40ce136e3cae51 Mon Sep 17 00:00:00 2001
From: Alvin Ali Khaled <aakside@gmail.com>
Date: Wed, 14 Nov 2018 02:59:30 -0800
Subject: [PATCH 282/808] [AIRFLOW-XXX] Revise template variables documentation
 (#4172)

Updated documentation to elaborate on the (yesterday|tomorrow)_.*
variables' relations to the execution date.
---
 docs/code.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/code.rst b/docs/code.rst
index bf6eda059fbe1..5c0c2c5567dd2 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -283,10 +283,10 @@ Variable                            Description
                                     if ``{{ ds }}`` is ``2016-01-01`` and ``schedule_interval`` is ``@weekly``,
                                     ``{{ prev_ds }}`` will be ``2016-01-08``
 ``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None`
-``{{ yesterday_ds }}``              yesterday's date as ``YYYY-MM-DD``
-``{{ yesterday_ds_nodash }}``       yesterday's date as ``YYYYMMDD``
-``{{ tomorrow_ds }}``               tomorrow's date as ``YYYY-MM-DD``
-``{{ tomorrow_ds_nodash }}``        tomorrow's date as ``YYYYMMDD``
+``{{ yesterday_ds }}``              the day before the execution date as ``YYYY-MM-DD``
+``{{ yesterday_ds_nodash }}``       the day before the execution date as ``YYYYMMDD``
+``{{ tomorrow_ds }}``               the day after the execution date as ``YYYY-MM-DD``
+``{{ tomorrow_ds_nodash }}``        the day after the execution date as ``YYYYMMDD``
 ``{{ ts }}``                        same as ``execution_date.isoformat()``
 ``{{ ts_nodash }}``                 same as ``ts`` without ``-`` and ``:``
 ``{{ execution_date }}``            the execution_date, (datetime.datetime)

From 8f2cefe6b85976bef727ca71b7834a61e5c27c0d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 15 Dec 2018 23:13:36 +0000
Subject: [PATCH 283/808] [AIRFLOW-3447] Add 2 options for ts_nodash Macro
 (#4323)

---
 UPDATING.md       |  7 +++++++
 airflow/models.py |  4 +++-
 docs/code.rst     | 13 +++++++------
 tests/core.py     |  3 ++-
 4 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 24a42c1aa2858..de68e065aad69 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -24,6 +24,13 @@ assists users migrating to a new version.
 
 ## Airflow 1.10.2
 
+### Modification to `ts_nodash` macro
+`ts_nodash` previously contained TimeZone information alongwith execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes. 
+
+Examples:
+  * `ts_nodash`: `20150101T000000`
+  * `ts_nodash_with_tz`: `20150101T000000+0000`
+
 ### User model changes
 This patch changes the `User.superuser` field from a hardcoded boolean to a `Boolean()` database column. `User.superuser` will default to `False`, which means that this privilege will have to be granted manually to any users that may require it.
 
diff --git a/airflow/models.py b/airflow/models.py
index 9cc7b15a59b6a..c50931afda3a5 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1870,7 +1870,8 @@ def get_template_context(self, session=None):
             prev_ds_nodash = prev_ds.replace('-', '')
 
         ds_nodash = ds.replace('-', '')
-        ts_nodash = ts.replace('-', '').replace(':', '')
+        ts_nodash = self.execution_date.strftime('%Y%m%dT%H%M%S')
+        ts_nodash_with_tz = ts.replace('-', '').replace(':', '')
         yesterday_ds_nodash = yesterday_ds.replace('-', '')
         tomorrow_ds_nodash = tomorrow_ds.replace('-', '')
 
@@ -1940,6 +1941,7 @@ def __repr__(self):
             'ds_nodash': ds_nodash,
             'ts': ts,
             'ts_nodash': ts_nodash,
+            'ts_nodash_with_tz': ts_nodash_with_tz,
             'yesterday_ds': yesterday_ds,
             'yesterday_ds_nodash': yesterday_ds_nodash,
             'tomorrow_ds': tomorrow_ds,
diff --git a/docs/code.rst b/docs/code.rst
index 5c0c2c5567dd2..ccf6ae5230197 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -261,7 +261,7 @@ Sensors
 .. _macros:
 
 Macros
----------
+------
 Here's a list of variables and macros that can be used in templates
 
 
@@ -276,19 +276,20 @@ Variable                            Description
 ``{{ ds }}``                        the execution date as ``YYYY-MM-DD``
 ``{{ ds_nodash }}``                 the execution date as ``YYYYMMDD``
 ``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``
-                                    if ``{{ ds }}`` is ``2016-01-08`` and ``schedule_interval`` is ``@weekly``,
+                                    if ``{{ ds }}`` is ``2018-01-08`` and ``schedule_interval`` is ``@weekly``,
                                     ``{{ prev_ds }}`` will be ``2016-01-01``
 ``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None`
 ``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``
-                                    if ``{{ ds }}`` is ``2016-01-01`` and ``schedule_interval`` is ``@weekly``,
-                                    ``{{ prev_ds }}`` will be ``2016-01-08``
+                                    if ``{{ ds }}`` is ``2018-01-01`` and ``schedule_interval`` is ``@weekly``,
+                                    ``{{ next_ds }}`` will be ``2018-01-08``
 ``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None`
 ``{{ yesterday_ds }}``              the day before the execution date as ``YYYY-MM-DD``
 ``{{ yesterday_ds_nodash }}``       the day before the execution date as ``YYYYMMDD``
 ``{{ tomorrow_ds }}``               the day after the execution date as ``YYYY-MM-DD``
 ``{{ tomorrow_ds_nodash }}``        the day after the execution date as ``YYYYMMDD``
-``{{ ts }}``                        same as ``execution_date.isoformat()``
-``{{ ts_nodash }}``                 same as ``ts`` without ``-`` and ``:``
+``{{ ts }}``                        same as ``execution_date.isoformat()``. Example: ``2018-01-01T00:00:00+00:00``
+``{{ ts_nodash }}``                 same as ``ts`` without ``-``, ``:`` and TimeZone info. Example: ``20180101T000000``
+``{{ ts_nodash_with_tz }}``         same as ``ts`` without ``-`` and ``:``. Example: ``20180101T000000+0000``
 ``{{ execution_date }}``            the execution_date, (datetime.datetime)
 ``{{ prev_execution_date }}``       the previous execution date (if available) (datetime.datetime)
 ``{{ next_execution_date }}``       the next execution date (datetime.datetime)
diff --git a/tests/core.py b/tests/core.py
index 0ac7380774252..7d36676b5731b 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -629,7 +629,8 @@ def test_task_get_template(self):
         self.assertEquals(context['prev_ds_nodash'], '20141231')
 
         self.assertEquals(context['ts'], '2015-01-01T00:00:00+00:00')
-        self.assertEquals(context['ts_nodash'], '20150101T000000+0000')
+        self.assertEquals(context['ts_nodash'], '20150101T000000')
+        self.assertEquals(context['ts_nodash_with_tz'], '20150101T000000+0000')
 
         self.assertEquals(context['yesterday_ds'], '2014-12-31')
         self.assertEquals(context['yesterday_ds_nodash'], '20141231')

From 08aafdbc247f49e9acccf9ee990625a20b4e25b1 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Mon, 17 Dec 2018 19:05:21 +0100
Subject: [PATCH 284/808] [AIRFLOW-XXX] Add missing remote logging field
 (#4333)

---
 docs/howto/write-logs.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index 935e79717c971..8b61c6e524c2a 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -57,6 +57,7 @@ example:
     # Airflow can store logs remotely in AWS S3. Users must supply a remote
     # location URL (starting with either 's3://...') and an Airflow connection
     # id that provides access to the storage location.
+    remote_logging = True
     remote_base_log_folder = s3://my-bucket/path/to/logs
     remote_log_conn_id = MyS3Conn
     # Use server-side encryption for logs stored in S3

From 1e4067ed49dc298b99a2878f15bbce9eade7f16d Mon Sep 17 00:00:00 2001
From: gseva <gavrilovseva@gmail.com>
Date: Wed, 19 Dec 2018 06:48:57 -0300
Subject: [PATCH 285/808] [AIRFLOW-3246] Make hmsclient optional in
 airflow.hooks.hive_hooks (#4080)

Delay the import right up until it is needed, like how we do with the thrift imports.
---
 airflow/hooks/hive_hooks.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index db6df226d06b2..6cade39ad3560 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -32,7 +32,6 @@
 import time
 from collections import OrderedDict
 from tempfile import NamedTemporaryFile
-import hmsclient
 
 from airflow import configuration as conf
 from airflow.exceptions import AirflowException
@@ -480,6 +479,7 @@ def get_metastore_client(self):
         """
         Returns a Hive thrift client.
         """
+        import hmsclient
         from thrift.transport import TSocket, TTransport
         from thrift.protocol import TBinaryProtocol
         ms = self.metastore_conn

From 83c370c0c6befd49311ce81398bc27fc934cf199 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Wed, 19 Dec 2018 22:41:53 +0100
Subject: [PATCH 286/808] [AIRFLOW-3398] Google Cloud Spanner instance database
 query operator (#4314)

---
 .../example_dags/example_gcp_spanner.py       | 45 ++++++++---
 .../example_dags/example_gcp_spanner.sql      |  3 +
 airflow/contrib/hooks/gcp_spanner_hook.py     | 31 ++++++-
 .../contrib/operators/gcp_spanner_operator.py | 67 ++++++++++++++++
 docs/howto/operator.rst                       | 42 ++++++++++
 docs/integration.rst                          |  9 +++
 .../operators/test_gcp_spanner_operator.py    | 80 ++++++++++++++++++-
 7 files changed, 260 insertions(+), 17 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_spanner.sql

diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
index dd8b8c52b9d61..cec3dcb855bc6 100644
--- a/airflow/contrib/example_dags/example_gcp_spanner.py
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -18,18 +18,18 @@
 # under the License.
 
 """
-Example Airflow DAG that creates, updates and deletes a Cloud Spanner instance.
+Example Airflow DAG that creates, updates, queries and deletes a Cloud Spanner instance.
 
 This DAG relies on the following environment variables
-* PROJECT_ID - Google Cloud Platform project for the Cloud Spanner instance.
-* INSTANCE_ID - Cloud Spanner instance ID.
-* CONFIG_NAME - The name of the instance's configuration. Values are of the form
+* SPANNER_PROJECT_ID - Google Cloud Platform project for the Cloud Spanner instance.
+* SPANNER_INSTANCE_ID - Cloud Spanner instance ID.
+* SPANNER_CONFIG_NAME - The name of the instance's configuration. Values are of the form
     projects/<project>/instanceConfigs/<configuration>.
     See also:
         https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs#InstanceConfig
         https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list#google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
-* NODE_COUNT - Number of nodes allocated to the instance.
-* DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
+* SPANNER_NODE_COUNT - Number of nodes allocated to the instance.
+* SPANNER_DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
     Must be unique per project and between 4 and 30 characters in length.
 """
 
@@ -38,15 +38,17 @@
 import airflow
 from airflow import models
 from airflow.contrib.operators.gcp_spanner_operator import \
-    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator
+    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDatabaseQueryOperator, \
+    CloudSpannerInstanceDeleteOperator
 
 # [START howto_operator_spanner_arguments]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-INSTANCE_ID = os.environ.get('INSTANCE_ID', 'testinstance')
-CONFIG_NAME = os.environ.get('CONFIG_NAME',
+PROJECT_ID = os.environ.get('SPANNER_PROJECT_ID', 'example-project')
+INSTANCE_ID = os.environ.get('SPANNER_INSTANCE_ID', 'testinstance')
+DB_ID = os.environ.get('SPANNER_DB_ID', 'db1')
+CONFIG_NAME = os.environ.get('SPANNER_CONFIG_NAME',
                              'projects/example-project/instanceConfigs/eur3')
-NODE_COUNT = os.environ.get('NODE_COUNT', '1')
-DISPLAY_NAME = os.environ.get('DISPLAY_NAME', 'Test Instance')
+NODE_COUNT = os.environ.get('SPANNER_NODE_COUNT', '1')
+DISPLAY_NAME = os.environ.get('SPANNER_DISPLAY_NAME', 'Test Instance')
 # [END howto_operator_spanner_arguments]
 
 default_args = {
@@ -80,6 +82,24 @@
         task_id='spanner_instance_update_task'
     )
 
+    # [START howto_operator_spanner_query]
+    spanner_instance_query = CloudSpannerInstanceDatabaseQueryOperator(
+        project_id=PROJECT_ID,
+        instance_id=INSTANCE_ID,
+        database_id='db1',
+        query="DELETE FROM my_table2 WHERE true",
+        task_id='spanner_instance_query'
+    )
+    # [END howto_operator_spanner_query]
+
+    spanner_instance_query2 = CloudSpannerInstanceDatabaseQueryOperator(
+        project_id=PROJECT_ID,
+        instance_id=INSTANCE_ID,
+        database_id='db1',
+        query="example_gcp_spanner.sql",
+        task_id='spanner_instance_query2'
+    )
+
     # [START howto_operator_spanner_delete]
     spanner_instance_delete_task = CloudSpannerInstanceDeleteOperator(
         project_id=PROJECT_ID,
@@ -89,4 +109,5 @@
     # [END howto_operator_spanner_delete]
 
     spanner_instance_create_task >> spanner_instance_update_task \
+        >> spanner_instance_query >> spanner_instance_query2 \
         >> spanner_instance_delete_task
diff --git a/airflow/contrib/example_dags/example_gcp_spanner.sql b/airflow/contrib/example_dags/example_gcp_spanner.sql
new file mode 100644
index 0000000000000..5d5f238022a52
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_spanner.sql
@@ -0,0 +1,3 @@
+INSERT my_table2 (id, name) VALUES (7, 'Seven');
+INSERT my_table2 (id, name)
+    VALUES (8, 'Eight');
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index fc73562e8b9fe..96e8bcb71c784 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -16,12 +16,12 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-from google.longrunning.operations_grpc_pb2 import Operation  # noqa: F401
-from typing import Optional, Callable  # noqa: F401
-
 from google.api_core.exceptions import GoogleAPICallError
 from google.cloud.spanner_v1.client import Client
+from google.cloud.spanner_v1.database import Database
 from google.cloud.spanner_v1.instance import Instance  # noqa: F401
+from google.longrunning.operations_grpc_pb2 import Operation  # noqa: F401
+from typing import Optional, Callable  # noqa: F401
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
@@ -181,3 +181,28 @@ def delete_instance(self, project_id, instance_id):
         except GoogleAPICallError as e:
             self.log.error('An error occurred: %s. Aborting.', e.message)
             raise e
+
+    def execute_dml(self, project_id, instance_id, database_id, queries):
+        # type: (str, str, str, str) -> None
+        """
+        Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+
+        :param project_id: The ID of the project which owns the instances, tables and data.
+        :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :param database_id: The ID of the database.
+        :type database_id: str
+        :param queries: The queries to be executed.
+        :type queries: str
+        """
+        client = self.get_client(project_id)
+        instance = client.instance(instance_id)
+        database = Database(database_id, instance)
+        database.run_in_transaction(lambda transaction:
+                                    self._execute_sql_in_transaction(transaction, queries))
+
+    @staticmethod
+    def _execute_sql_in_transaction(transaction, queries):
+        for sql in queries:
+            transaction.execute_update(sql)
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index 7b329a38490bb..b803fcc30ac15 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -16,6 +16,8 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+import six
+
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_spanner_hook import CloudSpannerHook
 from airflow.models import BaseOperator
@@ -130,3 +132,68 @@ def execute(self, context):
             self.log.info("Instance '%s' does not exist in project '%s'. "
                           "Aborting delete.", self.instance_id, self.project_id)
             return True
+
+
+class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
+    """
+    Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+
+    :param project_id: The ID of the project which owns the instances, tables and data.
+    :type project_id: str
+    :param instance_id: The ID of the instance.
+    :type instance_id: str
+    :param database_id: The ID of the database.
+    :type database_id: str
+    :param query: The query or list of queries to be executed. Can be a path to a SQL file.
+    :type query: str or list
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_query_template_fields]
+    template_fields = ('project_id', 'instance_id', 'database_id', 'query', 'gcp_conn_id')
+    template_ext = ('.sql',)
+    # [END gcp_spanner_query_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 database_id,
+                 query,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.database_id = database_id
+        self.query = query
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDatabaseQueryOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+        if not self.database_id:
+            raise AirflowException("The required parameter 'database_id' is empty")
+        if not self.query:
+            raise AirflowException("The required parameter 'query' is empty")
+
+    def execute(self, context):
+        queries = self.query
+        if isinstance(self.query, six.string_types):
+            queries = [x.strip() for x in self.query.split(';')]
+            self.sanitize_queries(queries)
+        self.log.info("Executing DML query(-ies) on "
+                      "projects/%s/instances/%s/databases/%s",
+                      self.project_id, self.instance_id, self.database_id)
+        self.log.info(queries)
+        self._hook.execute_dml(self.project_id, self.instance_id,
+                               self.database_id, queries)
+
+    @staticmethod
+    def sanitize_queries(queries):
+        if len(queries) and queries[-1] == '':
+            del queries[-1]
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 61b6f2ac721ef..ced4d80345fc9 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -535,6 +535,48 @@ See `Google Cloud Functions API documentation <https://cloud.google.com/function
 Google Cloud Sql Operators
 --------------------------
 
+CloudSpannerInstanceDatabaseQueryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_query]
+    :end-before: [END howto_operator_spanner_query]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
+  :language: python
+  :dedent: 4
+  :start-after: [START gcp_spanner_query_template_fields]
+  :end-before: [END gcp_spanner_query_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for `the DML syntax
+<https://cloud.google.com/spanner/docs/dml-syntax>`_.
+
 CloudSpannerInstanceDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/integration.rst b/docs/integration.rst
index ecdd3d488c82b..f0d2cecd2556a 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -654,10 +654,19 @@ Cloud Spanner
 Cloud Spanner Operators
 """""""""""""""""""""""
 
+- :ref:`CloudSpannerInstanceDatabaseQueryOperator` : executes an arbitrary DML query
+  (INSERT, UPDATE, DELETE).
 - :ref:`CloudSpannerInstanceDeployOperator` : creates a new Cloud Spanner instance or,
   if an instance with the same name exists, updates it.
 - :ref:`CloudSpannerInstanceDeleteOperator` : deletes a Cloud Spanner instance.
 
+.. _CloudSpannerInstanceDatabaseQueryOperator:
+
+CloudSpannerInstanceDatabaseQueryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
+
 .. _CloudSpannerInstanceDeployOperator:
 
 CloudSpannerInstanceDeployOperator
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
index ff2b82fd16cc1..38ae985f26947 100644
--- a/tests/contrib/operators/test_gcp_spanner_operator.py
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -22,7 +22,8 @@
 
 from airflow import AirflowException
 from airflow.contrib.operators.gcp_spanner_operator import \
-    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator
+    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator, \
+    CloudSpannerInstanceDatabaseQueryOperator
 from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
     SKIP_TEST_WARNING, GCP_SPANNER_KEY
 
@@ -37,10 +38,15 @@
 
 PROJECT_ID = 'project-id'
 INSTANCE_ID = 'instance-id'
-DB_NAME = 'db1'
+DB_ID = 'db1'
 CONFIG_NAME = 'projects/project-id/instanceConfigs/eur3'
 NODE_COUNT = '1'
 DISPLAY_NAME = 'Test Instance'
+INSERT_QUERY = "INSERT my_table1 (id, name) VALUES (1, 'One')"
+INSERT_QUERY_2 = "INSERT my_table2 (id, name) VALUES (1, 'One')"
+CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
+CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
+QUERY_TYPE = "DML"
 
 
 class CloudSpannerTest(unittest.TestCase):
@@ -164,6 +170,76 @@ def test_instance_delete_ex_if_param_missing(self, project_id, instance_id, exp_
         self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
         mock_hook.assert_not_called()
 
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_query(self, mock_hook):
+        mock_hook.return_value.execute_sql.return_value = None
+        op = CloudSpannerInstanceDatabaseQueryOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            query=INSERT_QUERY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.execute_dml.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY]
+        )
+        self.assertIsNone(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, DB_ID, INSERT_QUERY, "project_id"),
+        (PROJECT_ID, "", DB_ID, INSERT_QUERY, "instance_id"),
+        (PROJECT_ID, INSTANCE_ID, "", INSERT_QUERY, "database_id"),
+        (PROJECT_ID, INSTANCE_ID, DB_ID, "", "query"),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_query_ex_if_param_missing(self, project_id, instance_id,
+                                                database_id, query, exp_msg, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDatabaseQueryOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                database_id=database_id,
+                query=query,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_query_dml(self, mock_hook):
+        mock_hook.return_value.execute_dml.return_value = None
+        op = CloudSpannerInstanceDatabaseQueryOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            query=INSERT_QUERY,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.execute_dml.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY]
+        )
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_query_dml_list(self, mock_hook):
+        mock_hook.return_value.execute_dml.return_value = None
+        op = CloudSpannerInstanceDatabaseQueryOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            query=[INSERT_QUERY, INSERT_QUERY_2],
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.execute_dml.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY, INSERT_QUERY_2]
+        )
+
 
 @unittest.skipIf(
     BaseGcpIntegrationTestCase.skip_check(GCP_SPANNER_KEY), SKIP_TEST_WARNING)

From 2c161e9a63c0e28c5c9f5f7e07df7a4e6efe0e6c Mon Sep 17 00:00:00 2001
From: eladkal <45845474+eladkal@users.noreply.github.com>
Date: Thu, 20 Dec 2018 00:40:28 +0200
Subject: [PATCH 287/808] [AIRFLOW-XXX] Fix incorrect parameter in SFTPOperator
 example (#4344)

---
 airflow/contrib/operators/sftp_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index f04006a497d33..216d2da08bc63 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -63,7 +63,7 @@ class SFTPOperator(BaseOperator):
 
             put_file = SFTPOperator(
                 task_id="test_sftp",
-                ssh_conn="ssh_default",
+                ssh_conn_id="ssh_default",
                 local_filepath="/tmp/file.txt",
                 remote_filepath="/tmp/tmp1/tmp2/file.txt",
                 operation="put",

From a6fd0fa42889aac488a11b8a1fb2eed5a03d2d0e Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 20 Dec 2018 06:43:09 +0800
Subject: [PATCH 288/808] [AIRFLOW-XXX] Fix inconsistent comment in
 example_python_operator.py (#4337)

---
 airflow/example_dags/example_python_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/example_dags/example_python_operator.py b/airflow/example_dags/example_python_operator.py
index 254fb3e26cea5..84705181a8b01 100644
--- a/airflow/example_dags/example_python_operator.py
+++ b/airflow/example_dags/example_python_operator.py
@@ -61,7 +61,7 @@ def my_sleeping_function(random_base):
     time.sleep(random_base)
 
 
-# Generate 10 sleeping tasks, sleeping from 0 to 4 seconds respectively
+# Generate 5 sleeping tasks, sleeping from 0.0 to 0.4 seconds respectively
 for i in range(5):
     task = PythonOperator(
         task_id='sleep_for_' + str(i),

From 9d09c369e9e2b937a2139bb4cc7613d5e7eedf74 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Sat, 22 Dec 2018 10:13:39 -0800
Subject: [PATCH 289/808] [AIRFLOW-850] Add a PythonSensor (#4349)

---
 airflow/contrib/sensors/python_sensor.py    | 81 +++++++++++++++++++++
 docs/code.rst                               |  1 +
 tests/contrib/sensors/test_python_sensor.py | 72 ++++++++++++++++++
 3 files changed, 154 insertions(+)
 create mode 100644 airflow/contrib/sensors/python_sensor.py
 create mode 100644 tests/contrib/sensors/test_python_sensor.py

diff --git a/airflow/contrib/sensors/python_sensor.py b/airflow/contrib/sensors/python_sensor.py
new file mode 100644
index 0000000000000..68bc7497eaf41
--- /dev/null
+++ b/airflow/contrib/sensors/python_sensor.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class PythonSensor(BaseSensorOperator):
+    """
+    Waits for a Python callable to return True.
+
+    User could put input argument in templates_dict
+        e.g templates_dict = {'start_ds': 1970}
+    and access the argument by calling `kwargs['templates_dict']['start_ds']`
+    in the the callable
+
+    :param python_callable: A reference to an object that is callable
+    :type python_callable: python callable
+    :param op_kwargs: a dictionary of keyword arguments that will get unpacked
+        in your function
+    :type op_kwargs: dict
+    :param op_args: a list of positional arguments that will get unpacked when
+        calling your callable
+    :type op_args: list
+    :param provide_context: if set to true, Airflow will pass a set of
+        keyword arguments that can be used in your function. This set of
+        kwargs correspond exactly to what you can use in your jinja
+        templates. For this to work, you need to define `**kwargs` in your
+        function header.
+    :type provide_context: bool
+    :param templates_dict: a dictionary where the values are templates that
+        will get templated by the Airflow engine sometime between
+        ``__init__`` and ``execute`` takes place and are made available
+        in your callable's context after the template has been applied.
+    :type templates_dict: dict of str
+    """
+
+    template_fields = ('templates_dict',)
+    template_ext = tuple()
+
+    @apply_defaults
+    def __init__(
+            self,
+            python_callable,
+            op_args=None,
+            op_kwargs=None,
+            provide_context=False,
+            templates_dict=None,
+            *args, **kwargs):
+        super(PythonSensor, self).__init__(*args, **kwargs)
+        self.python_callable = python_callable
+        self.op_args = op_args or []
+        self.op_kwargs = op_kwargs or {}
+        self.provide_context = provide_context
+        self.templates_dict = templates_dict
+
+    def poke(self, context):
+        if self.provide_context:
+            context.update(self.op_kwargs)
+            context['templates_dict'] = self.templates_dict
+            self.op_kwargs = context
+
+        self.log.info("Poking callable: " + str(self.python_callable))
+        return_value = self.python_callable(*self.op_args, **self.op_kwargs)
+        return bool(return_value)
diff --git a/docs/code.rst b/docs/code.rst
index ccf6ae5230197..f9b5c23eba539 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -248,6 +248,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorRegex
 .. autoclass:: airflow.contrib.sensors.jira_sensor.JiraSensor
 .. autoclass:: airflow.contrib.sensors.pubsub_sensor.PubSubPullSensor
+.. autoclass:: airflow.contrib.sensors.python_sensor.PythonSensor
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleSensor
 .. autoclass:: airflow.contrib.sensors.redis_key_sensor.RedisKeySensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_base_sensor.SageMakerBaseSensor
diff --git a/tests/contrib/sensors/test_python_sensor.py b/tests/contrib/sensors/test_python_sensor.py
new file mode 100644
index 0000000000000..6c852e748a8d1
--- /dev/null
+++ b/tests/contrib/sensors/test_python_sensor.py
@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+import unittest
+
+from airflow import DAG, configuration
+from airflow.contrib.sensors.python_sensor import PythonSensor
+from airflow.exceptions import AirflowSensorTimeout
+from airflow.models import DagBag
+from airflow.utils.timezone import datetime
+
+
+DEFAULT_DATE = datetime(2015, 1, 1)
+TEST_DAG_ID = 'python_sensor_dag'
+DEV_NULL = '/dev/null'
+
+
+class PythonSensorTests(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.dagbag = DagBag(
+            dag_folder=DEV_NULL,
+            include_examples=True
+        )
+        self.args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        dag = DAG(TEST_DAG_ID, default_args=self.args)
+        self.dag = dag
+
+    def test_python_sensor_true(self):
+        t = PythonSensor(
+            task_id='python_sensor_check_true',
+            python_callable=lambda: True,
+            dag=self.dag)
+        t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+
+    def test_python_sensor_false(self):
+        t = PythonSensor(
+            task_id='python_sensor_check_false',
+            timeout=1,
+            python_callable=lambda: False,
+            dag=self.dag)
+        with self.assertRaises(AirflowSensorTimeout):
+            t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+
+    def test_python_sensor_raise(self):
+        t = PythonSensor(
+            task_id='python_sensor_check_raise',
+            python_callable=lambda: 1 / 0,
+            dag=self.dag)
+        with self.assertRaises(ZeroDivisionError):
+            t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)

From 29eed3cc2015ce667026153eafd002d4eb2afa46 Mon Sep 17 00:00:00 2001
From: Kazuhiro Sera <seratch@gmail.com>
Date: Sun, 12 Aug 2018 13:11:19 +0900
Subject: [PATCH 290/808] [AIRFLOW-2889] Fix typos detected by
 github.com/client9/misspell (#3732)

---
 airflow/contrib/example_dags/example_databricks_operator.py | 2 +-
 airflow/contrib/hooks/azure_fileshare_hook.py               | 2 +-
 airflow/contrib/hooks/bigquery_hook.py                      | 2 +-
 airflow/contrib/hooks/emr_hook.py                           | 2 +-
 airflow/contrib/hooks/gcp_dataproc_hook.py                  | 2 +-
 airflow/contrib/hooks/qubole_hook.py                        | 2 +-
 airflow/contrib/hooks/salesforce_hook.py                    | 4 ++--
 airflow/contrib/operators/gcs_to_bq.py                      | 2 +-
 airflow/contrib/operators/mlengine_operator_utils.py        | 2 +-
 airflow/contrib/operators/qubole_check_operator.py          | 2 +-
 .../templates/metastore_browser/table.html                  | 2 +-
 airflow/hooks/mysql_hook.py                                 | 2 +-
 airflow/models.py                                           | 2 +-
 airflow/operators/hive_to_druid.py                          | 2 +-
 airflow/sensors/hdfs_sensor.py                              | 6 +++---
 dev/airflow-pr                                              | 6 +++---
 docs/howto/write-logs.rst                                   | 2 +-
 scripts/ci/kubernetes/kube/secrets.yaml                     | 2 +-
 tests/contrib/hooks/test_bigquery_hook.py                   | 4 ++--
 tests/contrib/operators/test_ecs_operator.py                | 2 +-
 tests/core.py                                               | 2 +-
 tests/models.py                                             | 2 +-
 22 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/airflow/contrib/example_dags/example_databricks_operator.py b/airflow/contrib/example_dags/example_databricks_operator.py
index bc827d465bd3a..79f947ba1c123 100644
--- a/airflow/contrib/example_dags/example_databricks_operator.py
+++ b/airflow/contrib/example_dags/example_databricks_operator.py
@@ -32,7 +32,7 @@
 # the spark jar task will NOT run until the notebook task completes
 # successfully.
 #
-# The definition of a succesful run is if the run has a result_state of "SUCCESS".
+# The definition of a successful run is if the run has a result_state of "SUCCESS".
 # For more information about the state of a run refer to
 # https://docs.databricks.com/api/latest/jobs.html#runstate
 
diff --git a/airflow/contrib/hooks/azure_fileshare_hook.py b/airflow/contrib/hooks/azure_fileshare_hook.py
index edabc17293606..d4066ee549f3f 100644
--- a/airflow/contrib/hooks/azure_fileshare_hook.py
+++ b/airflow/contrib/hooks/azure_fileshare_hook.py
@@ -100,7 +100,7 @@ def list_directories_and_files(self, share_name, directory_name=None, **kwargs):
 
     def create_directory(self, share_name, directory_name, **kwargs):
         """
-        Create a new direcotry on a Azure File Share.
+        Create a new directory on a Azure File Share.
 
         :param share_name: Name of the share.
         :type share_name: str
diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index b255bb1686b7f..437c9b10cdadc 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -625,7 +625,7 @@ def run_query(self,
 
         if query_params:
             if self.use_legacy_sql:
-                raise ValueError("Query paramaters are not allowed when using "
+                raise ValueError("Query parameters are not allowed when using "
                                  "legacy SQL")
             else:
                 configuration['query']['queryParameters'] = query_params
diff --git a/airflow/contrib/hooks/emr_hook.py b/airflow/contrib/hooks/emr_hook.py
index f9fd3f04de114..fcdf4ac84852e 100644
--- a/airflow/contrib/hooks/emr_hook.py
+++ b/airflow/contrib/hooks/emr_hook.py
@@ -23,7 +23,7 @@
 
 class EmrHook(AwsHook):
     """
-    Interact with AWS EMR. emr_conn_id is only neccessary for using the
+    Interact with AWS EMR. emr_conn_id is only necessary for using the
     create_job_flow method.
     """
 
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index 8e4f32b13790c..57c48bde59328 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -235,6 +235,6 @@ def wait(self, operation):
     DataProcHook,
     "await",
     deprecation.deprecated(
-        DataProcHook.wait, "renamed to 'wait' for Python3.7 compatability"
+        DataProcHook.wait, "renamed to 'wait' for Python3.7 compatibility"
     ),
 )
diff --git a/airflow/contrib/hooks/qubole_hook.py b/airflow/contrib/hooks/qubole_hook.py
index fb45862e88e02..2aac592bf3ebe 100755
--- a/airflow/contrib/hooks/qubole_hook.py
+++ b/airflow/contrib/hooks/qubole_hook.py
@@ -123,7 +123,7 @@ def execute(self, context):
 
     def kill(self, ti):
         """
-        Kill (cancel) a Qubole commmand
+        Kill (cancel) a Qubole command
         :param ti: Task Instance of the dag, used to determine the Quboles command id
         :return: response from Qubole
         """
diff --git a/airflow/contrib/hooks/salesforce_hook.py b/airflow/contrib/hooks/salesforce_hook.py
index 24b67f49fc402..efc819e543995 100644
--- a/airflow/contrib/hooks/salesforce_hook.py
+++ b/airflow/contrib/hooks/salesforce_hook.py
@@ -53,14 +53,14 @@ def __init__(
 
         :param conn_id:     the name of the connection that has the parameters
                             we need to connect to Salesforce.
-                            The conenction shoud be type `http` and include a
+                            The connection shoud be type `http` and include a
                             user's security token in the `Extras` field.
         .. note::
             For the HTTP connection type, you can include a
             JSON structure in the `Extras` field.
             We need a user's security token to connect to Salesforce.
             So we define it in the `Extras` field as:
-                `{"security_token":"YOUR_SECRUITY_TOKEN"}`
+                `{"security_token":"YOUR_SECURITY_TOKEN"}`
         """
         self.conn_id = conn_id
         self._args = args
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 17dfdb48a5b47..69acb616594d9 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -86,7 +86,7 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         for other formats.
     :type allow_jagged_rows: bool
     :param max_id_key: If set, the name of a column in the BigQuery table
-        that's to be loaded. Thsi will be used to select the MAX value from
+        that's to be loaded. This will be used to select the MAX value from
         BigQuery after the load occurs. The results will be returned by the
         execute() command, which in turn gets stored in XCom for future
         operators to use. This can be helpful with incremental loads--during
diff --git a/airflow/contrib/operators/mlengine_operator_utils.py b/airflow/contrib/operators/mlengine_operator_utils.py
index 7ce784ebb4ae3..60001daea4d0f 100644
--- a/airflow/contrib/operators/mlengine_operator_utils.py
+++ b/airflow/contrib/operators/mlengine_operator_utils.py
@@ -160,7 +160,7 @@ def validate_err_and_count(summary):
         then the `dag`'s `default_args['model_name']` will be used.
     :type model_name: string
 
-    :param version_name: Used to indicate a model version to use for prediciton,
+    :param version_name: Used to indicate a model version to use for prediction,
         in combination with model_name. Cannot be used together with model_uri.
         See MLEngineBatchPredictionOperator for more detail. If None, then the
         `dag`'s `default_args['version_name']` will be used.
diff --git a/airflow/contrib/operators/qubole_check_operator.py b/airflow/contrib/operators/qubole_check_operator.py
index 0e8d75e16729e..235af08ca753e 100644
--- a/airflow/contrib/operators/qubole_check_operator.py
+++ b/airflow/contrib/operators/qubole_check_operator.py
@@ -28,7 +28,7 @@ class QuboleCheckOperator(CheckOperator, QuboleOperator):
     """
     Performs checks against Qubole Commands. ``QuboleCheckOperator`` expects
     a command that will be executed on QDS.
-    By default, each value on first row of the result of this Qubole Commmand
+    By default, each value on first row of the result of this Qubole Command
     is evaluated using python ``bool`` casting. If any of the
     values return ``False``, the check is failed and errors out.
 
diff --git a/airflow/contrib/plugins/metastore_browser/templates/metastore_browser/table.html b/airflow/contrib/plugins/metastore_browser/templates/metastore_browser/table.html
index 3a9d7ca671ad2..cbb7acff6da37 100644
--- a/airflow/contrib/plugins/metastore_browser/templates/metastore_browser/table.html
+++ b/airflow/contrib/plugins/metastore_browser/templates/metastore_browser/table.html
@@ -28,7 +28,7 @@ <h4>
     <li role="presentation" class="active"><a href="#home" aria-controls="fields" role="tab" data-toggle="tab">Fields</a></li>
     <li role="presentation"><a href="#data" aria-controls="data" role="tab" data-toggle="tab">Sample Data</a></li>
     <li role="presentation"><a href="#partitions" aria-controls="partitions" role="tab" data-toggle="tab">Partitions</a></li>
-    <li role="presentation"><a href="#attributes" aria-controls="attributes" role="tab" data-toggle="tab">Atributes</a></li>
+    <li role="presentation"><a href="#attributes" aria-controls="attributes" role="tab" data-toggle="tab">Attributes</a></li>
     <li role="presentation"><a href="#parameters" aria-controls="parameters" role="tab" data-toggle="tab">Parameters</a></li>
     <li role="presentation"><a href="#ddl" aria-controls="ddl" role="tab" data-toggle="tab">DDL</a></li>
 </ul>
diff --git a/airflow/hooks/mysql_hook.py b/airflow/hooks/mysql_hook.py
index 57f577c261353..4e65fdf3a3cf5 100644
--- a/airflow/hooks/mysql_hook.py
+++ b/airflow/hooks/mysql_hook.py
@@ -131,7 +131,7 @@ def bulk_dump(self, table, tmp_file):
     def _serialize_cell(cell, conn):
         """
         MySQLdb converts an argument to a literal
-        when passing those seperately to execute. Hence, this method does nothing.
+        when passing those separately to execute. Hence, this method does nothing.
 
         :param cell: The cell to insert into the table
         :type cell: object
diff --git a/airflow/models.py b/airflow/models.py
index c50931afda3a5..e7dd02a78eb17 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -954,7 +954,7 @@ def init_on_load(self):
     @property
     def try_number(self):
         """
-        Return the try number that this task number will be when it is acutally
+        Return the try number that this task number will be when it is actually
         run.
 
         If the TI is currently running, this will match the column in the
diff --git a/airflow/operators/hive_to_druid.py b/airflow/operators/hive_to_druid.py
index 9b4a881c5c3d4..a845902c871bb 100644
--- a/airflow/operators/hive_to_druid.py
+++ b/airflow/operators/hive_to_druid.py
@@ -162,7 +162,7 @@ def construct_ingest_query(self, static_path, columns):
         :type columns: list
         """
 
-        # backward compatibilty for num_shards,
+        # backward compatibility for num_shards,
         # but target_partition_size is the default setting
         # and overwrites the num_shards
         num_shards = self.num_shards
diff --git a/airflow/sensors/hdfs_sensor.py b/airflow/sensors/hdfs_sensor.py
index d05adef71c276..4d95556f47a8d 100644
--- a/airflow/sensors/hdfs_sensor.py
+++ b/airflow/sensors/hdfs_sensor.py
@@ -88,12 +88,12 @@ def filter_for_ignored_ext(result, ignored_ext, ignore_copying):
         if ignore_copying:
             log = LoggingMixin().log
             regex_builder = "^.*\.(%s$)$" % '$|'.join(ignored_ext)
-            ignored_extentions_regex = re.compile(regex_builder)
+            ignored_extensions_regex = re.compile(regex_builder)
             log.debug(
                 'Filtering result for ignored extensions: %s in files %s',
-                ignored_extentions_regex.pattern, map(lambda x: x['path'], result)
+                ignored_extensions_regex.pattern, map(lambda x: x['path'], result)
             )
-            result = [x for x in result if not ignored_extentions_regex.match(x['path'])]
+            result = [x for x in result if not ignored_extensions_regex.match(x['path'])]
             log.debug('HdfsSensor.poke: after ext filter result is %s', result)
         return result
 
diff --git a/dev/airflow-pr b/dev/airflow-pr
index c7cea6446b61d..867d3298498bf 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -713,8 +713,8 @@ def standardize_jira_ref(text, only_jira=False):
     '[AIRFLOW-5954][MLLIB] Top by key'
     >>> standardize_jira_ref("[AIRFLOW-979] a LRU scheduler for load balancing in TaskSchedulerImpl")
     '[AIRFLOW-979] a LRU scheduler for load balancing in TaskSchedulerImpl'
-    >>> standardize_jira_ref("AIRFLOW-1094 Support MiMa for reporting binary compatibility accross versions.")
-    '[AIRFLOW-1094] Support MiMa for reporting binary compatibility accross versions.'
+    >>> standardize_jira_ref("AIRFLOW-1094 Support MiMa for reporting binary compatibility across versions.")
+    '[AIRFLOW-1094] Support MiMa for reporting binary compatibility across versions.'
     >>> standardize_jira_ref("[WIP]  [AIRFLOW-1146] Vagrant support for Spark")
     '[AIRFLOW-1146][WIP] Vagrant support for Spark'
     >>> standardize_jira_ref("AIRFLOW-1032. If Yarn app fails before registering, app master stays aroun...")
@@ -973,7 +973,7 @@ def cli():
     status = run_cmd('git status --porcelain', echo_cmd=False)
     if status:
         msg = (
-            'You have uncomitted changes in this branch. Running this tool\n'
+            'You have uncommitted changes in this branch. Running this tool\n'
             'will delete them permanently. Continue?')
         if click.confirm(click.style(msg, fg='red', bold=True)):
             run_cmd('git reset --hard', echo_cmd=False)
diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index 8b61c6e524c2a..f3cc4017f443d 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -28,7 +28,7 @@ directory.
 In addition, users can supply a remote location for storing logs and log
 backups in cloud storage.
 
-In the Airflow Web UI, local logs take precedance over remote logs. If local logs
+In the Airflow Web UI, local logs take precedence over remote logs. If local logs
 can not be found or accessed, the remote logs will be displayed. Note that logs
 are only sent to remote storage once a task completes (including failure). In other
 words, remote logs for running tasks are unavailable. Logs are stored in the log
diff --git a/scripts/ci/kubernetes/kube/secrets.yaml b/scripts/ci/kubernetes/kube/secrets.yaml
index 4d533b36636e6..a93a0103e0f97 100644
--- a/scripts/ci/kubernetes/kube/secrets.yaml
+++ b/scripts/ci/kubernetes/kube/secrets.yaml
@@ -20,6 +20,6 @@ metadata:
   name: airflow-secrets
 type: Opaque
 data:
-  # The sql_alchemy_conn value is a base64 encoded represenation of this connection string:
+  # The sql_alchemy_conn value is a base64 encoded representation of this connection string:
   # postgresql+psycopg2://root:root@postgres-airflow:5432/airflow
   sql_alchemy_conn: cG9zdGdyZXNxbCtwc3ljb3BnMjovL3Jvb3Q6cm9vdEBwb3N0Z3Jlcy1haXJmbG93OjU0MzIvYWlyZmxvdwo=
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 74e3af452bf6f..40d806677c74e 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -52,12 +52,12 @@ def test_throws_exception_with_invalid_query(self):
         self.assertIn('Reason: ', str(context.exception), "")
 
     @unittest.skipIf(not bq_available, 'BQ is not available to run tests')
-    def test_suceeds_with_explicit_legacy_query(self):
+    def test_succeeds_with_explicit_legacy_query(self):
         df = self.instance.get_pandas_df('select 1', dialect='legacy')
         self.assertEqual(df.iloc(0)[0][0], 1)
 
     @unittest.skipIf(not bq_available, 'BQ is not available to run tests')
-    def test_suceeds_with_explicit_std_query(self):
+    def test_succeeds_with_explicit_std_query(self):
         df = self.instance.get_pandas_df(
             'select * except(b) from (select 1 a, 2 b)', dialect='standard')
         self.assertEqual(df.iloc(0)[0][0], 1)
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index 1467fff0b43eb..ab4604809c902 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -185,7 +185,7 @@ def test_check_success_tasks_raises_pending(self):
         client_mock.describe_tasks.assert_called_once_with(
             cluster='c', tasks=['arn'])
 
-    def test_check_success_tasks_raises_mutliple(self):
+    def test_check_success_tasks_raises_multiple(self):
         client_mock = mock.Mock()
         self.ecs.client = client_mock
         self.ecs.arn = 'arn'
diff --git a/tests/core.py b/tests/core.py
index 7d36676b5731b..ef8c9497e7ea0 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -843,7 +843,7 @@ def test_bad_trigger_rule(self):
         with self.assertRaises(AirflowException):
             DummyOperator(
                 task_id='test_bad_trigger',
-                trigger_rule="non_existant",
+                trigger_rule="non_existent",
                 dag=self.dag)
 
     def test_terminate_task(self):
diff --git a/tests/models.py b/tests/models.py
index 6c8fba070a4a2..954765d7fabb8 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -101,7 +101,7 @@ def test_dag_as_context_manager(self):
         """
         Test DAG as a context manager.
         When used as a context manager, Operators are automatically added to
-        the DAG (unless they specifiy a different DAG)
+        the DAG (unless they specify a different DAG)
         """
         dag = DAG(
             'dag',

From bae8f8622cfd9611cf100fb65f2f228c7d50ea11 Mon Sep 17 00:00:00 2001
From: Yuliya Volkova <xnuinside@gmail.com>
Date: Mon, 3 Sep 2018 23:30:22 +0300
Subject: [PATCH 291/808] [AIRFLOW-491] Add feature to pass extra api configs
 to BQ Hook (#3733)

---
 airflow/contrib/hooks/bigquery_hook.py        | 233 +++++++++++-------
 .../contrib/operators/bigquery_operator.py    |  18 +-
 tests/contrib/hooks/test_bigquery_hook.py     |  56 ++++-
 3 files changed, 208 insertions(+), 99 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 437c9b10cdadc..75c051e9a575a 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -24,6 +24,7 @@
 
 import time
 from builtins import range
+from copy import deepcopy
 
 from past.builtins import basestring
 
@@ -195,10 +196,19 @@ class BigQueryBaseCursor(LoggingMixin):
     PEP 249 cursor isn't needed.
     """
 
-    def __init__(self, service, project_id, use_legacy_sql=True):
+    def __init__(self,
+                 service,
+                 project_id,
+                 use_legacy_sql=True,
+                 api_resource_configs=None):
+
         self.service = service
         self.project_id = project_id
         self.use_legacy_sql = use_legacy_sql
+        if api_resource_configs:
+            _validate_value("api_resource_configs", api_resource_configs, dict)
+        self.api_resource_configs = api_resource_configs \
+            if api_resource_configs else {}
         self.running_job_id = None
 
     def create_empty_table(self,
@@ -238,8 +248,7 @@ def create_empty_table(self,
 
         :return:
         """
-        if time_partitioning is None:
-            time_partitioning = dict()
+
         project_id = project_id if project_id is not None else self.project_id
 
         table_resource = {
@@ -473,11 +482,11 @@ def create_external_table(self,
     def run_query(self,
                   bql=None,
                   sql=None,
-                  destination_dataset_table=False,
+                  destination_dataset_table=None,
                   write_disposition='WRITE_EMPTY',
                   allow_large_results=False,
                   flatten_results=None,
-                  udf_config=False,
+                  udf_config=None,
                   use_legacy_sql=None,
                   maximum_billing_tier=None,
                   maximum_bytes_billed=None,
@@ -486,7 +495,8 @@ def run_query(self,
                   labels=None,
                   schema_update_options=(),
                   priority='INTERACTIVE',
-                  time_partitioning=None):
+                  time_partitioning=None,
+                  api_resource_configs=None):
         """
         Executes a BigQuery SQL query. Optionally persists results in a BigQuery
         table. See here:
@@ -518,6 +528,13 @@ def run_query(self,
         :param use_legacy_sql: Whether to use legacy SQL (true) or standard SQL (false).
             If `None`, defaults to `self.use_legacy_sql`.
         :type use_legacy_sql: boolean
+        :param api_resource_configs: a dictionary that contain params
+            'configuration' applied for Google BigQuery Jobs API:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs
+            for example, {'query': {'useQueryCache': False}}. You could use it
+            if you need to provide some params that are not supported by the
+            BigQueryHook like args.
+        :type api_resource_configs: dict
         :type udf_config: list
         :param maximum_billing_tier: Positive integer that serves as a
             multiplier of the basic price.
@@ -548,12 +565,22 @@ def run_query(self,
         :type time_partitioning: dict
 
         """
+        if not api_resource_configs:
+            api_resource_configs = self.api_resource_configs
+        else:
+            _validate_value('api_resource_configs',
+                            api_resource_configs, dict)
+        configuration = deepcopy(api_resource_configs)
+        if 'query' not in configuration:
+            configuration['query'] = {}
+
+        else:
+            _validate_value("api_resource_configs['query']",
+                            configuration['query'], dict)
 
-        # TODO remove `bql` in Airflow 2.0 - Jira: [AIRFLOW-2513]
-        if time_partitioning is None:
-            time_partitioning = {}
         sql = bql if sql is None else sql
 
+        # TODO remove `bql` in Airflow 2.0 - Jira: [AIRFLOW-2513]
         if bql:
             import warnings
             warnings.warn('Deprecated parameter `bql` used in '
@@ -564,95 +591,109 @@ def run_query(self,
                           'Airflow.',
                           category=DeprecationWarning)
 
-        if sql is None:
-            raise TypeError('`BigQueryBaseCursor.run_query` missing 1 required '
-                            'positional argument: `sql`')
+        if sql is None and not configuration['query'].get('query', None):
+            raise TypeError('`BigQueryBaseCursor.run_query` '
+                            'missing 1 required positional argument: `sql`')
 
         # BigQuery also allows you to define how you want a table's schema to change
         # as a side effect of a query job
         # for more details:
         #   https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.schemaUpdateOptions
+
         allowed_schema_update_options = [
             'ALLOW_FIELD_ADDITION', "ALLOW_FIELD_RELAXATION"
         ]
-        if not set(allowed_schema_update_options).issuperset(
-                set(schema_update_options)):
-            raise ValueError(
-                "{0} contains invalid schema update options. "
-                "Please only use one or more of the following options: {1}"
-                .format(schema_update_options, allowed_schema_update_options))
 
-        if use_legacy_sql is None:
-            use_legacy_sql = self.use_legacy_sql
+        if not set(allowed_schema_update_options
+                   ).issuperset(set(schema_update_options)):
+            raise ValueError("{0} contains invalid schema update options. "
+                             "Please only use one or more of the following "
+                             "options: {1}"
+                             .format(schema_update_options,
+                                     allowed_schema_update_options))
 
-        configuration = {
-            'query': {
-                'query': sql,
-                'useLegacySql': use_legacy_sql,
-                'maximumBillingTier': maximum_billing_tier,
-                'maximumBytesBilled': maximum_bytes_billed,
-                'priority': priority
-            }
-        }
+        if schema_update_options:
+            if write_disposition not in ["WRITE_APPEND", "WRITE_TRUNCATE"]:
+                raise ValueError("schema_update_options is only "
+                                 "allowed if write_disposition is "
+                                 "'WRITE_APPEND' or 'WRITE_TRUNCATE'.")
 
         if destination_dataset_table:
-            if '.' not in destination_dataset_table:
-                raise ValueError(
-                    'Expected destination_dataset_table name in the format of '
-                    '<dataset>.<table>. Got: {}'.format(
-                        destination_dataset_table))
             destination_project, destination_dataset, destination_table = \
                 _split_tablename(table_input=destination_dataset_table,
                                  default_project_id=self.project_id)
-            configuration['query'].update({
-                'allowLargeResults': allow_large_results,
-                'flattenResults': flatten_results,
-                'writeDisposition': write_disposition,
-                'createDisposition': create_disposition,
-                'destinationTable': {
-                    'projectId': destination_project,
-                    'datasetId': destination_dataset,
-                    'tableId': destination_table,
-                }
-            })
-        if udf_config:
-            if not isinstance(udf_config, list):
-                raise TypeError("udf_config argument must have a type 'list'"
-                                " not {}".format(type(udf_config)))
-            configuration['query'].update({
-                'userDefinedFunctionResources': udf_config
-            })
 
-        if query_params:
-            if self.use_legacy_sql:
-                raise ValueError("Query parameters are not allowed when using "
-                                 "legacy SQL")
-            else:
-                configuration['query']['queryParameters'] = query_params
+            destination_dataset_table = {
+                'projectId': destination_project,
+                'datasetId': destination_dataset,
+                'tableId': destination_table,
+            }
 
-        if labels:
-            configuration['labels'] = labels
+        query_param_list = [
+            (sql, 'query', None, str),
+            (priority, 'priority', 'INTERACTIVE', str),
+            (use_legacy_sql, 'useLegacySql', self.use_legacy_sql, bool),
+            (query_params, 'queryParameters', None, dict),
+            (udf_config, 'userDefinedFunctionResources', None, list),
+            (maximum_billing_tier, 'maximumBillingTier', None, int),
+            (maximum_bytes_billed, 'maximumBytesBilled', None, float),
+            (time_partitioning, 'timePartitioning', {}, dict),
+            (schema_update_options, 'schemaUpdateOptions', None, tuple),
+            (destination_dataset_table, 'destinationTable', None, dict)
+        ]
 
-        time_partitioning = _cleanse_time_partitioning(
-            destination_dataset_table,
-            time_partitioning
-        )
-        if time_partitioning:
-            configuration['query'].update({
-                'timePartitioning': time_partitioning
-            })
+        for param_tuple in query_param_list:
 
-        if schema_update_options:
-            if write_disposition not in ["WRITE_APPEND", "WRITE_TRUNCATE"]:
-                raise ValueError("schema_update_options is only "
-                                 "allowed if write_disposition is "
-                                 "'WRITE_APPEND' or 'WRITE_TRUNCATE'.")
-            else:
-                self.log.info(
-                    "Adding experimental "
-                    "'schemaUpdateOptions': {0}".format(schema_update_options))
-                configuration['query'][
-                    'schemaUpdateOptions'] = schema_update_options
+            param, param_name, param_default, param_type = param_tuple
+
+            if param_name not in configuration['query'] and param in [None, {}, ()]:
+                if param_name == 'timePartitioning':
+                    param_default = _cleanse_time_partitioning(
+                        destination_dataset_table, time_partitioning)
+                param = param_default
+
+            if param not in [None, {}, ()]:
+                _api_resource_configs_duplication_check(
+                    param_name, param, configuration['query'])
+
+                configuration['query'][param_name] = param
+
+                # check valid type of provided param,
+                # it last step because we can get param from 2 sources,
+                # and first of all need to find it
+
+                _validate_value(param_name, configuration['query'][param_name],
+                                param_type)
+
+                if param_name == 'schemaUpdateOptions' and param:
+                    self.log.info("Adding experimental 'schemaUpdateOptions': "
+                                  "{0}".format(schema_update_options))
+
+                if param_name == 'destinationTable':
+                    for key in ['projectId', 'datasetId', 'tableId']:
+                        if key not in configuration['query']['destinationTable']:
+                            raise ValueError(
+                                "Not correct 'destinationTable' in "
+                                "api_resource_configs. 'destinationTable' "
+                                "must be a dict with {'projectId':'', "
+                                "'datasetId':'', 'tableId':''}")
+
+                    configuration['query'].update({
+                        'allowLargeResults': allow_large_results,
+                        'flattenResults': flatten_results,
+                        'writeDisposition': write_disposition,
+                        'createDisposition': create_disposition,
+                    })
+
+        if 'useLegacySql' in configuration['query'] and \
+                'queryParameters' in configuration['query']:
+            raise ValueError("Query parameters are not allowed "
+                             "when using legacy SQL")
+
+        if labels:
+            _api_resource_configs_duplication_check(
+                'labels', labels, configuration)
+            configuration['labels'] = labels
 
         return self.run_with_configuration(configuration)
 
@@ -884,8 +925,7 @@ def run_load(self,
         #   https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).sourceFormat
         if src_fmt_configs is None:
             src_fmt_configs = {}
-        if time_partitioning is None:
-            time_partitioning = {}
+
         source_format = source_format.upper()
         allowed_formats = [
             "CSV", "NEWLINE_DELIMITED_JSON", "AVRO", "GOOGLE_SHEETS",
@@ -1163,10 +1203,6 @@ def run_table_delete(self, deletion_dataset_table,
         :type ignore_if_missing: boolean
         :return:
         """
-        if '.' not in deletion_dataset_table:
-            raise ValueError(
-                'Expected deletion_dataset_table name in the format of '
-                '<dataset>.<table>. Got: {}'.format(deletion_dataset_table))
         deletion_project, deletion_dataset, deletion_table = \
             _split_tablename(table_input=deletion_dataset_table,
                              default_project_id=self.project_id)
@@ -1532,6 +1568,12 @@ def _bq_cast(string_field, bq_type):
 
 
 def _split_tablename(table_input, default_project_id, var_name=None):
+
+    if '.' not in table_input:
+        raise ValueError(
+            'Expected deletion_dataset_table name in the format of '
+            '<dataset>.<table>. Got: {}'.format(table_input))
+
     if not default_project_id:
         raise ValueError("INTERNAL: No default project is specified")
 
@@ -1593,8 +1635,29 @@ def var_print(var_name):
 
 def _cleanse_time_partitioning(destination_dataset_table, time_partitioning_in):
     # if it is a partitioned table ($ is in the table name) add partition load option
+
+    if time_partitioning_in is None:
+        time_partitioning_in = {}
+
     time_partitioning_out = {}
     if destination_dataset_table and '$' in destination_dataset_table:
         time_partitioning_out['type'] = 'DAY'
     time_partitioning_out.update(time_partitioning_in)
     return time_partitioning_out
+
+
+def _validate_value(key, value, expected_type):
+    """ function to check expected type and raise
+    error if type is not correct """
+    if not isinstance(value, expected_type):
+        raise TypeError("{} argument must have a type {} not {}".format(
+            key, expected_type, type(value)))
+
+
+def _api_resource_configs_duplication_check(key, value, config_dict):
+    if key in config_dict and value != config_dict[key]:
+        raise ValueError("Values of {param_name} param are duplicated. "
+                         "`api_resource_configs` contained {param_name} param "
+                         "in `query` config and {param_name} was also provided "
+                         "with arg to run_query() method. Please remove duplicates."
+                         .format(param_name=key))
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 037b9fc43e631..c773ebb2e6f21 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -75,6 +75,13 @@ class BigQueryOperator(BaseOperator):
         (without incurring a charge). If unspecified, this will be
         set to your project default.
     :type maximum_bytes_billed: float
+    :param api_resource_configs: a dictionary that contain params
+        'configuration' applied for Google BigQuery Jobs API:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs
+        for example, {'query': {'useQueryCache': False}}. You could use it
+        if you need to provide some params that are not supported by BigQueryOperator
+        like args.
+    :type api_resource_configs: dict
     :param schema_update_options: Allows the schema of the destination
         table to be updated as a side effect of the load job.
     :type schema_update_options: tuple
@@ -116,7 +123,8 @@ def __init__(self,
                  query_params=None,
                  labels=None,
                  priority='INTERACTIVE',
-                 time_partitioning={},
+                 time_partitioning=None,
+                 api_resource_configs=None,
                  *args,
                  **kwargs):
         super(BigQueryOperator, self).__init__(*args, **kwargs)
@@ -138,7 +146,10 @@ def __init__(self,
         self.labels = labels
         self.bq_cursor = None
         self.priority = priority
-        self.time_partitioning = time_partitioning
+        if time_partitioning is None:
+            self.time_partitioning = {}
+        if api_resource_configs is None:
+            self.api_resource_configs = {}
 
         # TODO remove `bql` in Airflow 2.0
         if self.bql:
@@ -177,7 +188,8 @@ def execute(self, context):
             labels=self.labels,
             schema_update_options=self.schema_update_options,
             priority=self.priority,
-            time_partitioning=self.time_partitioning
+            time_partitioning=self.time_partitioning,
+            api_resource_configs=self.api_resource_configs,
         )
 
     def on_kill(self):
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 40d806677c74e..4a97ea7aa4d3c 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -25,7 +25,8 @@
 import mock
 
 from airflow.contrib.hooks import bigquery_hook as hook
-from airflow.contrib.hooks.bigquery_hook import _cleanse_time_partitioning
+from airflow.contrib.hooks.bigquery_hook import _cleanse_time_partitioning, \
+    _validate_value, _api_resource_configs_duplication_check
 
 bq_available = True
 
@@ -206,6 +207,16 @@ def mock_job_cancel(projectId, jobId):
 
 
 class TestBigQueryBaseCursor(unittest.TestCase):
+    def test_bql_deprecation_warning(self):
+        with warnings.catch_warnings(record=True) as w:
+            hook.BigQueryBaseCursor("test", "test").run_query(
+                bql='select * from test_table'
+            )
+            yield
+        self.assertIn(
+            'Deprecated parameter `bql`',
+            w[0].message.args[0])
+
     def test_invalid_schema_update_options(self):
         with self.assertRaises(Exception) as context:
             hook.BigQueryBaseCursor("test", "test").run_load(
@@ -216,16 +227,6 @@ def test_invalid_schema_update_options(self):
             )
         self.assertIn("THIS IS NOT VALID", str(context.exception))
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_bql_deprecation_warning(self, mock_rwc):
-        with warnings.catch_warnings(record=True) as w:
-            hook.BigQueryBaseCursor("test", "test").run_query(
-                bql='select * from test_table'
-            )
-        self.assertIn(
-            'Deprecated parameter `bql`',
-            w[0].message.args[0])
-
     def test_nobql_nosql_param_error(self):
         with self.assertRaises(TypeError) as context:
             hook.BigQueryBaseCursor("test", "test").run_query(
@@ -281,6 +282,39 @@ def test_run_query_sql_dialect_override(self, run_with_config):
             args, kwargs = run_with_config.call_args
             self.assertIs(args[0]['query']['useLegacySql'], bool_val)
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_api_resource_configs(self, run_with_config):
+        for bool_val in [True, False]:
+            cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
+            cursor.run_query('query',
+                             api_resource_configs={
+                                 'query': {'useQueryCache': bool_val}})
+            args, kwargs = run_with_config.call_args
+            self.assertIs(args[0]['query']['useQueryCache'], bool_val)
+            self.assertIs(args[0]['query']['useLegacySql'], True)
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_api_resource_configs_duplication_warning(self, run_with_config):
+        with self.assertRaises(ValueError):
+            cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
+            cursor.run_query('query',
+                             use_legacy_sql=True,
+                             api_resource_configs={
+                                 'query': {'useLegacySql': False}})
+
+    def test_validate_value(self):
+        with self.assertRaises(TypeError):
+            _validate_value("case_1", "a", dict)
+        self.assertIsNone(_validate_value("case_2", 0, int))
+
+    def test_duplication_check(self):
+        with self.assertRaises(ValueError):
+            key_one = True
+            _api_resource_configs_duplication_check(
+                "key_one", key_one, {"key_one": False})
+        self.assertIsNone(_api_resource_configs_duplication_check(
+            "key_one", key_one, {"key_one": True}))
+
 
 class TestLabelsInRunJob(unittest.TestCase):
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')

From 1b552cddcb6b22594f7df4aace3ca383d3a5b5da Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Wed, 20 Jun 2018 20:36:32 +0200
Subject: [PATCH 292/808] [AIRFLOW-2640] Add Cassandra table sensor

Just like a partition sensor for Hive,
this PR adds a sensor that waits for
a table to be created in Cassandra cluster.

Closes #3518 from sekikn/AIRFLOW-2640
---
 airflow/contrib/hooks/cassandra_hook.py       | 19 ++++-
 ...a_sensor.py => cassandra_record_sensor.py} |  7 +-
 .../contrib/sensors/cassandra_table_sensor.py | 56 +++++++++++++
 docs/code.rst                                 |  3 +-
 tests/contrib/hooks/test_cassandra_hook.py    | 81 +++++++++++++++++--
 .../contrib/sensors/test_cassandra_sensor.py  | 25 +++++-
 6 files changed, 176 insertions(+), 15 deletions(-)
 rename airflow/contrib/sensors/{cassandra_sensor.py => cassandra_record_sensor.py} (88%)
 create mode 100644 airflow/contrib/sensors/cassandra_table_sensor.py

diff --git a/airflow/contrib/hooks/cassandra_hook.py b/airflow/contrib/hooks/cassandra_hook.py
index 704ba0d8d03e2..0e0b47708d5a5 100644
--- a/airflow/contrib/hooks/cassandra_hook.py
+++ b/airflow/contrib/hooks/cassandra_hook.py
@@ -158,6 +158,21 @@ def get_lb_policy(policy_name, policy_args):
                                                            child_policy_args)
                 return TokenAwarePolicy(child_policy)
 
+    def table_exists(self, table):
+        """
+        Checks if a table exists in Cassandra
+
+        :param table: Target Cassandra table.
+                      Use dot notation to target a specific keyspace.
+        :type table: string
+        """
+        keyspace = self.keyspace
+        if '.' in table:
+            keyspace, table = table.split('.', 1)
+        cluster_metadata = self.get_conn().cluster.metadata
+        return (keyspace in cluster_metadata.keyspaces and
+                table in cluster_metadata.keyspaces[keyspace].tables)
+
     def record_exists(self, table, keys):
         """
         Checks if a record exists in Cassandra
@@ -168,12 +183,12 @@ def record_exists(self, table, keys):
         :param keys: The keys and their values to check the existence.
         :type keys: dict
         """
-        keyspace = None
+        keyspace = self.keyspace
         if '.' in table:
             keyspace, table = table.split('.', 1)
         ks = " AND ".join("{}=%({})s".format(key, key) for key in keys.keys())
         cql = "SELECT * FROM {keyspace}.{table} WHERE {keys}".format(
-            keyspace=(keyspace or self.keyspace), table=table, keys=ks)
+            keyspace=keyspace, table=table, keys=ks)
 
         try:
             rs = self.get_conn().execute(cql, keys)
diff --git a/airflow/contrib/sensors/cassandra_sensor.py b/airflow/contrib/sensors/cassandra_record_sensor.py
similarity index 88%
rename from airflow/contrib/sensors/cassandra_sensor.py
rename to airflow/contrib/sensors/cassandra_record_sensor.py
index aef66122e90c2..493a6ba6b1e08 100644
--- a/airflow/contrib/sensors/cassandra_sensor.py
+++ b/airflow/contrib/sensors/cassandra_record_sensor.py
@@ -29,9 +29,10 @@ class CassandraRecordSensor(BaseSensorOperator):
     primary keys 'p1' and 'p2' to be populated in keyspace 'k' and table 't',
     instantiate it as follows:
 
-    >>> CassandraRecordSensor(table="k.t", keys={"p1": "v1", "p2": "v2"},
-    ...     cassandra_conn_id="cassandra_default", task_id="cassandra_sensor")
-    <Task(CassandraRecordSensor): cassandra_sensor>
+    >>> cassandra_sensor = CassandraRecordSensor(table="k.t",
+    ...                                          keys={"p1": "v1", "p2": "v2"},
+    ...                                          cassandra_conn_id="cassandra_default",
+    ...                                          task_id="cassandra_sensor")
     """
     template_fields = ('table', 'keys')
 
diff --git a/airflow/contrib/sensors/cassandra_table_sensor.py b/airflow/contrib/sensors/cassandra_table_sensor.py
new file mode 100644
index 0000000000000..5a85995acaaec
--- /dev/null
+++ b/airflow/contrib/sensors/cassandra_table_sensor.py
@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow.contrib.hooks.cassandra_hook import CassandraHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class CassandraTableSensor(BaseSensorOperator):
+    """
+    Checks for the existence of a table in a Cassandra cluster.
+
+    For example, if you want to wait for a table called 't' to be created
+    in a keyspace 'k', instantiate it as follows:
+
+    >>> cassandra_sensor = CassandraTableSensor(table="k.t",
+    ...                                         cassandra_conn_id="cassandra_default",
+    ...                                         task_id="cassandra_sensor")
+    """
+    template_fields = ('table',)
+
+    @apply_defaults
+    def __init__(self, table, cassandra_conn_id, *args, **kwargs):
+        """
+        Create a new CassandraTableSensor
+
+        :param table: Target Cassandra table.
+                      Use dot notation to target a specific keyspace.
+        :type table: string
+        :param cassandra_conn_id: The connection ID to use
+                                  when connecting to Cassandra cluster
+        :type cassandra_conn_id: string
+        """
+        super(CassandraTableSensor, self).__init__(*args, **kwargs)
+        self.cassandra_conn_id = cassandra_conn_id
+        self.table = table
+
+    def poke(self, context):
+        self.log.info('Sensor check existence of table: %s', self.table)
+        hook = CassandraHook(self.cassandra_conn_id)
+        return hook.table_exists(self.table)
diff --git a/docs/code.rst b/docs/code.rst
index f9b5c23eba539..744c9b6cf60ce 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -233,7 +233,8 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
 .. autoclass:: airflow.contrib.sensors.bash_sensor.BashSensor
 .. autoclass:: airflow.contrib.sensors.bigquery_sensor.BigQueryTableSensor
-.. autoclass:: airflow.contrib.sensors.cassandra_sensor.CassandraRecordSensor
+.. autoclass:: airflow.contrib.sensors.cassandra_record_sensor.CassandraRecordSensor
+.. autoclass:: airflow.contrib.sensors.cassandra_table_sensor.CassandraTableSensor
 .. autoclass:: airflow.contrib.sensors.datadog_sensor.DatadogSensor
 .. autoclass:: airflow.contrib.sensors.emr_base_sensor.EmrBaseSensor
 .. autoclass:: airflow.contrib.sensors.emr_job_flow_sensor.EmrJobFlowSensor
diff --git a/tests/contrib/hooks/test_cassandra_hook.py b/tests/contrib/hooks/test_cassandra_hook.py
index e420ec009583a..9cb0739993173 100644
--- a/tests/contrib/hooks/test_cassandra_hook.py
+++ b/tests/contrib/hooks/test_cassandra_hook.py
@@ -39,6 +39,25 @@ def setUp(self):
                 conn_id='cassandra_test', conn_type='cassandra',
                 host='host-1,host-2', port='9042', schema='test_keyspace',
                 extra='{"load_balancing_policy":"TokenAwarePolicy"}'))
+        db.merge_conn(
+            models.Connection(
+                conn_id='cassandra_default_with_schema', conn_type='cassandra',
+                host='localhost', port='9042', schema='s'))
+
+        hook = CassandraHook("cassandra_default")
+        session = hook.get_conn()
+        cqls = [
+            "DROP SCHEMA IF EXISTS s",
+            """
+                CREATE SCHEMA s WITH REPLICATION =
+                    { 'class' : 'SimpleStrategy', 'replication_factor' : 1 }
+            """,
+        ]
+        for cql in cqls:
+            session.execute(cql)
+
+        session.shutdown()
+        hook.shutdown_cluster()
 
     def test_get_conn(self):
         with mock.patch.object(Cluster, "connect") as mock_connect, \
@@ -117,16 +136,10 @@ def _assert_get_lb_policy(self, policy_name, policy_args, expected_policy_type,
             thrown = True
         self.assertEqual(should_throw, thrown)
 
-    def test_record_exists(self):
-        hook = CassandraHook()
+    def test_record_exists_with_keyspace_from_cql(self):
+        hook = CassandraHook("cassandra_default")
         session = hook.get_conn()
-
         cqls = [
-            "DROP SCHEMA IF EXISTS s",
-            """
-                CREATE SCHEMA s WITH REPLICATION =
-                    { 'class' : 'SimpleStrategy', 'replication_factor' : 1 }
-            """,
             "DROP TABLE IF EXISTS s.t",
             "CREATE TABLE s.t (pk1 text, pk2 text, c text, PRIMARY KEY (pk1, pk2))",
             "INSERT INTO s.t (pk1, pk2, c) VALUES ('foo', 'bar', 'baz')",
@@ -137,6 +150,58 @@ def test_record_exists(self):
         self.assertTrue(hook.record_exists("s.t", {"pk1": "foo", "pk2": "bar"}))
         self.assertFalse(hook.record_exists("s.t", {"pk1": "foo", "pk2": "baz"}))
 
+        session.shutdown()
+        hook.shutdown_cluster()
+
+    def test_record_exists_with_keyspace_from_session(self):
+        hook = CassandraHook("cassandra_default_with_schema")
+        session = hook.get_conn()
+        cqls = [
+            "DROP TABLE IF EXISTS t",
+            "CREATE TABLE t (pk1 text, pk2 text, c text, PRIMARY KEY (pk1, pk2))",
+            "INSERT INTO t (pk1, pk2, c) VALUES ('foo', 'bar', 'baz')",
+        ]
+        for cql in cqls:
+            session.execute(cql)
+
+        self.assertTrue(hook.record_exists("t", {"pk1": "foo", "pk2": "bar"}))
+        self.assertFalse(hook.record_exists("t", {"pk1": "foo", "pk2": "baz"}))
+
+        session.shutdown()
+        hook.shutdown_cluster()
+
+    def test_table_exists_with_keyspace_from_cql(self):
+        hook = CassandraHook("cassandra_default")
+        session = hook.get_conn()
+        cqls = [
+            "DROP TABLE IF EXISTS s.t",
+            "CREATE TABLE s.t (pk1 text PRIMARY KEY)",
+        ]
+        for cql in cqls:
+            session.execute(cql)
+
+        self.assertTrue(hook.table_exists("s.t"))
+        self.assertFalse(hook.table_exists("s.u"))
+
+        session.shutdown()
+        hook.shutdown_cluster()
+
+    def test_table_exists_with_keyspace_from_session(self):
+        hook = CassandraHook("cassandra_default_with_schema")
+        session = hook.get_conn()
+        cqls = [
+            "DROP TABLE IF EXISTS t",
+            "CREATE TABLE t (pk1 text PRIMARY KEY)",
+        ]
+        for cql in cqls:
+            session.execute(cql)
+
+        self.assertTrue(hook.table_exists("t"))
+        self.assertFalse(hook.table_exists("u"))
+
+        session.shutdown()
+        hook.shutdown_cluster()
+
 
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/sensors/test_cassandra_sensor.py b/tests/contrib/sensors/test_cassandra_sensor.py
index 0f0e7f5eb3b56..c07bc0be2a44d 100644
--- a/tests/contrib/sensors/test_cassandra_sensor.py
+++ b/tests/contrib/sensors/test_cassandra_sensor.py
@@ -24,7 +24,8 @@
 
 from airflow import DAG
 from airflow import configuration
-from airflow.contrib.sensors.cassandra_sensor import CassandraRecordSensor
+from airflow.contrib.sensors.cassandra_record_sensor import CassandraRecordSensor
+from airflow.contrib.sensors.cassandra_table_sensor import CassandraTableSensor
 from airflow.utils import timezone
 
 
@@ -54,5 +55,27 @@ def test_poke(self, mock_record_exists):
         mock_record_exists.assert_called_once_with('t', {'foo': 'bar'})
 
 
+class TestCassandraTableSensor(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+        self.sensor = CassandraTableSensor(
+            task_id='test_task',
+            cassandra_conn_id='cassandra_default',
+            dag=self.dag,
+            table='t',
+        )
+
+    @patch("airflow.contrib.hooks.cassandra_hook.CassandraHook.table_exists")
+    def test_poke(self, mock_table_exists):
+        self.sensor.poke(None)
+        mock_table_exists.assert_called_once_with('t')
+
+
 if __name__ == '__main__':
     unittest.main()

From e9207f2f577567177887525db62c234d3ee2ebaa Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Wed, 18 Jul 2018 09:04:25 -0700
Subject: [PATCH 293/808] [AIRFLOW-2758] Add a sensor for MongoDB

This PR adds a sensor for MongoDB,
which waits for some document that
matches the given query to be
inserted to the specified collection.

Closes #3611 from sekikn/AIRFLOW-2758
---
 .travis.yml                                |  1 +
 airflow/contrib/sensors/mongo_sensor.py    | 58 +++++++++++++++++++
 tests/contrib/sensors/test_mongo_sensor.py | 65 ++++++++++++++++++++++
 3 files changed, 124 insertions(+)
 create mode 100644 airflow/contrib/sensors/mongo_sensor.py
 create mode 100644 tests/contrib/sensors/test_mongo_sensor.py

diff --git a/.travis.yml b/.travis.yml
index defad4f8ebd9c..fae1ecc5f04f3 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -23,6 +23,7 @@ jdk:
   - openjdk8
 services:
   - cassandra
+  - mongodb
   - mysql
   - postgresql
   - rabbitmq
diff --git a/airflow/contrib/sensors/mongo_sensor.py b/airflow/contrib/sensors/mongo_sensor.py
new file mode 100644
index 0000000000000..3ed49a6f9d64f
--- /dev/null
+++ b/airflow/contrib/sensors/mongo_sensor.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow.contrib.hooks.mongo_hook import MongoHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class MongoSensor(BaseSensorOperator):
+    """
+    Checks for the existence of a document which
+    matches the given query in MongoDB. Example:
+
+    >>> mongo_sensor = MongoSensor(collection="coll",
+    ...                            query={"key": "value"},
+    ...                            mongo_conn_id="mongo_default",
+    ...                            task_id="mongo_sensor")
+    """
+    template_fields = ('collection', 'query')
+
+    @apply_defaults
+    def __init__(self, collection, query, mongo_conn_id="mongo_default", *args, **kwargs):
+        """
+        Create a new MongoSensor
+
+        :param collection: Target MongoDB collection.
+        :type collection: string
+        :param query: The query to find the target document.
+        :type query: dict
+        :param mongo_conn_id: The connection ID to use
+                              when connecting to MongoDB.
+        :type mongo_conn_id: string
+        """
+        super(MongoSensor, self).__init__(*args, **kwargs)
+        self.mongo_conn_id = mongo_conn_id
+        self.collection = collection
+        self.query = query
+
+    def poke(self, context):
+        self.log.info("Sensor check existence of the document "
+                      "that matches the following query: %s", self.query)
+        hook = MongoHook(self.mongo_conn_id)
+        return hook.find(self.collection, self.query, find_one=True) is not None
diff --git a/tests/contrib/sensors/test_mongo_sensor.py b/tests/contrib/sensors/test_mongo_sensor.py
new file mode 100644
index 0000000000000..876cb99ba4251
--- /dev/null
+++ b/tests/contrib/sensors/test_mongo_sensor.py
@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+import unittest
+
+from airflow import DAG
+from airflow import configuration
+from airflow.contrib.hooks.mongo_hook import MongoHook
+from airflow.contrib.sensors.mongo_sensor import MongoSensor
+from airflow.models import Connection
+from airflow.utils import db, timezone
+
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+
+class TestMongoSensor(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id='mongo_test', conn_type='mongo',
+                host='localhost', port='27017', schema='test'))
+
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+
+        hook = MongoHook('mongo_test')
+        hook.insert_one('foo', {'bar': 'baz'})
+
+        self.sensor = MongoSensor(
+            task_id='test_task',
+            mongo_conn_id='mongo_test',
+            dag=self.dag,
+            collection='foo',
+            query={'bar': 'baz'}
+        )
+
+    def test_poke(self):
+        self.assertTrue(self.sensor.poke(None))
+
+
+if __name__ == '__main__':
+    unittest.main()

From b1f69889ea5178e05d13d9b461d850d07cffef5f Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 28 Aug 2018 20:36:29 +0800
Subject: [PATCH 294/808] [AIRFLOW-2916] Arg `verify` for AwsHook() & S3
 sensors/operators (#3764)

---
 airflow/contrib/hooks/aws_hook.py             |  7 ++++---
 airflow/contrib/operators/gcs_to_s3.py        | 14 ++++++++++++-
 airflow/contrib/operators/s3_list_operator.py | 14 ++++++++++++-
 .../contrib/operators/s3_to_gcs_operator.py   | 14 ++++++++++++-
 airflow/operators/redshift_to_s3_operator.py  | 14 ++++++++++++-
 .../operators/s3_file_transform_operator.py   | 21 +++++++++++++++++--
 airflow/operators/s3_to_hive_operator.py      | 14 ++++++++++++-
 airflow/operators/s3_to_redshift_operator.py  | 14 ++++++++++++-
 airflow/sensors/s3_key_sensor.py              | 14 ++++++++++++-
 airflow/sensors/s3_prefix_sensor.py           | 14 ++++++++++++-
 .../operators/test_s3_to_gcs_operator.py      |  4 ++--
 11 files changed, 129 insertions(+), 15 deletions(-)

diff --git a/airflow/contrib/hooks/aws_hook.py b/airflow/contrib/hooks/aws_hook.py
index 5716eb3c0305e..9d4a73e1c0c6b 100644
--- a/airflow/contrib/hooks/aws_hook.py
+++ b/airflow/contrib/hooks/aws_hook.py
@@ -83,8 +83,9 @@ class AwsHook(BaseHook):
     This class is a thin wrapper around the boto3 python library.
     """
 
-    def __init__(self, aws_conn_id='aws_default'):
+    def __init__(self, aws_conn_id='aws_default', verify=None):
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
 
     def _get_credentials(self, region_name):
         aws_access_key_id = None
@@ -166,13 +167,13 @@ def get_client_type(self, client_type, region_name=None, config=None):
         session, endpoint_url = self._get_credentials(region_name)
 
         return session.client(client_type, endpoint_url=endpoint_url,
-                              config=config)
+                              config=config, verify=self.verify)
 
     def get_resource_type(self, resource_type, region_name=None, config=None):
         session, endpoint_url = self._get_credentials(region_name)
 
         return session.resource(resource_type, endpoint_url=endpoint_url,
-                                config=config)
+                                config=config, verify=self.verify)
 
     def get_session(self, region_name=None):
         """Get the underlying boto3.session."""
diff --git a/airflow/contrib/operators/gcs_to_s3.py b/airflow/contrib/operators/gcs_to_s3.py
index a87aa3af5c531..0df6170eab377 100644
--- a/airflow/contrib/operators/gcs_to_s3.py
+++ b/airflow/contrib/operators/gcs_to_s3.py
@@ -47,6 +47,16 @@ class GoogleCloudStorageToS3Operator(GoogleCloudStorageListOperator):
     :type dest_aws_conn_id: str
     :param dest_s3_key: The base S3 key to be used to store the files. (templated)
     :type dest_s3_key: str
+    :parame dest_verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type dest_verify: bool or str
     """
     template_fields = ('bucket', 'prefix', 'delimiter', 'dest_s3_key')
     ui_color = '#f0eee4'
@@ -60,6 +70,7 @@ def __init__(self,
                  delegate_to=None,
                  dest_aws_conn_id=None,
                  dest_s3_key=None,
+                 dest_verify=None,
                  replace=False,
                  *args,
                  **kwargs):
@@ -75,12 +86,13 @@ def __init__(self,
         )
         self.dest_aws_conn_id = dest_aws_conn_id
         self.dest_s3_key = dest_s3_key
+        self.dest_verify = dest_verify
         self.replace = replace
 
     def execute(self, context):
         # use the super to list all files in an Google Cloud Storage bucket
         files = super(GoogleCloudStorageToS3Operator, self).execute(context)
-        s3_hook = S3Hook(aws_conn_id=self.dest_aws_conn_id)
+        s3_hook = S3Hook(aws_conn_id=self.dest_aws_conn_id, verify=self.dest_verify)
 
         if not self.replace:
             # if we are not replacing -> list all files in the S3 bucket
diff --git a/airflow/contrib/operators/s3_list_operator.py b/airflow/contrib/operators/s3_list_operator.py
index b85691b005fb9..a9e005eed3f65 100644
--- a/airflow/contrib/operators/s3_list_operator.py
+++ b/airflow/contrib/operators/s3_list_operator.py
@@ -38,6 +38,16 @@ class S3ListOperator(BaseOperator):
     :type delimiter: string
     :param aws_conn_id: The connection ID to use when connecting to S3 storage.
     :type aws_conn_id: string
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
 
     **Example**:
         The following operator would list all the files
@@ -61,6 +71,7 @@ def __init__(self,
                  prefix='',
                  delimiter='',
                  aws_conn_id='aws_default',
+                 verify=None,
                  *args,
                  **kwargs):
         super(S3ListOperator, self).__init__(*args, **kwargs)
@@ -68,9 +79,10 @@ def __init__(self,
         self.prefix = prefix
         self.delimiter = delimiter
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
 
     def execute(self, context):
-        hook = S3Hook(aws_conn_id=self.aws_conn_id)
+        hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
 
         self.log.info(
             'Getting the list of files from bucket: {0} in prefix: {1} (Delimiter {2})'.
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index 64d7dc7cab976..81c48a9e157bc 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -41,6 +41,16 @@ class S3ToGoogleCloudStorageOperator(S3ListOperator):
     :type delimiter: string
     :param aws_conn_id: The source S3 connection
     :type aws_conn_id: string
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     :param dest_gcs_conn_id: The destination connection ID to use
         when connecting to Google Cloud Storage.
     :type dest_gcs_conn_id: string
@@ -80,6 +90,7 @@ def __init__(self,
                  prefix='',
                  delimiter='',
                  aws_conn_id='aws_default',
+                 verify=None,
                  dest_gcs_conn_id=None,
                  dest_gcs=None,
                  delegate_to=None,
@@ -98,6 +109,7 @@ def __init__(self,
         self.dest_gcs = dest_gcs
         self.delegate_to = delegate_to
         self.replace = replace
+        self.verify = verify
 
         if dest_gcs and not self._gcs_object_is_directory(self.dest_gcs):
             self.log.info(
@@ -146,7 +158,7 @@ def execute(self, context):
                     'There are no new files to sync. Have a nice day!')
 
         if files:
-            hook = S3Hook(aws_conn_id=self.aws_conn_id)
+            hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
 
             for file in files:
                 # GCS hook builds its own in-memory file so we have to create
diff --git a/airflow/operators/redshift_to_s3_operator.py b/airflow/operators/redshift_to_s3_operator.py
index 9c1b621dae965..e6682c78df3f7 100644
--- a/airflow/operators/redshift_to_s3_operator.py
+++ b/airflow/operators/redshift_to_s3_operator.py
@@ -39,6 +39,16 @@ class RedshiftToS3Transfer(BaseOperator):
     :type redshift_conn_id: string
     :param aws_conn_id: reference to a specific S3 connection
     :type aws_conn_id: string
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     :param unload_options: reference to a list of UNLOAD options
     :type unload_options: list
     """
@@ -56,6 +66,7 @@ def __init__(
             s3_key,
             redshift_conn_id='redshift_default',
             aws_conn_id='aws_default',
+            verify=None,
             unload_options=tuple(),
             autocommit=False,
             parameters=None,
@@ -68,6 +79,7 @@ def __init__(
         self.s3_key = s3_key
         self.redshift_conn_id = redshift_conn_id
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
         self.unload_options = unload_options
         self.autocommit = autocommit
         self.parameters = parameters
@@ -79,7 +91,7 @@ def __init__(
 
     def execute(self, context):
         self.hook = PostgresHook(postgres_conn_id=self.redshift_conn_id)
-        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id)
+        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         credentials = self.s3.get_credentials()
         unload_options = '\n\t\t\t'.join(self.unload_options)
 
diff --git a/airflow/operators/s3_file_transform_operator.py b/airflow/operators/s3_file_transform_operator.py
index 5111d455a832c..d1d8cfa58eec8 100644
--- a/airflow/operators/s3_file_transform_operator.py
+++ b/airflow/operators/s3_file_transform_operator.py
@@ -48,6 +48,17 @@ class S3FileTransformOperator(BaseOperator):
     :type source_s3_key: str
     :param source_aws_conn_id: source s3 connection
     :type source_aws_conn_id: str
+    :parame source_verify: Whether or not to verify SSL certificates for S3 connetion.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+        This is also applicable to ``dest_verify``.
+    :type source_verify: bool or str
     :param dest_s3_key: The key to be written from S3. (templated)
     :type dest_s3_key: str
     :param dest_aws_conn_id: destination s3 connection
@@ -72,14 +83,18 @@ def __init__(
             transform_script=None,
             select_expression=None,
             source_aws_conn_id='aws_default',
+            source_verify=None,
             dest_aws_conn_id='aws_default',
+            dest_verify=None,
             replace=False,
             *args, **kwargs):
         super(S3FileTransformOperator, self).__init__(*args, **kwargs)
         self.source_s3_key = source_s3_key
         self.source_aws_conn_id = source_aws_conn_id
+        self.source_verify = source_verify
         self.dest_s3_key = dest_s3_key
         self.dest_aws_conn_id = dest_aws_conn_id
+        self.dest_verify = dest_verify
         self.replace = replace
         self.transform_script = transform_script
         self.select_expression = select_expression
@@ -90,8 +105,10 @@ def execute(self, context):
             raise AirflowException(
                 "Either transform_script or select_expression must be specified")
 
-        source_s3 = S3Hook(aws_conn_id=self.source_aws_conn_id)
-        dest_s3 = S3Hook(aws_conn_id=self.dest_aws_conn_id)
+        source_s3 = S3Hook(aws_conn_id=self.source_aws_conn_id,
+                           verify=self.source_verify)
+        dest_s3 = S3Hook(aws_conn_id=self.dest_aws_conn_id,
+                         verify=self.dest_verify)
 
         self.log.info("Downloading source S3 file %s", self.source_s3_key)
         if not source_s3.check_for_key(self.source_s3_key):
diff --git a/airflow/operators/s3_to_hive_operator.py b/airflow/operators/s3_to_hive_operator.py
index b82ebce6fa295..85f05325f65be 100644
--- a/airflow/operators/s3_to_hive_operator.py
+++ b/airflow/operators/s3_to_hive_operator.py
@@ -78,6 +78,16 @@ class S3ToHiveTransfer(BaseOperator):
     :type delimiter: str
     :param aws_conn_id: source s3 connection
     :type aws_conn_id: str
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     :param hive_cli_conn_id: destination hive connection
     :type hive_cli_conn_id: str
     :param input_compressed: Boolean to determine if file decompression is
@@ -107,6 +117,7 @@ def __init__(
             check_headers=False,
             wildcard_match=False,
             aws_conn_id='aws_default',
+            verify=None,
             hive_cli_conn_id='hive_cli_default',
             input_compressed=False,
             tblproperties=None,
@@ -125,6 +136,7 @@ def __init__(
         self.wildcard_match = wildcard_match
         self.hive_cli_conn_id = hive_cli_conn_id
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
         self.input_compressed = input_compressed
         self.tblproperties = tblproperties
         self.select_expression = select_expression
@@ -136,7 +148,7 @@ def __init__(
 
     def execute(self, context):
         # Downloading file from S3
-        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id)
+        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         self.hive = HiveCliHook(hive_cli_conn_id=self.hive_cli_conn_id)
         self.log.info("Downloading S3 file")
 
diff --git a/airflow/operators/s3_to_redshift_operator.py b/airflow/operators/s3_to_redshift_operator.py
index 0d7921e9ed0f1..8c83f4437267f 100644
--- a/airflow/operators/s3_to_redshift_operator.py
+++ b/airflow/operators/s3_to_redshift_operator.py
@@ -39,6 +39,16 @@ class S3ToRedshiftTransfer(BaseOperator):
     :type redshift_conn_id: string
     :param aws_conn_id: reference to a specific S3 connection
     :type aws_conn_id: string
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     :param copy_options: reference to a list of COPY options
     :type copy_options: list
     """
@@ -56,6 +66,7 @@ def __init__(
             s3_key,
             redshift_conn_id='redshift_default',
             aws_conn_id='aws_default',
+            verify=None,
             copy_options=tuple(),
             autocommit=False,
             parameters=None,
@@ -67,13 +78,14 @@ def __init__(
         self.s3_key = s3_key
         self.redshift_conn_id = redshift_conn_id
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
         self.copy_options = copy_options
         self.autocommit = autocommit
         self.parameters = parameters
 
     def execute(self, context):
         self.hook = PostgresHook(postgres_conn_id=self.redshift_conn_id)
-        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id)
+        self.s3 = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         credentials = self.s3.get_credentials()
         copy_options = '\n\t\t\t'.join(self.copy_options)
 
diff --git a/airflow/sensors/s3_key_sensor.py b/airflow/sensors/s3_key_sensor.py
index fa2eb786ffa03..9eb7d2fb6553b 100644
--- a/airflow/sensors/s3_key_sensor.py
+++ b/airflow/sensors/s3_key_sensor.py
@@ -41,6 +41,16 @@ class S3KeySensor(BaseSensorOperator):
     :type wildcard_match: bool
     :param aws_conn_id: a reference to the s3 connection
     :type aws_conn_id: str
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     """
     template_fields = ('bucket_key', 'bucket_name')
 
@@ -50,6 +60,7 @@ def __init__(self,
                  bucket_name=None,
                  wildcard_match=False,
                  aws_conn_id='aws_default',
+                 verify=None,
                  *args,
                  **kwargs):
         super(S3KeySensor, self).__init__(*args, **kwargs)
@@ -68,10 +79,11 @@ def __init__(self,
         self.bucket_key = bucket_key
         self.wildcard_match = wildcard_match
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
 
     def poke(self, context):
         from airflow.hooks.S3_hook import S3Hook
-        hook = S3Hook(aws_conn_id=self.aws_conn_id)
+        hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         full_url = "s3://" + self.bucket_name + "/" + self.bucket_key
         self.log.info('Poking for key : {full_url}'.format(**locals()))
         if self.wildcard_match:
diff --git a/airflow/sensors/s3_prefix_sensor.py b/airflow/sensors/s3_prefix_sensor.py
index 42e574c5ee2b8..559e5a1348344 100644
--- a/airflow/sensors/s3_prefix_sensor.py
+++ b/airflow/sensors/s3_prefix_sensor.py
@@ -40,6 +40,16 @@ class S3PrefixSensor(BaseSensorOperator):
     :type delimiter: str
     :param aws_conn_id: a reference to the s3 connection
     :type aws_conn_id: str
+    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+        You can provide the following values:
+        - False: do not validate SSL certificates. SSL will still be used
+                 (unless use_ssl is False), but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
     """
     template_fields = ('prefix', 'bucket_name')
 
@@ -49,6 +59,7 @@ def __init__(self,
                  prefix,
                  delimiter='/',
                  aws_conn_id='aws_default',
+                 verify=None,
                  *args,
                  **kwargs):
         super(S3PrefixSensor, self).__init__(*args, **kwargs)
@@ -58,12 +69,13 @@ def __init__(self,
         self.delimiter = delimiter
         self.full_url = "s3://" + bucket_name + '/' + prefix
         self.aws_conn_id = aws_conn_id
+        self.verify = verify
 
     def poke(self, context):
         self.log.info('Poking for prefix : {self.prefix}\n'
                       'in bucket s3://{self.bucket_name}'.format(**locals()))
         from airflow.hooks.S3_hook import S3Hook
-        hook = S3Hook(aws_conn_id=self.aws_conn_id)
+        hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         return hook.check_for_prefix(
             prefix=self.prefix,
             delimiter=self.delimiter,
diff --git a/tests/contrib/operators/test_s3_to_gcs_operator.py b/tests/contrib/operators/test_s3_to_gcs_operator.py
index 807882c324936..97d6eae916d28 100644
--- a/tests/contrib/operators/test_s3_to_gcs_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_operator.py
@@ -88,8 +88,8 @@ def _assert_upload(bucket, object, tmp_filename):
 
         uploaded_files = operator.execute(None)
 
-        s3_one_mock_hook.assert_called_once_with(aws_conn_id=AWS_CONN_ID)
-        s3_two_mock_hook.assert_called_once_with(aws_conn_id=AWS_CONN_ID)
+        s3_one_mock_hook.assert_called_once_with(aws_conn_id=AWS_CONN_ID, verify=None)
+        s3_two_mock_hook.assert_called_once_with(aws_conn_id=AWS_CONN_ID, verify=None)
         gcs_mock_hook.assert_called_once_with(
             google_cloud_storage_conn_id=GCS_CONN_ID, delegate_to=None)
 

From 0a634aafb0da1d7feae440b467c76334af2799f8 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 31 Aug 2018 09:36:24 +0100
Subject: [PATCH 295/808] [AIRFLOW-XXX] Fix Docstrings for Operators (#3820)

---
 airflow/operators/s3_file_transform_operator.py | 15 ++++++++-------
 airflow/sensors/s3_key_sensor.py                |  2 +-
 airflow/sensors/s3_prefix_sensor.py             |  2 +-
 3 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/airflow/operators/s3_file_transform_operator.py b/airflow/operators/s3_file_transform_operator.py
index d1d8cfa58eec8..4a0b3ad2ee32c 100644
--- a/airflow/operators/s3_file_transform_operator.py
+++ b/airflow/operators/s3_file_transform_operator.py
@@ -48,15 +48,16 @@ class S3FileTransformOperator(BaseOperator):
     :type source_s3_key: str
     :param source_aws_conn_id: source s3 connection
     :type source_aws_conn_id: str
-    :parame source_verify: Whether or not to verify SSL certificates for S3 connetion.
+    :param source_verify: Whether or not to verify SSL certificates for S3 connetion.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
-                 (unless use_ssl is False), but SSL certificates will not be
-                 verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
-                 You can specify this argument if you want to use a different
-                 CA cert bundle than the one used by botocore.
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
+             (unless use_ssl is False), but SSL certificates will not be
+             verified.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
+             You can specify this argument if you want to use a different
+             CA cert bundle than the one used by botocore.
         This is also applicable to ``dest_verify``.
     :type source_verify: bool or str
     :param dest_s3_key: The key to be written from S3. (templated)
diff --git a/airflow/sensors/s3_key_sensor.py b/airflow/sensors/s3_key_sensor.py
index 9eb7d2fb6553b..4935561d057f1 100644
--- a/airflow/sensors/s3_key_sensor.py
+++ b/airflow/sensors/s3_key_sensor.py
@@ -41,7 +41,7 @@ class S3KeySensor(BaseSensorOperator):
     :type wildcard_match: bool
     :param aws_conn_id: a reference to the s3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
         - False: do not validate SSL certificates. SSL will still be used
diff --git a/airflow/sensors/s3_prefix_sensor.py b/airflow/sensors/s3_prefix_sensor.py
index 559e5a1348344..4617c97cf360e 100644
--- a/airflow/sensors/s3_prefix_sensor.py
+++ b/airflow/sensors/s3_prefix_sensor.py
@@ -40,7 +40,7 @@ class S3PrefixSensor(BaseSensorOperator):
     :type delimiter: str
     :param aws_conn_id: a reference to the s3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
         - False: do not validate SSL certificates. SSL will still be used

From ebec5e211b8654e52263e77ad923ab48413bf5df Mon Sep 17 00:00:00 2001
From: Gordon Ball <chronitis@gmail.com>
Date: Fri, 7 Sep 2018 18:41:03 +0200
Subject: [PATCH 296/808] [AIRFLOW-2997] Support cluster fields in bigquery
 (#3838)

This adds a cluster_fields argument to the bigquery hook, GCS to
bigquery operator and bigquery query operators. This field requests that
bigquery store the result of the query/load operation sorted according
to the specified fields (the order of fields given is significant).
---
 airflow/contrib/hooks/bigquery_hook.py        | 25 +++++-
 .../contrib/operators/bigquery_operator.py    |  7 ++
 airflow/contrib/operators/gcs_to_bq.py        | 10 ++-
 tests/contrib/hooks/test_bigquery_hook.py     | 88 +++++++++++++++++++
 4 files changed, 125 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 75c051e9a575a..bd337d53ae5bd 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -496,7 +496,8 @@ def run_query(self,
                   schema_update_options=(),
                   priority='INTERACTIVE',
                   time_partitioning=None,
-                  api_resource_configs=None):
+                  api_resource_configs=None,
+                  cluster_fields=None):
         """
         Executes a BigQuery SQL query. Optionally persists results in a BigQuery
         table. See here:
@@ -563,8 +564,12 @@ def run_query(self,
         :param time_partitioning: configure optional time partitioning fields i.e.
             partition by field, type and expiration as per API specifications.
         :type time_partitioning: dict
-
+        :param cluster_fields: Request that the result of this query be stored sorted
+            by one or more columns. This is only available in combination with
+            time_partitioning. The order of columns given determines the sort order.
+        :type cluster_fields: list of str
         """
+
         if not api_resource_configs:
             api_resource_configs = self.api_resource_configs
         else:
@@ -629,6 +634,9 @@ def run_query(self,
                 'tableId': destination_table,
             }
 
+        if cluster_fields:
+            cluster_fields = {'fields': cluster_fields}
+
         query_param_list = [
             (sql, 'query', None, str),
             (priority, 'priority', 'INTERACTIVE', str),
@@ -639,7 +647,8 @@ def run_query(self,
             (maximum_bytes_billed, 'maximumBytesBilled', None, float),
             (time_partitioning, 'timePartitioning', {}, dict),
             (schema_update_options, 'schemaUpdateOptions', None, tuple),
-            (destination_dataset_table, 'destinationTable', None, dict)
+            (destination_dataset_table, 'destinationTable', None, dict),
+            (cluster_fields, 'clustering', None, dict),
         ]
 
         for param_tuple in query_param_list:
@@ -854,7 +863,8 @@ def run_load(self,
                  allow_jagged_rows=False,
                  schema_update_options=(),
                  src_fmt_configs=None,
-                 time_partitioning=None):
+                 time_partitioning=None,
+                 cluster_fields=None):
         """
         Executes a BigQuery load command to load data from Google Cloud Storage
         to BigQuery. See here:
@@ -916,6 +926,10 @@ def run_load(self,
         :param time_partitioning: configure optional time partitioning fields i.e.
             partition by field, type and  expiration as per API specifications.
         :type time_partitioning: dict
+        :param cluster_fields: Request that the result of this load be stored sorted
+            by one or more columns. This is only available in combination with
+            time_partitioning. The order of columns given determines the sort order.
+        :type cluster_fields: list of str
         """
 
         # bigquery only allows certain source formats
@@ -979,6 +993,9 @@ def run_load(self,
                 'timePartitioning': time_partitioning
             })
 
+        if cluster_fields:
+            configuration['load'].update({'clustering': {'fields': cluster_fields}})
+
         if schema_fields:
             configuration['load']['schema'] = {'fields': schema_fields}
 
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index c773ebb2e6f21..98e5cfb6beb36 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -98,6 +98,10 @@ class BigQueryOperator(BaseOperator):
     :param time_partitioning: configure optional time partitioning fields i.e.
         partition by field, type and expiration as per API specifications.
     :type time_partitioning: dict
+    :param cluster_fields: Request that the result of this query be stored sorted
+        by one or more columns. This is only available in conjunction with
+        time_partitioning. The order of columns given determines the sort order.
+    :type cluster_fields: list of str
     """
 
     template_fields = ('bql', 'sql', 'destination_dataset_table', 'labels')
@@ -125,6 +129,7 @@ def __init__(self,
                  priority='INTERACTIVE',
                  time_partitioning=None,
                  api_resource_configs=None,
+                 cluster_fields=None,
                  *args,
                  **kwargs):
         super(BigQueryOperator, self).__init__(*args, **kwargs)
@@ -150,6 +155,7 @@ def __init__(self,
             self.time_partitioning = {}
         if api_resource_configs is None:
             self.api_resource_configs = {}
+        self.cluster_fields = cluster_fields
 
         # TODO remove `bql` in Airflow 2.0
         if self.bql:
@@ -190,6 +196,7 @@ def execute(self, context):
             priority=self.priority,
             time_partitioning=self.time_partitioning,
             api_resource_configs=self.api_resource_configs,
+            cluster_fields=self.cluster_fields,
         )
 
     def on_kill(self):
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 69acb616594d9..003e828a8aa9d 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -114,6 +114,11 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         Note that 'field' is not available in concurrency with
         dataset.table$partition.
     :type time_partitioning: dict
+    :param cluster_fields: Request that the result of this load be stored sorted
+        by one or more columns. This is only available in conjunction with
+        time_partitioning. The order of columns given determines the sort order.
+        Not applicable for external tables.
+    :type cluster_fields: list of str
     """
     template_fields = ('bucket', 'source_objects',
                        'schema_object', 'destination_project_dataset_table')
@@ -146,6 +151,7 @@ def __init__(self,
                  src_fmt_configs=None,
                  external_table=False,
                  time_partitioning=None,
+                 cluster_fields=None,
                  *args, **kwargs):
 
         super(GoogleCloudStorageToBigQueryOperator, self).__init__(*args, **kwargs)
@@ -183,6 +189,7 @@ def __init__(self,
         self.schema_update_options = schema_update_options
         self.src_fmt_configs = src_fmt_configs
         self.time_partitioning = time_partitioning
+        self.cluster_fields = cluster_fields
 
     def execute(self, context):
         bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
@@ -238,7 +245,8 @@ def execute(self, context):
                 allow_jagged_rows=self.allow_jagged_rows,
                 schema_update_options=self.schema_update_options,
                 src_fmt_configs=self.src_fmt_configs,
-                time_partitioning=self.time_partitioning)
+                time_partitioning=self.time_partitioning,
+                cluster_fields=self.cluster_fields)
 
         if self.max_id_key:
             cursor.execute('SELECT MAX({}) FROM {}'.format(
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 4a97ea7aa4d3c..0006b0c616b87 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -448,6 +448,94 @@ def test_extra_time_partitioning_options(self):
         self.assertEqual(tp_out, expect)
 
 
+class TestClusteringInRunJob(unittest.TestCase):
+
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_load_default(self, mocked_rwc, mocked_time, mocked_logging):
+        project_id = 12345
+
+        def run_with_config(config):
+            self.assertIsNone(config['load'].get('clustering'))
+        mocked_rwc.side_effect = run_with_config
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        bq_hook.run_load(
+            destination_project_dataset_table='my_dataset.my_table',
+            schema_fields=[],
+            source_uris=[],
+        )
+
+        mocked_rwc.assert_called_once()
+
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_load_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+        project_id = 12345
+
+        def run_with_config(config):
+            self.assertEqual(
+                config['load']['clustering'],
+                {
+                    'fields': ['field1', 'field2']
+                }
+            )
+        mocked_rwc.side_effect = run_with_config
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        bq_hook.run_load(
+            destination_project_dataset_table='my_dataset.my_table',
+            schema_fields=[],
+            source_uris=[],
+            cluster_fields=['field1', 'field2'],
+            time_partitioning={'type': 'DAY'}
+        )
+
+        mocked_rwc.assert_called_once()
+
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_query_default(self, mocked_rwc, mocked_time, mocked_logging):
+        project_id = 12345
+
+        def run_with_config(config):
+            self.assertIsNone(config['query'].get('clustering'))
+        mocked_rwc.side_effect = run_with_config
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        bq_hook.run_query(sql='select 1')
+
+        mocked_rwc.assert_called_once()
+
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
+    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_query_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+        project_id = 12345
+
+        def run_with_config(config):
+            self.assertEqual(
+                config['query']['clustering'],
+                {
+                    'fields': ['field1', 'field2']
+                }
+            )
+        mocked_rwc.side_effect = run_with_config
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        bq_hook.run_query(
+            sql='select 1',
+            destination_dataset_table='my_dataset.my_table',
+            cluster_fields=['field1', 'field2'],
+            time_partitioning={'type': 'DAY'}
+        )
+
+        mocked_rwc.assert_called_once()
+
+
 class TestBigQueryHookLegacySql(unittest.TestCase):
     """Ensure `use_legacy_sql` param in `BigQueryHook` propagates properly."""
 

From bfd8454004def2c12b1bccfa327e8cffb14dd435 Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Fri, 21 Sep 2018 17:46:59 +0300
Subject: [PATCH 297/808] [AIRFLOW-2887] Added
 BigQueryCreateEmptyDatasetOperator and create_emty_dataset to bigquery_hook
 (#3876)

---
 airflow/contrib/hooks/bigquery_hook.py        | 75 ++++++++++++++++++-
 .../contrib/operators/bigquery_operator.py    | 74 ++++++++++++++++--
 docs/code.rst                                 |  1 +
 docs/integration.rst                          |  8 ++
 tests/contrib/hooks/test_bigquery_hook.py     | 25 ++++++-
 .../operators/test_bigquery_operator.py       | 25 ++++++-
 6 files changed, 195 insertions(+), 13 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index bd337d53ae5bd..b93f5d3b3e679 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -960,7 +960,7 @@ def run_load(self,
         if not set(allowed_schema_update_options).issuperset(
                 set(schema_update_options)):
             raise ValueError(
-                "{0} contains invalid schema update options. "
+                "{0} contains invalid schema update options."
                 "Please only use one or more of the following options: {1}"
                 .format(schema_update_options, allowed_schema_update_options))
 
@@ -1350,6 +1350,72 @@ def run_grant_dataset_view_access(self,
                 view_project, view_dataset, view_table, source_project, source_dataset)
             return source_dataset_resource
 
+    def create_empty_dataset(self, dataset_id="", project_id="",
+                             dataset_reference=None):
+        """
+        Create a new empty dataset:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/insert
+
+        :param project_id: The name of the project where we want to create
+            an empty a dataset. Don't need to provide, if projectId in dataset_reference.
+        :type project_id: str
+        :param dataset_id: The id of dataset. Don't need to provide,
+            if datasetId in dataset_reference.
+        :type dataset_id: str
+        :param dataset_reference: Dataset reference that could be provided
+            with request body. More info:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource
+        :type dataset_reference: dict
+        """
+
+        if dataset_reference:
+            _validate_value('dataset_reference', dataset_reference, dict)
+        else:
+            dataset_reference = {}
+
+        if "datasetReference" not in dataset_reference:
+            dataset_reference["datasetReference"] = {}
+
+        if not dataset_reference["datasetReference"].get("datasetId") and not dataset_id:
+            raise ValueError(
+                "{} not provided datasetId. Impossible to create dataset")
+
+        dataset_required_params = [(dataset_id, "datasetId", ""),
+                                   (project_id, "projectId", self.project_id)]
+        for param_tuple in dataset_required_params:
+            param, param_name, param_default = param_tuple
+            if param_name not in dataset_reference['datasetReference']:
+                if param_default and not param:
+                    self.log.info("{} was not specified. Will be used default "
+                                  "value {}.".format(param_name,
+                                                     param_default))
+                    param = param_default
+                dataset_reference['datasetReference'].update(
+                    {param_name: param})
+            elif param:
+                _api_resource_configs_duplication_check(
+                    param_name, param,
+                    dataset_reference['datasetReference'], 'dataset_reference')
+
+        dataset_id = dataset_reference.get("datasetReference").get("datasetId")
+        dataset_project_id = dataset_reference.get("datasetReference").get(
+            "projectId")
+
+        self.log.info('Creating Dataset: %s in project: %s ', dataset_id,
+                      dataset_project_id)
+
+        try:
+            self.service.datasets().insert(
+                projectId=dataset_project_id,
+                body=dataset_reference).execute()
+            self.log.info('Dataset created successfully: In project %s '
+                          'Dataset %s', dataset_project_id, dataset_id)
+
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content)
+            )
+
     def delete_dataset(self, project_id, dataset_id):
         """
         Delete a dataset of Big query in your project.
@@ -1671,10 +1737,11 @@ def _validate_value(key, value, expected_type):
             key, expected_type, type(value)))
 
 
-def _api_resource_configs_duplication_check(key, value, config_dict):
+def _api_resource_configs_duplication_check(key, value, config_dict,
+                                            config_dict_name='api_resource_configs'):
     if key in config_dict and value != config_dict[key]:
         raise ValueError("Values of {param_name} param are duplicated. "
-                         "`api_resource_configs` contained {param_name} param "
+                         "{dict_name} contained {param_name} param "
                          "in `query` config and {param_name} was also provided "
                          "with arg to run_query() method. Please remove duplicates."
-                         .format(param_name=key))
+                         .format(param_name=key, dict_name=config_dict_name))
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 98e5cfb6beb36..422e58660b523 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -528,12 +528,11 @@ class BigQueryDeleteDatasetOperator(BaseOperator):
 
     **Example**: ::
 
-        delete_temp_data = BigQueryDeleteDatasetOperator(
-                                        dataset_id = 'temp-dataset',
-                                        project_id = 'temp-project',
-                                        bigquery_conn_id='_my_gcp_conn_',
-                                        task_id='Deletetemp',
-                                        dag=dag)
+        delete_temp_data = BigQueryDeleteDatasetOperator(dataset_id = 'temp-dataset',
+                                                         project_id = 'temp-project',
+                                                         bigquery_conn_id='_my_gcp_conn_',
+                                                         task_id='Deletetemp',
+                                                         dag=dag)
     """
 
     template_fields = ('dataset_id', 'project_id')
@@ -567,3 +566,66 @@ def execute(self, context):
             project_id=self.project_id,
             dataset_id=self.dataset_id
         )
+
+
+class BigQueryCreateEmptyDatasetOperator(BaseOperator):
+    """"
+    This operator is used to create new dataset for your Project in Big query.
+    https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource
+
+    :param project_id: The name of the project where we want to create the dataset.
+        Don't need to provide, if projectId in dataset_reference.
+    :type project_id: str
+    :param dataset_id: The id of dataset. Don't need to provide,
+        if datasetId in dataset_reference.
+    :type dataset_id: str
+    :param dataset_reference: Dataset reference that could be provided with request body.
+        More info:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource
+    :type dataset_reference: dict
+
+        **Example**: ::
+
+            create_new_dataset = BigQueryCreateEmptyDatasetOperator(
+                                    dataset_id = 'new-dataset',
+                                    project_id = 'my-project',
+                                    dataset_reference = {"friendlyName": "New Dataset"}
+                                    bigquery_conn_id='_my_gcp_conn_',
+                                    task_id='newDatasetCreator',
+                                    dag=dag)
+
+    """
+
+    template_fields = ('dataset_id', 'project_id')
+    ui_color = '#f0eee4'
+
+    @apply_defaults
+    def __init__(self,
+                 dataset_id,
+                 project_id=None,
+                 dataset_reference=None,
+                 bigquery_conn_id='bigquery_default',
+                 delegate_to=None,
+                 *args, **kwargs):
+        self.dataset_id = dataset_id
+        self.project_id = project_id
+        self.bigquery_conn_id = bigquery_conn_id
+        self.dataset_reference = dataset_reference if dataset_reference else {}
+        self.delegate_to = delegate_to
+
+        self.log.info('Dataset id: %s', self.dataset_id)
+        self.log.info('Project id: %s', self.project_id)
+
+        super(BigQueryCreateEmptyDatasetOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
+                               delegate_to=self.delegate_to)
+
+        conn = bq_hook.get_conn()
+        cursor = conn.cursor()
+
+        cursor.create_empty_dataset(
+            project_id=self.project_id,
+            dataset_id=self.dataset_id,
+            dataset_reference=self.dataset_reference)
diff --git a/docs/code.rst b/docs/code.rst
index 744c9b6cf60ce..aaa4eec5f7213 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -140,6 +140,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
 .. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index f0d2cecd2556a..c463f89a4a023 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -559,6 +559,7 @@ BigQuery Operators
 - :ref:`BigQueryCreateEmptyTableOperator` : Creates a new, empty table in the specified BigQuery dataset optionally with schema.
 - :ref:`BigQueryCreateExternalTableOperator` : Creates a new, external table in the dataset with the data in Google Cloud Storage.
 - :ref:`BigQueryDeleteDatasetOperator` : Deletes an existing BigQuery dataset.
+- :ref:`BigQueryCreateEmptyDatasetOperator` : Creates an empty BigQuery dataset.
 - :ref:`BigQueryOperator` : Executes BigQuery SQL queries in a specific BigQuery database.
 - :ref:`BigQueryToBigQueryOperator` : Copy a BigQuery table to another BigQuery table.
 - :ref:`BigQueryToCloudStorageOperator` : Transfers a BigQuery table to a Google Cloud Storage bucket
@@ -613,6 +614,13 @@ BigQueryDeleteDatasetOperator
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
 
+.. _BigQueryCreateEmptyDatasetOperator:
+
+BigQueryCreateEmptyDatasetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
+
 .. _BigQueryOperator:
 
 BigQueryOperator
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 0006b0c616b87..84fe84043e582 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -337,8 +337,31 @@ def run_with_config(config):
         mocked_rwc.assert_called_once()
 
 
-class TestTimePartitioningInRunJob(unittest.TestCase):
+class TestDatasetsOperations(unittest.TestCase):
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_create_empty_dataset_no_dataset_id_err(self,
+                                                    run_with_configuration):
+
+        with self.assertRaises(ValueError):
+            hook.BigQueryBaseCursor(
+                mock.Mock(), "test_create_empty_dataset").create_empty_dataset(
+                dataset_id="", project_id="")
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_create_empty_dataset_duplicates_call_err(self,
+                                                      run_with_configuration):
+        with self.assertRaises(ValueError):
+            hook.BigQueryBaseCursor(
+                mock.Mock(), "test_create_empty_dataset").create_empty_dataset(
+                dataset_id="", project_id="project_test",
+                dataset_reference={
+                    "datasetReference":
+                        {"datasetId": "test_dataset",
+                         "projectId": "project_test2"}})
+
+
+class TestTimePartitioningInRunJob(unittest.TestCase):
     @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
     @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 7c76ab73fec81..9ce3b478d3338 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -22,8 +22,8 @@
 
 from airflow.contrib.operators.bigquery_operator import \
     BigQueryCreateExternalTableOperator, \
-    BigQueryOperator, \
-    BigQueryCreateEmptyTableOperator, BigQueryDeleteDatasetOperator
+    BigQueryOperator, BigQueryCreateEmptyTableOperator, \
+    BigQueryDeleteDatasetOperator, BigQueryCreateEmptyDatasetOperator
 
 try:
     from unittest import mock
@@ -136,3 +136,24 @@ def test_execute(self, mock_hook):
                 dataset_id=TEST_DATASET,
                 project_id=TEST_PROJECT_ID
             )
+
+
+class BigQueryCreateEmptyDatasetOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
+    def test_execute(self, mock_hook):
+        operator = BigQueryCreateEmptyDatasetOperator(
+            task_id=TASK_ID,
+            dataset_id=TEST_DATASET,
+            project_id=TEST_PROJECT_ID
+        )
+
+        operator.execute(None)
+        mock_hook.return_value \
+            .get_conn() \
+            .cursor() \
+            .create_empty_dataset \
+            .assert_called_once_with(
+                dataset_id=TEST_DATASET,
+                project_id=TEST_PROJECT_ID,
+                dataset_reference={}
+            )

From 6f0dda0a399e0f05f35f7cb5c30f02052d84edce Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Sun, 7 Oct 2018 21:49:50 +0300
Subject: [PATCH 298/808] [AIRFLOW-3055] add get_dataset and get_datasets_list
 to bigquery_hook (#3894)

* [AIRFLOW-3055] add get_dataset and get_datasets_list to bigquery_hook
---
 airflow/contrib/hooks/bigquery_hook.py    | 80 +++++++++++++++++++++++
 tests/contrib/hooks/test_bigquery_hook.py | 62 ++++++++++++++++++
 2 files changed, 142 insertions(+)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index b93f5d3b3e679..6d2239f4e22f6 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1441,6 +1441,86 @@ def delete_dataset(self, project_id, dataset_id):
                 'BigQuery job failed. Error was: {}'.format(err.content)
             )
 
+    def get_dataset(self, dataset_id, project_id=None):
+        """
+        Method returns dataset_resource if dataset exist
+        and raised 404 error if dataset does not exist
+
+        :param dataset_id: The BigQuery Dataset ID
+        :type dataset_id: str
+        :param project_id: The GCP Project ID
+        :type project_id: str
+        :return: dataset_resource
+
+            .. seealso::
+                For more information, see Dataset Resource content:
+                https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource
+        """
+
+        if not dataset_id or not isinstance(dataset_id, str):
+            raise ValueError("dataset_id argument must be provided and has "
+                             "a type 'str'. You provided: {}".format(dataset_id))
+
+        dataset_project_id = project_id if project_id else self.project_id
+
+        try:
+            dataset_resource = self.service.datasets().get(
+                datasetId=dataset_id, projectId=dataset_project_id).execute()
+            self.log.info("Dataset Resource: {}".format(dataset_resource))
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content))
+
+        return dataset_resource
+
+    def get_datasets_list(self, project_id=None):
+        """
+        Method returns full list of BigQuery datasets in the current project
+
+        .. seealso::
+            For more information, see:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/list
+
+        :param project_id: Google Cloud Project for which you
+            try to get all datasets
+        :type project_id: str
+        :return: datasets_list
+
+            Example of returned datasets_list: ::
+
+                   {
+                      "kind":"bigquery#dataset",
+                      "location":"US",
+                      "id":"your-project:dataset_2_test",
+                      "datasetReference":{
+                         "projectId":"your-project",
+                         "datasetId":"dataset_2_test"
+                      }
+                   },
+                   {
+                      "kind":"bigquery#dataset",
+                      "location":"US",
+                      "id":"your-project:dataset_1_test",
+                      "datasetReference":{
+                         "projectId":"your-project",
+                         "datasetId":"dataset_1_test"
+                      }
+                   }
+                ]
+        """
+        dataset_project_id = project_id if project_id else self.project_id
+
+        try:
+            datasets_list = self.service.datasets().list(
+                projectId=dataset_project_id).execute()['datasets']
+            self.log.info("Datasets List: {}".format(datasets_list))
+
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content))
+
+        return datasets_list
+
 
 class BigQueryCursor(BigQueryBaseCursor):
     """
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 84fe84043e582..77a31f032081b 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -360,6 +360,68 @@ def test_create_empty_dataset_duplicates_call_err(self,
                         {"datasetId": "test_dataset",
                          "projectId": "project_test2"}})
 
+    def test_get_dataset_without_dataset_id(self):
+        with mock.patch.object(hook.BigQueryHook, 'get_service'):
+            with self.assertRaises(ValueError):
+                hook.BigQueryBaseCursor(
+                    mock.Mock(), "test_create_empty_dataset").get_dataset(
+                    dataset_id="", project_id="project_test")
+
+    def test_get_dataset(self):
+        expected_result = {
+            "kind": "bigquery#dataset",
+            "location": "US",
+            "id": "your-project:dataset_2_test",
+            "datasetReference": {
+                "projectId": "your-project",
+                "datasetId": "dataset_2_test"
+            }
+        }
+        dataset_id = "test_dataset"
+        project_id = "project_test"
+
+        bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
+        with mock.patch.object(bq_hook.service, 'datasets') as MockService:
+            MockService.return_value.get(datasetId=dataset_id,
+                                         projectId=project_id).execute.\
+                return_value = expected_result
+            result = bq_hook.get_dataset(dataset_id=dataset_id,
+                                         project_id=project_id)
+            self.assertEqual(result, expected_result)
+
+    def test_get_datasets_list(self):
+        expected_result = {'datasets': [
+            {
+                "kind": "bigquery#dataset",
+                "location": "US",
+                "id": "your-project:dataset_2_test",
+                "datasetReference": {
+                    "projectId": "your-project",
+                    "datasetId": "dataset_2_test"
+                }
+            },
+            {
+                "kind": "bigquery#dataset",
+                "location": "US",
+                "id": "your-project:dataset_1_test",
+                "datasetReference": {
+                    "projectId": "your-project",
+                    "datasetId": "dataset_1_test"
+                }
+            }
+        ]}
+        project_id = "project_test"''
+
+        mocked = mock.Mock()
+        with mock.patch.object(hook.BigQueryBaseCursor(mocked, project_id).service,
+                               'datasets') as MockService:
+            MockService.return_value.list(
+                projectId=project_id).execute.return_value = expected_result
+            result = hook.BigQueryBaseCursor(
+                mocked, "test_create_empty_dataset").get_datasets_list(
+                project_id=project_id)
+            self.assertEqual(result, expected_result['datasets'])
+
 
 class TestTimePartitioningInRunJob(unittest.TestCase):
     @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")

From 06949ef33bb0009ece1e375f3fdd68698c232607 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 20 Oct 2018 13:05:17 +0100
Subject: [PATCH 299/808] [AIRFLOW-XXX] BigQuery Hook - Minor Refactoring
 (#4066)

---
 airflow/contrib/hooks/bigquery_hook.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 6d2239f4e22f6..17337444e2f98 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -229,7 +229,8 @@ def create_empty_table(self,
         :param table_id: The Name of the table to be created.
         :type table_id: str
         :param schema_fields: If set, the schema field list as defined here:
-        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
+        :type schema_fields: list
         :param labels: a dictionary containing labels for the table, passed to BigQuery
         :type labels: dict
 
@@ -238,7 +239,6 @@ def create_empty_table(self,
             schema_fields=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
                            {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}]
 
-        :type schema_fields: list
         :param time_partitioning: configure optional time partitioning fields i.e.
             partition by field, type and expiration as per API specifications.
 
@@ -526,6 +526,7 @@ def run_query(self,
         :type flatten_results: boolean
         :param udf_config: The User Defined Function configuration for the query.
             See https://cloud.google.com/bigquery/user-defined-functions for details.
+        :type udf_config: list
         :param use_legacy_sql: Whether to use legacy SQL (true) or standard SQL (false).
             If `None`, defaults to `self.use_legacy_sql`.
         :type use_legacy_sql: boolean
@@ -536,7 +537,6 @@ def run_query(self,
             if you need to provide some params that are not supported by the
             BigQueryHook like args.
         :type api_resource_configs: dict
-        :type udf_config: list
         :param maximum_billing_tier: Positive integer that serves as a
             multiplier of the basic price.
         :type maximum_billing_tier: integer

From 53e34797abbb5ad5d6892353a9dd0e41b69c6f4e Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Mon, 22 Oct 2018 12:03:22 +0300
Subject: [PATCH 300/808] [AIRFLOW-461]  Support autodetected schemas in
 BigQuery run_load (#3880)

---
 airflow/contrib/hooks/bigquery_hook.py        | 17 ++++++++++---
 .../contrib/operators/bigquery_operator.py    |  4 ++--
 airflow/contrib/operators/gcs_to_bq.py        | 24 ++++++++++++-------
 tests/contrib/hooks/test_bigquery_hook.py     |  8 +++++++
 4 files changed, 39 insertions(+), 14 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 17337444e2f98..248fb986a8168 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -849,8 +849,8 @@ def run_copy(self,
 
     def run_load(self,
                  destination_project_dataset_table,
-                 schema_fields,
                  source_uris,
+                 schema_fields=None,
                  source_format='CSV',
                  create_disposition='CREATE_IF_NEEDED',
                  skip_leading_rows=0,
@@ -864,7 +864,8 @@ def run_load(self,
                  schema_update_options=(),
                  src_fmt_configs=None,
                  time_partitioning=None,
-                 cluster_fields=None):
+                 cluster_fields=None,
+                 autodetect=False):
         """
         Executes a BigQuery load command to load data from Google Cloud Storage
         to BigQuery. See here:
@@ -882,7 +883,11 @@ def run_load(self,
         :type destination_project_dataset_table: string
         :param schema_fields: The schema field list as defined here:
             https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load
+            Required if autodetect=False; optional if autodetect=True.
         :type schema_fields: list
+        :param autodetect: Attempt to autodetect the schema for CSV and JSON
+            source files.
+        :type autodetect: bool
         :param source_uris: The source Google Cloud
             Storage URI (e.g. gs://some-bucket/some-file.txt). A single wild
             per-object name can be used.
@@ -937,6 +942,11 @@ def run_load(self,
         # if it's not, we raise a ValueError
         # Refer to this link for more details:
         #   https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.query.tableDefinitions.(key).sourceFormat
+
+        if schema_fields is None and not autodetect:
+            raise ValueError(
+                'You must either pass a schema or autodetect=True.')
+
         if src_fmt_configs is None:
             src_fmt_configs = {}
 
@@ -971,6 +981,7 @@ def run_load(self,
 
         configuration = {
             'load': {
+                'autodetect': autodetect,
                 'createDisposition': create_disposition,
                 'destinationTable': {
                     'projectId': destination_project,
@@ -1734,7 +1745,7 @@ def _split_tablename(table_input, default_project_id, var_name=None):
 
     if '.' not in table_input:
         raise ValueError(
-            'Expected deletion_dataset_table name in the format of '
+            'Expected target table name in the format of '
             '<dataset>.<table>. Got: {}'.format(table_input))
 
     if not default_project_id:
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 422e58660b523..f861f064c7218 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -306,7 +306,7 @@ def __init__(self,
                  project_id=None,
                  schema_fields=None,
                  gcs_schema_object=None,
-                 time_partitioning={},
+                 time_partitioning=None,
                  bigquery_conn_id='bigquery_default',
                  google_cloud_storage_conn_id='google_cloud_default',
                  delegate_to=None,
@@ -323,7 +323,7 @@ def __init__(self,
         self.bigquery_conn_id = bigquery_conn_id
         self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
         self.delegate_to = delegate_to
-        self.time_partitioning = time_partitioning
+        self.time_partitioning = {} if time_partitioning is None else time_partitioning
         self.labels = labels
 
     def execute(self, context):
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 003e828a8aa9d..11c2c83bc174b 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -152,6 +152,7 @@ def __init__(self,
                  external_table=False,
                  time_partitioning=None,
                  cluster_fields=None,
+                 autodetect=False,
                  *args, **kwargs):
 
         super(GoogleCloudStorageToBigQueryOperator, self).__init__(*args, **kwargs)
@@ -190,20 +191,24 @@ def __init__(self,
         self.src_fmt_configs = src_fmt_configs
         self.time_partitioning = time_partitioning
         self.cluster_fields = cluster_fields
+        self.autodetect = autodetect
 
     def execute(self, context):
         bq_hook = BigQueryHook(bigquery_conn_id=self.bigquery_conn_id,
                                delegate_to=self.delegate_to)
 
-        if not self.schema_fields and \
-                self.schema_object and \
-                self.source_format != 'DATASTORE_BACKUP':
-            gcs_hook = GoogleCloudStorageHook(
-                google_cloud_storage_conn_id=self.google_cloud_storage_conn_id,
-                delegate_to=self.delegate_to)
-            schema_fields = json.loads(gcs_hook.download(
-                self.bucket,
-                self.schema_object).decode("utf-8"))
+        if not self.schema_fields:
+            if self.schema_object and self.source_format != 'DATASTORE_BACKUP':
+                gcs_hook = GoogleCloudStorageHook(
+                    google_cloud_storage_conn_id=self.google_cloud_storage_conn_id,
+                    delegate_to=self.delegate_to)
+                schema_fields = json.loads(gcs_hook.download(
+                    self.bucket,
+                    self.schema_object).decode("utf-8"))
+            elif self.schema_object is None and self.autodetect is False:
+                raise ValueError('At least one of `schema_fields`, `schema_object`, '
+                                 'or `autodetect` must be passed.')
+
         else:
             schema_fields = self.schema_fields
 
@@ -234,6 +239,7 @@ def execute(self, context):
                 schema_fields=schema_fields,
                 source_uris=source_uris,
                 source_format=self.source_format,
+                autodetect=self.autodetect,
                 create_disposition=self.create_disposition,
                 skip_leading_rows=self.skip_leading_rows,
                 write_disposition=self.write_disposition,
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 77a31f032081b..aff9b4cdf7a4d 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -443,6 +443,14 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_with_auto_detect(self, run_with_config):
+        destination_project_dataset_table = "autodetect.table"
+        cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
+        cursor.run_load(destination_project_dataset_table, [], [], autodetect=True)
+        args, kwargs = run_with_config.call_args
+        self.assertIs(args[0]['load']['autodetect'], True)
+
     @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
     @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')

From 7367529353188824e44a4ef0e34e408d0e052a73 Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Fri, 16 Nov 2018 14:31:24 -0800
Subject: [PATCH 301/808] [AIRFLOW-3355] Fix BigQueryCursor.execute to work
 with Python3 (#4198)

BigQueryCursor.execute uses dict.iteritems internally,
so it fails with Python3 if binding parameters are
provided. This PR fixes this problem.
---
 airflow/contrib/hooks/bigquery_hook.py    | 3 ++-
 tests/contrib/hooks/test_bigquery_hook.py | 8 ++++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 248fb986a8168..5f3899fc2e846 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -25,6 +25,7 @@
 import time
 from builtins import range
 from copy import deepcopy
+from six import iteritems
 
 from past.builtins import basestring
 
@@ -1700,7 +1701,7 @@ def _bind_parameters(operation, parameters):
     """ Helper method that binds parameters to a SQL query. """
     # inspired by MySQL Python Connector (conversion.py)
     string_parameters = {}
-    for (name, value) in parameters.iteritems():
+    for (name, value) in iteritems(parameters):
         if value is None:
             string_parameters[name] = 'NULL'
         elif isinstance(value, basestring):
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index aff9b4cdf7a4d..f47ce00c2f9ae 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -316,6 +316,14 @@ def test_duplication_check(self):
             "key_one", key_one, {"key_one": True}))
 
 
+class TestBigQueryCursor(unittest.TestCase):
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_execute_with_parameters(self, mocked_rwc):
+        hook.BigQueryCursor("test", "test").execute(
+            "SELECT %(foo)s", {"foo": "bar"})
+        mocked_rwc.assert_called_once()
+
+
 class TestLabelsInRunJob(unittest.TestCase):
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_query_with_arg(self, mocked_rwc):

From ad78c6124259d36b962e1abedf344bf8761f0c92 Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Sat, 17 Nov 2018 22:52:03 +1100
Subject: [PATCH 302/808] [AIRFLOW-3332] Add method to allow inserting rows
 into BQ table (#4179)

---
 airflow/contrib/hooks/bigquery_hook.py    | 73 +++++++++++++++++++++++
 tests/contrib/hooks/test_bigquery_hook.py | 50 ++++++++++++++++
 2 files changed, 123 insertions(+)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 5f3899fc2e846..75d5fd406a144 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1533,6 +1533,79 @@ def get_datasets_list(self, project_id=None):
 
         return datasets_list
 
+    def insert_all(self, project_id, dataset_id, table_id,
+                   rows, ignore_unknown_values=False,
+                   skip_invalid_rows=False, fail_on_error=False):
+        """
+        Method to stream data into BigQuery one record at a time without needing
+        to run a load job
+
+        .. seealso::
+            For more information, see:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tabledata/insertAll
+
+        :param project_id: The name of the project where we have the table
+        :type project_id: str
+        :param dataset_id: The name of the dataset where we have the table
+        :type dataset_id: str
+        :param table_id: The name of the table
+        :type table_id: str
+        :param rows: the rows to insert
+        :type rows: list
+
+        **Example or rows**:
+            rows=[{"json": {"a_key": "a_value_0"}}, {"json": {"a_key": "a_value_1"}}]
+
+        :param ignore_unknown_values: [Optional] Accept rows that contain values
+            that do not match the schema. The unknown values are ignored.
+            The default value  is false, which treats unknown values as errors.
+        :type ignore_unknown_values: bool
+        :param skip_invalid_rows: [Optional] Insert all valid rows of a request,
+            even if invalid rows exist. The default value is false, which causes
+            the entire request to fail if any invalid rows exist.
+        :type skip_invalid_rows: bool
+        :param fail_on_error: [Optional] Force the task to fail if any errors occur.
+            The default value is false, which indicates the task should not fail
+            even if any insertion errors occur.
+        :type fail_on_error: bool
+        """
+
+        dataset_project_id = project_id if project_id else self.project_id
+
+        body = {
+            "rows": rows,
+            "ignoreUnknownValues": ignore_unknown_values,
+            "kind": "bigquery#tableDataInsertAllRequest",
+            "skipInvalidRows": skip_invalid_rows,
+        }
+
+        try:
+            self.log.info('Inserting {} row(s) into Table {}:{}.{}'.format(
+                len(rows), dataset_project_id,
+                dataset_id, table_id))
+
+            resp = self.service.tabledata().insertAll(
+                projectId=dataset_project_id, datasetId=dataset_id,
+                tableId=table_id, body=body
+            ).execute()
+
+            if 'insertErrors' not in resp:
+                self.log.info('All row(s) inserted successfully: {}:{}.{}'.format(
+                    dataset_project_id, dataset_id, table_id))
+            else:
+                error_msg = '{} insert error(s) occured: {}:{}.{}. Details: {}'.format(
+                    len(resp['insertErrors']),
+                    dataset_project_id, dataset_id, table_id, resp['insertErrors'])
+                if fail_on_error:
+                    raise AirflowException(
+                        'BigQuery job failed. Error was: {}'.format(error_msg)
+                    )
+                self.log.info(error_msg)
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content)
+            )
+
 
 class BigQueryCursor(BigQueryBaseCursor):
     """
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index f47ce00c2f9ae..24864b202fdf9 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -315,6 +315,56 @@ def test_duplication_check(self):
         self.assertIsNone(_api_resource_configs_duplication_check(
             "key_one", key_one, {"key_one": True}))
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_insert_all_succeed(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        table_id = 'bq_table'
+        rows = [
+            {"json": {"a_key": "a_value_0"}}
+        ]
+        body = {
+            "rows": rows,
+            "ignoreUnknownValues": False,
+            "kind": "bigquery#tableDataInsertAllRequest",
+            "skipInvalidRows": False,
+        }
+
+        mock_service = mock.Mock()
+        method = (mock_service.tabledata.return_value.insertAll)
+        method.return_value.execute.return_value = {
+            "kind": "bigquery#tableDataInsertAllResponse"
+        }
+        cursor = hook.BigQueryBaseCursor(mock_service, 'project_id')
+        cursor.insert_all(project_id, dataset_id, table_id, rows)
+        method.assert_called_with(projectId=project_id, datasetId=dataset_id,
+                                  tableId=table_id, body=body)
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_insert_all_fail(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        table_id = 'bq_table'
+        rows = [
+            {"json": {"a_key": "a_value_0"}}
+        ]
+
+        mock_service = mock.Mock()
+        method = (mock_service.tabledata.return_value.insertAll)
+        method.return_value.execute.return_value = {
+            "kind": "bigquery#tableDataInsertAllResponse",
+            "insertErrors": [
+                {
+                    "index": 1,
+                    "errors": []
+                }
+            ]
+        }
+        cursor = hook.BigQueryBaseCursor(mock_service, 'project_id')
+        with self.assertRaises(Exception):
+            cursor.insert_all(project_id, dataset_id, table_id,
+                              rows, fail_on_error=True)
+
 
 class TestBigQueryCursor(unittest.TestCase):
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')

From 5055341ac3876a6e8ab09767a19cf57c9c06b4a2 Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Thu, 22 Nov 2018 10:16:18 +1100
Subject: [PATCH 303/808] [AIRFLOW-3371] BigQueryHook's Ability to Create View
 (#4213)

---
 airflow/contrib/hooks/bigquery_hook.py    | 19 ++++++++--
 tests/contrib/hooks/test_bigquery_hook.py | 43 +++++++++++++++++++++++
 2 files changed, 60 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 75d5fd406a144..39645ebee4640 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -218,10 +218,11 @@ def create_empty_table(self,
                            table_id,
                            schema_fields=None,
                            time_partitioning=None,
-                           labels=None
-                           ):
+                           labels=None,
+                           view=None):
         """
         Creates a new, empty table in the dataset.
+        To create a view, which is defined by a SQL query, parse a dictionary to 'view' kwarg
 
         :param project_id: The project to create the table into.
         :type project_id: str
@@ -246,6 +247,17 @@ def create_empty_table(self,
             .. seealso::
             https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#timePartitioning
         :type time_partitioning: dict
+        :param view: [Optional] A dictionary containing definition for the view.
+            If set, it will create a view instead of a table:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#view
+        :type view: dict
+
+        **Example**: ::
+
+            view = {
+                "query": "SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*` LIMIT 1000",
+                "useLegacySql": False
+            }
 
         :return:
         """
@@ -267,6 +279,9 @@ def create_empty_table(self,
         if labels:
             table_resource['labels'] = labels
 
+        if view:
+            table_resource['view'] = view
+
         self.log.info('Creating Table %s:%s.%s',
                       project_id, dataset_id, table_id)
 
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 24864b202fdf9..9334fd6dccdfc 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -23,6 +23,7 @@
 
 from google.auth.exceptions import GoogleAuthError
 import mock
+from apiclient.errors import HttpError
 
 from airflow.contrib.hooks import bigquery_hook as hook
 from airflow.contrib.hooks.bigquery_hook import _cleanse_time_partitioning, \
@@ -365,6 +366,48 @@ def test_insert_all_fail(self, run_with_config):
             cursor.insert_all(project_id, dataset_id, table_id,
                               rows, fail_on_error=True)
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_create_view_fails_on_exception(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        table_id = 'bq_table_view'
+        view = {
+            'incorrect_key': 'SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*`',
+            "useLegacySql": False
+        }
+
+        mock_service = mock.Mock()
+        method = (mock_service.tables.return_value.insert)
+        method.return_value.execute.side_effect = HttpError(
+            resp={'status': '400'}, content=b'Query is required for views')
+        cursor = hook.BigQueryBaseCursor(mock_service, project_id)
+        with self.assertRaises(Exception):
+            cursor.create_empty_table(project_id, dataset_id, table_id,
+                                      view=view)
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_create_view(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        table_id = 'bq_table_view'
+        view = {
+            'query': 'SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*`',
+            "useLegacySql": False
+        }
+
+        mock_service = mock.Mock()
+        method = (mock_service.tables.return_value.insert)
+        cursor = hook.BigQueryBaseCursor(mock_service, project_id)
+        cursor.create_empty_table(project_id, dataset_id, table_id,
+                                  view=view)
+        body = {
+            'tableReference': {
+                'tableId': table_id
+            },
+            'view': view
+        }
+        method.assert_called_once_with(projectId=project_id, datasetId=dataset_id, body=body)
+
 
 class TestBigQueryCursor(unittest.TestCase):
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')

From 1a92832547213e4f6ee2aad18efcfd0ff704aac4 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 9 Dec 2018 22:29:11 +0000
Subject: [PATCH 304/808] =?UTF-8?q?[AIRFLOW-3438]=20Fix=20default=20values?=
 =?UTF-8?q?=20in=20BigQuery=20Hook=20&=20BigQueryOperator=20(=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

…#4274)
---
 airflow/contrib/hooks/bigquery_hook.py        |  5 +-
 .../contrib/operators/bigquery_operator.py    | 12 ++-
 .../operators/test_bigquery_operator.py       | 87 ++++++++++++++++++-
 3 files changed, 93 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 39645ebee4640..9752847dd08b7 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -570,7 +570,7 @@ def run_query(self,
         :param labels a dictionary containing labels for the job/query,
             passed to BigQuery
         :type labels: dict
-        :param schema_update_options: Allows the schema of the desitination
+        :param schema_update_options: Allows the schema of the destination
             table to be updated as a side effect of the query job.
         :type schema_update_options: tuple
         :param priority: Specifies a priority for the query.
@@ -586,6 +586,9 @@ def run_query(self,
         :type cluster_fields: list of str
         """
 
+        if time_partitioning is None:
+            time_partitioning = {}
+
         if not api_resource_configs:
             api_resource_configs = self.api_resource_configs
         else:
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index f861f064c7218..481568d9291e3 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -112,13 +112,13 @@ class BigQueryOperator(BaseOperator):
     def __init__(self,
                  bql=None,
                  sql=None,
-                 destination_dataset_table=False,
+                 destination_dataset_table=None,
                  write_disposition='WRITE_EMPTY',
                  allow_large_results=False,
                  flatten_results=None,
                  bigquery_conn_id='bigquery_default',
                  delegate_to=None,
-                 udf_config=False,
+                 udf_config=None,
                  use_legacy_sql=True,
                  maximum_billing_tier=None,
                  maximum_bytes_billed=None,
@@ -151,10 +151,8 @@ def __init__(self,
         self.labels = labels
         self.bq_cursor = None
         self.priority = priority
-        if time_partitioning is None:
-            self.time_partitioning = {}
-        if api_resource_configs is None:
-            self.api_resource_configs = {}
+        self.time_partitioning = time_partitioning
+        self.api_resource_configs = api_resource_configs
         self.cluster_fields = cluster_fields
 
         # TODO remove `bql` in Airflow 2.0
@@ -181,7 +179,7 @@ def execute(self, context):
             conn = hook.get_conn()
             self.bq_cursor = conn.cursor()
         self.bq_cursor.run_query(
-            self.sql,
+            sql=self.sql,
             destination_dataset_table=self.destination_dataset_table,
             write_disposition=self.write_disposition,
             allow_large_results=self.allow_large_results,
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 9ce3b478d3338..0e52beea02657 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -21,9 +21,9 @@
 import warnings
 
 from airflow.contrib.operators.bigquery_operator import \
-    BigQueryCreateExternalTableOperator, \
-    BigQueryOperator, BigQueryCreateEmptyTableOperator, \
-    BigQueryDeleteDatasetOperator, BigQueryCreateEmptyDatasetOperator
+    BigQueryCreateExternalTableOperator, BigQueryCreateEmptyTableOperator, \
+    BigQueryDeleteDatasetOperator, BigQueryCreateEmptyDatasetOperator, \
+    BigQueryOperator
 
 try:
     from unittest import mock
@@ -157,3 +157,84 @@ def test_execute(self, mock_hook):
                 project_id=TEST_PROJECT_ID,
                 dataset_reference={}
             )
+
+
+class BigQueryOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
+    def test_execute(self, mock_hook):
+        operator = BigQueryOperator(
+            task_id=TASK_ID,
+            sql='Select * from test_table',
+            destination_dataset_table=None,
+            write_disposition='WRITE_EMPTY',
+            allow_large_results=False,
+            flatten_results=None,
+            bigquery_conn_id='bigquery_default',
+            udf_config=None,
+            use_legacy_sql=True,
+            maximum_billing_tier=None,
+            maximum_bytes_billed=None,
+            create_disposition='CREATE_IF_NEEDED',
+            schema_update_options=(),
+            query_params=None,
+            labels=None,
+            priority='INTERACTIVE',
+            time_partitioning=None,
+            api_resource_configs=None,
+            cluster_fields=None,
+        )
+
+        operator.execute(None)
+        mock_hook.return_value \
+            .get_conn() \
+            .cursor() \
+            .run_query \
+            .assert_called_once_with(
+                sql='Select * from test_table',
+                destination_dataset_table=None,
+                write_disposition='WRITE_EMPTY',
+                allow_large_results=False,
+                flatten_results=None,
+                udf_config=None,
+                maximum_billing_tier=None,
+                maximum_bytes_billed=None,
+                create_disposition='CREATE_IF_NEEDED',
+                schema_update_options=(),
+                query_params=None,
+                labels=None,
+                priority='INTERACTIVE',
+                time_partitioning=None,
+                api_resource_configs=None,
+                cluster_fields=None,
+            )
+
+    @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
+    def test_bigquery_operator_defaults(self, mock_hook):
+        operator = BigQueryOperator(
+            task_id=TASK_ID,
+            sql='Select * from test_table',
+        )
+
+        operator.execute(None)
+        mock_hook.return_value \
+            .get_conn() \
+            .cursor() \
+            .run_query \
+            .assert_called_once_with(
+                sql='Select * from test_table',
+                destination_dataset_table=None,
+                write_disposition='WRITE_EMPTY',
+                allow_large_results=False,
+                flatten_results=None,
+                udf_config=None,
+                maximum_billing_tier=None,
+                maximum_bytes_billed=None,
+                create_disposition='CREATE_IF_NEEDED',
+                schema_update_options=(),
+                query_params=None,
+                labels=None,
+                priority='INTERACTIVE',
+                time_partitioning=None,
+                api_resource_configs=None,
+                cluster_fields=None,
+            )

From 21e75dea2997e51aa5d80dce5aa2a2da416961c7 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 29 Dec 2018 11:00:20 +0000
Subject: [PATCH 305/808] [AIRFLOW-3327] Add support for location in
 BigQueryHook (#4324)

---
 airflow/contrib/hooks/bigquery_hook.py        | 60 +++++++++++---
 .../contrib/operators/bigquery_operator.py    | 10 ++-
 tests/contrib/hooks/test_bigquery_hook.py     | 83 ++++++++-----------
 3 files changed, 92 insertions(+), 61 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 9752847dd08b7..05db8f4e987f3 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -53,10 +53,12 @@ class BigQueryHook(GoogleCloudBaseHook, DbApiHook, LoggingMixin):
     def __init__(self,
                  bigquery_conn_id='bigquery_default',
                  delegate_to=None,
-                 use_legacy_sql=True):
+                 use_legacy_sql=True,
+                 location=None):
         super(BigQueryHook, self).__init__(
             gcp_conn_id=bigquery_conn_id, delegate_to=delegate_to)
         self.use_legacy_sql = use_legacy_sql
+        self.location = location
 
     def get_conn(self):
         """
@@ -67,7 +69,9 @@ def get_conn(self):
         return BigQueryConnection(
             service=service,
             project_id=project,
-            use_legacy_sql=self.use_legacy_sql)
+            use_legacy_sql=self.use_legacy_sql,
+            location=self.location,
+        )
 
     def get_service(self):
         """
@@ -201,7 +205,8 @@ def __init__(self,
                  service,
                  project_id,
                  use_legacy_sql=True,
-                 api_resource_configs=None):
+                 api_resource_configs=None,
+                 location=None):
 
         self.service = service
         self.project_id = project_id
@@ -211,6 +216,7 @@ def __init__(self,
         self.api_resource_configs = api_resource_configs \
             if api_resource_configs else {}
         self.running_job_id = None
+        self.location = location
 
     def create_empty_table(self,
                            project_id,
@@ -513,7 +519,8 @@ def run_query(self,
                   priority='INTERACTIVE',
                   time_partitioning=None,
                   api_resource_configs=None,
-                  cluster_fields=None):
+                  cluster_fields=None,
+                  location=None):
         """
         Executes a BigQuery SQL query. Optionally persists results in a BigQuery
         table. See here:
@@ -584,11 +591,18 @@ def run_query(self,
             by one or more columns. This is only available in combination with
             time_partitioning. The order of columns given determines the sort order.
         :type cluster_fields: list of str
+        :param location: The geographic location of the job. Required except for
+            US and EU. See details at
+            https://cloud.google.com/bigquery/docs/locations#specifying_your_location
+        :type location: str
         """
 
         if time_partitioning is None:
             time_partitioning = {}
 
+        if location:
+            self.location = location
+
         if not api_resource_configs:
             api_resource_configs = self.api_resource_configs
         else:
@@ -1106,9 +1120,15 @@ def run_with_configuration(self, configuration):
         keep_polling_job = True
         while keep_polling_job:
             try:
-                job = jobs.get(
-                    projectId=self.project_id,
-                    jobId=self.running_job_id).execute()
+                if self.location:
+                    job = jobs.get(
+                        projectId=self.project_id,
+                        jobId=self.running_job_id,
+                        location=self.location).execute()
+                else:
+                    job = jobs.get(
+                        projectId=self.project_id,
+                        jobId=self.running_job_id).execute()
                 if job['status']['state'] == 'DONE':
                     keep_polling_job = False
                     # Check if job had errors.
@@ -1137,7 +1157,13 @@ def run_with_configuration(self, configuration):
     def poll_job_complete(self, job_id):
         jobs = self.service.jobs()
         try:
-            job = jobs.get(projectId=self.project_id, jobId=job_id).execute()
+            if self.location:
+                job = jobs.get(projectId=self.project_id,
+                               jobId=job_id,
+                               location=self.location).execute()
+            else:
+                job = jobs.get(projectId=self.project_id,
+                               jobId=job_id).execute()
             if job['status']['state'] == 'DONE':
                 return True
         except HttpError as err:
@@ -1160,9 +1186,15 @@ def cancel_query(self):
                 not self.poll_job_complete(self.running_job_id)):
             self.log.info('Attempting to cancel job : %s, %s', self.project_id,
                           self.running_job_id)
-            jobs.cancel(
-                projectId=self.project_id,
-                jobId=self.running_job_id).execute()
+            if self.location:
+                jobs.cancel(
+                    projectId=self.project_id,
+                    jobId=self.running_job_id,
+                    location=self.location).execute()
+            else:
+                jobs.cancel(
+                    projectId=self.project_id,
+                    jobId=self.running_job_id).execute()
         else:
             self.log.info('No running BigQuery jobs to cancel.')
             return
@@ -1634,11 +1666,13 @@ class BigQueryCursor(BigQueryBaseCursor):
     https://github.com/dropbox/PyHive/blob/master/pyhive/common.py
     """
 
-    def __init__(self, service, project_id, use_legacy_sql=True):
+    def __init__(self, service, project_id, use_legacy_sql=True, location=None):
         super(BigQueryCursor, self).__init__(
             service=service,
             project_id=project_id,
-            use_legacy_sql=use_legacy_sql)
+            use_legacy_sql=use_legacy_sql,
+            location=location,
+        )
         self.buffersize = None
         self.page_token = None
         self.job_id = None
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 481568d9291e3..853e80894c10d 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -102,6 +102,10 @@ class BigQueryOperator(BaseOperator):
         by one or more columns. This is only available in conjunction with
         time_partitioning. The order of columns given determines the sort order.
     :type cluster_fields: list of str
+    :param location: The geographic location of the job. Required except for
+        US and EU. See details at
+        https://cloud.google.com/bigquery/docs/locations#specifying_your_location
+    :type location: str
     """
 
     template_fields = ('bql', 'sql', 'destination_dataset_table', 'labels')
@@ -130,6 +134,7 @@ def __init__(self,
                  time_partitioning=None,
                  api_resource_configs=None,
                  cluster_fields=None,
+                 location=None,
                  *args,
                  **kwargs):
         super(BigQueryOperator, self).__init__(*args, **kwargs)
@@ -154,6 +159,7 @@ def __init__(self,
         self.time_partitioning = time_partitioning
         self.api_resource_configs = api_resource_configs
         self.cluster_fields = cluster_fields
+        self.location = location
 
         # TODO remove `bql` in Airflow 2.0
         if self.bql:
@@ -175,7 +181,9 @@ def execute(self, context):
             hook = BigQueryHook(
                 bigquery_conn_id=self.bigquery_conn_id,
                 use_legacy_sql=self.use_legacy_sql,
-                delegate_to=self.delegate_to)
+                delegate_to=self.delegate_to,
+                location=self.location,
+            )
             conn = hook.get_conn()
             self.bq_cursor = conn.cursor()
         self.bq_cursor.run_query(
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index 9334fd6dccdfc..a7da79039f43c 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -249,9 +249,7 @@ def test_invalid_schema_update_and_write_disposition(self):
             )
         self.assertIn("schema_update_options is only", str(context.exception))
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
-    def test_cancel_queries(self, mocked_time, mocked_logging):
+    def test_cancel_queries(self):
         project_id = 12345
         running_job_id = 3
 
@@ -294,8 +292,7 @@ def test_api_resource_configs(self, run_with_config):
             self.assertIs(args[0]['query']['useQueryCache'], bool_val)
             self.assertIs(args[0]['query']['useLegacySql'], True)
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_api_resource_configs_duplication_warning(self, run_with_config):
+    def test_api_resource_configs_duplication_warning(self):
         with self.assertRaises(ValueError):
             cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
             cursor.run_query('query',
@@ -316,8 +313,7 @@ def test_duplication_check(self):
         self.assertIsNone(_api_resource_configs_duplication_check(
             "key_one", key_one, {"key_one": True}))
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_insert_all_succeed(self, run_with_config):
+    def test_insert_all_succeed(self):
         project_id = 'bq-project'
         dataset_id = 'bq_dataset'
         table_id = 'bq_table'
@@ -332,7 +328,7 @@ def test_insert_all_succeed(self, run_with_config):
         }
 
         mock_service = mock.Mock()
-        method = (mock_service.tabledata.return_value.insertAll)
+        method = mock_service.tabledata.return_value.insertAll
         method.return_value.execute.return_value = {
             "kind": "bigquery#tableDataInsertAllResponse"
         }
@@ -341,8 +337,7 @@ def test_insert_all_succeed(self, run_with_config):
         method.assert_called_with(projectId=project_id, datasetId=dataset_id,
                                   tableId=table_id, body=body)
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_insert_all_fail(self, run_with_config):
+    def test_insert_all_fail(self):
         project_id = 'bq-project'
         dataset_id = 'bq_dataset'
         table_id = 'bq_table'
@@ -351,7 +346,7 @@ def test_insert_all_fail(self, run_with_config):
         ]
 
         mock_service = mock.Mock()
-        method = (mock_service.tabledata.return_value.insertAll)
+        method = mock_service.tabledata.return_value.insertAll
         method.return_value.execute.return_value = {
             "kind": "bigquery#tableDataInsertAllResponse",
             "insertErrors": [
@@ -366,8 +361,7 @@ def test_insert_all_fail(self, run_with_config):
             cursor.insert_all(project_id, dataset_id, table_id,
                               rows, fail_on_error=True)
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_create_view_fails_on_exception(self, run_with_config):
+    def test_create_view_fails_on_exception(self):
         project_id = 'bq-project'
         dataset_id = 'bq_dataset'
         table_id = 'bq_table_view'
@@ -377,7 +371,7 @@ def test_create_view_fails_on_exception(self, run_with_config):
         }
 
         mock_service = mock.Mock()
-        method = (mock_service.tables.return_value.insert)
+        method = mock_service.tables.return_value.insert
         method.return_value.execute.side_effect = HttpError(
             resp={'status': '400'}, content=b'Query is required for views')
         cursor = hook.BigQueryBaseCursor(mock_service, project_id)
@@ -385,8 +379,7 @@ def test_create_view_fails_on_exception(self, run_with_config):
             cursor.create_empty_table(project_id, dataset_id, table_id,
                                       view=view)
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_create_view(self, run_with_config):
+    def test_create_view(self):
         project_id = 'bq-project'
         dataset_id = 'bq_dataset'
         table_id = 'bq_table_view'
@@ -396,7 +389,7 @@ def test_create_view(self, run_with_config):
         }
 
         mock_service = mock.Mock()
-        method = (mock_service.tables.return_value.insert)
+        method = mock_service.tables.return_value.insert
         cursor = hook.BigQueryBaseCursor(mock_service, project_id)
         cursor.create_empty_table(project_id, dataset_id, table_id,
                                   view=view)
@@ -440,18 +433,14 @@ def run_with_config(config):
 
 class TestDatasetsOperations(unittest.TestCase):
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_create_empty_dataset_no_dataset_id_err(self,
-                                                    run_with_configuration):
+    def test_create_empty_dataset_no_dataset_id_err(self):
 
         with self.assertRaises(ValueError):
             hook.BigQueryBaseCursor(
                 mock.Mock(), "test_create_empty_dataset").create_empty_dataset(
                 dataset_id="", project_id="")
 
-    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_create_empty_dataset_duplicates_call_err(self,
-                                                      run_with_configuration):
+    def test_create_empty_dataset_duplicates_call_err(self):
         with self.assertRaises(ValueError):
             hook.BigQueryBaseCursor(
                 mock.Mock(), "test_create_empty_dataset").create_empty_dataset(
@@ -525,10 +514,8 @@ def test_get_datasets_list(self):
 
 
 class TestTimePartitioningInRunJob(unittest.TestCase):
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_load_default(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_load_default(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -552,10 +539,8 @@ def test_run_with_auto_detect(self, run_with_config):
         args, kwargs = run_with_config.call_args
         self.assertIs(args[0]['load']['autodetect'], True)
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_load_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_load_with_arg(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -579,10 +564,8 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_query_default(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_query_default(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -594,10 +577,8 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_query_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_query_with_arg(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -644,10 +625,8 @@ def test_extra_time_partitioning_options(self):
 
 class TestClusteringInRunJob(unittest.TestCase):
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_load_default(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_load_default(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -663,10 +642,8 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_load_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_load_with_arg(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -689,10 +666,8 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_query_default(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_query_default(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -704,10 +679,8 @@ def run_with_config(config):
 
         mocked_rwc.assert_called_once()
 
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.LoggingMixin")
-    @mock.patch("airflow.contrib.hooks.bigquery_hook.time")
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
-    def test_run_query_with_arg(self, mocked_rwc, mocked_time, mocked_logging):
+    def test_run_query_with_arg(self, mocked_rwc):
         project_id = 12345
 
         def run_with_config(config):
@@ -750,5 +723,21 @@ def test_legacy_sql_override_propagates_properly(self, run_with_config):
             self.assertIs(args[0]['query']['useLegacySql'], False)
 
 
+class TestBigQueryHookLocation(unittest.TestCase):
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_location_propagates_properly(self, run_with_config):
+        with mock.patch.object(hook.BigQueryHook, 'get_service'):
+            bq_hook = hook.BigQueryHook(location=None)
+            self.assertIsNone(bq_hook.location)
+
+            bq_cursor = hook.BigQueryBaseCursor(mock.Mock(),
+                                                'test-project',
+                                                location=None)
+            self.assertIsNone(bq_cursor.location)
+            bq_cursor.run_query(sql='select 1', location='US')
+            run_with_config.assert_called_once()
+            self.assertEquals(bq_cursor.location, 'US')
+
+
 if __name__ == '__main__':
     unittest.main()

From 3355fb73cb28db5abba783064f65be703396621e Mon Sep 17 00:00:00 2001
From: Yohei Onishi <vivre214@gmail.com>
Date: Sun, 30 Dec 2018 08:09:00 +0800
Subject: [PATCH 306/808] [AIRFLOW-2939][AIRFLOW-3568] Fix TypeError in
 GCSToS3Op & S3ToGCSOp (#4371)

Fix TypeError on GoogleCloudStorageToS3Operator & S3ToGoogleCloudStorageOperator
---
 airflow/contrib/operators/gcs_to_s3.py          | 2 +-
 airflow/contrib/operators/s3_to_gcs_operator.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/operators/gcs_to_s3.py b/airflow/contrib/operators/gcs_to_s3.py
index 0df6170eab377..d0a7947f9f54e 100644
--- a/airflow/contrib/operators/gcs_to_s3.py
+++ b/airflow/contrib/operators/gcs_to_s3.py
@@ -100,7 +100,7 @@ def execute(self, context):
             # Google Cloud Storage and not in S3
             bucket_name, _ = S3Hook.parse_s3_url(self.dest_s3_key)
             existing_files = s3_hook.list_keys(bucket_name)
-            files = set(files) - set(existing_files)
+            files = list(set(files) - set(existing_files))
 
         if files:
             hook = GoogleCloudStorageHook(
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index 81c48a9e157bc..b831adba19c72 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -149,7 +149,7 @@ def execute(self, context):
                     else:
                         existing_files.append(f)
 
-            files = set(files) - set(existing_files)
+            files = list(set(files) - set(existing_files))
             if len(files) > 0:
                 self.log.info('{0} files are going to be synced: {1}.'.format(
                     len(files), files))

From 75a831f459e7f1a16429f30e3bdfedc01a9e5cb8 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@gmail.com>
Date: Tue, 7 Aug 2018 09:57:41 -0700
Subject: [PATCH 307/808] [AIRFLOW-2863] Fix GKEClusterHook catching wrong
 exception (#3711)

---
 airflow/contrib/hooks/gcp_container_hook.py   |  4 +--
 .../contrib/hooks/test_gcp_container_hook.py  | 34 ++++++++++++++++++-
 2 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 970d4ec8992c0..0047b8dbebf2f 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -23,7 +23,7 @@
 from airflow import AirflowException, version
 from airflow.hooks.base_hook import BaseHook
 
-from google.api_core.exceptions import AlreadyExists
+from google.api_core.exceptions import AlreadyExists, NotFound
 from google.api_core.gapic_v1.method import DEFAULT
 from google.cloud import container_v1, exceptions
 from google.cloud.container_v1.gapic.enums import Operation
@@ -146,7 +146,7 @@ def delete_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
             op = self.wait_for_operation(op)
             # Returns server-defined url for the resource
             return op.self_link
-        except exceptions.NotFound as error:
+        except NotFound as error:
             self.log.info('Assuming Success: ' + error.message)
 
     def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index f3705ea4ce7d4..6e13461395bc3 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -61,6 +61,22 @@ def test_delete_cluster(self, wait_mock, convert_mock):
         wait_mock.assert_called_with(client_delete.return_value)
         convert_mock.assert_not_called()
 
+    @mock.patch(
+        "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.log")
+    @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
+    @mock.patch(
+        "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.wait_for_operation")
+    def test_delete_cluster_not_found(self, wait_mock, convert_mock, log_mock):
+        from google.api_core.exceptions import NotFound
+        # To force an error
+        message = 'Not Found'
+        self.gke_hook.client.delete_cluster.side_effect = NotFound(message=message)
+
+        self.gke_hook.delete_cluster(None)
+        wait_mock.assert_not_called()
+        convert_mock.assert_not_called()
+        log_mock.info.assert_any_call("Assuming Success: " + message)
+
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
     @mock.patch(
         "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.wait_for_operation")
@@ -107,7 +123,7 @@ def test_create_cluster_proto(self, wait_mock, convert_mock):
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
     @mock.patch(
         "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.wait_for_operation")
-    def test_delete_cluster_dict(self, wait_mock, convert_mock):
+    def test_create_cluster_dict(self, wait_mock, convert_mock):
         mock_cluster_dict = {'name': CLUSTER_NAME}
         retry_mock, timeout_mock = mock.Mock(), mock.Mock()
 
@@ -135,6 +151,22 @@ def test_create_cluster_error(self, wait_mock, convert_mock):
             wait_mock.assert_not_called()
             convert_mock.assert_not_called()
 
+    @mock.patch(
+        "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.log")
+    @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
+    @mock.patch(
+        "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.wait_for_operation")
+    def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
+        from google.api_core.exceptions import AlreadyExists
+        # To force an error
+        message = 'Already Exists'
+        self.gke_hook.client.create_cluster.side_effect = AlreadyExists(message=message)
+
+        self.gke_hook.create_cluster({})
+        wait_mock.assert_not_called()
+        self.assertEquals(convert_mock.call_count, 1)
+        log_mock.info.assert_any_call("Assuming Success: " + message)
+
 
 class GKEClusterHookGetTest(unittest.TestCase):
     def setUp(self):

From f31a32af6e4d267f8123d0fd8e76a7a2a546eb20 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Sat, 29 Dec 2018 19:12:17 -0500
Subject: [PATCH 308/808] [AIRFLOW-3550] Standardize GKE hook (#4364)

---
 airflow/contrib/hooks/gcp_container_hook.py   | 83 +++++++++++-------
 .../contrib/hooks/test_gcp_container_hook.py  | 85 +++++++++----------
 2 files changed, 90 insertions(+), 78 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 0047b8dbebf2f..84173f249847f 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -21,7 +21,7 @@
 import time
 
 from airflow import AirflowException, version
-from airflow.hooks.base_hook import BaseHook
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 from google.api_core.exceptions import AlreadyExists, NotFound
 from google.api_core.gapic_v1.method import DEFAULT
@@ -34,15 +34,24 @@
 OPERATIONAL_POLL_INTERVAL = 15
 
 
-class GKEClusterHook(BaseHook):
+class GKEClusterHook(GoogleCloudBaseHook):
 
-    def __init__(self, project_id, location):
-        self.project_id = project_id
+    def __init__(self,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None,
+                 location=None):
+        super(GKEClusterHook, self).__init__(
+            gcp_conn_id=gcp_conn_id, delegate_to=delegate_to)
+        self._client = None
         self.location = location
 
-        # Add client library info for better error tracking
-        client_info = ClientInfo(client_library_version='airflow_v' + version.version)
-        self.client = container_v1.ClusterManagerClient(client_info=client_info)
+    def get_client(self):
+        if self._client is None:
+            credentials = self._get_credentials()
+            # Add client library info for better error tracking
+            client_info = ClientInfo(client_library_version='airflow_v' + version.version)
+            self._client = container_v1.ClusterManagerClient(credentials=credentials, client_info=client_info)
+        return self._client
 
     @staticmethod
     def _dict_to_proto(py_dict, proto):
@@ -60,13 +69,15 @@ def _dict_to_proto(py_dict, proto):
         dict_json_str = json.dumps(py_dict)
         return json_format.Parse(dict_json_str, proto)
 
-    def wait_for_operation(self, operation):
+    def wait_for_operation(self, operation, project_id=None):
         """
         Given an operation, continuously fetches the status from Google Cloud until either
         completion or an error occurring
 
         :param operation: The Operation to wait for
         :type operation: A google.cloud.container_V1.gapic.enums.Operator
+        :param project_id: Google Cloud Platform project ID
+        :type project_id: str
         :return: A new, updated operation fetched from Google Cloud
         """
         self.log.info("Waiting for OPERATION_NAME %s" % operation.name)
@@ -79,20 +90,22 @@ def wait_for_operation(self, operation):
                 raise exceptions.GoogleCloudError(
                     "Operation has failed with status: %s" % operation.status)
             # To update status of operation
-            operation = self.get_operation(operation.name)
+            operation = self.get_operation(operation.name, project_id=project_id or self.project_id)
         return operation
 
-    def get_operation(self, operation_name):
+    def get_operation(self, operation_name, project_id=None):
         """
         Fetches the operation from Google Cloud
 
         :param operation_name: Name of operation to fetch
         :type operation_name: str
+        :param project_id: Google Cloud Platform project ID
+        :type project_id: str
         :return: The new, updated operation from Google Cloud
         """
-        return self.client.get_operation(project_id=self.project_id,
-                                         zone=self.location,
-                                         operation_id=operation_name)
+        return self.get_client().get_operation(project_id=project_id or self.project_id,
+                                               zone=self.location,
+                                               operation_id=operation_name)
 
     @staticmethod
     def _append_label(cluster_proto, key, val):
@@ -113,7 +126,7 @@ def _append_label(cluster_proto, key, val):
         cluster_proto.resource_labels.update({key: val})
         return cluster_proto
 
-    def delete_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
+    def delete_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         """
         Deletes the cluster, including the Kubernetes endpoint and all
         worker nodes. Firewalls and routes that were configured during
@@ -124,6 +137,8 @@ def delete_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
 
         :param name: The name of the cluster to delete
         :type name: str
+        :param project_id: Google Cloud Platform project ID
+        :type project_id: str
         :param retry: Retry object used to determine when/if to retry requests.
             If None is specified, requests will not be retried.
         :type retry: google.api_core.retry.Retry
@@ -138,18 +153,18 @@ def delete_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
             self.project_id, self.location, name))
 
         try:
-            op = self.client.delete_cluster(project_id=self.project_id,
-                                            zone=self.location,
-                                            cluster_id=name,
-                                            retry=retry,
-                                            timeout=timeout)
+            op = self.get_client().delete_cluster(project_id=project_id or self.project_id,
+                                                  zone=self.location,
+                                                  cluster_id=name,
+                                                  retry=retry,
+                                                  timeout=timeout)
             op = self.wait_for_operation(op)
             # Returns server-defined url for the resource
             return op.self_link
         except NotFound as error:
             self.log.info('Assuming Success: ' + error.message)
 
-    def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
+    def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         """
         Creates a cluster, consisting of the specified number and type of Google Compute
         Engine instances.
@@ -157,6 +172,8 @@ def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
         :param cluster: A Cluster protobuf or dict. If dict is provided, it must be of
             the same form as the protobuf message google.cloud.container_v1.types.Cluster
         :type cluster: dict or google.cloud.container_v1.types.Cluster
+        :param project_id: Google Cloud Platform project ID
+        :type project_id: str
         :param retry: A retry object (google.api_core.retry.Retry) used to retry requests.
             If None is specified, requests will not be retried.
         :type retry: google.api_core.retry.Retry
@@ -184,11 +201,11 @@ def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
             self.location,
             cluster.name))
         try:
-            op = self.client.create_cluster(project_id=self.project_id,
-                                            zone=self.location,
-                                            cluster=cluster,
-                                            retry=retry,
-                                            timeout=timeout)
+            op = self.get_client().create_cluster(project_id=project_id or self.project_id,
+                                                  zone=self.location,
+                                                  cluster=cluster,
+                                                  retry=retry,
+                                                  timeout=timeout)
             op = self.wait_for_operation(op)
 
             return op.target_link
@@ -196,12 +213,14 @@ def create_cluster(self, cluster, retry=DEFAULT, timeout=DEFAULT):
             self.log.info('Assuming Success: ' + error.message)
             return self.get_cluster(name=cluster.name).self_link
 
-    def get_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
+    def get_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         """
         Gets details of specified cluster
 
         :param name: The name of the cluster to retrieve
         :type name: str
+        :param project_id: Google Cloud Platform project ID
+        :type project_id: str
         :param retry: A retry object used to retry requests. If None is specified,
             requests will not be retried.
         :type retry: google.api_core.retry.Retry
@@ -212,12 +231,12 @@ def get_cluster(self, name, retry=DEFAULT, timeout=DEFAULT):
         :return: A google.cloud.container_v1.types.Cluster instance
         """
         self.log.info("Fetching cluster (project_id={}, zone={}, cluster_name={})".format(
-            self.project_id,
+            project_id or self.project_id,
             self.location,
             name))
 
-        return self.client.get_cluster(project_id=self.project_id,
-                                       zone=self.location,
-                                       cluster_id=name,
-                                       retry=retry,
-                                       timeout=timeout).self_link
+        return self.get_client().get_cluster(project_id=project_id or self.project_id,
+                                             zone=self.location,
+                                             cluster_id=name,
+                                             retry=retry,
+                                             timeout=timeout).self_link
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index 6e13461395bc3..f4a21da7fc311 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -17,18 +17,12 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import mock
 import unittest
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_container_hook import GKEClusterHook
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 TASK_ID = 'test-gke-cluster-operator'
 CLUSTER_NAME = 'test-cluster'
@@ -38,11 +32,8 @@
 
 class GKEClusterHookDeleteTest(unittest.TestCase):
     def setUp(self):
-        with mock.patch.object(GKEClusterHook, "__init__", return_value=None):
-            self.gke_hook = GKEClusterHook(None, None, None)
-            self.gke_hook.project_id = TEST_PROJECT_ID
-            self.gke_hook.location = ZONE
-            self.gke_hook.client = mock.Mock()
+        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook._client = mock.Mock()
 
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
     @mock.patch(
@@ -50,9 +41,9 @@ def setUp(self):
     def test_delete_cluster(self, wait_mock, convert_mock):
         retry_mock, timeout_mock = mock.Mock(), mock.Mock()
 
-        client_delete = self.gke_hook.client.delete_cluster = mock.Mock()
+        client_delete = self.gke_hook._client.delete_cluster = mock.Mock()
 
-        self.gke_hook.delete_cluster(name=CLUSTER_NAME, retry=retry_mock,
+        self.gke_hook.delete_cluster(name=CLUSTER_NAME, project_id=TEST_PROJECT_ID, retry=retry_mock,
                                      timeout=timeout_mock)
 
         client_delete.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
@@ -70,7 +61,7 @@ def test_delete_cluster_not_found(self, wait_mock, convert_mock, log_mock):
         from google.api_core.exceptions import NotFound
         # To force an error
         message = 'Not Found'
-        self.gke_hook.client.delete_cluster.side_effect = NotFound(message=message)
+        self.gke_hook._client.delete_cluster.side_effect = NotFound(message=message)
 
         self.gke_hook.delete_cluster(None)
         wait_mock.assert_not_called()
@@ -82,7 +73,7 @@ def test_delete_cluster_not_found(self, wait_mock, convert_mock, log_mock):
         "airflow.contrib.hooks.gcp_container_hook.GKEClusterHook.wait_for_operation")
     def test_delete_cluster_error(self, wait_mock, convert_mock):
         # To force an error
-        self.gke_hook.client.delete_cluster.side_effect = AirflowException('400')
+        self.gke_hook._client.delete_cluster.side_effect = AirflowException('400')
 
         with self.assertRaises(AirflowException):
             self.gke_hook.delete_cluster(None)
@@ -92,11 +83,8 @@ def test_delete_cluster_error(self, wait_mock, convert_mock):
 
 class GKEClusterHookCreateTest(unittest.TestCase):
     def setUp(self):
-        with mock.patch.object(GKEClusterHook, "__init__", return_value=None):
-            self.gke_hook = GKEClusterHook(None, None, None)
-            self.gke_hook.project_id = TEST_PROJECT_ID
-            self.gke_hook.location = ZONE
-            self.gke_hook.client = mock.Mock()
+        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook._client = mock.Mock()
 
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
     @mock.patch(
@@ -109,9 +97,9 @@ def test_create_cluster_proto(self, wait_mock, convert_mock):
 
         retry_mock, timeout_mock = mock.Mock(), mock.Mock()
 
-        client_create = self.gke_hook.client.create_cluster = mock.Mock()
+        client_create = self.gke_hook._client.create_cluster = mock.Mock()
 
-        self.gke_hook.create_cluster(mock_cluster_proto, retry=retry_mock,
+        self.gke_hook.create_cluster(mock_cluster_proto, project_id=TEST_PROJECT_ID, retry=retry_mock,
                                      timeout=timeout_mock)
 
         client_create.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
@@ -127,10 +115,10 @@ def test_create_cluster_dict(self, wait_mock, convert_mock):
         mock_cluster_dict = {'name': CLUSTER_NAME}
         retry_mock, timeout_mock = mock.Mock(), mock.Mock()
 
-        client_create = self.gke_hook.client.create_cluster = mock.Mock()
+        client_create = self.gke_hook._client.create_cluster = mock.Mock()
         proto_mock = convert_mock.return_value = mock.Mock()
 
-        self.gke_hook.create_cluster(mock_cluster_dict, retry=retry_mock,
+        self.gke_hook.create_cluster(mock_cluster_dict, project_id=TEST_PROJECT_ID, retry=retry_mock,
                                      timeout=timeout_mock)
 
         client_create.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
@@ -160,7 +148,7 @@ def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
         from google.api_core.exceptions import AlreadyExists
         # To force an error
         message = 'Already Exists'
-        self.gke_hook.client.create_cluster.side_effect = AlreadyExists(message=message)
+        self.gke_hook._client.create_cluster.side_effect = AlreadyExists(message=message)
 
         self.gke_hook.create_cluster({})
         wait_mock.assert_not_called()
@@ -170,18 +158,15 @@ def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
 
 class GKEClusterHookGetTest(unittest.TestCase):
     def setUp(self):
-        with mock.patch.object(GKEClusterHook, "__init__", return_value=None):
-            self.gke_hook = GKEClusterHook(None, None, None)
-            self.gke_hook.project_id = TEST_PROJECT_ID
-            self.gke_hook.location = ZONE
-            self.gke_hook.client = mock.Mock()
+        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook._client = mock.Mock()
 
     def test_get_cluster(self):
         retry_mock, timeout_mock = mock.Mock(), mock.Mock()
 
-        client_get = self.gke_hook.client.get_cluster = mock.Mock()
+        client_get = self.gke_hook._client.get_cluster = mock.Mock()
 
-        self.gke_hook.get_cluster(name=CLUSTER_NAME, retry=retry_mock,
+        self.gke_hook.get_cluster(name=CLUSTER_NAME, project_id=TEST_PROJECT_ID, retry=retry_mock,
                                   timeout=timeout_mock)
 
         client_get.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
@@ -192,18 +177,26 @@ def test_get_cluster(self):
 class GKEClusterHookTest(unittest.TestCase):
 
     def setUp(self):
-        with mock.patch.object(GKEClusterHook, "__init__", return_value=None):
-            self.gke_hook = GKEClusterHook(None, None, None)
-            self.gke_hook.project_id = TEST_PROJECT_ID
-            self.gke_hook.location = ZONE
-            self.gke_hook.client = mock.Mock()
+        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook._client = mock.Mock()
+
+    @mock.patch('airflow.contrib.hooks.gcp_container_hook.container_v1.ClusterManagerClient')
+    @mock.patch('airflow.contrib.hooks.gcp_container_hook.ClientInfo')
+    @mock.patch('airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._get_credentials')
+    def test_get_client(self, mock_get_credentials, mock_client_info, mock_client):
+        self.gke_hook._client = None
+        self.gke_hook.get_client()
+        mock_get_credentials.assert_called()
+        mock_client.assert_called_with(
+            credentials=mock_get_credentials.return_value,
+            client_info=mock_client_info.return_value)
 
     def test_get_operation(self):
-        self.gke_hook.client.get_operation = mock.Mock()
-        self.gke_hook.get_operation('TEST_OP')
-        self.gke_hook.client.get_operation.assert_called_with(project_id=TEST_PROJECT_ID,
-                                                              zone=ZONE,
-                                                              operation_id='TEST_OP')
+        self.gke_hook._client.get_operation = mock.Mock()
+        self.gke_hook.get_operation('TEST_OP', project_id=TEST_PROJECT_ID)
+        self.gke_hook._client.get_operation.assert_called_with(project_id=TEST_PROJECT_ID,
+                                                               zone=ZONE,
+                                                               operation_id='TEST_OP')
 
     def test_append_label(self):
         key = 'test-key'
@@ -251,11 +244,11 @@ def test_wait_for_response_running(self, time_mock, operation_mock):
 
         # Status goes from Running -> Pending -> Done
         operation_mock.side_effect = [pending_op, done_op]
-        self.gke_hook.wait_for_operation(running_op)
+        self.gke_hook.wait_for_operation(running_op, project_id=TEST_PROJECT_ID)
 
         self.assertEqual(time_mock.call_count, 3)
-        operation_mock.assert_any_call(running_op.name)
-        operation_mock.assert_any_call(pending_op.name)
+        operation_mock.assert_any_call(running_op.name, project_id=TEST_PROJECT_ID)
+        operation_mock.assert_any_call(pending_op.name, project_id=TEST_PROJECT_ID)
         self.assertEqual(operation_mock.call_count, 2)
 
     @mock.patch("google.protobuf.json_format.Parse")

From f6a07a8c2226ecb3cfdf127da5b7339118138412 Mon Sep 17 00:00:00 2001
From: Tom Kunc <tom.kunc@kinesis.org>
Date: Tue, 24 Jul 2018 01:12:09 +0100
Subject: [PATCH 309/808] [AIRFLOW-2712] Pass annotations to
 KubernetesExecutorConfig

---
 airflow/contrib/example_dags/__init__.py      |  0
 .../example_kubernetes_annotation.py          | 47 +++++++++++++++++++
 .../contrib/executors/kubernetes_executor.py  | 14 ++++--
 .../kubernetes/worker_configuration.py        |  6 +--
 .../minikube/test_kubernetes_executor.py      | 18 +++----
 5 files changed, 69 insertions(+), 16 deletions(-)
 create mode 100644 airflow/contrib/example_dags/__init__.py
 create mode 100644 airflow/contrib/example_dags/example_kubernetes_annotation.py

diff --git a/airflow/contrib/example_dags/__init__.py b/airflow/contrib/example_dags/__init__.py
new file mode 100644
index 0000000000000..e69de29bb2d1d
diff --git a/airflow/contrib/example_dags/example_kubernetes_annotation.py b/airflow/contrib/example_dags/example_kubernetes_annotation.py
new file mode 100644
index 0000000000000..058baf69901f7
--- /dev/null
+++ b/airflow/contrib/example_dags/example_kubernetes_annotation.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from __future__ import print_function
+import airflow
+from airflow.operators.python_operator import PythonOperator
+from airflow.models import DAG
+
+args = {
+    'owner': 'airflow',
+    'start_date': airflow.utils.dates.days_ago(2)
+}
+
+dag = DAG(
+    dag_id='example_kubernetes_annotation', default_args=args,
+    schedule_interval=None
+)
+
+
+def print_stuff():
+    print("annotated!")
+
+
+# You can use annotations on your kubernetes pods!
+start_task = PythonOperator(
+    task_id="start_task", python_callable=print_stuff, dag=dag,
+    executor_config={
+        "KubernetesExecutor": {
+            "annotations": {"test": "annotation"}
+        }
+    }
+)
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 4021bce356a40..5104d150f0065 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -39,7 +39,8 @@
 class KubernetesExecutorConfig:
     def __init__(self, image=None, image_pull_policy=None, request_memory=None,
                  request_cpu=None, limit_memory=None, limit_cpu=None,
-                 gcp_service_account_key=None, node_selectors=None, affinity=None):
+                 gcp_service_account_key=None, node_selectors=None, affinity=None,
+                 annotations=None):
         self.image = image
         self.image_pull_policy = image_pull_policy
         self.request_memory = request_memory
@@ -49,15 +50,16 @@ def __init__(self, image=None, image_pull_policy=None, request_memory=None,
         self.gcp_service_account_key = gcp_service_account_key
         self.node_selectors = node_selectors
         self.affinity = affinity
+        self.annotations = annotations
 
     def __repr__(self):
         return "{}(image={}, image_pull_policy={}, request_memory={}, request_cpu={}, " \
                "limit_memory={}, limit_cpu={}, gcp_service_account_key={}, " \
-               "node_selectors={}, affinity={})" \
+               "node_selectors={}, affinity={}, annotations={})" \
             .format(KubernetesExecutorConfig.__name__, self.image, self.image_pull_policy,
                     self.request_memory, self.request_cpu, self.limit_memory,
                     self.limit_cpu, self.gcp_service_account_key, self.node_selectors,
-                    self.affinity)
+                    self.affinity, self.annotations)
 
     @staticmethod
     def from_dict(obj):
@@ -79,7 +81,8 @@ def from_dict(obj):
             limit_cpu=namespaced.get('limit_cpu', None),
             gcp_service_account_key=namespaced.get('gcp_service_account_key', None),
             node_selectors=namespaced.get('node_selectors', None),
-            affinity=namespaced.get('affinity', None)
+            affinity=namespaced.get('affinity', None),
+            annotations=namespaced.get('annotations', {}),
         )
 
     def as_dict(self):
@@ -92,7 +95,8 @@ def as_dict(self):
             'limit_cpu': self.limit_cpu,
             'gcp_service_account_key': self.gcp_service_account_key,
             'node_selectors': self.node_selectors,
-            'affinity': self.affinity
+            'affinity': self.affinity,
+            'annotations': self.annotations,
         }
 
 
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index b21b6db9871b9..ad19426f0f565 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -185,9 +185,9 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             limit_cpu=kube_executor_config.limit_cpu
         )
         gcp_sa_key = kube_executor_config.gcp_service_account_key
-        annotations = {
-            'iam.cloud.google.com/service-account': gcp_sa_key
-        } if gcp_sa_key else {}
+        annotations = kube_executor_config.annotations.copy()
+        if gcp_sa_key:
+            annotations['iam.cloud.google.com/service-account'] = gcp_sa_key
 
         return Pod(
             namespace=namespace,
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index 2d1105111b5b2..45d4124d07973 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -150,8 +150,9 @@ def start_dag(self, dag_id, host):
 
     def test_integration_run_dag(self):
         host = get_minikube_host()
+        dag_id = 'example_kubernetes_annotation'
 
-        result_json = self.start_dag(dag_id='example_python_operator', host=host)
+        result_json = self.start_dag(dag_id=dag_id, host=host)
 
         self.assertGreater(len(result_json['items']), 0)
 
@@ -161,19 +162,20 @@ def test_integration_run_dag(self):
         # Wait 100 seconds for the operator to complete
         self.monitor_task(host=host,
                           execution_date=execution_date,
-                          dag_id='example_python_operator',
-                          task_id='print_the_context',
+                          dag_id=dag_id,
+                          task_id='start_task',
                           expected_final_state='success', timeout=100)
 
         self.ensure_dag_expected_state(host=host,
                                        execution_date=execution_date,
-                                       dag_id='example_python_operator',
+                                       dag_id=dag_id,
                                        expected_final_state='success', timeout=100)
 
     def test_integration_run_dag_with_scheduler_failure(self):
         host = get_minikube_host()
+        dag_id = 'example_kubernetes_annotation'
 
-        result_json = self.start_dag(dag_id='example_python_operator', host=host)
+        result_json = self.start_dag(dag_id=dag_id, host=host)
 
         self.assertGreater(len(result_json['items']), 0)
 
@@ -187,13 +189,13 @@ def test_integration_run_dag_with_scheduler_failure(self):
         # Wait 100 seconds for the operator to complete
         self.monitor_task(host=host,
                           execution_date=execution_date,
-                          dag_id='example_python_operator',
-                          task_id='print_the_context',
+                          dag_id=dag_id,
+                          task_id='start_task',
                           expected_final_state='success', timeout=120)
 
         self.ensure_dag_expected_state(host=host,
                                        execution_date=execution_date,
-                                       dag_id='example_python_operator',
+                                       dag_id=dag_id,
                                        expected_final_state='success', timeout=100)
 
 

From 53a8440bf11191b1b7780dc08ff874ca723445f2 Mon Sep 17 00:00:00 2001
From: Ravi Kotecha <kotecha.ravi@gmail.com>
Date: Fri, 22 Jun 2018 16:37:46 +0200
Subject: [PATCH 310/808] [AIRFLOW-2661] fix config dags_volume_subpath and
 logs_volume_subpath

Make sure you have checked _all_ steps below.

### JIRA
- [x] My PR addresses the following [Airflow JIRA]
(https://issues.apache.org/jira/browse/AIRFLOW/)
issues and references them in the PR title. For
example, "\[AIRFLOW-XXX\] My Airflow PR"
    -
https://issues.apache.org/jira/browse/AIRFLOW-2661
    - In case you are fixing a typo in the
documentation you can prepend your commit with
\[AIRFLOW-XXX\], code changes always need a JIRA
issue.

### Description
- [x] Here are some details about my PR, including
screenshots of any UI changes:
Changes the use of `log_volume_subpath` and
`dags_volume_subpath` which are
now passed into the construction of the worker
pod's volumeMounts instead of
the volume section (where subPath is not valid).

### Tests
- [x] My PR adds the following unit tests __OR__
does not need testing for this extremely good
reason:
Unit tests have been added but I'm not sure how to
add integration tests
for this without breaking the other minikube tests

### Commits
- [x] My commits all reference JIRA issues in
their subject lines, and I have squashed multiple
commits if they address the same issue. In
addition, my commits follow the guidelines from
"[How to write a good git commit
message](http://chris.beams.io/posts/git-
commit/)":
    1. Subject is separated from body by a blank line
    2. Subject is limited to 50 characters
    3. Subject does not end with a period
    4. Subject uses the imperative mood ("add", not
"adding")
    5. Body wraps at 72 characters
    6. Body explains "what" and "why", not "how"

### Documentation
- [x] In case of new functionality, my PR adds
documentation that describes how to use it.

No new functionality added

### Code Quality
- [x] Passes `git diff upstream/master -u --
"*.py" | flake8 --diff`

Closes #3537 from r4vi/AIRFLOW-2661
---
 .../kubernetes/worker_configuration.py        | 41 +++++++-----
 .../executors/test_kubernetes_executor.py     | 62 +++++++++++++++++++
 2 files changed, 86 insertions(+), 17 deletions(-)

diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index ad19426f0f565..86ee270abc1b2 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -109,34 +109,31 @@ def init_volumes_and_mounts(self):
         dags_volume_name = 'airflow-dags'
         logs_volume_name = 'airflow-logs'
 
-        def _construct_volume(name, claim, subpath=None):
-            vo = {
+        def _construct_volume(name, claim):
+            volume = {
                 'name': name
             }
             if claim:
-                vo['persistentVolumeClaim'] = {
+                volume['persistentVolumeClaim'] = {
                     'claimName': claim
                 }
-                if subpath:
-                    vo['subPath'] = subpath
             else:
-                vo['emptyDir'] = {}
-            return vo
+                volume['emptyDir'] = {}
+            return volume
 
         volumes = [
             _construct_volume(
                 dags_volume_name,
-                self.kube_config.dags_volume_claim,
-                self.kube_config.dags_volume_subpath
+                self.kube_config.dags_volume_claim
             ),
             _construct_volume(
                 logs_volume_name,
-                self.kube_config.logs_volume_claim,
-                self.kube_config.logs_volume_subpath
+                self.kube_config.logs_volume_claim
             )
         ]
 
         dag_volume_mount_path = ""
+
         if self.kube_config.dags_volume_claim:
             dag_volume_mount_path = self.worker_airflow_dags
         else:
@@ -144,15 +141,25 @@ def _construct_volume(name, claim, subpath=None):
                 self.worker_airflow_dags,
                 self.kube_config.git_subpath
             )
-
-        volume_mounts = [{
+        dags_volume_mount = {
             'name': dags_volume_name,
             'mountPath': dag_volume_mount_path,
-            'readOnly': True
-        }, {
+            'readOnly': True,
+        }
+        if self.kube_config.dags_volume_subpath:
+            dags_volume_mount['subPath'] = self.kube_config.dags_volume_subpath
+
+        logs_volume_mount = {
             'name': logs_volume_name,
-            'mountPath': self.worker_airflow_logs
-        }]
+            'mountPath': self.worker_airflow_logs,
+        }
+        if self.kube_config.dags_volume_subpath:
+            logs_volume_mount['subPath'] = self.kube_config.logs_volume_subpath
+
+        volume_mounts = [
+            dags_volume_mount,
+            logs_volume_mount
+        ]
 
         # Mount the airflow.cfg file via a configmap the user has specified
         if self.kube_config.airflow_configmap:
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index a42a87dd17996..796a8e9ad1c1e 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -14,6 +14,7 @@
 #
 
 import unittest
+import mock
 import re
 import string
 import random
@@ -21,6 +22,7 @@
 
 try:
     from airflow.contrib.executors.kubernetes_executor import AirflowKubernetesScheduler
+    from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
 except ImportError:
     AirflowKubernetesScheduler = None
 
@@ -74,5 +76,65 @@ def test_execution_date_serialize_deserialize(self):
         self.assertEquals(datetime_obj, new_datetime_obj)
 
 
+class TestKubernetesWorkerConfiguration(unittest.TestCase):
+    """
+    Tests that if dags_volume_subpath/logs_volume_subpath configuration
+    options are passed to worker pod config
+    """
+    def setUp(self):
+        if AirflowKubernetesScheduler is None:
+            self.skipTest("kubernetes python package is not installed")
+
+        self.pod = mock.patch(
+            'airflow.contrib.kubernetes.worker_configuration.Pod'
+        )
+        self.resources = mock.patch(
+            'airflow.contrib.kubernetes.worker_configuration.Resources'
+        )
+        self.secret = mock.patch(
+            'airflow.contrib.kubernetes.worker_configuration.Secret'
+        )
+
+        for patcher in [self.pod, self.resources, self.secret]:
+            self.mock_foo = patcher.start()
+            self.addCleanup(patcher.stop)
+
+        self.kube_config = mock.MagicMock()
+        self.kube_config.airflow_home = '/'
+        self.kube_config.airflow_dags = 'dags'
+        self.kube_config.airflow_dags = 'logs'
+        self.kube_config.dags_volume_subpath = None
+        self.kube_config.logs_volume_subpath = None
+
+    def test_worker_configuration_no_subpaths(self):
+        worker_config = WorkerConfiguration(self.kube_config)
+        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        for volume_or_mount in volumes + volume_mounts:
+            if volume_or_mount['name'] != 'airflow-config':
+                self.assertNotIn(
+                    'subPath', volume_or_mount,
+                    "subPath shouldn't be defined"
+                )
+
+    def test_worker_with_subpaths(self):
+        self.kube_config.dags_volume_subpath = 'dags'
+        self.kube_config.logs_volume_subpath = 'logs'
+        worker_config = WorkerConfiguration(self.kube_config)
+        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+
+        for volume in volumes:
+            self.assertNotIn(
+                'subPath', volume,
+                "subPath isn't valid configuration for a volume"
+            )
+
+        for volume_mount in volume_mounts:
+            if volume_mount['name'] != 'airflow-config':
+                self.assertIn(
+                    'subPath', volume_mount,
+                    "subPath should've been passed to volumeMount configuration"
+                )
+
+
 if __name__ == '__main__':
     unittest.main()

From 08c1713c289bc15a272ebbaba15d4575baa35f40 Mon Sep 17 00:00:00 2001
From: roc <rockerchen@tencent.com>
Date: Wed, 20 Jun 2018 20:37:39 +0200
Subject: [PATCH 311/808] [AIRFLOW-2645][AIRFLOW-2617] Add
 worker_container_image_pull_policy

Set worker_container_image_pull_policy in default_airflow.cfg

As AIRFLOW-2617 added worker_container_image_pull_policy config
to the section of kubernetes, but the airflow_default.cfg
was not updated, this PR add worker_container_image_pull_policy
to default_airflow.cfg.

Closes #3521 from imroc/AIRFLOW-2645
---
 airflow/config_templates/default_airflow.cfg | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 7159c137f4c25..b5182434ccff8 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -568,9 +568,10 @@ elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_
 elasticsearch_end_of_log_mark = end_of_log
 
 [kubernetes]
-# The repository and tag of the Kubernetes Image for the Worker to Run
+# The repository, tag and imagePullPolicy of the Kubernetes Image for the Worker to Run
 worker_container_repository =
 worker_container_tag =
+worker_container_image_pull_policy = IfNotPresent
 
 # If True (default), worker pods will be deleted upon termination
 delete_worker_pods = True

From b446c56b2f251134703ac19721ef8225ef17e23b Mon Sep 17 00:00:00 2001
From: Shintaro Murakami <mrkm4ntr@gmail.com>
Date: Wed, 4 Jul 2018 17:48:51 +0100
Subject: [PATCH 312/808] [AIRFLOW-2655] Fix inconsistency of default config of
 kubernetes worker

Closes #3529 from mrkm4ntr/airflow-2655
---
 airflow/contrib/kubernetes/worker_configuration.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 86ee270abc1b2..50f7374e78c22 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -19,6 +19,7 @@
 import os
 import six
 
+from airflow.configuration import conf
 from airflow.contrib.kubernetes.pod import Pod, Resources
 from airflow.contrib.kubernetes.secret import Secret
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -84,7 +85,8 @@ def _get_environment(self):
         """Defines any necessary environment variables for the pod executor"""
         env = {
             'AIRFLOW__CORE__DAGS_FOLDER': '/tmp/dags',
-            'AIRFLOW__CORE__EXECUTOR': 'LocalExecutor'
+            'AIRFLOW__CORE__EXECUTOR': 'LocalExecutor',
+            'AIRFLOW__CORE__SQL_ALCHEMY_CONN': conf.get('core', 'SQL_ALCHEMY_CONN')
         }
         if self.kube_config.airflow_configmap:
             env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home

From f2d77789aa898366eec54bb18b616dd78f5c04b7 Mon Sep 17 00:00:00 2001
From: Aldo Giambelluca <xoen@users.noreply.github.com>
Date: Mon, 6 Aug 2018 21:44:48 +0100
Subject: [PATCH 313/808] [AIRFLOW-2755] Added `kubernetes.worker_dags_folder`
 configuration (#3612)

It was previously hardcoded to `/tmp/dags`.
This causes problems with python import of modules in the DAGs folder.
---
 airflow/config_templates/default_airflow.cfg     |  1 +
 airflow/contrib/executors/kubernetes_executor.py |  2 ++
 .../contrib/kubernetes/worker_configuration.py   |  8 +++++---
 scripts/ci/kubernetes/kube/configmaps.yaml       |  1 +
 .../executors/test_kubernetes_executor.py        | 16 ++++++++++++++++
 5 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index b5182434ccff8..dd43b980aaa6c 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -572,6 +572,7 @@ elasticsearch_end_of_log_mark = end_of_log
 worker_container_repository =
 worker_container_tag =
 worker_container_image_pull_policy = IfNotPresent
+worker_dags_folder =
 
 # If True (default), worker pods will be deleted upon termination
 delete_worker_pods = True
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 5104d150f0065..9769dc3c90332 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -115,6 +115,8 @@ def __init__(self):
             self.kubernetes_section, 'worker_container_repository')
         self.worker_container_tag = configuration.get(
             self.kubernetes_section, 'worker_container_tag')
+        self.worker_dags_folder = configuration.get(
+            self.kubernetes_section, 'worker_dags_folder')
         self.kube_image = '{}:{}'.format(
             self.worker_container_repository, self.worker_container_tag)
         self.kube_image_pull_policy = configuration.get(
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 50f7374e78c22..18239c5cd2a24 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -84,12 +84,14 @@ def _get_init_containers(self, volume_mounts):
     def _get_environment(self):
         """Defines any necessary environment variables for the pod executor"""
         env = {
-            'AIRFLOW__CORE__DAGS_FOLDER': '/tmp/dags',
-            'AIRFLOW__CORE__EXECUTOR': 'LocalExecutor',
-            'AIRFLOW__CORE__SQL_ALCHEMY_CONN': conf.get('core', 'SQL_ALCHEMY_CONN')
+            "AIRFLOW__CORE__EXECUTOR": "LocalExecutor",
+            "AIRFLOW__CORE__SQL_ALCHEMY_CONN": conf.get("core", "SQL_ALCHEMY_CONN"),
         }
+
         if self.kube_config.airflow_configmap:
             env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home
+        if self.kube_config.worker_dags_folder:
+            env['AIRFLOW__CORE__DAGS_FOLDER'] = self.kube_config.worker_dags_folder
         return env
 
     def _get_secrets(self):
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index 5796599683eb5..4c86bcaa6915f 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -176,6 +176,7 @@ data:
     worker_container_repository = airflow
     worker_container_tag = latest
     worker_container_image_pull_policy = IfNotPresent
+    worker_dags_folder = /tmp/dags
     delete_worker_pods = True
     git_repo = https://github.com/apache/incubator-airflow.git
     git_branch = master
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 796a8e9ad1c1e..c203e18d5cf8e 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -135,6 +135,22 @@ def test_worker_with_subpaths(self):
                     "subPath should've been passed to volumeMount configuration"
                 )
 
+    def test_worker_environment_no_dags_folder(self):
+        self.kube_config.worker_dags_folder = ''
+        worker_config = WorkerConfiguration(self.kube_config)
+        env = worker_config._get_environment()
+
+        self.assertNotIn('AIRFLOW__CORE__DAGS_FOLDER', env)
+
+    def test_worker_environment_when_dags_folder_specified(self):
+        dags_folder = '/workers/path/to/dags'
+        self.kube_config.worker_dags_folder = dags_folder
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        env = worker_config._get_environment()
+
+        self.assertEqual(dags_folder, env['AIRFLOW__CORE__DAGS_FOLDER'])
+
 
 if __name__ == '__main__':
     unittest.main()

From b15fecf1e18c9ad413fb16b4dbbde58bf4301769 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Sun, 19 Aug 2018 22:07:53 +0800
Subject: [PATCH 314/808] [AIRFLOW-2917] Set AIRFLOW__CORE__SQL_ALCHEMY_CONN
 only when needed (#3766)

Only when `airflow_configmap` is not provided and `AIRFLOW__CORE__SQL_ALCHEMY_CONN`
not in secrets, it is set as an env var.
---
 airflow/contrib/kubernetes/worker_configuration.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 18239c5cd2a24..dd620ba66ecc4 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -85,13 +85,15 @@ def _get_environment(self):
         """Defines any necessary environment variables for the pod executor"""
         env = {
             "AIRFLOW__CORE__EXECUTOR": "LocalExecutor",
-            "AIRFLOW__CORE__SQL_ALCHEMY_CONN": conf.get("core", "SQL_ALCHEMY_CONN"),
         }
 
         if self.kube_config.airflow_configmap:
             env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home
         if self.kube_config.worker_dags_folder:
             env['AIRFLOW__CORE__DAGS_FOLDER'] = self.kube_config.worker_dags_folder
+        if (not self.kube_config.airflow_configmap and
+                'AIRFLOW__CORE__SQL_ALCHEMY_CONN' not in self.kube_config.kube_secrets):
+            env['AIRFLOW__CORE__SQL_ALCHEMY_CONN'] = conf.get("core", "SQL_ALCHEMY_CONN")
         return env
 
     def _get_secrets(self):

From 27f48702ecb224b35c4c591a1e331b7899c3ecf2 Mon Sep 17 00:00:00 2001
From: John Cheng <ckljohn@gmail.com>
Date: Tue, 6 Nov 2018 00:28:01 +0800
Subject: [PATCH 315/808] [AIRFLOW-3022] Add volume mount to
 KubernetesExecutorConfig (#3855)

Added volumes and volume_mounts to the KubernetesExecutorConfig so
`volumes` or `secrets` can be mount to worker pod.
---
 ... => example_kubernetes_executor_config.py} | 34 ++++++++++++++++++-
 .../contrib/executors/kubernetes_executor.py  | 13 +++++--
 .../kubernetes/worker_configuration.py        |  2 ++
 .../minikube/test_kubernetes_executor.py      |  4 +--
 4 files changed, 47 insertions(+), 6 deletions(-)
 rename airflow/contrib/example_dags/{example_kubernetes_annotation.py => example_kubernetes_executor_config.py} (61%)

diff --git a/airflow/contrib/example_dags/example_kubernetes_annotation.py b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
similarity index 61%
rename from airflow/contrib/example_dags/example_kubernetes_annotation.py
rename to airflow/contrib/example_dags/example_kubernetes_executor_config.py
index 058baf69901f7..3aa70f862b4d4 100644
--- a/airflow/contrib/example_dags/example_kubernetes_annotation.py
+++ b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
@@ -20,6 +20,7 @@
 import airflow
 from airflow.operators.python_operator import PythonOperator
 from airflow.models import DAG
+import os
 
 args = {
     'owner': 'airflow',
@@ -27,7 +28,7 @@
 }
 
 dag = DAG(
-    dag_id='example_kubernetes_annotation', default_args=args,
+    dag_id='example_kubernetes_executor_config', default_args=args,
     schedule_interval=None
 )
 
@@ -36,6 +37,14 @@ def print_stuff():
     print("annotated!")
 
 
+def test_volume_mount():
+    with open('/foo/volume_mount_test.txt', 'w') as foo:
+        foo.write('Hello')
+
+    rc = os.system("cat /foo/volume_mount_test.txt")
+    assert rc == 0
+
+
 # You can use annotations on your kubernetes pods!
 start_task = PythonOperator(
     task_id="start_task", python_callable=print_stuff, dag=dag,
@@ -45,3 +54,26 @@ def print_stuff():
         }
     }
 )
+
+# You can mount volume or secret to the worker pod
+second_task = PythonOperator(
+    task_id="four_task", python_callable=test_volume_mount, dag=dag,
+    executor_config={
+        "KubernetesExecutor": {
+            "volumes": [
+                {
+                    "name": "test-volume",
+                    "hostPath": {"path": "/tmp/"},
+                },
+            ],
+            "volume_mounts": [
+                {
+                    "mountPath": "/foo/",
+                    "name": "test-volume",
+                },
+            ]
+        }
+    }
+)
+
+start_task.set_downstream(second_task)
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 9769dc3c90332..0798a7b967d22 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -40,7 +40,7 @@ class KubernetesExecutorConfig:
     def __init__(self, image=None, image_pull_policy=None, request_memory=None,
                  request_cpu=None, limit_memory=None, limit_cpu=None,
                  gcp_service_account_key=None, node_selectors=None, affinity=None,
-                 annotations=None):
+                 annotations=None, volumes=None, volume_mounts=None):
         self.image = image
         self.image_pull_policy = image_pull_policy
         self.request_memory = request_memory
@@ -51,15 +51,18 @@ def __init__(self, image=None, image_pull_policy=None, request_memory=None,
         self.node_selectors = node_selectors
         self.affinity = affinity
         self.annotations = annotations
+        self.volumes = volumes
+        self.volume_mounts = volume_mounts
 
     def __repr__(self):
         return "{}(image={}, image_pull_policy={}, request_memory={}, request_cpu={}, " \
                "limit_memory={}, limit_cpu={}, gcp_service_account_key={}, " \
-               "node_selectors={}, affinity={}, annotations={})" \
+               "node_selectors={}, affinity={}, annotations={}, volumes={}, " \
+               "volume_mounts={})" \
             .format(KubernetesExecutorConfig.__name__, self.image, self.image_pull_policy,
                     self.request_memory, self.request_cpu, self.limit_memory,
                     self.limit_cpu, self.gcp_service_account_key, self.node_selectors,
-                    self.affinity, self.annotations)
+                    self.affinity, self.annotations, self.volumes, self.volume_mounts)
 
     @staticmethod
     def from_dict(obj):
@@ -83,6 +86,8 @@ def from_dict(obj):
             node_selectors=namespaced.get('node_selectors', None),
             affinity=namespaced.get('affinity', None),
             annotations=namespaced.get('annotations', {}),
+            volumes=namespaced.get('volumes', []),
+            volume_mounts=namespaced.get('volume_mounts', []),
         )
 
     def as_dict(self):
@@ -97,6 +102,8 @@ def as_dict(self):
             'node_selectors': self.node_selectors,
             'affinity': self.affinity,
             'annotations': self.annotations,
+            'volumes': self.volumes,
+            'volume_mounts': self.volume_mounts,
         }
 
 
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index dd620ba66ecc4..9d206e62cfe9a 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -189,6 +189,8 @@ def _construct_volume(name, claim):
     def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_date,
                  airflow_command, kube_executor_config):
         volumes, volume_mounts = self.init_volumes_and_mounts()
+        volumes += kube_executor_config.volumes
+        volume_mounts += kube_executor_config.volume_mounts
         worker_init_container_spec = self._get_init_containers(
             copy.deepcopy(volume_mounts))
         resources = Resources(
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index 45d4124d07973..a8db7e12b7554 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -150,7 +150,7 @@ def start_dag(self, dag_id, host):
 
     def test_integration_run_dag(self):
         host = get_minikube_host()
-        dag_id = 'example_kubernetes_annotation'
+        dag_id = 'example_kubernetes_executor_config'
 
         result_json = self.start_dag(dag_id=dag_id, host=host)
 
@@ -173,7 +173,7 @@ def test_integration_run_dag(self):
 
     def test_integration_run_dag_with_scheduler_failure(self):
         host = get_minikube_host()
-        dag_id = 'example_kubernetes_annotation'
+        dag_id = 'example_kubernetes_executor_config'
 
         result_json = self.start_dag(dag_id=dag_id, host=host)
 

From 63bf106e18be127f447ad9a35efa0dbc8756a042 Mon Sep 17 00:00:00 2001
From: Kevin Pullin <kevin.pullin@gmail.com>
Date: Sun, 16 Dec 2018 23:05:26 -0800
Subject: [PATCH 316/808] [AIRFLOW-2770] Read `dags_in_image` config value as a
 boolean (#4319)

* Read `dags_in_image` config value as a boolean

This PR is a minor fix for #3683

The dags_in_image config value is read as a string. However, the existing code expects this to be a boolean.

For example, in worker_configuration.py there is the statement: if not self.kube_config.dags_in_image:

Since the value is a non-empty string ('False') and not a boolean, this evaluates to true (since non-empty strings are truthy)
and skips the logic to add the dags_volume_claim volume mount.

This results in the CI tests failing because the dag volume is missing in the k8s pod definition.

This PR reads the dags_in_image using the conf.getboolean to fix this error.

Rebased on 457ad83e4eb02b7348e5ce00292ca9bd27032651, before the previous
dags_in_image commit was reverted.

* Revert "Revert  [AIRFLOW-2770] [AIRFLOW-3505] (#4318)"

This reverts commit 77c368fd228fe5edfdb3304ed4cb000a50667010.
---
 airflow/config_templates/default_airflow.cfg  |  4 ++
 .../contrib/executors/kubernetes_executor.py  | 10 +++-
 .../kubernetes/worker_configuration.py        | 47 +++++++++-------
 scripts/ci/kubernetes/kube/configmaps.yaml    |  1 +
 .../executors/test_kubernetes_executor.py     | 56 +++++++++++++++++++
 5 files changed, 95 insertions(+), 23 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index dd43b980aaa6c..384ff9df31f43 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -583,6 +583,10 @@ namespace = default
 # The name of the Kubernetes ConfigMap Containing the Airflow Configuration (this file)
 airflow_configmap =
 
+# For docker image already contains DAGs, this is set to `True`, and the worker will search for dags in dags_folder,
+# otherwise use git sync or dags volume claim to mount DAGs
+dags_in_image = False
+
 # For either git sync or volume mounted DAGs, the worker will look in this subpath for DAGs
 dags_volume_subpath =
 
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 0798a7b967d22..dd9cd3ec53b15 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -137,6 +137,10 @@ def __init__(self):
             self.kubernetes_section, 'worker_service_account_name')
         self.image_pull_secrets = conf.get(self.kubernetes_section, 'image_pull_secrets')
 
+        # NOTE: user can build the dags into the docker image directly,
+        # this will set to True if so
+        self.dags_in_image = conf.getboolean(self.kubernetes_section, 'dags_in_image')
+
         # NOTE: `git_repo` and `git_branch` must be specified together as a pair
         # The http URL of the git repository to clone from
         self.git_repo = conf.get(self.kubernetes_section, 'git_repo')
@@ -204,10 +208,12 @@ def __init__(self):
         self._validate()
 
     def _validate(self):
-        if not self.dags_volume_claim and (not self.git_repo or not self.git_branch):
+        if not self.dags_volume_claim and not self.dags_in_image \
+                and (not self.git_repo or not self.git_branch):
             raise AirflowConfigException(
                 'In kubernetes mode the following must be set in the `kubernetes` '
-                'config section: `dags_volume_claim` or `git_repo and git_branch`')
+                'config section: `dags_volume_claim` or `git_repo and git_branch` '
+                'or `dags_in_image`')
 
 
 class KubernetesJobWatcher(multiprocessing.Process, LoggingMixin, object):
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 9d206e62cfe9a..d83be81c1f704 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -38,7 +38,7 @@ def __init__(self, kube_config):
     def _get_init_containers(self, volume_mounts):
         """When using git to retrieve the DAGs, use the GitSync Init Container"""
         # If we're using volume claims to mount the dags, no init container is needed
-        if self.kube_config.dags_volume_claim:
+        if self.kube_config.dags_volume_claim or self.kube_config.dags_in_image:
             return []
 
         # Otherwise, define a git-sync init container
@@ -128,32 +128,19 @@ def _construct_volume(name, claim):
             return volume
 
         volumes = [
-            _construct_volume(
-                dags_volume_name,
-                self.kube_config.dags_volume_claim
-            ),
             _construct_volume(
                 logs_volume_name,
                 self.kube_config.logs_volume_claim
             )
         ]
 
-        dag_volume_mount_path = ""
-
-        if self.kube_config.dags_volume_claim:
-            dag_volume_mount_path = self.worker_airflow_dags
-        else:
-            dag_volume_mount_path = os.path.join(
-                self.worker_airflow_dags,
-                self.kube_config.git_subpath
+        if not self.kube_config.dags_in_image:
+            volumes.append(
+                _construct_volume(
+                    dags_volume_name,
+                    self.kube_config.dags_volume_claim
+                )
             )
-        dags_volume_mount = {
-            'name': dags_volume_name,
-            'mountPath': dag_volume_mount_path,
-            'readOnly': True,
-        }
-        if self.kube_config.dags_volume_subpath:
-            dags_volume_mount['subPath'] = self.kube_config.dags_volume_subpath
 
         logs_volume_mount = {
             'name': logs_volume_name,
@@ -163,10 +150,28 @@ def _construct_volume(name, claim):
             logs_volume_mount['subPath'] = self.kube_config.logs_volume_subpath
 
         volume_mounts = [
-            dags_volume_mount,
             logs_volume_mount
         ]
 
+        if not self.kube_config.dags_in_image:
+            dag_volume_mount_path = ""
+
+            if self.kube_config.dags_volume_claim:
+                dag_volume_mount_path = self.worker_airflow_dags
+            else:
+                dag_volume_mount_path = os.path.join(
+                    self.worker_airflow_dags,
+                    self.kube_config.git_subpath
+                )
+            dags_volume_mount = {
+                'name': dags_volume_name,
+                'mountPath': dag_volume_mount_path,
+                'readOnly': True,
+            }
+            if self.kube_config.dags_volume_subpath:
+                dags_volume_mount['subPath'] = self.kube_config.dags_volume_subpath
+            volume_mounts.append(dags_volume_mount)
+
         # Mount the airflow.cfg file via a configmap the user has specified
         if self.kube_config.airflow_configmap:
             config_volume_name = 'airflow-config'
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index 4c86bcaa6915f..d10cbdc728a9f 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -178,6 +178,7 @@ data:
     worker_container_image_pull_policy = IfNotPresent
     worker_dags_folder = /tmp/dags
     delete_worker_pods = True
+    dags_in_image = False
     git_repo = https://github.com/apache/incubator-airflow.git
     git_branch = master
     git_subpath = airflow/example_dags/
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index c203e18d5cf8e..f93a9d81e142d 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -105,6 +105,7 @@ def setUp(self):
         self.kube_config.airflow_dags = 'logs'
         self.kube_config.dags_volume_subpath = None
         self.kube_config.logs_volume_subpath = None
+        self.kube_config.dags_in_image = False
 
     def test_worker_configuration_no_subpaths(self):
         worker_config = WorkerConfiguration(self.kube_config)
@@ -151,6 +152,61 @@ def test_worker_environment_when_dags_folder_specified(self):
 
         self.assertEqual(dags_folder, env['AIRFLOW__CORE__DAGS_FOLDER'])
 
+    def test_worker_pvc_dags(self):
+        # Tests persistence volume config created when `dags_volume_claim` is set
+        self.kube_config.dags_volume_claim = 'airflow-dags'
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+
+        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+
+        self.assertEqual('airflow-dags', dag_volume[0]['persistentVolumeClaim']['claimName'])
+        self.assertEqual(1, len(dag_volume_mount))
+
+    def test_worker_git_dags(self):
+        # Tests persistence volume config created when `git_repo` is set
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_folder = '/usr/local/airflow/dags'
+        self.kube_config.worker_dags_folder = '/usr/local/airflow/dags'
+
+        self.kube_config.git_sync_container_repository = 'gcr.io/google-containers/git-sync-amd64'
+        self.kube_config.git_sync_container_tag = 'v2.0.5'
+        self.kube_config.git_sync_container = 'gcr.io/google-containers/git-sync-amd64:v2.0.5'
+        self.kube_config.git_sync_init_container_name = 'git-sync-clone'
+        self.kube_config.git_subpath = ''
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+
+        init_container = worker_config._get_init_containers(volume_mounts)[0]
+
+        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+
+        self.assertTrue('emptyDir' in dag_volume[0])
+        self.assertEqual('/usr/local/airflow/dags/', dag_volume_mount[0]['mountPath'])
+
+        self.assertEqual('git-sync-clone', init_container['name'])
+        self.assertEqual('gcr.io/google-containers/git-sync-amd64:v2.0.5', init_container['image'])
+
+    def test_worker_container_dags(self):
+        # Tests that the 'airflow-dags' persistence volume is NOT created when `dags_in_image` is set
+        self.kube_config.dags_in_image = True
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+
+        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+
+        init_containers = worker_config._get_init_containers(volume_mounts)
+
+        self.assertEqual(0, len(dag_volume))
+        self.assertEqual(0, len(dag_volume_mount))
+        self.assertEqual(0, len(init_containers))
+
 
 if __name__ == '__main__':
     unittest.main()

From 6c5066493515bd777b5ad8ffbc81c9bd44ef9a0e Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Mon, 31 Dec 2018 12:50:01 +0000
Subject: [PATCH 317/808] Fix Flake8 issues

---
 .../operators/test_bigquery_operator.py       | 22 +++++++++----------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 0e52beea02657..9e4d315945ea2 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -42,18 +42,6 @@
 TEST_SOURCE_FORMAT = 'CSV'
 
 
-class BigQueryOperatorTest(unittest.TestCase):
-    def test_bql_deprecation_warning(self):
-        with warnings.catch_warnings(record=True) as w:
-            BigQueryOperator(
-                task_id='test_deprecation_warning_for_bql',
-                bql='select * from test_table'
-            )
-        self.assertIn(
-            'Deprecated parameter `bql`',
-            w[0].message.args[0])
-
-
 class BigQueryCreateEmptyTableOperatorTest(unittest.TestCase):
 
     @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
@@ -160,6 +148,16 @@ def test_execute(self, mock_hook):
 
 
 class BigQueryOperatorTest(unittest.TestCase):
+    def test_bql_deprecation_warning(self):
+        with warnings.catch_warnings(record=True) as w:
+            BigQueryOperator(
+                task_id='test_deprecation_warning_for_bql',
+                bql='select * from test_table'
+            )
+        self.assertIn(
+            'Deprecated parameter `bql`',
+            w[0].message.args[0])
+
     @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
     def test_execute(self, mock_hook):
         operator = BigQueryOperator(

From f64a4c8e68099c3f844848c227c0e91b1d283816 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Thu, 3 Jan 2019 09:35:35 +0000
Subject: [PATCH 318/808] [AIRFLOW-3560] Add DayOfWeek Sensor (#4363)

* [AIRFLOW-3560] Add WeekEnd & DayOfWeek Sensors

* Change to using Enum

* Fix Docstring

* Refactor into a Single Sensor
---
 airflow/contrib/sensors/weekday_sensor.py    | 103 ++++++++++++
 airflow/contrib/utils/weekday.py             |  51 ++++++
 docs/code.rst                                |   1 +
 tests/contrib/sensors/test_weekday_sensor.py | 163 +++++++++++++++++++
 tests/contrib/utils/test_weekday.py          |  42 +++++
 5 files changed, 360 insertions(+)
 create mode 100644 airflow/contrib/sensors/weekday_sensor.py
 create mode 100644 airflow/contrib/utils/weekday.py
 create mode 100644 tests/contrib/sensors/test_weekday_sensor.py
 create mode 100644 tests/contrib/utils/test_weekday.py

diff --git a/airflow/contrib/sensors/weekday_sensor.py b/airflow/contrib/sensors/weekday_sensor.py
new file mode 100644
index 0000000000000..4cff263f38325
--- /dev/null
+++ b/airflow/contrib/sensors/weekday_sensor.py
@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import six
+from airflow.contrib.utils.weekday import WeekDay
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils import timezone
+from airflow.utils.decorators import apply_defaults
+
+
+class DayOfWeekSensor(BaseSensorOperator):
+    """
+    Waits until the first specified day of the week. For example, if the execution
+    day of the task is '2018-12-22' (Saturday) and you pass 'FRIDAY', the task will wait
+    until next Friday.
+
+    **Example** (with single day): ::
+
+        weekend_check = DayOfWeekSensor(
+            task_id='weekend_check',
+            week_day='Saturday',
+            use_task_execution_day=True,
+            dag=dag)
+
+    **Example** (with multiple day using set): ::
+
+        weekend_check = DayOfWeekSensor(
+            task_id='weekend_check',
+            week_day={'Saturday', 'Sunday'},
+            use_task_execution_day=True,
+            dag=dag)
+
+    **Example** (with :class:`~airflow.contrib.utils.weekday.WeekDay` enum): ::
+
+        # import WeekDay Enum
+        from airflow.contrib.utils.weekday import WeekDay
+
+        weekend_check = DayOfWeekSensor(
+            task_id='weekend_check',
+            week_day={WeekDay.Saturday, WeekDay.Sunday},
+            use_task_execution_day=True,
+            dag=dag)
+
+    :param week_day: Day of the week to check (full name). Optionally, a set
+        of days can also be provided using a set.
+        Example values:
+            * ``"MONDAY"``,
+            * ``{"Saturday", "Sunday"}``
+            * ``{WeekDay.TUESDAY}``
+            * ``{WeekDay.Saturday, WeekDay.Sunday}``
+    :type week_day: set or str or WeekDay
+    :param use_task_execution_day: If ``True``, uses task's execution day to compare
+        with week_day. Execution Date is Useful for backfilling.
+        If ``False``, uses system's day of the week. Useful when you
+        don't want to run anything on weekdays on the system.
+    :type use_task_execution_day: bool
+    """
+
+    @apply_defaults
+    def __init__(self, week_day,
+                 use_task_execution_day=False,
+                 *args, **kwargs):
+        super(DayOfWeekSensor, self).__init__(*args, **kwargs)
+        self.week_day = week_day
+        self.use_task_execution_day = use_task_execution_day
+        if isinstance(self.week_day, six.string_types):
+            self._week_day_num = {WeekDay.get_weekday_number(week_day_str=self.week_day)}
+        elif isinstance(self.week_day, WeekDay):
+            self._week_day_num = {self.week_day}
+        elif isinstance(self.week_day, set):
+            if all(isinstance(day, six.string_types) for day in self.week_day):
+                self._week_day_num = {WeekDay.get_weekday_number(day) for day in week_day}
+            elif all(isinstance(day, WeekDay) for day in self.week_day):
+                self._week_day_num = self.week_day
+        else:
+            raise TypeError(
+                'Unsupported Type for week_day parameter: {}. It should be one of str'
+                ', set or Weekday enum type'.format(type(week_day)))
+
+    def poke(self, context):
+        self.log.info('Poking until weekday is in %s, Today is %s',
+                      self.week_day,
+                      WeekDay(timezone.utcnow().isoweekday()).name)
+        if self.use_task_execution_day:
+            return context['execution_date'].isoweekday() in self._week_day_num
+        else:
+            return timezone.utcnow().isoweekday() in self._week_day_num
diff --git a/airflow/contrib/utils/weekday.py b/airflow/contrib/utils/weekday.py
new file mode 100644
index 0000000000000..1fe4ad3a59011
--- /dev/null
+++ b/airflow/contrib/utils/weekday.py
@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import enum
+
+
+@enum.unique
+class WeekDay(enum.IntEnum):
+    """
+    Python Enum containing Days of the Week
+    """
+    MONDAY = 1
+    TUESDAY = 2
+    WEDNESDAY = 3
+    THURSDAY = 4
+    FRIDAY = 5
+    SATURDAY = 6
+    SUNDAY = 7
+
+    @classmethod
+    def get_weekday_number(cls, week_day_str):
+        """
+        Return the ISO Week Day Number for a Week Day
+
+        :param week_day_str: Full Name of the Week Day. Example: "Sunday"
+        :type week_day_str: str
+        :return: ISO Week Day Number corresponding to the provided Weedkay
+        """
+        sanitized_week_day_str = week_day_str.upper()
+
+        if sanitized_week_day_str not in cls.__members__:
+            raise AttributeError(
+                'Invalid Week Day passed: "{}"'.format(week_day_str)
+            )
+
+        return cls[sanitized_week_day_str]
diff --git a/docs/code.rst b/docs/code.rst
index aaa4eec5f7213..6f82166b10ff9 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -260,6 +260,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.sagemaker_tuning_sensor.SageMakerTuningSensor
 .. autoclass:: airflow.contrib.sensors.sftp_sensor.SFTPSensor
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
+.. autoclass:: airflow.contrib.sensors.weekday_sensor.DayOfWeekSensor
 
 .. _macros:
 
diff --git a/tests/contrib/sensors/test_weekday_sensor.py b/tests/contrib/sensors/test_weekday_sensor.py
new file mode 100644
index 0000000000000..55a4c4da4bf7d
--- /dev/null
+++ b/tests/contrib/sensors/test_weekday_sensor.py
@@ -0,0 +1,163 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import unittest
+from airflow import DAG, configuration, models
+from airflow.contrib.sensors.weekday_sensor import DayOfWeekSensor
+from airflow.contrib.utils.weekday import WeekDay
+from airflow.exceptions import AirflowSensorTimeout
+from airflow.models import DagBag
+from airflow.settings import Session
+from airflow.utils.timezone import datetime
+
+DEFAULT_DATE = datetime(2018, 12, 10)
+WEEKDAY_DATE = datetime(2018, 12, 20)
+WEEKEND_DATE = datetime(2018, 12, 22)
+TEST_DAG_ID = 'weekday_sensor_dag'
+DEV_NULL = '/dev/null'
+
+
+class DayOfWeekSensorTests(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        self.dagbag = DagBag(
+            dag_folder=DEV_NULL,
+            include_examples=True
+        )
+        self.args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        dag = DAG(TEST_DAG_ID, default_args=self.args)
+        self.dag = dag
+
+    def tearDown(self):
+        session = Session()
+        session.query(models.TaskInstance).filter_by(
+            dag_id=TEST_DAG_ID).delete()
+        session.query(models.TaskFail).filter_by(
+            dag_id=TEST_DAG_ID).delete()
+        session.commit()
+        session.close()
+
+    def test_weekday_sensor_true(self):
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day='Thursday',
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+
+    def test_weekday_sensor_false(self):
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_false',
+            poke_interval=1,
+            timeout=2,
+            week_day='Tuesday',
+            use_task_execution_day=True,
+            dag=self.dag)
+        with self.assertRaises(AirflowSensorTimeout):
+            t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+
+    def test_invalid_weekday_number(self):
+        invalid_week_day = 'Thsday'
+        with self.assertRaisesRegexp(AttributeError,
+                                     'Invalid Week Day passed: "{}"'.format(
+                                         invalid_week_day)):
+            DayOfWeekSensor(
+                task_id='weekday_sensor_invalid_weekday_num',
+                week_day=invalid_week_day,
+                use_task_execution_day=True,
+                dag=self.dag)
+
+    def test_weekday_sensor_with_enum(self):
+        week_day = WeekDay.THURSDAY
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day=WeekDay.THURSDAY,
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+        self.assertEqual(t.week_day, week_day)
+
+    def test_weekday_sensor_with_enum_set(self):
+        week_day = {WeekDay.THURSDAY}
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day=week_day,
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+        self.assertEqual(t.week_day, week_day)
+
+    def test_weekday_sensor_with_enum_set_2_items(self):
+        week_day = {WeekDay.THURSDAY, WeekDay.FRIDAY}
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day=week_day,
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+        self.assertEqual(t.week_day, week_day)
+
+    def test_weekday_sensor_with_string_set(self):
+        week_day = {'Thursday'}
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day=week_day,
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+        self.assertEqual(t.week_day, week_day)
+
+    def test_weekday_sensor_with_string_set_2_items(self):
+        week_day = {'Thursday', 'Friday'}
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_true',
+            week_day=week_day,
+            use_task_execution_day=True,
+            dag=self.dag)
+        t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
+        self.assertEqual(t.week_day, week_day)
+
+    def test_weekday_sensor_with_invalid_type(self):
+        invalid_week_day = ['Thsday']
+        with self.assertRaisesRegexp(TypeError,
+                                     'Unsupported Type for week_day parameter:'
+                                     ' {}. It should be one of str, set or '
+                                     'Weekday enum type'.format(type(invalid_week_day))
+                                     ):
+            DayOfWeekSensor(
+                task_id='weekday_sensor_check_true',
+                week_day=invalid_week_day,
+                use_task_execution_day=True,
+                dag=self.dag)
+
+    def test_weekday_sensor_timeout_with_set(self):
+        t = DayOfWeekSensor(
+            task_id='weekday_sensor_check_false',
+            poke_interval=1,
+            timeout=2,
+            week_day={WeekDay.MONDAY, WeekDay.TUESDAY},
+            use_task_execution_day=True,
+            dag=self.dag)
+        with self.assertRaises(AirflowSensorTimeout):
+            t.run(start_date=WEEKDAY_DATE, end_date=WEEKDAY_DATE, ignore_ti_state=True)
diff --git a/tests/contrib/utils/test_weekday.py b/tests/contrib/utils/test_weekday.py
new file mode 100644
index 0000000000000..961652a4ea8e6
--- /dev/null
+++ b/tests/contrib/utils/test_weekday.py
@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from enum import Enum
+
+from airflow.contrib.utils.weekday import WeekDay
+
+
+class WeekDayTest(unittest.TestCase):
+    def test_weekday_enum_length(self):
+        self.assertEqual(len(WeekDay), 7)
+
+    def test_weekday_name_value(self):
+        weekdays = "MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY SATURDAY SUNDAY"
+        weekdays = weekdays.split()
+        for i, weekday in enumerate(weekdays, start=1):
+            e = WeekDay(i)
+            self.assertEqual(e, i)
+            self.assertEqual(int(e), i)
+            self.assertEqual(e.name, weekday)
+            self.assertTrue(e in WeekDay)
+            self.assertTrue(0 < e < 8)
+            self.assertTrue(type(e) is WeekDay)
+            self.assertTrue(isinstance(e, int))
+            self.assertTrue(isinstance(e, Enum))

From 0eaed4bd0f796cb082c620ec42be931b8419d20d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Thu, 3 Jan 2019 10:51:46 +0000
Subject: [PATCH 319/808] [AIRFLOW-XXX] Fix WeekDay Sensor Example (#4431)

---
 airflow/contrib/sensors/weekday_sensor.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/sensors/weekday_sensor.py b/airflow/contrib/sensors/weekday_sensor.py
index 4cff263f38325..1a7a702aef97c 100644
--- a/airflow/contrib/sensors/weekday_sensor.py
+++ b/airflow/contrib/sensors/weekday_sensor.py
@@ -53,7 +53,7 @@ class DayOfWeekSensor(BaseSensorOperator):
 
         weekend_check = DayOfWeekSensor(
             task_id='weekend_check',
-            week_day={WeekDay.Saturday, WeekDay.Sunday},
+            week_day={WeekDay.SATURDAY, WeekDay.SUNDAY},
             use_task_execution_day=True,
             dag=dag)
 
@@ -63,7 +63,7 @@ class DayOfWeekSensor(BaseSensorOperator):
             * ``"MONDAY"``,
             * ``{"Saturday", "Sunday"}``
             * ``{WeekDay.TUESDAY}``
-            * ``{WeekDay.Saturday, WeekDay.Sunday}``
+            * ``{WeekDay.SATURDAY, WeekDay.SUNDAY}``
     :type week_day: set or str or WeekDay
     :param use_task_execution_day: If ``True``, uses task's execution day to compare
         with week_day. Execution Date is Useful for backfilling.

From 15d9f2e2d358a46de6451f5c4afb734a3f9aeceb Mon Sep 17 00:00:00 2001
From: Steve Jacobs <brokenjacobs@gmail.com>
Date: Wed, 2 Jan 2019 00:57:08 -0700
Subject: [PATCH 320/808] [AIRFLOW-1921] Add support for https and user auth
 (#2879)

---
 airflow/hooks/presto_hook.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/airflow/hooks/presto_hook.py b/airflow/hooks/presto_hook.py
index c7ebd8f5dcb70..20c918c1a4f49 100644
--- a/airflow/hooks/presto_hook.py
+++ b/airflow/hooks/presto_hook.py
@@ -21,6 +21,7 @@
 
 from pyhive import presto
 from pyhive.exc import DatabaseError
+from requests.auth import HTTPBasicAuth
 
 from airflow.hooks.dbapi_hook import DbApiHook
 
@@ -45,11 +46,17 @@ class PrestoHook(DbApiHook):
     def get_conn(self):
         """Returns a connection object"""
         db = self.get_connection(self.presto_conn_id)
+        reqkwargs = None
+        if db.password is not None:
+            reqkwargs = {'auth': HTTPBasicAuth(db.login, db.password)}
         return presto.connect(
             host=db.host,
             port=db.port,
             username=db.login,
+            source=db.extra_dejson.get('source', 'airflow'),
+            protocol=db.extra_dejson.get('protocol', 'http'),
             catalog=db.extra_dejson.get('catalog', 'hive'),
+            requests_kwargs=reqkwargs,
             schema=db.schema)
 
     @staticmethod

From 9d0c9c385e0a1a1f66fa1e0481048bd590e91b8e Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Thu, 3 Jan 2019 20:50:09 +0000
Subject: [PATCH 321/808] [AIRFLOW-XXX] Add license to Contrib Example DAG Init
 file

---
 airflow/contrib/example_dags/__init__.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/airflow/contrib/example_dags/__init__.py b/airflow/contrib/example_dags/__init__.py
index e69de29bb2d1d..114d189da14ab 100644
--- a/airflow/contrib/example_dags/__init__.py
+++ b/airflow/contrib/example_dags/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.

From 36a62da96950569fdca7e3c2f5006eb318ad14e2 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 28 Sep 2018 11:51:04 +0100
Subject: [PATCH 322/808] [AIRFLOW-XXX] Fix Kubernetes CI (#3957)

---
 scripts/ci/kubernetes/docker/airflow-test-env-init.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/scripts/ci/kubernetes/docker/airflow-test-env-init.sh b/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
index aa86da72dfa70..59d830af63c59 100755
--- a/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
+++ b/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
@@ -19,6 +19,7 @@
 
 cd /usr/local/lib/python2.7/dist-packages/airflow && \
 cp -R example_dags/* /root/airflow/dags/ && \
+cp -R contrib/example_dags/example_kubernetes_*.py /root/airflow/dags/ && \
 airflow initdb && \
 alembic upgrade heads && \
 (airflow create_user -u airflow -l airflow -f jon -e airflow@apache.org -r Admin -p airflow || true) && \

From def7a9fc136b9f567e3c8ca436daab6e6430cb6d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 2 Jan 2019 12:36:23 +0000
Subject: [PATCH 323/808] [AIRFLOW-3578] Fix Type Error for BigQueryOperator
 (#4384)

---
 airflow/contrib/hooks/bigquery_hook.py        |  5 +--
 .../operators/test_bigquery_operator.py       | 32 +++++++++++++++++++
 2 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 05db8f4e987f3..9eb940c905fdc 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -23,6 +23,7 @@
 """
 
 import time
+import six
 from builtins import range
 from copy import deepcopy
 from six import iteritems
@@ -671,8 +672,8 @@ def run_query(self,
             cluster_fields = {'fields': cluster_fields}
 
         query_param_list = [
-            (sql, 'query', None, str),
-            (priority, 'priority', 'INTERACTIVE', str),
+            (sql, 'query', None, six.string_types),
+            (priority, 'priority', 'INTERACTIVE', six.string_types),
             (use_legacy_sql, 'useLegacySql', self.use_legacy_sql, bool),
             (query_params, 'queryParameters', None, dict),
             (udf_config, 'userDefinedFunctionResources', None, list),
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 9e4d315945ea2..44ed2e3bcf7e0 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -19,11 +19,18 @@
 
 import unittest
 import warnings
+from datetime import datetime
+
+import six
+
+from airflow import configuration, models
+from airflow.models import TaskInstance, DAG
 
 from airflow.contrib.operators.bigquery_operator import \
     BigQueryCreateExternalTableOperator, BigQueryCreateEmptyTableOperator, \
     BigQueryDeleteDatasetOperator, BigQueryCreateEmptyDatasetOperator, \
     BigQueryOperator
+from airflow.settings import Session
 
 try:
     from unittest import mock
@@ -40,6 +47,8 @@
 TEST_GCS_BUCKET = 'test-bucket'
 TEST_GCS_DATA = ['dir1/*.csv']
 TEST_SOURCE_FORMAT = 'CSV'
+DEFAULT_DATE = datetime(2015, 1, 1)
+TEST_DAG_ID = 'test-bigquery-operators'
 
 
 class BigQueryCreateEmptyTableOperatorTest(unittest.TestCase):
@@ -158,6 +167,22 @@ def test_bql_deprecation_warning(self):
             'Deprecated parameter `bql`',
             w[0].message.args[0])
 
+    def setUp(self):
+        configuration.conf.load_test_config()
+        self.dagbag = models.DagBag(
+            dag_folder='/dev/null', include_examples=True)
+        self.args = {'owner': 'airflow', 'start_date': DEFAULT_DATE}
+        self.dag = DAG(TEST_DAG_ID, default_args=self.args)
+
+    def tearDown(self):
+        session = Session()
+        session.query(models.TaskInstance).filter_by(
+            dag_id=TEST_DAG_ID).delete()
+        session.query(models.TaskFail).filter_by(
+            dag_id=TEST_DAG_ID).delete()
+        session.commit()
+        session.close()
+
     @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
     def test_execute(self, mock_hook):
         operator = BigQueryOperator(
@@ -208,9 +233,11 @@ def test_execute(self, mock_hook):
 
     @mock.patch('airflow.contrib.operators.bigquery_operator.BigQueryHook')
     def test_bigquery_operator_defaults(self, mock_hook):
+
         operator = BigQueryOperator(
             task_id=TASK_ID,
             sql='Select * from test_table',
+            dag=self.dag, default_args=self.args
         )
 
         operator.execute(None)
@@ -236,3 +263,8 @@ def test_bigquery_operator_defaults(self, mock_hook):
                 api_resource_configs=None,
                 cluster_fields=None,
             )
+
+        self.assertTrue(isinstance(operator.sql, six.string_types))
+        ti = TaskInstance(task=operator, execution_date=DEFAULT_DATE)
+        ti.render_templates()
+        self.assertTrue(isinstance(ti.task.sql, six.string_types))

From f47d41d720ac43ca37bc6bfd57057b9fd120e465 Mon Sep 17 00:00:00 2001
From: Chinh Nguyen <chinhngt@gmail.com>
Date: Thu, 3 Jan 2019 14:39:24 -0800
Subject: [PATCH 324/808] [AIRFLOW-3583] Fix AirflowException import (#4389)

Looks like the class path changed and broke wasb_hook
---
 airflow/contrib/hooks/wasb_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/wasb_hook.py b/airflow/contrib/hooks/wasb_hook.py
index 4d4d123b40af6..19ee442f91b1d 100644
--- a/airflow/contrib/hooks/wasb_hook.py
+++ b/airflow/contrib/hooks/wasb_hook.py
@@ -18,7 +18,7 @@
 # under the License.
 #
 
-from airflow import AirflowException
+from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 
 from azure.storage.blob import BlockBlobService

From 625c7212d124330dcbfe29ad996fa1fda3bd8231 Mon Sep 17 00:00:00 2001
From: Conrad Lee <conradlee@gmail.com>
Date: Fri, 4 Jan 2019 00:18:05 +0100
Subject: [PATCH 325/808] [AIRFLOW-3316] For gcs_to_bq: add missing init of
 schema_fields var (#4430)

---
 airflow/contrib/operators/gcs_to_bq.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 11c2c83bc174b..ee762d6527eac 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -208,6 +208,8 @@ def execute(self, context):
             elif self.schema_object is None and self.autodetect is False:
                 raise ValueError('At least one of `schema_fields`, `schema_object`, '
                                  'or `autodetect` must be passed.')
+            else:
+                schema_fields = None
 
         else:
             schema_fields = self.schema_fields

From ba9b1c2dcb77edc5022eb7b5bb560555aba76e0d Mon Sep 17 00:00:00 2001
From: Dariusz Aniszewski <dariusz@aniszewski.eu>
Date: Fri, 4 Jan 2019 14:50:15 +0100
Subject: [PATCH 326/808] [AIRFLOW-3446] Add Google Cloud BigTable operators
 (#4354)

---
 .../example_gcp_bigtable_operators.py         | 149 +++++
 airflow/contrib/hooks/gcp_bigtable_hook.py    | 231 ++++++++
 .../operators/gcp_bigtable_operator.py        | 424 ++++++++++++++
 docs/howto/operator.rst                       | 130 +++++
 docs/integration.rst                          |  64 +++
 setup.py                                      |   1 +
 .../operators/test_gcp_bigtable_operator.py   | 540 ++++++++++++++++++
 7 files changed, 1539 insertions(+)
 create mode 100644 airflow/contrib/example_dags/example_gcp_bigtable_operators.py
 create mode 100644 airflow/contrib/hooks/gcp_bigtable_hook.py
 create mode 100644 airflow/contrib/operators/gcp_bigtable_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_bigtable_operator.py

diff --git a/airflow/contrib/example_dags/example_gcp_bigtable_operators.py b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
new file mode 100644
index 0000000000000..48c4245cbafbb
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# 'License'); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that creates and performs following operations on Cloud Bigtable:
+- creates an Instance
+- creates a Table
+- updates Cluster
+- waits for Table replication completeness
+- deletes the Table
+- deletes the Instance
+
+This DAG relies on the following environment variables
+* GCP_PROJECT_ID - Google Cloud Platform project
+* CBT_INSTANCE_ID - desired ID of a Cloud Bigtable instance
+* CBT_INSTANCE_DISPLAY_NAME - desired human-readable display name of the Instance
+* CBT_INSTANCE_TYPE - type of the Instance, e.g. 1 for DEVELOPMENT
+    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance
+* CBT_INSTANCE_LABELS - labels to add for the Instance
+* CBT_CLUSTER_ID - desired ID of the main Cluster created for the Instance
+* CBT_CLUSTER_ZONE - zone in which main Cluster will be created. e.g. europe-west1-b
+    See available zones: https://cloud.google.com/bigtable/docs/locations
+* CBT_CLUSTER_NODES - initial amount of nodes of the Cluster
+* CBT_CLUSTER_NODES_UPDATED - amount of nodes for BigtableClusterUpdateOperator
+* CBT_CLUSTER_STORAGE_TYPE - storage for the Cluster, e.g. 1 for SSD
+    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.cluster # noqa: E501
+* CBT_TABLE_ID - desired ID of the Table
+* CBT_POKE_INTERVAL - number of seconds between every attempt of Sensor check
+
+"""
+
+import datetime
+import json
+
+from os import getenv
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_bigtable_operator import BigtableInstanceCreateOperator, \
+    BigtableInstanceDeleteOperator, BigtableClusterUpdateOperator, BigtableTableCreateOperator, \
+    BigtableTableWaitForReplicationSensor, BigtableTableDeleteOperator
+
+# [START howto_operator_gcp_bigtable_args]
+GCP_PROJECT_ID = getenv('GCP_PROJECT_ID', 'example-project')
+CBT_INSTANCE_ID = getenv('CBT_INSTANCE_ID', 'some-instance-id')
+CBT_INSTANCE_DISPLAY_NAME = getenv('CBT_INSTANCE_DISPLAY_NAME', 'Human-readable name')
+CBT_INSTANCE_TYPE = getenv('CBT_INSTANCE_TYPE', '2')
+CBT_INSTANCE_LABELS = getenv('CBT_INSTANCE_LABELS', '{}')
+CBT_CLUSTER_ID = getenv('CBT_CLUSTER_ID', 'some-cluster-id')
+CBT_CLUSTER_ZONE = getenv('CBT_CLUSTER_ZONE', 'europe-west1-b')
+CBT_CLUSTER_NODES = getenv('CBT_CLUSTER_NODES', '3')
+CBT_CLUSTER_NODES_UPDATED = getenv('CBT_CLUSTER_NODES_UPDATED', '5')
+CBT_CLUSTER_STORAGE_TYPE = getenv('CBT_CLUSTER_STORAGE_TYPE', '2')
+CBT_TABLE_ID = getenv('CBT_TABLE_ID', 'some-table-id')
+CBT_POKE_INTERVAL = getenv('CBT_POKE_INTERVAL', '60')
+# [END howto_operator_gcp_bigtable_args]
+
+default_args = {
+    'start_date': airflow.utils.dates.days_ago(1)
+}
+
+with models.DAG(
+    'example_gcp_bigtable_operators',
+    default_args=default_args,
+    schedule_interval=datetime.timedelta(days=1)
+) as dag:
+    # [START howto_operator_gcp_bigtable_instance_create]
+    create_instance_task = BigtableInstanceCreateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        main_cluster_id=CBT_CLUSTER_ID,
+        main_cluster_zone=CBT_CLUSTER_ZONE,
+        instance_display_name=CBT_INSTANCE_DISPLAY_NAME,
+        instance_type=int(CBT_INSTANCE_TYPE),
+        instance_labels=json.loads(CBT_INSTANCE_LABELS),
+        cluster_nodes=int(CBT_CLUSTER_NODES),
+        cluster_storage_type=int(CBT_CLUSTER_STORAGE_TYPE),
+        task_id='create_instance',
+    )
+    # [END howto_operator_gcp_bigtable_instance_create]
+
+    # [START howto_operator_gcp_bigtable_cluster_update]
+    cluster_update_task = BigtableClusterUpdateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        cluster_id=CBT_CLUSTER_ID,
+        nodes=int(CBT_CLUSTER_NODES_UPDATED),
+        task_id='update_cluster',
+    )
+    # [END howto_operator_gcp_bigtable_cluster_update]
+
+    # [START howto_operator_gcp_bigtable_instance_delete]
+    delete_instance_task = BigtableInstanceDeleteOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        task_id='delete_instance',
+    )
+    # [END howto_operator_gcp_bigtable_instance_delete]
+
+    # [START howto_operator_gcp_bigtable_table_create]
+    create_table_task = BigtableTableCreateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        task_id='create_table',
+    )
+    # [END howto_operator_gcp_bigtable_table_create]
+
+    # [START howto_operator_gcp_bigtable_table_wait_for_replication]
+    wait_for_table_replication_task = BigtableTableWaitForReplicationSensor(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        poke_interval=int(CBT_POKE_INTERVAL),
+        task_id='wait_for_table_replication',
+    )
+    # [END howto_operator_gcp_bigtable_table_wait_for_replication]
+
+    # [START howto_operator_gcp_bigtable_table_delete]
+    delete_table_task = BigtableTableDeleteOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        task_id='delete_table',
+    )
+    # [END howto_operator_gcp_bigtable_table_delete]
+
+    wait_for_table_replication_task >> delete_table_task
+    create_instance_task \
+        >> create_table_task \
+        >> cluster_update_task \
+        >> delete_table_task \
+        >> delete_instance_task
diff --git a/airflow/contrib/hooks/gcp_bigtable_hook.py b/airflow/contrib/hooks/gcp_bigtable_hook.py
new file mode 100644
index 0000000000000..5d1b6f01c9aa1
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_bigtable_hook.py
@@ -0,0 +1,231 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from google.cloud.bigtable import Client
+from google.cloud.bigtable.cluster import Cluster
+from google.cloud.bigtable.instance import Instance
+from google.cloud.bigtable.table import Table
+from google.cloud.bigtable_admin_v2 import enums
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+
+class BigtableHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud Bigtable APIs.
+    """
+
+    _client = None
+
+    def __init__(self,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None):
+        super(BigtableHook, self).__init__(gcp_conn_id, delegate_to)
+
+    def get_client(self, project_id):
+        if not self._client:
+            self._client = Client(project=project_id, credentials=self._get_credentials(), admin=True)
+        return self._client
+
+    def get_instance(self, project_id, instance_id):
+        """
+        Retrieves and returns the specified Cloud Bigtable instance if it exists.
+        Otherwise, returns None.
+
+        :param project_id: The ID of the GCP project.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Bigtable instance.
+        :type instance_id: str
+        """
+
+        client = self.get_client(project_id)
+
+        instance = Instance(instance_id, client)
+        if not instance.exists():
+            return None
+        return instance
+
+    def delete_instance(self, project_id, instance_id):
+        """
+        Deletes the specified Cloud Bigtable instance.
+        Raises google.api_core.exceptions.NotFound if the Cloud Bigtable instance does not exist.
+
+        :param project_id: The ID of the GCP project.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Bigtable instance.
+        :type instance_id: str
+        """
+        instance = Instance(instance_id, self.get_client(project_id))
+        instance.delete()
+
+    def create_instance(self,
+                        project_id,
+                        instance_id,
+                        main_cluster_id,
+                        main_cluster_zone,
+                        replica_cluster_id=None,
+                        replica_cluster_zone=None,
+                        instance_display_name=None,
+                        instance_type=enums.Instance.Type.TYPE_UNSPECIFIED,
+                        instance_labels=None,
+                        cluster_nodes=None,
+                        cluster_storage_type=enums.StorageType.STORAGE_TYPE_UNSPECIFIED,
+                        timeout=None):
+        """
+        Creates new instance.
+
+        :type project_id: str
+        :param project_id: The ID of the GCP project.
+        :type instance_id: str
+        :param instance_id: The ID for the new instance.
+        :type main_cluster_id: str
+        :param main_cluster_id: The ID for main cluster for the new instance.
+        :type main_cluster_zone: str
+        :param main_cluster_zone: The zone for main cluster.
+            See https://cloud.google.com/bigtable/docs/locations for more details.
+        :type replica_cluster_id: str
+        :param replica_cluster_id: (optional) The ID for replica cluster for the new instance.
+        :type replica_cluster_zone: str
+        :param replica_cluster_zone: (optional)  The zone for replica cluster.
+        :type instance_type: enums.Instance.Type
+        :param instance_type: (optional) The type of the instance.
+        :type instance_display_name: str
+        :param instance_display_name: (optional) Human-readable name of the instance.
+                Defaults to ``instance_id``.
+        :type instance_labels: dict
+        :param instance_labels: (optional) Dictionary of labels to associate with the instance.
+        :type cluster_nodes: int
+        :param cluster_nodes: (optional) Number of nodes for cluster.
+        :type cluster_storage_type: enums.StorageType
+        :param cluster_storage_type: (optional) The type of storage.
+        :type timeout: int
+        :param timeout: (optional) timeout (in seconds) for instance creation.
+                        If None is not specified, Operator will wait indefinitely.
+        """
+        cluster_storage_type = enums.StorageType(cluster_storage_type)
+        instance_type = enums.Instance.Type(instance_type)
+
+        instance = Instance(
+            instance_id,
+            self.get_client(project_id),
+            instance_display_name,
+            instance_type,
+            instance_labels,
+        )
+
+        clusters = [
+            instance.cluster(
+                main_cluster_id,
+                main_cluster_zone,
+                cluster_nodes,
+                cluster_storage_type
+            )
+        ]
+        if replica_cluster_id and replica_cluster_zone:
+            clusters.append(instance.cluster(
+                replica_cluster_id,
+                replica_cluster_zone,
+                cluster_nodes,
+                cluster_storage_type
+            ))
+        operation = instance.create(
+            clusters=clusters
+        )
+        operation.result(timeout)
+        return instance
+
+    # noinspection PyMethodMayBeStatic
+    def create_table(self, instance, table_id, initial_split_keys, column_families):
+        """
+        Creates the specified Cloud Bigtable table.
+        Raises google.api_core.exceptions.AlreadyExists if the table exists.
+
+        :type instance: Instance
+        :param instance: The Cloud Bigtable instance that owns the table.
+        :type table_id: str
+        :param table_id: The ID of the table to create in Cloud Bigtable.
+        :type initial_split_keys: list
+        :param initial_split_keys: (Optional) A list of row keys in bytes to use to initially split the table.
+        :type column_families: dict
+        :param column_families: (Optional) A map of columns to create. The key is the column_id str, and the
+        value is a GarbageCollectionRule.
+        """
+        table = Table(table_id, instance)
+        table.create(initial_split_keys, column_families)
+
+    def delete_table(self, project_id, instance_id, table_id):
+        """
+        Deletes the specified table in Cloud Bigtable.
+        Raises google.api_core.exceptions.NotFound if the table does not exist.
+
+        :type project_id: str
+        :param project_id: The ID of the GCP project.
+        :type instance_id: str
+        :param instance_id: The ID of the Cloud Bigtable instance.
+        :type table_id: str
+        :param table_id: The ID of the table in Cloud Bigtable.
+        """
+        instance = Instance(instance_id, self.get_client(project_id))
+        table = Table(table_id, instance)
+        table.delete()
+
+    @staticmethod
+    def update_cluster(instance, cluster_id, nodes):
+        """
+        Updates number of nodes in the specified Cloud Bigtable cluster.
+        Raises google.api_core.exceptions.NotFound if the cluster does not exist.
+
+        :type instance: Instance
+        :param instance: The Cloud Bigtable instance that owns the cluster.
+        :type cluster_id: str
+        :param cluster_id: The ID of the cluster.
+        :type nodes: int
+        :param nodes: The desired number of nodes.
+        """
+        cluster = Cluster(cluster_id, instance)
+        cluster.serve_nodes = nodes
+        cluster.update()
+
+    @staticmethod
+    def get_column_families_for_table(instance, table_id):
+        """
+        Fetches Column Families for the specified table in Cloud Bigtable.
+
+        :type instance: Instance
+        :param instance: The Cloud Bigtable instance that owns the table.
+        :type table_id: str
+        :param table_id: The ID of the table in Cloud Bigtable to fetch Column Families from.
+        """
+
+        table = Table(table_id, instance)
+        return table.list_column_families()
+
+    @staticmethod
+    def get_cluster_states_for_table(instance, table_id):
+        """
+        Fetches Cluster States for the specified table in Cloud Bigtable.
+        Raises google.api_core.exceptions.NotFound if the table does not exist.
+
+        :type instance: Instance
+        :param instance: The Cloud Bigtable instance that owns the table.
+        :type table_id: str
+        :param table_id: The ID of the table in Cloud Bigtable to fetch Cluster States from.
+        """
+
+        table = Table(table_id, instance)
+        return table.get_cluster_states()
diff --git a/airflow/contrib/operators/gcp_bigtable_operator.py b/airflow/contrib/operators/gcp_bigtable_operator.py
new file mode 100644
index 0000000000000..640851e76e490
--- /dev/null
+++ b/airflow/contrib/operators/gcp_bigtable_operator.py
@@ -0,0 +1,424 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import google.api_core.exceptions
+
+from airflow import AirflowException
+from airflow.models import BaseOperator
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.contrib.hooks.gcp_bigtable_hook import BigtableHook
+from airflow.utils.decorators import apply_defaults
+from google.cloud.bigtable_admin_v2 import enums
+from google.cloud.bigtable.table import ClusterState
+
+
+class BigtableValidationMixin(object):
+    """
+    Common class for Cloud Bigtable operators for validating required fields.
+    """
+
+    REQUIRED_ATTRIBUTES = []
+
+    def _validate_inputs(self):
+        for attr_name in self.REQUIRED_ATTRIBUTES:
+            if not getattr(self, attr_name):
+                raise AirflowException('Empty parameter: {}'.format(attr_name))
+
+
+class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
+    """
+    Creates a new Cloud Bigtable instance.
+    If the Cloud Bigtable instance with the given ID exists, the operator does not compare its configuration
+    and immediately succeeds. No changes are made to the existing instance.
+
+    For more details about instance creation have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.create
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance to create.
+    :type main_cluster_id: str
+    :param main_cluster_id: The ID for main cluster for the new instance.
+    :type main_cluster_zone: str
+    :param main_cluster_zone: The zone for main cluster
+        See https://cloud.google.com/bigtable/docs/locations for more details.
+    :type replica_cluster_id: str
+    :param replica_cluster_id: (optional) The ID for replica cluster for the new instance.
+    :type replica_cluster_zone: str
+    :param replica_cluster_zone: (optional)  The zone for replica cluster.
+    :type instance_type: IntEnum
+    :param instance_type: (optional) The type of the instance.
+    :type instance_display_name: str
+    :param instance_display_name: (optional) Human-readable name of the instance. Defaults to ``instance_id``.
+    :type instance_labels: dict
+    :param instance_labels: (optional) Dictionary of labels to associate with the instance.
+    :type cluster_nodes: int
+    :param cluster_nodes: (optional) Number of nodes for cluster.
+    :type cluster_storage_type: IntEnum
+    :param cluster_storage_type: (optional) The type of storage.
+    :type timeout: int
+    :param timeout: (optional) timeout (in seconds) for instance creation.
+                    If None is not specified, Operator will wait indefinitely.
+    """
+
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'main_cluster_id', 'main_cluster_zone')
+    template_fields = ['project_id', 'instance_id', 'main_cluster_id', 'main_cluster_zone']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 main_cluster_id,
+                 main_cluster_zone,
+                 replica_cluster_id=None,
+                 replica_cluster_zone=None,
+                 instance_display_name=None,
+                 instance_type=None,
+                 instance_labels=None,
+                 cluster_nodes=None,
+                 cluster_storage_type=None,
+                 timeout=None,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self.main_cluster_id = main_cluster_id
+        self.main_cluster_zone = main_cluster_zone
+        self.replica_cluster_id = replica_cluster_id
+        self.replica_cluster_zone = replica_cluster_zone
+        self.instance_display_name = instance_display_name
+        self.instance_type = instance_type
+        self.instance_labels = instance_labels
+        self.cluster_nodes = cluster_nodes
+        self.cluster_storage_type = cluster_storage_type
+        self.timeout = timeout
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        super(BigtableInstanceCreateOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        if instance:
+            # Based on Instance.__eq__ instance with the same ID and client is considered as equal.
+            self.log.info(
+                "The instance '%s' already exists in this project. Consider it as created",
+                self.instance_id
+            )
+            return
+        try:
+            self.hook.create_instance(
+                self.project_id,
+                self.instance_id,
+                self.main_cluster_id,
+                self.main_cluster_zone,
+                self.replica_cluster_id,
+                self.replica_cluster_zone,
+                self.instance_display_name,
+                self.instance_type,
+                self.instance_labels,
+                self.cluster_nodes,
+                self.cluster_storage_type,
+                self.timeout,
+            )
+        except google.api_core.exceptions.GoogleAPICallError as e:
+            self.log.error('An error occurred. Exiting.')
+            raise e
+
+
+class BigtableInstanceDeleteOperator(BaseOperator, BigtableValidationMixin):
+    """
+    Deletes the Cloud Bigtable instance, including its clusters and all related tables.
+
+    For more details about deleting instance have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.delete
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance to delete.
+    """
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id')
+    template_fields = ['project_id', 'instance_id']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        super(BigtableInstanceDeleteOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        try:
+            self.hook.delete_instance(self.project_id, self.instance_id)
+        except google.api_core.exceptions.NotFound:
+            self.log.info(
+                "The instance '%s' does not exist in project '%s'. Consider it as deleted",
+                self.instance_id, self.project_id
+            )
+        except google.api_core.exceptions.GoogleAPICallError as e:
+            self.log.error('An error occurred. Exiting.')
+            raise e
+
+
+class BigtableTableCreateOperator(BaseOperator, BigtableValidationMixin):
+    """
+    Creates the table in the Cloud Bigtable instance.
+
+    For more details about creating table have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.create
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance that will hold the new table.
+    :type table_id: str
+    :param table_id: The ID of the table to be created.
+    :type initial_split_keys: list
+    :param initial_split_keys: (Optional) list of row keys in bytes that will be used to initially split
+                                the table into several tablets.
+    :type column_families: dict
+    :param column_families: (Optional) A map columns to create.
+                            The key is the column_id str and the value is a GarbageCollectionRule
+    """
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    template_fields = ['project_id', 'instance_id', 'table_id']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 table_id,
+                 initial_split_keys=None,
+                 column_families=None,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self.table_id = table_id
+        self.initial_split_keys = initial_split_keys or list()
+        self.column_families = column_families or dict()
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        self.instance = None
+        super(BigtableTableCreateOperator, self).__init__(*args, **kwargs)
+
+    def _compare_column_families(self):
+        table_column_families = self.hook.get_column_families_for_table(self.instance, self.table_id)
+        if set(table_column_families.keys()) != set(self.column_families.keys()):
+            self.log.error("Table '%s' has different set of Column Families", self.table_id)
+            self.log.error("Expected: %s", self.column_families.keys())
+            self.log.error("Actual: %s", table_column_families.keys())
+            return False
+
+        for key in table_column_families.keys():
+            # There is difference in structure between local Column Families and remote ones
+            # Local `self.column_families` is dict with column_id as key and GarbageCollectionRule as value.
+            # Remote `table_column_families` is list of ColumnFamily objects.
+            # For more information about ColumnFamily please refer to the documentation:
+            # https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html#google.cloud.bigtable.column_family.ColumnFamily
+            if table_column_families[key].gc_rule != self.column_families[key]:
+                self.log.error("Column Family '%s' differs for table '%s'.", key, self.table_id)
+                return False
+        return True
+
+    def execute(self, context):
+        self.instance = self.hook.get_instance(self.project_id, self.instance_id)
+        if not self.instance:
+            raise AirflowException("Dependency: instance '{}' does not exist in project '{}'.".format(
+                self.instance_id, self.project_id))
+        try:
+            self.hook.create_table(
+                self.instance,
+                self.table_id,
+                self.initial_split_keys,
+                self.column_families
+            )
+        except google.api_core.exceptions.AlreadyExists:
+            if not self._compare_column_families():
+                raise AirflowException(
+                    "Table '{}' already exists with different Column Families.".format(self.table_id))
+            self.log.info("The table '%s' already exists. Consider it as created", self.table_id)
+
+
+class BigtableTableDeleteOperator(BaseOperator, BigtableValidationMixin):
+    """
+    Deletes the Cloud Bigtable table.
+
+    For more details about deleting table have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.delete
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance.
+    :type table_id: str
+    :param table_id: The ID of the table to be deleted.
+    """
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    template_fields = ['project_id', 'instance_id', 'table_id']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 table_id,
+                 app_profile_id=None,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self.table_id = table_id
+        self.app_profile_id = app_profile_id
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        super(BigtableTableDeleteOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        if not instance:
+            raise AirflowException("Dependency: instance '{}' does not exist.".format(self.instance_id))
+
+        try:
+            self.hook.delete_table(
+                self.project_id,
+                self.instance_id,
+                self.table_id,
+            )
+        except google.api_core.exceptions.NotFound:
+            # It's OK if table doesn't exists.
+            self.log.info("The table '%s' no longer exists. Consider it as deleted", self.table_id)
+        except google.api_core.exceptions.GoogleAPICallError as e:
+            self.log.error('An error occurred. Exiting.')
+            raise e
+
+
+class BigtableClusterUpdateOperator(BaseOperator, BigtableValidationMixin):
+    """
+    Updates a Cloud Bigtable cluster.
+
+    For more details about updating a Cloud Bigtable cluster, have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/cluster.html#google.cloud.bigtable.cluster.Cluster.update
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance.
+    :type cluster_id: str
+    :param cluster_id: The ID of the Cloud Bigtable cluster to update.
+    :type nodes: int
+    :param nodes: The desired number of nodes for the Cloud Bigtable cluster.
+    """
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'cluster_id', 'nodes')
+    template_fields = ['project_id', 'instance_id', 'cluster_id', 'nodes']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 cluster_id,
+                 nodes,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self.cluster_id = cluster_id
+        self.nodes = nodes
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        super(BigtableClusterUpdateOperator, self).__init__(*args, **kwargs)
+
+    def execute(self, context):
+        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        if not instance:
+            raise AirflowException("Dependency: instance '{}' does not exist.".format(self.instance_id))
+
+        try:
+            self.hook.update_cluster(
+                instance,
+                self.cluster_id,
+                self.nodes
+            )
+        except google.api_core.exceptions.NotFound:
+            raise AirflowException("Dependency: cluster '{}' does not exist for instance '{}'.".format(
+                self.cluster_id,
+                self.instance_id
+            ))
+        except google.api_core.exceptions.GoogleAPICallError as e:
+            self.log.error('An error occurred. Exiting.')
+            raise e
+
+
+class BigtableTableWaitForReplicationSensor(BaseSensorOperator, BigtableValidationMixin):
+    """
+    Sensor that waits for Cloud Bigtable table to be fully replicated to its clusters.
+    No exception will be raised if the instance or the table does not exist.
+
+    For more details about cluster states for a table, have a look at the reference:
+    https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.get_cluster_states
+
+    :type project_id: str
+    :param project_id: The ID of the GCP project.
+    :type instance_id: str
+    :param instance_id: The ID of the Cloud Bigtable instance.
+    :type table_id: str
+    :param table_id: The ID of the table to check replication status.
+    """
+    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    template_fields = ['project_id', 'instance_id', 'table_id']
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 table_id,
+                 *args, **kwargs):
+        self.project_id = project_id
+        self.instance_id = instance_id
+        self.table_id = table_id
+        self._validate_inputs()
+        self.hook = BigtableHook()
+        super(BigtableTableWaitForReplicationSensor, self).__init__(*args, **kwargs)
+
+    def poke(self, context):
+        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        if not instance:
+            self.log.info("Dependency: instance '%s' does not exist.", self.instance_id)
+            return False
+
+        try:
+            cluster_states = self.hook.get_cluster_states_for_table(instance, self.table_id)
+        except google.api_core.exceptions.NotFound:
+            self.log.info(
+                "Dependency: table '%s' does not exist in instance '%s'.", self.table_id, self.instance_id)
+            return False
+
+        ready_state = ClusterState(enums.Table.ClusterState.ReplicationState.READY)
+
+        is_table_replicated = True
+        for cluster_id in cluster_states.keys():
+            if cluster_states[cluster_id] != ready_state:
+                self.log.info("Table '%s' is not yet replicated on cluster '%s'.", self.table_id, cluster_id)
+                is_table_replicated = False
+
+        if not is_table_replicated:
+            return False
+
+        self.log.info("Table '%s' is replicated.", self.table_id)
+        return True
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index ced4d80345fc9..e9aade62957cf 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -355,6 +355,135 @@ More information
 
 See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_
 
+Google Cloud Bigtable Operators
+-------------------------------
+
+Arguments
+"""""""""
+
+All examples below rely on the following variables, which can be passed via environment variables.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :start-after: [START howto_operator_gcp_bigtable_args]
+    :end-before: [END howto_operator_gcp_bigtable_args]
+
+
+BigtableInstanceCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator`
+to create a Google Cloud Bigtable instance.
+
+If the Cloud Bigtable instance with the given ID exists, the operator does not compare its configuration
+and immediately succeeds. No changes are made to the existing instance.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_instance_create]
+    :end-before: [END howto_operator_gcp_bigtable_instance_create]
+
+
+BigtableInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator`
+to delete a Google Cloud Bigtable instance.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_instance_delete]
+    :end-before: [END howto_operator_gcp_bigtable_instance_delete]
+
+BigtableClusterUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator`
+to modify number of nodes in a Cloud Bigtable cluster.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_cluster_update]
+    :end-before: [END howto_operator_gcp_bigtable_cluster_update]
+
+
+BigtableTableCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a table in a Cloud Bigtable instance.
+
+If the table with given ID exists in the Cloud Bigtable instance, the operator compares the Column Families.
+If the Column Families are identical operator succeeds. Otherwise, the operator fails with the appropriate
+error message.
+
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_create]
+    :end-before: [END howto_operator_gcp_bigtable_table_create]
+
+Advanced
+""""""""
+
+When creating a table, you can specify the optional ``initial_split_keys`` and ``column_familes``.
+Please refer to the Python Client for Google Cloud Bigtable documentation
+`for Table <https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html>`_ and `for Column
+Families <https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html>`_.
+
+
+BigtableTableDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator`
+to delete a table in Google Cloud Bigtable.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_delete]
+    :end-before: [END howto_operator_gcp_bigtable_table_delete]
+
+BigtableTableWaitForReplicationSensor
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor`
+to wait for the table to replicate fully.
+
+The same arguments apply to this sensor as the BigtableTableCreateOperator_.
+
+**Note:** If the table or the Cloud Bigtable instance does not exist, this sensor waits for the table until
+timeout hits and does not raise any exception.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_wait_for_replication]
+    :end-before: [END howto_operator_gcp_bigtable_table_wait_for_replication]
+
+
+
 Google Cloud Functions Operators
 --------------------------------
 
@@ -1140,3 +1269,4 @@ See `Google Cloud Storage ObjectAccessControls insert documentation
 <https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_
 for details.
 
+
diff --git a/docs/integration.rst b/docs/integration.rst
index c463f89a4a023..6a051134d891d 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1,3 +1,4 @@
+
 ..  Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
@@ -773,6 +774,69 @@ Cloud SQL Hooks
     :members:
 
 
+Cloud Bigtable
+''''''''''''''
+
+Cloud Bigtable Operators
+""""""""""""""""""""""""
+
+- :ref:`BigtableInstanceCreateOperator` : creates a Cloud Bigtable instance.
+- :ref:`BigtableInstanceDeleteOperator` : deletes a Google Cloud Bigtable instance.
+- :ref:`BigtableClusterUpdateOperator` : updates the number of nodes in a Google Cloud Bigtable cluster.
+- :ref:`BigtableTableCreateOperator` : creates a table in a Google Cloud Bigtable instance.
+- :ref:`BigtableTableDeleteOperator` : deletes a table in a Google Cloud Bigtable instance.
+- :ref:`BigtableTableWaitForReplicationSensor` : (sensor) waits for a table to be fully replicated.
+
+.. _BigtableInstanceCreateOperator:
+
+BigtableInstanceCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
+
+.. _BigtableInstanceDeleteOperator:
+
+BigtableInstanceDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
+
+.. _BigtableClusterUpdateOperator:
+
+BigtableClusterUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
+
+.. _BigtableTableCreateOperator:
+
+BigtableTableCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
+
+.. _BigtableTableDeleteOperator:
+
+BigtableTableDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
+
+.. _BigtableTableWaitForReplicationSensor:
+
+BigtableTableWaitForReplicationSensor
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor
+
+.. _BigtableHook:
+
+Cloud Bigtable Hook
+""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook
+    :members:
+
 Compute Engine
 ''''''''''''''
 
diff --git a/setup.py b/setup.py
index fb136ff69497f..c650567742d01 100644
--- a/setup.py
+++ b/setup.py
@@ -190,6 +190,7 @@ def write_version(filename=os.path.join(*['airflow',
     'google-auth>=1.0.0, <2.0.0dev',
     'google-auth-httplib2>=0.0.1',
     'google-cloud-container>=0.1.1',
+    'google-cloud-bigtable==0.31.0',
     'google-cloud-spanner>=1.6.0',
     'grpcio-gcp>=0.2.2',
     'PyOpenSSL',
diff --git a/tests/contrib/operators/test_gcp_bigtable_operator.py b/tests/contrib/operators/test_gcp_bigtable_operator.py
new file mode 100644
index 0000000000000..8417efc9977dc
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_bigtable_operator.py
@@ -0,0 +1,540 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+import google.api_core.exceptions
+from google.cloud.bigtable.column_family import MaxVersionsGCRule
+from google.cloud.bigtable.instance import Instance
+from google.cloud.bigtable.table import ClusterState
+from parameterized import parameterized
+
+from airflow import AirflowException
+from airflow.contrib.operators.gcp_bigtable_operator import BigtableInstanceDeleteOperator, \
+    BigtableTableDeleteOperator, BigtableTableCreateOperator, BigtableTableWaitForReplicationSensor, \
+    BigtableClusterUpdateOperator, BigtableInstanceCreateOperator
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PROJECT_ID = 'test_project_id'
+INSTANCE_ID = 'test-instance-id'
+CLUSTER_ID = 'test-cluster-id'
+CLUSTER_ZONE = 'us-central1-f'
+NODES = 5
+TABLE_ID = 'test-table-id'
+INITIAL_SPLIT_KEYS = []
+EMPTY_COLUMN_FAMILIES = {}
+
+
+class BigtableInstanceCreateTest(unittest.TestCase):
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID, CLUSTER_ID, CLUSTER_ZONE),
+        ('instance_id', PROJECT_ID, '', CLUSTER_ID, CLUSTER_ZONE),
+        ('main_cluster_id', PROJECT_ID, INSTANCE_ID, '', CLUSTER_ZONE),
+        ('main_cluster_zone', PROJECT_ID, INSTANCE_ID, CLUSTER_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, main_cluster_id,
+                             main_cluster_zone, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableInstanceCreateOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                main_cluster_id=main_cluster_id,
+                main_cluster_zone=main_cluster_zone,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_create_instance_that_exists(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+
+        op = BigtableInstanceCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            main_cluster_id=CLUSTER_ID,
+            main_cluster_zone=CLUSTER_ZONE,
+            task_id="id"
+        )
+        op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_instance.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_different_error_reraised(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+        op = BigtableInstanceCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            main_cluster_id=CLUSTER_ID,
+            main_cluster_zone=CLUSTER_ZONE,
+            task_id="id"
+        )
+
+        mock_hook.return_value.create_instance.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.GoogleAPICallError('error'))
+
+        with self.assertRaises(google.api_core.exceptions.GoogleAPICallError):
+            op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_ID, CLUSTER_ID, CLUSTER_ZONE, None, None, None, None, None, None, None, None
+        )
+
+
+class BigtableClusterUpdateTest(unittest.TestCase):
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID, CLUSTER_ID, NODES),
+        ('instance_id', PROJECT_ID, '', CLUSTER_ID, NODES),
+        ('cluster_id', PROJECT_ID, INSTANCE_ID, '', NODES),
+        ('nodes', PROJECT_ID, INSTANCE_ID, CLUSTER_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, cluster_id, nodes, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableClusterUpdateOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                cluster_id=cluster_id,
+                nodes=nodes,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_updating_cluster_but_instance_does_not_exists(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+
+        with self.assertRaises(AirflowException) as e:
+            op = BigtableClusterUpdateOperator(
+                project_id=PROJECT_ID,
+                instance_id=INSTANCE_ID,
+                cluster_id=CLUSTER_ID,
+                nodes=NODES,
+                task_id="id"
+            )
+            op.execute(None)
+
+        err = e.exception
+        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(INSTANCE_ID))
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.update_cluster.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_updating_cluster_that_does_not_exists(self, mock_hook):
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.update_cluster.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Cluster not found."))
+
+        with self.assertRaises(AirflowException) as e:
+            op = BigtableClusterUpdateOperator(
+                project_id=PROJECT_ID,
+                instance_id=INSTANCE_ID,
+                cluster_id=CLUSTER_ID,
+                nodes=NODES,
+                task_id="id"
+            )
+            op.execute(None)
+
+        err = e.exception
+        self.assertEqual(
+            str(err),
+            "Dependency: cluster '{}' does not exist for instance '{}'.".format(CLUSTER_ID, INSTANCE_ID)
+        )
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.update_cluster.assert_called_once_with(instance, CLUSTER_ID, NODES)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_different_error_reraised(self, mock_hook):
+        op = BigtableClusterUpdateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            cluster_id=CLUSTER_ID,
+            nodes=NODES,
+            task_id="id"
+        )
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.update_cluster.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.GoogleAPICallError('error'))
+
+        with self.assertRaises(google.api_core.exceptions.GoogleAPICallError):
+            op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.update_cluster.assert_called_once_with(instance, CLUSTER_ID, NODES)
+
+
+class BigtableInstanceDeleteTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_delete_execute(self, mock_hook):
+        op = BigtableInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID),
+        ('instance_id', PROJECT_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableInstanceDeleteOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_deleting_instance_that_doesnt_exists(self, mock_hook):
+        op = BigtableInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        mock_hook.return_value.delete_instance.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Instance not found."))
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_different_error_reraised(self, mock_hook):
+        op = BigtableInstanceDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        mock_hook.return_value.delete_instance.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.GoogleAPICallError('error'))
+
+        with self.assertRaises(google.api_core.exceptions.GoogleAPICallError):
+            op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+
+
+class BigtableTableDeleteTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_delete_execute(self, mock_hook):
+        op = BigtableTableDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID, TABLE_ID),
+        ('instance_id', PROJECT_ID, '', TABLE_ID),
+        ('table_id', PROJECT_ID, INSTANCE_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableTableDeleteOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                table_id=table_id,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_deleting_table_that_doesnt_exists(self, mock_hook):
+        op = BigtableTableDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+
+        mock_hook.return_value.delete_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Table not found."))
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_deleting_table_when_instance_doesnt_exists(self, mock_hook):
+        op = BigtableTableDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+
+        mock_hook.return_value.get_instance.return_value = None
+        with self.assertRaises(AirflowException) as e:
+            op.execute(None)
+        err = e.exception
+        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(INSTANCE_ID))
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_table.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_different_error_reraised(self, mock_hook):
+        op = BigtableTableDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        mock_hook.return_value.delete_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.GoogleAPICallError('error'))
+
+        with self.assertRaises(google.api_core.exceptions.GoogleAPICallError):
+            op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+
+
+class BigtableTableCreateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_create_execute(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES,
+            task_id="id"
+        )
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_table.assert_called_once_with(
+            instance, TABLE_ID, INITIAL_SPLIT_KEYS, EMPTY_COLUMN_FAMILIES)
+
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID, TABLE_ID),
+        ('instance_id', PROJECT_ID, '', TABLE_ID),
+        ('table_id', PROJECT_ID, INSTANCE_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableTableCreateOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                table_id=table_id,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_instance_not_exists(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES,
+            task_id="id"
+        )
+        mock_hook.return_value.get_instance.return_value = None
+        with self.assertRaises(AirflowException) as e:
+            op.execute(None)
+        err = e.exception
+        self.assertEqual(
+            str(err),
+            "Dependency: instance '{}' does not exist in project '{}'.".format(INSTANCE_ID, PROJECT_ID)
+        )
+        mock_hook.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_creating_table_that_exists(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES,
+            task_id="id"
+        )
+
+        mock_hook.return_value.get_column_families_for_table.return_value = EMPTY_COLUMN_FAMILIES
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.create_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
+        op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_table.assert_called_once_with(
+            instance, TABLE_ID, INITIAL_SPLIT_KEYS, EMPTY_COLUMN_FAMILIES)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_creating_table_that_exists_with_different_column_families_ids_in_the_table(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES,
+            task_id="id"
+        )
+
+        mock_hook.return_value.get_column_families_for_table.return_value = {"existing_family": None}
+        mock_hook.return_value.create_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
+
+        with self.assertRaises(AirflowException) as e:
+            op.execute(None)
+        err = e.exception
+        self.assertEqual(
+            str(err),
+            "Table '{}' already exists with different Column Families.".format(TABLE_ID)
+        )
+        mock_hook.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_creating_table_that_exists_with_different_column_families_gc_rule_in_the_table(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families={"cf-id": MaxVersionsGCRule(1)},
+            task_id="id"
+        )
+
+        cf_mock = mock.Mock()
+        cf_mock.gc_rule = mock.Mock(return_value=MaxVersionsGCRule(2))
+
+        mock_hook.return_value.get_column_families_for_table.return_value = {
+            "cf-id": cf_mock
+        }
+        mock_hook.return_value.create_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
+
+        with self.assertRaises(AirflowException) as e:
+            op.execute(None)
+        err = e.exception
+        self.assertEqual(
+            str(err),
+            "Table '{}' already exists with different Column Families.".format(TABLE_ID)
+        )
+        mock_hook.assert_called_once_with()
+
+
+class BigtableWaitForTableReplicationTest(unittest.TestCase):
+    @parameterized.expand([
+        ('project_id', '', INSTANCE_ID, TABLE_ID),
+        ('instance_id', PROJECT_ID, '', TABLE_ID),
+        ('table_id', PROJECT_ID, INSTANCE_ID, ''),
+    ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+        with self.assertRaises(AirflowException) as e:
+            BigtableTableWaitForReplicationSensor(
+                project_id=project_id,
+                instance_id=instance_id,
+                table_id=table_id,
+                task_id="id"
+            )
+        err = e.exception
+        self.assertEqual(str(err), 'Empty parameter: {}'.format(missing_attribute))
+        mock_hook.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_wait_no_instance(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+
+        op = BigtableTableWaitForReplicationSensor(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        self.assertFalse(op.poke(None))
+        mock_hook.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_wait_no_table(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.get_cluster_states_for_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Table not found."))
+
+        op = BigtableTableWaitForReplicationSensor(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        self.assertFalse(op.poke(None))
+        mock_hook.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_wait_not_ready(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.get_cluster_states_for_table.return_value = {
+            "cl-id": ClusterState(0)
+        }
+        op = BigtableTableWaitForReplicationSensor(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        self.assertFalse(op.poke(None))
+        mock_hook.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_wait_ready(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.get_cluster_states_for_table.return_value = {
+            "cl-id": ClusterState(4)
+        }
+        op = BigtableTableWaitForReplicationSensor(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+        self.assertTrue(op.poke(None))
+        mock_hook.assert_called_once_with()

From 0d55d2f37deb621ac7a97607b6c3cab4a1a53e0b Mon Sep 17 00:00:00 2001
From: Sumit Maheshwari <sumeet.manit@gmail.com>
Date: Fri, 4 Jan 2019 19:25:56 +0530
Subject: [PATCH 327/808] [AIRFLOW-3340] Placeholder support in connections
 form (#4185)

---
 airflow/www/static/connection_form.js         | 8 ++++++++
 airflow/www_rbac/static/js/connection_form.js | 8 ++++++++
 2 files changed, 16 insertions(+)

diff --git a/airflow/www/static/connection_form.js b/airflow/www/static/connection_form.js
index 8ed42c2dbed2e..8517ad2582bf4 100644
--- a/airflow/www/static/connection_form.js
+++ b/airflow/www/static/connection_form.js
@@ -59,6 +59,9 @@
           relabeling: {
             'host': 'API Endpoint',
             'password': 'Auth Token',
+          },
+          placeholders: {
+            'host': 'https://<env>.qubole.com/api'
           }
         },
         ssh: {
@@ -81,6 +84,8 @@
         $("label[orig_text]").each(function(){
             $(this).text($(this).attr("orig_text"));
         });
+        $(".form-control").each(function(){$(this).attr('placeholder', '')});
+
         if (config[connectionType] != undefined){
           $.each(config[connectionType].hidden_fields, function(i, field){
             $("#" + field).parent().parent().addClass('hide')
@@ -90,6 +95,9 @@
             lbl.attr("orig_text", lbl.text());
             $("label[for='" + k + "']").text(v);
           });
+          $.each(config[connectionType].placeholders, function(k, v){
+            $("#" + k).attr('placeholder', v);
+          });
         }
       }
       var connectionType=$("#conn_type").val();
diff --git a/airflow/www_rbac/static/js/connection_form.js b/airflow/www_rbac/static/js/connection_form.js
index 09034f8785203..17ca29066a21b 100644
--- a/airflow/www_rbac/static/js/connection_form.js
+++ b/airflow/www_rbac/static/js/connection_form.js
@@ -51,6 +51,9 @@ $(document).ready(function () {
       relabeling: {
         'host': 'API Endpoint',
         'password': 'Auth Token',
+      },
+      placeholders: {
+        'host': 'https://<env>.qubole.com/api'
       }
     },
     ssh: {
@@ -72,6 +75,8 @@ $(document).ready(function () {
     $("label[orig_text]").each(function () {
       $(this).text($(this).attr("orig_text"));
     });
+    $(".form-control").each(function(){$(this).attr('placeholder', '')});
+
     if (config[connectionType] != undefined) {
       $.each(config[connectionType].hidden_fields, function (i, field) {
         $("#" + field).parent().parent().addClass('hide')
@@ -81,6 +86,9 @@ $(document).ready(function () {
         lbl.attr("orig_text", lbl.text());
         $("label[for='" + k + "']").text(v);
       });
+      $.each(config[connectionType].placeholders, function(k, v){
+        $("#" + k).attr('placeholder', v);
+      });
     }
   }
 

From 08bd37b803f9d77cc65be88885a7aaeebd7d8fc8 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Fri, 4 Jan 2019 14:54:33 +0100
Subject: [PATCH 328/808] [AIRFLOW-3527] Update Cloud SQL Proxy to have shorter
 path for UNIX socket (#4350)

---
 airflow/contrib/hooks/gcp_sql_hook.py         | 89 ++++++++++++-------
 .../operators/test_gcp_sql_operator.py        | 45 +++++++++-
 2 files changed, 100 insertions(+), 34 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 43e664d15c857..7dabf74789f97 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -19,8 +19,11 @@
 import errno
 import json
 import os
+import random
 import re
 import shutil
+import string
+
 import socket
 import platform
 import subprocess
@@ -44,6 +47,8 @@
 from airflow.models import Connection
 from airflow.utils.db import provide_session
 
+UNIX_PATH_MAX = 108
+
 NUM_RETRIES = 5
 
 # Time to sleep between active checks of the operation results
@@ -378,8 +383,8 @@ def _download_sql_proxy_if_needed(self):
             download_url = CLOUD_SQL_PROXY_VERSION_DOWNLOAD_URL.format(
                 self.sql_proxy_version, system, processor)
         proxy_path_tmp = self.sql_proxy_path + ".tmp"
-        self.log.info("Downloading cloud_sql_proxy from {} to {}".
-                      format(download_url, proxy_path_tmp))
+        self.log.info("Downloading cloud_sql_proxy from %s to %s",
+                      download_url, proxy_path_tmp)
         r = requests.get(download_url, allow_redirects=True)
         # Downloading to .tmp file first to avoid case where partially downloaded
         # binary is used by parallel operator which uses the same fixed binary path
@@ -389,9 +394,8 @@ def _download_sql_proxy_if_needed(self):
             raise AirflowException(
                 "The cloud-sql-proxy could not be downloaded. Status code = {}. "
                 "Reason = {}".format(r.status_code, r.reason))
-        self.log.info("Moving sql_proxy binary from {} to {}".format(
-            proxy_path_tmp, self.sql_proxy_path
-        ))
+        self.log.info("Moving sql_proxy binary from %s to %s",
+                      proxy_path_tmp, self.sql_proxy_path)
         shutil.move(proxy_path_tmp, self.sql_proxy_path)
         os.chmod(self.sql_proxy_path, 0o744)  # Set executable bit
         self.sql_proxy_was_downloaded = True
@@ -409,7 +413,7 @@ def _get_credential_parameters(self, session):
         elif GCP_CREDENTIALS_KEYFILE_DICT in connection.extra_dejson:
             credential_file_content = json.loads(
                 connection.extra_dejson[GCP_CREDENTIALS_KEYFILE_DICT])
-            self.log.info("Saving credentials to {}".format(self.credentials_path))
+            self.log.info("Saving credentials to %s", self.credentials_path)
             with open(self.credentials_path, "w") as f:
                 json.dump(credential_file_content, f)
             credential_params = [
@@ -419,8 +423,8 @@ def _get_credential_parameters(self, session):
         else:
             self.log.info(
                 "The credentials are not supplied by neither key_path nor "
-                "keyfile_dict of the gcp connection {}. Falling back to "
-                "default activated account".format(self.gcp_conn_id))
+                "keyfile_dict of the gcp connection %s. Falling back to "
+                "default activated account", self.gcp_conn_id)
             credential_params = []
 
         if not self.instance_specification:
@@ -450,18 +454,17 @@ def start_proxy(self):
             command_to_run = [self.sql_proxy_path]
             command_to_run.extend(self.command_line_parameters)
             try:
-                self.log.info("Creating directory {}".format(
-                    self.cloud_sql_proxy_socket_directory))
+                self.log.info("Creating directory %s",
+                              self.cloud_sql_proxy_socket_directory)
                 os.makedirs(self.cloud_sql_proxy_socket_directory)
             except OSError:
                 # Needed for python 2 compatibility (exists_ok missing)
                 pass
             command_to_run.extend(self._get_credential_parameters())
-            self.log.info("Running the command: `{}`".format(" ".join(command_to_run)))
+            self.log.info("Running the command: `%s`", " ".join(command_to_run))
             self.sql_proxy_process = Popen(command_to_run,
                                            stdin=PIPE, stdout=PIPE, stderr=PIPE)
-            self.log.info("The pid of cloud_sql_proxy: {}".format(
-                self.sql_proxy_process.pid))
+            self.log.info("The pid of cloud_sql_proxy: %s", self.sql_proxy_process.pid)
             while True:
                 line = self.sql_proxy_process.stderr.readline().decode('utf-8')
                 return_code = self.sql_proxy_process.poll()
@@ -489,16 +492,16 @@ def stop_proxy(self):
         if not self.sql_proxy_process:
             raise AirflowException("The sql proxy is not started yet")
         else:
-            self.log.info("Stopping the cloud_sql_proxy pid: {}".format(
-                self.sql_proxy_process.pid))
+            self.log.info("Stopping the cloud_sql_proxy pid: %s",
+                          self.sql_proxy_process.pid)
             self.sql_proxy_process.kill()
             self.sql_proxy_process = None
         # Cleanup!
-        self.log.info("Removing the socket directory: {}".
-                      format(self.cloud_sql_proxy_socket_directory))
+        self.log.info("Removing the socket directory: %s",
+                      self.cloud_sql_proxy_socket_directory)
         shutil.rmtree(self.cloud_sql_proxy_socket_directory, ignore_errors=True)
         if self.sql_proxy_was_downloaded:
-            self.log.info("Removing downloaded proxy: {}".format(self.sql_proxy_path))
+            self.log.info("Removing downloaded proxy: %s", self.sql_proxy_path)
             # Silently ignore if the file has already been removed (concurrency)
             try:
                 os.remove(self.sql_proxy_path)
@@ -506,11 +509,11 @@ def stop_proxy(self):
                 if not e.errno == errno.ENOENT:
                     raise
         else:
-            self.log.info("Skipped removing proxy - it was not downloaded: {}".
-                          format(self.sql_proxy_path))
+            self.log.info("Skipped removing proxy - it was not downloaded: %s",
+                          self.sql_proxy_path)
         if isfile(self.credentials_path):
-            self.log.info("Removing generated credentials file {}".
-                          format(self.credentials_path))
+            self.log.info("Removing generated credentials file %s",
+                          self.credentials_path)
             # Here file cannot be delete by concurrent task (each task has its own copy)
             os.remove(self.credentials_path)
 
@@ -690,18 +693,38 @@ def _validate_inputs(self):
             self._check_ssl_file(self.sslcert, "sslcert")
             self._check_ssl_file(self.sslkey, "sslkey")
             self._check_ssl_file(self.sslrootcert, "sslrootcert")
+        if self.use_proxy and not self.sql_proxy_use_tcp:
+            if self.database_type == 'postgres':
+                suffix = "/.s.PGSQL.5432"
+            else:
+                suffix = ""
+            expected_path = "{}/{}:{}:{}{}".format(
+                self._generate_unique_path(),
+                self.project_id, self.instance,
+                self.database, suffix)
+            if len(expected_path) > UNIX_PATH_MAX:
+                self.log.info("Too long (%s) path: %s", len(expected_path), expected_path)
+                raise AirflowException(
+                    "The UNIX socket path length cannot exceed {} characters "
+                    "on Linux system. Either use shorter instance/database "
+                    "name or switch to TCP connection. "
+                    "The socket path for Cloud SQL proxy is now:"
+                    "{}".format(
+                        UNIX_PATH_MAX, expected_path))
 
-    def _generate_unique_path(self):
+    @staticmethod
+    def _generate_unique_path():
         # We are not using mkdtemp here as the path generated with mkdtemp
         # can be close to 60 characters and there is a limitation in
         # length of socket path to around 100 characters in total.
         # We append project/location/instance to it later and postgres
-        # appends its own prefix, so we chose a shorter "/tmp/{uuid1}" - based
-        # on host name and clock + clock sequence. This should be fairly
-        # sufficient for our needs and should even work if the time is set back.
-        # We are using db_conn_id generated with uuid1 so that connection
-        # id matches the folder - for easier debugging.
-        return "/tmp/" + self.db_conn_id
+        # appends its own prefix, so we chose a shorter "/tmp/[8 random characters]" -
+        random.seed()
+        while True:
+            candidate = "/tmp/" + ''.join(
+                random.choice(string.ascii_lowercase + string.digits) for _ in range(8))
+            if not os.path.exists(candidate):
+                return candidate
 
     @staticmethod
     def _quote(value):
@@ -754,8 +777,8 @@ def _generate_connection_uri(self):
             client_key_file=self._quote(self.sslkey),
             server_ca_file=self._quote(self.sslrootcert)
         )
-        self.log.info("DB connection URI {}".format(connection_uri.replace(
-            quote_plus(self.password), 'XXXXXXXXXXXX')))
+        self.log.info("DB connection URI %s", connection_uri.replace(
+            quote_plus(self.password), 'XXXXXXXXXXXX'))
         return connection_uri
 
     def _get_instance_socket_name(self):
@@ -778,7 +801,7 @@ def create_connection(self, session=None):
         """
         connection = Connection(conn_id=self.db_conn_id)
         uri = self._generate_connection_uri()
-        self.log.info("Creating connection {}".format(self.db_conn_id))
+        self.log.info("Creating connection %s", self.db_conn_id)
         connection.parse_from_uri(uri)
         session.add(connection)
         session.commit()
@@ -791,7 +814,7 @@ def delete_connection(self, session=None):
         :param session: Session of the SQL Alchemy ORM (automatically generated with
                         decorator).
         """
-        self.log.info("Deleting connection {}".format(self.db_conn_id))
+        self.log.info("Deleting connection %s", self.db_conn_id)
         connection = session.query(models.Connection).filter(
             models.Connection.conn_id == self.db_conn_id)[0]
         session.delete(connection)
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 516fcef4aa85b..a1d5ef632a8a7 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -511,7 +511,8 @@ def test_create_operator_with_wrong_parameters(self,
                                                    get_connections):
         connection = Connection()
         connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type={database_type}&"
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?"
+            "database_type={database_type}&"
             "project_id={project_id}&location={location}&instance={instance_name}&"
             "use_proxy={use_proxy}&use_ssl={use_ssl}".
             format(database_type=database_type,
@@ -728,6 +729,48 @@ def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections
         self.assertNotEqual(3200, conn.port)
         self.assertEqual('testdb', conn.schema)
 
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_too_long_unix_socket_path(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&"
+            "instance="
+            "test_db_with_long_name_a_bit_above_the_limit_of_UNIX_socket&"
+            "use_proxy=True&sql_proxy_use_tcp=False")
+        get_connections.return_value = [connection]
+        with self.assertRaises(AirflowException) as cm:
+            operator = CloudSqlQueryOperator(
+                sql=['SELECT * FROM TABLE'],
+                task_id='task_id'
+            )
+            operator.cloudsql_db_hook.create_connection()
+        err = cm.exception
+        self.assertIn("The UNIX socket path length cannot exceed", str(err))
+
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_not_too_long_unix_socket_path(self, get_connections):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
+            "project_id=example-project&location=europe-west1&"
+            "instance="
+            "test_db_with_longname_but_with_limit_of_UNIX_socket_aaaa&"
+            "use_proxy=True&sql_proxy_use_tcp=False")
+        get_connections.return_value = [connection]
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.postgres_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('postgres', conn.conn_type)
+        self.assertEqual('testdb', conn.schema)
+
 
 @unittest.skipIf(
     BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)

From c18b1b5f9fa63df12efa54d0a5c078dcee54d1eb Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 5 Jan 2019 13:06:56 +0100
Subject: [PATCH 329/808] [AIRFLOW-3480] Add GCP Spanner Database Operators
 (#4353)

---
 .../example_dags/example_gcp_spanner.py       | 140 ++++++++---
 airflow/contrib/hooks/gcp_spanner_hook.py     | 236 ++++++++++++++----
 .../contrib/operators/gcp_spanner_operator.py | 229 +++++++++++++++--
 docs/howto/operator.rst                       | 162 +++++++++---
 docs/integration.rst                          |  41 ++-
 setup.py                                      |   2 +-
 .../operators/test_gcp_spanner_operator.py    | 170 ++++++++++++-
 7 files changed, 839 insertions(+), 141 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
index cec3dcb855bc6..0aeb1e63a0bd8 100644
--- a/airflow/contrib/example_dags/example_gcp_spanner.py
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -21,15 +21,16 @@
 Example Airflow DAG that creates, updates, queries and deletes a Cloud Spanner instance.
 
 This DAG relies on the following environment variables
-* SPANNER_PROJECT_ID - Google Cloud Platform project for the Cloud Spanner instance.
-* SPANNER_INSTANCE_ID - Cloud Spanner instance ID.
-* SPANNER_CONFIG_NAME - The name of the instance's configuration. Values are of the form
-    projects/<project>/instanceConfigs/<configuration>.
+* GCP_PROJECT_ID - Google Cloud Platform project for the Cloud Spanner instance.
+* GCP_SPANNER_INSTANCE_ID - Cloud Spanner instance ID.
+* GCP_SPANNER_DATABASE_ID - Cloud Spanner database ID.
+* GCP_SPANNER_CONFIG_NAME - The name of the instance's configuration. Values are of the
+    form projects/<gcp_project>/instanceConfigs/<configuration>.
     See also:
         https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs#InstanceConfig
         https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list#google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
-* SPANNER_NODE_COUNT - Number of nodes allocated to the instance.
-* SPANNER_DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
+* GCP_SPANNER_NODE_COUNT - Number of nodes allocated to the instance.
+* GCP_SPANNER_DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
     Must be unique per project and between 4 and 30 characters in length.
 """
 
@@ -39,16 +40,21 @@
 from airflow import models
 from airflow.contrib.operators.gcp_spanner_operator import \
     CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDatabaseQueryOperator, \
-    CloudSpannerInstanceDeleteOperator
+    CloudSpannerInstanceDeleteOperator, \
+    CloudSpannerInstanceDatabaseDeployOperator, \
+    CloudSpannerInstanceDatabaseUpdateOperator, \
+    CloudSpannerInstanceDatabaseDeleteOperator
 
 # [START howto_operator_spanner_arguments]
-PROJECT_ID = os.environ.get('SPANNER_PROJECT_ID', 'example-project')
-INSTANCE_ID = os.environ.get('SPANNER_INSTANCE_ID', 'testinstance')
-DB_ID = os.environ.get('SPANNER_DB_ID', 'db1')
-CONFIG_NAME = os.environ.get('SPANNER_CONFIG_NAME',
-                             'projects/example-project/instanceConfigs/eur3')
-NODE_COUNT = os.environ.get('SPANNER_NODE_COUNT', '1')
-DISPLAY_NAME = os.environ.get('SPANNER_DISPLAY_NAME', 'Test Instance')
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_SPANNER_INSTANCE_ID = os.environ.get('GCP_SPANNER_INSTANCE_ID', 'testinstance')
+GCP_SPANNER_DATABASE_ID = os.environ.get('GCP_SPANNER_DATABASE_ID', 'testdatabase')
+GCP_SPANNER_CONFIG_NAME = os.environ.get('GCP_SPANNER_CONFIG_NAME',
+                                         'projects/example-project/instanceConfigs/eur3')
+GCP_SPANNER_NODE_COUNT = os.environ.get('GCP_SPANNER_NODE_COUNT', '1')
+GCP_SPANNER_DISPLAY_NAME = os.environ.get('GCP_SPANNER_DISPLAY_NAME', 'Test Instance')
+# OPERATION_ID should be unique per operation
+OPERATION_ID = 'unique_operation_id'
 # [END howto_operator_spanner_arguments]
 
 default_args = {
@@ -63,51 +69,115 @@
     # Create
     # [START howto_operator_spanner_deploy]
     spanner_instance_create_task = CloudSpannerInstanceDeployOperator(
-        project_id=PROJECT_ID,
-        instance_id=INSTANCE_ID,
-        configuration_name=CONFIG_NAME,
-        node_count=int(NODE_COUNT),
-        display_name=DISPLAY_NAME,
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        configuration_name=GCP_SPANNER_CONFIG_NAME,
+        node_count=int(GCP_SPANNER_NODE_COUNT),
+        display_name=GCP_SPANNER_DISPLAY_NAME,
         task_id='spanner_instance_create_task'
     )
     # [END howto_operator_spanner_deploy]
 
     # Update
     spanner_instance_update_task = CloudSpannerInstanceDeployOperator(
-        project_id=PROJECT_ID,
-        instance_id=INSTANCE_ID,
-        configuration_name=CONFIG_NAME,
-        node_count=int(NODE_COUNT) + 1,
-        display_name=DISPLAY_NAME + '_updated',
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        configuration_name=GCP_SPANNER_CONFIG_NAME,
+        node_count=int(GCP_SPANNER_NODE_COUNT) + 1,
+        display_name=GCP_SPANNER_DISPLAY_NAME + '_updated',
         task_id='spanner_instance_update_task'
     )
 
+    # [START howto_operator_spanner_database_deploy]
+    spanner_database_deploy_task = CloudSpannerInstanceDatabaseDeployOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        ddl_statements=[
+            "CREATE TABLE my_table1 (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+            "CREATE TABLE my_table2 (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+        ],
+        task_id='spanner_database_deploy_task'
+    )
+    # [END howto_operator_spanner_database_deploy]
+
+    # [START howto_operator_spanner_database_update]
+    spanner_database_update_task = CloudSpannerInstanceDatabaseUpdateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        ddl_statements=[
+            "CREATE TABLE my_table3 (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+        ],
+        task_id='spanner_database_update_task'
+    )
+    # [END howto_operator_spanner_database_update]
+
+    # [START howto_operator_spanner_database_update_idempotent]
+    spanner_database_update_idempotent1_task = CloudSpannerInstanceDatabaseUpdateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        operation_id=OPERATION_ID,
+        ddl_statements=[
+            "CREATE TABLE my_table_unique (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+        ],
+        task_id='spanner_database_update_idempotent1_task'
+    )
+    spanner_database_update_idempotent2_task = CloudSpannerInstanceDatabaseUpdateOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        operation_id=OPERATION_ID,
+        ddl_statements=[
+            "CREATE TABLE my_table_unique (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+        ],
+        task_id='spanner_database_update_idempotent2_task'
+    )
+    # [END howto_operator_spanner_database_update_idempotent]
+
     # [START howto_operator_spanner_query]
-    spanner_instance_query = CloudSpannerInstanceDatabaseQueryOperator(
-        project_id=PROJECT_ID,
-        instance_id=INSTANCE_ID,
+    spanner_instance_query_task = CloudSpannerInstanceDatabaseQueryOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
         database_id='db1',
-        query="DELETE FROM my_table2 WHERE true",
+        query=["DELETE FROM my_table2 WHERE true"],
         task_id='spanner_instance_query'
     )
     # [END howto_operator_spanner_query]
 
-    spanner_instance_query2 = CloudSpannerInstanceDatabaseQueryOperator(
-        project_id=PROJECT_ID,
-        instance_id=INSTANCE_ID,
+    spanner_instance_query2_task = CloudSpannerInstanceDatabaseQueryOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
         database_id='db1',
         query="example_gcp_spanner.sql",
         task_id='spanner_instance_query2'
     )
 
+    # [START howto_operator_spanner_database_delete]
+    spanner_database_delete_task = CloudSpannerInstanceDatabaseDeleteOperator(
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        task_id='spanner_database_delete_task'
+    )
+    # [END howto_operator_spanner_database_delete]
+
     # [START howto_operator_spanner_delete]
     spanner_instance_delete_task = CloudSpannerInstanceDeleteOperator(
-        project_id=PROJECT_ID,
-        instance_id=INSTANCE_ID,
+        project_id=GCP_PROJECT_ID,
+        instance_id=GCP_SPANNER_INSTANCE_ID,
         task_id='spanner_instance_delete_task'
     )
     # [END howto_operator_spanner_delete]
 
-    spanner_instance_create_task >> spanner_instance_update_task \
-        >> spanner_instance_query >> spanner_instance_query2 \
+    spanner_instance_create_task \
+        >> spanner_instance_update_task \
+        >> spanner_database_deploy_task \
+        >> spanner_database_update_task \
+        >> spanner_database_update_idempotent1_task \
+        >> spanner_database_update_idempotent2_task \
+        >> spanner_instance_query_task \
+        >> spanner_instance_query2_task \
+        >> spanner_database_delete_task \
         >> spanner_instance_delete_task
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index 96e8bcb71c784..23f3a3c86d400 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -16,13 +16,14 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-from google.api_core.exceptions import GoogleAPICallError
+from google.api_core.exceptions import GoogleAPICallError, AlreadyExists
 from google.cloud.spanner_v1.client import Client
 from google.cloud.spanner_v1.database import Database
 from google.cloud.spanner_v1.instance import Instance  # noqa: F401
 from google.longrunning.operations_grpc_pb2 import Operation  # noqa: F401
 from typing import Optional, Callable  # noqa: F401
 
+from airflow import AirflowException
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 
@@ -41,11 +42,12 @@ def __init__(self,
     def get_client(self, project_id):
         # type: (str) -> Client
         """
-        Provides a client for interacting with Cloud Spanner API.
+        Provides a client for interacting with the Cloud Spanner API.
 
-        :param project_id: The ID of the project which owns the instances, tables and data.
+        :param project_id: The ID of the  GCP project that owns the Cloud Spanner
+            database.
         :type project_id: str
-        :return: Client for interacting with Cloud Spanner API. See:
+        :return: Client for interacting with the Cloud Spanner API. See:
             https://googleapis.github.io/google-cloud-python/latest/spanner/client-api.html#google.cloud.spanner_v1.client.Client
         :rtype: object
         """
@@ -58,16 +60,15 @@ def get_instance(self, project_id, instance_id):
         """
         Gets information about a particular instance.
 
-        :param project_id: The ID of the project which owns the instances, tables and data.
+        :param project_id: The ID of the project which owns the Cloud Spanner Database.
         :type project_id: str
-        :param instance_id: The ID of the instance.
+        :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :return: Representation of a Cloud Spanner Instance. See:
             https://googleapis.github.io/google-cloud-python/latest/spanner/instance-api.html#google.cloud.spanner_v1.instance.Instance
         :rtype: object
         """
-        client = self.get_client(project_id)
-        instance = client.instance(instance_id)
+        instance = self.get_client(project_id).instance(instance_id)
         if not instance.exists():
             return None
         return instance
@@ -78,21 +79,22 @@ def create_instance(self, project_id, instance_id, configuration_name, node_coun
         """
         Creates a new Cloud Spanner instance.
 
-        :param project_id: The ID of the project which owns the instances, tables and
-            data.
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
         :type project_id: str
-        :param instance_id: The ID of the instance.
+        :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
-        :param configuration_name: Name of the instance configuration defining how the
-            instance will be created. Required for instances which do not yet exist.
+        :param configuration_name: The name of the instance configuration defining how the
+            instance will be created. Possible configuration values can be retrieved via
+            https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list
         :type configuration_name: str
-        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :param node_count: (Optional) The number of nodes allocated to the Cloud Spanner
+            instance.
         :type node_count: int
-        :param display_name: (Optional) The display name for the instance in the Cloud
-            Console UI. (Must be between 4 and 30 characters.) If this value is not set
-            in the constructor, will fall back to the instance ID.
+        :param display_name: (Optional) The display name for the instance in the GCP
+            Console. Must be between 4 and 30 characters.  If this value is not set in
+            the constructor, the name falls back to the instance ID.
         :type display_name: str
-        :return: True if the operation succeeded, raises an exception otherwise.
+        :return: True if the operation succeeds. Otherwise,raises an exception.
         :rtype: bool
         """
         return self._apply_to_instance(project_id, instance_id, configuration_name,
@@ -104,21 +106,22 @@ def update_instance(self, project_id, instance_id, configuration_name, node_coun
         """
         Updates an existing Cloud Spanner instance.
 
-        :param project_id: The ID of the project which owns the instances, tables and
-            data.
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
         :type project_id: str
-        :param instance_id: The ID of the instance.
+        :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
-        :param configuration_name: Name of the instance configuration defining how the
-            instance will be created. Required for instances which do not yet exist.
+        :param configuration_name: The name of the instance configuration defining how the
+            instance will be created. Possible configuration values can be retrieved via
+            https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list
         :type configuration_name: str
-        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :param node_count: (Optional) The number of nodes allocated to the Cloud Spanner
+            instance.
         :type node_count: int
-        :param display_name: (Optional) The display name for the instance in the Cloud
-            Console UI. (Must be between 4 and 30 characters.) If this value is not set
-            in the constructor, will fall back to the instance ID.
+        :param display_name: (Optional) The display name for the instance in the GCP
+            Console. Must be between 4 and 30 characters. If this value is not set in
+            the constructor, the name falls back to the instance ID.
         :type display_name: str
-        :return: True if the operation succeeded, raises an exception otherwise.
+        :return: True if the operation succeeded. Otherwise, raises an exception.
         :rtype: bool
         """
         return self._apply_to_instance(project_id, instance_id, configuration_name,
@@ -130,8 +133,7 @@ def _apply_to_instance(self, project_id, instance_id, configuration_name, node_c
         """
         Invokes a method on a given instance by applying a specified Callable.
 
-        :param project_id: The ID of the project which owns the instances, tables and
-            data.
+        :param project_id: The ID of the project which owns the Cloud Spanner Database.
         :type project_id: str
         :param instance_id: The ID of the instance.
         :type instance_id: str
@@ -147,15 +149,13 @@ def _apply_to_instance(self, project_id, instance_id, configuration_name, node_c
         :param func: Method of the instance to be called.
         :type func: Callable
         """
-        client = self.get_client(project_id)
-        instance = client.instance(instance_id,
-                                   configuration_name=configuration_name,
-                                   node_count=node_count,
-                                   display_name=display_name)
+        instance = self.get_client(project_id).instance(
+            instance_id, configuration_name=configuration_name,
+            node_count=node_count, display_name=display_name)
         try:
             operation = func(instance)  # type: Operation
         except GoogleAPICallError as e:
-            self.log.error('An error occurred: %s. Aborting.', e.message)
+            self.log.error('An error occurred: %s. Exiting.', e.message)
             raise e
 
         if operation:
@@ -168,39 +168,175 @@ def delete_instance(self, project_id, instance_id):
         """
         Deletes an existing Cloud Spanner instance.
 
-        :param project_id: The ID of the project which owns the instances, tables and data.
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
         :type project_id: str
-        :param instance_id: The ID of the instance.
+        :param instance_id:  The ID of the Cloud Spanner instance.
         :type instance_id: str
         """
-        client = self.get_client(project_id)
-        instance = client.instance(instance_id)
+        instance = self.get_client(project_id).instance(instance_id)
         try:
             instance.delete()
             return True
         except GoogleAPICallError as e:
-            self.log.error('An error occurred: %s. Aborting.', e.message)
+            self.log.error('An error occurred: %s. Exiting.', e.message)
+            raise e
+
+    def get_database(self, project_id, instance_id, database_id):
+        # type: (str, str, str) -> Optional[Database]
+        """
+        Retrieves a database in Cloud Spanner. If the database does not exist
+        in the specified instance, it returns None.
+
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Spanner instance.
+        :type instance_id: str
+        :param database_id: The ID of the database in Cloud Spanner.
+        :type database_id: str
+        :return: Database object or None if database does not exist
+        :rtype: Union[Database, None]
+        """
+
+        instance = self.get_client(project_id=project_id).instance(
+            instance_id=instance_id)
+        if not instance.exists():
+            raise AirflowException("The instance {} does not exist in project {} !".
+                                   format(instance_id, project_id))
+        database = instance.database(database_id=database_id)
+        if not database.exists():
+            return None
+        else:
+            return database
+
+    def create_database(self, project_id, instance_id, database_id, ddl_statements):
+        # type: (str, str, str, [str]) -> bool
+        """
+        Creates a new database in Cloud Spanner.
+
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Spanner instance.
+        :type instance_id: str
+        :param database_id: The ID of the database to create in Cloud Spanner.
+        :type database_id: str
+        :param ddl_statements: The string list containing DDL for the new database.
+        :type ddl_statements: list[str]
+        :return: True if everything succeeded
+        :rtype: bool
+        """
+
+        instance = self.get_client(project_id=project_id).instance(
+            instance_id=instance_id)
+        if not instance.exists():
+            raise AirflowException("The instance {} does not exist in project {} !".
+                                   format(instance_id, project_id))
+        database = instance.database(database_id=database_id,
+                                     ddl_statements=ddl_statements)
+        try:
+            operation = database.create()  # type: Operation
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Exiting.', e.message)
             raise e
 
+        if operation:
+            result = operation.result()
+            self.log.info(result)
+        return True
+
+    def update_database(self, project_id, instance_id, database_id, ddl_statements,
+                        operation_id=None):
+        # type: (str, str, str, [str], str) -> bool
+        """
+        Updates DDL of a database in Cloud Spanner.
+
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Spanner instance.
+        :type instance_id: str
+        :param database_id: The ID of the database in Cloud Spanner.
+        :type database_id: str
+        :param ddl_statements: The string list containing DDL for the new database.
+        :type ddl_statements: list[str]
+        :param operation_id: (Optional) The unique per database operation ID that can be
+            specified to implement idempotency check.
+        :type operation_id: str
+        :return: True if everything succeeded
+        :rtype: bool
+        """
+
+        instance = self.get_client(project_id=project_id).instance(
+            instance_id=instance_id)
+        if not instance.exists():
+            raise AirflowException("The instance {} does not exist in project {} !".
+                                   format(instance_id, project_id))
+        database = instance.database(database_id=database_id)
+        try:
+            operation = database.update_ddl(
+                ddl_statements, operation_id=operation_id)
+            if operation:
+                result = operation.result()
+                self.log.info(result)
+            return True
+        except AlreadyExists as e:
+            if e.code == 409 and operation_id in e.message:
+                self.log.info("Replayed update_ddl message - the operation id %s "
+                              "was already done before.", operation_id)
+                return True
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Exiting.', e.message)
+            raise e
+
+    def delete_database(self, project_id, instance_id, database_id):
+        # type: (str, str, str) -> bool
+        """
+        Drops a database in Cloud Spanner.
+
+        :param project_id:  The ID of the GCP project that owns the Cloud Spanner
+            database.
+        :type project_id: str
+        :param instance_id: The ID of the Cloud Spanner instance.
+        :type instance_id: str
+        :param database_id: The ID of the database in Cloud Spanner.
+        :type database_id: str
+        :return: True if everything succeeded
+        :rtype: bool
+        """
+
+        instance = self.get_client(project_id=project_id).\
+            instance(instance_id=instance_id)
+        if not instance.exists():
+            raise AirflowException("The instance {} does not exist in project {} !".
+                                   format(instance_id, project_id))
+        database = instance.database(database_id=database_id)
+        try:
+            operation = database.drop()  # type: Operation
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Exiting.', e.message)
+            raise e
+
+        if operation:
+            result = operation.result()
+            self.log.info(result)
+        return True
+
     def execute_dml(self, project_id, instance_id, database_id, queries):
         # type: (str, str, str, str) -> None
         """
         Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
-        :param project_id: The ID of the project which owns the instances, tables and data.
+        :param project_id: The ID of the GCP project that owns the Cloud Spanner
+            database.
         :type project_id: str
-        :param instance_id: The ID of the instance.
+        :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
-        :param database_id: The ID of the database.
+        :param database_id: The ID of the database in Cloud Spanner.
         :type database_id: str
-        :param queries: The queries to be executed.
+        :param queries: The queries to execute.
         :type queries: str
         """
-        client = self.get_client(project_id)
-        instance = client.instance(instance_id)
-        database = Database(database_id, instance)
-        database.run_in_transaction(lambda transaction:
-                                    self._execute_sql_in_transaction(transaction, queries))
+        instance = self.get_client(project_id).instance(instance_id)
+        Database(database_id, instance).run_in_transaction(
+            lambda transaction: self._execute_sql_in_transaction(transaction, queries))
 
     @staticmethod
     def _execute_sql_in_transaction(transaction, queries):
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index b803fcc30ac15..8ea08ea0cf46c 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -26,21 +26,23 @@
 
 class CloudSpannerInstanceDeployOperator(BaseOperator):
     """
-    Creates a new Cloud Spanner instance or, if an instance with the same instance_id
-    exists in the specified project, updates it.
+    Creates a new Cloud Spanner instance, or if an instance with the same instance_id
+    exists in the specified project, updates the Cloud Spanner instance.
 
-    :param project_id: The ID of the project which owns the instances, tables and data.
+    :param project_id: The ID of the project which owns the Cloud Spanner Database.
     :type project_id: str
     :param instance_id: Cloud Spanner instance ID.
     :type instance_id: str
-    :param configuration_name: Name of the instance configuration defining
-        how the instance will be created. Required for instances which do not yet exist.
+    :param configuration_name:  The name of the Cloud Spanner instance configuration
+      defining how the instance will be created. Required for
+      instances that do not yet exist.
     :type configuration_name: str
-    :param node_count: (Optional) Number of nodes allocated to the instance.
+    :param node_count: (Optional) The number of nodes allocated to the Cloud Spanner
+      instance.
     :type node_count: int
-    :param display_name: (Optional) The display name for the instance in the
-        Cloud Console UI. (Must be between 4 and 30 characters.) If this value is not
-        set in the constructor, will fall back to the instance ID.
+    :param display_name: (Optional) The display name for the Cloud Spanner  instance in
+      the GCP Console. (Must be between 4 and 30 characters.) If this value is not set
+      in the constructor, the name is the same as the instance ID.
     :type display_name: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
@@ -91,12 +93,12 @@ def execute(self, context):
 
 class CloudSpannerInstanceDeleteOperator(BaseOperator):
     """
-    Deletes a Cloud Spanner instance.
-    If an instance does not exist, no action will be taken and the operator will succeed.
+    Deletes a Cloud Spanner instance. If an instance does not exist,
+    no action is taken and the operator succeeds.
 
-    :param project_id: The ID of the project which owns the instances, tables and data.
+    :param project_id: The ID of the project that owns the Cloud Spanner Database.
     :type project_id: str
-    :param instance_id: Cloud Spanner instance ID.
+    :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
@@ -138,13 +140,14 @@ class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
     """
     Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
-    :param project_id: The ID of the project which owns the instances, tables and data.
+    :param project_id: The ID of the project that owns the Cloud Spanner Database.
     :type project_id: str
-    :param instance_id: The ID of the instance.
+    :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
-    :param database_id: The ID of the database.
+    :param database_id: The Cloud Spanner database ID.
     :type database_id: str
-    :param query: The query or list of queries to be executed. Can be a path to a SQL file.
+    :param query: The query or list of queries to be executed. Can be a path to a SQL
+       file.
     :type query: str or list
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
@@ -197,3 +200,195 @@ def execute(self, context):
     def sanitize_queries(queries):
         if len(queries) and queries[-1] == '':
             del queries[-1]
+
+
+class CloudSpannerInstanceDatabaseDeployOperator(BaseOperator):
+    """
+    Creates a new Cloud Spanner database, or if database exists,
+    the operator does nothing.
+
+    :param project_id: The ID of the project that owns the Cloud Spanner Database.
+    :type project_id: str
+    :param instance_id: The Cloud Spanner instance ID.
+    :type instance_id: str
+    :param database_id: The Cloud Spanner database ID.
+    :type database_id: str
+    :param ddl_statements: The string list containing DDL for the new database.
+    :type ddl_statements: list of str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_database_deploy_template_fields]
+    template_fields = ('project_id', 'instance_id', 'database_id', 'ddl_statements',
+                       'gcp_conn_id')
+    template_ext = ('.sql', )
+    # [END gcp_spanner_database_deploy_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 database_id,
+                 ddl_statements,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.database_id = database_id
+        self.ddl_statements = ddl_statements
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDatabaseDeployOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+        if not self.database_id:
+            raise AirflowException("The required parameter 'database_id' is empty")
+        if not self.ddl_statements:
+            raise AirflowException("The required parameter 'ddl_statements' is empty")
+
+    def execute(self, context):
+        if not self._hook.get_database(self.project_id,
+                                       self.instance_id,
+                                       self.database_id):
+            self.log.info("Creating Cloud Spanner database "
+                          "'%s' in project '%s' and instance '%s'",
+                          self.database_id, self.project_id, self.instance_id)
+            return self._hook.create_database(project_id=self.project_id,
+                                              instance_id=self.instance_id,
+                                              database_id=self.database_id,
+                                              ddl_statements=self.ddl_statements)
+        else:
+            self.log.info("The database '%s' in project '%s' and instance '%s'"
+                          " already exists. Nothing to do. Exiting.",
+                          self.database_id, self.project_id, self.instance_id)
+        return True
+
+
+class CloudSpannerInstanceDatabaseUpdateOperator(BaseOperator):
+    """
+    Updates a Cloud Spanner database with the specified DDL statement.
+
+    :param project_id: The ID of the project that owns the the Cloud Spanner Database.
+    :type project_id: str
+    :param instance_id: The Cloud Spanner instance ID.
+    :type instance_id: str
+    :param database_id: The Cloud Spanner database ID.
+    :type database_id: str
+    :param ddl_statements: The string list containing DDL to apply to the database.
+    :type ddl_statements: list[str]
+    :param operation_id: (Optional) Unique per database operation id that can
+           be specified to implement idempotency check.
+    :type operation_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_database_update_template_fields]
+    template_fields = ('project_id', 'instance_id', 'database_id', 'ddl_statements',
+                       'gcp_conn_id')
+    template_ext = ('.sql', )
+    # [END gcp_spanner_database_update_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 database_id,
+                 ddl_statements,
+                 operation_id=None,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.database_id = database_id
+        self.ddl_statements = ddl_statements
+        self.operation_id = operation_id
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDatabaseUpdateOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+        if not self.database_id:
+            raise AirflowException("The required parameter 'database_id' is empty")
+        if not self.ddl_statements:
+            raise AirflowException("The required parameter 'ddl_statements' is empty")
+
+    def execute(self, context):
+        if not self._hook.get_database(self.project_id,
+                                       self.instance_id,
+                                       self.database_id):
+            raise AirflowException("The Cloud Spanner database "
+                                   "'%s' in project '%s' and instance '%s' is missing."
+                                   " Create the database first before you can update it.",
+                                   self.database_id, self.project_id, self.instance_id)
+        else:
+            return self._hook.update_database(project_id=self.project_id,
+                                              instance_id=self.instance_id,
+                                              database_id=self.database_id,
+                                              ddl_statements=self.ddl_statements,
+                                              operation_id=self.operation_id)
+
+
+class CloudSpannerInstanceDatabaseDeleteOperator(BaseOperator):
+    """
+    Deletes a Cloud Spanner database.
+
+    :param project_id: The ID of the project that owns the Cloud Spanner Database.
+    :type project_id: str
+    :param instance_id: Cloud Spanner instance ID.
+    :type instance_id: str
+    :param database_id: Cloud Spanner database ID.
+    :type database_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+    # [START gcp_spanner_database_delete_template_fields]
+    template_fields = ('project_id', 'instance_id', 'database_id',
+                       'gcp_conn_id')
+    # [END gcp_spanner_database_delete_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance_id,
+                 database_id,
+                 gcp_conn_id='google_cloud_default',
+                 *args, **kwargs):
+        self.instance_id = instance_id
+        self.project_id = project_id
+        self.database_id = database_id
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+        self._hook = CloudSpannerHook(gcp_conn_id=gcp_conn_id)
+        super(CloudSpannerInstanceDatabaseDeleteOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.project_id:
+            raise AirflowException("The required parameter 'project_id' is empty")
+        if not self.instance_id:
+            raise AirflowException("The required parameter 'instance_id' is empty")
+        if not self.database_id:
+            raise AirflowException("The required parameter 'database_id' is empty")
+
+    def execute(self, context):
+        db = self._hook.get_database(self.project_id,
+                                     self.instance_id,
+                                     self.database_id)
+        if not db:
+            self.log.info("The Cloud Spanner database was missing: "
+                          "'%s' in project '%s' and instance '%s'. Assuming success.",
+                          self.database_id, self.project_id, self.instance_id)
+            return True
+        else:
+            return self._hook.delete_database(project_id=self.project_id,
+                                              instance_id=self.instance_id,
+                                              database_id=self.database_id)
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index e9aade62957cf..aaa27e6a1484a 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -661,21 +661,117 @@ More information
 
 See `Google Cloud Functions API documentation <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_
 
-Google Cloud Sql Operators
---------------------------
+Google Cloud Spanner Operators
+------------------------------
 
-CloudSpannerInstanceDatabaseQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudSpannerInstanceDatabaseDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+Deletes a database from the specified Cloud Spanner instance. If the database does not
+exist, no action is taken, and the operator succeeds.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_delete]
+    :end-before: [END howto_operator_spanner_database_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_delete_template_fields]
+    :end-before: [END gcp_spanner_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Spanner API documentation for database drop call
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/dropDatabase>`_.
+
+
+CloudSpannerInstanceDatabaseDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new Cloud Spanner database in the specified instance, or if the
+desired database exists, assumes success with no changes applied to database
+configuration. No structure of the database is verified - it's enough if the database exists
+with the same name.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_deploy]
+    :end-before: [END howto_operator_spanner_database_deploy]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_database_deploy_template_fields]
+    :end-before: [END gcp_spanner_database_deploy_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for `database create
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_
+
+CloudSpannerInstanceDatabaseUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Runs a DDL query in a Cloud Spanner database and allows you to modify the structure of an
+existing database.
+
+You can optionally specify an operation_id parameter which simplifies determining whether
+the statements were executed in case the update_database call is replayed
+(idempotency check). The operation_id should be unique within the database, and must be
+a valid identifier: `[a-z][a-z0-9_]*`. More information can be found in
+`the documentation of updateDdl API <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_
 
 For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`.
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator`.
 
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from environment variables:
+Some arguments in the example DAG are taken from environment variables.
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
@@ -688,37 +784,36 @@ Using the operator
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_spanner_query]
-    :end-before: [END howto_operator_spanner_query]
+    :start-after: [START howto_operator_spanner_database_update]
+    :end-before: [END howto_operator_spanner_database_update]
 
 Templating
 """"""""""
 
 .. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_spanner_query_template_fields]
-  :end-before: [END gcp_spanner_query_template_fields]
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_database_update_template_fields]
+    :end-before: [END gcp_spanner_database_update_template_fields]
 
 More information
 """"""""""""""""
 
-See Google Cloud Spanner API documentation for `the DML syntax
-<https://cloud.google.com/spanner/docs/dml-syntax>`_.
+See Google Cloud Spanner API documentation for `database update_ddl
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_.
 
-CloudSpannerInstanceDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudSpannerInstanceDatabaseQueryOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Creates a new Cloud Spanner instance or, if an instance with the same name exists,
-updates it.
+Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
 For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator`.
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`.
 
 Arguments
 """""""""
 
-Some arguments in the example DAG are taken from environment variables:
+Some arguments in the example DAG are taken from environment variables.
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
@@ -731,31 +826,29 @@ Using the operator
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_spanner_deploy]
-    :end-before: [END howto_operator_spanner_deploy]
+    :start-after: [START howto_operator_spanner_query]
+    :end-before: [END howto_operator_spanner_query]
 
 Templating
 """"""""""
 
 .. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_spanner_deploy_template_fields]
-  :end-before: [END gcp_spanner_deploy_template_fields]
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_query_template_fields]
+    :end-before: [END gcp_spanner_query_template_fields]
 
 More information
 """"""""""""""""
 
-See Google Cloud Spanner API documentation for instance `create
-<https://cloud.google.com/spanner/docs/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance>`_
-and `update
-<https://cloud.google.com/spanner/docs/reference/rpc/google.spanner.admin.instance.v1#google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance>`_.
+See Google Cloud Spanner API documentation for `the DML syntax
+<https://cloud.google.com/spanner/docs/dml-syntax>`_.
 
 CloudSpannerInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Deletes a Cloud Spanner instance.
-If an instance does not exist, no action will be taken and the operator will succeed.
+Deletes a Cloud Spanner instance. If an instance does not exist, no action is taken,
+and the operator succeeds.
 
 For parameter definition take a look at
 :class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator`.
@@ -794,6 +887,9 @@ More information
 See `Google Cloud Spanner API documentation for instance delete
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/delete>`_.
 
+Google Cloud Sql Operators
+--------------------------
+
 CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/integration.rst b/docs/integration.rst
index 6a051134d891d..284c372d47454 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -663,11 +663,38 @@ Cloud Spanner
 Cloud Spanner Operators
 """""""""""""""""""""""
 
+- :ref:`CloudSpannerInstanceDatabaseDeleteOperator` : deletes an existing database from
+  a Google Cloud Spanner instance or returns success if the database is missing.
+- :ref:`CloudSpannerInstanceDatabaseDeployOperator` : creates a new database in a Google
+  Cloud instance or returns success if the database already exists.
+- :ref:`CloudSpannerInstanceDatabaseUpdateOperator` : updates the structure of a
+  Google Cloud Spanner database.
 - :ref:`CloudSpannerInstanceDatabaseQueryOperator` : executes an arbitrary DML query
   (INSERT, UPDATE, DELETE).
-- :ref:`CloudSpannerInstanceDeployOperator` : creates a new Cloud Spanner instance or,
-  if an instance with the same name exists, updates it.
-- :ref:`CloudSpannerInstanceDeleteOperator` : deletes a Cloud Spanner instance.
+- :ref:`CloudSpannerInstanceDeployOperator` : creates a new Google Cloud Spanner instance,
+  or if an instance with the same name exists, updates the instance.
+- :ref:`CloudSpannerInstanceDeleteOperator` : deletes a Google Cloud Spanner instance.
+
+.. _CloudSpannerInstanceDatabaseDeleteOperator:
+
+CloudSpannerInstanceDatabaseDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
+
+.. _CloudSpannerInstanceDatabaseDeployOperator:
+
+CloudSpannerInstanceDatabaseDeployOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
+
+.. _CloudSpannerInstanceDatabaseUpdateOperator:
+
+CloudSpannerInstanceDatabaseUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
 
 .. _CloudSpannerInstanceDatabaseQueryOperator:
 
@@ -690,6 +717,14 @@ CloudSpannerInstanceDeleteOperator
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
 
+
+CloudSpannerHook
+""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
+    :members:
+
+
 Cloud SQL
 '''''''''
 
diff --git a/setup.py b/setup.py
index c650567742d01..f01a360dce59e 100644
--- a/setup.py
+++ b/setup.py
@@ -191,7 +191,7 @@ def write_version(filename=os.path.join(*['airflow',
     'google-auth-httplib2>=0.0.1',
     'google-cloud-container>=0.1.1',
     'google-cloud-bigtable==0.31.0',
-    'google-cloud-spanner>=1.6.0',
+    'google-cloud-spanner>=1.7.1',
     'grpcio-gcp>=0.2.2',
     'PyOpenSSL',
     'pandas-gbq'
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
index 38ae985f26947..525f79647126f 100644
--- a/tests/contrib/operators/test_gcp_spanner_operator.py
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -23,7 +23,8 @@
 from airflow import AirflowException
 from airflow.contrib.operators.gcp_spanner_operator import \
     CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator, \
-    CloudSpannerInstanceDatabaseQueryOperator
+    CloudSpannerInstanceDatabaseQueryOperator, CloudSpannerInstanceDatabaseDeployOperator, \
+    CloudSpannerInstanceDatabaseDeleteOperator, CloudSpannerInstanceDatabaseUpdateOperator
 from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
     SKIP_TEST_WARNING, GCP_SPANNER_KEY
 
@@ -46,7 +47,7 @@
 INSERT_QUERY_2 = "INSERT my_table2 (id, name) VALUES (1, 'One')"
 CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
 CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
-QUERY_TYPE = "DML"
+DDL_STATEMENTS = [CREATE_QUERY, CREATE_QUERY_2]
 
 
 class CloudSpannerTest(unittest.TestCase):
@@ -240,6 +241,171 @@ def test_instance_query_dml_list(self, mock_hook):
             PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY, INSERT_QUERY_2]
         )
 
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_create(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = None
+        op = CloudSpannerInstanceDatabaseDeployOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_called_once_with(
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID, database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS
+        )
+        mock_hook.return_value.update_database.assert_not_called()
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_create_with_pre_existing_db(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = {"name": DB_ID}
+        op = CloudSpannerInstanceDatabaseDeployOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_not_called()
+        mock_hook.return_value.update_database.assert_not_called()
+        self.assertTrue(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, DB_ID, DDL_STATEMENTS, 'project_id'),
+        (PROJECT_ID, "", DB_ID, DDL_STATEMENTS, 'instance_id'),
+        (PROJECT_ID, INSTANCE_ID, "", DDL_STATEMENTS, 'database_id'),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_create_ex_if_param_missing(self,
+                                                 project_id, instance_id,
+                                                 database_id, ddl_statements,
+                                                 exp_msg, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDatabaseDeployOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                database_id=database_id,
+                ddl_statements=ddl_statements,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_update(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = {"name": DB_ID}
+        op = CloudSpannerInstanceDatabaseUpdateOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.update_database.assert_called_once_with(
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID, database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS, operation_id=None
+        )
+        self.assertTrue(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, DB_ID, DDL_STATEMENTS, 'project_id'),
+        (PROJECT_ID, "", DB_ID, DDL_STATEMENTS, 'instance_id'),
+        (PROJECT_ID, INSTANCE_ID, "", DDL_STATEMENTS, 'database_id'),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_update_ex_if_param_missing(self, project_id, instance_id,
+                                                 database_id, ddl_statements,
+                                                 exp_msg, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDatabaseUpdateOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                database_id=database_id,
+                ddl_statements=ddl_statements,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_update_ex_if_database_not_exist(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            op = CloudSpannerInstanceDatabaseUpdateOperator(
+                project_id=PROJECT_ID,
+                instance_id=INSTANCE_ID,
+                database_id=DB_ID,
+                ddl_statements=DDL_STATEMENTS,
+                task_id="id"
+            )
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The Cloud Spanner database 'db1' in project 'project-id' and "
+                      "instance 'instance-id' is missing", str(err))
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_delete(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = {"name": DB_ID}
+        op = CloudSpannerInstanceDatabaseDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_called_once_with(
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID, database_id=DB_ID
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_delete_exits_and_succeeds_if_database_does_not_exist(self,
+                                                                           mock_hook):
+        mock_hook.return_value.get_database.return_value = None
+        op = CloudSpannerInstanceDatabaseDeleteOperator(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_not_called()
+        self.assertTrue(result)
+
+    @parameterized.expand([
+        ("", INSTANCE_ID, DB_ID, DDL_STATEMENTS, 'project_id'),
+        (PROJECT_ID, "", DB_ID, DDL_STATEMENTS, 'instance_id'),
+        (PROJECT_ID, INSTANCE_ID, "", DDL_STATEMENTS, 'database_id'),
+    ])
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_delete_ex_if_param_missing(self, project_id, instance_id,
+                                                 database_id, ddl_statements,
+                                                 exp_msg, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            CloudSpannerInstanceDatabaseDeleteOperator(
+                project_id=project_id,
+                instance_id=instance_id,
+                database_id=database_id,
+                ddl_statements=ddl_statements,
+                task_id="id"
+            )
+        err = cm.exception
+        self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
+        mock_hook.assert_not_called()
+
 
 @unittest.skipIf(
     BaseGcpIntegrationTestCase.skip_check(GCP_SPANNER_KEY), SKIP_TEST_WARNING)

From c184da85d4cfd4fe2e95c42518c6700a7cdb4108 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 25 Nov 2018 21:44:07 +0000
Subject: [PATCH 330/808] [AIRFLOW-1196][AIRFLOW-2399] Add templated field in
 TriggerDagRunOperator (#4228)

* [AIRFLOW-1196][AIRFLOW-2399] Make trigger_dag_id a templated field for TriggerDagRunOperator

* Update dagrun_operator.py
---
 airflow/operators/dagrun_operator.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/operators/dagrun_operator.py b/airflow/operators/dagrun_operator.py
index 53814af41024d..8d339894f444e 100644
--- a/airflow/operators/dagrun_operator.py
+++ b/airflow/operators/dagrun_operator.py
@@ -35,7 +35,7 @@ class TriggerDagRunOperator(BaseOperator):
     """
     Triggers a DAG run for a specified ``dag_id``
 
-    :param trigger_dag_id: the dag_id to trigger
+    :param trigger_dag_id: the dag_id to trigger (templated)
     :type trigger_dag_id: str
     :param python_callable: a reference to a python function that will be
         called while passing it the ``context`` object and a placeholder
@@ -50,7 +50,7 @@ class TriggerDagRunOperator(BaseOperator):
     :param execution_date: Execution date for the dag
     :type execution_date: datetime.datetime
     """
-    template_fields = tuple()
+    template_fields = ('trigger_dag_id',)
     template_ext = tuple()
     ui_color = '#ffefeb'
 

From 9af4770c6a4822ff08626d651bccc037aee8c543 Mon Sep 17 00:00:00 2001
From: aoen <aoen@users.noreply.github.com>
Date: Mon, 31 Dec 2018 08:31:11 +0200
Subject: [PATCH 331/808] [AIRFLOW-3581] Fix next_ds/prev_ds semantics for
 manual runs (#4385)

---
 UPDATING.md       |  4 ++++
 airflow/models.py | 46 +++++++++++++++++++++++++++-------------------
 tests/core.py     | 32 ++++++++++++++++++++++++++++++++
 3 files changed, 63 insertions(+), 19 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index de68e065aad69..45ab7dc96942c 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -31,6 +31,10 @@ Examples:
   * `ts_nodash`: `20150101T000000`
   * `ts_nodash_with_tz`: `20150101T000000+0000`
 
+### Semantics of next_ds/prev_ds changed for manually triggered runs
+
+next_ds/prev_ds now map to execution_date instead of the next/previous schedule-aligned execution date for DAGs triggered in the UI.
+
 ### User model changes
 This patch changes the `User.superuser` field from a hardcoded boolean to a `Boolean()` database column. `User.superuser` will default to `False`, which means that this privilege will have to be granted manually to any users that may require it.
 
diff --git a/airflow/models.py b/airflow/models.py
index e7dd02a78eb17..484dd821c4fbb 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1849,13 +1849,38 @@ def get_template_context(self, session=None):
         if 'tables' in task.params:
             tables = task.params['tables']
 
+        params = {}
+        run_id = ''
+        dag_run = None
+        if hasattr(task, 'dag'):
+            if task.dag.params:
+                params.update(task.dag.params)
+            dag_run = (
+                session.query(DagRun)
+                .filter_by(
+                    dag_id=task.dag.dag_id,
+                    execution_date=self.execution_date)
+                .first()
+            )
+            run_id = dag_run.run_id if dag_run else None
+            session.expunge_all()
+            session.commit()
+
         ds = self.execution_date.strftime('%Y-%m-%d')
         ts = self.execution_date.isoformat()
         yesterday_ds = (self.execution_date - timedelta(1)).strftime('%Y-%m-%d')
         tomorrow_ds = (self.execution_date + timedelta(1)).strftime('%Y-%m-%d')
 
-        prev_execution_date = task.dag.previous_schedule(self.execution_date)
-        next_execution_date = task.dag.following_schedule(self.execution_date)
+        # For manually triggered dagruns that aren't run on a schedule, next/previous
+        # schedule dates don't make sense, and should be set to execution date for
+        # consistency with how execution_date is set for manually triggered tasks, i.e.
+        # triggered_date == execution_date.
+        if dag_run and dag_run.external_trigger:
+            prev_execution_date = self.execution_date
+            next_execution_date = self.execution_date
+        else:
+            prev_execution_date = task.dag.previous_schedule(self.execution_date)
+            next_execution_date = task.dag.following_schedule(self.execution_date)
 
         next_ds = None
         next_ds_nodash = None
@@ -1878,23 +1903,6 @@ def get_template_context(self, session=None):
         ti_key_str = "{task.dag_id}__{task.task_id}__{ds_nodash}"
         ti_key_str = ti_key_str.format(**locals())
 
-        params = {}
-        run_id = ''
-        dag_run = None
-        if hasattr(task, 'dag'):
-            if task.dag.params:
-                params.update(task.dag.params)
-            dag_run = (
-                session.query(DagRun)
-                .filter_by(
-                    dag_id=task.dag.dag_id,
-                    execution_date=self.execution_date)
-                .first()
-            )
-            run_id = dag_run.run_id if dag_run else None
-            session.expunge_all()
-            session.commit()
-
         if task.params:
             params.update(task.params)
 
diff --git a/tests/core.py b/tests/core.py
index ef8c9497e7ea0..2df021412d4d3 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1023,6 +1023,38 @@ def payload_generator(context, object):
         dag_run = dag_runs[0]
         self.assertEquals(dag_run.execution_date, utc_now)
 
+    def test_externally_triggered_dagrun(self):
+        TI = models.TaskInstance
+
+        # Create the dagrun between two "scheduled" execution dates of the DAG
+        EXECUTION_DATE = DEFAULT_DATE + timedelta(days=2)
+        EXECUTION_DS = EXECUTION_DATE.strftime('%Y-%m-%d')
+        EXECUTION_DS_NODASH = EXECUTION_DS.replace('-', '')
+
+        dag = DAG(
+            TEST_DAG_ID,
+            default_args=self.args,
+            schedule_interval=timedelta(weeks=1),
+            start_date=DEFAULT_DATE)
+        task = DummyOperator(task_id='test_externally_triggered_dag_context',
+                             dag=dag)
+        dag.create_dagrun(run_id=models.DagRun.id_for_date(EXECUTION_DATE),
+                          execution_date=EXECUTION_DATE,
+                          state=State.RUNNING,
+                          external_trigger=True)
+        task.run(
+            start_date=EXECUTION_DATE, end_date=EXECUTION_DATE)
+
+        ti = TI(task=task, execution_date=EXECUTION_DATE)
+        context = ti.get_template_context()
+
+        # next_ds/prev_ds should be the execution date for manually triggered runs
+        self.assertEquals(context['next_ds'], EXECUTION_DS)
+        self.assertEquals(context['next_ds_nodash'], EXECUTION_DS_NODASH)
+
+        self.assertEquals(context['prev_ds'], EXECUTION_DS)
+        self.assertEquals(context['prev_ds_nodash'], EXECUTION_DS_NODASH)
+
 
 class CliTests(unittest.TestCase):
 

From a22462625324707ed754a16fd3a0f2979668bca5 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 5 Jan 2019 02:17:45 +0000
Subject: [PATCH 332/808] [AIRFLOW-3150] Make execution_date templated in
 TriggerDagRunOperator (#4359)

---
 airflow/operators/dagrun_operator.py | 28 ++++++++++++++++----
 tests/core.py                        | 38 +++++++++++++++++++++++++++-
 2 files changed, 60 insertions(+), 6 deletions(-)

diff --git a/airflow/operators/dagrun_operator.py b/airflow/operators/dagrun_operator.py
index 8d339894f444e..7000c6c90bc18 100644
--- a/airflow/operators/dagrun_operator.py
+++ b/airflow/operators/dagrun_operator.py
@@ -17,6 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import datetime
+import six
 from airflow.models import BaseOperator
 from airflow.utils import timezone
 from airflow.utils.decorators import apply_defaults
@@ -47,10 +49,10 @@ class TriggerDagRunOperator(BaseOperator):
         to your tasks while executing that DAG run. Your function header
         should look like ``def foo(context, dag_run_obj):``
     :type python_callable: python callable
-    :param execution_date: Execution date for the dag
-    :type execution_date: datetime.datetime
+    :param execution_date: Execution date for the dag (templated)
+    :type execution_date: str or datetime.datetime
     """
-    template_fields = ('trigger_dag_id',)
+    template_fields = ('trigger_dag_id', 'execution_date')
     template_ext = tuple()
     ui_color = '#ffefeb'
 
@@ -64,10 +66,26 @@ def __init__(
         super(TriggerDagRunOperator, self).__init__(*args, **kwargs)
         self.python_callable = python_callable
         self.trigger_dag_id = trigger_dag_id
-        self.execution_date = execution_date
+
+        if isinstance(execution_date, datetime.datetime):
+            self.execution_date = execution_date.isoformat()
+        elif isinstance(execution_date, six.string_types):
+            self.execution_date = execution_date
+        elif execution_date is None:
+            self.execution_date = execution_date
+        else:
+            raise TypeError(
+                'Expected str or datetime.datetime type '
+                'for execution_date. Got {}'.format(
+                    type(execution_date)))
 
     def execute(self, context):
-        dro = DagRunOrder(run_id='trig__' + timezone.utcnow().isoformat())
+        if self.execution_date is not None:
+            run_id = 'trig__{}'.format(self.execution_date)
+            self.execution_date = timezone.parse(self.execution_date)
+        else:
+            run_id = 'trig__' + timezone.utcnow().isoformat()
+        dro = DagRunOrder(run_id=run_id)
         if self.python_callable is not None:
             dro = self.python_callable(context, dro)
         if dro:
diff --git a/tests/core.py b/tests/core.py
index 2df021412d4d3..fd0d803eee074 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -44,7 +44,7 @@
 
 from airflow import configuration
 from airflow.executors import SequentialExecutor
-from airflow.models import Variable
+from airflow.models import Variable, TaskInstance
 
 configuration.conf.load_test_config()  # NOQA: E402
 from airflow import jobs, models, DAG, utils, macros, settings, exceptions
@@ -1023,6 +1023,42 @@ def payload_generator(context, object):
         dag_run = dag_runs[0]
         self.assertEquals(dag_run.execution_date, utc_now)
 
+    def test_trigger_dagrun_with_str_execution_date(self):
+        utc_now_str = timezone.utcnow().isoformat()
+        self.assertIsInstance(utc_now_str, six.string_types)
+        run_id = 'trig__' + utc_now_str
+
+        def payload_generator(context, object):
+            object.run_id = run_id
+            return object
+
+        task = TriggerDagRunOperator(
+            task_id='test_trigger_dagrun_with_str_execution_date',
+            trigger_dag_id='example_bash_operator',
+            python_callable=payload_generator,
+            execution_date=utc_now_str,
+            dag=self.dag)
+        task.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+        dag_runs = models.DagRun.find(dag_id='example_bash_operator',
+                                      run_id=run_id)
+        self.assertEquals(len(dag_runs), 1)
+        dag_run = dag_runs[0]
+        self.assertEquals(dag_run.execution_date.isoformat(), utc_now_str)
+
+    def test_trigger_dagrun_with_templated_execution_date(self):
+        task = TriggerDagRunOperator(
+            task_id='test_trigger_dagrun_with_str_execution_date',
+            trigger_dag_id='example_bash_operator',
+            execution_date='{{ execution_date }}',
+            dag=self.dag)
+
+        self.assertTrue(isinstance(task.execution_date, six.string_types))
+        self.assertEqual(task.execution_date, '{{ execution_date }}')
+
+        ti = TaskInstance(task=task, execution_date=DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(timezone.parse(task.execution_date), DEFAULT_DATE)
+
     def test_externally_triggered_dagrun(self):
         TI = models.TaskInstance
 

From 2420dbc7aa11e7536b340d98c5ffd87dabee906b Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 5 Jan 2019 13:15:56 +0000
Subject: [PATCH 333/808] [AIRFLOW-3634] Fix GCP Spanner Test (#4440)

---
 airflow/contrib/operators/gcp_spanner_operator.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index 8ea08ea0cf46c..1cb4c7d47f069 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -326,10 +326,11 @@ def execute(self, context):
         if not self._hook.get_database(self.project_id,
                                        self.instance_id,
                                        self.database_id):
-            raise AirflowException("The Cloud Spanner database "
-                                   "'%s' in project '%s' and instance '%s' is missing."
-                                   " Create the database first before you can update it.",
-                                   self.database_id, self.project_id, self.instance_id)
+            raise AirflowException("The Cloud Spanner database '{}' in project '{}' and "
+                                   "instance '{}' is missing. Create the database first "
+                                   "before you can update it.".format(self.database_id,
+                                                                      self.project_id,
+                                                                      self.instance_id))
         else:
             return self._hook.update_database(project_id=self.project_id,
                                               instance_id=self.instance_id,

From 6c4e9407f28978ba646bcdd21f080d6af22a4007 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 5 Sep 2018 01:04:42 +0100
Subject: [PATCH 334/808] [AIRFLOW-3005] Replace 'Airbnb Airflow' with 'Apache
 Airflow' (#3845)

---
 airflow/contrib/example_dags/example_twitter_README.md | 2 +-
 airflow/models.py                                      | 3 +--
 airflow/operators/slack_operator.py                    | 4 ++--
 docs/scheduler.rst                                     | 2 +-
 tests/jobs.py                                          | 2 --
 tests/sensors/test_http_sensor.py                      | 6 +++---
 6 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/example_dags/example_twitter_README.md b/airflow/contrib/example_dags/example_twitter_README.md
index 28ae9826f1f06..0876bdb4d161a 100644
--- a/airflow/contrib/example_dags/example_twitter_README.md
+++ b/airflow/contrib/example_dags/example_twitter_README.md
@@ -50,6 +50,6 @@ CREATE TABLE toTwitter_A(id BIGINT, id_str STRING
 ```
 When you review the code for the DAG, you will notice that these tasks are generated using for loop. These two for loops could be combined into one loop. However, in most cases, you will be running different analysis on your incoming incoming and outgoing tweets, and hence they are kept separated in this example.
 Final step is a running the broker script, brokerapi.py, which will run queries in Hive and store the summarized data to MySQL in our case. To connect to Hive, pyhs2 library is extremely useful and easy to use. To insert data into MySQL from Python, sqlalchemy is also a good one to use.
-I hope you find this tutorial useful. If you have question feel free to ask me on [Twitter](https://twitter.com/EkhtiarSyed) or via the live Airflow chatroom room in [Gitter](https://gitter.im/airbnb/airflow).<p>
+I hope you find this tutorial useful. If you have question feel free to ask me on [Twitter](https://twitter.com/EkhtiarSyed) or via the live Airflow chatroom room in [Gitter](https://gitter.im/apache/incubator-airflow).<p>
 -Ekhtiar Syed
 Last Update: 8-April-2016
diff --git a/airflow/models.py b/airflow/models.py
index 484dd821c4fbb..8e54c9b2a1a9f 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -3799,8 +3799,7 @@ def subdags(self):
         """
         Returns a list of the subdag objects associated to this DAG
         """
-        # Check SubDag for class but don't check class directly, see
-        # https://github.com/airbnb/airflow/issues/1168
+        # Check SubDag for class but don't check class directly
         from airflow.operators.subdag_operator import SubDagOperator
         subdag_lst = []
         for task in self.tasks:
diff --git a/airflow/operators/slack_operator.py b/airflow/operators/slack_operator.py
index c5a69456fbe86..3382bc2788dd4 100644
--- a/airflow/operators/slack_operator.py
+++ b/airflow/operators/slack_operator.py
@@ -115,8 +115,8 @@ def __init__(self,
                  text='No message has been set.\n'
                       'Here is a cat video instead\n'
                       'https://www.youtube.com/watch?v=J---aiyznGQ',
-                 icon_url='https://raw.githubusercontent.com'
-                          '/airbnb/airflow/master/airflow/www/static/pin_100.png',
+                 icon_url='https://raw.githubusercontent.com/apache/'
+                          'incubator-airflow/master/airflow/www/static/pin_100.jpg',
                  attachments=None,
                  *args, **kwargs):
         self.method = 'chat.postMessage'
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 4f539be2dd6f3..377fdffac2837 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -114,7 +114,7 @@ interval series.
 
     """
     Code that goes along with the Airflow tutorial located at:
-    https://github.com/airbnb/airflow/blob/master/airflow/example_dags/tutorial.py
+    https://github.com/apache/incubator-airflow/blob/master/airflow/example_dags/tutorial.py
     """
     from airflow import DAG
     from airflow.operators.bash_operator import BashOperator
diff --git a/tests/jobs.py b/tests/jobs.py
index 231944de3e8f5..bb729424eca38 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -421,8 +421,6 @@ def test_backfill_ordered_concurrent_execute(self):
     def test_backfill_pooled_tasks(self):
         """
         Test that queued tasks are executed by BackfillJob
-
-        Test for https://github.com/airbnb/airflow/pull/1225
         """
         session = settings.Session()
         pool = Pool(pool='test_backfill_pooled_task_pool', slots=1)
diff --git a/tests/sensors/test_http_sensor.py b/tests/sensors/test_http_sensor.py
index de9513724415a..5e55aa56e9c49 100644
--- a/tests/sensors/test_http_sensor.py
+++ b/tests/sensors/test_http_sensor.py
@@ -140,7 +140,7 @@ class FakeSession(object):
     def __init__(self):
         self.response = requests.Response()
         self.response.status_code = 200
-        self.response._content = 'airbnb/airflow'.encode('ascii', 'ignore')
+        self.response._content = 'apache/incubator-airflow'.encode('ascii', 'ignore')
 
     def send(self, request, **kwargs):
         return self.response
@@ -178,7 +178,7 @@ def test_get_response_check(self):
             method='GET',
             endpoint='/search',
             data={"client": "ubuntu", "q": "airflow"},
-            response_check=lambda response: ("airbnb/airflow" in response.text),
+            response_check=lambda response: ("apache/incubator-airflow" in response.text),
             headers={},
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
@@ -192,7 +192,7 @@ def test_sensor(self):
             request_params={"client": "ubuntu", "q": "airflow", 'date': '{{ds}}'},
             headers={},
             response_check=lambda response: (
-                "airbnb/airflow/" + DEFAULT_DATE.strftime('%Y-%m-%d')
+                "apache/incubator-airflow/" + DEFAULT_DATE.strftime('%Y-%m-%d')
                 in response.text),
             poke_interval=5,
             timeout=15,

From 3c8f391d3f690b766bb8f4a55c84923bc8ab7a85 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 29 Sep 2018 11:35:26 +0100
Subject: [PATCH 335/808] [AIRFLOW-2238] Update PR tool to remove outdated info
 (#3978)

---
 dev/README.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/dev/README.md b/dev/README.md
index 9f16b9f8fc032..fe3900e37795d 100755
--- a/dev/README.md
+++ b/dev/README.md
@@ -23,7 +23,7 @@ under the License.
 
 The `airflow-pr` tool interactively guides committers through the process of merging GitHub PRs into Airflow and closing associated JIRA issues.
 
-It is very important that PRs reference a JIRA issue. The preferred way to do that is for the PR title to begin with [AIRFLOW-XX]. However, the PR tool can recognize and parse many other JIRA issue formats in the title and will offer to correct them if possible.
+It is very important that PRs reference a JIRA issue. The preferred way to do that is for the PR title to begin with [AIRFLOW-XXX]. However, the PR tool can recognize and parse many other JIRA issue formats in the title and will offer to correct them if possible.
 
 __Please note:__ this tool will restore your current branch when it finishes, but you will lose any uncommitted changes. Make sure you commit any changes you wish to keep before proceeding.
 
@@ -76,14 +76,12 @@ pip install click jira
 #### git Remotes
 tl;dr run `airflow-pr setup_git_remotes` before using the tool for the first time.
 
-Before using the merge tool, users need to make sure their git remotes are configured. By default, the tool assumes a setup like the one below, where the github repo remote is named `github` and the Apache repo remote is named `apache`. If users have other remote names, they can be supplied by setting environment variables `GITHUB_REMOTE_NAME` and `APACHE_REMOTE_NAME`, respectively.
+Before using the merge tool, users need to make sure their git remotes are configured. By default, the tool assumes a setup like the one below, where the github repo remote is named `github`. If users have other remote names, they can be supplied by setting environment variables `GITHUB_REMOTE_NAME`.
 
 Users can configure this automatically by running `airflow-pr setup_git_remotes`.
 
 ```bash
 $ git remote -v
-apache	https://git-wip-us.apache.org/repos/asf/incubator-airflow.git (fetch)
-apache	https://git-wip-us.apache.org/repos/asf/incubator-airflow.git (push)
 github	https://github.com/apache/incubator-airflow.git (fetch)
 github	https://github.com/apache/incubator-airflow.git (push)
 origin	https://github.com/<USER>/airflow (fetch)

From efaf90ed81562efd2adb61b81d5a61f588494a01 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 24 May 2018 16:05:37 +0100
Subject: [PATCH 336/808] [AIRFLOW-2238] Flake8 fixes on dev/airflow-pr

---
 dev/airflow-pr | 75 +++++++++++++++++---------------------------------
 1 file changed, 26 insertions(+), 49 deletions(-)

diff --git a/dev/airflow-pr b/dev/airflow-pr
index 867d3298498bf..c374956c1054c 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -54,7 +54,8 @@ except ImportError:
 try:
     import keyring
 except ImportError:
-    print("Could not find the keyring library. Run 'sudo pip install keyring' to install.")
+    print("Could not find the keyring library. "
+          "Run 'sudo pip install keyring' to install.")
     sys.exit(-1)
 
 # Location of your Airflow git development area
@@ -66,10 +67,12 @@ AIRFLOW_GIT_LOCATION = os.environ.get(
 GITHUB_REMOTE_NAME = os.environ.get("GITHUB_REMOTE_NAME", "github")
 # Remote name which points to Apache git
 APACHE_REMOTE_NAME = os.environ.get("APACHE_REMOTE_NAME", "apache")
-# OAuth key used for issuing requests against the GitHub API. If this is not defined, then requests
-# will be unauthenticated. You should only need to configure this if you find yourself regularly
-# exceeding your IP's unauthenticated request rate limit. You can create an OAuth key at
-# https://github.com/settings/tokens. This tool only requires the "public_repo" scope.
+# OAuth key used for issuing requests against the GitHub API. If this is not
+# defined, then requests will be unauthenticated. You should only need to
+# configure this if you find yourself regularly exceeding your IP's
+# unauthenticated request rate limit. You can create an OAuth key at
+# https://github.com/settings/tokens. This tool only requires the "public_repo"
+# scope.
 GITHUB_OAUTH_KEY = os.environ.get("GITHUB_OAUTH_KEY")
 
 GITHUB_BASE = "https://github.com/apache/incubator-airflow/pull"
@@ -205,7 +208,8 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
     except Exception as e:
         msg = "Error merging: %s\nWould you like to manually fix-up this merge?" % e
         continue_maybe(msg)
-        msg = "Okay, please fix any conflicts and 'git add' conflicting files... Finished?"
+        msg = ("Okay, please fix any conflicts and 'git add' conflicting files... " +
+               "Finished?")
         continue_maybe(msg)
         had_conflicts = True
 
@@ -216,7 +220,6 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
     if pr_commits:
         all_text += ' '.join(c['commit']['message'] for c in pr_commits)
     all_jira_refs = standardize_jira_ref(all_text, only_jira=True)
-    all_jira_issues = re.findall("AIRFLOW-[0-9]{1,6}", all_jira_refs)
 
     merge_message_flags = []
 
@@ -315,7 +318,6 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
         if primary_author == "":
             primary_author = distinct_authors[0]
 
-        authors = "\n".join(["Author: %s" % a for a in distinct_authors])
         merge_message_flags.append(u'--author="{}"'.format(primary_author))
 
     else:
@@ -327,7 +329,7 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
     # reflow commit message
     seen_first_line = False
     for i in range(1, len(merge_message_flags)):
-        if merge_message_flags[i-1] == '-m':
+        if merge_message_flags[i - 1] == '-m':
             # let the first line be as long as the user wants
             if not seen_first_line:
                 if '\n\n' in merge_message_flags[i]:
@@ -376,7 +378,7 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
             run_cmd(['git', 'commit'] + commit_flags, echo_cmd=False)
 
     if local:
-        msg ='\n' + reflow("""
+        msg = '\n' + reflow("""
             The PR has been merged locally in branch {}.
             You may leave this program running while you work on it. When
             you are finished, press any key to delete the PR branch and
@@ -390,8 +392,8 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
     else:
         continue_maybe(
             '\n\nThe local merge is complete ({}).\n'.format(
-                target_branch_name)
-            + click.style(
+                target_branch_name) +
+            click.style(
                 'Push to Apache ({})?'.format(APACHE_REMOTE_NAME), 'red'))
 
     try:
@@ -459,7 +461,7 @@ def fix_version_from_branch(branch, versions):
     if branch == "master":
         return versions[0]
     else:
-        #TODO adopt a release scheme with branches. Spark uses branch-XX.
+        # TODO adopt a release scheme with branches. Spark uses branch-XX.
         branch_ver = branch.replace("branch-", "")
         versions = list(filter(
             lambda x: x.name.startswith(branch_ver), versions))
@@ -692,18 +694,19 @@ def resolve_jira_issue(comment=None, jira_id=None, merge_branches=None):
         action["id"],
         fixVersions=jira_fix_versions,
         comment=comment or None,
-        resolution = {'id': resolution.raw['id']})
+        resolution={'id': resolution.raw['id']})
 
     click.echo("Successfully resolved {id}{fv}!".format(
         id=jira_id,
         fv=' with fix versions={}'.format(fix_versions) if fix_versions else ''
-        ))
+    ))
 
 
 def standardize_jira_ref(text, only_jira=False):
     """
     Standardize the [AIRFLOW-XXXXX] [MODULE] prefix
-    Converts "[AIRFLOW-XXX][mllib] Issue", "[MLLib] AIRFLOW-XXX. Issue" or "AIRFLOW XXX [MLLIB]: Issue" to "[AIRFLOW-XXX][MLLIB] Issue"
+    Converts "[AIRFLOW-XXX][mllib] Issue", "[MLLib] AIRFLOW-XXX. Issue" or
+    "AIRFLOW XXX [MLLIB]: Issue" to "[AIRFLOW-XXX][MLLIB] Issue"
 
     >>> standardize_jira_ref("[AIRFLOW-5821] [SQL] ParquetRelation2 CTAS should check if delete is successful")
     '[AIRFLOW-5821][SQL] ParquetRelation2 CTAS should check if delete is successful'
@@ -725,7 +728,7 @@ def standardize_jira_ref(text, only_jira=False):
     'Additional information for users building from source code'
     >>> standardize_jira_ref('AIRFLOW 35 AIRFLOW--36 AIRFLOW  37 test', only_jira=True)
     '[AIRFLOW-35][AIRFLOW-36][AIRFLOW-37]'
-    """
+    """  # noqa
     jira_refs = []
     components = []
 
@@ -770,8 +773,8 @@ def standardize_jira_ref(text, only_jira=False):
     # Assemble full text (JIRA ref(s), module(s), remaining text)
     clean_text = ''.join(unique(jira_refs)).strip()
     if not only_jira:
-         clean_text += (
-             ''.join(unique(components)).strip() + " " + text.strip())
+        clean_text += (
+            ''.join(unique(components)).strip() + " " + text.strip())
 
     # Replace multiple spaces with a single space, e.g. if no jira refs
     # and/or components were included
@@ -847,7 +850,6 @@ def main(pr_num, local=False):
         click.echo('Working with pull request {}'.format(pr_num))
 
     pr = get_json("{}/pulls/{}".format(GITHUB_API_BASE, pr_num))
-    pr_events = get_json("{}/issues/{}/events".format(GITHUB_API_BASE, pr_num))
 
     url = pr["url"]
 
@@ -875,33 +877,6 @@ def main(pr_num, local=False):
     base_ref = pr["head"]["ref"]
     pr_repo_desc = "%s/%s" % (user_login, base_ref)
 
-    # Merged pull requests are either closed or merged by asfgit
-    merge_commits = [
-        e for e in pr_events
-        if e["actor"]["login"] == GITHUB_USER and
-        (e["event"] == "closed" or e["event"] == "merged")]
-
-    if merge_commits and False:
-        merge_hash = merge_commits[0]["commit_id"]
-        message = get_json(
-            "%s/commits/%s" % (GITHUB_API_BASE, merge_hash)
-            )["commit"]["message"]
-
-        continue_maybe(
-            "Pull request %s has already been merged. "
-            "Do you want to backport?" % pr_num)
-        commit_is_downloaded = run_cmd(
-            ['git', 'rev-parse', '--quiet', '--verify',
-             "%s^{commit}" % merge_hash]) != ""
-        if not commit_is_downloaded:
-            fail(
-                "Couldn't find any merge commit for #%s, "
-                "you may need to update HEAD." % pr_num)
-
-        click.echo("Found commit %s:\n%s" % (merge_hash, message))
-        cherry_pick(pr_num, merge_hash, latest_branch)
-        sys.exit(0)
-
     if not bool(pr["mergeable"]):
         msg = ('Pull request {} is not mergeable in its current form.\n'
                'Continue anyway? (experts only!)'.format(pr_num))
@@ -1059,7 +1034,8 @@ def setup_git_remotes():
 
     error = False
     try:
-        run_cmd('git remote add apache https://git-wip-us.apache.org/repos/asf/incubator-airflow.git')
+        run_cmd('git remote add apache '
+                'https://git-wip-us.apache.org/repos/asf/incubator-airflow.git')
     except:
         click.echo(click.style(reflow(
             '>>ERROR: Could not create apache remote. If it already exists, '
@@ -1072,7 +1048,8 @@ def setup_git_remotes():
             '>>ERROR: Could not create github remote. If it already exists, '
             'run `git remote remove github` to delete it.', fg='red')))
         error = True
-    click.echo('Done setting up git remotes. Run git remote -v to see them.')
+    if not error:
+        click.echo('Done setting up git remotes. Run git remote -v to see them.')
 
 
 if __name__ == "__main__":

From 7ecbdcb64d0cec678cff66b3aca0d587f337ca51 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 24 May 2018 16:20:16 +0100
Subject: [PATCH 337/808] [AIRFLOW-2238] Update PR tool to push directly to
 Github

---
 dev/airflow-pr | 46 +++++++++++++---------------------------------
 1 file changed, 13 insertions(+), 33 deletions(-)

diff --git a/dev/airflow-pr b/dev/airflow-pr
index c374956c1054c..80dc22ef38504 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -65,8 +65,6 @@ AIRFLOW_GIT_LOCATION = os.environ.get(
 
 # Remote name which points to the Gihub site
 GITHUB_REMOTE_NAME = os.environ.get("GITHUB_REMOTE_NAME", "github")
-# Remote name which points to Apache git
-APACHE_REMOTE_NAME = os.environ.get("APACHE_REMOTE_NAME", "apache")
 # OAuth key used for issuing requests against the GitHub API. If this is not
 # defined, then requests will be unauthenticated. You should only need to
 # configure this if you find yourself regularly exceeding your IP's
@@ -175,7 +173,7 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
     pr_branch_name = "%s_MERGE_PR_%s" % (BRANCH_PREFIX, pr_num)
     target_branch_name = "%s_MERGE_PR_%s_%s" % (BRANCH_PREFIX, pr_num, target_ref.upper())
     run_cmd("git fetch %s pull/%s/head:%s" % (GITHUB_REMOTE_NAME, pr_num, pr_branch_name))
-    run_cmd("git fetch %s %s:%s" % (APACHE_REMOTE_NAME, target_ref, target_branch_name))
+    run_cmd("git fetch %s %s:%s" % (GITHUB_REMOTE_NAME, target_ref, target_branch_name))
     run_cmd("git checkout %s" % target_branch_name)
 
     had_conflicts = False
@@ -394,11 +392,11 @@ def merge_pr(pr_num, target_ref, title, body, pr_repo_desc, local):
             '\n\nThe local merge is complete ({}).\n'.format(
                 target_branch_name) +
             click.style(
-                'Push to Apache ({})?'.format(APACHE_REMOTE_NAME), 'red'))
+                'Push to Gitbox ({})?'.format(GITHUB_REMOTE_NAME), 'red'))
 
     try:
         run_cmd('git push %s %s:%s' % (
-            APACHE_REMOTE_NAME, target_branch_name, target_ref))
+            GITHUB_REMOTE_NAME, target_branch_name, target_ref))
     except Exception as e:
         clean_up()
         fail("Exception while pushing: %s" % e)
@@ -421,7 +419,7 @@ def cherry_pick(pr_num, merge_hash, default_branch):
         BRANCH_PREFIX, pr_num, pick_ref.upper())
 
     run_cmd("git fetch %s %s:%s" % (
-        APACHE_REMOTE_NAME, pick_ref, pick_branch_name))
+        GITHUB_REMOTE_NAME, pick_ref, pick_branch_name))
     run_cmd("git checkout %s" % pick_branch_name)
 
     try:
@@ -437,12 +435,12 @@ def cherry_pick(pr_num, merge_hash, default_branch):
         continue_maybe(msg)
 
     continue_maybe("Pick complete (local ref %s). Push to %s?" % (
-        pick_branch_name, APACHE_REMOTE_NAME))
+        pick_branch_name, GITHUB_REMOTE_NAME))
 
     try:
         run_cmd(
             'git push %s %s:%s' % (
-                APACHE_REMOTE_NAME, pick_branch_name, pick_ref))
+                GITHUB_REMOTE_NAME, pick_branch_name, pick_ref))
     except Exception as e:
         clean_up()
         fail("Exception while pushing: %s" % e)
@@ -809,9 +807,6 @@ def main(pr_num, local=False):
     - GITHUB_REMOTE_NAME
         GitHub remote name (defaults to "github")
 
-    - APACHE_REMOTE_NAME
-        Apache git remote name (defaults to "apache")
-
     - JIRA_USERNAME
         ASF JIRA username for automatically closing JIRA issues. Users will be
         prompted if it is not set.
@@ -936,11 +931,10 @@ def cli():
     This tool should be used by Airflow committers to test PRs, merge them
     into the master branch, and close related JIRA issues.
 
-    Before you begin, make sure you have created the 'apache' and 'github' git
-    remotes. You can use the "setup_git_remotes" command to do this
-    automatically. If you do not want to use these remote names, you can tell
-    the PR tool by setting the appropriate environment variables. For more
-    information, run:
+    Before you begin, make sure you have created the 'github' git remote. You
+    can use the "setup_git_remotes" command to do this automatically. If you do
+    not want to use these remote names, you can tell the PR tool by setting the
+    appropriate environment variable. For more information, run:
 
         airflow-pr merge --help
     """
@@ -961,11 +955,10 @@ def cli():
 def merge(pr_num):
     """
     Utility for creating well-formed pull request merges and pushing them
-    to Apache, as well as closing JIRA issues.
+    to Gitbox (a.k.a. GitHub), as well as closing JIRA issues.
 
     This tool assumes you already have a local Airflow git folder and that you
-    have added remotes corresponding to both (i) the github apache Airflow
-    mirror and (ii) the apache git repo.
+    have added remote corresponding to the github apache Airflow repo.
 
     To configure the tool, set the following env vars:
     - AIRFLOW_GIT
@@ -975,9 +968,6 @@ def merge(pr_num):
     - GITHUB_REMOTE_NAME
         GitHub remote name (defaults to "github")
 
-    - APACHE_REMOTE_NAME
-        Apache git remote name (defaults to "apache")
-
     - JIRA_USERNAME
         ASF JIRA username for automatically closing JIRA issues. Users will be
         prompted if it is not set.
@@ -1020,11 +1010,9 @@ def setup_git_remotes():
     click.echo(reflow("""
         This command will create git remotes to mirror the following
         structure. If you do not want to use these names, you must set the
-        GITHUB_REMOTE_NAME and APACHE_REMOTE_NAME environment variables:
+        GITHUB_REMOTE_NAME environment variable:
 
           git remote -v
-          apache https://git-wip-us.apache.org/repos/asf/incubator-airflow.git (fetch)
-          apache https://git-wip-us.apache.org/repos/asf/incubator-airflow.git (push)
           github https://github.com/apache/incubator-airflow.git (fetch)
           github https://github.com/apache/incubator-airflow.git (push)
 
@@ -1033,14 +1021,6 @@ def setup_git_remotes():
     continue_maybe('Do you want to continue?')
 
     error = False
-    try:
-        run_cmd('git remote add apache '
-                'https://git-wip-us.apache.org/repos/asf/incubator-airflow.git')
-    except:
-        click.echo(click.style(reflow(
-            '>>ERROR: Could not create apache remote. If it already exists, '
-            'run `git remote remove apache` to delete it.', fg='red')))
-        error = True
     try:
         run_cmd('git remote add github https://github.com/apache/incubator-airflow.git')
     except:

From 03746b9a0880f13b00beda4a92cb48b781fd390b Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 4 Sep 2018 08:34:20 +0100
Subject: [PATCH 338/808] [AIRFLOW-208] Add badge to show supported Python
 versions (#3839)

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index c1893cfba8013..036e695a64fc5 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@ under the License.
 [![Coverage Status](https://img.shields.io/codecov/c/github/apache/incubator-airflow/master.svg)](https://codecov.io/github/apache/incubator-airflow?branch=master)
 [![Documentation Status](https://readthedocs.org/projects/airflow/badge/?version=latest)](https://airflow.readthedocs.io/en/latest/?badge=latest)
 [![License](http://img.shields.io/:license-Apache%202-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/apache-airflow.svg)](https://pypi.org/project/apache-airflow/)
 [![Join the chat at https://gitter.im/apache/incubator-airflow](https://badges.gitter.im/apache/incubator-airflow.svg)](https://gitter.im/apache/incubator-airflow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
 _NOTE: The transition from 1.8.0 (or before) to 1.8.1 (or after) requires uninstalling Airflow before installing the new version. The package name was changed from `airflow` to `apache-airflow` as of version 1.8.1._

From 183191a28c1c1211eaab6832724b6a7f2f1066ba Mon Sep 17 00:00:00 2001
From: r39132 <siddharthanand@yahoo.com>
Date: Thu, 6 Sep 2018 11:57:15 -0700
Subject: [PATCH 339/808] [AIRFLOW-3028] Update Text & Images in Readme.md

---
 README.md             |  26 ++++++++++++++------------
 docs/img/code.png     | Bin 218215 -> 285906 bytes
 docs/img/context.png  | Bin 238360 -> 149588 bytes
 docs/img/dags.png     | Bin 115068 -> 217069 bytes
 docs/img/duration.png | Bin 254497 -> 250846 bytes
 docs/img/gantt.png    | Bin 213845 -> 121795 bytes
 docs/img/graph.png    | Bin 333294 -> 152205 bytes
 docs/img/tree.png     | Bin 163147 -> 128024 bytes
 8 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 036e695a64fc5..4c22be6d8cf05 100644
--- a/README.md
+++ b/README.md
@@ -27,20 +27,14 @@ under the License.
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/apache-airflow.svg)](https://pypi.org/project/apache-airflow/)
 [![Join the chat at https://gitter.im/apache/incubator-airflow](https://badges.gitter.im/apache/incubator-airflow.svg)](https://gitter.im/apache/incubator-airflow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-_NOTE: The transition from 1.8.0 (or before) to 1.8.1 (or after) requires uninstalling Airflow before installing the new version. The package name was changed from `airflow` to `apache-airflow` as of version 1.8.1._
+_NOTE: The transition from 1.8.0 (or before) to 1.8.1 (or after) requires uninstalling Apache Airflow before installing the new version. The package name was changed from `airflow` to `apache-airflow` as of version 1.8.1._
 
-Airflow is a platform to programmatically author, schedule, and monitor
-workflows.
+Apache Airflow (or simply Airflow) is a platform to programmatically author, schedule, and monitor workflows.
 
 When workflows are defined as code, they become more maintainable,
 versionable, testable, and collaborative.
 
-Use Airflow to author workflows as directed acyclic graphs (DAGs) of tasks.
-The Airflow scheduler executes your tasks on an array of workers while
-following the specified dependencies. Rich command line utilities make
-performing complex surgeries on DAGs a snap. The rich user interface
-makes it easy to visualize pipelines running in production,
-monitor progress, and troubleshoot issues when needed.
+Use Airflow to author workflows as directed acyclic graphs (DAGs) of tasks. The Airflow scheduler executes your tasks on an array of workers while following the specified dependencies. Rich command line utilities make performing complex surgeries on DAGs a snap. The rich user interface makes it easy to visualize pipelines running in production, monitor progress, and troubleshoot issues when needed.
 
 ## Getting started
 Please visit the Airflow Platform documentation (latest **stable** release) for help with [installing Airflow](https://airflow.incubator.apache.org/installation.html), getting a [quick start](https://airflow.incubator.apache.org/start.html), or a more complete [tutorial](https://airflow.incubator.apache.org/tutorial.html).
@@ -69,7 +63,7 @@ unit of work and continuity.
 - **Dynamic**:  Airflow pipelines are configuration as code (Python), allowing for dynamic pipeline generation. This allows for writing code that instantiates pipelines dynamically.
 - **Extensible**:  Easily define your own operators, executors and extend the library so that it fits the level of abstraction that suits your environment.
 - **Elegant**:  Airflow pipelines are lean and explicit. Parameterizing your scripts is built into the core of Airflow using the powerful **Jinja** templating engine.
-- **Scalable**:  Airflow has a modular architecture and uses a message queue to orchestrate an arbitrary number of workers. Airflow is ready to scale to infinity.
+- **Scalable**:  Airflow has a modular architecture and uses a message queue to orchestrate an arbitrary number of workers.
 
 ## User Interface
 
@@ -91,9 +85,9 @@ unit of work and continuity.
 - **Code View**:  Quick way to view source code of a DAG.
 ![](/docs/img/code.png)
 
-## Who uses Airflow?
+## Who uses Apache Airflow?
 
-As the Airflow community grows, we'd like to keep track of who is using
+As the Apache Airflow community grows, we'd like to keep track of who is using
 the platform. Please send a PR with your company name and @githubhandle
 if you may.
 
@@ -277,6 +271,14 @@ Currently **officially** using Airflow:
 1. [Zymergen](https://www.zymergen.com/)
 1. [99](https://99taxis.com) [[@fbenevides](https://github.com/fbenevides), [@gustavoamigo](https://github.com/gustavoamigo) & [@mmmaia](https://github.com/mmmaia)]
 
+## Who Maintains Apache Airflow?
+
+Airflow is the work of the [community](https://github.com/apache/incubator-airflow/graphs/contributors),
+but the [core committers/maintainers](https://people.apache.org/committers-by-project.html#airflow)
+are responsible for reviewing and merging PRs as well as steering conversation around new feature requests.
+If you would like to become a maintainer, please review the Apache Airflow
+[committer requirements](https://cwiki.apache.org/confluence/display/AIRFLOW/Committers).
+
 ## Links
 
 
diff --git a/docs/img/code.png b/docs/img/code.png
index ac49291f1c3332bc62d192b18b70777c8f523d07..60e8f58a3382148b66a587d3685945a0a4b393ea 100644
GIT binary patch
literal 285906
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
KWz`F-i2nhZQ^sNd

literal 218215
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

diff --git a/docs/img/context.png b/docs/img/context.png
index de75e487c01f446e2137e7af9c2ddead3efeed00..bac718f1d1a2678e9c2c45263868aea47fe1fa47 100644
GIT binary patch
literal 149588
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
ME}zdmYjfxS079zF+yDRo

literal 238360
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
P;7>*IkwUqgdEoy8fPVOf

diff --git a/docs/img/dags.png b/docs/img/dags.png
index a551f02b1d2c2c4dc0220a904236a995da5c4dbd..04c82131f945cdea4171d90355c29e18a3b6bb10 100644
GIT binary patch
literal 217069
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

literal 115068
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

diff --git a/docs/img/duration.png b/docs/img/duration.png
index 18d723c005a4860a403bae2088d0de70b2596074..b59fc092573a679010f5ff2bd66873a4a150ca8d 100644
GIT binary patch
literal 250846
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
Hu0mjf_+ms&

literal 254497
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%0Ao(1!bKNO^qj9j!E5fHsy
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

diff --git a/docs/img/gantt.png b/docs/img/gantt.png
index c462adbdf4bdf93fd8cc4cbca7e83244bc5a801a..d74e1e5c3e5dd78ee193b5259de7cfdf8bda7038 100644
GIT binary patch
literal 121795
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

literal 213845
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
Y)zCL|tI1$0>7qq?KN#%D*0l8dADfZv)c^nh

diff --git a/docs/img/graph.png b/docs/img/graph.png
index cbc58e6d8f146ee365df9095d04d606227b00c53..ea2b7054e22e98f47eb9a0a0eaed8698c671c7c7 100644
GIT binary patch
literal 152205
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%0AEut7s#te&?=-vjX2-g
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

literal 333294
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%0A<*uZPU!
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

diff --git a/docs/img/tree.png b/docs/img/tree.png
index f3796b057249b7e0ee1b63a52270a623d1682fb6..06750aa4cb2025ede172d899215fe825ec57f297 100644
GIT binary patch
literal 128024
zcmeFYWmIHMlQ4)&<L*$nHSUEqZjHM`<L>U#NaNnPySuwX<L>URg|q$6%+Abv_MH8m
zv%j}a-nv<tAvZH_W<+E}g)7KOAbr9A0tN<#Bqb@T1O^660R{#U1_$%Eg~e007z_-N
z%0fg$K}tjfpx|g{YGG{x1|}Jvlme@gFpBMe#3UstX&#_Z5WER>qUsr?QW_W)3xzI?
z2ro1k{gti-TSc^ntemW=5v;Bxtn+JNr{LETnzJ9hA!F$j{#99^O%G7U^Cy$r<$5c~
z^n-^DtYoN8ERRqH$zR8?i<|LlEDtGVl9VT$<TuC?Fr05@P850m%gd5rCQtA39&SW{
zIuI6bYIXMOXL*T}2RbsC<kx-Ys^A2KX8>3Wfds`Qtp7B^L($xwSZp}6bPjC@xG-me
zLs1~VaYog)WUH*O4(dKTSYnBF6E_AJmZr`h2sx_z{5s6KpjdiTVcUT7@tykCSV0lu
z%yeF)x-u-|^82ed<Bxu`moRxwUZ-HJ))6sU4FK9fjoC-`!P8cJIyq5RKPD%gJ|Qvn
zxTae3xdj?)k+1;$_n7E_3h?JLfBNQ>8;mY?K8KMHNC|W(D;Qj`92G`hZiqSoV+=z%
z=l$4CE)mqRKt!t;D!5xs_+Pa&>U<2gBZ9ynYWQ#x(<Tjpls`o(X_>gp`%dK9!}yOY
zIwSIuY6Ib}m~ioVq~+hb=trYtaO*tuMo@kcH=)Vw8ME|%5<=qbPILc6GEJt(n?$(V
zMbMZLAxxc;hf|LnEV5s|U3LbT-B4hVh3@U&28v*M7>e;3?kc=#w9*JN+m3XpC1UUz
z$249$_8EI(j9kPAKJC={JlogO-VO%P2yzOc5mcoP662JIfj5K40pOq@sbc$*k&6Pp
z0?e;$&VP1e^5^;^4FE8%{WoGw-9_s<B;c}da!}u(!(l1N_aF{B`4qq&^u-%~6%&ob
zg0M#<jDx6SorIu90=f%t75m~=;(Lrr(B9a2VTaNn(<`p1iIiP5BoIkqF#5xDMXhvD
zK!cq(l27-c6Y!uO{?NS_Q+apcV+uYB9dc(hTUjj3aKEq&_`Gj8ku1(M?e|yp{R}zk
z>U^l6fR9|ejDRz6-gW3nO#j#3R^8mkSB*k)JiqdTSf)BiJW8vC_fa)L@thy|yTDyB
zwbCoA+%S5d0xcnOe!)Yud)@bzYoeQc$|hW1|IFTKqoW$^3N+?gBMl5!G+wg3xW*fe
zF3u3Mh=kz;q<1*qv>1N&;tEUjP|r}}&?ylgKsFb-{$nkaEXD*T0_*ehAFvkfyWd|)
zhke=SMtjjN^XfYFYa2TZM?lWO4j<`^)mUItN+o~Zij4aCkFPPnj<32-zU%j!bVK-)
z6A_lSe9P@OL4n8tQ++Bth7f6S)9j7R@F%#2`2avgLb3qB3;bzoCcRta1`U9}k+A*I
z6=2l-IdZ;OLumIR*ASe;M&&>g!WQ>JPlHzl@Y+{82jS$PbU;GF1;(P{3rjeokq;2o
zie;dp4B)^Ek;QRSKud|RqLGq`nUW*Ku@(@P3O4~<My^H-_qiRBPeg4=QDTYrId0(x
z73j*s@pG_`apxhCzL8HuIkTpPALjlvXK6#M6t$YxHHY*h?DW?YX`jY17ldIpi44Fq
za{Ud99Xx1IssTeaboirC16nQUqBm_v&<Fag&$Bj$8?AWn`#N&fl06^V(YD8vjyJ8|
z&#NAS>x3t)H}K6+Kgwyi7bxvOoB*-k-$p3DQzxR*!L7lC!WC~f&&j$=P@v<9%H;9B
zJt~E14rmS(4j>J54ygU0zCo+a79~50x0Vtpz(r3_l&2%DB)=ddBG;vINf4l+rN^V?
zq5Vl$NC%(vE0HeIm5xZYt>RwA!oNbCliDlJXhi4s`>mrRLu;yc__{1{PKokYT7g6;
zX>1el!uYyS$6t;qx8j<bE21mP9vyYxJh~hUZv_tO$50Xll{iW`=K-e_Wr=N(ZJDdm
zonk&B`7>Y5KN?iD1Z?msqg?}Cvmb?iR{f~%Q`#x}qg<+Hq0m}!tCUn>S%sei6l+vy
z6n^kOrCiYCs7w2)6^pNJQ>E3oYS>6%`F`r`BJqIxpz~08%DXUCDmVwQ&@c}+x99l9
z(PWu1?JhceTyzfrhIYm3$q0&FEmBx&S=O=FvyZd8Sv6TbT3DF3np0X#OqVSJ^A-ks
zaIq1w$wO;1YO@_OZ=}|~@qSA$?iBTkc{I5I0rQ>TT-<?$Krff76Yp7*(~x7+v#NQU
z`Of0dvz6nhrSz(1#j8ZUE1C(#&3x{BX^9IG7j2S-=9!qe?80u<&phAmfLx*90V4*P
zz3@SLA|bimhRHjY{rMsM;?Csy<N-65`9|VXsak))Op)v3J>pl)D(nbtzjAE;ShwXf
z_+b%mu4G)dw4X&gIN#6S@7!pSZjqfDr<u57UGG`Hc4+K`;?(u5b;ovi#qgCOo&j5v
zU5l@NzSdY1TWe8!voTNeS@S@1K|{BZO3O>bOxv#JvPQ^8$L5K1fiuNgQJYIU-~wiC
zawd2tEB|M{mH1Xo{wnk`*7Cv{e~sC)#464T*J?MR5hs<)pD`A*A#WFZml1~&mzKSf
z9q!56k=m7;#)K%0;nLNUGPVhxd5<ioggbg1ZJexe@s#u`=OvmYu_~J?{q^;Y0b8$i
z&-ID*x%H*?t?TLgum_D(hsA_#yknlJ`oX*Wlyvp3CEx1q&Wn!vPB%|M0xO<mt|r%W
zauN)ZrYY=fM*SkYv@6psMnNONCjF=_5kF<Ws!z_(V(>+9P4IRIJs2R=FGv*VE|l9Z
zX&CePk<g*gDKO2U=D`#pDnHjzIN&D`D^V^GoRHG77V+iaV&L@ge1lASc56;GeD>Cd
zC-B@@1M$&F6tQlYXQ`A3R|tQKM@491xp1xWY2j|*LjKTTDgSXfs5Nvr_`#CJE#T_?
z@I>tp?NGlrIWV_ZJaiT5mxB7chHpnMPc@IdmO+ZcLP<$?_H}=I|8~C$-iYc?sy(R~
zlUVF*qO`QE^hWZkAdB&CTKGnS4t3J^Hh~q#+sM(QqGQ?7R7c~oQ<cYgNQ>Zx{f117
z>=l-Cd{;jpy^oJ433XU~@?GHBl<vgE&hzz{hdi4%>lj;>$%}E-*!j-u4gFJRAV4T-
zTUE_{v8V#H!m_ef59<`~^ms^jP;@|yZ3$QZle!pBE}f-P*_fUV&E>%3pmOvKLn5qM
z3U$<2O1X=Q&saZEOUf@!faaQ^gz<@)-{K_z@02Z=jd8Lewbl4=u5Y?;%XFunyMEP_
zU`mhqwKv0`NBfY>Y3`_Lf-O^>uiDFZ`HcvH2B8k;O><vCMep9#@V4*pN6_x`V2m&P
zYhjmYp{S0dQ5+~wHsWS5aPUGVBc($7wlPuLv+GZ8Mc(<H(&X%2H}FI2`E0u`(&S=%
zBiT+zNQYF%!KZL*jOgI>;O9Y%npmZ!#)OV;+sj2-snw)vi;A_Dj3&MAnkt^=O2ee}
z#xIxb@+Z}$GRSgJ)slX<@%t;%I#LSPi`{ztsDbiIk$gIIx}7cj+N^?+qH=9gOQXSA
z!fL@PTeruXTC=R3_DU1e+RwFi*MSRe%_BYaW@W#lTh9hPt*v^i*{bM`-uCpz<%^ZN
zl-g!%l4a@*&>N^>tNJQtdCRqDuO}<$5O#?qkA%+V8@?&$J;yCUdzw-j5G96peerz5
z`xxa_u&EihS%qW<SocPAV16^xYxHyYMO&=0bC@kg&@z41^=Kd%LtQ>vaK)EycYb9q
zw^%*{p4;iXVrnJXN$&_b8^pck-g_b3FSZmB`r-V3r_iqL)lUhMktNC^n#eTbjnR8-
z_kNSUPMTBKRA<tO=vwsPzj>J;NU(L@*x&Sar9WCMUxRLjz5LTH)1vJuf1x+%^Zv^5
zS@*HD$=F;)juJ?s<Bj`yJxM;9j}t=~Bj|=Bn9E=4Zh7BunL1aWoHd;leT0$i){WYU
zd(7}G^IrYHRH;Y&w)S}y;e+wgrXQ}4)TQ?#4w`suX0%&-F?zk~9{1t8?z#`U3?(Ar
z7sz@}d^<Vmxt}VSO46_BX7`JF@^oW%vsW0vu0N0fN91HDhxA`s1J5b!sTY9-OAP<j
zo~na7=%XaJEm*tzL50Hw*7OP)%T3}h=`Owkm(F8M=RF?14gUe=;!12GLN;pes`QlC
zM}V-?zr9TW2_`uK=8cAejBJfd_@;yq)Cv8~Dr;Ac24jWDxxO<J*rp#ya<G+7=OC9i
z^Jn_6;{b0jsp$j;hE4ge3tUQx;u;JLJj+5w!&yW2JJ86^hSAX2?uQAZyN&%{XfQB7
zci`Wujft}%z}?2$)(Pm&Pxc=Wz`yl>H8YU`{sY9>il0nFRskSl=V$`pU}R@xCKLDq
z008(LjZJ|{qT>IB{`VI@nYpvGJ&=jX&CQL`jg8UH(Ts_OhlhuWnU#r^mEkW0gOi7?
zv!OeKtrPiw68XRBh?+PVIa=5|TiDqG{zcdDhn<TvKN;D-82$I>KcCaY-Qs^Z**g8#
zu>KB^>0doeER4)d|4sWZD&N0afeIGxCe|9F7B(ifPJej_uyC_-^Zf_H|D)@FSpF|m
z&Hq8=WdAqJ|JCzfn0!qC8o~b>(SJ_Yf3*IcFM%(7O#eOi0$-9ySC0RRgU~`$Ughr{
z;$O1)D>>1>Uo`)D|62!_bhQupdH@FY4NOW@NW~reJQLPHMfLGh9-kH!E*G@vb=4`J
zHmjm?uA!i@)O31k_i%Mtc2;GAwlw%lGJy`D>zT4y03u^Zgql72<aaxyV(O<r>=W*}
zQe|bU?w;}jb-hl4vYa6D^73?OX=%~9_Bjkm!O;Q#qy(G^ZIe6)6)F`<qkj{+_1xa)
zl=O%CCnW=lMiOXo%?lq3_76&r3*}$(ZM*wJ|Ah8mnE#*r|I0-Ef0&%vAhw<ZboFmN
zE<eYk;{K7yt}?-(rPjgeL=I^+^%w~^U%k3X+&?J3LHwVKy)OK|w-9<(1ldzDNf{vw
zl%6`+DIVT@MLksLQF1V}a@AQ=E6YE6MV~q`T1W$p4IJwVeg=P2QBj?l%G*({ggfc{
zMSrpSQ>xx41!~FiEA7Ub%<=3*e2XzmQ~55nNV6yTk=;LIzyS4;#w$ywQUU;1R8*`=
zOvDT)xLvhdk!w0jT&dG4v(ck9G~9`Y4b&ISk#Q8dLkN5<Zp#_-D}y}6nb^aH+PQVt
z%CSy1fQK6=zwx-0^6sMH(eH>H5W^W=PWh727EsR6_C*b;YUZ2Lsw*ojdYc~fC`q-e
zj84`+T4<600ti3k$do#h@ee!b(bxhgiw^fR=jB$pFMwT3l^RLgu)y3W*lsEK0qPH~
z&q$2IBTyPt+{NfL0t*vb-`>w201uY#cjP5YK&T}rOEDIhoz&7ou)_k8P$XiRj`l2Y
zi?nJ0GcL?vw9z+#f*}NOl4{2}DfoYu@_)PuOQPE$!PXoSaA-Bpr>(PY{Se{E$cY`O
zR14ZlVxxe!xj(TdE2RA03s#O6c_TvRApr_sFqG%^mC|G;jXbUUVe0avxWZA8Q~cS(
z;sZ{s%#a4iIbo8@=}KAn#ZaGBYh*_ug&c{XM#V5G>O+Qk{?TLEKS0^$0N}CE^rEA<
zm{LO3WmEc4Vefh#SeOJva`|A4^iXwhZsINrO3;naZ+RFyXdJ=Y4C#FJ`_`A|!Q91)
zq*bC=Z(Z^QZmlkb;hsGy<)xbO@l@IZ3pQs6czYK~jnlm2JRm6dkD}r`+)aljtFtJV
z{?UdDj($yMzXv6CzWghs(XBG27+XGZw@PIc1Hw*fkM<-U6^rslSERvm=DPAXLpPcA
z*{vuRCaFT7$Ss-ZSUxSd5)Z5Fm!#-KH>-yPo1b)suZ&Sczld5>7OF3IvB`rXl9C!O
zeJGKL(*iGkYt*(StP7!1a7nT9Q!p_5#{Z*b??P%X0xiY=gI-!q;5ve@(V#=+duK3a
zG+v%@iA17vR_0;qdf0TO7eF}VoA&qlno4`y@81ARlVY>`I_9y6)tjn^Nj4UIgckzq
zYu90MV$#xD%>wb**q4uy^W3$k5vgDPT7i~_fuY8;!k&`A*1LbELUiZ@2pA<#!L@s9
z=4;<?@8yjOO#3|GLuv5fuSS^VpBBG80fn6g`h;SM<|v@a_HSiS$ysPo^GsL?3FLd7
z>ReU)6DQB&mjNk}OdA?q<({Dwu%Xg`zS<(_vTDk{UU8h{dA;|+B;FWFRw&7bSm(3E
zEW&tHiY4aIf?d;pq)!9Rq_&IT;yoe2Q4w_m0+g=*ICz*|x+yVTCI-VoOJ(`9!?Uzf
zK%%N*<x$*9NHfNT)qGpYK8~-HVodN-YIYD1D?lV9wi1IK!J~;R6|$&f_QS)|EAGw+
z4;#Wvff5&sD4zn88pkNT(c3W8BK2&8mhvt;#RC^|WPlp|DQF6p)CP(DkM=x3fEAhj
z9F!ElCB3w`9yh)GpJ%nSLE<FTuy{iS_*@xjX>&$+Tc;R`>TG(_&}eD%-y>!7-=w5u
zm66c&;=z^RZgkQQ-J}RRsP+K%MKDEU(d#p})%ZRp>Jx|Pv*n=_M^WP5>ekbT$?Vyv
z<Q#qlXcTB)Tpz@x^!N}Yep-lE&XeCO>S*k|@qiF@1zEG<qF2nM0)BYzba-`p)DlKd
zT|xA!?J{laXLu#mz{PnhE`u~d4)l@s-;Mr>BwG043P@+E^Fm&}_Vx-;Z+*eAD+84J
zTR$z<1V^yiZ<<^9SjRvG2TS6wlk~%M)1#qu(OAI7NZr0wQ#$u;9W0k3)De)X=c_b`
zE~{cuXdg+ysk`%2;VLTeQ|daB(TaBA-ZuU5y%mdNYjGbDw1ARKNul`-vBSi~N3mp+
zQqZcrp=FG{q#4sJvx0tWvPEpFEEE8KyV+-Q3*OiHLTA@(M;e5`kfZ{a!ZfJ`$mg^H
zH7*~_)x3#d$&6>WyCkzhlNRM=w4hRhd<12?&Xyoat;Jk3faEsa_-2PU^2ii9KN^26
z6>V>}<Ff!^vyf53{|~Cfkr2GGznouB#=q!n&fBNiKuWl;uih-SnOQM!y8<T*VK*hl
zk<c-v{2M8WljBE0I-?{V8ND=2A%)bISVF<hP!#&i6>T^^tBw*ArPMcjM)=XFk;-oC
z*nt?B(X#9%NzqF%ccr!hnkuPK2-FCN1j?NvnW0Ws_$`hlioEu*->;z~Be|ck^C~4n
zDTEMlo7rW|u>I{U)0Cw8QE~grLBC7b>bea5TH1^6OLU3GTgIu}Z5N;K39`AK&G>o8
zbEqB^adcRXR|)Z&EIV}>)~1RE5yp3^N!T~@Tzd=VRa)=X;8|@91mOc)8ejJ<O7C~z
zc+<02(89zh<>YR4$aS^=>+GK43qc$ZT*;nkrqsAaKU$Tk*PF$C;Ra4K(^Pw1l&Y5@
zXv1e4bnw3Zd@I6X8oliw-XN}O>t3rY0HmIkCg5fDtv(%nabZId?u-E2VjfWYs2t?`
zUL))CTc<kyB+K4f1yo2p73Z;WwEf#<Lf=JYT+^Lf|Jq#xhdw-1CU6a-&0cXmX!(kA
zphN&ESu7&orq9RH4~H>iPw3nd`xB0)*{QZASwI}YLU%X^C;Xe-j<!2{oFBlpzYtx)
zY%*&oJQs~gg(83B=18T{*Xn(?4Ld5jzY%+5GgbMr>BQ6eN-O5bw7S|wZjIecyYd1X
zID;N-<}dK+y)c^Yv);V-QLQ3>FLpuk!tr9g2uI9Se(b<~m6Gm4xX$!%M*Kb$#7lIl
z{ph=%iOpi}aeZjt(4p@9qz76PN~1_wl=6lB%Vbg}Tt3<-JDI+U?^R{1-&xl~_9ZV|
z6UK&{1}CS2zV?hj7jeojy5-2)_VNvmf$^fkaoxTyXCAMr7vH=i2adt)_Y<$ORsVXU
z{PQ|`%h&lm*`eZt%BxmOef#9{){x1Ej_xy$%zz7#m1iKQ&yliMBZ%kZV*%NV<4Uuw
zTB9*{C++C2jq7da%;)??dr4Wlc2#)6b#G#{3M0a4{w&{BF^cuXM!9C3N3gTG6oh(t
z@iOyV;NH~{A7<70uw3oPj)Wt<<z`2@roRqd8b`07cRsIXiOodz{Ges3C|<qwwYtCe
zQtc~`a4h?FL!Wun&?ktP8(@?Dq<~H;+NPw$0#B+sr$pg)sSw^~ueI2{D1-dj@%_so
zd@MRC<H?uyyv1&nb@NlW(#`mk8ackxIQmJ-yB}?%p>|Pm!3OM%qirOZ8~WUl3l1$O
z-C3l)1Zq;!Vqvntjds@drC3RoKafm<<j+oK>xiS~PueJ-T57}+ly`Lfp3d>TvIM_N
zr{vP<`_-x*wE93(p!SBiBW*4=wkc|gF;A7eb%p+|tZo&m&8=a$_;$Ih_%RaSOE1Wb
zG&uk!sK3wGO>(nF0pnDCa6Ljw%6+kwf-o<bQz4sClT>DMPhc80Jccz#2i~L81%u6O
z^-=eB_H;rZxsSpb#uFzx{s`E>iIn4%i@8o+jzSnu?f3hy;X93M>JY=T)T-KrQl%=E
zRjMx%ub|!tm7kRn0GE!EnGD5OvP29dtCq_quZ?prDMfWoDg-<A?Jbb0BZtdGze4__
zYAb^S>Y~m_pEi=0l#4sjZW{lr)L_bMHLF%W(c;$HwA|A9;=UTg#ATa;jq9x-0F(}S
zYtT9D!FY>6o+yw_jlU%omPA>rV|xcRr@M`$Yr6l?FYa%z<jg13PNZWDZ%N)1<6ktI
z;UR8!&5vC6+HYG|-hAD@`XmZKNn4EjU4}LBEqe+3Yl;*s%X0se5}jMi_xAewW3X(-
zgc&NzUFb{vU$%DA)zQaZEmh->RXYl{FJ--9xGYyyj7r?{!4zIu(4GorOq9PluSQm!
zZa2~%SRIc((&_y-oRzo^!Kzf`Ew{yNyg|s0_kUw~sX%olKHWV6C+DoroGBFs2B{`1
zwoC#@QH_7|{kB2h!64*nWo~X=Q<{_tB}qr2(GDO)i&bBd#|R?SWquXi)IrmB=~*Z!
zx2aT<q2WT6MKgPCx7_;GAC6ZUV2v7}g6Mitt9=J}wYmAKJU^HP?_QY~Q9_vSuWX45
z)WUz5Zdp#Pfl+6uA2Qu+MZ@Qo2-*90OjorgGHHMnO@TQf*Ee0n`dL3wifHundSI#7
zbu89$BuB^zE>X6FM)lRo7?9;4J}~_rVZk3e#W@PUTH9IngH%=Ma69(R!reN?O|_7N
zHnXd=<UHrg7@=?XIXh4?qLZrCDw9&pVl5|Dfz^ljrmMXNf@NaCV<mc-Ca))Kj-MGO
zDGb+&cWp|Dk78F&UqY@yA4U4c6Y$(ePn!5bcF$1wLzHkHZgQ`*dz;sxcG$1eZj&=^
z4M{roFSu<6KWjZanef9s?p_9ad<p6NdRYA|HC|cM13|zSUYv~a*=9U9y-nNAZ*5Cu
zRB?K{&nHh2tUpeq@oHh41oiW}s-w34Sd`@Z<kG)YnyKf%>zpVYUTiYSf7S9S9CX}&
z%OIEZyvF=B!UU<!PXo<NMn(y534|*A#%@6Rn<U^@oS+*cJkUi28!5!V?L0?if&j3Q
zr>g;z$D1rAqBr_C_#Cc5jhw5Sdo-F=SGeEGLO@9h2NPrbwGhdP`{RO_l+_hn!0#vQ
zp@&p-$hUBDZu;8e2W+H+N?xFzD`~fOr`}~Y@U`ybA=kJZkos%r>YcLOm>QoxTMSfs
zDj=ZJNa891i?^N^r+MFBSbor&DwulpZlxAC;|6N01C*}K&QP`q@h??~lm4#U-1JMs
zWT4p^YUunS_F*w>>*2k5J1+6Dz52a1KWd&XIu4)4jI^PVm`ir|!PE(x*{{{p18=^M
zLFcqWlyBsoF1Qq@syHLap=qup+!3g7b-b3(r{0{#H<zQ<M4b<DO&y^=63UBgFdz#P
zW37JsC&M3Bqw~klgFB?P{VS{Hr+Vq8@h2~NYXMK4%Z%FXwuNjSH`n+t(5&M4KFvPO
z&J4=JdHwx=f}DrC`dN#ttSof$N+P$KwDmM=<*1zPs2`@$-ak_KZ;MSnkjzIO_x-5Z
z7>3W~)OpXdt5;~QtT$6Peq^Ks!3DP|nM^?XP;lwxG*k?ZD}JuX)OnkFk$5JMxfAE`
zD+<+3JdqqUxT03&vM(Hs6J1b1Pdz0Y73<&q*J7uWtZHd*7nOJ-UN%Be(2u{$y3QZa
zyC_j_2lv&B^A~(5pwdI8emHgBIPJqi85@RR>i1_Yv31dmFthngjqv%}EA?*<?DZ?@
zG!3hc_+vE7ZU#ux3cotq$T!wKiW_p~hwyiTQuVT6(2t?#-CQX)lNHS{W373C3Niw|
zk*soM)hvrOVMZbIdtVYp=+|fVjwufWU>m&AFyU)Z#$!{^>G$ectRG{;8^D)_-l|nU
zNti#Hmezrt5m>QqZB2Kr>zv%t_fLkz=X>f+=`Z!&MU=lrXgZq9xzkh?VIz|F>fDQA
zub5UjlA4mn^qbmNlR}uZ89rZ3x@%>ge2|#d;>`j*9Zos=0WWr>#9U1JYOZ7^+J988
z?GqJ#zo?@eQ+m{)u7vcR7y_*$KN1br2@ozXXb1CebzSYA`nl){s(p@BWF=zEhJ3>U
z^#)hXTvCq!l3nl{l-a|ZdyVEr**%ORI90KDYp!D`+baD=^-Di@9sJH7`-t@7PGhgr
zJkeiJPuXmqs6J@|!Q1Oej?e0eUw{oeH3^@}7yH*`?0U7$u^$O+P*SQk(~P1}q0*mJ
zAnDOSF|;y{1t<A_LG-&Iz(ufODql&4Sf22~NJF*Bf;NgwJ_Pt|r~mlZeA$Ro`%}u)
zFh4rUqQSz^^v^df-?lp;c<ywHDrQ{PMi#v`Rbv)$vjP1+X$$lWS5c+B=^6q}434$-
zZCm}%eMqHdXDK%HAM+uVtT}QnbM9F^aCg5x-(qy8FMtSi0fhYf*ap8+oDm4jNA`ag
zqhm9f=<KXv|DnDpQ~zm;OLHZg%|No{*UUHH*19saT`e(Qe1{W`Nkg-7x|CGf!m=<v
zRUBIIcdZD}PBqz4Qr;eMwVht-%a4U63HBdoi9`X{H#wjz_=puw!4HY-G>Xr>8SsI#
zyrL(gd$u4i7d-XmGeVsP@QmepjNi~BuvT2-O>9RLa7fBDqP618RG=~q@mo(}L%HFw
z%-nG<V^-S~ArbD^P2!Usrw7A3m<~trtMT>NA<S@2^6-1`VshzC?Rrgd+clGs<FF(*
zEsn%w)U*cc;G0TNOiPi*BBqVhLzm>>oNloN<cT@=2ExI5w_5DH+(bQs8h)2&!!t`?
zq3mehEFQ7nnEuMU#Uxp({j!tYiSXmPBCPC8EQG6ZoLtX6%dt5JqvrP^n+?)xM*S2`
zz&t9L)|Io5;EIWhyiT9%DGnn5MWvbox=&={2061`#gq^ja^ZE_#CiFmd)7o;Y;*3C
zn4~9SGk*WVGX<UyI8#;8(wwp%`o!)1j{S^7jN98Xl<jIx3e9q1SI#+-rZ2BcCE2xJ
z($v79`n~8}0FZ4MoUl`PRF+qj#oOT{%kp~v#cwAIQoz%0=jq;c4mp#tyxRqHcp=!n
zX007spc2r^^qA36V;p5z5nB1s1r5yip-W0Ku;)g@VX7ROviE}3-Q$>aj?obJjJhZ0
zBDd<<NWMS$9eYCD=Q5KnSsj6FeC^_M|6)~wx=~ei=2E?)yB?h_uTIZ2#bx)~*HWsb
znRl;nM?n}nEBbJA`2A{U1uAnsPIpZbqNw?uIPbTo<f+S2lSs<UOTm(OH@$jhRYqgi
znRB(L8Xar1_jFM>McxH5yB#gCYdNJgrY4KA+)$)JId7{`c4=y@p#;#{;m5Uy#A9|v
z`iwp$_)4Zo1j*v5O2c4s*UCQ$G7L5w4zHh%w#Xh=X5CmK*6X_T)74qiTH6xt9zBXE
zvq*R^k$3%Uo+%c57!ZJ+I}`TqIN}NLT3RnR*Y?Kpt4d(ZzxZvlcJA81c*5u7o12CB
z6PKqzkqCtFXpDF|cUI{V{qx`aTVFe<Y5A<R_WDF7R2$JjI~GYFNEjyprTV)0K-k=5
zo_5f<@^wgCw=k_oy$u_i4Yf5fN#&ZQwI<3!iM6$z*G<=g#jVa<^QBrxEc*xvEt0`_
z)d`x-yz7$XdL$wfxAn=|Bts!j-uKcC+s6QMR+A;)6RoPm`vI?vU%Uxu43|F-u66!Y
zZD)G0kj*E38~N@c{X`ho)zrswgm?c+e=ud%^gjD$!n(JOW<)X$tE~aCc{ab;cy#XJ
zK{&HyiRGAm7CP>i>}R)?zOng-w@vU>+u^jLW2T{sWr>H&9qrNovIahM`+XlOLtd-5
zDfUN(SB6YDB8|GzrsWc1H63^zXdPM+t%R<FfuuxlX8CudE<}(mif+p>h=bj$hLgqz
z_O|0yK&$C@;&{5ms!CNXvBy*jK$DG5iHht6W3$G1J=(|ADZrgtKEy_NYoc3tpwZ{Z
zaBXSVNbnNxDFSq8$Z#fu$Y;|y5Fpi7IWTp`bJC+&Uj-t0oh*IaHnZO_d)AorN}a2@
z(BSP8TefLSVW4$WFQ?gT;@?;jMpXE$(c}*=RU19`q&|OV>i=klhp58t6qs75wrDB_
z?UBzNj>acwa{o%@u>Hs$9#4rCY_u{&HpV%fRG0@5mF%h0bs`)kJa?ZbJ9+GgU4+K^
z6<%zFJ#*>Dsz5?VHpU_sY6op9RqCh)Ysw}Ws7M;M&3VFCOH8nZqqd<34Cd!39HM-Q
z)s&x4kq+gOnnDMU4{=wv6p$LcWmX*>j0M1RXVVFCm5_^wSH@ySiBxXJ@d6mXu8=x{
zwXUm#NlV3o?I$4oaS>L!>)|dM&W{REx6o>c{p$NdI;UU(T?q#6co!?NBYp0=K+I|p
zf~eh0Ij7aXeJar6K|XhkoCTB-_{lYSR+&DQp1Jn>fcV3;gKwdumc3MC@@?@;p4TIX
zrP1pR#;n`9%1W@$3nm2`y~kq?Y=O~)<)PsYA1abIx6Qlw372Obe1xiiU!t}9p&`v>
zt|KwAS5$}}rIv$@Cfl)qg+@{0Gmpof+6ljJS|;Ve-9a3KA8v4PSt|wc(ArCXjjdW%
z_KDR-2h(O$x*H_!7o)=t0Tv~~5EGxUhGEF#-~BD`a(h~{D7IU}0G$C!N*PK%XHFr7
zj&T_U_D#EEijt!Vq6AYj_P1zd5@^Fpybe>Bec9KW<ta+sa<sY%`!|o)c0C5#@EMvh
zm5q<?6~voT0Q#J%Nvw-C$keYf(6|UTWiKZ!=h7Q;O3-J7M0mNY3Bw?45g6jc;C<7v
z4&UW@>A6MV<{8Wx9m8mTo+_II|Atj{deGxaE6nBH?wR?uBNjlr+9S+uhl)nVFqV>p
zF6T-Ib;Pt?Pkd&mdy=IPXDD}7MFr*WN!Qi&qtZG27xT~^UTCz;lCa`zttDmZ=b1%n
z=?}^uZJ?h$s?Emm_0b_zZ#q+?f|EjGNCUsGa5E(~uQrJCQyfQO1sUSr%_hgr?{Fwd
z`UF&dMaE_?bVXxNeX&>+sZ%nK6&0D+NCN8z!eC;GuPp)nh|gamp9M-ReD(q=*FPfm
zA{PQ+EzcM7Li7<8+&lDSOEpUT;rEzdQ*`TgMJv`dy9%s-!oECmBmQVXia0nf-zzG9
zJrZx+-&tLlmGH|H!A-Pk8$yL^-)W=BL&|moe^|XkwD3oZ9=x{Z4QeuZ7Sl22<(L1B
z+28oRCnwsYB{}V?&TR!<sZ#^ZT?IDXlbJ+sE&bl`@K5(I1<Z>t24D!lVnfniN5sq>
zzv?GVr7xJ1EtkzZ5A4Ok0zEPOywXX1&?fu?ufLw}q$#pQ$VsoeTWz%u>lcx^9I^QH
zx|3D<0FXB6$yfY<c624<$)I;uD5)^!joYJSNF0m<oQ8HLu5zXqrGjz4M%M&FM`)?S
z9QM|BTUm_9R~5oOpB&p^@!YJ^<v`#foZ()~_Q8QU4H@(AS3q-yaJC7<EzD;tr8vmY
zD^0?^cap!30y(hQ$w1*SzpK!X2YS@OJV<{bc1iC*n-4O556>Lt@v9bXK8VnfDd4qD
z)>+R<Ujo4Qj)#bu-sO>QEhSbwg(tl+SA<lds%n{2b<8Hh&)D5#KAdRI$D}Gbw`=F)
z$mHYo{!pK_e3TPnX!$yt;wYGfQD{IRDJ_*?;sqN0vscW7lCVGJBCNf{=mw{hv7d}r
z%pyHEcSyVcCGcAI=k0g}+fku|M%cZ$fGZM<3+B|HX5S3zZi=E2(utd1;eU&ZcC$e&
zDu2J|%ofRcZ6`OGib2gP!wi!KCB8NpAy`D4YagLwMAewX3<WM}Pn?bWpxUuZ>*K%~
zzXD=qPr^|vYG8RHn1md^<T)(}J69E=B9LUXfAzV655rYQxzeMHcFu%|V@p@+Cyy_^
zxIzev^An*XW3Y77<;W@a@Y8R(iv7OaDF3lhnv@En>Z>n%DihnH#rZb<6`9wIYArX_
z>zTw41Ui<dXVk}w)GJdI%JQGkyJ*Q|F?gJYMx4D@w4Ud*+hjo<7qCUiML#Qn-KG^a
zs6%_Haz+Xwr7T0D1B2KlR?n%Ope=qtSvL`tJ2HH#v*OpP4D9&DTnG!;ZyGi@bEZbJ
zLb<o@S@O+TyVPaZ+7w9?FBjpyXj>Y<;jO*OQ2*;eubqGThj~wtk!3T%6mHvd!s>P6
zuewuPSFlKq@9A3pu)n962d`9ja=79@In%q=JE8jUZ8nrWK{(=Kuw&FBC3o|(rc&oF
zx&m?rk&CzR0Zroxkpn(l5SBA-+W@6aUlzdD)NHAv&e-D`oM___$iAcg)gPEqt5=-z
z1$a~C%wGw@Yiz{GM2r_;r(|X<NC4-C0B5316d`mRTC^l?22$Bcaq+Qf#XDoK#v$~Y
zBXx&LewsS0O&=jtG7-a;KmeJ81G@cb7}S1D3Onv+Jvv2qdwm3=xysZ!L<DMg`^8cI
z0qnlh`HteQ`UNjQRw8oJ*!zZ3(s!}G9??>13wM9Mz79@2dO1*;4Jq~g;%z;2Y{6&W
z9WFlRuh~f#6E($8dhkUEY_zCi%})Uz@l%}4kY@Gn4MS;!ya+ku_e-h7cLv106Q(I7
z>8XU)t9c9B&+5;j?4>gXf^lt@iwV6&19suP&&WTfF<gGhf=C8-VN##w8_PNgZh%wo
zOT3>Li2a+6?h@Ew)uZkPmpnMsOzagV#Fs=v-+!vh)$#PQUKgcDi7Sw_VYpo;q%f29
zt1B8_Zn<k%h&+8sPOblp?TCck-jgLL;`(sy<mMZJ`TnBVr000mFE<sQtrmN~P+B|u
z>abQci$q?YK_0qUqAUi(S?0CUTF(3lye&M00jZOsx~C{=yN-MYY;gzcS;Jk)Tsgw*
z>P&^R9ca`w!K9?nZ(#J6$dB(#l(Z5LlUJP1cf!hQh+{o+5em>vjHR#;WOf);M~cWb
zeBO77<aP96p7JcCHfFn6k`j$4O*#WCV@cTE!r$^$jWFmpLYQiV)37LPhKKQ=y3eO|
zR&(a+F|wxcWAvT$R`XuHJsyQqod+_fnvnXm{k+X0_j`LFwVk`uwv?x2V?KWtUT1av
z-N4O(467DH9>q9_5bos;M6K0^L_DFMMa1!q)2&O>>D>?bf>Da<Q~5U2R?~Q-nV>=H
z-y5m+Q^y@=K3nKJs&dq&ePMA?BfJ{mWUs(|;x3XM6;pCPaau&o8^-$PtHk1zGIjeL
zDDsqneE~Pznc3EiLj-q^7oAj3^dM=%A-^Nm=6(=9>Ls<|by!n&(01z^uJ|v`fEJhg
zbq^<`xz1X9q#w>;-(n_FZCC(3ijRf`I(W{KOh4?yqhH#a9eF&6L46)@vuPj&C!ys$
z9UNiNbN^mgAlW>2=TK1bR00p`<3pjMNVj>PGm)WXv)dO)jRq0ByTMhL;i|QLWQ^VA
ztW39ZKOnT!ny*K;GDX#J894v+`xk5<v;~}g1H`YX>(y%}pvI~*BI!<9;}Y*kaJorO
z*_1h}hs(FY+l5{X^k3kFAM@0@SFT?_7BOB4=gq<nTaX_;9X8712&pFG6YUX)gl<4U
z{x6Ut<;=nEp?s_$*cU1Mytl1mJAnw!xvu-wvl^sbN0j}#f6sUd*dhSOlB4RE%i$zI
zD)vNlWzgO%QP(9F{nWf5;4hj;8T7gGm*s2zzSXE7Le^ZsU_y2`axS3zoxLPCY@2Ow
zn?>|1Jt;_y!H)0q_Q$oE$TDSSUV^ThFjoOWUq@1n+ZGp*k0Ta4z<u&~OSeq8M91qq
z`2N!&S9ksBXztp69%R*s<eJ9KJICX_Qd-zRtE=OhH`RST;!t2)vUA71`7N;q)=FKL
zgfB}s4a*ONv$sc-FRMa~=b)~BSM|v_u!V-IP)~=^)+|9+7|05HRU^*>RjIHXslMTt
z;=reX($kN7eKo}~e_bxik%{=5;A)P@%OKsU*!%@9*YM78+l3Wst}N`Sc(;Oy<?@26
z@nADeRm{oO_t(9~LfoM=5teW81(5O!L<7(u*SL`+6XzFA1U*ToHkm`EMDL>q*EzWq
zs$^y8e&hAR#hTls6&gil=L$|x%BflsHU2!OYl}qem>K*fz5YRW3#hEW^%!>9b;}9v
zy(_tMWlr41oN6N0Rbl)tjG6mjx;lkKiR?TIe*xX*Cqq6-hjv;b0|PbM>T~TC)d;ri
zuQEjjCwmVDfZSLz1O0!b;9%k|?1pr>_9Nr?#-I}FDm81^oUGm>!?z_;8CtpzqJ6^;
zcHn@l@^$KU0YdeV&ngutbQ!F0-5}7u4Pq!2D*(vc3wu)$`zVqT<i01k!$J9dysFo=
z2r<DwS(LXR4_hb+x~JzTy6h;6lv5hq_dmOjy7*>OU`=R6Mv5MHY)lE#{=5@U3+>+~
zIUFe-Ay^^Fzn1`ASs)gq0Bkwmo)A_J?F%0$C08vxJ)6v{dTprX@M2OPB>a*b6+H^^
zg0X#2CpH_^Cwn3s1e@BuKMhlX*SE2iY@}JvKg|jl=t(h=LvbVoD4cxi9QaEELME|o
zO0u##B~ANe3g|nm8@M|Gul>K-J-^vG$pPh&d}IZmwHAfIW>`sH?eq)to<Bf8#}5`-
zBPKu@FT>d|3KF>$EybZ|Ayj1QTQXTXKAkc+Ng!YoYhDYdErDD{@&f3A9o}QucAcvF
zy<;%raT>T_941k69;nE1VtWI`39-e{o3!v>6elMWw)`E3pBY(Fz*5zmB|r~t@2A%D
zuvCYn_l>{k)41zsU+@t;E)!7Nx+p%>z=5KTwY9rV1cV68`-O0{9d(ZY1(I}*E)#1P
zLAr|Kr#EsX<6#1lp_TZdF&m#bzSw8fd36W(K%SC18#EC9T$&Yd|5a*cWD(3c9iO>u
zdIgVU#%!<~Q+N18TOW;w<j-mEAJToiI7)a%6FL7voC%5adWQMQZnjS2tns2+X>hx8
zLb(CW6oY^YJpFN>$|h=~Jzqa0hLFx&)0U55PLDpVS6Xt*Ga$_|y?PC;CRq>jUg3M@
z>YS~O_DiH+Y%vJux2th<pa?x2gL$d(LXZz7rk-<KM##(bb0cZsiuTN<NV7{j*0?Nm
z$?y#`V_<Y^vi-VI+OZZ!+*xPym&{Y}W0f_p-DbT#)uY|HPD??ZR=JN(m*!yMey#A|
zA0CRujSS5@e&j5UrVBo9cy_B?sDa!?&b9Z`H25DP{b817w0%0fDSR(`5Sqb9eWLCu
z3k;>CDy)|rUK>%<D7}BZ%<GPgs^Y9E*ojl=sneu6iGWSj+KLYN9g!6QHm86;z{9HH
zLgr=j#|{3uD<5qM>&|(b6`Yz-=CbM3PqqGmfm}O<_M9dWTQnsPJJI)<Ef>BWBWtte
zO)mV$y7%BzR#Ya>$qORUu*9Ha)WuNsVm*1H(pB)yn^3;MM&j`cr8hK+2b~K5LO-e@
z(5&Z7Ro}kx?aP#;&A63+w*X4RvchSY7%4sMV=`Qa#tFyF8Gh(%Cz@VbV<(3-i^8#8
zWx7tQzzXNq`Of3Zo*jQJsLJL}E<gJjfy_iD@W{b%3M{=5muSOp68)~`Ut2w_QTQUb
z_V9NNW5D98h*PBH@@+S{=yU$Dpw$-rmy7(z03*Zm>Bp;p)Ck*ZgueQJPX`f%|9gm%
zwcqQtS3ZskJsN`CiOVDd^T@KpyMRzJJl|TRPZTBani5v=xU`Ty+kELw%?A0b-pY@8
z0bz10IzkwhdSXFf;8k<5p%zuZ1V!u9t)}QWlzf4%oKNS7o6Hj7-Qk=5_bUIp&lfi$
ztp;o@Iw|8cW!d6qTHam;-J-(a>Ic48Oq57D;-iIFKby?~9nGTX#AEM~>8(;~vp+7Y
zA@dqmK<K($xM_V5aFv5QfQAc|iog2x<V;yvaRXs(tAT$TLU9&znSz8?TSxC~eu$Z%
z&A#x@w^MY#s$9=o4hFRmcV&Dbbh2H9h$Wq-v*MoPpHwbBU*e5We>6Lk?xs}cbG|9s
zXSjRq$z_<^FTM&n7uSXvFTu^AarG^}KV=LKvGjY`y{UCQ=A82$eM-kRxC-u3meCs8
z2IXZ%%R0z57*k3vj$=@L2CK!%%<*|hv$MlAep<G|rQgNgD4X<Ja5L<W+6Uf!O*0Z8
z=IN68g+=eW2Q6h|YoHu24Lvp*ba9znLy-d2*OD0GN2&mGpUs#<s*%8Q3SfZap+LK2
z#wn0ST1#UBetVRE)1r&^*0?Q)L@hc{;y};t#;m6JJO(vYFs*1nfC!V>RYN#7%U|S$
z;h3N2*yYJYV|sdI&~b?)P-EK!znWD(Xsjj|pDn~1`m_-Q?Mp>+ms|_nitR#J@jUI$
zDUFc>eA<i)`S`7JQ>*+co=T9~kX9^<SAKGmVp@$)i5J?*7k6(JM)7U6rCQ7rr*i9d
zJ+i<2SD1`7#5rB0&iK-P<+)FpD!8nwyp@6E$v4ecmg$b9Ree>R#>h9j!ybJ2GnLO@
z5$f}D2U|BoFE*R>&pDu_Vl8j@qZsdQpWhu>eD`qkeV96uxqMey1TG1f$4`yphyU$J
zWQ}$<@@!ogKbej+bbEC5@iq03o%)CIcU`!SG=<dxoKUW6n}SXx`%~6Ww8-N@K>UeF
zFZP3|yWbvD3kYJ4<XcR1I$4BVZmoaq1JOX>RcN$7KHQp+j-$Z91*hX|G5_Z|l+@K(
zPJSKn(0j!*XL_Xg58Dg4fSGY5%P~N@@>oK{%23@WHpI3*A1O&uPgrH`L9@ufMOAC@
zw77ZI06Z%48L4{l9niDhkvIbX@3~1q*)Jr|DE9kuB<SD2kPUF$wGPF}?VzQihCiAY
z2x3W`n>&JV@841L_0L9N!&W}wcSo!g4euo=RMo)yf>V1&m>J5i0$8v!hrn@dnhpn2
zzr(DSV^J)~oFTy-8Eqewn9xM_h%o<<s}6`R@<KC2x?gr~HDd|1!iHfp$Mcs<47r)U
zn~09ne8T=P;-y;24E%!oAn*(mr0!^jPT_aP@o~c#tQZj6@;JhBB4`!PE@s{rx3Q5+
zde1#%_bjHT**FTf`HAAfhddSA)S}kU0#U_ssrld;^^9!TxD%I1ApV*J+OW7J?W}Gx
z>iLCa!Adw4<VX6}oNS3|+ZDRx!+qI^hdLSRF20bO+B}o35ZtNjDK8%$Vs=HiJ}y6@
z4a3w9(1f3w?KsBy8U*_6@u2^6_ZpOpRA83$<#2Q94LpI_QbmSCC;e*1m!5u2jR#sv
z_fl-?c-HXxI66S0*=^$kk$8+~K?F~@Ioh(pCj6p-x4D>!-mga{92>Nav5rvUwn(u0
zrzPsc_<`_2Kunt}X=nI4@fA1M^Pcj&I7s5a0daOZZ*7)S1@=gz`i1(MwTS#%=bAti
z-!^gt1|YxbGJXsW!@2OKfXCZz*pcHw^lC$@lfBzD#{>K#DsHi9`TBOO4Mp!<dVk^q
z<Z`NAnt?`PLsZZ7@%W+8AMUfcf@4h-yJWN~?+SXO`1d~<_;(6VW+q*sQkGcoH1n%F
zi6MtN4LHj0qpejp)mUe*iM|F-oF-v~HSN=EUR5_$+hPY?w|?AsvE%^%)P}s47ipMt
zjM<bkKf^8f7K{668%V1kWgi*vF7<|Yy@2G}cSvxm;tk!K7v17`!oEDrTXVPdz>~V|
zQffXn@OEmvyh5G3I7YoH6Qs_~-JXn@9C(P*&w(<}`OeNybRXdr8=ZPPZXLFWSB|p(
z?BbWzlrNn=P(A$lw%!UGJ@P$fVzQNK{Ld=MIiFLe0}AFfB8BSO4JG33S8zM&4lM%S
zAznDpGtWJ0_G_<)pl)p<-&Rv=?Wk*@fi{4BV41(tM&t^q{gYl--mdGB`{Mnv8=Jz1
zD4Rb-`(lnn==Q^ra)08Hp^l%U(XETcCpwbf0o#RxyiTu)eq%e81RFVJEQx;0Tu4c~
z9E>)-yM#}nJ7$3RSCUaEBOKZ6XsVNxWB|4$q6!^rK~Fjh4~I}721Eg>xGn5qJIw(d
zX57<6gz;=maiRPG&xtCqx}dMz(5zIvu0%;9Rll`f=TDM4#O`DmLXytiefS}?C^S~^
zal+puSzRgg>6{9v%vDNSTnoE-MYEvO7F2rTPKmT+CaWUvR_{hWAU0BMv3F#L{Zy07
z7F_7mfOM&!w`Jeii8Z}|DW#-oQqatjXIrOj()jp1EUTB~N23UWN23pYCd2S{l;Ycl
z;bHroydkcG8@XtCo8eh)$p{ZxNIN8xfC&^j)(<W6`%`K6oeJMK0ShRQ0g?qyWM~lG
zC0p}lEN`qIYmv7_>f<&4VQ%foa<vldGr5!JO)>cW!!#$cDelh#azv`it*=aSS%&V%
zjlM9SiF-14$s+|p!!wfVgCfn3CdA;USS34eDsK+hy6RE0u&7fTLv@Q*HP%zUsiA~^
zTXxH22V;qGKB!a5to#R=+M_&M7b0|>{W+P?)w@1K?1~Ovk*urk*EN5Hedk=U#-uOM
z2Mg3M@Tm&&?gFfkmgT@JxzOd+gRepFZBdRN_ZH66(&=&hou~86L^MZrdZF=*WExYb
zSI;j5DR6mvj2;L#=NGkSw_5;~d+qDXX;yGzs|Qq8M{+(*FE5X}E~uCl>TMpY-;tS&
zIDllWD^z;P<=07zoCkrW3g2>Ai()CKKMu#)_?9{$xK_L<<f~kRwOC1waPX^sLxJ}P
z_v6-ZW>}<??rf*Zr4=2a(}OEX=fdb_&6`nKW~~;w$|y=^@J^9rK&WUpQf~=(MEsh(
zJG;LwzkMfc@89!PU{K{YGzbw2By=2^?Z2d+8^*kX1YSh{_@J3SG>f+B^SBxrP;74$
zyfmHnY=m>UO77Hjk*It9#-PzsbMDWzF^>A%MH^r1UjGi8fQdy{Z}471o1JsV3-n_{
z4xepnZgX93$q5Xo^NB*lICq)Hpcgy>KK6VT;FgX$W@>zJT<VCwwCWz8r)L{D;*gRu
za>F_B<b?*^)1<2Qt)cq@A@#vieWr!yw3-O>NAcR@XcJP?CQtLxdE#r?ndf`MI^)u4
zmXR7$_ho(3JzwjXecZ2DT*)0Ps7h^fYonLIDL_YK$ngTF4TiYg<^k%Ib9)RayTW@P
zv@vnh63WGL(rE%e_Iro!(^;#I?7!?)P8^mIuTI#_@FsKf4J?prs5=RnzU_K+t#GNY
zez9fPTaGx~70~1g<>+qmk;vMo?zK6)d9JbcXh8noa<N;;z=LP46S#CfHtEHG0hF?n
zDMMq%MNlsr^gE$Eun~GEdGCu&SdBhs?k83RnqM=maiB&YPVVj_d|+#?svqCgkqq=3
zt;i}3Q|9s>Yn<G17N>I;Gg`rNg-EnpwA!%gX?zS~#`m4U*KYg({!Mhcv!XF~3*F5=
zelGjR{>Q=zEZlY6e4LHvJ=^E+HRH_{3X`IMIg7=ee5sEStIcdAp|Z7wd7X$?H#Qxv
z-d^zwAzvIU+^L~4iNBF#E>T)%Ue1Ei{4lzD#K-&Zl<8K#En2O8HB2}89)L{WRug`-
zz*cN1am~R^vg!Apu@Gj(;deC>aSxXx@2X0Z;vbyDzTkR&^1>OGJu_O7Ma8WSWPn1N
z-}_tfysRIA{}+328C1!#v<nY1xVy8kfx+F~-JQYRT^8;zxC}73ySuyl;O;QEyMOHW
z-gCdR&wI|h_um_FBi4%OwW6y!D=YKqtgOzb^EafTf=*t4R{}WDCeWDL0ySC*Z6R84
zE$^>cChf7#oV+ALb+BNndHV22SZ7}FZg$+E<J=`vG>g`Yz9uaRJB}Q#yL~_>Yn_=w
z_SQ6KPH`Ur^bf<%FB0nN%x&L$=_z{FHk*Hm=M|8Br<(dKR%`UVyiUS^$|e?e?>_8@
zC<*;((@=P+aE7-E@flDP)P*qSAy6++PlRG#c-PiHdnsRkYBnA@0l6IKE*v;zb`d5}
zW~HU&zfc~x+t0V7x%smO$$NyvcJ2-{LsX=nRbIB6>FlIGLVX<wxIzz7OTb`B<Yjk9
zLAg3(?DT>TcS)h8ciq=Hd>MDEExV4^7Hu@;p>pn^6S(SZZyDNw8Z9x#3#|3{GDg4A
z{$A$2?QI?y5@6#vRL8++HRqoEKE!j8Ms11l$`!HdquU~S*ZDx&ChstM1s0Nr)q|HP
z1T`*%q$$-)<)kjng}qu*tnrp>Y`Kfbrz6sP>c!7?(8vd$HSnqfd{4I_f+f<@_1j-M
zzAYIRy0tX+_)&_0mk1($_kv=OhI<K3Y*TnSv->j`LUbymw=^`fBC--A5@a1er{Ypm
z$kSeCo(nJ6zolzuK;s7IG^qOS{2F7}-)*&%!-+Y7$K=`ff|Y;y@oA~TuI>eM-9Xad
z0F>KkbBV3V!MwRJ+dW1!1+v)@xDVFPYs3g`W{(NTU}4+}xb9_HYc<lGw=B5MSaiCI
z_$EwJzLjgufk@XY$7Yoz(*&V;a)q-!7nQ+?|0zP53W3Oy^5~K<$&4#bp^U%in48%#
zyUgFL884lnkYU~hBYmcAlBIM*mbXRCBVrl&Yhq10G^#~gSD&-3G1-2033uNXok4MO
zFeA4zRxyYO;jP@5#9Xc9C&#U8Vr2q)6Yuh4OQL1jBPg?OK-5($D)jDqgdJ6+Bu2cP
z{x2UigRuE$)eDG>sn&3`fuVZWty3;g&_)*=F~F)QDd+P<j!rKp|5o(HGVTo5fSVV`
zzK73(@Cgl328Y<2vFWc);|lU7nFw<lX9hi@){mI8F8Tr`ucveUIesd!a}&DLdZD#b
zk^_jku<nvl?rY|=B3oxY({@hCwKmUZ+CGz%R@SgzTCrj{J-M>Qx#T#e8q-(L3{)Ya
zJ`42qMj}=h<3>d!R<_})M53BF^=dY6y%GEYxz<q0I$qW1_$@QxBMp204W<#yryl1)
zOYW`NSgpV``1-T9h6Tmk?E$KJg`8KSXvp5xF{fA5)H1Z&R=bXW9>J)!z4gt%JgwSA
z2#Pr|dNEO+Cv{6{V(xTpJbm_h6-S;D-9f(8eP*k-Y_`~AZQmgz6F7dFpPziH{1FL$
zfSXYB#2Kz(+p7z4WbdcE$SGj|<r@ouLU5RVhiHX4pLeiln5SobOu<mA^m?;g6o5FB
z)AA$$zIkW2IT-_3fq=(>Ge6MPk0yMZqCYJh(X)9%A<XTNh>FROg^QfKt*<+G|D&>{
zu7&ow)+KJ;IBe9z?quqUTv$1!%Chs(yPuE!oi#T53Nf_rNvA|4TE#kW1zD0!skw(`
ztj>y+uk92u8DkDts2+~a<C5@5Ey?uQSXi!h|Mc7aU<Q63OvTn0;ro{3TH8E&t9P8Q
zXSE<+cIis_Go9~LgMvM~%@~m{9T^>WhUaWP;1ZTx+Ad@1v=aojE^t=sO7)qpDLDbx
zULK$wQ(3{xeV=~!heQuQr>?n2u6fHo-$=#u0Z!N|H>GoKrF)?!2eVGoG;P`d&?tUT
zLF#YP(7O@Th_*xG!>NT;fn68KSfObGMarBwTpVN|#Co(6k-TJFD-j7w^_vz1pxNXa
zK?3MBM6)MCWxpZlOsaw&u%H--;J0-5)B-za-I^b0Vn6C!82JqLgL|j_Z>uX~R6>U%
z7guPxR!I!0k~_R05E}((QjAg(*P=zZ?!{MZJJ`Y>P%uuJwe|3NO4oPLbyNyhj6c#w
z=>&07Nc*j~`?=1jN$7<DbCHRCE!IRICufg~V%PQ2TFj9ga!8zjCy#J7NgAvX!x%b6
zv5whSvp~;<%8*$RD5cjmG=hZVHZk9C4GXD!-I)*<u@0fnYaRK>mbZS)pD$Z6H}%Ud
z`|8a)_-`@ha;!VrjmN-%Cy0vmc0^O8%{VS+*DA-m=gVD7L1UU{eBBqb+L!#cI|&wo
zRDg~q0JR_)^NZYewl-ppwtZ+f5j}*30_JgR!9;Ai=|n4AjL`csq;R4?sX?jFRKxeW
za%JB3YX+?573QyviNdRLDQs4*C%~_G1eB3mYew*IoEu?Mhr}ebJ!nqfEc7{OQnVBu
zJ5Pl(=2*$Xu!y|4Q5ZY@Upza)t}~hzP<iJT99&Yg*Etl$x!ivfbO(4aLIBz}d9L7y
z&b|m#F%z9{=GTLPk=o<|I8G;Ib26rOVwE=0#biNv3K^h8R<Ul`(+hbNCJX7nE@((}
zfD_&8OcT#Tz?6xo7Kew4c=8*~ic3`}>g#8xgc>NONBrfxC?t89ZJZ+h7yLH!@M5U%
zF1J9ZBgLsGC;v}|D07xjD6_GHDYHqkSZVS^x_P@|O{iLldYeL&;MWb}qLq{2YjPAl
zyem0GCQ6D*(r;|K_b=t%JW@eHLusuZKLrGq-z=)fOKYupeUmaKE|9e01ZtqvpJDW$
z&E_1gC?B*yreQ+Yt&{!>w$2aNt%X!qYVT7WFZ`aR8Q<2A{)pOK{Ee`kI!!h<2HOr~
z2OL#-E}6kA8eJ<Dp+$eLqeIP<>R0dyhR#8js4)|n57?~JR+g`)fyj31|FEdPKw3io
z2^-tW0D1#+dzcLzWvYzUZRC6}Ehaxj7H#{|!_z9(wJkzO6k%}LV;gQluO4YP^r#2*
z%e446$K5`s*TuC-Jib6A(z-JxR<2!AE&<oEuj@xNcmLKlR~dQ#c)|9k5}5~LB+tVf
z>41H$J>sCTlYmhFLcv`exU2>dNW_YdZ2WG(xZY|a{#6NyoDs#-Di!1n<J9FkKY^PN
zSHM5G07j;`?w01p3h$pkav-UImehi7`RLAxD&3P_Z)<ay)(i2)joJ0$sSX@88mo1(
zSp@y?W%|N%9*X{pvx3;%vDQxzQd}DhIwA6RNP&#;=ZIiUd(^_*Wo%6<OvPZ;;@aS<
zBt2>;&DU45gNY_txiCoq$EuxouN)Aa-rs+4SkqI?tNkGG;7#)CVSN@)&bg8#cLgV`
zmy+&#E-MJVq<#A)bnaa9l)m?j(l;e3fk}pR-xbvbw-RepDB8iz2z@B$lvQ-!rIdc&
z=5yn!YD`iQ#Hsq=%!BWlzTzm#gTv_&JI3zN!?EINt3;|Px;nMK>Ji-y<~9{OmQkR=
z*tL9KXGQT^^22pSdke4bD}t=~`sW23Nw#`I%mlA0T-UK}^>(#Zjm}qOQYsSn1KpIl
zq;CkVdi`xc(rH7nS)`8WagCHSBgfi_J;~?xYX7`>O=g2wQ?UGtW(X8)1?3*0wTxH+
z0ir6Re8C9m#H>)#@6;$?zmiQ1jTHFAJ1RgDt!Bj~=XETK(g%*hUg#`ui08d>{X8SU
zMigOszP>%-b6Y`>cy@`)6Hp#%&})T6p07h|1FtXYNefeWkhP_3^*;N?{^iF*pK$T}
z<$lfe$>+?T9CTdgrE`Xqw)Y3Z8_NQNq)V}w7r4h>i0+tj<JILzhsnI;<OXA(GH=gM
zg4HdK1{#PG=+rJm<VHHHb>v%*k8?-PSBfF?1&po_1`&1CN{Vl~h4TYYZ@<ejcRBi!
zCNK$TTj`&&t{~s*Qzxb}@BA!9jR5D1)P28Y>5xi=b|yw^x)Hk%u>I0(EPkdEIZyd&
z*>)i6LA`<#$WG*J39{7X^Oki!0OQ+2R)Yuj2)TEVP?~ra(<jgq30fA)!sWvW>jZ6>
z0!inNOZ<(%&lUzPl;eV0??*he?mzI>pmhj#D7T0p$=!ANBEv)!;nk23X?}>XR6n-f
z%&QmRR}pkQJm}?)mA&#M;tg8I!1!uEz8<OmdGgz?2CvMUe0>`?Z1(D5vQdA&JrvUm
zrC?E_;QA~_#*`Mx6o|(tjE(q+RiX&!X0?{<h$Yopw#pjr<U{IV#)Vsn$yobKs`mO<
z)k8%?0AsOR3*v3|PSas%a<pZ|=j~ryk(N@OEu55J`*(5LeLYS^q2rbhvDQ11IauLA
zmc8*DMl8%gf5-<$ss|y>K4pza#?0=eL2PQtM9l6q-b=S+<=q>&+e@6~32Qtqwtu-f
zbaR{bg3N7ob%W7<v8bqa`OU(&?*#>2!eOHFb1I6T$*Ir!tULGM+cAGg`Ni1jV=p(V
z&7Klz^km4dUvlF*6omn+xnQMPHlF@ft$UkZmHYINxhWZbzVB35ORVoE{_H$$?&!mG
zV8|tI_;J<m=p1C830jZt9cxtut6GIE9=;Gg#YKQ)>T^F`!rfJtN5X>f_(Fyw#pC?@
z_R3oaEY329IjX{NG7ad^1{tYNA8xLjjI%XXqk0~yd5(UpeU8QR#w+KV{i6F<cDQLb
z6-e_%_mGbCKHZq_Ch|)5j^)ga)+|nWw;l5_t?3=<fWa7&RkWL00~nFvP7fCbK4+ti
z-XgWz7&?c2=v_^b(5V}FDl@I5)s^1a(yy)e;RqxxieA$%nH?kLWA7Hn5@o?`cWyy^
ztcPM6Xt23pPt2Ml;KYHGT^*wA1W|Ym<_ECP9_bbUyrw(d?O&MlZ_3nHJ(k5F-EPxs
zJTiP;zgsRV<V?D$-&RK!zJx1n8~tekJp}OOy=Qj=W2G(!ixn9#_;r)nPW-kQWUBYc
zT_sPFp1@`XvndzUz(jiM<?8$lUk0vg5J}Vtxu=aY{J#*^x#f4#!ZZj1YsfUC)t(GV
zud&gFjg5d}Zu%+L$*NJoIRlo}6N8n4CP6Z{RAQg|v|yJi8)QHu6&kgk6%k#p<8^q{
zkS>(R)@xNbUhQ&0Z$TsGb}Yj7M8!iZUwyk-bpYvYx-<47-0W(C_m3|Mz}=PBmK0a)
z+b}#R+~2f#8^(K-71_;0mu`?V;(W+JJ;VttC!5C9x##I#tg>fQD8(bvnU~T_6x@Rb
zvf~CF|H#MhCh!q7il4RXCB7T-byxA2H!XnLK~z^ByZEH6i=WOFKQ!LnXkh!vSG;|b
z8(pv&^!`22q0Ft;ZnU%xX0zUm2TECS4@sj(Ua2vMXZw`p)e7Qi($9}+u2~inA^h+y
zQn3L8?D6@Xo-Mvyx<2PiXyW53Px}}nC&g1xe^U5R)Y{rjB?%XEJcf8~;ohSLtkFnp
zyf=P4I%EAhHw?oSz$%WTeN|mxS}1qXk0PSUCXAxwF*cVD5vKuZ5hk9Dlu?FQ@^@Sn
z=vEv~3U#<e+m~tuq=2|h1bpAAmE|ub6vYG1*5C_0*O$=D)SBTJoyoS}SIkXvCWN~W
z!m|v`V)zJ2idC8ICodoGGd}o4XT7|}B1=iQalEhUt%M@X&vSa#J1{f+?N?|dy{q(!
zU+mYXaf!v>(EYbckznfagmSjFeV!?L<@Y&$^>q8y9Lr5g>V$q@ZsG>rnOQhqC4d-(
zSfd*!;x6dYYdU^_E)K48t2Wac1z>(CK2RefEsn?xi;a+zc#c7i>Z$Mo)blBXBcpu(
z1o62`Mc_(K$@|CW3%$9vpTJ*GcY_pft+=x?(F(i-MDRM@0hgl<k@+$~HAocks~KQO
zIB6pAl~PFFN|miJaOJ;-_%vHn+LrSwG)|npwGDGLAF!XHqqh@*dV%*^+-uH_ds2y~
ze3KG?Dhs|@C>$3JF|1^OVik<IiA7vDY)ZW-SmM4&A9SwmSiwsfD1uw?){@+xq`PM+
zA!l%FIxwRwkNcy1W+@cfri~5|Mk9dt6k^ABqzB4#UP;iT)uRv{@sr*?4ER&s-W-D4
zFjzW;R_16f-WHivu<>y?XYUHcAmcbdt+x+egjXe<*Km}M(dbZf_Ookx-C$nkghvmK
zX!><~=gMCD=i&V$5`DIc%*4ag#^GPs*D_)k-gUT@gHADev#Hida_-W}mVt%1U&SqG
zg<cDdx1VILrr|<$n?7w2?du55y3#B`$8qYycX8$%k`d;1IC;y`-eoL#9Mw5JxdoyH
zEM(Itm_crcoo$q0EfqQ|82+y0c33S009h8)8+B3XKBFSP^|&k3aX3j6^n`cy9-wsu
z-w8l69PrK!z0-w;EGL!`e3By#d|MB0YjgEtQB|x9NQ@)Zy*;EY-%=^drg;ao_aX(i
zTdOE$+AsvbLh$U$%Ki`$B47feOx(hQm>6jh@}km_Gxdh#`q`}`_N)Om#)4T{Gev*E
z6;nGiFXebn@}AW|r%AWblxz5O-8R>ReMqF*-rihubmJ~}Z-ZN*5;N=Af?gR<(5MuX
zR%0K|9sO;tVcpz2(oY6Q99quJ10D>G3D{t++tKe;{u-7(ggbqoYL61_$Du+jxYr7K
zKEW)10NmYc$6Sy<p4=Z*9p$20CAgR*GJ4u%J>&i57_K^;I)0>G&D)<PGf}b{_TnSO
zgB=XQODS$)V}#E?^~$#~WZpIeVOTX#Cw9h?Tf-t5;O=Hw^u?!ANjt)3J``CqLxhXv
zc#~o304bi}gpP%ta_-KD*{J=L>!$z@VeYwnp4&hd0U_prY8xxBY(V^<OH>&_WnlM`
zV#OWv?#hs<yc1o0G*f`sa8(HukuOPXUVys0@^^^+Sh}f3#9(;+byTo?<u?jckur3M
z@j*l1wpzE&PECR7N7-_h?;ahm1n0&?C@F3VCVaP5O9k-tM^wy(Ya#9%<$fUrF!C1R
z-yaR?^18Cc+wn33$|u;JyRvsOE!hg`8qrw0A<6Z8`K&&cm#^^VHZ@dlXOlLA8J)`^
z8yf8bykeBFK4HjVu~B09K+czYt?z2FlNvY6Xmno(QfDVEi=r@kV}d2yS9yaj?!nem
z+rk@PyC>9$WO+1ibu>V-&)=%6(uq-wazP)btxG~S_ev&U-cH0CEoWpoPBYX-7YH)1
z9ccp(u0n|m?vEBT*@iOrcRGS!VY4HR=($Zoh&8j9!J>3R#U@4xk+Xm0Zn&|=p@X$X
zV~eY)pa&S#m#w<;L->h!LNy@b+H=`GW!WOK8wKk7wn{z8re^N6Lu}Z9w?f{0ra2$e
zCMB62#V&@grEWUY6eV#rqwhdWX;q$ZH^<Vb@Q62EwG&{(%FPcaETK>UT1tXni9!@~
ze?mEn<0ca#%MrGLik07`Bl3}Hj^5>8`udCLTEH?8%iMrOXmu(TRi9>We~q}-CA6*P
zGmvQ1fVIG55LR@LdFIx8;QmuzEdt(UdY*-+DLR|8JF78oTw6n><}h{j?+XR<m%}0I
zq=udh+N$&2uU`=nd-T`1hBtplO83|5E0*8q(z^0+lS&c4uV-LpNW0Fx8cZ<)tti_d
zBgD{Tk+wdWb~nv_&H!r45?5OX-M^Dy0vgPL?b@)wQbVfiwKok%sQs{*GR=sPqQTIj
zP8DuT*kByd3ss6czg*GAlMxuVqqS%S+UDxTk>@k!3?<lZ0WpjRN<sj*xm=);GQp&Q
z@;G%<f)DtD&p5JqI81!XLOGxZvZTl|Tmv!#I2zUSnZQ7p0$h=%rENW~r7ck_zuQxS
zhjXfXsKV^_1#e48<z<TTcT~f4le+%(D;~jb9Ein?#^g{wDZn>gW}jwh-v@QX?IsN4
zds?`u001}!Kh{Sgpo|0RmJ4Q!$Z9HNjr?HOv+5F)>+9>xI_gqCgPbmwuGLSFQ(q1t
zf+7$dF^nbQ)s$<wAb1Y~_cE`|sr+UNXARu_jV~51vb8-$=+kBDKj&<1CuuxnhoMv!
zA-3+BL7J}@ox1#Zck98-M%A4(bpr+uPt~ocAF0w)8|fWr78cK>+ViD^f3u!;jH7D6
zbnf4rSwIMxNxx0Rn+y{<HPtOP2zMSkPd{t$sFQGWkR@eXW3yYvdVc3dvE~NSv2fJW
zs-c~Bx(MFtw0b<r)tvS1ftfh9Hd-8NV|-*58tFscX_upr-GG-Wzq@u?K-(nes7k>&
ztK&VKMcbVkb32wXpBY(@2$njo){N&4Z!>I;(@*Q3NyL|*&X2im_RJf2l<0n)j8r#;
zW92an?vhUJDYqTT;|QXKt-lx2cS7|<E;byYqMsud^XmqyZUd7Sl<01N#jl+BYb7F$
zD|gS>SBS!Nzf5ZrPmba>Hd!C9wT_14k&Zf}%x%FX`m-j-3@^Io>1S9?pVGj@cE1WI
z{@Olwo~CbW(9K;@u2$+jTeh~)x`lKboanlKH4Yti*^D?dgn)>E*YNifrv7uuE*HrK
zBSc$ix>R__pc`iWzSWGl6p~7smyNb8$=AcKV|lkcbL?;m`O3$OirIU$+dyTm{N>2B
z?QK(hEpf5D?^8L?e17*dmbSmlXYTQsISy|;T>8y7<Xc6kA>c4?;gA-JoKA`24!zUw
z;Oq0XyO>*7hr^+Nx36o--`4B;+!r1<Q0b_@!A5h|hw*@E85Tgfcd$m8KV`JyAOo*}
z#5rVLzfB>tR#ZUktuulm8xbI+o;~1Mq|YewLX|uwjMxj?HWSX38q;ljx&Y4S0`*EB
z&cYNcW{yzbt5iy8rk90p)1^pI#(TJu_@1XC*{yL;87St~an*Vk@FEs6U8?lGf|1%R
zeCBc%o{YYwNg(FL!qjit#ZEfbPkLq?!s)5qq92O4(<gPqGEMIQOg04OkcVw_?-@|;
zKI#=go(pfi=L~s43z?jCrYRIO5_ZfezkP<0NR1OQ-m69x|8BAtS*uC1FWqVXLARw}
zWY)Z`t$4Ix5l8L{+>IQg0fz6#7D+0g#BgD*M$YslppfqO+>O+@Pr}qm-lu<OUwrU?
z&&FuBL*4h|x<<kJVyagsoKz@$hKFzqkz))9#78G{)|Kr??gX34f-v|Y27{xpUsgsd
zvh@pT>Hew~#SgsIUFhBXP7r82TvCRSREW&#tR5{p5L%GXdA_idCzJrQpcWI@IHnvp
zH4QmM8=8^8_p*vNDILLmuG#GQR86x~EhYL=Cw$cnbz`=YsEA2KZT+~tA9=O78&OrU
zzMkH)dXZphd{NhIl8_AcETNVbLh}sxo%p`*b25qdet25F%dI!A?S_@pbuZpw1-}Ni
z>36Am4bim1h-0_UdDrULI$x`}4=-9&GiaeE!IrYT$I|fx-V{Q<<*0Wnc?D-sdEA>#
zC5U78Q;e!&X>YFljfOdKhGo(SfexqVP8-YbR^W(Q6MpAXes(pgS5Mg`IQ&=44_#+-
z8WDQRAq?X>EFGQYm?JQqYe|>BfGXGgnk&}T2kUk2z49$E9cx8$uM`_0M~M<ZE+RKg
zyz6NQ*PF%l+T)-O7mv<!jLXFRn+^n!*!1?$pduYwAmnv1Cp{jThf|zJPOMAz9X-8*
z?PE&?m;v6?k_HnfV&9Q+;|@KcR7fMx(dv(+dTJjLW==K!OQHr}{CvZ(r9OV(LbEO-
z$;Ia`t*&<-1iwu^5DG!m^c)w8Nd~E7S|=s<K>16qk~%~H+yF`0HkD2@-RYgpt(<A$
z@Itd0_iKI=M1TUKGx+>%(|`+~du0iElFJnrNna>BfzJ^pi7^16i9AbNnVBhMWfhL>
zddGRlT+SyIWAviGO4s07LI<56ZdzjLzTwkk6CNQ<JGN2|C)AYm(;;7ajrG1h_l#rm
zmIE%#4I+T}N3y&AWIzlfI-O?1uZhK+YgRyyfc5O$Oc5cc!Hq^)?)nebZ;kjw7CeUS
z$I16jTIbT<5N;!U;BxA^D>E$}c<Dyt@D|6NJQXX4Gl5&(2V&<r)~$@0;m22)gw_)w
z)~S+>SNR_`wn@Kay%0d2gv786c8Wu~sf~%$IY%+t(kRrPr*}U}ooseg-`+kT@EMA&
z@>cY?pFr5XDpxWgKsL4h9qH*S6{G$i&ss)${~|;RTj+2)60IZ5n(X98qPE8W<%eT<
zDNS{RoZwX-nT+7e_vb*5l}zsx>T9UtHjUeok`C}DaFxw5`*8{4F2JX&cfwq1tc1{Z
zK}~MxdzG$sUuz;A;>Z?$iWGThoa{<Q$EeJb<0t<qoYrJ2@2IY<8JGMp(;C~fjvo|4
z7}OzVaYPjl?zUW??CUq`GN(6AE1H<7H_zV)%0I~88ysPB)s{PyE)+XtQzNw(5RlYX
z@|XQznuBF4l`Y?ES86k#bn;{U=ZTXHec<?AG3psSXYwPN{c=ODf6gYp+?Bvz1y~SL
ze1vOB*A3R{E1?tDNtLw6rA3iyrzd2WZ~NM9(F-0Ojqn2=9dGm9qdS{JinaVsUobf3
zPK`5(;Zy4$kL%LDUFm<i!&}UR)zQyt<O!KNW*a>|W-Lsuy>@uohespz19cbad;Ij(
zJ*Pxi7$cszeng^!@iS5;774u`nyeobS_}#WE@cPJpj1vxe%Aq7%=X77>UCrs)Re*w
z)#QqAL?aSeZ&nc>t5%+qR5S%N`pm2-^*M4dn7l&3mx&lOc%_o-v4)yX=JQ_53!odK
z#rL2j{p5RInS08cdJ|Hcl-D6P^LDV`Z#AP>8IWwYp=-^3zpcl1iJGA~NC$~-GSsR^
z58OZC1M^U~v?Su}e4@J+Hh6A?FpA#tsDljwC_K{5!q-|upyPYX_jptzGS7XR#oX5`
z9nPBP8kIsZ<86=IsB1ANynZ;1vAAk5<BHob^t#cTo<XJsy3FxQxb_La2a0?k*<(P4
zWzQ1q%Koh^x@X1^GQzbpBxhe6JGTyn2ub6z;#0(3Lf08+TXFk!Kaj~Bd{P3PWm1oM
z&cSJ-PCYR-R%tR5S!I3Yg{JfN=P_CsD}F0G-aSSow`-?y>Ozfd!Vna&Le*FUcJd6_
z13{{uIA}cJ;b1uaYQ~o<Kf*<r=%i!U5N*Ex<laT+Ui6zGe0#RY3cSq08Gc32m5PGm
z&NJ7!2Um0^HaMjosYyMk!tdD5i;HU9c>*ImkWOuQ5Pazzx)30Ji#<pWzNyNI^V}mY
zgXCh^+xqCUR%YA6GtV0>9<m8UtJ%F9E3ux@+#Ln3Pi4Gy;az5U>)~YI#tzFKNBlqW
zEv~+Sm&uG}dbf2l*L7A-pi$nu{22Gpa9L66E`!CRpN;c`Ax>5bb*d;Ft*2F(JpgUt
zi=4jF3hR7+rdgR7K4zcvAY5;)FcNw#-``%9b6H?&J!Ru}kAAA!3hn|S17C3G!jthn
zzP+m_tY4}RDW}HCw4iHUU%9WJeD7zD1l$Uwe))29nb5#zd+!Z2nA(eCSJR{;AM5n<
zC!G~=qZ3V&j?a;}%{L4Gf)a$alwzceJE0sJ`y{tX)ZD)6;ZQe=CLQP+Fu_a^cj2k5
zARS*{0^mT+Wnw+GXA+*)Z8pW&HecwwoArRs$)_zH)@LD~*hbz?amU)yo5LOT!c+6_
zJoyfp*KC7nd~~NRn%6qb$;bUm&0V?N3}Xe;Lv_IFqd1|?+{PR6O~1jj#l8J92XD2`
zFZr&!hUIFIa9_7U<F;<r_-6Lhy+s}f6{Qu-`(?{cLMO;BM}|jV<rKn%&#AGFN_Rln
zic5x1<>V1$|CjEL<TJ$t_m6cV?eymx3@R_Hus@cq4xd19VdNlLBGels*V7x-e>sfo
z-`~fpqK{@<`z^4EHpwj3^FiX#Ao~4@bl^`o=nL+>0Up+UX+n{MFxU0z`Refs$8QcZ
zb}Ll$K`yVU8GSSom6YY4M3i?|CNz$*{yeD-su?{c&7udR1;E}i4N8iRlf%i<a$)Qf
zTe&O0MA!Fu?pquY{gEk>^pT&qERJ7{UM(`O%4dn)v_6;%x?s0OsBB>=S6AH-WvF-o
z@t0=DlA%5>GWKf5x{<dyj4axo7EG&iRvH}MhM$AzPn%2EjG+3O8XrP?^MN}VB@ZYp
zAjN7b`_}19JZZIuxxdrPb=Ld^b#vEyTGz)gB6Az0V0J61`b(V?E*{XJ#U=*zcB-*H
z1ps}amrC@tl(Mv26a#h_LJu99W=rER;Pn|m-Uao)Ar5qkyQxlSM+eG7EtSYd56d%-
z>g97IVN1bb6u(iokx_le3&Gr*mHp`>K-x#vT_`2F{0I_<k(VuFYpZbO<GpVO`4M?@
zr1*x#^>Wqm=N!M}*q^gd_cZqzC5Jt{`-n&b|BCLiNdep@4FKIP&oX@AS)XS%$3^N&
zysgk{$S8a*y3Gf_kP>06n1%X<UribgCPqnXe{{*$oR|hv!a~B0yFgg*M_*@A53y9k
z_cCEw@s}T@=p<WTHQ+PiOwsWLTM|3ec6S{}eOF<SQE_L*E1(c@-3qe6)4cc<!K&fm
z55wqd{=9Vf&(z89xS(vZF*k1FB>;^)Nw(qiAC%cc*G0f_<x=VH7o$M*wm=_fab9<e
zK_?E}{ipz3EH?qrqw$2<<?10S4f#AhhS+hjEwb-b<&@$_5XyFC{^jUBA7wFLP%m+D
z^7$8;m+V;xtU%ucF5$T2)j$m(0m4?;VR8I@f38~o(?aK;q<yCXWz&fn)6#-b3kWe1
zgyAL)h#8&=+AOwVU<5J6j;0T&Zv8EO^5~r5=n|p|FD(<>H8M(C-_L8mNAuNzpjxvt
z6CQC8&5hqcA@Ujr;d2eGx7phenj3EkWZv%zVRrTF<iJVcS4f4cZ-L+$N912YRH|z{
z2s7}n0{$l-{Qq5YlM}gV%irkDvwn*R7$QvCC8Q`++(V*RFMJ!(_Jc}%;!KCM&``}S
zodCo4<2iC;|1j%>x`s}1%|k|FL!`Ldg&ksjPF%rU$`s>R!<sf5B-*$VrlXRl<lx8R
zhwR5Mb4rZRIlGT~(A-P7>&ds=um+s4f7%ZIkFM0^Ok&sjdDsjpE+|Hb5zpU<b~i>?
zQ%oX|e5b!kkE7MJIgO(p3L#PhDgZ=%5uKtN81=pMo=75+=gU>EMQmFM=XU00U|)-K
zw!CPM6eIF_yl8~eB<poK1rU0ajM&GRJEtY%#813pysE<nlC1Q#b^q$mWRCw)G~Y~c
zn<hXpLEPspBJ9MUVdAAYB`h+u0ukJuwvlNs&K2T-wlB3bCG-%I^6GKmE)Ob--pPQ9
zfI<-mps<8<V+8-f{4x?A7?JoFL;FeU#zE2oTm_VwIVF^L(6~(?u&q6>z?nHEANk8y
zNfQrr_V~XwmoG$r=!*g>?vZMPs2LzGi11^#3c%rG7oWz-2{sY^Ge;*(4GnB9$H-2+
zDll=80#h!k-{J_q_*m$dvH~LxZe^g)PwL`_LXjW|Z52M}6xu={naWRPzZ)kevjm=+
zyI*~jf7dPFP@6s$p}|V<b`l+J^`y25HYiSCC8miTBzm%G9FB&VC729I5%9tv)s$77
z=<tYfiD+qiS)(K^n#8=6Cx-+d)X?6Qf6V5TnpNlIc^^51o>3;P&IHKL#nffBW?B9o
z0RJlh``@I}ewIXkutv`z5J8Fd2r;%PMqHXmb5%<jAj%{v$K#@0zhaQ^6rKz{LX|5C
z#zpg6a{KyL6mES2>U<l<Bm;1YfD&tO``_o$8mdUNmLQW8skg*UlL9o_sXksvCy6fs
zXAP-<lCAs4{o?O@yqWxP$;I6f7>I3Upi7ptK@m<99s*E_M0;`-f_h5PNtn`WxB@K;
zBo+&77y<CtSxhF4u#K|CD;H>iKF*(m^^9TSFrfJ){?64l8<GB)1ac!wH)SC=n)$@O
z_T0_>Q1#-auR&^FqDbhccVllA5_@e&?T(-Sv|;!k3Az2o{)-+wpB}*9BN!%OA=yUS
zI$_Eiw{a!aPRMd+fy9ID1It?>^e0A#|A>v2{{`K=sK>(xJg*i$r2y#c_&@U%{YRAo
z_K}-_{zemq-6X_+uB7-+vNuh9ymvvzG;0;_@4*j01PDwVHuXc~-<ntPO-|G-zz6B7
zgX4c1?!Wwx{UMG?)h65DRQ$2Dum7$y#K`#HdIiBJXd@(XOw!&C>T{SBXMt_1HwHu6
z&cE3-ri<l|#>SG^Nhgvh-|-#bQ+G=KMf(5vGe*GI-v|QMo8)iL%Jk>qw#g*NeA4`(
z{-MIkYuYA`zp0ZADnBOyMoP+&gt$0jd+XLW9gT~&zvUXf;1x`Mh+GXnJ_<*qe9=jh
zXtgQr?d{`YVgM2n5;?^AqkD|+71tfj|0K%8`^g%jC)!>*-^E9OD=ZHc3Sk8`m4yN>
zRR@xf6zwaH<VS_>4u1fx+%=N94&sVZ27Vs6emR&Z4^ql6S9AkeBusAx9~!4DA>t>f
zNDrv-Ck4TjNF?38PhU%4du&WyGXhJ!Sn4>Mn3&+c9`i79>Giw=62Qp&f}&-8`b@zO
z@-K%n!dV)%Ch~6^IU=yaA|lx;rK)BhJT4B7j<<fh>+K%)m)j!jcnGEd4Q=hn(Ih&i
z7%O6OP}hL}(A_^>1fD1>FcujZ*=)V7`J>fR4Vh-6P2~NCk1nD3*-GQ&5~rd$k%oo_
zG+B%?fh3g#?|&EWpL+Ypp*l2$U*45G=<v{xxGAhee!}kE>B@(weqfMJ<s=FGar$}a
zU-uRM({TUM&4)fTLCAh6gGyLa4VP;*9)S(_^a$=Z#f~h-o>Zue4x0aqp8l!f|2gc+
z^leyCHKvx>d$(=74CamD_I_z%3Y`s(wIVu<PB{NNQiS=Uh+7Cr<mc}`-5!68qgbgh
zO}mbgXm@WkiN^tsj0Y|4-_G0r5#oQ16b@7pshF3Tn3#KOm+<WZ(hC6mJ%%j@C@$*)
zC>rlD{hOKpmmVnOQ+;uyOUlXA$~E&5NhdRSj=u)z=Y{yA{_BbV&4$pj_<cbwD2l1y
zo;Tig2*nc<6FI~6v9PngVCMcioBNjzr9avxCnOl-i>J(Q!u<`s`+^F<(8s``M1(8-
zjd}Ki{Wy0uOiJ-@ocsU!{a=&&f1e)QK!;U*LMzQXdZTLiyzz~Yzoq>(M4@H**87sj
z^vzeWP_zU}%|vU_4LARbb^d!)@<-DHV3T5D7XA(U2F1Jpk7Ii&(UO_Vr%Zd^$n~on
zC;R$uyy(C6^?>}*@^rbrw78^1(A>N@v;Ps}Z+J4lU)N_WaR{6KzjGBoz#r#A5A^>H
ziT+=||I0Z3Z_<OWYF0@J%z4K%EetHIf~IDPSNIH?85-!+)YQRxI~Rfb0a2aV6!EU}
z{O34iZLQ5zIoTjj66%=0@E&Fr5HhRkB`X={`zGCm82<f<bOz&*A2H|E<T282&0;ch
z_bzzAC$k~89?-wAEPf@lhl^gs*!cJvG}p*yr$`v?my6z}_qS)Emir9;n!$#^l&c;X
zh&ZA>WBvcxJDH9Bl61YX$>lPvMp}owS_i;w+HX}~wlO=Q4s|?0hu3{VOTRu+fDWn>
zARI!dWBr9QnU#RjwOxQxQc|WIo!NI*2>7X%Yi=!>X2Kt4eDt>BQD6F4&;~DwNC5ly
zdc(%XmT_MAP*@eeiHV8${W_|6gXKa+L5Zc-5APlZQX$H*o_`NG|M=Ie1{97o^(4E!
zz_m;tY`8@HN20fv44C8oUnx23qa9enwnL<Zub+`2r)C+||2%jZ%}oo4xc1;EVT0%6
zzDAg!=G3amdEZ$E39R^Od>SLvJHyAtM8ZBK-xTN45twT8!48O0GwI4~aS5wvrAOSV
zQ8o1V0sV<zZc9m&cpkR+th>is+a9-qxW!vRwtRyOuUd(>2xh6vENcV_+f6KhK`c1@
zc>lYE!76>rjt0`q8G(gic@!`SFeu%>xOMxLlG(9<4cpf;PPHoKIWF9H@?zrh+VThK
z?8H3QuG`s^U%}~2s{8x06>4MFoUH=p;T@6;2F7}B@??v+YZ0-fST!nmu9Bs1PRmXt
z$nH8bvK_;dZplZVMsls*zfdpBd${2Yv8I16dH;?bFm@;rTE-ouf=$=0W>Z3o&}XRn
z+sG-btgmAadl5}s9LG1H(eoM&OrjQg|38M^{~Je2iT@Cs0Y&@^2bhFo6^28E8#F1o
z2iUL-iugRiT(hOVI$IGvQy0F3w*f-%pz8KY*xkXZPS3yyV;Y5J(9edA?YaG0=Ijmr
zG2o?so!Uq}VecxYDzGtz8DcU@LQv~IjR{4Z_7YVbqC>{jZ&(iC=tkY~+5no)Ma5Fo
zSBz@h^z}FAiO20{D;BbN#f35DAsDln=2|8=S}tc88k-jAJFm)ZvTGQq7TNXo1sR5z
zS^JC6|FhwsHMxW8ql#C=C3+X|m%h<5C<fLFWGt7+ePvw4h=V5(AK1Y*7dWuGF<UnF
zQpe@H!j?W;S!$k5_Np`-E`Y_l9~19uw2f|9Xx2<E5qUr)1=}dl%xE+&;2eCmn!{1j
zQag`3E3SF{*=iP`?{eYHh_(qF=ARbohW?At(a!m^KP;&s{ndAd1AHIUig4xLO35E9
zqjm@F@QZoaqx9aJ>=7p$VCl;iiB!)RAx355&K$O|!wz_3RDCk-#z5C1RSjC>vtQBC
zi<WMj1hPj_cNQ0_8sBSdVXI&BZ=cT8JR<wb#NxPDDt^od>*7=PBDxPAw^&7{bHhq7
zNP6_ZoalBA&Gb|*3=Lz=X?<rT8(VGsT#7(;q^V}1C5|AM8J2g(KoC7L;^3*(gh*Gu
z@%tMg0~mvbCQU=!C4p95QBQWc#-cuQ+W<Md@D<qCgEb9orI}X>z96s1$HiKb4fK+c
zlN*j?#<Kzg&EVDM@G3BgpSRmsO`PT`YEC@Qh@|->bDtWE6LC;819x{Je>FBzAvurJ
z4aRysE;gD%^0K+~<Df?SNgx99eTbPof|$hawsO5ZVr(^u9yp7gnRuCEn8Pku{>lI(
zLA$}@mKg}g=MoY<Q}YsXZvvJr$Cw^8;#ljZ>Ab8aDa)2!;MVyS-#hLTv;`Y6Nu9tT
zB$EmdH?~fSW}h24$qcb=;;P}&wW~(lq9=#dW0yZkYmZ%@*nFgyqiGH6pAX?~uUfUh
z;}}p7WSv6-GU9kp_X_W}9+QmV#Md6;pXQ@7g4R%XOnAr*Ei5c(Z&x$w!CPmu=uAj6
zQr8!nKgcz|7+wU<3T4N7V#H=-VHMHDD6?uEv%)7x6R=73Xj;E$d?#6{y(lS+D?q<k
zrFgxh;Htq7*I6@G|Mkqc$O&Ayk!6Uv(X<Qui~Hm^6~8Vp3G?qsUuiB^;Rz;BCi`j4
z50lcKJ{hc)1E|OXN8N^_Om(F%BMhO;58b2(u&oFQ5lwq}jcv*JJ+(oFZ2<?w6nu^_
z#<3$<Ve9e}OEibb=GhcPxy$o4FJsVnRF-}ZT$~>MgI9*lZr*bUGO&XC!FInF8NQj#
zU|)U^k)tP^X2zb<O<Cy@qFDqe>iXr80w0pef0p(oqt>Kjq$8c<X-(Dh4K~mXmeioh
ztlh5I)9k(3j>(TDXAm0-scvuHMcXM^gv~q!1~zJ-tW!qs-f&<g9KaZ-8*2sn7PLHL
z3!#8m&1iGoE5Uu?<HElb)NrB4B)4(r2b~rFk+~SKU%N^pcuS>su*)I-J*l0NEA(D=
zH82Fd_R3KG_Jwl1>1RrUe?`2B_P7xkWZVa{InA6^RQ&&Zr~g3K4scLJQV$8hBa<9J
z!<;Xmr$>lgVV%I$$tLK^VM(x`$TJX<o@02;U$#YZEv_2sab$p{{P_pJT{yUZbp}S5
zuQq5uCaJtKft+|_o@>*L6d4k?%Z%NPv#YTt(1fohv1x$dgxdsTz^#Fd$aEe$!l4nM
zJi?LC2t#M>90VlE1WqW4zJd*xi%&&7x|zJYP%p_-Xw@BRdbMaWWOOq*K1tb8YB%KI
zJ<qoX;#-7^<;S&%p@>FV`IT#3BgZr24b$A|mlooF8-EBp<G*)YYpK8#_#8K(@?t$>
z02bOUf9T&}H^Yh-E-~=aNH2bNVS~i{LA;K=4*hY^fd1P&PhQ!v?dQYb`Nn_^bRJvA
zm>YRJ|GzRv?LW*h-}2YtM1?>ki|T+3_45%DYuR$(SxSXU`&t;zf?fN3h-sx%(SF$C
z%{AK=6*N=)Y(et82!|Gr&5}{CT|HTTU`8tG&1xZS=8vc`hVLy5r0q1!w=|fME4l_p
zHMcx@7Cjoyr~{_?DtZGsw*yPg9_7WItZgh9CMB(%7;ys$slO~C;$#l=9Mt|1*8KY%
zhuJEqA7os`D_#ce&X<9~tXF3X$ddKfkF9g>D1wZOsu$&qh}@>RR(|P-x=KeLD^_bu
zL1^%`9XZN#9HDw&P>I7Mr}qq@gQ<<R`qEY{RXHlbQ}w6<S}i}rX2yy=1hrP4ox5_-
zVKit`u2kq%k9}{(;G8Gd0C$#enr?Tl4JdOVg#&`p&ZYo!(vq3uvNCF?^L703<$6ms
zC6#_!t>e6*g#UR2O<z9$VWj%2yKjsG`sgF4VizS&3Y>OsFz)1cF${!j!)f4lz!2Y#
zqs6d2@~W3d>cb&rAY5M>CSl@jLI{;|spPm*NYYcxI9AD0UQiyRYW9`<V3<=!jGN;F
zJGN`J2&}TF2UIG|PAmt<Fw^{Q^{HdEMUv&Pk$E%65yHa!xOM}m>0NnGoJ<A()pyhU
zQT6+#pYw*|M_S?;L+RnvYPPl0EY>Ik`FAmA8l@Mf+22kUUGakv)O4t#Dbp4kgalXg
z2#0^hbBwS+6h?G5eH+ldnL93>vVjI0)~lvT`cTa<%I?@vEd{p|3g*<eH?<WK(DIeK
z{z&}REW?%Mq&w|pAe#3b8Q%CDV~GO3J;|Bu2?jsD=MPQm!6~5-`ySQcaCA%s;8N>1
zVI!$Ji#3e&mcH$Yvud+FuW+S>2w(jE&mtEQjJW6lygYLo+kuGwYpM~%sfCH5vIha|
z*npqWEimkQTy{teQb$h;;s-M`Tv-jATyUBA4F-6-%}Bvw!742#;CL<+owIcbI(BCc
zsRw3G2S@=3)>=AD;HwJ%8a6bsf`cNE<_B$sPve&yD||QfVAY>%m}F4)??AKu)p)8E
zfxUNzqk_?pxg34ZODS|d3yE|NO)ICbG9V>>6+v{!7qe=SWdHTq_0H;f_RZ7NsSKw5
zBkaLXuW%es%Cb4Twl%zRoIyU%_>A4_@GjO&VYz~fNZRk=FUb-k{o}M$pwMyY<(1#c
z_9n_1GD)$<8Sr&SS2h77y!s6O>&ozCFM|g;cT60(Z9>D&W81`#a%*hD)!j$XdzN9o
z_N?@*G<IQ1zt;Y4dgsyFP_G&9mnW64;Ii~|xdF@Ia*2{gLnWkQoIiI79}c7;CYh@C
z@~}$dfxX|D<Jsg~f_2?`6*2~)tE9z3UczA;T>tKI9tF=STt~PTaNo&Zim?ZbI^{$0
z;&j)6U{{Fjd0AsO;v(F<+D3C_d)h$7-Mso%_7#d9hK<;`$Kkv}SWZm#Zjm0g0B`YU
zqW|7HH;R(#zMiMtm$-E>%-tV5p9Tu01!GO?!OJGJLo)O;$=R!nJz+3Bs3sh{9pN|>
zTtOi55S&jF&9Ltl{4^J+UaaT_5{+T2AJPL7aie6hg0XAK4eYSqiu!AM(j@*hyNy;P
z0@&n7xkR~>xeNBf*efZ=6qCHq@k(C{*Q6$`l|A*qr?Y<gHp5c-&hIcBti<TOr;Ob>
ztwva!z+OWJR{2{BtUo)Rfro6}z4z#wYf||_zEtV3u<b)pN4eJ>y0|176%B8`bAgNg
zniF=zn0BD2wOaLAVs<w~+|F-tyQ5WCE{FY&PxTB1HjZbQaHQHuk+d<&JwuT1uYAa;
zKDe5V9R$e8<7H9jD#@;{Nm}%V@-Qd{w*BL5>%KGl9le>??_s*Mk2Jgw<36A9B%fd)
z!Pbk1?hcsD00v+-F6xo~X^r;VIY8K0{Bu#w_mwf*hcrhVkDB{!D}0CT(0T2P&6wvN
z>X@tMT+iGL(5P)1aqPxLEy*6M-3r{Gix$Fj{<}Uj>e*GW%nnva!&au48-gZ4AzskW
zSVoX5*U;zK(E4V}Up#FHZJHe8Op~ACA;^V@<l{mvdrjSYAHg3L23qW%6+|gq>b#BF
z!(0ufn;vz@`TEK7==zU}y?ReP`s9NCP0p$-gn!d7Pm!OoU;;aA@$M|qFNJY5k8HOk
ziPfzI1)l?m5x30+)FR_dq8Y6A;;OQUKaNUg<1VF%StYj|BzaA?7eBFT($y^f(F|YO
zKsnk(AYoWwV5C@Pv$E&HrCDcvoU)HV%BLnc&mrfgWy7gPH(0Esa&WR9MHMsa^!Zpr
z4I_#$%yfXqcjD|!do5MW_!0YLr3PFpp+jRwY`b~bYYT;HutR0Cca5p6rRm-Du!7am
zUDvcdfq|1L(dweLZ9$ojwqPS6WivIBGN!D!SYUxXL$EKBEob~T81;pc5RWXvQ(v9(
zECz%*G8+B7BRc5#4RKKSl_!Ozl!w3E6>wO_Z+Sz&3BCpjO?DbI<ozD=g3xs|g>xT;
z=dV@1&N$8$scm~Il3ZY^`bvz90su>*d;Z2Bb!v@uxw-Z<_fR77kps7i3#q?LHvnj~
zA}2L{0hccCL){a@w(L0-!&ZBgUqsZ~j*<BF@+EH`hV0|<Mq_jPdfLH%6TELxBYguL
zuE+m$yE*biU2ZfFg2f!k>)+YW04R1=GKfn?iKMEQ%PS}Zzr1XUeZ1F$ywYf8xSDO)
zEP_A0#9?=|p`37}p>?#u57szn@xFQ7ogo=_h6*~Jgsk2S`Mc8Nv*$_p<XpaFJCaBI
zw7ZgM)DL^6SL;#NuN~`$WQOtsoP$|)_{+gwgPt^lkD7j>=;D+D^UfsRVJ2*Yn>B&)
z`qwcnp6u6OZ`x=GKJuYVD#s5?D672sD704V0KYU+hkEWYKO=C?0T)MvsH2Fhyok`z
zgeJF3(1}dGXjshhTw!6CzO1^p`UZCHM+pSp*X0~w9>g!iyMJ&2v}WLYzzM!<Y6U*p
z7%#OLQoFCNfi<od739vbdu&r65b#FSg#Wgy@rs6IsCtg9r?@;FpzY$XsV3~^oX_+#
z!ryArR6;ew%k)!IYu8i2DX^ZqNv4^Tkk$3Y&V9-en*EG7rWKM5+lWJ%OtHpaX%4=|
zk6SXH^xuQrNd9zCiSehjJbrc<<`VvzkK|oB;p<nsT26V3pD~gEjf>K+2Xm#EDQvbj
z8pS3;1l|2?8~ouIG}Idl6U>ltu?Gyy@N0A2a;;U2+Flr$r;p(M#u<J^+){ONF?MuQ
zx=pSG9_vq^OvjtE3gN`nN}@l$^B%u7%eF^(7OOYdA&kLWZh%Pl{ZBUIPsZK|cPnuE
zX1)R?js9sC5ulMfCfu!uaF5OX{EWMK)K&H{KY78H1QmS%r=PL-j8ZB}=XZgY`M0?p
z<S-sv7;wp1hi_Vv$sMd}E%OM^-dVTLqiX+V(4W90KA<Hvf<G6UG~rA$f&c0$HabWb
z@Rf#*FZ~uRE-ub914|O{_&U$W0XDqcVqFhM3Mm0N<XUjFxeu&!qNZ<fiZ}_(HoxyR
zO$0I$+WM4OW2~WQZ!d2j8(24CeFtCi&Y3(_1Nb~6EW!cJPW6ivt@DkI8zOXzWrQtP
zGUR?|ZB!+p<rW>VOG?si#+Bit&w*&8qWt2i2r$+_2+=1uE>5KJTDx)L?{t&Wn6FW1
zKOw7HirT@|f<D2dZ9blcz&B{gv0T7%GCQ^uSqd%`mw80s3PU6iR*-<E9gh0?obZbY
z*`6Udz^rkrt6LB+>D84tC&%dBBggbxM4|F&p!vIT$d43`ytJGg!6nGKYIp;b77~Gx
zO9jWDHUkTs!Fgb0{e#+rQcGWjiAn-alJF{<5Q1N)Ra<msRQ>YYb65Pfdji<K+rTmN
zcoh`t&uhgGC!kN8l@vWcLGFHYN}T(G8~}M_+X7qju&nny5RB5w&J}Hmw(Jrb>zGGn
z@PcI)o$8W0V$Y>+_lcEb|3}C*_u;kB<&E<!+|Lo9OWTm)CdU^^F9S|>LJvN_JfVug
z0LZW-9YUd7e=qaK;XBxHd13+u2O4(ky_Yb19Ula%*h^td%crO^XKsc5LUGUC7S*WI
z1+fW@o%*8EvNvvpbq9PlNUMGk3hEl*h$Sj&z*z?85sY~kW`#Q*AMJk5@73=T2S@iQ
zYLt0AnCa+cgQlT#2oTT7XCFaVdAlgic8e2sU0+a6Bo?oEvn!hs+^}`2Sau}r!2W&E
z6-Q1Q<n5j73K!cxMeMmhm_x;gYj-{cX&ypMCkN;Y-o=@phva$j*lbD)MiTbZb<eG~
z$<Z_hNj2~s?`LQFk)5@sivRV05AXF!yZ9L+5FkoX82<n&RaMoT@uKRj56IFU9C-(W
zCZ)4l3LP36(j1H}vjh|edSvdl!5e<TUO7j;X<lma+UZ8DQE<|k*|Qv_#d`ez82ieo
zIJRwFT!MSBAi>=wXmAY#cXxM}5G)BAAh^3W?ivUX+-a<FZ`^6@b<R0=ymQ~)_q_X~
z$EZ=Gt7_I<bFG^4&2PD|xHX-GH-XH+siLo`pA_^(%2k4>^LBxdW;h$oGJtB}rg?{<
zi%j4_K-Wh-FVTJ5MctTC|5e%Zd%L~YNyBg{?1~jr@5@4BzLzmCUiX?Z_iPHzoPGG-
zpE0icHMN-<&o;23S(JQ1@Gat{q4|TK7Fm-CHy4t9iu!8ZTmJ!U79N&%k7c8)Ijbz%
zaGhocDy^=)dTPKDdPa;dx6J!GGf;ucmXwmtiLxA_!??7{at?>zk^;yrn+Wx7t?4z{
zuSSntlPw7){pajGR*;kjQ!*eevWs(xblPpky90qMy?orLmeA3Q?bl;fdK%<&e3uDM
zHrdJy{s%-nxusW4l;%rjIa^<(>4zzM)3_&PwT%s>5AS-(<i?ldLq*pt%r{4OCcSA&
zov4>?MTwlGh7p`$zBBE8*flW${hHD_5Q!GQ^4PY3eqUWuOn_~csqNE)wQBqs0_ci+
zW8%hJ^3<^FcS)$LS~6wqX3ka=7S<p7Bq)f)B@P`}()nMB3et8g+$+%SR`X}B+Zkp~
zpr$@=!bOw6F3CVshwkjzxLlmiVE+LGE?AS8tUl^*-+oMw3IM}1ZH#)H%k_l_N_qgh
zC&Z^eMmw|uh@9r$XqY$Ra{3<#M<0?}2S|Ro+CweeS&1Na<OrS)ICbTzB*@B)l_pln
zx6U=KGkxkYTKZT+i$)yP3=z2fp_b3-;1yA?sN6UBql0K^0^2bQd;_)ipZlO(V9~kX
z>`9o@J6J{j>ck0?<5ATIti(_3@E5S5Q|{Mm#Q*fGFL7q)2lg5q=^-)M)&4@)()X35
zrOU*p57W3@%6bxZ?A=8Cr_#WVudhq)5ygA28g=;R&m=Ld8FwdabAZL(6`A>eDMN-e
z!oUyJhzeI4kV9*Q^El)6>9}%CtTaU<^GkYid;ye<oH`qCI)dev+i+~ifmo6!t&8fG
z6H?cx+Z~3vXm6H(UCSPdkej|@db_ms69?XO?jD@tUswC$P*kF0NnPVgKc_ifa2AEP
znjAFO69e+2ypiFRYE*2lJ0)%VQRUC9pl?JdGhtBev~udcc}1YZ-4y3d`~a&&#x;Z;
zEp2|#<X||d)4>hDwF`zX{B=-KRGFP!N9H!;)v(eqw;FccVJrAOx>0b%gVi#sc{HB1
zDP2`gPeC3}Vx&=on>Hyk!3CQ+FzjRYPW&eVLGa|DyUJ3)46xmSRlSdplHa_BEeV|^
z-h-0ep2P}pOLXMZEE3qy7kyly9ME|>=U8rfE65r64)-FtFKMsbkYAyuk-?HI`fcI;
za>}B;JBPw@<`O;(9X0Pc<!Z%`Spuz8YJ^rKu5FUZ98i#564RiOnzl-VV|iSTr>FCM
zX`EBqy79s*n&@+ab)Z_N=Kco5>R0)#0OZI4>Vlo61qNWm9#<lw2T-PA6y;8mngor{
zVPIV#uF2KiGq@@<s$j<ey@74&Vk>fNIF6zr1O52AFxjAb!h=z2kF}cgsttYf5twC+
zv6&NnFe7Agf8nj6Fj4QcoZTAoAyuD++Vzbau+UcwnMZoj%Tj@|yehPUwh%XoEr9~;
z5kEhi!uEsGss~+(oUBB5Mnv}?p}=7;#Fy0Vd$HL4DA*PAFAgSUG@?<^y=A7bFITkv
z@A8k70wMa&odn%?{p_Fh%aV)g>*^*u{k?ghl`zAY>3%y~+gxw<r<6*MMG_CRA;sx|
z(_*JPX*KU(@)S1xB@^pAnJOWCZeZ=Pwnyit8}B}rc&YxBg)Z}M{*^?LFE(rNZ=*qC
z!;hE70iUp9vw=tEG$+ZmOwNhVhRj`$Is;*|&3Z?()(j_cyxz}#8gN7G9w8R?D?)B4
zPIE~H-SVh3^|bM`me~quLrd+oyiUL%leZBz?Y}Qsuw%mZ)$nyQ0cFtMGH%xK`a(<M
z={ckEcivHaQS(%jUDZi6{3+ZtHg&H&^Jz7XRMjkWiD(pC>PJaWQsLxPpc|dMdrvJ*
zv15~xcuae@VAPvLpu=y3VPTJjhl`7+>Q?icOKd8|5);;B$`TA~3;Rxf25wf}aj|({
z4SXDSBjeF`T)&n%v?$?*f5BBK4Y-#79EM4oAflgHBiA3%nf67!)(%ztG0S<#?Sy?M
z^WhV8Pa_#gQu5M_kK@fYf@_tc7kJjy{plZ1l9j2d;;g}*84QczL4A9A)fEOr!`EB%
zYy9DSxY3339A=&x_|`=nBeyba(l?o1*?zC#xh6;t!;*e{!6j=De*StP`I$GJ0=JZT
zZm$(V*S4>AweI3s)OxxIaaBW^C?l^kJ4vMOQP}ImZawEf?-Z$<ZRZi#sB`14(@}*_
z+Pl_XvdZXe*|B^xj%GDX#zhjmo}X-W;!9}?v9m=zcsh@5E1awE6u^oa9ODT{fgCQ)
zl_QM*6;Bja(sKf8uXW!WKdU6OmkxP{f=<kZAohG72d*hT)$FB@@0i4+=(wtuyZ?C|
zv1HV1?ccl+*&WF5k!SJAT+Zk#VS<8o-oP1K-4;j=9Gvm<r`gKje65d#9EG=*Kgp?l
zbJfXr#4NB(Lo3ExwNt(%^VK)h@60B@Jhu^wMf~_2U|WkZOB>&SqMjdV+W+d{a0WD1
z)aM0LJ(?DF-G<$}0#|1Ol2V$vu0^GpSZ3K!#wWZcb+VbV!bCZmrrp9;24=mIGlRfc
z6l1x>Y14;f^+kZHE##V0(~BLZ4i=I{2<%A3!Qx!7Xj<&O>)C)NM+NVaf}(cy%eOe}
zPCDO0P6C^kFF4$<lmfvjhVh3&N^)79aP_j+t`zRb-!7X>(#sUpU6alw9@;WK+e*S%
zgQ7zUm3#B2AT<nnZMcS<{;3{@U^_2M=9RC4c+pi;zvLva=YDsr{T#Jj51iMcr6Q=G
zQKy|vtVJ^SGc%Dur7M1|w?$WM?rHVTuY3z@_;q-AJJ7s0z%k1B;LtV0<GK{??iCDP
ziAmq|U`H|{>5lNZ7d`kLU3#vel}?s3>RTd{DUDNKeQMaBb+)+J`@I!X(A-aG_OL0M
zX<$QuXWHtIDJ*x4km_@?dd1uE5jut2@wO*dM`a4R^iTpz#y!ucZ4;H-X4>%fc)|B=
zk-Qo@q=gv(3{TyiOS_n9-dZrV+d@<=tvN|DDI`7SO{)alxagtYbx@PtIjc~y5E1$G
z(^bx{(xkTti~fA%64X#x;4j_<6hB;PZIi6GH7p+wf2wM6nOx{>YG4}63c(ydm$Cfb
z<e0_!syeK@uA=Oq{`-=wXo$k6>@s+fy~+!tNvy~#I+MFc5;{<m)$4Z0Mx74_egQQT
z&-pv<Hb9w<I$Es3sEcc{6<7L-Vy(^h+S$y1tqk`{n(Pe!5b!+I@X?59%oP_wFf%jb
z@I0LLOET#!r;k5^P<YSr*azc;b9)TMUhBb*Vw8t(7j@k|K<Hhplhj;jzo`Vi-NMq^
zOira(ANTq`UX>-(fp=_t=MJNfY4V)|i^h~UduwsxY(Cq}VE)L+pSamI*Lp>!XXT=n
z)(<Oify1dlTBj6^kC!xlXvTPZ%f*&9{lPv@kJVgSW-a33RBKsB&jB7s?llkG*Ao}T
zZUV4&lVMaLbi2&Gl)mj<=ZHMT_m+mFghes)p312l(s~Zjz@`O;pYLor8>X?<q((44
znxoY+GFz~)Id_+g4-+_%v73w80Wi#8?=6O#jqdY*z%#P>Os+e?M48?RjTnzS5WVa;
z5p}mXm2>LMnmlaznLc!9I+l23@f*)PD<8j`)s6Q|<#70kL@deu0hF}2_%W4ri<a%G
zLyN8fG@mX36Z+oBip0uJozfhbV>g6rP%Q6KCW3$M2r3|CJs_^5FE+`e!_!(tTNG{Q
zPkQIi%Oz_&!A{%E9sQQUadTdw)LNiH?Xw_C2HRG5jOJi){VSM)61f_YRs1EAK^n~g
zwoyawVd8H(jfXLO4M*;$v5#yLdap32n(?o~yz|QAtj#?$YwU(HSwISG^@m#1bgT%n
z8G0ywH}Zn7)QrBFu5?J*nsyA#^y;Xq5OX_6M5mRY(ehU1C<7zhHEAokyh6%5OnHr}
z0zSww%U|P9Itbp$+m2;1R<-ixyuzJU9^|vd0a&fBN*ph6xuWp&JrC(moAGPw9laB?
zlkgV_Kja22>D#Tw1B-sAHdS=4YRodPSCbXY38v)<8qfNT)H9wnw{$7Is^bVq-$f?4
zSWJ4GqukZKbi5!CgwkM~ldepyD=}d?Fsa@SQ}S1YNsOHMLC6KjdrjKZ)bzJszJpZz
zL^&U9hz+Vz5}PK)e?g1<w^3>Q9TZC$*(-a#m&8R_yoHvB6?2R~6Q56WT}<n;_&@88
z3U5^Pn#WE2gzh;uPTX4kLW1Sg47;OX9}c$2MmO>?D*hp>VZZ+FzPo#Uw6V}0eMna&
zy#IBA7Ss)$(3-i6GY;w?f0z)M6^Y-Q-@p8g{mbsA8Db&2`m7PagXI}5f6C&nV*{d|
zX_VOjIFK<_TmeqZhiAteJQ0tG8o|=}p37RW<Zpm<qx`)yv<#VcD6i%Y1q$tf_=Z3L
zp<&PcLH0*hdMd*<;Vio;HF-V0<KaZ{X+geuS`WE>ux(Kp0349KZUzm$SNGK@6w=`2
zD@d2r;tvKo^NNbvlx1tfzHISO<+IW7kme_63?fENb0`b#XBPJt9awdE>Er4tE2ZVy
zRvlEdi)oL=7`Dq`C9-jFcNm(KKM*~-!=Kix<;@b+^1J6s&mA!={Gcaym!VS7Q!=#6
z`1CVyizPYHC7>g0Yc&yJDR;D7I=|X|ZH<$&lODG06!3nG%C;@~R8W(6ZH79&QZbN)
z@^iW+X23P8PfWP3Cq}s^+bY+`0rxpN;PYSyk6~hZ&!Pjy9hcku3^fd<CWEtP3S!2s
z0vcaI{6nKhXa*f<-7c7tBhZm;;9cUCs*%cW-6Qe+gHrR-AoL?2KGI-#Y@M4i(-1w1
zRTk{H(+d8WLjMrrIV}xQ7%Lx`aJ|pu@KCIB{#c<q$ITdGkq(6l;Ei5p+fy4#43(kN
zVlV~#HIEOi52j~-VvF}6Yx&YW0pX(YC-$MdXK(;VZV)coom6!9ga&gu2OYR8a&Fzs
zmkOwV0tYo>`3H-^y2`$MGw>K(Fv>DuHh{coZGXYS0)VX9dIac4_2p!mRK%Bhq?D`1
zK(#W%0*SW8u5@FjZ>fb$ZI+(SVrgs}qdgYWtw5Icxgmv~fjsTlSA`81-;*Pjv_$K*
zon5@_4<>i(6k1vJ^DX6JWmKjS+;Itg+A?Py+G(6|A|_^=+GaZr3JB7zP-hAy+b)<{
z8AGbBNEZt22P=2<J^62nV)6h#GNHJdn7I;05IzqCg-w~i+mrwI7_7J>e;j%Lw4K9B
zfU<H&>~oW)lVkEXf(%QRcY->*eRH_9h*2E2dBvS+vqIJ&2C*s!9?c7(#hwS2Wk8j`
zg!whuv@$q+8aHV{!F5IJ%TeVH$JK(aBISVyQgK~W^Y8O%kJAdl=VGU~ysVJuox4EC
zS2SQPitc5Ub>*$bP$^sT)`4=*LcP?6%;a<KM(uXK_|e3(z+$=p{^oM65m&K?gYsz)
z$9+9wl3~{_9^{^{GnOmkwV*0OOuKAGfw{-ho;FH%<{?wG!io>ppNWUTj2<}$R;SD^
zhOe@1+tb0yjgB_KcXrTL@?4_{F0HzNQ#*g@dCz4#2+P?^0Zb!P6MTETcMsA-(H2Ae
zInM=F`i#6Gv#Y1H=-=bMc^F|;C>Pxoo6{4noLyHIf-T9t`PaoSLX2}C%S3IipFXZ!
z&YB%HFBz?UWytZO&@-&tIHzwmJz-8<0ky*stmO;}+OqnLTq^(pYg@My<GuLGXo?k^
z*jgdmzDIsw_$0%d`PtVenq;6*a^uWvw)ITAuQ$i~jP09&QW||mUa(8L!x^<tGWio@
zhh|;@nNOnQ`y}iTOd1u!jz|?18`)xwkts1!aAj~aX0;OQ$!B&+Qc)WqpC{{Kzzj!h
zju+yXhrBDSS9fBJA)>UKy5`I;<@)HLx@7TbSrnY#G0v7k&neuIs9K<|!$WX9n{`pU
zth2^`Rd=^z+Ug7e$#1kZDs4)8{}ia_79l;Ne>#w*9-ClxwEBeUb;>0E{`tM6xTDU(
zlbSam-3j6!7vk!e*iJ{uiRAOOp5J7wRKOgku^aPapxs*h3+?AMip$n@PcJ#`BE~j=
zLg(pydF1JZ(%{cQER+UXBI}7B0c8dXXogx<FX+Q$!y|g3L1NXOJG2kS^BFy)mY`AV
zZH?{q>$HyQU!IJbJdWD#on`)$lh19RR6#Z<Im)1L`=H+@cJFn;ad4H)#nHi;R9h7O
z-PRVZdZF&%I)RkGg)-!xqd=kF6kRKgyLT@Ean6|8ujG&6F=&uK_z||kn-yJe8AE@}
zqD>&I;NTtC6-IMJXc0BxR%*y6Am>!PdCkEUP;WYQ%F*ObbFm6BzFOAUFCe=;a(P9=
zIuOC*l?Txs*TOfx>Q;PS<xRfb$#ysrt5Br*er7_#)Ay0&TOz;}BdhAo<2oyT)~!qq
z29Df#Je#;DKMO|V#S52STghmICRX)8@<%(tY&NDj;x_Ac4^4i;%Qf!iqe)gPzdWqO
zfVDed_3J;QiSaU$)`xH%(G_H$u6<*;&u;;+ifDd@&U8N&bqSNigM}vV^8VM}AyvnQ
z<srAN$+=}5LU?$DcFWg(_Pfps-Ubr*Fi3uY`-+syPVBjo`QzETPp-l7Z5nOk*TAvr
zZug&uB8?ep#ssx`vIEaYt4+z^$+nJ;=%Cax+i!$&E;fb<L4Ya7c(=gnE&rTr{ke{d
zYhvmUi&D`U<s5$P&9)>%9!DT`{FP%FCzle$Xz<9`p3;FqXd$I|{yrU$9kZ5o{YqBZ
z9F?>^5~FF?Ap38}jB*80IAnW{MAB`23s(-aoHhROJ3@jA37otwYudAYr6-yg-#KuB
z!5o|X`Hpv`(XBf8mg5zTN>D<mO80z8%&|XuuXyXwae#&#QJfIwdr}I>nqY;u{?_Vu
zNtcQT)(XOuDsza5oLlAGFyZAWsEbdEvWy}T`^yJqSw9I<gSyi1LGy?PE%BcQi!u2S
z4QLT{UyC|+2Dwf!ukl0Iewh_84Gos0-J0l^uTk%T`exWO(-CO}CAI@<S4e)tOkK{x
z{!AO0DBA<gb-6D)qx|)q=6wgvd%gs{gb8H_>XeZcH-m__A<Lf7YW8(y;G$kii`#=k
z<+o~g=66)Y@M@N$Q>g+T`+jJ+W_r~AyEZI9bYmZBIQb@MF*1f3loU(xxj$WIyfJRW
z=444j#Ob+Oaw~1q4`jkh!>@oQKQ^Rkuic=QC9(BxTEZ=>{$T;zNQID<1`J7i6Yc#Q
zpy>L_qMdGpvBGjx=OxFn*z*z6F5v>MXTo<^jQ_z$2IlSVByRN}-M#9h0ky`?d+gcS
z%$+=MNPI^R00=86KFE3Rq`6>9+v&2t7&7Stdei<|q4@)nh|v?rlUp@XciqOte7T^Y
zTFevIm)pz<`g%d{mp>OS*<wBH24>R_z7iM?UYwY*1fw6+UB9umA2QxjIa%Tx7O#US
zZg+H2Km_V|{lvHsK<VvXM;`AnZ?Y%ZKc>LXb`6H&x~=Z(%?)}r<`u0uLfz^HvYBaT
z#^<#p6Bfxf%xgZ%X=MLr?VEEzC(Kr)QYc+02fNLjW9EttZ)Cw`jg?V4LVN`EBZA*>
zg0@h+QYst&;2@++&}fg7CaT_&MRM$QHX&;yx*EpSG+8dstSH#KX9bbrPvD-uh%1%;
z0oOv&I}eTYT|AEm>MLbn6r`=)h@f&rTq}f}^Fkk`y%T<5JT0b60n}F%zCDf}opJgk
zRqBZ@AH_*A2lH{!d@Bw;e@2_q-;RQr1SmYSC(C2Bl8JFo9xYg^Hc&IB8=8Hx_9GR|
zv4xXH8P=eoL3I2E2w8~rw3Vz;BNgv#A$Ct9PsA~a*|W>4rVl&e7Kt~Rw0zSGR+~EG
zwyN-pCS5Z2$E;XJzpm$Gkv)uBxY<U8QjZRd=p_4dBir+_?tKq?Wac%ldDeG_VBYbD
zyCwYXgv>=ng)X8-FNEsuP>Pm&&Gub@g@_jq6e&?)qA!NuEZ5#l-klR2DaN(hQQaH-
z@}QWy4E9@JhPUCfXMdhYfg1{YKaE&Ekue3Q?+QoJVf^VbqBsuc7>~ouBwzno_{Jg_
z#_+Tp=Xfgkm$=83w*w2DWW&j4*@%_B1E1?sk7Y<Wz=SeinPpn-!6&(PRSNOK-K)py
zx18jvgql;BGcmh)hpm%SG26nY(VwpKa|x3cQ<*FV`;)LO8lU;NPWH(Rql7NUROD<p
zSgvtbeO2ml7)5+<^jJveK<(tH)N~5*2V-%Cw3a9Dt~j&Hhe>GL<M{#rRx9Fx@qUf)
z@{|OmH&)c+?cQyS=5ht(z>(82pQuT%pAiP=vGo!OJryqWTy<Url93F81}T%?o9Knt
zN#@$8k%Hp3HG%VUbFndQ+(E6o8W*5VKyvbXs#h@N;rj7hrnSY%UHUMJ8f;ZL4Pr1b
z!q-?I19=F_W(p4;L;0~Am?r69cWoR$F{0V_WttJ&yJlKdO1ECrQh5^xWY#f^CyRUJ
z(P96Xh=XD-GFf{@JrnDlep=mks7Z)KMFtcX4q1P@S)Si=to7ljuRPpjf6e7RRVGjd
z0!Cc;y#iUc*-`{P!%&9-i^vdWyja`5@v^>!`hQT1L3TGnXmpUz4u~6@&CEfS`+#(D
z*-7D|uC;B_0Z{R9zXLb7o6PX8zxZL6KO3a}t<6xfKo@a~)5?YPf_lYj2};yTgBE-h
zPe<1G)AAhx_I%G<`oxse_oV~oc)RP3rqiF*jP{-x@vxlQi#{SGh(r|UwX50o^#wiC
zd_#+J-2~SYf@);en~-JKof@gOhE&dON{qn@Hj8EaZ@RiOoU-qw5k<#WL%4q|c~f6+
zNkR5s@zp64T?L<suIxMIm9fIkS$}_d9>kR~njh0L+J~1Hg2sBV;{r6>(W<MR(IYAP
z`GdKUc{frOqgBVI1TdBHTC#2axhE1z@AWo?w*m5@B$33S;+Bmbt$F1<UxpLr-!GjU
zB;D@HrzY=yfQEsofrts1+m_0Gqu0=o4pn4sQi2hvgJsO`puBwL+6Q`Z(=vsNkMF_<
z7pD)d)+>JEl_D~cKc>wz+`_cBU!ET)W=yRnzf#xBaMI_WpLGNjHWjnM;_W&1q&EnJ
zmuAN?w@##&r%MPa=a%Ryr8PjCTcA0-=AZSnFeF7cjy6n+!I-vDm;OphJHOMX%Ne!x
zc*}s{ddZH~#bMs3rR+PpGvozjneXOh)%~*Ql&gw=*nN;4Pp{>8x{-wYagJN+vxNsF
z^fZlS^!V<S7s=YQi(Vhs*MwIfI{`%CQCqEnhLh&G^(Hf}F5}8Q(_`SmA7%E-t1rWG
zZ>{9KYnSY$dnX%lBg#uYc`vpp$**Vek?1$t(nrWIq?_V2>9GpoX55a4RQ$=GNnEEn
zUEG}C+c<&r<G^Z|;ey)~bXvqt%-1@)X%XYb-k22`==b%42D8o*K?~HN+O}?L5ohvv
zKrp>+8(Ok6Da%65(q<&1m&HixD4M4^*Tb{Hxx=Ubq4P9GuLn==X2DBe`95Jrpia`8
zsD50C$Olc{5)a-Y`gicptZ}jn+;80wl06zFd(S}n72o=X=%m5cEsBDtjz%ueY8Ig(
z!R+lVl?d?b1l(WJG9-E=S_O5}WZQz?<4-yBh8ARl4`w3uue>d{RMYr0qs0wga9ReP
zFXe!TC1U<q{!x|=qGJU`(RlYYR++zNasnwwGJ!04A7pYp2QzSH%HBFT5PTi}b}8Uk
zzu~Yb{gtqaVnEzY<>mpBoE0zbp~_k%6C<7R8QU@hVN|~s1|D~7QcI0MR-V(VTKCJn
zej`;b316GpD|h}vwP?Q7?=^WjVHl9e74c-!G1p<GvdG#IEt=S0-+Z^ezb;s5@?Mv)
z#i^^`H7Pnls;H~ORjBmx3}meCrHa?EBglG3s#sE--+nc5;Ii<s!C!=K3>axqho9^;
zB4g~`*S{nIGxIPUf&0t$rxeYAXFT?3NWy05-Au3Tq-B#?1GTJPX1W?}(I*p%T^MQN
zDW!W2`!9hv^W%p|LHU^#m)iz0u1HolXnfn2-JkE78>@~CXbY<sST<UOTDh`ryPRh;
zMlpUyw-V$E(5MVf3tohx?$xsYTx(+K8{LU`hoR48njzGHX&TsJ<e9-0+qlOf?H@bT
zY7lTHGMdx0fG@)|LeiJnG0HO<Ap4R<lqD>!rynOF(Qpy&fjW3u$LW6J7WkU+lx3lV
z$PQj^##NPXH$ci9GF>G1VCsF};nw5C+zW}8kGM3B9r|7LJKOyE`zJkxnh9v$lEd#r
ztIw{?$Msm_>bTqh$4!}RLUMkzl_SXFK;J99n!a(e%|Jy9))XW<Q*?dW(r>3(_+{}o
zw7w^59vz2ml%g=jXA3K)w+v_0rBK}ch5o_o2X_%|+lWptpr2%X%?DG6e*xyD_Berp
zadhrk?q@qr4v2KQ$Z`kUaYO<5?f^||y|xQgRpwI@0m1r@==<VJwprk(=BB@?!2Zb=
zqY%L=Q>Lk^8|lQpRiQwW2SJ-zekkAcAx8y$OB%1jSg!tM{jfTSmE!0+(G3JiTrd|3
zw_>-ixKm_Y3G-pLAV%JHMYPx5kPLHlbOaFRjQhQU(iBAScd%z*_#zNBIY<>EM2)5M
zUUr#sT8gzHp9Z_mZ)WvaHy$m(W8I#f80JC3qS<wGDU7-5-XaxU^EV@10CuwK>|kxD
zK;V>n!3F1|;5mJT9`z9DdQTINUL0On=L#kTH)<%7^5wryn<glFZYnRnPHAUwA0bCY
zrAZp{is0HM3~Ze3xoYyO=QV(nS4U*EqEXVNGXE@(r*_+i-<B!?gY0D)J76H$Qvf&x
zFFI>?bZK1(8k6Rhek>$YOhYf^KU}|E)W=b0Hayi2Q6AC>&akZPPK`(Uw0mM|U#*mn
z@GCv}H&vC&vHop)Sf2o9-dd5eb9yh?Ojnv#ZRU3d^IE`EbiZ929}Dn;mpdt>qYa~i
zt$gnGQCN|vP|#k+w#&Q$n3!`N&|%q;oz#E$lEx+mi)z9m+o(X*&h`UtCxG)wKpGS;
z?B8zXC=fg&Sh*M^N6$K7qB(MVQUYyS3NQirC{1J190ZO`Bvlg@25D{R{|^rKhaPM>
zEjdbG9vUH>04O5Q!NL16Uz`6|qf?B#b$4%mcK}HO^h=0ZA<l(M?hKB3_FgNm*j!{6
z?a3~H%tuw3pZ3R#LUufu4~#Un5;L368%-+*KXgWJK086WEL4JPk^SS4@JeNJ6;DN5
z0`Alo$N(`&xN=A!iRn(Uejy^$l>l>l3edQpG0nt4lV!mQC`=F8;%$mkA6esKj<xco
zj`^_u0dtf5NF%0dn}ZT(WByg8!9!S>x8U^W5{nUZ;^y&XZF5PF#d3#15Fh>`o_dYy
zvJcO@_X&dLvdM&VDp`?awj#xj4K@UDKFvkRri0_7wW$;)3~9oFh{-Y65!rT(p21Ca
zI0PoPuqXANiY$u}VU}r(17|`#jzUE4$U7VnZ-VsX2%VB#sZ;#<&0c*qyw>CK%gjSl
zIc0*B*^KJ9<Jc}4W2Q=^`pwIB|6Dg7T5#vKc$7ZX#P`8THjPb6q1qu{`T}8@J<Q}a
zB(3xM9JVeE8AwUC9M{h%xNR~hXX93^p*0sKB+U?qFe%(Fma$pj$jxtYOR+Yd<QxES
zl~%R(I@@Yh4O7N<Q!tN4;{j!XnJkb?W}avLZEgdh*|H$g!w-C;mjGy-ZNH@Ln9`-S
zOi(Z?e?gAja~oafcg0b;ni`V5#7<gaCK&g(-d64u8q`B?iEg)>e1>~f?M3NJD<?@N
zrxnnOEOdj6vo9@`?+NDHe?5aCf@_|&WlrM#km~`|D+B|0@7Po(C|1I;z72awKahn^
z2jS-6ll20pSu46_Ex@t+-&e3e7V$#`{&na5y4opq|AG#$R1CjPn6|74LLW(P@!#)j
zQO*g6EGM0a_`AZ^CA0R;2T<?}7T|FP-Uvg{F?+fbOj6Ow^NAVUW9GjEwV4=uer?R;
zj-A4sj%i0$!HjSf|C|)6wDzAGdi$Nznh962j?*H6jz%r{OLpwaQEiQ-waJRaDY?<{
z>zM4%7QG&QhI(u}3L~`UDPhGs36@8rmWK;zyBzO{Nx2($)@pplm2}qFV+Vfwrlo$L
zAM9W?XQ)_CZn_b7ecz<RD%BMyPWR6BwbevMNQi4*7g`kpQUNW8Dt~3ejef{}hc<_D
zTcPIOp*`3-C#t^4{&)Cle;^t11RN%59g(%kh7hFw_hpa=mzDMC&zfJjN~ByvE&y5+
zPiXj%q}54`>)<zmE4GEEkjiJ&%QK<5Q6J=m?=U1WuvsOFZXq!6{gT7kjzlT)*DMn!
z{`L8nSx1RX@2-UKdvK>h+h<(0T8}A*hQ%LL=1aZ>ipL8zZ9As2*>@I@^RLNH>DCh&
zcE0230Li`AO=Wk>1O3zFfUdx%Hp8Nh(NW@kJoAq7Ia-NJ0~W(^wvnqqRt1W#R1tq9
z8Cy}IPJPT{>o3g)xokNHhmhC`S3^HcbyP1a%i-2N(drJ2+B{OUdBa5rgmiE>ixu{U
z;TQ`^BMHf;iDJP9!ghI`Ww{dI`jhY;Q|IVXNc^DOd-yZ4k3-FU`+yFi@&Axw#rTtA
z1sJxcmzP^jS8W``AL(Z4%SBj#8}V^B#p{x*c<Y*(T_9l?)(R7woBawJipLrJDKL$J
zvcG=)$~Rx$)%FZdI>&Tu+H%V_a+`Zw9y7~~#7Qne?r^`V90@{Nb|sx<YWSLbtVo{3
z$vPKVr}Xi=vdk!4eqr|{fD^#UK6hI^S}&+H*#vMsi5!caMg!E!{CL`DGS9X3Dp;N4
z(UWfc>ZRv7X*TE2970HGuCwI8P;1;1jt00ap}JYrCADPfgFd^h*}Qdam`hq3aLJ%x
z&^GKlyUxZ2pHVgI>-6sB?Vhy+u);M6$#3P6W$#fq9$Y&sV&v2*hLz;{#!-MxG~Qhk
zDbn-icDXUsU@a&%hB1D&al!q!buz|Hf|`H|a#5^dyHSXFmG`AV6jy>V>2F?2^IroV
z$CTG+w~LEsIaJzL+#<h#MSWC;2n|UpO1Jgh6XR|7;5bwBfE`FS<9Pt#Fj0O0@^4>n
z#O`|10#dNjUs@afltl7BQN>p#<PNrBe5?_oXbQ1V#>hoT=uXG2<D>~~+_=DR;evba
z3u9J~G-;wXjR%qQAlIi`FEVuJeYfWPV1O7>9O&?bobb~nGDF?`0UdRq&6d@^c^TX&
z>G*^+bIp{_{P$*{+QaBFhLnK#B8t)JcbzaFJkR=^{x2`W!h$B9*M49o94<yRmopr7
zw+#t{4Yau{*WB{F<d0}br;QRKJ|otYhf32oHDo~V$PC8LBx9jQfa}+%8(#P&+V&N*
zG{D<?>N(v9NduGUuXwb7)XqOShah3mEXO_*+c~u%qNFIP*itdRytvHc{{e|lYgWnc
z{R1N&L_O{Zc?&O}h-uC9CS(Ag?)6|$WvJT)9I@EU;9agKLu^HuLhb>@vMOQ%<Xi>3
zPH|zM%NZCk`?KO}rCNvj0A2Q}x$xYl8%_dJH*TCkaV|<$HmScG4F*;I5F`wmit=)7
zu>;#oKpPAELHJY_8#D<f>sqTLw86Qu*x4?BaxdoGKg{a9v2eJSCmluTKxK=&89hMN
z!;$AoMn7Lyi>8B^APAP>4ViCyM7KTKqXVn_?c>BlTySh^#MKtx)5fp3@1wkdOzf%7
z07S5fX<4B(#$|>6Wb(90qmO&CF0w!!kK+Ycg^}MtH?d!r6~_JTFW175+m=3JxrmXU
zW+DvOnV;bG2TDv_zk639lDcuGj+t~&X6B2dAdrQVe&;f6Z7z&&*0>@Jv@E$JcC+kk
z<^6x#rl9ut2Q15D_(uusii%RSNsn?8L+2wwkqLENdtjFx4LwOOo3%G!E8!UA6;lf-
zDXA8%l<R!)V>nD?vg{(ge9PCo8aEnIc=$GOaG0(0v$7+_9(m{7QX-WB#eYF1{tH2I
zNHv)oViD6Ir6DnNcxbox^265Bs6{kg9;{6J$pOkeb@?*fz!it}KZyIUyZi&@o9hIJ
zK_bVbsRk#<o2pR))|!hjRz#(kQ&r1yx~p<S`+KMD-_P2#!9g3`?GAcdp>;ErrY{<_
zcYix^{~M|}1cGKTC0_SDXNmgn_xhJU|6Ra83`XMSxF(c~sj-A$g}=9oe>)o@LkI0q
z_)gBD_4mb;|Hg>)za@tFBO^%~bm4J`n4X@AaUjw${9ovn(%?@GfZYD1y!8r%_=g#!
zW&X$Y|1h`z+gL-N1qHv<vgQ?c)O-%Hcq{a&lI<@L!~gase<bYH{b#N^?MVcaP3+D1
zwI%4kDgEEH^lyhDGBoQ@tU~8%<L>r0Zh*Sp(wFjy^8XM0#6PazVEJ?5OP>AMl(mBD
zusBy{91&RN-){Z)haobwf39<gs=g2UNsNDNiZ&$UiJ-ffi|DX7zSTPBywxb;`@VXF
z0Duv4^^jP5M*kLj=48O$JhJs~dPn~6ID{bKPa-6s^6rH12wYs%BCU``75B^$_;}t9
zrrtwxT+gSAD)e!jM2-;kWTj0HCW1cGBdt)}cv>R<73J}7M!CUaf<nVg6E95i4~42)
zhfF}zEVrV!Yo10q%tje-IifEV``4jtz}<28>i>8vD(p$bgxHDU^V>xSDq=WoLYxS=
zxN5y9;H4;PUwW;=2FqD}*X>5*5MFQVw@T9gG~$$%h&&+{24jo0)~<C)=5i6&IOaQt
zER&WHg8=(()xGQ1%|^ya>4EQ$ZbNAQE6M(-jzE@7;Bh24ELVr{eaIQ!7YMMVuUf70
z;{sZP!xY?&=16Z>b|vM1l*<4SiY)b|8jME=!uR{l8AF*@o-nHCaM_+Vyn%-R_wN6w
zp=&~@hEiS)yV|e~##c5op`j?kA|;sm>X1kmy_Vzq*7r-{KUk)C>Z?CFeqBTR*fF;E
zj8GY7B>U~=w4pKtB36U0iRFyi2ebV@{JmZN<Lvbx;;OH44N#E4djj|&NJd>42LY7#
zsu;N#M<WV46$RufssDol!m9qv+}53@^wZ|#t>1^6HB~IkG9eHYj`+&B)y7UX_#yj;
zJNMK7poQEZxc|!l^k>z0QrKR?M^XQy2tN~&_l;0Rd=CA^^q&;5@JA6sMs4-G)8SD9
z7tSvz%foeM_@!}BR6Atfa2d=M-_aB&cKi3m%YUvchxE{Cy8O?+Z%!KU;80_qE>x2O
z6j^5gQuv`WQPE2B|D=g#=(GO($q)sKppU@5Bw_v*vd!z&)7t)Tv+Mso#8!j8Ce@CG
z=>`k5<s>uigAXt!#KMPyVm|h7gT{Y~+N+;CgpjbKIrqh89-TEq*5}s<S;}OWWzrrm
zJ-{)9nOLsr%NOxDHqN{Ekv3$a*BG(c_cu!e&fESI&~F8WxRw|TLRYeD`ODK5-0W;>
zMg2zJ^KM$EWQZQZQ3}(!-$%}IgUX)nRZr5k23x}sl7NhV3gfbaSiTdN^JG0TxmUc;
z-0kYbX%kXD!YiQThj}xsurhUmwBljNtWKQq><VY@6vsQZ7fna!vWuQh{w^%t3G@kI
zn6WVK>iw@}T3hzdYfxmr3r)cyG<{k}o>XE{2@J+5Xg-x$Rf#Yn*LC7OLI7w`-fsyx
z4caGC$Oe>T2qQVa9J@a{^phC42nb&aO!*)Hps{mt2i%Xjlqp@OCgvRH0H{~`YCA_X
zio$u-R`*&_ec=5Nqi>M@g-bD3NS^ZxVz8j^(!Eop7VG)Wo$OS(uRDdJJ0D`N@w%BN
zfdVtzoZiQs-Ig2K)J8xLA|UnCMd-pQbH${5?8l^s$hzTfMcOr#yS&Ph$_d#SoYXdO
zwGEqC_Ve+lhxG9eytN{(zq=a=iO7Dn(>vUC6rvMc=mmNtb#qRi?nej)`cdi?=e%sA
zIV4d?Jv~{+l}4SlqN4IVT&eTC<h+DjMB~wS_|MnAwM$4)6>+7udlNV-l%xJ%c7s4W
zX#qF178Hcg4Jn0jf1r8yq8i`=_P<jK3ik<kl>226Y^cg$&|>?_;H&rrV7xikWJ9>&
zTQm<<*JBFE=Wy<Y8#*RuL@ntd+Xbgby*FDWnR1{VqPEtz>Qm=!$s2J4Bx*gBxhwnk
z*7td;<Jx?ELQwk3F34@cK2G4<1m_bQzZ`A`6MO-$XSkDqCr8kcXW6Z}16*(?Kyo8W
zh8DZosp7G;u4De)OQ|~Y(fuCPpMF$8WzR<4<=sY3lcX)i?N;gspWtoEj+Rr(-Iwdj
zT;@7?KTIE<XXN+Qg9N=Q>)oOvpNthhU9T2|a^$*~oK;ZThpCJwnQR(goO`!MJc&3(
zf0I&3$vEFlp?6)5aeOTY>9dPI9f}*wVAuKdg;w#?p<TDXi|>(+2D?6zRQ+7NF+<nC
z0B1GWHVq+#(`Giikq>9;2Xy8(KsMDN&z9%kDdUDmQ_o0bOb_FNot_IY)<A~fWH#P!
z$7@@`Z}!c9s*bP>dJA}eY!$=~*Q#<BuSkBp4rDbmy}$W^LbH}BNbnYNb<_G1_vA$I
z{0M}*|KWixmUyE}veu#or_CJyn7>Vyu(|+P9wWFIIh6m}4BkCQMC_Fozwf_8Jdl~W
z^JxQ;?=Ri>-8cI32Gu=Dsxy=!B#hir$P}+MjJ(P2Rh>rp4WxsuAZ+e#eTht6efTg_
zm-#+qfEv5eO;TL5Q`1jLAo)%HJn^IV2l3qymIi&lBl*C~z`cAso%7KXm2>}te)@$$
zMX@d-m1`vwFJ3kZE4bmOuk<eo$UEszgA=j>k*Q_c1nk3ssF5ovHgCecs+Qqd4>d`&
z2}8t&In%G+cU?vzRO#~!PP7f08c2{ib=R_{%koH03AS^8GN1*XOB2({1(pI^An6k^
z2J4&B4X-(1#zeiJJ{1;wI~!zkA*MWB!?$_B7J}!$Oo&SUI-Ik)`H2k3>f9mJI9Y`M
zRR>;`3A)k^{D+g%(hC>E7q5|-q!mxG*cE=E$h+gZx=B}hG5Eqr+^lfmV*WMk`>^tq
zIK>|3>438+gruAEDsz_k(63|i)<`&ML2xo(qQijq#(DYkLl>MVvCyl|Wn`RqE%H7^
z`^(xBHJWGdD+ctAMLUq)c6Te{%m+=g^<xo^^&``0L2q)=91b{dzRis^fE1;#U;j()
z42C0g-$du`dh=oXm&ljfp|t=u;6q7${H<IE59vkgmxmZRjRjGe2VZ-8eU8FYtj84H
z1<otXhBgmEcF}v5=f1kD$g>^hILZ$Zu1^lPPL#GVC#_w$)m5oq=`UEcQI^x7W>R^J
zaa(<Pwyi(t`mS8?(eqLBqv6+85M(|4XGpLpL|7-58hWRaJNpu+yGya#>(<mcQUc@M
zO?sgZ1wUrBeHk|9$d3WY<AHHoRn?MyE95?<-I?B6%*JKD!^*kI5Utz(U|%#)T+&ut
z8P-+_D!)Nldf1Lv07&V@<;q0mw+(?pdB}Em@FV{U<=R1Vp2eJNrCvs4bNNm{6XZ}$
zdOHAMLmn#jB20_0H|*`>-scrvYaEC7@{X(-!EdX26`1YcuDsr^Ey9u)1i0NRsFx_`
zu8{|<$@c9)G@rE|LLaN>_Rinz2zzBeP?&2f-hx%l^^*7Mh8p-~GrPeUa|~S`<j(?B
zh_b6m_ThV#MOL}o503}rWDM7960(f;HV)PuKlnH%%~(^=qJsAXLJ96a@CG&M1pxI<
zq*BKoFWS*soM$it=wIjp8<wjUc&-NTo<gXVUe465o3}%>_!S27gVkeCbM>8Tb#{1G
zeOR@hS&_Ag<`kIU+>;*2Uc^O!Vt4P#9K5C09%w4-ba>-+H7~qBG(MgirBJMsh*cb(
z^P5s?V%%D~6@n+ePtVBzc*ORc7xCWc54xRg9bOB_j#>*a>vP6<;Uk-BBIkOe^!}6$
z(ya{cpqlu$vvB=V$9bouQP7RNzDOJO74IVSnqqhlVA!Usb;4+g6^t#`)*9NM;Bqri
zbTwQgYKKLG0W5FJe`uA+j`Zjv*m@~rUuxv(ApSj4C#iG2OXSmL&^kl=)6Q;*;Lcl4
z<U|s&PDR@_ZMPdjKppg;Z;g>zMPVGM`8gOY_KBK{8%p0&Eo_H`C8O!p<h}$EJ6uzb
z?=DHYDE~->K_2m&wII`d?lq-IU-bSmviGV%bFgIFGr1qCkZhr;NlgxXS6672cbNOX
z+&L;dn^`DTGggQ7Hib`!a1tkJQf;`?_uv}D3xSS6G(Q67V7j(9ofa%{`i1SSWS$Yi
zC2Oms)#xXAY3@aIBWDBU<ae!)5AI{1@?PgKbjPCKxxT8<I_aIM3xFI47CsZghHar_
zKT5*Rk8s%|T_KAug?^pGxwGgs-!}vXuOJz8N9fm3!4KuE<wVbBdz<#g?GSmu3MUaJ
z+=_Lh+{<=17(i;v*iFp4VcJ=X%NY*;iwofK29GDBaiA^}DdS$HTk0N9B#Zw+Y`K#}
z%)qe=6IoOgt2H!;QnU2e073OewtOPA`GV_-XMi&veSdQHHp0Ju<G5ub)E(BbLVK_M
z?4ZE2`{U-~?|#X<p`|CE3SZ;^eqTA&5LM}^hn9^_?(F<Zdg@wkM--%i`C|&lc}pY#
zZBR4V%;n%5e?lR$`3beNt1Ws>L;yeW6n*z{L0u{_?TkoHMw(|3$Q3((*1}etoB*W-
z0B>ztzwWv@Z96qx1OL9~r){~MXsbLu8(?09s`1NSBB~hbolwm)aMfF<nW<eq;8w4F
zKG-QxjKYvtHLm)x^DXf7&ZRYIZX$g*YunueThDj=Ni_=?au*eo89Ka{-YAyTjYBc;
zEOwDu1!59TMu`jFE8Wv!#(xGg{3_$$p1WK-GbDZEW~z!dSCU-*cyi*;*&2Mt%7W$m
zQ2(f`&S-ilhpGwx;9XzBG%&%`2=Khim{hlVn{~I`Z29_X*T04Geagk1#i;7liB3v4
zj-eR-bM2$5P9XaC^~xWQcZaNFdzTbDLPsT3Pnhc66rm3fvQ_5hzHe@BkbO?K`Nt{x
zI=ASfHT+<F-}{|UirQh&%v~C{CqS!VsDZMG_kGTS?5jTTVr=JxK9<k1WfOr6&W3%C
z<%_ZudHuQXdv-=jS)(<;Z)#og>ixBMJg<j;v^;Jn9_mL}U+Zy=@^vVku3#{~IVPR$
z&iX-(>6|igv^o6lksQ1ww4ln~Rrs&;SD1JKI?WGP!C1MJ%3+GQ7rHGOqzhF&g=eRp
z&O6h=eZ9dXVeJ}>tc&AuGg*(r&%9V-l-*pKL1Q#=r?FdO<i4-fH=k*jRPUj5>CA!V
zD-W{DhR<g#&m)AkV{c6>9=Fb-5s;1z{CDr2``@E-dNET)G@zs<MY#L6E(EgSzD2_7
zVLcp!o0yKV&d-Azl8%cRINHEM#He+eFjDfl=LKJzwVO+5pH_1-GdcgPrpNF^@)KHp
z7VEG|G?uQg*9r=6^rfHE*4}RwdcGO1c8PoZ)FuHp1!jSp!cYu~tmT&n@0`Z1XP2z@
zth@w}1v)2*U(8A0#r0{Irc*5`2{gqwj8vcUQ#>fNIktthFRgv~S<7i-wPJk#!@pnp
z6pMLMLR5$^Ao?pVAV9zj+s~f#vMK(gbZ$b>T<~Xy7g+)Y&(R=+q4oQ7;ffrVnIW{?
z&_Vv;(LmH21fteV3Xa^8ei7d#vOY_$7jC_OV!wd@%KS7{@vPHV<GhC%9M-(e-FVx1
z%iqI38w!ISD*c3*pm2@k7)U{CX~4ppL<X5RK0D{P&huz23#4hVk20MmZ-1uhW_TW-
zBX4)_YFHJhdy9NKq};YfOE1*7{t6f<=G#u72g2Tt(RdnIsh&MumTT3$O6+kaoO@WR
z7}yX|-f9OX@FH+$_)*>$KGyVI3Nls2u7Z3K_Vm4aR9+Yv5&U2YU2D;^?aQT^GaqEx
z%*5W&v%Yg0%qdDi5a{sk(+9c0Pb|XdKCu=@6C3(`xD?!THjTP{XS_yYZXtjc9Cvo_
z9UC{HO|jPae8Xt4`tWj;h3Z2vcRyf^fohtFGR%a{0?R|f@Xh3-IHHs|ACA=fhR+22
z4Xk!(P6U;RmCSaC71X~sBT&BmLR5W)zk~G~^9KS3EDiS85E|_JU~8*!hg-T<ei|2N
zpFQ6Mp^-Fh>mY9T-BI6(+rUFo&!yc{3}_qfufv^bKkE(T+Maag^W9!lpsH@A4HCaf
zLnn;yxJq;Vy8Q^jn}HKUAx`Ul%;?6-eWN26S|^n<@M32nVu^cu3Hmfjecn!Wg@<n7
zadE;h_VMz}FSVvE<gx|F#-Ex(fyWpk3Z8oH-Pw@?Yda(ln2xjfD&C%z2NzuP>vQ25
zXVzPOib6ZL(;vzV%KH!&%f9S!%MIHYUVH8u889BJ@s5F~<a=RwQT&(=F3`L8>!N4B
zYA}2@>vTSV($ZI!qyJ(OcD!anzh^@mes6R7i_hnl#J4&^_y7zaFk8<Ka55ltTvf$9
zA#3J&Qq3dVuqZ6^xSoq3oi{&T-YRt)Wb!<--TcODb)-WU_~4iuvO+ps1XkwX0D=L1
z)shjf`=g0P$x2i*kY=l*-ike{N==blt)BjXv#_=_J19SXonVP6us@$GxO<CQowYZ+
zxPe(Yv-9ebwB$?uw%xxrt3ZhqpG8ez;*%9~4a{G$OY*XFze&5>USf8&viztHS8V8G
z#Dem|0#>)<@8^eKMlQtGR5RH5UFv#nlc-ig+|>%GD*PTBj3a-kiinEahl|`bxI~Vu
z+N^6oE7XV2eTi9Ue%od67|;UqV~fTRG*IeYTyf4oF1C0d|73YpSP1H{&zS<Mx5@-I
zI2<}rf(JrdcH^fi;K6TtcFFz68c;na)m8)ugpPGXqSn?-d4kmavG9SI$qRNz8eeF+
z_i`)tzk`06*>%;WCg>3Oa?Zh-TYnR1zmKFIPG#RqF#L44<cZ_lZkjN@4gY{nL@*$@
z6g~@{YmK~}a<InfRq{niaGll}OM?h+GA+^*OURGXpaC6wc=2+uIG_5dVPdgiC#_8v
z?#v#kiuf*W966+h#8!CFL8QOTHjc{ffFFK%x<5W8$J(S(_U5AKFn8&H2@W7I=pf@e
zlUZyo_SmBMd2&q3;r4uCHgdCWOut@sX{V5$b3QwX9N?t?Ky_JlQcABslRP0llaidD
z*dho>=_IY^_m5jUxCm<5>h;?!R{u42bb3BZnqyYwxvj;@E`4iNE2rO#UmtV%k#ziL
z4f6!=aO-{4j*eN8=lqD=Pxj=t`DIiE5xlRTE%<TV2(6E5Ck_yaUCtx76J&b9Z3SPj
z;w1fR{8jjFwjZgf+$(Ycvm)0d5LtI3YN0Lvqh!pPfU;A&Zxy9d-dP1=UGVR6FyHF;
z->@=B1$>@Gdv6f3_}QYTYu<KPZc9v_{t2xvRjs6TwsRL*fAyz`nXC0&Cm&8)?O`6m
zy`1pLJ3WNrBMPm8k=`sdZ>_$0QnnOWlH@PU=gk+dEF0R^;EZFt{YzR#MOd<KIOje#
zf1kY%`mQvb9m5?@39k39{Qi?qHcXj!Rs>8o%UlG0!~Ypi#5jS{_x_<w6|mpHAgG5#
zAVO4_xYy=RYFdnvLaRJ3>k}V4Q`eF+_pn+Qe}$Idi@e>1*R1$OaHb`wKc(?YK&%2w
zX{9l?v1B$XF?M{XJKFRuLB9O(y&MBWf4er3#JC9S+Ytw6jj{+oH!<3lWzu(s_%8r#
zDt*tpwh~lohczNCbooFijch!68EeYh<Fqz4?~}!dAH<8(nBSy#sF$tPN={Z{uN*W_
zwPX{KSS_$Keacg*vzb;r^BVfG>5mmbD=5t;0u3W}%!Iv8+U3HZ=dzqiPkd|5;_#Sn
zR%7%wKt}I{!|s-&vbmg+AjdVc&YF{jW$$F?Zt!6(modxU7QJWPn=iCgb7}VMZ{+v9
zXZkH-d~96rvJEtcR4QCQY_UG6mMDDe3sHE;Du~Kog1Hb$eCr5P_RKWmSpmE=IQ6_V
zxXoX+xBK+9g)aLXV?bfP3{)-EzNA_BCYlvuSP_N&vwNh-=+I(LQ7=p_)H(<2BAfYu
z$LJscH7I!187}d_EBOoA^KC-f9gJvZm#RTbMG?Xgxo?d1nXS<PpTkfB1c9?uw;2^z
z)3Au%H#T|n1<tVl&@NL)XEnnu8U4i7F~xiS#8A!oi+CbC8#1$Y72R5?^402Ybvt0%
z(i3ROq>1Qj^nb{E>!7-pEN(Ojn&2KBf_s4A4gn7C&cP)(2Zw_McXx;29^56kyK92G
zyS{U0?wy*M@6P@1`}5VSI<>3M-n)9QUh?a;x>t9%Qdu(|jSVG&f3jMFkmy|=V-U^~
zLmA-{T5cWJ+rYzd@k!K0ZXDcl`@lQK8@W!GuZYlTR0n;v2Yzsi4fn5w%>p&=wvO(I
zw5|!FmV_5y#PC0<E(+Kqp`g9K(V%v$YEMIJcpOfVak0I_Gt@IRgV`{UlUjQb<u5rO
zG1nk3AP2Nh={dK@wh%k_KQN20M%u}we2TfrpD8eEc#O07Xf-Rj%&<nRd)21R>(Wj7
zJbWATkP`xaJ_3^xn!zC_Il8M9ZQwT?xD>1?7kd^Oc&F!vvqX_!msWpGBfuO@^46_r
zU!?{dy6(Jwc_5C8^CPq0`8JvEyk0{wd4bB*N+Ic9s)12ZrW+|~wfKH7(sE7bGrdIM
z!Ze+adqw|hs!|Wnk`r6dt%JK`7fFr1O7lLL-AcU4uOKF|yv1JYla$?61(qqP#v~u+
zCLz7=&|#6^#^N65A7@?Vk)S&I<Z_F%x!vYZ8`mMk*^V~XHb^Ef<&aIouV+mm?^$XT
zYQtimWRTk|87$X25X<KvQ=%O1HcX)pWlWohk2{8P#hi(Pirm2G`oqa>&>~?dA}0zb
zW=<Jl4xa=VYnB9T-nC*zsyu;n;?XW9%%%&)q(VOTYZt^8t<gGuzey<JCC)q^3CJ>c
z_)c42h7-D^ni!NVPBDa>Uy?zVbY0c(^ZZjTMSgc6x>DyBckggJ-s}oFh;ocG3}r1T
z^dRqv_r7yY|Iv6hu(;u@QGNNSsLD-jno!-lL4(JrtickGlrh!8G&R{Q`H2Zds7lh3
z{`%zrw|mH@VJgXadwsw))2~6xR>*EVJu=i{&dnh2mXE!UUD$$xckq+NIq~VBO(|z&
z8<|l-MNCqxQhF@|oWay?N%#GvhVk&$^H-kZ_kmt_s!O3qfg7hltF2;*u>P?gs{{Oq
zCDlIQ0ci`%wrAL~D>Hj51)~<yP1&Ncg}wXT7<fWML%}UyB<X7Z>HTB8p?`9#8R@9|
zITUL=!A%l@noMe9yZ41omERQIOORoGadh5&l2{DO9Zs-MuI}wynT`p^z;+C&b#HeT
z6f2;0v6Zc2-w~m~3>6%Q!EjiuSYJ@<N>X&>uV+3Au`I;z<HTzjqXodE>qYd+;ZHY`
zM@&$pKHU|yFcL@k<6u-n8ZEJqxjWgJ3bx$XG8}X#M$u&-M2+iamN+*6w_-Wd_hp$b
zyBm#S?k0a=foq6SJgZgPUe(M~bn^8T)tBe=u)|XsB4=Ll`rzHu@P@wffIXylAG_5G
zR%7Si$?0O`POT-Hk~7?&NCDZgL=;`A=fUb8mP7cep9h*$HWZwEa>2^BxT|AAFcO3U
zeFP)CMJp$^Hu$=MrTm}=j@#<Qde`U%l~LgnSS0380#ny*-_6zKN<CPYohw|wkDyO|
z>M{474@^wX4o~@2t7EdVr$ZcmQQTF3(kBJM)S51BB@weFkLeN&#=`iYnp(@HZH#SB
z65~K8|M3L-MFFMMnU2$=wt&ob4<|jO-r+?|`GN>*c_a(xEraNCapR9-Ot@i{fVpt}
zS;8O3!I)^J`vVsZ)LF-fZs)y{Kyf%6@}80J&8_bX4(eT`%anqCfk$>kcle(=djU%g
z7>0RXBYdq>dClGD(|jO`T8<Gu-}KBy^za*Z1xLtEDH0bv0oOtzXNVXMv`5YngVM)y
z0s~L?!ck!b&MoLru?KHRS5wV&Tj*9bTW<Ummom%jFmDEKd`%~BT1}0O7z@3tf&7ol
z)Y{c4Y~Rm%b;KU~6DfuP4NB2aBMv-67gpOt9%C%stu_&x)l1rUYle%%@$Zi}Qe)(a
zGm(zzkBWLGGX^h>H@owOR!_N_=vNM&wm&HjaqJ_Vhr8t?vYgJTG?g|n#$ICWxn6ZC
zGFR2^z}>L331&&=y(f#<WkwU2zBK5oYsiNW<!!ZDHF;}%nzz8Dkao4PO%ZxJTmHtu
zV(oQ$O3IZf;7EQ$5PipX+W>KZy;We(@TMFHB~xX$>FVso>ZeL|!299JIp~sVWT8#z
z-aG|&E@ybC<itx~J#NX1?|XSFVojP2Qcd?LR)f_KWHR@NX6YOX?Qxg4I5pq_xGyae
zmU7MY6?iU0y~EMtus_-yQwXV_?>JZ%$v{&$QuJR=TC><?;_Hq_#I)wjIO5BR2Z8JG
z$!k?Gl{h+IFndw)!o5p7%q(WJ6mO0@o}bR$Vvvh-#J8X*vBgbCyDL{)k2?EiD^QG#
zf9)PFaL!g_wyq|Fl3edQ(x6!qBi=H-^u5nwJr>4Qw@v2yu6HvR+AX}el{h!Q;~?Gs
zt-9e$f^)g_J<<6lu#*q-k&u3@$=H~15ESlvLHzsaesM8^%I{+Kwc|_5Wev>G=Cx^4
zy6+4cZ?7EHa@;H@Lgu!W&wjK$!7HNU4N=!3i<)k)8E|l};2WGN+*lXZ3uzBZ&?C=$
z!JpfuCxe|?Ob0X1-jX;Nu<rNzC3o#5O_wsJ5In&sP1=<vX&A(_eyfLflFjJ_;A4dD
zjqLXqmecQzv*Q=U8u@Lu9;3w^8w|7@J@?>Db%Ey09j}|Y4IM??%EC5T$Hbxg#2jrU
zw%$lDWLU*dEHl{zHzY1le-jGtrAD0#H6O%4Hl=67S3Vx4XZYxXx86%+{7}IQEuqqh
zOJ>s*-rh`J+G)KQA1u2;`HRXp7<*FLkAzDY8nVks3m4{N7zh7K2!1(Rk1!;UG-a5c
zJWT~9ct-k+$!g`{3-_7Q!il1#+Yz=@7_U#w<w}3KCVtsi9e0(dCes;>uOnZPNQN(y
zuIu~s5*Wy~jVrZ_4{!-y+XCHrCF=IYG~hWD0FNRJLux<3(r|>I_mczSKHoj!u?3|u
z^K#qs)b}(3$`6P5A3BR^Y!VwnJ;pKBYI{sp<t)1W4~KfMtM1h%U?gs;xoVuOF3a%)
zGxH({ts5hm;Z(buKR2qkB)KFYy4}J|IXva^q&ff#c~E;i=1N|kBg1~GsCCVlVQsGO
zj#}?}_~v>eTD~WN!r#^)zF}Y~ZHT?Uz2<MqsNq&LpjWH9c4EUYC-gw7Qo=FRk$tVx
z&wOwWM*sXH(J-RD9BR_NlBa6U!-so)c06hQvn6Kz>O$wmv1M&V6@UHm8K5s6&1OoS
zPBl}-{HMM|^G=}ja=KyLN?VhDR#;5DY#ViQ$iB4N>}v_ObcK2qLqo*G(k)Uz!rl|X
zDe`5nT@}wSsTTgWhlyf?Bk*diSBMLF5`QV{tOPH=^Wh+5vD4eSd6HSow{PFmj@dQ2
zXx&yj3do#%u-=YMJNU_MIXz4}XEw*E9yT(#&fTx9WMI+iEF<n<NpkcJoyr3!iA_%U
z+*7-i_BbrkXJ8)69fUH=k1>?^*5Hn17C>#)_Sx)0g*&W1myb;@QESekNoQtAf10o<
zJg@4I68ne@Pvu7fVX`W|vg$tX6?5p_%uPu%(hm9Dj<sV;r&haT?86yRBk_*q!oi+V
zYk@4G15XL661z$A&Qb9T;kIZ!2i+o{fb4pl)%;7fFWYb<?1#^?`{R`3{>|}nMeX+A
z#n%@-NkLW=WOv6dm3tb6p>KwlGK_(87V`2zHzpW&lu6XSS#_J#3fkR<Ade)HHHk#!
z2dtM7q~~&m!EILQ&s!<lJqV9eb8C2vS{3HXC|zSVu*M@#KI(vggQ_b9R~vS|95+2z
zM~|OqA&&!(pjDDNn{3x7qjsEB34B?4+`#@0I5u1&uSIOVF!+eUkzFmj^yc88S;@~e
z5ro_u`-^La9f&j6iU%dXwtHE2H{{tVAEPYb<LcB1f$YGF+eErk9!cODJ`MwGC(V2L
z(7U-}r#EefbG7sQZ)=;6@!@aqxi*~&U0laAqNmS>@87F8c`#9G`ogPdX+Sb-m8nX?
zz8Sfl3cLiSPv*Z*nudPrW)<gDGC9_#A9@^^&wH`K`*k@bi?9q_dkOgk4=Ok~@!@WO
z!7wRhUwqw~8ay;x&hq^_%Y8?E4DZk;i0>Rp-xH^hKf^oF$o7k7`IXFvz<ARuB2bB^
z+zF+NFl<EI7ESQ|tXUvmkuJ{5V`yK+r#(0e#wR^<JO-;msob(A<rdr4tbGqh<N)=&
zwJY;<>Ac-Q7U!_Emx9&@M%opZoSMLO+f5vswJ<cT^ANhjPVBZzbWbdfvg0Dfr8-Wl
zBhAPA(=O_`_KpGlZ8Rj0x3#sF9B0DJx-Iez?WS&2(+TVzh|eV%G8=Ab5!265VXxbo
zGQM9R-w~a+`$En-zM9KgbyCX&GWT6!WrqHKiYO|!cOfRZR}9+9oX5FJNB^z-=wmkf
zfJ+Nda)NkYwa@M=@k`Enr^%k%9YLg!@q?g$KaP-%UcqdHN>pW8iaM(kmW9|>go;>B
zD?Ra7mYpN`xaiG_kSpJYh4FCrl_dG}>x_==b5O+!W(2=3Ju*+aSz}bJ^aeTdrj;xK
zU}Yi;pG6Gh^Tcz@;5IUE?(k-w%oIpWAwm)H!$OPzYUOLyU~>CAoUuh~cXzjStWBFP
zKd)5lL`sR47%=`(%_Ns<WK*;;rnpyOQ-m4EH=p==#M$^n5?nfKt(~VcMh7_w<i@zN
zK3?xy9xp^LK2+-6qI9@M7>UX+?z;=1+dh-Z4+*#7D`mIg=_j`ZM{So|;#5B)Oa@2x
z`Ikw3bUSy?TqKv7Y3fTV!dwOEaaGC%3$%#3*Gop@8_Cpf?^hbO5eywW+V!0ya6seB
zYoMk528)#zhj*hG2;aY+tF?-k;xc_a*Qz`<)26-o#$4NimTbtKT&~lOrB-pEsj){;
zB3>UA?6cCaRVRLyFGX;rE|bzobn_Cz2(W&(rBrm1po-<axd5I?U9wv6r!qUWvR;L>
zp{oIAY*+}#9eqN$mhi9MIU)|+b8?o_=%k+$cfr(!NHkj~smp5#hc#B;v>zWbszy0@
zElWwae`WwQaaWFLdpIVFN6`Zb!*e3=d)@>`7EuA6Q`3+)R6q|N^_GXK1w~;_))lb>
zf>C!YgDM)*G|s$G<Fbv$%4h7xGACjqJy>(1s+u&-TiEW!>I-XWrDgtyr5~K~sf8wW
z^|0pdz?JJXkSIm^#1#BWp1$t6jp}+hGjQl8C0&>}xWU=6e?8;G6Y&EeKZxzzbS{*w
zYNG!%59MqH4359z6wx*>HZA<=v_k~ETa~7%cVN$0LzZ(^bObxd9#mC<jvjmZc{f?l
z&eCPKlBUk?;}Z=8-&S5O6Oo13`1&m-OwGx>Qx<+0MtdjP(QNh=17mI`qv}8yc(PX)
ztCP@$sq4&nHNj_~aaN<QniQ+vIGjvnjk~3TT*y;KF68Mz2#g^ytFZt&9?OH+Zd07t
zk}5HA#)dvFM#pxC_O>pD2GlvtZB?!@wB4#R@)x&iOq|@2B>rkp-MdklU*oDv#8{!R
z!XndcL3z}ox9e=<m;sl`FJjqCCq^BQ-hWuF?Q>kmGBbU+b8aJrk{c@uRbH8W7-yN*
zC|V?Tvn{FZLv|&?Dc+d?VHAo6?*Yl_0Wk}+)o`Wvs|<DV?M@q|L)-1drN)-ku+ewt
zMerwukY#s2Z*)uHTQJ+$24h|<_Nb^QLl)v!U3Ge7ocf7ao%~mk8KT%*uzGuVIwV)o
zShooEgY;%Sunl-NS3epiG|6%lo2<pDSCX}9zg@{d(sX&^?eE1zJBQP>5-7U=PNfU0
zL%`l6aKkY<cw>TpB>nR9_7m>miZ;@9LN<Or{x-=~!GQ~{+zRnlHxlFXT}7iX>~;a+
zS);M@vU{qBfcW9bkC;U+q2$j$2d7j^1tGphcnqP!Y}8DdHwmqYQ6_(Wsw&WWtBs9q
zCXB|cEYxZialR45|K%RX6LJh)`sCF?S)`3M?ql<)=W6)<Cy39?rnz{$aa8vp<j#G8
zp-nfIkF5LcX6k5uqbcyG_DM{{0k_a-%&UL6qk{9$-(;hfKaj0I01yXGDAe7}3cM$U
zu2LM7i;(GFa&>o~M-y5`GJ}RNht_+lW7$5;&%AQ*>L`jlIwV}G)cPz&)*H}`H#E8$
z=n$NI(d`U2&MmrNhCBw@n-dPzeJNEWhN-Wq#P@lfK69R}X6a7cd>Elsna$8`br3J{
zp}2Sy6s$pRMi8yYku_{bdHiW*C|lCX66@Co{<ZhtD1?mGD@EP+OOnX8sTU{}d;KQ|
z^m-aCQv$hISe%34zuy1|x^do>qFsWx*#pS57e(nelF!k}RhWqnydb-}&(Uq7QwiL@
zXAg-t+EtS9*+gq$ezsnwHOO7s2VFE#xR5<j@8bppq2sgE(PT79is@>WD@}~mC=M^x
z5{*e(4&0{X_pBdh(*0@^O8D6Dh!p&~k=I25e=P`Vg9rE6d(Qp2ron23)?iy5jTK+Q
z&Dm1I=5D8s88|{KbQX^?OESi7y*eh4^EC4`p#iJ2^F%%y>9wq<Wt(z0SC<e;qIH}N
zO{io)CrA@$N4F23_ya+^sdkG2Koswy;Du2FkA<PwSVb`T0j*wgnZ)>QxxsN`K`=U*
zRa`gV0zsf}ql!&#JuNS|Qo%qeSR#A<*EZm=>-V{mc+>gE4m2S}SOvsNF=JVCC*-Eu
zFCpEqNT|Bh>tDM$m<>`J_dBhbJ3f$kd>N~Uz+j#4^5|M|tR%!stcyTCj+n*$VQp)k
zX02g6*b%dKBO)cDJ*g%?R}fOvjcRtELjizovYR}CdIA;M2VLsEcxWiQI>O09M%#_u
z1eUO4CX>l;F1QckZ)C^XcBkgiw?erk#@sxP(w*BDE!Qrt`|Vp}IXntaR-MPjSYRXu
z#59)qSGKilB;#(QO@nBf9Xy5BZ$uAr_xoNWw6oAh#t{nRRPswc>DTW#FqU|+tG?6_
z2S#8^-f*8@8sq#bM@R)vy5M{=1&+a-kiTnX*cluXNa~p5pGu$<>7iX`GsgOrQZ+Y%
zLuY}8Qo~trz~@EPzRa-*_Fr95a&Fkqd6jqzN1oBpFr-^>F^!9PQF5Z@g}<;Yn%V3a
zx#W{u5$2?&G^tVkBkbwQjX_)eI84giMzsd)xw-yg@bs*=hA*o7e(T$<aWKdGK}asn
z3mg3zkGKI`ey}k^@vP9d5Qeh#)sv;bT735G67_xP<r0dORI$KP`!Sbe!<Q$b!C+B9
zN@<Hb;)7*l_dRXLO!&T`<q|@rym0uV$5p_02J+12M+5RXMPGQ2*zKHEe3p-Nw}MO~
zv!zRn3(s7N-CB`$hP-WM>XBM&HfQk&XZsJ^UlphDdz0%_G76ru4aQA20hY@q=m=V?
zK)4%;#|>$EU@f6YcWQu#z+Tm!TTi_uLX4dx))Aqj`YO*s6*+8<h1-djz|V!+-oE6@
zx|9Zw$0}W%LR6M)X;Hq4o?{CzI!z-X_jg<Wy;i_-Fb<#rXUxGi9#LnN(Km7AfqvSl
z|B;_X{sA+|!E&BoW-R(6M<Senp~nl{nt8<$gRlK68|+R4ed-dBp2)(0T&z_Rn`})}
z;9Ep@r8B+i73;BEUsJ@+^Xvqaw3OR3&vBfaFth|464nXK4JC(YXs-+^G1XC@@EM|#
z23}{m6KL-tJ51#Bs6enGAsvxVoYZWNRN}fi*#4tgo<;c&vrI3>enW-Z+l`>)PXi8X
z#h(Y_>12K>LJ!XeAo<IYMtEKzMdal|b1`|8h1giQW!%sqSVju!I@*L%GS9*R!n)tC
zoQ3<rD4YQI0$W;B$COY?`8l{$&5lW%pQCK)DF`_5TCkxT-)oD$`OSMoCH)7oGUTkQ
z9SwA*c)*>8J8&1d#AHhk`m5QPeJn<Kb>$37UlgN<dueO>VbYv2@fO*#D+Vdy<+`{s
zXl%4&i&iZ5#aD`LafOh+_ZjZHqL_3Wt#v~j0>R0qyY#+T&|J)<bb7rt(WrX9!0nPj
z1{TyLVYPG~eOq-u*a%#cHk0J-R8-8<5w_X%+BgA2YB<_{HSJL<AJF^|ibBpWO%y;`
z%o#8KQEyN)cg8Hh`M?A(oVshUxL2}!WC#<d@mcWrnK#m_kr!qlG?o3wVBZV+GBC7a
zSBu4Y!zYlaZ$ejw4u5U?19q#=s-DHGaw}4eQz+{OD*}^}R$wJzX#cQ!tI6I@kPR`p
zQ?3^k8m!zy4&8RH%>xxv5Sxi`=@Gw5vxQ@`(v=oqI~dh1bgO(OG2KF;lsJ$-<a#6H
z2cb-{<g=8#v7HJ55mWh>9;`#U2fSYqkl8hYfdbHKn>VME6<MT(nwnT2pVq3+=JJVG
zM~7T{-4HIBwO1X=UO2HmN;;~LqGMe_+4DQ4*`pubUEVi&$8m#8mD14O=>f*IK=tH3
z2J2VE$Mdht@T8dH4-DtiDb-uISIf5@pNyR??=cFEmztIyU)2Na-1ZsBve|6AiVcD3
z8+m0pNA^=!Z7TdgXZ*BcPb%gl79*)Q$Pq1K&^jl%Q>$c9LK(-l-Pq($=^@<dCMP2l
zc8MQ^qUfg{7G}=Y^F1Sj0CEqX$#1SZTu+*nok^B%T23<TxZOKFZtD65xk8O>qZYC^
z<3zMC2VVK4R<uz6%y5|ee7wwqzOgqumY5^BnmX8Iv>$(jsOJ0w*0L~3yWX?yP04kN
zRoz58AMwUgJ?;ADr6WySZ2vM>TwNNE0ItKh;{Iog$+^YD27x{z^?cD+>7%z;be)`)
z9}vG7?mu*wo2IkpuC4){5yLdB-c7p+qywJrp#{BwTe8JFtvgv|3|Fci$3pws^<TaX
z9W%w+v^x2h*`qv{ET&=|WT4a{UtLhY=bCS)-L->6*~->%^}o89IP^n8Z1%^1x^f<b
zzCp&v;HetavlZ4wH^5Hz#U(MFPvQzQxtCHkH~WeU!!ht4NoV0Z!=a)8lg}n04mr$m
z!5y^zA-R+Gp=|3qOE=TQ;(PLaOO!MzGh3oIG-jGp?qstIr_#<Etn~oh<*|y3Bcfsw
zT&9z03anGYtuB2g9ljF;cN$-_>0H=>7P{kZFhz(9+Pd=Q#r~22xQm5;F*=ZPz-pY4
z^3rKH=&?5771sDk_Bl@dx?y+O?dJo2gaQ<jxSQY;OxeYCl=Uh{HPi}(@DeqVC-Wb0
zpe>x|ko>7_gG@w0dD6Gfb`vl^hHL~%3N~`+7A5C1gvIsZO!fDw7~UH+Oedo9b0DGP
z4Ctus{9v8YssHT4a__5s^y<N-YV<gA^2$=7G5H{Tr`>{$SKtZ%abZq3{zJJTu{HSh
zeQp|EaQb6J0deu|WZG?6JYy4lfyWJ@Cm}nczf%5tm>}0ng*3(wxe>TUhLS`F%edmE
z!>B?ZVG9H<5Dkdj<q6Vyy1thyS5iVza<DoNgKau%i6zx@f!nVl_ZV1?UI(lyA5*Yi
zDjAn}jozAArtQ6jTbDh`;AkI$Iw4&dwJ$(Qa~76`vEIP@Bc~wzx156GDb1(^Z_iA6
z#|m0IowqRptCIqSD!E`Ps%_!7*nI2XzI<(<PATB|;RyBd=f=VviE<w<?d$alY@r%a
zUry-<yJjl+mgiT9v!Dv#dJ^H4wb0~J;Y2w6L)W;6-LosuMB`;f#sjV0mT^(?C4DY0
z)mkt)e8mq7{WI{h*p<eW!MCtudRxuXGiFdw;)E6(zV6qOSo|QS7~^$V6RO!@m7P&!
z|1b2`o4r663L?OwPs0uCI8P-OW$;kvHhSEX=$2DS8n7j<fTU;~IY!~jM#V`e9(tdC
zdV}GS-49oDHqYqD_!r9uVn!KmoV8;>-%*83UmYJf+$#HpPABRz$cwQ=bo01tTV(L<
z_l$@SWBUcN7zYD>LvY!x???OPoh?@#QP0Y6i(S#-#5EMl@63^5$JUBj;csh26}pfP
z6?rdJy~rhLBO$|hLklad<m|aYVYDwbK)Wdz0=0F?{1>>ywo4k#t9!CpMDznRG+?IY
zYu@QfG$)%B@B0JBo=Tw|JmFpZz?dE^E0tUtj*77WRVwH-05jd7R+PJ}m|SE6C*|=T
z9cU*vUytzE*ow6Ax@+P5wb8q1TK4gd08;>=3f$gHy()j)6X8{0CHTUPekCSY?q<^s
zRwMVCC`i_{aXD(XDAF4S{IT2i&ZyA=={nscy`j841cQ7=5H1IK5{jmKAJAOLOU+1|
z4qnl6uATPT1Wiw5zm2gFjl!fuFL9T39gdy8dgR1KdJ<gHeit*Oy1^A(wv{PdeS4)*
zpvf3Dc<E`KWPu<aB-J4v9{F?eh=mhC8M$Ql@)nx@;aI$61GskKePU^I|9!P}e;$&5
zGU&+jeG?AXiU}llG`g`UqwsN@;Eqtf8y=XwTvG=&C4EQ1KbK`9bL!p~3NqPhFktA9
zpSfFW2Qqo#+bUm!A^EEfM~`dJTp}Y2x?^{-0gDNA+yW=H{Ne`Zj2%}7+WbW#&daIm
z)d>rY^QGbr9(hX^&s!uue&vSBeQ^wc{kr0Z8uGE%>nv^=qf@PAL9QoUX(v*7W386Z
z1D3$Kz{yo*iXxI5_s%%30RIXU>&j3Sic#I`An%_134E!ibVC$aMXvOS3CGcHihc0*
zurEM^(n`~Vcn@6b2d@71E@rJ?FlepSbg&jDWNW|PxBQ20LdB0M3-&!J)bo>Ry2YWa
zfPC-0P<>0PS;rvlKoyRw?qgSbP+84R9DZL>cz35*sp};s6KHDPxKea!4fmJWvSW}F
zLsF}dfgw{Zy)%W$axSdtHx=K-ps_{oq52(v$dcjuVA}qRVqDmV6$;;XW9iqVmmk{;
zDC!RQXml)Y^&T4M7JLJ@nsD{eLcWL`I7O1uKC$y`I_-9Jl~9=IWi)tVGT(D&8gEQk
z-NyQ@xcqQS=&}xMkR$imiQn;e<?+0XlSiTi9C^h5ikPVu!dBM$j1-kp%K*IRlkKaA
zst{82VZH5-U41HDe3Q*1%H7-YNQ~xD#tx|Vz_za>NoW|lk<?PSYD!WHbAd%i5OsA*
z&DD-@nj~USjGDfxtlZFd=jOZI(LIW3wI@@xzC)8@MRtKL##>`d<jVGa^rZ~7Axknv
zD|(Uhy4L9CJ^f0`f-RdG@Z01(y}29rcy6%LA<zJkbT$X|*ICWWGfuqQC2II})~{lf
zMoT3Ay=w(#E13sZs4#DHw$c-c0o$7CS_Y%j?;cD+s3{~~h2{Yf=hF*)V3dWEh?q$H
zNA1Q0Xu#Lse!^s^Gd`Q+(=U40PG;nOoUQg(#=A<29d>*M+ULqX8VYB43B$=|4OF!}
zqmI5)Q?KHrFR7jHqE36|c<96X8%>rmEjAmhr8&>=(=nu~OOX_ENZ$q2)bRi!D@b>t
ztJ(_`2)kcMgsSplf4t8&tuJwe8a&jSJX`e9{B*40%T-b>U%vpe8>g)Ht{twT?H=YB
zo1<(4{c9!5H}={aJqL4YGDh75v_zIg>rZyf3feZ@Iglg&7!MlHvB_7qtX@*{)t~1@
zdW(r~hy`;Lwp(~)TrTwCV?I1vxmiJLhM30pRKI+s+XhE|x|pc^f=kCt*4Os+`sE`7
zRy9X!Bx~m5bnGdL^Ya8MlA8NHto2jpL-w`=JSg!#!7kAaI(4dgyh?&^!Lql|A!Tdz
ze5_SoyUr=jp%D@$cQ;&0w+3vyFjfQ}9!Y_EFew<Fx+CVSg}*hJt}t*5wwhO}KSrm`
z5gb6aB8mzx&VNt^Y4NyJQ`NI*6ps7k^1Z=xDUfo$l(6IObxi*RTn<IHbb6J^xa^bJ
zlj8c*xE$>Pj(z>kc@{6nEd0LEET5*zOlVZ4z^P<P+kjR_d6R8|xXP(7Utr7IhFNb`
z735g9zr(I5P%pS@f=1r%;25y)akz2M-4~e?fh-XfcfrAZ7cMKPrp=k7Evt>(KBTG%
z*hesZPSA{^KX_=&i%2hC3qO~wSqF22AbbCyv~7AM-ZPL(p_7Y1{65<G4}=!t<7a~<
zQPhMQ+Yawj6LUX^_7F{u<*j1Ev@?b1J#}*&ocX{<Ly1OBD}flx9PucSsVxRnO)2!;
z=8)ZL57cyVW+XOizc^65%VF3Vt+;({*yM?%%Cu;GUmLY+W4ON+^O?ArKjzlfz++<6
zdP#z6hx@JQcWG!?55%#zaJu7;4nLoYClBmzW*VPa_NyKa4A$I^7AteFO+=e_UQP<2
zZr8>F>@XicKx;gtrm&qZRi`^UN0E=xKCHZ7b&d#eT~ycZ&YLcbtO#^)f_)*t(%0h6
zn(wS@i+Da@q!_<xxj0&HHg!nPyEt7V8`b!H2pK<KFcmOb-+3ehM7tF<!eha81FsVW
zjv*VcX5(o2W9`j02%UP@q{yN6Zlf8!>aoz(bMdCvK&<UK+eP4kWQDMNnP$VCb>zuw
zIbsqYVl~vBlb8!GKk30<C;TaySeOq~IIuARvU?o454qwes5UsqA>^5=Hkx~M;8}7i
z(gWiWR=-m%d3-~BubRQ89EA1a&|g{1>KA5`T`vOHTUu56-9cMeZ5x;6yGsTlecf@j
z{1T}N@mIP`_{>&W*m^H=-{q^^?talZonSGxFtld3+Oq>}vY8Ms?M1wsdUiMxF#0}>
z#|zF~=^O6VwNOH1TPHiL=18jA_RHkLW6Zf4r-7Y$MHkp6;DYL%{#%78hyB&{%$LyU
zc58}R?Ea4F@}qQaelHyUr&Bs@I_83A3Cpg#Rss|hS)es`)h)Zv!RHSkRbE?V^dWI9
zIYkYAx6cD4TaKa8sEK9bv!$=iVL_Evhb0v%6IL=uy=zVbbWmm^Cla_}AFDW&PeNFa
zI%B3~`pfN*@3m(;RZL5q3ZAVMNRuR;QT*Ms3wYDWUjM`E^FDq1xs1dW;NDW7^o+*M
zQ5uRLlk#&We97vjtN;Oy4-XU*CKeW(WGUHTDPQ}}!~tQJbPL8b)T`<~!(@cHtz@WY
zK>@T-dup%E2;vNraNgX7EqH!aT~)&~<Uxj?-mxi575yx)Mg~cYoE$-eWl_zVYat8(
z=Yq~j?>dZUj(Ydc*r6|KQdLV@J{l-H%}Sk@;LEGRVX&{)am?X?D5-!h%*VC<!NBvg
z=I+~D$G#4SQ3>NBd}V(YMVkmVMK!TkvtPn&0^;0(+WxdNhec$7Hx*jKWbdwj#nTvm
zR9u`jcROwCJDV0QmH@-cA+-`)h^cpGLH6&(Y4fHtaW~AhaNGivHq_RhF<0H@P<?)+
zlZ}Fg&|_$Nmzc<StkTz3hO;$C2SDz%C1{h<t{6<Hk&zm|lt{leM^k#hH!#1>_x}*%
zskf=08CjWYsFdNmRl#ei;W7w|#-SD3&^QZFs(YcWA=%sS2S84mOfPM4apg$}0nZ}l
ztR|CV58u@F3o}*bD{MR$42fTK7(K<iqY}&FND*5}6v0TS0e97n`r8K0`>KpCbSa)l
zOFqZ8qGON=t)IP*UG7U&tLV$5I4(DH{uz>Jpk)<geEu<b;fuo;qTWFioS$|e@W%7^
zW|_g4gc5Dq6WjeST2W!q5vfZR(W9^IC$G{pi0N)POdhoX(i!O@<-)C!wCQnXZE*uG
z&T-@VOhv7(0rL}<*gLt;C^IWr5u{wQ1_jUHi<{TRs-06xlM_mlm>or>C#DZwt4${R
z&)g)Sc$1<A$sXrj@X#?hQIqiGJ_7~Q#eGl2{RVkN$GH2g(#@()FkIfrM2l4@Xu&jD
zy<mxcwNvy`v6m?j(RtT%&WyD#A6NC=apzienvuGE(_B%54iEY9?cEQ9$^|O|+-PeT
zb55z{>BbxOor^jqb~ygHdC2?+gDqyui{^o`qu(AOk3{-n2d{cBEn-sr%6k|6Q2%H4
zd>!P;fjtk(G<D%#KGG`%pW?`C_fUb>b`^SEqw|?y6H=d-Ib-A&T@^QvV~S~;ro-or
z`?;ZN0!fJHwsNumVB)1Cbc%qwzBok=^xap<_Vks>yBn2AWg^Aje2R}DvAX`zG~(G|
z*Iv}tL@y+w+lPK4bEPwN6XuSv^6}NtXGB)Y^uQCKg>~5Di{#f~EG9C?ZbQj5_)v4j
zS-W5GG3ElbUgHuMXuT!Y`&8B>Wy=1I^Q{{^E#DoeC^bi@p3)05fisknM+-8GZnL}4
zbAn7=L!u($QSOx@RA)Ll`xK3`s)%PGoVwVPar+S{qD7y#Hs!tQ8dY$ryH$HTOZBBE
zIU$!3Rl9JHHD1oy-Jkfs9)F<s8qXn9<_wsWwphbpq6Cj*goAeKJE77?ovXMSV8+HY
zts3X2RpZuiNvE9(YZzerom=sCIX<27wm5~)9COo_yRJQ=9J3dHo4k6>=^u8;)lTB-
zU4!*JTdwle0?4Mm8En(m<u27?se40DpWu>Jfa46jdLqu{pH{x)(P~$_Vlgn+JBZS`
z{#kYC7)oAOV<%eipycqhXP&vgv9~kE4frzV<$S0?vc{z7>~ah<V0eLZ5%nQE1Y%G{
z>Q)Or^L18R8z09oDf%LMD(cse(>&@#6+P|jLHA2GWZO($(Zy$3mCw5^uAH;2&9Rhv
zvbuD}PlbM_E3@>1*Nl4`TG#1YGJrO^&zBzciEh2=9!)c5A<h+3A3&tDqc5+lW^Qs@
zA`vz{N>6ZsYX@87C!{w#oR=H0X_RVFzt6V3hyJD-rA+Kr{G>K>KK1P9U|x)NSq$Q=
z?6Luki0iK7NK~81qcmffpZse1CUDF<j%+vpz8Ie|e=L!?Ay>w5W{0_*KDw8-8b{(^
zd0U(~!_FqrHBMlhi!GbzUQD88faPK!A?a(s^IfO^xf4HAp;6XSrRWvLR?@aI6j=N^
zM$WS!I}4vk^$ibf>QvH%R>-YmW1u`uZ!N};>hKvFlf!S3Tc4a(2ys#C`EoD}zO&Pf
zp}%u4x3)r1*mCO*#%Kfwht;Ug;<3oY7_J_0<ySThzo-C&&SlXsnaWK2Y-+M=2?C%D
zJ$D?$q{IOk&_;5ob3NvR*gsCCMLuF?pT?tou|j$?f??6sLKY)iiW*+@6YS7-M67PW
zh;`RKC1Y6G044)Jtk3oMoFRY}OloGf(S}p#A!oBkwORHAd{V?B5W3DL3z91|5AWyo
zQ|n!hjOH2P)kJbfwJ5LU7S!(CSR?j;MF}oZWy>oA6U$J!mGO?WM!tCYW0M1~f<Le+
zi$PNn@P*;<R+7slB9~^Y2i}lPv1m``b@yzT3$?Rr2|Tc%SJ%U*m>zv(Am?+;o-ShD
z`DRhaEzD;5<Y7aus(P_HfCkrk&?<!<nD@Ze&{V{JCD8{Ba?a)Mb|6g6NVjm>#y_Ax
zLsu;bEzpi33FB_k$({n`R1qy^ap@e`D|7^sIMItO3xk%-W%i$bF;4AXEa|&bHD)^Y
z2}MP`dt%<J*l^5<zQ->oac$W_>z8P+9!`sV@U(v4O_5-9<QeF{-K3H@<eFHFz7OU<
zO(#s^&vmw$eFutf>$00Luj7h3amy$hMTnKXe0~uw4ZnA9fu@a^!adhfV$`0>v&y5S
zFnX!v422mpvlz{Ye~l13Y7>@+@2q(x39@R8P^X3Z6ab(qe_5Cz^ck&ng0(M%a>6*v
zR>>1qOO;bKf2}cx)$}|$ls!$@c26x@RSUc=hC1M#aeu4yldHjboW2aK-8^uesF1kg
zrQNENS#9J&yLu6fo@l9dtj{s8I6^lUH7IIyO7nO^U{z_pS+MxbmV0#K_EK`SV$RX~
z$Zs0(D@6MkS8A8#JUsRXpngD){7J^R)M2%D*5LDtCI2a_C(i>$SJ}qa)xpn;Hnm?g
zAi}49FFrXSU`IaJl=!JME^4UZVkyWauMGF;D%{;rHNi&uOvg}Kr5kFDfiPTyuzq|Q
zHMHXXMr34$_<bepOjDL)d?`owV4dqKdlqAf=ju%w-brEE0vzbaFpT{AY>X#Rq3iyc
zB{|^1E765O^8-=frRO#ewT|COaG)bGB+Uzri3+MV5kt3C*N8{C3bD|1YvEZr!)hnO
z5%x7~E<-trAPz^TS1pN#NN3<CU@baBx%r!`Fp_d~8zozzL_PDg6Wjaeg&{`avRe{j
zR&J;(NJ``jcsyRL-tg!LkwMRMfma1P9HK;1_Bm4YPxC&mgsM><=XjST7Ff#NCM5xz
zYmhMbIiA8j{baZ<4zI;lPB^V#ZIHl0hZ$IBu3S*2=`Yz82$jm7T+*F)RcSJkRZ4O;
zCC6#C#4Zx|iG8*tFo&t-tD(pJ?n>zG%v^EM$n1XHBGTDaM?{2U@eUWZ+FosmUcLLq
zzGt_y5ebMG7f^aa+Ps20%7=MKNU#nH6~MQq_}x)le>?AE^w>Vehh6;<4lbXEkuGG7
zt*XwGyzNB=ksZtV$Z~J`j@$z$AeS)~W$ASuQFPMv)lPuuDDPTPamQ-K)d?c~6SUP$
z8Vs3rGCbIje6+LsD{Pj7cDat94qdf268H)PB<AQl6jAHa>_tQ@gHl|}F|a!vLRZTl
z^=_t^{xSV*U}jhYP8SPbTLd^`BU#PDRyfWOXUp>c*iMU1T#Zm<Eh8ARmD^dVyE~Bc
zlc}Q+PN7jMo{ox+SHnFMPut)mR*3Cxy3jeI?B9azwf@Y*6F;;Zj7d&>yoBM^TwV_%
z;$j&*E~a`3RzVl2x{Mv`l!xYHb8OlZLVGj98KOdzW?nx1!bBWE$Wbf$4I3x?3cZ@y
z1IZefXNH1BCxq#R3pIU=-Jh=&yehZ0QK|Og?d7-m=E@vYLR(4JBU2i3<<e!f@lngv
z=n<Cb<-m(D5`UCu$jqgr#sG=qz?Z`VM3??J)!k~TG}LNY;*G9*uIZS`BU}J#V0l)n
zgpu&3z~=Ho4<&%`#~@LW;<en+jhdS4=!{W=w`774?n&@cMyo7bP$e@ZQIVPhw%Uln
zS(ZTClVi3!xrIey_6TFbJ<Y)U%!M3xv0HFbRe$xQ_Acd{FDJcM6U`#v>5J9k{-sJp
z5p46y4ru|+W%;={^)ka+sokWFiX1H!l^n&LfkI_mt`f?U4PFKn*jP(}^~&errN%dM
z^vn8MG)X+&2K)Y2w$*iv<E1_h%Da(6dd&VKEgvpk2GGg*PCBbvGUN4#HwmdtVybk+
zV(3;#I;sV~TjZ=Qtvb^<F~+OQnMfN~gx>z_L)uzNZFQx2zBCT_HP8W!0poq@z2zrt
zxhmrk!W_}%x?y!szr(l>#eeqFnT35j3F3TCMRMs4nR42Vz!&Dl2Z?g-0CB(QYi45B
z#-gL?TAmuhTQypI7v;{5C)sPHqS*L(RLv)}KRv}<yO5kz&xc^Ph$jQVKuFGF_ADXp
znn7o0nIiE%Yg|)5XRl7*O#Z6!a0P$hPf{fJ8%r}736BU>F4<Zz|1@_^(vXqmyPhLQ
z^);@5_!r^I^ZHdU)z><_?KJDohaI*eB4y#e?E-MlG&azXbnt}({yx-TA+xrd+EcVg
zpq5{&o&>e*?sZ=C^|ztGO#D9Oa$=5uO`4FT&+E&Mg@%stbkCS}7zw<*){6RIa5m#O
z);%7&^ewL&>PFUJ;{KO`!^&1`fXKn8?x|L8Nj~#DCoTCQ+ML+tJt1kZDNMjl!@;0S
zi@m<p@WZJ4+WRwv<~}SYfTU+ZCy%77m;7pK+wmGwxNpPrrB0%J!sg=0%R8@o(z&V3
ztm{v0?ahNX&Rw(_VZ!EtnqW(v^S1$(!`GWfH956gdC8n{+zU!k@VfFon_{?ttmPU{
zrp^srwbCA1&<&AgG1F>YM*HKp7?D?d=|`qBbJtT#TWalUR*{VR_~P`sy6N?>&ftvt
zDdr+kgk^A^aSyFy6)wKw`Ro}@=w77a(QHiSi!kV{;@F>HtThYPz0F16Vwv$+Xe9xh
zU2CsRh0joZcNcWGw3f9lxgK<qs+R7nF8av*1@+y`wPvj_XUVsv6q?Su*oN!lr=^RD
zqCAWQLDQ6aE8Jf9MhvETDD>$B^_HnK=UqeB*?EFZo=-Jk!2U+oiJqfwg1a_Q?D>zR
z8Z-ELAM$N>t^g|->i3Sk-z3aJtn2At|FIW<Jp02Tzr%dc+{C){&W43VFHx|X`VA)v
z$?IH{!{`b9{S5}#Gt(I%pHE_4ndHQvgD5K1gfo?cP9k|{!0dot%Ps5ZcX1AxlSwr(
zPSxm3xYElH^U8J0@BO`g+AWKuPw~^_#I>K}+Uex|QjF-iF!uNWGtg;P;iBCztaFBB
zoy6Ot_6?(YzW6Eci>`_WuVh#sQ$n*JVC@W_qwl-PRoLkMAyA4LTx|nxWXSN<Ps|K;
zp)pv^UU9MSnYH6lG-EC2^f7u1jZ7$57uImiJH|rGQSnhO!zOV_zA|eVqeNAZ$P<lh
zgHF7&`lL9rI3a(OzA=K)TjzA7m`Lr)xlLmXPEHv#o58h3xEV6^BPKuLyj;iGSA8X6
z2Xp4e9;Byz;|4m>nQ4<>C}bB?F~g@(OUE)w`R+y*({r9{Y9KO(Teg-Nt~P5E`x?`V
z?_kI}J8eJs(RZCfkcJxs;G9yKOAz`|U0>F@$XEHrIk`bUu}Mp1N#5}~!#D`6yNvo-
zRC_{cC&PyI!LW4g<pQL8C(hXR%5X{Ny)b_#d)f)X)w7zTRQ7{TJTEd$Ny>cC3pV`g
zeh`I1g0j_`Mv(8M*#6WdLCe&WU5+f?)eHwbnO`oN^=4N_y6p_tRYVD|khALC$3Axf
zmo^Ds%ImVYCR(}u;+7;@K$MM|;iOgP`!h<+(HnCZPw|z<1uxqQbsAmmf;yC+AjWqG
zho!CkLy4xc`{#a(S6ke1<FF`=gtT*4f`vDtL5}C3jN{<>C#IpfpR#DrE6ijs%~V6E
zG#nDZ$Ae1420*zXe(+Q(d1o}|E;lH4CW2wAP6#m8UOqKbl+k(Bgh(p@NtI2zKC0)m
z+7Kh)xzQ$Q-u*!EaAflu_>x}OER?ZfxhL+|e2la;4;jjizi!Bm3pe}cFt)7O8!WM?
zQg}55t?v0_Y}!r<(Q&RcfDnt1Y^o>?)Eh|RQi2d#GR*G_9d6-+RHlXy$jz&}Da^+)
zmB4izh5(}ZptsetDV1w@X;jwiwLShe&WyjC%|BzLe_aJ}(Z9nCus%;;&QJK{^n2cW
z87D!GPYC=Pu^=SGLSUX<kVk^cO_zU(o<*{^^@HM{V^q5&QLXxD`}B^>V|jqe^m)BA
zb&gVE&HH6NaYzzN-0yk4ko=5)`%Q>-V3R}6N{%4J;;?wQIf<;ZFZ{T*(t2+%y=3?P
zh+ErV7CkFPX#w&fjXGYryk%-YhNN2Rj^uB(V1){<j@mGriozyrV(LXU#4Iy_wymul
zkgbo+HKbJ`%dr=JkN*DEvVRmlQ@?%}gXX5MURp&ZC{%TroI%T_7{#kn{%I`s_i2NF
za{a%rS-kM_QS>Oq!>k|P%14Fu520iEe<Q)gN(}ZV|EK@;KdwRYZ!pQpE<3-g8_Rw5
zF<M~dQ?bh>aV^$1%b@yQWPeI&l%Ojrq~%1)$)=wnEWnLUq@aB#D#Sv|h=CySAB_BW
zrv6q&&4#81i0%68R}N;pf*GhXbt~S41dGazle}`jPb8E4DY4$?BoLnP7P5>5kqZj3
zd|;AN#tiW>Qr4!#j`>UGkO=?AlW~MDgLpm&e~rg3l?S4IHjC`?Tr>Wgx_{FE$fGSG
z2v1z)jWf_BAcfC535C>{Faw1R()8qi%^bhqc#@41&_fG`@OLO<uPBBLW<Y66@`6|5
zAG1IIEx<o+4*EiPa-KEFOBMqu1hvpBC{VwPQ2-^Y1OA#h@Dvc92s0sus$4_kMYzEW
zY&|Mo<FfX>llggwHxqrftb}z>;A;2R?IoAbfCwjn3b;+E0B!Al$JWxk|MH<&nqGPn
zqoLA6s|ED%y`PC%3h<W_7JP#y31OF?&U@^V!?*6$WQ6Tt1A_(AVFJ2O-Zn%p2#R=Y
zrQ<vOvA>TY|EaVgH@(jxa<1atV>t;TI~~N){k6JRO;)Z=FK>kI;@K~_3^MNPrzep5
zXKK}d3hv*VsUQp?CQh3gyZR8`y~T--=s}Nv_VBUtki}RQE2Kj-IQ;C(TE=chjCS^D
zDAgYeWdFT}e=k%0CZJfM^uE8gtKU`FTgeady3(fb#izfP`|tYj(+FZ!t}KNYN&o)M
z|5>&T`R(-(?JpUWf2ogupiCMfL>uK`9f|%LP5w|uS+w6?k46}o`g@Iyg_z6cK-Q??
zpM&=wRQwJo9W)TZY|_|eyQcil2L8KLZCM~5l+mNb4pHdcCrAWonighv`uF$*LFA~f
z3;+Y`Si^bMuRaQUSf`&{CI8k}1>gL?mN?`~8D|CgeG%KlLe~QA0;00%1%Hi+|7xcE
zDzv3gmB~m--#Y|^O0SpabAHMTs{dsm|9PKN6w(LqiZXtZ`<v2*g#-h<BJ|{5kR#>>
z8en<<o(?IizabJ*Y_#MPOf18?Hn`~iUr_cR_kVuIu!SCAB@fuFfT+|Z%+Is`c>IUP
z{rAnR4;ZKKVg`lJJDx+_+ju$t5(EFm4sQ%V2L&JlRQml??OhBNDnH8q4I}=k3Rvl1
z<)W0aW8i4-xh@|6o0k7Uqb#bo9S*tI-Bu!G6)!L1A9g6{iczRsgdRb}r@0!a|NMXI
z8dcP*_A6NuOQMk9I<Iejf>--9Lp8ZujDQ3)vt-;q>iI9D`LDl%%4m>|MkO)S|My{*
zfAQc?3*NgQAiYFWIgXUn{{_MSNw0z^1Ui+0jM#r9E&Mf4zJ)@-ZnsH?p5bp%{}~I?
z8!I?As;mDku?8_h&?x7?t+M9-WagjTK~?$9&zRXV(EnS=OVR|fp0M(Rp2@!jUjJWb
zd?v{q9Wuc@u?kg3=ih4ZtGAySUni1iT&U~olfn%2x2n?rJstf_2!WZ>$Hm4zT87~t
z-nh65&gk?X|CWM82^vA%eTiW!JH(}T@*ipWSfmCOqyNhU{>NX)XCcbvJfN=k_mqq1
zO&y7AFL5dnkESj3!pkGSo8(x`-{s7w-<qhw`b%B^m%`y%yTCVu;m*HHCklkl3Hvfh
z;AD<?q`}Sc3TCR5OcYOy;2mnAN(uJ<Tt#G3QqnosD|<fUx8GMIOQm#EOrPc}4Wk{=
z`xH{9WO<G_ueZzp!~*`&t6+J5B?C|f`RBr`)j-0u#2K!@!$V6WBcm+YbnZg!MiyCt
zCkIoq9f)Pi;(6<OJz?G5-OV>UGvTpY2Ko8<#j0WxH5j1jwGuC0g@uPBG5iAMD|Q+{
zl)&@xOnkabtA5@Tn5SZJp1}t`y%-a~e<0lXC3k;p-XRJ(;w#*~0s?~6vKg0Bop1g;
zkm!&g)kBDx#PyVR^ihc7rJ2jtMs~YB)wf)#LkbQKmM5$z#)u;H-ttLFj)AO9iaX7E
ze)sNOR7OSwHiPDSU)avkAfBkNp|1`+aKhkIRmNO(babM}nu<}7iFm)jCnDi}5)8*<
zlh2ckhvx}B4b3?oNJ}F)T&zXdNwY^D<=jB56YcEl=lgSHBia8gbhwvNzkFLbI(B>O
z(uF6YK}~%Cco!pjv5t+-84VqGn^j64zoo3Inm{T`D<vUIZp#a;eiA4vhXgAh>jo>=
zeL1Zpmn{;A-0;%}0kP!E4YP_zR`=jZ`^zdSJ)IBg9=`xvh2H>!Rvifq%>WVkmRy(d
z|Ik_Q5Ge>C_q5i{f7gdfVYf0@2hwnuVUp9G_G}l4624{t&<;6Je11IbLiw^#Wjvh@
zhd`k58!?`IcJ}t+-BgfZ^5L+0qSj*Wt0@pkRvz1LrdWklyEM=fdm>)3u~2n69)=p&
zFFsdmX!hr@`O^i$5ndf1w3e49$AhS}G(-w9S_BDAak0}Lg9%xQH<EG620`c)@lkOx
zkd-5LKP3_gU(Y^dS3hng>W2MBf%3_^=hHn5??ExL{H*VwqrGTN#I%~ImPGM|vK5Bx
z|5D@vWQd_)-D;LZm~G+7_CO9@6^3aW=dCTI%%abUAmH-3I+%kC!c_1upnsGg?Qj!t
zIHVGZQqIHwsP}b8Lk$Wej-=6Sic;HQLNq&5FfRY`ddUW~>bisLLk=e?x+iK>`R5JJ
z!u%~HdZSr$_>DWCspV9-*E}Qvq1P@W20HG2HuS(r+rucCVp_~cm&rbvuUDSC@MIEE
z%8nh|BdKz@5J#y%)i;kC5a8L)Lh<LI_nGH61n`6jr4iuC5B2Vn`E8j9r0eSUFC^)K
z*xkK<E@Vujq)NJoo}31dK%ubxKfIZV-=b9q?E=O47{aN%&favu&)?!uS7DIat#9Qj
z$`iU$6k@uHMt&}dM#86Loc}@2?|{_FNW+ugCDuy_sRaX4OJ}s&E>snymUG4bpVs1y
zK?2w&y9!2gal)4uU}XF%eYJlz(V~QNc`)(ziVn^)Vizk}N=Nu55L@qX_-2BYdAM_D
zhpgSs*soDdop+v@5Sx*b(mPg|1XIZFsx<KIRI5axeFG}#QLiBDs@F||b-mG{C^Fwq
zmzZ!Yd8go4@Uw3;{}-10)#Ys$J8u1l{5;t%vd9+1|A)P=3X5xN+DvdK1Pe~k;0YR>
zK!C;x?gV#t4+II`H0}^ASYyE&OM<&=(-7R<t(iW*&7AL??>TcfH*?buP4B(e+Es5=
zy{l@8569Dk9@CRL(a+qXCaA2P$Oz?9F`@R4=_XsqBN7~Pi9UZHeI(AGy?q(7j@~J3
z_A4BeciuhJjZbG_SXF2+=yo@QA8wYGHTO+`bR~R~@7G%mF|j7yH2Xcet^4=Q**pj^
zG%+a3BQZxx^oN+oO_9P1+h1e9bwBlAoG)&u`mUUDyhm@WwZggS)O|eCS^d(6h(xL7
z>B>~-3U!&{gjMB_qP9b?T6tfI0T|cm;6YN;oZ!q|_v(qgNHR+QJz`U=7gjV8<a`5e
zuaeMR#!#_9?`oX?jmc<uBQd`R8qkKUza?OhRSu;23@R`9u}@6c)bSA-h3`B|??jg8
zCvqW1eW)RBn^zLxOoOJPqs#hk!W<MMK&m2r=DJJ4J{Y&N_?<5;Gb74@tl2fdG+_>c
z4DmdO37_^)WfMRiR1@!6<s*ChRV^p`3t04S71V`dENN9kYevu`k`e_rqn2uX9~3U(
z*n?IWc>iWbr&mn4h7WSN9kuC!#Nn82fV{=c&)(Tf!zCjF{=m)9a1hll$`#yU?$-z>
zr77Wjx1iz*u9;pp2x8t^c#7L8Oera3bcx2U!!ECGU(xtOHZD(Z;%H2;InFBpSOkn)
zTdJbPO{94dFD2UZ(Y^8gRf_4RTaAeetC&#(8kVvB{=7A;p4rz(?H9aR|IJNJDp0Eg
zotgrM8>~GW)HfDywnQ4e(S9w*9U10ge0~tQ3CG?Qe;>+`$`06+n$5Qyhsw2`R8%cF
zPh{b|I~5~f&}I_<)UAFe-CAT4xPZPb;*Df`;f-}9PPw?i`^zz*I!Zm|BJcw`-a!B`
z)&iSkjoF94tsY818L1>0@7Rw~C(lv#w#dkM1-1V^;QG9c^kg(>L^dTt&EXt!7vJP}
zJpHyjYk?-G^M>RV;P#Vq!rv$H5J?DT4It&krfCfW&i=!KkODhyF7#7jg8J)&O>Beh
zvxM~Y$gB!ubMqj|GVQA1+sF%Kq1LlH?u7K@um?K#nKC1a`n_3MRpd|il!ZklW{+GT
z{R=(o36VGM<!Sfqg${$f@h@+fXR2bqqtXH5u;~B;F5EnI!1^HZ!m)3L1!B9iUi;yv
zZWG7$jX%?(^}KC2*}s<_)aksc$-3$5ud%1Hox=E?|1?Fj*L@-6#QXPfy^#K_6MMM$
znGnRLh|>@Eu;oE+-?eD0t}<NZN19`#@AyS#G-`oUcjk^nysU9AN54@&tJ%Ey;^X3T
zZC|TP8M)=z)TQ~|Z0K>1wFtb1lHsFm80KUz?f5R4G5t;sP6im0Iv{{fQiM`c)aWpr
zrRm~i>XRB7n~-Rfpcf<hvSlUi#oI&0hLHdqv*o2P8KTtPN%~Qv%ZpqTJclh*G-w^w
z-T{gqB+Z_Zi14F0IVKs{UjE!ucVvAB#Cdo-PqFmlAU<ecjKfY$t0KjiIJIc$?iJwI
z7hU3ZT9ylgc&qB)E0<t53{Jr2`WGAmZNptDr#3r11w@r29o$ejD7!F&t0r3pvwbPI
z3oujB&emwt3gC5_?KFL9g9Tc>b+=X7SAj+;(tp<bw)}p#JumqUFfl#+eCR<2W>hXm
z$S~u%3y|1-TYB~KqItov2$rJzsgQp-x~eV~B48ND<>7C@F?C5}Y+zARnfB=?en8B6
zLgL9#9)pPv{q^0~Chk6$+CnTawd!M;Yx!05)F4)tJafqh{SgjvHe8B{jcnSZTD=+J
z_aq|fkw@J9qZPN=c3b@tBm-qjS6k(&Qh_w<jz7NW)AWw|%8nw=ffciQk9iSn72*2F
z^l|eMuj@VHM$-f(uwaG&dV?d(w(2Rwq^Fj7{Fis1Vfmm>N{G22vgPI96B$JMn@$pF
z@Gvplv{&iye87$==OEoWZ$S6)spE?`Ps{FRggt&HNvr%uDmW67T~%KSlNBSu=2_;I
zuXy8Ry{4mY2~G=xUx{xiB!|{GDa(vLU#tWhAEU^`oJG>~i@yF2=Wo53=Z_Ctzr|;W
zgNBa!_a=06n$>Ja=Jd%E6PzU^w;%McLOjY=Abd%#n@-tbBb`&t3?>7sHcfe7M!L9n
z(nfS*G7p3Lt3B-}E|eF&0_?u*&=iZ@Q1V9=QJM;`bd!0#n?K<Qw5K&vTO}On{f6oF
z)#Dcdd*&Mg_0(64<;57j>g?~hNXhgkf!W!?%}y%adJ5ZE&ls>9OwWNes@$ggHvz}n
zUvj<?wvb{MD|SWL6=k+q;uADGvNWsfv%f}P64xZg*}8fWCcHrzSIE)X)muWoYBLO`
z8;S+UfWH_t>d|RKO@g|=jL7vV>4#a-1ogi{9_b)-qu#S$SKse=7GH8YCuGLk6POmK
zB>*RzW!B_*yVq()_<UUC2a2Xs^78Ar#OxYkviW%(zAFcR`=?HbP*V3214I_xy9Q64
z8F*?oZZ=iW)b2r5$dMV`Tatm`Pz2$!C?9NjNK}#@w9-)>|G1+Y8<bDOjJ$@vgkONb
zaZ?@FE~Q*&Ok{j#>$GGmm%%HQP5ZZqMIPufCf%W1F>?_G#b3&;>*$hJ(Xl}3rT7Jp
z^tt&dIOjUQskdLgp*h+UdBJ8E89j|EK+DOY$&N;opc5tahRA7!!|Ot$96iUk3D>A4
zD2vQ#9Bo=^w<1Ex3$fTP$)Vo%sV!x=-|p!TbCK~;VtsCL!a8coxGgPT!WqOl0Ykn`
z<uBjv3UT_ZFTZ|u#v#J3J$+JN*siZ?9+28#N{+VtSbI0t<KL1n`kO|ek<^5b5Z`!#
z2EHKpDLz?h+#)Sz{?}0*?L`%JA-5WMc$l>7<wg65x48vJ3^|l=G?qv7=^Sd(Tyivn
zXAw(h_$4P)XwQ<Ym7cxAZY#yvquoO7Xm9Ag!=x1-t6}5^u!e@NVLJAD?}F~W>?$nB
zln}Vsnr|dzgV^5%xELV-K8z!+BU-?I9oUoD1d&FLb`$dqXnYaW?tz12b2@RNbNOpp
z8qc0JK3eKOszLvzX!OPZkFcS^sqdr=W;EQ|)KIOafu<;T8m?`Uv%xRnrtXzhLnbq3
z-i-v$xT*lQv!tJW<*httY+KJ44W#m>Qj#EN+8!ELF9azM7%LVg<_T%Z^A+QSr?M{U
z#vHobdftGff#g%|Xj-j&c*Sw)p;ntJJePdWui+M)K1dJU88S+8hJ~H&X3x2`hk6ES
z$|uqjJrlOYlv~;h#?)6^Eh>#ZZEa?V-j^jp>}Jrt<*?G=^HwtGK`or3g;EeqM+!e4
zTPN(wEJ(rqdkhf8Qj-chw)7i&Zk$QxOCl(>-GEUzL8CbH3>WTuYk!jd8vT>BFA?(b
ztuDXZ&!?Fp`bcVyJPYAC->EKeWW0dN)-_pVuTps6EE2#W;^;yB<ZcUn5gsev{X@I?
zN3r>!R54G?9%majnoeX>f^G4LMLyH)Yx6Rq&LMHLQw&ADQyx<&oQy}tc$J9DEEprh
zX~0z}#@7W)Xv&2jH52>78@HR^K0)W1GE9dsh`6S~19NLdTx+|xzdI?oQ8K&K4+{}3
zqE!9ggSx-kO7b-?nQpw*tDux7c641sQQXh8wyH6STBIm#37th89`e)3X=vXtJo7Mc
zWSsUs#2id1yEsv{#?a^Ttj7gwV$-w_*=bO0%j{QHFYuLH55v_UMzirc*6IkURh}E>
ztlW`jZBQoxL+^+|%sMVUdCI)0dQAGDG!d^dttwD4@kQfj#vX^$Zvt;F!Z$~3cGKch
zqBV6m5g7<-`rfYru@~N+A-c;Mdx@{z_f;8)D|+Z_jg;g-N4&{Z3P9c&FEW-3^MF#Q
z^dc{tnfnb?QDmI&1OL{?l&(&Vj10uifpJu!3(qHA77=PE{>JCdO|m$TwoqACGjXfU
zR?5Ysf=O-l*6M=Sy=Cw@y+w83+`EH>jk1!&E^^m}JiRpjLq7XKxn3)_Sfo7Jcuwny
z6aK|TmhpgBX6=34iiZ&{Fb2!wJ*on)OUOywXXZfHO3xP_xfsB7g$;itU5#F3+zUg`
zTGW2vGWsdNiX9Y;qdxm}(%87ya7D|J+*<HaOXHpEawAvX9nBJv@9@ceYvYM<r8LBQ
zvm_uC51BfZul}TpOT1f}+C!M;ZbEUCa6nl4;5HIq|6A_&0L#5D7HEZMjr#B7n<@cD
zmg>7&osaa(U8kAD%4hc%lVd)i?wrhWinTV%irgGsJ9wV3oAT7*`?_PbQ6q1K7$?Qx
zGg80i-em?E3vCC!bgr3XdYnCZ7$&t&yJ9N?3Eu#?2!^bFY%kuMZLha0-Ze44pEet^
zK4T;LW`E;BZ9hG2hHHF8xutM=XDS@ElPkF?!<4MqfSo=zNx4~py+r3l<uZ`vx$=dn
z;fs{8qM>jBnJ=_AJPYs}&6swEpRY=9RIp=<Y17XW8J|z@M`@SD9CukL>eGhgT_3ok
zRJUCpedX(mi<ZhlA=ST}P|#sp(8!}L4eQlH@I@C)ke>JRceW4=H5afc>W~npNelc!
zGsgNrEP_{r|M)4vhiSo>-i$lP?g+Z9OM>W*Oc9bGx@{Okh*33n%B?rusup3mK%`DN
z%DA>{zTTxupC%G)-b1x=&P@#+_o8*mrR%xdJYC@imebRmntjHa*P^Qs>JhoOT3=J7
z%Q1$FlWp^?^?(f$q3?Fi@tk`zVg=rZ!mqb7n%ou*b@(skDlRZVx9yS@Iy@uK*tDVK
z4eM+7=9oi#EpW}Q!x`lj!>^V<+ScWXZR!x~2#TS5#>e=jYn$>^sSHR<yadM~x&X8)
z8cnqWQ_WrN$eV4%@;|NAk&ifJ-%r|c7OKlehBU|uPrfvXOiPxKyk*?uG+XW>6dm?8
za9M)<Ho>7N>1w3*Htw2in&!%%HB>8@*^N%ees7==X+A*8HVii{VyS0l;>rj&Cu_=I
z6)7uC(MeSy#O_>>)(IK3CRQY*R=dE8w+f9|8{l{ARxl;2vUTQJ=9gDbxVxPAxdvpv
zIM>h?t&H2qSqv#G!O1Yj2w4wVvAj1A4wF`Qs;+pcNucPptT%-lSefM&LS2!V%i?I<
zJ<PGXTQH1zYq-hjaRafR9(9mALe|`>NVxiuSQ_EH#Z&dwfsgDH?N6(6#;n*-5Szde
zX7ZZaw~+Py`8vc*S@PC<*F01(tC8DDn2_r_V9|H4vODFnv?PbS0UvSR6blQBr=B4?
z;#gQRQbYHIwsv=(o9pu&yccx_0~fusCzr9LBne7*VgaW|Y0Z4-pJ_5f%L#|k*@IGb
zR4(B>=3YncJFql?9TMJGr-J89T#krM-Cf+9V*h@O#L5{=$Of2^mjvm&SxD>(Slm24
z5;!lta<O9GG1ojH=W$bQ_WasKlh}<&eU8faM$M0!{xaxYmDPVzdcS~66`k4g{T-+a
zN8M%Y^o&jaO>5UeZC!1HeMCPGO(^#d-jcWLB`U<EL2gA=dP319g4x|dsHfQhR-Az|
z?kd(!LkY^qjxx+mB;=YguUYtQnak#qSVz{l`sA0x=SP?DSsDiG%Ns1^Nk~K0l}Him
zrNa!BTNIblYo9T6Td}}fSdl#zJSDzzn@=V>@L6MlBFT81%bT{&^k0^(FL>mp&8=KS
z1|S<$6c1Bzki_f+hcH}5ee`NXY^EZoE#j+<PaqWZYtf21%1-$Mx_%_~^qXvt$f)b#
z<m(7J-b1yN%;#<sZqJ+3*q}=(4goz%Xhx7h0O@v!I~NmPD@FM_1|zm%KDEmG(ePEF
z$?9_)cHcy0uhp6sA@pijwQ!fL%|mQv!7pJe5;d>gQB1YL6yKqG9Dt}-BJXtza^hVk
zX{65HGFKYtC{)<fL75hy{9h;*db@EeZ9eFJ8b|Iv_(ONwy+4JEGxa;Vi&@h>gQ4p^
zE~dlti<)zN+0&+7UdsVn1T0z4_ilfcN}Wn;?6H5%$Vi$lJaw<EJaG>oGFS&ueb3u$
z1fJtR8Se$~n@R1Ksnb9?0OW5N#<kzemYQki@3W|PO~S*y%LdZFuX55GIk$XBJjo-c
zRQt#j6Ft~FWyA{R%wz9I*L)m$&H#<H(+PsvSvii(d03Ik-Gx@=jCi@cF?(T`KhD{~
zCEWIHvLD*5k2cJO^KOFUyzJg%34-&oZP5Lv{540SZ^t*Y&}%UO$y2r27I=lJrXhR|
z<GP$N2trsxSw`C&_~83T^8TppiaLeMIF8+>Wm_&X!4Ts9(__|9`)isvV#C*a-o;6i
zPZ&}4Z)}!Iwkf-W)KW!%3vB5xdUw+(YJ*pIFAinVqfyUXMc}LcJT_<ItAmYB-@`6G
zJxCcKW_rC>Rh0Sr3MO&P4@_bP8X(?I;LI!k%z`iRrB$L|WS7)9RkQI9vc6AW|E{!2
zdpH^R^cDmm)b{l_nfUV4d+@y7%1T$k;1cGw<?NpP0t8u`U3%fp<jvl5Uujyzqgde{
z(z7?v3u3-q%a6Zm36&Z5)hb!7v~gN78)VG8bJlwWJhZL>YNYVQ>CdmRl-#{Iym8%2
z8(I3)>ln1?JX$9G(;$+x7^NRAfPr&GssGSa!U_9(Ay1+W0n4|!)R(LC4^Doklh{E4
z0m>MT%JtjU%_$ewZoZi;ybXqYJ?<)OS~*-%9`Tpg%~u`j&R2yRYt`=tzhRr-?}{jh
zEnU=<{!+}<SNeW1McxdBe~y*6PiFbXrePL+OM2_#c%tJskaMet8vQaoGZ+^d_*}cZ
z24I`bo)S&*-rZkBLX|fvzp>e1OGqnGv`g)hgkhUk>>anZsh;EA4lrwd-a30xHMDdL
zaYzADLsScyb^k5~=x3J}g<<G$k_=Fzq}n&5YbiiiGccgW`X)f<rN;n0I2hjq8<Zlk
zgArexY+9@HQ~6+avAB4TwS@Xo&tUgqn93EN+t%_lZnxs<EnHSf)mjmY$WHY$7pAgA
zX=9k`9>-hIIk~ElBa|hyF;1eSkmEP19t&6SbG^LAPmCV6X-|oswUIPmO~jyCGQ<&u
zCImPCz=<^LjA5W+rFzZDFE@P`G%{~>wa=89rIf;$=|76oZ+Vq<CbH!QsvEjFc=Y)`
z(ArnZZQQz5eZDNB>rOO}N6J&O_7i<?QG%Nl$HA#{QzjeP?UuYvS-jNEbi{@*MF(Bj
z-aZrF*r*;b0%jf$*p{bl?!}dIQ1@Im=^R-e+;7MZ=&+c5(7|my3w#Ez4r%!SPdnj$
zt;$@&#gB5uZB)Lb(5ZP;a~Tkwdqn}raBMvr5q7;jx0$aoi%7%AZ+(Q{ff5p4CNis}
z=+;^G2VB9JZEW;Tmw$q?Bu+s?etGXl1|MpVuFJW9ouSWbJf=|Ib=c{#<Wlci3>xd3
zUtiPROaS4hciL71gnsUp{jJTX;&-_-Y%MKmW&OSNwra)+%~g+TIqhD6<799EJ#asR
zLjUEbCrB8yfBGop1WrkCQ}#*M*%Zw^@T`03xtOw|x$U}(z2-45*LB4<_jJjR85$gK
zZVW6tQ=-PjC*B6XREn*4Jslzw^eJSe!^kQlPE|M^X%Q&*fUPo<?)?bhXm}+X(WWqK
zI{*g-%7PWyDH(I_JV$aI7*+2CARc|Q)8tRKtwS%HM(iZ2e_&!LHbxgUIcKeJtOM3m
zwxY=D$H23Q(+Zu+yz+D3h4U{vcE|4AuC;939B3XcezGw$KLc-!082UQh0M#t?b69z
zHAkWe05V}}4V`b0`z0!q#M|XZP_>7KM#i!F(V8i7_8HWjY_+$Q4$etRMLqO}Ci9^`
zg~UztJlkWYxwE7O>#<H<x1O#HRjhH_?I<_a4~=sNEuq-7dB4A;Y_@J8uK+440Q}-{
zM3}Jo_M7d7{8@~Rh|0ndDO5T(&m7N%tPYPVB3$fc5j>AB6p&av8(4yS@zY(O);r7H
zu`=@4GV9I!?{QE;+TTI$rCOlk9fQof#b*8kp*JG|-<sbp$O(T9Hg6%W4`2fl*(8y=
z18jKiOn*jIs(EjswvB{})0%v4Qr)(wambso2{V5U{4Q08*62i0>_G&u4O`8^tkrc>
zCj{WZPbk|gcYy_;qbyGB+sGTg&l$-<!i66)Cm9=^zpnFZ3I>~Jwnxn1iDRIG-mt<d
zKl_M#Yq1?e&&6BIzsSCstqVNS034R4^qziS6mRNU@RB{UC_V~I(RYExPdipzArk^J
z?5?_7dIlFxCsg^&^V;=ND&|VhT6b}(&l=@*69QkX@N=G^fHuAO^4ylSG&TDX<<Rx1
zQuWjAg7^V}jvFO1Vb2O2%D1Ywh$7y~I0GBdUk|yTP;aH_=-Lr+E*Hby(H*39LK#1I
z;mR&uK+@e?JHSxAw_aSFb2;kvc&<nwCj~_6QMC+XZn4@Ofazc`v;_AS{|l-SUnQ`x
z83chb70)r7`LYuPrHj-^aTux`a@IAd7otd7jJBD;>NSb<TYR5HmQUr<d2I}uSbH=K
zcAu5n;Z5%VD*W6zWyfFYZ|wprS9TRz#CfiChBG@7QhpjI{Br5+RDsI+uFb<{cplRN
zlsZ2tk)x%(M1$p>RQ+`R2&{PQf678h-F{;qv8G=m%l7_Eaeux+assDdZX+=Kmgt5y
zU!a(evVvWoS(ejow?tucJ6#QaKcz~XUkR}jt}<?-Q<)rS$WJ+B)1tN6%9(QcXfZ#-
zO(r}P+X*&)%TTm;DV)FUolRQHdli+mJyzm4nstcUK{No)9d-}5csL4I)V=JKk4!`3
z(Xe<y9d$8qf~5;->uDiW5_DsD1f!L>j+X){jdH6m=_qQ&=XZOZJNDUDjywVHgL;XV
zIQ_-^H3@9<wsGbcMi%q(%X$z8bdTN07=xShrRsgd6>zhrO>6|@rTn0N!o;$|4U)A7
zS$QkVMVBEiPHv(*F4}Ai!*4>%nncmf#jihZfn#&n#*JhTDBJP{8K5}x<W{t$QkjS2
zE1KB~2H(UlYW2kJzvlKjZ=Ul>HH?fs?_W*D8{9ovI%$#47@6%GhmhP1bV=TrJLAcT
z2b*6n2&!%6F0zb>B;;Rqp1p>gIbEs%Xm^at3*u*uW)J)%eXE}@!6^e(s<(cKisc?z
z#BYSfl@*|4wjK7`eoMUitdoh@Dg0t-_M)VKit%^7H<BE55$e>z!N<p^Twh35>@oH2
z1GoFP%92LA`bSaS;6nYE>C9D+z8#Ac@cP8t<qk&NVaMg$y@;B?i!MS})u4MY8i+^M
zAhGt2I;C^MQ@Bpr?SbO-M<-VlQS#tPEPnmXlhhXNAY)912f-SWe|5nav|~^d5IG>D
z`R8WL=^~Z-@Mf{^&CUebDYDgzj(H*Ud9QWz>aRUo-w|{AMfQq!gnH9RX4gl+KpGBm
zva(hdoewO~;#jQg%v*Y{z8F4DN7@@5<?UkU!~IINW^03OnT2%Zvm*BveuH~ZmX4^{
z_kinni6i1#>v(T;s^#&VG7Iat(~EQ?6xgR%p2KR;v!BqGym|2o50r{WopkcEpEYwg
z9<UR`N8S)M1pbyHJpyy}TU(%TU)UNtK}@vYl%X2A?DI*85lQDAChQRkzz&j|irq<J
z>n(KOu~XKJw!Y@|I&e)l51&70e=2<Sagzv_N`a1bXWuS;O<Ue#M>MB$G2#-<<J|e%
z<;{3>!@wCK9kiv|FOsLV%uoG}Q_ypp1M@vj>MU!eO|zN-uL0aHc;sa%qu}_RKxfY3
z%xszC`!HV)?TugELOxdzEnQ2CLD4Im)VhuM!ArNwp8+V(XN+jaz9#cIu+f^0mfPI$
z0%NY4LNXVQ=d@{`jY+6=E`_TS7djYsKxZf1zd!?cHUQP)IeZHu_D)N(R*WrG%1~X}
zBbltb1OkV-Wo+he?aXYe^*OgvUPy9oip&B^prXxRFAVHy=iO!4h85~3{8xQT1M^>B
z=f}zjz7B$<4H~T?%c);C8R1nlIPeY1Wv6<S@=#vc3;LTTEPgl&&-zLu=CkurdRvI)
zHb3d+HlJv+G8Hce=rVi|k$?GuzQeC-l5PEWgUwGL_6wna-@0u*kILHk5fKR{ANPS=
zm%d7_AC(jAXQOY+ay9nuvk(3B*3yx=+uU0w`K~Ch@fjS5ZF-L^d?vn0h0q8tzakUF
zANYRKNlz9c&bSL%J{-A_6F)+?gpyP;O+{zEH-_oC<3V-bY*xokZ&v!YvjrFK3>GP*
z7B)0!wO`g(^=Er6?X>vGVKNlSd5WKV%)2P9!%uSu%kgpJ=Q|Ycw&eQRwh*9hi91T=
zN*`7BA)x@^<-h}OrU$BgjUpdk2Akho+6VuIjbNOk1s9@#I?}47E}Q2KBP^r&s{Iv_
z74$z?YmIP>t=w^E6z+a&E~PY5)Di4>j5j}3Q!n^7n3urqVi3nWtr?l!UZXRsdw?@u
z;ud4`YMYZ>O=&pUj`Y`FrMR~u*5{|D&P8L5mbgT1P-XU!<eo%L*O&f};yN$M5Wbq9
zGfjt`Ov%G_%Cl$Q47_AtHI;e%97{dBM3yt9Q<!El^CH2ad)LbC;Au8=V)5EB=up8b
z_m=UcK(W-j1QM*c95&)nl?fAds4h4cgo<rEGsbPqzt52<GHST3t}nm7F<A-Xk!IVH
zKV7i5|J=L%V@yok@&r#8E@6%ug`0C9YHP(t($}*+AUYYn*IQ)1;#pZSlu+;22$<0)
zx2I`gC8TDV{xR*A<T*Ef`Ky*+mVULW&DF<iklp9N;O^Z{J0tm5{_j_MP49vZ>=P1l
z+)Ntc*nmlUYPz+mao?kc7OS<3eU<kw)QM}4Eh?FYb68p$hzDwF8EYS-`aU_6UW_X>
zyGRMlm>5h>=rLX;;HvT09~^zk!O1;POrEJru614`;K<5m^J`Q*MWNO%`nt|iI=)$K
zKgY-@WZ=Zg4#Q=rcbC&raV~#0e6k>+2A=MFNX&J^L?Z^AG~o#9dhm)cSK-a;wYg;!
zLV?v#VvrWJt;YzibS)&<vRWPZqSHT%USz6X7mDMMEqtAU_nEA<owOp=?6!sB=Z#;0
zCLp6t#y}XoziZWnV0LHq;?_uY8_$Pa*qT=qi>u-Gdz)C6|2wIV+2V8TsNKGm9sX)@
zzDq=_*bHau3;jy%OM~{)c6VpwEdeTh9?LLIXqDJ9K3F4la3Xtaf$G=YFR_Q$kw%NY
zlEiM>$o&nk;W={3v@B|m9V&yJd&<@&hpC1_@#gML+vk^~PW@7kmoagKCTt9o8?iq4
zebKkNB_&3)FAds?k|A-~#-Nw_RHE&FCfonXQrzFsVg?tM{!T9-7V&rk5db*Ji@%Ca
zVF$T*rcGK_uFfA<*o*JZTaLZg?YMpC<F-SdZKrnD%gnYhELc!@*=JYlJ{;dEFrTgE
zy3wCHGf1g|DyJS0Yj1Rxg@?Jl6TVbv++kBs6c<G)G*%aWHl`s6=A8BveQEA^Vw#>3
zsKHNTJC%=tFBDu{YOwgaLt}`@#*<9rxUeFJsrFpZOIcB$(f448%iLzivcz>l13SH$
zN7hC<BsVa8v*BFhVeYbZnb5^-VM!!q{LJF$OgiVd7Yg#B#7nBhPVH|%HOnR*$}++B
z7<oPX#eCBe_j|Z(k=bo4E_DI2oIc~Xy4d~!Dz=TB{KJOe1p$kdGSLw+?Ab#QD!njX
z4ifoCQAZ?pT%y#2IVQ7gdmh^94Qz`NEzyOKdz-qrbNseHHq$94H9lxL>Cy?SERPNI
zJ(*;kZ;<^>X}cZ0e7PHv99Z0jD{erYVZ|X5QK;p3IA&r=UpLnTjXZRc4K^Q4uB+|X
z{aze(a|-B3Rxa8L8$hi+{6gJ<*8<U`!RHahm{Pd;MZ9|IkiwA|9&t;2BC!S17qd$?
zh|7>V9hes=+I9bo(?`X{NO+p1<lk7(`Ga%J<YT?8T9bVQI|kCU9Y(FB)U&g@+8Zki
z?!|e#(Z}a1w9S%RbXl9}(PPwxiCSC4sO4v^dsDNmOguSvHHJzZd-X1wHTRaCp3Qlh
z%f07Ug1qK-&dPH7FNm=YvtHK1+{`_vHhqLkz8V#fjw+`f2=&@~_a_q*XPPf`G@0bx
z`6o`@Ti1zPA@cz3yjjxPjI@GERMG6v_gjJV1q*mpu*(l_YjX4V``BulTg^}Q>OD?o
zNY`szRxTYLv9%uFH+0{&O~btA&~bx}*|J|MpIBA1tz3m->k0ZOvN1DiWFLt#TV7n=
z{@!Y<fDcb|cPauXJ-{J`&h3n=kRw>`Rn77hvOaMYDQ<d)NhT4hIOXqbDc4r`K}rv#
z$%mpXEZ)zKwlrv}RxQG~lHc<)^Wa`fJM)z#w8Q=(NTyT2_7pn0Es}V+iZ@?IgEr|y
zM>FF?rv$vY<uXq3i)e!K-UoL0-$iO?C3lo`w!rVc^d)eHw46M|V#zIQRDAiHD8l+j
z6fq>Rb4)2tA%Te)a&zwwf43Yj@z~)KLRGW2@ysQv^9;WV8zVpbyjjd-mE9L0Q%SVe
zJJztXkQ=vPJ;R^n=r=P7=gUmFv$7r)HkNddru5r_`pj;_V|R|L^DH~k(`{VOiW^ZA
zW@hYlTNKKVc?ny6{i8+d4LjNE%r^(qR-Ot59M;~sY0z$n?F7aW1LUK_jp}&MvA|i`
z;(CV@wEK$|gwi`--PGXKu10snnTO;*tF#MO$BVvxD5zVHr=|~%E@6C2RjfF!TGvJS
zsX@E=z|eh0KJkA1YC8Zn>H21F@xIcp$Xds}m2}ajOCa|ktV|vjTj%D=JKM&N`}5MZ
zxMDhLB7wj!?*6BhZ~}#g&dVL#=QD?8?jz+nIxIc|8lVhDeVO=X1>KRb@MFUkyUZ3N
z4dIda1_<x&Jrqk@Zqi5kYS=Ag)O$e?tl0>y-<@Gkzx8_~;`||qD@0VI(SZsgn0b-L
zm5mO99h4c#W)7jsRr!*^!QwExH;YE$4WxdURjE1Phf_C`n6|nxw#@|=-&p?H-^X_{
z+Z&-`fG!Uqh*aS6;Mc}Faj!>+(-qN!XwKE=a<%5)EN^nnUMpC7#u=4V4O;lQxRsTa
zK!UCgSsOR(j&K?H&K=(}#RvJNPoY_$$FqV?^j4O<;h|aI_&gF;y3s(z3y}S%Jn@As
zF{~Nv^SI1~xBku#{ak}5wV3U2e8MF^s4NP|LCG8KDatd6Cx80b#zqnq2JT~9{U)I{
zyK+*DaAGa75r;J~LplrU$q#N+`Sct-!YZJ;gf)(qa3U6cUAmgu)>|oyTGL1A%DlxQ
z;v{k$-&Bdp{iRyzGJDn+{v1|A2D-K0YC{3OUMnIq4;o38iR77*LMoO6Nfs7r+@3n#
z7ki|IU;WLdeCPEx)Tzr(F{>7T(&rweM|B<e`j=3&LekZmtee>}wD3H~qR4`#mtA~3
zO}Cr}b6a!=zOr`d*?I&vYTkJ`Q1$S?;LTJ*uAf$GaI|{W<>8qssF#w=ky=xuT%pS%
zL#tc9<)5767Kz3B&{&XMPHa(I$MnKmm}+97Z`GpKb!kqyT<3H7)fcBmG2lKygd8)7
zVeDZqup+MKCUDGE8qZ;w?ymm%Ld!ZSCx{W7>H3;B(yLtmtVsYJ6sM!!)_Rg_ak{#4
z_TkfK3*Vco4e|C{ZJ+x+l|J)I-z=MQYQCh!4zQw8>7^r&4pWd<fxpvc8w`(LNfv{l
zKp9<}?oZjN{|J}??|-u~x^2Yednt5OR8#~79{)r?UGiI6IlTQM$t60Z?_~zzsV2cR
z=-3Gb+1TiEzh*Vtx8L(LcESYwu=Ip<f)8sMp8+!~EoE&$$;5tKmTg)}Ci+$A=0C>r
z4e^>*ZAN#rGcL=qKL$c=X8Gfok%Ra2h|7I#kk4ChOG#qQwsJHB8Vfo|XPqEhJW8Wh
z`#ihzKKOnB+WAgpK$O?krQwy?4<EP;`u6g6Ws7Z>b;sutzW`dBctcr->$Cdb+t2i3
zMZCYn%iHishB@ZG<Gkg4@&p4-?)^KB!xVC6hA-b?FM;2m`^)|rhJT>)HbvsLBTy<r
zeUJ{gA6wGa3rjnU?V}__f)UXI_nBxjWigy#@xQl^Bg6;+p5K7?q?inePRh}LlMhjO
z2H?6)>C66%$>8^^AK*^Y^d{T-!)1iTDk=s8q0>U@6@nB!&NBngos#?bFc}C-``iE3
zG9;b^PZ0oec@53So+0&530lDY24Za<wJIWi96YB5wi=$c)fs~C;G>8ELs0p9upDhV
zK<P5<uO7NE?n$uuZdQ2{;{Khc{<$Z?h1kykOxdm40)O;khw&eKK?_vOb|dyuX?{Z`
zKt@3ebbpG}Uzm8ci`IO2C*Fnvf>%CoW(qc^<C`b_>wp_5goFYrbpx*+vIrEfF_|Hw
zfH);+)7?*vV6?LVk0q%R6CIj#vkXARLZ&;(zp6z|_LBs+$B5>l=thtGqPhJii3x-d
z6P1_BDb^uJkLS+;w~g}a87QF0DRbk$(Zw#tGeGf3b5u*oVp?2g4DK@k1R;-!em{@T
z23HTcMo4mxT9F2c65I(H``CZ-P5<Gl091&Vof6b`xk{p#bV;mviX=yhkcW^@l_PMk
z{c%!(c4wJ2!R|SLNi8wp?~=ash?f=GVm-`pH4}2==9i$|LC8an`Dhx~6?PTm>!(Mn
ztF6sUFB1cd57;+@<I{D|+(Vb)OsSlPpv6T4IR%A8#KiuhIf606zj#jsM!;Cl0G^th
zs0}UNCtv+nu#JIFk<pwdxll()4fivVn1HQ5XT|p`_(8z?`}_9DA0L<%Kkc;#4L}J1
zc;vi*sHiA9_{>4XbFfhxD>6D>5+a9qEB=K@f0DAm<*|!d>>X{o=~mp~-}nj`F~Tgs
zAMuyqryGN(C-FfB;W%V;G`C|BzRoH;<VXS9ziA$?BU<kcTb^T}tWV~`-Iv3D_Yu<l
z@K_dKJHTM*xZmJXc=zsI*D?f?LHznRvW<g7a^rGf%dD2%!fxMa;ANfii<^Xa|4@8|
zn@0}|rN6#E?FIr1>TseSu_x*t7ro-}5AE08Tm!P=w;vquyNg$eQ5>T`Vbbj@`Kk}w
z!<BWPZO1)9fX<f*SW#M<unfO!gbVEUWE2az{tCs+zcN1p+tb>B(PLv{LD|_HWMpJ*
zrq^0-ib_gK6Jukvh>Bt(kL_nN@H7gD{jX4af)s$jYHe!np4}{1P(VOwBe}UbJtt>r
zFg~qQik1&WPfu^1E9fTren%w;q!O^J4oXf=CZ{S%6*WTWq(fapQ!_c~^+fAc;GtWt
z+osa}kd@fv;WDH&iJus>nM*eQyX|TzkwU<+Z}}1K6@)(ddG_`=LYzH4J>3*Z*DZ@F
zhWGJBb3S@5FC_f0eqa#^fn@zp3zMEUlJQ<kKC(+ej}JLBe7Bz^a!FpFwPZx)3m-NW
zs0ceBN0R=A<a$pY?$^|Hc&KwY{E}5?v4N-m9=YckExDbjG8Sj{=Y3jO8pZpl2(Zbq
zdiPheeYP!(G%9iygG0fucx&S^B0jA2`mEHS<bQM+ypEZ6JRS;UO5=U>)u*+Q1e}ec
zB!(vR-?e>Z{GY4-#~|}cFzgq;%ZWYSj1mGalL#fn|I1<KIbo%#PM{@Tx|As(9*BTW
zZ)u?7InDpv`M>){8yKu@959_e^98H_`d|*}zb|QGMA*qb2R3m++lHbm<zF=`F^hm%
zi(_xfUw`_uoW~*&zJ*z$HRjL%{%fE$L^zRs2$lZd*wvrfkYGl5i|i*S+<$efe}1UD
zAp&}Pp7xRd)N(e$A9^Bn4gRT_zqx750|6H>w1)8?Tc(qsoyUB}MgQjx{be}*|5S+l
z!26&lPo6wJp3w>c|9f|!eHgB{re@C34UMhzrjZ6~5}>Sw_ThOU7Tc?MEU`ugckM6J
zpD=ixMu0k3SjzOTuD=EQpp=oD8sjcJC1@*HNe8_qm9C;if;}(G=*l6`qfkm>4Nc$q
zsHsh-wM{ezlf$xr+a1-ZjL3}$`i#oCwr}}JjzE{JDo2g{a;t;vDn-q&k5^K;3?YSX
zTO*Ma|0HSJF+wE$Mn_G=qPXy9fJ+qSy?<fTfB6~=KqwJ_d-#vKiARKy%U8^7Qvcgp
z{`Rl`|G>X7mH!03#Q(hvgN^VRxQtp~-1sd17ZDA9%I-X^sl78%q=4LnMnv`BuIWED
znpgkian_FGm)ReFG1#Ot{NhyzDZt1pI~<2b?7mj`r}yDvGxft0t-o>mf40L?w&Q!4
z*Is-o7c)>1#w0OJ@E6Sdsp)Oe;7Ufu+sh0-6i}P&P{u!84loR^92F_3s9;BsCI_S`
z%0E5qFHHq65zcu+9Uv!(Di{oY@o9YjfKwpk5Byt%n(sOW+Q$7`P5j3X5=VbP8q8()
zH&p-s<l3}Fe^3bDGj*T82Aw~dfUh>f!+Hhi3jc$dvTz_6-$Z8az(2gqSPR0nx9trs
z{F6*=5H_5&bgx1EPs03zkQo}!{F7kh5%j<Ke6!^AA40%67!k~lZfiaNK`?512!>uH
zAfEgWlFsu&NZM~Uwf-Lj1DrqzhNbPMROBBd-NuH9JT2`N|6(nF(%K&elSG1G>^s9M
z8~-5bZNuQFQ~*3O?)TaTE@6vKSDm=QOV678Z))3bciEbk51GjX7JRv<{0@2Uq$qZq
z7pj^5y=a7(Uw=gIXRB(Rz@``0He8C8xI$^aKULt$+F#NWYUFijb2EB)fc0BTJ-|Xw
z|7PUypW4B341P)mkU`^hT+a~xIg02I5kM<bVP@;H*rE)a>5yKgpX2*)1<Jqyyua?m
zznJG5-9D=`{x%Z0=rGl{=kfVr@vUbT+<UPpO}|&k&<Ejqe5w$0$yjXEt$WxhRq$+s
z!3}L|nvdT`#qJcXDzhIq&z8MqmYY^6$afZQV+D4hW*vl+mF2mlZWbc*TqtwJ52ie-
z7=IE6!m=hNCLo%Ro12@C9O618JvC?g+{wdg&4<}eEDosv)DDerW>603gO&4MyNNM4
ze-ycYvg0~zAm~=z&};ZL>^|Ft+~YxDf6KRO#KTzU?M=7S`S_^HZX+qD?ZQ<@RfSWK
z@BsY_i>|)DS0vQu37=XlOYJ^W*#wC{o`(i{UR#lS9=wKK!`NeA2udzDnS^RjEc+W(
z-PT>)p07<pyy0KryjLn0*%ZC9(;*Gi-EXX^-HUN?Gvw6?{`4kKf&=M)XSY7MkVcyg
z5&&*JbJjLEh4AE*WUXd!YoEd{TOl+)9SXRXeN#|0cUX(Yjuy60V2AaEIXVqqjkgIc
zWupOA(ES>XSGCr-liMI}sE|x5#ERO-Va;_mj@|JXPzJe(3EY~UC<$I)>3E>XzS&Q`
zeK&HIbaU5{TK%1`<JRiIp?jIlZOA&{5lj=hd{<u;Fx)b_-S-;P>sFQa#fs-Vo+}u)
zr-e$yU83WA13b4qD570Zh<*v$x)t=GTM4hqZ7&(0nR&EdI6wBY*)xfH=TTDNV6Cc|
zG4SUQfpJdp)az7B{Ls|JUQl@n@v>&KBf$y}3_$xbj@iX#bPZSYx*j7~H~)BKckAyw
z!lQWq@`P?{KP4f!Z9<BZpnX-`ESs!6;S7CQd)YXo^vZS>OrMcBUq3LL;xx55%d`vF
z!KrUVt2zuI0q~dlPis*1%@+;3anqBv-F?72AZ{I=5WNaz>(#Ies&dbJ@CkgN1y)p5
zYU=rhgLhB`v}KXxX4@+sz?tQ<OpfX{F_%yXs;`6DCv;G@qqfpTnP_TpOpKkL+xcBD
zq6IXQb^NX2nXz)=hF*Stz8z+#{pqyvWwk?m_)sT~WXAHtq1OYozy_8zbT32+nvmid
zE7TN;&hWv{;WY-m70fOu2IoLW-^tc~qTLYvoWpK!^31Z(QNIKiw=W<>@?UHZhY}&Y
z6p7k9=%5?rcJO+sHs3}2XWyGXJlIr?x(+PlEaWpM_@yPHd@YZvew0|uHTf%&EF(==
zi41dhoJiOBW>7h314t5kupsx4A&LrVbce)I>P#IW^^2maYYIIOQ|a(F#Cj)5Ayx5X
zUmg=G@y);wMXiI^<3iun-sw~wAg1EjmkEB{;FzdQ#V`F`46aXq9}12`0V#izi(GKB
zld5vS`7Kd<c2FjVo}#EZ9+@n3zC?H7uVBxySQmfC0Cb=HuGM}A79x~Eo5qpsXF=4T
zm6pi`aBORhINXk=(+PIUs_;`%WX#Q9*$qf?=%!s`ms&*TbZiNfonE(zt|q~-s#x5p
zr#`zedFGk$l{Q>v@v<9|8Ii_ziJJJ<rYP0-)<5hFvkH4cEb4U;Ueq(WIQF9Cm4i?I
z(UAuv;+?Q`3>3{lP(W#~WoAYg(G42XP>`3NzSm@9&m-lmf_W)_ZVe+n`Q4Y8$c)6?
zsvSWy=mUbD55Z3}`KOE<P&WRBX}s7+I$U>fLIEi$k=mnVqN300$X;;LHZ=NAqUv`{
zxGQDl%fa_*XQ4ScO0AB2AA^1pFV4UssV{TPxKKexJ_q(6v&wp=+CGXMl8lNU+lT`5
z`h_BlVUVQ;4ywpXc1yBfd%Nommm$biN!gFgA7}+(GJ>1~F^(Q5124c%uZHXi0pYvU
zqvKweP?O<cM#xnd83|y-rg7NM<0y;(R0D0G+1{^_aFvabnAnM+`pPejei`<IdFfNq
z?~At%^mCj`fwoVVsjk{*@R8&?mR8JUt$)1Vy9`>HqTYaMS0s}FIBf|54SKRkcD>Y1
z{1f`Y=1G3NQIng7FhkkZjn55Rae^dGx_NNPEQvOcpREDqsYv~oapeiUpJz5~@7{hh
zJNHuh>Peg?O@mk(GYS$R79ianixZ^ki`A2Ve&;=Y>TA5Xmnh*1J=5p&TeyN|7xNi~
z!OkoF27}5r*r=muCgxK65a*`3{R-b29m##=v;33az5X;WPFK0)#7>ykU(ARMa^|l-
zOuZ*s!yM>T@WP@)=0XT^mDl>k$un|EUsTYAAVX|Crc}Ygkk>w<t$zvHoP!dnP5n4s
zOirN}bmV)4+dMd9+oMDVao+sKPnz0avz6Lfiq6cOQ_BlqXnB<1@_X_9G5zGTq|M&h
z=#Glz`gdU^yH*vK$woLV7)$i~>dLhP%t3z-^@IN}p-;mjsnPyiI(~u<4iBMHD!G-0
zPGGI_j?UEp^NHLNT*d%G)hGWF1c;tHGdub50$ZKsxkOIC474Ub7h5m1VDyE2tOes`
zpAE!PhLK=}km!Bk?aXeqE}JedPqmKrLK-y=^oOgn`n>KH9$(P#(~wr69yjqC>1-)t
z3+m(-eakT!q!VO7L8A-)yb^f2R&SymS!|*AI{lk{gS*lVHpD9+y@UG7$rmgyKWppy
z)x<O3%P&rp1aOOtZIo&7mC;u--d@m>dD>_O9AiomEWpfqd@8d+rL&#ARRJ>#p38Zo
zm*SzpMUC^Rr+j_b!H6ov4K$b%J08siu~B+}atj-4f85#&nQbGm<u@J6)~BjtH!d+|
zKO2=>fcA1hiycr2AASs@Y3}Q^8E~ONSp!;`V&CSQ?NGRzpYcA5{*36lK0rl(lXKLk
zUWweVUPZFq&ao0pEq3L1cwMg7=C9Cn?+Ck5nZN1JYPj$yVADtH_obS<{t~4}4yvy+
zT=AUIP|u&f0w*|-J@N-OoJJgI&NoX^)u_@6;o&Y#okGj~RM0?}P|rPyS~*!`9kA?x
zvh~D*p|9_K#8UHa-+_^^4aj{z%}Z=HSxB@|wa9MEn_l_BQ>{X-dCg<LIva=sbJcd7
zT#(LhFxg@vywNqAjN6#;{M8#NS6f_6I>@O<o9<m^c;%8~j2{O)FNqFNV&vM|n=XQT
z!aUbSi>Q{q6-lFiX0^TF$7R(ORjRLq>fg#Aa8c!_yA{l?kWhA<5+}=`{Ot82vc8En
z`@Yu}JAhNwd_bk$OO4L}b)iw;+agIQ(0Dj7%s1pub}Y7=!;Gu>&<h+>9!uZImQ?D-
zgSBjSzwYxEUe2y*RJ0m;W0Xf7SO+^<kika-@f}cV!>nehm(6<9SHG;q1RS;6FAF<_
z*me}2wA)RvrO43qRv1#%63mjWQS~wzAIpTvQr@%@w5Tg{sazYnc>G!mGwx}>ZJb5!
zj~BmJou1a@7jji@+&xbexZJ*kGVch_&oB8dD9)4LBFl!g=nZq&8*fu=**^Rvc!Tt_
zL6p?AWQ0Q+zk|Aj^vk2KyAwwcv&cvEY&DCX3=p^D{N9D_Pelho7@Tq&tFpjnW3Zv1
z0R`l@xj%uIX(y=FOlP}sg|a8XRkv-VapAiXm(HpVdC0#ie#j?1nf6;DtQ^!Y>m+&B
zVQ<V@SrPzP^rM~9r+w#BK@mTz&bG+Lx#(8ZB8sD@vDl^~I<blhdepgyzioo()xoWT
z2Bx?9JnqNa9|M0Z+#X~&PYy3hIxIj?K}*&9me})N??*p8_6K`h7WwGx+(6xbzr)@X
zcEN5u_(H9?<XOwrIVXxD1!XzC@brCG&w=OgtrBzeU+56+nBO1K1A#zUfu(#|JWHDm
z^>SXH7<czOA%~iC=M6S~TZbVsu60`~0Oa>z5a)2q49r)-r<hc%=w6@O{q|$cOhicH
zaPtIf%gFK@i_+s#Nf>Cn;&b;P$9>X_Z?I)0|B_1;9%NQQYrdm?;U176@bPDMJVYle
z&z?SRH!j^SNi3j<e-kS4Wbb2#<1k5f9pNvk>=1R)7XY;EQCLbYuU`=s*5<2+?TI<&
zbcYO8uL(%tC@W0g-g{?K^VGdPe41w3Ry#s2P~w#n@O@3?8<>C23`gf~eZU1dwwGI*
zGXp*E7dnh$t$9zEV0}lE$iohcG>5_IrG~}hO#-F56Erw)@Wg&Squ$&04UgEy1R;{F
z2CB?m+eudhok@wvhRg~9TUFf*WL1K`4)1aFr5S$vWz%TwIwLqdtPgfuJJYPSg-m3s
zl-t8@n=TwM87is3nPnF#^AN~zwWmSzeAs@ir+vXn&r~?tuO?5+gVzsVjo1R;`x)|E
zd5D{O#J^=DuQM`&`Mm}zHZ8{{3v6uU?06b^e+XyIF)HKpQ?XN98T3@@&s;zm|LK{V
z)bS2qnWlgz*+TCKY2Uz3mZC)0bX}4S!L=9bN1ja9WsM4PrH#Oji}{rmRQ3h<ITk&O
z^`QeDjE2lcY+4EUX;~87UzO!^3zN%Jw(;7ErDrf|Evu%>1kE)3yz8PW2%0|Cn4d~(
zY8`$^X!h=n2@@pG_2k`Oty&W^yjl2syGK}evFTU7fj?e44H4elbw)>{Z04V+3pRgU
zUn1Pz;~7r_K>J*7`<&XWZWS#fTX$(eD}|~P>&zinG=FvD@Wm4U+y(i^m>@)?mPP&}
zQvZBXDW|8e_7Qp$<1xT;IdGpu#pb5xWnEhJ<<77!2&zNnFb!t1oU)Z!T+_)P(bTY2
zaY>+>ov3&1l-W>B|5p6j@pk(~wzlLlG4t~Pm8)*lQ2GW$VHR|^yihKFz4;0;*m9Ef
zx8FJnJU=tu&J8py5j@-U!*0a1Sq=A{I3cYdmDJ7fa;9(_F=Q8jY=!JS0A0R5Eb*N9
z5;h|-?pAJ~gSrQ@#pELJAypoaB<C`=n1s+`c!`mrDNFOYadgjikiOs8<8z!*yTEtC
zmg_s+72<W&>_LPTGl5pR7}vEU?2XN#nQqB;HNRJA`Dr>7ol+oF-LU;%qkd8KtxZL<
z5gvDAgN)@Hzx+EE{fMfT-nAKwW(@OixADoq-BzygHaLRD_k8MnWMp2w&n%R?=)M0?
zemFdHW}kT>lKEoc!=AWco@@$9{W)i~IIU;0$gA1X$_D@J&6L>L2K1th_!m(rJ7Wnp
zLaOWVw^*#!DlHcKO2ho|ei|yJs`#IIGff-jeBGqoy(ji@x$G`@#rr%+0~}%W2W{vu
zJ2;0CZS&TF0N<`Yy~mo@fqn-?ql&m#5yUuWI;0u9t^T{s-iieGO!YoCiRo6D)c$vG
z^a52Cp-22E(ScE#g4)`=l0^oGSLyi!vitZAs-hFjl^Q#n(ld^d^iI9&cB?0~&PQD*
zm*|7P&gCnwIOz^aYLQnP)HnvN-+K)i(llC)v9&Pmirsw<=O+r;{7W6Sjs3Us(xm|{
zS=Mn*A;^$|Z$A4+O@i8n@Bp9b0;Q6o_*(3yHCdP?7gVs-`I&ocScvBm?Vym>5r$Vq
z!_KxAhg$b~te)uVr%kZ<w|j?(^WR;niykXYS{s#<>kh(6ZY!w6hHkHkl*8%r7hIjP
zn<<Q@*JnxQJsM0?9sDOvunD7hZ7d@BIWzXdY)HjeW`lX?d97q#@3O&rjwumljq|Hr
zG84~L**YmUDE5~QbNa(pD*?!pGYFcmhAKkrx#}})Lt#;8mM|fiudq&(ctK3T=QeEP
z^jk(F?HTz?o3jrK+u$*u>aj?7uB5@YCd~abA7s||NS-)-uip5W6868?`|hZwwyj@9
zii(I>s8SRZr78$02%$)qqV%rx7CHnHfrE%B5PA`iCcR6IbQO?Z0|Wx0NGJ3XYLd6T
z_Z-FZo%`-zZ@hoLu?J%$o9w;HoNKl<=Wn?%GvA<3xi`gKcuJAjC8Tfaw|$N>dwy8*
zj0h!aX(vWs(-eHy?aFOmH~j>WXCK_X4G@hBTN-KAdbf6$E*oT%X>}AZ(~|ZIZ`vmX
z%m#{S?6OdDjE<}=Hx<{APb3>s?(;h!{veho9gbPdO9+ZrPQG`%@Ca6RUSE8|b;@kP
z!)^K;*80v@^w4>D@$M-_(2MOJuF-gXaqy^*V|7vrZ<l)VO3TL4`H?CBl0Oz+iFuw5
z#wUWfJn<#x&oz~h)%GsZrOArz+r4SN*ySLx_{PA=xaP)VYVex+J66)pS?ub^R5bOv
zpxxNzGFf33E^EiMRN?F4#UR2<OFn)(uP_LvpLeQ-M%LODHCV!VO40YSwdw97zYIH8
z)K$#8N&3UAA@qX1h+qaPR@ypZg?nSO*j8!w`c~H_TCbyM)+E1dM*%7PERD0avM=2)
z1O6}!W|)+oZah!My+vS7pcn1VsgxF+E9!egpDyapaCO=TRc@p6Hq1=Kh#5^B6kxah
zz8177TH9pgDu9DL5ASH&T3MWjiHDC7HkE~quqn0!J19v0vb)KP=g3OJW8aNQ7e{fh
zbb>mYo|t!`(q>`eYe<OA5CfA$jZg4S)LG{BuM|v(SoO8Q2T_S)y|8ck&)<(fipP;f
z=ODC;c95H}h^AF|Gy@kbu`h|Pfa2?Q?5w*(q{m1^&8?oSj3fsnqKFdkY!6P^;Y`G{
z+lV+yFhBH3cA@;hYdEEl#rJpWGOqC^Y033O+Cf%Kkq|9CnF)&!?K%cqP4KLHot3lL
zd9v^}+HPkX=A01-3u@v+;N2H?zHY)Y$O3IBn5qMo2A5afn0*z0ZeK(J=6-J~-osVV
z4ZWL$bi>9}s4{4$<l<({G3o{KuiygZC|2M|RKew7OjqF5)g6m`wUm1X`Df4G`@V3I
zGO<T*4Jc(ziYh|N7gDI@ga+tUfT2Z?uOerNCC{)<9gi8Fi>=QIm8wc7I3Ps|IuxnZ
z0+(!QwiSZM?oN|M^2ZR?5=6a&>YZhrI9%)&j#flcP}tTlO1vhOUkyH~7=)eXFvFM3
zQ*k5amY^i(gXt7rL*+?*-&J3LtyEUD=YR@k({hyz9aAePTd<vWvigqVu}74`h;3^n
z1WK9Ka=|)c=gnr8!8+=>a*p*rG-;h=@`14!PbgB*8a1qABa`HKo#*da=#p_{wQMUb
zMuuatcHX89<DwZo<>wa(yhcD+WZ*-9;61N`B-RpFnW<jRg=dcQeX+XX({c)Ey;CX`
zcBNP9O*!|>Li+DpXv~jvILoUimAY!|R?)n?>!9bMmmZlI+QOemmMvy)SxP74J%%j1
zX*2azHX%YxkKOeBoGqRv*-VWhvV!2|owhJ|5YfW8W6If~jK|UrRik!w?=#SlL+1me
ziw~Lms2}aiz9xI}{1sqTR+fIe@k0EY?kLygZ=@_OD~v%MD@TUr3@=goMBGdNAvKTn
zjSDanY$aWp_sIUhW@Aj=!)K@Nsgj<eKkDVS^kzpt@BA>lU)X;mup;Br2&FT-m7f@4
zn_1uI!=>l;VPugGv|Xf!Moz1}RDxR$!Znyg;Tj`rNd<EzdZx1<vfs%_eGEejsHD{9
z<tigQ{mtews@5gwH)!=U@uC(Q5#zh23C16BxXFu<)ra4@j&N~?h4Gc_hx4@lLn}+`
z<tr)K>1eAEAx||ga5f!Dn^XL<?v;?sU;}cIJ*&VY$<d-~i*j8FTH%7P0KcZ(``avO
zw$<pedp>8o9Xo8Rf>=jU*WplM1nCeg3KeHmKnw9>HiYtC;G82?pBz34k$ggNiPg*`
z835J;T&jJ#d)b>(R}iABRjRxW+TYUeeyyV|jD;DGF7!zX^f?P%ULDlG;G4>3s_A))
zqZ}(*DNcKnP;>_Uq_?Ox;l}+?I2B3Tn;zS>n(wAxr)7gJfFQ(<<YqBpsdzg*#^=p2
z<}7|T7JSeb<}*{6rJ@kEp8EVt<POP*eVyb>s<HmVFU*`5v%9DKRhr0v?q7oElqZv%
zf!cMIM40h~hoG1iZ;GuSQq;O-8pP%u&@kTpT6D$}opR{?BCShI+^T^2^D?E6V=Qxq
zNCzH17nXdL7P`E9+V+f)42r=X2Ya+12yMu2v2nDjzd7J<6OS8>lfRHQsQnOJ$AXi4
zG1A1p`%#I`I@xB+;_7&}hfxPfP0_5)+Ch@ADpL77e*LcCcGl#Up&DX?VzYcMHK6#*
z(Eu(P?J_Z>LKWfeRzYV>hNK*h)!0YoYsEiFg-fk5VsGd?lSwEfAzVckLg`7d9TSxk
z(4hdkmEDDnmpzMl+wHeyaSD{Ew$&y|4kH61WzC$F+8ALJnYl3vU6+?_lH%MH^q1`K
zYG8r9GPgbrxic%RoO4ywQ;tP5ov;-?M^V{WK=IAew|e+lO3-rQLf5p(-0o1#yHu-Q
z-t1s&nFyw^!@utvZI}Kb<~8cd&LI;3&O>psvY?z3l~$YU2rrb!t#ilbD*ZB&YMhaM
zvo&n3l%hQ0_E%iI;$jqQ<aQ|V5nP4EcOhwnm;G{v>4M{(rWN{?9x+`@1IuA*AC*s3
zab;ON*6dc{yA0Q;WQaGO!rDpnIdj8ilj&pxLq@D~*gXmn9@2_ECE2IiwCACwN#>#F
zPSi;X%-!=QJcxg0S>Tx-_u=asw(xTSyez6s57O8k;<CO|1-5uNbi-*yFJU=e<bWR?
zZNBt>(~?v*8X>v)HTP6|O>wJsV&+i{rO-y!-8^4#ZqRuMPk5)1wzWT9{|9tL|F?z2
z`5@l#f{G`G6kpk&7>(4qR&a{ae8W9sTO4Tyk20kBT@!9zejOnCaa_f3L;#-S%g28&
z53mv$7)R!%BR~0NK#ZDWB?Xcv%$bZ5t-k2aRLSTNC_TFGIPPy`kVj78?7<lL<-#tb
zEG-Q=-My7FFm^$U5@gfuD51{8<Z>_@gK=QP8;KIv6=jpo{zUoBotFVo6~Z;oY!*B(
zL6tjA9Eb~WAgc{FaF@-kGkA>8<NB~ATZnH+(!<VKmOge4vHBwwQG{1fkecqNU1Rf4
zC~A_nPc4H*KtA7G=&n&zU!G9~<SN#hjbYzt3XJ~L65RQ2r38_DRnsp6C<CdX<mEpn
zr=UcKRkKrz03m7*r!Aq@<)+x=lS<*DhhmmT<Bv)~p%-_CHmNr^;;5k?-hWKiEo-4@
z9LL;5_$R42-UXXlzto~s%^t6ja9ek%ya3L^={pAR79aw!G&6&s)8Bc@H($>M0wPI-
zjWW^x6TuG2TTrG9g;MBYc|B57EkygDiSzZ23h%%2Ha>F6_VT@){1GdUez;jeP@>#9
z{a`-ECPXLs>EZGz8oHf|RbgZ6#Vr4KuAaHff0&B6BkHo=`!tcX&E;GhTg3>qbQGdA
zGS9P$7pT8xO1^&YbjM2;a-s2@ZY0{HiSWmpy~ffTO`};zhrCf?aY6m|!HH9Csk_gP
zXd-#V7ty%r;J!rmfy$S5V&x7xe$M8O-*Q0jE^VKyp5(h|&y*xQ&|m*4@NZkzl8$G$
zfrK-^fp4>-qRxdw0cxL6O92e7S~syA#JNY}rt{dWVXvf@z4tPt=G{OGPDp&!Z8DR}
zzMwDrxlrQ!IF+PNc5<2S<_<zyb7YBggIVX3%uz)K5IFoI%)D4-<RJMgtD}Zu{YUep
ze%7%Z8j7K2-cbUWeY^D_UH@=Xw0OEfuvpwy<FmxmA<IWk3Re0cely!|?DSt}wVhMB
zgpTu@`Jju$8t*+)-i%#(WR=AW4;b;A7X^|o{Y5^=3y{ZcqAi$r@t26aQih(}t8XrO
zz(r75M<;ouoB_`~v(fDA_A}3=$u}p@r)?Rvi2h|YpVtLE%|HCNK7Kg?e+CM^qL6&r
zh+p8o5p;n3+i+24B%Z>pBj8#4kda4SYv+Zq069U+yyf?B!YJs8;H5oqXKvVCp|T|Z
z@(#-@H@w=1Cf_@Ip4AsytwmH>ETPexbmc_?GHQ<R)1Rl&1WHi^O}@A85S6}{rbpGH
z##nr*1x-F8b!dyP$v&mXw1_N%0Xd;Gsb3aMd`GQ3r8eGBgD=~SnJptXDNJR<l2`UN
znPN(;iiU=x3vUSHZSHir+-bJi%(90I35a`klM7a<(mN!KoL3vsFUmYqZ%11V#M=4D
zR`Tkmb+h2%Zu9fOnCL>Wqmwd(sy)w%E8269CXgQD-(#IS3JolJK&v~FrN!Cy6%SZy
z`(8cK#03V4v{cnquF%qzRwbVk#!KdisKIhwKbn2Rs?1Qhg0sU;L+vV1Ot(*S7|4mp
z#YlXYT1bevl+vF@kyuxSXk;G+LS%d|&Qbi47GA31XYNKF*vemU*Xro`#Fxt-X~=d~
zg#)1dA^hdWY_0-Fk^%_#6O1$pEaj4=5;_6-S+@!^nSyrgq6BWL_I+%hr8SlnHTlS2
z^ziU|sgGLKzP`1%*0+$H!KXFrV5iTv_~zaz$x^Mb^498RN{+*p=t8>XFu#X~W}nx(
zvgtJ{<#3_aqrzqskyD`FZ|KvCVv{Rxt#u0FNin_`wqes%z-jb5=WNe<M<8EcH=y7B
z`vyIbegXtgc{Oz%=PfOPc-jMm`NG)SMznR@<b!$9zG9`_EGzNnar9ib+jJ6)lC7$Y
z>RT{pF|GL}tNIWxE|0kW+dNMQyp7w>^-6-M(L!tX9{GdQc3>~cTKgu0=Za|#4BEw|
z--SdyMKP>}u>k2(VEA0E_R^CPEy{6NS?-?KBGig%^T4W!2&nJ~?Uh50WcnxT3&}Is
z%)5PZOK-Oy8DgI@1;gusg5%J!dX)q&kwbS^!3O3Mnuk7Y3|<#S58gj^8s`+Se<O;R
zhj+fE=_S*Ep!dJEx=PQcfs<<N3td_i0)vCyhE>*SxzsLLHgCH0JScNG#|4J84>2;`
zg{{S2YB$=CUQKzQhNK7vAj1d?fia`w<?9^Zp^zu+(#XpL;A*>;X?flIMtM6!;kB;X
z8ZVV4GwnuR!xK#1LAuM-f4qGkz;9gF=)Tql*j+vd=!^U<h=<Y8jmi{;0I|4b6XODl
z8VZe=(4L9ZuZv~{s}|!H4LoTT4E;Rsf#S*zBNDqrBVlFHYVWejs}juB4(4*E4K|BY
zDAzc!di}{{udYhC(e-vlwMcn|17vYE__E<Rj~z5kyQ@TLh-EiS=gW=|me=g#q>vd-
ziMKO8r!C!nCOb~Byr8kL<(tpzx>Jof92G({j3Uy(<IB1P(<r7#JZN^w@EypwB8J~{
zWqdAi+sZ=ogV{2Tip?g!7HVe}bGl<^HNn+`q51{9&*sW#m3OhlFk5!NQ_<8b(}~(?
zB{j7X+c+^XQz@g5nCm_61~MBR_HuS9rSY7JJvnaPB|3B2<1f@6L`-)Tv`T$u+^xxa
zP;F!}bUB~xi?e+Ml`*CCM2sDnW6!+fY3<m|qXk&`4kUmq@=O@rC9_6ce_5i4qxO$f
zydODOn?S{`+v<CeinW^eI01oMqOO0SB;q?iiqW5y2N44ZizxR5LC1PTvaUvDHH~kH
zbRDJeynAw&mw1hNgEsuEN($p$yd<#BHP_<RxkHXNRkyPE;1dSeMGwAJMnET5(5~>8
zkRtSJ*0;xm<Sm$a+zLFNcNjLONtR|3Xr|0OTi`E>(lsi-QFF8yGgl86dpp~YI@0x=
zx0H0BMHow~_0;LWddTQ9smP2trRh$dA1oo{Omuw3N5pFwKNEMniQeG=>xcAWS6_b2
z*Vf5PZGu*6RfE1>Cuw`;W?{}>-5XtKV|+Tn=9C1!_uj(u3)`oI#4Yj@$2~$p7IuIu
zA@10a`(%PKm#HDqlZjj_c=r$)rk1-JXI1fRReFsVjD~u)55*c^AXF!~9SsiZ*U##H
zvP$#)81nEBx!nv(!X5CLQ5a|VIp|FJ3d19&Ak=x!zh^uF**NPj%UL1LU6qE3*u9Yg
zGyaF)zsAS92I*CCS3F<2?ubS*GCg+#l9tvfR83-wk^HeXP$!4(?rST$D=#Z!XS3-X
zG^XCa9dDb=N;q3+TrbDVZ?N~NOKy%-Fi6i@-Mqs<_+qt%&4>n*W_XlMmE@s?frEwJ
z{tQnc&q%6l6nMnLA=yl%zrwnucb|S=%FOBFSdt0s`C=Ux<r1)U6$>x1aaKD-z8b2I
z&#tvoI7l})jHuK5j2jlZiP^R`4tM*UmC8${CWTEwZd*MHPPoE%&wc(JWx<>|Ij1C^
zVdO}!Y>YmElFRpbQoxH?G@2Jfb>U;lNB*16?b;BD`-YbD6=SuA2~(JxHnZ(C=+fC#
z@zM_Mm1;Rb|B*@Q9V%2|?vUk(LE-n<*BN6LH@JA-EyG!CT~_ShR+Ocdn9tfm51upE
zTF=ifGX_n8X%A+G8ftqpT1XTPU|%blz0TivOD-Mfa}{!}QneZpVip+|Vm5eiE-|S%
z7}im%-W(&2!A(6K4a8V*`hPiHwv}z?7+<#SSjCO7S-I{D(h~Do-O=en1-v8hDkHPA
z7bm|=x|pYBPaka_L8llaeOlf;d+{#G0HaYb+sx|@)V)i$2=H4QB3jXJgh-eeVAlS%
zk^)d>AF?HxxR3glakshO(HDSJXQkC@L~%3Gh2yr<)fDr?iJBYRE`=LkpCg()c@1LI
z=u8TzD4LB&!yq9QTLTz_@!9%f+qO;Ksc9$eRkuu5iJagP^5lSm>%Ly#bReGI)S`tb
zMzMlY<$3N?>6f{Vt}DIGB1?L3ozi+21DJGcjFcbQ(Ss3jj(s@Nmb)T#g%Ts_vdY2Y
zg8aL!ALCD6e4%5QwC>rL_p$EiBT8Pu=V&VMU~k$MvpZi_qZN}<TOyB`kWidx>&6Ws
zZ)Th!bK$(%HH5bLa+%uW-F;V0gZA^I0zP+y>&ID5Ssp}Jr`K71-?_=iotVrf<;Y7E
zOb_IfCr^-KTg*}fi|kM@*$A~)*pTYKZVP;Q^RUr;<?B_IWRGAj_SbWVdwnKyQpMEp
z9+U>Ps`gg=Dg8BOC;WqEWF1KVV)Q7ko^83J_%`-hxoT9I+~W6m>IyTJlChMVycXw3
z6k+`mjs{b1nS(4^8wtFX(+BDM0`~M(DE6<|c;Ut(JH7n=Su9u_3G8KH2WC{(7_Rbw
z#r*<yQazUz4`ce4q3Q*@4FF2pK%&}c++6bl3%Q1aqDDj)W<~!I0iA7s%d-rBt-=_#
zvTzrFJ8_Af6O&?AN9i{M(#EHwhO97RjYH!*qsRB|l+fkwV!dm6rj4a)z&Sd0KWus-
zll$pGrKP>B^Bzgv?ARmFfsDq7Z&<~7;&a9-xB*a*(+xF=o4Y!~)C~_mm-WJl>>T0N
zTXZ(s&`sQ@hYhWc8a=E0_eA?%Js?k~vZeUi;@Q4|3`!47MR|F?yL+PBH{&uo<Z^X5
z*ksGD*SrIks|qkHW@*J8Qg)?WuTC5@;P$0v)c`GoV;E;*Cn)Mx#=4s@7dz49pIwFi
z*p(-@gX6_=U{>vPFcpj!?qw*;{eqj6-(9|PV)z%dn5L?m$#Okda^bN2FktgcyT^Td
z>H^Hn?G2N!;{5DQlbSikhDWOj8A`pl4?{B*F?--aM=P5tcX{5#Nk5(4<Z~SUJ+|3k
z3di6>F}HC?)mv{u2Zvr>fT3Wt_M={khYB^#<7)V6$rm7^JK}-qTFXZJ;{FbRDzoN#
zG>@N-VgBf*!Wnud0{hSb6=6vD{%*lfB*O8H^Tc3D%c-_WSLv0eQBK?Q3!yNRvd_-)
zp4GMpqoXcH-<onr$jZ=Wk<q>ho5vf+HHC|s?ZlM|ILkSXbX4+Qgm2w+C?ZPtP^VUH
zq20Lvvjf@nq$&QG<XMk8rKl4N?r|JkwwchGTO%5C1`TZvC79sLaIr+q4xNV?o=6L&
zFADjwvoB$bwEf_*PfC{xmE|uaKiV-|c(xYrS@(9Vv-mC4E`S>C3}q){r|NOz2rpOK
zcTK5TWcPSvq_7_)jx8@AmIXWH9117tifU0TGe%~*3dmgU^UH|QZ=u#L4*T%NnAKA2
zX{r9|S`e;dr5N{eN0ZyQ;pPX<1ej0l&aF{v@pb`yiO~S-MoT+fbKO};^~XCU8E%C)
zYgUCl^2O_0pmkRe+k8&Xrz@pr&5g}QM!1-+dEFfoYpiR?`U)K>v{|$ex$T=NcNJr*
z0nwebMsa%fmM-S7kQYJT?VRSSOopwB1HsKQk!b6kdnmJ8s$u1mg*Y)Erszru;(LO*
zTquySmjh{f$^7XM+he-}q2Su?4GO&UB6R2Bi1n5o>$z(4eQwnr#$pE7SnH|xZM1W*
z9agq8wobLRCcC5^P;X_MuU7^Yn#BZsimFQvCPWuTtZ)ryUoSqT=lZ#Fkn(|WdEIPS
z-y?B<Ynd<P(;|P*udU<$u}h=`B-J*rLhN?09^MLHW{shydc975!+v1qu19F8eG=SL
z%&M%vE_ZOs^^Xl@EE&ayiRzw`6-nDGZl(TUV2>66Ky&c^Kz_Z6r46OIl}B~`K~C!z
zQ4D^#n{RD@M~`h}q`#t;DBb0(#lox87h5-_4D9bE>?P-$6_Z8Mu&$(Zz^|rW-1vT?
z7Fz-5Ad5T|&b=tR8YQ{8&F_=e4w)GIS2~~S%`tc^x_%RcTk2lJ<o-wnl~O=@cNArG
z7lMQo(x!KYZ1IF{(0L<y0q*N}mX4J4d1<zvDr4QKU$tJTVmV1?w978$8TxVDx(}gF
zZ+mj_Jf*^^Y)^5P+Ho?Eoz_%NjqPfE&{?QDY2C7+w?2>`-~(B|ztA@@!t&rPNn469
zRC*1_NlWJ_W?2d>_%dIyTa#O&=-2>NpEw-f-3F3McdZQ^dur-Rcbc%wi-1Y9bjD`r
ze}uqa{E$Oph|tid*lw$HuPikBO9+=%h7Ako8j%jw3`ix-N%u`h-~7xBy*HT?Lm2Yw
z1+J%P>|f1<bPmr8B-(4&RJl^;%(TwM(zvfUuCjQ`H|*GHDLb~C*XUYRca7^*k65nR
z?La>SdTYrO6JE=MUyIk+>o2P$=e)zOR@A#-Ay-&a$(Eud`$w)4MjQI98jdnW-0kFL
z+So#_;tL&b?^5{A(U`aoYB36!zZu)%<A>bcXGtAZ0wN~v<wru`lBs|Qq}ln9gFQd<
z8O@Ya>0^DFZs48@DHP6-Da2jObKwu4oeq=5RavCiRV5%DbIljKD<s~Nvg!V@d}nq0
zTo6trN%*pnBg;QzLF1J_yZeNR^rrg8MECzIGh>_1PXdT-1{mG)nkzF|qIfW22RYCN
zk_E+Le2ZJ}^cPMCaToQ*=ose~*B>aE`0QuGxMUrC=r!z-A*!X6<c^h;<kSU;pst1F
zx7s*{_*3}{G@0%{`wMYRo8d1kBxbKo^sR0eIwTAc53S^{FvwN!oR6&>PfC{RtIr*L
z{Q=v}{(E}Z@$7u^BFPl;$j~;G3Ftz0;LeU+@nF{kLpD?WUFr0qhVe@Uhu<l^35ihe
z?X9STxUKn^UA&=V!jQuFvsVeQqB`|kE)Q1OdyV|q*xay-t*4Ddys>I4=xo%v200NQ
zNP(PTN|EE(qzPsN*u}{w1iJ$1%o^3bPEr#HyMk&PeRjw49R>Io=Y}${wbMX?{@*iN
zepYH_RDVXwg8E+>to4RZH3ph^T<fTEoj+)5B8y5%KF~}_5zp^w*n{uJix?8AFn3%s
z9InF564?Yw)xX>l+I`QIIhWP*_?|wmiyqKjy_0m;t61qSR2x{y&sRU|uh`+2AWAnp
zFjy;`W@49LIAAK;MMJS{{V<sYRx~u@+vmCojPN}tJJq(o`~AQ2H^XBw#D<0B{e5p%
z1rIuqK+fW7wJwWa=vfXkO+Ij4x`EZRT7Cww^|MxWrT;_^zb{<9^BR>njtr&}+7LrZ
zx#FFf13fwtRW^D*tWQmf`It4fO?|DZXPFwDGjH3NaJ)X`_iBQL_n-eb&mpFxH4gt<
zEbo7O^#<xdMo`~hu>4)h{w;idn**p9k!DKF`@4zqlS=<4UoQ$Mi}2>{p8tnca{QIy
z(m%>4%1d&&{!7E&ydNz(Xe}%(Y+Bc+8u?AC-4y4$ldxEUb+6;^`&&2u_4SSd8U3{f
z3L-p%|4^}geD+d7K)E3<uuziW_}$;<^k2lL&j5Pu@7DN~_dikb&-HcS4^*Z24xf!a
zd3?eB&$s(YaY?fMZx{bzs(;M)|JPZpV^J`!^>hyJfAS}>pQ=sf<re|9Z*fnHzYoy=
zMp*hLk|Ptx3yy|)KZ@Jjo;(9i=`%7Ez?lMX`9{!9mi-SS{EH*}G%o<vKLLf0ng6qp
z`4<N&L;{QzIk~U<Ul{PI6j1JTrBcBC(f_?=HbsD=6<^Mq{kL|>fch@Y;r0QV-^Tq*
z1pfKSkK+sg+i)g1?7xhd?FuPS(Ds~LL;k-EB=U#g;qa88{V(nQ?*#q_LjUgs{<X+{
z=b-=Pz<-{X6aNpE@H%h|>S7pSA?)7qTJjsYw_fo47xjPooUq?uzK-4YLLZ=c!HrK@
z|1K{g`PH)#K{`1CWePof^l?Yu)k%*3L?P$|J4e*l?!dnrE_e3GRO|0)jBuaVleJpJ
zZ#i0j?fqh6W&0a^7?{l1bBYYkEEY=>3AXtMY^ZAXUZ>?7@LJaZL{RMqmlgib#qK5D
z--H!;&I!Mn6Bwt<OurcLhq0#%d0ay+WGf{VO8;0$7a_2t#NbyAi55O^=t_tw^ghhn
zImordM3Gaw$Nq%{5HC=X{o%OTa{&O^$+&&oa+U<q<RHa*#M5e6xyv?Z@~gdSK7BU?
zjoiC@%I_5kRi39!y0EvXqF9Pi>eQ1p@!UgXsZegMp;eX&GOIR8w88ge64i$g&tvw~
z=Sctt;_A`pJH}&E*xN(KsI}959^<=vR?9$<bwaPGg>I(&tk8kim0K(%w|Ugd4t?N8
z%c2*DdDj?{(8P}dbrh>9ax2MRg&vnR^W8cn;PtMB$zHn!EXkLd4PH-lGan}#ee@4Y
z%cbn;?PGVz!zImP9O`hwS_a`y>b9Q4*|X^-nZiC?pCnz{euTCLpEaAo;>$*bu9fra
z)Vbw5jOygf;mfxB3sJVRJJX_rN9K>L8H~flj!z+AC7$M>SbUwSf9&qImESix8|x;r
z>)b)edn-uPU@e}dLpZP84C{(E+NpB*<Q#OC1*-cXp2l&t=SsT$>2uJNiOKFQ%INJe
zhe3GzKw}uF_~rX2w)b)G<;M5lu|TslWvF@kvSdb}H3w_%s84BWs63umV?~`&H8HVu
zx@8{PSUB0^_J<3Jlvj=^Z8kvvDQX<ovwjj+a$r~=crwT^MF^Dt<O?TCSK)4@uGj>h
z<_0DhyfmZ-J=(yQ+eCq=W=6BSv3$~PlED+FIb<izo6qwmS2iW;dkx7@D;gkdQ(`i<
z@nu}^?r7G`8|6120tc>)wCqqT%h|oHTc{JxQnF#s&OIu#)bq%Nu&5w024z}4xKp!t
zu8ZCtjif%N<5P=)Sv=H#-*XI`fvuU0E68!Myn^<D96a2%H#DBTVkW$X)TjyvdOyuA
zq-mW+#t^tElg_Cz7P`b9e$MZ8)D`q6&xA^}tZ^AD*I>6h8DXFu&go997~x8^IGks4
zaN817V)90mrudq$K6FYShi=0X94W7?jODgB2gg`_nQe4n(HSjvWZus?n@??b()Avv
zS=46yane=+7F0^qmfx{^8KshD)|X=hTah(ZyLL~lUuhaOr!$JLXw>=oG}wRC+M6@-
zUCj)1C-{@dK4kVu0vM<_k%S6*8=Rp%EdP+WswaM7`D0qx!zx%-X)xWZ-5#?ZOr98P
z{?Mo}<0c;ymDh5nSG8*Zle`VAmMrFw_1y*i$lq|F!j%Ai&n>UW<vu1573r)8LJf+w
z8l#Hymsa<=V6}!_YOm#F@}#J!8ii^HF9Y?GiWAnC*#^mKZ^wXNO$)A}7iJZC8Qoj9
zn>xiRZVTR%?yu|D&GbTzXL*--EFCdX)~b?nPH<`Cjw<@nQw)Z_iXU5F7ZgqcR^H{|
zR?TBpo*#kT>8T*Hv|{x|*|+5~J4HS|WVc3_e)vd^Trl73Jk={T+(Hi>{c7Wx)#}s7
zmTQFa2IRD_+$qf?+RH0N+LByR8`kUq>L{vLig$+zQ2SjuOqFNU-Okd8ZpT;hqGE9g
z2$sR&eS@7^mA->NMk7{+hM&RqoW9+M(I5H$a#$tL0#FHAlXBVZ#|XC_E2%Q52v4}f
zXKOoHogfNtFRx;%OQhsrMMjO67f?Z0ha#W_qCGbqfs@sGYKynLQkKxm&3(<V1@|Ox
z97_e`eFi)W5YhpF7=~M0;)ORi)GJqt2P+%U+2We|Mebw|?&7*cuVllA(DqC>_WeLg
zr4Y)N-_Q_J8vv*R+%E5<{bLH1{sal!T?^{a4A!@c3*s)6D1PZoP{_%Pvs|jY5~!b?
z50ke^H_>+AVq!$8XUfZuXB8ItjPxuFOn?d=BXk=T>)dnnRjTzxEa$Di-v7{gvX}JM
z_Y<`D_q)#*dYitrwJ)DO)kC}J_ul!govX_(zP<8ESO0XL#9_w8l?1rEkS%?3?vryt
zAvSGM$EGVI0pR^Su=7&zv3XTHdv9p5FizW=U>5sG|6R!ze!k+F^c}|j<h=ae+8cq}
zo{OR?rRE<tX3jI6tWxU%xh82pwEQARn1(KFsi2_?&fY^u8P{W%+n$#4kzRPiuD<ao
zL8aNY#<Wk6afdq0CTgW!Of3mv6K!_mtvmFqoP@*Eh?U}i<znZ@UW~tV;z?38K;cTE
zDTd=Lxe)$`N>zfTMiCko>`|W|NcT7>Ax~(IOLbK{LF9&AvPZq$)NICMCK|o8@(5%!
zqD=pgu8Af7imTB>0A&bsDW?SQylfhSu3({*MnUaA+KHc6b1H0kofmg+v+_!U#UYky
zxfru$Wpk|2rwV}c6d)|DbzHz@liAvzZ7B(M9MEIpoxQ1Dn4hOUo1HRRhm97$AwP}o
zL=C3~A@c4`B`;vR2Q{^97G9kR`Lwi1)pT${fvwk?nY5^Dd_^tIe$DQ_US`k|7rxRt
z$Kkzza+GOkr2W9E7s_^{{$WfCrueF*rYc*f@-e!xT>t_U<QI?Rj@kHtHW%WvFUX0M
z!{prdg4{-u(ZIE;chIBT>xYBY&monomAS0!j>V%p9BXHc)cRrdeFV7BCG#0+0M5ma
zh3-uS@j&AiC>zq_n~L@5(ZF34*>UOMb(t~mDD&v4p<TwbPk1Sf(wWQEHJv&(ITs|^
zVgWAVxsrTL)SvJ>eUgdBy#fBFR9S+HUrp4l6$Z`@fK&3=pDU8G;$K=>N~*RSa}pY2
zMt<*u*rp_x^hHr0rgL&9BNuGKeyEsPr;^swCac#0!FmQa(Wxec6umsQ_c)?bqEfpj
z&Nqu<tb0T~lhef!nY9$?mbb5G@$HtejFJEAFjG(SbBxKyV?2KJfHb|U?s@h&cj=Qd
zt|U04&_dH5X!kkVPuNa9-HnCT(ego(RtUKL+ZlHU;Or)7?NLE;$h(G;qVH!Y+48pu
zUa&BD(6+o8uZ^BshrAQ@Nm8g{Y8@W2+IO!D(M>)gJA06NCp+^pCuDfXIBo%qm2{$G
zKCN%~dmfz;V5lu$WTHG476UK`IU${zI9EzHg8$3d5p67&8+O4aFS$Zvexemw5+s-q
zEtodz-eQKzR_++5InSXXAChpr*OwGM>f1xB$X+PpSL^L1)gfVj=$WuGoe3lbu(_aT
z2^vC5FMqA?6C|eqc6K=d<_QY=byre=RCTr9WF#2mc!_7Ib|>ds_e9?O1gMz8{<OIn
zMsbjeHT&@zV+0(E?Xwf|#ZDg->?_{=%*9|3+Vkl14yCm(F-iTd8brcFA*{iukaLZ3
zzC`Pxhz63SMryEYbQa`)^Ozz7)a9Q*T^z^m=3Z0ZjfF=i6kkt_thi&Uq@Am(mH{8i
z`T!X``oj&|Dy9WSexenR%J%hKzFXsyaoNyHKqxim1_@q0mHp6h3ht3K96@k5jRD8x
z;JBXJBJa_CvPq~qHpPGy`zJ1D@G%4g!18C@Hbg6kXI*Dn(WMtcmn>BoxR08ViH;t9
zd_APO0PNRl?R%v=baMChza(RnkG;E>NFlU5Pr^Lviz$L`>IUS2#M8f}i7eo1YleLf
z_hU0XkFC~o9Do+}E3dfqn=Zd-odZ>5cQi<=ou5DvC~m$|eqx4{3N<=1&`R-@F|_3C
z{K`yv5Od<tu>pPc@-Y-zzi0s3^Ko03YUZ&R%|fkY^Cg>vN=2?xZ08jyD&Fp262y60
zHEE(jay*k=tU*5(K$VfW@Qk=}%3R_njNA`P@;e}BzhzF59beUNXsvrgz1S<7jIIiZ
zsf`Q<)^c|_C$(DNV7b-{A_E3F?~$f?Y>*kR0U=;(Z)JN7%S|%u%=?1jLYct4jJubj
z5r1GG;plm|rBkU%f#*-ehy7;73Ij_Ntl;@u$Brq`pTC7F0f<J~9D3BpIOkYDe)&G-
zG;HDaGG8zK<3E4>jICD#Xj%M58}wIe<mHn3`Uwe%i4<<kk$Rp-k-0rq?7iZCniIYn
zbp(u^IM1;_x?~Fwx)PgfsyX(2)d|jw8id~lHknnKJ^b;X54PFEUI_o}w&cG-J}a}1
z9ZqwG^!~M^6WOQur%)$3#$QT;t|;u_MFz1GYKb?Re@QfYbD+!q_Wn<Q`AB|6XPl&~
z?Hs;5-6I1O!?VdV83%;Kr5#pJ-q?%3nEl+NAH4W!@Rs1OeuPm1Pr@?x+<U?@X%w;~
z^VS-2jfv)!;u60+R5te?@i{944UL~n;zvsIK3w$=q+i@R_QXX;snnFS|88<EyDQT4
z*Qz@w05mC8DV2NvSCc4UoERa*v)e}`XMEW2tdl<VCaUZlP}kBbzx~D4<R1V}S#r!a
zn&GG1PHiCro)mw2R6XC)5A=v_aCbtp*jHebCFK`M{*B&RR+xMHSBoSkA<_x|0;`j>
zJ$p|?B-^q%SLo-z0TfKYuNsl>eR1yCy?^4I+*?5WF~}fE^w*po<E3A2a<4o<B5%^J
zmVf;3uiu3Sk>Ia~k0I91YUxlvk!`-9rA75b#{ZsWr-jNpCq0n~p4oZdS#i~7sz*t`
zX66^G9s5MzN}@=`VYL3qye-DX&-}ya`c(hHj)_fk5dWn*IO^Ch7fK}o)K2#|iJv!(
zE`JWgH4+5xgt1cLShtpzY*pd~GJ|0a1!m5+2qIr&3EQz5xea76NcIPW^M$yj&A6i!
z^R*Q<vfG(x7D-wY7#GvSGU{NNI>s9a1=VhgI>Nz?D%4?fVTlwKyof`l@UhIHY{V_n
zpRbc_Arp2O%V}>{O3Y2aUK>uSB_JqRVS~K62H6Xshv>3^(A0-Lk`H}8U2wq;6>@QN
zml0v8S78oUiK0G7)alL?KiL8hVxk=3(USct9nev*ju%;H+lEZbqifR<?ETcfw~`*P
zJ2IknCmJr7xd=Im=ap<Bpv4v-V!edtq^)>DY+=x{eQ}G`M|F>J8Lk(b&b;sLaCvfl
zhxmJRGUeVl%t#spOkl&1)RL(TW2jq+cC?l}Ph8=Lq*1L;pVzL8db$J_bs2wekg&_{
zZYcR|s_gKKbMR81;d6SW=5IyvIE}qtkFw?fLqW<=ix154@`SOj1matmDZXP4wl*5c
za<=As5Zzy>Hi8_P9Uc&x#Rx63)4xe&g<C%c84$r2UArc+$O%%^tzQpbB`U2#Bl)5Y
zYjDbrXHo0HX=0oZz<~SC7!wQ1KVx>&TG}#c6(L#rn3h&TW0K+}+-iGRA5`8sv0q;q
zNYb=ky)+IKqSn*}j)cWw{W*E>!fOF%e6H0-)V!yQ3!NM2@=Z4_uiPCtB<gkULrUpg
z(4=%5dD27ew3gNP#WJLk5ikFO1UyL^$u+6^O)XKlF!P)PjtZsLh5xj*<(|fRIP1U{
z{sK2*g{Q#rcTCG4J|~`Gy+D4j(YTYqYy~P}X}eDt@y&L3UC93C<7*D0dEi*nG9h6+
zuGB(xoX*v^dguLSUQ_Ah<SZz`ONjSB-PXGV53x7m6nVO-MriUKf=9l;GvzX1a3uLO
z&%vkh5ESF~bc-i^pj!iKCS}<HW6Ilpv<gO>pSn6hDA0q*o{KJk+9W#|Ons1rbRgWp
z)P)`54g;%)#e?4k7WW|_<f*9ZwB>?2Js45_Fs*qYHh3s>?cUYRLNA+y32SzaT|w#o
zGcG@^-^kmOa-<la!xdhQ%c_<Ak1JAoCmg0qnJZxO%h`RtS+%u>4}>cy{+t3eXVKm;
zR*jXtIUoIrgQY!0zr<b(POw(%q;Oy|v5@#;Y}%2Pe<CmX;jtjl2|v}d+g@xBTxL+U
zSUI1)G|=~wsM(z&p(=~ua?|Fx18f6<%XY(w&1;-QaV;Z~RY5pb+s^mPr<`4Kjl6EO
z9{9P%x;|WGLsZ)UY(A5#r^N`HH{;?0<$rzOOALS67lnhmVk4p|aj)|b+x@FO?x<;M
z>z9Z(Wbd|kK68YJl+K_0YZ-_0_{p<+57am$?C$eD-jjM6IWTMo+Ax8jq93|1MFXoC
zf)QVn1IRtKH?>AtLMSZZ^!?s&VQX*k>m#~{0Qgr4ope&fA%Mml)V}p=;Q%(`T|Wsb
zj-K}n9|{WcYx^REgqXRXVIgGc9NCYn3K|2`i*Jm?OZLN)x3gTm7r;UwSlsSixEB8+
zdQ^KM9@2xIQcSV6M1w`68#KB`>Gq0K#=xim!-D?Zo_scXl9B2^o`jv@NWcFpxXGdS
zY<akZu%LkQTIOH2vKAvdFo5B6h%6#XRshN+&l(}T<%hIv+(^%FQ4{G}lE+PlvcGl6
zUzWv&EIT{_j;-chlWTMR$qRtY^(&&>wqdJsoVb!8vZjP_4J(H@qA119-!#~}ZmoUL
z?$4AIC?3et*eT}U?@qU=hGAs@+gfk!qVyHD3>$RT!#bEp!_5)jSVn)zQZ$L8@98XY
zM5A>3jVH6Ws2Wt+7|0rbx?^l_NgS#NBiQ8+Zdg0I8K`$N)@)rOe)$Gxs&K%F5>Iw;
zvM|qcD++nca}rJ+S%a2AS3$MuQm}M(yv%D5*uy&7d|-q9Ob2MIQxLj073d$i@yi4N
zWNbBCZ?>Pg6TX!d-^zDoW125oxV*JXWYm3iMS8cen0;hKvfs$0v}D^mvD^J+CR{7Q
zs}TOCyvH*qM?qu(aS&LMI8$_UzZaXmy(}Jo_mra0&_a^8mThf!b)b)N?!L0{TL2Gu
zH1@_{n$B<hVopv@Z@CTfXt1Z!1SeuqgOG!@Xb@_~N*$s@A!c5{C<yi83nn<$P}Y*r
z6k?!I0_#oN`)Me~<y{p1@CQkFQc_ZiS4I(#)ZSXM<D%sInIDvK$HsVIlDNzJq4yld
zuNEt;06B<<YH!`0P$Ojx$n`1SwYA4=3?YEydQES)JDt&cS9`WA;fj!}PFKBmUgeW$
zE6lC--qUThRy<8FhNU})5D6G1COeI40qN3;b74P+l0o^1EK;NJ{%UqzqS!T-gPOsl
za6WGCt+;o#4P$CBkywDWrdMwKpvl)3HEe1DD+01!j<Q>xr#{-1tw`bES(Dp+Ex&gl
z``zTH5e5urA>&8dPE3r>Es<TNDrNppc2XX*b9{PR6u6W~M|gb!ahJF_EW}Y!rtio@
zkJ@yGb7~#c*%ubZj{gvUaNAyGL3!Kev=(sn5NF+@zP|`7cfA$_&4k|_%)JjTAL8m^
zSwqaegj7vXp}mO;yp^t+fXL_jCGro#ewfQ9^t;(pAI?W(GwSBGh~C8wgzCATlr_+^
zA2eE7ll(C-Q)bXwNmdyGKQ~=x6-unnnRbkfZD=uqz5WeH*iA204amQ2FE20l3aEQg
zWoO}mN`7xfyuFX(g&&Oc)c3z3E)@3^@{XTw^Dbl2Su9|xqqeu-)8rSgRE(A7qG!&n
zMnnrk>o;F68q`4!h@|Yd{ZWje;@J@piMhJH&Tf}kjE{dp_lrE{ux^w#;%UuFIZY&G
zt=(f6Dn*l5zCVdZxaNc{MC4VAZp)9F=*G)cXcQ4Gi&6V)UPSz^JMdTb(8tF=75|aw
zbfoa&go@kIQ7>)XgN^Ui&Bnx5U$w+($BVHkcb-d&k<D2gr<wxC4>iV0+|W8$F1xn0
z<j&z(LX3W44vcY&!Z)3jr#3ZyMC6rBo37ss-Xp2Cw@Lqb;BxJYD-wiHv@;=F$zoN9
zJ{F_Ba=w?%_rPglKLTm84(&e1Rv=Hw#+8xkJdD2csOj24B=1_cju)`ovGvX<ZZm!h
z3b;=JuVH@)T3~<36Bwbs+=J>nQ-L_ad#Y17^j2EbRGGa#QDodxh9}I#GnxmmQv#>u
zQDG?}qZ>PG%Pn{cv7r^vXcQpm-*_FVeBCSwYIFVToj<|~z0Q6T)Exdc21YcXa$~qi
z4N<{u9XHLY?7JV=4{3nuF&Q676OSC{-FLKfUdyyOv5g$PKFTTa=U)9j%DA*Nun@~E
zYMB1IMIx#KW}HAPvO2Jjr~ICbUHaZqM*o-c`9qS9bgnBg+uI|_X>E@1>d+7W3B=+L
znzvmhOrX`0@WU(B*dpX2GJ6FGgv7i4SYwTZY38c{z5oSI5I`37hUAx|__-W81(xUH
zF75knGQ!4mW+5pJBR;DotdI!|*RoX%{>2PSx$BX8hka#=gyDG1@2J;qDycmHw{}u7
z6{$bzi!r9JvI>iiAMu&;&(+6>5nIIQ+;&sWX*K6Uy$|+fnXbjp1w<0J=SY|qKdH&~
z#Myq$c!&{tu6fA4S_rxKeqdE525Pl&HfEMa0Y@u{{TXu<<?aRG{OP!W@}0_>97=Xf
zYwJ}A&2}$*b|W3&zjHIw@(vCT9RtWOeqCgF@Gqx`A}tM-Ekx^UzojTjT9HOxRH!By
zhhnvGDXG_nkcKYotU5&@M)qPR8AN+z#V5&r45481JuSX?-hB<+ke#J$Vnb|6$tReW
z3CJH&SooGG3$luHXtDOcN*YAhe|FbW=`Wn)#fW;;%gtKkuYPksIJ8<j14&SM`gZSE
zW{TfwKRA;}JHDx=%7#Q)S-Fv&-Jl`t-@PxF;3Ew?1dL$!JSQ*&Fp;I4M~_x}W+4G8
zxD5mqz1nd%O0tGT5lE)&U650fARfgSU&Gu|6!ErOpDw!OHS@-|PGQ#=`@U#pv_W%v
z4X;E+#EIdb9Vx(7i79Sr8<FEjIjSlRhfg6#Q>Y!xL`@||X^Z^W(tIzeq5>CrTAG)q
zv})D)?yfLQK5MLP@64r}<-tvxdsPuG<*c|AKj_gdZf*@(*#Jnv^d72e+PB8!LhWzq
zT^~pzfyDYuCsgziKXLY~H*O?+GFP}^t^SakKg2ElHi$641zjT^(gEMnGHM0~h&AW&
zNA?3d9HRxVIFGq&KVu)q@1^#TMY1T63rV<IzS-enxh^8mk59fcRhp$5Q(D%rndMG3
zj&fU6uG<_ht_^fR581sop2a|}Wm0lub~uPHOy$-+eEy3M`-kL3vI7;i5eEMt4FG(0
zE4X^!0JVsF%p`0h0ugT$7k0<)193kGW<kSC@}pOa$By^!SZMmE&SlFbIVBMO5SFF~
z1LbL<wR9E&AuqVk=^l>WtTQs27bk4Joha{%G@)$x_A9dS^XcE;xB&ZsF)W%T5{g<H
zYY^t%9YtZO8#Y+Kx_lWZoTzokv9z4H;FJ8@-tI5A``4%5U6ND6;SUKTjyqrC$>DX+
z-(`g|)5N-JAnFgk6c29K@VmFL`WQ{%>+Bkfe|I_mX}Aa4&pwk!&J%VZ!b+Q{>H|BS
zrTVr8)=X^;;+p98R$28y9=FhL?2~HC1+6E=TfdL#9|(OQ_v3w`^TeY--=PL!qyEmd
z@l?n2tc*827UoTIvIrAR1BFj`9{$6l$GexRMn>+&#$d<~c*sjxR`6PPtEHj#_G_X5
z_k0VfDp+3bV3c_1()CNJAAkB-FM%Z1a|@E2am3BFgG9CNB`oo-$`+^P5pe}Wt!{{V
zzP7>YTX8@!TuS4?ld8g=t5|!>=eq4h$}u{;BGaoV#=eYG91OY1<une)+u2=Z%jyQU
z7x8V%JXKw-x14E^bJxb2-gE~`dR3@j)RB7I+}^D)bAv2em-|5w9gi~ih4t>b4n9gA
z%8s*VV%NIqSI1qu>mZ=r)%d%hBv-i?a|&4wm<Es(@u<hy*5)mf^HuJ5ojq%)WbwLJ
zQS5HRe@|rp6#)O&r_T!{NB|SA4^`}l&uJvM-QZqDzMpwTld|oJwMeS*l%;%Ztv6|C
zJrond`m}}dOqH|Q%TQL<bJsy1H>+tac9veiUK-meKGlgUh6_C{EiKgv2=JB({laui
zy!_+5p60y+Ks;gD2UDtYP~yh;jmVnqqU|bniA*8)e69J-7zbXx`)d2abfilIgUzGQ
zGg{a&aU=Ow$uJGp&Kj0myN>T2)dnsZJl)10jNpn&OC`kKZO3i>GTxs-Pjhf`s_jYF
z)YQnrj&2^D*f?6prxD+c<69mz9F`yVSWc#VE~n=39qP-~SYhF9yYqayhP?6HB-4xi
z6&A7R+Hqul;A6I`VbUn=(^a0%k@!P?5Jc7>#Z&oq?v%WQ1j0Aj10+7da#znl%v)Xw
zs&A|5&Ziu9rTDa^>CX<m@$!>oQ>U4d7uxYZl}U(8U>B7flc|zH2XD#GSb0r>=odDQ
zHt@kSl#hsl<;0b>wXj!e&d$yr#7j@uxsJ=N&!_!tSQU(+`34hW-cq+iIlQm$j?=LA
zHlz<e9zBSRuOEc!rOgnJ4D$+TB3W;L%9^JpcAJ1ZCni7w1}S{?NMq&FiV7>nqT7o@
zf*pbtvN21dS~pwXrMx@)mpvo73~aZZ4^hv1v!0xAK>CvOC1H))@0Oo6hj^<d<)bqk
z>{YOVpL+U&<mB9$$A^;rANFuzJ^9%PwUkcpz&Wvt@`D?Jk(^;!3%x~dnHk%Qn%L&M
z@^a@vli8>V8?}jQ2cr~Y&oqeV#%EaAm_u>hib99Fe(Ow+-O{_XgwT5yuW}}Z8t<>L
zzuUafj4Kg$Ktw+e1+{CDdens3ZDnE5I;hD}E#1N*v?)p3i3?1B_WsT#(j&jK?3dYV
zN3W1Zl9rN|5(xg19#D!>(nuN{QS%u7{p8IvO^?|2@u+e2mbD`CEHf%Avw+AODep6p
zp!eyHSJxMMlqb&Xh@0!_Sk=;6jhV%{Lv}-Q%v9c1b0HoTrACUw3!yxq(d7sERBfuv
z0tTvEDGi}zwfZeMT58f@2QBce-fuF5r@3yv>B-*rCeB~z8M@r2_kD2aDZ(RB6qZo4
zt*hGFgna*ea@MA=C_6tR;At1m+XVnGx7hnDyep{inf2BM1vyV7_i2tZz=g+C_;L7|
zzY@PS_?OxKLuGtE4UEO>;6=7i|6JeGvQYE!TUZ71i4_Pz>O(iAX_11He^I<U!q3zR
z(^m;PBDmFg+*Iu95{ZtwR8Af+pAnl~d{4@(O4aRQ+SLkdJiH3+Kz>sj;gNg4hWCO(
ztaftm_;;S9haVNOl>@mS`!ms{nNVk$(xJpAmzF8ZnAz++o86l+%MR-M5$9Ko64T0r
zm>#p)$R^m8H$d~xQf|fEm1AKzdSDwAsr6lmode5ojbZugU%LZM^?!iW*}_BCjdd<4
zTm-IzLjXgWr0q0JJ?}X4|3UNSEnuy=8@cm3U>=C*$x`ph@x898X=_vTC^<wse$}Eh
zzzv&>rzI>s$SYXZ($h0ZE#l{~e=?n^(Z1W0z65?ErBq~2(sCe>+ZqyHzzr%`t)r$c
z-+JfHjI6lP`07<mu2P#}_E+0Ws<ix6(X4l76HC331(hT09HRrn&$}aN?(f_esm;5s
zbS?a9Htpb_(v7VWU^)_jD7zIeB_n~Wf5P|2K;(vjJ&WTCJw);`Y2;ASL#Gdz`m{`6
zw-igx8^fb%KKF#0?FREmy`Rmxdn2Y0X?Y=b6RXTy6%ebSO2@UqD7EwCk-QXVqib%<
z7h=R>nD0j#)I<snUcRhgt1xMO)1^Y@o2F3B5En|%R9|$qe9ld%_?+N)>6e7MLA~4}
z4U0{(NISRO!@d$!XnEL$BY#N&U4QVOQu>`92|?0NQsC>Mu@svka4oKZey|$*vQ+MG
z$5hC%S(3DgqGYSY>huqj-7GK<#Fo2~I%y&~A-t&emFA^|am$yFh#d%rndZBv+HTmo
z&svvUQHWhbP1W8rYH(mSi+!rmRa}0x&?o}@wS(jVBqrX;<+?@@K<~A)4S#a;v$->S
zr^o=>uX&RJjLzYg(LiJi2ZC@PDKbTWIzoW{qW61uhC?kuh{K>$KeB^1a|u5}sCp_h
zF+JOHY1Ty+@p>lj$|7`72yk&H6k3Fn?r2mNt(&|){1j_dq+Kb_)h}XUH##JjgpLO}
z`AKP1u0}k4%%<lvTtK(K{w%}G4Mjef^SH;MLxdfe44DZ%+|T^KDYAc2+cTRc^M{N9
zt{*ZcQqtuSYuowbx{qGt$CTkZblkV+9j%|Y^N7C}q@M}6IQ;RNRN(n$EEC1UgROpq
zjMkZ&;(S5lV8Iu5T0;P=C!qPPwM}b_;fFbqU5w!_4ufx(Tr3`-D_|Q+D}ovy52TeQ
ztlMO=JZyH(taK`CA?ta$MljE$TeUAqXXUmR&{g%#4iLWCUg3AnNwbYosuZ!dGYj-c
zkYxv!9S*1dGs!cAYm)l%X%6`tXN}Z<BfbnIdij`$KjG&@a`%#gF?Mk<jd)an*JCw`
zzp^TrU&LoDD|^P0aX>;Sr6%X{mRKYzrLayJ<dBd_?K8uRZypNPzayeY)*axd-tS$j
z6rV3b&g=ruOH}#v&WtMlDo`lPmE$Czp4YV?A6S8eY1ah37ho`-)T$=FIxkWE)yFaH
zYXO(G4!$YN-rHFwXb7U6pYL&f<y2e~`Cq(nXXVeuhba1Qi?0({e3*wv$p6#cmxn{$
ze*Zs@2q_Vgtf7cxDP*6@&e)d>h9^5&B4ljOwCO3Kv4rev_N)_GlQi~yvJBa>jD5}i
zy;U^z^!fDf?{{4v??2}4x@P7*_kExHobx)bbDu+jShPh;7oEF0v1oO_tSV3v70014
zv|Lq+Uk8mXj~I%+nk(K~TzcE3;|Z<Rhc8c(?zmpYLQh1NnFe%$W_fYx@M0XxhBr+9
z0l#&@K(wxAo_1cUV`CBiQkzhSCD+r-jg2X_!*;VyNf_#cK9gR&LvSzNS9BAtA5d_^
z;+}ZbTzcugCAx0(O~ohvR>kYEd6X{aH5r#C9NpYzF4<u|`<LU((B(3`vC`yJ$hJ97
z*n3#4Ih^BktfyPdilo#)!9V);_Bn?rHf{lL2Dn?+eyIBVwk3$A?T1Ae2j?^-?~5uo
z>tI&T)#rEc(ZB~<SwkO2*y4^H;gN2Ox3{}W8!$H4vEM!J`mQ}v9pNA$)hY-y`lF%>
z!tY!bj}(~Zp#Qiwy!N<gCvY<@kz{Xic7X>m#akV=wM7cY3BR3Lcf=UZWqB~!oy4~(
zs22*I&y!b%#U}}S<J&#Om!G=!Q&)}HWpjG!Bnd+^mU{})^i4K;K3>eB7tg^zthaxb
z<>6k!z$ez*Pq|esYJr!dQS2HBfe0-beE6Q!C7{LDBcs?Z?ZG*DX_bnMnrwb+aN|PL
z%yrqqv=(3gSKMwtz-w6|K{`da&uc^e&8a(DOiJsrGiAefUdk&weE9ghymP=*Q!nSZ
z1y17`7d$6YplzqFVG4^b?@TQ%trBQ6ar-1{j9AlmjCAFsnR01X_Ftv{F^c?e4;ab7
zOQnrWa;2}>8eW{7nAV<nv~f{F?5{piw}Eovvd`C}V6dSn>fov)(M>)Q_q-M`(#gpr
z&ko~?QXIT-!$)#sMp_W1KlreOTIVY^GEE_SYs6+SD->^<s&Citjb=WqHX>hyuEnhL
z3m2M*iERx_zg=eZUT;dnPA_xT<_C<vI;tx7?=K=iLw^#dq(K@;P%<`)<4bF5e1;+E
zt5$vtO_!8JGp84Xg*P{kX`|Ip{C<S0gV6qcor`cdks!Tdk#V^#QI+T|$MmZ}KcGh)
zu8pCyIXtVFJd-}z7n7+Gr0e{ITfTx9TB?V|kOf=!oOJbVm=gK?dIKpv?)VV8RCLKP
z6}QrnW!E3=a0k<k9u>dzof-etSN%bRHe~w*f-D`d+FU#=kj3L8oG<+OEkpn2%@h^>
zok?hlLmA(C6z#u<@^!AiOp$3i*;{kAwY&Kho%{p04UcYDMI%<F79F3vZbdvs;D$R<
z_ZLGdZdcjArd0b)??KQ#_8|t+CL?}R>7CbT1-_}*BI9G4Ay(|dE%nLFUN^p|AJ1PA
z{EDxuh3q{=6^tCI$;KmcYqBK9&SZ=uJste)K1Rvl$2-#8nqQ?lEZ^pQ#;XQ)ptyIB
zd$>h?QfaBQSoD^%3I$W-k>80yDMa-kDr_A|GcB^6D(w`@e6YVsVlcKu7_48G$13g=
zf6XEGSRZlt#>(k?=T>LW@y~YBs4r2gu3z4FZTIlTk4qwuOmZD`0-WKcUwRkn;Jvhc
zAE6LAT-1LLOn}VXhWq%od(z?Jn6R)*_I=@Oc=U4Jjz%C0;-y0U%xvL6taNbPGoSFJ
zVUVdhFgCK30YGV&BmCEo+K-B;S|G!ZaQZIQ4@?wd2ecgABKy(Y%S8isi|Vl*bBih~
zu96FtWiSCO{dt&nel~2BkuGAfpAoUmniI~pApagO<$Xpob{p?u>ml5FUdAmG8&fB2
zZsE4?F_8IFDXOWl<T{p0lzc&??>0&g=hQA%uljA9Ay!$dE84%?1F%Vu?}@=A+$dWr
zf{U*jT141rVFQGqw&psmSRbHkCL0_}rp}sEL{Wsc1Sj?N$rhq(Cmf|cp(Z;Ey~E;|
zv5HIj1D`+Lu&`LpC|-L<8&STT`3M!w<1nptvq(ofBq6aTOWeBbsXhx@--e-_L|_+~
zcogX1NI_l5vE*ZW+S@6gm<S1xyQgq**^gMcAn-7iOib)YNbKy<fmlUi2j`vE0oHES
zs{p93tcs#kQqJ#vaCc_?X&-h&78)~f;=tfWMn}c9(XBq&96{SO&v(^}yU#yjR*u=k
zZs@Eva(X`MdNwJ+QIg<yNNf76k*NJ-C$_wcUb7dI=A}oX$2Kvk)vaa1W}rQ#Wk0Xw
z(X4m2rdYGl7*{8lKNgeK&1TgIbL~8iUr|eu5Ie?1_idY|fZk{$m1N0}$Y!6Wsk1R&
zd~>woJque5Yq^XzchH$2|0%r6o)f&ggB-#j4F^%jTNe3a^;e%rdtYBGQ;wK^&c19}
zCFc^get~{DICcfk8+cyJR=Gkgc8*)39StA39oXCTG|qyzy`!7XDiFnFFQtU;wP$U6
z8WvBjVuR=tIzT_I50jT4cWS{u?KR^O6S^o+DL8)2n}ap$RHRLS$b~D;xre49&ejd%
zHezv0ed59<>G}bVLFO%j2SpOg!=Cz??<ao=82!DAE_}}LJdj~9D-~TPHzzlrkhz`+
zTx6!iibMjnfK)p6a00S0-aMeOF`9v}#u&q*q}@?uTy7uur<W(|O`>wtz1!?^7{#6@
zUc)PGFII@_7<7aE@>e3K6kktNOosPm((_q2x~lS+Jk?bihwJ#dnT^ulby<bRP783H
zv}<_y?pW4YKAr0L5=gYv6J`K~t9@o|(gaVLDaB>JEY)${piFC%xst~w_qu@$V{8A^
z#q4Taf6S-zSz=ZxH*mU{0GPOuot!QtrfmA|&4I+aD>sM_rJop<Kgut%OioKqySBZ!
zg)TWrgc)S!oFxFguY`#NnH7toW;-w<f!lL2Yp^v^_x_WuH)BRAOdevlx5(E`cIH6c
z4t?yqZd>cZoSpU?TY)=b`W&hD%i|Fvw`fR|JGo$mXEL;PpF0;OH>J@$Q?tPoTZNRj
z5#Jx}O!rRE2v|w%34aYg!t*S{GbfLfNC{)pqmSPTaI?o4r;2O$+lG3o*?O!i7we>R
zG^%sgZ_tEho)erE<_yXdLYjLU6v5zLuwr~*Pc1AsUuUL-h(<9i0+M&FKUfo9uW_t@
zKXL3YaDs%4bBZ*HeacKIucd>lg|j7T=iw88ES$~hYgq_1vcr9dDk+NobvC}{IC>^L
zICFVtI>vBNY{n%M7WyJ3<<eH|Q#Gk2)8<#bB>G+xeoE`Zu4#4kcx<kj=)uRTap5=Q
zFF8oH#YfwDbDSKNP9KfH7c{ym^~7YON|*tPOF?RRG!~?vEq*=)$^9T3*hPj>z7Uz)
z09$G;ZR!fwd}0YPchS$%!i!kn#GGQD8Skn-Ksv`Xki68{3({j$l0{sk9%rb2FyLQo
zVyb6VJf5D-eLCHa;g#gZ$+i8Mr2lD192Fyyh=a2h(dHMbPxay$Hx2j3hA$E3udM@)
zgzGG~yUwr&q-q7dA>UAQAA47>dcK!Of>HLRvbK@dyp6kW-sV0(Xd5LR{9<)988b13
zP1C+xJ6EI=;dB!KjHR?16~F8;ZVw&ZpzJ3q0WUmfdn$8Bq_amFIxi#5pO918P5;rF
zK5~@P7&PSmteU6iIFO@)3*>ppnY5aDNGpnmGBU4I^osLDCGAVlidYDlR2)?WaeiW(
zP#Q+f>NrP}yWiN|pK5OBawNo#82Xu+ju^IkEwSd#A3aINS?#_W^4%=32^bIwvMRFN
zH14>smII)Lg9U&11%m);R`==$#LVKfIgT=(a<SVKj&G;44mR&Rz8bsMCm9;H0;+cP
zR|-njHeP&@f%YfkEQ9ATQQC=PRqeZbUd%+VAw|kH{VjEp=&tv0aFQO7&CmkbF*7$W
z4BZ;gyWoviv)BmyXfKE~cesZ%kD-+H-~$+zvC{FIkevwpx(SKvhCO=jPU=vBh55EL
zapg!Tp(w^f8c0!%)6t0J>cprGt%9M|nOFA<2Gt84P40*|24DxgRwB!{N72>#EXkm0
zMO22PmrK#g%(S-0nkk!2+f~oHF6JlC3it*@AGFGxwk!0l>nf5exiy(vNv42~a29S?
zEw+7<evu|E@~ol4QO-um49oQ{5#h*XZc@q|C+#A{wD8$#&=jYpkV-LN!Rh5*$o0yh
z&pT|;I69QoQuI$tpfEdmb|24BK}>~6u1g0=?tBv7iq+?znDM}@f8I!G5(kaQ=3#|A
zm%Ag%RtmCg(zd8^R_az!QpR?M3U>@-^01j4-Si#(S;m$lgKlEF-U%>|v}r_Nv6`Qb
zt-LTx$nf}Zoe|owDXTO6d~<MOnUWl@%7}BM%{6r?9zPifQ~32xai=*lOma-3B?9Y;
z$~WS&Mce+BY7=YM^BmDdRxgyVVGh0g=z&@{EP=W62@h|>Gmvoiz&uy76<$BbU~`xD
z!+w&~0}3kcxAJk2ILS>6%P@$X2!SiFVux$jEX4g}7S=#UF<O0Kd*0)D&Q#!W%u`w!
zrI4qrZk_3}!ooFB>yRYhTjp?h1vw`vHt?_!hz^S6z|y?+l&vcc>EevihL{E(VuDFU
ztVdI>ZeO7}@1VPw8=dzED3ivMD9bX%9kRC|{MYc}eN(0M>ihvq+0hip#+wDL&S{B@
z0??@zNE<9RuQF4;+thZ}aYn1Z_?TG6qfT9ubG+*QD=;GZDgtZp_s-EaVwf4^2!A$P
z3p=<HfKK#n0c9gf?~X|k_#0?>woeC?9?yI7IT%ltICMQ#6~!wyl?&$$UsCb(j0)pd
z*Re`n!cC%=as%P43cQOR+umW)a3Pblw6-*D(U4H#^>O9ES~J!Qe2w(7lwwFM2f7wk
z(H8ITPc?d#$M3dTPj4f1qo5$yk0<i<xyF-Wrvl8TAFY5?f^)C;loitSPon!D$Y{wz
z?#52uyrEC9ac(X#=nzWXF=9(uw(h<eLA;{dq||B?*00}Vj8i~uGibYzGmFD(J12WW
z#n)3e5jtQCZC_tCiB8Pf3Fg;f&UG7k%YS#j&3WY)WrJX6byJKJL>_37=BBFRzy4<o
zYYgjp4$@bHdLC_cjZLO%g~nQ*hG6GXksS-CMvma4;hnF~Pc{`}co3$OnH&=pN2}sT
z@-`g9pQ3Px@hX<lQmiPQU46zs2w+Go&CT=FVwDP>Q_HU}|IU#QB>^M!NX#+O<==sc
zuCMFl4M{gDsf9bQCMBO%V-(?hKl+Hm(_YQ0f|6xQSFLHhz2Je=ANPObtM^?&GEghR
zVwSDWPrBxR9J~r*W%F-5&_S2-v~_iBGP0nywvV3CX~Fn;y&CHA+HOTUdR<nt!=wbV
z@~cO*Up9S5jN%)UaLsE>bnlnaXN4oMw_b@Fas2Ls@ZAqO!lzpYW6QIX-rn~9bl`Ey
z)|24_gi(ecLCzQCA;3&*31Z|p|Jf*nu`w2*<Fs=H_xw{h<*J|E{>J`y^kCP!HHA?$
zynrmo?BJorKDcC{cngPC+ftUF3=i#z;(x%Z;gm!dc!Ek>Jd72L92(WsG(hYjrFv`d
z<nKP$wfnh(nT{Qi_9C}P8$<n_LEL)T>rblq=e0G2LHb{fw3Ecrh|LDtZ41RA2AK1g
zQ)i*EldFFC-^DP%FkgW_o$|3UzH6o4?a~pRIiDm@Q`0Lemv)U~dulSkfd;ef4MM>n
zpi$R6`>ee?=gpgP8}Iz$+l0dYFN6%-{lZFr3QoR{DJGk0RyaqS?gX7O842jdD%W^g
z>d@%?y)iTqrmhYy@#3&au-0$BjOrz^B>?}sh;=oTqGS-NHLZVq!jEfcIyL^)Ncwg`
zOUCLY&jN1zgA(!KWm^@LPe(}R*h-_ezJ4jQJS?6w@$?$ezAxCW&L$@2@rE9U!}0YD
zi?)(J9P^t!x>dV0BXedQm&!~ik)L-TY~#H&Tli}EzIqZKTM?DKA>_H-;Nm!W*8{8I
zeLmA^K^s5YQO{-B9dB+ne8f{6tI4QZL)2^ly1HuB%emZ4Gl1n6X{?DcXwNGb@ApeK
z)gmS%PH|_e+#2477MQV7ouLXS+6f=eSCAl_jXCm$51{Gf@YeeJjJbsWW`#^~Qb@;q
z*3q?ZOpM!!?mjQGbxDPpVV?I!SqEKenuOJgPa3Th($6^RO(%-AkGVJ{@9jwlEz!1&
z;%Y?)Q>*3>OI>FWB#}Mg6Dp0hFQ(m|^v)lDFq<mLUe;M0X2sCFU94T@f3@>+J@_F!
z#m8x5qJL*;byZ<$et2l;fzLL1QQ&xz&JU*ssfjKK1>LauN87<6;mN$Cf-j?+`G}LC
zUDAlJZv}%v_tUuPUeD!`;6#!LmSP<IbukCuRhxi8g}i=GD09A3G6$656wmF(gs>HA
zRgZ_)H~wZp8`cTb9(Da3=dB>hWrveaO*gL9DedT3DVm5#sOf3b;L%^b%y%Tce*Z)m
zRR%aKQBLjFE)^6$fjk^5^M)mzy@;qd!e<AtE?(P&tV<;=b@)@{2z@zK&ejG^!P@+J
zd)&6(TlA2yK1#Zj9T!uw+?E_eJuSs23=1`6A2=avG9U9!Pbw_dzCWt-fq5!r1Yhb}
zvq`N1Jj=}UG3gySbh-$w_3$a*G@X(P&1UIHeqOAkp*E-0Kl+9$xE}k-DVv!#GqF=N
z>e{^s58XmZImQd=oyI0py%s)2oi|#BP-?>Nojf-dArvBex(PV}%4jLE*+^9p=lN?q
zN#ZiQH`#GAUYU&n)2?DnAS)>WmHvl0^|O?9w6&wynVA{9dc*iJFBO!whv<O?rn_k2
z|4SzFlXBK>=)%pAE$Cd9WPDkTfw+fhaF>0W_Fu^=g%&EyLl4ZeME@BLsBYw`SJ!Qy
zfdV=tZh?cj=e0;RG3qBKlKOn$MPVs>t5G*|JDa!!1zov`o@@Ht&&WBS1++?k&d=ZD
zUddGT{{%Fo62ANNE&-KvlmomJq?C^CJNmmCzLmV;Jw!-M45Q~_ve9^NS-Nan&AY;<
zD1aHS3-A9}kX8QjrQDNeYG(&z0@KlQBxj3J<V^VbB=!qe^0GHymaIxkI{5^~7{p}r
zSrVJ+Tcm3VVbfmr+zYNzIWS79x|VW78*X?*UIc{ezj2Uj3UeifM5iWB=07l(vQv}~
zP^9=a$>Cu@v;fI*R|TvGgA%DccmX#U(FY}a`wOV&d&k3XB9nZ#-mmrzB(iRfXjzBe
zoWhlvm9NaGGUNuB*CUBW9qKggR@E#>1BSb@M^uGLNKlr7wQ-fLGDqyvBaQ7s@#h5j
zqMczbC6W3M7#zDz8~Z0Sb+Bo9NPvjWyUK`v>Up~ICy`7aVm_j_(C4vmN!v-}L|c*H
zR=ic*u|2Z>Z%6|;i+4;Bc2pDzIBm{oCh)R*GjL*(03=btOy7a*ufUL)n52#l>1Y=d
zvMiy1GW8ouoi5Ey?fqrmJp8jq3N97f73(?h>nW^?&~UDsl)G~92QVm}*UaEmc$@{v
z^Qxd6OP*MF#h=J;SdKKY5re&E?^W%Fv5jR50lK%>PI<lg*a~_zQzZ3LVY3cT-_2_q
zte&?UY~a-_fmimV*!1MrUmVEy<%i<v|I05vUX63-O3T-_6-JsrB0s~mu>Kiv{tN#Y
zoJzT|3{6G6QSB~yBV&>AOG<Jw?yTXe;@LAn=VWelJ@&dS&?Z@8ch^=Y#R@(8oEr6%
z6tubo`lei1d@8-O`rHYzr-o{Ki8l{HA%k7H6+H7rZY6f*76|YN<5j}lc!dH8uJc!?
ze_}0iV1fgmeLsxB%<<in`v+mT)K1EA{wUFFz1}()%Oi?n=t)`E;ykA5p0eA?3=!iY
z{7Fks!V1nn`Ld+rqdn4Wd(d*HUo)zbb=zKfe^EDLnO(Fbs%PL@*3fB6VI6xd%*sJ~
z`>7VSd~5R&07;vRD@tILIqn}3WeYqiH5PUpQR}XA!+HB#OO@;E7(Bl2y#e<BG6uk!
z*n?d5RdLT-Q|2Rh#dU0;SFJ=2{xNA2KE8(H!9CQ>ux_1EnV_N<0rv=+#fIDHFzVXN
z%ZO)2TOvA*<<ue$3(fK1e6NtQ8vj)xV`wJ-mmXb4hEJ(>(F5t!*^hP|eY!bJ8*h>A
zx%+X9w@IL85He}mlxCOlZ>ypPFW_e3NjzaVG@fMFOlNTvgOG)|_|Tpvw~hvls9a7@
zRP(k?qa3kDt-Ta|D=TvvZAp)uUpM~Kz{|(MVVzZ*&!g<7yt0(l?Z&JCd(d`;_znyH
zN@M+?;)R{==cjyc<LsR`NTmW^42E*>88XDH2_&4C*w@Y<j_>m41u;&$DHVzc@m<jX
zH|2taNjz)?yQ-P*5%8x*Kb`5}8ICSl_VP@S*7iz;3&)SFOqU@54OIv)O?U?5@2xc$
zYiN;5%b%KV^*v0C3O(N$#>ZUN^Gc-@adYu5%vbWN-N9#3hYQ?9FTVJ!=vS0=MDxUp
zn(wgg0`YE!K^9juh-M0boef@gZyXQ161brtOUw))x?$jr6`CpB;RAVhd>BW`F->J#
z6UDT#nCMg~^=5r5tJ0_@pJ;Jc4vkqW=4kQGnbyp=#9Q4PLKg=HDZ~%ZJ-G2XMZL_L
z2($kDm?EXvCC9yq`IGn!+2;co0bO~%ylpn9r%9X`k5)L*=53$P+jCpw?Q-|{A`fjT
ze4t38B6OzT(T0P9#mU<G^f^ZukEynBCr1h_NQp_UYrxT48--z<Wj!csdD$~~uh;yq
z`U)_jLPCu&N}+LG-%knf)!VLL`L4^SZxCp>eI|kcG6=YkSb70?fUrw@myocF%%7}t
znp>{m4F@K*;qY<l5Uk_UghVPFyBq`OYgTSQ5RsP1^7x1HPmmwTyDtN`d<0G|w?r4+
zQF_J;=Pw&EG!x=VHK`9%>YB~W+>VQk7v;YN$5KD*J?}Mw^ei-W&>DaALn;8_Tzs2K
z(+6Z!iv1&uTMIe;9T5Y!A_RmC0wtZAq0-`hzjN^spkiMC$c6<Jw~lLfa5cvNHQDw2
zM*ZOTRr=LkN-T)&bM{@>>B!1IMzdr!Ti@cPFvJ;k|LX5%bs5B2xh7bc9m_IZ=yS&V
zb^H!RQE*M1WBQ?L)xV#KOao4in9^!(WXbZkN%#J^I@_`}s~C}V;pX?e?_bOhScNZS
z1ZV&AZ;aCQ$u1??Pb~ySnPBDjq(K`7Di@#})vG}azjri)S{>KZ&%*VLx2aq_HQ&U*
zU@O=wnd#^L3qL&``J5lZ=CKI%V-iHA89t93T3%|O7x(F-mp#bJ%?GW+Oke>oca}eg
z|J6f6GUVSA0LG9BCY|q<@OGMEmbTOvMoiS^t$`>A^Obv(Bex75BMPUs;Tu~M7szd8
zWUj4@1bg?C<MfYPSMG29y|Mi?a&3*jAq&TGA<ul5Q<?zjx|`Uz>CIqijJdthz!F%1
za7}>0yb{?fmeBgT^X~dr;kq^YpT=h^#B0yz%d3cp^alw$qrSIPt^7=k3J$K-7nIGK
znQ>@ksh|pc_sZ>i66mY)ah>l6%mLx13B*Dnxp<9)zts8ivz%MN#A0}y&KF$8BqR`b
zcGmEYm5DBG%D@E^*&Xjm%}-qTXMM?}SsTPfc+O2}+fVB-ob}L?!>G~irpy_F1hLlE
zAwA}T{`b6ry%`0EO%RBp6vd{*<VoqzP9K_;PwhcCr+kvH6r0F@q}T>nG2L|Z^j5yU
z9JaDQoT@o-3W($#^948J9Ij&XLCLL!TK9?kz%x9;$tL#M184bMy>`q-Cj7OF7S&wc
zYPyk0bgKQ^SOdCi$fOJv3l(pqIW$+LutsH6$}pLBOkUXCmACd(^gg3jPvGkI?Vf8#
zQY+I@qn@u5=UwL5oO?X==g=C+thi5PLxg!>Ufw|fwLV(z?(1`yn=E4sy;A8iE}HaB
zwfKx!<0SOJBhW&0psiLK;T@$gr@PT#(cD(6@~Kz5NJMl%Lr-s9pnck{_Xv{>gEC{x
zw#Tm-v{r28_5|aawXtkuVxxbMQRWqiASML6di|ftV_j)$T4m1i&##M2+L4!>6WOyV
zNX;*1XIdfgdI+g`0WL)vc@BAQOX0>6D={k3_14sWN)CvyIPdBStmsH<mWFe)i+-Vd
zukkL^3{RguY~Yv~eUvU~@^c{SN+4>fz}f|oy+XpARFG#tTJJmsuvj23+T7hK?WAF>
zu1`_5zjdY{$4Qlflmd+-ev?G5D;M3yb2krfl%*!WyXSuznfEm|nxwo#hPgvKEyTf@
zQ7G5+<OmW0azqP0MMdPf>gSfIg?68^F2EkUbZOsxt^|c%4&_pFzqsztC{_BQgG+-`
zV`QUwbzl-O4Sw!Hgq-rnu3a5{a*Wz)O-nASeDml(>um#I7Y!IQYf8s3)0sphR_shN
z*$?z*aK#>uDe6qLLbXF_xpiZ$J0mmIbnWXp!^Bh7jKq^qkHu)NE7Q=1>1V9`b49Et
z(AI1QA^gH9d#0?8g^crbs*Oq3szguWY4_+!RgVna8L_m{3Eokyw1A5;@#kjMb@KAw
zmSTe-d3D67Ws7cGk9nKXY#CctJ7|+uG5!!p!UIWj*FDtbJ@|%^3HxOf1lS;Km)ZW3
zIYdY8b6VA#2ucK95Bx9=auqqIc3u!<Dpo>4wV6_-pr<UB-<(^SfLoLCq@L{d4p`rx
z=&-=Qh-%C)yt#=7X{$zf##ZiCO}=KMRQqg|wv}6<9n%^BO&kfSvrEy1VsPf9k7~{!
z3gi{_B3u0}x)K6ExfZ?ix4n3P{rPL#P#F61V-?B?Cj~SM%cZ}^KA%s{>1SaNGU6$W
zz#AA@ylFy2xPQ8~4aw7Rl{>3xTwgibjeUP~A6T6G8af6wo4bOgGfVG4LLm{5?tvW|
zMM^yD?eE!5e^>JDj!&+o`d|FlAYFASD__vkf8)HW5?=@Min+Lgj=g3?Z($OU0-m)4
zN&x)wO9y9m_O9Z!Rud1MBcG7UxI>%z=q^AiPlAlZ1xPZ<IbVZl<#{WCAfv=c?i`D^
zwTzpxH}+#z9K@TxL1$V{UZ(L;AVD7Ay}-`eybEaCIh@pfcn82wRZu`_#2gcF(+J4>
ztX@TOp!d@HiNdS&zOw^X6T_z$3%{m@i)vt8`c&_hAnG4N+VIPDgD+ED8au+Wo=o;f
zuv!l@)>zBS!A_+}U2zrwgCHSAjj^bAt$Q0bE@erCPRrau*ASzMsSlz&#HmIBJGAcj
z$9|5f<kx*e#T__ib2MH1a-1r-re;C><?i~yeSHB;>8twyP@}0NKI^DU(d95p96Mum
z1cN+l=zbC2R^&BsLVhPCvvd2bVeiU#TUsp<2NTY+u2c2GXu5EEn`)A6$_-|zpo@!{
zkrRf!9oAimOqWXEK)WXku}Oz7SlH2Gudp#}>g4Xl8_dYRa8|-$9WNIS5%KL_K*B$h
z9wA0mue<jXcs5RtfhKdLUYctM=OZ#+a96=)+F%OK?EH3HigrC+Jw0%`<3J<5`Tvic
zVhf7m{E$nDpI4kk=%d7;$JeH<a>m<z2bnW4K?`F$HSx_}4l!EV$tIf#3O2|ZCem~d
zHQUAX&>pMgdn*|losFS9P4l{v9;SEo9K=WXFAfgr3A6T|&G;ai(3*M5rt9%iAVktI
zzsmp7)Zr-?RvA-y9fv~&{O9;}aphMJw7;c1!fDZ!dQJeZEfU_d@%(j&d$w#-`gPY%
z`uaMW#ImqTxtIIU&;QiNox2y2T_-fEAM=tG>|WzC*N0gzg7XuzA3XxUhr%nfKzW{0
z;igl~L#(GG!g_M_BPHvan2bn;%<m$j?U~6DCh$nf=$ohH6)5c|a#8Aw%8XC1MMlE|
z`&f9%T)8>SZYS6jo*cILnS@GYy3k|CF#2+8-}c@iA)~#{p~0p>>62cYYfK>9wXIef
z1Si6gN}%d?6mf?l<=T4=a&c$QeoBt4r>LV+A83k-h2=7Yh1w3C#%AH$Dfs>Q-yZhV
zIJ9p_8Q8(Vmt>`9KuJ;}(l~DowmT+oi6mttWtL11?8LDTIX1t9_}rQ1YVkiq=;={`
zvNH_#Zc2z`{pp{fce-x$QNFqfaOalO)Zwgxu(m^N74uNP@@@6}X$0Vf0+?S5I;VH_
z&Y!x(wdXJiK#4!!-JagME4}?$y&!`v=yXsS4xH+VHSXEhMc|Qts{`NpktF%IZA+wY
z1|2S$+GbqYXtz2xJz=nQzZbnaiQ(GVbX?ope}uo3z)!6Vp#$@D1)Ty|D?I_5t(oz;
zC*eyba7)VyXXo{4wzl;~il4mhpZ-No0NW)dH;WPu&8VkyG>LBSuI<RwUXs3P@E@M}
zO>zc-6H>jQ@tai0KZrDeZI?$Xe6LpY(+}ADmkfXbhJL@_vKbGrfD(X*BqIq_4#9+c
z7i-9E;1teD6J|90`hB!OjcR^u{qGr+04BWw#UvlB#{c$x2|#rHi2?~~N&R{vso-EB
zrAG<P&o6)$85`AofQo5vU;OWhs{kj=fq@KqbN}{z+(1DmRwn)~@s#Wys4jeX_Udon
zCktGC1`-zN-WJ?j(Vr1MTPYaGZC2&qzV8rNIqo^@--_1%MDX7+lrP};e<HZ&y8bjl
r{}aJq>!QB_wfX<L7W`W#XmjU})^~?noO-zb0DnqyYO>i^Oz-?3TkAnU

literal 163147
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%0D#zn)OxWGPfd`~NKu}qwuY+QxSFe~Q
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
azx>B`$x#z|(S6{LisEgB{NEou`F{Y4>Eq@A


From 6a91a32a87017b725365a0e89c90e2c3a9f87636 Mon Sep 17 00:00:00 2001
From: r39132 <siddharthanand@yahoo.com>
Date: Mon, 10 Sep 2018 14:30:35 -0700
Subject: [PATCH 340/808] [AIRFLOW-3034]: Readme updates : Add Slack & Twitter,
 remove Gitter

---
 README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 4c22be6d8cf05..e52d2a311ef3e 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,7 @@ under the License.
 [![Documentation Status](https://readthedocs.org/projects/airflow/badge/?version=latest)](https://airflow.readthedocs.io/en/latest/?badge=latest)
 [![License](http://img.shields.io/:license-Apache%202-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/apache-airflow.svg)](https://pypi.org/project/apache-airflow/)
-[![Join the chat at https://gitter.im/apache/incubator-airflow](https://badges.gitter.im/apache/incubator-airflow.svg)](https://gitter.im/apache/incubator-airflow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Twitter Follow](https://img.shields.io/twitter/follow/ApacheAirflow.svg?style=social&label=Follow)](https://twitter.com/ApacheAirflow)
 
 _NOTE: The transition from 1.8.0 (or before) to 1.8.1 (or after) requires uninstalling Apache Airflow before installing the new version. The package name was changed from `airflow` to `apache-airflow` as of version 1.8.1._
 
@@ -282,7 +282,7 @@ If you would like to become a maintainer, please review the Apache Airflow
 ## Links
 
 
-* [Documentation](https://airflow.incubator.apache.org/)
-* [Chat](https://gitter.im/apache/incubator-airflow)
-* [Apache Airflow Incubation Status](http://incubator.apache.org/projects/airflow.html)
-* [More](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Links)
+- [Documentation](https://airflow.incubator.apache.org/)
+- [Chat](https://apache-airflow-slack.herokuapp.com/)
+- [Apache Airflow Incubation Status](http://incubator.apache.org/projects/airflow.html)
+- [More](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Links)

From 4a4648589776f3272dfdfe8a3a764968913b9777 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Sat, 5 Jan 2019 06:05:25 -0800
Subject: [PATCH 341/808] [AIRFLOW-3612] Remove incubation/incubator mention
 (#4419)

---
 .rat-excludes                                  |   4 ++--
 CHANGELOG.txt                                  |   4 ++--
 CONTRIBUTING.md                                |   8 ++++----
 DISCLAIMER                                     |   6 ------
 INSTALL                                        |   2 +-
 MANIFEST.in                                    |   1 -
 README.md                                      |  17 ++++++++++-------
 UPDATING.md                                    |   8 ++++----
 airflow/config_templates/default_airflow.cfg   |   2 +-
 .../example_dags/example_twitter_README.md     |   2 +-
 airflow/contrib/sensors/qubole_sensor.py       |   4 ++--
 airflow/example_dags/tutorial.py               |   2 +-
 airflow/operators/slack_operator.py            |   2 +-
 airflow/www/app.py                             |   4 ++--
 airflow/www_rbac/app.py                        |   2 +-
 airflow/www_rbac/package.json                  |   2 +-
 dev/README.md                                  |   4 ++--
 dev/airflow-pr                                 |  10 +++++-----
 docs/img/incubator.jpg                         | Bin 91227 -> 0 bytes
 docs/index.rst                                 |  17 +----------------
 docs/plugins.rst                               |   2 +-
 docs/project.rst                               |   6 +++---
 docs/scheduler.rst                             |   2 +-
 docs/tutorial.rst                              |   4 ++--
 scripts/ci/flake8_diff.sh                      |   4 ++--
 scripts/ci/kubernetes/kube/configmaps.yaml     |   4 ++--
 setup.cfg                                      |   2 +-
 setup.py                                       |   6 +++---
 tests/plugins/test_plugin.py                   |   2 +-
 tests/sensors/test_http_sensor.py              |   6 +++---
 30 files changed, 60 insertions(+), 79 deletions(-)
 delete mode 100644 DISCLAIMER
 delete mode 100644 docs/img/incubator.jpg

diff --git a/.rat-excludes b/.rat-excludes
index 05f7b98000f89..916e9e268971d 100644
--- a/.rat-excludes
+++ b/.rat-excludes
@@ -56,5 +56,5 @@ git_version
 flake8_diff.sh
 
 rat-results.txt
-apache-airflow-.*\+incubating-source.tar.gz.*
-apache-airflow-.*\+incubating-bin.tar.gz.*
+apache-airflow-.*\+source.tar.gz.*
+apache-airflow-.*\+bin.tar.gz.*
diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index abb0563d71771..aa7b321a5cb5a 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -535,7 +535,7 @@ AIRFLOW 1.10.0, 2018-08-03
 [AIRFLOW-2097] tz referenced before assignment
 [AIRFLOW-2152] Add Multiply to list of companies using Airflow
 [AIRFLOW-1551] Add operator to trigger Jenkins job
-[AIRFLOW-2034] Fix mixup between %s and {} when using str.format Convention is to use .format for string formating oustide logging, else use lazy format See comment in related issue https://github.com/apache/incubator-airflow/pull/2823/files Identified problematic case using following command line .git/COMMIT_EDITMSG:`grep -r '%s'./* | grep '\.format('`
+[AIRFLOW-2034] Fix mixup between %s and {} when using str.format Convention is to use .format for string formating oustide logging, else use lazy format See comment in related issue https://github.com/apache/airflow/pull/2823/files Identified problematic case using following command line .git/COMMIT_EDITMSG:`grep -r '%s'./* | grep '\.format('`
 [AIRFLOW-2102] Add custom_args to Sendgrid personalizations
 [AIRFLOW-1035][AIRFLOW-1053] import unicode_literals to parse Unicode in HQL
 [AIRFLOW-2127] Keep loggers during DB migrations
@@ -1829,7 +1829,7 @@ AIRFLOW 1.7.1, 2016-05-19
 -------------------------
 
 - Fix : Don't treat premature tasks as could_not_run tasks
-- AIRFLOW-92 Avoid unneeded upstream_failed session closes apache/incubator-airflow#1485
+- AIRFLOW-92 Avoid unneeded upstream_failed session closes apache/airflow#1485
 - Add logic to lock DB and avoid race condition
 - Handle queued tasks from multiple jobs/executors
 - AIRFLOW-52 Warn about overwriting tasks in a DAG
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d991eb51fa641..b7a1b1e0a361f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -83,7 +83,7 @@ If you are proposing a feature:
 ## Documentation
 
 The latest API documentation is usually available
-[here](https://airflow.incubator.apache.org/). To generate a local version,
+[here](https://airflow.apache.org/). To generate a local version,
 you need to have set up an Airflow development environemnt (see below). Also
 install the `doc` extra.
 
@@ -152,8 +152,8 @@ Before you submit a pull request from your forked repo, check that it
 meets these guidelines:
 
 1. The pull request should include tests, either as doctests, unit tests, or
-both. The airflow repo uses [Travis CI](https://travis-ci.org/apache/incubator-airflow)
-to run the tests and [codecov](https://codecov.io/gh/apache/incubator-airflow)
+both. The airflow repo uses [Travis CI](https://travis-ci.org/apache/airflow)
+to run the tests and [codecov](https://codecov.io/gh/apache/airflow)
 to track coverage. You can set up both for free on your fork. It will
 help you making sure you do not break the build with your PR and that you help
 increase coverage.
@@ -177,7 +177,7 @@ writing code that works in both Python 2 and 3, see the documentation at the
 Airflow requirement and should be used where possible).
 8. As Airflow grows as a project, we try to enforce a more consistent
 style and try to follow the Python community guidelines. We track this
-using [landscape.io](https://landscape.io/github/apache/incubator-airflow/),
+using [landscape.io](https://landscape.io/github/apache/airflow/),
 which you can setup on your fork as well to check before you submit your
 PR. We currently enforce most [PEP8](https://www.python.org/dev/peps/pep-0008/)
 and a few other linting rules. It is usually a good idea to lint locally
diff --git a/DISCLAIMER b/DISCLAIMER
deleted file mode 100644
index 2758508789843..0000000000000
--- a/DISCLAIMER
+++ /dev/null
@@ -1,6 +0,0 @@
-Apache Airflow is an effort undergoing incubation at The Apache Software Foundation (ASF),
-sponsored by the Apache Incubator. Incubation is required of all newly accepted projects
-until a further review indicates that the infrastructure, communications, and decision
-making process have stabilized in a manner consistent with other successful ASF projects.
-While incubation status is not necessarily a reflection of the completeness or stability
-of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
diff --git a/INSTALL b/INSTALL
index b018839ab1a5c..00d458f450737 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,4 +1,4 @@
-# INSTALL / BUILD instructions for Apache Airflow (incubating)
+# INSTALL / BUILD instructions for Apache Airflow
 
 # [required] fetch the tarball and untar the source
 # change into the directory that was untarred.
diff --git a/MANIFEST.in b/MANIFEST.in
index ec99c1f6b2b1e..2ad56c61dbfdc 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -18,7 +18,6 @@
 
 include NOTICE
 include LICENSE
-include DISCLAIMER
 include CHANGELOG.txt
 include README.md
 graft licenses/
diff --git a/README.md b/README.md
index e52d2a311ef3e..633000c18e788 100644
--- a/README.md
+++ b/README.md
@@ -17,11 +17,11 @@ specific language governing permissions and limitations
 under the License.
 -->
 
-# Apache Airflow (Incubating)
+# Apache Airflow
 
 [![PyPI version](https://badge.fury.io/py/apache-airflow.svg)](https://badge.fury.io/py/apache-airflow)
-[![Build Status](https://travis-ci.org/apache/incubator-airflow.svg?branch=master)](https://travis-ci.org/apache/incubator-airflow)
-[![Coverage Status](https://img.shields.io/codecov/c/github/apache/incubator-airflow/master.svg)](https://codecov.io/github/apache/incubator-airflow?branch=master)
+[![Build Status](https://travis-ci.org/apache/airflow.svg?branch=master)](https://travis-ci.org/apache/airflow)
+[![Coverage Status](https://img.shields.io/codecov/c/github/apache/airflow/master.svg)](https://codecov.io/github/apache/airflow?branch=master)
 [![Documentation Status](https://readthedocs.org/projects/airflow/badge/?version=latest)](https://airflow.readthedocs.io/en/latest/?badge=latest)
 [![License](http://img.shields.io/:license-Apache%202-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0.txt)
 [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/apache-airflow.svg)](https://pypi.org/project/apache-airflow/)
@@ -37,7 +37,7 @@ versionable, testable, and collaborative.
 Use Airflow to author workflows as directed acyclic graphs (DAGs) of tasks. The Airflow scheduler executes your tasks on an array of workers while following the specified dependencies. Rich command line utilities make performing complex surgeries on DAGs a snap. The rich user interface makes it easy to visualize pipelines running in production, monitor progress, and troubleshoot issues when needed.
 
 ## Getting started
-Please visit the Airflow Platform documentation (latest **stable** release) for help with [installing Airflow](https://airflow.incubator.apache.org/installation.html), getting a [quick start](https://airflow.incubator.apache.org/start.html), or a more complete [tutorial](https://airflow.incubator.apache.org/tutorial.html).
+Please visit the Airflow Platform documentation (latest **stable** release) for help with [installing Airflow](https://airflow.apache.org/installation.html), getting a [quick start](https://airflow.apache.org/start.html), or a more complete [tutorial](https://airflow.apache.org/tutorial.html).
 
 Documentation of GitHub master (latest development branch): [ReadTheDocs Documentation](https://airflow.readthedocs.io/en/latest/)
 
@@ -85,6 +85,10 @@ unit of work and continuity.
 - **Code View**:  Quick way to view source code of a DAG.
 ![](/docs/img/code.png)
 
+## Contributing
+
+Want to help build Apache Airflow? Check out our [contributing documentation](https://github.com/apache/airflow/blob/master/CONTRIBUTING.md).
+
 ## Who uses Apache Airflow?
 
 As the Apache Airflow community grows, we'd like to keep track of who is using
@@ -273,7 +277,7 @@ Currently **officially** using Airflow:
 
 ## Who Maintains Apache Airflow?
 
-Airflow is the work of the [community](https://github.com/apache/incubator-airflow/graphs/contributors),
+Airflow is the work of the [community](https://github.com/apache/airflow/graphs/contributors),
 but the [core committers/maintainers](https://people.apache.org/committers-by-project.html#airflow)
 are responsible for reviewing and merging PRs as well as steering conversation around new feature requests.
 If you would like to become a maintainer, please review the Apache Airflow
@@ -282,7 +286,6 @@ If you would like to become a maintainer, please review the Apache Airflow
 ## Links
 
 
-- [Documentation](https://airflow.incubator.apache.org/)
+- [Documentation](https://airflow.apache.org/)
 - [Chat](https://apache-airflow-slack.herokuapp.com/)
-- [Apache Airflow Incubation Status](http://incubator.apache.org/projects/airflow.html)
 - [More](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Links)
diff --git a/UPDATING.md b/UPDATING.md
index 45ab7dc96942c..036538131280a 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -104,7 +104,7 @@ config file.
 
 If you want to use LDAP auth backend without TLS then you will habe to create a
 custom-auth backend based on
-https://github.com/apache/incubator-airflow/blob/1.10.0/airflow/contrib/auth/backends/ldap_auth.py
+https://github.com/apache/airflow/blob/1.10.0/airflow/contrib/auth/backends/ldap_auth.py
 
 ## Airflow 1.10
 
@@ -419,11 +419,11 @@ The `file_task_handler` logger has been made more flexible. The default format c
 
 #### I'm using S3Log or GCSLogs, what do I do!?
 
-If you are logging to Google cloud storage, please see the [Google cloud platform documentation](https://airflow.incubator.apache.org/integration.html#gcp-google-cloud-platform) for logging instructions.
+If you are logging to Google cloud storage, please see the [Google cloud platform documentation](https://airflow.apache.org/integration.html#gcp-google-cloud-platform) for logging instructions.
 
 If you are using S3, the instructions should be largely the same as the Google cloud platform instructions above. You will need a custom logging config. The `REMOTE_BASE_LOG_FOLDER` configuration key in your airflow config has been removed, therefore you will need to take the following steps:
 
-- Copy the logging configuration from [`airflow/config_templates/airflow_logging_settings.py`](https://github.com/apache/incubator-airflow/blob/master/airflow/config_templates/airflow_local_settings.py).
+- Copy the logging configuration from [`airflow/config_templates/airflow_logging_settings.py`](https://github.com/apache/airflow/blob/master/airflow/config_templates/airflow_local_settings.py).
 - Place it in a directory inside the Python import path `PYTHONPATH`. If you are using Python 2.7, ensuring that any `__init__.py` files exist so that it is importable.
 - Update the config by setting the path of `REMOTE_BASE_LOG_FOLDER` explicitly in the config. The `REMOTE_BASE_LOG_FOLDER` key is not used anymore.
 - Set the `logging_config_class` to the filename and dict. For example, if you place `custom_logging_config.py` on the base of your pythonpath, you will need to set `logging_config_class = custom_logging_config.LOGGING_CONFIG` in your config as Airflow 1.8.
@@ -577,7 +577,7 @@ supported and will be removed entirely in Airflow 2.0
 - Operators no longer accept arbitrary arguments
 
   Previously, `Operator.__init__()` accepted any arguments (either positional `*args` or keyword `**kwargs`) without
-  complaint. Now, invalid arguments will be rejected. (https://github.com/apache/incubator-airflow/pull/1285)
+  complaint. Now, invalid arguments will be rejected. (https://github.com/apache/airflow/pull/1285)
 
 - The config value secure_mode will default to True which will disable some insecure endpoints/features
 
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 384ff9df31f43..c8aa4061e7271 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -266,7 +266,7 @@ error_logfile = -
 expose_config = False
 
 # Set to true to turn on authentication:
-# https://airflow.incubator.apache.org/security.html#web-authentication
+# https://airflow.apache.org/security.html#web-authentication
 authenticate = False
 
 # Filter the list of dags by owner name (requires authentication to be enabled)
diff --git a/airflow/contrib/example_dags/example_twitter_README.md b/airflow/contrib/example_dags/example_twitter_README.md
index 0876bdb4d161a..7563b816656b6 100644
--- a/airflow/contrib/example_dags/example_twitter_README.md
+++ b/airflow/contrib/example_dags/example_twitter_README.md
@@ -50,6 +50,6 @@ CREATE TABLE toTwitter_A(id BIGINT, id_str STRING
 ```
 When you review the code for the DAG, you will notice that these tasks are generated using for loop. These two for loops could be combined into one loop. However, in most cases, you will be running different analysis on your incoming incoming and outgoing tweets, and hence they are kept separated in this example.
 Final step is a running the broker script, brokerapi.py, which will run queries in Hive and store the summarized data to MySQL in our case. To connect to Hive, pyhs2 library is extremely useful and easy to use. To insert data into MySQL from Python, sqlalchemy is also a good one to use.
-I hope you find this tutorial useful. If you have question feel free to ask me on [Twitter](https://twitter.com/EkhtiarSyed) or via the live Airflow chatroom room in [Gitter](https://gitter.im/apache/incubator-airflow).<p>
+I hope you find this tutorial useful. If you have question feel free to ask me on [Twitter](https://twitter.com/EkhtiarSyed) or via the live Airflow chatroom room in [Gitter](https://gitter.im/apache/airflow).<p>
 -Ekhtiar Syed
 Last Update: 8-April-2016
diff --git a/airflow/contrib/sensors/qubole_sensor.py b/airflow/contrib/sensors/qubole_sensor.py
index 7065ae9262595..895fc171bc704 100644
--- a/airflow/contrib/sensors/qubole_sensor.py
+++ b/airflow/contrib/sensors/qubole_sensor.py
@@ -82,7 +82,7 @@ class QuboleFileSensor(QuboleSensor):
     :param qubole_conn_id: Connection id which consists of qds auth_token
     :type qubole_conn_id: str
     :param data: a JSON object containing payload, whose presence needs to be checked
-        Check this `example <https://github.com/apache/incubator-airflow/blob/master\
+        Check this `example <https://github.com/apache/airflow/blob/master\
         /airflow/contrib/example_dags/example_qubole_sensor.py>`_ for sample payload
         structure.
     :type data: a JSON object
@@ -105,7 +105,7 @@ class QubolePartitionSensor(QuboleSensor):
     :param qubole_conn_id: Connection id which consists of qds auth_token
     :type qubole_conn_id: str
     :param data: a JSON object containing payload, whose presence needs to be checked.
-        Check this `example <https://github.com/apache/incubator-airflow/blob/master\
+        Check this `example <https://github.com/apache/airflow/blob/master\
         /airflow/contrib/example_dags/example_qubole_sensor.py>`_ for sample payload
         structure.
     :type data: a JSON object
diff --git a/airflow/example_dags/tutorial.py b/airflow/example_dags/tutorial.py
index ccf2e6e2ee235..3ab107da83e50 100644
--- a/airflow/example_dags/tutorial.py
+++ b/airflow/example_dags/tutorial.py
@@ -20,7 +20,7 @@
 """
 ### Tutorial Documentation
 Documentation that goes along with the Airflow tutorial located
-[here](https://airflow.incubator.apache.org/tutorial.html)
+[here](https://airflow.apache.org/tutorial.html)
 """
 from datetime import timedelta
 
diff --git a/airflow/operators/slack_operator.py b/airflow/operators/slack_operator.py
index 3382bc2788dd4..98a56947c0ee1 100644
--- a/airflow/operators/slack_operator.py
+++ b/airflow/operators/slack_operator.py
@@ -116,7 +116,7 @@ def __init__(self,
                       'Here is a cat video instead\n'
                       'https://www.youtube.com/watch?v=J---aiyznGQ',
                  icon_url='https://raw.githubusercontent.com/apache/'
-                          'incubator-airflow/master/airflow/www/static/pin_100.jpg',
+                          'airflow/master/airflow/www/static/pin_100.jpg',
                  attachments=None,
                  *args, **kwargs):
         self.method = 'chat.postMessage'
diff --git a/airflow/www/app.py b/airflow/www/app.py
index 1140be9aa06e3..bc5ee8c816ad4 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -112,11 +112,11 @@ def create_app(config=None, testing=False):
 
         admin.add_link(base.MenuLink(
             category='Docs', name='Documentation',
-            url='https://airflow.incubator.apache.org/'))
+            url='https://airflow.apache.org/'))
         admin.add_link(
             base.MenuLink(category='Docs',
                           name='Github',
-                          url='https://github.com/apache/incubator-airflow'))
+                          url='https://github.com/apache/airflow'))
 
         av(vs.VersionView(name='Version', category="About"))
 
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 7a2b18418cd1c..ef1a7adad58ef 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -120,7 +120,7 @@ def init_views(appbuilder):
                                 category="Docs",
                                 category_icon="fa-cube")
             appbuilder.add_link("Github",
-                                href='https://github.com/apache/incubator-airflow',
+                                href='https://github.com/apache/airflow',
                                 category="Docs")
             appbuilder.add_link('Version',
                                 href='/version',
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index 5f0c4bc592d49..eb1053b941953 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -10,7 +10,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/apache/incubator-airflow.git"
+    "url": "git+https://github.com/apache/airflow.git"
   },
   "homepage": "http://airflow.apache.org/",
   "keywords": [
diff --git a/dev/README.md b/dev/README.md
index fe3900e37795d..a7747526cf862 100755
--- a/dev/README.md
+++ b/dev/README.md
@@ -82,8 +82,8 @@ Users can configure this automatically by running `airflow-pr setup_git_remotes`
 
 ```bash
 $ git remote -v
-github	https://github.com/apache/incubator-airflow.git (fetch)
-github	https://github.com/apache/incubator-airflow.git (push)
+github	https://github.com/apache/airflow.git (fetch)
+github	https://github.com/apache/airflow.git (push)
 origin	https://github.com/<USER>/airflow (fetch)
 origin	https://github.com/<USER>/airflow (push)
 ```
diff --git a/dev/airflow-pr b/dev/airflow-pr
index 80dc22ef38504..da996d1d6aa48 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -73,8 +73,8 @@ GITHUB_REMOTE_NAME = os.environ.get("GITHUB_REMOTE_NAME", "github")
 # scope.
 GITHUB_OAUTH_KEY = os.environ.get("GITHUB_OAUTH_KEY")
 
-GITHUB_BASE = "https://github.com/apache/incubator-airflow/pull"
-GITHUB_API_BASE = "https://api.github.com/repos/apache/incubator-airflow"
+GITHUB_BASE = "https://github.com/apache/airflow/pull"
+GITHUB_API_BASE = "https://api.github.com/repos/apache/airflow"
 GITHUB_USER = 'asfgit'
 
 JIRA_BASE = "https://issues.apache.org/jira/browse"
@@ -1013,8 +1013,8 @@ def setup_git_remotes():
         GITHUB_REMOTE_NAME environment variable:
 
           git remote -v
-          github https://github.com/apache/incubator-airflow.git (fetch)
-          github https://github.com/apache/incubator-airflow.git (push)
+          github https://github.com/apache/airflow.git (fetch)
+          github https://github.com/apache/airflow.git (push)
 
         If these remotes already exist, the tool will display an error.
         """))
@@ -1022,7 +1022,7 @@ def setup_git_remotes():
 
     error = False
     try:
-        run_cmd('git remote add github https://github.com/apache/incubator-airflow.git')
+        run_cmd('git remote add github https://github.com/apache/airflow.git')
     except:
         click.echo(click.style(reflow(
             '>>ERROR: Could not create github remote. If it already exists, '
diff --git a/docs/img/incubator.jpg b/docs/img/incubator.jpg
deleted file mode 100644
index 6f34a85e81c7437adbc7209dd0b2280a1ea1568e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 91227
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
B9r6GG

diff --git a/docs/index.rst b/docs/index.rst
index efd0a8b78db4c..b0054ad670bcf 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -18,25 +18,10 @@
 
 .. image:: img/pin_large.png
     :width: 100
-.. image:: img/incubator.jpg
-    :width: 150
 
-Apache Airflow (incubating) Documentation
+Apache Airflow Documentation
 =========================================
 
-.. important::
-
-    **Disclaimer**: Apache Airflow is an effort undergoing incubation at The
-    Apache Software Foundation (ASF), sponsored by the Apache Incubator.
-    Incubation is required of all newly accepted projects until a further
-    review indicates that the infrastructure, communications, and
-    decision making process have stabilized in a manner consistent with
-    other successful ASF projects. While incubation status is not
-    necessarily a reflection of the completeness or stability of
-    the code, it does indicate that the project has yet to be fully
-    endorsed by the ASF.
-
-
 Airflow is a platform to programmatically author, schedule and monitor
 workflows.
 
diff --git a/docs/plugins.rst b/docs/plugins.rst
index 61b49577c7eed..715211281b818 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -159,7 +159,7 @@ definitions in Airflow.
     ml = MenuLink(
         category='Test Plugin',
         name='Test Menu Link',
-        url='https://airflow.incubator.apache.org/')
+        url='https://airflow.apache.org/')
 
     # Creating a flask appbuilder BaseView
     class TestAppBuilderBaseView(AppBuilderBaseView):
diff --git a/docs/project.rst b/docs/project.rst
index 6e4074f0918ba..1f37ca2a2b42b 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -50,7 +50,7 @@ Committers
 
 For the full list of contributors, take a look at `Airflow's Github
 Contributor page:
-<https://github.com/apache/incubator-airflow/graphs/contributors>`_
+<https://github.com/apache/airflow/graphs/contributors>`_
 
 
 Resources & links
@@ -58,8 +58,8 @@ Resources & links
 
 * `Airflow's official documentation <http://airflow.apache.org/>`_
 * Mailing list (send emails to
-  ``dev-subscribe@airflow.incubator.apache.org`` and/or
-  ``commits-subscribe@airflow.incubator.apache.org``
+  ``dev-subscribe@airflow.apache.org`` and/or
+  ``commits-subscribe@airflow.apache.org``
   to subscribe to each)
 * `Issues on Apache's Jira <https://issues.apache.org/jira/browse/AIRFLOW>`_
 * `Gitter (chat) Channel <https://gitter.im/airbnb/airflow>`_
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 377fdffac2837..e30cd05a7e1d2 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -114,7 +114,7 @@ interval series.
 
     """
     Code that goes along with the Airflow tutorial located at:
-    https://github.com/apache/incubator-airflow/blob/master/airflow/example_dags/tutorial.py
+    https://github.com/apache/airflow/blob/master/airflow/example_dags/tutorial.py
     """
     from airflow import DAG
     from airflow.operators.bash_operator import BashOperator
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index 69670d7b025cf..9d1c94f5b9b71 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -32,7 +32,7 @@ complicated, a line by line explanation follows below.
 
     """
     Code that goes along with the Airflow tutorial located at:
-    https://github.com/apache/incubator-airflow/blob/master/airflow/example_dags/tutorial.py
+    https://github.com/apache/airflow/blob/master/airflow/example_dags/tutorial.py
     """
     from airflow import DAG
     from airflow.operators.bash_operator import BashOperator
@@ -308,7 +308,7 @@ something like this:
 
     """
     Code that goes along with the Airflow tutorial located at:
-    https://github.com/apache/incubator-airflow/blob/master/airflow/example_dags/tutorial.py
+    https://github.com/apache/airflow/blob/master/airflow/example_dags/tutorial.py
     """
     from airflow import DAG
     from airflow.operators.bash_operator import BashOperator
diff --git a/scripts/ci/flake8_diff.sh b/scripts/ci/flake8_diff.sh
index 376be9bc0fb5d..fcbbf8a52ffb3 100755
--- a/scripts/ci/flake8_diff.sh
+++ b/scripts/ci/flake8_diff.sh
@@ -30,7 +30,7 @@
 # This script is used in Travis to check that PRs do not add obvious
 # flake8 violations. It relies on two things:
 #   - find common ancestor between branch and
-#     apache/incubator-airflow remote
+#     apache/airflow remote
 #   - run flake8 --diff on the diff between the branch and the common
 #     ancestor
 #
@@ -44,7 +44,7 @@ set -e
 # pipefail is necessary to propagate exit codes
 set -o pipefail
 
-PROJECT=apache/incubator-airflow
+PROJECT=apache/airflow
 PROJECT_URL=https://github.com/$PROJECT.git
 
 # Find the remote with the project name (upstream in most cases)
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index d10cbdc728a9f..c8e6b19076d1d 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -119,7 +119,7 @@ data:
     expose_config = False
 
     # Set to true to turn on authentication:
-    # https://airflow.incubator.apache.org/security.html#web-authentication
+    # https://airflow.apache.org/security.html#web-authentication
     authenticate = False
 
     # Filter the list of dags by owner name (requires authentication to be enabled)
@@ -179,7 +179,7 @@ data:
     worker_dags_folder = /tmp/dags
     delete_worker_pods = True
     dags_in_image = False
-    git_repo = https://github.com/apache/incubator-airflow.git
+    git_repo = https://github.com/apache/airflow.git
     git_branch = master
     git_subpath = airflow/example_dags/
     git_user =
diff --git a/setup.cfg b/setup.cfg
index 881fe0107d9b2..f29267e269727 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -20,7 +20,7 @@ name = Airflow
 summary = Airflow is a system to programmatically author, schedule and monitor data pipelines.
 description-file = README.md
 author = Apache Airflow PMC
-author-email = dev@airflow.incubator.apache.org
+author-email = dev@airflow.apache.org
 license = Apache License, Version 2.0
 
 [files]
diff --git a/setup.py b/setup.py
index f01a360dce59e..7947c27482af8 100644
--- a/setup.py
+++ b/setup.py
@@ -405,10 +405,10 @@ def do_setup():
             'Topic :: System :: Monitoring',
         ],
         author='Apache Software Foundation',
-        author_email='dev@airflow.incubator.apache.org',
-        url='http://airflow.incubator.apache.org/',
+        author_email='dev@airflow.apache.org',
+        url='http://airflow.apache.org/',
         download_url=(
-            'https://dist.apache.org/repos/dist/release/incubator/airflow/' + version),
+            'https://dist.apache.org/repos/dist/release/airflow/' + version),
         cmdclass={
             'test': Tox,
             'extra_clean': CleanCommand,
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index 0770da120bc4c..39135c13069a5 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -94,7 +94,7 @@ def test(self):
 ml = MenuLink(
     category='Test Plugin',
     name="Test Menu Link",
-    url="https://airflow.incubator.apache.org/")
+    url="https://airflow.apache.org/")
 
 
 # Defining the plugin class
diff --git a/tests/sensors/test_http_sensor.py b/tests/sensors/test_http_sensor.py
index 5e55aa56e9c49..ffea7cadfe828 100644
--- a/tests/sensors/test_http_sensor.py
+++ b/tests/sensors/test_http_sensor.py
@@ -140,7 +140,7 @@ class FakeSession(object):
     def __init__(self):
         self.response = requests.Response()
         self.response.status_code = 200
-        self.response._content = 'apache/incubator-airflow'.encode('ascii', 'ignore')
+        self.response._content = 'apache/airflow'.encode('ascii', 'ignore')
 
     def send(self, request, **kwargs):
         return self.response
@@ -178,7 +178,7 @@ def test_get_response_check(self):
             method='GET',
             endpoint='/search',
             data={"client": "ubuntu", "q": "airflow"},
-            response_check=lambda response: ("apache/incubator-airflow" in response.text),
+            response_check=lambda response: ("apache/airflow" in response.text),
             headers={},
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
@@ -192,7 +192,7 @@ def test_sensor(self):
             request_params={"client": "ubuntu", "q": "airflow", 'date': '{{ds}}'},
             headers={},
             response_check=lambda response: (
-                "apache/incubator-airflow/" + DEFAULT_DATE.strftime('%Y-%m-%d')
+                "apache/airflow/" + DEFAULT_DATE.strftime('%Y-%m-%d')
                 in response.text),
             poke_interval=5,
             timeout=15,

From 21263ea90375aa6ce02de4f6feb92bc02e9d35ca Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 2 Dec 2018 11:08:26 +0000
Subject: [PATCH 342/808] [AIRFLOW-XXX] Add missing GCP operators to Docs
 (#4260)

---
 docs/integration.rst | 33 +++++++++++++++++++++------------
 1 file changed, 21 insertions(+), 12 deletions(-)

diff --git a/docs/integration.rst b/docs/integration.rst
index 284c372d47454..a04d71d825cb6 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -557,10 +557,11 @@ BigQuery Operators
 - :ref:`BigQueryValueCheckOperator` : Performs a simple value check using SQL code.
 - :ref:`BigQueryIntervalCheckOperator` : Checks that the values of metrics given as SQL expressions are within a certain tolerance of the ones from days_back before.
 - :ref:`BigQueryGetDataOperator` : Fetches the data from a BigQuery table and returns data in a python list
+- :ref:`BigQueryCreateEmptyDatasetOperator` : Creates an empty BigQuery dataset.
 - :ref:`BigQueryCreateEmptyTableOperator` : Creates a new, empty table in the specified BigQuery dataset optionally with schema.
 - :ref:`BigQueryCreateExternalTableOperator` : Creates a new, external table in the dataset with the data in Google Cloud Storage.
 - :ref:`BigQueryDeleteDatasetOperator` : Deletes an existing BigQuery dataset.
-- :ref:`BigQueryCreateEmptyDatasetOperator` : Creates an empty BigQuery dataset.
+- :ref:`BigQueryTableDeleteOperator` : Deletes an existing BigQuery table.
 - :ref:`BigQueryOperator` : Executes BigQuery SQL queries in a specific BigQuery database.
 - :ref:`BigQueryToBigQueryOperator` : Copy a BigQuery table to another BigQuery table.
 - :ref:`BigQueryToCloudStorageOperator` : Transfers a BigQuery table to a Google Cloud Storage bucket
@@ -608,13 +609,6 @@ BigQueryCreateExternalTableOperator
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
 
-.. _BigQueryDeleteDatasetOperator:
-
-BigQueryDeleteDatasetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
-
 .. _BigQueryCreateEmptyDatasetOperator:
 
 BigQueryCreateEmptyDatasetOperator
@@ -622,12 +616,12 @@ BigQueryCreateEmptyDatasetOperator
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
 
-.. _BigQueryOperator:
+.. _BigQueryDeleteDatasetOperator:
 
-BigQueryOperator
-^^^^^^^^^^^^^^^^
+BigQueryDeleteDatasetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
 
 .. _BigQueryTableDeleteOperator:
 
@@ -636,6 +630,13 @@ BigQueryTableDeleteOperator
 
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
 
+.. _BigQueryOperator:
+
+BigQueryOperator
+^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
+
 .. _BigQueryToBigQueryOperator:
 
 BigQueryToBigQueryOperator
@@ -1242,6 +1243,7 @@ Storage Operators
 - :ref:`GoogleCloudStorageObjectCreateAclEntryOperator` : Creates a new ACL entry on the specified object.
 - :ref:`GoogleCloudStorageToBigQueryOperator` : Loads files from Google cloud storage into BigQuery.
 - :ref:`GoogleCloudStorageToGoogleCloudStorageOperator` : Copies objects from a bucket to another, with renaming if requested.
+- :ref:`MySqlToGoogleCloudStorageOperator`: Copy data from any MySQL Database to Google cloud storage in JSON format.
 
 .. _FileToGoogleCloudStorageOperator:
 
@@ -1299,6 +1301,13 @@ GoogleCloudStorageToGoogleCloudStorageOperator
 
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
 
+.. _MySqlToGoogleCloudStorageOperator:
+
+MySqlToGoogleCloudStorageOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
+
 GoogleCloudStorageHook
 """"""""""""""""""""""
 

From 2772a9d45b569e41e213664d063df17097290e5c Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Sun, 6 Jan 2019 14:35:31 -0500
Subject: [PATCH 343/808] [AIRFLOW-3531] Add gcs to gcs transfer operator.
 (#4331)

---
 airflow/contrib/hooks/gcp_transfer_hook.py    |   6 +-
 .../operators/gcs_to_gcs_transfer_operator.py | 127 +++++++++++++++++
 .../operators/s3_to_gcs_transfer_operator.py  |   8 +-
 docs/code.rst                                 |   1 +
 docs/integration.rst                          |   8 ++
 .../test_gcs_to_gcs_transfer_operator.py      | 131 ++++++++++++++++++
 .../test_s3_to_gcs_transfer_operator.py       |   2 +
 7 files changed, 276 insertions(+), 7 deletions(-)
 create mode 100644 airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
 create mode 100644 tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py

diff --git a/airflow/contrib/hooks/gcp_transfer_hook.py b/airflow/contrib/hooks/gcp_transfer_hook.py
index 906dba786fb9c..6966ec3ae244e 100644
--- a/airflow/contrib/hooks/gcp_transfer_hook.py
+++ b/airflow/contrib/hooks/gcp_transfer_hook.py
@@ -26,7 +26,7 @@
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 # Time to sleep between active checks of the operation results
-TIME_TO_SLEEP_IN_SECONDS = 1
+TIME_TO_SLEEP_IN_SECONDS = 10
 
 
 # noinspection PyAbstractClass
@@ -56,10 +56,10 @@ def get_conn(self):
                                http=http_authorized, cache_discovery=False)
         return self._conn
 
-    def create_transfer_job(self, project_id, description, schedule, transfer_spec):
+    def create_transfer_job(self, description, schedule, transfer_spec, project_id=None):
         transfer_job = {
             'status': 'ENABLED',
-            'projectId': project_id,
+            'projectId': project_id or self.project_id,
             'description': description,
             'transferSpec': transfer_spec,
             'schedule': schedule or self._schedule_once_now(),
diff --git a/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py b/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
new file mode 100644
index 0000000000000..410d65821d205
--- /dev/null
+++ b/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
@@ -0,0 +1,127 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import BaseOperator
+from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
+from airflow.utils.decorators import apply_defaults
+
+
+class GoogleCloudStorageToGoogleCloudStorageTransferOperator(BaseOperator):
+    """
+    Copies objects from a bucket to another using the GCP Storage Transfer
+    Service.
+
+    :param source_bucket: The source Google cloud storage bucket where the
+         object is. (templated)
+    :type source_bucket: str
+    :param destination_bucket: The destination Google cloud storage bucket
+        where the object should be. (templated)
+    :type destination_bucket: str
+    :param project_id: The ID of the Google Cloud Platform Console project that
+        owns the job
+    :type project_id: str
+    :param gcp_conn_id: Optional connection ID to use when connecting to Google Cloud
+        Storage.
+    :type gcp_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+    :param description: Optional transfer service job description
+    :type description: str
+    :param schedule: Optional transfer service schedule; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
+        If not set, run transfer job once as soon as the operator runs
+    :type schedule: dict
+    :param object_conditions: Optional transfer service object conditions; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#ObjectConditions
+    :type object_conditions: dict
+    :param transfer_options: Optional transfer service transfer options; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#TransferOptions
+    :type transfer_options: dict
+    :param wait: Wait for transfer to finish; defaults to `True`
+    :type wait: bool
+
+    **Example**:
+
+    .. code-block:: python
+
+       gcs_to_gcs_transfer_op = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id='gcs_to_gcs_transfer_example',
+            source_bucket='my-source-bucket',
+            destination_bucket='my-destination-bucket',
+            project_id='my-gcp-project',
+            dag=my_dag)
+    """
+
+    template_fields = ('source_bucket', 'destination_bucket', 'description', 'object_conditions')
+    ui_color = '#e09411'
+
+    @apply_defaults
+    def __init__(self,
+                 source_bucket,
+                 destination_bucket,
+                 project_id=None,
+                 gcp_conn_id='google_cloud_default',
+                 delegate_to=None,
+                 description=None,
+                 schedule=None,
+                 object_conditions=None,
+                 transfer_options=None,
+                 wait=True,
+                 *args,
+                 **kwargs):
+
+        super(GoogleCloudStorageToGoogleCloudStorageTransferOperator, self).__init__(
+            *args,
+            **kwargs)
+        self.source_bucket = source_bucket
+        self.destination_bucket = destination_bucket
+        self.project_id = project_id
+        self.gcp_conn_id = gcp_conn_id
+        self.delegate_to = delegate_to
+        self.description = description
+        self.schedule = schedule
+        self.object_conditions = object_conditions or {}
+        self.transfer_options = transfer_options or {}
+        self.wait = wait
+
+    def execute(self, context):
+        transfer_hook = GCPTransferServiceHook(
+            gcp_conn_id=self.gcp_conn_id,
+            delegate_to=self.delegate_to)
+
+        job = transfer_hook.create_transfer_job(
+            project_id=self.project_id,
+            description=self.description,
+            schedule=self.schedule,
+            transfer_spec={
+                'gcsDataSource': {
+                    'bucketName': self.source_bucket,
+                },
+                'gcsDataSink': {
+                    'bucketName': self.destination_bucket,
+                },
+                'objectConditions': self.object_conditions,
+                'transferOptions': self.transfer_options,
+            }
+        )
+
+        if self.wait:
+            transfer_hook.wait_for_transfer_job(job)
diff --git a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
index b0cf2ae515572..c46a9460e701c 100644
--- a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
@@ -33,7 +33,7 @@ class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
     :param gcs_bucket: The destination Google Cloud Storage bucket
         where you want to store the files. (templated)
     :type gcs_bucket: str
-    :param project_id: The ID of the Google Cloud Platform Console project that
+    :param project_id: Optional ID of the Google Cloud Platform Console project that
         owns the job
     :type project_id: str
     :param aws_conn_id: The source S3 connection
@@ -51,10 +51,10 @@ class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
         https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
         If not set, run transfer job once as soon as the operator runs
     :type schedule: dict
-    :param object_conditions: Transfer service object conditions; see
+    :param object_conditions: Optional transfer service object conditions; see
         https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
     :type object_conditions: dict
-    :param transfer_options: Transfer service transfer options; see
+    :param transfer_options: Optional transfer service transfer options; see
         https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
     :type transfer_options: dict
     :param wait: Wait for transfer to finish
@@ -79,7 +79,7 @@ class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
     def __init__(self,
                  s3_bucket,
                  gcs_bucket,
-                 project_id,
+                 project_id=None,
                  aws_conn_id='aws_default',
                  gcp_conn_id='google_cloud_default',
                  delegate_to=None,
diff --git a/docs/code.rst b/docs/code.rst
index 6f82166b10ff9..1850bdb14b24f 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -179,6 +179,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_s3.GoogleCloudStorageToS3Operator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPIOperator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPISendRoomNotificationOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index a04d71d825cb6..c12e9ac57e62d 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1243,6 +1243,7 @@ Storage Operators
 - :ref:`GoogleCloudStorageObjectCreateAclEntryOperator` : Creates a new ACL entry on the specified object.
 - :ref:`GoogleCloudStorageToBigQueryOperator` : Loads files from Google cloud storage into BigQuery.
 - :ref:`GoogleCloudStorageToGoogleCloudStorageOperator` : Copies objects from a bucket to another, with renaming if requested.
+- :ref:`GoogleCloudStorageToGoogleCloudStorageTransferOperator` : Copies objects from a bucket to another using Google Transfer service.
 - :ref:`MySqlToGoogleCloudStorageOperator`: Copy data from any MySQL Database to Google cloud storage in JSON format.
 
 .. _FileToGoogleCloudStorageOperator:
@@ -1301,6 +1302,13 @@ GoogleCloudStorageToGoogleCloudStorageOperator
 
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
 
+.. _GoogleCloudStorageToGoogleCloudStorageTransferOperator:
+
+GoogleCloudStorageToGoogleCloudStorageTransferOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageTransferOperator
+
 .. _MySqlToGoogleCloudStorageOperator:
 
 MySqlToGoogleCloudStorageOperator
diff --git a/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py b/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py
new file mode 100644
index 0000000000000..8c0cd4ebfcaa5
--- /dev/null
+++ b/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py
@@ -0,0 +1,131 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.operators.gcs_to_gcs_transfer_operator import \
+    GoogleCloudStorageToGoogleCloudStorageTransferOperator
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+TASK_ID = 'test-gcs-gcs-transfer-operator'
+SOURCE_BUCKET = 'test-source-bucket'
+DESTINATION_BUCKET = 'test-destination-bucket'
+PROJECT_ID = 'test-project'
+DESCRIPTION = 'test-description'
+SCHEDULE = {
+    'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
+    'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
+}
+
+
+class GoogleCloudStorageToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
+    def test_constructor(self):
+        """Test GoogleCloudStorageToGoogleCloudStorageTransferOperator instance is properly initialized."""
+
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=SOURCE_BUCKET,
+            destination_bucket=DESTINATION_BUCKET,
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE,
+        )
+
+        self.assertEqual(operator.task_id, TASK_ID)
+        self.assertEqual(operator.source_bucket, SOURCE_BUCKET)
+        self.assertEqual(operator.destination_bucket, DESTINATION_BUCKET)
+        self.assertEqual(operator.project_id, PROJECT_ID)
+        self.assertEqual(operator.description, DESCRIPTION)
+        self.assertEqual(operator.schedule, SCHEDULE)
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs_transfer_operator.GCPTransferServiceHook')
+    def test_execute(self, mock_transfer_hook):
+        """Test the execute function when the run is successful."""
+
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=SOURCE_BUCKET,
+            destination_bucket=DESTINATION_BUCKET,
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE,
+            transfer_spec={
+                'gcsDataSource': {
+                    'bucketName': SOURCE_BUCKET,
+                },
+                'gcsDataSink': {
+                    'bucketName': DESTINATION_BUCKET,
+                },
+                'objectConditions': {},
+                'transferOptions': {}
+            }
+        )
+
+        mock_transfer_hook.return_value.wait_for_transfer_job.assert_called_once_with(
+            mock_transfer_hook.return_value.create_transfer_job.return_value
+        )
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs_transfer_operator.GCPTransferServiceHook')
+    def test_execute_skip_wait(self, mock_transfer_hook):
+        """Test the execute function when the run is successful."""
+
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=SOURCE_BUCKET,
+            destination_bucket=DESTINATION_BUCKET,
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            wait=False,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            project_id=PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=None,
+            transfer_spec={
+                'gcsDataSource': {
+                    'bucketName': SOURCE_BUCKET,
+                },
+                'gcsDataSink': {
+                    'bucketName': DESTINATION_BUCKET,
+                },
+                'objectConditions': {},
+                'transferOptions': {}
+            }
+        )
+
+        assert not mock_transfer_hook.return_value.wait_for_transfer_job.called
diff --git a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
index 2bf51c0707577..0825364884a78 100644
--- a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
@@ -59,6 +59,7 @@ def test_constructor(self):
             gcs_bucket=GCS_BUCKET,
             project_id=PROJECT_ID,
             description=DESCRIPTION,
+            schedule=SCHEDULE,
         )
 
         self.assertEqual(operator.task_id, TASK_ID)
@@ -66,6 +67,7 @@ def test_constructor(self):
         self.assertEqual(operator.gcs_bucket, GCS_BUCKET)
         self.assertEqual(operator.project_id, PROJECT_ID)
         self.assertEqual(operator.description, DESCRIPTION)
+        self.assertEqual(operator.schedule, SCHEDULE)
 
     @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
     @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')

From d36dd170b3b1ee2dbcbd1729f28034a5f8653e56 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 6 Jan 2019 21:40:54 +0000
Subject: [PATCH 344/808] [AIRFLOW-3531] Fix test for GCS to GCS Transfer Hook
 (#4452)

---
 tests/contrib/hooks/test_gcp_transfer_hook.py | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/tests/contrib/hooks/test_gcp_transfer_hook.py b/tests/contrib/hooks/test_gcp_transfer_hook.py
index 1107775f9170c..e42550979d836 100644
--- a/tests/contrib/hooks/test_gcp_transfer_hook.py
+++ b/tests/contrib/hooks/test_gcp_transfer_hook.py
@@ -54,7 +54,10 @@ def test_create_transfer_job(self):
             'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
         }
         self.transfer_hook.create_transfer_job(
-            'test-project', 'test-description', None, transfer_spec)
+            project_id='test-project',
+            description='test-description',
+            schedule=None,
+            transfer_spec=transfer_spec)
         mock_create.assert_called_once_with(body={
             'status': 'ENABLED',
             'projectId': 'test-project',
@@ -90,7 +93,10 @@ def test_create_transfer_job_custom_schedule(self):
             'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
         }
         self.transfer_hook.create_transfer_job(
-            'test-project', 'test-description', schedule, transfer_spec)
+            project_id='test-project',
+            description='test-description',
+            schedule=schedule,
+            transfer_spec=transfer_spec)
         mock_create.assert_called_once_with(body={
             'status': 'ENABLED',
             'projectId': 'test-project',

From f71a86d66589f0a56953cdaffa45d889855e1d87 Mon Sep 17 00:00:00 2001
From: Dana Ma <dana.ma537@gmail.com>
Date: Mon, 7 Jan 2019 08:51:01 +1100
Subject: [PATCH 345/808] [AIRFLOW-3610] Add region param for EMR jobflow
 creation (#4418)

---
 airflow/contrib/hooks/emr_hook.py                            | 5 +++--
 airflow/contrib/operators/emr_create_job_flow_operator.py    | 4 +++-
 tests/contrib/hooks/test_emr_hook.py                         | 2 +-
 tests/contrib/operators/test_emr_create_job_flow_operator.py | 2 ++
 4 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/airflow/contrib/hooks/emr_hook.py b/airflow/contrib/hooks/emr_hook.py
index fcdf4ac84852e..7571d0988f697 100644
--- a/airflow/contrib/hooks/emr_hook.py
+++ b/airflow/contrib/hooks/emr_hook.py
@@ -27,12 +27,13 @@ class EmrHook(AwsHook):
     create_job_flow method.
     """
 
-    def __init__(self, emr_conn_id=None, *args, **kwargs):
+    def __init__(self, emr_conn_id=None, region_name=None, *args, **kwargs):
         self.emr_conn_id = emr_conn_id
+        self.region_name = region_name
         super(EmrHook, self).__init__(*args, **kwargs)
 
     def get_conn(self):
-        self.conn = self.get_client_type('emr')
+        self.conn = self.get_client_type('emr', self.region_name)
         return self.conn
 
     def create_job_flow(self, job_flow_overrides):
diff --git a/airflow/contrib/operators/emr_create_job_flow_operator.py b/airflow/contrib/operators/emr_create_job_flow_operator.py
index 89be12f0657e4..bdf10b1ff654c 100644
--- a/airflow/contrib/operators/emr_create_job_flow_operator.py
+++ b/airflow/contrib/operators/emr_create_job_flow_operator.py
@@ -46,6 +46,7 @@ def __init__(
             aws_conn_id='s3_default',
             emr_conn_id='emr_default',
             job_flow_overrides=None,
+            region_name=None,
             *args, **kwargs):
         super(EmrCreateJobFlowOperator, self).__init__(*args, **kwargs)
         self.aws_conn_id = aws_conn_id
@@ -53,9 +54,10 @@ def __init__(
         if job_flow_overrides is None:
             job_flow_overrides = {}
         self.job_flow_overrides = job_flow_overrides
+        self.region_name = region_name
 
     def execute(self, context):
-        emr = EmrHook(aws_conn_id=self.aws_conn_id, emr_conn_id=self.emr_conn_id)
+        emr = EmrHook(aws_conn_id=self.aws_conn_id, emr_conn_id=self.emr_conn_id, region_name=self.region_name)
 
         self.log.info(
             'Creating JobFlow using aws-conn-id: %s, emr-conn-id: %s',
diff --git a/tests/contrib/hooks/test_emr_hook.py b/tests/contrib/hooks/test_emr_hook.py
index 814b4b317feae..9116b96ae3ed4 100644
--- a/tests/contrib/hooks/test_emr_hook.py
+++ b/tests/contrib/hooks/test_emr_hook.py
@@ -39,7 +39,7 @@ def setUp(self):
 
     @mock_emr
     def test_get_conn_returns_a_boto3_connection(self):
-        hook = EmrHook(aws_conn_id='aws_default')
+        hook = EmrHook(aws_conn_id='aws_default', region_name='ap-southeast-2')
         self.assertIsNotNone(hook.get_conn().list_clusters())
 
     @mock_emr
diff --git a/tests/contrib/operators/test_emr_create_job_flow_operator.py b/tests/contrib/operators/test_emr_create_job_flow_operator.py
index 7dae30d43a809..18b07b23b4a6f 100644
--- a/tests/contrib/operators/test_emr_create_job_flow_operator.py
+++ b/tests/contrib/operators/test_emr_create_job_flow_operator.py
@@ -71,12 +71,14 @@ def setUp(self):
             aws_conn_id='aws_default',
             emr_conn_id='emr_default',
             job_flow_overrides=self._config,
+            region_name='ap-southeast-2',
             dag=DAG('test_dag_id', default_args=args)
         )
 
     def test_init(self):
         self.assertEqual(self.operator.aws_conn_id, 'aws_default')
         self.assertEqual(self.operator.emr_conn_id, 'emr_default')
+        self.assertEqual(self.operator.region_name, 'ap-southeast-2')
 
     def test_render_template(self):
         ti = TaskInstance(self.operator, DEFAULT_DATE)

From 42386f0e456f2409a68094634ae6766ec72ac970 Mon Sep 17 00:00:00 2001
From: Raja Gangopadhya <raja.gangopadhya@remix.com>
Date: Sun, 6 Jan 2019 13:59:55 -0800
Subject: [PATCH 346/808] [AIRFLOW-2082] Resolve a bug in adding password_auth
 to api as auth method (#4343)

---
 airflow/contrib/auth/backends/password_auth.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/airflow/contrib/auth/backends/password_auth.py b/airflow/contrib/auth/backends/password_auth.py
index dcdb1d1225d42..0bc04fcea8730 100644
--- a/airflow/contrib/auth/backends/password_auth.py
+++ b/airflow/contrib/auth/backends/password_auth.py
@@ -48,6 +48,9 @@
 PY3 = version_info[0] == 3
 
 
+client_auth = None
+
+
 class AuthenticationError(Exception):
     pass
 

From 1e0b95fa2c6573a81f8e457d09d32957967fa2ba Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Sun, 6 Jan 2019 20:45:49 -0800
Subject: [PATCH 347/808] [AIRFLOW-XXX] Fix a flake8 error to unblock CI
 (#4453)

---
 airflow/contrib/operators/emr_create_job_flow_operator.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/emr_create_job_flow_operator.py b/airflow/contrib/operators/emr_create_job_flow_operator.py
index bdf10b1ff654c..5a39713b8a931 100644
--- a/airflow/contrib/operators/emr_create_job_flow_operator.py
+++ b/airflow/contrib/operators/emr_create_job_flow_operator.py
@@ -57,7 +57,9 @@ def __init__(
         self.region_name = region_name
 
     def execute(self, context):
-        emr = EmrHook(aws_conn_id=self.aws_conn_id, emr_conn_id=self.emr_conn_id, region_name=self.region_name)
+        emr = EmrHook(aws_conn_id=self.aws_conn_id,
+                      emr_conn_id=self.emr_conn_id,
+                      region_name=self.region_name)
 
         self.log.info(
             'Creating JobFlow using aws-conn-id: %s, emr-conn-id: %s',

From 2a315c70831bebaf038ff5cf076fd526830c0430 Mon Sep 17 00:00:00 2001
From: Kevin Pullin <kevin.pullin@gmail.com>
Date: Mon, 7 Jan 2019 12:46:05 -0800
Subject: [PATCH 348/808] [AIRFLOW-3402] Support global k8s affinity and
 toleration configs (#4247)

---
 airflow/config_templates/default_airflow.cfg  | 10 +++
 .../example_kubernetes_executor.py            | 32 ++++++-
 .../contrib/executors/kubernetes_executor.py  | 23 ++++-
 airflow/contrib/kubernetes/pod.py             |  4 +
 .../kubernetes/worker_configuration.py        |  8 +-
 .../operators/kubernetes_pod_operator.py      |  6 +-
 scripts/ci/kubernetes/kube/configmaps.yaml    |  4 +
 .../executors/test_kubernetes_executor.py     | 88 ++++++++++++++++++-
 8 files changed, 162 insertions(+), 13 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index c8aa4061e7271..a72604a536c01 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -630,6 +630,16 @@ gcp_service_account_keys =
 # It will raise an exception if called from a process not running in a kubernetes environment.
 in_cluster = True
 
+# Affinity configuration as a single line formatted JSON object.
+# See the affinity model for top-level key names (e.g. `nodeAffinity`, etc.):
+#   https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.12/#affinity-v1-core
+affinity =
+
+# A list of toleration objects as a single line formatted JSON array
+# See:
+#   https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.12/#toleration-v1-core
+tolerations =
+
 [kubernetes_node_selectors]
 # The Key-value pairs to be given to worker pods.
 # The worker pods will be scheduled to the nodes of the specified key-value pairs.
diff --git a/airflow/contrib/example_dags/example_kubernetes_executor.py b/airflow/contrib/example_dags/example_kubernetes_executor.py
index 1d9bb7304318b..d03e255ab3287 100644
--- a/airflow/contrib/example_dags/example_kubernetes_executor.py
+++ b/airflow/contrib/example_dags/example_kubernetes_executor.py
@@ -32,6 +32,31 @@
     schedule_interval=None
 )
 
+affinity = {
+    'podAntiAffinity': {
+        'requiredDuringSchedulingIgnoredDuringExecution': [
+            {
+                'topologyKey': 'kubernetes.io/hostname',
+                'labelSelector': {
+                    'matchExpressions': [
+                        {
+                            'key': 'app',
+                            'operator': 'In',
+                            'values': ['airflow']
+                        }
+                    ]
+                }
+            }
+        ]
+    }
+}
+
+tolerations = [{
+    'key': 'dedicated',
+    'operator': 'Equal',
+    'value': 'airflow'
+}]
+
 
 def print_stuff():
     print("stuff!")
@@ -59,11 +84,14 @@ def use_zip_binary():
     executor_config={"KubernetesExecutor": {"image": "airflow/ci_zip:latest"}}
 )
 
-# Limit resources on this operator/task
+# Limit resources on this operator/task with node affinity & tolerations
 three_task = PythonOperator(
     task_id="three_task", python_callable=print_stuff, dag=dag,
     executor_config={
-        "KubernetesExecutor": {"request_memory": "128Mi", "limit_memory": "128Mi"}}
+        "KubernetesExecutor": {"request_memory": "128Mi",
+                               "limit_memory": "128Mi",
+                               "tolerations": tolerations,
+                               "affinity": affinity}}
 )
 
 start_task.set_downstream([one_task, two_task, three_task])
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index dd9cd3ec53b15..e06a5f47e1ed0 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -16,6 +16,7 @@
 # under the License.
 
 import base64
+import json
 import multiprocessing
 from queue import Queue
 from dateutil import parser
@@ -40,7 +41,7 @@ class KubernetesExecutorConfig:
     def __init__(self, image=None, image_pull_policy=None, request_memory=None,
                  request_cpu=None, limit_memory=None, limit_cpu=None,
                  gcp_service_account_key=None, node_selectors=None, affinity=None,
-                 annotations=None, volumes=None, volume_mounts=None):
+                 annotations=None, volumes=None, volume_mounts=None, tolerations=None):
         self.image = image
         self.image_pull_policy = image_pull_policy
         self.request_memory = request_memory
@@ -53,16 +54,18 @@ def __init__(self, image=None, image_pull_policy=None, request_memory=None,
         self.annotations = annotations
         self.volumes = volumes
         self.volume_mounts = volume_mounts
+        self.tolerations = tolerations
 
     def __repr__(self):
         return "{}(image={}, image_pull_policy={}, request_memory={}, request_cpu={}, " \
                "limit_memory={}, limit_cpu={}, gcp_service_account_key={}, " \
                "node_selectors={}, affinity={}, annotations={}, volumes={}, " \
-               "volume_mounts={})" \
+               "volume_mounts={}, tolerations={})" \
             .format(KubernetesExecutorConfig.__name__, self.image, self.image_pull_policy,
                     self.request_memory, self.request_cpu, self.limit_memory,
                     self.limit_cpu, self.gcp_service_account_key, self.node_selectors,
-                    self.affinity, self.annotations, self.volumes, self.volume_mounts)
+                    self.affinity, self.annotations, self.volumes, self.volume_mounts,
+                    self.tolerations)
 
     @staticmethod
     def from_dict(obj):
@@ -88,6 +91,7 @@ def from_dict(obj):
             annotations=namespaced.get('annotations', {}),
             volumes=namespaced.get('volumes', []),
             volume_mounts=namespaced.get('volume_mounts', []),
+            tolerations=namespaced.get('tolerations', None),
         )
 
     def as_dict(self):
@@ -104,6 +108,7 @@ def as_dict(self):
             'annotations': self.annotations,
             'volumes': self.volumes,
             'volume_mounts': self.volume_mounts,
+            'tolerations': self.tolerations,
         }
 
 
@@ -205,6 +210,18 @@ def __init__(self):
         # configmap
         self.airflow_configmap = conf.get(self.kubernetes_section, 'airflow_configmap')
 
+        affinity_json = conf.get(self.kubernetes_section, 'affinity')
+        if affinity_json:
+            self.kube_affinity = json.loads(affinity_json)
+        else:
+            self.kube_affinity = None
+
+        tolerations_json = conf.get(self.kubernetes_section, 'tolerations')
+        if tolerations_json:
+            self.kube_tolerations = json.loads(tolerations_json)
+        else:
+            self.kube_tolerations = None
+
         self._validate()
 
     def _validate(self):
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index bad5caa738e1b..6d2977592598a 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -60,6 +60,10 @@ class Pod:
     :type image_pull_secrets: str
     :param affinity: A dict containing a group of affinity scheduling rules
     :type affinity: dict
+    :param hostnetwork: If True enable host networking on the pod
+    :type hostnetwork: bool
+    :param tolerations: A list of kubernetes tolerations
+    :type tolerations: list
     """
     def __init__(
             self,
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index d83be81c1f704..c2e7768baae8f 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -205,10 +205,13 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             limit_cpu=kube_executor_config.limit_cpu
         )
         gcp_sa_key = kube_executor_config.gcp_service_account_key
-        annotations = kube_executor_config.annotations.copy()
+        annotations = dict(kube_executor_config.annotations)
         if gcp_sa_key:
             annotations['iam.cloud.google.com/service-account'] = gcp_sa_key
 
+        affinity = kube_executor_config.affinity or self.kube_config.kube_affinity
+        tolerations = kube_executor_config.tolerations or self.kube_config.kube_tolerations
+
         return Pod(
             namespace=namespace,
             name=pod_id,
@@ -234,5 +237,6 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             annotations=annotations,
             node_selectors=(kube_executor_config.node_selectors or
                             self.kube_config.kube_node_selectors),
-            affinity=kube_executor_config.affinity
+            affinity=affinity,
+            tolerations=tolerations
         )
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index a29b61998d181..4494754f970f8 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -84,8 +84,10 @@ class KubernetesPodOperator(BaseOperator):
         /airflow/xcom/return.json in the container will also be pushed to an
         XCom when the container completes.
     :type xcom_push: bool
-    :param tolerations: Kubernetes tolerations
-    :type list of tolerations
+    :param hostnetwork: If True enable host networking on the pod
+    :type hostnetwork: bool
+    :param tolerations: A list of kubernetes tolerations
+    :type tolerations: list tolerations
     """
     template_fields = ('cmds', 'arguments', 'env_vars', 'config_file')
 
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index c8e6b19076d1d..b5fa3e5f639ee 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -192,6 +192,10 @@ data:
     namespace = default
     gcp_service_account_keys =
 
+    # Example affinity and toleration definitions.
+    affinity = {"nodeAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"kubernetes.io/hostname","operator":"NotIn","values":["4e5e6a99-e28a-450b-bba9-e0124853de9b"]}]}]}}}
+    tolerations = [{ "key": "dedicated", "operator": "Equal", "value": "airflow", "effect": "NoSchedule" }, { "key": "prod", "operator": "Exists" }]
+
     # For cloning DAGs from git repositories into volumes: https://github.com/kubernetes/git-sync
     git_sync_container_repository = gcr.io/google-containers/git-sync-amd64
     git_sync_container_tag = v2.0.5
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index f93a9d81e142d..1b5c4c015d963 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -14,6 +14,7 @@
 #
 
 import unittest
+import uuid
 import mock
 import re
 import string
@@ -22,6 +23,7 @@
 
 try:
     from airflow.contrib.executors.kubernetes_executor import AirflowKubernetesScheduler
+    from airflow.contrib.executors.kubernetes_executor import KubernetesExecutorConfig
     from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
 except ImportError:
     AirflowKubernetesScheduler = None
@@ -81,13 +83,42 @@ class TestKubernetesWorkerConfiguration(unittest.TestCase):
     Tests that if dags_volume_subpath/logs_volume_subpath configuration
     options are passed to worker pod config
     """
+
+    affinity_config = {
+        'podAntiAffinity': {
+            'requiredDuringSchedulingIgnoredDuringExecution': [
+                {
+                    'topologyKey': 'kubernetes.io/hostname',
+                    'labelSelector': {
+                        'matchExpressions': [
+                            {
+                                'key': 'app',
+                                'operator': 'In',
+                                'values': ['airflow']
+                            }
+                        ]
+                    }
+                }
+            ]
+        }
+    }
+
+    tolerations_config = [
+        {
+            'key': 'dedicated',
+            'operator': 'Equal',
+            'value': 'airflow'
+        },
+        {
+            'key': 'prod',
+            'operator': 'Exists'
+        }
+    ]
+
     def setUp(self):
         if AirflowKubernetesScheduler is None:
             self.skipTest("kubernetes python package is not installed")
 
-        self.pod = mock.patch(
-            'airflow.contrib.kubernetes.worker_configuration.Pod'
-        )
         self.resources = mock.patch(
             'airflow.contrib.kubernetes.worker_configuration.Resources'
         )
@@ -95,7 +126,7 @@ def setUp(self):
             'airflow.contrib.kubernetes.worker_configuration.Secret'
         )
 
-        for patcher in [self.pod, self.resources, self.secret]:
+        for patcher in [self.resources, self.secret]:
             self.mock_foo = patcher.start()
             self.addCleanup(patcher.stop)
 
@@ -152,6 +183,55 @@ def test_worker_environment_when_dags_folder_specified(self):
 
         self.assertEqual(dags_folder, env['AIRFLOW__CORE__DAGS_FOLDER'])
 
+    def test_make_pod_with_empty_executor_config(self):
+        self.kube_config.kube_affinity = self.affinity_config
+        self.kube_config.kube_tolerations = self.tolerations_config
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        kube_executor_config = KubernetesExecutorConfig(annotations=[],
+                                                        volumes=[],
+                                                        volume_mounts=[]
+                                                        )
+
+        pod = worker_config.make_pod("default", str(uuid.uuid4()), "test_pod_id", "test_dag_id",
+                                     "test_task_id", str(datetime.utcnow()), "bash -c 'ls /'",
+                                     kube_executor_config)
+
+        self.assertTrue(pod.affinity['podAntiAffinity'] is not None)
+        self.assertEqual('app',
+                         pod.affinity['podAntiAffinity']
+                         ['requiredDuringSchedulingIgnoredDuringExecution'][0]
+                         ['labelSelector']
+                         ['matchExpressions'][0]
+                         ['key'])
+
+        self.assertEqual(2, len(pod.tolerations))
+        self.assertEqual('prod', pod.tolerations[1]['key'])
+
+    def test_make_pod_with_executor_config(self):
+        worker_config = WorkerConfiguration(self.kube_config)
+        kube_executor_config = KubernetesExecutorConfig(affinity=self.affinity_config,
+                                                        tolerations=self.tolerations_config,
+                                                        annotations=[],
+                                                        volumes=[],
+                                                        volume_mounts=[]
+                                                        )
+
+        pod = worker_config.make_pod("default", str(uuid.uuid4()), "test_pod_id", "test_dag_id",
+                                     "test_task_id", str(datetime.utcnow()), "bash -c 'ls /'",
+                                     kube_executor_config)
+
+        self.assertTrue(pod.affinity['podAntiAffinity'] is not None)
+        self.assertEqual('app',
+                         pod.affinity['podAntiAffinity']
+                         ['requiredDuringSchedulingIgnoredDuringExecution'][0]
+                         ['labelSelector']
+                         ['matchExpressions'][0]
+                         ['key'])
+
+        self.assertEqual(2, len(pod.tolerations))
+        self.assertEqual('prod', pod.tolerations[1]['key'])
+
     def test_worker_pvc_dags(self):
         # Tests persistence volume config created when `dags_volume_claim` is set
         self.kube_config.dags_volume_claim = 'airflow-dags'

From b0cbdbb00011a719178bf1f7d946e8cc02f2ae57 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Mon, 7 Jan 2019 21:05:50 +0000
Subject: [PATCH 349/808] Revert "[AIRFLOW-XXX] Switch to openjdk8 in Travis
 tests"

This reverts commit 47ab0401d9a7c369151cc1800fee6adfe0efde53.
---
 .travis.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index fae1ecc5f04f3..e078d7c9ae884 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -20,7 +20,7 @@ sudo: true
 dist: trusty
 language: python
 jdk:
-  - openjdk8
+  - oraclejdk8
 services:
   - cassandra
   - mongodb
@@ -93,7 +93,7 @@ before_install:
   - cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
   - ln -s ~/.ssh/authorized_keys ~/.ssh/authorized_keys2
   - chmod 600 ~/.ssh/*
-  - jdk_switcher use openjdk8
+  - jdk_switcher use oraclejdk8
 install:
   - pip install --upgrade pip
   - pip install tox

From 712ea9af64daeace77ecabc6a5a67308e59cd74b Mon Sep 17 00:00:00 2001
From: Gerardo Curiel <gerardo@gerar.do>
Date: Wed, 22 Aug 2018 18:26:54 +1000
Subject: [PATCH 350/808] [AIRFLOW-2499] Dockerise CI pipeline (#3393)

---
 .travis.yml                                   |  89 ++-------
 CONTRIBUTING.md                               | 180 +++++++++---------
 README.md                                     |   3 +-
 airflow/operators/python_operator.py          |   2 -
 airflow/utils/db.py                           |  15 +-
 run_tox.sh                                    |  21 --
 run_unit_tests.sh                             |  64 +++----
 scripts/ci/{ldap.sh => 1-setup-env.sh}        |  27 ++-
 .../ci/{load_fixtures.sh => 2-setup-kdc.sh}   |  30 +--
 ...{travis_script.sh => 3-setup-databases.sh} |  25 +--
 scripts/ci/{load_data.sh => 4-load-data.sh}   |  11 +-
 scripts/ci/5-run-tests.sh                     |   6 +
 .../{check-license.sh => 6-check-license.sh}  |   8 +-
 scripts/ci/airflow_travis.cfg                 |   6 +-
 scripts/ci/docker-compose.yml                 |  90 +++++++++
 scripts/ci/{flake8_diff.sh => flake8-diff.sh} |   0
 scripts/ci/{run_tests.sh => krb5/Dockerfile}  |  51 ++---
 .../ci/{ => krb5/krb-conf/client}/krb5.conf   |   7 +-
 .../ci/{ => krb5/krb-conf/server}/kadm5.acl   |   4 +-
 .../ci/{ => krb5/krb-conf/server}/kdc.conf    |   4 +-
 .../ci/{setup_kdc.sh => krb5/start_kdc.sh}    |  31 +--
 scripts/ci/krb5/supervisord.conf              |  43 +++++
 scripts/ci/ldif/example.com.ldif              |  24 ---
 .../ci/{my.cnf => mysql/conf.d/airflow.cnf}   |   4 +-
 .../ldif/01-users.example.com.ldif}           |   4 +-
 .../ldif/02-groups.example.com.ldif}          |   6 +-
 .../ldif/03-manager.example.com.ldif}         |   4 +-
 .../ci/openldap/ldif/04-rootdn.ldif           |  13 +-
 scripts/ci/{ => openldap}/slapd.conf          |   5 +-
 scripts/ci/run-ci.sh                          |  56 ++++++
 scripts/ci/setup_env.sh                       | 166 ----------------
 scripts/ci/test-environment.sh                |  19 ++
 tests/contrib/hooks/test_cassandra_hook.py    |   2 +-
 tests/contrib/sensors/test_mongo_sensor.py    |   2 +-
 tests/core.py                                 |   4 +-
 tox.ini                                       |  39 ++--
 36 files changed, 485 insertions(+), 580 deletions(-)
 delete mode 100755 run_tox.sh
 rename scripts/ci/{ldap.sh => 1-setup-env.sh} (67%)
 rename scripts/ci/{load_fixtures.sh => 2-setup-kdc.sh} (59%)
 rename scripts/ci/{travis_script.sh => 3-setup-databases.sh} (58%)
 rename scripts/ci/{load_data.sh => 4-load-data.sh} (81%)
 rename scripts/ci/{check-license.sh => 6-check-license.sh} (94%)
 create mode 100644 scripts/ci/docker-compose.yml
 rename scripts/ci/{flake8_diff.sh => flake8-diff.sh} (100%)
 rename scripts/ci/{run_tests.sh => krb5/Dockerfile} (51%)
 mode change 100755 => 100644
 rename scripts/ci/{ => krb5/krb-conf/client}/krb5.conf (94%)
 rename scripts/ci/{ => krb5/krb-conf/server}/kadm5.acl (99%)
 rename scripts/ci/{ => krb5/krb-conf/server}/kdc.conf (99%)
 rename scripts/ci/{setup_kdc.sh => krb5/start_kdc.sh} (75%)
 create mode 100644 scripts/ci/krb5/supervisord.conf
 delete mode 100644 scripts/ci/ldif/example.com.ldif
 rename scripts/ci/{my.cnf => mysql/conf.d/airflow.cnf} (99%)
 rename scripts/ci/{ldif/users.example.com.ldif => openldap/ldif/01-users.example.com.ldif} (99%)
 rename scripts/ci/{ldif/groups.example.com.ldif => openldap/ldif/02-groups.example.com.ldif} (96%)
 rename scripts/ci/{ldif/manager.example.com.ldif => openldap/ldif/03-manager.example.com.ldif} (99%)
 rename init.sh => scripts/ci/openldap/ldif/04-rootdn.ldif (84%)
 rename scripts/ci/{ => openldap}/slapd.conf (99%)
 create mode 100755 scripts/ci/run-ci.sh
 delete mode 100755 scripts/ci/setup_env.sh
 create mode 100644 scripts/ci/test-environment.sh

diff --git a/.travis.yml b/.travis.yml
index e078d7c9ae884..9c7cfd02084db 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -19,95 +19,40 @@
 sudo: true
 dist: trusty
 language: python
-jdk:
-  - oraclejdk8
-services:
-  - cassandra
-  - mongodb
-  - mysql
-  - postgresql
-  - rabbitmq
-addons:
-  apt:
-    packages:
-      - slapd
-      - ldap-utils
-      - openssh-server
-      - mysql-server-5.6
-      - mysql-client-core-5.6
-      - mysql-client-5.6
-      - krb5-user
-      - krb5-kdc
-      - krb5-admin-server
-      - oracle-java8-installer
-      - python-selinux
-  postgresql: "9.2"
-python:
-  - "2.7"
-  - "3.5"
 env:
   global:
+    - DOCKER_COMPOSE_VERSION=1.20.0
     - SLUGIFY_USES_TEXT_UNIDECODE=yes
     - TRAVIS_CACHE=$HOME/.travis_cache/
-    - KRB5_CONFIG=/etc/krb5.conf
-    - KRB5_KTNAME=/etc/airflow.keytab
-    # Travis on google cloud engine has a global /etc/boto.cfg that
-    # does not work with python 3
-    - BOTO_CONFIG=/tmp/bogusvalue
   matrix:
+    - TOX_ENV=flake8
     - TOX_ENV=py27-backend_mysql
     - TOX_ENV=py27-backend_sqlite
     - TOX_ENV=py27-backend_postgres
-    - TOX_ENV=py35-backend_mysql
-    - TOX_ENV=py35-backend_sqlite
-    - TOX_ENV=py35-backend_postgres
-    - TOX_ENV=flake8
+    - TOX_ENV=py35-backend_mysql PYTHON_VERSION=3
+    - TOX_ENV=py35-backend_sqlite PYTHON_VERSION=3
+    - TOX_ENV=py35-backend_postgres PYTHON_VERSION=3
     - TOX_ENV=py27-backend_postgres KUBERNETES_VERSION=v1.9.0
-    - TOX_ENV=py35-backend_postgres KUBERNETES_VERSION=v1.10.0
-matrix:
-  exclude:
-    - python: "3.5"
-      env: TOX_ENV=py27-backend_mysql
-    - python: "3.5"
-      env: TOX_ENV=py27-backend_sqlite
-    - python: "3.5"
-      env: TOX_ENV=py27-backend_postgres
-    - python: "2.7"
-      env: TOX_ENV=py35-backend_mysql
-    - python: "2.7"
-      env: TOX_ENV=py35-backend_sqlite
-    - python: "2.7"
-      env: TOX_ENV=py35-backend_postgres
-    - python: "2.7"
-      env: TOX_ENV=flake8
-    - python: "3.5"
-      env: TOX_ENV=py27-backend_postgres KUBERNETES_VERSION=v1.9.0
-    - python: "2.7"
-      env: TOX_ENV=py35-backend_postgres KUBERNETES_VERSION=v1.10.0
+    - TOX_ENV=py35-backend_postgres KUBERNETES_VERSION=v1.10.0 PYTHON_VERSION=3
 cache:
   directories:
     - $HOME/.wheelhouse/
+    - $HOME/.cache/pip
     - $HOME/.travis_cache/
 before_install:
-  - yes | ssh-keygen -t rsa -C your_email@youremail.com -P '' -f ~/.ssh/id_rsa
-  - cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
-  - ln -s ~/.ssh/authorized_keys ~/.ssh/authorized_keys2
-  - chmod 600 ~/.ssh/*
-  - jdk_switcher use oraclejdk8
+  - sudo ls -lh $HOME/.cache/pip/
+  - sudo rm -rf $HOME/.cache/pip/* $HOME/.wheelhouse/*
+  - sudo chown -R travis.travis $HOME/.cache/pip
 install:
+  # Use recent docker-compose version
+  - sudo rm /usr/local/bin/docker-compose
+  - curl -L https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-`uname -s`-`uname -m` > docker-compose
+  - chmod +x docker-compose
+  - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
-  - pip install tox
   - pip install codecov
-before_script:
-  - cat "$TRAVIS_BUILD_DIR/scripts/ci/my.cnf" | sudo tee -a /etc/mysql/my.cnf
-  - mysql -e 'drop database if exists airflow; create database airflow' -u root
-  - sudo service mysql restart
-  - psql -c 'create database airflow;' -U postgres
-  - export PATH=${PATH}:/tmp/hive/bin
-  # Required for K8s v1.10.x. See
-  # https://github.com/kubernetes/kubernetes/issues/61058#issuecomment-372764783
-  - sudo mount --make-shared / && sudo service docker restart
 script:
-  - ./scripts/ci/travis_script.sh
+  - docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
 after_success:
+  - sudo chown -R travis.travis .
   - codecov
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b7a1b1e0a361f..57178abb4b7cd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,7 +22,6 @@ under the License.
 Contributions are welcome and are greatly appreciated! Every
 little bit helps, and credit will always be given.
 
-
 # Table of Contents
   * [TOC](#table-of-contents)
   * [Types of Contributions](#types-of-contributions)
@@ -34,11 +33,10 @@ little bit helps, and credit will always be given.
   * [Documentation](#documentation)
   * [Development and Testing](#development-and-testing)
       - [Setting up a development environment](#setting-up-a-development-environment)
-      - [Pull requests guidelines](#pull-request-guidelines)
-      - [Testing Locally](#testing-locally)
+      - [Running unit tests](#running-unit-tests)
+  * [Pull requests guidelines](#pull-request-guidelines)
   * [Changing the Metadata Database](#changing-the-metadata-database)
 
-
 ## Types of Contributions
 
 ### Report Bugs
@@ -98,55 +96,110 @@ extras to build the full API reference.
 
 ## Development and Testing
 
-### Set up a development env using Docker
+### Set up a development environment
 
-Go to your Airflow directory and start a new docker container. You can choose between Python 2 or 3, whatever you prefer.
+There are three ways to setup an Apache Airflow development environment.
 
-```
-# Start docker in your Airflow directory
-docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:2 bash
+1. Using tools and libraries installed directly on your system.
+
+  Install Python (2.7.x or 3.4.x), MySQL, and libxml by using system-level package
+  managers like yum, apt-get for Linux, or Homebrew for Mac OS at first. Refer to the [base CI Dockerfile](https://github.com/apache/incubator-airflow-ci/blob/master/Dockerfile.base) for
+  a comprehensive list of required packages.
+
+  Then install python development requirements. It is usually best to work in a virtualenv:
+
+  ```bash
+  cd $AIRFLOW_HOME
+  virtualenv env
+  source env/bin/activate
+  pip install -e .[devel]
+  ```
+
+2. Using a Docker container
+
+  Go to your Airflow directory and start a new docker container. You can choose between Python 2 or 3, whatever you prefer.
+
+  ```
+  # Start docker in your Airflow directory
+  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:2 bash
+
+  # Go to the Airflow directory
+  cd /airflow/
+
+  # Install Airflow with all the required dependencies,
+  # including the devel which will provide the development tools
+  pip install -e ".[hdfs,hive,druid,devel]"
+
+  # Init the database
+  airflow initdb
+
+  nosetests -v tests/hooks/test_druid_hook.py
+
+    test_get_first_record (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
+    test_get_records (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
+    test_get_uri (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
+    test_get_conn_url (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+    test_submit_gone_wrong (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+    test_submit_ok (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+    test_submit_timeout (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+    test_submit_unknown_response (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+
+    ----------------------------------------------------------------------
+    Ran 8 tests in 3.036s
+
+    OK
+  ```
 
-# Install Airflow with all the required dependencies,
-# including the devel which will provide the development tools
-pip install -e .[devel,druid,hdfs,hive]
+  The Airflow code is mounted inside of the Docker container, so if you change something using your favorite IDE, you can directly test is in the container.
 
-# Init the database
-airflow initdb
+3. Using [Docker Compose](https://docs.docker.com/compose/) and Airflow's CI scripts.
 
-nosetests -v tests/hooks/test_druid_hook.py
+  Start a docker container through Compose for development to avoid installing the packages directly on your system. The following will give you a shell inside a container, run all required service containers (MySQL, PostgresSQL, krb5 and so on) and install all the dependencies:
 
-  test_get_first_record (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
-  test_get_records (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
-  test_get_uri (tests.hooks.test_druid_hook.TestDruidDbApiHook) ... ok
-  test_get_conn_url (tests.hooks.test_druid_hook.TestDruidHook) ... ok
-  test_submit_gone_wrong (tests.hooks.test_druid_hook.TestDruidHook) ... ok
-  test_submit_ok (tests.hooks.test_druid_hook.TestDruidHook) ... ok
-  test_submit_timeout (tests.hooks.test_druid_hook.TestDruidHook) ... ok
-  test_submit_unknown_response (tests.hooks.test_druid_hook.TestDruidHook) ... ok
+  ```bash
+  docker-compose -f scripts/ci/docker-compose.yml run airflow-testing bash
+  # From the container
+  pip install -e .[devel]
+  # Run all the tests with python and mysql through tox
+  tox -e py35-backend_mysql
+  ```
 
-  ----------------------------------------------------------------------
-  Ran 8 tests in 3.036s
+### Running unit tests
+
+To run tests locally, once your unit test environment is setup (directly on your
+system or through our Docker setup) you should be able to simply run
+``./run_unit_tests.sh`` at will.
+
+For example, in order to just execute the "core" unit tests, run the following:
 
-  OK
 ```
+./run_unit_tests.sh tests.core:CoreTest -s --logging-level=DEBUG
+```
+
+or a single test method:
 
-The Airflow code is mounted inside of the Docker container, so if you change something using your favorite IDE, you can directly test is in the container.
+```
+./run_unit_tests.sh tests.core:CoreTest.test_check_operators -s --logging-level=DEBUG
+```
+
+To run the whole test suite with Docker Compose, do:
+
+```
+# Install Docker Compose first, then this will run the tests
+docker-compose -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
+```
 
-### Set up a development env using Virtualenv
+Alternatively can also set up [Travis CI](https://travis-ci.org/) on your repo to automate this.
+It is free for open source projects.
 
-Please install python(2.7.x or 3.4.x), mysql, and libxml by using system-level package
-managers like yum, apt-get for Linux, or homebrew for Mac OS at first.
-It is usually best to work in a virtualenv and tox. Install development requirements:
+For more information on how to run a subset of the tests, take a look at the
+nosetests docs.
 
-    cd $AIRFLOW_HOME
-    virtualenv env
-    source env/bin/activate
-    pip install -e .[devel]
-    tox
+See also the list of test classes and methods in `tests/core.py`.
 
 Feel free to customize based on the extras available in [setup.py](./setup.py)
 
-### Pull Request Guidelines
+## Pull Request Guidelines
 
 Before you submit a pull request from your forked repo, check that it
 meets these guidelines:
@@ -187,59 +240,6 @@ using `flake8 airflow tests`. `git diff upstream/master -u -- "*.py" | flake8 --
 commit messages and adhere to them. It makes the lives of those who
 come after you a lot easier.
 
-### Testing locally
-
-#### TL;DR
-Tests can then be run with (see also the [Running unit tests](#running-unit-tests) section below):
-
-    ./run_unit_tests.sh
-
-Individual test files can be run with:
-
-    nosetests [path to file]
-
-#### Running unit tests
-
-We *highly* recommend setting up [Travis CI](https://travis-ci.org/) on
-your repo to automate this. It is free for open source projects. If for
-some reason you cannot, you can use the steps below to run tests.
-
-Here are loose guidelines on how to get your environment to run the unit tests.
-We do understand that no one out there can run the full test suite since
-Airflow is meant to connect to virtually any external system and that you most
-likely have only a subset of these in your environment. You should run the
-CoreTests and tests related to things you touched in your PR.
-
-To set up a unit test environment, first take a look at `run_unit_tests.sh` and
-understand that your ``AIRFLOW_CONFIG`` points to an alternate config file
-while running the tests. You shouldn't have to alter this config file but
-you may if need be.
-
-From that point, you can actually export these same environment variables in
-your shell, start an Airflow webserver ``airflow webserver -d`` and go and
-configure your connection. Default connections that are used in the tests
-should already have been created, you just need to point them to the systems
-where you want your tests to run.
-
-Once your unit test environment is setup, you should be able to simply run
-``./run_unit_tests.sh`` at will.
-
-For example, in order to just execute the "core" unit tests, run the following:
-
-```
-./run_unit_tests.sh tests.core:CoreTest -s --logging-level=DEBUG
-```
-
-or a single test method:
-
-```
-./run_unit_tests.sh tests.core:CoreTest.test_check_operators -s --logging-level=DEBUG
-```
-
-For more information on how to run a subset of the tests, take a look at the
-nosetests docs.
-
-See also the list of test classes and methods in `tests/core.py`.
 
 ### Changing the Metadata Database
 
diff --git a/README.md b/README.md
index 633000c18e788..fceb2a7d7bffb 100644
--- a/README.md
+++ b/README.md
@@ -89,7 +89,8 @@ unit of work and continuity.
 
 Want to help build Apache Airflow? Check out our [contributing documentation](https://github.com/apache/airflow/blob/master/CONTRIBUTING.md).
 
-## Who uses Apache Airflow?
+
+## Who uses Airflow?
 
 As the Apache Airflow community grows, we'd like to keep track of who is using
 the platform. Please send a PR with your company name and @githubhandle
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index a75f3a0207e41..e9007cfba20f2 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -176,10 +176,8 @@ class PythonVirtualenvOperator(PythonOperator):
     variable named virtualenv_string_args will be available (populated by
     string_args). In addition, one can pass stuff through op_args and op_kwargs, and one
     can use a return value.
-
     Note that if your virtualenv runs in a different Python major version than Airflow,
     you cannot use return values, op_args, or op_kwargs. You can use string_args though.
-
     :param python_callable: A python function with no references to outside variables,
         defined with def, which will be run in a virtualenv
     :type python_callable: function
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 74317a59c7a1f..aa770b27b6106 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -94,12 +94,12 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='airflow_db', conn_type='mysql',
-            host='localhost', login='root', password='',
+            host='mysql', login='root', password='',
             schema='airflow'))
     merge_conn(
         models.Connection(
             conn_id='airflow_ci', conn_type='mysql',
-            host='localhost', login='root', extra="{\"local_infile\": true}",
+            host='mysql', login='root', extra="{\"local_infile\": true}",
             schema='airflow_ci'))
     merge_conn(
         models.Connection(
@@ -141,18 +141,19 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='mongo_default', conn_type='mongo',
-            host='localhost', port=27017))
+            host='mongo', port=27017))
     merge_conn(
         models.Connection(
             conn_id='mysql_default', conn_type='mysql',
             login='root',
-            host='localhost'))
+            host='mysql'))
     merge_conn(
         models.Connection(
             conn_id='postgres_default', conn_type='postgres',
             login='postgres',
+            password='airflow',
             schema='airflow',
-            host='localhost'))
+            host='postgres'))
     merge_conn(
         models.Connection(
             conn_id='sqlite_default', conn_type='sqlite',
@@ -184,7 +185,7 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='sftp_default', conn_type='sftp',
-            host='localhost', port=22, login='travis',
+            host='localhost', port=22, login='airflow',
             extra='''
                 {"key_file": "~/.ssh/id_rsa", "no_host_key_check": true}
             '''))
@@ -287,7 +288,7 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='cassandra_default', conn_type='cassandra',
-            host='localhost', port=9042))
+            host='cassandra', port=9042))
 
     # Known event types
     KET = models.KnownEventType
diff --git a/run_tox.sh b/run_tox.sh
deleted file mode 100755
index b4f204d649a32..0000000000000
--- a/run_tox.sh
+++ /dev/null
@@ -1,21 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-# 
-#   http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-set -o verbose
-
-python setup.py test --tox-args="-v -e $TOX_ENV"
diff --git a/run_unit_tests.sh b/run_unit_tests.sh
index 124abff44a844..2c4abbfaad605 100755
--- a/run_unit_tests.sh
+++ b/run_unit_tests.sh
@@ -21,7 +21,7 @@
 set -x
 
 # environment
-export AIRFLOW_HOME=${AIRFLOW_HOME:=~/airflow}
+export AIRFLOW_HOME=${AIRFLOW_HOME:=~}
 export AIRFLOW__CORE__UNIT_TEST_MODE=True
 
 # add test/contrib to PYTHONPATH
@@ -29,57 +29,41 @@ DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 export PYTHONPATH=$PYTHONPATH:${DIR}/tests/test_utils
 
 # any argument received is overriding the default nose execution arguments:
-
 nose_args=$@
 
-#--with-doctest
-
 # Generate the `airflow` executable if needed
 which airflow > /dev/null || python setup.py develop
 
 echo "Initializing the DB"
+yes | airflow initdb
 yes | airflow resetdb
 
-if [ "${TRAVIS}" ]; then
-    if [ -z "$nose_args" ]; then
-      nose_args="--with-coverage \
-    --cover-erase \
-    --cover-html \
-    --cover-package=airflow \
-    --cover-html-dir=airflow/www/static/coverage \
-    --with-ignore-docstrings \
-    --rednose \
-    --with-timer \
-    -v \
-    --logging-level=DEBUG "
-    fi
+if [ -z "$nose_args" ]; then
+  nose_args="--with-coverage \
+  --cover-erase \
+  --cover-html \
+  --cover-package=airflow \
+  --cover-html-dir=airflow/www/static/coverage \
+  --with-ignore-docstrings \
+  --rednose \
+  --with-timer \
+  -v \
+  --logging-level=DEBUG "
+fi
 
-  # For impersonation tests running on SQLite on Travis, make the database world readable so other
-  # users can update it
-  AIRFLOW_DB="/home/travis/airflow/airflow.db"
-  if [ -f "${AIRFLOW_DB}" ]; then
-    sudo chmod a+rw "${AIRFLOW_DB}"
-  fi
+# For impersonation tests running on SQLite on Travis, make the database world readable so other
+# users can update it
+AIRFLOW_DB="$HOME/airflow.db"
 
-  # For impersonation tests on Travis, make airflow accessible to other users via the global PATH
-  # (which contains /usr/local/bin)
-  sudo ln -s "${VIRTUAL_ENV}/bin/airflow" /usr/local/bin/
-else
-    if [ -z "$nose_args" ]; then
-      nose_args="--with-coverage \
-    --cover-erase \
-    --cover-html \
-    --cover-package=airflow \
-    --cover-html-dir=airflow/www/static/coverage \
-    --with-ignore-docstrings \
-    --rednose \
-    --with-timer \
-    -s \
-    -v \
-    --logging-level=DEBUG "
-    fi
+if [ -f "${AIRFLOW_DB}" ]; then
+  chmod a+rw "${AIRFLOW_DB}"
+  chmod g+rwx "${AIRFLOW_HOME}"
 fi
 
+# For impersonation tests on Travis, make airflow accessible to other users via the global PATH
+# (which contains /usr/local/bin)
+sudo ln -sf "${VIRTUAL_ENV}/bin/airflow" /usr/local/bin/
+
 echo "Starting the unit tests with the following nose arguments: "$nose_args
 nosetests $nose_args
 
diff --git a/scripts/ci/ldap.sh b/scripts/ci/1-setup-env.sh
similarity index 67%
rename from scripts/ci/ldap.sh
rename to scripts/ci/1-setup-env.sh
index d0e3043a9b685..0a976b35f027b 100755
--- a/scripts/ci/ldap.sh
+++ b/scripts/ci/1-setup-env.sh
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,19 +18,16 @@
 # specific language governing permissions and limitations
 # under the License.
 
-set -o verbose
-
-DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
-LDAP_DB=/tmp/ldap_db
-
-echo "Creating database directory"
-
-rm -rf ${LDAP_DB} && mkdir ${LDAP_DB} && cp  /usr/share/doc/slapd/examples/DB_CONFIG ${LDAP_DB}
+set -exuo pipefail
 
-echo "Launching OpenLDAP ..."
+# Start MiniCluster
+java -cp "/tmp/minicluster-1.1-SNAPSHOT/*" com.ing.minicluster.MiniCluster > /dev/null &
 
-# Start slapd with non root privileges
-slapd -h "ldap://127.0.0.1:3890/" -f ${DIR}/slapd.conf
+# Set up ssh keys
+echo 'yes' | ssh-keygen -t rsa -C your_email@youremail.com -P '' -f ~/.ssh/id_rsa
+cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
+ln -s ~/.ssh/authorized_keys ~/.ssh/authorized_keys2
+chmod 600 ~/.ssh/*
 
-# Wait for LDAP to start
-sleep 1
+# SSH Service
+sudo service ssh restart
diff --git a/scripts/ci/load_fixtures.sh b/scripts/ci/2-setup-kdc.sh
similarity index 59%
rename from scripts/ci/load_fixtures.sh
rename to scripts/ci/2-setup-kdc.sh
index 55beb919dfda2..56824f5a5ee3f 100755
--- a/scripts/ci/load_fixtures.sh
+++ b/scripts/ci/2-setup-kdc.sh
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,17 +18,21 @@
 # specific language governing permissions and limitations
 # under the License.
 
-set -o verbose
+set -exuo pipefail
+
+DIRNAME=$(cd "$(dirname "$0")"; pwd)
+
+FQDN=`hostname`
+ADMIN="admin"
+PASS="airflow"
+KRB5_KTNAME=/etc/airflow.keytab
 
-DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
-FIXTURES_DIR="$DIR/ldif"
-LOAD_ORDER=("example.com.ldif" "manager.example.com.ldif" "users.example.com.ldif" "groups.example.com.ldif")
+cat /etc/hosts
+echo "hostname: ${FQDN}"
 
-load_fixture () {
-  ldapadd -x -H ldap://127.0.0.1:3890/ -D "cn=Manager,dc=example,dc=com" -w insecure -f $1
-}
+sudo cp $DIRNAME/krb5/krb-conf/client/krb5.conf /etc/krb5.conf
 
-for FILE in "${LOAD_ORDER[@]}"
-do
-  load_fixture "${FIXTURES_DIR}/${FILE}"
-done;
+echo -e "${PASS}\n${PASS}" | sudo kadmin -p ${ADMIN}/admin -w ${PASS} -q "addprinc -randkey airflow/${FQDN}"
+sudo kadmin -p ${ADMIN}/admin -w ${PASS} -q "ktadd -k ${KRB5_KTNAME} airflow"
+sudo kadmin -p ${ADMIN}/admin -w ${PASS} -q "ktadd -k ${KRB5_KTNAME} airflow/${FQDN}"
+sudo chmod 0644 ${KRB5_KTNAME}
diff --git a/scripts/ci/travis_script.sh b/scripts/ci/3-setup-databases.sh
similarity index 58%
rename from scripts/ci/travis_script.sh
rename to scripts/ci/3-setup-databases.sh
index 52571cce14a35..2a5cb682e0119 100755
--- a/scripts/ci/travis_script.sh
+++ b/scripts/ci/3-setup-databases.sh
@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-
 #  Licensed to the Apache Software Foundation (ASF) under one   *
 #  or more contributor license agreements.  See the NOTICE file *
 #  distributed with this work for additional information        *
@@ -17,24 +16,8 @@
 #  specific language governing permissions and limitations      *
 #  under the License.                                           *
 
-DIRNAME=$(cd "$(dirname "$0")"; pwd)
-AIRFLOW_ROOT="$DIRNAME/../.."
-cd $AIRFLOW_ROOT && pip --version && ls -l $HOME/.wheelhouse && tox --version
+set -exuo pipefail
+
+MYSQL_HOST=mysql
 
-if [ -z "$KUBERNETES_VERSION" ];
-then
-  tox -e $TOX_ENV
-else
-  KUBERNETES_VERSION=${KUBERNETES_VERSION} $DIRNAME/kubernetes/setup_kubernetes.sh && \
-  tox -e $TOX_ENV -- tests.contrib.minikube \
-                     --with-coverage \
-                     --cover-erase \
-                     --cover-html \
-                     --cover-package=airflow \
-                     --cover-html-dir=airflow/www/static/coverage \
-                     --with-ignore-docstrings \
-                     --rednose \
-                     --with-timer \
-                     -v \
-                     --logging-level=DEBUG
-fi
+mysql -h ${MYSQL_HOST} -u root -e 'drop database if exists airflow; create database airflow'
diff --git a/scripts/ci/load_data.sh b/scripts/ci/4-load-data.sh
similarity index 81%
rename from scripts/ci/load_data.sh
rename to scripts/ci/4-load-data.sh
index 3422b07c20c13..7935482be075e 100755
--- a/scripts/ci/load_data.sh
+++ b/scripts/ci/4-load-data.sh
@@ -15,14 +15,15 @@
 #  KIND, either express or implied.  See the License for the    *
 #  specific language governing permissions and limitations      *
 #  under the License.                                           *
-set -o verbose
+
+set -exuo pipefail
 
 DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
 DATA_DIR="${DIR}/data"
 DATA_FILE="${DATA_DIR}/baby_names.csv"
 DATABASE=airflow_ci
+HOST=mysql
 
-mysqladmin -u root create ${DATABASE}
-mysql -u root < ${DATA_DIR}/mysql_schema.sql
-mysqlimport --local -u root --fields-optionally-enclosed-by="\"" --fields-terminated-by=, --ignore-lines=1 ${DATABASE} ${DATA_FILE}
-
+mysqladmin -h ${HOST} -u root create ${DATABASE}
+mysql -h ${HOST} -u root < ${DATA_DIR}/mysql_schema.sql
+mysqlimport --local -h ${HOST} -u root --fields-optionally-enclosed-by="\"" --fields-terminated-by=, --ignore-lines=1 ${DATABASE} ${DATA_FILE}
diff --git a/scripts/ci/5-run-tests.sh b/scripts/ci/5-run-tests.sh
index 8a74d824efa29..0a3add4762636 100755
--- a/scripts/ci/5-run-tests.sh
+++ b/scripts/ci/5-run-tests.sh
@@ -45,6 +45,12 @@ echo Backend: $AIRFLOW__CORE__SQL_ALCHEMY_CONN
 export AIRFLOW_HOME=${AIRFLOW_HOME:=~}
 export AIRFLOW__CORE__UNIT_TEST_MODE=True
 
+# configuration test
+export AIRFLOW__TESTSECTION__TESTKEY=testvalue
+
+# use Airflow 2.0-style imports
+export AIRFLOW_USE_NEW_IMPORTS=1
+
 # any argument received is overriding the default nose execution arguments:
 nose_args=$@
 
diff --git a/scripts/ci/check-license.sh b/scripts/ci/6-check-license.sh
similarity index 94%
rename from scripts/ci/check-license.sh
rename to scripts/ci/6-check-license.sh
index 035283f9061b5..8f3999043b14d 100755
--- a/scripts/ci/check-license.sh
+++ b/scripts/ci/6-check-license.sh
@@ -53,9 +53,7 @@ acquire_rat_jar () {
 FWDIR="$(cd "`dirname "$0"`"/../..; pwd)"
 cd "$FWDIR"
 
-if [ -z "${TRAVIS_CACHE}" ]; then
-    TRAVIS_CACHE=/tmp
-fi
+TMP_DIR=/tmp
 
 if test -x "$JAVA_HOME/bin/java"; then
     declare java_cmd="$JAVA_HOME/bin/java"
@@ -64,8 +62,8 @@ else
 fi
 
 export RAT_VERSION=0.12
-export rat_jar="${TRAVIS_CACHE}"/lib/apache-rat-${RAT_VERSION}.jar
-mkdir -p ${TRAVIS_CACHE}/lib
+export rat_jar="${TMP_DIR}"/lib/apache-rat-${RAT_VERSION}.jar
+mkdir -p ${TMP_DIR}/lib
 
 
 [[ -f "$rat_jar" ]] || acquire_rat_jar || {
diff --git a/scripts/ci/airflow_travis.cfg b/scripts/ci/airflow_travis.cfg
index 140ecab683f2c..31e8586c4cc15 100644
--- a/scripts/ci/airflow_travis.cfg
+++ b/scripts/ci/airflow_travis.cfg
@@ -21,7 +21,7 @@ airflow_home = ~/airflow
 dags_folder = ~/airflow/dags
 base_log_folder = ~/airflow/logs
 executor = LocalExecutor
-sql_alchemy_conn = mysql://root@localhost/airflow
+sql_alchemy_conn = mysql://root@mysql/airflow
 unit_test_mode = True
 load_examples = True
 donot_pickle = False
@@ -55,8 +55,8 @@ smtp_mail_from = airflow@example.com
 celery_app_name = airflow.executors.celery_executor
 worker_concurrency = 16
 worker_log_server_port = 8793
-broker_url = amqp://guest:guest@localhost:5672/
-result_backend = db+mysql://root@localhost/airflow
+broker_url = amqp://guest:guest@rabbitmq:5672/
+result_backend = db+mysql://root@mysql/airflow
 flower_port = 5555
 default_queue = default
 
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
new file mode 100644
index 0000000000000..861cf9e8b89ce
--- /dev/null
+++ b/scripts/ci/docker-compose.yml
@@ -0,0 +1,90 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+version: "2.2"
+services:
+  mysql:
+    image: mysql:5.6
+    restart: always
+    environment:
+      - MYSQL_ALLOW_EMPTY_PASSWORD=true
+      - MYSQL_ROOT_HOST=%
+    volumes:
+      - ./mysql/conf.d:/etc/mysql/conf.d
+
+  postgres:
+    image: postgres:9.6
+    restart: always
+    environment:
+      - POSTGRES_USER=postgres
+      - POSTGRES_PASSWORD=airflow
+      - POSTGRES_DB=airflow
+
+  mongo:
+    image: mongo:3
+    restart: always
+
+  cassandra:
+    image: cassandra:3.0
+    restart: always
+
+  rabbitmq:
+    image: rabbitmq:3.7
+    restart: always
+
+  openldap:
+    image: osixia/openldap:1.2.0
+    restart: always
+    command: --copy-service
+    environment:
+      - LDAP_DOMAIN=example.com
+      - LDAP_ADMIN_PASSWORD=insecure
+      - LDAP_CONFIG_PASSWORD=insecure
+    volumes:
+      - ./openldap/ldif:/container/service/slapd/assets/config/bootstrap/ldif/custom
+
+  krb5-kdc-server:
+    build: ./krb5
+    image: krb5-kdc-server
+    hostname: krb5-kdc-server
+    domainname: example.com
+
+  airflow-testing:
+    image: airflowci/incubator-airflow-ci:latest
+    init: true
+    environment:
+      - USER=airflow
+      - SLUGIFY_USES_TEXT_UNIDECODE=yes
+      - TOX_ENV
+      - PYTHON_VERSION
+      - TRAVIS
+      - TRAVIS_BRANCH
+      - TRAVIS_BUILD_DIR
+      - TRAVIS_JOB_ID
+      - TRAVIS_PULL_REQUEST
+    depends_on:
+      - postgres
+      - mysql
+      - mongo
+      - cassandra
+      - rabbitmq
+      - openldap
+      - krb5-kdc-server
+    volumes:
+      - ../../:/app
+      - ~/.cache/pip:/home/airflow/.cache/pip
+      - ~/.wheelhouse/:/home/airflow/.wheelhouse/
+    working_dir: /app
diff --git a/scripts/ci/flake8_diff.sh b/scripts/ci/flake8-diff.sh
similarity index 100%
rename from scripts/ci/flake8_diff.sh
rename to scripts/ci/flake8-diff.sh
diff --git a/scripts/ci/run_tests.sh b/scripts/ci/krb5/Dockerfile
old mode 100755
new mode 100644
similarity index 51%
rename from scripts/ci/run_tests.sh
rename to scripts/ci/krb5/Dockerfile
index d5e7655803df5..cdb4cf979e05d
--- a/scripts/ci/run_tests.sh
+++ b/scripts/ci/krb5/Dockerfile
@@ -1,5 +1,3 @@
-#!/usr/bin/env bash
-
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
@@ -8,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,30 +16,37 @@
 # specific language governing permissions and limitations
 # under the License.
 
-set -o verbose
+FROM ubuntu:xenial
 
-if [ -z "$HADOOP_HOME" ]; then
-    echo "HADOOP_HOME not set - abort" >&2
-    exit 1
-fi
+# environment variables
+ENV DEBIAN_FRONTEND noninteractive
 
-echo "Using ${HADOOP_DISTRO} distribution of Hadoop from ${HADOOP_HOME}"
+# Kerberos server
+RUN apt-get update && apt-get install --no-install-recommends -y \
+    ntp \
+    python-dev \
+    python-pip \
+    python-wheel \
+    python-setuptools \
+    python-pkg-resources \
+    krb5-admin-server \
+    krb5-kdc
 
-pwd
+RUN mkdir /app/
 
-mkdir ~/airflow/
+# Supervisord
+RUN pip install supervisor==3.3.4
+RUN mkdir -p /var/log/supervisord/
 
-if [ "${TRAVIS}" ]; then
-    echo "Using travis airflow.cfg"
-    DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-    cp -f ${DIR}/airflow_travis.cfg ~/airflow/unittests.cfg
+COPY ./krb-conf/server/kdc.conf /etc/krb5kdc/kdc.conf
+COPY ./krb-conf/server/kadm5.acl /etc/krb5kdc/kadm5.acl
+COPY ./krb-conf/client/krb5.conf /etc/krb5.conf
+COPY ./start_kdc.sh /app/start_kdc.sh
 
-    ROOTDIR="$(dirname $(dirname $DIR))"
-    export AIRFLOW__CORE__DAGS_FOLDER="$ROOTDIR/tests/dags"
+# supervisord
+COPY ./supervisord.conf /etc/supervisord.conf
 
-    # kdc init happens in setup_kdc.sh
-    kinit -kt ${KRB5_KTNAME} airflow
-fi
+WORKDIR /app
 
-echo Backend: $AIRFLOW__CORE__SQL_ALCHEMY_CONN
-./run_unit_tests.sh $@
+# when container is starting
+CMD ["/bin/bash", "/app/start_kdc.sh"]
diff --git a/scripts/ci/krb5.conf b/scripts/ci/krb5/krb-conf/client/krb5.conf
similarity index 94%
rename from scripts/ci/krb5.conf
rename to scripts/ci/krb5/krb-conf/client/krb5.conf
index bbc802a0eb9e8..471737a964123 100644
--- a/scripts/ci/krb5.conf
+++ b/scripts/ci/krb5/krb-conf/client/krb5.conf
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -31,5 +31,6 @@ forwardable = true
 
 [realms]
  TEST.LOCAL = {
-   kdc = localhost:88
+   kdc = krb5-kdc-server:88
+   admin_server = krb5-kdc-server
  }
diff --git a/scripts/ci/kadm5.acl b/scripts/ci/krb5/krb-conf/server/kadm5.acl
similarity index 99%
rename from scripts/ci/kadm5.acl
rename to scripts/ci/krb5/krb-conf/server/kadm5.acl
index 691dce6c2bbdf..41d17385ff144 100644
--- a/scripts/ci/kadm5.acl
+++ b/scripts/ci/krb5/krb-conf/server/kadm5.acl
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/ci/kdc.conf b/scripts/ci/krb5/krb-conf/server/kdc.conf
similarity index 99%
rename from scripts/ci/kdc.conf
rename to scripts/ci/krb5/krb-conf/server/kdc.conf
index 5eef3053b363c..c21095f418d4a 100644
--- a/scripts/ci/kdc.conf
+++ b/scripts/ci/krb5/krb-conf/server/kdc.conf
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/ci/setup_kdc.sh b/scripts/ci/krb5/start_kdc.sh
similarity index 75%
rename from scripts/ci/setup_kdc.sh
rename to scripts/ci/krb5/start_kdc.sh
index 3e525c5e82ec7..6e02f006fa830 100755
--- a/scripts/ci/setup_kdc.sh
+++ b/scripts/ci/krb5/start_kdc.sh
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,23 +18,15 @@
 # specific language governing permissions and limitations
 # under the License.
 
-cat /etc/hosts
+set -exuo pipefail
 
 FQDN=`hostname`
-
-echo "hostname: ${FQDN}"
-
 ADMIN="admin"
 PASS="airflow"
+KRB5_KTNAME=/etc/airflow.keytab
 
-DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
-
-ln -sf /dev/urandom /dev/random
-
-cp ${DIR}/kdc.conf /etc/krb5kdc/kdc.conf
-cp ${DIR}/kadm5.acl /etc/krb5kdc/kadm5.acl
-cp ${DIR}/krb5.conf /etc/krb5.conf
-
+cat /etc/hosts
+echo "hostname: ${FQDN}"
 # create kerberos database
 echo -e "${PASS}\n${PASS}" | kdb5_util create -s
 # create admin
@@ -45,12 +37,5 @@ echo -e "${PASS}\n${PASS}" | kadmin.local -q "addprinc -randkey airflow/${FQDN}"
 kadmin.local -q "ktadd -k ${KRB5_KTNAME} airflow"
 kadmin.local -q "ktadd -k ${KRB5_KTNAME} airflow/${FQDN}"
 
-service krb5-kdc restart
-
-# make sure the keytab is readable to anyone
-chmod 664 ${KRB5_KTNAME}
-
-# don't do a kinit here as this happens under super user privileges
-# on travis
-# kinit -kt ${KRB5_KTNAME} airflow
-
+# Start services
+/usr/local/bin/supervisord -n -c /etc/supervisord.conf
diff --git a/scripts/ci/krb5/supervisord.conf b/scripts/ci/krb5/supervisord.conf
new file mode 100644
index 0000000000000..165e5cde84646
--- /dev/null
+++ b/scripts/ci/krb5/supervisord.conf
@@ -0,0 +1,43 @@
+;
+; Licensed to the Apache Software Foundation (ASF) under one
+; or more contributor license agreements.  See the NOTICE file
+; distributed with this work for additional information
+; regarding copyright ownership.  The ASF licenses this file
+; to you under the Apache License, Version 2.0 (the
+; "License"); you may not use this file except in compliance
+; with the License.  You may obtain a copy of the License at
+;
+;   http://www.apache.org/licenses/LICENSE-2.0
+;
+; Unless required by applicable law or agreed to in writing,
+; software distributed under the License is distributed on an
+; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+; KIND, either express or implied.  See the License for the
+; specific language governing permissions and limitations
+; under the License.
+
+; supervisord.conf - kdc-server
+
+[supervisord]
+logfile=/var/log/supervisord/supervisord.log    ; supervisord log file
+logfile_maxbytes=50MB                           ; maximum size of logfile before rotation
+logfile_backups=10                              ; number of backed up logfiles
+loglevel=error                                  ; info, debug, warn, trace
+pidfile=/var/run/supervisord.pid                ; pidfile location
+nodaemon=false                                  ; run supervisord as a daemon
+minfds=1024                                     ; number of startup file descriptors
+minprocs=200                                    ; number of process descriptors
+user=root                                       ; default user
+childlogdir=/var/log/supervisord/               ; where child log files will live
+
+[program:krb5-kdc]
+command=service krb5-kdc start
+autostart=true
+autorestart=true
+
+[program:krb5-admin-server]
+command=service krb5-admin-server start
+autostart=true
+autorestart=true
+
+[supervisorctl]
diff --git a/scripts/ci/ldif/example.com.ldif b/scripts/ci/ldif/example.com.ldif
deleted file mode 100644
index cda5d005616ef..0000000000000
--- a/scripts/ci/ldif/example.com.ldif
+++ /dev/null
@@ -1,24 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-# 
-#   http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-dn: dc=example,dc=com
-dc: example
-description: LDAP Example
-objectClass: dcObject
-objectClass: organization
-o: example
diff --git a/scripts/ci/my.cnf b/scripts/ci/mysql/conf.d/airflow.cnf
similarity index 99%
rename from scripts/ci/my.cnf
rename to scripts/ci/mysql/conf.d/airflow.cnf
index 5ff549ca4ecff..4802d195a2b55 100644
--- a/scripts/ci/my.cnf
+++ b/scripts/ci/mysql/conf.d/airflow.cnf
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/ci/ldif/users.example.com.ldif b/scripts/ci/openldap/ldif/01-users.example.com.ldif
similarity index 99%
rename from scripts/ci/ldif/users.example.com.ldif
rename to scripts/ci/openldap/ldif/01-users.example.com.ldif
index ed4a7ceb7632c..bf5baf5ad8a18 100644
--- a/scripts/ci/ldif/users.example.com.ldif
+++ b/scripts/ci/openldap/ldif/01-users.example.com.ldif
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/ci/ldif/groups.example.com.ldif b/scripts/ci/openldap/ldif/02-groups.example.com.ldif
similarity index 96%
rename from scripts/ci/ldif/groups.example.com.ldif
rename to scripts/ci/openldap/ldif/02-groups.example.com.ldif
index 804dcb008bf2c..9d1deb349fa05 100644
--- a/scripts/ci/ldif/groups.example.com.ldif
+++ b/scripts/ci/openldap/ldif/02-groups.example.com.ldif
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -27,7 +27,7 @@ dn: cn=group1,ou=groups,dc=example,dc=com
 objectclass: groupofnames
 cn: group1
 description: Group 1 of users
-# add the group members all of which are 
+# add the group members all of which are
 # assumed to exist under example
 member: cn=user1,dc=example,dc=com
 
diff --git a/scripts/ci/ldif/manager.example.com.ldif b/scripts/ci/openldap/ldif/03-manager.example.com.ldif
similarity index 99%
rename from scripts/ci/ldif/manager.example.com.ldif
rename to scripts/ci/openldap/ldif/03-manager.example.com.ldif
index 1d06a4f2ebd6f..d4b90b73b8850 100644
--- a/scripts/ci/ldif/manager.example.com.ldif
+++ b/scripts/ci/openldap/ldif/03-manager.example.com.ldif
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/init.sh b/scripts/ci/openldap/ldif/04-rootdn.ldif
similarity index 84%
rename from init.sh
rename to scripts/ci/openldap/ldif/04-rootdn.ldif
index 6f4adcad06752..59bd3e554db90 100644
--- a/init.sh
+++ b/scripts/ci/openldap/ldif/04-rootdn.ldif
@@ -1,5 +1,3 @@
-#!/usr/bin/env bash
-
 #
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
@@ -8,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,4 +16,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
-source $AIRFLOW_HOME/env/bin/activate
+dn: cn=config
+changetype: modify
+
+dn: olcDatabase={1}{{ LDAP_BACKEND }},cn=config
+replace: olcRootDN
+olcRootDN: cn=Manager,{{ LDAP_BASE_DN }}
diff --git a/scripts/ci/slapd.conf b/scripts/ci/openldap/slapd.conf
similarity index 99%
rename from scripts/ci/slapd.conf
rename to scripts/ci/openldap/slapd.conf
index 34df186e4a256..a404530b8d285 100644
--- a/scripts/ci/slapd.conf
+++ b/scripts/ci/openldap/slapd.conf
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -38,7 +38,6 @@ disallow bind_anon
 database hdb
 
 suffix "dc=example,dc=com"
-
 rootdn "cn=Manager,dc=example,dc=com"
 rootpw insecure
 
diff --git a/scripts/ci/run-ci.sh b/scripts/ci/run-ci.sh
new file mode 100755
index 0000000000000..f2815bbd95979
--- /dev/null
+++ b/scripts/ci/run-ci.sh
@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+#
+#  Licensed to the Apache Software Foundation (ASF) under one
+#  or more contributor license agreements.  See the NOTICE file
+#  distributed with this work for additional information
+#  regarding copyright ownership.  The ASF licenses this file
+#  to you under the Apache License, Version 2.0 (the
+#  "License"); you may not use this file except in compliance
+#  with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing,
+#  software distributed under the License is distributed on an
+#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+#  KIND, either express or implied.  See the License for the
+#  specific language governing permissions and limitations
+#  under the License.
+
+set -x
+
+DIRNAME=$(cd "$(dirname "$0")"; pwd)
+AIRFLOW_ROOT="$DIRNAME/../.."
+
+# Fix file permissions
+sudo chown -R airflow.airflow . $HOME/.wheelhouse/ $HOME/.cache/pip
+
+if [[ $PYTHON_VERSION == '3' ]]; then
+  PIP=pip3
+else
+  PIP=pip
+fi
+
+sudo $PIP install --upgrade pip
+sudo $PIP install tox
+
+cd $AIRFLOW_ROOT && $PIP --version && tox --version
+
+if [ -z "$KUBERNETES_VERSION" ];
+then
+  tox -e $TOX_ENV
+else
+  KUBERNETES_VERSION=${KUBERNETES_VERSION} $DIRNAME/kubernetes/setup_kubernetes.sh && \
+  tox -e $TOX_ENV -- tests.contrib.minikube \
+                     --with-coverage \
+                     --cover-erase \
+                     --cover-html \
+                     --cover-package=airflow \
+                     --cover-html-dir=airflow/www/static/coverage \
+                     --with-ignore-docstrings \
+                     --rednose \
+                     --with-timer \
+                     -v \
+                     --logging-level=DEBUG
+fi
diff --git a/scripts/ci/setup_env.sh b/scripts/ci/setup_env.sh
deleted file mode 100755
index a1d9a4c244109..0000000000000
--- a/scripts/ci/setup_env.sh
+++ /dev/null
@@ -1,166 +0,0 @@
-#!/usr/bin/env bash
-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-# 
-#   http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-set -o verbose
-
-MINIKDC_VERSION=2.7.1
-
-HADOOP_DISTRO=${HADOOP_DISTRO:-"hdp"}
-
-ONLY_DOWNLOAD=${ONLY_DOWNLOAD:-false}
-ONLY_EXTRACT=${ONLY_EXTRACT:-false}
-
-MINICLUSTER_URL=https://github.com/bolkedebruin/minicluster/releases/download/1.1/minicluster-1.1-SNAPSHOT-bin.zip
-
-HIVE_HOME=/tmp/hive
-
-while test $# -gt 0; do
-    case "$1" in
-        -h|--help)
-            echo "Setup environment for airflow tests"
-            echo " "
-            echo "options:"
-            echo -e "\t-h, --help            show brief help"
-            echo -e "\t-o, --only-download   just download hadoop tar(s)"
-            echo -e "\t-e, --only-extract    just extract hadoop tar(s)"
-            echo -e "\t-d, --distro          select distro (hdp|cdh)"
-            exit 0
-            ;;
-        -o|--only-download)
-            shift
-            ONLY_DOWNLOAD=true
-            ;;
-        -e|--only-extract)
-            shift
-            ONLY_EXTRACT=true
-            ;;
-        -d|--distro)
-            shift
-            if test $# -gt 0; then
-                HADOOP_DISTRO=$1
-            else
-                echo "No Hadoop distro specified - abort" >&2
-                exit 1
-            fi
-            shift
-            ;;
-        *)
-            echo "Unknown options: $1" >&2
-            exit 1
-            ;;
-    esac
-done
-
-HADOOP_HOME=/tmp/hadoop-${HADOOP_DISTRO}
-MINICLUSTER_HOME=/tmp/minicluster
-
-if $ONLY_DOWNLOAD && $ONLY_EXTRACT; then
-    echo "Both only-download and only-extract specified - abort" >&2
-    exit 1
-fi
-
-mkdir -p ${HADOOP_HOME}
-mkdir -p ${TRAVIS_CACHE}/${HADOOP_DISTRO}
-mkdir -p ${TRAVIS_CACHE}/minicluster
-mkdir -p ${TRAVIS_CACHE}/hive
-mkdir -p ${HIVE_HOME}
-chmod -R 777 ${HIVE_HOME}
-sudo mkdir -p /user/hive/warehouse
-sudo chown -R ${USER} /user/
-sudo chmod -R 777 /user/
-ls -l /
-
-if [ $HADOOP_DISTRO = "cdh" ]; then
-    # URL="http://archive.cloudera.com/cdh5/cdh/5/hadoop-latest.tar.gz"
-    URL="https://archive.cloudera.com/cdh5/cdh/5/hadoop-2.6.0-cdh5.11.0.tar.gz"
-    # HIVE_URL="http://archive.cloudera.com/cdh5/cdh/5/hive-latest.tar.gz"
-    HIVE_URL="https://archive.cloudera.com/cdh5/cdh/5/hive-1.1.0-cdh5.11.0.tar.gz"
-elif [ $HADOOP_DISTRO = "hdp" ]; then
-    URL="http://public-repo-1.hortonworks.com/HDP/centos6/2.x/updates/2.3.2.0/tars/hadoop-2.7.1.2.3.2.0-2950.tar.gz"
-    HIVE_URL="http://public-repo-1.hortonworks.com/HDP/centos6/2.x/updates/2.3.2.0/tars/apache-hive-1.2.1.2.3.2.0-2950-bin.tar.gz"
-else
-    echo "No/bad HADOOP_DISTRO='${HADOOP_DISTRO}' specified" >&2
-    exit 1
-fi
-
-if ! $ONLY_EXTRACT; then
-    echo "Downloading Hadoop from $URL to ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz"
-    curl -z ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz -o ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz -L $URL
-
-    if [ $? != 0 ]; then
-        echo "Failed to download Hadoop from $URL - abort" >&2
-        exit 1
-    fi
-fi
-
-if $ONLY_DOWNLOAD; then
-    exit 0
-fi
-
-echo "Extracting ${HADOOP_HOME}/hadoop.tar.gz into $HADOOP_HOME"
-tar zxf ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz --strip-components 1 -C $HADOOP_HOME
-
-if [ $? != 0 ]; then
-    echo "Failed to extract Hadoop from ${HADOOP_HOME}/hadoop.tar.gz to ${HADOOP_HOME} - abort" >&2
-    echo "Trying again..." >&2
-    # dont use cache
-    curl -o ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz -L $URL
-    tar zxf ${TRAVIS_CACHE}/${HADOOP_DISTRO}/hadoop.tar.gz --strip-components 1 -C $HADOOP_HOME
-    if [ $? != 0 ]; then
-        echo "Failed twice in downloading and unpacking hadoop!" >&2
-        exit 1
-    fi
-fi
-
-echo "Downloading and unpacking hive"
-curl -z ${TRAVIS_CACHE}/hive/hive.tar.gz -o ${TRAVIS_CACHE}/hive/hive.tar.gz -L ${HIVE_URL}
-tar zxf ${TRAVIS_CACHE}/hive/hive.tar.gz --strip-components 1 -C ${HIVE_HOME}
-
-if [ $? != 0 ]; then
-    echo "Failed to extract hive from ${TRAVIS_CACHE}/hive/hive.tar.gz" >&2
-    echo "Trying again..." >&2
-    # dont use cache
-    curl -o ${TRAVIS_CACHE}/hive/hive.tar.gz -L ${HIVE_URL}
-    tar zxf ${TRAVIS_CACHE}/hive/hive.tar.gz --strip-components 1 -C ${HIVE_HOME}
-    if [ $? != 0 ]; then
-        echo "Failed twice in downloading and unpacking hive!" >&2
-        exit 1
-    fi
-fi
-
-echo "Downloading and unpacking minicluster"
-curl -z ${TRAVIS_CACHE}/minicluster/minicluster.zip -o ${TRAVIS_CACHE}/minicluster/minicluster.zip -L ${MINICLUSTER_URL}
-ls -l ${TRAVIS_CACHE}/minicluster/minicluster.zip
-unzip ${TRAVIS_CACHE}/minicluster/minicluster.zip -d /tmp
-if [ $? != 0 ] ; then
-    # Try downloading w/o cache if there's a failure
-    curl -o ${TRAVIS_CACHE}/minicluster/minicluster.zip -L ${MINICLUSTER_URL}
-    ls -l ${TRAVIS_CACHE}/minicluster/minicluster.zip
-    unzip ${TRAVIS_CACHE}/minicluster/minicluster.zip -d /tmp
-    if [ $? != 0 ] ; then
-        echo "Failed twice in downloading and unpacking minicluster!" >&2
-        exit 1
-    fi
-    exit 1
-fi
-
-echo "Path = ${PATH}"
-
-java -cp "/tmp/minicluster-1.1-SNAPSHOT/*" com.ing.minicluster.MiniCluster > /dev/null &
diff --git a/scripts/ci/test-environment.sh b/scripts/ci/test-environment.sh
new file mode 100644
index 0000000000000..5c402d46df287
--- /dev/null
+++ b/scripts/ci/test-environment.sh
@@ -0,0 +1,19 @@
+#!/bin/bash -e
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+docker-compose -f scripts/ci/docker-compose.yml run --rm airflow-testing "${@-bash}"
diff --git a/tests/contrib/hooks/test_cassandra_hook.py b/tests/contrib/hooks/test_cassandra_hook.py
index 9cb0739993173..73dac4f3b42ba 100644
--- a/tests/contrib/hooks/test_cassandra_hook.py
+++ b/tests/contrib/hooks/test_cassandra_hook.py
@@ -42,7 +42,7 @@ def setUp(self):
         db.merge_conn(
             models.Connection(
                 conn_id='cassandra_default_with_schema', conn_type='cassandra',
-                host='localhost', port='9042', schema='s'))
+                host='cassandra', port='9042', schema='s'))
 
         hook = CassandraHook("cassandra_default")
         session = hook.get_conn()
diff --git a/tests/contrib/sensors/test_mongo_sensor.py b/tests/contrib/sensors/test_mongo_sensor.py
index 876cb99ba4251..6a78b7d146498 100644
--- a/tests/contrib/sensors/test_mongo_sensor.py
+++ b/tests/contrib/sensors/test_mongo_sensor.py
@@ -38,7 +38,7 @@ def setUp(self):
         db.merge_conn(
             Connection(
                 conn_id='mongo_test', conn_type='mongo',
-                host='localhost', port='27017', schema='test'))
+                host='mongo', port='27017', schema='test'))
 
         args = {
             'owner': 'airflow',
diff --git a/tests/core.py b/tests/core.py
index fd0d803eee074..5a78244184d04 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -2187,7 +2187,7 @@ def setUp(self):
             configuration.conf.add_section("ldap")
         except:
             pass
-        configuration.conf.set("ldap", "uri", "ldap://localhost:3890")
+        configuration.conf.set("ldap", "uri", "ldap://openldap:389")
         configuration.conf.set("ldap", "user_filter", "objectClass=*")
         configuration.conf.set("ldap", "user_name_attr", "uid")
         configuration.conf.set("ldap", "bind_user", "cn=Manager,dc=example,dc=com")
@@ -2274,7 +2274,7 @@ def setUp(self):
             configuration.conf.add_section("ldap")
         except:
             pass
-        configuration.conf.set("ldap", "uri", "ldap://localhost:3890")
+        configuration.conf.set("ldap", "uri", "ldap://openldap:389")
         configuration.conf.set("ldap", "user_filter", "objectClass=*")
         configuration.conf.set("ldap", "user_name_attr", "uid")
         configuration.conf.set("ldap", "bind_user", "cn=Manager,dc=example,dc=com")
diff --git a/tox.ini b/tox.ini
index eba94a89e577d..fdc375ea99b8c 100644
--- a/tox.ini
+++ b/tox.ini
@@ -43,39 +43,37 @@ setenv =
   HADOOP_DISTRO=cdh
   HADOOP_HOME=/tmp/hadoop-cdh
   HADOOP_OPTS=-D/tmp/krb5.conf
-  MINICLUSTER_HOME=/tmp/minicluster-1.1-SNAPSHOT
   HIVE_HOME=/tmp/hive
-  backend_mysql: AIRFLOW__CORE__SQL_ALCHEMY_CONN=mysql://root@localhost/airflow
-  backend_postgres: AIRFLOW__CORE__SQL_ALCHEMY_CONN=postgresql+psycopg2://postgres@localhost/airflow
-  backend_sqlite: AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:///{homedir}/airflow/airflow.db
+  MINICLUSTER_HOME=/tmp/minicluster-1.1-SNAPSHOT
+  KRB5_CONFIG=/etc/krb5.conf
+  KRB5_KTNAME=/etc/airflow.keytab
+  backend_mysql: AIRFLOW__CORE__SQL_ALCHEMY_CONN=mysql://root@mysql/airflow
+  backend_postgres: AIRFLOW__CORE__SQL_ALCHEMY_CONN=postgresql+psycopg2://postgres:airflow@postgres/airflow
+  backend_sqlite: AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:///{homedir}/airflow.db
   backend_sqlite: AIRFLOW__CORE__EXECUTOR=SequentialExecutor
 
 passenv =
     HOME
     JAVA_HOME
+    USER
+    PATH
+    BOTO_CONFIG
     TRAVIS
     TRAVIS_BRANCH
     TRAVIS_BUILD_DIR
     TRAVIS_JOB_ID
-    USER
-    TRAVIS_CACHE
     TRAVIS_PULL_REQUEST
-    PATH
-    BOTO_CONFIG
-    KRB5_CONFIG
-    KRB5_KTNAME
     SLUGIFY_USES_TEXT_UNIDECODE
 
 commands =
-  pip wheel -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
-  pip install --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
-  sudo {toxinidir}/scripts/ci/setup_kdc.sh
-  {toxinidir}/scripts/ci/setup_env.sh
-  {toxinidir}/scripts/ci/ldap.sh
-  {toxinidir}/scripts/ci/load_fixtures.sh
-  {toxinidir}/scripts/ci/load_data.sh
-  {toxinidir}/scripts/ci/run_tests.sh []
-  {toxinidir}/scripts/ci/check-license.sh
+  pip wheel --progress-bar off -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
+  pip install --progress-bar off --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
+  {toxinidir}/scripts/ci/1-setup-env.sh
+  {toxinidir}/scripts/ci/2-setup-kdc.sh
+  {toxinidir}/scripts/ci/3-setup-databases.sh
+  {toxinidir}/scripts/ci/4-load-data.sh
+  {toxinidir}/scripts/ci/5-run-tests.sh []
+  {toxinidir}/scripts/ci/6-check-license.sh
 
 [testenv:flake8]
 basepython = python3
@@ -84,5 +82,4 @@ deps =
     flake8==3.5.0
 
 commands =
-    {toxinidir}/scripts/ci/flake8_diff.sh
-
+    {toxinidir}/scripts/ci/flake8-diff.sh

From 213061973bfec93a8bab42a5d267b317b85cc465 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sat, 25 Aug 2018 19:50:16 +0200
Subject: [PATCH 351/808] [AIRFLOW-2933] Enable Codecov on Docker-CI Build
 (#3780)

- Add missing variables and use codecov instead of coveralls.
  The issue why it wasn't working was because missing environment variables.
  The codecov library heavily depends on the environment variables in
  the CI to determine how to push the reports to codecov.

- Remove the explicit passing of the variables in the `tox.ini`
  since it is already done in the `docker-compose.yml`,
  having to maintain this at two places makes it brittle.

- Removed the empty Codecov yml since codecov was complaining that
  it was unable to parse it
---
 .codecov.yml                  | 19 -------------------
 .travis.yml                   |  6 +-----
 scripts/ci/docker-compose.yml |  6 ++++++
 tox.ini                       | 16 +++-------------
 4 files changed, 10 insertions(+), 37 deletions(-)
 delete mode 100644 .codecov.yml

diff --git a/.codecov.yml b/.codecov.yml
deleted file mode 100644
index 4094f35dccf0d..0000000000000
--- a/.codecov.yml
+++ /dev/null
@@ -1,19 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-# 
-#   http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-# keep default
diff --git a/.travis.yml b/.travis.yml
index 9c7cfd02084db..5bd750453a563 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -42,7 +42,7 @@ cache:
 before_install:
   - sudo ls -lh $HOME/.cache/pip/
   - sudo rm -rf $HOME/.cache/pip/* $HOME/.wheelhouse/*
-  - sudo chown -R travis.travis $HOME/.cache/pip
+  - sudo chown -R travis:travis $HOME/.cache/pip
 install:
   # Use recent docker-compose version
   - sudo rm /usr/local/bin/docker-compose
@@ -50,9 +50,5 @@ install:
   - chmod +x docker-compose
   - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
-  - pip install codecov
 script:
   - docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
-after_success:
-  - sudo chown -R travis.travis .
-  - codecov
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 861cf9e8b89ce..32e0a536c1597 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -70,11 +70,17 @@ services:
       - SLUGIFY_USES_TEXT_UNIDECODE=yes
       - TOX_ENV
       - PYTHON_VERSION
+      - CI
       - TRAVIS
       - TRAVIS_BRANCH
       - TRAVIS_BUILD_DIR
       - TRAVIS_JOB_ID
+      - TRAVIS_JOB_NUMBER
       - TRAVIS_PULL_REQUEST
+      - TRAVIS_COMMIT
+      - TRAVIS_REPO_SLUG
+      - TRAVIS_OS_NAME
+      - TRAVIS_TAG
     depends_on:
       - postgres
       - mysql
diff --git a/tox.ini b/tox.ini
index fdc375ea99b8c..77a3de9865f13 100644
--- a/tox.ini
+++ b/tox.ini
@@ -33,7 +33,7 @@ ignore = E731,W503
 [testenv]
 deps =
     wheel
-    coveralls
+    codecov
 
 basepython =
   py27: python2.7
@@ -52,18 +52,7 @@ setenv =
   backend_sqlite: AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:///{homedir}/airflow.db
   backend_sqlite: AIRFLOW__CORE__EXECUTOR=SequentialExecutor
 
-passenv =
-    HOME
-    JAVA_HOME
-    USER
-    PATH
-    BOTO_CONFIG
-    TRAVIS
-    TRAVIS_BRANCH
-    TRAVIS_BUILD_DIR
-    TRAVIS_JOB_ID
-    TRAVIS_PULL_REQUEST
-    SLUGIFY_USES_TEXT_UNIDECODE
+passenv = *
 
 commands =
   pip wheel --progress-bar off -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
@@ -74,6 +63,7 @@ commands =
   {toxinidir}/scripts/ci/4-load-data.sh
   {toxinidir}/scripts/ci/5-run-tests.sh []
   {toxinidir}/scripts/ci/6-check-license.sh
+  codecov -e TOXENV
 
 [testenv:flake8]
 basepython = python3

From 5f8972afcaabf7f285e374ef63e0db3fd4b71f88 Mon Sep 17 00:00:00 2001
From: Riccardo Bini <odracci@gmail.com>
Date: Fri, 21 Sep 2018 14:36:09 +0200
Subject: [PATCH 352/808] [AIRFLOW-2952] Fix Kubernetes CI (#3922)

---
 .travis.yml                                   | 32 ++++++++-----
 airflow/example_dags_kubernetes/__init__.py   | 18 +++++++
 .../example_kubernetes_annotation.py          | 47 +++++++++++++++++++
 scripts/ci/docker-compose-kubernetes.yml      | 28 +++++++++++
 scripts/ci/kubernetes/docker/build.sh         | 10 ++--
 scripts/ci/kubernetes/kube/airflow.yaml       |  1 -
 scripts/ci/kubernetes/kube/configmaps.yaml    |  2 +-
 scripts/ci/kubernetes/kube/deploy.sh          |  2 +
 .../ci/kubernetes/minikube/start_minikube.sh  |  4 +-
 scripts/ci/kubernetes/setup_kubernetes.sh     |  1 -
 scripts/ci/run-ci.sh                          | 10 +++-
 .../minikube/test_kubernetes_executor.py      | 24 ++++++----
 .../minikube/test_kubernetes_pod_operator.py  | 13 +++--
 tests/core.py                                 |  4 +-
 tox.ini                                       | 12 ++---
 15 files changed, 167 insertions(+), 41 deletions(-)
 create mode 100644 airflow/example_dags_kubernetes/__init__.py
 create mode 100644 airflow/example_dags_kubernetes/example_kubernetes_annotation.py
 create mode 100644 scripts/ci/docker-compose-kubernetes.yml

diff --git a/.travis.yml b/.travis.yml
index 5bd750453a563..dd493363ab1e7 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -26,23 +26,24 @@ env:
     - TRAVIS_CACHE=$HOME/.travis_cache/
   matrix:
     - TOX_ENV=flake8
-    - TOX_ENV=py27-backend_mysql
-    - TOX_ENV=py27-backend_sqlite
-    - TOX_ENV=py27-backend_postgres
-    - TOX_ENV=py35-backend_mysql PYTHON_VERSION=3
-    - TOX_ENV=py35-backend_sqlite PYTHON_VERSION=3
-    - TOX_ENV=py35-backend_postgres PYTHON_VERSION=3
-    - TOX_ENV=py27-backend_postgres KUBERNETES_VERSION=v1.9.0
-    - TOX_ENV=py35-backend_postgres KUBERNETES_VERSION=v1.10.0 PYTHON_VERSION=3
+    - TOX_ENV=py27-backend_mysql-env_docker
+    - TOX_ENV=py27-backend_sqlite-env_docker
+    - TOX_ENV=py27-backend_postgres-env_docker
+    - TOX_ENV=py35-backend_mysql-env_docker PYTHON_VERSION=3
+    - TOX_ENV=py35-backend_sqlite-env_docker PYTHON_VERSION=3
+    - TOX_ENV=py35-backend_postgres-env_docker PYTHON_VERSION=3
+    - TOX_ENV=py27-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.9.0
+    - TOX_ENV=py35-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.10.0 PYTHON_VERSION=3
+
 cache:
   directories:
     - $HOME/.wheelhouse/
     - $HOME/.cache/pip
     - $HOME/.travis_cache/
 before_install:
-  - sudo ls -lh $HOME/.cache/pip/
-  - sudo rm -rf $HOME/.cache/pip/* $HOME/.wheelhouse/*
-  - sudo chown -R travis:travis $HOME/.cache/pip
+  # Required for K8s v1.10.x. See
+  # https://github.com/kubernetes/kubernetes/issues/61058#issuecomment-372764783
+  - if [ ! -z "$KUBERNETES_VERSION" ]; then sudo mount --make-shared / && sudo service docker restart; fi
 install:
   # Use recent docker-compose version
   - sudo rm /usr/local/bin/docker-compose
@@ -50,5 +51,12 @@ install:
   - chmod +x docker-compose
   - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
+  - if [ ! -z "$KUBERNETES_VERSION" ]; then ./scripts/ci/kubernetes/setup_kubernetes.sh; fi
 script:
-  - docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
+  - if [ -z "$KUBERNETES_VERSION" ]; then docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh; fi
+  - if [ ! -z "$KUBERNETES_VERSION" ]; then
+      ./scripts/ci/kubernetes/kube/deploy.sh &&
+      MINIKUBE_IP=$(minikube ip) docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml -f scripts/ci/docker-compose-kubernetes.yml run airflow-testing /app/scripts/ci/run-ci.sh;
+    fi
+before_cache:
+  - sudo chown -R travis:travis $HOME/.cache/pip $HOME/.wheelhouse/
diff --git a/airflow/example_dags_kubernetes/__init__.py b/airflow/example_dags_kubernetes/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/airflow/example_dags_kubernetes/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/airflow/example_dags_kubernetes/example_kubernetes_annotation.py b/airflow/example_dags_kubernetes/example_kubernetes_annotation.py
new file mode 100644
index 0000000000000..058baf69901f7
--- /dev/null
+++ b/airflow/example_dags_kubernetes/example_kubernetes_annotation.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from __future__ import print_function
+import airflow
+from airflow.operators.python_operator import PythonOperator
+from airflow.models import DAG
+
+args = {
+    'owner': 'airflow',
+    'start_date': airflow.utils.dates.days_ago(2)
+}
+
+dag = DAG(
+    dag_id='example_kubernetes_annotation', default_args=args,
+    schedule_interval=None
+)
+
+
+def print_stuff():
+    print("annotated!")
+
+
+# You can use annotations on your kubernetes pods!
+start_task = PythonOperator(
+    task_id="start_task", python_callable=print_stuff, dag=dag,
+    executor_config={
+        "KubernetesExecutor": {
+            "annotations": {"test": "annotation"}
+        }
+    }
+)
diff --git a/scripts/ci/docker-compose-kubernetes.yml b/scripts/ci/docker-compose-kubernetes.yml
new file mode 100644
index 0000000000000..0cdb2df199b7b
--- /dev/null
+++ b/scripts/ci/docker-compose-kubernetes.yml
@@ -0,0 +1,28 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+version: "2.2"
+services:
+  airflow-testing:
+    network_mode: host
+    environment:
+      - KUBERNETES_VERSION
+      - MINIKUBE_IP
+    volumes:
+      - /usr/local/bin/kubectl:/usr/local/bin/kubectl
+      - /usr/local/bin/minikube:/usr/local/bin/minikube
+      - ~/.kube:/home/airflow/.kube
+      - ~/.minikube:/home/airflow/.minikube
diff --git a/scripts/ci/kubernetes/docker/build.sh b/scripts/ci/kubernetes/docker/build.sh
index b93c6b1715ddb..49d0fb87c3a31 100755
--- a/scripts/ci/kubernetes/docker/build.sh
+++ b/scripts/ci/kubernetes/docker/build.sh
@@ -22,9 +22,13 @@ TAG=${2:-latest}
 DIRNAME=$(cd "$(dirname "$0")"; pwd)
 AIRFLOW_ROOT="$DIRNAME/../../../.."
 
-ENVCONFIG=$(minikube docker-env)
-if [ $? -eq 0 ]; then
-  eval $ENVCONFIG
+set -e
+
+if [ "${VM_DRIVER:-none}" != "none" ]; then
+    ENVCONFIG=$(minikube docker-env)
+    if [ $? -eq 0 ]; then
+      eval $ENVCONFIG
+    fi
 fi
 
 echo "Airflow directory $AIRFLOW_ROOT"
diff --git a/scripts/ci/kubernetes/kube/airflow.yaml b/scripts/ci/kubernetes/kube/airflow.yaml
index 4f451ba44a687..1b6e33cec5b3c 100644
--- a/scripts/ci/kubernetes/kube/airflow.yaml
+++ b/scripts/ci/kubernetes/kube/airflow.yaml
@@ -151,4 +151,3 @@ spec:
       nodePort: 30809
   selector:
     name: airflow
-
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/configmaps.yaml
index b5fa3e5f639ee..86c1a9756134e 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/configmaps.yaml
@@ -27,7 +27,7 @@ data:
     logging_level = INFO
     executor = KubernetesExecutor
     parallelism = 32
-    load_examples = True
+    load_examples = False
     plugins_folder = /root/airflow/plugins
     sql_alchemy_conn = $SQL_ALCHEMY_CONN
 
diff --git a/scripts/ci/kubernetes/kube/deploy.sh b/scripts/ci/kubernetes/kube/deploy.sh
index a9a42a7a12d12..75567c9acf6a4 100755
--- a/scripts/ci/kubernetes/kube/deploy.sh
+++ b/scripts/ci/kubernetes/kube/deploy.sh
@@ -17,6 +17,8 @@
 #  specific language governing permissions and limitations      *
 #  under the License.                                           *
 
+set -x
+
 IMAGE=${1:-airflow/ci}
 TAG=${2:-latest}
 DIRNAME=$(cd "$(dirname "$0")"; pwd)
diff --git a/scripts/ci/kubernetes/minikube/start_minikube.sh b/scripts/ci/kubernetes/minikube/start_minikube.sh
index 5171a26313d53..6f843b89ec68f 100755
--- a/scripts/ci/kubernetes/minikube/start_minikube.sh
+++ b/scripts/ci/kubernetes/minikube/start_minikube.sh
@@ -19,11 +19,13 @@
 
 #!/usr/bin/env bash
 
+set -x
 
 _MY_SCRIPT="${BASH_SOURCE[0]}"
 _MY_DIR=$(cd "$(dirname "$_MY_SCRIPT")" && pwd)
 # Avoids 1.7.x because of https://github.com/kubernetes/minikube/issues/2240
 _KUBERNETES_VERSION="${KUBERNETES_VERSION}"
+_MINIKUBE_VERSION="${MINIKUBE_VERSION:-v0.28.2}"
 
 echo "setting up kubernetes ${_KUBERNETES_VERSION}"
 
@@ -118,7 +120,7 @@ echo Showing kube-system pods
 kubectl get -n kube-system pods
 
 (k8s_single_pod_ready -n kube-system -l component=kube-addon-manager) ||
-  (_ADDON=$(kubectl get pod -n kube-system -l component=kube-addon-manager
+  (_ADDON=$(kubectl get pod -n kube-system -l component=kube-addon-manager \
       --no-headers -o name| cut -d/ -f2);
    echo Addon-manager describe:;
    kubectl describe pod -n kube-system $_ADDON;
diff --git a/scripts/ci/kubernetes/setup_kubernetes.sh b/scripts/ci/kubernetes/setup_kubernetes.sh
index ea559a02aa997..96f8f5d6af2a5 100755
--- a/scripts/ci/kubernetes/setup_kubernetes.sh
+++ b/scripts/ci/kubernetes/setup_kubernetes.sh
@@ -25,6 +25,5 @@ DIRNAME=$(cd "$(dirname "$0")"; pwd)
 
 $DIRNAME/minikube/start_minikube.sh
 $DIRNAME/docker/build.sh
-$DIRNAME/kube/deploy.sh
 
 echo "Airflow environment on kubernetes is good to go!"
diff --git a/scripts/ci/run-ci.sh b/scripts/ci/run-ci.sh
index f2815bbd95979..1a65bf1ef6443 100755
--- a/scripts/ci/run-ci.sh
+++ b/scripts/ci/run-ci.sh
@@ -24,7 +24,7 @@ DIRNAME=$(cd "$(dirname "$0")"; pwd)
 AIRFLOW_ROOT="$DIRNAME/../.."
 
 # Fix file permissions
-sudo chown -R airflow.airflow . $HOME/.wheelhouse/ $HOME/.cache/pip
+sudo chown -R airflow.airflow . $HOME/.cache $HOME/.wheelhouse/ $HOME/.cache/pip $HOME/.kube $HOME/.minikube
 
 if [[ $PYTHON_VERSION == '3' ]]; then
   PIP=pip3
@@ -41,7 +41,13 @@ if [ -z "$KUBERNETES_VERSION" ];
 then
   tox -e $TOX_ENV
 else
-  KUBERNETES_VERSION=${KUBERNETES_VERSION} $DIRNAME/kubernetes/setup_kubernetes.sh && \
+  # This script runs inside a container, the path of the kubernetes certificate
+  # is /home/travis/.minikube/client.crt but the user in the container is `airflow`
+  if [ ! -d /home/travis ]; then
+    sudo mkdir -p /home/travis
+  fi
+  sudo ln -s /home/airflow/.minikube /home/travis/.minikube
+
   tox -e $TOX_ENV -- tests.contrib.minikube \
                      --with-coverage \
                      --cover-erase \
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index a8db7e12b7554..7d3947799dcd5 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -16,6 +16,7 @@
 # under the License.
 
 
+import os
 import unittest
 from subprocess import check_call, check_output
 import requests.exceptions
@@ -25,18 +26,25 @@
 import re
 
 try:
-    check_call(["kubectl", "get", "pods"])
+    check_call(["/usr/local/bin/kubectl", "get", "pods"])
 except Exception as e:
-    raise unittest.SkipTest(
-        "Kubernetes integration tests require a minikube cluster;"
-        "Skipping tests {}".format(e)
-    )
+    if os.environ.get('KUBERNETES_VERSION'):
+        raise e
+    else:
+        raise unittest.SkipTest(
+            "Kubernetes integration tests require a minikube cluster;"
+            "Skipping tests {}".format(e)
+        )
 
 
 def get_minikube_host():
-    host_ip = check_output(['minikube', 'ip'])
-    if six.PY3:
-        host_ip = host_ip.decode('UTF-8')
+    if "MINIKUBE_IP" in os.environ:
+        host_ip = os.environ['MINIKUBE_IP']
+    else:
+        host_ip = check_output(['/usr/local/bin/minikube', 'ip'])
+        if six.PY3:
+            host_ip = host_ip.decode('UTF-8')
+
     host = '{}:30809'.format(host_ip.strip())
     return host
 
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 6ab69f31c6927..f808a2f47febe 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -29,12 +29,15 @@
 from airflow.contrib.kubernetes.volume import Volume
 
 try:
-    check_call(["kubectl", "get", "pods"])
+    check_call(["/usr/local/bin/kubectl", "get", "pods"])
 except Exception as e:
-    raise unittest.SkipTest(
-        "Kubernetes integration tests require a minikube cluster;"
-        "Skipping tests {}".format(e)
-    )
+    if os.environ.get('KUBERNETES_VERSION'):
+        raise e
+    else:
+        raise unittest.SkipTest(
+            "Kubernetes integration tests require a minikube cluster;"
+            "Skipping tests {}".format(e)
+        )
 
 
 class KubernetesPodOperatorTest(unittest.TestCase):
diff --git a/tests/core.py b/tests/core.py
index 5a78244184d04..7b29bc6aad0de 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -98,7 +98,9 @@ def reset(dag_id=TEST_DAG_ID):
     session.close()
 
 
-reset()
+configuration.conf.load_test_config()
+if os.environ.get('KUBERNETES_VERSION') is None:
+    reset()
 
 
 class OperatorSubclass(BaseOperator):
diff --git a/tox.ini b/tox.ini
index 77a3de9865f13..acbeb970e7ffb 100644
--- a/tox.ini
+++ b/tox.ini
@@ -17,8 +17,8 @@
 # under the License.
 
 [tox]
-envlist = flake8,{py27,py35}-backend_{mysql,sqlite,postgres}
-skipsdist=True
+envlist = flake8,{py27,py35}-backend_{mysql,sqlite,postgres}-env_{docker,kubernetes}
+skipsdist = True
 
 [global]
 wheel_dir = {homedir}/.wheelhouse
@@ -57,10 +57,10 @@ passenv = *
 commands =
   pip wheel --progress-bar off -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
   pip install --progress-bar off --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
-  {toxinidir}/scripts/ci/1-setup-env.sh
-  {toxinidir}/scripts/ci/2-setup-kdc.sh
-  {toxinidir}/scripts/ci/3-setup-databases.sh
-  {toxinidir}/scripts/ci/4-load-data.sh
+  env_docker: {toxinidir}/scripts/ci/1-setup-env.sh
+  env_docker: {toxinidir}/scripts/ci/2-setup-kdc.sh
+  env_docker: {toxinidir}/scripts/ci/3-setup-databases.sh
+  env_docker: {toxinidir}/scripts/ci/4-load-data.sh
   {toxinidir}/scripts/ci/5-run-tests.sh []
   {toxinidir}/scripts/ci/6-check-license.sh
   codecov -e TOXENV

From 417d3be9523635cdadcef303a2800369022e3b0c Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 5 Sep 2018 00:46:41 +0100
Subject: [PATCH 353/808] [AIRFLOW-3008] Move Kubernetes example DAGs to
 contrib

---
 .../example_kubernetes_annotation.py           |  0
 airflow/example_dags_kubernetes/__init__.py    | 18 ------------------
 2 files changed, 18 deletions(-)
 rename airflow/{example_dags_kubernetes => contrib/example_dags}/example_kubernetes_annotation.py (100%)
 delete mode 100644 airflow/example_dags_kubernetes/__init__.py

diff --git a/airflow/example_dags_kubernetes/example_kubernetes_annotation.py b/airflow/contrib/example_dags/example_kubernetes_annotation.py
similarity index 100%
rename from airflow/example_dags_kubernetes/example_kubernetes_annotation.py
rename to airflow/contrib/example_dags/example_kubernetes_annotation.py
diff --git a/airflow/example_dags_kubernetes/__init__.py b/airflow/example_dags_kubernetes/__init__.py
deleted file mode 100644
index 114d189da14ab..0000000000000
--- a/airflow/example_dags_kubernetes/__init__.py
+++ /dev/null
@@ -1,18 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.

From 10808ce932d25e7d3a5a435a39227c9c1e5ef3d1 Mon Sep 17 00:00:00 2001
From: Kevin Yang <kevin.yang@airbnb.com>
Date: Thu, 28 Jun 2018 13:30:36 -0700
Subject: [PATCH 354/808] [AIRFLOW-2359] Add set failed for DagRun and task in
 tree view (#3255)

---
 airflow/api/common/experimental/mark_tasks.py | 113 ++++++-
 airflow/jobs.py                               |   3 +-
 airflow/models.py                             |   4 +-
 airflow/www/templates/airflow/dag.html        |  43 +++
 airflow/www/views.py                          | 292 +++++++++++++-----
 airflow/www_rbac/templates/airflow/dag.html   |  43 +++
 airflow/www_rbac/views.py                     | 235 ++++++++++----
 docs/scheduler.rst                            |   1 +
 tests/api/common/experimental/mark_tasks.py   | 275 +++++++++++------
 tests/dags/test_example_bash_operator.py      |   5 +-
 tests/www_rbac/test_views.py                  |   8 +-
 11 files changed, 763 insertions(+), 259 deletions(-)

diff --git a/airflow/api/common/experimental/mark_tasks.py b/airflow/api/common/experimental/mark_tasks.py
index e9e4fec2235a5..681864dfbeb3e 100644
--- a/airflow/api/common/experimental/mark_tasks.py
+++ b/airflow/api/common/experimental/mark_tasks.py
@@ -17,15 +17,16 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from sqlalchemy import or_
+
 from airflow.jobs import BackfillJob
 from airflow.models import DagRun, TaskInstance
 from airflow.operators.subdag_operator import SubDagOperator
 from airflow.settings import Session
 from airflow.utils import timezone
+from airflow.utils.db import provide_session
 from airflow.utils.state import State
 
-from sqlalchemy import or_
-
 
 def _create_dagruns(dag, execution_dates, state, run_id_template):
     """
@@ -191,15 +192,36 @@ def set_state(task, execution_date, upstream=False, downstream=False,
     return tis_altered
 
 
-def set_dag_run_state(dag, execution_date, state=State.SUCCESS, commit=False):
+def _set_dag_run_state(dag_id, execution_date, state, session=None):
+    """
+    Helper method that set dag run state in the DB.
+    :param dag_id: dag_id of target dag run
+    :param execution_date: the execution date from which to start looking
+    :param state: target state
+    :param session: database session
     """
-    Set the state of a dag run and all task instances associated with the dag
-    run for a specific execution date.
+    DR = DagRun
+    dr = session.query(DR).filter(
+        DR.dag_id == dag_id,
+        DR.execution_date == execution_date
+    ).one()
+    dr.state = state
+    dr.end_date = timezone.utcnow()
+    session.commit()
+
+
+@provide_session
+def set_dag_run_state_to_success(dag, execution_date, commit=False,
+                                 session=None):
+    """
+    Set the dag run for a specific execution date and its task instances
+    to success.
     :param dag: the DAG of which to alter state
     :param execution_date: the execution date from which to start looking
-    :param state: the state to which the DAG need to be set
     :param commit: commit DAG and tasks to be altered to the database
-    :return: list of tasks that have been created and updated
+    :param session: database session
+    :return: If commit is true, list of tasks that have been updated,
+             otherwise list of tasks that will be updated
     :raises: AssertionError if dag or execution_date is invalid
     """
     res = []
@@ -207,18 +229,81 @@ def set_dag_run_state(dag, execution_date, state=State.SUCCESS, commit=False):
     if not dag or not execution_date:
         return res
 
-    # Mark all task instances in the dag run
+    # Mark the dag run to success.
+    if commit:
+        _set_dag_run_state(dag.dag_id, execution_date, State.SUCCESS, session)
+
+    # Mark all task instances of the dag run to success.
     for task in dag.tasks:
         task.dag = dag
         new_state = set_state(task=task, execution_date=execution_date,
-                              state=state, commit=commit)
+                              state=State.SUCCESS, commit=commit)
         res.extend(new_state)
 
-    # Mark the dag run
+    return res
+
+
+@provide_session
+def set_dag_run_state_to_failed(dag, execution_date, commit=False,
+                                session=None):
+    """
+    Set the dag run for a specific execution date and its running task instances
+    to failed.
+    :param dag: the DAG of which to alter state
+    :param execution_date: the execution date from which to start looking
+    :param commit: commit DAG and tasks to be altered to the database
+    :param session: database session
+    :return: If commit is true, list of tasks that have been updated,
+             otherwise list of tasks that will be updated
+    :raises: AssertionError if dag or execution_date is invalid
+    """
+    res = []
+
+    if not dag or not execution_date:
+        return res
+
+    # Mark the dag run to failed.
+    if commit:
+        _set_dag_run_state(dag.dag_id, execution_date, State.FAILED, session)
+
+    # Mark only RUNNING task instances.
+    TI = TaskInstance
+    task_ids = [task.task_id for task in dag.tasks]
+    tis = session.query(TI).filter(
+        TI.dag_id == dag.dag_id,
+        TI.execution_date == execution_date,
+        TI.task_id.in_(task_ids)).filter(TI.state == State.RUNNING)
+    task_ids_of_running_tis = [ti.task_id for ti in tis]
+    for task in dag.tasks:
+        if task.task_id not in task_ids_of_running_tis:
+            continue
+        task.dag = dag
+        new_state = set_state(task=task, execution_date=execution_date,
+                              state=State.FAILED, commit=commit)
+        res.extend(new_state)
+
+    return res
+
+
+@provide_session
+def set_dag_run_state_to_running(dag, execution_date, commit=False,
+                                 session=None):
+    """
+    Set the dag run for a specific execution date to running.
+    :param dag: the DAG of which to alter state
+    :param execution_date: the execution date from which to start looking
+    :param commit: commit DAG and tasks to be altered to the database
+    :param session: database session
+    :return: If commit is true, list of tasks that have been updated,
+             otherwise list of tasks that will be updated
+    """
+    res = []
+    if not dag or not execution_date:
+        return res
+
+    # Mark the dag run to running.
     if commit:
-        drs = DagRun.find(dag.dag_id, execution_date=execution_date)
-        for dr in drs:
-            dr.dag = dag
-            dr.update_state()
+        _set_dag_run_state(dag.dag_id, execution_date, State.RUNNING, session)
 
+    # To keep the return type consistent with the other similar functions.
     return res
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 4daafc22ada18..0ad004809b7ff 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1009,7 +1009,8 @@ def _change_state_for_tis_without_dagrun(self,
                     models.TaskInstance.dag_id == subq.c.dag_id,
                     models.TaskInstance.task_id == subq.c.task_id,
                     models.TaskInstance.execution_date ==
-                    subq.c.execution_date)) \
+                    subq.c.execution_date,
+                    models.TaskInstance.task_id == subq.c.task_id)) \
                 .update({models.TaskInstance.state: new_state},
                         synchronize_session=False)
             session.commit()
diff --git a/airflow/models.py b/airflow/models.py
index 8e54c9b2a1a9f..a631436c9a0f2 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1690,9 +1690,9 @@ def signal_handler(signum, frame):
             return
         except AirflowException as e:
             self.refresh_from_db()
-            # for case when task is marked as success externally
+            # for case when task is marked as success/failed externally
             # current behavior doesn't hit the success callback
-            if self.state == State.SUCCESS:
+            if self.state in {State.SUCCESS, State.FAILED}:
                 return
             else:
                 self.handle_failure(e, test_mode, context)
diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index d202a977ee56f..c34ec375b6f78 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -197,6 +197,24 @@ <h4 class="modal-title" id="myModalLabel">
             </button>
           </span>
           <hr/>
+          <button id="btn_failed" type="button" class="btn btn-primary">
+            Mark Failed
+          </button>
+          <span class="btn-group">
+            <button id="btn_failed_past"
+              type="button" class="btn" data-toggle="button">Past</button>
+            <button id="btn_failed_future"
+              type="button" class="btn" data-toggle="button">
+              Future
+            </button>
+            <button id="btn_failed_upstream"
+              type="button" class="btn" data-toggle="button">Upstream</button>
+            <button id="btn_failed_downstream"
+              type="button" class="btn" data-toggle="button">
+              Downstream
+            </button>
+          </span>
+          <hr/>
           <button id="btn_success" type="button" class="btn btn-primary">
             Mark Success
           </button>
@@ -241,6 +259,9 @@ <h4 class="modal-title" id="dagModalLabel">
           <button id="btn_dagrun_clear" type="button" class="btn btn-primary">
             Clear
           </button>
+          <button id="btn_dagrun_failed" type="button" class="btn btn-primary">
+            Mark Failed
+          </button>
           <button id="btn_dagrun_success" type="button" class="btn btn-primary">
             Mark Success
           </button>
@@ -389,6 +410,20 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
+    $("#btn_failed").click(function(){
+      url = "{{ url_for('airflow.failed') }}" +
+        "?task_id=" + encodeURIComponent(task_id) +
+        "&dag_id=" + encodeURIComponent(dag_id) +
+        "&upstream=" + $('#btn_failed_upstream').hasClass('active') +
+        "&downstream=" + $('#btn_failed_downstream').hasClass('active') +
+        "&future=" + $('#btn_failed_future').hasClass('active') +
+        "&past=" + $('#btn_failed_past').hasClass('active') +
+        "&execution_date=" + encodeURIComponent(execution_date) +
+        "&origin=" + encodeURIComponent(window.location);
+
+      window.location = url;
+    });
+
     $("#btn_success").click(function(){
       url = "{{ url_for('airflow.success') }}" +
         "?task_id=" + encodeURIComponent(task_id) +
@@ -403,6 +438,14 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
+    $('#btn_dagrun_failed').click(function(){
+      url = "{{ url_for('airflow.dagrun_failed') }}" +
+        "?dag_id=" + encodeURIComponent(dag_id) +
+        "&execution_date=" + encodeURIComponent(execution_date) +
+        "&origin=" + encodeURIComponent(window.location);
+      window.location = url;
+    });
+
     $('#btn_dagrun_success').click(function(){
       url = "{{ url_for('airflow.dagrun_success') }}" +
         "?dag_id=" + encodeURIComponent(dag_id) +
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 41465c78c00b6..c10c28586684f 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -18,77 +18,68 @@
 # under the License.
 #
 
-from past.builtins import basestring, unicode
-
 import ast
+import codecs
+import copy
 import datetime as dt
+import inspect
 import itertools
+import json
 import logging
-import os
-import pkg_resources
-import socket
-from functools import wraps
-from datetime import timedelta
-import copy
 import math
-import json
-import bleach
-import pendulum
-import codecs
+import os
+import traceback
 from collections import defaultdict
-
-import inspect
+from datetime import timedelta
+from functools import wraps
 from textwrap import dedent
-import traceback
 
+import bleach
+import markdown
+import nvd3
+import pendulum
 import sqlalchemy as sqla
-from sqlalchemy import or_, desc, and_, union_all
-
 from flask import (
     abort, jsonify, redirect, url_for, request, Markup, Response,
     current_app, render_template, make_response)
+from flask import flash
+from flask._compat import PY2
 from flask_admin import BaseView, expose, AdminIndexView
-from flask_admin.contrib.sqla import ModelView
 from flask_admin.actions import action
 from flask_admin.babel import lazy_gettext
+from flask_admin.contrib.sqla import ModelView
+from flask_admin.form.fields import DateTimeField
 from flask_admin.tools import iterdecode
-from flask import flash
-from flask._compat import PY2
-
-from jinja2.sandbox import ImmutableSandboxedEnvironment
 from jinja2 import escape
-
-import markdown
-import nvd3
-
+from jinja2.sandbox import ImmutableSandboxedEnvironment
+from past.builtins import basestring, unicode
+from pygments import highlight, lexers
+from pygments.formatters import HtmlFormatter
+from sqlalchemy import or_, desc, and_, union_all
 from wtforms import (
     Form, SelectField, TextAreaField, PasswordField,
     StringField, validators)
-from flask_admin.form.fields import DateTimeField
-
-from pygments import highlight, lexers
-from pygments.formatters import HtmlFormatter
 
 import airflow
 from airflow import configuration as conf
 from airflow import models
 from airflow import settings
-from airflow.api.common.experimental.mark_tasks import set_dag_run_state
+from airflow.api.common.experimental.mark_tasks import (set_dag_run_state_to_running,
+                                                        set_dag_run_state_to_success,
+                                                        set_dag_run_state_to_failed)
 from airflow.exceptions import AirflowException
-from airflow.models import XCom, DagRun
-from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
-
 from airflow.models import BaseOperator
+from airflow.models import XCom, DagRun
 from airflow.operators.subdag_operator import SubDagOperator
-
+from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
-from airflow.utils.json import json_ser
-from airflow.utils.state import State
+from airflow.utils.dates import infer_time_unit, scale_time_units, parse_execution_date
 from airflow.utils.db import create_session, provide_session
 from airflow.utils.helpers import alchemy_to_dict
-from airflow.utils.dates import infer_time_unit, scale_time_units, parse_execution_date
-from airflow.utils.timezone import datetime
+from airflow.utils.json import json_ser
 from airflow.utils.net import get_hostname
+from airflow.utils.state import State
+from airflow.utils.timezone import datetime
 from airflow.www import utils as wwwutils
 from airflow.www.forms import (DateTimeForm, DateTimeWithNumRunsForm,
                                DateTimeWithNumRunsWithDagRunsForm)
@@ -1213,16 +1204,35 @@ def blocked(self, session=None):
             })
         return wwwutils.json_response(payload)
 
-    @expose('/dagrun_success')
-    @login_required
-    @wwwutils.action_logging
-    @wwwutils.notify_owner
-    def dagrun_success(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+    def _mark_dagrun_state_as_failed(self, dag_id, execution_date, confirmed, origin):
+        if not execution_date:
+            flash('Invalid execution date', 'error')
+            return redirect(origin)
+
+        execution_date = pendulum.parse(execution_date)
+        dag = dagbag.get_dag(dag_id)
+
+        if not dag:
+            flash('Cannot find DAG: {}'.format(dag_id), 'error')
+            return redirect(origin)
+
+        new_dag_state = set_dag_run_state_to_failed(dag, execution_date, commit=confirmed)
+
+        if confirmed:
+            flash('Marked failed on {} task instances'.format(len(new_dag_state)))
+            return redirect(origin)
+
+        else:
+            details = '\n'.join([str(t) for t in new_dag_state])
+
+            response = self.render('airflow/confirm.html',
+                                   message=("Here's the list of task instances you are "
+                                            "about to mark as failed"),
+                                   details=details)
+
+            return response
 
+    def _mark_dagrun_state_as_success(self, dag_id, execution_date, confirmed, origin):
         if not execution_date:
             flash('Invalid execution date', 'error')
             return redirect(origin)
@@ -1234,8 +1244,8 @@ def dagrun_success(self):
             flash('Cannot find DAG: {}'.format(dag_id), 'error')
             return redirect(origin)
 
-        new_dag_state = set_dag_run_state(dag, execution_date, state=State.SUCCESS,
-                                          commit=confirmed)
+        new_dag_state = set_dag_run_state_to_success(dag, execution_date,
+                                                     commit=confirmed)
 
         if confirmed:
             flash('Marked success on {} task instances'.format(len(new_dag_state)))
@@ -1246,30 +1256,43 @@ def dagrun_success(self):
 
             response = self.render('airflow/confirm.html',
                                    message=("Here's the list of task instances you are "
-                                            "about to mark as successful:"),
+                                            "about to mark as success"),
                                    details=details)
 
             return response
 
-    @expose('/success')
+    @expose('/dagrun_failed')
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
-    def success(self):
+    def dagrun_failed(self):
         dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
+        execution_date = request.args.get('execution_date')
+        confirmed = request.args.get('confirmed') == 'true'
+        origin = request.args.get('origin')
+        return self._mark_dagrun_state_as_failed(dag_id, execution_date,
+                                                 confirmed, origin)
+
+    @expose('/dagrun_success')
+    @login_required
+    @wwwutils.action_logging
+    @wwwutils.notify_owner
+    def dagrun_success(self):
+        dag_id = request.args.get('dag_id')
+        execution_date = request.args.get('execution_date')
+        confirmed = request.args.get('confirmed') == 'true'
         origin = request.args.get('origin')
+        return self._mark_dagrun_state_as_success(dag_id, execution_date,
+                                                  confirmed, origin)
+
+    def _mark_task_instance_state(self, dag_id, task_id, origin, execution_date,
+                                  confirmed, upstream, downstream,
+                                  future, past, state):
         dag = dagbag.get_dag(dag_id)
         task = dag.get_task(task_id)
         task.dag = dag
 
-        execution_date = request.args.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
 
         if not dag:
             flash("Cannot find DAG: {}".format(dag_id))
@@ -1284,26 +1307,66 @@ def success(self):
         if confirmed:
             altered = set_state(task=task, execution_date=execution_date,
                                 upstream=upstream, downstream=downstream,
-                                future=future, past=past, state=State.SUCCESS,
+                                future=future, past=past, state=state,
                                 commit=True)
 
-            flash("Marked success on {} task instances".format(len(altered)))
+            flash("Marked {} on {} task instances".format(state, len(altered)))
             return redirect(origin)
 
         to_be_altered = set_state(task=task, execution_date=execution_date,
                                   upstream=upstream, downstream=downstream,
-                                  future=future, past=past, state=State.SUCCESS,
+                                  future=future, past=past, state=state,
                                   commit=False)
 
         details = "\n".join([str(t) for t in to_be_altered])
 
         response = self.render("airflow/confirm.html",
                                message=("Here's the list of task instances you are "
-                                        "about to mark as successful:"),
+                                        "about to mark as {}:".format(state)),
                                details=details)
 
         return response
 
+    @expose('/failed')
+    @login_required
+    @wwwutils.action_logging
+    @wwwutils.notify_owner
+    def failed(self):
+        dag_id = request.args.get('dag_id')
+        task_id = request.args.get('task_id')
+        origin = request.args.get('origin')
+        execution_date = request.args.get('execution_date')
+
+        confirmed = request.args.get('confirmed') == "true"
+        upstream = request.args.get('upstream') == "true"
+        downstream = request.args.get('downstream') == "true"
+        future = request.args.get('future') == "true"
+        past = request.args.get('past') == "true"
+
+        return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
+                                              confirmed, upstream, downstream,
+                                              future, past, State.FAILED)
+
+    @expose('/success')
+    @login_required
+    @wwwutils.action_logging
+    @wwwutils.notify_owner
+    def success(self):
+        dag_id = request.args.get('dag_id')
+        task_id = request.args.get('task_id')
+        origin = request.args.get('origin')
+        execution_date = request.args.get('execution_date')
+
+        confirmed = request.args.get('confirmed') == "true"
+        upstream = request.args.get('upstream') == "true"
+        downstream = request.args.get('downstream') == "true"
+        future = request.args.get('future') == "true"
+        past = request.args.get('past') == "true"
+
+        return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
+                                              confirmed, upstream, downstream,
+                                              future, past, State.SUCCESS)
+
     @expose('/tree')
     @login_required
     @wwwutils.gzipped
@@ -2639,40 +2702,107 @@ def action_new_delete(self, ids, session=None):
         models.DagStat.update(dirty_ids, dirty_only=False, session=session)
 
     @action('set_running', "Set state to 'running'", None)
-    def action_set_running(self, ids):
-        self.set_dagrun_state(ids, State.RUNNING)
-
-    @action('set_failed', "Set state to 'failed'", None)
-    def action_set_failed(self, ids):
-        self.set_dagrun_state(ids, State.FAILED)
+    @provide_session
+    def action_set_running(self, ids, session=None):
+        try:
+            DR = models.DagRun
+            count = 0
+            dirty_ids = []
+            for dr in session.query(DR).filter(DR.id.in_(ids)).all():
+                dirty_ids.append(dr.dag_id)
+                count += 1
+                dr.state = State.RUNNING
+                dr.start_date = timezone.utcnow()
+            models.DagStat.update(dirty_ids, session=session)
+            flash(
+                "{count} dag runs were set to running".format(**locals()))
+        except Exception as ex:
+            if not self.handle_view_exception(ex):
+                raise Exception("Ooops")
+            flash('Failed to set state', 'error')
 
-    @action('set_success', "Set state to 'success'", None)
-    def action_set_success(self, ids):
-        self.set_dagrun_state(ids, State.SUCCESS)
+    @action('set_failed', "Set state to 'failed'",
+            "All running task instances would also be marked as failed, are you sure?")
+    @provide_session
+    def action_set_failed(self, ids, session=None):
+        try:
+            DR = models.DagRun
+            count = 0
+            dirty_ids = []
+            altered_tis = []
+            for dr in session.query(DR).filter(DR.id.in_(ids)).all():
+                dirty_ids.append(dr.dag_id)
+                count += 1
+                altered_tis += \
+                    set_dag_run_state_to_failed(dagbag.get_dag(dr.dag_id),
+                                                dr.execution_date,
+                                                commit=True,
+                                                session=session)
+            models.DagStat.update(dirty_ids, session=session)
+            altered_ti_count = len(altered_tis)
+            flash(
+                "{count} dag runs and {altered_ti_count} task instances "
+                "were set to failed".format(**locals()))
+        except Exception as ex:
+            if not self.handle_view_exception(ex):
+                raise Exception("Ooops")
+            flash('Failed to set state', 'error')
 
+    @action('set_success', "Set state to 'success'",
+            "All task instances would also be marked as success, are you sure?")
     @provide_session
-    def set_dagrun_state(self, ids, target_state, session=None):
+    def action_set_success(self, ids, session=None):
         try:
             DR = models.DagRun
             count = 0
             dirty_ids = []
+            altered_tis = []
             for dr in session.query(DR).filter(DR.id.in_(ids)).all():
                 dirty_ids.append(dr.dag_id)
                 count += 1
-                dr.state = target_state
-                if target_state == State.RUNNING:
-                    dr.start_date = timezone.utcnow()
-                else:
-                    dr.end_date = timezone.utcnow()
-            session.commit()
+                altered_tis += \
+                    set_dag_run_state_to_success(dagbag.get_dag(dr.dag_id),
+                                                 dr.execution_date,
+                                                 commit=True,
+                                                 session=session)
             models.DagStat.update(dirty_ids, session=session)
+            altered_ti_count = len(altered_tis)
             flash(
-                "{count} dag runs were set to '{target_state}'".format(**locals()))
+                "{count} dag runs and {altered_ti_count} task instances "
+                "were set to success".format(**locals()))
         except Exception as ex:
             if not self.handle_view_exception(ex):
                 raise Exception("Ooops")
             flash('Failed to set state', 'error')
 
+    # Called after editing DagRun model in the UI.
+    @provide_session
+    def after_model_change(self, form, dagrun, is_created, session=None):
+        altered_tis = []
+        if dagrun.state == State.SUCCESS:
+            altered_tis = set_dag_run_state_to_success(
+                dagbag.get_dag(dagrun.dag_id),
+                dagrun.execution_date,
+                commit=True)
+        elif dagrun.state == State.FAILED:
+            altered_tis = set_dag_run_state_to_failed(
+                dagbag.get_dag(dagrun.dag_id),
+                dagrun.execution_date,
+                commit=True,
+                session=session)
+        elif dagrun.state == State.RUNNING:
+            altered_tis = set_dag_run_state_to_running(
+                dagbag.get_dag(dagrun.dag_id),
+                dagrun.execution_date,
+                commit=True,
+                session=session)
+
+        altered_ti_count = len(altered_tis)
+        models.DagStat.update([dagrun.dag_id], session=session)
+        flash(
+            "1 dag run and {altered_ti_count} task instances "
+            "were set to '{dagrun.state}'".format(**locals()))
+
 
 class LogModelView(ModelViewOnly):
     verbose_name_plural = "logs"
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 7073d1795c29a..83bde73311dbf 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -195,6 +195,24 @@ <h4 class="modal-title" id="myModalLabel">
             </button>
           </span>
           <hr/>
+          <button id="btn_failed" type="button" class="btn btn-primary">
+            Mark Failed
+          </button>
+          <span class="btn-group">
+            <button id="btn_failed_past"
+              type="button" class="btn" data-toggle="button">Past</button>
+            <button id="btn_failed_future"
+              type="button" class="btn" data-toggle="button">
+              Future
+            </button>
+            <button id="btn_failed_upstream"
+              type="button" class="btn" data-toggle="button">Upstream</button>
+            <button id="btn_failed_downstream"
+              type="button" class="btn" data-toggle="button">
+              Downstream
+            </button>
+          </span>
+          <hr/>
           <button id="btn_success" type="button" class="btn btn-primary">
             Mark Success
           </button>
@@ -239,6 +257,9 @@ <h4 class="modal-title" id="dagModalLabel">
           <button id="btn_dagrun_clear" type="button" class="btn btn-primary">
             Clear
           </button>
+          <button id="btn_dagrun_failed" type="button" class="btn btn-primary">
+            Mark Failed
+          </button>
           <button id="btn_dagrun_success" type="button" class="btn btn-primary">
             Mark Success
           </button>
@@ -386,6 +407,20 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
+    $("#btn_failed").click(function(){
+      url = "{{ url_for('Airflow.failed') }}" +
+        "?task_id=" + encodeURIComponent(task_id) +
+        "&dag_id=" + encodeURIComponent(dag_id) +
+        "&upstream=" + $('#btn_failed_upstream').hasClass('active') +
+        "&downstream=" + $('#btn_failed_downstream').hasClass('active') +
+        "&future=" + $('#btn_failed_future').hasClass('active') +
+        "&past=" + $('#btn_failed_past').hasClass('active') +
+        "&execution_date=" + encodeURIComponent(execution_date) +
+        "&origin=" + encodeURIComponent(window.location);
+
+      window.location = url;
+    });
+
     $("#btn_success").click(function(){
       url = "{{ url_for('Airflow.success') }}" +
         "?task_id=" + encodeURIComponent(task_id) +
@@ -400,6 +435,14 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
+    $('#btn_dagrun_failed').click(function(){
+      url = "{{ url_for('Airflow.dagrun_failed') }}" +
+        "?dag_id=" + encodeURIComponent(dag_id) +
+        "&execution_date=" + encodeURIComponent(execution_date) +
+        "&origin=" + encodeURIComponent(window.location);
+      window.location = url;
+    });
+
     $('#btn_dagrun_success').click(function(){
       url = "{{ url_for('Airflow.dagrun_success') }}" +
         "?dag_id=" + encodeURIComponent(dag_id) +
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 163377d8e9176..45efc16c49a8f 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -18,55 +18,49 @@
 # under the License.
 #
 
-from past.builtins import unicode
-
+import copy
+import itertools
+import json
 import logging
+import math
 import os
 import socket
-from datetime import timedelta
-import itertools
-import copy
-import math
-import json
-from collections import defaultdict
 import traceback
+from collections import defaultdict
+from datetime import timedelta
+
 import markdown
 import nvd3
 import pendulum
-
 import sqlalchemy as sqla
-from sqlalchemy import or_, desc, and_, union_all
-
 from flask import (
     g, redirect, request, Markup, Response, render_template,
     make_response, flash, jsonify)
 from flask._compat import PY2
-
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
+from flask_appbuilder.models.sqla.interface import SQLAInterface
 from flask_babel import lazy_gettext
-
-from wtforms import Form, SelectField, validators
-
+from past.builtins import unicode
 from pygments import highlight, lexers
 from pygments.formatters import HtmlFormatter
+from sqlalchemy import or_, desc, and_, union_all
+from wtforms import SelectField, validators
 
 import airflow
 from airflow import configuration as conf
 from airflow import models, jobs
 from airflow import settings
-from airflow.api.common.experimental.mark_tasks import set_dag_run_state
+from airflow.api.common.experimental.mark_tasks import (set_dag_run_state_to_success,
+                                                        set_dag_run_state_to_failed)
 from airflow.models import XCom, DagRun
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
-
 from airflow.utils import timezone
-from airflow.utils.json import json_ser
-from airflow.utils.state import State
+from airflow.utils.dates import infer_time_unit, scale_time_units
 from airflow.utils.db import provide_session
 from airflow.utils.helpers import alchemy_to_dict
-from airflow.utils.dates import infer_time_unit, scale_time_units
-
-
+from airflow.utils.json import json_ser
+from airflow.utils.state import State
 from airflow.www_rbac import utils as wwwutils
 from airflow.www_rbac.app import app
 from airflow.www_rbac.decorators import action_logging, gzipped
@@ -892,15 +886,35 @@ def blocked(self, session=None):
             })
         return wwwutils.json_response(payload)
 
-    @expose('/dagrun_success')
-    @has_access
-    @action_logging
-    def dagrun_success(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+    def _mark_dagrun_state_as_failed(self, dag_id, execution_date, confirmed, origin):
+        if not execution_date:
+            flash('Invalid execution date', 'error')
+            return redirect(origin)
+
+        execution_date = pendulum.parse(execution_date)
+        dag = dagbag.get_dag(dag_id)
+
+        if not dag:
+            flash('Cannot find DAG: {}'.format(dag_id), 'error')
+            return redirect(origin)
+
+        new_dag_state = set_dag_run_state_to_failed(dag, execution_date, commit=confirmed)
+
+        if confirmed:
+            flash('Marked failed on {} task instances'.format(len(new_dag_state)))
+            return redirect(origin)
+
+        else:
+            details = '\n'.join([str(t) for t in new_dag_state])
 
+            response = self.render('airflow/confirm.html',
+                                   message=("Here's the list of task instances you are "
+                                            "about to mark as failed"),
+                                   details=details)
+
+            return response
+
+    def _mark_dagrun_state_as_success(self, dag_id, execution_date, confirmed, origin):
         if not execution_date:
             flash('Invalid execution date', 'error')
             return redirect(origin)
@@ -912,8 +926,8 @@ def dagrun_success(self):
             flash('Cannot find DAG: {}'.format(dag_id), 'error')
             return redirect(origin)
 
-        new_dag_state = set_dag_run_state(dag, execution_date, state=State.SUCCESS,
-                                          commit=confirmed)
+        new_dag_state = set_dag_run_state_to_success(dag, execution_date,
+                                                     commit=confirmed)
 
         if confirmed:
             flash('Marked success on {} task instances'.format(len(new_dag_state)))
@@ -924,29 +938,41 @@ def dagrun_success(self):
 
             response = self.render('airflow/confirm.html',
                                    message=("Here's the list of task instances you are "
-                                            "about to mark as successful:"),
+                                            "about to mark as success"),
                                    details=details)
 
             return response
 
-    @expose('/success')
+    @expose('/dagrun_failed')
     @has_access
     @action_logging
-    def success(self):
+    def dagrun_failed(self):
         dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
+        execution_date = request.args.get('execution_date')
+        confirmed = request.args.get('confirmed') == 'true'
+        origin = request.args.get('origin')
+        return self._mark_dagrun_state_as_failed(dag_id, execution_date,
+                                                 confirmed, origin)
+
+    @expose('/dagrun_success')
+    @has_access
+    @action_logging
+    def dagrun_success(self):
+        dag_id = request.args.get('dag_id')
+        execution_date = request.args.get('execution_date')
+        confirmed = request.args.get('confirmed') == 'true'
         origin = request.args.get('origin')
+        return self._mark_dagrun_state_as_success(dag_id, execution_date,
+                                                  confirmed, origin)
+
+    def _mark_task_instance_state(self, dag_id, task_id, origin, execution_date,
+                                  confirmed, upstream, downstream,
+                                  future, past, state):
         dag = dagbag.get_dag(dag_id)
         task = dag.get_task(task_id)
         task.dag = dag
 
-        execution_date = request.args.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
 
         if not dag:
             flash("Cannot find DAG: {}".format(dag_id))
@@ -961,26 +987,64 @@ def success(self):
         if confirmed:
             altered = set_state(task=task, execution_date=execution_date,
                                 upstream=upstream, downstream=downstream,
-                                future=future, past=past, state=State.SUCCESS,
+                                future=future, past=past, state=state,
                                 commit=True)
 
-            flash("Marked success on {} task instances".format(len(altered)))
+            flash("Marked {} on {} task instances".format(state, len(altered)))
             return redirect(origin)
 
         to_be_altered = set_state(task=task, execution_date=execution_date,
                                   upstream=upstream, downstream=downstream,
-                                  future=future, past=past, state=State.SUCCESS,
+                                  future=future, past=past, state=state,
                                   commit=False)
 
         details = "\n".join([str(t) for t in to_be_altered])
 
         response = self.render("airflow/confirm.html",
                                message=("Here's the list of task instances you are "
-                                        "about to mark as successful:"),
+                                        "about to mark as {}:".format(state)),
                                details=details)
 
         return response
 
+    @expose('/failed')
+    @has_access
+    @action_logging
+    def failed(self):
+        dag_id = request.args.get('dag_id')
+        task_id = request.args.get('task_id')
+        origin = request.args.get('origin')
+        execution_date = request.args.get('execution_date')
+
+        confirmed = request.args.get('confirmed') == "true"
+        upstream = request.args.get('upstream') == "true"
+        downstream = request.args.get('downstream') == "true"
+        future = request.args.get('future') == "true"
+        past = request.args.get('past') == "true"
+
+        return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
+                                              confirmed, upstream, downstream,
+                                              future, past, State.FAILED)
+
+    @expose('/success')
+    @has_access
+    @action_logging
+    def success(self):
+        dag_id = request.args.get('dag_id')
+        task_id = request.args.get('task_id')
+        origin = request.args.get('origin')
+        execution_date = request.args.get('execution_date')
+
+        confirmed = request.args.get('confirmed') == "true"
+        upstream = request.args.get('upstream') == "true"
+        downstream = request.args.get('downstream') == "true"
+        future = request.args.get('future') == "true"
+        past = request.args.get('past') == "true"
+
+        return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
+                                              confirmed, upstream, downstream,
+                                              future, past, State.SUCCESS)
+
     @expose('/tree')
     @has_access
     @gzipped
@@ -2005,43 +2069,86 @@ class DagRunModelView(AirflowModelView):
     def action_muldelete(self, items, session=None):
         self.datamodel.delete_all(items)
         self.update_redirect()
-        return redirect(self.get_redirect())
         dirty_ids = []
         for item in items:
             dirty_ids.append(item.dag_id)
         models.DagStat.update(dirty_ids, dirty_only=False, session=session)
+        return redirect(self.get_redirect())
 
     @action('set_running', "Set state to 'running'", '', single=False)
-    def action_set_running(self, drs):
-        return self.set_dagrun_state(drs, State.RUNNING)
-
-    @action('set_failed', "Set state to 'failed'", '', single=False)
-    def action_set_failed(self, drs):
-        return self.set_dagrun_state(drs, State.FAILED)
+    @provide_session
+    def action_set_running(self, drs, session=None):
+        try:
+            DR = models.DagRun
+            count = 0
+            dirty_ids = []
+            for dr in session.query(DR).filter(
+                    DR.id.in_([dagrun.id for dagrun in drs])).all():
+                dirty_ids.append(dr.dag_id)
+                count += 1
+                dr.start_date = timezone.utcnow()
+                dr.state = State.RUNNING
+            models.DagStat.update(dirty_ids, session=session)
+            session.commit()
+            flash(
+                "{count} dag runs were set to running".format(**locals()))
+        except Exception as ex:
+            flash(str(ex))
+            flash('Failed to set state', 'error')
+        return redirect(self.route_base + '/list')
 
-    @action('set_success', "Set state to 'success'", '', single=False)
-    def action_set_success(self, drs):
-        return self.set_dagrun_state(drs, State.SUCCESS)
+    @action('set_failed', "Set state to 'failed'",
+            "All running task instances would also be marked as failed, are you sure?",
+            single=False)
+    @provide_session
+    def action_set_failed(self, drs, session=None):
+        try:
+            DR = models.DagRun
+            count = 0
+            dirty_ids = []
+            altered_tis = []
+            for dr in session.query(DR).filter(
+                    DR.id.in_([dagrun.id for dagrun in drs])).all():
+                dirty_ids.append(dr.dag_id)
+                count += 1
+                altered_tis += \
+                    set_dag_run_state_to_failed(dagbag.get_dag(dr.dag_id),
+                                                dr.execution_date,
+                                                commit=True,
+                                                session=session)
+            models.DagStat.update(dirty_ids, session=session)
+            altered_ti_count = len(altered_tis)
+            flash(
+                "{count} dag runs and {altered_ti_count} task instances "
+                "were set to failed".format(**locals()))
+        except Exception as ex:
+            flash('Failed to set state', 'error')
+        return redirect(self.route_base + '/list')
 
+    @action('set_success', "Set state to 'success'",
+            "All task instances would also be marked as success, are you sure?",
+            single=False)
     @provide_session
-    def set_dagrun_state(self, drs, target_state, session=None):
+    def action_set_success(self, drs, session=None):
         try:
             DR = models.DagRun
             count = 0
             dirty_ids = []
+            altered_tis = []
             for dr in session.query(DR).filter(
                     DR.id.in_([dagrun.id for dagrun in drs])).all():
                 dirty_ids.append(dr.dag_id)
                 count += 1
-                dr.state = target_state
-                if target_state == State.RUNNING:
-                    dr.start_date = timezone.utcnow()
-                else:
-                    dr.end_date = timezone.utcnow()
-            session.commit()
+                altered_tis += \
+                    set_dag_run_state_to_success(dagbag.get_dag(dr.dag_id),
+                                                 dr.execution_date,
+                                                 commit=True,
+                                                 session=session)
             models.DagStat.update(dirty_ids, session=session)
+            altered_ti_count = len(altered_tis)
             flash(
-                "{count} dag runs were set to '{target_state}'".format(**locals()))
+                "{count} dag runs and {altered_ti_count} task instances "
+                "were set to success".format(**locals()))
         except Exception as ex:
             flash('Failed to set state', 'error')
         return redirect(self.route_base + '/list')
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index e30cd05a7e1d2..8c7d435b32440 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -178,6 +178,7 @@ Here are some of the ways you can **unblock tasks**:
   states (``failed``, or ``success``)
 * Clearing a task instance will no longer delete the task instance record. Instead it updates
   max_tries and set the current task instance state to be None.
+* Marking task instances as failed can be done through the UI. This can be used to stop running task instances.
 * Marking task instances as successful can be done through the UI. This is mostly to fix false negatives,
   or for instance when the fix has been applied outside of Airflow.
 * The ``airflow backfill`` CLI subcommand has a flag to ``--mark_success`` and allows selecting
diff --git a/tests/api/common/experimental/mark_tasks.py b/tests/api/common/experimental/mark_tasks.py
index 3ad50539c49ac..181d10d8a166f 100644
--- a/tests/api/common/experimental/mark_tasks.py
+++ b/tests/api/common/experimental/mark_tasks.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,14 +18,16 @@
 # under the License.
 
 import unittest
+from datetime import datetime
 
 from airflow import models
 from airflow.api.common.experimental.mark_tasks import (
-    set_state, _create_dagruns, set_dag_run_state)
+    set_state, _create_dagruns, set_dag_run_state_to_success, set_dag_run_state_to_failed,
+    set_dag_run_state_to_running)
 from airflow.settings import Session
+from airflow.utils import timezone
 from airflow.utils.dates import days_ago
 from airflow.utils.state import State
-from datetime import datetime, timedelta
 
 DEV_NULL = "/dev/null"
 
@@ -223,115 +225,183 @@ def setUp(self):
 
         self.session = Session()
 
-    def verify_dag_run_states(self, dag, date, state=State.SUCCESS):
-        drs = models.DagRun.find(dag_id=dag.dag_id, execution_date=date)
-        dr = drs[0]
-        self.assertEqual(dr.get_state(), state)
-        tis = dr.get_task_instances(session=self.session)
+    def _set_default_task_instance_states(self, dr):
+        if dr.dag_id != 'test_example_bash_operator':
+            return
+        # success task
+        dr.get_task_instance('runme_0').set_state(State.SUCCESS, self.session)
+        # skipped task
+        dr.get_task_instance('runme_1').set_state(State.SKIPPED, self.session)
+        # retry task
+        dr.get_task_instance('runme_2').set_state(State.UP_FOR_RETRY, self.session)
+        # queued task
+        dr.get_task_instance('also_run_this').set_state(State.QUEUED, self.session)
+        # running task
+        dr.get_task_instance('run_after_loop').set_state(State.RUNNING, self.session)
+        # failed task
+        dr.get_task_instance('run_this_last').set_state(State.FAILED, self.session)
+
+    def _verify_task_instance_states_remain_default(self, dr):
+        self.assertEqual(dr.get_task_instance('runme_0').state, State.SUCCESS)
+        self.assertEqual(dr.get_task_instance('runme_1').state, State.SKIPPED)
+        self.assertEqual(dr.get_task_instance('runme_2').state, State.UP_FOR_RETRY)
+        self.assertEqual(dr.get_task_instance('also_run_this').state, State.QUEUED, )
+        self.assertEqual(dr.get_task_instance('run_after_loop').state, State.RUNNING)
+        self.assertEqual(dr.get_task_instance('run_this_last').state, State.FAILED)
+
+    def _verify_task_instance_states(self, dag, date, state):
+        TI = models.TaskInstance
+        tis = self.session.query(TI).filter(TI.dag_id == dag.dag_id,
+                                            TI.execution_date == date)
         for ti in tis:
             self.assertEqual(ti.state, state)
 
-    def test_set_running_dag_run_state(self):
-        date = self.execution_dates[0]
-        dr = self.dag1.create_dagrun(
+    def _create_test_dag_run(self, state, date):
+        return self.dag1.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
-            state=State.RUNNING,
+            state=state,
             execution_date=date,
             session=self.session
         )
-        for ti in dr.get_task_instances(session=self.session):
-            ti.set_state(State.RUNNING, self.session)
 
-        altered = set_dag_run_state(self.dag1, date, state=State.SUCCESS, commit=True)
+    def _verify_dag_run_state(self, dag, date, state):
+        drs = models.DagRun.find(dag_id=dag.dag_id, execution_date=date)
+        dr = drs[0]
+        self.assertEqual(dr.get_state(), state)
+
+    def test_set_running_dag_run_to_success(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.RUNNING, date)
+        self._set_default_task_instance_states(dr)
+
+        altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
 
-        # All of the task should be altered
-        self.assertEqual(len(altered), len(self.dag1.tasks))
-        self.verify_dag_run_states(self.dag1, date)
+        # All except the SUCCESS task should be altered.
+        self.assertEqual(len(altered), 5)
+        self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
+        self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
 
-    def test_set_success_dag_run_state(self):
+    def test_set_running_dag_run_to_failed(self):
         date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.RUNNING, date)
+        self._set_default_task_instance_states(dr)
 
-        dr = self.dag1.create_dagrun(
-            run_id='manual__' + datetime.now().isoformat(),
-            state=State.SUCCESS,
-            execution_date=date,
-            session=self.session
-        )
-        for ti in dr.get_task_instances(session=self.session):
-            ti.set_state(State.SUCCESS, self.session)
+        altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
 
-        altered = set_dag_run_state(self.dag1, date, state=State.SUCCESS, commit=True)
+        # Only running task should be altered.
+        self.assertEqual(len(altered), 1)
+        self._verify_dag_run_state(self.dag1, date, State.FAILED)
+        self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+
+    def test_set_running_dag_run_to_running(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.RUNNING, date)
+        self._set_default_task_instance_states(dr)
 
-        # None of the task should be altered
+        altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
+
+        # None of the tasks should be altered.
         self.assertEqual(len(altered), 0)
-        self.verify_dag_run_states(self.dag1, date)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
 
-    def test_set_failed_dag_run_state(self):
+    def test_set_success_dag_run_to_success(self):
         date = self.execution_dates[0]
-        dr = self.dag1.create_dagrun(
-            run_id='manual__' + datetime.now().isoformat(),
-            state=State.FAILED,
-            execution_date=date,
-            session=self.session
-        )
-        dr.get_task_instance('runme_0').set_state(State.FAILED, self.session)
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
 
-        altered = set_dag_run_state(self.dag1, date, state=State.SUCCESS, commit=True)
+        altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
 
-        # All of the task should be altered
-        self.assertEqual(len(altered), len(self.dag1.tasks))
-        self.verify_dag_run_states(self.dag1, date)
+        # All except the SUCCESS task should be altered.
+        self.assertEqual(len(altered), 5)
+        self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
+        self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
 
-    def test_set_mixed_dag_run_state(self):
-        """
-        This test checks function set_dag_run_state with mixed task instance
-        state.
-        """
+    def test_set_success_dag_run_to_failed(self):
         date = self.execution_dates[0]
-        dr = self.dag1.create_dagrun(
-            run_id='manual__' + datetime.now().isoformat(),
-            state=State.FAILED,
-            execution_date=date,
-            session=self.session
-        )
-        # success task
-        dr.get_task_instance('runme_0').set_state(State.SUCCESS, self.session)
-        # skipped task
-        dr.get_task_instance('runme_1').set_state(State.SKIPPED, self.session)
-        # retry task
-        dr.get_task_instance('runme_2').set_state(State.UP_FOR_RETRY, self.session)
-        # queued task
-        dr.get_task_instance('also_run_this').set_state(State.QUEUED, self.session)
-        # running task
-        dr.get_task_instance('run_after_loop').set_state(State.RUNNING, self.session)
-        # failed task
-        dr.get_task_instance('run_this_last').set_state(State.FAILED, self.session)
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
 
-        altered = set_dag_run_state(self.dag1, date, state=State.SUCCESS, commit=True)
+        altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
 
-        self.assertEqual(len(altered), len(self.dag1.tasks) - 1) # only 1 task succeeded
-        self.verify_dag_run_states(self.dag1, date)
+        # Only running task should be altered.
+        self.assertEqual(len(altered), 1)
+        self._verify_dag_run_state(self.dag1, date, State.FAILED)
+        self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+
+    def test_set_success_dag_run_to_running(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
+
+        altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
+
+        # None of the tasks should be altered.
+        self.assertEqual(len(altered), 0)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
+
+    def test_set_failed_dag_run_to_success(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
+
+        altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
+
+        # All except the SUCCESS task should be altered.
+        self.assertEqual(len(altered), 5)
+        self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
+        self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
+
+    def test_set_failed_dag_run_to_failed(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
+
+        altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
+
+        # Only running task should be altered.
+        self.assertEqual(len(altered), 1)
+        self._verify_dag_run_state(self.dag1, date, State.FAILED)
+        self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+
+    def test_set_failed_dag_run_to_running(self):
+        date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.SUCCESS, date)
+        self._set_default_task_instance_states(dr)
+
+        altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
+
+        # None of the tasks should be altered.
+        self.assertEqual(len(altered), 0)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
 
     def test_set_state_without_commit(self):
         date = self.execution_dates[0]
+        dr = self._create_test_dag_run(State.RUNNING, date)
+        self._set_default_task_instance_states(dr)
 
-        # Running dag run and task instances
-        dr = self.dag1.create_dagrun(
-            run_id='manual__' + datetime.now().isoformat(),
-            state=State.RUNNING,
-            execution_date=date,
-            session=self.session
-        )
-        for ti in dr.get_task_instances(session=self.session):
-            ti.set_state(State.RUNNING, self.session)
+        will_be_altered = set_dag_run_state_to_running(self.dag1, date, commit=False)
 
-        altered = set_dag_run_state(self.dag1, date, state=State.SUCCESS, commit=False)
+        # None of the tasks will be altered.
+        self.assertEqual(len(will_be_altered), 0)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
 
-        # All of the task should be altered
-        self.assertEqual(len(altered), len(self.dag1.tasks))
+        will_be_altered = set_dag_run_state_to_failed(self.dag1, date, commit=False)
 
-        # Both dag run and task instances' states should remain the same
-        self.verify_dag_run_states(self.dag1, date, State.RUNNING)
+        # Only the running task will be altered.
+        self.assertEqual(len(will_be_altered), 1)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
+
+        will_be_altered = set_dag_run_state_to_success(self.dag1, date, commit=False)
+
+        # All except the SUCCESS task should be altered.
+        self.assertEqual(len(will_be_altered), 5)
+        self._verify_dag_run_state(self.dag1, date, State.RUNNING)
+        self._verify_task_instance_states_remain_default(dr)
 
     def test_set_state_with_multiple_dagruns(self):
         dr1 = self.dag2.create_dagrun(
@@ -353,8 +423,8 @@ def test_set_state_with_multiple_dagruns(self):
             session=self.session
         )
 
-        altered = set_dag_run_state(self.dag2, self.execution_dates[1],
-                                state=State.SUCCESS, commit=True)
+        altered = set_dag_run_state_to_success(self.dag2, self.execution_dates[1],
+                                               commit=True)
 
         # Recursively count number of tasks in the dag
         def count_dag_tasks(dag):
@@ -364,29 +434,45 @@ def count_dag_tasks(dag):
             return count
 
         self.assertEqual(len(altered), count_dag_tasks(self.dag2))
-        self.verify_dag_run_states(self.dag2, self.execution_dates[1])
+        self._verify_dag_run_state(self.dag2, self.execution_dates[1], State.SUCCESS)
 
         # Make sure other dag status are not changed
-        dr1 = models.DagRun.find(dag_id=self.dag2.dag_id, execution_date=self.execution_dates[0])
+        dr1 = models.DagRun.find(dag_id=self.dag2.dag_id,
+                                 execution_date=self.execution_dates[0])
         dr1 = dr1[0]
-        self.assertEqual(dr1.get_state(), State.FAILED)
-        dr3 = models.DagRun.find(dag_id=self.dag2.dag_id, execution_date=self.execution_dates[2])
+        self._verify_dag_run_state(self.dag2, self.execution_dates[0], State.FAILED)
+        dr3 = models.DagRun.find(dag_id=self.dag2.dag_id,
+                                 execution_date=self.execution_dates[2])
         dr3 = dr3[0]
-        self.assertEqual(dr3.get_state(), State.RUNNING)
+        self._verify_dag_run_state(self.dag2, self.execution_dates[2], State.RUNNING)
 
     def test_set_dag_run_state_edge_cases(self):
         # Dag does not exist
-        altered = set_dag_run_state(None, self.execution_dates[0])
+        altered = set_dag_run_state_to_success(None, self.execution_dates[0])
+        self.assertEqual(len(altered), 0)
+        altered = set_dag_run_state_to_failed(None, self.execution_dates[0])
+        self.assertEqual(len(altered), 0)
+        altered = set_dag_run_state_to_running(None, self.execution_dates[0])
         self.assertEqual(len(altered), 0)
 
         # Invalid execution date
-        altered = set_dag_run_state(self.dag1, None)
+        altered = set_dag_run_state_to_success(self.dag1, None)
+        self.assertEqual(len(altered), 0)
+        altered = set_dag_run_state_to_failed(self.dag1, None)
+        self.assertEqual(len(altered), 0)
+        altered = set_dag_run_state_to_running(self.dag1, None)
         self.assertEqual(len(altered), 0)
-        self.assertRaises(AssertionError, set_dag_run_state, self.dag1, timedelta(microseconds=-1))
 
+        # This will throw AssertionError since dag.latest_execution_date
+        # need to be 0 does not exist.
+        self.assertRaises(AssertionError, set_dag_run_state_to_success, self.dag1,
+                          timezone.make_naive(self.execution_dates[0]))
+
+        # altered = set_dag_run_state_to_success(self.dag1, self.execution_dates[0])
         # DagRun does not exist
         # This will throw AssertionError since dag.latest_execution_date does not exist
-        self.assertRaises(AssertionError, set_dag_run_state, self.dag1, self.execution_dates[0])
+        self.assertRaises(AssertionError, set_dag_run_state_to_success,
+                          self.dag1, self.execution_dates[0])
 
     def tearDown(self):
         self.dag1.clear()
@@ -397,5 +483,6 @@ def tearDown(self):
         self.session.query(models.DagStat).delete()
         self.session.commit()
 
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/dags/test_example_bash_operator.py b/tests/dags/test_example_bash_operator.py
index 94b89ffa52cd2..f9bd6c78631cb 100644
--- a/tests/dags/test_example_bash_operator.py
+++ b/tests/dags/test_example_bash_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -27,6 +27,7 @@
 
 args = {
     'owner': 'airflow',
+    'retries': 3,
     'start_date': airflow.utils.dates.days_ago(2)
 }
 
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 6e5d9922e1d5d..49272e3090cfb 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -400,8 +400,14 @@ def test_paused(self):
         resp = self.client.post(url, follow_redirects=True)
         self.check_content_in_response('OK', resp)
 
-    def test_success(self):
+    def test_failed(self):
+        url = ('failed?task_id=run_this_last&dag_id=example_bash_operator&'
+               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url)
+        self.check_content_in_response('Wait a minute', resp)
 
+    def test_success(self):
         url = ('success?task_id=run_this_last&dag_id=example_bash_operator&'
                'execution_date={}&upstream=false&downstream=false&future=false&past=false'
                .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))

From acb58f544d537d49755edff34bf568cd046b43bc Mon Sep 17 00:00:00 2001
From: Tao feng <tfeng@lyft.com>
Date: Mon, 16 Jul 2018 13:13:42 -0700
Subject: [PATCH 355/808] [AIRFLOW-2267] Airflow DAG level access (#3197)

---
 UPDATING.md                                   |   8 +
 airflow/bin/cli.py                            |  18 +
 airflow/settings.py                           |   5 +-
 airflow/www/views.py                          |   2 +-
 airflow/www_rbac/app.py                       |  25 +-
 airflow/www_rbac/decorators.py                |  34 +-
 airflow/www_rbac/security.py                  | 393 ++++++++++--
 airflow/www_rbac/views.py                     | 212 +++++--
 tests/core.py                                 |  18 +-
 tests/jobs.py                                 |   6 +-
 tests/models.py                               |   2 +-
 tests/utils/test_db.py                        |   3 +
 tests/www/test_views.py                       |   2 -
 .../api/experimental/test_endpoints.py        |  84 +--
 tests/www_rbac/test_security.py               | 104 +++-
 tests/www_rbac/test_views.py                  | 573 +++++++++++++++---
 16 files changed, 1215 insertions(+), 274 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 036538131280a..6a034fb01b43f 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -116,6 +116,14 @@ dependency (python-nvd3 -> python-slugify -> unidecode).
 
 The method name was changed to be compatible with the Python 3.7 async/await keywords
 
+### DAG level Access Control for new RBAC UI
+
+Extend and enhance new Airflow RBAC UI to support DAG level ACL. Each dag now has two permissions(one for write, one for read) associated('can_dag_edit', 'can_dag_read').
+The admin will create new role, associate the dag permission with the target dag and assign that role to users. That user can only access / view the certain dags on the UI
+that he has permissions on. If a new role wants to access all the dags, the admin could associate dag permissions on an artificial view(``all_dags``) with that role.
+
+We also provide a new cli command(``sync_perm``) to allow admin to auto sync permissions.
+
 ### Setting UTF-8 as default mime_charset in email utils
 
 ### Add a configuration variable(default_dag_run_display_number) to control numbers of dag run for display
diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 86342869f1e27..6cf7ea1f00c65 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1338,6 +1338,9 @@ def create_user(args):
         if password != password_confirmation:
             raise SystemExit('Passwords did not match!')
 
+    if appbuilder.sm.find_user(args.username):
+        print('{} already exist in the db'.format(args.username))
+        return
     user = appbuilder.sm.add_user(args.username, args.firstname, args.lastname,
                                   args.email, role, password)
     if user:
@@ -1398,6 +1401,16 @@ def list_dag_runs(args, dag=None):
         print(record)
 
 
+@cli_utils.action_logging
+def sync_perm(args): # noqa
+    if settings.RBAC:
+        appbuilder = cached_appbuilder()
+        print('Update permission, view-menu for all existing roles')
+        appbuilder.sm.sync_roles()
+    else:
+        print('The sync_perm command only works for rbac UI.')
+
+
 Arg = namedtuple(
     'Arg', ['flags', 'help', 'action', 'default', 'nargs', 'type', 'choices', 'metavar'])
 Arg.__new__.__defaults__ = (None, None, None, None, None, None, None)
@@ -2000,6 +2013,11 @@ class CLIFactory(object):
             'args': ('role', 'username', 'email', 'firstname', 'lastname',
                      'password', 'use_random_password'),
         },
+        {
+            'func': sync_perm,
+            'help': "Update existing role's permissions.",
+            'args': tuple(),
+        }
     )
     subparsers_dict = {sp['func'].__name__: sp for sp in subparsers}
     dag_subparsers = (
diff --git a/airflow/settings.py b/airflow/settings.py
index d98733718aa36..524e4819d8b01 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -190,7 +190,10 @@ def configure_orm(disable_connection_pool=False):
     setup_event_handlers(engine, reconnect_timeout)
 
     Session = scoped_session(
-        sessionmaker(autocommit=False, autoflush=False, bind=engine))
+        sessionmaker(autocommit=False,
+                     autoflush=False,
+                     bind=engine,
+                     expire_on_commit=False))
 
 
 def dispose_orm():
diff --git a/airflow/www/views.py b/airflow/www/views.py
index c10c28586684f..6d74b997d1649 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2559,7 +2559,7 @@ def hidden_field_formatter(view, context, model, name):
     )
     column_list = ('key', 'val', 'is_encrypted',)
     column_filters = ('key', 'val')
-    column_searchable_list = ('key', 'val')
+    column_searchable_list = ('key', 'val', 'is_encrypted',)
     column_default_sort = ('key', False)
     form_widget_args = {
         'is_encrypted': {'disabled': True},
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index ef1a7adad58ef..84e5ca2140f39 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -40,7 +40,7 @@
 
 log = logging.getLogger(__name__)
 
-def create_app(config=None, testing=False, app_name="Airflow"):
+def create_app(config=None, session=None, testing=False, app_name="Airflow"):
     global app, appbuilder
     app = Flask(__name__)
     if conf.getboolean('webserver', 'ENABLE_PROXY_FIX'):
@@ -71,10 +71,20 @@ def create_app(config=None, testing=False, app_name="Airflow"):
     configure_manifest_files(app)
 
     with app.app_context():
+
+        from airflow.www_rbac.security import AirflowSecurityManager
+        security_manager_class = app.config.get('SECURITY_MANAGER_CLASS') or \
+            AirflowSecurityManager
+
+        if not issubclass(security_manager_class, AirflowSecurityManager):
+            raise Exception(
+                """Your CUSTOM_SECURITY_MANAGER must now extend AirflowSecurityManager,
+                 not FAB's security manager.""")
+
         appbuilder = AppBuilder(
             app,
-            db.session,
-            security_manager_class=app.config.get('SECURITY_MANAGER_CLASS'),
+            db.session if not session else session,
+            security_manager_class=security_manager_class,
             base_template='appbuilder/baselayout.html')
 
         def init_views(appbuilder):
@@ -149,12 +159,11 @@ def integrate_plugins():
             # Otherwise, when the name of a view or menu is changed, the framework
             # will add the new Views and Menus names to the backend, but will not
             # delete the old ones.
-            appbuilder.security_cleanup()
 
         init_views(appbuilder)
 
-        from airflow.www_rbac.security import init_roles
-        init_roles(appbuilder)
+        security_manager = appbuilder.sm
+        security_manager.sync_roles()
 
         from airflow.www_rbac.api.experimental import endpoints as e
         # required for testing purposes otherwise the module retains
@@ -187,14 +196,14 @@ def root_app(env, resp):
     return [b'Apache Airflow is not at this location']
 
 
-def cached_app(config=None, testing=False):
+def cached_app(config=None, session=None, testing=False):
     global app, appbuilder
     if not app or not appbuilder:
         base_url = urlparse(conf.get('webserver', 'base_url'))[2]
         if not base_url or base_url == '/':
             base_url = ""
 
-        app, _ = create_app(config, testing)
+        app, _ = create_app(config, session, testing)
         app = DispatcherMiddleware(root_app, {base_url: app})
     return app
 
diff --git a/airflow/www_rbac/decorators.py b/airflow/www_rbac/decorators.py
index 41be4eb4be597..8f962ef8406bb 100644
--- a/airflow/www_rbac/decorators.py
+++ b/airflow/www_rbac/decorators.py
@@ -21,7 +21,7 @@
 import functools
 import pendulum
 from io import BytesIO as IO
-from flask import after_this_request, request, g
+from flask import after_this_request, redirect, request, url_for, g
 from airflow import models, settings
 
 
@@ -91,3 +91,35 @@ def zipper(response):
         return f(*args, **kwargs)
 
     return view_func
+
+
+def has_dag_access(**dag_kwargs):
+    """
+    Decorator to check whether the user has read / write permission on the dag.
+    """
+    def decorator(f):
+        @functools.wraps(f)
+        def wrapper(self, *args, **kwargs):
+            has_access = self.appbuilder.sm.has_access
+            dag_id = request.args.get('dag_id')
+            # if it is false, we need to check whether user has write access on the dag
+            can_dag_edit = dag_kwargs.get('can_dag_edit', False)
+
+            # 1. check whether the user has can_dag_edit permissions on all_dags
+            # 2. if 1 false, check whether the user
+            #    has can_dag_edit permissions on the dag
+            # 3. if 2 false, check whether it is can_dag_read view,
+            #    and whether user has the permissions
+            if (
+                has_access('can_dag_edit', 'all_dags') or
+                has_access('can_dag_edit', dag_id) or (not can_dag_edit and
+                                                       (has_access('can_dag_read',
+                                                                   'all_dags') or
+                                                        has_access('can_dag_read',
+                                                                   dag_id)))):
+                return f(self, *args, **kwargs)
+            else:
+                return redirect(url_for(self.appbuilder.sm.auth_view.
+                                        __class__.__name__ + ".login"))
+        return wrapper
+    return decorator
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 72691565e64be..dc8cd9161af03 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -7,22 +7,30 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+#
 
+import logging
+from flask import g
 from flask_appbuilder.security.sqla import models as sqla_models
+from flask_appbuilder.security.sqla.manager import SecurityManager
+from sqlalchemy import or_
+
+from airflow import models, settings
+from airflow.www_rbac.app import appbuilder
 
 ###########################################################################
 #                               VIEW MENUS
 ###########################################################################
-viewer_vms = [
+viewer_vms = {
     'Airflow',
     'DagModelView',
     'Browse',
@@ -42,11 +50,11 @@
     'About',
     'Version',
     'VersionView',
-]
+}
 
 user_vms = viewer_vms
 
-op_vms = [
+op_vms = {
     'Admin',
     'Configurations',
     'ConfigurationView',
@@ -58,13 +66,13 @@
     'VariableModelView',
     'XComs',
     'XComModelView',
-]
+}
 
 ###########################################################################
 #                               PERMISSIONS
 ###########################################################################
 
-viewer_perms = [
+viewer_perms = {
     'menu_access',
     'can_index',
     'can_list',
@@ -89,9 +97,9 @@
     'can_rendered',
     'can_pickle_info',
     'can_version',
-]
+}
 
-user_perms = [
+user_perms = {
     'can_dagrun_clear',
     'can_run',
     'can_trigger',
@@ -107,12 +115,22 @@
     'set_success',
     'clear',
     'can_clear',
-]
+}
 
-op_perms = [
+op_perms = {
     'can_conf',
     'can_varimport',
-]
+}
+
+# global view-menu for dag-level access
+dag_vms = {
+    'all_dags'
+}
+
+dag_perms = {
+    'can_dag_read',
+    'can_dag_edit',
+}
 
 ###########################################################################
 #                     DEFAULT ROLE CONFIGURATIONS
@@ -122,60 +140,317 @@
     {
         'role': 'Viewer',
         'perms': viewer_perms,
-        'vms': viewer_vms,
+        'vms': viewer_vms | dag_vms
     },
     {
         'role': 'User',
-        'perms': viewer_perms + user_perms,
-        'vms': viewer_vms + user_vms,
+        'perms': viewer_perms | user_perms | dag_perms,
+        'vms': viewer_vms | dag_vms | user_vms,
     },
     {
         'role': 'Op',
-        'perms': viewer_perms + user_perms + op_perms,
-        'vms': viewer_vms + user_vms + op_vms,
+        'perms': viewer_perms | user_perms | op_perms | dag_perms,
+        'vms': viewer_vms | dag_vms | user_vms | op_vms,
     },
 ]
 
+EXISTING_ROLES = {
+    'Admin',
+    'Viewer',
+    'User',
+    'Op',
+    'Public',
+}
+
+
+class AirflowSecurityManager(SecurityManager):
+
+    def init_role(self, role_name, role_vms, role_perms):
+        """
+        Initialize the role with the permissions and related view-menus.
+
+        :param role_name:
+        :param role_vms:
+        :param role_perms:
+        :return:
+        """
+        pvms = self.get_session.query(sqla_models.PermissionView).all()
+        pvms = [p for p in pvms if p.permission and p.view_menu]
+
+        role = self.find_role(role_name)
+        if not role:
+            role = self.add_role(role_name)
+
+        role_pvms = []
+        for pvm in pvms:
+            if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
+                role_pvms.append(pvm)
+        role.permissions = list(set(role_pvms))
+        self.get_session.merge(role)
+        self.get_session.commit()
+
+    def get_user_roles(self, user=None):
+        """
+        Get all the roles associated with the user.
+        """
+        if user is None:
+            user = g.user
+        if user.is_anonymous():
+            public_role = appbuilder.config.get('AUTH_ROLE_PUBLIC')
+            return [appbuilder.security_manager.find_role(public_role)] \
+                if public_role else []
+        return user.roles
+
+    def get_all_permissions_views(self):
+        """
+        Returns a set of tuples with the perm name and view menu name
+        """
+        perms_views = set()
+        for role in self.get_user_roles():
+            for perm_view in role.permissions:
+                perms_views.add((perm_view.permission.name, perm_view.view_menu.name))
+        return perms_views
+
+    def get_accessible_dag_ids(self, username=None):
+        """
+        Return a set of dags that user has access to(either read or write).
+
+        :param username: Name of the user.
+        :return: A set of dag ids that the user could access.
+        """
+        if not username:
+            username = g.user
+
+        if username.is_anonymous() or 'Public' in username.roles:
+            # return an empty list if the role is public
+            return set()
+
+        roles = {role.name for role in username.roles}
+        if {'Admin', 'Viewer', 'User', 'Op'} & roles:
+            return dag_vms
+
+        user_perms_views = self.get_all_permissions_views()
+        # return all dags that the user could access
+        return set([view for perm, view in user_perms_views if perm in dag_perms])
+
+    def has_access(self, permission, view_name, user=None):
+        """
+        Verify whether a given user could perform certain permission
+        (e.g can_read, can_write) on the given dag_id.
+
+        :param str permission: permission on dag_id(e.g can_read, can_edit).
+        :param str view_name: name of view-menu(e.g dag id is a view-menu as well).
+        :param str user: user name
+        :return: a bool whether user could perform certain permission on the dag_id.
+        """
+        if not user:
+            user = g.user
+        if user.is_anonymous():
+            return self.is_item_public(permission, view_name)
+        return self._has_view_access(user, permission, view_name)
+
+    def _get_and_cache_perms(self):
+        """
+        Cache permissions-views
+        """
+        self.perms = self.get_all_permissions_views()
+
+    def _has_role(self, role_name_or_list):
+        """
+        Whether the user has this role name
+        """
+        if not isinstance(role_name_or_list, list):
+            role_name_or_list = [role_name_or_list]
+        return any(
+            [r.name in role_name_or_list for r in self.get_user_roles()])
+
+    def _has_perm(self, permission_name, view_menu_name):
+        """
+        Whether the user has this perm
+        """
+        if hasattr(self, 'perms'):
+            if (permission_name, view_menu_name) in self.perms:
+                return True
+        # rebuild the permissions set
+        self._get_and_cache_perms()
+        return (permission_name, view_menu_name) in self.perms
+
+    def has_all_dags_access(self):
+        """
+        Has all the dag access in any of the 3 cases:
+        1. Role needs to be in (Admin, Viewer, User, Op).
+        2. Has can_dag_read permission on all_dags view.
+        3. Has can_dag_edit permission on all_dags view.
+        """
+        return (
+            self._has_role(['Admin', 'Viewer', 'Op', 'User']) or
+            self._has_perm('can_dag_read', 'all_dags') or
+            self._has_perm('can_dag_edit', 'all_dags'))
+
+    def clean_perms(self):
+        """
+        FAB leaves faulty permissions that need to be cleaned up
+        """
+        logging.info('Cleaning faulty perms')
+        sesh = self.get_session
+        pvms = (
+            sesh.query(sqla_models.PermissionView)
+            .filter(or_(
+                sqla_models.PermissionView.permission == None,  # NOQA
+                sqla_models.PermissionView.view_menu == None,  # NOQA
+            ))
+        )
+        deleted_count = pvms.delete()
+        sesh.commit()
+        if deleted_count:
+            logging.info('Deleted {} faulty permissions'.format(deleted_count))
+
+    def _merge_perm(self, permission_name, view_menu_name):
+        """
+        Add the new permission , view_menu to ab_permission_view_role if not exists.
+        It will add the related entry to ab_permission
+        and ab_view_menu two meta tables as well.
+
+        :param str permission_name: Name of the permission.
+        :param str view_menu_name: Name of the view-menu
+
+        :return:
+        """
+        permission = self.find_permission(permission_name)
+        view_menu = self.find_view_menu(view_menu_name)
+        pv = None
+        if permission and view_menu:
+            pv = self.get_session.query(self.permissionview_model).filter_by(
+                permission=permission, view_menu=view_menu).first()
+        if not pv and permission_name and view_menu_name:
+            self.add_permission_view_menu(permission_name, view_menu_name)
+
+    def create_custom_dag_permission_view(self):
+        """
+        Workflow:
+        1. when scheduler found a new dag, we will create an entry in ab_view_menu
+        2. we fetch all the roles associated with dag users.
+        3. we join and create all the entries for ab_permission_view_menu
+           (predefined permissions * dag-view_menus)
+        4. Create all the missing role-permission-views for the ab_role_permission_views
+
+        :return: None.
+        """
+        # todo(Tao): should we put this function here or in scheduler loop?
+        logging.info('Fetching a set of all permission, view_menu from FAB meta-table')
+
+        def merge_pv(perm, view_menu):
+            """Create permission view menu only if it doesn't exist"""
+            if view_menu and perm and (view_menu, perm) not in all_pvs:
+                self._merge_perm(perm, view_menu)
+
+        all_pvs = set()
+        for pv in self.get_session.query(self.permissionview_model).all():
+            if pv.permission and pv.view_menu:
+                all_pvs.add((pv.permission.name, pv.view_menu.name))
+
+        # create perm for global logical dag
+        for dag in dag_vms:
+            for perm in dag_perms:
+                merge_pv(perm, dag)
+
+        # Get all the active / paused dags and insert them into a set
+        all_dags_models = settings.Session.query(models.DagModel)\
+            .filter(or_(models.DagModel.is_active, models.DagModel.is_paused))\
+            .filter(~models.DagModel.is_subdag).all()
+
+        for dag in all_dags_models:
+            for perm in dag_perms:
+                merge_pv(perm, dag.dag_id)
+
+        # for all the dag-level role, add the permission of viewer
+        # with the dag view to ab_permission_view
+        all_roles = self.get_all_roles()
+        user_role = self.find_role('User')
+
+        dag_role = [role for role in all_roles if role.name not in EXISTING_ROLES]
+        update_perm_views = []
+
+        # todo(tao) need to remove all_dag vm
+        dag_vm = self.find_view_menu('all_dags')
+        ab_perm_view_role = sqla_models.assoc_permissionview_role
+        perm_view = self.permissionview_model
+        view_menu = self.viewmenu_model
+
+        # todo(tao) comment on the query
+        all_perm_view_by_user = settings.Session.query(ab_perm_view_role)\
+            .join(perm_view, perm_view.id == ab_perm_view_role
+                  .columns.permission_view_id)\
+            .filter(ab_perm_view_role.columns.role_id == user_role.id)\
+            .join(view_menu)\
+            .filter(perm_view.view_menu_id != dag_vm.id)
+        all_perm_views = set([role.permission_view_id for role in all_perm_view_by_user])
+
+        for role in dag_role:
+            # Get all the perm-view of the role
+            existing_perm_view_by_user = self.get_session.query(ab_perm_view_role)\
+                .filter(ab_perm_view_role.columns.role_id == role.id)
+
+            existing_perms_views = set([role.permission_view_id
+                                        for role in existing_perm_view_by_user])
+            missing_perm_views = all_perm_views - existing_perms_views
+
+            for perm_view_id in missing_perm_views:
+                update_perm_views.append({'permission_view_id': perm_view_id,
+                                          'role_id': role.id})
+
+        self.get_session.execute(ab_perm_view_role.insert(), update_perm_views)
+        self.get_session.commit()
+
+    def update_admin_perm_view(self):
+        """
+        Admin should have all the permission-views.
+        Add the missing ones to the table for admin.
+
+        :return: None.
+        """
+        pvms = self.get_session.query(sqla_models.PermissionView).all()
+        pvms = [p for p in pvms if p.permission and p.view_menu]
+
+        admin = self.find_role('Admin')
+        existing_perms_vms = set(admin.permissions)
+        for p in pvms:
+            if p not in existing_perms_vms:
+                existing_perms_vms.add(p)
+        admin.permissions = list(existing_perms_vms)
+        self.get_session.commit()
+
+    def sync_roles(self):
+        """
+        1. Init the default role(Admin, Viewer, User, Op, public)
+           with related permissions.
+        2. Init the custom role(dag-user) with related permissions.
+
+        :return: None.
+        """
+        logging.info('Start syncing user roles.')
+
+        # Create default user role.
+        for config in ROLE_CONFIGS:
+            role = config['role']
+            vms = config['vms']
+            perms = config['perms']
+            self.init_role(role, vms, perms)
+        self.create_custom_dag_permission_view()
+
+        # init existing roles, the rest role could be created through UI.
+        self.update_admin_perm_view()
+        self.clean_perms()
+
+    def sync_perm_for_dag(self, dag_id):
+        """
+        Sync permissions for given dag id. The dag id surely exists in our dag bag
+        as only /refresh button will call this function
 
-def init_role(sm, role_name, role_vms, role_perms):
-    sm_session = sm.get_session
-    pvms = sm_session.query(sqla_models.PermissionView).all()
-    pvms = [p for p in pvms if p.permission and p.view_menu]
-
-    valid_perms = [p.permission.name for p in pvms]
-    valid_vms = [p.view_menu.name for p in pvms]
-    invalid_perms = [p for p in role_perms if p not in valid_perms]
-    if invalid_perms:
-        raise Exception('The following permissions are not valid: {}'
-                        .format(invalid_perms))
-    invalid_vms = [v for v in role_vms if v not in valid_vms]
-    if invalid_vms:
-        raise Exception('The following view menus are not valid: {}'
-                        .format(invalid_vms))
-
-    role = sm.add_role(role_name)
-    role_pvms = []
-    for pvm in pvms:
-        if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
-            role_pvms.append(pvm)
-    role_pvms = list(set(role_pvms))
-    role.permissions = role_pvms
-    sm_session.merge(role)
-    sm_session.commit()
-
-
-def init_roles(appbuilder):
-    for config in ROLE_CONFIGS:
-        name = config['role']
-        vms = config['vms']
-        perms = config['perms']
-        init_role(appbuilder.sm, name, vms, perms)
-
-
-def is_view_only(user, appbuilder):
-    if user.is_anonymous:
-        anonymous_role = appbuilder.sm.auth_role_public
-        return anonymous_role == 'Viewer'
-
-    user_roles = user.roles
-    return len(user_roles) == 1 and user_roles[0].name == 'Viewer'
+        :param dag_id:
+        :return:
+        """
+        for dag_perm in dag_perms:
+            perm_on_dag = self.find_permission_view_menu(dag_perm, dag_id)
+            if perm_on_dag is None:
+                self.add_permission_view_menu(dag_perm, dag_id)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 45efc16c49a8f..8a8fc03040283 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -29,6 +29,7 @@
 from collections import defaultdict
 from datetime import timedelta
 
+
 import markdown
 import nvd3
 import pendulum
@@ -39,6 +40,7 @@
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
+from flask_appbuilder.models.sqla.filters import BaseFilter
 from flask_appbuilder.models.sqla.interface import SQLAInterface
 from flask_babel import lazy_gettext
 from past.builtins import unicode
@@ -62,14 +64,14 @@
 from airflow.utils.json import json_ser
 from airflow.utils.state import State
 from airflow.www_rbac import utils as wwwutils
-from airflow.www_rbac.app import app
-from airflow.www_rbac.decorators import action_logging, gzipped
+from airflow.www_rbac.app import app, appbuilder
+from airflow.www_rbac.decorators import action_logging, gzipped, has_dag_access
 from airflow.www_rbac.forms import (DateTimeForm, DateTimeWithNumRunsForm,
                                     DateTimeWithNumRunsWithDagRunsForm,
                                     DagRunForm, ConnectionForm)
-from airflow.www_rbac.security import is_view_only
 from airflow.www_rbac.widgets import AirflowModelListWidget
 
+
 PAGE_SIZE = conf.getint('webserver', 'page_size')
 dagbag = models.DagBag(settings.DAGS_FOLDER)
 
@@ -180,9 +182,8 @@ def get_int_arg(value, default=0):
         if hide_paused:
             sql_query = sql_query.filter(~DM.is_paused)
 
-        orm_dags = {dag.dag_id: dag for dag
-                    in sql_query
-                    .all()}
+        # Get all the dag id the user could access
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
 
         import_errors = session.query(models.ImportError).all()
         for ie in import_errors:
@@ -200,6 +201,17 @@ def get_int_arg(value, default=0):
             unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
                                          not dag.parent_dag]
 
+        if 'all_dags' in filter_dag_ids:
+            orm_dags = {dag.dag_id: dag for dag
+                        in sql_query
+                        .all()}
+        else:
+            orm_dags = {dag.dag_id: dag for dag in
+                        sql_query.filter(DM.dag_id.in_(filter_dag_ids)).all()}
+            unfiltered_webserver_dags = [dag for dag in
+                                         unfiltered_webserver_dags
+                                         if dag.dag_id in filter_dag_ids]
+
         webserver_dags = {
             dag.dag_id: dag
             for dag in unfiltered_webserver_dags
@@ -256,8 +268,7 @@ def get_int_arg(value, default=0):
                                            search=arg_search_query,
                                            showPaused=not hide_paused),
             dag_ids_in_page=page_dag_ids,
-            auto_complete_data=auto_complete_data,
-            view_only=is_view_only(g.user, self.appbuilder))
+            auto_complete_data=auto_complete_data)
 
     @expose('/dag_stats')
     @has_access
@@ -271,23 +282,33 @@ def dag_stats(self, session=None):
             session.query(ds.dag_id, ds.state, ds.count)
         )
 
-        data = {}
-        for dag_id, state, count in qry:
-            if dag_id not in data:
-                data[dag_id] = {}
-            data[dag_id][state] = count
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
 
         payload = {}
-        for dag in dagbag.dags.values():
-            payload[dag.safe_dag_id] = []
-            for state in State.dag_states:
-                count = data.get(dag.dag_id, {}).get(state, 0)
-                payload[dag.safe_dag_id].append({
-                    'state': state,
-                    'count': count,
-                    'dag_id': dag.dag_id,
-                    'color': State.color(state)
-                })
+        if filter_dag_ids:
+            if 'all_dags' not in filter_dag_ids:
+                qry = qry.filter(ds.dag_id.in_(filter_dag_ids))
+            data = {}
+            for dag_id, state, count in qry:
+                if dag_id not in data:
+                    data[dag_id] = {}
+                data[dag_id][state] = count
+
+            for dag in dagbag.dags.values():
+                if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
+                    payload[dag.safe_dag_id] = []
+                    for state in State.dag_states:
+                        try:
+                            count = data[dag.dag_id][state]
+                        except Exception:
+                            count = 0
+                        d = {
+                            'state': state,
+                            'count': count,
+                            'dag_id': dag.dag_id,
+                            'color': State.color(state)
+                        }
+                        payload[dag.safe_dag_id].append(d)
         return wwwutils.json_response(payload)
 
     @expose('/task_stats')
@@ -298,6 +319,12 @@ def task_stats(self, session=None):
         DagRun = models.DagRun
         Dag = models.DagModel
 
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
+
+        payload = {}
+        if not filter_dag_ids:
+            return
+
         LastDagRun = (
             session.query(
                         DagRun.dag_id,
@@ -339,25 +366,31 @@ def task_stats(self, session=None):
 
         data = {}
         for dag_id, state, count in qry:
-            if dag_id not in data:
-                data[dag_id] = {}
-            data[dag_id][state] = count
+            if 'all_dags' in filter_dag_ids or dag_id in filter_dag_ids:
+                if dag_id not in data:
+                    data[dag_id] = {}
+                data[dag_id][state] = count
         session.commit()
 
-        payload = {}
         for dag in dagbag.dags.values():
-            payload[dag.safe_dag_id] = []
-            for state in State.task_states:
-                count = data.get(dag.dag_id, {}).get(state, 0)
-                payload[dag.safe_dag_id].append({
-                    'state': state,
-                    'count': count,
-                    'dag_id': dag.dag_id,
-                    'color': State.color(state)
-                })
+            if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
+                payload[dag.safe_dag_id] = []
+                for state in State.task_states:
+                    try:
+                        count = data[dag.dag_id][state]
+                    except Exception:
+                        count = 0
+                    d = {
+                        'state': state,
+                        'count': count,
+                        'dag_id': dag.dag_id,
+                        'color': State.color(state)
+                    }
+                    payload[dag.safe_dag_id].append(d)
         return wwwutils.json_response(payload)
 
     @expose('/code')
+    @has_dag_access(can_dag_read=True)
     @has_access
     def code(self):
         dag_id = request.args.get('dag_id')
@@ -377,6 +410,7 @@ def code(self):
             demo_mode=conf.getboolean('webserver', 'demo_mode'))
 
     @expose('/dag_details')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @provide_session
     def dag_details(self, session=None):
@@ -413,14 +447,19 @@ def show_traceback(self):
     @has_access
     def pickle_info(self):
         d = {}
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
+        if not filter_dag_ids:
+            return wwwutils.json_response({})
         dag_id = request.args.get('dag_id')
         dags = [dagbag.dags.get(dag_id)] if dag_id else dagbag.dags.values()
         for dag in dags:
-            if not dag.is_subdag:
-                d[dag.dag_id] = dag.pickle_info()
+            if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
+                if not dag.is_subdag:
+                    d[dag.dag_id] = dag.pickle_info()
         return wwwutils.json_response(d)
 
     @expose('/rendered')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     def rendered(self):
@@ -457,6 +496,7 @@ def rendered(self):
             title=title, )
 
     @expose('/get_logs_with_metadata')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -516,6 +556,7 @@ def get_logs_with_metadata(self, session=None):
             return jsonify(message=error_message, error=True, metadata=metadata)
 
     @expose('/log')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -540,6 +581,7 @@ def log(self, session=None):
             execution_date=execution_date, form=form)
 
     @expose('/task')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     def task(self):
@@ -617,6 +659,7 @@ def task(self):
             dag=dag, title=title)
 
     @expose('/xcom')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -655,6 +698,7 @@ def xcom(self, session=None):
             dag=dag, title=title)
 
     @expose('/run')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def run(self):
@@ -722,8 +766,9 @@ def run(self):
         return redirect(origin)
 
     @expose('/delete')
-    @action_logging
+    @has_dag_access(can_dag_edit=True)
     @has_access
+    @action_logging
     def delete(self):
         from airflow.api.common.experimental import delete_dag
         from airflow.exceptions import DagNotFound, DagFileExists
@@ -749,6 +794,7 @@ def delete(self):
         return redirect(origin)
 
     @expose('/trigger')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def trigger(self):
@@ -818,6 +864,7 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
         return response
 
     @expose('/clear')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def clear(self):
@@ -847,6 +894,7 @@ def clear(self):
                                    recursive=recursive, confirmed=confirmed)
 
     @expose('/dagrun_clear')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_clear(self):
@@ -868,22 +916,29 @@ def dagrun_clear(self):
     @provide_session
     def blocked(self, session=None):
         DR = models.DagRun
-        dags = (
-            session.query(DR.dag_id, sqla.func.count(DR.id))
-                   .filter(DR.state == State.RUNNING)
-                   .group_by(DR.dag_id)
-                   .all()
-        )
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
+
         payload = []
-        for dag_id, active_dag_runs in dags:
-            max_active_runs = 0
-            if dag_id in dagbag.dags:
-                max_active_runs = dagbag.dags[dag_id].max_active_runs
-            payload.append({
-                'dag_id': dag_id,
-                'active_dag_run': active_dag_runs,
-                'max_active_runs': max_active_runs,
-            })
+        if filter_dag_ids:
+            dags = (
+                session.query(DR.dag_id, sqla.func.count(DR.id))
+                       .filter(DR.state == State.RUNNING)
+                       .group_by(DR.dag_id)
+
+            )
+            if 'all_dags' not in filter_dag_ids:
+                dags = dags.filter(DR.dag_id.in_(filter_dag_ids))
+            dags = dags.all()
+
+            for dag_id, active_dag_runs in dags:
+                max_active_runs = 0
+                if dag_id in dagbag.dags:
+                    max_active_runs = dagbag.dags[dag_id].max_active_runs
+                payload.append({
+                    'dag_id': dag_id,
+                    'active_dag_run': active_dag_runs,
+                    'max_active_runs': max_active_runs,
+                })
         return wwwutils.json_response(payload)
 
     def _mark_dagrun_state_as_failed(self, dag_id, execution_date, confirmed, origin):
@@ -944,6 +999,7 @@ def _mark_dagrun_state_as_success(self, dag_id, execution_date, confirmed, origi
             return response
 
     @expose('/dagrun_failed')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_failed(self):
@@ -955,6 +1011,7 @@ def dagrun_failed(self):
                                                  confirmed, origin)
 
     @expose('/dagrun_success')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_success(self):
@@ -1008,6 +1065,7 @@ def _mark_task_instance_state(self, dag_id, task_id, origin, execution_date,
         return response
 
     @expose('/failed')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def failed(self):
@@ -1027,6 +1085,7 @@ def failed(self):
                                               future, past, State.FAILED)
 
     @expose('/success')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def success(self):
@@ -1046,6 +1105,7 @@ def success(self):
                                               future, past, State.SUCCESS)
 
     @expose('/tree')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @gzipped
     @action_logging
@@ -1175,6 +1235,7 @@ def set_duration(tid):
             dag=dag, data=data, blur=blur, num_runs=num_runs)
 
     @expose('/graph')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @gzipped
     @action_logging
@@ -1273,6 +1334,7 @@ class GraphForm(DateTimeWithNumRunsWithDagRunsForm):
             edges=json.dumps(edges, indent=2), )
 
     @expose('/duration')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -1380,6 +1442,7 @@ def duration(self, session=None):
         )
 
     @expose('/tries')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -1444,6 +1507,7 @@ def tries(self, session=None):
         )
 
     @expose('/landing_times')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -1522,6 +1586,7 @@ def landing_times(self, session=None):
         )
 
     @expose('/paused', methods=['POST'])
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     @provide_session
@@ -1543,6 +1608,7 @@ def paused(self, session=None):
         return "OK"
 
     @expose('/refresh')
+    @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     @provide_session
@@ -1557,6 +1623,9 @@ def refresh(self, session=None):
             session.merge(orm_dag)
         session.commit()
 
+        # sync dag permission
+        appbuilder.sm.sync_perm_for_dag(dag_id)
+
         dagbag.get_dag(dag_id)
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
@@ -1566,10 +1635,13 @@ def refresh(self, session=None):
     @action_logging
     def refresh_all(self):
         dagbag.collect_dags(only_if_updated=False)
+        # sync permissions for all dags
+        appbuilder.sm.sync_perm_for_dag()
         flash("All DAGs are now up to date")
         return redirect('/')
 
     @expose('/gantt')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -1670,6 +1742,7 @@ def gantt(self, session=None):
         )
 
     @expose('/object/task_instances')
+    @has_dag_access(can_dag_read=True)
     @has_access
     @action_logging
     @provide_session
@@ -1759,6 +1832,14 @@ def conf(self):
 #                                    ModelViews
 ######################################################################################
 
+class DagFilter(BaseFilter):
+    def apply(self, query, func): # noqa
+        if appbuilder.sm.has_all_dags_access():
+            return query
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
+        return query.filter(self.model.dag_id.in_(filter_dag_ids))
+
+
 class AirflowModelView(ModelView):
     list_widget = AirflowModelListWidget
     page_size = PAGE_SIZE
@@ -1778,6 +1859,8 @@ class SlaMissModelView(AirflowModelView):
     edit_columns = ['dag_id', 'task_id', 'execution_date', 'email_sent', 'timestamp']
     search_columns = ['dag_id', 'task_id', 'email_sent', 'timestamp', 'execution_date']
     base_order = ('execution_date', 'desc')
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     formatters_columns = {
         'task_id': wwwutils.task_instance_link,
         'execution_date': wwwutils.datetime_f('execution_date'),
@@ -1799,6 +1882,8 @@ class XComModelView(AirflowModelView):
     edit_columns = ['key', 'value', 'execution_date', 'task_id', 'dag_id']
     base_order = ('execution_date', 'desc')
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     @action('muldelete', 'Delete', "Are you sure you want to delete selected records?",
             single=False)
     def action_muldelete(self, items):
@@ -1831,6 +1916,7 @@ class ConnectionModelView(AirflowModelView):
 
     @action('muldelete', 'Delete', 'Are you sure you want to delete selected records?',
             single=False)
+    @has_dag_access(can_dag_edit=True)
     def action_muldelete(self, items):
         self.datamodel.delete_all(items)
         self.update_redirect()
@@ -1932,7 +2018,7 @@ class VariableModelView(AirflowModelView):
     base_permissions = ['can_add', 'can_list', 'can_edit', 'can_delete', 'can_varimport']
 
     list_columns = ['key', 'val', 'is_encrypted']
-    add_columns = ['key', 'val']
+    add_columns = ['key', 'val', 'is_encrypted']
     edit_columns = ['key', 'val']
     search_columns = ['key', 'val']
 
@@ -1972,7 +2058,6 @@ def action_varexport(self, items):
         var_dict = {}
         d = json.JSONDecoder()
         for var in items:
-            val = None
             try:
                 val = d.decode(var.val)
             except Exception:
@@ -2028,6 +2113,8 @@ class JobModelView(AirflowModelView):
 
     base_order = ('start_date', 'desc')
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     formatters_columns = {
         'start_date': wwwutils.datetime_f('start_date'),
         'end_date': wwwutils.datetime_f('end_date'),
@@ -2049,6 +2136,8 @@ class DagRunModelView(AirflowModelView):
 
     base_order = ('execution_date', 'desc')
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     add_form = edit_form = DagRunForm
 
     formatters_columns = {
@@ -2065,6 +2154,7 @@ class DagRunModelView(AirflowModelView):
 
     @action('muldelete', "Delete", "Are you sure you want to delete selected records?",
             single=False)
+    @has_dag_access(can_dag_edit=True)
     @provide_session
     def action_muldelete(self, items, session=None):
         self.datamodel.delete_all(items)
@@ -2167,6 +2257,8 @@ class LogModelView(AirflowModelView):
 
     base_order = ('dttm', 'desc')
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     formatters_columns = {
         'dttm': wwwutils.datetime_f('dttm'),
         'execution_date': wwwutils.datetime_f('execution_date'),
@@ -2193,6 +2285,8 @@ class TaskInstanceModelView(AirflowModelView):
 
     base_order = ('job_id', 'asc')
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     def log_url_formatter(attr):
         log_url = attr.get('log_url')
         return Markup(
@@ -2257,24 +2351,28 @@ def set_task_instance_state(self, tis, target_state, session=None):
             flash('Failed to set state', 'error')
 
     @action('set_running', "Set state to 'running'", '', single=False)
+    @has_dag_access(can_dag_edit=True)
     def action_set_running(self, tis):
         self.set_task_instance_state(tis, State.RUNNING)
         self.update_redirect()
         return redirect(self.get_redirect())
 
     @action('set_failed', "Set state to 'failed'", '', single=False)
+    @has_dag_access(can_dag_edit=True)
     def action_set_failed(self, tis):
         self.set_task_instance_state(tis, State.FAILED)
         self.update_redirect()
         return redirect(self.get_redirect())
 
     @action('set_success', "Set state to 'success'", '', single=False)
+    @has_dag_access(can_dag_edit=True)
     def action_set_success(self, tis):
         self.set_task_instance_state(tis, State.SUCCESS)
         self.update_redirect()
         return redirect(self.get_redirect())
 
     @action('set_retry', "Set state to 'up_for_retry'", '', single=False)
+    @has_dag_access(can_dag_edit=True)
     def action_set_retry(self, tis):
         self.set_task_instance_state(tis, State.UP_FOR_RETRY)
         self.update_redirect()
@@ -2307,6 +2405,8 @@ class DagModelView(AirflowModelView):
         'dag_id': wwwutils.dag_link
     }
 
+    base_filters = [['dag_id', DagFilter, lambda: []]]
+
     def get_query(self):
         """
         Default filters for model
diff --git a/tests/core.py b/tests/core.py
index 7b29bc6aad0de..d64c9939bf814 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -46,7 +46,7 @@
 from airflow.executors import SequentialExecutor
 from airflow.models import Variable, TaskInstance
 
-configuration.conf.load_test_config()  # NOQA: E402
+
 from airflow import jobs, models, DAG, utils, macros, settings, exceptions
 from airflow.models import BaseOperator
 from airflow.operators.bash_operator import BashOperator
@@ -1103,12 +1103,15 @@ def setUpClass(cls):
 
     def setUp(self):
         super(CliTests, self).setUp()
+        from airflow.www_rbac import app as application
         configuration.load_test_config()
-        app = application.create_app()
-        app.config['TESTING'] = True
+        self.app, self.appbuilder = application.create_app(session=Session, testing=True)
+        self.app.config['TESTING'] = True
+
         self.parser = cli.CLIFactory.get_parser()
         self.dagbag = models.DagBag(dag_folder=DEV_NULL, include_examples=True)
-        self.session = Session()
+        settings.configure_orm()
+        self.session = Session
 
     def tearDown(self):
         self._cleanup(session=self.session)
@@ -1150,6 +1153,13 @@ def test_cli_create_user_supplied_password(self):
         ])
         cli.create_user(args)
 
+    def test_cli_sync_perm(self):
+        # test whether sync_perm cli will throw exceptions or not
+        args = self.parser.parse_args([
+            'sync_perm'
+        ])
+        cli.sync_perm(args)
+
     def test_cli_list_tasks(self):
         for dag_id in self.dagbag.dags.keys():
             args = self.parser.parse_args(['list_tasks', dag_id])
diff --git a/tests/jobs.py b/tests/jobs.py
index bb729424eca38..77037f3100751 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1170,6 +1170,8 @@ def test_localtaskjob_heartbeat(self, mock_pid):
         mock_pid.return_value = 2
         self.assertRaises(AirflowException, job1.heartbeat_callback)
 
+    @unittest.skipIf('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                     "flaky when run on mysql")
     def test_mark_success_no_kill(self):
         """
         Test that ensures that mark_success in the UI doesn't cause
@@ -1926,6 +1928,8 @@ def test_execute_task_instances_limit(self):
             ti.refresh_from_db()
             self.assertEqual(State.QUEUED, ti.state)
 
+    @unittest.skipUnless("INTEGRATION" in os.environ,
+                         "The test is flaky with nondeterministic result")
     def test_change_state_for_tis_without_dagrun(self):
         dag1 = DAG(
             dag_id='test_change_state_for_tis_without_dagrun',
@@ -2022,7 +2026,7 @@ def test_change_state_for_tis_without_dagrun(self):
             new_state=State.NONE,
             session=session)
         ti1a.refresh_from_db(session=session)
-        self.assertEqual(ti1a.state, State.NONE)
+        self.assertEqual(ti1a.state, State.SCHEDULED)
 
         # don't touch ti1b
         ti1b.refresh_from_db(session=session)
diff --git a/tests/models.py b/tests/models.py
index 954765d7fabb8..cf5774d6057d1 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1256,7 +1256,7 @@ def with_all_tasks_removed(dag):
 
         dagrun.verify_integrity()
         flaky_ti.refresh_from_db()
-        self.assertEquals(State.REMOVED, flaky_ti.state)
+        self.assertEquals(State.NONE, flaky_ti.state)
 
         dagrun.dag.add_task(DummyOperator(task_id='flaky_task', owner='test'))
 
diff --git a/tests/utils/test_db.py b/tests/utils/test_db.py
index 8ddd3ef715368..5fdc40b5255be 100644
--- a/tests/utils/test_db.py
+++ b/tests/utils/test_db.py
@@ -76,6 +76,9 @@ def test_database_schema_and_sqlalchemy_model_are_in_sync(self):
                        t[1].name == 'ab_user'),
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'ab_view_menu'),
+            # from test_security unit test
+            lambda t: (t[0] == 'remove_table' and
+                       t[1].name == 'some_model'),
         ]
         for ignore in ignores:
             diff = [d for d in diff if not ignore(d)]
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 5805016a00e62..8198eaa33742f 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -156,8 +156,6 @@ def test_can_handle_error_on_decrypt(self):
         response = self.app.get('/admin/variable', follow_redirects=True)
         self.assertEqual(response.status_code, 200)
         self.assertEqual(self.session.query(models.Variable).count(), 1)
-        self.assertIn('<span class="label label-danger">Invalid</span>',
-                      response.data.decode('utf-8'))
 
     def test_xss_prevention(self):
         xss = "/admin/airflow/variables/asdf<img%20src=''%20onerror='alert(1);'>"
diff --git a/tests/www_rbac/api/experimental/test_endpoints.py b/tests/www_rbac/api/experimental/test_endpoints.py
index a84d9cfdb44ae..059ae0eabb888 100644
--- a/tests/www_rbac/api/experimental/test_endpoints.py
+++ b/tests/www_rbac/api/experimental/test_endpoints.py
@@ -22,7 +22,9 @@
 import unittest
 from urllib.parse import quote_plus
 
-from airflow import configuration
+
+from airflow import configuration as conf
+from airflow import settings
 from airflow.api.common.experimental.trigger_dag import trigger_dag
 from airflow.models import DagBag, DagRun, Pool, TaskInstance
 from airflow.settings import Session
@@ -30,7 +32,20 @@
 from airflow.www_rbac import app as application
 
 
-class TestApiExperimental(unittest.TestCase):
+class TestBase(unittest.TestCase):
+    def setUp(self):
+        conf.load_test_config()
+        self.app, self.appbuilder = application.create_app(session=Session, testing=True)
+        self.app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///'
+        self.app.config['SECRET_KEY'] = 'secret_key'
+        self.app.config['CSRF_ENABLED'] = False
+        self.app.config['WTF_CSRF_ENABLED'] = False
+        self.client = self.app.test_client()
+        settings.configure_orm()
+        self.session = Session
+
+
+class TestApiExperimental(TestBase):
 
     @classmethod
     def setUpClass(cls):
@@ -43,9 +58,6 @@ def setUpClass(cls):
 
     def setUp(self):
         super(TestApiExperimental, self).setUp()
-        configuration.load_test_config()
-        app, _ = application.create_app(testing=True)
-        self.app = app.test_client()
 
     def tearDown(self):
         session = Session()
@@ -58,20 +70,20 @@ def tearDown(self):
     def test_task_info(self):
         url_template = '/api/experimental/dags/{}/tasks/{}'
 
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('example_bash_operator', 'runme_0')
         )
         self.assertIn('"email"', response.data.decode('utf-8'))
         self.assertNotIn('error', response.data.decode('utf-8'))
         self.assertEqual(200, response.status_code)
 
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('example_bash_operator', 'DNE')
         )
         self.assertIn('error', response.data.decode('utf-8'))
         self.assertEqual(404, response.status_code)
 
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('DNE', 'DNE')
         )
         self.assertIn('error', response.data.decode('utf-8'))
@@ -80,7 +92,7 @@ def test_task_info(self):
     def test_task_paused(self):
         url_template = '/api/experimental/dags/{}/paused/{}'
 
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('example_bash_operator', 'true')
         )
         self.assertIn('ok', response.data.decode('utf-8'))
@@ -88,7 +100,7 @@ def test_task_paused(self):
 
         url_template = '/api/experimental/dags/{}/paused/{}'
 
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('example_bash_operator', 'false')
         )
         self.assertIn('ok', response.data.decode('utf-8'))
@@ -96,7 +108,7 @@ def test_task_paused(self):
 
     def test_trigger_dag(self):
         url_template = '/api/experimental/dags/{}/dag_runs'
-        response = self.app.post(
+        response = self.client.post(
             url_template.format('example_bash_operator'),
             data=json.dumps({'run_id': 'my_run' + utcnow().isoformat()}),
             content_type="application/json"
@@ -104,7 +116,7 @@ def test_trigger_dag(self):
 
         self.assertEqual(200, response.status_code)
 
-        response = self.app.post(
+        response = self.client.post(
             url_template.format('does_not_exist_dag'),
             data=json.dumps({}),
             content_type="application/json"
@@ -122,7 +134,7 @@ def test_trigger_dag_for_date(self):
         datetime_string = execution_date.isoformat()
 
         # Test Correct execution
-        response = self.app.post(
+        response = self.client.post(
             url_template.format(dag_id),
             data=json.dumps({'execution_date': datetime_string}),
             content_type="application/json"
@@ -137,7 +149,7 @@ def test_trigger_dag_for_date(self):
                         .format(execution_date))
 
         # Test error for nonexistent dag
-        response = self.app.post(
+        response = self.client.post(
             url_template.format('does_not_exist_dag'),
             data=json.dumps({'execution_date': execution_date.isoformat()}),
             content_type="application/json"
@@ -145,7 +157,7 @@ def test_trigger_dag_for_date(self):
         self.assertEqual(404, response.status_code)
 
         # Test error for bad datetime format
-        response = self.app.post(
+        response = self.client.post(
             url_template.format(dag_id),
             data=json.dumps({'execution_date': 'not_a_datetime'}),
             content_type="application/json"
@@ -168,7 +180,7 @@ def test_task_instance_info(self):
                     execution_date=execution_date)
 
         # Test Correct execution
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, datetime_string, task_id)
         )
         self.assertEqual(200, response.status_code)
@@ -176,7 +188,7 @@ def test_task_instance_info(self):
         self.assertNotIn('error', response.data.decode('utf-8'))
 
         # Test error for nonexistent dag
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('does_not_exist_dag', datetime_string,
                                 task_id),
         )
@@ -184,21 +196,21 @@ def test_task_instance_info(self):
         self.assertIn('error', response.data.decode('utf-8'))
 
         # Test error for nonexistent task
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, datetime_string, 'does_not_exist_task')
         )
         self.assertEqual(404, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
         # Test error for nonexistent dag run (wrong execution_date)
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, wrong_datetime_string, task_id)
         )
         self.assertEqual(404, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
         # Test error for bad datetime format
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, 'not_a_datetime', task_id)
         )
         self.assertEqual(400, response.status_code)
@@ -219,7 +231,7 @@ def test_dagrun_status(self):
                     execution_date=execution_date)
 
         # Test Correct execution
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, datetime_string)
         )
         self.assertEqual(200, response.status_code)
@@ -227,27 +239,28 @@ def test_dagrun_status(self):
         self.assertNotIn('error', response.data.decode('utf-8'))
 
         # Test error for nonexistent dag
-        response = self.app.get(
+        response = self.client.get(
             url_template.format('does_not_exist_dag', datetime_string),
         )
         self.assertEqual(404, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
         # Test error for nonexistent dag run (wrong execution_date)
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, wrong_datetime_string)
         )
         self.assertEqual(404, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
         # Test error for bad datetime format
-        response = self.app.get(
+        response = self.client.get(
             url_template.format(dag_id, 'not_a_datetime')
         )
         self.assertEqual(400, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
-class TestPoolApiExperimental(unittest.TestCase):
+
+class TestPoolApiExperimental(TestBase):
 
     @classmethod
     def setUpClass(cls):
@@ -259,10 +272,7 @@ def setUpClass(cls):
 
     def setUp(self):
         super(TestPoolApiExperimental, self).setUp()
-        configuration.load_test_config()
-        app, _ = application.create_app(testing=True)
-        self.app = app.test_client()
-        self.session = Session()
+
         self.pools = []
         for i in range(2):
             name = 'experimental_%s' % (i + 1)
@@ -283,12 +293,12 @@ def tearDown(self):
         super(TestPoolApiExperimental, self).tearDown()
 
     def _get_pool_count(self):
-        response = self.app.get('/api/experimental/pools')
+        response = self.client.get('/api/experimental/pools')
         self.assertEqual(response.status_code, 200)
         return len(json.loads(response.data.decode('utf-8')))
 
     def test_get_pool(self):
-        response = self.app.get(
+        response = self.client.get(
             '/api/experimental/pools/{}'.format(self.pool.pool),
         )
         self.assertEqual(response.status_code, 200)
@@ -296,13 +306,13 @@ def test_get_pool(self):
                          self.pool.to_json())
 
     def test_get_pool_non_existing(self):
-        response = self.app.get('/api/experimental/pools/foo')
+        response = self.client.get('/api/experimental/pools/foo')
         self.assertEqual(response.status_code, 404)
         self.assertEqual(json.loads(response.data.decode('utf-8'))['error'],
                          "Pool 'foo' doesn't exist")
 
     def test_get_pools(self):
-        response = self.app.get('/api/experimental/pools')
+        response = self.client.get('/api/experimental/pools')
         self.assertEqual(response.status_code, 200)
         pools = json.loads(response.data.decode('utf-8'))
         self.assertEqual(len(pools), 2)
@@ -310,7 +320,7 @@ def test_get_pools(self):
             self.assertDictEqual(pool, self.pools[i].to_json())
 
     def test_create_pool(self):
-        response = self.app.post(
+        response = self.client.post(
             '/api/experimental/pools',
             data=json.dumps({
                 'name': 'foo',
@@ -328,7 +338,7 @@ def test_create_pool(self):
 
     def test_create_pool_with_bad_name(self):
         for name in ('', '    '):
-            response = self.app.post(
+            response = self.client.post(
                 '/api/experimental/pools',
                 data=json.dumps({
                     'name': name,
@@ -345,7 +355,7 @@ def test_create_pool_with_bad_name(self):
         self.assertEqual(self._get_pool_count(), 2)
 
     def test_delete_pool(self):
-        response = self.app.delete(
+        response = self.client.delete(
             '/api/experimental/pools/{}'.format(self.pool.pool),
         )
         self.assertEqual(response.status_code, 200)
@@ -354,7 +364,7 @@ def test_delete_pool(self):
         self.assertEqual(self._get_pool_count(), 1)
 
     def test_delete_pool_non_existing(self):
-        response = self.app.delete(
+        response = self.client.delete(
             '/api/experimental/pools/foo',
         )
         self.assertEqual(response.status_code, 404)
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index ae1a5c6fa3f6d..67ea5b3035640 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -21,6 +21,7 @@
 
 import unittest
 import logging
+import mock
 
 from flask import Flask
 from flask_appbuilder import AppBuilder, SQLA, Model, has_access, expose
@@ -29,7 +30,8 @@
 
 from sqlalchemy import Column, Integer, String, Date, Float
 
-from airflow.www_rbac.security import init_role
+from airflow.www_rbac.security import AirflowSecurityManager, dag_perms
+
 
 logging.basicConfig(format='%(asctime)s:%(levelname)s:%(name)s:%(message)s')
 logging.getLogger().setLevel(logging.DEBUG)
@@ -70,11 +72,13 @@ def setUp(self):
         self.app.config['CSRF_ENABLED'] = False
         self.app.config['WTF_CSRF_ENABLED'] = False
         self.db = SQLA(self.app)
-        self.appbuilder = AppBuilder(self.app, self.db.session)
+        self.appbuilder = AppBuilder(self.app,
+                                     self.db.session,
+                                     security_manager_class=AirflowSecurityManager)
+        self.security_manager = self.appbuilder.sm
         self.appbuilder.add_view(SomeBaseView, "SomeBaseView", category="BaseViews")
         self.appbuilder.add_view(SomeModelView, "SomeModelView", category="ModelViews")
-
-        role_admin = self.appbuilder.sm.find_role('Admin')
+        role_admin = self.security_manager.find_role('Admin')
         self.user = self.appbuilder.sm.add_user('admin', 'admin', 'user', 'admin@fab.org',
                                                 role_admin, 'general')
         log.debug("Complete setup!")
@@ -89,7 +93,7 @@ def test_init_role_baseview(self):
         role_name = 'MyRole1'
         role_perms = ['can_some_action']
         role_vms = ['SomeBaseView']
-        init_role(self.appbuilder.sm, role_name, role_vms, role_perms)
+        self.security_manager.init_role(role_name, role_vms, role_perms)
         role = self.appbuilder.sm.find_role(role_name)
         self.assertIsNotNone(role)
         self.assertEqual(len(role_perms), len(role.permissions))
@@ -98,26 +102,78 @@ def test_init_role_modelview(self):
         role_name = 'MyRole2'
         role_perms = ['can_list', 'can_show', 'can_add', 'can_edit', 'can_delete']
         role_vms = ['SomeModelView']
-        init_role(self.appbuilder.sm, role_name, role_vms, role_perms)
+        self.security_manager.init_role(role_name, role_vms, role_perms)
         role = self.appbuilder.sm.find_role(role_name)
         self.assertIsNotNone(role)
         self.assertEqual(len(role_perms), len(role.permissions))
 
-    def test_invalid_perms(self):
-        role_name = 'MyRole3'
-        role_perms = ['can_foo']
-        role_vms = ['SomeBaseView']
-        with self.assertRaises(Exception) as context:
-            init_role(self.appbuilder.sm, role_name, role_vms, role_perms)
-        self.assertEqual("The following permissions are not valid: ['can_foo']",
-                         str(context.exception))
+    def test_get_user_roles(self):
+        user = mock.MagicMock()
+        user.is_anonymous.return_value = False
+        roles = self.appbuilder.sm.find_role('Admin')
+        user.roles = roles
+        self.assertEqual(self.security_manager.get_user_roles(user), roles)
 
-    def test_invalid_vms(self):
-        role_name = 'MyRole4'
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager.get_user_roles')
+    def test_get_all_permissions_views(self, mock_get_user_roles):
+        role_name = 'MyRole1'
         role_perms = ['can_some_action']
-        role_vms = ['NonExistentBaseView']
-        with self.assertRaises(Exception) as context:
-            init_role(self.appbuilder.sm, role_name, role_vms, role_perms)
-        self.assertEqual("The following view menus are not valid: "
-                         "['NonExistentBaseView']",
-                         str(context.exception))
+        role_vms = ['SomeBaseView']
+        self.security_manager.init_role(role_name, role_vms, role_perms)
+        role = self.security_manager.find_role(role_name)
+
+        mock_get_user_roles.return_value = [role]
+        self.assertEqual(self.security_manager
+                         .get_all_permissions_views(),
+                         {('can_some_action', 'SomeBaseView')})
+
+        mock_get_user_roles.return_value = []
+        self.assertEquals(len(self.security_manager
+                              .get_all_permissions_views()), 0)
+
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager'
+                '.get_all_permissions_views')
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager'
+                '.get_user_roles')
+    def test_get_accessible_dag_ids(self, mock_get_user_roles,
+                                    mock_get_all_permissions_views):
+        user = mock.MagicMock()
+        role_name = 'MyRole1'
+        role_perms = ['can_dag_read']
+        role_vms = ['dag_id']
+        self.security_manager.init_role(role_name, role_vms, role_perms)
+        role = self.security_manager.find_role(role_name)
+        user.roles = [role]
+        user.is_anonymous.return_value = False
+        mock_get_all_permissions_views.return_value = {('can_dag_read', 'dag_id')}
+
+        mock_get_user_roles.return_value = [role]
+        self.assertEquals(self.security_manager
+                          .get_accessible_dag_ids(user), set(['dag_id']))
+
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager._has_view_access')
+    def test_has_access(self, mock_has_view_access):
+        user = mock.MagicMock()
+        user.is_anonymous.return_value = False
+        mock_has_view_access.return_value = True
+        self.assertTrue(self.security_manager.has_access('perm', 'view', user))
+
+    def test_sync_perm_for_dag(self):
+        test_dag_id = 'TEST_DAG'
+        self.security_manager.sync_perm_for_dag(test_dag_id)
+        for dag_perm in dag_perms:
+            self.assertIsNotNone(self.security_manager.
+                                 find_permission_view_menu(dag_perm, test_dag_id))
+
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager._has_perm')
+    @mock.patch('airflow.www_rbac.security.AirflowSecurityManager._has_role')
+    def test_has_all_dag_access(self, mock_has_role, mock_has_perm):
+        mock_has_role.return_value = True
+        self.assertTrue(self.security_manager.has_all_dags_access())
+
+        mock_has_role.return_value = False
+        mock_has_perm.return_value = False
+        self.assertFalse(self.security_manager.has_all_dags_access())
+
+        mock_has_perm.return_value = True
+        self.assertTrue(self.security_manager.has_all_dags_access())
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 49272e3090cfb..7f86c17db5e87 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -30,12 +30,11 @@
 import urllib
 
 from flask._compat import PY2
-from flask_appbuilder.security.sqla.models import User as ab_user
 from urllib.parse import quote_plus
 from werkzeug.test import Client
 
 from airflow import configuration as conf
-from airflow import models
+from airflow import models, settings
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
 from airflow.models import DAG, DagRun, TaskInstance
 from airflow.operators.dummy_operator import DummyOperator
@@ -49,17 +48,17 @@
 class TestBase(unittest.TestCase):
     def setUp(self):
         conf.load_test_config()
-        self.app, self.appbuilder = application.create_app(testing=True)
+        self.app, self.appbuilder = application.create_app(session=Session, testing=True)
         self.app.config['WTF_CSRF_ENABLED'] = False
         self.client = self.app.test_client()
-        self.session = Session()
+        settings.configure_orm()
+        self.session = Session
         self.login()
 
     def login(self):
-        sm_session = self.appbuilder.sm.get_session()
-        self.user = sm_session.query(ab_user).first()
-        if not self.user:
-            role_admin = self.appbuilder.sm.find_role('Admin')
+        role_admin = self.appbuilder.sm.find_role('Admin')
+        tester = self.appbuilder.sm.find_user(username='test')
+        if not tester:
             self.appbuilder.sm.add_user(
                 username='test',
                 first_name='test',
@@ -89,6 +88,15 @@ def check_content_in_response(self, text, resp, resp_code=200):
         else:
             self.assertIn(text, resp_html)
 
+    def check_content_not_in_response(self, text, resp, resp_code=200):
+        resp_html = resp.data.decode('utf-8')
+        self.assertEqual(resp_code, resp.status_code)
+        if isinstance(text, list):
+            for kw in text:
+                self.assertNotIn(kw, resp_html)
+        else:
+            self.assertNotIn(text, resp_html)
+
     def percent_encode(self, obj):
         if PY2:
             return urllib.quote_plus(str(obj))
@@ -138,10 +146,6 @@ def test_can_handle_error_on_decrypt(self):
         resp = self.client.post('/variable/add',
                                 data=self.variable,
                                 follow_redirects=True)
-        self.assertEqual(resp.status_code, 200)
-        v = self.session.query(models.Variable).first()
-        self.assertEqual(v.key, 'test_key')
-        self.assertEqual(v.val, 'text_val')
 
         # update the variable with a wrong value, given that is encrypted
         Var = models.Variable
@@ -268,6 +272,8 @@ class TestAirflowBaseViews(TestBase):
 
     def setUp(self):
         super(TestAirflowBaseViews, self).setUp()
+        self.logout()
+        self.login()
         self.cleanup_dagruns()
         self.prepare_dagruns()
 
@@ -312,7 +318,7 @@ def test_index(self):
         self.check_content_in_response('DAGs', resp)
 
     def test_health(self):
-        resp = self.client.get('health')
+        resp = self.client.get('health', follow_redirects=True)
         self.check_content_in_response('The server is healthy!', resp)
 
     def test_home(self):
@@ -381,7 +387,7 @@ def test_tries(self):
         self.check_content_in_response('example_bash_operator', resp)
 
     def test_landing_times(self):
-        url = 'landing_times?days=30&dag_id=test_example_bash_operator'
+        url = 'landing_times?days=30&dag_id=example_bash_operator'
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('example_bash_operator', resp)
 
@@ -471,6 +477,7 @@ def test_configuration_expose_config(self):
         self.logout()
         self.login()
         conf.set("webserver", "expose_config", "True")
+
         resp = self.client.get('configuration', follow_redirects=True)
         self.check_content_in_response(
             ['Airflow Configuration', 'Running Configuration'], resp)
@@ -493,6 +500,7 @@ def setUp(self):
         current_dir = os.path.dirname(os.path.abspath(__file__))
         logging_config['handlers']['task']['base_log_folder'] = os.path.normpath(
             os.path.join(current_dir, 'test_logs'))
+
         logging_config['handlers']['task']['filename_template'] = \
             '{{ ti.dag_id }}/{{ ti.task_id }}/' \
             '{{ ts | replace(":", ".") }}/{{ try_number }}.log'
@@ -506,11 +514,12 @@ def setUp(self):
         sys.path.append(self.settings_folder)
         conf.set('core', 'logging_config_class', 'airflow_local_settings.LOGGING_CONFIG')
 
-        self.app, self.appbuilder = application.create_app(testing=True)
+        self.app, self.appbuilder = application.create_app(session=Session, testing=True)
         self.app.config['WTF_CSRF_ENABLED'] = False
         self.client = self.app.test_client()
+        settings.configure_orm()
+        self.session = Session
         self.login()
-        self.session = Session()
 
         from airflow.www_rbac.views import dagbag
         dag = DAG(self.DAG_ID, start_date=self.DEFAULT_DATE)
@@ -533,9 +542,9 @@ def tearDown(self):
 
     def test_get_file_task_log(self):
         response = self.client.get(
-            TestLogView.ENDPOINT,
-            follow_redirects=True,
-        )
+            TestLogView.ENDPOINT, data=dict(
+                username='test',
+                password='test'), follow_redirects=True)
         self.assertEqual(response.status_code, 200)
         self.assertIn('Log by attempts',
                       response.data.decode('utf-8'))
@@ -549,7 +558,10 @@ def test_get_logs_with_metadata(self):
                                                 self.TASK_ID,
                                                 quote_plus(self.DEFAULT_DATE.isoformat()),
                                                 1,
-                                                json.dumps({})), follow_redirects=True)
+                                                json.dumps({})), data=dict(
+                                                    username='test',
+                                                    password='test'),
+                            follow_redirects=True)
 
         self.assertIn('"message":', response.data.decode('utf-8'))
         self.assertIn('"metadata":', response.data.decode('utf-8'))
@@ -564,7 +576,10 @@ def test_get_logs_with_null_metadata(self):
             self.client.get(url_template.format(self.DAG_ID,
                                                 self.TASK_ID,
                                                 quote_plus(self.DEFAULT_DATE.isoformat()),
-                                                1), follow_redirects=True)
+                                                1), data=dict(
+                                                    username='test',
+                                                    password='test'),
+                            follow_redirects=True)
 
         self.assertIn('"message":', response.data.decode('utf-8'))
         self.assertIn('"metadata":', response.data.decode('utf-8'))
@@ -574,7 +589,10 @@ def test_get_logs_with_null_metadata(self):
 
 class TestVersionView(TestBase):
     def test_version(self):
-        resp = self.client.get('version', follow_redirects=True)
+        resp = self.client.get('version', data=dict(
+            username='test',
+            password='test'
+        ), follow_redirects=True)
         self.check_content_in_response('Version Info', resp)
 
 
@@ -638,8 +656,9 @@ def test_with_default_parameters(self):
         Should set base date to current date (not asserted)
         """
         response = self.test.client.get(
-            self.endpoint
-        )
+            self.endpoint, data=dict(
+                username='test',
+                password='test'), follow_redirects=True)
         self.test.assertEqual(response.status_code, 200)
         data = response.data.decode('utf-8')
         self.test.assertIn('Base date:', data)
@@ -659,7 +678,11 @@ def test_with_execution_date_parameter_only(self):
         """
         response = self.test.client.get(
             self.endpoint + '&execution_date={}'.format(
-                self.runs[1].execution_date.isoformat())
+                self.runs[1].execution_date.isoformat()),
+            data=dict(
+                username='test',
+                password='test'
+            ), follow_redirects=True
         )
         self.test.assertEqual(response.status_code, 200)
         data = response.data.decode('utf-8')
@@ -682,7 +705,11 @@ def test_with_base_date_and_num_runs_parmeters_only(self):
         """
         response = self.test.client.get(
             self.endpoint + '&base_date={}&num_runs=2'.format(
-                self.runs[1].execution_date.isoformat())
+                self.runs[1].execution_date.isoformat()),
+            data=dict(
+                username='test',
+                password='test'
+            ), follow_redirects=True
         )
         self.test.assertEqual(response.status_code, 200)
         data = response.data.decode('utf-8')
@@ -704,7 +731,11 @@ def test_with_base_date_and_num_runs_and_execution_date_outside(self):
         response = self.test.client.get(
             self.endpoint + '&base_date={}&num_runs=42&execution_date={}'.format(
                 self.runs[1].execution_date.isoformat(),
-                self.runs[0].execution_date.isoformat())
+                self.runs[0].execution_date.isoformat()),
+            data=dict(
+                username='test',
+                password='test'
+            ), follow_redirects=True
         )
         self.test.assertEqual(response.status_code, 200)
         data = response.data.decode('utf-8')
@@ -726,7 +757,11 @@ def test_with_base_date_and_num_runs_and_execution_date_within(self):
         response = self.test.client.get(
             self.endpoint + '&base_date={}&num_runs=5&execution_date={}'.format(
                 self.runs[2].execution_date.isoformat(),
-                self.runs[3].execution_date.isoformat())
+                self.runs[3].execution_date.isoformat()),
+            data=dict(
+                username='test',
+                password='test'
+            ), follow_redirects=True
         )
         self.test.assertEqual(response.status_code, 200)
         data = response.data.decode('utf-8')
@@ -815,20 +850,7 @@ def test_dt_nr_dr_form_with_base_date_and_num_runs_and_execution_date_within(sel
         self.tester.test_with_base_date_and_num_runs_and_execution_date_within()
 
 
-class TestTaskInstanceView(TestBase):
-    TI_ENDPOINT = '/taskinstance/list/?_flt_0_execution_date={}'
-
-    def test_start_date_filter(self):
-        resp = self.client.get(self.TI_ENDPOINT.format(
-            self.percent_encode('2018-10-09 22:44:31')))
-        # We aren't checking the logic of the date filter itself (that is built
-        # in to FAB) but simply that our UTC conversion was run - i.e. it
-        # doesn't blow up!
-        self.check_content_in_response('List Task Instance', resp)
-        pass
-
-
-class TestLogViewPermission(TestBase):
+class TestDagACLView(TestBase):
     """
     Test Airflow DAG acl
     """
@@ -837,7 +859,7 @@ class TestLogViewPermission(TestBase):
 
     @classmethod
     def setUpClass(cls):
-        super(TestLogViewPermission, cls).setUpClass()
+        super(TestDagACLView, cls).setUpClass()
 
     def cleanup_dagruns(self):
         DR = models.DagRun
@@ -868,71 +890,464 @@ def prepare_dagruns(self):
             state=State.RUNNING)
 
     def setUp(self):
-        super(TestLogViewPermission, self).setUp()
+        super(TestDagACLView, self).setUp()
         self.cleanup_dagruns()
         self.prepare_dagruns()
         self.logout()
+        self.appbuilder.sm.sync_roles()
+        self.add_permission_for_role()
 
     def login(self, username=None, password=None):
         role_admin = self.appbuilder.sm.find_role('Admin')
-        tester = self.appbuilder.sm.find_user(username='test_admin')
+        tester = self.appbuilder.sm.find_user(username='test')
         if not tester:
             self.appbuilder.sm.add_user(
-                username='test_admin',
-                first_name='test_admin',
-                last_name='test_admin',
-                email='test_admin@fab.org',
+                username='test',
+                first_name='test',
+                last_name='test',
+                email='test@fab.org',
                 role=role_admin,
-                password='test_admin')
+                password='test')
 
-        role_user = self.appbuilder.sm.find_role('User')
-        test_user = self.appbuilder.sm.find_user(username='test_user')
-        if not test_user:
+        dag_acl_role = self.appbuilder.sm.add_role('dag_acl_tester')
+        dag_tester = self.appbuilder.sm.find_user(username='dag_tester')
+        if not dag_tester:
+            self.appbuilder.sm.add_user(
+                username='dag_tester',
+                first_name='dag_test',
+                last_name='dag_test',
+                email='dag_test@fab.org',
+                role=dag_acl_role,
+                password='dag_test')
+
+        # create an user without permission
+        dag_no_role = self.appbuilder.sm.add_role('dag_acl_faker')
+        dag_faker = self.appbuilder.sm.find_user(username='dag_faker')
+        if not dag_faker:
+            self.appbuilder.sm.add_user(
+                username='dag_faker',
+                first_name='dag_faker',
+                last_name='dag_faker',
+                email='dag_fake@fab.org',
+                role=dag_no_role,
+                password='dag_faker')
+
+        # create an user with only read permission
+        dag_read_only_role = self.appbuilder.sm.add_role('dag_acl_read_only')
+        dag_read_only = self.appbuilder.sm.find_user(username='dag_read_only')
+        if not dag_read_only:
+            self.appbuilder.sm.add_user(
+                username='dag_read_only',
+                first_name='dag_read_only',
+                last_name='dag_read_only',
+                email='dag_read_only@fab.org',
+                role=dag_read_only_role,
+                password='dag_read_only')
+
+        # create an user that has all dag access
+        all_dag_role = self.appbuilder.sm.add_role('all_dag_role')
+        all_dag_tester = self.appbuilder.sm.find_user(username='all_dag_user')
+        if not all_dag_tester:
             self.appbuilder.sm.add_user(
-                username='test_user',
-                first_name='test_user',
-                last_name='test_user',
-                email='test_user@fab.org',
-                role=role_user,
-                password='test_user')
+                username='all_dag_user',
+                first_name='all_dag_user',
+                last_name='all_dag_user',
+                email='all_dag_user@fab.org',
+                role=all_dag_role,
+                password='all_dag_user')
+
+        user = username if username else 'dag_tester'
+        passwd = password if password else 'dag_test'
 
         return self.client.post('/login/', data=dict(
-            username=username,
-            password=password
+            username=user,
+            password=passwd
         ))
 
     def logout(self):
         return self.client.get('/logout/')
 
-    def test_log_success_for_admin(self):
+    def add_permission_for_role(self):
+        self.logout()
+        self.login(username='test',
+                   password='test')
+        perm_on_dag = self.appbuilder.sm.\
+            find_permission_view_menu('can_dag_edit', 'example_bash_operator')
+        dag_tester_role = self.appbuilder.sm.find_role('dag_acl_tester')
+        self.appbuilder.sm.add_permission_role(dag_tester_role, perm_on_dag)
+
+        perm_on_all_dag = self.appbuilder.sm.\
+            find_permission_view_menu('can_dag_edit', 'all_dags')
+        all_dag_role = self.appbuilder.sm.find_role('all_dag_role')
+        self.appbuilder.sm.add_permission_role(all_dag_role, perm_on_all_dag)
+
+        read_only_perm_on_dag = self.appbuilder.sm.\
+            find_permission_view_menu('can_dag_read', 'example_bash_operator')
+        dag_read_only_role = self.appbuilder.sm.find_role('dag_acl_read_only')
+        self.appbuilder.sm.add_permission_role(dag_read_only_role, read_only_perm_on_dag)
+
+    def test_permission_exist(self):
+        self.logout()
+        self.login(username='test',
+                   password='test')
+        test_view_menu = self.appbuilder.sm.find_view_menu('example_bash_operator')
+        perms_views = self.appbuilder.sm.find_permissions_view_menu(test_view_menu)
+        self.assertEqual(len(perms_views), 2)
+        # each dag view will create one write, and one read permission
+        self.assertTrue(str(perms_views[0]).startswith('can dag'))
+        self.assertTrue(str(perms_views[1]).startswith('can dag'))
+
+    def test_role_permission_associate(self):
+        self.logout()
+        self.login(username='test',
+                   password='test')
+        test_role = self.appbuilder.sm.find_role('dag_acl_tester')
+        perms = set([str(perm) for perm in test_role.permissions])
+        self.assertIn('can dag edit on example_bash_operator', perms)
+        self.assertNotIn('can dag read on example_bash_operator', perms)
+
+    def test_index_success(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('/', follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_index_failure(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('/', follow_redirects=True)
+        # The user can only access/view example_bash_operator dag.
+        self.check_content_not_in_response('example_subdag_operator', resp)
+
+    def test_index_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        resp = self.client.get('/', follow_redirects=True)
+        # The all dag user can access/view all dags.
+        self.check_content_in_response('example_subdag_operator', resp)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_dag_stats_success(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('dag_stats', follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_dag_stats_failure(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('dag_stats', follow_redirects=True)
+        self.check_content_not_in_response('example_subdag_operator', resp)
+
+    def test_dag_stats_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        resp = self.client.get('dag_stats', follow_redirects=True)
+        self.check_content_in_response('example_subdag_operator', resp)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_task_stats_success(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('task_stats', follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_task_stats_failure(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('task_stats', follow_redirects=True)
+        self.check_content_not_in_response('example_subdag_operator', resp)
+
+    def test_task_stats_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        resp = self.client.get('task_stats', follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+        self.check_content_in_response('example_subdag_operator', resp)
+
+    def test_code_success(self):
+        self.logout()
+        self.login()
+        url = 'code?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_code_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = 'code?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('example_bash_operator', resp)
+
+    def test_code_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = 'code?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+        url = 'code?dag_id=example_subdag_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_subdag_operator', resp)
+
+    def test_dag_details_success(self):
+        self.logout()
+        self.login()
+        url = 'dag_details?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('DAG details', resp)
+
+    def test_dag_details_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = 'dag_details?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('DAG details', resp)
+
+    def test_dag_details_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = 'dag_details?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+        url = 'dag_details?dag_id=example_subdag_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_subdag_operator', resp)
+
+    def test_pickle_info_success(self):
+        self.logout()
+        self.login()
+        url = 'pickle_info?dag_id=example_bash_operator'
+        resp = self.client.get(url, follow_redirects=True)
+        self.assertEqual(resp.status_code, 200)
+
+    def test_rendered_success(self):
+        self.logout()
+        self.login()
+        url = ('rendered?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Rendered Template', resp)
+
+    def test_rendered_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = ('rendered?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('Rendered Template', resp)
+
+    def test_rendered_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = ('rendered?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Rendered Template', resp)
+
+    def test_task_success(self):
+        self.logout()
+        self.login()
+        url = ('task?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Task Instance Details', resp)
+
+    def test_task_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = ('task?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('Task Instance Details', resp)
+
+    def test_task_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = ('task?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Task Instance Details', resp)
+
+    def test_xcom_success(self):
+        self.logout()
+        self.login()
+        url = ('xcom?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('XCom', resp)
+
+    def test_xcom_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = ('xcom?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('XCom', resp)
+
+    def test_xcom_success_for_all_dag_user(self):
         self.logout()
-        self.login(username='test_admin',
-                   password='test_admin')
-        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = ('xcom?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
                .format(self.percent_encode(self.default_date)))
         resp = self.client.get(url, follow_redirects=True)
-        self.check_content_in_response('Log by attempts', resp)
-        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
-               'execution_date={}&try_number=1&metadata=null'
+        self.check_content_in_response('XCom', resp)
+
+    def test_run_success(self):
+        self.logout()
+        self.login()
+        url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
+               'ignore_ti_state=true&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url)
+        self.check_content_in_response('', resp, resp_code=302)
+
+    def test_run_success_for_all_dag_user(self):
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
+        url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
+               'ignore_ti_state=true&execution_date={}'
                .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url)
+        self.check_content_in_response('', resp, resp_code=302)
+
+    def test_blocked_success(self):
+        url = 'blocked'
+        self.logout()
+        self.login()
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_blocked_success_for_all_dag_user(self):
+        url = 'blocked'
+        self.logout()
+        self.login(username='all_dag_user',
+                   password='all_dag_user')
         resp = self.client.get(url, follow_redirects=True)
-        self.check_content_in_response('"message":', resp)
-        self.check_content_in_response('"metadata":', resp)
+        self.check_content_in_response('example_bash_operator', resp)
+        self.check_content_in_response('example_subdag_operator', resp)
 
-    def test_log_success_for_user(self):
+    def test_failed_success(self):
         self.logout()
-        self.login(username='test_user',
-                   password='test_user')
-        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+        self.login()
+        url = ('failed?task_id=run_this_last&dag_id=example_bash_operator&'
+               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
                .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url)
+        self.check_content_in_response('Redirecting', resp, 302)
+
+    def test_duration_success(self):
+        url = 'duration?days=30&dag_id=example_bash_operator'
+        self.logout()
+        self.login()
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_duration_failure(self):
+        url = 'duration?days=30&dag_id=example_bash_operator'
+        self.logout()
+        # login as an user without permissions
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('example_bash_operator', resp)
+
+    def test_tries_success(self):
+        url = 'tries?days=30&dag_id=example_bash_operator'
+        self.logout()
+        self.login()
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_tries_failure(self):
+        url = 'tries?days=30&dag_id=example_bash_operator'
+        self.logout()
+        # login as an user without permissions
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('example_bash_operator', resp)
+
+    def test_landing_times_success(self):
+        url = 'landing_times?days=30&dag_id=example_bash_operator'
+        self.logout()
+        self.login()
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_landing_times_failure(self):
+        url = 'landing_times?days=30&dag_id=example_bash_operator'
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
         resp = self.client.get(url, follow_redirects=True)
-        self.check_content_in_response('Log by attempts', resp)
-        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
-               'execution_date={}&try_number=1&metadata=null'
+        self.check_content_not_in_response('example_bash_operator', resp)
+
+    def test_paused_success(self):
+        # post request failure won't test
+        url = 'paused?dag_id=example_bash_operator&is_paused=false'
+        self.logout()
+        self.login()
+        resp = self.client.post(url, follow_redirects=True)
+        self.check_content_in_response('OK', resp)
+
+    def test_refresh_success(self):
+        self.logout()
+        self.login()
+        resp = self.client.get('refresh?dag_id=example_bash_operator')
+        self.check_content_in_response('', resp, resp_code=302)
+
+    def test_gantt_success(self):
+        url = 'gantt?dag_id=example_bash_operator'
+        self.logout()
+        self.login()
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('example_bash_operator', resp)
+
+    def test_gantt_failure(self):
+        url = 'gantt?dag_id=example_bash_operator'
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('example_bash_operator', resp)
+
+    def test_success_fail_for_read_only_role(self):
+        # succcess endpoint need can_dag_edit, which read only role can not access
+        self.logout()
+        self.login(username='dag_read_only',
+                   password='dag_read_only')
+
+        url = ('success?task_id=run_this_last&dag_id=example_bash_operator&'
+               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
                .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url)
+        self.check_content_not_in_response('Wait a minute', resp, resp_code=302)
+
+    def test_tree_success_for_read_only_role(self):
+        # tree view only allows can_dag_read, which read only role could access
+        self.logout()
+        self.login(username='dag_read_only',
+                   password='dag_read_only')
+
+        url = 'tree?dag_id=example_bash_operator'
         resp = self.client.get(url, follow_redirects=True)
-        self.check_content_in_response('"message":', resp)
-        self.check_content_in_response('"metadata":', resp)
+        self.check_content_in_response('runme_1', resp)
 
 
 if __name__ == '__main__':

From 98cacb7c28461acb5250948426afbbb46ca64feb Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Tue, 17 Jul 2018 13:52:28 +0100
Subject: [PATCH 356/808] [AIRFLOW-2750] Add subcommands to delete and list
 users

Currently, adding user is the only
operation that CLI has on RBAC.
This PR adds functionality to delete
and list users via CLI.

Closes #3610 from sekikn/AIRFLOW-2750
---
 airflow/bin/cli.py | 49 +++++++++++++++++++++++++++++++++++++++++-----
 tests/core.py      | 26 ++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 5 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 6cf7ea1f00c65..d7b553283b931 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1349,6 +1349,37 @@ def create_user(args):
         raise SystemExit('Failed to create user.')
 
 
+@cli_utils.action_logging
+def delete_user(args):
+    if not args.username:
+        raise SystemExit('Required arguments are missing: username')
+
+    appbuilder = cached_appbuilder()
+
+    try:
+        u = next(u for u in appbuilder.sm.get_all_users() if u.username == args.username)
+    except StopIteration:
+        raise SystemExit('{} is not a valid user.'.format(args.username))
+
+    if appbuilder.sm.del_register_user(u):
+        print('User {} deleted.'.format(args.username))
+    else:
+        raise SystemExit('Failed to delete user.')
+
+
+@cli_utils.action_logging
+def list_users(args):
+    appbuilder = cached_appbuilder()
+    users = appbuilder.sm.get_all_users()
+    fields = ['id', 'username', 'email', 'first_name', 'last_name', 'roles']
+    users = [[user.__getattribute__(field) for field in fields] for user in users]
+    msg = tabulate(users, [field.capitalize().replace('_', ' ') for field in fields],
+                   tablefmt="fancy_grid")
+    if sys.version_info[0] < 3:
+        msg = msg.encode('utf-8')
+    print(msg)
+
+
 @cli_utils.action_logging
 def list_dag_runs(args, dag=None):
     if dag:
@@ -1459,6 +1490,10 @@ class CLIFactory(object):
             "Do not prompt to confirm reset. Use with care!",
             "store_true",
             default=False),
+        'username': Arg(
+            ('-u', '--username',),
+            help='Username of the user',
+            type=str),
 
         # list_dag_runs
         'no_backfill': Arg(
@@ -1838,10 +1873,6 @@ class CLIFactory(object):
             ('-e', '--email',),
             help='Email of the user',
             type=str),
-        'username': Arg(
-            ('-u', '--username',),
-            help='Username of the user',
-            type=str),
         'password': Arg(
             ('-p', '--password',),
             help='Password of the user',
@@ -2009,9 +2040,17 @@ class CLIFactory(object):
                      'conn_id', 'conn_uri', 'conn_extra') + tuple(alternative_conn_specs),
         }, {
             'func': create_user,
-            'help': "Create an admin account",
+            'help': "Create an account for the Web UI",
             'args': ('role', 'username', 'email', 'firstname', 'lastname',
                      'password', 'use_random_password'),
+        }, {
+            'func': delete_user,
+            'help': "Delete an account for the Web UI",
+            'args': ('username',),
+        }, {
+            'func': list_users,
+            'help': "List accounts for the Web UI",
+            'args': tuple(),
         },
         {
             'func': sync_perm,
diff --git a/tests/core.py b/tests/core.py
index d64c9939bf814..c3ae9e1c66c94 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1153,6 +1153,32 @@ def test_cli_create_user_supplied_password(self):
         ])
         cli.create_user(args)
 
+    def test_cli_delete_user(self):
+        args = self.parser.parse_args([
+            'create_user', '-u', 'test3', '-l', 'doe', '-f', 'jon',
+            '-e', 'jdoe@example.com', '-r', 'Viewer', '--use_random_password'
+        ])
+        cli.create_user(args)
+        args = self.parser.parse_args([
+            'delete_user', '-u', 'test3',
+        ])
+        cli.delete_user(args)
+
+    def test_cli_list_users(self):
+        for i in range(0, 3):
+            args = self.parser.parse_args([
+                'create_user', '-u', 'user{}'.format(i), '-l', 'doe', '-f', 'jon',
+                '-e', 'jdoe+{}@gmail.com'.format(i), '-r', 'Viewer',
+                '--use_random_password'
+            ])
+            cli.create_user(args)
+        with mock.patch('sys.stdout',
+                        new_callable=six.StringIO) as mock_stdout:
+            cli.list_users(self.parser.parse_args(['list_users']))
+            stdout = mock_stdout.getvalue()
+        for i in range(0, 3):
+            self.assertIn('user{}'.format(i), stdout)
+
     def test_cli_sync_perm(self):
         # test whether sync_perm cli will throw exceptions or not
         args = self.parser.parse_args([

From 4958d26a0a76e9a3958feca35bf17966a2746921 Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Tue, 24 Jul 2018 01:07:15 +0100
Subject: [PATCH 357/808] [AIRFLOW-2615] Limit DAGs parsing to once only

Closes #3614 from verdan/double-dag-parsing
---
 airflow/bin/cli.py        | 2 ++
 airflow/www_rbac/views.py | 5 ++++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index d7b553283b931..d8afc00b038c6 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -836,9 +836,11 @@ def webserver(args):
                 port=args.port, host=args.hostname,
                 ssl_context=(ssl_cert, ssl_key) if ssl_cert and ssl_key else None)
     else:
+        os.environ['SKIP_DAGS_PARSING'] = 'True'
         app = cached_app_rbac(conf) if settings.RBAC else cached_app(conf)
         pid, stdout, stderr, log_file = setup_locations(
             "webserver", args.pid, args.stdout, args.stderr, args.log_file)
+        os.environ.pop('SKIP_DAGS_PARSING')
         if args.daemon:
             handle = setup_logging(log_file)
             stdout = open(stdout, 'w+')
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 8a8fc03040283..b5a3336468ffc 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -73,7 +73,10 @@
 
 
 PAGE_SIZE = conf.getint('webserver', 'page_size')
-dagbag = models.DagBag(settings.DAGS_FOLDER)
+if os.environ.get('SKIP_DAGS_PARSING') != 'True':
+    dagbag = models.DagBag(settings.DAGS_FOLDER)
+else:
+    dagbag = models.DagBag
 
 
 def get_date_time_num_runs_dag_runs_form_data(request, session, dag):

From 542e0acf5823b31d9fd123b23c55c63853a41a90 Mon Sep 17 00:00:00 2001
From: Giovanni Lanzani <gglanzani@users.noreply.github.com>
Date: Wed, 7 Nov 2018 23:07:48 +0100
Subject: [PATCH 358/808] [AIRFLOW-2698] Simplify Kerberos code (#3563)

Some functions were not used. On top of that, the
`principal_from_username` function was getting the wrong config value
("security" instead of "kerberos").

Since the results were only used by `kerberos.checkPassword`, and the
function can cope with needing a realm in the `username` when `realm` is
provided, we removed the `principal_from_username` function altogether.
---
 .../contrib/auth/backends/kerberos_auth.py    | 12 +++++--
 airflow/security/utils.py                     | 33 ++++---------------
 2 files changed, 16 insertions(+), 29 deletions(-)

diff --git a/airflow/contrib/auth/backends/kerberos_auth.py b/airflow/contrib/auth/backends/kerberos_auth.py
index 4b5bb295d9685..d8a2410e74bc8 100644
--- a/airflow/contrib/auth/backends/kerberos_auth.py
+++ b/airflow/contrib/auth/backends/kerberos_auth.py
@@ -19,6 +19,7 @@
 
 import logging
 import flask_login
+from airflow.exceptions import AirflowConfigException
 from flask_login import current_user
 from flask import flash
 from wtforms import (
@@ -58,7 +59,13 @@ def authenticate(username, password):
             utils.get_fqdn()
         )
         realm = configuration.conf.get("kerberos", "default_realm")
-        user_principal = utils.principal_from_username(username)
+
+        try:
+            user_realm = configuration.conf.get("security", "default_realm")
+        except AirflowConfigException:
+            user_realm = realm
+
+        user_principal = utils.principal_from_username(username, user_realm)
 
         try:
             # this is pykerberos specific, verify = True is needed to prevent KDC spoofing
@@ -68,7 +75,8 @@ def authenticate(username, password):
                 raise AuthenticationError()
         except kerberos.KrbError as e:
             logging.error(
-                'Password validation for principal %s failed %s', user_principal, e)
+                'Password validation for user '
+                '%s in realm %s failed %s', user_principal, realm, e)
             raise AuthenticationError(e)
 
         return
diff --git a/airflow/security/utils.py b/airflow/security/utils.py
index 8e4fcbd4bfc0e..cf8ade922b336 100644
--- a/airflow/security/utils.py
+++ b/airflow/security/utils.py
@@ -22,21 +22,6 @@
 
 from airflow.utils.net import get_hostname
 
-# Pattern to replace with hostname
-HOSTNAME_PATTERN = '_HOST'
-
-
-def get_kerberos_principal(principal, host):
-    components = get_components(principal)
-    if not components or len(components) != 3 or components[1] != HOSTNAME_PATTERN:
-        return principal
-    else:
-        if not host:
-            raise IOError("Can't replace %s pattern "
-                          "since host is null." % HOSTNAME_PATTERN)
-        return replace_hostname_pattern(components, host)
-
-
 def get_components(principal):
     """
     get_components(principal) -> (short name, instance (FQDN), realm)
@@ -51,33 +36,27 @@ def get_components(principal):
 def replace_hostname_pattern(components, host=None):
     fqdn = host
     if not fqdn or fqdn == '0.0.0.0':
-        fqdn = get_localhost_name()
+        fqdn = get_hostname()
     return '%s/%s@%s' % (components[0], fqdn.lower(), components[2])
 
 
-def get_localhost_name():
-    return get_hostname()
-
-
 def get_fqdn(hostname_or_ip=None):
     # Get hostname
     try:
         if hostname_or_ip:
             fqdn = socket.gethostbyaddr(hostname_or_ip)[0]
+            if fqdn == 'localhost':
+                fqdn = get_hostname()
         else:
-            fqdn = get_localhost_name()
+            fqdn = get_hostname()
     except IOError:
         fqdn = hostname_or_ip
 
-    if fqdn == 'localhost':
-        fqdn = get_localhost_name()
-
     return fqdn
 
 
-def principal_from_username(username):
-    realm = conf.get("security", "default_realm")
-    if '@' not in username and realm:
+def principal_from_username(username, realm):
+    if ('@' not in username) and realm:
         username = "{}@{}".format(username, realm)
 
     return username

From f177b7fbe02304eaac68a204bd90071bf634136c Mon Sep 17 00:00:00 2001
From: Israel Knight <israel.s.knight@gmail.com>
Date: Thu, 6 Sep 2018 00:07:28 -0700
Subject: [PATCH 359/808] =?UTF-8?q?[AIRFLOW-1998]=20Implemented=20Databric?=
 =?UTF-8?q?ksRunNowOperator=20for=20jobs/run-now=20=E2=80=A6=20(#3813)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add functionality to kick of a Databricks job right away.

* Per feedback: fixed a documentation error,
  reintegrated the execute and on_kill onto the objects.
* Fixed a  documentation issue.
---
 airflow/contrib/hooks/databricks_hook.py      |  13 +
 .../contrib/operators/databricks_operator.py  | 302 ++++++++++++++---
 tests/contrib/hooks/test_databricks_hook.py   |  40 +++
 .../operators/test_databricks_operator.py     | 310 ++++++++++++++----
 4 files changed, 556 insertions(+), 109 deletions(-)

diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index cb2ba9bd00fd7..284db98d91c2e 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -37,6 +37,7 @@
 START_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/start")
 TERMINATE_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/delete")
 
+RUN_NOW_ENDPOINT = ('POST', 'api/2.0/jobs/run-now')
 SUBMIT_RUN_ENDPOINT = ('POST', 'api/2.0/jobs/runs/submit')
 GET_RUN_ENDPOINT = ('GET', 'api/2.0/jobs/runs/get')
 CANCEL_RUN_ENDPOINT = ('POST', 'api/2.0/jobs/runs/cancel')
@@ -161,6 +162,18 @@ def _log_request_error(self, attempt_num, error):
             attempt_num, error
         )
 
+    def run_now(self, json):
+        """
+        Utility function to call the ``api/2.0/jobs/run-now`` endpoint.
+
+        :param json: The data used in the body of the request to the ``run-now`` endpoint.
+        :type json: dict
+        :return: the run_id as a string
+        :rtype: string
+        """
+        response = self._do_api_call(RUN_NOW_ENDPOINT, json)
+        return response['run_id']
+
     def submit_run(self, json):
         """
         Utility function to call the ``api/2.0/jobs/runs/submit`` endpoint.
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 3245a99256502..aed2d8909c76c 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -30,6 +30,66 @@
 XCOM_RUN_PAGE_URL_KEY = 'run_page_url'
 
 
+def _deep_string_coerce(content, json_path='json'):
+    """
+    Coerces content or all values of content if it is a dict to a string. The
+    function will throw if content contains non-string or non-numeric types.
+
+    The reason why we have this function is because the ``self.json`` field must be a
+     dict with only string values. This is because ``render_template`` will fail
+    for numerical values.
+    """
+    c = _deep_string_coerce
+    if isinstance(content, six.string_types):
+        return content
+    elif isinstance(content, six.integer_types + (float,)):
+        # Databricks can tolerate either numeric or string types in the API backend.
+        return str(content)
+    elif isinstance(content, (list, tuple)):
+        return [c(e, '{0}[{1}]'.format(json_path, i)) for i, e in enumerate(content)]
+    elif isinstance(content, dict):
+        return {k: c(v, '{0}[{1}]'.format(json_path, k))
+                for k, v in list(content.items())}
+    else:
+        param_type = type(content)
+        msg = 'Type {0} used for parameter {1} is not a number or a string' \
+            .format(param_type, json_path)
+        raise AirflowException(msg)
+
+
+def _handle_databricks_operator_execution(operator, hook, log, context):
+    """
+    Handles the Airflow + Databricks lifecycle logic for a Databricks operator
+    :param operator: Databricks operator being handled
+    :param context: Airflow context
+    """
+    if operator.do_xcom_push:
+        context['ti'].xcom_push(key=XCOM_RUN_ID_KEY, value=operator.run_id)
+    log.info('Run submitted with run_id: %s', operator.run_id)
+    run_page_url = hook.get_run_page_url(operator.run_id)
+    if operator.do_xcom_push:
+        context['ti'].xcom_push(key=XCOM_RUN_PAGE_URL_KEY, value=run_page_url)
+
+    log.info('View run status, Spark UI, and logs at %s', run_page_url)
+    while True:
+        run_state = hook.get_run_state(operator.run_id)
+        if run_state.is_terminal:
+            if run_state.is_successful:
+                log.info('%s completed successfully.', operator.task_id)
+                log.info('View run status, Spark UI, and logs at %s', run_page_url)
+                return
+            else:
+                error_message = '{t} failed with terminal state: {s}'.format(
+                    t=operator.task_id,
+                    s=run_state)
+                raise AirflowException(error_message)
+        else:
+            log.info('%s in run state: %s', operator.task_id, run_state)
+            log.info('View run status, Spark UI, and logs at %s', run_page_url)
+            log.info('Sleeping for %s seconds.', operator.polling_period_seconds)
+            time.sleep(operator.polling_period_seconds)
+
+
 class DatabricksSubmitRunOperator(BaseOperator):
     """
     Submits an Spark job run to Databricks using the
@@ -200,39 +260,202 @@ def __init__(
         if 'run_name' not in self.json:
             self.json['run_name'] = run_name or kwargs['task_id']
 
-        self.json = self._deep_string_coerce(self.json)
+        self.json = _deep_string_coerce(self.json)
         # This variable will be used in case our task gets killed.
         self.run_id = None
         self.do_xcom_push = do_xcom_push
 
-    def _deep_string_coerce(self, content, json_path='json'):
-        """
-        Coerces content or all values of content if it is a dict to a string. The
-        function will throw if content contains non-string or non-numeric types.
+    def get_hook(self):
+        return DatabricksHook(
+            self.databricks_conn_id,
+            retry_limit=self.databricks_retry_limit,
+            retry_delay=self.databricks_retry_delay)
+
+    def execute(self, context):
+        hook = self.get_hook()
+        self.run_id = hook.submit_run(self.json)
+        _handle_databricks_operator_execution(self, hook, self.log, context)
+
+    def on_kill(self):
+        hook = self.get_hook()
+        hook.cancel_run(self.run_id)
+        self.log.info(
+            'Task: %s with run_id: %s was requested to be cancelled.',
+            self.task_id, self.run_id
+        )
+
+
+class DatabricksRunNowOperator(BaseOperator):
+    """
+    Runs an existing Spark job run to Databricks using the
+    `api/2.0/jobs/run-now
+    <https://docs.databricks.com/api/latest/jobs.html#run-now>`_
+    API endpoint.
+
+    There are two ways to instantiate this operator.
+
+    In the first way, you can take the JSON payload that you typically use
+    to call the ``api/2.0/jobs/run-now`` endpoint and pass it directly
+    to our ``DatabricksRunNowOperator`` through the ``json`` parameter.
+    For example ::
+        json = {
+          "job_id": 42,
+          "notebook_params": {
+            "dry-run": "true",
+            "oldest-time-to-consider": "1457570074236"
+          }
+        }
+
+        notebook_run = DatabricksRunNowOperator(task_id='notebook_run', json=json)
+
+    Another way to accomplish the same thing is to use the named parameters
+    of the ``DatabricksRunNowOperator`` directly. Note that there is exactly
+    one named parameter for each top level parameter in the ``run-now``
+    endpoint. In this method, your code would look like this: ::
+
+        job_id=42
+
+        notebook_params = {
+            "dry-run": "true",
+            "oldest-time-to-consider": "1457570074236"
+        }
+
+        python_params = ["douglas adams", "42"]
+
+        spark_submit_params = ["--class", "org.apache.spark.examples.SparkPi"]
+
+        notebook_run = DatabricksRunNowOperator(
+            job_id=job_id,
+            notebook_params=notebook_params,
+            python_params=python_params,
+            spark_submit_params=spark_submit_params
+        )
+
+    In the case where both the json parameter **AND** the named parameters
+    are provided, they will be merged together. If there are conflicts during the merge,
+    the named parameters will take precedence and override the top level ``json`` keys.
+
+    Currently the named parameters that ``DatabricksRunNowOperator`` supports are
+        - ``job_id``
+        - ``json``
+        - ``notebook_params``
+        - ``python_params``
+        - ``spark_submit_params``
+
+
+    :param job_id: the job_id of the existing Databricks job.
+        This field will be templated.
+        .. seealso::
+            https://docs.databricks.com/api/latest/jobs.html#run-now
+    :type job_id: string
+    :param json: A JSON object containing API parameters which will be passed
+        directly to the ``api/2.0/jobs/run-now`` endpoint. The other named parameters
+        (i.e. ``notebook_params``, ``spark_submit_params``..) to this operator will
+        be merged with this json dictionary if they are provided.
+        If there are conflicts during the merge, the named parameters will
+        take precedence and override the top level json keys. (templated)
+
+        .. seealso::
+            For more information about templating see :ref:`jinja-templating`.
+            https://docs.databricks.com/api/latest/jobs.html#run-now
+    :type json: dict
+    :param notebook_params: A dict from keys to values for jobs with notebook task,
+        e.g. "notebook_params": {"name": "john doe", "age":  "35"}.
+        The map is passed to the notebook and will be accessible through the
+        dbutils.widgets.get function. See Widgets for more information.
+        If not specified upon run-now, the triggered run will use the
+        job’s base parameters. notebook_params cannot be
+        specified in conjunction with jar_params. The json representation
+        of this field (i.e. {"notebook_params":{"name":"john doe","age":"35"}})
+        cannot exceed 10,000 bytes.
+        This field will be templated.
+
+        .. seealso::
+            https://docs.databricks.com/user-guide/notebooks/widgets.html
+    :type notebook_params: dict
+    :param python_params: A list of parameters for jobs with python tasks,
+        e.g. "python_params": ["john doe", "35"].
+        The parameters will be passed to python file as command line parameters.
+        If specified upon run-now, it would overwrite the parameters specified in
+        job setting.
+        The json representation of this field (i.e. {"python_params":["john doe","35"]})
+        cannot exceed 10,000 bytes.
+        This field will be templated.
+
+        .. seealso::
+            https://docs.databricks.com/api/latest/jobs.html#run-now
+    :type python_params: array of strings
+    :param spark_submit_params: A list of parameters for jobs with spark submit task,
+        e.g. "spark_submit_params": ["--class", "org.apache.spark.examples.SparkPi"].
+        The parameters will be passed to spark-submit script as command line parameters.
+        If specified upon run-now, it would overwrite the parameters specified
+        in job setting.
+        The json representation of this field cannot exceed 10,000 bytes.
+        This field will be templated.
+        .. seealso::
+            https://docs.databricks.com/api/latest/jobs.html#run-now
+    :type spark_submit_params: array of strings
+    :param timeout_seconds: The timeout for this run. By default a value of 0 is used
+        which means to have no timeout.
+        This field will be templated.
+    :type timeout_seconds: int32
+    :param databricks_conn_id: The name of the Airflow connection to use.
+        By default and in the common case this will be ``databricks_default``. To use
+        token based authentication, provide the key ``token`` in the extra field for the
+        connection.
+    :type databricks_conn_id: string
+    :param polling_period_seconds: Controls the rate which we poll for the result of
+        this run. By default the operator will poll every 30 seconds.
+    :type polling_period_seconds: int
+    :param databricks_retry_limit: Amount of times retry if the Databricks backend is
+        unreachable. Its value must be greater than or equal to 1.
+    :type databricks_retry_limit: int
+    :param do_xcom_push: Whether we should push run_id and run_page_url to xcom.
+    :type do_xcom_push: boolean
+    """
+    # Used in airflow.models.BaseOperator
+    template_fields = ('json',)
+    # Databricks brand color (blue) under white text
+    ui_color = '#1CB1C2'
+    ui_fgcolor = '#fff'
+
+    def __init__(
+            self,
+            job_id,
+            json=None,
+            notebook_params=None,
+            python_params=None,
+            spark_submit_params=None,
+            databricks_conn_id='databricks_default',
+            polling_period_seconds=30,
+            databricks_retry_limit=3,
+            databricks_retry_delay=1,
+            do_xcom_push=False,
+            **kwargs):
 
-        The reason why we have this function is because the ``self.json`` field must be a
-         dict with only string values. This is because ``render_template`` will fail
-        for numerical values.
         """
-        c = self._deep_string_coerce
-        if isinstance(content, six.string_types):
-            return content
-        elif isinstance(content, six.integer_types + (float,)):
-            # Databricks can tolerate either numeric or string types in the API backend.
-            return str(content)
-        elif isinstance(content, (list, tuple)):
-            return [c(e, '{0}[{1}]'.format(json_path, i)) for i, e in enumerate(content)]
-        elif isinstance(content, dict):
-            return {k: c(v, '{0}[{1}]'.format(json_path, k))
-                    for k, v in list(content.items())}
-        else:
-            param_type = type(content)
-            msg = 'Type {0} used for parameter {1} is not a number or a string'\
-                .format(param_type, json_path)
-            raise AirflowException(msg)
+        Creates a new ``DatabricksRunNowOperator``.
+        """
+        super(DatabricksRunNowOperator, self).__init__(**kwargs)
+        self.json = json or {}
+        self.databricks_conn_id = databricks_conn_id
+        self.polling_period_seconds = polling_period_seconds
+        self.databricks_retry_limit = databricks_retry_limit
+        self.databricks_retry_delay = databricks_retry_delay
 
-    def _log_run_page_url(self, url):
-        self.log.info('View run status, Spark UI, and logs at %s', url)
+        if job_id is not None:
+            self.json['job_id'] = job_id
+        if notebook_params is not None:
+            self.json['notebook_params'] = notebook_params
+        if python_params is not None:
+            self.json['python_params'] = python_params
+        if spark_submit_params is not None:
+            self.json['spark_submit_params'] = spark_submit_params
+
+        self.json = _deep_string_coerce(self.json)
+        # This variable will be used in case our task gets killed.
+        self.run_id = None
+        self.do_xcom_push = do_xcom_push
 
     def get_hook(self):
         return DatabricksHook(
@@ -242,31 +465,8 @@ def get_hook(self):
 
     def execute(self, context):
         hook = self.get_hook()
-        self.run_id = hook.submit_run(self.json)
-        if self.do_xcom_push:
-            context['ti'].xcom_push(key=XCOM_RUN_ID_KEY, value=self.run_id)
-        self.log.info('Run submitted with run_id: %s', self.run_id)
-        run_page_url = hook.get_run_page_url(self.run_id)
-        if self.do_xcom_push:
-            context['ti'].xcom_push(key=XCOM_RUN_PAGE_URL_KEY, value=run_page_url)
-        self._log_run_page_url(run_page_url)
-        while True:
-            run_state = hook.get_run_state(self.run_id)
-            if run_state.is_terminal:
-                if run_state.is_successful:
-                    self.log.info('%s completed successfully.', self.task_id)
-                    self._log_run_page_url(run_page_url)
-                    return
-                else:
-                    error_message = '{t} failed with terminal state: {s}'.format(
-                        t=self.task_id,
-                        s=run_state)
-                    raise AirflowException(error_message)
-            else:
-                self.log.info('%s in run state: %s', self.task_id, run_state)
-                self._log_run_page_url(run_page_url)
-                self.log.info('Sleeping for %s seconds.', self.polling_period_seconds)
-                time.sleep(self.polling_period_seconds)
+        self.run_id = hook.run_now(self.json)
+        _handle_databricks_operator_execution(self, hook, self.log, context)
 
     def on_kill(self):
         hook = self.get_hook()
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 5c1d7876d2f32..185b6a6f2c8db 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -54,6 +54,7 @@
 }
 CLUSTER_ID = 'cluster_id'
 RUN_ID = 1
+JOB_ID = 42
 HOST = 'xx.cloud.databricks.com'
 HOST_WITH_SCHEME = 'https://xx.cloud.databricks.com'
 LOGIN = 'login'
@@ -70,9 +71,21 @@
         'state_message': STATE_MESSAGE
     }
 }
+NOTEBOOK_PARAMS = {
+    "dry-run": "true",
+    "oldest-time-to-consider": "1457570074236"
+}
+JAR_PARAMS = ["param1", "param2"]
 RESULT_STATE = None
 
 
+def run_now_endpoint(host):
+    """
+    Utility function to generate the run now endpoint given the host.
+    """
+    return 'https://{}/api/2.0/jobs/run-now'.format(host)
+
+
 def submit_run_endpoint(host):
     """
     Utility function to generate the submit run endpoint given the host.
@@ -161,6 +174,7 @@ def setUp(self, session=None):
         conn.host = HOST
         conn.login = LOGIN
         conn.password = PASSWORD
+        conn.extra = None
         session.commit()
 
         self.hook = DatabricksHook(retry_delay=0)
@@ -271,6 +285,32 @@ def test_submit_run(self, mock_requests):
             headers=USER_AGENT_HEADER,
             timeout=self.hook.timeout_seconds)
 
+    @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
+    def test_run_now(self, mock_requests):
+        mock_requests.codes.ok = 200
+        mock_requests.post.return_value.json.return_value = {'run_id': '1'}
+        status_code_mock = mock.PropertyMock(return_value=200)
+        type(mock_requests.post.return_value).status_code = status_code_mock
+        json = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': JAR_PARAMS,
+            'job_id': JOB_ID
+        }
+        run_id = self.hook.run_now(json)
+
+        self.assertEquals(run_id, '1')
+
+        mock_requests.post.assert_called_once_with(
+            run_now_endpoint(HOST),
+            json={
+                'notebook_params': NOTEBOOK_PARAMS,
+                'jar_params': JAR_PARAMS,
+                'job_id': JOB_ID
+            },
+            auth=(LOGIN, PASSWORD),
+            headers=USER_AGENT_HEADER,
+            timeout=self.hook.timeout_seconds)
+
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_get_run_page_url(self, mock_requests):
         mock_requests.get.return_value.json.return_value = GET_RUN_RESPONSE
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index afe1a92f28d9e..5884fc3c98d81 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -23,7 +23,9 @@
 from datetime import datetime
 
 from airflow.contrib.hooks.databricks_hook import RunState
+import airflow.contrib.operators.databricks_operator as databricks_operator
 from airflow.contrib.operators.databricks_operator import DatabricksSubmitRunOperator
+from airflow.contrib.operators.databricks_operator import DatabricksRunNowOperator
 from airflow.exceptions import AirflowException
 from airflow.models import DAG
 
@@ -58,6 +60,40 @@
 EXISTING_CLUSTER_ID = 'existing-cluster-id'
 RUN_NAME = 'run-name'
 RUN_ID = 1
+JOB_ID = 42
+NOTEBOOK_PARAMS = {
+    "dry-run": "true",
+    "oldest-time-to-consider": "1457570074236"
+}
+JAR_PARAMS = ["param1", "param2"]
+RENDERED_TEMPLATED_JAR_PARAMS = [
+    '/test-{0}'.format(DATE)
+]
+TEMPLATED_JAR_PARAMS = [
+    '/test-{{ ds }}'
+]
+PYTHON_PARAMS = ["john doe", "35"]
+SPARK_SUBMIT_PARAMS = ["--class", "org.apache.spark.examples.SparkPi"]
+
+
+class DatabricksOperatorSharedFunctions(unittest.TestCase):
+    def test_deep_string_coerce(self):
+        test_json = {
+            'test_int': 1,
+            'test_float': 1.0,
+            'test_dict': {'key': 'value'},
+            'test_list': [1, 1.0, 'a', 'b'],
+            'test_tuple': (1, 1.0, 'a', 'b')
+        }
+
+        expected = {
+            'test_int': '1',
+            'test_float': '1.0',
+            'test_dict': {'key': 'value'},
+            'test_list': ['1', '1.0', 'a', 'b'],
+            'test_tuple': ['1', '1.0', 'a', 'b']
+        }
+        self.assertDictEqual(databricks_operator._deep_string_coerce(test_json), expected)
 
 
 class DatabricksSubmitRunOperatorTest(unittest.TestCase):
@@ -65,12 +101,15 @@ def test_init_with_named_parameters(self):
         """
         Test the initializer with the named parameters.
         """
-        op = DatabricksSubmitRunOperator(task_id=TASK_ID, new_cluster=NEW_CLUSTER, notebook_task=NOTEBOOK_TASK)
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': TASK_ID
+        op = DatabricksSubmitRunOperator(task_id=TASK_ID,
+                                         new_cluster=NEW_CLUSTER,
+                                         notebook_task=NOTEBOOK_TASK)
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': TASK_ID
         })
+
         self.assertDictEqual(expected, op.json)
 
     def test_init_with_json(self):
@@ -78,14 +117,14 @@ def test_init_with_json(self):
         Test the initializer with json data.
         """
         json = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': TASK_ID
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': TASK_ID
         })
         self.assertDictEqual(expected, op.json)
 
@@ -99,10 +138,10 @@ def test_init_with_specified_run_name(self):
           'run_name': RUN_NAME
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': RUN_NAME
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': RUN_NAME
         })
         self.assertDictEqual(expected, op.json)
 
@@ -114,14 +153,16 @@ def test_init_with_merging(self):
         """
         override_new_cluster = {'workers': 999}
         json = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
         }
-        op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=json, new_cluster=override_new_cluster)
-        expected = op._deep_string_coerce({
-          'new_cluster': override_new_cluster,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': TASK_ID,
+        op = DatabricksSubmitRunOperator(task_id=TASK_ID,
+                                         json=json,
+                                         new_cluster=override_new_cluster)
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': override_new_cluster,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': TASK_ID,
         })
         self.assertDictEqual(expected, op.json)
 
@@ -133,10 +174,10 @@ def test_init_with_templating(self):
         dag = DAG('test', start_date=datetime.now())
         op = DatabricksSubmitRunOperator(dag=dag, task_id=TASK_ID, json=json)
         op.json = op.render_template('json', op.json, {'ds': DATE})
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': RENDERED_TEMPLATED_NOTEBOOK_TASK,
-          'run_name': TASK_ID,
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': RENDERED_TEMPLATED_NOTEBOOK_TASK,
+            'run_name': TASK_ID,
         })
         self.assertDictEqual(expected, op.json)
 
@@ -146,27 +187,9 @@ def test_init_with_bad_type(self):
         }
         # Looks a bit weird since we have to escape regex reserved symbols.
         exception_message = 'Type \<(type|class) \'datetime.datetime\'\> used ' + \
-                        'for parameter json\[test\] is not a number or a string'
+                            'for parameter json\[test\] is not a number or a string'
         with self.assertRaisesRegexp(AirflowException, exception_message):
-            op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
-
-    def test_deep_string_coerce(self):
-        op = DatabricksSubmitRunOperator(task_id='test')
-        test_json = {
-            'test_int': 1,
-            'test_float': 1.0,
-            'test_dict': {'key': 'value'},
-            'test_list': [1, 1.0, 'a', 'b'],
-            'test_tuple': (1, 1.0, 'a', 'b')
-        }
-        expected = {
-            'test_int': '1',
-            'test_float': '1.0',
-            'test_dict': {'key': 'value'},
-            'test_list': ['1', '1.0', 'a', 'b'],
-            'test_tuple': ['1', '1.0', 'a', 'b']
-        }
-        self.assertDictEqual(op._deep_string_coerce(test_json), expected)
+            DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
 
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_exec_success(self, db_mock_class):
@@ -184,15 +207,16 @@ def test_exec_success(self, db_mock_class):
 
         op.execute(None)
 
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': TASK_ID
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': TASK_ID
         })
         db_mock_class.assert_called_once_with(
             DEFAULT_CONN_ID,
             retry_limit=op.databricks_retry_limit,
             retry_delay=op.databricks_retry_delay)
+
         db_mock.submit_run.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
@@ -215,10 +239,10 @@ def test_exec_failure(self, db_mock_class):
         with self.assertRaises(AirflowException):
             op.execute(None)
 
-        expected = op._deep_string_coerce({
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': TASK_ID,
+        expected = databricks_operator._deep_string_coerce({
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': TASK_ID,
         })
         db_mock_class.assert_called_once_with(
             DEFAULT_CONN_ID,
@@ -232,8 +256,8 @@ def test_exec_failure(self, db_mock_class):
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_on_kill(self, db_mock_class):
         run = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=run)
         db_mock = db_mock_class.return_value
@@ -243,3 +267,173 @@ def test_on_kill(self, db_mock_class):
 
         db_mock.cancel_run.assert_called_once_with(RUN_ID)
 
+
+class DatabricksRunNowOperatorTest(unittest.TestCase):
+
+    def test_init_with_named_parameters(self):
+        """
+        Test the initializer with the named parameters.
+        """
+        op = DatabricksRunNowOperator(job_id=JOB_ID, task_id=TASK_ID)
+        expected = databricks_operator._deep_string_coerce({
+            'job_id': 42
+        })
+
+        self.assertDictEqual(expected, op.json)
+
+    def test_init_with_json(self):
+        """
+        Test the initializer with json data.
+        """
+        json = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': JAR_PARAMS,
+            'python_params': PYTHON_PARAMS,
+            'spark_submit_params': SPARK_SUBMIT_PARAMS
+        }
+        op = DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=json)
+
+        expected = databricks_operator._deep_string_coerce({
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': JAR_PARAMS,
+            'python_params': PYTHON_PARAMS,
+            'spark_submit_params': SPARK_SUBMIT_PARAMS,
+            'job_id': JOB_ID
+        })
+
+        self.assertDictEqual(expected, op.json)
+
+    def test_init_with_merging(self):
+        """
+        Test the initializer when json and other named parameters are both
+        provided. The named parameters should override top level keys in the
+        json dict.
+        """
+        override_notebook_params = {'workers': 999}
+        json = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': JAR_PARAMS
+        }
+
+        op = DatabricksRunNowOperator(task_id=TASK_ID,
+                                      json=json,
+                                      job_id=JOB_ID,
+                                      notebook_params=override_notebook_params,
+                                      python_params=PYTHON_PARAMS,
+                                      spark_submit_params=SPARK_SUBMIT_PARAMS)
+
+        expected = databricks_operator._deep_string_coerce({
+            'notebook_params': override_notebook_params,
+            'jar_params': JAR_PARAMS,
+            'python_params': PYTHON_PARAMS,
+            'spark_submit_params': SPARK_SUBMIT_PARAMS,
+            'job_id': JOB_ID
+        })
+
+        self.assertDictEqual(expected, op.json)
+
+    def test_init_with_templating(self):
+        json = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': TEMPLATED_JAR_PARAMS
+        }
+
+        dag = DAG('test', start_date=datetime.now())
+        op = DatabricksRunNowOperator(dag=dag, task_id=TASK_ID, job_id=JOB_ID, json=json)
+        op.json = op.render_template('json', op.json, {'ds': DATE})
+        expected = databricks_operator._deep_string_coerce({
+            'notebook_params': NOTEBOOK_PARAMS,
+            'jar_params': RENDERED_TEMPLATED_JAR_PARAMS,
+            'job_id': JOB_ID
+        })
+        self.assertDictEqual(expected, op.json)
+
+    def test_init_with_bad_type(self):
+        json = {
+            'test': datetime.now()
+        }
+        # Looks a bit weird since we have to escape regex reserved symbols.
+        exception_message = 'Type \<(type|class) \'datetime.datetime\'\> used ' + \
+                            'for parameter json\[test\] is not a number or a string'
+        with self.assertRaisesRegexp(AirflowException, exception_message):
+            DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=json)
+
+    @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
+    def test_exec_success(self, db_mock_class):
+        """
+        Test the execute function in case where the run is successful.
+        """
+        run = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'notebook_task': NOTEBOOK_TASK,
+            'jar_params': JAR_PARAMS
+        }
+        op = DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=run)
+        db_mock = db_mock_class.return_value
+        db_mock.run_now.return_value = 1
+        db_mock.get_run_state.return_value = RunState('TERMINATED', 'SUCCESS', '')
+
+        op.execute(None)
+
+        expected = databricks_operator._deep_string_coerce({
+            'notebook_params': NOTEBOOK_PARAMS,
+            'notebook_task': NOTEBOOK_TASK,
+            'jar_params': JAR_PARAMS,
+            'job_id': JOB_ID
+        })
+
+        db_mock_class.assert_called_once_with(
+            DEFAULT_CONN_ID,
+            retry_limit=op.databricks_retry_limit,
+            retry_delay=op.databricks_retry_delay)
+        db_mock.run_now.assert_called_once_with(expected)
+        db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
+        db_mock.get_run_state.assert_called_once_with(RUN_ID)
+        self.assertEquals(RUN_ID, op.run_id)
+
+    @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
+    def test_exec_failure(self, db_mock_class):
+        """
+        Test the execute function in case where the run failed.
+        """
+        run = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'notebook_task': NOTEBOOK_TASK,
+            'jar_params': JAR_PARAMS
+        }
+        op = DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=run)
+        db_mock = db_mock_class.return_value
+        db_mock.run_now.return_value = 1
+        db_mock.get_run_state.return_value = RunState('TERMINATED', 'FAILED', '')
+
+        with self.assertRaises(AirflowException):
+            op.execute(None)
+
+        expected = databricks_operator._deep_string_coerce({
+            'notebook_params': NOTEBOOK_PARAMS,
+            'notebook_task': NOTEBOOK_TASK,
+            'jar_params': JAR_PARAMS,
+            'job_id': JOB_ID
+        })
+        db_mock_class.assert_called_once_with(
+            DEFAULT_CONN_ID,
+            retry_limit=op.databricks_retry_limit,
+            retry_delay=op.databricks_retry_delay)
+        db_mock.run_now.assert_called_once_with(expected)
+        db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
+        db_mock.get_run_state.assert_called_once_with(RUN_ID)
+        self.assertEquals(RUN_ID, op.run_id)
+
+    @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
+    def test_on_kill(self, db_mock_class):
+        run = {
+            'notebook_params': NOTEBOOK_PARAMS,
+            'notebook_task': NOTEBOOK_TASK,
+            'jar_params': JAR_PARAMS
+        }
+        op = DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=run)
+        db_mock = db_mock_class.return_value
+        op.run_id = RUN_ID
+
+        op.on_kill()
+        db_mock.cancel_run.assert_called_once_with(RUN_ID)

From b09f8cc4064507d8743f0f275d249e79c11adc3e Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Fri, 12 Oct 2018 23:22:52 +0200
Subject: [PATCH 360/808] [AIRFLOW-3190] Make flake8 compliant (#4035)

---
 .flake8                                       |   3 +
 .github/PULL_REQUEST_TEMPLATE.md              |   4 +
 airflow/contrib/hooks/gcp_dataproc_hook.py    |  11 ++
 airflow/jobs.py                               |   4 +-
 airflow/utils/db.py                           |   2 +-
 airflow/utils/log/file_processor_handler.py   |   2 +-
 airflow/utils/sqlalchemy.py                   |  11 +-
 airflow/utils/trigger_rule.py                 |   1 +
 airflow/utils/weight_rule.py                  |   1 +
 airflow/www/views.py                          |  63 ++++------
 airflow/www_rbac/views.py                     |   4 +-
 setup.py                                      |   3 +-
 tests/api/__init__.py                         |   4 +-
 tests/api/client/__init__.py                  |   4 +-
 tests/api/common/__init__.py                  |   4 +-
 tests/api/common/experimental/__init__.py     |   4 +-
 tests/api/common/experimental/mark_tasks.py   |  25 ++--
 tests/contrib/hooks/test_databricks_hook.py   | 116 +++++++++---------
 tests/contrib/hooks/test_emr_hook.py          |   2 +-
 tests/contrib/hooks/test_gcp_mlengine_hook.py |   3 +-
 tests/contrib/hooks/test_jdbc_hook.py         |  12 +-
 tests/contrib/hooks/test_jira_hook.py         |  10 +-
 tests/contrib/hooks/test_spark_sql_hook.py    |   8 +-
 tests/contrib/hooks/test_sqoop_hook.py        |  10 +-
 tests/contrib/operators/__init__.py           |   1 -
 .../operators/test_awsbatch_operator.py       |  11 +-
 .../operators/test_databricks_operator.py     |  18 +--
 .../operators/test_dataproc_operator.py       |  31 ++---
 tests/contrib/operators/test_ecs_operator.py  |  17 ++-
 .../test_emr_terminate_job_flow_operator.py   |   3 +-
 .../operators/test_hipchat_operator.py        |   2 +-
 .../test_hive_to_dynamodb_operator.py         |  18 ++-
 .../operators/test_jira_operator_test.py      |  12 +-
 .../operators/test_mlengine_operator_utils.py |  16 +--
 .../contrib/operators/test_qubole_operator.py |  30 ++---
 tests/contrib/operators/test_sftp_operator.py |  92 +++++++-------
 .../operators/test_spark_sql_operator.py      |   2 +-
 .../contrib/operators/test_sqoop_operator.py  |  13 +-
 tests/contrib/operators/test_ssh_operator.py  |  25 ++--
 .../operators/test_vertica_to_mysql.py        |  12 +-
 .../sensors/test_emr_job_flow_sensor.py       |   8 +-
 .../contrib/sensors/test_jira_sensor_test.py  |  14 +--
 tests/contrib/utils/__init__.py               |   1 -
 tests/core.py                                 |  16 +--
 tests/dags/test_cli_triggered_dags.py         |   7 +-
 tests/dags/test_example_bash_operator.py      |   2 +-
 tests/dags/test_issue_1225.py                 |   3 +
 tests/dags/test_retry_handling_job.py         |   3 +-
 tests/executors/test_base_executor.py         |   1 -
 tests/executors/test_celery_executor.py       |   2 +-
 tests/executors/test_executor.py              |   2 +-
 tests/executors/test_local_executor.py        |   2 +-
 tests/hooks/__init__.py                       |   4 +-
 tests/hooks/test_docker_hook.py               |  12 +-
 tests/hooks/test_postgres_hook.py             |   4 +-
 tests/hooks/test_slack_hook.py                |   4 +-
 tests/jobs.py                                 | 103 ++++++++--------
 tests/models.py                               |  24 ++--
 tests/operators/test_latest_only_operator.py  |   4 +-
 tests/operators/test_python_operator.py       |  12 +-
 tests/operators/test_s3_to_hive_operator.py   |  50 +++-----
 tests/plugins/test_plugin.py                  |  11 +-
 tests/plugins_manager.py                      |   2 +-
 tests/sensors/test_sql_sensor.py              |  29 +++++
 tests/task/task_runner/__init__.py            |   4 +-
 tests/test_logging_config.py                  |   6 +-
 .../deps/test_runnable_exec_date_dep.py       |   1 +
 tests/ti_deps/deps/test_task_concurrency.py   |   1 -
 tests/utils.py                                |   1 +
 tests/utils/test_dates.py                     |  28 ++---
 tests/utils/test_log_handlers.py              |   8 +-
 tests/utils/test_logging_mixin.py             |   1 -
 tests/utils/test_timezone.py                  |   5 +-
 tests/www/__init__.py                         |   1 -
 tests/www/api/__init__.py                     |   1 -
 tests/www/api/experimental/__init__.py        |   1 -
 .../experimental/test_kerberos_endpoints.py   |   4 +-
 tests/www/test_validators.py                  |   1 -
 tests/www_rbac/__init__.py                    |   4 +-
 tests/www_rbac/api/__init__.py                |   4 +-
 tests/www_rbac/api/experimental/__init__.py   |   4 +-
 .../experimental/test_kerberos_endpoints.py   |   4 +-
 tests/www_rbac/test_utils.py                  |   4 +-
 tests/www_rbac/test_validators.py             |   4 +-
 tests/www_rbac/test_views.py                  |   4 +-
 tox.ini                                       |   6 +-
 86 files changed, 515 insertions(+), 516 deletions(-)
 create mode 100644 .flake8

diff --git a/.flake8 b/.flake8
new file mode 100644
index 0000000000000..2723df1f10969
--- /dev/null
+++ b/.flake8
@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 110
+ignore = E731
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 6000d0e5ff450..62929155afb01 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -29,5 +29,9 @@ Make sure you have checked _all_ steps below.
     - When adding new operators/hooks/sensors, the autoclass documentation generation needs to be added.
 
 
+<<<<<<< HEAD
 ### Code Quality
 - [ ] Passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
+=======
+- [ ] Passes `flake8`
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index 57c48bde59328..aaf33bc3ce36f 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -70,10 +70,21 @@ def wait_for_done(self):
             time.sleep(5)
 
     def raise_error(self, message=None):
+<<<<<<< HEAD
         if 'ERROR' == self.job['status']['state']:
             if message is None:
                 message = "Google DataProc job has error"
             raise Exception(message + ": " + str(self.job['status']['details']))
+=======
+        job_state = self.job['status']['state']
+        # We always consider ERROR to be an error state.
+        if (self.job_error_states and job_state in self.job_error_states) or 'ERROR' == job_state:
+            ex_message = message or ("Google DataProc job has state: %s" % job_state)
+            ex_details = (str(self.job['status']['details'])
+                          if 'details' in self.job['status']
+                          else "No details available")
+            raise Exception(ex_message + ": " + ex_details)
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
 
     def get(self):
         return self.job
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 0ad004809b7ff..2df2ed6009a31 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -199,10 +199,10 @@ def run(self):
                 self._execute()
                 # In case of max runs or max duration
                 self.state = State.SUCCESS
-            except SystemExit as e:
+            except SystemExit:
                 # In case of ^C or SIGTERM
                 self.state = State.SUCCESS
-            except Exception as e:
+            except Exception:
                 self.state = State.FAILED
                 raise
             finally:
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index aa770b27b6106..3817375c1efea 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -272,7 +272,7 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='qubole_default', conn_type='qubole',
-            host= 'localhost'))
+            host='localhost'))
     merge_conn(
         models.Connection(
             conn_id='segment_default', conn_type='segment',
diff --git a/airflow/utils/log/file_processor_handler.py b/airflow/utils/log/file_processor_handler.py
index f39dffe0c9333..cc7a8bd843ace 100644
--- a/airflow/utils/log/file_processor_handler.py
+++ b/airflow/utils/log/file_processor_handler.py
@@ -116,7 +116,7 @@ def _symlink_latest_log_directory(self):
                         os.unlink(latest_log_directory_path)
                         os.symlink(log_directory, latest_log_directory_path)
                 elif (os.path.isdir(latest_log_directory_path) or
-                          os.path.isfile(latest_log_directory_path)):
+                      os.path.isfile(latest_log_directory_path)):
                     logging.warning(
                         "%s already exists as a dir/file. Skip creating symlink.",
                         latest_log_directory_path
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index 76c112785f852..7e97371319ee0 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -37,12 +37,10 @@
 utc = pendulum.timezone('UTC')
 
 
-def setup_event_handlers(
-        engine,
-        reconnect_timeout_seconds,
-        initial_backoff_seconds=0.2,
-        max_backoff_seconds=120):
-
+def setup_event_handlers(engine,
+                         reconnect_timeout_seconds,
+                         initial_backoff_seconds=0.2,
+                         max_backoff_seconds=120):
     @event.listens_for(engine, "engine_connect")
     def ping_connection(connection, branch):
         """
@@ -100,7 +98,6 @@ def ping_connection(connection, branch):
                 # restore "close with result"
                 connection.should_close_with_result = save_should_close_with_result
 
-
     @event.listens_for(engine, "connect")
     def connect(dbapi_connection, connection_record):
         connection_record.info['pid'] = os.getpid()
diff --git a/airflow/utils/trigger_rule.py b/airflow/utils/trigger_rule.py
index ae51d6a30134d..7fdcbc8ca8057 100644
--- a/airflow/utils/trigger_rule.py
+++ b/airflow/utils/trigger_rule.py
@@ -31,6 +31,7 @@ class TriggerRule(object):
     DUMMY = 'dummy'
 
     _ALL_TRIGGER_RULES = {}
+
     @classmethod
     def is_valid(cls, trigger_rule):
         return trigger_rule in cls.all_triggers()
diff --git a/airflow/utils/weight_rule.py b/airflow/utils/weight_rule.py
index b920ef40229a1..f34856be8311e 100644
--- a/airflow/utils/weight_rule.py
+++ b/airflow/utils/weight_rule.py
@@ -28,6 +28,7 @@ class WeightRule(object):
     ABSOLUTE = 'absolute'
 
     _ALL_WEIGHT_RULES = {}
+
     @classmethod
     def is_valid(cls, weight_rule):
         return weight_rule in cls.all_weight_rules()
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 6d74b997d1649..715560e0992ed 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -675,12 +675,12 @@ def dag_details(self, session=None):
         title = "DAG details"
 
         TI = models.TaskInstance
-        states = (
-            session.query(TI.state, sqla.func.count(TI.dag_id))
-                .filter(TI.dag_id == dag_id)
-                .group_by(TI.state)
-                .all()
-        )
+        states = session\
+            .query(TI.state, sqla.func.count(TI.dag_id))\
+            .filter(TI.dag_id == dag_id)\
+            .group_by(TI.state)\
+            .all()
+
         return self.render(
             'airflow/dag_details.html',
             dag=dag, title=title, states=states, State=State)
@@ -1186,12 +1186,12 @@ def dagrun_clear(self):
     @provide_session
     def blocked(self, session=None):
         DR = models.DagRun
-        dags = (
-            session.query(DR.dag_id, sqla.func.count(DR.id))
-                .filter(DR.state == State.RUNNING)
-                .group_by(DR.dag_id)
-                .all()
-        )
+        dags = session\
+            .query(DR.dag_id, sqla.func.count(DR.id))\
+            .filter(DR.state == State.RUNNING)\
+            .group_by(DR.dag_id)\
+            .all()
+
         payload = []
         for dag_id, active_dag_runs in dags:
             max_active_runs = 0
@@ -1448,8 +1448,8 @@ def recurse_nodes(task, visited):
                 children_key = "_children"
 
             def set_duration(tid):
-                if (isinstance(tid, dict) and tid.get("state") == State.RUNNING and
-                            tid["start_date"] is not None):
+                if isinstance(tid, dict) and tid.get("state") == State.RUNNING \
+                        and tid["start_date"] is not None:
                     d = timezone.utcnow() - pendulum.parse(tid["start_date"])
                     tid["duration"] = d.total_seconds()
                 return tid
@@ -1476,9 +1476,7 @@ def set_duration(tid):
         data = {
             'name': '[DAG]',
             'children': [recurse_nodes(t, set()) for t in dag.roots],
-            'instances': [
-                dag_runs.get(d) or {'execution_date': d.isoformat()}
-                for d in dates],
+            'instances': [dag_runs.get(d) or {'execution_date': d.isoformat()} for d in dates],
         }
 
         data = json.dumps(data, indent=4, default=json_ser)
@@ -2331,13 +2329,10 @@ class SlaMissModelView(wwwutils.SuperUserMixin, ModelViewOnly):
 
 @provide_session
 def _connection_ids(session=None):
-    return [
-            (c.conn_id, c.conn_id)
-            for c in (
-                session.query(models.Connection.conn_id)
-                    .group_by(models.Connection.conn_id)
-            )
-    ]
+    return [(c.conn_id, c.conn_id) for c in (
+        session
+            .query(models.Connection.conn_id)
+            .group_by(models.Connection.conn_id))]
 
 
 class ChartModelView(wwwutils.DataProfilingMixin, AirflowModelView):
@@ -3136,20 +3131,16 @@ def get_query(self):
         """
         Default filters for model
         """
-        return (
-            super(DagModelView, self)
-                .get_query()
-                .filter(or_(models.DagModel.is_active, models.DagModel.is_paused))
-                .filter(~models.DagModel.is_subdag)
-        )
+        return super(DagModelView, self)\
+            .get_query()\
+            .filter(or_(models.DagModel.is_active, models.DagModel.is_paused))\
+            .filter(~models.DagModel.is_subdag)
 
     def get_count_query(self):
         """
         Default filters for model
         """
-        return (
-            super(DagModelView, self)
-                .get_count_query()
-                .filter(models.DagModel.is_active)
-                .filter(~models.DagModel.is_subdag)
-        )
+        return super(DagModelView, self)\
+            .get_count_query()\
+            .filter(models.DagModel.is_active)\
+            .filter(~models.DagModel.is_subdag)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index b5a3336468ffc..1d2f6e1aef57a 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -2095,7 +2095,7 @@ def varimport(self):
                     suc_count += 1
             flash("{} variable(s) successfully updated.".format(suc_count))
             if fail_count:
-                flash("{} variables(s) failed to be updated.".format(fail_count), 'error')
+                flash("{} variable(s) failed to be updated.".format(fail_count), 'error')
             self.update_redirect()
             return redirect(self.get_redirect())
 
@@ -2338,7 +2338,7 @@ def action_clear(self, tis, session=None):
             self.update_redirect()
             return redirect(self.get_redirect())
 
-        except Exception as ex:
+        except Exception:
             flash('Failed to clear task instances', 'error')
 
     @provide_session
diff --git a/setup.py b/setup.py
index 7947c27482af8..67c20ed6d608c 100644
--- a/setup.py
+++ b/setup.py
@@ -45,8 +45,7 @@ def verify_gpl_dependency():
     if os.getenv("READTHEDOCS") == "True":
         os.environ["SLUGIFY_USES_TEXT_UNIDECODE"] = "yes"
 
-    if (not os.getenv("AIRFLOW_GPL_UNIDECODE")
-            and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes"):
+    if not os.getenv("AIRFLOW_GPL_UNIDECODE") and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes":
         raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
                            "dependency (unidecode). To avoid this dependency set "
                            "SLUGIFY_USES_TEXT_UNIDECODE=yes in your environment when you "
diff --git a/tests/api/__init__.py b/tests/api/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/api/__init__.py
+++ b/tests/api/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/api/client/__init__.py b/tests/api/client/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/api/client/__init__.py
+++ b/tests/api/client/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/api/common/__init__.py b/tests/api/common/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/api/common/__init__.py
+++ b/tests/api/common/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/api/common/experimental/__init__.py b/tests/api/common/experimental/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/api/common/experimental/__init__.py
+++ b/tests/api/common/experimental/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/api/common/experimental/mark_tasks.py b/tests/api/common/experimental/mark_tasks.py
index 181d10d8a166f..4bf625999fc8c 100644
--- a/tests/api/common/experimental/mark_tasks.py
+++ b/tests/api/common/experimental/mark_tasks.py
@@ -72,7 +72,7 @@ def tearDown(self):
     def snapshot_state(self, dag, execution_dates):
         TI = models.TaskInstance
         tis = self.session.query(TI).filter(
-            TI.dag_id==dag.dag_id,
+            TI.dag_id == dag.dag_id,
             TI.execution_date.in_(execution_dates)
         ).all()
 
@@ -84,7 +84,7 @@ def verify_state(self, dag, task_ids, execution_dates, state, old_tis):
         TI = models.TaskInstance
 
         tis = self.session.query(TI).filter(
-            TI.dag_id==dag.dag_id,
+            TI.dag_id == dag.dag_id,
             TI.execution_date.in_(execution_dates)
         ).all()
 
@@ -95,9 +95,8 @@ def verify_state(self, dag, task_ids, execution_dates, state, old_tis):
                 self.assertEqual(ti.state, state)
             else:
                 for old_ti in old_tis:
-                    if (old_ti.task_id == ti.task_id
-                            and old_ti.execution_date == ti.execution_date):
-                            self.assertEqual(ti.state, old_ti.state)
+                    if old_ti.task_id == ti.task_id and old_ti.execution_date == ti.execution_date:
+                        self.assertEqual(ti.state, old_ti.state)
 
     def test_mark_tasks_now(self):
         # set one task to success but do not commit
@@ -404,19 +403,19 @@ def test_set_state_without_commit(self):
         self._verify_task_instance_states_remain_default(dr)
 
     def test_set_state_with_multiple_dagruns(self):
-        dr1 = self.dag2.create_dagrun(
+        self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.FAILED,
             execution_date=self.execution_dates[0],
             session=self.session
         )
-        dr2 = self.dag2.create_dagrun(
+        self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.FAILED,
             execution_date=self.execution_dates[1],
             session=self.session
         )
-        dr3 = self.dag2.create_dagrun(
+        self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.RUNNING,
             execution_date=self.execution_dates[2],
@@ -437,13 +436,11 @@ def count_dag_tasks(dag):
         self._verify_dag_run_state(self.dag2, self.execution_dates[1], State.SUCCESS)
 
         # Make sure other dag status are not changed
-        dr1 = models.DagRun.find(dag_id=self.dag2.dag_id,
-                                 execution_date=self.execution_dates[0])
-        dr1 = dr1[0]
+        models.DagRun.find(dag_id=self.dag2.dag_id,
+                           execution_date=self.execution_dates[0])
         self._verify_dag_run_state(self.dag2, self.execution_dates[0], State.FAILED)
-        dr3 = models.DagRun.find(dag_id=self.dag2.dag_id,
-                                 execution_date=self.execution_dates[2])
-        dr3 = dr3[0]
+        models.DagRun.find(dag_id=self.dag2.dag_id,
+                           execution_date=self.execution_dates[2])
         self._verify_dag_run_state(self.dag2, self.execution_dates[2], State.RUNNING)
 
     def test_set_dag_run_state_edge_cases(self):
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 185b6a6f2c8db..597c88192997f 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -144,13 +144,11 @@ def create_post_side_effect(exception, status_code=500):
         return response
 
 
-def setup_mock_requests(
-        mock_requests,
-        exception,
-        status_code=500,
-        error_count=None,
-        response_content=None):
-
+def setup_mock_requests(mock_requests,
+                        exception,
+                        status_code=500,
+                        error_count=None,
+                        response_content=None):
     side_effect = create_post_side_effect(exception, status_code)
 
     if error_count is None:
@@ -166,6 +164,7 @@ class DatabricksHookTest(unittest.TestCase):
     """
     Tests for DatabricksHook.
     """
+
     @db.provide_session
     def setUp(self, session=None):
         conn = session.query(Connection) \
@@ -192,21 +191,19 @@ def test_init_bad_retry_limit(self):
             DatabricksHook(retry_limit=0)
 
     def test_do_api_call_retries_with_retryable_error(self):
-        for exception in [
-                requests_exceptions.ConnectionError,
-                requests_exceptions.SSLError,
-                requests_exceptions.Timeout,
-                requests_exceptions.ConnectTimeout,
-                requests_exceptions.HTTPError]:
-            with mock.patch(
-                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
-                    mock.patch.object(self.hook.log, 'error') as mock_errors:
-                setup_mock_requests(mock_requests, exception)
-
-                with self.assertRaises(AirflowException):
-                    self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
-
-                self.assertEquals(mock_errors.call_count, self.hook.retry_limit)
+        for exception in [requests_exceptions.ConnectionError,
+                          requests_exceptions.SSLError,
+                          requests_exceptions.Timeout,
+                          requests_exceptions.ConnectTimeout,
+                          requests_exceptions.HTTPError]:
+            with mock.patch('airflow.contrib.hooks.databricks_hook.requests') as mock_requests:
+                with mock.patch.object(self.hook.log, 'error') as mock_errors:
+                    setup_mock_requests(mock_requests, exception)
+
+                    with self.assertRaises(AirflowException):
+                        self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+
+                    self.assertEquals(mock_errors.call_count, self.hook.retry_limit)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_do_api_call_does_not_retry_with_non_retryable_error(self, mock_requests):
@@ -221,56 +218,52 @@ def test_do_api_call_does_not_retry_with_non_retryable_error(self, mock_requests
             mock_errors.assert_not_called()
 
     def test_do_api_call_succeeds_after_retrying(self):
-        for exception in [
-                requests_exceptions.ConnectionError,
-                requests_exceptions.SSLError,
-                requests_exceptions.Timeout,
-                requests_exceptions.ConnectTimeout,
-                requests_exceptions.HTTPError]:
-            with mock.patch(
-                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
-                    mock.patch.object(self.hook.log, 'error') as mock_errors:
-                setup_mock_requests(
-                    mock_requests,
-                    exception,
-                    error_count=2,
-                    response_content={'run_id': '1'}
-                )
-
-                response = self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
-
-                self.assertEquals(mock_errors.call_count, 2)
-                self.assertEquals(response, {'run_id': '1'})
+        for exception in [requests_exceptions.ConnectionError,
+                          requests_exceptions.SSLError,
+                          requests_exceptions.Timeout,
+                          requests_exceptions.ConnectTimeout,
+                          requests_exceptions.HTTPError]:
+            with mock.patch('airflow.contrib.hooks.databricks_hook.requests') as mock_requests:
+                with mock.patch.object(self.hook.log, 'error') as mock_errors:
+                    setup_mock_requests(
+                        mock_requests,
+                        exception,
+                        error_count=2,
+                        response_content={'run_id': '1'}
+                    )
+
+                    response = self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+
+                    self.assertEquals(mock_errors.call_count, 2)
+                    self.assertEquals(response, {'run_id': '1'})
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.sleep')
     def test_do_api_call_waits_between_retries(self, mock_sleep):
         retry_delay = 5
         self.hook = DatabricksHook(retry_delay=retry_delay)
 
-        for exception in [
-                requests_exceptions.ConnectionError,
-                requests_exceptions.SSLError,
-                requests_exceptions.Timeout,
-                requests_exceptions.ConnectTimeout,
-                requests_exceptions.HTTPError]:
-            with mock.patch(
-                'airflow.contrib.hooks.databricks_hook.requests') as mock_requests, \
-                    mock.patch.object(self.hook.log, 'error'):
-                mock_sleep.reset_mock()
-                setup_mock_requests(mock_requests, exception)
+        for exception in [requests_exceptions.ConnectionError,
+                          requests_exceptions.SSLError,
+                          requests_exceptions.Timeout,
+                          requests_exceptions.ConnectTimeout,
+                          requests_exceptions.HTTPError]:
+            with mock.patch('airflow.contrib.hooks.databricks_hook.requests') as mock_requests:
+                with mock.patch.object(self.hook.log, 'error'):
+                    mock_sleep.reset_mock()
+                    setup_mock_requests(mock_requests, exception)
 
-                with self.assertRaises(AirflowException):
-                    self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
+                    with self.assertRaises(AirflowException):
+                        self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
 
-                self.assertEquals(len(mock_sleep.mock_calls), self.hook.retry_limit - 1)
-                mock_sleep.assert_called_with(retry_delay)
+                    self.assertEquals(len(mock_sleep.mock_calls), self.hook.retry_limit - 1)
+                    mock_sleep.assert_called_with(retry_delay)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_submit_run(self, mock_requests):
         mock_requests.post.return_value.json.return_value = {'run_id': '1'}
         json = {
-          'notebook_task': NOTEBOOK_TASK,
-          'new_cluster': NEW_CLUSTER
+            'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER
         }
         run_id = self.hook.submit_run(json)
 
@@ -408,6 +401,7 @@ class DatabricksHookTokenTest(unittest.TestCase):
     """
     Tests for DatabricksHook when auth is done with token.
     """
+
     @db.provide_session
     def setUp(self, session=None):
         conn = session.query(Connection) \
@@ -425,8 +419,8 @@ def test_submit_run(self, mock_requests):
         status_code_mock = mock.PropertyMock(return_value=200)
         type(mock_requests.post.return_value).status_code = status_code_mock
         json = {
-          'notebook_task': NOTEBOOK_TASK,
-          'new_cluster': NEW_CLUSTER
+            'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER
         }
         run_id = self.hook.submit_run(json)
 
diff --git a/tests/contrib/hooks/test_emr_hook.py b/tests/contrib/hooks/test_emr_hook.py
index 9116b96ae3ed4..64485ae973fe3 100644
--- a/tests/contrib/hooks/test_emr_hook.py
+++ b/tests/contrib/hooks/test_emr_hook.py
@@ -24,7 +24,6 @@
 from airflow import configuration
 from airflow.contrib.hooks.emr_hook import EmrHook
 
-
 try:
     from moto import mock_emr
 except ImportError:
@@ -75,5 +74,6 @@ def test_create_job_flow_extra_args(self):
         # The AmiVersion comes back as {Requested,Running}AmiVersion fields.
         self.assertEqual(cluster['RequestedAmiVersion'], '3.2')
 
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/hooks/test_gcp_mlengine_hook.py b/tests/contrib/hooks/test_gcp_mlengine_hook.py
index c3bc7a9c0da0a..f986354503607 100644
--- a/tests/contrib/hooks/test_gcp_mlengine_hook.py
+++ b/tests/contrib/hooks/test_gcp_mlengine_hook.py
@@ -185,8 +185,7 @@ def test_list_versions(self):
                 self._SERVICE_URI_PREFIX, project, model_name), 'GET',
              None),
         ] + [
-            ('{}projects/{}/models/{}/versions?alt=json&pageToken={}'
-             '&pageSize=100'.format(
+            ('{}projects/{}/models/{}/versions?alt=json&pageToken={}&pageSize=100'.format(
                 self._SERVICE_URI_PREFIX, project, model_name, ix), 'GET',
              None) for ix in range(len(versions) - 1)
         ]
diff --git a/tests/contrib/hooks/test_jdbc_hook.py b/tests/contrib/hooks/test_jdbc_hook.py
index c1b994907be1c..30c7df4a91da6 100644
--- a/tests/contrib/hooks/test_jdbc_hook.py
+++ b/tests/contrib/hooks/test_jdbc_hook.py
@@ -19,6 +19,7 @@
 #
 
 import unittest
+import json
 
 from mock import Mock
 from mock import patch
@@ -29,7 +30,7 @@
 from airflow.utils import db
 
 jdbc_conn_mock = Mock(
-        name="jdbc_conn"
+    name="jdbc_conn"
 )
 
 
@@ -37,10 +38,11 @@ class TestJdbcHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-                models.Connection(
-                        conn_id='jdbc_default', conn_type='jdbc',
-                        host='jdbc://localhost/', port=443,
-                        extra='{"extra__jdbc__drv_path": "/path1/test.jar,/path2/t.jar2", "extra__jdbc__drv_clsname": "com.driver.main"}'))
+            models.Connection(
+                conn_id='jdbc_default', conn_type='jdbc',
+                host='jdbc://localhost/', port=443,
+                extra=json.dumps({"extra__jdbc__drv_path": "/path1/test.jar,/path2/t.jar2",
+                                  "extra__jdbc__drv_clsname": "com.driver.main"})))
 
     @patch("airflow.hooks.jdbc_hook.jaydebeapi.connect", autospec=True,
            return_value=jdbc_conn_mock)
diff --git a/tests/contrib/hooks/test_jira_hook.py b/tests/contrib/hooks/test_jira_hook.py
index e07ddf32fc788..6cddbd046fb03 100644
--- a/tests/contrib/hooks/test_jira_hook.py
+++ b/tests/contrib/hooks/test_jira_hook.py
@@ -29,7 +29,7 @@
 from airflow.utils import db
 
 jira_client_mock = Mock(
-        name="jira_client"
+    name="jira_client"
 )
 
 
@@ -37,10 +37,10 @@ class TestJiraHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-                models.Connection(
-                        conn_id='jira_default', conn_type='jira',
-                        host='https://localhost/jira/', port=443,
-                        extra='{"verify": "False", "project": "AIRFLOW"}'))
+            models.Connection(
+                conn_id='jira_default', conn_type='jira',
+                host='https://localhost/jira/', port=443,
+                extra='{"verify": "False", "project": "AIRFLOW"}'))
 
     @patch("airflow.contrib.hooks.jira_hook.JIRA", autospec=True,
            return_value=jira_client_mock)
diff --git a/tests/contrib/hooks/test_spark_sql_hook.py b/tests/contrib/hooks/test_spark_sql_hook.py
index c95ee3fb130d0..8a6d410ae4177 100644
--- a/tests/contrib/hooks/test_spark_sql_hook.py
+++ b/tests/contrib/hooks/test_spark_sql_hook.py
@@ -37,8 +37,8 @@ def get_after(sentinel, iterable):
     next(truncated)
     return next(truncated)
 
-class TestSparkSqlHook(unittest.TestCase):
 
+class TestSparkSqlHook(unittest.TestCase):
     _config = {
         'conn_id': 'spark_default',
         'executor_cores': 4,
@@ -100,7 +100,8 @@ def test_spark_process_runcmd(self, mock_popen):
                 hook.run_query()
                 mock_debug.assert_called_with(
                     'Spark-Sql cmd: %s',
-                    ['spark-sql', '-e', 'SELECT 1', '--master', 'yarn', '--name', 'default-name', '--verbose', '--queue', 'default']
+                    ['spark-sql', '-e', 'SELECT 1', '--master', 'yarn', '--name', 'default-name', '--verbose',
+                     '--queue', 'default']
                 )
                 mock_info.assert_called_with(
                     'Spark-sql communicates using stdout'
@@ -109,7 +110,8 @@ def test_spark_process_runcmd(self, mock_popen):
         # Then
         self.assertEqual(
             mock_popen.mock_calls[0],
-            call(['spark-sql', '-e', 'SELECT 1', '--master', 'yarn', '--name', 'default-name', '--verbose', '--queue', 'default'], stderr=-2, stdout=-1)
+            call(['spark-sql', '-e', 'SELECT 1', '--master', 'yarn', '--name', 'default-name', '--verbose',
+                  '--queue', 'default'], stderr=-2, stdout=-1)
         )
 
 
diff --git a/tests/contrib/hooks/test_sqoop_hook.py b/tests/contrib/hooks/test_sqoop_hook.py
index 47c9a7be8e283..5e7ac7a6275da 100644
--- a/tests/contrib/hooks/test_sqoop_hook.py
+++ b/tests/contrib/hooks/test_sqoop_hook.py
@@ -98,7 +98,8 @@ def test_popen(self, mock_popen):
         mock_popen.return_value.stdout = StringIO(u'stdout')
         mock_popen.return_value.stderr = StringIO(u'stderr')
         mock_popen.return_value.returncode = 0
-        mock_popen.return_value.communicate.return_value = [StringIO(u'stdout\nstdout'), StringIO(u'stderr\nstderr')]
+        mock_popen.return_value.communicate.return_value = \
+            [StringIO(u'stdout\nstdout'), StringIO(u'stderr\nstderr')]
 
         # When
         hook = SqoopHook(conn_id='sqoop_test')
@@ -163,7 +164,7 @@ def test_submit(self):
             self.assertIn("-files {}".format(self._config_json['files']), cmd)
 
         if self._config_json['archives']:
-            self.assertIn( "-archives {}".format(self._config_json['archives']), cmd)
+            self.assertIn("-archives {}".format(self._config_json['archives']), cmd)
 
         self.assertIn("--hcatalog-database {}".format(self._config['hcatalog_database']), cmd)
         self.assertIn("--hcatalog-table {}".format(self._config['hcatalog_table']), cmd)
@@ -173,7 +174,7 @@ def test_submit(self):
             self.assertIn("--verbose", cmd)
 
         if self._config['num_mappers']:
-            self.assertIn( "--num-mappers {}".format(self._config['num_mappers']), cmd)
+            self.assertIn("--num-mappers {}".format(self._config['num_mappers']), cmd)
 
         for key, value in self._config['properties'].items():
             self.assertIn("-D {}={}".format(key, value), cmd)
@@ -301,7 +302,8 @@ def test_import_cmd(self):
 
     def test_get_export_format_argument(self):
         """
-        Tests to verify the hook get format function is building correct Sqoop command with correct format type.
+        Tests to verify the hook get format function is building
+        correct Sqoop command with correct format type.
         """
         hook = SqoopHook()
         self.assertIn("--as-avrodatafile",
diff --git a/tests/contrib/operators/__init__.py b/tests/contrib/operators/__init__.py
index fc532e61c6c64..db5ba598d7c23 100644
--- a/tests/contrib/operators/__init__.py
+++ b/tests/contrib/operators/__init__.py
@@ -17,4 +17,3 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-
diff --git a/tests/contrib/operators/test_awsbatch_operator.py b/tests/contrib/operators/test_awsbatch_operator.py
index 66540bc44f267..782ee6deaced5 100644
--- a/tests/contrib/operators/test_awsbatch_operator.py
+++ b/tests/contrib/operators/test_awsbatch_operator.py
@@ -33,7 +33,6 @@
     except ImportError:
         mock = None
 
-
 RESPONSE_WITHOUT_FAILURES = {
     "jobName": "51455483-c62c-48ac-9b88-53a6a725baa3",
     "jobId": "8ba9d676-4108-4474-9dca-8bbac1da9b19"
@@ -58,7 +57,6 @@ def setUp(self, aws_hook_mock):
             region_name='eu-west-1')
 
     def test_init(self):
-
         self.assertEqual(self.batch.job_name, '51455483-c62c-48ac-9b88-53a6a725baa3')
         self.assertEqual(self.batch.job_queue, 'queue')
         self.assertEqual(self.batch.job_definition, 'hello-world')
@@ -76,13 +74,13 @@ def test_template_fields_overrides(self):
     @mock.patch.object(AWSBatchOperator, '_wait_for_task_ended')
     @mock.patch.object(AWSBatchOperator, '_check_success_task')
     def test_execute_without_failures(self, check_mock, wait_mock):
-
         client_mock = self.aws_hook_mock.return_value.get_client_type.return_value
         client_mock.submit_job.return_value = RESPONSE_WITHOUT_FAILURES
 
         self.batch.execute(None)
 
-        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('batch', region_name='eu-west-1')
+        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('batch',
+                                                                                region_name='eu-west-1')
         client_mock.submit_job.assert_called_once_with(
             jobQueue='queue',
             jobName='51455483-c62c-48ac-9b88-53a6a725baa3',
@@ -95,14 +93,14 @@ def test_execute_without_failures(self, check_mock, wait_mock):
         self.assertEqual(self.batch.jobId, '8ba9d676-4108-4474-9dca-8bbac1da9b19')
 
     def test_execute_with_failures(self):
-
         client_mock = self.aws_hook_mock.return_value.get_client_type.return_value
         client_mock.submit_job.return_value = ""
 
         with self.assertRaises(AirflowException):
             self.batch.execute(None)
 
-        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('batch', region_name='eu-west-1')
+        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('batch',
+                                                                                region_name='eu-west-1')
         client_mock.submit_job.assert_called_once_with(
             jobQueue='queue',
             jobName='51455483-c62c-48ac-9b88-53a6a725baa3',
@@ -111,7 +109,6 @@ def test_execute_with_failures(self):
         )
 
     def test_wait_end_tasks(self):
-
         client_mock = mock.Mock()
         self.batch.jobId = '8ba9d676-4108-4474-9dca-8bbac1da9b19'
         self.batch.client = client_mock
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index 5884fc3c98d81..d3bbc73d7eeb3 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -133,9 +133,9 @@ def test_init_with_specified_run_name(self):
         Test the initializer with a specified run_name.
         """
         json = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
-          'run_name': RUN_NAME
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
+            'run_name': RUN_NAME
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
         expected = databricks_operator._deep_string_coerce({
@@ -168,8 +168,8 @@ def test_init_with_merging(self):
 
     def test_init_with_templating(self):
         json = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': TEMPLATED_NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': TEMPLATED_NOTEBOOK_TASK,
         }
         dag = DAG('test', start_date=datetime.now())
         op = DatabricksSubmitRunOperator(dag=dag, task_id=TASK_ID, json=json)
@@ -197,8 +197,8 @@ def test_exec_success(self, db_mock_class):
         Test the execute function in case where the run is successful.
         """
         run = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=run)
         db_mock = db_mock_class.return_value
@@ -228,8 +228,8 @@ def test_exec_failure(self, db_mock_class):
         Test the execute function in case where the run failed.
         """
         run = {
-          'new_cluster': NEW_CLUSTER,
-          'notebook_task': NOTEBOOK_TASK,
+            'new_cluster': NEW_CLUSTER,
+            'notebook_task': NOTEBOOK_TASK,
         }
         op = DatabricksSubmitRunOperator(task_id=TASK_ID, json=run)
         db_mock = db_mock_class.return_value
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 173752d722ecb..2a5226e811d04 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -114,7 +114,7 @@ def setUp(self):
         self.dataproc_operators = []
         self.mock_conn = Mock()
         for labels in self.labels:
-             self.dataproc_operators.append(
+            self.dataproc_operators.append(
                 DataprocClusterCreateOperator(
                     task_id=TASK_ID,
                     cluster_name=CLUSTER_NAME,
@@ -140,7 +140,7 @@ def setUp(self):
                     auto_delete_time=AUTO_DELETE_TIME,
                     auto_delete_ttl=AUTO_DELETE_TTL
                 )
-             )
+            )
         self.dag = DAG(
             'test_dag',
             default_args={
@@ -214,7 +214,7 @@ def test_build_cluster_data(self):
             # set to the dataproc operator.
             merged_labels = {}
             merged_labels.update(self.labels[suffix])
-            merged_labels.update({'airflow-version': 'v' + version.replace('.', '-').replace('+','-')})
+            merged_labels.update({'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')})
             self.assertTrue(re.match(r'[a-z]([-a-z0-9]*[a-z0-9])?',
                                      cluster_data['labels']['airflow-version']))
             self.assertEqual(cluster_data['labels'], merged_labels)
@@ -327,8 +327,7 @@ def test_init_cluster_with_zero_workers_and_not_non_zero_preemtibles(self):
             )
 
     def test_cluster_name_log_no_sub(self):
-        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') \
-                as mock_hook:
+        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
             mock_hook.return_value.get_conn = self.mock_conn
             dataproc_task = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
@@ -339,13 +338,12 @@ def test_cluster_name_log_no_sub(self):
                 dag=self.dag
             )
             with patch.object(dataproc_task.log, 'info') as mock_info:
-                with self.assertRaises(TypeError) as _:
+                with self.assertRaises(TypeError):
                     dataproc_task.execute(None)
                 mock_info.assert_called_with('Creating cluster: %s', CLUSTER_NAME)
 
     def test_cluster_name_log_sub(self):
-        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') \
-                as mock_hook:
+        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
             mock_hook.return_value.get_conn = self.mock_conn
             dataproc_task = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
@@ -364,13 +362,11 @@ def test_cluster_name_log_sub(self):
                 setattr(dataproc_task, 'cluster_name', rendered)
                 with self.assertRaises(TypeError):
                     dataproc_task.execute(None)
-                mock_info.assert_called_with('Creating cluster: %s',
-                                             u'smoke-cluster-testnodash')
+                mock_info.assert_called_with('Creating cluster: %s', u'smoke-cluster-testnodash')
 
     def test_build_cluster_data_internal_ip_only_without_subnetwork(self):
 
         def create_cluster_with_invalid_internal_ip_only_setup():
-
             # Given
             create_cluster = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
@@ -389,8 +385,7 @@ def create_cluster_with_invalid_internal_ip_only_setup():
             create_cluster_with_invalid_internal_ip_only_setup()
 
         self.assertEqual(str(cm.exception),
-                         "Set internal_ip_only to true only when"
-                         " you pass a subnetwork_uri.")
+                         "Set internal_ip_only to true only when you pass a subnetwork_uri.")
 
 
 class DataprocClusterScaleOperatorTest(unittest.TestCase):
@@ -434,8 +429,7 @@ def test_cluster_name_log_no_sub(self):
                 mock_info.assert_called_with('Scaling cluster: %s', CLUSTER_NAME)
 
     def test_cluster_name_log_sub(self):
-        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') \
-                as mock_hook:
+        with patch('airflow.contrib.operators.dataproc_operator.DataProcHook') as mock_hook:
             mock_hook.return_value.get_conn = self.mock_conn
             dataproc_task = DataprocClusterScaleOperator(
                 task_id=TASK_ID,
@@ -455,22 +449,21 @@ def test_cluster_name_log_sub(self):
                 setattr(dataproc_task, 'cluster_name', rendered)
                 with self.assertRaises(TypeError):
                     dataproc_task.execute(None)
-                mock_info.assert_called_with('Scaling cluster: %s',
-                                             u'smoke-cluster-testnodash')
+                mock_info.assert_called_with('Scaling cluster: %s', u'smoke-cluster-testnodash')
 
 
 class DataprocClusterDeleteOperatorTest(unittest.TestCase):
     # Unit test for the DataprocClusterDeleteOperator
     def setUp(self):
         self.mock_execute = Mock()
-        self.mock_execute.execute = Mock(return_value={'done' : True})
+        self.mock_execute.execute = Mock(return_value={'done': True})
         self.mock_get = Mock()
         self.mock_get.get = Mock(return_value=self.mock_execute)
         self.mock_operations = Mock()
         self.mock_operations.get = Mock(return_value=self.mock_get)
         self.mock_regions = Mock()
         self.mock_regions.operations = Mock(return_value=self.mock_operations)
-        self.mock_projects=Mock()
+        self.mock_projects = Mock()
         self.mock_projects.regions = Mock(return_value=self.mock_regions)
         self.mock_conn = Mock()
         self.mock_conn.projects = Mock(return_value=self.mock_projects)
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index ab4604809c902..232a02a26842a 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -34,14 +34,14 @@
     except ImportError:
         mock = None
 
-
 RESPONSE_WITHOUT_FAILURES = {
     "failures": [],
     "tasks": [
         {
             "containers": [
                 {
-                    "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e1ed7aac-d9b2-4315-8726-d2432bf11868",
+                    "containerArn":
+                        "arn:aws:ecs:us-east-1:012345678910:container/e1ed7aac-d9b2-4315-8726-d2432bf11868",
                     "lastStatus": "PENDING",
                     "name": "wordpress",
                     "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55"
@@ -72,7 +72,6 @@ def setUp(self, aws_hook_mock):
             region_name='eu-west-1')
 
     def test_init(self):
-
         self.assertEqual(self.ecs.region_name, 'eu-west-1')
         self.assertEqual(self.ecs.task_definition, 't')
         self.assertEqual(self.ecs.aws_conn_id, None)
@@ -88,13 +87,13 @@ def test_template_fields_overrides(self):
     @mock.patch.object(ECSOperator, '_wait_for_task_ended')
     @mock.patch.object(ECSOperator, '_check_success_task')
     def test_execute_without_failures(self, check_mock, wait_mock):
-
         client_mock = self.aws_hook_mock.return_value.get_client_type.return_value
         client_mock.run_task.return_value = RESPONSE_WITHOUT_FAILURES
 
         self.ecs.execute(None)
 
-        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs', region_name='eu-west-1')
+        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs',
+                                                                                region_name='eu-west-1')
         client_mock.run_task.assert_called_once_with(
             cluster='c',
             launchType='EC2',
@@ -105,10 +104,10 @@ def test_execute_without_failures(self, check_mock, wait_mock):
 
         wait_mock.assert_called_once_with()
         check_mock.assert_called_once_with()
-        self.assertEqual(self.ecs.arn, 'arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55')
+        self.assertEqual(self.ecs.arn,
+                         'arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55')
 
     def test_execute_with_failures(self):
-
         client_mock = self.aws_hook_mock.return_value.get_client_type.return_value
         resp_failures = deepcopy(RESPONSE_WITHOUT_FAILURES)
         resp_failures['failures'].append('dummy error')
@@ -117,7 +116,8 @@ def test_execute_with_failures(self):
         with self.assertRaises(AirflowException):
             self.ecs.execute(None)
 
-        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs', region_name='eu-west-1')
+        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs',
+                                                                                region_name='eu-west-1')
         client_mock.run_task.assert_called_once_with(
             cluster='c',
             launchType='EC2',
@@ -127,7 +127,6 @@ def test_execute_with_failures(self):
         )
 
     def test_wait_end_tasks(self):
-
         client_mock = mock.Mock()
         self.ecs.arn = 'arn'
         self.ecs.client = client_mock
diff --git a/tests/contrib/operators/test_emr_terminate_job_flow_operator.py b/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
index 7eb27ec16ec79..4c905719fe9b8 100644
--- a/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
+++ b/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
@@ -44,10 +44,8 @@ def setUp(self):
         # Mock out the emr_client creator
         self.boto3_session_mock = MagicMock(return_value=mock_emr_session)
 
-
     def test_execute_terminates_the_job_flow_and_does_not_error(self):
         with patch('boto3.session.Session', self.boto3_session_mock):
-
             operator = EmrTerminateJobFlowOperator(
                 task_id='test_task',
                 job_flow_id='j-8989898989',
@@ -56,5 +54,6 @@ def test_execute_terminates_the_job_flow_and_does_not_error(self):
 
             operator.execute(None)
 
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/operators/test_hipchat_operator.py b/tests/contrib/operators/test_hipchat_operator.py
index b6abce9bd2f94..10d39c56ba331 100644
--- a/tests/contrib/operators/test_hipchat_operator.py
+++ b/tests/contrib/operators/test_hipchat_operator.py
@@ -47,7 +47,7 @@ def test_execute(self, request_mock):
 
         operator = HipChatAPISendRoomNotificationOperator(
             task_id='test_hipchat_success',
-            owner = 'airflow',
+            owner='airflow',
             token='abc123',
             room_id='room_id',
             message='hello world!'
diff --git a/tests/contrib/operators/test_hive_to_dynamodb_operator.py b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
index e5b2c3e65a257..91736ca521ebd 100644
--- a/tests/contrib/operators/test_hive_to_dynamodb_operator.py
+++ b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
@@ -20,17 +20,18 @@
 
 import json
 import unittest
+import datetime
 
 import mock
 import pandas as pd
 
 from airflow import configuration, DAG
-
-configuration.load_test_config()
-import datetime
 from airflow.contrib.hooks.aws_dynamodb_hook import AwsDynamoDBHook
+
 import airflow.contrib.operators.hive_to_dynamodb
 
+configuration.load_test_config()
+
 DEFAULT_DATE = datetime.datetime(2015, 1, 1)
 DEFAULT_DATE_ISO = DEFAULT_DATE.isoformat()
 DEFAULT_DATE_DS = DEFAULT_DATE_ISO[:10]
@@ -67,9 +68,8 @@ def test_get_conn_returns_a_boto3_connection(self):
     @unittest.skipIf(mock_dynamodb2 is None, 'mock_dynamodb2 package not present')
     @mock_dynamodb2
     def test_get_records_with_schema(self, get_results_mock):
-
         # this table needs to be created in production
-        table = self.hook.get_conn().create_table(
+        self.hook.get_conn().create_table(
             TableName='test_airflow',
             KeySchema=[
                 {
@@ -108,9 +108,8 @@ def test_get_records_with_schema(self, get_results_mock):
     @unittest.skipIf(mock_dynamodb2 is None, 'mock_dynamodb2 package not present')
     @mock_dynamodb2
     def test_pre_process_records_with_schema(self, get_results_mock):
-
-         # this table needs to be created in production
-        table = self.hook.get_conn().create_table(
+        # this table needs to be created in production
+        self.hook.get_conn().create_table(
             TableName='test_airflow',
             KeySchema=[
                 {
@@ -141,8 +140,7 @@ def test_pre_process_records_with_schema(self, get_results_mock):
         operator.execute(None)
 
         table = self.hook.get_conn().Table('test_airflow')
-        table.meta.client.get_waiter(
-            'table_exists').wait(TableName='test_airflow')
+        table.meta.client.get_waiter('table_exists').wait(TableName='test_airflow')
         self.assertEqual(table.item_count, 1)
 
 
diff --git a/tests/contrib/operators/test_jira_operator_test.py b/tests/contrib/operators/test_jira_operator_test.py
index 764458c314dad..2324f68d5abad 100644
--- a/tests/contrib/operators/test_jira_operator_test.py
+++ b/tests/contrib/operators/test_jira_operator_test.py
@@ -31,7 +31,7 @@
 
 DEFAULT_DATE = timezone.datetime(2017, 1, 1)
 jira_client_mock = Mock(
-        name="jira_client_for_test"
+    name="jira_client_for_test"
 )
 
 minimal_test_ticket = {
@@ -54,14 +54,14 @@ def setUp(self):
         args = {
             'owner': 'airflow',
             'start_date': DEFAULT_DATE
-            }
+        }
         dag = DAG('test_dag_id', default_args=args)
         self.dag = dag
         db.merge_conn(
-                models.Connection(
-                        conn_id='jira_default', conn_type='jira',
-                        host='https://localhost/jira/', port=443,
-                        extra='{"verify": "False", "project": "AIRFLOW"}'))
+            models.Connection(
+                conn_id='jira_default', conn_type='jira',
+                host='https://localhost/jira/', port=443,
+                extra='{"verify": "False", "project": "AIRFLOW"}'))
 
     @patch("airflow.contrib.hooks.jira_hook.JIRA",
            autospec=True, return_value=jira_client_mock)
diff --git a/tests/contrib/operators/test_mlengine_operator_utils.py b/tests/contrib/operators/test_mlengine_operator_utils.py
index 0cb106da6bb8d..554a6b9e4f7df 100644
--- a/tests/contrib/operators/test_mlengine_operator_utils.py
+++ b/tests/contrib/operators/test_mlengine_operator_utils.py
@@ -36,7 +36,6 @@
 
 
 class CreateEvaluateOpsTest(unittest.TestCase):
-
     INPUT_MISSING_ORIGIN = {
         'dataFormat': 'TEXT',
         'inputPaths': ['gs://legal-bucket/fake-input-path/*'],
@@ -89,7 +88,6 @@ def testSuccessfulRun(self):
 
         with patch('airflow.contrib.operators.mlengine_operator.'
                    'MLEngineHook') as mock_mlengine_hook:
-
             success_message = self.SUCCESS_MESSAGE_MISSING_INPUT.copy()
             success_message['predictionInput'] = input_with_model
             hook_instance = mock_mlengine_hook.return_value
@@ -107,7 +105,6 @@ def testSuccessfulRun(self):
 
         with patch('airflow.contrib.operators.dataflow_operator.'
                    'DataFlowHook') as mock_dataflow_hook:
-
             hook_instance = mock_dataflow_hook.return_value
             hook_instance.start_python_dataflow.return_value = None
             summary.execute(None)
@@ -126,7 +123,6 @@ def testSuccessfulRun(self):
 
         with patch('airflow.contrib.operators.mlengine_operator_utils.'
                    'GoogleCloudStorageHook') as mock_gcs_hook:
-
             hook_instance = mock_gcs_hook.return_value
             hook_instance.download.return_value = '{"err": 0.9, "count": 9}'
             result = validate.execute({})
@@ -159,27 +155,25 @@ def testFailures(self):
         }
 
         with self.assertRaisesRegexp(AirflowException, 'Missing model origin'):
-            _ = create_evaluate_ops(**other_params_but_models)
+            create_evaluate_ops(**other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException, 'Ambiguous model origin'):
-            _ = create_evaluate_ops(model_uri='abc', model_name='cde',
-                                    **other_params_but_models)
+            create_evaluate_ops(model_uri='abc', model_name='cde', **other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException, 'Ambiguous model origin'):
-            _ = create_evaluate_ops(model_uri='abc', version_name='vvv',
-                                    **other_params_but_models)
+            create_evaluate_ops(model_uri='abc', version_name='vvv', **other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException,
                                      '`metric_fn` param must be callable'):
             params = other_params_but_models.copy()
             params['metric_fn_and_keys'] = (None, ['abc'])
-            _ = create_evaluate_ops(model_uri='gs://blah', **params)
+            create_evaluate_ops(model_uri='gs://blah', **params)
 
         with self.assertRaisesRegexp(AirflowException,
                                      '`validate_fn` param must be callable'):
             params = other_params_but_models.copy()
             params['validate_fn'] = None
-            _ = create_evaluate_ops(model_uri='gs://blah', **params)
+            create_evaluate_ops(model_uri='gs://blah', **params)
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/operators/test_qubole_operator.py b/tests/contrib/operators/test_qubole_operator.py
index bf61262bb398d..c0894c0ba76ae 100644
--- a/tests/contrib/operators/test_qubole_operator.py
+++ b/tests/contrib/operators/test_qubole_operator.py
@@ -35,9 +35,9 @@
     except ImportError:
         mock = None
 
-DAG_ID="qubole_test_dag"
-TASK_ID="test_task"
-DEFAULT_CONN="qubole_default"
+DAG_ID = "qubole_test_dag"
+TASK_ID = "test_task"
+DEFAULT_CONN = "qubole_default"
 TEMPLATE_CONN = "my_conn_id"
 DEFAULT_DATE = datetime(2017, 1, 1)
 
@@ -60,7 +60,7 @@ def test_init_with_template_connection(self):
                                   qubole_conn_id="{{ dag_run.conf['qubole_conn_id'] }}")
 
         result = task.render_template('qubole_conn_id', "{{ qubole_conn_id }}",
-                                      {'qubole_conn_id' : TEMPLATE_CONN})
+                                      {'qubole_conn_id': TEMPLATE_CONN})
         self.assertEqual(task.task_id, TASK_ID)
         self.assertEqual(result, TEMPLATE_CONN)
 
@@ -93,26 +93,22 @@ def test_hyphen_args_note_id(self):
         dag = DAG(DAG_ID, start_date=DEFAULT_DATE)
 
         with dag:
-            task = QuboleOperator(task_id=TASK_ID, command_type='sparkcmd',
-                                  note_id="123", dag=dag)
-        self.assertEqual(task.get_hook().create_cmd_args({'run_id':'dummy'})[0],
-                         "--note-id=123")
+            task = QuboleOperator(task_id=TASK_ID, command_type='sparkcmd', note_id="123", dag=dag)
+
+        self.assertEqual(task.get_hook().create_cmd_args({'run_id': 'dummy'})[0], "--note-id=123")
 
     def test_position_args_parameters(self):
         dag = DAG(DAG_ID, start_date=DEFAULT_DATE)
 
         with dag:
             task = QuboleOperator(task_id=TASK_ID, command_type='pigcmd',
-                          parameters="key1=value1 key2=value2", dag=dag)
+                                  parameters="key1=value1 key2=value2", dag=dag)
 
-        self.assertEqual(task.get_hook().create_cmd_args({'run_id':'dummy'})[1],
-                         "key1=value1")
-        self.assertEqual(task.get_hook().create_cmd_args({'run_id':'dummy'})[2],
-                         "key2=value2")
+        self.assertEqual(task.get_hook().create_cmd_args({'run_id': 'dummy'})[1], "key1=value1")
+        self.assertEqual(task.get_hook().create_cmd_args({'run_id': 'dummy'})[2], "key2=value2")
 
-        task = QuboleOperator(task_id=TASK_ID, command_type='hadoopcmd',
-                          sub_command="s3distcp --src s3n://airflow/source_hadoopcmd " +
-                                      "--dest s3n://airflow/destination_hadoopcmd", dag=dag)
+        cmd = "s3distcp --src s3n://airflow/source_hadoopcmd --dest s3n://airflow/destination_hadoopcmd"
+        task = QuboleOperator(task_id=TASK_ID, command_type='hadoopcmd', dag=dag, sub_command=cmd)
 
         self.assertEqual(task.get_hook().create_cmd_args({'run_id': 'dummy'})[1],
                          "s3distcp")
@@ -124,5 +120,3 @@ def test_position_args_parameters(self):
                          "--dest")
         self.assertEqual(task.get_hook().create_cmd_args({'run_id': 'dummy'})[5],
                          "s3n://airflow/destination_hadoopcmd")
-
-
diff --git a/tests/contrib/operators/test_sftp_operator.py b/tests/contrib/operators/test_sftp_operator.py
index 0877b216f60ab..1f1a1c01ae1ac 100644
--- a/tests/contrib/operators/test_sftp_operator.py
+++ b/tests/contrib/operators/test_sftp_operator.py
@@ -42,6 +42,7 @@ def reset(dag_id=TEST_DAG_ID):
     session.commit()
     session.close()
 
+
 reset()
 
 
@@ -101,18 +102,18 @@ def test_pickle_file_transfer_put(self):
 
         # check the remote file content
         check_file_task = SSHOperator(
-                task_id="test_check_file",
-                ssh_hook=self.hook,
-                command="cat {0}".format(self.test_remote_filepath),
-                do_xcom_push=True,
-                dag=self.dag
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="cat {0}".format(self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
         )
         self.assertIsNotNone(check_file_task)
         ti3 = TaskInstance(task=check_file_task, execution_date=timezone.utcnow())
         ti3.run()
         self.assertEqual(
-                ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
-                test_local_file_content)
+            ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
+            test_local_file_content)
 
     def test_file_transfer_no_intermediate_dir_error_put(self):
         configuration.conf.set("core", "enable_xcom_pickling", "True")
@@ -190,12 +191,12 @@ def test_json_file_transfer_put(self):
 
         # put test file to remote
         put_test_task = SFTPOperator(
-                task_id="test_sftp",
-                ssh_hook=self.hook,
-                local_filepath=self.test_local_filepath,
-                remote_filepath=self.test_remote_filepath,
-                operation=SFTPOperation.PUT,
-                dag=self.dag
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.PUT,
+            dag=self.dag
         )
         self.assertIsNotNone(put_test_task)
         ti2 = TaskInstance(task=put_test_task, execution_date=timezone.utcnow())
@@ -203,19 +204,18 @@ def test_json_file_transfer_put(self):
 
         # check the remote file content
         check_file_task = SSHOperator(
-                task_id="test_check_file",
-                ssh_hook=self.hook,
-                command="cat {0}".format(self.test_remote_filepath),
-                do_xcom_push=True,
-                dag=self.dag
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="cat {0}".format(self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
         )
         self.assertIsNotNone(check_file_task)
         ti3 = TaskInstance(task=check_file_task, execution_date=timezone.utcnow())
         ti3.run()
         self.assertEqual(
-                ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
-                b64encode(test_local_file_content).decode('utf-8'))
-
+            ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
+            b64encode(test_local_file_content).decode('utf-8'))
 
     def test_pickle_file_transfer_get(self):
         configuration.conf.set("core", "enable_xcom_pickling", "True")
@@ -225,12 +225,12 @@ def test_pickle_file_transfer_get(self):
 
         # create a test file remotely
         create_file_task = SSHOperator(
-                task_id="test_create_file",
-                ssh_hook=self.hook,
-                command="echo '{0}' > {1}".format(test_remote_file_content,
-                                                  self.test_remote_filepath),
-                do_xcom_push=True,
-                dag=self.dag
+            task_id="test_create_file",
+            ssh_hook=self.hook,
+            command="echo '{0}' > {1}".format(test_remote_file_content,
+                                              self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
         )
         self.assertIsNotNone(create_file_task)
         ti1 = TaskInstance(task=create_file_task, execution_date=timezone.utcnow())
@@ -238,12 +238,12 @@ def test_pickle_file_transfer_get(self):
 
         # get remote file to local
         get_test_task = SFTPOperator(
-                task_id="test_sftp",
-                ssh_hook=self.hook,
-                local_filepath=self.test_local_filepath,
-                remote_filepath=self.test_remote_filepath,
-                operation=SFTPOperation.GET,
-                dag=self.dag
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.GET,
+            dag=self.dag
         )
         self.assertIsNotNone(get_test_task)
         ti2 = TaskInstance(task=get_test_task, execution_date=timezone.utcnow())
@@ -263,12 +263,12 @@ def test_json_file_transfer_get(self):
 
         # create a test file remotely
         create_file_task = SSHOperator(
-                task_id="test_create_file",
-                ssh_hook=self.hook,
-                command="echo '{0}' > {1}".format(test_remote_file_content,
-                                                  self.test_remote_filepath),
-                do_xcom_push=True,
-                dag=self.dag
+            task_id="test_create_file",
+            ssh_hook=self.hook,
+            command="echo '{0}' > {1}".format(test_remote_file_content,
+                                              self.test_remote_filepath),
+            do_xcom_push=True,
+            dag=self.dag
         )
         self.assertIsNotNone(create_file_task)
         ti1 = TaskInstance(task=create_file_task, execution_date=timezone.utcnow())
@@ -276,12 +276,12 @@ def test_json_file_transfer_get(self):
 
         # get remote file to local
         get_test_task = SFTPOperator(
-                task_id="test_sftp",
-                ssh_hook=self.hook,
-                local_filepath=self.test_local_filepath,
-                remote_filepath=self.test_remote_filepath,
-                operation=SFTPOperation.GET,
-                dag=self.dag
+            task_id="test_sftp",
+            ssh_hook=self.hook,
+            local_filepath=self.test_local_filepath,
+            remote_filepath=self.test_remote_filepath,
+            operation=SFTPOperation.GET,
+            dag=self.dag
         )
         self.assertIsNotNone(get_test_task)
         ti2 = TaskInstance(task=get_test_task, execution_date=timezone.utcnow())
@@ -292,7 +292,7 @@ def test_json_file_transfer_get(self):
         with open(self.test_local_filepath, 'r') as f:
             content_received = f.read()
         self.assertEqual(content_received.strip(),
-            test_remote_file_content.encode('utf-8').decode('utf-8'))
+                         test_remote_file_content.encode('utf-8').decode('utf-8'))
 
     def test_file_transfer_no_intermediate_dir_error_get(self):
         configuration.conf.set("core", "enable_xcom_pickling", "True")
diff --git a/tests/contrib/operators/test_spark_sql_operator.py b/tests/contrib/operators/test_spark_sql_operator.py
index 8fa1428e5a5cb..19d58a977708a 100644
--- a/tests/contrib/operators/test_spark_sql_operator.py
+++ b/tests/contrib/operators/test_spark_sql_operator.py
@@ -28,7 +28,6 @@
 
 
 class TestSparkSqlOperator(unittest.TestCase):
-
     _config = {
         'sql': 'SELECT 22',
         'conn_id': 'spark_special_conn_id',
@@ -74,5 +73,6 @@ def test_execute(self):
         self.assertEqual(self._config['num_executors'], operator._num_executors)
         self.assertEqual(self._config['yarn_queue'], operator._yarn_queue)
 
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/contrib/operators/test_sqoop_operator.py b/tests/contrib/operators/test_sqoop_operator.py
index 83ffa6fb796d6..4586aebdde5ca 100644
--- a/tests/contrib/operators/test_sqoop_operator.py
+++ b/tests/contrib/operators/test_sqoop_operator.py
@@ -111,7 +111,7 @@ def test_execute(self):
         self.assertEqual(self._config['extra_export_options'], operator.extra_export_options)
 
         # the following are meant to be more of examples
-        sqoop_import_op = SqoopOperator(
+        SqoopOperator(
             task_id='sqoop_import_using_table',
             cmd_type='import',
             conn_id='sqoop_default',
@@ -125,12 +125,13 @@ def test_execute(self):
             dag=self.dag
         )
 
-        sqoop_import_op_qry = SqoopOperator(
+        SqoopOperator(
             task_id='sqoop_import_using_query',
             cmd_type='import',
             conn_id='sqoop_default',
             query='select name, age from company where $CONDITIONS',
-            split_by='age', # the mappers will pass in values to the $CONDITIONS based on the field you select to split by
+            split_by='age',
+            # the mappers will pass in values to the $CONDITIONS based on the field you select to split by
             verbose=True,
             num_mappers=None,
             hcatalog_database='default',
@@ -140,7 +141,7 @@ def test_execute(self):
             dag=self.dag
         )
 
-        sqoop_import_op_with_partition = SqoopOperator(
+        SqoopOperator(
             task_id='sqoop_import_with_partition',
             cmd_type='import',
             conn_id='sqoop_default',
@@ -157,7 +158,7 @@ def test_execute(self):
             dag=self.dag
         )
 
-        sqoop_export_op_name = SqoopOperator(
+        SqoopOperator(
             task_id='sqoop_export_tablename',
             cmd_type='export',
             conn_id='sqoop_default',
@@ -170,7 +171,7 @@ def test_execute(self):
             dag=self.dag
         )
 
-        sqoop_export_op_path = SqoopOperator(
+        SqoopOperator(
             task_id='sqoop_export_tablepath',
             cmd_type='export',
             conn_id='sqoop_default',
diff --git a/tests/contrib/operators/test_ssh_operator.py b/tests/contrib/operators/test_ssh_operator.py
index 1a2c788596671..00c4be679bb4b 100644
--- a/tests/contrib/operators/test_ssh_operator.py
+++ b/tests/contrib/operators/test_ssh_operator.py
@@ -40,6 +40,7 @@ def reset(dag_id=TEST_DAG_ID):
     session.commit()
     session.close()
 
+
 reset()
 
 
@@ -79,17 +80,17 @@ def test_hook_created_correctly(self):
     def test_json_command_execution(self):
         configuration.conf.set("core", "enable_xcom_pickling", "False")
         task = SSHOperator(
-                task_id="test",
-                ssh_hook=self.hook,
-                command="echo -n airflow",
-                do_xcom_push=True,
-                dag=self.dag,
+            task_id="test",
+            ssh_hook=self.hook,
+            command="echo -n airflow",
+            do_xcom_push=True,
+            dag=self.dag,
         )
 
         self.assertIsNotNone(task)
 
         ti = TaskInstance(
-                task=task, execution_date=timezone.utcnow())
+            task=task, execution_date=timezone.utcnow())
         ti.run()
         self.assertIsNotNone(ti.duration)
         self.assertEqual(ti.xcom_pull(task_ids='test', key='return_value'),
@@ -98,17 +99,17 @@ def test_json_command_execution(self):
     def test_pickle_command_execution(self):
         configuration.conf.set("core", "enable_xcom_pickling", "True")
         task = SSHOperator(
-                task_id="test",
-                ssh_hook=self.hook,
-                command="echo -n airflow",
-                do_xcom_push=True,
-                dag=self.dag,
+            task_id="test",
+            ssh_hook=self.hook,
+            command="echo -n airflow",
+            do_xcom_push=True,
+            dag=self.dag,
         )
 
         self.assertIsNotNone(task)
 
         ti = TaskInstance(
-                task=task, execution_date=timezone.utcnow())
+            task=task, execution_date=timezone.utcnow())
         ti.run()
         self.assertIsNotNone(ti.duration)
         self.assertEqual(ti.xcom_pull(task_ids='test', key='return_value'), b'airflow')
diff --git a/tests/contrib/operators/test_vertica_to_mysql.py b/tests/contrib/operators/test_vertica_to_mysql.py
index 615f111f840f4..c76c4d5dccc26 100644
--- a/tests/contrib/operators/test_vertica_to_mysql.py
+++ b/tests/contrib/operators/test_vertica_to_mysql.py
@@ -30,14 +30,14 @@ def mock_get_conn():
     commit_mock = mock.MagicMock(
     )
     cursor_mock = mock.MagicMock(
-        execute     = [],
-        fetchall    = [['1', '2', '3']],
-        description =  ['a', 'b', 'c'],
-        iterate     = [['1', '2', '3']],
+        execute=[],
+        fetchall=[['1', '2', '3']],
+        description=['a', 'b', 'c'],
+        iterate=[['1', '2', '3']],
     )
     conn_mock = mock.MagicMock(
-        commit      = commit_mock,
-        cursor      = cursor_mock,
+        commit=commit_mock,
+        cursor=cursor_mock,
     )
     return conn_mock
 
diff --git a/tests/contrib/sensors/test_emr_job_flow_sensor.py b/tests/contrib/sensors/test_emr_job_flow_sensor.py
index a66e52ffdf5f1..b50b270a85a3a 100644
--- a/tests/contrib/sensors/test_emr_job_flow_sensor.py
+++ b/tests/contrib/sensors/test_emr_job_flow_sensor.py
@@ -42,7 +42,8 @@
         'Status': {
             'State': 'STARTING',
             'StateChangeReason': {},
-            'Timeline': {'CreationDateTime': datetime.datetime(2016, 6, 27, 21, 5, 2, 348000, tzinfo=tzlocal())}
+            'Timeline': {
+                'CreationDateTime': datetime.datetime(2016, 6, 27, 21, 5, 2, 348000, tzinfo=tzlocal())}
         },
         'Tags': [
             {'Key': 'app', 'Value': 'analytics'},
@@ -74,7 +75,8 @@
         'Status': {
             'State': 'TERMINATED',
             'StateChangeReason': {},
-            'Timeline': {'CreationDateTime': datetime.datetime(2016, 6, 27, 21, 5, 2, 348000, tzinfo=tzlocal())}
+            'Timeline': {
+                'CreationDateTime': datetime.datetime(2016, 6, 27, 21, 5, 2, 348000, tzinfo=tzlocal())}
         },
         'Tags': [
             {'Key': 'app', 'Value': 'analytics'},
@@ -107,10 +109,8 @@ def setUp(self):
         # Mock out the emr_client creator
         self.boto3_session_mock = MagicMock(return_value=mock_emr_session)
 
-
     def test_execute_calls_with_the_job_flow_id_until_it_reaches_a_terminal_state(self):
         with patch('boto3.session.Session', self.boto3_session_mock):
-
             operator = EmrJobFlowSensor(
                 task_id='test_task',
                 poke_interval=2,
diff --git a/tests/contrib/sensors/test_jira_sensor_test.py b/tests/contrib/sensors/test_jira_sensor_test.py
index 06a7713f35d48..4b3f591e622e8 100644
--- a/tests/contrib/sensors/test_jira_sensor_test.py
+++ b/tests/contrib/sensors/test_jira_sensor_test.py
@@ -67,13 +67,13 @@ def setUp(self):
     def test_issue_label_set(self, jira_mock):
         jira_mock.return_value.issue.return_value = minimal_test_ticket
 
-        ticket_label_sensor = JiraTicketSensor(task_id='search-ticket-test',
-                                               ticket_id='TEST-1226',
-                                               field_checker_func=
-                                               TestJiraSensor.field_checker_func,
-                                               timeout=518400,
-                                               poke_interval=10,
-                                               dag=self.dag)
+        ticket_label_sensor = JiraTicketSensor(
+            task_id='search-ticket-test',
+            ticket_id='TEST-1226',
+            field_checker_func=TestJiraSensor.field_checker_func,
+            timeout=518400,
+            poke_interval=10,
+            dag=self.dag)
 
         ticket_label_sensor.run(start_date=DEFAULT_DATE,
                                 end_date=DEFAULT_DATE, ignore_ti_state=True)
diff --git a/tests/contrib/utils/__init__.py b/tests/contrib/utils/__init__.py
index fc532e61c6c64..db5ba598d7c23 100644
--- a/tests/contrib/utils/__init__.py
+++ b/tests/contrib/utils/__init__.py
@@ -17,4 +17,3 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-
diff --git a/tests/core.py b/tests/core.py
index c3ae9e1c66c94..12a97bb12757c 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -900,11 +900,11 @@ def test_task_fail_duration(self):
         session = settings.Session()
         try:
             p.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
-        except:
+        except Exception:
             pass
         try:
             f.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
-        except:
+        except Exception:
             pass
         p_fails = session.query(models.TaskFail).filter_by(
             task_id='pass_sleepy',
@@ -914,10 +914,9 @@ def test_task_fail_duration(self):
             task_id='fail_sleepy',
             dag_id=self.dag.dag_id,
             execution_date=DEFAULT_DATE).all()
-        print(f_fails)
+
         self.assertEqual(0, len(p_fails))
         self.assertEqual(1, len(f_fails))
-        # C
         self.assertGreaterEqual(sum([f.duration for f in f_fails]), 3)
 
     def test_dag_stats(self):
@@ -1671,7 +1670,7 @@ def _wait_pidfile(self, pidfile):
             try:
                 with open(pidfile) as f:
                     return int(f.read())
-            except:
+            except Exception:
                 sleep(1)
 
     def test_cli_webserver_foreground(self):
@@ -1781,7 +1780,7 @@ def test_csrf_acceptance(self):
     def test_xss(self):
         try:
             self.app.get("/admin/airflow/tree?dag_id=<script>alert(123456)</script>")
-        except:
+        except Exception:
             # exception is expected here since dag doesnt exist
             pass
         response = self.app.get("/admin/log", follow_redirects=True)
@@ -2223,7 +2222,7 @@ def setUp(self):
         configuration.conf.set("webserver", "auth_backend", "airflow.contrib.auth.backends.ldap_auth")
         try:
             configuration.conf.add_section("ldap")
-        except:
+        except Exception:
             pass
         configuration.conf.set("ldap", "uri", "ldap://openldap:389")
         configuration.conf.set("ldap", "user_filter", "objectClass=*")
@@ -2310,7 +2309,7 @@ def setUp(self):
         configuration.conf.set("webserver", "auth_backend", "airflow.contrib.auth.backends.ldap_auth")
         try:
             configuration.conf.add_section("ldap")
-        except:
+        except Exception:
             pass
         configuration.conf.set("ldap", "uri", "ldap://openldap:389")
         configuration.conf.set("ldap", "user_filter", "objectClass=*")
@@ -2649,6 +2648,7 @@ def test_get_ha_client(self, mock_get_connections):
         client = HDFSHook().get_conn()
         self.assertIsInstance(client, snakebite.client.HAClient)
 
+
 send_email_test = mock.Mock()
 
 
diff --git a/tests/dags/test_cli_triggered_dags.py b/tests/dags/test_cli_triggered_dags.py
index b0683be80f57a..611e24babbdea 100644
--- a/tests/dags/test_cli_triggered_dags.py
+++ b/tests/dags/test_cli_triggered_dags.py
@@ -42,14 +42,15 @@ def success(ti=None, *args, **kwargs):
 
 # DAG tests that tasks ignore all dependencies
 
-dag1 = DAG(dag_id='test_run_ignores_all_dependencies', default_args=dict(depends_on_past=True, **default_args))
+dag1 = DAG(dag_id='test_run_ignores_all_dependencies',
+           default_args=dict(depends_on_past=True, **default_args))
 dag1_task1 = PythonOperator(
     task_id='test_run_dependency_task',
     python_callable=fail,
-    dag=dag1,)
+    dag=dag1)
 dag1_task2 = PythonOperator(
     task_id='test_run_dependent_task',
     python_callable=success,
     provide_context=True,
-    dag=dag1,)
+    dag=dag1)
 dag1_task1.set_downstream(dag1_task2)
diff --git a/tests/dags/test_example_bash_operator.py b/tests/dags/test_example_bash_operator.py
index f9bd6c78631cb..a87db8dd7ccd7 100644
--- a/tests/dags/test_example_bash_operator.py
+++ b/tests/dags/test_example_bash_operator.py
@@ -46,7 +46,7 @@
 for i in range(3):
     i = str(i)
     task = BashOperator(
-        task_id='runme_'+i,
+        task_id='runme_' + i,
         bash_command='echo "{{ task_instance_key_str }}" && sleep 1',
         dag=dag)
     task.set_downstream(run_this)
diff --git a/tests/dags/test_issue_1225.py b/tests/dags/test_issue_1225.py
index b7bd5d5a24e7b..00d8a534d050e 100644
--- a/tests/dags/test_issue_1225.py
+++ b/tests/dags/test_issue_1225.py
@@ -37,9 +37,11 @@
     start_date=DEFAULT_DATE,
     owner='airflow')
 
+
 def fail():
     raise ValueError('Expected failure.')
 
+
 def delayed_fail():
     """
     Delayed failure to make sure that processes are running before the error
@@ -50,6 +52,7 @@ def delayed_fail():
     time.sleep(5)
     raise ValueError('Expected failure.')
 
+
 # DAG tests backfill with pooled tasks
 # Previously backfill would queue the task but never run it
 dag1 = DAG(dag_id='test_backfill_pooled_task_dag', default_args=default_args)
diff --git a/tests/dags/test_retry_handling_job.py b/tests/dags/test_retry_handling_job.py
index aae072e0bf4b5..a1112b9684e9e 100644
--- a/tests/dags/test_retry_handling_job.py
+++ b/tests/dags/test_retry_handling_job.py
@@ -24,7 +24,7 @@
 default_args = {
     'owner': 'airflow',
     'depends_on_past': False,
-    'start_date': datetime(2016,10,5,19),
+    'start_date': datetime(2016, 10, 5, 19),
     'email': ['airflow@example.com'],
     'email_on_failure': False,
     'email_on_retry': False,
@@ -38,4 +38,3 @@
     task_id='test_retry_handling_op',
     bash_command='exit 1',
     dag=dag)
-
diff --git a/tests/executors/test_base_executor.py b/tests/executors/test_base_executor.py
index 06a47541e404c..939b9f285563c 100644
--- a/tests/executors/test_base_executor.py
+++ b/tests/executors/test_base_executor.py
@@ -42,4 +42,3 @@ def test_get_event_buffer(self):
         self.assertEqual(len(executor.get_event_buffer(("my_dag1",))), 1)
         self.assertEqual(len(executor.get_event_buffer()), 2)
         self.assertEqual(len(executor.event_buffer), 0)
-
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index d5fbbbcf1c78c..dd999dca2066f 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -41,7 +41,7 @@ def test_celery_integration(self):
             # errors are propagated for some reason
             try:
                 executor.execute_async(key='fail', command=fail_command)
-            except:
+            except Exception:
                 pass
             executor.running['success'] = True
             executor.running['fail'] = True
diff --git a/tests/executors/test_executor.py b/tests/executors/test_executor.py
index a6fc54020f04e..1f373edc1be71 100644
--- a/tests/executors/test_executor.py
+++ b/tests/executors/test_executor.py
@@ -26,6 +26,7 @@ class TestExecutor(BaseExecutor):
     """
     TestExecutor is used for unit testing purposes.
     """
+
     def __init__(self, do_update=False, *args, **kwargs):
         self.do_update = do_update
         self._running = []
@@ -58,4 +59,3 @@ def terminate(self):
 
     def end(self):
         self.sync()
-
diff --git a/tests/executors/test_local_executor.py b/tests/executors/test_local_executor.py
index 91d1ec8196246..33cfbc4a6ba14 100644
--- a/tests/executors/test_local_executor.py
+++ b/tests/executors/test_local_executor.py
@@ -44,7 +44,7 @@ def execution_parallelism(self, parallelism=0):
         # errors are propagated for some reason
         try:
             executor.execute_async(key='fail', command=fail_command)
-        except:
+        except Exception:
             pass
 
         executor.running['fail'] = True
diff --git a/tests/hooks/__init__.py b/tests/hooks/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/hooks/__init__.py
+++ b/tests/hooks/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/hooks/test_docker_hook.py b/tests/hooks/test_docker_hook.py
index b8a0132e505ca..dd7ed4d44d388 100644
--- a/tests/hooks/test_docker_hook.py
+++ b/tests/hooks/test_docker_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -101,7 +101,7 @@ def test_get_conn_with_standard_config(self, _):
             )
             client = hook.get_conn()
             self.assertIsNotNone(client)
-        except:
+        except Exception:
             self.fail('Could not get connection from Airflow')
 
     def test_get_conn_with_extra_config(self, _):
@@ -113,7 +113,7 @@ def test_get_conn_with_extra_config(self, _):
             )
             client = hook.get_conn()
             self.assertIsNotNone(client)
-        except:
+        except Exception:
             self.fail('Could not get connection from Airflow')
 
     def test_conn_with_standard_config_passes_parameters(self, _):
@@ -157,7 +157,7 @@ def test_conn_with_broken_config_missing_username_fails(self, _):
             )
         )
         with self.assertRaises(AirflowException):
-            hook = DockerHook(
+            DockerHook(
                 docker_conn_id='docker_without_username',
                 base_url='unix://var/run/docker.sock',
                 version='auto'
@@ -173,7 +173,7 @@ def test_conn_with_broken_config_missing_host_fails(self, _):
             )
         )
         with self.assertRaises(AirflowException):
-            hook = DockerHook(
+            DockerHook(
                 docker_conn_id='docker_without_host',
                 base_url='unix://var/run/docker.sock',
                 version='auto'
diff --git a/tests/hooks/test_postgres_hook.py b/tests/hooks/test_postgres_hook.py
index 0520239e06ee8..5c87484ac200c 100644
--- a/tests/hooks/test_postgres_hook.py
+++ b/tests/hooks/test_postgres_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/hooks/test_slack_hook.py b/tests/hooks/test_slack_hook.py
index 46f8946411b1d..73193dff8cc6f 100644
--- a/tests/hooks/test_slack_hook.py
+++ b/tests/hooks/test_slack_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/jobs.py b/tests/jobs.py
index 77037f3100751..b755cd26f9a9b 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1303,7 +1303,7 @@ def test_process_executor_events(self):
         dag = DAG(dag_id=dag_id, start_date=DEFAULT_DATE)
         dag2 = DAG(dag_id=dag_id2, start_date=DEFAULT_DATE)
         task1 = DummyOperator(dag=dag, task_id=task_id_1)
-        task2 = DummyOperator(dag=dag2, task_id=task_id_1)
+        DummyOperator(dag=dag2, task_id=task_id_1)
 
         dagbag1 = self._make_simple_dag_bag([dag])
         dagbag2 = self._make_simple_dag_bag([dag2])
@@ -1479,7 +1479,7 @@ def test_find_executable_task_instances_pool(self):
             TI(task2, dr1.execution_date),
             TI(task1, dr2.execution_date),
             TI(task2, dr2.execution_date)
-            ])
+        ])
         for ti in tis:
             ti.state = State.SCHEDULED
             session.merge(ti)
@@ -1858,8 +1858,12 @@ def test_execute_task_instances(self):
         session.commit()
 
         self.assertEqual(State.RUNNING, dr1.state)
-        self.assertEqual(2, DAG.get_num_task_instances(dag_id, dag.task_ids,
-            states=[State.RUNNING], session=session))
+        self.assertEqual(
+            2,
+            DAG.get_num_task_instances(
+                dag_id, dag.task_ids, states=[State.RUNNING], session=session
+            )
+        )
 
         # create second dag run
         dr2 = scheduler.create_dag_run(dag)
@@ -1883,8 +1887,12 @@ def test_execute_task_instances(self):
         ti2.refresh_from_db()
         ti3.refresh_from_db()
         ti4.refresh_from_db()
-        self.assertEqual(3, DAG.get_num_task_instances(dag_id, dag.task_ids,
-            states=[State.RUNNING, State.QUEUED], session=session))
+        self.assertEqual(
+            3,
+            DAG.get_num_task_instances(
+                dag_id, dag.task_ids, states=[State.RUNNING, State.QUEUED], session=session
+            )
+        )
         self.assertEqual(State.RUNNING, ti1.state)
         self.assertEqual(State.RUNNING, ti2.state)
         six.assertCountEqual(self, [State.QUEUED, State.SCHEDULED], [ti3.state, ti4.state])
@@ -1931,43 +1939,26 @@ def test_execute_task_instances_limit(self):
     @unittest.skipUnless("INTEGRATION" in os.environ,
                          "The test is flaky with nondeterministic result")
     def test_change_state_for_tis_without_dagrun(self):
-        dag1 = DAG(
-            dag_id='test_change_state_for_tis_without_dagrun',
-            start_date=DEFAULT_DATE)
+        dag1 = DAG(dag_id='test_change_state_for_tis_without_dagrun', start_date=DEFAULT_DATE)
 
-        DummyOperator(
-            task_id='dummy',
-            dag=dag1,
-            owner='airflow')
-        DummyOperator(
-            task_id='dummy_b',
-            dag=dag1,
-            owner='airflow')
+        DummyOperator(task_id='dummy', dag=dag1, owner='airflow')
 
-        dag2 = DAG(
-            dag_id='test_change_state_for_tis_without_dagrun_dont_change',
-            start_date=DEFAULT_DATE)
+        DummyOperator(task_id='dummy_b', dag=dag1, owner='airflow')
 
-        DummyOperator(
-            task_id='dummy',
-            dag=dag2,
-            owner='airflow')
+        dag2 = DAG(dag_id='test_change_state_for_tis_without_dagrun_dont_change', start_date=DEFAULT_DATE)
 
-        dag3 = DAG(
-            dag_id='test_change_state_for_tis_without_dagrun_no_dagrun',
-            start_date=DEFAULT_DATE)
+        DummyOperator(task_id='dummy', dag=dag2, owner='airflow')
 
-        DummyOperator(
-            task_id='dummy',
-            dag=dag3,
-            owner='airflow')
+        dag3 = DAG(dag_id='test_change_state_for_tis_without_dagrun_no_dagrun', start_date=DEFAULT_DATE)
+
+        DummyOperator(task_id='dummy', dag=dag3, owner='airflow')
 
         session = settings.Session()
         dr1 = dag1.create_dagrun(run_id=DagRun.ID_PREFIX,
-                               state=State.RUNNING,
-                               execution_date=DEFAULT_DATE,
-                               start_date=DEFAULT_DATE,
-                               session=session)
+                                 state=State.RUNNING,
+                                 execution_date=DEFAULT_DATE,
+                                 start_date=DEFAULT_DATE,
+                                 session=session)
 
         dr2 = dag2.create_dagrun(run_id=DagRun.ID_PREFIX,
                                  state=State.RUNNING,
@@ -2353,7 +2344,7 @@ def test_scheduler_do_not_schedule_removed_task(self):
         dag = DAG(
             dag_id='test_scheduler_do_not_schedule_removed_task',
             start_date=DEFAULT_DATE)
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2383,7 +2374,7 @@ def test_scheduler_do_not_schedule_too_early(self):
         dag = DAG(
             dag_id='test_scheduler_do_not_schedule_too_early',
             start_date=timezone.datetime(2200, 1, 1))
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2409,7 +2400,7 @@ def test_scheduler_do_not_run_finished(self):
         dag = DAG(
             dag_id='test_scheduler_do_not_run_finished',
             start_date=DEFAULT_DATE)
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2445,7 +2436,7 @@ def test_scheduler_add_new_task(self):
             dag_id='test_scheduler_add_new_task',
             start_date=DEFAULT_DATE)
 
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2465,7 +2456,7 @@ def test_scheduler_add_new_task(self):
         tis = dr.get_task_instances()
         self.assertEquals(len(tis), 1)
 
-        dag_task2 = DummyOperator(
+        DummyOperator(
             task_id='dummy2',
             dag=dag,
             owner='airflow')
@@ -2485,7 +2476,7 @@ def test_scheduler_verify_max_active_runs(self):
             start_date=DEFAULT_DATE)
         dag.max_active_runs = 1
 
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2514,7 +2505,7 @@ def test_scheduler_fail_dagrun_timeout(self):
             start_date=DEFAULT_DATE)
         dag.dagrun_timeout = datetime.timedelta(seconds=60)
 
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2541,8 +2532,11 @@ def test_scheduler_fail_dagrun_timeout(self):
 
     def test_scheduler_verify_max_active_runs_and_dagrun_timeout(self):
         """
-        Test if a a dagrun will not be scheduled if max_dag_runs has been reached and dagrun_timeout is not reached
-        Test if a a dagrun will be scheduled if max_dag_runs has been reached but dagrun_timeout is also reached
+        Test if a a dagrun will not be scheduled if max_dag_runs
+        has been reached and dagrun_timeout is not reached
+
+        Test if a a dagrun will be scheduled if max_dag_runs has
+        been reached but dagrun_timeout is also reached
         """
         dag = DAG(
             dag_id='test_scheduler_verify_max_active_runs_and_dagrun_timeout',
@@ -2550,7 +2544,7 @@ def test_scheduler_verify_max_active_runs_and_dagrun_timeout(self):
         dag.max_active_runs = 1
         dag.dagrun_timeout = datetime.timedelta(seconds=60)
 
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2686,7 +2680,7 @@ def test_scheduler_auto_align(self):
             start_date=timezone.datetime(2016, 1, 1, 10, 10, 0),
             schedule_interval="4 5 * * *"
         )
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2708,7 +2702,7 @@ def test_scheduler_auto_align(self):
             start_date=timezone.datetime(2016, 1, 1, 10, 10, 0),
             schedule_interval="10 10 * * *"
         )
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2739,7 +2733,7 @@ def test_scheduler_reschedule(self):
         dag = DAG(
             dag_id='test_scheduler_reschedule',
             start_date=DEFAULT_DATE)
-        dag_task1 = DummyOperator(
+        DummyOperator(
             task_id='dummy',
             dag=dag,
             owner='airflow')
@@ -2784,7 +2778,8 @@ def test_scheduler_sla_miss_callback(self):
         # Mock the callback function so we can verify that it was not called
         sla_callback = MagicMock()
 
-        # Create dag with a start of 2 days ago, but an sla of 1 day ago so we'll already have an sla_miss on the books
+        # Create dag with a start of 2 days ago, but an sla of 1 day
+        # ago so we'll already have an sla_miss on the books
         test_start_date = days_ago(2)
         dag = DAG(dag_id='test_sla_miss',
                   sla_miss_callback=sla_callback,
@@ -2996,8 +2991,8 @@ def test_retry_handling_job(self):
         scheduler.run()
 
         session = settings.Session()
-        ti = session.query(TI).filter(TI.dag_id==dag.dag_id,
-                                      TI.task_id==dag_task1.task_id).first()
+        ti = session.query(TI).filter(TI.dag_id == dag.dag_id,
+                                      TI.task_id == dag_task1.task_id).first()
 
         # make sure the counter has increased
         self.assertEqual(ti.try_number, 2)
@@ -3059,7 +3054,8 @@ def test_dag_get_active_runs(self):
         """
 
         now = timezone.utcnow()
-        six_hours_ago_to_the_hour = (now - datetime.timedelta(hours=6)).replace(minute=0, second=0, microsecond=0)
+        six_hours_ago_to_the_hour = \
+            (now - datetime.timedelta(hours=6)).replace(minute=0, second=0, microsecond=0)
 
         START_DATE = six_hours_ago_to_the_hour
         DAG_NAME1 = 'get_active_runs_test'
@@ -3102,7 +3098,7 @@ def test_dag_get_active_runs(self):
 
         try:
             running_date = running_dates[0]
-        except:
+        except Exception as _:
             running_date = 'Except'
 
         self.assertEqual(execution_date, running_date, 'Running Date must match Execution Date')
@@ -3185,7 +3181,6 @@ def setup_dag(dag_id, schedule_interval, start_date, catchup):
         dr = scheduler.create_dag_run(dag4)
         self.assertIsNotNone(dr)
 
-
     def test_add_unparseable_file_before_sched_start_creates_import_error(self):
         dags_folder = mkdtemp()
         try:
diff --git a/tests/models.py b/tests/models.py
index cf5774d6057d1..09ab657170676 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -702,10 +702,10 @@ def test_dagstats_crud(self):
             default_args={'owner': 'owner1'})
 
         with dag:
-            op1 = DummyOperator(task_id='A')
+            DummyOperator(task_id='A')
 
         now = timezone.utcnow()
-        dr = dag.create_dagrun(
+        dag.create_dagrun(
             run_id='manual__' + now.isoformat(),
             execution_date=now,
             start_date=now,
@@ -976,8 +976,8 @@ def test_dagrun_no_deadlock_with_depends_on_past(self):
         dag = DAG('test_dagrun_no_deadlock',
                   start_date=DEFAULT_DATE)
         with dag:
-            op1 = DummyOperator(task_id='dop', depends_on_past=True)
-            op2 = DummyOperator(task_id='tc', task_concurrency=1)
+            DummyOperator(task_id='dop', depends_on_past=True)
+            DummyOperator(task_id='tc', task_concurrency=1)
 
         dag.clear()
         dr = dag.create_dagrun(run_id='test_dagrun_no_deadlock_1',
@@ -989,9 +989,9 @@ def test_dagrun_no_deadlock_with_depends_on_past(self):
                                 execution_date=DEFAULT_DATE + datetime.timedelta(days=1),
                                 start_date=DEFAULT_DATE + datetime.timedelta(days=1))
         ti1_op1 = dr.get_task_instance(task_id='dop')
-        ti2_op1 = dr2.get_task_instance(task_id='dop')
+        dr2.get_task_instance(task_id='dop')
         ti2_op1 = dr.get_task_instance(task_id='tc')
-        ti2_op2 = dr.get_task_instance(task_id='tc')
+        dr.get_task_instance(task_id='tc')
         ti1_op1.set_state(state=State.RUNNING, session=session)
         dr.update_state()
         dr2.update_state()
@@ -1192,7 +1192,7 @@ def test_get_task_instance_on_empty_dagrun(self):
             dag_id='test_get_task_instance_on_empty_dagrun',
             start_date=timezone.datetime(2017, 1, 1)
         )
-        dag_task1 = ShortCircuitOperator(
+        ShortCircuitOperator(
             task_id='test_short_circuit_false',
             dag=dag,
             python_callable=lambda: False)
@@ -1222,10 +1222,8 @@ def test_get_latest_runs(self):
         dag = DAG(
             dag_id='test_latest_runs_1',
             start_date=DEFAULT_DATE)
-        dag_1_run_1 = self.create_dag_run(dag,
-                execution_date=timezone.datetime(2015, 1, 1))
-        dag_1_run_2 = self.create_dag_run(dag,
-                execution_date=timezone.datetime(2015, 1, 2))
+        self.create_dag_run(dag, execution_date=timezone.datetime(2015, 1, 1))
+        self.create_dag_run(dag, execution_date=timezone.datetime(2015, 1, 2))
         dagruns = models.DagRun.get_latest_runs(session)
         session.close()
         for dagrun in dagruns:
@@ -1360,9 +1358,9 @@ def process_file(self, filepath, only_if_updated=True, safe_mode=True):
                 super(TestDagBag, self).process_file(filepath, only_if_updated, safe_mode)
 
         dagbag = TestDagBag(include_examples=True)
-        processed_files = dagbag.process_file_calls
+        dagbag.process_file_calls
 
-        # Should not call process_file agani, since it's already loaded during init.
+        # Should not call process_file again, since it's already loaded during init.
         self.assertEqual(1, dagbag.process_file_calls)
         self.assertIsNotNone(dagbag.get_dag(dag_id))
         self.assertEqual(1, dagbag.process_file_calls)
diff --git a/tests/operators/test_latest_only_operator.py b/tests/operators/test_latest_only_operator.py
index 1ed040765d041..7a4efa11b5af1 100644
--- a/tests/operators/test_latest_only_operator.py
+++ b/tests/operators/test_latest_only_operator.py
@@ -91,7 +91,7 @@ def test_skipping(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'success',
             timezone.datetime(2016, 1, 1, 12): 'success',
-            timezone.datetime(2016, 1, 2): 'success', },
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_latest_state)
 
         downstream_instances = get_task_instances('downstream')
@@ -157,7 +157,7 @@ def test_skipping_dagrun(self):
         self.assertEqual({
             timezone.datetime(2016, 1, 1): 'success',
             timezone.datetime(2016, 1, 1, 12): 'success',
-            timezone.datetime(2016, 1, 2): 'success', },
+            timezone.datetime(2016, 1, 2): 'success'},
             exec_date_to_latest_state)
 
         downstream_instances = get_task_instances('downstream')
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index 713ddfc3caadd..b4b08f1a464a3 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -157,8 +157,10 @@ def test_without_dag_run(self):
         """This checks the defensive against non existent tasks in a dag run"""
         value = False
         dag = DAG('shortcircuit_operator_test_without_dag_run',
-                  default_args={'owner': 'airflow',
-                                'start_date': DEFAULT_DATE},
+                  default_args={
+                      'owner': 'airflow',
+                      'start_date': DEFAULT_DATE
+                  },
                   schedule_interval=INTERVAL)
         short_op = ShortCircuitOperator(task_id='make_choice',
                                         dag=dag,
@@ -210,8 +212,10 @@ def test_without_dag_run(self):
     def test_with_dag_run(self):
         value = False
         dag = DAG('shortcircuit_operator_test_with_dag_run',
-                  default_args={'owner': 'airflow',
-                                'start_date': DEFAULT_DATE},
+                  default_args={
+                      'owner': 'airflow',
+                      'start_date': DEFAULT_DATE
+                  },
                   schedule_interval=INTERVAL)
         short_op = ShortCircuitOperator(task_id='make_choice',
                                         dag=dag,
diff --git a/tests/operators/test_s3_to_hive_operator.py b/tests/operators/test_s3_to_hive_operator.py
index 426566c40c7e5..bafa3eb191a79 100644
--- a/tests/operators/test_s3_to_hive_operator.py
+++ b/tests/operators/test_s3_to_hive_operator.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import unittest
+
 try:
     from unittest import mock
 except ImportError:
@@ -31,7 +32,7 @@
 from collections import OrderedDict
 from airflow.exceptions import AirflowException
 from tempfile import NamedTemporaryFile, mkdtemp
-import gzip
+from gzip import GzipFile
 import bz2
 import shutil
 import filecmp
@@ -85,39 +86,31 @@ def setUp(self):
                 self._set_fn(f_txt_h.name, '.txt', True)
                 f_txt_h.writelines([header, line1, line2])
             fn_gz = self._get_fn('.txt', True) + ".gz"
-            with gzip.GzipFile(filename=fn_gz,
-                               mode="wb") as f_gz_h:
+            with GzipFile(filename=fn_gz, mode="wb") as f_gz_h:
                 self._set_fn(fn_gz, '.gz', True)
                 f_gz_h.writelines([header, line1, line2])
             fn_gz_upper = self._get_fn('.txt', True) + ".GZ"
-            with gzip.GzipFile(filename=fn_gz_upper,
-                               mode="wb") as f_gz_upper_h:
+            with GzipFile(filename=fn_gz_upper, mode="wb") as f_gz_upper_h:
                 self._set_fn(fn_gz_upper, '.GZ', True)
                 f_gz_upper_h.writelines([header, line1, line2])
             fn_bz2 = self._get_fn('.txt', True) + '.bz2'
-            with bz2.BZ2File(filename=fn_bz2,
-                             mode="wb") as f_bz2_h:
+            with bz2.BZ2File(filename=fn_bz2, mode="wb") as f_bz2_h:
                 self._set_fn(fn_bz2, '.bz2', True)
                 f_bz2_h.writelines([header, line1, line2])
             # create sample txt, bz and bz2 without header
-            with NamedTemporaryFile(mode='wb+',
-                                    dir=self.tmp_dir,
-                                    delete=False) as f_txt_nh:
+            with NamedTemporaryFile(mode='wb+', dir=self.tmp_dir, delete=False) as f_txt_nh:
                 self._set_fn(f_txt_nh.name, '.txt', False)
                 f_txt_nh.writelines([line1, line2])
             fn_gz = self._get_fn('.txt', False) + ".gz"
-            with gzip.GzipFile(filename=fn_gz,
-                               mode="wb") as f_gz_nh:
+            with GzipFile(filename=fn_gz, mode="wb") as f_gz_nh:
                 self._set_fn(fn_gz, '.gz', False)
                 f_gz_nh.writelines([line1, line2])
             fn_gz_upper = self._get_fn('.txt', False) + ".GZ"
-            with gzip.GzipFile(filename=fn_gz_upper,
-                               mode="wb") as f_gz_upper_nh:
+            with GzipFile(filename=fn_gz_upper, mode="wb") as f_gz_upper_nh:
                 self._set_fn(fn_gz_upper, '.GZ', False)
                 f_gz_upper_nh.writelines([line1, line2])
             fn_bz2 = self._get_fn('.txt', False) + '.bz2'
-            with bz2.BZ2File(filename=fn_bz2,
-                             mode="wb") as f_bz2_nh:
+            with bz2.BZ2File(filename=fn_bz2, mode="wb") as f_bz2_nh:
                 self._set_fn(fn_bz2, '.bz2', False)
                 f_bz2_nh.writelines([line1, line2])
         # Base Exception so it catches Keyboard Interrupt
@@ -156,15 +149,13 @@ def _check_file_equality(fn_1, fn_2, ext):
         # causes filecmp to return False even if contents are identical
         # Hence decompress to test for equality
         if ext.lower() == '.gz':
-            with gzip.GzipFile(fn_1, 'rb') as f_1,\
-                    NamedTemporaryFile(mode='wb') as f_txt_1,\
-                    gzip.GzipFile(fn_2, 'rb') as f_2,\
-                    NamedTemporaryFile(mode='wb') as f_txt_2:
-                shutil.copyfileobj(f_1, f_txt_1)
-                shutil.copyfileobj(f_2, f_txt_2)
-                f_txt_1.flush()
-                f_txt_2.flush()
-                return filecmp.cmp(f_txt_1.name, f_txt_2.name, shallow=False)
+            with GzipFile(fn_1, 'rb') as f_1, NamedTemporaryFile(mode='wb') as f_txt_1:
+                with GzipFile(fn_2, 'rb') as f_2, NamedTemporaryFile(mode='wb') as f_txt_2:
+                    shutil.copyfileobj(f_1, f_txt_1)
+                    shutil.copyfileobj(f_2, f_txt_2)
+                    f_txt_1.flush()
+                    f_txt_2.flush()
+                    return filecmp.cmp(f_txt_1.name, f_txt_2.name, shallow=False)
         else:
             return filecmp.cmp(fn_1, fn_2, shallow=False)
 
@@ -179,20 +170,20 @@ def test_bad_parameters(self):
     def test__get_top_row_as_list(self):
         self.kwargs['delimiter'] = '\t'
         fn_txt = self._get_fn('.txt', True)
-        header_list = S3ToHiveTransfer(**self.kwargs).\
+        header_list = S3ToHiveTransfer(**self.kwargs). \
             _get_top_row_as_list(fn_txt)
         self.assertEqual(header_list, ['Sno', 'Some,Text'],
                          msg="Top row from file doesnt matched expected value")
 
         self.kwargs['delimiter'] = ','
-        header_list = S3ToHiveTransfer(**self.kwargs).\
+        header_list = S3ToHiveTransfer(**self.kwargs). \
             _get_top_row_as_list(fn_txt)
         self.assertEqual(header_list, ['Sno\tSome', 'Text'],
                          msg="Top row from file doesnt matched expected value")
 
     def test__match_headers(self):
         self.kwargs['field_dict'] = OrderedDict([('Sno', 'BIGINT'),
-                                                ('Some,Text', 'STRING')])
+                                                 ('Some,Text', 'STRING')])
         self.assertTrue(S3ToHiveTransfer(**self.kwargs).
                         _match_headers(['Sno', 'Some,Text']),
                         msg="Header row doesnt match expected value")
@@ -250,8 +241,7 @@ def test_execute(self, mock_hiveclihook):
             # file parameter to HiveCliHook.load_file is compared
             # against expected file output
             mock_hiveclihook().load_file.side_effect = \
-                lambda *args, **kwargs: \
-                self.assertTrue(
+                lambda *args, **kwargs: self.assertTrue(
                     self._check_file_equality(args[0], op_fn, ext),
                     msg='{0} output file not as expected'.format(ext))
             # Execute S3ToHiveTransfer
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index 39135c13069a5..c9afa0209a6a2 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -31,10 +31,12 @@
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.executors.base_executor import BaseExecutor
 
+
 # Will show up under airflow.hooks.test_plugin.PluginHook
 class PluginHook(BaseHook):
     pass
 
+
 # Will show up under airflow.operators.test_plugin.PluginOperator
 class PluginOperator(BaseOperator):
     pass
@@ -49,16 +51,21 @@ class PluginSensorOperator(BaseSensorOperator):
 class PluginExecutor(BaseExecutor):
     pass
 
+
 # Will show up under airflow.macros.test_plugin.plugin_macro
 def plugin_macro():
     pass
 
+
 # Creating a flask admin BaseView
 class TestView(BaseView):
     @expose('/')
     def test(self):
-        # in this example, put your test_plugin/test.html template at airflow/plugins/templates/test_plugin/test.html
+        # in this example, put your test_plugin/test.html
+        # template at airflow/plugins/templates/test_plugin/test.html
         return self.render("test_plugin/test.html", content="Hello galaxy!")
+
+
 v = TestView(category="Test Plugin", name="Test View")
 
 
@@ -86,7 +93,7 @@ def test(self):
 # Creating a flask blueprint to intergrate the templates and static folder
 bp = Blueprint(
     "test_plugin", __name__,
-    template_folder='templates', # registers airflow/plugins/templates as a Jinja template folder
+    template_folder='templates',  # registers airflow/plugins/templates as a Jinja template folder
     static_folder='static',
     static_url_path='/static/test_plugin')
 
diff --git a/tests/plugins_manager.py b/tests/plugins_manager.py
index 0013d9f641f3c..6bd9d61085dfb 100644
--- a/tests/plugins_manager.py
+++ b/tests/plugins_manager.py
@@ -32,7 +32,7 @@
 
 from airflow.configuration import conf
 from airflow.hooks.base_hook import BaseHook
-from airflow.models import  BaseOperator
+from airflow.models import BaseOperator
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.executors.base_executor import BaseExecutor
 from airflow.www.app import cached_app
diff --git a/tests/sensors/test_sql_sensor.py b/tests/sensors/test_sql_sensor.py
index 960bdd21ed1aa..e8564623051be 100644
--- a/tests/sensors/test_sql_sensor.py
+++ b/tests/sensors/test_sql_sensor.py
@@ -38,6 +38,11 @@ def setUp(self):
         }
         self.dag = DAG(TEST_DAG_ID, default_args=args)
 
+<<<<<<< HEAD
+=======
+    @unittest.skipUnless(
+        'mysql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a mysql test")
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
     def test_sql_sensor_mysql(self):
         t = SqlSensor(
             task_id='sql_sensor_check',
@@ -47,6 +52,11 @@ def test_sql_sensor_mysql(self):
         )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+<<<<<<< HEAD
+=======
+    @unittest.skipUnless(
+        'postgresql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a postgres test")
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
     def test_sql_sensor_postgres(self):
         t = SqlSensor(
             task_id='sql_sensor_check',
@@ -55,3 +65,22 @@ def test_sql_sensor_postgres(self):
             dag=self.dag
         )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+<<<<<<< HEAD
+=======
+
+    @mock.patch('airflow.sensors.sql_sensor.BaseHook')
+    def test_sql_sensor_postgres_poke(self, mock_hook):
+        t = SqlSensor(
+            task_id='sql_sensor_check',
+            conn_id='postgres_default',
+            sql="SELECT 1",
+        )
+
+        mock_get_records = mock_hook.get_connection.return_value.get_hook.return_value.get_records
+
+        mock_get_records.return_value = []
+        self.assertFalse(t.poke(None))
+
+        mock_get_records.return_value = [['1']]
+        self.assertTrue(t.poke(None))
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
diff --git a/tests/task/task_runner/__init__.py b/tests/task/task_runner/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/task/task_runner/__init__.py
+++ b/tests/task/task_runner/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/test_logging_config.py b/tests/test_logging_config.py
index b568a88cb2422..324e33a3acb2b 100644
--- a/tests/test_logging_config.py
+++ b/tests/test_logging_config.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -148,7 +148,7 @@ def __enter__(self):
         return self.settings_file
 
     def __exit__(self, *exc_info):
-        #shutil.rmtree(self.settings_root)
+        # shutil.rmtree(self.settings_root)
         # Reset config
         conf.set('core', 'logging_config_class', '')
         sys.path.remove(self.settings_root)
diff --git a/tests/ti_deps/deps/test_runnable_exec_date_dep.py b/tests/ti_deps/deps/test_runnable_exec_date_dep.py
index 643985ce4c0cb..c555921782e89 100644
--- a/tests/ti_deps/deps/test_runnable_exec_date_dep.py
+++ b/tests/ti_deps/deps/test_runnable_exec_date_dep.py
@@ -25,6 +25,7 @@
 from airflow.ti_deps.deps.runnable_exec_date_dep import RunnableExecDateDep
 from airflow.utils.timezone import datetime
 
+
 class RunnableExecDateDepTest(unittest.TestCase):
 
     def _get_task_instance(self, execution_date, dag_end_date=None, task_end_date=None):
diff --git a/tests/ti_deps/deps/test_task_concurrency.py b/tests/ti_deps/deps/test_task_concurrency.py
index fd1b28da33967..426b9838de5b9 100644
--- a/tests/ti_deps/deps/test_task_concurrency.py
+++ b/tests/ti_deps/deps/test_task_concurrency.py
@@ -53,4 +53,3 @@ def test_reached_concurrency(self):
         self.assertTrue(TaskConcurrencyDep().is_met(ti=ti, dep_context=dep_context))
         ti.get_num_running_task_instances = lambda x: 2
         self.assertFalse(TaskConcurrencyDep().is_met(ti=ti, dep_context=dep_context))
-
diff --git a/tests/utils.py b/tests/utils.py
index 12d3ff037b264..fadb139dd1046 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -62,6 +62,7 @@ def test_gcs_url_parse(self):
             glog.parse_gcs_url('gs://bucket/'),
             ('bucket', ''))
 
+
 class OperatorResourcesTest(unittest.TestCase):
 
     def setUp(self):
diff --git a/tests/utils/test_dates.py b/tests/utils/test_dates.py
index ba762c8d09cfe..d44f55171c9d7 100644
--- a/tests/utils/test_dates.py
+++ b/tests/utils/test_dates.py
@@ -33,26 +33,22 @@ def test_days_ago(self):
 
         self.assertTrue(dates.days_ago(0) == today_midnight)
 
-        self.assertTrue(
-            dates.days_ago(100) == today_midnight + timedelta(days=-100))
-
-        self.assertTrue(
-            dates.days_ago(0, hour=3) == today_midnight + timedelta(hours=3))
-        self.assertTrue(
-            dates.days_ago(0, minute=3)
-            == today_midnight + timedelta(minutes=3))
-        self.assertTrue(
-            dates.days_ago(0, second=3)
-            == today_midnight + timedelta(seconds=3))
-        self.assertTrue(
-            dates.days_ago(0, microsecond=3)
-            == today_midnight + timedelta(microseconds=3))
+        self.assertTrue(dates.days_ago(100) == today_midnight + timedelta(days=-100))
+
+        self.assertTrue(dates.days_ago(0, hour=3) == today_midnight + timedelta(hours=3))
+        self.assertTrue(dates.days_ago(0, minute=3) == today_midnight + timedelta(minutes=3))
+        self.assertTrue(dates.days_ago(0, second=3) == today_midnight + timedelta(seconds=3))
+        self.assertTrue(dates.days_ago(0, microsecond=3) == today_midnight + timedelta(microseconds=3))
 
     def test_parse_execution_date(self):
         execution_date_str_wo_ms = '2017-11-02 00:00:00'
         execution_date_str_w_ms = '2017-11-05 16:18:30.989729'
         bad_execution_date_str = '2017-11-06TXX:00:00Z'
 
-        self.assertEqual(timezone.datetime(2017, 11, 2, 0, 0, 0), dates.parse_execution_date(execution_date_str_wo_ms))
-        self.assertEqual(timezone.datetime(2017, 11, 5, 16, 18, 30, 989729), dates.parse_execution_date(execution_date_str_w_ms))
+        self.assertEqual(
+            timezone.datetime(2017, 11, 2, 0, 0, 0),
+            dates.parse_execution_date(execution_date_str_wo_ms))
+        self.assertEqual(
+            timezone.datetime(2017, 11, 5, 16, 18, 30, 989729),
+            dates.parse_execution_date(execution_date_str_w_ms))
         self.assertRaises(ValueError, dates.parse_execution_date, bad_execution_date_str)
diff --git a/tests/utils/test_log_handlers.py b/tests/utils/test_log_handlers.py
index d9623ee113604..8acc5a252967a 100644
--- a/tests/utils/test_log_handlers.py
+++ b/tests/utils/test_log_handlers.py
@@ -169,14 +169,18 @@ def setUp(self):
         self.ti = TaskInstance(task=task, execution_date=DEFAULT_DATE)
 
     def test_python_formatting(self):
-        expected_filename = 'dag_for_testing_filename_rendering/task_for_testing_filename_rendering/%s/42.log' % DEFAULT_DATE.isoformat()
+        expected_filename = \
+            'dag_for_testing_filename_rendering/task_for_testing_filename_rendering/%s/42.log' \
+            % DEFAULT_DATE.isoformat()
 
         fth = FileTaskHandler('', '{dag_id}/{task_id}/{execution_date}/{try_number}.log')
         rendered_filename = fth._render_filename(self.ti, 42)
         self.assertEqual(expected_filename, rendered_filename)
 
     def test_jinja_rendering(self):
-        expected_filename = 'dag_for_testing_filename_rendering/task_for_testing_filename_rendering/%s/42.log' % DEFAULT_DATE.isoformat()
+        expected_filename = \
+            'dag_for_testing_filename_rendering/task_for_testing_filename_rendering/%s/42.log' \
+            % DEFAULT_DATE.isoformat()
 
         fth = FileTaskHandler('', '{{ ti.dag_id }}/{{ ti.task_id }}/{{ ts }}/{{ try_number }}.log')
         rendered_filename = fth._render_filename(self.ti, 42)
diff --git a/tests/utils/test_logging_mixin.py b/tests/utils/test_logging_mixin.py
index 6d795584d9bfd..d23da5c90cb15 100644
--- a/tests/utils/test_logging_mixin.py
+++ b/tests/utils/test_logging_mixin.py
@@ -120,4 +120,3 @@ def test_encoding(self):
 
         log = StreamLogWriter(logger, 1)
         self.assertFalse(log.encoding)
-
diff --git a/tests/utils/test_timezone.py b/tests/utils/test_timezone.py
index 0b44bddaaea28..861b6d071ed73 100644
--- a/tests/utils/test_timezone.py
+++ b/tests/utils/test_timezone.py
@@ -24,8 +24,8 @@
 from airflow.utils import timezone
 
 CET = pendulum.timezone("Europe/Paris")
-EAT = pendulum.timezone('Africa/Nairobi')      # Africa/Nairobi
-ICT = pendulum.timezone('Asia/Bangkok')      # Asia/Bangkok
+EAT = pendulum.timezone('Africa/Nairobi')  # Africa/Nairobi
+ICT = pendulum.timezone('Asia/Bangkok')  # Asia/Bangkok
 UTC = timezone.utc
 
 
@@ -69,4 +69,3 @@ def test_make_aware(self):
             datetime.datetime(2011, 9, 1, 13, 20, 30, tzinfo=EAT))
         with self.assertRaises(ValueError):
             timezone.make_aware(datetime.datetime(2011, 9, 1, 13, 20, 30, tzinfo=EAT), EAT)
-
diff --git a/tests/www/__init__.py b/tests/www/__init__.py
index f0f8b68337da6..4067cc78ee9a2 100644
--- a/tests/www/__init__.py
+++ b/tests/www/__init__.py
@@ -16,4 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/tests/www/api/__init__.py b/tests/www/api/__init__.py
index f0f8b68337da6..4067cc78ee9a2 100644
--- a/tests/www/api/__init__.py
+++ b/tests/www/api/__init__.py
@@ -16,4 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/tests/www/api/experimental/__init__.py b/tests/www/api/experimental/__init__.py
index f0f8b68337da6..4067cc78ee9a2 100644
--- a/tests/www/api/experimental/__init__.py
+++ b/tests/www/api/experimental/__init__.py
@@ -16,4 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
diff --git a/tests/www/api/experimental/test_kerberos_endpoints.py b/tests/www/api/experimental/test_kerberos_endpoints.py
index 1cf30635fa407..d5058709bcc4d 100644
--- a/tests/www/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www/api/experimental/test_kerberos_endpoints.py
@@ -38,14 +38,14 @@ def setUp(self):
         configuration.load_test_config()
         try:
             configuration.conf.add_section("api")
-        except:
+        except Exception:
             pass
         configuration.conf.set("api",
                                "auth_backend",
                                "airflow.api.auth.backend.kerberos_auth")
         try:
             configuration.conf.add_section("kerberos")
-        except:
+        except Exception:
             pass
         configuration.conf.set("kerberos",
                                "keytab",
diff --git a/tests/www/test_validators.py b/tests/www/test_validators.py
index 0fef4e3db202d..7ad5b17d55e7f 100644
--- a/tests/www/test_validators.py
+++ b/tests/www/test_validators.py
@@ -92,6 +92,5 @@ def test_validation_raises_custom_message(self):
         )
 
 
-
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/www_rbac/__init__.py b/tests/www_rbac/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www_rbac/__init__.py
+++ b/tests/www_rbac/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/api/__init__.py b/tests/www_rbac/api/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www_rbac/api/__init__.py
+++ b/tests/www_rbac/api/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/api/experimental/__init__.py b/tests/www_rbac/api/experimental/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www_rbac/api/experimental/__init__.py
+++ b/tests/www_rbac/api/experimental/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/api/experimental/test_kerberos_endpoints.py b/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
index 54bbd865b3724..788613b504ba4 100644
--- a/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www_rbac/api/experimental/test_kerberos_endpoints.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index 68d1744ab8fa8..84bf6ce8aeb07 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/test_validators.py b/tests/www_rbac/test_validators.py
index d7709c4ee76c2..b50e88de11c5a 100644
--- a/tests/www_rbac/test_validators.py
+++ b/tests/www_rbac/test_validators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 7f86c17db5e87..3d6841540628b 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -173,7 +173,7 @@ def test_xss_prevention(self):
         self.assertNotIn("<img src='' onerror='alert(1);'>",
                          resp.data.decode("utf-8"))
 
-    def test_import_variables(self):
+    def test_import_variables_failed(self):
         content = '{"str_key": "str_value"}'
 
         with mock.patch('airflow.models.Variable.set') as set_mock:
@@ -192,7 +192,7 @@ def test_import_variables(self):
                                     follow_redirects=True)
             self.check_content_in_response('1 variable(s) failed to be updated.', resp)
 
-    def test_import_variables(self):
+    def test_import_variables_success(self):
         self.assertEqual(self.session.query(models.Variable).count(), 0)
 
         content = ('{"str_key": "str_value", "int_key": 60,'
diff --git a/tox.ini b/tox.ini
index acbeb970e7ffb..55d19915c855e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -26,10 +26,13 @@ find_links =
     {homedir}/.wheelhouse
     {homedir}/.pip-cache
 
+<<<<<<< HEAD
 [flake8]
 max-line-length = 110
 ignore = E731,W503
 
+=======
+>>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
 [testenv]
 deps =
     wheel
@@ -71,5 +74,4 @@ basepython = python3
 deps =
     flake8==3.5.0
 
-commands =
-    {toxinidir}/scripts/ci/flake8-diff.sh
+commands = flake8

From 1929ffa7a59bcccb8ad99f9cae566df00d97187c Mon Sep 17 00:00:00 2001
From: Riccardo Bini <odracci@gmail.com>
Date: Mon, 31 Dec 2018 06:03:33 +0100
Subject: [PATCH 361/808] [AIRFLOW-3281] Fix Kubernetes operator with git-sync
 (#3770)

---
 .coveragerc                                   |   1 +
 .rat-excludes                                 |   1 +
 .travis.yml                                   |  11 +-
 airflow/config_templates/default_airflow.cfg  |  18 ++-
 .../example_kubernetes_executor_config.py     |   9 +-
 airflow/contrib/example_dags/libs/__init__.py |  18 +++
 airflow/contrib/example_dags/libs/helper.py   |  22 +++
 .../contrib/executors/kubernetes_executor.py  |  29 +++-
 .../kubernetes/worker_configuration.py        | 140 ++++++++++--------
 airflow/www_rbac/compile_assets.sh            |   7 +-
 docs/kubernetes.rst                           |   4 +-
 scripts/ci/5-run-tests.sh                     |   6 +
 scripts/ci/kubernetes/README.md               |   2 +-
 .../docker/airflow-test-env-init.sh           |   3 +
 scripts/ci/kubernetes/docker/build.sh         |  12 +-
 scripts/ci/kubernetes/docker/compile.sh       |  32 ++++
 scripts/ci/kubernetes/kube/deploy.sh          | 126 +++++++++++++++-
 .../airflow.template.yaml}                    |  25 +---
 .../configmaps.template.yaml}                 |  19 ++-
 .../templates/init_git_sync.template.yaml     |  36 +++++
 .../ci/kubernetes/minikube/start_minikube.sh  |   6 +-
 .../ci/kubernetes/minikube/stop_minikube.sh   |  39 +++++
 scripts/ci/kubernetes/setup_kubernetes.sh     |   5 +
 scripts/ci/run-ci.sh                          |   5 +-
 .../executors/test_kubernetes_executor.py     |  85 +++++++++--
 .../minikube/test_kubernetes_executor.py      |  14 +-
 26 files changed, 547 insertions(+), 128 deletions(-)
 create mode 100644 airflow/contrib/example_dags/libs/__init__.py
 create mode 100644 airflow/contrib/example_dags/libs/helper.py
 create mode 100755 scripts/ci/kubernetes/docker/compile.sh
 rename scripts/ci/kubernetes/kube/{airflow.yaml => templates/airflow.template.yaml} (89%)
 rename scripts/ci/kubernetes/kube/{configmaps.yaml => templates/configmaps.template.yaml} (96%)
 create mode 100644 scripts/ci/kubernetes/kube/templates/init_git_sync.template.yaml
 create mode 100755 scripts/ci/kubernetes/minikube/stop_minikube.sh

diff --git a/.coveragerc b/.coveragerc
index 249fcf15ddb4b..3fa052108477e 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -23,3 +23,4 @@ omit =
     scripts/*
     dev/*
     airflow/migrations/*
+    airflow/www_rbac/node_modules/**
diff --git a/.rat-excludes b/.rat-excludes
index 916e9e268971d..786920076dd57 100644
--- a/.rat-excludes
+++ b/.rat-excludes
@@ -54,6 +54,7 @@ node_modules/*
 coverage/*
 git_version
 flake8_diff.sh
+coverage.xml
 
 rat-results.txt
 apache-airflow-.*\+source.tar.gz.*
diff --git a/.travis.yml b/.travis.yml
index dd493363ab1e7..934b0d749b1f1 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -51,11 +51,18 @@ install:
   - chmod +x docker-compose
   - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
-  - if [ ! -z "$KUBERNETES_VERSION" ]; then ./scripts/ci/kubernetes/setup_kubernetes.sh; fi
 script:
   - if [ -z "$KUBERNETES_VERSION" ]; then docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh; fi
   - if [ ! -z "$KUBERNETES_VERSION" ]; then
-      ./scripts/ci/kubernetes/kube/deploy.sh &&
+      ./scripts/ci/kubernetes/minikube/stop_minikube.sh &&
+      ./scripts/ci/kubernetes/setup_kubernetes.sh &&
+      ./scripts/ci/kubernetes/kube/deploy.sh -d persistent_mode &&
+      MINIKUBE_IP=$(minikube ip) docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml -f scripts/ci/docker-compose-kubernetes.yml run airflow-testing /app/scripts/ci/run-ci.sh;
+    fi
+  - if [ ! -z "$KUBERNETES_VERSION" ]; then
+      ./scripts/ci/kubernetes/minikube/stop_minikube.sh &&
+      ./scripts/ci/kubernetes/setup_kubernetes.sh &&
+      ./scripts/ci/kubernetes/kube/deploy.sh -d git_mode &&
       MINIKUBE_IP=$(minikube ip) docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml -f scripts/ci/docker-compose-kubernetes.yml run airflow-testing /app/scripts/ci/run-ci.sh;
     fi
 before_cache:
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index a72604a536c01..585275cd92470 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -78,7 +78,7 @@ hostname_callable = socket:getfqdn
 default_timezone = utc
 
 # The executor class that airflow should use. Choices include
-# SequentialExecutor, LocalExecutor, CeleryExecutor, DaskExecutor
+# SequentialExecutor, LocalExecutor, CeleryExecutor, DaskExecutor, KubernetesExecutor
 executor = SequentialExecutor
 
 # The SqlAlchemy connection string to the metadata database.
@@ -572,7 +572,6 @@ elasticsearch_end_of_log_mark = end_of_log
 worker_container_repository =
 worker_container_tag =
 worker_container_image_pull_policy = IfNotPresent
-worker_dags_folder =
 
 # If True (default), worker pods will be deleted upon termination
 delete_worker_pods = True
@@ -590,7 +589,7 @@ dags_in_image = False
 # For either git sync or volume mounted DAGs, the worker will look in this subpath for DAGs
 dags_volume_subpath =
 
-# For DAGs mounted via a volume claim (mutually exclusive with volume claim)
+# For DAGs mounted via a volume claim (mutually exclusive with git-sync and host path)
 dags_volume_claim =
 
 # For volume mounted logs, the worker will look in this subpath for logs
@@ -599,12 +598,25 @@ logs_volume_subpath =
 # A shared volume claim for the logs
 logs_volume_claim =
 
+# For DAGs mounted via a hostPath volume (mutually exclusive with volume claim and git-sync)
+# Useful in local environment, discouraged in production
+dags_volume_host =
+
+# A hostPath volume for the logs
+# Useful in local environment, discouraged in production
+logs_volume_host =
+
 # Git credentials and repository for DAGs mounted via Git (mutually exclusive with volume claim)
 git_repo =
 git_branch =
 git_user =
 git_password =
 git_subpath =
+git_sync_root = /git
+git_sync_dest = repo
+# Mount point of the volume if git-sync is being used.
+# i.e. {AIRFLOW_HOME}/dags
+git_dags_folder_mount_point =
 
 # For cloning DAGs from git repositories into volumes: https://github.com/kubernetes/git-sync
 git_sync_container_repository = gcr.io/google-containers/git-sync-amd64
diff --git a/airflow/contrib/example_dags/example_kubernetes_executor_config.py b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
index 3aa70f862b4d4..1b194499b28ec 100644
--- a/airflow/contrib/example_dags/example_kubernetes_executor_config.py
+++ b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
@@ -19,6 +19,7 @@
 from __future__ import print_function
 import airflow
 from airflow.operators.python_operator import PythonOperator
+from libs.helper import print_stuff
 from airflow.models import DAG
 import os
 
@@ -33,10 +34,6 @@
 )
 
 
-def print_stuff():
-    print("annotated!")
-
-
 def test_volume_mount():
     with open('/foo/volume_mount_test.txt', 'w') as foo:
         foo.write('Hello')
@@ -62,14 +59,14 @@ def test_volume_mount():
         "KubernetesExecutor": {
             "volumes": [
                 {
-                    "name": "test-volume",
+                    "name": "example-kubernetes-test-volume",
                     "hostPath": {"path": "/tmp/"},
                 },
             ],
             "volume_mounts": [
                 {
                     "mountPath": "/foo/",
-                    "name": "test-volume",
+                    "name": "example-kubernetes-test-volume",
                 },
             ]
         }
diff --git a/airflow/contrib/example_dags/libs/__init__.py b/airflow/contrib/example_dags/libs/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/airflow/contrib/example_dags/libs/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/airflow/contrib/example_dags/libs/helper.py b/airflow/contrib/example_dags/libs/helper.py
new file mode 100644
index 0000000000000..d7b62e65c7c88
--- /dev/null
+++ b/airflow/contrib/example_dags/libs/helper.py
@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+def print_stuff():
+    print("annotated!")
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index e06a5f47e1ed0..53756d1e17b61 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -127,8 +127,6 @@ def __init__(self):
             self.kubernetes_section, 'worker_container_repository')
         self.worker_container_tag = configuration.get(
             self.kubernetes_section, 'worker_container_tag')
-        self.worker_dags_folder = configuration.get(
-            self.kubernetes_section, 'worker_dags_folder')
         self.kube_image = '{}:{}'.format(
             self.worker_container_repository, self.worker_container_tag)
         self.kube_image_pull_policy = configuration.get(
@@ -153,6 +151,14 @@ def __init__(self):
         self.git_branch = conf.get(self.kubernetes_section, 'git_branch')
         # Optionally, the directory in the git repository containing the dags
         self.git_subpath = conf.get(self.kubernetes_section, 'git_subpath')
+        # Optionally, the root directory for git operations
+        self.git_sync_root = conf.get(self.kubernetes_section, 'git_sync_root')
+        # Optionally, the name at which to publish the checked-out files under --root
+        self.git_sync_dest = conf.get(self.kubernetes_section, 'git_sync_dest')
+        # Optionally, if git_dags_folder_mount_point is set the worker will use
+        # {git_dags_folder_mount_point}/{git_sync_dest}/{git_subpath} as dags_folder
+        self.git_dags_folder_mount_point = conf.get(self.kubernetes_section,
+                                                    'git_dags_folder_mount_point')
 
         # Optionally a user may supply a `git_user` and `git_password` for private
         # repositories
@@ -176,6 +182,12 @@ def __init__(self):
         self.logs_volume_subpath = conf.get(
             self.kubernetes_section, 'logs_volume_subpath')
 
+        # Optionally, hostPath volume containing DAGs
+        self.dags_volume_host = conf.get(self.kubernetes_section, 'dags_volume_host')
+
+        # Optionally, write logs to a hostPath Volume
+        self.logs_volume_host = conf.get(self.kubernetes_section, 'logs_volume_host')
+
         # This prop may optionally be set for PV Claims and is used to write logs
         self.base_log_folder = configuration.get(self.core_section, 'base_log_folder')
 
@@ -225,12 +237,17 @@ def __init__(self):
         self._validate()
 
     def _validate(self):
-        if not self.dags_volume_claim and not self.dags_in_image \
-                and (not self.git_repo or not self.git_branch):
+        # TODO: use XOR for dags_volume_claim and git_dags_folder_mount_point
+        if not self.dags_volume_claim \
+           and not self.dags_volume_host \
+           and not self.dags_in_image \
+           and (not self.git_repo or not self.git_branch or not self.git_dags_folder_mount_point):
             raise AirflowConfigException(
                 'In kubernetes mode the following must be set in the `kubernetes` '
-                'config section: `dags_volume_claim` or `git_repo and git_branch` '
-                'or `dags_in_image`')
+                'config section: `dags_volume_claim` '
+                'or `dags_volume_host` '
+                'or `dags_in_image` '
+                'or `git_repo and git_branch and git_dags_folder_mount_point`')
 
 
 class KubernetesJobWatcher(multiprocessing.Process, LoggingMixin, object):
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index c2e7768baae8f..165db956f2e5d 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -19,6 +19,7 @@
 import os
 import six
 
+from airflow import AirflowException
 from airflow.configuration import conf
 from airflow.contrib.kubernetes.pod import Pod, Resources
 from airflow.contrib.kubernetes.secret import Secret
@@ -33,12 +34,17 @@ def __init__(self, kube_config):
         self.worker_airflow_home = self.kube_config.airflow_home
         self.worker_airflow_dags = self.kube_config.dags_folder
         self.worker_airflow_logs = self.kube_config.base_log_folder
+
+        self.dags_volume_name = 'airflow-dags'
+        self.logs_volume_name = 'airflow-logs'
+
         super(WorkerConfiguration, self).__init__()
 
     def _get_init_containers(self, volume_mounts):
         """When using git to retrieve the DAGs, use the GitSync Init Container"""
         # If we're using volume claims to mount the dags, no init container is needed
-        if self.kube_config.dags_volume_claim or self.kube_config.dags_in_image:
+        if self.kube_config.dags_volume_claim or \
+           self.kube_config.dags_volume_host or self.kube_config.dags_in_image:
             return []
 
         # Otherwise, define a git-sync init container
@@ -50,13 +56,13 @@ def _get_init_containers(self, volume_mounts):
             'value': self.kube_config.git_branch
         }, {
             'name': 'GIT_SYNC_ROOT',
-            'value': os.path.join(
-                self.worker_airflow_dags,
-                self.kube_config.git_subpath
-            )
+            'value': self.kube_config.git_sync_root
         }, {
             'name': 'GIT_SYNC_DEST',
-            'value': 'dags'
+            'value': self.kube_config.git_sync_dest
+        }, {
+            'name': 'GIT_SYNC_DEPTH',
+            'value': '1'
         }, {
             'name': 'GIT_SYNC_ONE_TIME',
             'value': 'true'
@@ -72,13 +78,19 @@ def _get_init_containers(self, volume_mounts):
                 'value': self.kube_config.git_password
             })
 
-        volume_mounts[0]['readOnly'] = False
+        if self.dags_volume_name not in volume_mounts:
+            raise AirflowException(
+                "GitSync enabled but volume %s is not defined." % self.dags_volume_name)
+
+        volume_mounts[self.dags_volume_name]['mountPath'] = self.kube_config.git_sync_root
+        volume_mounts[self.dags_volume_name]['readOnly'] = False
+
         return [{
             'name': self.kube_config.git_sync_init_container_name,
             'image': self.kube_config.git_sync_container,
             'securityContext': {'runAsUser': 0},
             'env': init_environment,
-            'volumeMounts': volume_mounts
+            'volumeMounts': [value for value in volume_mounts.values()]
         }]
 
     def _get_environment(self):
@@ -89,11 +101,18 @@ def _get_environment(self):
 
         if self.kube_config.airflow_configmap:
             env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home
-        if self.kube_config.worker_dags_folder:
-            env['AIRFLOW__CORE__DAGS_FOLDER'] = self.kube_config.worker_dags_folder
+            env['AIRFLOW__CORE__DAGS_FOLDER'] = self.worker_airflow_dags
         if (not self.kube_config.airflow_configmap and
                 'AIRFLOW__CORE__SQL_ALCHEMY_CONN' not in self.kube_config.kube_secrets):
             env['AIRFLOW__CORE__SQL_ALCHEMY_CONN'] = conf.get("core", "SQL_ALCHEMY_CONN")
+        if self.kube_config.git_dags_folder_mount_point:
+            # /root/airflow/dags/repo/dags
+            dag_volume_mount_path = os.path.join(
+                self.kube_config.git_dags_folder_mount_point,
+                self.kube_config.git_sync_dest,  # repo
+                self.kube_config.git_subpath     # dags
+            )
+            env['AIRFLOW__CORE__DAGS_FOLDER'] = dag_volume_mount_path
         return env
 
     def _get_secrets(self):
@@ -112,10 +131,7 @@ def _get_image_pull_secrets(self):
         return self.kube_config.image_pull_secrets.split(',')
 
     def init_volumes_and_mounts(self):
-        dags_volume_name = 'airflow-dags'
-        logs_volume_name = 'airflow-logs'
-
-        def _construct_volume(name, claim):
+        def _construct_volume(name, claim, host):
             volume = {
                 'name': name
             }
@@ -123,81 +139,82 @@ def _construct_volume(name, claim):
                 volume['persistentVolumeClaim'] = {
                     'claimName': claim
                 }
+            elif host:
+                volume['hostPath'] = {
+                    'path': host,
+                    'type': ''
+                }
             else:
                 volume['emptyDir'] = {}
             return volume
 
-        volumes = [
-            _construct_volume(
-                logs_volume_name,
-                self.kube_config.logs_volume_claim
-            )
-        ]
-
-        if not self.kube_config.dags_in_image:
-            volumes.append(
-                _construct_volume(
-                    dags_volume_name,
-                    self.kube_config.dags_volume_claim
-                )
+        volumes = {
+            self.dags_volume_name: _construct_volume(
+                self.dags_volume_name,
+                self.kube_config.dags_volume_claim,
+                self.kube_config.dags_volume_host
+            ),
+            self.logs_volume_name: _construct_volume(
+                self.logs_volume_name,
+                self.kube_config.logs_volume_claim,
+                self.kube_config.logs_volume_host
             )
+        }
 
-        logs_volume_mount = {
-            'name': logs_volume_name,
-            'mountPath': self.worker_airflow_logs,
+        volume_mounts = {
+            self.dags_volume_name: {
+                'name': self.dags_volume_name,
+                'mountPath': self.generate_dag_volume_mount_path(),
+                'readOnly': True,
+            },
+            self.logs_volume_name: {
+                'name': self.logs_volume_name,
+                'mountPath': self.worker_airflow_logs,
+            }
         }
+
         if self.kube_config.dags_volume_subpath:
-            logs_volume_mount['subPath'] = self.kube_config.logs_volume_subpath
+            volume_mounts[self.dags_volume_name]['subPath'] = self.kube_config.dags_volume_subpath
 
-        volume_mounts = [
-            logs_volume_mount
-        ]
+        if self.kube_config.logs_volume_subpath:
+            volume_mounts[self.logs_volume_name]['subPath'] = self.kube_config.logs_volume_subpath
 
-        if not self.kube_config.dags_in_image:
-            dag_volume_mount_path = ""
-
-            if self.kube_config.dags_volume_claim:
-                dag_volume_mount_path = self.worker_airflow_dags
-            else:
-                dag_volume_mount_path = os.path.join(
-                    self.worker_airflow_dags,
-                    self.kube_config.git_subpath
-                )
-            dags_volume_mount = {
-                'name': dags_volume_name,
-                'mountPath': dag_volume_mount_path,
-                'readOnly': True,
-            }
-            if self.kube_config.dags_volume_subpath:
-                dags_volume_mount['subPath'] = self.kube_config.dags_volume_subpath
-            volume_mounts.append(dags_volume_mount)
+        if self.kube_config.dags_in_image:
+            del volumes[self.dags_volume_name]
+            del volume_mounts[self.dags_volume_name]
 
         # Mount the airflow.cfg file via a configmap the user has specified
         if self.kube_config.airflow_configmap:
             config_volume_name = 'airflow-config'
             config_path = '{}/airflow.cfg'.format(self.worker_airflow_home)
-            volumes.append({
+            volumes[config_volume_name] = {
                 'name': config_volume_name,
                 'configMap': {
                     'name': self.kube_config.airflow_configmap
                 }
-            })
-            volume_mounts.append({
+            }
+            volume_mounts[config_volume_name] = {
                 'name': config_volume_name,
                 'mountPath': config_path,
                 'subPath': 'airflow.cfg',
                 'readOnly': True
-            })
+            }
 
         return volumes, volume_mounts
 
+    def generate_dag_volume_mount_path(self):
+        if self.kube_config.dags_volume_claim or self.kube_config.dags_volume_host:
+            dag_volume_mount_path = self.worker_airflow_dags
+        else:
+            dag_volume_mount_path = self.kube_config.git_dags_folder_mount_point
+
+        return dag_volume_mount_path
+
     def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_date,
                  airflow_command, kube_executor_config):
-        volumes, volume_mounts = self.init_volumes_and_mounts()
-        volumes += kube_executor_config.volumes
-        volume_mounts += kube_executor_config.volume_mounts
+        volumes_dict, volume_mounts_dict = self.init_volumes_and_mounts()
         worker_init_container_spec = self._get_init_containers(
-            copy.deepcopy(volume_mounts))
+            copy.deepcopy(volume_mounts_dict))
         resources = Resources(
             request_memory=kube_executor_config.request_memory,
             request_cpu=kube_executor_config.request_cpu,
@@ -209,6 +226,9 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
         if gcp_sa_key:
             annotations['iam.cloud.google.com/service-account'] = gcp_sa_key
 
+        volumes = [value for value in volumes_dict.values()] + kube_executor_config.volumes
+        volume_mounts = [value for value in volume_mounts_dict.values()] + kube_executor_config.volume_mounts
+
         affinity = kube_executor_config.affinity or self.kube_config.kube_affinity
         tolerations = kube_executor_config.tolerations or self.kube_config.kube_tolerations
 
diff --git a/airflow/www_rbac/compile_assets.sh b/airflow/www_rbac/compile_assets.sh
index 2c115a44a528f..a2b61115c8570 100755
--- a/airflow/www_rbac/compile_assets.sh
+++ b/airflow/www_rbac/compile_assets.sh
@@ -15,8 +15,13 @@
 # limitations under the License.
 #
 
+set -e
+
 # first bump up package.json manually, commit and tag
-rm airflow/www_rbac/static/dist/*
+if [ -d airflow/www_rbac/static/dist ]; then
+  rm airflow/www_rbac/static/dist/*
+fi
+
 cd airflow/www_rbac/
 npm install
 npm run build
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 372b27c009acc..d042c14f19aef 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -56,11 +56,11 @@ Kubernetes Operator
             {
               "weight": 1,
               "preference": {
-                "matchExpressions": [
+                "matchExpressions": {
                   "key": "disktype",
                   "operator": "In",
                   "values": ["ssd"]
-                ]
+                }
               }
             }
           ]
diff --git a/scripts/ci/5-run-tests.sh b/scripts/ci/5-run-tests.sh
index 0a3add4762636..1bd33755bf151 100755
--- a/scripts/ci/5-run-tests.sh
+++ b/scripts/ci/5-run-tests.sh
@@ -97,5 +97,11 @@ fi
 echo "Starting the unit tests with the following nose arguments: "$nose_args
 nosetests $nose_args
 
+# Fix codecov build path
+if [ ! -h /home/travis/build/apache/incubator-airflow ]; then
+  sudo mkdir -p /home/travis/build/apache
+  sudo ln -s ${ROOTDIR} /home/travis/build/apache/incubator-airflow
+fi
+
 # To run individual tests:
 # nosetests tests.core:CoreTest.test_scheduler_job
diff --git a/scripts/ci/kubernetes/README.md b/scripts/ci/kubernetes/README.md
index 675be9fc4a042..09eaa47397e93 100644
--- a/scripts/ci/kubernetes/README.md
+++ b/scripts/ci/kubernetes/README.md
@@ -21,7 +21,7 @@ under the License.
 
 If you don't have minikube installed, please run `./minikube/start_minikube.sh` to start a k8s-instance on your local machine. Make sure that your `kubectl` is pointing to the local k8s instance.
 
-First build the docker images by running `./docker/build.sh`. This will build the image and push it to the local registry. Secondly, deploy Apache Airflow using `./kube/deploy.sh`. Finally, open the Airflow webserver page by browsing to `http://192.168.99.100:30809/admin/` (on OSX).
+First build the docker images by running `./docker/build.sh`. This will build the image and push it to the local registry. Secondly, deploy Apache Airflow using `./kube/deploy.sh -d persistent_mode`. Finally, open the Airflow webserver page by browsing to `http://192.168.99.100:30809/admin/` (on OSX).
 
 When kicking of a new job, you should be able to see new pods being kicked off:
 ```
diff --git a/scripts/ci/kubernetes/docker/airflow-test-env-init.sh b/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
index 59d830af63c59..6c24a5cf6878a 100755
--- a/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
+++ b/scripts/ci/kubernetes/docker/airflow-test-env-init.sh
@@ -17,9 +17,12 @@
 #  specific language governing permissions and limitations      *
 #  under the License.
 
+set -x
+
 cd /usr/local/lib/python2.7/dist-packages/airflow && \
 cp -R example_dags/* /root/airflow/dags/ && \
 cp -R contrib/example_dags/example_kubernetes_*.py /root/airflow/dags/ && \
+cp -a contrib/example_dags/libs /root/airflow/dags/ && \
 airflow initdb && \
 alembic upgrade heads && \
 (airflow create_user -u airflow -l airflow -f jon -e airflow@apache.org -r Admin -p airflow || true) && \
diff --git a/scripts/ci/kubernetes/docker/build.sh b/scripts/ci/kubernetes/docker/build.sh
index 49d0fb87c3a31..df755f9659178 100755
--- a/scripts/ci/kubernetes/docker/build.sh
+++ b/scripts/ci/kubernetes/docker/build.sh
@@ -34,8 +34,18 @@ fi
 echo "Airflow directory $AIRFLOW_ROOT"
 echo "Airflow Docker directory $DIRNAME"
 
+if [[ ${PYTHON_VERSION} == '3' ]]; then
+  PYTHON_DOCKER_IMAGE=python:3.6-slim
+else
+  PYTHON_DOCKER_IMAGE=python:2.7-slim
+fi
+
 cd $AIRFLOW_ROOT
-python setup.py sdist -q
+docker run -ti --rm -e SLUGIFY_USES_TEXT_UNIDECODE -v ${AIRFLOW_ROOT}:/airflow \
+    -w /airflow ${PYTHON_DOCKER_IMAGE} ./scripts/ci/kubernetes/docker/compile.sh \
+
+sudo rm -rf ${AIRFLOW_ROOT}/airflow/www_rbac/node_modules
+
 echo "Copy distro $AIRFLOW_ROOT/dist/*.tar.gz ${DIRNAME}/airflow.tar.gz"
 cp $AIRFLOW_ROOT/dist/*.tar.gz ${DIRNAME}/airflow.tar.gz
 cd $DIRNAME && docker build --pull $DIRNAME --tag=${IMAGE}:${TAG}
diff --git a/scripts/ci/kubernetes/docker/compile.sh b/scripts/ci/kubernetes/docker/compile.sh
new file mode 100755
index 0000000000000..9a84d4d0e04fc
--- /dev/null
+++ b/scripts/ci/kubernetes/docker/compile.sh
@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+#
+#  Licensed to the Apache Software Foundation (ASF) under one   *
+#  or more contributor license agreements.  See the NOTICE file *
+#  distributed with this work for additional information        *
+#  regarding copyright ownership.  The ASF licenses this file   *
+#  to you under the Apache License, Version 2.0 (the            *
+#  "License"); you may not use this file except in compliance   *
+#  with the License.  You may obtain a copy of the License at   *
+#                                                               *
+#    http://www.apache.org/licenses/LICENSE-2.0                 *
+#                                                               *
+#  Unless required by applicable law or agreed to in writing,   *
+#  software distributed under the License is distributed on an  *
+#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
+#  KIND, either express or implied.  See the License for the    *
+#  specific language governing permissions and limitations      *
+#  under the License.                                           *
+
+set -e
+
+export DEBIAN_FRONTEND=noninteractive
+
+apt-get update
+apt-get install -y --no-install-recommends curl gnupg2
+
+curl -sL https://deb.nodesource.com/setup_8.x | bash -
+
+apt-get update
+apt-get install -y --no-install-recommends git nodejs
+pip install GitPython
+python setup.py compile_assets sdist -q
diff --git a/scripts/ci/kubernetes/kube/deploy.sh b/scripts/ci/kubernetes/kube/deploy.sh
index 75567c9acf6a4..abbf4f8d0ff06 100755
--- a/scripts/ci/kubernetes/kube/deploy.sh
+++ b/scripts/ci/kubernetes/kube/deploy.sh
@@ -22,16 +22,130 @@ set -x
 IMAGE=${1:-airflow/ci}
 TAG=${2:-latest}
 DIRNAME=$(cd "$(dirname "$0")"; pwd)
+TEMPLATE_DIRNAME=${DIRNAME}/templates
+BUILD_DIRNAME=${DIRNAME}/build
+
+usage() {
+    cat << EOF
+  usage: $0 options
+  OPTIONS:
+    -d Use PersistentVolume or GitSync for dags_folder. Available options are "persistent_mode" or "git_mode"
+EOF
+    exit 1;
+}
+
+while getopts ":d:" OPTION; do
+  case ${OPTION} in
+    d)
+      DAGS_VOLUME=${OPTARG};;
+    \?)
+      echo "Invalid option: -$OPTARG" >&2
+      exit 1
+      ;;
+    :)
+      echo "Option -$OPTARG requires an argument." >&2
+      usage
+      ;;
+  esac
+done
+
+case ${DAGS_VOLUME} in
+  "persistent_mode")
+    GIT_SYNC=0
+    ;;
+  "git_mode")
+    GIT_SYNC=1
+    ;;
+  *)
+    echo "Value \"$DAGS_VOLUME\" for dags_folder is not valid." >&2
+    usage
+    ;;
+esac
+
+if [ ! -d "$BUILD_DIRNAME" ]; then
+  mkdir -p ${BUILD_DIRNAME}
+fi
+
+rm -f ${BUILD_DIRNAME}/*
+
+if [ "${GIT_SYNC}" = 0 ]; then
+    INIT_DAGS_VOLUME_NAME=airflow-dags
+    POD_AIRFLOW_DAGS_VOLUME_NAME=airflow-dags
+    CONFIGMAP_DAGS_FOLDER=/root/airflow/dags
+    CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT=
+    CONFIGMAP_DAGS_VOLUME_CLAIM=airflow-dags
+else
+    INIT_DAGS_VOLUME_NAME=airflow-dags-fake
+    POD_AIRFLOW_DAGS_VOLUME_NAME=airflow-dags-git
+    CONFIGMAP_DAGS_FOLDER=/root/airflow/dags/repo/airflow/contrib/example_dags
+    CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT=/root/airflow/dags
+    CONFIGMAP_DAGS_VOLUME_CLAIM=
+fi
+CONFIGMAP_GIT_REPO=${TRAVIS_REPO_SLUG:-apache/incubator-airflow}
+CONFIGMAP_BRANCH=${TRAVIS_BRANCH:-master}
+
+_UNAME_OUT=$(uname -s)
+case "${_UNAME_OUT}" in
+    Linux*)     _MY_OS=linux;;
+    Darwin*)    _MY_OS=darwin;;
+    *)          echo "${_UNAME_OUT} is unsupported."
+                exit 1;;
+esac
+echo "Local OS is ${_MY_OS}"
+
+case $_MY_OS in
+  linux)
+    SED_COMMAND=sed
+  ;;
+  darwin)
+    SED_COMMAND=gsed
+    if ! $(type "$SED_COMMAND" &> /dev/null) ; then
+      echo "Could not find \"$SED_COMMAND\" binary, please install it. On OSX brew install gnu-sed" >&2
+      exit 1
+    fi
+  ;;
+  *)
+    echo "${_UNAME_OUT} is unsupported."
+    exit 1
+  ;;
+esac
+
+if [ "${GIT_SYNC}" = 0 ]; then
+  ${SED_COMMAND} -e "s/{{INIT_GIT_SYNC}}//g" \
+      ${TEMPLATE_DIRNAME}/airflow.template.yaml > ${BUILD_DIRNAME}/airflow.yaml
+else
+  ${SED_COMMAND} -e "/{{INIT_GIT_SYNC}}/{r $TEMPLATE_DIRNAME/init_git_sync.template.yaml" -e 'd}' \
+      ${TEMPLATE_DIRNAME}/airflow.template.yaml > ${BUILD_DIRNAME}/airflow.yaml
+fi
+
+${SED_COMMAND} -i "s|{{CONFIGMAP_GIT_REPO}}|$CONFIGMAP_GIT_REPO|g" ${BUILD_DIRNAME}/airflow.yaml
+${SED_COMMAND} -i "s|{{CONFIGMAP_BRANCH}}|$CONFIGMAP_BRANCH|g" ${BUILD_DIRNAME}/airflow.yaml
+${SED_COMMAND} -i "s|{{INIT_DAGS_VOLUME_NAME}}|$INIT_DAGS_VOLUME_NAME|g" ${BUILD_DIRNAME}/airflow.yaml
+${SED_COMMAND} -i "s|{{POD_AIRFLOW_DAGS_VOLUME_NAME}}|$POD_AIRFLOW_DAGS_VOLUME_NAME|g" ${BUILD_DIRNAME}/airflow.yaml
+
+${SED_COMMAND} "s|{{CONFIGMAP_DAGS_FOLDER}}|$CONFIGMAP_DAGS_FOLDER|g" \
+    ${TEMPLATE_DIRNAME}/configmaps.template.yaml > ${BUILD_DIRNAME}/configmaps.yaml
+${SED_COMMAND} -i "s|{{CONFIGMAP_GIT_REPO}}|$CONFIGMAP_GIT_REPO|g" ${BUILD_DIRNAME}/configmaps.yaml
+${SED_COMMAND} -i "s|{{CONFIGMAP_BRANCH}}|$CONFIGMAP_BRANCH|g" ${BUILD_DIRNAME}/configmaps.yaml
+${SED_COMMAND} -i "s|{{CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT}}|$CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT|g" ${BUILD_DIRNAME}/configmaps.yaml
+${SED_COMMAND} -i "s|{{CONFIGMAP_DAGS_VOLUME_CLAIM}}|$CONFIGMAP_DAGS_VOLUME_CLAIM|g" ${BUILD_DIRNAME}/configmaps.yaml
+
+# Fix file permissions
+if [[ "${TRAVIS}" == true ]]; then
+  sudo chown -R travis.travis $HOME/.kube $HOME/.minikube
+fi
 
 kubectl delete -f $DIRNAME/postgres.yaml
-kubectl delete -f $DIRNAME/airflow.yaml
+kubectl delete -f $BUILD_DIRNAME/airflow.yaml
 kubectl delete -f $DIRNAME/secrets.yaml
 
+set -e
+
 kubectl apply -f $DIRNAME/secrets.yaml
-kubectl apply -f $DIRNAME/configmaps.yaml
+kubectl apply -f $BUILD_DIRNAME/configmaps.yaml
 kubectl apply -f $DIRNAME/postgres.yaml
 kubectl apply -f $DIRNAME/volumes.yaml
-kubectl apply -f $DIRNAME/airflow.yaml
+kubectl apply -f $BUILD_DIRNAME/airflow.yaml
 
 # wait for up to 10 minutes for everything to be deployed
 for i in {1..150}
@@ -51,6 +165,12 @@ POD=$(kubectl get pods -o go-template --template '{{range .items}}{{.metadata.na
 
 echo "------- pod description -------"
 kubectl describe pod $POD
+echo "------- webserver init container logs - init -------"
+kubectl logs $POD init
+if [ "${GIT_SYNC}" = 1 ]; then
+    echo "------- webserver init container logs - git-sync-clone -------"
+    kubectl logs $POD git-sync-clone
+fi
 echo "------- webserver logs -------"
 kubectl logs $POD webserver
 echo "------- scheduler logs -------"
diff --git a/scripts/ci/kubernetes/kube/airflow.yaml b/scripts/ci/kubernetes/kube/templates/airflow.template.yaml
similarity index 89%
rename from scripts/ci/kubernetes/kube/airflow.yaml
rename to scripts/ci/kubernetes/kube/templates/airflow.template.yaml
index 1b6e33cec5b3c..82f7b8b17da51 100644
--- a/scripts/ci/kubernetes/kube/airflow.yaml
+++ b/scripts/ci/kubernetes/kube/templates/airflow.template.yaml
@@ -49,7 +49,7 @@ spec:
         - name: airflow-configmap
           mountPath: /root/airflow/airflow.cfg
           subPath: airflow.cfg
-        - name: airflow-dags
+        - name: {{INIT_DAGS_VOLUME_NAME}}
           mountPath: /root/airflow/dags
         - name: test-volume
           mountPath: /root/test_volume
@@ -64,6 +64,7 @@ spec:
         args:
           - "-cx"
           - "./tmp/airflow-test-env-init.sh"
+{{INIT_GIT_SYNC}}
       containers:
       - name: webserver
         image: airflow
@@ -86,24 +87,10 @@ spec:
         - name: airflow-configmap
           mountPath: /root/airflow/airflow.cfg
           subPath: airflow.cfg
-        - name: airflow-dags
+        - name: {{POD_AIRFLOW_DAGS_VOLUME_NAME}}
           mountPath: /root/airflow/dags
         - name: airflow-logs
           mountPath: /root/airflow/logs
-#        readinessProbe:
-#          initialDelaySeconds: 5
-#          timeoutSeconds: 5
-#          periodSeconds: 5
-#          httpGet:
-#            path: /login
-#            port: 8080
-#        livenessProbe:
-#          initialDelaySeconds: 5
-#          timeoutSeconds: 5
-#          failureThreshold: 5
-#          httpGet:
-#            path: /login
-#            port: 8080
       - name: scheduler
         image: airflow
         imagePullPolicy: IfNotPresent
@@ -122,7 +109,7 @@ spec:
         - name: airflow-configmap
           mountPath: /root/airflow/airflow.cfg
           subPath: airflow.cfg
-        - name: airflow-dags
+        - name: {{POD_AIRFLOW_DAGS_VOLUME_NAME}}
           mountPath: /root/airflow/dags
         - name: airflow-logs
           mountPath: /root/airflow/logs
@@ -130,6 +117,10 @@ spec:
       - name: airflow-dags
         persistentVolumeClaim:
           claimName: airflow-dags
+      - name: airflow-dags-fake
+        emptyDir: {}
+      - name: airflow-dags-git
+        emptyDir: {}
       - name: test-volume
         persistentVolumeClaim:
           claimName: test-volume
diff --git a/scripts/ci/kubernetes/kube/configmaps.yaml b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
similarity index 96%
rename from scripts/ci/kubernetes/kube/configmaps.yaml
rename to scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
index 86c1a9756134e..dd699228ef89e 100644
--- a/scripts/ci/kubernetes/kube/configmaps.yaml
+++ b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
@@ -22,7 +22,7 @@ data:
   airflow.cfg: |
     [core]
     airflow_home = /root/airflow
-    dags_folder = /root/airflow/dags
+    dags_folder = {{CONFIGMAP_DAGS_FOLDER}}
     base_log_folder = /root/airflow/logs
     logging_level = INFO
     executor = KubernetesExecutor
@@ -57,6 +57,9 @@ data:
     statsd_port = 8125
     statsd_prefix = airflow
 
+    # How many seconds to wait between file-parsing loops to prevent the logs from being spammed.
+    min_file_parsing_loop_time = 1
+
     print_stats_interval = 30
     scheduler_zombie_task_threshold = 300
     max_tis_per_query = 0
@@ -176,18 +179,22 @@ data:
     worker_container_repository = airflow
     worker_container_tag = latest
     worker_container_image_pull_policy = IfNotPresent
-    worker_dags_folder = /tmp/dags
     delete_worker_pods = True
     dags_in_image = False
-    git_repo = https://github.com/apache/airflow.git
-    git_branch = master
-    git_subpath = airflow/example_dags/
+    git_repo = https://github.com/{{CONFIGMAP_GIT_REPO}}.git
+    git_branch = {{CONFIGMAP_BRANCH}}
+    git_subpath = airflow/contrib/example_dags/
     git_user =
     git_password =
-    dags_volume_claim = airflow-dags
+    git_sync_root = /git
+    git_sync_path = repo
+    git_dags_folder_mount_point = {{CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT}}
+    dags_volume_claim = {{CONFIGMAP_DAGS_VOLUME_CLAIM}}
     dags_volume_subpath =
     logs_volume_claim = airflow-logs
     logs_volume_subpath =
+    dags_volume_host =
+    logs_volume_host =
     in_cluster = True
     namespace = default
     gcp_service_account_keys =
diff --git a/scripts/ci/kubernetes/kube/templates/init_git_sync.template.yaml b/scripts/ci/kubernetes/kube/templates/init_git_sync.template.yaml
new file mode 100644
index 0000000000000..0129a5f91b6e5
--- /dev/null
+++ b/scripts/ci/kubernetes/kube/templates/init_git_sync.template.yaml
@@ -0,0 +1,36 @@
+#
+#  Licensed to the Apache Software Foundation (ASF) under one   *
+#  or more contributor license agreements.  See the NOTICE file *
+#  distributed with this work for additional information        *
+#  regarding copyright ownership.  The ASF licenses this file   *
+#  to you under the Apache License, Version 2.0 (the            *
+#  "License"); you may not use this file except in compliance   *
+#  with the License.  You may obtain a copy of the License at   *
+#                                                               *
+#    http://www.apache.org/licenses/LICENSE-2.0                 *
+#                                                               *
+#  Unless required by applicable law or agreed to in writing,   *
+#  software distributed under the License is distributed on an  *
+#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
+#  KIND, either express or implied.  See the License for the    *
+#  specific language governing permissions and limitations      *
+#  under the License.                                           *
+      - name: git-sync-clone
+        env:
+        - name: GIT_SYNC_REPO
+          value: https://github.com/{{CONFIGMAP_GIT_REPO}}.git
+        - name: GIT_SYNC_BRANCH
+          value: {{CONFIGMAP_BRANCH}}
+        - name: GIT_SYNC_ROOT
+          value: /git
+        - name: GIT_SYNC_DEST
+          value: repo
+        - name: GIT_SYNC_ONE_TIME
+          value: "true"
+        image: gcr.io/google-containers/git-sync-amd64:v2.0.5
+        imagePullPolicy: IfNotPresent
+        securityContext:
+          runAsUser: 0
+        volumeMounts:
+        - mountPath: /git
+          name: airflow-dags-git
diff --git a/scripts/ci/kubernetes/minikube/start_minikube.sh b/scripts/ci/kubernetes/minikube/start_minikube.sh
index 6f843b89ec68f..599d45d2d521a 100755
--- a/scripts/ci/kubernetes/minikube/start_minikube.sh
+++ b/scripts/ci/kubernetes/minikube/start_minikube.sh
@@ -19,7 +19,7 @@
 
 #!/usr/bin/env bash
 
-set -x
+set -ex
 
 _MY_SCRIPT="${BASH_SOURCE[0]}"
 _MY_DIR=$(cd "$(dirname "$_MY_SCRIPT")" && pwd)
@@ -53,7 +53,9 @@ source _k8s.sh
 rm -rf tmp
 mkdir -p bin tmp
 
-sudo mkdir -p /usr/local/bin
+if [[ ! -d /usr/local/bin ]]; then
+    sudo mkdir -p /usr/local/bin
+fi
 
 if [[ ! -x /usr/local/bin/kubectl ]]; then
   echo Downloading kubectl, which is a requirement for using minikube.
diff --git a/scripts/ci/kubernetes/minikube/stop_minikube.sh b/scripts/ci/kubernetes/minikube/stop_minikube.sh
new file mode 100755
index 0000000000000..bd5f8bcbe7468
--- /dev/null
+++ b/scripts/ci/kubernetes/minikube/stop_minikube.sh
@@ -0,0 +1,39 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# This script was based on one made by @kimoonkim for kubernetes-hdfs
+
+#!/usr/bin/env bash
+
+set -ex
+
+if [[ ! -x /usr/local/bin/minikube ]]; then
+  exit 0
+fi
+
+# Fix file permissions
+if [[ "${TRAVIS}" == true ]]; then
+  sudo chown -R travis.travis $HOME/.kube $HOME/.minikube
+fi
+
+sudo minikube status
+if [[ $? = 0 ]]; then
+  sudo minikube delete
+  sudo rm -rf HOME/.kube $HOME/.minikube
+fi
+
+sudo chown -R travis.travis .
diff --git a/scripts/ci/kubernetes/setup_kubernetes.sh b/scripts/ci/kubernetes/setup_kubernetes.sh
index 96f8f5d6af2a5..e0ef216f07884 100755
--- a/scripts/ci/kubernetes/setup_kubernetes.sh
+++ b/scripts/ci/kubernetes/setup_kubernetes.sh
@@ -23,6 +23,11 @@ echo "For development, start minikube yourself (ie: minikube start) then run thi
 
 DIRNAME=$(cd "$(dirname "$0")"; pwd)
 
+# Fix file permissions
+if [[ "${TRAVIS}" == true ]]; then
+  sudo chown -R travis.travis .
+fi
+
 $DIRNAME/minikube/start_minikube.sh
 $DIRNAME/docker/build.sh
 
diff --git a/scripts/ci/run-ci.sh b/scripts/ci/run-ci.sh
index 1a65bf1ef6443..8bee25859f38d 100755
--- a/scripts/ci/run-ci.sh
+++ b/scripts/ci/run-ci.sh
@@ -24,7 +24,10 @@ DIRNAME=$(cd "$(dirname "$0")"; pwd)
 AIRFLOW_ROOT="$DIRNAME/../.."
 
 # Fix file permissions
-sudo chown -R airflow.airflow . $HOME/.cache $HOME/.wheelhouse/ $HOME/.cache/pip $HOME/.kube $HOME/.minikube
+sudo chown -R airflow.airflow . $HOME/.cache $HOME/.wheelhouse/ $HOME/.cache/pip
+if [ -d $HOME/.minikube ]; then
+    sudo chown -R airflow.airflow $HOME/.kube $HOME/.minikube
+fi
 
 if [[ $PYTHON_VERSION == '3' ]]; then
   PIP=pip3
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 1b5c4c015d963..f4c48665d2597 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -137,11 +137,15 @@ def setUp(self):
         self.kube_config.dags_volume_subpath = None
         self.kube_config.logs_volume_subpath = None
         self.kube_config.dags_in_image = False
+        self.kube_config.dags_folder = None
+        self.kube_config.git_dags_folder_mount_point = None
 
     def test_worker_configuration_no_subpaths(self):
         worker_config = WorkerConfiguration(self.kube_config)
         volumes, volume_mounts = worker_config.init_volumes_and_mounts()
-        for volume_or_mount in volumes + volume_mounts:
+        volumes_list = [value for value in volumes.values()]
+        volume_mounts_list = [value for value in volume_mounts.values()]
+        for volume_or_mount in volumes_list + volume_mounts_list:
             if volume_or_mount['name'] != 'airflow-config':
                 self.assertNotIn(
                     'subPath', volume_or_mount,
@@ -154,29 +158,69 @@ def test_worker_with_subpaths(self):
         worker_config = WorkerConfiguration(self.kube_config)
         volumes, volume_mounts = worker_config.init_volumes_and_mounts()
 
-        for volume in volumes:
+        for volume in [value for value in volumes.values()]:
             self.assertNotIn(
                 'subPath', volume,
                 "subPath isn't valid configuration for a volume"
             )
 
-        for volume_mount in volume_mounts:
+        for volume_mount in [value for value in volume_mounts.values()]:
             if volume_mount['name'] != 'airflow-config':
                 self.assertIn(
                     'subPath', volume_mount,
                     "subPath should've been passed to volumeMount configuration"
                 )
 
+    def test_worker_generate_dag_volume_mount_path(self):
+        self.kube_config.git_dags_folder_mount_point = '/root/airflow/git/dags'
+        self.kube_config.dags_folder = '/root/airflow/dags'
+        worker_config = WorkerConfiguration(self.kube_config)
+
+        self.kube_config.dags_volume_claim = 'airflow-dags'
+        self.kube_config.dags_volume_host = ''
+        dag_volume_mount_path = worker_config.generate_dag_volume_mount_path()
+        self.assertEqual(dag_volume_mount_path, self.kube_config.dags_folder)
+
+        self.kube_config.dags_volume_claim = ''
+        self.kube_config.dags_volume_host = '/host/airflow/dags'
+        dag_volume_mount_path = worker_config.generate_dag_volume_mount_path()
+        self.assertEqual(dag_volume_mount_path, self.kube_config.dags_folder)
+
+        self.kube_config.dags_volume_claim = ''
+        self.kube_config.dags_volume_host = ''
+        dag_volume_mount_path = worker_config.generate_dag_volume_mount_path()
+        self.assertEqual(dag_volume_mount_path,
+                         self.kube_config.git_dags_folder_mount_point)
+
     def test_worker_environment_no_dags_folder(self):
-        self.kube_config.worker_dags_folder = ''
+        self.kube_config.airflow_configmap = ''
+        self.kube_config.git_dags_folder_mount_point = ''
+        self.kube_config.dags_folder = ''
         worker_config = WorkerConfiguration(self.kube_config)
         env = worker_config._get_environment()
 
         self.assertNotIn('AIRFLOW__CORE__DAGS_FOLDER', env)
 
     def test_worker_environment_when_dags_folder_specified(self):
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_dags_folder_mount_point = ''
         dags_folder = '/workers/path/to/dags'
-        self.kube_config.worker_dags_folder = dags_folder
+        self.kube_config.dags_folder = dags_folder
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        env = worker_config._get_environment()
+
+        self.assertEqual(dags_folder, env['AIRFLOW__CORE__DAGS_FOLDER'])
+
+    def test_worker_environment_dags_folder_using_git_sync(self):
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_sync_dest = 'repo'
+        self.kube_config.git_subpath = 'dags'
+        self.kube_config.git_dags_folder_mount_point = '/workers/path/to/dags'
+
+        dags_folder = '{}/{}/{}'.format(self.kube_config.git_dags_folder_mount_point,
+                                        self.kube_config.git_sync_dest,
+                                        self.kube_config.git_subpath)
 
         worker_config = WorkerConfiguration(self.kube_config)
         env = worker_config._get_environment()
@@ -239,15 +283,20 @@ def test_worker_pvc_dags(self):
         worker_config = WorkerConfiguration(self.kube_config)
         volumes, volume_mounts = worker_config.init_volumes_and_mounts()
 
-        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
-        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+        init_containers = worker_config._get_init_containers(volume_mounts)
+
+        dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
 
         self.assertEqual('airflow-dags', dag_volume[0]['persistentVolumeClaim']['claimName'])
         self.assertEqual(1, len(dag_volume_mount))
+        self.assertTrue(dag_volume_mount[0]['readOnly'])
+        self.assertEqual(0, len(init_containers))
 
     def test_worker_git_dags(self):
         # Tests persistence volume config created when `git_repo` is set
         self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
         self.kube_config.dags_folder = '/usr/local/airflow/dags'
         self.kube_config.worker_dags_folder = '/usr/local/airflow/dags'
 
@@ -255,21 +304,27 @@ def test_worker_git_dags(self):
         self.kube_config.git_sync_container_tag = 'v2.0.5'
         self.kube_config.git_sync_container = 'gcr.io/google-containers/git-sync-amd64:v2.0.5'
         self.kube_config.git_sync_init_container_name = 'git-sync-clone'
-        self.kube_config.git_subpath = ''
+        self.kube_config.git_subpath = 'dags_folder'
+        self.kube_config.git_sync_root = '/git'
+        self.kube_config.git_dags_folder_mount_point = '/usr/local/airflow/dags/repo/dags_folder'
 
         worker_config = WorkerConfiguration(self.kube_config)
         volumes, volume_mounts = worker_config.init_volumes_and_mounts()
 
-        init_container = worker_config._get_init_containers(volume_mounts)[0]
-
-        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
-        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+        dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
 
         self.assertTrue('emptyDir' in dag_volume[0])
-        self.assertEqual('/usr/local/airflow/dags/', dag_volume_mount[0]['mountPath'])
+        self.assertEqual(self.kube_config.git_dags_folder_mount_point, dag_volume_mount[0]['mountPath'])
+        self.assertTrue(dag_volume_mount[0]['readOnly'])
+
+        init_container = worker_config._get_init_containers(volume_mounts)[0]
+        init_container_volume_mount = [mount for mount in init_container['volumeMounts'] if mount['name'] == 'airflow-dags']
 
         self.assertEqual('git-sync-clone', init_container['name'])
         self.assertEqual('gcr.io/google-containers/git-sync-amd64:v2.0.5', init_container['image'])
+        self.assertEqual(1, len(init_container_volume_mount))
+        self.assertFalse(init_container_volume_mount[0]['readOnly'])
 
     def test_worker_container_dags(self):
         # Tests that the 'airflow-dags' persistence volume is NOT created when `dags_in_image` is set
@@ -278,8 +333,8 @@ def test_worker_container_dags(self):
         worker_config = WorkerConfiguration(self.kube_config)
         volumes, volume_mounts = worker_config.init_volumes_and_mounts()
 
-        dag_volume = [volume for volume in volumes if volume['name'] == 'airflow-dags']
-        dag_volume_mount = [mount for mount in volume_mounts if mount['name'] == 'airflow-dags']
+        dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
+        dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
 
         init_containers = worker_config._get_init_containers(volume_mounts)
 
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index 7d3947799dcd5..58d28a60070ae 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -133,8 +133,13 @@ def start_dag(self, dag_id, host):
             'http://{host}/api/experimental/'
             'dags/{dag_id}/paused/false'.format(host=host, dag_id=dag_id)
         )
+        try:
+            result_json = result.json()
+        except ValueError:
+            result_json = str(result)
+
         self.assertEqual(result.status_code, 200, "Could not enable DAG: {result}"
-                         .format(result=result.json()))
+                         .format(result=result_json))
 
         # Trigger a new dagrun
         result = requests.post(
@@ -142,8 +147,13 @@ def start_dag(self, dag_id, host):
             'dags/{dag_id}/dag_runs'.format(host=host, dag_id=dag_id),
             json={}
         )
+        try:
+            result_json = result.json()
+        except ValueError:
+            result_json = str(result)
+
         self.assertEqual(result.status_code, 200, "Could not trigger a DAG-run: {result}"
-                         .format(result=result.json()))
+                         .format(result=result_json))
 
         time.sleep(1)
 

From eb96dd565361104defd62d5bbccbb03201841ebc Mon Sep 17 00:00:00 2001
From: BrechtDeVlieger <brechtdevlieger@hotmail.com>
Date: Tue, 11 Dec 2018 19:20:14 +0100
Subject: [PATCH 362/808] [AIRFLOW-3397] Fix integrety error in rbac
 AirflowSecurityManager (#4305)

This was caused by the variable `role` being shadowed in a loop statement.
---
 airflow/www_rbac/security.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index dc8cd9161af03..c14bb4d3c83c8 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -391,8 +391,8 @@ def merge_pv(perm, view_menu):
             existing_perm_view_by_user = self.get_session.query(ab_perm_view_role)\
                 .filter(ab_perm_view_role.columns.role_id == role.id)
 
-            existing_perms_views = set([role.permission_view_id
-                                        for role in existing_perm_view_by_user])
+            existing_perms_views = set([pv.permission_view_id
+                                        for pv in existing_perm_view_by_user])
             missing_perm_views = all_perm_views - existing_perms_views
 
             for perm_view_id in missing_perm_views:

From 7216ff3a70f03bfb76b618251ec7c316157225a9 Mon Sep 17 00:00:00 2001
From: Matt Revell <nightowlmatt@gmail.com>
Date: Thu, 2 Aug 2018 08:43:39 +0100
Subject: [PATCH 363/808] [AIRFLOW-2099] Handle getsource() calls gracefully

---
 airflow/www/utils.py                    | 28 ++++++++++++
 airflow/www/views.py                    |  4 +-
 tests/core.py                           | 14 ++++++
 tests/dags/test_task_view_type_check.py | 61 +++++++++++++++++++++++++
 tests/www/test_utils.py                 | 37 +++++++++++++++
 5 files changed, 143 insertions(+), 1 deletion(-)
 create mode 100644 tests/dags/test_task_view_type_check.py

diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 3f869e625180f..1902657989d1b 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import inspect
 from future import standard_library
 standard_library.install_aliases()  # noqa: E402
 from builtins import str, object
@@ -399,6 +400,33 @@ def make_cache_key(*args, **kwargs):
     return (path + args).encode('ascii', 'ignore')
 
 
+def get_python_source(x):
+    """
+    Helper function to get Python source (or not), preventing exceptions
+    """
+    source_code = None
+
+    if isinstance(x, functools.partial):
+        source_code = inspect.getsource(x.func)
+
+    if source_code is None:
+        try:
+            source_code = inspect.getsource(x)
+        except TypeError:
+            pass
+
+    if source_code is None:
+        try:
+            source_code = inspect.getsource(x.__call__)
+        except (TypeError, AttributeError):
+            pass
+
+    if source_code is None:
+        source_code = 'No source code available for {}'.format(type(x))
+
+    return source_code
+
+
 class AceEditorWidget(wtforms.widgets.TextArea):
     """
     Renders an ACE code editor.
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 715560e0992ed..3418c96299f05 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -248,7 +248,9 @@ def wrapped_markdown(s):
     'doc_yaml': lambda x: render(x, lexers.YamlLexer),
     'doc_md': wrapped_markdown,
     'python_callable': lambda x: render(
-        inspect.getsource(x), lexers.PythonLexer),
+        wwwutils.get_python_source(x),
+        lexers.PythonLexer,
+    ),
 }
 
 
diff --git a/tests/core.py b/tests/core.py
index 12a97bb12757c..9ce3b3f40bcef 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -2074,6 +2074,20 @@ def test_fetch_task_instance(self):
         response = self.app.get(url)
         self.assertIn("print_the_context", response.data.decode('utf-8'))
 
+    def test_dag_view_task_with_python_operator_using_partial(self):
+        response = self.app.get(
+            '/admin/airflow/task?'
+            'task_id=test_dagrun_functool_partial&dag_id=test_task_view_type_check&'
+            'execution_date={}'.format(DEFAULT_DATE_DS))
+        self.assertIn("A function with two args", response.data.decode('utf-8'))
+
+    def test_dag_view_task_with_python_operator_using_instance(self):
+        response = self.app.get(
+            '/admin/airflow/task?'
+            'task_id=test_dagrun_instance&dag_id=test_task_view_type_check&'
+            'execution_date={}'.format(DEFAULT_DATE_DS))
+        self.assertIn("A __call__ method", response.data.decode('utf-8'))
+
     def tearDown(self):
         configuration.conf.set("webserver", "expose_config", "False")
         self.dag_bash.clear(start_date=EXAMPLE_DAG_DEFAULT_DATE,
diff --git a/tests/dags/test_task_view_type_check.py b/tests/dags/test_task_view_type_check.py
new file mode 100644
index 0000000000000..eee80581373b1
--- /dev/null
+++ b/tests/dags/test_task_view_type_check.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""
+DAG designed to test a PythonOperator that calls a functool.partial
+"""
+import functools
+import logging
+
+from datetime import datetime
+
+from airflow.models import DAG
+from airflow.operators.python_operator import PythonOperator
+
+DEFAULT_DATE = datetime(2016, 1, 1)
+default_args = dict(
+    start_date=DEFAULT_DATE,
+    owner='airflow')
+
+
+class CallableClass(object):
+    def __call__(self):
+        """ A __call__ method """
+        pass
+
+
+def a_function(arg_x, arg_y):
+    """ A function with two args """
+    pass
+
+
+partial_function = functools.partial(a_function, arg_x=1)
+class_instance = CallableClass()
+
+logging.info('class_instance type: {}'.format(type(class_instance)))
+
+dag = DAG(dag_id='test_task_view_type_check', default_args=default_args)
+
+dag_task1 = PythonOperator(
+    task_id='test_dagrun_functool_partial',
+    dag=dag,
+    python_callable=partial_function,
+)
+
+dag_task2 = PythonOperator(
+    task_id='test_dagrun_instance',
+    dag=dag,
+    python_callable=class_instance,
+)
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index 30a293e50cdeb..a824e58b09c31 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import functools
 import mock
 import unittest
 from xml.dom import minidom
@@ -228,6 +229,42 @@ def test_open_maybe_zipped_archive(self, mocked_ZipFile, mocked_is_zipfile):
         (args, kwargs) = instance.open.call_args_list[0]
         self.assertEqual('deep/path/to/file.txt', args[0])
 
+    def test_get_python_source_from_method(self):
+        class AMockClass(object):
+            def a_method(self):
+                """ A method """
+                pass
+
+        mocked_class = AMockClass()
+
+        result = utils.get_python_source(mocked_class.a_method)
+        self.assertIn('A method', result)
+
+    def test_get_python_source_from_class(self):
+        class AMockClass(object):
+            def __call__(self):
+                """ A __call__ method """
+                pass
+
+        mocked_class = AMockClass()
+
+        result = utils.get_python_source(mocked_class)
+        self.assertIn('A __call__ method', result)
+
+    def test_get_python_source_from_partial_func(self):
+        def a_function(arg_x, arg_y):
+            """ A function with two args """
+            pass
+
+        partial_function = functools.partial(a_function, arg_x=1)
+
+        result = utils.get_python_source(partial_function)
+        self.assertIn('A function with two args', result)
+
+    def test_get_python_source_from_none(self):
+        result = utils.get_python_source(None)
+        self.assertIn('No source code available', result)
+
 
 if __name__ == '__main__':
     unittest.main()

From c565241305fe41c4a8bcd851d4a99c619ed41cc2 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Tue, 21 Aug 2018 00:44:36 +0200
Subject: [PATCH 364/808] [AIRFLOW-2918] Fix Flake8 violations (#3772)

---
 airflow/__init__.py                           |   4 +-
 .../auth/backends/github_enterprise_auth.py   |  10 +-
 airflow/contrib/auth/backends/google_auth.py  |  10 +-
 .../contrib/auth/backends/kerberos_auth.py    |   4 +-
 airflow/contrib/auth/backends/ldap_auth.py    |   7 +-
 .../operators/mlengine_prediction_summary.py  |   1 +
 airflow/default_login.py                      |   7 +-
 airflow/jobs.py                               |  18 +-
 airflow/migrations/env.py                     |   1 +
 .../versions/05f30312d566_merge_heads.py      |   3 -
 .../0e2a74e0fc9f_add_time_zone_awareness.py   |  26 ++-
 ...add_dag_id_state_index_on_dag_run_table.py |   3 +-
 .../1507a7289a2f_create_is_encrypted.py       |   7 +-
 ...e3_add_is_encrypted_column_to_variable_.py |   7 +-
 .../versions/1b38cef5b76e_add_dagrun.py       |  25 +--
 .../211e584da130_add_ti_state_index.py        |   4 +-
 ...24_add_executor_config_to_task_instance.py |  11 +-
 .../versions/2e541a1dcfed_task_duration.py    |   8 +-
 .../2e82aab8ef20_rename_user_table.py         |   4 +-
 ...0f54d61_more_logging_into_task_isntance.py |   9 +-
 ...4_add_kubernetes_resource_checkpointing.py |   7 +-
 .../versions/40e67319e3a9_dagrun_config.py    |   5 +-
 .../versions/4446e08588_dagrun_start_end.py   |   6 +-
 ..._add_fractional_seconds_to_mysql_tables.py | 208 +++++++++++-------
 .../502898887f84_adding_extra_to_log.py       |   5 +-
 .../versions/52d714495f0_job_id_indices.py    |   7 +-
 ...61833c1c74b_add_password_column_to_user.py |   5 +-
 ...d17757c7a_add_pid_field_to_taskinstance.py |   6 +-
 ...de9cddf6c9_add_task_fails_journal_table.py |   6 +-
 .../8504051e801b_xcom_dag_task_indices.py     |   8 +-
 .../856955da8476_fix_sqlite_foreign_key.py    |  64 +++---
 ...5c0_add_kubernetes_scheduler_uniqueness.py |   6 +-
 .../947454bf1dff_add_ti_job_id_index.py       |   4 +-
 .../versions/9635ae0956e7_index_faskfail.py   |   5 +-
 ...6_add_a_column_to_track_the_encryption_.py |   9 +-
 ...dd_notification_sent_column_to_sla_miss.py |   7 +-
 ...6_make_xcom_value_column_a_large_binary.py |   8 +-
 ...7_add_max_tries_column_to_task_instance.py |  20 +-
 ...ae31099d61_increase_text_size_for_mysql.py |   8 +-
 .../versions/e3a246e0dc1_current_schema.py    |  10 +-
 ...433877c24_fix_mysql_not_null_constraint.py |   6 +-
 .../f2ca10b85618_add_dag_stats_table.py       |   5 +-
 airflow/operators/__init__.py                 |   2 +-
 airflow/utils/dates.py                        |  13 +-
 airflow/utils/decorators.py                   |   1 +
 airflow/utils/email.py                        |   7 +-
 airflow/utils/helpers.py                      |   2 +-
 airflow/utils/log/es_task_handler.py          |   2 +-
 airflow/www/app.py                            |   4 +-
 airflow/www/utils.py                          |   5 +-
 airflow/www/views.py                          |  19 +-
 airflow/www_rbac/app.py                       |   3 +-
 airflow/www_rbac/views.py                     |   2 +-
 dags/test_dag.py                              |   8 +-
 54 files changed, 329 insertions(+), 323 deletions(-)

diff --git a/airflow/__init__.py b/airflow/__init__.py
index bc6a7bbe19f36..d010fe4c74840 100644
--- a/airflow/__init__.py
+++ b/airflow/__init__.py
@@ -32,8 +32,8 @@
 
 import sys
 
-from airflow import configuration as conf
-from airflow import settings
+# flake8: noqa: F401
+from airflow import settings, configuration as conf
 from airflow.models import DAG
 from flask_admin import BaseView
 from importlib import import_module
diff --git a/airflow/contrib/auth/backends/github_enterprise_auth.py b/airflow/contrib/auth/backends/github_enterprise_auth.py
index 78afee46078dc..99c01ed2794ce 100644
--- a/airflow/contrib/auth/backends/github_enterprise_auth.py
+++ b/airflow/contrib/auth/backends/github_enterprise_auth.py
@@ -19,18 +19,14 @@
 import flask_login
 
 # Need to expose these downstream
-# pylint: disable=unused-import
-from flask_login import (current_user,
-                         logout_user,
-                         login_required,
-                         login_user)
-# pylint: enable=unused-import
+# flake8: noqa: F401
+from flask_login import current_user, logout_user, login_required, login_user
 
 from flask import url_for, redirect, request
 
 from flask_oauthlib.client import OAuth
 
-from airflow import models, configuration, settings
+from airflow import models, configuration
 from airflow.configuration import AirflowConfigException
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
diff --git a/airflow/contrib/auth/backends/google_auth.py b/airflow/contrib/auth/backends/google_auth.py
index 131e3d6adb8f5..ddbcb1222f2c0 100644
--- a/airflow/contrib/auth/backends/google_auth.py
+++ b/airflow/contrib/auth/backends/google_auth.py
@@ -19,18 +19,14 @@
 import flask_login
 
 # Need to expose these downstream
-# pylint: disable=unused-import
-from flask_login import (current_user,
-                         logout_user,
-                         login_required,
-                         login_user)
-# pylint: enable=unused-import
+# flake8: noqa: F401
+from flask_login import current_user, logout_user, login_required, login_user
 
 from flask import url_for, redirect, request
 
 from flask_oauthlib.client import OAuth
 
-from airflow import models, configuration, settings
+from airflow import models, configuration
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
 
diff --git a/airflow/contrib/auth/backends/kerberos_auth.py b/airflow/contrib/auth/backends/kerberos_auth.py
index d8a2410e74bc8..17b8b387c14ef 100644
--- a/airflow/contrib/auth/backends/kerberos_auth.py
+++ b/airflow/contrib/auth/backends/kerberos_auth.py
@@ -22,8 +22,7 @@
 from airflow.exceptions import AirflowConfigException
 from flask_login import current_user
 from flask import flash
-from wtforms import (
-    Form, PasswordField, StringField)
+from wtforms import Form, PasswordField, StringField
 from wtforms.validators import InputRequired
 
 # pykerberos should be used as it verifies the KDC, the "kerberos" module does not do so
@@ -33,7 +32,6 @@
 
 from flask import url_for, redirect
 
-from airflow import settings
 from airflow import models
 from airflow import configuration
 from airflow.utils.db import provide_session
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index dc17dab5124cd..587fc2be16d05 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -19,13 +19,12 @@
 from future.utils import native
 
 import flask_login
-from flask_login import login_required, current_user, logout_user
+from flask_login import login_required, current_user, logout_user  # noqa: F401
 from flask import flash
-from wtforms import (
-    Form, PasswordField, StringField)
+from wtforms import Form, PasswordField, StringField
 from wtforms.validators import InputRequired
 
-from ldap3 import Server, Connection, Tls, LEVEL, SUBTREE, BASE
+from ldap3 import Server, Connection, Tls, LEVEL, SUBTREE
 import ssl
 
 from flask import url_for, redirect
diff --git a/airflow/contrib/operators/mlengine_prediction_summary.py b/airflow/contrib/operators/mlengine_prediction_summary.py
index 5dac0a44a9dcb..def793c1be001 100644
--- a/airflow/contrib/operators/mlengine_prediction_summary.py
+++ b/airflow/contrib/operators/mlengine_prediction_summary.py
@@ -1,3 +1,4 @@
+# flake8: noqa: F841
 #
 # Licensed to the Apache Software Foundation (ASF) under one or more
 # contributor license agreements.  See the NOTICE file distributed with
diff --git a/airflow/default_login.py b/airflow/default_login.py
index b6453c55d0c69..e423199fe01a9 100644
--- a/airflow/default_login.py
+++ b/airflow/default_login.py
@@ -25,11 +25,11 @@
 """
 
 import flask_login
-from flask_login import login_required, current_user, logout_user
+from flask_login import login_required, current_user, logout_user  # noqa: F401
 
 from flask import url_for, redirect
 
-from airflow import settings
+from airflow import settings  # noqa: F401
 from airflow import models
 from airflow.utils.db import provide_session
 
@@ -67,9 +67,6 @@ def is_superuser(self):
         """Access all the things"""
         return True
 
-# models.User = User  # hack!
-# del User
-
 
 @login_manager.user_loader
 @provide_session
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 2df2ed6009a31..526af2a75c1d1 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -666,7 +666,7 @@ def manage_slas(self, dag, session=None):
         slas = (
             session
             .query(SlaMiss)
-            .filter(SlaMiss.notification_sent == False)
+            .filter(SlaMiss.notification_sent == False)  # noqa: E712
             .filter(SlaMiss.dag_id == dag.dag_id)
             .all()
         )
@@ -804,7 +804,7 @@ def create_dag_run(self, dag, session=None):
                 session.query(func.max(DagRun.execution_date))
                 .filter_by(dag_id=dag.dag_id)
                 .filter(or_(
-                    DagRun.external_trigger == False,
+                    DagRun.external_trigger == False,  # noqa: E712
                     # add % as a wildcard for the like query
                     DagRun.run_id.like(DagRun.ID_PREFIX + '%')
                 ))
@@ -1076,14 +1076,16 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                 DR,
                 and_(DR.dag_id == TI.dag_id, DR.execution_date == TI.execution_date)
             )
-            .filter(or_(DR.run_id == None,  # noqa E711
+            .filter(or_(DR.run_id == None,  # noqa: E711
                     not_(DR.run_id.like(BackfillJob.ID_PREFIX + '%'))))
             .outerjoin(DM, DM.dag_id == TI.dag_id)
-            .filter(or_(DM.dag_id == None,  # noqa E711
+            .filter(or_(DM.dag_id == None,  # noqa: E711
                     not_(DM.is_paused)))
         )
         if None in states:
-            ti_query = ti_query.filter(or_(TI.state == None, TI.state.in_(states))) # noqa E711
+            ti_query = ti_query.filter(
+                or_(TI.state == None, TI.state.in_(states))  # noqa: E711
+            )
         else:
             ti_query = ti_query.filter(TI.state.in_(states))
 
@@ -1173,8 +1175,8 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                 )
                 if current_task_concurrency >= task_concurrency_limit:
                     self.log.info(
-                        "Not executing %s since the number of tasks running or queued from DAG %s"
-                        " is >= to the DAG's task concurrency limit of %s",
+                        "Not executing %s since the number of tasks running or queued "
+                        "from DAG %s is >= to the DAG's task concurrency limit of %s",
                         task_instance, dag_id, task_concurrency_limit
                     )
                     continue
@@ -1250,7 +1252,7 @@ def _change_state_for_executable_task_instances(self, task_instances,
 
         if None in acceptable_states:
             ti_query = ti_query.filter(
-                or_(TI.state == None, TI.state.in_(acceptable_states)) # noqa E711
+                or_(TI.state == None, TI.state.in_(acceptable_states))  # noqa: E711
             )
         else:
             ti_query = ti_query.filter(TI.state.in_(acceptable_states))
diff --git a/airflow/migrations/env.py b/airflow/migrations/env.py
index 97ebe4257f2c4..4e1977635a12f 100644
--- a/airflow/migrations/env.py
+++ b/airflow/migrations/env.py
@@ -85,6 +85,7 @@ def run_migrations_online():
         with context.begin_transaction():
             context.run_migrations()
 
+
 if context.is_offline_mode():
     run_migrations_offline()
 else:
diff --git a/airflow/migrations/versions/05f30312d566_merge_heads.py b/airflow/migrations/versions/05f30312d566_merge_heads.py
index 78d5652679ca9..f869cb8c08e5a 100644
--- a/airflow/migrations/versions/05f30312d566_merge_heads.py
+++ b/airflow/migrations/versions/05f30312d566_merge_heads.py
@@ -31,9 +31,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     pass
diff --git a/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py b/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
index ad10c76ab8bc6..ac7824fd9e2f5 100644
--- a/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
+++ b/airflow/migrations/versions/0e2a74e0fc9f_add_time_zone_awareness.py
@@ -25,16 +25,16 @@
 
 """
 
+from alembic import op
+from sqlalchemy.dialects import mysql
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = '0e2a74e0fc9f'
 down_revision = 'd2ae31099d61'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-from sqlalchemy.dialects import mysql
-import sqlalchemy as sa
-
 
 def upgrade():
     conn = op.get_bind()
@@ -69,14 +69,16 @@ def upgrade():
         op.alter_column(table_name='log', column_name='dttm', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='log', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6))
 
-        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6), nullable=False)
+        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6),
+                        nullable=False)
         op.alter_column(table_name='sla_miss', column_name='timestamp', type_=mysql.TIMESTAMP(fsp=6))
 
         op.alter_column(table_name='task_fail', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='task_fail', column_name='start_date', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='task_fail', column_name='end_date', type_=mysql.TIMESTAMP(fsp=6))
 
-        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6), nullable=False)
+        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.TIMESTAMP(fsp=6),
+                        nullable=False)
         op.alter_column(table_name='task_instance', column_name='start_date', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='task_instance', column_name='end_date', type_=mysql.TIMESTAMP(fsp=6))
         op.alter_column(table_name='task_instance', column_name='queued_dttm', type_=mysql.TIMESTAMP(fsp=6))
@@ -117,14 +119,16 @@ def upgrade():
         op.alter_column(table_name='log', column_name='dttm', type_=sa.TIMESTAMP(timezone=True))
         op.alter_column(table_name='log', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True))
 
-        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True), nullable=False)
+        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True),
+                        nullable=False)
         op.alter_column(table_name='sla_miss', column_name='timestamp', type_=sa.TIMESTAMP(timezone=True))
 
         op.alter_column(table_name='task_fail', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True))
         op.alter_column(table_name='task_fail', column_name='start_date', type_=sa.TIMESTAMP(timezone=True))
         op.alter_column(table_name='task_fail', column_name='end_date', type_=sa.TIMESTAMP(timezone=True))
 
-        op.alter_column(table_name='task_instance', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True), nullable=False)
+        op.alter_column(table_name='task_instance', column_name='execution_date', type_=sa.TIMESTAMP(timezone=True),
+                        nullable=False)
         op.alter_column(table_name='task_instance', column_name='start_date', type_=sa.TIMESTAMP(timezone=True))
         op.alter_column(table_name='task_instance', column_name='end_date', type_=sa.TIMESTAMP(timezone=True))
         op.alter_column(table_name='task_instance', column_name='queued_dttm', type_=sa.TIMESTAMP(timezone=True))
@@ -161,14 +165,16 @@ def downgrade():
         op.alter_column(table_name='log', column_name='dttm', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='log', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
 
-        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.DATETIME(fsp=6), nullable=False)
+        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.DATETIME(fsp=6),
+                        nullable=False)
         op.alter_column(table_name='sla_miss', column_name='DATETIME', type_=mysql.DATETIME(fsp=6))
 
         op.alter_column(table_name='task_fail', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='task_fail', column_name='start_date', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='task_fail', column_name='end_date', type_=mysql.DATETIME(fsp=6))
 
-        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.DATETIME(fsp=6), nullable=False)
+        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.DATETIME(fsp=6),
+                        nullable=False)
         op.alter_column(table_name='task_instance', column_name='start_date', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='task_instance', column_name='end_date', type_=mysql.DATETIME(fsp=6))
         op.alter_column(table_name='task_instance', column_name='queued_dttm', type_=mysql.DATETIME(fsp=6))
diff --git a/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py b/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
index 6ee50aa94da81..288a0b60aa821 100644
--- a/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
+++ b/airflow/migrations/versions/127d2bf2dfa7_add_dag_id_state_index_on_dag_run_table.py
@@ -23,6 +23,7 @@
 Create Date: 2017-01-25 11:43:51.635667
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '127d2bf2dfa7'
@@ -30,8 +31,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
 
 def upgrade():
     op.create_index('dag_id_state', 'dag_run', ['dag_id', 'state'], unique=False)
diff --git a/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py b/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
index 3db0d41190408..fe84254c38caa 100644
--- a/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
+++ b/airflow/migrations/versions/1507a7289a2f_create_is_encrypted.py
@@ -24,6 +24,9 @@
 Create Date: 2015-08-18 18:57:51.927315
 
 """
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.engine.reflection import Inspector
 
 # revision identifiers, used by Alembic.
 revision = '1507a7289a2f'
@@ -31,10 +34,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.engine.reflection import Inspector
-
 connectionhelper = sa.Table(
     'connection',
     sa.MetaData(),
diff --git a/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py b/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
index aaf938a0355ee..16ab349563428 100644
--- a/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
+++ b/airflow/migrations/versions/1968acfc09e3_add_is_encrypted_column_to_variable_.py
@@ -24,6 +24,8 @@
 Create Date: 2016-02-02 17:20:55.692295
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '1968acfc09e3'
@@ -31,12 +33,9 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
-    op.add_column('variable', sa.Column('is_encrypted', sa.Boolean,default=False))
+    op.add_column('variable', sa.Column('is_encrypted', sa.Boolean, default=False))
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py b/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
index 79fcff454114a..50d53652c4734 100644
--- a/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
+++ b/airflow/migrations/versions/1b38cef5b76e_add_dagrun.py
@@ -25,28 +25,27 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = '1b38cef5b76e'
 down_revision = '502898887f84'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_table('dag_run',
-        sa.Column('id', sa.Integer(), nullable=False),
-        sa.Column('dag_id', sa.String(length=250), nullable=True),
-        sa.Column('execution_date', sa.DateTime(), nullable=True),
-        sa.Column('state', sa.String(length=50), nullable=True),
-        sa.Column('run_id', sa.String(length=250), nullable=True),
-        sa.Column('external_trigger', sa.Boolean(), nullable=True),
-        sa.PrimaryKeyConstraint('id'),
-        sa.UniqueConstraint('dag_id', 'execution_date'),
-        sa.UniqueConstraint('dag_id', 'run_id'),
-    )
+                    sa.Column('id', sa.Integer(), nullable=False),
+                    sa.Column('dag_id', sa.String(length=250), nullable=True),
+                    sa.Column('execution_date', sa.DateTime(), nullable=True),
+                    sa.Column('state', sa.String(length=50), nullable=True),
+                    sa.Column('run_id', sa.String(length=250), nullable=True),
+                    sa.Column('external_trigger', sa.Boolean(), nullable=True),
+                    sa.PrimaryKeyConstraint('id'),
+                    sa.UniqueConstraint('dag_id', 'execution_date'),
+                    sa.UniqueConstraint('dag_id', 'run_id'))
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/211e584da130_add_ti_state_index.py b/airflow/migrations/versions/211e584da130_add_ti_state_index.py
index afc600d58aca1..b17f390e0b65b 100644
--- a/airflow/migrations/versions/211e584da130_add_ti_state_index.py
+++ b/airflow/migrations/versions/211e584da130_add_ti_state_index.py
@@ -24,6 +24,7 @@
 Create Date: 2016-06-30 10:54:24.323588
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '211e584da130'
@@ -31,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_index('ti_state', 'task_instance', ['state'], unique=False)
diff --git a/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py b/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
index 27a9f593b54df..a757d2770971b 100644
--- a/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
+++ b/airflow/migrations/versions/27c6a30d7c24_add_executor_config_to_task_instance.py
@@ -26,18 +26,16 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+import dill
+
 # revision identifiers, used by Alembic.
 revision = '27c6a30d7c24'
 down_revision = '33ae817a1ff4'
 branch_labels = None
 depends_on = None
 
-
-from alembic import op
-import sqlalchemy as sa
-import dill
-
-
 TASK_INSTANCE_TABLE = "task_instance"
 NEW_COLUMN = "executor_config"
 
@@ -48,4 +46,3 @@ def upgrade():
 
 def downgrade():
     op.drop_column(TASK_INSTANCE_TABLE, NEW_COLUMN)
-
diff --git a/airflow/migrations/versions/2e541a1dcfed_task_duration.py b/airflow/migrations/versions/2e541a1dcfed_task_duration.py
index 6b24ef66e4ab2..595a5774a6b27 100644
--- a/airflow/migrations/versions/2e541a1dcfed_task_duration.py
+++ b/airflow/migrations/versions/2e541a1dcfed_task_duration.py
@@ -25,16 +25,16 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import mysql
+
 # revision identifiers, used by Alembic.
 revision = '2e541a1dcfed'
 down_revision = '1b38cef5b76e'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects import mysql
-
 
 def upgrade():
     # use batch_alter_table to support SQLite workaround
diff --git a/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py b/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
index 75db27cdb3a8c..fc8a1aab20e69 100644
--- a/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
+++ b/airflow/migrations/versions/2e82aab8ef20_rename_user_table.py
@@ -24,6 +24,7 @@
 Create Date: 2016-04-02 19:28:15.211915
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '2e82aab8ef20'
@@ -31,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.rename_table('user', 'users')
diff --git a/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py b/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
index 4f1364b971a57..473f76778b89d 100644
--- a/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
+++ b/airflow/migrations/versions/338e90f54d61_more_logging_into_task_isntance.py
@@ -17,13 +17,17 @@
 # specific language governing permissions and limitations
 # under the License.
 
-"""More logging into task_isntance
+"""More logging into task_instance
 
 Revision ID: 338e90f54d61
 Revises: 13eb55f81627
 Create Date: 2015-08-25 06:09:20.460147
 
 """
+# flake8: noqa: E266
+
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '338e90f54d61'
@@ -31,9 +35,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     ### commands auto generated by Alembic - please adjust! ###
diff --git a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
index 4eb056892ac5f..88a4199d3250e 100644
--- a/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
+++ b/airflow/migrations/versions/33ae817a1ff4_add_kubernetes_resource_checkpointing.py
@@ -25,6 +25,8 @@
 Create Date: 2017-09-11 15:26:47.598494
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '33ae817a1ff4'
@@ -32,10 +34,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
-
 RESOURCE_TABLE = "kube_resource_version"
 
 
@@ -64,4 +62,3 @@ def upgrade():
 
 def downgrade():
     op.drop_table(RESOURCE_TABLE)
-
diff --git a/airflow/migrations/versions/40e67319e3a9_dagrun_config.py b/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
index 02ea51501c49f..3da4d5f543038 100644
--- a/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
+++ b/airflow/migrations/versions/40e67319e3a9_dagrun_config.py
@@ -24,6 +24,8 @@
 Create Date: 2015-10-29 08:36:31.726728
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '40e67319e3a9'
@@ -31,9 +33,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('dag_run', sa.Column('conf', sa.PickleType(), nullable=True))
diff --git a/airflow/migrations/versions/4446e08588_dagrun_start_end.py b/airflow/migrations/versions/4446e08588_dagrun_start_end.py
index 101f2ad9055bf..29932c92060e9 100644
--- a/airflow/migrations/versions/4446e08588_dagrun_start_end.py
+++ b/airflow/migrations/versions/4446e08588_dagrun_start_end.py
@@ -25,15 +25,15 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = '4446e08588'
 down_revision = '561833c1c74b'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('dag_run', sa.Column('end_date', sa.DateTime(), nullable=True))
diff --git a/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py b/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
index c3898e95969b2..655ff61042d1e 100644
--- a/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
+++ b/airflow/migrations/versions/4addfa1236f1_add_fractional_seconds_to_mysql_tables.py
@@ -24,93 +24,147 @@
 
 """
 
+from alembic import op
+from sqlalchemy.dialects import mysql
+from alembic import context
+
 # revision identifiers, used by Alembic.
 revision = '4addfa1236f1'
 down_revision = 'f2ca10b85618'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects import mysql
-from alembic import context
-
 
 def upgrade():
     if context.config.get_main_option('sqlalchemy.url').startswith('mysql'):
-        op.alter_column(table_name='dag', column_name='last_scheduler_run', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='dag', column_name='last_pickled', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='dag', column_name='last_expired', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='dag_pickle', column_name='created_dttm', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='dag_run', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='dag_run', column_name='start_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='dag_run', column_name='end_date', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='import_error', column_name='timestamp', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='job', column_name='start_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='job', column_name='end_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='job', column_name='latest_heartbeat', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='known_event', column_name='start_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='known_event', column_name='end_date', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='log', column_name='dttm', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='log', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.DATETIME(fsp=6), nullable=False)
-        op.alter_column(table_name='sla_miss', column_name='timestamp', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='task_fail', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='task_fail', column_name='start_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='task_fail', column_name='end_date', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.DATETIME(fsp=6), nullable=False)
-        op.alter_column(table_name='task_instance', column_name='start_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='task_instance', column_name='end_date', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='task_instance', column_name='queued_dttm', type_=mysql.DATETIME(fsp=6))
-
-        op.alter_column(table_name='xcom', column_name='timestamp', type_=mysql.DATETIME(fsp=6))
-        op.alter_column(table_name='xcom', column_name='execution_date', type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='dag', column_name='last_scheduler_run',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='dag', column_name='last_pickled',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='dag', column_name='last_expired',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='dag_pickle', column_name='created_dttm',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='dag_run', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='dag_run', column_name='start_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='dag_run', column_name='end_date',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='import_error', column_name='timestamp',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='job', column_name='start_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='job', column_name='end_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='job', column_name='latest_heartbeat',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='known_event', column_name='start_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='known_event', column_name='end_date',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='log', column_name='dttm',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='log', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='sla_miss', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6),
+                        nullable=False)
+        op.alter_column(table_name='sla_miss', column_name='timestamp',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='task_fail', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='task_fail', column_name='start_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='task_fail', column_name='end_date',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='task_instance', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6),
+                        nullable=False)
+        op.alter_column(table_name='task_instance', column_name='start_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='task_instance', column_name='end_date',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='task_instance', column_name='queued_dttm',
+                        type_=mysql.DATETIME(fsp=6))
+
+        op.alter_column(table_name='xcom', column_name='timestamp',
+                        type_=mysql.DATETIME(fsp=6))
+        op.alter_column(table_name='xcom', column_name='execution_date',
+                        type_=mysql.DATETIME(fsp=6))
 
 
 def downgrade():
     if context.config.get_main_option('sqlalchemy.url').startswith('mysql'):
-        op.alter_column(table_name='dag', column_name='last_scheduler_run', type_=mysql.DATETIME())
-        op.alter_column(table_name='dag', column_name='last_pickled', type_=mysql.DATETIME())
-        op.alter_column(table_name='dag', column_name='last_expired', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='dag_pickle', column_name='created_dttm', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='dag_run', column_name='execution_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='dag_run', column_name='start_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='dag_run', column_name='end_date', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='import_error', column_name='timestamp', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='job', column_name='start_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='job', column_name='end_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='job', column_name='latest_heartbeat', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='known_event', column_name='start_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='known_event', column_name='end_date', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='log', column_name='dttm', type_=mysql.DATETIME())
-        op.alter_column(table_name='log', column_name='execution_date', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='sla_miss', column_name='execution_date', type_=mysql.DATETIME(), nullable=False)
-        op.alter_column(table_name='sla_miss', column_name='timestamp', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='task_fail', column_name='execution_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='task_fail', column_name='start_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='task_fail', column_name='end_date', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='task_instance', column_name='execution_date', type_=mysql.DATETIME(), nullable=False)
-        op.alter_column(table_name='task_instance', column_name='start_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='task_instance', column_name='end_date', type_=mysql.DATETIME())
-        op.alter_column(table_name='task_instance', column_name='queued_dttm', type_=mysql.DATETIME())
-
-        op.alter_column(table_name='xcom', column_name='timestamp', type_=mysql.DATETIME())
-        op.alter_column(table_name='xcom', column_name='execution_date', type_=mysql.DATETIME())
+        op.alter_column(table_name='dag', column_name='last_scheduler_run',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='dag', column_name='last_pickled',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='dag', column_name='last_expired',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='dag_pickle', column_name='created_dttm',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='dag_run', column_name='execution_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='dag_run', column_name='start_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='dag_run', column_name='end_date',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='import_error', column_name='timestamp',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='job', column_name='start_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='job', column_name='end_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='job', column_name='latest_heartbeat',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='known_event', column_name='start_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='known_event', column_name='end_date',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='log', column_name='dttm',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='log', column_name='execution_date',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='sla_miss', column_name='execution_date',
+                        type_=mysql.DATETIME(), nullable=False)
+        op.alter_column(table_name='sla_miss', column_name='timestamp',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='task_fail', column_name='execution_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='task_fail', column_name='start_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='task_fail', column_name='end_date',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='task_instance', column_name='execution_date',
+                        type_=mysql.DATETIME(),
+                        nullable=False)
+        op.alter_column(table_name='task_instance', column_name='start_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='task_instance', column_name='end_date',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='task_instance', column_name='queued_dttm',
+                        type_=mysql.DATETIME())
+
+        op.alter_column(table_name='xcom', column_name='timestamp',
+                        type_=mysql.DATETIME())
+        op.alter_column(table_name='xcom', column_name='execution_date',
+                        type_=mysql.DATETIME())
diff --git a/airflow/migrations/versions/502898887f84_adding_extra_to_log.py b/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
index 333b18e8d200d..632720a4e27b0 100644
--- a/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
+++ b/airflow/migrations/versions/502898887f84_adding_extra_to_log.py
@@ -24,6 +24,8 @@
 Create Date: 2015-11-03 22:50:49.794097
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '502898887f84'
@@ -31,9 +33,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('log', sa.Column('extra', sa.Text(), nullable=True))
diff --git a/airflow/migrations/versions/52d714495f0_job_id_indices.py b/airflow/migrations/versions/52d714495f0_job_id_indices.py
index 13f561cffb77f..94374cb68aa30 100644
--- a/airflow/migrations/versions/52d714495f0_job_id_indices.py
+++ b/airflow/migrations/versions/52d714495f0_job_id_indices.py
@@ -24,6 +24,7 @@
 Create Date: 2015-10-20 03:17:01.962542
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '52d714495f0'
@@ -31,12 +32,10 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
-    op.create_index('idx_job_state_heartbeat', 'job', ['state', 'latest_heartbeat'], unique=False)
+    op.create_index('idx_job_state_heartbeat', 'job',
+                    ['state', 'latest_heartbeat'], unique=False)
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py b/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
index d92db9f891b6b..a26a105ac8299 100644
--- a/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
+++ b/airflow/migrations/versions/561833c1c74b_add_password_column_to_user.py
@@ -24,6 +24,8 @@
 Create Date: 2015-11-30 06:51:25.872557
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '561833c1c74b'
@@ -31,9 +33,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('user', sa.Column('password', sa.String(255)))
diff --git a/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py b/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
index e23a0a8b2f742..77a35db48fad5 100644
--- a/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
+++ b/airflow/migrations/versions/5e7d17757c7a_add_pid_field_to_taskinstance.py
@@ -24,15 +24,15 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = '5e7d17757c7a'
 down_revision = '8504051e801b'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('task_instance', sa.Column('pid', sa.Integer))
diff --git a/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py b/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
index 6dda5df43b146..2def57e904870 100644
--- a/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
+++ b/airflow/migrations/versions/64de9cddf6c9_add_task_fails_journal_table.py
@@ -23,6 +23,8 @@
 Create Date: 2016-08-03 14:02:59.203021
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '64de9cddf6c9'
@@ -30,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_table(
@@ -47,5 +46,6 @@ def upgrade():
         sa.PrimaryKeyConstraint('id'),
     )
 
+
 def downgrade():
     op.drop_table('task_fail')
diff --git a/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py b/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
index d6a4514ae2883..fdcbc59df8d00 100644
--- a/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
+++ b/airflow/migrations/versions/8504051e801b_xcom_dag_task_indices.py
@@ -25,18 +25,18 @@
 
 """
 
+from alembic import op
+
 # revision identifiers, used by Alembic.
 revision = '8504051e801b'
 down_revision = '4addfa1236f1'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
-    op.create_index('idx_xcom_dag_task_date', 'xcom', ['dag_id', 'task_id', 'execution_date'], unique=False)
+    op.create_index('idx_xcom_dag_task_date', 'xcom',
+                    ['dag_id', 'task_id', 'execution_date'], unique=False)
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py b/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
index 5b11dc7860ea9..52a817081be7c 100644
--- a/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
+++ b/airflow/migrations/versions/856955da8476_fix_sqlite_foreign_key.py
@@ -25,15 +25,15 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = '856955da8476'
 down_revision = 'f23433877c24'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     conn = op.get_bind()
@@ -45,41 +45,39 @@ def upgrade():
         #
         # Use batch_alter_table to support SQLite workaround.
         chart_table = sa.Table('chart',
-            sa.MetaData(),
-            sa.Column('id', sa.Integer(), nullable=False),
-            sa.Column('label', sa.String(length=200), nullable=True),
-            sa.Column('conn_id', sa.String(length=250), nullable=False),
-            sa.Column('user_id', sa.Integer(), nullable=True),
-            sa.Column('chart_type', sa.String(length=100), nullable=True),
-            sa.Column('sql_layout', sa.String(length=50), nullable=True),
-            sa.Column('sql', sa.Text(), nullable=True),
-            sa.Column('y_log_scale', sa.Boolean(), nullable=True),
-            sa.Column('show_datatable', sa.Boolean(), nullable=True),
-            sa.Column('show_sql', sa.Boolean(), nullable=True),
-            sa.Column('height', sa.Integer(), nullable=True),
-            sa.Column('default_params', sa.String(length=5000), nullable=True),
-            sa.Column('x_is_date', sa.Boolean(), nullable=True),
-            sa.Column('iteration_no', sa.Integer(), nullable=True),
-            sa.Column('last_modified', sa.DateTime(), nullable=True),
-            sa.PrimaryKeyConstraint('id')
-        )
+                               sa.MetaData(),
+                               sa.Column('id', sa.Integer(), nullable=False),
+                               sa.Column('label', sa.String(length=200), nullable=True),
+                               sa.Column('conn_id', sa.String(length=250), nullable=False),
+                               sa.Column('user_id', sa.Integer(), nullable=True),
+                               sa.Column('chart_type', sa.String(length=100), nullable=True),
+                               sa.Column('sql_layout', sa.String(length=50), nullable=True),
+                               sa.Column('sql', sa.Text(), nullable=True),
+                               sa.Column('y_log_scale', sa.Boolean(), nullable=True),
+                               sa.Column('show_datatable', sa.Boolean(), nullable=True),
+                               sa.Column('show_sql', sa.Boolean(), nullable=True),
+                               sa.Column('height', sa.Integer(), nullable=True),
+                               sa.Column('default_params', sa.String(length=5000), nullable=True),
+                               sa.Column('x_is_date', sa.Boolean(), nullable=True),
+                               sa.Column('iteration_no', sa.Integer(), nullable=True),
+                               sa.Column('last_modified', sa.DateTime(), nullable=True),
+                               sa.PrimaryKeyConstraint('id'))
         with op.batch_alter_table('chart', copy_from=chart_table) as batch_op:
             batch_op.create_foreign_key('chart_user_id_fkey', 'users',
                                         ['user_id'], ['id'])
 
         known_event_table = sa.Table('known_event',
-            sa.MetaData(),
-            sa.Column('id', sa.Integer(), nullable=False),
-            sa.Column('label', sa.String(length=200), nullable=True),
-            sa.Column('start_date', sa.DateTime(), nullable=True),
-            sa.Column('end_date', sa.DateTime(), nullable=True),
-            sa.Column('user_id', sa.Integer(), nullable=True),
-            sa.Column('known_event_type_id', sa.Integer(), nullable=True),
-            sa.Column('description', sa.Text(), nullable=True),
-            sa.ForeignKeyConstraint(['known_event_type_id'],
-                                    ['known_event_type.id'], ),
-            sa.PrimaryKeyConstraint('id')
-        )
+                                     sa.MetaData(),
+                                     sa.Column('id', sa.Integer(), nullable=False),
+                                     sa.Column('label', sa.String(length=200), nullable=True),
+                                     sa.Column('start_date', sa.DateTime(), nullable=True),
+                                     sa.Column('end_date', sa.DateTime(), nullable=True),
+                                     sa.Column('user_id', sa.Integer(), nullable=True),
+                                     sa.Column('known_event_type_id', sa.Integer(), nullable=True),
+                                     sa.Column('description', sa.Text(), nullable=True),
+                                     sa.ForeignKeyConstraint(['known_event_type_id'],
+                                                             ['known_event_type.id'], ),
+                                     sa.PrimaryKeyConstraint('id'))
         with op.batch_alter_table('chart', copy_from=known_event_table) as batch_op:
             batch_op.create_foreign_key('known_event_user_id_fkey', 'users',
                                         ['user_id'], ['id'])
diff --git a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
index ea1e9ac4bf837..633201b03b6cd 100644
--- a/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
+++ b/airflow/migrations/versions/86770d1215c0_add_kubernetes_scheduler_uniqueness.py
@@ -25,6 +25,8 @@
 Create Date: 2018-04-03 15:31:20.814328
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = '86770d1215c0'
@@ -32,10 +34,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
-
 RESOURCE_TABLE = "kube_worker_uuid"
 
 
diff --git a/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py b/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
index b821cacedc400..6ff41baa28c7a 100644
--- a/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
+++ b/airflow/migrations/versions/947454bf1dff_add_ti_job_id_index.py
@@ -24,6 +24,7 @@
 Create Date: 2017-08-15 15:12:13.845074
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '947454bf1dff'
@@ -31,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_index('ti_job_id', 'task_instance', ['job_id'], unique=False)
diff --git a/airflow/migrations/versions/9635ae0956e7_index_faskfail.py b/airflow/migrations/versions/9635ae0956e7_index_faskfail.py
index da69846233e87..6b21c3474acc4 100644
--- a/airflow/migrations/versions/9635ae0956e7_index_faskfail.py
+++ b/airflow/migrations/versions/9635ae0956e7_index_faskfail.py
@@ -24,6 +24,7 @@
 Create Date: 2018-06-17 21:40:01.963540
 
 """
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision = '9635ae0956e7'
@@ -31,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_index('idx_task_fail_dag_task_date', 'task_fail', ['dag_id', 'task_id', 'execution_date'], unique=False)
@@ -41,4 +39,3 @@ def upgrade():
 
 def downgrade():
     op.drop_index('idx_task_fail_dag_task_date', table_name='task_fail')
-
diff --git a/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py b/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
index a19eb58eb5c8d..503cd0b6f0406 100644
--- a/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
+++ b/airflow/migrations/versions/bba5a7cfc896_add_a_column_to_track_the_encryption_.py
@@ -25,18 +25,19 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = 'bba5a7cfc896'
 down_revision = 'bbc73705a13e'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
-    op.add_column('connection', sa.Column('is_extra_encrypted', sa.Boolean,default=False))
+    op.add_column('connection',
+                  sa.Column('is_extra_encrypted', sa.Boolean, default=False))
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py b/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
index 04cdc22d6cdab..9855a6d4daf3c 100644
--- a/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
+++ b/airflow/migrations/versions/bbc73705a13e_add_notification_sent_column_to_sla_miss.py
@@ -24,6 +24,8 @@
 Create Date: 2016-01-14 18:05:54.871682
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = 'bbc73705a13e'
@@ -31,12 +33,9 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
-    op.add_column('sla_miss', sa.Column('notification_sent', sa.Boolean,default=False))
+    op.add_column('sla_miss', sa.Column('notification_sent', sa.Boolean, default=False))
 
 
 def downgrade():
diff --git a/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py b/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
index a02eea5519cc6..a1a5270c7bff4 100644
--- a/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
+++ b/airflow/migrations/versions/bdaa763e6c56_make_xcom_value_column_a_large_binary.py
@@ -23,6 +23,9 @@
 Create Date: 2017-08-14 16:06:31.568971
 
 """
+from alembic import op
+import dill
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = 'bdaa763e6c56'
@@ -30,15 +33,10 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import dill
-import sqlalchemy as sa
-
 
 def upgrade():
     # There can be data truncation here as LargeBinary can be smaller than the pickle
     # type.
-
     # use batch_alter_table to support SQLite workaround
     with op.batch_alter_table("xcom") as batch_op:
         batch_op.alter_column('value', type_=sa.LargeBinary())
diff --git a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
index 61ad3ef57069d..03195a7536d3d 100644
--- a/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
+++ b/airflow/migrations/versions/cc1e65623dc7_add_max_tries_column_to_task_instance.py
@@ -25,22 +25,21 @@
 
 """
 
-# revision identifiers, used by Alembic.
-revision = 'cc1e65623dc7'
-down_revision = '127d2bf2dfa7'
-branch_labels = None
-depends_on = None
-
 from alembic import op
 import sqlalchemy as sa
 from airflow import settings
 from airflow.models import DagBag
 
-from sqlalchemy import (
-    Column, Integer, String)
+from sqlalchemy import Column, Integer, String
 from sqlalchemy.engine.reflection import Inspector
 from sqlalchemy.ext.declarative import declarative_base
 
+# revision identifiers, used by Alembic.
+revision = 'cc1e65623dc7'
+down_revision = '127d2bf2dfa7'
+branch_labels = None
+depends_on = None
+
 Base = declarative_base()
 BATCH_SIZE = 5000
 ID_LEN = 250
@@ -57,8 +56,7 @@ class TaskInstance(Base):
 
 
 def upgrade():
-    op.add_column('task_instance', sa.Column('max_tries', sa.Integer,
-        server_default="-1"))
+    op.add_column('task_instance', sa.Column('max_tries', sa.Integer, server_default="-1"))
     # Check if table task_instance exist before data migration. This check is
     # needed for database that does not create table until migration finishes.
     # Checking task_instance table exists prevent the error of querying
@@ -128,7 +126,7 @@ def downgrade():
                     # max number of self retry (task.retries) minus number of
                     # times left for task instance to try the task.
                     ti.try_number = max(0, task.retries - (ti.max_tries -
-                        ti.try_number))
+                                                           ti.try_number))
                 ti.max_tries = -1
                 session.merge(ti)
             session.commit()
diff --git a/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py b/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
index 5ecb0d5c72357..db5afaf023e54 100644
--- a/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
+++ b/airflow/migrations/versions/d2ae31099d61_increase_text_size_for_mysql.py
@@ -23,6 +23,9 @@
 Create Date: 2017-08-18 17:07:16.686130
 
 """
+from alembic import op
+from sqlalchemy.dialects import mysql
+from alembic import context
 
 # revision identifiers, used by Alembic.
 revision = 'd2ae31099d61'
@@ -30,11 +33,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects import mysql
-from alembic import context
-
 
 def upgrade():
     if context.config.get_main_option('sqlalchemy.url').startswith('mysql'):
diff --git a/airflow/migrations/versions/e3a246e0dc1_current_schema.py b/airflow/migrations/versions/e3a246e0dc1_current_schema.py
index cfa4147dd925d..cbf98976458d4 100644
--- a/airflow/migrations/versions/e3a246e0dc1_current_schema.py
+++ b/airflow/migrations/versions/e3a246e0dc1_current_schema.py
@@ -25,17 +25,17 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy import func
+from sqlalchemy.engine.reflection import Inspector
+
 # revision identifiers, used by Alembic.
 revision = 'e3a246e0dc1'
 down_revision = None
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy import func
-from sqlalchemy.engine.reflection import Inspector
-
 
 def upgrade():
     conn = op.get_bind()
diff --git a/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py b/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py
index 44edeef0695a7..3e643f629dfcd 100644
--- a/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py
+++ b/airflow/migrations/versions/f23433877c24_fix_mysql_not_null_constraint.py
@@ -24,6 +24,8 @@
 Create Date: 2018-06-17 10:16:31.412131
 
 """
+from alembic import op
+from sqlalchemy.dialects import mysql
 
 # revision identifiers, used by Alembic.
 revision = 'f23433877c24'
@@ -31,9 +33,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-from sqlalchemy.dialects import mysql
 
 def upgrade():
     conn = op.get_bind()
@@ -51,4 +50,3 @@ def downgrade():
         op.alter_column('xcom', 'timestamp', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
         op.alter_column('xcom', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
         op.alter_column('task_fail', 'execution_date', existing_type=mysql.TIMESTAMP(fsp=6), nullable=True)
-
diff --git a/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py b/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
index 3e3d40abc4384..e14b4b8025109 100644
--- a/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
+++ b/airflow/migrations/versions/f2ca10b85618_add_dag_stats_table.py
@@ -23,6 +23,8 @@
 Create Date: 2016-07-20 15:08:28.247537
 
 """
+from alembic import op
+import sqlalchemy as sa
 
 # revision identifiers, used by Alembic.
 revision = 'f2ca10b85618'
@@ -30,9 +32,6 @@
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.create_table('dag_stats',
diff --git a/airflow/operators/__init__.py b/airflow/operators/__init__.py
index efdfd3ebe2dc1..00f34d038ccfd 100644
--- a/airflow/operators/__init__.py
+++ b/airflow/operators/__init__.py
@@ -19,7 +19,7 @@
 
 import sys
 import os
-from airflow.models import BaseOperator
+from airflow.models import BaseOperator  # noqa: F401
 
 # ------------------------------------------------------------------------
 #
diff --git a/airflow/utils/dates.py b/airflow/utils/dates.py
index 216b2ed62667f..3393de0311491 100644
--- a/airflow/utils/dates.py
+++ b/airflow/utils/dates.py
@@ -24,12 +24,11 @@
 
 from airflow.utils import timezone
 from datetime import datetime, timedelta
-from dateutil.relativedelta import relativedelta  # for doctest
+from dateutil.relativedelta import relativedelta  # flake8: noqa: F401 for doctest
 import six
 
 from croniter import croniter
 
-
 cron_presets = {
     '@hourly': '0 * * * *',
     '@daily': '0 0 * * *',
@@ -39,11 +38,7 @@
 }
 
 
-def date_range(
-        start_date,
-        end_date=None,
-        num=None,
-        delta=None):
+def date_range(start_date, end_date=None, num=None, delta=None):
     """
     Get a set of dates as a list based on a start, end and delta, delta
     can be something that can be added to ``datetime.datetime``
@@ -181,8 +176,8 @@ def round_time(dt, delta, start_date=timezone.make_aware(datetime.min)):
             # Check if start_date + (lower + 1)*delta or
             # start_date + lower*delta is closer to dt and return the solution
             if (
-                    (start_date + (lower + 1) * delta) - dt <=
-                    dt - (start_date + lower * delta)):
+                (start_date + (lower + 1) * delta) - dt <=
+                dt - (start_date + lower * delta)):
                 return start_date + (lower + 1) * delta
             else:
                 return start_date + lower * delta
diff --git a/airflow/utils/decorators.py b/airflow/utils/decorators.py
index f1f0ea9a425e9..4bc8e0debdaaf 100644
--- a/airflow/utils/decorators.py
+++ b/airflow/utils/decorators.py
@@ -100,5 +100,6 @@ def wrapper(*args, **kwargs):
     return wrapper
 
 if 'BUILDING_AIRFLOW_DOCS' in os.environ:
+    # flake8: noqa: F811
     # Monkey patch hook to get good function headers while building docs
     apply_defaults = lambda x: x
diff --git a/airflow/utils/email.py b/airflow/utils/email.py
index 195c9c5c11b61..532880161eaf9 100644
--- a/airflow/utils/email.py
+++ b/airflow/utils/email.py
@@ -22,7 +22,6 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-from builtins import str
 from past.builtins import basestring
 
 import importlib
@@ -65,13 +64,13 @@ def send_email_smtp(to, subject, html_content, files=None,
 
     >>> send_email('test@example.com', 'foo', '<b>Foo</b> bar', ['/dev/null'], dryrun=True)
     """
-    SMTP_MAIL_FROM = configuration.conf.get('smtp', 'SMTP_MAIL_FROM')
+    smtp_mail_from = configuration.conf.get('smtp', 'SMTP_MAIL_FROM')
 
     to = get_email_address_list(to)
 
     msg = MIMEMultipart(mime_subtype)
     msg['Subject'] = subject
-    msg['From'] = SMTP_MAIL_FROM
+    msg['From'] = smtp_mail_from
     msg['To'] = ", ".join(to)
     recipients = to
     if cc:
@@ -99,7 +98,7 @@ def send_email_smtp(to, subject, html_content, files=None,
             part['Content-ID'] = '<%s>' % basename
             msg.attach(part)
 
-    send_MIME_email(SMTP_MAIL_FROM, recipients, msg, dryrun)
+    send_MIME_email(smtp_mail_from, recipients, msg, dryrun)
 
 
 def send_MIME_email(e_from, e_to, mime_msg, dryrun=False):
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index b3d1768945281..2a343ca0b5d96 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -34,7 +34,6 @@
 import os
 import re
 import signal
-import subprocess
 import sys
 import warnings
 
@@ -228,6 +227,7 @@ def reap_process_group(pid, log, sig=signal.SIGTERM,
     :param sig: signal type
     :param timeout: how much time a process has to terminate
     """
+
     def on_terminate(p):
         log.info("Process %s (%s) terminated with exit code %s", p, p.pid, p.returncode)
 
diff --git a/airflow/utils/log/es_task_handler.py b/airflow/utils/log/es_task_handler.py
index d74aabfbaead6..16372c0600bb5 100644
--- a/airflow/utils/log/es_task_handler.py
+++ b/airflow/utils/log/es_task_handler.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-# Using `from elasticsearch import *` would break elasticseach mocking used in unit test.
+# Using `from elasticsearch import *` would break elasticsearch mocking used in unit test.
 import elasticsearch
 import pendulum
 from elasticsearch_dsl import Search
diff --git a/airflow/www/app.py b/airflow/www/app.py
index bc5ee8c816ad4..428ff241fddd1 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -61,8 +61,8 @@ def create_app(config=None, testing=False):
     api.load_auth()
     api.api_auth.init_app(app)
 
-    cache = Cache(
-        app=app, config={'CACHE_TYPE': 'filesystem', 'CACHE_DIR': '/tmp'})
+    # flake8: noqa: F841
+    cache = Cache(app=app, config={'CACHE_TYPE': 'filesystem', 'CACHE_DIR': '/tmp'})
 
     app.register_blueprint(routes)
 
diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 1902657989d1b..757d2268bf4f5 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+# flake8: noqa: E402
 import inspect
 from future import standard_library
 standard_library.install_aliases()  # noqa: E402
@@ -31,14 +32,14 @@
 import os
 import re
 import time
+import wtforms
+from wtforms.compat import text_type
 import zipfile
 
 from flask import after_this_request, request, Response
 from flask_admin.model import filters
 import flask_admin.contrib.sqla.filters as sqlafilters
 from flask_login import current_user
-import wtforms
-from wtforms.compat import text_type
 
 from airflow import configuration, models, settings
 from airflow.utils.db import create_session
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 3418c96299f05..d097e54b85c05 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -22,7 +22,6 @@
 import codecs
 import copy
 import datetime as dt
-import inspect
 import itertools
 import json
 import logging
@@ -364,6 +363,7 @@ def get_date_time_num_runs_dag_runs_form_data(request, session, dag):
         'dr_state': dr_state,
     }
 
+
 class Airflow(BaseView):
     def is_visible(self):
         return False
@@ -480,8 +480,6 @@ def chart_data(self):
             else:
                 if chart.sql_layout == 'series':
                     # User provides columns (series, x, y)
-                    xaxis_label = df.columns[1]
-                    yaxis_label = df.columns[2]
                     df[df.columns[2]] = df[df.columns[2]].astype(np.float)
                     df = df.pivot_table(
                         index=df.columns[1],
@@ -489,8 +487,6 @@ def chart_data(self):
                         values=df.columns[2], aggfunc=np.sum)
                 else:
                     # User provides columns (x, y, metric1, metric2, ...)
-                    xaxis_label = df.columns[0]
-                    yaxis_label = 'y'
                     df.index = df[df.columns[0]]
                     df = df.sort(df.columns[0])
                     del df[df.columns[0]]
@@ -594,8 +590,8 @@ def task_stats(self, session=None):
             session.query(DagRun.dag_id, sqla.func.max(DagRun.execution_date).label('execution_date'))
                 .join(Dag, Dag.dag_id == DagRun.dag_id)
                 .filter(DagRun.state != State.RUNNING)
-                .filter(Dag.is_active == True)
-                .filter(Dag.is_subdag == False)
+                .filter(Dag.is_active == True)  # noqa: E712
+                .filter(Dag.is_subdag == False)  # noqa: E712
                 .group_by(DagRun.dag_id)
                 .subquery('last_dag_run')
         )
@@ -603,8 +599,8 @@ def task_stats(self, session=None):
             session.query(DagRun.dag_id, DagRun.execution_date)
                 .join(Dag, Dag.dag_id == DagRun.dag_id)
                 .filter(DagRun.state == State.RUNNING)
-                .filter(Dag.is_active == True)
-                .filter(Dag.is_subdag == False)
+                .filter(Dag.is_active == True)  # noqa: E712
+                .filter(Dag.is_subdag == False)  # noqa: E712
                 .subquery('running_dag_run')
         )
 
@@ -874,7 +870,7 @@ def task(self):
         for attr_name in dir(ti):
             if not attr_name.startswith('_'):
                 attr = getattr(ti, attr_name)
-                if type(attr) != type(self.task):
+                if type(attr) != type(self.task):  # noqa: E721
                     ti_attrs.append((attr_name, str(attr)))
 
         task_attrs = []
@@ -882,7 +878,7 @@ def task(self):
             if not attr_name.startswith('_'):
                 attr = getattr(task, attr_name)
                 if type(attr) != type(self.task) and \
-                        attr_name not in attr_renderer:
+                        attr_name not in attr_renderer:  # noqa: E721
                     task_attrs.append((attr_name, str(attr)))
 
         # Color coding the special attributes that are code
@@ -1170,7 +1166,6 @@ def clear(self):
     @wwwutils.notify_owner
     def dagrun_clear(self):
         dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
         origin = request.args.get('origin')
         execution_date = request.args.get('execution_date')
         confirmed = request.args.get('confirmed') == "true"
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 84e5ca2140f39..50f823b50d605 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -62,7 +62,8 @@ def create_app(config=None, session=None, testing=False, app_name="Airflow"):
     api.load_auth()
     api.api_auth.init_app(app)
 
-    cache = Cache(app=app, config={'CACHE_TYPE': 'filesystem', 'CACHE_DIR': '/tmp'})  # noqa
+    # flake8: noqa: F841
+    cache = Cache(app=app, config={'CACHE_TYPE': 'filesystem', 'CACHE_DIR': '/tmp'})
 
     from airflow.www_rbac.blueprints import routes
     app.register_blueprint(routes)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 1d2f6e1aef57a..276f4fae20e5c 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -35,7 +35,7 @@
 import pendulum
 import sqlalchemy as sqla
 from flask import (
-    g, redirect, request, Markup, Response, render_template,
+    redirect, request, Markup, Response, render_template,
     make_response, flash, jsonify)
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
diff --git a/dags/test_dag.py b/dags/test_dag.py
index 3c385bbbefe43..a133dd5a1263b 100644
--- a/dags/test_dag.py
+++ b/dags/test_dag.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -23,7 +23,9 @@
 from datetime import datetime, timedelta
 
 now = datetime.now()
-now_to_the_hour = (now - timedelta(0, 0, 0, 0, 0, 3)).replace(minute=0, second=0, microsecond=0)
+now_to_the_hour = (
+    now - timedelta(0, 0, 0, 0, 0, 3)
+).replace(minute=0, second=0, microsecond=0)
 START_DATE = now_to_the_hour
 DAG_NAME = 'test_dag_v1'
 

From 1a7f30a9d473e460c0105a47479429a6c500d758 Mon Sep 17 00:00:00 2001
From: Mike Ascah <mike.ascah@joinroot.com>
Date: Fri, 20 Jul 2018 13:46:50 +0200
Subject: [PATCH 365/808] [AIRFLOW-2771] Add except type to broad S3Hook try
 catch clauses

S3Hook will silently fail if given a conn_id that
does not exist. The
calls to check_for_key done by an S3KeySensor will
never fail if the
credentials object is not configured correctly.
This adds the expected
ClientError exception type when performing a HEAD
operation on an
object that doesn't exist to the try catch
statements so that other
exceptions are properly raised.

Closes #3616 from mascah/AIRFLOW-2771-S3hook-
except-type
---
 airflow/hooks/S3_hook.py    |  7 +++++--
 tests/hooks/test_s3_hook.py | 16 +++++++++++++++-
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index 76188f109c244..e39916a70ba3f 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -16,6 +16,7 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+from botocore.exceptions import ClientError
 
 from airflow.exceptions import AirflowException
 from airflow.contrib.hooks.aws_hook import AwsHook
@@ -54,7 +55,8 @@ def check_for_bucket(self, bucket_name):
         try:
             self.get_conn().head_bucket(Bucket=bucket_name)
             return True
-        except:
+        except ClientError as e:
+            self.log.info(e.response["Error"]["Message"])
             return False
 
     def get_bucket(self, bucket_name):
@@ -188,7 +190,8 @@ def check_for_key(self, key, bucket_name=None):
         try:
             self.get_conn().head_object(Bucket=bucket_name, Key=key)
             return True
-        except:
+        except ClientError as e:
+            self.log.info(e.response["Error"]["Message"])
             return False
 
     def get_key(self, key, bucket_name=None):
diff --git a/tests/hooks/test_s3_hook.py b/tests/hooks/test_s3_hook.py
index 8553e3b6471e9..e0f9e8a3eca53 100644
--- a/tests/hooks/test_s3_hook.py
+++ b/tests/hooks/test_s3_hook.py
@@ -22,6 +22,8 @@
 import tempfile
 import unittest
 
+from botocore.exceptions import NoCredentialsError
+
 from airflow import configuration
 
 try:
@@ -29,7 +31,6 @@
 except ImportError:
     S3Hook = None
 
-
 try:
     import boto3
     from moto import mock_s3
@@ -52,6 +53,7 @@ def test_parse_s3_url(self):
         self.assertEqual(parsed,
                          ("test", "this/is/not/a-real-key.txt"),
                          "Incorrect parsing of the s3 url")
+
     @mock_s3
     def test_check_for_bucket(self):
         hook = S3Hook(aws_conn_id=None)
@@ -61,6 +63,12 @@ def test_check_for_bucket(self):
         self.assertTrue(hook.check_for_bucket('bucket'))
         self.assertFalse(hook.check_for_bucket('not-a-bucket'))
 
+    def test_check_for_bucket_raises_error_with_invalid_conn_id(self):
+        hook = S3Hook(aws_conn_id="does_not_exist")
+
+        with self.assertRaises(NoCredentialsError):
+            hook.check_for_bucket('bucket')
+
     @mock_s3
     def test_get_bucket(self):
         hook = S3Hook(aws_conn_id=None)
@@ -172,6 +180,12 @@ def test_check_for_key(self):
         self.assertFalse(hook.check_for_key('b', 'bucket'))
         self.assertFalse(hook.check_for_key('s3://bucket//b'))
 
+    def test_check_for_key_raises_error_with_invalid_conn_id(self):
+        hook = S3Hook(aws_conn_id="does_not_exist")
+
+        with self.assertRaises(NoCredentialsError):
+            hook.check_for_key('a', 'bucket')
+
     @mock_s3
     def test_get_key(self):
         hook = S3Hook(aws_conn_id=None)

From 6d7180b6e3d2cf52610eca2238b7932aaa79c95f Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokkodriesprong@godatadriven.com>
Date: Thu, 8 Nov 2018 00:02:18 +0100
Subject: [PATCH 366/808] [AIRFLOW-3190] Make flake8 compliant

---
 airflow/security/utils.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/security/utils.py b/airflow/security/utils.py
index cf8ade922b336..d46c03af99a0f 100644
--- a/airflow/security/utils.py
+++ b/airflow/security/utils.py
@@ -18,10 +18,10 @@
 
 import re
 import socket
-import airflow.configuration as conf
 
 from airflow.utils.net import get_hostname
 
+
 def get_components(principal):
     """
     get_components(principal) -> (short name, instance (FQDN), realm)

From d81675a7254a24cc97c44e56cc7c489daa018498 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Fri, 21 Sep 2018 16:25:54 +0200
Subject: [PATCH 367/808] [AIRFLOW-2918] Fix Flake8 violations (#3931)

---
 tests/cli/__init__.py                                |  4 ++--
 tests/configuration.py                               |  4 ++--
 tests/contrib/__init__.py                            |  4 ++--
 tests/contrib/hooks/__init__.py                      |  4 ++--
 tests/contrib/hooks/test_aws_dynamodb_hook.py        |  4 ++--
 tests/contrib/hooks/test_aws_hook.py                 |  4 ++--
 tests/contrib/hooks/test_aws_lambda_hook.py          |  4 ++--
 tests/contrib/hooks/test_discord_webhook_hook.py     |  4 ++--
 tests/contrib/hooks/test_emr_hook.py                 |  4 ++--
 tests/contrib/hooks/test_ftp_hook.py                 | 12 ++++++------
 tests/contrib/hooks/test_gcp_pubsub_hook.py          |  4 ++--
 tests/contrib/hooks/test_jdbc_hook.py                |  4 ++--
 tests/contrib/hooks/test_jira_hook.py                |  4 ++--
 tests/contrib/hooks/test_redis_hook.py               |  4 ++--
 tests/contrib/hooks/test_redshift_hook.py            |  4 ++--
 tests/contrib/hooks/test_sftp_hook.py                |  4 ++--
 tests/contrib/hooks/test_slack_webhook_hook.py       |  4 ++--
 tests/contrib/hooks/test_snowflake_hook.py           |  4 ++--
 tests/contrib/hooks/test_spark_jdbc_hook.py          |  4 ++--
 tests/contrib/hooks/test_sqoop_hook.py               |  4 ++--
 tests/contrib/hooks/test_wasb_hook.py                |  4 ++--
 tests/contrib/hooks/test_zendesk_hook.py             |  4 ++--
 tests/contrib/operators/__init__.py                  |  4 ++--
 tests/contrib/operators/test_awsbatch_operator.py    |  4 ++--
 .../operators/test_discord_webhook_operator.py       |  4 ++--
 tests/contrib/operators/test_druid_operator.py       |  4 ++--
 tests/contrib/operators/test_ecs_operator.py         |  4 ++--
 .../contrib/operators/test_emr_add_steps_operator.py |  4 ++--
 .../operators/test_emr_create_job_flow_operator.py   |  4 ++--
 .../test_emr_terminate_job_flow_operator.py          |  4 ++--
 tests/contrib/operators/test_file_to_wasb.py         |  4 ++--
 .../contrib/operators/test_gcs_download_operator.py  |  4 ++--
 tests/contrib/operators/test_gcs_list_operator.py    |  4 ++--
 tests/contrib/operators/test_gcs_to_s3_operator.py   |  4 ++--
 tests/contrib/operators/test_hipchat_operator.py     |  4 ++--
 .../operators/test_hive_to_dynamodb_operator.py      |  4 ++--
 tests/contrib/operators/test_jenkins_operator.py     |  4 ++--
 tests/contrib/operators/test_jira_operator_test.py   |  4 ++--
 .../contrib/operators/test_mysql_to_gcs_operator.py  |  4 ++--
 tests/contrib/operators/test_pubsub_operator.py      |  4 ++--
 tests/contrib/operators/test_s3_list_operator.py     |  4 ++--
 tests/contrib/operators/test_s3_to_gcs_operator.py   |  4 ++--
 tests/contrib/operators/test_sftp_operator.py        |  4 ++--
 .../contrib/operators/test_slack_webhook_operator.py |  4 ++--
 tests/contrib/operators/test_snowflake_operator.py   |  4 ++--
 tests/contrib/operators/test_spark_jdbc_operator.py  |  4 ++--
 tests/contrib/operators/test_spark_sql_operator.py   |  4 ++--
 .../contrib/operators/test_spark_submit_operator.py  |  4 ++--
 tests/contrib/operators/test_sqoop_operator.py       |  4 ++--
 tests/contrib/sensors/__init__.py                    |  4 ++--
 .../sensors/test_aws_redshift_cluster_sensor.py      |  4 ++--
 tests/contrib/sensors/test_bash_sensor.py            |  4 ++--
 tests/contrib/sensors/test_datadog_sensor.py         |  4 ++--
 tests/contrib/sensors/test_emr_base_sensor.py        |  4 ++--
 tests/contrib/sensors/test_emr_job_flow_sensor.py    |  4 ++--
 tests/contrib/sensors/test_emr_step_sensor.py        |  4 ++--
 tests/contrib/sensors/test_file_sensor.py            |  4 ++--
 tests/contrib/sensors/test_ftp_sensor.py             |  4 ++--
 tests/contrib/sensors/test_hdfs_sensor.py            |  4 ++--
 tests/contrib/sensors/test_jira_sensor_test.py       |  4 ++--
 tests/contrib/sensors/test_pubsub_sensor.py          |  4 ++--
 tests/contrib/sensors/test_qubole_sensor.py          |  4 ++--
 tests/contrib/sensors/test_redis_sensor.py           |  4 ++--
 tests/contrib/sensors/test_sftp_sensor.py            |  4 ++--
 tests/contrib/sensors/test_wasb_sensor.py            |  4 ++--
 tests/contrib/utils/__init__.py                      |  4 ++--
 tests/dags/no_dags.py                                |  4 ++--
 tests/dags/test_backfill_pooled_tasks.py             |  4 ++--
 tests/dags/test_cli_triggered_dags.py                |  4 ++--
 tests/dags/test_default_impersonation.py             |  4 ++--
 tests/dags/test_double_trigger.py                    |  4 ++--
 tests/dags/test_impersonation.py                     |  4 ++--
 tests/dags/test_impersonation_custom.py              |  4 ++--
 tests/dags/test_impersonation_subdag.py              |  4 ++--
 tests/dags/test_issue_1225.py                        |  4 ++--
 tests/dags/test_latest_runs.py                       |  4 ++--
 tests/dags/test_mark_success.py                      |  4 ++--
 tests/dags/test_no_impersonation.py                  |  4 ++--
 tests/dags/test_on_kill.py                           |  4 ++--
 tests/dags/test_retry_handling_job.py                |  4 ++--
 tests/dags/test_scheduler_dags.py                    |  4 ++--
 tests/dags_with_system_exit/a_system_exit.py         |  4 ++--
 tests/dags_with_system_exit/b_test_scheduler_dags.py |  4 ++--
 tests/dags_with_system_exit/c_system_exit.py         |  4 ++--
 tests/executors/__init__.py                          |  4 ++--
 tests/executors/test_base_executor.py                |  4 ++--
 tests/executors/test_executor.py                     |  4 ++--
 tests/impersonation.py                               |  4 ++--
 tests/macros/__init__.py                             |  4 ++--
 tests/macros/test_hive.py                            |  4 ++--
 tests/operators/test_check_operator.py               |  4 ++--
 tests/operators/test_redshift_to_s3_operator.py      |  4 ++--
 tests/operators/test_s3_file_transform_operator.py   |  4 ++--
 tests/operators/test_s3_to_redshift_operator.py      |  4 ++--
 tests/operators/test_virtualenv_operator.py          |  4 ++--
 tests/plugins/test_plugin.py                         |  4 ++--
 tests/plugins_manager.py                             |  4 ++--
 tests/security/__init__.py                           |  4 ++--
 tests/security/kerberos.py                           |  4 ++--
 tests/sensors/__init__.py                            |  4 ++--
 tests/sensors/test_external_task_sensor.py           |  4 ++--
 tests/sensors/test_hdfs_sensor.py                    |  4 ++--
 tests/sensors/test_http_sensor.py                    |  4 ++--
 tests/sensors/test_sql_sensor.py                     |  4 ++--
 tests/sensors/test_timedelta_sensor.py               |  4 ++--
 tests/sensors/test_timeout_sensor.py                 |  4 ++--
 tests/test_utils/__init__.py                         |  4 ++--
 tests/test_utils/reset_warning_registry.py           |  4 ++--
 tests/ti_deps/__init__.py                            |  4 ++--
 tests/ti_deps/contexts/__init__.py                   |  4 ++--
 tests/ti_deps/deps/__init__.py                       |  4 ++--
 tests/ti_deps/deps/fake_models.py                    |  4 ++--
 .../ti_deps/deps/test_dag_ti_slots_available_dep.py  |  4 ++--
 tests/ti_deps/deps/test_dag_unpaused_dep.py          |  4 ++--
 tests/ti_deps/deps/test_dagrun_exists_dep.py         |  4 ++--
 tests/ti_deps/deps/test_not_in_retry_period_dep.py   |  4 ++--
 tests/ti_deps/deps/test_not_running_dep.py           |  4 ++--
 tests/ti_deps/deps/test_not_skipped_dep.py           |  4 ++--
 tests/ti_deps/deps/test_prev_dagrun_dep.py           |  4 ++--
 tests/ti_deps/deps/test_runnable_exec_date_dep.py    |  4 ++--
 tests/ti_deps/deps/test_task_concurrency.py          |  4 ++--
 tests/ti_deps/deps/test_trigger_rule_dep.py          |  4 ++--
 tests/ti_deps/deps/test_valid_state_dep.py           |  4 ++--
 tests/utils.py                                       |  4 ++--
 tests/utils/__init__.py                              |  4 ++--
 tests/utils/log/__init__.py                          |  4 ++--
 tests/utils/log/test_es_task_handler.py              |  4 ++--
 tests/utils/log/test_file_processor_handler.py       |  4 ++--
 tests/utils/test_cli_util.py                         |  4 ++--
 tests/utils/test_compression.py                      |  4 ++--
 tests/utils/test_dag_processing.py                   |  4 ++--
 tests/utils/test_dates.py                            |  4 ++--
 tests/utils/test_decorators.py                       |  4 ++--
 tests/utils/test_helpers.py                          |  4 ++--
 tests/utils/test_json.py                             |  4 ++--
 tests/utils/test_log_handlers.py                     |  4 ++--
 tests/utils/test_logging_mixin.py                    |  4 ++--
 tests/utils/test_module_loading.py                   |  4 ++--
 tests/utils/test_net.py                              |  4 ++--
 tests/utils/test_timezone.py                         |  4 ++--
 tests/utils/test_trigger_rule.py                     |  4 ++--
 tests/utils/test_weight_rule.py                      |  4 ++--
 tests/www/__init__.py                                |  4 ++--
 tests/www/api/__init__.py                            |  4 ++--
 tests/www/api/experimental/__init__.py               |  4 ++--
 tests/www/api/experimental/test_endpoints.py         |  4 ++--
 .../www/api/experimental/test_kerberos_endpoints.py  |  4 ++--
 tests/www/test_validators.py                         |  4 ++--
 148 files changed, 300 insertions(+), 300 deletions(-)

diff --git a/tests/cli/__init__.py b/tests/cli/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/cli/__init__.py
+++ b/tests/cli/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/configuration.py b/tests/configuration.py
index d898ac6d40d58..027a51d893657 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/__init__.py b/tests/contrib/__init__.py
index 50b2e1d1785dd..2b497dfb91cee 100644
--- a/tests/contrib/__init__.py
+++ b/tests/contrib/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/__init__.py b/tests/contrib/hooks/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/contrib/hooks/__init__.py
+++ b/tests/contrib/hooks/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_aws_dynamodb_hook.py b/tests/contrib/hooks/test_aws_dynamodb_hook.py
index eabd352190213..835c042b2dc62 100644
--- a/tests/contrib/hooks/test_aws_dynamodb_hook.py
+++ b/tests/contrib/hooks/test_aws_dynamodb_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_aws_hook.py b/tests/contrib/hooks/test_aws_hook.py
index 57814b43d9038..addee85109194 100644
--- a/tests/contrib/hooks/test_aws_hook.py
+++ b/tests/contrib/hooks/test_aws_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_aws_lambda_hook.py b/tests/contrib/hooks/test_aws_lambda_hook.py
index 0b9744cd22285..a0d48d068a3d3 100644
--- a/tests/contrib/hooks/test_aws_lambda_hook.py
+++ b/tests/contrib/hooks/test_aws_lambda_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_discord_webhook_hook.py b/tests/contrib/hooks/test_discord_webhook_hook.py
index c92b198fc20e1..c6b3eac00fd07 100644
--- a/tests/contrib/hooks/test_discord_webhook_hook.py
+++ b/tests/contrib/hooks/test_discord_webhook_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_emr_hook.py b/tests/contrib/hooks/test_emr_hook.py
index 64485ae973fe3..03f23f69062ca 100644
--- a/tests/contrib/hooks/test_emr_hook.py
+++ b/tests/contrib/hooks/test_emr_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_ftp_hook.py b/tests/contrib/hooks/test_ftp_hook.py
index e735217ad3609..1274990827096 100644
--- a/tests/contrib/hooks/test_ftp_hook.py
+++ b/tests/contrib/hooks/test_ftp_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -83,19 +83,19 @@ def test_rename(self):
 
         self.conn_mock.rename.assert_called_once_with(from_path, to_path)
         self.conn_mock.quit.assert_called_once_with()
-        
+
     def test_mod_time(self):
         self.conn_mock.sendcmd.return_value = '213 20170428010138'
-        
+
         path = '/path/file'
         with fh.FTPHook() as ftp_hook:
             ftp_hook.get_mod_time(path)
 
         self.conn_mock.sendcmd.assert_called_once_with('MDTM ' + path)
-        
+
     def test_mod_time_micro(self):
         self.conn_mock.sendcmd.return_value = '213 20170428010138.003'
-        
+
         path = '/path/file'
         with fh.FTPHook() as ftp_hook:
             ftp_hook.get_mod_time(path)
diff --git a/tests/contrib/hooks/test_gcp_pubsub_hook.py b/tests/contrib/hooks/test_gcp_pubsub_hook.py
index 98f1b1316392c..b1290fb3320c3 100644
--- a/tests/contrib/hooks/test_gcp_pubsub_hook.py
+++ b/tests/contrib/hooks/test_gcp_pubsub_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_jdbc_hook.py b/tests/contrib/hooks/test_jdbc_hook.py
index 30c7df4a91da6..3f708997d93e9 100644
--- a/tests/contrib/hooks/test_jdbc_hook.py
+++ b/tests/contrib/hooks/test_jdbc_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_jira_hook.py b/tests/contrib/hooks/test_jira_hook.py
index 6cddbd046fb03..378c379d5551c 100644
--- a/tests/contrib/hooks/test_jira_hook.py
+++ b/tests/contrib/hooks/test_jira_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_redis_hook.py b/tests/contrib/hooks/test_redis_hook.py
index ca8bdea3b3448..12c30680e1bfa 100644
--- a/tests/contrib/hooks/test_redis_hook.py
+++ b/tests/contrib/hooks/test_redis_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_redshift_hook.py b/tests/contrib/hooks/test_redshift_hook.py
index 029dfd38016c5..103411207071c 100644
--- a/tests/contrib/hooks/test_redshift_hook.py
+++ b/tests/contrib/hooks/test_redshift_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_sftp_hook.py b/tests/contrib/hooks/test_sftp_hook.py
index 7715161adb08a..ac4d78e9b1609 100644
--- a/tests/contrib/hooks/test_sftp_hook.py
+++ b/tests/contrib/hooks/test_sftp_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_slack_webhook_hook.py b/tests/contrib/hooks/test_slack_webhook_hook.py
index 3f657aa741e31..a26204f39ef39 100644
--- a/tests/contrib/hooks/test_slack_webhook_hook.py
+++ b/tests/contrib/hooks/test_slack_webhook_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_snowflake_hook.py b/tests/contrib/hooks/test_snowflake_hook.py
index aaaf57a00b8d8..a6bc375be60e6 100644
--- a/tests/contrib/hooks/test_snowflake_hook.py
+++ b/tests/contrib/hooks/test_snowflake_hook.py
@@ -8,9 +8,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_spark_jdbc_hook.py b/tests/contrib/hooks/test_spark_jdbc_hook.py
index 2451b4a157c60..a6202dcfb95ca 100644
--- a/tests/contrib/hooks/test_spark_jdbc_hook.py
+++ b/tests/contrib/hooks/test_spark_jdbc_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_sqoop_hook.py b/tests/contrib/hooks/test_sqoop_hook.py
index 5e7ac7a6275da..8bef5a4937b75 100644
--- a/tests/contrib/hooks/test_sqoop_hook.py
+++ b/tests/contrib/hooks/test_sqoop_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_wasb_hook.py b/tests/contrib/hooks/test_wasb_hook.py
index db2b69b4ed99b..88481440e71be 100644
--- a/tests/contrib/hooks/test_wasb_hook.py
+++ b/tests/contrib/hooks/test_wasb_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/hooks/test_zendesk_hook.py b/tests/contrib/hooks/test_zendesk_hook.py
index 799919b3a0d3b..99dd8926dc40b 100644
--- a/tests/contrib/hooks/test_zendesk_hook.py
+++ b/tests/contrib/hooks/test_zendesk_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/__init__.py b/tests/contrib/operators/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/tests/contrib/operators/__init__.py
+++ b/tests/contrib/operators/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_awsbatch_operator.py b/tests/contrib/operators/test_awsbatch_operator.py
index 782ee6deaced5..f081a274213ec 100644
--- a/tests/contrib/operators/test_awsbatch_operator.py
+++ b/tests/contrib/operators/test_awsbatch_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_discord_webhook_operator.py b/tests/contrib/operators/test_discord_webhook_operator.py
index 0fa5838351ef9..9816f0e223199 100644
--- a/tests/contrib/operators/test_discord_webhook_operator.py
+++ b/tests/contrib/operators/test_discord_webhook_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_druid_operator.py b/tests/contrib/operators/test_druid_operator.py
index d3e51dddba5e6..e7d502c9cf0af 100644
--- a/tests/contrib/operators/test_druid_operator.py
+++ b/tests/contrib/operators/test_druid_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index 232a02a26842a..a5914ae585d4c 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_emr_add_steps_operator.py b/tests/contrib/operators/test_emr_add_steps_operator.py
index 1315f93769c6b..5caa79cf36766 100644
--- a/tests/contrib/operators/test_emr_add_steps_operator.py
+++ b/tests/contrib/operators/test_emr_add_steps_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_emr_create_job_flow_operator.py b/tests/contrib/operators/test_emr_create_job_flow_operator.py
index 18b07b23b4a6f..fd95f78fd2d01 100644
--- a/tests/contrib/operators/test_emr_create_job_flow_operator.py
+++ b/tests/contrib/operators/test_emr_create_job_flow_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_emr_terminate_job_flow_operator.py b/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
index 4c905719fe9b8..d25b02adb5bd9 100644
--- a/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
+++ b/tests/contrib/operators/test_emr_terminate_job_flow_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_file_to_wasb.py b/tests/contrib/operators/test_file_to_wasb.py
index f508be1574d26..46630cb475c1b 100644
--- a/tests/contrib/operators/test_file_to_wasb.py
+++ b/tests/contrib/operators/test_file_to_wasb.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_gcs_download_operator.py b/tests/contrib/operators/test_gcs_download_operator.py
index 13b08a4bd7e00..4e9914e8fd446 100644
--- a/tests/contrib/operators/test_gcs_download_operator.py
+++ b/tests/contrib/operators/test_gcs_download_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_gcs_list_operator.py b/tests/contrib/operators/test_gcs_list_operator.py
index 84612eaaf3a04..8f0281f76fb64 100644
--- a/tests/contrib/operators/test_gcs_list_operator.py
+++ b/tests/contrib/operators/test_gcs_list_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_gcs_to_s3_operator.py b/tests/contrib/operators/test_gcs_to_s3_operator.py
index 5f386a62fe812..1a35a223ab8aa 100644
--- a/tests/contrib/operators/test_gcs_to_s3_operator.py
+++ b/tests/contrib/operators/test_gcs_to_s3_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_hipchat_operator.py b/tests/contrib/operators/test_hipchat_operator.py
index 10d39c56ba331..dbfb227d1d4b5 100644
--- a/tests/contrib/operators/test_hipchat_operator.py
+++ b/tests/contrib/operators/test_hipchat_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_hive_to_dynamodb_operator.py b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
index 91736ca521ebd..ab86e055176fd 100644
--- a/tests/contrib/operators/test_hive_to_dynamodb_operator.py
+++ b/tests/contrib/operators/test_hive_to_dynamodb_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_jenkins_operator.py b/tests/contrib/operators/test_jenkins_operator.py
index 0d70246fff85d..23e0bcb66fd97 100644
--- a/tests/contrib/operators/test_jenkins_operator.py
+++ b/tests/contrib/operators/test_jenkins_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_jira_operator_test.py b/tests/contrib/operators/test_jira_operator_test.py
index 2324f68d5abad..2509038a36c53 100644
--- a/tests/contrib/operators/test_jira_operator_test.py
+++ b/tests/contrib/operators/test_jira_operator_test.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_mysql_to_gcs_operator.py b/tests/contrib/operators/test_mysql_to_gcs_operator.py
index f0eb709500ca0..e33d270032765 100644
--- a/tests/contrib/operators/test_mysql_to_gcs_operator.py
+++ b/tests/contrib/operators/test_mysql_to_gcs_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_pubsub_operator.py b/tests/contrib/operators/test_pubsub_operator.py
index 8f775da43a8be..26424b46881d6 100644
--- a/tests/contrib/operators/test_pubsub_operator.py
+++ b/tests/contrib/operators/test_pubsub_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_s3_list_operator.py b/tests/contrib/operators/test_s3_list_operator.py
index de95c7623b18a..df897b5700286 100644
--- a/tests/contrib/operators/test_s3_list_operator.py
+++ b/tests/contrib/operators/test_s3_list_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_s3_to_gcs_operator.py b/tests/contrib/operators/test_s3_to_gcs_operator.py
index 97d6eae916d28..3534bb1c2b517 100644
--- a/tests/contrib/operators/test_s3_to_gcs_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_sftp_operator.py b/tests/contrib/operators/test_sftp_operator.py
index 1f1a1c01ae1ac..66d793991de7a 100644
--- a/tests/contrib/operators/test_sftp_operator.py
+++ b/tests/contrib/operators/test_sftp_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_slack_webhook_operator.py b/tests/contrib/operators/test_slack_webhook_operator.py
index 544b790eecda0..6345ad0ef9924 100644
--- a/tests/contrib/operators/test_slack_webhook_operator.py
+++ b/tests/contrib/operators/test_slack_webhook_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_snowflake_operator.py b/tests/contrib/operators/test_snowflake_operator.py
index 669bd65563021..f5da6f6c43ae8 100644
--- a/tests/contrib/operators/test_snowflake_operator.py
+++ b/tests/contrib/operators/test_snowflake_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_spark_jdbc_operator.py b/tests/contrib/operators/test_spark_jdbc_operator.py
index 9f2cd23f8f247..652c2bc6306bb 100644
--- a/tests/contrib/operators/test_spark_jdbc_operator.py
+++ b/tests/contrib/operators/test_spark_jdbc_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_spark_sql_operator.py b/tests/contrib/operators/test_spark_sql_operator.py
index 19d58a977708a..bbe6868dc71f9 100644
--- a/tests/contrib/operators/test_spark_sql_operator.py
+++ b/tests/contrib/operators/test_spark_sql_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_spark_submit_operator.py b/tests/contrib/operators/test_spark_submit_operator.py
index 0a528d9b1904c..38018d9d8cc3d 100644
--- a/tests/contrib/operators/test_spark_submit_operator.py
+++ b/tests/contrib/operators/test_spark_submit_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/operators/test_sqoop_operator.py b/tests/contrib/operators/test_sqoop_operator.py
index 4586aebdde5ca..e3cf32fdae45c 100644
--- a/tests/contrib/operators/test_sqoop_operator.py
+++ b/tests/contrib/operators/test_sqoop_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/__init__.py b/tests/contrib/sensors/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/contrib/sensors/__init__.py
+++ b/tests/contrib/sensors/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
index 95064c2655ac0..6753cefa428a3 100644
--- a/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
+++ b/tests/contrib/sensors/test_aws_redshift_cluster_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_bash_sensor.py b/tests/contrib/sensors/test_bash_sensor.py
index 346be5180eaa9..e678425997790 100644
--- a/tests/contrib/sensors/test_bash_sensor.py
+++ b/tests/contrib/sensors/test_bash_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_datadog_sensor.py b/tests/contrib/sensors/test_datadog_sensor.py
index 2f93bb1d4500e..75fca65033766 100644
--- a/tests/contrib/sensors/test_datadog_sensor.py
+++ b/tests/contrib/sensors/test_datadog_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_emr_base_sensor.py b/tests/contrib/sensors/test_emr_base_sensor.py
index 2215edd09e0f6..6dd6fc2b87917 100644
--- a/tests/contrib/sensors/test_emr_base_sensor.py
+++ b/tests/contrib/sensors/test_emr_base_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_emr_job_flow_sensor.py b/tests/contrib/sensors/test_emr_job_flow_sensor.py
index b50b270a85a3a..5b33cb5bb418d 100644
--- a/tests/contrib/sensors/test_emr_job_flow_sensor.py
+++ b/tests/contrib/sensors/test_emr_job_flow_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_emr_step_sensor.py b/tests/contrib/sensors/test_emr_step_sensor.py
index ad0b2469e861b..08cb8d1aeac52 100644
--- a/tests/contrib/sensors/test_emr_step_sensor.py
+++ b/tests/contrib/sensors/test_emr_step_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_file_sensor.py b/tests/contrib/sensors/test_file_sensor.py
index d78400e317fcd..0f17e2de5ae0e 100644
--- a/tests/contrib/sensors/test_file_sensor.py
+++ b/tests/contrib/sensors/test_file_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_ftp_sensor.py b/tests/contrib/sensors/test_ftp_sensor.py
index cf0fdb4918503..a20618fe9923b 100644
--- a/tests/contrib/sensors/test_ftp_sensor.py
+++ b/tests/contrib/sensors/test_ftp_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_hdfs_sensor.py b/tests/contrib/sensors/test_hdfs_sensor.py
index 26ce5570a0e44..f72d9834477d0 100644
--- a/tests/contrib/sensors/test_hdfs_sensor.py
+++ b/tests/contrib/sensors/test_hdfs_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_jira_sensor_test.py b/tests/contrib/sensors/test_jira_sensor_test.py
index 4b3f591e622e8..32aa235851a6d 100644
--- a/tests/contrib/sensors/test_jira_sensor_test.py
+++ b/tests/contrib/sensors/test_jira_sensor_test.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_pubsub_sensor.py b/tests/contrib/sensors/test_pubsub_sensor.py
index f1f8fade62c7b..1973b0453ab76 100644
--- a/tests/contrib/sensors/test_pubsub_sensor.py
+++ b/tests/contrib/sensors/test_pubsub_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_qubole_sensor.py b/tests/contrib/sensors/test_qubole_sensor.py
index 1f28c3ddcd87c..9a0365d021570 100644
--- a/tests/contrib/sensors/test_qubole_sensor.py
+++ b/tests/contrib/sensors/test_qubole_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_redis_sensor.py b/tests/contrib/sensors/test_redis_sensor.py
index b931b49e9bd0c..394c8e574bd4f 100644
--- a/tests/contrib/sensors/test_redis_sensor.py
+++ b/tests/contrib/sensors/test_redis_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_sftp_sensor.py b/tests/contrib/sensors/test_sftp_sensor.py
index 1c13f3fb879ae..0fb9d6c610ca9 100644
--- a/tests/contrib/sensors/test_sftp_sensor.py
+++ b/tests/contrib/sensors/test_sftp_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/sensors/test_wasb_sensor.py b/tests/contrib/sensors/test_wasb_sensor.py
index f715b0166e705..d122e4c454403 100644
--- a/tests/contrib/sensors/test_wasb_sensor.py
+++ b/tests/contrib/sensors/test_wasb_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/contrib/utils/__init__.py b/tests/contrib/utils/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/tests/contrib/utils/__init__.py
+++ b/tests/contrib/utils/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/no_dags.py b/tests/dags/no_dags.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/tests/dags/no_dags.py
+++ b/tests/dags/no_dags.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_backfill_pooled_tasks.py b/tests/dags/test_backfill_pooled_tasks.py
index 4b4f2a8661e14..8320f51c86e76 100644
--- a/tests/dags/test_backfill_pooled_tasks.py
+++ b/tests/dags/test_backfill_pooled_tasks.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_cli_triggered_dags.py b/tests/dags/test_cli_triggered_dags.py
index 611e24babbdea..9f53ca4c3ab0b 100644
--- a/tests/dags/test_cli_triggered_dags.py
+++ b/tests/dags/test_cli_triggered_dags.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_default_impersonation.py b/tests/dags/test_default_impersonation.py
index 42b7198bd6ca1..537fee9a7cb93 100644
--- a/tests/dags/test_default_impersonation.py
+++ b/tests/dags/test_default_impersonation.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_double_trigger.py b/tests/dags/test_double_trigger.py
index eea0aa1ddc69f..a53d7638dfefc 100644
--- a/tests/dags/test_double_trigger.py
+++ b/tests/dags/test_double_trigger.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_impersonation.py b/tests/dags/test_impersonation.py
index 4e554e146d7c6..bc327d2953844 100644
--- a/tests/dags/test_impersonation.py
+++ b/tests/dags/test_impersonation.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_impersonation_custom.py b/tests/dags/test_impersonation_custom.py
index 43a52355c4095..1157812abca02 100644
--- a/tests/dags/test_impersonation_custom.py
+++ b/tests/dags/test_impersonation_custom.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_impersonation_subdag.py b/tests/dags/test_impersonation_subdag.py
index 423c55266485b..01275c67c0264 100644
--- a/tests/dags/test_impersonation_subdag.py
+++ b/tests/dags/test_impersonation_subdag.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_issue_1225.py b/tests/dags/test_issue_1225.py
index 00d8a534d050e..0450cf470f7b4 100644
--- a/tests/dags/test_issue_1225.py
+++ b/tests/dags/test_issue_1225.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_latest_runs.py b/tests/dags/test_latest_runs.py
index a39a6bd948e25..e8cd99adc907e 100644
--- a/tests/dags/test_latest_runs.py
+++ b/tests/dags/test_latest_runs.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_mark_success.py b/tests/dags/test_mark_success.py
index 50ba32d2e3d73..dfbcbc1b5d16b 100644
--- a/tests/dags/test_mark_success.py
+++ b/tests/dags/test_mark_success.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_no_impersonation.py b/tests/dags/test_no_impersonation.py
index cb5bb66a6124c..26cb935d8679e 100644
--- a/tests/dags/test_no_impersonation.py
+++ b/tests/dags/test_no_impersonation.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_on_kill.py b/tests/dags/test_on_kill.py
index 353b4573921c3..d9307f150843b 100644
--- a/tests/dags/test_on_kill.py
+++ b/tests/dags/test_on_kill.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_retry_handling_job.py b/tests/dags/test_retry_handling_job.py
index a1112b9684e9e..d8e314dbabde5 100644
--- a/tests/dags/test_retry_handling_job.py
+++ b/tests/dags/test_retry_handling_job.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags/test_scheduler_dags.py b/tests/dags/test_scheduler_dags.py
index 4febbb1f55dcc..94e6f8216d226 100644
--- a/tests/dags/test_scheduler_dags.py
+++ b/tests/dags/test_scheduler_dags.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags_with_system_exit/a_system_exit.py b/tests/dags_with_system_exit/a_system_exit.py
index 42d96a3d1c9be..8d51ddcbb833e 100644
--- a/tests/dags_with_system_exit/a_system_exit.py
+++ b/tests/dags_with_system_exit/a_system_exit.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags_with_system_exit/b_test_scheduler_dags.py b/tests/dags_with_system_exit/b_test_scheduler_dags.py
index 2d925cd79e172..bde36ba5dfecf 100644
--- a/tests/dags_with_system_exit/b_test_scheduler_dags.py
+++ b/tests/dags_with_system_exit/b_test_scheduler_dags.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/dags_with_system_exit/c_system_exit.py b/tests/dags_with_system_exit/c_system_exit.py
index 2581dfecebeea..bebaa3e8f3945 100644
--- a/tests/dags_with_system_exit/c_system_exit.py
+++ b/tests/dags_with_system_exit/c_system_exit.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/__init__.py b/tests/executors/__init__.py
index 4e16cd0a8e1f1..1ef5efdd4e74e 100644
--- a/tests/executors/__init__.py
+++ b/tests/executors/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/test_base_executor.py b/tests/executors/test_base_executor.py
index 939b9f285563c..ae7c76fabd8ab 100644
--- a/tests/executors/test_base_executor.py
+++ b/tests/executors/test_base_executor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/test_executor.py b/tests/executors/test_executor.py
index 1f373edc1be71..aab66644b8a76 100644
--- a/tests/executors/test_executor.py
+++ b/tests/executors/test_executor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/impersonation.py b/tests/impersonation.py
index f789fcb95f463..8ded423e356a0 100644
--- a/tests/impersonation.py
+++ b/tests/impersonation.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/macros/__init__.py b/tests/macros/__init__.py
index db5ba598d7c23..b7f8352944d3f 100644
--- a/tests/macros/__init__.py
+++ b/tests/macros/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/macros/test_hive.py b/tests/macros/test_hive.py
index eaa5050f0ddab..758a73b44ea04 100644
--- a/tests/macros/test_hive.py
+++ b/tests/macros/test_hive.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/test_check_operator.py b/tests/operators/test_check_operator.py
index 46a48e42d233b..d3b546058431c 100644
--- a/tests/operators/test_check_operator.py
+++ b/tests/operators/test_check_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/test_redshift_to_s3_operator.py b/tests/operators/test_redshift_to_s3_operator.py
index 379e78744e6cf..314b74a8042d2 100644
--- a/tests/operators/test_redshift_to_s3_operator.py
+++ b/tests/operators/test_redshift_to_s3_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/test_s3_file_transform_operator.py b/tests/operators/test_s3_file_transform_operator.py
index af00a4bcf5f75..da7a4b0bed91f 100644
--- a/tests/operators/test_s3_file_transform_operator.py
+++ b/tests/operators/test_s3_file_transform_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/test_s3_to_redshift_operator.py b/tests/operators/test_s3_to_redshift_operator.py
index 2afde6c95d7f3..95e0f1d823935 100644
--- a/tests/operators/test_s3_to_redshift_operator.py
+++ b/tests/operators/test_s3_to_redshift_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/test_virtualenv_operator.py b/tests/operators/test_virtualenv_operator.py
index 8196d636f4c1f..ce7068b8a8567 100644
--- a/tests/operators/test_virtualenv_operator.py
+++ b/tests/operators/test_virtualenv_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index c9afa0209a6a2..058a2bb227467 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/plugins_manager.py b/tests/plugins_manager.py
index 6bd9d61085dfb..850695757426c 100644
--- a/tests/plugins_manager.py
+++ b/tests/plugins_manager.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/security/__init__.py b/tests/security/__init__.py
index 7aa5f6adfa814..880e77221365b 100644
--- a/tests/security/__init__.py
+++ b/tests/security/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/security/kerberos.py b/tests/security/kerberos.py
index 98c06951cfdbb..c495dd08c4d3d 100644
--- a/tests/security/kerberos.py
+++ b/tests/security/kerberos.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/__init__.py b/tests/sensors/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/sensors/__init__.py
+++ b/tests/sensors/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_external_task_sensor.py b/tests/sensors/test_external_task_sensor.py
index 403c892c239b2..feb0cdcd40a3b 100644
--- a/tests/sensors/test_external_task_sensor.py
+++ b/tests/sensors/test_external_task_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_hdfs_sensor.py b/tests/sensors/test_hdfs_sensor.py
index b94065d8423ef..26adeaa3ab60b 100644
--- a/tests/sensors/test_hdfs_sensor.py
+++ b/tests/sensors/test_hdfs_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_http_sensor.py b/tests/sensors/test_http_sensor.py
index ffea7cadfe828..cfa135e2047c9 100644
--- a/tests/sensors/test_http_sensor.py
+++ b/tests/sensors/test_http_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_sql_sensor.py b/tests/sensors/test_sql_sensor.py
index e8564623051be..de990bfd10339 100644
--- a/tests/sensors/test_sql_sensor.py
+++ b/tests/sensors/test_sql_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_timedelta_sensor.py b/tests/sensors/test_timedelta_sensor.py
index 18ee07bfa8823..6951746532f6f 100644
--- a/tests/sensors/test_timedelta_sensor.py
+++ b/tests/sensors/test_timedelta_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/sensors/test_timeout_sensor.py b/tests/sensors/test_timeout_sensor.py
index 7a4e70b71cfdb..91fc2d57a619e 100644
--- a/tests/sensors/test_timeout_sensor.py
+++ b/tests/sensors/test_timeout_sensor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/test_utils/__init__.py b/tests/test_utils/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/test_utils/__init__.py
+++ b/tests/test_utils/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/test_utils/reset_warning_registry.py b/tests/test_utils/reset_warning_registry.py
index 3ca78eda67cb4..65f08a2300468 100644
--- a/tests/test_utils/reset_warning_registry.py
+++ b/tests/test_utils/reset_warning_registry.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/__init__.py b/tests/ti_deps/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/ti_deps/__init__.py
+++ b/tests/ti_deps/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/contexts/__init__.py b/tests/ti_deps/contexts/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/ti_deps/contexts/__init__.py
+++ b/tests/ti_deps/contexts/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/__init__.py b/tests/ti_deps/deps/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/ti_deps/deps/__init__.py
+++ b/tests/ti_deps/deps/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/fake_models.py b/tests/ti_deps/deps/fake_models.py
index da4731710b0b0..7896f205ff74d 100644
--- a/tests/ti_deps/deps/fake_models.py
+++ b/tests/ti_deps/deps/fake_models.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_dag_ti_slots_available_dep.py b/tests/ti_deps/deps/test_dag_ti_slots_available_dep.py
index 0ea1503a21afa..cfac5d3051835 100644
--- a/tests/ti_deps/deps/test_dag_ti_slots_available_dep.py
+++ b/tests/ti_deps/deps/test_dag_ti_slots_available_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_dag_unpaused_dep.py b/tests/ti_deps/deps/test_dag_unpaused_dep.py
index c1f4148d29cd2..8a6df5c1bf319 100644
--- a/tests/ti_deps/deps/test_dag_unpaused_dep.py
+++ b/tests/ti_deps/deps/test_dag_unpaused_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_dagrun_exists_dep.py b/tests/ti_deps/deps/test_dagrun_exists_dep.py
index 62aff97cdce89..85d649aaba15d 100644
--- a/tests/ti_deps/deps/test_dagrun_exists_dep.py
+++ b/tests/ti_deps/deps/test_dagrun_exists_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_not_in_retry_period_dep.py b/tests/ti_deps/deps/test_not_in_retry_period_dep.py
index afd9e01a8ff40..ca0726dc0c388 100644
--- a/tests/ti_deps/deps/test_not_in_retry_period_dep.py
+++ b/tests/ti_deps/deps/test_not_in_retry_period_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_not_running_dep.py b/tests/ti_deps/deps/test_not_running_dep.py
index 37696186b7288..1bc4261bb86bc 100644
--- a/tests/ti_deps/deps/test_not_running_dep.py
+++ b/tests/ti_deps/deps/test_not_running_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_not_skipped_dep.py b/tests/ti_deps/deps/test_not_skipped_dep.py
index 07d0bffdc2acb..6e1d832940a19 100644
--- a/tests/ti_deps/deps/test_not_skipped_dep.py
+++ b/tests/ti_deps/deps/test_not_skipped_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_prev_dagrun_dep.py b/tests/ti_deps/deps/test_prev_dagrun_dep.py
index a51dcd091b0e9..e5d8cdf2b15fb 100644
--- a/tests/ti_deps/deps/test_prev_dagrun_dep.py
+++ b/tests/ti_deps/deps/test_prev_dagrun_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_runnable_exec_date_dep.py b/tests/ti_deps/deps/test_runnable_exec_date_dep.py
index c555921782e89..16057c8108b27 100644
--- a/tests/ti_deps/deps/test_runnable_exec_date_dep.py
+++ b/tests/ti_deps/deps/test_runnable_exec_date_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_task_concurrency.py b/tests/ti_deps/deps/test_task_concurrency.py
index 426b9838de5b9..4272d3f01cdb3 100644
--- a/tests/ti_deps/deps/test_task_concurrency.py
+++ b/tests/ti_deps/deps/test_task_concurrency.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_trigger_rule_dep.py b/tests/ti_deps/deps/test_trigger_rule_dep.py
index f4a96f5bd0658..14dc01756c0fa 100644
--- a/tests/ti_deps/deps/test_trigger_rule_dep.py
+++ b/tests/ti_deps/deps/test_trigger_rule_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/ti_deps/deps/test_valid_state_dep.py b/tests/ti_deps/deps/test_valid_state_dep.py
index 19b18935dbd06..188b074db6526 100644
--- a/tests/ti_deps/deps/test_valid_state_dep.py
+++ b/tests/ti_deps/deps/test_valid_state_dep.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils.py b/tests/utils.py
index fadb139dd1046..f670e4118368e 100644
--- a/tests/utils.py
+++ b/tests/utils.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/__init__.py b/tests/utils/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/utils/__init__.py
+++ b/tests/utils/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/log/__init__.py b/tests/utils/log/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/utils/log/__init__.py
+++ b/tests/utils/log/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/log/test_es_task_handler.py b/tests/utils/log/test_es_task_handler.py
index 787094ef53860..94184fc82685d 100644
--- a/tests/utils/log/test_es_task_handler.py
+++ b/tests/utils/log/test_es_task_handler.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/log/test_file_processor_handler.py b/tests/utils/log/test_file_processor_handler.py
index 23cf1d4daae0e..42b1a1e27040f 100644
--- a/tests/utils/log/test_file_processor_handler.py
+++ b/tests/utils/log/test_file_processor_handler.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_cli_util.py b/tests/utils/test_cli_util.py
index 00dc9f959f1bc..ec159abd68470 100644
--- a/tests/utils/test_cli_util.py
+++ b/tests/utils/test_cli_util.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_compression.py b/tests/utils/test_compression.py
index a0886880bf877..5a367094f4d27 100644
--- a/tests/utils/test_compression.py
+++ b/tests/utils/test_compression.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_dag_processing.py b/tests/utils/test_dag_processing.py
index d2307647ac14f..9c85b66c578ad 100644
--- a/tests/utils/test_dag_processing.py
+++ b/tests/utils/test_dag_processing.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_dates.py b/tests/utils/test_dates.py
index d44f55171c9d7..85613d079139d 100644
--- a/tests/utils/test_dates.py
+++ b/tests/utils/test_dates.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_decorators.py b/tests/utils/test_decorators.py
index f9b48148bb354..3a196dd8a1eb0 100644
--- a/tests/utils/test_decorators.py
+++ b/tests/utils/test_decorators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index 1005671e9e84e..d5559ad79cf32 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_json.py b/tests/utils/test_json.py
index 91f53099dff3e..8e95716ee867b 100644
--- a/tests/utils/test_json.py
+++ b/tests/utils/test_json.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_log_handlers.py b/tests/utils/test_log_handlers.py
index 8acc5a252967a..72a5793f7e77b 100644
--- a/tests/utils/test_log_handlers.py
+++ b/tests/utils/test_log_handlers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_logging_mixin.py b/tests/utils/test_logging_mixin.py
index d23da5c90cb15..fa8c589a9e9fe 100644
--- a/tests/utils/test_logging_mixin.py
+++ b/tests/utils/test_logging_mixin.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_module_loading.py b/tests/utils/test_module_loading.py
index 6c257df1bbcb4..ba1ebcade6a3b 100644
--- a/tests/utils/test_module_loading.py
+++ b/tests/utils/test_module_loading.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_net.py b/tests/utils/test_net.py
index f97f6c0821000..86540983be305 100644
--- a/tests/utils/test_net.py
+++ b/tests/utils/test_net.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_timezone.py b/tests/utils/test_timezone.py
index 861b6d071ed73..07e0befcb81a6 100644
--- a/tests/utils/test_timezone.py
+++ b/tests/utils/test_timezone.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_trigger_rule.py b/tests/utils/test_trigger_rule.py
index be2a9f432b825..f068542849d35 100644
--- a/tests/utils/test_trigger_rule.py
+++ b/tests/utils/test_trigger_rule.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/utils/test_weight_rule.py b/tests/utils/test_weight_rule.py
index 27576e2e077aa..c862263387cc3 100644
--- a/tests/utils/test_weight_rule.py
+++ b/tests/utils/test_weight_rule.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/__init__.py b/tests/www/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www/__init__.py
+++ b/tests/www/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/api/__init__.py b/tests/www/api/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www/api/__init__.py
+++ b/tests/www/api/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/api/experimental/__init__.py b/tests/www/api/experimental/__init__.py
index 4067cc78ee9a2..114d189da14ab 100644
--- a/tests/www/api/experimental/__init__.py
+++ b/tests/www/api/experimental/__init__.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/api/experimental/test_endpoints.py b/tests/www/api/experimental/test_endpoints.py
index a93a19bc8947d..187ca921d59d8 100644
--- a/tests/www/api/experimental/test_endpoints.py
+++ b/tests/www/api/experimental/test_endpoints.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/api/experimental/test_kerberos_endpoints.py b/tests/www/api/experimental/test_kerberos_endpoints.py
index d5058709bcc4d..40394cec06b55 100644
--- a/tests/www/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www/api/experimental/test_kerberos_endpoints.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/www/test_validators.py b/tests/www/test_validators.py
index 7ad5b17d55e7f..e6242632f2cd1 100644
--- a/tests/www/test_validators.py
+++ b/tests/www/test_validators.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY

From 5b2acc321215cf5182bafffd025682609411a8e0 Mon Sep 17 00:00:00 2001
From: johnhofman <johncarlhofman@gmail.com>
Date: Fri, 28 Sep 2018 12:04:29 +0200
Subject: [PATCH 368/808] [AIRFLOW-XXX] Fix PythonVirtualenvOperator tests
 (#3968)

The recent update to the CI image changed the default
python from python2 to python3. The PythonVirtualenvOperator
tests expected python2 as default and fail due to
serialisation errors.
---
 scripts/ci/run-ci.sh                        | 2 +-
 tests/operators/test_virtualenv_operator.py | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/scripts/ci/run-ci.sh b/scripts/ci/run-ci.sh
index 8bee25859f38d..4be51167bb0b0 100755
--- a/scripts/ci/run-ci.sh
+++ b/scripts/ci/run-ci.sh
@@ -32,7 +32,7 @@ fi
 if [[ $PYTHON_VERSION == '3' ]]; then
   PIP=pip3
 else
-  PIP=pip
+  PIP=pip2
 fi
 
 sudo $PIP install --upgrade pip
diff --git a/tests/operators/test_virtualenv_operator.py b/tests/operators/test_virtualenv_operator.py
index ce7068b8a8567..ab53439c509b0 100644
--- a/tests/operators/test_virtualenv_operator.py
+++ b/tests/operators/test_virtualenv_operator.py
@@ -55,9 +55,10 @@ def setUp(self):
             schedule_interval=INTERVAL)
         self.addCleanup(self.dag.clear)
 
-    def _run_as_operator(self, fn, **kwargs):
+    def _run_as_operator(self, fn, python_version=sys.version_info[0], **kwargs):
         task = PythonVirtualenvOperator(
             python_callable=fn,
+            python_version=python_version,
             task_id='task',
             dag=self.dag,
             **kwargs)

From 5f8f305d17a6322817019b756b581150c436b1db Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokkodriesprong@godatadriven.com>
Date: Fri, 21 Sep 2018 16:36:28 +0200
Subject: [PATCH 369/808] [AIRFLOW-2918] Remove unused imports

---
 airflow/utils/helpers.py                      |  3 -
 .../www_rbac/api/experimental/endpoints.py    |  1 +
 scripts/perf/dags/perf_dag_1.py               |  4 +-
 scripts/perf/dags/perf_dag_2.py               |  4 +-
 scripts/perf/scheduler_ops_metrics.py         |  7 +-
 tests/contrib/__init__.py                     |  4 -
 tests/contrib/hooks/test_aws_lambda_hook.py   |  1 -
 tests/contrib/hooks/test_gcp_dataflow_hook.py |  1 -
 tests/contrib/hooks/test_spark_sql_hook.py    |  2 -
 .../operators/test_databricks_operator.py     |  1 -
 .../test_postgres_to_gcs_operator.py          |  1 -
 tests/core.py                                 |  6 +-
 tests/executors/__init__.py                   |  2 -
 tests/macros/test_hive.py                     |  2 +-
 tests/models.py                               | 88 ++++++++++++-------
 tests/operators/operators.py                  |  1 -
 tests/operators/test_virtualenv_operator.py   | 31 ++++---
 tests/plugins_manager.py                      |  3 -
 tests/security/__init__.py                    |  2 -
 tests/ti_deps/deps/test_task_concurrency.py   |  1 -
 .../experimental/test_kerberos_endpoints.py   |  1 -
 .../experimental/test_password_endpoints.py   |  3 -
 tests/www/test_views.py                       |  2 +-
 23 files changed, 89 insertions(+), 82 deletions(-)

diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 2a343ca0b5d96..ff513561df314 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -30,12 +30,9 @@
 from past.builtins import basestring
 from datetime import datetime
 from functools import reduce
-import imp
 import os
 import re
 import signal
-import sys
-import warnings
 
 from jinja2 import Template
 
diff --git a/airflow/www_rbac/api/experimental/endpoints.py b/airflow/www_rbac/api/experimental/endpoints.py
index 8663bad55d631..21aa7e8a1a60b 100644
--- a/airflow/www_rbac/api/experimental/endpoints.py
+++ b/airflow/www_rbac/api/experimental/endpoints.py
@@ -237,6 +237,7 @@ def dag_run_status(dag_id, execution_date):
 
     return jsonify(info)
 
+
 @api_experimental.route('/latest_runs', methods=['GET'])
 @requires_authentication
 def latest_dag_runs():
diff --git a/scripts/perf/dags/perf_dag_1.py b/scripts/perf/dags/perf_dag_1.py
index ea9714112e3ca..46b3d3e5a2f8d 100644
--- a/scripts/perf/dags/perf_dag_1.py
+++ b/scripts/perf/dags/perf_dag_1.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/perf/dags/perf_dag_2.py b/scripts/perf/dags/perf_dag_2.py
index 2289ebb5eda7b..a6916e664c40f 100644
--- a/scripts/perf/dags/perf_dag_2.py
+++ b/scripts/perf/dags/perf_dag_2.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/scripts/perf/scheduler_ops_metrics.py b/scripts/perf/scheduler_ops_metrics.py
index def829e7cdc3f..aabb2ff50e2ef 100644
--- a/scripts/perf/scheduler_ops_metrics.py
+++ b/scripts/perf/scheduler_ops_metrics.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -126,8 +126,7 @@ def heartbeat(self):
             if len(successful_tis) == num_task_instances:
                 self.log.info("All tasks processed! Printing stats.")
             else:
-                self.log.info("Test timeout reached. "
-                                 "Printing available stats.")
+                self.log.info("Test timeout reached. Printing available stats.")
             self.print_stats()
             set_dags_paused_state(True)
             sys.exit()
diff --git a/tests/contrib/__init__.py b/tests/contrib/__init__.py
index 2b497dfb91cee..114d189da14ab 100644
--- a/tests/contrib/__init__.py
+++ b/tests/contrib/__init__.py
@@ -16,7 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
-from __future__ import absolute_import
-from .operators import *
-from .sensors import *
diff --git a/tests/contrib/hooks/test_aws_lambda_hook.py b/tests/contrib/hooks/test_aws_lambda_hook.py
index a0d48d068a3d3..e71bac5518ebf 100644
--- a/tests/contrib/hooks/test_aws_lambda_hook.py
+++ b/tests/contrib/hooks/test_aws_lambda_hook.py
@@ -23,7 +23,6 @@
 import json
 import textwrap
 import zipfile
-import base64
 
 from airflow.contrib.hooks.aws_lambda_hook import AwsLambdaHook
 
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 7811e4aabd59f..3075e8b054a81 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -19,7 +19,6 @@
 #
 
 import unittest
-from mock import call
 from mock import MagicMock
 
 from airflow.contrib.hooks.gcp_dataflow_hook import DataFlowHook,\
diff --git a/tests/contrib/hooks/test_spark_sql_hook.py b/tests/contrib/hooks/test_spark_sql_hook.py
index 8a6d410ae4177..f76768efcd947 100644
--- a/tests/contrib/hooks/test_spark_sql_hook.py
+++ b/tests/contrib/hooks/test_spark_sql_hook.py
@@ -19,9 +19,7 @@
 #
 
 import six
-import sys
 import unittest
-from io import StringIO
 from itertools import dropwhile
 
 from mock import patch, call
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index d3bbc73d7eeb3..af62a3e4c3406 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -18,7 +18,6 @@
 # under the License.
 #
 
-import jinja2
 import unittest
 from datetime import datetime
 
diff --git a/tests/contrib/operators/test_postgres_to_gcs_operator.py b/tests/contrib/operators/test_postgres_to_gcs_operator.py
index ca72016974c0e..aaf2b9715c826 100644
--- a/tests/contrib/operators/test_postgres_to_gcs_operator.py
+++ b/tests/contrib/operators/test_postgres_to_gcs_operator.py
@@ -22,7 +22,6 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-import sys
 import unittest
 
 from airflow.contrib.operators.postgres_to_gcs_operator import PostgresToGoogleCloudStorageOperator
diff --git a/tests/core.py b/tests/core.py
index 9ce3b3f40bcef..a591f05139afa 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -397,7 +397,7 @@ def test_illegal_args(self):
         Tests that Operators reject illegal arguments
         """
         with warnings.catch_warnings(record=True) as w:
-            t = BashOperator(
+            BashOperator(
                 task_id='test_illegal_args',
                 bash_command='echo success',
                 dag=self.dag,
@@ -930,7 +930,7 @@ def test_dag_stats(self):
 
         models.DagStat.update([], session=session)
 
-        run1 = self.dag_bash.create_dagrun(
+        self.dag_bash.create_dagrun(
             run_id="run1",
             execution_date=DEFAULT_DATE,
             state=State.RUNNING)
@@ -948,7 +948,7 @@ def test_dag_stats(self):
                 self.assertEqual(stats.count, 0)
             self.assertFalse(stats.dirty)
 
-        run2 = self.dag_bash.create_dagrun(
+        self.dag_bash.create_dagrun(
             run_id="run2",
             execution_date=DEFAULT_DATE + timedelta(days=1),
             state=State.RUNNING)
diff --git a/tests/executors/__init__.py b/tests/executors/__init__.py
index 1ef5efdd4e74e..114d189da14ab 100644
--- a/tests/executors/__init__.py
+++ b/tests/executors/__init__.py
@@ -16,5 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
-from .dask_executor import *
diff --git a/tests/macros/test_hive.py b/tests/macros/test_hive.py
index 758a73b44ea04..73e42717fa837 100644
--- a/tests/macros/test_hive.py
+++ b/tests/macros/test_hive.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from datetime import datetime, timedelta
+from datetime import datetime
 import unittest
 
 from airflow.macros import hive
diff --git a/tests/models.py b/tests/models.py
index 09ab657170676..a627d3eb9bd26 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -343,20 +343,41 @@ def test_get_num_task_instances(self):
         session.merge(ti4)
         session.commit()
 
-        self.assertEqual(0, DAG.get_num_task_instances(test_dag_id, ['fakename'],
-            session=session))
-        self.assertEqual(4, DAG.get_num_task_instances(test_dag_id, [test_task_id],
-            session=session))
-        self.assertEqual(4, DAG.get_num_task_instances(test_dag_id,
-            ['fakename', test_task_id], session=session))
-        self.assertEqual(1, DAG.get_num_task_instances(test_dag_id, [test_task_id],
-            states=[None], session=session))
-        self.assertEqual(2, DAG.get_num_task_instances(test_dag_id, [test_task_id],
-            states=[State.RUNNING], session=session))
-        self.assertEqual(3, DAG.get_num_task_instances(test_dag_id, [test_task_id],
-            states=[None, State.RUNNING], session=session))
-        self.assertEqual(4, DAG.get_num_task_instances(test_dag_id, [test_task_id],
-            states=[None, State.QUEUED, State.RUNNING], session=session))
+        self.assertEqual(
+            0,
+            DAG.get_num_task_instances(test_dag_id, ['fakename'], session=session)
+        )
+        self.assertEqual(
+            4,
+            DAG.get_num_task_instances(test_dag_id, [test_task_id], session=session)
+        )
+        self.assertEqual(
+            4,
+            DAG.get_num_task_instances(
+                test_dag_id, ['fakename', test_task_id], session=session)
+        )
+        self.assertEqual(
+            1,
+            DAG.get_num_task_instances(
+                test_dag_id, [test_task_id], states=[None], session=session)
+        )
+        self.assertEqual(
+            2,
+            DAG.get_num_task_instances(
+                test_dag_id, [test_task_id], states=[State.RUNNING], session=session)
+        )
+        self.assertEqual(
+            3,
+            DAG.get_num_task_instances(
+                test_dag_id, [test_task_id],
+                states=[None, State.RUNNING], session=session)
+        )
+        self.assertEqual(
+            4,
+            DAG.get_num_task_instances(
+                test_dag_id, [test_task_id],
+                states=[None, State.QUEUED, State.RUNNING], session=session)
+        )
         session.close()
 
     def test_render_template_field(self):
@@ -377,7 +398,7 @@ def test_render_template_field_macro(self):
 
         dag = DAG('test-dag',
                   start_date=DEFAULT_DATE,
-                  user_defined_macros = dict(foo='bar'))
+                  user_defined_macros=dict(foo='bar'))
 
         with dag:
             task = DummyOperator(task_id='op1')
@@ -416,11 +437,11 @@ def test_render_template_field_filter(self):
             if a custom filter was defined"""
 
         def jinja_udf(name):
-            return 'Hello %s' %name
+            return 'Hello %s' % name
 
         dag = DAG('test-dag',
                   start_date=DEFAULT_DATE,
-                  user_defined_filters = dict(hello=jinja_udf))
+                  user_defined_filters=dict(hello=jinja_udf))
 
         with dag:
             task = DummyOperator(task_id='op1')
@@ -835,10 +856,14 @@ def test_dagrun_find(self):
 
         session.commit()
 
-        self.assertEqual(1, len(models.DagRun.find(dag_id=dag_id1, external_trigger=True)))
-        self.assertEqual(0, len(models.DagRun.find(dag_id=dag_id1, external_trigger=False)))
-        self.assertEqual(0, len(models.DagRun.find(dag_id=dag_id2, external_trigger=True)))
-        self.assertEqual(1, len(models.DagRun.find(dag_id=dag_id2, external_trigger=False)))
+        self.assertEqual(1,
+                         len(models.DagRun.find(dag_id=dag_id1, external_trigger=True)))
+        self.assertEqual(0,
+                         len(models.DagRun.find(dag_id=dag_id1, external_trigger=False)))
+        self.assertEqual(0,
+                         len(models.DagRun.find(dag_id=dag_id2, external_trigger=True)))
+        self.assertEqual(1,
+                         len(models.DagRun.find(dag_id=dag_id2, external_trigger=False)))
 
     def test_dagrun_success_when_all_skipped(self):
         """
@@ -1338,7 +1363,7 @@ def test_process_file_cron_validity_check(self):
             dagbag.process_file(os.path.join(TEST_DAGS_FOLDER, d))
         self.assertEqual(len(dagbag.import_errors), len(invalid_dag_files))
 
-    @patch.object(DagModel,'get_current')
+    @patch.object(DagModel, 'get_current')
     def test_get_dag_without_refresh(self, mock_dagmodel):
         """
         Test that, once a DAG is loaded, it doesn't get refreshed again if it
@@ -1352,6 +1377,7 @@ def test_get_dag_without_refresh(self, mock_dagmodel):
 
         class TestDagBag(models.DagBag):
             process_file_calls = 0
+
             def process_file(self, filepath, only_if_updated=True, safe_mode=True):
                 if 'example_bash_operator.py' == os.path.basename(filepath):
                     TestDagBag.process_file_calls += 1
@@ -1571,6 +1597,7 @@ def test_skip_cycle_dags(self):
         Don't crash when loading an invalid (contains a cycle) DAG file.
         Don't load the dag into the DagBag either
         """
+
         # Define Dag to load
         def basic_cycle():
             from airflow.models import DAG
@@ -1764,7 +1791,8 @@ def test_set_task_dates(self):
         """
         Test that tasks properly take start/end dates from DAGs
         """
-        dag = DAG('dag', start_date=DEFAULT_DATE, end_date=DEFAULT_DATE + datetime.timedelta(days=10))
+        dag = DAG('dag', start_date=DEFAULT_DATE,
+                  end_date=DEFAULT_DATE + datetime.timedelta(days=10))
 
         op1 = DummyOperator(task_id='op_1', owner='test')
 
@@ -1930,7 +1958,6 @@ def test_requeue_over_concurrency(self, mock_concurrency_reached):
         ti.run()
         self.assertEqual(ti.state, models.State.NONE)
 
-
     @patch.object(TI, 'pool_full')
     def test_run_pooling_task(self, mock_pool_full):
         """
@@ -2124,11 +2151,11 @@ def test_next_retry_datetime(self):
 
         ti.try_number = 9
         dt = ti.next_retry_datetime()
-        self.assertEqual(dt, ti.end_date+max_delay)
+        self.assertEqual(dt, ti.end_date + max_delay)
 
         ti.try_number = 50
         dt = ti.next_retry_datetime()
-        self.assertEqual(dt, ti.end_date+max_delay)
+        self.assertEqual(dt, ti.end_date + max_delay)
 
     def test_depends_on_past(self):
         dagbag = models.DagBag()
@@ -2370,7 +2397,7 @@ def test_check_and_change_state_before_execution(self):
     def test_check_and_change_state_before_execution_dep_not_met(self):
         dag = models.DAG(dag_id='test_check_and_change_state_before_execution')
         task = DummyOperator(task_id='task', dag=dag, start_date=DEFAULT_DATE)
-        task2= DummyOperator(task_id='task2', dag=dag, start_date=DEFAULT_DATE)
+        task2 = DummyOperator(task_id='task2', dag=dag, start_date=DEFAULT_DATE)
         task >> task2
         ti = TI(
             task=task2, execution_date=timezone.utcnow())
@@ -2666,7 +2693,8 @@ def test_dags_clear(self):
         for i in range(num_of_dags):
             dag = DAG('test_dag_clear_' + str(i), start_date=DEFAULT_DATE,
                       end_date=DEFAULT_DATE + datetime.timedelta(days=10))
-            ti = TI(task=DummyOperator(task_id='test_task_clear_' + str(i), owner='test', dag=dag),
+            ti = TI(task=DummyOperator(task_id='test_task_clear_' + str(i), owner='test',
+                                       dag=dag),
                     execution_date=DEFAULT_DATE)
             dags.append(dag)
             tis.append(ti)
@@ -2887,8 +2915,8 @@ def test_connection_from_uri_without_extras(self):
         self.assertIsNone(connection.extra)
 
     def test_connection_from_uri_with_extras(self):
-        uri = 'scheme://user:password@host%2flocation:1234/schema?'\
-            'extra1=a%20value&extra2=%2fpath%2f'
+        uri = 'scheme://user:password@host%2flocation:1234/schema?' \
+              'extra1=a%20value&extra2=%2fpath%2f'
         connection = Connection(uri=uri)
         self.assertEqual(connection.conn_type, 'scheme')
         self.assertEqual(connection.host, 'host/location')
diff --git a/tests/operators/operators.py b/tests/operators/operators.py
index ae953253cccf8..9f320a13dee0e 100644
--- a/tests/operators/operators.py
+++ b/tests/operators/operators.py
@@ -27,7 +27,6 @@
 
 import os
 import mock
-import six
 import unittest
 
 configuration.load_test_config()
diff --git a/tests/operators/test_virtualenv_operator.py b/tests/operators/test_virtualenv_operator.py
index ab53439c509b0..460ea2f4a25b6 100644
--- a/tests/operators/test_virtualenv_operator.py
+++ b/tests/operators/test_virtualenv_operator.py
@@ -28,13 +28,10 @@
 from subprocess import CalledProcessError
 
 from airflow import configuration, DAG
-from airflow.models import TaskInstance
 from airflow.operators.python_operator import PythonVirtualenvOperator
-from airflow.settings import Session
 from airflow.utils import timezone
 
 from airflow.exceptions import AirflowException
-import logging
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 END_DATE = timezone.datetime(2016, 1, 2)
@@ -84,7 +81,7 @@ def f():
     def test_no_system_site_packages(self):
         def f():
             try:
-                import funcsigs
+                import funcsigs  # noqa: F401
             except ImportError:
                 return True
             raise Exception
@@ -92,26 +89,31 @@ def f():
 
     def test_system_site_packages(self):
         def f():
-            import funcsigs
+            import funcsigs  # noqa: F401
         self._run_as_operator(f, requirements=['funcsigs'], system_site_packages=True)
 
     def test_with_requirements_pinned(self):
-        self.assertNotEqual('0.4', funcsigs.__version__, 'Please update this string if this fails')
+        self.assertNotEqual(
+            '0.4', funcsigs.__version__, 'Please update this string if this fails')
+
         def f():
-            import funcsigs
+            import funcsigs  # noqa: F401
             if funcsigs.__version__ != '0.4':
                 raise Exception
+
         self._run_as_operator(f, requirements=['funcsigs==0.4'])
 
     def test_unpinned_requirements(self):
         def f():
-            import funcsigs
-        self._run_as_operator(f, requirements=['funcsigs', 'dill'], system_site_packages=False)
+            import funcsigs  # noqa: F401
+        self._run_as_operator(
+            f, requirements=['funcsigs', 'dill'], system_site_packages=False)
 
     def test_range_requirements(self):
         def f():
-            import funcsigs
-        self._run_as_operator(f, requirements=['funcsigs>1.0', 'dill'], system_site_packages=False)
+            import funcsigs  # noqa: F401
+        self._run_as_operator(
+            f, requirements=['funcsigs>1.0', 'dill'], system_site_packages=False)
 
     def test_fail(self):
         def f():
@@ -153,8 +155,10 @@ def test_wrong_python_op_args(self):
             version = 3
         else:
             version = 2
+
         def f():
             pass
+
         with self.assertRaises(AirflowException):
             self._run_as_operator(f, python_version=version, op_args=[1])
 
@@ -169,11 +173,12 @@ def f():
             print(virtualenv_string_args)
             if virtualenv_string_args[0] != virtualenv_string_args[2]:
                 raise Exception
-        self._run_as_operator(f, python_version=self._invert_python_major_version(), string_args=[1,2,1])
+        self._run_as_operator(
+            f, python_version=self._invert_python_major_version(), string_args=[1, 2, 1])
 
     def test_with_args(self):
         def f(a, b, c=False, d=False):
-            if a==0 and b==1 and c and not d:
+            if a == 0 and b == 1 and c and not d:
                 return True
             else:
                 raise Exception
diff --git a/tests/plugins_manager.py b/tests/plugins_manager.py
index 850695757426c..eeb6494100b84 100644
--- a/tests/plugins_manager.py
+++ b/tests/plugins_manager.py
@@ -22,12 +22,9 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-import inspect
-import logging
 import unittest
 
 from flask.blueprints import Blueprint
-from flask_admin import BaseView
 from flask_admin.menu import MenuLink, MenuView
 
 from airflow.configuration import conf
diff --git a/tests/security/__init__.py b/tests/security/__init__.py
index 880e77221365b..114d189da14ab 100644
--- a/tests/security/__init__.py
+++ b/tests/security/__init__.py
@@ -16,5 +16,3 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
-from .kerberos import *
diff --git a/tests/ti_deps/deps/test_task_concurrency.py b/tests/ti_deps/deps/test_task_concurrency.py
index 4272d3f01cdb3..ad3c0d9ea0dad 100644
--- a/tests/ti_deps/deps/test_task_concurrency.py
+++ b/tests/ti_deps/deps/test_task_concurrency.py
@@ -24,7 +24,6 @@
 from airflow.models import DAG, BaseOperator
 from airflow.ti_deps.dep_context import DepContext
 from airflow.ti_deps.deps.task_concurrency_dep import TaskConcurrencyDep
-from airflow.utils.state import State
 
 
 class TaskConcurrencyDepTest(unittest.TestCase):
diff --git a/tests/www/api/experimental/test_kerberos_endpoints.py b/tests/www/api/experimental/test_kerberos_endpoints.py
index 40394cec06b55..b305e19b2137a 100644
--- a/tests/www/api/experimental/test_kerberos_endpoints.py
+++ b/tests/www/api/experimental/test_kerberos_endpoints.py
@@ -20,7 +20,6 @@
 import json
 import mock
 import os
-import socket
 import unittest
 
 from datetime import datetime
diff --git a/tests/www/api/experimental/test_password_endpoints.py b/tests/www/api/experimental/test_password_endpoints.py
index 8131ff52f3dd5..20a0608a77880 100644
--- a/tests/www/api/experimental/test_password_endpoints.py
+++ b/tests/www/api/experimental/test_password_endpoints.py
@@ -17,11 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import json
 import unittest
 
-from datetime import datetime
-
 from backports.configparser import DuplicateSectionError
 
 from airflow import models
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 8198eaa33742f..507b5cfced142 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -31,7 +31,7 @@
 from urllib.parse import quote_plus
 from werkzeug.test import Client
 
-from airflow import models, configuration, settings
+from airflow import models, configuration
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
 from airflow.models import DAG, DagRun, TaskInstance
 from airflow.operators.dummy_operator import DummyOperator

From ed29c9c1f6158deaaeaf7e022f2e853ddd63746a Mon Sep 17 00:00:00 2001
From: Kevin Yang <kevin.yang@airbnb.com>
Date: Wed, 11 Jul 2018 10:28:06 +0200
Subject: [PATCH 370/808] [AIRFLOW-2463] Make task instance context available
 for hive queries

---
 airflow/hooks/hive_hooks.py                 |  89 ++++++++++---
 airflow/operators/bash_operator.py          |  14 ++-
 airflow/operators/hive_to_mysql.py          |   8 +-
 airflow/operators/hive_to_samba_operator.py |   4 +-
 airflow/operators/python_operator.py        |  16 ++-
 airflow/utils/operator_helpers.py           |  59 +++++----
 tests/hooks/test_hive_hook.py               |  83 ++++++++++--
 tests/operators/bash_operator.py            |  12 +-
 tests/operators/test_python_operator.py     | 133 ++++++++++++++++++--
 tests/utils/test_operator_helpers.py        |  32 +++--
 10 files changed, 374 insertions(+), 76 deletions(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index 6cade39ad3560..e872551c4c0e2 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -21,29 +21,40 @@
 
 import contextlib
 import os
-
-from six.moves import zip
-from past.builtins import basestring, unicode
-
-import unicodecsv as csv
 import re
-import six
 import subprocess
 import time
 from collections import OrderedDict
 from tempfile import NamedTemporaryFile
 
-from airflow import configuration as conf
+import hmsclient
+import six
+import unicodecsv as csv
+from past.builtins import basestring
+from past.builtins import unicode
+from six.moves import zip
+
+import airflow.security.utils as utils
+from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.helpers import as_flattened_list
 from airflow.utils.file import TemporaryDirectory
-from airflow import configuration
-import airflow.security.utils as utils
+from airflow.utils.helpers import as_flattened_list
+from airflow.utils.operator_helpers import AIRFLOW_VAR_NAME_FORMAT_MAPPING
 
 HIVE_QUEUE_PRIORITIES = ['VERY_HIGH', 'HIGH', 'NORMAL', 'LOW', 'VERY_LOW']
 
 
+def get_context_from_env_var():
+    """
+    Extract context from env variable, e.g. dag_id, task_id and execution_date,
+    so that they can be used inside BashOperator and PythonOperator.
+    :return: The context of interest.
+    """
+    return {format_map['default']: os.environ.get(format_map['env_var_format'], '')
+            for format_map in AIRFLOW_VAR_NAME_FORMAT_MAPPING.values()}
+
+
 class HiveCliHook(BaseHook):
     """Simple wrapper around the hive CLI.
 
@@ -91,8 +102,8 @@ def __init__(
                     "Invalid Mapred Queue Priority.  Valid values are: "
                     "{}".format(', '.join(HIVE_QUEUE_PRIORITIES)))
 
-        self.mapred_queue = mapred_queue or conf.get('hive',
-                                                     'default_hive_mapred_queue')
+        self.mapred_queue = mapred_queue or configuration.get('hive',
+                                                              'default_hive_mapred_queue')
         self.mapred_queue_priority = mapred_queue_priority
         self.mapred_job_name = mapred_job_name
 
@@ -125,6 +136,7 @@ def _prepare_cli_cmd(self):
                 jdbc_url += ";auth=" + self.auth
 
             jdbc_url = jdbc_url.format(**locals())
+            jdbc_url = '"{}"'.format(jdbc_url)
 
             cmd_extra += ['-u', jdbc_url]
             if conn.login:
@@ -184,10 +196,15 @@ def run_cli(self, hql, schema=None, verbose=True, hive_conf=None):
 
         with TemporaryDirectory(prefix='airflow_hiveop_') as tmp_dir:
             with NamedTemporaryFile(dir=tmp_dir) as f:
+                hql = hql + '\n'
                 f.write(hql.encode('UTF-8'))
                 f.flush()
                 hive_cmd = self._prepare_cli_cmd()
-                hive_conf_params = self._prepare_hiveconf(hive_conf)
+                env_context = get_context_from_env_var()
+                # Only extend the hive_conf if it is defined.
+                if hive_conf:
+                    env_context.update(hive_conf)
+                hive_conf_params = self._prepare_hiveconf(env_context)
                 if self.mapred_queue:
                     hive_conf_params.extend(
                         ['-hiveconf',
@@ -773,7 +790,7 @@ def get_conn(self, schema=None):
             username=db.login or username,
             database=schema or db.schema or 'default')
 
-    def _get_results(self, hql, schema='default', fetch_size=None):
+    def _get_results(self, hql, schema='default', fetch_size=None, hive_conf=None):
         from pyhive.exc import ProgrammingError
         if isinstance(hql, basestring):
             hql = [hql]
@@ -781,12 +798,21 @@ def _get_results(self, hql, schema='default', fetch_size=None):
         with contextlib.closing(self.get_conn(schema)) as conn, \
                 contextlib.closing(conn.cursor()) as cur:
             cur.arraysize = fetch_size or 1000
+
+            env_context = get_context_from_env_var()
+            if hive_conf:
+                env_context.update(hive_conf)
+            for k, v in env_context.items():
+                cur.execute("set {}={}".format(k, v))
+
             for statement in hql:
                 cur.execute(statement)
                 # we only get results of statements that returns
                 lowered_statement = statement.lower().strip()
                 if (lowered_statement.startswith('select') or
-                   lowered_statement.startswith('with')):
+                    lowered_statement.startswith('with') or
+                    (lowered_statement.startswith('set') and
+                     '=' not in lowered_statement)):
                     description = [c for c in cur.description]
                     if previous_description and previous_description != description:
                         message = '''The statements are producing different descriptions:
@@ -806,8 +832,17 @@ def _get_results(self, hql, schema='default', fetch_size=None):
                     except ProgrammingError:
                         self.log.debug("get_results returned no records")
 
-    def get_results(self, hql, schema='default', fetch_size=None):
-        results_iter = self._get_results(hql, schema, fetch_size=fetch_size)
+    def get_results(self, hql, schema='default', fetch_size=None, hive_conf=None):
+        """
+        Get results of the provided hql in target schema.
+        :param hql: hql to be executed.
+        :param schema: target schema, default to 'default'.
+        :param fetch_size max size of result to fetch.
+        :param hive_conf: hive_conf to execute alone with the hql.
+        :return: results of hql execution.
+        """
+        results_iter = self._get_results(hql, schema,
+                                         fetch_size=fetch_size, hive_conf=hive_conf)
         header = next(results_iter)
         results = {
             'data': list(results_iter),
@@ -823,9 +858,23 @@ def to_csv(
             delimiter=',',
             lineterminator='\r\n',
             output_header=True,
-            fetch_size=1000):
-
-        results_iter = self._get_results(hql, schema, fetch_size=fetch_size)
+            fetch_size=1000,
+            hive_conf=None):
+        """
+        Execute hql in target schema and write results to a csv file.
+        :param hql: hql to be executed.
+        :param csv_filepath: filepath of csv to write results into.
+        :param schema: target schema, , default to 'default'.
+        :param delimiter: delimiter of the csv file.
+        :param lineterminator: lineterminator of the csv file.
+        :param output_header: header of the csv file.
+        :param fetch_size: number of result rows to write into the csv file.
+        :param hive_conf: hive_conf to execute alone with the hql.
+        :return:
+        """
+
+        results_iter = self._get_results(hql, schema,
+                                         fetch_size=fetch_size, hive_conf=hive_conf)
         header = next(results_iter)
         message = None
 
diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index 37a19dbe9bc31..17de0145a3e13 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -18,16 +18,18 @@
 # under the License.
 
 
-from builtins import bytes
 import os
 import signal
 from subprocess import Popen, STDOUT, PIPE
 from tempfile import gettempdir, NamedTemporaryFile
 
+from builtins import bytes
+
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
 from airflow.utils.file import TemporaryDirectory
+from airflow.utils.operator_helpers import context_to_airflow_vars
 
 
 class BashOperator(BaseOperator):
@@ -73,6 +75,16 @@ def execute(self, context):
         """
         self.log.info("Tmp dir root location: \n %s", gettempdir())
 
+        # Prepare env for child process.
+        if self.env is None:
+            self.env = os.environ.copy()
+        airflow_context_vars = context_to_airflow_vars(context, in_env_var_format=True)
+        self.log.info("Exporting the following env vars:\n" +
+                      '\n'.join(["{}={}".format(k, v)
+                                 for k, v in
+                                 airflow_context_vars.items()]))
+        self.env.update(airflow_context_vars)
+
         self.lineage_data = self.bash_command
 
         with TemporaryDirectory(prefix='airflowtmp') as tmp_dir:
diff --git a/airflow/operators/hive_to_mysql.py b/airflow/operators/hive_to_mysql.py
index 4dc25a6e8f8c5..882a9d854016a 100644
--- a/airflow/operators/hive_to_mysql.py
+++ b/airflow/operators/hive_to_mysql.py
@@ -17,12 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from tempfile import NamedTemporaryFile
+
 from airflow.hooks.hive_hooks import HiveServer2Hook
 from airflow.hooks.mysql_hook import MySqlHook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
-
-from tempfile import NamedTemporaryFile
+from airflow.utils.operator_helpers import context_to_airflow_vars
 
 
 class HiveToMySqlTransfer(BaseOperator):
@@ -88,7 +89,8 @@ def execute(self, context):
         if self.bulk_load:
             tmpfile = NamedTemporaryFile()
             hive.to_csv(self.sql, tmpfile.name, delimiter='\t',
-                        lineterminator='\n', output_header=False)
+                        lineterminator='\n', output_header=False,
+                        hive_conf=context_to_airflow_vars(context))
         else:
             results = hive.get_records(self.sql)
 
diff --git a/airflow/operators/hive_to_samba_operator.py b/airflow/operators/hive_to_samba_operator.py
index f6978ac30e2e6..fa2a9619eb73e 100644
--- a/airflow/operators/hive_to_samba_operator.py
+++ b/airflow/operators/hive_to_samba_operator.py
@@ -23,6 +23,7 @@
 from airflow.hooks.samba_hook import SambaHook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
+from airflow.utils.operator_helpers import context_to_airflow_vars
 
 
 class Hive2SambaOperator(BaseOperator):
@@ -60,6 +61,7 @@ def execute(self, context):
         hive = HiveServer2Hook(hiveserver2_conn_id=self.hiveserver2_conn_id)
         tmpfile = tempfile.NamedTemporaryFile()
         self.log.info("Fetching file from Hive")
-        hive.to_csv(hql=self.hql, csv_filepath=tmpfile.name)
+        hive.to_csv(hql=self.hql, csv_filepath=tmpfile.name,
+                    hive_conf=context_to_airflow_vars(context))
         self.log.info("Pushing to samba")
         samba.push_from_local(self.destination_filepath, tmpfile.name)
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index e9007cfba20f2..c18ee3098b73f 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -17,21 +17,22 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from builtins import str
-import dill
 import inspect
 import os
 import pickle
 import subprocess
 import sys
 import types
+from textwrap import dedent
+
+import dill
+from builtins import str
 
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator, SkipMixin
 from airflow.utils.decorators import apply_defaults
 from airflow.utils.file import TemporaryDirectory
-
-from textwrap import dedent
+from airflow.utils.operator_helpers import context_to_airflow_vars
 
 
 class PythonOperator(BaseOperator):
@@ -87,6 +88,13 @@ def __init__(
             self.template_ext = templates_exts
 
     def execute(self, context):
+        # Export context to make it available for callables to use.
+        airflow_context_vars = context_to_airflow_vars(context, in_env_var_format=True)
+        self.log.info("Exporting the following env vars:\n" +
+                      '\n'.join(["{}={}".format(k, v)
+                                 for k, v in airflow_context_vars.items()]))
+        os.environ.update(airflow_context_vars)
+
         if self.provide_context:
             context.update(self.op_kwargs)
             context['templates_dict'] = self.templates_dict
diff --git a/airflow/utils/operator_helpers.py b/airflow/utils/operator_helpers.py
index 356aa650a3a40..e981941d84fea 100644
--- a/airflow/utils/operator_helpers.py
+++ b/airflow/utils/operator_helpers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -18,32 +18,49 @@
 # under the License.
 #
 
+AIRFLOW_VAR_NAME_FORMAT_MAPPING = {
+    'AIRFLOW_CONTEXT_DAG_ID': {'default': 'airflow.ctx.dag_id',
+                               'env_var_format': 'AIRFLOW_CTX_DAG_ID'},
+    'AIRFLOW_CONTEXT_TASK_ID': {'default': 'airflow.ctx.task_id',
+                                'env_var_format': 'AIRFLOW_CTX_TASK_ID'},
+    'AIRFLOW_CONTEXT_EXECUTION_DATE': {'default': 'airflow.ctx.execution_date',
+                                       'env_var_format': 'AIRFLOW_CTX_EXECUTION_DATE'},
+    'AIRFLOW_CONTEXT_DAG_RUN_ID': {'default': 'airflow.ctx.dag_run_id',
+                                   'env_var_format': 'AIRFLOW_CTX_DAG_RUN_ID'}
+}
+
 
-def context_to_airflow_vars(context):
+def context_to_airflow_vars(context, in_env_var_format=False):
     """
     Given a context, this function provides a dictionary of values that can be used to
     externally reconstruct relations between dags, dag_runs, tasks and task_instances.
+    Default to abc.def.ghi format and can be made to ABC_DEF_GHI format if
+    in_env_var_format is set to True.
 
-    :param context: The context for the task_instance of interest
+    :param context: The context for the task_instance of interest.
     :type context: dict
+    :param in_env_var_format: If returned vars should be in ABC_DEF_GHI format.
+    :type in_env_var_format: bool
+    :return task_instance context as dict.
     """
-    params = {}
-    dag = context.get('dag')
-    if dag and dag.dag_id:
-        params['airflow.ctx.dag.dag_id'] = dag.dag_id
-
-    dag_run = context.get('dag_run')
-    if dag_run and dag_run.execution_date:
-        params['airflow.ctx.dag_run.execution_date'] = dag_run.execution_date.isoformat()
-
-    task = context.get('task')
-    if task and task.task_id:
-        params['airflow.ctx.task.task_id'] = task.task_id
-
+    params = dict()
+    if in_env_var_format:
+        name_format = 'env_var_format'
+    else:
+        name_format = 'default'
     task_instance = context.get('task_instance')
+    if task_instance and task_instance.dag_id:
+        params[AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_ID'][
+            name_format]] = task_instance.dag_id
+    if task_instance and task_instance.task_id:
+        params[AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_TASK_ID'][
+            name_format]] = task_instance.task_id
     if task_instance and task_instance.execution_date:
-        params['airflow.ctx.task_instance.execution_date'] = (
-            task_instance.execution_date.isoformat()
-        )
-
+        params[
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_EXECUTION_DATE'][
+                name_format]] = task_instance.execution_date.isoformat()
+    dag_run = context.get('dag_run')
+    if dag_run and dag_run.run_id:
+        params[AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_RUN_ID'][
+            name_format]] = dag_run.run_id
     return params
diff --git a/tests/hooks/test_hive_hook.py b/tests/hooks/test_hive_hook.py
index 81270c635b042..1cac74c6cd846 100644
--- a/tests/hooks/test_hive_hook.py
+++ b/tests/hooks/test_hive_hook.py
@@ -21,24 +21,22 @@
 import datetime
 import itertools
 import os
-
-import pandas as pd
 import random
-
-import mock
 import unittest
-
 from collections import OrderedDict
+
+import mock
+import pandas as pd
 from hmsclient import HMSClient
 
+from airflow import DAG, configuration
 from airflow.exceptions import AirflowException
 from airflow.hooks.hive_hooks import HiveCliHook, HiveMetastoreHook, HiveServer2Hook
-from airflow import DAG, configuration
 from airflow.operators.hive_operator import HiveOperator
 from airflow.utils import timezone
+from airflow.utils.operator_helpers import AIRFLOW_VAR_NAME_FORMAT_MAPPING
 from airflow.utils.tests import assertEqualIgnoreMultipleSpaces
 
-
 configuration.load_test_config()
 
 
@@ -97,6 +95,39 @@ def test_run_cli(self):
         hook = HiveCliHook()
         hook.run_cli("SHOW DATABASES")
 
+    def test_run_cli_with_hive_conf(self):
+        hql = "set key;\n" \
+              "set airflow.ctx.dag_id;\nset airflow.ctx.dag_run_id;\n" \
+              "set airflow.ctx.task_id;\nset airflow.ctx.execution_date;\n"
+
+        dag_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_ID']['env_var_format']
+        task_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_TASK_ID']['env_var_format']
+        execution_date_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_EXECUTION_DATE'][
+                'env_var_format']
+        dag_run_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_RUN_ID'][
+                'env_var_format']
+        os.environ[dag_id_ctx_var_name] = 'test_dag_id'
+        os.environ[task_id_ctx_var_name] = 'test_task_id'
+        os.environ[execution_date_ctx_var_name] = 'test_execution_date'
+        os.environ[dag_run_id_ctx_var_name] = 'test_dag_run_id'
+
+        hook = HiveCliHook()
+        output = hook.run_cli(hql=hql, hive_conf={'key': 'value'})
+        self.assertIn('value', output)
+        self.assertIn('test_dag_id', output)
+        self.assertIn('test_task_id', output)
+        self.assertIn('test_execution_date', output)
+        self.assertIn('test_dag_run_id', output)
+
+        del os.environ[dag_id_ctx_var_name]
+        del os.environ[task_id_ctx_var_name]
+        del os.environ[execution_date_ctx_var_name]
+        del os.environ[dag_run_id_ctx_var_name]
+
     @mock.patch('airflow.hooks.hive_hooks.HiveCliHook.run_cli')
     def test_load_file(self, mock_run_cli):
         filepath = "/path/to/input/file"
@@ -419,3 +450,41 @@ def test_multi_statements(self):
         hook = HiveServer2Hook()
         results = hook.get_records(sqls, schema=self.database)
         self.assertListEqual(results, [(1, 1), (2, 2)])
+
+    def test_get_results_with_hive_conf(self):
+        hql = ["set key",
+               "set airflow.ctx.dag_id",
+               "set airflow.ctx.dag_run_id",
+               "set airflow.ctx.task_id",
+               "set airflow.ctx.execution_date"]
+
+        dag_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_ID']['env_var_format']
+        task_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_TASK_ID']['env_var_format']
+        execution_date_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_EXECUTION_DATE'][
+                'env_var_format']
+        dag_run_id_ctx_var_name = \
+            AIRFLOW_VAR_NAME_FORMAT_MAPPING['AIRFLOW_CONTEXT_DAG_RUN_ID'][
+                'env_var_format']
+        os.environ[dag_id_ctx_var_name] = 'test_dag_id'
+        os.environ[task_id_ctx_var_name] = 'test_task_id'
+        os.environ[execution_date_ctx_var_name] = 'test_execution_date'
+        os.environ[dag_run_id_ctx_var_name] = 'test_dag_run_id'
+
+        hook = HiveServer2Hook()
+        output = '\n'.join(res_tuple[0]
+                           for res_tuple
+                           in hook.get_results(hql=hql,
+                                               hive_conf={'key': 'value'})['data'])
+        self.assertIn('value', output)
+        self.assertIn('test_dag_id', output)
+        self.assertIn('test_task_id', output)
+        self.assertIn('test_execution_date', output)
+        self.assertIn('test_dag_run_id', output)
+
+        del os.environ[dag_id_ctx_var_name]
+        del os.environ[task_id_ctx_var_name]
+        del os.environ[execution_date_ctx_var_name]
+        del os.environ[dag_run_id_ctx_var_name]
diff --git a/tests/operators/bash_operator.py b/tests/operators/bash_operator.py
index 1ce77e93e7ccb..e0a0ff3ebb402 100644
--- a/tests/operators/bash_operator.py
+++ b/tests/operators/bash_operator.py
@@ -12,8 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-import unittest
 import os
+import unittest
 from datetime import datetime, timedelta
 
 from airflow import DAG
@@ -59,7 +59,11 @@ def test_echo_env_variables(self):
                 task_id='echo_env_vars',
                 dag=self.dag,
                 bash_command='echo $AIRFLOW_HOME>> {0};'
-                             'echo $PYTHONPATH>> {0};'.format(fname)
+                             'echo $PYTHONPATH>> {0};'
+                             'echo $AIRFLOW_CTX_DAG_ID >> {0};'
+                             'echo $AIRFLOW_CTX_TASK_ID>> {0};'
+                             'echo $AIRFLOW_CTX_EXECUTION_DATE>> {0};'
+                             'echo $AIRFLOW_CTX_DAG_RUN_ID>> {0};'.format(fname)
             )
             os.environ['AIRFLOW_HOME'] = 'MY_PATH_TO_AIRFLOW_HOME'
             t.run(DEFAULT_DATE, DEFAULT_DATE,
@@ -70,3 +74,7 @@ def test_echo_env_variables(self):
                 self.assertIn('MY_PATH_TO_AIRFLOW_HOME', output)
                 # exported in run_unit_tests.sh as part of PYTHONPATH
                 self.assertIn('tests/test_utils', output)
+                self.assertIn('bash_op_test', output)
+                self.assertIn('echo_env_vars', output)
+                self.assertIn(DEFAULT_DATE.isoformat(), output)
+                self.assertIn('manual__' + DEFAULT_DATE.isoformat(), output)
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index b4b08f1a464a3..afc2a1383ae84 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -19,28 +19,44 @@
 
 from __future__ import print_function, unicode_literals
 
-import datetime
+import copy
+import logging
+import os
 import unittest
+from datetime import timedelta
 
-from airflow import configuration, DAG
-from airflow.models import TaskInstance as TI
+from airflow import configuration
+from airflow.exceptions import AirflowException
+from airflow.models import TaskInstance as TI, DAG, DagRun
+from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import PythonOperator, BranchPythonOperator
 from airflow.operators.python_operator import ShortCircuitOperator
-from airflow.operators.dummy_operator import DummyOperator
 from airflow.settings import Session
 from airflow.utils import timezone
 from airflow.utils.state import State
 
-from airflow.exceptions import AirflowException
-import logging
-
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 END_DATE = timezone.datetime(2016, 1, 2)
-INTERVAL = datetime.timedelta(hours=12)
+INTERVAL = timedelta(hours=12)
 FROZEN_NOW = timezone.datetime(2016, 1, 2, 12, 1, 1)
 
+TI_CONTEXT_ENV_VARS = ['AIRFLOW_CTX_DAG_ID',
+                       'AIRFLOW_CTX_TASK_ID',
+                       'AIRFLOW_CTX_EXECUTION_DATE',
+                       'AIRFLOW_CTX_DAG_RUN_ID']
+
 
 class PythonOperatorTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        super(PythonOperatorTest, cls).setUpClass()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        session.commit()
+        session.close()
 
     def setUp(self):
         super(PythonOperatorTest, self).setUp()
@@ -55,6 +71,21 @@ def setUp(self):
         self.clear_run()
         self.addCleanup(self.clear_run)
 
+    def tearDown(self):
+        super(PythonOperatorTest, self).tearDown()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        print(len(session.query(DagRun).all()))
+        session.commit()
+        session.close()
+
+        for var in TI_CONTEXT_ENV_VARS:
+            if var in os.environ:
+                del os.environ[var]
+
     def do_run(self):
         self.run = True
 
@@ -90,8 +121,62 @@ def test_python_operator_python_callable_is_callable(self):
                 task_id='python_operator',
                 dag=self.dag)
 
+    def test_python_operator_shallow_copy_attr(self):
+        not_callable = lambda x: x
+        original_task = PythonOperator(
+            python_callable=not_callable,
+            task_id='python_operator',
+            op_kwargs={'certain_attrs': ''},
+            dag=self.dag
+        )
+        new_task = copy.deepcopy(original_task)
+        # shallow copy op_kwargs
+        self.assertEquals(id(original_task.op_kwargs['certain_attrs']),
+                          id(new_task.op_kwargs['certain_attrs']))
+        # shallow copy python_callable
+        self.assertEquals(id(original_task.python_callable),
+                          id(new_task.python_callable))
+
+    def _env_var_check_callback(self):
+        self.assertEqual('test_dag', os.environ['AIRFLOW_CTX_DAG_ID'])
+        self.assertEqual('hive_in_python_op', os.environ['AIRFLOW_CTX_TASK_ID'])
+        self.assertEqual(DEFAULT_DATE.isoformat(),
+                         os.environ['AIRFLOW_CTX_EXECUTION_DATE'])
+        self.assertEqual('manual__' + DEFAULT_DATE.isoformat(),
+                         os.environ['AIRFLOW_CTX_DAG_RUN_ID'])
+
+    def test_echo_env_variables(self):
+        """
+        Test that env variables are exported correctly to the
+        python callback in the task.
+        """
+        self.dag.create_dagrun(
+            run_id='manual__' + DEFAULT_DATE.isoformat(),
+            execution_date=DEFAULT_DATE,
+            start_date=DEFAULT_DATE,
+            state=State.RUNNING,
+            external_trigger=False,
+        )
+
+        t = PythonOperator(task_id='hive_in_python_op',
+                           dag=self.dag,
+                           python_callable=self._env_var_check_callback
+                           )
+        t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
 
 class BranchOperatorTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        super(BranchOperatorTest, cls).setUpClass()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        session.commit()
+        session.close()
+
     def setUp(self):
         self.dag = DAG('branch_operator_test',
                        default_args={
@@ -108,6 +193,17 @@ def setUp(self):
         self.branch_2.set_upstream(self.branch_op)
         self.dag.clear()
 
+    def tearDown(self):
+        super(BranchOperatorTest, self).tearDown()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        print(len(session.query(DagRun).all()))
+        session.commit()
+        session.close()
+
     def test_without_dag_run(self):
         """This checks the defensive against non existent tasks in a dag run"""
         self.branch_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
@@ -153,6 +249,27 @@ def test_with_dag_run(self):
 
 
 class ShortCircuitOperatorTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        super(ShortCircuitOperatorTest, cls).setUpClass()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        session.commit()
+        session.close()
+
+    def tearDown(self):
+        super(ShortCircuitOperatorTest, self).tearDown()
+
+        session = Session()
+
+        session.query(DagRun).delete()
+        session.query(TI).delete()
+        session.commit()
+        session.close()
+
     def test_without_dag_run(self):
         """This checks the defensive against non existent tasks in a dag run"""
         value = False
diff --git a/tests/utils/test_operator_helpers.py b/tests/utils/test_operator_helpers.py
index 592b4560b62ac..a3586012f1108 100644
--- a/tests/utils/test_operator_helpers.py
+++ b/tests/utils/test_operator_helpers.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -17,9 +17,10 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import unittest
 from datetime import datetime
+
 import mock
-import unittest
 
 from airflow.utils import operator_helpers
 
@@ -31,16 +32,18 @@ def setUp(self):
         self.dag_id = 'dag_id'
         self.task_id = 'task_id'
         self.execution_date = '2017-05-21T00:00:00'
+        self.dag_run_id = 'dag_run_id'
         self.context = {
-            'dag': mock.MagicMock(name='dag', dag_id=self.dag_id),
             'dag_run': mock.MagicMock(
                 name='dag_run',
+                run_id=self.dag_run_id,
                 execution_date=datetime.strptime(self.execution_date,
                                                  '%Y-%m-%dT%H:%M:%S'),
             ),
-            'task': mock.MagicMock(name='task', task_id=self.task_id),
             'task_instance': mock.MagicMock(
                 name='task_instance',
+                task_id=self.task_id,
+                dag_id=self.dag_id,
                 execution_date=datetime.strptime(self.execution_date,
                                                  '%Y-%m-%dT%H:%M:%S'),
             ),
@@ -53,10 +56,21 @@ def test_context_to_airflow_vars_all_context(self):
         self.assertDictEqual(
             operator_helpers.context_to_airflow_vars(self.context),
             {
-                'airflow.ctx.dag.dag_id': self.dag_id,
-                'airflow.ctx.dag_run.execution_date': self.execution_date,
-                'airflow.ctx.task.task_id': self.task_id,
-                'airflow.ctx.task_instance.execution_date': self.execution_date,
+                'airflow.ctx.dag_id': self.dag_id,
+                'airflow.ctx.execution_date': self.execution_date,
+                'airflow.ctx.task_id': self.task_id,
+                'airflow.ctx.dag_run_id': self.dag_run_id,
+            }
+        )
+
+        self.assertDictEqual(
+            operator_helpers.context_to_airflow_vars(self.context,
+                                                     in_env_var_format=True),
+            {
+                'AIRFLOW_CTX_DAG_ID': self.dag_id,
+                'AIRFLOW_CTX_EXECUTION_DATE': self.execution_date,
+                'AIRFLOW_CTX_TASK_ID': self.task_id,
+                'AIRFLOW_CTX_DAG_RUN_ID': self.dag_run_id,
             }
         )
 

From a0edb39815d26b351772f9b10325e924d9cf055d Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sun, 16 Sep 2018 14:31:10 +0200
Subject: [PATCH 371/808] [AIRFLOW-3059] Log how many rows are read from
 Postgres (#3905)

To know how many data is being read from Postgres, it is nice to log
this to the Airflow log.

Previously when there was no data, it would still create a single file.
This is not something that we want, and therefore we've changed this
behaviour.

Refactored the tests to make use of Postgres itself since we have it
running. This makes the tests more realistic, instead of mocking
everything.
---
 .../operators/postgres_to_gcs_operator.py     | 54 ++++++-----
 .../test_postgres_to_gcs_operator.py          | 96 ++++++++++++-------
 2 files changed, 92 insertions(+), 58 deletions(-)

diff --git a/airflow/contrib/operators/postgres_to_gcs_operator.py b/airflow/contrib/operators/postgres_to_gcs_operator.py
index 88b4d00e39790..ddebc05319039 100644
--- a/airflow/contrib/operators/postgres_to_gcs_operator.py
+++ b/airflow/contrib/operators/postgres_to_gcs_operator.py
@@ -133,28 +133,38 @@ def _write_local_data_files(self, cursor):
             contain the data for the GCS objects.
         """
         schema = list(map(lambda schema_tuple: schema_tuple[0], cursor.description))
-        file_no = 0
-        tmp_file_handle = NamedTemporaryFile(delete=True)
-        tmp_file_handles = {self.filename.format(file_no): tmp_file_handle}
-
-        for row in cursor:
-            # Convert datetime objects to utc seconds, and decimals to floats
-            row = map(self.convert_types, row)
-            row_dict = dict(zip(schema, row))
-
-            s = json.dumps(row_dict, sort_keys=True)
-            if PY3:
-                s = s.encode('utf-8')
-            tmp_file_handle.write(s)
-
-            # Append newline to make dumps BigQuery compatible.
-            tmp_file_handle.write(b'\n')
-
-            # Stop if the file exceeds the file size limit.
-            if tmp_file_handle.tell() >= self.approx_max_file_size_bytes:
-                file_no += 1
-                tmp_file_handle = NamedTemporaryFile(delete=True)
-                tmp_file_handles[self.filename.format(file_no)] = tmp_file_handle
+        tmp_file_handles = {}
+        row_no = 0
+
+        def _create_new_file():
+            handle = NamedTemporaryFile(delete=True)
+            filename = self.filename.format(len(tmp_file_handles))
+            tmp_file_handles[filename] = handle
+            return handle
+
+        # Don't create a file if there is nothing to write
+        if cursor.rowcount > 0:
+            tmp_file_handle = _create_new_file()
+
+            for row in cursor:
+                # Convert datetime objects to utc seconds, and decimals to floats
+                row = map(self.convert_types, row)
+                row_dict = dict(zip(schema, row))
+
+                s = json.dumps(row_dict, sort_keys=True)
+                if PY3:
+                    s = s.encode('utf-8')
+                tmp_file_handle.write(s)
+
+                # Append newline to make dumps BigQuery compatible.
+                tmp_file_handle.write(b'\n')
+
+                # Stop if the file exceeds the file size limit.
+                if tmp_file_handle.tell() >= self.approx_max_file_size_bytes:
+                    tmp_file_handle = _create_new_file()
+                row_no += 1
+
+        self.log.info('Received %s rows over %s files', row_no, len(tmp_file_handles))
 
         return tmp_file_handles
 
diff --git a/tests/contrib/operators/test_postgres_to_gcs_operator.py b/tests/contrib/operators/test_postgres_to_gcs_operator.py
index aaf2b9715c826..608c57d503941 100644
--- a/tests/contrib/operators/test_postgres_to_gcs_operator.py
+++ b/tests/contrib/operators/test_postgres_to_gcs_operator.py
@@ -24,40 +24,66 @@
 
 import unittest
 
-from airflow.contrib.operators.postgres_to_gcs_operator import PostgresToGoogleCloudStorageOperator
+from airflow.hooks.postgres_hook import PostgresHook
+from airflow.contrib.operators.postgres_to_gcs_operator import \
+    PostgresToGoogleCloudStorageOperator
 
 try:
-    from unittest import mock
+    from unittest.mock import patch
 except ImportError:
     try:
-        import mock
+        from mock import patch
     except ImportError:
         mock = None
 
-PY3 = sys.version_info[0] == 3
+TABLES = {'postgres_to_gcs_operator', 'postgres_to_gcs_operator_empty'}
 
 TASK_ID = 'test-postgres-to-gcs'
-POSTGRES_CONN_ID = 'postgres_conn_test'
-SQL = 'select 1'
+POSTGRES_CONN_ID = 'postgres_default'
+SQL = 'SELECT * FROM postgres_to_gcs_operator'
 BUCKET = 'gs://test'
 FILENAME = 'test_{}.ndjson'
-# we expect the psycopg cursor to return encoded strs in py2 and decoded in py3
-if PY3:
-    ROWS = [('mock_row_content_1', 42), ('mock_row_content_2', 43), ('mock_row_content_3', 44)]
-    CURSOR_DESCRIPTION = (('some_str', 0), ('some_num', 1005))
-else:
-    ROWS = [(b'mock_row_content_1', 42), (b'mock_row_content_2', 43), (b'mock_row_content_3', 44)]
-    CURSOR_DESCRIPTION = ((b'some_str', 0), (b'some_num', 1005))
+
 NDJSON_LINES = [
     b'{"some_num": 42, "some_str": "mock_row_content_1"}\n',
     b'{"some_num": 43, "some_str": "mock_row_content_2"}\n',
     b'{"some_num": 44, "some_str": "mock_row_content_3"}\n'
 ]
 SCHEMA_FILENAME = 'schema_test.json'
-SCHEMA_JSON = b'[{"mode": "NULLABLE", "name": "some_str", "type": "STRING"}, {"mode": "REPEATED", "name": "some_num", "type": "INTEGER"}]'
+SCHEMA_JSON = b'[{"mode": "NULLABLE", "name": "some_str", "type": "STRING"}, ' \
+              b'{"mode": "NULLABLE", "name": "some_num", "type": "INTEGER"}]'
 
 
 class PostgresToGoogleCloudStorageOperatorTest(unittest.TestCase):
+    def setUp(self):
+        postgres = PostgresHook()
+        with postgres.get_conn() as conn:
+            with conn.cursor() as cur:
+                for table in TABLES:
+                    cur.execute("DROP TABLE IF EXISTS {} CASCADE;".format(table))
+                    cur.execute("CREATE TABLE {}(some_str varchar, some_num integer);"
+                                .format(table))
+
+                cur.execute(
+                    "INSERT INTO postgres_to_gcs_operator VALUES(%s, %s);",
+                    ('mock_row_content_1', 42)
+                )
+                cur.execute(
+                    "INSERT INTO postgres_to_gcs_operator VALUES(%s, %s);",
+                    ('mock_row_content_2', 43)
+                )
+                cur.execute(
+                    "INSERT INTO postgres_to_gcs_operator VALUES(%s, %s);",
+                    ('mock_row_content_3', 44)
+                )
+
+    def tearDown(self):
+        postgres = PostgresHook()
+        with postgres.get_conn() as conn:
+            with conn.cursor() as cur:
+                for table in TABLES:
+                    cur.execute("DROP TABLE IF EXISTS {} CASCADE;".format(table))
+
     def test_init(self):
         """Test PostgresToGoogleCloudStorageOperator instance is properly initialized."""
         op = PostgresToGoogleCloudStorageOperator(
@@ -67,9 +93,8 @@ def test_init(self):
         self.assertEqual(op.bucket, BUCKET)
         self.assertEqual(op.filename, FILENAME)
 
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.PostgresHook')
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
-    def test_exec_success(self, gcs_hook_mock_class, pg_hook_mock_class):
+    @patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
+    def test_exec_success(self, gcs_hook_mock_class):
         """Test the execute function in case where the run is successful."""
         op = PostgresToGoogleCloudStorageOperator(
             task_id=TASK_ID,
@@ -78,10 +103,6 @@ def test_exec_success(self, gcs_hook_mock_class, pg_hook_mock_class):
             bucket=BUCKET,
             filename=FILENAME)
 
-        pg_hook_mock = pg_hook_mock_class.return_value
-        pg_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
-        pg_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
-
         gcs_hook_mock = gcs_hook_mock_class.return_value
 
         def _assert_upload(bucket, obj, tmp_filename, content_type):
@@ -95,16 +116,9 @@ def _assert_upload(bucket, obj, tmp_filename, content_type):
 
         op.execute(None)
 
-        pg_hook_mock_class.assert_called_once_with(postgres_conn_id=POSTGRES_CONN_ID)
-        pg_hook_mock.get_conn().cursor().execute.assert_called_once_with(SQL, None)
-
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.PostgresHook')
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
-    def test_file_splitting(self, gcs_hook_mock_class, pg_hook_mock_class):
+    @patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
+    def test_file_splitting(self, gcs_hook_mock_class):
         """Test that ndjson is split by approx_max_file_size_bytes param."""
-        pg_hook_mock = pg_hook_mock_class.return_value
-        pg_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
-        pg_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
 
         gcs_hook_mock = gcs_hook_mock_class.return_value
         expected_upload = {
@@ -128,13 +142,23 @@ def _assert_upload(bucket, obj, tmp_filename, content_type):
             approx_max_file_size_bytes=len(expected_upload[FILENAME.format(0)]))
         op.execute(None)
 
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.PostgresHook')
-    @mock.patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
-    def test_schema_file(self, gcs_hook_mock_class, pg_hook_mock_class):
+    @patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
+    def test_empty_query(self, gcs_hook_mock_class):
+        """If the sql returns no rows, we should not upload any files"""
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+
+        op = PostgresToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            sql='SELECT * FROM postgres_to_gcs_operator_empty',
+            bucket=BUCKET,
+            filename=FILENAME)
+        op.execute(None)
+
+        assert not gcs_hook_mock.upload.called, 'No data means no files in the bucket'
+
+    @patch('airflow.contrib.operators.postgres_to_gcs_operator.GoogleCloudStorageHook')
+    def test_schema_file(self, gcs_hook_mock_class):
         """Test writing schema files."""
-        pg_hook_mock = pg_hook_mock_class.return_value
-        pg_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
-        pg_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
 
         gcs_hook_mock = gcs_hook_mock_class.return_value
 

From be03fb34526f980736d96c6721e93442fad235df Mon Sep 17 00:00:00 2001
From: "juhwi.lee" <juhwi.lee@navercorp.com>
Date: Sun, 15 Jul 2018 12:14:21 +0200
Subject: [PATCH 372/808] [AIRFLOW-2751] add job properties update in hive to
 druid operator.

Closes #3600 from happyjulie/AIRFLOW-2751
---
 airflow/operators/hive_to_druid.py    |  8 ++++++++
 tests/operators/test_hive_to_druid.py | 17 +++++++++--------
 2 files changed, 17 insertions(+), 8 deletions(-)

diff --git a/airflow/operators/hive_to_druid.py b/airflow/operators/hive_to_druid.py
index a845902c871bb..ee924a0d2c32a 100644
--- a/airflow/operators/hive_to_druid.py
+++ b/airflow/operators/hive_to_druid.py
@@ -55,6 +55,8 @@ class HiveToDruidTransfer(BaseOperator):
     :param hive_tblproperties: additional properties for tblproperties in
         hive for the staging table
     :type hive_tblproperties: dict
+    :param job_properties: additional properties for job
+    :type job_properties: dict
     """
 
     template_fields = ('sql', 'intervals')
@@ -77,6 +79,7 @@ def __init__(
             query_granularity="NONE",
             segment_granularity="DAY",
             hive_tblproperties=None,
+            job_properties=None,
             *args, **kwargs):
         super(HiveToDruidTransfer, self).__init__(*args, **kwargs)
         self.sql = sql
@@ -95,6 +98,7 @@ def __init__(
         self.druid_ingest_conn_id = druid_ingest_conn_id
         self.metastore_conn_id = metastore_conn_id
         self.hive_tblproperties = hive_tblproperties
+        self.job_properties = job_properties
 
     def execute(self, context):
         hive = HiveCliHook(hive_cli_conn_id=self.hive_cli_conn_id)
@@ -231,6 +235,10 @@ def construct_ingest_query(self, static_path, columns):
             }
         }
 
+        if self.job_properties:
+            ingest_query_dict['spec']['tuningConfig']['jobProperties'] \
+                .update(self.job_properties)
+
         if self.hadoop_dependency_coordinates:
             ingest_query_dict['hadoopDependencyCoordinates'] \
                 = self.hadoop_dependency_coordinates
diff --git a/tests/operators/test_hive_to_druid.py b/tests/operators/test_hive_to_druid.py
index 06e9596a74f26..b657e292a8bc2 100644
--- a/tests/operators/test_hive_to_druid.py
+++ b/tests/operators/test_hive_to_druid.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -47,7 +47,12 @@ class TestDruidHook(unittest.TestCase):
         'num_shards': -1,
         'target_partition_size': 1925,
         'query_granularity': 'month',
-        'segment_granularity': 'week'
+        'segment_granularity': 'week',
+        'job_properties': {
+            "mapreduce.job.user.classpath.first": "false",
+            "mapreduce.map.output.compress": "false",
+            "mapreduce.output.fileoutputformat.compress": "false"
+        }
     }
 
     index_spec_config = {
@@ -112,11 +117,7 @@ def test_construct_ingest_query(self):
                 },
                 "tuningConfig": {
                     "type": "hadoop",
-                    "jobProperties": {
-                        "mapreduce.job.user.classpath.first": "false",
-                        "mapreduce.map.output.compress": "false",
-                        "mapreduce.output.fileoutputformat.compress": "false",
-                    },
+                    "jobProperties": self.hook_config['job_properties'],
                     "partitionsSpec": {
                         "type": "hashed",
                         "targetPartitionSize": self.hook_config['target_partition_size'],

From e3ce13484fece5d6bb2b3a6c210e75a3890bb464 Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Tue, 7 Aug 2018 01:42:02 +0900
Subject: [PATCH 373/808] [AIRFLOW-2811] Fix scheduler_ops_metrics.py to work
 (#3653)

This PR fixes timezone problem in
scheduler_ops_metrics.py and makes
its timeout configurable.
---
 scripts/perf/scheduler_ops_metrics.py | 24 +++++++++++++++++++-----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/scripts/perf/scheduler_ops_metrics.py b/scripts/perf/scheduler_ops_metrics.py
index aabb2ff50e2ef..ef274d6cd233e 100644
--- a/scripts/perf/scheduler_ops_metrics.py
+++ b/scripts/perf/scheduler_ops_metrics.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from datetime import datetime
 import logging
 import pandas as pd
 import sys
@@ -25,6 +24,7 @@
 from airflow import configuration, settings
 from airflow.jobs import SchedulerJob
 from airflow.models import DagBag, DagModel, DagRun, TaskInstance
+from airflow.utils import timezone
 from airflow.utils.state import State
 
 SUBDIR = 'scripts/perf/dags'
@@ -53,7 +53,10 @@ class SchedulerMetricsJob(SchedulerJob):
     run on remote systems and spend the majority of their time on I/O wait.
 
     To Run:
-        $ python scripts/perf/scheduler_ops_metrics.py
+        $ python scripts/perf/scheduler_ops_metrics.py [timeout]
+
+    You can specify timeout in seconds as an optional parameter.
+    Its default value is 6 seconds.
     """
     __mapper_args__ = {
         'polymorphic_identity': 'SchedulerMetricsJob'
@@ -71,7 +74,7 @@ def print_stats(self):
             .filter(TI.dag_id.in_(DAG_IDS))
             .all()
         )
-        successful_tis = filter(lambda x: x.state == State.SUCCESS, tis)
+        successful_tis = [x for x in tis if x.state == State.SUCCESS]
         ti_perf = [(ti.dag_id, ti.task_id, ti.execution_date,
                     (ti.queued_dttm - self.start_date).total_seconds(),
                     (ti.start_date - self.start_date).total_seconds(),
@@ -117,11 +120,11 @@ def heartbeat(self):
         dagbag = DagBag(SUBDIR)
         dags = [dagbag.dags[dag_id] for dag_id in DAG_IDS]
         # the tasks in perf_dag_1 and per_dag_2 have a daily schedule interval.
-        num_task_instances = sum([(datetime.today() - task.start_date).days
+        num_task_instances = sum([(timezone.utcnow() - task.start_date).days
                                  for dag in dags for task in dag.tasks])
 
         if (len(successful_tis) == num_task_instances or
-                (datetime.now()-self.start_date).total_seconds() >
+                (timezone.utcnow() - self.start_date).total_seconds() >
                 MAX_RUNTIME_SECS):
             if len(successful_tis) == num_task_instances:
                 self.log.info("All tasks processed! Printing stats.")
@@ -177,6 +180,17 @@ def set_dags_paused_state(is_paused):
 
 
 def main():
+    global MAX_RUNTIME_SECS
+    if len(sys.argv) > 1:
+        try:
+            max_runtime_secs = int(sys.argv[1])
+            if max_runtime_secs < 1:
+                raise ValueError
+            MAX_RUNTIME_SECS = max_runtime_secs
+        except ValueError:
+            logging.error('Specify a positive integer for timeout.')
+            sys.exit(1)
+
     configuration.load_test_config()
 
     set_dags_paused_state(False)

From 1b4968cd7109fb09cadb216b2aa3108dd08a6357 Mon Sep 17 00:00:00 2001
From: gseva <gavrilovseva@gmail.com>
Date: Wed, 19 Dec 2018 06:48:57 -0300
Subject: [PATCH 374/808] [AIRFLOW-3246] Make hmsclient optional in
 airflow.hooks.hive_hooks (#4080)

Delay the import right up until it is needed, like how we do with the thrift imports.
---
 airflow/hooks/hive_hooks.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index e872551c4c0e2..65c46d6e54562 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -27,7 +27,6 @@
 from collections import OrderedDict
 from tempfile import NamedTemporaryFile
 
-import hmsclient
 import six
 import unicodecsv as csv
 from past.builtins import basestring

From f89bdbd8cc7ed7c429af1eeaf339e0e873945d00 Mon Sep 17 00:00:00 2001
From: Jeff Payne <jeffkpayne@gmail.com>
Date: Wed, 12 Sep 2018 14:42:13 -0700
Subject: [PATCH 375/808] [AIRFLOW-3035] Allow custom 'job_error_states' in
 dataproc ops (#3884)

---
 airflow/contrib/hooks/gcp_dataproc_hook.py    | 16 ++--
 .../contrib/operators/dataproc_operator.py    | 79 ++++++++++++++++---
 tests/contrib/hooks/test_gcp_dataproc_hook.py | 49 +++++++++++-
 .../operators/test_dataproc_operator.py       | 10 +--
 4 files changed, 126 insertions(+), 28 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index aaf33bc3ce36f..23bbfe9303abd 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -28,7 +28,8 @@
 
 
 class _DataProcJob(LoggingMixin):
-    def __init__(self, dataproc_api, project_id, job, region='global'):
+    def __init__(self, dataproc_api, project_id, job, region='global',
+                 job_error_states=None):
         self.dataproc_api = dataproc_api
         self.project_id = project_id
         self.region = region
@@ -37,6 +38,7 @@ def __init__(self, dataproc_api, project_id, job, region='global'):
             region=self.region,
             body=job).execute()
         self.job_id = self.job['reference']['jobId']
+        self.job_error_states = job_error_states
         self.log.info(
             'DataProc job %s is %s',
             self.job_id, str(self.job['status']['state'])
@@ -49,13 +51,11 @@ def wait_for_done(self):
                 region=self.region,
                 jobId=self.job_id).execute(num_retries=5)
             if 'ERROR' == self.job['status']['state']:
-                print(str(self.job))
                 self.log.error('DataProc job %s has errors', self.job_id)
                 self.log.error(self.job['status']['details'])
                 self.log.debug(str(self.job))
                 return False
             if 'CANCELLED' == self.job['status']['state']:
-                print(str(self.job))
                 self.log.warning('DataProc job %s is cancelled', self.job_id)
                 if 'details' in self.job['status']:
                     self.log.warning(self.job['status']['details'])
@@ -78,7 +78,8 @@ def raise_error(self, message=None):
 =======
         job_state = self.job['status']['state']
         # We always consider ERROR to be an error state.
-        if (self.job_error_states and job_state in self.job_error_states) or 'ERROR' == job_state:
+        if ((self.job_error_states and job_state in self.job_error_states)
+                or 'ERROR' == job_state):
             ex_message = message or ("Google DataProc job has state: %s" % job_state)
             ex_details = (str(self.job['status']['details'])
                           if 'details' in self.job['status']
@@ -227,10 +228,11 @@ def get_cluster(self, project_id, region, cluster_name):
             clusterName=cluster_name
         ).execute(num_retries=5)
 
-    def submit(self, project_id, job, region='global'):
-        submitted = _DataProcJob(self.get_conn(), project_id, job, region)
+    def submit(self, project_id, job, region='global', job_error_states=None):
+        submitted = _DataProcJob(self.get_conn(), project_id, job, region,
+                                 job_error_states=job_error_states)
         if not submitted.wait_for_done():
-            submitted.raise_error('DataProcTask has errors')
+            submitted.raise_error()
 
     def create_job_template(self, task_id, cluster_name, job_type, properties):
         return _DataProcJobBuilder(self.project_id, task_id, cluster_name,
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index f8b515961115c..441b86fa268b6 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -717,7 +717,14 @@ class DataProcPigOperator(BaseOperator):
         delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -741,6 +748,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -755,6 +763,7 @@ def __init__(
         self.dataproc_properties = dataproc_pig_properties
         self.dataproc_jars = dataproc_pig_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(gcp_conn_id=self.gcp_conn_id,
@@ -773,7 +782,7 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataProcHiveOperator(BaseOperator):
@@ -805,7 +814,14 @@ class DataProcHiveOperator(BaseOperator):
         delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -829,6 +845,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -843,6 +860,7 @@ def __init__(
         self.dataproc_properties = dataproc_hive_properties
         self.dataproc_jars = dataproc_hive_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(gcp_conn_id=self.gcp_conn_id,
@@ -862,7 +880,7 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataProcSparkSqlOperator(BaseOperator):
@@ -895,7 +913,14 @@ class DataProcSparkSqlOperator(BaseOperator):
         delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -919,6 +944,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -933,6 +959,7 @@ def __init__(
         self.dataproc_properties = dataproc_spark_properties
         self.dataproc_jars = dataproc_spark_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(gcp_conn_id=self.gcp_conn_id,
@@ -952,7 +979,7 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataProcSparkOperator(BaseOperator):
@@ -992,7 +1019,14 @@ class DataProcSparkOperator(BaseOperator):
         delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -1018,6 +1052,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -1034,6 +1069,7 @@ def __init__(
         self.dataproc_properties = dataproc_spark_properties
         self.dataproc_jars = dataproc_spark_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(gcp_conn_id=self.gcp_conn_id,
@@ -1051,7 +1087,7 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataProcHadoopOperator(BaseOperator):
@@ -1091,7 +1127,14 @@ class DataProcHadoopOperator(BaseOperator):
         delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -1117,6 +1160,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -1133,6 +1177,7 @@ def __init__(
         self.dataproc_properties = dataproc_hadoop_properties
         self.dataproc_jars = dataproc_hadoop_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(gcp_conn_id=self.gcp_conn_id,
@@ -1150,11 +1195,10 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataProcPySparkOperator(BaseOperator):
-    # TODO Add docs around dataproc_job_id.
     """
     Start a PySpark Job on a Cloud DataProc cluster.
 
@@ -1191,7 +1235,14 @@ class DataProcPySparkOperator(BaseOperator):
         domain-wide delegation enabled.
     :type delegate_to: string
     :param region: The specified region where the dataproc cluster is created.
-    :type region: string
+    :type region: str
+    :param job_error_states: Job states that should be considered error states.
+        Any states in this list will result in an error being raised and failure of the
+        task. Eg, if the ``CANCELLED`` state should also be considered a task failure,
+        pass in ``['ERROR', 'CANCELLED']``. Possible values are currently only
+        ``'ERROR'`` and ``'CANCELLED'``, but could change in the future. Defaults to
+        ``['ERROR']``.
+    :type job_error_states: list
     :var dataproc_job_id: The actual "jobId" as submitted to the Dataproc API.
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
@@ -1244,6 +1295,7 @@ def __init__(
             gcp_conn_id='google_cloud_default',
             delegate_to=None,
             region='global',
+            job_error_states=['ERROR'],
             *args,
             **kwargs):
 
@@ -1260,6 +1312,7 @@ def __init__(
         self.dataproc_properties = dataproc_pyspark_properties
         self.dataproc_jars = dataproc_pyspark_jars
         self.region = region
+        self.job_error_states = job_error_states
 
     def execute(self, context):
         hook = DataProcHook(
@@ -1290,7 +1343,7 @@ def execute(self, context):
         job_to_submit = job.build()
         self.dataproc_job_id = job_to_submit["job"]["reference"]["jobId"]
 
-        hook.submit(hook.project_id, job_to_submit, self.region)
+        hook.submit(hook.project_id, job_to_submit, self.region, self.job_error_states)
 
 
 class DataprocWorkflowTemplateBaseOperator(BaseOperator):
diff --git a/tests/contrib/hooks/test_gcp_dataproc_hook.py b/tests/contrib/hooks/test_gcp_dataproc_hook.py
index f2629ff148ce1..b5084549ee7b3 100644
--- a/tests/contrib/hooks/test_gcp_dataproc_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataproc_hook.py
@@ -19,6 +19,7 @@
 #
 
 import unittest
+from airflow.contrib.hooks.gcp_dataproc_hook import _DataProcJob
 from airflow.contrib.hooks.gcp_dataproc_hook import DataProcHook
 
 try:
@@ -48,6 +49,48 @@ def setUp(self):
 
     @mock.patch(DATAPROC_STRING.format('_DataProcJob'))
     def test_submit(self, job_mock):
-      with mock.patch(DATAPROC_STRING.format('DataProcHook.get_conn', return_value=None)):
-        self.dataproc_hook.submit(PROJECT_ID, JOB)
-        job_mock.assert_called_once_with(mock.ANY, PROJECT_ID, JOB, REGION)
+        with mock.patch(DATAPROC_STRING.format('DataProcHook.get_conn',
+                                               return_value=None)):
+            self.dataproc_hook.submit(PROJECT_ID, JOB)
+            job_mock.assert_called_once_with(mock.ANY, PROJECT_ID, JOB, REGION,
+                                             job_error_states=mock.ANY)
+
+
+class DataProcJobTest(unittest.TestCase):
+    @mock.patch(DATAPROC_STRING.format('_DataProcJob.__init__'), return_value=None)
+    def test_raise_error_default_job_error_states(self, mock_init):
+        job = _DataProcJob()
+        job.job = {'status': {'state': 'ERROR'}}
+        job.job_error_states = None
+        with self.assertRaises(Exception) as cm:
+            job.raise_error()
+        self.assertIn('ERROR', str(cm.exception))
+
+    @mock.patch(DATAPROC_STRING.format('_DataProcJob.__init__'), return_value=None)
+    def test_raise_error_custom_job_error_states(self, mock_init):
+        job = _DataProcJob()
+        job.job = {'status': {'state': 'CANCELLED'}}
+        job.job_error_states = ['ERROR', 'CANCELLED']
+        with self.assertRaises(Exception) as cm:
+            job.raise_error()
+        self.assertIn('CANCELLED', str(cm.exception))
+
+    @mock.patch(DATAPROC_STRING.format('_DataProcJob.__init__'), return_value=None)
+    def test_raise_error_fallback_job_error_states(self, mock_init):
+        job = _DataProcJob()
+        job.job = {'status': {'state': 'ERROR'}}
+        job.job_error_states = ['CANCELLED']
+        with self.assertRaises(Exception) as cm:
+            job.raise_error()
+        self.assertIn('ERROR', str(cm.exception))
+
+    @mock.patch(DATAPROC_STRING.format('_DataProcJob.__init__'), return_value=None)
+    def test_raise_error_with_state_done(self, mock_init):
+        job = _DataProcJob()
+        job.job = {'status': {'state': 'DONE'}}
+        job.job_error_states = None
+        try:
+            job.raise_error()
+            # Pass test
+        except Exception:
+            self.fail("raise_error() should not raise Exception when job=%s" % job.job)
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 2a5226e811d04..219d7255ffaca 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -486,7 +486,7 @@ def test_cluster_name_log_no_sub(self):
                 dag=self.dag
             )
             with patch.object(dataproc_task.log, 'info') as mock_info:
-                with self.assertRaises(TypeError) as _:
+                with self.assertRaises(TypeError):
                     dataproc_task.execute(None)
                 mock_info.assert_called_with('Deleting cluster: %s', CLUSTER_NAME)
 
@@ -525,7 +525,7 @@ def test_hook_correct_region():
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION)
+                                                                  REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -549,7 +549,7 @@ def test_hook_correct_region():
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION)
+                                                                  REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -574,7 +574,7 @@ def test_hook_correct_region():
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION)
+                                                                  REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -599,7 +599,7 @@ def test_hook_correct_region():
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION)
+                                                                  REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():

From 5d96c1d660725182047c4e8d6121e8a8e9a6c463 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Tue, 8 Jan 2019 01:50:49 +0000
Subject: [PATCH 376/808] [AIRFLOW-XXX] Fix flake8 issues

---
 .github/PULL_REQUEST_TEMPLATE.md                       |  4 ----
 airflow/contrib/hooks/gcp_dataproc_hook.py             | 10 +---------
 airflow/utils/helpers.py                               |  3 +++
 airflow/www_rbac/views.py                              |  1 -
 tests/contrib/executors/test_kubernetes_executor.py    |  3 ++-
 tests/contrib/hooks/test_gcp_dataflow_hook.py          |  1 -
 tests/contrib/hooks/test_gcp_dataproc_hook.py          |  6 ++++--
 .../contrib/operators/test_postgres_to_gcs_operator.py |  4 ++--
 tests/executors/dask_executor.py                       |  4 ++--
 tests/executors/test_celery_executor.py                |  4 ++--
 tests/executors/test_local_executor.py                 |  4 ++--
 tests/operators/operators.py                           |  2 +-
 tests/sensors/test_sql_sensor.py                       | 10 +---------
 tests/task/task_runner/test_bash_task_runner.py        |  4 ++--
 tox.ini                                                |  7 -------
 15 files changed, 22 insertions(+), 45 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 62929155afb01..539ca28fca423 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -29,9 +29,5 @@ Make sure you have checked _all_ steps below.
     - When adding new operators/hooks/sensors, the autoclass documentation generation needs to be added.
 
 
-<<<<<<< HEAD
 ### Code Quality
-- [ ] Passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
-=======
 - [ ] Passes `flake8`
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index 23bbfe9303abd..98282f728a430 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -70,22 +70,14 @@ def wait_for_done(self):
             time.sleep(5)
 
     def raise_error(self, message=None):
-<<<<<<< HEAD
-        if 'ERROR' == self.job['status']['state']:
-            if message is None:
-                message = "Google DataProc job has error"
-            raise Exception(message + ": " + str(self.job['status']['details']))
-=======
         job_state = self.job['status']['state']
         # We always consider ERROR to be an error state.
-        if ((self.job_error_states and job_state in self.job_error_states)
-                or 'ERROR' == job_state):
+        if (self.job_error_states and job_state in self.job_error_states) or 'ERROR' == job_state:
             ex_message = message or ("Google DataProc job has state: %s" % job_state)
             ex_details = (str(self.job['status']['details'])
                           if 'details' in self.job['status']
                           else "No details available")
             raise Exception(ex_message + ": " + ex_details)
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
 
     def get(self):
         return self.job
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index ff513561df314..167168fb9f122 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -23,6 +23,9 @@
 from __future__ import unicode_literals
 
 import errno
+import imp
+import sys
+import warnings
 
 import psutil
 
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 276f4fae20e5c..c916941112df2 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -41,7 +41,6 @@
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
 from flask_appbuilder.models.sqla.filters import BaseFilter
-from flask_appbuilder.models.sqla.interface import SQLAInterface
 from flask_babel import lazy_gettext
 from past.builtins import unicode
 from pygments import highlight, lexers
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index f4c48665d2597..87e583b6d38c7 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -319,7 +319,8 @@ def test_worker_git_dags(self):
         self.assertTrue(dag_volume_mount[0]['readOnly'])
 
         init_container = worker_config._get_init_containers(volume_mounts)[0]
-        init_container_volume_mount = [mount for mount in init_container['volumeMounts'] if mount['name'] == 'airflow-dags']
+        init_container_volume_mount = [mount for mount in init_container['volumeMounts']
+                                       if mount['name'] == 'airflow-dags']
 
         self.assertEqual('git-sync-clone', init_container['name'])
         self.assertEqual('gcr.io/google-containers/git-sync-amd64:v2.0.5', init_container['image'])
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 3075e8b054a81..7a02c1a33ec59 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -150,7 +150,6 @@ def test_start_java_dataflow_with_job_class(
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
-
     @mock.patch('airflow.contrib.hooks.gcp_dataflow_hook._Dataflow.log')
     @mock.patch('subprocess.Popen')
     @mock.patch('select.select')
diff --git a/tests/contrib/hooks/test_gcp_dataproc_hook.py b/tests/contrib/hooks/test_gcp_dataproc_hook.py
index b5084549ee7b3..e22b27a8e7165 100644
--- a/tests/contrib/hooks/test_gcp_dataproc_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataproc_hook.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -38,9 +38,11 @@
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
 DATAPROC_STRING = 'airflow.contrib.hooks.gcp_dataproc_hook.{}'
 
+
 def mock_init(self, gcp_conn_id, delegate_to=None):
     pass
 
+
 class DataProcHookTest(unittest.TestCase):
     def setUp(self):
         with mock.patch(BASE_STRING.format('GoogleCloudBaseHook.__init__'),
diff --git a/tests/contrib/operators/test_postgres_to_gcs_operator.py b/tests/contrib/operators/test_postgres_to_gcs_operator.py
index 608c57d503941..904f57689d4b9 100644
--- a/tests/contrib/operators/test_postgres_to_gcs_operator.py
+++ b/tests/contrib/operators/test_postgres_to_gcs_operator.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/dask_executor.py b/tests/executors/dask_executor.py
index 7937b1b8a3c95..45f25fe77ff24 100644
--- a/tests/executors/dask_executor.py
+++ b/tests/executors/dask_executor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index dd999dca2066f..0d84e2ecc2e62 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/executors/test_local_executor.py b/tests/executors/test_local_executor.py
index 33cfbc4a6ba14..2c6b4f90f5c46 100644
--- a/tests/executors/test_local_executor.py
+++ b/tests/executors/test_local_executor.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tests/operators/operators.py b/tests/operators/operators.py
index 9f320a13dee0e..341534bf3464a 100644
--- a/tests/operators/operators.py
+++ b/tests/operators/operators.py
@@ -312,7 +312,7 @@ def test_mysql_to_hive_tblproperties(self):
             hive_table='test_mysql_to_hive',
             recreate=True,
             delimiter=",",
-            tblproperties={'test_property':'test_value'},
+            tblproperties={'test_property': 'test_value'},
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
diff --git a/tests/sensors/test_sql_sensor.py b/tests/sensors/test_sql_sensor.py
index de990bfd10339..81bcdd1691919 100644
--- a/tests/sensors/test_sql_sensor.py
+++ b/tests/sensors/test_sql_sensor.py
@@ -16,6 +16,7 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+import mock
 import unittest
 
 from airflow import DAG
@@ -38,11 +39,8 @@ def setUp(self):
         }
         self.dag = DAG(TEST_DAG_ID, default_args=args)
 
-<<<<<<< HEAD
-=======
     @unittest.skipUnless(
         'mysql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a mysql test")
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
     def test_sql_sensor_mysql(self):
         t = SqlSensor(
             task_id='sql_sensor_check',
@@ -52,11 +50,8 @@ def test_sql_sensor_mysql(self):
         )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
-<<<<<<< HEAD
-=======
     @unittest.skipUnless(
         'postgresql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a postgres test")
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
     def test_sql_sensor_postgres(self):
         t = SqlSensor(
             task_id='sql_sensor_check',
@@ -65,8 +60,6 @@ def test_sql_sensor_postgres(self):
             dag=self.dag
         )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
-<<<<<<< HEAD
-=======
 
     @mock.patch('airflow.sensors.sql_sensor.BaseHook')
     def test_sql_sensor_postgres_poke(self, mock_hook):
@@ -83,4 +76,3 @@ def test_sql_sensor_postgres_poke(self, mock_hook):
 
         mock_get_records.return_value = [['1']]
         self.assertTrue(t.poke(None))
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
diff --git a/tests/task/task_runner/test_bash_task_runner.py b/tests/task/task_runner/test_bash_task_runner.py
index 24c0819fdb070..1342e10945c24 100644
--- a/tests/task/task_runner/test_bash_task_runner.py
+++ b/tests/task/task_runner/test_bash_task_runner.py
@@ -7,9 +7,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
diff --git a/tox.ini b/tox.ini
index 55d19915c855e..108fe35882614 100644
--- a/tox.ini
+++ b/tox.ini
@@ -26,13 +26,6 @@ find_links =
     {homedir}/.wheelhouse
     {homedir}/.pip-cache
 
-<<<<<<< HEAD
-[flake8]
-max-line-length = 110
-ignore = E731,W503
-
-=======
->>>>>>> 0e8394fd... [AIRFLOW-3190] Make flake8 compliant (#4035)
 [testenv]
 deps =
     wheel

From 5ccf31297cbe28346a89a2e47ad03aed83cf6627 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Tue, 8 Jan 2019 10:36:52 +0100
Subject: [PATCH 377/808] [AIRFLOW-3519] Fix example http operator (#4455)

---
 airflow/example_dags/example_http_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/example_dags/example_http_operator.py b/airflow/example_dags/example_http_operator.py
index eca528e89965a..4a469795a21f7 100644
--- a/airflow/example_dags/example_http_operator.py
+++ b/airflow/example_dags/example_http_operator.py
@@ -92,7 +92,7 @@
     http_conn_id='http_default',
     endpoint='',
     request_params={},
-    response_check=lambda response: True if "Google" in response.content else False,
+    response_check=lambda response: True if "Google" in response.text else False,
     poke_interval=5,
     dag=dag,
 )

From 433e987ff0a0719d5d88a0c8215e1653bac9db81 Mon Sep 17 00:00:00 2001
From: Kengo Seki <sekikn@apache.org>
Date: Wed, 1 Aug 2018 18:07:34 +0900
Subject: [PATCH 378/808] [AIRFLOW-2829] Brush up the CI script for minikube

---
 .../ci/kubernetes/minikube/start_minikube.sh  | 23 ++++++++-----------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/scripts/ci/kubernetes/minikube/start_minikube.sh b/scripts/ci/kubernetes/minikube/start_minikube.sh
index 599d45d2d521a..9727a00acfac2 100755
--- a/scripts/ci/kubernetes/minikube/start_minikube.sh
+++ b/scripts/ci/kubernetes/minikube/start_minikube.sh
@@ -27,18 +27,17 @@ _MY_DIR=$(cd "$(dirname "$_MY_SCRIPT")" && pwd)
 _KUBERNETES_VERSION="${KUBERNETES_VERSION}"
 _MINIKUBE_VERSION="${MINIKUBE_VERSION:-v0.28.2}"
 
-echo "setting up kubernetes ${_KUBERNETES_VERSION}"
+echo "setting up kubernetes ${_KUBERNETES_VERSION}, using minikube ${_MINIKUBE_VERSION}"
 
-_MINIKUBE_VERSION="v0.26.0"
-_HELM_VERSION=v2.8.1
-_VM_DRIVER=none
+_VM_DRIVER="${VM_DRIVER:-none}"
 USE_MINIKUBE_DRIVER_NONE=true
 
 _UNAME_OUT=$(uname -s)
 case "${_UNAME_OUT}" in
     Linux*)     _MY_OS=linux;;
     Darwin*)    _MY_OS=darwin;;
-    *)          _MY_OS="UNKNOWN:${unameOut}"
+    *)          echo "${_UNAME_OUT} is unsupported."
+                exit 1;;
 esac
 echo "Local OS is ${_MY_OS}"
 
@@ -62,27 +61,25 @@ if [[ ! -x /usr/local/bin/kubectl ]]; then
   curl -Lo bin/kubectl  \
     https://storage.googleapis.com/kubernetes-release/release/${_KUBERNETES_VERSION}/bin/${_MY_OS}/amd64/kubectl
   chmod +x bin/kubectl
+  sudo mv bin/kubectl /usr/local/bin/kubectl
 fi
 if [[ ! -x /usr/local/bin/minikube ]]; then
   echo Downloading minikube.
   curl -Lo bin/minikube  \
     https://storage.googleapis.com/minikube/releases/${_MINIKUBE_VERSION}/minikube-${_MY_OS}-amd64
   chmod +x bin/minikube
+  sudo mv bin/minikube /usr/local/bin/minikube
 fi
 
-sudo mv bin/minikube /usr/local/bin/minikube
-sudo mv bin/kubectl /usr/local/bin/kubectl
-
 export PATH="${_MY_DIR}/bin:$PATH"
 
 if [[ "${USE_MINIKUBE_DRIVER_NONE:-}" = "true" ]]; then
   # Run minikube with none driver.
   # See https://blog.travis-ci.com/2017-10-26-running-kubernetes-on-travis-ci-with-minikube
-  _VM_DRIVER="--vm-driver=none"
+  _VM_DRIVER=none
   if [[ ! -x /usr/local/bin/nsenter ]]; then
     # From https://engineering.bitnami.com/articles/implementing-kubernetes-integration-tests-in-travis.html
     # Travis ubuntu trusty env doesn't have nsenter, needed for --vm-driver=none
-    which nsenter >/dev/null && return 0
     echo "INFO: Building 'nsenter' ..."
 cat <<-EOF | docker run -i --rm -v "$(pwd):/build" ubuntu:14.04 >& nsenter.build.log
         apt-get update
@@ -97,7 +94,7 @@ EOF
     if [ ! -f ./nsenter ]; then
         echo "ERROR: nsenter build failed, log:"
         cat nsenter.build.log
-        return 1
+        exit 1
     fi
     echo "INFO: nsenter build OK"
     sudo mv ./nsenter /usr/local/bin
@@ -106,10 +103,10 @@ fi
 
 echo "your path is ${PATH}"
 
-_MINIKUBE="sudo PATH=$PATH minikube"
+_MINIKUBE="sudo -E PATH=$PATH minikube"
 
 $_MINIKUBE config set bootstrapper localkube
-$_MINIKUBE start --kubernetes-version=${_KUBERNETES_VERSION}  --vm-driver=none
+$_MINIKUBE start --kubernetes-version=${_KUBERNETES_VERSION} --vm-driver=${_VM_DRIVER}
 $_MINIKUBE update-context
 
 # Wait for Kubernetes to be up and ready.

From 93a2ea74a83e6960d97e9f72a3e5e83546fca308 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Fri, 21 Sep 2018 16:37:55 +0200
Subject: [PATCH 379/808] [AIRFLOW-3076] Remove preloading of MySQL testdata
 (#3911)

One of the things for tests is being self contained. This means that
it should not depend on anything external, such as loading data.

This PR will use the setUp and tearDown to load the data into MySQL
and remove it afterwards. This removes the actual bash mysql commands
and will make it easier to dockerize the whole testsuite in the future
---
 airflow/utils/db.py              |   6 +-
 scripts/ci/4-load-data.sh        |  29 ---------
 scripts/ci/data/baby_names.csv   |  54 ----------------
 scripts/ci/data/mysql_schema.sql |  27 --------
 tests/operators/operators.py     | 103 +++++++++++++++++++++++++------
 tests/www/test_views.py          |   2 +-
 tox.ini                          |   1 -
 7 files changed, 85 insertions(+), 137 deletions(-)
 delete mode 100755 scripts/ci/4-load-data.sh
 delete mode 100644 scripts/ci/data/baby_names.csv
 delete mode 100644 scripts/ci/data/mysql_schema.sql

diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 3817375c1efea..df1814a486960 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -96,11 +96,6 @@ def initdb(rbac=False):
             conn_id='airflow_db', conn_type='mysql',
             host='mysql', login='root', password='',
             schema='airflow'))
-    merge_conn(
-        models.Connection(
-            conn_id='airflow_ci', conn_type='mysql',
-            host='mysql', login='root', extra="{\"local_infile\": true}",
-            schema='airflow_ci'))
     merge_conn(
         models.Connection(
             conn_id='beeline_default', conn_type='beeline', port="10000",
@@ -146,6 +141,7 @@ def initdb(rbac=False):
         models.Connection(
             conn_id='mysql_default', conn_type='mysql',
             login='root',
+            schema='airflow',
             host='mysql'))
     merge_conn(
         models.Connection(
diff --git a/scripts/ci/4-load-data.sh b/scripts/ci/4-load-data.sh
deleted file mode 100755
index 7935482be075e..0000000000000
--- a/scripts/ci/4-load-data.sh
+++ /dev/null
@@ -1,29 +0,0 @@
-#!/usr/bin/env bash
-#  Licensed to the Apache Software Foundation (ASF) under one   *
-#  or more contributor license agreements.  See the NOTICE file *
-#  distributed with this work for additional information        *
-#  regarding copyright ownership.  The ASF licenses this file   *
-#  to you under the Apache License, Version 2.0 (the            *
-#  "License"); you may not use this file except in compliance   *
-#  with the License.  You may obtain a copy of the License at   *
-#                                                               *
-#    http://www.apache.org/licenses/LICENSE-2.0                 *
-#                                                               *
-#  Unless required by applicable law or agreed to in writing,   *
-#  software distributed under the License is distributed on an  *
-#  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY       *
-#  KIND, either express or implied.  See the License for the    *
-#  specific language governing permissions and limitations      *
-#  under the License.                                           *
-
-set -exuo pipefail
-
-DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
-DATA_DIR="${DIR}/data"
-DATA_FILE="${DATA_DIR}/baby_names.csv"
-DATABASE=airflow_ci
-HOST=mysql
-
-mysqladmin -h ${HOST} -u root create ${DATABASE}
-mysql -h ${HOST} -u root < ${DATA_DIR}/mysql_schema.sql
-mysqlimport --local -h ${HOST} -u root --fields-optionally-enclosed-by="\"" --fields-terminated-by=, --ignore-lines=1 ${DATABASE} ${DATA_FILE}
diff --git a/scripts/ci/data/baby_names.csv b/scripts/ci/data/baby_names.csv
deleted file mode 100644
index b0ee22951e1ee..0000000000000
--- a/scripts/ci/data/baby_names.csv
+++ /dev/null
@@ -1,54 +0,0 @@
-"year","name","percent","sex"
-1880,"John",0.081541,"boy"
-1880,"William",0.080511,"boy"
-1880,"James",0.050057,"boy"
-1880,"Charles",0.045167,"boy"
-1880,"George",0.043292,"boy"
-1880,"Frank",0.02738,"boy"
-1880,"Joseph",0.022229,"boy"
-1880,"Thomas",0.021401,"boy"
-1880,"Henry",0.020641,"boy"
-1880,"Robert",0.020404,"boy"
-1880,"Edward",0.019965,"boy"
-1880,"Harry",0.018175,"boy"
-1880,"Walter",0.014822,"boy"
-1880,"Arthur",0.013504,"boy"
-1880,"Fred",0.013251,"boy"
-1880,"Albert",0.012609,"boy"
-1880,"Samuel",0.008648,"boy"
-1880,"David",0.007339,"boy"
-1880,"Louis",0.006993,"boy"
-1880,"Joe",0.006174,"boy"
-1880,"Charlie",0.006165,"boy"
-1880,"Clarence",0.006165,"boy"
-1880,"Richard",0.006148,"boy"
-1880,"Andrew",0.005439,"boy"
-1880,"Daniel",0.00543,"boy"
-1880,"Ernest",0.005194,"boy"
-1880,"Will",0.004966,"boy"
-1880,"Jesse",0.004805,"boy"
-1880,"Oscar",0.004594,"boy"
-1880,"Lewis",0.004366,"boy"
-1880,"Peter",0.004189,"boy"
-1880,"Benjamin",0.004138,"boy"
-1880,"Frederick",0.004079,"boy"
-1880,"Willie",0.00402,"boy"
-1880,"Alfred",0.003961,"boy"
-1880,"Sam",0.00386,"boy"
-1880,"Roy",0.003716,"boy"
-1880,"Herbert",0.003581,"boy"
-1880,"Jacob",0.003412,"boy"
-1880,"Tom",0.00337,"boy"
-1880,"Elmer",0.00315,"boy"
-1880,"Carl",0.003142,"boy"
-1880,"Lee",0.003049,"boy"
-1880,"Howard",0.003015,"boy"
-1880,"Martin",0.003015,"boy"
-1880,"Michael",0.00299,"boy"
-1880,"Bert",0.002939,"boy"
-1880,"Herman",0.002931,"boy"
-1880,"Jim",0.002914,"boy"
-1880,"Francis",0.002905,"boy"
-1880,"Harvey",0.002905,"boy"
-1880,"Earl",0.002829,"boy"
-1880,"Eugene",0.00277,"boy"
\ No newline at end of file
diff --git a/scripts/ci/data/mysql_schema.sql b/scripts/ci/data/mysql_schema.sql
deleted file mode 100644
index c2c60729d1468..0000000000000
--- a/scripts/ci/data/mysql_schema.sql
+++ /dev/null
@@ -1,27 +0,0 @@
-/**
-* Licensed to the Apache Software Foundation (ASF) under one
-* or more contributor license agreements. See the NOTICE file
-* distributed with this work for additional information
-* regarding copyright ownership. The ASF licenses this file
-* to you under the Apache License, Version 2.0 (the
-* "License"); you may not use this file except in compliance
-* with the License. You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing,
-* software distributed under the License is distributed on an
-* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-* KIND, either express or implied. See the License for the
-* specific language governing permissions and limitations
-* under the License.
-*/
-
-USE airflow_ci;
-
-CREATE TABLE IF NOT EXISTS baby_names (
-  org_year integer(4),
-  baby_name VARCHAR(25),
-  rate FLOAT(7,6),
-  sex VARCHAR(4)
-)
\ No newline at end of file
diff --git a/tests/operators/operators.py b/tests/operators/operators.py
index 341534bf3464a..d3bbe77f95476 100644
--- a/tests/operators/operators.py
+++ b/tests/operators/operators.py
@@ -20,7 +20,6 @@
 from __future__ import print_function
 
 from airflow import DAG, configuration, operators
-from airflow.utils.tests import skipUnlessImported
 from airflow.utils import timezone
 
 from collections import OrderedDict
@@ -37,13 +36,11 @@
 TEST_DAG_ID = 'unit_test_dag'
 
 
-@skipUnlessImported('airflow.operators.mysql_operator', 'MySqlOperator')
 class MySqlTest(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         args = {
             'owner': 'airflow',
-            'mysql_conn_id': 'airflow_db',
             'start_date': DEFAULT_DATE
         }
         dag = DAG(TEST_DAG_ID, default_args=args)
@@ -59,7 +56,6 @@ def test_mysql_operator_test(self):
         t = MySqlOperator(
             task_id='basic_mysql',
             sql=sql,
-            mysql_conn_id='airflow_db',
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
@@ -71,8 +67,9 @@ def test_mysql_operator_test_multi(self):
         from airflow.operators.mysql_operator import MySqlOperator
         t = MySqlOperator(
             task_id='mysql_operator_test_multi',
-            mysql_conn_id='airflow_db',
-            sql=sql, dag=self.dag)
+            sql=sql,
+            dag=self.dag,
+        )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
     def test_mysql_hook_test_bulk_load(self):
@@ -84,7 +81,7 @@ def test_mysql_hook_test_bulk_load(self):
             t.flush()
 
             from airflow.hooks.mysql_hook import MySqlHook
-            h = MySqlHook('airflow_ci')
+            h = MySqlHook('airflow_db')
             with h.get_conn() as c:
                 c.execute("""
                     CREATE TABLE IF NOT EXISTS test_airflow (
@@ -99,7 +96,7 @@ def test_mysql_hook_test_bulk_load(self):
 
     def test_mysql_hook_test_bulk_dump(self):
         from airflow.hooks.mysql_hook import MySqlHook
-        hook = MySqlHook('airflow_ci')
+        hook = MySqlHook('airflow_db')
         priv = hook.get_first("SELECT @@global.secure_file_priv")
         if priv and priv[0]:
             # Confirm that no error occurs
@@ -114,7 +111,7 @@ def test_mysql_hook_test_bulk_dump_mock(self, mock_get_conn):
         mock_get_conn.return_value.cursor.return_value.execute = mock_execute
 
         from airflow.hooks.mysql_hook import MySqlHook
-        hook = MySqlHook('airflow_ci')
+        hook = MySqlHook('airflow_db')
         table = "INFORMATION_SCHEMA.TABLES"
         tmp_file = "/path/to/output/file"
         hook.bulk_dump(table, tmp_file)
@@ -166,7 +163,6 @@ def test_overwrite_schema(self):
             assert "Unknown database 'foobar'" in str(e)
 
 
-@skipUnlessImported('airflow.operators.postgres_operator', 'PostgresOperator')
 class PostgresTest(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
@@ -258,7 +254,6 @@ def test_overwrite_schema(self):
             assert 'database "foobar" does not exist' in str(e)
 
 
-@skipUnlessImported('airflow.operators.mysql_to_hive', 'MySqlToHiveTransfer')
 class TransferTests(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
@@ -266,6 +261,81 @@ def setUp(self):
         dag = DAG(TEST_DAG_ID, default_args=args)
         self.dag = dag
 
+        rows = [
+            (1880, "John", 0.081541, "boy"),
+            (1880, "William", 0.080511, "boy"),
+            (1880, "James", 0.050057, "boy"),
+            (1880, "Charles", 0.045167, "boy"),
+            (1880, "George", 0.043292, "boy"),
+            (1880, "Frank", 0.02738, "boy"),
+            (1880, "Joseph", 0.022229, "boy"),
+            (1880, "Thomas", 0.021401, "boy"),
+            (1880, "Henry", 0.020641, "boy"),
+            (1880, "Robert", 0.020404, "boy"),
+            (1880, "Edward", 0.019965, "boy"),
+            (1880, "Harry", 0.018175, "boy"),
+            (1880, "Walter", 0.014822, "boy"),
+            (1880, "Arthur", 0.013504, "boy"),
+            (1880, "Fred", 0.013251, "boy"),
+            (1880, "Albert", 0.012609, "boy"),
+            (1880, "Samuel", 0.008648, "boy"),
+            (1880, "David", 0.007339, "boy"),
+            (1880, "Louis", 0.006993, "boy"),
+            (1880, "Joe", 0.006174, "boy"),
+            (1880, "Charlie", 0.006165, "boy"),
+            (1880, "Clarence", 0.006165, "boy"),
+            (1880, "Richard", 0.006148, "boy"),
+            (1880, "Andrew", 0.005439, "boy"),
+            (1880, "Daniel", 0.00543, "boy"),
+            (1880, "Ernest", 0.005194, "boy"),
+            (1880, "Will", 0.004966, "boy"),
+            (1880, "Jesse", 0.004805, "boy"),
+            (1880, "Oscar", 0.004594, "boy"),
+            (1880, "Lewis", 0.004366, "boy"),
+            (1880, "Peter", 0.004189, "boy"),
+            (1880, "Benjamin", 0.004138, "boy"),
+            (1880, "Frederick", 0.004079, "boy"),
+            (1880, "Willie", 0.00402, "boy"),
+            (1880, "Alfred", 0.003961, "boy"),
+            (1880, "Sam", 0.00386, "boy"),
+            (1880, "Roy", 0.003716, "boy"),
+            (1880, "Herbert", 0.003581, "boy"),
+            (1880, "Jacob", 0.003412, "boy"),
+            (1880, "Tom", 0.00337, "boy"),
+            (1880, "Elmer", 0.00315, "boy"),
+            (1880, "Carl", 0.003142, "boy"),
+            (1880, "Lee", 0.003049, "boy"),
+            (1880, "Howard", 0.003015, "boy"),
+            (1880, "Martin", 0.003015, "boy"),
+            (1880, "Michael", 0.00299, "boy"),
+            (1880, "Bert", 0.002939, "boy"),
+            (1880, "Herman", 0.002931, "boy"),
+            (1880, "Jim", 0.002914, "boy"),
+            (1880, "Francis", 0.002905, "boy"),
+            (1880, "Harvey", 0.002905, "boy"),
+            (1880, "Earl", 0.002829, "boy"),
+            (1880, "Eugene", 0.00277, "boy"),
+        ]
+
+        from airflow.hooks.mysql_hook import MySqlHook
+        with MySqlHook().get_conn() as cur:
+            cur.execute('''
+            CREATE TABLE IF NOT EXISTS baby_names (
+              org_year integer(4),
+              baby_name VARCHAR(25),
+              rate FLOAT(7,6),
+              sex VARCHAR(4)
+            )
+            ''')
+
+        for row in rows:
+            cur.execute("INSERT INTO baby_names VALUES(%s, %s, %s, %s);", row)
+
+    def tearDown(self):
+        from airflow.hooks.mysql_hook import MySqlHook
+        with MySqlHook().get_conn() as cur:
+            cur.execute("DROP TABLE IF EXISTS baby_names CASCADE;")
+
     def test_clear(self):
         self.dag.clear(
             start_date=DEFAULT_DATE,
@@ -276,7 +346,6 @@ def test_mysql_to_hive(self):
         sql = "SELECT * FROM baby_names LIMIT 1000;"
         t = MySqlToHiveTransfer(
             task_id='test_m2h',
-            mysql_conn_id='airflow_ci',
             hive_cli_conn_id='beeline_default',
             sql=sql,
             hive_table='test_mysql_to_hive',
@@ -290,7 +359,6 @@ def test_mysql_to_hive_partition(self):
         sql = "SELECT * FROM baby_names LIMIT 1000;"
         t = MySqlToHiveTransfer(
             task_id='test_m2h',
-            mysql_conn_id='airflow_ci',
             hive_cli_conn_id='beeline_default',
             sql=sql,
             hive_table='test_mysql_to_hive_part',
@@ -306,7 +374,6 @@ def test_mysql_to_hive_tblproperties(self):
         sql = "SELECT * FROM baby_names LIMIT 1000;"
         t = MySqlToHiveTransfer(
             task_id='test_m2h',
-            mysql_conn_id='airflow_ci',
             hive_cli_conn_id='beeline_default',
             sql=sql,
             hive_table='test_mysql_to_hive',
@@ -318,11 +385,10 @@ def test_mysql_to_hive_tblproperties(self):
 
     @mock.patch('airflow.hooks.hive_hooks.HiveCliHook.load_file')
     def test_mysql_to_hive_type_conversion(self, mock_load_file):
-        mysql_conn_id = 'airflow_ci'
         mysql_table = 'test_mysql_to_hive'
 
         from airflow.hooks.mysql_hook import MySqlHook
-        m = MySqlHook(mysql_conn_id)
+        m = MySqlHook()
 
         try:
             with m.get_conn() as c:
@@ -341,7 +407,6 @@ def test_mysql_to_hive_type_conversion(self, mock_load_file):
             from airflow.operators.mysql_to_hive import MySqlToHiveTransfer
             t = MySqlToHiveTransfer(
                 task_id='test_m2h',
-                mysql_conn_id=mysql_conn_id,
                 hive_cli_conn_id='beeline_default',
                 sql="SELECT * FROM {}".format(mysql_table),
                 hive_table='test_mysql_to_hive',
@@ -362,12 +427,11 @@ def test_mysql_to_hive_type_conversion(self, mock_load_file):
                 c.execute("DROP TABLE IF EXISTS {}".format(mysql_table))
 
     def test_mysql_to_hive_verify_loaded_values(self):
-        mysql_conn_id = 'airflow_ci'
         mysql_table = 'test_mysql_to_hive'
         hive_table = 'test_mysql_to_hive'
 
         from airflow.hooks.mysql_hook import MySqlHook
-        m = MySqlHook(mysql_conn_id)
+        m = MySqlHook()
 
         try:
             minmax = (
@@ -408,7 +472,6 @@ def test_mysql_to_hive_verify_loaded_values(self):
             from airflow.operators.mysql_to_hive import MySqlToHiveTransfer
             t = MySqlToHiveTransfer(
                 task_id='test_m2h',
-                mysql_conn_id=mysql_conn_id,
                 hive_cli_conn_id='beeline_default',
                 sql="SELECT * FROM {}".format(mysql_table),
                 hive_table=hive_table,
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 507b5cfced142..a0d86ac54a02a 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -67,7 +67,7 @@ def setUp(self):
         self.chart = {
             'label': 'chart',
             'owner': 'airflow',
-            'conn_id': 'airflow_ci',
+            'conn_id': 'airflow_db',
         }
 
     def tearDown(self):
diff --git a/tox.ini b/tox.ini
index 108fe35882614..c87248b50024d 100644
--- a/tox.ini
+++ b/tox.ini
@@ -56,7 +56,6 @@ commands =
   env_docker: {toxinidir}/scripts/ci/1-setup-env.sh
   env_docker: {toxinidir}/scripts/ci/2-setup-kdc.sh
   env_docker: {toxinidir}/scripts/ci/3-setup-databases.sh
-  env_docker: {toxinidir}/scripts/ci/4-load-data.sh
   {toxinidir}/scripts/ci/5-run-tests.sh []
   {toxinidir}/scripts/ci/6-check-license.sh
   codecov -e TOXENV

From f027d603d265d90588e89149f5f0bda66fbe6447 Mon Sep 17 00:00:00 2001
From: dima-asana <42555784+dima-asana@users.noreply.github.com>
Date: Thu, 11 Oct 2018 01:55:15 -0700
Subject: [PATCH 380/808] [AIRFLOW-3168] More resillient database use in CI
 (#4014)

---
 scripts/ci/{3-setup-databases.sh => 3-setup-mysql.sh} | 9 ++++++++-
 scripts/ci/airflow_travis.cfg                         | 4 ++--
 tests/configuration.py                                | 5 +++++
 tests/executors/test_celery_executor.py               | 5 +++++
 tox.ini                                               | 4 +++-
 5 files changed, 23 insertions(+), 4 deletions(-)
 rename scripts/ci/{3-setup-databases.sh => 3-setup-mysql.sh} (79%)

diff --git a/scripts/ci/3-setup-databases.sh b/scripts/ci/3-setup-mysql.sh
similarity index 79%
rename from scripts/ci/3-setup-databases.sh
rename to scripts/ci/3-setup-mysql.sh
index 2a5cb682e0119..ca5c1aa9f1b84 100755
--- a/scripts/ci/3-setup-databases.sh
+++ b/scripts/ci/3-setup-mysql.sh
@@ -20,4 +20,11 @@ set -exuo pipefail
 
 MYSQL_HOST=mysql
 
-mysql -h ${MYSQL_HOST} -u root -e 'drop database if exists airflow; create database airflow'
+retries=3
+for ((i=0; i<retries; i++)); do
+    mysql -h ${MYSQL_HOST} -u root -e 'drop database if exists airflow; create database airflow' && exit 0
+    echo "mysql db creation did not succeed, waiting 5 seconds to retry"
+    sleep 5
+done
+
+echo "mysql db creation could not succeed" && exit 1
diff --git a/scripts/ci/airflow_travis.cfg b/scripts/ci/airflow_travis.cfg
index 31e8586c4cc15..9a0c6184cef1b 100644
--- a/scripts/ci/airflow_travis.cfg
+++ b/scripts/ci/airflow_travis.cfg
@@ -21,7 +21,7 @@ airflow_home = ~/airflow
 dags_folder = ~/airflow/dags
 base_log_folder = ~/airflow/logs
 executor = LocalExecutor
-sql_alchemy_conn = mysql://root@mysql/airflow
+sql_alchemy_conn = # overridden by tox.ini
 unit_test_mode = True
 load_examples = True
 donot_pickle = False
@@ -56,7 +56,7 @@ celery_app_name = airflow.executors.celery_executor
 worker_concurrency = 16
 worker_log_server_port = 8793
 broker_url = amqp://guest:guest@rabbitmq:5672/
-result_backend = db+mysql://root@mysql/airflow
+result_backend = # overridden by tox.ini
 flower_port = 5555
 default_queue = default
 
diff --git a/tests/configuration.py b/tests/configuration.py
index 027a51d893657..acebd5732c3df 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -221,4 +221,9 @@ def test_deprecated_options_cmd(self):
         conf.set('celery', 'celery_result_backend_cmd', '/bin/echo 99')
 
         with self.assertWarns(DeprecationWarning):
+            tmp = None
+            if 'AIRFLOW__CELERY__RESULT_BACKEND' in os.environ:
+                tmp = os.environ.pop('AIRFLOW__CELERY__RESULT_BACKEND')
             self.assertEquals(conf.getint('celery', 'result_backend'), 99)
+            if tmp:
+                os.environ['AIRFLOW__CELERY__RESULT_BACKEND'] = tmp
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 0d84e2ecc2e62..8a06e1560266f 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -24,11 +24,16 @@
 from airflow.executors.celery_executor import app
 from airflow.utils.state import State
 
+from airflow import configuration
+configuration.load_test_config()
+
 # leave this it is used by the test worker
 import celery.contrib.testing.tasks  # noqa: F401
 
 
 class CeleryExecutorTest(unittest.TestCase):
+    @unittest.skipIf('sqlite' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                     "sqlite is configured with SequentialExecutor")
     def test_celery_integration(self):
         executor = CeleryExecutor()
         executor.start()
diff --git a/tox.ini b/tox.ini
index c87248b50024d..bc0d4b78f74cd 100644
--- a/tox.ini
+++ b/tox.ini
@@ -44,7 +44,9 @@ setenv =
   KRB5_CONFIG=/etc/krb5.conf
   KRB5_KTNAME=/etc/airflow.keytab
   backend_mysql: AIRFLOW__CORE__SQL_ALCHEMY_CONN=mysql://root@mysql/airflow
+  backend_mysql: AIRFLOW__CELERY__RESULT_BACKEND=db+mysql://root@mysql/airflow
   backend_postgres: AIRFLOW__CORE__SQL_ALCHEMY_CONN=postgresql+psycopg2://postgres:airflow@postgres/airflow
+  backend_postgres: AIRFLOW__CELERY__RESULT_BACKEND=db+postgresql://postgres:airflow@postgres/airflow
   backend_sqlite: AIRFLOW__CORE__SQL_ALCHEMY_CONN=sqlite:///{homedir}/airflow.db
   backend_sqlite: AIRFLOW__CORE__EXECUTOR=SequentialExecutor
 
@@ -55,7 +57,7 @@ commands =
   pip install --progress-bar off --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
   env_docker: {toxinidir}/scripts/ci/1-setup-env.sh
   env_docker: {toxinidir}/scripts/ci/2-setup-kdc.sh
-  env_docker: {toxinidir}/scripts/ci/3-setup-databases.sh
+  backend_mysql: {toxinidir}/scripts/ci/3-setup-mysql.sh
   {toxinidir}/scripts/ci/5-run-tests.sh []
   {toxinidir}/scripts/ci/6-check-license.sh
   codecov -e TOXENV

From 47145e860afd6e491f5ef8839a50fd7ef4b8275e Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Thu, 4 Oct 2018 03:20:24 -0400
Subject: [PATCH 381/808] [AIRFLOW-3103][AIRFLOW-3147] Update flask-appbuilder
 (#3937)

---
 UPDATING.md                     | 16 ++++++++++++++++
 airflow/www_rbac/security.py    |  6 +++---
 tests/www_rbac/test_security.py |  6 +++---
 3 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 6a034fb01b43f..def4aa73b5689 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -106,6 +106,22 @@ If you want to use LDAP auth backend without TLS then you will habe to create a
 custom-auth backend based on
 https://github.com/apache/airflow/blob/1.10.0/airflow/contrib/auth/backends/ldap_auth.py
 
+### Custom auth backends interface change
+
+We have updated the version of flask-login we depend upon, and as a result any
+custom auth backends might need a small change: `is_active`,
+`is_authenticated`, and `is_anonymous` should now be properties. What this means is if
+previously you had this in your user class
+
+    def is_active(self):
+      return self.active
+
+then you need to change it like this
+
+    @property
+    def is_active(self):
+      return self.active
+
 ## Airflow 1.10
 
 Installation and upgrading requires setting `SLUGIFY_USES_TEXT_UNIDECODE=yes` in your environment or
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index c14bb4d3c83c8..5dfa319bafbae 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -195,7 +195,7 @@ def get_user_roles(self, user=None):
         """
         if user is None:
             user = g.user
-        if user.is_anonymous():
+        if user.is_anonymous:
             public_role = appbuilder.config.get('AUTH_ROLE_PUBLIC')
             return [appbuilder.security_manager.find_role(public_role)] \
                 if public_role else []
@@ -221,7 +221,7 @@ def get_accessible_dag_ids(self, username=None):
         if not username:
             username = g.user
 
-        if username.is_anonymous() or 'Public' in username.roles:
+        if username.is_anonymous or 'Public' in username.roles:
             # return an empty list if the role is public
             return set()
 
@@ -245,7 +245,7 @@ def has_access(self, permission, view_name, user=None):
         """
         if not user:
             user = g.user
-        if user.is_anonymous():
+        if user.is_anonymous:
             return self.is_item_public(permission, view_name)
         return self._has_view_access(user, permission, view_name)
 
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index 67ea5b3035640..6e0b5726394da 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -109,7 +109,7 @@ def test_init_role_modelview(self):
 
     def test_get_user_roles(self):
         user = mock.MagicMock()
-        user.is_anonymous.return_value = False
+        user.is_anonymous = False
         roles = self.appbuilder.sm.find_role('Admin')
         user.roles = roles
         self.assertEqual(self.security_manager.get_user_roles(user), roles)
@@ -144,7 +144,7 @@ def test_get_accessible_dag_ids(self, mock_get_user_roles,
         self.security_manager.init_role(role_name, role_vms, role_perms)
         role = self.security_manager.find_role(role_name)
         user.roles = [role]
-        user.is_anonymous.return_value = False
+        user.is_anonymous = False
         mock_get_all_permissions_views.return_value = {('can_dag_read', 'dag_id')}
 
         mock_get_user_roles.return_value = [role]
@@ -154,7 +154,7 @@ def test_get_accessible_dag_ids(self, mock_get_user_roles,
     @mock.patch('airflow.www_rbac.security.AirflowSecurityManager._has_view_access')
     def test_has_access(self, mock_has_view_access):
         user = mock.MagicMock()
-        user.is_anonymous.return_value = False
+        user.is_anonymous = False
         mock_has_view_access.return_value = True
         self.assertTrue(self.security_manager.has_access('perm', 'view', user))
 

From 162f081b4f3bb92276ac76e056c00e9137717bd3 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Wed, 9 Jan 2019 00:10:03 +0000
Subject: [PATCH 382/808] [AIRFLOW-XXX] Remove Flake8 Diff checker

---
 scripts/ci/flake8-diff.sh | 164 --------------------------------------
 1 file changed, 164 deletions(-)
 delete mode 100755 scripts/ci/flake8-diff.sh

diff --git a/scripts/ci/flake8-diff.sh b/scripts/ci/flake8-diff.sh
deleted file mode 100755
index fcbbf8a52ffb3..0000000000000
--- a/scripts/ci/flake8-diff.sh
+++ /dev/null
@@ -1,164 +0,0 @@
-#!/usr/bin/env bash
-
-# Copyright (c) 2007–2017 The scikit-learn developers.
-# All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1. Redistributions of source code must retain the above copyright notice, this
-#    list of conditions and the following disclaimer.
-# 2. Redistributions in binary form must reproduce the above copyright notice,
-#    this list of conditions and the following disclaimer in the documentation
-#    and/or other materials provided with the distribution.
-# 3. Neither the name of the Scikit-learn Developers  nor the names of
-#    its contributors may be used to endorse or promote products
-#    derived from this software without specific prior written
-#    permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-# DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-# ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-# This script is used in Travis to check that PRs do not add obvious
-# flake8 violations. It relies on two things:
-#   - find common ancestor between branch and
-#     apache/airflow remote
-#   - run flake8 --diff on the diff between the branch and the common
-#     ancestor
-#
-# Additional features:
-#   - the line numbers in Travis match the local branch on the PR
-#     author machine.
-#   - ./build_tools/travis/flake8_diff.sh can be run locally for quick
-#     turn-around
-
-set -e
-# pipefail is necessary to propagate exit codes
-set -o pipefail
-
-PROJECT=apache/airflow
-PROJECT_URL=https://github.com/$PROJECT.git
-
-# Find the remote with the project name (upstream in most cases)
-REMOTE=$(git remote -v | grep $PROJECT | cut -f1 | head -1 || echo '')
-
-# Add a temporary remote if needed. For example this is necessary when
-# Travis is configured to run in a fork. In this case 'origin' is the
-# fork and not the reference repo we want to diff against.
-if [[ -z "$REMOTE" ]]; then
-    TMP_REMOTE=tmp_reference_upstream
-    REMOTE=$TMP_REMOTE
-    git remote add $REMOTE $PROJECT_URL
-fi
-
-echo "Remotes:"
-echo '--------------------------------------------------------------------------------'
-git remote --verbose
-
-# Travis does the git clone with a limited depth (50 at the time of
-# writing). This may not be enough to find the common ancestor with
-# $REMOTE/master so we unshallow the git checkout
-if [[ -a .git/shallow ]]; then
-    echo -e '\nTrying to unshallow the repo:'
-    echo '--------------------------------------------------------------------------------'
-    git fetch --unshallow
-fi
-
-if [[ "$TRAVIS" == "true" ]]; then
-    if [[ "$TRAVIS_PULL_REQUEST" == "false" ]]
-    then
-        # In main repo, using TRAVIS_COMMIT_RANGE to test the commits
-        # that were pushed into a branch
-        if [[ "$PROJECT" == "$TRAVIS_REPO_SLUG" ]]; then
-            if [[ -z "$TRAVIS_COMMIT_RANGE" ]]; then
-                echo "New branch, no commit range from Travis so passing this test by convention"
-                exit 0
-            fi
-            COMMIT_RANGE=$TRAVIS_COMMIT_RANGE
-        fi
-    else
-        # We want to fetch the code as it is in the PR branch and not
-        # the result of the merge into master. This way line numbers
-        # reported by Travis will match with the local code.
-        LOCAL_BRANCH_REF=travis_pr_$TRAVIS_PULL_REQUEST
-        # In Travis the PR target is always origin
-        git fetch origin pull/$TRAVIS_PULL_REQUEST/head:refs/$LOCAL_BRANCH_REF
-    fi
-fi
-
-# If not using the commit range from Travis we need to find the common
-# ancestor between $LOCAL_BRANCH_REF and $REMOTE/master
-if [[ -z "$COMMIT_RANGE" ]]; then
-    if [[ -z "$LOCAL_BRANCH_REF" ]]; then
-        LOCAL_BRANCH_REF=$(git rev-parse --abbrev-ref HEAD)
-    fi
-    echo -e "\nLast 2 commits in $LOCAL_BRANCH_REF:"
-    echo '--------------------------------------------------------------------------------'
-    git --no-pager log -2 $LOCAL_BRANCH_REF
-
-    REMOTE_MASTER_REF="$REMOTE/master"
-    # Make sure that $REMOTE_MASTER_REF is a valid reference
-    echo -e "\nFetching $REMOTE_MASTER_REF"
-    echo '--------------------------------------------------------------------------------'
-    git fetch $REMOTE master:refs/remotes/$REMOTE_MASTER_REF
-    LOCAL_BRANCH_SHORT_HASH=$(git rev-parse --short $LOCAL_BRANCH_REF)
-    REMOTE_MASTER_SHORT_HASH=$(git rev-parse --short $REMOTE_MASTER_REF)
-
-    COMMIT=$(git merge-base $LOCAL_BRANCH_REF $REMOTE_MASTER_REF) || \
-        echo "No common ancestor found for $(git show $LOCAL_BRANCH_REF -q) and $(git show $REMOTE_MASTER_REF -q)"
-
-    if [ -z "$COMMIT" ]; then
-        exit 1
-    fi
-
-    COMMIT_SHORT_HASH=$(git rev-parse --short $COMMIT)
-
-    echo -e "\nCommon ancestor between $LOCAL_BRANCH_REF ($LOCAL_BRANCH_SHORT_HASH)"\
-         "and $REMOTE_MASTER_REF ($REMOTE_MASTER_SHORT_HASH) is $COMMIT_SHORT_HASH:"
-    echo '--------------------------------------------------------------------------------'
-    git --no-pager show --no-patch $COMMIT_SHORT_HASH
-
-    COMMIT_RANGE="$COMMIT_SHORT_HASH..$LOCAL_BRANCH_SHORT_HASH"
-
-    if [[ -n "$TMP_REMOTE" ]]; then
-        git remote remove $TMP_REMOTE
-    fi
-
-else
-    echo "Got the commit range from Travis: $COMMIT_RANGE"
-fi
-
-echo -e '\nRunning flake8 on the diff in the range' "$COMMIT_RANGE" \
-     "($(git rev-list $COMMIT_RANGE | wc -l) commit(s)):"
-echo '--------------------------------------------------------------------------------'
-
-MODIFIED_FILES="$(git diff --name-only $COMMIT_RANGE || echo "no_match")"
-
-check_files() {
-    files="$1"
-    shift
-    options="$*"
-    if [ -n "$files" ]; then
-        # Conservative approach: diff without context (--unified=0) so that code
-        # that was not changed does not create failures
-        git diff --unified=0 $COMMIT_RANGE -- $files | flake8 --diff --show-source $options
-    fi
-}
-
-if [[ "$MODIFIED_FILES" == "no_match" ]]; then
-    echo "No file outside ignored locations has been modified"
-else
-
-    check_files "$(echo "$MODIFIED_FILES" | grep -v ^examples)"
-    check_files "$(echo "$MODIFIED_FILES" | grep ^examples)" \
-        --config ./examples/.flake8
-fi
-echo -e "No problem detected by flake8\n"

From 4ae9ed5720d287abe2f709bbcb9183e3692e9639 Mon Sep 17 00:00:00 2001
From: dima-asana <42555784+dima-asana@users.noreply.github.com>
Date: Fri, 12 Oct 2018 00:14:47 -0700
Subject: [PATCH 383/808] [AIRFLOW-1837] Respect task start_date when different
 from dag's (#4010)

---
 tests/core.py                | 4 ++--
 tests/www_rbac/test_views.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/core.py b/tests/core.py
index a591f05139afa..f0c25dd898fd1 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -2078,14 +2078,14 @@ def test_dag_view_task_with_python_operator_using_partial(self):
         response = self.app.get(
             '/admin/airflow/task?'
             'task_id=test_dagrun_functool_partial&dag_id=test_task_view_type_check&'
-            'execution_date={}'.format(DEFAULT_DATE_DS))
+            'execution_date={}'.format(EXAMPLE_DAG_DEFAULT_DATE))
         self.assertIn("A function with two args", response.data.decode('utf-8'))
 
     def test_dag_view_task_with_python_operator_using_instance(self):
         response = self.app.get(
             '/admin/airflow/task?'
             'task_id=test_dagrun_instance&dag_id=test_task_view_type_check&'
-            'execution_date={}'.format(DEFAULT_DATE_DS))
+            'execution_date={}'.format(EXAMPLE_DAG_DEFAULT_DATE))
         self.assertIn("A __call__ method", response.data.decode('utf-8'))
 
     def tearDown(self):
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 3d6841540628b..93f6bfd8f7142 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -409,7 +409,7 @@ def test_paused(self):
     def test_failed(self):
         url = ('failed?task_id=run_this_last&dag_id=example_bash_operator&'
                'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.default_date)))
+               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
         resp = self.client.get(url)
         self.check_content_in_response('Wait a minute', resp)
 

From 6742dc1fe023d9b1b45f19758aef7098beb096a3 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Wed, 9 Jan 2019 21:36:39 +0100
Subject: [PATCH 384/808] [AIRFLOW-3630] Cleanup of GCP Cloud SQL Connection
 (#4451)

---
 airflow/contrib/hooks/gcp_sql_hook.py         |  7 ++-
 airflow/contrib/operators/gcp_sql_operator.py | 46 +++++++++----------
 .../operators/test_gcp_sql_operator.py        | 40 ++++++++++++++--
 3 files changed, 65 insertions(+), 28 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 7dabf74789f97..cfe256df04aa9 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -689,6 +689,8 @@ def _validate_inputs(self):
             raise AirflowException("Cloud Sql Proxy does not support SSL connections."
                                    " SSL is not needed as Cloud Sql Proxy "
                                    "provides encryption on its own")
+
+    def validate_ssl_certs(self):
         if self.use_ssl:
             self._check_ssl_file(self.sslcert, "sslcert")
             self._check_ssl_file(self.sslkey, "sslkey")
@@ -854,8 +856,9 @@ def cleanup_database_hook(self):
         Clean up database hook after it was used.
         """
         if self.database_type == 'postgres':
-            for output in self.db_hook.conn.notices:
-                self.log.info(output)
+            if self.db_hook.conn and self.db_hook.conn.notices:
+                for output in self.db_hook.conn.notices:
+                    self.log.info(output)
 
     def reserve_free_tcp_port(self):
         """
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index 711f2c8d15ebb..706d58baefd96 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -575,30 +575,30 @@ def __init__(self,
         self.cloud_sql_proxy_runner = None
         self.database_hook = None
 
-    def pre_execute(self, context):
-        self.cloudsql_db_hook.create_connection()
-        self.database_hook = self.cloudsql_db_hook.get_database_hook()
-        if self.cloudsql_db_hook.use_proxy:
-            self.cloud_sql_proxy_runner = self.cloudsql_db_hook.get_sqlproxy_runner()
-            self.cloudsql_db_hook.free_reserved_port()
-            # There is very, very slim chance that the socket will be taken over
-            # here by another bind(0). It's quite unlikely to happen though!
-            self.cloud_sql_proxy_runner.start_proxy()
-
     def execute(self, context):
-        self.log.info('Executing: "%s"', self.sql)
-        self.database_hook.run(self.sql, self.autocommit, parameters=self.parameters)
-
-    def post_execute(self, context, result=None):
-        # Make sure that all the cleanups happen, no matter if there are some
-        # exceptions thrown
+        self.cloudsql_db_hook.validate_ssl_certs()
+        self.cloudsql_db_hook.create_connection()
         try:
-            self.cloudsql_db_hook.cleanup_database_hook()
-        finally:
+            self.database_hook = self.cloudsql_db_hook.get_database_hook()
             try:
-                if self.cloud_sql_proxy_runner:
-                    self.cloud_sql_proxy_runner.stop_proxy()
-                    self.cloud_sql_proxy_runner = None
+                try:
+                    if self.cloudsql_db_hook.use_proxy:
+                        self.cloud_sql_proxy_runner = self.cloudsql_db_hook.\
+                            get_sqlproxy_runner()
+                        self.cloudsql_db_hook.free_reserved_port()
+                        # There is very, very slim chance that the socket will
+                        # be taken over here by another bind(0).
+                        # It's quite unlikely to happen though!
+                        self.cloud_sql_proxy_runner.start_proxy()
+                    self.log.info('Executing: "%s"', self.sql)
+                    self.database_hook.run(self.sql, self.autocommit,
+                                           parameters=self.parameters)
+                finally:
+                    if self.cloud_sql_proxy_runner:
+                        self.cloud_sql_proxy_runner.stop_proxy()
+                        self.cloud_sql_proxy_runner = None
             finally:
-                self.cloudsql_db_hook.delete_connection()
-                self.cloudsql_db_hook = None
+                self.cloudsql_db_hook.cleanup_database_hook()
+        finally:
+            self.cloudsql_db_hook.delete_connection()
+            self.cloudsql_db_hook = None
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index a1d5ef632a8a7..f5039fb4888e4 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -523,10 +523,11 @@ def test_create_operator_with_wrong_parameters(self,
                    use_ssl=use_ssl))
         get_connections.return_value = [connection]
         with self.assertRaises(AirflowException) as cm:
-            CloudSqlQueryOperator(
+            op = CloudSqlQueryOperator(
                 sql=sql,
                 task_id='task_id'
             )
+            op.execute(None)
         err = cm.exception
         self.assertIn(message, str(err))
 
@@ -740,11 +741,11 @@ def test_create_operator_with_too_long_unix_socket_path(self, get_connections):
             "use_proxy=True&sql_proxy_use_tcp=False")
         get_connections.return_value = [connection]
         with self.assertRaises(AirflowException) as cm:
-            operator = CloudSqlQueryOperator(
+            op = CloudSqlQueryOperator(
                 sql=['SELECT * FROM TABLE'],
                 task_id='task_id'
             )
-            operator.cloudsql_db_hook.create_connection()
+            op.execute(None)
         err = cm.exception
         self.assertIn("The UNIX socket path length cannot exceed", str(err))
 
@@ -771,6 +772,39 @@ def test_create_operator_with_not_too_long_unix_socket_path(self, get_connection
         self.assertEqual('postgres', conn.conn_type)
         self.assertEqual('testdb', conn.schema)
 
+    @mock.patch("airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook."
+                "delete_connection")
+    @mock.patch("airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook."
+                "get_connection")
+    @mock.patch("airflow.hooks.mysql_hook.MySqlHook.run")
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_cloudsql_hook_delete_connection_on_exception(
+            self, get_connections, run, get_connection, delete_connection):
+        connection = Connection()
+        connection.parse_from_uri(
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "project_id=example-project&location=europe-west1&instance=testdb&"
+            "use_proxy=False")
+        get_connection.return_value = connection
+
+        db_connection = Connection()
+        db_connection.host = "8.8.8.8"
+        db_connection.set_extra(json.dumps({"project_id": "example-project",
+                                            "location": "europe-west1",
+                                            "instance": "testdb",
+                                            "database_type": "mysql"}))
+        get_connections.return_value = [db_connection]
+        run.side_effect = Exception("Exception when running a query")
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        with self.assertRaises(Exception) as cm:
+            operator.execute(None)
+        err = cm.exception
+        self.assertEqual("Exception when running a query", str(err))
+        delete_connection.assert_called_once_with()
+
 
 @unittest.skipIf(
     BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)

From 6a6d91b6e273c33c74d405618b6dca11b62c295c Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Wed, 9 Jan 2019 21:50:02 +0000
Subject: [PATCH 385/808] [AIRFLOW-XXX] Update Updating instructions for
 changes in 1.10.2

---
 UPDATING.md | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index def4aa73b5689..a287ea34e5aba 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -53,22 +53,6 @@ session.add(admin)
 session.commit()
 ```
 
-## Airflow 1.10.1
-
-### New `dag_processor_manager_log_location` config option
-
-The DAG parsing manager log now by default will be log into a file, where its location is
-controlled by the new `dag_processor_manager_log_location` config option in core section.
-
-### new `sync_parallelism` config option in celery section
-
-The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
-fetch celery task state in parallel. Default value is max(1, number of cores - 1)
-
-### StatsD Metrics
-
-The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
-
 ### Custom auth backends interface change
 
 We have updated the version of flask-login we depend upon, and as a result any
@@ -85,6 +69,22 @@ then you need to change it like this
     def is_active(self):
       return self.active
 
+## Airflow 1.10.1
+
+### New `dag_processor_manager_log_location` config option
+
+The DAG parsing manager log now by default will be log into a file, where its location is
+controlled by the new `dag_processor_manager_log_location` config option in core section.
+
+### new `sync_parallelism` config option in celery section
+
+The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
+fetch celery task state in parallel. Default value is max(1, number of cores - 1)
+
+### StatsD Metrics
+
+The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
+
 ### EMRHook now passes all of connection's extra to CreateJobFlow API
 
 EMRHook.create_job_flow has been changed to pass all keys to the create_job_flow API, rather than

From a38fecf948e22a0631054b5e21e444f06a477808 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 9 Jan 2019 23:09:48 +0000
Subject: [PATCH 386/808] [AIRFLOW-3662] Add dependency for Enum (#4468)

---
 setup.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup.py b/setup.py
index 67c20ed6d608c..ffda4e96aa682 100644
--- a/setup.py
+++ b/setup.py
@@ -297,6 +297,7 @@ def do_setup():
             'configparser>=3.5.0, <3.6.0',
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
+            'enum34~=1.1.6',
             'flask>=0.12.4, <0.13',
             'flask-appbuilder==1.12.1',
             'flask-admin==1.5.2',

From 27a4a888e946728d9bb33b78ec604e08d4a93f89 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 9 Jan 2019 23:06:42 +0000
Subject: [PATCH 387/808] [AIRFLOW-3655] Escape links generated in model views
 (#4463)

---
 airflow/www/views.py         | 9 ++++++---
 airflow/www_rbac/views.py    | 3 ++-
 tests/www_rbac/test_views.py | 7 +++++++
 3 files changed, 15 insertions(+), 4 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index d097e54b85c05..9f34b9c440085 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -131,7 +131,8 @@ def dag_run_link(v, c, m, p):
         dag_id=m.dag_id,
         run_id=m.run_id,
         execution_date=m.execution_date)
-    return Markup('<a href="{url}">{m.run_id}</a>'.format(**locals()))
+    title = escape(m.run_id)
+    return Markup('<a href="{url}">{title}</a>'.format(**locals()))
 
 
 def task_instance_link(v, c, m, p):
@@ -202,12 +203,14 @@ def label_link(v, c, m, p):
     url = url_for(
         'airflow.chart', chart_id=m.id, iteration_no=m.iteration_no,
         **default_params)
-    return Markup("<a href='{url}'>{m.label}</a>".format(**locals()))
+    title = escape(m.label)
+    return Markup("<a href='{url}'>{title}</a>".format(**locals()))
 
 
 def pool_link(v, c, m, p):
+    title = escape(m.pool)
     url = '/admin/taskinstance/?flt1_pool_equals=' + m.pool
-    return Markup("<a href='{url}'>{m.pool}</a>".format(**locals()))
+    return Markup("<a href='{url}'>{title}</a>".format(**locals()))
 
 
 def pygment_html_render(s, lexer=lexers.TextLexer):
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index c916941112df2..767ef4aef037c 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -36,7 +36,7 @@
 import sqlalchemy as sqla
 from flask import (
     redirect, request, Markup, Response, render_template,
-    make_response, flash, jsonify)
+    make_response, flash, jsonify, escape)
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
@@ -1974,6 +1974,7 @@ def pool_link(attr):
         pool_id = attr.get('pool')
         if pool_id is not None:
             url = '/taskinstance/list/?_flt_3_pool=' + str(pool_id)
+            pool_id = escape(pool_id)
             return Markup("<a href='{url}'>{pool_id}</a>".format(**locals()))
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 93f6bfd8f7142..3e583507b9ba5 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -244,6 +244,13 @@ def test_create_pool_with_empty_name(self):
                                 follow_redirects=True)
         self.check_content_in_response('This field is required.', resp)
 
+    def test_odd_name(self):
+        self.pool['pool'] = 'test-pool<script></script>'
+        self.session.add(models.Pool(**self.pool))
+        self.session.commit()
+        resp = self.client.get('/pool/list/')
+        self.check_content_in_response('test-pool&lt;script&gt;', resp)
+
 
 class TestMountPoint(unittest.TestCase):
     def setUp(self):

From 3fb1f67ca54e99a95128a8ea777a5cd195ef5377 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 11 Jan 2019 07:46:22 +0100
Subject: [PATCH 388/808] [AIRFLOW-XXX] Docs: Fix paths to GCS transfer
 operator (#4479)

---
 docs/code.rst        | 2 +-
 docs/integration.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/code.rst b/docs/code.rst
index 1850bdb14b24f..39bc2418e732d 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -179,7 +179,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_s3.GoogleCloudStorageToS3Operator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPIOperator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPISendRoomNotificationOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index c12e9ac57e62d..b3c86dada08e4 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1307,7 +1307,7 @@ GoogleCloudStorageToGoogleCloudStorageOperator
 GoogleCloudStorageToGoogleCloudStorageTransferOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
 
 .. _MySqlToGoogleCloudStorageOperator:
 

From e234c0fd05b7287c0a19973e2552d36c24fb0164 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Fri, 11 Jan 2019 10:58:14 +0100
Subject: [PATCH 389/808] [AIRFLOW-3589] Visualize reschedule state in all
 views (#4408)

* [AIRFLOW-3589] Visualize reschedule state in all views

* Add explicit `UP_FOR_RESCHEDULE` state
* Add legend and CSS to views

* [AIRFLOW-3589] Visualize reschedule state in all views

* Use set or tuple instad of list
* Use `with` statement for session handling
---
 airflow/jobs.py                               |  29 +++-
 airflow/models.py                             |   4 +-
 airflow/ti_deps/dep_context.py                |   1 +
 airflow/ti_deps/deps/ready_to_reschedule.py   |   5 +-
 airflow/utils/state.py                        |   6 +-
 airflow/www/static/graph.css                  |   5 +-
 airflow/www/static/main.css                   |   3 +
 airflow/www/static/tree.css                   |   3 +
 airflow/www/templates/airflow/dags.html       |   2 +-
 airflow/www/templates/airflow/graph.html      |   1 +
 airflow/www/templates/airflow/tree.html       |   2 +
 airflow/www_rbac/static/css/graph.css         |   5 +-
 airflow/www_rbac/static/css/main.css          |   3 +
 airflow/www_rbac/static/css/tree.css          |   3 +
 airflow/www_rbac/templates/airflow/dags.html  |   2 +-
 airflow/www_rbac/templates/airflow/graph.html |   1 +
 airflow/www_rbac/templates/airflow/tree.html  |   2 +
 tests/jobs.py                                 | 137 +++++++++++++++++-
 tests/sensors/test_base_sensor.py             |  16 +-
 .../deps/test_ready_to_reschedule_dep.py      |  10 +-
 20 files changed, 203 insertions(+), 37 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 526af2a75c1d1..58d142233dc41 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -941,7 +941,8 @@ def _process_task_instances(self, dag, queue, session=None):
             self.log.debug("Examining active DAG run: %s", run)
             # this needs a fresh session sometimes tis get detached
             tis = run.get_task_instances(state=(State.NONE,
-                                                State.UP_FOR_RETRY))
+                                                State.UP_FOR_RETRY,
+                                                State.UP_FOR_RESCHEDULE))
 
             # this loop is quite slow as it uses are_dependencies_met for
             # every task (in ti.is_runnable). This is also called in
@@ -1572,12 +1573,13 @@ def _execute_helper(self):
                     self._change_state_for_tis_without_dagrun(simple_dag_bag,
                                                               [State.UP_FOR_RETRY],
                                                               State.FAILED)
-                    # If a task instance is scheduled or queued, but the corresponding
-                    # DAG run isn't running, set the state to NONE so we don't try to
-                    # re-run it.
+                    # If a task instance is scheduled or queued or up for reschedule,
+                    # but the corresponding DAG run isn't running, set the state to
+                    # NONE so we don't try to re-run it.
                     self._change_state_for_tis_without_dagrun(simple_dag_bag,
                                                               [State.QUEUED,
-                                                               State.SCHEDULED],
+                                                               State.SCHEDULED,
+                                                               State.UP_FOR_RESCHEDULE],
                                                               State.NONE)
 
                     self._execute_task_instances(simple_dag_bag,
@@ -1928,6 +1930,11 @@ def _update_counters(self, ti_status):
                 self.log.warning("Task instance %s is up for retry", ti)
                 ti_status.running.pop(key)
                 ti_status.to_run[key] = ti
+            # special case: if the task needs to be rescheduled put it back
+            elif ti.state == State.UP_FOR_RESCHEDULE:
+                self.log.warning("Task instance %s is up for reschedule", ti)
+                ti_status.running.pop(key)
+                ti_status.to_run[key] = ti
             # special case: The state of the task can be set to NONE by the task itself
             # when it reaches concurrency limits. It could also happen when the state
             # is changed externally, e.g. by clearing tasks from the ui. We need to cover
@@ -2207,7 +2214,7 @@ def _process_backfill_task_instances(self,
                             session=session,
                             verbose=self.verbose):
                         ti.refresh_from_db(lock_for_update=True, session=session)
-                        if ti.state == State.SCHEDULED or ti.state == State.UP_FOR_RETRY:
+                        if ti.state in (State.SCHEDULED, State.UP_FOR_RETRY, State.UP_FOR_RESCHEDULE):
                             if executor.has_task(ti):
                                 self.log.debug(
                                     "Task Instance %s already in executor "
@@ -2256,6 +2263,16 @@ def _process_backfill_task_instances(self,
                         ti_status.to_run[key] = ti
                         continue
 
+                    # special case
+                    if ti.state == State.UP_FOR_RESCHEDULE:
+                        self.log.debug(
+                            "Task instance %s reschedule period not "
+                            "expired yet", ti)
+                        if key in ti_status.running:
+                            ti_status.running.pop(key)
+                        ti_status.to_run[key] = ti
+                        continue
+
                     # all remaining tasks
                     self.log.debug('Adding %s to not_ready', ti)
                     ti_status.not_ready.add(key)
diff --git a/airflow/models.py b/airflow/models.py
index a631436c9a0f2..c236957cfdb7e 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1773,7 +1773,7 @@ def _handle_reschedule(self, reschedule_exception, test_mode=False, context=None
                     reschedule_exception.reschedule_date))
 
         # set state
-        self.state = State.NONE
+        self.state = State.UP_FOR_RESCHEDULE
 
         # Decrement try_number so subsequent runs will use the same try number and write
         # to same log file.
@@ -1781,7 +1781,7 @@ def _handle_reschedule(self, reschedule_exception, test_mode=False, context=None
 
         session.merge(self)
         session.commit()
-        self.log.info('Rescheduling task, marking task as NONE')
+        self.log.info('Rescheduling task, marking task as UP_FOR_RESCHEDULE')
 
     @provide_session
     def handle_failure(self, error, test_mode=False, context=None, session=None):
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index a347983f3b9f1..fbfb1a038d09b 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -95,6 +95,7 @@ def __init__(
     State.SKIPPED,
     State.UPSTREAM_FAILED,
     State.UP_FOR_RETRY,
+    State.UP_FOR_RESCHEDULE,
 }
 
 # Context to get the dependencies that need to be met in order for a task instance to
diff --git a/airflow/ti_deps/deps/ready_to_reschedule.py b/airflow/ti_deps/deps/ready_to_reschedule.py
index e0f5f8fdfe410..dc1c92c654f43 100644
--- a/airflow/ti_deps/deps/ready_to_reschedule.py
+++ b/airflow/ti_deps/deps/ready_to_reschedule.py
@@ -27,6 +27,7 @@ class ReadyToRescheduleDep(BaseTIDep):
     NAME = "Ready To Reschedule"
     IGNOREABLE = True
     IS_TASK_DEP = True
+    RESCHEDULEABLE_STATES = {State.UP_FOR_RESCHEDULE, State.NONE}
 
     @provide_session
     def _get_dep_statuses(self, ti, session, dep_context):
@@ -43,9 +44,9 @@ def _get_dep_statuses(self, ti, session, dep_context):
                        "permitted.")
             return
 
-        if ti.state != State.NONE:
+        if ti.state not in self.RESCHEDULEABLE_STATES:
             yield self._passing_status(
-                reason="The task instance is not in NONE state.")
+                reason="The task instance is not in State_UP_FOR_RESCHEDULE or NONE state.")
             return
 
         # Lazy import to avoid circular dependency
diff --git a/airflow/utils/state.py b/airflow/utils/state.py
index b73aaa12a087a..320b996d5d500 100644
--- a/airflow/utils/state.py
+++ b/airflow/utils/state.py
@@ -43,6 +43,7 @@ class State(object):
     SHUTDOWN = "shutdown"  # External request to shut down
     FAILED = "failed"
     UP_FOR_RETRY = "up_for_retry"
+    UP_FOR_RESCHEDULE = "up_for_reschedule"
     UPSTREAM_FAILED = "upstream_failed"
     SKIPPED = "skipped"
 
@@ -53,6 +54,7 @@ class State(object):
         UPSTREAM_FAILED,
         SKIPPED,
         UP_FOR_RETRY,
+        UP_FOR_RESCHEDULE,
         QUEUED,
         NONE,
         SCHEDULED,
@@ -71,6 +73,7 @@ class State(object):
         SHUTDOWN: 'blue',
         FAILED: 'red',
         UP_FOR_RETRY: 'gold',
+        UP_FOR_RESCHEDULE: 'turquoise',
         UPSTREAM_FAILED: 'orange',
         SKIPPED: 'pink',
         REMOVED: 'lightgrey',
@@ -114,5 +117,6 @@ def unfinished(cls):
             cls.QUEUED,
             cls.RUNNING,
             cls.SHUTDOWN,
-            cls.UP_FOR_RETRY
+            cls.UP_FOR_RETRY,
+            cls.UP_FOR_RESCHEDULE
         ]
diff --git a/airflow/www/static/graph.css b/airflow/www/static/graph.css
index f1d34800612fa..a40abf3ed7930 100644
--- a/airflow/www/static/graph.css
+++ b/airflow/www/static/graph.css
@@ -31,11 +31,12 @@ g.node.success rect {
 g.node.up_for_retry rect {
     stroke: gold;
 }
-
 g.node.queued rect {
     stroke: grey;
 }
-
+g.node.up_for_reschedule rect{
+    stroke: turquoise;
+}
 g.node.running rect{
     stroke: lime;
 }
diff --git a/airflow/www/static/main.css b/airflow/www/static/main.css
index 147695c4a9591..66f449aceee29 100644
--- a/airflow/www/static/main.css
+++ b/airflow/www/static/main.css
@@ -75,6 +75,9 @@ span.success{
 span.up_for_retry{
     background-color: gold;
 }
+span.up_for_reschedule{
+    background-color: turquoise;
+}
 span.started{
     background-color: lime;
 }
diff --git a/airflow/www/static/tree.css b/airflow/www/static/tree.css
index 9304bb1c55f78..17ff748b59a94 100644
--- a/airflow/www/static/tree.css
+++ b/airflow/www/static/tree.css
@@ -62,6 +62,9 @@ rect.upstream_failed {
 rect.up_for_retry {
     fill: gold;
 }
+rect.up_for_reschedule {
+    fill: turquoise;
+}
 rect.skipped {
     fill: pink;
 }
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index a34c6720f6520..395915b8135e9 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -402,7 +402,7 @@ <h2>DAGs</h2>
             states = json[dag_id];
             g = d3.select('svg#task-run-' + dag_id)
               .attr('height', diameter + (stroke_width_hover * 2))
-              .attr('width', '270px')
+              .attr('width', '300px')
               .selectAll("g")
               .data(states)
               .enter()
diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index 33cdd9737b2fa..dcd4f1c468c7d 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -66,6 +66,7 @@
     <div class="legend_item state" style="border-color:white;">no status</div>
     <div class="legend_item state" style="border-color:grey;">queued</div>
     <div class="legend_item state" style="border-color:gold;">retry</div>
+    <div class="legend_item state" style="border-color:turquoise;">rescheduled</div>
     <div class="legend_item state" style="border-color:pink;">skipped</div>
     <div class="legend_item state" style="border-color:red;">failed</div>
     <div class="legend_item state" style="border-color:lime;">running</div>
diff --git a/airflow/www/templates/airflow/tree.html b/airflow/www/templates/airflow/tree.html
index f20127ceb3178..da109c1e5ea9f 100644
--- a/airflow/www/templates/airflow/tree.html
+++ b/airflow/www/templates/airflow/tree.html
@@ -47,6 +47,8 @@
     <div class="square" style="background: grey;"></div>
     <div class="legend_item" style="border: none;">retry</div>
     <div class="square" style="background: gold;"></div>
+    <div class="legend_item" style="border: none;">rescheduled</div>
+    <div class="square" style="background: turquoise;"></div>
     <div class="legend_item" style="border: none;">skipped</div>
     <div class="square" style="background: pink;"></div>
     <div class="legend_item" style="border: none;">failed</div>
diff --git a/airflow/www_rbac/static/css/graph.css b/airflow/www_rbac/static/css/graph.css
index fa055b9e1bb2a..f2091ba841657 100644
--- a/airflow/www_rbac/static/css/graph.css
+++ b/airflow/www_rbac/static/css/graph.css
@@ -51,11 +51,12 @@ g.node.success rect {
 g.node.up_for_retry rect {
     stroke: gold;
 }
-
+g.node.up_for_reschedule rect{
+    stroke: turquoise;
+}
 g.node.queued rect {
     stroke: grey;
 }
-
 g.node.running rect{
     stroke: lime;
 }
diff --git a/airflow/www_rbac/static/css/main.css b/airflow/www_rbac/static/css/main.css
index d3d198356e8db..bc9bb25daa1ac 100644
--- a/airflow/www_rbac/static/css/main.css
+++ b/airflow/www_rbac/static/css/main.css
@@ -78,6 +78,9 @@ span.success{
 span.up_for_retry{
     background-color: gold;
 }
+span.up_for_reschedule{
+    background-color: turquoise;
+}
 span.started{
     background-color: lime;
 }
diff --git a/airflow/www_rbac/static/css/tree.css b/airflow/www_rbac/static/css/tree.css
index 9304bb1c55f78..17ff748b59a94 100644
--- a/airflow/www_rbac/static/css/tree.css
+++ b/airflow/www_rbac/static/css/tree.css
@@ -62,6 +62,9 @@ rect.upstream_failed {
 rect.up_for_retry {
     fill: gold;
 }
+rect.up_for_reschedule {
+    fill: turquoise;
+}
 rect.skipped {
     fill: pink;
 }
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index d1aab0218f7ad..d4e3a227a274c 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -403,7 +403,7 @@ <h2>DAGs</h2>
             states = json[dag_id];
             g = d3.select('svg#task-run-' + dag_id)
               .attr('height', diameter + (stroke_width_hover * 2))
-              .attr('width', '270px')
+              .attr('width', '300px')
               .selectAll("g")
               .data(states)
               .enter()
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 23744287dcedd..44d620fbaef83 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -62,6 +62,7 @@
     <div class="legend_item state" style="border-color:white;">no status</div>
     <div class="legend_item state" style="border-color:grey;">queued</div>
     <div class="legend_item state" style="border-color:gold;">retry</div>
+    <div class="legend_item state" style="border-color:turquoise;">rescheduled</div>
     <div class="legend_item state" style="border-color:pink;">skipped</div>
     <div class="legend_item state" style="border-color:red;">failed</div>
     <div class="legend_item state" style="border-color:lime;">running</div>
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index da886317ed06b..a00fda6c29eb4 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -48,6 +48,8 @@
     <div class="square" style="background: grey;"></div>
     <div class="legend_item" style="border: none;">retry</div>
     <div class="square" style="background: gold;"></div>
+    <div class="legend_item" style="border: none;">rescheduled</div>
+    <div class="square" style="background: turquoise;"></div>
     <div class="legend_item" style="border: none;">skipped</div>
     <div class="square" style="background: pink;"></div>
     <div class="legend_item" style="border: none;">failed</div>
diff --git a/tests/jobs.py b/tests/jobs.py
index b755cd26f9a9b..5fb7ad348b292 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -37,6 +37,7 @@
 import six
 import sqlalchemy
 from mock import Mock, patch, MagicMock, PropertyMock
+from parameterized import parameterized
 
 from airflow.utils.db import create_session
 from airflow import AirflowException, settings, models
@@ -254,6 +255,46 @@ def test_backfill_conf(self):
 
         self.assertEqual(conf, dr[0].conf)
 
+    def test_backfill_run_rescheduled(self):
+        dag = DAG(
+            dag_id='test_backfill_run_rescheduled',
+            start_date=DEFAULT_DATE,
+            schedule_interval='@daily')
+
+        with dag:
+            DummyOperator(
+                task_id='test_backfill_run_rescheduled_task-1',
+                dag=dag,
+            )
+
+        dag.clear()
+
+        executor = TestExecutor(do_update=True)
+
+        job = BackfillJob(dag=dag,
+                          executor=executor,
+                          start_date=DEFAULT_DATE,
+                          end_date=DEFAULT_DATE + datetime.timedelta(days=2),
+                          )
+        job.run()
+
+        ti = TI(task=dag.get_task('test_backfill_run_rescheduled_task-1'),
+                execution_date=DEFAULT_DATE)
+        ti.refresh_from_db()
+        ti.set_state(State.UP_FOR_RESCHEDULE)
+
+        job = BackfillJob(dag=dag,
+                          executor=executor,
+                          start_date=DEFAULT_DATE,
+                          end_date=DEFAULT_DATE + datetime.timedelta(days=2),
+                          rerun_failed_tasks=True
+                          )
+        job.run()
+        ti = TI(task=dag.get_task('test_backfill_run_rescheduled_task-1'),
+                execution_date=DEFAULT_DATE)
+        ti.refresh_from_db()
+        self.assertEquals(ti.state, State.SUCCESS)
+
     def test_backfill_rerun_failed_tasks(self):
         dag = DAG(
             dag_id='test_backfill_rerun_failed',
@@ -1052,8 +1093,31 @@ def test_update_counters(self):
 
         ti_status.failed.clear()
 
+        # test for retry
+        ti.set_state(State.UP_FOR_RETRY, session)
+        ti_status.running[ti.key] = ti
+        job._update_counters(ti_status=ti_status)
+        self.assertTrue(len(ti_status.running) == 0)
+        self.assertTrue(len(ti_status.succeeded) == 0)
+        self.assertTrue(len(ti_status.skipped) == 0)
+        self.assertTrue(len(ti_status.failed) == 0)
+        self.assertTrue(len(ti_status.to_run) == 1)
+
+        ti_status.to_run.clear()
+
         # test for reschedule
-        # test for failed
+        ti.set_state(State.UP_FOR_RESCHEDULE, session)
+        ti_status.running[ti.key] = ti
+        job._update_counters(ti_status=ti_status)
+        self.assertTrue(len(ti_status.running) == 0)
+        self.assertTrue(len(ti_status.succeeded) == 0)
+        self.assertTrue(len(ti_status.skipped) == 0)
+        self.assertTrue(len(ti_status.failed) == 0)
+        self.assertTrue(len(ti_status.to_run) == 1)
+
+        ti_status.to_run.clear()
+
+        # test for none
         ti.set_state(State.NONE, session)
         ti_status.running[ti.key] = ti
         job._update_counters(ti_status=ti_status)
@@ -1063,6 +1127,8 @@ def test_update_counters(self):
         self.assertTrue(len(ti_status.failed) == 0)
         self.assertTrue(len(ti_status.to_run) == 1)
 
+        ti_status.to_run.clear()
+
         session.close()
 
     def test_dag_get_run_dates(self):
@@ -2069,6 +2135,51 @@ def test_execute_helper_reset_orphaned_tasks(self):
         ti2 = dr2.get_task_instance(task_id=op1.task_id, session=session)
         self.assertEqual(ti2.state, State.SCHEDULED)
 
+    @parameterized.expand([
+        [State.UP_FOR_RETRY, State.FAILED],
+        [State.QUEUED, State.NONE],
+        [State.SCHEDULED, State.NONE],
+        [State.UP_FOR_RESCHEDULE, State.NONE],
+    ])
+    def test_execute_helper_should_change_state_for_tis_without_dagrun(
+            self, initial_task_state, expected_task_state):
+        session = settings.Session()
+        dag = DAG(
+            'test_execute_helper_should_change_state_for_tis_without_dagrun',
+            start_date=DEFAULT_DATE,
+            default_args={'owner': 'owner1'})
+
+        with dag:
+            op1 = DummyOperator(task_id='op1')
+
+        # Create DAG run with FAILED state
+        dag.clear()
+        dr = dag.create_dagrun(run_id=DagRun.ID_PREFIX,
+                               state=State.FAILED,
+                               execution_date=DEFAULT_DATE,
+                               start_date=DEFAULT_DATE,
+                               session=session)
+        ti = dr.get_task_instance(task_id=op1.task_id, session=session)
+        ti.state = initial_task_state
+        session.commit()
+
+        # Create scheduler and mock calls to processor. Run duration is set
+        # to a high value to ensure loop is entered. Poll interval is 0 to
+        # avoid sleep. Done flag is set to true to exist the loop immediately.
+        scheduler = SchedulerJob(num_runs=0, processor_poll_interval=0)
+        executor = TestExecutor()
+        executor.queued_tasks
+        scheduler.executor = executor
+        processor = mock.MagicMock()
+        processor.harvest_simple_dags.return_value = [dag]
+        processor.done = True
+        scheduler.processor_agent = processor
+
+        scheduler._execute_helper()
+
+        ti = dr.get_task_instance(task_id=op1.task_id, session=session)
+        self.assertEqual(ti.state, expected_task_state)
+
     @provide_session
     def evaluate_dagrun(
             self,
@@ -2309,7 +2420,14 @@ def test_scheduler_dagrun_once(self):
         dr = scheduler.create_dag_run(dag)
         self.assertIsNone(dr)
 
-    def test_scheduler_process_task_instances(self):
+    @parameterized.expand([
+        [State.NONE, None, None],
+        [State.UP_FOR_RETRY, timezone.utcnow() - datetime.timedelta(minutes=30),
+            timezone.utcnow() - datetime.timedelta(minutes=15)],
+        [State.UP_FOR_RESCHEDULE, timezone.utcnow() - datetime.timedelta(minutes=30),
+            timezone.utcnow() - datetime.timedelta(minutes=15)],
+    ])
+    def test_scheduler_process_task_instances(self, state, start_date, end_date):
         """
         Test if _process_task_instances puts the right task instances into the
         queue.
@@ -2322,17 +2440,22 @@ def test_scheduler_process_task_instances(self):
             dag=dag,
             owner='airflow')
 
-        session = settings.Session()
-        orm_dag = DagModel(dag_id=dag.dag_id)
-        session.merge(orm_dag)
-        session.commit()
-        session.close()
+        with create_session() as session:
+            orm_dag = DagModel(dag_id=dag.dag_id)
+            session.merge(orm_dag)
 
         scheduler = SchedulerJob()
         dag.clear()
         dr = scheduler.create_dag_run(dag)
         self.assertIsNotNone(dr)
 
+        with create_session() as session:
+            tis = dr.get_task_instances(session=session)
+            for ti in tis:
+                ti.state = state
+                ti.start_date = start_date
+                ti.end_date = end_date
+
         queue = Mock()
         scheduler._process_task_instances(dag, queue=queue)
 
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index 353f4447b1008..f9186db149c5c 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -182,7 +182,7 @@ def test_ok_with_reschedule(self):
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 1)
@@ -201,7 +201,7 @@ def test_ok_with_reschedule(self):
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify two rows in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 2)
@@ -239,7 +239,7 @@ def test_fail_with_reschedule(self):
         self.assertEquals(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
             if ti.task_id == DUMMY_OP:
                 self.assertEquals(ti.state, State.NONE)
 
@@ -273,7 +273,7 @@ def test_soft_fail_with_reschedule(self):
         self.assertEquals(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
             if ti.task_id == DUMMY_OP:
                 self.assertEquals(ti.state, State.NONE)
 
@@ -305,7 +305,7 @@ def test_ok_with_reschedule_and_retry(self):
         self.assertEquals(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 1)
@@ -337,7 +337,7 @@ def test_ok_with_reschedule_and_retry(self):
         self.assertEquals(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 1)
@@ -393,7 +393,7 @@ def test_ok_with_custom_reschedule_exception(self):
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 1)
@@ -410,7 +410,7 @@ def test_ok_with_custom_reschedule_exception(self):
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify two rows in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 2)
diff --git a/tests/ti_deps/deps/test_ready_to_reschedule_dep.py b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
index 898850f8b7bfb..9bae3498984f1 100644
--- a/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
+++ b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
@@ -44,7 +44,7 @@ def _get_task_reschedule(self, reschedule_date):
         return tr
 
     def test_should_pass_if_ignore_in_reschedule_period_is_set(self):
-        ti = self._get_task_instance(State.NONE)
+        ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         dep_context = DepContext(ignore_in_reschedule_period=True)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti, dep_context=dep_context))
 
@@ -62,7 +62,7 @@ def test_should_pass_after_reschedule_date_one(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() - timedelta(minutes=1)),
         ]
-        ti = self._get_task_instance(State.NONE)
+        ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
     @patch('airflow.models.TaskReschedule.find_for_task_instance')
@@ -72,7 +72,7 @@ def test_should_pass_after_reschedule_date_multiple(self, find_for_task_instance
             self._get_task_reschedule(utcnow() - timedelta(minutes=11)),
             self._get_task_reschedule(utcnow() - timedelta(minutes=1)),
         ]
-        ti = self._get_task_instance(State.NONE)
+        ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
     @patch('airflow.models.TaskReschedule.find_for_task_instance')
@@ -80,7 +80,7 @@ def test_should_fail_before_reschedule_date_one(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() + timedelta(minutes=1)),
         ]
-        ti = self._get_task_instance(State.NONE)
+        ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertFalse(ReadyToRescheduleDep().is_met(ti=ti))
 
     @patch('airflow.models.TaskReschedule.find_for_task_instance')
@@ -90,5 +90,5 @@ def test_should_fail_before_reschedule_date_multiple(self, find_for_task_instanc
             self._get_task_reschedule(utcnow() - timedelta(minutes=9)),
             self._get_task_reschedule(utcnow() + timedelta(minutes=1)),
         ]
-        ti = self._get_task_instance(State.NONE)
+        ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertFalse(ReadyToRescheduleDep().is_met(ti=ti))

From 141f244a61b70398a7d51755452ff53efdd54be9 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Wed, 9 Jan 2019 12:23:03 -0800
Subject: [PATCH 390/808] [AIRFLOW-3646] Rename plugins_manager.py to test_xx
 to trigger tests (#4464)

---
 tests/plugins/__init__.py                     | 18 +++++
 tests/plugins/test_plugin.py                  |  8 +--
 tests/plugins/test_plugins_manager_rbac.py    | 68 +++++++++++++++++++
 .../test_plugins_manager_www.py}              | 49 ++-----------
 4 files changed, 94 insertions(+), 49 deletions(-)
 create mode 100644 tests/plugins/__init__.py
 create mode 100644 tests/plugins/test_plugins_manager_rbac.py
 rename tests/{plugins_manager.py => plugins/test_plugins_manager_www.py} (63%)

diff --git a/tests/plugins/__init__.py b/tests/plugins/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/tests/plugins/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index 058a2bb227467..68aa989a2e2bc 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -58,7 +58,7 @@ def plugin_macro():
 
 
 # Creating a flask admin BaseView
-class TestView(BaseView):
+class PluginTestView(BaseView):
     @expose('/')
     def test(self):
         # in this example, put your test_plugin/test.html
@@ -66,11 +66,11 @@ def test(self):
         return self.render("test_plugin/test.html", content="Hello galaxy!")
 
 
-v = TestView(category="Test Plugin", name="Test View")
+v = PluginTestView(category="Test Plugin", name="Test View")
 
 
 # Creating a flask appbuilder BaseView
-class TestAppBuilderBaseView(AppBuilderBaseView):
+class PluginTestAppBuilderBaseView(AppBuilderBaseView):
     default_view = "test"
 
     @expose("/")
@@ -78,7 +78,7 @@ def test(self):
         return self.render("test_plugin/test.html", content="Hello galaxy!")
 
 
-v_appbuilder_view = TestAppBuilderBaseView()
+v_appbuilder_view = PluginTestAppBuilderBaseView()
 v_appbuilder_package = {"name": "Test View",
                         "category": "Test Plugin",
                         "view": v_appbuilder_view}
diff --git a/tests/plugins/test_plugins_manager_rbac.py b/tests/plugins/test_plugins_manager_rbac.py
new file mode 100644
index 0000000000000..b33464d397cda
--- /dev/null
+++ b/tests/plugins/test_plugins_manager_rbac.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+import unittest
+
+
+from airflow.configuration import conf
+from airflow.www_rbac import app as application
+
+
+class PluginsTestRBAC(unittest.TestCase):
+    def setUp(self):
+        conf.load_test_config()
+        self.app, self.appbuilder = application.create_app(testing=True)
+
+    def test_flaskappbuilder_views(self):
+        from tests.plugins.test_plugin import v_appbuilder_package
+        appbuilder_class_name = str(v_appbuilder_package['view'].__class__.__name__)
+        plugin_views = [view for view in self.appbuilder.baseviews
+                        if view.blueprint.name == appbuilder_class_name]
+
+        self.assertTrue(len(plugin_views) == 1)
+
+        # view should have a menu item matching category of v_appbuilder_package
+        links = [menu_item for menu_item in self.appbuilder.menu.menu
+                 if menu_item.name == v_appbuilder_package['category']]
+
+        self.assertTrue(len(links) == 1)
+
+        # menu link should also have a link matching the name of the package.
+        link = links[0]
+        self.assertEqual(link.name, v_appbuilder_package['category'])
+        self.assertEqual(link.childs[0].name, v_appbuilder_package['name'])
+
+    def test_flaskappbuilder_menu_links(self):
+        from tests.plugins.test_plugin import appbuilder_mitem
+
+        # menu item should exist matching appbuilder_mitem
+        links = [menu_item for menu_item in self.appbuilder.menu.menu
+                 if menu_item.name == appbuilder_mitem['category']]
+
+        self.assertTrue(len(links) == 1)
+
+        # menu link should also have a link matching the name of the package.
+        link = links[0]
+        self.assertEqual(link.name, appbuilder_mitem['category'])
+        self.assertEqual(link.childs[0].name, appbuilder_mitem['name'])
diff --git a/tests/plugins_manager.py b/tests/plugins/test_plugins_manager_www.py
similarity index 63%
rename from tests/plugins_manager.py
rename to tests/plugins/test_plugins_manager_www.py
index eeb6494100b84..130bd32c738c7 100644
--- a/tests/plugins_manager.py
+++ b/tests/plugins/test_plugins_manager_www.py
@@ -27,13 +27,11 @@
 from flask.blueprints import Blueprint
 from flask_admin.menu import MenuLink, MenuView
 
-from airflow.configuration import conf
 from airflow.hooks.base_hook import BaseHook
 from airflow.models import BaseOperator
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.executors.base_executor import BaseExecutor
-from airflow.www.app import cached_app
-from airflow.www_rbac import app as application
+from airflow.www.app import create_app
 
 
 class PluginsTest(unittest.TestCase):
@@ -67,7 +65,7 @@ def test_macros(self):
         self.assertTrue(callable(plugin_macro))
 
     def test_admin_views(self):
-        app = cached_app()
+        app = create_app(testing=True)
         [admin] = app.extensions['admin']
         category = admin._menu_categories['Test Plugin']
         [admin_view] = [v for v in category.get_children()
@@ -75,52 +73,13 @@ def test_admin_views(self):
         self.assertEqual('Test View', admin_view.name)
 
     def test_flask_blueprints(self):
-        app = cached_app()
+        app = create_app(testing=True)
         self.assertIsInstance(app.blueprints['test_plugin'], Blueprint)
 
     def test_menu_links(self):
-        app = cached_app()
+        app = create_app(testing=True)
         [admin] = app.extensions['admin']
         category = admin._menu_categories['Test Plugin']
         [menu_link] = [ml for ml in category.get_children()
                        if isinstance(ml, MenuLink)]
         self.assertEqual('Test Menu Link', menu_link.name)
-
-
-class PluginsTestRBAC(unittest.TestCase):
-    def setUp(self):
-        conf.load_test_config()
-        self.app, self.appbuilder = application.create_app(testing=True)
-
-    def test_flaskappbuilder_views(self):
-        from tests.plugins.test_plugin import v_appbuilder_package
-        appbuilder_class_name = str(v_appbuilder_package['view'].__class__.__name__)
-        plugin_views = [view for view in self.appbuilder.baseviews
-                        if view.blueprint.name == appbuilder_class_name]
-
-        self.assertTrue(len(plugin_views) == 1)
-
-        # view should have a menu item matching category of v_appbuilder_package
-        links = [menu_item for menu_item in self.appbuilder.menu.menu
-                 if menu_item.name == v_appbuilder_package['category']]
-
-        self.assertTrue(len(links) == 1)
-
-        # menu link should also have a link matching the name of the package.
-        link = links[0]
-        self.assertEqual(link.name, v_appbuilder_package['category'])
-        self.assertEqual(link.childs[0].name, v_appbuilder_package['name'])
-
-    def test_flaskappbuilder_menu_links(self):
-        from tests.plugins.test_plugin import appbuilder_mitem
-
-        # menu item should exist matching appbuilder_mitem
-        links = [menu_item for menu_item in self.appbuilder.menu.menu
-                 if menu_item.name == appbuilder_mitem['category']]
-
-        self.assertTrue(len(links) == 1)
-
-        # menu link should also have a link matching the name of the package.
-        link = links[0]
-        self.assertEqual(link.name, appbuilder_mitem['category'])
-        self.assertEqual(link.childs[0].name, appbuilder_mitem['name'])

From 8be42200ee20a74f2da4928b445f78c06ad5fc11 Mon Sep 17 00:00:00 2001
From: "Drew J. Sonne" <drew.sonne@gmail.com>
Date: Thu, 10 Jan 2019 23:03:59 +0000
Subject: [PATCH 391/808] [AIRFLOW-3605] Load plugins from entry_points (#4412)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* [AIRFLOW-3605] Add entrypoint plugin docs

This documentation came from https://github.com/apache/incubator-airflow/pull/730 which had already started work on a PR for this functionality.

* [AIRFLOW-3605] Extend plugin loading functionality

Added business logic to import AirflowPlugin classes through entry_points.
This means we don’t have to interact with the file system directly to install plugins, and can manage them via `pip`.
---
 airflow/plugins_manager.py                | 68 ++++++++++++++++++++---
 docs/plugins.rst                          | 53 ++++++++++++++++++
 tests/plugins/test_plugin.py              | 12 ++++
 tests/plugins/test_plugins_manager_www.py | 54 ++++++++++++++++++
 4 files changed, 180 insertions(+), 7 deletions(-)

diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index c589e9b5a91ea..b74c35e56045a 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -28,6 +28,7 @@
 import os
 import re
 import sys
+import pkg_resources
 
 from airflow import configuration
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -57,6 +58,59 @@ def validate(cls):
         if not cls.name:
             raise AirflowPluginException("Your plugin needs a name.")
 
+    @classmethod
+    def on_load(cls, *args, **kwargs):
+        """
+        Executed when the plugin is loaded.
+        This method is only called once during runtime.
+
+        :param args: If future arguments are passed in on call.
+        :param kwargs: If future arguments are passed in on call.
+        """
+        pass
+
+
+def load_entrypoint_plugins(entry_points, airflow_plugins):
+    """
+    Load AirflowPlugin subclasses from the entrypoints
+    provided. The entry_point group should be 'airflow.plugins'.
+
+    :param entry_points: A collection of entrypoints to search for plugins
+    :type entry_points: Generator[setuptools.EntryPoint, None, None]
+    :param airflow_plugins: A collection of existing airflow plugins to
+        ensure we don't load duplicates
+    :type airflow_plugins: List[AirflowPlugin]
+    :return: List[Type[AirflowPlugin]]
+    """
+    for entry_point in entry_points:
+        log.debug('Importing entry_point plugin %s', entry_point.name)
+        plugin_obj = entry_point.load()
+        if is_valid_plugin(plugin_obj, airflow_plugins):
+            if callable(getattr(plugin_obj, 'on_load', None)):
+                plugin_obj.on_load()
+                airflow_plugins.append(plugin_obj)
+    return airflow_plugins
+
+
+def is_valid_plugin(plugin_obj, existing_plugins):
+    """
+    Check whether a potential object is a subclass of
+    the AirflowPlugin class.
+
+    :param plugin_obj: potential subclass of AirflowPlugin
+    :param existing_plugins: Existing list of AirflowPlugin subclasses
+    :return: Whether or not the obj is a valid subclass of
+        AirflowPlugin
+    """
+    if (
+        inspect.isclass(plugin_obj) and
+        issubclass(plugin_obj, AirflowPlugin) and
+        (plugin_obj is not AirflowPlugin)
+    ):
+        plugin_obj.validate()
+        return plugin_obj not in existing_plugins
+    return False
+
 
 plugins_folder = configuration.conf.get('core', 'plugins_folder')
 if not plugins_folder:
@@ -88,18 +142,18 @@ def validate(cls):
 
             m = imp.load_source(namespace, filepath)
             for obj in list(m.__dict__.values()):
-                if (
-                        inspect.isclass(obj) and
-                        issubclass(obj, AirflowPlugin) and
-                        obj is not AirflowPlugin):
-                    obj.validate()
-                    if obj not in plugins:
-                        plugins.append(obj)
+                if is_valid_plugin(obj, plugins):
+                    plugins.append(obj)
 
         except Exception as e:
             log.exception(e)
             log.error('Failed to import plugin %s', filepath)
 
+plugins = load_entrypoint_plugins(
+    pkg_resources.iter_entry_points('airflow.plugins'),
+    plugins
+)
+
 
 def make_module(name, objects):
     log.debug('Creating module %s', name)
diff --git a/docs/plugins.rst b/docs/plugins.rst
index 715211281b818..a5662da47962c 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -198,3 +198,56 @@ Note on role based views
 Airflow 1.10 introduced role based views using FlaskAppBuilder. You can configure which UI is used by setting
 rbac = True. To support plugin views and links for both versions of the UI and maintain backwards compatibility,
 the fields appbuilder_views and appbuilder_menu_items were added to the AirflowTestPlugin class.
+
+
+Plugins as Python packages
+--------------------------
+
+It is possible to load plugins via `setuptools' entrypoint<https://packaging.python.org/guides/creating-and-discovering-plugins/#using-package-metadata>`_ mechanism. To do this link
+your plugin using an entrypoint in your package. If the package is installed, airflow
+will automatically load the registered plugins from the entrypoint list.
+
+_Note_: Neither the entrypoint name (eg, `my_plugin`) nor the name of the
+plugin class will contribute towards the module and class name of the plugin
+itself. The structure is determined by
+`airflow.plugins_manager.AirflowPlugin.name` and the class name of the plugin
+component with the pattern `airflow.{component}.{name}.{component_class_name}`.
+
+.. code-block:: python
+
+    # my_package/my_plugin.py
+    from airflow.plugins_manager import AirflowPlugin
+    from airflow.models import BaseOperator
+    from airflow.hooks.base_hook import BaseHook
+
+    class MyOperator(BaseOperator):
+      pass
+
+    class MyHook(BaseHook):
+      pass
+
+    class MyAirflowPlugin(AirflowPlugin):
+      name = 'my_namespace'
+      operators = [MyOperator]
+      hooks = [MyHook]
+
+
+.. code-block:: python
+
+    from setuptools import setup
+
+    setup(
+        name="my-package",
+        ...
+        entry_points = {
+            'airflow.plugins': [
+                'my_plugin = my_package.my_plugin:MyAirflowPlugin'
+            ]
+        }
+    )
+
+::
+
+This will create a hook, and an operator accessible at:
+ - `airflow.hooks.my_namespace.MyHook`
+ - `airflow.operators.my_namespace.MyOperator`
diff --git a/tests/plugins/test_plugin.py b/tests/plugins/test_plugin.py
index 68aa989a2e2bc..8bf0416b220ae 100644
--- a/tests/plugins/test_plugin.py
+++ b/tests/plugins/test_plugin.py
@@ -117,3 +117,15 @@ class AirflowTestPlugin(AirflowPlugin):
     menu_links = [ml]
     appbuilder_views = [v_appbuilder_package]
     appbuilder_menu_items = [appbuilder_mitem]
+
+
+class MockPluginA(AirflowPlugin):
+    name = 'plugin-a'
+
+
+class MockPluginB(AirflowPlugin):
+    name = 'plugin-b'
+
+
+class MockPluginC(AirflowPlugin):
+    name = 'plugin-c'
diff --git a/tests/plugins/test_plugins_manager_www.py b/tests/plugins/test_plugins_manager_www.py
index 130bd32c738c7..d47feb6e76a2f 100644
--- a/tests/plugins/test_plugins_manager_www.py
+++ b/tests/plugins/test_plugins_manager_www.py
@@ -23,15 +23,18 @@
 from __future__ import unicode_literals
 
 import unittest
+from mock import MagicMock, PropertyMock
 
 from flask.blueprints import Blueprint
 from flask_admin.menu import MenuLink, MenuView
 
 from airflow.hooks.base_hook import BaseHook
 from airflow.models import BaseOperator
+from airflow.plugins_manager import load_entrypoint_plugins, is_valid_plugin
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.executors.base_executor import BaseExecutor
 from airflow.www.app import create_app
+from tests.plugins.test_plugin import MockPluginA, MockPluginB, MockPluginC
 
 
 class PluginsTest(unittest.TestCase):
@@ -83,3 +86,54 @@ def test_menu_links(self):
         [menu_link] = [ml for ml in category.get_children()
                        if isinstance(ml, MenuLink)]
         self.assertEqual('Test Menu Link', menu_link.name)
+
+
+class PluginsTestEntrypointLoad(unittest.TestCase):
+
+    def setUp(self):
+        self.expected = [MockPluginA, MockPluginB, MockPluginC]
+        self.entrypoints = [
+            self._build_mock(plugin_obj)
+            for plugin_obj in self.expected
+        ]
+
+    def _build_mock(self, plugin_obj):
+        m = MagicMock(**{
+            'load.return_value': plugin_obj
+        })
+        type(m).name = PropertyMock(return_value='plugin-' + plugin_obj.name)
+        return m
+
+    def test_load_entrypoint_plugins(self):
+        self.assertListEqual(
+            load_entrypoint_plugins(self.entrypoints, []),
+            self.expected
+        )
+
+    def test_failed_load_entrpoint_plugins(self):
+        self.assertListEqual(
+            load_entrypoint_plugins(
+                self.entrypoints[:2] + [self._build_mock(
+                    MagicMock(name='other')
+                )], []),
+            self.expected[:2]
+        )
+
+
+class PluginsTestValidator(unittest.TestCase):
+    def setUp(self):
+        self.existing = [MockPluginA, MockPluginB]
+
+    def test_valid_plugin(self):
+        c = MockPluginC
+        self.assertTrue(
+            is_valid_plugin(
+                c, self.existing
+            ))
+
+    def test_invalid_plugin(self):
+        c = MockPluginC
+        self.assertFalse(
+            is_valid_plugin(
+                c, self.existing + [c]
+            ))

From adec5e5a1223942ed9635e31ef86e80a2f32283e Mon Sep 17 00:00:00 2001
From: Tobias Kaymak <tobias.kaymak@ricardo.ch>
Date: Thu, 10 Jan 2019 18:57:15 +0100
Subject: [PATCH 392/808] [AIRFLOW-3657] Fix zendesk integration (#4466)

---
 airflow/hooks/zendesk_hook.py            | 3 ++-
 tests/contrib/hooks/test_zendesk_hook.py | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/airflow/hooks/zendesk_hook.py b/airflow/hooks/zendesk_hook.py
index 3cf8353344f11..a6f758345018b 100644
--- a/airflow/hooks/zendesk_hook.py
+++ b/airflow/hooks/zendesk_hook.py
@@ -33,7 +33,8 @@ def __init__(self, zendesk_conn_id):
     def get_conn(self):
         conn = self.get_connection(self.__zendesk_conn_id)
         self.__url = "https://" + conn.host
-        return Zendesk(self.__url, conn.login, conn.password, True)
+        return Zendesk(zdesk_url=self.__url, zdesk_email=conn.login, zdesk_password=conn.password,
+                       zdesk_token=True)
 
     def __handle_rate_limit_exception(self, rate_limit_exception):
         """
diff --git a/tests/contrib/hooks/test_zendesk_hook.py b/tests/contrib/hooks/test_zendesk_hook.py
index 99dd8926dc40b..51be042086969 100644
--- a/tests/contrib/hooks/test_zendesk_hook.py
+++ b/tests/contrib/hooks/test_zendesk_hook.py
@@ -92,8 +92,8 @@ def test_zdesk_is_inited_correctly(self, mock_zendesk):
         zendesk_hook = ZendeskHook("conn_id")
         zendesk_hook.get_connection = mock.Mock(return_value=conn_mock)
         zendesk_hook.get_conn()
-        mock_zendesk.assert_called_with('https://conn_host', 'conn_login',
-                                        'conn_pass', True)
+        mock_zendesk.assert_called_with(zdesk_url='https://conn_host', zdesk_email='conn_login',
+                                        zdesk_password='conn_pass', zdesk_token=True)
 
     @mock.patch("airflow.hooks.zendesk_hook.Zendesk")
     def test_zdesk_sideloading_works_correctly(self, mock_zendesk):

From 22ae7a1f248164f7e2327c36b1ae99d6c8915111 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 10 Jan 2019 14:58:29 +0800
Subject: [PATCH 393/808] [AIRFLOW-3504] Refine the functionality of "/health"
 endpoint (#4309)

---
 airflow/config_templates/default_airflow.cfg |  5 ++
 airflow/config_templates/default_test.cfg    |  1 +
 airflow/www/blueprints.py                    | 45 ++++++++++++--
 airflow/www/views.py                         |  1 -
 airflow/www_rbac/blueprints.py               | 10 +--
 airflow/www_rbac/views.py                    | 38 +++++++++++-
 docs/howto/check-health.rst                  | 47 ++++++++++++++
 docs/howto/index.rst                         |  1 +
 tests/core.py                                | 65 +++++++++++++++++++-
 tests/www_rbac/test_views.py                 | 64 ++++++++++++++++++-
 10 files changed, 257 insertions(+), 20 deletions(-)
 create mode 100644 docs/howto/check-health.rst

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 585275cd92470..a7c180a556872 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -447,6 +447,11 @@ dag_dir_list_interval = 300
 # How often should stats be printed to the logs
 print_stats_interval = 30
 
+# If the last scheduler heartbeat happened more than scheduler_health_check_threshold ago (in seconds),
+# scheduler is considered unhealthy.
+# This is used by the health check in the "/health" endpoint
+scheduler_health_check_threshold = 30
+
 child_process_log_directory = {AIRFLOW_HOME}/logs/scheduler
 
 # Local task jobs periodically heartbeat to the DB. If the job has
diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index 7d8347efa2341..887d7a9c8fedd 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -110,6 +110,7 @@ docker_image_slave = test/docker-airflow
 [scheduler]
 job_heartbeat_sec = 1
 scheduler_heartbeat_sec = 5
+scheduler_health_check_threshold = 30
 authenticate = true
 max_threads = 2
 catchup_by_default = True
diff --git a/airflow/www/blueprints.py b/airflow/www/blueprints.py
index eb92837fe3b7e..e964081f8a1a2 100644
--- a/airflow/www/blueprints.py
+++ b/airflow/www/blueprints.py
@@ -17,10 +17,16 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+from datetime import timedelta
 from flask import (
-    url_for, Markup, Blueprint, redirect,
+    url_for, Blueprint, redirect,
 )
-import markdown
+from sqlalchemy import func
+
+from airflow import configuration as conf
+from airflow import jobs, settings
+from airflow.utils import timezone
+from airflow.www import utils as wwwutils
 
 routes = Blueprint('routes', __name__)
 
@@ -32,6 +38,35 @@ def index():
 
 @routes.route('/health')
 def health():
-    """ We can add an array of tests here to check the server's health """
-    content = Markup(markdown.markdown("The server is healthy!"))
-    return content
+    """
+    An endpoint helping check the health status of the Airflow instance,
+    including metadatabase and scheduler.
+    """
+    session = settings.Session()
+    BJ = jobs.BaseJob
+    payload = {}
+    scheduler_health_check_threshold = timedelta(seconds=conf.getint('scheduler',
+                                                                     'scheduler_health_check_threshold'
+                                                                     ))
+
+    latest_scheduler_heartbeat = None
+    payload['metadatabase'] = {'status': 'healthy'}
+    try:
+        latest_scheduler_heartbeat = session.query(func.max(BJ.latest_heartbeat)). \
+            filter(BJ.state == 'running', BJ.job_type == 'SchedulerJob'). \
+            scalar()
+    except Exception:
+        payload['metadatabase']['status'] = 'unhealthy'
+
+    if not latest_scheduler_heartbeat:
+        scheduler_status = 'unhealthy'
+    else:
+        if timezone.utcnow() - latest_scheduler_heartbeat <= scheduler_health_check_threshold:
+            scheduler_status = 'healthy'
+        else:
+            scheduler_status = 'unhealthy'
+
+    payload['scheduler'] = {'status': scheduler_status,
+                            'latest_scheduler_heartbeat': str(latest_scheduler_heartbeat)}
+
+    return wwwutils.json_response(payload)
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 9f34b9c440085..e0ba13e5fdcac 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -379,7 +379,6 @@ def index(self):
     @expose('/chart_data')
     @data_profiling_required
     @wwwutils.gzipped
-    # @cache.cached(timeout=3600, key_prefix=wwwutils.make_cache_key)
     def chart_data(self):
         from airflow import macros
         import pandas as pd
diff --git a/airflow/www_rbac/blueprints.py b/airflow/www_rbac/blueprints.py
index 75bbb93aeadc9..dfa29f19caa38 100644
--- a/airflow/www_rbac/blueprints.py
+++ b/airflow/www_rbac/blueprints.py
@@ -17,8 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-from flask import Markup, Blueprint, redirect
-import markdown
+from flask import Blueprint, redirect
 
 routes = Blueprint('routes', __name__)
 
@@ -26,10 +25,3 @@
 @routes.route('/')
 def index():
     return redirect('/home')
-
-
-@routes.route('/health')
-def health():
-    """ We can add an array of tests here to check the server's health """
-    content = Markup(markdown.markdown("The server is healthy!"))
-    return content
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 767ef4aef037c..fc70f74a62581 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -45,7 +45,7 @@
 from past.builtins import unicode
 from pygments import highlight, lexers
 from pygments.formatters import HtmlFormatter
-from sqlalchemy import or_, desc, and_, union_all
+from sqlalchemy import func, or_, desc, and_, union_all
 from wtforms import SelectField, validators
 
 import airflow
@@ -146,6 +146,42 @@ def render(self, template, **context):
 
 
 class Airflow(AirflowBaseView):
+    @expose('/health')
+    @provide_session
+    def health(self, session=None):
+        """
+        An endpoint helping check the health status of the Airflow instance,
+        including metadatabase and scheduler.
+        """
+
+        BJ = jobs.BaseJob
+        payload = {}
+        scheduler_health_check_threshold = timedelta(seconds=conf.getint('scheduler',
+                                                                         'scheduler_health_check_threshold'
+                                                                         ))
+
+        latest_scheduler_heartbeat = None
+        payload['metadatabase'] = {'status': 'healthy'}
+        try:
+            latest_scheduler_heartbeat = session.query(func.max(BJ.latest_heartbeat)).\
+                filter(BJ.state == 'running', BJ.job_type == 'SchedulerJob').\
+                scalar()
+        except Exception:
+            payload['metadatabase']['status'] = 'unhealthy'
+
+        if not latest_scheduler_heartbeat:
+            scheduler_status = 'unhealthy'
+        else:
+            if timezone.utcnow() - latest_scheduler_heartbeat <= scheduler_health_check_threshold:
+                scheduler_status = 'healthy'
+            else:
+                scheduler_status = 'unhealthy'
+
+        payload['scheduler'] = {'status': scheduler_status,
+                                'latest_scheduler_heartbeat': str(latest_scheduler_heartbeat)}
+
+        return wwwutils.json_response(payload)
+
     @expose('/home')
     @has_access
     @provide_session
diff --git a/docs/howto/check-health.rst b/docs/howto/check-health.rst
new file mode 100644
index 0000000000000..e18026f1e2802
--- /dev/null
+++ b/docs/howto/check-health.rst
@@ -0,0 +1,47 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Checking Airflow Health Status
+==============================
+
+To check the health status of your Airflow instance, you can simply access the endpoint
+``"/health"``. It will return a JSON object in which a high-level glance is provided.
+
+.. code-block:: JSON
+
+  {
+    "metadatabase":{
+      "status":"healthy"
+    },
+    "scheduler":{
+      "status":"healthy",
+      "latest_scheduler_heartbeat":"2018-12-26 17:15:11+00:00"
+    }
+  }
+
+* The ``status`` of each component can be either "healthy" or "unhealthy".
+
+    * The status of ``metadatabase`` is depending on whether a valid connection can be initiated
+      with the database backend of Airflow.
+    * The status of ``scheduler`` is depending on when the latest scheduler heartbeat happened. If the latest
+      scheduler heartbeat happened 30 seconds (default value) earlier than the current time, scheduler component is
+      considered unhealthy. You can also specify this threshold value by changing
+      ``scheduler_health_check_threshold`` in ``scheduler`` section of the ``airflow.cfg`` file.
+
+* The response code of ``"/health"`` endpoint is not used to label the health status of the
+  application (it would always be 200). Hence please be reminded not to use the response code here
+  for health-check purpose.
diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index 8a19a9ecb40a2..c83df3632de91 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -39,3 +39,4 @@ configuring an Airflow environment.
     run-with-systemd
     run-with-upstart
     use-test-config
+    check-health
diff --git a/tests/core.py b/tests/core.py
index f0c25dd898fd1..9ca7112276edb 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1898,8 +1898,69 @@ def test_query(self):
         self.assertIn("TEST", response.data.decode('utf-8'))
 
     def test_health(self):
-        response = self.app.get('/health')
-        self.assertIn('The server is healthy!', response.data.decode('utf-8'))
+        BJ = jobs.BaseJob
+        session = Session()
+
+        # case-1: healthy scheduler status
+        last_scheduler_heartbeat_for_testing_1 = timezone.utcnow()
+        session.add(BJ(job_type='SchedulerJob',
+                       state='running',
+                       latest_heartbeat=last_scheduler_heartbeat_for_testing_1))
+        session.commit()
+
+        response_json = json.loads(self.app.get('/health').data.decode('utf-8'))
+
+        self.assertEqual('healthy', response_json['metadatabase']['status'])
+        self.assertEqual('healthy', response_json['scheduler']['status'])
+        self.assertEqual(str(last_scheduler_heartbeat_for_testing_1),
+                         response_json['scheduler']['latest_scheduler_heartbeat'])
+
+        session.query(BJ).\
+            filter(BJ.job_type == 'SchedulerJob',
+                   BJ.state == 'running',
+                   BJ.latest_heartbeat == last_scheduler_heartbeat_for_testing_1).\
+            delete()
+        session.commit()
+
+        # case-2: unhealthy scheduler status - scenario 1 (SchedulerJob is running too slowly)
+        last_scheduler_heartbeat_for_testing_2 = timezone.utcnow() - timedelta(minutes=1)
+        (session.query(BJ)
+                .filter(BJ.job_type == 'SchedulerJob')
+                .update({'latest_heartbeat': last_scheduler_heartbeat_for_testing_2 - timedelta(seconds=1)}))
+        session.add(BJ(job_type='SchedulerJob',
+                       state='running',
+                       latest_heartbeat=last_scheduler_heartbeat_for_testing_2))
+        session.commit()
+
+        response_json = json.loads(self.app.get('/health').data.decode('utf-8'))
+
+        self.assertEqual('healthy', response_json['metadatabase']['status'])
+        self.assertEqual('unhealthy', response_json['scheduler']['status'])
+        self.assertEqual(str(last_scheduler_heartbeat_for_testing_2),
+                         response_json['scheduler']['latest_scheduler_heartbeat'])
+
+        session.query(BJ).\
+            filter(BJ.job_type == 'SchedulerJob',
+                   BJ.state == 'running',
+                   BJ.latest_heartbeat == last_scheduler_heartbeat_for_testing_1).\
+            delete()
+        session.commit()
+
+        # case-3: unhealthy scheduler status - scenario 2 (no running SchedulerJob)
+        session.query(BJ).\
+            filter(BJ.job_type == 'SchedulerJob',
+                   BJ.state == 'running').\
+            delete()
+        session.commit()
+
+        response_json = json.loads(self.app.get('/health').data.decode('utf-8'))
+
+        self.assertEqual('healthy', response_json['metadatabase']['status'])
+        self.assertEqual('unhealthy', response_json['scheduler']['status'])
+        self.assertEqual('None',
+                         response_json['scheduler']['latest_scheduler_heartbeat'])
+
+        session.close()
 
     def test_noaccess(self):
         response = self.app.get('/admin/airflow/noaccess')
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 3e583507b9ba5..a264adf4027b7 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -29,6 +29,7 @@
 import unittest
 import urllib
 
+from datetime import timedelta
 from flask._compat import PY2
 from urllib.parse import quote_plus
 from werkzeug.test import Client
@@ -36,6 +37,7 @@
 from airflow import configuration as conf
 from airflow import models, settings
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
+from airflow.jobs import BaseJob
 from airflow.models import DAG, DagRun, TaskInstance
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.settings import Session
@@ -325,8 +327,66 @@ def test_index(self):
         self.check_content_in_response('DAGs', resp)
 
     def test_health(self):
-        resp = self.client.get('health', follow_redirects=True)
-        self.check_content_in_response('The server is healthy!', resp)
+
+        # case-1: healthy scheduler status
+        last_scheduler_heartbeat_for_testing_1 = timezone.utcnow()
+        self.session.add(BaseJob(job_type='SchedulerJob',
+                                 state='running',
+                                 latest_heartbeat=last_scheduler_heartbeat_for_testing_1))
+        self.session.commit()
+
+        resp_json = json.loads(self.client.get('health', follow_redirects=True).data.decode('utf-8'))
+
+        self.assertEqual('healthy', resp_json['metadatabase']['status'])
+        self.assertEqual('healthy', resp_json['scheduler']['status'])
+        self.assertEqual(str(last_scheduler_heartbeat_for_testing_1),
+                         resp_json['scheduler']['latest_scheduler_heartbeat'])
+
+        self.session.query(BaseJob).\
+            filter(BaseJob.job_type == 'SchedulerJob',
+                   BaseJob.state == 'running',
+                   BaseJob.latest_heartbeat == last_scheduler_heartbeat_for_testing_1).\
+            delete()
+        self.session.commit()
+
+        # case-2: unhealthy scheduler status - scenario 1 (SchedulerJob is running too slowly)
+        last_scheduler_heartbeat_for_testing_2 = timezone.utcnow() - timedelta(minutes=1)
+        (self.session
+             .query(BaseJob)
+             .filter(BaseJob.job_type == 'SchedulerJob')
+             .update({'latest_heartbeat': last_scheduler_heartbeat_for_testing_2 - timedelta(seconds=1)}))
+        self.session.add(BaseJob(job_type='SchedulerJob',
+                                 state='running',
+                                 latest_heartbeat=last_scheduler_heartbeat_for_testing_2))
+        self.session.commit()
+
+        resp_json = json.loads(self.client.get('health', follow_redirects=True).data.decode('utf-8'))
+
+        self.assertEqual('healthy', resp_json['metadatabase']['status'])
+        self.assertEqual('unhealthy', resp_json['scheduler']['status'])
+        self.assertEqual(str(last_scheduler_heartbeat_for_testing_2),
+                         resp_json['scheduler']['latest_scheduler_heartbeat'])
+
+        self.session.query(BaseJob).\
+            filter(BaseJob.job_type == 'SchedulerJob',
+                   BaseJob.state == 'running',
+                   BaseJob.latest_heartbeat == last_scheduler_heartbeat_for_testing_2).\
+            delete()
+        self.session.commit()
+
+        # case-3: unhealthy scheduler status - scenario 2 (no running SchedulerJob)
+        self.session.query(BaseJob).\
+            filter(BaseJob.job_type == 'SchedulerJob',
+                   BaseJob.state == 'running').\
+            delete()
+        self.session.commit()
+
+        resp_json = json.loads(self.client.get('health', follow_redirects=True).data.decode('utf-8'))
+
+        self.assertEqual('healthy', resp_json['metadatabase']['status'])
+        self.assertEqual('unhealthy', resp_json['scheduler']['status'])
+        self.assertEqual('None',
+                         resp_json['scheduler']['latest_scheduler_heartbeat'])
 
     def test_home(self):
         resp = self.client.get('home', follow_redirects=True)

From b1b15b231ab0ed4d417b308769b0eb92b31ad599 Mon Sep 17 00:00:00 2001
From: Ant Weiss <antweiss@users.noreply.github.com>
Date: Fri, 11 Jan 2019 21:04:54 +0200
Subject: [PATCH 394/808] [AIRFLOW-3197] Remove invalid parameter
 KeepJobFlowAliveWhenNoSteps in example DAG (#4404)

The parameter 'KeepJobFlowAliveWhenNoSteps' in  JOB_FLOW_OVERRIDES doesn't pass boto API parameter validation, as it should be a part of 'Instances' object.

Signed-off-by: Anton Weiss <anton@otomato.link>
---
 .../contrib/example_dags/example_emr_job_flow_manual_steps.py  | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/airflow/contrib/example_dags/example_emr_job_flow_manual_steps.py b/airflow/contrib/example_dags/example_emr_job_flow_manual_steps.py
index 48a178a2a954c..ba5b923007511 100644
--- a/airflow/contrib/example_dags/example_emr_job_flow_manual_steps.py
+++ b/airflow/contrib/example_dags/example_emr_job_flow_manual_steps.py
@@ -54,8 +54,7 @@
 ]
 
 JOB_FLOW_OVERRIDES = {
-    'Name': 'PiCalc',
-    'KeepJobFlowAliveWhenNoSteps': True
+    'Name': 'PiCalc'
 }
 
 dag = DAG(

From c21900af67ca258af6a35720ea4c909fd28b82a6 Mon Sep 17 00:00:00 2001
From: Mike Mole <mikemole@gmail.com>
Date: Fri, 11 Jan 2019 14:35:08 -0500
Subject: [PATCH 395/808] [AIRFLOW-3212] Add AwsGlueCatalogPartitionSensor
 (#4112)

Adds AwsGlueCatalogPartitionSensor and AwsGlueCatalogHook with
supporting functions. Unit tests are included but rely on mocking since
Moto does not yet fully support AWS Glue Catalog at this time.
---
 .../contrib/hooks/aws_glue_catalog_hook.py    | 118 ++++++++++++++++++
 .../aws_glue_catalog_partition_sensor.py      |  93 ++++++++++++++
 docs/code.rst                                 |   2 +
 setup.py                                      |   2 +-
 .../hooks/test_aws_glue_catalog_hook.py       | 110 ++++++++++++++++
 .../test_aws_glue_catalog_partition_sensor.py | 118 ++++++++++++++++++
 6 files changed, 442 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/hooks/aws_glue_catalog_hook.py
 create mode 100644 airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
 create mode 100644 tests/contrib/hooks/test_aws_glue_catalog_hook.py
 create mode 100644 tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py

diff --git a/airflow/contrib/hooks/aws_glue_catalog_hook.py b/airflow/contrib/hooks/aws_glue_catalog_hook.py
new file mode 100644
index 0000000000000..687f0fddb99c5
--- /dev/null
+++ b/airflow/contrib/hooks/aws_glue_catalog_hook.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+
+
+class AwsGlueCatalogHook(AwsHook):
+    """
+    Interact with AWS Glue Catalog
+
+    :param aws_conn_id: ID of the Airflow connection where
+        credentials and extra configuration are stored
+    :type aws_conn_id: str
+    :param region_name: aws region name (example: us-east-1)
+    :type region_name: str
+    """
+
+    def __init__(self,
+                 aws_conn_id='aws_default',
+                 region_name=None,
+                 *args,
+                 **kwargs):
+        self.region_name = region_name
+        super(AwsGlueCatalogHook, self).__init__(aws_conn_id=aws_conn_id, *args, **kwargs)
+
+    def get_conn(self):
+        """
+        Returns glue connection object.
+        """
+        self.conn = self.get_client_type('glue', self.region_name)
+        return self.conn
+
+    def get_partitions(self,
+                       database_name,
+                       table_name,
+                       expression='',
+                       page_size=None,
+                       max_items=None):
+        """
+        Retrieves the partition values for a table.
+
+        :param database_name: The name of the catalog database where the partitions reside.
+        :type database_name: str
+        :param table_name: The name of the partitions' table.
+        :type table_name: str
+        :param expression: An expression filtering the partitions to be returned.
+            Please see official AWS documentation for further information.
+            https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-catalog-partitions.html#aws-glue-api-catalog-partitions-GetPartitions
+        :type expression: str
+        :param page_size: pagination size
+        :type page_size: int
+        :param max_items: maximum items to return
+        :type max_items: int
+        :return: set of partition values where each value is a tuple since
+            a partition may be composed of multiple columns. For example:
+        {('2018-01-01','1'), ('2018-01-01','2')}
+        """
+        config = {
+            'PageSize': page_size,
+            'MaxItems': max_items,
+        }
+
+        paginator = self.get_conn().get_paginator('get_partitions')
+        response = paginator.paginate(
+            DatabaseName=database_name,
+            TableName=table_name,
+            Expression=expression,
+            PaginationConfig=config
+        )
+
+        partitions = set()
+        for page in response:
+            for p in page['Partitions']:
+                partitions.add(tuple(p['Values']))
+
+        return partitions
+
+    def check_for_partition(self, database_name, table_name, expression):
+        """
+        Checks whether a partition exists
+
+        :param database_name: Name of hive database (schema) @table belongs to
+        :type database_name: str
+        :param table_name: Name of hive table @partition belongs to
+        :type table_name: str
+        :expression: Expression that matches the partitions to check for
+            (eg `a = 'b' AND c = 'd'`)
+        :type expression: str
+        :rtype: bool
+
+        >>> hook = AwsGlueCatalogHook()
+        >>> t = 'static_babynames_partitioned'
+        >>> hook.check_for_partition('airflow', t, "ds='2015-01-01'")
+        True
+        """
+        partitions = self.get_partitions(database_name, table_name, expression, max_items=1)
+
+        if partitions:
+            return True
+        else:
+            return False
diff --git a/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py b/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
new file mode 100644
index 0000000000000..74e25a29dc4ff
--- /dev/null
+++ b/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class AwsGlueCatalogPartitionSensor(BaseSensorOperator):
+    """
+    Waits for a partition to show up in AWS Glue Catalog.
+
+    :param table_name: The name of the table to wait for, supports the dot
+        notation (my_database.my_table)
+    :type table_name: str
+    :param expression: The partition clause to wait for. This is passed as
+        is to the AWS Glue Catalog API's get_partitions function,
+        and supports SQL like notation as in ``ds='2015-01-01'
+        AND type='value'`` and comparison operators as in ``"ds>=2015-01-01"``.
+        See https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-catalog-partitions.html
+        #aws-glue-api-catalog-partitions-GetPartitions
+    :type expression: str
+    :param aws_conn_id: ID of the Airflow connection where
+        credentials and extra configuration are stored
+    :type aws_conn_id: str
+    :param region_name: Optional aws region name (example: us-east-1). Uses region from connection
+        if not specified.
+    :type region_name: str
+    :param database_name: The name of the catalog database where the partitions reside.
+    :type database_name: str
+    :param poke_interval: Time in seconds that the job should wait in
+        between each tries
+    :type poke_interval: int
+    """
+    template_fields = ('database_name', 'table_name', 'expression',)
+    ui_color = '#C5CAE9'
+
+    @apply_defaults
+    def __init__(self,
+                 table_name, expression="ds='{{ ds }}'",
+                 aws_conn_id='aws_default',
+                 region_name=None,
+                 database_name='default',
+                 poke_interval=60 * 3,
+                 *args,
+                 **kwargs):
+        super(AwsGlueCatalogPartitionSensor, self).__init__(
+            poke_interval=poke_interval, *args, **kwargs)
+        self.aws_conn_id = aws_conn_id
+        self.region_name = region_name
+        self.table_name = table_name
+        self.expression = expression
+        self.database_name = database_name
+
+    def poke(self, context):
+        """
+        Checks for existence of the partition in the AWS Glue Catalog table
+        """
+        if '.' in self.table_name:
+            self.database_name, self.table_name = self.table_name.split('.')
+        self.log.info(
+            'Poking for table {self.database_name}.{self.table_name}, '
+            'expression {self.expression}'.format(**locals()))
+
+        return self.get_hook().check_for_partition(
+            self.database_name, self.table_name, self.expression)
+
+    def get_hook(self):
+        """
+        Gets the AwsGlueCatalogHook
+        """
+        if not hasattr(self, 'hook'):
+            from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
+            self.hook = AwsGlueCatalogHook(
+                aws_conn_id=self.aws_conn_id,
+                region_name=self.region_name)
+
+        return self.hook
diff --git a/docs/code.rst b/docs/code.rst
index 39bc2418e732d..d8c5dab8bd7c0 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -232,6 +232,7 @@ Sensors
 ^^^^^^^
 
 .. autoclass:: airflow.contrib.sensors.aws_athena_sensor.AthenaSensor
+.. autoclass:: airflow.contrib.sensors.aws_glue_catalog_partition_sensor.AwsGlueCatalogPartitionSensor
 .. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
 .. autoclass:: airflow.contrib.sensors.bash_sensor.BashSensor
 .. autoclass:: airflow.contrib.sensors.bigquery_sensor.BigQueryTableSensor
@@ -414,6 +415,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.aws_athena_hook.AWSAthenaHook
 .. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
 .. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
+.. autoclass:: airflow.contrib.hooks.aws_glue_catalog_hook.AwsGlueCatalogHook
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
 .. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
 .. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
diff --git a/setup.py b/setup.py
index ffda4e96aa682..4a2eb786f7a7a 100644
--- a/setup.py
+++ b/setup.py
@@ -249,7 +249,7 @@ def write_version(filename=os.path.join(*['airflow',
     'lxml>=4.0.0',
     'mock',
     'mongomock',
-    'moto==1.1.19',
+    'moto==1.3.5',
     'nose',
     'nose-ignore-docstring==0.2',
     'nose-timer',
diff --git a/tests/contrib/hooks/test_aws_glue_catalog_hook.py b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
new file mode 100644
index 0000000000000..cddc5cfb6ff3a
--- /dev/null
+++ b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
@@ -0,0 +1,110 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
+
+try:
+    from moto import mock_glue
+except ImportError:
+    mock_glue = None
+
+try:
+    from unittest import mock
+except ImportError:
+    import mock
+
+
+@unittest.skipIf(mock_glue is None,
+                 "Skipping test because moto.mock_glue is not available")
+class TestAwsGlueCatalogHook(unittest.TestCase):
+
+    @mock_glue
+    def test_get_conn_returns_a_boto3_connection(self):
+        hook = AwsGlueCatalogHook(region_name="us-east-1")
+        self.assertIsNotNone(hook.get_conn())
+
+    @mock_glue
+    def test_conn_id(self):
+        hook = AwsGlueCatalogHook(aws_conn_id='my_aws_conn_id', region_name="us-east-1")
+        self.assertEquals(hook.aws_conn_id, 'my_aws_conn_id')
+
+    @mock_glue
+    def test_region(self):
+        hook = AwsGlueCatalogHook(region_name="us-west-2")
+        self.assertEquals(hook.region_name, 'us-west-2')
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'get_conn')
+    def test_get_partitions_empty(self, mock_get_conn):
+        response = set()
+        mock_get_conn.get_paginator.paginate.return_value = response
+        hook = AwsGlueCatalogHook(region_name="us-east-1")
+
+        self.assertEquals(hook.get_partitions('db', 'tbl'), set())
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'get_conn')
+    def test_get_partitions(self, mock_get_conn):
+        response = [{
+            'Partitions': [{
+                'Values': ['2015-01-01']
+            }]
+        }]
+        mock_paginator = mock.Mock()
+        mock_paginator.paginate.return_value = response
+        mock_conn = mock.Mock()
+        mock_conn.get_paginator.return_value = mock_paginator
+        mock_get_conn.return_value = mock_conn
+        hook = AwsGlueCatalogHook(region_name="us-east-1")
+        result = hook.get_partitions('db',
+                                     'tbl',
+                                     expression='foo=bar',
+                                     page_size=2,
+                                     max_items=3)
+
+        self.assertEquals(result, set([('2015-01-01',)]))
+        mock_conn.get_paginator.assert_called_once_with('get_partitions')
+        mock_paginator.paginate.assert_called_once_with(DatabaseName='db',
+                                                        TableName='tbl',
+                                                        Expression='foo=bar',
+                                                        PaginationConfig={
+                                                            'PageSize': 2,
+                                                            'MaxItems': 3})
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'get_partitions')
+    def test_check_for_partition(self, mock_get_partitions):
+        mock_get_partitions.return_value = set([('2018-01-01',)])
+        hook = AwsGlueCatalogHook(region_name="us-east-1")
+
+        self.assertTrue(hook.check_for_partition('db', 'tbl', 'expr'))
+        mock_get_partitions.assert_called_once_with('db', 'tbl', 'expr', max_items=1)
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'get_partitions')
+    def test_check_for_partition_false(self, mock_get_partitions):
+        mock_get_partitions.return_value = set()
+        hook = AwsGlueCatalogHook(region_name="us-east-1")
+
+        self.assertFalse(hook.check_for_partition('db', 'tbl', 'expr'))
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py b/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py
new file mode 100644
index 0000000000000..fc12318e1a448
--- /dev/null
+++ b/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
+from airflow.contrib.sensors.aws_glue_catalog_partition_sensor import AwsGlueCatalogPartitionSensor
+
+try:
+    from moto import mock_glue
+except ImportError:
+    mock_glue = None
+
+try:
+    from unittest import mock
+except ImportError:
+    import mock
+
+
+@unittest.skipIf(mock_glue is None,
+                 "Skipping test because moto.mock_glue is not available")
+class TestAwsGlueCatalogPartitionSensor(unittest.TestCase):
+
+    task_id = 'test_glue_catalog_partition_sensor'
+
+    def setUp(self):
+        configuration.load_test_config()
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'check_for_partition')
+    def test_poke(self, mock_check_for_partition):
+        mock_check_for_partition.return_value = True
+        op = AwsGlueCatalogPartitionSensor(task_id=self.task_id,
+                                           table_name='tbl')
+        self.assertTrue(op.poke(None))
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'check_for_partition')
+    def test_poke_false(self, mock_check_for_partition):
+        mock_check_for_partition.return_value = False
+        op = AwsGlueCatalogPartitionSensor(task_id=self.task_id,
+                                           table_name='tbl')
+        self.assertFalse(op.poke(None))
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'check_for_partition')
+    def test_poke_default_args(self, mock_check_for_partition):
+        table_name = 'test_glue_catalog_partition_sensor_tbl'
+        op = AwsGlueCatalogPartitionSensor(task_id=self.task_id,
+                                           table_name=table_name)
+        op.poke(None)
+
+        self.assertEqual(op.hook.region_name, None)
+        self.assertEqual(op.hook.aws_conn_id, 'aws_default')
+        mock_check_for_partition.assert_called_once_with('default',
+                                                         table_name,
+                                                         "ds='{{ ds }}'")
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'check_for_partition')
+    def test_poke_nondefault_args(self, mock_check_for_partition):
+        table_name = 'my_table'
+        expression = 'col=val'
+        aws_conn_id = 'my_aws_conn_id'
+        region_name = 'us-west-2'
+        database_name = 'my_db'
+        poke_interval = 2
+        timeout = 3
+        op = AwsGlueCatalogPartitionSensor(task_id=self.task_id,
+                                           table_name=table_name,
+                                           expression=expression,
+                                           aws_conn_id=aws_conn_id,
+                                           region_name=region_name,
+                                           database_name=database_name,
+                                           poke_interval=poke_interval,
+                                           timeout=timeout)
+        op.poke(None)
+
+        self.assertEqual(op.hook.region_name, region_name)
+        self.assertEqual(op.hook.aws_conn_id, aws_conn_id)
+        self.assertEqual(op.poke_interval, poke_interval)
+        self.assertEqual(op.timeout, timeout)
+        mock_check_for_partition.assert_called_once_with(database_name,
+                                                         table_name,
+                                                         expression)
+
+    @mock_glue
+    @mock.patch.object(AwsGlueCatalogHook, 'check_for_partition')
+    def test_dot_notation(self, mock_check_for_partition):
+        db_table = 'my_db.my_tbl'
+        op = AwsGlueCatalogPartitionSensor(task_id=self.task_id,
+                                           table_name=db_table)
+        op.poke(None)
+
+        mock_check_for_partition.assert_called_once_with('my_db',
+                                                         'my_tbl',
+                                                         "ds='{{ ds }}'")
+
+
+if __name__ == '__main__':
+    unittest.main()

From a65f976bd113bb087360759f0b280ac26be1e51d Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Fri, 11 Jan 2019 19:17:20 +0100
Subject: [PATCH 396/808] [AIRFLOW-3594] Unify different License Header

---
 UPDATING.md                                   | 23 +++++++++++--------
 airflow/contrib/hooks/mongo_hook.py           | 23 +++++++++++--------
 airflow/contrib/operators/mongo_to_s3.py      | 23 +++++++++++--------
 .../executors/test_kubernetes_executor.py     | 23 +++++++++++--------
 tests/contrib/hooks/test_mongo_hook.py        | 23 +++++++++++--------
 .../operators/test_mongo_to_s3_operator.py    | 23 +++++++++++--------
 tests/dags/test_task_view_type_check.py       | 23 +++++++++++--------
 tests/hooks/test_http_hook.py                 | 23 +++++++++++--------
 tests/hooks/test_presto_hook.py               | 23 +++++++++++--------
 tests/operators/bash_operator.py              | 23 +++++++++++--------
 10 files changed, 140 insertions(+), 90 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index a287ea34e5aba..91d509d681548 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -308,17 +308,22 @@ The config can be taken from `airflow/config_templates/airflow_local_settings.py
 ```
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 import os
 
diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index c1c15e4136c47..3561aa34ffe08 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 from ssl import CERT_NONE
 
 from airflow.hooks.base_hook import BaseHook
diff --git a/airflow/contrib/operators/mongo_to_s3.py b/airflow/contrib/operators/mongo_to_s3.py
index 8bfa7a52f80bb..86a8d00413190 100644
--- a/airflow/contrib/operators/mongo_to_s3.py
+++ b/airflow/contrib/operators/mongo_to_s3.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 import json
 
 from airflow.contrib.hooks.mongo_hook import MongoHook
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 87e583b6d38c7..affde37192ad8 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 #
 
 import unittest
diff --git a/tests/contrib/hooks/test_mongo_hook.py b/tests/contrib/hooks/test_mongo_hook.py
index 3b705f1a45fba..6b7fd528e0e7d 100644
--- a/tests/contrib/hooks/test_mongo_hook.py
+++ b/tests/contrib/hooks/test_mongo_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 import unittest
 import pymongo
 try:
diff --git a/tests/contrib/operators/test_mongo_to_s3_operator.py b/tests/contrib/operators/test_mongo_to_s3_operator.py
index 6f30596ce9985..ad3e1e939fabb 100644
--- a/tests/contrib/operators/test_mongo_to_s3_operator.py
+++ b/tests/contrib/operators/test_mongo_to_s3_operator.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 import unittest
 
 from airflow import DAG
diff --git a/tests/dags/test_task_view_type_check.py b/tests/dags/test_task_view_type_check.py
index eee80581373b1..a03db8a65cec3 100644
--- a/tests/dags/test_task_view_type_check.py
+++ b/tests/dags/test_task_view_type_check.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 
 """
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index e64e59fbcae64..22797c927f274 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 import unittest
 
 import json
diff --git a/tests/hooks/test_presto_hook.py b/tests/hooks/test_presto_hook.py
index b01782ea4bb68..dbcd0d9660129 100644
--- a/tests/hooks/test_presto_hook.py
+++ b/tests/hooks/test_presto_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 #
 
 import mock
diff --git a/tests/operators/bash_operator.py b/tests/operators/bash_operator.py
index e0a0ff3ebb402..e934fdbcc4eda 100644
--- a/tests/operators/bash_operator.py
+++ b/tests/operators/bash_operator.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 import os
 import unittest

From d45a4f35169aaa7054e8058b9253f61cf99dc4b3 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 12 Jan 2019 02:01:49 +0100
Subject: [PATCH 397/808] [AIRFLOW-3679] Added Google Cloud Base Hook to
 documentation (#4487)

---
 docs/howto/operator.rst | 2 --
 docs/integration.rst    | 8 +++++++-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index aaa27e6a1484a..700fa1b9730ed 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1364,5 +1364,3 @@ More information
 See `Google Cloud Storage ObjectAccessControls insert documentation
 <https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_
 for details.
-
-
diff --git a/docs/integration.rst b/docs/integration.rst
index b3c86dada08e4..e54b6c6121285 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -547,6 +547,13 @@ Logging
 Airflow can be configured to read and write task logs in Google Cloud Storage.
 See :ref:`write-logs-gcp`.
 
+GoogleCloudBaseHook
+'''''''''''''''''''
+
+.. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
+
+.. _GoogleCloudBaseHook:
+
 BigQuery
 ''''''''
 
@@ -965,7 +972,6 @@ GcfFunctionDeleteOperator
 
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 
-
 .. _GcfHook:
 
 Cloud Functions Hook

From 8a10292b02610e94b0c132e20f46bd10b3b81a4d Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Sat, 12 Jan 2019 02:06:11 +0100
Subject: [PATCH 398/808] [AIRFLOW-3592] Fix logs when task is in rescheduled
 state (#4492)

---
 airflow/www/views.py         |  8 +++++++-
 airflow/www_rbac/views.py    |  8 +++++++-
 tests/www_rbac/test_views.py | 34 ++++++++++++++++++++++++++--------
 3 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index e0ba13e5fdcac..c81c1941f39cd 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -835,7 +835,13 @@ def log(self, session=None):
             models.TaskInstance.task_id == task_id,
             models.TaskInstance.execution_date == dttm).first()
 
-        logs = [''] * (ti.next_try_number - 1 if ti is not None else 0)
+        num_logs = 0
+        if ti is not None:
+            num_logs = ti.next_try_number - 1
+            if ti.state == State.UP_FOR_RESCHEDULE:
+                # Tasks in reschedule state decremented the try number
+                num_logs += 1
+        logs = [''] * num_logs
         return self.render(
             'airflow/ti_log.html',
             logs=logs, dag=dag, title="Log by attempts",
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index fc70f74a62581..6fd13b1bcb929 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -611,7 +611,13 @@ def log(self, session=None):
             models.TaskInstance.task_id == task_id,
             models.TaskInstance.execution_date == dttm).first()
 
-        logs = [''] * (ti.next_try_number - 1 if ti is not None else 0)
+        num_logs = 0
+        if ti is not None:
+            num_logs = ti.next_try_number - 1
+            if ti.state == State.UP_FOR_RESCHEDULE:
+                # Tasks in reschedule state decremented the try number
+                num_logs += 1
+        logs = [''] * num_logs
         return self.render(
             'airflow/ti_log.html',
             logs=logs, dag=dag, title="Log by attempts",
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index a264adf4027b7..64485718e65d9 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -31,6 +31,7 @@
 
 from datetime import timedelta
 from flask._compat import PY2
+from parameterized import parameterized
 from urllib.parse import quote_plus
 from werkzeug.test import Client
 
@@ -42,6 +43,7 @@
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.settings import Session
 from airflow.utils import dates, timezone
+from airflow.utils.db import create_session
 from airflow.utils.state import State
 from airflow.utils.timezone import datetime
 from airflow.www_rbac import app as application
@@ -585,17 +587,16 @@ def setUp(self):
         self.app.config['WTF_CSRF_ENABLED'] = False
         self.client = self.app.test_client()
         settings.configure_orm()
-        self.session = Session
         self.login()
 
         from airflow.www_rbac.views import dagbag
         dag = DAG(self.DAG_ID, start_date=self.DEFAULT_DATE)
         task = DummyOperator(task_id=self.TASK_ID, dag=dag)
         dagbag.bag_dag(dag, parent_dag=dag, root_dag=dag)
-        ti = TaskInstance(task=task, execution_date=self.DEFAULT_DATE)
-        ti.try_number = 1
-        self.session.merge(ti)
-        self.session.commit()
+        with create_session() as session:
+            self.ti = TaskInstance(task=task, execution_date=self.DEFAULT_DATE)
+            self.ti.try_number = 1
+            session.merge(self.ti)
 
     def tearDown(self):
         logging.config.dictConfig(DEFAULT_LOGGING_CONFIG)
@@ -607,14 +608,31 @@ def tearDown(self):
         self.logout()
         super(TestLogView, self).tearDown()
 
-    def test_get_file_task_log(self):
+    @parameterized.expand([
+        [State.NONE, 0, 0],
+        [State.UP_FOR_RETRY, 2, 2],
+        [State.UP_FOR_RESCHEDULE, 0, 1],
+        [State.UP_FOR_RESCHEDULE, 1, 2],
+        [State.RUNNING, 1, 1],
+        [State.SUCCESS, 1, 1],
+        [State.FAILED, 3, 3],
+    ])
+    def test_get_file_task_log(self, state, try_number, expected_num_logs_visible):
+        with create_session() as session:
+            self.ti.state = state
+            self.ti.try_number = try_number
+            session.merge(self.ti)
+
         response = self.client.get(
             TestLogView.ENDPOINT, data=dict(
                 username='test',
                 password='test'), follow_redirects=True)
         self.assertEqual(response.status_code, 200)
-        self.assertIn('Log by attempts',
-                      response.data.decode('utf-8'))
+        self.assertIn('Log by attempts', response.data.decode('utf-8'))
+        for num in range(1, expected_num_logs_visible + 1):
+            self.assertIn('try-{}'.format(num), response.data.decode('utf-8'))
+        self.assertNotIn('try-0', response.data.decode('utf-8'))
+        self.assertNotIn('try-{}'.format(expected_num_logs_visible + 1), response.data.decode('utf-8'))
 
     def test_get_logs_with_metadata(self):
         url_template = "get_logs_with_metadata?dag_id={}&" \

From 070ad44b2d5e735c038c136cc89daf963eed94c6 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Wed, 5 Dec 2018 21:33:00 +0100
Subject: [PATCH 399/808] [AIRFLOW-2440] Google Cloud SQL import/export
 operator (#4251)

---
 .../contrib/example_dags/example_gcp_sql.py   | 156 +++++++++++++++-
 airflow/contrib/hooks/gcp_sql_hook.py         |  59 ++++++
 airflow/contrib/hooks/gcs_hook.py             |  22 +--
 airflow/contrib/operators/gcp_sql_operator.py | 149 ++++++++++++++-
 airflow/contrib/operators/gcs_acl_operator.py |  20 +-
 docs/howto/operator.rst                       | 173 +++++++++++++++++-
 docs/integration.rst                          |  16 ++
 tests/contrib/hooks/test_gcp_sql_hook.py      |  63 +++++++
 .../operators/test_gcp_sql_operator.py        |  94 +++++++++-
 9 files changed, 693 insertions(+), 59 deletions(-)
 create mode 100644 tests/contrib/hooks/test_gcp_sql_hook.py

diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index 45c0895b0f569..c6838a2baf256 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -29,22 +29,32 @@
 """
 
 import os
-import datetime
+
+import re
 
 import airflow
 from airflow import models
-
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
     CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
     CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
-    CloudSqlInstanceDatabaseDeleteOperator
+    CloudSqlInstanceDatabaseDeleteOperator, CloudSqlInstanceExportOperator, \
+    CloudSqlInstanceImportOperator
+from airflow.contrib.operators.gcs_acl_operator import \
+    GoogleCloudStorageBucketCreateAclEntryOperator, \
+    GoogleCloudStorageObjectCreateAclEntryOperator
 
 # [START howto_operator_cloudsql_arguments]
 PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'testpostgres')
+INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'test-mysql')
+INSTANCE_NAME2 = os.environ.get('INSTANCE_NAME2', 'test-mysql2')
 DB_NAME = os.environ.get('DB_NAME', 'testdb')
 # [END howto_operator_cloudsql_arguments]
 
+# [START howto_operator_cloudsql_export_import_arguments]
+EXPORT_URI = os.environ.get('EXPORT_URI', 'gs://bucketName/fileName')
+IMPORT_URI = os.environ.get('IMPORT_URI', 'gs://bucketName/fileName')
+# [END howto_operator_cloudsql_export_import_arguments]
+
 # Bodies below represent Cloud SQL instance resources:
 # https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances
 
@@ -86,6 +96,16 @@
     "region": "europe-west4",
 }
 # [END howto_operator_cloudsql_create_body]
+
+body2 = {
+    "name": INSTANCE_NAME2,
+    "settings": {
+        "tier": "db-n1-standard-1",
+    },
+    "databaseVersion": "MYSQL_5_7",
+    "region": "europe-west4",
+}
+
 # [START howto_operator_cloudsql_patch_body]
 patch_body = {
     "name": INSTANCE_NAME,
@@ -102,6 +122,25 @@
     }
 }
 # [END howto_operator_cloudsql_patch_body]
+# [START howto_operator_cloudsql_export_body]
+export_body = {
+    "exportContext": {
+        "fileType": "sql",
+        "uri": EXPORT_URI,
+        "sqlExportOptions": {
+            "schemaOnly": False
+        }
+    }
+}
+# [END howto_operator_cloudsql_export_body]
+# [START howto_operator_cloudsql_import_body]
+import_body = {
+    "importContext": {
+        "fileType": "sql",
+        "uri": IMPORT_URI
+    }
+}
+# [END howto_operator_cloudsql_import_body]
 # [START howto_operator_cloudsql_db_create_body]
 db_create_body = {
     "instance": INSTANCE_NAME,
@@ -123,16 +162,40 @@
 with models.DAG(
     'example_gcp_sql',
     default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
+    schedule_interval=None
 ) as dag:
+    prev_task = None
+
+    def next_dep(task, prev):
+        prev >> task
+        return task
+
+    # ############################################## #
+    # ### INSTANCES SET UP ######################### #
+    # ############################################## #
+
     # [START howto_operator_cloudsql_create]
-    sql_instance_create_task = CloudSqlInstanceCreateOperator(
+    sql_instance_create = CloudSqlInstanceCreateOperator(
         project_id=PROJECT_ID,
         body=body,
         instance=INSTANCE_NAME,
-        task_id='sql_instance_create_task'
+        task_id='sql_instance_create'
     )
     # [END howto_operator_cloudsql_create]
+    prev_task = sql_instance_create
+
+    sql_instance_create_2 = CloudSqlInstanceCreateOperator(
+        project_id=PROJECT_ID,
+        body=body2,
+        instance=INSTANCE_NAME2,
+        task_id='sql_instance_create_2'
+    )
+    prev_task = next_dep(sql_instance_create_2, prev_task)
+
+    # ############################################## #
+    # ### MODIFYING INSTANCE AND ITS DATABASE ###### #
+    # ############################################## #
+
     # [START howto_operator_cloudsql_patch]
     sql_instance_patch_task = CloudSqlInstancePatchOperator(
         project_id=PROJECT_ID,
@@ -141,6 +204,8 @@
         task_id='sql_instance_patch_task'
     )
     # [END howto_operator_cloudsql_patch]
+    prev_task = next_dep(sql_instance_patch_task, prev_task)
+
     # [START howto_operator_cloudsql_db_create]
     sql_db_create_task = CloudSqlInstanceDatabaseCreateOperator(
         project_id=PROJECT_ID,
@@ -149,6 +214,8 @@
         task_id='sql_db_create_task'
     )
     # [END howto_operator_cloudsql_db_create]
+    prev_task = next_dep(sql_db_create_task, prev_task)
+
     # [START howto_operator_cloudsql_db_patch]
     sql_db_patch_task = CloudSqlInstanceDatabasePatchOperator(
         project_id=PROJECT_ID,
@@ -158,6 +225,65 @@
         task_id='sql_db_patch_task'
     )
     # [END howto_operator_cloudsql_db_patch]
+    prev_task = next_dep(sql_db_patch_task, prev_task)
+
+    # ############################################## #
+    # ### EXPORTING SQL FROM INSTANCE 1 ############ #
+    # ############################################## #
+
+    # For export to work we need to add the Cloud SQL instance's Service Account
+    # write access to the destination GCS bucket.
+    # [START howto_operator_cloudsql_export_gcs_permissions]
+    sql_gcp_add_bucket_permission = GoogleCloudStorageBucketCreateAclEntryOperator(
+        entity="user-{{ task_instance.xcom_pull('sql_instance_create', key='service_account_email') }}",
+        role="WRITER",
+        bucket=re.match(r'gs:\/\/(\S*)\/', EXPORT_URI).group(1),
+        task_id='sql_gcp_add_bucket_permission'
+    )
+    # [END howto_operator_cloudsql_export_gcs_permissions]
+    prev_task = next_dep(sql_gcp_add_bucket_permission, prev_task)
+
+    # [START howto_operator_cloudsql_export]
+    sql_export_task = CloudSqlInstanceExportOperator(
+        project_id=PROJECT_ID,
+        body=export_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_export_task'
+    )
+    # [END howto_operator_cloudsql_export]
+    prev_task = next_dep(sql_export_task, prev_task)
+
+    # ############################################## #
+    # ### IMPORTING SQL TO INSTANCE 2 ############## #
+    # ############################################## #
+
+    # For import to work we need to add the Cloud SQL instance's Service Account
+    # read access to the target GCS object.
+    # [START howto_operator_cloudsql_import_gcs_permissions]
+    sql_gcp_add_object_permission = GoogleCloudStorageObjectCreateAclEntryOperator(
+        entity="user-{{ task_instance.xcom_pull('sql_instance_create_2', key='service_account_email') }}",
+        role="READER",
+        bucket=re.match(r'gs:\/\/(\S*)\/', IMPORT_URI).group(1),
+        object_name=re.match(r'gs:\/\/[^\/]*\/(\S*)', IMPORT_URI).group(1),
+        task_id='sql_gcp_add_object_permission',
+    )
+    # [END howto_operator_cloudsql_import_gcs_permissions]
+    prev_task = next_dep(sql_gcp_add_object_permission, prev_task)
+
+    # [START howto_operator_cloudsql_import]
+    sql_import_task = CloudSqlInstanceImportOperator(
+        project_id=PROJECT_ID,
+        body=import_body,
+        instance=INSTANCE_NAME2,
+        task_id='sql_import_task'
+    )
+    # [END howto_operator_cloudsql_import]
+    prev_task = next_dep(sql_import_task, prev_task)
+
+    # ############################################## #
+    # ### DELETING A DATABASE FROM AN INSTANCE ##### #
+    # ############################################## #
+
     # [START howto_operator_cloudsql_db_delete]
     sql_db_delete_task = CloudSqlInstanceDatabaseDeleteOperator(
         project_id=PROJECT_ID,
@@ -166,6 +292,12 @@
         task_id='sql_db_delete_task'
     )
     # [END howto_operator_cloudsql_db_delete]
+    prev_task = next_dep(sql_db_delete_task, prev_task)
+
+    # ############################################## #
+    # ### INSTANCES TEAR DOWN ###################### #
+    # ############################################## #
+
     # [START howto_operator_cloudsql_delete]
     sql_instance_delete_task = CloudSqlInstanceDeleteOperator(
         project_id=PROJECT_ID,
@@ -173,7 +305,11 @@
         task_id='sql_instance_delete_task'
     )
     # [END howto_operator_cloudsql_delete]
+    prev_task = next_dep(sql_instance_delete_task, prev_task)
 
-    sql_instance_create_task >> sql_instance_patch_task \
-        >> sql_db_create_task >> sql_db_patch_task \
-        >> sql_db_delete_task >> sql_instance_delete_task
+    sql_instance_delete_task_2 = CloudSqlInstanceDeleteOperator(
+        project_id=PROJECT_ID,
+        instance=INSTANCE_NAME2,
+        task_id='sql_instance_delete_task_2'
+    )
+    prev_task = next_dep(sql_instance_delete_task_2, prev_task)
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index cfe256df04aa9..5c24b2e8a5d16 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -30,6 +30,7 @@
 import time
 import uuid
 from os.path import isfile
+from googleapiclient import errors
 from subprocess import Popen, PIPE
 from six.moves.urllib.parse import quote_plus
 
@@ -259,6 +260,64 @@ def delete_database(self, project, instance, database):
         operation_name = response["name"]
         return self._wait_for_operation_to_complete(project, operation_name)
 
+    def export_instance(self, project_id, instance_id, body):
+        """
+        Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
+        or CSV file.
+
+        :param project_id: Project ID of the project where the instance exists.
+        :type project_id: str
+        :param instance_id: Name of the Cloud SQL instance. This does not include the
+            project ID.
+        :type instance_id: str
+        :param body: The request body, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        try:
+            response = self.get_conn().instances().export(
+                project=project_id,
+                instance=instance_id,
+                body=body
+            ).execute(num_retries=NUM_RETRIES)
+            operation_name = response["name"]
+            return self._wait_for_operation_to_complete(project_id, operation_name)
+        except errors.HttpError as ex:
+            raise AirflowException(
+                'Exporting instance {} failed: {}'.format(instance_id, ex.content)
+            )
+
+    def import_instance(self, project_id, instance_id, body):
+        """
+        Imports data into a Cloud SQL instance from a SQL dump or CSV file in
+        Cloud Storage.
+
+        :param project_id: Project ID of the project where the instance exists.
+        :type project_id: str
+        :param instance_id: Name of the Cloud SQL instance. This does not include the
+            project ID.
+        :type instance_id: str
+        :param body: The request body, as described in
+            https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
+        :type body: dict
+        :return: True if the operation succeeded, raises an error otherwise
+        :rtype: bool
+        """
+        try:
+            response = self.get_conn().instances().import_(
+                project=project_id,
+                instance=instance_id,
+                body=body
+            ).execute(num_retries=NUM_RETRIES)
+            operation_name = response["name"]
+            return self._wait_for_operation_to_complete(project_id, operation_name)
+        except errors.HttpError as ex:
+            raise AirflowException(
+                'Importing instance {} failed: {}'.format(instance_id, ex.content)
+            )
+
     def _wait_for_operation_to_complete(self, project_id, operation_name):
         """
         Waits for the named operation to complete - checks status of the
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 391336faf28fe..c4516f33d04a9 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -544,14 +544,9 @@ def insert_bucket_acl(self, bucket, entity, role, user_project):
         :param bucket: Name of a bucket.
         :type bucket: str
         :param entity: The entity holding the permission, in one of the following forms:
-        - user-userId
-        - user-email
-        - group-groupId
-        - group-email
-        - domain-domain
-        - project-team-projectId
-        - allUsers
-        - allAuthenticatedUsers
+            user-userId, user-email, group-groupId, group-email, domain-domain,
+            project-team-projectId, allUsers, allAuthenticatedUsers.
+            See: https://cloud.google.com/storage/docs/access-control/lists#scopes
         :type entity: str
         :param role: The access permission for the entity.
             Acceptable values are: "OWNER", "READER", "WRITER".
@@ -592,14 +587,9 @@ def insert_object_acl(self, bucket, object_name, entity, role, generation,
             https://cloud.google.com/storage/docs/json_api/#encoding
         :type object_name: str
         :param entity: The entity holding the permission, in one of the following forms:
-            - user-userId
-            - user-email
-            - group-groupId
-            - group-email
-            - domain-domain
-            - project-team-projectId
-            - allUsers
-            - allAuthenticatedUsers
+            user-userId, user-email, group-groupId, group-email, domain-domain,
+            project-team-projectId, allUsers, allAuthenticatedUsers
+            See: https://cloud.google.com/storage/docs/access-control/lists#scopes
         :type entity: str
         :param role: The access permission for the entity.
             Acceptable values are: "OWNER", "READER".
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index 706d58baefd96..e5c6cb8dbccfb 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -27,7 +27,7 @@
 SETTINGS = 'settings'
 SETTINGS_VERSION = 'settingsVersion'
 
-CLOUD_SQL_VALIDATION = [
+CLOUD_SQL_CREATE_VALIDATION = [
     dict(name="name", allow_empty=False),
     dict(name="settings", type="dict", fields=[
         dict(name="tier", allow_empty=False),
@@ -95,10 +95,10 @@
     dict(name="exportContext", type="dict", fields=[
         dict(name="fileType", allow_empty=False),
         dict(name="uri", allow_empty=False),
-        dict(name="databases", type="list"),
+        dict(name="databases", optional=True, type="list"),
         dict(name="sqlExportOptions", type="dict", optional=True, fields=[
-            dict(name="tables", type="list"),
-            dict(name="schemaOnly")
+            dict(name="tables", optional=True, type="list"),
+            dict(name="schemaOnly", optional=True)
         ]),
         dict(name="csvExportOptions", type="dict", optional=True, fields=[
             dict(name="selectQuery")
@@ -117,7 +117,7 @@
         ])
     ])
 ]
-CLOUD_SQL_DATABASE_INSERT_VALIDATION = [
+CLOUD_SQL_DATABASE_CREATE_VALIDATION = [
     dict(name="instance", allow_empty=False),
     dict(name="name", allow_empty=False),
     dict(name="project", allow_empty=False),
@@ -142,7 +142,7 @@ class CloudSqlBaseOperator(BaseOperator):
     :type instance: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
-    :param api_version: API version used (e.g. v1).
+    :param api_version: API version used (e.g. v1beta4).
     :type api_version: str
     """
     @apply_defaults
@@ -241,17 +241,21 @@ def _validate_inputs(self):
 
     def _validate_body_fields(self):
         if self.validate_body:
-            GcpBodyFieldValidator(CLOUD_SQL_VALIDATION,
+            GcpBodyFieldValidator(CLOUD_SQL_CREATE_VALIDATION,
                                   api_version=self.api_version).validate(self.body)
 
     def execute(self, context):
         self._validate_body_fields()
         if not self._check_if_instance_exists(self.instance):
-            return self._hook.create_instance(self.project_id, self.body)
+            self._hook.create_instance(self.project_id, self.body)
         else:
             self.log.info("Cloud SQL instance with ID {} already exists. "
                           "Aborting create.".format(self.instance))
-            return True
+
+        instance_resource = self._hook.get_instance(self.project_id, self.instance)
+        service_account_email = instance_resource["serviceAccountEmailAddress"]
+        task_instance = context['task_instance']
+        task_instance.xcom_push(key="service_account_email", value=service_account_email)
 
 
 class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
@@ -389,7 +393,7 @@ def _validate_inputs(self):
 
     def _validate_body_fields(self):
         if self.validate_body:
-            GcpBodyFieldValidator(CLOUD_SQL_DATABASE_INSERT_VALIDATION,
+            GcpBodyFieldValidator(CLOUD_SQL_DATABASE_CREATE_VALIDATION,
                                   api_version=self.api_version).validate(self.body)
 
     def execute(self, context):
@@ -526,6 +530,131 @@ def execute(self, context):
                                               self.database)
 
 
+class CloudSqlInstanceExportOperator(CloudSqlBaseOperator):
+    """
+    Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
+    or CSV file.
+
+    Note: This operator is idempotent. If executed multiple times with the same
+    export file URI, the export file in GCS will simply be overridden.
+
+    :param project_id: Project ID of the project that contains the instance to be
+        exported.
+    :type project_id: str
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param body: The request body, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
+    :type body: dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1beta4).
+    :type api_version: str
+    :param validate_body: Whether the body should be validated. Defaults to True.
+    :type validate_body: bool
+    """
+    # [START gcp_sql_export_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_export_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body = body
+        self.validate_body = validate_body
+        super(CloudSqlInstanceExportOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceExportOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+
+    def _validate_body_fields(self):
+        if self.validate_body:
+            GcpBodyFieldValidator(CLOUD_SQL_EXPORT_VALIDATION,
+                                  api_version=self.api_version).validate(self.body)
+
+    def execute(self, context):
+        self._validate_body_fields()
+        return self._hook.export_instance(self.project_id, self.instance, self.body)
+
+
+class CloudSqlInstanceImportOperator(CloudSqlBaseOperator):
+    """
+    Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
+
+    CSV IMPORT:
+
+    This operator is NOT idempotent for a CSV import. If the same file is imported
+    multiple times, the imported data will be duplicated in the database.
+    Moreover, if there are any unique constraints the duplicate import may result in an
+    error.
+
+    SQL IMPORT:
+
+    This operator is idempotent for a SQL import if it was also exported by Cloud SQL.
+    The exported SQL contains 'DROP TABLE IF EXISTS' statements for all tables
+    to be imported.
+
+    If the import file was generated in a different way, idempotence is not guaranteed.
+    It has to be ensured on the SQL file level.
+
+    :param project_id: Project ID of the project that contains the instance.
+    :type project_id: str
+    :param instance: Cloud SQL instance ID. This does not include the project ID.
+    :type instance: str
+    :param body: The request body, as described in
+        https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
+    :type body: dict
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1beta4).
+    :type api_version: str
+    :param validate_body: Whether the body should be validated. Defaults to True.
+    :type validate_body: bool
+    """
+    # [START gcp_sql_import_template_fields]
+    template_fields = ('project_id', 'instance', 'gcp_conn_id', 'api_version')
+    # [END gcp_sql_import_template_fields]
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 instance,
+                 body,
+                 gcp_conn_id='google_cloud_default',
+                 api_version='v1beta4',
+                 validate_body=True,
+                 *args, **kwargs):
+        self.body = body
+        self.validate_body = validate_body
+        super(CloudSqlInstanceImportOperator, self).__init__(
+            project_id=project_id, instance=instance, gcp_conn_id=gcp_conn_id,
+            api_version=api_version, *args, **kwargs)
+
+    def _validate_inputs(self):
+        super(CloudSqlInstanceImportOperator, self)._validate_inputs()
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty")
+
+    def _validate_body_fields(self):
+        if self.validate_body:
+            GcpBodyFieldValidator(CLOUD_SQL_IMPORT_VALIDATION,
+                                  api_version=self.api_version).validate(self.body)
+
+    def execute(self, context):
+        self._validate_body_fields()
+        return self._hook.import_instance(self.project_id, self.instance, self.body)
+
+
 class CloudSqlQueryOperator(BaseOperator):
     """
     Performs DML or DDL query on an existing Cloud Sql instance. It optionally uses
diff --git a/airflow/contrib/operators/gcs_acl_operator.py b/airflow/contrib/operators/gcs_acl_operator.py
index d91844413199b..a39b8cf5d9616 100644
--- a/airflow/contrib/operators/gcs_acl_operator.py
+++ b/airflow/contrib/operators/gcs_acl_operator.py
@@ -29,14 +29,8 @@ class GoogleCloudStorageBucketCreateAclEntryOperator(BaseOperator):
     :param bucket: Name of a bucket.
     :type bucket: str
     :param entity: The entity holding the permission, in one of the following forms:
-        - user-userId
-        - user-email
-        - group-groupId
-        - group-email
-        - domain-domain
-        - project-team-projectId
-        - allUsers
-        - allAuthenticatedUsers
+        user-userId, user-email, group-groupId, group-email, domain-domain,
+        project-team-projectId, allUsers, allAuthenticatedUsers
     :type entity: str
     :param role: The access permission for the entity.
         Acceptable values are: "OWNER", "READER", "WRITER".
@@ -82,14 +76,8 @@ class GoogleCloudStorageObjectCreateAclEntryOperator(BaseOperator):
         https://cloud.google.com/storage/docs/json_api/#encoding
     :type object_name: str
     :param entity: The entity holding the permission, in one of the following forms:
-        - user-userId
-        - user-email
-        - group-groupId
-        - group-email
-        - domain-domain
-        - project-team-projectId
-        - allUsers
-        - allAuthenticatedUsers
+        user-userId, user-email, group-groupId, group-email, domain-domain,
+        project-team-projectId, allUsers, allAuthenticatedUsers
     :type entity: str
     :param role: The access permission for the entity.
         Acceptable values are: "OWNER", "READER".
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 700fa1b9730ed..65d38d5ef25b5 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1074,6 +1074,178 @@ More information
 See `Google Cloud SQL API documentation for delete
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
 
+.. CloudSqlInstanceExportOperator:
+
+CloudSqlInstanceExportOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
+or CSV file.
+
+Note: This operator is idempotent. If executed multiple times with the same
+export file URI, the export file in GCS will simply be overridden.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_import_arguments]
+    :end-before: [END howto_operator_cloudsql_export_import_arguments]
+
+Example body defining the export operation:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_body]
+    :end-before: [END howto_operator_cloudsql_export_body]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_export]
+    :end-before: [END howto_operator_cloudsql_export]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_export_template_fields]
+    :end-before: [END gcp_sql_export_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for export <https://cloud.google
+.com/sql/docs/mysql/admin-api/v1beta4/instances/export>`_.
+
+Troubleshooting
+"""""""""""""""
+
+If you receive an "Unauthorized" error in GCP, make sure that the service account
+of the Cloud SQL instance is authorized to write to the selected GCS bucket.
+
+It is not the service account configured in Airflow that communicates with GCS,
+but rather the service account of the particular Cloud SQL instance.
+
+To grant the service account with the appropriate WRITE permissions for the GCS bucket
+you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`,
+as shown in the example:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_export_gcs_permissions]
+    :end-before: [END howto_operator_cloudsql_export_gcs_permissions]
+
+
+.. CloudSqlInstanceImportOperator:
+
+CloudSqlInstanceImportOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
+
+CSV import:
+"""""""""""
+
+This operator is NOT idempotent for a CSV import. If the same file is imported
+multiple times, the imported data will be duplicated in the database.
+Moreover, if there are any unique constraints the duplicate import may result in an
+error.
+
+SQL import:
+"""""""""""
+
+This operator is idempotent for a SQL import if it was also exported by Cloud SQL.
+The exported SQL contains 'DROP TABLE IF EXISTS' statements for all tables
+to be imported.
+
+If the import file was generated in a different way, idempotence is not guaranteed.
+It has to be ensured on the SQL file level.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_import_arguments]
+    :end-before: [END howto_operator_cloudsql_export_import_arguments]
+
+Example body defining the import operation:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_import_body]
+    :end-before: [END howto_operator_cloudsql_import_body]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_import]
+    :end-before: [END howto_operator_cloudsql_import]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_import_template_fields]
+    :end-before: [END gcp_sql_import_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for import <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/import>`_.
+
+Troubleshooting
+"""""""""""""""
+
+If you receive an "Unauthorized" error in GCP, make sure that the service account
+of the Cloud SQL instance is authorized to read from the selected GCS object.
+
+It is not the service account configured in Airflow that communicates with GCS,
+but rather the service account of the particular Cloud SQL instance.
+
+To grant the service account with the appropriate READ permissions for the GCS object
+you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`,
+as shown in the example:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
+    :end-before: [END howto_operator_cloudsql_import_gcs_permissions]
+
 .. _CloudSqlInstanceCreateOperator:
 
 CloudSqlInstanceCreateOperator
@@ -1128,7 +1300,6 @@ More information
 See `Google Cloud SQL API documentation for insert <https://cloud.google
 .com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
 
-
 .. _CloudSqlInstancePatchOperator:
 
 CloudSqlInstancePatchOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index e54b6c6121285..1a64ab0a8c16e 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -746,6 +746,8 @@ Cloud SQL Operators
 - :ref:`CloudSqlInstanceDatabasePatchOperator` : updates a database inside a Cloud
   SQL instance.
 - :ref:`CloudSqlInstanceDeleteOperator` : delete a Cloud SQL instance.
+- :ref:`CloudSqlInstanceExportOperator` : exports data from a Cloud SQL instance.
+- :ref:`CloudSqlInstanceImportOperator` : imports data into a Cloud SQL instance.
 - :ref:`CloudSqlInstanceCreateOperator` : create a new Cloud SQL instance.
 - :ref:`CloudSqlInstancePatchOperator` : patch a Cloud SQL instance.
 - :ref:`CloudSqlQueryOperator` : run query in a Cloud SQL instance.
@@ -778,6 +780,20 @@ CloudSqlInstanceDeleteOperator
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
 
+.. _CloudSqlInstanceExportOperator:
+
+CloudSqlInstanceExportOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
+
+.. _CloudSqlInstanceImportOperator:
+
+CloudSqlInstanceImportOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
+
 .. _CloudSqlInstanceCreateOperator:
 
 CloudSqlInstanceCreateOperator
diff --git a/tests/contrib/hooks/test_gcp_sql_hook.py b/tests/contrib/hooks/test_gcp_sql_hook.py
new file mode 100644
index 0000000000000..cb56237736c4b
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_sql_hook.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from googleapiclient.errors import HttpError
+
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook
+from airflow.exceptions import AirflowException
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestGcpSqlHook(unittest.TestCase):
+    def test_instance_import_ex(self):
+        # Mocking __init__ with an empty anonymous function
+        with mock.patch.object(CloudSqlHook, "__init__", lambda x, y, z: None):
+            hook = CloudSqlHook(None, None)
+            # Simulating HttpError inside import_instance
+            hook.get_conn = mock.Mock(
+                side_effect=HttpError(resp={'status': '400'},
+                                      content='Error content'.encode('utf-8'))
+            )
+            with self.assertRaises(AirflowException) as cm:
+                hook.import_instance(None, None, None)
+            err = cm.exception
+            self.assertIn("Importing instance ", str(err))
+
+    def test_instance_export_ex(self):
+        # Mocking __init__ with an empty anonymous function
+        with mock.patch.object(CloudSqlHook, "__init__", lambda x, y, z: None):
+            hook = CloudSqlHook(None, None)
+            # Simulating HttpError inside export_instance
+            hook.get_conn = mock.Mock(
+                side_effect=HttpError(resp={'status': '400'},
+                                      content='Error content'.encode('utf-8'))
+            )
+            with self.assertRaises(AirflowException) as cm:
+                hook.export_instance(None, None, None)
+            err = cm.exception
+            self.assertIn("Exporting instance ", str(err))
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index f5039fb4888e4..f8e8434e92a0a 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -18,17 +18,18 @@
 # under the License.
 import json
 import os
-import time
 import unittest
-from uuid import uuid1
 
+import time
 from parameterized import parameterized
+from uuid import uuid1
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_sql_hook import CloudSqlProxyRunner
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
     CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
     CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
+    CloudSqlInstanceExportOperator, CloudSqlInstanceImportOperator, \
     CloudSqlInstanceDatabaseDeleteOperator, CloudSqlQueryOperator
 from airflow.models import Connection
 from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
@@ -137,6 +138,36 @@
     "charset": "utf16",
     "collation": "utf16_general_ci"
 }
+EXPORT_BODY = {
+    "exportContext": {
+        "fileType": "CSV",
+        "uri": "gs://bucketName/fileName",
+        "databases": [],
+        "sqlExportOptions": {
+            "tables": [
+                "table1", "table2"
+            ],
+            "schemaOnly": False
+        },
+        "csvExportOptions": {
+            "selectQuery": "SELECT * FROM ..."
+        }
+    }
+}
+IMPORT_BODY = {
+    "importContext": {
+        "fileType": "CSV",
+        "uri": "gs://bucketName/fileName",
+        "database": "db1",
+        "importUser": "",
+        "csvImportOptions": {
+            "table": "my_table",
+            "columns": [
+                "col1", "col2"
+            ]
+        }
+    }
+}
 
 
 class CloudSqlTest(unittest.TestCase):
@@ -152,13 +183,15 @@ def test_instance_create(self, mock_hook, _check_if_instance_exists):
             body=CREATE_BODY,
             task_id="id"
         )
-        result = op.execute(None)
+        result = op.execute(context={
+            'task_instance': mock.Mock()
+        })
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_instance.assert_called_once_with(
             PROJECT_ID, CREATE_BODY
         )
-        self.assertTrue(result)
+        self.assertIsNone(result)
 
     @mock.patch("airflow.contrib.operators.gcp_sql_operator"
                 ".CloudSqlInstanceCreateOperator._check_if_instance_exists")
@@ -172,11 +205,13 @@ def test_instance_create_idempotent(self, mock_hook, _check_if_instance_exists):
             body=CREATE_BODY,
             task_id="id"
         )
-        result = op.execute(None)
+        result = op.execute(context={
+            'task_instance': mock.Mock()
+        })
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_instance.assert_not_called()
-        self.assertTrue(result)
+        self.assertIsNone(result)
 
     @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
     def test_create_should_throw_ex_when_empty_project_id(self, mock_hook):
@@ -475,6 +510,40 @@ def test_instance_db_delete_should_abort_and_succeed_if_not_exists(
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_database.assert_not_called()
 
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_export(self, mock_hook):
+        mock_hook.return_value.export_instance.return_value = True
+        op = CloudSqlInstanceExportOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=EXPORT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.export_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME, EXPORT_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_import(self, mock_hook):
+        mock_hook.return_value.export_instance.return_value = True
+        op = CloudSqlInstanceImportOperator(
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=IMPORT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.import_instance.assert_called_once_with(
+            PROJECT_ID, INSTANCE_NAME, IMPORT_BODY
+        )
+        self.assertTrue(result)
+
 
 class CloudSqlQueryValidationTest(unittest.TestCase):
     @parameterized.expand([
@@ -866,6 +935,19 @@ def test_start_proxy_with_all_instances_specific_version(self):
         self.assertEqual(runner.get_proxy_version(), "1.13")
 
 
+@unittest.skipIf(
+    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
+class CloudSqlExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlExampleDagsIntegrationTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_sql',
+            gcp_key=GCP_CLOUDSQL_KEY)
+
+    def test_run_example_dag_cloudsql_query(self):
+        self._run_dag()
+
+
 @unittest.skipIf(
     BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
 class CloudSqlQueryExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):

From 7ea328b2676253fdcbb58487125c285b14c7c5ab Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 12 Jan 2019 02:18:40 +0100
Subject: [PATCH 400/808] [AIRFLOW-3676] Add required permission to CloudSQL
 export/import example (#4489)

---
 .../contrib/example_dags/example_gcp_sql.py   | 59 ++++++++++++-------
 1 file changed, 37 insertions(+), 22 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index c6838a2baf256..eaf1f7d404b0a 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -30,8 +30,6 @@
 
 import os
 
-import re
-
 import airflow
 from airflow import models
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
@@ -43,6 +41,8 @@
     GoogleCloudStorageBucketCreateAclEntryOperator, \
     GoogleCloudStorageObjectCreateAclEntryOperator
 
+from six.moves.urllib.parse import urlsplit
+
 # [START howto_operator_cloudsql_arguments]
 PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
 INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'test-mysql')
@@ -175,22 +175,22 @@ def next_dep(task, prev):
     # ############################################## #
 
     # [START howto_operator_cloudsql_create]
-    sql_instance_create = CloudSqlInstanceCreateOperator(
+    sql_instance_create_task = CloudSqlInstanceCreateOperator(
         project_id=PROJECT_ID,
         body=body,
         instance=INSTANCE_NAME,
-        task_id='sql_instance_create'
+        task_id='sql_instance_create_task'
     )
     # [END howto_operator_cloudsql_create]
-    prev_task = sql_instance_create
+    prev_task = sql_instance_create_task
 
-    sql_instance_create_2 = CloudSqlInstanceCreateOperator(
+    sql_instance_create_2_task = CloudSqlInstanceCreateOperator(
         project_id=PROJECT_ID,
         body=body2,
         instance=INSTANCE_NAME2,
-        task_id='sql_instance_create_2'
+        task_id='sql_instance_create_2_task'
     )
-    prev_task = next_dep(sql_instance_create_2, prev_task)
+    prev_task = next_dep(sql_instance_create_2_task, prev_task)
 
     # ############################################## #
     # ### MODIFYING INSTANCE AND ITS DATABASE ###### #
@@ -230,18 +230,19 @@ def next_dep(task, prev):
     # ############################################## #
     # ### EXPORTING SQL FROM INSTANCE 1 ############ #
     # ############################################## #
+    export_url_split = urlsplit(EXPORT_URI)
 
     # For export to work we need to add the Cloud SQL instance's Service Account
     # write access to the destination GCS bucket.
     # [START howto_operator_cloudsql_export_gcs_permissions]
-    sql_gcp_add_bucket_permission = GoogleCloudStorageBucketCreateAclEntryOperator(
-        entity="user-{{ task_instance.xcom_pull('sql_instance_create', key='service_account_email') }}",
+    sql_gcp_add_bucket_permission_task = GoogleCloudStorageBucketCreateAclEntryOperator(
+        entity="user-{{ task_instance.xcom_pull('sql_instance_create_task', key='service_account_email') }}",
         role="WRITER",
-        bucket=re.match(r'gs:\/\/(\S*)\/', EXPORT_URI).group(1),
-        task_id='sql_gcp_add_bucket_permission'
+        bucket=export_url_split[1],  # netloc (bucket)
+        task_id='sql_gcp_add_bucket_permission_task'
     )
     # [END howto_operator_cloudsql_export_gcs_permissions]
-    prev_task = next_dep(sql_gcp_add_bucket_permission, prev_task)
+    prev_task = next_dep(sql_gcp_add_bucket_permission_task, prev_task)
 
     # [START howto_operator_cloudsql_export]
     sql_export_task = CloudSqlInstanceExportOperator(
@@ -256,19 +257,33 @@ def next_dep(task, prev):
     # ############################################## #
     # ### IMPORTING SQL TO INSTANCE 2 ############## #
     # ############################################## #
+    import_url_split = urlsplit(IMPORT_URI)
 
     # For import to work we need to add the Cloud SQL instance's Service Account
     # read access to the target GCS object.
     # [START howto_operator_cloudsql_import_gcs_permissions]
-    sql_gcp_add_object_permission = GoogleCloudStorageObjectCreateAclEntryOperator(
-        entity="user-{{ task_instance.xcom_pull('sql_instance_create_2', key='service_account_email') }}",
+    sql_gcp_add_object_permission_task = GoogleCloudStorageObjectCreateAclEntryOperator(
+        entity="user-{{ task_instance.xcom_pull('sql_instance_create_2_task', "
+               "key='service_account_email') }}",
         role="READER",
-        bucket=re.match(r'gs:\/\/(\S*)\/', IMPORT_URI).group(1),
-        object_name=re.match(r'gs:\/\/[^\/]*\/(\S*)', IMPORT_URI).group(1),
-        task_id='sql_gcp_add_object_permission',
+        bucket=import_url_split[1],  # netloc (bucket)
+        object_name=import_url_split[2][1:],  # path (strip first '/')
+        task_id='sql_gcp_add_object_permission_task',
+    )
+    prev_task = next_dep(sql_gcp_add_object_permission_task, prev_task)
+
+    # For import to work we also need to add the Cloud SQL instance's Service Account
+    # write access to the whole bucket!.
+    sql_gcp_add_bucket_permission_2_task = GoogleCloudStorageBucketCreateAclEntryOperator(
+        entity="user-{{ task_instance.xcom_pull("
+               "'sql_instance_create_2_task', key='service_account_email') "
+               "}}",
+        role="WRITER",
+        bucket=import_url_split[1],  # netloc
+        task_id='sql_gcp_add_bucket_permission_2_task',
     )
     # [END howto_operator_cloudsql_import_gcs_permissions]
-    prev_task = next_dep(sql_gcp_add_object_permission, prev_task)
+    prev_task = next_dep(sql_gcp_add_bucket_permission_2_task, prev_task)
 
     # [START howto_operator_cloudsql_import]
     sql_import_task = CloudSqlInstanceImportOperator(
@@ -307,9 +322,9 @@ def next_dep(task, prev):
     # [END howto_operator_cloudsql_delete]
     prev_task = next_dep(sql_instance_delete_task, prev_task)
 
-    sql_instance_delete_task_2 = CloudSqlInstanceDeleteOperator(
+    sql_instance_delete_2_task = CloudSqlInstanceDeleteOperator(
         project_id=PROJECT_ID,
         instance=INSTANCE_NAME2,
-        task_id='sql_instance_delete_task_2'
+        task_id='sql_instance_delete_2_task'
     )
-    prev_task = next_dep(sql_instance_delete_task_2, prev_task)
+    prev_task = next_dep(sql_instance_delete_2_task, prev_task)

From 931b83d93234900574704fbebe8c71e1b6dedeb4 Mon Sep 17 00:00:00 2001
From: Jasper Kahn <jasperakahn@gmail.com>
Date: Wed, 8 Aug 2018 01:04:19 -0700
Subject: [PATCH 401/808] [AIRFLOW-2826] Add GoogleCloudKMSHook (#3677)

Adds a hook enabling encryption and decryption through Google Cloud KMS.
This should also contribute to AIRFLOW-2062.
---
 airflow/contrib/hooks/gcp_kms_hook.py    | 108 +++++++++++++++
 tests/contrib/hooks/test_gcp_kms_hook.py | 160 +++++++++++++++++++++++
 2 files changed, 268 insertions(+)
 create mode 100644 airflow/contrib/hooks/gcp_kms_hook.py
 create mode 100644 tests/contrib/hooks/test_gcp_kms_hook.py

diff --git a/airflow/contrib/hooks/gcp_kms_hook.py b/airflow/contrib/hooks/gcp_kms_hook.py
new file mode 100644
index 0000000000000..6f2b3aedffdbf
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_kms_hook.py
@@ -0,0 +1,108 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import base64
+
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+from apiclient.discovery import build
+
+
+def _b64encode(s):
+    """ Base 64 encodes a bytes object to a string """
+    return base64.b64encode(s).decode('ascii')
+
+
+def _b64decode(s):
+    """ Base 64 decodes a string to bytes. """
+    return base64.b64decode(s.encode('utf-8'))
+
+
+class GoogleCloudKMSHook(GoogleCloudBaseHook):
+    """
+    Interact with Google Cloud KMS. This hook uses the Google Cloud Platform
+    connection.
+    """
+
+    def __init__(self, gcp_conn_id='google_cloud_default', delegate_to=None):
+        super(GoogleCloudKMSHook, self).__init__(gcp_conn_id, delegate_to=delegate_to)
+
+    def get_conn(self):
+        """
+        Returns a KMS service object.
+
+        :rtype: apiclient.discovery.Resource
+        """
+        http_authorized = self._authorize()
+        return build(
+            'cloudkms', 'v1', http=http_authorized, cache_discovery=False)
+
+    def encrypt(self, key_name, plaintext, authenticated_data=None):
+        """
+        Encrypts a plaintext message using Google Cloud KMS.
+
+        :param key_name: The Resource Name for the key (or key version)
+                         to be used for encyption. Of the form
+                         ``projects/*/locations/*/keyRings/*/cryptoKeys/**``
+        :type key_name: str
+        :param plaintext: The message to be encrypted.
+        :type plaintext: bytes
+        :param authenticated_data: Optional additional authenticated data that
+                                   must also be provided to decrypt the message.
+        :type authenticated_data: bytes
+        :return: The base 64 encoded ciphertext of the original message.
+        :rtype: str
+        """
+        keys = self.get_conn().projects().locations().keyRings().cryptoKeys()
+        body = {'plaintext': _b64encode(plaintext)}
+        if authenticated_data:
+            body['additionalAuthenticatedData'] = _b64encode(authenticated_data)
+
+        request = keys.encrypt(name=key_name, body=body)
+        response = request.execute()
+
+        ciphertext = response['ciphertext']
+        return ciphertext
+
+    def decrypt(self, key_name, ciphertext, authenticated_data=None):
+        """
+        Decrypts a ciphertext message using Google Cloud KMS.
+
+        :param key_name: The Resource Name for the key to be used for decyption.
+                         Of the form ``projects/*/locations/*/keyRings/*/cryptoKeys/**``
+        :type key_name: str
+        :param ciphertext: The message to be decrypted.
+        :type ciphertext: str
+        :param authenticated_data: Any additional authenticated data that was
+                                   provided when encrypting the message.
+        :type authenticated_data: bytes
+        :return: The original message.
+        :rtype: bytes
+        """
+        keys = self.get_conn().projects().locations().keyRings().cryptoKeys()
+        body = {'ciphertext': ciphertext}
+        if authenticated_data:
+            body['additionalAuthenticatedData'] = _b64encode(authenticated_data)
+
+        request = keys.decrypt(name=key_name, body=body)
+        response = request.execute()
+
+        plaintext = _b64decode(response['plaintext'])
+        return plaintext
diff --git a/tests/contrib/hooks/test_gcp_kms_hook.py b/tests/contrib/hooks/test_gcp_kms_hook.py
new file mode 100644
index 0000000000000..eabf20e5642b2
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_kms_hook.py
@@ -0,0 +1,160 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from __future__ import unicode_literals
+
+import unittest
+from base64 import b64encode
+
+from airflow.contrib.hooks.gcp_kms_hook import GoogleCloudKMSHook
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
+KMS_STRING = 'airflow.contrib.hooks.gcp_kms_hook.{}'
+
+
+TEST_PROJECT = 'test-project'
+TEST_LOCATION = 'global'
+TEST_KEY_RING = 'test-key-ring'
+TEST_KEY = 'test-key'
+TEST_KEY_ID = 'projects/{}/locations/{}/keyRings/{}/cryptoKeys/{}'.format(
+    TEST_PROJECT, TEST_LOCATION, TEST_KEY_RING, TEST_KEY)
+
+
+def mock_init(self, gcp_conn_id, delegate_to=None):
+    pass
+
+
+class GoogleCloudKMSHookTest(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(BASE_STRING.format('GoogleCloudBaseHook.__init__'),
+                        new=mock_init):
+            self.kms_hook = GoogleCloudKMSHook(gcp_conn_id='test')
+
+    @mock.patch(KMS_STRING.format('GoogleCloudKMSHook.get_conn'))
+    def test_encrypt(self, mock_service):
+        plaintext = b'Test plaintext'
+        ciphertext = 'Test ciphertext'
+        plaintext_b64 = b64encode(plaintext).decode('ascii')
+        body = {'plaintext': plaintext_b64}
+        response = {'ciphertext': ciphertext}
+
+        encrypt_method = (mock_service.return_value
+                          .projects.return_value
+                          .locations.return_value
+                          .keyRings.return_value
+                          .cryptoKeys.return_value
+                          .encrypt)
+        execute_method = encrypt_method.return_value.execute
+        execute_method.return_value = response
+
+        ret_val = self.kms_hook.encrypt(TEST_KEY_ID, plaintext)
+        encrypt_method.assert_called_with(name=TEST_KEY_ID,
+                                          body=body)
+        execute_method.assert_called_with()
+        self.assertEqual(ciphertext, ret_val)
+
+    @mock.patch(KMS_STRING.format('GoogleCloudKMSHook.get_conn'))
+    def test_encrypt_authdata(self, mock_service):
+        plaintext = b'Test plaintext'
+        auth_data = b'Test authdata'
+        ciphertext = 'Test ciphertext'
+        plaintext_b64 = b64encode(plaintext).decode('ascii')
+        auth_data_b64 = b64encode(auth_data).decode('ascii')
+        body = {
+            'plaintext': plaintext_b64,
+            'additionalAuthenticatedData': auth_data_b64
+        }
+        response = {'ciphertext': ciphertext}
+
+        encrypt_method = (mock_service.return_value
+                          .projects.return_value
+                          .locations.return_value
+                          .keyRings.return_value
+                          .cryptoKeys.return_value
+                          .encrypt)
+        execute_method = encrypt_method.return_value.execute
+        execute_method.return_value = response
+
+        ret_val = self.kms_hook.encrypt(TEST_KEY_ID, plaintext,
+                                        authenticated_data=auth_data)
+        encrypt_method.assert_called_with(name=TEST_KEY_ID,
+                                          body=body)
+        execute_method.assert_called_with()
+        self.assertEqual(ciphertext, ret_val)
+
+    @mock.patch(KMS_STRING.format('GoogleCloudKMSHook.get_conn'))
+    def test_decrypt(self, mock_service):
+        plaintext = b'Test plaintext'
+        ciphertext = 'Test ciphertext'
+        plaintext_b64 = b64encode(plaintext).decode('ascii')
+        body = {'ciphertext': ciphertext}
+        response = {'plaintext': plaintext_b64}
+
+        decrypt_method = (mock_service.return_value
+                          .projects.return_value
+                          .locations.return_value
+                          .keyRings.return_value
+                          .cryptoKeys.return_value
+                          .decrypt)
+        execute_method = decrypt_method.return_value.execute
+        execute_method.return_value = response
+
+        ret_val = self.kms_hook.decrypt(TEST_KEY_ID, ciphertext)
+        decrypt_method.assert_called_with(name=TEST_KEY_ID,
+                                          body=body)
+        execute_method.assert_called_with()
+        self.assertEqual(plaintext, ret_val)
+
+    @mock.patch(KMS_STRING.format('GoogleCloudKMSHook.get_conn'))
+    def test_decrypt_authdata(self, mock_service):
+        plaintext = b'Test plaintext'
+        auth_data = b'Test authdata'
+        ciphertext = 'Test ciphertext'
+        plaintext_b64 = b64encode(plaintext).decode('ascii')
+        auth_data_b64 = b64encode(auth_data).decode('ascii')
+        body = {
+            'ciphertext': ciphertext,
+            'additionalAuthenticatedData': auth_data_b64
+        }
+        response = {'plaintext': plaintext_b64}
+
+        decrypt_method = (mock_service.return_value
+                          .projects.return_value
+                          .locations.return_value
+                          .keyRings.return_value
+                          .cryptoKeys.return_value
+                          .decrypt)
+        execute_method = decrypt_method.return_value.execute
+        execute_method.return_value = response
+
+        ret_val = self.kms_hook.decrypt(TEST_KEY_ID, ciphertext,
+                                        authenticated_data=auth_data)
+        decrypt_method.assert_called_with(name=TEST_KEY_ID,
+                                          body=body)
+        execute_method.assert_called_with()
+        self.assertEqual(plaintext, ret_val)

From 901272563193dd4a72343c222c1f933eda1e9c61 Mon Sep 17 00:00:00 2001
From: Gordon Ball <chronitis@gmail.com>
Date: Mon, 5 Nov 2018 15:48:11 +0100
Subject: [PATCH 402/808] [AIRFLOW-3205] Support multipart uploads to GCS
 (#4084)

* [AIRFLOW-3205] Support multipart uploads to GCS

Cloud Storage supports resumable/multipart uploads for large files,
which can be used to avoid limitations on the size of a single HTTP
request, or by adding a retry behaviour, increase the reliability of
large transfers.

* [AIRFLOW-3205] Use only the multipart keyword

This removes the chunksize keyword, using instead multipart=True for a
default chunk size or multipart=int to override the default.
---
 airflow/contrib/hooks/gcs_hook.py    |  53 +++++++---
 tests/contrib/hooks/test_gcs_hook.py | 142 +++++++++++++++++++++++++++
 2 files changed, 184 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index c4516f33d04a9..675fa672e4bd5 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -175,7 +175,8 @@ def download(self, bucket, object, filename=None):
 
     # pylint:disable=redefined-builtin
     def upload(self, bucket, object, filename,
-               mime_type='application/octet-stream', gzip=False):
+               mime_type='application/octet-stream', gzip=False,
+               multipart=False, num_retries=0):
         """
         Uploads a local file to Google Cloud Storage.
 
@@ -189,6 +190,14 @@ def upload(self, bucket, object, filename,
         :type mime_type: str
         :param gzip: Option to compress file for upload
         :type gzip: bool
+        :param multipart: If True, the upload will be split into multiple HTTP requests. The
+                          default size is 256MiB per request. Pass a number instead of True to
+                          specify the request size, which must be a multiple of 262144 (256KiB).
+        :type multipart: bool or int
+        :param num_retries: The number of times to attempt to re-upload the file (or individual
+                            chunks, in the case of multipart uploads). Retries are attempted
+                            with exponential backoff.
+        :type num_retries: int
         """
         service = self.get_conn()
 
@@ -200,23 +209,45 @@ def upload(self, bucket, object, filename,
                     shutil.copyfileobj(f_in, f_out)
                     filename = filename_gz
 
-        media = MediaFileUpload(filename, mime_type)
-
         try:
-            service \
-                .objects() \
-                .insert(bucket=bucket, name=object, media_body=media) \
-                .execute()
+            if multipart:
+                if multipart is True:
+                    chunksize = 256 * 1024 * 1024
+                else:
+                    chunksize = multipart
+
+                if chunksize % (256 * 1024) > 0 or chunksize < 0:
+                    raise ValueError("Multipart size is not a multiple of 262144 (256KiB)")
+
+                media = MediaFileUpload(filename, mimetype=mime_type,
+                                        chunksize=chunksize, resumable=True)
+
+                request = service.objects().insert(bucket=bucket, name=object, media_body=media)
+                response = None
+                while response is None:
+                    status, response = request.next_chunk(num_retries=num_retries)
+                    if status:
+                        self.log.info("Upload progress %.1f%%", status.progress() * 100)
+
+            else:
+                media = MediaFileUpload(filename, mime_type)
+
+                service \
+                    .objects() \
+                    .insert(bucket=bucket, name=object, media_body=media) \
+                    .execute(num_retries=num_retries)
 
-            # Clean up gzip file
-            if gzip:
-                os.remove(filename)
-            return True
         except errors.HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
 
+        finally:
+            if gzip:
+                os.remove(filename)
+
+        return True
+
     # pylint:disable=redefined-builtin
     def exists(self, bucket, object):
         """
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index eedceff1f7790..37d6f6d590330 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -18,6 +18,8 @@
 # under the License.
 
 import unittest
+import tempfile
+import os
 
 import airflow.contrib.hooks.gcs_hook as gcs_hook
 
@@ -340,3 +342,143 @@ def test_delete_nonexisting_object(self, mock_service):
         response = self.gcs_hook.delete(bucket=test_bucket, object=test_object)
 
         self.assertFalse(response)
+
+
+class TestGoogleCloudStorageHookUpload(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(BASE_STRING.format('GoogleCloudBaseHook.__init__')):
+            self.gcs_hook = gcs_hook.GoogleCloudStorageHook(
+                google_cloud_storage_conn_id='test'
+            )
+
+        # generate a 384KiB test file (larger than the minimum 256KiB multipart chunk size)
+        self.testfile = tempfile.NamedTemporaryFile(delete=False)
+        self.testfile.write(b"x" * 393216)
+        self.testfile.flush()
+
+    def tearDown(self):
+        os.unlink(self.testfile.name)
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_upload(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_object = 'test_object'
+
+        (mock_service.return_value.objects.return_value
+         .insert.return_value.execute.return_value) = {
+            "kind": "storage#object",
+            "id": "{}/{}/0123456789012345".format(test_bucket, test_object),
+            "name": test_object,
+            "bucket": test_bucket,
+            "generation": "0123456789012345",
+            "contentType": "application/octet-stream",
+            "timeCreated": "2018-03-15T16:51:02.502Z",
+            "updated": "2018-03-15T16:51:02.502Z",
+            "storageClass": "MULTI_REGIONAL",
+            "timeStorageClassUpdated": "2018-03-15T16:51:02.502Z",
+            "size": "393216",
+            "md5Hash": "leYUJBUWrRtks1UeUFONJQ==",
+            "crc32c": "xgdNfQ==",
+            "etag": "CLf4hODk7tkCEAE="
+        }
+
+        response = self.gcs_hook.upload(test_bucket,
+                                        test_object,
+                                        self.testfile.name)
+
+        self.assertTrue(response)
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_upload_gzip(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_object = 'test_object'
+
+        (mock_service.return_value.objects.return_value
+         .insert.return_value.execute.return_value) = {
+            "kind": "storage#object",
+            "id": "{}/{}/0123456789012345".format(test_bucket, test_object),
+            "name": test_object,
+            "bucket": test_bucket,
+            "generation": "0123456789012345",
+            "contentType": "application/octet-stream",
+            "timeCreated": "2018-03-15T16:51:02.502Z",
+            "updated": "2018-03-15T16:51:02.502Z",
+            "storageClass": "MULTI_REGIONAL",
+            "timeStorageClassUpdated": "2018-03-15T16:51:02.502Z",
+            "size": "393216",
+            "md5Hash": "leYUJBUWrRtks1UeUFONJQ==",
+            "crc32c": "xgdNfQ==",
+            "etag": "CLf4hODk7tkCEAE="
+        }
+
+        response = self.gcs_hook.upload(test_bucket,
+                                        test_object,
+                                        self.testfile.name,
+                                        gzip=True)
+        self.assertFalse(os.path.exists(self.testfile.name + '.gz'))
+        self.assertTrue(response)
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_upload_gzip_error(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_object = 'test_object'
+
+        (mock_service.return_value.objects.return_value
+         .insert.return_value.execute.side_effect) = HttpError(
+            resp={'status': '404'}, content=EMPTY_CONTENT)
+
+        response = self.gcs_hook.upload(test_bucket,
+                                        test_object,
+                                        self.testfile.name,
+                                        gzip=True)
+        self.assertFalse(os.path.exists(self.testfile.name + '.gz'))
+        self.assertFalse(response)
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_upload_multipart(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_object = 'test_object'
+
+        class MockProgress:
+            def __init__(self, value):
+                self.value = value
+
+            def progress(self):
+                return self.value
+
+        (mock_service.return_value.objects.return_value
+         .insert.return_value.next_chunk.side_effect) = [
+            (MockProgress(0.66), None),
+            (MockProgress(1.0), {
+                "kind": "storage#object",
+                "id": "{}/{}/0123456789012345".format(test_bucket, test_object),
+                "name": test_object,
+                "bucket": test_bucket,
+                "generation": "0123456789012345",
+                "contentType": "application/octet-stream",
+                "timeCreated": "2018-03-15T16:51:02.502Z",
+                "updated": "2018-03-15T16:51:02.502Z",
+                "storageClass": "MULTI_REGIONAL",
+                "timeStorageClassUpdated": "2018-03-15T16:51:02.502Z",
+                "size": "393216",
+                "md5Hash": "leYUJBUWrRtks1UeUFONJQ==",
+                "crc32c": "xgdNfQ==",
+                "etag": "CLf4hODk7tkCEAE="
+            })
+        ]
+
+        response = self.gcs_hook.upload(test_bucket,
+                                        test_object,
+                                        self.testfile.name,
+                                        multipart=True)
+
+        self.assertTrue(response)
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_upload_multipart_wrong_chunksize(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_object = 'test_object'
+
+        with self.assertRaises(ValueError):
+            self.gcs_hook.upload(test_bucket, test_object,
+                                 self.testfile.name, multipart=123)

From 0823038a513b28a26274d1ecae45dac16596046f Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 12 Jan 2019 10:07:45 +0100
Subject: [PATCH 403/808] [AIRFLOW-3675] Use googlapiclient for google apis
 (#4484)

The deprecated apiclient package name is used in a number of places.

This commit changes it to googleapiclient and modifies the right
packages to be used instead.
---
 airflow/contrib/hooks/bigquery_hook.py        |  6 ++--
 airflow/contrib/hooks/datastore_hook.py       |  2 +-
 airflow/contrib/hooks/gcp_api_base_hook.py    |  8 +++--
 airflow/contrib/hooks/gcp_dataflow_hook.py    |  2 +-
 airflow/contrib/hooks/gcp_dataproc_hook.py    |  2 +-
 airflow/contrib/hooks/gcp_kms_hook.py         |  4 +--
 airflow/contrib/hooks/gcp_mlengine_hook.py    | 18 +++++------
 airflow/contrib/hooks/gcp_pubsub_hook.py      | 20 ++++++-------
 airflow/contrib/hooks/gcp_sql_hook.py         |  6 ++--
 airflow/contrib/hooks/gcs_hook.py             | 30 +++++++++----------
 .../contrib/operators/mlengine_operator.py    |  6 ++--
 docs/conf.py                                  |  7 +++--
 tests/contrib/hooks/test_bigquery_hook.py     |  2 +-
 tests/contrib/hooks/test_gcp_mlengine_hook.py |  8 ++---
 tests/contrib/hooks/test_gcp_pubsub_hook.py   |  2 +-
 tests/contrib/hooks/test_gcs_hook.py          |  2 +-
 .../operators/test_mlengine_operator.py       | 16 +++++-----
 17 files changed, 72 insertions(+), 69 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 9eb940c905fdc..ab5d9f7496fab 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -34,8 +34,8 @@
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.hooks.dbapi_hook import DbApiHook
 from airflow.utils.log.logging_mixin import LoggingMixin
-from apiclient.discovery import HttpError, build
-from googleapiclient import errors
+from googleapiclient.discovery import build
+from googleapiclient.errors import HttpError
 from pandas_gbq.gbq import \
     _check_google_client_version as gbq_check_google_client_version
 from pandas_gbq import read_gbq
@@ -136,7 +136,7 @@ def table_exists(self, project_id, dataset_id, table_id):
                 projectId=project_id, datasetId=dataset_id,
                 tableId=table_id).execute()
             return True
-        except errors.HttpError as e:
+        except HttpError as e:
             if e.resp['status'] == '404':
                 return False
             raise
diff --git a/airflow/contrib/hooks/datastore_hook.py b/airflow/contrib/hooks/datastore_hook.py
index b8c3ca00a0f46..26ed4be544943 100644
--- a/airflow/contrib/hooks/datastore_hook.py
+++ b/airflow/contrib/hooks/datastore_hook.py
@@ -19,7 +19,7 @@
 #
 
 import time
-from apiclient.discovery import build
+from googleapiclient.discovery import build
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 90547579f0a69..70287ab5cec50 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -37,22 +37,24 @@ class GoogleCloudBaseHook(BaseHook, LoggingMixin):
     A base hook for Google cloud-related hooks. Google cloud has a shared REST
     API client that is built in the same way no matter which service you use.
     This class helps construct and authorize the credentials needed to then
-    call apiclient.discovery.build() to actually discover and build a client
+    call googleapiclient.discovery.build() to actually discover and build a client
     for a Google cloud service.
 
     The class also contains some miscellaneous helper functions.
 
     All hook derived from this base hook use the 'Google Cloud Platform' connection
-    type. Two ways of authentication are supported:
+    type. Three ways of authentication are supported:
 
     Default credentials: Only the 'Project Id' is required. You'll need to
     have set up default credentials, such as by the
     ``GOOGLE_APPLICATION_DEFAULT`` environment variable or from the metadata
     server on Google Compute Engine.
 
-    JSON key file: Specify 'Project Id', 'Key Path' and 'Scope'.
+    JSON key file: Specify 'Project Id', 'Keyfile Path' and 'Scope'.
 
     Legacy P12 key files are not supported.
+
+    JSON data provided in the UI: Specify 'Keyfile JSON'.
     """
 
     def __init__(self, gcp_conn_id='google_cloud_default', delegate_to=None):
diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 8c9b7423e0e6d..8d07b0514e22d 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -23,7 +23,7 @@
 import time
 import uuid
 
-from apiclient.discovery import build
+from googleapiclient.discovery import build
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index 98282f728a430..49345b51f731f 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -20,7 +20,7 @@
 import time
 import uuid
 
-from apiclient.discovery import build
+from googleapiclient.discovery import build
 from zope.deprecation import deprecation
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
diff --git a/airflow/contrib/hooks/gcp_kms_hook.py b/airflow/contrib/hooks/gcp_kms_hook.py
index 6f2b3aedffdbf..138cc173ed973 100644
--- a/airflow/contrib/hooks/gcp_kms_hook.py
+++ b/airflow/contrib/hooks/gcp_kms_hook.py
@@ -22,7 +22,7 @@
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
-from apiclient.discovery import build
+from googleapiclient.discovery import build
 
 
 def _b64encode(s):
@@ -48,7 +48,7 @@ def get_conn(self):
         """
         Returns a KMS service object.
 
-        :rtype: apiclient.discovery.Resource
+        :rtype: googleapiclient.discovery.Resource
         """
         http_authorized = self._authorize()
         return build(
diff --git a/airflow/contrib/hooks/gcp_mlengine_hook.py b/airflow/contrib/hooks/gcp_mlengine_hook.py
index b9f1008fa7fde..039f29e8fb7a1 100644
--- a/airflow/contrib/hooks/gcp_mlengine_hook.py
+++ b/airflow/contrib/hooks/gcp_mlengine_hook.py
@@ -15,8 +15,8 @@
 # limitations under the License.
 import random
 import time
-from apiclient import errors
-from apiclient.discovery import build
+from googleapiclient.errors import HttpError
+from googleapiclient.discovery import build
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -37,7 +37,7 @@ def _poll_with_exponential_delay(request, max_n, is_done_func, is_error_func):
                 return response
             else:
                 time.sleep((2**i) + (random.randint(0, 1000) / 1000))
-        except errors.HttpError as e:
+        except HttpError as e:
             if e.resp.status != 429:
                 log.info('Something went wrong. Not retrying: %s', format(e))
                 raise
@@ -96,7 +96,7 @@ def create_job(self, project_id, job, use_existing_job_fn=None):
 
         try:
             request.execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             # 409 means there is an existing job with the same job ID.
             if e.resp.status == 409:
                 if use_existing_job_fn is not None:
@@ -126,14 +126,14 @@ def _get_job(self, project_id, job_id):
         :rtype: dict
 
         Raises:
-            apiclient.errors.HttpError: if HTTP error is returned from server
+            googleapiclient.errors.HttpError: if HTTP error is returned from server
         """
         job_name = 'projects/{}/jobs/{}'.format(project_id, job_id)
         request = self._mlengine.projects().jobs().get(name=job_name)
         while True:
             try:
                 return request.execute()
-            except errors.HttpError as e:
+            except HttpError as e:
                 if e.resp.status == 429:
                     # polling after 30 seconds when quota failure occurs
                     time.sleep(30)
@@ -149,7 +149,7 @@ def _wait_for_job_done(self, project_id, job_id, interval=30):
         a terminal state.
 
         Raises:
-            apiclient.errors.HttpError: if HTTP error is returned when getting
+            googleapiclient.errors.HttpError: if HTTP error is returned when getting
             the job
         """
         if interval <= 0:
@@ -193,7 +193,7 @@ def set_default_version(self, project_id, model_name, version_name):
             response = request.execute()
             self.log.info('Successfully set version: %s to default', response)
             return response
-        except errors.HttpError as e:
+        except HttpError as e:
             self.log.error('Something went wrong: %s', e)
             raise
 
@@ -264,7 +264,7 @@ def get_model(self, project_id, model_name):
         request = self._mlengine.projects().models().get(name=full_model_name)
         try:
             return request.execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             if e.resp.status == 404:
                 self.log.error('Model was not found: %s', e)
                 return None
diff --git a/airflow/contrib/hooks/gcp_pubsub_hook.py b/airflow/contrib/hooks/gcp_pubsub_hook.py
index 1d55d5d487237..b160e9634719f 100644
--- a/airflow/contrib/hooks/gcp_pubsub_hook.py
+++ b/airflow/contrib/hooks/gcp_pubsub_hook.py
@@ -19,8 +19,8 @@
 
 from uuid import uuid4
 
-from apiclient.discovery import build
-from apiclient import errors
+from googleapiclient.discovery import build
+from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
@@ -50,7 +50,7 @@ def __init__(self, gcp_conn_id='google_cloud_default', delegate_to=None):
     def get_conn(self):
         """Returns a Pub/Sub service object.
 
-        :rtype: apiclient.discovery.Resource
+        :rtype: googleapiclient.discovery.Resource
         """
         http_authorized = self._authorize()
         return build(
@@ -75,7 +75,7 @@ def publish(self, project, topic, messages):
             topic=full_topic, body=body)
         try:
             request.execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             raise PubSubException(
                 'Error publishing to topic {}'.format(full_topic), e)
 
@@ -97,7 +97,7 @@ def create_topic(self, project, topic, fail_if_exists=False):
         try:
             service.projects().topics().create(
                 name=full_topic, body={}).execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             # Status code 409 indicates that the topic already exists.
             if str(e.resp['status']) == '409':
                 message = 'Topic already exists: {}'.format(full_topic)
@@ -124,7 +124,7 @@ def delete_topic(self, project, topic, fail_if_not_exists=False):
         full_topic = _format_topic(project, topic)
         try:
             service.projects().topics().delete(topic=full_topic).execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             # Status code 409 indicates that the topic was not found
             if str(e.resp['status']) == '404':
                 message = 'Topic does not exist: {}'.format(full_topic)
@@ -178,7 +178,7 @@ def create_subscription(self, topic_project, topic, subscription=None,
         try:
             service.projects().subscriptions().create(
                 name=full_subscription, body=body).execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             # Status code 409 indicates that the subscription already exists.
             if str(e.resp['status']) == '409':
                 message = 'Subscription already exists: {}'.format(
@@ -210,7 +210,7 @@ def delete_subscription(self, project, subscription,
         try:
             service.projects().subscriptions().delete(
                 subscription=full_subscription).execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             # Status code 404 indicates that the subscription was not found
             if str(e.resp['status']) == '404':
                 message = 'Subscription does not exist: {}'.format(
@@ -255,7 +255,7 @@ def pull(self, project, subscription, max_messages,
             response = service.projects().subscriptions().pull(
                 subscription=full_subscription, body=body).execute()
             return response.get('receivedMessages', [])
-        except errors.HttpError as e:
+        except HttpError as e:
             raise PubSubException(
                 'Error pulling messages from subscription {}'.format(
                     full_subscription), e)
@@ -279,7 +279,7 @@ def acknowledge(self, project, subscription, ack_ids):
             service.projects().subscriptions().acknowledge(
                 subscription=full_subscription, body={'ackIds': ack_ids}
             ).execute()
-        except errors.HttpError as e:
+        except HttpError as e:
             raise PubSubException(
                 'Error acknowledging {} messages pulled from subscription {}'
                 .format(len(ack_ids), full_subscription), e)
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 5c24b2e8a5d16..91f34f9c860ae 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -30,7 +30,7 @@
 import time
 import uuid
 from os.path import isfile
-from googleapiclient import errors
+from googleapiclient.errors import HttpError
 from subprocess import Popen, PIPE
 from six.moves.urllib.parse import quote_plus
 
@@ -284,7 +284,7 @@ def export_instance(self, project_id, instance_id, body):
             ).execute(num_retries=NUM_RETRIES)
             operation_name = response["name"]
             return self._wait_for_operation_to_complete(project_id, operation_name)
-        except errors.HttpError as ex:
+        except HttpError as ex:
             raise AirflowException(
                 'Exporting instance {} failed: {}'.format(instance_id, ex.content)
             )
@@ -313,7 +313,7 @@ def import_instance(self, project_id, instance_id, body):
             ).execute(num_retries=NUM_RETRIES)
             operation_name = response["name"]
             return self._wait_for_operation_to_complete(project_id, operation_name)
-        except errors.HttpError as ex:
+        except HttpError as ex:
             raise AirflowException(
                 'Importing instance {} failed: {}'.format(instance_id, ex.content)
             )
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 675fa672e4bd5..de83bde7522d5 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -17,9 +17,9 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-from apiclient.discovery import build
-from apiclient.http import MediaFileUpload
-from googleapiclient import errors
+from googleapiclient.discovery import build
+from googleapiclient.http import MediaFileUpload
+from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 from airflow.exceptions import AirflowException
@@ -90,7 +90,7 @@ def copy(self, source_bucket, source_object, destination_bucket=None,
                       destinationObject=destination_object, body='') \
                 .execute()
             return True
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
@@ -142,7 +142,7 @@ def rewrite(self, source_bucket, source_object, destination_bucket,
                     .execute()
                 self.log.info('Rewrite request #%s: %s', request_count, result)
             return True
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
@@ -237,7 +237,7 @@ def upload(self, bucket, object, filename,
                     .insert(bucket=bucket, name=object, media_body=media) \
                     .execute(num_retries=num_retries)
 
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
@@ -266,7 +266,7 @@ def exists(self, bucket, object):
                 .get(bucket=bucket, object=object) \
                 .execute()
             return True
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
@@ -304,7 +304,7 @@ def is_updated_after(self, bucket, object, ts):
                 if updated > ts:
                     return True
 
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] != '404':
                 raise
 
@@ -331,7 +331,7 @@ def delete(self, bucket, object, generation=None):
                 .delete(bucket=bucket, object=object, generation=generation) \
                 .execute()
             return True
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 return False
             raise
@@ -416,7 +416,7 @@ def get_size(self, bucket, object):
                 return size
             else:
                 raise ValueError('Object is not a file')
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 raise ValueError('Object Not Found')
 
@@ -443,7 +443,7 @@ def get_crc32c(self, bucket, object):
             self.log.info('The crc32c checksum of %s is %s', object, crc32c)
             return crc32c
 
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 raise ValueError('Object Not Found')
 
@@ -470,7 +470,7 @@ def get_md5hash(self, bucket, object):
             self.log.info('The md5Hash of %s is %s', object, md5hash)
             return md5hash
 
-        except errors.HttpError as ex:
+        except HttpError as ex:
             if ex.resp['status'] == '404':
                 raise ValueError('Object Not Found')
 
@@ -561,7 +561,7 @@ def create_bucket(self,
 
             return response['id']
 
-        except errors.HttpError as ex:
+        except HttpError as ex:
             raise AirflowException(
                 'Bucket creation failed. Error was: {}'.format(ex.content)
             )
@@ -599,7 +599,7 @@ def insert_bucket_acl(self, bucket, entity, role, user_project):
             ).execute()
             if response:
                 self.log.info('A new ACL entry created in bucket: %s', bucket)
-        except errors.HttpError as ex:
+        except HttpError as ex:
             raise AirflowException(
                 'Bucket ACL entry creation failed. Error was: {}'.format(ex.content)
             )
@@ -649,7 +649,7 @@ def insert_object_acl(self, bucket, object_name, entity, role, generation,
             if response:
                 self.log.info('A new ACL entry created for object: %s in bucket: %s',
                               object_name, bucket)
-        except errors.HttpError as ex:
+        except HttpError as ex:
             raise AirflowException(
                 'Object ACL entry creation failed. Error was: {}'.format(ex.content)
             )
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 8e75b3c608238..88dae39453081 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -15,7 +15,7 @@
 # limitations under the License.
 import re
 
-from apiclient import errors
+from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks.gcp_mlengine_hook import MLEngineHook
 from airflow.exceptions import AirflowException
@@ -264,7 +264,7 @@ def check_existing_job(existing_job):
         try:
             finished_prediction_job = hook.create_job(
                 self._project_id, prediction_request, check_existing_job)
-        except errors.HttpError:
+        except HttpError:
             raise
 
         if finished_prediction_job['state'] != 'SUCCEEDED':
@@ -604,7 +604,7 @@ def check_existing_job(existing_job):
         try:
             finished_training_job = hook.create_job(
                 self._project_id, training_request, check_existing_job)
-        except errors.HttpError:
+        except HttpError:
             raise
 
         if finished_training_job['state'] != 'SUCCEEDED':
diff --git a/docs/conf.py b/docs/conf.py
index 7c17f97bf9086..577b86da706eb 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -36,9 +36,10 @@
 import mock
 
 MOCK_MODULES = [
-    'apiclient',
-    'apiclient.discovery',
-    'apiclient.http',
+    'googleapiclient',
+    'googleapiclient.errors',
+    'googleapiclient.discovery',
+    'googleapiclient.http',
     'mesos',
     'mesos.interface',
     'mesos.native',
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index a7da79039f43c..baec6cafced42 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -23,7 +23,7 @@
 
 from google.auth.exceptions import GoogleAuthError
 import mock
-from apiclient.errors import HttpError
+from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks import bigquery_hook as hook
 from airflow.contrib.hooks.bigquery_hook import _cleanse_time_partitioning, \
diff --git a/tests/contrib/hooks/test_gcp_mlengine_hook.py b/tests/contrib/hooks/test_gcp_mlengine_hook.py
index f986354503607..7313d8dc9ba8e 100644
--- a/tests/contrib/hooks/test_gcp_mlengine_hook.py
+++ b/tests/contrib/hooks/test_gcp_mlengine_hook.py
@@ -25,9 +25,9 @@
     from urllib.parse import urlparse, parse_qsl
 
 from airflow.contrib.hooks import gcp_mlengine_hook as hook
-from apiclient import errors
-from apiclient.discovery import build_from_document
-from apiclient.http import HttpMockSequence
+from googleapiclient.errors import HttpError
+from googleapiclient.discovery import build_from_document
+from googleapiclient.http import HttpMockSequence
 from google.auth.exceptions import GoogleAuthError
 import requests
 
@@ -392,7 +392,7 @@ def check_input(existing_job):
                 self,
                 responses=responses,
                 expected_requests=expected_requests) as cml_hook:
-            with self.assertRaises(errors.HttpError):
+            with self.assertRaises(HttpError):
                 cml_hook.create_job(
                     project_id=project, job=my_job,
                     use_existing_job_fn=check_input)
diff --git a/tests/contrib/hooks/test_gcp_pubsub_hook.py b/tests/contrib/hooks/test_gcp_pubsub_hook.py
index b1290fb3320c3..3cd6e2a89b507 100644
--- a/tests/contrib/hooks/test_gcp_pubsub_hook.py
+++ b/tests/contrib/hooks/test_gcp_pubsub_hook.py
@@ -23,7 +23,7 @@
 from base64 import b64encode as b64e
 import unittest
 
-from apiclient.errors import HttpError
+from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks.gcp_pubsub_hook import PubSubException, PubSubHook
 
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index 37d6f6d590330..16a9afb0978b2 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -24,7 +24,7 @@
 import airflow.contrib.hooks.gcs_hook as gcs_hook
 
 from airflow.exceptions import AirflowException
-from apiclient.errors import HttpError
+from googleapiclient.errors import HttpError
 
 try:
     from unittest import mock
diff --git a/tests/contrib/operators/test_mlengine_operator.py b/tests/contrib/operators/test_mlengine_operator.py
index 9a8d56cfb2e43..bceeb5c225e54 100644
--- a/tests/contrib/operators/test_mlengine_operator.py
+++ b/tests/contrib/operators/test_mlengine_operator.py
@@ -22,7 +22,7 @@
 import unittest
 
 import httplib2
-from apiclient import errors
+from googleapiclient.errors import HttpError
 from mock import ANY, patch
 
 from airflow import DAG, configuration
@@ -85,7 +85,7 @@ def testSuccessWithModel(self):
             success_message['predictionInput'] = input_with_model
 
             hook_instance = mock_hook.return_value
-            hook_instance.get_job.side_effect = errors.HttpError(
+            hook_instance.get_job.side_effect = HttpError(
                 resp=httplib2.Response({
                     'status': 404
                 }), content=b'some bytes')
@@ -123,7 +123,7 @@ def testSuccessWithVersion(self):
             success_message['predictionInput'] = input_with_version
 
             hook_instance = mock_hook.return_value
-            hook_instance.get_job.side_effect = errors.HttpError(
+            hook_instance.get_job.side_effect = HttpError(
                 resp=httplib2.Response({
                     'status': 404
                 }), content=b'some bytes')
@@ -161,7 +161,7 @@ def testSuccessWithURI(self):
             success_message['predictionInput'] = input_with_uri
 
             hook_instance = mock_hook.return_value
-            hook_instance.get_job.side_effect = errors.HttpError(
+            hook_instance.get_job.side_effect = HttpError(
                 resp=httplib2.Response({
                     'status': 404
                 }), content=b'some bytes')
@@ -238,13 +238,13 @@ def testHttpError(self):
                 'projects/experimental/models/test_model'
 
             hook_instance = mock_hook.return_value
-            hook_instance.create_job.side_effect = errors.HttpError(
+            hook_instance.create_job.side_effect = HttpError(
                 resp=httplib2.Response({
                     'status': http_error_code
                 }),
                 content=b'Forbidden')
 
-            with self.assertRaises(errors.HttpError) as context:
+            with self.assertRaises(HttpError) as context:
                 prediction_task = MLEngineBatchPredictionOperator(
                     job_id='test_prediction',
                     project_id='test-project',
@@ -356,13 +356,13 @@ def testHttpError(self):
         with patch('airflow.contrib.operators.mlengine_operator.MLEngineHook') \
                 as mock_hook:
             hook_instance = mock_hook.return_value
-            hook_instance.create_job.side_effect = errors.HttpError(
+            hook_instance.create_job.side_effect = HttpError(
                 resp=httplib2.Response({
                     'status': http_error_code
                 }),
                 content=b'Forbidden')
 
-            with self.assertRaises(errors.HttpError) as context:
+            with self.assertRaises(HttpError) as context:
                 training_op = MLEngineTrainingOperator(
                     **self.TRAINING_DEFAULT_ARGS)
                 training_op.execute(None)

From 5adf0aa77b43f19c7bd2af75ec4fb9d3bed56249 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@gmail.com>
Date: Thu, 2 Aug 2018 12:44:16 -0700
Subject: [PATCH 404/808] [AIRFLOW-2658] Add GCP specific k8s pod operator
 (#3532)

Executes a task in a Kubernetes pod in the specified Google Kubernetes
Engine cluster. This makes it easier to interact with GCP kubernetes
engine service because it encapsulates acquiring credentials.
---
 .../operators/gcp_container_operator.py       | 149 +++++++++++++++
 docs/code.rst                                 |   1 +
 docs/integration.rst                          |   6 +
 .../operators/test_gcp_container_operator.py  | 172 +++++++++++++++++-
 4 files changed, 327 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/gcp_container_operator.py b/airflow/contrib/operators/gcp_container_operator.py
index 9c1eb12d7275c..c99f2a93f2c59 100644
--- a/airflow/contrib/operators/gcp_container_operator.py
+++ b/airflow/contrib/operators/gcp_container_operator.py
@@ -17,8 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+import os
+import subprocess
+import tempfile
+
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_container_hook import GKEClusterHook
+from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
 
@@ -172,3 +177,147 @@ def execute(self, context):
         hook = GKEClusterHook(self.project_id, self.location)
         create_op = hook.create_cluster(cluster=self.body)
         return create_op
+
+
+KUBE_CONFIG_ENV_VAR = "KUBECONFIG"
+G_APP_CRED = "GOOGLE_APPLICATION_CREDENTIALS"
+
+
+class GKEPodOperator(KubernetesPodOperator):
+    template_fields = ('project_id', 'location',
+                       'cluster_name') + KubernetesPodOperator.template_fields
+
+    @apply_defaults
+    def __init__(self,
+                 project_id,
+                 location,
+                 cluster_name,
+                 gcp_conn_id='google_cloud_default',
+                 *args,
+                 **kwargs):
+        """
+        Executes a task in a Kubernetes pod in the specified Google Kubernetes
+        Engine cluster
+
+        This Operator assumes that the system has gcloud installed and either
+        has working default application credentials or has configured a
+        connection id with a service account.
+
+        The **minimum** required to define a cluster to create are the variables
+        ``task_id``, ``project_id``, ``location``, ``cluster_name``, ``name``,
+        ``namespace``, and ``image``
+
+        **Operator Creation**: ::
+
+            operator = GKEPodOperator(task_id='pod_op',
+                                      project_id='my-project',
+                                      location='us-central1-a',
+                                      cluster_name='my-cluster-name',
+                                      name='task-name',
+                                      namespace='default',
+                                      image='perl')
+
+        .. seealso::
+            For more detail about application authentication have a look at the reference:
+            https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application
+
+        :param project_id: The Google Developers Console project id
+        :type project_id: str
+        :param location: The name of the Google Kubernetes Engine zone in which the
+            cluster resides, e.g. 'us-central1-a'
+        :type location: str
+        :param cluster_name: The name of the Google Kubernetes Engine cluster the pod
+            should be spawned in
+        :type cluster_name: str
+        :param gcp_conn_id: The google cloud connection id to use. This allows for
+            users to specify a service account.
+        :type gcp_conn_id: str
+        """
+        super(GKEPodOperator, self).__init__(*args, **kwargs)
+        self.project_id = project_id
+        self.location = location
+        self.cluster_name = cluster_name
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        # Specifying a service account file allows the user to using non default
+        # authentication for creating a Kubernetes Pod. This is done by setting the
+        # environment variable `GOOGLE_APPLICATION_CREDENTIALS` that gcloud looks at.
+        key_file = None
+
+        # If gcp_conn_id is not specified gcloud will use the default
+        # service account credentials.
+        if self.gcp_conn_id:
+            from airflow.hooks.base_hook import BaseHook
+            # extras is a deserialized json object
+            extras = BaseHook.get_connection(self.gcp_conn_id).extra_dejson
+            # key_file only gets set if a json file is created from a JSON string in
+            # the web ui, else none
+            key_file = self._set_env_from_extras(extras=extras)
+
+        # Write config to a temp file and set the environment variable to point to it.
+        # This is to avoid race conditions of reading/writing a single file
+        with tempfile.NamedTemporaryFile() as conf_file:
+            os.environ[KUBE_CONFIG_ENV_VAR] = conf_file.name
+            # Attempt to get/update credentials
+            # We call gcloud directly instead of using google-cloud-python api
+            # because there is no way to write kubernetes config to a file, which is
+            # required by KubernetesPodOperator.
+            # The gcloud command looks at the env variable `KUBECONFIG` for where to save
+            # the kubernetes config file.
+            subprocess.check_call(
+                ["gcloud", "container", "clusters", "get-credentials",
+                 self.cluster_name,
+                 "--zone", self.location,
+                 "--project", self.project_id])
+
+            # Since the key file is of type mkstemp() closing the file will delete it from
+            # the file system so it cannot be accessed after we don't need it anymore
+            if key_file:
+                key_file.close()
+
+            # Tell `KubernetesPodOperator` where the config file is located
+            self.config_file = os.environ[KUBE_CONFIG_ENV_VAR]
+            super(GKEPodOperator, self).execute(context)
+
+    def _set_env_from_extras(self, extras):
+        """
+        Sets the environment variable `GOOGLE_APPLICATION_CREDENTIALS` with either:
+
+        - The path to the keyfile from the specified connection id
+        - A generated file's path if the user specified JSON in the connection id. The
+            file is assumed to be deleted after the process dies due to how mkstemp()
+            works.
+
+        The environment variable is used inside the gcloud command to determine correct
+        service account to use.
+        """
+        key_path = self._get_field(extras, 'key_path', False)
+        keyfile_json_str = self._get_field(extras, 'keyfile_dict', False)
+
+        if not key_path and not keyfile_json_str:
+            self.log.info('Using gcloud with application default credentials.')
+        elif key_path:
+            os.environ[G_APP_CRED] = key_path
+        else:
+            # Write service account JSON to secure file for gcloud to reference
+            service_key = tempfile.NamedTemporaryFile(delete=False)
+            service_key.write(keyfile_json_str)
+            os.environ[G_APP_CRED] = service_key.name
+            # Return file object to have a pointer to close after use,
+            # thus deleting from file system.
+            return service_key
+
+    def _get_field(self, extras, field, default=None):
+        """
+        Fetches a field from extras, and returns it. This is some Airflow
+        magic. The google_cloud_platform hook type adds custom UI elements
+        to the hook page, which allow admins to specify service_account,
+        key_path, etc. They get formatted as shown below.
+        """
+        long_f = 'extra__google_cloud_platform__{}'.format(field)
+        if long_f in extras:
+            return extras[long_f]
+        else:
+            self.log.info('Field {} not found in extras.'.format(field))
+            return default
diff --git a/docs/code.rst b/docs/code.rst
index d8c5dab8bd7c0..1a90e738024c9 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -174,6 +174,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
 .. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
diff --git a/docs/integration.rst b/docs/integration.rst
index 1a64ab0a8c16e..511004e254f3e 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1371,6 +1371,12 @@ GKEClusterDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
 .. _GKEClusterDeleteOperator:
 
+GKEPodOperator
+^^^^^^^^^^^^^^
+
+.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
+.. _GKEPodOperator:
+
 Google Kubernetes Engine Hook
 """""""""""""""""""""""""""""
 
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index 0f67290cbf350..1685e9c6ac6eb 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -17,11 +17,13 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import os
 import unittest
 
 from airflow import AirflowException
 from airflow.contrib.operators.gcp_container_operator import GKEClusterCreateOperator, \
-    GKEClusterDeleteOperator
+    GKEClusterDeleteOperator, GKEPodOperator
+from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
 
 try:
     from unittest import mock
@@ -39,6 +41,15 @@
 PROJECT_BODY = {'name': 'test-name'}
 PROJECT_BODY_CREATE = {'name': 'test-name', 'initial_node_count': 1}
 
+TASK_NAME = 'test-task-name'
+NAMESPACE = 'default',
+IMAGE = 'bash'
+
+GCLOUD_COMMAND = "gcloud container clusters get-credentials {} --zone {} --project {}"
+KUBE_ENV_VAR = 'KUBECONFIG'
+GAC_ENV_VAR = 'GOOGLE_APPLICATION_CREDENTIALS'
+FILE_NAME = '/tmp/mock_name'
+
 
 class GoogleCloudPlatformContainerOperatorTest(unittest.TestCase):
 
@@ -123,3 +134,162 @@ def test_delete_execute_error_location(self, mock_hook):
 
             operator.execute(None)
             mock_hook.return_value.delete_cluster.assert_not_called()
+
+
+class GKEPodOperatorTest(unittest.TestCase):
+    def setUp(self):
+        self.gke_op = GKEPodOperator(project_id=PROJECT_ID,
+                                     location=PROJECT_LOCATION,
+                                     cluster_name=CLUSTER_NAME,
+                                     task_id=PROJECT_TASK_ID,
+                                     name=TASK_NAME,
+                                     namespace=NAMESPACE,
+                                     image=IMAGE)
+
+    def test_template_fields(self):
+        self.assertTrue(set(KubernetesPodOperator.template_fields).issubset(
+            GKEPodOperator.template_fields))
+
+    @mock.patch(
+        'airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator.execute')
+    @mock.patch('tempfile.NamedTemporaryFile')
+    @mock.patch("subprocess.check_call")
+    def test_execute_conn_id_none(self, proc_mock, file_mock, exec_mock):
+        self.gke_op.gcp_conn_id = None
+
+        file_mock.return_value.__enter__.return_value.name = FILE_NAME
+
+        self.gke_op.execute(None)
+
+        # Assert Environment Variable is being set correctly
+        self.assertIn(KUBE_ENV_VAR, os.environ)
+        self.assertEqual(os.environ[KUBE_ENV_VAR], FILE_NAME)
+
+        # Assert the gcloud command being called correctly
+        proc_mock.assert_called_with(
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+
+        self.assertEqual(self.gke_op.config_file, FILE_NAME)
+
+    @mock.patch('airflow.hooks.base_hook.BaseHook.get_connection')
+    @mock.patch(
+        'airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator.execute')
+    @mock.patch('tempfile.NamedTemporaryFile')
+    @mock.patch("subprocess.check_call")
+    @mock.patch.dict(os.environ, {})
+    def test_execute_conn_id_path(self, proc_mock, file_mock, exec_mock, get_con_mock):
+        # gcp_conn_id is defaulted to `google_cloud_default`
+
+        FILE_PATH = '/path/to/file'
+        KEYFILE_DICT = {"extra__google_cloud_platform__key_path": FILE_PATH}
+        get_con_mock.return_value.extra_dejson = KEYFILE_DICT
+        file_mock.return_value.__enter__.return_value.name = FILE_NAME
+
+        self.gke_op.execute(None)
+
+        # Assert Environment Variable is being set correctly
+        self.assertIn(KUBE_ENV_VAR, os.environ)
+        self.assertEqual(os.environ[KUBE_ENV_VAR], FILE_NAME)
+
+        self.assertIn(GAC_ENV_VAR, os.environ)
+        # since we passed in keyfile_path we should get a file
+        self.assertEqual(os.environ[GAC_ENV_VAR], FILE_PATH)
+
+        # Assert the gcloud command being called correctly
+        proc_mock.assert_called_with(
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+
+        self.assertEqual(self.gke_op.config_file, FILE_NAME)
+
+    @mock.patch.dict(os.environ, {})
+    @mock.patch('airflow.hooks.base_hook.BaseHook.get_connection')
+    @mock.patch(
+        'airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator.execute')
+    @mock.patch('tempfile.NamedTemporaryFile')
+    @mock.patch("subprocess.check_call")
+    def test_execute_conn_id_dict(self, proc_mock, file_mock, exec_mock, get_con_mock):
+        # gcp_conn_id is defaulted to `google_cloud_default`
+        FILE_PATH = '/path/to/file'
+
+        # This is used in the _set_env_from_extras method
+        file_mock.return_value.name = FILE_PATH
+        # This is used in the execute method
+        file_mock.return_value.__enter__.return_value.name = FILE_NAME
+
+        KEYFILE_DICT = {"extra__google_cloud_platform__keyfile_dict":
+                        '{"private_key": "r4nd0m_k3y"}'}
+        get_con_mock.return_value.extra_dejson = KEYFILE_DICT
+
+        self.gke_op.execute(None)
+
+        # Assert Environment Variable is being set correctly
+        self.assertIn(KUBE_ENV_VAR, os.environ)
+        self.assertEqual(os.environ[KUBE_ENV_VAR], FILE_NAME)
+
+        self.assertIn(GAC_ENV_VAR, os.environ)
+        # since we passed in keyfile_path we should get a file
+        self.assertEqual(os.environ[GAC_ENV_VAR], FILE_PATH)
+
+        # Assert the gcloud command being called correctly
+        proc_mock.assert_called_with(
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+
+        self.assertEqual(self.gke_op.config_file, FILE_NAME)
+
+    @mock.patch.dict(os.environ, {})
+    def test_set_env_from_extras_none(self):
+        extras = {}
+        self.gke_op._set_env_from_extras(extras)
+        # _set_env_from_extras should not edit os.environ if extras does not specify
+        self.assertNotIn(GAC_ENV_VAR, os.environ)
+
+    @mock.patch.dict(os.environ, {})
+    @mock.patch('tempfile.NamedTemporaryFile')
+    def test_set_env_from_extras_dict(self, file_mock):
+        file_mock.return_value.name = FILE_NAME
+
+        KEYFILE_DICT_STR = '{ \"test\": \"cluster\" }'
+        extras = {
+            'extra__google_cloud_platform__keyfile_dict': KEYFILE_DICT_STR,
+        }
+
+        self.gke_op._set_env_from_extras(extras)
+        self.assertEquals(os.environ[GAC_ENV_VAR], FILE_NAME)
+
+        file_mock.return_value.write.assert_called_once_with(KEYFILE_DICT_STR)
+
+    @mock.patch.dict(os.environ, {})
+    def test_set_env_from_extras_path(self):
+        TEST_PATH = '/test/path'
+
+        extras = {
+            'extra__google_cloud_platform__key_path': TEST_PATH,
+        }
+
+        self.gke_op._set_env_from_extras(extras)
+        self.assertEquals(os.environ[GAC_ENV_VAR], TEST_PATH)
+
+    def test_get_field(self):
+        FIELD_NAME = 'test_field'
+        FIELD_VALUE = 'test_field_value'
+        extras = {
+            'extra__google_cloud_platform__{}'.format(FIELD_NAME):
+                FIELD_VALUE
+        }
+
+        ret_val = self.gke_op._get_field(extras, FIELD_NAME)
+        self.assertEqual(FIELD_VALUE, ret_val)
+
+    @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEPodOperator.log')
+    def test_get_field_fail(self, log_mock):
+        log_mock.info = mock.Mock()
+        LOG_STR = 'Field {} not found in extras.'
+        FIELD_NAME = 'test_field'
+        FIELD_VALUE = 'test_field_value'
+
+        extras = {}
+
+        ret_val = self.gke_op._get_field(extras, FIELD_NAME, default=FIELD_VALUE)
+        # Assert default is returned upon failure
+        self.assertEqual(FIELD_VALUE, ret_val)
+        log_mock.info.assert_called_with(LOG_STR.format(FIELD_NAME))

From 6ff39dd47d04209bc9ebd45ea8bf56d7b35855a2 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Wed, 5 Dec 2018 21:35:29 +0100
Subject: [PATCH 405/808] [AIRFLOW-XXX] GCP operators documentation
 clarifications (#4273)

---
 airflow/contrib/hooks/gcp_sql_hook.py         |  72 ++++++------
 docs/howto/manage-connections.rst             |  36 +++---
 docs/howto/operator.rst                       | 111 ++++++++++--------
 docs/integration.rst                          |   6 +-
 .../operators/test_gcp_sql_operator.py        |   4 +-
 5 files changed, 118 insertions(+), 111 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 91f34f9c860ae..7089e9a8c5577 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -116,7 +116,7 @@ def create_instance(self, project_id, body):
         :param body: Body required by the Cloud SQL insert API, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise.
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().instances().insert(
@@ -140,7 +140,7 @@ def patch_instance(self, project_id, body, instance):
         :type body: dict
         :param instance: Cloud SQL instance ID. This does not include the project ID.
         :type instance: str
-        :return: True if the operation succeeded, raises an error otherwise.
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().instances().patch(
@@ -159,7 +159,7 @@ def delete_instance(self, project_id, instance):
         :type project_id: str
         :param instance: Cloud SQL instance ID. This does not include the project ID.
         :type instance: str
-        :return: True if the operation succeeded, raises an error otherwise
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().instances().delete(
@@ -200,7 +200,7 @@ def create_database(self, project, instance, body):
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise.
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().databases().insert(
@@ -216,7 +216,7 @@ def patch_database(self, project, instance, database, body):
         Updates a database resource inside a Cloud SQL instance.
 
         This method supports patch semantics.
-        See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+        See https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch.
 
         :param project: Project ID of the project that contains the instance.
         :type project: str
@@ -227,7 +227,7 @@ def patch_database(self, project, instance, database, body):
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise.
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().databases().patch(
@@ -249,7 +249,7 @@ def delete_database(self, project, instance, database):
         :type instance: str
         :param database: Name of the database to be deleted in the instance.
         :type database: str
-        :return: True if the operation succeeded, raises an error otherwise.
+        :return: True if the operation succeeded otherwise raises an error.
         :rtype: bool
         """
         response = self.get_conn().databases().delete(
@@ -357,11 +357,11 @@ def _wait_for_operation_to_complete(self, project_id, operation_name):
 
 class CloudSqlProxyRunner(LoggingMixin):
     """
-    Downloads and runs cloud-sql-proxy as subprocess of the python process.
+    Downloads and runs cloud-sql-proxy as subprocess of the Python process.
 
     The cloud-sql-proxy needs to be downloaded and started before we can connect
     to the Google Cloud SQL instance via database connection. It establishes
-    secure tunnel connection to the database - it authorizes using the
+    secure tunnel connection to the database. It authorizes using the
     GCP credentials that are passed by the configuration.
 
     More details about the proxy can be found here:
@@ -501,7 +501,7 @@ def _get_credential_parameters(self, session):
 
     def start_proxy(self):
         """
-        Starts Cloud Sql Proxy.
+        Starts Cloud SQL Proxy.
 
         You have to remember to stop the proxy if you started it!
         """
@@ -578,7 +578,7 @@ def stop_proxy(self):
 
     def get_proxy_version(self):
         """
-        Returns version of the Cloud Sql Proxy.
+        Returns version of the Cloud SQL Proxy.
         """
         self._download_sql_proxy_if_needed()
         command_to_run = [self.sql_proxy_path]
@@ -594,7 +594,7 @@ def get_proxy_version(self):
 
     def get_socket_path(self):
         """
-        Retrieves UNIX socket path used by Cloud Sql Proxy.
+        Retrieves UNIX socket path used by Cloud SQL Proxy.
 
         :return: The dynamically generated path for the socket created by the proxy.
         :rtype: str
@@ -645,38 +645,38 @@ def get_socket_path(self):
 # noinspection PyAbstractClass
 class CloudSqlDatabaseHook(BaseHook):
     """
-    Serves DB connection configuration for CloudSQL (Connections
+    Serves DB connection configuration for Google Cloud SQL (Connections
     of *gcpcloudsql://* type).
 
-    The hook is a "meta" one - it does not perform an actual connection,
-    it is there to retrieve all the parameters configured in gcpcloudsql:// connection,
-    start/stop Cloud Sql Proxy if needed, dynamically generate Postgres or MySQL
+    The hook is a "meta" one. It does not perform an actual connection.
+    It is there to retrieve all the parameters configured in gcpcloudsql:// connection,
+    start/stop Cloud SQL Proxy if needed, dynamically generate Postgres or MySQL
     connection in the database and return an actual Postgres or MySQL hook.
-    The returned Postgres/MySQL hooks are using direct connection or Cloud Sql
-    Proxy socket/tcp as configured.
+    The returned Postgres/MySQL hooks are using direct connection or Cloud SQL
+    Proxy socket/TCP as configured.
 
     Main parameters of the hook are retrieved from the standard URI components:
 
     * **user** - User name to authenticate to the database (from login of the URI).
-    * **password** - Password to authenticate to the database (from password of the URI)
-    * **public_ip** - IP to connect to for public connection (from host of the URI)
-    * **public_port** - Port to connect to for public connection (from port of the URI)
-    * **database** - Database to connect to (from schema of the URI)
+    * **password** - Password to authenticate to the database (from password of the URI).
+    * **public_ip** - IP to connect to for public connection (from host of the URI).
+    * **public_port** - Port to connect to for public connection (from port of the URI).
+    * **database** - Database to connect to (from schema of the URI).
 
     Remaining parameters are retrieved from the extras (URI query parameters):
 
     * **project_id** - Google Cloud Platform project where the Cloud SQL instance exists.
     * **instance** -  Name of the instance of the Cloud SQL database instance.
-    * **location** - The location of the cloud sql instance (for example europe-west1).
-    * **database_type** - The type of the database instance (mysql or postgres).
+    * **location** - The location of the Cloud SQL instance (for example europe-west1).
+    * **database_type** - The type of the database instance (MySQL or Postgres).
     * **use_proxy** - (default False) Whether SQL proxy should be used to connect to Cloud
       SQL DB.
     * **use_ssl** - (default False) Whether SSL should be used to connect to Cloud SQL DB.
-      You cannot use proxy and ssl together.
+      You cannot use proxy and SSL together.
     * **sql_proxy_use_tcp** - (default False) If set to true, TCP is used to connect via
       proxy, otherwise UNIX sockets are used.
-    * **sql_proxy_binary_path** - Optional path to sql proxy binary. If the binary is not
-      specified or the binary is not present, it is automatically downloaded.
+    * **sql_proxy_binary_path** - Optional path to Cloud SQL Proxy binary. If the binary
+      is not specified or the binary is not present, it is automatically downloaded.
     * **sql_proxy_version** -  Specific version of the proxy to download (for example
       v1.13). If not specified, the latest version is downloaded.
     * **sslcert** - Path to client certificate to authenticate when SSL is used.
@@ -745,8 +745,8 @@ def _validate_inputs(self):
                 self.database_type, CLOUD_SQL_VALID_DATABASE_TYPES
             ))
         if self.use_proxy and self.use_ssl:
-            raise AirflowException("Cloud Sql Proxy does not support SSL connections."
-                                   " SSL is not needed as Cloud Sql Proxy "
+            raise AirflowException("Cloud SQL Proxy does not support SSL connections."
+                                   " SSL is not needed as Cloud SQL Proxy "
                                    "provides encryption on its own")
 
     def validate_ssl_certs(self):
@@ -854,7 +854,7 @@ def _get_sqlproxy_instance_specification(self):
     @provide_session
     def create_connection(self, session=None):
         """
-        Create connection in the Connection table - according to whether it uses
+        Create connection in the Connection table, according to whether it uses
         proxy, TCP, UNIX sockets, SSL. Connection ID will be randomly generated.
 
         :param session: Session of the SQL Alchemy ORM (automatically generated with
@@ -883,10 +883,10 @@ def delete_connection(self, session=None):
 
     def get_sqlproxy_runner(self):
         """
-        Retrieve Cloud Sql Proxy runner. It is used to manage the proxy
+        Retrieve Cloud SQL Proxy runner. It is used to manage the proxy
         lifecycle per task.
 
-        :return: The Cloud Sql Proxy runner.
+        :return: The Cloud SQL Proxy runner.
         :rtype: CloudSqlProxyRunner
         """
         return CloudSqlProxyRunner(
@@ -899,8 +899,8 @@ def get_sqlproxy_runner(self):
 
     def get_database_hook(self):
         """
-        Retrieve database hook - this is the actual Postgres or MySQL database hook
-        that uses proxy or connects directly to the Google Cloud Sql database.
+        Retrieve database hook. This is the actual Postgres or MySQL database hook
+        that uses proxy or connects directly to the Google Cloud SQL database.
         """
         if self.database_type == 'postgres':
             self.db_hook = PostgresHook(postgres_conn_id=self.db_conn_id,
@@ -921,7 +921,7 @@ def cleanup_database_hook(self):
 
     def reserve_free_tcp_port(self):
         """
-        Reserve free TCP port to be used by Cloud Sql Proxy
+        Reserve free TCP port to be used by Cloud SQL Proxy
         """
         self.reserved_tcp_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
         self.reserved_tcp_socket.bind(('127.0.0.1', 0))
@@ -929,7 +929,7 @@ def reserve_free_tcp_port(self):
 
     def free_reserved_port(self):
         """
-        Free TCP port - makes it immediately ready to be used by Cloud Sql Proxy.
+        Free TCP port. Makes it immediately ready to be used by Cloud SQL Proxy.
         """
         if self.reserved_tcp_socket:
             self.reserved_tcp_socket.close()
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 35b5807c9ea96..f38ff2fb61abe 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -16,7 +16,7 @@
     under the License.
 
 Managing Connections
-=====================
+====================
 
 Airflow needs to know how to connect to your environment. Information
 such as hostname, port, login and passwords to other systems and services is
@@ -170,21 +170,21 @@ Password (required)
     Specify the password to connect.    
     
 Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in mysql
+    Specify the extra parameters (as json dictionary) that can be used in MySQL
     connection. The following parameters are supported:
 
     * **charset**: specify charset of the connection
-    * **cursor**: one of "sscursor", "dictcursor, "ssdictcursor" - specifies cursor class to be
+    * **cursor**: one of "sscursor", "dictcursor, "ssdictcursor" . Specifies cursor class to be
       used
     * **local_infile**: controls MySQL's LOCAL capability (permitting local data loading by
       clients). See `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_
       for details.
-    * **unix_socket**: UNIX socket used instead of the default socket
-    * **ssl**: Dictionary of SSL parameters that control connecting using SSL (those
+    * **unix_socket**: UNIX socket used instead of the default socket.
+    * **ssl**: Dictionary of SSL parameters that control connecting using SSL. Those
       parameters are server specific and should contain "ca", "cert", "key", "capath",
       "cipher" parameters. See
       `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_ for details.
-      Note that in order to be useful in URL notation, this parameter might also be
+      Note that to be useful in URL notation, this parameter might also be
       a string where the SSL dictionary is a string-encoded JSON dictionary.
 
     Example "extras" field:
@@ -216,8 +216,8 @@ Extra (optional)
        }
 
     When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras are passed as parameters
-    of the URI (note that all components of the URI should be URL-encoded).
+    following the standard syntax of DB connections - where extras are passed as parameters
+    of the URI. Note that all components of the URI should be URL-encoded.
 
     For example:
 
@@ -226,7 +226,7 @@ Extra (optional)
        mysql://mysql_user:XXXXXXXXXXXX@1.1.1.1:3306/mysqldb?ssl=%7B%22cert%22%3A+%22%2Ftmp%2Fclient-cert.pem%22%2C+%22ca%22%3A+%22%2Ftmp%2Fserver-ca.pem%22%2C+%22key%22%3A+%22%2Ftmp%2Fclient-key.pem%22%7D
 
     .. note::
-        If encounter UnicodeDecodeError while working with MySQL connection check
+        If encounter UnicodeDecodeError while working with MySQL connection, check
         the charset defined is matched to the database charset.
 
 Postgres
@@ -269,7 +269,7 @@ Extra (optional)
       should send a keepalive message to the server.
 
     More details on all Postgres parameters supported can be found in
-    `Postgres documentation <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING>`_
+    `Postgres documentation <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING>`_.
 
     Example "extras" field:
 
@@ -297,14 +297,14 @@ Cloudsql
 The gcpcloudsql:// connection is used by
 :class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator` to perform query
 on a Google Cloud SQL database. Google Cloud SQL database can be either
-Postgres or MySQL, so this is a "meta" connection type - it introduces common schema
+Postgres or MySQL, so this is a "meta" connection type. It introduces common schema
 for both MySQL and Postgres, including what kind of connectivity should be used.
-Google Cloud SQL supports connecting via public IP or via Cloud Sql Proxy
-and in the latter case the
+Google Cloud SQL supports connecting via public IP or via Cloud SQL Proxy.
+In the latter case the
 :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` uses
 :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to automatically prepare
 and use temporary Postgres or MySQL connection that will use the proxy to connect
-(either via TCP or UNIX socket)
+(either via TCP or UNIX socket.
 
 Configuring the Connection
 ''''''''''''''''''''''''''
@@ -321,7 +321,7 @@ Password (required)
     Specify the password to connect.
 
 Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in gcpcloudsql
+    Specify the extra parameters (as JSON dictionary) that can be used in Google Cloud SQL
     connection.
 
     Details of all the parameters supported in extra field can be found in
@@ -340,9 +340,9 @@ Extra (optional)
           "sql_proxy_use_tcp": false
        }
 
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras are passed as parameters
-    of the URI (note that all components of the URI should be URL-encoded).
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable), you should specify
+    it following the standard syntax of DB connection, where extras are passed as
+    parameters of the URI. Note that all components of the URI should be URL-encoded.
 
     For example:
 
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 65d38d5ef25b5..2aa57831bf7a8 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -162,7 +162,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_
+See `Google Compute Engine API documentation
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
 
 
 GceInstanceStopOperator
@@ -170,7 +171,7 @@ GceInstanceStopOperator
 
 Use the operator to stop Google Compute Engine instance.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator`
 
 Arguments
@@ -204,7 +205,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_
+See `Google Compute Engine API documentation
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
 
 
 GceSetMachineTypeOperator
@@ -212,8 +214,8 @@ GceSetMachineTypeOperator
 
 Use the operator to change machine type of a Google Compute Engine instance.
 
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`.
 
 Arguments
 """""""""
@@ -252,7 +254,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_
+See `Google Compute Engine API documentation
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
 
 
 GceInstanceTemplateCopyOperator
@@ -261,7 +264,7 @@ GceInstanceTemplateCopyOperator
 Use the operator to copy an existing Google Compute Engine instance template
 applying a patch to it.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator`.
 
 Arguments
@@ -300,14 +303,15 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_
+See `Google Compute Engine API documentation
+<https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
 
 GceInstanceGroupManagerUpdateTemplateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Use the operator to update template in Google Compute Engine Instance Group Manager.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`.
 
 Arguments
@@ -347,13 +351,15 @@ Troubleshooting
 """""""""""""""
 
 You might find that your GceInstanceGroupManagerUpdateTemplateOperator fails with
-missing permissions. The service account has to have Service Account User role assigned
-via IAM permissions in order to execute the operation.
+missing permissions. To execute the operation, the service account requires
+the permissions that theService Account User role provides
+(assigned via Google Cloud IAM).
 
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation <https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_
+See `Google Compute Engine API documentation
+<https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_.
 
 Google Cloud Bigtable Operators
 -------------------------------
@@ -492,7 +498,7 @@ GcfFunctionDeleteOperator
 
 Use the operator to delete a function from Google Cloud Functions.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`.
 
 Arguments
@@ -546,19 +552,21 @@ and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
     --role="roles/iam.serviceAccountUser"
 
 
-See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
+See `Adding the IAM service agent user role to the runtime service
+<https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_.
 
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_
+See `Google Cloud Functions API documentation
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
 
 GcfFunctionDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Use the operator to deploy a function to Google Cloud Functions.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`.
 
 
@@ -592,7 +600,8 @@ Note that the neither the body nor the default args are complete in the above ex
 Depending on the variables set, there might be different variants on how to pass source
 code related fields. Currently, you can pass either sourceArchiveUrl, sourceRepository
 or sourceUploadUrl as described in the
-`Cloud Functions API specification <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
+`Cloud Functions API specification
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
 
 Additionally, default_args or direct operator args might contain zip_path parameter
 to run the extra step of uploading the source code before deploying it.
@@ -659,7 +668,8 @@ can be downloaded if necessary.
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_
+See `Google Cloud Functions API documentation
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_.
 
 Google Cloud Spanner Operators
 ------------------------------
@@ -895,7 +905,7 @@ CloudSqlInstanceDatabaseCreateOperator
 
 Creates a new database inside a Cloud SQL instance.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator`.
 
 Arguments
@@ -944,7 +954,7 @@ CloudSqlInstanceDatabaseDeleteOperator
 
 Deletes a database from a Cloud SQL instance.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator`.
 
 Arguments
@@ -988,7 +998,7 @@ Updates a resource containing information about a database inside a Cloud SQL in
 using patch semantics.
 See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator`.
 
 Arguments
@@ -1037,7 +1047,7 @@ CloudSqlInstanceDeleteOperator
 
 Deletes a Cloud SQL instance in Google Cloud Platform.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`.
 
 Arguments
@@ -1253,7 +1263,7 @@ CloudSqlInstanceCreateOperator
 
 Creates a new Cloud SQL instance in Google Cloud Platform.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`.
 
 If an instance with the same name exists, no action will be taken and the operator
@@ -1297,8 +1307,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for insert <https://cloud.google
-.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
+See `Google Cloud SQL API documentation for insert
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
 
 .. _CloudSqlInstancePatchOperator:
 
@@ -1307,7 +1317,7 @@ CloudSqlInstancePatchOperator
 
 Updates settings of a Cloud SQL instance in Google Cloud Platform (partial update).
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator`.
 
 This is a partial update, so only values for the settings specified in the body
@@ -1352,44 +1362,44 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for patch <https://cloud.google
-.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
+See `Google Cloud SQL API documentation for patch
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
 
 
 CloudSqlQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^
 
 Performs DDL or DML SQL queries in Google Cloud SQL instance. The DQL
-(retrieving data from Google Cloud SQL) is not supported - you might run the SELECT
-queries but results of those queries are discarded.
+(retrieving data from Google Cloud SQL) is not supported. You might run the SELECT
+queries, but the results of those queries are discarded.
 
-You can specify various connectivity methods to connect to running instance -
+You can specify various connectivity methods to connect to running instance,
 starting from public IP plain connection through public IP with SSL or both TCP and
-socket connection via Cloud Sql Proxy. The proxy is downloaded and started/stopped
+socket connection via Cloud SQL Proxy. The proxy is downloaded and started/stopped
 dynamically as needed by the operator.
 
 There is a *gcpcloudsql://* connection type that you should use to define what
 kind of connectivity you want the operator to use. The connection is a "meta"
 type of connection. It is not used to make an actual connectivity on its own, but it
-determines whether Cloud Sql Proxy should be started by `CloudSqlDatabaseHook`
-and what kind of the database connection (Postgres or MySQL) should be created
-dynamically - to either connect to Cloud SQL via public IP address or via the proxy.
+determines whether Cloud SQL Proxy should be started by `CloudSqlDatabaseHook`
+and what kind of database connection (Postgres or MySQL) should be created
+dynamically to connect to Cloud SQL via public IP address or via the proxy.
 The 'CloudSqlDatabaseHook` uses
-:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to manage Cloud Sql
-Proxy lifecycle (each task has its own Cloud Sql Proxy)
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to manage Cloud SQL
+Proxy lifecycle (each task has its own Cloud SQL Proxy)
 
 When you build connection, you should use connection parameters as described in
 :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`. You can see
 examples of connections below for all the possible types of connectivity. Such connection
-can be reused between different tasks (instances of `CloudSqlQueryOperator`) - each
+can be reused between different tasks (instances of `CloudSqlQueryOperator`). Each
 task will get their own proxy started if needed with their own TCP or UNIX socket.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator`.
 
-Since query operator can run arbitrary query - it cannot be guaranteed to be
-idempotent. SQL query designer should design the queries to be idempotent. For example
-both Postgres and MySql support CREATE TABLE IF NOT EXISTS statements that can be
+Since query operator can run arbitrary query, it cannot be guaranteed to be
+idempotent. SQL query designer should design the queries to be idempotent. For example,
+both Postgres and MySQL support CREATE TABLE IF NOT EXISTS statements that can be
 used to create tables in an idempotent way.
 
 Arguments
@@ -1422,8 +1432,8 @@ of the connection URI should be URL-encoded:
 Using the operator
 """"""""""""""""""
 
-Example operators below are using all connectivity options (note connection id
-from the operator matches the `AIRFLOW_CONN_*` postfix uppercase - this is
+Example operators below are using all connectivity options. Note connection id
+from the operator matches the `AIRFLOW_CONN_*` postfix uppercase. This is
 standard AIRFLOW notation for defining connection via environment variables):
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
@@ -1443,9 +1453,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Sql Proxy documentation
-<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_
-for details about Cloud Sql Proxy.
+See `Google Cloud SQL Proxy documentation
+<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_.
 
 Google Cloud Storage Operators
 ------------------------------
@@ -1455,7 +1464,7 @@ GoogleCloudStorageBucketCreateAclEntryOperator
 
 Creates a new ACL entry on the specified bucket.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`
 
 Arguments
@@ -1490,15 +1499,14 @@ More information
 """"""""""""""""
 
 See `Google Cloud Storage BucketAccessControls insert documentation
-<https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_
-for details.
+<https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_.
 
 GoogleCloudStorageObjectCreateAclEntryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Creates a new ACL entry on the specified object.
 
-For parameter definition take a look at
+For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`
 
 Arguments
@@ -1534,4 +1542,3 @@ More information
 
 See `Google Cloud Storage ObjectAccessControls insert documentation
 <https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_
-for details.
diff --git a/docs/integration.rst b/docs/integration.rst
index 511004e254f3e..b408b7ba39a56 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -910,11 +910,11 @@ Compute Engine Operators
 - :ref:`GceInstanceGroupManagerUpdateTemplateOperator` : patch the Instance Group Manager,
   replacing source Instance Template URL with the destination one.
 
-The operators have common base operator:
+The operators have the common base operator:
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
 
-They also use :ref:`GceHook` hook to communicate with Google Cloud Platform.
+They also use :ref:`GceHook` to communicate with Google Cloud Platform.
 
 .. _GceInstanceStartOperator:
 
@@ -971,7 +971,7 @@ Cloud Functions Operators
 
 .. autoclass:: airflow.contrib.operators.gcp_operator.GCP
 
-They also use :ref:`GcfHook` hook to communicate with Google Cloud Platform.
+They also use :ref:`GcfHook` to communicate with Google Cloud Platform.
 
 .. _GcfFunctionDeployOperator:
 
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index f8e8434e92a0a..6e5b2e4e866ab 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -561,8 +561,8 @@ class CloudSqlQueryValidationTest(unittest.TestCase):
          "Invalid database type 'wrong'. Must be one of ['postgres', 'mysql']"),
         ('project_id', 'location', 'instance_name', 'postgres', True, True,
          'SELECT * FROM TEST',
-         "Cloud Sql Proxy does not support SSL connections. SSL is not needed as"
-         " Cloud Sql Proxy provides encryption on its own"),
+         "Cloud SQL Proxy does not support SSL connections. SSL is not needed as"
+         " Cloud SQL Proxy provides encryption on its own"),
         ('project_id', 'location', 'instance_name', 'postgres', False, True,
          'SELECT * FROM TEST',
          "SSL connections requires sslcert to be set"),

From c52468c3123b596197b12b9e188cfbfab0942abc Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Sat, 12 Jan 2019 13:44:01 +0100
Subject: [PATCH 406/808] [AIRFLOW-3680] Consistency update in tests for All
 GCP-related operators (#4493)

---
 .../example_gcp_bigtable_operators.py         |   5 +-
 .../example_dags/example_gcp_compute.py       |  59 ++-
 .../example_dags/example_gcp_compute_igm.py   |  63 ++-
 .../example_dags/example_gcp_function.py      | 125 +++++
 .../example_gcp_function_delete.py            |  59 ---
 .../example_gcp_function_deploy_delete.py     | 117 -----
 .../example_dags/example_gcp_spanner.py       |   7 +-
 .../contrib/example_dags/example_gcp_sql.py   |  48 +-
 .../example_dags/example_gcp_sql_query.py     | 159 +++---
 airflow/contrib/hooks/gcp_function_hook.py    |  20 +-
 .../operators/gcp_function_operator.py        |  33 +-
 docs/howto/operator.rst                       |  92 ++--
 .../contrib/hooks/test_gcp_container_hook.py  |  62 ++-
 tests/contrib/hooks/test_gcp_dataproc_hook.py |   8 +-
 .../operators/postgres_local_executor.cfg     |  28 +
 .../operators/test_bigquery_operator.py       |  14 +-
 .../operators/test_dataproc_operator.py       |  94 ++--
 tests/contrib/operators/test_gcp_base.py      | 175 -------
 .../test_gcp_bigtable_operator_system.py      |  47 ++
 ...est_gcp_bigtable_operator_system_helper.py |  67 +++
 .../operators/test_gcp_compute_operator.py    | 151 +++---
 .../test_gcp_compute_operator_system.py       |  84 +++
 ...test_gcp_compute_operator_system_helper.py | 124 +++++
 .../operators/test_gcp_container_operator.py  |  22 +-
 .../operators/test_gcp_function_operator.py   |  36 +-
 .../test_gcp_function_operator_system.py      |  37 ++
 .../operators/test_gcp_spanner_operator.py    |  28 +-
 .../test_gcp_spanner_operator_system.py       |  46 ++
 ...test_gcp_spanner_operator_system_helper.py |  67 +++
 .../operators/test_gcp_sql_operator.py        | 248 +++------
 .../operators/test_gcp_sql_operator_system.py |  64 +++
 .../test_gcp_sql_operator_system_helper.py    | 477 ++++++++++++++++++
 .../test_gcp_sql_operatorquery_system.py      | 146 ++++++
 ...est_gcp_sql_operatorquery_system_helper.py |  59 +++
 .../operators/test_gcs_acl_operator.py        |  15 -
 .../operators/test_gcs_acl_operator_system.py |  36 ++
 .../test_s3_to_gcs_transfer_operator.py       |  14 +-
 .../utils/base_gcp_system_test_case.py        | 259 ++++++++++
 tests/contrib/utils/gcp_authenticator.py      | 209 ++++++++
 .../contrib/utils/logging_command_executor.py |  56 ++
 tests/contrib/utils/run_once_decorator.py     |  35 ++
 tests/dags/.gitignore                         |   1 -
 42 files changed, 2490 insertions(+), 1006 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_function.py
 delete mode 100644 airflow/contrib/example_dags/example_gcp_function_delete.py
 delete mode 100644 airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
 create mode 100644 tests/contrib/operators/postgres_local_executor.cfg
 delete mode 100644 tests/contrib/operators/test_gcp_base.py
 create mode 100644 tests/contrib/operators/test_gcp_bigtable_operator_system.py
 create mode 100755 tests/contrib/operators/test_gcp_bigtable_operator_system_helper.py
 create mode 100644 tests/contrib/operators/test_gcp_compute_operator_system.py
 create mode 100755 tests/contrib/operators/test_gcp_compute_operator_system_helper.py
 create mode 100644 tests/contrib/operators/test_gcp_function_operator_system.py
 create mode 100644 tests/contrib/operators/test_gcp_spanner_operator_system.py
 create mode 100755 tests/contrib/operators/test_gcp_spanner_operator_system_helper.py
 create mode 100644 tests/contrib/operators/test_gcp_sql_operator_system.py
 create mode 100755 tests/contrib/operators/test_gcp_sql_operator_system_helper.py
 create mode 100644 tests/contrib/operators/test_gcp_sql_operatorquery_system.py
 create mode 100755 tests/contrib/operators/test_gcp_sql_operatorquery_system_helper.py
 create mode 100644 tests/contrib/operators/test_gcs_acl_operator_system.py
 create mode 100644 tests/contrib/utils/base_gcp_system_test_case.py
 create mode 100644 tests/contrib/utils/gcp_authenticator.py
 create mode 100644 tests/contrib/utils/logging_command_executor.py
 create mode 100644 tests/contrib/utils/run_once_decorator.py

diff --git a/airflow/contrib/example_dags/example_gcp_bigtable_operators.py b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
index 48c4245cbafbb..4239f78004c60 100644
--- a/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+++ b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
@@ -44,8 +44,6 @@
 * CBT_POKE_INTERVAL - number of seconds between every attempt of Sensor check
 
 """
-
-import datetime
 import json
 
 from os import getenv
@@ -78,7 +76,7 @@
 with models.DAG(
     'example_gcp_bigtable_operators',
     default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
+    schedule_interval=None  # Override to match your needs
 ) as dag:
     # [START howto_operator_gcp_bigtable_instance_create]
     create_instance_task = BigtableInstanceCreateOperator(
@@ -128,6 +126,7 @@
         instance_id=CBT_INSTANCE_ID,
         table_id=CBT_TABLE_ID,
         poke_interval=int(CBT_POKE_INTERVAL),
+        timeout=180,
         task_id='wait_for_table_replication',
     )
     # [END howto_operator_gcp_bigtable_table_wait_for_replication]
diff --git a/airflow/contrib/example_dags/example_gcp_compute.py b/airflow/contrib/example_dags/example_gcp_compute.py
index 928e9744b62be..f0608e466ce05 100644
--- a/airflow/contrib/example_dags/example_gcp_compute.py
+++ b/airflow/contrib/example_dags/example_gcp_compute.py
@@ -23,14 +23,13 @@
 
 This DAG relies on the following OS environment variables
 
-* PROJECT_ID - Google Cloud Platform project where the Compute Engine instance exists.
-* ZONE - Google Cloud Platform zone where the instance exists.
-* INSTANCE - Name of the Compute Engine instance.
-* SHORT_MACHINE_TYPE_NAME - Machine type resource name to set, e.g. 'n1-standard-1'.
+* GCP_PROJECT_ID - Google Cloud Platform project where the Compute Engine instance exists.
+* GCE_ZONE - Google Cloud Platform zone where the instance exists.
+* GCE_INSTANCE - Name of the Compute Engine instance.
+* GCE_SHORT_MACHINE_TYPE_NAME - Machine type resource name to set, e.g. 'n1-standard-1'.
     See https://cloud.google.com/compute/docs/machine-types
 """
 import os
-import datetime
 
 import airflow
 from airflow import models
@@ -38,19 +37,19 @@
     GceInstanceStopOperator, GceSetMachineTypeOperator
 
 # [START howto_operator_gce_args_common]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-ZONE = os.environ.get('ZONE', 'europe-west1-b')
-INSTANCE = os.environ.get('INSTANCE', 'testinstance')
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCE_ZONE = os.environ.get('GCE_ZONE', 'europe-west1-b')
+GCE_INSTANCE = os.environ.get('GCE_INSTANCE', 'testinstance')
 # [END howto_operator_gce_args_common]
 
 default_args = {
-    'start_date': airflow.utils.dates.days_ago(1)
+    'start_date': airflow.utils.dates.days_ago(1),
 }
 
 # [START howto_operator_gce_args_set_machine_type]
-SHORT_MACHINE_TYPE_NAME = os.environ.get('SHORT_MACHINE_TYPE_NAME', 'n1-standard-1')
+GCE_SHORT_MACHINE_TYPE_NAME = os.environ.get('GCE_SHORT_MACHINE_TYPE_NAME', 'n1-standard-1')
 SET_MACHINE_TYPE_BODY = {
-    'machineType': 'zones/{}/machineTypes/{}'.format(ZONE, SHORT_MACHINE_TYPE_NAME)
+    'machineType': 'zones/{}/machineTypes/{}'.format(GCE_ZONE, GCE_SHORT_MACHINE_TYPE_NAME)
 }
 # [END howto_operator_gce_args_set_machine_type]
 
@@ -58,52 +57,52 @@
 with models.DAG(
     'example_gcp_compute',
     default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
+    schedule_interval=None  # Override to match your needs
 ) as dag:
     # [START howto_operator_gce_start]
     gce_instance_start = GceInstanceStartOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         task_id='gcp_compute_start_task'
     )
     # [END howto_operator_gce_start]
     # Duplicate start for idempotence testing
     gce_instance_start2 = GceInstanceStartOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         task_id='gcp_compute_start_task2'
     )
     # [START howto_operator_gce_stop]
     gce_instance_stop = GceInstanceStopOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         task_id='gcp_compute_stop_task'
     )
     # [END howto_operator_gce_stop]
     # Duplicate stop for idempotence testing
     gce_instance_stop2 = GceInstanceStopOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         task_id='gcp_compute_stop_task2'
     )
     # [START howto_operator_gce_set_machine_type]
     gce_set_machine_type = GceSetMachineTypeOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         body=SET_MACHINE_TYPE_BODY,
         task_id='gcp_compute_set_machine_type'
     )
     # [END howto_operator_gce_set_machine_type]
     # Duplicate set machine type for idempotence testing
     gce_set_machine_type2 = GceSetMachineTypeOperator(
-        project_id=PROJECT_ID,
-        zone=ZONE,
-        resource_id=INSTANCE,
+        project_id=GCP_PROJECT_ID,
+        zone=GCE_ZONE,
+        resource_id=GCE_INSTANCE,
         body=SET_MACHINE_TYPE_BODY,
         task_id='gcp_compute_set_machine_type2'
     )
diff --git a/airflow/contrib/example_dags/example_gcp_compute_igm.py b/airflow/contrib/example_dags/example_gcp_compute_igm.py
index 3e4543c60d8ee..400bc1afc1040 100644
--- a/airflow/contrib/example_dags/example_gcp_compute_igm.py
+++ b/airflow/contrib/example_dags/example_gcp_compute_igm.py
@@ -24,23 +24,22 @@
 
 This DAG relies on the following OS environment variables
 
-* PROJECT_ID - the Google Cloud Platform project where the Compute Engine instance exists
-* ZONE - the zone where the Compute Engine instance exists
+* GCP_PROJECT_ID - the Google Cloud Platform project where the Compute Engine instance exists
+* GCE_ZONE - the zone where the Compute Engine instance exists
 
 Variables for copy template operator:
-* TEMPLATE_NAME - name of the template to copy
-* NEW_TEMPLATE_NAME - name of the new template
-* NEW_DESCRIPTION - description added to the template
+* GCE_TEMPLATE_NAME - name of the template to copy
+* GCE_NEW_TEMPLATE_NAME - name of the new template
+* GCE_NEW_DESCRIPTION - description added to the template
 
 Variables for update template in Group Manager:
 
-* INSTANCE_GROUP_MANAGER_NAME - name of the Instance Group Manager
+* GCE_INSTANCE_GROUP_MANAGER_NAME - name of the Instance Group Manager
 * SOURCE_TEMPLATE_URL - url of the template to replace in the Instance Group Manager
 * DESTINATION_TEMPLATE_URL - url of the new template to set in the Instance Group Manager
 """
 
 import os
-import datetime
 
 import airflow
 from airflow import models
@@ -48,8 +47,8 @@
     GceInstanceTemplateCopyOperator, GceInstanceGroupManagerUpdateTemplateOperator
 
 # [START howto_operator_compute_igm_common_args]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-ZONE = os.environ.get('ZONE', 'europe-west1-b')
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCE_ZONE = os.environ.get('GCE_ZONE', 'europe-west1-b')
 # [END howto_operator_compute_igm_common_args]
 
 default_args = {
@@ -57,13 +56,13 @@
 }
 
 # [START howto_operator_compute_template_copy_args]
-TEMPLATE_NAME = os.environ.get('TEMPLATE_NAME', 'instance-template-test')
-NEW_TEMPLATE_NAME = os.environ.get('NEW_TEMPLATE_NAME',
-                                   'instance-template-test-new')
-NEW_DESCRIPTION = os.environ.get('NEW_DESCRIPTION', 'Test new description')
+GCE_TEMPLATE_NAME = os.environ.get('GCE_TEMPLATE_NAME', 'instance-template-test')
+GCE_NEW_TEMPLATE_NAME = os.environ.get('GCE_NEW_TEMPLATE_NAME',
+                                       'instance-template-test-new')
+GCE_NEW_DESCRIPTION = os.environ.get('GCE_NEW_DESCRIPTION', 'Test new description')
 GCE_INSTANCE_TEMPLATE_BODY_UPDATE = {
-    "name": NEW_TEMPLATE_NAME,
-    "description": NEW_DESCRIPTION,
+    "name": GCE_NEW_TEMPLATE_NAME,
+    "description": GCE_NEW_DESCRIPTION,
     "properties": {
         "machineType": "n1-standard-2"
     }
@@ -71,18 +70,18 @@
 # [END howto_operator_compute_template_copy_args]
 
 # [START howto_operator_compute_igm_update_template_args]
-INSTANCE_GROUP_MANAGER_NAME = os.environ.get('INSTANCE_GROUP_MANAGER_NAME',
-                                             'instance-group-test')
+GCE_INSTANCE_GROUP_MANAGER_NAME = os.environ.get('GCE_INSTANCE_GROUP_MANAGER_NAME',
+                                                 'instance-group-test')
 
 SOURCE_TEMPLATE_URL = os.environ.get(
     'SOURCE_TEMPLATE_URL',
-    "https://www.googleapis.com/compute/beta/projects/"
-    "example-project/global/instanceTemplates/instance-template-test")
+    "https://www.googleapis.com/compute/beta/projects/" + GCP_PROJECT_ID +
+    "/global/instanceTemplates/instance-template-test")
 
 DESTINATION_TEMPLATE_URL = os.environ.get(
     'DESTINATION_TEMPLATE_URL',
-    "https://www.googleapis.com/compute/beta/projects/"
-    "example-airflow/global/instanceTemplates/" + NEW_TEMPLATE_NAME)
+    "https://www.googleapis.com/compute/beta/projects/" + GCP_PROJECT_ID +
+    "/global/instanceTemplates/" + GCE_NEW_TEMPLATE_NAME)
 
 UPDATE_POLICY = {
     "type": "OPPORTUNISTIC",
@@ -99,29 +98,29 @@
 with models.DAG(
     'example_gcp_compute_igm',
     default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
+    schedule_interval=None  # Override to match your needs
 ) as dag:
     # [START howto_operator_gce_igm_copy_template]
     gce_instance_template_copy = GceInstanceTemplateCopyOperator(
-        project_id=PROJECT_ID,
-        resource_id=TEMPLATE_NAME,
+        project_id=GCP_PROJECT_ID,
+        resource_id=GCE_TEMPLATE_NAME,
         body_patch=GCE_INSTANCE_TEMPLATE_BODY_UPDATE,
         task_id='gcp_compute_igm_copy_template_task'
     )
     # [END howto_operator_gce_igm_copy_template]
     # Added to check for idempotence
     gce_instance_template_copy2 = GceInstanceTemplateCopyOperator(
-        project_id=PROJECT_ID,
-        resource_id=TEMPLATE_NAME,
+        project_id=GCP_PROJECT_ID,
+        resource_id=GCE_TEMPLATE_NAME,
         body_patch=GCE_INSTANCE_TEMPLATE_BODY_UPDATE,
         task_id='gcp_compute_igm_copy_template_task_2'
     )
     # [START howto_operator_gce_igm_update_template]
     gce_instance_group_manager_update_template = \
         GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            resource_id=INSTANCE_GROUP_MANAGER_NAME,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            zone=GCE_ZONE,
             source_template=SOURCE_TEMPLATE_URL,
             destination_template=DESTINATION_TEMPLATE_URL,
             update_policy=UPDATE_POLICY,
@@ -131,9 +130,9 @@
     # Added to check for idempotence (and without UPDATE_POLICY)
     gce_instance_group_manager_update_template2 = \
         GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            resource_id=INSTANCE_GROUP_MANAGER_NAME,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            zone=GCE_ZONE,
             source_template=SOURCE_TEMPLATE_URL,
             destination_template=DESTINATION_TEMPLATE_URL,
             task_id='gcp_compute_igm_group_manager_update_template_2'
diff --git a/airflow/contrib/example_dags/example_gcp_function.py b/airflow/contrib/example_dags/example_gcp_function.py
new file mode 100644
index 0000000000000..afd6d36aed2e3
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_function.py
@@ -0,0 +1,125 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that displays interactions with Google Cloud Functions.
+It creates a function and then deletes it.
+
+This DAG relies on the following OS environment variables
+https://airflow.apache.org/concepts.html#variables
+* GCP_PROJECT_ID - Google Cloud Project to use for the Cloud Function.
+* GCP_LOCATION - Google Cloud Functions region where the function should be
+  created.
+* GCF_ENTRYPOINT - Name of the executable function in the source code.
+* and one of the below:
+    - GCF_SOURCE_ARCHIVE_URL - Path to the zipped source in Google Cloud Storage
+    or
+    (
+        - GCF_SOURCE_UPLOAD_URL - Generated upload URL for the zipped source
+        and
+        - GCF_ZIP_PATH - Local path to the zipped source archive
+    )
+    or
+    - GCF_SOURCE_REPOSITORY - The URL pointing to the hosted repository where the function
+    is defined in a supported Cloud Source Repository URL format
+    https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#SourceRepository
+"""
+
+import os
+
+from airflow import models
+from airflow.contrib.operators.gcp_function_operator \
+    import GcfFunctionDeployOperator, GcfFunctionDeleteOperator
+from airflow.utils import dates
+
+# [START howto_operator_gcf_common_variables]
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_LOCATION = os.environ.get('GCP_LOCATION', 'europe-west1')
+GCF_SHORT_FUNCTION_NAME = os.environ.get('GCF_SHORT_FUNCTION_NAME', 'hello').\
+    replace("-", "_")  # make sure there are no dashes in function name (!)
+FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(GCP_PROJECT_ID,
+                                                               GCP_LOCATION,
+                                                               GCF_SHORT_FUNCTION_NAME)
+# [END howto_operator_gcf_common_variables]
+# [START howto_operator_gcf_deploy_variables]
+GCF_SOURCE_ARCHIVE_URL = os.environ.get('GCF_SOURCE_ARCHIVE_URL', '')
+GCF_SOURCE_UPLOAD_URL = os.environ.get('GCF_SOURCE_UPLOAD_URL', '')
+GCF_SOURCE_REPOSITORY = os.environ.get(
+    'GCF_SOURCE_REPOSITORY',
+    'https://source.developers.google.com/'
+    'projects/{}/repos/hello-world/moveable-aliases/master'.format(GCP_PROJECT_ID))
+GCF_ZIP_PATH = os.environ.get('GCF_ZIP_PATH', '')
+GCF_ENTRYPOINT = os.environ.get('GCF_ENTRYPOINT', 'helloWorld')
+GCF_RUNTIME = 'nodejs6'
+GCP_VALIDATE_BODY = os.environ.get('GCP_VALIDATE_BODY', True)
+# [END howto_operator_gcf_deploy_variables]
+
+# [START howto_operator_gcf_deploy_body]
+body = {
+    "name": FUNCTION_NAME,
+    "entryPoint": GCF_ENTRYPOINT,
+    "runtime": GCF_RUNTIME,
+    "httpsTrigger": {}
+}
+# [END howto_operator_gcf_deploy_body]
+
+# [START howto_operator_gcf_default_args]
+default_args = {
+    'start_date': dates.days_ago(1)
+}
+# [END howto_operator_gcf_default_args]
+
+# [START howto_operator_gcf_deploy_variants]
+if GCF_SOURCE_ARCHIVE_URL:
+    body['sourceArchiveUrl'] = GCF_SOURCE_ARCHIVE_URL
+elif GCF_SOURCE_REPOSITORY:
+    body['sourceRepository'] = {
+        'url': GCF_SOURCE_REPOSITORY
+    }
+elif GCF_ZIP_PATH:
+    body['sourceUploadUrl'] = ''
+    default_args['zip_path'] = GCF_ZIP_PATH
+elif GCF_SOURCE_UPLOAD_URL:
+    body['sourceUploadUrl'] = GCF_SOURCE_UPLOAD_URL
+else:
+    raise Exception("Please provide one of the source_code parameters")
+# [END howto_operator_gcf_deploy_variants]
+
+
+with models.DAG(
+    'example_gcp_function',
+    default_args=default_args,
+    schedule_interval=None  # Override to match your needs
+) as dag:
+    # [START howto_operator_gcf_deploy]
+    deploy_task = GcfFunctionDeployOperator(
+        task_id="gcf_deploy_task",
+        project_id=GCP_PROJECT_ID,
+        location=GCP_LOCATION,
+        body=body,
+        validate_body=GCP_VALIDATE_BODY
+    )
+    # [END howto_operator_gcf_deploy]
+    # [START howto_operator_gcf_delete]
+    delete_task = GcfFunctionDeleteOperator(
+        task_id="gcf_delete_task",
+        name=FUNCTION_NAME
+    )
+    # [END howto_operator_gcf_delete]
+    deploy_task >> delete_task
diff --git a/airflow/contrib/example_dags/example_gcp_function_delete.py b/airflow/contrib/example_dags/example_gcp_function_delete.py
deleted file mode 100644
index 642e3a744c253..0000000000000
--- a/airflow/contrib/example_dags/example_gcp_function_delete.py
+++ /dev/null
@@ -1,59 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-"""
-Example Airflow DAG that deletes a Google Cloud Function.
-This DAG relies on the following OS environment variables
-* PROJECT_ID - Google Cloud Project where the Cloud Function exists.
-* LOCATION - Google Cloud Functions region where the function exists.
-* ENTRYPOINT - Name of the executable function in the source code.
-"""
-
-import os
-import datetime
-
-import airflow
-from airflow import models
-from airflow.contrib.operators.gcp_function_operator import GcfFunctionDeleteOperator
-
-# [START howto_operator_gcf_delete_args]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-LOCATION = os.environ.get('LOCATION', 'europe-west1')
-ENTRYPOINT = os.environ.get('ENTRYPOINT', 'helloWorld')
-# A fully-qualified name of the function to delete
-
-FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
-                                                               ENTRYPOINT)
-# [END howto_operator_gcf_delete_args]
-
-default_args = {
-    'start_date': airflow.utils.dates.days_ago(1)
-}
-
-with models.DAG(
-    'example_gcp_function_delete',
-    default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
-) as dag:
-    # [START howto_operator_gcf_delete]
-    t1 = GcfFunctionDeleteOperator(
-        task_id="gcf_delete_task",
-        name=FUNCTION_NAME
-    )
-    # [END howto_operator_gcf_delete]
diff --git a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py b/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
deleted file mode 100644
index 76563d7596cd2..0000000000000
--- a/airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+++ /dev/null
@@ -1,117 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-"""
-Example Airflow DAG that creates a Google Cloud Function and then deletes it.
-
-This DAG relies on the following OS environment variables
-https://airflow.apache.org/concepts.html#variables
-* PROJECT_ID - Google Cloud Project to use for the Cloud Function.
-* LOCATION - Google Cloud Functions region where the function should be
-  created.
-* SOURCE_ARCHIVE_URL - Path to the zipped source in Google Cloud Storage
-or
-    * SOURCE_UPLOAD_URL - Generated upload URL for the zipped source
-    or
-    * ZIP_PATH - Local path to the zipped source archive
-or
-* SOURCE_REPOSITORY - The URL pointing to the hosted repository where the function is
-defined in a supported Cloud Source Repository URL format
-https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#SourceRepository
-* ENTRYPOINT - Name of the executable function in the source code.
-"""
-
-import os
-import datetime
-
-from airflow import models
-from airflow.contrib.operators.gcp_function_operator \
-    import GcfFunctionDeployOperator, GcfFunctionDeleteOperator
-from airflow.utils import dates
-
-# [START howto_operator_gcf_deploy_variables]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-LOCATION = os.environ.get('LOCATION', 'europe-west1')
-SOURCE_ARCHIVE_URL = os.environ.get('SOURCE_ARCHIVE_URL', '')
-SOURCE_UPLOAD_URL = os.environ.get('SOURCE_UPLOAD_URL', '')
-SOURCE_REPOSITORY = os.environ.get(
-    'SOURCE_REPOSITORY',
-    'https://source.developers.google.com/'
-    'projects/example-project/repos/hello-world/moveable-aliases/master')
-ZIP_PATH = os.environ.get('ZIP_PATH', '')
-ENTRYPOINT = os.environ.get('ENTRYPOINT', 'helloWorld')
-FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
-                                                               ENTRYPOINT)
-RUNTIME = 'nodejs6'
-VALIDATE_BODY = os.environ.get('VALIDATE_BODY', True)
-
-# [END howto_operator_gcf_deploy_variables]
-
-# [START howto_operator_gcf_deploy_body]
-body = {
-    "name": FUNCTION_NAME,
-    "entryPoint": ENTRYPOINT,
-    "runtime": RUNTIME,
-    "httpsTrigger": {}
-}
-# [END howto_operator_gcf_deploy_body]
-
-# [START howto_operator_gcf_default_args]
-default_args = {
-    'start_date': dates.days_ago(1)
-}
-# [END howto_operator_gcf_default_args]
-
-# [START howto_operator_gcf_deploy_variants]
-if SOURCE_ARCHIVE_URL:
-    body['sourceArchiveUrl'] = SOURCE_ARCHIVE_URL
-elif SOURCE_REPOSITORY:
-    body['sourceRepository'] = {
-        'url': SOURCE_REPOSITORY
-    }
-elif ZIP_PATH:
-    body['sourceUploadUrl'] = ''
-    default_args['zip_path'] = ZIP_PATH
-elif SOURCE_UPLOAD_URL:
-    body['sourceUploadUrl'] = SOURCE_UPLOAD_URL
-else:
-    raise Exception("Please provide one of the source_code parameters")
-# [END howto_operator_gcf_deploy_variants]
-
-
-with models.DAG(
-    'example_gcp_function_deploy_delete',
-    default_args=default_args,
-    schedule_interval=datetime.timedelta(days=1)
-) as dag:
-    # [START howto_operator_gcf_deploy]
-    deploy_task = GcfFunctionDeployOperator(
-        task_id="gcf_deploy_task",
-        name=FUNCTION_NAME,
-        project_id=PROJECT_ID,
-        location=LOCATION,
-        body=body,
-        validate_body=VALIDATE_BODY
-    )
-    # [END howto_operator_gcf_deploy]
-    delete_task = GcfFunctionDeleteOperator(
-        task_id="gcf_delete_task",
-        name=FUNCTION_NAME
-    )
-    deploy_task >> delete_task
diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
index 0aeb1e63a0bd8..f421451c8979b 100644
--- a/airflow/contrib/example_dags/example_gcp_spanner.py
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -39,7 +39,8 @@
 import airflow
 from airflow import models
 from airflow.contrib.operators.gcp_spanner_operator import \
-    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDatabaseQueryOperator, \
+    CloudSpannerInstanceDeployOperator, \
+    CloudSpannerInstanceDatabaseQueryOperator, \
     CloudSpannerInstanceDeleteOperator, \
     CloudSpannerInstanceDatabaseDeployOperator, \
     CloudSpannerInstanceDatabaseUpdateOperator, \
@@ -140,7 +141,7 @@
     spanner_instance_query_task = CloudSpannerInstanceDatabaseQueryOperator(
         project_id=GCP_PROJECT_ID,
         instance_id=GCP_SPANNER_INSTANCE_ID,
-        database_id='db1',
+        database_id=GCP_SPANNER_DATABASE_ID,
         query=["DELETE FROM my_table2 WHERE true"],
         task_id='spanner_instance_query'
     )
@@ -149,7 +150,7 @@
     spanner_instance_query2_task = CloudSpannerInstanceDatabaseQueryOperator(
         project_id=GCP_PROJECT_ID,
         instance_id=GCP_SPANNER_INSTANCE_ID,
-        database_id='db1',
+        database_id=GCP_SPANNER_DATABASE_ID,
         query="example_gcp_spanner.sql",
         task_id='spanner_instance_query2'
     )
diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index eaf1f7d404b0a..b663b4ecebe7f 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -23,7 +23,7 @@
 
 This DAG relies on the following OS environment variables
 https://airflow.apache.org/concepts.html#variables
-* PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance.
+* GCP_PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance.
 * INSTANCE_NAME - Name of the Cloud SQL instance.
 * DB_NAME - Name of the database inside a Cloud SQL instance.
 """
@@ -44,15 +44,15 @@
 from six.moves.urllib.parse import urlsplit
 
 # [START howto_operator_cloudsql_arguments]
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'test-mysql')
-INSTANCE_NAME2 = os.environ.get('INSTANCE_NAME2', 'test-mysql2')
-DB_NAME = os.environ.get('DB_NAME', 'testdb')
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+INSTANCE_NAME = os.environ.get('GCSQL_MYSQL_INSTANCE_NAME', 'test-mysql')
+INSTANCE_NAME2 = os.environ.get('GCSQL_MYSQL_INSTANCE_NAME2', 'test-mysql2')
+DB_NAME = os.environ.get('GCSQL_MYSQL_DATABASE_NAME', 'testdb')
 # [END howto_operator_cloudsql_arguments]
 
 # [START howto_operator_cloudsql_export_import_arguments]
-EXPORT_URI = os.environ.get('EXPORT_URI', 'gs://bucketName/fileName')
-IMPORT_URI = os.environ.get('IMPORT_URI', 'gs://bucketName/fileName')
+EXPORT_URI = os.environ.get('GCSQL_MYSQL_EXPORT_URI', 'gs://bucketName/fileName')
+IMPORT_URI = os.environ.get('GCSQL_MYSQL_IMPORT_URI', 'gs://bucketName/fileName')
 # [END howto_operator_cloudsql_export_import_arguments]
 
 # Bodies below represent Cloud SQL instance resources:
@@ -145,7 +145,7 @@
 db_create_body = {
     "instance": INSTANCE_NAME,
     "name": DB_NAME,
-    "project": PROJECT_ID
+    "project": GCP_PROJECT_ID
 }
 # [END howto_operator_cloudsql_db_create_body]
 # [START howto_operator_cloudsql_db_patch_body]
@@ -162,9 +162,8 @@
 with models.DAG(
     'example_gcp_sql',
     default_args=default_args,
-    schedule_interval=None
+    schedule_interval=None  # Override to match your needs
 ) as dag:
-    prev_task = None
 
     def next_dep(task, prev):
         prev >> task
@@ -176,7 +175,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_create]
     sql_instance_create_task = CloudSqlInstanceCreateOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=body,
         instance=INSTANCE_NAME,
         task_id='sql_instance_create_task'
@@ -185,7 +184,7 @@ def next_dep(task, prev):
     prev_task = sql_instance_create_task
 
     sql_instance_create_2_task = CloudSqlInstanceCreateOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=body2,
         instance=INSTANCE_NAME2,
         task_id='sql_instance_create_2_task'
@@ -198,7 +197,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_patch]
     sql_instance_patch_task = CloudSqlInstancePatchOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=patch_body,
         instance=INSTANCE_NAME,
         task_id='sql_instance_patch_task'
@@ -208,7 +207,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_db_create]
     sql_db_create_task = CloudSqlInstanceDatabaseCreateOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=db_create_body,
         instance=INSTANCE_NAME,
         task_id='sql_db_create_task'
@@ -218,7 +217,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_db_patch]
     sql_db_patch_task = CloudSqlInstanceDatabasePatchOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=db_patch_body,
         instance=INSTANCE_NAME,
         database=DB_NAME,
@@ -236,7 +235,9 @@ def next_dep(task, prev):
     # write access to the destination GCS bucket.
     # [START howto_operator_cloudsql_export_gcs_permissions]
     sql_gcp_add_bucket_permission_task = GoogleCloudStorageBucketCreateAclEntryOperator(
-        entity="user-{{ task_instance.xcom_pull('sql_instance_create_task', key='service_account_email') }}",
+        entity="user-{{ task_instance.xcom_pull("
+               "'sql_instance_create_task', key='service_account_email') "
+               "}}",
         role="WRITER",
         bucket=export_url_split[1],  # netloc (bucket)
         task_id='sql_gcp_add_bucket_permission_task'
@@ -246,7 +247,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_export]
     sql_export_task = CloudSqlInstanceExportOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=export_body,
         instance=INSTANCE_NAME,
         task_id='sql_export_task'
@@ -263,8 +264,9 @@ def next_dep(task, prev):
     # read access to the target GCS object.
     # [START howto_operator_cloudsql_import_gcs_permissions]
     sql_gcp_add_object_permission_task = GoogleCloudStorageObjectCreateAclEntryOperator(
-        entity="user-{{ task_instance.xcom_pull('sql_instance_create_2_task', "
-               "key='service_account_email') }}",
+        entity="user-{{ task_instance.xcom_pull("
+               "'sql_instance_create_2_task', key='service_account_email')"
+               " }}",
         role="READER",
         bucket=import_url_split[1],  # netloc (bucket)
         object_name=import_url_split[2][1:],  # path (strip first '/')
@@ -287,7 +289,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_import]
     sql_import_task = CloudSqlInstanceImportOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         body=import_body,
         instance=INSTANCE_NAME2,
         task_id='sql_import_task'
@@ -301,7 +303,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_db_delete]
     sql_db_delete_task = CloudSqlInstanceDatabaseDeleteOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         instance=INSTANCE_NAME,
         database=DB_NAME,
         task_id='sql_db_delete_task'
@@ -315,7 +317,7 @@ def next_dep(task, prev):
 
     # [START howto_operator_cloudsql_delete]
     sql_instance_delete_task = CloudSqlInstanceDeleteOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         instance=INSTANCE_NAME,
         task_id='sql_instance_delete_task'
     )
@@ -323,7 +325,7 @@ def next_dep(task, prev):
     prev_task = next_dep(sql_instance_delete_task, prev_task)
 
     sql_instance_delete_2_task = CloudSqlInstanceDeleteOperator(
-        project_id=PROJECT_ID,
+        project_id=GCP_PROJECT_ID,
         instance=INSTANCE_NAME2,
         task_id='sql_instance_delete_2_task'
     )
diff --git a/airflow/contrib/example_dags/example_gcp_sql_query.py b/airflow/contrib/example_dags/example_gcp_sql_query.py
index 5439fb6afc7e8..b830417d9c54a 100644
--- a/airflow/contrib/example_dags/example_gcp_sql_query.py
+++ b/airflow/contrib/example_dags/example_gcp_sql_query.py
@@ -22,26 +22,25 @@
 
 This DAG relies on the following OS environment variables
 
-* PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance
-* LOCATION - Google Cloud location where the database is created
+* GCP_PROJECT_ID - Google Cloud Platform project for the Cloud SQL instance
+* GCP_REGION - Google Cloud region where the database is created
 *
-* POSTGRES_INSTANCE_NAME - Name of the postgres Cloud SQL instance
-* POSTGRES_USER - Name of the postgres database user
-* POSTGRES_PASSWORD - Password of the postgres database user
-* POSTGRES_PROXY_PORT - Local port number for proxy connections for postgres
-* POSTGRES_PUBLIC_IP - Public IP of the Postgres database
-* POSTGRES_PUBLIC_PORT - Port of the postgres database
+* GCSQL_POSTGRES_INSTANCE_NAME - Name of the postgres Cloud SQL instance
+* GCSQL_POSTGRES_USER - Name of the postgres database user
+* GCSQL_POSTGRES_PASSWORD - Password of the postgres database user
+* GCSQL_POSTGRES_PUBLIC_IP - Public IP of the Postgres database
+* GCSQL_POSTGRES_PUBLIC_PORT - Port of the postgres database
 *
-* MYSQL_INSTANCE_NAME - Name of the postgres Cloud SQL instance
-* MYSQL_USER - Name of the mysql database user
-* MYSQL_PASSWORD - Password of the mysql database user
-* MYSQL_PROXY_PORT - Local port number for proxy connections for mysql
-* MYSQL_PUBLIC_IP - Public IP of the mysql database
-* MYSQL_PUBLIC_PORT - Port of the mysql database
+* GCSQL_MYSQL_INSTANCE_NAME - Name of the postgres Cloud SQL instance
+* GCSQL_MYSQL_USER - Name of the mysql database user
+* GCSQL_MYSQL_PASSWORD - Password of the mysql database user
+* GCSQL_MYSQL_PUBLIC_IP - Public IP of the mysql database
+* GCSQL_MYSQL_PUBLIC_PORT - Port of the mysql database
 """
 
 import os
 import subprocess
+from os.path import expanduser
 
 from six.moves.urllib.parse import quote_plus
 
@@ -51,34 +50,38 @@
 
 # [START howto_operator_cloudsql_query_arguments]
 
-PROJECT_ID = os.environ.get('PROJECT_ID', 'example-project')
-LOCATION = os.environ.get('REGION', 'europe-west-1')
-
-POSTGRES_INSTANCE_NAME = os.environ.get('POSTGRES_INSTANCE_NAME', 'testpostgres')
-POSTGRES_DATABASE_NAME = os.environ.get('POSTGRES_DATABASE_NAME', 'postgresdb')
-POSTGRES_USER = os.environ.get('POSTGRES_USER', 'postgres_user')
-POSTGRES_PASSWORD = os.environ.get('POSTGRES_PASSWORD', 'password')
-POSTGRES_PUBLIC_IP = os.environ.get('POSTGRES_PUBLIC_IP', '0.0.0.0')
-POSTGRES_PUBLIC_PORT = os.environ.get('POSTGRES_PUBLIC_PORT', 5432)
-POSTGRES_CLIENT_CERT_FILE = os.environ.get('POSTGRES_CLIENT_CERT_FILE',
-                                           "/tmp/client-cert.pem")
-POSTGRES_CLIENT_KEY_FILE = os.environ.get('POSTGRES_CLIENT_KEY_FILE',
-                                          "/tmp/client-key.pem")
-POSTGRES_SERVER_CA_FILE = os.environ.get('POSTGRES_SERVER_CA_FILE',
-                                         "/tmp/server-ca.pem")
-
-MYSQL_INSTANCE_NAME = os.environ.get('MYSQL_INSTANCE_NAME', 'testmysql')
-MYSQL_DATABASE_NAME = os.environ.get('MYSQL_DATABASE_NAME', 'mysqldb')
-MYSQL_USER = os.environ.get('MYSQL_USER', 'mysql_user')
-MYSQL_PASSWORD = os.environ.get('MYSQL_PASSWORD', 'password')
-MYSQL_PUBLIC_IP = os.environ.get('MYSQL_PUBLIC_IP', '0.0.0.0')
-MYSQL_PUBLIC_PORT = os.environ.get('MYSQL_PUBLIC_PORT', 3306)
-MYSQL_CLIENT_CERT_FILE = os.environ.get('MYSQL_CLIENT_CERT_FILE',
-                                        "/tmp/client-cert.pem")
-MYSQL_CLIENT_KEY_FILE = os.environ.get('MYSQL_CLIENT_KEY_FILE',
-                                       "/tmp/client-key.pem")
-MYSQL_SERVER_CA_FILE = os.environ.get('MYSQL_SERVER_CA_FILE',
-                                      "/tmp/server-ca.pem")
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_REGION = os.environ.get('GCP_REGION', 'europe-west-1b')
+
+GCSQL_POSTGRES_INSTANCE_NAME_QUERY = os.environ.get(
+    'GCSQL_POSTGRES_INSTANCE_NAME_QUERY',
+    'testpostgres')
+GCSQL_POSTGRES_DATABASE_NAME = os.environ.get('GCSQL_POSTGRES_DATABASE_NAME',
+                                              'postgresdb')
+GCSQL_POSTGRES_USER = os.environ.get('GCSQL_POSTGRES_USER', 'postgres_user')
+GCSQL_POSTGRES_PASSWORD = os.environ.get('GCSQL_POSTGRES_PASSWORD', 'password')
+GCSQL_POSTGRES_PUBLIC_IP = os.environ.get('GCSQL_POSTGRES_PUBLIC_IP', '0.0.0.0')
+GCSQL_POSTGRES_PUBLIC_PORT = os.environ.get('GCSQL_POSTGRES_PUBLIC_PORT', 5432)
+GCSQL_POSTGRES_CLIENT_CERT_FILE = os.environ.get('GCSQL_POSTGRES_CLIENT_CERT_FILE',
+                                                 ".key/postgres-client-cert.pem")
+GCSQL_POSTGRES_CLIENT_KEY_FILE = os.environ.get('GCSQL_POSTGRES_CLIENT_KEY_FILE',
+                                                ".key/postgres-client-key.pem")
+GCSQL_POSTGRES_SERVER_CA_FILE = os.environ.get('GCSQL_POSTGRES_SERVER_CA_FILE',
+                                               ".key/postgres-server-ca.pem")
+
+GCSQL_MYSQL_INSTANCE_NAME_QUERY = os.environ.get('GCSQL_MYSQL_INSTANCE_NAME_QUERY',
+                                                 'testmysql')
+GCSQL_MYSQL_DATABASE_NAME = os.environ.get('GCSQL_MYSQL_DATABASE_NAME', 'mysqldb')
+GCSQL_MYSQL_USER = os.environ.get('GCSQL_MYSQL_USER', 'mysql_user')
+GCSQL_MYSQL_PASSWORD = os.environ.get('GCSQL_MYSQL_PASSWORD', 'password')
+GCSQL_MYSQL_PUBLIC_IP = os.environ.get('GCSQL_MYSQL_PUBLIC_IP', '0.0.0.0')
+GCSQL_MYSQL_PUBLIC_PORT = os.environ.get('GCSQL_MYSQL_PUBLIC_PORT', 3306)
+GCSQL_MYSQL_CLIENT_CERT_FILE = os.environ.get('GCSQL_MYSQL_CLIENT_CERT_FILE',
+                                              ".key/mysql-client-cert.pem")
+GCSQL_MYSQL_CLIENT_KEY_FILE = os.environ.get('GCSQL_MYSQL_CLIENT_KEY_FILE',
+                                             ".key/mysql-client-key.pem")
+GCSQL_MYSQL_SERVER_CA_FILE = os.environ.get('GCSQL_MYSQL_SERVER_CA_FILE',
+                                            ".key/mysql-server-ca.pem")
 
 SQL = [
     'CREATE TABLE IF NOT EXISTS TABLE_TEST (I INTEGER)',
@@ -97,18 +100,28 @@
 
 # [START howto_operator_cloudsql_query_connections]
 
+HOME_DIR = expanduser("~")
+
+
+def get_absolute_path(path):
+    if path.startswith("/"):
+        return path
+    else:
+        return os.path.join(HOME_DIR, path)
+
+
 postgres_kwargs = dict(
-    user=quote_plus(POSTGRES_USER),
-    password=quote_plus(POSTGRES_PASSWORD),
-    public_port=POSTGRES_PUBLIC_PORT,
-    public_ip=quote_plus(POSTGRES_PUBLIC_IP),
-    project_id=quote_plus(PROJECT_ID),
-    location=quote_plus(LOCATION),
-    instance=quote_plus(POSTGRES_INSTANCE_NAME),
-    database=quote_plus(POSTGRES_DATABASE_NAME),
-    client_cert_file=quote_plus(POSTGRES_CLIENT_CERT_FILE),
-    client_key_file=quote_plus(POSTGRES_CLIENT_KEY_FILE),
-    server_ca_file=quote_plus(POSTGRES_SERVER_CA_FILE)
+    user=quote_plus(GCSQL_POSTGRES_USER),
+    password=quote_plus(GCSQL_POSTGRES_PASSWORD),
+    public_port=GCSQL_POSTGRES_PUBLIC_PORT,
+    public_ip=quote_plus(GCSQL_POSTGRES_PUBLIC_IP),
+    project_id=quote_plus(GCP_PROJECT_ID),
+    location=quote_plus(GCP_REGION),
+    instance=quote_plus(GCSQL_POSTGRES_INSTANCE_NAME_QUERY),
+    database=quote_plus(GCSQL_POSTGRES_DATABASE_NAME),
+    client_cert_file=quote_plus(get_absolute_path(GCSQL_POSTGRES_CLIENT_CERT_FILE)),
+    client_key_file=quote_plus(get_absolute_path(GCSQL_POSTGRES_CLIENT_KEY_FILE)),
+    server_ca_file=quote_plus(get_absolute_path(GCSQL_POSTGRES_SERVER_CA_FILE))
 )
 
 # The connections below are created using one of the standard approaches - via environment
@@ -161,17 +174,17 @@
     .format(**postgres_kwargs)
 
 mysql_kwargs = dict(
-    user=quote_plus(MYSQL_USER),
-    password=quote_plus(MYSQL_PASSWORD),
-    public_port=MYSQL_PUBLIC_PORT,
-    public_ip=quote_plus(MYSQL_PUBLIC_IP),
-    project_id=quote_plus(PROJECT_ID),
-    location=quote_plus(LOCATION),
-    instance=quote_plus(MYSQL_INSTANCE_NAME),
-    database=quote_plus(MYSQL_DATABASE_NAME),
-    client_cert_file=quote_plus(MYSQL_CLIENT_CERT_FILE),
-    client_key_file=quote_plus(MYSQL_CLIENT_KEY_FILE),
-    server_ca_file=quote_plus(MYSQL_SERVER_CA_FILE)
+    user=quote_plus(GCSQL_MYSQL_USER),
+    password=quote_plus(GCSQL_MYSQL_PASSWORD),
+    public_port=GCSQL_MYSQL_PUBLIC_PORT,
+    public_ip=quote_plus(GCSQL_MYSQL_PUBLIC_IP),
+    project_id=quote_plus(GCP_PROJECT_ID),
+    location=quote_plus(GCP_REGION),
+    instance=quote_plus(GCSQL_MYSQL_INSTANCE_NAME_QUERY),
+    database=quote_plus(GCSQL_MYSQL_DATABASE_NAME),
+    client_cert_file=quote_plus(get_absolute_path(GCSQL_MYSQL_CLIENT_CERT_FILE)),
+    client_key_file=quote_plus(get_absolute_path(GCSQL_MYSQL_CLIENT_KEY_FILE)),
+    server_ca_file=quote_plus(get_absolute_path(GCSQL_MYSQL_SERVER_CA_FILE))
 )
 
 # MySQL: connect via proxy over TCP (specific proxy version)
@@ -243,17 +256,23 @@
 
 tasks = []
 
+
 with models.DAG(
     dag_id='example_gcp_sql_query',
     default_args=default_args,
     schedule_interval=None
 ) as dag:
+    prev_task = None
+
     for connection_name in connection_names:
-        tasks.append(
-            CloudSqlQueryOperator(
-                gcp_cloudsql_conn_id=connection_name,
-                task_id="example_gcp_sql_task_" + connection_name,
-                sql=SQL
-            )
+        task = CloudSqlQueryOperator(
+            gcp_cloudsql_conn_id=connection_name,
+            task_id="example_gcp_sql_task_" + connection_name,
+            sql=SQL
         )
+        tasks.append(task)
+        if prev_task:
+            prev_task >> task
+        prev_task = task
+
 # [END howto_operator_cloudsql_query_operators]
diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
index 29cef1716c327..7f1b395d677f6 100644
--- a/airflow/contrib/hooks/gcp_function_hook.py
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -71,26 +71,12 @@ def get_function(self, name):
         return self.get_conn().projects().locations().functions().get(
             name=name).execute(num_retries=NUM_RETRIES)
 
-    def list_functions(self, full_location):
-        """
-        Lists all Cloud Functions created in the location.
-
-        :param full_location: full location including the project in the form of
-            of /projects/<PROJECT>/location/<LOCATION>
-        :type full_location: str
-        :return: array of Cloud Functions objects - representing functions in the location
-        :rtype: [dict]
-        """
-        list_response = self.get_conn().projects().locations().functions().list(
-            parent=full_location).execute(num_retries=NUM_RETRIES)
-        return list_response.get("functions", [])
-
     def create_new_function(self, full_location, body):
         """
         Creates a new function in Cloud Function in the location specified in the body.
 
         :param full_location: full location including the project in the form of
-            of /projects/<PROJECT>/location/<LOCATION>
+            of /projects/<PROJECT>/location/<GCP_LOCATION>
         :type full_location: str
         :param body: body required by the Cloud Functions insert API
         :type body: dict
@@ -130,7 +116,7 @@ def upload_function_zip(self, parent, zip_path):
         Uploads zip file with sources.
 
         :param parent: Google Cloud Platform project id and region where zip file should
-         be uploaded in the form of /projects/<PROJECT>/location/<LOCATION>
+            be uploaded in the form of /projects/<PROJECT>/location/<GCP_LOCATION>
         :type parent: str
         :param zip_path: path of the valid .zip file to upload
         :type zip_path: str
@@ -143,7 +129,7 @@ def upload_function_zip(self, parent, zip_path):
         with open(zip_path, 'rb') as fp:
             requests.put(
                 url=upload_url,
-                data=fp.read(),
+                data=fp,
                 # Those two headers needs to be specified according to:
                 # https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/generateUploadUrl
                 # nopep8
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index 7f7da1d3ec5eb..811dab7a157b2 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -81,8 +81,9 @@ def _validate_max_instances(value):
 class GcfFunctionDeployOperator(BaseOperator):
     """
     Creates a function in Google Cloud Functions.
+    If a function with this name already exists, it will be updated.
 
-    :param project_id: Google Cloud Platform Project ID where the function should
+    :param project_id: Google Cloud Platform project ID where the function should
         be created.
     :type project_id: str
     :param location: Google Cloud Platform region where the function should be created.
@@ -105,9 +106,9 @@ class GcfFunctionDeployOperator(BaseOperator):
     :param validate_body: If set to False, body validation is not performed.
     :type validate_body: bool
     """
-    # [START gce_function_deploy_template_operator_template_fields]
+    # [START gcf_function_deploy_template_fields]
     template_fields = ('project_id', 'location', 'gcp_conn_id', 'api_version')
-    # [END gce_function_deploy_template_operator_template_fields]
+    # [END gcf_function_deploy_template_fields]
 
     @apply_defaults
     def __init__(self,
@@ -181,7 +182,7 @@ def _set_airflow_version_label(self):
 
     def execute(self, context):
         if self.zip_path_preprocessor.should_upload_function():
-            self.body[SOURCE_UPLOAD_URL] = self._upload_source_code()
+            self.body[GCF_SOURCE_UPLOAD_URL] = self._upload_source_code()
         self._validate_all_body_fields()
         self._set_airflow_version_label()
         if not self._check_if_function_exists():
@@ -190,10 +191,10 @@ def execute(self, context):
             self._update_function()
 
 
-SOURCE_ARCHIVE_URL = 'sourceArchiveUrl'
-SOURCE_UPLOAD_URL = 'sourceUploadUrl'
+GCF_SOURCE_ARCHIVE_URL = 'sourceArchiveUrl'
+GCF_SOURCE_UPLOAD_URL = 'sourceUploadUrl'
 SOURCE_REPOSITORY = 'sourceRepository'
-ZIP_PATH = 'zip_path'
+GCF_ZIP_PATH = 'zip_path'
 
 
 class ZipPathPreprocessor:
@@ -226,28 +227,28 @@ def _is_present_and_empty(dictionary, field):
         return field in dictionary and not dictionary[field]
 
     def _verify_upload_url_and_no_zip_path(self):
-        if self._is_present_and_empty(self.body, SOURCE_UPLOAD_URL):
+        if self._is_present_and_empty(self.body, GCF_SOURCE_UPLOAD_URL):
             if not self.zip_path:
                 raise AirflowException(
                     "Parameter '{}' is empty in the body and argument '{}' "
                     "is missing or empty. You need to have non empty '{}' "
                     "when '{}' is present and empty.".
-                    format(SOURCE_UPLOAD_URL, ZIP_PATH, ZIP_PATH, SOURCE_UPLOAD_URL))
+                    format(GCF_SOURCE_UPLOAD_URL, GCF_ZIP_PATH, GCF_ZIP_PATH, GCF_SOURCE_UPLOAD_URL))
 
     def _verify_upload_url_and_zip_path(self):
-        if SOURCE_UPLOAD_URL in self.body and self.zip_path:
-            if not self.body[SOURCE_UPLOAD_URL]:
+        if GCF_SOURCE_UPLOAD_URL in self.body and self.zip_path:
+            if not self.body[GCF_SOURCE_UPLOAD_URL]:
                 self.upload_function = True
             else:
                 raise AirflowException("Only one of '{}' in body or '{}' argument "
                                        "allowed. Found both."
-                                       .format(SOURCE_UPLOAD_URL, ZIP_PATH))
+                                       .format(GCF_SOURCE_UPLOAD_URL, GCF_ZIP_PATH))
 
     def _verify_archive_url_and_zip_path(self):
-        if SOURCE_ARCHIVE_URL in self.body and self.zip_path:
+        if GCF_SOURCE_ARCHIVE_URL in self.body and self.zip_path:
             raise AirflowException("Only one of '{}' in body or '{}' argument "
                                    "allowed. Found both."
-                                   .format(SOURCE_ARCHIVE_URL, ZIP_PATH))
+                                   .format(GCF_SOURCE_ARCHIVE_URL, GCF_ZIP_PATH))
 
     def should_upload_function(self):
         if self.upload_function is None:
@@ -279,9 +280,9 @@ class GcfFunctionDeleteOperator(BaseOperator):
     :param api_version: API version used (for example v1 or v1beta1).
     :type api_version: str
     """
-    # [START gce_function_delete_template_operator_template_fields]
+    # [START gcf_function_delete_template_fields]
     template_fields = ('name', 'gcp_conn_id', 'api_version')
-    # [END gce_function_delete_template_operator_template_fields]
+    # [END gcf_function_delete_template_fields]
 
     @apply_defaults
     def __init__(self,
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 2aa57831bf7a8..404bd0e6578d3 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -507,15 +507,15 @@ Arguments
 The following examples of OS environment variables show how you can build function name
 to use in the operator:
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
-    :start-after: [START howto_operator_gcf_delete_args]
-    :end-before: [END howto_operator_gcf_delete_args]
+    :start-after: [START howto_operator_gcf_common_variables]
+    :end-before: [END howto_operator_gcf_common_variables]
 
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcf_delete]
@@ -527,33 +527,8 @@ Templating
 .. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START gce_function_delete_template_operator_template_fields]
-    :end-before: [END gce_function_delete_template_operator_template_fields]
-
-Troubleshooting
-"""""""""""""""
-If you want to run or deploy an operator using a service account and get “forbidden 403”
-errors, it means that your service account does not have the correct
-Cloud IAM permissions.
-
-1. Assign your Service Account the Cloud Functions Developer role.
-2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
-   service account.
-
-The typical way of assigning Cloud IAM permissions with `gcloud` is
-shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
-and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
-
-.. code-block:: bash
-
-  gcloud iam service-accounts add-iam-policy-binding \
-    PROJECT_ID@appspot.gserviceaccount.com \
-    --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
-    --role="roles/iam.serviceAccountUser"
-
-
-See `Adding the IAM service agent user role to the runtime service
-<https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_.
+    :start-after: [START gcf_function_delete_template_fields]
+    :end-before: [END gcf_function_delete_template_fields]
 
 More information
 """"""""""""""""
@@ -565,6 +540,7 @@ GcfFunctionDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Use the operator to deploy a function to Google Cloud Functions.
+If a function with this name already exists, it will be updated.
 
 For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`.
@@ -573,55 +549,61 @@ For parameter definition, take a look at
 Arguments
 """""""""
 
-The following examples of OS environment variables show several variants of args you can
-use with the operator:
+In the example DAG the following environment variables are used to parameterize the
+operator's definition:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_common_variables]
+    :end-before: [END howto_operator_gcf_common_variables]
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_variables]
     :end-before: [END howto_operator_gcf_deploy_variables]
 
-With those variables you can define the body of the request:
+Some of those variables are used to create the request's body:
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_body]
     :end-before: [END howto_operator_gcf_deploy_body]
 
-When you create a DAG, the default_args dictionary can be used to pass
+When a DAG is created, the default_args dictionary can be used to pass
 arguments common with other tasks:
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_default_args]
     :end-before: [END howto_operator_gcf_default_args]
 
 Note that the neither the body nor the default args are complete in the above examples.
 Depending on the variables set, there might be different variants on how to pass source
-code related fields. Currently, you can pass either sourceArchiveUrl, sourceRepository
-or sourceUploadUrl as described in the
+code related fields. Currently, you can pass either ``sourceArchiveUrl``,
+``sourceRepository`` or ``sourceUploadUrl`` as described in the
 `Cloud Functions API specification
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
 
-Additionally, default_args or direct operator args might contain zip_path parameter
+Additionally, ``default_args`` or direct operator args might contain ``zip_path``
+parameter
 to run the extra step of uploading the source code before deploying it.
-In this case, you also need to provide an empty `sourceUploadUrl`
+In this case, you also need to provide an empty ``sourceUploadUrl``
 parameter in the body.
 
 Using the operator
 """"""""""""""""""
 
-Based on the variables defined above, example logic of setting the source code
-related fields is shown here:
+Depending on the combination of parameters, the Function's source code can be obtained
+from different sources:
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_variants]
     :end-before: [END howto_operator_gcf_deploy_variants]
 
 The code to create the operator:
 
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function_deploy_delete.py
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcf_deploy]
@@ -633,16 +615,20 @@ Templating
 .. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START gce_function_deploy_template_operator_template_fields]
-    :end-before: [END gce_function_deploy_template_operator_template_fields]
+    :start-after: [START gcf_function_deploy_template_fields]
+    :end-before: [END gcf_function_deploy_template_fields]
 
 
 Troubleshooting
 """""""""""""""
 
-If you want to run or deploy an operator using a service account and get “forbidden 403”
-errors, it means that your service account does not have the correct
-Cloud IAM permissions.
+If during the deploy you see an error similar to:
+
+`"HttpError 403: Missing necessary permission iam.serviceAccounts.actAs for on resource
+project-name@appspot.gserviceaccount.com. Please grant the
+roles/iam.serviceAccountUser role."`
+
+it means that your service account does not have the correct Cloud IAM permissions.
 
 1. Assign your Service Account the Cloud Functions Developer role.
 2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
@@ -659,7 +645,9 @@ and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
     --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
     --role="roles/iam.serviceAccountUser"
 
-See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details
+You can also do that via the GCP Web console.
+
+See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details.
 
 If the source code for your function is in Google Source Repository, make sure that
 your service account has the Source Repository Viewer role so that the source code
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index f4a21da7fc311..dfcc98cb5cc85 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -26,13 +26,13 @@
 
 TASK_ID = 'test-gke-cluster-operator'
 CLUSTER_NAME = 'test-cluster'
-TEST_PROJECT_ID = 'test-project'
-ZONE = 'test-zone'
+TEST_GCP_PROJECT_ID = 'test-project'
+GKE_ZONE = 'test-zone'
 
 
 class GKEClusterHookDeleteTest(unittest.TestCase):
     def setUp(self):
-        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook = GKEClusterHook(location=GKE_ZONE)
         self.gke_hook._client = mock.Mock()
 
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
@@ -43,12 +43,15 @@ def test_delete_cluster(self, wait_mock, convert_mock):
 
         client_delete = self.gke_hook._client.delete_cluster = mock.Mock()
 
-        self.gke_hook.delete_cluster(name=CLUSTER_NAME, project_id=TEST_PROJECT_ID, retry=retry_mock,
+        self.gke_hook.delete_cluster(name=CLUSTER_NAME, project_id=TEST_GCP_PROJECT_ID,
+                                     retry=retry_mock,
                                      timeout=timeout_mock)
 
-        client_delete.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
+        client_delete.assert_called_with(project_id=TEST_GCP_PROJECT_ID,
+                                         zone=GKE_ZONE,
                                          cluster_id=CLUSTER_NAME,
-                                         retry=retry_mock, timeout=timeout_mock)
+                                         retry=retry_mock,
+                                         timeout=timeout_mock)
         wait_mock.assert_called_with(client_delete.return_value)
         convert_mock.assert_not_called()
 
@@ -63,7 +66,7 @@ def test_delete_cluster_not_found(self, wait_mock, convert_mock, log_mock):
         message = 'Not Found'
         self.gke_hook._client.delete_cluster.side_effect = NotFound(message=message)
 
-        self.gke_hook.delete_cluster(None)
+        self.gke_hook.delete_cluster('not-existing')
         wait_mock.assert_not_called()
         convert_mock.assert_not_called()
         log_mock.info.assert_any_call("Assuming Success: " + message)
@@ -76,14 +79,14 @@ def test_delete_cluster_error(self, wait_mock, convert_mock):
         self.gke_hook._client.delete_cluster.side_effect = AirflowException('400')
 
         with self.assertRaises(AirflowException):
-            self.gke_hook.delete_cluster(None)
+            self.gke_hook.delete_cluster('a-cluster')
             wait_mock.assert_not_called()
             convert_mock.assert_not_called()
 
 
 class GKEClusterHookCreateTest(unittest.TestCase):
     def setUp(self):
-        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook = GKEClusterHook(location=GKE_ZONE)
         self.gke_hook._client = mock.Mock()
 
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
@@ -99,10 +102,13 @@ def test_create_cluster_proto(self, wait_mock, convert_mock):
 
         client_create = self.gke_hook._client.create_cluster = mock.Mock()
 
-        self.gke_hook.create_cluster(mock_cluster_proto, project_id=TEST_PROJECT_ID, retry=retry_mock,
+        self.gke_hook.create_cluster(mock_cluster_proto,
+                                     project_id=TEST_GCP_PROJECT_ID,
+                                     retry=retry_mock,
                                      timeout=timeout_mock)
 
-        client_create.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
+        client_create.assert_called_with(project_id=TEST_GCP_PROJECT_ID,
+                                         zone=GKE_ZONE,
                                          cluster=mock_cluster_proto,
                                          retry=retry_mock, timeout=timeout_mock)
         wait_mock.assert_called_with(client_create.return_value)
@@ -118,10 +124,13 @@ def test_create_cluster_dict(self, wait_mock, convert_mock):
         client_create = self.gke_hook._client.create_cluster = mock.Mock()
         proto_mock = convert_mock.return_value = mock.Mock()
 
-        self.gke_hook.create_cluster(mock_cluster_dict, project_id=TEST_PROJECT_ID, retry=retry_mock,
+        self.gke_hook.create_cluster(mock_cluster_dict,
+                                     project_id=TEST_GCP_PROJECT_ID,
+                                     retry=retry_mock,
                                      timeout=timeout_mock)
 
-        client_create.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
+        client_create.assert_called_with(project_id=TEST_GCP_PROJECT_ID,
+                                         zone=GKE_ZONE,
                                          cluster=proto_mock,
                                          retry=retry_mock, timeout=timeout_mock)
         wait_mock.assert_called_with(client_create.return_value)
@@ -158,7 +167,7 @@ def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
 
 class GKEClusterHookGetTest(unittest.TestCase):
     def setUp(self):
-        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook = GKEClusterHook(location=GKE_ZONE)
         self.gke_hook._client = mock.Mock()
 
     def test_get_cluster(self):
@@ -166,10 +175,13 @@ def test_get_cluster(self):
 
         client_get = self.gke_hook._client.get_cluster = mock.Mock()
 
-        self.gke_hook.get_cluster(name=CLUSTER_NAME, project_id=TEST_PROJECT_ID, retry=retry_mock,
+        self.gke_hook.get_cluster(name=CLUSTER_NAME,
+                                  project_id=TEST_GCP_PROJECT_ID,
+                                  retry=retry_mock,
                                   timeout=timeout_mock)
 
-        client_get.assert_called_with(project_id=TEST_PROJECT_ID, zone=ZONE,
+        client_get.assert_called_with(project_id=TEST_GCP_PROJECT_ID,
+                                      zone=GKE_ZONE,
                                       cluster_id=CLUSTER_NAME,
                                       retry=retry_mock, timeout=timeout_mock)
 
@@ -177,10 +189,11 @@ def test_get_cluster(self):
 class GKEClusterHookTest(unittest.TestCase):
 
     def setUp(self):
-        self.gke_hook = GKEClusterHook(location=ZONE)
+        self.gke_hook = GKEClusterHook(location=GKE_ZONE)
         self.gke_hook._client = mock.Mock()
 
-    @mock.patch('airflow.contrib.hooks.gcp_container_hook.container_v1.ClusterManagerClient')
+    @mock.patch('airflow.contrib.hooks.gcp_container_hook.container_v1.'
+                'ClusterManagerClient')
     @mock.patch('airflow.contrib.hooks.gcp_container_hook.ClientInfo')
     @mock.patch('airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._get_credentials')
     def test_get_client(self, mock_get_credentials, mock_client_info, mock_client):
@@ -193,10 +206,9 @@ def test_get_client(self, mock_get_credentials, mock_client_info, mock_client):
 
     def test_get_operation(self):
         self.gke_hook._client.get_operation = mock.Mock()
-        self.gke_hook.get_operation('TEST_OP', project_id=TEST_PROJECT_ID)
-        self.gke_hook._client.get_operation.assert_called_with(project_id=TEST_PROJECT_ID,
-                                                               zone=ZONE,
-                                                               operation_id='TEST_OP')
+        self.gke_hook.get_operation('TEST_OP', project_id=TEST_GCP_PROJECT_ID)
+        self.gke_hook._client.get_operation.assert_called_with(
+            project_id=TEST_GCP_PROJECT_ID, zone=GKE_ZONE, operation_id='TEST_OP')
 
     def test_append_label(self):
         key = 'test-key'
@@ -244,11 +256,11 @@ def test_wait_for_response_running(self, time_mock, operation_mock):
 
         # Status goes from Running -> Pending -> Done
         operation_mock.side_effect = [pending_op, done_op]
-        self.gke_hook.wait_for_operation(running_op, project_id=TEST_PROJECT_ID)
+        self.gke_hook.wait_for_operation(running_op, project_id=TEST_GCP_PROJECT_ID)
 
         self.assertEqual(time_mock.call_count, 3)
-        operation_mock.assert_any_call(running_op.name, project_id=TEST_PROJECT_ID)
-        operation_mock.assert_any_call(pending_op.name, project_id=TEST_PROJECT_ID)
+        operation_mock.assert_any_call(running_op.name, project_id=TEST_GCP_PROJECT_ID)
+        operation_mock.assert_any_call(pending_op.name, project_id=TEST_GCP_PROJECT_ID)
         self.assertEqual(operation_mock.call_count, 2)
 
     @mock.patch("google.protobuf.json_format.Parse")
diff --git a/tests/contrib/hooks/test_gcp_dataproc_hook.py b/tests/contrib/hooks/test_gcp_dataproc_hook.py
index e22b27a8e7165..acc4922f8261f 100644
--- a/tests/contrib/hooks/test_gcp_dataproc_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataproc_hook.py
@@ -31,8 +31,8 @@
         mock = None
 
 JOB = 'test-job'
-PROJECT_ID = 'test-project-id'
-REGION = 'global'
+GCP_PROJECT_ID = 'test-project-id'
+GCP_REGION = 'global'
 TASK_ID = 'test-task-id'
 
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
@@ -53,8 +53,8 @@ def setUp(self):
     def test_submit(self, job_mock):
         with mock.patch(DATAPROC_STRING.format('DataProcHook.get_conn',
                                                return_value=None)):
-            self.dataproc_hook.submit(PROJECT_ID, JOB)
-            job_mock.assert_called_once_with(mock.ANY, PROJECT_ID, JOB, REGION,
+            self.dataproc_hook.submit(GCP_PROJECT_ID, JOB)
+            job_mock.assert_called_once_with(mock.ANY, GCP_PROJECT_ID, JOB, GCP_REGION,
                                              job_error_states=mock.ANY)
 
 
diff --git a/tests/contrib/operators/postgres_local_executor.cfg b/tests/contrib/operators/postgres_local_executor.cfg
new file mode 100644
index 0000000000000..1f8eb3d3c34c0
--- /dev/null
+++ b/tests/contrib/operators/postgres_local_executor.cfg
@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+# This configuration file is used to override
+# the executor to be LocalExecutor and switch to using Postgres as the database
+# Some system tests require LocalExecutor to be used because of parallelism required
+# One example is test_gcp_bigtable_operator_system.py in which sensor
+# Has to be run in parallell with a task to create BigTable table
+[core]
+executor = LocalExecutor
+sql_alchemy_conn = postgresql:///airflow/airflow.db
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 44ed2e3bcf7e0..6cc80c1eefda1 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -42,7 +42,7 @@
 
 TASK_ID = 'test-bq-create-table-operator'
 TEST_DATASET = 'test-dataset'
-TEST_PROJECT_ID = 'test-project'
+TEST_GCP_PROJECT_ID = 'test-project'
 TEST_TABLE_ID = 'test-table-id'
 TEST_GCS_BUCKET = 'test-bucket'
 TEST_GCS_DATA = ['dir1/*.csv']
@@ -57,7 +57,7 @@ class BigQueryCreateEmptyTableOperatorTest(unittest.TestCase):
     def test_execute(self, mock_hook):
         operator = BigQueryCreateEmptyTableOperator(task_id=TASK_ID,
                                                     dataset_id=TEST_DATASET,
-                                                    project_id=TEST_PROJECT_ID,
+                                                    project_id=TEST_GCP_PROJECT_ID,
                                                     table_id=TEST_TABLE_ID)
 
         operator.execute(None)
@@ -67,7 +67,7 @@ def test_execute(self, mock_hook):
             .create_empty_table \
             .assert_called_once_with(
                 dataset_id=TEST_DATASET,
-                project_id=TEST_PROJECT_ID,
+                project_id=TEST_GCP_PROJECT_ID,
                 table_id=TEST_TABLE_ID,
                 schema_fields=None,
                 time_partitioning={},
@@ -121,7 +121,7 @@ def test_execute(self, mock_hook):
         operator = BigQueryDeleteDatasetOperator(
             task_id=TASK_ID,
             dataset_id=TEST_DATASET,
-            project_id=TEST_PROJECT_ID
+            project_id=TEST_GCP_PROJECT_ID
         )
 
         operator.execute(None)
@@ -131,7 +131,7 @@ def test_execute(self, mock_hook):
             .delete_dataset \
             .assert_called_once_with(
                 dataset_id=TEST_DATASET,
-                project_id=TEST_PROJECT_ID
+                project_id=TEST_GCP_PROJECT_ID
             )
 
 
@@ -141,7 +141,7 @@ def test_execute(self, mock_hook):
         operator = BigQueryCreateEmptyDatasetOperator(
             task_id=TASK_ID,
             dataset_id=TEST_DATASET,
-            project_id=TEST_PROJECT_ID
+            project_id=TEST_GCP_PROJECT_ID
         )
 
         operator.execute(None)
@@ -151,7 +151,7 @@ def test_execute(self, mock_hook):
             .create_empty_dataset \
             .assert_called_once_with(
                 dataset_id=TEST_DATASET,
-                project_id=TEST_PROJECT_ID,
+                project_id=TEST_GCP_PROJECT_ID,
                 dataset_reference={}
             )
 
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 219d7255ffaca..28e4e035e96b8 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -50,9 +50,9 @@
 
 TASK_ID = 'test-dataproc-operator'
 CLUSTER_NAME = 'test-cluster-name'
-PROJECT_ID = 'test-project-id'
+GCP_PROJECT_ID = 'test-project-id'
 NUM_WORKERS = 123
-ZONE = 'us-central1-a'
+GCE_ZONE = 'us-central1-a'
 NETWORK_URI = '/projects/project_id/regions/global/net'
 SUBNETWORK_URI = '/projects/project_id/regions/global/subnet'
 INTERNAL_IP_ONLY = True
@@ -78,7 +78,7 @@
 AUTO_DELETE_TIME = datetime.datetime(2017, 6, 7)
 AUTO_DELETE_TTL = 654
 DEFAULT_DATE = datetime.datetime(2017, 6, 6)
-REGION = 'test-region'
+GCP_REGION = 'test-region'
 MAIN_URI = 'test-uri'
 TEMPLATE_ID = 'template-id'
 
@@ -87,7 +87,7 @@
 DATAPROC_JOB_TO_SUBMIT = {
     'job': {
         'reference': {
-            'projectId': PROJECT_ID,
+            'projectId': GCP_PROJECT_ID,
             'jobId': DATAPROC_JOB_ID,
         },
         'placement': {
@@ -118,9 +118,9 @@ def setUp(self):
                 DataprocClusterCreateOperator(
                     task_id=TASK_ID,
                     cluster_name=CLUSTER_NAME,
-                    project_id=PROJECT_ID,
+                    project_id=GCP_PROJECT_ID,
                     num_workers=NUM_WORKERS,
-                    zone=ZONE,
+                    zone=GCE_ZONE,
                     network_uri=NETWORK_URI,
                     subnetwork_uri=SUBNETWORK_URI,
                     internal_ip_only=INTERNAL_IP_ONLY,
@@ -154,9 +154,9 @@ def test_init(self):
         """Test DataProcClusterOperator instance is properly initialized."""
         for suffix, dataproc_operator in enumerate(self.dataproc_operators):
             self.assertEqual(dataproc_operator.cluster_name, CLUSTER_NAME)
-            self.assertEqual(dataproc_operator.project_id, PROJECT_ID)
+            self.assertEqual(dataproc_operator.project_id, GCP_PROJECT_ID)
             self.assertEqual(dataproc_operator.num_workers, NUM_WORKERS)
-            self.assertEqual(dataproc_operator.zone, ZONE)
+            self.assertEqual(dataproc_operator.zone, GCE_ZONE)
             self.assertEqual(dataproc_operator.network_uri, NETWORK_URI)
             self.assertEqual(dataproc_operator.subnetwork_uri, SUBNETWORK_URI)
             self.assertEqual(dataproc_operator.tags, TAGS)
@@ -186,7 +186,7 @@ def test_build_cluster_data(self):
         for suffix, dataproc_operator in enumerate(self.dataproc_operators):
             cluster_data = dataproc_operator._build_cluster_data()
             self.assertEqual(cluster_data['clusterName'], CLUSTER_NAME)
-            self.assertEqual(cluster_data['projectId'], PROJECT_ID)
+            self.assertEqual(cluster_data['projectId'], GCP_PROJECT_ID)
             self.assertEqual(cluster_data['config']['softwareConfig'],
                              {'imageVersion': IMAGE_VERSION})
             self.assertEqual(cluster_data['config']['configBucket'], STORAGE_BUCKET)
@@ -223,9 +223,9 @@ def test_build_cluster_data_with_autoDeleteTime(self):
         dataproc_operator = DataprocClusterCreateOperator(
             task_id=TASK_ID,
             cluster_name=CLUSTER_NAME,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             num_workers=NUM_WORKERS,
-            zone=ZONE,
+            zone=GCE_ZONE,
             dag=self.dag,
             auto_delete_time=AUTO_DELETE_TIME,
         )
@@ -237,9 +237,9 @@ def test_build_cluster_data_with_autoDeleteTtl(self):
         dataproc_operator = DataprocClusterCreateOperator(
             task_id=TASK_ID,
             cluster_name=CLUSTER_NAME,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             num_workers=NUM_WORKERS,
-            zone=ZONE,
+            zone=GCE_ZONE,
             dag=self.dag,
             auto_delete_ttl=AUTO_DELETE_TTL,
         )
@@ -251,9 +251,9 @@ def test_build_cluster_data_with_autoDeleteTime_and_autoDeleteTtl(self):
         dataproc_operator = DataprocClusterCreateOperator(
             task_id=TASK_ID,
             cluster_name=CLUSTER_NAME,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             num_workers=NUM_WORKERS,
-            zone=ZONE,
+            zone=GCE_ZONE,
             dag=self.dag,
             auto_delete_time=AUTO_DELETE_TIME,
             auto_delete_ttl=AUTO_DELETE_TTL,
@@ -270,9 +270,9 @@ def test_init_with_image_version_and_custom_image_both_set(self):
             DataprocClusterCreateOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
-                zone=ZONE,
+                zone=GCE_ZONE,
                 dag=self.dag,
                 image_version=IMAGE_VERSION,
                 custom_image=CUSTOM_IMAGE
@@ -282,9 +282,9 @@ def test_init_with_custom_image(self):
         dataproc_operator = DataprocClusterCreateOperator(
             task_id=TASK_ID,
             cluster_name=CLUSTER_NAME,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             num_workers=NUM_WORKERS,
-            zone=ZONE,
+            zone=GCE_ZONE,
             dag=self.dag,
             custom_image=CUSTOM_IMAGE
         )
@@ -292,7 +292,7 @@ def test_init_with_custom_image(self):
         cluster_data = dataproc_operator._build_cluster_data()
         expected_custom_image_url = \
             'https://www.googleapis.com/compute/beta/projects/' \
-            '{}/global/images/{}'.format(PROJECT_ID, CUSTOM_IMAGE)
+            '{}/global/images/{}'.format(GCP_PROJECT_ID, CUSTOM_IMAGE)
         self.assertEqual(cluster_data['config']['masterConfig']['imageUri'],
                          expected_custom_image_url)
         self.assertEqual(cluster_data['config']['workerConfig']['imageUri'],
@@ -302,10 +302,10 @@ def test_build_single_node_cluster(self):
         dataproc_operator = DataprocClusterCreateOperator(
             task_id=TASK_ID,
             cluster_name=CLUSTER_NAME,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             num_workers=0,
             num_preemptible_workers=0,
-            zone=ZONE,
+            zone=GCE_ZONE,
             dag=self.dag
         )
         cluster_data = dataproc_operator._build_cluster_data()
@@ -318,10 +318,10 @@ def test_init_cluster_with_zero_workers_and_not_non_zero_preemtibles(self):
             DataprocClusterCreateOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=0,
                 num_preemptible_workers=2,
-                zone=ZONE,
+                zone=GCE_ZONE,
                 dag=self.dag,
                 image_version=IMAGE_VERSION,
             )
@@ -332,9 +332,9 @@ def test_cluster_name_log_no_sub(self):
             dataproc_task = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
-                zone=ZONE,
+                zone=GCE_ZONE,
                 dag=self.dag
             )
             with patch.object(dataproc_task.log, 'info') as mock_info:
@@ -348,9 +348,9 @@ def test_cluster_name_log_sub(self):
             dataproc_task = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
                 cluster_name='smoke-cluster-{{ ts_nodash }}',
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
-                zone=ZONE,
+                zone=GCE_ZONE,
                 dag=self.dag
             )
             with patch.object(dataproc_task.log, 'info') as mock_info:
@@ -371,9 +371,9 @@ def create_cluster_with_invalid_internal_ip_only_setup():
             create_cluster = DataprocClusterCreateOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
-                zone=ZONE,
+                zone=GCE_ZONE,
                 dag=self.dag,
                 internal_ip_only=True)
 
@@ -418,7 +418,7 @@ def test_cluster_name_log_no_sub(self):
             dataproc_task = DataprocClusterScaleOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
                 num_preemptible_workers=NUM_PREEMPTIBLE_WORKERS,
                 dag=self.dag
@@ -434,7 +434,7 @@ def test_cluster_name_log_sub(self):
             dataproc_task = DataprocClusterScaleOperator(
                 task_id=TASK_ID,
                 cluster_name='smoke-cluster-{{ ts_nodash }}',
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 num_workers=NUM_WORKERS,
                 num_preemptible_workers=NUM_PREEMPTIBLE_WORKERS,
                 dag=self.dag
@@ -482,7 +482,7 @@ def test_cluster_name_log_no_sub(self):
             dataproc_task = DataprocClusterDeleteOperator(
                 task_id=TASK_ID,
                 cluster_name=CLUSTER_NAME,
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 dag=self.dag
             )
             with patch.object(dataproc_task.log, 'info') as mock_info:
@@ -496,7 +496,7 @@ def test_cluster_name_log_sub(self):
             dataproc_task = DataprocClusterDeleteOperator(
                 task_id=TASK_ID,
                 cluster_name='smoke-cluster-{{ ts_nodash }}',
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 dag=self.dag
             )
 
@@ -520,12 +520,12 @@ def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHadoopOperator(
                 task_id=TASK_ID,
-                region=REGION
+                region=GCP_REGION
             )
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION, mock.ANY)
+                                                                  GCP_REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -544,12 +544,12 @@ def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcHiveOperator(
                 task_id=TASK_ID,
-                region=REGION
+                region=GCP_REGION
             )
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION, mock.ANY)
+                                                                  GCP_REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -569,12 +569,12 @@ def test_hook_correct_region():
             dataproc_task = DataProcPySparkOperator(
                 task_id=TASK_ID,
                 main=MAIN_URI,
-                region=REGION
+                region=GCP_REGION
             )
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION, mock.ANY)
+                                                                  GCP_REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -594,12 +594,12 @@ def test_hook_correct_region():
         with patch(HOOK) as mock_hook:
             dataproc_task = DataProcSparkOperator(
                 task_id=TASK_ID,
-                region=REGION
+                region=GCP_REGION
             )
 
             dataproc_task.execute(None)
             mock_hook.return_value.submit.assert_called_once_with(mock.ANY, mock.ANY,
-                                                                  REGION, mock.ANY)
+                                                                  GCP_REGION, mock.ANY)
 
     @staticmethod
     def test_dataproc_job_id_is_set():
@@ -642,8 +642,8 @@ def test_workflow(self):
 
             dataproc_task = DataprocWorkflowTemplateInstantiateOperator(
                 task_id=TASK_ID,
-                project_id=PROJECT_ID,
-                region=REGION,
+                project_id=GCP_PROJECT_ID,
+                region=GCP_REGION,
                 template_id=TEMPLATE_ID,
                 dag=self.dag
             )
@@ -694,7 +694,7 @@ def test_iniline_workflow(self):
                         "cluster_name": CLUSTER_NAME,
                         "config": {
                             "gce_cluster_config": {
-                                "zone_uri": ZONE,
+                                "zone_uri": GCE_ZONE,
                             }
                         }
                     }
@@ -710,8 +710,8 @@ def test_iniline_workflow(self):
 
             dataproc_task = DataprocWorkflowTemplateInstantiateInlineOperator(
                 task_id=TASK_ID,
-                project_id=PROJECT_ID,
-                region=REGION,
+                project_id=GCP_PROJECT_ID,
+                region=GCP_REGION,
                 template=template,
                 dag=self.dag
             )
diff --git a/tests/contrib/operators/test_gcp_base.py b/tests/contrib/operators/test_gcp_base.py
deleted file mode 100644
index 7e786c5b4b7c6..0000000000000
--- a/tests/contrib/operators/test_gcp_base.py
+++ /dev/null
@@ -1,175 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-import json
-import os
-import subprocess
-import unittest
-
-from airflow import models, settings, configuration, AirflowException
-from airflow.utils.timezone import datetime
-
-DEFAULT_DATE = datetime(2015, 1, 1)
-
-KEYPATH_EXTRA = 'extra__google_cloud_platform__key_path'
-KEYFILE_DICT_EXTRA = 'extra__google_cloud_platform__keyfile_dict'
-SCOPE_EXTRA = 'extra__google_cloud_platform__scope'
-PROJECT_EXTRA = 'extra__google_cloud_platform__project'
-
-AIRFLOW_MAIN_FOLDER = os.path.realpath(os.path.join(
-    os.path.dirname(os.path.realpath(__file__)),
-    os.pardir, os.pardir, os.pardir))
-
-CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
-    AIRFLOW_MAIN_FOLDER, "airflow", "contrib", "example_dags")
-
-OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
-    AIRFLOW_MAIN_FOLDER, "airflow", "example_dags")
-
-TESTS_DAG_FOLDER = os.path.join(
-    AIRFLOW_MAIN_FOLDER, "tests", "dags")
-
-GCP_FOLDER_ENVIRONMENT_VARIABLE = "GCP_SERVICE_ACCOUNT_KEY_FOLDER"
-
-GCP_COMPUTE_KEY = 'gcp_compute.json'
-GCP_FUNCTION_KEY = 'gcp_function.json'
-GCP_CLOUDSQL_KEY = 'gcp_cloudsql.json'
-GCP_BIGTABLE_KEY = 'gcp_bigtable.json'
-GCP_SPANNER_KEY = 'gcp_spanner.json'
-GCP_GCS_KEY = 'gcp_gcs.json'
-
-SKIP_TEST_WARNING = """
-The test is only run when there is GCP connection available! "
-Set GCP_SERVICE_ACCOUNT_KEY_FOLDER environment variable if "
-you want to run them".
-"""
-
-
-class BaseGcpIntegrationTestCase(unittest.TestCase):
-    def __init__(self,
-                 method_name,
-                 dag_id,
-                 gcp_key,
-                 dag_name=None,
-                 example_dags_folder=CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER,
-                 project_extra=None):
-        super(BaseGcpIntegrationTestCase, self).__init__(method_name)
-        self.dag_id = dag_id
-        self.dag_name = self.dag_id + '.py' if not dag_name else dag_name
-        self.gcp_key = gcp_key
-        self.example_dags_folder = example_dags_folder
-        self.project_extra = project_extra
-        self.full_key_path = None
-
-    def _gcp_authenticate(self):
-        key_dir_path = os.environ['GCP_SERVICE_ACCOUNT_KEY_FOLDER']
-        self.full_key_path = os.path.join(key_dir_path, self.gcp_key)
-
-        if not os.path.isfile(self.full_key_path):
-            raise Exception("The key {} could not be found. Please copy it to the "
-                            "{} folder.".format(self.gcp_key, key_dir_path))
-        print("Setting the GCP key to {}".format(self.full_key_path))
-        # Checking if we can authenticate using service account credentials provided
-        retcode = subprocess.call(['gcloud', 'auth', 'activate-service-account',
-                                   '--key-file={}'.format(self.full_key_path)])
-        if retcode != 0:
-            raise AirflowException("The gcloud auth method was not successful!")
-        self.update_connection_with_key_path()
-        # Now we revoke all authentication here because we want to make sure
-        # that all works fine with the credentials retrieved from the gcp_connection
-        subprocess.call(['gcloud', 'auth', 'revoke'])
-
-    def update_connection_with_key_path(self):
-        session = settings.Session()
-        try:
-            conn = session.query(models.Connection).filter(
-                models.Connection.conn_id == 'google_cloud_default')[0]
-            extras = conn.extra_dejson
-            extras[KEYPATH_EXTRA] = self.full_key_path
-            if extras.get(KEYFILE_DICT_EXTRA):
-                del extras[KEYFILE_DICT_EXTRA]
-            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
-            extras[PROJECT_EXTRA] = self.project_extra
-            conn.extra = json.dumps(extras)
-            session.commit()
-        except BaseException as e:
-            print('Airflow DB Session error:' + str(e.message))
-            session.rollback()
-            raise
-        finally:
-            session.close()
-
-    def update_connection_with_dictionary(self):
-        session = settings.Session()
-        try:
-            conn = session.query(models.Connection).filter(
-                models.Connection.conn_id == 'google_cloud_default')[0]
-            extras = conn.extra_dejson
-            with open(self.full_key_path, "r") as f:
-                content = json.load(f)
-            extras[KEYFILE_DICT_EXTRA] = json.dumps(content)
-            if extras.get(KEYPATH_EXTRA):
-                del extras[KEYPATH_EXTRA]
-            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
-            extras[PROJECT_EXTRA] = self.project_extra
-            conn.extra = json.dumps(extras)
-            session.commit()
-        except BaseException as e:
-            print('Airflow DB Session error:' + str(e.message))
-            session.rollback()
-            raise
-        finally:
-            session.close()
-
-    def _symlink_dag(self):
-        target_path = os.path.join(TESTS_DAG_FOLDER, self.dag_name)
-        if os.path.exists(target_path):
-            os.remove(target_path)
-        os.symlink(
-            os.path.join(self.example_dags_folder, self.dag_name),
-            os.path.join(target_path))
-
-    def _rm_symlink_dag(self):
-        os.remove(os.path.join(TESTS_DAG_FOLDER, self.dag_name))
-
-    def _run_dag(self):
-        dag_bag = models.DagBag(dag_folder=TESTS_DAG_FOLDER, include_examples=False)
-        self.args = {'owner': 'airflow', 'start_date': DEFAULT_DATE}
-        dag = dag_bag.get_dag(self.dag_id)
-        dag.clear(reset_dag_runs=True)
-        dag.run(ignore_first_depends_on_past=True, verbose=True)
-
-    def setUp(self):
-        configuration.conf.load_test_config()
-        self._gcp_authenticate()
-        self._symlink_dag()
-
-    def tearDown(self):
-        self._rm_symlink_dag()
-
-    @staticmethod
-    def skip_check(key):
-        if GCP_FOLDER_ENVIRONMENT_VARIABLE not in os.environ:
-            return True
-        key_folder = os.environ[GCP_FOLDER_ENVIRONMENT_VARIABLE]
-        if not os.path.isdir(key_folder):
-            return True
-        key_path = os.path.join(key_folder, key)
-        if not os.path.isfile(key_path):
-            return True
-        return False
diff --git a/tests/contrib/operators/test_gcp_bigtable_operator_system.py b/tests/contrib/operators/test_gcp_bigtable_operator_system.py
new file mode 100644
index 0000000000000..525da7776c550
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_bigtable_operator_system.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.operators.test_gcp_bigtable_operator_system_helper import \
+    GCPBigtableTestHelper
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.utils.gcp_authenticator import GCP_BIGTABLE_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_BIGTABLE_KEY), SKIP_TEST_WARNING)
+class BigTableExampleDagsSystemTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(BigTableExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_bigtable_operators',
+            require_local_executor=True,
+            gcp_key=GCP_BIGTABLE_KEY)
+        self.helper = GCPBigtableTestHelper()
+
+    def test_run_example_dag_gcs_bigtable(self):
+        self._run_dag()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            self.helper.delete_instance()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+        super(BigTableExampleDagsSystemTest, self).tearDown()
diff --git a/tests/contrib/operators/test_gcp_bigtable_operator_system_helper.py b/tests/contrib/operators/test_gcp_bigtable_operator_system_helper.py
new file mode 100755
index 0000000000000..68d579d3d82a3
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_bigtable_operator_system_helper.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+
+import argparse
+
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_SPANNER_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+CBT_INSTANCE = os.environ.get('CBT_INSTANCE_ID', 'testinstance')
+
+
+class GCPBigtableTestHelper(LoggingCommandExecutor):
+
+    def delete_instance(self):
+        self.execute_cmd([
+            'gcloud', 'bigtable', '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instances', 'delete', CBT_INSTANCE
+        ])
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description='Create or delete spanner instances for system tests.')
+    parser.add_argument('--action', dest='action', required=True,
+                        choices=('delete-instance',
+                                 'before-tests', 'after-tests'))
+    action = parser.parse_args().action
+
+    helper = GCPBigtableTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_SPANNER_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'delete-instance':
+            helper.delete_instance()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
index 4a4e336b7c842..a0907b4a57def 100644
--- a/tests/contrib/operators/test_gcp_compute_operator.py
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -41,12 +41,12 @@
 
 EMPTY_CONTENT = ''.encode('utf8')
 
-PROJECT_ID = 'project-id'
-ZONE = 'zone'
+GCP_PROJECT_ID = 'project-id'
+GCE_ZONE = 'zone'
 RESOURCE_ID = 'resource-id'
-SHORT_MACHINE_TYPE_NAME = 'n1-machine-type'
+GCE_SHORT_MACHINE_TYPE_NAME = 'n1-machine-type'
 SET_MACHINE_TYPE_BODY = {
-    'machineType': 'zones/{}/machineTypes/{}'.format(ZONE, SHORT_MACHINE_TYPE_NAME)
+    'machineType': 'zones/{}/machineTypes/{}'.format(GCE_ZONE, GCE_SHORT_MACHINE_TYPE_NAME)
 }
 
 DEFAULT_DATE = timezone.datetime(2017, 1, 1)
@@ -57,8 +57,8 @@ class GceInstanceStartTest(unittest.TestCase):
     def test_instance_start(self, mock_hook):
         mock_hook.return_value.start_instance.return_value = True
         op = GceInstanceStartOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=RESOURCE_ID,
             task_id='id'
         )
@@ -66,14 +66,14 @@ def test_instance_start(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.start_instance.assert_called_once_with(
-            PROJECT_ID, ZONE, RESOURCE_ID
+            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID
         )
         self.assertTrue(result)
 
     # Setting all of the operator's input parameters as template dag_ids
     # (could be anything else) just to test if the templating works for all fields
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
-    def test_instance_start_with_templates(self, mock_hook):
+    def test_instance_start_with_templates(self, _):
         dag_id = 'test_dag_id'
         configuration.load_test_config()
         args = {
@@ -102,7 +102,7 @@ def test_start_should_throw_ex_when_missing_project_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStartOperator(
                 project_id="",
-                zone=ZONE,
+                zone=GCE_ZONE,
                 resource_id=RESOURCE_ID,
                 task_id='id'
             )
@@ -115,7 +115,7 @@ def test_start_should_throw_ex_when_missing_project_id(self, mock_hook):
     def test_start_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStartOperator(
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 zone="",
                 resource_id=RESOURCE_ID,
                 task_id='id'
@@ -129,8 +129,8 @@ def test_start_should_throw_ex_when_missing_zone(self, mock_hook):
     def test_start_should_throw_ex_when_missing_resource_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStartOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id="",
                 task_id='id'
             )
@@ -145,8 +145,8 @@ class GceInstanceStopTest(unittest.TestCase):
     def test_instance_stop(self, mock_hook):
         mock_hook.return_value.stop_instance.return_value = True
         op = GceInstanceStopOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=RESOURCE_ID,
             task_id='id'
         )
@@ -154,14 +154,14 @@ def test_instance_stop(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.stop_instance.assert_called_once_with(
-            PROJECT_ID, ZONE, RESOURCE_ID
+            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID
         )
         self.assertTrue(result)
 
     # Setting all of the operator's input parameters as templated dag_ids
     # (could be anything else) just to test if the templating works for all fields
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
-    def test_instance_stop_with_templates(self, mock_hook):
+    def test_instance_stop_with_templates(self, _):
         dag_id = 'test_dag_id'
         configuration.load_test_config()
         args = {
@@ -190,7 +190,7 @@ def test_stop_should_throw_ex_when_missing_project_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStopOperator(
                 project_id="",
-                zone=ZONE,
+                zone=GCE_ZONE,
                 resource_id=RESOURCE_ID,
                 task_id='id'
             )
@@ -203,7 +203,7 @@ def test_stop_should_throw_ex_when_missing_project_id(self, mock_hook):
     def test_stop_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStopOperator(
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 zone="",
                 resource_id=RESOURCE_ID,
                 task_id='id'
@@ -217,8 +217,8 @@ def test_stop_should_throw_ex_when_missing_zone(self, mock_hook):
     def test_stop_should_throw_ex_when_missing_resource_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceStopOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id="",
                 task_id='id'
             )
@@ -233,8 +233,8 @@ class GceInstanceSetMachineTypeTest(unittest.TestCase):
     def test_set_machine_type(self, mock_hook):
         mock_hook.return_value.set_machine_type.return_value = True
         op = GceSetMachineTypeOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=RESOURCE_ID,
             body=SET_MACHINE_TYPE_BODY,
             task_id='id'
@@ -243,14 +243,14 @@ def test_set_machine_type(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.set_machine_type.assert_called_once_with(
-            PROJECT_ID, ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY
+            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY
         )
         self.assertTrue(result)
 
     # Setting all of the operator's input parameters as templated dag_ids
     # (could be anything else) just to test if the templating works for all fields
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
-    def test_set_machine_type_with_templates(self, mock_hook):
+    def test_set_machine_type_with_templates(self, _):
         dag_id = 'test_dag_id'
         configuration.load_test_config()
         args = {
@@ -280,7 +280,7 @@ def test_set_machine_type_should_throw_ex_when_missing_project_id(self, mock_hoo
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
                 project_id="",
-                zone=ZONE,
+                zone=GCE_ZONE,
                 resource_id=RESOURCE_ID,
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
@@ -294,7 +294,7 @@ def test_set_machine_type_should_throw_ex_when_missing_project_id(self, mock_hoo
     def test_set_machine_type_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 zone="",
                 resource_id=RESOURCE_ID,
                 body=SET_MACHINE_TYPE_BODY,
@@ -309,8 +309,8 @@ def test_set_machine_type_should_throw_ex_when_missing_zone(self, mock_hook):
     def test_set_machine_type_should_throw_ex_when_missing_resource_id(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id="",
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
@@ -324,8 +324,8 @@ def test_set_machine_type_should_throw_ex_when_missing_resource_id(self, mock_ho
     def test_set_machine_type_should_throw_ex_when_missing_machine_type(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id=RESOURCE_ID,
                 body={},
                 task_id='id'
@@ -367,11 +367,12 @@ def test_set_machine_type_should_handle_and_trim_gce_error(
             self, get_conn, _execute_set_machine_type, _check_zone_operation_status):
         get_conn.return_value = {}
         _execute_set_machine_type.return_value = {"name": "test-operation"}
-        _check_zone_operation_status.return_value = ast.literal_eval(self.MOCK_OP_RESPONSE)
+        _check_zone_operation_status.return_value = ast.literal_eval(
+            self.MOCK_OP_RESPONSE)
         with self.assertRaises(AirflowException) as cm:
             op = GceSetMachineTypeOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id=RESOURCE_ID,
                 body=SET_MACHINE_TYPE_BODY,
                 task_id='id'
@@ -379,9 +380,9 @@ def test_set_machine_type_should_handle_and_trim_gce_error(
             op.execute(None)
         err = cm.exception
         _check_zone_operation_status.assert_called_once_with(
-            {}, "test-operation", PROJECT_ID, ZONE)
+            {}, "test-operation", GCP_PROJECT_ID, GCE_ZONE)
         _execute_set_machine_type.assert_called_once_with(
-            PROJECT_ID, ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
+            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
         # Checking the full message was sometimes failing due to different order
         # of keys in the serialized JSON
         self.assertIn("400 BAD REQUEST: {", str(err))  # checking the square bracket trim
@@ -490,7 +491,7 @@ def test_successful_copy_template(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
@@ -499,7 +500,7 @@ def test_successful_copy_template(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=GCE_INSTANCE_TEMPLATE_BODY_INSERT,
             request_id=None
         )
@@ -511,7 +512,7 @@ def test_idempotent_copy_template_when_already_copied(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
@@ -530,7 +531,7 @@ def test_successful_copy_template_with_request_id(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
             task_id='id',
@@ -540,7 +541,7 @@ def test_successful_copy_template_with_request_id(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=GCE_INSTANCE_TEMPLATE_BODY_INSERT,
             request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
         )
@@ -554,7 +555,7 @@ def test_successful_copy_template_with_description_fields(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
             task_id='id',
@@ -568,7 +569,7 @@ def test_successful_copy_template_with_description_fields(self, mock_hook):
         body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
         body_insert["description"] = "New description"
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=body_insert,
             request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
         )
@@ -582,7 +583,7 @@ def test_copy_with_some_validation_warnings(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME,
@@ -598,7 +599,7 @@ def test_copy_with_some_validation_warnings(self, mock_hook):
         body_insert["some_wrong_field"] = "test"
         body_insert["properties"]["some_other_wrong_field"] = "test"
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=body_insert,
             request_id=None,
         )
@@ -612,7 +613,7 @@ def test_successful_copy_template_with_updated_nested_fields(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={
@@ -628,7 +629,7 @@ def test_successful_copy_template_with_updated_nested_fields(self, mock_hook):
         body_insert = deepcopy(GCE_INSTANCE_TEMPLATE_BODY_INSERT)
         body_insert["properties"]["machineType"] = "n1-standard-2"
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=body_insert,
             request_id=None
         )
@@ -642,7 +643,7 @@ def test_successful_copy_template_with_smaller_array_fields(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={
@@ -681,7 +682,7 @@ def test_successful_copy_template_with_smaller_array_fields(self, mock_hook):
             }
         ]
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=body_insert,
             request_id=None
         )
@@ -695,7 +696,7 @@ def test_successful_copy_template_with_bigger_array_fields(self, mock_hook):
             GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
         ]
         op = GceInstanceTemplateCopyOperator(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_TEMPLATE_NAME,
             task_id='id',
             body_patch={
@@ -742,7 +743,7 @@ def test_successful_copy_template_with_bigger_array_fields(self, mock_hook):
             }
         ]
         mock_hook.return_value.insert_instance_template.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             body=body_insert,
             request_id=None,
         )
@@ -757,7 +758,7 @@ def test_missing_name(self, mock_hook):
         ]
         with self.assertRaises(AirflowException) as cm:
             op = GceInstanceTemplateCopyOperator(
-                project_id=PROJECT_ID,
+                project_id=GCP_PROJECT_ID,
                 resource_id=GCE_INSTANCE_TEMPLATE_NAME,
                 request_id=GCE_INSTANCE_TEMPLATE_REQUEST_ID,
                 task_id='id',
@@ -876,8 +877,8 @@ def test_successful_instance_group_update(self, mock_hook):
         mock_hook.return_value.get_instance_group_manager.return_value = \
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
@@ -887,8 +888,8 @@ def test_successful_instance_group_update(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='beta',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             body=GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH,
             request_id=None
@@ -902,8 +903,8 @@ def test_successful_instance_group_update_no_instance_template_field(self, mock_
         mock_hook.return_value.get_instance_group_manager.return_value = \
             instance_group_manager_no_template
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
@@ -916,8 +917,8 @@ def test_successful_instance_group_update_no_instance_template_field(self, mock_
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
         del expected_patch_no_instance_template['instanceTemplate']
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             body=expected_patch_no_instance_template,
             request_id=None
@@ -931,8 +932,8 @@ def test_successful_instance_group_update_no_versions_field(self, mock_hook):
         mock_hook.return_value.get_instance_group_manager.return_value = \
             instance_group_manager_no_versions
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
@@ -945,8 +946,8 @@ def test_successful_instance_group_update_no_versions_field(self, mock_hook):
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
         del expected_patch_no_versions['versions']
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             body=expected_patch_no_versions,
             request_id=None
@@ -958,8 +959,8 @@ def test_successful_instance_group_update_with_update_policy(self, mock_hook):
         mock_hook.return_value.get_instance_group_manager.return_value = \
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             update_policy=GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY,
@@ -974,8 +975,8 @@ def test_successful_instance_group_update_with_update_policy(self, mock_hook):
         expected_patch_with_update_policy['updatePolicy'] = \
             GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             body=expected_patch_with_update_policy,
             request_id=None
@@ -987,8 +988,8 @@ def test_successful_instance_group_update_with_request_id(self, mock_hook):
         mock_hook.return_value.get_instance_group_manager.return_value = \
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
@@ -999,8 +1000,8 @@ def test_successful_instance_group_update_with_request_id(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='beta',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             body=GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH,
             request_id=GCE_INSTANCE_GROUP_MANAGER_REQUEST_ID
@@ -1011,8 +1012,8 @@ def test_successful_instance_group_update_with_request_id(self, mock_hook):
     def test_try_to_use_api_v1(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
             GceInstanceGroupManagerUpdateTemplateOperator(
-                project_id=PROJECT_ID,
-                zone=ZONE,
+                project_id=GCP_PROJECT_ID,
+                zone=GCE_ZONE,
                 resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
                 task_id='id',
                 api_version='v1',
@@ -1027,8 +1028,8 @@ def test_try_to_use_non_existing_template(self, mock_hook):
         mock_hook.return_value.get_instance_group_manager.return_value = \
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
         op = GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=PROJECT_ID,
-            zone=ZONE,
+            project_id=GCP_PROJECT_ID,
+            zone=GCE_ZONE,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             task_id='id',
             source_template=GCE_INSTANCE_TEMPLATE_NON_EXISTING_URL,
diff --git a/tests/contrib/operators/test_gcp_compute_operator_system.py b/tests/contrib/operators/test_gcp_compute_operator_system.py
new file mode 100644
index 0000000000000..0054df99d7dbb
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_compute_operator_system.py
@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+
+from tests.contrib.operators.test_gcp_compute_operator_system_helper import \
+    GCPComputeTestHelper
+from tests.contrib.utils.gcp_authenticator import GCP_COMPUTE_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_COMPUTE_KEY), SKIP_TEST_WARNING)
+class GcpComputeExampleDagsSystemTest(DagGcpSystemTestCase):
+
+    def setUp(self):
+        super(GcpComputeExampleDagsSystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        self.helper.delete_instance()
+        self.helper.create_instance()
+        self.gcp_authenticator.gcp_revoke_authentication()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        self.helper.delete_instance()
+        self.gcp_authenticator.gcp_revoke_authentication()
+        super(GcpComputeExampleDagsSystemTest, self).tearDown()
+
+    def __init__(self, method_name='runTest'):
+        super(GcpComputeExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_compute',
+            gcp_key=GCP_COMPUTE_KEY)
+        self.helper = GCPComputeTestHelper()
+
+    def test_run_example_dag_compute(self):
+        self._run_dag()
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_COMPUTE_KEY), SKIP_TEST_WARNING)
+class GcpComputeIgmExampleDagsSystemTest(DagGcpSystemTestCase):
+
+    def setUp(self):
+        super(GcpComputeIgmExampleDagsSystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            self.helper.delete_instance_group_and_template(silent=True)
+            self.helper.create_instance_group_and_template()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            self.helper.delete_instance_group_and_template()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+        super(GcpComputeIgmExampleDagsSystemTest, self).tearDown()
+
+    def __init__(self, method_name='runTest'):
+        super(GcpComputeIgmExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_compute_igm',
+            gcp_key=GCP_COMPUTE_KEY)
+        self.helper = GCPComputeTestHelper()
+
+    def test_run_example_dag_compute_igm(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_compute_operator_system_helper.py b/tests/contrib/operators/test_gcp_compute_operator_system_helper.py
new file mode 100755
index 0000000000000..60de2381d196c
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_compute_operator_system_helper.py
@@ -0,0 +1,124 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import argparse
+import os
+
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_COMPUTE_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+GCE_INSTANCE = os.environ.get('GCE_INSTANCE', 'testinstance')
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCE_INSTANCE_GROUP_MANAGER_NAME = os.environ.get('GCE_INSTANCE_GROUP_MANAGER_NAME',
+                                                 'instance-group-test')
+GCE_ZONE = os.environ.get('GCE_ZONE', 'europe-west1-b')
+GCE_TEMPLATE_NAME = os.environ.get('GCE_TEMPLATE_NAME',
+                                   'instance-template-test')
+GCE_NEW_TEMPLATE_NAME = os.environ.get('GCE_NEW_TEMPLATE_NAME',
+                                       'instance-template-test-new')
+
+
+class GCPComputeTestHelper(LoggingCommandExecutor):
+
+    def delete_instance(self):
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instances', 'delete', GCE_INSTANCE, '--zone', GCE_ZONE,
+        ])
+
+    def create_instance(self):
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID, '--quiet',
+            'instances', 'create', GCE_INSTANCE,
+            '--zone', GCE_ZONE
+        ])
+
+    def delete_instance_group_and_template(self, silent=False):
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instance-groups', 'managed', 'delete', GCE_INSTANCE_GROUP_MANAGER_NAME,
+            '--zone', GCE_ZONE
+        ], silent=silent)
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instance-templates', 'delete', GCE_NEW_TEMPLATE_NAME
+        ], silent=silent)
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute',
+            '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instance-templates', 'delete', GCE_TEMPLATE_NAME
+        ], silent=silent)
+
+    def create_instance_group_and_template(self):
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID, '--quiet',
+            'instance-templates', 'create', GCE_TEMPLATE_NAME
+        ])
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID, '--quiet',
+            'instance-groups', 'managed', 'create', GCE_INSTANCE_GROUP_MANAGER_NAME,
+            '--template', GCE_TEMPLATE_NAME,
+            '--zone', GCE_ZONE, '--size=1'
+        ])
+        self.execute_cmd([
+            'gcloud', 'beta', 'compute', '--project', GCP_PROJECT_ID, '--quiet',
+            'instance-groups', 'managed', 'wait-until-stable',
+            GCE_INSTANCE_GROUP_MANAGER_NAME,
+            '--zone', GCE_ZONE
+        ])
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description='Create or delete GCE instances/instance groups for system tests.')
+    parser.add_argument('--action', dest='action', required=True,
+                        choices=('create-instance', 'delete-instance',
+                                 'create-instance-group', 'delete-instance-group',
+                                 'before-tests', 'after-tests'))
+    action = parser.parse_args().action
+
+    helper = GCPComputeTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_COMPUTE_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'create-instance':
+            helper.create_instance()
+        elif action == 'delete-instance':
+            helper.delete_instance()
+        elif action == 'create-instance-group':
+            helper.create_instance_group_and_template()
+        elif action == 'delete-instance-group':
+            helper.delete_instance_group_and_template()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index 1685e9c6ac6eb..600c7cd8a89e4 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -33,7 +33,7 @@
     except ImportError:
         mock = None
 
-PROJECT_ID = 'test-id'
+TEST_GCP_PROJECT_ID = 'test-id'
 PROJECT_LOCATION = 'test-location'
 PROJECT_TASK_ID = 'test-task-id'
 CLUSTER_NAME = 'test-cluster-name'
@@ -55,7 +55,7 @@ class GoogleCloudPlatformContainerOperatorTest(unittest.TestCase):
 
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_create_execute(self, mock_hook):
-        operator = GKEClusterCreateOperator(project_id=PROJECT_ID,
+        operator = GKEClusterCreateOperator(project_id=TEST_GCP_PROJECT_ID,
                                             location=PROJECT_LOCATION,
                                             body=PROJECT_BODY_CREATE,
                                             task_id=PROJECT_TASK_ID)
@@ -67,7 +67,7 @@ def test_create_execute(self, mock_hook):
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_create_execute_error_body(self, mock_hook):
         with self.assertRaises(AirflowException):
-            operator = GKEClusterCreateOperator(project_id=PROJECT_ID,
+            operator = GKEClusterCreateOperator(project_id=TEST_GCP_PROJECT_ID,
                                                 location=PROJECT_LOCATION,
                                                 body=None,
                                                 task_id=PROJECT_TASK_ID)
@@ -88,7 +88,7 @@ def test_create_execute_error_project_id(self, mock_hook):
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_create_execute_error_location(self, mock_hook):
         with self.assertRaises(AirflowException):
-            operator = GKEClusterCreateOperator(project_id=PROJECT_ID,
+            operator = GKEClusterCreateOperator(project_id=TEST_GCP_PROJECT_ID,
                                                 body=PROJECT_BODY,
                                                 task_id=PROJECT_TASK_ID)
 
@@ -97,7 +97,7 @@ def test_create_execute_error_location(self, mock_hook):
 
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_delete_execute(self, mock_hook):
-        operator = GKEClusterDeleteOperator(project_id=PROJECT_ID,
+        operator = GKEClusterDeleteOperator(project_id=TEST_GCP_PROJECT_ID,
                                             name=CLUSTER_NAME,
                                             location=PROJECT_LOCATION,
                                             task_id=PROJECT_TASK_ID)
@@ -118,7 +118,7 @@ def test_delete_execute_error_project_id(self, mock_hook):
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_delete_execute_error_cluster_name(self, mock_hook):
         with self.assertRaises(AirflowException):
-            operator = GKEClusterDeleteOperator(project_id=PROJECT_ID,
+            operator = GKEClusterDeleteOperator(project_id=TEST_GCP_PROJECT_ID,
                                                 location=PROJECT_LOCATION,
                                                 task_id=PROJECT_TASK_ID)
 
@@ -128,7 +128,7 @@ def test_delete_execute_error_cluster_name(self, mock_hook):
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEClusterHook')
     def test_delete_execute_error_location(self, mock_hook):
         with self.assertRaises(AirflowException):
-            operator = GKEClusterDeleteOperator(project_id=PROJECT_ID,
+            operator = GKEClusterDeleteOperator(project_id=TEST_GCP_PROJECT_ID,
                                                 name=CLUSTER_NAME,
                                                 task_id=PROJECT_TASK_ID)
 
@@ -138,7 +138,7 @@ def test_delete_execute_error_location(self, mock_hook):
 
 class GKEPodOperatorTest(unittest.TestCase):
     def setUp(self):
-        self.gke_op = GKEPodOperator(project_id=PROJECT_ID,
+        self.gke_op = GKEPodOperator(project_id=TEST_GCP_PROJECT_ID,
                                      location=PROJECT_LOCATION,
                                      cluster_name=CLUSTER_NAME,
                                      task_id=PROJECT_TASK_ID,
@@ -167,7 +167,7 @@ def test_execute_conn_id_none(self, proc_mock, file_mock, exec_mock):
 
         # Assert the gcloud command being called correctly
         proc_mock.assert_called_with(
-            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, TEST_GCP_PROJECT_ID).split())
 
         self.assertEqual(self.gke_op.config_file, FILE_NAME)
 
@@ -197,7 +197,7 @@ def test_execute_conn_id_path(self, proc_mock, file_mock, exec_mock, get_con_moc
 
         # Assert the gcloud command being called correctly
         proc_mock.assert_called_with(
-            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, TEST_GCP_PROJECT_ID).split())
 
         self.assertEqual(self.gke_op.config_file, FILE_NAME)
 
@@ -232,7 +232,7 @@ def test_execute_conn_id_dict(self, proc_mock, file_mock, exec_mock, get_con_moc
 
         # Assert the gcloud command being called correctly
         proc_mock.assert_called_with(
-            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, PROJECT_ID).split())
+            GCLOUD_COMMAND.format(CLUSTER_NAME, PROJECT_LOCATION, TEST_GCP_PROJECT_ID).split())
 
         self.assertEqual(self.gke_op.config_file, FILE_NAME)
 
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
index 46d599bf7d35f..3c568fce0c959 100644
--- a/tests/contrib/operators/test_gcp_function_operator.py
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -41,20 +41,21 @@
 EMPTY_CONTENT = ''.encode('utf8')
 MOCK_RESP_404 = type('', (object,), {"status": 404})()
 
-PROJECT_ID = 'test_project_id'
-LOCATION = 'test_region'
-SOURCE_ARCHIVE_URL = 'gs://folder/file.zip'
-ENTRYPOINT = 'helloWorld'
-FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(PROJECT_ID, LOCATION,
-                                                               ENTRYPOINT)
-RUNTIME = 'nodejs6'
+GCP_PROJECT_ID = 'test_project_id'
+GCP_LOCATION = 'test_region'
+GCF_SOURCE_ARCHIVE_URL = 'gs://folder/file.zip'
+GCF_ENTRYPOINT = 'helloWorld'
+FUNCTION_NAME = 'projects/{}/locations/{}/functions/{}'.format(GCP_PROJECT_ID,
+                                                               GCP_LOCATION,
+                                                               GCF_ENTRYPOINT)
+GCF_RUNTIME = 'nodejs6'
 VALID_RUNTIMES = ['nodejs6', 'nodejs8', 'python37']
 VALID_BODY = {
     "name": FUNCTION_NAME,
-    "entryPoint": ENTRYPOINT,
-    "runtime": RUNTIME,
+    "entryPoint": GCF_ENTRYPOINT,
+    "runtime": GCF_RUNTIME,
     "httpsTrigger": {},
-    "sourceArchiveUrl": SOURCE_ARCHIVE_URL
+    "sourceArchiveUrl": GCF_SOURCE_ARCHIVE_URL
 }
 
 
@@ -100,8 +101,8 @@ def test_deploy_execute(self, mock_hook):
             side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
         mock_hook.return_value.create_new_function.return_value = True
         op = GcfFunctionDeployOperator(
-            project_id=PROJECT_ID,
-            location=LOCATION,
+            project_id=GCP_PROJECT_ID,
+            location=GCP_LOCATION,
             body=deepcopy(VALID_BODY),
             task_id="id"
         )
@@ -125,8 +126,8 @@ def test_update_function_if_exists(self, mock_hook):
         mock_hook.return_value.get_function.return_value = True
         mock_hook.return_value.update_function.return_value = True
         op = GcfFunctionDeployOperator(
-            project_id=PROJECT_ID,
-            location=LOCATION,
+            project_id=GCP_PROJECT_ID,
+            location=GCP_LOCATION,
             body=deepcopy(VALID_BODY),
             task_id="id"
         )
@@ -192,7 +193,6 @@ def test_empty_body(self, mock_hook):
     ])
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_correct_runtime_field(self, runtime, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body['runtime'] = runtime
@@ -217,7 +217,6 @@ def test_correct_runtime_field(self, runtime, mock_hook):
     ])
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_valid_network_field(self, network, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body['network'] = network
@@ -241,7 +240,6 @@ def test_valid_network_field(self, network, mock_hook):
     ])
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_valid_labels_field(self, labels, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body['labels'] = labels
@@ -258,7 +256,6 @@ def test_valid_labels_field(self, labels, mock_hook):
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_validation_disabled(self, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = {
             "name": "function_name",
@@ -278,7 +275,6 @@ def test_validation_disabled(self, mock_hook):
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_body_validation_simple(self, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body['name'] = ''
@@ -315,7 +311,6 @@ def test_body_validation_simple(self, mock_hook):
     ])
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_invalid_field_values(self, key, value, message, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body[key] = value
@@ -521,7 +516,6 @@ def test_valid_trigger_union_field(self, trigger, mock_hook):
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_extra_parameter(self, mock_hook):
-        mock_hook.return_value.list_functions.return_value = []
         mock_hook.return_value.create_new_function.return_value = True
         body = deepcopy(VALID_BODY)
         body['extra_parameter'] = 'extra'
diff --git a/tests/contrib/operators/test_gcp_function_operator_system.py b/tests/contrib/operators/test_gcp_function_operator_system.py
new file mode 100644
index 0000000000000..2dc24de00a16e
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_function_operator_system.py
@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.utils.gcp_authenticator import GCP_FUNCTION_KEY
+
+
+@unittest.skipIf(
+    DagGcpSystemTestCase.skip_check(GCP_FUNCTION_KEY), SKIP_TEST_WARNING)
+class GcpFunctionExampleDagsSystemTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(GcpFunctionExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_function',
+            gcp_key=GCP_FUNCTION_KEY)
+
+    def test_run_example_dag_function(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
index 525f79647126f..455a6543c8b0d 100644
--- a/tests/contrib/operators/test_gcp_spanner_operator.py
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -22,11 +22,12 @@
 
 from airflow import AirflowException
 from airflow.contrib.operators.gcp_spanner_operator import \
-    CloudSpannerInstanceDeployOperator, CloudSpannerInstanceDeleteOperator, \
-    CloudSpannerInstanceDatabaseQueryOperator, CloudSpannerInstanceDatabaseDeployOperator, \
-    CloudSpannerInstanceDatabaseDeleteOperator, CloudSpannerInstanceDatabaseUpdateOperator
-from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
-    SKIP_TEST_WARNING, GCP_SPANNER_KEY
+    CloudSpannerInstanceDeployOperator, \
+    CloudSpannerInstanceDeleteOperator, \
+    CloudSpannerInstanceDatabaseQueryOperator, \
+    CloudSpannerInstanceDatabaseDeployOperator, \
+    CloudSpannerInstanceDatabaseDeleteOperator, \
+    CloudSpannerInstanceDatabaseUpdateOperator
 
 try:
     # noinspection PyProtectedMember
@@ -45,8 +46,8 @@
 DISPLAY_NAME = 'Test Instance'
 INSERT_QUERY = "INSERT my_table1 (id, name) VALUES (1, 'One')"
 INSERT_QUERY_2 = "INSERT my_table2 (id, name) VALUES (1, 'One')"
-CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
-CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(MAX)) PRIMARY KEY (id)"
+CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(100)) PRIMARY KEY (id)"
+CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(100)) PRIMARY KEY (id)"
 DDL_STATEMENTS = [CREATE_QUERY, CREATE_QUERY_2]
 
 
@@ -405,16 +406,3 @@ def test_database_delete_ex_if_param_missing(self, project_id, instance_id,
         err = cm.exception
         self.assertIn("The required parameter '{}' is empty".format(exp_msg), str(err))
         mock_hook.assert_not_called()
-
-
-@unittest.skipIf(
-    BaseGcpIntegrationTestCase.skip_check(GCP_SPANNER_KEY), SKIP_TEST_WARNING)
-class CloudSpannerExampleDagsTest(BaseGcpIntegrationTestCase):
-    def __init__(self, method_name='runTest'):
-        super(CloudSpannerExampleDagsTest, self).__init__(
-            method_name,
-            dag_id='example_gcp_spanner',
-            gcp_key=GCP_SPANNER_KEY)
-
-    def test_run_example_dag_cloudsql_query(self):
-        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_spanner_operator_system.py b/tests/contrib/operators/test_gcp_spanner_operator_system.py
new file mode 100644
index 0000000000000..fd4c50bd8ab09
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_spanner_operator_system.py
@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.operators.test_gcp_spanner_operator_system_helper import \
+    GCPSpannerTestHelper
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.utils.gcp_authenticator import GCP_SPANNER_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_SPANNER_KEY), SKIP_TEST_WARNING)
+class CloudSpannerExampleDagsTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSpannerExampleDagsTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_spanner',
+            gcp_key=GCP_SPANNER_KEY)
+        self.helper = GCPSpannerTestHelper()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            self.helper.delete_instance()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+        super(CloudSpannerExampleDagsTest, self).tearDown()
+
+    def test_run_example_dag_spanner(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_spanner_operator_system_helper.py b/tests/contrib/operators/test_gcp_spanner_operator_system_helper.py
new file mode 100755
index 0000000000000..b715bcdbcb47c
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_spanner_operator_system_helper.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+
+import argparse
+
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_SPANNER_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_SPANNER_INSTANCE_ID = os.environ.get('GCP_SPANNER_INSTANCE_ID', 'testinstance')
+
+
+class GCPSpannerTestHelper(LoggingCommandExecutor):
+
+    def delete_instance(self):
+        self.execute_cmd([
+            'gcloud', 'spanner', '--project', GCP_PROJECT_ID,
+            '--quiet', '--verbosity=none',
+            'instances', 'delete', GCP_SPANNER_INSTANCE_ID
+        ])
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description='Create or delete spanner instances for system tests.')
+    parser.add_argument('--action', dest='action', required=True,
+                        choices=('delete-instance',
+                                 'before-tests', 'after-tests'))
+    action = parser.parse_args().action
+
+    helper = GCPSpannerTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_SPANNER_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'delete-instance':
+            helper.delete_instance()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 6e5b2e4e866ab..d4870e4812867 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -20,20 +20,15 @@
 import os
 import unittest
 
-import time
 from parameterized import parameterized
-from uuid import uuid1
 
 from airflow import AirflowException
-from airflow.contrib.hooks.gcp_sql_hook import CloudSqlProxyRunner
 from airflow.contrib.operators.gcp_sql_operator import CloudSqlInstanceCreateOperator, \
     CloudSqlInstancePatchOperator, CloudSqlInstanceDeleteOperator, \
     CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
     CloudSqlInstanceExportOperator, CloudSqlInstanceImportOperator, \
     CloudSqlInstanceDatabaseDeleteOperator, CloudSqlQueryOperator
 from airflow.models import Connection
-from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
-    GCP_CLOUDSQL_KEY, SKIP_TEST_WARNING
 
 try:
     # noinspection PyProtectedMember
@@ -150,7 +145,7 @@
             "schemaOnly": False
         },
         "csvExportOptions": {
-            "selectQuery": "SELECT * FROM ..."
+            "selectQuery": "SELECT * FROM TABLE"
         }
     }
 }
@@ -546,6 +541,13 @@ def test_instance_import(self, mock_hook):
 
 
 class CloudSqlQueryValidationTest(unittest.TestCase):
+
+    @staticmethod
+    def _setup_connections(get_connections, uri):
+        cloudsql_connection = Connection()
+        cloudsql_connection.parse_from_uri(uri)
+        get_connections.side_effect = [[cloudsql_connection]]
+
     @parameterized.expand([
         ('', 'location', 'instance_name', 'postgres', False, False,
          'SELECT * FROM TEST',
@@ -578,19 +580,18 @@ def test_create_operator_with_wrong_parameters(self,
                                                    sql,
                                                    message,
                                                    get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?"
-            "database_type={database_type}&"
-            "project_id={project_id}&location={location}&instance={instance_name}&"
-            "use_proxy={use_proxy}&use_ssl={use_ssl}".
-            format(database_type=database_type,
-                   project_id=project_id,
-                   location=location,
-                   instance_name=instance_name,
-                   use_proxy=use_proxy,
-                   use_ssl=use_ssl))
-        get_connections.return_value = [connection]
+        uri = \
+            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?" \
+            "database_type={database_type}&" \
+            "project_id={project_id}&location={location}&instance={instance_name}&" \
+            "use_proxy={use_proxy}&use_ssl={use_ssl}".format(
+                database_type=database_type,
+                project_id=project_id,
+                location=location,
+                instance_name=instance_name,
+                use_proxy=use_proxy,
+                use_ssl=use_ssl)
+        self._setup_connections(get_connections, uri)
         with self.assertRaises(AirflowException) as cm:
             op = CloudSqlQueryOperator(
                 sql=sql,
@@ -602,12 +603,10 @@ def test_create_operator_with_wrong_parameters(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=False&use_ssl=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=False&use_ssl=False"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -625,13 +624,11 @@ def test_create_operator_with_correct_parameters_postgres(self, get_connections)
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=False&use_ssl=True&sslcert=/bin/bash&"
-            "sslkey=/bin/bash&sslrootcert=/bin/bash")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=False&use_ssl=True&sslcert=/bin/bash&" \
+              "sslkey=/bin/bash&sslrootcert=/bin/bash"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -653,12 +650,10 @@ def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connecti
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_proxy_socket(
             self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=True&sql_proxy_use_tcp=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=True&sql_proxy_use_tcp=False"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -678,12 +673,10 @@ def test_create_operator_with_correct_parameters_postgres_proxy_socket(
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_proxy_tcp(self,
                                                                         get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=True&sql_proxy_use_tcp=True")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=True&sql_proxy_use_tcp=True"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -701,12 +694,10 @@ def test_create_operator_with_correct_parameters_postgres_proxy_tcp(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=False&use_ssl=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+            "project_id=example-project&location=europe-west1&instance=testdb&" \
+            "use_proxy=False&use_ssl=False"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -724,13 +715,11 @@ def test_create_operator_with_correct_parameters_mysql(self, get_connections):
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=False&use_ssl=True&sslcert=/bin/bash&"
-            "sslkey=/bin/bash&sslrootcert=/bin/bash")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=False&use_ssl=True&sslcert=/bin/bash&" \
+              "sslkey=/bin/bash&sslrootcert=/bin/bash"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -752,12 +741,10 @@ def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_proxy_socket(self,
                                                                         get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=True&sql_proxy_use_tcp=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=True&sql_proxy_use_tcp=False"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -778,12 +765,10 @@ def test_create_operator_with_correct_parameters_mysql_proxy_socket(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
-            "project_id=example-project&location=europe-west1&instance=testdb&"
-            "use_proxy=True&sql_proxy_use_tcp=True")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+              "project_id=example-project&location=europe-west1&instance=testdb&" \
+              "use_proxy=True&sql_proxy_use_tcp=True"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -801,33 +786,30 @@ def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_too_long_unix_socket_path(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&"
-            "instance="
-            "test_db_with_long_name_a_bit_above_the_limit_of_UNIX_socket&"
-            "use_proxy=True&sql_proxy_use_tcp=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&" \
+              "instance=" \
+              "test_db_with_long_name_a_bit_above" \
+              "_the_limit_of_UNIX_socket_asdadadasadasd&" \
+              "use_proxy=True&sql_proxy_use_tcp=False"
+        self._setup_connections(get_connections, uri)
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
         with self.assertRaises(AirflowException) as cm:
-            op = CloudSqlQueryOperator(
-                sql=['SELECT * FROM TABLE'],
-                task_id='task_id'
-            )
-            op.execute(None)
+            operator.execute(None)
         err = cm.exception
         self.assertIn("The UNIX socket path length cannot exceed", str(err))
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_not_too_long_unix_socket_path(self, get_connections):
-        connection = Connection()
-        connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&"
-            "project_id=example-project&location=europe-west1&"
-            "instance="
-            "test_db_with_longname_but_with_limit_of_UNIX_socket_aaaa&"
-            "use_proxy=True&sql_proxy_use_tcp=False")
-        get_connections.return_value = [connection]
+        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+              "project_id=example-project&location=europe-west1&" \
+              "instance=" \
+              "test_db_with_longname_but_with_limit_of_UNIX_socket&" \
+              "use_proxy=True&sql_proxy_use_tcp=False"
+        self._setup_connections(get_connections, uri)
         operator = CloudSqlQueryOperator(
             sql=['SELECT * FROM TABLE'],
             task_id='task_id'
@@ -873,89 +855,3 @@ def test_cloudsql_hook_delete_connection_on_exception(
         err = cm.exception
         self.assertEqual("Exception when running a query", str(err))
         delete_connection.assert_called_once_with()
-
-
-@unittest.skipIf(
-    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
-class CloudSqlProxyIntegrationTest(BaseGcpIntegrationTestCase):
-    def __init__(self, method_name='runTest'):
-        super(CloudSqlProxyIntegrationTest, self).__init__(
-            method_name,
-            dag_id='example_gcp_sql_query',
-            gcp_key='gcp_cloudsql.json')
-
-    def test_start_proxy_fail_no_parameters(self):
-        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
-                                     project_id=PROJECT_ID,
-                                     instance_specification='a')
-        with self.assertRaises(AirflowException) as cm:
-            runner.start_proxy()
-        err = cm.exception
-        self.assertIn("invalid instance name", str(err))
-        with self.assertRaises(AirflowException) as cm:
-            runner.start_proxy()
-        err = cm.exception
-        self.assertIn("invalid instance name", str(err))
-        self.assertIsNone(runner.sql_proxy_process)
-
-    def test_start_proxy_with_all_instances(self):
-        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
-                                     project_id=PROJECT_ID,
-                                     instance_specification='')
-        try:
-            runner.start_proxy()
-            time.sleep(1)
-        finally:
-            runner.stop_proxy()
-        self.assertIsNone(runner.sql_proxy_process)
-
-    def test_start_proxy_with_all_instances_generated_credential_file(self):
-        self.update_connection_with_dictionary()
-        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
-                                     project_id=PROJECT_ID,
-                                     instance_specification='')
-        try:
-            runner.start_proxy()
-            time.sleep(1)
-        finally:
-            runner.stop_proxy()
-        self.assertIsNone(runner.sql_proxy_process)
-
-    def test_start_proxy_with_all_instances_specific_version(self):
-        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + str(uuid1()),
-                                     project_id=PROJECT_ID,
-                                     instance_specification='',
-                                     sql_proxy_version='v1.13')
-        try:
-            runner.start_proxy()
-            time.sleep(1)
-        finally:
-            runner.stop_proxy()
-        self.assertIsNone(runner.sql_proxy_process)
-        self.assertEqual(runner.get_proxy_version(), "1.13")
-
-
-@unittest.skipIf(
-    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
-class CloudSqlExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
-    def __init__(self, method_name='runTest'):
-        super(CloudSqlExampleDagsIntegrationTest, self).__init__(
-            method_name,
-            dag_id='example_gcp_sql',
-            gcp_key=GCP_CLOUDSQL_KEY)
-
-    def test_run_example_dag_cloudsql_query(self):
-        self._run_dag()
-
-
-@unittest.skipIf(
-    BaseGcpIntegrationTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
-class CloudSqlQueryExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
-    def __init__(self, method_name='runTest'):
-        super(CloudSqlQueryExampleDagsIntegrationTest, self).__init__(
-            method_name,
-            dag_id='example_gcp_sql_query',
-            gcp_key=GCP_CLOUDSQL_KEY)
-
-    def test_run_example_dag_cloudsql_query(self):
-        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_sql_operator_system.py b/tests/contrib/operators/test_gcp_sql_operator_system.py
new file mode 100644
index 0000000000000..4fc7b56136cee
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_sql_operator_system.py
@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+import unittest
+
+from airflow import AirflowException
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.operators.test_gcp_sql_operator_system_helper import \
+    CloudSqlQueryTestHelper
+from tests.contrib.utils.gcp_authenticator import GCP_CLOUDSQL_KEY
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'project-id')
+
+SQL_QUERY_TEST_HELPER = CloudSqlQueryTestHelper()
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_CLOUDSQL_KEY), SKIP_TEST_WARNING)
+class CloudSqlExampleDagsIntegrationTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlExampleDagsIntegrationTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_sql',
+            gcp_key=GCP_CLOUDSQL_KEY)
+
+    def tearDown(self):
+        # Delete instances just in case the test failed and did not cleanup after itself
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            SQL_QUERY_TEST_HELPER.delete_instances()
+            SQL_QUERY_TEST_HELPER.delete_instances(instance_suffix="2")
+            SQL_QUERY_TEST_HELPER.delete_service_account_acls()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+        super(CloudSqlExampleDagsIntegrationTest, self).tearDown()
+
+    def test_run_example_dag_cloudsql(self):
+        try:
+            self._run_dag()
+        except AirflowException as e:
+            self.log.warning(
+                "In case you see 'The instance or operation is not in an appropriate "
+                "state to handle the request' error - you "
+                "can remove '.random' file from airflow folder and re-run "
+                "the test. This will generate random name of the database for next run "
+                "(the problem is that Cloud SQL keeps names of deleted instances in "
+                "short-term cache).")
+            raise e
diff --git a/tests/contrib/operators/test_gcp_sql_operator_system_helper.py b/tests/contrib/operators/test_gcp_sql_operator_system_helper.py
new file mode 100755
index 0000000000000..85974a9987d33
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_sql_operator_system_helper.py
@@ -0,0 +1,477 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import errno
+import json
+import os
+from os.path import expanduser
+
+import argparse
+from threading import Thread
+
+import time
+
+from six.moves.urllib.parse import urlsplit
+
+from tests.contrib.utils.base_gcp_system_test_case import RetrieveVariables
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_CLOUDSQL_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+retrieve_variables = RetrieveVariables()
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_LOCATION = os.environ.get('GCP_LOCATION', 'europe-west1')
+
+GCSQL_POSTGRES_SERVER_CA_FILE = os.environ.get('GCSQL_POSTGRES_SERVER_CA_FILE',
+                                               ".key/postgres-server-ca.pem")
+GCSQL_POSTGRES_CLIENT_CERT_FILE = os.environ.get('GCSQL_POSTGRES_CLIENT_CERT_FILE',
+                                                 ".key/postgres-client-cert.pem")
+GCSQL_POSTGRES_CLIENT_KEY_FILE = os.environ.get('GCSQL_POSTGRES_CLIENT_KEY_FILE',
+                                                ".key/postgres-client-key.pem")
+GCSQL_POSTGRES_PUBLIC_IP_FILE = os.environ.get('GCSQL_POSTGRES_PUBLIC_IP_FILE',
+                                               ".key/postgres-ip.env")
+GCSQL_POSTGRES_USER = os.environ.get('GCSQL_POSTGRES_USER', 'postgres_user')
+GCSQL_POSTGRES_DATABASE_NAME = os.environ.get('GCSQL_POSTGRES_DATABASE_NAME',
+                                              'postgresdb')
+GCSQL_MYSQL_CLIENT_CERT_FILE = os.environ.get('GCSQL_MYSQL_CLIENT_CERT_FILE',
+                                              ".key/mysql-client-cert.pem")
+GCSQL_MYSQL_CLIENT_KEY_FILE = os.environ.get('GCSQL_MYSQL_CLIENT_KEY_FILE',
+                                             ".key/mysql-client-key.pem")
+GCSQL_MYSQL_SERVER_CA_FILE = os.environ.get('GCSQL_MYSQL_SERVER_CA_FILE',
+                                            ".key/mysql-server-ca.pem")
+GCSQL_MYSQL_PUBLIC_IP_FILE = os.environ.get('GCSQL_MYSQL_PUBLIC_IP_FILE',
+                                            ".key/mysql-ip.env")
+GCSQL_MYSQL_USER = os.environ.get('GCSQL_MYSQL_USER', 'mysql_user')
+GCSQL_MYSQL_DATABASE_NAME = os.environ.get('GCSQL_MYSQL_DATABASE_NAME', 'mysqldb')
+
+GCSQL_MYSQL_EXPORT_URI = os.environ.get('GCSQL_MYSQL_EXPORT_URI',
+                                        'gs://bucketName/fileName')
+DB_VERSION_MYSQL = 'MYSQL_5_7'
+DV_VERSION_POSTGRES = 'POSTGRES_9_6'
+
+HOME_DIR = expanduser("~")
+
+
+def get_absolute_path(path):
+    if path.startswith("/"):
+        return path
+    else:
+        return os.path.join(HOME_DIR, path)
+
+
+server_ca_file_postgres = get_absolute_path(GCSQL_POSTGRES_SERVER_CA_FILE)
+client_cert_file_postgres = get_absolute_path(GCSQL_POSTGRES_CLIENT_CERT_FILE)
+client_key_file_postgres = get_absolute_path(GCSQL_POSTGRES_CLIENT_KEY_FILE)
+
+server_ca_file_mysql = get_absolute_path(GCSQL_MYSQL_SERVER_CA_FILE)
+client_cert_file_mysql = get_absolute_path(GCSQL_MYSQL_CLIENT_CERT_FILE)
+client_key_file_mysql = get_absolute_path(GCSQL_MYSQL_CLIENT_KEY_FILE)
+
+
+def get_postgres_instance_name(instance_suffix=''):
+    return os.environ.get('GCSQL_POSTGRES_INSTANCE_NAME' + instance_suffix,
+                          'testpostgres')
+
+
+def get_mysql_instance_name(instance_suffix=''):
+    return os.environ.get('GCSQL_MYSQL_INSTANCE_NAME' + instance_suffix,
+                          'testmysql')
+
+
+class CloudSqlQueryTestHelper(LoggingCommandExecutor):
+
+    def create_instances(self, instance_suffix=''):
+        thread_mysql = Thread(target=lambda: self.__create_instance(
+            get_mysql_instance_name(instance_suffix), DB_VERSION_MYSQL))
+        thread_postgres = Thread(target=lambda: self.__create_instance(
+            get_postgres_instance_name(instance_suffix), DV_VERSION_POSTGRES))
+        thread_mysql.start()
+        thread_postgres.start()
+        thread_mysql.join()
+        thread_postgres.join()
+
+    def delete_instances(self, instance_suffix=''):
+        thread_mysql = Thread(target=lambda: self.__delete_instance(
+            get_mysql_instance_name(instance_suffix)))
+        thread_postgres = Thread(target=lambda: self.__delete_instance(
+            get_postgres_instance_name(instance_suffix)))
+        thread_mysql.start()
+        thread_postgres.start()
+        thread_mysql.join()
+        thread_postgres.join()
+
+    def get_ip_addresses(self, instance_suffix):
+        with open(GCSQL_MYSQL_PUBLIC_IP_FILE, "w") as f:
+            ip = self.__get_ip_address(get_mysql_instance_name(instance_suffix),
+                                       'GCSQL_MYSQL_PUBLIC_IP')
+            f.write(ip)
+        with open(GCSQL_POSTGRES_PUBLIC_IP_FILE, "w") as f:
+            ip = self.__get_ip_address(get_postgres_instance_name(instance_suffix),
+                                       'GCSQL_POSTGRES_PUBLIC_IP')
+            f.write(ip)
+
+    def raise_database_exception(self, database):
+        raise Exception("The {database} instance does not exist. Make sure to run  "
+                        "`python {f} --action=before-tests` before running the test"
+                        " (and remember to run `python {f} --action=after-tests` "
+                        "after you are done."
+                        .format(f=__file__, database=database))
+
+    def check_if_instances_are_up(self, instance_suffix=''):
+        res_postgres = self.execute_cmd(
+            ['gcloud', 'sql', 'instances', 'describe',
+             get_postgres_instance_name(instance_suffix),
+             "--project={}".format(GCP_PROJECT_ID)])
+        if res_postgres != 0:
+            self.raise_database_exception('postgres')
+        res_postgres = self.execute_cmd(
+            ['gcloud', 'sql', 'instances', 'describe',
+             get_postgres_instance_name(instance_suffix),
+             "--project={}".format(GCP_PROJECT_ID)])
+        if res_postgres != 0:
+            self.raise_database_exception('mysql')
+
+    def authorize_address(self, instance_suffix=''):
+        ip = self.__get_my_public_ip()
+        self.log.info('Authorizing access from IP: %s', ip)
+        postgres_thread = Thread(target=lambda: self.execute_cmd(
+            ['gcloud', 'sql', 'instances', 'patch',
+             get_postgres_instance_name(instance_suffix), '--quiet',
+             "--authorized-networks={}".format(ip),
+             "--project={}".format(GCP_PROJECT_ID)]))
+        mysql_thread = Thread(target=lambda: self.execute_cmd(
+            ['gcloud', 'sql', 'instances', 'patch',
+             get_mysql_instance_name(instance_suffix), '--quiet',
+             "--authorized-networks={}".format(ip),
+             "--project={}".format(GCP_PROJECT_ID)]))
+        postgres_thread.start()
+        mysql_thread.start()
+        postgres_thread.join()
+        mysql_thread.join()
+
+    def setup_instances(self, instance_suffix=''):
+        mysql_thread = Thread(target=lambda: self.__setup_instance_and_certs(
+            get_mysql_instance_name(instance_suffix), DB_VERSION_MYSQL,
+            server_ca_file_mysql,
+            client_key_file_mysql, client_cert_file_mysql, GCSQL_MYSQL_DATABASE_NAME,
+            GCSQL_MYSQL_USER
+        ))
+        postgres_thread = Thread(target=lambda: self.__setup_instance_and_certs(
+            get_postgres_instance_name(instance_suffix), DV_VERSION_POSTGRES,
+            server_ca_file_postgres,
+            client_key_file_postgres, client_cert_file_postgres,
+            GCSQL_POSTGRES_DATABASE_NAME, GCSQL_POSTGRES_USER
+        ))
+        mysql_thread.start()
+        postgres_thread.start()
+        mysql_thread.join()
+        postgres_thread.join()
+        self.get_ip_addresses(instance_suffix)
+        self.authorize_address(instance_suffix)
+
+    def delete_service_account_acls(self):
+        self.__delete_service_accounts_acls()
+
+    def __create_instance(self, instance_name, db_version):
+        self.log.info('Creating a test %s instance "%s"...', db_version, instance_name)
+        try:
+            create_instance_opcode = self.__create_sql_instance(instance_name, db_version)
+            if create_instance_opcode:  # return code 1, some error occurred
+                operation_name = self.__get_operation_name(instance_name)
+                self.log.info('Waiting for operation: %s ...', operation_name)
+                self.__wait_for_create(operation_name)
+                self.log.info('... Done.')
+
+            self.log.info('... Done creating a test %s instance "%s"!\n',
+                          db_version, instance_name)
+        except Exception as ex:
+            self.log.error('Exception occurred. '
+                           'Aborting creating a test instance.\n\n%s', ex)
+            raise ex
+
+    def __delete_service_accounts_acls(self):
+        export_bucket_split = urlsplit(GCSQL_MYSQL_EXPORT_URI)
+        export_bucket_name = export_bucket_split[1]  # netloc (bucket)
+        self.log.info('Deleting temporary service accounts from bucket "%s"...',
+                      export_bucket_name)
+        all_permissions = self.check_output(['gsutil', 'iam', 'get',
+                                             "gs://{}".format(export_bucket_name),
+                                             "--project={}".format(GCP_PROJECT_ID)])
+        all_permissions_dejson = json.loads(all_permissions.decode("utf-8"))
+        for binding in all_permissions_dejson['bindings']:
+            if binding['role'] == 'roles/storage.legacyBucketWriter':
+                for member in binding['members']:
+                    if not member.startswith('serviceAccount:gcp-storage-account'):
+
+                        self.log.info("Remove member: {}".format(member))
+                        member_type, member_email = member.split(':')
+                        if member_type != 'serviceAccount':
+                            self.log.warning("Skip removing member {} as the type {} is "
+                                             "not service account".format(member,
+                                                                          member_type))
+                        self.execute_cmd(['gsutil', 'acl', 'ch', '-d', member_email,
+                                         "gs://{}".format(export_bucket_name)])
+                    else:
+                        self.log.info("Skip removing member {}".format(member))
+
+    @staticmethod
+    def set_ip_addresses_in_env():
+        CloudSqlQueryTestHelper.__set_ip_address_in_env(GCSQL_MYSQL_PUBLIC_IP_FILE)
+        CloudSqlQueryTestHelper.__set_ip_address_in_env(GCSQL_POSTGRES_PUBLIC_IP_FILE)
+
+    @staticmethod
+    def __set_ip_address_in_env(file_name):
+        if os.path.exists(file_name):
+            with open(file_name, "r") as f:
+                env, ip = f.read().split("=")
+                os.environ[env] = ip
+
+    def __setup_instance_and_certs(self, instance_name, db_version, server_ca_file,
+                                   client_key_file, client_cert_file, db_name,
+                                   db_username):
+        self.log.info('Setting up a test %s instance "%s"...', db_version, instance_name)
+        try:
+            self.__remove_keys_and_certs([server_ca_file, client_key_file,
+                                          client_cert_file])
+
+            self.__wait_for_operations(instance_name)
+            self.__write_to_file(server_ca_file, self.__get_server_ca_cert(instance_name))
+            client_cert_name = 'client-cert-name'
+            self.__wait_for_operations(instance_name)
+            self.__delete_client_cert(instance_name, client_cert_name)
+            self.__wait_for_operations(instance_name)
+            self.__create_client_cert(instance_name, client_key_file, client_cert_name)
+            self.__wait_for_operations(instance_name)
+            self.__write_to_file(client_cert_file,
+                                 self.__get_client_cert(instance_name, client_cert_name))
+            self.__wait_for_operations(instance_name)
+            self.__wait_for_operations(instance_name)
+            self.__create_user(instance_name, db_username)
+            self.__wait_for_operations(instance_name)
+            self.__delete_db(instance_name, db_name)
+            self.__create_db(instance_name, db_name)
+            self.log.info('... Done setting up a test %s instance "%s"!\n',
+                          db_version, instance_name)
+        except Exception as ex:
+            self.log.error('Exception occurred. '
+                           'Aborting setting up test instance and certs.\n\n%s', ex)
+            raise ex
+
+    def __delete_instance(self, instance_name):
+        # type: (str) -> None
+        self.log.info('Deleting Cloud SQL instance "%s"...', instance_name)
+        self.execute_cmd(['gcloud', 'sql', 'instances', 'delete',
+                          instance_name, '--quiet'])
+        self.log.info('... Done.')
+
+    def __get_my_public_ip(self):
+        return self.check_output(
+            ['curl', 'https://ipinfo.io/ip']).decode('utf-8').strip()
+
+    def __create_sql_instance(self, instance_name, db_version):
+        # type: (str, str) -> int
+        return self.execute_cmd(
+            ['gcloud', 'sql', 'instances', 'create', instance_name,
+             '--region', GCP_LOCATION,
+             '--project', GCP_PROJECT_ID,
+             '--database-version', db_version,
+             '--tier', 'db-f1-micro'])
+
+    def __get_server_ca_cert(self, instance_name):
+        # type: (str) -> bytes
+        self.log.info('Getting server CA cert for "%s"...', instance_name)
+        output = self.check_output(
+            ['gcloud', 'sql', 'instances', 'describe', instance_name,
+             '--format=value(serverCaCert.cert)'])
+        self.log.info('... Done.')
+        return output
+
+    def __get_client_cert(self, instance_name, client_cert_name):
+        # type: (str, str) -> bytes
+        self.log.info('Getting client cert for "%s"...', instance_name)
+        output = self.check_output(
+            ['gcloud', 'sql', 'ssl', 'client-certs', 'describe', client_cert_name, '-i',
+             instance_name, '--format=get(cert)'])
+        self.log.info('... Done.')
+        return output
+
+    def __create_user(self, instance_name, username):
+        # type: (str, str) -> None
+        self.log.info('Creating user "%s" in Cloud SQL instance "%s"...', username,
+                      instance_name)
+        self.execute_cmd(['gcloud', 'sql', 'users', 'create', username, '-i',
+                          instance_name, '--host', '%', '--password', 'JoxHlwrPzwch0gz9',
+                          '--quiet'])
+        self.log.info('... Done.')
+
+    def __delete_db(self, instance_name, db_name):
+        # type: (str, str) -> None
+        self.log.info('Deleting database "%s" in Cloud SQL instance "%s"...', db_name,
+                      instance_name)
+        self.execute_cmd(['gcloud', 'sql', 'databases', 'delete', db_name, '-i',
+                          instance_name, '--quiet'])
+        self.log.info('... Done.')
+
+    def __create_db(self, instance_name, db_name):
+        # type: (str, str) -> None
+        self.log.info('Creating database "%s" in Cloud SQL instance "%s"...', db_name,
+                      instance_name)
+        self.execute_cmd(['gcloud', 'sql', 'databases', 'create', db_name, '-i',
+                          instance_name, '--quiet'])
+        self.log.info('... Done.')
+
+    def __write_to_file(self, filepath, content):
+        # type: (str, bytes) -> None
+        # https://stackoverflow.com/a/12517490
+        self.log.info("Checking file under: %s", filepath)
+        if not os.path.exists(os.path.dirname(filepath)):
+            self.log.info("File doesn't exits. Creating dir...")
+            try:
+                os.makedirs(os.path.dirname(filepath))
+            except OSError as exc:  # Guard against race condition
+                self.log.info("Error while creating dir.")
+                if exc.errno != errno.EEXIST:
+                    raise
+        self.log.info("... Done. Dir created.")
+
+        with open(filepath, "w") as f:
+            f.write(str(content.decode('utf-8')))
+        self.log.info('Written file in: %s', filepath)
+
+    def __remove_keys_and_certs(self, filepaths):
+        if not len(filepaths):
+            return
+        self.log.info('Removing client keys and certs...')
+
+        for filepath in filepaths:
+            if os.path.exists(filepath):
+                os.remove(filepath)
+        self.log.info('Done ...')
+
+    def __delete_client_cert(self, instance_name, common_name):
+        self.log.info('Deleting client key and cert for "%s"...', instance_name)
+        self.execute_cmd(['gcloud', 'sql', 'ssl', 'client-certs', 'delete', common_name,
+                          '-i', instance_name, '--quiet'])
+        self.log.info('... Done.')
+
+    def __create_client_cert(self, instance_name, client_key_file, common_name):
+        self.log.info('Creating client key and cert for "%s"...', instance_name)
+        try:
+            os.remove(client_key_file)
+        except OSError:
+            pass
+        self.execute_cmd(['gcloud', 'sql', 'ssl', 'client-certs', 'create', common_name,
+                          client_key_file, '-i', instance_name])
+        self.log.info('... Done.')
+
+    def __get_operation_name(self, instance_name):
+        # type: (str) -> str
+        op_name_bytes = self.check_output(
+            ['gcloud', 'sql', 'operations', 'list', '-i',
+             instance_name, '--format=get(name)'])
+        return op_name_bytes.decode('utf-8').strip()
+
+    def __print_operations(self, operations):
+        self.log.info("\n==== OPERATIONS >>>>")
+        self.log.info(operations)
+        self.log.info("<<<< OPERATIONS ====\n")
+
+    def __wait_for_operations(self, instance_name):
+        # type: (str) -> None
+        while True:
+            operations = self.__get_operations(instance_name)
+            self.__print_operations(operations)
+            if "RUNNING" in operations:
+                self.log.info("Found a running operation. Sleeping 5s before retrying...")
+                time.sleep(5)
+            else:
+                break
+
+    def __get_ip_address(self, instance_name, env_var):
+        # type: (str, str) -> str
+        ip = self.check_output(
+            ['gcloud', 'sql', 'instances', 'describe',
+             instance_name,
+             '--format=get(ipAddresses[0].ipAddress)']
+        ).decode('utf-8').strip()
+        os.environ[env_var] = ip
+        return "{}={}".format(env_var, ip)
+
+    def __get_operations(self, instance_name):
+        # type: (str) -> str
+        op_name_bytes = self.check_output(
+            ['gcloud', 'sql', 'operations', 'list', '-i',
+             instance_name, '--format=get(NAME,TYPE,STATUS)'])
+        return op_name_bytes.decode('utf-8').strip()
+
+    def __wait_for_create(self, operation_name):
+        # type: (str) -> None
+        self.execute_cmd(['gcloud', 'beta', 'sql', 'operations', 'wait',
+                          '--project', GCP_PROJECT_ID, operation_name])
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description='Create or delete Cloud SQL instances for system tests.')
+    parser.add_argument('--action', required=True,
+                        choices=('create', 'delete', 'setup-instances',
+                                 'create2', 'delete2', 'setup-instances2',
+                                 'before-tests', 'after-tests',
+                                 'delete-service-accounts-acls'))
+    action = parser.parse_args().action
+
+    helper = CloudSqlQueryTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_CLOUDSQL_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'create':
+            helper.create_instances()
+        elif action == 'delete':
+            helper.delete_instances()
+        elif action == 'create2':
+            helper.create_instances(instance_suffix="2")
+        elif action == 'delete2':
+            helper.delete_instances(instance_suffix="2")
+        elif action == 'setup-instances':
+            helper.setup_instances()
+        elif action == 'setup-instances2':
+            helper.setup_instances(instance_suffix="2")
+        elif action == 'delete-service-accounts-acls':
+            helper.delete_service_account_acls()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcp_sql_operatorquery_system.py b/tests/contrib/operators/test_gcp_sql_operatorquery_system.py
new file mode 100644
index 0000000000000..4e216662f6c6c
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_sql_operatorquery_system.py
@@ -0,0 +1,146 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+import random
+import string
+import unittest
+from os.path import dirname
+
+import time
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlProxyRunner
+from tests.contrib.utils.base_gcp_system_test_case import BaseGcpSystemTestCase, \
+    DagGcpSystemTestCase
+from tests.contrib.operators.test_gcp_sql_operator_system_helper import \
+    CloudSqlQueryTestHelper
+from tests.contrib.utils.gcp_authenticator import GCP_CLOUDSQL_KEY
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'project-id')
+
+SKIP_CLOUDSQL_QUERY_WARNING = """
+    This test is skipped from automated runs intentionally
+    as creating databases in Google Cloud SQL takes a very
+    long time. You can still set GCP_ENABLE_CLOUDSQL_QUERY_TEST
+    environment variable to 'True' and then you should be able to
+    run it manually after you create the database
+    Creating the database can be done by running
+    `{}/test_gcp_sql_operatorquery_system_helper.py \
+--action=before-tests`
+    (you should remember to delete the database with --action=after-tests flag)
+""".format(dirname(__file__))
+
+GCP_ENABLE_CLOUDSQL_QUERY_TEST = os.environ.get('GCP_ENABLE_CLOUDSQL_QUERY_TEST')
+
+if GCP_ENABLE_CLOUDSQL_QUERY_TEST == 'True':
+    enable_cloudsql_query_test = True
+else:
+    enable_cloudsql_query_test = False
+
+
+SQL_QUERY_TEST_HELPER = CloudSqlQueryTestHelper()
+
+
+@unittest.skipIf(not enable_cloudsql_query_test, SKIP_CLOUDSQL_QUERY_WARNING)
+class CloudSqlProxySystemTest(BaseGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlProxySystemTest, self).__init__(
+            method_name,
+            gcp_key='gcp_cloudsql.json')
+
+    def setUp(self):
+        super(CloudSqlProxySystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        SQL_QUERY_TEST_HELPER.check_if_instances_are_up(instance_suffix="_QUERY")
+        self.gcp_authenticator.gcp_revoke_authentication()
+
+    @staticmethod
+    def generate_unique_path():
+        return ''.join(
+            random.choice(string.ascii_letters + string.digits) for _ in range(8))
+
+    def test_start_proxy_fail_no_parameters(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + self.generate_unique_path(),
+                                     project_id=GCP_PROJECT_ID,
+                                     instance_specification='a')
+        with self.assertRaises(AirflowException) as cm:
+            runner.start_proxy()
+        err = cm.exception
+        self.assertIn("invalid instance name", str(err))
+        with self.assertRaises(AirflowException) as cm:
+            runner.start_proxy()
+        err = cm.exception
+        self.assertIn("invalid instance name", str(err))
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + self.generate_unique_path(),
+                                     project_id=GCP_PROJECT_ID,
+                                     instance_specification='')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances_generated_credential_file(self):
+        self.gcp_authenticator.set_dictionary_in_airflow_connection()
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + self.generate_unique_path(),
+                                     project_id=GCP_PROJECT_ID,
+                                     instance_specification='')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+
+    def test_start_proxy_with_all_instances_specific_version(self):
+        runner = CloudSqlProxyRunner(path_prefix='/tmp/' + self.generate_unique_path(),
+                                     project_id=GCP_PROJECT_ID,
+                                     instance_specification='',
+                                     sql_proxy_version='v1.13')
+        try:
+            runner.start_proxy()
+            time.sleep(1)
+        finally:
+            runner.stop_proxy()
+        self.assertIsNone(runner.sql_proxy_process)
+        self.assertEqual(runner.get_proxy_version(), "1.13")
+
+
+@unittest.skipIf(not enable_cloudsql_query_test, SKIP_CLOUDSQL_QUERY_WARNING)
+class CloudSqlQueryExampleDagsSystemTest(DagGcpSystemTestCase):
+
+    def __init__(self, method_name='runTest'):
+        super(CloudSqlQueryExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcp_sql_query',
+            gcp_key=GCP_CLOUDSQL_KEY)
+
+    def setUp(self):
+        super(CloudSqlQueryExampleDagsSystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        SQL_QUERY_TEST_HELPER.check_if_instances_are_up(instance_suffix="_QUERY")
+        SQL_QUERY_TEST_HELPER.setup_instances(instance_suffix="_QUERY")
+        self.gcp_authenticator.gcp_revoke_authentication()
+
+    def test_run_example_dag_cloudsql_query(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_sql_operatorquery_system_helper.py b/tests/contrib/operators/test_gcp_sql_operatorquery_system_helper.py
new file mode 100755
index 0000000000000..d8bc5164c9dce
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_sql_operatorquery_system_helper.py
@@ -0,0 +1,59 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import argparse
+
+from tests.contrib.operators.test_gcp_sql_operator_system_helper \
+    import CloudSqlQueryTestHelper
+from tests.contrib.utils.gcp_authenticator import GCP_CLOUDSQL_KEY, GcpAuthenticator
+
+QUERY_SUFFIX = "_QUERY"
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description='Create or delete Cloud SQL instances for system tests.')
+    parser.add_argument('--action', required=True,
+                        choices=('create', 'delete', 'setup-instances',
+                                 'before-tests', 'after-tests'))
+    action = parser.parse_args().action
+
+    helper = CloudSqlQueryTestHelper()
+    gcp_authenticator = GcpAuthenticator(gcp_key=GCP_CLOUDSQL_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            helper.create_instances(instance_suffix=QUERY_SUFFIX)
+            helper.setup_instances(instance_suffix=QUERY_SUFFIX)
+        elif action == 'after-tests':
+            helper.delete_instances(instance_suffix=QUERY_SUFFIX)
+        elif action == 'create':
+            helper.create_instances(instance_suffix=QUERY_SUFFIX)
+        elif action == 'delete':
+            helper.delete_instances(instance_suffix=QUERY_SUFFIX)
+        elif action == 'setup-instances':
+            helper.setup_instances(instance_suffix=QUERY_SUFFIX)
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcs_acl_operator.py b/tests/contrib/operators/test_gcs_acl_operator.py
index 562c653574200..f428397e8bf1f 100644
--- a/tests/contrib/operators/test_gcs_acl_operator.py
+++ b/tests/contrib/operators/test_gcs_acl_operator.py
@@ -22,8 +22,6 @@
 from airflow.contrib.operators.gcs_acl_operator import \
     GoogleCloudStorageBucketCreateAclEntryOperator, \
     GoogleCloudStorageObjectCreateAclEntryOperator
-from tests.contrib.operators.test_gcp_base import BaseGcpIntegrationTestCase, \
-    SKIP_TEST_WARNING, GCP_GCS_KEY
 
 try:
     from unittest import mock
@@ -72,16 +70,3 @@ def test_object_create_acl(self, mock_hook):
             generation="test-generation",
             user_project="test-user-project"
         )
-
-
-@unittest.skipIf(
-    BaseGcpIntegrationTestCase.skip_check(GCP_GCS_KEY), SKIP_TEST_WARNING)
-class CloudStorageExampleDagsIntegrationTest(BaseGcpIntegrationTestCase):
-    def __init__(self, method_name='runTest'):
-        super(CloudStorageExampleDagsIntegrationTest, self).__init__(
-            method_name,
-            dag_id='example_gcs_acl',
-            gcp_key=GCP_GCS_KEY)
-
-    def test_run_example_dag_gcs_acl(self):
-        self._run_dag()
diff --git a/tests/contrib/operators/test_gcs_acl_operator_system.py b/tests/contrib/operators/test_gcs_acl_operator_system.py
new file mode 100644
index 0000000000000..0afddcbc9e5a7
--- /dev/null
+++ b/tests/contrib/operators/test_gcs_acl_operator_system.py
@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import \
+    SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.utils.gcp_authenticator import GCP_GCS_KEY
+
+
+@unittest.skipIf(
+    DagGcpSystemTestCase.skip_check(GCP_GCS_KEY), SKIP_TEST_WARNING)
+class CloudStorageExampleDagsSystemTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudStorageExampleDagsSystemTest, self).__init__(
+            method_name,
+            dag_id='example_gcs_acl',
+            gcp_key=GCP_GCS_KEY)
+
+    def test_run_example_dag_gcs_acl(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
index 0825364884a78..2eeae3a8a9971 100644
--- a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
@@ -35,7 +35,7 @@
 TASK_ID = 'test-s3-gcs-transfer-operator'
 S3_BUCKET = 'test-s3-bucket'
 GCS_BUCKET = 'test-gcs-bucket'
-PROJECT_ID = 'test-project'
+GCP_PROJECT_ID = 'test-project'
 DESCRIPTION = 'test-description'
 ACCESS_KEY = 'test-access-key'
 SECRET_KEY = 'test-secret-key'
@@ -57,7 +57,7 @@ def test_constructor(self):
             task_id=TASK_ID,
             s3_bucket=S3_BUCKET,
             gcs_bucket=GCS_BUCKET,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             description=DESCRIPTION,
             schedule=SCHEDULE,
         )
@@ -65,7 +65,7 @@ def test_constructor(self):
         self.assertEqual(operator.task_id, TASK_ID)
         self.assertEqual(operator.s3_bucket, S3_BUCKET)
         self.assertEqual(operator.gcs_bucket, GCS_BUCKET)
-        self.assertEqual(operator.project_id, PROJECT_ID)
+        self.assertEqual(operator.project_id, GCP_PROJECT_ID)
         self.assertEqual(operator.description, DESCRIPTION)
         self.assertEqual(operator.schedule, SCHEDULE)
 
@@ -78,7 +78,7 @@ def test_execute(self, mock_s3_hook, mock_transfer_hook):
             task_id=TASK_ID,
             s3_bucket=S3_BUCKET,
             gcs_bucket=GCS_BUCKET,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             description=DESCRIPTION,
             schedule=SCHEDULE,
         )
@@ -91,7 +91,7 @@ def test_execute(self, mock_s3_hook, mock_transfer_hook):
         operator.execute(None)
 
         mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             description=DESCRIPTION,
             schedule=SCHEDULE,
             transfer_spec={
@@ -123,7 +123,7 @@ def test_execute_skip_wait(self, mock_s3_hook, mock_transfer_hook):
             task_id=TASK_ID,
             s3_bucket=S3_BUCKET,
             gcs_bucket=GCS_BUCKET,
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             description=DESCRIPTION,
             wait=False,
         )
@@ -136,7 +136,7 @@ def test_execute_skip_wait(self, mock_s3_hook, mock_transfer_hook):
         operator.execute(None)
 
         mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=PROJECT_ID,
+            project_id=GCP_PROJECT_ID,
             description=DESCRIPTION,
             schedule=None,
             transfer_spec={
diff --git a/tests/contrib/utils/base_gcp_system_test_case.py b/tests/contrib/utils/base_gcp_system_test_case.py
new file mode 100644
index 0000000000000..03031a457ff62
--- /dev/null
+++ b/tests/contrib/utils/base_gcp_system_test_case.py
@@ -0,0 +1,259 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+import subprocess
+import unittest
+from glob import glob
+from shutil import move
+from tempfile import mkdtemp
+
+from airflow.utils import db as db_utils
+from airflow import models, settings, AirflowException, LoggingMixin
+from airflow.utils.timezone import datetime
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator
+from tests.contrib.utils.run_once_decorator import run_once
+
+AIRFLOW_MAIN_FOLDER = os.path.realpath(os.path.join(
+    os.path.dirname(os.path.realpath(__file__)),
+    os.pardir, os.pardir, os.pardir))
+
+AIRFLOW_PARENT_FOLDER = os.path.realpath(os.path.join(AIRFLOW_MAIN_FOLDER,
+                                                      os.pardir, os.pardir, os.pardir))
+ENV_FILE_RETRIEVER = os.path.join(AIRFLOW_PARENT_FOLDER,
+                                  "get_system_test_environment_variables.py")
+
+
+# Retrieve environment variables from parent directory retriever - it should be
+# in the path ${AIRFLOW_SOOURCE_DIR}/../../get_system_test_environment_variables.py
+# and it should print all the variables in form of key=value to the stdout
+class RetrieveVariables:
+    @staticmethod
+    @run_once
+    def retrieve_variables():
+        if os.path.isfile(ENV_FILE_RETRIEVER):
+            if os.environ.get('AIRFLOW__CORE__UNIT_TEST_MODE'):
+                raise Exception("Please unset the AIRFLOW__CORE__UNIT_TEST_MODE")
+            variables = subprocess.check_output([ENV_FILE_RETRIEVER]).decode("utf-8")
+            print("Applying variables retrieved")
+            for line in variables.split("\n"):
+                try:
+                    variable, key = line.split("=")
+                except ValueError:
+                    continue
+                print("{}={}".format(variable, key))
+                os.environ[variable] = key
+
+
+RetrieveVariables.retrieve_variables()
+
+DEFAULT_DATE = datetime(2015, 1, 1)
+
+CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
+    AIRFLOW_MAIN_FOLDER, "airflow", "contrib", "example_dags")
+
+OPERATORS_EXAMPLES_DAG_FOLDER = os.path.join(
+    AIRFLOW_MAIN_FOLDER, "airflow", "example_dags")
+
+AIRFLOW_HOME = os.environ.get('AIRFLOW_HOME',
+                              os.path.join(os.path.expanduser('~'), 'airflow'))
+
+DAG_FOLDER = os.path.join(AIRFLOW_HOME, "dags")
+
+
+SKIP_TEST_WARNING = """
+The test is only run when the test is run in with GCP-system-tests enabled
+environment. You can enable it in one of two ways:
+
+* Set GCP_CONFIG_DIR environment variable to point to the GCP configuration
+  directory which keeps variables.env file with environment variables to set
+  and keys directory which keeps service account keys in .json format
+* Run this test within automated environment variable workspace where
+  config directory is checked out next to the airflow one.
+
+""".format(__file__)
+
+
+class BaseGcpSystemTestCase(unittest.TestCase, LoggingMixin):
+    def __init__(self,
+                 method_name,
+                 gcp_key,
+                 project_extra=None):
+        super(BaseGcpSystemTestCase, self).__init__(methodName=method_name)
+        self.gcp_authenticator = GcpAuthenticator(gcp_key=gcp_key,
+                                                  project_extra=project_extra)
+        self.setup_called = False
+
+    @staticmethod
+    def skip_check(key_name):
+        return GcpAuthenticator(key_name).full_key_path is None
+
+    def setUp(self):
+        self.gcp_authenticator.gcp_store_authentication()
+        self.gcp_authenticator.gcp_authenticate()
+        # We checked that authentication works. Ne we revoke it to make
+        # sure we are not relying on the default authentication
+        self.gcp_authenticator.gcp_revoke_authentication()
+        self.setup_called = True
+
+    # noinspection PyPep8Naming
+    def tearDown(self):
+        self.gcp_authenticator.gcp_restore_authentication()
+
+
+class DagGcpSystemTestCase(BaseGcpSystemTestCase):
+    def __init__(self,
+                 method_name,
+                 dag_id,
+                 gcp_key,
+                 dag_name=None,
+                 require_local_executor=False,
+                 example_dags_folder=CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER,
+                 project_extra=None):
+        super(DagGcpSystemTestCase, self).__init__(method_name=method_name,
+                                                   gcp_key=gcp_key,
+                                                   project_extra=project_extra)
+        self.dag_id = dag_id
+        self.dag_name = self.dag_id + '.py' if not dag_name else dag_name
+        self.example_dags_folder = example_dags_folder
+        self.require_local_executor = require_local_executor
+        self.temp_dir = None
+
+    @staticmethod
+    def _get_dag_folder():
+        return DAG_FOLDER
+
+    @staticmethod
+    def _get_files_to_link(path):
+        """
+        Returns all file names (note - file names not paths)
+        that have the same base name as the .py dag file (for example dag_name.sql etc.)
+        :param path: path to the dag file.
+        :return: list of files matching the base name
+        """
+        prefix, ext = os.path.splitext(path)
+        assert ext == '.py', "Dag name should be a .py file and is {} file".format(ext)
+        files_to_link = []
+        for file in glob(prefix + ".*"):
+            files_to_link.append(os.path.basename(file))
+        return files_to_link
+
+    def _symlink_dag_and_associated_files(self, remove=False):
+        target_folder = self._get_dag_folder()
+        source_path = os.path.join(self.example_dags_folder, self.dag_name)
+        for file_name in self._get_files_to_link(source_path):
+            source_path = os.path.join(self.example_dags_folder, file_name)
+            target_path = os.path.join(target_folder, file_name)
+            if remove:
+                try:
+                    self.log.info("Remove symlink: {} -> {} ".format(
+                        target_path, source_path))
+                    os.remove(target_path)
+                except OSError:
+                    pass
+            else:
+                if not os.path.exists(target_path):
+                    self.log.info("Symlink: {} -> {} ".format(target_path, source_path))
+                    os.symlink(source_path, target_path)
+                else:
+                    self.log.info("Symlink {} already exists. Not symlinking it.".
+                                  format(target_path))
+
+    def _store_dags_to_temporary_directory(self):
+        dag_folder = self._get_dag_folder()
+        self.temp_dir = mkdtemp()
+        self.log.info("Storing DAGS from {} to temporary directory {}".
+                      format(dag_folder, self.temp_dir))
+        try:
+            os.mkdir(dag_folder)
+        except OSError:
+            pass
+        for file in os.listdir(dag_folder):
+            move(os.path.join(dag_folder, file), os.path.join(self.temp_dir, file))
+
+    def _restore_dags_from_temporary_directory(self):
+        dag_folder = self._get_dag_folder()
+        self.log.info("Restoring DAGS to {} from temporary directory {}"
+                      .format(dag_folder, self.temp_dir))
+        for file in os.listdir(self.temp_dir):
+            move(os.path.join(self.temp_dir, file), os.path.join(dag_folder, file))
+
+    def _run_dag(self):
+        self.log.info("Attempting to run DAG: {}".format(self.dag_id))
+        if not self.setup_called:
+            raise AirflowException("Please make sure to call super.setUp() in your "
+                                   "test class!")
+        dag_folder = self._get_dag_folder()
+        dag_bag = models.DagBag(dag_folder=dag_folder, include_examples=False)
+        self.args = {'owner': 'airflow', 'start_date': DEFAULT_DATE}
+        dag = dag_bag.get_dag(self.dag_id)
+        if dag is None:
+            raise AirflowException(
+                "The Dag {} could not be found. It's either an import problem or "
+                "the dag {} was not symlinked to the DAGs folder. "
+                "The content of the {} folder is {}".
+                format(self.dag_id,
+                       self.dag_id + ".py",
+                       dag_folder,
+                       os.listdir(dag_folder)))
+        dag.clear(reset_dag_runs=True)
+        dag.run(ignore_first_depends_on_past=True, verbose=True)
+
+    @staticmethod
+    def _check_local_executor_setup():
+        postgres_path = os.path.realpath(os.path.join(
+            AIRFLOW_MAIN_FOLDER,
+            "tests", "contrib", "operators", "postgres_local_executor.cfg"))
+        if postgres_path != os.environ.get('AIRFLOW_CONFIG'):
+            raise AirflowException(
+                """
+Please set AIRFLOW_CONFIG variable to '{}'
+and make sure you have a Postgres server running locally and
+airflow/airflow.db database created.
+
+You can create the database via these commands:
+'createuser root'
+'createdb airflow/airflow.db`
+
+""".format(postgres_path))
+
+    # noinspection PyPep8Naming
+    def setUp(self):
+        if self.require_local_executor:
+            self._check_local_executor_setup()
+        try:
+            # We want to avoid random errors while database got reset - those
+            # Are apparently triggered by parser trying to parse DAGs while
+            # The tables are dropped. We move the dags temporarily out of the dags folder
+            # and move them back after reset
+            self._store_dags_to_temporary_directory()
+            try:
+                db_utils.resetdb(settings.RBAC)
+            finally:
+                self._restore_dags_from_temporary_directory()
+            self._symlink_dag_and_associated_files()
+            super(DagGcpSystemTestCase, self).setUp()
+
+        except Exception as e:
+            # In case of any error during setup - restore the authentication
+            self.gcp_authenticator.gcp_restore_authentication()
+            raise e
+
+    def tearDown(self):
+        self._symlink_dag_and_associated_files(remove=True)
+        super(DagGcpSystemTestCase, self).tearDown()
diff --git a/tests/contrib/utils/gcp_authenticator.py b/tests/contrib/utils/gcp_authenticator.py
new file mode 100644
index 0000000000000..b26f23f9c7a8d
--- /dev/null
+++ b/tests/contrib/utils/gcp_authenticator.py
@@ -0,0 +1,209 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import json
+import os
+import subprocess
+
+from airflow import settings, AirflowException
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+from airflow.models.connection import Connection
+
+GCP_COMPUTE_KEY = 'gcp_compute.json'
+GCP_FUNCTION_KEY = 'gcp_function.json'
+GCP_CLOUDSQL_KEY = 'gcp_cloudsql.json'
+GCP_BIGTABLE_KEY = 'gcp_bigtable.json'
+GCP_SPANNER_KEY = 'gcp_spanner.json'
+GCP_GCS_KEY = 'gcp_gcs.json'
+
+KEYPATH_EXTRA = 'extra__google_cloud_platform__key_path'
+KEYFILE_DICT_EXTRA = 'extra__google_cloud_platform__keyfile_dict'
+SCOPE_EXTRA = 'extra__google_cloud_platform__scope'
+PROJECT_EXTRA = 'extra__google_cloud_platform__project'
+
+AIRFLOW_MAIN_FOLDER = os.path.realpath(os.path.join(
+    os.path.dirname(os.path.realpath(__file__)),
+    os.pardir, os.pardir, os.pardir))
+
+
+class GcpAuthenticator(LoggingCommandExecutor):
+    """
+    Manages authentication to Google Cloud Platform. It helps to manage
+    connection - it can authenticate with the gcp key name specified
+    """
+    original_account = None
+
+    def __init__(self, gcp_key, project_extra=None):
+        """
+        Initialises the authenticator.
+
+        :param gcp_key: name of the key to use for authentication (see GCP_*_KEY values)
+        :param project_extra: optional extra project parameter passed to google cloud
+               connection
+        """
+        super(GcpAuthenticator, self).__init__()
+        self.gcp_key = gcp_key
+        self.project_extra = project_extra
+        self.project_id = self.get_project_id()
+        self.full_key_path = None
+        self._set_key_path()
+
+    @staticmethod
+    def get_project_id():
+        return os.environ.get('GCP_PROJECT_ID')
+
+    def set_key_path_in_airflow_connection(self):
+        """
+        Set key path in 'google_cloud_default' connection to point to the full
+        key path
+        :return: None
+        """
+        session = settings.Session()
+        try:
+            conn = session.query(Connection).filter(
+                Connection.conn_id == 'google_cloud_default')[0]
+            extras = conn.extra_dejson
+            extras[KEYPATH_EXTRA] = self.full_key_path
+            if extras.get(KEYFILE_DICT_EXTRA):
+                del extras[KEYFILE_DICT_EXTRA]
+            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
+            extras[PROJECT_EXTRA] = self.project_extra if self.project_extra else \
+                self.project_id
+            conn.extra = json.dumps(extras)
+            session.commit()
+        except BaseException as ex:
+            self.log.info('Airflow DB Session error:' + str(ex))
+            session.rollback()
+            raise
+        finally:
+            session.close()
+
+    def set_dictionary_in_airflow_connection(self):
+        """
+        Set dictionary in 'google_cloud_default' connection to contain content
+        of the json service account file.
+        :return: None
+        """
+        session = settings.Session()
+        try:
+            conn = session.query(Connection).filter(
+                Connection.conn_id == 'google_cloud_default')[0]
+            extras = conn.extra_dejson
+            with open(self.full_key_path, "r") as path_file:
+                content = json.load(path_file)
+            extras[KEYFILE_DICT_EXTRA] = json.dumps(content)
+            if extras.get(KEYPATH_EXTRA):
+                del extras[KEYPATH_EXTRA]
+            extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
+            extras[PROJECT_EXTRA] = self.project_extra
+            conn.extra = json.dumps(extras)
+            session.commit()
+        except BaseException as ex:
+            self.log.info('Airflow DB Session error:' + str(ex))
+            session.rollback()
+            raise
+        finally:
+            session.close()
+
+    def _set_key_path(self):
+        """
+        Sets full key path - if GCP_CONFIG_DIR points to absolute
+            directory, it tries to find the key in this directory. Otherwise it assumes
+            that Airflow is run from directory where configuration i checked out
+            next to airflow directory in config directory
+            it tries to find the key folder in the workspace's config
+            directory.
+        :param : name of the key file to find.
+        """
+        if "GCP_CONFIG_DIR" in os.environ:
+            gcp_config_dir = os.environ["GCP_CONFIG_DIR"]
+        else:
+            gcp_config_dir = os.path.join(AIRFLOW_MAIN_FOLDER,
+                                          os.pardir,
+                                          "config")
+        if not os.path.isdir(gcp_config_dir):
+            self.log.info("The {} is not a directory".format(gcp_config_dir))
+        key_dir = os.path.join(gcp_config_dir, "keys")
+        if not os.path.isdir(key_dir):
+            self.log.info("The {} is not a directory".format(key_dir))
+            return
+        key_path = os.path.join(key_dir, self.gcp_key)
+        if not os.path.isfile(key_path):
+            self.log.info("The {} is missing".format(key_path))
+        self.full_key_path = key_path
+
+    def _validate_key_set(self):
+        if self.full_key_path is None:
+            raise AirflowException("The gcp_key is not set!")
+        if not os.path.isfile(self.full_key_path):
+            raise AirflowException(
+                "The key {} could not be found. Please copy it to the {} path.".
+                format(self.gcp_key, self.full_key_path))
+
+    def gcp_authenticate(self):
+        """
+        Authenticate with service account specified via key name.
+        """
+        self._validate_key_set()
+        self.log.info("Setting the GCP key to {}".format(self.full_key_path))
+        # Checking if we can authenticate using service account credentials provided
+        self.execute_cmd(
+            ['gcloud', 'auth', 'activate-service-account',
+             '--key-file={}'.format(self.full_key_path),
+             '--project={}'.format(self.project_id)])
+        self.set_key_path_in_airflow_connection()
+
+    def gcp_revoke_authentication(self):
+        """
+        Change default authentication to none - which is not existing one.
+        """
+        self._validate_key_set()
+        self.log.info("Revoking authentication - setting it to none")
+        self.execute_cmd(
+            ['gcloud', 'config', 'get-value', 'account',
+             '--project={}'.format(self.project_id)])
+        self.execute_cmd(['gcloud', 'config', 'set', 'account', 'none',
+                          '--project={}'.format(self.project_id)])
+
+    def gcp_store_authentication(self):
+        """
+        Store authentication as it was originally so it can be restored and revoke
+        authentication.
+        """
+        self._validate_key_set()
+        if not GcpAuthenticator.original_account:
+            GcpAuthenticator.original_account = self.check_output(
+                ['gcloud', 'config', 'get-value', 'account',
+                 '--project={}'.format(self.project_id)]).decode('utf-8')
+            self.log.info("Storing account: to restore it later {}".format(
+                GcpAuthenticator.original_account))
+
+    def gcp_restore_authentication(self):
+        """
+        Restore authentication to the original one one.
+        """
+        self._validate_key_set()
+        if GcpAuthenticator.original_account:
+            self.log.info("Restoring original account stored: {}".
+                          format(GcpAuthenticator.original_account))
+            subprocess.call(['gcloud', 'config', 'set', 'account',
+                             GcpAuthenticator.original_account,
+                             '--project={}'.format(self.project_id)])
+        else:
+            self.log.info("Not restoring the original GCP account: it is not set")
diff --git a/tests/contrib/utils/logging_command_executor.py b/tests/contrib/utils/logging_command_executor.py
new file mode 100644
index 0000000000000..e0833f4a77b9e
--- /dev/null
+++ b/tests/contrib/utils/logging_command_executor.py
@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+import subprocess
+
+from airflow import LoggingMixin, AirflowException
+
+
+class LoggingCommandExecutor(LoggingMixin):
+
+    def execute_cmd(self, cmd, silent=False):
+        if silent:
+            self.log.info("Executing in silent mode: '{}'".format(" ".join(cmd)))
+            with open(os.devnull, 'w') as FNULL:
+                return subprocess.call(args=cmd, stdout=FNULL, stderr=subprocess.STDOUT)
+        else:
+            self.log.info("Executing: '{}'".format(" ".join(cmd)))
+            process = subprocess.Popen(args=cmd, stdout=subprocess.PIPE,
+                                       stderr=subprocess.PIPE, universal_newlines=True)
+            output, err = process.communicate()
+            retcode = process.poll()
+            self.log.info("Stdout: {}".format(output))
+            self.log.info("Stderr: {}".format(err))
+            if retcode:
+                print("Error when executing '{}'".format(" ".join(cmd)))
+            return retcode
+
+    def check_output(self, cmd):
+        self.log.info("Executing for output: '{}'".format(" ".join(cmd)))
+        process = subprocess.Popen(args=cmd, stdout=subprocess.PIPE,
+                                   stderr=subprocess.PIPE)
+        output, err = process.communicate()
+        retcode = process.poll()
+        if retcode:
+            self.log.info("Error when executing '{}'".format(" ".join(cmd)))
+            self.log.info("Stdout: {}".format(output))
+            self.log.info("Stderr: {}".format(err))
+            raise AirflowException("Retcode {} on {} with stdout: {}, stderr: {}".
+                                   format(retcode, " ".join(cmd), output, err))
+        return output
diff --git a/tests/contrib/utils/run_once_decorator.py b/tests/contrib/utils/run_once_decorator.py
new file mode 100644
index 0000000000000..934250ec2ffa7
--- /dev/null
+++ b/tests/contrib/utils/run_once_decorator.py
@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from functools import wraps
+
+
+def run_once(f):
+    """Runs a function (successfully) only once.
+    The running can be reset by setting the `has_run` attribute to False
+    """
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        if not wrapper.has_run:
+            result = f(*args, **kwargs)
+            wrapper.has_run = True
+            return result
+    wrapper.has_run = False
+    return wrapper
diff --git a/tests/dags/.gitignore b/tests/dags/.gitignore
index beddda487f386..30db57ad4bacb 100644
--- a/tests/dags/.gitignore
+++ b/tests/dags/.gitignore
@@ -1,5 +1,4 @@
 # This line is to avoid accidental commits of example dags for integration testing
 # In order to test example dags easily we often create symbolic links in this directory
-# and run the Airflow with AIRFLOW__CORE__UNIT_TEST_MODE=True
 # this line prevents accidental commiting of such symbolic links
 example_*

From 99fea9381e78b30e7af0eb1879212beebf49bde0 Mon Sep 17 00:00:00 2001
From: aoen <aoen@users.noreply.github.com>
Date: Sat, 12 Jan 2019 15:59:40 +0200
Subject: [PATCH 407/808] [AIRFLOW-3191] Fix not being able to specify
 execution_date when creating dagrun (#4037)

---
 airflow/www/views.py | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index c81c1941f39cd..7efa144db89c4 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2670,9 +2670,18 @@ class DagRunModelView(ModelViewOnly):
             ('failed', 'failed'),
         ],
     }
-    form_args = dict(
-        dag_id=dict(validators=[validators.DataRequired()])
-    )
+    form_args = {
+        'dag_id': {
+            'validators': [
+                validators.DataRequired(),
+            ]
+        },
+        'execution_date': {
+            'filters': [
+                parse_datetime_f,
+            ]
+        }
+    }
     column_list = (
         'state', 'dag_id', 'execution_date', 'run_id', 'external_trigger')
     column_filters = column_list
@@ -2685,6 +2694,7 @@ class DagRunModelView(ModelViewOnly):
         dag_id=dag_link,
         run_id=dag_run_link
     )
+    form_overrides = dict(execution_date=DateTimeField)
 
     @action('new_delete', "Delete", "Are you sure you want to delete selected records?")
     @provide_session

From 6e8708c45c45ea2329efa53785e031e3efdd9731 Mon Sep 17 00:00:00 2001
From: XD-DENG <xd_deng@hotmail.com>
Date: Sun, 9 Sep 2018 21:06:51 +0800
Subject: [PATCH 408/808] [AIRFLOW-2965] CLI tool to show the next execution
 datetime (#3834)

---
 airflow/bin/cli.py    | 30 ++++++++++++++++
 tests/cli/test_cli.py | 80 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 110 insertions(+)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index d8afc00b038c6..35c3537a4516e 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -589,6 +589,31 @@ def dag_state(args):
     print(dr[0].state if len(dr) > 0 else None)
 
 
+@cli_utils.action_logging
+def next_execution(args):
+    """
+    Returns the next execution datetime of a DAG at the command line.
+    >>> airflow next_execution tutorial
+    2018-08-31 10:38:00
+    """
+    dag = get_dag(args)
+
+    if dag.is_paused:
+        print("[INFO] Please be reminded this DAG is PAUSED now.")
+
+    if dag.latest_execution_date:
+        next_execution_dttm = dag.following_schedule(dag.latest_execution_date)
+
+        if next_execution_dttm is None:
+            print("[WARN] No following schedule can be found. " +
+                  "This DAG may have schedule interval '@once' or `None`.")
+
+        print(next_execution_dttm)
+    else:
+        print("[WARN] Only applicable when there is execution record found for the DAG.")
+        print(None)
+
+
 @cli_utils.action_logging
 def list_dags(args):
     dagbag = DagBag(process_subdir(args.subdir))
@@ -2058,6 +2083,11 @@ class CLIFactory(object):
             'func': sync_perm,
             'help': "Update existing role's permissions.",
             'args': tuple(),
+        },
+        {
+            'func': next_execution,
+            'help': "Get the next execution datetime of a DAG.",
+            'args': ('dag_id', 'subdir')
         }
     )
     subparsers_dict = {sp['func'].__name__: sp for sp in subparsers}
diff --git a/tests/cli/test_cli.py b/tests/cli/test_cli.py
index 81a0a16bda2e9..f274fe907daf1 100644
--- a/tests/cli/test_cli.py
+++ b/tests/cli/test_cli.py
@@ -22,9 +22,12 @@
 import sys
 import unittest
 
+from datetime import datetime, timedelta, time
 from mock import patch, Mock, MagicMock
 from time import sleep
 import psutil
+import pytz
+import subprocess
 from argparse import Namespace
 from airflow import settings
 import airflow.bin.cli as cli
@@ -205,3 +208,80 @@ def test_test(self):
                           output)
         finally:
             sys.stdout = saved_stdout
+
+    def test_next_execution(self):
+        # A scaffolding function
+        def reset_dr_db(dag_id):
+            session = Session()
+            dr = session.query(models.DagRun).filter_by(dag_id=dag_id)
+            dr.delete()
+            session.commit()
+            session.close()
+
+        EXAMPLE_DAGS_FOLDER = os.path.join(
+            os.path.dirname(
+                os.path.dirname(
+                    os.path.dirname(os.path.realpath(__file__))
+                )
+            ),
+            "airflow/example_dags"
+        )
+
+        dagbag = models.DagBag(dag_folder=EXAMPLE_DAGS_FOLDER,
+                               include_examples=False)
+        dag_ids = ['example_bash_operator',  # schedule_interval is '0 0 * * *'
+                   'latest_only',  # schedule_interval is timedelta(hours=4)
+                   'example_python_operator',  # schedule_interval=None
+                   'example_xcom']  # schedule_interval="@once"
+
+        # The details below is determined by the schedule_interval of example DAGs
+        now = timezone.utcnow()
+        next_execution_time_for_dag1 = pytz.utc.localize(
+            datetime.combine(
+                now.date() + timedelta(days=1),
+                time(0)
+            )
+        )
+        next_execution_time_for_dag2 = now + timedelta(hours=4)
+        expected_output = [str(next_execution_time_for_dag1),
+                           str(next_execution_time_for_dag2),
+                           "None",
+                           "None"]
+
+        for i in range(len(dag_ids)):
+            dag_id = dag_ids[i]
+
+            # Clear dag run so no execution history fo each DAG
+            reset_dr_db(dag_id)
+
+            p = subprocess.Popen(["airflow", "next_execution", dag_id,
+                                  "--subdir", EXAMPLE_DAGS_FOLDER],
+                                 stdout=subprocess.PIPE)
+            p.wait()
+            stdout = []
+            for line in p.stdout:
+                stdout.append(str(line.decode("utf-8").rstrip()))
+
+            # `next_execution` function is inapplicable if no execution record found
+            # It prints `None` in such cases
+            self.assertEqual(stdout[-1], "None")
+
+            dag = dagbag.dags[dag_id]
+            # Create a DagRun for each DAG, to prepare for next step
+            dag.create_dagrun(
+                run_id='manual__' + now.isoformat(),
+                execution_date=now,
+                start_date=now,
+                state=State.FAILED
+            )
+
+            p = subprocess.Popen(["airflow", "next_execution", dag_id,
+                                  "--subdir", EXAMPLE_DAGS_FOLDER],
+                                 stdout=subprocess.PIPE)
+            p.wait()
+            stdout = []
+            for line in p.stdout:
+                stdout.append(str(line.decode("utf-8").rstrip()))
+            self.assertEqual(stdout[-1], expected_output[i])
+
+            reset_dr_db(dag_id)

From b684934949b6213ba0f78383e5ec7d9752e63885 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 5 Jan 2019 16:32:12 +0000
Subject: [PATCH 409/808] [AIRFLOW-3612] Remove remaining incubator mention &
 Fix CI Behaviour (#4441)

---
 scripts/ci/5-run-tests.sh            | 13 +++++++------
 scripts/ci/kubernetes/kube/deploy.sh |  2 +-
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/scripts/ci/5-run-tests.sh b/scripts/ci/5-run-tests.sh
index 1bd33755bf151..436b0ab4ba558 100755
--- a/scripts/ci/5-run-tests.sh
+++ b/scripts/ci/5-run-tests.sh
@@ -19,6 +19,7 @@
 #  under the License.
 
 set -o verbose
+set -e
 
 if [ -z "$HADOOP_HOME" ]; then
     echo "HADOOP_HOME not set - abort" >&2
@@ -61,6 +62,12 @@ which airflow > /dev/null || python setup.py develop
 # (which contains /usr/local/bin)
 sudo ln -sf "${VIRTUAL_ENV}/bin/airflow" /usr/local/bin/
 
+# Fix codecov build path
+if [ ! -h /home/travis/build/apache/airflow ]; then
+  sudo mkdir -p /home/travis/build/apache
+  sudo ln -s ${ROOTDIR} /home/travis/build/apache/airflow
+fi
+
 if [ -z "$KUBERNETES_VERSION" ]; then
   echo "Initializing the DB"
   yes | airflow initdb
@@ -97,11 +104,5 @@ fi
 echo "Starting the unit tests with the following nose arguments: "$nose_args
 nosetests $nose_args
 
-# Fix codecov build path
-if [ ! -h /home/travis/build/apache/incubator-airflow ]; then
-  sudo mkdir -p /home/travis/build/apache
-  sudo ln -s ${ROOTDIR} /home/travis/build/apache/incubator-airflow
-fi
-
 # To run individual tests:
 # nosetests tests.core:CoreTest.test_scheduler_job
diff --git a/scripts/ci/kubernetes/kube/deploy.sh b/scripts/ci/kubernetes/kube/deploy.sh
index abbf4f8d0ff06..6883c301a0539 100755
--- a/scripts/ci/kubernetes/kube/deploy.sh
+++ b/scripts/ci/kubernetes/kube/deploy.sh
@@ -81,7 +81,7 @@ else
     CONFIGMAP_GIT_DAGS_FOLDER_MOUNT_POINT=/root/airflow/dags
     CONFIGMAP_DAGS_VOLUME_CLAIM=
 fi
-CONFIGMAP_GIT_REPO=${TRAVIS_REPO_SLUG:-apache/incubator-airflow}
+CONFIGMAP_GIT_REPO=${TRAVIS_REPO_SLUG:-apache/airflow}
 CONFIGMAP_BRANCH=${TRAVIS_BRANCH:-master}
 
 _UNAME_OUT=$(uname -s)

From 1bc034df823165847101d5af1e21ca18503f73d5 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Sat, 5 Jan 2019 06:10:31 -0800
Subject: [PATCH 410/808] [AIRFLOW-XXX] Update committer list based on latest
 TLP discussion (#4427)

---
 docs/project.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/project.rst b/docs/project.rst
index 1f37ca2a2b42b..2554702a8a1e0 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -37,9 +37,7 @@ Committers
 - @bolkedebruin (Bolke de Bruin)
 - @artwr (Arthur Wiedmer)
 - @jlowin (Jeremiah Lowin)
-- @patrickleotardif (Patrick Leo Tardif)
 - @aoen (Dan Davydov)
-- @syvineckruyk (Steven Yvinec-Kruyk)
 - @msumit (Sumit Maheshwari)
 - @alexvanboxel (Alex Van Boxel)
 - @saguziel (Alex Guziel)
@@ -47,6 +45,9 @@ Committers
 - @fokko (Fokko Driesprong)
 - @ash (Ash Berlin-Taylor)
 - @kaxilnaik (Kaxil Naik)
+- @feng-tao (Tao Feng)
+- @hiteshs (Hitesh Shah)
+- @jghoman (Jakob Homan)
 
 For the full list of contributors, take a look at `Airflow's Github
 Contributor page:

From 86fd1c9c856bd9cc2624b4939c51e10f77594d7b Mon Sep 17 00:00:00 2001
From: yrqls21 <yrqls21@gmail.com>
Date: Wed, 1 Aug 2018 01:31:30 -0700
Subject: [PATCH 411/808] [AIRFLOW-2756] Fix bug in set DAG run state workflow
 (#3606)

---
 airflow/api/common/experimental/mark_tasks.py |  5 ++-
 airflow/jobs.py                               |  3 +-
 airflow/www/views.py                          |  3 +-
 tests/api/common/experimental/mark_tasks.py   | 31 +++++++++++++++++++
 4 files changed, 38 insertions(+), 4 deletions(-)

diff --git a/airflow/api/common/experimental/mark_tasks.py b/airflow/api/common/experimental/mark_tasks.py
index 681864dfbeb3e..88c5275f5a4e8 100644
--- a/airflow/api/common/experimental/mark_tasks.py
+++ b/airflow/api/common/experimental/mark_tasks.py
@@ -206,7 +206,10 @@ def _set_dag_run_state(dag_id, execution_date, state, session=None):
         DR.execution_date == execution_date
     ).one()
     dr.state = state
-    dr.end_date = timezone.utcnow()
+    if state == State.RUNNING:
+        dr.start_date = timezone.utcnow()
+    else:
+        dr.end_date = timezone.utcnow()
     session.commit()
 
 
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 58d142233dc41..3c2afee1f0860 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1010,8 +1010,7 @@ def _change_state_for_tis_without_dagrun(self,
                     models.TaskInstance.dag_id == subq.c.dag_id,
                     models.TaskInstance.task_id == subq.c.task_id,
                     models.TaskInstance.execution_date ==
-                    subq.c.execution_date,
-                    models.TaskInstance.task_id == subq.c.task_id)) \
+                    subq.c.execution_date)) \
                 .update({models.TaskInstance.state: new_state},
                         synchronize_session=False)
             session.commit()
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 7efa144db89c4..9d6df65e022a4 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2793,7 +2793,8 @@ def after_model_change(self, form, dagrun, is_created, session=None):
             altered_tis = set_dag_run_state_to_success(
                 dagbag.get_dag(dagrun.dag_id),
                 dagrun.execution_date,
-                commit=True)
+                commit=True,
+                session=session)
         elif dagrun.state == State.FAILED:
             altered_tis = set_dag_run_state_to_failed(
                 dagbag.get_dag(dagrun.dag_id),
diff --git a/tests/api/common/experimental/mark_tasks.py b/tests/api/common/experimental/mark_tasks.py
index 4bf625999fc8c..304e261b980bd 100644
--- a/tests/api/common/experimental/mark_tasks.py
+++ b/tests/api/common/experimental/mark_tasks.py
@@ -266,11 +266,25 @@ def _create_test_dag_run(self, state, date):
     def _verify_dag_run_state(self, dag, date, state):
         drs = models.DagRun.find(dag_id=dag.dag_id, execution_date=date)
         dr = drs[0]
+
         self.assertEqual(dr.get_state(), state)
 
+    def _verify_dag_run_dates(self, dag, date, state, middle_time):
+        # When target state is RUNNING, we should set start_date,
+        # otherwise we should set end_date.
+        drs = models.DagRun.find(dag_id=dag.dag_id, execution_date=date)
+        dr = drs[0]
+        if state == State.RUNNING:
+            self.assertGreater(dr.start_date, middle_time)
+            self.assertIsNone(dr.end_date)
+        else:
+            self.assertLess(dr.start_date, middle_time)
+            self.assertGreater(dr.end_date, middle_time)
+
     def test_set_running_dag_run_to_success(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.RUNNING, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
@@ -279,10 +293,12 @@ def test_set_running_dag_run_to_success(self):
         self.assertEqual(len(altered), 5)
         self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
         self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
+        self._verify_dag_run_dates(self.dag1, date, State.SUCCESS, middle_time)
 
     def test_set_running_dag_run_to_failed(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.RUNNING, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
@@ -291,10 +307,12 @@ def test_set_running_dag_run_to_failed(self):
         self.assertEqual(len(altered), 1)
         self._verify_dag_run_state(self.dag1, date, State.FAILED)
         self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+        self._verify_dag_run_dates(self.dag1, date, State.FAILED, middle_time)
 
     def test_set_running_dag_run_to_running(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.RUNNING, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
@@ -303,10 +321,12 @@ def test_set_running_dag_run_to_running(self):
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
+        self._verify_dag_run_dates(self.dag1, date, State.RUNNING, middle_time)
 
     def test_set_success_dag_run_to_success(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
@@ -315,10 +335,12 @@ def test_set_success_dag_run_to_success(self):
         self.assertEqual(len(altered), 5)
         self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
         self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
+        self._verify_dag_run_dates(self.dag1, date, State.SUCCESS, middle_time)
 
     def test_set_success_dag_run_to_failed(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
@@ -327,10 +349,12 @@ def test_set_success_dag_run_to_failed(self):
         self.assertEqual(len(altered), 1)
         self._verify_dag_run_state(self.dag1, date, State.FAILED)
         self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+        self._verify_dag_run_dates(self.dag1, date, State.FAILED, middle_time)
 
     def test_set_success_dag_run_to_running(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
@@ -339,10 +363,12 @@ def test_set_success_dag_run_to_running(self):
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
+        self._verify_dag_run_dates(self.dag1, date, State.RUNNING, middle_time)
 
     def test_set_failed_dag_run_to_success(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_success(self.dag1, date, commit=True)
@@ -351,10 +377,12 @@ def test_set_failed_dag_run_to_success(self):
         self.assertEqual(len(altered), 5)
         self._verify_dag_run_state(self.dag1, date, State.SUCCESS)
         self._verify_task_instance_states(self.dag1, date, State.SUCCESS)
+        self._verify_dag_run_dates(self.dag1, date, State.SUCCESS, middle_time)
 
     def test_set_failed_dag_run_to_failed(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_failed(self.dag1, date, commit=True)
@@ -363,10 +391,12 @@ def test_set_failed_dag_run_to_failed(self):
         self.assertEqual(len(altered), 1)
         self._verify_dag_run_state(self.dag1, date, State.FAILED)
         self.assertEqual(dr.get_task_instance('run_after_loop').state, State.FAILED)
+        self._verify_dag_run_dates(self.dag1, date, State.FAILED, middle_time)
 
     def test_set_failed_dag_run_to_running(self):
         date = self.execution_dates[0]
         dr = self._create_test_dag_run(State.SUCCESS, date)
+        middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
@@ -375,6 +405,7 @@ def test_set_failed_dag_run_to_running(self):
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
+        self._verify_dag_run_dates(self.dag1, date, State.RUNNING, middle_time)
 
     def test_set_state_without_commit(self):
         date = self.execution_dates[0]

From 9cf09fd60d9655cf6bb688b6e77e7909cf0c1afc Mon Sep 17 00:00:00 2001
From: Yingbo Wang <ybwang@gmail.com>
Date: Fri, 31 Aug 2018 16:49:39 -0700
Subject: [PATCH 412/808] [AIRFLOW-2951] Update dag_run table end_date when
 state change (#3798)

The existing airflow only change dag_run table end_date value when
a user teminate a dag in web UI. The end_date will not be updated
if airflow detected a dag finished and updated its state.

This commit add end_date update in DagRun's set_state function to
make up tho problem mentioned above.
---
 airflow/api/common/experimental/mark_tasks.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/api/common/experimental/mark_tasks.py b/airflow/api/common/experimental/mark_tasks.py
index 88c5275f5a4e8..2fac1254cd698 100644
--- a/airflow/api/common/experimental/mark_tasks.py
+++ b/airflow/api/common/experimental/mark_tasks.py
@@ -208,6 +208,7 @@ def _set_dag_run_state(dag_id, execution_date, state, session=None):
     dr.state = state
     if state == State.RUNNING:
         dr.start_date = timezone.utcnow()
+        dr.end_date = None
     else:
         dr.end_date = timezone.utcnow()
     session.commit()

From 7e0af2ee5584df8b4ab237eadab26c153113b22a Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 29 Nov 2018 23:21:06 +0800
Subject: [PATCH 413/808] [AIRFLOW-3239] Fix/refine tests for
 api/common/experimental/ (#4255)

Follow-up on [AIRFLOW-3239]
Related PRs: #4074, #4131

1. Fix (test_)trigger_dag.py

2. Fix (test_)mark_tasks.py
  2-1. properly name the file
  2-2. Correct the name of sample DAG
  2-3. Correct the range of sample execution_dates
       (earlier one conflict with the start_date of the sample DAG)
  2-4. Skip for test running on MySQL
       Seems something is wrong with
       airflow.api.common.experimental.mark_tasks.set_state,
       Corresponding test case works on Postgres & SQLite,
       but fails when on MySQL ("(1062, "Duplicate entry '110' for key 'PRIMARY'")").

       A TODO note is added to remind us fix it for MySQL later.

3. Remove unnecessary lines in test_pool.py
---
 .../{mark_tasks.py => test_mark_tasks.py}      | 18 +++++++++++++-----
 tests/api/common/experimental/test_pool.py     |  2 --
 ...rigger_dag_tests.py => test_trigger_dag.py} |  0
 3 files changed, 13 insertions(+), 7 deletions(-)
 rename tests/api/common/experimental/{mark_tasks.py => test_mark_tasks.py} (97%)
 rename tests/api/common/experimental/{trigger_dag_tests.py => test_trigger_dag.py} (100%)

diff --git a/tests/api/common/experimental/mark_tasks.py b/tests/api/common/experimental/test_mark_tasks.py
similarity index 97%
rename from tests/api/common/experimental/mark_tasks.py
rename to tests/api/common/experimental/test_mark_tasks.py
index 304e261b980bd..9afe31c9512bc 100644
--- a/tests/api/common/experimental/mark_tasks.py
+++ b/tests/api/common/experimental/test_mark_tasks.py
@@ -20,7 +20,7 @@
 import unittest
 from datetime import datetime
 
-from airflow import models
+from airflow import configuration, models
 from airflow.api.common.experimental.mark_tasks import (
     set_state, _create_dagruns, set_dag_run_state_to_success, set_dag_run_state_to_failed,
     set_dag_run_state_to_running)
@@ -31,12 +31,14 @@
 
 DEV_NULL = "/dev/null"
 
+configuration.load_test_config()
+
 
 class TestMarkTasks(unittest.TestCase):
 
     def setUp(self):
         self.dagbag = models.DagBag(include_examples=True)
-        self.dag1 = self.dagbag.dags['test_example_bash_operator']
+        self.dag1 = self.dagbag.dags['example_bash_operator']
         self.dag2 = self.dagbag.dags['example_subdag_operator']
 
         self.execution_dates = [days_ago(2), days_ago(1)]
@@ -195,6 +197,11 @@ def test_mark_tasks_past(self):
         self.verify_state(self.dag1, [task.task_id], self.execution_dates,
                           State.SUCCESS, snapshot)
 
+    # TODO: this skipIf should be removed once a fixing solution is found later
+    #       We skip it here because this test case is working with Postgres & SQLite
+    #       but not with MySQL
+    @unittest.skipIf('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                     "Flaky with MySQL")
     def test_mark_tasks_subdag(self):
         # set one task to success towards end of scheduled dag runs
         task = self.dag2.get_task("section-1")
@@ -217,15 +224,15 @@ def test_mark_tasks_subdag(self):
 class TestMarkDAGRun(unittest.TestCase):
     def setUp(self):
         self.dagbag = models.DagBag(include_examples=True)
-        self.dag1 = self.dagbag.dags['test_example_bash_operator']
+        self.dag1 = self.dagbag.dags['example_bash_operator']
         self.dag2 = self.dagbag.dags['example_subdag_operator']
 
-        self.execution_dates = [days_ago(3), days_ago(2), days_ago(1)]
+        self.execution_dates = [days_ago(2), days_ago(1), days_ago(0)]
 
         self.session = Session()
 
     def _set_default_task_instance_states(self, dr):
-        if dr.dag_id != 'test_example_bash_operator':
+        if dr.dag_id != 'example_bash_operator':
             return
         # success task
         dr.get_task_instance('runme_0').set_state(State.SUCCESS, self.session)
@@ -510,6 +517,7 @@ def tearDown(self):
         self.session.query(models.TaskInstance).delete()
         self.session.query(models.DagStat).delete()
         self.session.commit()
+        self.session.close()
 
 
 if __name__ == '__main__':
diff --git a/tests/api/common/experimental/test_pool.py b/tests/api/common/experimental/test_pool.py
index e5efa2c6768d2..fac1e2e71b23d 100644
--- a/tests/api/common/experimental/test_pool.py
+++ b/tests/api/common/experimental/test_pool.py
@@ -28,7 +28,6 @@
 class TestPool(unittest.TestCase):
 
     def setUp(self):
-        super(TestPool, self).setUp()
         self.session = settings.Session()
         self.pools = []
         for i in range(2):
@@ -46,7 +45,6 @@ def tearDown(self):
         self.session.query(models.Pool).delete()
         self.session.commit()
         self.session.close()
-        super(TestPool, self).tearDown()
 
     def test_get_pool(self):
         pool = pool_api.get_pool(name=self.pools[0].pool, session=self.session)
diff --git a/tests/api/common/experimental/trigger_dag_tests.py b/tests/api/common/experimental/test_trigger_dag.py
similarity index 100%
rename from tests/api/common/experimental/trigger_dag_tests.py
rename to tests/api/common/experimental/test_trigger_dag.py

From dc2c4ca2ab87ad5b0370b35b1b76d757eb1ffe18 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Tue, 8 Jan 2019 11:45:40 +0100
Subject: [PATCH 414/808] [AIRFLOW-3478] Make sure that the session is closed
 (#4298)

---
 airflow/api/common/experimental/delete_dag.py |  10 +-
 airflow/api/common/experimental/mark_tasks.py |  22 +-
 airflow/bin/cli.py                            | 198 ++++++++----------
 .../contrib/auth/backends/password_auth.py    |  25 +--
 .../contrib/executors/kubernetes_executor.py  |  51 ++---
 airflow/settings.py                           |   4 +-
 airflow/utils/cli_action_loggers.py           |   7 +-
 airflow/utils/db.py                           |   1 -
 airflow/www_rbac/decorators.py                |  43 ++--
 airflow/www_rbac/security.py                  |  10 +-
 airflow/www_rbac/utils.py                     |   4 +-
 .../common/experimental/test_mark_tasks.py    | 131 ++++++------
 tests/core.py                                 |   4 +-
 13 files changed, 237 insertions(+), 273 deletions(-)

diff --git a/airflow/api/common/experimental/delete_dag.py b/airflow/api/common/experimental/delete_dag.py
index e7d15772c961f..b20313a56aefe 100644
--- a/airflow/api/common/experimental/delete_dag.py
+++ b/airflow/api/common/experimental/delete_dag.py
@@ -19,11 +19,13 @@
 
 from sqlalchemy import or_
 
-from airflow import models, settings
+from airflow import models
+from airflow.utils.db import provide_session
 from airflow.exceptions import DagNotFound, DagFileExists
 
 
-def delete_dag(dag_id, keep_records_in_log=True):
+@provide_session
+def delete_dag(dag_id, keep_records_in_log=True, session=None):
     """
     :param dag_id: the dag_id of the DAG to delete
     :type dag_id: str
@@ -32,8 +34,6 @@ def delete_dag(dag_id, keep_records_in_log=True):
         The default value is True.
     :type keep_records_in_log: bool
     """
-    session = settings.Session()
-
     DM = models.DagModel
     dag = session.query(DM).filter(DM.dag_id == dag_id).first()
     if dag is None:
@@ -59,6 +59,4 @@ def delete_dag(dag_id, keep_records_in_log=True):
         for m in models.DagRun, models.TaskFail, models.TaskInstance:
             count += session.query(m).filter(m.dag_id == p, m.task_id == c).delete()
 
-    session.commit()
-
     return count
diff --git a/airflow/api/common/experimental/mark_tasks.py b/airflow/api/common/experimental/mark_tasks.py
index 2fac1254cd698..21b4463da14e3 100644
--- a/airflow/api/common/experimental/mark_tasks.py
+++ b/airflow/api/common/experimental/mark_tasks.py
@@ -22,7 +22,6 @@
 from airflow.jobs import BackfillJob
 from airflow.models import DagRun, TaskInstance
 from airflow.operators.subdag_operator import SubDagOperator
-from airflow.settings import Session
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
 from airflow.utils.state import State
@@ -54,8 +53,9 @@ def _create_dagruns(dag, execution_dates, state, run_id_template):
     return drs
 
 
+@provide_session
 def set_state(task, execution_date, upstream=False, downstream=False,
-              future=False, past=False, state=State.SUCCESS, commit=False):
+              future=False, past=False, state=State.SUCCESS, commit=False, session=None):
     """
     Set the state of a task instance and if needed its relatives. Can set state
     for future tasks (calculated from execution_date) and retroactively
@@ -71,6 +71,7 @@ def set_state(task, execution_date, upstream=False, downstream=False,
     :param past: Retroactively mark all tasks starting from start_date of the DAG
     :param state: State to which the tasks need to be set
     :param commit: Commit tasks to be altered to the database
+    :param session: database session
     :return: list of tasks that have been created and updated
     """
     assert timezone.is_localized(execution_date)
@@ -124,7 +125,6 @@ def set_state(task, execution_date, upstream=False, downstream=False,
     # go through subdagoperators and create dag runs. We will only work
     # within the scope of the subdag. We wont propagate to the parent dag,
     # but we will propagate from parent to subdag.
-    session = Session()
     dags = [dag]
     sub_dag_ids = []
     while len(dags) > 0:
@@ -180,18 +180,15 @@ def set_state(task, execution_date, upstream=False, downstream=False,
             tis_altered += qry_sub_dag.with_for_update().all()
         for ti in tis_altered:
             ti.state = state
-        session.commit()
     else:
         tis_altered = qry_dag.all()
         if len(sub_dag_ids) > 0:
             tis_altered += qry_sub_dag.all()
 
-    session.expunge_all()
-    session.close()
-
     return tis_altered
 
 
+@provide_session
 def _set_dag_run_state(dag_id, execution_date, state, session=None):
     """
     Helper method that set dag run state in the DB.
@@ -211,12 +208,11 @@ def _set_dag_run_state(dag_id, execution_date, state, session=None):
         dr.end_date = None
     else:
         dr.end_date = timezone.utcnow()
-    session.commit()
+    session.merge(dr)
 
 
 @provide_session
-def set_dag_run_state_to_success(dag, execution_date, commit=False,
-                                 session=None):
+def set_dag_run_state_to_success(dag, execution_date, commit=False, session=None):
     """
     Set the dag run for a specific execution date and its task instances
     to success.
@@ -248,8 +244,7 @@ def set_dag_run_state_to_success(dag, execution_date, commit=False,
 
 
 @provide_session
-def set_dag_run_state_to_failed(dag, execution_date, commit=False,
-                                session=None):
+def set_dag_run_state_to_failed(dag, execution_date, commit=False, session=None):
     """
     Set the dag run for a specific execution date and its running task instances
     to failed.
@@ -290,8 +285,7 @@ def set_dag_run_state_to_failed(dag, execution_date, commit=False,
 
 
 @provide_session
-def set_dag_run_state_to_running(dag, execution_date, commit=False,
-                                 session=None):
+def set_dag_run_state_to_running(dag, execution_date, commit=False, session=None):
     """
     Set the dag run for a specific execution date to running.
     :param dag: the DAG of which to alter state
diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 35c3537a4516e..01e25b3659172 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -59,8 +59,7 @@
                             Connection, DAG)
 
 from airflow.ti_deps.dep_context import (DepContext, SCHEDULER_DEPS)
-from airflow.utils import cli as cli_utils
-from airflow.utils import db as db_utils
+from airflow.utils import cli as cli_utils, db
 from airflow.utils.net import get_hostname
 from airflow.utils.log.logging_mixin import (LoggingMixin, redirect_stderr,
                                              redirect_stdout)
@@ -344,10 +343,8 @@ def variables(args):
         except ValueError as e:
             print(e)
     if args.delete:
-        session = settings.Session()
-        session.query(Variable).filter_by(key=args.delete).delete()
-        session.commit()
-        session.close()
+        with db.create_session() as session:
+            session.query(Variable).filter_by(key=args.delete).delete()
     if args.set:
         Variable.set(args.set[0], args.set[1])
     # Work around 'import' as a reserved keyword
@@ -361,10 +358,10 @@ def variables(args):
         export_helper(args.export)
     if not (args.set or args.get or imp or args.export or args.delete):
         # list all variables
-        session = settings.Session()
-        vars = session.query(Variable)
-        msg = "\n".join(var.key for var in vars)
-        print(msg)
+        with db.create_session() as session:
+            vars = session.query(Variable)
+            msg = "\n".join(var.key for var in vars)
+            print(msg)
 
 
 def import_helper(filepath):
@@ -391,19 +388,17 @@ def import_helper(filepath):
 
 
 def export_helper(filepath):
-    session = settings.Session()
-    qry = session.query(Variable).all()
-    session.close()
-
     var_dict = {}
-    d = json.JSONDecoder()
-    for var in qry:
-        val = None
-        try:
-            val = d.decode(var.val)
-        except Exception:
-            val = var.val
-        var_dict[var.key] = val
+    with db.create_session() as session:
+        qry = session.query(Variable).all()
+
+        d = json.JSONDecoder()
+        for var in qry:
+            try:
+                val = d.decode(var.val)
+            except Exception:
+                val = var.val
+            var_dict[var.key] = val
 
     with open(filepath, 'w') as varfile:
         varfile.write(json.dumps(var_dict, sort_keys=True, indent=4))
@@ -423,14 +418,12 @@ def unpause(args, dag=None):
 def set_is_paused(is_paused, args, dag=None):
     dag = dag or get_dag(args)
 
-    session = settings.Session()
-    dm = session.query(DagModel).filter(
-        DagModel.dag_id == dag.dag_id).first()
-    dm.is_paused = is_paused
-    session.commit()
+    with db.create_session() as session:
+        dm = session.query(DagModel).filter(DagModel.dag_id == dag.dag_id).first()
+        dm.is_paused = is_paused
+        session.commit()
 
-    msg = "Dag: {}, paused: {}".format(dag, str(dag.is_paused))
-    print(msg)
+    print("Dag: {}, paused: {}".format(dag, str(dag.is_paused)))
 
 
 def _run(args, dag, ti):
@@ -456,14 +449,12 @@ def _run(args, dag, ti):
         if args.ship_dag:
             try:
                 # Running remotely, so pickling the DAG
-                session = settings.Session()
-                pickle = DagPickle(dag)
-                session.add(pickle)
-                session.commit()
-                pickle_id = pickle.id
-                # TODO: This should be written to a log
-                print('Pickled dag {dag} as pickle_id:{pickle_id}'
-                      .format(**locals()))
+                with db.create_session() as session:
+                    pickle = DagPickle(dag)
+                    session.add(pickle)
+                    pickle_id = pickle.id
+                    # TODO: This should be written to a log
+                    print('Pickled dag {dag} as pickle_id:{pickle_id}'.format(**locals()))
             except Exception as e:
                 print('Could not pickle the DAG')
                 print(e)
@@ -512,13 +503,12 @@ def run(args, dag=None):
     if not args.pickle and not dag:
         dag = get_dag(args)
     elif not dag:
-        session = settings.Session()
-        log.info('Loading pickle id {args.pickle}'.format(args=args))
-        dag_pickle = session.query(
-            DagPickle).filter(DagPickle.id == args.pickle).first()
-        if not dag_pickle:
-            raise AirflowException("Who hid the pickle!? [missing pickle]")
-        dag = dag_pickle.pickle
+        with db.create_session() as session:
+            log.info('Loading pickle id {args.pickle}'.format(args=args))
+            dag_pickle = session.query(DagPickle).filter(DagPickle.id == args.pickle).first()
+            if not dag_pickle:
+                raise AirflowException("Who hid the pickle!? [missing pickle]")
+            dag = dag_pickle.pickle
 
     task = dag.get_task(task_id=args.task_id)
     ti = TaskInstance(task, args.execution_date)
@@ -1081,7 +1071,7 @@ def worker(args):
 
 def initdb(args):  # noqa
     print("DB: " + repr(settings.engine.url))
-    db_utils.initdb(settings.RBAC)
+    db.initdb(settings.RBAC)
     print("Done.")
 
 
@@ -1090,7 +1080,7 @@ def resetdb(args):
     if args.yes or input("This will drop existing tables "
                          "if they exist. Proceed? "
                          "(y/n)").upper() == "Y":
-        db_utils.resetdb(settings.RBAC)
+        db.resetdb(settings.RBAC)
     else:
         print("Bail.")
 
@@ -1098,7 +1088,7 @@ def resetdb(args):
 @cli_utils.action_logging
 def upgradedb(args):  # noqa
     print("DB: " + repr(settings.engine.url))
-    db_utils.upgradedb()
+    db.upgradedb()
 
     # Populate DagStats table
     session = settings.Session()
@@ -1137,20 +1127,20 @@ def connections(args):
             print(msg)
             return
 
-        session = settings.Session()
-        conns = session.query(Connection.conn_id, Connection.conn_type,
-                              Connection.host, Connection.port,
-                              Connection.is_encrypted,
-                              Connection.is_extra_encrypted,
-                              Connection.extra).all()
-        conns = [map(reprlib.repr, conn) for conn in conns]
-        msg = tabulate(conns, ['Conn Id', 'Conn Type', 'Host', 'Port',
-                               'Is Encrypted', 'Is Extra Encrypted', 'Extra'],
-                       tablefmt="fancy_grid")
-        if sys.version_info[0] < 3:
-            msg = msg.encode('utf-8')
-        print(msg)
-        return
+        with db.create_session() as session:
+            conns = session.query(Connection.conn_id, Connection.conn_type,
+                                  Connection.host, Connection.port,
+                                  Connection.is_encrypted,
+                                  Connection.is_extra_encrypted,
+                                  Connection.extra).all()
+            conns = [map(reprlib.repr, conn) for conn in conns]
+            msg = tabulate(conns, ['Conn Id', 'Conn Type', 'Host', 'Port',
+                                   'Is Encrypted', 'Is Extra Encrypted', 'Extra'],
+                           tablefmt="fancy_grid")
+            if sys.version_info[0] < 3:
+                msg = msg.encode('utf-8')
+            print(msg)
+            return
 
     if args.delete:
         # Check that only the `conn_id` arg was passed to the command
@@ -1170,31 +1160,30 @@ def connections(args):
                   'the --conn_id flag.\n')
             return
 
-        session = settings.Session()
-        try:
-            to_delete = (session
-                         .query(Connection)
-                         .filter(Connection.conn_id == args.conn_id)
-                         .one())
-        except exc.NoResultFound:
-            msg = '\n\tDid not find a connection with `conn_id`={conn_id}\n'
-            msg = msg.format(conn_id=args.conn_id)
-            print(msg)
-            return
-        except exc.MultipleResultsFound:
-            msg = ('\n\tFound more than one connection with ' +
-                   '`conn_id`={conn_id}\n')
-            msg = msg.format(conn_id=args.conn_id)
-            print(msg)
+        with db.create_session() as session:
+            try:
+                to_delete = (session
+                             .query(Connection)
+                             .filter(Connection.conn_id == args.conn_id)
+                             .one())
+            except exc.NoResultFound:
+                msg = '\n\tDid not find a connection with `conn_id`={conn_id}\n'
+                msg = msg.format(conn_id=args.conn_id)
+                print(msg)
+                return
+            except exc.MultipleResultsFound:
+                msg = ('\n\tFound more than one connection with ' +
+                       '`conn_id`={conn_id}\n')
+                msg = msg.format(conn_id=args.conn_id)
+                print(msg)
+                return
+            else:
+                deleted_conn_id = to_delete.conn_id
+                session.delete(to_delete)
+                msg = '\n\tSuccessfully deleted `conn_id`={conn_id}\n'
+                msg = msg.format(conn_id=deleted_conn_id)
+                print(msg)
             return
-        else:
-            deleted_conn_id = to_delete.conn_id
-            session.delete(to_delete)
-            session.commit()
-            msg = '\n\tSuccessfully deleted `conn_id`={conn_id}\n'
-            msg = msg.format(conn_id=deleted_conn_id)
-            print(msg)
-        return
 
     if args.add:
         # Check that the conn_id and conn_uri args were passed to the command:
@@ -1233,26 +1222,25 @@ def connections(args):
         if args.conn_extra is not None:
             new_conn.set_extra(args.conn_extra)
 
-        session = settings.Session()
-        if not (session.query(Connection)
-                       .filter(Connection.conn_id == new_conn.conn_id).first()):
-            session.add(new_conn)
-            session.commit()
-            msg = '\n\tSuccessfully added `conn_id`={conn_id} : {uri}\n'
-            msg = msg.format(conn_id=new_conn.conn_id,
-                             uri=args.conn_uri or
-                             urlunparse((args.conn_type,
-                                        '{login}:{password}@{host}:{port}'
-                                         .format(login=args.conn_login or '',
-                                                 password=args.conn_password or '',
-                                                 host=args.conn_host or '',
-                                                 port=args.conn_port or ''),
-                                         args.conn_schema or '', '', '', '')))
-            print(msg)
-        else:
-            msg = '\n\tA connection with `conn_id`={conn_id} already exists\n'
-            msg = msg.format(conn_id=new_conn.conn_id)
-            print(msg)
+        with db.create_session() as session:
+            if not (session.query(Connection)
+                           .filter(Connection.conn_id == new_conn.conn_id).first()):
+                session.add(new_conn)
+                msg = '\n\tSuccessfully added `conn_id`={conn_id} : {uri}\n'
+                msg = msg.format(conn_id=new_conn.conn_id,
+                                 uri=args.conn_uri or
+                                 urlunparse((args.conn_type,
+                                            '{login}:{password}@{host}:{port}'
+                                             .format(login=args.conn_login or '',
+                                                     password=args.conn_password or '',
+                                                     host=args.conn_host or '',
+                                                     port=args.conn_port or ''),
+                                             args.conn_schema or '', '', '', '')))
+                print(msg)
+            else:
+                msg = '\n\tA connection with `conn_id`={conn_id} already exists\n'
+                msg = msg.format(conn_id=new_conn.conn_id)
+                print(msg)
 
         return
 
diff --git a/airflow/contrib/auth/backends/password_auth.py b/airflow/contrib/auth/backends/password_auth.py
index 0bc04fcea8730..9d6a3ccbe6327 100644
--- a/airflow/contrib/auth/backends/password_auth.py
+++ b/airflow/contrib/auth/backends/password_auth.py
@@ -35,9 +35,8 @@
 from sqlalchemy import Column, String
 from sqlalchemy.ext.hybrid import hybrid_property
 
-from airflow import settings
 from airflow import models
-from airflow.utils.db import provide_session
+from airflow.utils.db import provide_session, create_session
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 login_manager = flask_login.LoginManager()
@@ -165,9 +164,6 @@ def login(self, request, session=None):
         return self.render('airflow/login.html',
                            title="Airflow - Login",
                            form=form)
-    finally:
-        session.commit()
-        session.close()
 
 
 class LoginForm(Form):
@@ -201,19 +197,16 @@ def decorated(*args, **kwargs):
             userpass = ''.join(header.split()[1:])
             username, password = base64.b64decode(userpass).decode("utf-8").split(":", 1)
 
-            session = settings.Session()
-            try:
-                authenticate(session, username, password)
+            with create_session() as session:
+                try:
+                    authenticate(session, username, password)
 
-                response = function(*args, **kwargs)
-                response = make_response(response)
-                return response
+                    response = function(*args, **kwargs)
+                    response = make_response(response)
+                    return response
 
-            except AuthenticationError:
-                return _forbidden()
+                except AuthenticationError:
+                    return _forbidden()
 
-            finally:
-                session.commit()
-                session.close()
         return _unauthorized()
     return decorated
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 53756d1e17b61..75c8dc292e561 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -32,7 +32,8 @@
 from airflow.executors import Executors
 from airflow.models import TaskInstance, KubeResourceVersion, KubeWorkerIdentifier
 from airflow.utils.state import State
-from airflow import configuration, settings
+from airflow.utils.db import provide_session, create_session
+from airflow import configuration
 from airflow.exceptions import AirflowConfigException, AirflowException
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -337,8 +338,7 @@ def process_status(self, pod_id, status, labels, resource_version):
 
 
 class AirflowKubernetesScheduler(LoggingMixin):
-    def __init__(self, kube_config, task_queue, result_queue, session,
-                 kube_client, worker_uuid):
+    def __init__(self, kube_config, task_queue, result_queue, kube_client, worker_uuid):
         self.log.debug("Creating Kubernetes executor")
         self.kube_config = kube_config
         self.task_queue = task_queue
@@ -349,12 +349,11 @@ def __init__(self, kube_config, task_queue, result_queue, session,
         self.launcher = PodLauncher(kube_client=self.kube_client)
         self.worker_configuration = WorkerConfiguration(kube_config=self.kube_config)
         self.watcher_queue = multiprocessing.Queue()
-        self._session = session
         self.worker_uuid = worker_uuid
         self.kube_watcher = self._make_kube_watcher()
 
     def _make_kube_watcher(self):
-        resource_version = KubeResourceVersion.get_current_resource_version(self._session)
+        resource_version = KubeResourceVersion.get_current_resource_version()
         watcher = KubernetesJobWatcher(self.namespace, self.watcher_queue,
                                        resource_version, self.worker_uuid)
         watcher.start()
@@ -514,14 +513,14 @@ class KubernetesExecutor(BaseExecutor, LoggingMixin):
     def __init__(self):
         self.kube_config = KubeConfig()
         self.task_queue = None
-        self._session = None
         self.result_queue = None
         self.kube_scheduler = None
         self.kube_client = None
         self.worker_uuid = None
         super(KubernetesExecutor, self).__init__(parallelism=self.kube_config.parallelism)
 
-    def clear_not_launched_queued_tasks(self):
+    @provide_session
+    def clear_not_launched_queued_tasks(self, session=None):
         """
         If the airflow scheduler restarts with pending "Queued" tasks, the tasks may or
         may not
@@ -537,8 +536,9 @@ def clear_not_launched_queued_tasks(self):
         proper support
         for State.LAUNCHED
         """
-        queued_tasks = self._session.query(
-            TaskInstance).filter(TaskInstance.state == State.QUEUED).all()
+        queued_tasks = session\
+            .query(TaskInstance)\
+            .filter(TaskInstance.state == State.QUEUED).all()
         self.log.info(
             'When executor started up, found %s queued task instances',
             len(queued_tasks)
@@ -557,14 +557,12 @@ def clear_not_launched_queued_tasks(self):
                     'TaskInstance: %s found in queued state but was not launched, '
                     'rescheduling', task
                 )
-                self._session.query(TaskInstance).filter(
+                session.query(TaskInstance).filter(
                     TaskInstance.dag_id == task.dag_id,
                     TaskInstance.task_id == task.task_id,
                     TaskInstance.execution_date == task.execution_date
                 ).update({TaskInstance.state: State.NONE})
 
-        self._session.commit()
-
     def _inject_secrets(self):
         def _create_or_update_secret(secret_name, secret_path):
             try:
@@ -601,20 +599,18 @@ def _create_or_update_secret(secret_name, secret_path):
 
     def start(self):
         self.log.info('Start Kubernetes executor')
-        self._session = settings.Session()
-        self.worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(
-            self._session)
+        self.worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid()
         self.log.debug('Start with worker_uuid: %s', self.worker_uuid)
         # always need to reset resource version since we don't know
         # when we last started, note for behavior below
         # https://github.com/kubernetes-client/python/blob/master/kubernetes/docs
         # /CoreV1Api.md#list_namespaced_pod
-        KubeResourceVersion.reset_resource_version(self._session)
+        KubeResourceVersion.reset_resource_version()
         self.task_queue = Queue()
         self.result_queue = Queue()
         self.kube_client = get_kube_client()
         self.kube_scheduler = AirflowKubernetesScheduler(
-            self.kube_config, self.task_queue, self.result_queue, self._session,
+            self.kube_config, self.task_queue, self.result_queue,
             self.kube_client, self.worker_uuid
         )
         self._inject_secrets()
@@ -643,8 +639,7 @@ def sync(self):
             self.log.info('Changing state of %s to %s', results, state)
             self._change_state(key, state, pod_id)
 
-        KubeResourceVersion.checkpoint_resource_version(
-            last_resource_version, session=self._session)
+        KubeResourceVersion.checkpoint_resource_version(last_resource_version)
 
         if not self.task_queue.empty():
             key, command, kube_executor_config = self.task_queue.get()
@@ -661,15 +656,15 @@ def _change_state(self, key, state, pod_id):
                 pass
         self.event_buffer[key] = state
         (dag_id, task_id, ex_time, try_number) = key
-        item = self._session.query(TaskInstance).filter_by(
-            dag_id=dag_id,
-            task_id=task_id,
-            execution_date=ex_time
-        ).one()
-        if state:
-            item.state = state
-            self._session.add(item)
-            self._session.commit()
+        with create_session() as session:
+            item = session.query(TaskInstance).filter_by(
+                dag_id=dag_id,
+                task_id=task_id,
+                execution_date=ex_time
+            ).one()
+            if state:
+                item.state = state
+                session.add(item)
 
     def end(self):
         self.log.info('Shutting down Kubernetes executor')
diff --git a/airflow/settings.py b/airflow/settings.py
index 524e4819d8b01..69622ba15afff 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -170,8 +170,8 @@ def configure_orm(disable_connection_pool=False):
         except conf.AirflowConfigException:
             pool_recycle = 1800
 
-        log.info("setting.configure_orm(): Using pool settings. pool_size={}, "
-                 "pool_recycle={}".format(pool_size, pool_recycle))
+        log.info("settings.configure_orm(): Using pool settings. pool_size={}, "
+                 "pool_recycle={}, pid={}".format(pool_size, pool_recycle, os.getpid()))
         engine_args['pool_size'] = pool_size
         engine_args['pool_recycle'] = pool_recycle
 
diff --git a/airflow/utils/cli_action_loggers.py b/airflow/utils/cli_action_loggers.py
index 8b8cda538fdd6..21304936f3ff5 100644
--- a/airflow/utils/cli_action_loggers.py
+++ b/airflow/utils/cli_action_loggers.py
@@ -25,7 +25,7 @@
 
 import logging
 
-import airflow.settings
+from airflow.utils.db import create_session
 
 
 def register_pre_exec_callback(action_logger):
@@ -94,9 +94,8 @@ def default_action_log(log, **_):
     :param **_: other keyword arguments that is not being used by this function
     :return: None
     """
-    session = airflow.settings.Session()
-    session.add(log)
-    session.commit()
+    with create_session() as session:
+        session.add(log)
 
 
 __pre_exec_callbacks = []
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index df1814a486960..92ffd373bf4ff 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -41,7 +41,6 @@ def create_session():
     session = settings.Session()
     try:
         yield session
-        session.expunge_all()
         session.commit()
     except Exception:
         session.rollback()
diff --git a/airflow/www_rbac/decorators.py b/airflow/www_rbac/decorators.py
index 8f962ef8406bb..4ec2c7e8e9774 100644
--- a/airflow/www_rbac/decorators.py
+++ b/airflow/www_rbac/decorators.py
@@ -22,7 +22,8 @@
 import pendulum
 from io import BytesIO as IO
 from flask import after_this_request, redirect, request, url_for, g
-from airflow import models, settings
+from airflow import models
+from airflow.utils.db import create_session
 
 
 def action_logging(f):
@@ -31,26 +32,26 @@ def action_logging(f):
     """
     @functools.wraps(f)
     def wrapper(*args, **kwargs):
-        session = settings.Session()
-        if g.user.is_anonymous:
-            user = 'anonymous'
-        else:
-            user = g.user.username
-
-        log = models.Log(
-            event=f.__name__,
-            task_instance=None,
-            owner=user,
-            extra=str(list(request.args.items())),
-            task_id=request.args.get('task_id'),
-            dag_id=request.args.get('dag_id'))
-
-        if 'execution_date' in request.args:
-            log.execution_date = pendulum.parse(
-                request.args.get('execution_date'))
-
-        session.add(log)
-        session.commit()
+
+        with create_session() as session:
+            if g.user.is_anonymous:
+                user = 'anonymous'
+            else:
+                user = g.user.username
+
+            log = models.Log(
+                event=f.__name__,
+                task_instance=None,
+                owner=user,
+                extra=str(list(request.args.items())),
+                task_id=request.args.get('task_id'),
+                dag_id=request.args.get('dag_id'))
+
+            if 'execution_date' in request.args:
+                log.execution_date = pendulum.parse(
+                    request.args.get('execution_date'))
+
+            session.add(log)
 
         return f(*args, **kwargs)
 
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 5dfa319bafbae..f7a339f032816 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -24,8 +24,9 @@
 from flask_appbuilder.security.sqla.manager import SecurityManager
 from sqlalchemy import or_
 
-from airflow import models, settings
+from airflow import models
 from airflow.www_rbac.app import appbuilder
+from airflow.utils.db import provide_session
 
 ###########################################################################
 #                               VIEW MENUS
@@ -325,7 +326,8 @@ def _merge_perm(self, permission_name, view_menu_name):
         if not pv and permission_name and view_menu_name:
             self.add_permission_view_menu(permission_name, view_menu_name)
 
-    def create_custom_dag_permission_view(self):
+    @provide_session
+    def create_custom_dag_permission_view(self, session=None):
         """
         Workflow:
         1. when scheduler found a new dag, we will create an entry in ab_view_menu
@@ -355,7 +357,7 @@ def merge_pv(perm, view_menu):
                 merge_pv(perm, dag)
 
         # Get all the active / paused dags and insert them into a set
-        all_dags_models = settings.Session.query(models.DagModel)\
+        all_dags_models = session.query(models.DagModel)\
             .filter(or_(models.DagModel.is_active, models.DagModel.is_paused))\
             .filter(~models.DagModel.is_subdag).all()
 
@@ -378,7 +380,7 @@ def merge_pv(perm, view_menu):
         view_menu = self.viewmenu_model
 
         # todo(tao) comment on the query
-        all_perm_view_by_user = settings.Session.query(ab_perm_view_role)\
+        all_perm_view_by_user = session.query(ab_perm_view_role)\
             .join(perm_view, perm_view.id == ab_perm_view_role
                   .columns.permission_view_id)\
             .filter(ab_perm_view_role.columns.role_id == user_role.id)\
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index b25e1541abd85..7c983279afebb 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -40,7 +40,7 @@
 from flask_appbuilder.models.sqla.interface import SQLAInterface
 import flask_appbuilder.models.sqla.filters as fab_sqlafilters
 import sqlalchemy as sqla
-from airflow import configuration, settings
+from airflow import configuration
 from airflow.models import BaseOperator
 from airflow.operators.subdag_operator import SubDagOperator
 from airflow.utils import timezone
@@ -427,8 +427,6 @@ class CustomSQLAInterface(SQLAInterface):
     def __init__(self, obj):
         super(CustomSQLAInterface, self).__init__(obj)
 
-        self.session = settings.Session()
-
         def clean_column_names():
             if self.list_properties:
                 self.list_properties = dict(
diff --git a/tests/api/common/experimental/test_mark_tasks.py b/tests/api/common/experimental/test_mark_tasks.py
index 9afe31c9512bc..456d3c4a30577 100644
--- a/tests/api/common/experimental/test_mark_tasks.py
+++ b/tests/api/common/experimental/test_mark_tasks.py
@@ -18,16 +18,18 @@
 # under the License.
 
 import unittest
+import time
 from datetime import datetime
 
 from airflow import configuration, models
 from airflow.api.common.experimental.mark_tasks import (
     set_state, _create_dagruns, set_dag_run_state_to_success, set_dag_run_state_to_failed,
     set_dag_run_state_to_running)
-from airflow.settings import Session
 from airflow.utils import timezone
+from airflow.utils.db import create_session, provide_session
 from airflow.utils.dates import days_ago
 from airflow.utils.state import State
+from airflow.models import DagRun
 
 DEV_NULL = "/dev/null"
 
@@ -59,33 +61,29 @@ def setUp(self):
             dr.dag = self.dag2
             dr.verify_integrity()
 
-        self.session = Session()
-
     def tearDown(self):
         self.dag1.clear()
         self.dag2.clear()
 
         # just to make sure we are fully cleaned up
-        self.session.query(models.DagRun).delete()
-        self.session.query(models.TaskInstance).delete()
-        self.session.commit()
-        self.session.close()
+        with create_session() as session:
+            session.query(models.DagRun).delete()
+            session.query(models.TaskInstance).delete()
 
-    def snapshot_state(self, dag, execution_dates):
+    @staticmethod
+    def snapshot_state(dag, execution_dates):
         TI = models.TaskInstance
-        tis = self.session.query(TI).filter(
-            TI.dag_id == dag.dag_id,
-            TI.execution_date.in_(execution_dates)
-        ).all()
-
-        self.session.expunge_all()
-
-        return tis
-
-    def verify_state(self, dag, task_ids, execution_dates, state, old_tis):
+        with create_session() as session:
+            return session.query(TI).filter(
+                TI.dag_id == dag.dag_id,
+                TI.execution_date.in_(execution_dates)
+            ).all()
+
+    @provide_session
+    def verify_state(self, dag, task_ids, execution_dates, state, old_tis, session=None):
         TI = models.TaskInstance
 
-        tis = self.session.query(TI).filter(
+        tis = session.query(TI).filter(
             TI.dag_id == dag.dag_id,
             TI.execution_date.in_(execution_dates)
         ).all()
@@ -102,7 +100,7 @@ def verify_state(self, dag, task_ids, execution_dates, state, old_tis):
 
     def test_mark_tasks_now(self):
         # set one task to success but do not commit
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("runme_1")
         altered = set_state(task=task, execution_date=self.execution_dates[0],
                             upstream=False, downstream=False, future=False,
@@ -136,7 +134,7 @@ def test_mark_tasks_now(self):
                           State.FAILED, snapshot)
 
         # dont alter other tasks
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("runme_0")
         altered = set_state(task=task, execution_date=self.execution_dates[0],
                             upstream=False, downstream=False, future=False,
@@ -147,7 +145,7 @@ def test_mark_tasks_now(self):
 
     def test_mark_downstream(self):
         # test downstream
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("runme_1")
         relatives = task.get_flat_relatives(upstream=False)
         task_ids = [t.task_id for t in relatives]
@@ -157,12 +155,11 @@ def test_mark_downstream(self):
                             upstream=False, downstream=True, future=False,
                             past=False, state=State.SUCCESS, commit=True)
         self.assertEqual(len(altered), 3)
-        self.verify_state(self.dag1, task_ids, [self.execution_dates[0]],
-                          State.SUCCESS, snapshot)
+        self.verify_state(self.dag1, task_ids, [self.execution_dates[0]], State.SUCCESS, snapshot)
 
     def test_mark_upstream(self):
         # test upstream
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("run_after_loop")
         relatives = task.get_flat_relatives(upstream=True)
         task_ids = [t.task_id for t in relatives]
@@ -177,31 +174,28 @@ def test_mark_upstream(self):
 
     def test_mark_tasks_future(self):
         # set one task to success towards end of scheduled dag runs
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("runme_1")
         altered = set_state(task=task, execution_date=self.execution_dates[0],
                             upstream=False, downstream=False, future=True,
                             past=False, state=State.SUCCESS, commit=True)
         self.assertEqual(len(altered), 2)
-        self.verify_state(self.dag1, [task.task_id], self.execution_dates,
-                          State.SUCCESS, snapshot)
+        self.verify_state(self.dag1, [task.task_id], self.execution_dates, State.SUCCESS, snapshot)
 
     def test_mark_tasks_past(self):
         # set one task to success towards end of scheduled dag runs
-        snapshot = self.snapshot_state(self.dag1, self.execution_dates)
+        snapshot = TestMarkTasks.snapshot_state(self.dag1, self.execution_dates)
         task = self.dag1.get_task("runme_1")
         altered = set_state(task=task, execution_date=self.execution_dates[1],
                             upstream=False, downstream=False, future=False,
                             past=True, state=State.SUCCESS, commit=True)
         self.assertEqual(len(altered), 2)
-        self.verify_state(self.dag1, [task.task_id], self.execution_dates,
-                          State.SUCCESS, snapshot)
+        self.verify_state(self.dag1, [task.task_id], self.execution_dates, State.SUCCESS, snapshot)
 
     # TODO: this skipIf should be removed once a fixing solution is found later
     #       We skip it here because this test case is working with Postgres & SQLite
     #       but not with MySQL
-    @unittest.skipIf('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
-                     "Flaky with MySQL")
+    @unittest.skipIf('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'), "Flaky with MySQL")
     def test_mark_tasks_subdag(self):
         # set one task to success towards end of scheduled dag runs
         task = self.dag2.get_task("section-1")
@@ -226,39 +220,35 @@ def setUp(self):
         self.dagbag = models.DagBag(include_examples=True)
         self.dag1 = self.dagbag.dags['example_bash_operator']
         self.dag2 = self.dagbag.dags['example_subdag_operator']
-
         self.execution_dates = [days_ago(2), days_ago(1), days_ago(0)]
 
-        self.session = Session()
-
     def _set_default_task_instance_states(self, dr):
-        if dr.dag_id != 'example_bash_operator':
-            return
         # success task
-        dr.get_task_instance('runme_0').set_state(State.SUCCESS, self.session)
+        dr.get_task_instance('runme_0').set_state(State.SUCCESS)
         # skipped task
-        dr.get_task_instance('runme_1').set_state(State.SKIPPED, self.session)
+        dr.get_task_instance('runme_1').set_state(State.SKIPPED)
         # retry task
-        dr.get_task_instance('runme_2').set_state(State.UP_FOR_RETRY, self.session)
+        dr.get_task_instance('runme_2').set_state(State.UP_FOR_RETRY)
         # queued task
-        dr.get_task_instance('also_run_this').set_state(State.QUEUED, self.session)
+        dr.get_task_instance('also_run_this').set_state(State.QUEUED)
         # running task
-        dr.get_task_instance('run_after_loop').set_state(State.RUNNING, self.session)
+        dr.get_task_instance('run_after_loop').set_state(State.RUNNING)
         # failed task
-        dr.get_task_instance('run_this_last').set_state(State.FAILED, self.session)
+        dr.get_task_instance('run_this_last').set_state(State.FAILED)
 
     def _verify_task_instance_states_remain_default(self, dr):
         self.assertEqual(dr.get_task_instance('runme_0').state, State.SUCCESS)
         self.assertEqual(dr.get_task_instance('runme_1').state, State.SKIPPED)
         self.assertEqual(dr.get_task_instance('runme_2').state, State.UP_FOR_RETRY)
-        self.assertEqual(dr.get_task_instance('also_run_this').state, State.QUEUED, )
+        self.assertEqual(dr.get_task_instance('also_run_this').state, State.QUEUED)
         self.assertEqual(dr.get_task_instance('run_after_loop').state, State.RUNNING)
         self.assertEqual(dr.get_task_instance('run_this_last').state, State.FAILED)
 
-    def _verify_task_instance_states(self, dag, date, state):
+    @provide_session
+    def _verify_task_instance_states(self, dag, date, state, session):
         TI = models.TaskInstance
-        tis = self.session.query(TI).filter(TI.dag_id == dag.dag_id,
-                                            TI.execution_date == date)
+        tis = session.query(TI)\
+            .filter(TI.dag_id == dag.dag_id, TI.execution_date == date)
         for ti in tis:
             self.assertEqual(ti.state, state)
 
@@ -266,8 +256,7 @@ def _create_test_dag_run(self, state, date):
         return self.dag1.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=state,
-            execution_date=date,
-            session=self.session
+            execution_date=date
         )
 
     def _verify_dag_run_state(self, dag, date, state):
@@ -276,15 +265,22 @@ def _verify_dag_run_state(self, dag, date, state):
 
         self.assertEqual(dr.get_state(), state)
 
-    def _verify_dag_run_dates(self, dag, date, state, middle_time):
+    @provide_session
+    def _verify_dag_run_dates(self, dag, date, state, middle_time, session=None):
         # When target state is RUNNING, we should set start_date,
         # otherwise we should set end_date.
-        drs = models.DagRun.find(dag_id=dag.dag_id, execution_date=date)
-        dr = drs[0]
+        DR = DagRun
+        dr = session.query(DR).filter(
+            DR.dag_id == dag.dag_id,
+            DR.execution_date == date
+        ).one()
         if state == State.RUNNING:
+            # Since the DAG is running, the start_date must be updated after creation
             self.assertGreater(dr.start_date, middle_time)
+            # If the dag is still running, we don't have an end date
             self.assertIsNone(dr.end_date)
         else:
+            # If the dag is not running, there must be an end time
             self.assertLess(dr.start_date, middle_time)
             self.assertGreater(dr.end_date, middle_time)
 
@@ -324,7 +320,7 @@ def test_set_running_dag_run_to_running(self):
 
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
 
-        # None of the tasks should be altered.
+        # None of the tasks should be altered, only the dag itself
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
@@ -366,7 +362,7 @@ def test_set_success_dag_run_to_running(self):
 
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
 
-        # None of the tasks should be altered.
+        # None of the tasks should be altered, but only the dag object should be changed
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
@@ -406,9 +402,11 @@ def test_set_failed_dag_run_to_running(self):
         middle_time = timezone.utcnow()
         self._set_default_task_instance_states(dr)
 
+        time.sleep(2)
+
         altered = set_dag_run_state_to_running(self.dag1, date, commit=True)
 
-        # None of the tasks should be altered.
+        # None of the tasks should be altered, since we've only altered the DAG itself
         self.assertEqual(len(altered), 0)
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
@@ -440,28 +438,28 @@ def test_set_state_without_commit(self):
         self._verify_dag_run_state(self.dag1, date, State.RUNNING)
         self._verify_task_instance_states_remain_default(dr)
 
-    def test_set_state_with_multiple_dagruns(self):
+    @provide_session
+    def test_set_state_with_multiple_dagruns(self, session=None):
         self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.FAILED,
             execution_date=self.execution_dates[0],
-            session=self.session
+            session=session
         )
         self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.FAILED,
             execution_date=self.execution_dates[1],
-            session=self.session
+            session=session
         )
         self.dag2.create_dagrun(
             run_id='manual__' + datetime.now().isoformat(),
             state=State.RUNNING,
             execution_date=self.execution_dates[2],
-            session=self.session
+            session=session
         )
 
-        altered = set_dag_run_state_to_success(self.dag2, self.execution_dates[1],
-                                               commit=True)
+        altered = set_dag_run_state_to_success(self.dag2, self.execution_dates[1], commit=True)
 
         # Recursively count number of tasks in the dag
         def count_dag_tasks(dag):
@@ -513,11 +511,10 @@ def tearDown(self):
         self.dag1.clear()
         self.dag2.clear()
 
-        self.session.query(models.DagRun).delete()
-        self.session.query(models.TaskInstance).delete()
-        self.session.query(models.DagStat).delete()
-        self.session.commit()
-        self.session.close()
+        with create_session() as session:
+            session.query(models.DagRun).delete()
+            session.query(models.TaskInstance).delete()
+            self.session.query(models.DagStat).delete()
 
 
 if __name__ == '__main__':
diff --git a/tests/core.py b/tests/core.py
index 9ca7112276edb..146ccbb97499e 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1194,13 +1194,13 @@ def test_cli_list_tasks(self):
             'list_tasks', 'example_bash_operator', '--tree'])
         cli.list_tasks(args)
 
-    @mock.patch("airflow.bin.cli.db_utils.initdb")
+    @mock.patch("airflow.bin.cli.db.initdb")
     def test_cli_initdb(self, initdb_mock):
         cli.initdb(self.parser.parse_args(['initdb']))
 
         initdb_mock.assert_called_once_with(False)
 
-    @mock.patch("airflow.bin.cli.db_utils.resetdb")
+    @mock.patch("airflow.bin.cli.db.resetdb")
     def test_cli_resetdb(self, resetdb_mock):
         cli.resetdb(self.parser.parse_args(['resetdb', '--yes']))
 

From f19b3753df36cfd675e71843edfdf9fbbb08c965 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sun, 11 Nov 2018 22:22:11 +0000
Subject: [PATCH 415/808] [AIRFLOW-XXX] Speed up RBAC view tests (#4162)

Not re-creating the FAB app ones per test functions took the run time of
the TestAirflowBaseViews from 223s down to 53s on my laptop, _and_ made
it only print the deprecation warning (fixed in another PR already open)
once instead of 10+ times.
---
 tests/www_rbac/test_views.py | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 64485718e65d9..8796bb3945bbe 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -50,13 +50,16 @@
 
 
 class TestBase(unittest.TestCase):
-    def setUp(self):
+    @classmethod
+    def setUpClass(cls):
         conf.load_test_config()
-        self.app, self.appbuilder = application.create_app(session=Session, testing=True)
-        self.app.config['WTF_CSRF_ENABLED'] = False
-        self.client = self.app.test_client()
+        cls.app, cls.appbuilder = application.create_app(session=Session, testing=True)
+        cls.app.config['WTF_CSRF_ENABLED'] = False
         settings.configure_orm()
-        self.session = Session
+        cls.session = Session
+
+    def setUp(self):
+        self.client = self.app.test_client()
         self.login()
 
     def login(self):

From 3e76b44c1d3351e92840c83815f072e484c690f4 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sat, 12 Jan 2019 22:03:47 +0000
Subject: [PATCH 416/808] [AIRFLOW-XXX] Fix CI

---
 tests/api/common/experimental/test_mark_tasks.py | 2 +-
 tests/contrib/utils/gcp_authenticator.py         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/api/common/experimental/test_mark_tasks.py b/tests/api/common/experimental/test_mark_tasks.py
index 456d3c4a30577..278b917fe1f22 100644
--- a/tests/api/common/experimental/test_mark_tasks.py
+++ b/tests/api/common/experimental/test_mark_tasks.py
@@ -514,7 +514,7 @@ def tearDown(self):
         with create_session() as session:
             session.query(models.DagRun).delete()
             session.query(models.TaskInstance).delete()
-            self.session.query(models.DagStat).delete()
+            session.query(models.DagStat).delete()
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/utils/gcp_authenticator.py b/tests/contrib/utils/gcp_authenticator.py
index b26f23f9c7a8d..4734a42b10287 100644
--- a/tests/contrib/utils/gcp_authenticator.py
+++ b/tests/contrib/utils/gcp_authenticator.py
@@ -23,7 +23,7 @@
 from airflow import settings, AirflowException
 from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
 
-from airflow.models.connection import Connection
+from airflow.models import Connection
 
 GCP_COMPUTE_KEY = 'gcp_compute.json'
 GCP_FUNCTION_KEY = 'gcp_function.json'

From 5c0f2d54f1005642e44801e6b049e14c09f23647 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Sat, 12 Jan 2019 20:54:43 +0100
Subject: [PATCH 417/808] [AIRFLOW-3687] Add missing @apply_defaults decorators
 (#4498)

---
 airflow/contrib/operators/databricks_operator.py | 3 +++
 airflow/contrib/operators/druid_operator.py      | 2 ++
 airflow/contrib/operators/mongo_to_s3.py         | 2 ++
 airflow/operators/python_operator.py             | 1 +
 4 files changed, 8 insertions(+)

diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index aed2d8909c76c..542a3d7857376 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -24,6 +24,7 @@
 from airflow.exceptions import AirflowException
 from airflow.contrib.hooks.databricks_hook import DatabricksHook
 from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
 
 
 XCOM_RUN_ID_KEY = 'run_id'
@@ -218,6 +219,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
     ui_color = '#1CB1C2'
     ui_fgcolor = '#fff'
 
+    @apply_defaults
     def __init__(
             self,
             json=None,
@@ -419,6 +421,7 @@ class DatabricksRunNowOperator(BaseOperator):
     ui_color = '#1CB1C2'
     ui_fgcolor = '#fff'
 
+    @apply_defaults
     def __init__(
             self,
             job_id,
diff --git a/airflow/contrib/operators/druid_operator.py b/airflow/contrib/operators/druid_operator.py
index 426393deeb315..1436d99f28d6f 100644
--- a/airflow/contrib/operators/druid_operator.py
+++ b/airflow/contrib/operators/druid_operator.py
@@ -21,6 +21,7 @@
 
 from airflow.hooks.druid_hook import DruidHook
 from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
 
 
 class DruidOperator(BaseOperator):
@@ -36,6 +37,7 @@ class DruidOperator(BaseOperator):
     template_fields = ('index_spec_str',)
     template_ext = ('.json',)
 
+    @apply_defaults
     def __init__(self, json_index_file,
                  druid_ingest_conn_id='druid_ingest_default',
                  max_ingestion_time=None,
diff --git a/airflow/contrib/operators/mongo_to_s3.py b/airflow/contrib/operators/mongo_to_s3.py
index 86a8d00413190..4a052d4b4af24 100644
--- a/airflow/contrib/operators/mongo_to_s3.py
+++ b/airflow/contrib/operators/mongo_to_s3.py
@@ -21,6 +21,7 @@
 from airflow.contrib.hooks.mongo_hook import MongoHook
 from airflow.hooks.S3_hook import S3Hook
 from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
 from bson import json_util
 
 
@@ -39,6 +40,7 @@ class MongoToS3Operator(BaseOperator):
     template_fields = ['s3_key', 'mongo_query']
     # pylint: disable=too-many-instance-attributes
 
+    @apply_defaults
     def __init__(self,
                  mongo_conn_id,
                  s3_conn_id,
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index c18ee3098b73f..e6a0795dc6ce7 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -219,6 +219,7 @@ class PythonVirtualenvOperator(PythonOperator):
         processing templated fields, for examples ``['.sql', '.hql']``
     :type templates_exts: list(str)
     """
+    @apply_defaults
     def __init__(self, python_callable,
                  requirements=None,
                  python_version=None, use_dill=False,

From 68d59caf3350b35acf70149d3863b1b28171c96b Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sat, 12 Jan 2019 23:00:13 +0000
Subject: [PATCH 418/808] Version 1.10.2b1

---
 CHANGELOG.txt      | 212 +++++++++++++++++++++++++++++++++++++++++++++
 airflow/version.py |   2 +-
 2 files changed, 213 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index aa7b321a5cb5a..acac71cd721b1 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,3 +1,215 @@
+AIRFLOW 1.10.2b1, 2019-01-12
+----------------------------
+
+New features:
+
+[AIRFLOW-2658] Add GCP specific k8s pod operator (#3532)
+[AIRFLOW-2440] Google Cloud SQL import/export operator (#4251)
+[AIRFLOW-3212] Add AwsGlueCatalogPartitionSensor (#4112)
+[AIRFLOW-2750] Add subcommands to delete and list users
+[AIRFLOW-3480] Add GCP Spanner Database Operators (#4353)
+[AIRFLOW-3560] Add DayOfWeek Sensor (#4363)
+[AIRFLOW-3371] BigQueryHook's Ability to Create View (#4213)
+[AIRFLOW-3332] Add method to allow inserting rows into BQ table (#4179)
+[AIRFLOW-3055] add get_dataset and get_datasets_list to bigquery_hook (#3894)
+[AIRFLOW-2887] Added BigQueryCreateEmptyDatasetOperator and create_emty_dataset to bigquery_hook (#3876)
+[AIRFLOW-2758] Add a sensor for MongoDB
+[AIRFLOW-2640] Add Cassandra table sensor
+[AIRFLOW-3398] Google Cloud Spanner instance database query operator (#4314)
+[AIRFLOW-3310] Google Cloud Spanner deploy / delete operators (#4286)
+[AIRFLOW-3406] Implement an Azure CosmosDB operator (#4265)
+[AIRFLOW-3434] Allows creating intermediate dirs in SFTPOperator (#4270)
+[AIRFLOW-3345] Add Google Cloud Storage (GCS) operators for ACL (#4192)
+[AIRFLOW-3266] Add AWS Athena Hook and Operator (#4111)
+[AIRFLOW-3346] Add hook and operator for GCP transfer service (#4189)
+[AIRFLOW-2983] Add prev_ds_nodash and next_ds_nodash macro (#3821)
+[AIRFLOW-3403] Add AWS Athena Sensor (#4244)
+[AIRFLOW-3323] Support HTTP basic authentication for Airflow Flower (#4166)
+[AIRFLOW-3410] Add feature to allow Host Key Change for SSH Op (#4249)
+[AIRFLOW-3275] Add Google Cloud SQL Query operator (#4170)
+[AIRFLOW-2691] Manage JS dependencies via npm
+[AIRFLOW-2795] Oracle to Oracle Transfer Operator (#3639)
+[AIRFLOW-2596] Add Oracle to Azure Datalake Transfer Operator
+[AIRFLOW-3220] Add Instance Group Manager Operators for GCE (#4167)
+[AIRFLOW-2882] Add import and export for pool cli using JSON
+[AIRFLOW-2965] CLI tool to show the next execution datetime (#3834)
+
+Improvements:
+
+[AIRFLOW-3680] Consistency update in tests for All GCP-related operators (#4493)
+[AIRFLOW-3675] Use googlapiclient for google apis (#4484)
+[AIRFLOW-3205] Support multipart uploads to GCS (#4084)
+[AIRFLOW-2826] Add GoogleCloudKMSHook (#3677)
+[AIRFLOW-3676] Add required permission to CloudSQL export/import example (#4489)
+[AIRFLOW-3679] Added Google Cloud Base Hook to documentation (#4487)
+[AIRFLOW-3594] Unify different License Header
+[AIRFLOW-3197] Remove invalid parameter KeepJobFlowAliveWhenNoSteps in example DAG (#4404)
+[AIRFLOW-3504] Refine the functionality of "/health" endpoint (#4309)
+[AIRFLOW-3103][AIRFLOW-3147] Update flask-appbuilder (#3937)
+[AIRFLOW-3168] More resillient database use in CI (#4014)
+[AIRFLOW-3076] Remove preloading of MySQL testdata (#3911)
+[AIRFLOW-3035] Allow custom 'job_error_states' in dataproc ops (#3884)
+[AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
+[AIRFLOW-3059] Log how many rows are read from Postgres (#3905)
+[AIRFLOW-2463] Make task instance context available for hive queries
+[AIRFLOW-3190] Make flake8 compliant
+[AIRFLOW-3190] Make flake8 compliant (#4035)
+[AIRFLOW-1998] Implemented DatabricksRunNowOperator for jobs/run-now … (#3813)
+[AIRFLOW-2267] Airflow DAG level access (#3197)
+[AIRFLOW-2359] Add set failed for DagRun and task in tree view (#3255)
+[AIRFLOW-3008] Move Kubernetes example DAGs to contrib
+[AIRFLOW-3402] Support global k8s affinity and toleration configs (#4247)
+[AIRFLOW-3610] Add region param for EMR jobflow creation (#4418)
+[AIRFLOW-3531] Fix test for GCS to GCS Transfer Hook (#4452)
+[AIRFLOW-3531] Add gcs to gcs transfer operator. (#4331)
+[AIRFLOW-3034]: Readme updates : Add Slack & Twitter, remove Gitter
+[AIRFLOW-3028] Update Text & Images in Readme.md
+[AIRFLOW-208] Add badge to show supported Python versions (#3839)
+[AIRFLOW-2238] Update PR tool to push directly to Github
+[AIRFLOW-2238] Flake8 fixes on dev/airflow-pr
+[AIRFLOW-2238] Update PR tool to remove outdated info (#3978)
+[AIRFLOW-3005] Replace 'Airbnb Airflow' with 'Apache Airflow' (#3845)
+[AIRFLOW-3150] Make execution_date templated in TriggerDagRunOperator (#4359)
+[AIRFLOW-1196][AIRFLOW-2399] Add templated field in TriggerDagRunOperator (#4228)
+[AIRFLOW-3340] Placeholder support in connections form (#4185)
+[AIRFLOW-3446] Add Google Cloud BigTable operators (#4354)
+[AIRFLOW-1921] Add support for https and user auth (#2879)
+[AIRFLOW-2770] Read `dags_in_image` config value as a boolean (#4319)
+[AIRFLOW-3022] Add volume mount to KubernetesExecutorConfig (#3855)
+[AIRFLOW-2917] Set AIRFLOW__CORE__SQL_ALCHEMY_CONN only when needed (#3766)
+[AIRFLOW-2712] Pass annotations to KubernetesExecutorConfig
+[AIRFLOW-461]  Support autodetected schemas in BigQuery run_load (#3880)
+[AIRFLOW-2997] Support cluster fields in bigquery (#3838)
+[AIRFLOW-2916] Arg `verify` for AwsHook() & S3 sensors/operators (#3764)
+[AIRFLOW-491] Add feature to pass extra api configs to BQ Hook (#3733)
+[AIRFLOW-2889] Fix typos detected by github.com/client9/misspell (#3732)
+[AIRFLOW-850] Add a PythonSensor (#4349)
+[AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
+[AIRFLOW-2747] Explicit re-schedule of sensors (#3596)
+[AIRFLOW-3392] Add index on dag_id in sla_miss table (#4235)
+[AIRFLOW-3001] Add index 'ti_dag_date' to taskinstance (#3885)
+[AIRFLOW-2861] Add index on log table (#3709)
+[AIRFLOW-3518] Performance fixes for topological_sort of Tasks (#4322)
+[AIRFLOW-3521] Fetch more than 50 items in `airflow-jira compare` script (#4300)
+[AIRFLOW-1919] Add option to query for DAG runs given a DAG ID
+[AIRFLOW-3444] Explicitly set transfer operator description. (#4279)
+[AIRFLOW-3411]  Add OpenFaaS hook (#4267)
+[AIRFLOW-2785] Add context manager entry points to mongoHook
+[AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
+[AIRFLOW-3479] Keeps records in Log Table when DAG is deleted (#4287)
+[AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
+[AIRFLOW-2948] Arg check & better doc - SSHOperator & SFTPOperator (#3793)
+[AIRFLOW-2245] Add remote_host of SSH/SFTP operator as templated field (#3765)
+[AIRFLOW-2670] Update SSH Operator's Hook to respect timeout (#3666)
+[AIRFLOW-3380] Add metrics documentation (#4219)
+[AIRFLOW-3361] Log the task_id in the PendingDeprecationWarning from BaseOperator (#4030)
+[AIRFLOW-3213] Create ADLS to GCS operator (#4134)
+[AIRFLOW-3395] added the REST API endpoints to the doc (#4236)
+[AIRFLOW-3294] Update connections form and integration docs (#4129)
+[AIRFLOW-3236] Create AzureDataLakeStorageListOperator (#4094)
+[AIRFLOW-3062] Add Qubole in integration docs (#3946)
+[AIRFLOW-3306] Disable flask-sqlalchemy modification tracking. (#4146)
+[AIRFLOW-2867] Refactor Code to conform standards (#3714)
+[AIRFLOW-2753] Add dataproc_job_id instance var holding actual DP jobId
+[AIRFLOW-3132] Enable specifying auto_remove option for DockerOperator (#3977)
+[AIRFLOW-2731] Raise psutil restriction to <6.0.0
+[AIRFLOW-3384] Allow higher versions of Sqlalchemy and Jinja2 (#4227)
+[Airflow-2760] Decouple DAG parsing loop from scheduler loop (#3873)
+[AIRFLOW-3004] Add config disabling scheduler cron (#3899)
+[AIRFLOW-3175] Fix docstring format in airflow/jobs.py (#4025)
+[AIRFLOW-3589] Visualize reschedule state in all views (#4408)
+[AIRFLOW-2698] Simplify Kerberos code (#3563)
+[AIRFLOW-2499] Dockerise CI pipeline (#3393)
+[AIRFLOW-3432] Add test for feature "Delete DAG in UI" (#4266)
+[AIRFLOW-3301] Update DockerOperator CI test for PR #3977 (#4138)
+[AIRFLOW-3478] Make sure that the session is closed
+[AIRFLOW-3687] Add missing @apply_defaults decorators (#4498)
+
+Bug fixes:
+
+[AIRFLOW-3191] Fix not being able to specify execution_date when creating dagrun (#4037)
+[AIRFLOW-3657] Fix zendesk integration (#4466)
+[AIRFLOW-3605] Load plugins from entry_points (#4412)
+[AIRFLOW-3646] Rename plugins_manager.py to test_xx to trigger tests (#4464)
+[AIRFLOW-3655] Escape links generated in model views (#4463)
+[AIRFLOW-3662] Add dependency for Enum (#4468)
+[AIRFLOW-3630] Cleanup of GCP Cloud SQL Connection (#4451)
+[AIRFLOW-1837] Respect task start_date when different from dag's (#4010)
+[AIRFLOW-2829] Brush up the CI script for minikube
+[AIRFLOW-3519] Fix example http operator (#4455)
+[AIRFLOW-2811] Fix scheduler_ops_metrics.py to work (#3653)
+[AIRFLOW-2751] add job properties update in hive to druid operator.
+[AIRFLOW-2918] Remove unused imports
+[AIRFLOW-2918] Fix Flake8 violations (#3931)
+[AIRFLOW-2771] Add except type to broad S3Hook try catch clauses
+[AIRFLOW-2918] Fix Flake8 violations (#3772)
+[AIRFLOW-2099] Handle getsource() calls gracefully
+[AIRFLOW-3397] Fix integrety error in rbac AirflowSecurityManager (#4305)
+[AIRFLOW-3281] Fix Kubernetes operator with git-sync (#3770)
+[AIRFLOW-2615] Limit DAGs parsing to once only
+[AIRFLOW-2952] Fix Kubernetes CI (#3922)
+[AIRFLOW-2933] Enable Codecov on Docker-CI Build (#3780)
+[AIRFLOW-2082] Resolve a bug in adding password_auth to api as auth method (#4343)
+[AIRFLOW-3612] Remove incubation/incubator mention (#4419)
+[AIRFLOW-3581] Fix next_ds/prev_ds semantics for manual runs (#4385)
+[AIRFLOW-3527] Update Cloud SQL Proxy to have shorter path for UNIX socket (#4350)
+[AIRFLOW-3316] For gcs_to_bq: add missing init of schema_fields var (#4430)
+[AIRFLOW-3583] Fix AirflowException import (#4389)
+[AIRFLOW-3578] Fix Type Error for BigQueryOperator (#4384)
+[AIRFLOW-2755] Added `kubernetes.worker_dags_folder` configuration (#3612)
+[AIRFLOW-2655] Fix inconsistency of default config of kubernetes worker
+[AIRFLOW-2645][AIRFLOW-2617] Add worker_container_image_pull_policy
+[AIRFLOW-2661] fix config dags_volume_subpath and logs_volume_subpath
+[AIRFLOW-3550] Standardize GKE hook (#4364)
+[AIRFLOW-2863] Fix GKEClusterHook catching wrong exception (#3711)
+[AIRFLOW-2939][AIRFLOW-3568] Fix TypeError in GCSToS3Op & S3ToGCSOp (#4371)
+[AIRFLOW-3327] Add support for location in BigQueryHook (#4324)
+[AIRFLOW-3438] Fix default values in BigQuery Hook & BigQueryOperator (…
+[AIRFLOW-3355] Fix BigQueryCursor.execute to work with Python3 (#4198)
+[AIRFLOW-3447] Add 2 options for ts_nodash Macro (#4323)
+[AIRFLOW-1552] Airflow Filter_by_owner not working with password_auth (#4276)
+[AIRFLOW-3484] Fix Over-logging in the k8s executor (#4296)
+[AIRFLOW-3309] Add MongoDB connection (#4154)
+[AIRFLOW-3414] Fix reload_module in DagFileProcessorAgent (#4253)
+[AIRFLOW-1252] API accept JSON when invoking a trigger dag (#2334)
+[AIRFLOW-3425] Fix setting default scope in hook (#4261)
+[AIRFLOW-3416] Fixes Python 3 compatibility with CloudSqlQueryOperator (#4254)
+[AIRFLOW-3263] Ignore exception when 'run' kills already killed job (#4108)
+[AIRFLOW-3264] URL decoding when parsing URI for connection (#4109)
+[AIRFLOW-3365][AIRFLOW-3366] Allow celery_broker_transport_options to be set with environment variables (#4211)
+[AIRFLOW-2642] fix wrong value git-sync initcontainer env GIT_SYNC_ROOT (#3519)
+[AIRFLOW-3353] Pin redis verison (#4195)
+[AIRFLOW-3251] KubernetesPodOperator now uses 'image_pull_secrets' argument when creating Pods (#4188)
+[AIRFLOW-2705] Move class-level moto decorator to method-level
+[AIRFLOW-3233] Fix deletion of DAGs in the UI (#4069)
+[AIRFLOW-2908] Allow retries with KubernetesExecutor. (#3758)
+[AIRFLOW-1561] Fix scheduler to pick up example DAGs without other DAGs (#2635)
+[AIRFLOW-3352] Fix expose_config not honoured on RBAC UI (#4194)
+[AIRFLOW-3592] Fix logs when task is in rescheduled state (#4492)
+[AIRFLOW-3634] Fix GCP Spanner Test (#4440)
+[AIRFLOW-XXX] Fix PythonVirtualenvOperator tests (#3968)
+[AIRFLOW-3239] Fix/refine tests for api/common/experimental/ (#4255)
+[AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
+[AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
+
+Doc-only changes:
+
+[AIRFLOW-XXX] GCP operators documentation clarifications (#4273)
+[AIRFLOW-XXX] Docs: Fix paths to GCS transfer operator (#4479)
+[AIRFLOW-XXX] Add missing GCP operators to Docs (#4260)
+[AIRFLOW-XXX] Fix Docstrings for Operators (#3820)
+[AIRFLOW-XXX] Fix inconsistent comment in example_python_operator.py (#4337)
+[AIRFLOW-XXX] Fix incorrect parameter in SFTPOperator example (#4344)
+[AIRFLOW-XXX] Add missing remote logging field (#4333)
+[AIRFLOW-XXX] Revise template variables documentation (#4172)
+[AIRFLOW-XXX] Fix typo in docstring of gcs_to_bq (#3833)
+[AIRFLOW-XXX] Fix display of SageMaker operators/hook docs (#4263)
+[AIRFLOW-XXX] Better instructions for airflow flower (#4214)
+[AIRFLOW-XXX] Make pip install commands consistent (#3752)
+[AIRFLOW-XXX] Add `BigQueryGetDataOperator` to Integration Docs (#4063)
+[AIRFLOW-XXX] Don't spam test logs with "bad cron expression" messages (#3973)
+[AIRFLOW-XXX] Update committer list based on latest TLP discussion (#4427)
+
 AIRFLOW 1.10.1, 2018-11-13
 
 New features:
diff --git a/airflow/version.py b/airflow/version.py
index 5521427e4c327..7d12dbf593702 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.1'
+version = '1.10.2b1'

From 2be7b1b3ebdb39b11646fa0e8bdc837e4e71bfc0 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 01:28:05 +0000
Subject: [PATCH 419/808] [AIRFLOW-XXX] Bump version to 1.10.2b2

---
 CHANGELOG.txt      | 2 +-
 airflow/version.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index acac71cd721b1..daa5011c273fe 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,4 @@
-AIRFLOW 1.10.2b1, 2019-01-12
+AIRFLOW 1.10.2b2, 2019-01-12
 ----------------------------
 
 New features:
diff --git a/airflow/version.py b/airflow/version.py
index 7d12dbf593702..30e1b4a3ef844 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.2b1'
+version = '1.10.2b2'

From ed8a2e2e0f4a9cb924208333067bc6530e15b14d Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Sun, 13 Jan 2019 09:02:34 +0100
Subject: [PATCH 420/808] [AIRFLOW-3691] Update notice to 2019 (#4503)

---
 NOTICE   | 2 +-
 setup.py | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/NOTICE b/NOTICE
index 544c0807667fb..31b9455e93661 100644
--- a/NOTICE
+++ b/NOTICE
@@ -1,5 +1,5 @@
 Apache Airflow
-Copyright 2016-2018 The Apache Software Foundation
+Copyright 2016-2019 The Apache Software Foundation
 
 This product includes software developed at The Apache Software
 Foundation (http://www.apache.org/).
diff --git a/setup.py b/setup.py
index 4a2eb786f7a7a..6d31117bbcba3 100644
--- a/setup.py
+++ b/setup.py
@@ -21,6 +21,7 @@
 from setuptools.command.test import test as TestCommand
 
 import imp
+import io
 import logging
 import os
 import sys
@@ -34,6 +35,9 @@
 
 PY3 = sys.version_info[0] == 3
 
+with io.open('README.md', encoding='utf-8') as f:
+    long_description = f.read()
+
 
 # See LEGAL-362
 def verify_gpl_dependency():
@@ -284,6 +288,8 @@ def do_setup():
     setup(
         name='apache-airflow',
         description='Programmatically author, schedule and monitor data pipelines',
+        long_description=long_description,
+        long_description_content_type='text/markdown',
         license='Apache License 2.0',
         version=version,
         packages=find_packages(exclude=['tests*']),

From 7f8abfb775d7fcd726edb8f733f33670be45311a Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 13 Jan 2019 21:11:12 +0800
Subject: [PATCH 421/808] [AIRFLOW-3689] Update pop-up message when deleting
 DAG in RBAC UI (#4505)

This feature was added in https://github.com/apache/airflow/pull/4287,
but the pop-up messages was only updated in airflow/www/templates/airflow/dag.html,
while it should be updated for all dag.html & dags.html for both /www and /www_rbac.
---
 airflow/www/templates/airflow/dag.html       | 3 ++-
 airflow/www/templates/airflow/dags.html      | 1 +
 airflow/www_rbac/templates/airflow/dag.html  | 1 +
 airflow/www_rbac/templates/airflow/dags.html | 1 +
 4 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index c34ec375b6f78..e69f31ad0674d 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -332,7 +332,8 @@ <h4 class="modal-title" id="dagModalLabel">
 
     function confirmDeleteDag(dag_id){
         return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
-          This option will delete ALL metadata, DAG runs, etc., EXCEPT Log\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          EXCEPT Log.\n\
           This cannot be undone.");
     }
 
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 395915b8135e9..d01d51e36e187 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -254,6 +254,7 @@ <h2>DAGs</h2>
       function confirmDeleteDag(dag_id){
           return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\
+          EXCEPT Log.\n\
           This cannot be undone.");
       }
       all_dags = $("[id^=toggle]");
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 83bde73311dbf..04c20ce9ab479 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -330,6 +330,7 @@ <h4 class="modal-title" id="dagModalLabel">
     function confirmDeleteDag(dag_id){
         return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\
+          EXCEPT Log.\n\
           This cannot be undone.");
     }
 
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index d4e3a227a274c..e55f8278c59ee 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -252,6 +252,7 @@ <h2>DAGs</h2>
       function confirmDeleteDag(dag_id){
           return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\
+          EXCEPT Log.\n\
           This cannot be undone.");
       }
 

From 5da6e12f43b8be9eab585c979a81da7463430399 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 13 Jan 2019 22:33:08 +0800
Subject: [PATCH 422/808] [AIRFLOW-3690] Fix bug to set state of a task for
 manually-triggered DAGs (#4504)

---
 airflow/api/common/experimental/mark_tasks.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/airflow/api/common/experimental/mark_tasks.py b/airflow/api/common/experimental/mark_tasks.py
index 21b4463da14e3..b761d8dc5b594 100644
--- a/airflow/api/common/experimental/mark_tasks.py
+++ b/airflow/api/common/experimental/mark_tasks.py
@@ -76,10 +76,6 @@ def set_state(task, execution_date, upstream=False, downstream=False,
     """
     assert timezone.is_localized(execution_date)
 
-    # microseconds are supported by the database, but is not handled
-    # correctly by airflow on e.g. the filesystem and in other places
-    execution_date = execution_date.replace(microsecond=0)
-
     assert task.dag is not None
     dag = task.dag
 

From ece63f8428ae9a12a2e280d2b676316340e424b3 Mon Sep 17 00:00:00 2001
From: "Taylor D. Edmiston" <tedmiston@gmail.com>
Date: Thu, 26 Jul 2018 11:02:47 +0200
Subject: [PATCH 423/808] [AIRFLOW-2801] Skip test_mark_success_no_kill in
 PostgreSQL on CI

See mailing list thread "Flaky test case:
test_mark_success_no_kill".

Closes #3642 from
tedmiston/test_mark_success_no_kill-postgresql
---
 tests/jobs.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/jobs.py b/tests/jobs.py
index 5fb7ad348b292..15daeaca7a61b 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1238,6 +1238,8 @@ def test_localtaskjob_heartbeat(self, mock_pid):
 
     @unittest.skipIf('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
                      "flaky when run on mysql")
+    @unittest.skipIf('postgresql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                     'flaky when run on postgresql')
     def test_mark_success_no_kill(self):
         """
         Test that ensures that mark_success in the UI doesn't cause

From 67f249a5953d1b16ea12289edbaae1a6b50e2c78 Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Sun, 13 Jan 2019 13:34:00 +0100
Subject: [PATCH 424/808] [AIRFLOW-3692] Remove ENV variables to avoid GPL
 (#4506)

---
 CONTRIBUTING.md                         |  2 +-
 INSTALL                                 |  8 --------
 UPDATING.md                             |  6 ++++++
 docs/installation.rst                   |  8 --------
 scripts/ci/docker-compose.yml           |  1 -
 scripts/ci/kubernetes/docker/Dockerfile |  2 --
 scripts/ci/kubernetes/docker/build.sh   |  2 +-
 setup.py                                | 20 +-------------------
 8 files changed, 9 insertions(+), 40 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 57178abb4b7cd..5b4e8db9347bd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -121,7 +121,7 @@ There are three ways to setup an Apache Airflow development environment.
 
   ```
   # Start docker in your Airflow directory
-  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:2 bash
+  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ python:2 bash
 
   # Go to the Airflow directory
   cd /airflow/
diff --git a/INSTALL b/INSTALL
index 00d458f450737..c3d15a23eaa08 100644
--- a/INSTALL
+++ b/INSTALL
@@ -14,14 +14,6 @@ java -jar apache-rat.jar -E ./.rat-excludes -d .
 python -m my_env
 source my_env/bin/activate
 
-# [required] by default one of Apache Airflow's dependencies pulls in a GPL
-# library. Airflow will not install (and upgrade) without an explicit choice.
-#
-# To make sure not to install the GPL dependency:
-#   export SLUGIFY_USES_TEXT_UNIDECODE=yes
-# In case you do not mind:
-#   export AIRFLOW_GPL_UNIDECODE=yes
-
 # [required] building and installing
 # by pip (preferred)
 pip install .
diff --git a/UPDATING.md b/UPDATING.md
index 91d509d681548..fb85118386298 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -24,6 +24,12 @@ assists users migrating to a new version.
 
 ## Airflow 1.10.2
 
+#### SLUGIFY_USES_TEXT_UNIDECODE or AIRFLOW_GPL_UNIDECODE no longer required
+
+It is no longer required to set one of the environment variables to avoid
+a GPL dependency. Airflow will now always use text-unidecode if unidecode
+was not installed before.
+
 ### Modification to `ts_nodash` macro
 `ts_nodash` previously contained TimeZone information alongwith execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes. 
 
diff --git a/docs/installation.rst b/docs/installation.rst
index 78249df189960..0ca7c9717c6cc 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -33,14 +33,6 @@ You can also install Airflow with support for extra features like ``s3`` or ``po
 
     pip install apache-airflow[postgres,s3]
 
-.. note:: GPL dependency
-
-    One of the dependencies of Apache Airflow by default pulls in a GPL library ('unidecode').
-    In case this is a concern you can force a non GPL library by issuing
-    ``export SLUGIFY_USES_TEXT_UNIDECODE=yes`` and then proceed with the normal installation.
-    Please note that this needs to be specified at every upgrade. Also note that if `unidecode`
-    is already present on the system the dependency will still be used.
-
 Extra Packages
 ''''''''''''''
 
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 32e0a536c1597..0f5d660c390e9 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -67,7 +67,6 @@ services:
     init: true
     environment:
       - USER=airflow
-      - SLUGIFY_USES_TEXT_UNIDECODE=yes
       - TOX_ENV
       - PYTHON_VERSION
       - CI
diff --git a/scripts/ci/kubernetes/docker/Dockerfile b/scripts/ci/kubernetes/docker/Dockerfile
index 93b20dbcd22fa..387e7d3804740 100644
--- a/scripts/ci/kubernetes/docker/Dockerfile
+++ b/scripts/ci/kubernetes/docker/Dockerfile
@@ -17,8 +17,6 @@
 
 FROM ubuntu:16.04
 
-ENV SLUGIFY_USES_TEXT_UNIDECODE=yes
-
 # install deps
 RUN apt-get update -y && apt-get install -y \
         wget \
diff --git a/scripts/ci/kubernetes/docker/build.sh b/scripts/ci/kubernetes/docker/build.sh
index df755f9659178..cb0995aaf473c 100755
--- a/scripts/ci/kubernetes/docker/build.sh
+++ b/scripts/ci/kubernetes/docker/build.sh
@@ -41,7 +41,7 @@ else
 fi
 
 cd $AIRFLOW_ROOT
-docker run -ti --rm -e SLUGIFY_USES_TEXT_UNIDECODE -v ${AIRFLOW_ROOT}:/airflow \
+docker run -ti --rm -v ${AIRFLOW_ROOT}:/airflow \
     -w /airflow ${PYTHON_DOCKER_IMAGE} ./scripts/ci/kubernetes/docker/compile.sh \
 
 sudo rm -rf ${AIRFLOW_ROOT}/airflow/www_rbac/node_modules
diff --git a/setup.py b/setup.py
index 6d31117bbcba3..ea4550591ef7f 100644
--- a/setup.py
+++ b/setup.py
@@ -39,24 +39,6 @@
     long_description = f.read()
 
 
-# See LEGAL-362
-def verify_gpl_dependency():
-    # The Read the Docs build environment [1] does a pip install of Airflow which cannot
-    # be overridden with custom environment variables, so we detect the READTHEDOCS env
-    # var they provide to set the env var that avoids the GPL dependency on install when
-    # building the docs site.
-    # [1]: http://docs.readthedocs.io/en/latest/builds.html#build-environment
-    if os.getenv("READTHEDOCS") == "True":
-        os.environ["SLUGIFY_USES_TEXT_UNIDECODE"] = "yes"
-
-    if not os.getenv("AIRFLOW_GPL_UNIDECODE") and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes":
-        raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
-                           "dependency (unidecode). To avoid this dependency set "
-                           "SLUGIFY_USES_TEXT_UNIDECODE=yes in your environment when you "
-                           "install or upgrade Airflow. To force installing the GPL "
-                           "version set AIRFLOW_GPL_UNIDECODE")
-
-
 class Tox(TestCommand):
     user_options = [('tox-args=', None, "Arguments to pass to tox")]
 
@@ -283,7 +265,6 @@ def write_version(filename=os.path.join(*['airflow',
 
 
 def do_setup():
-    verify_gpl_dependency()
     write_version()
     setup(
         name='apache-airflow',
@@ -332,6 +313,7 @@ def do_setup():
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
+            'text-unidecode==1.2',  # Avoid GPL dependency, pip uses reverse order(!)
             'thrift>=0.9.2',
             'tzlocal>=1.4',
             'unicodecsv>=0.14.1',

From c5037c5d112f90470c473384df9e7fc9418ac3e0 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Sat, 27 Oct 2018 15:48:25 +0200
Subject: [PATCH 425/808] [AIRFLOW-XXX] Fix incorrect statement in contributing
 guide (#4104)

---
 CONTRIBUTING.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5b4e8db9347bd..b83d096a19f36 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -121,10 +121,8 @@ There are three ways to setup an Apache Airflow development environment.
 
   ```
   # Start docker in your Airflow directory
-  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ python:2 bash
+  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ python:3 bash
 
-  # Go to the Airflow directory
-  cd /airflow/
 
   # Install Airflow with all the required dependencies,
   # including the devel which will provide the development tools

From a7dc4154e928a9b17ecd026600df05a1ac9cee46 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 29 Aug 2018 21:44:24 +0100
Subject: [PATCH 426/808] [AIRFLOW-XXX] Fix Broken Link in CONTRIBUTING.md

---
 CONTRIBUTING.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b83d096a19f36..f75ab78658def 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -103,7 +103,7 @@ There are three ways to setup an Apache Airflow development environment.
 1. Using tools and libraries installed directly on your system.
 
   Install Python (2.7.x or 3.4.x), MySQL, and libxml by using system-level package
-  managers like yum, apt-get for Linux, or Homebrew for Mac OS at first. Refer to the [base CI Dockerfile](https://github.com/apache/incubator-airflow-ci/blob/master/Dockerfile.base) for
+  managers like yum, apt-get for Linux, or Homebrew for Mac OS at first. Refer to the [base CI Dockerfile](https://github.com/apache/incubator-airflow-ci/blob/master/Dockerfile) for
   a comprehensive list of required packages.
 
   Then install python development requirements. It is usually best to work in a virtualenv:

From 1eda89cbcdd0a77b6988c79062c4ef64dc51f37a Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Sun, 11 Nov 2018 23:40:03 +0100
Subject: [PATCH 427/808] [AIRFLOW-XXX] Update Contributing Guide - Git Hooks
 (#4120)

- changes pre-commit example to use methods
- adds activating virtual env for python to run things like flake8 locally
- changes pre-commit file to use set -e command to instantly exit if any non-zero error occurs
- changes flake8 call to lint the repo instead of not only the changes files
---
 CONTRIBUTING.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f75ab78658def..58a1fe447c9ff 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -190,6 +190,53 @@ docker-compose -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts
 Alternatively can also set up [Travis CI](https://travis-ci.org/) on your repo to automate this.
 It is free for open source projects.
 
+Another great way of automating linting and testing is to use [Git Hooks](https://git-scm.com/book/uz/v2/Customizing-Git-Git-Hooks). For example you could create a `pre-commit` file based on the Travis CI Pipeline so that before each commit a local pipeline will be triggered and if this pipeline fails (returns an exit code other than `0`) the commit does not come through.
+This "in theory" has the advantage that you can not commit any code that fails that again reduces the errors in the Travis CI Pipelines.
+
+Since there are a lot of tests the script would last very long so you propably only should test your new feature locally.
+
+The following example of a `pre-commit` file allows you..
+- to lint your code via flake8
+- to test your code via nosetests in a docker container based on python 2
+- to test your code via nosetests in a docker container based on python 3
+
+```
+#!/bin/sh
+
+GREEN='\033[0;32m'
+NO_COLOR='\033[0m'
+
+setup_python_env() {
+    local venv_path=${1}
+
+    echo -e "${GREEN}Activating python virtual environment ${venv_path}..${NO_COLOR}"
+    source ${venv_path}
+}
+run_linting() {
+    local project_dir=$(git rev-parse --show-toplevel)
+
+    echo -e "${GREEN}Running flake8 over directory ${project_dir}..${NO_COLOR}"
+    flake8 ${project_dir}
+}
+run_testing_in_docker() {
+    local feature_path=${1}
+    local airflow_py2_container=${2}
+    local airflow_py3_container=${3}
+
+    echo -e "${GREEN}Running tests in ${feature_path} in airflow python 2 docker container..${NO_COLOR}"
+    docker exec -i -w /airflow/ ${airflow_py2_container} nosetests -v ${feature_path}
+    echo -e "${GREEN}Running tests in ${feature_path} in airflow python 3 docker container..${NO_COLOR}"
+    docker exec -i -w /airflow/ ${airflow_py3_container} nosetests -v ${feature_path}
+}
+
+set -e
+# NOTE: Before running this make sure you have set the function arguments correctly.
+setup_python_env /Users/feluelle/venv/bin/activate
+run_linting
+run_testing_in_docker tests/contrib/hooks/test_imap_hook.py dazzling_chatterjee quirky_stallman
+
+```
+
 For more information on how to run a subset of the tests, take a look at the
 nosetests docs.
 

From cb07b89be11b722e6a0d79be7c68b8c31b2a57c8 Mon Sep 17 00:00:00 2001
From: Bryant Biggs <bryantbiggs@gmail.com>
Date: Sun, 2 Dec 2018 00:58:50 -0500
Subject: [PATCH 428/808] [AIRFLOW-3426] Correct Python Version Documentation
 Reference (#4259)

---
 setup.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index ea4550591ef7f..2d95009df36a3 100644
--- a/setup.py
+++ b/setup.py
@@ -388,7 +388,6 @@ def do_setup():
             'Intended Audience :: System Administrators',
             'License :: OSI Approved :: Apache Software License',
             'Programming Language :: Python :: 2.7',
-            'Programming Language :: Python :: 3.4',
             'Programming Language :: Python :: 3.5',
             'Topic :: System :: Monitoring',
         ],
@@ -402,7 +401,7 @@ def do_setup():
             'extra_clean': CleanCommand,
             'compile_assets': CompileAssets
         },
-        python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*',
+        python_requires='>=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*',
     )
 
 

From d5eb11eee5610c9d8519dd9b45f144d647c47851 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sun, 13 Jan 2019 17:54:45 +0100
Subject: [PATCH 429/808] [AIRFLOW-3693] Replace psycopg2-binary by psycopg2
 (#4508)

For Python packages, psycopg2 is preferred over psycopg2-binary
http://initd.org/psycopg/docs/install.html#binary-install-from-pypi
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 2d95009df36a3..ca6e3436cf953 100644
--- a/setup.py
+++ b/setup.py
@@ -205,7 +205,7 @@ def write_version(filename=os.path.join(*['airflow',
     'flask-bcrypt>=0.7.1',
 ]
 pinot = ['pinotdb>=0.1.1']
-postgres = ['psycopg2-binary>=2.7.4']
+postgres = ['psycopg2>=2.7.4']
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']
 redis = ['redis>=2.10.5,<3.0.0']

From 75e800cfdfffddfa42a06833747eb35a28431553 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 16:56:54 +0000
Subject: [PATCH 430/808] Update CHANGELOG.txt

---
 CHANGELOG.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index daa5011c273fe..3766f3b9142dd 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -124,6 +124,11 @@ Improvements:
 [AIRFLOW-3301] Update DockerOperator CI test for PR #3977 (#4138)
 [AIRFLOW-3478] Make sure that the session is closed
 [AIRFLOW-3687] Add missing @apply_defaults decorators (#4498)
+[AIRFLOW-3691] Update notice to 2019 (#4503)
+[AIRFLOW-3689] Update pop-up message when deleting DAG in RBAC UI (#4505)
+[AIRFLOW-2801] Skip test_mark_success_no_kill in PostgreSQL on CI (#3642)
+[AIRFLOW-3692] Remove ENV variables to avoid GPL (#4506)
+[AIRFLOW-3693] Replace psycopg2-binary by psycopg2 (#4508)
 
 Bug fixes:
 
@@ -191,6 +196,7 @@ Bug fixes:
 [AIRFLOW-3239] Fix/refine tests for api/common/experimental/ (#4255)
 [AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
 [AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
+[AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
 
 Doc-only changes:
 
@@ -209,6 +215,10 @@ Doc-only changes:
 [AIRFLOW-XXX] Add `BigQueryGetDataOperator` to Integration Docs (#4063)
 [AIRFLOW-XXX] Don't spam test logs with "bad cron expression" messages (#3973)
 [AIRFLOW-XXX] Update committer list based on latest TLP discussion (#4427)
+[AIRFLOW-XXX] Fix incorrect statement in contributing guide (#4104)
+[AIRFLOW-XXX] Fix Broken Link in CONTRIBUTING.md
+[AIRFLOW-XXX] Update Contributing Guide - Git Hooks (#4120)
+[AIRFLOW-3426] Correct Python Version Documentation Reference (#4259)
 
 AIRFLOW 1.10.1, 2018-11-13
 

From ec3d80dc20cab4b6fd61efd4f1e2e5055125dee2 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Fri, 22 Jun 2018 16:35:48 +0200
Subject: [PATCH 431/808] [AIRFLOW-2663] Add instructions to install SSH
 dependencies

Closes #3536 from kaxil/patch-1
---
 docs/installation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index 0ca7c9717c6cc..a39e8232f6cf4 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -104,6 +104,8 @@ Here's the list of the subpackages and what they enable:
 +---------------+----------------------------------------------+-------------------------------------------------+
 |  slack        | ``pip install apache-airflow[slack]``        | ``SlackAPIPostOperator``                        |
 +---------------+----------------------------------------------+-------------------------------------------------+
+|  ssh          | ``pip install apache-airflow[ssh]``          | SSh hooks and Operator                          |
++---------------+----------------------------------------------+-------------------------------------------------+
 |  vertica      | ``pip install apache-airflow[vertica]``      | Vertica hook                                    |
 |               |                                              | support as an Airflow backend                   |
 +---------------+----------------------------------------------+-------------------------------------------------+

From f23f0eb4e269cb5fb1af481e5948e7951306d6f6 Mon Sep 17 00:00:00 2001
From: "Taylor D. Edmiston" <tedmiston@gmail.com>
Date: Wed, 15 Aug 2018 01:09:26 -0400
Subject: [PATCH 432/808] [AIRFLOW-XXX] Clean up installation extra packages
 table (#3750)

Sort the extra packages table, use official product names, improve
capitalization, and make table whitespace consistent.
---
 docs/installation.rst | 67 +++++++++++++++++++++----------------------
 1 file changed, 33 insertions(+), 34 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index a39e8232f6cf4..5623bcbf3f91a 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -50,68 +50,67 @@ Here's the list of the subpackages and what they enable:
 +---------------+----------------------------------------------+-------------------------------------------------+
 | subpackage    | install command                              | enables                                         |
 +===============+==============================================+=================================================+
-|  all          | ``pip install apache-airflow[all]``          | All Airflow features known to man               |
+| all           | ``pip install apache-airflow[all]``          | All Airflow features known to man               |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  all_dbs      | ``pip install apache-airflow[all_dbs]``      | All databases integrations                      |
+| all_dbs       | ``pip install apache-airflow[all_dbs]``      | All databases integrations                      |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  async        | ``pip install apache-airflow[async]``        | Async worker classes for gunicorn               |
+| async         | ``pip install apache-airflow[async]``        | Async worker classes for Gunicorn               |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  devel        | ``pip install apache-airflow[devel]``        | Minimum dev tools requirements                  |
+| celery        | ``pip install apache-airflow[celery]``       | CeleryExecutor                                  |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  devel_hadoop | ``pip install apache-airflow[devel_hadoop]`` | Airflow + dependencies on the Hadoop stack      |
+| cloudant      | ``pip install apache-airflow[cloudant]``     | Cloudant hook                                   |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  celery       | ``pip install apache-airflow[celery]``       | CeleryExecutor                                  |
+| crypto        | ``pip install apache-airflow[crypto]``       | Encrypt connection passwords in metadata db     |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  crypto       | ``pip install apache-airflow[crypto]``       | Encrypt connection passwords in metadata db     |
+| devel         | ``pip install apache-airflow[devel]``        | Minimum dev tools requirements                  |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  druid        | ``pip install apache-airflow[druid]``        | Druid.io related operators & hooks              |
+| devel_hadoop  | ``pip install apache-airflow[devel_hadoop]`` | Airflow + dependencies on the Hadoop stack      |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  gcp_api      | ``pip install apache-airflow[gcp_api]``      | Google Cloud Platform hooks and operators       |
+| druid         | ``pip install apache-airflow[druid]``        | Druid related operators & hooks                 |
++---------------+----------------------------------------------+-------------------------------------------------+
+| gcp_api       | ``pip install apache-airflow[gcp_api]``      | Google Cloud Platform hooks and operators       |
 |               |                                              | (using ``google-api-python-client``)            |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  jdbc         | ``pip install apache-airflow[jdbc]``         | JDBC hooks and operators                        |
+| hdfs          | ``pip install apache-airflow[hdfs]``         | HDFS hooks and operators                        |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  hdfs         | ``pip install apache-airflow[hdfs]``         | HDFS hooks and operators                        |
+| hive          | ``pip install apache-airflow[hive]``         | All Hive related operators                      |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  hive         | ``pip install apache-airflow[hive]``         | All Hive related operators                      |
+| jdbc          | ``pip install apache-airflow[jdbc]``         | JDBC hooks and operators                        |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  kerberos     | ``pip install apache-airflow[kerberos]``     | kerberos integration for kerberized hadoop      |
+| kerbero s     | ``pip install apache-airflow[kerberos]``     | Kerberos integration for Kerberized Hadoop      |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  ldap         | ``pip install apache-airflow[ldap]``         | ldap authentication for users                   |
+| ldap          | ``pip install apache-airflow[ldap]``         | LDAP authentication for users                   |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  mssql        | ``pip install apache-airflow[mssql]``        | Microsoft SQL operators and hook,               |
+| mssql         | ``pip install apache-airflow[mssql]``        | Microsoft SQL Server operators and hook,        |
 |               |                                              | support as an Airflow backend                   |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  mysql        | ``pip install apache-airflow[mysql]``        | MySQL operators and hook, support as            |
-|               |                                              | an Airflow backend. The version of MySQL server |
-|               |                                              | has to be 5.6.4+. The exact version upper bound |
-|               |                                              | depends on version of ``mysqlclient`` package.  |
-|               |                                              | For example, ``mysqlclient`` 1.3.12 can only be |
+| mysql         | ``pip install apache-airflow[mysql]``        | MySQL operators and hook, support as an Airflow |
+|               |                                              | backend. The version of MySQL server has to be  |
+|               |                                              | 5.6.4+. The exact version upper bound depends   |
+|               |                                              | on version of ``mysqlclient`` package. For      |
+|               |                                              | example, ``mysqlclient`` 1.3.12 can only be     |
 |               |                                              | used with MySQL server 5.6.4 through 5.7.       |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  password     | ``pip install apache-airflow[password]``     | Password Authentication for users               |
-+---------------+----------------------------------------------+-------------------------------------------------+
-|  postgres     | ``pip install apache-airflow[postgres]``     | Postgres operators and hook, support            |
-|               |                                              | as an Airflow backend                           |
+| password      | ``pip install apache-airflow[password]``     | Password authentication for users               |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  qds          | ``pip install apache-airflow[qds]``          | Enable QDS (qubole data services) support       |
+| postgres      | ``pip install apache-airflow[postgres]``     | PostgreSQL operators and hook, support as an    |
+|               |                                              | Airflow backend                                 |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  rabbitmq     | ``pip install apache-airflow[rabbitmq]``     | Rabbitmq support as a Celery backend            |
+| qds           | ``pip install apache-airflow[qds]``          | Enable QDS (Qubole Data Service) support        |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  s3           | ``pip install apache-airflow[s3]``           | ``S3KeySensor``, ``S3PrefixSensor``             |
+| rabbitmq      | ``pip install apache-airflow[rabbitmq]``     | RabbitMQ support as a Celery backend            |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  samba        | ``pip install apache-airflow[samba]``        | ``Hive2SambaOperator``                          |
+| redis         | ``pip install apache-airflow[redis]``        | Redis hooks and sensors                         |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  slack        | ``pip install apache-airflow[slack]``        | ``SlackAPIPostOperator``                        |
+| s3            | ``pip install apache-airflow[s3]``           | ``S3KeySensor``, ``S3PrefixSensor``             |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  ssh          | ``pip install apache-airflow[ssh]``          | SSh hooks and Operator                          |
+| samba         | ``pip install apache-airflow[samba]``        | ``Hive2SambaOperator``                          |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  vertica      | ``pip install apache-airflow[vertica]``      | Vertica hook                                    |
-|               |                                              | support as an Airflow backend                   |
+| slack         | ``pip install apache-airflow[slack]``        | ``SlackAPIPostOperator``                        |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  cloudant     | ``pip install apache-airflow[cloudant]``     | Cloudant hook                                   |
+| ssh           | ``pip install apache-airflow[ssh]``          | SSH hooks and Operator                          |
 +---------------+----------------------------------------------+-------------------------------------------------+
-|  redis        | ``pip install apache-airflow[redis]``        | Redis hooks and sensors                         |
+| vertica       | ``pip install apache-airflow[vertica]``      | Vertica hook support as an Airflow backend      |
 +---------------+----------------------------------------------+-------------------------------------------------+
 
 Initiating Airflow Database

From a9c4bf4125e4d354423ea45a771e25f974d039a9 Mon Sep 17 00:00:00 2001
From: Naman Bhalla <namanbhalla1998@gmail.com>
Date: Sat, 8 Sep 2018 21:40:27 +0530
Subject: [PATCH 433/808] [AIRFLOW-XXX] Remove redundant space in Kerberos
 (#3866)

---
 docs/installation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index 5623bcbf3f91a..550e365af6c4c 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -77,7 +77,7 @@ Here's the list of the subpackages and what they enable:
 +---------------+----------------------------------------------+-------------------------------------------------+
 | jdbc          | ``pip install apache-airflow[jdbc]``         | JDBC hooks and operators                        |
 +---------------+----------------------------------------------+-------------------------------------------------+
-| kerbero s     | ``pip install apache-airflow[kerberos]``     | Kerberos integration for Kerberized Hadoop      |
+| kerberos      | ``pip install apache-airflow[kerberos]``     | Kerberos integration for Kerberized Hadoop      |
 +---------------+----------------------------------------------+-------------------------------------------------+
 | ldap          | ``pip install apache-airflow[ldap]``         | LDAP authentication for users                   |
 +---------------+----------------------------------------------+-------------------------------------------------+

From 28368f6b77243fe30a6ee1acd2b8fbc301130d17 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Tue, 9 Oct 2018 11:14:07 -0400
Subject: [PATCH 434/808] [AIRFLOW-3086] Add extras group for google auth to
 setup.py. (#3917)

To clarify installation instructions for the google auth backend, add an
install group to `setup.py` that installs dependencies google auth via
`pip install apache-airflow[google_auth]`.
---
 docs/installation.rst | 134 ++++++++++++++++++++++--------------------
 docs/security.rst     |  18 ++++++
 setup.py              |   2 +
 3 files changed, 89 insertions(+), 65 deletions(-)

diff --git a/docs/installation.rst b/docs/installation.rst
index 550e365af6c4c..d4778e3fce761 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -47,71 +47,75 @@ these extra dependencies.
 
 Here's the list of the subpackages and what they enable:
 
-+---------------+----------------------------------------------+-------------------------------------------------+
-| subpackage    | install command                              | enables                                         |
-+===============+==============================================+=================================================+
-| all           | ``pip install apache-airflow[all]``          | All Airflow features known to man               |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| all_dbs       | ``pip install apache-airflow[all_dbs]``      | All databases integrations                      |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| async         | ``pip install apache-airflow[async]``        | Async worker classes for Gunicorn               |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| celery        | ``pip install apache-airflow[celery]``       | CeleryExecutor                                  |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| cloudant      | ``pip install apache-airflow[cloudant]``     | Cloudant hook                                   |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| crypto        | ``pip install apache-airflow[crypto]``       | Encrypt connection passwords in metadata db     |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| devel         | ``pip install apache-airflow[devel]``        | Minimum dev tools requirements                  |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| devel_hadoop  | ``pip install apache-airflow[devel_hadoop]`` | Airflow + dependencies on the Hadoop stack      |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| druid         | ``pip install apache-airflow[druid]``        | Druid related operators & hooks                 |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| gcp_api       | ``pip install apache-airflow[gcp_api]``      | Google Cloud Platform hooks and operators       |
-|               |                                              | (using ``google-api-python-client``)            |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| hdfs          | ``pip install apache-airflow[hdfs]``         | HDFS hooks and operators                        |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| hive          | ``pip install apache-airflow[hive]``         | All Hive related operators                      |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| jdbc          | ``pip install apache-airflow[jdbc]``         | JDBC hooks and operators                        |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| kerberos      | ``pip install apache-airflow[kerberos]``     | Kerberos integration for Kerberized Hadoop      |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| ldap          | ``pip install apache-airflow[ldap]``         | LDAP authentication for users                   |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| mssql         | ``pip install apache-airflow[mssql]``        | Microsoft SQL Server operators and hook,        |
-|               |                                              | support as an Airflow backend                   |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| mysql         | ``pip install apache-airflow[mysql]``        | MySQL operators and hook, support as an Airflow |
-|               |                                              | backend. The version of MySQL server has to be  |
-|               |                                              | 5.6.4+. The exact version upper bound depends   |
-|               |                                              | on version of ``mysqlclient`` package. For      |
-|               |                                              | example, ``mysqlclient`` 1.3.12 can only be     |
-|               |                                              | used with MySQL server 5.6.4 through 5.7.       |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| password      | ``pip install apache-airflow[password]``     | Password authentication for users               |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| postgres      | ``pip install apache-airflow[postgres]``     | PostgreSQL operators and hook, support as an    |
-|               |                                              | Airflow backend                                 |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| qds           | ``pip install apache-airflow[qds]``          | Enable QDS (Qubole Data Service) support        |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| rabbitmq      | ``pip install apache-airflow[rabbitmq]``     | RabbitMQ support as a Celery backend            |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| redis         | ``pip install apache-airflow[redis]``        | Redis hooks and sensors                         |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| s3            | ``pip install apache-airflow[s3]``           | ``S3KeySensor``, ``S3PrefixSensor``             |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| samba         | ``pip install apache-airflow[samba]``        | ``Hive2SambaOperator``                          |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| slack         | ``pip install apache-airflow[slack]``        | ``SlackAPIPostOperator``                        |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| ssh           | ``pip install apache-airflow[ssh]``          | SSH hooks and Operator                          |
-+---------------+----------------------------------------------+-------------------------------------------------+
-| vertica       | ``pip install apache-airflow[vertica]``      | Vertica hook support as an Airflow backend      |
-+---------------+----------------------------------------------+-------------------------------------------------+
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| subpackage          | install command                                   | enables                                         |
++=====================+===================================================+=================================================+
+| all                 | ``pip install apache-airflow[all]``               | All Airflow features known to man               |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| all_dbs             | ``pip install apache-airflow[all_dbs]``           | All databases integrations                      |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| async               | ``pip install apache-airflow[async]``             | Async worker classes for Gunicorn               |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| celery              | ``pip install apache-airflow[celery]``            | CeleryExecutor                                  |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| cloudant            | ``pip install apache-airflow[cloudant]``          | Cloudant hook                                   |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| crypto              | ``pip install apache-airflow[crypto]``            | Encrypt connection passwords in metadata db     |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| devel               | ``pip install apache-airflow[devel]``             | Minimum dev tools requirements                  |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| devel_hadoop        | ``pip install apache-airflow[devel_hadoop]``      | Airflow + dependencies on the Hadoop stack      |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| druid               | ``pip install apache-airflow[druid]``             | Druid related operators & hooks                 |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| gcp_api             | ``pip install apache-airflow[gcp_api]``           | Google Cloud Platform hooks and operators       |
+|                     |                                                   | (using ``google-api-python-client``)            |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| github_enterprise   | ``pip install apache-airflow[github_enterprise]`` | Github Enterprise auth backend                  |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| google_auth         | ``pip install apache-airflow[google_auth]``       | Google auth backend                             |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| hdfs                | ``pip install apache-airflow[hdfs]``              | HDFS hooks and operators                        |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| hive                | ``pip install apache-airflow[hive]``              | All Hive related operators                      |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| jdbc                | ``pip install apache-airflow[jdbc]``              | JDBC hooks and operators                        |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| kerberos            | ``pip install apache-airflow[kerberos]``          | Kerberos integration for Kerberized Hadoop      |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| ldap                | ``pip install apache-airflow[ldap]``              | LDAP authentication for users                   |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| mssql               | ``pip install apache-airflow[mssql]``             | Microsoft SQL Server operators and hook,        |
+|                     |                                                   | support as an Airflow backend                   |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| mysql               | ``pip install apache-airflow[mysql]``             | MySQL operators and hook, support as an Airflow |
+|                     |                                                   | backend. The version of MySQL server has to be  |
+|                     |                                                   | 5.6.4+. The exact version upper bound depends   |
+|                     |                                                   | on version of ``mysqlclient`` package. For      |
+|                     |                                                   | example, ``mysqlclient`` 1.3.12 can only be     |
+|                     |                                                   | used with MySQL server 5.6.4 through 5.7.       |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| password            | ``pip install apache-airflow[password]``          | Password authentication for users               |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| postgres            | ``pip install apache-airflow[postgres]``          | PostgreSQL operators and hook, support as an    |
+|                     |                                                   | Airflow backend                                 |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| qds                 | ``pip install apache-airflow[qds]``               | Enable QDS (Qubole Data Service) support        |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| rabbitmq            | ``pip install apache-airflow[rabbitmq]``          | RabbitMQ support as a Celery backend            |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| redis               | ``pip install apache-airflow[redis]``             | Redis hooks and sensors                         |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| s3                  | ``pip install apache-airflow[s3]``                | ``S3KeySensor``, ``S3PrefixSensor``             |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| samba               | ``pip install apache-airflow[samba]``             | ``Hive2SambaOperator``                          |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| slack               | ``pip install apache-airflow[slack]``             | ``SlackAPIPostOperator``                        |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| ssh                 | ``pip install apache-airflow[ssh]``               | SSH hooks and Operator                          |
++---------------------+---------------------------------------------------+-------------------------------------------------+
+| vertica             | ``pip install apache-airflow[vertica]``           | Vertica hook support as an Airflow backend      |
++---------------------+---------------------------------------------------+-------------------------------------------------+
 
 Initiating Airflow Database
 '''''''''''''''''''''''''''
diff --git a/docs/security.rst b/docs/security.rst
index 13f7eeb57dc7b..dec8c3fe0e73e 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -249,6 +249,12 @@ and in your DAG, when initializing the HiveOperator, specify:
 
     run_as_owner=True
 
+To use kerberos authentication, you must install Airflow with the `kerberos` extras group:
+
+.. code-block:: base
+
+   pip install airflow[kerberos]
+
 OAuth Authentication
 --------------------
 
@@ -276,6 +282,12 @@ to only members of those teams.
 .. note:: If you do not specify a team whitelist, anyone with a valid account on
    your GHE installation will be able to login to Airflow.
 
+To use GHE authentication, you must install Airflow with the `github_enterprise` extras group:
+
+.. code-block:: base
+
+   pip install airflow[github_enterprise]
+
 Setting up GHE Authentication
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -318,6 +330,12 @@ login, separated with a comma, to only members of those domains.
     oauth_callback_route = /oauth2callback
     domain = "example1.com,example2.com"
 
+To use Google authentication, you must install Airflow with the `google_auth` extras group:
+
+.. code-block:: base
+
+   pip install airflow[google_auth]
+
 Setting up Google Authentication
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/setup.py b/setup.py
index ca6e3436cf953..6e90ae2ebff9c 100644
--- a/setup.py
+++ b/setup.py
@@ -182,6 +182,7 @@ def write_version(filename=os.path.join(*['airflow',
     'pandas-gbq'
 ]
 github_enterprise = ['Flask-OAuthlib>=0.9.1']
+google_auth = ['Flask-OAuthlib>=0.9.1']
 hdfs = ['snakebite>=2.7.8']
 hive = [
     'hmsclient>=0.1.0',
@@ -350,6 +351,7 @@ def do_setup():
             'emr': emr,
             'gcp_api': gcp_api,
             'github_enterprise': github_enterprise,
+            'google_auth': google_auth,
             'hdfs': hdfs,
             'hive': hive,
             'jdbc': jdbc,

From e02e9741b4e832100c5b0305c9b75a801af43a93 Mon Sep 17 00:00:00 2001
From: Gabriel Nicolas Avellaneda <avellaneda.gabriel@gmail.com>
Date: Wed, 5 Dec 2018 17:55:38 -0200
Subject: [PATCH 435/808] [AIRFLOW-XXX] Add Kubernetes Dependency in Extra
 Packages Doc (#4281)

---
 docs/installation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index d4778e3fce761..2c9436e2f997b 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -83,6 +83,8 @@ Here's the list of the subpackages and what they enable:
 +---------------------+---------------------------------------------------+-------------------------------------------------+
 | kerberos            | ``pip install apache-airflow[kerberos]``          | Kerberos integration for Kerberized Hadoop      |
 +---------------------+---------------------------------------------------+-------------------------------------------------+
+| kubernetes          | ``pip install apache-airflow[kubernetes]``        | Kubernetes Executor and operator                |
++---------------------+---------------------------------------------------+-------------------------------------------------+
 | ldap                | ``pip install apache-airflow[ldap]``              | LDAP authentication for users                   |
 +---------------------+---------------------------------------------------+-------------------------------------------------+
 | mssql               | ``pip install apache-airflow[mssql]``             | Microsoft SQL Server operators and hook,        |

From 657aaec3d6565b31d0d7bf7d15ebfae830d7daf5 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 17:48:18 +0000
Subject: [PATCH 436/808] Update CHANGELOG.txt

---
 CHANGELOG.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 3766f3b9142dd..66fb4940bc928 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -219,6 +219,11 @@ Doc-only changes:
 [AIRFLOW-XXX] Fix Broken Link in CONTRIBUTING.md
 [AIRFLOW-XXX] Update Contributing Guide - Git Hooks (#4120)
 [AIRFLOW-3426] Correct Python Version Documentation Reference (#4259)
+[AIRFLOW-2663] Add instructions to install SSH dependencies
+[AIRFLOW-XXX] Clean up installation extra packages table (#3750)
+[AIRFLOW-XXX] Remove redundant space in Kerberos (#3866)
+[AIRFLOW-3086] Add extras group for google auth to setup.py (#3917)
+[AIRFLOW-XXX] Add Kubernetes Dependency in Extra Packages Doc (#4281)
 
 AIRFLOW 1.10.1, 2018-11-13
 

From 2925d7f0dfd501dab00a009ce437128cb289ae8d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 19:38:56 +0000
Subject: [PATCH 437/808] Remove Duplicates from Changelog

---
 CHANGELOG.txt | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 66fb4940bc928..6d463566d9ab1 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -52,7 +52,6 @@ Improvements:
 [AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
 [AIRFLOW-3059] Log how many rows are read from Postgres (#3905)
 [AIRFLOW-2463] Make task instance context available for hive queries
-[AIRFLOW-3190] Make flake8 compliant
 [AIRFLOW-3190] Make flake8 compliant (#4035)
 [AIRFLOW-1998] Implemented DatabricksRunNowOperator for jobs/run-now … (#3813)
 [AIRFLOW-2267] Airflow DAG level access (#3197)
@@ -84,7 +83,6 @@ Improvements:
 [AIRFLOW-491] Add feature to pass extra api configs to BQ Hook (#3733)
 [AIRFLOW-2889] Fix typos detected by github.com/client9/misspell (#3732)
 [AIRFLOW-850] Add a PythonSensor (#4349)
-[AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
 [AIRFLOW-2747] Explicit re-schedule of sensors (#3596)
 [AIRFLOW-3392] Add index on dag_id in sla_miss table (#4235)
 [AIRFLOW-3001] Add index 'ti_dag_date' to taskinstance (#3885)
@@ -97,7 +95,6 @@ Improvements:
 [AIRFLOW-2785] Add context manager entry points to mongoHook
 [AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
 [AIRFLOW-3479] Keeps records in Log Table when DAG is deleted (#4287)
-[AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
 [AIRFLOW-2948] Arg check & better doc - SSHOperator & SFTPOperator (#3793)
 [AIRFLOW-2245] Add remote_host of SSH/SFTP operator as templated field (#3765)
 [AIRFLOW-2670] Update SSH Operator's Hook to respect timeout (#3666)

From 80d33ade8b71fce55cdaf3a95260f9405abf962f Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 13 Jan 2019 20:12:53 +0000
Subject: [PATCH 438/808] [AIRFLOW-3696] Add Version info to Airflow
 Documentation (#4512)

---
 docs/conf.py | 106 ++++++++++++++++++++++++++-------------------------
 1 file changed, 54 insertions(+), 52 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 577b86da706eb..0b5e69f159b18 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,6 +35,8 @@
 import sys
 import mock
 
+import airflow
+
 MOCK_MODULES = [
     'googleapiclient',
     'googleapiclient.errors',
@@ -53,12 +55,10 @@
 for mod_name in MOCK_MODULES:
     sys.modules[mod_name] = mock.Mock()
 
-
 # Hack to allow changing for piece of the code to behave differently while
 # the docs are being built. The main objective was to alter the
 # behavior of the utils.apply_default that was hiding function headers
 os.environ['BUILDING_AIRFLOW_DOCS'] = 'TRUE'
-from airflow import settings
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -67,7 +67,7 @@
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
-#needs_sphinx = '1.0'
+# needs_sphinx = '1.0'
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -92,33 +92,35 @@
 source_suffix = '.rst'
 
 # The encoding of source files.
-#source_encoding = 'utf-8-sig'
+# source_encoding = 'utf-8-sig'
 
 # The master toctree document.
 master_doc = 'index'
 
 # General information about the project.
 project = u'Airflow'
-#copyright = u''
+# copyright = u''
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-#version = '1.0.0'
+# version = '1.0.0'
+version = airflow.__version__
 # The full version, including alpha/beta/rc tags.
-#release = '1.0.0'
+# release = '1.0.0'
+release = airflow.__version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
-#language = None
+# language = None
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
-#today = ''
+# today = ''
 # Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
+# today_fmt = '%B %d, %Y'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -126,27 +128,27 @@
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
-#default_role = None
+# default_role = None
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
+# add_function_parentheses = True
 
 # If true, the current module name will be prepended to all description
 # unit titles (such as .. function::).
-#add_module_names = True
+# add_module_names = True
 
 # If true, sectionauthor and moduleauthor directives will be shown in the
 # output. They are ignored by default.
-#show_authors = False
+# show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
 
 # A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
+# modindex_common_prefix = []
 
 # If true, keep warnings as "system message" paragraphs in the built documents.
-#keep_warnings = False
+# keep_warnings = False
 
 
 intersphinx_mapping = {
@@ -162,11 +164,12 @@
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-#html_theme_options = {}
+# html_theme_options = {}
 
 # Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
+# html_theme_path = []
 import sphinx_rtd_theme
+
 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
@@ -178,12 +181,12 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = None
+# html_logo = None
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = None
+# html_favicon = None
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
@@ -193,37 +196,37 @@
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
 # directly to the root of the documentation.
-#html_extra_path = []
+# html_extra_path = []
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
+# html_last_updated_fmt = '%b %d, %Y'
 
 # If true, SmartyPants will be used to convert quotes and dashes to
 # typographically correct entities.
-#html_use_smartypants = True
+# html_use_smartypants = True
 
 # Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
+# html_sidebars = {}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-#html_additional_pages = {}
+# html_additional_pages = {}
 
 # If false, no module index is generated.
-#html_domain_indices = True
+# html_domain_indices = True
 
 # If false, no index is generated.
 html_use_index = True
 
 # If true, the index is split into individual pages for each letter.
-#html_split_index = False
+# html_split_index = False
 
 # If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
+# html_show_sourcelink = True
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
+# html_show_sphinx = True
 
 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
 html_show_copyright = False
@@ -231,55 +234,54 @@
 # If true, an OpenSearch description file will be output, and all pages will
 # contain a <link> tag referring to it.  The value of this option must be the
 # base URL from which the finished HTML is served.
-#html_use_opensearch = ''
+# html_use_opensearch = ''
 
 # This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
+# html_file_suffix = None
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'Airflowdoc'
 
-
 # -- Options for LaTeX output ---------------------------------------------
 
 latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
+    # The paper size ('letterpaper' or 'a4paper').
+    # 'papersize': 'letterpaper',
 
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
+    # The font size ('10pt', '11pt' or '12pt').
+    # 'pointsize': '10pt',
 
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
+    # Additional stuff for the LaTeX preamble.
+    # 'preamble': '',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-  ('index', 'Airflow.tex', u'Airflow Documentation',
-   u'Apache Airflow', 'manual'),
+    ('index', 'Airflow.tex', u'Airflow Documentation',
+     u'Apache Airflow', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
 # the title page.
-#latex_logo = None
+# latex_logo = None
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # not chapters.
-#latex_use_parts = False
+# latex_use_parts = False
 
 # If true, show page references after internal links.
-#latex_show_pagerefs = False
+# latex_show_pagerefs = False
 
 # If true, show URL addresses after external links.
-#latex_show_urls = False
+# latex_show_urls = False
 
 # Documents to append as an appendix to all manuals.
-#latex_appendices = []
+# latex_appendices = []
 
 # If false, no module index is generated.
-#latex_domain_indices = True
+# latex_domain_indices = True
 
 
 # -- Options for manual page output ---------------------------------------
@@ -292,7 +294,7 @@
 ]
 
 # If true, show URL addresses after external links.
-#man_show_urls = False
+# man_show_urls = False
 
 
 # -- Options for Texinfo output -------------------------------------------
@@ -305,16 +307,16 @@
     u'Apache Airflow', 'Airflow',
     'Airflow is a system to programmaticaly author, schedule and monitor data pipelines.',
     'Miscellaneous'
-),]
+), ]
 
 # Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
+# texinfo_appendices = []
 
 # If false, no module index is generated.
-#texinfo_domain_indices = True
+# texinfo_domain_indices = True
 
 # How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
+# texinfo_show_urls = 'footnote'
 
 # If true, do not generate a @detailmenu in the "Top" node's menu.
-#texinfo_no_detailmenu = False
+# texinfo_no_detailmenu = False

From 580d15015ffa7db831fb2b7f4328b999b207bb08 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 20:36:42 +0000
Subject: [PATCH 439/808] [AIRFLOW-XXX] Add CHANGELOG & K8s to Documentation

---
 CHANGELOG.txt       | 4038 ++++++++++++++++++++++---------------------
 docs/changelog.rst  |   21 +
 docs/index.rst      |    2 +
 docs/kubernetes.rst |    3 +
 4 files changed, 2049 insertions(+), 2015 deletions(-)
 create mode 100644 docs/changelog.rst

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 6d463566d9ab1..2e319607da7b2 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,2055 +1,2063 @@
-AIRFLOW 1.10.2b2, 2019-01-12
+Airflow 1.10.2b2, 2019-01-12
 ----------------------------
 
-New features:
+New features
+""""""""""""
 
-[AIRFLOW-2658] Add GCP specific k8s pod operator (#3532)
-[AIRFLOW-2440] Google Cloud SQL import/export operator (#4251)
-[AIRFLOW-3212] Add AwsGlueCatalogPartitionSensor (#4112)
-[AIRFLOW-2750] Add subcommands to delete and list users
-[AIRFLOW-3480] Add GCP Spanner Database Operators (#4353)
-[AIRFLOW-3560] Add DayOfWeek Sensor (#4363)
-[AIRFLOW-3371] BigQueryHook's Ability to Create View (#4213)
-[AIRFLOW-3332] Add method to allow inserting rows into BQ table (#4179)
-[AIRFLOW-3055] add get_dataset and get_datasets_list to bigquery_hook (#3894)
-[AIRFLOW-2887] Added BigQueryCreateEmptyDatasetOperator and create_emty_dataset to bigquery_hook (#3876)
-[AIRFLOW-2758] Add a sensor for MongoDB
-[AIRFLOW-2640] Add Cassandra table sensor
-[AIRFLOW-3398] Google Cloud Spanner instance database query operator (#4314)
-[AIRFLOW-3310] Google Cloud Spanner deploy / delete operators (#4286)
-[AIRFLOW-3406] Implement an Azure CosmosDB operator (#4265)
-[AIRFLOW-3434] Allows creating intermediate dirs in SFTPOperator (#4270)
-[AIRFLOW-3345] Add Google Cloud Storage (GCS) operators for ACL (#4192)
-[AIRFLOW-3266] Add AWS Athena Hook and Operator (#4111)
-[AIRFLOW-3346] Add hook and operator for GCP transfer service (#4189)
-[AIRFLOW-2983] Add prev_ds_nodash and next_ds_nodash macro (#3821)
-[AIRFLOW-3403] Add AWS Athena Sensor (#4244)
-[AIRFLOW-3323] Support HTTP basic authentication for Airflow Flower (#4166)
-[AIRFLOW-3410] Add feature to allow Host Key Change for SSH Op (#4249)
-[AIRFLOW-3275] Add Google Cloud SQL Query operator (#4170)
-[AIRFLOW-2691] Manage JS dependencies via npm
-[AIRFLOW-2795] Oracle to Oracle Transfer Operator (#3639)
-[AIRFLOW-2596] Add Oracle to Azure Datalake Transfer Operator
-[AIRFLOW-3220] Add Instance Group Manager Operators for GCE (#4167)
-[AIRFLOW-2882] Add import and export for pool cli using JSON
-[AIRFLOW-2965] CLI tool to show the next execution datetime (#3834)
+- [AIRFLOW-2658] Add GCP specific k8s pod operator (#3532)
+- [AIRFLOW-2440] Google Cloud SQL import/export operator (#4251)
+- [AIRFLOW-3212] Add AwsGlueCatalogPartitionSensor (#4112)
+- [AIRFLOW-2750] Add subcommands to delete and list users
+- [AIRFLOW-3480] Add GCP Spanner Database Operators (#4353)
+- [AIRFLOW-3560] Add DayOfWeek Sensor (#4363)
+- [AIRFLOW-3371] BigQueryHook's Ability to Create View (#4213)
+- [AIRFLOW-3332] Add method to allow inserting rows into BQ table (#4179)
+- [AIRFLOW-3055] add get_dataset and get_datasets_list to bigquery_hook (#3894)
+- [AIRFLOW-2887] Added BigQueryCreateEmptyDatasetOperator and create_emty_dataset to bigquery_hook (#3876)
+- [AIRFLOW-2758] Add a sensor for MongoDB
+- [AIRFLOW-2640] Add Cassandra table sensor
+- [AIRFLOW-3398] Google Cloud Spanner instance database query operator (#4314)
+- [AIRFLOW-3310] Google Cloud Spanner deploy / delete operators (#4286)
+- [AIRFLOW-3406] Implement an Azure CosmosDB operator (#4265)
+- [AIRFLOW-3434] Allows creating intermediate dirs in SFTPOperator (#4270)
+- [AIRFLOW-3345] Add Google Cloud Storage (GCS) operators for ACL (#4192)
+- [AIRFLOW-3266] Add AWS Athena Hook and Operator (#4111)
+- [AIRFLOW-3346] Add hook and operator for GCP transfer service (#4189)
+- [AIRFLOW-2983] Add prev_ds_nodash and next_ds_nodash macro (#3821)
+- [AIRFLOW-3403] Add AWS Athena Sensor (#4244)
+- [AIRFLOW-3323] Support HTTP basic authentication for Airflow Flower (#4166)
+- [AIRFLOW-3410] Add feature to allow Host Key Change for SSH Op (#4249)
+- [AIRFLOW-3275] Add Google Cloud SQL Query operator (#4170)
+- [AIRFLOW-2691] Manage JS dependencies via npm
+- [AIRFLOW-2795] Oracle to Oracle Transfer Operator (#3639)
+- [AIRFLOW-2596] Add Oracle to Azure Datalake Transfer Operator
+- [AIRFLOW-3220] Add Instance Group Manager Operators for GCE (#4167)
+- [AIRFLOW-2882] Add import and export for pool cli using JSON
+- [AIRFLOW-2965] CLI tool to show the next execution datetime (#3834)
 
-Improvements:
+Improvements
+""""""""""""
 
-[AIRFLOW-3680] Consistency update in tests for All GCP-related operators (#4493)
-[AIRFLOW-3675] Use googlapiclient for google apis (#4484)
-[AIRFLOW-3205] Support multipart uploads to GCS (#4084)
-[AIRFLOW-2826] Add GoogleCloudKMSHook (#3677)
-[AIRFLOW-3676] Add required permission to CloudSQL export/import example (#4489)
-[AIRFLOW-3679] Added Google Cloud Base Hook to documentation (#4487)
-[AIRFLOW-3594] Unify different License Header
-[AIRFLOW-3197] Remove invalid parameter KeepJobFlowAliveWhenNoSteps in example DAG (#4404)
-[AIRFLOW-3504] Refine the functionality of "/health" endpoint (#4309)
-[AIRFLOW-3103][AIRFLOW-3147] Update flask-appbuilder (#3937)
-[AIRFLOW-3168] More resillient database use in CI (#4014)
-[AIRFLOW-3076] Remove preloading of MySQL testdata (#3911)
-[AIRFLOW-3035] Allow custom 'job_error_states' in dataproc ops (#3884)
-[AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
-[AIRFLOW-3059] Log how many rows are read from Postgres (#3905)
-[AIRFLOW-2463] Make task instance context available for hive queries
-[AIRFLOW-3190] Make flake8 compliant (#4035)
-[AIRFLOW-1998] Implemented DatabricksRunNowOperator for jobs/run-now … (#3813)
-[AIRFLOW-2267] Airflow DAG level access (#3197)
-[AIRFLOW-2359] Add set failed for DagRun and task in tree view (#3255)
-[AIRFLOW-3008] Move Kubernetes example DAGs to contrib
-[AIRFLOW-3402] Support global k8s affinity and toleration configs (#4247)
-[AIRFLOW-3610] Add region param for EMR jobflow creation (#4418)
-[AIRFLOW-3531] Fix test for GCS to GCS Transfer Hook (#4452)
-[AIRFLOW-3531] Add gcs to gcs transfer operator. (#4331)
-[AIRFLOW-3034]: Readme updates : Add Slack & Twitter, remove Gitter
-[AIRFLOW-3028] Update Text & Images in Readme.md
-[AIRFLOW-208] Add badge to show supported Python versions (#3839)
-[AIRFLOW-2238] Update PR tool to push directly to Github
-[AIRFLOW-2238] Flake8 fixes on dev/airflow-pr
-[AIRFLOW-2238] Update PR tool to remove outdated info (#3978)
-[AIRFLOW-3005] Replace 'Airbnb Airflow' with 'Apache Airflow' (#3845)
-[AIRFLOW-3150] Make execution_date templated in TriggerDagRunOperator (#4359)
-[AIRFLOW-1196][AIRFLOW-2399] Add templated field in TriggerDagRunOperator (#4228)
-[AIRFLOW-3340] Placeholder support in connections form (#4185)
-[AIRFLOW-3446] Add Google Cloud BigTable operators (#4354)
-[AIRFLOW-1921] Add support for https and user auth (#2879)
-[AIRFLOW-2770] Read `dags_in_image` config value as a boolean (#4319)
-[AIRFLOW-3022] Add volume mount to KubernetesExecutorConfig (#3855)
-[AIRFLOW-2917] Set AIRFLOW__CORE__SQL_ALCHEMY_CONN only when needed (#3766)
-[AIRFLOW-2712] Pass annotations to KubernetesExecutorConfig
-[AIRFLOW-461]  Support autodetected schemas in BigQuery run_load (#3880)
-[AIRFLOW-2997] Support cluster fields in bigquery (#3838)
-[AIRFLOW-2916] Arg `verify` for AwsHook() & S3 sensors/operators (#3764)
-[AIRFLOW-491] Add feature to pass extra api configs to BQ Hook (#3733)
-[AIRFLOW-2889] Fix typos detected by github.com/client9/misspell (#3732)
-[AIRFLOW-850] Add a PythonSensor (#4349)
-[AIRFLOW-2747] Explicit re-schedule of sensors (#3596)
-[AIRFLOW-3392] Add index on dag_id in sla_miss table (#4235)
-[AIRFLOW-3001] Add index 'ti_dag_date' to taskinstance (#3885)
-[AIRFLOW-2861] Add index on log table (#3709)
-[AIRFLOW-3518] Performance fixes for topological_sort of Tasks (#4322)
-[AIRFLOW-3521] Fetch more than 50 items in `airflow-jira compare` script (#4300)
-[AIRFLOW-1919] Add option to query for DAG runs given a DAG ID
-[AIRFLOW-3444] Explicitly set transfer operator description. (#4279)
-[AIRFLOW-3411]  Add OpenFaaS hook (#4267)
-[AIRFLOW-2785] Add context manager entry points to mongoHook
-[AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
-[AIRFLOW-3479] Keeps records in Log Table when DAG is deleted (#4287)
-[AIRFLOW-2948] Arg check & better doc - SSHOperator & SFTPOperator (#3793)
-[AIRFLOW-2245] Add remote_host of SSH/SFTP operator as templated field (#3765)
-[AIRFLOW-2670] Update SSH Operator's Hook to respect timeout (#3666)
-[AIRFLOW-3380] Add metrics documentation (#4219)
-[AIRFLOW-3361] Log the task_id in the PendingDeprecationWarning from BaseOperator (#4030)
-[AIRFLOW-3213] Create ADLS to GCS operator (#4134)
-[AIRFLOW-3395] added the REST API endpoints to the doc (#4236)
-[AIRFLOW-3294] Update connections form and integration docs (#4129)
-[AIRFLOW-3236] Create AzureDataLakeStorageListOperator (#4094)
-[AIRFLOW-3062] Add Qubole in integration docs (#3946)
-[AIRFLOW-3306] Disable flask-sqlalchemy modification tracking. (#4146)
-[AIRFLOW-2867] Refactor Code to conform standards (#3714)
-[AIRFLOW-2753] Add dataproc_job_id instance var holding actual DP jobId
-[AIRFLOW-3132] Enable specifying auto_remove option for DockerOperator (#3977)
-[AIRFLOW-2731] Raise psutil restriction to <6.0.0
-[AIRFLOW-3384] Allow higher versions of Sqlalchemy and Jinja2 (#4227)
-[Airflow-2760] Decouple DAG parsing loop from scheduler loop (#3873)
-[AIRFLOW-3004] Add config disabling scheduler cron (#3899)
-[AIRFLOW-3175] Fix docstring format in airflow/jobs.py (#4025)
-[AIRFLOW-3589] Visualize reschedule state in all views (#4408)
-[AIRFLOW-2698] Simplify Kerberos code (#3563)
-[AIRFLOW-2499] Dockerise CI pipeline (#3393)
-[AIRFLOW-3432] Add test for feature "Delete DAG in UI" (#4266)
-[AIRFLOW-3301] Update DockerOperator CI test for PR #3977 (#4138)
-[AIRFLOW-3478] Make sure that the session is closed
-[AIRFLOW-3687] Add missing @apply_defaults decorators (#4498)
-[AIRFLOW-3691] Update notice to 2019 (#4503)
-[AIRFLOW-3689] Update pop-up message when deleting DAG in RBAC UI (#4505)
-[AIRFLOW-2801] Skip test_mark_success_no_kill in PostgreSQL on CI (#3642)
-[AIRFLOW-3692] Remove ENV variables to avoid GPL (#4506)
-[AIRFLOW-3693] Replace psycopg2-binary by psycopg2 (#4508)
+- [AIRFLOW-3680] Consistency update in tests for All GCP-related operators (#4493)
+- [AIRFLOW-3675] Use googlapiclient for google apis (#4484)
+- [AIRFLOW-3205] Support multipart uploads to GCS (#4084)
+- [AIRFLOW-2826] Add GoogleCloudKMSHook (#3677)
+- [AIRFLOW-3676] Add required permission to CloudSQL export/import example (#4489)
+- [AIRFLOW-3679] Added Google Cloud Base Hook to documentation (#4487)
+- [AIRFLOW-3594] Unify different License Header
+- [AIRFLOW-3197] Remove invalid parameter KeepJobFlowAliveWhenNoSteps in example DAG (#4404)
+- [AIRFLOW-3504] Refine the functionality of "/health" endpoint (#4309)
+- [AIRFLOW-3103][AIRFLOW-3147] Update flask-appbuilder (#3937)
+- [AIRFLOW-3168] More resillient database use in CI (#4014)
+- [AIRFLOW-3076] Remove preloading of MySQL testdata (#3911)
+- [AIRFLOW-3035] Allow custom 'job_error_states' in dataproc ops (#3884)
+- [AIRFLOW-3246] Make hmsclient optional in airflow.hooks.hive_hooks (#4080)
+- [AIRFLOW-3059] Log how many rows are read from Postgres (#3905)
+- [AIRFLOW-2463] Make task instance context available for hive queries
+- [AIRFLOW-3190] Make flake8 compliant (#4035)
+- [AIRFLOW-1998] Implemented DatabricksRunNowOperator for jobs/run-now … (#3813)
+- [AIRFLOW-2267] Airflow DAG level access (#3197)
+- [AIRFLOW-2359] Add set failed for DagRun and task in tree view (#3255)
+- [AIRFLOW-3008] Move Kubernetes example DAGs to contrib
+- [AIRFLOW-3402] Support global k8s affinity and toleration configs (#4247)
+- [AIRFLOW-3610] Add region param for EMR jobflow creation (#4418)
+- [AIRFLOW-3531] Fix test for GCS to GCS Transfer Hook (#4452)
+- [AIRFLOW-3531] Add gcs to gcs transfer operator. (#4331)
+- [AIRFLOW-3034]: Readme updates : Add Slack & Twitter, remove Gitter
+- [AIRFLOW-3028] Update Text & Images in Readme.md
+- [AIRFLOW-208] Add badge to show supported Python versions (#3839)
+- [AIRFLOW-2238] Update PR tool to push directly to Github
+- [AIRFLOW-2238] Flake8 fixes on dev/airflow-pr
+- [AIRFLOW-2238] Update PR tool to remove outdated info (#3978)
+- [AIRFLOW-3005] Replace 'Airbnb Airflow' with 'Apache Airflow' (#3845)
+- [AIRFLOW-3150] Make execution_date templated in TriggerDagRunOperator (#4359)
+- [AIRFLOW-1196][AIRFLOW-2399] Add templated field in TriggerDagRunOperator (#4228)
+- [AIRFLOW-3340] Placeholder support in connections form (#4185)
+- [AIRFLOW-3446] Add Google Cloud BigTable operators (#4354)
+- [AIRFLOW-1921] Add support for https and user auth (#2879)
+- [AIRFLOW-2770] Read `dags_in_image` config value as a boolean (#4319)
+- [AIRFLOW-3022] Add volume mount to KubernetesExecutorConfig (#3855)
+- [AIRFLOW-2917] Set AIRFLOW__CORE__SQL_ALCHEMY_CONN only when needed (#3766)
+- [AIRFLOW-2712] Pass annotations to KubernetesExecutorConfig
+- [AIRFLOW-461]  Support autodetected schemas in BigQuery run_load (#3880)
+- [AIRFLOW-2997] Support cluster fields in bigquery (#3838)
+- [AIRFLOW-2916] Arg `verify` for AwsHook() & S3 sensors/operators (#3764)
+- [AIRFLOW-491] Add feature to pass extra api configs to BQ Hook (#3733)
+- [AIRFLOW-2889] Fix typos detected by github.com/client9/misspell (#3732)
+- [AIRFLOW-850] Add a PythonSensor (#4349)
+- [AIRFLOW-2747] Explicit re-schedule of sensors (#3596)
+- [AIRFLOW-3392] Add index on dag_id in sla_miss table (#4235)
+- [AIRFLOW-3001] Add index 'ti_dag_date' to taskinstance (#3885)
+- [AIRFLOW-2861] Add index on log table (#3709)
+- [AIRFLOW-3518] Performance fixes for topological_sort of Tasks (#4322)
+- [AIRFLOW-3521] Fetch more than 50 items in `airflow-jira compare` script (#4300)
+- [AIRFLOW-1919] Add option to query for DAG runs given a DAG ID
+- [AIRFLOW-3444] Explicitly set transfer operator description. (#4279)
+- [AIRFLOW-3411]  Add OpenFaaS hook (#4267)
+- [AIRFLOW-2785] Add context manager entry points to mongoHook
+- [AIRFLOW-2524] Add SageMaker doc to AWS integration section (#4278)
+- [AIRFLOW-3479] Keeps records in Log Table when DAG is deleted (#4287)
+- [AIRFLOW-2948] Arg check & better doc - SSHOperator & SFTPOperator (#3793)
+- [AIRFLOW-2245] Add remote_host of SSH/SFTP operator as templated field (#3765)
+- [AIRFLOW-2670] Update SSH Operator's Hook to respect timeout (#3666)
+- [AIRFLOW-3380] Add metrics documentation (#4219)
+- [AIRFLOW-3361] Log the task_id in the PendingDeprecationWarning from BaseOperator (#4030)
+- [AIRFLOW-3213] Create ADLS to GCS operator (#4134)
+- [AIRFLOW-3395] added the REST API endpoints to the doc (#4236)
+- [AIRFLOW-3294] Update connections form and integration docs (#4129)
+- [AIRFLOW-3236] Create AzureDataLakeStorageListOperator (#4094)
+- [AIRFLOW-3062] Add Qubole in integration docs (#3946)
+- [AIRFLOW-3306] Disable flask-sqlalchemy modification tracking. (#4146)
+- [AIRFLOW-2867] Refactor Code to conform standards (#3714)
+- [AIRFLOW-2753] Add dataproc_job_id instance var holding actual DP jobId
+- [AIRFLOW-3132] Enable specifying auto_remove option for DockerOperator (#3977)
+- [AIRFLOW-2731] Raise psutil restriction to <6.0.0
+- [AIRFLOW-3384] Allow higher versions of Sqlalchemy and Jinja2 (#4227)
+- [Airflow-2760] Decouple DAG parsing loop from scheduler loop (#3873)
+- [AIRFLOW-3004] Add config disabling scheduler cron (#3899)
+- [AIRFLOW-3175] Fix docstring format in airflow/jobs.py (#4025)
+- [AIRFLOW-3589] Visualize reschedule state in all views (#4408)
+- [AIRFLOW-2698] Simplify Kerberos code (#3563)
+- [AIRFLOW-2499] Dockerise CI pipeline (#3393)
+- [AIRFLOW-3432] Add test for feature "Delete DAG in UI" (#4266)
+- [AIRFLOW-3301] Update DockerOperator CI test for PR #3977 (#4138)
+- [AIRFLOW-3478] Make sure that the session is closed
+- [AIRFLOW-3687] Add missing @apply_defaults decorators (#4498)
+- [AIRFLOW-3691] Update notice to 2019 (#4503)
+- [AIRFLOW-3689] Update pop-up message when deleting DAG in RBAC UI (#4505)
+- [AIRFLOW-2801] Skip test_mark_success_no_kill in PostgreSQL on CI (#3642)
+- [AIRFLOW-3692] Remove ENV variables to avoid GPL (#4506)
+- [AIRFLOW-3693] Replace psycopg2-binary by psycopg2 (#4508)
 
-Bug fixes:
+Bug fixes
+"""""""""
 
-[AIRFLOW-3191] Fix not being able to specify execution_date when creating dagrun (#4037)
-[AIRFLOW-3657] Fix zendesk integration (#4466)
-[AIRFLOW-3605] Load plugins from entry_points (#4412)
-[AIRFLOW-3646] Rename plugins_manager.py to test_xx to trigger tests (#4464)
-[AIRFLOW-3655] Escape links generated in model views (#4463)
-[AIRFLOW-3662] Add dependency for Enum (#4468)
-[AIRFLOW-3630] Cleanup of GCP Cloud SQL Connection (#4451)
-[AIRFLOW-1837] Respect task start_date when different from dag's (#4010)
-[AIRFLOW-2829] Brush up the CI script for minikube
-[AIRFLOW-3519] Fix example http operator (#4455)
-[AIRFLOW-2811] Fix scheduler_ops_metrics.py to work (#3653)
-[AIRFLOW-2751] add job properties update in hive to druid operator.
-[AIRFLOW-2918] Remove unused imports
-[AIRFLOW-2918] Fix Flake8 violations (#3931)
-[AIRFLOW-2771] Add except type to broad S3Hook try catch clauses
-[AIRFLOW-2918] Fix Flake8 violations (#3772)
-[AIRFLOW-2099] Handle getsource() calls gracefully
-[AIRFLOW-3397] Fix integrety error in rbac AirflowSecurityManager (#4305)
-[AIRFLOW-3281] Fix Kubernetes operator with git-sync (#3770)
-[AIRFLOW-2615] Limit DAGs parsing to once only
-[AIRFLOW-2952] Fix Kubernetes CI (#3922)
-[AIRFLOW-2933] Enable Codecov on Docker-CI Build (#3780)
-[AIRFLOW-2082] Resolve a bug in adding password_auth to api as auth method (#4343)
-[AIRFLOW-3612] Remove incubation/incubator mention (#4419)
-[AIRFLOW-3581] Fix next_ds/prev_ds semantics for manual runs (#4385)
-[AIRFLOW-3527] Update Cloud SQL Proxy to have shorter path for UNIX socket (#4350)
-[AIRFLOW-3316] For gcs_to_bq: add missing init of schema_fields var (#4430)
-[AIRFLOW-3583] Fix AirflowException import (#4389)
-[AIRFLOW-3578] Fix Type Error for BigQueryOperator (#4384)
-[AIRFLOW-2755] Added `kubernetes.worker_dags_folder` configuration (#3612)
-[AIRFLOW-2655] Fix inconsistency of default config of kubernetes worker
-[AIRFLOW-2645][AIRFLOW-2617] Add worker_container_image_pull_policy
-[AIRFLOW-2661] fix config dags_volume_subpath and logs_volume_subpath
-[AIRFLOW-3550] Standardize GKE hook (#4364)
-[AIRFLOW-2863] Fix GKEClusterHook catching wrong exception (#3711)
-[AIRFLOW-2939][AIRFLOW-3568] Fix TypeError in GCSToS3Op & S3ToGCSOp (#4371)
-[AIRFLOW-3327] Add support for location in BigQueryHook (#4324)
-[AIRFLOW-3438] Fix default values in BigQuery Hook & BigQueryOperator (…
-[AIRFLOW-3355] Fix BigQueryCursor.execute to work with Python3 (#4198)
-[AIRFLOW-3447] Add 2 options for ts_nodash Macro (#4323)
-[AIRFLOW-1552] Airflow Filter_by_owner not working with password_auth (#4276)
-[AIRFLOW-3484] Fix Over-logging in the k8s executor (#4296)
-[AIRFLOW-3309] Add MongoDB connection (#4154)
-[AIRFLOW-3414] Fix reload_module in DagFileProcessorAgent (#4253)
-[AIRFLOW-1252] API accept JSON when invoking a trigger dag (#2334)
-[AIRFLOW-3425] Fix setting default scope in hook (#4261)
-[AIRFLOW-3416] Fixes Python 3 compatibility with CloudSqlQueryOperator (#4254)
-[AIRFLOW-3263] Ignore exception when 'run' kills already killed job (#4108)
-[AIRFLOW-3264] URL decoding when parsing URI for connection (#4109)
-[AIRFLOW-3365][AIRFLOW-3366] Allow celery_broker_transport_options to be set with environment variables (#4211)
-[AIRFLOW-2642] fix wrong value git-sync initcontainer env GIT_SYNC_ROOT (#3519)
-[AIRFLOW-3353] Pin redis verison (#4195)
-[AIRFLOW-3251] KubernetesPodOperator now uses 'image_pull_secrets' argument when creating Pods (#4188)
-[AIRFLOW-2705] Move class-level moto decorator to method-level
-[AIRFLOW-3233] Fix deletion of DAGs in the UI (#4069)
-[AIRFLOW-2908] Allow retries with KubernetesExecutor. (#3758)
-[AIRFLOW-1561] Fix scheduler to pick up example DAGs without other DAGs (#2635)
-[AIRFLOW-3352] Fix expose_config not honoured on RBAC UI (#4194)
-[AIRFLOW-3592] Fix logs when task is in rescheduled state (#4492)
-[AIRFLOW-3634] Fix GCP Spanner Test (#4440)
-[AIRFLOW-XXX] Fix PythonVirtualenvOperator tests (#3968)
-[AIRFLOW-3239] Fix/refine tests for api/common/experimental/ (#4255)
-[AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
-[AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
-[AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
+- [AIRFLOW-3191] Fix not being able to specify execution_date when creating dagrun (#4037)
+- [AIRFLOW-3657] Fix zendesk integration (#4466)
+- [AIRFLOW-3605] Load plugins from entry_points (#4412)
+- [AIRFLOW-3646] Rename plugins_manager.py to test_xx to trigger tests (#4464)
+- [AIRFLOW-3655] Escape links generated in model views (#4463)
+- [AIRFLOW-3662] Add dependency for Enum (#4468)
+- [AIRFLOW-3630] Cleanup of GCP Cloud SQL Connection (#4451)
+- [AIRFLOW-1837] Respect task start_date when different from dag's (#4010)
+- [AIRFLOW-2829] Brush up the CI script for minikube
+- [AIRFLOW-3519] Fix example http operator (#4455)
+- [AIRFLOW-2811] Fix scheduler_ops_metrics.py to work (#3653)
+- [AIRFLOW-2751] add job properties update in hive to druid operator.
+- [AIRFLOW-2918] Remove unused imports
+- [AIRFLOW-2918] Fix Flake8 violations (#3931)
+- [AIRFLOW-2771] Add except type to broad S3Hook try catch clauses
+- [AIRFLOW-2918] Fix Flake8 violations (#3772)
+- [AIRFLOW-2099] Handle getsource() calls gracefully
+- [AIRFLOW-3397] Fix integrety error in rbac AirflowSecurityManager (#4305)
+- [AIRFLOW-3281] Fix Kubernetes operator with git-sync (#3770)
+- [AIRFLOW-2615] Limit DAGs parsing to once only
+- [AIRFLOW-2952] Fix Kubernetes CI (#3922)
+- [AIRFLOW-2933] Enable Codecov on Docker-CI Build (#3780)
+- [AIRFLOW-2082] Resolve a bug in adding password_auth to api as auth method (#4343)
+- [AIRFLOW-3612] Remove incubation/incubator mention (#4419)
+- [AIRFLOW-3581] Fix next_ds/prev_ds semantics for manual runs (#4385)
+- [AIRFLOW-3527] Update Cloud SQL Proxy to have shorter path for UNIX socket (#4350)
+- [AIRFLOW-3316] For gcs_to_bq: add missing init of schema_fields var (#4430)
+- [AIRFLOW-3583] Fix AirflowException import (#4389)
+- [AIRFLOW-3578] Fix Type Error for BigQueryOperator (#4384)
+- [AIRFLOW-2755] Added `kubernetes.worker_dags_folder` configuration (#3612)
+- [AIRFLOW-2655] Fix inconsistency of default config of kubernetes worker
+- [AIRFLOW-2645][AIRFLOW-2617] Add worker_container_image_pull_policy
+- [AIRFLOW-2661] fix config dags_volume_subpath and logs_volume_subpath
+- [AIRFLOW-3550] Standardize GKE hook (#4364)
+- [AIRFLOW-2863] Fix GKEClusterHook catching wrong exception (#3711)
+- [AIRFLOW-2939][AIRFLOW-3568] Fix TypeError in GCSToS3Op & S3ToGCSOp (#4371)
+- [AIRFLOW-3327] Add support for location in BigQueryHook (#4324)
+- [AIRFLOW-3438] Fix default values in BigQuery Hook & BigQueryOperator (…
+- [AIRFLOW-3355] Fix BigQueryCursor.execute to work with Python3 (#4198)
+- [AIRFLOW-3447] Add 2 options for ts_nodash Macro (#4323)
+- [AIRFLOW-1552] Airflow Filter_by_owner not working with password_auth (#4276)
+- [AIRFLOW-3484] Fix Over-logging in the k8s executor (#4296)
+- [AIRFLOW-3309] Add MongoDB connection (#4154)
+- [AIRFLOW-3414] Fix reload_module in DagFileProcessorAgent (#4253)
+- [AIRFLOW-1252] API accept JSON when invoking a trigger dag (#2334)
+- [AIRFLOW-3425] Fix setting default scope in hook (#4261)
+- [AIRFLOW-3416] Fixes Python 3 compatibility with CloudSqlQueryOperator (#4254)
+- [AIRFLOW-3263] Ignore exception when 'run' kills already killed job (#4108)
+- [AIRFLOW-3264] URL decoding when parsing URI for connection (#4109)
+- [AIRFLOW-3365][AIRFLOW-3366] Allow celery_broker_transport_options to be set with environment variables (#4211)
+- [AIRFLOW-2642] fix wrong value git-sync initcontainer env GIT_SYNC_ROOT (#3519)
+- [AIRFLOW-3353] Pin redis verison (#4195)
+- [AIRFLOW-3251] KubernetesPodOperator now uses 'image_pull_secrets' argument when creating Pods (#4188)
+- [AIRFLOW-2705] Move class-level moto decorator to method-level
+- [AIRFLOW-3233] Fix deletion of DAGs in the UI (#4069)
+- [AIRFLOW-2908] Allow retries with KubernetesExecutor. (#3758)
+- [AIRFLOW-1561] Fix scheduler to pick up example DAGs without other DAGs (#2635)
+- [AIRFLOW-3352] Fix expose_config not honoured on RBAC UI (#4194)
+- [AIRFLOW-3592] Fix logs when task is in rescheduled state (#4492)
+- [AIRFLOW-3634] Fix GCP Spanner Test (#4440)
+- [AIRFLOW-XXX] Fix PythonVirtualenvOperator tests (#3968)
+- [AIRFLOW-3239] Fix/refine tests for api/common/experimental/ (#4255)
+- [AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
+- [AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
+- [AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
 
-Doc-only changes:
+Doc-only changes
+""""""""""""""""
 
-[AIRFLOW-XXX] GCP operators documentation clarifications (#4273)
-[AIRFLOW-XXX] Docs: Fix paths to GCS transfer operator (#4479)
-[AIRFLOW-XXX] Add missing GCP operators to Docs (#4260)
-[AIRFLOW-XXX] Fix Docstrings for Operators (#3820)
-[AIRFLOW-XXX] Fix inconsistent comment in example_python_operator.py (#4337)
-[AIRFLOW-XXX] Fix incorrect parameter in SFTPOperator example (#4344)
-[AIRFLOW-XXX] Add missing remote logging field (#4333)
-[AIRFLOW-XXX] Revise template variables documentation (#4172)
-[AIRFLOW-XXX] Fix typo in docstring of gcs_to_bq (#3833)
-[AIRFLOW-XXX] Fix display of SageMaker operators/hook docs (#4263)
-[AIRFLOW-XXX] Better instructions for airflow flower (#4214)
-[AIRFLOW-XXX] Make pip install commands consistent (#3752)
-[AIRFLOW-XXX] Add `BigQueryGetDataOperator` to Integration Docs (#4063)
-[AIRFLOW-XXX] Don't spam test logs with "bad cron expression" messages (#3973)
-[AIRFLOW-XXX] Update committer list based on latest TLP discussion (#4427)
-[AIRFLOW-XXX] Fix incorrect statement in contributing guide (#4104)
-[AIRFLOW-XXX] Fix Broken Link in CONTRIBUTING.md
-[AIRFLOW-XXX] Update Contributing Guide - Git Hooks (#4120)
-[AIRFLOW-3426] Correct Python Version Documentation Reference (#4259)
-[AIRFLOW-2663] Add instructions to install SSH dependencies
-[AIRFLOW-XXX] Clean up installation extra packages table (#3750)
-[AIRFLOW-XXX] Remove redundant space in Kerberos (#3866)
-[AIRFLOW-3086] Add extras group for google auth to setup.py (#3917)
-[AIRFLOW-XXX] Add Kubernetes Dependency in Extra Packages Doc (#4281)
+- [AIRFLOW-XXX] GCP operators documentation clarifications (#4273)
+- [AIRFLOW-XXX] Docs: Fix paths to GCS transfer operator (#4479)
+- [AIRFLOW-XXX] Add missing GCP operators to Docs (#4260)
+- [AIRFLOW-XXX] Fix Docstrings for Operators (#3820)
+- [AIRFLOW-XXX] Fix inconsistent comment in example_python_operator.py (#4337)
+- [AIRFLOW-XXX] Fix incorrect parameter in SFTPOperator example (#4344)
+- [AIRFLOW-XXX] Add missing remote logging field (#4333)
+- [AIRFLOW-XXX] Revise template variables documentation (#4172)
+- [AIRFLOW-XXX] Fix typo in docstring of gcs_to_bq (#3833)
+- [AIRFLOW-XXX] Fix display of SageMaker operators/hook docs (#4263)
+- [AIRFLOW-XXX] Better instructions for airflow flower (#4214)
+- [AIRFLOW-XXX] Make pip install commands consistent (#3752)
+- [AIRFLOW-XXX] Add `BigQueryGetDataOperator` to Integration Docs (#4063)
+- [AIRFLOW-XXX] Don't spam test logs with "bad cron expression" messages (#3973)
+- [AIRFLOW-XXX] Update committer list based on latest TLP discussion (#4427)
+- [AIRFLOW-XXX] Fix incorrect statement in contributing guide (#4104)
+- [AIRFLOW-XXX] Fix Broken Link in CONTRIBUTING.md
+- [AIRFLOW-XXX] Update Contributing Guide - Git Hooks (#4120)
+- [AIRFLOW-3426] Correct Python Version Documentation Reference (#4259)
+- [AIRFLOW-2663] Add instructions to install SSH dependencies
+- [AIRFLOW-XXX] Clean up installation extra packages table (#3750)
+- [AIRFLOW-XXX] Remove redundant space in Kerberos (#3866)
+- [AIRFLOW-3086] Add extras group for google auth to setup.py (#3917)
+- [AIRFLOW-XXX] Add Kubernetes Dependency in Extra Packages Doc (#4281)
 
-AIRFLOW 1.10.1, 2018-11-13
+Airflow 1.10.1, 2018-11-13
+--------------------------
 
-New features:
+New features
+""""""""""""
 
-[AIRFLOW-2524] Airflow integration with AWS Sagemaker
-[AIRFLOW-2657] Add ability to delete DAG from web ui
-[AIRFLOW-2780] Adds IMAP Hook to interact with a mail server
-[AIRFLOW-2794] Add delete support for Azure blob
-[AIRFLOW-2912] Add operators for Google Cloud Functions
-[AIRFLOW-2974] Add Start/Restart/Terminate methods Databricks Hook
-[AIRFLOW-2989] No Parameter to change bootDiskType for DataprocClusterCreateOperator
-[AIRFLOW-3078] Basic operators for Google Compute Engine
-[AIRFLOW-3147] Update Flask-AppBuilder version
-[AIRFLOW-3231] Basic operators for Google Cloud SQL (deploy / patch / delete)
-[AIRFLOW-3276] Google Cloud SQL database create / patch / delete operators
+- [AIRFLOW-2524] Airflow integration with AWS Sagemaker
+- [AIRFLOW-2657] Add ability to delete DAG from web ui
+- [AIRFLOW-2780] Adds IMAP Hook to interact with a mail server
+- [AIRFLOW-2794] Add delete support for Azure blob
+- [AIRFLOW-2912] Add operators for Google Cloud Functions
+- [AIRFLOW-2974] Add Start/Restart/Terminate methods Databricks Hook
+- [AIRFLOW-2989] No Parameter to change bootDiskType for DataprocClusterCreateOperator
+- [AIRFLOW-3078] Basic operators for Google Compute Engine
+- [AIRFLOW-3147] Update Flask-AppBuilder version
+- [AIRFLOW-3231] Basic operators for Google Cloud SQL (deploy / patch / delete)
+- [AIRFLOW-3276] Google Cloud SQL database create / patch / delete operators
 
-Improvements:
+Improvements
+""""""""""""
 
-[AIRFLOW-393] Add progress callbacks for FTP downloads
-[AIRFLOW-520] Show Airflow version on web page
-[AIRFLOW-843] Exceptions now available in context during on_failure_callback
-[AIRFLOW-2476] Update tabulate dependency to v0.8.2
-[AIRFLOW-2592] Bump Bleach dependency
-[AIRFLOW-2622] Add "confirm=False" option to SFTPOperator
-[AIRFLOW-2662] support affinity & nodeSelector policies for kubernetes executor/operator
-[AIRFLOW-2709] Improve error handling in Databricks hook
-[AIRFLOW-2723] Update lxml dependancy to >= 4.0.
-[AIRFLOW-2763] No precheck mechanism in place during worker initialisation for the connection to metadata database
-[AIRFLOW-2789] Add ability to create single node cluster to DataprocClusterCreateOperator
-[AIRFLOW-2797] Add ability to create Google Dataproc cluster with custom image
-[AIRFLOW-2854] kubernetes_pod_operator add more configuration items
-[AIRFLOW-2855] Need to Check Validity of Cron Expression When Process DAG File/Zip File
-[AIRFLOW-2904] Clean an unnecessary line in airflow/executors/celery_executor.py
-[AIRFLOW-2921] A trivial incorrectness in CeleryExecutor()
-[AIRFLOW-2922] Potential deal-lock bug in CeleryExecutor()
-[AIRFLOW-2932] GoogleCloudStorageHook - allow compression of file
-[AIRFLOW-2949] Syntax Highlight for Single Quote
-[AIRFLOW-2951] dag_run end_date Null after a dag is finished
-[AIRFLOW-2956] Kubernetes tolerations for pod operator
-[AIRFLOW-2997] Support for clustered tables in Bigquery hooks/operators
-[AIRFLOW-3006] Fix error when schedule_interval="None"
-[AIRFLOW-3008] Move Kubernetes related example DAGs to contrib/example_dags
-[AIRFLOW-3025] Allow to specify dns and dns-search parameters for DockerOperator
-[AIRFLOW-3067] (www_rbac) Flask flash messages are not displayed properly (no background color)
-[AIRFLOW-3069] Decode output of S3 file transform operator
-[AIRFLOW-3072] Assign permission get_logs_with_metadata to viewer role
-[AIRFLOW-3090] INFO logs are too verbose
-[AIRFLOW-3103] Update Flask-Login
-[AIRFLOW-3112] Align SFTP hook with SSH hook
-[AIRFLOW-3119] Enable loglevel on celery worker and inherit from airflow.cfg
-[AIRFLOW-3137] Make ProxyFix middleware optional
-[AIRFLOW-3173] Add _cmd options for more password config options
-[AIRFLOW-3177] Change scheduler_heartbeat metric from gauge to counter
-[AIRFLOW-3193] Pin docker requirement version to v3
-[AIRFLOW-3195] Druid Hook: Log ingestion spec and task id
-[AIRFLOW-3197] EMR Hook is missing some parameters to valid on the AWS API
-[AIRFLOW-3232] Make documentation for GCF Functions operator more readable
-[AIRFLOW-3262] Can't get log containing Response when using SimpleHttpOperator
-[AIRFLOW-3265] Add support for "unix_socket" in connection extra for Mysql Hook
+- [AIRFLOW-393] Add progress callbacks for FTP downloads
+- [AIRFLOW-520] Show Airflow version on web page
+- [AIRFLOW-843] Exceptions now available in context during on_failure_callback
+- [AIRFLOW-2476] Update tabulate dependency to v0.8.2
+- [AIRFLOW-2592] Bump Bleach dependency
+- [AIRFLOW-2622] Add "confirm=False" option to SFTPOperator
+- [AIRFLOW-2662] support affinity & nodeSelector policies for kubernetes executor/operator
+- [AIRFLOW-2709] Improve error handling in Databricks hook
+- [AIRFLOW-2723] Update lxml dependancy to >= 4.0.
+- [AIRFLOW-2763] No precheck mechanism in place during worker initialisation for the connection to metadata database
+- [AIRFLOW-2789] Add ability to create single node cluster to DataprocClusterCreateOperator
+- [AIRFLOW-2797] Add ability to create Google Dataproc cluster with custom image
+- [AIRFLOW-2854] kubernetes_pod_operator add more configuration items
+- [AIRFLOW-2855] Need to Check Validity of Cron Expression When Process DAG File/Zip File
+- [AIRFLOW-2904] Clean an unnecessary line in airflow/executors/celery_executor.py
+- [AIRFLOW-2921] A trivial incorrectness in CeleryExecutor()
+- [AIRFLOW-2922] Potential deal-lock bug in CeleryExecutor()
+- [AIRFLOW-2932] GoogleCloudStorageHook - allow compression of file
+- [AIRFLOW-2949] Syntax Highlight for Single Quote
+- [AIRFLOW-2951] dag_run end_date Null after a dag is finished
+- [AIRFLOW-2956] Kubernetes tolerations for pod operator
+- [AIRFLOW-2997] Support for clustered tables in Bigquery hooks/operators
+- [AIRFLOW-3006] Fix error when schedule_interval="None"
+- [AIRFLOW-3008] Move Kubernetes related example DAGs to contrib/example_dags
+- [AIRFLOW-3025] Allow to specify dns and dns-search parameters for DockerOperator
+- [AIRFLOW-3067] (www_rbac) Flask flash messages are not displayed properly (no background color)
+- [AIRFLOW-3069] Decode output of S3 file transform operator
+- [AIRFLOW-3072] Assign permission get_logs_with_metadata to viewer role
+- [AIRFLOW-3090] INFO logs are too verbose
+- [AIRFLOW-3103] Update Flask-Login
+- [AIRFLOW-3112] Align SFTP hook with SSH hook
+- [AIRFLOW-3119] Enable loglevel on celery worker and inherit from airflow.cfg
+- [AIRFLOW-3137] Make ProxyFix middleware optional
+- [AIRFLOW-3173] Add _cmd options for more password config options
+- [AIRFLOW-3177] Change scheduler_heartbeat metric from gauge to counter
+- [AIRFLOW-3193] Pin docker requirement version to v3
+- [AIRFLOW-3195] Druid Hook: Log ingestion spec and task id
+- [AIRFLOW-3197] EMR Hook is missing some parameters to valid on the AWS API
+- [AIRFLOW-3232] Make documentation for GCF Functions operator more readable
+- [AIRFLOW-3262] Can't get log containing Response when using SimpleHttpOperator
+- [AIRFLOW-3265] Add support for "unix_socket" in connection extra for Mysql Hook
 
-Doc-only changes:
+Doc-only changes
+""""""""""""""""
 
-[AIRFLOW-1441] Tutorial Inconsistencies Between Example Pipeline Definition and Recap
-[AIRFLOW-2682] Add how-to guide(s) for how to use basic operators like BashOperator and PythonOperator
-[AIRFLOW-3104] .airflowignore feature is not mentioned at all in documentation
-[AIRFLOW-3237] Refactor example DAGs
-[AIRFLOW-3187] Update airflow.gif file with a slower version
-[AIRFLOW-3159] Update Airflow documentation on GCP Logging
-[AIRFLOW-3030] Command Line docs incorrect subdir
-[AIRFLOW-2990] Docstrings for Hooks/Operators are in incorrect format
-[AIRFLOW-3127] Celery SSL Documentation is out-dated
-[AIRFLOW-2779] Add license headers to doc files
-[AIRFLOW-2779] Add project version to license
+- [AIRFLOW-1441] Tutorial Inconsistencies Between Example Pipeline Definition and Recap
+- [AIRFLOW-2682] Add how-to guide(s) for how to use basic operators like BashOperator and PythonOperator
+- [AIRFLOW-3104] .airflowignore feature is not mentioned at all in documentation
+- [AIRFLOW-3237] Refactor example DAGs
+- [AIRFLOW-3187] Update airflow.gif file with a slower version
+- [AIRFLOW-3159] Update Airflow documentation on GCP Logging
+- [AIRFLOW-3030] Command Line docs incorrect subdir
+- [AIRFLOW-2990] Docstrings for Hooks/Operators are in incorrect format
+- [AIRFLOW-3127] Celery SSL Documentation is out-dated
+- [AIRFLOW-2779] Add license headers to doc files
+- [AIRFLOW-2779] Add project version to license
 
-Bug fixes:
+Bug fixes
+"""""""""
 
-[AIRFLOW-839] docker_operator.py attempts to log status key without first checking existence
-[AIRFLOW-1104] Concurrency check in scheduler should count queued tasks as well as running
-[AIRFLOW-1163] Add support for x-forwarded-* headers to support access behind AWS ELB
-[AIRFLOW-1195] Cleared tasks in SubDagOperator do not trigger Parent dag_runs
-[AIRFLOW-1508] Skipped state not part of State.task_states
-[AIRFLOW-1762] Use key_file in SSHHook.create_tunnel()
-[AIRFLOW-1837] Differing start_dates on tasks not respected by scheduler.
-[AIRFLOW-1874] Support standard SQL in Check, ValueCheck and IntervalCheck BigQuery operators
-[AIRFLOW-1917] print() from python operators end up with extra new line
-[AIRFLOW-1970] Database cannot be initialized if an invalid fernet key is provided
-[AIRFLOW-2145] Deadlock after clearing a running task
-[AIRFLOW-2216] Cannot specify a profile for AWS Hook to load with s3 config file
-[AIRFLOW-2574] initdb fails when mysql password contains percent sign
-[AIRFLOW-2707] Error accessing log files from web UI
-[AIRFLOW-2716] Replace new Python 3.7 keywords
-[AIRFLOW-2744] RBAC app doesn't integrate plugins (blueprints etc)
-[AIRFLOW-2772] BigQuery hook does not allow specifying both the partition field name and table name at the same time
-[AIRFLOW-2778] Bad Import in collect_dag in DagBag
-[AIRFLOW-2786] Variables view fails to render if a variable has an empty key
-[AIRFLOW-2799] Filtering UI objects by datetime is broken
-[AIRFLOW-2800] Remove airflow/ low-hanging linting errors
-[AIRFLOW-2825] S3ToHiveTransfer operator may not may able to handle GZIP file with uppercase ext in S3
-[AIRFLOW-2848] dag_id is missing in metadata table "job" for LocalTaskJob
-[AIRFLOW-2860] DruidHook: time variable is not updated correctly when checking for timeout
-[AIRFLOW-2865] Race condition between on_success_callback and LocalTaskJob's cleanup
-[AIRFLOW-2893] Stuck dataflow job due to jobName mismatch.
-[AIRFLOW-2895] Prevent scheduler from spamming heartbeats/logs
-[AIRFLOW-2900] Code not visible for Packaged DAGs
-[AIRFLOW-2905] Switch to regional dataflow job service.
-[AIRFLOW-2907] Sendgrid - Attachments - ERROR - Object of type 'bytes' is not JSON serializable
-[AIRFLOW-2938] Invalid 'extra' field in connection can raise an AttributeError when attempting to edit
-[AIRFLOW-2979] Deprecated Celery Option not in Options list
-[AIRFLOW-2981] TypeError in dataflow operators when using GCS jar or py_file
-[AIRFLOW-2984] Cannot convert naive_datetime when task has a naive start_date/end_date
-[AIRFLOW-2994] flatten_results in BigQueryOperator/BigQueryHook should default to None
-[AIRFLOW-3002] ValueError in dataflow operators when using GCS jar or py_file
-[AIRFLOW-3012] Email on sla miss is send only to first address on the list
-[AIRFLOW-3046] ECS Operator mistakenly reports success when task is killed due to EC2 host termination
-[AIRFLOW-3064] No output from `airflow test` due to default logging config
-[AIRFLOW-3072] Only admin can view logs in RBAC UI
-[AIRFLOW-3079] Improve initdb to support MSSQL Server
-[AIRFLOW-3089] Google auth doesn't work under http
-[AIRFLOW-3099] Errors raised when some blocs are missing in airflow.cfg
-[AIRFLOW-3109] Default user permission should contain 'can_clear'
-[AIRFLOW-3111] Confusing comments and instructions for log templates in UPDATING.md and default_airflow.cfg
-[AIRFLOW-3124] Broken webserver debug mode (RBAC)
-[AIRFLOW-3136] Scheduler Failing the Task retries run while processing Executor Events
-[AIRFLOW-3138] Migration cc1e65623dc7 creates issues with postgres
-[AIRFLOW-3161] Log Url link does not link to task instance logs in RBAC UI
-[AIRFLOW-3162] HttpHook fails to parse URL when port is specified
-[AIRFLOW-3183] Potential Bug in utils/dag_processing/DagFileProcessorManager.max_runs_reached()
-[AIRFLOW-3203] Bugs in DockerOperator & Some operator test scripts were named incorrectly
-[AIRFLOW-3238] Dags, removed from the filesystem, are not deactivated on initdb
-[AIRFLOW-3268] Cannot pass SSL dictionary to mysql connection via URL
-[AIRFLOW-3277] Invalid timezone transition handling for cron schedules
-[AIRFLOW-3295] Require encryption in DaskExecutor when certificates are configured.
-[AIRFLOW-3297] EmrStepSensor marks cancelled step as successful
+- [AIRFLOW-839] docker_operator.py attempts to log status key without first checking existence
+- [AIRFLOW-1104] Concurrency check in scheduler should count queued tasks as well as running
+- [AIRFLOW-1163] Add support for x-forwarded-* headers to support access behind AWS ELB
+- [AIRFLOW-1195] Cleared tasks in SubDagOperator do not trigger Parent dag_runs
+- [AIRFLOW-1508] Skipped state not part of State.task_states
+- [AIRFLOW-1762] Use key_file in SSHHook.create_tunnel()
+- [AIRFLOW-1837] Differing start_dates on tasks not respected by scheduler.
+- [AIRFLOW-1874] Support standard SQL in Check, ValueCheck and IntervalCheck BigQuery operators
+- [AIRFLOW-1917] print() from python operators end up with extra new line
+- [AIRFLOW-1970] Database cannot be initialized if an invalid fernet key is provided
+- [AIRFLOW-2145] Deadlock after clearing a running task
+- [AIRFLOW-2216] Cannot specify a profile for AWS Hook to load with s3 config file
+- [AIRFLOW-2574] initdb fails when mysql password contains percent sign
+- [AIRFLOW-2707] Error accessing log files from web UI
+- [AIRFLOW-2716] Replace new Python 3.7 keywords
+- [AIRFLOW-2744] RBAC app doesn't integrate plugins (blueprints etc)
+- [AIRFLOW-2772] BigQuery hook does not allow specifying both the partition field name and table name at the same time
+- [AIRFLOW-2778] Bad Import in collect_dag in DagBag
+- [AIRFLOW-2786] Variables view fails to render if a variable has an empty key
+- [AIRFLOW-2799] Filtering UI objects by datetime is broken
+- [AIRFLOW-2800] Remove airflow/ low-hanging linting errors
+- [AIRFLOW-2825] S3ToHiveTransfer operator may not may able to handle GZIP file with uppercase ext in S3
+- [AIRFLOW-2848] dag_id is missing in metadata table "job" for LocalTaskJob
+- [AIRFLOW-2860] DruidHook: time variable is not updated correctly when checking for timeout
+- [AIRFLOW-2865] Race condition between on_success_callback and LocalTaskJob's cleanup
+- [AIRFLOW-2893] Stuck dataflow job due to jobName mismatch.
+- [AIRFLOW-2895] Prevent scheduler from spamming heartbeats/logs
+- [AIRFLOW-2900] Code not visible for Packaged DAGs
+- [AIRFLOW-2905] Switch to regional dataflow job service.
+- [AIRFLOW-2907] Sendgrid - Attachments - ERROR - Object of type 'bytes' is not JSON serializable
+- [AIRFLOW-2938] Invalid 'extra' field in connection can raise an AttributeError when attempting to edit
+- [AIRFLOW-2979] Deprecated Celery Option not in Options list
+- [AIRFLOW-2981] TypeError in dataflow operators when using GCS jar or py_file
+- [AIRFLOW-2984] Cannot convert naive_datetime when task has a naive start_date/end_date
+- [AIRFLOW-2994] flatten_results in BigQueryOperator/BigQueryHook should default to None
+- [AIRFLOW-3002] ValueError in dataflow operators when using GCS jar or py_file
+- [AIRFLOW-3012] Email on sla miss is send only to first address on the list
+- [AIRFLOW-3046] ECS Operator mistakenly reports success when task is killed due to EC2 host termination
+- [AIRFLOW-3064] No output from `airflow test` due to default logging config
+- [AIRFLOW-3072] Only admin can view logs in RBAC UI
+- [AIRFLOW-3079] Improve initdb to support MSSQL Server
+- [AIRFLOW-3089] Google auth doesn't work under http
+- [AIRFLOW-3099] Errors raised when some blocs are missing in airflow.cfg
+- [AIRFLOW-3109] Default user permission should contain 'can_clear'
+- [AIRFLOW-3111] Confusing comments and instructions for log templates in UPDATING.md and default_airflow.cfg
+- [AIRFLOW-3124] Broken webserver debug mode (RBAC)
+- [AIRFLOW-3136] Scheduler Failing the Task retries run while processing Executor Events
+- [AIRFLOW-3138] Migration cc1e65623dc7 creates issues with postgres
+- [AIRFLOW-3161] Log Url link does not link to task instance logs in RBAC UI
+- [AIRFLOW-3162] HttpHook fails to parse URL when port is specified
+- [AIRFLOW-3183] Potential Bug in utils/dag_processing/DagFileProcessorManager.max_runs_reached()
+- [AIRFLOW-3203] Bugs in DockerOperator & Some operator test scripts were named incorrectly
+- [AIRFLOW-3238] Dags, removed from the filesystem, are not deactivated on initdb
+- [AIRFLOW-3268] Cannot pass SSL dictionary to mysql connection via URL
+- [AIRFLOW-3277] Invalid timezone transition handling for cron schedules
+- [AIRFLOW-3295] Require encryption in DaskExecutor when certificates are configured.
+- [AIRFLOW-3297] EmrStepSensor marks cancelled step as successful
 
-AIRFLOW 1.10.0, 2018-08-03
+Airflow 1.10.0, 2018-08-03
 --------------------------
-[AIRFLOW-2870] Use abstract TaskInstance for migration
-[AIRFLOW-2859] Implement own UtcDateTime (#3708)
-[AIRFLOW-2140] Don't require kubernetes for the SparkSubmit hook
-[AIRFLOW-2869] Remove smart quote from default config
-[AIRFLOW-2857] Fix Read the Docs env
-[AIRFLOW-2817] Force explicit choice on GPL dependency
-[AIRFLOW-2716] Replace async and await py3.7 keywords
-[AIRFLOW-2810] Fix typo in Xcom model timestamp
-[AIRFLOW-2710] Clarify fernet key value in documentation
-[AIRFLOW-2606] Fix DB schema and SQLAlchemy model
-[AIRFLOW-2646] Fix setup.py not to install snakebite on Python3
-[AIRFLOW-2604] Add index to task_fail
-[AIRFLOW-2650] Mark SchedulerJob as succeed when hitting Ctrl-c
-[AIRFLOW-2678] Fix db schema unit test to remove checking fab models
-[AIRFLOW-2624] Fix webserver login as anonymous
-[AIRFLOW-2654] Fix incorret URL on refresh in Graph View of FAB UI
-[AIRFLOW-2668] Handle missing optional cryptography dependency
-[AIRFLOW-2681] Include last dag run of externally triggered DAGs in UI.
-[AIRFLOW-1840] Support back-compat on old celery config
-[AIRFLOW-2612][AIRFLOW-2534] Clean up Hive-related tests
-[AIRFLOW-2608] Implements/Standardize custom exceptions for experimental APIs
-[AIRFLOW-2607] Fix failing TestLocalClient
-[AIRFLOW-2638] dbapi_hook: support REPLACE INTO
-[AIRFLOW-2542][AIRFLOW-1790] Rename AWS Batch Operator queue to job_queue
-[AIRFLOW-2567] Extract result from the kubernetes pod as Xcom
-[AIRFLOW-XXX] Adding REA Group to readme
-[AIRFLOW-2601] Allow user to specify k8s config
-[AIRFLOW-2559] Azure Fileshare hook
-[AIRFLOW-1786] Enforce correct behavior for soft-fail sensors
-[AIRFLOW-2355] Airflow trigger tag parameters in subdag
-[AIRFLOW-2613] Fix Airflow searching .zip bug
-[AIRFLOW-2627] Add a sensor for Cassandra
-[AIRFLOW-2634][AIRFLOW-2534] Remove dependency for impyla
-[AIRFLOW-2611] Fix wrong dag volume mount path for kubernetes executor
-[AIRFLOW-2562] Add Google Kubernetes Engine Operators
-[AIRFLOW-2630] Fix classname in test_sql_sensor.py
-[AIRFLOW-2534] Fix bug in HiveServer2Hook
-[AIRFLOW-2586] Stop getting AIRFLOW_HOME value from config file in bash operator
-[AIRFLOW-2605] Fix autocommit for MySqlHook
-[AIRFLOW-2539][AIRFLOW-2359] Move remaing log config to configuration file
-[AIRFLOW-1656] Tree view dags query changed
-[AIRFLOW-2617] add imagePullPolicy config for kubernetes executor
-[AIRFLOW-2429] Fix security/task/sensors/ti_deps folders flake8 error
-[AIRFLOW-2550] Implements API endpoint to list DAG runs
-[AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead of oauth2client
-[AIRFLOW-2429] Fix operators folder flake8 error
-[AIRFLOW-2585] Fix several bugs in CassandraHook and CassandraToGCSOperator
-[AIRFLOW-2597] Restore original dbapi.run() behavior
-[AIRFLOW-2590] Fix commit in DbApiHook.run() for no-autocommit DB
-[AIRFLOW-1115] fix github oauth api URL
-[AIRFLOW-2587] Add TIMESTAMP type mapping to MySqlToHiveTransfer
-[AIRFLOW-2591][AIRFLOW-2581] Set default value of autocommit to False in DbApiHook.run()
-[AIRFLOW-59] Implement bulk_dump and bulk_load for the Postgres hook
-[AIRFLOW-2533] Fix path to DAG's on kubernetes executor workers
-[AIRFLOW-2581] RFLOW-2581] Fix DbApiHook autocommit
-[AIRFLOW-2578] Add option to use proxies in JiraHook
-[AIRFLOW-2575] Make gcs to gcs operator work with large files
-[AIRFLOW-437] Send TI context in kill zombies
-[AIRFLOW-2566] Change backfill to rerun failed tasks
-[AIRFLOW-1021] Fix double login for new users with LDAP
-[AIRFLOW-XXX] Typo fix
-[AIRFLOW-2561] Fix typo in EmailOperator
-[AIRFLOW-2573] Cast BigQuery TIMESTAMP field to float
-[AIRFLOW-2560] Adding support for internalIpOnly to DataprocClusterCreateOperator
-[AIRFLOW-2565] templatize cluster_label
-[AIRFLOW-83] add mongo hook and operator
-[AIRFLOW-2558] Clear task/dag is clearing all executions
-[AIRFLOW-XXX] Fix doc typos
-[AIRFLOW-2513] Change `bql` to `sql` for BigQuery Hooks & Ops
-[AIRFLOW-2557] Fix pagination for s3
-[AIRFLOW-2545] Eliminate DeprecationWarning
-[AIRFLOW-2500] Fix MySqlToHiveTransfer to transfer unsigned type properly
-[AIRFLOW-2462] Change PasswordUser setter to correct syntax
-[AIRFLOW-2525] Fix a bug introduced by commit dabf1b9
-[AIRFLOW-2553] Add webserver.pid to .gitignore
-[AIRFLOW-1863][AIRFLOW-2529] Add dag run selection widgets to gantt view
-[AIRFLOW-2504] Log username correctly and add extra to search columns
-[AIRFLOW-2551] Encode binary data with base64 standard rather than base64 url
-[AIRFLOW-2537] Add reset-dagrun option to backfill command
-[AIRFLOW-2526] dag_run.conf can override params
-[AIRFLOW-2544][AIRFLOW-1967] Guard against next major release of Celery, Flower
-[AIRFLOW-XXX] Add Yieldr to who is using airflow
-[AIRFLOW-2547] Describe how to run tests using Docker
-[AIRFLOW-2538] Update faq doc on how to reduce airflow scheduler latency
-[AIRFLOW-2529] Improve graph view performance and usability
-[AIRFLOW-2517] backfill support passing key values through CLI
-[AIRFLOW-2532] Support logs_volume_subpath for KubernetesExecutor
-[AIRFLOW-2466] consider task_id in _change_state_for_tis_without_dagrun
-[AIRFLOW-2519] Fix CeleryExecutor with SQLAlchemy
-[AIRFLOW-2402] Fix RBAC task log
-[AIRFLOW-XXX] Add M4U to user list
-[AIRFLOW-2536] docs about how to deal with airflow initdb failure
-[AIRFLOW-2530] KubernetesOperator supports multiple clusters
-[AIRFLOW-1499] Eliminate duplicate and unneeded code
-[AIRFLOW-2521] backfill - make variable name and logging messages more acurate
-[AIRFLOW-2429] Fix hook, macros folder flake8 error
-[Airflow-XXX] add Prime to company list
-[AIRFLOW-2525] Fix PostgresHook.copy_expert to work with "COPY FROM"
-[AIRFLOW-2515] Add dependency on thrift_sasl to hive extra
-[AIRFLOW-2523] Add how-to for managing GCP connections
-[AIRFLOW-2510] Introduce new macros: prev_ds and next_ds
-[AIRFLOW-1730] Unpickle value of XCom queried from DB
-[AIRFLOW-2518] Fix broken ToC links in integration.rst
-[AIRFLOW-1472] Fix SLA misses triggering on skipped tasks.
-[AIRFLOW-2520] CLI - make backfill less verbose
-[AIRFLOW-2107] add time_partitioning to run_query on BigQueryBaseCursor
-[AIRFLOW-1057][AIRFLOW-1380][AIRFLOW-2362][2362] AIRFLOW Update DockerOperator to new API
-[AIRFLOW-2415] Make airflow DAG templating render numbers
-[AIRFLOW-2473] Fix wrong skip condition for TransferTests
-[AIRFLOW-2472] Implement MySqlHook.bulk_dump
-[AIRFLOW-2419] Use default view for subdag operator
-[AIRFLOW-2498] Fix Unexpected argument in SFTP Sensor
-[AIRFLOW-2509] Separate config docs into how-to guides
-[AIRFLOW-2429] Add BaseExecutor back
-[AIRFLOW-2429] Fix dag, example_dags, executors flake8 error
-[AIRFLOW-2502] Change Single triple quotes to double for docstrings
-[AIRFLOW-2503] Fix broken links in CONTRIBUTING.md
-[AIRFLOW-2501] Refer to devel instructions in docs contrib guide
-[AIRFLOW-2429] Fix contrib folder's flake8 errors
-[AIRFLOW-2471] Fix HiveCliHook.load_df to use unused parameters
-[AIRFLOW-2495] Update celery to 4.1.1
-[AIRFLOW-2429] Fix api, bin, config_templates folders flake8 error
-[AIRFLOW-2493] Mark template_fields of all Operators in the API document as "templated"
-[AIRFLOW-2489] Update FlaskAppBuilder to 1.11.1
-[AIRFLOW-2448] Enhance HiveCliHook.load_df to work with datetime
-[AIRFLOW-2487] Enhance druid ingestion hook
-[AIRFLOW-2397] Support affinity policies for Kubernetes executor/operator
-[AIRFLOW-2482] Add test for rewrite method in GCS Hook
-[AIRFLOW-2481] Fix flaky Kubernetes test
-[AIRFLOW-2479] Improve doc FAQ section
-[AIRFLOW-2485] Fix Incorrect logging for Qubole Sensor
-[AIRFLOW-2486] Remove unnecessary slash after port
-[AIRFLOW-2429] Make Airflow flake8 compliant
-[AIRFLOW-2491] Resolve flask version conflict
-[AIRFLOW-2484] Remove duplicate key in MySQL to GCS Op
-[ARIFLOW-2458] Add cassandra-to-gcs operator
-[AIRFLOW-2477] Improve time units for task duration and landing times charts for RBAC UI
-[AIRFLOW-2474] Only import snakebite if using py2
-[AIRFLOW-48] Parse connection uri querystring
-[AIRFLOW-2467][AIRFLOW-2] Update import direct warn message to use the module name
-[AIRFLOW-XXX] Fix order of companies
-[AIRFLOW-2452] Document field_dict must be OrderedDict
-[AIRFLOW-2420] Azure Data Lake Hook
-[AIRFLOW-2213] Add Quoble check operator
-[AIRFLOW-2465] Fix wrong module names in the doc
-[AIRFLOW-1929] Modifying TriggerDagRunOperator to accept execution_date
-[AIRFLOW-2460] Users can now use volume mounts and volumes
-[AIRFLOW-2110][AIRFLOW-2122] Enhance Http Hook
-[AIRFLOW-XXX] Updated contributors list
-[AIRFLOW-2435] Add launch_type to ECSOperator to allow FARGATE
-[AIRFLOW-2451] Remove extra slash ('/') char when using wildcard in gcs_to_gcs operator
-[AIRFLOW-2461] Add support for cluster scaling on dataproc operator
-[AIRFLOW-2376] Fix no hive section error
-[AIRFLOW-2425] Add lineage support
-[AIRFLOW-2430] Extend query batching to additional slow queries
-[AIRFLOW-2453] Add default nil value for kubernetes/git_subpath
-[AIRFLOW-2396] Add support for resources in kubernetes operator
-[AIRFLOW-2169] Encode binary data with base64 before importing to BigQuery
-[AIRFLOW-XXX] Add spotahome in user list
-[AIRFLOW-2457] Update FAB version requirement
-[AIRFLOW-2454][Airflow 2454] Support imagePullPolicy for k8s
-[AIRFLOW-2450] update supported k8s versions to 1.9 and 1.10
-[AIRFLOW-2333] Add Segment Hook and TrackEventOperator
-[AIRFLOW-2442][AIRFLOW-2] Airflow run command leaves database connections open
-[AIRFLOW-2016] assign template_fields for Dataproc Workflow Template sub-classes, not base class
-[AIRFLOW-2446] Add S3ToRedshiftTransfer into the "Integration" doc
-[AIRFLOW-2449] Fix operators.py to run all test cases
-[AIRFLOW-2424] Add dagrun status endpoint and increased k8s test coverage
-[AIRFLOW-2441] Fix bugs in HiveCliHook.load_df
-[AIRFLOW-2358][AIRFLOW-201804] Make the Kubernetes example optional
-[AIRFLOW-2436] Remove cli_logger in initdb
-[AIRFLOW-2444] Remove unused option(include_adhoc) in cli backfill command
-[AIRFLOW-2447] Fix TestHiveMetastoreHook to run all cases
-[AIRFLOW-2445] Allow templating in kubernetes operator
-[AIRFLOW-2086][AIRFLOW-2393] Customize default dagrun number in tree view
-[AIRFLOW-2437] Add PubNub to list of current airflow users
-[AIRFLOW-XXX] Add Quantopian to list of Airflow users
-[AIRFLOW-1978] Add WinRM windows operator and hook
-[AIRFLOW-2427] Add tests to named hive sensor
-[AIRFLOW-2412] Fix HiveCliHook.load_file to address HIVE-10541
-[AIRFLOW-2431] Add the navigation bar color parameter for RBAC UI
-[AIRFLOW-2407] Resolve Python undefined names
-[AIRFLOW-1952] Add the navigation bar color parameter
-[AIRFLOW-2222] Implement GoogleCloudStorageHook.rewrite
-[AIRFLOW-2426] Add Google Cloud Storage Hook tests
-[AIRFLOW-2418] Bump Flask-WTF
-[AIRFLOW-2417] Wait for pod is not running to end task
-[AIRFLOW-1914] Add other charset support to email utils
-[AIRFLOW-XXX] Update README.md with Craig@Work
-[AIRFLOW-1899] Fix Kubernetes tests
-[AIRFLOW-1812] Update logging example
-[AIRFLOW-2313] Add TTL parameters for Dataproc
-[AIRFLOW-2411] add dataproc_jars to templated_fields
-[AIRFLOW-XXX] Add Reddit to Airflow users
-[AIRFLOW-XXX] Fix wrong table header in scheduler.rst
-[AIRFLOW-2409] Supply password as a parameter
-[AIRFLOW-2410][AIRFLOW-75] Set the timezone in the RBAC Web UI
-[AIRFLOW-2394] default cmds and arguments in kubernetes operator
-[AIRFLOW-2406] Add Apache2 License Shield to Readme
-[AIRFLOW-2404] Add additional documentation for unqueued task
-[AIRFLOW-2400] Add Ability to set Environment Variables for K8s
-[AIRFLOW-XXX] Add Twine Labs as an Airflow user
-[AIRFLOW-1853] Show only the desired number of runs in tree view
-[AIRFLOW-2401] Document the use of variables in Jinja template
-[AIRFLOW-2403] Fix License Headers
-[AIRFLOW-1313] Fix license header
-[AIRFLOW-2398] Add BounceX to list of current airflow users
-[AIRFLOW-2363] Fix return type bug in TaskHandler
-[AIRFLOW-2389] Create a pinot db api hook
-[AIRFLOW-2390] Resolve FlaskWTFDeprecationWarning
-[AIRFLOW-1933] Fix some typos
-[AIRFLOW-1960] Add support for secrets in kubernetes operator
-[AIRFLOW-1313] Add vertica_to_mysql operator
-[AIRFLOW-1575] Add AWS Kinesis Firehose Hook for inserting batch records
-[AIRFLOW-2266][AIRFLOW-2343] Remove google-cloud-dataflow dependency
-[AIRFLOW-2370] Implement --use_random_password in create_user
-[AIRFLOW-2348] Strip path prefix from the destination_object when source_object contains a wildcard[]
-[AIRFLOW-2391] Fix to Flask 0.12.2
-[AIRFLOW-2381] Fix the flaky ApiPasswordTests test
-[AIRFLOW-2378] Add Groupon to list of current users
-[AIRFLOW-2382] Fix wrong description for delimiter
-[AIRFLOW-2380] Add support for environment variables in Spark submit operator.
-[AIRFLOW-2377] Improve Sendgrid sender support
-[AIRFLOW-2331] Support init action timeout on dataproc cluster create
-[AIRFLOW-1835] Update docs: Variable file is json
-[AIRFLOW-1781] Make search case-insensitive in LDAP group
-[AIRFLOW-2042] Fix browser menu appearing over the autocomplete menu
-[AIRFLOW-XXX] Remove wheelhouse files from travis not owned by travis
-[AIRFLOW-2336] Use hmsclient in hive_hook
-[AIRFLOW-2041] Correct Syntax in python examples
-[AIRFLOW-74] SubdagOperators can consume all celeryd worker processes
-[AIRFLOW-2369] Fix gcs tests
-[AIRFLOW-2365] Fix autocommit attribute check
-[AIRFLOW-2068] MesosExecutor allows optional Docker image
-[AIRFLOW-1652] Push DatabricksRunSubmitOperator metadata into XCOM
-[AIRFLOW-2234] Enable insert_rows for PrestoHook
-[AIRFLOW-2208][Airflow-22208] Link to same DagRun graph from TaskInstance view
-[AIRFLOW-1153] Allow HiveOperators to take hiveconfs
-[AIRFLOW-775] Fix autocommit settings with Jdbc hook
-[AIRFLOW-2364] Warn when setting autocommit on a connection which does not support it
-[AIRFLOW-2357] Add persistent volume for the logs
-[AIRFLOW-766] Skip conn.commit() when in Auto-commit
-[AIRFLOW-2351] Check for valid default_args start_date
-[AIRFLOW-1433] Set default rbac to initdb
-[AIRFLOW-2270] Handle removed tasks in backfill
-[AIRFLOW-2344] Fix `connections -l` to work with pipe/redirect
-[AIRFLOW-2300] Add S3 Select functionarity to S3ToHiveTransfer
-[AIRFLOW-1314] Cleanup the config
-[AIRFLOW-1314] Polish some of the Kubernetes docs/config
-[AIRFLOW-1314] Improve error handling
-[AIRFLOW-1999] Add per-task GCP service account support
-[AIRFLOW-1314] Rebasing against master
-[AIRFLOW-1314] Small cleanup to address PR comments (#24)
-[AIRFLOW-1314] Add executor_config and tests
-[AIRFLOW-1314] Improve k8s support
-[AIRFLOW-1314] Use VolumeClaim for transporting DAGs
-[AIRFLOW-1314] Create integration testing environment
-[AIRFLOW-1314] Git Mode to pull in DAGs for Kubernetes Executor
-[AIRFLOW-1314] Add support for volume mounts & Secrets in Kubernetes Executor
-[AIRFLOW=1314] Basic Kubernetes Mode
-[AIRFLOW-2326][AIRFLOW-2222] remove contrib.gcs_copy_operator
-[AIRFLOW-2328] Fix empty GCS blob in S3ToGoogleCloudStorageOperator
-[AIRFLOW-2350] Fix grammar in UPDATING.md
-[AIRFLOW-2302] Fix documentation
-[AIRFLOW-2345] pip is not used in this setup.py
-[AIRFLOW-2347] Add Banco de Formaturas to Readme
-[AIRFLOW-2346] Add Investorise as official user of Airflow
-[AIRFLOW-2330] Do not append destination prefix if not given
-[AIRFLOW-2240][DASK] Added TLS/SSL support for the dask-distributed scheduler.
-[AIRFLOW-2309] Fix duration calculation on TaskFail
-[AIRFLOW-2335] fix issue with jdk8 download for ci
-[AIRFLOW-2184] Add druid_checker_operator
-[AIRFLOW-2299] Add S3 Select functionarity to S3FileTransformOperator
-[AIRFLOW-2254] Put header as first row in unload
-[AIRFLOW-610] Respect _cmd option in config before defaults
-[AIRFLOW-2287] Fix incorrect ASF headers
-[AIRFLOW-XXX] Add Zego as an Apache Airflow user
-[AIRFLOW-952] fix save empty extra field in UI
-[AIRFLOW-1325] Add ElasticSearch log handler and reader
-[AIRFLOW-2301] Sync files of an S3 key with a GCS path
-[AIRFLOW-2293] Fix S3FileTransformOperator to work with boto3
-[AIRFLOW-3212][AIRFLOW-2314] Remove only leading slash in GCS path
-[AIRFLOW-1509][AIRFLOW-442] SFTP Sensor
-[AIRFLOW-2291] Add optional params to ML Engine
-[AIRFLOW-1774] Allow consistent templating of arguments in MLEngineBatchPredictionOperator
-[AIRFLOW-2302] Add missing operators and hooks
-[AIRFLOW-2312] Docs Typo Correction: Corresponding
-[AIRFLOW-1623] Trigger on_kill method in operators
-[AIRFLOW-2162] When impersonating another user, pass env variables to sudo
-[AIRFLOW-2304] Update quickstart doc to mention scheduler part
-[AIRFLOW-1633] docker_operator needs a way to set shm_size
-[AIRFLOW-1340] Add S3 to Redshift transfer operator
-[AIRFLOW-2303] Lists the keys inside an S3 bucket
-[AIRFLOW-2209] restore flask_login imports
-[AIRFLOW-2306] Add Bonnier Broadcasting to list of current users
-[AIRFLOW-2305][AIRFLOW-2027] Fix CI failure caused by []
-[AIRFLOW-2281] Add support for Sendgrid categories
-[AIRFLOW-2027] Only trigger sleep in scheduler after all files have parsed
-[AIRFLOW-2256] SparkOperator: Add Client Standalone mode and retry mechanism
-[AIRFLOW-2284] GCS to S3 operator
-[AIRFLOW-2287] Update license notices
-[AIRFLOW-2296] Add Cinimex DataLab to Readme
-[AIRFLOW-2298] Add Kalibrr to who uses airflow
-[AIRFLOW-2292] Fix docstring for S3Hook.get_wildcard_key
-[AIRFLOW-XXX] Update PR template
-[AIRFLOW-XXX] Remove outdated migrations.sql
-[AIRFLOW-2287] Add license header to docs/Makefile
-[AIRFLOW-2286] Add tokopedia to the readme
-[AIRFLOW-2273] Add Discord webhook operator/hook
-[AIRFLOW-2282] Fix grammar in UPDATING.md
-[AIRFLOW-2200] Add snowflake operator with tests
-[AIRFLOW-2178] Add handling on SLA miss errors
-[AIRFLOW-2169] Fix type 'bytes' is not JSON serializable in python3
-[AIRFLOW-2215] Pass environment to subproces.Popen in base_task_runner
-[AIRFLOW-2253] Add Airflow CLI instrumentation
-[AIRFLOW-2274] Fix Dataflow tests
-[AIRFLOW-2269] Add Custom Ink as an Airflow user
-[AIRFLOW-2259] Dataflow Hook Index out of range
-[AIRFLOW-2233] Update updating.md to include the info of hdfs_sensors renaming
-[AIRFLOW-2217] Add Slack webhook operator
-[AIRFLOW-1729] improve dagBag time
-[AIRFLOW-2264] Improve create_user cli help message
-[AIRFLOW-2260] [AIRFLOW-2260] SSHOperator add command template .sh files
-[AIRFLOW-2261] Check config/env for remote base log folder
-[AIRFLOW-2258] Allow import of Parquet-format files into BigQuery
-[AIRFLOW-1430] Include INSTALL instructions to avoid GPL
-[AIRFLOW-1430] Solve GPL dependency
-[AIRFLOW-2251] Add Thinknear as an Airflow user
-[AIRFLOW-2244] bugfix: remove legacy LongText code from models.py
-[AIRFLOW-2247] Fix RedshiftToS3Transfer not to fail with ValueError
-[AIRFLOW-2249] Add side-loading support for Zendesk Hook
-[AIRFLOW-XXX] Add Qplum to Airflow users
-[AIRFLOW-2228] Enhancements in ValueCheckOperator
-[AIRFLOW-1206] Typos
-[AIRFLOW-2060] Update pendulum version to 1.4.4
-[AIRFLOW-2248] Fix wrong param name in RedshiftToS3Transfer doc
-[AIRFLOW-1433][AIRFLOW-85] New Airflow Webserver UI with RBAC support
-[AIRFLOW-1235] Fix webserver's odd behaviour
-[AIRFLOW-1460] Allow restoration of REMOVED TI's
-[airflow-2235] Fix wrong docstrings in two operators
-[AIRFLOW-XXX] Fix chronological order for companies using Airflow
-[AIRFLOW-2124] Upload Python file to a bucket for Dataproc
-[AIRFLOW-2212] Fix ungenerated sensor API reference
-[AIRFLOW-2226] Rename google_cloud_storage_default to google_cloud_default
-[AIRFLOW-2211] Rename hdfs_sensors.py to hdfs_sensor.py for consistency
-[AIRFLOW-2225] Update document to include DruidDbApiHook
-[Airflow-2202] Add filter support in HiveMetastoreHook().max_partition()
-[AIRFLOW-2220] Remove duplicate numeric list entry in security.rst
-[AIRFLOW-XXX] Update tutorial documentation
-[AIRFLOW-2215] Update celery task to preserve environment variables and improve logging on exception
-[AIRFLOW-2185] Use state instead of query param
-[AIRFLOW-2183] Refactor DruidHook to enable sql
-[AIRFLOW-2203] Defer cycle detection
-[AIRFLOW-2203] Remove Useless Commands.
-[AIRFLOW-2203] Cache signature in apply_defaults
-[AIRFLOW-2203] Speed up Operator Resources
-[AIRFLOW-2203] Cache static rules (trigger/weight)
-[AIRFLOW-2203] Store task ids as sets not lists
-[AIRFLOW-2205] Remove unsupported args from JdbcHook doc
-[AIRFLOW-2207] Fix flaky test that uses app.cached_app()
-[AIRFLOW-2206] Remove unsupported args from JdbcOperator doc
-[AIRFLOW-2140] Add Kubernetes scheduler to SparkSubmitOperator
-[AIRFLOW-XXX] Add Xero to list of users
-[AIRFLOW-2204] Fix webserver debug mode
-[AIRFLOW-102] Fix test_complex_template always succeeds
-[AIRFLOW-442] Add SFTPHook
-[AIRFLOW-2169] Add schema to MySqlToGoogleCloudStorageOperator
-[AIRFLOW-2184][AIRFLOW-2138] Google Cloud Storage allow wildcards
-[AIRFLOW-1588] Cast Variable value to string
-[AIRFLOW-2199] Fix invalid reference to logger
-[AIRFLOW-2191] Change scheduler heartbeat logs from info to debug
-[AIRFLOW-2106] SalesForce hook sandbox option
-[AIRFLOW-2197] Silence hostname_callable config error message
-[AIRFLOW-2150] Use lighter call in HiveMetastoreHook().max_partition()
-[AIRFLOW-2186] Change the way logging is carried out in few ops
-[AIRFLOW-2181] Convert password_auth and test_password_endpoints from DOS to UNIX
-[AIRFLOW-2187] Fix Broken Travis CI due to AIRFLOW-2123
-[AIRFLOW-2175] Check that filepath is not None
-[AIRFLOW-2173] Don't check task IDs for concurrency reached check
-[AIRFLOW-2168] Remote logging for Azure Blob Storage
-[AIRFLOW-XXX] Add DocuTAP to list of users
-[AIRFLOW-2176] Change the way logging is carried out in BQ Get Data Operator
-[AIRFLOW-2177] Add mock test for GCS Download op
-[AIRFLOW-2123] Install CI dependencies from setup.py
-[AIRFLOW-2129] Presto hook calls _parse_exception_message but defines _get_pretty_exception_message
-[AIRFLOW-2174] Fix typos and wrongly rendered documents
-[AIRFLOW-2171] Store delegated credentials
-[AIRFLOW-2166] Restore BQ run_query dialect param
-[AIRFLOW-2163] Add HBC Digital to users of airflow
-[AIRFLOW-2065] Fix race-conditions when creating loggers
-[AIRFLOW-2147] Plugin manager: added 'sensors' attribute
-[AIRFLOW-2059] taskinstance query is awful, un-indexed, and does not scale
-[AIRFLOW-2159] Fix a few typos in salesforce_hook
-[AIRFLOW-2132] Add step to initialize database
-[AIRFLOW-2160] Fix bad rowid deserialization
-[AIRFLOW-2161] Add Vevo to list of companies using Airflow
-[AIRFLOW-2149] Add link to apache Beam documentation to create self executing Jar
-[AIRFLOW-2151] Allow getting the session from AwsHook
-[AIRFLOW-2097] tz referenced before assignment
-[AIRFLOW-2152] Add Multiply to list of companies using Airflow
-[AIRFLOW-1551] Add operator to trigger Jenkins job
-[AIRFLOW-2034] Fix mixup between %s and {} when using str.format Convention is to use .format for string formating oustide logging, else use lazy format See comment in related issue https://github.com/apache/airflow/pull/2823/files Identified problematic case using following command line .git/COMMIT_EDITMSG:`grep -r '%s'./* | grep '\.format('`
-[AIRFLOW-2102] Add custom_args to Sendgrid personalizations
-[AIRFLOW-1035][AIRFLOW-1053] import unicode_literals to parse Unicode in HQL
-[AIRFLOW-2127] Keep loggers during DB migrations
-[AIRFLOW-2146] Resolve issues with BQ using DbApiHook methods
-[AIRFLOW-2087] Scheduler Report shows incorrect Total task number
-[AIRFLOW-2139] Remove unncecessary boilerplate to get DataFrame using pandas_gbq
-[AIRFLOW-2125] Using binary package psycopg2-binary
-[AIRFLOW-2142] Include message on mkdir failure
-[AIRFLOW-1615] SSHHook: use port specified by Connection
-[AIRFLOW-2122] Handle boolean values in sshHook
-[AIRFLOW-XXX] Add Tile to the list of users
-[AIRFLOW-2130] Add missing Operators to API Reference docs
-[AIRFLOW-XXX] Add timeout units (seconds)
-[AIRFLOW-2134] Add Alan to the list of companies that use Airflow
-[AIRFLOW-2133] Remove references to GitHub issues in CONTRIBUTING
-[AIRFLOW-2131] Remove confusing AirflowImport docs
-[AIRFLOW-1852] Allow hostname to be overridable.
-[AIRFLOW-2126] Add Bluecore to active users
-[AIRFLOW-1618] Add feature to create GCS bucket
-[AIRFLOW-2108] Fix log indentation in BashOperator
-[AIRFLOW-2115] Fix doc links to PythonHosted
-[AIRFLOW-XXX] Add contributor from Easy company
-[AIRFLOW-1882] Add ignoreUnknownValues option to gcs_to_bq operator
-[AIRFLOW-2089] Add on kill for SparkSubmit in Standalone Cluster
-[AIRFLOW-2113] Address missing DagRun callbacks Given that the handle_callback method belongs to the DAG object, we are able to get the list of task directly with get_task and reduce the communication with the database, making airflow more lightweight.
-[AIRFLOW-2112] Fix svg width for Recent Tasks on UI.
-[AIRFLOW-2116] Set CI Cloudant version to <2.0
-[AIRFLOW-XXX] Add PMC to list of companies using Airflow
-[AIRFLOW-2100] Fix Broken Documentation Links
-[AIRFLOW-1404] Add 'flatten_results' & 'maximum_bytes_billed' to BQ Operator
-[AIRFLOW-800] Initialize valid Google BigQuery Connection
-[AIRFLOW-1319] Fix misleading SparkSubmitOperator and SparkSubmitHook docstring
-[AIRFLOW-1983] Parse environment parameter as template
-[AIRFLOW-2095] Add operator to create External BigQuery Table
-[AIRFLOW-2085] Add SparkJdbc operator
-[AIRFLOW-1002] Add ability to clean all dependencies of removed DAG
-[AIRFLOW-2094] Jinjafied project_id, region & zone in DataProc{*} Operators
-[AIRFLOW-2092] Fixed incorrect parameter in docstring for FTPHook
-[AIRFLOW-XXX] Add SocialCops to Airflow users
-[AIRFLOW-2088] Fix duplicate keys in MySQL to GCS Helper function
-[AIRFLOW-2091] Fix incorrect docstring parameter in BigQuery Hook
-[AIRFLOW-2090] Fix typo in DataStore Hook
-[AIRFLOW-1157] Fix missing pools crashing the scheduler
-[AIRFLOW-713] Jinjafy {EmrCreateJobFlow,EmrAddSteps}Operator attributes
-[AIRFLOW-2083] Docs: Use "its" instead of "it's" where appropriate
-[AIRFLOW-2066] Add operator to create empty BQ table
-[AIRFLOW-XXX] add Karmic to list of companies
-[AIRFLOW-2073] Make FileSensor fail when the file doesn't exist
-[AIRFLOW-2078] Improve task_stats and dag_stats performance
-[AIRFLOW-2080] Use a log-out icon instead of a power button
-[AIRFLOW-2077] Fetch all pages of list_objects_v2 response
-[AIRFLOW-XXX] Add TM to list of companies
-[AIRFLOW-1985] Impersonation fixes for using `run_as_user`
-[AIRFLOW-2018][AIRFLOW-2] Make Sensors backward compatible
-[AIRFLOW-XXX] Fix typo in concepts doc (dag_md)
-[AIRFLOW-2069] Allow Bytes to be uploaded to S3
-[AIRFLOW-2074] Fix log var name in GHE auth
-[AIRFLOW-1927] Convert naive datetimes for TaskInstances
-[AIRFLOW-1760] Password auth for experimental API
-[AIRFLOW-2038] Add missing kubernetes dependency for dev
-[AIRFLOW-2040] Escape special chars in task instance logs URL
-[AIRFLOW-1968][AIRFLOW-1520] Add role_arn and aws_account_id/aws_iam_role support back to aws hook
-[AIRFLOW-2048] Fix task instance failure string formatting
-[AIRFLOW-2046] Fix kerberos error to work with python 3.x
-[AIRFLOW-2063] Add missing docs for GCP
-[AIRFLOW-XXX] Fix typo in docs
-[AIRFLOW-1793] Use docker_url instead of invalid base_url
-[AIRFLOW-2055] Elaborate on slightly ambiguous documentation
-[AIRFLOW-2039] BigQueryOperator supports priority property
-[AIRFLOW-2053] Fix quote character bug in BQ hook
-[AIRFLOW-2057] Add Overstock to list of companies
-[AIRFLOW-XXX] Add Plaid to Airflow users
-[AIRFLOW-2044] Add SparkSubmitOperator to documentation
-[AIRFLOW-2037] Add methods to get Hash values of a GCS object
-[AIRFLOW-2050] Fix Travis permission problem
-[AIRFLOW-2043] Add Intercom to list of companies
-[AIRFLOW-2023] Add debug logging around number of queued files
-[AIRFLOW-XXX] Add Pernod-ricard as a airflow user
-[AIRFLOW-1453] Add 'steps' into template_fields in EmrAddSteps
-[AIRFLOW-2015] Add flag for interactive runs
-[AIRFLOW-1895] Fix primary key integrity for mysql
-[AIRFLOW-2030] Fix KeyError:`i` in DbApiHook for insert
-[AIRFLOW-1943] Add External BigQuery Table feature
-[AIRFLOW-2033] Add Google Cloud Storage List Operator
-[AIRFLOW-2006] Add local log catching to kubernetes operator
-[AIRFLOW-2031] Add missing gcp_conn_id in the example in DataFlow docstrings
-[AIRFLOW-2029] Fix AttributeError in BigQueryPandasConnector
-[AIRFLOW-2028] Add JobTeaser to official users list
-[AIRFLOW-2016] Add support for Dataproc Workflow Templates
-[AIRFLOW-2025] Reduced Logging verbosity
-[AIRFLOW-1267][AIRFLOW-1874] Add dialect parameter to BigQueryHook
-[AIRFLOW-XXX] Fixed a typo
-[AIRFLOW-XXX] Typo node to nodes
-[AIRFLOW-2019] Update DataflowHook for updating Streaming type job
-[AIRFLOW-2017][Airflow 2017] adding query output to PostgresOperator
-[AIRFLOW-1889] Split sensors into separate files
-[AIRFLOW-1950] Optionally pass xcom_pull task_ids
-[AIRFLOW-1755] Allow mount below root
-[AIRFLOW-511][Airflow 511] add success/failure callbacks on dag level
-[AIRFLOW-192] Add weight_rule param to BaseOperator
-[AIRFLOW-2008] Use callable for python column defaults
-[AIRFLOW-1984] Fix to AWS Batch operator
-[AIRFLOW-2000] Support non-main dataflow job class
-[AIRFLOW-2003] Use flask-caching instead of flask-cache
-[AIRFLOW-2002] Do not swallow exception on logging import
-[AIRFLOW-2004] Import flash from flask not flask.login
-[AIRFLOW-1997] Fix GCP operator doc strings
-[AIRFLOW-1996] Update DataflowHook waitfordone for Streaming type job[]
-[AIRFLOW-1995][Airflow 1995] add on_kill method to SqoopOperator
-[AIRFLOW-1770] Allow HiveOperator to take in a file
-[AIRFLOW-1994] Change background color of Scheduled state Task Instances
-[AIRFLOW-1436][AIRFLOW-1475] EmrJobFlowSensor considers Cancelled step as Successful
-[AIRFLOW-1517] Kubernetes operator PR fixes
-[AIRFLOW-1517] addressed PR comments
-[AIRFLOW-1517] started documentation of k8s operator
-[AIRFLOW-1517] Restore authorship of resources
-[AIRFLOW-1517] Remove authorship of resources
-[AIRFLOW-1517] Add minikube for kubernetes integration tests
-[AIRFLOW-1517] Restore authorship of resources
-[AIRFLOW-1517] fixed license issues
-[AIRFLOW-1517] Created more accurate failures for kube cluster issues
-[AIRFLOW-1517] Remove authorship of resources
-[AIRFLOW-1517] Add minikube for kubernetes integration tests
-[AIRFLOW-1988] Change BG color of None state TIs
-[AIRFLOW-790] Clean up TaskInstances without DagRuns
-[AIRFLOW-1949] Fix var upload, str() produces "b'...'" which is not json
-[AIRFLOW-1930] Convert func.now() to timezone.utcnow()
-[AIRFLOW-1688] Support load.time_partitioning in bigquery_hook
-[AIRFLOW-1975] Make TriggerDagRunOperator callback optional
-[AIRFLOW-1480] Render template attributes for ExternalTaskSensor fields
-[AIRFLOW-1958] Add **kwargs to send_email
-[AIRFLOW-1976] Fix for missing log/logger attribute FileProcessHandler
-[AIRFLOW-1982] Fix Executor event log formatting
-[AIRFLOW-1971] Propagate hive config on impersonation
-[AIRFLOW-1969] Always use HTTPS URIs for Google OAuth2
-[AIRFLOW-1954] Add DataFlowTemplateOperator
-[AIRFLOW-1963] Add config for HiveOperator mapred_queue
-[AIRFLOW-1946][AIRFLOW-1855] Create a BigQuery Get Data Operator
-[AIRFLOW-1953] Add labels to dataflow operators
-[AIRFLOW-1967] Update Celery to 4.0.2
-[AIRFLOW-1964] Add Upsight to list of Airflow users
-[AIRFLOW-XXX] Changelog for 1.9.0
-[AIRFLOW-1470] Implement BashSensor operator
-[AIRFLOW-XXX] Pin sqlalchemy dependency
-[AIRFLOW-1955] Do not reference unassigned variable
-[AIRFLOW-1957] Add contributor to BalanceHero in Readme
-[AIRFLOW-1517] Restore authorship of secrets and init container
-[AIRFLOW-1517] Remove authorship of secrets and init container
-[AIRFLOW-1935] Add BalanceHero to readme
-[AIRFLOW-1939] add astronomer contributors
-[AIRFLOW-1517] Kubernetes Operator
-[AIRFLOW-1928] Fix @once with catchup=False
-[AIRFLOW-1937] Speed up scheduling by committing in batch
-[AIRFLOW-1821] Enhance default logging config by removing extra loggers
-[AIRFLOW-1904] Correct DAG fileloc to the right filepath
-[AIRFLOW-1909] Update docs with supported versions of MySQL server
-[AIRFLOW-1915] Relax flask-wtf dependency specification
-[AIRFLOW-1920] Update CONTRIBUTING.md to reflect enforced linting rules
-[AIRFLOW-1942] Update Sphinx docs to remove deprecated import structure
-[AIRFLOW-1846][AIRFLOW-1697] Hide Ad Hoc Query behind secure_mode config
-[AIRFLOW-1948] Include details for on_kill failure
-[AIRFLOW-1938] Clean up unused exception
-[AIRFLOW-1932] Add GCP Pub/Sub Pull and Ack
-[AIRFLOW-XXX] Purge coveralls
-[AIRFLOW-XXX] Remove unused coveralls token
-[AIRFLOW-1938] Remove tag version check in setup.py
-[AIRFLOW-1916] Don't upload logs to remote from `run --raw`
-[AIRFLOW-XXX] Fix failing PubSub tests on Python3
-[AIRFLOW-XXX] Upgrade to python 3.5 and disable dask tests
-[AIRFLOW-1913] Add new GCP PubSub operators
-[AIRFLOW-1525] Fix minor LICENSE and NOTICE issues
-[AIRFLOW-1687] fix fernet error without encryption
-[AIRFLOW-1912] airflow.processor should not propagate logging
-[AIRFLOW-1911] Rename celeryd_concurrency
-[AIRFLOW-1885] Fix IndexError in ready_prefix_on_cmdline
-[AIRFLOW-1854] Improve Spark Submit operator for standalone cluster mode
-[AIRFLOW-1908] Fix celery broker options config load
-[AIRFLOW-1907] Pass max_ingestion_time to Druid hook
-[AIRFLOW-1909] Add away to list of users
-[AIRFLOW-1893][AIRFLOW-1901] Propagate PYTHONPATH when using impersonation
-[AIRFLOW-1892] Modify BQ hook to extract data filtered by column
-[AIRFLOW-1829] Support for schema updates in query jobs
-[AIRFLOW-1840] Make celery configuration congruent with Celery 4
-[AIRFLOW-1878] Fix stderr/stdout redirection for tasks
-[AIRFLOW-1897][AIRFLOW-1873] Task Logs for running instance not visible in WebUI
-[AIRFLOW-1896] FIX bleach <> html5lib incompatibility
-[AIRFLOW-1884][AIRFLOW-1059] Reset orphaned task state for external dagruns
-[AIRFLOW-XXX] Fix typo in comment
-[AIRFLOW-1869] Do not emit spurious warning on missing logs
-[AIRFLOW-1888] Add AWS Redshift Cluster Sensor
-[AIRFLOW-1887] Renamed endpoint url variable
-[AIRFLOW-1873] Set TI.try_number to right value depending TI state
-[AIRFLOW-1891] Fix non-ascii typo in default configuration template
-[AIRFLOW-1879] Handle ti log entirely within ti
-[AIRFLOW-1869] Write more error messages into gcs and file logs
-[AIRFLOW-1876] Write subtask id to task log header
-[AIRFLOW-1554] Fix wrong DagFileProcessor termination method call
-[AIRFLOW-342] Do not use amqp, rpc as result backend
-[AIRFLOW-966] Make celery broker_transport_options configurable
-[AIRFLOW-1881] Make operator log in task log
-[AIRFLOW-XXX] Added DataReply to the list of Airflow Users
-[AIRFLOW-1883] Get File Size for objects in Google Cloud Storage
-[AIRFLOW-1872] Set context for all handlers including parents
-[AIRFLOW-1855][AIRFLOW-1866] Add GCS Copy Operator to copy multiple files
-[AIRFLOW-1870] Enable flake8 tests
-[AIRFLOW-1785] Enable Python 3 tests
-[AIRFLOW-1850] Copy cmd before masking
-[AIRFLOW-1665] Reconnect on database errors
-[AIRFLOW-1559] Dispose SQLAlchemy engines on exit
-[AIRFLOW-1559] Close file handles in subprocesses
-[AIRFLOW-1559] Make database pooling optional
-[AIRFLOW-1848][Airflow-1848] Fix DataFlowPythonOperator py_file extension doc comment
-[AIRFLOW-1843] Add Google Cloud Storage Sensor with prefix
-[AIRFLOW-1803] Time zone documentation
-[AIRFLOW-1826] Update views to use timezone aware objects
-[AIRFLOW-1827] Fix api endpoint date parsing
-[AIRFLOW-1806] Use naive datetime when using cron
-[AIRFLOW-1809] Update tests to use timezone aware objects
-[AIRFLOW-1806] Use naive datetime for cron scheduling
-[AIRFLOW-1807] Force use of time zone aware db fields
-[AIRFLOW-1808] Convert all utcnow() to time zone aware
-[AIRFLOW-1804] Add time zone configuration options
-[AIRFLOW-1802] Convert database fields to timezone aware
-[AIRFLOW-XXX] Add dask lock files to excludes
-[AIRFLOW-1790] Add support for AWS Batch operator
-[AIRFLOW-XXX] Update README.md
-[AIRFLOW-1820] Remove timestamp from metric name
-[AIRFLOW-1810] Remove unused mysql import in migrations.
-[AIRFLOW-1838] Properly log collect_dags exception
-[AIRFLOW-1842] Fixed Super class name for the gcs to gcs copy operator
-[AIRFLOW-1845] Modal background now covers long or tall pages
-[AIRFLOW-1229] Add link to Run Id, incl execution_date
-[AIRFLOW-1842] Add gcs to gcs copy operator with renaming if required
-[AIRFLOW-1841] change False to None in operator and hook
-[AIRFLOW-1839] Fix more bugs in S3Hook boto -> boto3 migration
-[AIRFLOW-1830] Support multiple domains in Google authentication backend
-[AIRFLOW-1831] Add driver-classpath spark submit
-[AIRFLOW-1795] Correctly call S3Hook after migration to boto3
-[AIRFLOW-1811] Fix render Druid operator
-[AIRFLOW-1819] Fix slack operator unittest bug
-[AIRFLOW-1805] Allow Slack token to be passed through connection
-[AIRFLOW-1816] Add region param to Dataproc operators
-[AIRFLOW-868] Add postgres_to_gcs operator and unittests
-[AIRFLOW-1613] make mysql_to_gcs_operator py3 compatible
-[AIRFLOW-1817] use boto3 for s3 dependency
-[AIRFLOW-1813] Bug SSH Operator empty buffer
-[AIRFLOW-1801][AIRFLOW-288] Url encode execution dates
-[AIRFLOW-1563] Catch OSError while symlinking the latest log directory
-[AIRFLOW-1794] Remove uses of Exception.message for Python 3
-[AIRFLOW-1799] Fix logging line which raises errors
-[AIRFLOW-1102] Upgrade Gunicorn >=19.4.0
-[AIRFLOW-1756] Fix S3TaskHandler to work with Boto3-based S3Hook
-[AIRFLOW-1797] S3Hook.load_string didn't work on Python3
-[AIRFLOW-646] Add docutils to setup_requires
-[AIRFLOW-1792] Missing intervals DruidOperator
-[AIRFLOW-1789][AIRFLOW-1712] Log SSHOperator stderr to log.warning
-[AIRFLOW-1787] Fix task instance batch clear and set state bugs
-[AIRFLOW-1780] Fix long output lines with unicode from hanging parent
-[AIRFLOW-387] Close SQLAlchemy sessions properly
-[AIRFLOW-1779] Add keepalive packets to ssh hook
-[AIRFLOW-1669] Fix Docker and pin Moto to 1.1.19
-[AIRFLOW-71] Add support for private Docker images
-[AIRFLOW-XXX] Give a clue what the 'ds' variable is
-[AIRFLOW-XXX] Correct typos in the faq docs page
-[AIRFLOW-1571] Add AWS Lambda Hook
-[AIRFLOW-1675] Fix docstrings for API docs
-[AIRFLOW-1712][AIRFLOW-756][AIRFLOW-751] Log SSHOperator output
-[AIRFLOW-1776] Capture stdout and stderr for logging
-[AIRFLOW-1765] Make experimental API securable without needing Kerberos.
-[AIRFLOW-1764] The web interface should not use the experimental API
-[AIRFLOW-1771] Rename heartbeat to avoid confusion
-[AIRFLOW-1769] Add support for templates in VirtualenvOperator
-[AIRFLOW-1763] Fix S3TaskHandler unit tests
-[AIRFLOW-1315] Add Qubole File & Partition Sensors
-[AIRFLOW-1018] Make processor use logging framework
-[AIRFLOW-1695] Add RedshiftHook using boto3
-[AIRFLOW-1706] Fix query error for MSSQL backend
-[AIRFLOW-1711] Use ldap3 dict for group membership
-[AIRFLOW-1723] Make sendgrid a plugin
-[AIRFLOW-1757] Add missing options to SparkSubmitOperator
-[AIRFLOW-1734][Airflow 1734] Sqoop hook/operator enhancements
-[AIRFLOW-1761] Fix type in scheduler.rst
-[AIRFLOW-1731] Set pythonpath for logging
-[AIRFLOW-1641] Handle executor events in the scheduler
-[AIRFLOW-1744] Make sure max_tries can be set
-[AIRFLOW-1732] Improve dataflow hook logging
-[AIRFLOW-1736] Add HotelQuickly to Who Uses Airflow
-[AIRFLOW-1657] Handle failing qubole operator
-[AIRFLOW-1677] Fix typo in example_qubole_operator
-[AIRFLOW-926] Fix JDBC Hook
-[AIRFLOW-1520] Boto3 S3Hook, S3Log
-[AIRFLOW-1716] Fix multiple __init__ def in SimpleDag
-[AIRFLOW-XXX] Fix DateTime in Tree View
-[AIRFLOW-1719] Fix small typo
-[AIRFLOW-1432] Charts label for Y axis not visible
-[AIRFLOW-1743] Verify ldap filters correctly
-[AIRFLOW-1745] Restore default signal disposition
-[AIRFLOW-1741] Correctly hide second chart on task duration page
-[AIRFLOW-1728] Add networkUri, subnet, tags to Dataproc operator
-[AIRFLOW-1726] Add copy_expert psycopg2 method to PostgresHook
-[AIRFLOW-1330] Add conn_type argument to CLI when adding connection
-[AIRFLOW-1698] Remove SCHEDULER_RUNS env var in systemd
-[AIRFLOW-1694] Stop using itertools.izip
-[AIRFLOW-1692] Change test_views filename to support Windows
-[AIRFLOW-1722] Fix typo in scheduler autorestart output filename
-[AIRFLOW-1723] Support sendgrid in email backend
-[AIRFLOW-1718] Set num_retries on Dataproc job request execution
-[AIRFLOW-1727] Add unit tests for DataProcHook
-[AIRFLOW-1631] Fix timing issue in unit test
-[AIRFLOW-1631] Fix local executor unbound parallelism
-[AIRFLOW-1724] Add Fundera to Who uses Airflow?
-[AIRFLOW-1683] Cancel BigQuery job on timeout.
-[AIRFLOW-1714] Fix misspelling: s/seperate/separate/
-[AIRFLOW-1681] Add batch clear in task instance view
-[AIRFLOW-1696] Fix dataproc version label error
-[AIRFLOW-1613] Handle binary field in MySqlToGoogleCloudStorageOperator
-[AIRFLOW-1697] Mode to disable charts endpoint
-[AIRFLOW-1691] Add better Google cloud logging documentation
-[AIRFLOW-1690] Add detail to gcs error messages
-[AIRFLOW-1682] Make S3TaskHandler write to S3 on close
-[AIRFLOW-1634] Adds task_concurrency feature
-[AIRFLOW-1676] Make GCSTaskHandler write to GCS on close
-[AIRFLOW-1678] Fix erroneously repeated word in function docstrings
-[AIRFLOW-1323] Made Dataproc operator parameter names consistent
-[AIRFLOW-1590] fix unused module and variable
-[AIRFLOW-1671] Add @apply_defaults back to gcs download operator
-[AIRFLOW-988] Fix repeating SLA miss callbacks
-[AIRFLOW-1611] Customize logging
-[AIRFLOW-1668] Expose keepalives_idle for Postgres connections
-[AIRFLOW-1658] Kill Druid task on timeout
-[AIRFLOW-1669][AIRFLOW-1368] Fix Docker import
-[AIRFLOW-891] Make webserver clock include date
-[AIRFLOW-1560] Add AWS DynamoDB hook and operator for inserting batch items
-[AIRFLOW-1654] Show tooltips for link icons in DAGs view
-[AIRFLOW-1660] Change webpage width to full-width
-[AIRFLOW-1664] write file as binary instead of str
-[AIRFLOW-1659] Fix invalid obj attribute bug in file_task_handler.py
-[AIRFLOW-1635] Allow creating GCP connection without requiring a JSON file
-[AIRFLOW-1650] Fix custom celery config loading
-[AIRFLOW-1647] Fix Spark-sql hook
-[AIRFLOW-1587] Fix CeleryExecutor import error
-[Airflow-1640][AIRFLOW-1640] Add qubole default connection
-[AIRFLOW-1576] Added region param to Dataproc{*}Operators
-[AIRFLOW-1643] Add healthjump to officially using list
-[AIRFLOW-1626] Add Azri Solutions to Airflow users
-[AIRFLOW-1636] Add AWS and EMR connection type
-[AIRFLOW-1527] Refactor celery config
-[AIRFLOW-1639] Fix Fernet error handling
-[AIRFLOW-1637] Fix Travis CI build status link
-[AIRFLOW-1628] Fix docstring of sqlsensor
-[AIRFLOW-1331] add SparkSubmitOperator option
-[AIRFLOW-1627] Only query pool in SubDAG init when necessary
-[AIRFLOW-1629] Make extra a textarea in edit connections form
-[AIRFLOW-1368] Automatically remove Docker container on exit
-[AIRFLOW-289] Make airflow timezone independent
-[AIRFLOW-1356] Add `--celery_hostname` to `airflow worker`
-[AIRFLOW-1247] Fix ignore_all_dependencies argument ignored
-[AIRFLOW-1621] Add tests for server side paging
-[AIRFLOW-1591] Avoid attribute error when rendering logging filename
-[AIRFLOW-1031] Replace hard-code to DagRun.ID_PREFIX
-[AIRFLOW-1604] Rename logger to log
-[AIRFLOW-1512] Add PythonVirtualenvOperator
-[AIRFLOW-1617] Fix XSS vulnerability in Variable endpoint
-[AIRFLOW-1497] Reset hidden fields when changing connection type
-[AIRFLOW-1619] Add poll_sleep parameter to GCP dataflow operator
-[AIRFLOW-XXX] Remove landscape.io config
-[AIRFLOW-XXX] Remove non working service badges
-[AIRFLOW-1177] Fix Variable.setdefault w/existing JSON
-[AIRFLOW-1600] Fix exception handling in get_fernet
-[AIRFLOW-1614] Replace inspect.stack() with sys._getframe()
-[AIRFLOW-1519] Add server side paging in DAGs list
-[AIRFLOW-1309] Allow hive_to_druid to take tblproperties
-[AIRFLOW-1613] Make MySqlToGoogleCloudStorageOperator compaitible with python3
-[AIRFLOW-1603] add PAYMILL to companies list
-[AIRFLOW-1609] Fix gitignore to ignore all venvs
-[AIRFLOW-1601] Add configurable task cleanup time
+- [AIRFLOW-2870] Use abstract TaskInstance for migration
+- [AIRFLOW-2859] Implement own UtcDateTime (#3708)
+- [AIRFLOW-2140] Don't require kubernetes for the SparkSubmit hook
+- [AIRFLOW-2869] Remove smart quote from default config
+- [AIRFLOW-2857] Fix Read the Docs env
+- [AIRFLOW-2817] Force explicit choice on GPL dependency
+- [AIRFLOW-2716] Replace async and await py3.7 keywords
+- [AIRFLOW-2810] Fix typo in Xcom model timestamp
+- [AIRFLOW-2710] Clarify fernet key value in documentation
+- [AIRFLOW-2606] Fix DB schema and SQLAlchemy model
+- [AIRFLOW-2646] Fix setup.py not to install snakebite on Python3
+- [AIRFLOW-2604] Add index to task_fail
+- [AIRFLOW-2650] Mark SchedulerJob as succeed when hitting Ctrl-c
+- [AIRFLOW-2678] Fix db schema unit test to remove checking fab models
+- [AIRFLOW-2624] Fix webserver login as anonymous
+- [AIRFLOW-2654] Fix incorret URL on refresh in Graph View of FAB UI
+- [AIRFLOW-2668] Handle missing optional cryptography dependency
+- [AIRFLOW-2681] Include last dag run of externally triggered DAGs in UI.
+- [AIRFLOW-1840] Support back-compat on old celery config
+- [AIRFLOW-2612][AIRFLOW-2534] Clean up Hive-related tests
+- [AIRFLOW-2608] Implements/Standardize custom exceptions for experimental APIs
+- [AIRFLOW-2607] Fix failing TestLocalClient
+- [AIRFLOW-2638] dbapi_hook: support REPLACE INTO
+- [AIRFLOW-2542][AIRFLOW-1790] Rename AWS Batch Operator queue to job_queue
+- [AIRFLOW-2567] Extract result from the kubernetes pod as Xcom
+- [AIRFLOW-XXX] Adding REA Group to readme
+- [AIRFLOW-2601] Allow user to specify k8s config
+- [AIRFLOW-2559] Azure Fileshare hook
+- [AIRFLOW-1786] Enforce correct behavior for soft-fail sensors
+- [AIRFLOW-2355] Airflow trigger tag parameters in subdag
+- [AIRFLOW-2613] Fix Airflow searching .zip bug
+- [AIRFLOW-2627] Add a sensor for Cassandra
+- [AIRFLOW-2634][AIRFLOW-2534] Remove dependency for impyla
+- [AIRFLOW-2611] Fix wrong dag volume mount path for kubernetes executor
+- [AIRFLOW-2562] Add Google Kubernetes Engine Operators
+- [AIRFLOW-2630] Fix classname in test_sql_sensor.py
+- [AIRFLOW-2534] Fix bug in HiveServer2Hook
+- [AIRFLOW-2586] Stop getting AIRFLOW_HOME value from config file in bash operator
+- [AIRFLOW-2605] Fix autocommit for MySqlHook
+- [AIRFLOW-2539][AIRFLOW-2359] Move remaing log config to configuration file
+- [AIRFLOW-1656] Tree view dags query changed
+- [AIRFLOW-2617] add imagePullPolicy config for kubernetes executor
+- [AIRFLOW-2429] Fix security/task/sensors/ti_deps folders flake8 error
+- [AIRFLOW-2550] Implements API endpoint to list DAG runs
+- [AIRFLOW-2512][AIRFLOW-2522] Use google-auth instead of oauth2client
+- [AIRFLOW-2429] Fix operators folder flake8 error
+- [AIRFLOW-2585] Fix several bugs in CassandraHook and CassandraToGCSOperator
+- [AIRFLOW-2597] Restore original dbapi.run() behavior
+- [AIRFLOW-2590] Fix commit in DbApiHook.run() for no-autocommit DB
+- [AIRFLOW-1115] fix github oauth api URL
+- [AIRFLOW-2587] Add TIMESTAMP type mapping to MySqlToHiveTransfer
+- [AIRFLOW-2591][AIRFLOW-2581] Set default value of autocommit to False in DbApiHook.run()
+- [AIRFLOW-59] Implement bulk_dump and bulk_load for the Postgres hook
+- [AIRFLOW-2533] Fix path to DAG's on kubernetes executor workers
+- [AIRFLOW-2581] RFLOW-2581] Fix DbApiHook autocommit
+- [AIRFLOW-2578] Add option to use proxies in JiraHook
+- [AIRFLOW-2575] Make gcs to gcs operator work with large files
+- [AIRFLOW-437] Send TI context in kill zombies
+- [AIRFLOW-2566] Change backfill to rerun failed tasks
+- [AIRFLOW-1021] Fix double login for new users with LDAP
+- [AIRFLOW-XXX] Typo fix
+- [AIRFLOW-2561] Fix typo in EmailOperator
+- [AIRFLOW-2573] Cast BigQuery TIMESTAMP field to float
+- [AIRFLOW-2560] Adding support for internalIpOnly to DataprocClusterCreateOperator
+- [AIRFLOW-2565] templatize cluster_label
+- [AIRFLOW-83] add mongo hook and operator
+- [AIRFLOW-2558] Clear task/dag is clearing all executions
+- [AIRFLOW-XXX] Fix doc typos
+- [AIRFLOW-2513] Change `bql` to `sql` for BigQuery Hooks & Ops
+- [AIRFLOW-2557] Fix pagination for s3
+- [AIRFLOW-2545] Eliminate DeprecationWarning
+- [AIRFLOW-2500] Fix MySqlToHiveTransfer to transfer unsigned type properly
+- [AIRFLOW-2462] Change PasswordUser setter to correct syntax
+- [AIRFLOW-2525] Fix a bug introduced by commit dabf1b9
+- [AIRFLOW-2553] Add webserver.pid to .gitignore
+- [AIRFLOW-1863][AIRFLOW-2529] Add dag run selection widgets to gantt view
+- [AIRFLOW-2504] Log username correctly and add extra to search columns
+- [AIRFLOW-2551] Encode binary data with base64 standard rather than base64 url
+- [AIRFLOW-2537] Add reset-dagrun option to backfill command
+- [AIRFLOW-2526] dag_run.conf can override params
+- [AIRFLOW-2544][AIRFLOW-1967] Guard against next major release of Celery, Flower
+- [AIRFLOW-XXX] Add Yieldr to who is using airflow
+- [AIRFLOW-2547] Describe how to run tests using Docker
+- [AIRFLOW-2538] Update faq doc on how to reduce airflow scheduler latency
+- [AIRFLOW-2529] Improve graph view performance and usability
+- [AIRFLOW-2517] backfill support passing key values through CLI
+- [AIRFLOW-2532] Support logs_volume_subpath for KubernetesExecutor
+- [AIRFLOW-2466] consider task_id in _change_state_for_tis_without_dagrun
+- [AIRFLOW-2519] Fix CeleryExecutor with SQLAlchemy
+- [AIRFLOW-2402] Fix RBAC task log
+- [AIRFLOW-XXX] Add M4U to user list
+- [AIRFLOW-2536] docs about how to deal with airflow initdb failure
+- [AIRFLOW-2530] KubernetesOperator supports multiple clusters
+- [AIRFLOW-1499] Eliminate duplicate and unneeded code
+- [AIRFLOW-2521] backfill - make variable name and logging messages more acurate
+- [AIRFLOW-2429] Fix hook, macros folder flake8 error
+- [Airflow-XXX] add Prime to company list
+- [AIRFLOW-2525] Fix PostgresHook.copy_expert to work with "COPY FROM"
+- [AIRFLOW-2515] Add dependency on thrift_sasl to hive extra
+- [AIRFLOW-2523] Add how-to for managing GCP connections
+- [AIRFLOW-2510] Introduce new macros: prev_ds and next_ds
+- [AIRFLOW-1730] Unpickle value of XCom queried from DB
+- [AIRFLOW-2518] Fix broken ToC links in integration.rst
+- [AIRFLOW-1472] Fix SLA misses triggering on skipped tasks.
+- [AIRFLOW-2520] CLI - make backfill less verbose
+- [AIRFLOW-2107] add time_partitioning to run_query on BigQueryBaseCursor
+- [AIRFLOW-1057][AIRFLOW-1380][AIRFLOW-2362][2362] AIRFLOW Update DockerOperator to new API
+- [AIRFLOW-2415] Make airflow DAG templating render numbers
+- [AIRFLOW-2473] Fix wrong skip condition for TransferTests
+- [AIRFLOW-2472] Implement MySqlHook.bulk_dump
+- [AIRFLOW-2419] Use default view for subdag operator
+- [AIRFLOW-2498] Fix Unexpected argument in SFTP Sensor
+- [AIRFLOW-2509] Separate config docs into how-to guides
+- [AIRFLOW-2429] Add BaseExecutor back
+- [AIRFLOW-2429] Fix dag, example_dags, executors flake8 error
+- [AIRFLOW-2502] Change Single triple quotes to double for docstrings
+- [AIRFLOW-2503] Fix broken links in CONTRIBUTING.md
+- [AIRFLOW-2501] Refer to devel instructions in docs contrib guide
+- [AIRFLOW-2429] Fix contrib folder's flake8 errors
+- [AIRFLOW-2471] Fix HiveCliHook.load_df to use unused parameters
+- [AIRFLOW-2495] Update celery to 4.1.1
+- [AIRFLOW-2429] Fix api, bin, config_templates folders flake8 error
+- [AIRFLOW-2493] Mark template_fields of all Operators in the API document as "templated"
+- [AIRFLOW-2489] Update FlaskAppBuilder to 1.11.1
+- [AIRFLOW-2448] Enhance HiveCliHook.load_df to work with datetime
+- [AIRFLOW-2487] Enhance druid ingestion hook
+- [AIRFLOW-2397] Support affinity policies for Kubernetes executor/operator
+- [AIRFLOW-2482] Add test for rewrite method in GCS Hook
+- [AIRFLOW-2481] Fix flaky Kubernetes test
+- [AIRFLOW-2479] Improve doc FAQ section
+- [AIRFLOW-2485] Fix Incorrect logging for Qubole Sensor
+- [AIRFLOW-2486] Remove unnecessary slash after port
+- [AIRFLOW-2429] Make Airflow flake8 compliant
+- [AIRFLOW-2491] Resolve flask version conflict
+- [AIRFLOW-2484] Remove duplicate key in MySQL to GCS Op
+- [ARIFLOW-2458] Add cassandra-to-gcs operator
+- [AIRFLOW-2477] Improve time units for task duration and landing times charts for RBAC UI
+- [AIRFLOW-2474] Only import snakebite if using py2
+- [AIRFLOW-48] Parse connection uri querystring
+- [AIRFLOW-2467][AIRFLOW-2] Update import direct warn message to use the module name
+- [AIRFLOW-XXX] Fix order of companies
+- [AIRFLOW-2452] Document field_dict must be OrderedDict
+- [AIRFLOW-2420] Azure Data Lake Hook
+- [AIRFLOW-2213] Add Quoble check operator
+- [AIRFLOW-2465] Fix wrong module names in the doc
+- [AIRFLOW-1929] Modifying TriggerDagRunOperator to accept execution_date
+- [AIRFLOW-2460] Users can now use volume mounts and volumes
+- [AIRFLOW-2110][AIRFLOW-2122] Enhance Http Hook
+- [AIRFLOW-XXX] Updated contributors list
+- [AIRFLOW-2435] Add launch_type to ECSOperator to allow FARGATE
+- [AIRFLOW-2451] Remove extra slash ('/') char when using wildcard in gcs_to_gcs operator
+- [AIRFLOW-2461] Add support for cluster scaling on dataproc operator
+- [AIRFLOW-2376] Fix no hive section error
+- [AIRFLOW-2425] Add lineage support
+- [AIRFLOW-2430] Extend query batching to additional slow queries
+- [AIRFLOW-2453] Add default nil value for kubernetes/git_subpath
+- [AIRFLOW-2396] Add support for resources in kubernetes operator
+- [AIRFLOW-2169] Encode binary data with base64 before importing to BigQuery
+- [AIRFLOW-XXX] Add spotahome in user list
+- [AIRFLOW-2457] Update FAB version requirement
+- [AIRFLOW-2454][Airflow 2454] Support imagePullPolicy for k8s
+- [AIRFLOW-2450] update supported k8s versions to 1.9 and 1.10
+- [AIRFLOW-2333] Add Segment Hook and TrackEventOperator
+- [AIRFLOW-2442][AIRFLOW-2] Airflow run command leaves database connections open
+- [AIRFLOW-2016] assign template_fields for Dataproc Workflow Template sub-classes, not base class
+- [AIRFLOW-2446] Add S3ToRedshiftTransfer into the "Integration" doc
+- [AIRFLOW-2449] Fix operators.py to run all test cases
+- [AIRFLOW-2424] Add dagrun status endpoint and increased k8s test coverage
+- [AIRFLOW-2441] Fix bugs in HiveCliHook.load_df
+- [AIRFLOW-2358][AIRFLOW-201804] Make the Kubernetes example optional
+- [AIRFLOW-2436] Remove cli_logger in initdb
+- [AIRFLOW-2444] Remove unused option(include_adhoc) in cli backfill command
+- [AIRFLOW-2447] Fix TestHiveMetastoreHook to run all cases
+- [AIRFLOW-2445] Allow templating in kubernetes operator
+- [AIRFLOW-2086][AIRFLOW-2393] Customize default dagrun number in tree view
+- [AIRFLOW-2437] Add PubNub to list of current airflow users
+- [AIRFLOW-XXX] Add Quantopian to list of Airflow users
+- [AIRFLOW-1978] Add WinRM windows operator and hook
+- [AIRFLOW-2427] Add tests to named hive sensor
+- [AIRFLOW-2412] Fix HiveCliHook.load_file to address HIVE-10541
+- [AIRFLOW-2431] Add the navigation bar color parameter for RBAC UI
+- [AIRFLOW-2407] Resolve Python undefined names
+- [AIRFLOW-1952] Add the navigation bar color parameter
+- [AIRFLOW-2222] Implement GoogleCloudStorageHook.rewrite
+- [AIRFLOW-2426] Add Google Cloud Storage Hook tests
+- [AIRFLOW-2418] Bump Flask-WTF
+- [AIRFLOW-2417] Wait for pod is not running to end task
+- [AIRFLOW-1914] Add other charset support to email utils
+- [AIRFLOW-XXX] Update README.md with Craig@Work
+- [AIRFLOW-1899] Fix Kubernetes tests
+- [AIRFLOW-1812] Update logging example
+- [AIRFLOW-2313] Add TTL parameters for Dataproc
+- [AIRFLOW-2411] add dataproc_jars to templated_fields
+- [AIRFLOW-XXX] Add Reddit to Airflow users
+- [AIRFLOW-XXX] Fix wrong table header in scheduler.rst
+- [AIRFLOW-2409] Supply password as a parameter
+- [AIRFLOW-2410][AIRFLOW-75] Set the timezone in the RBAC Web UI
+- [AIRFLOW-2394] default cmds and arguments in kubernetes operator
+- [AIRFLOW-2406] Add Apache2 License Shield to Readme
+- [AIRFLOW-2404] Add additional documentation for unqueued task
+- [AIRFLOW-2400] Add Ability to set Environment Variables for K8s
+- [AIRFLOW-XXX] Add Twine Labs as an Airflow user
+- [AIRFLOW-1853] Show only the desired number of runs in tree view
+- [AIRFLOW-2401] Document the use of variables in Jinja template
+- [AIRFLOW-2403] Fix License Headers
+- [AIRFLOW-1313] Fix license header
+- [AIRFLOW-2398] Add BounceX to list of current airflow users
+- [AIRFLOW-2363] Fix return type bug in TaskHandler
+- [AIRFLOW-2389] Create a pinot db api hook
+- [AIRFLOW-2390] Resolve FlaskWTFDeprecationWarning
+- [AIRFLOW-1933] Fix some typos
+- [AIRFLOW-1960] Add support for secrets in kubernetes operator
+- [AIRFLOW-1313] Add vertica_to_mysql operator
+- [AIRFLOW-1575] Add AWS Kinesis Firehose Hook for inserting batch records
+- [AIRFLOW-2266][AIRFLOW-2343] Remove google-cloud-dataflow dependency
+- [AIRFLOW-2370] Implement --use_random_password in create_user
+- [AIRFLOW-2348] Strip path prefix from the destination_object when source_object contains a wildcard[]
+- [AIRFLOW-2391] Fix to Flask 0.12.2
+- [AIRFLOW-2381] Fix the flaky ApiPasswordTests test
+- [AIRFLOW-2378] Add Groupon to list of current users
+- [AIRFLOW-2382] Fix wrong description for delimiter
+- [AIRFLOW-2380] Add support for environment variables in Spark submit operator.
+- [AIRFLOW-2377] Improve Sendgrid sender support
+- [AIRFLOW-2331] Support init action timeout on dataproc cluster create
+- [AIRFLOW-1835] Update docs: Variable file is json
+- [AIRFLOW-1781] Make search case-insensitive in LDAP group
+- [AIRFLOW-2042] Fix browser menu appearing over the autocomplete menu
+- [AIRFLOW-XXX] Remove wheelhouse files from travis not owned by travis
+- [AIRFLOW-2336] Use hmsclient in hive_hook
+- [AIRFLOW-2041] Correct Syntax in python examples
+- [AIRFLOW-74] SubdagOperators can consume all celeryd worker processes
+- [AIRFLOW-2369] Fix gcs tests
+- [AIRFLOW-2365] Fix autocommit attribute check
+- [AIRFLOW-2068] MesosExecutor allows optional Docker image
+- [AIRFLOW-1652] Push DatabricksRunSubmitOperator metadata into XCOM
+- [AIRFLOW-2234] Enable insert_rows for PrestoHook
+- [AIRFLOW-2208][Airflow-22208] Link to same DagRun graph from TaskInstance view
+- [AIRFLOW-1153] Allow HiveOperators to take hiveconfs
+- [AIRFLOW-775] Fix autocommit settings with Jdbc hook
+- [AIRFLOW-2364] Warn when setting autocommit on a connection which does not support it
+- [AIRFLOW-2357] Add persistent volume for the logs
+- [AIRFLOW-766] Skip conn.commit() when in Auto-commit
+- [AIRFLOW-2351] Check for valid default_args start_date
+- [AIRFLOW-1433] Set default rbac to initdb
+- [AIRFLOW-2270] Handle removed tasks in backfill
+- [AIRFLOW-2344] Fix `connections -l` to work with pipe/redirect
+- [AIRFLOW-2300] Add S3 Select functionarity to S3ToHiveTransfer
+- [AIRFLOW-1314] Cleanup the config
+- [AIRFLOW-1314] Polish some of the Kubernetes docs/config
+- [AIRFLOW-1314] Improve error handling
+- [AIRFLOW-1999] Add per-task GCP service account support
+- [AIRFLOW-1314] Rebasing against master
+- [AIRFLOW-1314] Small cleanup to address PR comments (#24)
+- [AIRFLOW-1314] Add executor_config and tests
+- [AIRFLOW-1314] Improve k8s support
+- [AIRFLOW-1314] Use VolumeClaim for transporting DAGs
+- [AIRFLOW-1314] Create integration testing environment
+- [AIRFLOW-1314] Git Mode to pull in DAGs for Kubernetes Executor
+- [AIRFLOW-1314] Add support for volume mounts & Secrets in Kubernetes Executor
+- [AIRFLOW=1314] Basic Kubernetes Mode
+- [AIRFLOW-2326][AIRFLOW-2222] remove contrib.gcs_copy_operator
+- [AIRFLOW-2328] Fix empty GCS blob in S3ToGoogleCloudStorageOperator
+- [AIRFLOW-2350] Fix grammar in UPDATING.md
+- [AIRFLOW-2302] Fix documentation
+- [AIRFLOW-2345] pip is not used in this setup.py
+- [AIRFLOW-2347] Add Banco de Formaturas to Readme
+- [AIRFLOW-2346] Add Investorise as official user of Airflow
+- [AIRFLOW-2330] Do not append destination prefix if not given
+- [AIRFLOW-2240][DASK] Added TLS/SSL support for the dask-distributed scheduler.
+- [AIRFLOW-2309] Fix duration calculation on TaskFail
+- [AIRFLOW-2335] fix issue with jdk8 download for ci
+- [AIRFLOW-2184] Add druid_checker_operator
+- [AIRFLOW-2299] Add S3 Select functionarity to S3FileTransformOperator
+- [AIRFLOW-2254] Put header as first row in unload
+- [AIRFLOW-610] Respect _cmd option in config before defaults
+- [AIRFLOW-2287] Fix incorrect ASF headers
+- [AIRFLOW-XXX] Add Zego as an Apache Airflow user
+- [AIRFLOW-952] fix save empty extra field in UI
+- [AIRFLOW-1325] Add ElasticSearch log handler and reader
+- [AIRFLOW-2301] Sync files of an S3 key with a GCS path
+- [AIRFLOW-2293] Fix S3FileTransformOperator to work with boto3
+- [AIRFLOW-3212][AIRFLOW-2314] Remove only leading slash in GCS path
+- [AIRFLOW-1509][AIRFLOW-442] SFTP Sensor
+- [AIRFLOW-2291] Add optional params to ML Engine
+- [AIRFLOW-1774] Allow consistent templating of arguments in MLEngineBatchPredictionOperator
+- [AIRFLOW-2302] Add missing operators and hooks
+- [AIRFLOW-2312] Docs Typo Correction: Corresponding
+- [AIRFLOW-1623] Trigger on_kill method in operators
+- [AIRFLOW-2162] When impersonating another user, pass env variables to sudo
+- [AIRFLOW-2304] Update quickstart doc to mention scheduler part
+- [AIRFLOW-1633] docker_operator needs a way to set shm_size
+- [AIRFLOW-1340] Add S3 to Redshift transfer operator
+- [AIRFLOW-2303] Lists the keys inside an S3 bucket
+- [AIRFLOW-2209] restore flask_login imports
+- [AIRFLOW-2306] Add Bonnier Broadcasting to list of current users
+- [AIRFLOW-2305][AIRFLOW-2027] Fix CI failure caused by []
+- [AIRFLOW-2281] Add support for Sendgrid categories
+- [AIRFLOW-2027] Only trigger sleep in scheduler after all files have parsed
+- [AIRFLOW-2256] SparkOperator: Add Client Standalone mode and retry mechanism
+- [AIRFLOW-2284] GCS to S3 operator
+- [AIRFLOW-2287] Update license notices
+- [AIRFLOW-2296] Add Cinimex DataLab to Readme
+- [AIRFLOW-2298] Add Kalibrr to who uses airflow
+- [AIRFLOW-2292] Fix docstring for S3Hook.get_wildcard_key
+- [AIRFLOW-XXX] Update PR template
+- [AIRFLOW-XXX] Remove outdated migrations.sql
+- [AIRFLOW-2287] Add license header to docs/Makefile
+- [AIRFLOW-2286] Add tokopedia to the readme
+- [AIRFLOW-2273] Add Discord webhook operator/hook
+- [AIRFLOW-2282] Fix grammar in UPDATING.md
+- [AIRFLOW-2200] Add snowflake operator with tests
+- [AIRFLOW-2178] Add handling on SLA miss errors
+- [AIRFLOW-2169] Fix type 'bytes' is not JSON serializable in python3
+- [AIRFLOW-2215] Pass environment to subproces.Popen in base_task_runner
+- [AIRFLOW-2253] Add Airflow CLI instrumentation
+- [AIRFLOW-2274] Fix Dataflow tests
+- [AIRFLOW-2269] Add Custom Ink as an Airflow user
+- [AIRFLOW-2259] Dataflow Hook Index out of range
+- [AIRFLOW-2233] Update updating.md to include the info of hdfs_sensors renaming
+- [AIRFLOW-2217] Add Slack webhook operator
+- [AIRFLOW-1729] improve dagBag time
+- [AIRFLOW-2264] Improve create_user cli help message
+- [AIRFLOW-2260] [AIRFLOW-2260] SSHOperator add command template .sh files
+- [AIRFLOW-2261] Check config/env for remote base log folder
+- [AIRFLOW-2258] Allow import of Parquet-format files into BigQuery
+- [AIRFLOW-1430] Include INSTALL instructions to avoid GPL
+- [AIRFLOW-1430] Solve GPL dependency
+- [AIRFLOW-2251] Add Thinknear as an Airflow user
+- [AIRFLOW-2244] bugfix: remove legacy LongText code from models.py
+- [AIRFLOW-2247] Fix RedshiftToS3Transfer not to fail with ValueError
+- [AIRFLOW-2249] Add side-loading support for Zendesk Hook
+- [AIRFLOW-XXX] Add Qplum to Airflow users
+- [AIRFLOW-2228] Enhancements in ValueCheckOperator
+- [AIRFLOW-1206] Typos
+- [AIRFLOW-2060] Update pendulum version to 1.4.4
+- [AIRFLOW-2248] Fix wrong param name in RedshiftToS3Transfer doc
+- [AIRFLOW-1433][AIRFLOW-85] New Airflow Webserver UI with RBAC support
+- [AIRFLOW-1235] Fix webserver's odd behaviour
+- [AIRFLOW-1460] Allow restoration of REMOVED TI's
+- [airflow-2235] Fix wrong docstrings in two operators
+- [AIRFLOW-XXX] Fix chronological order for companies using Airflow
+- [AIRFLOW-2124] Upload Python file to a bucket for Dataproc
+- [AIRFLOW-2212] Fix ungenerated sensor API reference
+- [AIRFLOW-2226] Rename google_cloud_storage_default to google_cloud_default
+- [AIRFLOW-2211] Rename hdfs_sensors.py to hdfs_sensor.py for consistency
+- [AIRFLOW-2225] Update document to include DruidDbApiHook
+- [Airflow-2202] Add filter support in HiveMetastoreHook().max_partition()
+- [AIRFLOW-2220] Remove duplicate numeric list entry in security.rst
+- [AIRFLOW-XXX] Update tutorial documentation
+- [AIRFLOW-2215] Update celery task to preserve environment variables and improve logging on exception
+- [AIRFLOW-2185] Use state instead of query param
+- [AIRFLOW-2183] Refactor DruidHook to enable sql
+- [AIRFLOW-2203] Defer cycle detection
+- [AIRFLOW-2203] Remove Useless Commands.
+- [AIRFLOW-2203] Cache signature in apply_defaults
+- [AIRFLOW-2203] Speed up Operator Resources
+- [AIRFLOW-2203] Cache static rules (trigger/weight)
+- [AIRFLOW-2203] Store task ids as sets not lists
+- [AIRFLOW-2205] Remove unsupported args from JdbcHook doc
+- [AIRFLOW-2207] Fix flaky test that uses app.cached_app()
+- [AIRFLOW-2206] Remove unsupported args from JdbcOperator doc
+- [AIRFLOW-2140] Add Kubernetes scheduler to SparkSubmitOperator
+- [AIRFLOW-XXX] Add Xero to list of users
+- [AIRFLOW-2204] Fix webserver debug mode
+- [AIRFLOW-102] Fix test_complex_template always succeeds
+- [AIRFLOW-442] Add SFTPHook
+- [AIRFLOW-2169] Add schema to MySqlToGoogleCloudStorageOperator
+- [AIRFLOW-2184][AIRFLOW-2138] Google Cloud Storage allow wildcards
+- [AIRFLOW-1588] Cast Variable value to string
+- [AIRFLOW-2199] Fix invalid reference to logger
+- [AIRFLOW-2191] Change scheduler heartbeat logs from info to debug
+- [AIRFLOW-2106] SalesForce hook sandbox option
+- [AIRFLOW-2197] Silence hostname_callable config error message
+- [AIRFLOW-2150] Use lighter call in HiveMetastoreHook().max_partition()
+- [AIRFLOW-2186] Change the way logging is carried out in few ops
+- [AIRFLOW-2181] Convert password_auth and test_password_endpoints from DOS to UNIX
+- [AIRFLOW-2187] Fix Broken Travis CI due to AIRFLOW-2123
+- [AIRFLOW-2175] Check that filepath is not None
+- [AIRFLOW-2173] Don't check task IDs for concurrency reached check
+- [AIRFLOW-2168] Remote logging for Azure Blob Storage
+- [AIRFLOW-XXX] Add DocuTAP to list of users
+- [AIRFLOW-2176] Change the way logging is carried out in BQ Get Data Operator
+- [AIRFLOW-2177] Add mock test for GCS Download op
+- [AIRFLOW-2123] Install CI dependencies from setup.py
+- [AIRFLOW-2129] Presto hook calls _parse_exception_message but defines _get_pretty_exception_message
+- [AIRFLOW-2174] Fix typos and wrongly rendered documents
+- [AIRFLOW-2171] Store delegated credentials
+- [AIRFLOW-2166] Restore BQ run_query dialect param
+- [AIRFLOW-2163] Add HBC Digital to users of airflow
+- [AIRFLOW-2065] Fix race-conditions when creating loggers
+- [AIRFLOW-2147] Plugin manager: added 'sensors' attribute
+- [AIRFLOW-2059] taskinstance query is awful, un-indexed, and does not scale
+- [AIRFLOW-2159] Fix a few typos in salesforce_hook
+- [AIRFLOW-2132] Add step to initialize database
+- [AIRFLOW-2160] Fix bad rowid deserialization
+- [AIRFLOW-2161] Add Vevo to list of companies using Airflow
+- [AIRFLOW-2149] Add link to apache Beam documentation to create self executing Jar
+- [AIRFLOW-2151] Allow getting the session from AwsHook
+- [AIRFLOW-2097] tz referenced before assignment
+- [AIRFLOW-2152] Add Multiply to list of companies using Airflow
+- [AIRFLOW-1551] Add operator to trigger Jenkins job
+- [AIRFLOW-2034] Fix mixup between %s and {} when using str.format Convention is to use .format for string formating oustide logging, else use lazy format See comment in related issue https://github.com/apache/airflow/pull/2823/files Identified problematic case using following command line .git/COMMIT_EDITMSG:`grep -r '%s'./* | grep '\.format('`
+- [AIRFLOW-2102] Add custom_args to Sendgrid personalizations
+- [AIRFLOW-1035][AIRFLOW-1053] import unicode_literals to parse Unicode in HQL
+- [AIRFLOW-2127] Keep loggers during DB migrations
+- [AIRFLOW-2146] Resolve issues with BQ using DbApiHook methods
+- [AIRFLOW-2087] Scheduler Report shows incorrect Total task number
+- [AIRFLOW-2139] Remove unncecessary boilerplate to get DataFrame using pandas_gbq
+- [AIRFLOW-2125] Using binary package psycopg2-binary
+- [AIRFLOW-2142] Include message on mkdir failure
+- [AIRFLOW-1615] SSHHook: use port specified by Connection
+- [AIRFLOW-2122] Handle boolean values in sshHook
+- [AIRFLOW-XXX] Add Tile to the list of users
+- [AIRFLOW-2130] Add missing Operators to API Reference docs
+- [AIRFLOW-XXX] Add timeout units (seconds)
+- [AIRFLOW-2134] Add Alan to the list of companies that use Airflow
+- [AIRFLOW-2133] Remove references to GitHub issues in CONTRIBUTING
+- [AIRFLOW-2131] Remove confusing AirflowImport docs
+- [AIRFLOW-1852] Allow hostname to be overridable.
+- [AIRFLOW-2126] Add Bluecore to active users
+- [AIRFLOW-1618] Add feature to create GCS bucket
+- [AIRFLOW-2108] Fix log indentation in BashOperator
+- [AIRFLOW-2115] Fix doc links to PythonHosted
+- [AIRFLOW-XXX] Add contributor from Easy company
+- [AIRFLOW-1882] Add ignoreUnknownValues option to gcs_to_bq operator
+- [AIRFLOW-2089] Add on kill for SparkSubmit in Standalone Cluster
+- [AIRFLOW-2113] Address missing DagRun callbacks Given that the handle_callback method belongs to the DAG object, we are able to get the list of task directly with get_task and reduce the communication with the database, making airflow more lightweight.
+- [AIRFLOW-2112] Fix svg width for Recent Tasks on UI.
+- [AIRFLOW-2116] Set CI Cloudant version to <2.0
+- [AIRFLOW-XXX] Add PMC to list of companies using Airflow
+- [AIRFLOW-2100] Fix Broken Documentation Links
+- [AIRFLOW-1404] Add 'flatten_results' & 'maximum_bytes_billed' to BQ Operator
+- [AIRFLOW-800] Initialize valid Google BigQuery Connection
+- [AIRFLOW-1319] Fix misleading SparkSubmitOperator and SparkSubmitHook docstring
+- [AIRFLOW-1983] Parse environment parameter as template
+- [AIRFLOW-2095] Add operator to create External BigQuery Table
+- [AIRFLOW-2085] Add SparkJdbc operator
+- [AIRFLOW-1002] Add ability to clean all dependencies of removed DAG
+- [AIRFLOW-2094] Jinjafied project_id, region & zone in DataProc{*} Operators
+- [AIRFLOW-2092] Fixed incorrect parameter in docstring for FTPHook
+- [AIRFLOW-XXX] Add SocialCops to Airflow users
+- [AIRFLOW-2088] Fix duplicate keys in MySQL to GCS Helper function
+- [AIRFLOW-2091] Fix incorrect docstring parameter in BigQuery Hook
+- [AIRFLOW-2090] Fix typo in DataStore Hook
+- [AIRFLOW-1157] Fix missing pools crashing the scheduler
+- [AIRFLOW-713] Jinjafy {EmrCreateJobFlow,EmrAddSteps}Operator attributes
+- [AIRFLOW-2083] Docs: Use "its" instead of "it's" where appropriate
+- [AIRFLOW-2066] Add operator to create empty BQ table
+- [AIRFLOW-XXX] add Karmic to list of companies
+- [AIRFLOW-2073] Make FileSensor fail when the file doesn't exist
+- [AIRFLOW-2078] Improve task_stats and dag_stats performance
+- [AIRFLOW-2080] Use a log-out icon instead of a power button
+- [AIRFLOW-2077] Fetch all pages of list_objects_v2 response
+- [AIRFLOW-XXX] Add TM to list of companies
+- [AIRFLOW-1985] Impersonation fixes for using `run_as_user`
+- [AIRFLOW-2018][AIRFLOW-2] Make Sensors backward compatible
+- [AIRFLOW-XXX] Fix typo in concepts doc (dag_md)
+- [AIRFLOW-2069] Allow Bytes to be uploaded to S3
+- [AIRFLOW-2074] Fix log var name in GHE auth
+- [AIRFLOW-1927] Convert naive datetimes for TaskInstances
+- [AIRFLOW-1760] Password auth for experimental API
+- [AIRFLOW-2038] Add missing kubernetes dependency for dev
+- [AIRFLOW-2040] Escape special chars in task instance logs URL
+- [AIRFLOW-1968][AIRFLOW-1520] Add role_arn and aws_account_id/aws_iam_role support back to aws hook
+- [AIRFLOW-2048] Fix task instance failure string formatting
+- [AIRFLOW-2046] Fix kerberos error to work with python 3.x
+- [AIRFLOW-2063] Add missing docs for GCP
+- [AIRFLOW-XXX] Fix typo in docs
+- [AIRFLOW-1793] Use docker_url instead of invalid base_url
+- [AIRFLOW-2055] Elaborate on slightly ambiguous documentation
+- [AIRFLOW-2039] BigQueryOperator supports priority property
+- [AIRFLOW-2053] Fix quote character bug in BQ hook
+- [AIRFLOW-2057] Add Overstock to list of companies
+- [AIRFLOW-XXX] Add Plaid to Airflow users
+- [AIRFLOW-2044] Add SparkSubmitOperator to documentation
+- [AIRFLOW-2037] Add methods to get Hash values of a GCS object
+- [AIRFLOW-2050] Fix Travis permission problem
+- [AIRFLOW-2043] Add Intercom to list of companies
+- [AIRFLOW-2023] Add debug logging around number of queued files
+- [AIRFLOW-XXX] Add Pernod-ricard as a airflow user
+- [AIRFLOW-1453] Add 'steps' into template_fields in EmrAddSteps
+- [AIRFLOW-2015] Add flag for interactive runs
+- [AIRFLOW-1895] Fix primary key integrity for mysql
+- [AIRFLOW-2030] Fix KeyError:`i` in DbApiHook for insert
+- [AIRFLOW-1943] Add External BigQuery Table feature
+- [AIRFLOW-2033] Add Google Cloud Storage List Operator
+- [AIRFLOW-2006] Add local log catching to kubernetes operator
+- [AIRFLOW-2031] Add missing gcp_conn_id in the example in DataFlow docstrings
+- [AIRFLOW-2029] Fix AttributeError in BigQueryPandasConnector
+- [AIRFLOW-2028] Add JobTeaser to official users list
+- [AIRFLOW-2016] Add support for Dataproc Workflow Templates
+- [AIRFLOW-2025] Reduced Logging verbosity
+- [AIRFLOW-1267][AIRFLOW-1874] Add dialect parameter to BigQueryHook
+- [AIRFLOW-XXX] Fixed a typo
+- [AIRFLOW-XXX] Typo node to nodes
+- [AIRFLOW-2019] Update DataflowHook for updating Streaming type job
+- [AIRFLOW-2017][Airflow 2017] adding query output to PostgresOperator
+- [AIRFLOW-1889] Split sensors into separate files
+- [AIRFLOW-1950] Optionally pass xcom_pull task_ids
+- [AIRFLOW-1755] Allow mount below root
+- [AIRFLOW-511][Airflow 511] add success/failure callbacks on dag level
+- [AIRFLOW-192] Add weight_rule param to BaseOperator
+- [AIRFLOW-2008] Use callable for python column defaults
+- [AIRFLOW-1984] Fix to AWS Batch operator
+- [AIRFLOW-2000] Support non-main dataflow job class
+- [AIRFLOW-2003] Use flask-caching instead of flask-cache
+- [AIRFLOW-2002] Do not swallow exception on logging import
+- [AIRFLOW-2004] Import flash from flask not flask.login
+- [AIRFLOW-1997] Fix GCP operator doc strings
+- [AIRFLOW-1996] Update DataflowHook waitfordone for Streaming type job[]
+- [AIRFLOW-1995][Airflow 1995] add on_kill method to SqoopOperator
+- [AIRFLOW-1770] Allow HiveOperator to take in a file
+- [AIRFLOW-1994] Change background color of Scheduled state Task Instances
+- [AIRFLOW-1436][AIRFLOW-1475] EmrJobFlowSensor considers Cancelled step as Successful
+- [AIRFLOW-1517] Kubernetes operator PR fixes
+- [AIRFLOW-1517] addressed PR comments
+- [AIRFLOW-1517] started documentation of k8s operator
+- [AIRFLOW-1517] Restore authorship of resources
+- [AIRFLOW-1517] Remove authorship of resources
+- [AIRFLOW-1517] Add minikube for kubernetes integration tests
+- [AIRFLOW-1517] Restore authorship of resources
+- [AIRFLOW-1517] fixed license issues
+- [AIRFLOW-1517] Created more accurate failures for kube cluster issues
+- [AIRFLOW-1517] Remove authorship of resources
+- [AIRFLOW-1517] Add minikube for kubernetes integration tests
+- [AIRFLOW-1988] Change BG color of None state TIs
+- [AIRFLOW-790] Clean up TaskInstances without DagRuns
+- [AIRFLOW-1949] Fix var upload, str() produces "b'...'" which is not json
+- [AIRFLOW-1930] Convert func.now() to timezone.utcnow()
+- [AIRFLOW-1688] Support load.time_partitioning in bigquery_hook
+- [AIRFLOW-1975] Make TriggerDagRunOperator callback optional
+- [AIRFLOW-1480] Render template attributes for ExternalTaskSensor fields
+- [AIRFLOW-1958] Add **kwargs to send_email
+- [AIRFLOW-1976] Fix for missing log/logger attribute FileProcessHandler
+- [AIRFLOW-1982] Fix Executor event log formatting
+- [AIRFLOW-1971] Propagate hive config on impersonation
+- [AIRFLOW-1969] Always use HTTPS URIs for Google OAuth2
+- [AIRFLOW-1954] Add DataFlowTemplateOperator
+- [AIRFLOW-1963] Add config for HiveOperator mapred_queue
+- [AIRFLOW-1946][AIRFLOW-1855] Create a BigQuery Get Data Operator
+- [AIRFLOW-1953] Add labels to dataflow operators
+- [AIRFLOW-1967] Update Celery to 4.0.2
+- [AIRFLOW-1964] Add Upsight to list of Airflow users
+- [AIRFLOW-XXX] Changelog for 1.9.0
+- [AIRFLOW-1470] Implement BashSensor operator
+- [AIRFLOW-XXX] Pin sqlalchemy dependency
+- [AIRFLOW-1955] Do not reference unassigned variable
+- [AIRFLOW-1957] Add contributor to BalanceHero in Readme
+- [AIRFLOW-1517] Restore authorship of secrets and init container
+- [AIRFLOW-1517] Remove authorship of secrets and init container
+- [AIRFLOW-1935] Add BalanceHero to readme
+- [AIRFLOW-1939] add astronomer contributors
+- [AIRFLOW-1517] Kubernetes Operator
+- [AIRFLOW-1928] Fix @once with catchup=False
+- [AIRFLOW-1937] Speed up scheduling by committing in batch
+- [AIRFLOW-1821] Enhance default logging config by removing extra loggers
+- [AIRFLOW-1904] Correct DAG fileloc to the right filepath
+- [AIRFLOW-1909] Update docs with supported versions of MySQL server
+- [AIRFLOW-1915] Relax flask-wtf dependency specification
+- [AIRFLOW-1920] Update CONTRIBUTING.md to reflect enforced linting rules
+- [AIRFLOW-1942] Update Sphinx docs to remove deprecated import structure
+- [AIRFLOW-1846][AIRFLOW-1697] Hide Ad Hoc Query behind secure_mode config
+- [AIRFLOW-1948] Include details for on_kill failure
+- [AIRFLOW-1938] Clean up unused exception
+- [AIRFLOW-1932] Add GCP Pub/Sub Pull and Ack
+- [AIRFLOW-XXX] Purge coveralls
+- [AIRFLOW-XXX] Remove unused coveralls token
+- [AIRFLOW-1938] Remove tag version check in setup.py
+- [AIRFLOW-1916] Don't upload logs to remote from `run --raw`
+- [AIRFLOW-XXX] Fix failing PubSub tests on Python3
+- [AIRFLOW-XXX] Upgrade to python 3.5 and disable dask tests
+- [AIRFLOW-1913] Add new GCP PubSub operators
+- [AIRFLOW-1525] Fix minor LICENSE and NOTICE issues
+- [AIRFLOW-1687] fix fernet error without encryption
+- [AIRFLOW-1912] airflow.processor should not propagate logging
+- [AIRFLOW-1911] Rename celeryd_concurrency
+- [AIRFLOW-1885] Fix IndexError in ready_prefix_on_cmdline
+- [AIRFLOW-1854] Improve Spark Submit operator for standalone cluster mode
+- [AIRFLOW-1908] Fix celery broker options config load
+- [AIRFLOW-1907] Pass max_ingestion_time to Druid hook
+- [AIRFLOW-1909] Add away to list of users
+- [AIRFLOW-1893][AIRFLOW-1901] Propagate PYTHONPATH when using impersonation
+- [AIRFLOW-1892] Modify BQ hook to extract data filtered by column
+- [AIRFLOW-1829] Support for schema updates in query jobs
+- [AIRFLOW-1840] Make celery configuration congruent with Celery 4
+- [AIRFLOW-1878] Fix stderr/stdout redirection for tasks
+- [AIRFLOW-1897][AIRFLOW-1873] Task Logs for running instance not visible in WebUI
+- [AIRFLOW-1896] FIX bleach <> html5lib incompatibility
+- [AIRFLOW-1884][AIRFLOW-1059] Reset orphaned task state for external dagruns
+- [AIRFLOW-XXX] Fix typo in comment
+- [AIRFLOW-1869] Do not emit spurious warning on missing logs
+- [AIRFLOW-1888] Add AWS Redshift Cluster Sensor
+- [AIRFLOW-1887] Renamed endpoint url variable
+- [AIRFLOW-1873] Set TI.try_number to right value depending TI state
+- [AIRFLOW-1891] Fix non-ascii typo in default configuration template
+- [AIRFLOW-1879] Handle ti log entirely within ti
+- [AIRFLOW-1869] Write more error messages into gcs and file logs
+- [AIRFLOW-1876] Write subtask id to task log header
+- [AIRFLOW-1554] Fix wrong DagFileProcessor termination method call
+- [AIRFLOW-342] Do not use amqp, rpc as result backend
+- [AIRFLOW-966] Make celery broker_transport_options configurable
+- [AIRFLOW-1881] Make operator log in task log
+- [AIRFLOW-XXX] Added DataReply to the list of Airflow Users
+- [AIRFLOW-1883] Get File Size for objects in Google Cloud Storage
+- [AIRFLOW-1872] Set context for all handlers including parents
+- [AIRFLOW-1855][AIRFLOW-1866] Add GCS Copy Operator to copy multiple files
+- [AIRFLOW-1870] Enable flake8 tests
+- [AIRFLOW-1785] Enable Python 3 tests
+- [AIRFLOW-1850] Copy cmd before masking
+- [AIRFLOW-1665] Reconnect on database errors
+- [AIRFLOW-1559] Dispose SQLAlchemy engines on exit
+- [AIRFLOW-1559] Close file handles in subprocesses
+- [AIRFLOW-1559] Make database pooling optional
+- [AIRFLOW-1848][Airflow-1848] Fix DataFlowPythonOperator py_file extension doc comment
+- [AIRFLOW-1843] Add Google Cloud Storage Sensor with prefix
+- [AIRFLOW-1803] Time zone documentation
+- [AIRFLOW-1826] Update views to use timezone aware objects
+- [AIRFLOW-1827] Fix api endpoint date parsing
+- [AIRFLOW-1806] Use naive datetime when using cron
+- [AIRFLOW-1809] Update tests to use timezone aware objects
+- [AIRFLOW-1806] Use naive datetime for cron scheduling
+- [AIRFLOW-1807] Force use of time zone aware db fields
+- [AIRFLOW-1808] Convert all utcnow() to time zone aware
+- [AIRFLOW-1804] Add time zone configuration options
+- [AIRFLOW-1802] Convert database fields to timezone aware
+- [AIRFLOW-XXX] Add dask lock files to excludes
+- [AIRFLOW-1790] Add support for AWS Batch operator
+- [AIRFLOW-XXX] Update README.md
+- [AIRFLOW-1820] Remove timestamp from metric name
+- [AIRFLOW-1810] Remove unused mysql import in migrations.
+- [AIRFLOW-1838] Properly log collect_dags exception
+- [AIRFLOW-1842] Fixed Super class name for the gcs to gcs copy operator
+- [AIRFLOW-1845] Modal background now covers long or tall pages
+- [AIRFLOW-1229] Add link to Run Id, incl execution_date
+- [AIRFLOW-1842] Add gcs to gcs copy operator with renaming if required
+- [AIRFLOW-1841] change False to None in operator and hook
+- [AIRFLOW-1839] Fix more bugs in S3Hook boto -> boto3 migration
+- [AIRFLOW-1830] Support multiple domains in Google authentication backend
+- [AIRFLOW-1831] Add driver-classpath spark submit
+- [AIRFLOW-1795] Correctly call S3Hook after migration to boto3
+- [AIRFLOW-1811] Fix render Druid operator
+- [AIRFLOW-1819] Fix slack operator unittest bug
+- [AIRFLOW-1805] Allow Slack token to be passed through connection
+- [AIRFLOW-1816] Add region param to Dataproc operators
+- [AIRFLOW-868] Add postgres_to_gcs operator and unittests
+- [AIRFLOW-1613] make mysql_to_gcs_operator py3 compatible
+- [AIRFLOW-1817] use boto3 for s3 dependency
+- [AIRFLOW-1813] Bug SSH Operator empty buffer
+- [AIRFLOW-1801][AIRFLOW-288] Url encode execution dates
+- [AIRFLOW-1563] Catch OSError while symlinking the latest log directory
+- [AIRFLOW-1794] Remove uses of Exception.message for Python 3
+- [AIRFLOW-1799] Fix logging line which raises errors
+- [AIRFLOW-1102] Upgrade Gunicorn >=19.4.0
+- [AIRFLOW-1756] Fix S3TaskHandler to work with Boto3-based S3Hook
+- [AIRFLOW-1797] S3Hook.load_string didn't work on Python3
+- [AIRFLOW-646] Add docutils to setup_requires
+- [AIRFLOW-1792] Missing intervals DruidOperator
+- [AIRFLOW-1789][AIRFLOW-1712] Log SSHOperator stderr to log.warning
+- [AIRFLOW-1787] Fix task instance batch clear and set state bugs
+- [AIRFLOW-1780] Fix long output lines with unicode from hanging parent
+- [AIRFLOW-387] Close SQLAlchemy sessions properly
+- [AIRFLOW-1779] Add keepalive packets to ssh hook
+- [AIRFLOW-1669] Fix Docker and pin Moto to 1.1.19
+- [AIRFLOW-71] Add support for private Docker images
+- [AIRFLOW-XXX] Give a clue what the 'ds' variable is
+- [AIRFLOW-XXX] Correct typos in the faq docs page
+- [AIRFLOW-1571] Add AWS Lambda Hook
+- [AIRFLOW-1675] Fix docstrings for API docs
+- [AIRFLOW-1712][AIRFLOW-756][AIRFLOW-751] Log SSHOperator output
+- [AIRFLOW-1776] Capture stdout and stderr for logging
+- [AIRFLOW-1765] Make experimental API securable without needing Kerberos.
+- [AIRFLOW-1764] The web interface should not use the experimental API
+- [AIRFLOW-1771] Rename heartbeat to avoid confusion
+- [AIRFLOW-1769] Add support for templates in VirtualenvOperator
+- [AIRFLOW-1763] Fix S3TaskHandler unit tests
+- [AIRFLOW-1315] Add Qubole File & Partition Sensors
+- [AIRFLOW-1018] Make processor use logging framework
+- [AIRFLOW-1695] Add RedshiftHook using boto3
+- [AIRFLOW-1706] Fix query error for MSSQL backend
+- [AIRFLOW-1711] Use ldap3 dict for group membership
+- [AIRFLOW-1723] Make sendgrid a plugin
+- [AIRFLOW-1757] Add missing options to SparkSubmitOperator
+- [AIRFLOW-1734][Airflow 1734] Sqoop hook/operator enhancements
+- [AIRFLOW-1761] Fix type in scheduler.rst
+- [AIRFLOW-1731] Set pythonpath for logging
+- [AIRFLOW-1641] Handle executor events in the scheduler
+- [AIRFLOW-1744] Make sure max_tries can be set
+- [AIRFLOW-1732] Improve dataflow hook logging
+- [AIRFLOW-1736] Add HotelQuickly to Who Uses Airflow
+- [AIRFLOW-1657] Handle failing qubole operator
+- [AIRFLOW-1677] Fix typo in example_qubole_operator
+- [AIRFLOW-926] Fix JDBC Hook
+- [AIRFLOW-1520] Boto3 S3Hook, S3Log
+- [AIRFLOW-1716] Fix multiple __init__ def in SimpleDag
+- [AIRFLOW-XXX] Fix DateTime in Tree View
+- [AIRFLOW-1719] Fix small typo
+- [AIRFLOW-1432] Charts label for Y axis not visible
+- [AIRFLOW-1743] Verify ldap filters correctly
+- [AIRFLOW-1745] Restore default signal disposition
+- [AIRFLOW-1741] Correctly hide second chart on task duration page
+- [AIRFLOW-1728] Add networkUri, subnet, tags to Dataproc operator
+- [AIRFLOW-1726] Add copy_expert psycopg2 method to PostgresHook
+- [AIRFLOW-1330] Add conn_type argument to CLI when adding connection
+- [AIRFLOW-1698] Remove SCHEDULER_RUNS env var in systemd
+- [AIRFLOW-1694] Stop using itertools.izip
+- [AIRFLOW-1692] Change test_views filename to support Windows
+- [AIRFLOW-1722] Fix typo in scheduler autorestart output filename
+- [AIRFLOW-1723] Support sendgrid in email backend
+- [AIRFLOW-1718] Set num_retries on Dataproc job request execution
+- [AIRFLOW-1727] Add unit tests for DataProcHook
+- [AIRFLOW-1631] Fix timing issue in unit test
+- [AIRFLOW-1631] Fix local executor unbound parallelism
+- [AIRFLOW-1724] Add Fundera to Who uses Airflow?
+- [AIRFLOW-1683] Cancel BigQuery job on timeout.
+- [AIRFLOW-1714] Fix misspelling: s/seperate/separate/
+- [AIRFLOW-1681] Add batch clear in task instance view
+- [AIRFLOW-1696] Fix dataproc version label error
+- [AIRFLOW-1613] Handle binary field in MySqlToGoogleCloudStorageOperator
+- [AIRFLOW-1697] Mode to disable charts endpoint
+- [AIRFLOW-1691] Add better Google cloud logging documentation
+- [AIRFLOW-1690] Add detail to gcs error messages
+- [AIRFLOW-1682] Make S3TaskHandler write to S3 on close
+- [AIRFLOW-1634] Adds task_concurrency feature
+- [AIRFLOW-1676] Make GCSTaskHandler write to GCS on close
+- [AIRFLOW-1678] Fix erroneously repeated word in function docstrings
+- [AIRFLOW-1323] Made Dataproc operator parameter names consistent
+- [AIRFLOW-1590] fix unused module and variable
+- [AIRFLOW-1671] Add @apply_defaults back to gcs download operator
+- [AIRFLOW-988] Fix repeating SLA miss callbacks
+- [AIRFLOW-1611] Customize logging
+- [AIRFLOW-1668] Expose keepalives_idle for Postgres connections
+- [AIRFLOW-1658] Kill Druid task on timeout
+- [AIRFLOW-1669][AIRFLOW-1368] Fix Docker import
+- [AIRFLOW-891] Make webserver clock include date
+- [AIRFLOW-1560] Add AWS DynamoDB hook and operator for inserting batch items
+- [AIRFLOW-1654] Show tooltips for link icons in DAGs view
+- [AIRFLOW-1660] Change webpage width to full-width
+- [AIRFLOW-1664] write file as binary instead of str
+- [AIRFLOW-1659] Fix invalid obj attribute bug in file_task_handler.py
+- [AIRFLOW-1635] Allow creating GCP connection without requiring a JSON file
+- [AIRFLOW-1650] Fix custom celery config loading
+- [AIRFLOW-1647] Fix Spark-sql hook
+- [AIRFLOW-1587] Fix CeleryExecutor import error
+- [Airflow-1640][AIRFLOW-1640] Add qubole default connection
+- [AIRFLOW-1576] Added region param to Dataproc{*}Operators
+- [AIRFLOW-1643] Add healthjump to officially using list
+- [AIRFLOW-1626] Add Azri Solutions to Airflow users
+- [AIRFLOW-1636] Add AWS and EMR connection type
+- [AIRFLOW-1527] Refactor celery config
+- [AIRFLOW-1639] Fix Fernet error handling
+- [AIRFLOW-1637] Fix Travis CI build status link
+- [AIRFLOW-1628] Fix docstring of sqlsensor
+- [AIRFLOW-1331] add SparkSubmitOperator option
+- [AIRFLOW-1627] Only query pool in SubDAG init when necessary
+- [AIRFLOW-1629] Make extra a textarea in edit connections form
+- [AIRFLOW-1368] Automatically remove Docker container on exit
+- [AIRFLOW-289] Make airflow timezone independent
+- [AIRFLOW-1356] Add `--celery_hostname` to `airflow worker`
+- [AIRFLOW-1247] Fix ignore_all_dependencies argument ignored
+- [AIRFLOW-1621] Add tests for server side paging
+- [AIRFLOW-1591] Avoid attribute error when rendering logging filename
+- [AIRFLOW-1031] Replace hard-code to DagRun.ID_PREFIX
+- [AIRFLOW-1604] Rename logger to log
+- [AIRFLOW-1512] Add PythonVirtualenvOperator
+- [AIRFLOW-1617] Fix XSS vulnerability in Variable endpoint
+- [AIRFLOW-1497] Reset hidden fields when changing connection type
+- [AIRFLOW-1619] Add poll_sleep parameter to GCP dataflow operator
+- [AIRFLOW-XXX] Remove landscape.io config
+- [AIRFLOW-XXX] Remove non working service badges
+- [AIRFLOW-1177] Fix Variable.setdefault w/existing JSON
+- [AIRFLOW-1600] Fix exception handling in get_fernet
+- [AIRFLOW-1614] Replace inspect.stack() with sys._getframe()
+- [AIRFLOW-1519] Add server side paging in DAGs list
+- [AIRFLOW-1309] Allow hive_to_druid to take tblproperties
+- [AIRFLOW-1613] Make MySqlToGoogleCloudStorageOperator compaitible with python3
+- [AIRFLOW-1603] add PAYMILL to companies list
+- [AIRFLOW-1609] Fix gitignore to ignore all venvs
+- [AIRFLOW-1601] Add configurable task cleanup time
 
-AIRFLOW 1.9.0, 2018-01-02
+Airflow 1.9.0, 2018-01-02
 -------------------------
 
-[AIRFLOW-1525] Fix minor LICENSE and NOTICE issues
-[AIRFLOW-XXX] Bump version to 1.9.0
-[AIRFLOW-1897][AIRFLOW-1873] Task Logs for running instance not visible in WebUI
-[AIRFLOW-XXX] Make sure session is committed
-[AIRFLOW-1896] FIX bleach <> html5lib incompatibility
-[AIRFLOW-XXX] Fix log handler test
-[AIRFLOW-1873] Set TI.try_number to right value depending TI state
-[AIRFLOW-1554] Fix wrong DagFileProcessor termination method call
-[AIRFLOW-1872] Set context for all handlers including parents
-[AIRFLOW-XXX] Add dask lock files to excludes
-[AIRFLOW-1839] Fix more bugs in S3Hook boto -> boto3 migration
-[AIRFLOW-1795] Correctly call S3Hook after migration to boto3
-[AIRFLOW-1813] Bug SSH Operator empty buffer
-[AIRFLOW-1794] Remove uses of Exception.message for Python 3
-[AIRFLOW-1799] Fix logging line which raises errors
-[AIRFLOW-1102] Upgrade Gunicorn >=19.4.0
-[AIRFLOW-1756] Fix S3TaskHandler to work with Boto3-based S3Hook
-[AIRFLOW-1797] S3Hook.load_string didn't work on Python3
-[AIRFLOW-1792] Missing intervals DruidOperator
-[AIRFLOW-1789][AIRFLOW-1712] Log SSHOperator stderr to log.warning
-[AIRFLOW-1669] Fix Docker and pin Moto to 1.1.19
-[AIRFLOW-71] Add support for private Docker images
-[AIRFLOW-1779] Add keepalive packets to ssh hook
-[AIRFLOW-XXX] Give a clue what the 'ds' variable is
-[AIRFLOW-XXX] Correct typos in the faq docs page
-[AIRFLOW-1571] Add AWS Lambda Hook
-[AIRFLOW-1675] Fix docstrings for API docs
-[AIRFLOW-1712][AIRFLOW-756][AIRFLOW-751] Log SSHOperator output
-[AIRFLOW-1776] Capture stdout and stderr for logging
-[AIRFLOW-1765] Make experimental API securable without needing Kerberos.
-[AIRFLOW-1764] The web interface should not use the experimental API
-[AIRFLOW-1634] Adds task_concurrency feature
-[AIRFLOW-1018] Make processor use logging framework
-[AIRFLOW-1695] Add RedshiftHook using boto3
-[AIRFLOW-1706] Fix query error for MSSQL backend
-[AIRFLOW-1711] Use ldap3 dict for group membership
-[AIRFLOW-1757] Add missing options to SparkSubmitOperator
-[AIRFLOW-1734][Airflow 1734] Sqoop hook/operator enhancements
-[AIRFLOW-1731] Set pythonpath for logging
-[AIRFLOW-1641] Handle executor events in the scheduler
-[AIRFLOW-1744] Make sure max_tries can be set
-[AIRFLOW-1330] Add conn_type argument to CLI when adding connection
-[AIRFLOW-926] Fix JDBC Hook
-[AIRFLOW-1520] Boto3 S3Hook, S3Log
-[AIRFLOW-XXX] Fix DateTime in Tree View
-[AIRFLOW-1432] Charts label for Y axis not visible
-[AIRFLOW-1743] Verify ldap filters correctly
-[AIRFLOW-1745] Restore default signal disposition
-[AIRFLOW-1741] Correctly hide second chart on task duration page
-[AIRFLOW-1726] Add copy_expert psycopg2 method to PostgresHook
-[AIRFLOW-1698] Remove SCHEDULER_RUNS env var in systemd
-[AIRFLOW-1694] Stop using itertools.izip
-[AIRFLOW-1692] Change test_views filename to support Windows
-[AIRFLOW-1722] Fix typo in scheduler autorestart output filename
-[AIRFLOW-1691] Add better Google cloud logging documentation
-[AIRFLOW-1690] Add detail to gcs error messages
-[AIRFLOW-1682] Make S3TaskHandler write to S3 on close
-[AIRFLOW-1676] Make GCSTaskHandler write to GCS on close
-[AIRFLOW-1635] Allow creating GCP connection without requiring a JSON file
-[AIRFLOW-1323] Made Dataproc operator parameter names consistent
-[AIRFLOW-1590] fix unused module and variable
-[AIRFLOW-988] Fix repeating SLA miss callbacks
-[AIRFLOW-1611] Customize logging
-[AIRFLOW-1668] Expose keepalives_idle for Postgres connections
-[AIRFLOW-1658] Kill Druid task on timeout
-[AIRFLOW-1669][AIRFLOW-1368] Fix Docker import
-[AIRFLOW-1560] Add AWS DynamoDB hook and operator for inserting batch items
-[AIRFLOW-1654] Show tooltips for link icons in DAGs view
-[AIRFLOW-1660] Change webpage width to full-width
-[AIRFLOW-1664] write file as binary instead of str
-[AIRFLOW-1659] Fix invalid obj attribute bug in file_task_handler.py
-[AIRFLOW-1650] Fix custom celery config loading
-[AIRFLOW-1647] Fix Spark-sql hook
-[AIRFLOW-1587] Fix CeleryExecutor import error
-[AIRFLOW-1636] Add AWS and EMR connection type
-[AIRFLOW-1527] Refactor celery config
-[AIRFLOW-1639] Fix Fernet error handling
-[AIRFLOW-1628] Fix docstring of sqlsensor
-[AIRFLOW-1331] add SparkSubmitOperator option
-[AIRFLOW-1627] Only query pool in SubDAG init when necessary
-[AIRFLOW-1629] Make extra a textarea in edit connections form
-[AIRFLOW-1621] Add tests for server side paging
-[AIRFLOW-1519] Add server side paging in DAGs list
-[AIRFLOW-289] Make airflow timezone independent
-[AIRFLOW-1356] Add `--celery_hostname` to `airflow worker`
-[AIRFLOW-1591] Avoid attribute error when rendering logging filename
-[AIRFLOW-1031] Replace hard-code to DagRun.ID_PREFIX
-[AIRFLOW-1604] Rename logger to log
-[AIRFLOW-1512] Add PythonVirtualenvOperator
-[AIRFLOW-1617] Fix XSS vulnerability in Variable endpoint
-[AIRFLOW-1497] Reset hidden fields when changing connection type
-[AIRFLOW-1177] Fix Variable.setdefault w/existing JSON
-[AIRFLOW-1600] Fix exception handling in get_fernet
-[AIRFLOW-1614] Replace inspect.stack() with sys._getframe()
-[AIRFLOW-1613] Make MySqlToGoogleCloudStorageOperator compaitible with python3
-[AIRFLOW-1609] Fix gitignore to ignore all venvs
-[AIRFLOW-1601] Add configurable task cleanup time
-[AIRFLOW-XXX] Bumping Airflow 1.9.0alpha0 version
-[AIRFLOW-1608] Handle pending job state in GCP Dataflow hook
-[AIRFLOW-1606] Use non static DAG.sync_to_db
-[AIRFLOW-1606][Airflow-1606][AIRFLOW-1605][AIRFLOW-160] DAG.sync_to_db is now a normal method
-[AIRFLOW-1602] LoggingMixin in DAG class
-[AIRFLOW-1593] expose load_string in WasbHook
-[AIRFLOW-1597] Add GameWisp as Airflow user
-[AIRFLOW-1594] Don't install test packages into python root.[]
-[AIRFLOW-1582] Improve logging within Airflow
-[AIRFLOW-1476] add INSTALL instruction for source releases
-[AIRFLOW-XXX] Save username and password in airflow-pr
-[AIRFLOW-1522] Increase text size for var field in variables for MySQL
-[AIRFLOW-950] Missing AWS integrations on documentation::integrations
-[AIRFLOW-XXX] 1.8.2 release notes
-[AIRFLOW-1573] Remove `thrift < 0.10.0` requirement
-[AIRFLOW-1584] Remove insecure /headers endpoint
-[AIRFLOW-1586] Add mapping for date type to mysql_to_gcs operator
-[AIRFLOW-1579] Adds support for jagged rows in Bigquery hook for BQ load jobs
-[AIRFLOW-1577] Add token support to DatabricksHook
-[AIRFLOW-1580] Error in string formating
-[AIRFLOW-1567] Updated docs for Google ML Engine operators/hooks
-[AIRFLOW-1574] add 'to' attribute to templated vars of email operator
-[AIRFLOW-1572] add carbonite to company list
-[AIRFLOW-1568] Fix typo in BigQueryHook
-[AIRFLOW-1493][AIRFLOW-XXXX][WIP] fixed dumb thing
-[AIRFLOW-1567][Airflow-1567] Renamed cloudml hook and operator to mlengine
-[AIRFLOW-1568] Add datastore export/import operators
-[AIRFLOW-1564] Use Jinja2 to render logging filename
-[AIRFLOW-1562] Spark-sql logging contains deadlock
-[AIRFLOW-1556][Airflow 1556] Add support for SQL parameters in BigQueryBaseCursor
-[AIRFLOW-108] Add CreditCards.com to companies list
-[AIRFLOW-1541] Add channel to template fields of slack_operator
-[AIRFLOW-1535] Add service account/scopes in dataproc
-[AIRFLOW-1384] Add to README.md CaDC/ARGO
-[AIRFLOW-1546] add Zymergen 80to org list in README
-[AIRFLOW-1545] Add Nextdoor to companies list
-[AIRFLOW-1544] Add DataFox to companies list
-[AIRFLOW-1529] Add logic supporting quoted newlines in Google BigQuery load jobs
-[AIRFLOW-1521] Fix emplate rendering for BigqueryTableDeleteOperator
-[AIRFLOW-1324] Generalize Druid operator and hook
-[AIRFLOW-1516] Fix error handling getting fernet
-[AIRFLOW-1420][AIRFLOW-1473] Fix deadlock check
-[AIRFLOW-1495] Fix migration on index on job_id
-[AIRFLOW-1483] Making page size consistent in list
-[AIRFLOW-1495] Add TaskInstance index on job_id
-[AIRFLOW-855] Replace PickleType with LargeBinary in XCom
-[AIRFLOW-1505] Document when Jinja substitution occurs
-[AIRFLOW-1504] Log dataproc cluster name
-[AIRFLOW-1239] Fix unicode error for logs in base_task_runner
-[AIRFLOW-1280] Fix Gantt chart height
-[AIRFLOW-1507] Template parameters in file_to_gcs operator
-[AIRFLOW-1452] workaround lock on method
-[AIRFLOW-1385] Make Airflow task logging configurable
-[AIRFLOW-940] Handle error on variable decrypt
-[AIRFLOW-1492] Add gauge for task successes/failures
-[AIRFLOW-1443] Update Airflow configuration documentation
-[AIRFLOW-1486] Unexpected S3 writing log error
-[AIRFLOW-1487] Added links to all companies officially using Airflow
-[AIRFLOW-1489] Fix typo in BigQueryCheckOperator
-[AIRFLOW-1349] Fix backfill to respect limits
-[AIRFLOW-1478] Chart owner column should be sortable
-[AIRFLOW-1397][AIRFLOW-1] No Last Run column data displyed in Airflow UI 1.8.1
-[AIRFLOW-1474] Add dag_id regex feature for `airflow clear` command
-[AIRFLOW-1445] Changing HivePartitionSensor UI color to lighter shade
-[AIRFLOW-1359] Use default_args in Cloud ML eval
-[AIRFLOW-1389] Support createDisposition in BigQueryOperator
-[AIRFLOW-1349] Refactor BackfillJob _execute
-[AIRFLOW-1459] Fixed broken integration .rst formatting
-[AIRFLOW-1448] Revert "Fix cli reading logfile in memory"
-[AIRFLOW-1398] Allow ExternalTaskSensor to wait on multiple runs of a task
-[AIRFLOW-1399] Fix cli reading logfile in memory
-[AIRFLOW-1442] Remove extra space from ignore_all_deps generated command
-[AIRFLOW-1438] Change batch size per query in scheduler
-[AIRFLOW-1439] Add max billing tier for the BQ Hook and Operator
-[AIRFLOW-1437] Modify BigQueryTableDeleteOperator
-[Airflow 1332] Split logs based on try number
-[AIRFLOW-1385] Create abstraction for Airflow task logging
-[AIRFLOW-756][AIRFLOW-751] Replace ssh hook, operator & sftp operator with paramiko based
-[AIRFLOW-1393][[AIRFLOW-1393] Enable Py3 tests in contrib/spark_submit_hook[
-[AIRFLOW-1345] Dont expire TIs on each scheduler loop
-[AIRFLOW-1059] Reset orphaned tasks in batch for scheduler
-[AIRFLOW-1255] Fix SparkSubmitHook output deadlock
-[AIRFLOW-1359] Add Google CloudML utils for model evaluation
-[AIRFLOW-1247] Fix ignore all dependencies argument ignored
-[AIRFLOW-1401] Standardize cloud ml operator arguments
-[AIRFLOW-1394] Add quote_character param to GCS hook and operator
-[AIRFLOW-1402] Cleanup SafeConfigParser DeprecationWarning
-[AIRFLOW-1326][[AIRFLOW-1326][AIRFLOW-1184] Don't split argument array -- it's already an array.[
-[AIRFLOW-1384] Add ARGO/CaDC as a Airflow user
-[AIRFLOW-1357] Fix scheduler zip file support
-[AIRFLOW-1382] Add working dir option to DockerOperator
-[AIRFLOW-1388] Add Cloud ML Engine operators to integration doc
-[AIRFLOW-1387] Add unicode string prefix
-[AIRFLOW-1366] Add max_tries to task instance
-[AIRFLOW-1300] Enable table creation with TBLPROPERTIES
-[AIRFLOW-1271] Add Google CloudML Training Operator
-[AIRFLOW-300] Add Google Pubsub hook and operator
-[AIRFLOW-1343] Fix dataproc label format
-[AIRFLOW-1367] Pass Content-ID To reference inline images in an email, we need to be able to add <img src="cid:{}"/> to the HTML. However currently the Content-ID (cid) is not passed, so we need to add it
-[AIRFLOW-1265] Fix celery executor parsing CELERY_SSL_ACTIVE
-[AIRFLOW-1272] Google Cloud ML Batch Prediction Operator
-[AIRFLOW-1352][AIRFLOW-1335] Revert MemoryHandler change ()[]
-[AIRFLOW-1350] Add query_uri param to Hive/SparkSQL DataProc operator
-[AIRFLOW-1334] Check if tasks are backfill on scheduler in a join
-[AIRFLOW-1343] Add Airflow default label to the dataproc operator
-[AIRFLOW-1273] Add Google Cloud ML version and model operators
-[AIRFLOW-1273]AIRFLOW-1273] Add Google Cloud ML version and model operators
-[AIRFLOW-1321] Fix hidden field key to ignore case
-[AIRFLOW-1337] Make log_format key names lowercase
-[AIRFLOW-1338][AIRFLOW-782] Add GCP dataflow hook runner change to UPDATING.md
-[AIRFLOW-801] Remove outdated docstring on BaseOperator
-[AIRFLOW-1344] Fix text encoding bug when reading logs for Python 3.5
-[AIRFLOW-1338] Fix incompatible GCP dataflow hook
-[AIRFLOW-1333] Enable copy function for Google Cloud Storage Hook
-[AIRFLOW-1337] Allow log format customization via airflow.cfg
-[AIRFLOW-1320] Update LetsBonus users in README
-[AIRFLOW-1335] Use MemoryHandler for buffered logging
-[AIRFLOW-1339] Add Drivy to the list of users
-[AIRFLOW-1275] Put 'airflow pool' into API
-[AIRFLOW-1296] Propagate SKIPPED to all downstream tasks
-[AIRFLOW-1317] Fix minor issues in API reference
-[AIRFLOW-1308] Disable nanny usage for Dask
-[AIRFLOW-1172] Support nth weekday of the month cron expression
-[AIRFLOW-936] Add clear/mark success for DAG in the UI
-[AIRFLOW-1294] Backfills can loose tasks to execute
-[AIRFLOW-1299] Support imageVersion in Google Dataproc cluster
-[AIRFLOW-1291] Update NOTICE and LICENSE files to match ASF requirements
-[AIRFLOW-1301] Add New Relic to list of companies
-[AIRFLOW-1289] Removes restriction on number of scheduler threads
-[AIRFLOW-1024] Ignore celery executor errors (#49)
-[AIRFLOW-1265] Fix exception while loading celery configurations
-[AIRFLOW-1290] set docs author to 'Apache Airflow'
-[AIRFLOW-1242] Allowing project_id to have a colon in it.
-[AIRFLOW-1282] Fix known event column sorting
-[AIRFLOW-1166] Speed up _change_state_for_tis_without_dagrun
-[AIRFLOW-1208] Speed-up cli tests
-[AIRFLOW-1192] Some enhancements to qubole_operator
-[AIRFLOW-1281] Sort variables by key field by default
-[AIRFLOW-1277] Forbid KE creation with empty fields
-[AIRFLOW-1276] Forbid event creation with end_data earlier than start_date
-[AIRFLOW-1263] Dynamic height for charts
-[AIRFLOW-1266] Increase width of gantt y axis
-[AIRFLOW-1244] Forbid creation of a pool with empty name
-[AIRFLOW-1274][HTTPSENSOR] Rename parameter params to data
-[AIRFLOW-654] Add SSL Config Option for CeleryExecutor w/ RabbitMQ - Add BROKER_USE_SSL config to give option to send AMQP messages over SSL - Can be set using usual airflow options (e.g. airflow.cfg, env vars, etc.)
-[AIRFLOW-1256] Add United Airlines to readme
-[AIRFLOW-1251] Add eRevalue to Airflow users
-[AIRFLOW-908] Print hostname at the start of cli run
-[AIRFLOW-1237] Fix IN-predicate sqlalchemy warning
-[AIRFLOW-1243] DAGs table has no default entries to show
-[AIRFLOW-1245] Fix random failure in test_trigger_dag_for_date
-[AIRFLOW-1248] Fix wrong conf name for worker timeout
-[AIRFLOW-1197] : SparkSubmitHook on_kill error
-[AIRFLOW-1191] : SparkSubmitHook custom cmd
-[AIRFLOW-1234] Cover utils.operator_helpers with UTs
-[AIRFLOW-1217] Enable Sqoop logging
-[AIRFLOW-645] Support HTTPS connections in HttpHook
-[AIRFLOW-1231] Use flask_wtf.CSRFProtect
-[AIRFLOW-1232] Remove deprecated readfp warning
-[AIRFLOW-1233] Cover utils.json with unit tests
-[AIRFLOW-1227] Remove empty column on the Logs view
-[AIRFLOW-1226] Remove empty column on the Jobs view
-[AIRFLOW-1221] Fix templating bug with DatabricksSubmitRunOperator
-[AIRFLOW-1210] Enable DbApiHook unit tests
-[AIRFLOW-1199] Fix create modal
-[AIRFLOW-1200] Forbid creation of a variable with an empty key
-[AIRFLOW-1207] Enable utils.helpers unit tests
-[AIRFLOW-1213] Add hcatalog parameters to sqoop
-[AIRFLOW-1201] Update deprecated 'nose-parameterized'
-[AIRFLOW-1186] Sort dag.get_task_instances by execution_date
-[AIRFLOW-1203] Pin Google API client version to fix OAuth issue
-[AIRFLOW-1145] Fix closest_date_partition function with before set to True If we're looking for the closest date before, we should take the latest date in the list of date before.
-[AIRFLOW-1180] Fix flask-wtf version for test_csrf_rejection
-[AIRFLOW-993] Update date inference logic
-[AIRFLOW-1170] DbApiHook insert_rows inserts parameters separately
-[AIRFLOW-1041] Do not shadow xcom_push method[]
-[AIRFLOW-860][AIRFLOW-935] Fix plugin executor import cycle and executor selection
-[AIRFLOW-1189] Fix get a DataFrame using BigQueryHook failing
-[AIRFLOW-1184] SparkSubmitHook does not split args
-[AIRFLOW-1182] SparkSubmitOperator template field
-[AIRFLOW-823] Allow specifying execution date in task_info API
-[AIRFLOW-1175] Add Pronto Tools to Airflow user list
-[AIRFLOW-1150] Fix scripts execution in sparksql hook[]
-[AIRFLOW-1141] remove crawl_for_tasks
-[AIRFLOW-1193] Add Checkr to company using Airflow
-[AIRFLOW-1168] Add closing() to all connections and cursors
-[AIRFLOW-1188] Add max_bad_records param to GoogleCloudStorageToBigQueryOperator
-[AIRFLOW-1187][AIRFLOW-1185] Fix PyPi package names in documents
-[AIRFLOW-1185] Fix PyPi URL in templates
-[AIRFLOW-XXX] Updating CHANGELOG, README, and UPDATING after 1.8.1 release
-[AIRFLOW-1181] Add delete and list functionality to gcs_hook
-[AIRFLOW-1179] Fix Pandas 0.2x breaking Google BigQuery change
-[AIRFLOW-1167] Support microseconds in FTPHook modification time
-[AIRFLOW-1173] Add Robinhood to who uses Airflow
-[AIRFLOW-945][AIRFLOW-941] Remove psycopg2 connection workaround
-[AIRFLOW-1140] DatabricksSubmitRunOperator should template the "json" field.
-[AIRFLOW-1160] Update Spark parameters for Mesos
-[AIRFLOW 1149][AIRFLOW-1149] Allow for custom filters in Jinja2 templates
-[AIRFLOW-1036] Randomize exponential backoff
-[AIRFLOW-1155] Add Tails.com to community
-[AIRFLOW-1142] Do not reset orphaned state for backfills
-[AIRFLOW-492] Make sure stat updates cannot fail a task
-[AIRFLOW-1119] Fix unload query so headers are on first row[]
-[AIRFLOW-1089] Add Spark application arguments
-[AIRFLOW-1125] Document encrypted connections
-[AIRFLOW-1122] Increase stroke width in UI
-[AIRFLOW-1138] Add missing licenses to files in scripts directory
-(AIRFLOW-11-38) [AIRFLOW-1136] Capture invalid arguments for Sqoop
-[AIRFLOW-1127] Move license notices to LICENSE
-[AIRFLOW-1118] Add evo.company to Airflow users
-[AIRFLOW-1121][AIRFLOW-1004] Fix `airflow webserver --pid` to write out pid file
-[AIRFLOW-1124] Do not set all tasks to scheduled in backfill
-[AIRFLOW-1120] Update version view to include Apache prefix
-[AIRFLOW-1091] Add script that can compare jira target against merges
-[AIRFLOW-1107] Add support for ftps non-default port
-[AIRFLOW-1000] Rebrand distribution to Apache Airflow
-[AIRFLOW-1094] Run unit tests under contrib in Travis
-[AIRFLOW-1112] Log which pool when pool is full in scheduler
-[AIRFLOW-1106] Add Groupalia/Letsbonus to the ReadMe
-[AIRFLOW-1109] Use kill signal to kill processes and log results
-[AIRFLOW-1074] Don't count queued tasks for concurrency limits
-[AIRFLOW-1095] Make ldap_auth memberOf come from configuration
-[AIRFLOW-1090] Add HBO
-[AIRFLOW-1035] Use binary exponential backoff
-[AIRFLOW-1081] Improve performance of duration chart
-[AIRFLOW-1078] Fix latest_runs endpoint for old flask versions
-[AIRFLOW-1085] Enhance the SparkSubmitOperator
-[AIRFLOW-1050] Do not count up_for_retry as not ready
-[AIRFLOW-1028] Databricks Operator for Airflow
-[AIRFLOW-1075] Security docs cleanup
-[AIRFLOW-1033][AIFRLOW-1033] Fix ti_deps for no schedule dags
-[AIRFLOW-1016] Allow HTTP HEAD request method on HTTPSensor
-[AIRFLOW-970] Load latest_runs on homepage async
-[AIRFLOW-111] Include queued tasks in scheduler concurrency check
-[AIRFLOW-1001] Fix landing times if there is no following schedule
-[AIRFLOW-1065] Add functionality for Azure Blob Storage over wasb://
-[AIRFLOW-947] Improve exceptions for unavailable Presto cluster
-[AIRFLOW-1067] use example.com in examples
-[AIRFLOW-1064] Change default sort to job_id for TaskInstanceModelView
-[AIRFLOW-1030][AIRFLOW-1] Fix hook import for HttpSensor
-[AIRFLOW-1051] Add a test for resetdb to CliTests
-[AIRFLOW-1004][AIRFLOW-276] Fix `airflow webserver -D` to run in background
-[AIRFLOW-1062] Fix DagRun#find to return correct result
-[AIRFLOW-1011] Fix bug in BackfillJob._execute() for SubDAGs
-[AIRFLOW-1038] Specify celery serialization options explicitly
-[AIRFLOW-1054] Fix broken import in test_dag
-[AIRFLOW-1007] Use Jinja sandbox for chart_data endpoint
-[AIRFLOW-719] Fix race condition in ShortCircuit, Branch and LatestOnly
-[AIRFLOW-1043] Fix doc strings of operators
-[AIRFLOW-840] Make ticket renewer python3 compatible
-[AIRFLOW-985] Extend the sqoop operator and hook
-[AIRFLOW-1034] Make it possible to connect to S3 in sigv4 regions
-[AIRFLOW-1045] Make log level configurable via airflow.cfg
-[AIRFLOW-1047] Sanitize strings passed to Markup
-[AIRFLOW-1040] Fix some small typos in comments and docstrings
-[AIRFLOW-1017] get_task_instance shouldn't throw exception when no TI
-[AIRFLOW-1006] Add config_templates to MANIFEST
-[AIRFLOW-999] Add support for Redis database
-[AIRFLOW-1009] Remove SQLOperator from Concepts page
-[AIRFLOW-1006] Move config templates to separate files
-[AIRFLOW-1005] Improve Airflow startup time
-[AIRFLOW-1010] Add convenience script for signing releases
-[AIRFLOW-995] Remove reference to actual Airflow issue
-[AIRFLOW-681] homepage doc link should pointing to apache repo not airbnb repo
-[AIRFLOW-705][AIRFLOW-706] Fix run_command bugs
-[AIRFLOW-990] Fix Py27 unicode logging in DockerOperator
-[AIRFLOW-963] Fix non-rendered code examples
-[AIRFLOW-969] Catch bad python_callable argument
-[AIRFLOW-984] Enable subclassing of SubDagOperator
-[AIRFLOW-997] Update setup.cfg to point to Apache
-[AIRFLOW-994] Add MiNODES to the official airflow user list
-[AIRFLOW-995][AIRFLOW-1] Update GitHub PR Template
-[AIRFLOW-989] Do not mark dag run successful if unfinished tasks
-[AIRFLOW-903] New configuration setting for the default dag view
-[AIRFLOW-979] Add GovTech GDS
-[AIRFLOW-933] Replace eval with literal_eval to prevent RCE
-[AIRFLOW-974] Fix mkdirs race condition
-[AIRFLOW-917] Fix formatting of error message
-[AIRFLOW-770] Refactor BaseHook so env vars are always read
-[AIRFLOW-900] Double trigger should not kill original task instance
-[AIRFLOW-900] Fixes bugs in LocalTaskJob for double run protection
-[AIRFLOW-932][AIRFLOW-932][AIRFLOW-921][AIRFLOW-910] Do not mark tasks removed when backfilling[
-[AIRFLOW-961] run onkill when SIGTERMed
-[AIRFLOW-910] Use parallel task execution for backfills
-[AIRFLOW-967] Wrap strings in native for py2 ldap compatibility
-[AIRFLOW-958] Improve tooltip readability
-AIRFLOW-959 Cleanup and reorganize .gitignore
-AIRFLOW-960 Add .editorconfig file
-[AIRFLOW-931] Do not set QUEUED in TaskInstances
-[AIRFLOW-956] Get docs working on readthedocs.org
-[AIRFLOW-954] Fix configparser ImportError
-[AIRFLOW-941] Use defined parameters for psycopg2
-[AIRFLOW-943] Update Digital First Media in users list
-[AIRFLOW-942] Add mytaxi to Airflow users
-[AIRFLOW-939] add .swp to gitginore
-[AIRFLOW-719] Prevent DAGs from ending prematurely
-[AIRFLOW-938] Use test for True in task_stats queries
-[AIRFLOW-937] Improve performance of task_stats
-[AIRFLOW-933] use ast.literal_eval rather eval because ast.literal_eval does not execute input.
-[AIRFLOW-925] Revert airflow.hooks change that cherry-pick picked
-[AIRFLOW-919] Running tasks with no start date shouldn't break a DAGs UI
-[AIRFLOW-802][AIRFLOW-1] Add spark-submit operator/hook
-[AIRFLOW-725] Use keyring to store credentials for JIRA
-[AIRFLOW-916] Remove deprecated readfp function
-[AIRFLOW-911] Add coloring and timing to tests
-[AIRFLOW-906] Update Code icon from lightning bolt to file
-[AIRFLOW-897] Prevent dagruns from failing with unfinished tasks
-[AIRFLOW-896] Remove unicode to 8-bit conversion in BigQueryOperator
-[AIRFLOW-899] Tasks in SCHEDULED state should be white in the UI instead of black
-[AIRFLOW-895] Address Apache release incompliancies
-[AIRFLOW-893][AIRFLOW-510] Fix crashing webservers when a dagrun has no start date
-[AIRFLOW-880] Make webserver serve logs in a sane way for remote logs
-[AIRFLOW-889] Fix minor error in the docstrings for BaseOperator
-[AIRFLOW-809][AIRFLOW-1] Use __eq__ ColumnOperator When Testing Booleans
-[AIRFLOW-875] Add template to HttpSensor params
-[AIRFLOW-866] Add FTPSensor
-[AIRFLOW-881] Check if SubDagOperator is in DAG context manager
-[AIRFLOW-885] Add change.org to the users list
-[AIRFLOW-836] Use POST and CSRF for state changing endpoints
-[AIRFLOW-862] Fix Unit Tests for DaskExecutor
-[AIRFLOW-887] Support future v0.16
-[AIRFLOW-886] Pass result to post_execute() hook
-[AIRFLOW-871] change logging.warn() into warning()
-[AIRFLOW-882] Remove unnecessary dag>>op assignment in docs
-[AIRFLOW-861] make pickle_info endpoint be login_required
-[AIRFLOW-869] Refactor mark success functionality
-[AIRFLOW-877] Remove .sql template extension from GCS download operator
-[AIRFLOW-826] Add Zendesk hook
-[AIRFLOW-842] do not query the DB with an empty IN clause
-[AIRFLOW-834] change raise StopIteration into return
-[AIRFLOW-832] Let debug server run without SSL
-[AIRFLOW-862] Add DaskExecutor
-[AIRFLOW-858] Configurable database name for DB operators
-[AIRFLOW-863] Example DAGs should have recent start dates
-[AIRFLOW-853] use utf8 encoding for stdout line decode
-[AIRFLOW-857] Use library assert statements instead of conditionals
-[AIRFLOW-856] Make sure execution date is set for local client
-[AIRFLOW-854] Add OKI as Airflow user
-[AIRFLOW-830][AIRFLOW-829][AIRFLOW-88] Reduce Travis log verbosity
-[AIRFLOW-814] Fix Presto*CheckOperator.__init__
-[AIRFLOW-793] Enable compressed loading in S3ToHiveTransfer
-[AIRFLOW-844] Fix cgroups directory creation
-[AIRFLOW-831] Restore import to fix broken tests
-[AIRFLOW-794] Access DAGS_FOLDER and SQL_ALCHEMY_CONN exclusively from settings
-[AIRFLOW-694] Fix config behaviour for empty envvar
-[AIRFLOW-365] Set dag.fileloc explicitly and use for Code view
-[AIRFLOW-781] Allow DataFlowOperators to accept jobs stored in GCS
+- [AIRFLOW-1525] Fix minor LICENSE and NOTICE issues
+- [AIRFLOW-XXX] Bump version to 1.9.0
+- [AIRFLOW-1897][AIRFLOW-1873] Task Logs for running instance not visible in WebUI
+- [AIRFLOW-XXX] Make sure session is committed
+- [AIRFLOW-1896] FIX bleach <> html5lib incompatibility
+- [AIRFLOW-XXX] Fix log handler test
+- [AIRFLOW-1873] Set TI.try_number to right value depending TI state
+- [AIRFLOW-1554] Fix wrong DagFileProcessor termination method call
+- [AIRFLOW-1872] Set context for all handlers including parents
+- [AIRFLOW-XXX] Add dask lock files to excludes
+- [AIRFLOW-1839] Fix more bugs in S3Hook boto -> boto3 migration
+- [AIRFLOW-1795] Correctly call S3Hook after migration to boto3
+- [AIRFLOW-1813] Bug SSH Operator empty buffer
+- [AIRFLOW-1794] Remove uses of Exception.message for Python 3
+- [AIRFLOW-1799] Fix logging line which raises errors
+- [AIRFLOW-1102] Upgrade Gunicorn >=19.4.0
+- [AIRFLOW-1756] Fix S3TaskHandler to work with Boto3-based S3Hook
+- [AIRFLOW-1797] S3Hook.load_string didn't work on Python3
+- [AIRFLOW-1792] Missing intervals DruidOperator
+- [AIRFLOW-1789][AIRFLOW-1712] Log SSHOperator stderr to log.warning
+- [AIRFLOW-1669] Fix Docker and pin Moto to 1.1.19
+- [AIRFLOW-71] Add support for private Docker images
+- [AIRFLOW-1779] Add keepalive packets to ssh hook
+- [AIRFLOW-XXX] Give a clue what the 'ds' variable is
+- [AIRFLOW-XXX] Correct typos in the faq docs page
+- [AIRFLOW-1571] Add AWS Lambda Hook
+- [AIRFLOW-1675] Fix docstrings for API docs
+- [AIRFLOW-1712][AIRFLOW-756][AIRFLOW-751] Log SSHOperator output
+- [AIRFLOW-1776] Capture stdout and stderr for logging
+- [AIRFLOW-1765] Make experimental API securable without needing Kerberos.
+- [AIRFLOW-1764] The web interface should not use the experimental API
+- [AIRFLOW-1634] Adds task_concurrency feature
+- [AIRFLOW-1018] Make processor use logging framework
+- [AIRFLOW-1695] Add RedshiftHook using boto3
+- [AIRFLOW-1706] Fix query error for MSSQL backend
+- [AIRFLOW-1711] Use ldap3 dict for group membership
+- [AIRFLOW-1757] Add missing options to SparkSubmitOperator
+- [AIRFLOW-1734][Airflow 1734] Sqoop hook/operator enhancements
+- [AIRFLOW-1731] Set pythonpath for logging
+- [AIRFLOW-1641] Handle executor events in the scheduler
+- [AIRFLOW-1744] Make sure max_tries can be set
+- [AIRFLOW-1330] Add conn_type argument to CLI when adding connection
+- [AIRFLOW-926] Fix JDBC Hook
+- [AIRFLOW-1520] Boto3 S3Hook, S3Log
+- [AIRFLOW-XXX] Fix DateTime in Tree View
+- [AIRFLOW-1432] Charts label for Y axis not visible
+- [AIRFLOW-1743] Verify ldap filters correctly
+- [AIRFLOW-1745] Restore default signal disposition
+- [AIRFLOW-1741] Correctly hide second chart on task duration page
+- [AIRFLOW-1726] Add copy_expert psycopg2 method to PostgresHook
+- [AIRFLOW-1698] Remove SCHEDULER_RUNS env var in systemd
+- [AIRFLOW-1694] Stop using itertools.izip
+- [AIRFLOW-1692] Change test_views filename to support Windows
+- [AIRFLOW-1722] Fix typo in scheduler autorestart output filename
+- [AIRFLOW-1691] Add better Google cloud logging documentation
+- [AIRFLOW-1690] Add detail to gcs error messages
+- [AIRFLOW-1682] Make S3TaskHandler write to S3 on close
+- [AIRFLOW-1676] Make GCSTaskHandler write to GCS on close
+- [AIRFLOW-1635] Allow creating GCP connection without requiring a JSON file
+- [AIRFLOW-1323] Made Dataproc operator parameter names consistent
+- [AIRFLOW-1590] fix unused module and variable
+- [AIRFLOW-988] Fix repeating SLA miss callbacks
+- [AIRFLOW-1611] Customize logging
+- [AIRFLOW-1668] Expose keepalives_idle for Postgres connections
+- [AIRFLOW-1658] Kill Druid task on timeout
+- [AIRFLOW-1669][AIRFLOW-1368] Fix Docker import
+- [AIRFLOW-1560] Add AWS DynamoDB hook and operator for inserting batch items
+- [AIRFLOW-1654] Show tooltips for link icons in DAGs view
+- [AIRFLOW-1660] Change webpage width to full-width
+- [AIRFLOW-1664] write file as binary instead of str
+- [AIRFLOW-1659] Fix invalid obj attribute bug in file_task_handler.py
+- [AIRFLOW-1650] Fix custom celery config loading
+- [AIRFLOW-1647] Fix Spark-sql hook
+- [AIRFLOW-1587] Fix CeleryExecutor import error
+- [AIRFLOW-1636] Add AWS and EMR connection type
+- [AIRFLOW-1527] Refactor celery config
+- [AIRFLOW-1639] Fix Fernet error handling
+- [AIRFLOW-1628] Fix docstring of sqlsensor
+- [AIRFLOW-1331] add SparkSubmitOperator option
+- [AIRFLOW-1627] Only query pool in SubDAG init when necessary
+- [AIRFLOW-1629] Make extra a textarea in edit connections form
+- [AIRFLOW-1621] Add tests for server side paging
+- [AIRFLOW-1519] Add server side paging in DAGs list
+- [AIRFLOW-289] Make airflow timezone independent
+- [AIRFLOW-1356] Add `--celery_hostname` to `airflow worker`
+- [AIRFLOW-1591] Avoid attribute error when rendering logging filename
+- [AIRFLOW-1031] Replace hard-code to DagRun.ID_PREFIX
+- [AIRFLOW-1604] Rename logger to log
+- [AIRFLOW-1512] Add PythonVirtualenvOperator
+- [AIRFLOW-1617] Fix XSS vulnerability in Variable endpoint
+- [AIRFLOW-1497] Reset hidden fields when changing connection type
+- [AIRFLOW-1177] Fix Variable.setdefault w/existing JSON
+- [AIRFLOW-1600] Fix exception handling in get_fernet
+- [AIRFLOW-1614] Replace inspect.stack() with sys._getframe()
+- [AIRFLOW-1613] Make MySqlToGoogleCloudStorageOperator compaitible with python3
+- [AIRFLOW-1609] Fix gitignore to ignore all venvs
+- [AIRFLOW-1601] Add configurable task cleanup time
+- [AIRFLOW-XXX] Bumping Airflow 1.9.0alpha0 version
+- [AIRFLOW-1608] Handle pending job state in GCP Dataflow hook
+- [AIRFLOW-1606] Use non static DAG.sync_to_db
+- [AIRFLOW-1606][Airflow-1606][AIRFLOW-1605][AIRFLOW-160] DAG.sync_to_db is now a normal method
+- [AIRFLOW-1602] LoggingMixin in DAG class
+- [AIRFLOW-1593] expose load_string in WasbHook
+- [AIRFLOW-1597] Add GameWisp as Airflow user
+- [AIRFLOW-1594] Don't install test packages into python root.[]
+- [AIRFLOW-1582] Improve logging within Airflow
+- [AIRFLOW-1476] add INSTALL instruction for source releases
+- [AIRFLOW-XXX] Save username and password in airflow-pr
+- [AIRFLOW-1522] Increase text size for var field in variables for MySQL
+- [AIRFLOW-950] Missing AWS integrations on documentation::integrations
+- [AIRFLOW-XXX] 1.8.2 release notes
+- [AIRFLOW-1573] Remove `thrift < 0.10.0` requirement
+- [AIRFLOW-1584] Remove insecure /headers endpoint
+- [AIRFLOW-1586] Add mapping for date type to mysql_to_gcs operator
+- [AIRFLOW-1579] Adds support for jagged rows in Bigquery hook for BQ load jobs
+- [AIRFLOW-1577] Add token support to DatabricksHook
+- [AIRFLOW-1580] Error in string formating
+- [AIRFLOW-1567] Updated docs for Google ML Engine operators/hooks
+- [AIRFLOW-1574] add 'to' attribute to templated vars of email operator
+- [AIRFLOW-1572] add carbonite to company list
+- [AIRFLOW-1568] Fix typo in BigQueryHook
+- [AIRFLOW-1493][AIRFLOW-XXXX][WIP] fixed dumb thing
+- [AIRFLOW-1567][Airflow-1567] Renamed cloudml hook and operator to mlengine
+- [AIRFLOW-1568] Add datastore export/import operators
+- [AIRFLOW-1564] Use Jinja2 to render logging filename
+- [AIRFLOW-1562] Spark-sql logging contains deadlock
+- [AIRFLOW-1556][Airflow 1556] Add support for SQL parameters in BigQueryBaseCursor
+- [AIRFLOW-108] Add CreditCards.com to companies list
+- [AIRFLOW-1541] Add channel to template fields of slack_operator
+- [AIRFLOW-1535] Add service account/scopes in dataproc
+- [AIRFLOW-1384] Add to README.md CaDC/ARGO
+- [AIRFLOW-1546] add Zymergen 80to org list in README
+- [AIRFLOW-1545] Add Nextdoor to companies list
+- [AIRFLOW-1544] Add DataFox to companies list
+- [AIRFLOW-1529] Add logic supporting quoted newlines in Google BigQuery load jobs
+- [AIRFLOW-1521] Fix emplate rendering for BigqueryTableDeleteOperator
+- [AIRFLOW-1324] Generalize Druid operator and hook
+- [AIRFLOW-1516] Fix error handling getting fernet
+- [AIRFLOW-1420][AIRFLOW-1473] Fix deadlock check
+- [AIRFLOW-1495] Fix migration on index on job_id
+- [AIRFLOW-1483] Making page size consistent in list
+- [AIRFLOW-1495] Add TaskInstance index on job_id
+- [AIRFLOW-855] Replace PickleType with LargeBinary in XCom
+- [AIRFLOW-1505] Document when Jinja substitution occurs
+- [AIRFLOW-1504] Log dataproc cluster name
+- [AIRFLOW-1239] Fix unicode error for logs in base_task_runner
+- [AIRFLOW-1280] Fix Gantt chart height
+- [AIRFLOW-1507] Template parameters in file_to_gcs operator
+- [AIRFLOW-1452] workaround lock on method
+- [AIRFLOW-1385] Make Airflow task logging configurable
+- [AIRFLOW-940] Handle error on variable decrypt
+- [AIRFLOW-1492] Add gauge for task successes/failures
+- [AIRFLOW-1443] Update Airflow configuration documentation
+- [AIRFLOW-1486] Unexpected S3 writing log error
+- [AIRFLOW-1487] Added links to all companies officially using Airflow
+- [AIRFLOW-1489] Fix typo in BigQueryCheckOperator
+- [AIRFLOW-1349] Fix backfill to respect limits
+- [AIRFLOW-1478] Chart owner column should be sortable
+- [AIRFLOW-1397][AIRFLOW-1] No Last Run column data displyed in Airflow UI 1.8.1
+- [AIRFLOW-1474] Add dag_id regex feature for `airflow clear` command
+- [AIRFLOW-1445] Changing HivePartitionSensor UI color to lighter shade
+- [AIRFLOW-1359] Use default_args in Cloud ML eval
+- [AIRFLOW-1389] Support createDisposition in BigQueryOperator
+- [AIRFLOW-1349] Refactor BackfillJob _execute
+- [AIRFLOW-1459] Fixed broken integration .rst formatting
+- [AIRFLOW-1448] Revert "Fix cli reading logfile in memory"
+- [AIRFLOW-1398] Allow ExternalTaskSensor to wait on multiple runs of a task
+- [AIRFLOW-1399] Fix cli reading logfile in memory
+- [AIRFLOW-1442] Remove extra space from ignore_all_deps generated command
+- [AIRFLOW-1438] Change batch size per query in scheduler
+- [AIRFLOW-1439] Add max billing tier for the BQ Hook and Operator
+- [AIRFLOW-1437] Modify BigQueryTableDeleteOperator
+- [Airflow 1332] Split logs based on try number
+- [AIRFLOW-1385] Create abstraction for Airflow task logging
+- [AIRFLOW-756][AIRFLOW-751] Replace ssh hook, operator & sftp operator with paramiko based
+- [AIRFLOW-1393][[AIRFLOW-1393] Enable Py3 tests in contrib/spark_submit_hook[
+- [AIRFLOW-1345] Dont expire TIs on each scheduler loop
+- [AIRFLOW-1059] Reset orphaned tasks in batch for scheduler
+- [AIRFLOW-1255] Fix SparkSubmitHook output deadlock
+- [AIRFLOW-1359] Add Google CloudML utils for model evaluation
+- [AIRFLOW-1247] Fix ignore all dependencies argument ignored
+- [AIRFLOW-1401] Standardize cloud ml operator arguments
+- [AIRFLOW-1394] Add quote_character param to GCS hook and operator
+- [AIRFLOW-1402] Cleanup SafeConfigParser DeprecationWarning
+- [AIRFLOW-1326][[AIRFLOW-1326][AIRFLOW-1184] Don't split argument array -- it's already an array.[
+- [AIRFLOW-1384] Add ARGO/CaDC as a Airflow user
+- [AIRFLOW-1357] Fix scheduler zip file support
+- [AIRFLOW-1382] Add working dir option to DockerOperator
+- [AIRFLOW-1388] Add Cloud ML Engine operators to integration doc
+- [AIRFLOW-1387] Add unicode string prefix
+- [AIRFLOW-1366] Add max_tries to task instance
+- [AIRFLOW-1300] Enable table creation with TBLPROPERTIES
+- [AIRFLOW-1271] Add Google CloudML Training Operator
+- [AIRFLOW-300] Add Google Pubsub hook and operator
+- [AIRFLOW-1343] Fix dataproc label format
+- [AIRFLOW-1367] Pass Content-ID To reference inline images in an email, we need to be able to add <img src="cid:{}"/> to the HTML. However currently the Content-ID (cid) is not passed, so we need to add it
+- [AIRFLOW-1265] Fix celery executor parsing CELERY_SSL_ACTIVE
+- [AIRFLOW-1272] Google Cloud ML Batch Prediction Operator
+- [AIRFLOW-1352][AIRFLOW-1335] Revert MemoryHandler change ()[]
+- [AIRFLOW-1350] Add query_uri param to Hive/SparkSQL DataProc operator
+- [AIRFLOW-1334] Check if tasks are backfill on scheduler in a join
+- [AIRFLOW-1343] Add Airflow default label to the dataproc operator
+- [AIRFLOW-1273] Add Google Cloud ML version and model operators
+- [AIRFLOW-1273]AIRFLOW-1273] Add Google Cloud ML version and model operators
+- [AIRFLOW-1321] Fix hidden field key to ignore case
+- [AIRFLOW-1337] Make log_format key names lowercase
+- [AIRFLOW-1338][AIRFLOW-782] Add GCP dataflow hook runner change to UPDATING.md
+- [AIRFLOW-801] Remove outdated docstring on BaseOperator
+- [AIRFLOW-1344] Fix text encoding bug when reading logs for Python 3.5
+- [AIRFLOW-1338] Fix incompatible GCP dataflow hook
+- [AIRFLOW-1333] Enable copy function for Google Cloud Storage Hook
+- [AIRFLOW-1337] Allow log format customization via airflow.cfg
+- [AIRFLOW-1320] Update LetsBonus users in README
+- [AIRFLOW-1335] Use MemoryHandler for buffered logging
+- [AIRFLOW-1339] Add Drivy to the list of users
+- [AIRFLOW-1275] Put 'airflow pool' into API
+- [AIRFLOW-1296] Propagate SKIPPED to all downstream tasks
+- [AIRFLOW-1317] Fix minor issues in API reference
+- [AIRFLOW-1308] Disable nanny usage for Dask
+- [AIRFLOW-1172] Support nth weekday of the month cron expression
+- [AIRFLOW-936] Add clear/mark success for DAG in the UI
+- [AIRFLOW-1294] Backfills can loose tasks to execute
+- [AIRFLOW-1299] Support imageVersion in Google Dataproc cluster
+- [AIRFLOW-1291] Update NOTICE and LICENSE files to match ASF requirements
+- [AIRFLOW-1301] Add New Relic to list of companies
+- [AIRFLOW-1289] Removes restriction on number of scheduler threads
+- [AIRFLOW-1024] Ignore celery executor errors (#49)
+- [AIRFLOW-1265] Fix exception while loading celery configurations
+- [AIRFLOW-1290] set docs author to 'Apache Airflow'
+- [AIRFLOW-1242] Allowing project_id to have a colon in it.
+- [AIRFLOW-1282] Fix known event column sorting
+- [AIRFLOW-1166] Speed up _change_state_for_tis_without_dagrun
+- [AIRFLOW-1208] Speed-up cli tests
+- [AIRFLOW-1192] Some enhancements to qubole_operator
+- [AIRFLOW-1281] Sort variables by key field by default
+- [AIRFLOW-1277] Forbid KE creation with empty fields
+- [AIRFLOW-1276] Forbid event creation with end_data earlier than start_date
+- [AIRFLOW-1263] Dynamic height for charts
+- [AIRFLOW-1266] Increase width of gantt y axis
+- [AIRFLOW-1244] Forbid creation of a pool with empty name
+- [AIRFLOW-1274][HTTPSENSOR] Rename parameter params to data
+- [AIRFLOW-654] Add SSL Config Option for CeleryExecutor w/ RabbitMQ - Add BROKER_USE_SSL config to give option to send AMQP messages over SSL - Can be set using usual airflow options (e.g. airflow.cfg, env vars, etc.)
+- [AIRFLOW-1256] Add United Airlines to readme
+- [AIRFLOW-1251] Add eRevalue to Airflow users
+- [AIRFLOW-908] Print hostname at the start of cli run
+- [AIRFLOW-1237] Fix IN-predicate sqlalchemy warning
+- [AIRFLOW-1243] DAGs table has no default entries to show
+- [AIRFLOW-1245] Fix random failure in test_trigger_dag_for_date
+- [AIRFLOW-1248] Fix wrong conf name for worker timeout
+- [AIRFLOW-1197] : SparkSubmitHook on_kill error
+- [AIRFLOW-1191] : SparkSubmitHook custom cmd
+- [AIRFLOW-1234] Cover utils.operator_helpers with UTs
+- [AIRFLOW-1217] Enable Sqoop logging
+- [AIRFLOW-645] Support HTTPS connections in HttpHook
+- [AIRFLOW-1231] Use flask_wtf.CSRFProtect
+- [AIRFLOW-1232] Remove deprecated readfp warning
+- [AIRFLOW-1233] Cover utils.json with unit tests
+- [AIRFLOW-1227] Remove empty column on the Logs view
+- [AIRFLOW-1226] Remove empty column on the Jobs view
+- [AIRFLOW-1221] Fix templating bug with DatabricksSubmitRunOperator
+- [AIRFLOW-1210] Enable DbApiHook unit tests
+- [AIRFLOW-1199] Fix create modal
+- [AIRFLOW-1200] Forbid creation of a variable with an empty key
+- [AIRFLOW-1207] Enable utils.helpers unit tests
+- [AIRFLOW-1213] Add hcatalog parameters to sqoop
+- [AIRFLOW-1201] Update deprecated 'nose-parameterized'
+- [AIRFLOW-1186] Sort dag.get_task_instances by execution_date
+- [AIRFLOW-1203] Pin Google API client version to fix OAuth issue
+- [AIRFLOW-1145] Fix closest_date_partition function with before set to True If we're looking for the closest date before, we should take the latest date in the list of date before.
+- [AIRFLOW-1180] Fix flask-wtf version for test_csrf_rejection
+- [AIRFLOW-993] Update date inference logic
+- [AIRFLOW-1170] DbApiHook insert_rows inserts parameters separately
+- [AIRFLOW-1041] Do not shadow xcom_push method[]
+- [AIRFLOW-860][AIRFLOW-935] Fix plugin executor import cycle and executor selection
+- [AIRFLOW-1189] Fix get a DataFrame using BigQueryHook failing
+- [AIRFLOW-1184] SparkSubmitHook does not split args
+- [AIRFLOW-1182] SparkSubmitOperator template field
+- [AIRFLOW-823] Allow specifying execution date in task_info API
+- [AIRFLOW-1175] Add Pronto Tools to Airflow user list
+- [AIRFLOW-1150] Fix scripts execution in sparksql hook[]
+- [AIRFLOW-1141] remove crawl_for_tasks
+- [AIRFLOW-1193] Add Checkr to company using Airflow
+- [AIRFLOW-1168] Add closing() to all connections and cursors
+- [AIRFLOW-1188] Add max_bad_records param to GoogleCloudStorageToBigQueryOperator
+- [AIRFLOW-1187][AIRFLOW-1185] Fix PyPi package names in documents
+- [AIRFLOW-1185] Fix PyPi URL in templates
+- [AIRFLOW-XXX] Updating CHANGELOG, README, and UPDATING after 1.8.1 release
+- [AIRFLOW-1181] Add delete and list functionality to gcs_hook
+- [AIRFLOW-1179] Fix Pandas 0.2x breaking Google BigQuery change
+- [AIRFLOW-1167] Support microseconds in FTPHook modification time
+- [AIRFLOW-1173] Add Robinhood to who uses Airflow
+- [AIRFLOW-945][AIRFLOW-941] Remove psycopg2 connection workaround
+- [AIRFLOW-1140] DatabricksSubmitRunOperator should template the "json" field.
+- [AIRFLOW-1160] Update Spark parameters for Mesos
+- [AIRFLOW 1149][AIRFLOW-1149] Allow for custom filters in Jinja2 templates
+- [AIRFLOW-1036] Randomize exponential backoff
+- [AIRFLOW-1155] Add Tails.com to community
+- [AIRFLOW-1142] Do not reset orphaned state for backfills
+- [AIRFLOW-492] Make sure stat updates cannot fail a task
+- [AIRFLOW-1119] Fix unload query so headers are on first row[]
+- [AIRFLOW-1089] Add Spark application arguments
+- [AIRFLOW-1125] Document encrypted connections
+- [AIRFLOW-1122] Increase stroke width in UI
+- [AIRFLOW-1138] Add missing licenses to files in scripts directory
+- (AIRFLOW-11-38) [AIRFLOW-1136] Capture invalid arguments for Sqoop
+- [AIRFLOW-1127] Move license notices to LICENSE
+- [AIRFLOW-1118] Add evo.company to Airflow users
+- [AIRFLOW-1121][AIRFLOW-1004] Fix `airflow webserver --pid` to write out pid file
+- [AIRFLOW-1124] Do not set all tasks to scheduled in backfill
+- [AIRFLOW-1120] Update version view to include Apache prefix
+- [AIRFLOW-1091] Add script that can compare jira target against merges
+- [AIRFLOW-1107] Add support for ftps non-default port
+- [AIRFLOW-1000] Rebrand distribution to Apache Airflow
+- [AIRFLOW-1094] Run unit tests under contrib in Travis
+- [AIRFLOW-1112] Log which pool when pool is full in scheduler
+- [AIRFLOW-1106] Add Groupalia/Letsbonus to the ReadMe
+- [AIRFLOW-1109] Use kill signal to kill processes and log results
+- [AIRFLOW-1074] Don't count queued tasks for concurrency limits
+- [AIRFLOW-1095] Make ldap_auth memberOf come from configuration
+- [AIRFLOW-1090] Add HBO
+- [AIRFLOW-1035] Use binary exponential backoff
+- [AIRFLOW-1081] Improve performance of duration chart
+- [AIRFLOW-1078] Fix latest_runs endpoint for old flask versions
+- [AIRFLOW-1085] Enhance the SparkSubmitOperator
+- [AIRFLOW-1050] Do not count up_for_retry as not ready
+- [AIRFLOW-1028] Databricks Operator for Airflow
+- [AIRFLOW-1075] Security docs cleanup
+- [AIRFLOW-1033][AIFRLOW-1033] Fix ti_deps for no schedule dags
+- [AIRFLOW-1016] Allow HTTP HEAD request method on HTTPSensor
+- [AIRFLOW-970] Load latest_runs on homepage async
+- [AIRFLOW-111] Include queued tasks in scheduler concurrency check
+- [AIRFLOW-1001] Fix landing times if there is no following schedule
+- [AIRFLOW-1065] Add functionality for Azure Blob Storage over wasb://
+- [AIRFLOW-947] Improve exceptions for unavailable Presto cluster
+- [AIRFLOW-1067] use example.com in examples
+- [AIRFLOW-1064] Change default sort to job_id for TaskInstanceModelView
+- [AIRFLOW-1030][AIRFLOW-1] Fix hook import for HttpSensor
+- [AIRFLOW-1051] Add a test for resetdb to CliTests
+- [AIRFLOW-1004][AIRFLOW-276] Fix `airflow webserver -D` to run in background
+- [AIRFLOW-1062] Fix DagRun#find to return correct result
+- [AIRFLOW-1011] Fix bug in BackfillJob._execute() for SubDAGs
+- [AIRFLOW-1038] Specify celery serialization options explicitly
+- [AIRFLOW-1054] Fix broken import in test_dag
+- [AIRFLOW-1007] Use Jinja sandbox for chart_data endpoint
+- [AIRFLOW-719] Fix race condition in ShortCircuit, Branch and LatestOnly
+- [AIRFLOW-1043] Fix doc strings of operators
+- [AIRFLOW-840] Make ticket renewer python3 compatible
+- [AIRFLOW-985] Extend the sqoop operator and hook
+- [AIRFLOW-1034] Make it possible to connect to S3 in sigv4 regions
+- [AIRFLOW-1045] Make log level configurable via airflow.cfg
+- [AIRFLOW-1047] Sanitize strings passed to Markup
+- [AIRFLOW-1040] Fix some small typos in comments and docstrings
+- [AIRFLOW-1017] get_task_instance shouldn't throw exception when no TI
+- [AIRFLOW-1006] Add config_templates to MANIFEST
+- [AIRFLOW-999] Add support for Redis database
+- [AIRFLOW-1009] Remove SQLOperator from Concepts page
+- [AIRFLOW-1006] Move config templates to separate files
+- [AIRFLOW-1005] Improve Airflow startup time
+- [AIRFLOW-1010] Add convenience script for signing releases
+- [AIRFLOW-995] Remove reference to actual Airflow issue
+- [AIRFLOW-681] homepage doc link should pointing to apache repo not airbnb repo
+- [AIRFLOW-705][AIRFLOW-706] Fix run_command bugs
+- [AIRFLOW-990] Fix Py27 unicode logging in DockerOperator
+- [AIRFLOW-963] Fix non-rendered code examples
+- [AIRFLOW-969] Catch bad python_callable argument
+- [AIRFLOW-984] Enable subclassing of SubDagOperator
+- [AIRFLOW-997] Update setup.cfg to point to Apache
+- [AIRFLOW-994] Add MiNODES to the official airflow user list
+- [AIRFLOW-995][AIRFLOW-1] Update GitHub PR Template
+- [AIRFLOW-989] Do not mark dag run successful if unfinished tasks
+- [AIRFLOW-903] New configuration setting for the default dag view
+- [AIRFLOW-979] Add GovTech GDS
+- [AIRFLOW-933] Replace eval with literal_eval to prevent RCE
+- [AIRFLOW-974] Fix mkdirs race condition
+- [AIRFLOW-917] Fix formatting of error message
+- [AIRFLOW-770] Refactor BaseHook so env vars are always read
+- [AIRFLOW-900] Double trigger should not kill original task instance
+- [AIRFLOW-900] Fixes bugs in LocalTaskJob for double run protection
+- [AIRFLOW-932][AIRFLOW-932][AIRFLOW-921][AIRFLOW-910] Do not mark tasks removed when backfilling[
+- [AIRFLOW-961] run onkill when SIGTERMed
+- [AIRFLOW-910] Use parallel task execution for backfills
+- [AIRFLOW-967] Wrap strings in native for py2 ldap compatibility
+- [AIRFLOW-958] Improve tooltip readability
+- AIRFLOW-959 Cleanup and reorganize .gitignore
+- AIRFLOW-960 Add .editorconfig file
+- [AIRFLOW-931] Do not set QUEUED in TaskInstances
+- [AIRFLOW-956] Get docs working on readthedocs.org
+- [AIRFLOW-954] Fix configparser ImportError
+- [AIRFLOW-941] Use defined parameters for psycopg2
+- [AIRFLOW-943] Update Digital First Media in users list
+- [AIRFLOW-942] Add mytaxi to Airflow users
+- [AIRFLOW-939] add .swp to gitginore
+- [AIRFLOW-719] Prevent DAGs from ending prematurely
+- [AIRFLOW-938] Use test for True in task_stats queries
+- [AIRFLOW-937] Improve performance of task_stats
+- [AIRFLOW-933] use ast.literal_eval rather eval because ast.literal_eval does not execute input.
+- [AIRFLOW-925] Revert airflow.hooks change that cherry-pick picked
+- [AIRFLOW-919] Running tasks with no start date shouldn't break a DAGs UI
+- [AIRFLOW-802][AIRFLOW-1] Add spark-submit operator/hook
+- [AIRFLOW-725] Use keyring to store credentials for JIRA
+- [AIRFLOW-916] Remove deprecated readfp function
+- [AIRFLOW-911] Add coloring and timing to tests
+- [AIRFLOW-906] Update Code icon from lightning bolt to file
+- [AIRFLOW-897] Prevent dagruns from failing with unfinished tasks
+- [AIRFLOW-896] Remove unicode to 8-bit conversion in BigQueryOperator
+- [AIRFLOW-899] Tasks in SCHEDULED state should be white in the UI instead of black
+- [AIRFLOW-895] Address Apache release incompliancies
+- [AIRFLOW-893][AIRFLOW-510] Fix crashing webservers when a dagrun has no start date
+- [AIRFLOW-880] Make webserver serve logs in a sane way for remote logs
+- [AIRFLOW-889] Fix minor error in the docstrings for BaseOperator
+- [AIRFLOW-809][AIRFLOW-1] Use __eq__ ColumnOperator When Testing Booleans
+- [AIRFLOW-875] Add template to HttpSensor params
+- [AIRFLOW-866] Add FTPSensor
+- [AIRFLOW-881] Check if SubDagOperator is in DAG context manager
+- [AIRFLOW-885] Add change.org to the users list
+- [AIRFLOW-836] Use POST and CSRF for state changing endpoints
+- [AIRFLOW-862] Fix Unit Tests for DaskExecutor
+- [AIRFLOW-887] Support future v0.16
+- [AIRFLOW-886] Pass result to post_execute() hook
+- [AIRFLOW-871] change logging.warn() into warning()
+- [AIRFLOW-882] Remove unnecessary dag>>op assignment in docs
+- [AIRFLOW-861] make pickle_info endpoint be login_required
+- [AIRFLOW-869] Refactor mark success functionality
+- [AIRFLOW-877] Remove .sql template extension from GCS download operator
+- [AIRFLOW-826] Add Zendesk hook
+- [AIRFLOW-842] do not query the DB with an empty IN clause
+- [AIRFLOW-834] change raise StopIteration into return
+- [AIRFLOW-832] Let debug server run without SSL
+- [AIRFLOW-862] Add DaskExecutor
+- [AIRFLOW-858] Configurable database name for DB operators
+- [AIRFLOW-863] Example DAGs should have recent start dates
+- [AIRFLOW-853] use utf8 encoding for stdout line decode
+- [AIRFLOW-857] Use library assert statements instead of conditionals
+- [AIRFLOW-856] Make sure execution date is set for local client
+- [AIRFLOW-854] Add OKI as Airflow user
+- [AIRFLOW-830][AIRFLOW-829][AIRFLOW-88] Reduce Travis log verbosity
+- [AIRFLOW-814] Fix Presto*CheckOperator.__init__
+- [AIRFLOW-793] Enable compressed loading in S3ToHiveTransfer
+- [AIRFLOW-844] Fix cgroups directory creation
+- [AIRFLOW-831] Restore import to fix broken tests
+- [AIRFLOW-794] Access DAGS_FOLDER and SQL_ALCHEMY_CONN exclusively from settings
+- [AIRFLOW-694] Fix config behaviour for empty envvar
+- [AIRFLOW-365] Set dag.fileloc explicitly and use for Code view
+- [AIRFLOW-781] Allow DataFlowOperators to accept jobs stored in GCS
 
-AIRFLOW 1.8.2, 2017-09-04
+Airflow 1.8.2, 2017-09-04
 -------------------------
 
-9a53e66 [AIRFLOW-809][AIRFLOW-1] Use __eq__ ColumnOperator When Testing Booleans
-333e0b3 [AIRFLOW-1296] Propagate SKIPPED to all downstream tasks
-93825d5 Re-enable caching for hadoop components
-33a9dcb Pin Hive and Hadoop to a specific version and create writable warehouse dir
-7cff6cd [AIRFLOW-1308] Disable nanny usage for Dask
-c6a09c4 Updating CHANGELOG for 1.8.2rc1
-570b2ed [AIRFLOW-1294] Backfills can loose tasks to execute
-3f48d48 [AIRFLOW-1291] Update NOTICE and LICENSE files to match ASF requirements
-e10af9a [AIRFLOW-XXX] Set version to 1.8.2rc1
-69bd269 [AIRFLOW-1160] Update Spark parameters for Mesos
-9692510 [AIRFLOW 1149][AIRFLOW-1149] Allow for custom filters in Jinja2 templates
-6de5330 [AIRFLOW-1119] Fix unload query so headers are on first row[]
-b4e9eb8 [AIRFLOW-1089] Add Spark application arguments
-a4083f3 [AIRFLOW-1078] Fix latest_runs endpoint for old flask versions
-7a02841 [AIRFLOW-1074] Don't count queued tasks for concurrency limits
-a2c18a5 [AIRFLOW-1064] Change default sort to job_id for TaskInstanceModelView
-d1c64ab [AIRFLOW-1038] Specify celery serialization options explicitly
-b4ee88a [AIRFLOW-1036] Randomize exponential backoff
-9fca409 [AIRFLOW-993] Update date inference logic
-272c2f5 [AIRFLOW-1167] Support microseconds in FTPHook modification time
-c7c0b72 [AIRFLOW-1179] Fix Pandas 0.2x breaking Google BigQuery change
-acd0166 [AIRFLOW-1263] Dynamic height for charts
-7f33f6e [AIRFLOW-1266] Increase width of gantt y axis
-fc33c04 [AIRFLOW-1290] set docs author to 'Apache Airflow'
-2e9eee3 [AIRFLOW-1282] Fix known event column sorting
-2389a8a [AIRFLOW-1166] Speed up _change_state_for_tis_without_dagrun
-bf966e6 [AIRFLOW-1192] Some enhancements to qubole_operator
-57d5bcd [AIRFLOW-1281] Sort variables by key field by default
-802fc15 [AIRFLOW-1244] Forbid creation of a pool with empty name
-1232b6a [AIRFLOW-1243] DAGs table has no default entries to show
-b0ba3c9 [AIRFLOW-1227] Remove empty column on the Logs view
-c406652 [AIRFLOW-1226] Remove empty column on the Jobs view
-51a83cc [AIRFLOW-1199] Fix create modal
-cac7d4c [AIRFLOW-1200] Forbid creation of a variable with an empty key
-5f3ee52 [AIRFLOW-1186] Sort dag.get_task_instances by execution_date
-f446c08 [AIRFLOW-1145] Fix closest_date_partition function with before set to True If we're looking for the closest date before, we should take the latest date in the list of date before.
-93b8e96 [AIRFLOW-1180] Fix flask-wtf version for test_csrf_rejection
-bb56805 [AIRFLOW-1170] DbApiHook insert_rows inserts parameters separately
-093b2f0 [AIRFLOW-1150] Fix scripts execution in sparksql hook[]
-777f181 [AIRFLOW-1168] Add closing() to all connections and cursors
-bc8e912 [AIRFLOW-XXX] Updating CHANGELOG, README, and UPDATING after 1.8.1 release
+- [AIRFLOW-809][AIRFLOW-1] Use __eq__ ColumnOperator When Testing Booleans
+- [AIRFLOW-1296] Propagate SKIPPED to all downstream tasks
+- Re-enable caching for hadoop components
+- Pin Hive and Hadoop to a specific version and create writable warehouse dir
+- [AIRFLOW-1308] Disable nanny usage for Dask
+- Updating CHANGELOG for 1.8.2rc1
+- [AIRFLOW-1294] Backfills can loose tasks to execute
+- [AIRFLOW-1291] Update NOTICE and LICENSE files to match ASF requirements
+- [AIRFLOW-XXX] Set version to 1.8.2rc1
+- [AIRFLOW-1160] Update Spark parameters for Mesos
+- [AIRFLOW 1149][AIRFLOW-1149] Allow for custom filters in Jinja2 templates
+- [AIRFLOW-1119] Fix unload query so headers are on first row[]
+- [AIRFLOW-1089] Add Spark application arguments
+- [AIRFLOW-1078] Fix latest_runs endpoint for old flask versions
+- [AIRFLOW-1074] Don't count queued tasks for concurrency limits
+- [AIRFLOW-1064] Change default sort to job_id for TaskInstanceModelView
+- [AIRFLOW-1038] Specify celery serialization options explicitly
+- [AIRFLOW-1036] Randomize exponential backoff
+- [AIRFLOW-993] Update date inference logic
+- [AIRFLOW-1167] Support microseconds in FTPHook modification time
+- [AIRFLOW-1179] Fix Pandas 0.2x breaking Google BigQuery change
+- [AIRFLOW-1263] Dynamic height for charts
+- [AIRFLOW-1266] Increase width of gantt y axis
+- [AIRFLOW-1290] set docs author to 'Apache Airflow'
+- [AIRFLOW-1282] Fix known event column sorting
+- [AIRFLOW-1166] Speed up _change_state_for_tis_without_dagrun
+- [AIRFLOW-1192] Some enhancements to qubole_operator
+- [AIRFLOW-1281] Sort variables by key field by default
+- [AIRFLOW-1244] Forbid creation of a pool with empty name
+- [AIRFLOW-1243] DAGs table has no default entries to show
+- [AIRFLOW-1227] Remove empty column on the Logs view
+- [AIRFLOW-1226] Remove empty column on the Jobs view
+- [AIRFLOW-1199] Fix create modal
+- [AIRFLOW-1200] Forbid creation of a variable with an empty key
+- [AIRFLOW-1186] Sort dag.get_task_instances by execution_date
+- [AIRFLOW-1145] Fix closest_date_partition function with before set to True If we're looking for the closest date before, we should take the latest date in the list of date before.
+- [AIRFLOW-1180] Fix flask-wtf version for test_csrf_rejection
+- [AIRFLOW-1170] DbApiHook insert_rows inserts parameters separately
+- [AIRFLOW-1150] Fix scripts execution in sparksql hook[]
+- [AIRFLOW-1168] Add closing() to all connections and cursors
+- [AIRFLOW-XXX] Updating CHANGELOG, README, and UPDATING after 1.8.1 release
 
-AIRFLOW 1.8.1, 2017-05-09
+Airflow 1.8.1, 2017-05-09
 -------------------------
 
-[AIRFLOW-1142] SubDAG Tasks Not Executed Even Though All Dependencies Met
-[AIRFLOW-1138] Add licenses to files in scripts directory
-[AIRFLOW-1127] Move license notices to LICENSE instead of NOTICE
-[AIRFLOW-1124] Do not set all task instances to scheduled on backfill
-[AIRFLOW-1120] Update version view to include Apache prefix
-[AIRFLOW-1062] DagRun#find returns wrong result if external_trigger=False is specified
-[AIRFLOW-1054] Fix broken import on test_dag
-[AIRFLOW-1050] Retries ignored - regression
-[AIRFLOW-1033] TypeError: can't compare datetime.datetime to None
-[AIRFLOW-1017] get_task_instance should return None instead of throw an exception for non-existent TIs
-[AIRFLOW-1011] Fix bug in BackfillJob._execute() for SubDAGs
-[AIRFLOW-1004] `airflow webserver -D` runs in foreground
-[AIRFLOW-1001] Landing Time shows "unsupported operand type(s) for -: 'datetime.datetime' and 'NoneType'" on example_subdag_operator
-[AIRFLOW-1000] Rebrand to Apache Airflow instead of Airflow
-[AIRFLOW-989] Clear Task Regression
-[AIRFLOW-974] airflow.util.file mkdir has a race condition
-[AIRFLOW-906] Update Code icon from lightning bolt to file
-[AIRFLOW-858] Configurable database name for DB operators
-[AIRFLOW-853] ssh_execute_operator.py stdout decode default to ASCII
-[AIRFLOW-832] Fix debug server
-[AIRFLOW-817] Trigger dag fails when using CLI + API
-[AIRFLOW-816] Make sure to pull nvd3 from local resources
-[AIRFLOW-815] Add previous/next execution dates to available default variables.
-[AIRFLOW-813] Fix unterminated unit tests in tests.job (tests/job.py)
-[AIRFLOW-812] Scheduler job terminates when there is no dag file
-[AIRFLOW-806] UI should properly ignore DAG doc when it is None
-[AIRFLOW-794] Consistent access to DAGS_FOLDER and SQL_ALCHEMY_CONN
-[AIRFLOW-785] ImportError if cgroupspy is not installed
-[AIRFLOW-784] Cannot install with funcsigs > 1.0.0
-[AIRFLOW-780] The UI no longer shows broken DAGs
-[AIRFLOW-777] dag_is_running is initlialized to True instead of False
-[AIRFLOW-719] Skipped operations make DAG finish prematurely
-[AIRFLOW-694] Empty env vars do not overwrite non-empty config values
-[AIRFLOW-492] Insert into dag_stats table results into failed task while task itself succeeded
-[AIRFLOW-139] Executing VACUUM with PostgresOperator
-[AIRFLOW-111] DAG concurrency is not honored
-[AIRFLOW-88] Improve clarity Travis CI reports
+- [AIRFLOW-1142] SubDAG Tasks Not Executed Even Though All Dependencies Met
+- [AIRFLOW-1138] Add licenses to files in scripts directory
+- [AIRFLOW-1127] Move license notices to LICENSE instead of NOTICE
+- [AIRFLOW-1124] Do not set all task instances to scheduled on backfill
+- [AIRFLOW-1120] Update version view to include Apache prefix
+- [AIRFLOW-1062] DagRun#find returns wrong result if external_trigger=False is specified
+- [AIRFLOW-1054] Fix broken import on test_dag
+- [AIRFLOW-1050] Retries ignored - regression
+- [AIRFLOW-1033] TypeError: can't compare datetime.datetime to None
+- [AIRFLOW-1017] get_task_instance should return None instead of throw an exception for non-existent TIs
+- [AIRFLOW-1011] Fix bug in BackfillJob._execute() for SubDAGs
+- [AIRFLOW-1004] `airflow webserver -D` runs in foreground
+- [AIRFLOW-1001] Landing Time shows "unsupported operand type(s) for -: 'datetime.datetime' and 'NoneType'" on example_subdag_operator
+- [AIRFLOW-1000] Rebrand to Apache Airflow instead of Airflow
+- [AIRFLOW-989] Clear Task Regression
+- [AIRFLOW-974] airflow.util.file mkdir has a race condition
+- [AIRFLOW-906] Update Code icon from lightning bolt to file
+- [AIRFLOW-858] Configurable database name for DB operators
+- [AIRFLOW-853] ssh_execute_operator.py stdout decode default to ASCII
+- [AIRFLOW-832] Fix debug server
+- [AIRFLOW-817] Trigger dag fails when using CLI + API
+- [AIRFLOW-816] Make sure to pull nvd3 from local resources
+- [AIRFLOW-815] Add previous/next execution dates to available default variables.
+- [AIRFLOW-813] Fix unterminated unit tests in tests.job (tests/job.py)
+- [AIRFLOW-812] Scheduler job terminates when there is no dag file
+- [AIRFLOW-806] UI should properly ignore DAG doc when it is None
+- [AIRFLOW-794] Consistent access to DAGS_FOLDER and SQL_ALCHEMY_CONN
+- [AIRFLOW-785] ImportError if cgroupspy is not installed
+- [AIRFLOW-784] Cannot install with funcsigs > 1.0.0
+- [AIRFLOW-780] The UI no longer shows broken DAGs
+- [AIRFLOW-777] dag_is_running is initlialized to True instead of False
+- [AIRFLOW-719] Skipped operations make DAG finish prematurely
+- [AIRFLOW-694] Empty env vars do not overwrite non-empty config values
+- [AIRFLOW-492] Insert into dag_stats table results into failed task while task itself succeeded
+- [AIRFLOW-139] Executing VACUUM with PostgresOperator
+- [AIRFLOW-111] DAG concurrency is not honored
+- [AIRFLOW-88] Improve clarity Travis CI reports
 
-AIRFLOW 1.8.0, 2017-03-12
+Airflow 1.8.0, 2017-03-12
 -------------------------
 
-[AIRFLOW-900] Double trigger should not kill original task instance
-[AIRFLOW-900] Fixes bugs in LocalTaskJob for double run protection
-[AIRFLOW-932] Do not mark tasks removed when backfilling
-[AIRFLOW-961] run onkill when SIGTERMed
-[AIRFLOW-910] Use parallel task execution for backfills
-[AIRFLOW-967] Wrap strings in native for py2 ldap compatibility
-[AIRFLOW-941] Use defined parameters for psycopg2
-[AIRFLOW-719] Prevent DAGs from ending prematurely
-[AIRFLOW-938] Use test for True in task_stats queries
-[AIRFLOW-937] Improve performance of task_stats
-[AIRFLOW-933] use ast.literal_eval rather eval because ast.literal_eval does not execute input.
-[AIRFLOW-925] Revert airflow.hooks change that cherry-pick picked
-[AIRFLOW-919] Running tasks with no start date shouldn't break a DAGs UI
-[AIRFLOW-802] Add spark-submit operator/hook
-[AIRFLOW-897] Prevent dagruns from failing with unfinished tasks
-[AIRFLOW-861] make pickle_info endpoint be login_required
-[AIRFLOW-853] use utf8 encoding for stdout line decode
-[AIRFLOW-856] Make sure execution date is set for local client
-[AIRFLOW-830][AIRFLOW-829][AIRFLOW-88] Reduce Travis log verbosity
-[AIRFLOW-831] Restore import to fix broken tests
-[AIRFLOW-794] Access DAGS_FOLDER and SQL_ALCHEMY_CONN exclusively from settings
-[AIRFLOW-694] Fix config behaviour for empty envvar
-[AIRFLOW-365] Set dag.fileloc explicitly and use for Code view
-[AIRFLOW-931] Do not set QUEUED in TaskInstances
-[AIRFLOW-899] Tasks in SCHEDULED state should be white in the UI instead of black
-[AIRFLOW-895] Address Apache release incompliancies
-[AIRFLOW-893][AIRFLOW-510] Fix crashing webservers when a dagrun has no start date
-[AIRFLOW-793] Enable compressed loading in S3ToHiveTransfer
-[AIRFLOW-863] Example DAGs should have recent start dates
-[AIRFLOW-869] Refactor mark success functionality
-[AIRFLOW-856] Make sure execution date is set for local client
-[AIRFLOW-814] Fix Presto*CheckOperator.__init__
-[AIRFLOW-844] Fix cgroups directory creation
-[AIRFLOW-816] Use static nvd3 and d3
-[AIRFLOW-821] Fix py3 compatibility
-[AIRFLOW-817] Check for None value of execution_date in endpoint
-[AIRFLOW-822] Close db before exception
-[AIRFLOW-815] Add prev/next execution dates to template variables
-[AIRFLOW-813] Fix unterminated unit tests in SchedulerJobTest
-[AIRFLOW-813] Fix unterminated scheduler unit tests
-[AIRFLOW-806] UI should properly ignore DAG doc when it is None
-[AIRFLOW-812] Fix the scheduler termination bug.
-[AIRFLOW-780] Fix dag import errors no longer working
-[AIRFLOW-783] Fix py3 incompatibility in BaseTaskRunner
-[AIRFLOW-810] Correct down_revision dag_id/state index creation
-[AIRFLOW-807] Improve scheduler performance for large DAGs
-[AIRFLOW-798] Check return_code before forcing termination
-[AIRFLOW-139] Let psycopg2 handle autocommit for PostgresHook
-[AIRFLOW-776] Add missing cgroups devel dependency
-[AIRFLOW-777] Fix expression to check if a DagRun is in running state
-[AIRFLOW-785] Don't import CgroupTaskRunner at global scope
-[AIRFLOW-784] Pin funcsigs to 1.0.0
-[AIRFLOW-624] Fix setup.py to not import airflow.version as version
-[AIRFLOW-779] Task should fail with specific message when deleted
-[AIRFLOW-778] Fix completey broken MetastorePartitionSensor
-[AIRFLOW-739] Set pickle_info log to debug
-[AIRFLOW-771] Make S3 logs append instead of clobber
-[AIRFLOW-773] Fix flaky datetime addition in api test
-[AIRFLOW-219][AIRFLOW-398] Cgroups + impersonation
-[AIRFLOW-683] Add jira hook, operator and sensor
-[AIRFLOW-762] Add Google DataProc delete operator
-[AIRFLOW-760] Update systemd config
-[AIRFLOW-759] Use previous dag_run to verify depend_on_past
-[AIRFLOW-757] Set child_process_log_directory default more sensible
-[AIRFLOW-692] Open XCom page to super-admins only
-[AIRFLOW-737] Fix HDFS Sensor directory.
-[AIRFLOW-747] Fix retry_delay not honoured
-[AIRFLOW-558] Add Support for dag.catchup=(True|False) Option
-[AIRFLOW-489] Allow specifying execution date in trigger_dag API
-[AIRFLOW-738] Commit deleted xcom items before insert
-[AIRFLOW-729] Add Google Cloud Dataproc cluster creation operator
-[AIRFLOW-728] Add Google BigQuery table sensor
-[AIRFLOW-741] Log to debug instead of info for app.py
-[AIRFLOW-731] Fix period bug for NamedHivePartitionSensor
-[AIRFLOW-740] Pin jinja2 to < 2.9.0
-[AIRFLOW-663] Improve time units for task performance charts
-[AIRFLOW-665] Fix email attachments
-[AIRFLOW-734] Fix SMTP auth regression when not using user/pass
-[AIRFLOW-702] Fix LDAP Regex Bug
-[AIRFLOW-717] Add Cloud Storage updated sensor
-[AIRFLOW-695] Retries do not execute because dagrun is in FAILED state
-[AIRFLOW-673] Add operational metrics test for SchedulerJob
-[AIRFLOW-727] try_number is not increased
-[AIRFLOW-715] A more efficient HDFS Sensor:
-[AIRFLOW-716] Allow AVRO BigQuery load-job without schema
-[AIRFLOW-718] Allow the query URI for DataProc Pig
-Log needs to be part of try/catch block
-[AIRFLOW-721] Descendant process can disappear before termination
-[AIRFLOW-403] Bash operator's kill method leaves underlying processes running
-[AIRFLOW-657] Add AutoCommit Parameter for MSSQL
-[AIRFLOW-641] Improve pull request instructions
-[AIRFLOW-685] Add test for MySqlHook.bulk_load()
-[AIRFLOW-686] Match auth backend config section
-[AIRFLOW-691] Add SSH KeepAlive option to SSH_hook
-[AIRFLOW-709] Use same engine for migrations and reflection
-[AIRFLOW-700] Update to reference to web authentication documentation
-[AIRFLOW-649] Support non-sched DAGs in LatestOnlyOp
-[AIRFLOW-712] Fix AIRFLOW-667 to use proper HTTP error properties
-[AIRFLOW-710] Add OneFineStay as official user
-[AIRFLOW-703][AIRFLOW-1] Stop Xcom being cleared too early
-[AIRFLOW-679] Stop concurrent task instances from running
-[AIRFLOW-704][AIRFLOW-1] Fix invalid syntax in BQ hook
-[AIRFLOW-667] Handle BigQuery 503 error
-[AIRFLOW-680] Disable connection pool for commands
-[AIRFLOW-678] Prevent scheduler from double triggering TIs
-[AIRFLOW-677] Kill task if it fails to heartbeat
-[AIRFLOW-674] Ability to add descriptions for DAGs
-[AIRFLOW-682] Bump MAX_PERIODS to make mark_success work for large DAGs
-Use jdk selector to set required jdk
-[AIRFLOW-647] Restore dag.get_active_runs
-[AIRFLOW-662] Change seasons to months in project description
-[AIRFLOW-656] Add dag/task/date index to xcom table
-[AIRFLOW-658] Improve schema_update_options in GCP
-[AIRFLOW-41] Fix pool oversubscription
-[AIRFLOW-489] Add API Framework
-[AIRFLOW-653] Add some missing endpoint tests
-[AIRFLOW-652] Remove obsolete endpoint
-[AIRFLOW-345] Add contrib ECSOperator
-[AIRFLOW-650] Adding Celect to user list
-[AIRFLOW-510] Filter Paused Dags, show Last Run & Trigger Dag
-[AIRFLOW-643] Improve date handling for sf_hook
-[AIRFLOW-638] Add schema_update_options to GCP ops
-[AIRFLOW-640] Install and enable nose-ignore-docstring
-[AIRFLOW-639]AIRFLOW-639] Alphasort package names
-[AIRFLOW-375] Fix pylint errors
-[AIRFLOW-347] Show empty DAG runs in tree view
-[AIRFLOW-628] Adding SalesforceHook to contrib/hooks
-[AIRFLOW-514] hive hook loads data from pandas DataFrame into hive and infers types
-[AIRFLOW-565] Fixes DockerOperator on Python3.x
-[AIRFLOW-635] Encryption option for S3 hook
-[AIRFLOW-137] Fix max_active_runs on clearing tasks
-[AIRFLOW-343] Fix schema plumbing in HiveServer2Hook
-[AIRFLOW-130] Fix ssh operator macosx
-[AIRFLOW-633] Show TI attributes in TI view
-[AIRFLOW-626][AIRFLOW-1] HTML Content does not show up when sending email with attachment
-[AIRFLOW-533] Set autocommit via set_autocommit
-[AIRFLOW-629] stop pinning lxml
-[AIRFLOW-464] Add setdefault method to Variable
-[AIRFLOW-626][AIRFLOW-1] HTML Content does not show up when sending email with attachment
-[AIRFLOW-591] Add datadog hook & sensor
-[AIRFLOW-561] Add RedshiftToS3Transfer operator
-[AIRFLOW-570] Pass root to date form on gantt
-[AIRFLOW-504] Store fractional seconds in MySQL tables
-[AIRFLOW-623] LDAP attributes not always a list
-[AIRFLOW-611] source_format in BigQueryBaseCursor
-[AIRFLOW-619] Fix exception in Gannt chart
-[AIRFLOW-618] Cast DateTimes to avoid sqllite errors
-[AIRFLOW-422] Add JSON endpoint for task info
-[AIRFLOW-616][AIRFLOW-617] Minor fixes to PR tool UX
-[AIRFLOW-179] Fix DbApiHook with non-ASCII chars
-[AIRFLOW-566] Add timeout while fetching logs
-[AIRFLOW-615] Set graph glyphicon first
-[AIRFLOW-609] Add application_name to PostgresHook
-[AIRFLOW-604] Revert .first() to .one()
-[AIRFLOW-370] Create AirflowConfigException in exceptions.py
-[AIRFLOW-582] Fixes TI.get_dagrun filter (removes start_date)
-[AIRFLOW-568] Fix double task_stats count if a DagRun is active
-[AIRFLOW-585] Fix race condition in backfill execution loop
-[AIRFLOW-580] Prevent landscape warning on .format
-[AIRFLOW-597] Check if content is None, not false-equivalent
-[AIRFLOW-586] test_dag_v1 fails from 0 to 3 a.m.
-[AIRFLOW-453] Add XCom Admin Page
-[AIRFLOW-588] Add Google Cloud Storage Object sensor[]
-[AIRFLOW-592] example_xcom import Error
-[AIRFLOW-587] Fix incorrect scope for Google Auth[]
-[AIRFLOW-589] Add templatable job_name[]
-[AIRFLOW-227] Show running config in config view
-[AIRFLOW-319]AIRFLOW-319] xcom push response in HTTP Operator
-[AIRFLOW-385] Add symlink to latest scheduler log directory
-[AIRFLOW-583] Fix decode error in gcs_to_bq
-[AIRFLOW-96] s3_conn_id using environment variable
-[AIRFLOW-575] Clarify tutorial and FAQ about `schedule_interval` always inheriting from DAG object
-[AIRFLOW-577] Output BigQuery job for improved debugging
-[AIRFLOW-560] Get URI & SQLA engine from Connection
-[AIRFLOW-518] Require DataProfilingMixin for Variables CRUD
-[AIRFLOW-553] Fix load path for filters.js
-[AIRFLOW-554] Add Jinja support to Spark-sql
-[AIRFLOW-550] Make ssl config check empty string safe
-[AIRFLOW-500] Use id for github allowed teams
-[AIRFLOW-556] Add UI PR guidelines
-[AIRFLOW-358][AIRFLOW-430] Add `connections` cli
-[AIRFLOW-548] Load DAGs immediately & continually
-[AIRFLOW-539] Updated BQ hook and BQ operator to support Standard SQL.
-[AIRFLOW-378] Add string casting to params of spark-sql operator
-[AIRFLOW-544] Add Pause/Resume toggle button
-[AIRFLOW-333][AIRFLOW-258] Fix non-module plugin components
-[AIRFLOW-542] Add tooltip to DAGs links icons
-[AIRFLOW-530] Update docs to reflect connection environment var has to be in uppercase
-[AIRFLOW-525] Update template_fields in Qubole Op
-[AIRFLOW-480] Support binary file download from GCS
-[AIRFLOW-198] Implement latest_only_operator
-[AIRFLOW-91] Add SSL config option for the webserver
-[AIRFLOW-191] Fix connection leak with PostgreSQL backend
-[AIRFLOW-512] Fix 'bellow' typo in docs & comments
-[AIRFLOW-509][AIRFLOW-1] Create operator to delete tables in BigQuery
-[AIRFLOW-498] Remove hard-coded gcp project id
-[AIRFLOW-505] Support unicode characters in authors' names
-[AIRFLOW-494] Add per-operator success/failure metrics
-[AIRFLOW-488] Fix test_simple fail
-[AIRFLOW-468] Update Panda requirement to 0.17.1
-[AIRFLOW-159] Add cloud integration section + GCP documentation
-[AIRFLOW-477][AIRFLOW-478] Restructure security section for clarity
-[AIRFLOW-467] Allow defining of project_id in BigQueryHook
-[AIRFLOW-483] Change print to logging statement
-[AIRFLOW-475] make the segment granularity in Druid hook configurable
+- [AIRFLOW-900] Double trigger should not kill original task instance
+- [AIRFLOW-900] Fixes bugs in LocalTaskJob for double run protection
+- [AIRFLOW-932] Do not mark tasks removed when backfilling
+- [AIRFLOW-961] run onkill when SIGTERMed
+- [AIRFLOW-910] Use parallel task execution for backfills
+- [AIRFLOW-967] Wrap strings in native for py2 ldap compatibility
+- [AIRFLOW-941] Use defined parameters for psycopg2
+- [AIRFLOW-719] Prevent DAGs from ending prematurely
+- [AIRFLOW-938] Use test for True in task_stats queries
+- [AIRFLOW-937] Improve performance of task_stats
+- [AIRFLOW-933] use ast.literal_eval rather eval because ast.literal_eval does not execute input.
+- [AIRFLOW-925] Revert airflow.hooks change that cherry-pick picked
+- [AIRFLOW-919] Running tasks with no start date shouldn't break a DAGs UI
+- [AIRFLOW-802] Add spark-submit operator/hook
+- [AIRFLOW-897] Prevent dagruns from failing with unfinished tasks
+- [AIRFLOW-861] make pickle_info endpoint be login_required
+- [AIRFLOW-853] use utf8 encoding for stdout line decode
+- [AIRFLOW-856] Make sure execution date is set for local client
+- [AIRFLOW-830][AIRFLOW-829][AIRFLOW-88] Reduce Travis log verbosity
+- [AIRFLOW-831] Restore import to fix broken tests
+- [AIRFLOW-794] Access DAGS_FOLDER and SQL_ALCHEMY_CONN exclusively from settings
+- [AIRFLOW-694] Fix config behaviour for empty envvar
+- [AIRFLOW-365] Set dag.fileloc explicitly and use for Code view
+- [AIRFLOW-931] Do not set QUEUED in TaskInstances
+- [AIRFLOW-899] Tasks in SCHEDULED state should be white in the UI instead of black
+- [AIRFLOW-895] Address Apache release incompliancies
+- [AIRFLOW-893][AIRFLOW-510] Fix crashing webservers when a dagrun has no start date
+- [AIRFLOW-793] Enable compressed loading in S3ToHiveTransfer
+- [AIRFLOW-863] Example DAGs should have recent start dates
+- [AIRFLOW-869] Refactor mark success functionality
+- [AIRFLOW-856] Make sure execution date is set for local client
+- [AIRFLOW-814] Fix Presto*CheckOperator.__init__
+- [AIRFLOW-844] Fix cgroups directory creation
+- [AIRFLOW-816] Use static nvd3 and d3
+- [AIRFLOW-821] Fix py3 compatibility
+- [AIRFLOW-817] Check for None value of execution_date in endpoint
+- [AIRFLOW-822] Close db before exception
+- [AIRFLOW-815] Add prev/next execution dates to template variables
+- [AIRFLOW-813] Fix unterminated unit tests in SchedulerJobTest
+- [AIRFLOW-813] Fix unterminated scheduler unit tests
+- [AIRFLOW-806] UI should properly ignore DAG doc when it is None
+- [AIRFLOW-812] Fix the scheduler termination bug.
+- [AIRFLOW-780] Fix dag import errors no longer working
+- [AIRFLOW-783] Fix py3 incompatibility in BaseTaskRunner
+- [AIRFLOW-810] Correct down_revision dag_id/state index creation
+- [AIRFLOW-807] Improve scheduler performance for large DAGs
+- [AIRFLOW-798] Check return_code before forcing termination
+- [AIRFLOW-139] Let psycopg2 handle autocommit for PostgresHook
+- [AIRFLOW-776] Add missing cgroups devel dependency
+- [AIRFLOW-777] Fix expression to check if a DagRun is in running state
+- [AIRFLOW-785] Don't import CgroupTaskRunner at global scope
+- [AIRFLOW-784] Pin funcsigs to 1.0.0
+- [AIRFLOW-624] Fix setup.py to not import airflow.version as version
+- [AIRFLOW-779] Task should fail with specific message when deleted
+- [AIRFLOW-778] Fix completey broken MetastorePartitionSensor
+- [AIRFLOW-739] Set pickle_info log to debug
+- [AIRFLOW-771] Make S3 logs append instead of clobber
+- [AIRFLOW-773] Fix flaky datetime addition in api test
+- [AIRFLOW-219][AIRFLOW-398] Cgroups + impersonation
+- [AIRFLOW-683] Add jira hook, operator and sensor
+- [AIRFLOW-762] Add Google DataProc delete operator
+- [AIRFLOW-760] Update systemd config
+- [AIRFLOW-759] Use previous dag_run to verify depend_on_past
+- [AIRFLOW-757] Set child_process_log_directory default more sensible
+- [AIRFLOW-692] Open XCom page to super-admins only
+- [AIRFLOW-737] Fix HDFS Sensor directory.
+- [AIRFLOW-747] Fix retry_delay not honoured
+- [AIRFLOW-558] Add Support for dag.catchup=(True|False) Option
+- [AIRFLOW-489] Allow specifying execution date in trigger_dag API
+- [AIRFLOW-738] Commit deleted xcom items before insert
+- [AIRFLOW-729] Add Google Cloud Dataproc cluster creation operator
+- [AIRFLOW-728] Add Google BigQuery table sensor
+- [AIRFLOW-741] Log to debug instead of info for app.py
+- [AIRFLOW-731] Fix period bug for NamedHivePartitionSensor
+- [AIRFLOW-740] Pin jinja2 to < 2.9.0
+- [AIRFLOW-663] Improve time units for task performance charts
+- [AIRFLOW-665] Fix email attachments
+- [AIRFLOW-734] Fix SMTP auth regression when not using user/pass
+- [AIRFLOW-702] Fix LDAP Regex Bug
+- [AIRFLOW-717] Add Cloud Storage updated sensor
+- [AIRFLOW-695] Retries do not execute because dagrun is in FAILED state
+- [AIRFLOW-673] Add operational metrics test for SchedulerJob
+- [AIRFLOW-727] try_number is not increased
+- [AIRFLOW-715] A more efficient HDFS Sensor:
+- [AIRFLOW-716] Allow AVRO BigQuery load-job without schema
+- [AIRFLOW-718] Allow the query URI for DataProc Pig
+- Log needs to be part of try/catch block
+- [AIRFLOW-721] Descendant process can disappear before termination
+- [AIRFLOW-403] Bash operator's kill method leaves underlying processes running
+- [AIRFLOW-657] Add AutoCommit Parameter for MSSQL
+- [AIRFLOW-641] Improve pull request instructions
+- [AIRFLOW-685] Add test for MySqlHook.bulk_load()
+- [AIRFLOW-686] Match auth backend config section
+- [AIRFLOW-691] Add SSH KeepAlive option to SSH_hook
+- [AIRFLOW-709] Use same engine for migrations and reflection
+- [AIRFLOW-700] Update to reference to web authentication documentation
+- [AIRFLOW-649] Support non-sched DAGs in LatestOnlyOp
+- [AIRFLOW-712] Fix AIRFLOW-667 to use proper HTTP error properties
+- [AIRFLOW-710] Add OneFineStay as official user
+- [AIRFLOW-703][AIRFLOW-1] Stop Xcom being cleared too early
+- [AIRFLOW-679] Stop concurrent task instances from running
+- [AIRFLOW-704][AIRFLOW-1] Fix invalid syntax in BQ hook
+- [AIRFLOW-667] Handle BigQuery 503 error
+- [AIRFLOW-680] Disable connection pool for commands
+- [AIRFLOW-678] Prevent scheduler from double triggering TIs
+- [AIRFLOW-677] Kill task if it fails to heartbeat
+- [AIRFLOW-674] Ability to add descriptions for DAGs
+- [AIRFLOW-682] Bump MAX_PERIODS to make mark_success work for large DAGs
+- Use jdk selector to set required jdk
+- [AIRFLOW-647] Restore dag.get_active_runs
+- [AIRFLOW-662] Change seasons to months in project description
+- [AIRFLOW-656] Add dag/task/date index to xcom table
+- [AIRFLOW-658] Improve schema_update_options in GCP
+- [AIRFLOW-41] Fix pool oversubscription
+- [AIRFLOW-489] Add API Framework
+- [AIRFLOW-653] Add some missing endpoint tests
+- [AIRFLOW-652] Remove obsolete endpoint
+- [AIRFLOW-345] Add contrib ECSOperator
+- [AIRFLOW-650] Adding Celect to user list
+- [AIRFLOW-510] Filter Paused Dags, show Last Run & Trigger Dag
+- [AIRFLOW-643] Improve date handling for sf_hook
+- [AIRFLOW-638] Add schema_update_options to GCP ops
+- [AIRFLOW-640] Install and enable nose-ignore-docstring
+- [AIRFLOW-639]AIRFLOW-639] Alphasort package names
+- [AIRFLOW-375] Fix pylint errors
+- [AIRFLOW-347] Show empty DAG runs in tree view
+- [AIRFLOW-628] Adding SalesforceHook to contrib/hooks
+- [AIRFLOW-514] hive hook loads data from pandas DataFrame into hive and infers types
+- [AIRFLOW-565] Fixes DockerOperator on Python3.x
+- [AIRFLOW-635] Encryption option for S3 hook
+- [AIRFLOW-137] Fix max_active_runs on clearing tasks
+- [AIRFLOW-343] Fix schema plumbing in HiveServer2Hook
+- [AIRFLOW-130] Fix ssh operator macosx
+- [AIRFLOW-633] Show TI attributes in TI view
+- [AIRFLOW-626][AIRFLOW-1] HTML Content does not show up when sending email with attachment
+- [AIRFLOW-533] Set autocommit via set_autocommit
+- [AIRFLOW-629] stop pinning lxml
+- [AIRFLOW-464] Add setdefault method to Variable
+- [AIRFLOW-626][AIRFLOW-1] HTML Content does not show up when sending email with attachment
+- [AIRFLOW-591] Add datadog hook & sensor
+- [AIRFLOW-561] Add RedshiftToS3Transfer operator
+- [AIRFLOW-570] Pass root to date form on gantt
+- [AIRFLOW-504] Store fractional seconds in MySQL tables
+- [AIRFLOW-623] LDAP attributes not always a list
+- [AIRFLOW-611] source_format in BigQueryBaseCursor
+- [AIRFLOW-619] Fix exception in Gannt chart
+- [AIRFLOW-618] Cast DateTimes to avoid sqllite errors
+- [AIRFLOW-422] Add JSON endpoint for task info
+- [AIRFLOW-616][AIRFLOW-617] Minor fixes to PR tool UX
+- [AIRFLOW-179] Fix DbApiHook with non-ASCII chars
+- [AIRFLOW-566] Add timeout while fetching logs
+- [AIRFLOW-615] Set graph glyphicon first
+- [AIRFLOW-609] Add application_name to PostgresHook
+- [AIRFLOW-604] Revert .first() to .one()
+- [AIRFLOW-370] Create AirflowConfigException in exceptions.py
+- [AIRFLOW-582] Fixes TI.get_dagrun filter (removes start_date)
+- [AIRFLOW-568] Fix double task_stats count if a DagRun is active
+- [AIRFLOW-585] Fix race condition in backfill execution loop
+- [AIRFLOW-580] Prevent landscape warning on .format
+- [AIRFLOW-597] Check if content is None, not false-equivalent
+- [AIRFLOW-586] test_dag_v1 fails from 0 to 3 a.m.
+- [AIRFLOW-453] Add XCom Admin Page
+- [AIRFLOW-588] Add Google Cloud Storage Object sensor[]
+- [AIRFLOW-592] example_xcom import Error
+- [AIRFLOW-587] Fix incorrect scope for Google Auth[]
+- [AIRFLOW-589] Add templatable job_name[]
+- [AIRFLOW-227] Show running config in config view
+- [AIRFLOW-319]AIRFLOW-319] xcom push response in HTTP Operator
+- [AIRFLOW-385] Add symlink to latest scheduler log directory
+- [AIRFLOW-583] Fix decode error in gcs_to_bq
+- [AIRFLOW-96] s3_conn_id using environment variable
+- [AIRFLOW-575] Clarify tutorial and FAQ about `schedule_interval` always inheriting from DAG object
+- [AIRFLOW-577] Output BigQuery job for improved debugging
+- [AIRFLOW-560] Get URI & SQLA engine from Connection
+- [AIRFLOW-518] Require DataProfilingMixin for Variables CRUD
+- [AIRFLOW-553] Fix load path for filters.js
+- [AIRFLOW-554] Add Jinja support to Spark-sql
+- [AIRFLOW-550] Make ssl config check empty string safe
+- [AIRFLOW-500] Use id for github allowed teams
+- [AIRFLOW-556] Add UI PR guidelines
+- [AIRFLOW-358][AIRFLOW-430] Add `connections` cli
+- [AIRFLOW-548] Load DAGs immediately & continually
+- [AIRFLOW-539] Updated BQ hook and BQ operator to support Standard SQL.
+- [AIRFLOW-378] Add string casting to params of spark-sql operator
+- [AIRFLOW-544] Add Pause/Resume toggle button
+- [AIRFLOW-333][AIRFLOW-258] Fix non-module plugin components
+- [AIRFLOW-542] Add tooltip to DAGs links icons
+- [AIRFLOW-530] Update docs to reflect connection environment var has to be in uppercase
+- [AIRFLOW-525] Update template_fields in Qubole Op
+- [AIRFLOW-480] Support binary file download from GCS
+- [AIRFLOW-198] Implement latest_only_operator
+- [AIRFLOW-91] Add SSL config option for the webserver
+- [AIRFLOW-191] Fix connection leak with PostgreSQL backend
+- [AIRFLOW-512] Fix 'bellow' typo in docs & comments
+- [AIRFLOW-509][AIRFLOW-1] Create operator to delete tables in BigQuery
+- [AIRFLOW-498] Remove hard-coded gcp project id
+- [AIRFLOW-505] Support unicode characters in authors' names
+- [AIRFLOW-494] Add per-operator success/failure metrics
+- [AIRFLOW-488] Fix test_simple fail
+- [AIRFLOW-468] Update Panda requirement to 0.17.1
+- [AIRFLOW-159] Add cloud integration section + GCP documentation
+- [AIRFLOW-477][AIRFLOW-478] Restructure security section for clarity
+- [AIRFLOW-467] Allow defining of project_id in BigQueryHook
+- [AIRFLOW-483] Change print to logging statement
+- [AIRFLOW-475] make the segment granularity in Druid hook configurable
 
 
-AIRFLOW 1.7.2
+Airflow 1.7.2
 -------------
 
-[AIRFLOW-463] Link Airflow icon to landing page
-[AIRFLOW-149] Task Dependency Engine + Why Isn't My Task Running View
-[AIRFLOW-361] Add default failure handler for the Qubole Operator
-[AIRFLOW-353] Fix dag run status update failure
-[AIRFLOW-447] Store source URIs in Python 3 compatible list
-[AIRFLOW-443] Make module names unique when importing
-[AIRFLOW-444] Add Google authentication backend
-[AIRFLOW-446][AIRFLOW-445] Adds missing dataproc submit options
-[AIRFLOW-431] Add CLI for CRUD operations on pools
-[AIRFLOW-329] Update Dag Overview Page with Better Status Columns
-[AIRFLOW-360] Fix style warnings in models.py
-[AIRFLOW-425] Add white fill for null state tasks in tree view.
-[AIRFLOW-69] Use dag runs in backfill jobs
-[AIRFLOW-415] Make dag_id not found error clearer
-[AIRFLOW-416] Use ordinals in README's company list
-[AIRFLOW-369] Allow setting default DAG orientation
-[AIRFLOW-410] Add 2 Q/A to the FAQ in the docs
-[AIRFLOW-407] Add different colors for some sensors
-[AIRFLOW-414] Improve error message for missing FERNET_KEY
-[AIRFLOW-406] Sphinx/rst fixes
-[AIRFLOW-412] Fix lxml dependency
-[AIRFLOW-413] Fix unset path bug when backfilling via pickle
-[AIRFLOW-78] Airflow clear leaves dag_runs
-[AIRFLOW-402] Remove NamedHivePartitionSensor static check, add docs
-[AIRFLOW-394] Add an option to the Task Duration graph to show cumulative times
-[AIRFLOW-404] Retry download if unpacking fails for hive
-[AIRFLOW-276] Gunicorn rolling restart
-[AIRFLOW-399] Remove dags/testdruid.py
-[AIRFLOW-400] models.py/DAG.set_dag_runs_state() does not correctly set state
-[AIRFLOW-395] Fix colon/equal signs typo for resources in default config
-[AIRFLOW-397] Documentation: Fix typo "instatiating" to "instantiating"
-[AIRFLOW-395] Remove trailing commas from resources in config
-[AIRFLOW-388] Add a new chart for Task_Tries for each DAG
-[AIRFLOW-322] Fix typo in FAQ section
-[AIRFLOW-375] Pylint fixes
-limit scope to user email only AIRFLOW-386
-[AIRFLOW-383] Cleanup example qubole operator dag
-[AIRFLOW-160] Parse DAG files through child processes
-[AIRFLOW-381] Manual UI Dag Run creation: require dag_id field
-[AIRFLOW-373] Enhance CLI variables functionality
-[AIRFLOW-379] Enhance Variables page functionality: import/export variables
-[AIRFLOW-331] modify the LDAP authentication config lines in  'Security' sample codes
-[AIRFLOW-356][AIRFLOW-355][AIRFLOW-354] Replace nobr, enable DAG only exists locally message, change edit DAG icon
-[AIRFLOW-362] Import __future__ division
-[AIRFLOW-359] Pin flask-login to 0.2.11
-[AIRFLOW-261] Add bcc and cc fields to EmailOperator
-[AIRFLOW-348] Fix code style warnings
-[AIRFLOW-349] Add metric for number of zombies killed
-[AIRFLOW-340] Remove unused dependency on Babel
-[AIRFLOW-339]: Ability to pass a flower conf file
-[AIRFLOW-341][operators] Add resource requirement attributes to operators
-[AIRFLOW-335] Fix simple style errors/warnings
-[AIRFLOW-337] Add __repr__ to VariableAccessor and VariableJsonAccessor
-[AIRFLOW-334] Fix using undefined variable
-[AIRFLOW-315] Fix blank lines code style warnings
-[AIRFLOW-306] Add Spark-sql Hook and Operator
-[AIRFLOW-327] Add rename method to the FTPHook
-[AIRFLOW-321] Fix a wrong code example about tests/dags
-[AIRFLOW-316] Always check DB state for Backfill Job execution
-[AIRFLOW-264] Adding workload management for Hive
-[AIRFLOW-297] support exponential backoff option for retry delay
-[AIRFLOW-31][AIRFLOW-200] Add note to updating.md
-[AIRFLOW-307] There is no __neq__ python magic method.
-[AIRFLOW-309] Add requirements of develop dependencies to docs
-[AIRFLOW-307] Rename __neq__ to __ne__ python magic method.
-[AIRFLOW-313] Fix code style for sqoop_hook.py
-[AIRFLOW-311] Fix wrong path in CONTRIBUTING.md
-[AIRFLOW-24] DataFlow Java Operator
-[AIRFLOW-308] Add link to refresh DAG within DAG view header
-[AIRFLOW-314] Fix BigQuery cursor run_table_upsert method
-[AIRFLOW-298] fix incubator diclaimer in docs
-[AIRFLOW-284] HiveServer2Hook fix for cursor scope for get_results
-[AIRFLOW-260] More graceful exit when issues can't be closed
-[AIRFLOW-260] Handle case when no version is found
-[AIRFLOW-228] Handle empty version list in PR tool
-[AIRFLOW-302] Improve default squash commit message
-[AIRFLOW-187] Improve prompt styling
-[AIRFLOW-187] Fix typo in argument name
-[AIRFLOW-187] Move "Close XXX" message to end of squash commit
-[AIRFLOW-247] Add EMR hook, operators and sensors. Add AWS base hook
-[AIRFLOW-301] Fix broken unit test
-[AIRFLOW-100] Add execution_date_fn to ExternalTaskSensor
-[AIRFLOW-282] Remove PR Tool logic that depends on version formatting
-[AIRFLOW-291] Add index for state in TI table
-[AIRFLOW-269] Add some unit tests for PostgreSQL
-[AIRFLOW-296] template_ext is being treated as a string rather than a tuple in qubole operator
-[AIRFLOW-286] Improve FTPHook to implement context manager interface
-[AIRFLOW-243] Create NamedHivePartitionSensor
-[AIRFLOW-246] Improve dag_stats endpoint query
-[AIRFLOW-189] Highlighting of Parent/Child nodes in Graphs
-[ARFLOW-255] Check dagrun timeout when comparing active runs
-[AIRFLOW-281] Add port to mssql_hook
-[AIRFLOW-285] Use Airflow 2.0 style imports for all remaining hooks/operators
-[AIRFLOW-40] Add LDAP group filtering feature.
-[AIRFLOW-277] Multiple deletions does not work in Task Instances view if using SQLite backend
-[AIRFLOW-200] Make hook/operator imports lazy, and print proper exceptions
-[AIRFLOW-283] Make store_to_xcom_key a templated field in GoogleCloudStorageDownloadOperator
-[AIRFLOW-278] Support utf-8 ecoding for SQL
-[AIRFLOW-280] clean up tmp druid table no matter if an ingestion job succeeds or not
-[AIRFLOW-274] Add XCom functionality to GoogleCloudStorageDownloadOperator
-[AIRFLOW-273] Create an svg version of the airflow logo.
-[AIRFLOW-275] Update contributing guidelines
-[AIRFLOW-244] Modify hive operator to inject analysis data
-[AIRFLOW-162] Allow variable to be accessible into templates
-[AIRFLOW-248] Add Apache license header to all files
-[AIRFLOW-263] Remove temp backtick file
-[AIRFLOW-252] Raise Sqlite exceptions when deleting tasks instance in WebUI
-[AIRFLOW-180] Fix timeout behavior for sensors
-[AIRFLOW-262] Simplify commands in MANIFEST.in
-[AIRFLOW-31] Add zope dependency
-[AIRFLOW-6] Remove dependency on Highcharts
-[AIRFLOW-234] make task that aren't `running` self-terminate
-[AIRFLOW-256] Fix test_scheduler_reschedule heartrate
-Add Python 3 compatibility fix
-[AIRFLOW-31] Use standard imports for hooks/operators
-[AIRFLOW-173] Initial implementation of FileSensor
-[AIRFLOW-224] Collect orphaned tasks and reschedule them
-[AIRFLOW-239] Fix tests indentation
-[AIRFLOW-225] Better units for task duration graph
-[AIRFLOW-241] Add testing done section to PR template
-[AIRFLOW-222] Show duration of task instances in ui
-[AIRFLOW-231] Do not eval user input in PrestoHook
-[AIRFLOW-216] Add Sqoop Hook and Operator
-[AIRFLOW-171] Add upgrade notes on email and S3 to 1.7.1.2
-[AIRFLOW-238] Make compatible with flask-admin 1.4.1
-[AIRFLOW-230] [HiveServer2Hook] adding multi statements support
-[AIRFLOW-142] setup_env.sh doesn't download hive tarball if hdp is specified as distro
-[AIRFLOW-223] Make parametrable the IP on which Flower binds to
-[AIRFLOW-218] Added option to enable webserver gunicorn access/err logs
-[AIRFLOW-213] Add "Closes #X" phrase to commit messages
-[AIRFLOW-68] Align start_date with the schedule_interval
-[AIRFLOW-9] Improving docs to meet Apache's standards
-[AIRFLOW-131] Make XCom.clear more selective
-[AIRFLOW-214] Fix occasion of detached taskinstance
-[AIRFLOW-206] Add commit to close PR
-[AIRFLOW-206] Always load local log files if they exist
-[AIRFLOW-211] Fix JIRA "resolve" vs "close" behavior
-[AIRFLOW-64] Add note about relative DAGS_FOLDER
-[AIRFLOW-114] Sort plugins dropdown
-[AIRFLOW-209] Add scheduler tests and improve lineage handling
-[AIRFLOW-207] Improve JIRA auth workflow
-[AIRFLOW-187] Improve PR tool UX
-[AIRFLOW-155] Documentation of Qubole Operator
-Optimize and refactor process_dag
-[AIRFLOW-185] Handle empty versions list
-[AIRFLOW-201] Fix for HiveMetastoreHook + kerberos
-[AIRFLOW-202]: Fixes stray print line
-[AIRFLOW-196] Fix bug that exception is not handled in HttpSensor
-[AIRFLOW-195] : Add toggle support to subdag clearing in the CLI
-[AIRFLOW-23] Support for Google Cloud DataProc
-[AIRFLOW-25] Configuration for Celery always required
-[AIRFLOW-190] Add codecov and remove download count
-[AIRFLOW-168] Correct evaluation of @once schedule
-[AIRFLOW-183] Fetch log from remote when worker returns 4xx/5xx response
-[AIRFLOW-181] Fix failing unpacking of hadoop by redownloading
-[AIRFLOW-176] remove unused formatting key
-[AIRFLOW-167]: Add dag_state option in cli
-[AIRFLOW-178] Fix bug so that zip file is detected in DAG folder
-[AIRFLOW-176] Improve PR Tool JIRA workflow
-AIRFLOW-45: Support Hidden Airflow Variables
-[AIRFLOW-175] Run git-reset before checkout in PR tool
-[AIRFLOW-157] Make PR tool Py3-compat; add JIRA command
-[AIRFLOW-170] Add missing @apply_defaults
-
+- [AIRFLOW-463] Link Airflow icon to landing page
+- [AIRFLOW-149] Task Dependency Engine + Why Isn't My Task Running View
+- [AIRFLOW-361] Add default failure handler for the Qubole Operator
+- [AIRFLOW-353] Fix dag run status update failure
+- [AIRFLOW-447] Store source URIs in Python 3 compatible list
+- [AIRFLOW-443] Make module names unique when importing
+- [AIRFLOW-444] Add Google authentication backend
+- [AIRFLOW-446][AIRFLOW-445] Adds missing dataproc submit options
+- [AIRFLOW-431] Add CLI for CRUD operations on pools
+- [AIRFLOW-329] Update Dag Overview Page with Better Status Columns
+- [AIRFLOW-360] Fix style warnings in models.py
+- [AIRFLOW-425] Add white fill for null state tasks in tree view.
+- [AIRFLOW-69] Use dag runs in backfill jobs
+- [AIRFLOW-415] Make dag_id not found error clearer
+- [AIRFLOW-416] Use ordinals in README's company list
+- [AIRFLOW-369] Allow setting default DAG orientation
+- [AIRFLOW-410] Add 2 Q/A to the FAQ in the docs
+- [AIRFLOW-407] Add different colors for some sensors
+- [AIRFLOW-414] Improve error message for missing FERNET_KEY
+- [AIRFLOW-406] Sphinx/rst fixes
+- [AIRFLOW-412] Fix lxml dependency
+- [AIRFLOW-413] Fix unset path bug when backfilling via pickle
+- [AIRFLOW-78] Airflow clear leaves dag_runs
+- [AIRFLOW-402] Remove NamedHivePartitionSensor static check, add docs
+- [AIRFLOW-394] Add an option to the Task Duration graph to show cumulative times
+- [AIRFLOW-404] Retry download if unpacking fails for hive
+- [AIRFLOW-276] Gunicorn rolling restart
+- [AIRFLOW-399] Remove dags/testdruid.py
+- [AIRFLOW-400] models.py/DAG.set_dag_runs_state() does not correctly set state
+- [AIRFLOW-395] Fix colon/equal signs typo for resources in default config
+- [AIRFLOW-397] Documentation: Fix typo "instatiating" to "instantiating"
+- [AIRFLOW-395] Remove trailing commas from resources in config
+- [AIRFLOW-388] Add a new chart for Task_Tries for each DAG
+- [AIRFLOW-322] Fix typo in FAQ section
+- [AIRFLOW-375] Pylint fixes
+- limit scope to user email only AIRFLOW-386
+- [AIRFLOW-383] Cleanup example qubole operator dag
+- [AIRFLOW-160] Parse DAG files through child processes
+- [AIRFLOW-381] Manual UI Dag Run creation: require dag_id field
+- [AIRFLOW-373] Enhance CLI variables functionality
+- [AIRFLOW-379] Enhance Variables page functionality: import/export variables
+- [AIRFLOW-331] modify the LDAP authentication config lines in  'Security' sample codes
+- [AIRFLOW-356][AIRFLOW-355][AIRFLOW-354] Replace nobr, enable DAG only exists locally message, change edit DAG icon
+- [AIRFLOW-362] Import __future__ division
+- [AIRFLOW-359] Pin flask-login to 0.2.11
+- [AIRFLOW-261] Add bcc and cc fields to EmailOperator
+- [AIRFLOW-348] Fix code style warnings
+- [AIRFLOW-349] Add metric for number of zombies killed
+- [AIRFLOW-340] Remove unused dependency on Babel
+- [AIRFLOW-339]: Ability to pass a flower conf file
+- [AIRFLOW-341][operators] Add resource requirement attributes to operators
+- [AIRFLOW-335] Fix simple style errors/warnings
+- [AIRFLOW-337] Add __repr__ to VariableAccessor and VariableJsonAccessor
+- [AIRFLOW-334] Fix using undefined variable
+- [AIRFLOW-315] Fix blank lines code style warnings
+- [AIRFLOW-306] Add Spark-sql Hook and Operator
+- [AIRFLOW-327] Add rename method to the FTPHook
+- [AIRFLOW-321] Fix a wrong code example about tests/dags
+- [AIRFLOW-316] Always check DB state for Backfill Job execution
+- [AIRFLOW-264] Adding workload management for Hive
+- [AIRFLOW-297] support exponential backoff option for retry delay
+- [AIRFLOW-31][AIRFLOW-200] Add note to updating.md
+- [AIRFLOW-307] There is no __neq__ python magic method.
+- [AIRFLOW-309] Add requirements of develop dependencies to docs
+- [AIRFLOW-307] Rename __neq__ to __ne__ python magic method.
+- [AIRFLOW-313] Fix code style for sqoop_hook.py
+- [AIRFLOW-311] Fix wrong path in CONTRIBUTING.md
+- [AIRFLOW-24] DataFlow Java Operator
+- [AIRFLOW-308] Add link to refresh DAG within DAG view header
+- [AIRFLOW-314] Fix BigQuery cursor run_table_upsert method
+- [AIRFLOW-298] fix incubator diclaimer in docs
+- [AIRFLOW-284] HiveServer2Hook fix for cursor scope for get_results
+- [AIRFLOW-260] More graceful exit when issues can't be closed
+- [AIRFLOW-260] Handle case when no version is found
+- [AIRFLOW-228] Handle empty version list in PR tool
+- [AIRFLOW-302] Improve default squash commit message
+- [AIRFLOW-187] Improve prompt styling
+- [AIRFLOW-187] Fix typo in argument name
+- [AIRFLOW-187] Move "Close XXX" message to end of squash commit
+- [AIRFLOW-247] Add EMR hook, operators and sensors. Add AWS base hook
+- [AIRFLOW-301] Fix broken unit test
+- [AIRFLOW-100] Add execution_date_fn to ExternalTaskSensor
+- [AIRFLOW-282] Remove PR Tool logic that depends on version formatting
+- [AIRFLOW-291] Add index for state in TI table
+- [AIRFLOW-269] Add some unit tests for PostgreSQL
+- [AIRFLOW-296] template_ext is being treated as a string rather than a tuple in qubole operator
+- [AIRFLOW-286] Improve FTPHook to implement context manager interface
+- [AIRFLOW-243] Create NamedHivePartitionSensor
+- [AIRFLOW-246] Improve dag_stats endpoint query
+- [AIRFLOW-189] Highlighting of Parent/Child nodes in Graphs
+- [ARFLOW-255] Check dagrun timeout when comparing active runs
+- [AIRFLOW-281] Add port to mssql_hook
+- [AIRFLOW-285] Use Airflow 2.0 style imports for all remaining hooks/operators
+- [AIRFLOW-40] Add LDAP group filtering feature.
+- [AIRFLOW-277] Multiple deletions does not work in Task Instances view if using SQLite backend
+- [AIRFLOW-200] Make hook/operator imports lazy, and print proper exceptions
+- [AIRFLOW-283] Make store_to_xcom_key a templated field in GoogleCloudStorageDownloadOperator
+- [AIRFLOW-278] Support utf-8 ecoding for SQL
+- [AIRFLOW-280] clean up tmp druid table no matter if an ingestion job succeeds or not
+- [AIRFLOW-274] Add XCom functionality to GoogleCloudStorageDownloadOperator
+- [AIRFLOW-273] Create an svg version of the airflow logo.
+- [AIRFLOW-275] Update contributing guidelines
+- [AIRFLOW-244] Modify hive operator to inject analysis data
+- [AIRFLOW-162] Allow variable to be accessible into templates
+- [AIRFLOW-248] Add Apache license header to all files
+- [AIRFLOW-263] Remove temp backtick file
+- [AIRFLOW-252] Raise Sqlite exceptions when deleting tasks instance in WebUI
+- [AIRFLOW-180] Fix timeout behavior for sensors
+- [AIRFLOW-262] Simplify commands in MANIFEST.in
+- [AIRFLOW-31] Add zope dependency
+- [AIRFLOW-6] Remove dependency on Highcharts
+- [AIRFLOW-234] make task that aren't `running` self-terminate
+- [AIRFLOW-256] Fix test_scheduler_reschedule heartrate
+- Add Python 3 compatibility fix
+- [AIRFLOW-31] Use standard imports for hooks/operators
+- [AIRFLOW-173] Initial implementation of FileSensor
+- [AIRFLOW-224] Collect orphaned tasks and reschedule them
+- [AIRFLOW-239] Fix tests indentation
+- [AIRFLOW-225] Better units for task duration graph
+- [AIRFLOW-241] Add testing done section to PR template
+- [AIRFLOW-222] Show duration of task instances in ui
+- [AIRFLOW-231] Do not eval user input in PrestoHook
+- [AIRFLOW-216] Add Sqoop Hook and Operator
+- [AIRFLOW-171] Add upgrade notes on email and S3 to 1.7.1.2
+- [AIRFLOW-238] Make compatible with flask-admin 1.4.1
+- [AIRFLOW-230] [HiveServer2Hook] adding multi statements support
+- [AIRFLOW-142] setup_env.sh doesn't download hive tarball if hdp is specified as distro
+- [AIRFLOW-223] Make parametrable the IP on which Flower binds to
+- [AIRFLOW-218] Added option to enable webserver gunicorn access/err logs
+- [AIRFLOW-213] Add "Closes #X" phrase to commit messages
+- [AIRFLOW-68] Align start_date with the schedule_interval
+- [AIRFLOW-9] Improving docs to meet Apache's standards
+- [AIRFLOW-131] Make XCom.clear more selective
+- [AIRFLOW-214] Fix occasion of detached taskinstance
+- [AIRFLOW-206] Add commit to close PR
+- [AIRFLOW-206] Always load local log files if they exist
+- [AIRFLOW-211] Fix JIRA "resolve" vs "close" behavior
+- [AIRFLOW-64] Add note about relative DAGS_FOLDER
+- [AIRFLOW-114] Sort plugins dropdown
+- [AIRFLOW-209] Add scheduler tests and improve lineage handling
+- [AIRFLOW-207] Improve JIRA auth workflow
+- [AIRFLOW-187] Improve PR tool UX
+- [AIRFLOW-155] Documentation of Qubole Operator
+- Optimize and refactor process_dag
+- [AIRFLOW-185] Handle empty versions list
+- [AIRFLOW-201] Fix for HiveMetastoreHook + kerberos
+- [AIRFLOW-202]: Fixes stray print line
+- [AIRFLOW-196] Fix bug that exception is not handled in HttpSensor
+- [AIRFLOW-195] : Add toggle support to subdag clearing in the CLI
+- [AIRFLOW-23] Support for Google Cloud DataProc
+- [AIRFLOW-25] Configuration for Celery always required
+- [AIRFLOW-190] Add codecov and remove download count
+- [AIRFLOW-168] Correct evaluation of @once schedule
+- [AIRFLOW-183] Fetch log from remote when worker returns 4xx/5xx response
+- [AIRFLOW-181] Fix failing unpacking of hadoop by redownloading
+- [AIRFLOW-176] remove unused formatting key
+- [AIRFLOW-167]: Add dag_state option in cli
+- [AIRFLOW-178] Fix bug so that zip file is detected in DAG folder
+- [AIRFLOW-176] Improve PR Tool JIRA workflow
+- AIRFLOW-45: Support Hidden Airflow Variables
+- [AIRFLOW-175] Run git-reset before checkout in PR tool
+- [AIRFLOW-157] Make PR tool Py3-compat; add JIRA command
+- [AIRFLOW-170] Add missing @apply_defaults
 
-AIRFLOW 1.7.1, 2016-05-19
+Airflow 1.7.1, 2016-05-19
 -------------------------
 
 - Fix : Don't treat premature tasks as could_not_run tasks
diff --git a/docs/changelog.rst b/docs/changelog.rst
new file mode 100644
index 0000000000000..8fa1965686619
--- /dev/null
+++ b/docs/changelog.rst
@@ -0,0 +1,21 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Changelog
+=========
+
+.. include:: ../CHANGELOG.txt
diff --git a/docs/index.rst b/docs/index.rst
index b0054ad670bcf..a5f0c4503a630 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -89,6 +89,8 @@ Content
     api
     integration
     metrics
+    kubernetes
     lineage
+    changelog
     faq
     code
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index d042c14f19aef..33b4f3474d73a 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -15,6 +15,9 @@
     specific language governing permissions and limitations
     under the License.
 
+Kubernetes
+----------
+
 Kubernetes Executor
 ^^^^^^^^^^^^^^^^^^^
 

From 3180dacb679d336f5272337f7cbf1b20174211ce Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sun, 13 Jan 2019 20:42:16 +0000
Subject: [PATCH 440/808] Update CHANGELOG.txt

---
 CHANGELOG.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 2e319607da7b2..f14a9ffbc9d41 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -225,6 +225,7 @@ Doc-only changes
 - [AIRFLOW-XXX] Remove redundant space in Kerberos (#3866)
 - [AIRFLOW-3086] Add extras group for google auth to setup.py (#3917)
 - [AIRFLOW-XXX] Add Kubernetes Dependency in Extra Packages Doc (#4281)
+- [AIRFLOW-3696] Add Version info to Airflow Documentation (#4512)
 
 Airflow 1.10.1, 2018-11-13
 --------------------------

From dcad2e83cfb61e57d7f46baa95b2aa191485f200 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Mon, 14 Jan 2019 00:39:37 +0000
Subject: [PATCH 441/808] Revert [AIRFLOW-3692] Remove ENV variables to avoid
 GPL (#4506)

---
 CHANGELOG.txt                           |  1 -
 CONTRIBUTING.md                         |  2 +-
 INSTALL                                 |  8 ++++++++
 UPDATING.md                             |  6 ------
 docs/installation.rst                   |  8 ++++++++
 scripts/ci/docker-compose.yml           |  1 +
 scripts/ci/kubernetes/docker/Dockerfile |  2 ++
 scripts/ci/kubernetes/docker/build.sh   |  2 +-
 setup.py                                | 20 +++++++++++++++++++-
 9 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index f14a9ffbc9d41..b0c704e79bdb8 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -126,7 +126,6 @@ Improvements
 - [AIRFLOW-3691] Update notice to 2019 (#4503)
 - [AIRFLOW-3689] Update pop-up message when deleting DAG in RBAC UI (#4505)
 - [AIRFLOW-2801] Skip test_mark_success_no_kill in PostgreSQL on CI (#3642)
-- [AIRFLOW-3692] Remove ENV variables to avoid GPL (#4506)
 - [AIRFLOW-3693] Replace psycopg2-binary by psycopg2 (#4508)
 
 Bug fixes
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 58a1fe447c9ff..d23605458e101 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -121,7 +121,7 @@ There are three ways to setup an Apache Airflow development environment.
 
   ```
   # Start docker in your Airflow directory
-  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ python:3 bash
+  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:3 bash
 
 
   # Install Airflow with all the required dependencies,
diff --git a/INSTALL b/INSTALL
index c3d15a23eaa08..00d458f450737 100644
--- a/INSTALL
+++ b/INSTALL
@@ -14,6 +14,14 @@ java -jar apache-rat.jar -E ./.rat-excludes -d .
 python -m my_env
 source my_env/bin/activate
 
+# [required] by default one of Apache Airflow's dependencies pulls in a GPL
+# library. Airflow will not install (and upgrade) without an explicit choice.
+#
+# To make sure not to install the GPL dependency:
+#   export SLUGIFY_USES_TEXT_UNIDECODE=yes
+# In case you do not mind:
+#   export AIRFLOW_GPL_UNIDECODE=yes
+
 # [required] building and installing
 # by pip (preferred)
 pip install .
diff --git a/UPDATING.md b/UPDATING.md
index fb85118386298..91d509d681548 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -24,12 +24,6 @@ assists users migrating to a new version.
 
 ## Airflow 1.10.2
 
-#### SLUGIFY_USES_TEXT_UNIDECODE or AIRFLOW_GPL_UNIDECODE no longer required
-
-It is no longer required to set one of the environment variables to avoid
-a GPL dependency. Airflow will now always use text-unidecode if unidecode
-was not installed before.
-
 ### Modification to `ts_nodash` macro
 `ts_nodash` previously contained TimeZone information alongwith execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes. 
 
diff --git a/docs/installation.rst b/docs/installation.rst
index 2c9436e2f997b..f06aab56c5067 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -33,6 +33,14 @@ You can also install Airflow with support for extra features like ``s3`` or ``po
 
     pip install apache-airflow[postgres,s3]
 
+.. note:: GPL dependency
+
+    One of the dependencies of Apache Airflow by default pulls in a GPL library ('unidecode').
+    In case this is a concern you can force a non GPL library by issuing
+    ``export SLUGIFY_USES_TEXT_UNIDECODE=yes`` and then proceed with the normal installation.
+    Please note that this needs to be specified at every upgrade. Also note that if `unidecode`
+    is already present on the system the dependency will still be used.
+
 Extra Packages
 ''''''''''''''
 
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 0f5d660c390e9..32e0a536c1597 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -67,6 +67,7 @@ services:
     init: true
     environment:
       - USER=airflow
+      - SLUGIFY_USES_TEXT_UNIDECODE=yes
       - TOX_ENV
       - PYTHON_VERSION
       - CI
diff --git a/scripts/ci/kubernetes/docker/Dockerfile b/scripts/ci/kubernetes/docker/Dockerfile
index 387e7d3804740..93b20dbcd22fa 100644
--- a/scripts/ci/kubernetes/docker/Dockerfile
+++ b/scripts/ci/kubernetes/docker/Dockerfile
@@ -17,6 +17,8 @@
 
 FROM ubuntu:16.04
 
+ENV SLUGIFY_USES_TEXT_UNIDECODE=yes
+
 # install deps
 RUN apt-get update -y && apt-get install -y \
         wget \
diff --git a/scripts/ci/kubernetes/docker/build.sh b/scripts/ci/kubernetes/docker/build.sh
index cb0995aaf473c..df755f9659178 100755
--- a/scripts/ci/kubernetes/docker/build.sh
+++ b/scripts/ci/kubernetes/docker/build.sh
@@ -41,7 +41,7 @@ else
 fi
 
 cd $AIRFLOW_ROOT
-docker run -ti --rm -v ${AIRFLOW_ROOT}:/airflow \
+docker run -ti --rm -e SLUGIFY_USES_TEXT_UNIDECODE -v ${AIRFLOW_ROOT}:/airflow \
     -w /airflow ${PYTHON_DOCKER_IMAGE} ./scripts/ci/kubernetes/docker/compile.sh \
 
 sudo rm -rf ${AIRFLOW_ROOT}/airflow/www_rbac/node_modules
diff --git a/setup.py b/setup.py
index 6e90ae2ebff9c..f1091ddb1d697 100644
--- a/setup.py
+++ b/setup.py
@@ -39,6 +39,24 @@
     long_description = f.read()
 
 
+# See LEGAL-362
+def verify_gpl_dependency():
+    # The Read the Docs build environment [1] does a pip install of Airflow which cannot
+    # be overridden with custom environment variables, so we detect the READTHEDOCS env
+    # var they provide to set the env var that avoids the GPL dependency on install when
+    # building the docs site.
+    # [1]: http://docs.readthedocs.io/en/latest/builds.html#build-environment
+    if os.getenv("READTHEDOCS") == "True":
+        os.environ["SLUGIFY_USES_TEXT_UNIDECODE"] = "yes"
+
+    if not os.getenv("AIRFLOW_GPL_UNIDECODE") and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes":
+        raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
+                           "dependency (unidecode). To avoid this dependency set "
+                           "SLUGIFY_USES_TEXT_UNIDECODE=yes in your environment when you "
+                           "install or upgrade Airflow. To force installing the GPL "
+                           "version set AIRFLOW_GPL_UNIDECODE")
+
+
 class Tox(TestCommand):
     user_options = [('tox-args=', None, "Arguments to pass to tox")]
 
@@ -266,6 +284,7 @@ def write_version(filename=os.path.join(*['airflow',
 
 
 def do_setup():
+    verify_gpl_dependency()
     write_version()
     setup(
         name='apache-airflow',
@@ -314,7 +333,6 @@ def do_setup():
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
-            'text-unidecode==1.2',  # Avoid GPL dependency, pip uses reverse order(!)
             'thrift>=0.9.2',
             'tzlocal>=1.4',
             'unicodecsv>=0.14.1',

From 8419e5f119cc60388133a5226f8b4c0d8899ea34 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 14 Jan 2019 18:10:04 +0800
Subject: [PATCH 442/808] [AIRFLOW-3700] Change the lowest allowed version of
 "requests" (#4517)

---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index f1091ddb1d697..cd9bb3aa7b784 100644
--- a/setup.py
+++ b/setup.py
@@ -170,7 +170,7 @@ def write_version(filename=os.path.join(*['airflow',
 dask = [
     'distributed>=1.17.1, <2'
 ]
-databricks = ['requests>=2.5.1, <3']
+databricks = ['requests>=2.20.0, <3']
 datadog = ['datadog>=0.14.0']
 doc = [
     'mock',
@@ -328,7 +328,7 @@ def do_setup():
             'python-daemon>=2.1.1, <2.2',
             'python-dateutil>=2.3, <3',
             'python-nvd3==0.15.0',
-            'requests>=2.5.1, <3',
+            'requests>=2.20.0, <3',
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',

From c70748884fba36ff60c759e3b595d63a2437394f Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 14 Jan 2019 15:59:03 +0000
Subject: [PATCH 443/808] [AIRFLOW-3655] Escape links generated in model views
 (#4519)

---
 airflow/www/views.py         | 23 ++++++++++++++---------
 airflow/www_rbac/views.py    | 12 ++++++------
 tests/www_rbac/test_views.py |  1 +
 3 files changed, 21 insertions(+), 15 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 9d6df65e022a4..dbd12df43baea 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -209,7 +209,8 @@ def label_link(v, c, m, p):
 
 def pool_link(v, c, m, p):
     title = escape(m.pool)
-    url = '/admin/taskinstance/?flt1_pool_equals=' + m.pool
+
+    url = url_for('airflow.task', flt1_pool_equals=m.pool)
     return Markup("<a href='{url}'>{title}</a>".format(**locals()))
 
 
@@ -273,18 +274,22 @@ def decorated_function(*args, **kwargs):
 
 
 def fused_slots(v, c, m, p):
-    url = (
-        '/admin/taskinstance/' +
-        '?flt1_pool_equals=' + m.pool +
-        '&flt2_state_equals=running')
+    url = url_for(
+        'taskinstance.index_view',
+        flt1_pool_equals=m.pool,
+        flt2_state_equals='running',
+    )
     return Markup("<a href='{0}'>{1}</a>".format(url, m.used_slots()))
 
 
 def fqueued_slots(v, c, m, p):
-    url = (
-        '/admin/taskinstance/' +
-        '?flt1_pool_equals=' + m.pool +
-        '&flt2_state_equals=queued&sort=10&desc=1')
+    url = url_for(
+        'taskinstance.index_view',
+        flt1_pool_equals=m.pool,
+        flt2_state_equals='queued',
+        sort='1',
+        desc='1'
+    )
     return Markup("<a href='{0}'>{1}</a>".format(url, m.queued_slots()))
 
 
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 6fd13b1bcb929..509e17c1ae5fd 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -36,7 +36,7 @@
 import sqlalchemy as sqla
 from flask import (
     redirect, request, Markup, Response, render_template,
-    make_response, flash, jsonify, escape)
+    make_response, flash, jsonify, escape, url_for)
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
@@ -2015,7 +2015,7 @@ def action_muldelete(self, items):
     def pool_link(attr):
         pool_id = attr.get('pool')
         if pool_id is not None:
-            url = '/taskinstance/list/?_flt_3_pool=' + str(pool_id)
+            url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id)
             pool_id = escape(pool_id)
             return Markup("<a href='{url}'>{pool_id}</a>".format(**locals()))
         else:
@@ -2025,8 +2025,8 @@ def fused_slots(attr):
         pool_id = attr.get('pool')
         used_slots = attr.get('used_slots')
         if pool_id is not None and used_slots is not None:
-            url = '/taskinstance/list/?_flt_3_pool=' + str(pool_id) + \
-                  '&_flt_3_state=running'
+            url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id, _flt_3_state='running')
+            pool_id = escape(pool_id)
             return Markup("<a href='{url}'>{used_slots}</a>".format(**locals()))
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
@@ -2035,8 +2035,8 @@ def fqueued_slots(attr):
         pool_id = attr.get('pool')
         queued_slots = attr.get('queued_slots')
         if pool_id is not None and queued_slots is not None:
-            url = '/taskinstance/list/?_flt_3_pool=' + str(pool_id) + \
-                  '&_flt_3_state=queued'
+            url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id, _flt_3_state='queued')
+            pool_id = escape(pool_id)
             return Markup("<a href='{url}'>{queued_slots}</a>".format(**locals()))
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 8796bb3945bbe..843ee16807941 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -257,6 +257,7 @@ def test_odd_name(self):
         self.session.commit()
         resp = self.client.get('/pool/list/')
         self.check_content_in_response('test-pool&lt;script&gt;', resp)
+        self.check_content_not_in_response('test-pool<script>', resp)
 
 
 class TestMountPoint(unittest.TestCase):

From 66ef768d657b08d41dbbb0839ab3ff903527c7a8 Mon Sep 17 00:00:00 2001
From: Wyndham Blanton <bo.blanton@gmail.com>
Date: Mon, 14 Jan 2019 10:06:46 -0800
Subject: [PATCH 444/808] [AIRFLOW-3319] - KubernetsExecutor: Need in
 try_number in  labels if getting them later (#4163)

* Need in labels if getting them later

* has to be an int to match running keys

- otherwise  running list will never empty

* pr comments

* bad merge

* mend pep issue

* add try_numer to make_pod test
---
 airflow/contrib/executors/kubernetes_executor.py    | 11 +++++++++--
 airflow/contrib/kubernetes/worker_configuration.py  |  5 +++--
 tests/contrib/executors/test_kubernetes_executor.py |  4 ++--
 3 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 75c8dc292e561..222b196e88a61 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -384,7 +384,7 @@ def run_next(self, next_job):
         pod = self.worker_configuration.make_pod(
             namespace=self.namespace, worker_uuid=self.worker_uuid,
             pod_id=self._create_pod_id(dag_id, task_id),
-            dag_id=dag_id, task_id=task_id,
+            dag_id=dag_id, task_id=task_id, try_number=try_number,
             execution_date=self._datetime_to_label_safe_datestring(execution_date),
             airflow_command=command, kube_executor_config=kube_executor_config
         )
@@ -496,11 +496,18 @@ def _datetime_to_label_safe_datestring(datetime_obj):
         return datetime_obj.isoformat().replace(":", "_").replace('+', '_plus_')
 
     def _labels_to_key(self, labels):
+        try_num = 1
+        try:
+            try_num = int(labels.get('try_number', '1'))
+        except ValueError:
+            self.log.warn("could not get try_number as an int: %s", labels.get('try_number', '1'))
+
         try:
             return (
                 labels['dag_id'], labels['task_id'],
                 self._label_safe_datestring_to_datetime(labels['execution_date']),
-                labels['try_number'])
+                try_num,
+            )
         except Exception as e:
             self.log.warn(
                 'Error while converting labels to key; labels: %s; exception: %s',
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 165db956f2e5d..21cbdd6c7fc0f 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -211,7 +211,7 @@ def generate_dag_volume_mount_path(self):
         return dag_volume_mount_path
 
     def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_date,
-                 airflow_command, kube_executor_config):
+                 try_number, airflow_command, kube_executor_config):
         volumes_dict, volume_mounts_dict = self.init_volumes_and_mounts()
         worker_init_container_spec = self._get_init_containers(
             copy.deepcopy(volume_mounts_dict))
@@ -244,7 +244,8 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
                 'airflow-worker': worker_uuid,
                 'dag_id': dag_id,
                 'task_id': task_id,
-                'execution_date': execution_date
+                'execution_date': execution_date,
+                'try_number': str(try_number),
             },
             envs=self._get_environment(),
             secrets=self._get_secrets(),
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index affde37192ad8..d67b9b23b4a76 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -243,7 +243,7 @@ def test_make_pod_with_empty_executor_config(self):
                                                         )
 
         pod = worker_config.make_pod("default", str(uuid.uuid4()), "test_pod_id", "test_dag_id",
-                                     "test_task_id", str(datetime.utcnow()), "bash -c 'ls /'",
+                                     "test_task_id", str(datetime.utcnow()), 1, "bash -c 'ls /'",
                                      kube_executor_config)
 
         self.assertTrue(pod.affinity['podAntiAffinity'] is not None)
@@ -267,7 +267,7 @@ def test_make_pod_with_executor_config(self):
                                                         )
 
         pod = worker_config.make_pod("default", str(uuid.uuid4()), "test_pod_id", "test_dag_id",
-                                     "test_task_id", str(datetime.utcnow()), "bash -c 'ls /'",
+                                     "test_task_id", str(datetime.utcnow()), 1, "bash -c 'ls /'",
                                      kube_executor_config)
 
         self.assertTrue(pod.affinity['podAntiAffinity'] is not None)

From 7318c5f68bd2382dbcbcb6e7e6b800e32d7adce4 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 15 Jan 2019 01:34:45 +0800
Subject: [PATCH 445/808] [AIRFLOW-3704] Support SSL Protection When Redis is
 Used as Broker for CeleryExecutor (#4521)

From Celery 4.1 (current Airflow is using 4.1.1),
"broker_use_ssl" argument starts to support Redis
(earlier this argument is only supported when amqp is used for broker)
(REF: https://github.com/celery/celery/blob/4.1/docs/userguide/configuration.rst).
---
 airflow/config_templates/default_celery.py | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/airflow/config_templates/default_celery.py b/airflow/config_templates/default_celery.py
index 5e72134de1efe..000545f1dd257 100644
--- a/airflow/config_templates/default_celery.py
+++ b/airflow/config_templates/default_celery.py
@@ -60,10 +60,20 @@ def _broker_supports_visibility_timeout(url):
 
 try:
     if celery_ssl_active:
-        broker_use_ssl = {'keyfile': configuration.conf.get('celery', 'SSL_KEY'),
-                          'certfile': configuration.conf.get('celery', 'SSL_CERT'),
-                          'ca_certs': configuration.conf.get('celery', 'SSL_CACERT'),
-                          'cert_reqs': ssl.CERT_REQUIRED}
+        if 'amqp://' in broker_url:
+            broker_use_ssl = {'keyfile': configuration.conf.get('celery', 'SSL_KEY'),
+                              'certfile': configuration.conf.get('celery', 'SSL_CERT'),
+                              'ca_certs': configuration.conf.get('celery', 'SSL_CACERT'),
+                              'cert_reqs': ssl.CERT_REQUIRED}
+        elif 'redis://' in broker_url:
+            broker_use_ssl = {'ssl_keyfile': configuration.conf.get('celery', 'SSL_KEY'),
+                              'ssl_certfile': configuration.conf.get('celery', 'SSL_CERT'),
+                              'ssl_ca_certs': configuration.conf.get('celery', 'SSL_CACERT'),
+                              'ssl_cert_reqs': ssl.CERT_REQUIRED}
+        else:
+            raise AirflowException('The broker you configured does not support SSL_ACTIVE to be True. '
+                                   'Please use RabbitMQ or Redis if you would like to use SSL for broker.')
+
         DEFAULT_CELERY_CONFIG['broker_use_ssl'] = broker_use_ssl
 except AirflowConfigException as e:
     raise AirflowException('AirflowConfigException: SSL_ACTIVE is True, '
@@ -75,6 +85,6 @@ def _broker_supports_visibility_timeout(url):
                            'SSL and/or have all necessary certs and key ({}).'.format(e))
 
 result_backend = DEFAULT_CELERY_CONFIG['result_backend']
-if 'amqp' in result_backend or 'redis' in result_backend or 'rpc' in result_backend:
+if 'amqp://' in result_backend or 'redis://' in result_backend or 'rpc://' in result_backend:
     log.warning("You have configured a result_backend of %s, it is highly recommended "
                 "to use an alternative result_backend (i.e. a database).", result_backend)

From c305a914b4a35b4a59f05e8cb77a96e5ed33736b Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Tue, 15 Jan 2019 01:54:03 +0100
Subject: [PATCH 446/808] [AIRFLOW-3681] All GCP operators have now optional
 GCP Project ID (#4500)

---
 .../example_gcp_bigtable_operators.py         |   83 +-
 .../example_dags/example_gcp_compute.py       |    9 +-
 .../example_dags/example_gcp_compute_igm.py   |    6 +-
 .../example_dags/example_gcp_function.py      |   10 +-
 .../example_dags/example_gcp_spanner.py       |   43 +-
 .../contrib/example_dags/example_gcp_sql.py   |   51 +-
 .../example_dags/example_gcp_sql_query.py     |   18 +-
 airflow/contrib/hooks/gcp_api_base_hook.py    |   43 +-
 airflow/contrib/hooks/gcp_bigtable_hook.py    |   90 +-
 airflow/contrib/hooks/gcp_compute_hook.py     |  128 ++-
 airflow/contrib/hooks/gcp_function_hook.py    |   83 +-
 airflow/contrib/hooks/gcp_spanner_hook.py     |  211 ++--
 airflow/contrib/hooks/gcp_sql_hook.py         |  243 ++--
 airflow/contrib/hooks/gcs_hook.py             |    2 -
 .../operators/gcp_bigtable_operator.py        |  202 ++--
 .../contrib/operators/gcp_compute_operator.py |  143 ++-
 .../operators/gcp_function_operator.py        |   26 +-
 .../contrib/operators/gcp_spanner_operator.py |  131 ++-
 airflow/contrib/operators/gcp_sql_operator.py |  126 ++-
 docs/howto/operator.rst                       |  133 ++-
 tests/contrib/hooks/test_gcp_bigtable_hook.py |  372 ++++++
 tests/contrib/hooks/test_gcp_compute_hook.py  |  576 ++++++++++
 tests/contrib/hooks/test_gcp_dataproc_hook.py |    6 +-
 tests/contrib/hooks/test_gcp_function_hook.py |  276 +++++
 tests/contrib/hooks/test_gcp_spanner_hook.py  |  730 ++++++++++++
 tests/contrib/hooks/test_gcp_sql_hook.py      | 1001 ++++++++++++++++-
 .../operators/test_gcp_bigtable_operator.py   |  238 +++-
 .../operators/test_gcp_compute_operator.py    |  109 +-
 .../operators/test_gcp_function_operator.py   |   79 +-
 .../operators/test_gcp_spanner_operator.py    |  159 ++-
 .../operators/test_gcp_sql_operator.py        |  254 ++++-
 tests/contrib/utils/base_gcp_mock.py          |   47 +
 .../utils/base_gcp_system_test_case.py        |    3 +-
 33 files changed, 4878 insertions(+), 753 deletions(-)
 create mode 100644 tests/contrib/hooks/test_gcp_bigtable_hook.py
 create mode 100644 tests/contrib/hooks/test_gcp_compute_hook.py
 create mode 100644 tests/contrib/hooks/test_gcp_function_hook.py
 create mode 100644 tests/contrib/hooks/test_gcp_spanner_hook.py
 create mode 100644 tests/contrib/utils/base_gcp_mock.py

diff --git a/airflow/contrib/example_dags/example_gcp_bigtable_operators.py b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
index 4239f78004c60..aca820a0ecb41 100644
--- a/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+++ b/airflow/contrib/example_dags/example_gcp_bigtable_operators.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+# noinspection LongLine
 """
 Example Airflow DAG that creates and performs following operations on Cloud Bigtable:
 - creates an Instance
@@ -26,12 +27,13 @@
 - deletes the Table
 - deletes the Instance
 
-This DAG relies on the following environment variables
+This DAG relies on the following environment variables:
+
 * GCP_PROJECT_ID - Google Cloud Platform project
 * CBT_INSTANCE_ID - desired ID of a Cloud Bigtable instance
 * CBT_INSTANCE_DISPLAY_NAME - desired human-readable display name of the Instance
 * CBT_INSTANCE_TYPE - type of the Instance, e.g. 1 for DEVELOPMENT
-    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance
+    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance # noqa E501
 * CBT_INSTANCE_LABELS - labels to add for the Instance
 * CBT_CLUSTER_ID - desired ID of the main Cluster created for the Instance
 * CBT_CLUSTER_ZONE - zone in which main Cluster will be created. e.g. europe-west1-b
@@ -39,7 +41,7 @@
 * CBT_CLUSTER_NODES - initial amount of nodes of the Cluster
 * CBT_CLUSTER_NODES_UPDATED - amount of nodes for BigtableClusterUpdateOperator
 * CBT_CLUSTER_STORAGE_TYPE - storage for the Cluster, e.g. 1 for SSD
-    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.cluster # noqa: E501
+    See https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.cluster # noqa E501
 * CBT_TABLE_ID - desired ID of the Table
 * CBT_POKE_INTERVAL - number of seconds between every attempt of Sensor check
 
@@ -50,9 +52,13 @@
 
 import airflow
 from airflow import models
-from airflow.contrib.operators.gcp_bigtable_operator import BigtableInstanceCreateOperator, \
-    BigtableInstanceDeleteOperator, BigtableClusterUpdateOperator, BigtableTableCreateOperator, \
-    BigtableTableWaitForReplicationSensor, BigtableTableDeleteOperator
+from airflow.contrib.operators.gcp_bigtable_operator import \
+    BigtableInstanceCreateOperator, \
+    BigtableInstanceDeleteOperator, \
+    BigtableClusterUpdateOperator, \
+    BigtableTableCreateOperator, \
+    BigtableTableWaitForReplicationSensor, \
+    BigtableTableDeleteOperator
 
 # [START howto_operator_gcp_bigtable_args]
 GCP_PROJECT_ID = getenv('GCP_PROJECT_ID', 'example-project')
@@ -89,8 +95,20 @@
         instance_labels=json.loads(CBT_INSTANCE_LABELS),
         cluster_nodes=int(CBT_CLUSTER_NODES),
         cluster_storage_type=int(CBT_CLUSTER_STORAGE_TYPE),
-        task_id='create_instance',
+        task_id='create_instance_task',
+    )
+    create_instance_task2 = BigtableInstanceCreateOperator(
+        instance_id=CBT_INSTANCE_ID,
+        main_cluster_id=CBT_CLUSTER_ID,
+        main_cluster_zone=CBT_CLUSTER_ZONE,
+        instance_display_name=CBT_INSTANCE_DISPLAY_NAME,
+        instance_type=int(CBT_INSTANCE_TYPE),
+        instance_labels=json.loads(CBT_INSTANCE_LABELS),
+        cluster_nodes=int(CBT_CLUSTER_NODES),
+        cluster_storage_type=int(CBT_CLUSTER_STORAGE_TYPE),
+        task_id='create_instance_task2',
     )
+    create_instance_task >> create_instance_task2
     # [END howto_operator_gcp_bigtable_instance_create]
 
     # [START howto_operator_gcp_bigtable_cluster_update]
@@ -99,15 +117,26 @@
         instance_id=CBT_INSTANCE_ID,
         cluster_id=CBT_CLUSTER_ID,
         nodes=int(CBT_CLUSTER_NODES_UPDATED),
-        task_id='update_cluster',
+        task_id='update_cluster_task',
+    )
+    cluster_update_task2 = BigtableClusterUpdateOperator(
+        instance_id=CBT_INSTANCE_ID,
+        cluster_id=CBT_CLUSTER_ID,
+        nodes=int(CBT_CLUSTER_NODES_UPDATED),
+        task_id='update_cluster_task2',
     )
+    cluster_update_task >> cluster_update_task2
     # [END howto_operator_gcp_bigtable_cluster_update]
 
     # [START howto_operator_gcp_bigtable_instance_delete]
     delete_instance_task = BigtableInstanceDeleteOperator(
         project_id=GCP_PROJECT_ID,
         instance_id=CBT_INSTANCE_ID,
-        task_id='delete_instance',
+        task_id='delete_instance_task',
+    )
+    delete_instance_task2 = BigtableInstanceDeleteOperator(
+        instance_id=CBT_INSTANCE_ID,
+        task_id='delete_instance_task2',
     )
     # [END howto_operator_gcp_bigtable_instance_delete]
 
@@ -118,6 +147,12 @@
         table_id=CBT_TABLE_ID,
         task_id='create_table',
     )
+    create_table_task2 = BigtableTableCreateOperator(
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        task_id='create_table_task2',
+    )
+    create_table_task >> create_table_task2
     # [END howto_operator_gcp_bigtable_table_create]
 
     # [START howto_operator_gcp_bigtable_table_wait_for_replication]
@@ -127,7 +162,14 @@
         table_id=CBT_TABLE_ID,
         poke_interval=int(CBT_POKE_INTERVAL),
         timeout=180,
-        task_id='wait_for_table_replication',
+        task_id='wait_for_table_replication_task',
+    )
+    wait_for_table_replication_task2 = BigtableTableWaitForReplicationSensor(
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        poke_interval=int(CBT_POKE_INTERVAL),
+        timeout=180,
+        task_id='wait_for_table_replication_task2',
     )
     # [END howto_operator_gcp_bigtable_table_wait_for_replication]
 
@@ -136,13 +178,28 @@
         project_id=GCP_PROJECT_ID,
         instance_id=CBT_INSTANCE_ID,
         table_id=CBT_TABLE_ID,
-        task_id='delete_table',
+        task_id='delete_table_task',
+    )
+    delete_table_task2 = BigtableTableDeleteOperator(
+        instance_id=CBT_INSTANCE_ID,
+        table_id=CBT_TABLE_ID,
+        task_id='delete_table_task2',
     )
     # [END howto_operator_gcp_bigtable_table_delete]
 
     wait_for_table_replication_task >> delete_table_task
+    wait_for_table_replication_task2 >> delete_table_task
+    wait_for_table_replication_task >> delete_table_task2
+    wait_for_table_replication_task2 >> delete_table_task2
     create_instance_task \
         >> create_table_task \
         >> cluster_update_task \
-        >> delete_table_task \
-        >> delete_instance_task
+        >> delete_table_task
+    create_instance_task2 \
+        >> create_table_task2 \
+        >> cluster_update_task2 \
+        >> delete_table_task2
+
+    # Only delete instances after all tables are deleted
+    [delete_table_task, delete_table_task2] >> \
+        delete_instance_task >> delete_instance_task2
diff --git a/airflow/contrib/example_dags/example_gcp_compute.py b/airflow/contrib/example_dags/example_gcp_compute.py
index f0608e466ce05..dde0f5975ae6f 100644
--- a/airflow/contrib/example_dags/example_gcp_compute.py
+++ b/airflow/contrib/example_dags/example_gcp_compute.py
@@ -68,12 +68,13 @@
     )
     # [END howto_operator_gce_start]
     # Duplicate start for idempotence testing
+    # [START howto_operator_gce_start_no_project_id]
     gce_instance_start2 = GceInstanceStartOperator(
-        project_id=GCP_PROJECT_ID,
         zone=GCE_ZONE,
         resource_id=GCE_INSTANCE,
         task_id='gcp_compute_start_task2'
     )
+    # [END howto_operator_gce_start_no_project_id]
     # [START howto_operator_gce_stop]
     gce_instance_stop = GceInstanceStopOperator(
         project_id=GCP_PROJECT_ID,
@@ -83,12 +84,13 @@
     )
     # [END howto_operator_gce_stop]
     # Duplicate stop for idempotence testing
+    # [START howto_operator_gce_stop_no_project_id]
     gce_instance_stop2 = GceInstanceStopOperator(
-        project_id=GCP_PROJECT_ID,
         zone=GCE_ZONE,
         resource_id=GCE_INSTANCE,
         task_id='gcp_compute_stop_task2'
     )
+    # [END howto_operator_gce_stop_no_project_id]
     # [START howto_operator_gce_set_machine_type]
     gce_set_machine_type = GceSetMachineTypeOperator(
         project_id=GCP_PROJECT_ID,
@@ -99,13 +101,14 @@
     )
     # [END howto_operator_gce_set_machine_type]
     # Duplicate set machine type for idempotence testing
+    # [START howto_operator_gce_set_machine_type_no_project_id]
     gce_set_machine_type2 = GceSetMachineTypeOperator(
-        project_id=GCP_PROJECT_ID,
         zone=GCE_ZONE,
         resource_id=GCE_INSTANCE,
         body=SET_MACHINE_TYPE_BODY,
         task_id='gcp_compute_set_machine_type2'
     )
+    # [END howto_operator_gce_set_machine_type_no_project_id]
 
     gce_instance_start >> gce_instance_start2 >> gce_instance_stop >> \
         gce_instance_stop2 >> gce_set_machine_type >> gce_set_machine_type2
diff --git a/airflow/contrib/example_dags/example_gcp_compute_igm.py b/airflow/contrib/example_dags/example_gcp_compute_igm.py
index 400bc1afc1040..103cbfd590c15 100644
--- a/airflow/contrib/example_dags/example_gcp_compute_igm.py
+++ b/airflow/contrib/example_dags/example_gcp_compute_igm.py
@@ -109,12 +109,13 @@
     )
     # [END howto_operator_gce_igm_copy_template]
     # Added to check for idempotence
+    # [START howto_operator_gce_igm_copy_template_no_project_id]
     gce_instance_template_copy2 = GceInstanceTemplateCopyOperator(
-        project_id=GCP_PROJECT_ID,
         resource_id=GCE_TEMPLATE_NAME,
         body_patch=GCE_INSTANCE_TEMPLATE_BODY_UPDATE,
         task_id='gcp_compute_igm_copy_template_task_2'
     )
+    # [END howto_operator_gce_igm_copy_template_no_project_id]
     # [START howto_operator_gce_igm_update_template]
     gce_instance_group_manager_update_template = \
         GceInstanceGroupManagerUpdateTemplateOperator(
@@ -128,15 +129,16 @@
         )
     # [END howto_operator_gce_igm_update_template]
     # Added to check for idempotence (and without UPDATE_POLICY)
+    # [START howto_operator_gce_igm_update_template_no_project_id]
     gce_instance_group_manager_update_template2 = \
         GceInstanceGroupManagerUpdateTemplateOperator(
-            project_id=GCP_PROJECT_ID,
             resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
             zone=GCE_ZONE,
             source_template=SOURCE_TEMPLATE_URL,
             destination_template=DESTINATION_TEMPLATE_URL,
             task_id='gcp_compute_igm_group_manager_update_template_2'
         )
+    # [END howto_operator_gce_igm_update_template_no_project_id]
     gce_instance_template_copy >> gce_instance_template_copy2 >> \
         gce_instance_group_manager_update_template >> \
         gce_instance_group_manager_update_template2
diff --git a/airflow/contrib/example_dags/example_gcp_function.py b/airflow/contrib/example_dags/example_gcp_function.py
index afd6d36aed2e3..b8f48cebfdda2 100644
--- a/airflow/contrib/example_dags/example_gcp_function.py
+++ b/airflow/contrib/example_dags/example_gcp_function.py
@@ -116,10 +116,18 @@
         validate_body=GCP_VALIDATE_BODY
     )
     # [END howto_operator_gcf_deploy]
+    # [START howto_operator_gcf_deploy_no_project_id]
+    deploy2_task = GcfFunctionDeployOperator(
+        task_id="gcf_deploy2_task",
+        location=GCP_LOCATION,
+        body=body,
+        validate_body=GCP_VALIDATE_BODY
+    )
+    # [END howto_operator_gcf_deploy_no_project_id]
     # [START howto_operator_gcf_delete]
     delete_task = GcfFunctionDeleteOperator(
         task_id="gcf_delete_task",
         name=FUNCTION_NAME
     )
     # [END howto_operator_gcf_delete]
-    deploy_task >> delete_task
+    deploy_task >> deploy2_task >> delete_task
diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
index f421451c8979b..936e5094e588f 100644
--- a/airflow/contrib/example_dags/example_gcp_spanner.py
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -77,17 +77,14 @@
         display_name=GCP_SPANNER_DISPLAY_NAME,
         task_id='spanner_instance_create_task'
     )
-    # [END howto_operator_spanner_deploy]
-
-    # Update
     spanner_instance_update_task = CloudSpannerInstanceDeployOperator(
-        project_id=GCP_PROJECT_ID,
         instance_id=GCP_SPANNER_INSTANCE_ID,
         configuration_name=GCP_SPANNER_CONFIG_NAME,
         node_count=int(GCP_SPANNER_NODE_COUNT) + 1,
         display_name=GCP_SPANNER_DISPLAY_NAME + '_updated',
         task_id='spanner_instance_update_task'
     )
+    # [END howto_operator_spanner_deploy]
 
     # [START howto_operator_spanner_database_deploy]
     spanner_database_deploy_task = CloudSpannerInstanceDatabaseDeployOperator(
@@ -100,6 +97,15 @@
         ],
         task_id='spanner_database_deploy_task'
     )
+    spanner_database_deploy_task2 = CloudSpannerInstanceDatabaseDeployOperator(
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        ddl_statements=[
+            "CREATE TABLE my_table1 (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+            "CREATE TABLE my_table2 (id INT64, name STRING(MAX)) PRIMARY KEY (id)",
+        ],
+        task_id='spanner_database_deploy_task2'
+    )
     # [END howto_operator_spanner_database_deploy]
 
     # [START howto_operator_spanner_database_update]
@@ -126,7 +132,6 @@
         task_id='spanner_database_update_idempotent1_task'
     )
     spanner_database_update_idempotent2_task = CloudSpannerInstanceDatabaseUpdateOperator(
-        project_id=GCP_PROJECT_ID,
         instance_id=GCP_SPANNER_INSTANCE_ID,
         database_id=GCP_SPANNER_DATABASE_ID,
         operation_id=OPERATION_ID,
@@ -143,17 +148,15 @@
         instance_id=GCP_SPANNER_INSTANCE_ID,
         database_id=GCP_SPANNER_DATABASE_ID,
         query=["DELETE FROM my_table2 WHERE true"],
-        task_id='spanner_instance_query'
+        task_id='spanner_instance_query_task'
     )
-    # [END howto_operator_spanner_query]
-
-    spanner_instance_query2_task = CloudSpannerInstanceDatabaseQueryOperator(
-        project_id=GCP_PROJECT_ID,
+    spanner_instance_query_task2 = CloudSpannerInstanceDatabaseQueryOperator(
         instance_id=GCP_SPANNER_INSTANCE_ID,
         database_id=GCP_SPANNER_DATABASE_ID,
-        query="example_gcp_spanner.sql",
-        task_id='spanner_instance_query2'
+        query=["DELETE FROM my_table2 WHERE true"],
+        task_id='spanner_instance_query_task2'
     )
+    # [END howto_operator_spanner_query]
 
     # [START howto_operator_spanner_database_delete]
     spanner_database_delete_task = CloudSpannerInstanceDatabaseDeleteOperator(
@@ -162,6 +165,11 @@
         database_id=GCP_SPANNER_DATABASE_ID,
         task_id='spanner_database_delete_task'
     )
+    spanner_database_delete_task2 = CloudSpannerInstanceDatabaseDeleteOperator(
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        database_id=GCP_SPANNER_DATABASE_ID,
+        task_id='spanner_database_delete_task2'
+    )
     # [END howto_operator_spanner_database_delete]
 
     # [START howto_operator_spanner_delete]
@@ -170,15 +178,22 @@
         instance_id=GCP_SPANNER_INSTANCE_ID,
         task_id='spanner_instance_delete_task'
     )
+    spanner_instance_delete_task2 = CloudSpannerInstanceDeleteOperator(
+        instance_id=GCP_SPANNER_INSTANCE_ID,
+        task_id='spanner_instance_delete_task2'
+    )
     # [END howto_operator_spanner_delete]
 
     spanner_instance_create_task \
         >> spanner_instance_update_task \
         >> spanner_database_deploy_task \
+        >> spanner_database_deploy_task2 \
         >> spanner_database_update_task \
         >> spanner_database_update_idempotent1_task \
         >> spanner_database_update_idempotent2_task \
         >> spanner_instance_query_task \
-        >> spanner_instance_query2_task \
+        >> spanner_instance_query_task2 \
         >> spanner_database_delete_task \
-        >> spanner_instance_delete_task
+        >> spanner_database_delete_task2 \
+        >> spanner_instance_delete_task \
+        >> spanner_instance_delete_task2
diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index b663b4ecebe7f..3ec9429a76f97 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -187,8 +187,11 @@ def next_dep(task, prev):
         project_id=GCP_PROJECT_ID,
         body=body2,
         instance=INSTANCE_NAME2,
-        task_id='sql_instance_create_2_task'
+        task_id='sql_instance_create_task2'
     )
+    # [END howto_operator_cloudsql_create]
+
+    prev_task = sql_instance_create_task
     prev_task = next_dep(sql_instance_create_2_task, prev_task)
 
     # ############################################## #
@@ -202,8 +205,15 @@ def next_dep(task, prev):
         instance=INSTANCE_NAME,
         task_id='sql_instance_patch_task'
     )
+
+    sql_instance_patch_task2 = CloudSqlInstancePatchOperator(
+        body=patch_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_instance_patch_task2'
+    )
     # [END howto_operator_cloudsql_patch]
     prev_task = next_dep(sql_instance_patch_task, prev_task)
+    prev_task = next_dep(sql_instance_patch_task2, prev_task)
 
     # [START howto_operator_cloudsql_db_create]
     sql_db_create_task = CloudSqlInstanceDatabaseCreateOperator(
@@ -212,8 +222,14 @@ def next_dep(task, prev):
         instance=INSTANCE_NAME,
         task_id='sql_db_create_task'
     )
+    sql_db_create_task2 = CloudSqlInstanceDatabaseCreateOperator(
+        body=db_create_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_db_create_task2'
+    )
     # [END howto_operator_cloudsql_db_create]
     prev_task = next_dep(sql_db_create_task, prev_task)
+    prev_task = next_dep(sql_db_create_task2, prev_task)
 
     # [START howto_operator_cloudsql_db_patch]
     sql_db_patch_task = CloudSqlInstanceDatabasePatchOperator(
@@ -223,8 +239,15 @@ def next_dep(task, prev):
         database=DB_NAME,
         task_id='sql_db_patch_task'
     )
+    sql_db_patch_task2 = CloudSqlInstanceDatabasePatchOperator(
+        body=db_patch_body,
+        instance=INSTANCE_NAME,
+        database=DB_NAME,
+        task_id='sql_db_patch_task2'
+    )
     # [END howto_operator_cloudsql_db_patch]
     prev_task = next_dep(sql_db_patch_task, prev_task)
+    prev_task = next_dep(sql_db_patch_task2, prev_task)
 
     # ############################################## #
     # ### EXPORTING SQL FROM INSTANCE 1 ############ #
@@ -252,8 +275,14 @@ def next_dep(task, prev):
         instance=INSTANCE_NAME,
         task_id='sql_export_task'
     )
+    sql_export_task2 = CloudSqlInstanceExportOperator(
+        body=export_body,
+        instance=INSTANCE_NAME,
+        task_id='sql_export_task2'
+    )
     # [END howto_operator_cloudsql_export]
     prev_task = next_dep(sql_export_task, prev_task)
+    prev_task = next_dep(sql_export_task2, prev_task)
 
     # ############################################## #
     # ### IMPORTING SQL TO INSTANCE 2 ############## #
@@ -265,7 +294,7 @@ def next_dep(task, prev):
     # [START howto_operator_cloudsql_import_gcs_permissions]
     sql_gcp_add_object_permission_task = GoogleCloudStorageObjectCreateAclEntryOperator(
         entity="user-{{ task_instance.xcom_pull("
-               "'sql_instance_create_2_task', key='service_account_email')"
+               "'sql_instance_create_task2', key='service_account_email')"
                " }}",
         role="READER",
         bucket=import_url_split[1],  # netloc (bucket)
@@ -278,7 +307,7 @@ def next_dep(task, prev):
     # write access to the whole bucket!.
     sql_gcp_add_bucket_permission_2_task = GoogleCloudStorageBucketCreateAclEntryOperator(
         entity="user-{{ task_instance.xcom_pull("
-               "'sql_instance_create_2_task', key='service_account_email') "
+               "'sql_instance_create_task2', key='service_account_email') "
                "}}",
         role="WRITER",
         bucket=import_url_split[1],  # netloc
@@ -294,8 +323,14 @@ def next_dep(task, prev):
         instance=INSTANCE_NAME2,
         task_id='sql_import_task'
     )
+    sql_import_task2 = CloudSqlInstanceImportOperator(
+        body=import_body,
+        instance=INSTANCE_NAME2,
+        task_id='sql_import_task2'
+    )
     # [END howto_operator_cloudsql_import]
     prev_task = next_dep(sql_import_task, prev_task)
+    prev_task = next_dep(sql_import_task2, prev_task)
 
     # ############################################## #
     # ### DELETING A DATABASE FROM AN INSTANCE ##### #
@@ -308,8 +343,14 @@ def next_dep(task, prev):
         database=DB_NAME,
         task_id='sql_db_delete_task'
     )
+    sql_db_delete_task2 = CloudSqlInstanceDatabaseDeleteOperator(
+        instance=INSTANCE_NAME,
+        database=DB_NAME,
+        task_id='sql_db_delete_task2'
+    )
     # [END howto_operator_cloudsql_db_delete]
     prev_task = next_dep(sql_db_delete_task, prev_task)
+    prev_task = next_dep(sql_db_delete_task2, prev_task)
 
     # ############################################## #
     # ### INSTANCES TEAR DOWN ###################### #
@@ -321,6 +362,10 @@ def next_dep(task, prev):
         instance=INSTANCE_NAME,
         task_id='sql_instance_delete_task'
     )
+    sql_instance_delete_task2 = CloudSqlInstanceDeleteOperator(
+        instance=INSTANCE_NAME2,
+        task_id='sql_instance_delete_task2'
+    )
     # [END howto_operator_cloudsql_delete]
     prev_task = next_dep(sql_instance_delete_task, prev_task)
 
diff --git a/airflow/contrib/example_dags/example_gcp_sql_query.py b/airflow/contrib/example_dags/example_gcp_sql_query.py
index b830417d9c54a..f4fc5f392650c 100644
--- a/airflow/contrib/example_dags/example_gcp_sql_query.py
+++ b/airflow/contrib/example_dags/example_gcp_sql_query.py
@@ -239,6 +239,21 @@ def get_absolute_path(path):
     "sslkey={client_key_file}&" \
     "sslrootcert={server_ca_file}".format(**mysql_kwargs)
 
+# Special case: MySQL: connect directly via TCP (SSL) and with fixed Cloud Sql
+# Proxy binary path AND with missing project_id
+
+os.environ['AIRFLOW_CONN_PUBLIC_MYSQL_TCP_SSL_NO_PROJECT_ID'] = \
+    "gcpcloudsql://{user}:{password}@{public_ip}:{public_port}/{database}?" \
+    "database_type=mysql&" \
+    "location={location}&" \
+    "instance={instance}&" \
+    "use_proxy=False&" \
+    "use_ssl=True&" \
+    "sslcert={client_cert_file}&" \
+    "sslkey={client_key_file}&" \
+    "sslrootcert={server_ca_file}".format(**mysql_kwargs)
+
+
 # [END howto_operator_cloudsql_query_connections]
 
 # [START howto_operator_cloudsql_query_operators]
@@ -251,7 +266,8 @@ def get_absolute_path(path):
     "proxy_mysql_tcp",
     "proxy_mysql_socket",
     "public_mysql_tcp",
-    "public_mysql_tcp_ssl"
+    "public_mysql_tcp_ssl",
+    "public_mysql_tcp_ssl_no_project_id"
 ]
 
 tasks = []
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 70287ab5cec50..e2d7676a13632 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -18,6 +18,7 @@
 # under the License.
 #
 import json
+import functools
 
 import httplib2
 import google.auth
@@ -144,7 +145,7 @@ def _get_field(self, f, default=None):
         key_path, etc. They get formatted as shown below.
         """
         long_f = 'extra__google_cloud_platform__{}'.format(f)
-        if long_f in self.extras:
+        if hasattr(self, 'extras') and long_f in self.extras:
             return self.extras[long_f]
         else:
             return default
@@ -152,3 +153,43 @@ def _get_field(self, f, default=None):
     @property
     def project_id(self):
         return self._get_field('project')
+
+    def fallback_to_default_project_id(func):
+        """
+        Decorator that provides fallback for Google Cloud Platform project id. If
+        the project is None it will be replaced with the project_id from the
+        service account the Hook is authenticated with. Project id can be specified
+        either via project_id kwarg or via first parameter in positional args.
+
+        :param func: function to wrap
+        :return: result of the function call
+        """
+        @functools.wraps(func)
+        def inner_wrapper(self, *args, **kwargs):
+            if len(args) > 0:
+                raise AirflowException(
+                    "Use keyword arguments when initializing method with the "
+                    "'fallback_to_default_project_id' decorator")
+            if 'project_id' in kwargs:
+                kwargs['project_id'] = self._get_project_id(kwargs['project_id'])
+            else:
+                kwargs['project_id'] = self._get_project_id(None)
+            if not kwargs['project_id']:
+                raise AirflowException("The project id must be passed either as "
+                                       "keyword project_id parameter or as project_id extra "
+                                       "in GCP connection definition. Both are not set!")
+            return func(self, *args, **kwargs)
+        return inner_wrapper
+
+    fallback_to_default_project_id = staticmethod(fallback_to_default_project_id)
+
+    def _get_project_id(self, project_id):
+        """
+        In case project_id is None, overrides it with default project_id from
+        the service account that is authorized.
+
+        :param project_id: project id to
+        :type project_id: str
+        :return: the project_id specified or default project id if project_id is None
+        """
+        return project_id if project_id else self.project_id
diff --git a/airflow/contrib/hooks/gcp_bigtable_hook.py b/airflow/contrib/hooks/gcp_bigtable_hook.py
index 5d1b6f01c9aa1..81e1e017492ae 100644
--- a/airflow/contrib/hooks/gcp_bigtable_hook.py
+++ b/airflow/contrib/hooks/gcp_bigtable_hook.py
@@ -37,47 +37,60 @@ def __init__(self,
                  delegate_to=None):
         super(BigtableHook, self).__init__(gcp_conn_id, delegate_to)
 
-    def get_client(self, project_id):
+    def _get_client(self, project_id):
         if not self._client:
-            self._client = Client(project=project_id, credentials=self._get_credentials(), admin=True)
+            self._client = Client(project=project_id, credentials=self._get_credentials(),
+                                  admin=True)
         return self._client
 
-    def get_instance(self, project_id, instance_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_instance(self, instance_id, project_id=None):
         """
         Retrieves and returns the specified Cloud Bigtable instance if it exists.
         Otherwise, returns None.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: The ID of the GCP project.
-        :type project_id: str
         :param instance_id: The ID of the Cloud Bigtable instance.
         :type instance_id: str
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            BigTable exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
         """
 
-        client = self.get_client(project_id)
-
-        instance = Instance(instance_id, client)
+        instance = self._get_client(project_id=project_id).instance(instance_id)
         if not instance.exists():
             return None
         return instance
 
-    def delete_instance(self, project_id, instance_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_instance(self, instance_id, project_id=None):
         """
         Deletes the specified Cloud Bigtable instance.
-        Raises google.api_core.exceptions.NotFound if the Cloud Bigtable instance does not exist.
+        Must be called with keyword arguments rather than positional.
+        Raises google.api_core.exceptions.NotFound if the Cloud Bigtable instance does
+        not exist.
 
-        :param project_id: The ID of the GCP project.
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            BigTable exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
         :type project_id: str
         :param instance_id: The ID of the Cloud Bigtable instance.
         :type instance_id: str
         """
-        instance = Instance(instance_id, self.get_client(project_id))
-        instance.delete()
+        instance = self.get_instance(instance_id=instance_id, project_id=project_id)
+        if instance:
+            instance.delete()
+        else:
+            self.log.info("The instance '%s' does not exist in project '%s'. Exiting", instance_id,
+                          project_id)
 
+    @GoogleCloudBaseHook.fallback_to_default_project_id
     def create_instance(self,
-                        project_id,
                         instance_id,
                         main_cluster_id,
                         main_cluster_zone,
+                        project_id=None,
                         replica_cluster_id=None,
                         replica_cluster_zone=None,
                         instance_display_name=None,
@@ -89,8 +102,6 @@ def create_instance(self,
         """
         Creates new instance.
 
-        :type project_id: str
-        :param project_id: The ID of the GCP project.
         :type instance_id: str
         :param instance_id: The ID for the new instance.
         :type main_cluster_id: str
@@ -98,8 +109,13 @@ def create_instance(self,
         :type main_cluster_zone: str
         :param main_cluster_zone: The zone for main cluster.
             See https://cloud.google.com/bigtable/docs/locations for more details.
+        :type project_id: str
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            BigTable exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
         :type replica_cluster_id: str
-        :param replica_cluster_id: (optional) The ID for replica cluster for the new instance.
+        :param replica_cluster_id: (optional) The ID for replica cluster for the new
+            instance.
         :type replica_cluster_zone: str
         :param replica_cluster_zone: (optional)  The zone for replica cluster.
         :type instance_type: enums.Instance.Type
@@ -108,7 +124,8 @@ def create_instance(self,
         :param instance_display_name: (optional) Human-readable name of the instance.
                 Defaults to ``instance_id``.
         :type instance_labels: dict
-        :param instance_labels: (optional) Dictionary of labels to associate with the instance.
+        :param instance_labels: (optional) Dictionary of labels to associate with the
+            instance.
         :type cluster_nodes: int
         :param cluster_nodes: (optional) Number of nodes for cluster.
         :type cluster_storage_type: enums.StorageType
@@ -122,7 +139,7 @@ def create_instance(self,
 
         instance = Instance(
             instance_id,
-            self.get_client(project_id),
+            self._get_client(project_id=project_id),
             instance_display_name,
             instance_type,
             instance_labels,
@@ -149,8 +166,11 @@ def create_instance(self,
         operation.result(timeout)
         return instance
 
-    # noinspection PyMethodMayBeStatic
-    def create_table(self, instance, table_id, initial_split_keys, column_families):
+    @staticmethod
+    def create_table(instance,
+                     table_id,
+                     initial_split_keys=None,
+                     column_families=None):
         """
         Creates the specified Cloud Bigtable table.
         Raises google.api_core.exceptions.AlreadyExists if the table exists.
@@ -160,28 +180,36 @@ def create_table(self, instance, table_id, initial_split_keys, column_families):
         :type table_id: str
         :param table_id: The ID of the table to create in Cloud Bigtable.
         :type initial_split_keys: list
-        :param initial_split_keys: (Optional) A list of row keys in bytes to use to initially split the table.
+        :param initial_split_keys: (Optional) A list of row keys in bytes to use to
+            initially split the table.
         :type column_families: dict
-        :param column_families: (Optional) A map of columns to create. The key is the column_id str, and the
+        :param column_families: (Optional) A map of columns to create. The key is the
+            column_id str, and the
         value is a GarbageCollectionRule.
         """
+        if column_families is None:
+            column_families = {}
+        if initial_split_keys is None:
+            initial_split_keys = []
         table = Table(table_id, instance)
         table.create(initial_split_keys, column_families)
 
-    def delete_table(self, project_id, instance_id, table_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_table(self, instance_id, table_id, project_id=None):
         """
         Deletes the specified table in Cloud Bigtable.
         Raises google.api_core.exceptions.NotFound if the table does not exist.
 
-        :type project_id: str
-        :param project_id: The ID of the GCP project.
         :type instance_id: str
         :param instance_id: The ID of the Cloud Bigtable instance.
         :type table_id: str
         :param table_id: The ID of the table in Cloud Bigtable.
+        :type project_id: str
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            BigTable exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
         """
-        instance = Instance(instance_id, self.get_client(project_id))
-        table = Table(table_id, instance)
+        table = self.get_instance(instance_id=instance_id, project_id=project_id).table(table_id=table_id)
         table.delete()
 
     @staticmethod
@@ -209,7 +237,8 @@ def get_column_families_for_table(instance, table_id):
         :type instance: Instance
         :param instance: The Cloud Bigtable instance that owns the table.
         :type table_id: str
-        :param table_id: The ID of the table in Cloud Bigtable to fetch Column Families from.
+        :param table_id: The ID of the table in Cloud Bigtable to fetch Column Families
+            from.
         """
 
         table = Table(table_id, instance)
@@ -224,7 +253,8 @@ def get_cluster_states_for_table(instance, table_id):
         :type instance: Instance
         :param instance: The Cloud Bigtable instance that owns the table.
         :type table_id: str
-        :param table_id: The ID of the table in Cloud Bigtable to fetch Cluster States from.
+        :param table_id: The ID of the table in Cloud Bigtable to fetch Cluster States
+            from.
         """
 
         table = Table(table_id, instance)
diff --git a/airflow/contrib/hooks/gcp_compute_hook.py b/airflow/contrib/hooks/gcp_compute_hook.py
index 617e39cb4006e..7dd17d18b867c 100644
--- a/airflow/contrib/hooks/gcp_compute_hook.py
+++ b/airflow/contrib/hooks/gcp_compute_hook.py
@@ -41,11 +41,15 @@ class GceOperationStatus:
 class GceHook(GoogleCloudBaseHook):
     """
     Hook for Google Compute Engine APIs.
+
+    All the methods in the hook where project_id is used must be called with
+    keyword arguments rather than positional.
+
     """
     _conn = None
 
     def __init__(self,
-                 api_version,
+                 api_version='v1',
                  gcp_conn_id='google_cloud_default',
                  delegate_to=None):
         super(GceHook, self).__init__(gcp_conn_id, delegate_to)
@@ -64,19 +68,21 @@ def get_conn(self):
                                http=http_authorized, cache_discovery=False)
         return self._conn
 
-    def start_instance(self, project_id, zone, resource_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def start_instance(self, zone, resource_id, project_id=None):
         """
         Starts an existing instance defined by project_id, zone and resource_id.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance exists
-        :type project_id: str
         :param zone: Google Cloud Platform zone where the instance exists
         :type zone: str
         :param resource_id: Name of the Compute Engine instance resource
         :type resource_id: str
-        :return: True if the operation succeeded, raises an error otherwise.
-        :rtype: bool
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().instances().start(
             project=project_id,
@@ -89,21 +95,25 @@ def start_instance(self, project_id, zone, resource_id):
             raise AirflowException(
                 "Wrong response '{}' returned - it should contain "
                 "'name' field".format(response))
-        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name,
+                                             zone=zone)
 
-    def stop_instance(self, project_id, zone, resource_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def stop_instance(self, zone, resource_id, project_id=None):
         """
         Stops an instance defined by project_id, zone and resource_id
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance exists
-        :type project_id: str
         :param zone: Google Cloud Platform zone where the instance exists
         :type zone: str
         :param resource_id: Name of the Compute Engine instance resource
         :type resource_id: str
-        :return: True if the operation succeeded, raises an error otherwise.
-        :rtype: bool
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().instances().stop(
             project=project_id,
@@ -116,15 +126,16 @@ def stop_instance(self, project_id, zone, resource_id):
             raise AirflowException(
                 "Wrong response '{}' returned - it should contain "
                 "'name' field".format(response))
-        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name,
+                                             zone=zone)
 
-    def set_machine_type(self, project_id, zone, resource_id, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def set_machine_type(self, zone, resource_id, body, project_id=None):
         """
         Sets machine type of an instance defined by project_id, zone and resource_id.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance exists
-        :type project_id: str
         :param zone: Google Cloud Platform zone where the instance exists.
         :type zone: str
         :param resource_id: Name of the Compute Engine instance resource
@@ -133,32 +144,40 @@ def set_machine_type(self, project_id, zone, resource_id, body):
             as described in
             https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise.
-        :rtype: bool
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
-        response = self._execute_set_machine_type(project_id, zone, resource_id, body)
+        response = self._execute_set_machine_type(zone, resource_id, body, project_id)
         try:
             operation_name = response["name"]
         except KeyError:
             raise AirflowException(
                 "Wrong response '{}' returned - it should contain "
                 "'name' field".format(response))
-        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name,
+                                             zone=zone)
 
-    def _execute_set_machine_type(self, project_id, zone, resource_id, body):
+    def _execute_set_machine_type(self, zone, resource_id, body, project_id):
         return self.get_conn().instances().setMachineType(
             project=project_id, zone=zone, instance=resource_id, body=body)\
             .execute(num_retries=NUM_RETRIES)
 
-    def get_instance_template(self, project_id, resource_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_instance_template(self, resource_id, project_id=None):
         """
         Retrieves instance template by project_id and resource_id.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance template exists
-        :type project_id: str
         :param resource_id: Name of the instance template
         :type resource_id: str
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
         :return: Instance template representation as object according to
             https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates
         :rtype: dict
@@ -169,13 +188,12 @@ def get_instance_template(self, project_id, resource_id):
         ).execute(num_retries=NUM_RETRIES)
         return response
 
-    def insert_instance_template(self, project_id, body, request_id=None):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def insert_instance_template(self, body, request_id=None, project_id=None):
         """
         Inserts instance template using body specified
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance exists
-        :type project_id: str
         :param body: Instance template representation as object according to
             https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates
         :type body: dict
@@ -184,8 +202,11 @@ def insert_instance_template(self, project_id, body, request_id=None):
             with the same request id will not create a new instance template again)
             It should be in UUID format as defined in RFC 4122
         :type request_id: str
-        :return: True if the operation succeeded
-        :rtype: bool
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().instanceTemplates().insert(
             project=project_id,
@@ -198,19 +219,23 @@ def insert_instance_template(self, project_id, body, request_id=None):
             raise AirflowException(
                 "Wrong response '{}' returned - it should contain "
                 "'name' field".format(response))
-        return self._wait_for_operation_to_complete(project_id, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def get_instance_group_manager(self, project_id, zone, resource_id):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_instance_group_manager(self, zone, resource_id, project_id=None):
         """
         Retrieves Instance Group Manager by project_id, zone and resource_id.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance Group Manager exists
-        :type project_id: str
         :param zone: Google Cloud Platform zone where the Instance Group Manager exists
         :type zone: str
         :param resource_id: Name of the Instance Group Manager
         :type resource_id: str
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
         :return: Instance group manager representation as object according to
             https://cloud.google.com/compute/docs/reference/rest/beta/instanceGroupManagers
         :rtype: dict
@@ -222,14 +247,13 @@ def get_instance_group_manager(self, project_id, zone, resource_id):
         ).execute(num_retries=NUM_RETRIES)
         return response
 
-    def patch_instance_group_manager(self, project_id, zone, resource_id,
-                                     body, request_id=None):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def patch_instance_group_manager(self, zone, resource_id,
+                                     body, request_id=None, project_id=None):
         """
         Patches Instance Group Manager with the specified body.
+        Must be called with keyword arguments rather than positional.
 
-        :param project_id: Google Cloud Platform project ID where the Compute Engine
-            Instance Group Manager exists
-        :type project_id: str
         :param zone: Google Cloud Platform zone where the Instance Group Manager exists
         :type zone: str
         :param resource_id: Name of the Instance Group Manager
@@ -243,8 +267,11 @@ def patch_instance_group_manager(self, project_id, zone, resource_id,
             with the same request id will not create a new instance template again).
             It should be in UUID format as defined in RFC 4122
         :type request_id: str
-        :return: True if the operation succeeded
-        :rtype: bool
+        :param project_id: Optional, Google Cloud Platform project ID where the
+            Compute Engine Instance exists. If set to None or missing,
+            the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return None
         """
         response = self.get_conn().instanceGroupManagers().patch(
             project=project_id,
@@ -259,7 +286,9 @@ def patch_instance_group_manager(self, project_id, zone, resource_id,
             raise AirflowException(
                 "Wrong response '{}' returned - it should contain "
                 "'name' field".format(response))
-        return self._wait_for_operation_to_complete(project_id, operation_name, zone)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name,
+                                             zone=zone)
 
     def _wait_for_operation_to_complete(self, project_id, operation_name, zone=None):
         """
@@ -269,8 +298,7 @@ def _wait_for_operation_to_complete(self, project_id, operation_name, zone=None)
         :type operation_name: str
         :param zone: optional region of the request (might be None for global operations)
         :type zone: str
-        :return: True if the operation succeeded, raises an error otherwise
-        :rtype: bool
+        :return: None
         """
         service = self.get_conn()
         while True:
@@ -291,7 +319,7 @@ def _wait_for_operation_to_complete(self, project_id, operation_name, zone=None)
                     error_msg = str(error.get("errors"))[1:-1]
                     raise AirflowException("{} {}: ".format(code, msg) + error_msg)
                 # No meaningful info to return from the response in case of success
-                return True
+                return
             time.sleep(TIME_TO_SLEEP_IN_SECONDS)
 
     @staticmethod
diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
index 7f1b395d677f6..13e6dc63966a5 100644
--- a/airflow/contrib/hooks/gcp_function_hook.py
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -46,11 +46,25 @@ def __init__(self,
         super(GcfHook, self).__init__(gcp_conn_id, delegate_to)
         self.api_version = api_version
 
+    @staticmethod
+    def _full_location(project_id, location):
+        """
+        Retrieve full location of the function in the form of
+        projects/<GCP_PROJECT_ID>/locations/<GCP_LOCATION>
+
+        :param project_id: The Google Cloud Project project_id where the function belongs.
+        :type project_id: str
+        :param location: The location where the function is created.
+        :type location: str
+        :return:
+        """
+        return 'projects/{}/locations/{}'.format(project_id, location)
+
     def get_conn(self):
         """
         Retrieves the connection to Cloud Functions.
 
-        :return: Google Cloud Function services object
+        :return: Google Cloud Function services object.
         :rtype: dict
         """
         if not self._conn:
@@ -63,45 +77,46 @@ def get_function(self, name):
         """
         Returns the Cloud Function with the given name.
 
-        :param name: name of the function
+        :param name: Name of the function.
         :type name: str
-        :return: a Cloud Functions object representing the function
+        :return: A Cloud Functions object representing the function.
         :rtype: dict
         """
         return self.get_conn().projects().locations().functions().get(
             name=name).execute(num_retries=NUM_RETRIES)
 
-    def create_new_function(self, full_location, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_new_function(self, location, body, project_id=None):
         """
         Creates a new function in Cloud Function in the location specified in the body.
 
-        :param full_location: full location including the project in the form of
-            of /projects/<PROJECT>/location/<GCP_LOCATION>
-        :type full_location: str
-        :param body: body required by the Cloud Functions insert API
+        :param location: The location of the function.
+        :type location: str
+        :param body: The body required by the Cloud Functions insert API.
         :type body: dict
-        :return: response returned by the operation
-        :rtype: dict
+        :param project_id: Optional, Google Cloud Project project_id where the function belongs.
+            If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().projects().locations().functions().create(
-            location=full_location,
+            location=self._full_location(project_id, location),
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(operation_name)
+        self._wait_for_operation_to_complete(operation_name=operation_name)
 
     def update_function(self, name, body, update_mask):
         """
         Updates Cloud Functions according to the specified update mask.
 
-        :param name: name of the function
+        :param name: The name of the function.
         :type name: str
-        :param body: body required by the cloud function patch API
-        :type body: str
-        :param update_mask: update mask - array of fields that should be patched
+        :param body: The body required by the cloud function patch API.
+        :type body: dict
+        :param update_mask: The update mask - array of fields that should be patched.
         :type update_mask: [str]
-        :return: response returned by the operation
-        :rtype: dict
+        :return: None
         """
         response = self.get_conn().projects().locations().functions().patch(
             updateMask=",".join(update_mask),
@@ -109,21 +124,24 @@ def update_function(self, name, body, update_mask):
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(operation_name)
+        self._wait_for_operation_to_complete(operation_name=operation_name)
 
-    def upload_function_zip(self, parent, zip_path):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def upload_function_zip(self, location, zip_path, project_id=None):
         """
         Uploads zip file with sources.
 
-        :param parent: Google Cloud Platform project id and region where zip file should
-            be uploaded in the form of /projects/<PROJECT>/location/<GCP_LOCATION>
-        :type parent: str
-        :param zip_path: path of the valid .zip file to upload
+        :param location: The location where the function is created.
+        :type location: str
+        :param zip_path: The path of the valid .zip file to upload.
         :type zip_path: str
-        :return: Upload URL that was returned by generateUploadUrl method
+        :param project_id: Optional, Google Cloud Project project_id where the function belongs.
+            If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: The upload URL that was returned by generateUploadUrl method.
         """
         response = self.get_conn().projects().locations().functions().generateUploadUrl(
-            parent=parent
+            parent=self._full_location(project_id, location)
         ).execute(num_retries=NUM_RETRIES)
         upload_url = response.get('uploadUrl')
         with open(zip_path, 'rb') as fp:
@@ -144,26 +162,25 @@ def delete_function(self, name):
         """
         Deletes the specified Cloud Function.
 
-        :param name: name of the function
+        :param name: The name of the function.
         :type name: str
-        :return: response returned by the operation
-        :rtype: dict
+        :return: None
         """
         response = self.get_conn().projects().locations().functions().delete(
             name=name).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(operation_name)
+        self._wait_for_operation_to_complete(operation_name=operation_name)
 
     def _wait_for_operation_to_complete(self, operation_name):
         """
         Waits for the named operation to complete - checks status of the
         asynchronous call.
 
-        :param operation_name: name of the operation
+        :param operation_name: The name of the operation.
         :type operation_name: str
-        :return: response  returned by the operation
+        :return: The response returned by the operation.
         :rtype: dict
-        :exception: AirflowException in case error is returned
+        :exception: AirflowException in case error is returned.
         """
         service = self.get_conn()
         while True:
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index 23f3a3c86d400..e1ee216b62de2 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -18,16 +18,12 @@
 # under the License.
 from google.api_core.exceptions import GoogleAPICallError, AlreadyExists
 from google.cloud.spanner_v1.client import Client
-from google.cloud.spanner_v1.database import Database
-from google.cloud.spanner_v1.instance import Instance  # noqa: F401
 from google.longrunning.operations_grpc_pb2 import Operation  # noqa: F401
-from typing import Optional, Callable  # noqa: F401
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 
-# noinspection PyAbstractClass
 class CloudSpannerHook(GoogleCloudBaseHook):
     """
     Hook for Google Cloud Spanner APIs.
@@ -39,13 +35,11 @@ def __init__(self,
                  delegate_to=None):
         super(CloudSpannerHook, self).__init__(gcp_conn_id, delegate_to)
 
-    def get_client(self, project_id):
-        # type: (str) -> Client
+    def _get_client(self, project_id):
         """
         Provides a client for interacting with the Cloud Spanner API.
 
-        :param project_id: The ID of the  GCP project that owns the Cloud Spanner
-            database.
+        :param project_id: The ID of the  GCP project.
         :type project_id: str
         :return: Client for interacting with the Cloud Spanner API. See:
             https://googleapis.github.io/google-cloud-python/latest/spanner/client-api.html#google.cloud.spanner_v1.client.Client
@@ -55,12 +49,13 @@ def get_client(self, project_id):
             self._client = Client(project=project_id, credentials=self._get_credentials())
         return self._client
 
-    def get_instance(self, project_id, instance_id):
-        # type: (str, str) -> Optional[Instance]
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_instance(self, instance_id, project_id=None):
         """
         Gets information about a particular instance.
 
-        :param project_id: The ID of the project which owns the Cloud Spanner Database.
+        :param project_id: Optional, The ID of the  GCP project that owns the Cloud Spanner
+            database.  If set to None or missing, the default project_id from the GCP connection is used.
         :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
@@ -68,19 +63,53 @@ def get_instance(self, project_id, instance_id):
             https://googleapis.github.io/google-cloud-python/latest/spanner/instance-api.html#google.cloud.spanner_v1.instance.Instance
         :rtype: object
         """
-        instance = self.get_client(project_id).instance(instance_id)
+        instance = self._get_client(project_id=project_id).instance(instance_id=instance_id)
         if not instance.exists():
             return None
         return instance
 
-    def create_instance(self, project_id, instance_id, configuration_name, node_count,
-                        display_name):
-        # type: (str, str, str, int, str) -> bool
+    def _apply_to_instance(self, project_id, instance_id, configuration_name, node_count,
+                           display_name, func):
         """
-        Creates a new Cloud Spanner instance.
+        Invokes a method on a given instance by applying a specified Callable.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
+        :param project_id: The ID of the  GCP project that owns the Cloud Spanner
+            database.
         :type project_id: str
+        :param instance_id: The ID of the instance.
+        :type instance_id: str
+        :param configuration_name: Name of the instance configuration defining how the
+            instance will be created. Required for instances which do not yet exist.
+        :type configuration_name: str
+        :param node_count: (Optional) Number of nodes allocated to the instance.
+        :type node_count: int
+        :param display_name: (Optional) The display name for the instance in the Cloud
+            Console UI. (Must be between 4 and 30 characters.) If this value is not set
+            in the constructor, will fall back to the instance ID.
+        :type display_name: str
+        :param func: Method of the instance to be called.
+        :type func: Callable
+        """
+        # noinspection PyUnresolvedReferences
+        instance = self._get_client(project_id=project_id).instance(
+            instance_id=instance_id, configuration_name=configuration_name,
+            node_count=node_count, display_name=display_name)
+        try:
+            operation = func(instance)  # type: Operation
+        except GoogleAPICallError as e:
+            self.log.error('An error occurred: %s. Exiting.', e.message)
+            raise e
+
+        if operation:
+            result = operation.result()
+            self.log.info(result)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_instance(self, instance_id, configuration_name, node_count,
+                        display_name, project_id=None):
+        """
+        Creates a new Cloud Spanner instance.
+
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :param configuration_name: The name of the instance configuration defining how the
@@ -94,20 +123,20 @@ def create_instance(self, project_id, instance_id, configuration_name, node_coun
             Console. Must be between 4 and 30 characters.  If this value is not set in
             the constructor, the name falls back to the instance ID.
         :type display_name: str
-        :return: True if the operation succeeds. Otherwise,raises an exception.
-        :rtype: bool
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
-        return self._apply_to_instance(project_id, instance_id, configuration_name,
-                                       node_count, display_name, lambda x: x.create())
+        self._apply_to_instance(project_id, instance_id, configuration_name,
+                                node_count, display_name, lambda x: x.create())
 
-    def update_instance(self, project_id, instance_id, configuration_name, node_count,
-                        display_name):
-        # type: (str, str, str, int, str) -> bool
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def update_instance(self, instance_id, configuration_name, node_count,
+                        display_name, project_id=None):
         """
         Updates an existing Cloud Spanner instance.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
-        :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :param configuration_name: The name of the instance configuration defining how the
@@ -121,83 +150,52 @@ def update_instance(self, project_id, instance_id, configuration_name, node_coun
             Console. Must be between 4 and 30 characters. If this value is not set in
             the constructor, the name falls back to the instance ID.
         :type display_name: str
-        :return: True if the operation succeeded. Otherwise, raises an exception.
-        :rtype: bool
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         return self._apply_to_instance(project_id, instance_id, configuration_name,
                                        node_count, display_name, lambda x: x.update())
 
-    def _apply_to_instance(self, project_id, instance_id, configuration_name, node_count,
-                           display_name, func):
-        # type: (str, str, str, int, str, Callable[[Instance], Operation]) -> bool
-        """
-        Invokes a method on a given instance by applying a specified Callable.
-
-        :param project_id: The ID of the project which owns the Cloud Spanner Database.
-        :type project_id: str
-        :param instance_id: The ID of the instance.
-        :type instance_id: str
-        :param configuration_name: Name of the instance configuration defining how the
-            instance will be created. Required for instances which do not yet exist.
-        :type configuration_name: str
-        :param node_count: (Optional) Number of nodes allocated to the instance.
-        :type node_count: int
-        :param display_name: (Optional) The display name for the instance in the Cloud
-            Console UI. (Must be between 4 and 30 characters.) If this value is not set
-            in the constructor, will fall back to the instance ID.
-        :type display_name: str
-        :param func: Method of the instance to be called.
-        :type func: Callable
-        """
-        instance = self.get_client(project_id).instance(
-            instance_id, configuration_name=configuration_name,
-            node_count=node_count, display_name=display_name)
-        try:
-            operation = func(instance)  # type: Operation
-        except GoogleAPICallError as e:
-            self.log.error('An error occurred: %s. Exiting.', e.message)
-            raise e
-
-        if operation:
-            result = operation.result()
-            self.log.info(result)
-        return True
-
-    def delete_instance(self, project_id, instance_id):
-        # type: (str, str) -> bool
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_instance(self, instance_id, project_id=None):
         """
         Deletes an existing Cloud Spanner instance.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
-        :type project_id: str
         :param instance_id:  The ID of the Cloud Spanner instance.
         :type instance_id: str
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return None
         """
-        instance = self.get_client(project_id).instance(instance_id)
+        instance = self._get_client(project_id=project_id).instance(instance_id)
         try:
             instance.delete()
-            return True
+            return
         except GoogleAPICallError as e:
             self.log.error('An error occurred: %s. Exiting.', e.message)
             raise e
 
-    def get_database(self, project_id, instance_id, database_id):
-        # type: (str, str, str) -> Optional[Database]
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_database(self, instance_id, database_id, project_id=None):
         """
         Retrieves a database in Cloud Spanner. If the database does not exist
         in the specified instance, it returns None.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
-        :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :param database_id: The ID of the database in Cloud Spanner.
         :type database_id: str
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
         :return: Database object or None if database does not exist
         :rtype: Union[Database, None]
         """
 
-        instance = self.get_client(project_id=project_id).instance(
+        instance = self._get_client(project_id=project_id).instance(
             instance_id=instance_id)
         if not instance.exists():
             raise AirflowException("The instance {} does not exist in project {} !".
@@ -208,12 +206,11 @@ def get_database(self, project_id, instance_id, database_id):
         else:
             return database
 
-    def create_database(self, project_id, instance_id, database_id, ddl_statements):
-        # type: (str, str, str, [str]) -> bool
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_database(self, instance_id, database_id, ddl_statements, project_id=None):
         """
         Creates a new database in Cloud Spanner.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
         :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
@@ -221,11 +218,12 @@ def create_database(self, project_id, instance_id, database_id, ddl_statements):
         :type database_id: str
         :param ddl_statements: The string list containing DDL for the new database.
         :type ddl_statements: list[str]
-        :return: True if everything succeeded
-        :rtype: bool
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :return: None
         """
 
-        instance = self.get_client(project_id=project_id).instance(
+        instance = self._get_client(project_id=project_id).instance(
             instance_id=instance_id)
         if not instance.exists():
             raise AirflowException("The instance {} does not exist in project {} !".
@@ -241,15 +239,15 @@ def create_database(self, project_id, instance_id, database_id, ddl_statements):
         if operation:
             result = operation.result()
             self.log.info(result)
-        return True
+        return
 
-    def update_database(self, project_id, instance_id, database_id, ddl_statements,
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def update_database(self, instance_id, database_id, ddl_statements,
+                        project_id=None,
                         operation_id=None):
-        # type: (str, str, str, [str], str) -> bool
         """
         Updates DDL of a database in Cloud Spanner.
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner database.
         :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
@@ -257,14 +255,15 @@ def update_database(self, project_id, instance_id, database_id, ddl_statements,
         :type database_id: str
         :param ddl_statements: The string list containing DDL for the new database.
         :type ddl_statements: list[str]
+        :param project_id: Optional, the ID of the GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
         :param operation_id: (Optional) The unique per database operation ID that can be
             specified to implement idempotency check.
         :type operation_id: str
-        :return: True if everything succeeded
-        :rtype: bool
+        :return: None
         """
 
-        instance = self.get_client(project_id=project_id).instance(
+        instance = self._get_client(project_id=project_id).instance(
             instance_id=instance_id)
         if not instance.exists():
             raise AirflowException("The instance {} does not exist in project {} !".
@@ -272,42 +271,46 @@ def update_database(self, project_id, instance_id, database_id, ddl_statements,
         database = instance.database(database_id=database_id)
         try:
             operation = database.update_ddl(
-                ddl_statements, operation_id=operation_id)
+                ddl_statements=ddl_statements, operation_id=operation_id)
             if operation:
                 result = operation.result()
                 self.log.info(result)
-            return True
+            return
         except AlreadyExists as e:
             if e.code == 409 and operation_id in e.message:
                 self.log.info("Replayed update_ddl message - the operation id %s "
                               "was already done before.", operation_id)
-                return True
+                return
         except GoogleAPICallError as e:
             self.log.error('An error occurred: %s. Exiting.', e.message)
             raise e
 
-    def delete_database(self, project_id, instance_id, database_id):
-        # type: (str, str, str) -> bool
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_database(self, instance_id, database_id, project_id=None):
         """
         Drops a database in Cloud Spanner.
 
-        :param project_id:  The ID of the GCP project that owns the Cloud Spanner
-            database.
         :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :param database_id: The ID of the database in Cloud Spanner.
         :type database_id: str
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
         :return: True if everything succeeded
         :rtype: bool
         """
 
-        instance = self.get_client(project_id=project_id).\
+        instance = self._get_client(project_id=project_id).\
             instance(instance_id=instance_id)
         if not instance.exists():
             raise AirflowException("The instance {} does not exist in project {} !".
                                    format(instance_id, project_id))
         database = instance.database(database_id=database_id)
+        if not database.exists():
+            self.log.info("The database {} is already deleted from instance {}. "
+                          "Exiting.".format(database_id, instance_id))
+            return
         try:
             operation = database.drop()  # type: Operation
         except GoogleAPICallError as e:
@@ -317,25 +320,25 @@ def delete_database(self, project_id, instance_id, database_id):
         if operation:
             result = operation.result()
             self.log.info(result)
-        return True
+        return
 
-    def execute_dml(self, project_id, instance_id, database_id, queries):
-        # type: (str, str, str, str) -> None
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def execute_dml(self, instance_id, database_id, queries, project_id=None):
         """
         Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
-        :param project_id: The ID of the GCP project that owns the Cloud Spanner
-            database.
-        :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
         :param database_id: The ID of the database in Cloud Spanner.
         :type database_id: str
         :param queries: The queries to execute.
         :type queries: str
+        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+            database. If set to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
         """
-        instance = self.get_client(project_id).instance(instance_id)
-        Database(database_id, instance).run_in_transaction(
+        self._get_client(project_id=project_id).instance(instance_id=instance_id).\
+            database(database_id=database_id).run_in_transaction(
             lambda transaction: self._execute_sql_in_transaction(transaction, queries))
 
     @staticmethod
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 7089e9a8c5577..a5bd51c24cc8d 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -29,7 +29,8 @@
 import subprocess
 import time
 import uuid
-from os.path import isfile
+import os.path
+
 from googleapiclient.errors import HttpError
 from subprocess import Popen, PIPE
 from six.moves.urllib.parse import quote_plus
@@ -90,14 +91,16 @@ def get_conn(self):
                                http=http_authorized, cache_discovery=False)
         return self._conn
 
-    def get_instance(self, project_id, instance):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_instance(self, instance, project_id=None):
         """
         Retrieves a resource containing information about a Cloud SQL instance.
 
-        :param project_id: Project ID of the project that contains the instance.
-        :type project_id: str
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
         :return: A Cloud SQL instance resource.
         :rtype: dict
         """
@@ -106,42 +109,44 @@ def get_instance(self, project_id, instance):
             instance=instance
         ).execute(num_retries=NUM_RETRIES)
 
-    def create_instance(self, project_id, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_instance(self, body, project_id=None):
         """
         Creates a new Cloud SQL instance.
 
-        :param project_id: Project ID of the project to which the newly created
-            Cloud SQL instances should belong.
-        :type project_id: str
         :param body: Body required by the Cloud SQL insert API, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().instances().insert(
             project=project_id,
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def patch_instance(self, project_id, body, instance):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def patch_instance(self, body, instance, project_id=None):
         """
         Updates settings of a Cloud SQL instance.
 
         Caution: This is not a partial update, so you must include values for
         all the settings that you want to retain.
 
-        :param project_id: Project ID of the project that contains the instance.
-        :type project_id: str
         :param body: Body required by the Cloud SQL patch API, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body.
         :type body: dict
         :param instance: Cloud SQL instance ID. This does not include the project ID.
         :type instance: str
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().instances().patch(
             project=project_id,
@@ -149,36 +154,41 @@ def patch_instance(self, project_id, body, instance):
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def delete_instance(self, project_id, instance):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_instance(self, instance, project_id=None):
         """
         Deletes a Cloud SQL instance.
 
-        :param project_id: Project ID of the project that contains the instance.
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
         :type project_id: str
         :param instance: Cloud SQL instance ID. This does not include the project ID.
         :type instance: str
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :return: None
         """
         response = self.get_conn().instances().delete(
             project=project_id,
             instance=instance,
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project_id, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def get_database(self, project_id, instance, database):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_database(self, instance, database, project_id=None):
         """
         Retrieves a database resource from a Cloud SQL instance.
 
-        :param project_id: Project ID of the project that contains the instance.
-        :type project_id: str
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
         :param database: Name of the database in the instance.
         :type database: str
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
         :return: A Cloud SQL database resource, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases#resource.
         :rtype: dict
@@ -189,37 +199,38 @@ def get_database(self, project_id, instance, database):
             database=database
         ).execute(num_retries=NUM_RETRIES)
 
-    def create_database(self, project, instance, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_database(self, instance, body, project_id=None):
         """
         Creates a new database inside a Cloud SQL instance.
 
-        :param project: Project ID of the project that contains the instance.
-        :type project: str
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().databases().insert(
-            project=project,
+            project=project_id,
             instance=instance,
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def patch_database(self, project, instance, database, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def patch_database(self, instance, database, body, project_id=None):
         """
         Updates a database resource inside a Cloud SQL instance.
 
         This method supports patch semantics.
         See https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch.
 
-        :param project: Project ID of the project that contains the instance.
-        :type project: str
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
         :param database: Name of the database to be updated in the instance.
@@ -227,95 +238,104 @@ def patch_database(self, project, instance, database, body):
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body.
         :type body: dict
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().databases().patch(
-            project=project,
+            project=project_id,
             instance=instance,
             database=database,
             body=body
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def delete_database(self, project, instance, database):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_database(self, instance, database, project_id=None):
         """
         Deletes a database from a Cloud SQL instance.
 
-        :param project: Project ID of the project that contains the instance.
-        :type project: str
         :param instance: Database instance ID. This does not include the project ID.
         :type instance: str
         :param database: Name of the database to be deleted in the instance.
         :type database: str
-        :return: True if the operation succeeded otherwise raises an error.
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         response = self.get_conn().databases().delete(
-            project=project,
+            project=project_id,
             instance=instance,
             database=database
         ).execute(num_retries=NUM_RETRIES)
         operation_name = response["name"]
-        return self._wait_for_operation_to_complete(project, operation_name)
+        self._wait_for_operation_to_complete(project_id=project_id,
+                                             operation_name=operation_name)
 
-    def export_instance(self, project_id, instance_id, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def export_instance(self, instance, body, project_id=None):
         """
         Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
         or CSV file.
 
-        :param project_id: Project ID of the project where the instance exists.
-        :type project_id: str
-        :param instance_id: Name of the Cloud SQL instance. This does not include the
+        :param instance: Database instance ID of the Cloud SQL instance. This does not include the
             project ID.
-        :type instance_id: str
+        :type instance: str
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         try:
             response = self.get_conn().instances().export(
                 project=project_id,
-                instance=instance_id,
+                instance=instance,
                 body=body
             ).execute(num_retries=NUM_RETRIES)
             operation_name = response["name"]
-            return self._wait_for_operation_to_complete(project_id, operation_name)
+            self._wait_for_operation_to_complete(project_id=project_id,
+                                                 operation_name=operation_name)
         except HttpError as ex:
             raise AirflowException(
-                'Exporting instance {} failed: {}'.format(instance_id, ex.content)
+                'Exporting instance {} failed: {}'.format(instance, ex.content)
             )
 
-    def import_instance(self, project_id, instance_id, body):
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def import_instance(self, instance, body, project_id=None):
         """
         Imports data into a Cloud SQL instance from a SQL dump or CSV file in
         Cloud Storage.
 
-        :param project_id: Project ID of the project where the instance exists.
-        :type project_id: str
-        :param instance_id: Name of the Cloud SQL instance. This does not include the
+        :param instance: Database instance ID. This does not include the
             project ID.
-        :type instance_id: str
+        :type instance: str
         :param body: The request body, as described in
             https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
         :type body: dict
-        :return: True if the operation succeeded, raises an error otherwise
-        :rtype: bool
+        :param project_id: Project ID of the project that contains the instance. If set
+            to None or missing, the default project_id from the GCP connection is used.
+        :type project_id: str
+        :return: None
         """
         try:
             response = self.get_conn().instances().import_(
                 project=project_id,
-                instance=instance_id,
+                instance=instance,
                 body=body
             ).execute(num_retries=NUM_RETRIES)
             operation_name = response["name"]
-            return self._wait_for_operation_to_complete(project_id, operation_name)
+            self._wait_for_operation_to_complete(project_id=project_id,
+                                                 operation_name=operation_name)
         except HttpError as ex:
             raise AirflowException(
-                'Importing instance {} failed: {}'.format(instance_id, ex.content)
+                'Importing instance {} failed: {}'.format(instance, ex.content)
             )
 
     def _wait_for_operation_to_complete(self, project_id, operation_name):
@@ -327,8 +347,7 @@ def _wait_for_operation_to_complete(self, project_id, operation_name):
         :type project_id: str
         :param operation_name: Name of the operation.
         :type operation_name: str
-        :return: Response returned by the operation.
-        :rtype: dict
+        :return: None
         """
         service = self.get_conn()
         while True:
@@ -343,7 +362,7 @@ def _wait_for_operation_to_complete(self, project_id, operation_name):
                     error_msg = str(error.get("errors"))[1:-1]
                     raise AirflowException(error_msg)
                 # No meaningful info to return from the response in case of success
-                return True
+                return
             time.sleep(TIME_TO_SLEEP_IN_SECONDS)
 
 
@@ -368,6 +387,7 @@ class CloudSqlProxyRunner(LoggingMixin):
     https://cloud.google.com/sql/docs/mysql/sql-proxy
 
     """
+
     def __init__(self,
                  path_prefix,
                  instance_specification,
@@ -392,7 +412,7 @@ def __init__(self,
             authentication
         :type: str
         :param project_id: Optional id of the GCP project to connect to - it overwrites
-            default project id taken from the GCP connection
+            default project id taken from the GCP connection.
         :type project_id: str
         :param sql_proxy_version: Specific version of SQL proxy to download
             (for example 'v1.13'). By default latest version is downloaded.
@@ -570,7 +590,7 @@ def stop_proxy(self):
         else:
             self.log.info("Skipped removing proxy - it was not downloaded: %s",
                           self.sql_proxy_path)
-        if isfile(self.credentials_path):
+        if os.path.isfile(self.credentials_path):
             self.log.info("Removing generated credentials file %s",
                           self.credentials_path)
             # Here file cannot be delete by concurrent task (each task has its own copy)
@@ -665,7 +685,8 @@ class CloudSqlDatabaseHook(BaseHook):
 
     Remaining parameters are retrieved from the extras (URI query parameters):
 
-    * **project_id** - Google Cloud Platform project where the Cloud SQL instance exists.
+    * **project_id** - Optional, Google Cloud Platform project where the Cloud SQL
+       instance exists. If missing, default project id passed is used.
     * **instance** -  Name of the instance of the Cloud SQL database instance.
     * **location** - The location of the Cloud SQL instance (for example europe-west1).
     * **database_type** - The type of the database instance (MySQL or Postgres).
@@ -682,15 +703,22 @@ class CloudSqlDatabaseHook(BaseHook):
     * **sslcert** - Path to client certificate to authenticate when SSL is used.
     * **sslkey** - Path to client private key to authenticate when SSL is used.
     * **sslrootcert** - Path to server's certificate to authenticate when SSL is used.
+
+    :param gcp_cloudsql_conn_id: URL of the connection
+    :type gcp_cloudsql_conn_id: str
+    :param default_gcp_project_id: Default project id used if project_id not specified
+           in the connection URL
+    :type default_gcp_project_id: str
     """
     _conn = None
 
-    def __init__(self, gcp_cloudsql_conn_id='google_cloud_sql_default'):
+    def __init__(self, gcp_cloudsql_conn_id='google_cloud_sql_default',
+                 default_gcp_project_id=None):
         super(CloudSqlDatabaseHook, self).__init__(source=None)
         self.gcp_cloudsql_conn_id = gcp_cloudsql_conn_id
         self.cloudsql_connection = self.get_connection(self.gcp_cloudsql_conn_id)
         self.extras = self.cloudsql_connection.extra_dejson
-        self.project_id = self.extras.get('project_id')
+        self.project_id = self.extras.get('project_id', default_gcp_project_id)
         self.instance = self.extras.get('instance')
         self.database = self.cloudsql_connection.schema
         self.location = self.extras.get('location')
@@ -729,17 +757,17 @@ def _check_ssl_file(file_to_check, name):
         if not file_to_check:
             raise AirflowException("SSL connections requires {name} to be set".
                                    format(name=name))
-        if not isfile(file_to_check):
+        if not os.path.isfile(file_to_check):
             raise AirflowException("The {file_to_check} must be a readable file".
                                    format(file_to_check=file_to_check))
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required extra 'project_id' is empty")
         if not self.location:
-            raise AirflowException("The required extra 'location' is empty")
+            raise AirflowException("The required extra 'location' is empty or None")
         if not self.instance:
-            raise AirflowException("The required extra 'instance' is empty")
+            raise AirflowException("The required extra 'instance' is empty or None")
         if self.database_type not in CLOUD_SQL_VALID_DATABASE_TYPES:
             raise AirflowException("Invalid database type '{}'. Must be one of {}".format(
                 self.database_type, CLOUD_SQL_VALID_DATABASE_TYPES
@@ -754,6 +782,8 @@ def validate_ssl_certs(self):
             self._check_ssl_file(self.sslcert, "sslcert")
             self._check_ssl_file(self.sslkey, "sslkey")
             self._check_ssl_file(self.sslrootcert, "sslrootcert")
+
+    def validate_socket_path_length(self):
         if self.use_proxy and not self.sql_proxy_use_tcp:
             if self.database_type == 'postgres':
                 suffix = "/.s.PGSQL.5432"
@@ -824,22 +854,30 @@ def _generate_connection_uri(self):
                 }
             else:
                 format_string = public_uris['non-ssl']
+        if not self.user:
+            raise AirflowException("The login parameter needs to be set in connection")
+        if not self.public_ip:
+            raise AirflowException("The location parameter needs to be set in connection")
+        if not self.password:
+            raise AirflowException("The password parameter needs to be set in connection")
+        if not self.database:
+            raise AirflowException("The database parameter needs to be set in connection")
 
         connection_uri = format_string.format(
-            user=quote_plus(self.user),
-            password=quote_plus(self.password),
-            database=quote_plus(self.database),
+            user=quote_plus(self.user) if self.user else '',
+            password=quote_plus(self.password) if self.password else '',
+            database=quote_plus(self.database) if self.database else '',
             public_ip=self.public_ip,
             public_port=self.public_port,
             proxy_port=self.sql_proxy_tcp_port,
             socket_path=self._quote(socket_path),
-            ssl_spec=self._quote(json.dumps(ssl_spec)) if ssl_spec else None,
-            client_cert_file=self._quote(self.sslcert),
-            client_key_file=self._quote(self.sslkey),
-            server_ca_file=self._quote(self.sslrootcert)
+            ssl_spec=self._quote(json.dumps(ssl_spec)) if ssl_spec else '',
+            client_cert_file=self._quote(self.sslcert) if self.sslcert else '',
+            client_key_file=self._quote(self.sslkey) if self.sslcert else '',
+            server_ca_file=self._quote(self.sslrootcert if self.sslcert else '')
         )
         self.log.info("DB connection URI %s", connection_uri.replace(
-            quote_plus(self.password), 'XXXXXXXXXXXX'))
+            quote_plus(self.password) if self.password else 'PASSWORD', 'XXXXXXXXXXXX'))
         return connection_uri
 
     def _get_instance_socket_name(self):
@@ -867,6 +905,21 @@ def create_connection(self, session=None):
         session.add(connection)
         session.commit()
 
+    @provide_session
+    def retrieve_connection(self, session=None):
+        """
+        Retrieves the dynamically created connection from the Connection table.
+
+        :param session: Session of the SQL Alchemy ORM (automatically generated with
+                        decorator).
+        """
+        self.log.info("Retrieving connection %s", self.db_conn_id)
+        connections = session.query(Connection).filter(
+            Connection.conn_id == self.db_conn_id)
+        if connections.count():
+            return connections[0]
+        return None
+
     @provide_session
     def delete_connection(self, session=None):
         """
@@ -876,10 +929,15 @@ def delete_connection(self, session=None):
                         decorator).
         """
         self.log.info("Deleting connection %s", self.db_conn_id)
-        connection = session.query(models.Connection).filter(
-            models.Connection.conn_id == self.db_conn_id)[0]
-        session.delete(connection)
-        session.commit()
+
+        connections = session.query(Connection).filter(
+            Connection.conn_id == self.db_conn_id)
+        if connections.count():
+            connection = connections[0]
+            session.delete(connection)
+            session.commit()
+        else:
+            self.log.info("Connection was already deleted!")
 
     def get_sqlproxy_runner(self):
         """
@@ -889,6 +947,8 @@ def get_sqlproxy_runner(self):
         :return: The Cloud SQL Proxy runner.
         :rtype: CloudSqlProxyRunner
         """
+        if not self.use_proxy:
+            raise AirflowException("Proxy runner can only be retrieved in case of use_proxy = True")
         return CloudSqlProxyRunner(
             path_prefix=self.sql_proxy_unique_path,
             instance_specification=self._get_sqlproxy_instance_specification(),
@@ -915,7 +975,8 @@ def cleanup_database_hook(self):
         Clean up database hook after it was used.
         """
         if self.database_type == 'postgres':
-            if self.db_hook.conn and self.db_hook.conn.notices:
+            if hasattr(self.db_hook,
+                       'conn') and self.db_hook.conn and self.db_hook.conn.notices:
                 for output in self.db_hook.conn.notices:
                     self.log.info(output)
 
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index de83bde7522d5..2e7cf19ba0dcb 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -567,7 +567,6 @@ def create_bucket(self,
             )
 
     def insert_bucket_acl(self, bucket, entity, role, user_project):
-        # type: (str, str, str, str) -> None
         """
         Creates a new ACL entry on the specified bucket.
         See: https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert
@@ -606,7 +605,6 @@ def insert_bucket_acl(self, bucket, entity, role, user_project):
 
     def insert_object_acl(self, bucket, object_name, entity, role, generation,
                           user_project):
-        # type: (str, str, str, str, str, str) -> None
         """
         Creates a new ACL entry on the specified object.
         See: https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert
diff --git a/airflow/contrib/operators/gcp_bigtable_operator.py b/airflow/contrib/operators/gcp_bigtable_operator.py
index 640851e76e490..c59ee5561d259 100644
--- a/airflow/contrib/operators/gcp_bigtable_operator.py
+++ b/airflow/contrib/operators/gcp_bigtable_operator.py
@@ -44,14 +44,13 @@ def _validate_inputs(self):
 class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
     """
     Creates a new Cloud Bigtable instance.
-    If the Cloud Bigtable instance with the given ID exists, the operator does not compare its configuration
+    If the Cloud Bigtable instance with the given ID exists, the operator does not
+    compare its configuration
     and immediately succeeds. No changes are made to the existing instance.
 
     For more details about instance creation have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.create
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance to create.
     :type main_cluster_id: str
@@ -59,6 +58,9 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
     :type main_cluster_zone: str
     :param main_cluster_zone: The zone for main cluster
         See https://cloud.google.com/bigtable/docs/locations for more details.
+    :type project_id: str
+    :param project_id: Optional, the ID of the GCP project.  If set to None or missing,
+            the default project_id from the GCP connection is used.
     :type replica_cluster_id: str
     :param replica_cluster_id: (optional) The ID for replica cluster for the new instance.
     :type replica_cluster_zone: str
@@ -66,9 +68,11 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
     :type instance_type: IntEnum
     :param instance_type: (optional) The type of the instance.
     :type instance_display_name: str
-    :param instance_display_name: (optional) Human-readable name of the instance. Defaults to ``instance_id``.
+    :param instance_display_name: (optional) Human-readable name of the instance. Defaults
+        to ``instance_id``.
     :type instance_labels: dict
-    :param instance_labels: (optional) Dictionary of labels to associate with the instance.
+    :param instance_labels: (optional) Dictionary of labels to associate
+        with the instance.
     :type cluster_nodes: int
     :param cluster_nodes: (optional) Number of nodes for cluster.
     :type cluster_storage_type: IntEnum
@@ -78,15 +82,17 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
                     If None is not specified, Operator will wait indefinitely.
     """
 
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'main_cluster_id', 'main_cluster_zone')
-    template_fields = ['project_id', 'instance_id', 'main_cluster_id', 'main_cluster_zone']
+    REQUIRED_ATTRIBUTES = ('instance_id', 'main_cluster_id',
+                           'main_cluster_zone')
+    template_fields = ['project_id', 'instance_id', 'main_cluster_id',
+                       'main_cluster_zone']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  main_cluster_id,
                  main_cluster_zone,
+                 project_id=None,
                  replica_cluster_id=None,
                  replica_cluster_zone=None,
                  instance_display_name=None,
@@ -113,28 +119,31 @@ def __init__(self,
         super(BigtableInstanceCreateOperator, self).__init__(*args, **kwargs)
 
     def execute(self, context):
-        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        instance = self.hook.get_instance(project_id=self.project_id,
+                                          instance_id=self.instance_id)
         if instance:
-            # Based on Instance.__eq__ instance with the same ID and client is considered as equal.
+            # Based on Instance.__eq__ instance with the same ID and client is
+            # considered as equal.
             self.log.info(
-                "The instance '%s' already exists in this project. Consider it as created",
+                "The instance '%s' already exists in this project. "
+                "Consider it as created",
                 self.instance_id
             )
             return
         try:
             self.hook.create_instance(
-                self.project_id,
-                self.instance_id,
-                self.main_cluster_id,
-                self.main_cluster_zone,
-                self.replica_cluster_id,
-                self.replica_cluster_zone,
-                self.instance_display_name,
-                self.instance_type,
-                self.instance_labels,
-                self.cluster_nodes,
-                self.cluster_storage_type,
-                self.timeout,
+                project_id=self.project_id,
+                instance_id=self.instance_id,
+                main_cluster_id=self.main_cluster_id,
+                main_cluster_zone=self.main_cluster_zone,
+                replica_cluster_id=self.replica_cluster_id,
+                replica_cluster_zone=self.replica_cluster_zone,
+                instance_display_name=self.instance_display_name,
+                instance_type=self.instance_type,
+                instance_labels=self.instance_labels,
+                cluster_nodes=self.cluster_nodes,
+                cluster_storage_type=self.cluster_storage_type,
+                timeout=self.timeout,
             )
         except google.api_core.exceptions.GoogleAPICallError as e:
             self.log.error('An error occurred. Exiting.')
@@ -148,18 +157,19 @@ class BigtableInstanceDeleteOperator(BaseOperator, BigtableValidationMixin):
     For more details about deleting instance have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.delete
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance to delete.
+    :param project_id: Optional, the ID of the GCP project.  If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     """
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id')
+    REQUIRED_ATTRIBUTES = ('instance_id',)
     template_fields = ['project_id', 'instance_id']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
+                 project_id=None,
                  *args, **kwargs):
         self.project_id = project_id
         self.instance_id = instance_id
@@ -169,10 +179,12 @@ def __init__(self,
 
     def execute(self, context):
         try:
-            self.hook.delete_instance(self.project_id, self.instance_id)
+            self.hook.delete_instance(project_id=self.project_id,
+                                      instance_id=self.instance_id)
         except google.api_core.exceptions.NotFound:
             self.log.info(
-                "The instance '%s' does not exist in project '%s'. Consider it as deleted",
+                "The instance '%s' does not exist in project '%s'. "
+                "Consider it as deleted",
                 self.instance_id, self.project_id
             )
         except google.api_core.exceptions.GoogleAPICallError as e:
@@ -187,27 +199,30 @@ class BigtableTableCreateOperator(BaseOperator, BigtableValidationMixin):
     For more details about creating table have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.create
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
-    :param instance_id: The ID of the Cloud Bigtable instance that will hold the new table.
+    :param instance_id: The ID of the Cloud Bigtable instance that will
+        hold the new table.
     :type table_id: str
     :param table_id: The ID of the table to be created.
+    :type project_id: str
+    :param project_id: Optional, the ID of the GCP project. If set to None or missing,
+            the default project_id from the GCP connection is used.
     :type initial_split_keys: list
-    :param initial_split_keys: (Optional) list of row keys in bytes that will be used to initially split
-                                the table into several tablets.
+    :param initial_split_keys: (Optional) list of row keys in bytes that will be used to
+        initially split the table into several tablets.
     :type column_families: dict
     :param column_families: (Optional) A map columns to create.
-                            The key is the column_id str and the value is a GarbageCollectionRule
+                            The key is the column_id str and the value is a
+                            GarbageCollectionRule
     """
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    REQUIRED_ATTRIBUTES = ('instance_id', 'table_id')
     template_fields = ['project_id', 'instance_id', 'table_id']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  table_id,
+                 project_id=None,
                  initial_split_keys=None,
                  column_families=None,
                  *args, **kwargs):
@@ -222,41 +237,50 @@ def __init__(self,
         super(BigtableTableCreateOperator, self).__init__(*args, **kwargs)
 
     def _compare_column_families(self):
-        table_column_families = self.hook.get_column_families_for_table(self.instance, self.table_id)
+        table_column_families = self.hook.get_column_families_for_table(self.instance,
+                                                                        self.table_id)
         if set(table_column_families.keys()) != set(self.column_families.keys()):
-            self.log.error("Table '%s' has different set of Column Families", self.table_id)
+            self.log.error("Table '%s' has different set of Column Families",
+                           self.table_id)
             self.log.error("Expected: %s", self.column_families.keys())
             self.log.error("Actual: %s", table_column_families.keys())
             return False
 
         for key in table_column_families.keys():
-            # There is difference in structure between local Column Families and remote ones
-            # Local `self.column_families` is dict with column_id as key and GarbageCollectionRule as value.
+            # There is difference in structure between local Column Families
+            # and remote ones
+            # Local `self.column_families` is dict with column_id as key
+            # and GarbageCollectionRule as value.
             # Remote `table_column_families` is list of ColumnFamily objects.
             # For more information about ColumnFamily please refer to the documentation:
             # https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html#google.cloud.bigtable.column_family.ColumnFamily
             if table_column_families[key].gc_rule != self.column_families[key]:
-                self.log.error("Column Family '%s' differs for table '%s'.", key, self.table_id)
+                self.log.error("Column Family '%s' differs for table '%s'.", key,
+                               self.table_id)
                 return False
         return True
 
     def execute(self, context):
-        self.instance = self.hook.get_instance(self.project_id, self.instance_id)
+        self.instance = self.hook.get_instance(project_id=self.project_id,
+                                               instance_id=self.instance_id)
         if not self.instance:
-            raise AirflowException("Dependency: instance '{}' does not exist in project '{}'.".format(
-                self.instance_id, self.project_id))
+            raise AirflowException(
+                "Dependency: instance '{}' does not exist in project '{}'.".
+                format(self.instance_id, self.project_id))
         try:
             self.hook.create_table(
-                self.instance,
-                self.table_id,
-                self.initial_split_keys,
-                self.column_families
+                instance=self.instance,
+                table_id=self.table_id,
+                initial_split_keys=self.initial_split_keys,
+                column_families=self.column_families
             )
         except google.api_core.exceptions.AlreadyExists:
             if not self._compare_column_families():
                 raise AirflowException(
-                    "Table '{}' already exists with different Column Families.".format(self.table_id))
-            self.log.info("The table '%s' already exists. Consider it as created", self.table_id)
+                    "Table '{}' already exists with different Column Families.".
+                    format(self.table_id))
+            self.log.info("The table '%s' already exists. Consider it as created",
+                          self.table_id)
 
 
 class BigtableTableDeleteOperator(BaseOperator, BigtableValidationMixin):
@@ -266,21 +290,24 @@ class BigtableTableDeleteOperator(BaseOperator, BigtableValidationMixin):
     For more details about deleting table have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.delete
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type table_id: str
     :param table_id: The ID of the table to be deleted.
+    :type project_id: str
+    :param project_id: Optional, the ID of the GCP project. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type app_profile_id: str
+    :parm app_profile_id: Application profile.
     """
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    REQUIRED_ATTRIBUTES = ('instance_id', 'table_id')
     template_fields = ['project_id', 'instance_id', 'table_id']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  table_id,
+                 project_id=None,
                  app_profile_id=None,
                  *args, **kwargs):
         self.project_id = project_id
@@ -292,19 +319,22 @@ def __init__(self,
         super(BigtableTableDeleteOperator, self).__init__(*args, **kwargs)
 
     def execute(self, context):
-        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        instance = self.hook.get_instance(project_id=self.project_id,
+                                          instance_id=self.instance_id)
         if not instance:
-            raise AirflowException("Dependency: instance '{}' does not exist.".format(self.instance_id))
+            raise AirflowException("Dependency: instance '{}' does not exist.".format(
+                self.instance_id))
 
         try:
             self.hook.delete_table(
-                self.project_id,
-                self.instance_id,
-                self.table_id,
+                project_id=self.project_id,
+                instance_id=self.instance_id,
+                table_id=self.table_id,
             )
         except google.api_core.exceptions.NotFound:
             # It's OK if table doesn't exists.
-            self.log.info("The table '%s' no longer exists. Consider it as deleted", self.table_id)
+            self.log.info("The table '%s' no longer exists. Consider it as deleted",
+                          self.table_id)
         except google.api_core.exceptions.GoogleAPICallError as e:
             self.log.error('An error occurred. Exiting.')
             raise e
@@ -314,27 +344,28 @@ class BigtableClusterUpdateOperator(BaseOperator, BigtableValidationMixin):
     """
     Updates a Cloud Bigtable cluster.
 
-    For more details about updating a Cloud Bigtable cluster, have a look at the reference:
+    For more details about updating a Cloud Bigtable cluster,
+    have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/cluster.html#google.cloud.bigtable.cluster.Cluster.update
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type cluster_id: str
     :param cluster_id: The ID of the Cloud Bigtable cluster to update.
     :type nodes: int
     :param nodes: The desired number of nodes for the Cloud Bigtable cluster.
+    :type project_id: str
+    :param project_id: Optional, the ID of the GCP project.
     """
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'cluster_id', 'nodes')
+    REQUIRED_ATTRIBUTES = ('instance_id', 'cluster_id', 'nodes')
     template_fields = ['project_id', 'instance_id', 'cluster_id', 'nodes']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  cluster_id,
                  nodes,
+                 project_id=None,
                  *args, **kwargs):
         self.project_id = project_id
         self.instance_id = instance_id
@@ -345,21 +376,22 @@ def __init__(self,
         super(BigtableClusterUpdateOperator, self).__init__(*args, **kwargs)
 
     def execute(self, context):
-        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        instance = self.hook.get_instance(project_id=self.project_id,
+                                          instance_id=self.instance_id)
         if not instance:
-            raise AirflowException("Dependency: instance '{}' does not exist.".format(self.instance_id))
+            raise AirflowException("Dependency: instance '{}' does not exist.".format(
+                self.instance_id))
 
         try:
             self.hook.update_cluster(
-                instance,
-                self.cluster_id,
-                self.nodes
+                instance=instance,
+                cluster_id=self.cluster_id,
+                nodes=self.nodes
             )
         except google.api_core.exceptions.NotFound:
-            raise AirflowException("Dependency: cluster '{}' does not exist for instance '{}'.".format(
-                self.cluster_id,
-                self.instance_id
-            ))
+            raise AirflowException(
+                "Dependency: cluster '{}' does not exist for instance '{}'.".
+                format(self.cluster_id, self.instance_id))
         except google.api_core.exceptions.GoogleAPICallError as e:
             self.log.error('An error occurred. Exiting.')
             raise e
@@ -373,21 +405,21 @@ class BigtableTableWaitForReplicationSensor(BaseSensorOperator, BigtableValidati
     For more details about cluster states for a table, have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.get_cluster_states
 
-    :type project_id: str
-    :param project_id: The ID of the GCP project.
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type table_id: str
     :param table_id: The ID of the table to check replication status.
+    :type project_id: str
+    :param project_id: Optional, the ID of the GCP project.
     """
-    REQUIRED_ATTRIBUTES = ('project_id', 'instance_id', 'table_id')
+    REQUIRED_ATTRIBUTES = ('instance_id', 'table_id')
     template_fields = ['project_id', 'instance_id', 'table_id']
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  table_id,
+                 project_id=None,
                  *args, **kwargs):
         self.project_id = project_id
         self.instance_id = instance_id
@@ -397,16 +429,19 @@ def __init__(self,
         super(BigtableTableWaitForReplicationSensor, self).__init__(*args, **kwargs)
 
     def poke(self, context):
-        instance = self.hook.get_instance(self.project_id, self.instance_id)
+        instance = self.hook.get_instance(project_id=self.project_id,
+                                          instance_id=self.instance_id)
         if not instance:
             self.log.info("Dependency: instance '%s' does not exist.", self.instance_id)
             return False
 
         try:
-            cluster_states = self.hook.get_cluster_states_for_table(instance, self.table_id)
+            cluster_states = self.hook.get_cluster_states_for_table(instance=instance,
+                                                                    table_id=self.table_id)
         except google.api_core.exceptions.NotFound:
             self.log.info(
-                "Dependency: table '%s' does not exist in instance '%s'.", self.table_id, self.instance_id)
+                "Dependency: table '%s' does not exist in instance '%s'.",
+                self.table_id, self.instance_id)
             return False
 
         ready_state = ClusterState(enums.Table.ClusterState.ReplicationState.READY)
@@ -414,7 +449,8 @@ def poke(self, context):
         is_table_replicated = True
         for cluster_id in cluster_states.keys():
             if cluster_states[cluster_id] != ready_state:
-                self.log.info("Table '%s' is not yet replicated on cluster '%s'.", self.table_id, cluster_id)
+                self.log.info("Table '%s' is not yet replicated on cluster '%s'.",
+                              self.table_id, cluster_id)
                 is_table_replicated = False
 
         if not is_table_replicated:
diff --git a/airflow/contrib/operators/gcp_compute_operator.py b/airflow/contrib/operators/gcp_compute_operator.py
index a872c17227ddf..0645ce6ce856f 100644
--- a/airflow/contrib/operators/gcp_compute_operator.py
+++ b/airflow/contrib/operators/gcp_compute_operator.py
@@ -36,16 +36,14 @@ class GceBaseOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  zone,
                  resource_id,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
                  *args, **kwargs):
         self.project_id = project_id
         self.zone = zone
-        self.full_location = 'projects/{}/zones/{}'.format(self.project_id,
-                                                           self.zone)
         self.resource_id = resource_id
         self.gcp_conn_id = gcp_conn_id
         self.api_version = api_version
@@ -54,7 +52,7 @@ def __init__(self,
         super(GceBaseOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is missing")
         if not self.zone:
             raise AirflowException("The required parameter 'zone' is missing")
@@ -69,17 +67,22 @@ class GceInstanceStartOperator(GceBaseOperator):
     """
     Starts an instance in Google Compute Engine.
 
-    :param project_id: Google Cloud Platform Project ID where the Compute Engine
-        Instance exists.
-    :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
     :type resource_id: str
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param project_id: Optional, Google Cloud Platform Project ID where the Compute
+        Engine Instance exists.  If set to None or missing, the default project_id from the GCP connection is
+        used.
+    :type project_id: str
+    :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud
+        Platform. Defaults to 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example v1 or beta).
+    :param api_version: Optional, API version used (for example v1 - or beta). Defaults
+        to v1.
     :type api_version: str
+    :param validate_body: Optional, If set to False, body validation is not performed.
+        Defaults to False.
     """
     # [START gce_instance_start_template_fields]
     template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
@@ -87,9 +90,9 @@ class GceInstanceStartOperator(GceBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  zone,
                  resource_id,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
                  *args, **kwargs):
@@ -98,24 +101,31 @@ def __init__(self,
             gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
 
     def execute(self, context):
-        return self._hook.start_instance(self.project_id, self.zone, self.resource_id)
+        return self._hook.start_instance(zone=self.zone,
+                                         resource_id=self.resource_id,
+                                         project_id=self.project_id)
 
 
 class GceInstanceStopOperator(GceBaseOperator):
     """
     Stops an instance in Google Compute Engine.
 
-    :param project_id: Google Cloud Platform Project ID where the Compute Engine
-        Instance exists.
-    :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
     :type resource_id: str
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param project_id: Optional, Google Cloud Platform Project ID where the Compute
+        Engine Instance exists. If set to None or missing, the default project_id from the GCP connection is
+        used.
+    :type project_id: str
+    :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud
+        Platform. Defaults to 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example v1 or beta).
+    :param api_version: Optional, API version used (for example v1 - or beta). Defaults
+        to v1.
     :type api_version: str
+    :param validate_body: Optional, If set to False, body validation is not performed.
+        Defaults to False.
     """
     # [START gce_instance_stop_template_fields]
     template_fields = ('project_id', 'zone', 'resource_id', 'gcp_conn_id', 'api_version')
@@ -123,9 +133,9 @@ class GceInstanceStopOperator(GceBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  zone,
                  resource_id,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
                  *args, **kwargs):
@@ -134,7 +144,9 @@ def __init__(self,
             gcp_conn_id=gcp_conn_id, api_version=api_version, *args, **kwargs)
 
     def execute(self, context):
-        return self._hook.stop_instance(self.project_id, self.zone, self.resource_id)
+        self._hook.stop_instance(zone=self.zone,
+                                 resource_id=self.resource_id,
+                                 project_id=self.project_id)
 
 
 SET_MACHINE_TYPE_VALIDATION_SPECIFICATION = [
@@ -147,9 +159,6 @@ class GceSetMachineTypeOperator(GceBaseOperator):
     Changes the machine type for a stopped instance to the machine type specified in
         the request.
 
-    :param project_id: Google Cloud Platform Project ID where the Compute Engine
-        Instance exists.
-    :type project_id: str
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
@@ -157,11 +166,18 @@ class GceSetMachineTypeOperator(GceBaseOperator):
     :param body: Body required by the Compute Engine setMachineType API, as described in
         https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType#request-body
     :type body: dict
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param project_id: Optional, Google Cloud Platform Project ID where the Compute
+        Engine Instance exists. If set to None or missing, the default project_id from the GCP connection
+        is used.
+    :type project_id: str
+    :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud
+        Platform. Defaults to 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example v1 or beta).
+    :param api_version: Optional, API version used (for example v1 - or beta). Defaults
+        to v1.
     :type api_version: str
-    :param validate_body: If set to False, body validation is not performed.
+    :param validate_body: Optional, If set to False, body validation is not performed.
+        Defaults to False.
     :type validate_body: bool
     """
     # [START gce_instance_set_machine_type_template_fields]
@@ -170,10 +186,10 @@ class GceSetMachineTypeOperator(GceBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  zone,
                  resource_id,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
                  validate_body=True,
@@ -193,8 +209,10 @@ def _validate_all_body_fields(self):
 
     def execute(self, context):
         self._validate_all_body_fields()
-        return self._hook.set_machine_type(self.project_id, self.zone,
-                                           self.resource_id, self.body)
+        return self._hook.set_machine_type(zone=self.zone,
+                                           resource_id=self.resource_id,
+                                           body=self.body,
+                                           project_id=self.project_id)
 
 
 GCE_INSTANCE_TEMPLATE_VALIDATION_PATCH_SPECIFICATION = [
@@ -249,9 +267,6 @@ class GceInstanceTemplateCopyOperator(GceBaseOperator):
     """
     Copies the instance template, applying specified changes.
 
-    :param project_id: Google Cloud Platform Project ID where the Compute Engine
-        instance exists.
-    :type project_id: str
     :param resource_id: Name of the Instance Template
     :type resource_id: str
     :param body_patch: Patch to the body of instanceTemplates object following rfc7386
@@ -262,16 +277,23 @@ class GceInstanceTemplateCopyOperator(GceBaseOperator):
         - arrays are replaced fully, so if you need to update an array you should
         provide the whole target array as patch element.
     :type body_patch: dict
+    :param project_id: Optional, Google Cloud Platform Project ID where the Compute
+        Engine Instance exists.  If set to None or missing, the default project_id from the GCP connection
+        is used.
+    :type project_id: str
     :param request_id: Optional, unique request_id that you might add to achieve
         full idempotence (for example when client call times out repeating the request
         with the same request id will not create a new instance template again).
         It should be in UUID format as defined in RFC 4122.
     :type request_id: str
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud
+        Platform. Defaults to 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example v1 or beta).
+    :param api_version: Optional, API version used (for example v1 - or beta). Defaults
+        to v1.
     :type api_version: str
-    :param validate_body: If set to False, body validation is not performed.
+    :param validate_body: Optional, If set to False, body validation is not performed.
+        Defaults to False.
     :type validate_body: bool
     """
     # [START gce_instance_template_copy_operator_template_fields]
@@ -281,9 +303,9 @@ class GceInstanceTemplateCopyOperator(GceBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  resource_id,
                  body_patch,
+                 project_id=None,
                  request_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
@@ -320,7 +342,7 @@ def execute(self, context):
             # that we cannot delete template if it is already used in some Instance
             # Group Manager. We assume success if the template is simply present
             existing_template = self._hook.get_instance_template(
-                project_id=self.project_id, resource_id=self.body_patch['name'])
+                resource_id=self.body_patch['name'], project_id=self.project_id)
             self.log.info("The {} template already existed. It was likely "
                           "created by previous run of the operator. Assuming success.")
             return existing_template
@@ -329,18 +351,18 @@ def execute(self, context):
             # not yet exist
             if not e.resp.status == 404:
                 raise e
-        old_body = self._hook.get_instance_template(project_id=self.project_id,
-                                                    resource_id=self.resource_id)
+        old_body = self._hook.get_instance_template(resource_id=self.resource_id,
+                                                    project_id=self.project_id)
         new_body = deepcopy(old_body)
         self._field_sanitizer.sanitize(new_body)
         new_body = merge(new_body, self.body_patch)
         self.log.info("Calling insert instance template with updated body: {}".
                       format(new_body))
-        self._hook.insert_instance_template(project_id=self.project_id,
-                                            body=new_body,
-                                            request_id=self.request_id)
-        return self._hook.get_instance_template(project_id=self.project_id,
-                                                resource_id=self.body_patch['name'])
+        self._hook.insert_instance_template(body=new_body,
+                                            request_id=self.request_id,
+                                            project_id=self.project_id)
+        return self._hook.get_instance_template(resource_id=self.body_patch['name'],
+                                                project_id=self.project_id)
 
 
 class GceInstanceGroupManagerUpdateTemplateOperator(GceBaseOperator):
@@ -349,26 +371,32 @@ class GceInstanceGroupManagerUpdateTemplateOperator(GceBaseOperator):
     destination one. API V1 does not have update/patch operations for Instance
     Group Manager, so you must use beta or newer API version. Beta is the default.
 
-    :param project_id: Google Cloud Platform Project ID where the Compute Engine
-        Instance exists.
-    :type project_id: str
     :param resource_id: Name of the Instance Group Manager
     :type resource_id: str
     :param zone: Google Cloud Platform zone where the Instance Group Manager exists.
     :type zone: str
+    :param source_template: URL of the template to replace.
+    :type source_template: str
+    :param destination_template: URL of the target template.
+    :type destination_template: str
+    :param project_id: Optional, Google Cloud Platform Project ID where the Compute
+        Engine Instance exists.  If set to None or missing, the default project_id from the GCP connection is
+        used.
+    :type project_id: str
     :param request_id: Optional, unique request_id that you might add to achieve
         full idempotence (for example when client call times out repeating the request
         with the same request id will not create a new instance template again).
-        It should be in UUID format as defined in RFC 4122
+        It should be in UUID format as defined in RFC 4122.
     :type request_id: str
-    :param update_policy: The update policy for this managed instance group. See
-        https://cloud.google.com/compute/docs/reference/rest/beta/instanceGroupManagers/patch
-        for details of the updatePolicy fields. It's an optional field.
-    :type dict
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud
+        Platform. Defaults to 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example beta).
+    :param api_version: Optional, API version used (for example v1 - or beta). Defaults
+        to v1.
     :type api_version: str
+    :param validate_body: Optional, If set to False, body validation is not performed.
+        Defaults to False.
+    :type validate_body: bool
     """
     # [START gce_igm_update_template_operator_template_fields]
     template_fields = ('project_id', 'resource_id', 'zone', 'request_id',
@@ -378,11 +406,11 @@ class GceInstanceGroupManagerUpdateTemplateOperator(GceBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  resource_id,
                  zone,
                  source_template,
                  destination_template,
+                 project_id=None,
                  update_policy=None,
                  request_id=None,
                  gcp_conn_id='google_cloud_default',
@@ -410,9 +438,7 @@ def _possibly_replace_template(self, dictionary):
 
     def execute(self, context):
         old_instance_group_manager = self._hook.get_instance_group_manager(
-            project_id=self.project_id,
-            zone=self.zone,
-            resource_id=self.resource_id)
+            zone=self.zone, resource_id=self.resource_id, project_id=self.project_id)
         patch_body = {}
         if 'versions' in old_instance_group_manager:
             patch_body['versions'] = old_instance_group_manager['versions']
@@ -428,8 +454,9 @@ def execute(self, context):
             self.log.info("Calling patch instance template with updated body: {}".
                           format(patch_body))
             return self._hook.patch_instance_group_manager(
-                project_id=self.project_id, zone=self.zone, resource_id=self.resource_id,
-                body=patch_body, request_id=self.request_id)
+                zone=self.zone, resource_id=self.resource_id,
+                body=patch_body, request_id=self.request_id,
+                project_id=self.project_id)
         else:
             # Idempotence achieved
             return True
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index 811dab7a157b2..420fd12bff0d7 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -83,9 +83,6 @@ class GcfFunctionDeployOperator(BaseOperator):
     Creates a function in Google Cloud Functions.
     If a function with this name already exists, it will be updated.
 
-    :param project_id: Google Cloud Platform project ID where the function should
-        be created.
-    :type project_id: str
     :param location: Google Cloud Platform region where the function should be created.
     :type location: str
     :param body: Body of the Cloud Functions definition. The body must be a
@@ -94,9 +91,14 @@ class GcfFunctionDeployOperator(BaseOperator):
         . Different API versions require different variants of the Cloud Functions
         dictionary.
     :type body: dict or google.cloud.functions.v1.CloudFunction
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param project_id: (Optional) Google Cloud Platform project ID where the function
+        should be created.
+    :type project_id: str
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud
+         Platform - default 'google_cloud_default'.
     :type gcp_conn_id: str
-    :param api_version: API version used (for example v1 or v1beta1).
+    :param api_version: (Optional) API version used (for example v1 - default -  or
+        v1beta1).
     :type api_version: str
     :param zip_path: Path to zip file containing source code of the function. If the path
         is set, the sourceUploadUrl should not be specified in the body or it should
@@ -112,9 +114,9 @@ class GcfFunctionDeployOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  location,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1',
                  zip_path=None,
@@ -122,8 +124,6 @@ def __init__(self,
                  *args, **kwargs):
         self.project_id = project_id
         self.location = location
-        self.full_location = 'projects/{}/locations/{}'.format(self.project_id,
-                                                               self.location)
         self.body = body
         self.gcp_conn_id = gcp_conn_id
         self.api_version = api_version
@@ -138,8 +138,6 @@ def __init__(self,
         super(GcfFunctionDeployOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
-            raise AirflowException("The required parameter 'project_id' is missing")
         if not self.location:
             raise AirflowException("The required parameter 'location' is missing")
         if not self.body:
@@ -151,7 +149,10 @@ def _validate_all_body_fields(self):
             self._field_validator.validate(self.body)
 
     def _create_new_function(self):
-        self._hook.create_new_function(self.full_location, self.body)
+        self._hook.create_new_function(
+            project_id=self.project_id,
+            location=self.location,
+            body=self.body)
 
     def _update_function(self):
         self._hook.update_function(self.body['name'], self.body, self.body.keys())
@@ -171,7 +172,8 @@ def _check_if_function_exists(self):
         return True
 
     def _upload_source_code(self):
-        return self._hook.upload_function_zip(parent=self.full_location,
+        return self._hook.upload_function_zip(project_id=self.project_id,
+                                              location=self.location,
                                               zip_path=self.zip_path)
 
     def _set_airflow_version_label(self):
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index 1cb4c7d47f069..a85e1aeb76020 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -29,8 +29,6 @@ class CloudSpannerInstanceDeployOperator(BaseOperator):
     Creates a new Cloud Spanner instance, or if an instance with the same instance_id
     exists in the specified project, updates the Cloud Spanner instance.
 
-    :param project_id: The ID of the project which owns the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: Cloud Spanner instance ID.
     :type instance_id: str
     :param configuration_name:  The name of the Cloud Spanner instance configuration
@@ -44,6 +42,9 @@ class CloudSpannerInstanceDeployOperator(BaseOperator):
       the GCP Console. (Must be between 4 and 30 characters.) If this value is not set
       in the constructor, the name is the same as the instance ID.
     :type display_name: str
+    :param project_id: Optional, the ID of the project which owns the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
@@ -54,11 +55,11 @@ class CloudSpannerInstanceDeployOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  configuration_name,
                  node_count,
                  display_name,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
         self.instance_id = instance_id
@@ -72,23 +73,24 @@ def __init__(self,
         super(CloudSpannerInstanceDeployOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' "
+                                   "is empty or None")
 
     def execute(self, context):
-        if not self._hook.get_instance(self.project_id, self.instance_id):
+        if not self._hook.get_instance(project_id=self.project_id, instance_id=self.instance_id):
             self.log.info("Creating Cloud Spanner instance '%s'", self.instance_id)
             func = self._hook.create_instance
         else:
             self.log.info("Updating Cloud Spanner instance '%s'", self.instance_id)
             func = self._hook.update_instance
-        return func(self.project_id,
-                    self.instance_id,
-                    self.configuration_name,
-                    self.node_count,
-                    self.display_name)
+        func(project_id=self.project_id,
+             instance_id=self.instance_id,
+             configuration_name=self.configuration_name,
+             node_count=self.node_count,
+             display_name=self.display_name)
 
 
 class CloudSpannerInstanceDeleteOperator(BaseOperator):
@@ -96,10 +98,11 @@ class CloudSpannerInstanceDeleteOperator(BaseOperator):
     Deletes a Cloud Spanner instance. If an instance does not exist,
     no action is taken and the operator succeeds.
 
-    :param project_id: The ID of the project that owns the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
+    :param project_id: Optional, the ID of the project that owns the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
@@ -109,8 +112,8 @@ class CloudSpannerInstanceDeleteOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
         self.instance_id = instance_id
@@ -121,15 +124,16 @@ def __init__(self,
         super(CloudSpannerInstanceDeleteOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' "
+                                   "is empty or None")
 
     def execute(self, context):
-        if self._hook.get_instance(self.project_id, self.instance_id):
-            return self._hook.delete_instance(self.project_id,
-                                              self.instance_id)
+        if self._hook.get_instance(project_id=self.project_id, instance_id=self.instance_id):
+            return self._hook.delete_instance(project_id=self.project_id,
+                                              instance_id=self.instance_id)
         else:
             self.log.info("Instance '%s' does not exist in project '%s'. "
                           "Aborting delete.", self.instance_id, self.project_id)
@@ -140,8 +144,6 @@ class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
     """
     Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
-    :param project_id: The ID of the project that owns the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
@@ -149,6 +151,9 @@ class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
     :param query: The query or list of queries to be executed. Can be a path to a SQL
        file.
     :type query: str or list
+    :param project_id: Optional, the ID of the project that owns the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
@@ -159,10 +164,10 @@ class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  database_id,
                  query,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
         self.instance_id = instance_id
@@ -175,12 +180,14 @@ def __init__(self,
         super(CloudSpannerInstanceDatabaseQueryOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' "
+                                   "is empty or None")
         if not self.database_id:
-            raise AirflowException("The required parameter 'database_id' is empty")
+            raise AirflowException("The required parameter 'database_id' "
+                                   "is empty or None")
         if not self.query:
             raise AirflowException("The required parameter 'query' is empty")
 
@@ -193,8 +200,10 @@ def execute(self, context):
                       "projects/%s/instances/%s/databases/%s",
                       self.project_id, self.instance_id, self.database_id)
         self.log.info(queries)
-        self._hook.execute_dml(self.project_id, self.instance_id,
-                               self.database_id, queries)
+        self._hook.execute_dml(project_id=self.project_id,
+                               instance_id=self.instance_id,
+                               database_id=self.database_id,
+                               queries=queries)
 
     @staticmethod
     def sanitize_queries(queries):
@@ -207,14 +216,15 @@ class CloudSpannerInstanceDatabaseDeployOperator(BaseOperator):
     Creates a new Cloud Spanner database, or if database exists,
     the operator does nothing.
 
-    :param project_id: The ID of the project that owns the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
     :type database_id: str
     :param ddl_statements: The string list containing DDL for the new database.
     :type ddl_statements: list of str
+    :param project_id: Optional, the ID of the project that owns the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
@@ -226,10 +236,10 @@ class CloudSpannerInstanceDatabaseDeployOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  database_id,
                  ddl_statements,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
         self.instance_id = instance_id
@@ -242,19 +252,19 @@ def __init__(self,
         super(CloudSpannerInstanceDatabaseDeployOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' is empty "
+                                   "or None")
         if not self.database_id:
-            raise AirflowException("The required parameter 'database_id' is empty")
-        if not self.ddl_statements:
-            raise AirflowException("The required parameter 'ddl_statements' is empty")
+            raise AirflowException("The required parameter 'database_id' is empty"
+                                   " or None")
 
     def execute(self, context):
-        if not self._hook.get_database(self.project_id,
-                                       self.instance_id,
-                                       self.database_id):
+        if not self._hook.get_database(project_id=self.project_id,
+                                       instance_id=self.instance_id,
+                                       database_id=self.database_id):
             self.log.info("Creating Cloud Spanner database "
                           "'%s' in project '%s' and instance '%s'",
                           self.database_id, self.project_id, self.instance_id)
@@ -273,14 +283,15 @@ class CloudSpannerInstanceDatabaseUpdateOperator(BaseOperator):
     """
     Updates a Cloud Spanner database with the specified DDL statement.
 
-    :param project_id: The ID of the project that owns the the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
     :type database_id: str
     :param ddl_statements: The string list containing DDL to apply to the database.
     :type ddl_statements: list[str]
+    :param project_id: Optional, the ID of the project that owns the the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param operation_id: (Optional) Unique per database operation id that can
            be specified to implement idempotency check.
     :type operation_id: str
@@ -295,10 +306,10 @@ class CloudSpannerInstanceDatabaseUpdateOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  database_id,
                  ddl_statements,
+                 project_id=None,
                  operation_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
@@ -313,19 +324,22 @@ def __init__(self,
         super(CloudSpannerInstanceDatabaseUpdateOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' is empty"
+                                   " or None")
         if not self.database_id:
-            raise AirflowException("The required parameter 'database_id' is empty")
+            raise AirflowException("The required parameter 'database_id' is empty"
+                                   " or None")
         if not self.ddl_statements:
-            raise AirflowException("The required parameter 'ddl_statements' is empty")
+            raise AirflowException("The required parameter 'ddl_statements' is empty"
+                                   " or None")
 
     def execute(self, context):
-        if not self._hook.get_database(self.project_id,
-                                       self.instance_id,
-                                       self.database_id):
+        if not self._hook.get_database(project_id=self.project_id,
+                                       instance_id=self.instance_id,
+                                       database_id=self.database_id):
             raise AirflowException("The Cloud Spanner database '{}' in project '{}' and "
                                    "instance '{}' is missing. Create the database first "
                                    "before you can update it.".format(self.database_id,
@@ -343,12 +357,13 @@ class CloudSpannerInstanceDatabaseDeleteOperator(BaseOperator):
     """
     Deletes a Cloud Spanner database.
 
-    :param project_id: The ID of the project that owns the Cloud Spanner Database.
-    :type project_id: str
     :param instance_id: Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: Cloud Spanner database ID.
     :type database_id: str
+    :param project_id: Optional, the ID of the project that owns the Cloud Spanner
+        Database.  If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
@@ -359,9 +374,9 @@ class CloudSpannerInstanceDatabaseDeleteOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance_id,
                  database_id,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  *args, **kwargs):
         self.instance_id = instance_id
@@ -373,17 +388,19 @@ def __init__(self,
         super(CloudSpannerInstanceDatabaseDeleteOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance_id:
-            raise AirflowException("The required parameter 'instance_id' is empty")
+            raise AirflowException("The required parameter 'instance_id' is empty"
+                                   " or None")
         if not self.database_id:
-            raise AirflowException("The required parameter 'database_id' is empty")
+            raise AirflowException("The required parameter 'database_id' is empty"
+                                   " or None")
 
     def execute(self, context):
-        db = self._hook.get_database(self.project_id,
-                                     self.instance_id,
-                                     self.database_id)
+        db = self._hook.get_database(project_id=self.project_id,
+                                     instance_id=self.instance_id,
+                                     database_id=self.database_id)
         if not db:
             self.log.info("The Cloud Spanner database was missing: "
                           "'%s' in project '%s' and instance '%s'. Assuming success.",
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index e5c6cb8dbccfb..5a7f348984ec0 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -23,6 +23,7 @@
 from airflow.contrib.utils.gcp_field_validator import GcpBodyFieldValidator
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
+from airflow.hooks.base_hook import BaseHook
 
 SETTINGS = 'settings'
 SETTINGS_VERSION = 'settingsVersion'
@@ -136,10 +137,11 @@ class CloudSqlBaseOperator(BaseOperator):
     """
     Abstract base operator for Google Cloud SQL operators to inherit from.
 
-    :param project_id: Project ID of the Google Cloud Platform project to operate it.
-    :type project_id: str
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
+    :param project_id: Optional, Google Cloud Platform Project ID.  f set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -147,8 +149,8 @@ class CloudSqlBaseOperator(BaseOperator):
     """
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  *args, **kwargs):
@@ -162,14 +164,15 @@ def __init__(self,
         super(CloudSqlBaseOperator, self).__init__(*args, **kwargs)
 
     def _validate_inputs(self):
-        if not self.project_id:
+        if self.project_id == '':
             raise AirflowException("The required parameter 'project_id' is empty")
         if not self.instance:
-            raise AirflowException("The required parameter 'instance' is empty")
+            raise AirflowException("The required parameter 'instance' is empty or None")
 
     def _check_if_instance_exists(self, instance):
         try:
-            return self._hook.get_instance(self.project_id, instance)
+            return self._hook.get_instance(project_id=self.project_id,
+                                           instance=instance)
         except HttpError as e:
             status = e.resp.status
             if status == 404:
@@ -178,7 +181,10 @@ def _check_if_instance_exists(self, instance):
 
     def _check_if_db_exists(self, db_name):
         try:
-            return self._hook.get_database(self.project_id, self.instance, db_name)
+            return self._hook.get_database(
+                project_id=self.project_id,
+                instance=self.instance,
+                database=db_name)
         except HttpError as e:
             status = e.resp.status
             if status == 404:
@@ -199,15 +205,15 @@ class CloudSqlInstanceCreateOperator(CloudSqlBaseOperator):
     If an instance with the same name exists, no action will be taken and
     the operator will succeed.
 
-    :param project_id: Project ID of the project to which the newly created Cloud SQL
-        instances should belong.
-    :type project_id: str
     :param body: Body required by the Cloud SQL insert API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert
         #request-body
     :type body: dict
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -221,9 +227,9 @@ class CloudSqlInstanceCreateOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  body,
                  instance,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  validate_body=True,
@@ -247,12 +253,15 @@ def _validate_body_fields(self):
     def execute(self, context):
         self._validate_body_fields()
         if not self._check_if_instance_exists(self.instance):
-            self._hook.create_instance(self.project_id, self.body)
+            self._hook.create_instance(
+                project_id=self.project_id,
+                body=self.body)
         else:
             self.log.info("Cloud SQL instance with ID {} already exists. "
                           "Aborting create.".format(self.instance))
 
-        instance_resource = self._hook.get_instance(self.project_id, self.instance)
+        instance_resource = self._hook.get_instance(project_id=self.project_id,
+                                                    instance=self.instance)
         service_account_email = instance_resource["serviceAccountEmailAddress"]
         task_instance = context['task_instance']
         task_instance.xcom_push(key="service_account_email", value=service_account_email)
@@ -269,13 +278,14 @@ class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
     to the rules of patch semantics.
     https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
-    :param project_id: Project ID of the project that contains the instance.
-    :type project_id: str
     :param body: Body required by the Cloud SQL patch API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
     :type body: dict
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
+    :param project_id: Optional, Google Cloud Platform Project ID.  If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -287,9 +297,9 @@ class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  body,
                  instance,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  *args, **kwargs):
@@ -309,17 +319,21 @@ def execute(self, context):
                                    'Please specify another instance to patch.'
                                    .format(self.instance))
         else:
-            return self._hook.patch_instance(self.project_id, self.body, self.instance)
+            return self._hook.patch_instance(
+                project_id=self.project_id,
+                body=self.body,
+                instance=self.instance)
 
 
 class CloudSqlInstanceDeleteOperator(CloudSqlBaseOperator):
     """
     Deletes a Cloud SQL instance.
 
-    :param project_id: Project ID of the project that contains the instance to be deleted.
-    :type project_id: str
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -331,8 +345,8 @@ class CloudSqlInstanceDeleteOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  *args, **kwargs):
@@ -346,20 +360,23 @@ def execute(self, context):
                   .format(self.instance))
             return True
         else:
-            return self._hook.delete_instance(self.project_id, self.instance)
+            return self._hook.delete_instance(
+                project_id=self.project_id,
+                instance=self.instance)
 
 
 class CloudSqlInstanceDatabaseCreateOperator(CloudSqlBaseOperator):
     """
     Creates a new database inside a Cloud SQL instance.
 
-    :param project_id: Project ID of the project that contains the instance.
-    :type project_id: str
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert#request-body
     :type body: dict
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -373,9 +390,9 @@ class CloudSqlInstanceDatabaseCreateOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  validate_body=True,
@@ -410,7 +427,9 @@ def execute(self, context):
                           .format(self.instance, database))
             return True
         else:
-            return self._hook.create_database(self.project_id, self.instance, self.body)
+            return self._hook.create_database(project_id=self.project_id,
+                                              instance=self.instance,
+                                              body=self.body)
 
 
 class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
@@ -419,8 +438,6 @@ class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
     instance using patch semantics.
     See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
-    :param project_id: Project ID of the project that contains the instance.
-    :type project_id: str
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param database: Name of the database to be updated in the instance.
@@ -428,6 +445,8 @@ class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
     :param body: The request body, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch#request-body
     :type body: dict
+    :param project_id: Optional, Google Cloud Platform Project ID.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -442,10 +461,10 @@ class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
                  database,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  validate_body=True,
@@ -477,20 +496,24 @@ def execute(self, context):
                                    "Please specify another database to patch."
                                    .format(self.instance, self.database))
         else:
-            return self._hook.patch_database(self.project_id, self.instance,
-                                             self.database, self.body)
+            return self._hook.patch_database(
+                project_id=self.project_id,
+                instance=self.instance,
+                database=self.database,
+                body=self.body)
 
 
 class CloudSqlInstanceDatabaseDeleteOperator(CloudSqlBaseOperator):
     """
     Deletes a database from a Cloud SQL instance.
 
-    :param project_id: Project ID of the project that contains the instance.
-    :type project_id: str
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param database: Name of the database to be deleted in the instance.
     :type database: str
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -503,9 +526,9 @@ class CloudSqlInstanceDatabaseDeleteOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
                  database,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  *args, **kwargs):
@@ -526,8 +549,10 @@ def execute(self, context):
                   .format(self.instance, self.database))
             return True
         else:
-            return self._hook.delete_database(self.project_id, self.instance,
-                                              self.database)
+            return self._hook.delete_database(
+                project_id=self.project_id,
+                instance=self.instance,
+                database=self.database)
 
 
 class CloudSqlInstanceExportOperator(CloudSqlBaseOperator):
@@ -538,14 +563,14 @@ class CloudSqlInstanceExportOperator(CloudSqlBaseOperator):
     Note: This operator is idempotent. If executed multiple times with the same
     export file URI, the export file in GCS will simply be overridden.
 
-    :param project_id: Project ID of the project that contains the instance to be
-        exported.
-    :type project_id: str
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
     :type body: dict
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -559,9 +584,9 @@ class CloudSqlInstanceExportOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  validate_body=True,
@@ -584,7 +609,10 @@ def _validate_body_fields(self):
 
     def execute(self, context):
         self._validate_body_fields()
-        return self._hook.export_instance(self.project_id, self.instance, self.body)
+        return self._hook.export_instance(
+            project_id=self.project_id,
+            instance=self.instance,
+            body=self.body)
 
 
 class CloudSqlInstanceImportOperator(CloudSqlBaseOperator):
@@ -607,13 +635,14 @@ class CloudSqlInstanceImportOperator(CloudSqlBaseOperator):
     If the import file was generated in a different way, idempotence is not guaranteed.
     It has to be ensured on the SQL file level.
 
-    :param project_id: Project ID of the project that contains the instance.
-    :type project_id: str
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export#request-body
     :type body: dict
+    :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
+            the default project_id from the GCP connection is used.
+    :type project_id: str
     :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     :param api_version: API version used (e.g. v1beta4).
@@ -627,9 +656,9 @@ class CloudSqlInstanceImportOperator(CloudSqlBaseOperator):
 
     @apply_defaults
     def __init__(self,
-                 project_id,
                  instance,
                  body,
+                 project_id=None,
                  gcp_conn_id='google_cloud_default',
                  api_version='v1beta4',
                  validate_body=True,
@@ -652,7 +681,10 @@ def _validate_body_fields(self):
 
     def execute(self, context):
         self._validate_body_fields()
-        return self._hook.import_instance(self.project_id, self.instance, self.body)
+        return self._hook.import_instance(
+            project_id=self.project_id,
+            instance=self.instance,
+            body=self.body)
 
 
 class CloudSqlQueryOperator(BaseOperator):
@@ -699,8 +731,11 @@ def __init__(self,
         self.gcp_cloudsql_conn_id = gcp_cloudsql_conn_id
         self.autocommit = autocommit
         self.parameters = parameters
+        self.gcp_connection = BaseHook.get_connection(self.gcp_conn_id)
         self.cloudsql_db_hook = CloudSqlDatabaseHook(
-            gcp_cloudsql_conn_id=gcp_cloudsql_conn_id)
+            gcp_cloudsql_conn_id=gcp_cloudsql_conn_id,
+            default_gcp_project_id=self.gcp_connection.extra_dejson.get(
+                'extra__google_cloud_platform__project'))
         self.cloud_sql_proxy_runner = None
         self.database_hook = None
 
@@ -708,6 +743,7 @@ def execute(self, context):
         self.cloudsql_db_hook.validate_ssl_certs()
         self.cloudsql_db_hook.create_connection()
         try:
+            self.cloudsql_db_hook.validate_socket_path_length()
             self.database_hook = self.cloudsql_db_hook.get_database_hook()
             try:
                 try:
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 404bd0e6578d3..2bf78e63cd078 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -144,12 +144,24 @@ The following examples of OS environment variables used to pass arguments to the
 Using the operator
 """"""""""""""""""
 
+The code to create the operator:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_start]
     :end-before: [END howto_operator_gce_start]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection id used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_start_no_project_id]
+    :end-before: [END howto_operator_gce_start_no_project_id]
+
+
 Templating
 """"""""""
 
@@ -187,12 +199,23 @@ The following examples of OS environment variables used to pass arguments to the
 Using the operator
 """"""""""""""""""
 
+The code to create the operator:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_stop]
     :end-before: [END howto_operator_gce_stop]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_stop_no_project_id]
+    :end-before: [END howto_operator_gce_stop_no_project_id]
+
 Templating
 """"""""""
 
@@ -236,12 +259,23 @@ The following examples of OS environment variables used to pass arguments to the
 Using the operator
 """"""""""""""""""
 
+The code to create the operator:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_set_machine_type]
     :end-before: [END howto_operator_gce_set_machine_type]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_set_machine_type_no_project_id]
+    :end-before: [END howto_operator_gce_set_machine_type_no_project_id]
+
 Templating
 """"""""""
 
@@ -285,12 +319,23 @@ The following examples of OS environment variables used to pass arguments to the
 Using the operator
 """"""""""""""""""
 
+The code to create the operator:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_copy_template]
     :end-before: [END howto_operator_gce_igm_copy_template]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_copy_template_no_project_id]
+    :end-before: [END howto_operator_gce_igm_copy_template_no_project_id]
+
 Templating
 """"""""""
 
@@ -332,12 +377,24 @@ The following examples of OS environment variables used to pass arguments to the
 Using the operator
 """"""""""""""""""
 
+The code to create the operator:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_update_template]
     :end-before: [END howto_operator_gce_igm_update_template]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_update_template_no_project_id]
+    :end-before: [END howto_operator_gce_igm_update_template_no_project_id]
+
+
 Templating
 """"""""""
 
@@ -387,13 +444,15 @@ and immediately succeeds. No changes are made to the existing instance.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_instance_create]
     :end-before: [END howto_operator_gcp_bigtable_instance_create]
 
-
 BigtableInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -403,6 +462,9 @@ to delete a Google Cloud Bigtable instance.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
@@ -418,13 +480,15 @@ to modify number of nodes in a Cloud Bigtable cluster.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_cluster_update]
     :end-before: [END howto_operator_gcp_bigtable_cluster_update]
 
-
 BigtableTableCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -438,6 +502,9 @@ error message.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
@@ -462,6 +529,9 @@ to delete a table in Google Cloud Bigtable.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
@@ -471,6 +541,9 @@ Using the operator
 BigtableTableWaitForReplicationSensor
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor`
 to wait for the table to replicate fully.
 
@@ -488,8 +561,6 @@ Using the operator
     :start-after: [START howto_operator_gcp_bigtable_table_wait_for_replication]
     :end-before: [END howto_operator_gcp_bigtable_table_wait_for_replication]
 
-
-
 Google Cloud Functions Operators
 --------------------------------
 
@@ -609,6 +680,15 @@ The code to create the operator:
     :start-after: [START howto_operator_gcf_deploy]
     :end-before: [END howto_operator_gcf_deploy]
 
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcf_deploy_no_project_id]
+    :end-before: [END howto_operator_gcf_deploy_no_project_id]
+
 Templating
 """"""""""
 
@@ -684,6 +764,9 @@ Some arguments in the example DAG are taken from environment variables.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
@@ -730,6 +813,9 @@ Some arguments in the example DAG are taken from environment variables.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
@@ -779,12 +865,21 @@ Some arguments in the example DAG are taken from environment variables.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_database_update]
     :end-before: [END howto_operator_spanner_database_update]
 
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_update_idempotent]
+    :end-before: [END howto_operator_spanner_database_update_idempotent]
+
 Templating
 """"""""""
 
@@ -821,6 +916,9 @@ Some arguments in the example DAG are taken from environment variables.
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
@@ -864,6 +962,9 @@ Some arguments in the example DAG are taken from environment variables:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
@@ -909,6 +1010,9 @@ Some arguments in the example DAG are taken from environment variables:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -958,6 +1062,9 @@ Some arguments in the example DAG are taken from environment variables:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1002,6 +1109,9 @@ Some arguments in the example DAG are taken from environment variables:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1051,6 +1161,9 @@ Some arguments in the example DAG are taken from OS environment variables:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1111,6 +1224,9 @@ Example body defining the export operation:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1205,6 +1321,9 @@ Example body defining the import operation:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1277,6 +1396,9 @@ Example body defining the instance:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
@@ -1332,6 +1454,9 @@ Example body defining the instance:
 Using the operator
 """"""""""""""""""
 
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
diff --git a/tests/contrib/hooks/test_gcp_bigtable_hook.py b/tests/contrib/hooks/test_gcp_bigtable_hook.py
new file mode 100644
index 0000000000000..ea86ff9d756b6
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_bigtable_hook.py
@@ -0,0 +1,372 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import google
+
+import unittest
+
+from google.cloud.bigtable import Client
+from google.cloud.bigtable.instance import Instance
+
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
+    mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_bigtable_hook import BigtableHook
+
+CBT_INSTANCE = 'instance'
+CBT_CLUSTER = 'cluster'
+CBT_ZONE = 'zone'
+CBT_TABLE = 'table'
+
+
+class TestBigtableHookNoDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_no_default_project_id):
+            self.bigtable_hook_no_default_project_id = BigtableHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.bigtable_hook_no_default_project_id.get_instance(instance_id=CBT_INSTANCE)
+        instance_exists_method.assert_not_called()
+        instance_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.bigtable_hook_no_default_project_id.get_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='example-project')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        delete_method = instance_method.return_value.delete
+        instance_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.bigtable_hook_no_default_project_id.delete_instance(instance_id=CBT_INSTANCE)
+        instance_exists_method.assert_not_called()
+        instance_method.assert_not_called()
+        delete_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        res = self.bigtable_hook_no_default_project_id.delete_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST, instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        delete_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='example-project')
+        self.assertIsNone(res)
+
+    @mock.patch('google.cloud.bigtable.instance.Instance.create')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_create_instance_missing_project_id(self, get_client, instance_create):
+        operation = mock.Mock()
+        operation.result_return_value = Instance(instance_id=CBT_INSTANCE, client=get_client)
+        instance_create.return_value = operation
+        with self.assertRaises(AirflowException) as cm:
+            self.bigtable_hook_no_default_project_id.create_instance(
+                instance_id=CBT_INSTANCE,
+                main_cluster_id=CBT_CLUSTER,
+                main_cluster_zone=CBT_ZONE)
+        get_client.assert_not_called()
+        instance_create.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('google.cloud.bigtable.instance.Instance.create')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_create_instance_overridden_project_id(self, get_client, instance_create):
+        operation = mock.Mock()
+        operation.result_return_value = Instance(instance_id=CBT_INSTANCE, client=get_client)
+        instance_create.return_value = operation
+        res = self.bigtable_hook_no_default_project_id.create_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=CBT_INSTANCE,
+            main_cluster_id=CBT_CLUSTER,
+            main_cluster_zone=CBT_ZONE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_create.assert_called_once_with(clusters=mock.ANY)
+        self.assertEquals(res.instance_id, 'instance')
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_table_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        table_delete_method = instance_method.return_value.table.return_value.delete
+        instance_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.bigtable_hook_no_default_project_id.delete_table(
+                instance_id=CBT_INSTANCE,
+                table_id=CBT_TABLE)
+        get_client.assert_not_called()
+        instance_exists_method.assert_not_called()
+        table_delete_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_table_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        table_delete_method = instance_method.return_value.table.return_value.delete
+        instance_exists_method.return_value = True
+        self.bigtable_hook_no_default_project_id.delete_table(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=CBT_INSTANCE,
+            table_id=CBT_TABLE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_exists_method.assert_called_once_with()
+        table_delete_method.assert_called_once_with()
+
+
+class TestBigtableHookDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_default_project_id):
+            self.bigtable_hook_default_project_id = BigtableHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.bigtable_hook_default_project_id.get_instance(
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='example-project')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.bigtable_hook_default_project_id.get_instance(
+            project_id='new-project',
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='new-project')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_instance_no_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = False
+        res = self.bigtable_hook_default_project_id.get_instance(
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='example-project')
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        res = self.bigtable_hook_default_project_id.delete_instance(
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        delete_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='example-project')
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        res = self.bigtable_hook_default_project_id.delete_instance(
+            project_id='new-project', instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        delete_method.assert_called_once_with()
+        get_client.assert_called_once_with(project_id='new-project')
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_instance_no_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = False
+        delete_method = instance_method.return_value.delete
+        self.bigtable_hook_default_project_id.delete_instance(
+            instance_id=CBT_INSTANCE)
+        instance_method.assert_called_once_with('instance')
+        instance_exists_method.assert_called_once_with()
+        delete_method.assert_not_called()
+        get_client.assert_called_once_with(project_id='example-project')
+
+    @mock.patch('google.cloud.bigtable.instance.Instance.create')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_create_instance(self, get_client, instance_create):
+        operation = mock.Mock()
+        operation.result_return_value = Instance(instance_id=CBT_INSTANCE, client=get_client)
+        instance_create.return_value = operation
+        res = self.bigtable_hook_default_project_id.create_instance(
+            instance_id=CBT_INSTANCE,
+            main_cluster_id=CBT_CLUSTER,
+            main_cluster_zone=CBT_ZONE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_create.assert_called_once_with(clusters=mock.ANY)
+        self.assertEquals(res.instance_id, 'instance')
+
+    @mock.patch('google.cloud.bigtable.instance.Instance.create')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_create_instance_overridden_project_id(self, get_client, instance_create):
+        operation = mock.Mock()
+        operation.result_return_value = Instance(instance_id=CBT_INSTANCE, client=get_client)
+        instance_create.return_value = operation
+        res = self.bigtable_hook_default_project_id.create_instance(
+            project_id='new-project',
+            instance_id=CBT_INSTANCE,
+            main_cluster_id=CBT_CLUSTER,
+            main_cluster_zone=CBT_ZONE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_create.assert_called_once_with(clusters=mock.ANY)
+        self.assertEquals(res.instance_id, 'instance')
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_table(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        table_delete_method = instance_method.return_value.table.return_value.delete
+        instance_exists_method.return_value = True
+        self.bigtable_hook_default_project_id.delete_table(
+            instance_id=CBT_INSTANCE,
+            table_id=CBT_TABLE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_exists_method.assert_called_once_with()
+        table_delete_method.assert_called_once_with()
+
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_delete_table_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        table_delete_method = instance_method.return_value.table.return_value.delete
+        instance_exists_method.return_value = True
+        self.bigtable_hook_default_project_id.delete_table(
+            project_id='new-project',
+            instance_id=CBT_INSTANCE,
+            table_id=CBT_TABLE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_exists_method.assert_called_once_with()
+        table_delete_method.assert_called_once_with()
+
+    @mock.patch('google.cloud.bigtable.table.Table.create')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_create_table(self, get_client, create):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        client = mock.Mock(Client)
+        instance = google.cloud.bigtable.instance.Instance(
+            instance_id=CBT_INSTANCE,
+            client=client)
+        self.bigtable_hook_default_project_id.create_table(
+            instance=instance,
+            table_id=CBT_TABLE)
+        get_client.assert_not_called()
+        create.assert_called_once_with([], {})
+
+    @mock.patch('google.cloud.bigtable.cluster.Cluster.update')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_update_cluster(self, get_client, update):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        client = mock.Mock(Client)
+        instance = google.cloud.bigtable.instance.Instance(
+            instance_id=CBT_INSTANCE,
+            client=client)
+        self.bigtable_hook_default_project_id.update_cluster(
+            instance=instance,
+            cluster_id=CBT_CLUSTER,
+            nodes=4)
+        get_client.assert_not_called()
+        update.assert_called_once_with()
+
+    @mock.patch('google.cloud.bigtable.table.Table.list_column_families')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_list_column_families(self, get_client, list_column_families):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        client = mock.Mock(Client)
+        get_client.return_value = client
+        instance = google.cloud.bigtable.instance.Instance(
+            instance_id=CBT_INSTANCE,
+            client=client)
+        self.bigtable_hook_default_project_id.get_column_families_for_table(
+            instance=instance, table_id=CBT_TABLE)
+        get_client.assert_not_called()
+        list_column_families.assert_called_once_with()
+
+    @mock.patch('google.cloud.bigtable.table.Table.get_cluster_states')
+    @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
+    def test_get_cluster_states(self, get_client, get_cluster_states):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        client = mock.Mock(Client)
+        instance = google.cloud.bigtable.instance.Instance(
+            instance_id=CBT_INSTANCE,
+            client=client)
+        self.bigtable_hook_default_project_id.get_cluster_states_for_table(
+            instance=instance, table_id=CBT_TABLE)
+        get_client.assert_not_called()
+        get_cluster_states.assert_called_once_with()
diff --git a/tests/contrib/hooks/test_gcp_compute_hook.py b/tests/contrib/hooks/test_gcp_compute_hook.py
new file mode 100644
index 0000000000000..59cab2650636b
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_compute_hook.py
@@ -0,0 +1,576 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
+    mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_compute_hook import GceHook
+
+GCE_ZONE = 'zone'
+GCE_INSTANCE = 'instance'
+GCE_INSTANCE_TEMPLATE = 'instance-template'
+GCE_REQUEST_ID = 'request_id'
+GCE_INSTANCE_GROUP_MANAGER = 'instance_group_manager'
+
+
+class TestGcpComputeHookNoDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_no_default_project_id):
+            self.gce_hook_no_project_id = GceHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_start_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        start_method = get_conn.return_value.instances.return_value.start
+        execute_method = start_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.start_instance(
+            project_id='example-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        start_method.assert_called_once_with(instance='instance', project='example-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_start_instance_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        start_method = get_conn.return_value.instances.return_value.start
+        execute_method = start_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.start_instance(
+                zone=GCE_ZONE,
+                resource_id=GCE_INSTANCE)
+        start_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_stop_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        stop_method = get_conn.return_value.instances.return_value.stop
+        execute_method = stop_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.stop_instance(
+            project_id='example-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        stop_method.assert_called_once_with(instance='instance', project='example-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_stop_instance_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        stop_method = get_conn.return_value.instances.return_value.stop
+        execute_method = stop_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.stop_instance(
+                zone=GCE_ZONE,
+                resource_id=GCE_INSTANCE)
+        stop_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_set_machine_type_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        set_machine_type_method = get_conn.return_value.instances.return_value.setMachineType
+        execute_method = set_machine_type_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.set_machine_type(
+            body={},
+            project_id='example-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        set_machine_type_method.assert_called_once_with(body={}, instance='instance',
+                                                        project='example-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_set_machine_type_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        set_machine_type_method = get_conn.return_value.instances.return_value.setMachineType
+        execute_method = set_machine_type_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.set_machine_type(
+                body={},
+                zone=GCE_ZONE,
+                resource_id=GCE_INSTANCE)
+        set_machine_type_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_template_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceTemplates.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.get_instance_template(
+            resource_id=GCE_INSTANCE_TEMPLATE,
+            project_id='example-project'
+        )
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceTemplate='instance-template', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_template_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceTemplates.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.get_instance_template(
+                resource_id=GCE_INSTANCE_TEMPLATE
+            )
+        get_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_insert_instance_template_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instanceTemplates.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.insert_instance_template(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='example-project', requestId='request_id')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_insert_instance_template_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instanceTemplates.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.insert_instance_template(
+                body={},
+                request_id=GCE_REQUEST_ID
+            )
+        insert_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_group_manager_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceGroupManagers.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.get_instance_group_manager(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER
+        )
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceGroupManager='instance_group_manager',
+                                           project='example-project',
+                                           zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_group_manager_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceGroupManagers.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.get_instance_group_manager(
+                zone=GCE_ZONE,
+                resource_id=GCE_INSTANCE_GROUP_MANAGER
+            )
+        get_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_patch_instance_group_manager_overridden_project_id(self,
+                                                                wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instanceGroupManagers.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook_no_project_id.patch_instance_group_manager(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER,
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(
+            body={},
+            instanceGroupManager='instance_group_manager',
+            project='example-project',
+            requestId='request_id',
+            zone='zone'
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id',
+                                                               project_id='example-project',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_patch_instance_group_manager_no_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instanceGroupManagers.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gce_hook_no_project_id.patch_instance_group_manager(
+                zone=GCE_ZONE,
+                resource_id=GCE_INSTANCE_GROUP_MANAGER,
+                body={},
+                request_id=GCE_REQUEST_ID
+            )
+        patch_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+
+class TestGcpComputeHookDefaultProjectId(unittest.TestCase):
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_default_project_id):
+            self.gce_hook = GceHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_start_instance(self, wait_for_operation_to_complete, get_conn):
+        start_method = get_conn.return_value.instances.return_value.start
+        execute_method = start_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.start_instance(
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        start_method.assert_called_once_with(instance='instance', project='example-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_start_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        start_method = get_conn.return_value.instances.return_value.start
+        execute_method = start_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.start_instance(
+            project_id='new-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        start_method.assert_called_once_with(instance='instance', project='new-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_stop_instance(self, wait_for_operation_to_complete, get_conn):
+        stop_method = get_conn.return_value.instances.return_value.stop
+        execute_method = stop_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.stop_instance(
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        stop_method.assert_called_once_with(instance='instance', project='example-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_stop_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        stop_method = get_conn.return_value.instances.return_value.stop
+        execute_method = stop_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.stop_instance(
+            project_id='new-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        stop_method.assert_called_once_with(instance='instance', project='new-project', zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_set_machine_type_instance(self, wait_for_operation_to_complete, get_conn):
+        execute_method = get_conn.return_value.instances.return_value.setMachineType.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.set_machine_type(
+            body={},
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_set_machine_type_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        execute_method = get_conn.return_value.instances.return_value.setMachineType.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.set_machine_type(
+            project_id='new-project',
+            body={},
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE)
+        self.assertIsNone(res)
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_template(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceTemplates.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.get_instance_template(
+            resource_id=GCE_INSTANCE_TEMPLATE)
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceTemplate='instance-template', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_template_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceTemplates.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.get_instance_template(
+            project_id='new-project',
+            resource_id=GCE_INSTANCE_TEMPLATE)
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceTemplate='instance-template', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_insert_instance_template(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instanceTemplates.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.insert_instance_template(
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='example-project', requestId='request_id')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_insert_instance_template_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instanceTemplates.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.insert_instance_template(
+            project_id='new-project',
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='new-project', requestId='request_id')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_group_manager(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceGroupManagers.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.get_instance_group_manager(
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER
+        )
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceGroupManager='instance_group_manager',
+                                           project='example-project',
+                                           zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_get_instance_group_manager_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instanceGroupManagers.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.get_instance_group_manager(
+            project_id='new-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER
+        )
+        self.assertIsNotNone(res)
+        get_method.assert_called_once_with(instanceGroupManager='instance_group_manager',
+                                           project='new-project',
+                                           zone='zone')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_patch_instance_group_manager(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instanceGroupManagers.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.patch_instance_group_manager(
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER,
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(
+            body={},
+            instanceGroupManager='instance_group_manager',
+            project='example-project',
+            requestId='request_id',
+            zone='zone'
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id',
+                                                               project_id='example-project',
+                                                               zone='zone')
+
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_compute_hook.GceHook._wait_for_operation_to_complete')
+    def test_patch_instance_group_manager_overridden_project_id(self,
+                                                                wait_for_operation_to_complete,
+                                                                get_conn):
+        patch_method = get_conn.return_value.instanceGroupManagers.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gce_hook.patch_instance_group_manager(
+            project_id='new-project',
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER,
+            body={},
+            request_id=GCE_REQUEST_ID
+        )
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(
+            body={},
+            instanceGroupManager='instance_group_manager',
+            project='new-project',
+            requestId='request_id',
+            zone='zone'
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id',
+                                                               project_id='new-project',
+                                                               zone='zone')
diff --git a/tests/contrib/hooks/test_gcp_dataproc_hook.py b/tests/contrib/hooks/test_gcp_dataproc_hook.py
index acc4922f8261f..117ddca018bd3 100644
--- a/tests/contrib/hooks/test_gcp_dataproc_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataproc_hook.py
@@ -21,6 +21,7 @@
 import unittest
 from airflow.contrib.hooks.gcp_dataproc_hook import _DataProcJob
 from airflow.contrib.hooks.gcp_dataproc_hook import DataProcHook
+from tests.contrib.utils.base_gcp_mock import GCP_PROJECT_ID_HOOK_UNIT_TEST
 
 try:
     from unittest import mock
@@ -31,7 +32,6 @@
         mock = None
 
 JOB = 'test-job'
-GCP_PROJECT_ID = 'test-project-id'
 GCP_REGION = 'global'
 TASK_ID = 'test-task-id'
 
@@ -53,8 +53,8 @@ def setUp(self):
     def test_submit(self, job_mock):
         with mock.patch(DATAPROC_STRING.format('DataProcHook.get_conn',
                                                return_value=None)):
-            self.dataproc_hook.submit(GCP_PROJECT_ID, JOB)
-            job_mock.assert_called_once_with(mock.ANY, GCP_PROJECT_ID, JOB, GCP_REGION,
+            self.dataproc_hook.submit(GCP_PROJECT_ID_HOOK_UNIT_TEST, JOB)
+            job_mock.assert_called_once_with(mock.ANY, GCP_PROJECT_ID_HOOK_UNIT_TEST, JOB, GCP_REGION,
                                              job_error_states=mock.ANY)
 
 
diff --git a/tests/contrib/hooks/test_gcp_function_hook.py b/tests/contrib/hooks/test_gcp_function_hook.py
new file mode 100644
index 0000000000000..b9cd9780a127a
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_function_hook.py
@@ -0,0 +1,276 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import AirflowException
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
+    mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST, get_open_mock
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow.contrib.hooks.gcp_function_hook import GcfHook
+
+GCF_LOCATION = 'location'
+GCF_FUNCTION = 'function'
+
+
+class TestFunctionHookNoDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_no_default_project_id):
+            self.gcf_function_hook_no_project_id = GcfHook(gcp_conn_id='test', api_version='v1')
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_create_new_function_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        create_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.gcf_function_hook_no_project_id.create_new_function(
+                location=GCF_LOCATION,
+                body={}
+            )
+        create_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_create_new_function_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        create_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gcf_function_hook_no_project_id.create_new_function(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            location=GCF_LOCATION,
+            body={}
+        )
+        self.assertIsNone(res)
+        create_method.assert_called_once_with(body={},
+                                              location='projects/example-project/locations/location')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id')
+
+    @mock.patch('requests.put')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    def test_upload_function_zip_missing_project_id(self, get_conn, requests_put):
+        m = mock.mock_open()
+        with mock.patch('builtins.open', m):
+            generate_upload_url_method = get_conn.return_value.projects.return_value.locations. \
+                return_value.functions.return_value.generateUploadUrl
+            execute_method = generate_upload_url_method.return_value.execute
+            execute_method.return_value = {"uploadUrl": "http://uploadHere"}
+            requests_put.return_value = None
+            with self.assertRaises(AirflowException) as cm:
+                self.gcf_function_hook_no_project_id.upload_function_zip(
+                    location=GCF_LOCATION,
+                    zip_path="/tmp/path.zip"
+                )
+                generate_upload_url_method.assert_not_called()
+                execute_method.assert_not_called()
+                m.assert_not_called()
+                err = cm.exception
+                self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('requests.put')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    def test_upload_function_zip_overridden_project_id(self, get_conn, requests_put):
+        m, open_module = get_open_mock()
+        with mock.patch('{}.open'.format(open_module), m):
+            generate_upload_url_method = get_conn.return_value.projects.return_value.locations. \
+                return_value.functions.return_value.generateUploadUrl
+            execute_method = generate_upload_url_method.return_value.execute
+            execute_method.return_value = {"uploadUrl": "http://uploadHere"}
+            requests_put.return_value = None
+            res = self.gcf_function_hook_no_project_id.upload_function_zip(
+                project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+                location=GCF_LOCATION,
+                zip_path="/tmp/path.zip"
+            )
+            self.assertEquals("http://uploadHere", res)
+            generate_upload_url_method.assert_called_with(
+                parent='projects/example-project/locations/location')
+            execute_method.assert_called_once_with(num_retries=5)
+            requests_put.assert_called_once_with(
+                data=mock.ANY,
+                headers={'Content-type': 'application/zip',
+                         'x-goog-content-length-range': '0,104857600'},
+                url='http://uploadHere'
+            )
+
+
+class TestFunctionHookDefaultProjectId(unittest.TestCase):
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_default_project_id):
+            self.gcf_function_hook = GcfHook(gcp_conn_id='test', api_version='v1')
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_create_new_function(self, wait_for_operation_to_complete, get_conn):
+        create_method = get_conn.return_value.projects.return_value.locations.\
+            return_value.functions.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gcf_function_hook.create_new_function(
+            location=GCF_LOCATION,
+            body={}
+        )
+        self.assertIsNone(res)
+        create_method.assert_called_once_with(body={},
+                                              location='projects/example-project/locations/location')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_create_new_function_override_project_id(self, wait_for_operation_to_complete, get_conn):
+        create_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gcf_function_hook.create_new_function(
+            project_id='new-project',
+            location=GCF_LOCATION,
+            body={}
+        )
+        self.assertIsNone(res)
+        create_method.assert_called_once_with(body={},
+                                              location='projects/new-project/locations/location')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    def test_get_function(self, get_conn):
+        get_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "function"}
+        res = self.gcf_function_hook.get_function(
+            name=GCF_FUNCTION
+        )
+        self.assertIsNotNone(res)
+        self.assertEquals('function', res['name'])
+        get_method.assert_called_once_with(name='function')
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_delete_function(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.delete
+        execute_method = delete_method.return_value.execute
+        wait_for_operation_to_complete.return_value = None
+        execute_method.return_value = {"name": "operation_id"}
+        res = self.gcf_function_hook.delete_function(
+            name=GCF_FUNCTION
+        )
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(name='function')
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook._wait_for_operation_to_complete')
+    def test_update_function(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.projects.return_value.locations. \
+            return_value.functions.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.gcf_function_hook.update_function(
+            update_mask=['a', 'b', 'c'],
+            name=GCF_FUNCTION,
+            body={}
+        )
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(
+            body={},
+            name='function',
+            updateMask='a,b,c'
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(operation_name='operation_id')
+
+    @mock.patch('requests.put')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    def test_upload_function_zip(self, get_conn, requests_put):
+        m, open_module = get_open_mock()
+        with mock.patch('{}.open'.format(open_module), m):
+            generate_upload_url_method = get_conn.return_value.projects.return_value.locations. \
+                return_value.functions.return_value.generateUploadUrl
+            execute_method = generate_upload_url_method.return_value.execute
+            execute_method.return_value = {"uploadUrl": "http://uploadHere"}
+            requests_put.return_value = None
+            res = self.gcf_function_hook.upload_function_zip(
+                location=GCF_LOCATION,
+                zip_path="/tmp/path.zip"
+            )
+            self.assertEquals("http://uploadHere", res)
+            generate_upload_url_method.assert_called_with(
+                parent='projects/example-project/locations/location')
+            execute_method.assert_called_once_with(num_retries=5)
+            requests_put.assert_called_once_with(
+                data=mock.ANY,
+                headers={'Content-type': 'application/zip',
+                         'x-goog-content-length-range': '0,104857600'},
+                url='http://uploadHere'
+            )
+
+    @mock.patch('requests.put')
+    @mock.patch('airflow.contrib.hooks.gcp_function_hook.GcfHook.get_conn')
+    def test_upload_function_zip_overridden_project_id(self, get_conn, requests_put):
+        m, open_module = get_open_mock()
+        with mock.patch('{}.open'.format(open_module), m):
+            generate_upload_url_method = get_conn.return_value.projects.return_value.locations. \
+                return_value.functions.return_value.generateUploadUrl
+            execute_method = generate_upload_url_method.return_value.execute
+            execute_method.return_value = {"uploadUrl": "http://uploadHere"}
+            requests_put.return_value = None
+            res = self.gcf_function_hook.upload_function_zip(
+                project_id='new-project',
+                location=GCF_LOCATION,
+                zip_path="/tmp/path.zip"
+            )
+            self.assertEquals("http://uploadHere", res)
+            generate_upload_url_method.assert_called_with(
+                parent='projects/new-project/locations/location')
+            execute_method.assert_called_once_with(num_retries=5)
+            requests_put.assert_called_once_with(
+                data=mock.ANY,
+                headers={'Content-type': 'application/zip',
+                         'x-goog-content-length-range': '0,104857600'},
+                url='http://uploadHere'
+            )
diff --git a/tests/contrib/hooks/test_gcp_spanner_hook.py b/tests/contrib/hooks/test_gcp_spanner_hook.py
new file mode 100644
index 0000000000000..083c338d8e86c
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_spanner_hook.py
@@ -0,0 +1,730 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_spanner_hook import CloudSpannerHook
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
+    GCP_PROJECT_ID_HOOK_UNIT_TEST, mock_base_gcp_hook_default_project_id
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+SPANNER_INSTANCE = 'instance'
+SPANNER_CONFIGURATION = 'configuration'
+SPANNER_DATABASE = 'database-name'
+
+
+class TestGcpSpannerHookDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_default_project_id):
+            self.spanner_hook_default_project_id = CloudSpannerHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_existing_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.get_instance(instance_id=SPANNER_INSTANCE,
+                                                                project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_existing_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.get_instance(instance_id=SPANNER_INSTANCE,
+                                                                project_id='new-project')
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        create_method = instance_method.return_value.create
+        create_method.return_value = False
+        res = self.spanner_hook_default_project_id.create_instance(
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=1,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance',
+            configuration_name='configuration',
+            display_name='database-name',
+            node_count=1)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        create_method = instance_method.return_value.create
+        create_method.return_value = False
+        res = self.spanner_hook_default_project_id.create_instance(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=1,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance',
+            configuration_name='configuration',
+            display_name='database-name',
+            node_count=1)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        update_method = instance_method.return_value.update
+        update_method.return_value = False
+        res = self.spanner_hook_default_project_id.update_instance(
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=2,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance', configuration_name='configuration', display_name='database-name',
+            node_count=2)
+        update_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        update_method = instance_method.return_value.update
+        update_method.return_value = False
+        res = self.spanner_hook_default_project_id.update_instance(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=2,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance', configuration_name='configuration', display_name='database-name',
+            node_count=2)
+        update_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        delete_method.return_value = False
+        res = self.spanner_hook_default_project_id.delete_instance(
+            instance_id=SPANNER_INSTANCE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            'instance')
+        delete_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        delete_method.return_value = False
+        res = self.spanner_hook_default_project_id.delete_instance(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(
+            'instance')
+        delete_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_database(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_exists_method = instance_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.get_database(
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_exists_method = instance_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.get_database(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_database(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_create_method = database_method.return_value.create
+        res = self.spanner_hook_default_project_id.create_database(
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name', ddl_statements=[])
+        database_create_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_create_method = database_method.return_value.create
+        res = self.spanner_hook_default_project_id.create_database(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name', ddl_statements=[])
+        database_create_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_database(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_update_ddl_method = database_method.return_value.update_ddl
+        res = self.spanner_hook_default_project_id.update_database(
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_update_ddl_method.assert_called_with(ddl_statements=[], operation_id=None)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_update_ddl_method = database_method.return_value.update_ddl
+        res = self.spanner_hook_default_project_id.update_database(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_update_ddl_method.assert_called_with(ddl_statements=[], operation_id=None)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_database(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_drop_method = database_method.return_value.drop
+        database_exists_method = database_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.delete_database(
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        database_drop_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_drop_method = database_method.return_value.drop
+        database_exists_method = database_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_default_project_id.delete_database(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        database_drop_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_execute_dml(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        run_in_transaction_method = database_method.return_value.run_in_transaction
+        res = self.spanner_hook_default_project_id.execute_dml(
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            queries='')
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        run_in_transaction_method.assert_called_with(mock.ANY)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_execute_dml_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        run_in_transaction_method = database_method.return_value.run_in_transaction
+        res = self.spanner_hook_default_project_id.execute_dml(
+            project_id='new-project',
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            queries='')
+        get_client.assert_called_once_with(project_id='new-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        run_in_transaction_method.assert_called_with(mock.ANY)
+        self.assertIsNone(res)
+
+
+class TestGcpSpannerHookNoDefaultProjectID(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_no_default_project_id):
+            self.spanner_hook_no_default_project_id = CloudSpannerHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_existing_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.get_instance(instance_id=SPANNER_INSTANCE)
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        instance_exists_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_existing_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        res = self.spanner_hook_no_default_project_id.get_instance(instance_id=SPANNER_INSTANCE,
+                                                                   project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_non_existing_instance(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = False
+        res = self.spanner_hook_no_default_project_id.get_instance(instance_id=SPANNER_INSTANCE,
+                                                                   project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        create_method = instance_method.return_value.create
+        create_method.return_value = False
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.create_instance(
+                instance_id=SPANNER_INSTANCE,
+                configuration_name=SPANNER_CONFIGURATION,
+                node_count=1,
+                display_name=SPANNER_DATABASE)
+            get_client.assert_called_once_with(project_id='example-project')
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        create_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        create_method = instance_method.return_value.create
+        create_method.return_value = False
+        res = self.spanner_hook_no_default_project_id.create_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=1,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance',
+            configuration_name='configuration',
+            display_name='database-name',
+            node_count=1)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        update_method = instance_method.return_value.update
+        update_method.return_value = False
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.update_instance(
+                instance_id=SPANNER_INSTANCE,
+                configuration_name=SPANNER_CONFIGURATION,
+                node_count=2,
+                display_name=SPANNER_DATABASE)
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        update_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        update_method = instance_method.return_value.update
+        update_method.return_value = False
+        res = self.spanner_hook_no_default_project_id.update_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            configuration_name=SPANNER_CONFIGURATION,
+            node_count=2,
+            display_name=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            instance_id='instance', configuration_name='configuration', display_name='database-name',
+            node_count=2)
+        update_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_instance_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        delete_method.return_value = False
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.delete_instance(
+                instance_id=SPANNER_INSTANCE)
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        delete_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_instance_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        delete_method = instance_method.return_value.delete
+        delete_method.return_value = False
+        res = self.spanner_hook_no_default_project_id.delete_instance(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(
+            'instance')
+        delete_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_database_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_exists_method = instance_method.return_value.exists
+        database_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.get_database(
+                instance_id=SPANNER_INSTANCE,
+                database_id=SPANNER_DATABASE)
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        database_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_get_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_exists_method = instance_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_no_default_project_id.get_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        self.assertIsNotNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_database_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_create_method = database_method.return_value.create
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.create_database(
+                instance_id=SPANNER_INSTANCE,
+                database_id=SPANNER_DATABASE,
+                ddl_statements=[])
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        database_method.assert_not_called()
+        database_create_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_create_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_create_method = database_method.return_value.create
+        res = self.spanner_hook_no_default_project_id.create_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name', ddl_statements=[])
+        database_create_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_database_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_update_method = database_method.return_value.update
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.update_database(
+                instance_id=SPANNER_INSTANCE,
+                database_id=SPANNER_DATABASE,
+                ddl_statements=[])
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        database_method.assert_not_called()
+        database_update_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_update_ddl_method = database_method.return_value.update_ddl
+        res = self.spanner_hook_no_default_project_id.update_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_update_ddl_method.assert_called_with(ddl_statements=[], operation_id=None)
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_update_database_overridden_project_id_and_operation(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_update_ddl_method = database_method.return_value.update_ddl
+        res = self.spanner_hook_no_default_project_id.update_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            operation_id="operation",
+            ddl_statements=[])
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_update_ddl_method.assert_called_with(ddl_statements=[], operation_id="operation")
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_database_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_drop_method = database_method.return_value.drop
+        database_exists_method = database_method.return_value.exists
+        database_exists_method.return_value = True
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.delete_database(
+                instance_id=SPANNER_INSTANCE,
+                database_id=SPANNER_DATABASE)
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        database_method.assert_not_called()
+        database_exists_method.assert_not_called()
+        database_drop_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_database_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_drop_method = database_method.return_value.drop
+        database_exists_method = database_method.return_value.exists
+        database_exists_method.return_value = True
+        res = self.spanner_hook_no_default_project_id.delete_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        database_drop_method.assert_called_with()
+        self.assertIsNone(res)
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_delete_database_missing_database(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        database_drop_method = database_method.return_value.drop
+        database_exists_method = database_method.return_value.exists
+        database_exists_method.return_value = False
+        self.spanner_hook_no_default_project_id.delete_database(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE)
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        database_exists_method.assert_called_with()
+        database_drop_method.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_execute_dml_missing_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        run_in_transaction_method = database_method.return_value.run_in_transaction
+        with self.assertRaises(AirflowException) as cm:
+            self.spanner_hook_no_default_project_id.execute_dml(
+                instance_id=SPANNER_INSTANCE,
+                database_id=SPANNER_DATABASE,
+                queries='')
+        get_client.assert_not_called()
+        instance_method.assert_not_called()
+        database_method.assert_not_called()
+        run_in_transaction_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook._get_client')
+    def test_execute_dml_overridden_project_id(self, get_client):
+        instance_method = get_client.return_value.instance
+        instance_exists_method = instance_method.return_value.exists
+        instance_exists_method.return_value = True
+        database_method = instance_method.return_value.database
+        run_in_transaction_method = database_method.return_value.run_in_transaction
+        res = self.spanner_hook_no_default_project_id.execute_dml(
+            project_id=GCP_PROJECT_ID_HOOK_UNIT_TEST,
+            instance_id=SPANNER_INSTANCE,
+            database_id=SPANNER_DATABASE,
+            queries='')
+        get_client.assert_called_once_with(project_id='example-project')
+        instance_method.assert_called_once_with(instance_id='instance')
+        database_method.assert_called_with(database_id='database-name')
+        run_in_transaction_method.assert_called_with(mock.ANY)
+        self.assertIsNone(res)
diff --git a/tests/contrib/hooks/test_gcp_sql_hook.py b/tests/contrib/hooks/test_gcp_sql_hook.py
index cb56237736c4b..51b84104ef60b 100644
--- a/tests/contrib/hooks/test_gcp_sql_hook.py
+++ b/tests/contrib/hooks/test_gcp_sql_hook.py
@@ -16,13 +16,18 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
+import json
 import unittest
 
 from googleapiclient.errors import HttpError
 
-from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook
+from airflow.contrib.hooks.gcp_sql_hook import CloudSqlHook, CloudSqlDatabaseHook
 from airflow.exceptions import AirflowException
+from airflow.models import Connection
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id, \
+    mock_base_gcp_hook_no_default_project_id
+
+from parameterized import parameterized
 
 try:
     from unittest import mock
@@ -33,31 +38,971 @@
         mock = None
 
 
-class TestGcpSqlHook(unittest.TestCase):
-    def test_instance_import_ex(self):
-        # Mocking __init__ with an empty anonymous function
-        with mock.patch.object(CloudSqlHook, "__init__", lambda x, y, z: None):
-            hook = CloudSqlHook(None, None)
-            # Simulating HttpError inside import_instance
-            hook.get_conn = mock.Mock(
-                side_effect=HttpError(resp={'status': '400'},
-                                      content='Error content'.encode('utf-8'))
-            )
-            with self.assertRaises(AirflowException) as cm:
-                hook.import_instance(None, None, None)
-            err = cm.exception
-            self.assertIn("Importing instance ", str(err))
-
-    def test_instance_export_ex(self):
-        # Mocking __init__ with an empty anonymous function
-        with mock.patch.object(CloudSqlHook, "__init__", lambda x, y, z: None):
-            hook = CloudSqlHook(None, None)
-            # Simulating HttpError inside export_instance
-            hook.get_conn = mock.Mock(
-                side_effect=HttpError(resp={'status': '400'},
-                                      content='Error content'.encode('utf-8'))
-            )
+class TestGcpSqlHookDefaultProjectId(unittest.TestCase):
+
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_default_project_id):
+            self.cloudsql_hook = CloudSqlHook(api_version='v1', gcp_conn_id='test')
+
+    def test_instance_import_exception(self):
+        self.cloudsql_hook.get_conn = mock.Mock(
+            side_effect=HttpError(resp={'status': '400'},
+                                  content='Error content'.encode('utf-8'))
+        )
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook.import_instance(
+                instance='instance',
+                body={})
+        err = cm.exception
+        self.assertIn("Importing instance ", str(err))
+
+    def test_instance_export_exception(self):
+        self.cloudsql_hook.get_conn = mock.Mock(
+            side_effect=HttpError(resp={'status': '400'},
+                                  content='Error content'.encode('utf-8'))
+        )
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook.export_instance(
+                instance='instance',
+                body={})
+        err = cm.exception
+        self.assertIn("Exporting instance ", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_import(self, wait_for_operation_to_complete, get_conn):
+        import_method = get_conn.return_value.instances.return_value.import_
+        execute_method = import_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.import_instance(
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        import_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_import_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        import_method = get_conn.return_value.instances.return_value.import_
+        execute_method = import_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.import_instance(
+            project_id='new-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        import_method.assert_called_once_with(body={}, instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_export(self, wait_for_operation_to_complete, get_conn):
+        export_method = get_conn.return_value.instances.return_value.export
+        execute_method = export_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.export_instance(
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        export_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_export_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        export_method = get_conn.return_value.instances.return_value.export
+        execute_method = export_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.export_instance(
+            project_id='new-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        export_method.assert_called_once_with(body={}, instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='new-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_instance(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instances.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "instance"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.get_instance(
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('instance', res['name'])
+        get_method.assert_called_once_with(instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instances.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "instance"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.get_instance(
+            project_id='new-project',
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('instance', res['name'])
+        get_method.assert_called_once_with(instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_instance(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instances.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.create_instance(
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instances.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.create_instance(
+            project_id='new-project',
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_instance(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instances.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.patch_instance(
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instances.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.patch_instance(
+            project_id='new-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={}, instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_instance(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.instances.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.delete_instance(
+            instance='instance')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.instances.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.delete_instance(
+            project_id='new-project',
+            instance='instance')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_database(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.databases.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "database"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.get_database(
+            database='database',
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('database', res['name'])
+        get_method.assert_called_once_with(instance='instance',
+                                           database='database',
+                                           project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.databases.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "database"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.get_database(
+            project_id='new-project',
+            database='database',
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('database', res['name'])
+        get_method.assert_called_once_with(instance='instance',
+                                           database='database',
+                                           project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_database(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.databases.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.create_database(
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.databases.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.create_database(
+            project_id='new-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, instance='instance', project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_database(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.databases.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.patch_database(
+            instance='instance',
+            database='database',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={},
+                                             database='database',
+                                             instance='instance',
+                                             project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.databases.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.patch_database(
+            project_id='new-project',
+            instance='instance',
+            database='database',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={},
+                                             database='database',
+                                             instance='instance',
+                                             project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_database(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.databases.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.delete_database(
+            instance='instance',
+            database='database')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(database='database',
+                                              instance='instance',
+                                              project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.databases.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook.delete_database(
+            project_id='new-project',
+            instance='instance',
+            database='database')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(database='database',
+                                              instance='instance',
+                                              project='new-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='new-project'
+        )
+
+
+class TestGcpSqlHookNoDefaultProjectID(unittest.TestCase):
+    def setUp(self):
+        with mock.patch('airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+                        new=mock_base_gcp_hook_no_default_project_id):
+            self.cloudsql_hook_no_default_project_id = CloudSqlHook(api_version='v1', gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_import_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        import_method = get_conn.return_value.instances.return_value.import_
+        execute_method = import_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.import_instance(
+            project_id='example-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        import_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_import_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        import_method = get_conn.return_value.instances.return_value.import_
+        execute_method = import_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.import_instance(
+                instance='instance',
+                body={})
+        import_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_export_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        export_method = get_conn.return_value.instances.return_value.export
+        execute_method = export_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.export_instance(
+            project_id='example-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        export_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(project_id='example-project',
+                                                               operation_name='operation_id')
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_instance_export_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        export_method = get_conn.return_value.instances.return_value.export
+        execute_method = export_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.export_instance(
+                instance='instance',
+                body={})
+        export_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instances.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "instance"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.get_instance(
+            project_id='example-project',
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('instance', res['name'])
+        get_method.assert_called_once_with(instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_instance_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.instances.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "instance"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.get_instance(
+                instance='instance')
+        get_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instances.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.create_instance(
+            project_id='example-project',
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_instance_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.instances.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.create_instance(
+                body={})
+        insert_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instances.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.patch_instance(
+            project_id='example-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_instance_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.instances.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.patch_instance(
+                instance='instance',
+                body={})
+        patch_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_instance_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.instances.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.delete_instance(
+            project_id='example-project',
+            instance='instance')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_instance_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.instances.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.delete_instance(
+                instance='instance')
+        delete_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.databases.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "database"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.get_database(
+            project_id='example-project',
+            database='database',
+            instance='instance')
+        self.assertIsNotNone(res)
+        self.assertEquals('database', res['name'])
+        get_method.assert_called_once_with(instance='instance',
+                                           database='database',
+                                           project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_get_database_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        get_method = get_conn.return_value.databases.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = {"name": "database"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.get_database(
+                database='database',
+                instance='instance')
+        get_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.databases.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.create_database(
+            project_id='example-project',
+            instance='instance',
+            body={})
+        self.assertIsNone(res)
+        insert_method.assert_called_once_with(body={}, instance='instance', project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_create_database_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        insert_method = get_conn.return_value.databases.return_value.insert
+        execute_method = insert_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.create_database(
+                instance='instance',
+                body={})
+        insert_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.databases.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.patch_database(
+            project_id='example-project',
+            instance='instance',
+            database='database',
+            body={})
+        self.assertIsNone(res)
+        patch_method.assert_called_once_with(body={},
+                                             database='database',
+                                             instance='instance',
+                                             project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_patch_database_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        patch_method = get_conn.return_value.databases.return_value.patch
+        execute_method = patch_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.patch_database(
+                instance='instance',
+                database='database',
+                body={})
+        patch_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_database_overridden_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.databases.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        res = self.cloudsql_hook_no_default_project_id.delete_database(
+            project_id='example-project',
+            instance='instance',
+            database='database')
+        self.assertIsNone(res)
+        delete_method.assert_called_once_with(database='database',
+                                              instance='instance',
+                                              project='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+        wait_for_operation_to_complete.assert_called_once_with(
+            operation_name='operation_id', project_id='example-project'
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook.get_conn')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook._wait_for_operation_to_complete')
+    def test_delete_database_missing_project_id(self, wait_for_operation_to_complete, get_conn):
+        delete_method = get_conn.return_value.databases.return_value.delete
+        execute_method = delete_method.return_value.execute
+        execute_method.return_value = {"name": "operation_id"}
+        wait_for_operation_to_complete.return_value = None
+        with self.assertRaises(AirflowException) as cm:
+            self.cloudsql_hook_no_default_project_id.delete_database(
+                instance='instance',
+                database='database')
+        delete_method.assert_not_called()
+        execute_method.assert_not_called()
+        err = cm.exception
+        self.assertIn("The project id must be passed", str(err))
+        wait_for_operation_to_complete.assert_not_called()
+
+
+class TestCloudsqlDatabaseHook(unittest.TestCase):
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_ssl_certs_no_ssl(self, get_connection):
+        connection = Connection()
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres"
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.validate_ssl_certs()
+
+    @parameterized.expand([
+        [{}],
+        [{"sslcert": "cert_file.pem"}],
+        [{"sslkey": "cert_key.pem"}],
+        [{"sslrootcert": "root_cert_file.pem"}],
+        [{"sslcert": "cert_file.pem", "sslkey": "cert_key.pem"}],
+        [{"sslrootcert": "root_cert_file.pem", "sslkey": "cert_key.pem"}],
+        [{"sslrootcert": "root_cert_file.pem", "sslcert": "cert_file.pem"}],
+    ])
+    @mock.patch('os.path.isfile')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_ssl_certs_missing_cert_params(
+            self, cert_dict, get_connection, mock_is_file):
+        mock_is_file.side_effects = True
+        connection = Connection()
+        extras = {
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+            "use_ssl": "True"
+        }
+        extras.update(cert_dict)
+        connection.set_extra(json.dumps(extras))
+
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        with self.assertRaises(AirflowException) as cm:
+            hook.validate_ssl_certs()
+        err = cm.exception
+        self.assertIn("SSL connections requires", str(err))
+
+    @mock.patch('os.path.isfile')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_ssl_certs_with_ssl(self, get_connection, mock_is_file):
+        connection = Connection()
+        mock_is_file.return_value = True
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+            "use_ssl": "True",
+            "sslcert": "cert_file.pem",
+            "sslrootcert": "rootcert_file.pem",
+            "sslkey": "key_file.pem",
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.validate_ssl_certs()
+
+    @mock.patch('os.path.isfile')
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_ssl_certs_with_ssl_files_not_readable(
+            self, get_connection, mock_is_file):
+        connection = Connection()
+        mock_is_file.return_value = False
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+            "use_ssl": "True",
+            "sslcert": "cert_file.pem",
+            "sslrootcert": "rootcert_file.pem",
+            "sslkey": "key_file.pem",
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        with self.assertRaises(AirflowException) as cm:
+            hook.validate_ssl_certs()
+        err = cm.exception
+        self.assertIn("must be a readable file", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_socket_path_length_too_long(self, get_connection):
+        connection = Connection()
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "very_long_instance_name_that_will_be_too_long_to_build_socket_length",
+            "database_type": "postgres",
+            "use_proxy": "True",
+            "use_tcp": "False"
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        with self.assertRaises(AirflowException) as cm:
+            hook.validate_socket_path_length()
+        err = cm.exception
+        self.assertIn("The UNIX socket path length cannot exceed", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_validate_socket_path_length_not_too_long(self, get_connection):
+        connection = Connection()
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "short_instance_name",
+            "database_type": "postgres",
+            "use_proxy": "True",
+            "use_tcp": "False"
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.validate_socket_path_length()
+
+    @parameterized.expand([
+        ["http://:password@host:80/database"],
+        ["http://user:@host:80/database"],
+        ["http://user:password@/database"],
+        ["http://user:password@host:80/"],
+        ["http://user:password@/"],
+        ["http://host:80/database"],
+        ["http://host:80/"],
+    ])
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_create_connection_missing_fields(self, uri, get_connection):
+        connection = Connection()
+        connection.parse_from_uri(uri)
+        params = {
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+            'use_proxy': "True",
+            'use_tcp': "False"
+        }
+        connection.set_extra(json.dumps(params))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        with self.assertRaises(AirflowException) as cm:
+            hook.create_connection()
+        err = cm.exception
+        self.assertIn("needs to be set in connection", str(err))
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_create_delete_connection(self, get_connection):
+        connection = Connection()
+        connection.parse_from_uri("http://user:password@host:80/database")
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres"
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.create_connection()
+        self.assertIsNotNone(hook.retrieve_connection())
+        hook.delete_connection()
+        self.assertIsNone(hook.retrieve_connection())
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_get_sqlproxy_runner_no_proxy(self, get_connection):
+        connection = Connection()
+        connection.parse_from_uri("http://user:password@host:80/database")
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.create_connection()
+        try:
             with self.assertRaises(AirflowException) as cm:
-                hook.export_instance(None, None, None)
+                hook.get_sqlproxy_runner()
             err = cm.exception
-            self.assertIn("Exporting instance ", str(err))
+            self.assertIn('Proxy runner can only be retrieved in case of use_proxy = True', str(err))
+        finally:
+            hook.delete_connection()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_get_sqlproxy_runner(self, get_connection):
+        connection = Connection()
+        connection.parse_from_uri("http://user:password@host:80/database")
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+            'use_proxy': "True",
+            'use_tcp': "False"
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.create_connection()
+        try:
+            proxy_runner = hook.get_sqlproxy_runner()
+            self.assertIsNotNone(proxy_runner)
+        finally:
+            hook.delete_connection()
+
+    @mock.patch('airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook.get_connection')
+    def test_cloudsql_database_hook_get_database_hook(self, get_connection):
+        connection = Connection()
+        connection.parse_from_uri("http://user:password@host:80/database")
+        connection.set_extra(json.dumps({
+            "location": "test",
+            "instance": "instance",
+            "database_type": "postgres",
+        }))
+        get_connection.return_value = connection
+        hook = CloudSqlDatabaseHook(gcp_cloudsql_conn_id='cloudsql_connection',
+                                    default_gcp_project_id='google_connection')
+        hook.create_connection()
+        try:
+            db_hook = hook.get_database_hook()
+            self.assertIsNotNone(db_hook)
+        finally:
+            hook.delete_connection()
diff --git a/tests/contrib/operators/test_gcp_bigtable_operator.py b/tests/contrib/operators/test_gcp_bigtable_operator.py
index 8417efc9977dc..1633acb9d94f4 100644
--- a/tests/contrib/operators/test_gcp_bigtable_operator.py
+++ b/tests/contrib/operators/test_gcp_bigtable_operator.py
@@ -25,9 +25,13 @@
 from parameterized import parameterized
 
 from airflow import AirflowException
-from airflow.contrib.operators.gcp_bigtable_operator import BigtableInstanceDeleteOperator, \
-    BigtableTableDeleteOperator, BigtableTableCreateOperator, BigtableTableWaitForReplicationSensor, \
-    BigtableClusterUpdateOperator, BigtableInstanceCreateOperator
+from airflow.contrib.operators.gcp_bigtable_operator import \
+    BigtableInstanceDeleteOperator, \
+    BigtableTableDeleteOperator, \
+    BigtableTableCreateOperator, \
+    BigtableTableWaitForReplicationSensor, \
+    BigtableClusterUpdateOperator, \
+    BigtableInstanceCreateOperator
 
 try:
     # noinspection PyProtectedMember
@@ -50,13 +54,13 @@
 
 class BigtableInstanceCreateTest(unittest.TestCase):
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID, CLUSTER_ID, CLUSTER_ZONE),
         ('instance_id', PROJECT_ID, '', CLUSTER_ID, CLUSTER_ZONE),
         ('main_cluster_id', PROJECT_ID, INSTANCE_ID, '', CLUSTER_ZONE),
         ('main_cluster_zone', PROJECT_ID, INSTANCE_ID, CLUSTER_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_empty_attribute(self, missing_attribute, project_id, instance_id, main_cluster_id,
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id,
+                             main_cluster_id,
                              main_cluster_zone, mock_hook):
         with self.assertRaises(AirflowException) as e:
             BigtableInstanceCreateOperator(
@@ -86,6 +90,21 @@ def test_create_instance_that_exists(self, mock_hook):
         mock_hook.assert_called_once_with()
         mock_hook.return_value.create_instance.assert_not_called()
 
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_create_instance_that_exists_empty_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+
+        op = BigtableInstanceCreateOperator(
+            instance_id=INSTANCE_ID,
+            main_cluster_id=CLUSTER_ID,
+            main_cluster_zone=CLUSTER_ZONE,
+            task_id="id"
+        )
+        op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_instance.assert_not_called()
+
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
     def test_different_error_reraised(self, mock_hook):
         mock_hook.return_value.get_instance.return_value = None
@@ -105,19 +124,30 @@ def test_different_error_reraised(self, mock_hook):
 
         mock_hook.assert_called_once_with()
         mock_hook.return_value.create_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, CLUSTER_ID, CLUSTER_ZONE, None, None, None, None, None, None, None, None
+            cluster_nodes=None,
+            cluster_storage_type=None,
+            instance_display_name=None,
+            instance_id=INSTANCE_ID,
+            instance_labels=None,
+            instance_type=None,
+            main_cluster_id=CLUSTER_ID,
+            main_cluster_zone=CLUSTER_ZONE,
+            project_id=PROJECT_ID,
+            replica_cluster_id=None,
+            replica_cluster_zone=None,
+            timeout=None
         )
 
 
 class BigtableClusterUpdateTest(unittest.TestCase):
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID, CLUSTER_ID, NODES),
         ('instance_id', PROJECT_ID, '', CLUSTER_ID, NODES),
         ('cluster_id', PROJECT_ID, INSTANCE_ID, '', NODES),
         ('nodes', PROJECT_ID, INSTANCE_ID, CLUSTER_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_empty_attribute(self, missing_attribute, project_id, instance_id, cluster_id, nodes, mock_hook):
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id,
+                             cluster_id, nodes, mock_hook):
         with self.assertRaises(AirflowException) as e:
             BigtableClusterUpdateOperator(
                 project_id=project_id,
@@ -145,7 +175,28 @@ def test_updating_cluster_but_instance_does_not_exists(self, mock_hook):
             op.execute(None)
 
         err = e.exception
-        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(INSTANCE_ID))
+        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(
+            INSTANCE_ID))
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.update_cluster.assert_not_called()
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_updating_cluster_but_instance_does_not_exists_empty_project_id(self,
+                                                                            mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+
+        with self.assertRaises(AirflowException) as e:
+            op = BigtableClusterUpdateOperator(
+                instance_id=INSTANCE_ID,
+                cluster_id=CLUSTER_ID,
+                nodes=NODES,
+                task_id="id"
+            )
+            op.execute(None)
+
+        err = e.exception
+        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(
+            INSTANCE_ID))
         mock_hook.assert_called_once_with()
         mock_hook.return_value.update_cluster.assert_not_called()
 
@@ -168,10 +219,37 @@ def test_updating_cluster_that_does_not_exists(self, mock_hook):
         err = e.exception
         self.assertEqual(
             str(err),
-            "Dependency: cluster '{}' does not exist for instance '{}'.".format(CLUSTER_ID, INSTANCE_ID)
+            "Dependency: cluster '{}' does not exist for instance '{}'.".format(
+                CLUSTER_ID, INSTANCE_ID)
         )
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.update_cluster.assert_called_once_with(instance, CLUSTER_ID, NODES)
+        mock_hook.return_value.update_cluster.assert_called_once_with(
+            instance=instance, cluster_id=CLUSTER_ID, nodes=NODES)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_updating_cluster_that_does_not_exists_empty_project_id(self, mock_hook):
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.update_cluster.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Cluster not found."))
+
+        with self.assertRaises(AirflowException) as e:
+            op = BigtableClusterUpdateOperator(
+                instance_id=INSTANCE_ID,
+                cluster_id=CLUSTER_ID,
+                nodes=NODES,
+                task_id="id"
+            )
+            op.execute(None)
+
+        err = e.exception
+        self.assertEqual(
+            str(err),
+            "Dependency: cluster '{}' does not exist for instance '{}'.".format(
+                CLUSTER_ID, INSTANCE_ID)
+        )
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.update_cluster.assert_called_once_with(
+            instance=instance, cluster_id=CLUSTER_ID, nodes=NODES)
 
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
     def test_different_error_reraised(self, mock_hook):
@@ -190,7 +268,8 @@ def test_different_error_reraised(self, mock_hook):
             op.execute(None)
 
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.update_cluster.assert_called_once_with(instance, CLUSTER_ID, NODES)
+        mock_hook.return_value.update_cluster.assert_called_once_with(
+            instance=instance, cluster_id=CLUSTER_ID, nodes=NODES)
 
 
 class BigtableInstanceDeleteTest(unittest.TestCase):
@@ -203,10 +282,23 @@ def test_delete_execute(self, mock_hook):
         )
         op.execute(None)
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_delete_execute_empty_project_id(self, mock_hook):
+        op = BigtableInstanceDeleteOperator(
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID)
 
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID),
         ('instance_id', PROJECT_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
@@ -232,7 +324,23 @@ def test_deleting_instance_that_doesnt_exists(self, mock_hook):
             side_effect=google.api_core.exceptions.NotFound("Instance not found."))
         op.execute(None)
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_deleting_instance_that_doesnt_exists_empty_project_id(self, mock_hook):
+        op = BigtableInstanceDeleteOperator(
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        mock_hook.return_value.delete_instance.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Instance not found."))
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID)
 
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
     def test_different_error_reraised(self, mock_hook):
@@ -248,7 +356,9 @@ def test_different_error_reraised(self, mock_hook):
             op.execute(None)
 
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_instance.assert_called_once_with(PROJECT_ID, INSTANCE_ID)
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID)
 
 
 class BigtableTableDeleteTest(unittest.TestCase):
@@ -262,15 +372,18 @@ def test_delete_execute(self, mock_hook):
         )
         op.execute(None)
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+        mock_hook.return_value.delete_table.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID)
 
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID, TABLE_ID),
         ('instance_id', PROJECT_ID, '', TABLE_ID),
         ('table_id', PROJECT_ID, INSTANCE_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id,
+                             mock_hook):
         with self.assertRaises(AirflowException) as e:
             BigtableTableDeleteOperator(
                 project_id=project_id,
@@ -295,7 +408,27 @@ def test_deleting_table_that_doesnt_exists(self, mock_hook):
             side_effect=google.api_core.exceptions.NotFound("Table not found."))
         op.execute(None)
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+        mock_hook.return_value.delete_table.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_deleting_table_that_doesnt_exists_empty_project_id(self, mock_hook):
+        op = BigtableTableDeleteOperator(
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            task_id="id"
+        )
+
+        mock_hook.return_value.delete_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.NotFound("Table not found."))
+        op.execute(None)
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.delete_table.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID)
 
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
     def test_deleting_table_when_instance_doesnt_exists(self, mock_hook):
@@ -310,7 +443,8 @@ def test_deleting_table_when_instance_doesnt_exists(self, mock_hook):
         with self.assertRaises(AirflowException) as e:
             op.execute(None)
         err = e.exception
-        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(INSTANCE_ID))
+        self.assertEqual(str(err), "Dependency: instance '{}' does not exist.".format(
+            INSTANCE_ID))
         mock_hook.assert_called_once_with()
         mock_hook.return_value.delete_table.assert_not_called()
 
@@ -329,7 +463,10 @@ def test_different_error_reraised(self, mock_hook):
             op.execute(None)
 
         mock_hook.assert_called_once_with()
-        mock_hook.return_value.delete_table.assert_called_once_with(PROJECT_ID, INSTANCE_ID, TABLE_ID)
+        mock_hook.return_value.delete_table.assert_called_once_with(
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID)
 
 
 class BigtableTableCreateTest(unittest.TestCase):
@@ -347,15 +484,18 @@ def test_create_execute(self, mock_hook):
         op.execute(None)
         mock_hook.assert_called_once_with()
         mock_hook.return_value.create_table.assert_called_once_with(
-            instance, TABLE_ID, INITIAL_SPLIT_KEYS, EMPTY_COLUMN_FAMILIES)
+            instance=instance,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES)
 
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID, TABLE_ID),
         ('instance_id', PROJECT_ID, '', TABLE_ID),
         ('table_id', PROJECT_ID, INSTANCE_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id,
+                             mock_hook):
         with self.assertRaises(AirflowException) as e:
             BigtableTableCreateOperator(
                 project_id=project_id,
@@ -383,7 +523,8 @@ def test_instance_not_exists(self, mock_hook):
         err = e.exception
         self.assertEqual(
             str(err),
-            "Dependency: instance '{}' does not exist in project '{}'.".format(INSTANCE_ID, PROJECT_ID)
+            "Dependency: instance '{}' does not exist in project '{}'.".format(
+                INSTANCE_ID, PROJECT_ID)
         )
         mock_hook.assert_called_once_with()
 
@@ -398,7 +539,8 @@ def test_creating_table_that_exists(self, mock_hook):
             task_id="id"
         )
 
-        mock_hook.return_value.get_column_families_for_table.return_value = EMPTY_COLUMN_FAMILIES
+        mock_hook.return_value.get_column_families_for_table.return_value = \
+            EMPTY_COLUMN_FAMILIES
         instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
         mock_hook.return_value.create_table.side_effect = mock.Mock(
             side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
@@ -406,10 +548,38 @@ def test_creating_table_that_exists(self, mock_hook):
 
         mock_hook.assert_called_once_with()
         mock_hook.return_value.create_table.assert_called_once_with(
-            instance, TABLE_ID, INITIAL_SPLIT_KEYS, EMPTY_COLUMN_FAMILIES)
+            instance=instance,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES)
 
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_creating_table_that_exists_with_different_column_families_ids_in_the_table(self, mock_hook):
+    def test_creating_table_that_exists_empty_project_id(self, mock_hook):
+        op = BigtableTableCreateOperator(
+            instance_id=INSTANCE_ID,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES,
+            task_id="id"
+        )
+
+        mock_hook.return_value.get_column_families_for_table.return_value = \
+            EMPTY_COLUMN_FAMILIES
+        instance = mock_hook.return_value.get_instance.return_value = mock.Mock(Instance)
+        mock_hook.return_value.create_table.side_effect = mock.Mock(
+            side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
+        op.execute(None)
+
+        mock_hook.assert_called_once_with()
+        mock_hook.return_value.create_table.assert_called_once_with(
+            instance=instance,
+            table_id=TABLE_ID,
+            initial_split_keys=INITIAL_SPLIT_KEYS,
+            column_families=EMPTY_COLUMN_FAMILIES)
+
+    @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
+    def test_creating_table_that_exists_with_different_column_families_ids_in_the_table(
+            self, mock_hook):
         op = BigtableTableCreateOperator(
             project_id=PROJECT_ID,
             instance_id=INSTANCE_ID,
@@ -419,7 +589,8 @@ def test_creating_table_that_exists_with_different_column_families_ids_in_the_ta
             task_id="id"
         )
 
-        mock_hook.return_value.get_column_families_for_table.return_value = {"existing_family": None}
+        mock_hook.return_value.get_column_families_for_table.return_value = {
+            "existing_family": None}
         mock_hook.return_value.create_table.side_effect = mock.Mock(
             side_effect=google.api_core.exceptions.AlreadyExists("Table already exists."))
 
@@ -433,7 +604,8 @@ def test_creating_table_that_exists_with_different_column_families_ids_in_the_ta
         mock_hook.assert_called_once_with()
 
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_creating_table_that_exists_with_different_column_families_gc_rule_in_the_table(self, mock_hook):
+    def test_creating_table_that_exists_with_different_column_families_gc_rule_in__table(
+            self, mock_hook):
         op = BigtableTableCreateOperator(
             project_id=PROJECT_ID,
             instance_id=INSTANCE_ID,
@@ -464,12 +636,12 @@ def test_creating_table_that_exists_with_different_column_families_gc_rule_in_th
 
 class BigtableWaitForTableReplicationTest(unittest.TestCase):
     @parameterized.expand([
-        ('project_id', '', INSTANCE_ID, TABLE_ID),
         ('instance_id', PROJECT_ID, '', TABLE_ID),
         ('table_id', PROJECT_ID, INSTANCE_ID, ''),
     ], testcase_func_name=lambda f, n, p: 'test_empty_attribute.empty_' + p.args[0])
     @mock.patch('airflow.contrib.operators.gcp_bigtable_operator.BigtableHook')
-    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id, mock_hook):
+    def test_empty_attribute(self, missing_attribute, project_id, instance_id, table_id,
+                             mock_hook):
         with self.assertRaises(AirflowException) as e:
             BigtableTableWaitForReplicationSensor(
                 project_id=project_id,
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
index a0907b4a57def..8ff30dd320945 100644
--- a/tests/contrib/operators/test_gcp_compute_operator.py
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -66,7 +66,7 @@ def test_instance_start(self, mock_hook):
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.start_instance.assert_called_once_with(
-            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID
+            zone=GCE_ZONE, resource_id=RESOURCE_ID, project_id=GCP_PROJECT_ID
         )
         self.assertTrue(result)
 
@@ -111,6 +111,15 @@ def test_start_should_throw_ex_when_missing_project_id(self, mock_hook):
         self.assertIn("The required parameter 'project_id' is missing", str(err))
         mock_hook.assert_not_called()
 
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_start_should_not_throw_ex_when_project_id_None(self, _):
+        op = GceInstanceStartOperator(
+            zone=GCE_ZONE,
+            resource_id=RESOURCE_ID,
+            task_id='id'
+        )
+        op.execute(None)
+
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_start_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
@@ -143,20 +152,18 @@ def test_start_should_throw_ex_when_missing_resource_id(self, mock_hook):
 class GceInstanceStopTest(unittest.TestCase):
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_instance_stop(self, mock_hook):
-        mock_hook.return_value.stop_instance.return_value = True
         op = GceInstanceStopOperator(
             project_id=GCP_PROJECT_ID,
             zone=GCE_ZONE,
             resource_id=RESOURCE_ID,
             task_id='id'
         )
-        result = op.execute(None)
+        op.execute(None)
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.stop_instance.assert_called_once_with(
-            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID
+            zone=GCE_ZONE, resource_id=RESOURCE_ID, project_id=GCP_PROJECT_ID
         )
-        self.assertTrue(result)
 
     # Setting all of the operator's input parameters as templated dag_ids
     # (could be anything else) just to test if the templating works for all fields
@@ -199,6 +206,20 @@ def test_stop_should_throw_ex_when_missing_project_id(self, mock_hook):
         self.assertIn("The required parameter 'project_id' is missing", str(err))
         mock_hook.assert_not_called()
 
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_stop_should_not_throw_ex_when_project_id_none(self, mock_hook):
+        op = GceInstanceStopOperator(
+            zone=GCE_ZONE,
+            resource_id=RESOURCE_ID,
+            task_id='id'
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.stop_instance.assert_called_once_with(
+            zone=GCE_ZONE, resource_id=RESOURCE_ID, project_id=None
+        )
+
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_stop_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
@@ -239,13 +260,15 @@ def test_set_machine_type(self, mock_hook):
             body=SET_MACHINE_TYPE_BODY,
             task_id='id'
         )
-        result = op.execute(None)
+        op.execute(None)
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         mock_hook.return_value.set_machine_type.assert_called_once_with(
-            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY
+            zone=GCE_ZONE,
+            resource_id=RESOURCE_ID,
+            body=SET_MACHINE_TYPE_BODY,
+            project_id=GCP_PROJECT_ID
         )
-        self.assertTrue(result)
 
     # Setting all of the operator's input parameters as templated dag_ids
     # (could be anything else) just to test if the templating works for all fields
@@ -290,6 +313,24 @@ def test_set_machine_type_should_throw_ex_when_missing_project_id(self, mock_hoo
         self.assertIn("The required parameter 'project_id' is missing", str(err))
         mock_hook.assert_not_called()
 
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_set_machine_type_should_not_throw_ex_when_project_id_none(self, mock_hook):
+        op = GceSetMachineTypeOperator(
+            zone=GCE_ZONE,
+            resource_id=RESOURCE_ID,
+            body=SET_MACHINE_TYPE_BODY,
+            task_id='id'
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.set_machine_type.assert_called_once_with(
+            zone=GCE_ZONE,
+            resource_id=RESOURCE_ID,
+            body=SET_MACHINE_TYPE_BODY,
+            project_id=None
+        )
+
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_set_machine_type_should_throw_ex_when_missing_zone(self, mock_hook):
         with self.assertRaises(AirflowException) as cm:
@@ -382,7 +423,7 @@ def test_set_machine_type_should_handle_and_trim_gce_error(
         _check_zone_operation_status.assert_called_once_with(
             {}, "test-operation", GCP_PROJECT_ID, GCE_ZONE)
         _execute_set_machine_type.assert_called_once_with(
-            GCP_PROJECT_ID, GCE_ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY)
+            GCE_ZONE, RESOURCE_ID, SET_MACHINE_TYPE_BODY, GCP_PROJECT_ID)
         # Checking the full message was sometimes failing due to different order
         # of keys in the serialized JSON
         self.assertIn("400 BAD REQUEST: {", str(err))  # checking the square bracket trim
@@ -506,6 +547,28 @@ def test_successful_copy_template(self, mock_hook):
         )
         self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
 
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_copy_template_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance_template.side_effect = [
+            HttpError(resp=httplib2.Response({'status': 404}), content=EMPTY_CONTENT),
+            GCE_INSTANCE_TEMPLATE_BODY_GET,
+            GCE_INSTANCE_TEMPLATE_BODY_GET_NEW
+        ]
+        op = GceInstanceTemplateCopyOperator(
+            resource_id=GCE_INSTANCE_TEMPLATE_NAME,
+            task_id='id',
+            body_patch={"name": GCE_INSTANCE_TEMPLATE_NEW_NAME}
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.insert_instance_template.assert_called_once_with(
+            project_id=None,
+            body=GCE_INSTANCE_TEMPLATE_BODY_INSERT,
+            request_id=None
+        )
+        self.assertEqual(GCE_INSTANCE_TEMPLATE_BODY_GET_NEW, result)
+
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_idempotent_copy_template_when_already_copied(self, mock_hook):
         mock_hook.return_value.get_instance_template.side_effect = [
@@ -896,6 +959,29 @@ def test_successful_instance_group_update(self, mock_hook):
         )
         self.assertTrue(result)
 
+    @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
+    def test_successful_instance_group_update_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance_group_manager.return_value = \
+            deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
+        op = GceInstanceGroupManagerUpdateTemplateOperator(
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            task_id='id',
+            source_template=GCE_INSTANCE_TEMPLATE_SOURCE_URL,
+            destination_template=GCE_INSTANCE_TEMPLATE_DESTINATION_URL
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='beta',
+                                          gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
+            project_id=None,
+            zone=GCE_ZONE,
+            resource_id=GCE_INSTANCE_GROUP_MANAGER_NAME,
+            body=GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH,
+            request_id=None
+        )
+        self.assertTrue(result)
+
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
     def test_successful_instance_group_update_no_instance_template_field(self, mock_hook):
         instance_group_manager_no_template = deepcopy(GCE_INSTANCE_GROUP_MANAGER_GET)
@@ -972,8 +1058,7 @@ def test_successful_instance_group_update_with_update_policy(self, mock_hook):
                                           gcp_conn_id='google_cloud_default')
         expected_patch_with_update_policy = \
             deepcopy(GCE_INSTANCE_GROUP_MANAGER_EXPECTED_PATCH)
-        expected_patch_with_update_policy['updatePolicy'] = \
-            GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY
+        expected_patch_with_update_policy['updatePolicy'] = GCE_INSTANCE_GROUP_MANAGER_UPDATE_POLICY
         mock_hook.return_value.patch_instance_group_manager.assert_called_once_with(
             project_id=GCP_PROJECT_ID,
             zone=GCE_ZONE,
@@ -1009,7 +1094,7 @@ def test_successful_instance_group_update_with_request_id(self, mock_hook):
         self.assertTrue(result)
 
     @mock.patch('airflow.contrib.operators.gcp_compute_operator.GceHook')
-    def test_try_to_use_api_v1(self, mock_hook):
+    def test_try_to_use_api_v1(self, _):
         with self.assertRaises(AirflowException) as cm:
             GceInstanceGroupManagerUpdateTemplateOperator(
                 project_id=GCP_PROJECT_ID,
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
index 3c568fce0c959..394c24b86a232 100644
--- a/tests/contrib/operators/test_gcp_function_operator.py
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -117,8 +117,9 @@ def test_deploy_execute(self, mock_hook):
             'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')
         }
         mock_hook.return_value.create_new_function.assert_called_once_with(
-            'projects/test_project_id/locations/test_region',
-            expected_body
+            project_id='test_project_id',
+            location='test_region',
+            body=expected_body
         )
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
@@ -147,18 +148,24 @@ def test_update_function_if_exists(self, mock_hook):
         mock_hook.return_value.create_new_function.assert_not_called()
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
-    def test_empty_project_id(self, mock_hook):
-        with self.assertRaises(AirflowException) as cm:
-            GcfFunctionDeployOperator(
-                project_id="",
-                location="test_region",
-                body=None,
-                task_id="id"
-            )
-        err = cm.exception
-        self.assertIn("The required parameter 'project_id' is missing", str(err))
+    def test_empty_project_id_is_ok(self, mock_hook):
+        operator = GcfFunctionDeployOperator(
+            location="test_region",
+            body=deepcopy(VALID_BODY),
+            task_id="id"
+        )
+        operator._hook.get_function.side_effect = \
+            HttpError(resp=MOCK_RESP_404, content=b'not found')
+        operator.execute(None)
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
+        new_body = deepcopy(VALID_BODY)
+        new_body['labels'] = {
+            'airflow-version': 'v' + version.replace('.', '-').replace('+', '-')}
+        mock_hook.return_value.create_new_function.assert_called_once_with(
+            project_id=None,
+            location="test_region",
+            body=new_body)
 
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
     def test_empty_location(self, mock_hook):
@@ -386,16 +393,19 @@ def test_invalid_source_code_union_field(self, source_code, message, mock_hook):
         mock_hook.reset_mock()
 
     @parameterized.expand([
-        ({'sourceArchiveUrl': 'gs://url'},),
-        ({'zip_path': '/path/to/file', 'sourceUploadUrl': None},),
+        ({'sourceArchiveUrl': 'gs://url'}, 'test_project_id'),
+        ({'zip_path': '/path/to/file', 'sourceUploadUrl': None}, 'test_project_id'),
+        ({'zip_path': '/path/to/file', 'sourceUploadUrl': None}, None),
         ({'sourceUploadUrl':
-         'https://source.developers.google.com/projects/a/repos/b/revisions/c/paths/d'},),
+         'https://source.developers.google.com/projects/a/repos/b/revisions/c/paths/d'},
+         'test_project_id'),
         ({'sourceRepository':
          {'url': 'https://source.developers.google.com/projects/a/'
-          'repos/b/revisions/c/paths/d'}},),
+          'repos/b/revisions/c/paths/d'}},
+         'test_project_id'),
     ])
     @mock.patch('airflow.contrib.operators.gcp_function_operator.GcfHook')
-    def test_valid_source_code_union_field(self, source_code, mock_hook):
+    def test_valid_source_code_union_field(self, source_code, project_id, mock_hook):
         mock_hook.return_value.upload_function_zip.return_value = 'https://uploadUrl'
         mock_hook.return_value.get_function.side_effect = mock.Mock(
             side_effect=HttpError(resp=MOCK_RESP_404, content=b'not found'))
@@ -407,27 +417,37 @@ def test_valid_source_code_union_field(self, source_code, mock_hook):
         body.pop('sourceRepositoryUrl', None)
         zip_path = source_code.pop('zip_path', None)
         body.update(source_code)
-        op = GcfFunctionDeployOperator(
-            project_id="test_project_id",
-            location="test_region",
-            body=body,
-            task_id="id",
-            zip_path=zip_path
-        )
+        if project_id:
+            op = GcfFunctionDeployOperator(
+                project_id="test_project_id",
+                location="test_region",
+                body=body,
+                task_id="id",
+                zip_path=zip_path
+            )
+        else:
+            op = GcfFunctionDeployOperator(
+                location="test_region",
+                body=body,
+                task_id="id",
+                zip_path=zip_path
+            )
         op.execute(None)
         mock_hook.assert_called_once_with(api_version='v1',
                                           gcp_conn_id='google_cloud_default')
         if zip_path:
             mock_hook.return_value.upload_function_zip.assert_called_once_with(
-                parent='projects/test_project_id/locations/test_region',
+                project_id=project_id,
+                location='test_region',
                 zip_path='/path/to/file'
             )
         mock_hook.return_value.get_function.assert_called_once_with(
             'projects/test_project_id/locations/test_region/functions/helloWorld'
         )
         mock_hook.return_value.create_new_function.assert_called_once_with(
-            'projects/test_project_id/locations/test_region',
-            body
+            project_id=project_id,
+            location='test_region',
+            body=body
         )
         mock_hook.reset_mock()
 
@@ -509,8 +529,9 @@ def test_valid_trigger_union_field(self, trigger, mock_hook):
             'projects/test_project_id/locations/test_region/functions/helloWorld'
         )
         mock_hook.return_value.create_new_function.assert_called_once_with(
-            'projects/test_project_id/locations/test_region',
-            body
+            project_id='test_project_id',
+            location='test_region',
+            body=body
         )
         mock_hook.reset_mock()
 
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
index 455a6543c8b0d..eea242bbc1437 100644
--- a/tests/contrib/operators/test_gcp_spanner_operator.py
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -46,8 +46,8 @@
 DISPLAY_NAME = 'Test Instance'
 INSERT_QUERY = "INSERT my_table1 (id, name) VALUES (1, 'One')"
 INSERT_QUERY_2 = "INSERT my_table2 (id, name) VALUES (1, 'One')"
-CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(100)) PRIMARY KEY (id)"
-CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(100)) PRIMARY KEY (id)"
+CREATE_QUERY = "CREATE TABLE my_table1 (id INT64, name STRING(100))"
+CREATE_QUERY_2 = "CREATE TABLE my_table2 (id INT64, name STRING(100))"
 DDL_STATEMENTS = [CREATE_QUERY, CREATE_QUERY_2]
 
 
@@ -66,10 +66,36 @@ def test_instance_create(self, mock_hook):
         result = op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, CONFIG_NAME, int(NODE_COUNT), DISPLAY_NAME
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME
         )
         mock_hook.return_value.update_instance.assert_not_called()
-        self.assertTrue(result)
+        self.assertIsNone(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_create_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = None
+        op = CloudSpannerInstanceDeployOperator(
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME
+        )
+        mock_hook.return_value.update_instance.assert_not_called()
+        self.assertIsNone(result)
 
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
     def test_instance_update(self, mock_hook):
@@ -85,10 +111,36 @@ def test_instance_update(self, mock_hook):
         result = op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.update_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, CONFIG_NAME, int(NODE_COUNT), DISPLAY_NAME
+            project_id=PROJECT_ID,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME
         )
         mock_hook.return_value.create_instance.assert_not_called()
-        self.assertTrue(result)
+        self.assertIsNone(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_update_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = {"name": INSTANCE_ID}
+        op = CloudSpannerInstanceDeployOperator(
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.update_instance.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID,
+            configuration_name=CONFIG_NAME,
+            node_count=int(NODE_COUNT),
+            display_name=DISPLAY_NAME
+        )
+        mock_hook.return_value.create_instance.assert_not_called()
+        self.assertIsNone(result)
 
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
     def test_instance_create_aborts_and_succeeds_if_instance_exists(self, mock_hook):
@@ -104,7 +156,7 @@ def test_instance_create_aborts_and_succeeds_if_instance_exists(self, mock_hook)
         result = op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_instance.assert_not_called()
-        self.assertTrue(result)
+        self.assertIsNone(result)
 
     @parameterized.expand([
         ("", INSTANCE_ID, "project_id"),
@@ -137,7 +189,22 @@ def test_instance_delete(self, mock_hook):
         result = op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_delete_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_instance.return_value = {"name": INSTANCE_ID}
+        op = CloudSpannerInstanceDeleteOperator(
+            instance_id=INSTANCE_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=None,
+            instance_id=INSTANCE_ID
         )
         self.assertTrue(result)
 
@@ -185,7 +252,26 @@ def test_instance_query(self, mock_hook):
         result = op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.execute_dml.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY]
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            queries=[INSERT_QUERY]
+        )
+        self.assertIsNone(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_instance_query_missing_project_id(self, mock_hook):
+        mock_hook.return_value.execute_sql.return_value = None
+        op = CloudSpannerInstanceDatabaseQueryOperator(
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            query=INSERT_QUERY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.execute_dml.assert_called_once_with(
+            project_id=None, instance_id=INSTANCE_ID,
+            database_id=DB_ID, queries=[INSERT_QUERY]
         )
         self.assertIsNone(result)
 
@@ -223,7 +309,7 @@ def test_instance_query_dml(self, mock_hook):
         op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.execute_dml.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY]
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID, database_id=DB_ID, queries=[INSERT_QUERY]
         )
 
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
@@ -239,7 +325,8 @@ def test_instance_query_dml_list(self, mock_hook):
         op.execute(None)
         mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
         mock_hook.return_value.execute_dml.assert_called_once_with(
-            PROJECT_ID, INSTANCE_ID, DB_ID, [INSERT_QUERY, INSERT_QUERY_2]
+            project_id=PROJECT_ID, instance_id=INSTANCE_ID,
+            database_id=DB_ID, queries=[INSERT_QUERY, INSERT_QUERY_2]
         )
 
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
@@ -261,6 +348,24 @@ def test_database_create(self, mock_hook):
         mock_hook.return_value.update_database.assert_not_called()
         self.assertTrue(result)
 
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_create_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = None
+        op = CloudSpannerInstanceDatabaseDeployOperator(
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_called_once_with(
+            project_id=None, instance_id=INSTANCE_ID, database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS
+        )
+        mock_hook.return_value.update_database.assert_not_called()
+        self.assertTrue(result)
+
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
     def test_database_create_with_pre_existing_db(self, mock_hook):
         mock_hook.return_value.get_database.return_value = {"name": DB_ID}
@@ -317,6 +422,23 @@ def test_database_update(self, mock_hook):
         )
         self.assertTrue(result)
 
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_update_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = {"name": DB_ID}
+        op = CloudSpannerInstanceDatabaseUpdateOperator(
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.update_database.assert_called_once_with(
+            project_id=None, instance_id=INSTANCE_ID, database_id=DB_ID,
+            ddl_statements=DDL_STATEMENTS, operation_id=None
+        )
+        self.assertTrue(result)
+
     @parameterized.expand([
         ("", INSTANCE_ID, DB_ID, DDL_STATEMENTS, 'project_id'),
         (PROJECT_ID, "", DB_ID, DDL_STATEMENTS, 'instance_id'),
@@ -371,6 +493,21 @@ def test_database_delete(self, mock_hook):
         )
         self.assertTrue(result)
 
+    @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
+    def test_database_delete_missing_project_id(self, mock_hook):
+        mock_hook.return_value.get_database.return_value = {"name": DB_ID}
+        op = CloudSpannerInstanceDatabaseDeleteOperator(
+            instance_id=INSTANCE_ID,
+            database_id=DB_ID,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_called_once_with(
+            project_id=None, instance_id=INSTANCE_ID, database_id=DB_ID
+        )
+        self.assertTrue(result)
+
     @mock.patch("airflow.contrib.operators.gcp_spanner_operator.CloudSpannerHook")
     def test_database_delete_exits_and_succeeds_if_database_does_not_exist(self,
                                                                            mock_hook):
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index d4870e4812867..447b2348eff92 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -184,7 +184,30 @@ def test_instance_create(self, mock_hook, _check_if_instance_exists):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_instance.assert_called_once_with(
-            PROJECT_ID, CREATE_BODY
+            project_id=PROJECT_ID,
+            body=CREATE_BODY
+        )
+        self.assertIsNone(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceCreateOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_create_missing_project_id(self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = False
+        mock_hook.return_value.create_instance.return_value = True
+        op = CloudSqlInstanceCreateOperator(
+            instance=INSTANCE_NAME,
+            body=CREATE_BODY,
+            task_id="id"
+        )
+        result = op.execute(context={
+            'task_instance': mock.Mock()
+        })
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_instance.assert_called_once_with(
+            project_id=None,
+            body=CREATE_BODY
         )
         self.assertIsNone(result)
 
@@ -312,7 +335,27 @@ def test_instance_patch(self, mock_hook):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.patch_instance.assert_called_once_with(
-            PROJECT_ID, PATCH_BODY, INSTANCE_NAME
+            project_id=PROJECT_ID,
+            body=PATCH_BODY,
+            instance=INSTANCE_NAME
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_patch_missing_project_id(self, mock_hook):
+        mock_hook.return_value.patch_instance.return_value = True
+        op = CloudSqlInstancePatchOperator(
+            body=PATCH_BODY,
+            instance=INSTANCE_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_instance.assert_called_once_with(
+            project_id=None,
+            body=PATCH_BODY,
+            instance=INSTANCE_NAME
         )
         self.assertTrue(result)
 
@@ -351,7 +394,26 @@ def test_instance_delete(self, mock_hook, _check_if_instance_exists):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME
+        )
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDeleteOperator._check_if_instance_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_delete_missing_project_id(self, mock_hook, _check_if_instance_exists):
+        _check_if_instance_exists.return_value = True
+        op = CloudSqlInstanceDeleteOperator(
+            instance=INSTANCE_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_instance.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME
         )
 
     @mock.patch("airflow.contrib.operators.gcp_sql_operator"
@@ -388,7 +450,29 @@ def test_instance_db_create(self, mock_hook, _check_if_db_exists):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.create_database.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME, DATABASE_INSERT_BODY
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=DATABASE_INSERT_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseCreateOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_create_missing_project_id(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = False
+        op = CloudSqlInstanceDatabaseCreateOperator(
+            instance=INSTANCE_NAME,
+            body=DATABASE_INSERT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.create_database.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME,
+            body=DATABASE_INSERT_BODY
         )
         self.assertTrue(result)
 
@@ -426,7 +510,32 @@ def test_instance_db_patch(self, mock_hook, _check_if_db_exists):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.patch_database.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME, DB_NAME, DATABASE_PATCH_BODY
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            body=DATABASE_PATCH_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabasePatchOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_patch_missing_project_id(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = True
+        op = CloudSqlInstanceDatabasePatchOperator(
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            body=DATABASE_PATCH_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.patch_database.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            body=DATABASE_PATCH_BODY
         )
         self.assertTrue(result)
 
@@ -484,7 +593,29 @@ def test_instance_db_delete(self, mock_hook, _check_if_db_exists):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.delete_database.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME, DB_NAME
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            database=DB_NAME
+        )
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator"
+                ".CloudSqlInstanceDatabaseDeleteOperator._check_if_db_exists")
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_db_delete_missing_project_id(self, mock_hook, _check_if_db_exists):
+        _check_if_db_exists.return_value = True
+        op = CloudSqlInstanceDatabaseDeleteOperator(
+            instance=INSTANCE_NAME,
+            database=DB_NAME,
+            task_id="id"
+        )
+        result = op.execute(None)
+        self.assertTrue(result)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.delete_database.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME,
+            database=DB_NAME
         )
 
     @mock.patch("airflow.contrib.operators.gcp_sql_operator"
@@ -518,7 +649,27 @@ def test_instance_export(self, mock_hook):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.export_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME, EXPORT_BODY
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=EXPORT_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_export_missing_project_id(self, mock_hook):
+        mock_hook.return_value.export_instance.return_value = True
+        op = CloudSqlInstanceExportOperator(
+            instance=INSTANCE_NAME,
+            body=EXPORT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.export_instance.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME,
+            body=EXPORT_BODY
         )
         self.assertTrue(result)
 
@@ -535,7 +686,27 @@ def test_instance_import(self, mock_hook):
         mock_hook.assert_called_once_with(api_version="v1beta4",
                                           gcp_conn_id="google_cloud_default")
         mock_hook.return_value.import_instance.assert_called_once_with(
-            PROJECT_ID, INSTANCE_NAME, IMPORT_BODY
+            project_id=PROJECT_ID,
+            instance=INSTANCE_NAME,
+            body=IMPORT_BODY
+        )
+        self.assertTrue(result)
+
+    @mock.patch("airflow.contrib.operators.gcp_sql_operator.CloudSqlHook")
+    def test_instance_import_missing_project_id(self, mock_hook):
+        mock_hook.return_value.export_instance.return_value = True
+        op = CloudSqlInstanceImportOperator(
+            instance=INSTANCE_NAME,
+            body=IMPORT_BODY,
+            task_id="id"
+        )
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version="v1beta4",
+                                          gcp_conn_id="google_cloud_default")
+        mock_hook.return_value.import_instance.assert_called_once_with(
+            project_id=None,
+            instance=INSTANCE_NAME,
+            body=IMPORT_BODY
         )
         self.assertTrue(result)
 
@@ -544,14 +715,17 @@ class CloudSqlQueryValidationTest(unittest.TestCase):
 
     @staticmethod
     def _setup_connections(get_connections, uri):
+        gcp_connection = mock.MagicMock()
+        gcp_connection.extra_dejson = mock.MagicMock()
+        gcp_connection.extra_dejson.get.return_value = 'empty_project'
         cloudsql_connection = Connection()
         cloudsql_connection.parse_from_uri(uri)
-        get_connections.side_effect = [[cloudsql_connection]]
+        cloudsql_connection2 = Connection()
+        cloudsql_connection2.parse_from_uri(uri)
+        get_connections.side_effect = [[gcp_connection], [cloudsql_connection],
+                                       [cloudsql_connection2]]
 
     @parameterized.expand([
-        ('', 'location', 'instance_name', 'postgres', False, False,
-         'SELECT * FROM TEST',
-         "The required extra 'project_id' is empty"),
         ('project_id', '', 'instance_name', 'mysql', False, False,
          'SELECT * FROM TEST',
          "The required extra 'location' is empty"),
@@ -581,7 +755,7 @@ def test_create_operator_with_wrong_parameters(self,
                                                    message,
                                                    get_connections):
         uri = \
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?" \
+            "gcpcloudsql://user:password@127.0.0.1:3200/testdb?" \
             "database_type={database_type}&" \
             "project_id={project_id}&location={location}&instance={instance_name}&" \
             "use_proxy={use_proxy}&use_ssl={use_ssl}".format(
@@ -603,7 +777,7 @@ def test_create_operator_with_wrong_parameters(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=False&use_ssl=False"
         self._setup_connections(get_connections, uri)
@@ -618,13 +792,13 @@ def test_create_operator_with_correct_parameters_postgres(self, get_connections)
         finally:
             operator.cloudsql_db_hook.delete_connection()
         self.assertEqual('postgres', conn.conn_type)
-        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual('127.0.0.1', conn.host)
         self.assertEqual(3200, conn.port)
         self.assertEqual('testdb', conn.schema)
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=False&use_ssl=True&sslcert=/bin/bash&" \
               "sslkey=/bin/bash&sslrootcert=/bin/bash"
@@ -640,7 +814,7 @@ def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connecti
         finally:
             operator.cloudsql_db_hook.delete_connection()
         self.assertEqual('postgres', conn.conn_type)
-        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual('127.0.0.1', conn.host)
         self.assertEqual(3200, conn.port)
         self.assertEqual('testdb', conn.schema)
         self.assertEqual('/bin/bash', conn.extra_dejson['sslkey'])
@@ -650,7 +824,7 @@ def test_create_operator_with_correct_parameters_postgres_ssl(self, get_connecti
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_proxy_socket(
             self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=True&sql_proxy_use_tcp=False"
         self._setup_connections(get_connections, uri)
@@ -670,10 +844,32 @@ def test_create_operator_with_correct_parameters_postgres_proxy_socket(
         self.assertIsNone(conn.port)
         self.assertEqual('testdb', conn.schema)
 
+    @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
+    def test_create_operator_with_correct_parameters_project_id_missing(self,
+                                                                        get_connections):
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&" \
+              "location=europe-west1&instance=testdb&" \
+              "use_proxy=False&use_ssl=False"
+        self._setup_connections(get_connections, uri)
+        operator = CloudSqlQueryOperator(
+            sql=['SELECT * FROM TABLE'],
+            task_id='task_id'
+        )
+        operator.cloudsql_db_hook.create_connection()
+        try:
+            db_hook = operator.cloudsql_db_hook.get_database_hook()
+            conn = db_hook._get_connections_from_db(db_hook.mysql_conn_id)[0]
+        finally:
+            operator.cloudsql_db_hook.delete_connection()
+        self.assertEqual('mysql', conn.conn_type)
+        self.assertEqual('127.0.0.1', conn.host)
+        self.assertEqual(3200, conn.port)
+        self.assertEqual('testdb', conn.schema)
+
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_postgres_proxy_tcp(self,
                                                                         get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=True&sql_proxy_use_tcp=True"
         self._setup_connections(get_connections, uri)
@@ -694,7 +890,7 @@ def test_create_operator_with_correct_parameters_postgres_proxy_tcp(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&" \
             "project_id=example-project&location=europe-west1&instance=testdb&" \
             "use_proxy=False&use_ssl=False"
         self._setup_connections(get_connections, uri)
@@ -709,13 +905,13 @@ def test_create_operator_with_correct_parameters_mysql(self, get_connections):
         finally:
             operator.cloudsql_db_hook.delete_connection()
         self.assertEqual('mysql', conn.conn_type)
-        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual('127.0.0.1', conn.host)
         self.assertEqual(3200, conn.port)
         self.assertEqual('testdb', conn.schema)
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=False&use_ssl=True&sslcert=/bin/bash&" \
               "sslkey=/bin/bash&sslrootcert=/bin/bash"
@@ -731,7 +927,7 @@ def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections
         finally:
             operator.cloudsql_db_hook.delete_connection()
         self.assertEqual('mysql', conn.conn_type)
-        self.assertEqual('8.8.8.8', conn.host)
+        self.assertEqual('127.0.0.1', conn.host)
         self.assertEqual(3200, conn.port)
         self.assertEqual('testdb', conn.schema)
         self.assertEqual('/bin/bash', json.loads(conn.extra_dejson['ssl'])['cert'])
@@ -741,7 +937,7 @@ def test_create_operator_with_correct_parameters_mysql_ssl(self, get_connections
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_proxy_socket(self,
                                                                         get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=True&sql_proxy_use_tcp=False"
         self._setup_connections(get_connections, uri)
@@ -765,7 +961,7 @@ def test_create_operator_with_correct_parameters_mysql_proxy_socket(self,
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&" \
               "project_id=example-project&location=europe-west1&instance=testdb&" \
               "use_proxy=True&sql_proxy_use_tcp=True"
         self._setup_connections(get_connections, uri)
@@ -786,7 +982,7 @@ def test_create_operator_with_correct_parameters_mysql_tcp(self, get_connections
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_too_long_unix_socket_path(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&" \
               "instance=" \
               "test_db_with_long_name_a_bit_above" \
@@ -804,7 +1000,7 @@ def test_create_operator_with_too_long_unix_socket_path(self, get_connections):
 
     @mock.patch("airflow.hooks.base_hook.BaseHook.get_connections")
     def test_create_operator_with_not_too_long_unix_socket_path(self, get_connections):
-        uri = "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=postgres&" \
+        uri = "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=postgres&" \
               "project_id=example-project&location=europe-west1&" \
               "instance=" \
               "test_db_with_longname_but_with_limit_of_UNIX_socket&" \
@@ -833,13 +1029,13 @@ def test_cloudsql_hook_delete_connection_on_exception(
             self, get_connections, run, get_connection, delete_connection):
         connection = Connection()
         connection.parse_from_uri(
-            "gcpcloudsql://user:password@8.8.8.8:3200/testdb?database_type=mysql&"
+            "gcpcloudsql://user:password@127.0.0.1:3200/testdb?database_type=mysql&"
             "project_id=example-project&location=europe-west1&instance=testdb&"
             "use_proxy=False")
         get_connection.return_value = connection
 
         db_connection = Connection()
-        db_connection.host = "8.8.8.8"
+        db_connection.host = "127.0.0.1"
         db_connection.set_extra(json.dumps({"project_id": "example-project",
                                             "location": "europe-west1",
                                             "instance": "testdb",
diff --git a/tests/contrib/utils/base_gcp_mock.py b/tests/contrib/utils/base_gcp_mock.py
new file mode 100644
index 0000000000000..444a3245cad71
--- /dev/null
+++ b/tests/contrib/utils/base_gcp_mock.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import sys
+
+import mock
+
+GCP_PROJECT_ID_HOOK_UNIT_TEST = 'example-project'
+
+
+def mock_base_gcp_hook_default_project_id(self, gcp_conn_id, delegate_to=None):
+    self.extras = {
+        'extra__google_cloud_platform__project': GCP_PROJECT_ID_HOOK_UNIT_TEST
+    }
+    self._conn = gcp_conn_id
+    self.delegate_to = delegate_to
+
+
+def mock_base_gcp_hook_no_default_project_id(self, gcp_conn_id, delegate_to=None):
+    self.extras = {
+    }
+    self._conn = gcp_conn_id
+    self.delegate_to = delegate_to
+
+
+def get_open_mock():
+    m = mock.mock_open()
+    if sys.version_info[0] == 2:
+        open_module = '__builtin__'
+    else:
+        open_module = 'builtins'
+    return m, open_module
diff --git a/tests/contrib/utils/base_gcp_system_test_case.py b/tests/contrib/utils/base_gcp_system_test_case.py
index 03031a457ff62..113d3e31526db 100644
--- a/tests/contrib/utils/base_gcp_system_test_case.py
+++ b/tests/contrib/utils/base_gcp_system_test_case.py
@@ -40,7 +40,7 @@
 
 
 # Retrieve environment variables from parent directory retriever - it should be
-# in the path ${AIRFLOW_SOOURCE_DIR}/../../get_system_test_environment_variables.py
+# in the path ${AIRFLOW_SOURCE_DIR}/../../get_system_test_environment_variables.py
 # and it should print all the variables in form of key=value to the stdout
 class RetrieveVariables:
     @staticmethod
@@ -243,6 +243,7 @@ def setUp(self):
             # and move them back after reset
             self._store_dags_to_temporary_directory()
             try:
+                db_utils.upgradedb()
                 db_utils.resetdb(settings.RBAC)
             finally:
                 self._restore_dags_from_temporary_directory()

From 30873817ae016060fb7bcdbf4e8c0a3828eda376 Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Tue, 24 Jul 2018 11:22:53 +0200
Subject: [PATCH 447/808] [AIRFLOW-2782][Airflow 2782] Upgrades the Dagre D3
 version

Closes #3634 from verdan/AIRFLOW-2782-upgrade-
dagre-d3
---
 airflow/www_rbac/package-lock.json            |   49 +
 airflow/www_rbac/package.json                 |    1 +
 airflow/www_rbac/static/css/graph.css         |    7 +-
 airflow/www_rbac/static/js/dagre-d3.js        | 5007 -----------------
 airflow/www_rbac/templates/airflow/graph.html |  124 +-
 airflow/www_rbac/views.py                     |    2 +
 airflow/www_rbac/webpack.config.js            |    1 +
 7 files changed, 138 insertions(+), 5053 deletions(-)
 delete mode 100644 airflow/www_rbac/static/js/dagre-d3.js

diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index 90d94cd0054f6..a5cbf24adf803 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -1887,6 +1887,40 @@
         "d3-selection": "^1.3.0"
       }
     },
+    "dagre": {
+      "version": "0.7.4",
+      "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.7.4.tgz",
+      "integrity": "sha1-3nLw50pVDOEc5jjwoTb+1xI5gCI=",
+      "requires": {
+        "graphlib": "^1.0.5",
+        "lodash": "^3.10.0"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
+      }
+    },
+    "dagre-d3": {
+      "version": "0.4.18",
+      "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.4.18.tgz",
+      "integrity": "sha512-7tRltaOfNTIkNEZYMCL8N3Q8bCre99x/mAJL2RbuUfPu5d+4f0KOHglZm+AzOG2Z/+S2HBDYciE6iDcDtki6Tg==",
+      "requires": {
+        "d3": "^3.3.8",
+        "dagre": "^0.7.3",
+        "graphlib": "^1.0.5",
+        "lodash": "^3.10.0"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
+      }
+    },
     "datatables.net": {
       "version": "1.10.19",
       "resolved": "https://registry.npmjs.org/datatables.net/-/datatables.net-1.10.19.tgz",
@@ -3240,6 +3274,21 @@
       "integrity": "sha1-Dovf5NHduIVNZOBOp8AOKgJuVlg=",
       "dev": true
     },
+    "graphlib": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-1.0.7.tgz",
+      "integrity": "sha1-DKst8P/mq+BwsmJb+h7bbslnuLE=",
+      "requires": {
+        "lodash": "^3.10.0"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
+      }
+    },
     "handlebars": {
       "version": "4.0.11",
       "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.11.tgz",
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index eb1053b941953..a996498c2df5e 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -47,6 +47,7 @@
     "bootstrap-toggle": "^2.2.2",
     "d3": "^3.4.4",
     "d3-tip": "^0.9.1",
+    "dagre-d3": "^0.4.18",
     "datatables.net": "^1.10.19",
     "datatables.net-bs": "^1.10.19",
     "npm": "^6.1.0",
diff --git a/airflow/www_rbac/static/css/graph.css b/airflow/www_rbac/static/css/graph.css
index f2091ba841657..12de132d38ab6 100644
--- a/airflow/www_rbac/static/css/graph.css
+++ b/airflow/www_rbac/static/css/graph.css
@@ -34,14 +34,17 @@ svg {
 .edgePath {
     stroke: #333;
     stroke-width: 1px;
-    fill: none;
 }
 
 g.node rect {
-    stroke-width: 3;
+    stroke-width: 3px;
     stroke: white;
     cursor: pointer;
 }
+g.node .label {
+  font-size: inherit;
+  font-weight: normal;
+}
 g.node text {
     cursor: pointer;
 }
diff --git a/airflow/www_rbac/static/js/dagre-d3.js b/airflow/www_rbac/static/js/dagre-d3.js
deleted file mode 100644
index 2da7cdda08275..0000000000000
--- a/airflow/www_rbac/static/js/dagre-d3.js
+++ /dev/null
@@ -1,5007 +0,0 @@
-;(function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);throw new Error("Cannot find module '"+o+"'")}var f=n[o]={exports:{}};t[o][0].call(f.exports,function(e){var n=t[o][1][e];return s(n?n:e)},f,f.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
-var global=self;
-/**
- * @license
- * Copyright (c) 2012-2013 Chris Pettitt
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-global.dagreD3 = require('./index');
-
-},{"./index":2}],2:[function(require,module,exports){
-/**
- * @license
- * Copyright (c) 2012-2013 Chris Pettitt
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-module.exports =  {
-  Digraph: require('graphlib').Digraph,
-  Graph: require('graphlib').Graph,
-  Renderer: require('./lib/Renderer'),
-  json: require('graphlib').converter.json,
-  layout: require('dagre').layout,
-  version: require('./lib/version'),
-  debug: require('dagre').debug
-};
-
-},{"./lib/Renderer":3,"./lib/version":4,"dagre":11,"graphlib":29}],3:[function(require,module,exports){
-var layout = require('dagre').layout;
-
-var d3;
-try { d3 = require('d3'); } catch (_) { d3 = window.d3; }
-
-module.exports = Renderer;
-
-function Renderer() {
-  // Set up defaults...
-  this._layout = layout();
-
-  this.drawNodes(defaultDrawNodes);
-  this.drawEdgeLabels(defaultDrawEdgeLabels);
-  this.drawEdgePaths(defaultDrawEdgePaths);
-  this.positionNodes(defaultPositionNodes);
-  this.positionEdgeLabels(defaultPositionEdgeLabels);
-  this.positionEdgePaths(defaultPositionEdgePaths);
-  this.zoomSetup(defaultZoomSetup);
-  this.zoom(defaultZoom);
-  this.transition(defaultTransition);
-  this.postLayout(defaultPostLayout);
-  this.postRender(defaultPostRender);
-
-  this.edgeInterpolate('bundle');
-  this.edgeTension(0.95);
-  this.zoom_obj = null;
-}
-
-Renderer.prototype.layout = function(layout) {
-  if (!arguments.length) { return this._layout; }
-  this._layout = layout;
-  return this;
-};
-
-Renderer.prototype.drawNodes = function(drawNodes) {
-  if (!arguments.length) { return this._drawNodes; }
-  this._drawNodes = bind(drawNodes, this);
-  return this;
-};
-
-Renderer.prototype.drawEdgeLabels = function(drawEdgeLabels) {
-  if (!arguments.length) { return this._drawEdgeLabels; }
-  this._drawEdgeLabels = bind(drawEdgeLabels, this);
-  return this;
-};
-
-Renderer.prototype.drawEdgePaths = function(drawEdgePaths) {
-  if (!arguments.length) { return this._drawEdgePaths; }
-  this._drawEdgePaths = bind(drawEdgePaths, this);
-  return this;
-};
-
-Renderer.prototype.positionNodes = function(positionNodes) {
-  if (!arguments.length) { return this._positionNodes; }
-  this._positionNodes = bind(positionNodes, this);
-  return this;
-};
-
-Renderer.prototype.positionEdgeLabels = function(positionEdgeLabels) {
-  if (!arguments.length) { return this._positionEdgeLabels; }
-  this._positionEdgeLabels = bind(positionEdgeLabels, this);
-  return this;
-};
-
-Renderer.prototype.positionEdgePaths = function(positionEdgePaths) {
-  if (!arguments.length) { return this._positionEdgePaths; }
-  this._positionEdgePaths = bind(positionEdgePaths, this);
-  return this;
-};
-
-Renderer.prototype.transition = function(transition) {
-  if (!arguments.length) { return this._transition; }
-  this._transition = bind(transition, this);
-  return this;
-};
-
-Renderer.prototype.zoomSetup = function(zoomSetup) {
-  if (!arguments.length) { return this._zoomSetup; }
-  this._zoomSetup = bind(zoomSetup, this);
-  return this;
-};
-
-Renderer.prototype.zoom = function(zoom) {
-  if (!arguments.length) { return this._zoom; }
-  if (zoom) {
-    this._zoom = bind(zoom, this);
-  } else {
-    delete this._zoom;
-  }
-  return this;
-};
-
-Renderer.prototype.postLayout = function(postLayout) {
-  if (!arguments.length) { return this._postLayout; }
-  this._postLayout = bind(postLayout, this);
-  return this;
-};
-
-Renderer.prototype.postRender = function(postRender) {
-  if (!arguments.length) { return this._postRender; }
-  this._postRender = bind(postRender, this);
-  return this;
-};
-
-Renderer.prototype.edgeInterpolate = function(edgeInterpolate) {
-  if (!arguments.length) { return this._edgeInterpolate; }
-  this._edgeInterpolate = edgeInterpolate;
-  return this;
-};
-
-Renderer.prototype.edgeTension = function(edgeTension) {
-  if (!arguments.length) { return this._edgeTension; }
-  this._edgeTension = edgeTension;
-  return this;
-};
-
-Renderer.prototype.run = function(graph, orgSvg) {
-  // First copy the input graph so that it is not changed by the rendering
-  // process.
-  graph = copyAndInitGraph(graph);
-
-  // Create zoom elements
-  var svg = this._zoomSetup(graph, orgSvg);
-
-  // Create layers
-  svg
-    .selectAll('g.edgePaths, g.edgeLabels, g.nodes')
-    .data(['edgePaths', 'edgeLabels', 'nodes'])
-    .enter()
-      .append('g')
-      .attr('class', function(d) { return d; });
-
-  // Create node and edge roots, attach labels, and capture dimension
-  // information for use with layout.
-  var svgNodes = this._drawNodes(graph, svg.select('g.nodes'));
-  var svgEdgeLabels = this._drawEdgeLabels(graph, svg.select('g.edgeLabels'));
-
-  svgNodes.each(function(u) { calculateDimensions(this, graph.node(u)); });
-  svgEdgeLabels.each(function(e) { calculateDimensions(this, graph.edge(e)); });
-
-  // Now apply the layout function
-  var result = runLayout(graph, this._layout);
-
-  // Copy useDef attribute from input graph to output graph
-  graph.eachNode(function(u, a) {
-    if (a.useDef) {
-      result.node(u).useDef = a.useDef;
-    }
-  });
-
-  // Run any user-specified post layout processing
-  this._postLayout(result, svg);
-
-  var svgEdgePaths = this._drawEdgePaths(graph, svg.select('g.edgePaths'));
-
-  // Apply the layout information to the graph
-  this._positionNodes(result, svgNodes);
-  this._positionEdgeLabels(result, svgEdgeLabels);
-  this._positionEdgePaths(result, svgEdgePaths, orgSvg);
-
-  this._postRender(result, svg);
-
-  return result;
-};
-
-function copyAndInitGraph(graph) {
-  var copy = graph.copy();
-
-  if (copy.graph() === undefined) {
-    copy.graph({});
-  }
-
-  if (!('arrowheadFix' in copy.graph())) {
-    copy.graph().arrowheadFix = true;
-  }
-
-  // Init labels if they were not present in the source graph
-  copy.nodes().forEach(function(u) {
-    var value = copyObject(copy.node(u));
-    copy.node(u, value);
-    if (!('label' in value)) { value.label = ''; }
-  });
-
-  copy.edges().forEach(function(e) {
-    var value = copyObject(copy.edge(e));
-    copy.edge(e, value);
-    if (!('label' in value)) { value.label = ''; }
-  });
-
-  return copy;
-}
-
-function copyObject(obj) {
-  var copy = {};
-  for (var k in obj) {
-    copy[k] = obj[k];
-  }
-  return copy;
-}
-
-function calculateDimensions(group, value) {
-  var bbox = group.getBBox();
-  value.width = bbox.width;
-  value.height = bbox.height;
-}
-
-function runLayout(graph, layout) {
-  var result = layout.run(graph);
-
-  // Copy labels to the result graph
-  graph.eachNode(function(u, value) { result.node(u).label = value.label; });
-  graph.eachEdge(function(e, u, v, value) { result.edge(e).label = value.label; });
-
-  return result;
-}
-
-function defaultDrawNodes(g, root) {
-  var nodes = g.nodes().filter(function(u) { return !isComposite(g, u); });
-
-  var svgNodes = root
-    .selectAll('g.node')
-    .classed('enter', false)
-    .data(nodes, function(u) { return u; });
-
-  svgNodes.selectAll('*').remove();
-
-  svgNodes
-    .enter()
-      .append('g')
-        .style('opacity', 0)
-        .attr('class', 'node enter');
-
-  svgNodes.each(function(u) {
-    var attrs = g.node(u),
-        domNode = d3.select(this);
-    addLabel(attrs, domNode, true, 10, 10);
-  });
-
-  this._transition(svgNodes.exit())
-      .style('opacity', 0)
-      .remove();
-
-  return svgNodes;
-}
-
-function defaultDrawEdgeLabels(g, root) {
-  var svgEdgeLabels = root
-    .selectAll('g.edgeLabel')
-    .classed('enter', false)
-    .data(g.edges(), function (e) { return e; });
-
-  svgEdgeLabels.selectAll('*').remove();
-
-  svgEdgeLabels
-    .enter()
-      .append('g')
-        .style('opacity', 0)
-        .attr('class', 'edgeLabel enter');
-
-  svgEdgeLabels.each(function(e) { addLabel(g.edge(e), d3.select(this), false, 0, 0); });
-
-  this._transition(svgEdgeLabels.exit())
-      .style('opacity', 0)
-      .remove();
-
-  return svgEdgeLabels;
-}
-
-var defaultDrawEdgePaths = function(g, root) {
-  var svgEdgePaths = root
-    .selectAll('g.edgePath')
-    .classed('enter', false)
-    .data(g.edges(), function(e) { return e; });
-
-  var DEFAULT_ARROWHEAD = 'url(#arrowhead)',
-      createArrowhead = DEFAULT_ARROWHEAD;
-  if (!g.isDirected()) {
-    createArrowhead = null;
-  } else if (g.graph().arrowheadFix !== 'false' && g.graph().arrowheadFix !== false) {
-    createArrowhead = function() {
-      var strokeColor = d3.select(this).style('stroke');
-      if (strokeColor) {
-        var id = 'arrowhead-' + strokeColor.replace(/[^a-zA-Z0-9]/g, '_');
-        getOrMakeArrowhead(root, id).style('fill', strokeColor);
-        return 'url(#' + id + ')';
-      }
-      return DEFAULT_ARROWHEAD;
-    };
-  }
-
-  svgEdgePaths
-    .enter()
-      .append('g')
-        .attr('class', 'edgePath enter')
-        .append('path')
-          .style('opacity', 0);
-
-  svgEdgePaths
-    .selectAll('path')
-    .each(function(e) { applyStyle(g.edge(e).style, d3.select(this)); })
-    .attr('marker-end', createArrowhead);
-
-  this._transition(svgEdgePaths.exit())
-      .style('opacity', 0)
-      .remove();
-
-  return svgEdgePaths;
-};
-
-function defaultPositionNodes(g, svgNodes) {
-  function transform(u) {
-    var value = g.node(u);
-    return 'translate(' + value.x + ',' + value.y + ')';
-  }
-
-  // For entering nodes, position immediately without transition
-  svgNodes.filter('.enter').attr('transform', transform);
-
-  this._transition(svgNodes)
-      .style('opacity', 1)
-      .attr('transform', transform);
-}
-
-function defaultPositionEdgeLabels(g, svgEdgeLabels) {
-  function transform(e) {
-    var value = g.edge(e);
-    var point = findMidPoint(value.points);
-    return 'translate(' + point.x + ',' + point.y + ')';
-  }
-
-  // For entering edge labels, position immediately without transition
-  svgEdgeLabels.filter('.enter').attr('transform', transform);
-
-  this._transition(svgEdgeLabels)
-    .style('opacity', 1)
-    .attr('transform', transform);
-}
-
-function isEllipse(obj) {
-  return Object.prototype.toString.call(obj) === '[object SVGEllipseElement]';
-}
-
-function isCircle(obj) {
-  return Object.prototype.toString.call(obj) === '[object SVGCircleElement]';
-}
-
-function isPolygon(obj) {
-  return Object.prototype.toString.call(obj) === '[object SVGPolygonElement]';
-}
-
-function intersectNode(nd, p1, root) {
-  if (nd.useDef) {
-    var definedFig = root.select('defs #' + nd.useDef).node();
-    if (definedFig) {
-      var outerFig = definedFig.childNodes[0];
-      if (isCircle(outerFig) || isEllipse(outerFig)) {
-        return intersectEllipse(nd, outerFig, p1);
-      } else if (isPolygon(outerFig)) {
-        return intersectPolygon(nd, outerFig, p1);
-      }
-    }
-  }
-  // TODO: use bpodgursky's shortening algorithm here
-  return intersectRect(nd, p1);
-}
-
-function defaultPositionEdgePaths(g, svgEdgePaths, root) {
-  var interpolate = this._edgeInterpolate,
-      tension = this._edgeTension;
-
-  function calcPoints(e) {
-    var value = g.edge(e);
-    var source = g.node(g.incidentNodes(e)[0]);
-    var target = g.node(g.incidentNodes(e)[1]);
-    var points = value.points.slice();
-
-    var p0 = points.length === 0 ? target : points[0];
-    var p1 = points.length === 0 ? source : points[points.length - 1];
-
-    points.unshift(intersectNode(source, p0, root));
-    points.push(intersectNode(target, p1, root));
-
-    return d3.svg.line()
-      .x(function(d) { return d.x; })
-      .y(function(d) { return d.y; })
-      .interpolate(interpolate)
-      .tension(tension)
-      (points);
-  }
-
-  svgEdgePaths.filter('.enter').selectAll('path')
-      .attr('d', calcPoints);
-
-  this._transition(svgEdgePaths.selectAll('path'))
-      .attr('d', calcPoints)
-      .style('opacity', 1);
-}
-
-// By default we do not use transitions
-function defaultTransition(selection) {
-  return selection;
-}
-
-// Setup dom for zooming
-function defaultZoomSetup(graph, svg) {
-  var root = svg.property('ownerSVGElement');
-  // If the svg node is the root, we get null, so set to svg.
-  if (!root) {
-    root = svg;
-  } else {
-    root = d3.select(root);
-  }
-
-  if (root.select('rect.overlay').empty()) {
-    // Create an overlay for capturing mouse events that don't touch foreground
-    root.insert('rect', ':first-child')
-      .attr('class', 'overlay')
-      .attr('width', '100%')
-      .attr('height', '100%')
-      .style('fill', 'none')
-      .style('pointer-events', 'all');
-
-    // Capture the zoom behaviour from the svg
-    svg = svg.append('g')
-      .attr('class', 'zoom');
-
-    if (this._zoom) {
-      root.call(this._zoom(graph, svg));
-    }
-  }
-
-  return svg;
-}
-
-// By default allow pan and zoom
-function defaultZoom(graph, svg) {
-
-  this.zoom_obj = d3.behavior.zoom().on('zoom', function() {
-    svg.attr('transform', 'translate(' + d3.event.translate + ')scale(' + d3.event.scale + ')');
-  });
-  return this.zoom_obj;
-}
-
-function defaultPostLayout() {
-  // Do nothing
-}
-
-function defaultPostRender(graph, root) {
-  if (graph.isDirected()) {
-    // Fill = #333 is for backwards compatibility
-    getOrMakeArrowhead(root, 'arrowhead')
-      .attr('fill', '#333');
-  }
-}
-
-function getOrMakeArrowhead(root, id) {
-  var search = root.select('#' + id);
-  if (!search.empty()) { return search; }
-
-  var defs = root.select('defs');
-  if (defs.empty()) {
-    defs = root.append('svg:defs');
-  }
-
-  var marker =
-    defs
-      .append('svg:marker')
-        .attr('id', id)
-        .attr('viewBox', '0 0 10 10')
-        .attr('refX', 8)
-        .attr('refY', 5)
-        .attr('markerUnits', 'strokeWidth')
-        .attr('markerWidth', 8)
-        .attr('markerHeight', 5)
-        .attr('orient', 'auto');
-
-  marker
-    .append('svg:path')
-      .attr('d', 'M 0 0 L 10 5 L 0 10 z');
-
-  return marker;
-}
-
-function addLabel(node, root, addingNode, marginX, marginY) {
-  // If the node has 'useDef' meta data, we rely on that
-  if (node.useDef) {
-    root.append('use').attr('xlink:href', '#' + node.useDef);
-    return;
-  }
-  // Add the rect first so that it appears behind the label
-  var label = node.label;
-  var rect = root.append('rect');
-  if (node.width) {
-    rect.attr('width', node.width);
-  }
-  if (node.height) {
-    rect.attr('height', node.height);
-  }
-
-  var labelSvg = root.append('g'),
-      innerLabelSvg;
-
-  if (label[0] === '<') {
-    addForeignObjectLabel(label, labelSvg);
-    // No margin for HTML elements
-    marginX = marginY = 0;
-  } else {
-    innerLabelSvg = addTextLabel(label,
-                                 labelSvg,
-                                 Math.floor(node.labelCols),
-                                 node.labelCut);
-    applyStyle(node.labelStyle, innerLabelSvg);
-  }
-
-  var labelBBox = labelSvg.node().getBBox();
-  labelSvg.attr('transform',
-                'translate(' + (-labelBBox.width / 2) + ',' + (-labelBBox.height / 2) + ')');
-
-  var bbox = root.node().getBBox();
-
-  rect
-    .attr('rx', node.rx ? node.rx : 5)
-    .attr('ry', node.ry ? node.ry : 5)
-    .attr('x', -(bbox.width / 2 + marginX))
-    .attr('y', -(bbox.height / 2 + marginY))
-    .attr('width', bbox.width + 2 * marginX)
-    .attr('height', bbox.height + 2 * marginY)
-    .attr('fill', '#fff');
-
-  if (addingNode) {
-    applyStyle(node.style, rect);
-
-    if (node.fill) {
-      rect.style('fill', node.fill);
-    }
-
-    if (node.stroke) {
-      rect.style('stroke', node.stroke);
-    }
-
-    if (node['stroke-width']) {
-      rect.style('stroke-width', node['stroke-width'] + 'px');
-    }
-
-    if (node['stroke-dasharray']) {
-      rect.style('stroke-dasharray', node['stroke-dasharray']);
-    }
-
-    if (node.href) {
-      root
-        .attr('class', root.attr('class') + ' clickable')
-        .on('click', function() {
-          window.open(node.href);
-        });
-    }
-  }
-}
-
-function addForeignObjectLabel(label, root) {
-  var fo = root
-    .append('foreignObject')
-      .attr('width', '100000');
-
-  var w, h;
-  fo
-    .append('xhtml:div')
-      .style('float', 'left')
-      // TODO find a better way to get dimensions for foreignObjects...
-      .html(function() { return label; })
-      .each(function() {
-        w = this.clientWidth;
-        h = this.clientHeight;
-      });
-
-  fo
-    .attr('width', w)
-    .attr('height', h);
-}
-
-function addTextLabel(label, root, labelCols, labelCut) {
-  if (labelCut === undefined) { labelCut = 'false'; }
-  labelCut = (labelCut.toString().toLowerCase() === 'true');
-
-  var node = root
-    .append('text')
-    .attr('text-anchor', 'left');
-
-  label = label.replace(/\\n/g, '\n');
-
-  var arr = labelCols ? wordwrap(label, labelCols, labelCut) : label;
-  arr = arr.split('\n');
-  for (var i = 0; i < arr.length; i++) {
-    node
-      .append('tspan')
-        .attr('dy', '1em')
-        .attr('x', '1')
-        .text(arr[i]);
-  }
-
-  return node;
-}
-
-// Thanks to
-// http://james.padolsey.com/javascript/wordwrap-for-javascript/
-function wordwrap (str, width, cut, brk) {
-  brk = brk || '\n';
-  width = width || 75;
-  cut = cut || false;
-
-  if (!str) { return str; }
-
-  var regex = '.{1,' + width + '}(\\s|$)' + (cut ? '|.{' + width + '}|.+$' : '|\\S+?(\\s|$)');
-
-  return str.match(new RegExp(regex, 'g')).join(brk);
-}
-
-function findMidPoint(points) {
-  var midIdx = points.length / 2;
-  if (points.length % 2) {
-    return points[Math.floor(midIdx)];
-  } else {
-    var p0 = points[midIdx - 1];
-    var p1 = points[midIdx];
-    return {x: (p0.x + p1.x) / 2, y: (p0.y + p1.y) / 2};
-  }
-}
-
-function intersectRect(rect, point) {
-  var x = rect.x;
-  var y = rect.y;
-
-  // Rectangle intersection algorithm from:
-  // http://math.stackexchange.com/questions/108113/find-edge-between-two-boxes
-  var dx = point.x - x;
-  var dy = point.y - y;
-  var w = rect.width / 2;
-  var h = rect.height / 2;
-
-  var sx, sy;
-  if (Math.abs(dy) * w > Math.abs(dx) * h) {
-    // Intersection is top or bottom of rect.
-    if (dy < 0) {
-      h = -h;
-    }
-    sx = dy === 0 ? 0 : h * dx / dy;
-    sy = h;
-  } else {
-    // Intersection is left or right of rect.
-    if (dx < 0) {
-      w = -w;
-    }
-    sx = w;
-    sy = dx === 0 ? 0 : w * dy / dx;
-  }
-
-  return {x: x + sx, y: y + sy};
-}
-
-function intersectEllipse(node, ellipseOrCircle, point) {
-  // Formulae from: http://mathworld.wolfram.com/Ellipse-LineIntersection.html
-
-  var cx = node.x;
-  var cy = node.y;
-  var rx, ry;
-
-  if (isCircle(ellipseOrCircle)) {
-    rx = ry = ellipseOrCircle.r.baseVal.value;
-  } else {
-    rx = ellipseOrCircle.rx.baseVal.value;
-    ry = ellipseOrCircle.ry.baseVal.value;
-  }
-
-  var px = cx - point.x;
-  var py = cy - point.y;
-
-  var det = Math.sqrt(rx * rx * py * py + ry * ry * px * px);
-
-  var dx = Math.abs(rx * ry * px / det);
-  if (point.x < cx) {
-    dx = -dx;
-  }
-  var dy = Math.abs(rx * ry * py / det);
-  if (point.y < cy) {
-    dy = -dy;
-  }
-
-  return {x: cx + dx, y: cy + dy};
-}
-
-function sameSign(r1, r2) {
-  return r1 * r2 > 0;
-}
-
-// Add point to the found intersections, but check first that it is unique.
-function addPoint(x, y, intersections) {
-  if (!intersections.some(function (elm) { return elm[0] === x && elm[1] === y; })) {
-    intersections.push([x, y]);
-  }
-}
-
-function intersectLine(x1, y1, x2, y2, x3, y3, x4, y4, intersections) {
-  // Algorithm from J. Avro, (ed.) Graphics Gems, No 2, Morgan Kaufmann, 1994, p7 and p473.
-
-  var a1, a2, b1, b2, c1, c2;
-  var r1, r2 , r3, r4;
-  var denom, offset, num;
-  var x, y;
-
-  // Compute a1, b1, c1, where line joining points 1 and 2 is F(x,y) = a1 x + b1 y + c1 = 0.
-  a1 = y2 - y1;
-  b1 = x1 - x2;
-  c1 = (x2 * y1) - (x1 * y2);
-
-  // Compute r3 and r4.
-  r3 = ((a1 * x3) + (b1 * y3) + c1);
-  r4 = ((a1 * x4) + (b1 * y4) + c1);
-
-  // Check signs of r3 and r4. If both point 3 and point 4 lie on
-  // same side of line 1, the line segments do not intersect.
-  if ((r3 !== 0) && (r4 !== 0) && sameSign(r3, r4)) {
-    return /*DONT_INTERSECT*/;
-  }
-
-  // Compute a2, b2, c2 where line joining points 3 and 4 is G(x,y) = a2 x + b2 y + c2 = 0
-  a2 = y4 - y3;
-  b2 = x3 - x4;
-  c2 = (x4 * y3) - (x3 * y4);
-
-  // Compute r1 and r2
-  r1 = (a2 * x1) + (b2 * y1) + c2;
-  r2 = (a2 * x2) + (b2 * y2) + c2;
-
-  // Check signs of r1 and r2. If both point 1 and point 2 lie
-  // on same side of second line segment, the line segments do
-  // not intersect.
-  if ((r1 !== 0) && (r2 !== 0) && (sameSign(r1, r2))) {
-    return /*DONT_INTERSECT*/;
-  }
-
-  // Line segments intersect: compute intersection point.
-  denom = (a1 * b2) - (a2 * b1);
-  if (denom === 0) {
-    return /*COLLINEAR*/;
-  }
-
-  offset = Math.abs(denom / 2);
-
-  // The denom/2 is to get rounding instead of truncating. It
-  // is added or subtracted to the numerator, depending upon the
-  // sign of the numerator.
-  num = (b1 * c2) - (b2 * c1);
-  x = (num < 0) ? ((num - offset) / denom) : ((num + offset) / denom);
-
-  num = (a2 * c1) - (a1 * c2);
-  y = (num < 0) ? ((num - offset) / denom) : ((num + offset) / denom);
-
-  // lines_intersect
-  addPoint(x, y, intersections);
-}
-
-function intersectPolygon(node, polygon, point) {
-  var x1 = node.x;
-  var y1 = node.y;
-  var x2 = point.x;
-  var y2 = point.y;
-
-  var intersections = [];
-  var points = polygon.points;
-
-  var minx = 100000, miny = 100000;
-  for (var j = 0; j < points.numberOfItems; j++) {
-    var p = points.getItem(j);
-    minx = Math.min(minx, p.x);
-    miny = Math.min(miny, p.y);
-  }
-
-  var left = x1 - node.width / 2 - minx;
-  var top =  y1 - node.height / 2 - miny;
-
-  for (var i = 0; i < points.numberOfItems; i++) {
-    var p1 = points.getItem(i);
-    var p2 = points.getItem(i < points.numberOfItems - 1 ? i + 1 : 0);
-    intersectLine(x1, y1, x2, y2, left + p1.x, top + p1.y, left + p2.x, top + p2.y, intersections);
-  }
-
-  if (intersections.length === 1) {
-    return {x: intersections[0][0], y: intersections[0][1]};
-  }
-
-  if (intersections.length > 1) {
-    // More intersections, find the one nearest to edge end point
-    intersections.sort(function(p, q) {
-      var pdx = p[0] - point.x,
-         pdy = p[1] - point.y,
-         distp = Math.sqrt(pdx * pdx + pdy * pdy),
-
-         qdx = q[0] - point.x,
-         qdy = q[1] - point.y,
-         distq = Math.sqrt(qdx * qdx + qdy * qdy);
-
-      return (distp < distq) ? -1 : (distp === distq ? 0 : 1);
-    });
-    return {x: intersections[0][0], y: intersections[0][1]};
-  } else {
-    console.log('NO INTERSECTION FOUND, RETURN NODE CENTER', node);
-    return node;
-  }
-}
-
-function isComposite(g, u) {
-  return 'children' in g && g.children(u).length;
-}
-
-function bind(func, thisArg) {
-  // For some reason PhantomJS occassionally fails when using the builtin bind,
-  // so we check if it is available and if not, use a degenerate polyfill.
-  if (func.bind) {
-    return func.bind(thisArg);
-  }
-
-  return function() {
-    return func.apply(thisArg, arguments);
-  };
-}
-
-function applyStyle(style, domNode) {
-  if (style) {
-    var currStyle = domNode.attr('style') || '';
-    domNode.attr('style', currStyle + '; ' + style);
-  }
-}
-
-},{"d3":10,"dagre":11}],4:[function(require,module,exports){
-module.exports = '0.2.9';
-
-},{}],5:[function(require,module,exports){
-exports.Set = require('./lib/Set');
-exports.PriorityQueue = require('./lib/PriorityQueue');
-exports.version = require('./lib/version');
-
-},{"./lib/PriorityQueue":6,"./lib/Set":7,"./lib/version":9}],6:[function(require,module,exports){
-module.exports = PriorityQueue;
-
-/**
- * A min-priority queue data structure. This algorithm is derived from Cormen,
- * et al., "Introduction to Algorithms". The basic idea of a min-priority
- * queue is that you can efficiently (in O(1) time) get the smallest key in
- * the queue. Adding and removing elements takes O(log n) time. A key can
- * have its priority decreased in O(log n) time.
- */
-function PriorityQueue() {
-  this._arr = [];
-  this._keyIndices = {};
-}
-
-/**
- * Returns the number of elements in the queue. Takes `O(1)` time.
- */
-PriorityQueue.prototype.size = function() {
-  return this._arr.length;
-};
-
-/**
- * Returns the keys that are in the queue. Takes `O(n)` time.
- */
-PriorityQueue.prototype.keys = function() {
-  return this._arr.map(function(x) { return x.key; });
-};
-
-/**
- * Returns `true` if **key** is in the queue and `false` if not.
- */
-PriorityQueue.prototype.has = function(key) {
-  return key in this._keyIndices;
-};
-
-/**
- * Returns the priority for **key**. If **key** is not present in the queue
- * then this function returns `undefined`. Takes `O(1)` time.
- *
- * @param {Object} key
- */
-PriorityQueue.prototype.priority = function(key) {
-  var index = this._keyIndices[key];
-  if (index !== undefined) {
-    return this._arr[index].priority;
-  }
-};
-
-/**
- * Returns the key for the minimum element in this queue. If the queue is
- * empty this function throws an Error. Takes `O(1)` time.
- */
-PriorityQueue.prototype.min = function() {
-  if (this.size() === 0) {
-    throw new Error("Queue underflow");
-  }
-  return this._arr[0].key;
-};
-
-/**
- * Inserts a new key into the priority queue. If the key already exists in
- * the queue this function returns `false`; otherwise it will return `true`.
- * Takes `O(n)` time.
- *
- * @param {Object} key the key to add
- * @param {Number} priority the initial priority for the key
- */
-PriorityQueue.prototype.add = function(key, priority) {
-  var keyIndices = this._keyIndices;
-  if (!(key in keyIndices)) {
-    var arr = this._arr;
-    var index = arr.length;
-    keyIndices[key] = index;
-    arr.push({key: key, priority: priority});
-    this._decrease(index);
-    return true;
-  }
-  return false;
-};
-
-/**
- * Removes and returns the smallest key in the queue. Takes `O(log n)` time.
- */
-PriorityQueue.prototype.removeMin = function() {
-  this._swap(0, this._arr.length - 1);
-  var min = this._arr.pop();
-  delete this._keyIndices[min.key];
-  this._heapify(0);
-  return min.key;
-};
-
-/**
- * Decreases the priority for **key** to **priority**. If the new priority is
- * greater than the previous priority, this function will throw an Error.
- *
- * @param {Object} key the key for which to raise priority
- * @param {Number} priority the new priority for the key
- */
-PriorityQueue.prototype.decrease = function(key, priority) {
-  var index = this._keyIndices[key];
-  if (priority > this._arr[index].priority) {
-    throw new Error("New priority is greater than current priority. " +
-        "Key: " + key + " Old: " + this._arr[index].priority + " New: " + priority);
-  }
-  this._arr[index].priority = priority;
-  this._decrease(index);
-};
-
-PriorityQueue.prototype._heapify = function(i) {
-  var arr = this._arr;
-  var l = 2 * i,
-      r = l + 1,
-      largest = i;
-  if (l < arr.length) {
-    largest = arr[l].priority < arr[largest].priority ? l : largest;
-    if (r < arr.length) {
-      largest = arr[r].priority < arr[largest].priority ? r : largest;
-    }
-    if (largest !== i) {
-      this._swap(i, largest);
-      this._heapify(largest);
-    }
-  }
-};
-
-PriorityQueue.prototype._decrease = function(index) {
-  var arr = this._arr;
-  var priority = arr[index].priority;
-  var parent;
-  while (index !== 0) {
-    parent = index >> 1;
-    if (arr[parent].priority < priority) {
-      break;
-    }
-    this._swap(index, parent);
-    index = parent;
-  }
-};
-
-PriorityQueue.prototype._swap = function(i, j) {
-  var arr = this._arr;
-  var keyIndices = this._keyIndices;
-  var origArrI = arr[i];
-  var origArrJ = arr[j];
-  arr[i] = origArrJ;
-  arr[j] = origArrI;
-  keyIndices[origArrJ.key] = i;
-  keyIndices[origArrI.key] = j;
-};
-
-},{}],7:[function(require,module,exports){
-var util = require('./util');
-
-module.exports = Set;
-
-/**
- * Constructs a new Set with an optional set of `initialKeys`.
- *
- * It is important to note that keys are coerced to String for most purposes
- * with this object, similar to the behavior of JavaScript's Object. For
- * example, the following will add only one key:
- *
- *     var s = new Set();
- *     s.add(1);
- *     s.add("1");
- *
- * However, the type of the key is preserved internally so that `keys` returns
- * the original key set uncoerced. For the above example, `keys` would return
- * `[1]`.
- */
-function Set(initialKeys) {
-  this._size = 0;
-  this._keys = {};
-
-  if (initialKeys) {
-    for (var i = 0, il = initialKeys.length; i < il; ++i) {
-      this.add(initialKeys[i]);
-    }
-  }
-}
-
-/**
- * Returns a new Set that represents the set intersection of the array of given
- * sets.
- */
-Set.intersect = function(sets) {
-  if (sets.length === 0) {
-    return new Set();
-  }
-
-  var result = new Set(!util.isArray(sets[0]) ? sets[0].keys() : sets[0]);
-  for (var i = 1, il = sets.length; i < il; ++i) {
-    var resultKeys = result.keys(),
-        other = !util.isArray(sets[i]) ? sets[i] : new Set(sets[i]);
-    for (var j = 0, jl = resultKeys.length; j < jl; ++j) {
-      var key = resultKeys[j];
-      if (!other.has(key)) {
-        result.remove(key);
-      }
-    }
-  }
-
-  return result;
-};
-
-/**
- * Returns a new Set that represents the set union of the array of given sets.
- */
-Set.union = function(sets) {
-  var totalElems = util.reduce(sets, function(lhs, rhs) {
-    return lhs + (rhs.size ? rhs.size() : rhs.length);
-  }, 0);
-  var arr = new Array(totalElems);
-
-  var k = 0;
-  for (var i = 0, il = sets.length; i < il; ++i) {
-    var cur = sets[i],
-        keys = !util.isArray(cur) ? cur.keys() : cur;
-    for (var j = 0, jl = keys.length; j < jl; ++j) {
-      arr[k++] = keys[j];
-    }
-  }
-
-  return new Set(arr);
-};
-
-/**
- * Returns the size of this set in `O(1)` time.
- */
-Set.prototype.size = function() {
-  return this._size;
-};
-
-/**
- * Returns the keys in this set. Takes `O(n)` time.
- */
-Set.prototype.keys = function() {
-  return values(this._keys);
-};
-
-/**
- * Tests if a key is present in this Set. Returns `true` if it is and `false`
- * if not. Takes `O(1)` time.
- */
-Set.prototype.has = function(key) {
-  return key in this._keys;
-};
-
-/**
- * Adds a new key to this Set if it is not already present. Returns `true` if
- * the key was added and `false` if it was already present. Takes `O(1)` time.
- */
-Set.prototype.add = function(key) {
-  if (!(key in this._keys)) {
-    this._keys[key] = key;
-    ++this._size;
-    return true;
-  }
-  return false;
-};
-
-/**
- * Removes a key from this Set. If the key was removed this function returns
- * `true`. If not, it returns `false`. Takes `O(1)` time.
- */
-Set.prototype.remove = function(key) {
-  if (key in this._keys) {
-    delete this._keys[key];
-    --this._size;
-    return true;
-  }
-  return false;
-};
-
-/*
- * Returns an array of all values for properties of **o**.
- */
-function values(o) {
-  var ks = Object.keys(o),
-      len = ks.length,
-      result = new Array(len),
-      i;
-  for (i = 0; i < len; ++i) {
-    result[i] = o[ks[i]];
-  }
-  return result;
-}
-
-},{"./util":8}],8:[function(require,module,exports){
-/*
- * This polyfill comes from
- * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray
- */
-if(!Array.isArray) {
-  exports.isArray = function (vArg) {
-    return Object.prototype.toString.call(vArg) === '[object Array]';
-  };
-} else {
-  exports.isArray = Array.isArray;
-}
-
-/*
- * Slightly adapted polyfill from
- * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/Reduce
- */
-if ('function' !== typeof Array.prototype.reduce) {
-  exports.reduce = function(array, callback, opt_initialValue) {
-    'use strict';
-    if (null === array || 'undefined' === typeof array) {
-      // At the moment all modern browsers, that support strict mode, have
-      // native implementation of Array.prototype.reduce. For instance, IE8
-      // does not support strict mode, so this check is actually useless.
-      throw new TypeError(
-          'Array.prototype.reduce called on null or undefined');
-    }
-    if ('function' !== typeof callback) {
-      throw new TypeError(callback + ' is not a function');
-    }
-    var index, value,
-        length = array.length >>> 0,
-        isValueSet = false;
-    if (1 < arguments.length) {
-      value = opt_initialValue;
-      isValueSet = true;
-    }
-    for (index = 0; length > index; ++index) {
-      if (array.hasOwnProperty(index)) {
-        if (isValueSet) {
-          value = callback(value, array[index], index, array);
-        }
-        else {
-          value = array[index];
-          isValueSet = true;
-        }
-      }
-    }
-    if (!isValueSet) {
-      throw new TypeError('Reduce of empty array with no initial value');
-    }
-    return value;
-  };
-} else {
-  exports.reduce = function(array, callback, opt_initialValue) {
-    return array.reduce(callback, opt_initialValue);
-  };
-}
-
-},{}],9:[function(require,module,exports){
-module.exports = '1.1.3';
-
-},{}],10:[function(require,module,exports){
-require("./d3");
-module.exports = d3;
-(function () { delete this.d3; })(); // unset global
-
-},{}],11:[function(require,module,exports){
-/*
-Copyright (c) 2012-2013 Chris Pettitt
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-*/
-exports.Digraph = require("graphlib").Digraph;
-exports.Graph = require("graphlib").Graph;
-exports.layout = require("./lib/layout");
-exports.version = require("./lib/version");
-exports.debug = require("./lib/debug");
-
-},{"./lib/debug":12,"./lib/layout":13,"./lib/version":28,"graphlib":29}],12:[function(require,module,exports){
-'use strict';
-
-var util = require('./util');
-
-/**
- * Renders a graph in a stringified DOT format that indicates the ordering of
- * nodes by layer. Circles represent normal nodes. Diamons represent dummy
- * nodes. While we try to put nodes in clusters, it appears that graphviz
- * does not respect this because we're later using subgraphs for ordering nodes
- * in each layer.
- */
-exports.dotOrdering = function(g) {
-  var ordering = util.ordering(g.filterNodes(util.filterNonSubgraphs(g)));
-  var result = 'digraph {';
-
-  function dfs(u) {
-    var children = g.children(u);
-    if (children.length) {
-      result += 'subgraph cluster_' + u + ' {';
-      result += 'label="' + u + '";';
-      children.forEach(function(v) {
-        dfs(v);
-      });
-      result += '}';
-    } else {
-      result += u;
-      if (g.node(u).dummy) {
-        result += ' [shape=diamond]';
-      }
-      result += ';';
-    }
-  }
-
-  g.children(null).forEach(dfs);
-
-  ordering.forEach(function(layer) {
-    result += 'subgraph { rank=same; edge [style="invis"];';
-    result += layer.join('->');
-    result += '}';
-  });
-
-  g.eachEdge(function(e, u, v) {
-    result += u + '->' + v + ';';
-  });
-
-  result += '}';
-
-  return result;
-};
-
-},{"./util":27}],13:[function(require,module,exports){
-'use strict';
-
-var util = require('./util'),
-    rank = require('./rank'),
-    order = require('./order'),
-    CGraph = require('graphlib').CGraph,
-    CDigraph = require('graphlib').CDigraph;
-
-module.exports = function() {
-  // External configuration
-  var config = {
-    // How much debug information to include?
-    debugLevel: 0,
-    // Max number of sweeps to perform in order phase
-    orderMaxSweeps: order.DEFAULT_MAX_SWEEPS,
-    // Use network simplex algorithm in ranking
-    rankSimplex: false,
-    // Rank direction. Valid values are (TB, LR)
-    rankDir: 'TB'
-  };
-
-  // Phase functions
-  var position = require('./position')();
-
-  // This layout object
-  var self = {};
-
-  self.orderIters = util.propertyAccessor(self, config, 'orderMaxSweeps');
-
-  self.rankSimplex = util.propertyAccessor(self, config, 'rankSimplex');
-
-  self.nodeSep = delegateProperty(position.nodeSep);
-  self.edgeSep = delegateProperty(position.edgeSep);
-  self.universalSep = delegateProperty(position.universalSep);
-  self.rankSep = delegateProperty(position.rankSep);
-  self.rankDir = util.propertyAccessor(self, config, 'rankDir');
-  self.debugAlignment = delegateProperty(position.debugAlignment);
-
-  self.debugLevel = util.propertyAccessor(self, config, 'debugLevel', function(x) {
-    util.log.level = x;
-    position.debugLevel(x);
-  });
-
-  self.run = util.time('Total layout', run);
-
-  self._normalize = normalize;
-
-  return self;
-
-  /*
-   * Constructs an adjacency graph using the nodes and edges specified through
-   * config. For each node and edge we add a property `dagre` that contains an
-   * object that will hold intermediate and final layout information. Some of
-   * the contents include:
-   *
-   *  1) A generated ID that uniquely identifies the object.
-   *  2) Dimension information for nodes (copied from the source node).
-   *  3) Optional dimension information for edges.
-   *
-   * After the adjacency graph is constructed the code no longer needs to use
-   * the original nodes and edges passed in via config.
-   */
-  function initLayoutGraph(inputGraph) {
-    var g = new CDigraph();
-
-    inputGraph.eachNode(function(u, value) {
-      if (value === undefined) value = {};
-      g.addNode(u, {
-        width: value.width,
-        height: value.height
-      });
-      if (value.hasOwnProperty('rank')) {
-        g.node(u).prefRank = value.rank;
-      }
-    });
-
-    // Set up subgraphs
-    if (inputGraph.parent) {
-      inputGraph.nodes().forEach(function(u) {
-        g.parent(u, inputGraph.parent(u));
-      });
-    }
-
-    inputGraph.eachEdge(function(e, u, v, value) {
-      if (value === undefined) value = {};
-      var newValue = {
-        e: e,
-        minLen: value.minLen || 1,
-        width: value.width || 0,
-        height: value.height || 0,
-        points: []
-      };
-
-      g.addEdge(null, u, v, newValue);
-    });
-
-    // Initial graph attributes
-    var graphValue = inputGraph.graph() || {};
-    g.graph({
-      rankDir: graphValue.rankDir || config.rankDir,
-      orderRestarts: graphValue.orderRestarts
-    });
-
-    return g;
-  }
-
-  function run(inputGraph) {
-    var rankSep = self.rankSep();
-    var g;
-    try {
-      // Build internal graph
-      g = util.time('initLayoutGraph', initLayoutGraph)(inputGraph);
-
-      if (g.order() === 0) {
-        return g;
-      }
-
-      // Make space for edge labels
-      g.eachEdge(function(e, s, t, a) {
-        a.minLen *= 2;
-      });
-      self.rankSep(rankSep / 2);
-
-      // Determine the rank for each node. Nodes with a lower rank will appear
-      // above nodes of higher rank.
-      util.time('rank.run', rank.run)(g, config.rankSimplex);
-
-      // Normalize the graph by ensuring that every edge is proper (each edge has
-      // a length of 1). We achieve this by adding dummy nodes to long edges,
-      // thus shortening them.
-      util.time('normalize', normalize)(g);
-
-      // Order the nodes so that edge crossings are minimized.
-      util.time('order', order)(g, config.orderMaxSweeps);
-
-      // Find the x and y coordinates for every node in the graph.
-      util.time('position', position.run)(g);
-
-      // De-normalize the graph by removing dummy nodes and augmenting the
-      // original long edges with coordinate information.
-      util.time('undoNormalize', undoNormalize)(g);
-
-      // Reverses points for edges that are in a reversed state.
-      util.time('fixupEdgePoints', fixupEdgePoints)(g);
-
-      // Restore delete edges and reverse edges that were reversed in the rank
-      // phase.
-      util.time('rank.restoreEdges', rank.restoreEdges)(g);
-
-      // Construct final result graph and return it
-      return util.time('createFinalGraph', createFinalGraph)(g, inputGraph.isDirected());
-    } finally {
-      self.rankSep(rankSep);
-    }
-  }
-
-  /*
-   * This function is responsible for 'normalizing' the graph. The process of
-   * normalization ensures that no edge in the graph has spans more than one
-   * rank. To do this it inserts dummy nodes as needed and links them by adding
-   * dummy edges. This function keeps enough information in the dummy nodes and
-   * edges to ensure that the original graph can be reconstructed later.
-   *
-   * This method assumes that the input graph is cycle free.
-   */
-  function normalize(g) {
-    var dummyCount = 0;
-    g.eachEdge(function(e, s, t, a) {
-      var sourceRank = g.node(s).rank;
-      var targetRank = g.node(t).rank;
-      if (sourceRank + 1 < targetRank) {
-        for (var u = s, rank = sourceRank + 1, i = 0; rank < targetRank; ++rank, ++i) {
-          var v = '_D' + (++dummyCount);
-          var node = {
-            width: a.width,
-            height: a.height,
-            edge: { id: e, source: s, target: t, attrs: a },
-            rank: rank,
-            dummy: true
-          };
-
-          // If this node represents a bend then we will use it as a control
-          // point. For edges with 2 segments this will be the center dummy
-          // node. For edges with more than two segments, this will be the
-          // first and last dummy node.
-          if (i === 0) node.index = 0;
-          else if (rank + 1 === targetRank) node.index = 1;
-
-          g.addNode(v, node);
-          g.addEdge(null, u, v, {});
-          u = v;
-        }
-        g.addEdge(null, u, t, {});
-        g.delEdge(e);
-      }
-    });
-  }
-
-  /*
-   * Reconstructs the graph as it was before normalization. The positions of
-   * dummy nodes are used to build an array of points for the original 'long'
-   * edge. Dummy nodes and edges are removed.
-   */
-  function undoNormalize(g) {
-    g.eachNode(function(u, a) {
-      if (a.dummy) {
-        if ('index' in a) {
-          var edge = a.edge;
-          if (!g.hasEdge(edge.id)) {
-            g.addEdge(edge.id, edge.source, edge.target, edge.attrs);
-          }
-          var points = g.edge(edge.id).points;
-          points[a.index] = { x: a.x, y: a.y, ul: a.ul, ur: a.ur, dl: a.dl, dr: a.dr };
-        }
-        g.delNode(u);
-      }
-    });
-  }
-
-  /*
-   * For each edge that was reversed during the `acyclic` step, reverse its
-   * array of points.
-   */
-  function fixupEdgePoints(g) {
-    g.eachEdge(function(e, s, t, a) { if (a.reversed) a.points.reverse(); });
-  }
-
-  function createFinalGraph(g, isDirected) {
-    var out = isDirected ? new CDigraph() : new CGraph();
-    out.graph(g.graph());
-    g.eachNode(function(u, value) { out.addNode(u, value); });
-    g.eachNode(function(u) { out.parent(u, g.parent(u)); });
-    g.eachEdge(function(e, u, v, value) {
-      out.addEdge(value.e, u, v, value);
-    });
-
-    // Attach bounding box information
-    var maxX = 0, maxY = 0;
-    g.eachNode(function(u, value) {
-      if (!g.children(u).length) {
-        maxX = Math.max(maxX, value.x + value.width / 2);
-        maxY = Math.max(maxY, value.y + value.height / 2);
-      }
-    });
-    g.eachEdge(function(e, u, v, value) {
-      var maxXPoints = Math.max.apply(Math, value.points.map(function(p) { return p.x; }));
-      var maxYPoints = Math.max.apply(Math, value.points.map(function(p) { return p.y; }));
-      maxX = Math.max(maxX, maxXPoints + value.width / 2);
-      maxY = Math.max(maxY, maxYPoints + value.height / 2);
-    });
-    out.graph().width = maxX;
-    out.graph().height = maxY;
-
-    return out;
-  }
-
-  /*
-   * Given a function, a new function is returned that invokes the given
-   * function. The return value from the function is always the `self` object.
-   */
-  function delegateProperty(f) {
-    return function() {
-      if (!arguments.length) return f();
-      f.apply(null, arguments);
-      return self;
-    };
-  }
-};
-
-
-},{"./order":14,"./position":19,"./rank":20,"./util":27,"graphlib":29}],14:[function(require,module,exports){
-'use strict';
-
-var util = require('./util'),
-    crossCount = require('./order/crossCount'),
-    initLayerGraphs = require('./order/initLayerGraphs'),
-    initOrder = require('./order/initOrder'),
-    sortLayer = require('./order/sortLayer');
-
-module.exports = order;
-
-// The maximum number of sweeps to perform before finishing the order phase.
-var DEFAULT_MAX_SWEEPS = 24;
-order.DEFAULT_MAX_SWEEPS = DEFAULT_MAX_SWEEPS;
-
-/*
- * Runs the order phase with the specified `graph, `maxSweeps`, and
- * `debugLevel`. If `maxSweeps` is not specified we use `DEFAULT_MAX_SWEEPS`.
- * If `debugLevel` is not set we assume 0.
- */
-function order(g, maxSweeps) {
-  if (arguments.length < 2) {
-    maxSweeps = DEFAULT_MAX_SWEEPS;
-  }
-
-  var restarts = g.graph().orderRestarts || 0;
-
-  var layerGraphs = initLayerGraphs(g);
-  // TODO: remove this when we add back support for ordering clusters
-  layerGraphs.forEach(function(lg) {
-    lg = lg.filterNodes(function(u) { return !g.children(u).length; });
-  });
-
-  var iters = 0,
-      currentBestCC,
-      allTimeBestCC = Number.MAX_VALUE,
-      allTimeBest = {};
-
-  function saveAllTimeBest() {
-    g.eachNode(function(u, value) { allTimeBest[u] = value.order; });
-  }
-
-  for (var j = 0; j < Number(restarts) + 1 && allTimeBestCC !== 0; ++j) {
-    currentBestCC = Number.MAX_VALUE;
-    initOrder(g, restarts > 0);
-
-    util.log(2, 'Order phase start cross count: ' + g.graph().orderInitCC);
-
-    var i, lastBest, cc;
-    for (i = 0, lastBest = 0; lastBest < 4 && i < maxSweeps && currentBestCC > 0; ++i, ++lastBest, ++iters) {
-      sweep(g, layerGraphs, i);
-      cc = crossCount(g);
-      if (cc < currentBestCC) {
-        lastBest = 0;
-        currentBestCC = cc;
-        if (cc < allTimeBestCC) {
-          saveAllTimeBest();
-          allTimeBestCC = cc;
-        }
-      }
-      util.log(3, 'Order phase start ' + j + ' iter ' + i + ' cross count: ' + cc);
-    }
-  }
-
-  Object.keys(allTimeBest).forEach(function(u) {
-    if (!g.children || !g.children(u).length) {
-      g.node(u).order = allTimeBest[u];
-    }
-  });
-  g.graph().orderCC = allTimeBestCC;
-
-  util.log(2, 'Order iterations: ' + iters);
-  util.log(2, 'Order phase best cross count: ' + g.graph().orderCC);
-}
-
-function predecessorWeights(g, nodes) {
-  var weights = {};
-  nodes.forEach(function(u) {
-    weights[u] = g.inEdges(u).map(function(e) {
-      return g.node(g.source(e)).order;
-    });
-  });
-  return weights;
-}
-
-function successorWeights(g, nodes) {
-  var weights = {};
-  nodes.forEach(function(u) {
-    weights[u] = g.outEdges(u).map(function(e) {
-      return g.node(g.target(e)).order;
-    });
-  });
-  return weights;
-}
-
-function sweep(g, layerGraphs, iter) {
-  if (iter % 2 === 0) {
-    sweepDown(g, layerGraphs, iter);
-  } else {
-    sweepUp(g, layerGraphs, iter);
-  }
-}
-
-function sweepDown(g, layerGraphs) {
-  var cg;
-  for (var i = 1; i < layerGraphs.length; ++i) {
-    cg = sortLayer(layerGraphs[i], cg, predecessorWeights(g, layerGraphs[i].nodes()));
-  }
-}
-
-function sweepUp(g, layerGraphs) {
-  var cg;
-  for (var i = layerGraphs.length - 2; i >= 0; --i) {
-    sortLayer(layerGraphs[i], cg, successorWeights(g, layerGraphs[i].nodes()));
-  }
-}
-
-},{"./order/crossCount":15,"./order/initLayerGraphs":16,"./order/initOrder":17,"./order/sortLayer":18,"./util":27}],15:[function(require,module,exports){
-'use strict';
-
-var util = require('../util');
-
-module.exports = crossCount;
-
-/*
- * Returns the cross count for the given graph.
- */
-function crossCount(g) {
-  var cc = 0;
-  var ordering = util.ordering(g);
-  for (var i = 1; i < ordering.length; ++i) {
-    cc += twoLayerCrossCount(g, ordering[i-1], ordering[i]);
-  }
-  return cc;
-}
-
-/*
- * This function searches through a ranked and ordered graph and counts the
- * number of edges that cross. This algorithm is derived from:
- *
- *    W. Barth et al., Bilayer Cross Counting, JGAA, 8(2) 179–194 (2004)
- */
-function twoLayerCrossCount(g, layer1, layer2) {
-  var indices = [];
-  layer1.forEach(function(u) {
-    var nodeIndices = [];
-    g.outEdges(u).forEach(function(e) { nodeIndices.push(g.node(g.target(e)).order); });
-    nodeIndices.sort(function(x, y) { return x - y; });
-    indices = indices.concat(nodeIndices);
-  });
-
-  var firstIndex = 1;
-  while (firstIndex < layer2.length) firstIndex <<= 1;
-
-  var treeSize = 2 * firstIndex - 1;
-  firstIndex -= 1;
-
-  var tree = [];
-  for (var i = 0; i < treeSize; ++i) { tree[i] = 0; }
-
-  var cc = 0;
-  indices.forEach(function(i) {
-    var treeIndex = i + firstIndex;
-    ++tree[treeIndex];
-    while (treeIndex > 0) {
-      if (treeIndex % 2) {
-        cc += tree[treeIndex + 1];
-      }
-      treeIndex = (treeIndex - 1) >> 1;
-      ++tree[treeIndex];
-    }
-  });
-
-  return cc;
-}
-
-},{"../util":27}],16:[function(require,module,exports){
-'use strict';
-
-var nodesFromList = require('graphlib').filter.nodesFromList,
-    /* jshint -W079 */
-    Set = require('cp-data').Set;
-
-module.exports = initLayerGraphs;
-
-/*
- * This function takes a compound layered graph, g, and produces an array of
- * layer graphs. Each entry in the array represents a subgraph of nodes
- * relevant for performing crossing reduction on that layer.
- */
-function initLayerGraphs(g) {
-  var ranks = [];
-
-  function dfs(u) {
-    if (u === null) {
-      g.children(u).forEach(function(v) { dfs(v); });
-      return;
-    }
-
-    var value = g.node(u);
-    value.minRank = ('rank' in value) ? value.rank : Number.MAX_VALUE;
-    value.maxRank = ('rank' in value) ? value.rank : Number.MIN_VALUE;
-    var uRanks = new Set();
-    g.children(u).forEach(function(v) {
-      var rs = dfs(v);
-      uRanks = Set.union([uRanks, rs]);
-      value.minRank = Math.min(value.minRank, g.node(v).minRank);
-      value.maxRank = Math.max(value.maxRank, g.node(v).maxRank);
-    });
-
-    if ('rank' in value) uRanks.add(value.rank);
-
-    uRanks.keys().forEach(function(r) {
-      if (!(r in ranks)) ranks[r] = [];
-      ranks[r].push(u);
-    });
-
-    return uRanks;
-  }
-  dfs(null);
-
-  var layerGraphs = [];
-  ranks.forEach(function(us, rank) {
-    layerGraphs[rank] = g.filterNodes(nodesFromList(us));
-  });
-
-  return layerGraphs;
-}
-
-},{"cp-data":5,"graphlib":29}],17:[function(require,module,exports){
-'use strict';
-
-var crossCount = require('./crossCount'),
-    util = require('../util');
-
-module.exports = initOrder;
-
-/*
- * Given a graph with a set of layered nodes (i.e. nodes that have a `rank`
- * attribute) this function attaches an `order` attribute that uniquely
- * arranges each node of each rank. If no constraint graph is provided the
- * order of the nodes in each rank is entirely arbitrary.
- */
-function initOrder(g, random) {
-  var layers = [];
-
-  g.eachNode(function(u, value) {
-    var layer = layers[value.rank];
-    if (g.children && g.children(u).length > 0) return;
-    if (!layer) {
-      layer = layers[value.rank] = [];
-    }
-    layer.push(u);
-  });
-
-  layers.forEach(function(layer) {
-    if (random) {
-      util.shuffle(layer);
-    }
-    layer.forEach(function(u, i) {
-      g.node(u).order = i;
-    });
-  });
-
-  var cc = crossCount(g);
-  g.graph().orderInitCC = cc;
-  g.graph().orderCC = Number.MAX_VALUE;
-}
-
-},{"../util":27,"./crossCount":15}],18:[function(require,module,exports){
-'use strict';
-
-var util = require('../util'),
-    Digraph = require('graphlib').Digraph,
-    topsort = require('graphlib').alg.topsort,
-    nodesFromList = require('graphlib').filter.nodesFromList;
-
-module.exports = sortLayer;
-
-function sortLayer(g, cg, weights) {
-  weights = adjustWeights(g, weights);
-  var result = sortLayerSubgraph(g, null, cg, weights);
-
-  result.list.forEach(function(u, i) {
-    g.node(u).order = i;
-  });
-  return result.constraintGraph;
-}
-
-function sortLayerSubgraph(g, sg, cg, weights) {
-  cg = cg ? cg.filterNodes(nodesFromList(g.children(sg))) : new Digraph();
-
-  var nodeData = {};
-  g.children(sg).forEach(function(u) {
-    if (g.children(u).length) {
-      nodeData[u] = sortLayerSubgraph(g, u, cg, weights);
-      nodeData[u].firstSG = u;
-      nodeData[u].lastSG = u;
-    } else {
-      var ws = weights[u];
-      nodeData[u] = {
-        degree: ws.length,
-        barycenter: util.sum(ws) / ws.length,
-        order: g.node(u).order,
-        orderCount: 1,
-        list: [u]
-      };
-    }
-  });
-
-  resolveViolatedConstraints(g, cg, nodeData);
-
-  var keys = Object.keys(nodeData);
-  keys.sort(function(x, y) {
-    return nodeData[x].barycenter - nodeData[y].barycenter ||
-           nodeData[x].order - nodeData[y].order;
-  });
-
-  var result =  keys.map(function(u) { return nodeData[u]; })
-                    .reduce(function(lhs, rhs) { return mergeNodeData(g, lhs, rhs); });
-  return result;
-}
-
-function mergeNodeData(g, lhs, rhs) {
-  var cg = mergeDigraphs(lhs.constraintGraph, rhs.constraintGraph);
-
-  if (lhs.lastSG !== undefined && rhs.firstSG !== undefined) {
-    if (cg === undefined) {
-      cg = new Digraph();
-    }
-    if (!cg.hasNode(lhs.lastSG)) { cg.addNode(lhs.lastSG); }
-    cg.addNode(rhs.firstSG);
-    cg.addEdge(null, lhs.lastSG, rhs.firstSG);
-  }
-
-  return {
-    degree: lhs.degree + rhs.degree,
-    barycenter: (lhs.barycenter * lhs.degree + rhs.barycenter * rhs.degree) /
-                (lhs.degree + rhs.degree),
-    order: (lhs.order * lhs.orderCount + rhs.order * rhs.orderCount) /
-           (lhs.orderCount + rhs.orderCount),
-    orderCount: lhs.orderCount + rhs.orderCount,
-    list: lhs.list.concat(rhs.list),
-    firstSG: lhs.firstSG !== undefined ? lhs.firstSG : rhs.firstSG,
-    lastSG: rhs.lastSG !== undefined ? rhs.lastSG : lhs.lastSG,
-    constraintGraph: cg
-  };
-}
-
-function mergeDigraphs(lhs, rhs) {
-  if (lhs === undefined) return rhs;
-  if (rhs === undefined) return lhs;
-
-  lhs = lhs.copy();
-  rhs.nodes().forEach(function(u) { lhs.addNode(u); });
-  rhs.edges().forEach(function(e, u, v) { lhs.addEdge(null, u, v); });
-  return lhs;
-}
-
-function resolveViolatedConstraints(g, cg, nodeData) {
-  // Removes nodes `u` and `v` from `cg` and makes any edges incident on them
-  // incident on `w` instead.
-  function collapseNodes(u, v, w) {
-    // TODO original paper removes self loops, but it is not obvious when this would happen
-    cg.inEdges(u).forEach(function(e) {
-      cg.delEdge(e);
-      cg.addEdge(null, cg.source(e), w);
-    });
-
-    cg.outEdges(v).forEach(function(e) {
-      cg.delEdge(e);
-      cg.addEdge(null, w, cg.target(e));
-    });
-
-    cg.delNode(u);
-    cg.delNode(v);
-  }
-
-  var violated;
-  while ((violated = findViolatedConstraint(cg, nodeData)) !== undefined) {
-    var source = cg.source(violated),
-        target = cg.target(violated);
-
-    var v;
-    while ((v = cg.addNode(null)) && g.hasNode(v)) {
-      cg.delNode(v);
-    }
-
-    // Collapse barycenter and list
-    nodeData[v] = mergeNodeData(g, nodeData[source], nodeData[target]);
-    delete nodeData[source];
-    delete nodeData[target];
-
-    collapseNodes(source, target, v);
-    if (cg.incidentEdges(v).length === 0) { cg.delNode(v); }
-  }
-}
-
-function findViolatedConstraint(cg, nodeData) {
-  var us = topsort(cg);
-  for (var i = 0; i < us.length; ++i) {
-    var u = us[i];
-    var inEdges = cg.inEdges(u);
-    for (var j = 0; j < inEdges.length; ++j) {
-      var e = inEdges[j];
-      if (nodeData[cg.source(e)].barycenter >= nodeData[u].barycenter) {
-        return e;
-      }
-    }
-  }
-}
-
-// Adjust weights so that they fall in the range of 0..|N|-1. If a node has no
-// weight assigned then set its adjusted weight to its current position. This
-// allows us to better retain the origiinal position of nodes without neighbors.
-function adjustWeights(g, weights) {
-  var minW = Number.MAX_VALUE,
-      maxW = 0,
-      adjusted = {};
-  g.eachNode(function(u) {
-    if (g.children(u).length) return;
-
-    var ws = weights[u];
-    if (ws.length) {
-      minW = Math.min(minW, util.min(ws));
-      maxW = Math.max(maxW, util.max(ws));
-    }
-  });
-
-  var rangeW = (maxW - minW);
-  g.eachNode(function(u) {
-    if (g.children(u).length) return;
-
-    var ws = weights[u];
-    if (!ws.length) {
-      adjusted[u] = [g.node(u).order];
-    } else {
-      adjusted[u] = ws.map(function(w) {
-        if (rangeW) {
-          return (w - minW) * (g.order() - 1) / rangeW;
-        } else {
-          return g.order() - 1 / 2;
-        }
-      });
-    }
-  });
-
-  return adjusted;
-}
-
-},{"../util":27,"graphlib":29}],19:[function(require,module,exports){
-'use strict';
-
-var util = require('./util');
-
-/*
- * The algorithms here are based on Brandes and Köpf, "Fast and Simple
- * Horizontal Coordinate Assignment".
- */
-module.exports = function() {
-  // External configuration
-  var config = {
-    nodeSep: 50,
-    edgeSep: 10,
-    universalSep: null,
-    rankSep: 30
-  };
-
-  var self = {};
-
-  self.nodeSep = util.propertyAccessor(self, config, 'nodeSep');
-  self.edgeSep = util.propertyAccessor(self, config, 'edgeSep');
-  // If not null this separation value is used for all nodes and edges
-  // regardless of their widths. `nodeSep` and `edgeSep` are ignored with this
-  // option.
-  self.universalSep = util.propertyAccessor(self, config, 'universalSep');
-  self.rankSep = util.propertyAccessor(self, config, 'rankSep');
-  self.debugLevel = util.propertyAccessor(self, config, 'debugLevel');
-
-  self.run = run;
-
-  return self;
-
-  function run(g) {
-    g = g.filterNodes(util.filterNonSubgraphs(g));
-
-    var layering = util.ordering(g);
-
-    var conflicts = findConflicts(g, layering);
-
-    var xss = {};
-    ['u', 'd'].forEach(function(vertDir) {
-      if (vertDir === 'd') layering.reverse();
-
-      ['l', 'r'].forEach(function(horizDir) {
-        if (horizDir === 'r') reverseInnerOrder(layering);
-
-        var dir = vertDir + horizDir;
-        var align = verticalAlignment(g, layering, conflicts, vertDir === 'u' ? 'predecessors' : 'successors');
-        xss[dir]= horizontalCompaction(g, layering, align.pos, align.root, align.align);
-
-        if (config.debugLevel >= 3)
-          debugPositioning(vertDir + horizDir, g, layering, xss[dir]);
-
-        if (horizDir === 'r') flipHorizontally(xss[dir]);
-
-        if (horizDir === 'r') reverseInnerOrder(layering);
-      });
-
-      if (vertDir === 'd') layering.reverse();
-    });
-
-    balance(g, layering, xss);
-
-    g.eachNode(function(v) {
-      var xs = [];
-      for (var alignment in xss) {
-        var alignmentX = xss[alignment][v];
-        posXDebug(alignment, g, v, alignmentX);
-        xs.push(alignmentX);
-      }
-      xs.sort(function(x, y) { return x - y; });
-      posX(g, v, (xs[1] + xs[2]) / 2);
-    });
-
-    // Align y coordinates with ranks
-    var y = 0, reverseY = g.graph().rankDir === 'BT' || g.graph().rankDir === 'RL';
-    layering.forEach(function(layer) {
-      var maxHeight = util.max(layer.map(function(u) { return height(g, u); }));
-      y += maxHeight / 2;
-      layer.forEach(function(u) {
-        posY(g, u, reverseY ? -y : y);
-      });
-      y += maxHeight / 2 + config.rankSep;
-    });
-
-    // Translate layout so that top left corner of bounding rectangle has
-    // coordinate (0, 0).
-    var minX = util.min(g.nodes().map(function(u) { return posX(g, u) - width(g, u) / 2; }));
-    var minY = util.min(g.nodes().map(function(u) { return posY(g, u) - height(g, u) / 2; }));
-    g.eachNode(function(u) {
-      posX(g, u, posX(g, u) - minX);
-      posY(g, u, posY(g, u) - minY);
-    });
-  }
-
-  /*
-   * Generate an ID that can be used to represent any undirected edge that is
-   * incident on `u` and `v`.
-   */
-  function undirEdgeId(u, v) {
-    return u < v
-      ? u.toString().length + ':' + u + '-' + v
-      : v.toString().length + ':' + v + '-' + u;
-  }
-
-  function findConflicts(g, layering) {
-    var conflicts = {}, // Set of conflicting edge ids
-        pos = {},       // Position of node in its layer
-        prevLayer,
-        currLayer,
-        k0,     // Position of the last inner segment in the previous layer
-        l,      // Current position in the current layer (for iteration up to `l1`)
-        k1;     // Position of the next inner segment in the previous layer or
-                // the position of the last element in the previous layer
-
-    if (layering.length <= 2) return conflicts;
-
-    function updateConflicts(v) {
-      var k = pos[v];
-      if (k < k0 || k > k1) {
-        conflicts[undirEdgeId(currLayer[l], v)] = true;
-      }
-    }
-
-    layering[1].forEach(function(u, i) { pos[u] = i; });
-    for (var i = 1; i < layering.length - 1; ++i) {
-      prevLayer = layering[i];
-      currLayer = layering[i+1];
-      k0 = 0;
-      l = 0;
-
-      // Scan current layer for next node that is incident to an inner segement
-      // between layering[i+1] and layering[i].
-      for (var l1 = 0; l1 < currLayer.length; ++l1) {
-        var u = currLayer[l1]; // Next inner segment in the current layer or
-                               // last node in the current layer
-        pos[u] = l1;
-        k1 = undefined;
-
-        if (g.node(u).dummy) {
-          var uPred = g.predecessors(u)[0];
-          // Note: In the case of self loops and sideways edges it is possible
-          // for a dummy not to have a predecessor.
-          if (uPred !== undefined && g.node(uPred).dummy)
-            k1 = pos[uPred];
-        }
-        if (k1 === undefined && l1 === currLayer.length - 1)
-          k1 = prevLayer.length - 1;
-
-        if (k1 !== undefined) {
-          for (; l <= l1; ++l) {
-            g.predecessors(currLayer[l]).forEach(updateConflicts);
-          }
-          k0 = k1;
-        }
-      }
-    }
-
-    return conflicts;
-  }
-
-  function verticalAlignment(g, layering, conflicts, relationship) {
-    var pos = {},   // Position for a node in its layer
-        root = {},  // Root of the block that the node participates in
-        align = {}; // Points to the next node in the block or, if the last
-                    // element in the block, points to the first block's root
-
-    layering.forEach(function(layer) {
-      layer.forEach(function(u, i) {
-        root[u] = u;
-        align[u] = u;
-        pos[u] = i;
-      });
-    });
-
-    layering.forEach(function(layer) {
-      var prevIdx = -1;
-      layer.forEach(function(v) {
-        var related = g[relationship](v), // Adjacent nodes from the previous layer
-            mid;                          // The mid point in the related array
-
-        if (related.length > 0) {
-          related.sort(function(x, y) { return pos[x] - pos[y]; });
-          mid = (related.length - 1) / 2;
-          related.slice(Math.floor(mid), Math.ceil(mid) + 1).forEach(function(u) {
-            if (align[v] === v) {
-              if (!conflicts[undirEdgeId(u, v)] && prevIdx < pos[u]) {
-                align[u] = v;
-                align[v] = root[v] = root[u];
-                prevIdx = pos[u];
-              }
-            }
-          });
-        }
-      });
-    });
-
-    return { pos: pos, root: root, align: align };
-  }
-
-  // This function deviates from the standard BK algorithm in two ways. First
-  // it takes into account the size of the nodes. Second it includes a fix to
-  // the original algorithm that is described in Carstens, "Node and Label
-  // Placement in a Layered Layout Algorithm".
-  function horizontalCompaction(g, layering, pos, root, align) {
-    var sink = {},       // Mapping of node id -> sink node id for class
-        maybeShift = {}, // Mapping of sink node id -> { class node id, min shift }
-        shift = {},      // Mapping of sink node id -> shift
-        pred = {},       // Mapping of node id -> predecessor node (or null)
-        xs = {};         // Calculated X positions
-
-    layering.forEach(function(layer) {
-      layer.forEach(function(u, i) {
-        sink[u] = u;
-        maybeShift[u] = {};
-        if (i > 0)
-          pred[u] = layer[i - 1];
-      });
-    });
-
-    function updateShift(toShift, neighbor, delta) {
-      if (!(neighbor in maybeShift[toShift])) {
-        maybeShift[toShift][neighbor] = delta;
-      } else {
-        maybeShift[toShift][neighbor] = Math.min(maybeShift[toShift][neighbor], delta);
-      }
-    }
-
-    function placeBlock(v) {
-      if (!(v in xs)) {
-        xs[v] = 0;
-        var w = v;
-        do {
-          if (pos[w] > 0) {
-            var u = root[pred[w]];
-            placeBlock(u);
-            if (sink[v] === v) {
-              sink[v] = sink[u];
-            }
-            var delta = sep(g, pred[w]) + sep(g, w);
-            if (sink[v] !== sink[u]) {
-              updateShift(sink[u], sink[v], xs[v] - xs[u] - delta);
-            } else {
-              xs[v] = Math.max(xs[v], xs[u] + delta);
-            }
-          }
-          w = align[w];
-        } while (w !== v);
-      }
-    }
-
-    // Root coordinates relative to sink
-    util.values(root).forEach(function(v) {
-      placeBlock(v);
-    });
-
-    // Absolute coordinates
-    // There is an assumption here that we've resolved shifts for any classes
-    // that begin at an earlier layer. We guarantee this by visiting layers in
-    // order.
-    layering.forEach(function(layer) {
-      layer.forEach(function(v) {
-        xs[v] = xs[root[v]];
-        if (v === root[v] && v === sink[v]) {
-          var minShift = 0;
-          if (v in maybeShift && Object.keys(maybeShift[v]).length > 0) {
-            minShift = util.min(Object.keys(maybeShift[v])
-                                 .map(function(u) {
-                                      return maybeShift[v][u] + (u in shift ? shift[u] : 0);
-                                      }
-                                 ));
-          }
-          shift[v] = minShift;
-        }
-      });
-    });
-
-    layering.forEach(function(layer) {
-      layer.forEach(function(v) {
-        xs[v] += shift[sink[root[v]]] || 0;
-      });
-    });
-
-    return xs;
-  }
-
-  function findMinCoord(g, layering, xs) {
-    return util.min(layering.map(function(layer) {
-      var u = layer[0];
-      return xs[u];
-    }));
-  }
-
-  function findMaxCoord(g, layering, xs) {
-    return util.max(layering.map(function(layer) {
-      var u = layer[layer.length - 1];
-      return xs[u];
-    }));
-  }
-
-  function balance(g, layering, xss) {
-    var min = {},                            // Min coordinate for the alignment
-        max = {},                            // Max coordinate for the alginment
-        smallestAlignment,
-        shift = {};                          // Amount to shift a given alignment
-
-    function updateAlignment(v) {
-      xss[alignment][v] += shift[alignment];
-    }
-
-    var smallest = Number.POSITIVE_INFINITY;
-    for (var alignment in xss) {
-      var xs = xss[alignment];
-      min[alignment] = findMinCoord(g, layering, xs);
-      max[alignment] = findMaxCoord(g, layering, xs);
-      var w = max[alignment] - min[alignment];
-      if (w < smallest) {
-        smallest = w;
-        smallestAlignment = alignment;
-      }
-    }
-
-    // Determine how much to adjust positioning for each alignment
-    ['u', 'd'].forEach(function(vertDir) {
-      ['l', 'r'].forEach(function(horizDir) {
-        var alignment = vertDir + horizDir;
-        shift[alignment] = horizDir === 'l'
-            ? min[smallestAlignment] - min[alignment]
-            : max[smallestAlignment] - max[alignment];
-      });
-    });
-
-    // Find average of medians for xss array
-    for (alignment in xss) {
-      g.eachNode(updateAlignment);
-    }
-  }
-
-  function flipHorizontally(xs) {
-    for (var u in xs) {
-      xs[u] = -xs[u];
-    }
-  }
-
-  function reverseInnerOrder(layering) {
-    layering.forEach(function(layer) {
-      layer.reverse();
-    });
-  }
-
-  function width(g, u) {
-    switch (g.graph().rankDir) {
-      case 'LR': return g.node(u).height;
-      case 'RL': return g.node(u).height;
-      default:   return g.node(u).width;
-    }
-  }
-
-  function height(g, u) {
-    switch(g.graph().rankDir) {
-      case 'LR': return g.node(u).width;
-      case 'RL': return g.node(u).width;
-      default:   return g.node(u).height;
-    }
-  }
-
-  function sep(g, u) {
-    if (config.universalSep !== null) {
-      return config.universalSep;
-    }
-    var w = width(g, u);
-    var s = g.node(u).dummy ? config.edgeSep : config.nodeSep;
-    return (w + s) / 2;
-  }
-
-  function posX(g, u, x) {
-    if (g.graph().rankDir === 'LR' || g.graph().rankDir === 'RL') {
-      if (arguments.length < 3) {
-        return g.node(u).y;
-      } else {
-        g.node(u).y = x;
-      }
-    } else {
-      if (arguments.length < 3) {
-        return g.node(u).x;
-      } else {
-        g.node(u).x = x;
-      }
-    }
-  }
-
-  function posXDebug(name, g, u, x) {
-    if (g.graph().rankDir === 'LR' || g.graph().rankDir === 'RL') {
-      if (arguments.length < 3) {
-        return g.node(u)[name];
-      } else {
-        g.node(u)[name] = x;
-      }
-    } else {
-      if (arguments.length < 3) {
-        return g.node(u)[name];
-      } else {
-        g.node(u)[name] = x;
-      }
-    }
-  }
-
-  function posY(g, u, y) {
-    if (g.graph().rankDir === 'LR' || g.graph().rankDir === 'RL') {
-      if (arguments.length < 3) {
-        return g.node(u).x;
-      } else {
-        g.node(u).x = y;
-      }
-    } else {
-      if (arguments.length < 3) {
-        return g.node(u).y;
-      } else {
-        g.node(u).y = y;
-      }
-    }
-  }
-
-  function debugPositioning(align, g, layering, xs) {
-    layering.forEach(function(l, li) {
-      var u, xU;
-      l.forEach(function(v) {
-        var xV = xs[v];
-        if (u) {
-          var s = sep(g, u) + sep(g, v);
-          if (xV - xU < s)
-            console.log('Position phase: sep violation. Align: ' + align + '. Layer: ' + li + '. ' +
-              'U: ' + u + ' V: ' + v + '. Actual sep: ' + (xV - xU) + ' Expected sep: ' + s);
-        }
-        u = v;
-        xU = xV;
-      });
-    });
-  }
-};
-
-},{"./util":27}],20:[function(require,module,exports){
-'use strict';
-
-var util = require('./util'),
-    acyclic = require('./rank/acyclic'),
-    initRank = require('./rank/initRank'),
-    feasibleTree = require('./rank/feasibleTree'),
-    constraints = require('./rank/constraints'),
-    simplex = require('./rank/simplex'),
-    components = require('graphlib').alg.components,
-    filter = require('graphlib').filter;
-
-exports.run = run;
-exports.restoreEdges = restoreEdges;
-
-/*
- * Heuristic function that assigns a rank to each node of the input graph with
- * the intent of minimizing edge lengths, while respecting the `minLen`
- * attribute of incident edges.
- *
- * Prerequisites:
- *
- *  * Each edge in the input graph must have an assigned 'minLen' attribute
- */
-function run(g, useSimplex) {
-  expandSelfLoops(g);
-
-  // If there are rank constraints on nodes, then build a new graph that
-  // encodes the constraints.
-  util.time('constraints.apply', constraints.apply)(g);
-
-  expandSidewaysEdges(g);
-
-  // Reverse edges to get an acyclic graph, we keep the graph in an acyclic
-  // state until the very end.
-  util.time('acyclic', acyclic)(g);
-
-  // Convert the graph into a flat graph for ranking
-  var flatGraph = g.filterNodes(util.filterNonSubgraphs(g));
-
-  // Assign an initial ranking using DFS.
-  initRank(flatGraph);
-
-  // For each component improve the assigned ranks.
-  components(flatGraph).forEach(function(cmpt) {
-    var subgraph = flatGraph.filterNodes(filter.nodesFromList(cmpt));
-    rankComponent(subgraph, useSimplex);
-  });
-
-  // Relax original constraints
-  util.time('constraints.relax', constraints.relax(g));
-
-  // When handling nodes with constrained ranks it is possible to end up with
-  // edges that point to previous ranks. Most of the subsequent algorithms assume
-  // that edges are pointing to successive ranks only. Here we reverse any "back
-  // edges" and mark them as such. The acyclic algorithm will reverse them as a
-  // post processing step.
-  util.time('reorientEdges', reorientEdges)(g);
-}
-
-function restoreEdges(g) {
-  acyclic.undo(g);
-}
-
-/*
- * Expand self loops into three dummy nodes. One will sit above the incident
- * node, one will be at the same level, and one below. The result looks like:
- *
- *         /--<--x--->--\
- *     node              y
- *         \--<--z--->--/
- *
- * Dummy nodes x, y, z give us the shape of a loop and node y is where we place
- * the label.
- *
- * TODO: consolidate knowledge of dummy node construction.
- * TODO: support minLen = 2
- */
-function expandSelfLoops(g) {
-  g.eachEdge(function(e, u, v, a) {
-    if (u === v) {
-      var x = addDummyNode(g, e, u, v, a, 0, false),
-          y = addDummyNode(g, e, u, v, a, 1, true),
-          z = addDummyNode(g, e, u, v, a, 2, false);
-      g.addEdge(null, x, u, {minLen: 1, selfLoop: true});
-      g.addEdge(null, x, y, {minLen: 1, selfLoop: true});
-      g.addEdge(null, u, z, {minLen: 1, selfLoop: true});
-      g.addEdge(null, y, z, {minLen: 1, selfLoop: true});
-      g.delEdge(e);
-    }
-  });
-}
-
-function expandSidewaysEdges(g) {
-  g.eachEdge(function(e, u, v, a) {
-    if (u === v) {
-      var origEdge = a.originalEdge,
-          dummy = addDummyNode(g, origEdge.e, origEdge.u, origEdge.v, origEdge.value, 0, true);
-      g.addEdge(null, u, dummy, {minLen: 1});
-      g.addEdge(null, dummy, v, {minLen: 1});
-      g.delEdge(e);
-    }
-  });
-}
-
-function addDummyNode(g, e, u, v, a, index, isLabel) {
-  return g.addNode(null, {
-    width: isLabel ? a.width : 0,
-    height: isLabel ? a.height : 0,
-    edge: { id: e, source: u, target: v, attrs: a },
-    dummy: true,
-    index: index
-  });
-}
-
-function reorientEdges(g) {
-  g.eachEdge(function(e, u, v, value) {
-    if (g.node(u).rank > g.node(v).rank) {
-      g.delEdge(e);
-      value.reversed = true;
-      g.addEdge(e, v, u, value);
-    }
-  });
-}
-
-function rankComponent(subgraph, useSimplex) {
-  var spanningTree = feasibleTree(subgraph);
-
-  if (useSimplex) {
-    util.log(1, 'Using network simplex for ranking');
-    simplex(subgraph, spanningTree);
-  }
-  normalize(subgraph);
-}
-
-function normalize(g) {
-  var m = util.min(g.nodes().map(function(u) { return g.node(u).rank; }));
-  g.eachNode(function(u, node) { node.rank -= m; });
-}
-
-},{"./rank/acyclic":21,"./rank/constraints":22,"./rank/feasibleTree":23,"./rank/initRank":24,"./rank/simplex":26,"./util":27,"graphlib":29}],21:[function(require,module,exports){
-'use strict';
-
-var util = require('../util');
-
-module.exports = acyclic;
-module.exports.undo = undo;
-
-/*
- * This function takes a directed graph that may have cycles and reverses edges
- * as appropriate to break these cycles. Each reversed edge is assigned a
- * `reversed` attribute with the value `true`.
- *
- * There should be no self loops in the graph.
- */
-function acyclic(g) {
-  var onStack = {},
-      visited = {},
-      reverseCount = 0;
-
-  function dfs(u) {
-    if (u in visited) return;
-    visited[u] = onStack[u] = true;
-    g.outEdges(u).forEach(function(e) {
-      var t = g.target(e),
-          value;
-
-      if (u === t) {
-        console.error('Warning: found self loop "' + e + '" for node "' + u + '"');
-      } else if (t in onStack) {
-        value = g.edge(e);
-        g.delEdge(e);
-        value.reversed = true;
-        ++reverseCount;
-        g.addEdge(e, t, u, value);
-      } else {
-        dfs(t);
-      }
-    });
-
-    delete onStack[u];
-  }
-
-  g.eachNode(function(u) { dfs(u); });
-
-  util.log(2, 'Acyclic Phase: reversed ' + reverseCount + ' edge(s)');
-
-  return reverseCount;
-}
-
-/*
- * Given a graph that has had the acyclic operation applied, this function
- * undoes that operation. More specifically, any edge with the `reversed`
- * attribute is again reversed to restore the original direction of the edge.
- */
-function undo(g) {
-  g.eachEdge(function(e, s, t, a) {
-    if (a.reversed) {
-      delete a.reversed;
-      g.delEdge(e);
-      g.addEdge(e, t, s, a);
-    }
-  });
-}
-
-},{"../util":27}],22:[function(require,module,exports){
-'use strict';
-
-exports.apply = function(g) {
-  function dfs(sg) {
-    var rankSets = {};
-    g.children(sg).forEach(function(u) {
-      if (g.children(u).length) {
-        dfs(u);
-        return;
-      }
-
-      var value = g.node(u),
-          prefRank = value.prefRank;
-      if (prefRank !== undefined) {
-        if (!checkSupportedPrefRank(prefRank)) { return; }
-
-        if (!(prefRank in rankSets)) {
-          rankSets.prefRank = [u];
-        } else {
-          rankSets.prefRank.push(u);
-        }
-
-        var newU = rankSets[prefRank];
-        if (newU === undefined) {
-          newU = rankSets[prefRank] = g.addNode(null, { originalNodes: [] });
-          g.parent(newU, sg);
-        }
-
-        redirectInEdges(g, u, newU, prefRank === 'min');
-        redirectOutEdges(g, u, newU, prefRank === 'max');
-
-        // Save original node and remove it from reduced graph
-        g.node(newU).originalNodes.push({ u: u, value: value, parent: sg });
-        g.delNode(u);
-      }
-    });
-
-    addLightEdgesFromMinNode(g, sg, rankSets.min);
-    addLightEdgesToMaxNode(g, sg, rankSets.max);
-  }
-
-  dfs(null);
-};
-
-function checkSupportedPrefRank(prefRank) {
-  if (prefRank !== 'min' && prefRank !== 'max' && prefRank.indexOf('same_') !== 0) {
-    console.error('Unsupported rank type: ' + prefRank);
-    return false;
-  }
-  return true;
-}
-
-function redirectInEdges(g, u, newU, reverse) {
-  g.inEdges(u).forEach(function(e) {
-    var origValue = g.edge(e),
-        value;
-    if (origValue.originalEdge) {
-      value = origValue;
-    } else {
-      value =  {
-        originalEdge: { e: e, u: g.source(e), v: g.target(e), value: origValue },
-        minLen: g.edge(e).minLen
-      };
-    }
-
-    // Do not reverse edges for self-loops.
-    if (origValue.selfLoop) {
-      reverse = false;
-    }
-
-    if (reverse) {
-      // Ensure that all edges to min are reversed
-      g.addEdge(null, newU, g.source(e), value);
-      value.reversed = true;
-    } else {
-      g.addEdge(null, g.source(e), newU, value);
-    }
-  });
-}
-
-function redirectOutEdges(g, u, newU, reverse) {
-  g.outEdges(u).forEach(function(e) {
-    var origValue = g.edge(e),
-        value;
-    if (origValue.originalEdge) {
-      value = origValue;
-    } else {
-      value =  {
-        originalEdge: { e: e, u: g.source(e), v: g.target(e), value: origValue },
-        minLen: g.edge(e).minLen
-      };
-    }
-
-    // Do not reverse edges for self-loops.
-    if (origValue.selfLoop) {
-      reverse = false;
-    }
-
-    if (reverse) {
-      // Ensure that all edges from max are reversed
-      g.addEdge(null, g.target(e), newU, value);
-      value.reversed = true;
-    } else {
-      g.addEdge(null, newU, g.target(e), value);
-    }
-  });
-}
-
-function addLightEdgesFromMinNode(g, sg, minNode) {
-  if (minNode !== undefined) {
-    g.children(sg).forEach(function(u) {
-      // The dummy check ensures we don't add an edge if the node is involved
-      // in a self loop or sideways edge.
-      if (u !== minNode && !g.outEdges(minNode, u).length && !g.node(u).dummy) {
-        g.addEdge(null, minNode, u, { minLen: 0 });
-      }
-    });
-  }
-}
-
-function addLightEdgesToMaxNode(g, sg, maxNode) {
-  if (maxNode !== undefined) {
-    g.children(sg).forEach(function(u) {
-      // The dummy check ensures we don't add an edge if the node is involved
-      // in a self loop or sideways edge.
-      if (u !== maxNode && !g.outEdges(u, maxNode).length && !g.node(u).dummy) {
-        g.addEdge(null, u, maxNode, { minLen: 0 });
-      }
-    });
-  }
-}
-
-/*
- * This function "relaxes" the constraints applied previously by the "apply"
- * function. It expands any nodes that were collapsed and assigns the rank of
- * the collapsed node to each of the expanded nodes. It also restores the
- * original edges and removes any dummy edges pointing at the collapsed nodes.
- *
- * Note that the process of removing collapsed nodes also removes dummy edges
- * automatically.
- */
-exports.relax = function(g) {
-  // Save original edges
-  var originalEdges = [];
-  g.eachEdge(function(e, u, v, value) {
-    var originalEdge = value.originalEdge;
-    if (originalEdge) {
-      originalEdges.push(originalEdge);
-    }
-  });
-
-  // Expand collapsed nodes
-  g.eachNode(function(u, value) {
-    var originalNodes = value.originalNodes;
-    if (originalNodes) {
-      originalNodes.forEach(function(originalNode) {
-        originalNode.value.rank = value.rank;
-        g.addNode(originalNode.u, originalNode.value);
-        g.parent(originalNode.u, originalNode.parent);
-      });
-      g.delNode(u);
-    }
-  });
-
-  // Restore original edges
-  originalEdges.forEach(function(edge) {
-    g.addEdge(edge.e, edge.u, edge.v, edge.value);
-  });
-};
-
-},{}],23:[function(require,module,exports){
-'use strict';
-
-/* jshint -W079 */
-var Set = require('cp-data').Set,
-/* jshint +W079 */
-    Digraph = require('graphlib').Digraph,
-    util = require('../util');
-
-module.exports = feasibleTree;
-
-/*
- * Given an acyclic graph with each node assigned a `rank` attribute, this
- * function constructs and returns a spanning tree. This function may reduce
- * the length of some edges from the initial rank assignment while maintaining
- * the `minLen` specified by each edge.
- *
- * Prerequisites:
- *
- * * The input graph is acyclic
- * * Each node in the input graph has an assigned `rank` attribute
- * * Each edge in the input graph has an assigned `minLen` attribute
- *
- * Outputs:
- *
- * A feasible spanning tree for the input graph (i.e. a spanning tree that
- * respects each graph edge's `minLen` attribute) represented as a Digraph with
- * a `root` attribute on graph.
- *
- * Nodes have the same id and value as that in the input graph.
- *
- * Edges in the tree have arbitrarily assigned ids. The attributes for edges
- * include `reversed`. `reversed` indicates that the edge is a
- * back edge in the input graph.
- */
-function feasibleTree(g) {
-  var remaining = new Set(g.nodes()),
-      tree = new Digraph();
-
-  if (remaining.size() === 1) {
-    var root = g.nodes()[0];
-    tree.addNode(root, {});
-    tree.graph({ root: root });
-    return tree;
-  }
-
-  function addTightEdges(v) {
-    var continueToScan = true;
-    g.predecessors(v).forEach(function(u) {
-      if (remaining.has(u) && !slack(g, u, v)) {
-        if (remaining.has(v)) {
-          tree.addNode(v, {});
-          remaining.remove(v);
-          tree.graph({ root: v });
-        }
-
-        tree.addNode(u, {});
-        tree.addEdge(null, u, v, { reversed: true });
-        remaining.remove(u);
-        addTightEdges(u);
-        continueToScan = false;
-      }
-    });
-
-    g.successors(v).forEach(function(w)  {
-      if (remaining.has(w) && !slack(g, v, w)) {
-        if (remaining.has(v)) {
-          tree.addNode(v, {});
-          remaining.remove(v);
-          tree.graph({ root: v });
-        }
-
-        tree.addNode(w, {});
-        tree.addEdge(null, v, w, {});
-        remaining.remove(w);
-        addTightEdges(w);
-        continueToScan = false;
-      }
-    });
-    return continueToScan;
-  }
-
-  function createTightEdge() {
-    var minSlack = Number.MAX_VALUE;
-    remaining.keys().forEach(function(v) {
-      g.predecessors(v).forEach(function(u) {
-        if (!remaining.has(u)) {
-          var edgeSlack = slack(g, u, v);
-          if (Math.abs(edgeSlack) < Math.abs(minSlack)) {
-            minSlack = -edgeSlack;
-          }
-        }
-      });
-
-      g.successors(v).forEach(function(w) {
-        if (!remaining.has(w)) {
-          var edgeSlack = slack(g, v, w);
-          if (Math.abs(edgeSlack) < Math.abs(minSlack)) {
-            minSlack = edgeSlack;
-          }
-        }
-      });
-    });
-
-    tree.eachNode(function(u) { g.node(u).rank -= minSlack; });
-  }
-
-  while (remaining.size()) {
-    var nodesToSearch = !tree.order() ? remaining.keys() : tree.nodes();
-    for (var i = 0, il = nodesToSearch.length;
-         i < il && addTightEdges(nodesToSearch[i]);
-         ++i);
-    if (remaining.size()) {
-      createTightEdge();
-    }
-  }
-
-  return tree;
-}
-
-function slack(g, u, v) {
-  var rankDiff = g.node(v).rank - g.node(u).rank;
-  var maxMinLen = util.max(g.outEdges(u, v)
-                            .map(function(e) { return g.edge(e).minLen; }));
-  return rankDiff - maxMinLen;
-}
-
-},{"../util":27,"cp-data":5,"graphlib":29}],24:[function(require,module,exports){
-'use strict';
-
-var util = require('../util'),
-    topsort = require('graphlib').alg.topsort;
-
-module.exports = initRank;
-
-/*
- * Assigns a `rank` attribute to each node in the input graph and ensures that
- * this rank respects the `minLen` attribute of incident edges.
- *
- * Prerequisites:
- *
- *  * The input graph must be acyclic
- *  * Each edge in the input graph must have an assigned 'minLen' attribute
- */
-function initRank(g) {
-  var sorted = topsort(g);
-
-  sorted.forEach(function(u) {
-    var inEdges = g.inEdges(u);
-    if (inEdges.length === 0) {
-      g.node(u).rank = 0;
-      return;
-    }
-
-    var minLens = inEdges.map(function(e) {
-      return g.node(g.source(e)).rank + g.edge(e).minLen;
-    });
-    g.node(u).rank = util.max(minLens);
-  });
-}
-
-},{"../util":27,"graphlib":29}],25:[function(require,module,exports){
-'use strict';
-
-module.exports = {
-  slack: slack
-};
-
-/*
- * A helper to calculate the slack between two nodes (`u` and `v`) given a
- * `minLen` constraint. The slack represents how much the distance between `u`
- * and `v` could shrink while maintaining the `minLen` constraint. If the value
- * is negative then the constraint is currently violated.
- *
-  This function requires that `u` and `v` are in `graph` and they both have a
-  `rank` attribute.
- */
-function slack(graph, u, v, minLen) {
-  return Math.abs(graph.node(u).rank - graph.node(v).rank) - minLen;
-}
-
-},{}],26:[function(require,module,exports){
-'use strict';
-
-var util = require('../util'),
-    rankUtil = require('./rankUtil');
-
-module.exports = simplex;
-
-function simplex(graph, spanningTree) {
-  // The network simplex algorithm repeatedly replaces edges of
-  // the spanning tree with negative cut values until no such
-  // edge exists.
-  initCutValues(graph, spanningTree);
-  while (true) {
-    var e = leaveEdge(spanningTree);
-    if (e === null) break;
-    var f = enterEdge(graph, spanningTree, e);
-    exchange(graph, spanningTree, e, f);
-  }
-}
-
-/*
- * Set the cut values of edges in the spanning tree by a depth-first
- * postorder traversal.  The cut value corresponds to the cost, in
- * terms of a ranking's edge length sum, of lengthening an edge.
- * Negative cut values typically indicate edges that would yield a
- * smaller edge length sum if they were lengthened.
- */
-function initCutValues(graph, spanningTree) {
-  computeLowLim(spanningTree);
-
-  spanningTree.eachEdge(function(id, u, v, treeValue) {
-    treeValue.cutValue = 0;
-  });
-
-  // Propagate cut values up the tree.
-  function dfs(n) {
-    var children = spanningTree.successors(n);
-    for (var c in children) {
-      var child = children[c];
-      dfs(child);
-    }
-    if (n !== spanningTree.graph().root) {
-      setCutValue(graph, spanningTree, n);
-    }
-  }
-  dfs(spanningTree.graph().root);
-}
-
-/*
- * Perform a DFS postorder traversal, labeling each node v with
- * its traversal order 'lim(v)' and the minimum traversal number
- * of any of its descendants 'low(v)'.  This provides an efficient
- * way to test whether u is an ancestor of v since
- * low(u) <= lim(v) <= lim(u) if and only if u is an ancestor.
- */
-function computeLowLim(tree) {
-  var postOrderNum = 0;
-
-  function dfs(n) {
-    var children = tree.successors(n);
-    var low = postOrderNum;
-    for (var c in children) {
-      var child = children[c];
-      dfs(child);
-      low = Math.min(low, tree.node(child).low);
-    }
-    tree.node(n).low = low;
-    tree.node(n).lim = postOrderNum++;
-  }
-
-  dfs(tree.graph().root);
-}
-
-/*
- * To compute the cut value of the edge parent -> child, we consider
- * it and any other graph edges to or from the child.
- *          parent
- *             |
- *           child
- *          /      \
- *         u        v
- */
-function setCutValue(graph, tree, child) {
-  var parentEdge = tree.inEdges(child)[0];
-
-  // List of child's children in the spanning tree.
-  var grandchildren = [];
-  var grandchildEdges = tree.outEdges(child);
-  for (var gce in grandchildEdges) {
-    grandchildren.push(tree.target(grandchildEdges[gce]));
-  }
-
-  var cutValue = 0;
-
-  // TODO: Replace unit increment/decrement with edge weights.
-  var E = 0;    // Edges from child to grandchild's subtree.
-  var F = 0;    // Edges to child from grandchild's subtree.
-  var G = 0;    // Edges from child to nodes outside of child's subtree.
-  var H = 0;    // Edges from nodes outside of child's subtree to child.
-
-  // Consider all graph edges from child.
-  var outEdges = graph.outEdges(child);
-  var gc;
-  for (var oe in outEdges) {
-    var succ = graph.target(outEdges[oe]);
-    for (gc in grandchildren) {
-      if (inSubtree(tree, succ, grandchildren[gc])) {
-        E++;
-      }
-    }
-    if (!inSubtree(tree, succ, child)) {
-      G++;
-    }
-  }
-
-  // Consider all graph edges to child.
-  var inEdges = graph.inEdges(child);
-  for (var ie in inEdges) {
-    var pred = graph.source(inEdges[ie]);
-    for (gc in grandchildren) {
-      if (inSubtree(tree, pred, grandchildren[gc])) {
-        F++;
-      }
-    }
-    if (!inSubtree(tree, pred, child)) {
-      H++;
-    }
-  }
-
-  // Contributions depend on the alignment of the parent -> child edge
-  // and the child -> u or v edges.
-  var grandchildCutSum = 0;
-  for (gc in grandchildren) {
-    var cv = tree.edge(grandchildEdges[gc]).cutValue;
-    if (!tree.edge(grandchildEdges[gc]).reversed) {
-      grandchildCutSum += cv;
-    } else {
-      grandchildCutSum -= cv;
-    }
-  }
-
-  if (!tree.edge(parentEdge).reversed) {
-    cutValue += grandchildCutSum - E + F - G + H;
-  } else {
-    cutValue -= grandchildCutSum - E + F - G + H;
-  }
-
-  tree.edge(parentEdge).cutValue = cutValue;
-}
-
-/*
- * Return whether n is a node in the subtree with the given
- * root.
- */
-function inSubtree(tree, n, root) {
-  return (tree.node(root).low <= tree.node(n).lim &&
-          tree.node(n).lim <= tree.node(root).lim);
-}
-
-/*
- * Return an edge from the tree with a negative cut value, or null if there
- * is none.
- */
-function leaveEdge(tree) {
-  var edges = tree.edges();
-  for (var n in edges) {
-    var e = edges[n];
-    var treeValue = tree.edge(e);
-    if (treeValue.cutValue < 0) {
-      return e;
-    }
-  }
-  return null;
-}
-
-/*
- * The edge e should be an edge in the tree, with an underlying edge
- * in the graph, with a negative cut value.  Of the two nodes incident
- * on the edge, take the lower one.  enterEdge returns an edge with
- * minimum slack going from outside of that node's subtree to inside
- * of that node's subtree.
- */
-function enterEdge(graph, tree, e) {
-  var source = tree.source(e);
-  var target = tree.target(e);
-  var lower = tree.node(target).lim < tree.node(source).lim ? target : source;
-
-  // Is the tree edge aligned with the graph edge?
-  var aligned = !tree.edge(e).reversed;
-
-  var minSlack = Number.POSITIVE_INFINITY;
-  var minSlackEdge;
-  if (aligned) {
-    graph.eachEdge(function(id, u, v, value) {
-      if (id !== e && inSubtree(tree, u, lower) && !inSubtree(tree, v, lower)) {
-        var slack = rankUtil.slack(graph, u, v, value.minLen);
-        if (slack < minSlack) {
-          minSlack = slack;
-          minSlackEdge = id;
-        }
-      }
-    });
-  } else {
-    graph.eachEdge(function(id, u, v, value) {
-      if (id !== e && !inSubtree(tree, u, lower) && inSubtree(tree, v, lower)) {
-        var slack = rankUtil.slack(graph, u, v, value.minLen);
-        if (slack < minSlack) {
-          minSlack = slack;
-          minSlackEdge = id;
-        }
-      }
-    });
-  }
-
-  if (minSlackEdge === undefined) {
-    var outside = [];
-    var inside = [];
-    graph.eachNode(function(id) {
-      if (!inSubtree(tree, id, lower)) {
-        outside.push(id);
-      } else {
-        inside.push(id);
-      }
-    });
-    throw new Error('No edge found from outside of tree to inside');
-  }
-
-  return minSlackEdge;
-}
-
-/*
- * Replace edge e with edge f in the tree, recalculating the tree root,
- * the nodes' low and lim properties and the edges' cut values.
- */
-function exchange(graph, tree, e, f) {
-  tree.delEdge(e);
-  var source = graph.source(f);
-  var target = graph.target(f);
-
-  // Redirect edges so that target is the root of its subtree.
-  function redirect(v) {
-    var edges = tree.inEdges(v);
-    for (var i in edges) {
-      var e = edges[i];
-      var u = tree.source(e);
-      var value = tree.edge(e);
-      redirect(u);
-      tree.delEdge(e);
-      value.reversed = !value.reversed;
-      tree.addEdge(e, v, u, value);
-    }
-  }
-
-  redirect(target);
-
-  var root = source;
-  var edges = tree.inEdges(root);
-  while (edges.length > 0) {
-    root = tree.source(edges[0]);
-    edges = tree.inEdges(root);
-  }
-
-  tree.graph().root = root;
-
-  tree.addEdge(null, source, target, {cutValue: 0});
-
-  initCutValues(graph, tree);
-
-  adjustRanks(graph, tree);
-}
-
-/*
- * Reset the ranks of all nodes based on the current spanning tree.
- * The rank of the tree's root remains unchanged, while all other
- * nodes are set to the sum of minimum length constraints along
- * the path from the root.
- */
-function adjustRanks(graph, tree) {
-  function dfs(p) {
-    var children = tree.successors(p);
-    children.forEach(function(c) {
-      var minLen = minimumLength(graph, p, c);
-      graph.node(c).rank = graph.node(p).rank + minLen;
-      dfs(c);
-    });
-  }
-
-  dfs(tree.graph().root);
-}
-
-/*
- * If u and v are connected by some edges in the graph, return the
- * minimum length of those edges, as a positive number if v succeeds
- * u and as a negative number if v precedes u.
- */
-function minimumLength(graph, u, v) {
-  var outEdges = graph.outEdges(u, v);
-  if (outEdges.length > 0) {
-    return util.max(outEdges.map(function(e) {
-      return graph.edge(e).minLen;
-    }));
-  }
-
-  var inEdges = graph.inEdges(u, v);
-  if (inEdges.length > 0) {
-    return -util.max(inEdges.map(function(e) {
-      return graph.edge(e).minLen;
-    }));
-  }
-}
-
-},{"../util":27,"./rankUtil":25}],27:[function(require,module,exports){
-'use strict';
-
-/*
- * Returns the smallest value in the array.
- */
-exports.min = function(values) {
-  return Math.min.apply(Math, values);
-};
-
-/*
- * Returns the largest value in the array.
- */
-exports.max = function(values) {
-  return Math.max.apply(Math, values);
-};
-
-/*
- * Returns `true` only if `f(x)` is `true` for all `x` in `xs`. Otherwise
- * returns `false`. This function will return immediately if it finds a
- * case where `f(x)` does not hold.
- */
-exports.all = function(xs, f) {
-  for (var i = 0; i < xs.length; ++i) {
-    if (!f(xs[i])) {
-      return false;
-    }
-  }
-  return true;
-};
-
-/*
- * Accumulates the sum of elements in the given array using the `+` operator.
- */
-exports.sum = function(values) {
-  return values.reduce(function(acc, x) { return acc + x; }, 0);
-};
-
-/*
- * Returns an array of all values in the given object.
- */
-exports.values = function(obj) {
-  return Object.keys(obj).map(function(k) { return obj[k]; });
-};
-
-exports.shuffle = function(array) {
-  for (var i = array.length - 1; i > 0; --i) {
-    var j = Math.floor(Math.random() * (i + 1));
-    var aj = array[j];
-    array[j] = array[i];
-    array[i] = aj;
-  }
-};
-
-exports.propertyAccessor = function(self, config, field, setHook) {
-  return function(x) {
-    if (!arguments.length) return config[field];
-    config[field] = x;
-    if (setHook) setHook(x);
-    return self;
-  };
-};
-
-/*
- * Given a layered, directed graph with `rank` and `order` node attributes,
- * this function returns an array of ordered ranks. Each rank contains an array
- * of the ids of the nodes in that rank in the order specified by the `order`
- * attribute.
- */
-exports.ordering = function(g) {
-  var ordering = [];
-  g.eachNode(function(u, value) {
-    var rank = ordering[value.rank] || (ordering[value.rank] = []);
-    rank[value.order] = u;
-  });
-  return ordering;
-};
-
-/*
- * A filter that can be used with `filterNodes` to get a graph that only
- * includes nodes that do not contain others nodes.
- */
-exports.filterNonSubgraphs = function(g) {
-  return function(u) {
-    return g.children(u).length === 0;
-  };
-};
-
-/*
- * Returns a new function that wraps `func` with a timer. The wrapper logs the
- * time it takes to execute the function.
- *
- * The timer will be enabled provided `log.level >= 1`.
- */
-function time(name, func) {
-  return function() {
-    var start = new Date().getTime();
-    try {
-      return func.apply(null, arguments);
-    } finally {
-      log(1, name + ' time: ' + (new Date().getTime() - start) + 'ms');
-    }
-  };
-}
-time.enabled = false;
-
-exports.time = time;
-
-/*
- * A global logger with the specification `log(level, message, ...)` that
- * will log a message to the console if `log.level >= level`.
- */
-function log(level) {
-  if (log.level >= level) {
-    console.log.apply(console, Array.prototype.slice.call(arguments, 1));
-  }
-}
-log.level = 0;
-
-exports.log = log;
-
-},{}],28:[function(require,module,exports){
-module.exports = '0.4.6';
-
-},{}],29:[function(require,module,exports){
-exports.Graph = require("./lib/Graph");
-exports.Digraph = require("./lib/Digraph");
-exports.CGraph = require("./lib/CGraph");
-exports.CDigraph = require("./lib/CDigraph");
-require("./lib/graph-converters");
-
-exports.alg = {
-  isAcyclic: require("./lib/alg/isAcyclic"),
-  components: require("./lib/alg/components"),
-  dijkstra: require("./lib/alg/dijkstra"),
-  dijkstraAll: require("./lib/alg/dijkstraAll"),
-  findCycles: require("./lib/alg/findCycles"),
-  floydWarshall: require("./lib/alg/floydWarshall"),
-  postorder: require("./lib/alg/postorder"),
-  preorder: require("./lib/alg/preorder"),
-  prim: require("./lib/alg/prim"),
-  tarjan: require("./lib/alg/tarjan"),
-  topsort: require("./lib/alg/topsort")
-};
-
-exports.converter = {
-  json: require("./lib/converter/json.js")
-};
-
-var filter = require("./lib/filter");
-exports.filter = {
-  all: filter.all,
-  nodesFromList: filter.nodesFromList
-};
-
-exports.version = require("./lib/version");
-
-},{"./lib/CDigraph":31,"./lib/CGraph":32,"./lib/Digraph":33,"./lib/Graph":34,"./lib/alg/components":35,"./lib/alg/dijkstra":36,"./lib/alg/dijkstraAll":37,"./lib/alg/findCycles":38,"./lib/alg/floydWarshall":39,"./lib/alg/isAcyclic":40,"./lib/alg/postorder":41,"./lib/alg/preorder":42,"./lib/alg/prim":43,"./lib/alg/tarjan":44,"./lib/alg/topsort":45,"./lib/converter/json.js":47,"./lib/filter":48,"./lib/graph-converters":49,"./lib/version":51}],30:[function(require,module,exports){
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = BaseGraph;
-
-function BaseGraph() {
-  // The value assigned to the graph itself.
-  this._value = undefined;
-
-  // Map of node id -> { id, value }
-  this._nodes = {};
-
-  // Map of edge id -> { id, u, v, value }
-  this._edges = {};
-
-  // Used to generate a unique id in the graph
-  this._nextId = 0;
-}
-
-// Number of nodes
-BaseGraph.prototype.order = function() {
-  return Object.keys(this._nodes).length;
-};
-
-// Number of edges
-BaseGraph.prototype.size = function() {
-  return Object.keys(this._edges).length;
-};
-
-// Accessor for graph level value
-BaseGraph.prototype.graph = function(value) {
-  if (arguments.length === 0) {
-    return this._value;
-  }
-  this._value = value;
-};
-
-BaseGraph.prototype.hasNode = function(u) {
-  return u in this._nodes;
-};
-
-BaseGraph.prototype.node = function(u, value) {
-  var node = this._strictGetNode(u);
-  if (arguments.length === 1) {
-    return node.value;
-  }
-  node.value = value;
-};
-
-BaseGraph.prototype.nodes = function() {
-  var nodes = [];
-  this.eachNode(function(id) { nodes.push(id); });
-  return nodes;
-};
-
-BaseGraph.prototype.eachNode = function(func) {
-  for (var k in this._nodes) {
-    var node = this._nodes[k];
-    func(node.id, node.value);
-  }
-};
-
-BaseGraph.prototype.hasEdge = function(e) {
-  return e in this._edges;
-};
-
-BaseGraph.prototype.edge = function(e, value) {
-  var edge = this._strictGetEdge(e);
-  if (arguments.length === 1) {
-    return edge.value;
-  }
-  edge.value = value;
-};
-
-BaseGraph.prototype.edges = function() {
-  var es = [];
-  this.eachEdge(function(id) { es.push(id); });
-  return es;
-};
-
-BaseGraph.prototype.eachEdge = function(func) {
-  for (var k in this._edges) {
-    var edge = this._edges[k];
-    func(edge.id, edge.u, edge.v, edge.value);
-  }
-};
-
-BaseGraph.prototype.incidentNodes = function(e) {
-  var edge = this._strictGetEdge(e);
-  return [edge.u, edge.v];
-};
-
-BaseGraph.prototype.addNode = function(u, value) {
-  if (u === undefined || u === null) {
-    do {
-      u = "_" + (++this._nextId);
-    } while (this.hasNode(u));
-  } else if (this.hasNode(u)) {
-    throw new Error("Graph already has node '" + u + "'");
-  }
-  this._nodes[u] = { id: u, value: value };
-  return u;
-};
-
-BaseGraph.prototype.delNode = function(u) {
-  this._strictGetNode(u);
-  this.incidentEdges(u).forEach(function(e) { this.delEdge(e); }, this);
-  delete this._nodes[u];
-};
-
-// inMap and outMap are opposite sides of an incidence map. For example, for
-// Graph these would both come from the _incidentEdges map, while for Digraph
-// they would come from _inEdges and _outEdges.
-BaseGraph.prototype._addEdge = function(e, u, v, value, inMap, outMap) {
-  this._strictGetNode(u);
-  this._strictGetNode(v);
-
-  if (e === undefined || e === null) {
-    do {
-      e = "_" + (++this._nextId);
-    } while (this.hasEdge(e));
-  }
-  else if (this.hasEdge(e)) {
-    throw new Error("Graph already has edge '" + e + "'");
-  }
-
-  this._edges[e] = { id: e, u: u, v: v, value: value };
-  addEdgeToMap(inMap[v], u, e);
-  addEdgeToMap(outMap[u], v, e);
-
-  return e;
-};
-
-// See note for _addEdge regarding inMap and outMap.
-BaseGraph.prototype._delEdge = function(e, inMap, outMap) {
-  var edge = this._strictGetEdge(e);
-  delEdgeFromMap(inMap[edge.v], edge.u, e);
-  delEdgeFromMap(outMap[edge.u], edge.v, e);
-  delete this._edges[e];
-};
-
-BaseGraph.prototype.copy = function() {
-  var copy = new this.constructor();
-  copy.graph(this.graph());
-  this.eachNode(function(u, value) { copy.addNode(u, value); });
-  this.eachEdge(function(e, u, v, value) { copy.addEdge(e, u, v, value); });
-  copy._nextId = this._nextId;
-  return copy;
-};
-
-BaseGraph.prototype.filterNodes = function(filter) {
-  var copy = new this.constructor();
-  copy.graph(this.graph());
-  this.eachNode(function(u, value) {
-    if (filter(u)) {
-      copy.addNode(u, value);
-    }
-  });
-  this.eachEdge(function(e, u, v, value) {
-    if (copy.hasNode(u) && copy.hasNode(v)) {
-      copy.addEdge(e, u, v, value);
-    }
-  });
-  return copy;
-};
-
-BaseGraph.prototype._strictGetNode = function(u) {
-  var node = this._nodes[u];
-  if (node === undefined) {
-    throw new Error("Node '" + u + "' is not in graph");
-  }
-  return node;
-};
-
-BaseGraph.prototype._strictGetEdge = function(e) {
-  var edge = this._edges[e];
-  if (edge === undefined) {
-    throw new Error("Edge '" + e + "' is not in graph");
-  }
-  return edge;
-};
-
-function addEdgeToMap(map, v, e) {
-  (map[v] || (map[v] = new Set())).add(e);
-}
-
-function delEdgeFromMap(map, v, e) {
-  var vEntry = map[v];
-  vEntry.remove(e);
-  if (vEntry.size() === 0) {
-    delete map[v];
-  }
-}
-
-
-},{"cp-data":5}],31:[function(require,module,exports){
-var Digraph = require("./Digraph"),
-    compoundify = require("./compoundify");
-
-var CDigraph = compoundify(Digraph);
-
-module.exports = CDigraph;
-
-CDigraph.fromDigraph = function(src) {
-  var g = new CDigraph(),
-      graphValue = src.graph();
-
-  if (graphValue !== undefined) {
-    g.graph(graphValue);
-  }
-
-  src.eachNode(function(u, value) {
-    if (value === undefined) {
-      g.addNode(u);
-    } else {
-      g.addNode(u, value);
-    }
-  });
-  src.eachEdge(function(e, u, v, value) {
-    if (value === undefined) {
-      g.addEdge(null, u, v);
-    } else {
-      g.addEdge(null, u, v, value);
-    }
-  });
-  return g;
-};
-
-CDigraph.prototype.toString = function() {
-  return "CDigraph " + JSON.stringify(this, null, 2);
-};
-
-},{"./Digraph":33,"./compoundify":46}],32:[function(require,module,exports){
-var Graph = require("./Graph"),
-    compoundify = require("./compoundify");
-
-var CGraph = compoundify(Graph);
-
-module.exports = CGraph;
-
-CGraph.fromGraph = function(src) {
-  var g = new CGraph(),
-      graphValue = src.graph();
-
-  if (graphValue !== undefined) {
-    g.graph(graphValue);
-  }
-
-  src.eachNode(function(u, value) {
-    if (value === undefined) {
-      g.addNode(u);
-    } else {
-      g.addNode(u, value);
-    }
-  });
-  src.eachEdge(function(e, u, v, value) {
-    if (value === undefined) {
-      g.addEdge(null, u, v);
-    } else {
-      g.addEdge(null, u, v, value);
-    }
-  });
-  return g;
-};
-
-CGraph.prototype.toString = function() {
-  return "CGraph " + JSON.stringify(this, null, 2);
-};
-
-},{"./Graph":34,"./compoundify":46}],33:[function(require,module,exports){
-/*
- * This file is organized with in the following order:
- *
- * Exports
- * Graph constructors
- * Graph queries (e.g. nodes(), edges()
- * Graph mutators
- * Helper functions
- */
-
-var util = require("./util"),
-    BaseGraph = require("./BaseGraph"),
-/* jshint -W079 */
-    Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = Digraph;
-
-/*
- * Constructor to create a new directed multi-graph.
- */
-function Digraph() {
-  BaseGraph.call(this);
-
-  /*! Map of sourceId -> {targetId -> Set of edge ids} */
-  this._inEdges = {};
-
-  /*! Map of targetId -> {sourceId -> Set of edge ids} */
-  this._outEdges = {};
-}
-
-Digraph.prototype = new BaseGraph();
-Digraph.prototype.constructor = Digraph;
-
-/*
- * Always returns `true`.
- */
-Digraph.prototype.isDirected = function() {
-  return true;
-};
-
-/*
- * Returns all successors of the node with the id `u`. That is, all nodes
- * that have the node `u` as their source are returned.
- *
- * If no node `u` exists in the graph this function throws an Error.
- *
- * @param {String} u a node id
- */
-Digraph.prototype.successors = function(u) {
-  this._strictGetNode(u);
-  return Object.keys(this._outEdges[u])
-               .map(function(v) { return this._nodes[v].id; }, this);
-};
-
-/*
- * Returns all predecessors of the node with the id `u`. That is, all nodes
- * that have the node `u` as their target are returned.
- *
- * If no node `u` exists in the graph this function throws an Error.
- *
- * @param {String} u a node id
- */
-Digraph.prototype.predecessors = function(u) {
-  this._strictGetNode(u);
-  return Object.keys(this._inEdges[u])
-               .map(function(v) { return this._nodes[v].id; }, this);
-};
-
-/*
- * Returns all nodes that are adjacent to the node with the id `u`. In other
- * words, this function returns the set of all successors and predecessors of
- * node `u`.
- *
- * @param {String} u a node id
- */
-Digraph.prototype.neighbors = function(u) {
-  return Set.union([this.successors(u), this.predecessors(u)]).keys();
-};
-
-/*
- * Returns all nodes in the graph that have no in-edges.
- */
-Digraph.prototype.sources = function() {
-  var self = this;
-  return this._filterNodes(function(u) {
-    // This could have better space characteristics if we had an inDegree function.
-    return self.inEdges(u).length === 0;
-  });
-};
-
-/*
- * Returns all nodes in the graph that have no out-edges.
- */
-Digraph.prototype.sinks = function() {
-  var self = this;
-  return this._filterNodes(function(u) {
-    // This could have better space characteristics if we have an outDegree function.
-    return self.outEdges(u).length === 0;
-  });
-};
-
-/*
- * Returns the source node incident on the edge identified by the id `e`. If no
- * such edge exists in the graph this function throws an Error.
- *
- * @param {String} e an edge id
- */
-Digraph.prototype.source = function(e) {
-  return this._strictGetEdge(e).u;
-};
-
-/*
- * Returns the target node incident on the edge identified by the id `e`. If no
- * such edge exists in the graph this function throws an Error.
- *
- * @param {String} e an edge id
- */
-Digraph.prototype.target = function(e) {
-  return this._strictGetEdge(e).v;
-};
-
-/*
- * Returns an array of ids for all edges in the graph that have the node
- * `target` as their target. If the node `target` is not in the graph this
- * function raises an Error.
- *
- * Optionally a `source` node can also be specified. This causes the results
- * to be filtered such that only edges from `source` to `target` are included.
- * If the node `source` is specified but is not in the graph then this function
- * raises an Error.
- *
- * @param {String} target the target node id
- * @param {String} [source] an optional source node id
- */
-Digraph.prototype.inEdges = function(target, source) {
-  this._strictGetNode(target);
-  var results = Set.union(util.values(this._inEdges[target])).keys();
-  if (arguments.length > 1) {
-    this._strictGetNode(source);
-    results = results.filter(function(e) { return this.source(e) === source; }, this);
-  }
-  return results;
-};
-
-/*
- * Returns an array of ids for all edges in the graph that have the node
- * `source` as their source. If the node `source` is not in the graph this
- * function raises an Error.
- *
- * Optionally a `target` node may also be specified. This causes the results
- * to be filtered such that only edges from `source` to `target` are included.
- * If the node `target` is specified but is not in the graph then this function
- * raises an Error.
- *
- * @param {String} source the source node id
- * @param {String} [target] an optional target node id
- */
-Digraph.prototype.outEdges = function(source, target) {
-  this._strictGetNode(source);
-  var results = Set.union(util.values(this._outEdges[source])).keys();
-  if (arguments.length > 1) {
-    this._strictGetNode(target);
-    results = results.filter(function(e) { return this.target(e) === target; }, this);
-  }
-  return results;
-};
-
-/*
- * Returns an array of ids for all edges in the graph that have the `u` as
- * their source or their target. If the node `u` is not in the graph this
- * function raises an Error.
- *
- * Optionally a `v` node may also be specified. This causes the results to be
- * filtered such that only edges between `u` and `v` - in either direction -
- * are included. IF the node `v` is specified but not in the graph then this
- * function raises an Error.
- *
- * @param {String} u the node for which to find incident edges
- * @param {String} [v] option node that must be adjacent to `u`
- */
-Digraph.prototype.incidentEdges = function(u, v) {
-  if (arguments.length > 1) {
-    return Set.union([this.outEdges(u, v), this.outEdges(v, u)]).keys();
-  } else {
-    return Set.union([this.inEdges(u), this.outEdges(u)]).keys();
-  }
-};
-
-/*
- * Returns a string representation of this graph.
- */
-Digraph.prototype.toString = function() {
-  return "Digraph " + JSON.stringify(this, null, 2);
-};
-
-/*
- * Adds a new node with the id `u` to the graph and assigns it the value
- * `value`. If a node with the id is already a part of the graph this function
- * throws an Error.
- *
- * @param {String} u a node id
- * @param {Object} [value] an optional value to attach to the node
- */
-Digraph.prototype.addNode = function(u, value) {
-  u = BaseGraph.prototype.addNode.call(this, u, value);
-  this._inEdges[u] = {};
-  this._outEdges[u] = {};
-  return u;
-};
-
-/*
- * Removes a node from the graph that has the id `u`. Any edges incident on the
- * node are also removed. If the graph does not contain a node with the id this
- * function will throw an Error.
- *
- * @param {String} u a node id
- */
-Digraph.prototype.delNode = function(u) {
-  BaseGraph.prototype.delNode.call(this, u);
-  delete this._inEdges[u];
-  delete this._outEdges[u];
-};
-
-/*
- * Adds a new edge to the graph with the id `e` from a node with the id `source`
- * to a node with an id `target` and assigns it the value `value`. This graph
- * allows more than one edge from `source` to `target` as long as the id `e`
- * is unique in the set of edges. If `e` is `null` the graph will assign a
- * unique identifier to the edge.
- *
- * If `source` or `target` are not present in the graph this function will
- * throw an Error.
- *
- * @param {String} [e] an edge id
- * @param {String} source the source node id
- * @param {String} target the target node id
- * @param {Object} [value] an optional value to attach to the edge
- */
-Digraph.prototype.addEdge = function(e, source, target, value) {
-  return BaseGraph.prototype._addEdge.call(this, e, source, target, value,
-                                           this._inEdges, this._outEdges);
-};
-
-/*
- * Removes an edge in the graph with the id `e`. If no edge in the graph has
- * the id `e` this function will throw an Error.
- *
- * @param {String} e an edge id
- */
-Digraph.prototype.delEdge = function(e) {
-  BaseGraph.prototype._delEdge.call(this, e, this._inEdges, this._outEdges);
-};
-
-// Unlike BaseGraph.filterNodes, this helper just returns nodes that
-// satisfy a predicate.
-Digraph.prototype._filterNodes = function(pred) {
-  var filtered = [];
-  this.eachNode(function(u) {
-    if (pred(u)) {
-      filtered.push(u);
-    }
-  });
-  return filtered;
-};
-
-
-},{"./BaseGraph":30,"./util":50,"cp-data":5}],34:[function(require,module,exports){
-/*
- * This file is organized with in the following order:
- *
- * Exports
- * Graph constructors
- * Graph queries (e.g. nodes(), edges()
- * Graph mutators
- * Helper functions
- */
-
-var util = require("./util"),
-    BaseGraph = require("./BaseGraph"),
-/* jshint -W079 */
-    Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = Graph;
-
-/*
- * Constructor to create a new undirected multi-graph.
- */
-function Graph() {
-  BaseGraph.call(this);
-
-  /*! Map of nodeId -> { otherNodeId -> Set of edge ids } */
-  this._incidentEdges = {};
-}
-
-Graph.prototype = new BaseGraph();
-Graph.prototype.constructor = Graph;
-
-/*
- * Always returns `false`.
- */
-Graph.prototype.isDirected = function() {
-  return false;
-};
-
-/*
- * Returns all nodes that are adjacent to the node with the id `u`.
- *
- * @param {String} u a node id
- */
-Graph.prototype.neighbors = function(u) {
-  this._strictGetNode(u);
-  return Object.keys(this._incidentEdges[u])
-               .map(function(v) { return this._nodes[v].id; }, this);
-};
-
-/*
- * Returns an array of ids for all edges in the graph that are incident on `u`.
- * If the node `u` is not in the graph this function raises an Error.
- *
- * Optionally a `v` node may also be specified. This causes the results to be
- * filtered such that only edges between `u` and `v` are included. If the node
- * `v` is specified but not in the graph then this function raises an Error.
- *
- * @param {String} u the node for which to find incident edges
- * @param {String} [v] option node that must be adjacent to `u`
- */
-Graph.prototype.incidentEdges = function(u, v) {
-  this._strictGetNode(u);
-  if (arguments.length > 1) {
-    this._strictGetNode(v);
-    return v in this._incidentEdges[u] ? this._incidentEdges[u][v].keys() : [];
-  } else {
-    return Set.union(util.values(this._incidentEdges[u])).keys();
-  }
-};
-
-/*
- * Returns a string representation of this graph.
- */
-Graph.prototype.toString = function() {
-  return "Graph " + JSON.stringify(this, null, 2);
-};
-
-/*
- * Adds a new node with the id `u` to the graph and assigns it the value
- * `value`. If a node with the id is already a part of the graph this function
- * throws an Error.
- *
- * @param {String} u a node id
- * @param {Object} [value] an optional value to attach to the node
- */
-Graph.prototype.addNode = function(u, value) {
-  u = BaseGraph.prototype.addNode.call(this, u, value);
-  this._incidentEdges[u] = {};
-  return u;
-};
-
-/*
- * Removes a node from the graph that has the id `u`. Any edges incident on the
- * node are also removed. If the graph does not contain a node with the id this
- * function will throw an Error.
- *
- * @param {String} u a node id
- */
-Graph.prototype.delNode = function(u) {
-  BaseGraph.prototype.delNode.call(this, u);
-  delete this._incidentEdges[u];
-};
-
-/*
- * Adds a new edge to the graph with the id `e` between a node with the id `u`
- * and a node with an id `v` and assigns it the value `value`. This graph
- * allows more than one edge between `u` and `v` as long as the id `e`
- * is unique in the set of edges. If `e` is `null` the graph will assign a
- * unique identifier to the edge.
- *
- * If `u` or `v` are not present in the graph this function will throw an
- * Error.
- *
- * @param {String} [e] an edge id
- * @param {String} u the node id of one of the adjacent nodes
- * @param {String} v the node id of the other adjacent node
- * @param {Object} [value] an optional value to attach to the edge
- */
-Graph.prototype.addEdge = function(e, u, v, value) {
-  return BaseGraph.prototype._addEdge.call(this, e, u, v, value,
-                                           this._incidentEdges, this._incidentEdges);
-};
-
-/*
- * Removes an edge in the graph with the id `e`. If no edge in the graph has
- * the id `e` this function will throw an Error.
- *
- * @param {String} e an edge id
- */
-Graph.prototype.delEdge = function(e) {
-  BaseGraph.prototype._delEdge.call(this, e, this._incidentEdges, this._incidentEdges);
-};
-
-
-},{"./BaseGraph":30,"./util":50,"cp-data":5}],35:[function(require,module,exports){
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = components;
-
-/**
- * Finds all [connected components][] in a graph and returns an array of these
- * components. Each component is itself an array that contains the ids of nodes
- * in the component.
- *
- * This function only works with undirected Graphs.
- *
- * [connected components]: http://en.wikipedia.org/wiki/Connected_component_(graph_theory)
- *
- * @param {Graph} g the graph to search for components
- */
-function components(g) {
-  var results = [];
-  var visited = new Set();
-
-  function dfs(v, component) {
-    if (!visited.has(v)) {
-      visited.add(v);
-      component.push(v);
-      g.neighbors(v).forEach(function(w) {
-        dfs(w, component);
-      });
-    }
-  }
-
-  g.nodes().forEach(function(v) {
-    var component = [];
-    dfs(v, component);
-    if (component.length > 0) {
-      results.push(component);
-    }
-  });
-
-  return results;
-}
-
-},{"cp-data":5}],36:[function(require,module,exports){
-var PriorityQueue = require("cp-data").PriorityQueue;
-
-module.exports = dijkstra;
-
-/**
- * This function is an implementation of [Dijkstra's algorithm][] which finds
- * the shortest path from **source** to all other nodes in **g**. This
- * function returns a map of `u -> { distance, predecessor }`. The distance
- * property holds the sum of the weights from **source** to `u` along the
- * shortest path or `Number.POSITIVE_INFINITY` if there is no path from
- * **source**. The predecessor property can be used to walk the individual
- * elements of the path from **source** to **u** in reverse order.
- *
- * This function takes an optional `weightFunc(e)` which returns the
- * weight of the edge `e`. If no weightFunc is supplied then each edge is
- * assumed to have a weight of 1. This function throws an Error if any of
- * the traversed edges have a negative edge weight.
- *
- * This function takes an optional `incidentFunc(u)` which returns the ids of
- * all edges incident to the node `u` for the purposes of shortest path
- * traversal. By default this function uses the `g.outEdges` for Digraphs and
- * `g.incidentEdges` for Graphs.
- *
- * This function takes `O((|E| + |V|) * log |V|)` time.
- *
- * [Dijkstra's algorithm]: http://en.wikipedia.org/wiki/Dijkstra%27s_algorithm
- *
- * @param {Graph} g the graph to search for shortest paths from **source**
- * @param {Object} source the source from which to start the search
- * @param {Function} [weightFunc] optional weight function
- * @param {Function} [incidentFunc] optional incident function
- */
-function dijkstra(g, source, weightFunc, incidentFunc) {
-  var results = {},
-      pq = new PriorityQueue();
-
-  function updateNeighbors(e) {
-    var incidentNodes = g.incidentNodes(e),
-        v = incidentNodes[0] !== u ? incidentNodes[0] : incidentNodes[1],
-        vEntry = results[v],
-        weight = weightFunc(e),
-        distance = uEntry.distance + weight;
-
-    if (weight < 0) {
-      throw new Error("dijkstra does not allow negative edge weights. Bad edge: " + e + " Weight: " + weight);
-    }
-
-    if (distance < vEntry.distance) {
-      vEntry.distance = distance;
-      vEntry.predecessor = u;
-      pq.decrease(v, distance);
-    }
-  }
-
-  weightFunc = weightFunc || function() { return 1; };
-  incidentFunc = incidentFunc || (g.isDirected()
-      ? function(u) { return g.outEdges(u); }
-      : function(u) { return g.incidentEdges(u); });
-
-  g.eachNode(function(u) {
-    var distance = u === source ? 0 : Number.POSITIVE_INFINITY;
-    results[u] = { distance: distance };
-    pq.add(u, distance);
-  });
-
-  var u, uEntry;
-  while (pq.size() > 0) {
-    u = pq.removeMin();
-    uEntry = results[u];
-    if (uEntry.distance === Number.POSITIVE_INFINITY) {
-      break;
-    }
-
-    incidentFunc(u).forEach(updateNeighbors);
-  }
-
-  return results;
-}
-
-},{"cp-data":5}],37:[function(require,module,exports){
-var dijkstra = require("./dijkstra");
-
-module.exports = dijkstraAll;
-
-/**
- * This function finds the shortest path from each node to every other
- * reachable node in the graph. It is similar to [alg.dijkstra][], but
- * instead of returning a single-source array, it returns a mapping of
- * of `source -> alg.dijksta(g, source, weightFunc, incidentFunc)`.
- *
- * This function takes an optional `weightFunc(e)` which returns the
- * weight of the edge `e`. If no weightFunc is supplied then each edge is
- * assumed to have a weight of 1. This function throws an Error if any of
- * the traversed edges have a negative edge weight.
- *
- * This function takes an optional `incidentFunc(u)` which returns the ids of
- * all edges incident to the node `u` for the purposes of shortest path
- * traversal. By default this function uses the `outEdges` function on the
- * supplied graph.
- *
- * This function takes `O(|V| * (|E| + |V|) * log |V|)` time.
- *
- * [alg.dijkstra]: dijkstra.js.html#dijkstra
- *
- * @param {Graph} g the graph to search for shortest paths from **source**
- * @param {Function} [weightFunc] optional weight function
- * @param {Function} [incidentFunc] optional incident function
- */
-function dijkstraAll(g, weightFunc, incidentFunc) {
-  var results = {};
-  g.eachNode(function(u) {
-    results[u] = dijkstra(g, u, weightFunc, incidentFunc);
-  });
-  return results;
-}
-
-},{"./dijkstra":36}],38:[function(require,module,exports){
-var tarjan = require("./tarjan");
-
-module.exports = findCycles;
-
-/*
- * Given a Digraph **g** this function returns all nodes that are part of a
- * cycle. Since there may be more than one cycle in a graph this function
- * returns an array of these cycles, where each cycle is itself represented
- * by an array of ids for each node involved in that cycle.
- *
- * [alg.isAcyclic][] is more efficient if you only need to determine whether
- * a graph has a cycle or not.
- *
- * [alg.isAcyclic]: isAcyclic.js.html#isAcyclic
- *
- * @param {Digraph} g the graph to search for cycles.
- */
-function findCycles(g) {
-  return tarjan(g).filter(function(cmpt) { return cmpt.length > 1; });
-}
-
-},{"./tarjan":44}],39:[function(require,module,exports){
-module.exports = floydWarshall;
-
-/**
- * This function is an implementation of the [Floyd-Warshall algorithm][],
- * which finds the shortest path from each node to every other reachable node
- * in the graph. It is similar to [alg.dijkstraAll][], but it handles negative
- * edge weights and is more efficient for some types of graphs. This function
- * returns a map of `source -> { target -> { distance, predecessor }`. The
- * distance property holds the sum of the weights from `source` to `target`
- * along the shortest path of `Number.POSITIVE_INFINITY` if there is no path
- * from `source`. The predecessor property can be used to walk the individual
- * elements of the path from `source` to `target` in reverse order.
- *
- * This function takes an optional `weightFunc(e)` which returns the
- * weight of the edge `e`. If no weightFunc is supplied then each edge is
- * assumed to have a weight of 1.
- *
- * This function takes an optional `incidentFunc(u)` which returns the ids of
- * all edges incident to the node `u` for the purposes of shortest path
- * traversal. By default this function uses the `outEdges` function on the
- * supplied graph.
- *
- * This algorithm takes O(|V|^3) time.
- *
- * [Floyd-Warshall algorithm]: https://en.wikipedia.org/wiki/Floyd-Warshall_algorithm
- * [alg.dijkstraAll]: dijkstraAll.js.html#dijkstraAll
- *
- * @param {Graph} g the graph to search for shortest paths from **source**
- * @param {Function} [weightFunc] optional weight function
- * @param {Function} [incidentFunc] optional incident function
- */
-function floydWarshall(g, weightFunc, incidentFunc) {
-  var results = {},
-      nodes = g.nodes();
-
-  weightFunc = weightFunc || function() { return 1; };
-  incidentFunc = incidentFunc || (g.isDirected()
-      ? function(u) { return g.outEdges(u); }
-      : function(u) { return g.incidentEdges(u); });
-
-  nodes.forEach(function(u) {
-    results[u] = {};
-    results[u][u] = { distance: 0 };
-    nodes.forEach(function(v) {
-      if (u !== v) {
-        results[u][v] = { distance: Number.POSITIVE_INFINITY };
-      }
-    });
-    incidentFunc(u).forEach(function(e) {
-      var incidentNodes = g.incidentNodes(e),
-          v = incidentNodes[0] !== u ? incidentNodes[0] : incidentNodes[1],
-          d = weightFunc(e);
-      if (d < results[u][v].distance) {
-        results[u][v] = { distance: d, predecessor: u };
-      }
-    });
-  });
-
-  nodes.forEach(function(k) {
-    var rowK = results[k];
-    nodes.forEach(function(i) {
-      var rowI = results[i];
-      nodes.forEach(function(j) {
-        var ik = rowI[k];
-        var kj = rowK[j];
-        var ij = rowI[j];
-        var altDistance = ik.distance + kj.distance;
-        if (altDistance < ij.distance) {
-          ij.distance = altDistance;
-          ij.predecessor = kj.predecessor;
-        }
-      });
-    });
-  });
-
-  return results;
-}
-
-},{}],40:[function(require,module,exports){
-var topsort = require("./topsort");
-
-module.exports = isAcyclic;
-
-/*
- * Given a Digraph **g** this function returns `true` if the graph has no
- * cycles and returns `false` if it does. This algorithm returns as soon as it
- * detects the first cycle.
- *
- * Use [alg.findCycles][] if you need the actual list of cycles in a graph.
- *
- * [alg.findCycles]: findCycles.js.html#findCycles
- *
- * @param {Digraph} g the graph to test for cycles
- */
-function isAcyclic(g) {
-  try {
-    topsort(g);
-  } catch (e) {
-    if (e instanceof topsort.CycleException) return false;
-    throw e;
-  }
-  return true;
-}
-
-},{"./topsort":45}],41:[function(require,module,exports){
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = postorder;
-
-// Postorder traversal of g, calling f for each visited node. Assumes the graph
-// is a tree.
-function postorder(g, root, f) {
-  var visited = new Set();
-  if (g.isDirected()) {
-    throw new Error("This function only works for undirected graphs");
-  }
-  function dfs(u, prev) {
-    if (visited.has(u)) {
-      throw new Error("The input graph is not a tree: " + g);
-    }
-    visited.add(u);
-    g.neighbors(u).forEach(function(v) {
-      if (v !== prev) dfs(v, u);
-    });
-    f(u);
-  }
-  dfs(root);
-}
-
-},{"cp-data":5}],42:[function(require,module,exports){
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = preorder;
-
-// Preorder traversal of g, calling f for each visited node. Assumes the graph
-// is a tree.
-function preorder(g, root, f) {
-  var visited = new Set();
-  if (g.isDirected()) {
-    throw new Error("This function only works for undirected graphs");
-  }
-  function dfs(u, prev) {
-    if (visited.has(u)) {
-      throw new Error("The input graph is not a tree: " + g);
-    }
-    visited.add(u);
-    f(u);
-    g.neighbors(u).forEach(function(v) {
-      if (v !== prev) dfs(v, u);
-    });
-  }
-  dfs(root);
-}
-
-},{"cp-data":5}],43:[function(require,module,exports){
-var Graph = require("../Graph"),
-    PriorityQueue = require("cp-data").PriorityQueue;
-
-module.exports = prim;
-
-/**
- * [Prim's algorithm][] takes a connected undirected graph and generates a
- * [minimum spanning tree][]. This function returns the minimum spanning
- * tree as an undirected graph. This algorithm is derived from the description
- * in "Introduction to Algorithms", Third Edition, Cormen, et al., Pg 634.
- *
- * This function takes a `weightFunc(e)` which returns the weight of the edge
- * `e`. It throws an Error if the graph is not connected.
- *
- * This function takes `O(|E| log |V|)` time.
- *
- * [Prim's algorithm]: https://en.wikipedia.org/wiki/Prim's_algorithm
- * [minimum spanning tree]: https://en.wikipedia.org/wiki/Minimum_spanning_tree
- *
- * @param {Graph} g the graph used to generate the minimum spanning tree
- * @param {Function} weightFunc the weight function to use
- */
-function prim(g, weightFunc) {
-  var result = new Graph(),
-      parents = {},
-      pq = new PriorityQueue(),
-      u;
-
-  function updateNeighbors(e) {
-    var incidentNodes = g.incidentNodes(e),
-        v = incidentNodes[0] !== u ? incidentNodes[0] : incidentNodes[1],
-        pri = pq.priority(v);
-    if (pri !== undefined) {
-      var edgeWeight = weightFunc(e);
-      if (edgeWeight < pri) {
-        parents[v] = u;
-        pq.decrease(v, edgeWeight);
-      }
-    }
-  }
-
-  if (g.order() === 0) {
-    return result;
-  }
-
-  g.eachNode(function(u) {
-    pq.add(u, Number.POSITIVE_INFINITY);
-    result.addNode(u);
-  });
-
-  // Start from an arbitrary node
-  pq.decrease(g.nodes()[0], 0);
-
-  var init = false;
-  while (pq.size() > 0) {
-    u = pq.removeMin();
-    if (u in parents) {
-      result.addEdge(null, u, parents[u]);
-    } else if (init) {
-      throw new Error("Input graph is not connected: " + g);
-    } else {
-      init = true;
-    }
-
-    g.incidentEdges(u).forEach(updateNeighbors);
-  }
-
-  return result;
-}
-
-},{"../Graph":34,"cp-data":5}],44:[function(require,module,exports){
-module.exports = tarjan;
-
-/**
- * This function is an implementation of [Tarjan's algorithm][] which finds
- * all [strongly connected components][] in the directed graph **g**. Each
- * strongly connected component is composed of nodes that can reach all other
- * nodes in the component via directed edges. A strongly connected component
- * can consist of a single node if that node cannot both reach and be reached
- * by any other specific node in the graph. Components of more than one node
- * are guaranteed to have at least one cycle.
- *
- * This function returns an array of components. Each component is itself an
- * array that contains the ids of all nodes in the component.
- *
- * [Tarjan's algorithm]: http://en.wikipedia.org/wiki/Tarjan's_strongly_connected_components_algorithm
- * [strongly connected components]: http://en.wikipedia.org/wiki/Strongly_connected_component
- *
- * @param {Digraph} g the graph to search for strongly connected components
- */
-function tarjan(g) {
-  if (!g.isDirected()) {
-    throw new Error("tarjan can only be applied to a directed graph. Bad input: " + g);
-  }
-
-  var index = 0,
-      stack = [],
-      visited = {}, // node id -> { onStack, lowlink, index }
-      results = [];
-
-  function dfs(u) {
-    var entry = visited[u] = {
-      onStack: true,
-      lowlink: index,
-      index: index++
-    };
-    stack.push(u);
-
-    g.successors(u).forEach(function(v) {
-      if (!(v in visited)) {
-        dfs(v);
-        entry.lowlink = Math.min(entry.lowlink, visited[v].lowlink);
-      } else if (visited[v].onStack) {
-        entry.lowlink = Math.min(entry.lowlink, visited[v].index);
-      }
-    });
-
-    if (entry.lowlink === entry.index) {
-      var cmpt = [],
-          v;
-      do {
-        v = stack.pop();
-        visited[v].onStack = false;
-        cmpt.push(v);
-      } while (u !== v);
-      results.push(cmpt);
-    }
-  }
-
-  g.nodes().forEach(function(u) {
-    if (!(u in visited)) {
-      dfs(u);
-    }
-  });
-
-  return results;
-}
-
-},{}],45:[function(require,module,exports){
-module.exports = topsort;
-topsort.CycleException = CycleException;
-
-/*
- * Given a graph **g**, this function returns an ordered list of nodes such
- * that for each edge `u -> v`, `u` appears before `v` in the list. If the
- * graph has a cycle it is impossible to generate such a list and
- * **CycleException** is thrown.
- *
- * See [topological sorting](https://en.wikipedia.org/wiki/Topological_sorting)
- * for more details about how this algorithm works.
- *
- * @param {Digraph} g the graph to sort
- */
-function topsort(g) {
-  if (!g.isDirected()) {
-    throw new Error("topsort can only be applied to a directed graph. Bad input: " + g);
-  }
-
-  var visited = {};
-  var stack = {};
-  var results = [];
-
-  function visit(node) {
-    if (node in stack) {
-      throw new CycleException();
-    }
-
-    if (!(node in visited)) {
-      stack[node] = true;
-      visited[node] = true;
-      g.predecessors(node).forEach(function(pred) {
-        visit(pred);
-      });
-      delete stack[node];
-      results.push(node);
-    }
-  }
-
-  var sinks = g.sinks();
-  if (g.order() !== 0 && sinks.length === 0) {
-    throw new CycleException();
-  }
-
-  g.sinks().forEach(function(sink) {
-    visit(sink);
-  });
-
-  return results;
-}
-
-function CycleException() {}
-
-CycleException.prototype.toString = function() {
-  return "Graph has at least one cycle";
-};
-
-},{}],46:[function(require,module,exports){
-// This file provides a helper function that mixes-in Dot behavior to an
-// existing graph prototype.
-
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-module.exports = compoundify;
-
-// Extends the given SuperConstructor with the ability for nodes to contain
-// other nodes. A special node id `null` is used to indicate the root graph.
-function compoundify(SuperConstructor) {
-  function Constructor() {
-    SuperConstructor.call(this);
-
-    // Map of object id -> parent id (or null for root graph)
-    this._parents = {};
-
-    // Map of id (or null) -> children set
-    this._children = {};
-    this._children[null] = new Set();
-  }
-
-  Constructor.prototype = new SuperConstructor();
-  Constructor.prototype.constructor = Constructor;
-
-  Constructor.prototype.parent = function(u, parent) {
-    this._strictGetNode(u);
-
-    if (arguments.length < 2) {
-      return this._parents[u];
-    }
-
-    if (u === parent) {
-      throw new Error("Cannot make " + u + " a parent of itself");
-    }
-    if (parent !== null) {
-      this._strictGetNode(parent);
-    }
-
-    this._children[this._parents[u]].remove(u);
-    this._parents[u] = parent;
-    this._children[parent].add(u);
-  };
-
-  Constructor.prototype.children = function(u) {
-    if (u !== null) {
-      this._strictGetNode(u);
-    }
-    return this._children[u].keys();
-  };
-
-  Constructor.prototype.addNode = function(u, value) {
-    u = SuperConstructor.prototype.addNode.call(this, u, value);
-    this._parents[u] = null;
-    this._children[u] = new Set();
-    this._children[null].add(u);
-    return u;
-  };
-
-  Constructor.prototype.delNode = function(u) {
-    // Promote all children to the parent of the subgraph
-    var parent = this.parent(u);
-    this._children[u].keys().forEach(function(child) {
-      this.parent(child, parent);
-    }, this);
-
-    this._children[parent].remove(u);
-    delete this._parents[u];
-    delete this._children[u];
-
-    return SuperConstructor.prototype.delNode.call(this, u);
-  };
-
-  Constructor.prototype.copy = function() {
-    var copy = SuperConstructor.prototype.copy.call(this);
-    this.nodes().forEach(function(u) {
-      copy.parent(u, this.parent(u));
-    }, this);
-    return copy;
-  };
-
-  Constructor.prototype.filterNodes = function(filter) {
-    var self = this,
-        copy = SuperConstructor.prototype.filterNodes.call(this, filter);
-
-    var parents = {};
-    function findParent(u) {
-      var parent = self.parent(u);
-      if (parent === null || copy.hasNode(parent)) {
-        parents[u] = parent;
-        return parent;
-      } else if (parent in parents) {
-        return parents[parent];
-      } else {
-        return findParent(parent);
-      }
-    }
-
-    copy.eachNode(function(u) { copy.parent(u, findParent(u)); });
-
-    return copy;
-  };
-
-  return Constructor;
-}
-
-},{"cp-data":5}],47:[function(require,module,exports){
-var Graph = require("../Graph"),
-    Digraph = require("../Digraph"),
-    CGraph = require("../CGraph"),
-    CDigraph = require("../CDigraph");
-
-exports.decode = function(nodes, edges, Ctor) {
-  Ctor = Ctor || Digraph;
-
-  if (typeOf(nodes) !== "Array") {
-    throw new Error("nodes is not an Array");
-  }
-
-  if (typeOf(edges) !== "Array") {
-    throw new Error("edges is not an Array");
-  }
-
-  if (typeof Ctor === "string") {
-    switch(Ctor) {
-      case "graph": Ctor = Graph; break;
-      case "digraph": Ctor = Digraph; break;
-      case "cgraph": Ctor = CGraph; break;
-      case "cdigraph": Ctor = CDigraph; break;
-      default: throw new Error("Unrecognized graph type: " + Ctor);
-    }
-  }
-
-  var graph = new Ctor();
-
-  nodes.forEach(function(u) {
-    graph.addNode(u.id, u.value);
-  });
-
-  // If the graph is compound, set up children...
-  if (graph.parent) {
-    nodes.forEach(function(u) {
-      if (u.children) {
-        u.children.forEach(function(v) {
-          graph.parent(v, u.id);
-        });
-      }
-    });
-  }
-
-  edges.forEach(function(e) {
-    graph.addEdge(e.id, e.u, e.v, e.value);
-  });
-
-  return graph;
-};
-
-exports.encode = function(graph) {
-  var nodes = [];
-  var edges = [];
-
-  graph.eachNode(function(u, value) {
-    var node = {id: u, value: value};
-    if (graph.children) {
-      var children = graph.children(u);
-      if (children.length) {
-        node.children = children;
-      }
-    }
-    nodes.push(node);
-  });
-
-  graph.eachEdge(function(e, u, v, value) {
-    edges.push({id: e, u: u, v: v, value: value});
-  });
-
-  var type;
-  if (graph instanceof CDigraph) {
-    type = "cdigraph";
-  } else if (graph instanceof CGraph) {
-    type = "cgraph";
-  } else if (graph instanceof Digraph) {
-    type = "digraph";
-  } else if (graph instanceof Graph) {
-    type = "graph";
-  } else {
-    throw new Error("Couldn't determine type of graph: " + graph);
-  }
-
-  return { nodes: nodes, edges: edges, type: type };
-};
-
-function typeOf(obj) {
-  return Object.prototype.toString.call(obj).slice(8, -1);
-}
-
-},{"../CDigraph":31,"../CGraph":32,"../Digraph":33,"../Graph":34}],48:[function(require,module,exports){
-/* jshint -W079 */
-var Set = require("cp-data").Set;
-/* jshint +W079 */
-
-exports.all = function() {
-  return function() { return true; };
-};
-
-exports.nodesFromList = function(nodes) {
-  var set = new Set(nodes);
-  return function(u) {
-    return set.has(u);
-  };
-};
-
-},{"cp-data":5}],49:[function(require,module,exports){
-var Graph = require("./Graph"),
-    Digraph = require("./Digraph");
-
-// Side-effect based changes are lousy, but node doesn't seem to resolve the
-// requires cycle.
-
-/**
- * Returns a new directed graph using the nodes and edges from this graph. The
- * new graph will have the same nodes, but will have twice the number of edges:
- * each edge is split into two edges with opposite directions. Edge ids,
- * consequently, are not preserved by this transformation.
- */
-Graph.prototype.toDigraph =
-Graph.prototype.asDirected = function() {
-  var g = new Digraph();
-  this.eachNode(function(u, value) { g.addNode(u, value); });
-  this.eachEdge(function(e, u, v, value) {
-    g.addEdge(null, u, v, value);
-    g.addEdge(null, v, u, value);
-  });
-  return g;
-};
-
-/**
- * Returns a new undirected graph using the nodes and edges from this graph.
- * The new graph will have the same nodes, but the edges will be made
- * undirected. Edge ids are preserved in this transformation.
- */
-Digraph.prototype.toGraph =
-Digraph.prototype.asUndirected = function() {
-  var g = new Graph();
-  this.eachNode(function(u, value) { g.addNode(u, value); });
-  this.eachEdge(function(e, u, v, value) {
-    g.addEdge(e, u, v, value);
-  });
-  return g;
-};
-
-},{"./Digraph":33,"./Graph":34}],50:[function(require,module,exports){
-// Returns an array of all values for properties of **o**.
-exports.values = function(o) {
-  var ks = Object.keys(o),
-      len = ks.length,
-      result = new Array(len),
-      i;
-  for (i = 0; i < len; ++i) {
-    result[i] = o[ks[i]];
-  }
-  return result;
-};
-
-},{}],51:[function(require,module,exports){
-module.exports = '0.7.4';
-
-},{}]},{},[1])
-;
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 44d620fbaef83..acc48997725c2 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -95,14 +95,14 @@
     {{ super() }}
 
     <script src="{{ url_for_asset('d3.min.js') }}"></script>
-    {# It's an old or custom dagre-d3 library not supported with webpack 4. #}
-    {# TODO: Fix this using NPM version #}
-    <script src="{{ url_for_asset('dagreD3.js') }}"></script>
+    <script src="{{ url_for_asset('dagre-d3.min.js') }}"></script>
     <script>
 
     var highlight_color = "#000000";
     var upstream_color = "#2020A0";
     var downstream_color = "#0000FF";
+    var initialStrokeWidth = '3px';
+    var highlightStrokeWidth = '5px';
 
     var nodes = {{ nodes|safe }};
     var edges = {{ edges|safe }};
@@ -110,16 +110,49 @@
     var task_instances = {{ task_instances|safe }};
     var execution_date = "{{ execution_date }}";
     var arrange = "{{ arrange }}";
-    var g = dagreD3.json.decode(nodes, edges);
+
     var duration = 500;
     var stateFocusMap = {
         'no status':false, 'failed':false, 'running':false,
         'queued': false, 'success': false};
 
+    // Preparation of DagreD3 data structures
+    var g = new dagreD3.graphlib.Graph().setGraph({
+        nodesep: 15,
+        ranksep: 15,
+        rankdir: arrange,
+      })
+      .setDefaultEdgeLabel(function() { return { lineInterpolate: 'basis' } });
+
+    // Set all nodes and styles
+    nodes.forEach(function(node) {
+      g.setNode(node.id, node.value)
+    });
+
+    // Set edges
+    edges.forEach(function(edge) {
+      g.setEdge(edge.u, edge.v)
+    });
+
+    var render = dagreD3.render(),
+      svg = d3.select("svg"),
+      innerSvg = d3.select("svg g");
+
+    innerSvg.call(render, g);
+
+    function setUpZoomSupport() {
+      // Set up zoom support for Graph
+      var zoom = d3.behavior.zoom().on("zoom", function() {
+            innerSvg.attr("transform", "translate(" + d3.event.translate + ")" +
+                                        "scale(" + d3.event.scale + ")");
+          });
+      svg.call(zoom);
+    }
+
+    // Centering the DAG on load (Not implemented yet)
+    // https://github.com/dagrejs/dagre-d3/issues/245
 
-    var layout = dagreD3.layout().rankDir(arrange).nodeSep(15).rankSep(15);
-    var renderer = new dagreD3.Renderer();
-    renderer.layout(layout).run(g, d3.select("#dig"));
+    setUpZoomSupport();
     inject_node_ids(tasks);
     update_nodes_states(task_instances);
 
@@ -134,14 +167,14 @@
 
     function highlight_nodes(nodes, color) {
         nodes.forEach (function (nodeid) {
-            my_node = d3.select('#' + nodeid + ' rect');
-            my_node.style("stroke", color) ;
+            my_node = d3.select('#' + nodeid).node().parentNode;
+            d3.select(my_node).selectAll("rect").style("stroke", color) ;
         })
     }
 
     d3.selectAll("g.node").on("mouseover", function(d){
         d3.select(this).selectAll("rect").style("stroke", highlight_color) ;
-        highlight_nodes(g.predecessors(d), upstream_color)
+        highlight_nodes(g.predecessors(d), upstream_color);
         highlight_nodes(g.successors(d), downstream_color)
 
     });
@@ -210,7 +243,7 @@
                     .transition().duration(duration)
                     .style("opacity", 1)
                     .selectAll("rect")
-                    .style("stroke-width", "2px");
+                    .style("stroke-width", initialStrokeWidth);
             }
             else{
                 d3.select("g.edgePaths")
@@ -223,17 +256,21 @@
                         .transition().duration(duration)
                         .style("opacity", 1)
                         .selectAll("rect")
-                        .style("stroke-width", "10px");
+                        .style("stroke-width", highlightStrokeWidth);
                 }
                 else {
                     d3.select(this)
                         .transition()
                         .style("opacity", 0.2).duration(duration)
                         .selectAll("rect")
-                        .style("stroke-width", "2px");
+                        .style("stroke-width", initialStrokeWidth);
                 }
             }
         });
+
+        // This moves the matched node in the center of the graph area
+        // ToDo: Should we keep this here as it has no added value
+        // and does not fit the graph on small screens, and has to scroll
         if(match) {
             var transform = d3.transform(d3.select(match).attr("transform"));
             transform.translate = [
@@ -245,8 +282,8 @@
             d3.select("g.zoom")
                 .transition()
                 .attr("transform", transform.toString());
-            renderer.zoom_obj.translate(transform.translate);
-            renderer.zoom_obj.scale(1);
+            innerSvg.attr("transform", "translate(" + transform.translate + ")" +
+                                        "scale(1)");
         }
     });
 
@@ -267,7 +304,7 @@
     function update_nodes_states(task_instances) {
         $.each(task_instances, function(task_id, ti) {
           $('tspan').filter(function(index) { return $(this).text() === task_id; })
-            .parent().parent().parent()
+            .parent().parent().parent().parent()
             .attr("class", "node enter " + ti.state)
             .attr("data-toggle", "tooltip")
             .attr("data-original-title", function(d) {
@@ -294,7 +331,7 @@
             .style("opacity", 1);
         d3.selectAll("g.node rect")
             .transition(duration)
-            .style("stroke-width", "2px");
+            .style("stroke-width", initialStrokeWidth);
         d3.select("g.edgePaths")
             .transition().duration(duration)
             .style("opacity", 1);
@@ -311,7 +348,7 @@
             .style("opacity", 1);
         d3.selectAll("g.node." + state + " rect")
             .transition(duration)
-            .style("stroke-width", "10px")
+            .style("stroke-width", highlightStrokeWidth)
             .style("opacity", 1);
         d3.select("g.edgePaths")
             .transition().duration(duration)
@@ -338,34 +375,33 @@
         return false
     }
 
-    function error(msg){
-      $('#error_msg').html(msg);
-      $('#error').show();
-      $('#loading').hide();
-      $('#chart_section').hide(1000);
-      $('#datatable_section').hide(1000);
+    function initRefreshButton() {
+      d3.select("#refresh_button").on("click",
+          function() {
+              $("#loading").css("display", "block");
+              $("div#svg_container").css("opacity", "0.2");
+              $.get(
+                  "{{ url_for('Airflow.task_instances') }}",
+                  {dag_id : "{{ dag.dag_id }}", execution_date : "{{ execution_date }}"})
+              .done(
+                  function(task_instances) {
+                      update_nodes_states(JSON.parse(task_instances));
+                      $("#loading").hide();
+                      $("div#svg_container").css("opacity", "1");
+                      $('#error').hide();
+                  }
+              ).fail(function(jqxhr, textStatus, err) {
+                  $('#error_msg').html(textStatus + ': ' + err);
+                  $('#error').show();
+                  $('#loading').hide();
+                  $('#chart_section').hide(1000);
+                  $('#datatable_section').hide(1000);
+              });
+          }
+      );
     }
 
-    d3.select("#refresh_button").on("click",
-        function() {
-            $("#loading").css("display", "block");
-            $("div#svg_container").css("opacity", "0.2");
-            $.get(
-                "{{ url_for('Airflow.task_instances') }}",
-                {dag_id : "{{ dag.dag_id }}", execution_date : "{{ execution_date }}"})
-            .done(
-                function(task_instances) {
-                    update_nodes_states(JSON.parse(task_instances));
-                    $("#loading").hide();
-                    $("div#svg_container").css("opacity", "1");
-                    $('#error').hide();
-                }
-            ).fail(function(jqxhr, textStatus, err) {
-                error(textStatus + ': ' + err);
-            });
-        }
-    );
-
+    initRefreshButton();
     </script>
 
 
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 509e17c1ae5fd..e648f5378bcde 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1310,6 +1310,8 @@ def graph(self, session=None):
                     'label': task.task_id,
                     'labelStyle': "fill:{0};".format(task.ui_fgcolor),
                     'style': "fill:{0};".format(task.ui_color),
+                    'rx': 5,
+                    'ry': 5,
                 }
             })
 
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index d20b0e24db4a4..916d49bd9baa8 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -115,6 +115,7 @@ const config = {
       {from: 'node_modules/nvd3/build/\*.min.\*',flatten:true},
       // Update this when upgrade d3 package, as the path in new D3 is different
       {from: 'node_modules/d3/d3.min.\*', flatten:true},
+      {from: 'node_modules/dagre-d3/dist/\*.min.\*', flatten:true},
       {from: 'node_modules/d3-tip/dist/index.js', to:'d3-tip.js', flatten:true},
       {from: 'node_modules/bootstrap-3-typeahead/\*min.\*', flatten:true},
       {from: 'node_modules/bootstrap-toggle/**/*bootstrap-toggle.min.\*',

From 11dc3b9bd6d2edefa99f3948a00d1fa80166a4ab Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Wed, 25 Jul 2018 14:15:30 +0200
Subject: [PATCH 448/808] [AIRFLOW-2782][Airflow 2782] Removes unused
 hard-coded dagreD3

Closes #3635 from verdan/AIRFLOW-2782-dagred3-fix
---
 airflow/www_rbac/webpack.config.js | 1 -
 1 file changed, 1 deletion(-)

diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index 916d49bd9baa8..16c80ba84e421 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -36,7 +36,6 @@ const config = {
   entry: {
     connectionForm: STATIC_DIR + '/js/connection_form.js',
     clock: STATIC_DIR + '/js/clock.js',
-    dagreD3: STATIC_DIR + '/js/dagre-d3.js',
     ganttChartD3v2: STATIC_DIR + '/js/gantt-chart-d3v2.js',
     styleBundle: [
       STATIC_DIR + '/css/main.css',

From 77821b91faab5fa0287a495a42b1107530cc8c40 Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Thu, 26 Jul 2018 20:45:14 +0200
Subject: [PATCH 449/808] [AIRFLOW-2783][Airflow 2783] Implement eslint for JS
 code check (#3641)

---
 CONTRIBUTING.md                    |   16 +
 airflow/www_rbac/.eslintignore     |    8 +
 airflow/www_rbac/.eslintrc         |    5 +
 airflow/www_rbac/package-lock.json | 1269 +++++++++++++++++++++++++++-
 airflow/www_rbac/package.json      |   12 +-
 airflow/www_rbac/webpack.config.js |   44 +-
 6 files changed, 1324 insertions(+), 30 deletions(-)
 create mode 100644 airflow/www_rbac/.eslintignore
 create mode 100644 airflow/www_rbac/.eslintrc

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d23605458e101..a54db677a4787 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -360,3 +360,19 @@ npm run dev
 Should you add or upgrade a npm package, which involves changing `package.json`, you'll need to re-run `npm install` 
 and push the newly generated `package-lock.json` file so we get the reproducible build.
 
+#### Javascript Style Guide
+
+We try to enforce a more consistent style and try to follow the JS community guidelines. 
+Once you add or modify any javascript code in the project, please make sure it follows the guidelines 
+defined in [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript).
+Apache Airflow uses [ESLint](https://eslint.org/) as a tool for identifying and reporting on patterns in JavaScript,
+which can be used by running any of the following commands.
+
+```bash
+# Check JS code in .js and .html files, and report any errors/warnings
+npm run lint
+
+# Check JS code in .js and .html files, report any errors/warnings and fix them if possible 
+npm run lint:fix
+```
+ 
diff --git a/airflow/www_rbac/.eslintignore b/airflow/www_rbac/.eslintignore
new file mode 100644
index 0000000000000..924c9fc72b57d
--- /dev/null
+++ b/airflow/www_rbac/.eslintignore
@@ -0,0 +1,8 @@
+**/*{.,-}min.js
+**/*.sh
+**/*.py
+gantt-chart-d3v2.js
+jqClock.min.js
+coverage/**
+static/dist/*
+static/docs/*
diff --git a/airflow/www_rbac/.eslintrc b/airflow/www_rbac/.eslintrc
new file mode 100644
index 0000000000000..e566b6e0fb971
--- /dev/null
+++ b/airflow/www_rbac/.eslintrc
@@ -0,0 +1,5 @@
+{
+  "extends": "airbnb-base",
+  "parser": "babel-eslint",
+  "plugins": [ "html" ]
+}
diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index a5cbf24adf803..7038c4e5a62ec 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -2,6 +2,193 @@
   "requires": true,
   "lockfileVersion": 1,
   "dependencies": {
+    "@babel/code-frame": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.0.0-beta.44.tgz",
+      "integrity": "sha512-cuAuTTIQ9RqcFRJ/Y8PvTh+paepNcaGxwQwjIDRWPXmzzyAeCO4KqS9ikMvq0MCbRk6GlYKwfzStrcP3/jSL8g==",
+      "dev": true,
+      "requires": {
+        "@babel/highlight": "7.0.0-beta.44"
+      }
+    },
+    "@babel/generator": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.0.0-beta.44.tgz",
+      "integrity": "sha512-5xVb7hlhjGcdkKpMXgicAVgx8syK5VJz193k0i/0sLP6DzE6lRrU1K3B/rFefgdo9LPGMAOOOAWW4jycj07ShQ==",
+      "dev": true,
+      "requires": {
+        "@babel/types": "7.0.0-beta.44",
+        "jsesc": "^2.5.1",
+        "lodash": "^4.2.0",
+        "source-map": "^0.5.0",
+        "trim-right": "^1.0.1"
+      },
+      "dependencies": {
+        "jsesc": {
+          "version": "2.5.1",
+          "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-2.5.1.tgz",
+          "integrity": "sha1-5CGiqOINawgZ3yiQj3glJrlt0f4=",
+          "dev": true
+        }
+      }
+    },
+    "@babel/helper-function-name": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/helper-function-name/-/helper-function-name-7.0.0-beta.44.tgz",
+      "integrity": "sha512-MHRG2qZMKMFaBavX0LWpfZ2e+hLloT++N7rfM3DYOMUOGCD8cVjqZpwiL8a0bOX3IYcQev1ruciT0gdFFRTxzg==",
+      "dev": true,
+      "requires": {
+        "@babel/helper-get-function-arity": "7.0.0-beta.44",
+        "@babel/template": "7.0.0-beta.44",
+        "@babel/types": "7.0.0-beta.44"
+      }
+    },
+    "@babel/helper-get-function-arity": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/helper-get-function-arity/-/helper-get-function-arity-7.0.0-beta.44.tgz",
+      "integrity": "sha512-w0YjWVwrM2HwP6/H3sEgrSQdkCaxppqFeJtAnB23pRiJB5E/O9Yp7JAAeWBl+gGEgmBFinnTyOv2RN7rcSmMiw==",
+      "dev": true,
+      "requires": {
+        "@babel/types": "7.0.0-beta.44"
+      }
+    },
+    "@babel/helper-split-export-declaration": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.0.0-beta.44.tgz",
+      "integrity": "sha512-aQ7QowtkgKKzPGf0j6u77kBMdUFVBKNHw2p/3HX/POt5/oz8ec5cs0GwlgM8Hz7ui5EwJnzyfRmkNF1Nx1N7aA==",
+      "dev": true,
+      "requires": {
+        "@babel/types": "7.0.0-beta.44"
+      }
+    },
+    "@babel/highlight": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/highlight/-/highlight-7.0.0-beta.44.tgz",
+      "integrity": "sha512-Il19yJvy7vMFm8AVAh6OZzaFoAd0hbkeMZiX3P5HGD+z7dyI7RzndHB0dg6Urh/VAFfHtpOIzDUSxmY6coyZWQ==",
+      "dev": true,
+      "requires": {
+        "chalk": "^2.0.0",
+        "esutils": "^2.0.2",
+        "js-tokens": "^3.0.0"
+      },
+      "dependencies": {
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "@babel/template": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.0.0-beta.44.tgz",
+      "integrity": "sha512-w750Sloq0UNifLx1rUqwfbnC6uSUk0mfwwgGRfdLiaUzfAOiH0tHJE6ILQIUi3KYkjiCDTskoIsnfqZvWLBDng==",
+      "dev": true,
+      "requires": {
+        "@babel/code-frame": "7.0.0-beta.44",
+        "@babel/types": "7.0.0-beta.44",
+        "babylon": "7.0.0-beta.44",
+        "lodash": "^4.2.0"
+      },
+      "dependencies": {
+        "babylon": {
+          "version": "7.0.0-beta.44",
+          "resolved": "https://registry.npmjs.org/babylon/-/babylon-7.0.0-beta.44.tgz",
+          "integrity": "sha512-5Hlm13BJVAioCHpImtFqNOF2H3ieTOHd0fmFGMxOJ9jgeFqeAwsv3u5P5cR7CSeFrkgHsT19DgFJkHV0/Mcd8g==",
+          "dev": true
+        }
+      }
+    },
+    "@babel/traverse": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.0.0-beta.44.tgz",
+      "integrity": "sha512-UHuDz8ukQkJCDASKHf+oDt3FVUzFd+QYfuBIsiNu/4+/ix6pP/C+uQZJ6K1oEfbCMv/IKWbgDEh7fcsnIE5AtA==",
+      "dev": true,
+      "requires": {
+        "@babel/code-frame": "7.0.0-beta.44",
+        "@babel/generator": "7.0.0-beta.44",
+        "@babel/helper-function-name": "7.0.0-beta.44",
+        "@babel/helper-split-export-declaration": "7.0.0-beta.44",
+        "@babel/types": "7.0.0-beta.44",
+        "babylon": "7.0.0-beta.44",
+        "debug": "^3.1.0",
+        "globals": "^11.1.0",
+        "invariant": "^2.2.0",
+        "lodash": "^4.2.0"
+      },
+      "dependencies": {
+        "babylon": {
+          "version": "7.0.0-beta.44",
+          "resolved": "https://registry.npmjs.org/babylon/-/babylon-7.0.0-beta.44.tgz",
+          "integrity": "sha512-5Hlm13BJVAioCHpImtFqNOF2H3ieTOHd0fmFGMxOJ9jgeFqeAwsv3u5P5cR7CSeFrkgHsT19DgFJkHV0/Mcd8g==",
+          "dev": true
+        },
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "globals": {
+          "version": "11.7.0",
+          "resolved": "https://registry.npmjs.org/globals/-/globals-11.7.0.tgz",
+          "integrity": "sha512-K8BNSPySfeShBQXsahYB/AbbWruVOTyVpgoIDnl8odPpeSfP2J5QO2oLFFdl2j7GfDCtZj2bMKar2T49itTPCg==",
+          "dev": true
+        }
+      }
+    },
+    "@babel/types": {
+      "version": "7.0.0-beta.44",
+      "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.0.0-beta.44.tgz",
+      "integrity": "sha512-5eTV4WRmqbaFM3v9gHAIljEQJU4Ssc6fxL61JN+Oe2ga/BwyjzjamwkCVVAQjHGuAX8i0BWo42dshL8eO5KfLQ==",
+      "dev": true,
+      "requires": {
+        "esutils": "^2.0.2",
+        "lodash": "^4.2.0",
+        "to-fast-properties": "^2.0.0"
+      },
+      "dependencies": {
+        "to-fast-properties": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/to-fast-properties/-/to-fast-properties-2.0.0.tgz",
+          "integrity": "sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=",
+          "dev": true
+        }
+      }
+    },
     "@webassemblyjs/ast": {
       "version": "1.5.13",
       "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.5.13.tgz",
@@ -348,6 +535,23 @@
         "acorn": "^5.0.0"
       }
     },
+    "acorn-jsx": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-3.0.1.tgz",
+      "integrity": "sha1-r9+UiPsezvyDSPb7IvRk4ypYs2s=",
+      "dev": true,
+      "requires": {
+        "acorn": "^3.0.4"
+      },
+      "dependencies": {
+        "acorn": {
+          "version": "3.3.0",
+          "resolved": "https://registry.npmjs.org/acorn/-/acorn-3.3.0.tgz",
+          "integrity": "sha1-ReN/s56No/JbruP/U2niu18iAXo=",
+          "dev": true
+        }
+      }
+    },
     "ajv": {
       "version": "6.5.2",
       "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.5.2.tgz",
@@ -619,6 +823,28 @@
         "source-map": "^0.5.7"
       }
     },
+    "babel-eslint": {
+      "version": "8.2.6",
+      "resolved": "https://registry.npmjs.org/babel-eslint/-/babel-eslint-8.2.6.tgz",
+      "integrity": "sha512-aCdHjhzcILdP8c9lej7hvXKvQieyRt20SF102SIGyY4cUIiw6UaAtK4j2o3dXX74jEmy0TJ0CEhv4fTIM3SzcA==",
+      "dev": true,
+      "requires": {
+        "@babel/code-frame": "7.0.0-beta.44",
+        "@babel/traverse": "7.0.0-beta.44",
+        "@babel/types": "7.0.0-beta.44",
+        "babylon": "7.0.0-beta.44",
+        "eslint-scope": "3.7.1",
+        "eslint-visitor-keys": "^1.0.0"
+      },
+      "dependencies": {
+        "babylon": {
+          "version": "7.0.0-beta.44",
+          "resolved": "https://registry.npmjs.org/babylon/-/babylon-7.0.0-beta.44.tgz",
+          "integrity": "sha512-5Hlm13BJVAioCHpImtFqNOF2H3ieTOHd0fmFGMxOJ9jgeFqeAwsv3u5P5cR7CSeFrkgHsT19DgFJkHV0/Mcd8g==",
+          "dev": true
+        }
+      }
+    },
     "babel-generator": {
       "version": "6.26.1",
       "resolved": "https://registry.npmjs.org/babel-generator/-/babel-generator-6.26.1.tgz",
@@ -1066,6 +1292,12 @@
       "integrity": "sha1-JuYe0UIvtw3ULm42cp7VHYVf6Nk=",
       "dev": true
     },
+    "builtin-modules": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/builtin-modules/-/builtin-modules-1.1.1.tgz",
+      "integrity": "sha1-Jw8HbFpywC9bZaR9+Uxf46J4iS8=",
+      "dev": true
+    },
     "builtin-status-codes": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/builtin-status-codes/-/builtin-status-codes-3.0.0.tgz",
@@ -1126,6 +1358,21 @@
         "unset-value": "^1.0.0"
       }
     },
+    "caller-path": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/caller-path/-/caller-path-0.1.0.tgz",
+      "integrity": "sha1-lAhe9jWB7NPaqSREqP6U6CV3dR8=",
+      "dev": true,
+      "requires": {
+        "callsites": "^0.2.0"
+      }
+    },
+    "callsites": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/callsites/-/callsites-0.2.0.tgz",
+      "integrity": "sha1-r6uWJikQp/M8GaV3WCXGnzTjUMo=",
+      "dev": true
+    },
     "camelcase": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-1.2.1.tgz",
@@ -1227,6 +1474,12 @@
         "safe-buffer": "^5.0.1"
       }
     },
+    "circular-json": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/circular-json/-/circular-json-0.3.3.tgz",
+      "integrity": "sha512-UZK3NBx2Mca+b5LsG7bY183pHWt5Y1xts4P3Pz7ENTwGVnJOUWbRb3ocjvX7hx9tq/yTAdclXm9sZ38gNuem4A==",
+      "dev": true
+    },
     "clap": {
       "version": "1.2.3",
       "resolved": "https://registry.npmjs.org/clap/-/clap-1.2.3.tgz",
@@ -1310,6 +1563,12 @@
       "integrity": "sha1-2jCcwmPfFZlMaIypAheco8fNfH4=",
       "dev": true
     },
+    "co": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/co/-/co-4.6.0.tgz",
+      "integrity": "sha1-bqa989hTrlTMuOR7+gvz+QMfsYQ=",
+      "dev": true
+    },
     "coa": {
       "version": "1.0.4",
       "resolved": "https://registry.npmjs.org/coa/-/coa-1.0.4.tgz",
@@ -1438,6 +1697,12 @@
       "integrity": "sha1-wguW2MYXdIqvHBYCF2DNJ/y4y3U=",
       "dev": true
     },
+    "contains-path": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/contains-path/-/contains-path-0.1.0.tgz",
+      "integrity": "sha1-/ozxhP9mcLa67wGp1IYaXL7EEgo=",
+      "dev": true
+    },
     "convert-source-map": {
       "version": "1.5.1",
       "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-1.5.1.tgz",
@@ -2034,6 +2299,57 @@
       "integrity": "sha1-yY2bzvdWdBiOEQlpFRGZ45sfppM=",
       "dev": true
     },
+    "del": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/del/-/del-2.2.2.tgz",
+      "integrity": "sha1-wSyYHQZ4RshLyvhiz/kw2Qf/0ag=",
+      "dev": true,
+      "requires": {
+        "globby": "^5.0.0",
+        "is-path-cwd": "^1.0.0",
+        "is-path-in-cwd": "^1.0.0",
+        "object-assign": "^4.0.1",
+        "pify": "^2.0.0",
+        "pinkie-promise": "^2.0.0",
+        "rimraf": "^2.2.8"
+      },
+      "dependencies": {
+        "glob": {
+          "version": "7.1.2",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
+          "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+          "dev": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        },
+        "globby": {
+          "version": "5.0.0",
+          "resolved": "https://registry.npmjs.org/globby/-/globby-5.0.0.tgz",
+          "integrity": "sha1-69hGZ8oNuzMLmbz8aOrCvFQ3Dg0=",
+          "dev": true,
+          "requires": {
+            "array-union": "^1.0.1",
+            "arrify": "^1.0.0",
+            "glob": "^7.0.3",
+            "object-assign": "^4.0.1",
+            "pify": "^2.0.0",
+            "pinkie-promise": "^2.0.0"
+          }
+        },
+        "pify": {
+          "version": "2.3.0",
+          "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
+          "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=",
+          "dev": true
+        }
+      }
+    },
     "des.js": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.0.tgz",
@@ -2074,12 +2390,64 @@
         "path-type": "^3.0.0"
       }
     },
+    "doctrine": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz",
+      "integrity": "sha512-35mSku4ZXK0vfCuHEDAwt55dg2jNajHZ1odvF+8SSr82EsZY4QmXfuWso8oEd8zRhVObSN18aM0CjSdoBX7zIw==",
+      "dev": true,
+      "requires": {
+        "esutils": "^2.0.2"
+      }
+    },
+    "dom-serializer": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-0.1.0.tgz",
+      "integrity": "sha1-BzxpdUbOB4DOI75KKOKT5AvDDII=",
+      "dev": true,
+      "requires": {
+        "domelementtype": "~1.1.1",
+        "entities": "~1.1.1"
+      },
+      "dependencies": {
+        "domelementtype": {
+          "version": "1.1.3",
+          "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.1.3.tgz",
+          "integrity": "sha1-vSh3PiZCiBrsUVRJJCmcXNgiGFs=",
+          "dev": true
+        }
+      }
+    },
     "domain-browser": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/domain-browser/-/domain-browser-1.2.0.tgz",
       "integrity": "sha512-jnjyiM6eRyZl2H+W8Q/zLMA481hzi0eszAaBUzIVnmYVDBbnLxVNnfu1HgEBvCbL+71FrxMl3E6lpKH7Ge3OXA==",
       "dev": true
     },
+    "domelementtype": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-1.3.0.tgz",
+      "integrity": "sha1-sXrtguirWeUt2cGbF1bg/BhyBMI=",
+      "dev": true
+    },
+    "domhandler": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-2.4.2.tgz",
+      "integrity": "sha512-JiK04h0Ht5u/80fdLMCEmV4zkNh2BcoMFBmZ/91WtYZ8qVXSKjiw7fXMgFPnHcSZgOo3XdinHvmnDUeMf5R4wA==",
+      "dev": true,
+      "requires": {
+        "domelementtype": "1"
+      }
+    },
+    "domutils": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/domutils/-/domutils-1.7.0.tgz",
+      "integrity": "sha512-Lgd2XcJ/NjEw+7tFvfKxOzCYKZsdct5lczQ2ZaQY8Djz7pfAD3Gbp8ySJWtreII/vDlMVmxwa6pHmdxIYgttDg==",
+      "dev": true,
+      "requires": {
+        "dom-serializer": "0",
+        "domelementtype": "1"
+      }
+    },
     "duplexify": {
       "version": "3.6.0",
       "resolved": "https://registry.npmjs.org/duplexify/-/duplexify-3.6.0.tgz",
@@ -2139,6 +2507,12 @@
         "tapable": "^1.0.0"
       }
     },
+    "entities": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-1.1.1.tgz",
+      "integrity": "sha1-blwtClYhtdra7O+AuQ7ftc13cvA=",
+      "dev": true
+    },
     "errno": {
       "version": "0.1.7",
       "resolved": "https://registry.npmjs.org/errno/-/errno-0.1.7.tgz",
@@ -2148,6 +2522,39 @@
         "prr": "~1.0.1"
       }
     },
+    "error-ex": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/error-ex/-/error-ex-1.3.2.tgz",
+      "integrity": "sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g==",
+      "dev": true,
+      "requires": {
+        "is-arrayish": "^0.2.1"
+      }
+    },
+    "es-abstract": {
+      "version": "1.12.0",
+      "resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.12.0.tgz",
+      "integrity": "sha512-C8Fx/0jFmV5IPoMOFPA9P9G5NtqW+4cOPit3MIuvR2t7Ag2K15EJTpxnHAYTzL+aYQJIESYeXZmDBfOBE1HcpA==",
+      "dev": true,
+      "requires": {
+        "es-to-primitive": "^1.1.1",
+        "function-bind": "^1.1.1",
+        "has": "^1.0.1",
+        "is-callable": "^1.1.3",
+        "is-regex": "^1.0.4"
+      }
+    },
+    "es-to-primitive": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-to-primitive/-/es-to-primitive-1.1.1.tgz",
+      "integrity": "sha1-RTVSSKiJeQNLZ5Lhm7gfK3l13Q0=",
+      "dev": true,
+      "requires": {
+        "is-callable": "^1.1.1",
+        "is-date-object": "^1.0.1",
+        "is-symbol": "^1.0.1"
+      }
+    },
     "es5-ext": {
       "version": "0.10.45",
       "resolved": "https://registry.npmjs.org/es5-ext/-/es5-ext-0.10.45.tgz",
@@ -2211,14 +2618,418 @@
         }
       }
     },
+    "eslint": {
+      "version": "4.19.1",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-4.19.1.tgz",
+      "integrity": "sha512-bT3/1x1EbZB7phzYu7vCr1v3ONuzDtX8WjuM9c0iYxe+cq+pwcKEoQjl7zd3RpC6YOLgnSy3cTN58M2jcoPDIQ==",
+      "dev": true,
+      "requires": {
+        "ajv": "^5.3.0",
+        "babel-code-frame": "^6.22.0",
+        "chalk": "^2.1.0",
+        "concat-stream": "^1.6.0",
+        "cross-spawn": "^5.1.0",
+        "debug": "^3.1.0",
+        "doctrine": "^2.1.0",
+        "eslint-scope": "^3.7.1",
+        "eslint-visitor-keys": "^1.0.0",
+        "espree": "^3.5.4",
+        "esquery": "^1.0.0",
+        "esutils": "^2.0.2",
+        "file-entry-cache": "^2.0.0",
+        "functional-red-black-tree": "^1.0.1",
+        "glob": "^7.1.2",
+        "globals": "^11.0.1",
+        "ignore": "^3.3.3",
+        "imurmurhash": "^0.1.4",
+        "inquirer": "^3.0.6",
+        "is-resolvable": "^1.0.0",
+        "js-yaml": "^3.9.1",
+        "json-stable-stringify-without-jsonify": "^1.0.1",
+        "levn": "^0.3.0",
+        "lodash": "^4.17.4",
+        "minimatch": "^3.0.2",
+        "mkdirp": "^0.5.1",
+        "natural-compare": "^1.4.0",
+        "optionator": "^0.8.2",
+        "path-is-inside": "^1.0.2",
+        "pluralize": "^7.0.0",
+        "progress": "^2.0.0",
+        "regexpp": "^1.0.1",
+        "require-uncached": "^1.0.3",
+        "semver": "^5.3.0",
+        "strip-ansi": "^4.0.0",
+        "strip-json-comments": "~2.0.1",
+        "table": "4.0.2",
+        "text-table": "~0.2.0"
+      },
+      "dependencies": {
+        "ajv": {
+          "version": "5.5.2",
+          "resolved": "https://registry.npmjs.org/ajv/-/ajv-5.5.2.tgz",
+          "integrity": "sha1-c7Xuyj+rZT49P5Qis0GtQiBdyWU=",
+          "dev": true,
+          "requires": {
+            "co": "^4.6.0",
+            "fast-deep-equal": "^1.0.0",
+            "fast-json-stable-stringify": "^2.0.0",
+            "json-schema-traverse": "^0.3.0"
+          }
+        },
+        "ansi-regex": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-3.0.0.tgz",
+          "integrity": "sha1-7QMXwyIGT3lGbAKWa922Bas32Zg=",
+          "dev": true
+        },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "chardet": {
+          "version": "0.4.2",
+          "resolved": "https://registry.npmjs.org/chardet/-/chardet-0.4.2.tgz",
+          "integrity": "sha1-tUc7M9yXxCTl2Y3IfVXU2KKci/I=",
+          "dev": true
+        },
+        "cross-spawn": {
+          "version": "5.1.0",
+          "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-5.1.0.tgz",
+          "integrity": "sha1-6L0O/uWPz/b4+UUQoKVUu/ojVEk=",
+          "dev": true,
+          "requires": {
+            "lru-cache": "^4.0.1",
+            "shebang-command": "^1.2.0",
+            "which": "^1.2.9"
+          }
+        },
+        "debug": {
+          "version": "3.1.0",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-3.1.0.tgz",
+          "integrity": "sha512-OX8XqP7/1a9cqkxYw2yXss15f26NKWBpDXQd0/uK/KPqdQhxbPa994hnzjcE2VqQpDslf55723cKPUOGSmMY3g==",
+          "dev": true,
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "external-editor": {
+          "version": "2.2.0",
+          "resolved": "https://registry.npmjs.org/external-editor/-/external-editor-2.2.0.tgz",
+          "integrity": "sha512-bSn6gvGxKt+b7+6TKEv1ZycHleA7aHhRHyAqJyp5pbUFuYYNIzpZnQDk7AsYckyWdEnTeAnay0aCy2aV6iTk9A==",
+          "dev": true,
+          "requires": {
+            "chardet": "^0.4.0",
+            "iconv-lite": "^0.4.17",
+            "tmp": "^0.0.33"
+          }
+        },
+        "fast-deep-equal": {
+          "version": "1.1.0",
+          "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-1.1.0.tgz",
+          "integrity": "sha1-wFNHeBfIa1HaqFPIHgWbcz0CNhQ=",
+          "dev": true
+        },
+        "glob": {
+          "version": "7.1.2",
+          "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
+          "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+          "dev": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
+            "minimatch": "^3.0.4",
+            "once": "^1.3.0",
+            "path-is-absolute": "^1.0.0"
+          }
+        },
+        "globals": {
+          "version": "11.7.0",
+          "resolved": "https://registry.npmjs.org/globals/-/globals-11.7.0.tgz",
+          "integrity": "sha512-K8BNSPySfeShBQXsahYB/AbbWruVOTyVpgoIDnl8odPpeSfP2J5QO2oLFFdl2j7GfDCtZj2bMKar2T49itTPCg==",
+          "dev": true
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "inquirer": {
+          "version": "3.3.0",
+          "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-3.3.0.tgz",
+          "integrity": "sha512-h+xtnyk4EwKvFWHrUYsWErEVR+igKtLdchu+o0Z1RL7VU/jVMFbYir2bp6bAj8efFNxWqHX0dIss6fJQ+/+qeQ==",
+          "dev": true,
+          "requires": {
+            "ansi-escapes": "^3.0.0",
+            "chalk": "^2.0.0",
+            "cli-cursor": "^2.1.0",
+            "cli-width": "^2.0.0",
+            "external-editor": "^2.0.4",
+            "figures": "^2.0.0",
+            "lodash": "^4.3.0",
+            "mute-stream": "0.0.7",
+            "run-async": "^2.2.0",
+            "rx-lite": "^4.0.8",
+            "rx-lite-aggregates": "^4.0.8",
+            "string-width": "^2.1.0",
+            "strip-ansi": "^4.0.0",
+            "through": "^2.3.6"
+          }
+        },
+        "json-schema-traverse": {
+          "version": "0.3.1",
+          "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.3.1.tgz",
+          "integrity": "sha1-NJptRMU6Ud6JtAgFxdXlm0F9M0A=",
+          "dev": true
+        },
+        "strip-ansi": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
+          "integrity": "sha1-qEeQIusaw2iocTibY1JixQXuNo8=",
+          "dev": true,
+          "requires": {
+            "ansi-regex": "^3.0.0"
+          }
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
+    "eslint-config-airbnb-base": {
+      "version": "13.0.0",
+      "resolved": "https://registry.npmjs.org/eslint-config-airbnb-base/-/eslint-config-airbnb-base-13.0.0.tgz",
+      "integrity": "sha512-hUFXRlE6AY84z0qYh4wKdtSF4EqDnyT8sxrvTpcXCV4ENSLF8li5yNA1yDM26iinH8Ierbpc4lv8Rp62uX6VSQ==",
+      "dev": true,
+      "requires": {
+        "eslint-restricted-globals": "^0.1.1",
+        "object.assign": "^4.1.0",
+        "object.entries": "^1.0.4"
+      }
+    },
+    "eslint-import-resolver-node": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/eslint-import-resolver-node/-/eslint-import-resolver-node-0.3.2.tgz",
+      "integrity": "sha512-sfmTqJfPSizWu4aymbPr4Iidp5yKm8yDkHp+Ir3YiTHiiDfxh69mOUsmiqW6RZ9zRXFaF64GtYmN7e+8GHBv6Q==",
+      "dev": true,
+      "requires": {
+        "debug": "^2.6.9",
+        "resolve": "^1.5.0"
+      }
+    },
+    "eslint-module-utils": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/eslint-module-utils/-/eslint-module-utils-2.2.0.tgz",
+      "integrity": "sha1-snA2LNiLGkitMIl2zn+lTphBF0Y=",
+      "dev": true,
+      "requires": {
+        "debug": "^2.6.8",
+        "pkg-dir": "^1.0.0"
+      },
+      "dependencies": {
+        "find-up": {
+          "version": "1.1.2",
+          "resolved": "https://registry.npmjs.org/find-up/-/find-up-1.1.2.tgz",
+          "integrity": "sha1-ay6YIrGizgpgq2TWEOzK1TyyTQ8=",
+          "dev": true,
+          "requires": {
+            "path-exists": "^2.0.0",
+            "pinkie-promise": "^2.0.0"
+          }
+        },
+        "path-exists": {
+          "version": "2.1.0",
+          "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-2.1.0.tgz",
+          "integrity": "sha1-D+tsZPD8UY2adU3V77YscCJ2H0s=",
+          "dev": true,
+          "requires": {
+            "pinkie-promise": "^2.0.0"
+          }
+        },
+        "pkg-dir": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-1.0.0.tgz",
+          "integrity": "sha1-ektQio1bstYp1EcFb/TpyTFM89Q=",
+          "dev": true,
+          "requires": {
+            "find-up": "^1.0.0"
+          }
+        }
+      }
+    },
+    "eslint-plugin-es": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-es/-/eslint-plugin-es-1.3.1.tgz",
+      "integrity": "sha512-9XcVyZiQRVeFjqHw8qHNDAZcQLqaHlOGGpeYqzYh8S4JYCWTCO3yzyen8yVmA5PratfzTRWDwCOFphtDEG+w/w==",
+      "dev": true,
+      "requires": {
+        "eslint-utils": "^1.3.0",
+        "regexpp": "^2.0.0"
+      },
+      "dependencies": {
+        "regexpp": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/regexpp/-/regexpp-2.0.0.tgz",
+          "integrity": "sha512-g2FAVtR8Uh8GO1Nv5wpxW7VFVwHcCEr4wyA8/MHiRkO8uHoR5ntAA8Uq3P1vvMTX/BeQiRVSpDGLd+Wn5HNOTA==",
+          "dev": true
+        }
+      }
+    },
+    "eslint-plugin-html": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-html/-/eslint-plugin-html-4.0.5.tgz",
+      "integrity": "sha512-yULqYldzhYXTwZEaJXM30HhfgJdtTzuVH3LeoANybESHZ5+2ztLD72BsB2wR124/kk/PvQqZofDFSdNIk+kykw==",
+      "dev": true,
+      "requires": {
+        "htmlparser2": "^3.8.2"
+      }
+    },
+    "eslint-plugin-import": {
+      "version": "2.13.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-import/-/eslint-plugin-import-2.13.0.tgz",
+      "integrity": "sha512-t6hGKQDMIt9N8R7vLepsYXgDfeuhp6ZJSgtrLEDxonpSubyxUZHjhm6LsAaZX8q6GYVxkbT3kTsV9G5mBCFR6A==",
+      "dev": true,
+      "requires": {
+        "contains-path": "^0.1.0",
+        "debug": "^2.6.8",
+        "doctrine": "1.5.0",
+        "eslint-import-resolver-node": "^0.3.1",
+        "eslint-module-utils": "^2.2.0",
+        "has": "^1.0.1",
+        "lodash": "^4.17.4",
+        "minimatch": "^3.0.3",
+        "read-pkg-up": "^2.0.0",
+        "resolve": "^1.6.0"
+      },
+      "dependencies": {
+        "doctrine": {
+          "version": "1.5.0",
+          "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-1.5.0.tgz",
+          "integrity": "sha1-N53Ocw9hZvds76TmcHoVmwLFpvo=",
+          "dev": true,
+          "requires": {
+            "esutils": "^2.0.2",
+            "isarray": "^1.0.0"
+          }
+        }
+      }
+    },
+    "eslint-plugin-node": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-node/-/eslint-plugin-node-7.0.1.tgz",
+      "integrity": "sha512-lfVw3TEqThwq0j2Ba/Ckn2ABdwmL5dkOgAux1rvOk6CO7A6yGyPI2+zIxN6FyNkp1X1X/BSvKOceD6mBWSj4Yw==",
+      "dev": true,
+      "requires": {
+        "eslint-plugin-es": "^1.3.1",
+        "eslint-utils": "^1.3.1",
+        "ignore": "^4.0.2",
+        "minimatch": "^3.0.4",
+        "resolve": "^1.8.1",
+        "semver": "^5.5.0"
+      },
+      "dependencies": {
+        "ignore": {
+          "version": "4.0.2",
+          "resolved": "https://registry.npmjs.org/ignore/-/ignore-4.0.2.tgz",
+          "integrity": "sha512-uoxnT7PYpyEnsja+yX+7v49B7LXxmzDJ2JALqHH3oEGzpM2U1IGcbfnOr8Dt57z3B/UWs7/iAgPFbmye8m4I0g==",
+          "dev": true
+        }
+      }
+    },
+    "eslint-plugin-promise": {
+      "version": "3.8.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-promise/-/eslint-plugin-promise-3.8.0.tgz",
+      "integrity": "sha512-JiFL9UFR15NKpHyGii1ZcvmtIqa3UTwiDAGb8atSffe43qJ3+1czVGN6UtkklpcJ2DVnqvTMzEKRaJdBkAL2aQ==",
+      "dev": true
+    },
+    "eslint-plugin-standard": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/eslint-plugin-standard/-/eslint-plugin-standard-3.1.0.tgz",
+      "integrity": "sha512-fVcdyuKRr0EZ4fjWl3c+gp1BANFJD1+RaWa2UPYfMZ6jCtp5RG00kSaXnK/dE5sYzt4kaWJ9qdxqUfc0d9kX0w==",
+      "dev": true
+    },
+    "eslint-restricted-globals": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/eslint-restricted-globals/-/eslint-restricted-globals-0.1.1.tgz",
+      "integrity": "sha1-NfDVy8ZMLj7WLpO0saevBbp+1Nc=",
+      "dev": true
+    },
     "eslint-scope": {
       "version": "3.7.1",
       "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-3.7.1.tgz",
       "integrity": "sha1-PWPD7f2gLgbgGkUq2IyqzHzctug=",
       "dev": true,
       "requires": {
-        "esrecurse": "^4.1.0",
-        "estraverse": "^4.1.1"
+        "esrecurse": "^4.1.0",
+        "estraverse": "^4.1.1"
+      },
+      "dependencies": {
+        "estraverse": {
+          "version": "4.2.0",
+          "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.2.0.tgz",
+          "integrity": "sha1-De4/7TH81GlhjOc0IJn8GvoL2xM=",
+          "dev": true
+        }
+      }
+    },
+    "eslint-utils": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/eslint-utils/-/eslint-utils-1.3.1.tgz",
+      "integrity": "sha512-Z7YjnIldX+2XMcjr7ZkgEsOj/bREONV60qYeB/bjMAqqqZ4zxKyWX+BOUkdmRmA9riiIPVvo5x86m5elviOk0Q==",
+      "dev": true
+    },
+    "eslint-visitor-keys": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-1.0.0.tgz",
+      "integrity": "sha512-qzm/XxIbxm/FHyH341ZrbnMUpe+5Bocte9xkmFMzPMjRaZMcXww+MpBptFvtU+79L362nqiLhekCxCxDPaUMBQ==",
+      "dev": true
+    },
+    "espree": {
+      "version": "3.5.4",
+      "resolved": "https://registry.npmjs.org/espree/-/espree-3.5.4.tgz",
+      "integrity": "sha512-yAcIQxtmMiB/jL32dzEp2enBeidsB7xWPLNiw3IIkpVds1P+h7qF9YwJq1yUNzp2OKXgAprs4F61ih66UsoD1A==",
+      "dev": true,
+      "requires": {
+        "acorn": "^5.5.0",
+        "acorn-jsx": "^3.0.0"
+      }
+    },
+    "esprima": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz",
+      "integrity": "sha1-luO3DVd59q1JzQMmc9HDEnZ7pYE=",
+      "dev": true
+    },
+    "esquery": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.0.1.tgz",
+      "integrity": "sha512-SmiyZ5zIWH9VM+SRUReLS5Q8a7GxtRdxEBVZpm98rJM7Sb+A9DVCndXfkeFUd3byderg+EbDkfnevfCwynWaNA==",
+      "dev": true,
+      "requires": {
+        "estraverse": "^4.0.0"
       },
       "dependencies": {
         "estraverse": {
@@ -2229,12 +3040,6 @@
         }
       }
     },
-    "esprima": {
-      "version": "2.7.3",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz",
-      "integrity": "sha1-luO3DVd59q1JzQMmc9HDEnZ7pYE=",
-      "dev": true
-    },
     "esrecurse": {
       "version": "4.2.1",
       "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.2.1.tgz",
@@ -2479,6 +3284,16 @@
         "escape-string-regexp": "^1.0.5"
       }
     },
+    "file-entry-cache": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-2.0.0.tgz",
+      "integrity": "sha1-w5KZDD5oR4PYOLjISkXYoEhFg2E=",
+      "dev": true,
+      "requires": {
+        "flat-cache": "^1.2.1",
+        "object-assign": "^4.0.1"
+      }
+    },
     "file-loader": {
       "version": "1.1.11",
       "resolved": "https://registry.npmjs.org/file-loader/-/file-loader-1.1.11.tgz",
@@ -2532,6 +3347,18 @@
         "locate-path": "^2.0.0"
       }
     },
+    "flat-cache": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-1.3.0.tgz",
+      "integrity": "sha1-0wMLMrOBVPTjt+nHCfSQ9++XxIE=",
+      "dev": true,
+      "requires": {
+        "circular-json": "^0.3.1",
+        "del": "^2.0.2",
+        "graceful-fs": "^4.1.2",
+        "write": "^0.2.1"
+      }
+    },
     "flatten": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/flatten/-/flatten-1.0.2.tgz",
@@ -3145,6 +3972,12 @@
       "integrity": "sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==",
       "dev": true
     },
+    "functional-red-black-tree": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/functional-red-black-tree/-/functional-red-black-tree-1.0.1.tgz",
+      "integrity": "sha1-GwqzvVU7Kg1jmdKcDj6gslIHgyc=",
+      "dev": true
+    },
     "generic-names": {
       "version": "1.0.3",
       "resolved": "https://registry.npmjs.org/generic-names/-/generic-names-1.0.3.tgz",
@@ -3415,12 +4248,32 @@
         "os-tmpdir": "^1.0.1"
       }
     },
+    "hosted-git-info": {
+      "version": "2.7.1",
+      "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.7.1.tgz",
+      "integrity": "sha512-7T/BxH19zbcCTa8XkMlbK5lTo1WtgkFi3GvdWEyNuc4Vex7/9Dqbnpsf4JMydcfj9HCg4zUWFTL3Za6lapg5/w==",
+      "dev": true
+    },
     "html-comment-regex": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/html-comment-regex/-/html-comment-regex-1.1.1.tgz",
       "integrity": "sha1-ZouTd26q5V696POtRkswekljYl4=",
       "dev": true
     },
+    "htmlparser2": {
+      "version": "3.9.2",
+      "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-3.9.2.tgz",
+      "integrity": "sha1-G9+HrMoPP55T+k/M6w9LTLsAszg=",
+      "dev": true,
+      "requires": {
+        "domelementtype": "^1.3.0",
+        "domhandler": "^2.3.0",
+        "domutils": "^1.5.1",
+        "entities": "^1.1.1",
+        "inherits": "^2.0.1",
+        "readable-stream": "^2.0.2"
+      }
+    },
     "https-browserify": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/https-browserify/-/https-browserify-1.0.0.tgz",
@@ -3640,6 +4493,12 @@
         "kind-of": "^3.0.2"
       }
     },
+    "is-arrayish": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.2.1.tgz",
+      "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0=",
+      "dev": true
+    },
     "is-binary-path": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-1.0.1.tgz",
@@ -3655,6 +4514,21 @@
       "integrity": "sha512-NcdALwpXkTm5Zvvbk7owOUSvVvBKDgKP5/ewfXEznmQFfs4ZRmanOeKBTjRVjka3QFoN6XJ+9F3USqfHqTaU5w==",
       "dev": true
     },
+    "is-builtin-module": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-builtin-module/-/is-builtin-module-1.0.0.tgz",
+      "integrity": "sha1-VAVy0096wxGfj3bDDLwbHgN6/74=",
+      "dev": true,
+      "requires": {
+        "builtin-modules": "^1.0.0"
+      }
+    },
+    "is-callable": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.1.4.tgz",
+      "integrity": "sha512-r5p9sxJjYnArLjObpjA4xu5EKI3CuKHkJXMhT7kwbpUyIFD1n5PMAsoPvWnvtZiNz7LjkYDRZhd7FlI0eMijEA==",
+      "dev": true
+    },
     "is-data-descriptor": {
       "version": "0.1.4",
       "resolved": "https://registry.npmjs.org/is-data-descriptor/-/is-data-descriptor-0.1.4.tgz",
@@ -3664,6 +4538,12 @@
         "kind-of": "^3.0.2"
       }
     },
+    "is-date-object": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-date-object/-/is-date-object-1.0.1.tgz",
+      "integrity": "sha1-mqIOtq7rv/d/vTPnTKAbM1gdOhY=",
+      "dev": true
+    },
     "is-descriptor": {
       "version": "0.1.6",
       "resolved": "https://registry.npmjs.org/is-descriptor/-/is-descriptor-0.1.6.tgz",
@@ -3728,6 +4608,30 @@
         "kind-of": "^3.0.2"
       }
     },
+    "is-path-cwd": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-path-cwd/-/is-path-cwd-1.0.0.tgz",
+      "integrity": "sha1-0iXsIxMuie3Tj9p2dHLmLmXxEG0=",
+      "dev": true
+    },
+    "is-path-in-cwd": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-path-in-cwd/-/is-path-in-cwd-1.0.1.tgz",
+      "integrity": "sha512-FjV1RTW48E7CWM7eE/J2NJvAEEVektecDBVBE5Hh3nM1Jd0kvhHtX68Pr3xsDf857xt3Y4AkwVULK1Vku62aaQ==",
+      "dev": true,
+      "requires": {
+        "is-path-inside": "^1.0.0"
+      }
+    },
+    "is-path-inside": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-1.0.1.tgz",
+      "integrity": "sha1-jvW33lBDej/cprToZe96pVy0gDY=",
+      "dev": true,
+      "requires": {
+        "path-is-inside": "^1.0.1"
+      }
+    },
     "is-plain-obj": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-1.1.0.tgz",
@@ -3749,6 +4653,21 @@
       "integrity": "sha1-eaKp7OfwlugPNtKy87wWwf9L8/o=",
       "dev": true
     },
+    "is-regex": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.0.4.tgz",
+      "integrity": "sha1-VRdIm1RwkbCTDglWVM7SXul+lJE=",
+      "dev": true,
+      "requires": {
+        "has": "^1.0.1"
+      }
+    },
+    "is-resolvable": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/is-resolvable/-/is-resolvable-1.1.0.tgz",
+      "integrity": "sha512-qgDYXFSR5WvEfuS5dMj6oTMEbrrSaM0CrFk2Yiq/gXnBvD9pMa2jGXxyhGLfvhZpuMZe18CJpFxAt3CRs42NMg==",
+      "dev": true
+    },
     "is-stream": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-1.1.0.tgz",
@@ -3764,6 +4683,12 @@
         "html-comment-regex": "^1.1.0"
       }
     },
+    "is-symbol": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-symbol/-/is-symbol-1.0.1.tgz",
+      "integrity": "sha1-PMWfAAJRlLarLjjbrmaJJWtmBXI=",
+      "dev": true
+    },
     "is-windows": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/is-windows/-/is-windows-1.0.2.tgz",
@@ -3841,6 +4766,12 @@
       "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
       "dev": true
     },
+    "json-stable-stringify-without-jsonify": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
+      "integrity": "sha1-nbe1lJatPzz+8wp1FC0tkwrXJlE=",
+      "dev": true
+    },
     "json5": {
       "version": "0.5.1",
       "resolved": "https://registry.npmjs.org/json5/-/json5-0.5.1.tgz",
@@ -3900,6 +4831,26 @@
         "type-check": "~0.3.2"
       }
     },
+    "load-json-file": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-2.0.0.tgz",
+      "integrity": "sha1-eUfkIUmvgNaWy/eXvKq8/h/inKg=",
+      "dev": true,
+      "requires": {
+        "graceful-fs": "^4.1.2",
+        "parse-json": "^2.2.0",
+        "pify": "^2.0.0",
+        "strip-bom": "^3.0.0"
+      },
+      "dependencies": {
+        "pify": {
+          "version": "2.3.0",
+          "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
+          "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=",
+          "dev": true
+        }
+      }
+    },
     "loader-runner": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-2.3.0.tgz",
@@ -4325,6 +5276,12 @@
         }
       }
     },
+    "natural-compare": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz",
+      "integrity": "sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=",
+      "dev": true
+    },
     "neo-async": {
       "version": "2.5.1",
       "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.5.1.tgz",
@@ -4391,6 +5348,18 @@
         "abbrev": "1"
       }
     },
+    "normalize-package-data": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.4.0.tgz",
+      "integrity": "sha512-9jjUFbTPfEy3R/ad/2oNbKtW9Hgovl5O1FvFWKkKblNXoN/Oou6+9+KKohPK13Yc3/TyunyWhJp6gvRNR/PPAw==",
+      "dev": true,
+      "requires": {
+        "hosted-git-info": "^2.1.4",
+        "is-builtin-module": "^1.0.0",
+        "semver": "2 || 3 || 4 || 5",
+        "validate-npm-package-license": "^3.0.1"
+      }
+    },
     "normalize-path": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-2.1.1.tgz",
@@ -9623,6 +10592,18 @@
         "object-keys": "^1.0.11"
       }
     },
+    "object.entries": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/object.entries/-/object.entries-1.0.4.tgz",
+      "integrity": "sha1-G/mk3SKI9bM/Opk9JXZh8F0WGl8=",
+      "dev": true,
+      "requires": {
+        "define-properties": "^1.1.2",
+        "es-abstract": "^1.6.1",
+        "function-bind": "^1.1.0",
+        "has": "^1.0.1"
+      }
+    },
     "object.pick": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/object.pick/-/object.pick-1.3.0.tgz",
@@ -9771,6 +10752,15 @@
         "pbkdf2": "^3.0.3"
       }
     },
+    "parse-json": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/parse-json/-/parse-json-2.2.0.tgz",
+      "integrity": "sha1-9ID0BDTvgHQfhGkJn43qGPVaTck=",
+      "dev": true,
+      "requires": {
+        "error-ex": "^1.2.0"
+      }
+    },
     "pascalcase": {
       "version": "0.1.1",
       "resolved": "https://registry.npmjs.org/pascalcase/-/pascalcase-0.1.1.tgz",
@@ -9801,6 +10791,12 @@
       "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=",
       "dev": true
     },
+    "path-is-inside": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/path-is-inside/-/path-is-inside-1.0.2.tgz",
+      "integrity": "sha1-NlQX3t5EQw0cEa9hAn+s8HS9/FM=",
+      "dev": true
+    },
     "path-key": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/path-key/-/path-key-2.0.1.tgz",
@@ -9841,6 +10837,21 @@
       "integrity": "sha1-5aSs0sEB/fPZpNB/DbxNtJ3SgXY=",
       "dev": true
     },
+    "pinkie": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/pinkie/-/pinkie-2.0.4.tgz",
+      "integrity": "sha1-clVrgM+g1IqXToDnckjoDtT3+HA=",
+      "dev": true
+    },
+    "pinkie-promise": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/pinkie-promise/-/pinkie-promise-2.0.1.tgz",
+      "integrity": "sha1-ITXW36ejWMBprJsXh3YogihFD/o=",
+      "dev": true,
+      "requires": {
+        "pinkie": "^2.0.0"
+      }
+    },
     "pkg-dir": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/pkg-dir/-/pkg-dir-2.0.0.tgz",
@@ -9850,6 +10861,12 @@
         "find-up": "^2.1.0"
       }
     },
+    "pluralize": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-7.0.0.tgz",
+      "integrity": "sha512-ARhBOdzS3e41FbkW/XWrTEtukqqLoK5+Z/4UeDaLuSW+39JPeFgs4gCGqsrJHVZX0fUrx//4OF0K1CUGwlIFow==",
+      "dev": true
+    },
     "posix-character-classes": {
       "version": "0.1.1",
       "resolved": "https://registry.npmjs.org/posix-character-classes/-/posix-character-classes-0.1.1.tgz",
@@ -10856,6 +11873,12 @@
       "integrity": "sha512-MtEC1TqN0EU5nephaJ4rAtThHtC86dNN9qCuEhtshvpVBkAW5ZO7BASN9REnF9eoXGcRub+pFuKEpOHE+HbEMw==",
       "dev": true
     },
+    "progress": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/progress/-/progress-2.0.0.tgz",
+      "integrity": "sha1-ihvjZr+Pwj2yvSPxDG/pILQ4nR8=",
+      "dev": true
+    },
     "promise-inflight": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/promise-inflight/-/promise-inflight-1.0.1.tgz",
@@ -10961,6 +11984,44 @@
         "safe-buffer": "^5.1.0"
       }
     },
+    "read-pkg": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/read-pkg/-/read-pkg-2.0.0.tgz",
+      "integrity": "sha1-jvHAYjxqbbDcZxPEv6xGMysjaPg=",
+      "dev": true,
+      "requires": {
+        "load-json-file": "^2.0.0",
+        "normalize-package-data": "^2.3.2",
+        "path-type": "^2.0.0"
+      },
+      "dependencies": {
+        "path-type": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/path-type/-/path-type-2.0.0.tgz",
+          "integrity": "sha1-8BLMuEFbcJb8LaoQVMPXI4lZTHM=",
+          "dev": true,
+          "requires": {
+            "pify": "^2.0.0"
+          }
+        },
+        "pify": {
+          "version": "2.3.0",
+          "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
+          "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=",
+          "dev": true
+        }
+      }
+    },
+    "read-pkg-up": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/read-pkg-up/-/read-pkg-up-2.0.0.tgz",
+      "integrity": "sha1-a3KoBImE4MQeeVEP1en6mbO1Sb4=",
+      "dev": true,
+      "requires": {
+        "find-up": "^2.0.0",
+        "read-pkg": "^2.0.0"
+      }
+    },
     "readable-stream": {
       "version": "2.3.6",
       "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.6.tgz",
@@ -11046,6 +12107,12 @@
         "safe-regex": "^1.1.0"
       }
     },
+    "regexpp": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/regexpp/-/regexpp-1.1.0.tgz",
+      "integrity": "sha512-LOPw8FpgdQF9etWMaAfG/WRthIdXJGYp4mJ2Jgn/2lpkbod9jPn0t9UqN7AxBOKNfzRbYyVfgc7Vk4t/MpnXgw==",
+      "dev": true
+    },
     "regexpu-core": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/regexpu-core/-/regexpu-core-1.0.0.tgz",
@@ -11119,6 +12186,24 @@
       "integrity": "sha1-l/cXtp1IeE9fUmpsWqj/3aBVpNE=",
       "dev": true
     },
+    "require-uncached": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/require-uncached/-/require-uncached-1.0.3.tgz",
+      "integrity": "sha1-Tg1W1slmL9MeQwEcS5WqSZVUIdM=",
+      "dev": true,
+      "requires": {
+        "caller-path": "^0.1.0",
+        "resolve-from": "^1.0.0"
+      },
+      "dependencies": {
+        "resolve-from": {
+          "version": "1.0.1",
+          "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-1.0.1.tgz",
+          "integrity": "sha1-Jsv+k10a7uq7Kbw/5a6wHpPUQiY=",
+          "dev": true
+        }
+      }
+    },
     "resolve": {
       "version": "1.8.1",
       "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.8.1.tgz",
@@ -11228,6 +12313,21 @@
         "aproba": "^1.1.1"
       }
     },
+    "rx-lite": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/rx-lite/-/rx-lite-4.0.8.tgz",
+      "integrity": "sha1-Cx4Rr4vESDbwSmQH6S2kJGe3lEQ=",
+      "dev": true
+    },
+    "rx-lite-aggregates": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/rx-lite-aggregates/-/rx-lite-aggregates-4.0.8.tgz",
+      "integrity": "sha1-dTuHqJoRyVRnxKwWJsTvxOBcZ74=",
+      "dev": true,
+      "requires": {
+        "rx-lite": "*"
+      }
+    },
     "rxjs": {
       "version": "6.2.1",
       "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-6.2.1.tgz",
@@ -11370,6 +12470,15 @@
       "integrity": "sha1-xB8vbDn8FtHNF61LXYlhFK5HDVU=",
       "dev": true
     },
+    "slice-ansi": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-1.0.0.tgz",
+      "integrity": "sha512-POqxBK6Lb3q6s047D/XsDVNPnF9Dl8JSaqe9h9lURl0OdNqy/ujDrOiIHtsqXMGbWWTIomRzAMaTyawAU//Reg==",
+      "dev": true,
+      "requires": {
+        "is-fullwidth-code-point": "^2.0.0"
+      }
+    },
     "snapdragon": {
       "version": "0.8.2",
       "resolved": "https://registry.npmjs.org/snapdragon/-/snapdragon-0.8.2.tgz",
@@ -11521,6 +12630,38 @@
       "integrity": "sha1-PpNdfd1zYxuXZZlW1VEo6HtQhKM=",
       "dev": true
     },
+    "spdx-correct": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.0.0.tgz",
+      "integrity": "sha512-N19o9z5cEyc8yQQPukRCZ9EUmb4HUpnrmaL/fxS2pBo2jbfcFRVuFZ/oFC+vZz0MNNk0h80iMn5/S6qGZOL5+g==",
+      "dev": true,
+      "requires": {
+        "spdx-expression-parse": "^3.0.0",
+        "spdx-license-ids": "^3.0.0"
+      }
+    },
+    "spdx-exceptions": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.1.0.tgz",
+      "integrity": "sha512-4K1NsmrlCU1JJgUrtgEeTVyfx8VaYea9J9LvARxhbHtVtohPs/gFGG5yy49beySjlIMhhXZ4QqujIZEfS4l6Cg==",
+      "dev": true
+    },
+    "spdx-expression-parse": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.0.tgz",
+      "integrity": "sha512-Yg6D3XpRD4kkOmTpdgbUiEJFKghJH03fiC1OPll5h/0sO6neh2jqRDVHOQ4o/LMea0tgCkbMgea5ip/e+MkWyg==",
+      "dev": true,
+      "requires": {
+        "spdx-exceptions": "^2.1.0",
+        "spdx-license-ids": "^3.0.0"
+      }
+    },
+    "spdx-license-ids": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.0.tgz",
+      "integrity": "sha512-2+EPwgbnmOIl8HjGBXXMd9NAu02vLjOO1nWw4kmeRDFyHn+M/ETfHxQUK0oXg8ctgVnl9t3rosNVsZ1jG61nDA==",
+      "dev": true
+    },
     "split-string": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/split-string/-/split-string-3.1.0.tgz",
@@ -11656,12 +12797,24 @@
         "ansi-regex": "^2.0.0"
       }
     },
+    "strip-bom": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz",
+      "integrity": "sha1-IzTBjpx1n3vdVv3vfprj1YjmjtM=",
+      "dev": true
+    },
     "strip-eof": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/strip-eof/-/strip-eof-1.0.0.tgz",
       "integrity": "sha1-u0P/VZim6wXYm1n80SnJgzE2Br8=",
       "dev": true
     },
+    "strip-json-comments": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
+      "integrity": "sha1-PFMZQukIwml8DsNEhYwobHygpgo=",
+      "dev": true
+    },
     "style-loader": {
       "version": "0.21.0",
       "resolved": "https://registry.npmjs.org/style-loader/-/style-loader-0.21.0.tgz",
@@ -11705,6 +12858,87 @@
         }
       }
     },
+    "table": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/table/-/table-4.0.2.tgz",
+      "integrity": "sha512-UUkEAPdSGxtRpiV9ozJ5cMTtYiqz7Ni1OGqLXRCynrvzdtR1p+cfOWe2RJLwvUG8hNanaSRjecIqwOjqeatDsA==",
+      "dev": true,
+      "requires": {
+        "ajv": "^5.2.3",
+        "ajv-keywords": "^2.1.0",
+        "chalk": "^2.1.0",
+        "lodash": "^4.17.4",
+        "slice-ansi": "1.0.0",
+        "string-width": "^2.1.1"
+      },
+      "dependencies": {
+        "ajv": {
+          "version": "5.5.2",
+          "resolved": "https://registry.npmjs.org/ajv/-/ajv-5.5.2.tgz",
+          "integrity": "sha1-c7Xuyj+rZT49P5Qis0GtQiBdyWU=",
+          "dev": true,
+          "requires": {
+            "co": "^4.6.0",
+            "fast-deep-equal": "^1.0.0",
+            "fast-json-stable-stringify": "^2.0.0",
+            "json-schema-traverse": "^0.3.0"
+          }
+        },
+        "ajv-keywords": {
+          "version": "2.1.1",
+          "resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-2.1.1.tgz",
+          "integrity": "sha1-YXmX/F9gV2iUxDX5QNgZ4TW4B2I=",
+          "dev": true
+        },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+          "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+          "dev": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.1.tgz",
+          "integrity": "sha512-ObN6h1v2fTJSmUXoS3nMQ92LbDK9be4TV+6G+omQlGJFdcUX5heKi1LZ1YnRMIgwTLEj3E24bT6tYni50rlCfQ==",
+          "dev": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
+        "fast-deep-equal": {
+          "version": "1.1.0",
+          "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-1.1.0.tgz",
+          "integrity": "sha1-wFNHeBfIa1HaqFPIHgWbcz0CNhQ=",
+          "dev": true
+        },
+        "has-flag": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+          "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
+          "dev": true
+        },
+        "json-schema-traverse": {
+          "version": "0.3.1",
+          "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.3.1.tgz",
+          "integrity": "sha1-NJptRMU6Ud6JtAgFxdXlm0F9M0A=",
+          "dev": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.4.0.tgz",
+          "integrity": "sha512-zjaXglF5nnWpsq470jSv6P9DwPvgLkuapYmfDm3JWOm0vkNTVF2tI4UrN2r6jH1qM/uc/WtxYY1hYoA2dOKj5w==",
+          "dev": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        }
+      }
+    },
     "tapable": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/tapable/-/tapable-1.0.0.tgz",
@@ -12079,6 +13313,16 @@
       "integrity": "sha512-qNdTUMaCjPs4eEnM3W9H94R3sU70YCuT+/ST7nUf+id1bVOrdjrpUaeZLqPBPRph3hsgn4a4BvwpxhHZx+oSDg==",
       "dev": true
     },
+    "validate-npm-package-license": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.3.tgz",
+      "integrity": "sha512-63ZOUnL4SIXj4L0NixR3L1lcjO38crAbgrTpl28t8jjrfuiOBL5Iygm+60qPs/KsZGzPNg6Smnc/oY16QTjF0g==",
+      "dev": true,
+      "requires": {
+        "spdx-correct": "^3.0.0",
+        "spdx-expression-parse": "^3.0.0"
+      }
+    },
     "vendors": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/vendors/-/vendors-1.0.2.tgz",
@@ -12405,6 +13649,15 @@
       "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=",
       "dev": true
     },
+    "write": {
+      "version": "0.2.1",
+      "resolved": "https://registry.npmjs.org/write/-/write-0.2.1.tgz",
+      "integrity": "sha1-X8A4KOJkzqP+kUVUdvejxWbLB1c=",
+      "dev": true,
+      "requires": {
+        "mkdirp": "^0.5.1"
+      }
+    },
     "xtend": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz",
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index a996498c2df5e..0608e9a504cd9 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -4,7 +4,9 @@
     "test": "echo \"Error: no test specified\" && exit 1",
     "dev": "NODE_ENV=dev webpack --watch --colors --progress --debug --output-pathinfo --devtool eval-cheap-source-map --mode development",
     "prod": "NODE_ENV=production node --max_old_space_size=4096 ./node_modules/webpack/bin/webpack.js -p --colors --progress",
-    "build": "NODE_ENV=production webpack --colors --progress"
+    "build": "NODE_ENV=production webpack --colors --progress",
+    "lint": "eslint --ignore-path=.eslintignore --ext .js,.html .",
+    "lint:fix": "eslint --fix --ignore-path=.eslintignore --ext .js,.html ."
   },
   "author": "Apache",
   "license": "Apache-2.0",
@@ -26,6 +28,7 @@
   "devDependencies": {
     "babel": "^6.23.0",
     "babel-core": "^6.26.3",
+    "babel-eslint": "^8.2.6",
     "babel-istanbul": "^0.12.2",
     "babel-loader": "^7.1.4",
     "babel-plugin-css-modules-transform": "^1.6.1",
@@ -33,6 +36,13 @@
     "clean-webpack-plugin": "^0.1.19",
     "copy-webpack-plugin": "^4.5.2",
     "css-loader": "^0.28.11",
+    "eslint": "^4.19.1",
+    "eslint-config-airbnb-base": "^13.0.0",
+    "eslint-plugin-html": "^4.0.5",
+    "eslint-plugin-import": "^2.13.0",
+    "eslint-plugin-node": "^7.0.1",
+    "eslint-plugin-promise": "^3.8.0",
+    "eslint-plugin-standard": "^3.1.0",
     "file-loader": "^1.1.11",
     "imports-loader": "^0.8.0",
     "mini-css-extract-plugin": "^0.4.1",
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index 16c80ba84e421..f04d1d9949cf2 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -22,7 +22,7 @@ const path = require('path');
 const ManifestPlugin = require('webpack-manifest-plugin');
 const CleanWebpackPlugin = require('clean-webpack-plugin');
 const CopyWebpackPlugin = require('copy-webpack-plugin');
-const MiniCssExtractPlugin = require("mini-css-extract-plugin");
+const MiniCssExtractPlugin = require('mini-css-extract-plugin');
 
 // Input Directory (airflow/www_rbac)
 // noinspection JSUnresolvedVariable
@@ -34,13 +34,13 @@ const BUILD_DIR = path.resolve(__dirname, './static/dist');
 
 const config = {
   entry: {
-    connectionForm: STATIC_DIR + '/js/connection_form.js',
-    clock: STATIC_DIR + '/js/clock.js',
-    ganttChartD3v2: STATIC_DIR + '/js/gantt-chart-d3v2.js',
+    connectionForm: `${STATIC_DIR}/js/connection_form.js`,
+    clock: `${STATIC_DIR}/js/clock.js`,
+    ganttChartD3v2: `${STATIC_DIR}/js/gantt-chart-d3v2.js`,
     styleBundle: [
-      STATIC_DIR + '/css/main.css',
-      STATIC_DIR + '/css/bootstrap-theme.css'
-      ]
+      `${STATIC_DIR}/css/main.css`,
+      `${STATIC_DIR}/css/bootstrap-theme.css`,
+    ],
   },
   output: {
     path: BUILD_DIR,
@@ -71,8 +71,8 @@ const config = {
         include: STATIC_DIR,
         use: [
           MiniCssExtractPlugin.loader,
-          "css-loader"
-        ]
+          'css-loader',
+        ],
       },
       /* for css linking images */
       {
@@ -96,12 +96,12 @@ const config = {
         test: /\.(ttf|eot|svg)(\?v=[0-9]\.[0-9]\.[0-9])?$/,
         loader: 'file-loader',
       },
-    ]
+    ],
   },
   plugins: [
     new ManifestPlugin(),
     new CleanWebpackPlugin(['static/dist']),
-    new MiniCssExtractPlugin({filename: '[name].[chunkhash].css'}),
+    new MiniCssExtractPlugin({ filename: '[name].[chunkhash].css' }),
     new webpack.DefinePlugin({
       'process.env': {
         NODE_ENV: JSON.stringify(process.env.NODE_ENV),
@@ -111,17 +111,19 @@ const config = {
     // this seems like an efficient solution for now. Will update that once
     // we'll have the dependencies imported within the custom JS
     new CopyWebpackPlugin([
-      {from: 'node_modules/nvd3/build/\*.min.\*',flatten:true},
+      { from: 'node_modules/nvd3/build/*.min.*', flatten: true },
       // Update this when upgrade d3 package, as the path in new D3 is different
-      {from: 'node_modules/d3/d3.min.\*', flatten:true},
-      {from: 'node_modules/dagre-d3/dist/\*.min.\*', flatten:true},
-      {from: 'node_modules/d3-tip/dist/index.js', to:'d3-tip.js', flatten:true},
-      {from: 'node_modules/bootstrap-3-typeahead/\*min.\*', flatten:true},
-      {from: 'node_modules/bootstrap-toggle/**/*bootstrap-toggle.min.\*',
-        flatten:true},
-      {from: 'node_modules/datatables.net/**/*\*.min.\*',flatten:true},
-      {from: 'node_modules/datatables.net-bs/**/*\*.min.\*',flatten:true},
-    ], {copyUnmodified: true})
+      { from: 'node_modules/d3/d3.min.*', flatten: true },
+      { from: 'node_modules/dagre-d3/dist/*.min.*', flatten: true },
+      { from: 'node_modules/d3-tip/dist/index.js', to: 'd3-tip.js', flatten: true },
+      { from: 'node_modules/bootstrap-3-typeahead/*min.*', flatten: true },
+      {
+        from: 'node_modules/bootstrap-toggle/**/*bootstrap-toggle.min.*',
+        flatten: true,
+      },
+      { from: 'node_modules/datatables.net/**/**.min.*', flatten: true },
+      { from: 'node_modules/datatables.net-bs/**/**.min.*', flatten: true },
+    ], { copyUnmodified: true }),
   ],
 };
 

From dc3d7670721b47a363744181b6a0b2656f8e0a0e Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Fri, 3 Aug 2018 14:07:50 +0200
Subject: [PATCH 450/808] [AIRFLOW-2805] Display multiple timezones on UI
 (#3687)

---
 LICENSE                                       |    1 +
 airflow/www_rbac/package-lock.json            | 5978 +++++------------
 airflow/www_rbac/package.json                 |    7 +-
 airflow/www_rbac/static/js/clock.js           |   33 +-
 airflow/www_rbac/static/js/datetime-utils.js  |   60 +
 airflow/www_rbac/static/js/graph.js           |   74 +
 airflow/www_rbac/static/js/jqClock.min.js     |   27 -
 airflow/www_rbac/templates/airflow/dag.html   |    1 +
 airflow/www_rbac/templates/airflow/graph.html |   64 +-
 airflow/www_rbac/webpack.config.js            |    8 +-
 licenses/LICENSE-moment.txt                   |   22 +
 11 files changed, 2031 insertions(+), 4244 deletions(-)
 create mode 100644 airflow/www_rbac/static/js/datetime-utils.js
 create mode 100644 airflow/www_rbac/static/js/graph.js
 delete mode 100644 airflow/www_rbac/static/js/jqClock.min.js
 create mode 100644 licenses/LICENSE-moment.txt

diff --git a/LICENSE b/LICENSE
index 7f2532df77c07..debddc0d7bb79 100644
--- a/LICENSE
+++ b/LICENSE
@@ -239,6 +239,7 @@ The text of each license is also included at licenses/LICENSE-[project].txt.
     (MIT License) Bootstrap Toggle v2.2.0 (http://www.bootstraptoggle.com)
     (MIT License) normalize.css v3.0.2 (http://necolas.github.io/normalize.css/)
     (MIT License) ElasticMock v1.3.2 (https://github.com/vrcmarcos/elasticmock)
+    (MIT License) MomentJS v2.22.2 (http://momentjs.com/)
 
 ========================================================================
 BSD 2-Clause licenses
diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index 7038c4e5a62ec..2e75cf9ec40d9 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -1215,14 +1215,15 @@
       }
     },
     "browserify-des": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.1.tgz",
-      "integrity": "sha512-zy0Cobe3hhgpiOM32Tj7KQ3Vl91m0njwsjzZQK1L+JDf11dzP9qIvjreVinsvXrgfjhStXwUWAEpB9D7Gwmayw==",
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/browserify-des/-/browserify-des-1.0.2.tgz",
+      "integrity": "sha512-BioO1xf3hFwz4kc6iBhI3ieDFompMhrMlnDFC4/0/vd5MokpuAc3R+LYbwTA9A5Yc9pq9UYPqffKpW2ObuwX5A==",
       "dev": true,
       "requires": {
         "cipher-base": "^1.0.1",
         "des.js": "^1.0.0",
-        "inherits": "^2.0.1"
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.1.2"
       }
     },
     "browserify-rsa": {
@@ -4002,9 +4003,9 @@
       }
     },
     "get-caller-file": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-1.0.2.tgz",
-      "integrity": "sha1-9wLmMSfn4jHBYKgMFVSstw1QR+U=",
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-1.0.3.tgz",
+      "integrity": "sha512-3t6rVToeoZfYSGd8YoLFR2DJkiQrIiUrGcjvFX2mDw3bn6k2OtwHN0TNCLbBO+w8qTvimhDkv+LSscbJY1vE6w==",
       "dev": true
     },
     "get-stream": {
@@ -4060,9 +4061,9 @@
       "dev": true
     },
     "global-modules-path": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/global-modules-path/-/global-modules-path-2.1.0.tgz",
-      "integrity": "sha512-3DrmGj2TP+96cABk9TfMp6f3knH/Y46dqvWznTU3Tf6/bDGLDAn15tFluQ7BcloykOcdY16U0WGq0BQblYOxJQ==",
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/global-modules-path/-/global-modules-path-2.3.0.tgz",
+      "integrity": "sha512-HchvMJNYh9dGSCy8pOQ2O8u/hoXaL+0XhnrwH0RyLiSXMMTl9W3N6KUU73+JFOg5PGjtzl6VZzUQsnrpm7Szag==",
       "dev": true
     },
     "globals": {
@@ -5197,6 +5198,19 @@
         "minimist": "0.0.8"
       }
     },
+    "moment": {
+      "version": "2.22.2",
+      "resolved": "https://registry.npmjs.org/moment/-/moment-2.22.2.tgz",
+      "integrity": "sha1-PCV/mDn8DpP/UxSWMiOeuQeD/2Y="
+    },
+    "moment-timezone": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/moment-timezone/-/moment-timezone-0.5.21.tgz",
+      "integrity": "sha512-j96bAh4otsgj3lKydm3K7kdtA3iKf2m6MY2iSYCzCm5a1zmHo1g+aK3068dDEeocLZQIS9kU8bsdQHLqEvgW0A==",
+      "requires": {
+        "moment": ">= 2.9.0"
+      }
+    },
     "move-concurrently": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/move-concurrently/-/move-concurrently-1.0.1.tgz",
@@ -5388,13 +5402,12 @@
       }
     },
     "npm": {
-      "version": "6.1.0",
-      "resolved": "https://registry.npmjs.org/npm/-/npm-6.1.0.tgz",
-      "integrity": "sha512-e38cCtJ0lEjLXXpc4twEfj8Xw5hDLolc2Py87ueWnUhJfZ8GA/5RVIeD+XbSr1+aVRGsRsdtLdzUNO63PvQJ1w==",
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/npm/-/npm-6.3.0.tgz",
+      "integrity": "sha512-oDtLFo3wXue/xe3pU/oks9VHS5501OAWlYrZrApZkFv7l2LXk+9CfPMbjbfZWK7Jqlc1jbNcJMkB6KZC7K/vEA==",
       "requires": {
-        "JSONStream": "^1.3.2",
+        "JSONStream": "^1.3.3",
         "abbrev": "~1.1.1",
-        "ansi-regex": "~3.0.0",
         "ansicolors": "~0.3.2",
         "ansistyles": "~0.1.3",
         "aproba": "~1.2.0",
@@ -5402,11 +5415,11 @@
         "bin-links": "^1.1.2",
         "bluebird": "~3.5.1",
         "byte-size": "^4.0.3",
-        "cacache": "^11.0.2",
+        "cacache": "^11.1.0",
         "call-limit": "~1.1.0",
         "chownr": "~1.0.1",
         "cli-columns": "^3.1.2",
-        "cli-table2": "~0.2.0",
+        "cli-table3": "^0.5.0",
         "cmd-shim": "~2.0.2",
         "columnify": "~1.5.4",
         "config-chain": "~1.1.11",
@@ -5415,7 +5428,7 @@
         "detect-newline": "^2.1.0",
         "dezalgo": "~1.0.3",
         "editor": "~1.0.0",
-        "figgy-pudding": "^3.1.0",
+        "figgy-pudding": "^3.2.0",
         "find-npm-prefix": "^1.0.2",
         "fs-vacuum": "~1.2.10",
         "fs-write-stream-atomic": "~1.0.10",
@@ -5430,10 +5443,10 @@
         "inherits": "~2.0.3",
         "ini": "^1.3.5",
         "init-package-json": "^1.10.3",
-        "is-cidr": "^2.0.5",
+        "is-cidr": "^2.0.6",
         "json-parse-better-errors": "^1.0.2",
         "lazy-property": "~1.0.0",
-        "libcipm": "^1.6.2",
+        "libcipm": "^2.0.0",
         "libnpmhook": "^4.0.1",
         "libnpx": "^10.2.0",
         "lock-verify": "^2.0.2",
@@ -5454,17 +5467,17 @@
         "mississippi": "^3.0.0",
         "mkdirp": "~0.5.1",
         "move-concurrently": "^1.0.1",
-        "node-gyp": "^3.6.2",
+        "node-gyp": "^3.7.0",
         "nopt": "~4.0.1",
         "normalize-package-data": "~2.4.0",
-        "npm-audit-report": "^1.2.1",
+        "npm-audit-report": "^1.3.1",
         "npm-cache-filename": "~1.0.2",
         "npm-install-checks": "~3.0.0",
         "npm-lifecycle": "^2.0.3",
         "npm-package-arg": "^6.1.0",
         "npm-packlist": "~1.1.10",
         "npm-pick-manifest": "^2.1.0",
-        "npm-profile": "^3.0.1",
+        "npm-profile": "^3.0.2",
         "npm-registry-client": "^8.5.1",
         "npm-registry-fetch": "^1.1.0",
         "npm-user-validate": "~1.0.0",
@@ -5472,7 +5485,7 @@
         "once": "~1.4.0",
         "opener": "~1.4.3",
         "osenv": "^0.1.5",
-        "pacote": "^8.1.5",
+        "pacote": "^8.1.6",
         "path-is-inside": "~1.0.2",
         "promise-inflight": "~1.0.1",
         "qrcode-terminal": "^0.12.0",
@@ -5485,7 +5498,7 @@
         "read-package-tree": "^5.2.1",
         "readable-stream": "^2.3.6",
         "readdir-scoped-modules": "*",
-        "request": "^2.86.0",
+        "request": "^2.81.0",
         "retry": "^0.12.0",
         "rimraf": "~2.6.2",
         "safe-buffer": "^5.1.2",
@@ -5495,8 +5508,8 @@
         "sorted-object": "~2.0.1",
         "sorted-union-stream": "~2.1.3",
         "ssri": "^6.0.0",
-        "strip-ansi": "~4.0.0",
-        "tar": "^4.4.1",
+        "stringify-package": "^1.0.0",
+        "tar": "^4.4.4",
         "text-table": "~0.2.0",
         "tiny-relative-date": "^1.3.0",
         "uid-number": "0.0.6",
@@ -5504,41 +5517,58 @@
         "unique-filename": "~1.1.0",
         "unpipe": "~1.0.0",
         "update-notifier": "^2.5.0",
-        "uuid": "^3.2.1",
+        "uuid": "^3.3.2",
         "validate-npm-package-license": "^3.0.3",
         "validate-npm-package-name": "~3.0.0",
-        "which": "~1.3.0",
+        "which": "^1.3.1",
         "worker-farm": "^1.6.0",
-        "wrappy": "~1.0.2",
         "write-file-atomic": "^2.3.0"
       },
       "dependencies": {
         "JSONStream": {
-          "version": "1.3.2",
+          "version": "1.3.3",
           "bundled": true,
           "requires": {
             "jsonparse": "^1.2.0",
             "through": ">=2.2.7 <3"
-          },
-          "dependencies": {
-            "jsonparse": {
-              "version": "1.3.1",
-              "bundled": true
-            },
-            "through": {
-              "version": "2.3.8",
-              "bundled": true
-            }
           }
         },
         "abbrev": {
           "version": "1.1.1",
           "bundled": true
         },
+        "agent-base": {
+          "version": "4.2.0",
+          "bundled": true,
+          "requires": {
+            "es6-promisify": "^5.0.0"
+          }
+        },
+        "agentkeepalive": {
+          "version": "3.4.1",
+          "bundled": true,
+          "requires": {
+            "humanize-ms": "^1.2.1"
+          }
+        },
+        "ansi-align": {
+          "version": "2.0.0",
+          "bundled": true,
+          "requires": {
+            "string-width": "^2.0.0"
+          }
+        },
         "ansi-regex": {
-          "version": "3.0.0",
+          "version": "2.1.1",
           "bundled": true
         },
+        "ansi-styles": {
+          "version": "3.2.1",
+          "bundled": true,
+          "requires": {
+            "color-convert": "^1.9.0"
+          }
+        },
         "ansicolors": {
           "version": "0.3.2",
           "bundled": true
@@ -5555,6 +5585,50 @@
           "version": "1.0.0",
           "bundled": true
         },
+        "are-we-there-yet": {
+          "version": "1.1.4",
+          "bundled": true,
+          "requires": {
+            "delegates": "^1.0.0",
+            "readable-stream": "^2.0.6"
+          }
+        },
+        "asap": {
+          "version": "2.0.6",
+          "bundled": true
+        },
+        "asn1": {
+          "version": "0.2.3",
+          "bundled": true
+        },
+        "assert-plus": {
+          "version": "0.2.0",
+          "bundled": true
+        },
+        "asynckit": {
+          "version": "0.4.0",
+          "bundled": true
+        },
+        "aws-sign2": {
+          "version": "0.6.0",
+          "bundled": true
+        },
+        "aws4": {
+          "version": "1.7.0",
+          "bundled": true
+        },
+        "balanced-match": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "bcrypt-pbkdf": {
+          "version": "1.0.2",
+          "bundled": true,
+          "optional": true,
+          "requires": {
+            "tweetnacl": "^0.14.3"
+          }
+        },
         "bin-links": {
           "version": "1.1.2",
           "bundled": true,
@@ -5566,16 +5640,67 @@
             "write-file-atomic": "^2.3.0"
           }
         },
+        "block-stream": {
+          "version": "0.0.9",
+          "bundled": true,
+          "requires": {
+            "inherits": "~2.0.0"
+          }
+        },
         "bluebird": {
           "version": "3.5.1",
           "bundled": true
         },
+        "boom": {
+          "version": "2.10.1",
+          "bundled": true,
+          "requires": {
+            "hoek": "2.x.x"
+          }
+        },
+        "boxen": {
+          "version": "1.3.0",
+          "bundled": true,
+          "requires": {
+            "ansi-align": "^2.0.0",
+            "camelcase": "^4.0.0",
+            "chalk": "^2.0.1",
+            "cli-boxes": "^1.0.0",
+            "string-width": "^2.0.0",
+            "term-size": "^1.2.0",
+            "widest-line": "^2.0.0"
+          }
+        },
+        "brace-expansion": {
+          "version": "1.1.11",
+          "bundled": true,
+          "requires": {
+            "balanced-match": "^1.0.0",
+            "concat-map": "0.0.1"
+          }
+        },
+        "buffer-from": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "builtin-modules": {
+          "version": "1.1.1",
+          "bundled": true
+        },
+        "builtins": {
+          "version": "1.0.3",
+          "bundled": true
+        },
+        "byline": {
+          "version": "5.0.0",
+          "bundled": true
+        },
         "byte-size": {
           "version": "4.0.3",
           "bundled": true
         },
         "cacache": {
-          "version": "11.0.2",
+          "version": "11.1.0",
           "bundled": true,
           "requires": {
             "bluebird": "^3.5.1",
@@ -5583,7 +5708,7 @@
             "figgy-pudding": "^3.1.0",
             "glob": "^7.1.2",
             "graceful-fs": "^4.1.11",
-            "lru-cache": "^4.1.2",
+            "lru-cache": "^4.1.3",
             "mississippi": "^3.0.0",
             "mkdirp": "^0.5.1",
             "move-concurrently": "^1.0.1",
@@ -5592,127 +5717,95 @@
             "ssri": "^6.0.0",
             "unique-filename": "^1.1.0",
             "y18n": "^4.0.0"
-          },
-          "dependencies": {
-            "y18n": {
-              "version": "4.0.0",
-              "bundled": true
-            }
           }
         },
         "call-limit": {
           "version": "1.1.0",
           "bundled": true
         },
+        "camelcase": {
+          "version": "4.1.0",
+          "bundled": true
+        },
+        "capture-stack-trace": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "caseless": {
+          "version": "0.12.0",
+          "bundled": true
+        },
+        "chalk": {
+          "version": "2.4.1",
+          "bundled": true,
+          "requires": {
+            "ansi-styles": "^3.2.1",
+            "escape-string-regexp": "^1.0.5",
+            "supports-color": "^5.3.0"
+          }
+        },
         "chownr": {
           "version": "1.0.1",
           "bundled": true
         },
+        "ci-info": {
+          "version": "1.1.3",
+          "bundled": true
+        },
+        "cidr-regex": {
+          "version": "2.0.9",
+          "bundled": true,
+          "requires": {
+            "ip-regex": "^2.1.0"
+          }
+        },
+        "cli-boxes": {
+          "version": "1.0.0",
+          "bundled": true
+        },
         "cli-columns": {
           "version": "3.1.2",
           "bundled": true,
           "requires": {
             "string-width": "^2.0.0",
             "strip-ansi": "^3.0.1"
-          },
-          "dependencies": {
-            "string-width": {
-              "version": "2.1.1",
-              "bundled": true,
-              "requires": {
-                "is-fullwidth-code-point": "^2.0.0",
-                "strip-ansi": "^4.0.0"
-              },
-              "dependencies": {
-                "is-fullwidth-code-point": {
-                  "version": "2.0.0",
-                  "bundled": true
-                },
-                "strip-ansi": {
-                  "version": "4.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "ansi-regex": "^3.0.0"
-                  }
-                }
-              }
-            },
-            "strip-ansi": {
-              "version": "3.0.1",
-              "bundled": true,
-              "requires": {
-                "ansi-regex": "^2.0.0"
-              },
-              "dependencies": {
-                "ansi-regex": {
-                  "version": "2.1.1",
-                  "bundled": true
-                }
-              }
-            }
           }
         },
-        "cli-table2": {
-          "version": "0.2.0",
+        "cli-table3": {
+          "version": "0.5.0",
           "bundled": true,
           "requires": {
             "colors": "^1.1.2",
-            "lodash": "^3.10.1",
-            "string-width": "^1.0.1"
+            "object-assign": "^4.1.0",
+            "string-width": "^2.1.1"
+          }
+        },
+        "cliui": {
+          "version": "4.1.0",
+          "bundled": true,
+          "requires": {
+            "string-width": "^2.1.1",
+            "strip-ansi": "^4.0.0",
+            "wrap-ansi": "^2.0.0"
           },
           "dependencies": {
-            "colors": {
-              "version": "1.1.2",
-              "bundled": true,
-              "optional": true
-            },
-            "lodash": {
-              "version": "3.10.1",
+            "ansi-regex": {
+              "version": "3.0.0",
               "bundled": true
             },
-            "string-width": {
-              "version": "1.0.2",
+            "strip-ansi": {
+              "version": "4.0.0",
               "bundled": true,
               "requires": {
-                "code-point-at": "^1.0.0",
-                "is-fullwidth-code-point": "^1.0.0",
-                "strip-ansi": "^3.0.0"
-              },
-              "dependencies": {
-                "code-point-at": {
-                  "version": "1.1.0",
-                  "bundled": true
-                },
-                "is-fullwidth-code-point": {
-                  "version": "1.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "number-is-nan": "^1.0.0"
-                  },
-                  "dependencies": {
-                    "number-is-nan": {
-                      "version": "1.0.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "strip-ansi": {
-                  "version": "3.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "ansi-regex": "^2.0.0"
-                  },
-                  "dependencies": {
-                    "ansi-regex": {
-                      "version": "2.1.1",
-                      "bundled": true
-                    }
-                  }
-                }
+                "ansi-regex": "^3.0.0"
               }
             }
           }
         },
+        "clone": {
+          "version": "1.0.4",
+          "bundled": true
+        },
         "cmd-shim": {
           "version": "2.0.2",
           "bundled": true,
@@ -5721,68 +5814,192 @@
             "mkdirp": "~0.5.0"
           }
         },
+        "co": {
+          "version": "4.6.0",
+          "bundled": true
+        },
+        "code-point-at": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "color-convert": {
+          "version": "1.9.1",
+          "bundled": true,
+          "requires": {
+            "color-name": "^1.1.1"
+          }
+        },
+        "color-name": {
+          "version": "1.1.3",
+          "bundled": true
+        },
+        "colors": {
+          "version": "1.3.0",
+          "bundled": true,
+          "optional": true
+        },
         "columnify": {
           "version": "1.5.4",
           "bundled": true,
           "requires": {
             "strip-ansi": "^3.0.0",
             "wcwidth": "^1.0.0"
-          },
-          "dependencies": {
-            "strip-ansi": {
-              "version": "3.0.1",
-              "bundled": true,
-              "requires": {
-                "ansi-regex": "^2.0.0"
-              },
-              "dependencies": {
-                "ansi-regex": {
-                  "version": "2.1.1",
-                  "bundled": true
-                }
-              }
-            },
-            "wcwidth": {
-              "version": "1.0.1",
-              "bundled": true,
-              "requires": {
-                "defaults": "^1.0.3"
-              },
-              "dependencies": {
-                "defaults": {
-                  "version": "1.0.3",
-                  "bundled": true,
-                  "requires": {
-                    "clone": "^1.0.2"
-                  },
-                  "dependencies": {
-                    "clone": {
-                      "version": "1.0.2",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            }
           }
         },
-        "config-chain": {
-          "version": "1.1.11",
+        "combined-stream": {
+          "version": "1.0.6",
           "bundled": true,
           "requires": {
-            "ini": "^1.3.4",
-            "proto-list": "~1.2.1"
-          },
-          "dependencies": {
-            "proto-list": {
-              "version": "1.2.4",
-              "bundled": true
-            }
+            "delayed-stream": "~1.0.0"
           }
         },
-        "debuglog": {
-          "version": "1.0.1",
-          "bundled": true
+        "concat-map": {
+          "version": "0.0.1",
+          "bundled": true
+        },
+        "concat-stream": {
+          "version": "1.6.2",
+          "bundled": true,
+          "requires": {
+            "buffer-from": "^1.0.0",
+            "inherits": "^2.0.3",
+            "readable-stream": "^2.2.2",
+            "typedarray": "^0.0.6"
+          }
+        },
+        "config-chain": {
+          "version": "1.1.11",
+          "bundled": true,
+          "requires": {
+            "ini": "^1.3.4",
+            "proto-list": "~1.2.1"
+          }
+        },
+        "configstore": {
+          "version": "3.1.2",
+          "bundled": true,
+          "requires": {
+            "dot-prop": "^4.1.0",
+            "graceful-fs": "^4.1.2",
+            "make-dir": "^1.0.0",
+            "unique-string": "^1.0.0",
+            "write-file-atomic": "^2.0.0",
+            "xdg-basedir": "^3.0.0"
+          }
+        },
+        "console-control-strings": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "copy-concurrently": {
+          "version": "1.0.5",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.1.1",
+            "fs-write-stream-atomic": "^1.0.8",
+            "iferr": "^0.1.5",
+            "mkdirp": "^0.5.1",
+            "rimraf": "^2.5.4",
+            "run-queue": "^1.0.0"
+          },
+          "dependencies": {
+            "iferr": {
+              "version": "0.1.5",
+              "bundled": true
+            }
+          }
+        },
+        "core-util-is": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "create-error-class": {
+          "version": "3.0.2",
+          "bundled": true,
+          "requires": {
+            "capture-stack-trace": "^1.0.0"
+          }
+        },
+        "cross-spawn": {
+          "version": "5.1.0",
+          "bundled": true,
+          "requires": {
+            "lru-cache": "^4.0.1",
+            "shebang-command": "^1.2.0",
+            "which": "^1.2.9"
+          }
+        },
+        "cryptiles": {
+          "version": "2.0.5",
+          "bundled": true,
+          "requires": {
+            "boom": "2.x.x"
+          }
+        },
+        "crypto-random-string": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "cyclist": {
+          "version": "0.2.2",
+          "bundled": true
+        },
+        "dashdash": {
+          "version": "1.14.1",
+          "bundled": true,
+          "requires": {
+            "assert-plus": "^1.0.0"
+          },
+          "dependencies": {
+            "assert-plus": {
+              "version": "1.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "debug": {
+          "version": "3.1.0",
+          "bundled": true,
+          "requires": {
+            "ms": "2.0.0"
+          },
+          "dependencies": {
+            "ms": {
+              "version": "2.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "debuglog": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "decamelize": {
+          "version": "1.2.0",
+          "bundled": true
+        },
+        "decode-uri-component": {
+          "version": "0.2.0",
+          "bundled": true
+        },
+        "deep-extend": {
+          "version": "0.5.1",
+          "bundled": true
+        },
+        "defaults": {
+          "version": "1.0.3",
+          "bundled": true,
+          "requires": {
+            "clone": "^1.0.2"
+          }
+        },
+        "delayed-stream": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "delegates": {
+          "version": "1.0.0",
+          "bundled": true
         },
         "detect-indent": {
           "version": "5.0.0",
@@ -5798,26 +6015,157 @@
           "requires": {
             "asap": "^2.0.0",
             "wrappy": "1"
-          },
-          "dependencies": {
-            "asap": {
-              "version": "2.0.5",
-              "bundled": true
-            }
+          }
+        },
+        "dot-prop": {
+          "version": "4.2.0",
+          "bundled": true,
+          "requires": {
+            "is-obj": "^1.0.0"
+          }
+        },
+        "dotenv": {
+          "version": "5.0.1",
+          "bundled": true
+        },
+        "duplexer3": {
+          "version": "0.1.4",
+          "bundled": true
+        },
+        "duplexify": {
+          "version": "3.6.0",
+          "bundled": true,
+          "requires": {
+            "end-of-stream": "^1.0.0",
+            "inherits": "^2.0.1",
+            "readable-stream": "^2.0.0",
+            "stream-shift": "^1.0.0"
+          }
+        },
+        "ecc-jsbn": {
+          "version": "0.1.1",
+          "bundled": true,
+          "optional": true,
+          "requires": {
+            "jsbn": "~0.1.0"
           }
         },
         "editor": {
           "version": "1.0.0",
           "bundled": true
         },
+        "encoding": {
+          "version": "0.1.12",
+          "bundled": true,
+          "requires": {
+            "iconv-lite": "~0.4.13"
+          }
+        },
+        "end-of-stream": {
+          "version": "1.4.1",
+          "bundled": true,
+          "requires": {
+            "once": "^1.4.0"
+          }
+        },
+        "err-code": {
+          "version": "1.1.2",
+          "bundled": true
+        },
+        "errno": {
+          "version": "0.1.7",
+          "bundled": true,
+          "requires": {
+            "prr": "~1.0.1"
+          }
+        },
+        "es6-promise": {
+          "version": "4.2.4",
+          "bundled": true
+        },
+        "es6-promisify": {
+          "version": "5.0.0",
+          "bundled": true,
+          "requires": {
+            "es6-promise": "^4.0.3"
+          }
+        },
+        "escape-string-regexp": {
+          "version": "1.0.5",
+          "bundled": true
+        },
+        "execa": {
+          "version": "0.7.0",
+          "bundled": true,
+          "requires": {
+            "cross-spawn": "^5.0.1",
+            "get-stream": "^3.0.0",
+            "is-stream": "^1.1.0",
+            "npm-run-path": "^2.0.0",
+            "p-finally": "^1.0.0",
+            "signal-exit": "^3.0.0",
+            "strip-eof": "^1.0.0"
+          }
+        },
+        "extend": {
+          "version": "3.0.1",
+          "bundled": true
+        },
+        "extsprintf": {
+          "version": "1.3.0",
+          "bundled": true
+        },
         "figgy-pudding": {
-          "version": "3.1.0",
+          "version": "3.2.0",
           "bundled": true
         },
         "find-npm-prefix": {
           "version": "1.0.2",
           "bundled": true
         },
+        "find-up": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "locate-path": "^2.0.0"
+          }
+        },
+        "flush-write-stream": {
+          "version": "1.0.3",
+          "bundled": true,
+          "requires": {
+            "inherits": "^2.0.1",
+            "readable-stream": "^2.0.4"
+          }
+        },
+        "forever-agent": {
+          "version": "0.6.1",
+          "bundled": true
+        },
+        "form-data": {
+          "version": "2.1.4",
+          "bundled": true,
+          "requires": {
+            "asynckit": "^0.4.0",
+            "combined-stream": "^1.0.5",
+            "mime-types": "^2.1.12"
+          }
+        },
+        "from2": {
+          "version": "2.3.0",
+          "bundled": true,
+          "requires": {
+            "inherits": "^2.0.1",
+            "readable-stream": "^2.0.0"
+          }
+        },
+        "fs-minipass": {
+          "version": "1.2.5",
+          "bundled": true,
+          "requires": {
+            "minipass": "^2.2.1"
+          }
+        },
         "fs-vacuum": {
           "version": "1.2.10",
           "bundled": true,
@@ -5843,6 +6191,49 @@
             }
           }
         },
+        "fs.realpath": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "fstream": {
+          "version": "1.0.11",
+          "bundled": true,
+          "requires": {
+            "graceful-fs": "^4.1.2",
+            "inherits": "~2.0.0",
+            "mkdirp": ">=0.5 0",
+            "rimraf": "2"
+          }
+        },
+        "gauge": {
+          "version": "2.7.4",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.0.3",
+            "console-control-strings": "^1.0.0",
+            "has-unicode": "^2.0.0",
+            "object-assign": "^4.1.0",
+            "signal-exit": "^3.0.0",
+            "string-width": "^1.0.1",
+            "strip-ansi": "^3.0.1",
+            "wide-align": "^1.1.0"
+          },
+          "dependencies": {
+            "string-width": {
+              "version": "1.0.2",
+              "bundled": true,
+              "requires": {
+                "code-point-at": "^1.0.0",
+                "is-fullwidth-code-point": "^1.0.0",
+                "strip-ansi": "^3.0.0"
+              }
+            }
+          }
+        },
+        "genfun": {
+          "version": "4.0.1",
+          "bundled": true
+        },
         "gentle-fs": {
           "version": "2.0.1",
           "bundled": true,
@@ -5863,71 +6254,173 @@
             }
           }
         },
-        "glob": {
-          "version": "7.1.2",
+        "get-caller-file": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "get-stream": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "getpass": {
+          "version": "0.1.7",
           "bundled": true,
           "requires": {
-            "fs.realpath": "^1.0.0",
-            "inflight": "^1.0.4",
-            "inherits": "2",
+            "assert-plus": "^1.0.0"
+          },
+          "dependencies": {
+            "assert-plus": {
+              "version": "1.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "glob": {
+          "version": "7.1.2",
+          "bundled": true,
+          "requires": {
+            "fs.realpath": "^1.0.0",
+            "inflight": "^1.0.4",
+            "inherits": "2",
             "minimatch": "^3.0.4",
             "once": "^1.3.0",
             "path-is-absolute": "^1.0.0"
+          }
+        },
+        "global-dirs": {
+          "version": "0.1.1",
+          "bundled": true,
+          "requires": {
+            "ini": "^1.3.4"
+          }
+        },
+        "got": {
+          "version": "6.7.1",
+          "bundled": true,
+          "requires": {
+            "create-error-class": "^3.0.0",
+            "duplexer3": "^0.1.4",
+            "get-stream": "^3.0.0",
+            "is-redirect": "^1.0.0",
+            "is-retry-allowed": "^1.0.0",
+            "is-stream": "^1.0.0",
+            "lowercase-keys": "^1.0.0",
+            "safe-buffer": "^5.0.1",
+            "timed-out": "^4.0.0",
+            "unzip-response": "^2.0.1",
+            "url-parse-lax": "^1.0.0"
+          }
+        },
+        "graceful-fs": {
+          "version": "4.1.11",
+          "bundled": true
+        },
+        "har-schema": {
+          "version": "1.0.5",
+          "bundled": true
+        },
+        "har-validator": {
+          "version": "4.2.1",
+          "bundled": true,
+          "requires": {
+            "ajv": "^4.9.1",
+            "har-schema": "^1.0.5"
           },
           "dependencies": {
-            "fs.realpath": {
-              "version": "1.0.0",
-              "bundled": true
-            },
-            "minimatch": {
-              "version": "3.0.4",
+            "ajv": {
+              "version": "4.11.8",
               "bundled": true,
               "requires": {
-                "brace-expansion": "^1.1.7"
-              },
-              "dependencies": {
-                "brace-expansion": {
-                  "version": "1.1.8",
-                  "bundled": true,
-                  "requires": {
-                    "balanced-match": "^1.0.0",
-                    "concat-map": "0.0.1"
-                  },
-                  "dependencies": {
-                    "balanced-match": {
-                      "version": "1.0.0",
-                      "bundled": true
-                    },
-                    "concat-map": {
-                      "version": "0.0.1",
-                      "bundled": true
-                    }
-                  }
-                }
+                "co": "^4.6.0",
+                "json-stable-stringify": "^1.0.1"
               }
-            },
-            "path-is-absolute": {
-              "version": "1.0.1",
-              "bundled": true
             }
           }
         },
-        "graceful-fs": {
-          "version": "4.1.11",
+        "has-flag": {
+          "version": "3.0.0",
           "bundled": true
         },
         "has-unicode": {
           "version": "2.0.1",
           "bundled": true
         },
+        "hawk": {
+          "version": "3.1.3",
+          "bundled": true,
+          "requires": {
+            "boom": "2.x.x",
+            "cryptiles": "2.x.x",
+            "hoek": "2.x.x",
+            "sntp": "1.x.x"
+          }
+        },
+        "hoek": {
+          "version": "2.16.3",
+          "bundled": true
+        },
         "hosted-git-info": {
           "version": "2.6.0",
           "bundled": true
         },
+        "http-cache-semantics": {
+          "version": "3.8.1",
+          "bundled": true
+        },
+        "http-proxy-agent": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "agent-base": "4",
+            "debug": "3.1.0"
+          }
+        },
+        "http-signature": {
+          "version": "1.1.1",
+          "bundled": true,
+          "requires": {
+            "assert-plus": "^0.2.0",
+            "jsprim": "^1.2.2",
+            "sshpk": "^1.7.0"
+          }
+        },
+        "https-proxy-agent": {
+          "version": "2.2.1",
+          "bundled": true,
+          "requires": {
+            "agent-base": "^4.1.0",
+            "debug": "^3.1.0"
+          }
+        },
+        "humanize-ms": {
+          "version": "1.2.1",
+          "bundled": true,
+          "requires": {
+            "ms": "^2.0.0"
+          }
+        },
+        "iconv-lite": {
+          "version": "0.4.23",
+          "bundled": true,
+          "requires": {
+            "safer-buffer": ">= 2.1.2 < 3"
+          }
+        },
         "iferr": {
           "version": "1.0.0",
           "bundled": true
         },
+        "ignore-walk": {
+          "version": "3.0.1",
+          "bundled": true,
+          "requires": {
+            "minimatch": "^3.0.4"
+          }
+        },
+        "import-lazy": {
+          "version": "2.1.0",
+          "bundled": true
+        },
         "imurmurhash": {
           "version": "0.1.4",
           "bundled": true
@@ -5960,698 +6453,182 @@
             "semver": "2.x || 3.x || 4 || 5",
             "validate-npm-package-license": "^3.0.1",
             "validate-npm-package-name": "^3.0.0"
-          },
-          "dependencies": {
-            "promzard": {
-              "version": "0.3.0",
-              "bundled": true,
-              "requires": {
-                "read": "1"
-              }
-            }
+          }
+        },
+        "invert-kv": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "ip": {
+          "version": "1.1.5",
+          "bundled": true
+        },
+        "ip-regex": {
+          "version": "2.1.0",
+          "bundled": true
+        },
+        "is-builtin-module": {
+          "version": "1.0.0",
+          "bundled": true,
+          "requires": {
+            "builtin-modules": "^1.0.0"
+          }
+        },
+        "is-ci": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "ci-info": "^1.0.0"
           }
         },
         "is-cidr": {
-          "version": "2.0.5",
+          "version": "2.0.6",
           "bundled": true,
           "requires": {
             "cidr-regex": "^2.0.8"
-          },
-          "dependencies": {
-            "cidr-regex": {
-              "version": "2.0.8",
-              "bundled": true,
-              "requires": {
-                "ip-regex": "^2.1.0"
-              },
-              "dependencies": {
-                "ip-regex": {
-                  "version": "2.1.0",
-                  "bundled": true
-                }
-              }
-            }
           }
         },
+        "is-fullwidth-code-point": {
+          "version": "1.0.0",
+          "bundled": true,
+          "requires": {
+            "number-is-nan": "^1.0.0"
+          }
+        },
+        "is-installed-globally": {
+          "version": "0.1.0",
+          "bundled": true,
+          "requires": {
+            "global-dirs": "^0.1.0",
+            "is-path-inside": "^1.0.0"
+          }
+        },
+        "is-npm": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "is-obj": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "is-path-inside": {
+          "version": "1.0.1",
+          "bundled": true,
+          "requires": {
+            "path-is-inside": "^1.0.1"
+          }
+        },
+        "is-redirect": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "is-retry-allowed": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "is-stream": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "is-typedarray": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "isarray": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "isexe": {
+          "version": "2.0.0",
+          "bundled": true
+        },
+        "isstream": {
+          "version": "0.1.2",
+          "bundled": true
+        },
+        "jsbn": {
+          "version": "0.1.1",
+          "bundled": true,
+          "optional": true
+        },
         "json-parse-better-errors": {
           "version": "1.0.2",
           "bundled": true
         },
+        "json-schema": {
+          "version": "0.2.3",
+          "bundled": true
+        },
+        "json-stable-stringify": {
+          "version": "1.0.1",
+          "bundled": true,
+          "requires": {
+            "jsonify": "~0.0.0"
+          }
+        },
+        "json-stringify-safe": {
+          "version": "5.0.1",
+          "bundled": true
+        },
+        "jsonify": {
+          "version": "0.0.0",
+          "bundled": true
+        },
+        "jsonparse": {
+          "version": "1.3.1",
+          "bundled": true
+        },
+        "jsprim": {
+          "version": "1.4.1",
+          "bundled": true,
+          "requires": {
+            "assert-plus": "1.0.0",
+            "extsprintf": "1.3.0",
+            "json-schema": "0.2.3",
+            "verror": "1.10.0"
+          },
+          "dependencies": {
+            "assert-plus": {
+              "version": "1.0.0",
+              "bundled": true
+            }
+          }
+        },
+        "latest-version": {
+          "version": "3.1.0",
+          "bundled": true,
+          "requires": {
+            "package-json": "^4.0.0"
+          }
+        },
         "lazy-property": {
           "version": "1.0.0",
           "bundled": true
         },
+        "lcid": {
+          "version": "1.0.0",
+          "bundled": true,
+          "requires": {
+            "invert-kv": "^1.0.0"
+          }
+        },
         "libcipm": {
-          "version": "1.6.2",
+          "version": "2.0.0",
           "bundled": true,
           "requires": {
-            "bin-links": "^1.1.0",
+            "bin-links": "^1.1.2",
             "bluebird": "^3.5.1",
             "find-npm-prefix": "^1.0.2",
             "graceful-fs": "^4.1.11",
-            "lock-verify": "^2.0.0",
-            "npm-lifecycle": "^2.0.0",
+            "lock-verify": "^2.0.2",
+            "npm-lifecycle": "^2.0.3",
             "npm-logical-tree": "^1.2.1",
-            "npm-package-arg": "^6.0.0",
-            "pacote": "^7.5.1",
+            "npm-package-arg": "^6.1.0",
+            "pacote": "^8.1.6",
             "protoduck": "^5.0.0",
-            "read-package-json": "^2.0.12",
+            "read-package-json": "^2.0.13",
             "rimraf": "^2.6.2",
-            "worker-farm": "^1.5.4"
-          },
-          "dependencies": {
-            "npm-logical-tree": {
-              "version": "1.2.1",
-              "bundled": true
-            },
-            "pacote": {
-              "version": "7.6.1",
-              "bundled": true,
-              "requires": {
-                "bluebird": "^3.5.1",
-                "cacache": "^10.0.4",
-                "get-stream": "^3.0.0",
-                "glob": "^7.1.2",
-                "lru-cache": "^4.1.1",
-                "make-fetch-happen": "^2.6.0",
-                "minimatch": "^3.0.4",
-                "mississippi": "^3.0.0",
-                "mkdirp": "^0.5.1",
-                "normalize-package-data": "^2.4.0",
-                "npm-package-arg": "^6.0.0",
-                "npm-packlist": "^1.1.10",
-                "npm-pick-manifest": "^2.1.0",
-                "osenv": "^0.1.5",
-                "promise-inflight": "^1.0.1",
-                "promise-retry": "^1.1.1",
-                "protoduck": "^5.0.0",
-                "rimraf": "^2.6.2",
-                "safe-buffer": "^5.1.1",
-                "semver": "^5.5.0",
-                "ssri": "^5.2.4",
-                "tar": "^4.4.0",
-                "unique-filename": "^1.1.0",
-                "which": "^1.3.0"
-              },
-              "dependencies": {
-                "cacache": {
-                  "version": "10.0.4",
-                  "bundled": true,
-                  "requires": {
-                    "bluebird": "^3.5.1",
-                    "chownr": "^1.0.1",
-                    "glob": "^7.1.2",
-                    "graceful-fs": "^4.1.11",
-                    "lru-cache": "^4.1.1",
-                    "mississippi": "^2.0.0",
-                    "mkdirp": "^0.5.1",
-                    "move-concurrently": "^1.0.1",
-                    "promise-inflight": "^1.0.1",
-                    "rimraf": "^2.6.2",
-                    "ssri": "^5.2.4",
-                    "unique-filename": "^1.1.0",
-                    "y18n": "^4.0.0"
-                  },
-                  "dependencies": {
-                    "mississippi": {
-                      "version": "2.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "concat-stream": "^1.5.0",
-                        "duplexify": "^3.4.2",
-                        "end-of-stream": "^1.1.0",
-                        "flush-write-stream": "^1.0.0",
-                        "from2": "^2.1.0",
-                        "parallel-transform": "^1.1.0",
-                        "pump": "^2.0.1",
-                        "pumpify": "^1.3.3",
-                        "stream-each": "^1.1.0",
-                        "through2": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "concat-stream": {
-                          "version": "1.6.2",
-                          "bundled": true,
-                          "requires": {
-                            "buffer-from": "^1.0.0",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.2.2",
-                            "typedarray": "^0.0.6"
-                          },
-                          "dependencies": {
-                            "buffer-from": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            },
-                            "typedarray": {
-                              "version": "0.0.6",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "duplexify": {
-                          "version": "3.5.4",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.0.0",
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "end-of-stream": {
-                          "version": "1.4.1",
-                          "bundled": true,
-                          "requires": {
-                            "once": "^1.4.0"
-                          }
-                        },
-                        "flush-write-stream": {
-                          "version": "1.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.4"
-                          }
-                        },
-                        "from2": {
-                          "version": "2.3.0",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0"
-                          }
-                        },
-                        "parallel-transform": {
-                          "version": "1.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "cyclist": "~0.2.2",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.1.5"
-                          },
-                          "dependencies": {
-                            "cyclist": {
-                              "version": "0.2.2",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "pump": {
-                          "version": "2.0.1",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "once": "^1.3.1"
-                          }
-                        },
-                        "pumpify": {
-                          "version": "1.4.0",
-                          "bundled": true,
-                          "requires": {
-                            "duplexify": "^3.5.3",
-                            "inherits": "^2.0.3",
-                            "pump": "^2.0.0"
-                          }
-                        },
-                        "stream-each": {
-                          "version": "1.2.2",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "through2": {
-                          "version": "2.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "readable-stream": "^2.1.5",
-                            "xtend": "~4.0.1"
-                          },
-                          "dependencies": {
-                            "xtend": {
-                              "version": "4.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "y18n": {
-                      "version": "4.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "get-stream": {
-                  "version": "3.0.0",
-                  "bundled": true
-                },
-                "make-fetch-happen": {
-                  "version": "2.6.0",
-                  "bundled": true,
-                  "requires": {
-                    "agentkeepalive": "^3.3.0",
-                    "cacache": "^10.0.0",
-                    "http-cache-semantics": "^3.8.0",
-                    "http-proxy-agent": "^2.0.0",
-                    "https-proxy-agent": "^2.1.0",
-                    "lru-cache": "^4.1.1",
-                    "mississippi": "^1.2.0",
-                    "node-fetch-npm": "^2.0.2",
-                    "promise-retry": "^1.1.1",
-                    "socks-proxy-agent": "^3.0.1",
-                    "ssri": "^5.0.0"
-                  },
-                  "dependencies": {
-                    "agentkeepalive": {
-                      "version": "3.4.1",
-                      "bundled": true,
-                      "requires": {
-                        "humanize-ms": "^1.2.1"
-                      },
-                      "dependencies": {
-                        "humanize-ms": {
-                          "version": "1.2.1",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.1.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "http-cache-semantics": {
-                      "version": "3.8.1",
-                      "bundled": true
-                    },
-                    "http-proxy-agent": {
-                      "version": "2.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "4",
-                        "debug": "3.1.0"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.2.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "debug": {
-                          "version": "3.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.0.0",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "https-proxy-agent": {
-                      "version": "2.2.1",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "^4.1.0",
-                        "debug": "^3.1.0"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.2.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "debug": {
-                          "version": "3.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.0.0",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "mississippi": {
-                      "version": "1.3.1",
-                      "bundled": true,
-                      "requires": {
-                        "concat-stream": "^1.5.0",
-                        "duplexify": "^3.4.2",
-                        "end-of-stream": "^1.1.0",
-                        "flush-write-stream": "^1.0.0",
-                        "from2": "^2.1.0",
-                        "parallel-transform": "^1.1.0",
-                        "pump": "^1.0.0",
-                        "pumpify": "^1.3.3",
-                        "stream-each": "^1.1.0",
-                        "through2": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "concat-stream": {
-                          "version": "1.6.2",
-                          "bundled": true,
-                          "requires": {
-                            "buffer-from": "^1.0.0",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.2.2",
-                            "typedarray": "^0.0.6"
-                          },
-                          "dependencies": {
-                            "buffer-from": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            },
-                            "typedarray": {
-                              "version": "0.0.6",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "duplexify": {
-                          "version": "3.5.4",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.0.0",
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "end-of-stream": {
-                          "version": "1.4.1",
-                          "bundled": true,
-                          "requires": {
-                            "once": "^1.4.0"
-                          }
-                        },
-                        "flush-write-stream": {
-                          "version": "1.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.4"
-                          }
-                        },
-                        "from2": {
-                          "version": "2.3.0",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0"
-                          }
-                        },
-                        "parallel-transform": {
-                          "version": "1.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "cyclist": "~0.2.2",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.1.5"
-                          },
-                          "dependencies": {
-                            "cyclist": {
-                              "version": "0.2.2",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "pump": {
-                          "version": "1.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "once": "^1.3.1"
-                          }
-                        },
-                        "pumpify": {
-                          "version": "1.4.0",
-                          "bundled": true,
-                          "requires": {
-                            "duplexify": "^3.5.3",
-                            "inherits": "^2.0.3",
-                            "pump": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "pump": {
-                              "version": "2.0.1",
-                              "bundled": true,
-                              "requires": {
-                                "end-of-stream": "^1.1.0",
-                                "once": "^1.3.1"
-                              }
-                            }
-                          }
-                        },
-                        "stream-each": {
-                          "version": "1.2.2",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "through2": {
-                          "version": "2.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "readable-stream": "^2.1.5",
-                            "xtend": "~4.0.1"
-                          },
-                          "dependencies": {
-                            "xtend": {
-                              "version": "4.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "node-fetch-npm": {
-                      "version": "2.0.2",
-                      "bundled": true,
-                      "requires": {
-                        "encoding": "^0.1.11",
-                        "json-parse-better-errors": "^1.0.0",
-                        "safe-buffer": "^5.1.1"
-                      },
-                      "dependencies": {
-                        "encoding": {
-                          "version": "0.1.12",
-                          "bundled": true,
-                          "requires": {
-                            "iconv-lite": "~0.4.13"
-                          },
-                          "dependencies": {
-                            "iconv-lite": {
-                              "version": "0.4.21",
-                              "bundled": true,
-                              "requires": {
-                                "safer-buffer": "^2.1.0"
-                              },
-                              "dependencies": {
-                                "safer-buffer": {
-                                  "version": "2.1.2",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "socks-proxy-agent": {
-                      "version": "3.0.1",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "^4.1.0",
-                        "socks": "^1.1.10"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.2.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "socks": {
-                          "version": "1.1.10",
-                          "bundled": true,
-                          "requires": {
-                            "ip": "^1.1.4",
-                            "smart-buffer": "^1.0.13"
-                          },
-                          "dependencies": {
-                            "ip": {
-                              "version": "1.1.5",
-                              "bundled": true
-                            },
-                            "smart-buffer": {
-                              "version": "1.1.15",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                },
-                "minimatch": {
-                  "version": "3.0.4",
-                  "bundled": true,
-                  "requires": {
-                    "brace-expansion": "^1.1.7"
-                  },
-                  "dependencies": {
-                    "brace-expansion": {
-                      "version": "1.1.11",
-                      "bundled": true,
-                      "requires": {
-                        "balanced-match": "^1.0.0",
-                        "concat-map": "0.0.1"
-                      },
-                      "dependencies": {
-                        "balanced-match": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        },
-                        "concat-map": {
-                          "version": "0.0.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "promise-retry": {
-                  "version": "1.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "err-code": "^1.0.0",
-                    "retry": "^0.10.0"
-                  },
-                  "dependencies": {
-                    "err-code": {
-                      "version": "1.1.2",
-                      "bundled": true
-                    },
-                    "retry": {
-                      "version": "0.10.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "ssri": {
-                  "version": "5.3.0",
-                  "bundled": true,
-                  "requires": {
-                    "safe-buffer": "^5.1.1"
-                  }
-                }
-              }
-            },
-            "protoduck": {
-              "version": "5.0.0",
-              "bundled": true,
-              "requires": {
-                "genfun": "^4.0.1"
-              },
-              "dependencies": {
-                "genfun": {
-                  "version": "4.0.1",
-                  "bundled": true
-                }
-              }
-            }
+            "worker-farm": "^1.6.0"
           }
         },
         "libnpmhook": {
@@ -6671,244 +6648,6 @@
                 "lru-cache": "^4.1.2",
                 "make-fetch-happen": "^4.0.0",
                 "npm-package-arg": "^6.0.0"
-              },
-              "dependencies": {
-                "make-fetch-happen": {
-                  "version": "4.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "agentkeepalive": "^3.4.1",
-                    "cacache": "^11.0.1",
-                    "http-cache-semantics": "^3.8.1",
-                    "http-proxy-agent": "^2.1.0",
-                    "https-proxy-agent": "^2.2.1",
-                    "lru-cache": "^4.1.2",
-                    "mississippi": "^3.0.0",
-                    "node-fetch-npm": "^2.0.2",
-                    "promise-retry": "^1.1.1",
-                    "socks-proxy-agent": "^4.0.0",
-                    "ssri": "^6.0.0"
-                  },
-                  "dependencies": {
-                    "agentkeepalive": {
-                      "version": "3.4.1",
-                      "bundled": true,
-                      "requires": {
-                        "humanize-ms": "^1.2.1"
-                      },
-                      "dependencies": {
-                        "humanize-ms": {
-                          "version": "1.2.1",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.1.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "http-cache-semantics": {
-                      "version": "3.8.1",
-                      "bundled": true
-                    },
-                    "http-proxy-agent": {
-                      "version": "2.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "4",
-                        "debug": "3.1.0"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.2.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "debug": {
-                          "version": "3.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.0.0",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "https-proxy-agent": {
-                      "version": "2.2.1",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "^4.1.0",
-                        "debug": "^3.1.0"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.2.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "debug": {
-                          "version": "3.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "ms": "2.0.0"
-                          },
-                          "dependencies": {
-                            "ms": {
-                              "version": "2.0.0",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "node-fetch-npm": {
-                      "version": "2.0.2",
-                      "bundled": true,
-                      "requires": {
-                        "encoding": "^0.1.11",
-                        "json-parse-better-errors": "^1.0.0",
-                        "safe-buffer": "^5.1.1"
-                      },
-                      "dependencies": {
-                        "encoding": {
-                          "version": "0.1.12",
-                          "bundled": true,
-                          "requires": {
-                            "iconv-lite": "~0.4.13"
-                          },
-                          "dependencies": {
-                            "iconv-lite": {
-                              "version": "0.4.21",
-                              "bundled": true,
-                              "requires": {
-                                "safer-buffer": "^2.1.0"
-                              },
-                              "dependencies": {
-                                "safer-buffer": {
-                                  "version": "2.1.2",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "promise-retry": {
-                      "version": "1.1.1",
-                      "bundled": true,
-                      "requires": {
-                        "err-code": "^1.0.0",
-                        "retry": "^0.10.0"
-                      },
-                      "dependencies": {
-                        "err-code": {
-                          "version": "1.1.2",
-                          "bundled": true
-                        },
-                        "retry": {
-                          "version": "0.10.1",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "socks-proxy-agent": {
-                      "version": "4.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "agent-base": "~4.1.0",
-                        "socks": "~2.1.6"
-                      },
-                      "dependencies": {
-                        "agent-base": {
-                          "version": "4.1.2",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promisify": "^5.0.0"
-                          },
-                          "dependencies": {
-                            "es6-promisify": {
-                              "version": "5.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "es6-promise": "^4.0.3"
-                              },
-                              "dependencies": {
-                                "es6-promise": {
-                                  "version": "4.2.4",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "socks": {
-                          "version": "2.1.6",
-                          "bundled": true,
-                          "requires": {
-                            "ip": "^1.1.5",
-                            "smart-buffer": "^4.0.1"
-                          },
-                          "dependencies": {
-                            "ip": {
-                              "version": "1.1.5",
-                              "bundled": true
-                            },
-                            "smart-buffer": {
-                              "version": "4.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
               }
             }
           }
@@ -6925,307 +6664,14 @@
             "which": "^1.3.0",
             "y18n": "^4.0.0",
             "yargs": "^11.0.0"
-          },
-          "dependencies": {
-            "dotenv": {
-              "version": "5.0.1",
-              "bundled": true
-            },
-            "y18n": {
-              "version": "4.0.0",
-              "bundled": true
-            },
-            "yargs": {
-              "version": "11.0.0",
-              "bundled": true,
-              "requires": {
-                "cliui": "^4.0.0",
-                "decamelize": "^1.1.1",
-                "find-up": "^2.1.0",
-                "get-caller-file": "^1.0.1",
-                "os-locale": "^2.0.0",
-                "require-directory": "^2.1.1",
-                "require-main-filename": "^1.0.1",
-                "set-blocking": "^2.0.0",
-                "string-width": "^2.0.0",
-                "which-module": "^2.0.0",
-                "y18n": "^3.2.1",
-                "yargs-parser": "^9.0.2"
-              },
-              "dependencies": {
-                "cliui": {
-                  "version": "4.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "string-width": "^2.1.1",
-                    "strip-ansi": "^4.0.0",
-                    "wrap-ansi": "^2.0.0"
-                  },
-                  "dependencies": {
-                    "wrap-ansi": {
-                      "version": "2.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "string-width": "^1.0.1",
-                        "strip-ansi": "^3.0.1"
-                      },
-                      "dependencies": {
-                        "string-width": {
-                          "version": "1.0.2",
-                          "bundled": true,
-                          "requires": {
-                            "code-point-at": "^1.0.0",
-                            "is-fullwidth-code-point": "^1.0.0",
-                            "strip-ansi": "^3.0.0"
-                          },
-                          "dependencies": {
-                            "code-point-at": {
-                              "version": "1.1.0",
-                              "bundled": true
-                            },
-                            "is-fullwidth-code-point": {
-                              "version": "1.0.0",
-                              "bundled": true,
-                              "requires": {
-                                "number-is-nan": "^1.0.0"
-                              },
-                              "dependencies": {
-                                "number-is-nan": {
-                                  "version": "1.0.1",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "strip-ansi": {
-                          "version": "3.0.1",
-                          "bundled": true,
-                          "requires": {
-                            "ansi-regex": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "ansi-regex": {
-                              "version": "2.1.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                },
-                "decamelize": {
-                  "version": "1.2.0",
-                  "bundled": true
-                },
-                "find-up": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "locate-path": "^2.0.0"
-                  },
-                  "dependencies": {
-                    "locate-path": {
-                      "version": "2.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "p-locate": "^2.0.0",
-                        "path-exists": "^3.0.0"
-                      },
-                      "dependencies": {
-                        "p-locate": {
-                          "version": "2.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "p-limit": "^1.1.0"
-                          },
-                          "dependencies": {
-                            "p-limit": {
-                              "version": "1.2.0",
-                              "bundled": true,
-                              "requires": {
-                                "p-try": "^1.0.0"
-                              },
-                              "dependencies": {
-                                "p-try": {
-                                  "version": "1.0.0",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "path-exists": {
-                          "version": "3.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "get-caller-file": {
-                  "version": "1.0.2",
-                  "bundled": true
-                },
-                "os-locale": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "execa": "^0.7.0",
-                    "lcid": "^1.0.0",
-                    "mem": "^1.1.0"
-                  },
-                  "dependencies": {
-                    "execa": {
-                      "version": "0.7.0",
-                      "bundled": true,
-                      "requires": {
-                        "cross-spawn": "^5.0.1",
-                        "get-stream": "^3.0.0",
-                        "is-stream": "^1.1.0",
-                        "npm-run-path": "^2.0.0",
-                        "p-finally": "^1.0.0",
-                        "signal-exit": "^3.0.0",
-                        "strip-eof": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "cross-spawn": {
-                          "version": "5.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "lru-cache": "^4.0.1",
-                            "shebang-command": "^1.2.0",
-                            "which": "^1.2.9"
-                          },
-                          "dependencies": {
-                            "shebang-command": {
-                              "version": "1.2.0",
-                              "bundled": true,
-                              "requires": {
-                                "shebang-regex": "^1.0.0"
-                              },
-                              "dependencies": {
-                                "shebang-regex": {
-                                  "version": "1.0.0",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "get-stream": {
-                          "version": "3.0.0",
-                          "bundled": true
-                        },
-                        "is-stream": {
-                          "version": "1.1.0",
-                          "bundled": true
-                        },
-                        "npm-run-path": {
-                          "version": "2.0.2",
-                          "bundled": true,
-                          "requires": {
-                            "path-key": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "path-key": {
-                              "version": "2.0.1",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "p-finally": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        },
-                        "signal-exit": {
-                          "version": "3.0.2",
-                          "bundled": true
-                        },
-                        "strip-eof": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "lcid": {
-                      "version": "1.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "invert-kv": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "invert-kv": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "mem": {
-                      "version": "1.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "mimic-fn": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "mimic-fn": {
-                          "version": "1.2.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "require-directory": {
-                  "version": "2.1.1",
-                  "bundled": true
-                },
-                "require-main-filename": {
-                  "version": "1.0.1",
-                  "bundled": true
-                },
-                "set-blocking": {
-                  "version": "2.0.0",
-                  "bundled": true
-                },
-                "string-width": {
-                  "version": "2.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "is-fullwidth-code-point": "^2.0.0",
-                    "strip-ansi": "^4.0.0"
-                  },
-                  "dependencies": {
-                    "is-fullwidth-code-point": {
-                      "version": "2.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "which-module": {
-                  "version": "2.0.0",
-                  "bundled": true
-                },
-                "y18n": {
-                  "version": "3.2.1",
-                  "bundled": true
-                },
-                "yargs-parser": {
-                  "version": "9.0.2",
-                  "bundled": true,
-                  "requires": {
-                    "camelcase": "^4.1.0"
-                  },
-                  "dependencies": {
-                    "camelcase": {
-                      "version": "4.1.0",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            }
+          }
+        },
+        "locate-path": {
+          "version": "2.0.0",
+          "bundled": true,
+          "requires": {
+            "p-locate": "^2.0.0",
+            "path-exists": "^3.0.0"
           }
         },
         "lock-verify": {
@@ -7241,12 +6687,6 @@
           "bundled": true,
           "requires": {
             "signal-exit": "^3.0.2"
-          },
-          "dependencies": {
-            "signal-exit": {
-              "version": "3.0.2",
-              "bundled": true
-            }
           }
         },
         "lodash._baseindexof": {
@@ -7259,16 +6699,6 @@
           "requires": {
             "lodash._createset": "~4.0.0",
             "lodash._root": "~3.0.0"
-          },
-          "dependencies": {
-            "lodash._createset": {
-              "version": "4.0.3",
-              "bundled": true
-            },
-            "lodash._root": {
-              "version": "3.0.1",
-              "bundled": true
-            }
           }
         },
         "lodash._bindcallback": {
@@ -7286,10 +6716,18 @@
             "lodash._getnative": "^3.0.0"
           }
         },
+        "lodash._createset": {
+          "version": "4.0.3",
+          "bundled": true
+        },
         "lodash._getnative": {
           "version": "3.9.1",
           "bundled": true
         },
+        "lodash._root": {
+          "version": "3.0.1",
+          "bundled": true
+        },
         "lodash.clonedeep": {
           "version": "4.5.0",
           "bundled": true
@@ -7310,27 +6748,99 @@
           "version": "4.4.0",
           "bundled": true
         },
+        "lowercase-keys": {
+          "version": "1.0.1",
+          "bundled": true
+        },
         "lru-cache": {
           "version": "4.1.3",
           "bundled": true,
           "requires": {
             "pseudomap": "^1.0.2",
             "yallist": "^2.1.2"
+          }
+        },
+        "make-dir": {
+          "version": "1.3.0",
+          "bundled": true,
+          "requires": {
+            "pify": "^3.0.0"
+          }
+        },
+        "make-fetch-happen": {
+          "version": "4.0.1",
+          "bundled": true,
+          "requires": {
+            "agentkeepalive": "^3.4.1",
+            "cacache": "^11.0.1",
+            "http-cache-semantics": "^3.8.1",
+            "http-proxy-agent": "^2.1.0",
+            "https-proxy-agent": "^2.2.1",
+            "lru-cache": "^4.1.2",
+            "mississippi": "^3.0.0",
+            "node-fetch-npm": "^2.0.2",
+            "promise-retry": "^1.1.1",
+            "socks-proxy-agent": "^4.0.0",
+            "ssri": "^6.0.0"
+          }
+        },
+        "meant": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "mem": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "mimic-fn": "^1.0.0"
+          }
+        },
+        "mime-db": {
+          "version": "1.33.0",
+          "bundled": true
+        },
+        "mime-types": {
+          "version": "2.1.18",
+          "bundled": true,
+          "requires": {
+            "mime-db": "~1.33.0"
+          }
+        },
+        "mimic-fn": {
+          "version": "1.2.0",
+          "bundled": true
+        },
+        "minimatch": {
+          "version": "3.0.4",
+          "bundled": true,
+          "requires": {
+            "brace-expansion": "^1.1.7"
+          }
+        },
+        "minimist": {
+          "version": "0.0.8",
+          "bundled": true
+        },
+        "minipass": {
+          "version": "2.3.3",
+          "bundled": true,
+          "requires": {
+            "safe-buffer": "^5.1.2",
+            "yallist": "^3.0.0"
           },
           "dependencies": {
-            "pseudomap": {
-              "version": "1.0.2",
-              "bundled": true
-            },
             "yallist": {
-              "version": "2.1.2",
+              "version": "3.0.2",
               "bundled": true
             }
           }
         },
-        "meant": {
-          "version": "1.0.1",
-          "bundled": true
+        "minizlib": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "minipass": "^2.2.1"
+          }
         },
         "mississippi": {
           "version": "3.0.0",
@@ -7346,132 +6856,6 @@
             "pumpify": "^1.3.3",
             "stream-each": "^1.1.0",
             "through2": "^2.0.0"
-          },
-          "dependencies": {
-            "concat-stream": {
-              "version": "1.6.1",
-              "bundled": true,
-              "requires": {
-                "inherits": "^2.0.3",
-                "readable-stream": "^2.2.2",
-                "typedarray": "^0.0.6"
-              },
-              "dependencies": {
-                "typedarray": {
-                  "version": "0.0.6",
-                  "bundled": true
-                }
-              }
-            },
-            "duplexify": {
-              "version": "3.5.4",
-              "bundled": true,
-              "requires": {
-                "end-of-stream": "^1.0.0",
-                "inherits": "^2.0.1",
-                "readable-stream": "^2.0.0",
-                "stream-shift": "^1.0.0"
-              },
-              "dependencies": {
-                "stream-shift": {
-                  "version": "1.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "end-of-stream": {
-              "version": "1.4.1",
-              "bundled": true,
-              "requires": {
-                "once": "^1.4.0"
-              }
-            },
-            "flush-write-stream": {
-              "version": "1.0.2",
-              "bundled": true,
-              "requires": {
-                "inherits": "^2.0.1",
-                "readable-stream": "^2.0.4"
-              }
-            },
-            "from2": {
-              "version": "2.3.0",
-              "bundled": true,
-              "requires": {
-                "inherits": "^2.0.1",
-                "readable-stream": "^2.0.0"
-              }
-            },
-            "parallel-transform": {
-              "version": "1.1.0",
-              "bundled": true,
-              "requires": {
-                "cyclist": "~0.2.2",
-                "inherits": "^2.0.3",
-                "readable-stream": "^2.1.5"
-              },
-              "dependencies": {
-                "cyclist": {
-                  "version": "0.2.2",
-                  "bundled": true
-                }
-              }
-            },
-            "pump": {
-              "version": "3.0.0",
-              "bundled": true,
-              "requires": {
-                "end-of-stream": "^1.1.0",
-                "once": "^1.3.1"
-              }
-            },
-            "pumpify": {
-              "version": "1.4.0",
-              "bundled": true,
-              "requires": {
-                "duplexify": "^3.5.3",
-                "inherits": "^2.0.3",
-                "pump": "^2.0.0"
-              },
-              "dependencies": {
-                "pump": {
-                  "version": "2.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "end-of-stream": "^1.1.0",
-                    "once": "^1.3.1"
-                  }
-                }
-              }
-            },
-            "stream-each": {
-              "version": "1.2.2",
-              "bundled": true,
-              "requires": {
-                "end-of-stream": "^1.1.0",
-                "stream-shift": "^1.0.0"
-              },
-              "dependencies": {
-                "stream-shift": {
-                  "version": "1.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "through2": {
-              "version": "2.0.3",
-              "bundled": true,
-              "requires": {
-                "readable-stream": "^2.1.5",
-                "xtend": "~4.0.1"
-              },
-              "dependencies": {
-                "xtend": {
-                  "version": "4.0.1",
-                  "bundled": true
-                }
-              }
-            }
           }
         },
         "mkdirp": {
@@ -7479,12 +6863,6 @@
           "bundled": true,
           "requires": {
             "minimist": "0.0.8"
-          },
-          "dependencies": {
-            "minimist": {
-              "version": "0.0.8",
-              "bundled": true
-            }
           }
         },
         "move-concurrently": {
@@ -7497,91 +6875,43 @@
             "mkdirp": "^0.5.1",
             "rimraf": "^2.5.4",
             "run-queue": "^1.0.3"
-          },
-          "dependencies": {
-            "copy-concurrently": {
-              "version": "1.0.5",
-              "bundled": true,
-              "requires": {
-                "aproba": "^1.1.1",
-                "fs-write-stream-atomic": "^1.0.8",
-                "iferr": "^0.1.5",
-                "mkdirp": "^0.5.1",
-                "rimraf": "^2.5.4",
-                "run-queue": "^1.0.0"
-              },
-              "dependencies": {
-                "iferr": {
-                  "version": "0.1.5",
-                  "bundled": true
-                }
-              }
-            },
-            "run-queue": {
-              "version": "1.0.3",
-              "bundled": true,
-              "requires": {
-                "aproba": "^1.1.1"
-              }
-            }
+          }
+        },
+        "ms": {
+          "version": "2.1.1",
+          "bundled": true
+        },
+        "mute-stream": {
+          "version": "0.0.7",
+          "bundled": true
+        },
+        "node-fetch-npm": {
+          "version": "2.0.2",
+          "bundled": true,
+          "requires": {
+            "encoding": "^0.1.11",
+            "json-parse-better-errors": "^1.0.0",
+            "safe-buffer": "^5.1.1"
           }
         },
         "node-gyp": {
-          "version": "3.6.2",
+          "version": "3.7.0",
           "bundled": true,
           "requires": {
             "fstream": "^1.0.0",
             "glob": "^7.0.3",
             "graceful-fs": "^4.1.2",
-            "minimatch": "^3.0.2",
             "mkdirp": "^0.5.0",
             "nopt": "2 || 3",
             "npmlog": "0 || 1 || 2 || 3 || 4",
             "osenv": "0",
-            "request": "2",
+            "request": ">=2.9.0 <2.82.0",
             "rimraf": "2",
             "semver": "~5.3.0",
             "tar": "^2.0.0",
             "which": "1"
           },
           "dependencies": {
-            "fstream": {
-              "version": "1.0.11",
-              "bundled": true,
-              "requires": {
-                "graceful-fs": "^4.1.2",
-                "inherits": "~2.0.0",
-                "mkdirp": ">=0.5 0",
-                "rimraf": "2"
-              }
-            },
-            "minimatch": {
-              "version": "3.0.4",
-              "bundled": true,
-              "requires": {
-                "brace-expansion": "^1.1.7"
-              },
-              "dependencies": {
-                "brace-expansion": {
-                  "version": "1.1.11",
-                  "bundled": true,
-                  "requires": {
-                    "balanced-match": "^1.0.0",
-                    "concat-map": "0.0.1"
-                  },
-                  "dependencies": {
-                    "balanced-match": {
-                      "version": "1.0.0",
-                      "bundled": true
-                    },
-                    "concat-map": {
-                      "version": "0.0.1",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            },
             "nopt": {
               "version": "3.0.6",
               "bundled": true,
@@ -7600,15 +6930,6 @@
                 "block-stream": "*",
                 "fstream": "^1.0.2",
                 "inherits": "2"
-              },
-              "dependencies": {
-                "block-stream": {
-                  "version": "0.0.9",
-                  "bundled": true,
-                  "requires": {
-                    "inherits": "~2.0.0"
-                  }
-                }
               }
             }
           }
@@ -7629,37 +6950,20 @@
             "is-builtin-module": "^1.0.0",
             "semver": "2 || 3 || 4 || 5",
             "validate-npm-package-license": "^3.0.1"
-          },
-          "dependencies": {
-            "is-builtin-module": {
-              "version": "1.0.0",
-              "bundled": true,
-              "requires": {
-                "builtin-modules": "^1.0.0"
-              },
-              "dependencies": {
-                "builtin-modules": {
-                  "version": "1.1.1",
-                  "bundled": true
-                }
-              }
-            }
           }
         },
         "npm-audit-report": {
-          "version": "1.2.1",
+          "version": "1.3.1",
           "bundled": true,
           "requires": {
-            "cli-table2": "^0.2.0",
+            "cli-table3": "^0.5.0",
             "console-control-strings": "^1.1.0"
-          },
-          "dependencies": {
-            "console-control-strings": {
-              "version": "1.1.0",
-              "bundled": true
-            }
           }
         },
+        "npm-bundled": {
+          "version": "1.0.3",
+          "bundled": true
+        },
         "npm-cache-filename": {
           "version": "1.0.2",
           "bundled": true
@@ -7683,18 +6987,12 @@
             "uid-number": "0.0.6",
             "umask": "^1.1.0",
             "which": "^1.3.0"
-          },
-          "dependencies": {
-            "byline": {
-              "version": "5.0.0",
-              "bundled": true
-            },
-            "resolve-from": {
-              "version": "4.0.0",
-              "bundled": true
-            }
           }
         },
+        "npm-logical-tree": {
+          "version": "1.2.1",
+          "bundled": true
+        },
         "npm-package-arg": {
           "version": "6.1.0",
           "bundled": true,
@@ -7711,48 +7009,6 @@
           "requires": {
             "ignore-walk": "^3.0.1",
             "npm-bundled": "^1.0.1"
-          },
-          "dependencies": {
-            "ignore-walk": {
-              "version": "3.0.1",
-              "bundled": true,
-              "requires": {
-                "minimatch": "^3.0.4"
-              },
-              "dependencies": {
-                "minimatch": {
-                  "version": "3.0.4",
-                  "bundled": true,
-                  "requires": {
-                    "brace-expansion": "^1.1.7"
-                  },
-                  "dependencies": {
-                    "brace-expansion": {
-                      "version": "1.1.8",
-                      "bundled": true,
-                      "requires": {
-                        "balanced-match": "^1.0.0",
-                        "concat-map": "0.0.1"
-                      },
-                      "dependencies": {
-                        "balanced-match": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        },
-                        "concat-map": {
-                          "version": "0.0.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            },
-            "npm-bundled": {
-              "version": "1.0.3",
-              "bundled": true
-            }
           }
         },
         "npm-pick-manifest": {
@@ -7764,555 +7020,11 @@
           }
         },
         "npm-profile": {
-          "version": "3.0.1",
+          "version": "3.0.2",
           "bundled": true,
           "requires": {
-            "aproba": "^1.1.2",
-            "make-fetch-happen": "^2.5.0"
-          },
-          "dependencies": {
-            "make-fetch-happen": {
-              "version": "2.6.0",
-              "bundled": true,
-              "requires": {
-                "agentkeepalive": "^3.3.0",
-                "cacache": "^10.0.0",
-                "http-cache-semantics": "^3.8.0",
-                "http-proxy-agent": "^2.0.0",
-                "https-proxy-agent": "^2.1.0",
-                "lru-cache": "^4.1.1",
-                "mississippi": "^1.2.0",
-                "node-fetch-npm": "^2.0.2",
-                "promise-retry": "^1.1.1",
-                "socks-proxy-agent": "^3.0.1",
-                "ssri": "^5.0.0"
-              },
-              "dependencies": {
-                "agentkeepalive": {
-                  "version": "3.3.0",
-                  "bundled": true,
-                  "requires": {
-                    "humanize-ms": "^1.2.1"
-                  },
-                  "dependencies": {
-                    "humanize-ms": {
-                      "version": "1.2.1",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.1.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "cacache": {
-                  "version": "10.0.4",
-                  "bundled": true,
-                  "requires": {
-                    "bluebird": "^3.5.1",
-                    "chownr": "^1.0.1",
-                    "glob": "^7.1.2",
-                    "graceful-fs": "^4.1.11",
-                    "lru-cache": "^4.1.1",
-                    "mississippi": "^2.0.0",
-                    "mkdirp": "^0.5.1",
-                    "move-concurrently": "^1.0.1",
-                    "promise-inflight": "^1.0.1",
-                    "rimraf": "^2.6.2",
-                    "ssri": "^5.2.4",
-                    "unique-filename": "^1.1.0",
-                    "y18n": "^4.0.0"
-                  },
-                  "dependencies": {
-                    "mississippi": {
-                      "version": "2.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "concat-stream": "^1.5.0",
-                        "duplexify": "^3.4.2",
-                        "end-of-stream": "^1.1.0",
-                        "flush-write-stream": "^1.0.0",
-                        "from2": "^2.1.0",
-                        "parallel-transform": "^1.1.0",
-                        "pump": "^2.0.1",
-                        "pumpify": "^1.3.3",
-                        "stream-each": "^1.1.0",
-                        "through2": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "concat-stream": {
-                          "version": "1.6.2",
-                          "bundled": true,
-                          "requires": {
-                            "buffer-from": "^1.0.0",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.2.2",
-                            "typedarray": "^0.0.6"
-                          },
-                          "dependencies": {
-                            "buffer-from": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            },
-                            "typedarray": {
-                              "version": "0.0.6",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "duplexify": {
-                          "version": "3.5.4",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.0.0",
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "end-of-stream": {
-                          "version": "1.4.1",
-                          "bundled": true,
-                          "requires": {
-                            "once": "^1.4.0"
-                          }
-                        },
-                        "flush-write-stream": {
-                          "version": "1.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.4"
-                          }
-                        },
-                        "from2": {
-                          "version": "2.3.0",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0"
-                          }
-                        },
-                        "parallel-transform": {
-                          "version": "1.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "cyclist": "~0.2.2",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.1.5"
-                          },
-                          "dependencies": {
-                            "cyclist": {
-                              "version": "0.2.2",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "pump": {
-                          "version": "2.0.1",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "once": "^1.3.1"
-                          }
-                        },
-                        "pumpify": {
-                          "version": "1.4.0",
-                          "bundled": true,
-                          "requires": {
-                            "duplexify": "^3.5.3",
-                            "inherits": "^2.0.3",
-                            "pump": "^2.0.0"
-                          }
-                        },
-                        "stream-each": {
-                          "version": "1.2.2",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "through2": {
-                          "version": "2.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "readable-stream": "^2.1.5",
-                            "xtend": "~4.0.1"
-                          },
-                          "dependencies": {
-                            "xtend": {
-                              "version": "4.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "y18n": {
-                      "version": "4.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "http-cache-semantics": {
-                  "version": "3.8.1",
-                  "bundled": true
-                },
-                "http-proxy-agent": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "4",
-                    "debug": "3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "https-proxy-agent": {
-                  "version": "2.2.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "^4.1.0",
-                    "debug": "^3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "mississippi": {
-                  "version": "1.3.1",
-                  "bundled": true,
-                  "requires": {
-                    "concat-stream": "^1.5.0",
-                    "duplexify": "^3.4.2",
-                    "end-of-stream": "^1.1.0",
-                    "flush-write-stream": "^1.0.0",
-                    "from2": "^2.1.0",
-                    "parallel-transform": "^1.1.0",
-                    "pump": "^1.0.0",
-                    "pumpify": "^1.3.3",
-                    "stream-each": "^1.1.0",
-                    "through2": "^2.0.0"
-                  },
-                  "dependencies": {
-                    "concat-stream": {
-                      "version": "1.6.0",
-                      "bundled": true,
-                      "requires": {
-                        "inherits": "^2.0.3",
-                        "readable-stream": "^2.2.2",
-                        "typedarray": "^0.0.6"
-                      },
-                      "dependencies": {
-                        "typedarray": {
-                          "version": "0.0.6",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "duplexify": {
-                      "version": "3.5.3",
-                      "bundled": true,
-                      "requires": {
-                        "end-of-stream": "^1.0.0",
-                        "inherits": "^2.0.1",
-                        "readable-stream": "^2.0.0",
-                        "stream-shift": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "stream-shift": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "end-of-stream": {
-                      "version": "1.4.1",
-                      "bundled": true,
-                      "requires": {
-                        "once": "^1.4.0"
-                      }
-                    },
-                    "flush-write-stream": {
-                      "version": "1.0.2",
-                      "bundled": true,
-                      "requires": {
-                        "inherits": "^2.0.1",
-                        "readable-stream": "^2.0.4"
-                      }
-                    },
-                    "from2": {
-                      "version": "2.3.0",
-                      "bundled": true,
-                      "requires": {
-                        "inherits": "^2.0.1",
-                        "readable-stream": "^2.0.0"
-                      }
-                    },
-                    "parallel-transform": {
-                      "version": "1.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "cyclist": "~0.2.2",
-                        "inherits": "^2.0.3",
-                        "readable-stream": "^2.1.5"
-                      },
-                      "dependencies": {
-                        "cyclist": {
-                          "version": "0.2.2",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "pump": {
-                      "version": "1.0.3",
-                      "bundled": true,
-                      "requires": {
-                        "end-of-stream": "^1.1.0",
-                        "once": "^1.3.1"
-                      }
-                    },
-                    "pumpify": {
-                      "version": "1.4.0",
-                      "bundled": true,
-                      "requires": {
-                        "duplexify": "^3.5.3",
-                        "inherits": "^2.0.3",
-                        "pump": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "pump": {
-                          "version": "2.0.1",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "once": "^1.3.1"
-                          }
-                        }
-                      }
-                    },
-                    "stream-each": {
-                      "version": "1.2.2",
-                      "bundled": true,
-                      "requires": {
-                        "end-of-stream": "^1.1.0",
-                        "stream-shift": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "stream-shift": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "through2": {
-                      "version": "2.0.3",
-                      "bundled": true,
-                      "requires": {
-                        "readable-stream": "^2.1.5",
-                        "xtend": "~4.0.1"
-                      },
-                      "dependencies": {
-                        "xtend": {
-                          "version": "4.0.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "node-fetch-npm": {
-                  "version": "2.0.2",
-                  "bundled": true,
-                  "requires": {
-                    "encoding": "^0.1.11",
-                    "json-parse-better-errors": "^1.0.0",
-                    "safe-buffer": "^5.1.1"
-                  },
-                  "dependencies": {
-                    "encoding": {
-                      "version": "0.1.12",
-                      "bundled": true,
-                      "requires": {
-                        "iconv-lite": "~0.4.13"
-                      },
-                      "dependencies": {
-                        "iconv-lite": {
-                          "version": "0.4.19",
-                          "bundled": true
-                        }
-                      }
-                    },
-                    "json-parse-better-errors": {
-                      "version": "1.0.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "promise-retry": {
-                  "version": "1.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "err-code": "^1.0.0",
-                    "retry": "^0.10.0"
-                  },
-                  "dependencies": {
-                    "err-code": {
-                      "version": "1.1.2",
-                      "bundled": true
-                    },
-                    "retry": {
-                      "version": "0.10.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "socks-proxy-agent": {
-                  "version": "3.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "^4.1.0",
-                    "socks": "^1.1.10"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "socks": {
-                      "version": "1.1.10",
-                      "bundled": true,
-                      "requires": {
-                        "ip": "^1.1.4",
-                        "smart-buffer": "^1.0.13"
-                      },
-                      "dependencies": {
-                        "ip": {
-                          "version": "1.1.5",
-                          "bundled": true
-                        },
-                        "smart-buffer": {
-                          "version": "1.1.15",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "ssri": {
-                  "version": "5.3.0",
-                  "bundled": true,
-                  "requires": {
-                    "safe-buffer": "^5.1.1"
-                  }
-                }
-              }
-            }
+            "aproba": "^1.1.2 || 2",
+            "make-fetch-happen": "^2.5.0 || 3 || 4"
           }
         },
         "npm-registry-client": {
@@ -8333,21 +7045,6 @@
             "ssri": "^5.2.4"
           },
           "dependencies": {
-            "concat-stream": {
-              "version": "1.6.1",
-              "bundled": true,
-              "requires": {
-                "inherits": "^2.0.3",
-                "readable-stream": "^2.2.2",
-                "typedarray": "^0.0.6"
-              },
-              "dependencies": {
-                "typedarray": {
-                  "version": "0.0.6",
-                  "bundled": true
-                }
-              }
-            },
             "retry": {
               "version": "0.10.1",
               "bundled": true
@@ -8373,6 +7070,43 @@
             "safe-buffer": "^5.1.1"
           },
           "dependencies": {
+            "cacache": {
+              "version": "10.0.4",
+              "bundled": true,
+              "requires": {
+                "bluebird": "^3.5.1",
+                "chownr": "^1.0.1",
+                "glob": "^7.1.2",
+                "graceful-fs": "^4.1.11",
+                "lru-cache": "^4.1.1",
+                "mississippi": "^2.0.0",
+                "mkdirp": "^0.5.1",
+                "move-concurrently": "^1.0.1",
+                "promise-inflight": "^1.0.1",
+                "rimraf": "^2.6.2",
+                "ssri": "^5.2.4",
+                "unique-filename": "^1.1.0",
+                "y18n": "^4.0.0"
+              },
+              "dependencies": {
+                "mississippi": {
+                  "version": "2.0.0",
+                  "bundled": true,
+                  "requires": {
+                    "concat-stream": "^1.5.0",
+                    "duplexify": "^3.4.2",
+                    "end-of-stream": "^1.1.0",
+                    "flush-write-stream": "^1.0.0",
+                    "from2": "^2.1.0",
+                    "parallel-transform": "^1.1.0",
+                    "pump": "^2.0.1",
+                    "pumpify": "^1.3.3",
+                    "stream-each": "^1.1.0",
+                    "through2": "^2.0.0"
+                  }
+                }
+              }
+            },
             "figgy-pudding": {
               "version": "2.0.1",
               "bundled": true
@@ -8392,398 +7126,52 @@
                 "promise-retry": "^1.1.1",
                 "socks-proxy-agent": "^3.0.1",
                 "ssri": "^5.2.4"
-              },
-              "dependencies": {
-                "agentkeepalive": {
-                  "version": "3.4.1",
-                  "bundled": true,
-                  "requires": {
-                    "humanize-ms": "^1.2.1"
-                  },
-                  "dependencies": {
-                    "humanize-ms": {
-                      "version": "1.2.1",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.1.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "cacache": {
-                  "version": "10.0.4",
-                  "bundled": true,
-                  "requires": {
-                    "bluebird": "^3.5.1",
-                    "chownr": "^1.0.1",
-                    "glob": "^7.1.2",
-                    "graceful-fs": "^4.1.11",
-                    "lru-cache": "^4.1.1",
-                    "mississippi": "^2.0.0",
-                    "mkdirp": "^0.5.1",
-                    "move-concurrently": "^1.0.1",
-                    "promise-inflight": "^1.0.1",
-                    "rimraf": "^2.6.2",
-                    "ssri": "^5.2.4",
-                    "unique-filename": "^1.1.0",
-                    "y18n": "^4.0.0"
-                  },
-                  "dependencies": {
-                    "mississippi": {
-                      "version": "2.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "concat-stream": "^1.5.0",
-                        "duplexify": "^3.4.2",
-                        "end-of-stream": "^1.1.0",
-                        "flush-write-stream": "^1.0.0",
-                        "from2": "^2.1.0",
-                        "parallel-transform": "^1.1.0",
-                        "pump": "^2.0.1",
-                        "pumpify": "^1.3.3",
-                        "stream-each": "^1.1.0",
-                        "through2": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "concat-stream": {
-                          "version": "1.6.2",
-                          "bundled": true,
-                          "requires": {
-                            "buffer-from": "^1.0.0",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.2.2",
-                            "typedarray": "^0.0.6"
-                          },
-                          "dependencies": {
-                            "buffer-from": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            },
-                            "typedarray": {
-                              "version": "0.0.6",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "duplexify": {
-                          "version": "3.5.4",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.0.0",
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "end-of-stream": {
-                          "version": "1.4.1",
-                          "bundled": true,
-                          "requires": {
-                            "once": "^1.4.0"
-                          }
-                        },
-                        "flush-write-stream": {
-                          "version": "1.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.4"
-                          }
-                        },
-                        "from2": {
-                          "version": "2.3.0",
-                          "bundled": true,
-                          "requires": {
-                            "inherits": "^2.0.1",
-                            "readable-stream": "^2.0.0"
-                          }
-                        },
-                        "parallel-transform": {
-                          "version": "1.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "cyclist": "~0.2.2",
-                            "inherits": "^2.0.3",
-                            "readable-stream": "^2.1.5"
-                          },
-                          "dependencies": {
-                            "cyclist": {
-                              "version": "0.2.2",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "pump": {
-                          "version": "2.0.1",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "once": "^1.3.1"
-                          }
-                        },
-                        "pumpify": {
-                          "version": "1.4.0",
-                          "bundled": true,
-                          "requires": {
-                            "duplexify": "^3.5.3",
-                            "inherits": "^2.0.3",
-                            "pump": "^2.0.0"
-                          }
-                        },
-                        "stream-each": {
-                          "version": "1.2.2",
-                          "bundled": true,
-                          "requires": {
-                            "end-of-stream": "^1.1.0",
-                            "stream-shift": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "stream-shift": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "through2": {
-                          "version": "2.0.3",
-                          "bundled": true,
-                          "requires": {
-                            "readable-stream": "^2.1.5",
-                            "xtend": "~4.0.1"
-                          },
-                          "dependencies": {
-                            "xtend": {
-                              "version": "4.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "y18n": {
-                      "version": "4.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "http-cache-semantics": {
-                  "version": "3.8.1",
-                  "bundled": true
-                },
-                "http-proxy-agent": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "4",
-                    "debug": "3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "https-proxy-agent": {
-                  "version": "2.2.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "^4.1.0",
-                    "debug": "^3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "node-fetch-npm": {
-                  "version": "2.0.2",
-                  "bundled": true,
-                  "requires": {
-                    "encoding": "^0.1.11",
-                    "json-parse-better-errors": "^1.0.0",
-                    "safe-buffer": "^5.1.1"
-                  },
-                  "dependencies": {
-                    "encoding": {
-                      "version": "0.1.12",
-                      "bundled": true,
-                      "requires": {
-                        "iconv-lite": "~0.4.13"
-                      },
-                      "dependencies": {
-                        "iconv-lite": {
-                          "version": "0.4.21",
-                          "bundled": true,
-                          "requires": {
-                            "safer-buffer": "^2.1.0"
-                          },
-                          "dependencies": {
-                            "safer-buffer": {
-                              "version": "2.1.2",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                },
-                "promise-retry": {
-                  "version": "1.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "err-code": "^1.0.0",
-                    "retry": "^0.10.0"
-                  },
-                  "dependencies": {
-                    "err-code": {
-                      "version": "1.1.2",
-                      "bundled": true
-                    },
-                    "retry": {
-                      "version": "0.10.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "socks-proxy-agent": {
-                  "version": "3.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "^4.1.0",
-                    "socks": "^1.1.10"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "socks": {
-                      "version": "1.1.10",
-                      "bundled": true,
-                      "requires": {
-                        "ip": "^1.1.4",
-                        "smart-buffer": "^1.0.13"
-                      },
-                      "dependencies": {
-                        "ip": {
-                          "version": "1.1.5",
-                          "bundled": true
-                        },
-                        "smart-buffer": {
-                          "version": "1.1.15",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "ssri": {
-                  "version": "5.3.0",
-                  "bundled": true,
-                  "requires": {
-                    "safe-buffer": "^5.1.1"
-                  }
-                }
+              }
+            },
+            "pump": {
+              "version": "2.0.1",
+              "bundled": true,
+              "requires": {
+                "end-of-stream": "^1.1.0",
+                "once": "^1.3.1"
+              }
+            },
+            "smart-buffer": {
+              "version": "1.1.15",
+              "bundled": true
+            },
+            "socks": {
+              "version": "1.1.10",
+              "bundled": true,
+              "requires": {
+                "ip": "^1.1.4",
+                "smart-buffer": "^1.0.13"
+              }
+            },
+            "socks-proxy-agent": {
+              "version": "3.0.1",
+              "bundled": true,
+              "requires": {
+                "agent-base": "^4.1.0",
+                "socks": "^1.1.10"
+              }
+            },
+            "ssri": {
+              "version": "5.3.0",
+              "bundled": true,
+              "requires": {
+                "safe-buffer": "^5.1.1"
               }
             }
           }
         },
+        "npm-run-path": {
+          "version": "2.0.2",
+          "bundled": true,
+          "requires": {
+            "path-key": "^2.0.0"
+          }
+        },
         "npm-user-validate": {
           "version": "1.0.0",
           "bundled": true
@@ -8796,104 +7184,20 @@
             "console-control-strings": "~1.1.0",
             "gauge": "~2.7.3",
             "set-blocking": "~2.0.0"
-          },
-          "dependencies": {
-            "are-we-there-yet": {
-              "version": "1.1.4",
-              "bundled": true,
-              "requires": {
-                "delegates": "^1.0.0",
-                "readable-stream": "^2.0.6"
-              },
-              "dependencies": {
-                "delegates": {
-                  "version": "1.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "console-control-strings": {
-              "version": "1.1.0",
-              "bundled": true
-            },
-            "gauge": {
-              "version": "2.7.4",
-              "bundled": true,
-              "requires": {
-                "aproba": "^1.0.3",
-                "console-control-strings": "^1.0.0",
-                "has-unicode": "^2.0.0",
-                "object-assign": "^4.1.0",
-                "signal-exit": "^3.0.0",
-                "string-width": "^1.0.1",
-                "strip-ansi": "^3.0.1",
-                "wide-align": "^1.1.0"
-              },
-              "dependencies": {
-                "object-assign": {
-                  "version": "4.1.1",
-                  "bundled": true
-                },
-                "signal-exit": {
-                  "version": "3.0.2",
-                  "bundled": true
-                },
-                "string-width": {
-                  "version": "1.0.2",
-                  "bundled": true,
-                  "requires": {
-                    "code-point-at": "^1.0.0",
-                    "is-fullwidth-code-point": "^1.0.0",
-                    "strip-ansi": "^3.0.0"
-                  },
-                  "dependencies": {
-                    "code-point-at": {
-                      "version": "1.1.0",
-                      "bundled": true
-                    },
-                    "is-fullwidth-code-point": {
-                      "version": "1.0.0",
-                      "bundled": true,
-                      "requires": {
-                        "number-is-nan": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "number-is-nan": {
-                          "version": "1.0.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "strip-ansi": {
-                  "version": "3.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "ansi-regex": "^2.0.0"
-                  },
-                  "dependencies": {
-                    "ansi-regex": {
-                      "version": "2.1.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "wide-align": {
-                  "version": "1.1.2",
-                  "bundled": true,
-                  "requires": {
-                    "string-width": "^1.0.2"
-                  }
-                }
-              }
-            },
-            "set-blocking": {
-              "version": "2.0.0",
-              "bundled": true
-            }
           }
         },
+        "number-is-nan": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "oauth-sign": {
+          "version": "0.8.2",
+          "bundled": true
+        },
+        "object-assign": {
+          "version": "4.1.1",
+          "bundled": true
+        },
         "once": {
           "version": "1.4.0",
           "bundled": true,
@@ -8905,38 +7209,77 @@
           "version": "1.4.3",
           "bundled": true
         },
+        "os-homedir": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "os-locale": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "execa": "^0.7.0",
+            "lcid": "^1.0.0",
+            "mem": "^1.1.0"
+          }
+        },
+        "os-tmpdir": {
+          "version": "1.0.2",
+          "bundled": true
+        },
         "osenv": {
           "version": "0.1.5",
           "bundled": true,
           "requires": {
             "os-homedir": "^1.0.0",
             "os-tmpdir": "^1.0.0"
-          },
-          "dependencies": {
-            "os-homedir": {
-              "version": "1.0.2",
-              "bundled": true
-            },
-            "os-tmpdir": {
-              "version": "1.0.2",
-              "bundled": true
-            }
           }
         },
-        "pacote": {
-          "version": "8.1.5",
+        "p-finally": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "p-limit": {
+          "version": "1.2.0",
           "bundled": true,
           "requires": {
-            "bluebird": "^3.5.1",
-            "cacache": "^11.0.2",
-            "get-stream": "^3.0.0",
-            "glob": "^7.1.2",
-            "lru-cache": "^4.1.3",
-            "make-fetch-happen": "^4.0.1",
-            "minimatch": "^3.0.4",
-            "minipass": "^2.3.3",
-            "mississippi": "^3.0.0",
-            "mkdirp": "^0.5.1",
+            "p-try": "^1.0.0"
+          }
+        },
+        "p-locate": {
+          "version": "2.0.0",
+          "bundled": true,
+          "requires": {
+            "p-limit": "^1.1.0"
+          }
+        },
+        "p-try": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "package-json": {
+          "version": "4.0.1",
+          "bundled": true,
+          "requires": {
+            "got": "^6.7.1",
+            "registry-auth-token": "^3.0.1",
+            "registry-url": "^3.0.3",
+            "semver": "^5.1.0"
+          }
+        },
+        "pacote": {
+          "version": "8.1.6",
+          "bundled": true,
+          "requires": {
+            "bluebird": "^3.5.1",
+            "cacache": "^11.0.2",
+            "get-stream": "^3.0.0",
+            "glob": "^7.1.2",
+            "lru-cache": "^4.1.3",
+            "make-fetch-happen": "^4.0.1",
+            "minimatch": "^3.0.4",
+            "minipass": "^2.3.3",
+            "mississippi": "^3.0.0",
+            "mkdirp": "^0.5.1",
             "normalize-package-data": "^2.4.0",
             "npm-package-arg": "^6.1.0",
             "npm-packlist": "^1.1.10",
@@ -8949,354 +7292,170 @@
             "safe-buffer": "^5.1.2",
             "semver": "^5.5.0",
             "ssri": "^6.0.0",
-            "tar": "4.4.1",
+            "tar": "^4.4.3",
             "unique-filename": "^1.1.0",
             "which": "^1.3.0"
+          }
+        },
+        "parallel-transform": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "cyclist": "~0.2.2",
+            "inherits": "^2.0.3",
+            "readable-stream": "^2.1.5"
+          }
+        },
+        "path-exists": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "path-is-absolute": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "path-is-inside": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "path-key": {
+          "version": "2.0.1",
+          "bundled": true
+        },
+        "performance-now": {
+          "version": "0.2.0",
+          "bundled": true
+        },
+        "pify": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "prepend-http": {
+          "version": "1.0.4",
+          "bundled": true
+        },
+        "process-nextick-args": {
+          "version": "2.0.0",
+          "bundled": true
+        },
+        "promise-inflight": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "promise-retry": {
+          "version": "1.1.1",
+          "bundled": true,
+          "requires": {
+            "err-code": "^1.0.0",
+            "retry": "^0.10.0"
           },
           "dependencies": {
-            "get-stream": {
-              "version": "3.0.0",
+            "retry": {
+              "version": "0.10.1",
               "bundled": true
-            },
-            "make-fetch-happen": {
-              "version": "4.0.1",
-              "bundled": true,
-              "requires": {
-                "agentkeepalive": "^3.4.1",
-                "cacache": "^11.0.1",
-                "http-cache-semantics": "^3.8.1",
-                "http-proxy-agent": "^2.1.0",
-                "https-proxy-agent": "^2.2.1",
-                "lru-cache": "^4.1.2",
-                "mississippi": "^3.0.0",
-                "node-fetch-npm": "^2.0.2",
-                "promise-retry": "^1.1.1",
-                "socks-proxy-agent": "^4.0.0",
-                "ssri": "^6.0.0"
-              },
-              "dependencies": {
-                "agentkeepalive": {
-                  "version": "3.4.1",
-                  "bundled": true,
-                  "requires": {
-                    "humanize-ms": "^1.2.1"
-                  },
-                  "dependencies": {
-                    "humanize-ms": {
-                      "version": "1.2.1",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "^2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.1.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "http-cache-semantics": {
-                  "version": "3.8.1",
-                  "bundled": true
-                },
-                "http-proxy-agent": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "4",
-                    "debug": "3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "https-proxy-agent": {
-                  "version": "2.2.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "^4.1.0",
-                    "debug": "^3.1.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "debug": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "ms": "2.0.0"
-                      },
-                      "dependencies": {
-                        "ms": {
-                          "version": "2.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "node-fetch-npm": {
-                  "version": "2.0.2",
-                  "bundled": true,
-                  "requires": {
-                    "encoding": "^0.1.11",
-                    "json-parse-better-errors": "^1.0.0",
-                    "safe-buffer": "^5.1.1"
-                  },
-                  "dependencies": {
-                    "encoding": {
-                      "version": "0.1.12",
-                      "bundled": true,
-                      "requires": {
-                        "iconv-lite": "~0.4.13"
-                      },
-                      "dependencies": {
-                        "iconv-lite": {
-                          "version": "0.4.23",
-                          "bundled": true,
-                          "requires": {
-                            "safer-buffer": ">= 2.1.2 < 3"
-                          },
-                          "dependencies": {
-                            "safer-buffer": {
-                              "version": "2.1.2",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                },
-                "socks-proxy-agent": {
-                  "version": "4.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "agent-base": "~4.2.0",
-                    "socks": "~2.2.0"
-                  },
-                  "dependencies": {
-                    "agent-base": {
-                      "version": "4.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "es6-promisify": "^5.0.0"
-                      },
-                      "dependencies": {
-                        "es6-promisify": {
-                          "version": "5.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "es6-promise": "^4.0.3"
-                          },
-                          "dependencies": {
-                            "es6-promise": {
-                              "version": "4.2.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "socks": {
-                      "version": "2.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "ip": "^1.1.5",
-                        "smart-buffer": "^4.0.1"
-                      },
-                      "dependencies": {
-                        "ip": {
-                          "version": "1.1.5",
-                          "bundled": true
-                        },
-                        "smart-buffer": {
-                          "version": "4.0.1",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            },
-            "minimatch": {
-              "version": "3.0.4",
-              "bundled": true,
-              "requires": {
-                "brace-expansion": "^1.1.7"
-              },
-              "dependencies": {
-                "brace-expansion": {
-                  "version": "1.1.11",
-                  "bundled": true,
-                  "requires": {
-                    "balanced-match": "^1.0.0",
-                    "concat-map": "0.0.1"
-                  },
-                  "dependencies": {
-                    "balanced-match": {
-                      "version": "1.0.0",
-                      "bundled": true
-                    },
-                    "concat-map": {
-                      "version": "0.0.1",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            },
-            "minipass": {
-              "version": "2.3.3",
-              "bundled": true,
-              "requires": {
-                "safe-buffer": "^5.1.2",
-                "yallist": "^3.0.0"
-              },
-              "dependencies": {
-                "yallist": {
-                  "version": "3.0.2",
-                  "bundled": true
-                }
-              }
-            },
-            "promise-retry": {
-              "version": "1.1.1",
-              "bundled": true,
-              "requires": {
-                "err-code": "^1.0.0",
-                "retry": "^0.10.0"
-              },
-              "dependencies": {
-                "err-code": {
-                  "version": "1.1.2",
-                  "bundled": true
-                },
-                "retry": {
-                  "version": "0.10.1",
-                  "bundled": true
-                }
-              }
-            },
-            "protoduck": {
-              "version": "5.0.0",
-              "bundled": true,
-              "requires": {
-                "genfun": "^4.0.1"
-              },
-              "dependencies": {
-                "genfun": {
-                  "version": "4.0.1",
-                  "bundled": true
-                }
-              }
             }
           }
         },
-        "path-is-inside": {
-          "version": "1.0.2",
+        "promzard": {
+          "version": "0.3.0",
+          "bundled": true,
+          "requires": {
+            "read": "1"
+          }
+        },
+        "proto-list": {
+          "version": "1.2.4",
           "bundled": true
         },
-        "promise-inflight": {
+        "protoduck": {
+          "version": "5.0.0",
+          "bundled": true,
+          "requires": {
+            "genfun": "^4.0.1"
+          }
+        },
+        "prr": {
           "version": "1.0.1",
           "bundled": true
         },
+        "pseudomap": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "pump": {
+          "version": "3.0.0",
+          "bundled": true,
+          "requires": {
+            "end-of-stream": "^1.1.0",
+            "once": "^1.3.1"
+          }
+        },
+        "pumpify": {
+          "version": "1.5.1",
+          "bundled": true,
+          "requires": {
+            "duplexify": "^3.6.0",
+            "inherits": "^2.0.3",
+            "pump": "^2.0.0"
+          },
+          "dependencies": {
+            "pump": {
+              "version": "2.0.1",
+              "bundled": true,
+              "requires": {
+                "end-of-stream": "^1.1.0",
+                "once": "^1.3.1"
+              }
+            }
+          }
+        },
+        "punycode": {
+          "version": "1.4.1",
+          "bundled": true
+        },
         "qrcode-terminal": {
           "version": "0.12.0",
           "bundled": true
         },
+        "qs": {
+          "version": "6.4.0",
+          "bundled": true
+        },
         "query-string": {
           "version": "6.1.0",
           "bundled": true,
           "requires": {
             "decode-uri-component": "^0.2.0",
             "strict-uri-encode": "^2.0.0"
-          },
-          "dependencies": {
-            "decode-uri-component": {
-              "version": "0.2.0",
-              "bundled": true
-            },
-            "strict-uri-encode": {
-              "version": "2.0.0",
-              "bundled": true
-            }
           }
         },
         "qw": {
           "version": "1.0.1",
           "bundled": true
         },
-        "read": {
-          "version": "1.0.7",
+        "rc": {
+          "version": "1.2.7",
           "bundled": true,
           "requires": {
-            "mute-stream": "~0.0.4"
+            "deep-extend": "^0.5.1",
+            "ini": "~1.3.0",
+            "minimist": "^1.2.0",
+            "strip-json-comments": "~2.0.1"
           },
           "dependencies": {
-            "mute-stream": {
-              "version": "0.0.7",
+            "minimist": {
+              "version": "1.2.0",
               "bundled": true
             }
           }
         },
+        "read": {
+          "version": "1.0.7",
+          "bundled": true,
+          "requires": {
+            "mute-stream": "~0.0.4"
+          }
+        },
         "read-cmd-shim": {
           "version": "1.0.1",
           "bundled": true,
@@ -9315,12 +7474,6 @@
             "semver": "2 || 3 || 4 || 5",
             "slide": "~1.1.3",
             "util-extend": "^1.0.1"
-          },
-          "dependencies": {
-            "util-extend": {
-              "version": "1.0.3",
-              "bundled": true
-            }
           }
         },
         "read-package-json": {
@@ -9332,16 +7485,6 @@
             "json-parse-better-errors": "^1.0.1",
             "normalize-package-data": "^2.0.0",
             "slash": "^1.0.0"
-          },
-          "dependencies": {
-            "json-parse-better-errors": {
-              "version": "1.0.1",
-              "bundled": true
-            },
-            "slash": {
-              "version": "1.0.0",
-              "bundled": true
-            }
           }
         },
         "read-package-tree": {
@@ -9366,31 +7509,6 @@
             "safe-buffer": "~5.1.1",
             "string_decoder": "~1.1.1",
             "util-deprecate": "~1.0.1"
-          },
-          "dependencies": {
-            "core-util-is": {
-              "version": "1.0.2",
-              "bundled": true
-            },
-            "isarray": {
-              "version": "1.0.0",
-              "bundled": true
-            },
-            "process-nextick-args": {
-              "version": "2.0.0",
-              "bundled": true
-            },
-            "string_decoder": {
-              "version": "1.1.1",
-              "bundled": true,
-              "requires": {
-                "safe-buffer": "~5.1.0"
-              }
-            },
-            "util-deprecate": {
-              "version": "1.0.2",
-              "bundled": true
-            }
           }
         },
         "readdir-scoped-modules": {
@@ -9403,338 +7521,61 @@
             "once": "^1.3.0"
           }
         },
+        "registry-auth-token": {
+          "version": "3.3.2",
+          "bundled": true,
+          "requires": {
+            "rc": "^1.1.6",
+            "safe-buffer": "^5.0.1"
+          }
+        },
+        "registry-url": {
+          "version": "3.1.0",
+          "bundled": true,
+          "requires": {
+            "rc": "^1.0.1"
+          }
+        },
         "request": {
-          "version": "2.86.0",
+          "version": "2.81.0",
           "bundled": true,
           "requires": {
-            "aws-sign2": "~0.7.0",
-            "aws4": "^1.6.0",
+            "aws-sign2": "~0.6.0",
+            "aws4": "^1.2.1",
             "caseless": "~0.12.0",
             "combined-stream": "~1.0.5",
-            "extend": "~3.0.1",
+            "extend": "~3.0.0",
             "forever-agent": "~0.6.1",
-            "form-data": "~2.3.1",
-            "har-validator": "~5.0.3",
-            "hawk": "~6.0.2",
-            "http-signature": "~1.2.0",
+            "form-data": "~2.1.1",
+            "har-validator": "~4.2.1",
+            "hawk": "~3.1.3",
+            "http-signature": "~1.1.0",
             "is-typedarray": "~1.0.0",
             "isstream": "~0.1.2",
             "json-stringify-safe": "~5.0.1",
-            "mime-types": "~2.1.17",
-            "oauth-sign": "~0.8.2",
-            "performance-now": "^2.1.0",
-            "qs": "~6.5.1",
-            "safe-buffer": "^5.1.1",
-            "tough-cookie": "~2.3.3",
+            "mime-types": "~2.1.7",
+            "oauth-sign": "~0.8.1",
+            "performance-now": "^0.2.0",
+            "qs": "~6.4.0",
+            "safe-buffer": "^5.0.1",
+            "stringstream": "~0.0.4",
+            "tough-cookie": "~2.3.0",
             "tunnel-agent": "^0.6.0",
-            "uuid": "^3.1.0"
-          },
-          "dependencies": {
-            "aws-sign2": {
-              "version": "0.7.0",
-              "bundled": true
-            },
-            "aws4": {
-              "version": "1.7.0",
-              "bundled": true
-            },
-            "caseless": {
-              "version": "0.12.0",
-              "bundled": true
-            },
-            "combined-stream": {
-              "version": "1.0.6",
-              "bundled": true,
-              "requires": {
-                "delayed-stream": "~1.0.0"
-              },
-              "dependencies": {
-                "delayed-stream": {
-                  "version": "1.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "extend": {
-              "version": "3.0.1",
-              "bundled": true
-            },
-            "forever-agent": {
-              "version": "0.6.1",
-              "bundled": true
-            },
-            "form-data": {
-              "version": "2.3.2",
-              "bundled": true,
-              "requires": {
-                "asynckit": "^0.4.0",
-                "combined-stream": "1.0.6",
-                "mime-types": "^2.1.12"
-              },
-              "dependencies": {
-                "asynckit": {
-                  "version": "0.4.0",
-                  "bundled": true
-                }
-              }
-            },
-            "har-validator": {
-              "version": "5.0.3",
-              "bundled": true,
-              "requires": {
-                "ajv": "^5.1.0",
-                "har-schema": "^2.0.0"
-              },
-              "dependencies": {
-                "ajv": {
-                  "version": "5.5.2",
-                  "bundled": true,
-                  "requires": {
-                    "co": "^4.6.0",
-                    "fast-deep-equal": "^1.0.0",
-                    "fast-json-stable-stringify": "^2.0.0",
-                    "json-schema-traverse": "^0.3.0"
-                  },
-                  "dependencies": {
-                    "co": {
-                      "version": "4.6.0",
-                      "bundled": true
-                    },
-                    "fast-deep-equal": {
-                      "version": "1.1.0",
-                      "bundled": true
-                    },
-                    "fast-json-stable-stringify": {
-                      "version": "2.0.0",
-                      "bundled": true
-                    },
-                    "json-schema-traverse": {
-                      "version": "0.3.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "har-schema": {
-                  "version": "2.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "hawk": {
-              "version": "6.0.2",
-              "bundled": true,
-              "requires": {
-                "boom": "4.x.x",
-                "cryptiles": "3.x.x",
-                "hoek": "4.x.x",
-                "sntp": "2.x.x"
-              },
-              "dependencies": {
-                "boom": {
-                  "version": "4.3.1",
-                  "bundled": true,
-                  "requires": {
-                    "hoek": "4.x.x"
-                  }
-                },
-                "cryptiles": {
-                  "version": "3.1.2",
-                  "bundled": true,
-                  "requires": {
-                    "boom": "5.x.x"
-                  },
-                  "dependencies": {
-                    "boom": {
-                      "version": "5.2.0",
-                      "bundled": true,
-                      "requires": {
-                        "hoek": "4.x.x"
-                      }
-                    }
-                  }
-                },
-                "hoek": {
-                  "version": "4.2.1",
-                  "bundled": true
-                },
-                "sntp": {
-                  "version": "2.1.0",
-                  "bundled": true,
-                  "requires": {
-                    "hoek": "4.x.x"
-                  }
-                }
-              }
-            },
-            "http-signature": {
-              "version": "1.2.0",
-              "bundled": true,
-              "requires": {
-                "assert-plus": "^1.0.0",
-                "jsprim": "^1.2.2",
-                "sshpk": "^1.7.0"
-              },
-              "dependencies": {
-                "assert-plus": {
-                  "version": "1.0.0",
-                  "bundled": true
-                },
-                "jsprim": {
-                  "version": "1.4.1",
-                  "bundled": true,
-                  "requires": {
-                    "assert-plus": "1.0.0",
-                    "extsprintf": "1.3.0",
-                    "json-schema": "0.2.3",
-                    "verror": "1.10.0"
-                  },
-                  "dependencies": {
-                    "extsprintf": {
-                      "version": "1.3.0",
-                      "bundled": true
-                    },
-                    "json-schema": {
-                      "version": "0.2.3",
-                      "bundled": true
-                    },
-                    "verror": {
-                      "version": "1.10.0",
-                      "bundled": true,
-                      "requires": {
-                        "assert-plus": "^1.0.0",
-                        "core-util-is": "1.0.2",
-                        "extsprintf": "^1.2.0"
-                      },
-                      "dependencies": {
-                        "core-util-is": {
-                          "version": "1.0.2",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "sshpk": {
-                  "version": "1.14.1",
-                  "bundled": true,
-                  "requires": {
-                    "asn1": "~0.2.3",
-                    "assert-plus": "^1.0.0",
-                    "bcrypt-pbkdf": "^1.0.0",
-                    "dashdash": "^1.12.0",
-                    "ecc-jsbn": "~0.1.1",
-                    "getpass": "^0.1.1",
-                    "jsbn": "~0.1.0",
-                    "tweetnacl": "~0.14.0"
-                  },
-                  "dependencies": {
-                    "asn1": {
-                      "version": "0.2.3",
-                      "bundled": true
-                    },
-                    "bcrypt-pbkdf": {
-                      "version": "1.0.1",
-                      "bundled": true,
-                      "optional": true,
-                      "requires": {
-                        "tweetnacl": "^0.14.3"
-                      }
-                    },
-                    "dashdash": {
-                      "version": "1.14.1",
-                      "bundled": true,
-                      "requires": {
-                        "assert-plus": "^1.0.0"
-                      }
-                    },
-                    "ecc-jsbn": {
-                      "version": "0.1.1",
-                      "bundled": true,
-                      "optional": true,
-                      "requires": {
-                        "jsbn": "~0.1.0"
-                      }
-                    },
-                    "getpass": {
-                      "version": "0.1.7",
-                      "bundled": true,
-                      "requires": {
-                        "assert-plus": "^1.0.0"
-                      }
-                    },
-                    "jsbn": {
-                      "version": "0.1.1",
-                      "bundled": true,
-                      "optional": true
-                    },
-                    "tweetnacl": {
-                      "version": "0.14.5",
-                      "bundled": true,
-                      "optional": true
-                    }
-                  }
-                }
-              }
-            },
-            "is-typedarray": {
-              "version": "1.0.0",
-              "bundled": true
-            },
-            "isstream": {
-              "version": "0.1.2",
-              "bundled": true
-            },
-            "json-stringify-safe": {
-              "version": "5.0.1",
-              "bundled": true
-            },
-            "mime-types": {
-              "version": "2.1.18",
-              "bundled": true,
-              "requires": {
-                "mime-db": "~1.33.0"
-              },
-              "dependencies": {
-                "mime-db": {
-                  "version": "1.33.0",
-                  "bundled": true
-                }
-              }
-            },
-            "oauth-sign": {
-              "version": "0.8.2",
-              "bundled": true
-            },
-            "performance-now": {
-              "version": "2.1.0",
-              "bundled": true
-            },
-            "qs": {
-              "version": "6.5.2",
-              "bundled": true
-            },
-            "tough-cookie": {
-              "version": "2.3.4",
-              "bundled": true,
-              "requires": {
-                "punycode": "^1.4.1"
-              },
-              "dependencies": {
-                "punycode": {
-                  "version": "1.4.1",
-                  "bundled": true
-                }
-              }
-            },
-            "tunnel-agent": {
-              "version": "0.6.0",
-              "bundled": true,
-              "requires": {
-                "safe-buffer": "^5.0.1"
-              }
-            }
+            "uuid": "^3.0.0"
           }
         },
+        "require-directory": {
+          "version": "2.1.1",
+          "bundled": true
+        },
+        "require-main-filename": {
+          "version": "1.0.1",
+          "bundled": true
+        },
+        "resolve-from": {
+          "version": "4.0.0",
+          "bundled": true
+        },
         "retry": {
           "version": "0.12.0",
           "bundled": true
@@ -9746,14 +7587,36 @@
             "glob": "^7.0.5"
           }
         },
+        "run-queue": {
+          "version": "1.0.3",
+          "bundled": true,
+          "requires": {
+            "aproba": "^1.1.1"
+          }
+        },
         "safe-buffer": {
           "version": "5.1.2",
           "bundled": true
         },
+        "safer-buffer": {
+          "version": "2.1.2",
+          "bundled": true
+        },
         "semver": {
           "version": "5.5.0",
           "bundled": true
         },
+        "semver-diff": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "semver": "^5.0.3"
+          }
+        },
+        "set-blocking": {
+          "version": "2.0.0",
+          "bundled": true
+        },
         "sha": {
           "version": "2.0.1",
           "bundled": true,
@@ -9762,10 +7625,56 @@
             "readable-stream": "^2.0.2"
           }
         },
+        "shebang-command": {
+          "version": "1.2.0",
+          "bundled": true,
+          "requires": {
+            "shebang-regex": "^1.0.0"
+          }
+        },
+        "shebang-regex": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "signal-exit": {
+          "version": "3.0.2",
+          "bundled": true
+        },
+        "slash": {
+          "version": "1.0.0",
+          "bundled": true
+        },
         "slide": {
           "version": "1.1.6",
           "bundled": true
         },
+        "smart-buffer": {
+          "version": "4.0.1",
+          "bundled": true
+        },
+        "sntp": {
+          "version": "1.0.9",
+          "bundled": true,
+          "requires": {
+            "hoek": "2.x.x"
+          }
+        },
+        "socks": {
+          "version": "2.2.0",
+          "bundled": true,
+          "requires": {
+            "ip": "^1.1.5",
+            "smart-buffer": "^4.0.1"
+          }
+        },
+        "socks-proxy-agent": {
+          "version": "4.0.1",
+          "bundled": true,
+          "requires": {
+            "agent-base": "~4.2.0",
+            "socks": "~2.2.0"
+          }
+        },
         "sorted-object": {
           "version": "2.0.1",
           "bundled": true
@@ -9784,620 +7693,306 @@
               "requires": {
                 "inherits": "~2.0.1",
                 "readable-stream": "~1.1.10"
-              },
-              "dependencies": {
-                "readable-stream": {
-                  "version": "1.1.14",
-                  "bundled": true,
-                  "requires": {
-                    "core-util-is": "~1.0.0",
-                    "inherits": "~2.0.1",
-                    "isarray": "0.0.1",
-                    "string_decoder": "~0.10.x"
-                  },
-                  "dependencies": {
-                    "core-util-is": {
-                      "version": "1.0.2",
-                      "bundled": true
-                    },
-                    "isarray": {
-                      "version": "0.0.1",
-                      "bundled": true
-                    },
-                    "string_decoder": {
-                      "version": "0.10.31",
-                      "bundled": true
-                    }
-                  }
-                }
               }
             },
-            "stream-iterate": {
-              "version": "1.2.0",
+            "isarray": {
+              "version": "0.0.1",
+              "bundled": true
+            },
+            "readable-stream": {
+              "version": "1.1.14",
               "bundled": true,
               "requires": {
-                "readable-stream": "^2.1.5",
-                "stream-shift": "^1.0.0"
-              },
-              "dependencies": {
-                "stream-shift": {
-                  "version": "1.0.0",
-                  "bundled": true
-                }
+                "core-util-is": "~1.0.0",
+                "inherits": "~2.0.1",
+                "isarray": "0.0.1",
+                "string_decoder": "~0.10.x"
               }
+            },
+            "string_decoder": {
+              "version": "0.10.31",
+              "bundled": true
             }
           }
         },
-        "ssri": {
-          "version": "6.0.0",
+        "spdx-correct": {
+          "version": "3.0.0",
+          "bundled": true,
+          "requires": {
+            "spdx-expression-parse": "^3.0.0",
+            "spdx-license-ids": "^3.0.0"
+          }
+        },
+        "spdx-exceptions": {
+          "version": "2.1.0",
           "bundled": true
         },
-        "strip-ansi": {
-          "version": "4.0.0",
+        "spdx-expression-parse": {
+          "version": "3.0.0",
           "bundled": true,
           "requires": {
-            "ansi-regex": "^3.0.0"
-          },
-          "dependencies": {
-            "ansi-regex": {
-              "version": "3.0.0",
-              "bundled": true
-            }
+            "spdx-exceptions": "^2.1.0",
+            "spdx-license-ids": "^3.0.0"
           }
         },
-        "tar": {
-          "version": "4.4.1",
+        "spdx-license-ids": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "sshpk": {
+          "version": "1.14.2",
           "bundled": true,
           "requires": {
-            "chownr": "^1.0.1",
-            "fs-minipass": "^1.2.5",
-            "minipass": "^2.2.4",
-            "minizlib": "^1.1.0",
-            "mkdirp": "^0.5.0",
-            "safe-buffer": "^5.1.1",
-            "yallist": "^3.0.2"
+            "asn1": "~0.2.3",
+            "assert-plus": "^1.0.0",
+            "bcrypt-pbkdf": "^1.0.0",
+            "dashdash": "^1.12.0",
+            "ecc-jsbn": "~0.1.1",
+            "getpass": "^0.1.1",
+            "jsbn": "~0.1.0",
+            "safer-buffer": "^2.0.2",
+            "tweetnacl": "~0.14.0"
           },
           "dependencies": {
-            "fs-minipass": {
-              "version": "1.2.5",
-              "bundled": true,
-              "requires": {
-                "minipass": "^2.2.1"
-              }
-            },
-            "minipass": {
-              "version": "2.3.1",
-              "bundled": true,
-              "requires": {
-                "safe-buffer": "^5.1.1",
-                "yallist": "^3.0.0"
-              }
-            },
-            "minizlib": {
-              "version": "1.1.0",
-              "bundled": true,
-              "requires": {
-                "minipass": "^2.2.1"
-              }
-            },
-            "yallist": {
-              "version": "3.0.2",
+            "assert-plus": {
+              "version": "1.0.0",
               "bundled": true
             }
           }
         },
-        "text-table": {
-          "version": "0.2.0",
+        "ssri": {
+          "version": "6.0.0",
           "bundled": true
         },
-        "tiny-relative-date": {
-          "version": "1.3.0",
-          "bundled": true
+        "stream-each": {
+          "version": "1.2.2",
+          "bundled": true,
+          "requires": {
+            "end-of-stream": "^1.1.0",
+            "stream-shift": "^1.0.0"
+          }
         },
-        "uid-number": {
-          "version": "0.0.6",
+        "stream-iterate": {
+          "version": "1.2.0",
+          "bundled": true,
+          "requires": {
+            "readable-stream": "^2.1.5",
+            "stream-shift": "^1.0.0"
+          }
+        },
+        "stream-shift": {
+          "version": "1.0.0",
           "bundled": true
         },
-        "umask": {
-          "version": "1.1.0",
+        "strict-uri-encode": {
+          "version": "2.0.0",
           "bundled": true
         },
-        "unique-filename": {
-          "version": "1.1.0",
+        "string-width": {
+          "version": "2.1.1",
           "bundled": true,
           "requires": {
-            "unique-slug": "^2.0.0"
+            "is-fullwidth-code-point": "^2.0.0",
+            "strip-ansi": "^4.0.0"
           },
           "dependencies": {
-            "unique-slug": {
+            "ansi-regex": {
+              "version": "3.0.0",
+              "bundled": true
+            },
+            "is-fullwidth-code-point": {
               "version": "2.0.0",
+              "bundled": true
+            },
+            "strip-ansi": {
+              "version": "4.0.0",
               "bundled": true,
               "requires": {
-                "imurmurhash": "^0.1.4"
+                "ansi-regex": "^3.0.0"
               }
             }
           }
         },
-        "unpipe": {
+        "string_decoder": {
+          "version": "1.1.1",
+          "bundled": true,
+          "requires": {
+            "safe-buffer": "~5.1.0"
+          }
+        },
+        "stringify-package": {
           "version": "1.0.0",
           "bundled": true
         },
-        "update-notifier": {
-          "version": "2.5.0",
+        "stringstream": {
+          "version": "0.0.6",
+          "bundled": true
+        },
+        "strip-ansi": {
+          "version": "3.0.1",
           "bundled": true,
           "requires": {
-            "boxen": "^1.2.1",
-            "chalk": "^2.0.1",
-            "configstore": "^3.0.0",
-            "import-lazy": "^2.1.0",
-            "is-ci": "^1.0.10",
-            "is-installed-globally": "^0.1.0",
-            "is-npm": "^1.0.0",
-            "latest-version": "^3.0.0",
-            "semver-diff": "^2.0.0",
-            "xdg-basedir": "^3.0.0"
+            "ansi-regex": "^2.0.0"
+          }
+        },
+        "strip-eof": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "strip-json-comments": {
+          "version": "2.0.1",
+          "bundled": true
+        },
+        "supports-color": {
+          "version": "5.4.0",
+          "bundled": true,
+          "requires": {
+            "has-flag": "^3.0.0"
+          }
+        },
+        "tar": {
+          "version": "4.4.4",
+          "bundled": true,
+          "requires": {
+            "chownr": "^1.0.1",
+            "fs-minipass": "^1.2.5",
+            "minipass": "^2.3.3",
+            "minizlib": "^1.1.0",
+            "mkdirp": "^0.5.0",
+            "safe-buffer": "^5.1.2",
+            "yallist": "^3.0.2"
           },
           "dependencies": {
-            "boxen": {
-              "version": "1.3.0",
-              "bundled": true,
-              "requires": {
-                "ansi-align": "^2.0.0",
-                "camelcase": "^4.0.0",
-                "chalk": "^2.0.1",
-                "cli-boxes": "^1.0.0",
-                "string-width": "^2.0.0",
-                "term-size": "^1.2.0",
-                "widest-line": "^2.0.0"
-              },
-              "dependencies": {
-                "ansi-align": {
-                  "version": "2.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "string-width": "^2.0.0"
-                  }
-                },
-                "camelcase": {
-                  "version": "4.1.0",
-                  "bundled": true
-                },
-                "cli-boxes": {
-                  "version": "1.0.0",
-                  "bundled": true
-                },
-                "string-width": {
-                  "version": "2.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "is-fullwidth-code-point": "^2.0.0",
-                    "strip-ansi": "^4.0.0"
-                  },
-                  "dependencies": {
-                    "is-fullwidth-code-point": {
-                      "version": "2.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "term-size": {
-                  "version": "1.2.0",
-                  "bundled": true,
-                  "requires": {
-                    "execa": "^0.7.0"
-                  },
-                  "dependencies": {
-                    "execa": {
-                      "version": "0.7.0",
-                      "bundled": true,
-                      "requires": {
-                        "cross-spawn": "^5.0.1",
-                        "get-stream": "^3.0.0",
-                        "is-stream": "^1.1.0",
-                        "npm-run-path": "^2.0.0",
-                        "p-finally": "^1.0.0",
-                        "signal-exit": "^3.0.0",
-                        "strip-eof": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "cross-spawn": {
-                          "version": "5.1.0",
-                          "bundled": true,
-                          "requires": {
-                            "lru-cache": "^4.0.1",
-                            "shebang-command": "^1.2.0",
-                            "which": "^1.2.9"
-                          },
-                          "dependencies": {
-                            "shebang-command": {
-                              "version": "1.2.0",
-                              "bundled": true,
-                              "requires": {
-                                "shebang-regex": "^1.0.0"
-                              },
-                              "dependencies": {
-                                "shebang-regex": {
-                                  "version": "1.0.0",
-                                  "bundled": true
-                                }
-                              }
-                            }
-                          }
-                        },
-                        "get-stream": {
-                          "version": "3.0.0",
-                          "bundled": true
-                        },
-                        "is-stream": {
-                          "version": "1.1.0",
-                          "bundled": true
-                        },
-                        "npm-run-path": {
-                          "version": "2.0.2",
-                          "bundled": true,
-                          "requires": {
-                            "path-key": "^2.0.0"
-                          },
-                          "dependencies": {
-                            "path-key": {
-                              "version": "2.0.1",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "p-finally": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        },
-                        "signal-exit": {
-                          "version": "3.0.2",
-                          "bundled": true
-                        },
-                        "strip-eof": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "widest-line": {
-                  "version": "2.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "string-width": "^2.1.1"
-                  }
-                }
-              }
-            },
-            "chalk": {
-              "version": "2.4.1",
-              "bundled": true,
-              "requires": {
-                "ansi-styles": "^3.2.1",
-                "escape-string-regexp": "^1.0.5",
-                "supports-color": "^5.3.0"
-              },
-              "dependencies": {
-                "ansi-styles": {
-                  "version": "3.2.1",
-                  "bundled": true,
-                  "requires": {
-                    "color-convert": "^1.9.0"
-                  },
-                  "dependencies": {
-                    "color-convert": {
-                      "version": "1.9.1",
-                      "bundled": true,
-                      "requires": {
-                        "color-name": "^1.1.1"
-                      },
-                      "dependencies": {
-                        "color-name": {
-                          "version": "1.1.3",
-                          "bundled": true
-                        }
-                      }
-                    }
-                  }
-                },
-                "escape-string-regexp": {
-                  "version": "1.0.5",
-                  "bundled": true
-                },
-                "supports-color": {
-                  "version": "5.4.0",
-                  "bundled": true,
-                  "requires": {
-                    "has-flag": "^3.0.0"
-                  },
-                  "dependencies": {
-                    "has-flag": {
-                      "version": "3.0.0",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            },
-            "configstore": {
-              "version": "3.1.2",
-              "bundled": true,
-              "requires": {
-                "dot-prop": "^4.1.0",
-                "graceful-fs": "^4.1.2",
-                "make-dir": "^1.0.0",
-                "unique-string": "^1.0.0",
-                "write-file-atomic": "^2.0.0",
-                "xdg-basedir": "^3.0.0"
-              },
-              "dependencies": {
-                "dot-prop": {
-                  "version": "4.2.0",
-                  "bundled": true,
-                  "requires": {
-                    "is-obj": "^1.0.0"
-                  },
-                  "dependencies": {
-                    "is-obj": {
-                      "version": "1.0.1",
-                      "bundled": true
-                    }
-                  }
-                },
-                "make-dir": {
-                  "version": "1.2.0",
-                  "bundled": true,
-                  "requires": {
-                    "pify": "^3.0.0"
-                  },
-                  "dependencies": {
-                    "pify": {
-                      "version": "3.0.0",
-                      "bundled": true
-                    }
-                  }
-                },
-                "unique-string": {
-                  "version": "1.0.0",
-                  "bundled": true,
-                  "requires": {
-                    "crypto-random-string": "^1.0.0"
-                  },
-                  "dependencies": {
-                    "crypto-random-string": {
-                      "version": "1.0.0",
-                      "bundled": true
-                    }
-                  }
-                }
-              }
-            },
-            "import-lazy": {
-              "version": "2.1.0",
-              "bundled": true
-            },
-            "is-ci": {
-              "version": "1.1.0",
-              "bundled": true,
-              "requires": {
-                "ci-info": "^1.0.0"
-              },
-              "dependencies": {
-                "ci-info": {
-                  "version": "1.1.3",
-                  "bundled": true
-                }
-              }
-            },
-            "is-installed-globally": {
-              "version": "0.1.0",
-              "bundled": true,
-              "requires": {
-                "global-dirs": "^0.1.0",
-                "is-path-inside": "^1.0.0"
-              },
-              "dependencies": {
-                "global-dirs": {
-                  "version": "0.1.1",
-                  "bundled": true,
-                  "requires": {
-                    "ini": "^1.3.4"
-                  }
-                },
-                "is-path-inside": {
-                  "version": "1.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "path-is-inside": "^1.0.1"
-                  }
-                }
-              }
-            },
-            "is-npm": {
-              "version": "1.0.0",
-              "bundled": true
-            },
-            "latest-version": {
-              "version": "3.1.0",
-              "bundled": true,
-              "requires": {
-                "package-json": "^4.0.0"
-              },
-              "dependencies": {
-                "package-json": {
-                  "version": "4.0.1",
-                  "bundled": true,
-                  "requires": {
-                    "got": "^6.7.1",
-                    "registry-auth-token": "^3.0.1",
-                    "registry-url": "^3.0.3",
-                    "semver": "^5.1.0"
-                  },
-                  "dependencies": {
-                    "got": {
-                      "version": "6.7.1",
-                      "bundled": true,
-                      "requires": {
-                        "create-error-class": "^3.0.0",
-                        "duplexer3": "^0.1.4",
-                        "get-stream": "^3.0.0",
-                        "is-redirect": "^1.0.0",
-                        "is-retry-allowed": "^1.0.0",
-                        "is-stream": "^1.0.0",
-                        "lowercase-keys": "^1.0.0",
-                        "safe-buffer": "^5.0.1",
-                        "timed-out": "^4.0.0",
-                        "unzip-response": "^2.0.1",
-                        "url-parse-lax": "^1.0.0"
-                      },
-                      "dependencies": {
-                        "create-error-class": {
-                          "version": "3.0.2",
-                          "bundled": true,
-                          "requires": {
-                            "capture-stack-trace": "^1.0.0"
-                          },
-                          "dependencies": {
-                            "capture-stack-trace": {
-                              "version": "1.0.0",
-                              "bundled": true
-                            }
-                          }
-                        },
-                        "duplexer3": {
-                          "version": "0.1.4",
-                          "bundled": true
-                        },
-                        "get-stream": {
-                          "version": "3.0.0",
-                          "bundled": true
-                        },
-                        "is-redirect": {
-                          "version": "1.0.0",
-                          "bundled": true
-                        },
-                        "is-retry-allowed": {
-                          "version": "1.1.0",
-                          "bundled": true
-                        },
-                        "is-stream": {
-                          "version": "1.1.0",
-                          "bundled": true
-                        },
-                        "lowercase-keys": {
-                          "version": "1.0.1",
-                          "bundled": true
-                        },
-                        "timed-out": {
-                          "version": "4.0.1",
-                          "bundled": true
-                        },
-                        "unzip-response": {
-                          "version": "2.0.1",
-                          "bundled": true
-                        },
-                        "url-parse-lax": {
-                          "version": "1.0.0",
-                          "bundled": true,
-                          "requires": {
-                            "prepend-http": "^1.0.1"
-                          },
-                          "dependencies": {
-                            "prepend-http": {
-                              "version": "1.0.4",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "registry-auth-token": {
-                      "version": "3.3.2",
-                      "bundled": true,
-                      "requires": {
-                        "rc": "^1.1.6",
-                        "safe-buffer": "^5.0.1"
-                      },
-                      "dependencies": {
-                        "rc": {
-                          "version": "1.2.7",
-                          "bundled": true,
-                          "requires": {
-                            "deep-extend": "^0.5.1",
-                            "ini": "~1.3.0",
-                            "minimist": "^1.2.0",
-                            "strip-json-comments": "~2.0.1"
-                          },
-                          "dependencies": {
-                            "deep-extend": {
-                              "version": "0.5.1",
-                              "bundled": true
-                            },
-                            "minimist": {
-                              "version": "1.2.0",
-                              "bundled": true
-                            },
-                            "strip-json-comments": {
-                              "version": "2.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    },
-                    "registry-url": {
-                      "version": "3.1.0",
-                      "bundled": true,
-                      "requires": {
-                        "rc": "^1.0.1"
-                      },
-                      "dependencies": {
-                        "rc": {
-                          "version": "1.2.7",
-                          "bundled": true,
-                          "requires": {
-                            "deep-extend": "^0.5.1",
-                            "ini": "~1.3.0",
-                            "minimist": "^1.2.0",
-                            "strip-json-comments": "~2.0.1"
-                          },
-                          "dependencies": {
-                            "deep-extend": {
-                              "version": "0.5.1",
-                              "bundled": true
-                            },
-                            "minimist": {
-                              "version": "1.2.0",
-                              "bundled": true
-                            },
-                            "strip-json-comments": {
-                              "version": "2.0.1",
-                              "bundled": true
-                            }
-                          }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            },
-            "semver-diff": {
-              "version": "2.1.0",
-              "bundled": true,
-              "requires": {
-                "semver": "^5.0.3"
-              }
-            },
-            "xdg-basedir": {
-              "version": "3.0.0",
+            "yallist": {
+              "version": "3.0.2",
               "bundled": true
             }
           }
         },
+        "term-size": {
+          "version": "1.2.0",
+          "bundled": true,
+          "requires": {
+            "execa": "^0.7.0"
+          }
+        },
+        "text-table": {
+          "version": "0.2.0",
+          "bundled": true
+        },
+        "through": {
+          "version": "2.3.8",
+          "bundled": true
+        },
+        "through2": {
+          "version": "2.0.3",
+          "bundled": true,
+          "requires": {
+            "readable-stream": "^2.1.5",
+            "xtend": "~4.0.1"
+          }
+        },
+        "timed-out": {
+          "version": "4.0.1",
+          "bundled": true
+        },
+        "tiny-relative-date": {
+          "version": "1.3.0",
+          "bundled": true
+        },
+        "tough-cookie": {
+          "version": "2.3.4",
+          "bundled": true,
+          "requires": {
+            "punycode": "^1.4.1"
+          }
+        },
+        "tunnel-agent": {
+          "version": "0.6.0",
+          "bundled": true,
+          "requires": {
+            "safe-buffer": "^5.0.1"
+          }
+        },
+        "tweetnacl": {
+          "version": "0.14.5",
+          "bundled": true,
+          "optional": true
+        },
+        "typedarray": {
+          "version": "0.0.6",
+          "bundled": true
+        },
+        "uid-number": {
+          "version": "0.0.6",
+          "bundled": true
+        },
+        "umask": {
+          "version": "1.1.0",
+          "bundled": true
+        },
+        "unique-filename": {
+          "version": "1.1.0",
+          "bundled": true,
+          "requires": {
+            "unique-slug": "^2.0.0"
+          }
+        },
+        "unique-slug": {
+          "version": "2.0.0",
+          "bundled": true,
+          "requires": {
+            "imurmurhash": "^0.1.4"
+          }
+        },
+        "unique-string": {
+          "version": "1.0.0",
+          "bundled": true,
+          "requires": {
+            "crypto-random-string": "^1.0.0"
+          }
+        },
+        "unpipe": {
+          "version": "1.0.0",
+          "bundled": true
+        },
+        "unzip-response": {
+          "version": "2.0.1",
+          "bundled": true
+        },
+        "update-notifier": {
+          "version": "2.5.0",
+          "bundled": true,
+          "requires": {
+            "boxen": "^1.2.1",
+            "chalk": "^2.0.1",
+            "configstore": "^3.0.0",
+            "import-lazy": "^2.1.0",
+            "is-ci": "^1.0.10",
+            "is-installed-globally": "^0.1.0",
+            "is-npm": "^1.0.0",
+            "latest-version": "^3.0.0",
+            "semver-diff": "^2.0.0",
+            "xdg-basedir": "^3.0.0"
+          }
+        },
+        "url-parse-lax": {
+          "version": "1.0.0",
+          "bundled": true,
+          "requires": {
+            "prepend-http": "^1.0.1"
+          }
+        },
+        "util-deprecate": {
+          "version": "1.0.2",
+          "bundled": true
+        },
+        "util-extend": {
+          "version": "1.0.3",
+          "bundled": true
+        },
         "uuid": {
-          "version": "3.2.1",
+          "version": "3.3.2",
           "bundled": true
         },
         "validate-npm-package-license": {
@@ -10406,40 +8001,6 @@
           "requires": {
             "spdx-correct": "^3.0.0",
             "spdx-expression-parse": "^3.0.0"
-          },
-          "dependencies": {
-            "spdx-correct": {
-              "version": "3.0.0",
-              "bundled": true,
-              "requires": {
-                "spdx-expression-parse": "^3.0.0",
-                "spdx-license-ids": "^3.0.0"
-              },
-              "dependencies": {
-                "spdx-license-ids": {
-                  "version": "3.0.0",
-                  "bundled": true
-                }
-              }
-            },
-            "spdx-expression-parse": {
-              "version": "3.0.0",
-              "bundled": true,
-              "requires": {
-                "spdx-exceptions": "^2.1.0",
-                "spdx-license-ids": "^3.0.0"
-              },
-              "dependencies": {
-                "spdx-exceptions": {
-                  "version": "2.1.0",
-                  "bundled": true
-                },
-                "spdx-license-ids": {
-                  "version": "3.0.0",
-                  "bundled": true
-                }
-              }
-            }
           }
         },
         "validate-npm-package-name": {
@@ -10447,45 +8008,88 @@
           "bundled": true,
           "requires": {
             "builtins": "^1.0.3"
+          }
+        },
+        "verror": {
+          "version": "1.10.0",
+          "bundled": true,
+          "requires": {
+            "assert-plus": "^1.0.0",
+            "core-util-is": "1.0.2",
+            "extsprintf": "^1.2.0"
           },
           "dependencies": {
-            "builtins": {
-              "version": "1.0.3",
+            "assert-plus": {
+              "version": "1.0.0",
               "bundled": true
             }
           }
         },
+        "wcwidth": {
+          "version": "1.0.1",
+          "bundled": true,
+          "requires": {
+            "defaults": "^1.0.3"
+          }
+        },
         "which": {
-          "version": "1.3.0",
+          "version": "1.3.1",
           "bundled": true,
           "requires": {
             "isexe": "^2.0.0"
+          }
+        },
+        "which-module": {
+          "version": "2.0.0",
+          "bundled": true
+        },
+        "wide-align": {
+          "version": "1.1.2",
+          "bundled": true,
+          "requires": {
+            "string-width": "^1.0.2"
           },
           "dependencies": {
-            "isexe": {
-              "version": "2.0.0",
-              "bundled": true
+            "string-width": {
+              "version": "1.0.2",
+              "bundled": true,
+              "requires": {
+                "code-point-at": "^1.0.0",
+                "is-fullwidth-code-point": "^1.0.0",
+                "strip-ansi": "^3.0.0"
+              }
             }
           }
         },
+        "widest-line": {
+          "version": "2.0.0",
+          "bundled": true,
+          "requires": {
+            "string-width": "^2.1.1"
+          }
+        },
         "worker-farm": {
           "version": "1.6.0",
           "bundled": true,
           "requires": {
             "errno": "~0.1.7"
+          }
+        },
+        "wrap-ansi": {
+          "version": "2.1.0",
+          "bundled": true,
+          "requires": {
+            "string-width": "^1.0.1",
+            "strip-ansi": "^3.0.1"
           },
           "dependencies": {
-            "errno": {
-              "version": "0.1.7",
+            "string-width": {
+              "version": "1.0.2",
               "bundled": true,
               "requires": {
-                "prr": "~1.0.1"
-              },
-              "dependencies": {
-                "prr": {
-                  "version": "1.0.1",
-                  "bundled": true
-                }
+                "code-point-at": "^1.0.0",
+                "is-fullwidth-code-point": "^1.0.0",
+                "strip-ansi": "^3.0.0"
               }
             }
           }
@@ -10501,13 +8105,54 @@
             "graceful-fs": "^4.1.11",
             "imurmurhash": "^0.1.4",
             "signal-exit": "^3.0.2"
+          }
+        },
+        "xdg-basedir": {
+          "version": "3.0.0",
+          "bundled": true
+        },
+        "xtend": {
+          "version": "4.0.1",
+          "bundled": true
+        },
+        "y18n": {
+          "version": "4.0.0",
+          "bundled": true
+        },
+        "yallist": {
+          "version": "2.1.2",
+          "bundled": true
+        },
+        "yargs": {
+          "version": "11.0.0",
+          "bundled": true,
+          "requires": {
+            "cliui": "^4.0.0",
+            "decamelize": "^1.1.1",
+            "find-up": "^2.1.0",
+            "get-caller-file": "^1.0.1",
+            "os-locale": "^2.0.0",
+            "require-directory": "^2.1.1",
+            "require-main-filename": "^1.0.1",
+            "set-blocking": "^2.0.0",
+            "string-width": "^2.0.0",
+            "which-module": "^2.0.0",
+            "y18n": "^3.2.1",
+            "yargs-parser": "^9.0.2"
           },
           "dependencies": {
-            "signal-exit": {
-              "version": "3.0.2",
+            "y18n": {
+              "version": "3.2.1",
               "bundled": true
             }
           }
+        },
+        "yargs-parser": {
+          "version": "9.0.2",
+          "bundled": true,
+          "requires": {
+            "camelcase": "^4.1.0"
+          }
         }
       }
     },
@@ -12329,9 +9974,9 @@
       }
     },
     "rxjs": {
-      "version": "6.2.1",
-      "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-6.2.1.tgz",
-      "integrity": "sha512-OwMxHxmnmHTUpgO+V7dZChf3Tixf4ih95cmXjzzadULziVl/FKhHScGLj4goEw9weePVOH2Q0+GcCBUhKCZc/g==",
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-6.2.2.tgz",
+      "integrity": "sha512-0MI8+mkKAXZUF9vMrEoPnaoHkfzBPP4IGwUYRJhIRJF6/w3uByO1e91bEHn8zd43RdkTMKiooYKmwz7RH6zfOQ==",
       "dev": true,
       "requires": {
         "tslib": "^1.9.0"
@@ -13270,21 +10915,10 @@
       }
     },
     "use": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/use/-/use-3.1.0.tgz",
-      "integrity": "sha512-6UJEQM/L+mzC3ZJNM56Q4DFGLX/evKGRg15UJHGB9X5j5Z3AFbgZvjUh2yq/UJUY4U5dh7Fal++XbNg1uzpRAw==",
-      "dev": true,
-      "requires": {
-        "kind-of": "^6.0.2"
-      },
-      "dependencies": {
-        "kind-of": {
-          "version": "6.0.2",
-          "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.2.tgz",
-          "integrity": "sha512-s5kLOcnH0XqDO+FvuaLX8DDjZ18CGFk7VygH40QoKPUQhW4e2rvM0rwUq0t8IQDOwYSeLK01U90OjzBTme2QqA==",
-          "dev": true
-        }
-      }
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/use/-/use-3.1.1.tgz",
+      "integrity": "sha512-cwESVXlO3url9YWlFW/TA9cshCEhtu7IKJ/p5soJ/gGpj7vbvFrAY/eIioQ6Dw23KjZhYgiIo8HOs1nQ2vr/oQ==",
+      "dev": true
     },
     "util": {
       "version": "0.10.4",
@@ -13350,9 +10984,9 @@
       }
     },
     "webpack": {
-      "version": "4.15.1",
-      "resolved": "https://registry.npmjs.org/webpack/-/webpack-4.15.1.tgz",
-      "integrity": "sha512-UwfFQ2plA5EMhhzwi/hl5xpLk7mNK7p0853Ml04z1Bqw553pY+oS8Xke3funcVy7eG/yMpZPvnlFTUyGKyKoyw==",
+      "version": "4.16.3",
+      "resolved": "https://registry.npmjs.org/webpack/-/webpack-4.16.3.tgz",
+      "integrity": "sha512-3VcrVoFgzSz1IYgga71YpU3HO89Al5bSnDOj9RJQPsy+FNyI1sFsUyJITn3pktNuaRBlQT0usvKZE3GgkPGAIw==",
       "dev": true,
       "requires": {
         "@webassemblyjs/ast": "1.5.13",
@@ -13366,7 +11000,7 @@
         "ajv-keywords": "^3.1.0",
         "chrome-trace-event": "^1.0.0",
         "enhanced-resolve": "^4.1.0",
-        "eslint-scope": "^3.7.1",
+        "eslint-scope": "^4.0.0",
         "json-parse-better-errors": "^1.0.2",
         "loader-runner": "^2.3.0",
         "loader-utils": "^1.1.0",
@@ -13380,12 +11014,30 @@
         "uglifyjs-webpack-plugin": "^1.2.4",
         "watchpack": "^1.5.0",
         "webpack-sources": "^1.0.1"
+      },
+      "dependencies": {
+        "eslint-scope": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-4.0.0.tgz",
+          "integrity": "sha512-1G6UTDi7Jc1ELFwnR58HV4fK9OQK4S6N985f166xqXxpjU6plxFISJa2Ba9KCQuFa8RCnj/lSFJbHo7UFDBnUA==",
+          "dev": true,
+          "requires": {
+            "esrecurse": "^4.1.0",
+            "estraverse": "^4.1.1"
+          }
+        },
+        "estraverse": {
+          "version": "4.2.0",
+          "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.2.0.tgz",
+          "integrity": "sha1-De4/7TH81GlhjOc0IJn8GvoL2xM=",
+          "dev": true
+        }
       }
     },
     "webpack-cli": {
-      "version": "3.0.8",
-      "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-3.0.8.tgz",
-      "integrity": "sha512-KnRLJ0BUaYRqrhAMb9dv3gzdmhmgIMKo0FmdsnmfqbPGtLnnZ6tORZAvmmKfr+A0VgiVpqC60Gv7Ofg0R2CHtQ==",
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/webpack-cli/-/webpack-cli-3.1.0.tgz",
+      "integrity": "sha512-p5NeKDtYwjZozUWq6kGNs9w+Gtw/CPvyuXjXn2HMdz8Tie+krjEg8oAtonvIyITZdvpF7XG9xDHwscLr2c+ugQ==",
       "dev": true,
       "requires": {
         "chalk": "^2.4.1",
@@ -13398,7 +11050,7 @@
         "loader-utils": "^1.1.0",
         "supports-color": "^5.4.0",
         "v8-compile-cache": "^2.0.0",
-        "yargs": "^11.1.0"
+        "yargs": "^12.0.1"
       },
       "dependencies": {
         "ansi-regex": {
@@ -13438,12 +11090,64 @@
             "wrap-ansi": "^2.0.0"
           }
         },
+        "decamelize": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-2.0.0.tgz",
+          "integrity": "sha512-Ikpp5scV3MSYxY39ymh45ZLEecsTdv/Xj2CaQfI8RLMuwi7XvjX9H/fhraiSuU+C5w5NTDu4ZU72xNiZnurBPg==",
+          "dev": true,
+          "requires": {
+            "xregexp": "4.0.0"
+          }
+        },
+        "find-up": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/find-up/-/find-up-3.0.0.tgz",
+          "integrity": "sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==",
+          "dev": true,
+          "requires": {
+            "locate-path": "^3.0.0"
+          }
+        },
         "has-flag": {
           "version": "3.0.0",
           "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
           "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=",
           "dev": true
         },
+        "locate-path": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-3.0.0.tgz",
+          "integrity": "sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==",
+          "dev": true,
+          "requires": {
+            "p-locate": "^3.0.0",
+            "path-exists": "^3.0.0"
+          }
+        },
+        "p-limit": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.0.0.tgz",
+          "integrity": "sha512-fl5s52lI5ahKCernzzIyAP0QAZbGIovtVHGwpcu1Jr/EpzLVDI2myISHwGqK7m8uQFugVWSrbxH7XnhGtvEc+A==",
+          "dev": true,
+          "requires": {
+            "p-try": "^2.0.0"
+          }
+        },
+        "p-locate": {
+          "version": "3.0.0",
+          "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-3.0.0.tgz",
+          "integrity": "sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==",
+          "dev": true,
+          "requires": {
+            "p-limit": "^2.0.0"
+          }
+        },
+        "p-try": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.0.0.tgz",
+          "integrity": "sha512-hMp0onDKIajHfIkdRk3P4CdCmErkYAxxDtP3Wx/4nZ3aGlau2VKh3mZpcuFkH27WQkL/3WBCPOktzA9ZOAnMQQ==",
+          "dev": true
+        },
         "strip-ansi": {
           "version": "4.0.0",
           "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-4.0.0.tgz",
@@ -13462,21 +11166,15 @@
             "has-flag": "^3.0.0"
           }
         },
-        "y18n": {
-          "version": "3.2.1",
-          "resolved": "https://registry.npmjs.org/y18n/-/y18n-3.2.1.tgz",
-          "integrity": "sha1-bRX7qITAhnnA136I53WegR4H+kE=",
-          "dev": true
-        },
         "yargs": {
-          "version": "11.1.0",
-          "resolved": "https://registry.npmjs.org/yargs/-/yargs-11.1.0.tgz",
-          "integrity": "sha512-NwW69J42EsCSanF8kyn5upxvjp5ds+t3+udGBeTbFnERA+lF541DDpMawzo4z6W/QrzNM18D+BPMiOBibnFV5A==",
+          "version": "12.0.1",
+          "resolved": "https://registry.npmjs.org/yargs/-/yargs-12.0.1.tgz",
+          "integrity": "sha512-B0vRAp1hRX4jgIOWFtjfNjd9OA9RWYZ6tqGA9/I/IrTMsxmKvtWy+ersM+jzpQqbC3YfLzeABPdeTgcJ9eu1qQ==",
           "dev": true,
           "requires": {
             "cliui": "^4.0.0",
-            "decamelize": "^1.1.1",
-            "find-up": "^2.1.0",
+            "decamelize": "^2.0.0",
+            "find-up": "^3.0.0",
             "get-caller-file": "^1.0.1",
             "os-locale": "^2.0.0",
             "require-directory": "^2.1.1",
@@ -13484,8 +11182,8 @@
             "set-blocking": "^2.0.0",
             "string-width": "^2.0.0",
             "which-module": "^2.0.0",
-            "y18n": "^3.2.1",
-            "yargs-parser": "^9.0.2"
+            "y18n": "^3.2.1 || ^4.0.0",
+            "yargs-parser": "^10.1.0"
           }
         }
       }
@@ -13658,6 +11356,12 @@
         "mkdirp": "^0.5.1"
       }
     },
+    "xregexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/xregexp/-/xregexp-4.0.0.tgz",
+      "integrity": "sha512-PHyM+sQouu7xspQQwELlGwwd05mXUFqwFYfqPO0cC7x4fxyHnnuetmQr6CjJiafIDoH4MogHb9dOoJzR/Y4rFg==",
+      "dev": true
+    },
     "xtend": {
       "version": "4.0.1",
       "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz",
@@ -13690,9 +11394,9 @@
       }
     },
     "yargs-parser": {
-      "version": "9.0.2",
-      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-9.0.2.tgz",
-      "integrity": "sha1-nM9qQ0YP5O1Aqbto9I1DuKaMwHc=",
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-10.1.0.tgz",
+      "integrity": "sha512-VCIyR1wJoEBZUqk5PA+oOBF6ypbwh5aNB3I50guxAL/quggdfs4TtNHQrSazFA3fYZ+tEqfs0zIGlv0c/rgjbQ==",
       "dev": true,
       "requires": {
         "camelcase": "^4.1.0"
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index 0608e9a504cd9..5d40eb6b11a4e 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -48,8 +48,8 @@
     "mini-css-extract-plugin": "^0.4.1",
     "style-loader": "^0.21.0",
     "url-loader": "^1.0.1",
-    "webpack": "^4.12.2",
-    "webpack-cli": "^3.0.8",
+    "webpack": "^4.16.3",
+    "webpack-cli": "^3.1.0",
     "webpack-manifest-plugin": "^2.0.3"
   },
   "dependencies": {
@@ -60,7 +60,8 @@
     "dagre-d3": "^0.4.18",
     "datatables.net": "^1.10.19",
     "datatables.net-bs": "^1.10.19",
-    "npm": "^6.1.0",
+    "moment-timezone": "^0.5.21",
+    "npm": "^6.3.0",
     "nvd3": "^1.8.6"
   }
 }
diff --git a/airflow/www_rbac/static/js/clock.js b/airflow/www_rbac/static/js/clock.js
index 9842e3bfebfdc..afde7c2545f37 100644
--- a/airflow/www_rbac/static/js/clock.js
+++ b/airflow/www_rbac/static/js/clock.js
@@ -16,26 +16,21 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-require('./jqClock.min');
+
+import {defaultFormatWithTZ, moment} from './datetime-utils';
+
+function displayTime() {
+  let utcTime = moment().utc().format(defaultFormatWithTZ);
+  $('#clock')
+    .attr("data-original-title", function() {
+      return hostName
+    })
+    .html(utcTime);
+
+  setTimeout(displayTime, 1000);
+}
 
 $(document).ready(function () {
-  x = new Date();
-  const UTCseconds = (x.getTime() + x.getTimezoneOffset() * 60 * 1000);
-  $("#clock").clock({
-    "dateFormat": "Y-m-d ",
-    "timeFormat": "H:i:s %UTC%",
-    "timestamp": UTCseconds
-  }).click(function () {
-    alert(hostName); // Declared in baselayout.html
-  });
+  displayTime();
   $('span').tooltip();
-
-  $.ajaxSetup({
-    beforeSend: function (xhr, settings) {
-      if (!/^(GET|HEAD|OPTIONS|TRACE)$/i.test(settings.type) && !this.crossDomain) {
-        // csrfToken declared in baselayout.html
-        xhr.setRequestHeader("X-CSRFToken", csrfToken);
-      }
-    }
-  });
 });
diff --git a/airflow/www_rbac/static/js/datetime-utils.js b/airflow/www_rbac/static/js/datetime-utils.js
new file mode 100644
index 0000000000000..08e94694794c0
--- /dev/null
+++ b/airflow/www_rbac/static/js/datetime-utils.js
@@ -0,0 +1,60 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+export const moment = require('moment-timezone');
+export const defaultFormat = 'YYYY-MM-DD, HH:mm:ss';
+export const defaultFormatWithTZ = 'YYYY-MM-DD, HH:mm:ss z';
+
+
+const makeDateTimeHTML = (start, end) => {
+  return (
+    `Started: ${start.format(defaultFormat)} <br> Ended: ${end.format(defaultFormat)} <br>`
+  )
+};
+
+export const generateTooltipDateTime = (startDate, endDate, dagTZ) => {
+  const tzFormat = 'z (Z)';
+  const localTZ = moment.tz.guess();
+  startDate = moment.utc(startDate);
+  endDate = moment.utc(endDate);
+  dagTZ = dagTZ.toUpperCase();
+
+  // Generate UTC Start and End Date
+  let tooltipHTML = '<br><strong>UTC</strong><br>';
+  tooltipHTML += makeDateTimeHTML(startDate, endDate);
+
+  // Generate User's Local Start and End Date
+  tooltipHTML += `<br><strong>Local: ${moment.tz(localTZ).format(tzFormat)}</strong><br>`;
+  tooltipHTML += makeDateTimeHTML(startDate.local(), endDate.local());
+
+  // Generate DAG's Start and End Date
+  if (dagTZ !== 'UTC' && dagTZ !== localTZ) {
+    tooltipHTML += `<br><strong>DAG's TZ: ${moment.tz(dagTZ).format(tzFormat)}</strong><br>`;
+    tooltipHTML += makeDateTimeHTML(startDate.tz(dagTZ), endDate.tz(dagTZ));
+  }
+
+  return tooltipHTML
+};
+
+
+export const converAndFormatUTC = (datetime, tz) => {
+  let dateTimeObj = moment.utc(datetime);
+  if (tz) dateTimeObj = dateTimeObj.tz(tz);
+  return dateTimeObj.format(defaultFormatWithTZ)
+}
diff --git a/airflow/www_rbac/static/js/graph.js b/airflow/www_rbac/static/js/graph.js
new file mode 100644
index 0000000000000..3ccc72cc6f78a
--- /dev/null
+++ b/airflow/www_rbac/static/js/graph.js
@@ -0,0 +1,74 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import { generateTooltipDateTime, converAndFormatUTC } from './datetime-utils';
+
+// Assigning css classes based on state to nodes
+// Initiating the tooltips
+function update_nodes_states(task_instances) {
+  $.each(task_instances, function (task_id, ti) {
+    $('tspan').filter(function (index) {
+      return $(this).text() === task_id;
+    })
+      .parent().parent().parent().parent()
+      .attr("class", "node enter " + ti.state)
+      .attr("data-toggle", "tooltip")
+      .attr("data-original-title", function (d) {
+        // Tooltip
+        const task = tasks[task_id];
+        let tt = "Task_id: " + ti.task_id + "<br>";
+        tt += "Run: " + converAndFormatUTC(ti.execution_date) + "<br>";
+        if (ti.run_id != undefined) {
+          tt += "run_id: <nobr>" + ti.run_id + "</nobr><br>";
+        }
+        tt += "Operator: " + task.task_type + "<br>";
+        tt += "Duration: " + ti.duration + "<br>";
+        tt += "State: " + ti.state + "<br>";
+        tt += generateTooltipDateTime(ti.start_date, ti.end_date, dagTZ); // dagTZ has been defined in dag.html
+        return tt;
+      });
+  });
+}
+
+function initRefreshButton() {
+  d3.select("#refresh_button").on("click",
+    function () {
+      $("#loading").css("display", "block");
+      $("div#svg_container").css("opacity", "0.2");
+      $.get(getTaskInstanceURL)
+        .done(
+          function (task_instances) {
+            update_nodes_states(JSON.parse(task_instances));
+            $("#loading").hide();
+            $("div#svg_container").css("opacity", "1");
+            $('#error').hide();
+          }
+        ).fail(function (jqxhr, textStatus, err) {
+        $('#error_msg').html(textStatus + ': ' + err);
+        $('#error').show();
+        $('#loading').hide();
+        $('#chart_section').hide(1000);
+        $('#datatable_section').hide(1000);
+      });
+    }
+  );
+}
+
+initRefreshButton();
+update_nodes_states(task_instances);
diff --git a/airflow/www_rbac/static/js/jqClock.min.js b/airflow/www_rbac/static/js/jqClock.min.js
deleted file mode 100644
index 5528efd186774..0000000000000
--- a/airflow/www_rbac/static/js/jqClock.min.js
+++ /dev/null
@@ -1,27 +0,0 @@
-/**
- * jQuery Clock plugin
- * Copyright (c) 2010 John R D'Orazio (priest@johnromanodorazio.com)
- * Licensed under the Apache 2.0 license:
- * https://www.apache.org/licenses/LICENSE-2.0
- */
-Date.prototype.hasOwnProperty("stdTimezoneOffset")||(Date.prototype.stdTimezoneOffset=function(){var b=this.getFullYear();if(!Date.prototype.stdTimezoneOffset.cache.hasOwnProperty(b)){for(var d=(new Date(b,0,1)).getTimezoneOffset(),h=[6,7,5,8,4,9,3,10,2,11,1],a=0;12>a;a++){var m=(new Date(b,h[a],1)).getTimezoneOffset();if(m!=d){d=Math.max(d,m);break}}Date.prototype.stdTimezoneOffset.cache[b]=d}return Date.prototype.stdTimezoneOffset.cache[b]},Date.prototype.stdTimezoneOffset.cache={});
-Date.prototype.hasOwnProperty("isDST")||(Date.prototype.isDST=function(){return this.getTimezoneOffset()<this.stdTimezoneOffset()});Date.prototype.hasOwnProperty("isLeapYear")||(Date.prototype.isLeapYear=function(){var b=this.getFullYear();return 0!=(b&3)?!1:0!=b%100||0==b%400});Date.prototype.hasOwnProperty("getDOY")||(Date.prototype.getDOY=function(){var b=this.getMonth(),d=this.getDate(),d=[0,31,59,90,120,151,181,212,243,273,304,334][b]+d;1<b&&this.isLeapYear()&&d++;return d});
-Date.prototype.hasOwnProperty("daysInMonth")||(Date.prototype.daysInMonth=function(){return[31,this.isLeapYear()?29:28,31,30,31,30,31,31,30,31,30,31][this.getMonth()]});Date.prototype.hasOwnProperty("getWOY")||(Date.prototype.getWOY=function(b){var d=new Date(+this);d.setHours(0,0,0,0);d.setDate(d.getDate()+4-(d.getDay()||7));return b?d.getFullYear():Math.ceil(((d-new Date(d.getFullYear(),0,1))/864E5+1)/7)});
-Date.prototype.hasOwnProperty("swatchTime")||(Date.prototype.swatchTime=function(){return("00"+Math.floor((60*((this.getUTCHours()+1)%24*60+this.getUTCMinutes())+this.getUTCSeconds()+.001*this.getUTCMilliseconds())/86.4)).slice(-3)});String.prototype.padStart||(String.prototype.padStart=function(b,d){b>>=0;d=String(d||" ");if(this.length>b)return String(this);b-=this.length;b>d.length&&(d+=d.repeat(b/d.length));return d.slice(0,b)+String(this)});
-(function(b,d){b.clock={version:"2.3.0",options:[{type:"string",value:"destroy",description:"Passing in 'destroy' to an already initialized clock will remove the setTimeout for that clock to stop it from ticking, and remove all html markup and data associated with the plugin instance on the dom elements"},{type:"string",value:"stop",description:"Passing in 'stop' to an already initialized clock will clear the setTimeout for that clock to stop it from ticking"},{type:"string",value:"start",description:"Passing in 'start' to an already initialized clock will restart the setTimeout for that clock to get it ticking again, as though it had never lost time"},
-{type:"object",description:"option set {}",values:[{name:"timestamp",description:"Either a javascript timestamp as produces by [JAVASCRIPT new Date().getTime()] or a php timestamp as produced by [PHP time()] ",type:"unix timestamp",values:["javascript timestamp","php timestamp"]},{name:"langSet",description:"two letter locale to be used for the translation of Day names and Month names",type:"String",values:"am ar bn bg ca zh hr cs da nl en et fi fr de el gu hi hu id it ja kn ko lv lt ms ml mr mo ps fa pl pt ro ru sr sk sl es sw sv ta te th tr uk vi".split(" ")},
-{name:"calendar",description:"Whether the date should be displayed together with the time",type:"Boolean",values:[!0,!1]},{name:"dateFormat",description:"PHP Style Format string for formatting a local date, see http://php.net/manual/en/function.date.php",type:"String",values:"dDjlNSwzWFmMntLoYy".split("")},{name:"timeFormat",description:"PHP Style Format string for formatting a local date, see http://php.net/manual/en/function.date.php",type:"String",values:"aABgGhHisveIOPZcrU".split("")},{name:"isDST",
-description:"When a client side timestamp is used, whether DST is active will be automatically determined. However this cannot be determined for a server-side timestamp which must be passed in as UTC, in that can case it can be set with this option",type:"Boolean",values:[!0,!1]},{name:"rate",description:"Defines the rate at which the clock will update, in milliseconds",type:"Integer",values:"1 - 9007199254740991 (recommended 10-60000)"}]}],methods:{destroy:"Chaining clock().destroy() has the same effect as passing the 'destroy' option as in clock('destroy')",
-stop:"Chaining clock().stop() has the same effect as passing the 'stop' option as in clock('stop')",start:"Chaining clock().start() has the same effect as passing the 'start' option as in clock('start')"}};Object.freeze(b.clock);var h=h||{};b.fn.clock=function(a){var m=this;this.initialize=function(){return this};this.destroy=function(){return m.each(function(a){a=b(this).attr("id");h.hasOwnProperty(a)&&(clearTimeout(h[a]),delete h[a]);b(this).html("");b(this).hasClass("jqclock")&&b(this).removeClass("jqclock");
-b(this).removeData("clockoptions")})};this.stop=function(){return m.each(function(a){a=b(this).attr("id");h.hasOwnProperty(a)&&(clearTimeout(h[a]),delete h[a])})};this.start=function(){return m.each(function(a){a=b(this).attr("id");var c=b(this).data("clockoptions");if(c!==d&&!1===h.hasOwnProperty(a)){var g=this;h[a]=setTimeout(function(){x(b(g))},c.rate)}})};var B=function(){return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,function(a){var b=16*Math.random()|0;return("x"==a?b:b&3|8).toString(16)}).toUpperCase()},
-x=function(a){var c=b(a).data("clockoptions"),d=(new Date).getTime()+c.sysdiff,k=new Date(d),g=k.getHours(),m=k.getMinutes(),C=k.getSeconds(),B=k.getMilliseconds(),e=k.getDay(),l=k.getDate(),D=k.getMonth(),y=k.getFullYear(),p=k.isLeapYear(),w=k.getDOY(),q=k.getWOY(),v=k.getWOY(!0),G=k.daysInMonth(),H=k.swatchTime(),n=parseInt(c.tzOffset/60),z=parseInt(60*c.tzOffset),E="AM",f="",r="";11<g&&(E="PM");r=g;12<r?r-=12:0===r&&(r=12);if(!0===c.calendar){for(var f="",t=0;t<=c.dateFormat.length;t++){var F=
-c.dateFormat.charAt(t);switch(F){case "d":f+=(""+l).padStart(2,"0");break;case "D":f+=(new Intl.DateTimeFormat(c.langSet,{weekday:"short"})).format(k);break;case "j":f+=l;break;case "l":f+=(new Intl.DateTimeFormat(c.langSet,{weekday:"long"})).format(k);break;case "N":f+=0===e?7:e;break;case "S":f+=1===l||1===l%10&&11!=l?"st":2===l||2===l%10&&12!=l?"nd":3===l||3===l%10&&13!=l?"rd":"th";break;case "w":f+=e;break;case "z":f+=w-1;break;case "W":f+=q;break;case "F":f+=(new Intl.DateTimeFormat(c.langSet,
-{month:"long"})).format(k);break;case "m":f+=(D+1+"").padStart(2,"0");break;case "M":f+=(new Intl.DateTimeFormat(c.langSet,{month:"short"})).format(k);break;case "n":f+=D+1;break;case "t":f+=G;break;case "L":f+=p?1:0;break;case "o":f+=v;break;case "Y":f+=y;break;case "y":f+=y.toString().substr(2,2);break;case String.fromCharCode(92):f+=c.dateFormat.charAt(++t);break;case "%":for(var u=t+1,A=c.dateFormat;u<A.length&&"%"!=A.charAt(u);)u++;u>t+1&&u!=A.length?(f+=A.substring(t+1,u),t+=u-t):f+=F;break;
-default:f+=F}}f='<span class="clockdate">'+f+"</span>"}e="";for(p=0;p<=c.timeFormat.length;p++)switch(w=c.timeFormat.charAt(p),w){case "a":e+=E.toLowerCase();break;case "A":e+=E;break;case "B":e+=H;break;case "g":e+=r;break;case "G":e+=g;break;case "h":e+=(""+r).padStart(2,"0");break;case "H":e+=(""+g).padStart(2,"0");break;case "i":e+=(""+m).padStart(2,"0");break;case "s":e+=(""+C).padStart(2,"0");break;case "v":e+=(""+B).padStart(3,"0");break;case "e":e+=c.timezone;break;case "I":e+=c.isDST?"DST":
-"";break;case "O":e+=(0>n?"+"+(""+Math.abs(n)).padStart(2,"0"):0<n?(""+-1*n).padStart(2,"0"):"+00")+"00";break;case "P":e+=(0>n?"+"+(""+Math.abs(n)).padStart(2,"0"):0<n?(""+-1*n).padStart(2,"0"):"+00")+":00";break;case "Z":e+=0>z?""+Math.abs(z):0<z?""+-1*z:"0";break;case "c":e+=y+"-"+(D+1+"").padStart(2,"0")+"-"+(""+l).padStart(2,"0")+"T"+(""+g).padStart(2,"0")+":"+(""+m).padStart(2,"0")+":"+(""+C).padStart(2,"0")+(0>n?"+"+(""+Math.abs(n)).padStart(2,"0"):0<tzh?(""+-1*tzh).padStart(2,"0"):"+00")+
-":00";break;case "r":e+=(new Intl.DateTimeFormat(c.langSet,{weekday:"short"})).format(k)+", "+l+" "+(new Intl.DateTimeFormat(c.langSet,{month:"short"})).format(k)+" "+y+" "+(""+g).padStart(2,"0")+":"+(""+m).padStart(2,"0")+":"+(""+C).padStart(2,"0")+" "+(0>n?"+"+(""+Math.abs(n)).padStart(2,"0"):0<tzh?(""+-1*tzh).padStart(2,"0"):"+00")+"00";break;case "U":e+=Math.floor(d/1E3);break;case String.fromCharCode(92):e+=c.timeFormat.charAt(++p);break;case "%":q=p+1;for(v=c.timeFormat;q<v.length&&"%"!=v.charAt(q);)q++;
-q>p+1&&q!=v.length?(e+=v.substring(p+1,q),p+=q-p):e+=w;break;default:e+=w}r='<span class="clocktime">'+e+"</span>";b(a).html(f+r);d=b(a).attr("id");h[d]=setTimeout(function(){x(b(a))},c.rate)};this.each(function(g){if("undefined"===typeof a||"object"===typeof a){g=new Date;a=a||{};a.timestamp=a.timestamp||"localsystime";a.langSet=a.langSet||"en";a.calendar=a.hasOwnProperty("calendar")?a.calendar:!0;a.dateFormat=a.dateFormat||("en"==a.langSet?"l, F j, Y":"l, j F Y");a.timeFormat=a.timeFormat||("en"==
-a.langSet?"h:i:s A":"H:i:s");a.timezone=a.timezone||"localsystimezone";a.isDST=a.hasOwnProperty("isDST")?a.isDST:g.isDST();a.rate=a.rate||500;"string"!==typeof a.langSet&&(a.langSet=""+a.langSet);"string"===typeof a.calendar?a.calendar="false"==a.calendar?!1:!0:"boolean"!==typeof a.calendar&&(a.calendar=!!a.calendar);"string"!==typeof a.dateFormat&&(a.dateFormat=""+a.dateFormat);"string"!==typeof a.timeFormat&&(a.timeFormat=""+a.dateFormat);"string"!==typeof a.timezone&&(a.timezone=""+a.timezone);
-"string"===typeof a.isDST?a.isDST="true"==a.isDST?!0:!1:"boolean"!==typeof a.isDST&&(a.isDST=!!a.isDST);"number"!==typeof a.rate&&(a.rate=parseInt(a.rate));a.tzOffset=g.getTimezoneOffset();var c=a.tzOffset/60;a.sysdiff=0;"localsystime"!=a.timestamp?2<(g.getTime()+"").length-(a.timestamp+"").length?(a.timestamp*=1E3,a.sysdiff=a.timestamp-g.getTime()+6E4*a.tzOffset):(a.sysdiff=a.timestamp-g.getTime(),"localsystimezone"==a.timezone&&(a.timezone="UTC",0>c?a.timezone+="+"+Math.abs(c):0<c&&(a.timezone+=
--1*c))):"localsystimezone"==a.timezone&&(a.timezone="UTC",0>c?a.timezone+="+"+Math.abs(c):0<c&&(a.timezone+=-1*c));b(this).hasClass("jqclock")||b(this).addClass("jqclock");b(this).is("[id]")||b(this).attr("id",B());b(this).data("clockoptions",a);!1===h.hasOwnProperty(b(this).attr("id"))&&x(b(this))}else if("string"===typeof a)switch(g=b(this).attr("id"),a){case "destroy":h.hasOwnProperty(g)&&(clearTimeout(h[g]),delete h[g]);b(this).html("");b(this).hasClass("jqclock")&&b(this).removeClass("jqclock");
-b(this).removeData("clockoptions");break;case "stop":h.hasOwnProperty(g)&&(clearTimeout(h[g]),delete h[g]);break;case "start":var m=this,c=b(this).data("clockoptions");c!==d&&!1===h.hasOwnProperty(g)&&(h[g]=setTimeout(function(){x(b(m))},c.rate))}});return this.initialize()};return this})(jQuery);
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 04c20ce9ab479..0e62c6c9ad376 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -296,6 +296,7 @@ <h4 class="modal-title" id="dagModalLabel">
 
     var id = '';
     var dag_id = '{{ dag.dag_id }}';
+    var dagTZ = '{{ dag.timezone.name }}'; // Being used in datetime-utils.js
     var task_id = '';
     var exection_date = '';
     var subdag_id = '';
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index acc48997725c2..3b8d4914ccbdb 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -106,11 +106,15 @@
 
     var nodes = {{ nodes|safe }};
     var edges = {{ edges|safe }};
-    var tasks = {{ tasks|safe }};
-    var task_instances = {{ task_instances|safe }};
     var execution_date = "{{ execution_date }}";
     var arrange = "{{ arrange }}";
 
+    // Below variables are being used in dag.js
+    var tasks = {{ tasks|safe }};
+    var task_instances = {{ task_instances|safe }};
+    var getTaskInstanceURL = '{{ url_for("Airflow.task_instances", dag_id='+
+      dag.dag_id + ', execution_date=' + execution_date + ') }}';
+
     var duration = 500;
     var stateFocusMap = {
         'no status':false, 'failed':false, 'running':false,
@@ -154,7 +158,6 @@
 
     setUpZoomSupport();
     inject_node_ids(tasks);
-    update_nodes_states(task_instances);
 
     d3.selectAll("g.node").on("click", function(d){
         task = tasks[d];
@@ -299,32 +302,6 @@
         });
     }
 
-
-    // Assigning css classes based on state to nodes
-    function update_nodes_states(task_instances) {
-        $.each(task_instances, function(task_id, ti) {
-          $('tspan').filter(function(index) { return $(this).text() === task_id; })
-            .parent().parent().parent().parent()
-            .attr("class", "node enter " + ti.state)
-            .attr("data-toggle", "tooltip")
-            .attr("data-original-title", function(d) {
-              // Tooltip
-              task = tasks[task_id];
-              tt =  "Task_id: " + ti.task_id + "<br>";
-              tt += "Run: " + ti.execution_date + "<br>";
-              if(ti.run_id != undefined){
-                tt += "run_id: <nobr>" + ti.run_id + "</nobr><br>";
-              }
-              tt += "Operator: " + task.task_type + "<br>";
-              tt += "Started: " + ti.start_date + "<br>";
-              tt += "Ended: " + ti.end_date + "<br>";
-              tt += "Duration: " + ti.duration + "<br>";
-              tt += "State: " + ti.state + "<br>";
-              return tt;
-            });
-        });
-    }
-
     function clearFocus(){
         d3.selectAll("g.node")
             .transition(duration)
@@ -374,35 +351,8 @@
         }
         return false
     }
-
-    function initRefreshButton() {
-      d3.select("#refresh_button").on("click",
-          function() {
-              $("#loading").css("display", "block");
-              $("div#svg_container").css("opacity", "0.2");
-              $.get(
-                  "{{ url_for('Airflow.task_instances') }}",
-                  {dag_id : "{{ dag.dag_id }}", execution_date : "{{ execution_date }}"})
-              .done(
-                  function(task_instances) {
-                      update_nodes_states(JSON.parse(task_instances));
-                      $("#loading").hide();
-                      $("div#svg_container").css("opacity", "1");
-                      $('#error').hide();
-                  }
-              ).fail(function(jqxhr, textStatus, err) {
-                  $('#error_msg').html(textStatus + ': ' + err);
-                  $('#error').show();
-                  $('#loading').hide();
-                  $('#chart_section').hide(1000);
-                  $('#datatable_section').hide(1000);
-              });
-          }
-      );
-    }
-
-    initRefreshButton();
     </script>
+    <script src="{{ url_for_asset('graph.js') }}"></script>
 
 
 {% endblock %}
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index f04d1d9949cf2..46df449a500c9 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -36,10 +36,11 @@ const config = {
   entry: {
     connectionForm: `${STATIC_DIR}/js/connection_form.js`,
     clock: `${STATIC_DIR}/js/clock.js`,
+    graph: `${STATIC_DIR}/js/graph.js`,
     ganttChartD3v2: `${STATIC_DIR}/js/gantt-chart-d3v2.js`,
     styleBundle: [
-      `${STATIC_DIR}/css/main.css`,
       `${STATIC_DIR}/css/bootstrap-theme.css`,
+      `${STATIC_DIR}/css/main.css`,
     ],
   },
   output: {
@@ -102,6 +103,11 @@ const config = {
     new ManifestPlugin(),
     new CleanWebpackPlugin(['static/dist']),
     new MiniCssExtractPlugin({ filename: '[name].[chunkhash].css' }),
+
+    // MomentJS loads all the locale, making it a huge JS file.
+    // This will ignore the locales from momentJS
+    new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/),
+
     new webpack.DefinePlugin({
       'process.env': {
         NODE_ENV: JSON.stringify(process.env.NODE_ENV),
diff --git a/licenses/LICENSE-moment.txt b/licenses/LICENSE-moment.txt
new file mode 100644
index 0000000000000..8618b7333d6f5
--- /dev/null
+++ b/licenses/LICENSE-moment.txt
@@ -0,0 +1,22 @@
+Copyright (c) JS Foundation and other contributors
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

From aa76c53b6dc388fbe4d73dae10d1217a3a337178 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 30 Aug 2018 13:30:40 +0100
Subject: [PATCH 451/808] [AIRFLOW-2779] Make GHE auth third party licensed
 (#3803)

---
 NOTICE                                        |  5 ++++
 .../auth/backends/github_enterprise_auth.py   | 24 +++++++++----------
 2 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/NOTICE b/NOTICE
index 31b9455e93661..962cd8a71a425 100644
--- a/NOTICE
+++ b/NOTICE
@@ -13,6 +13,11 @@ is subject to the terms and conditions of their respective licenses.
 See the LICENSE file for a list of subcomponents and dependencies and
 their respective licenses.
 
+airflow.contrib.auth.backends.github_enterprise_auth:
+-----------------------------------------------------
+
+* Copyright 2015 Matthew Pelland (matt@pelland.io)
+
 hue:
 -----
 This product contains a modified portion of 'Hue' developed by Cloudera, Inc.
diff --git a/airflow/contrib/auth/backends/github_enterprise_auth.py b/airflow/contrib/auth/backends/github_enterprise_auth.py
index 99c01ed2794ce..e1b8b133425fe 100644
--- a/airflow/contrib/auth/backends/github_enterprise_auth.py
+++ b/airflow/contrib/auth/backends/github_enterprise_auth.py
@@ -1,21 +1,19 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
+# See the NOTICE file distributed with this work for additional information
+# regarding copyright ownership.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
 #   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 import flask_login
 
 # Need to expose these downstream

From d35439a82b11848d25596c44563ae2ac2a1fd134 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Fri, 11 Jan 2019 19:17:20 +0100
Subject: [PATCH 452/808] Update github_enterprise_auth.py

---
 .../auth/backends/github_enterprise_auth.py   | 24 ++++++++++---------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/auth/backends/github_enterprise_auth.py b/airflow/contrib/auth/backends/github_enterprise_auth.py
index e1b8b133425fe..99c01ed2794ce 100644
--- a/airflow/contrib/auth/backends/github_enterprise_auth.py
+++ b/airflow/contrib/auth/backends/github_enterprise_auth.py
@@ -1,19 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# See the NOTICE file distributed with this work for additional information
-# regarding copyright ownership.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
 #   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 import flask_login
 
 # Need to expose these downstream

From fa50cf764c6c25c603480b82277f7981fb524a83 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Wed, 16 Jan 2019 21:59:57 +0000
Subject: [PATCH 453/808] [AIRFLOW-XXX] Changelog and version for 1.10.2

---
 CHANGELOG.txt      | 10 +++++++++-
 airflow/version.py |  2 +-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index b0c704e79bdb8..7f963a53d2fe9 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,4 @@
-Airflow 1.10.2b2, 2019-01-12
+Airflow 1.10.2, 2019-01-16
 ----------------------------
 
 New features
@@ -127,6 +127,13 @@ Improvements
 - [AIRFLOW-3689] Update pop-up message when deleting DAG in RBAC UI (#4505)
 - [AIRFLOW-2801] Skip test_mark_success_no_kill in PostgreSQL on CI (#3642)
 - [AIRFLOW-3693] Replace psycopg2-binary by psycopg2 (#4508)
+- [AIRFLOW-3700] Change the lowest allowed version of "requests" (#4517)
+- [AIRFLOW-3704] Support SSL Protection When Redis is Used as Broker for CeleryExecutor (#4521)
+- [AIRFLOW-3681] All GCP operators have now optional GCP Project ID (#4500)
+- [Airflow 2782] Upgrades Dagre D3 version to latest possible
+- [Airflow 2783] Implement eslint for JS code check (#3641)
+- [AIRFLOW-2805] Display multiple timezones on UI (#3687)
+
 
 Bug fixes
 """""""""
@@ -196,6 +203,7 @@ Bug fixes
 - [AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
 - [AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
 - [AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
+- [AIRFLOW-3319] - KubernetsExecutor: Need in try_number in labels if getting them later (#4163)
 
 Doc-only changes
 """"""""""""""""
diff --git a/airflow/version.py b/airflow/version.py
index 30e1b4a3ef844..e7deef18768cf 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.2b2'
+version = '1.10.2'

From 559d78de052227828a12ace6b01eb64ff66ffb72 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Thu, 17 Jan 2019 14:39:59 +0000
Subject: [PATCH 454/808] [AIRFLOW-3724] Fix the broken refresh button on Graph
 View in RBAC UI

---
 airflow/www_rbac/templates/airflow/graph.html | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 3b8d4914ccbdb..edca149babe97 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -112,8 +112,9 @@
     // Below variables are being used in dag.js
     var tasks = {{ tasks|safe }};
     var task_instances = {{ task_instances|safe }};
-    var getTaskInstanceURL = '{{ url_for("Airflow.task_instances", dag_id='+
-      dag.dag_id + ', execution_date=' + execution_date + ') }}';
+    var getTaskInstanceURL = "{{ url_for('Airflow.task_instances') }}" +
+      "?dag_id=" + encodeURIComponent(dag_id) + "&execution_date=" +
+      encodeURIComponent(execution_date);
 
     var duration = 500;
     var stateFocusMap = {

From 3b43a87abb6dfe16d7df3735506dfe9f11815975 Mon Sep 17 00:00:00 2001
From: Daniel Lamblin <dlamblin+github@gmail.com>
Date: Fri, 18 Jan 2019 00:21:37 +0900
Subject: [PATCH 455/808] [AIRFLOW-XXX] Correct Typo in sensor's exception
 (#4545)

---
 airflow/sensors/external_task_sensor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index eda1a2d9d2d28..bf36ee786f413 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -63,7 +63,7 @@ def __init__(self,
         self.allowed_states = allowed_states or [State.SUCCESS]
         if execution_delta is not None and execution_date_fn is not None:
             raise ValueError(
-                'Only one of `execution_date` or `execution_date_fn` may'
+                'Only one of `execution_delta` or `execution_date_fn` may '
                 'be provided to ExternalTaskSensor; not both.')
 
         self.execution_delta = execution_delta

From 4b8e73913ad3ffd0ffbd5c44de21361a52b18073 Mon Sep 17 00:00:00 2001
From: Vivek <3vivekb@gmail.com>
Date: Wed, 16 Jan 2019 21:57:42 -0800
Subject: [PATCH 456/808] [AIRFLOW-XXX] Fix a typo of config (#4544)

---
 docs/howto/set-config.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/howto/set-config.rst b/docs/howto/set-config.rst
index cedce11324124..6d54444547248 100644
--- a/docs/howto/set-config.rst
+++ b/docs/howto/set-config.rst
@@ -58,7 +58,7 @@ The following config options support this ``_cmd`` version:
 
 The idea behind this is to not store passwords on boxes in plain text files.
 
-The order of precedence for all connfig options is as follows -
+The order of precedence for all config options is as follows -
 
 1. environment variable
 2. configuration in airflow.cfg

From d72778386f63db33e5587df6268c266d45b7a980 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Thu, 17 Jan 2019 21:31:07 +0000
Subject: [PATCH 457/808] [AIRFLOW-XXX] Update Changelog

---
 CHANGELOG.txt | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 7f963a53d2fe9..8c9a3c083b808 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,5 +1,5 @@
-Airflow 1.10.2, 2019-01-16
-----------------------------
+Airflow 1.10.2, 2019-01-17
+--------------------------
 
 New features
 """"""""""""
@@ -203,7 +203,8 @@ Bug fixes
 - [AIRFLOW-2951] Update dag_run table end_date when state change (#3798)
 - [AIRFLOW-2756] Fix bug in set DAG run state workflow (#3606)
 - [AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
-- [AIRFLOW-3319] - KubernetsExecutor: Need in try_number in labels if getting them later (#4163)
+- [AIRFLOW-3319] KubernetsExecutor: Need in try_number in labels if getting them later (#4163)
+- [AIRFLOW-3724] Fix the broken refresh button on Graph View in RBAC UI
 
 Doc-only changes
 """"""""""""""""
@@ -233,6 +234,8 @@ Doc-only changes
 - [AIRFLOW-3086] Add extras group for google auth to setup.py (#3917)
 - [AIRFLOW-XXX] Add Kubernetes Dependency in Extra Packages Doc (#4281)
 - [AIRFLOW-3696] Add Version info to Airflow Documentation (#4512)
+- [AIRFLOW-XXX] Correct Typo in sensor's exception (#4545)
+- [AIRFLOW-XXX] Fix a typo of config (#4544)
 
 Airflow 1.10.1, 2018-11-13
 --------------------------

From 6b33cd39f316ea332138cb63f7e26fd649273ec4 Mon Sep 17 00:00:00 2001
From: Zakaria EL Mesaoudi <elmesaoudee@gmail.com>
Date: Wed, 7 Nov 2018 21:58:15 +0000
Subject: [PATCH 458/808] AIRFLOW-3259] Fix internal server error when
 displaying charts (#4114)

This is caused by the fact that the function 'sort' is no longer a part of Dataframe in pandas and is still used in the code base. It has ever since been replaced by 'sort_values'. Replacing the function gets the chart display back to its normal behaviour.
---
 airflow/www/views.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index dbd12df43baea..0af6a0f725f23 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -495,7 +495,7 @@ def chart_data(self):
                 else:
                     # User provides columns (x, y, metric1, metric2, ...)
                     df.index = df[df.columns[0]]
-                    df = df.sort(df.columns[0])
+                    df = df.sort_values(by=df.columns[0])
                     del df[df.columns[0]]
                     for col in df.columns:
                         df[col] = df[col].astype(np.float)

From 043926cab16dab13a51d22d7769ca3f450d9efb0 Mon Sep 17 00:00:00 2001
From: Sumit Maheshwari <sumeet.manit@gmail.com>
Date: Wed, 7 Nov 2018 15:42:17 +0530
Subject: [PATCH 459/808] [AIRFLOW-3302] Small CSS fixes (#4140)

* Don't highlight logout button when viewing Log tab of a task
* Align Airflow logo to the center of the login page
---
 airflow/www/templates/admin/master.html  |  2 +-
 airflow/www/templates/airflow/login.html | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/airflow/www/templates/admin/master.html b/airflow/www/templates/admin/master.html
index 2939a099d4aa2..1d47bcc71905e 100644
--- a/airflow/www/templates/admin/master.html
+++ b/airflow/www/templates/admin/master.html
@@ -89,7 +89,7 @@
         <ul class="nav navbar-nav navbar-right">
             <li><a id="clock"></a></li>
             {% if current_user.is_authenticated %}
-              <li><a href="{{ url_for('airflow.logout') }}"><span data-toggle="tooltip" data-placement="left" title="Logout" class="glyphicon glyphicon-log-out"></span></a></li>
+              <li class="never_active"><a href="{{ url_for('airflow.logout') }}"><span data-toggle="tooltip" data-placement="left" title="Logout" class="glyphicon glyphicon-log-out"></span></a></li>
             {% endif %}
         </ul>
           <ul class="nav navbar-nav navbar-right">
diff --git a/airflow/www/templates/airflow/login.html b/airflow/www/templates/airflow/login.html
index cdae3178f01db..72cdff202cc11 100644
--- a/airflow/www/templates/airflow/login.html
+++ b/airflow/www/templates/airflow/login.html
@@ -1,13 +1,13 @@
-{# 
+{#
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at
-  
+
     http://www.apache.org/licenses/LICENSE-2.0
-  
+
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@@ -25,7 +25,7 @@
     <div class="row">
         <div class="col-sm-6 col-md-4 col-md-offset-4">
             <h1 class="text-center login-title">Sign in to Airflow</h1>
-            <div class="account-wall">
+            <div class="text-center account-wall">
                 <img src="{{ url_for("static", filename="pin_100.png") }}" />
                 <form class="form-signin" method="post" action="{{ url_for('airflow.login') }}">
                     <input type="text" class="form-control" placeholder="Username" name="username" required autofocus>
@@ -43,4 +43,4 @@ <h1 class="text-center login-title">Sign in to Airflow</h1>
     </div>
 </div>
 
-{% endblock %}
\ No newline at end of file
+{% endblock %}

From 9d68b3a2e847589ed11911e5f7312d232bd43485 Mon Sep 17 00:00:00 2001
From: smithakoduri <41048347+smithakoduri@users.noreply.github.com>
Date: Wed, 14 Nov 2018 17:45:24 -0800
Subject: [PATCH 460/808] [AIRFLOW-3271] Fix issue with persistence of RBAC
 Permissions modified via UI (#4118)

---
 airflow/www_rbac/security.py    | 18 +++++++++++-------
 tests/www_rbac/test_security.py | 15 +++++++++++++++
 tests/www_rbac/test_views.py    |  3 +++
 3 files changed, 29 insertions(+), 7 deletions(-)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index f7a339f032816..6bc627a561eed 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -182,13 +182,17 @@ def init_role(self, role_name, role_vms, role_perms):
         if not role:
             role = self.add_role(role_name)
 
-        role_pvms = []
-        for pvm in pvms:
-            if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
-                role_pvms.append(pvm)
-        role.permissions = list(set(role_pvms))
-        self.get_session.merge(role)
-        self.get_session.commit()
+        if len(role.permissions) == 0:
+            logging.info('Initializing permissions for role:%s in the database.', role_name)
+            role_pvms = []
+            for pvm in pvms:
+                if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
+                    role_pvms.append(pvm)
+            role.permissions = list(set(role_pvms))
+            self.get_session.merge(role)
+            self.get_session.commit()
+        else:
+            logging.info('Existing permissions for the role:%s within the database will persist.', role_name)
 
     def get_user_roles(self, user=None):
         """
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index 6e0b5726394da..9b32a86c9cdf4 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -107,6 +107,21 @@ def test_init_role_modelview(self):
         self.assertIsNotNone(role)
         self.assertEqual(len(role_perms), len(role.permissions))
 
+    def test_update_and_verify_permission_role(self):
+        role_name = 'Test_Role'
+        self.security_manager.init_role(role_name, [], [])
+        role = self.security_manager.find_role(role_name)
+
+        perm = self.security_manager.\
+            find_permission_view_menu('can_edit', 'RoleModelView')
+        self.security_manager.add_permission_role(role, perm)
+        role_perms_len = len(role.permissions)
+
+        self.security_manager.init_role(role_name, [], [])
+        new_role_perms_len = len(role.permissions)
+
+        self.assertEqual(role_perms_len, new_role_perms_len)
+
     def test_get_user_roles(self):
         user = mock.MagicMock()
         user.is_anonymous = False
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 843ee16807941..131d9535f07e4 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -1070,6 +1070,9 @@ def add_permission_for_role(self):
         all_dag_role = self.appbuilder.sm.find_role('all_dag_role')
         self.appbuilder.sm.add_permission_role(all_dag_role, perm_on_all_dag)
 
+        role_user = self.appbuilder.sm.find_role('User')
+        self.appbuilder.sm.add_permission_role(role_user, perm_on_all_dag)
+
         read_only_perm_on_dag = self.appbuilder.sm.\
             find_permission_view_menu('can_dag_read', 'example_bash_operator')
         dag_read_only_role = self.appbuilder.sm.find_role('dag_acl_read_only')

From c3946fe56812f995b93644d2f1eb623c715021ec Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 19 Nov 2018 18:26:18 +0000
Subject: [PATCH 461/808] [AIRFLOW-XXX] Don't publish md5 sigs as part of
 release (#4210)

Apache recommend against publishing MD5 files now as they are relatively
easy to collide and shouldn't be trusted anymore
---
 dev/sign.sh | 1 -
 1 file changed, 1 deletion(-)

diff --git a/dev/sign.sh b/dev/sign.sh
index 66427a7e87ce8..33054a175e46c 100755
--- a/dev/sign.sh
+++ b/dev/sign.sh
@@ -26,4 +26,3 @@ NAME=${1}
 
 gpg --armor --output ${NAME}.asc --detach-sig ${NAME}
 gpg --print-md SHA512 ${NAME} > ${NAME}.sha512
-gpg --print-md MD5 ${NAME} > ${NAME}.md5

From ea000961f1a8944944ece6e4fb7fc1d389b6f4ed Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 15 Oct 2018 09:12:33 -0400
Subject: [PATCH 462/808] [AIRFLOW-3141] Handle duration for missing dag.
 (#3984)

---
 airflow/www/views.py         | 4 ++++
 airflow/www_rbac/views.py    | 4 ++++
 tests/core.py                | 4 ++++
 tests/www_rbac/test_views.py | 5 +++++
 4 files changed, 17 insertions(+)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 0af6a0f725f23..df3f1493611a8 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1613,6 +1613,10 @@ def duration(self, session=None):
         num_runs = request.args.get('num_runs')
         num_runs = int(num_runs) if num_runs else default_dag_run
 
+        if dag is None:
+            flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
+            return redirect('/admin/')
+
         if base_date:
             base_date = pendulum.parse(base_date)
         else:
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index e648f5378bcde..775cf38ffd28b 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1392,6 +1392,10 @@ def duration(self, session=None):
         num_runs = request.args.get('num_runs')
         num_runs = int(num_runs) if num_runs else default_dag_run
 
+        if dag is None:
+            flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
+            return redirect('/')
+
         if base_date:
             base_date = pendulum.parse(base_date)
         else:
diff --git a/tests/core.py b/tests/core.py
index 146ccbb97499e..e773030d58ad9 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1984,6 +1984,10 @@ def test_dag_views(self):
         response = self.app.get(
             '/admin/airflow/duration?days=30&dag_id=example_bash_operator')
         self.assertIn("example_bash_operator", response.data.decode('utf-8'))
+        response = self.app.get(
+            '/admin/airflow/duration?days=30&dag_id=missing_dag',
+            follow_redirects=True)
+        self.assertIn("seems to be missing", response.data.decode('utf-8'))
         response = self.app.get(
             '/admin/airflow/tries?days=30&dag_id=example_bash_operator')
         self.assertIn("example_bash_operator", response.data.decode('utf-8'))
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 131d9535f07e4..4c9b8340572d2 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -454,6 +454,11 @@ def test_duration(self):
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('example_bash_operator', resp)
 
+    def test_duration_missing(self):
+        url = 'duration?days=30&dag_id=missing_dag'
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('seems to be missing', resp)
+
     def test_tries(self):
         url = 'tries?days=30&dag_id=example_bash_operator'
         resp = self.client.get(url, follow_redirects=True)

From 878c9b71187e71a87fd5c889e6371461e2abf6c7 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 25 Sep 2018 02:20:17 +0800
Subject: [PATCH 463/808] [AIRFLOW-3067] Display www_rbac Flask flash msg
 properly (#3903)

The Flask flash messages are not displayed properly.

When we don't give a category for a flash message, defautl
value will be 'message'. In some cases, we specify 'error'
category.

Using Flask-AppBuilder, the flash message will be given
a CSS class 'alert-[category]'. But We don't have
'alert-message' or 'alert-error' in the current
'bootstrap-theme.css' file.

This makes the the flash messages in www_rbac UI come with
no background color.

This commit addresses this issue by adding 'alert-message'
(using specs of existing CSS class 'alert-info') and
'alert-error' (using specs of existing CSS class 'alert-danger')
into 'bootstrap-theme.css'.
---
 airflow/www_rbac/views.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 775cf38ffd28b..ea520c5578a23 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -2231,10 +2231,9 @@ def action_set_running(self, drs, session=None):
                 dr.state = State.RUNNING
             models.DagStat.update(dirty_ids, session=session)
             session.commit()
-            flash(
-                "{count} dag runs were set to running".format(**locals()))
+            flash("{count} dag runs were set to running".format(**locals()))
         except Exception as ex:
-            flash(str(ex))
+            flash(str(ex), 'error')
             flash('Failed to set state', 'error')
         return redirect(self.route_base + '/list')
 

From 4d4069e8a86491dceef1794cf01559eafe726f29 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Thu, 20 Sep 2018 20:49:20 +0200
Subject: [PATCH 464/808] [AIRFLOW-3072] Assign permission
 get_logs_with_metadata to viewer role (#3913)

---
 tests/www_rbac/test_views.py | 55 ++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 4c9b8340572d2..e295c8dbd3b83 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -1003,6 +1003,17 @@ def login(self, username=None, password=None):
                 role=role_admin,
                 password='test')
 
+        role_user = self.appbuilder.sm.find_role('User')
+        test_user = self.appbuilder.sm.find_user(username='test_user')
+        if not test_user:
+            self.appbuilder.sm.add_user(
+                username='test_user',
+                first_name='test_user',
+                last_name='test_user',
+                email='test_user@fab.org',
+                role=role_user,
+                password='test_user')
+
         dag_acl_role = self.appbuilder.sm.add_role('dag_acl_tester')
         dag_tester = self.appbuilder.sm.find_user(username='dag_tester')
         if not dag_tester:
@@ -1446,6 +1457,50 @@ def test_tree_success_for_read_only_role(self):
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('runme_1', resp)
 
+    def test_log_success(self):
+        self.logout()
+        self.login()
+        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Log by attempts', resp)
+        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
+               'execution_date={}&try_number=1&metadata=null'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('"message":', resp)
+        self.check_content_in_response('"metadata":', resp)
+
+    def test_log_failure(self):
+        self.logout()
+        self.login(username='dag_faker',
+                   password='dag_faker')
+        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('Log by attempts', resp)
+        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
+               'execution_date={}&try_number=1&metadata=null'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_not_in_response('"message":', resp)
+        self.check_content_not_in_response('"metadata":', resp)
+
+    def test_log_success_for_user(self):
+        self.logout()
+        self.login(username='test_user',
+                   password='test_user')
+        url = ('log?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('Log by attempts', resp)
+        url = ('get_logs_with_metadata?task_id=runme_0&dag_id=example_bash_operator&'
+               'execution_date={}&try_number=1&metadata=null'
+               .format(self.percent_encode(self.default_date)))
+        resp = self.client.get(url, follow_redirects=True)
+        self.check_content_in_response('"message":', resp)
+        self.check_content_in_response('"metadata":', resp)
+
 
 if __name__ == '__main__':
     unittest.main()

From 4ff82029fb2e4d1bfd7d3150b24f5cba26d84954 Mon Sep 17 00:00:00 2001
From: Gabriel Silk <gabe@nomic.com>
Date: Mon, 3 Sep 2018 11:37:20 -0700
Subject: [PATCH 465/808] [AIRFLOW-2866] Fix missing CSRF token head when using
 RBAC UI (#3804)

---
 airflow/www_rbac/static/js/{clock.js => base.js}      | 7 +++++++
 airflow/www_rbac/templates/appbuilder/baselayout.html | 4 ++--
 airflow/www_rbac/webpack.config.js                    | 2 +-
 3 files changed, 10 insertions(+), 3 deletions(-)
 rename airflow/www_rbac/static/js/{clock.js => base.js} (84%)

diff --git a/airflow/www_rbac/static/js/clock.js b/airflow/www_rbac/static/js/base.js
similarity index 84%
rename from airflow/www_rbac/static/js/clock.js
rename to airflow/www_rbac/static/js/base.js
index afde7c2545f37..ea065792a533a 100644
--- a/airflow/www_rbac/static/js/clock.js
+++ b/airflow/www_rbac/static/js/base.js
@@ -33,4 +33,11 @@ function displayTime() {
 $(document).ready(function () {
   displayTime();
   $('span').tooltip();
+  $.ajaxSetup({
+    beforeSend: function(xhr, settings) {
+      if (!/^(GET|HEAD|OPTIONS|TRACE)$/i.test(settings.type) && !this.crossDomain) {
+        xhr.setRequestHeader("X-CSRFToken", csrfToken);
+      }
+    }
+  });
 });
diff --git a/airflow/www_rbac/templates/appbuilder/baselayout.html b/airflow/www_rbac/templates/appbuilder/baselayout.html
index 6b0c4416a92a0..3e36c123c5fca 100644
--- a/airflow/www_rbac/templates/appbuilder/baselayout.html
+++ b/airflow/www_rbac/templates/appbuilder/baselayout.html
@@ -61,9 +61,9 @@
 {% block tail_js %}
 {{ super() }}
 <script type="text/javascript">
-  // below variables are used in clock.js
+  // below variables are used in base.js
   var hostName = '{{ hostname }}';
   var csrfToken = '{{ csrf_token() }}';
 </script>
-<script src="{{ url_for_asset('clock.js') }}" type="text/javascript"></script>
+<script src="{{ url_for_asset('base.js') }}" type="text/javascript"></script>
 {% endblock %}
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index 46df449a500c9..3bfb2f43452b2 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -35,7 +35,7 @@ const BUILD_DIR = path.resolve(__dirname, './static/dist');
 const config = {
   entry: {
     connectionForm: `${STATIC_DIR}/js/connection_form.js`,
-    clock: `${STATIC_DIR}/js/clock.js`,
+    base: `${STATIC_DIR}/js/base.js`,
     graph: `${STATIC_DIR}/js/graph.js`,
     ganttChartD3v2: `${STATIC_DIR}/js/gantt-chart-d3v2.js`,
     styleBundle: [

From 48d0b23f1888afd547f4815473e857509861ea9f Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Wed, 8 Aug 2018 13:47:59 +0200
Subject: [PATCH 466/808] [AIRFLOW-2874] Enables FAB's theme support (#3719)

---
 airflow/config_templates/default_webserver_config.py  | 10 ++++++++++
 airflow/www_rbac/templates/appbuilder/baselayout.html | 10 ++++++++--
 airflow/www_rbac/webpack.config.js                    |  6 ++----
 3 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/airflow/config_templates/default_webserver_config.py b/airflow/config_templates/default_webserver_config.py
index ba33d81dec23b..e61c7e1a45cb2 100644
--- a/airflow/config_templates/default_webserver_config.py
+++ b/airflow/config_templates/default_webserver_config.py
@@ -89,3 +89,13 @@
 #    { 'name': 'AOL', 'url': 'http://openid.aol.com/<username>' },
 #    { 'name': 'Flickr', 'url': 'http://www.flickr.com/<username>' },
 #    { 'name': 'MyOpenID', 'url': 'https://www.myopenid.com' }]
+
+# ----------------------------------------------------
+# Theme CONFIG
+# ----------------------------------------------------
+# Flask App Builder comes up with a number of predefined themes
+# that you can use for Apache Airflow.
+# http://flask-appbuilder.readthedocs.io/en/latest/customizing.html#changing-themes
+# Please make sure to remove "navbar_color" configuration from airflow.cfg
+# in order to fully utilize the theme. (or use that property in conjunction with theme)
+# APP_THEME = "bootstrap-theme.css"  # default bootstrap
diff --git a/airflow/www_rbac/templates/appbuilder/baselayout.html b/airflow/www_rbac/templates/appbuilder/baselayout.html
index 3e36c123c5fca..89e32cae783ec 100644
--- a/airflow/www_rbac/templates/appbuilder/baselayout.html
+++ b/airflow/www_rbac/templates/appbuilder/baselayout.html
@@ -20,8 +20,14 @@
 
 {% block head_css %}
   {{ super() }}
-  {# styleBundle.css file contains the styles from main.css and bootstrap-theme.css #}
-  <link href="{{ url_for_asset('styleBundle.css') }}" rel="stylesheet">
+
+  <link href="{{ url_for_asset('main.css') }}" rel="stylesheet">
+
+  {% if not appbuilder.app_theme %}
+    {# airflowDefaultTheme.css file contains the styles from local bootstrap-theme.css #}
+    <link href="{{ url_for_asset('airflowDefaultTheme.css') }}" rel="stylesheet">
+  {% endif %}
+
   <link rel="icon" type="image/png" href="{{ url_for('static', filename='pin_30.png') }}">
 {% endblock %}
 
diff --git a/airflow/www_rbac/webpack.config.js b/airflow/www_rbac/webpack.config.js
index 3bfb2f43452b2..16f394cc616b9 100644
--- a/airflow/www_rbac/webpack.config.js
+++ b/airflow/www_rbac/webpack.config.js
@@ -38,10 +38,8 @@ const config = {
     base: `${STATIC_DIR}/js/base.js`,
     graph: `${STATIC_DIR}/js/graph.js`,
     ganttChartD3v2: `${STATIC_DIR}/js/gantt-chart-d3v2.js`,
-    styleBundle: [
-      `${STATIC_DIR}/css/bootstrap-theme.css`,
-      `${STATIC_DIR}/css/main.css`,
-    ],
+    main: `${STATIC_DIR}/css/main.css`,
+    airflowDefaultTheme : `${STATIC_DIR}/css/bootstrap-theme.css`,
   },
   output: {
     path: BUILD_DIR,

From 34e83f498dda32b67e922322bb406969bef9d1d5 Mon Sep 17 00:00:00 2001
From: Verdan Mahmood <verdan.mahmood@gmail.com>
Date: Thu, 26 Jul 2018 20:55:04 +0200
Subject: [PATCH 467/808] [AIRFLOW-2766][Airflow-2766] Respect shared datetime
 across tabs

Closes #3615 from verdan/AIRFLOW-2766-shared-
datetime
---
 airflow/www_rbac/templates/airflow/dag.html | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 0e62c6c9ad376..78c3f251694ce 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -45,6 +45,8 @@ <h4 class="pull-right">
   </div>
   <div class="clearfix"></div>
   <div>
+    {% set base_date_arg = request.args.get('base_date') %}
+    {% set num_runs_arg = request.args.get('num_runs') %}
     <ul class="nav nav-pills">
       {% if dag.parent_dag %}
           <li class="never_active"><a href="{{ url_for('Airflow.' + dag.default_view, dag_id=dag.parent_dag.dag_id) }}">
@@ -52,29 +54,29 @@ <h4 class="pull-right">
               Back to {{ dag.parent_dag.dag_id }}</a>
           </li>
       {% endif %}
-      <li><a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, root=root) }}">
+      <li><a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, root=root, num_runs=num_runs_arg, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-certificate" aria-hidden="true"></span>
         Graph View</a></li>
-      <li><a href="{{ url_for('Airflow.tree', dag_id=dag.dag_id, num_runs=num_runs, root=root) }}">
+      <li><a href="{{ url_for('Airflow.tree', dag_id=dag.dag_id, num_runs=num_runs_arg, root=root, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-tree-deciduous" aria-hidden="true"></span>
         Tree View
       </a></li>
-      <li><a href="{{ url_for('Airflow.duration', dag_id=dag.dag_id, days=30, root=root) }}">
+      <li><a href="{{ url_for('Airflow.duration', dag_id=dag.dag_id, days=30, root=root, num_runs=num_runs_arg, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-stats" aria-hidden="true"></span>
           Task Duration
       </a></li>
-      <li><a href="{{ url_for('Airflow.tries', dag_id=dag.dag_id, days=30, root=root) }}">
+      <li><a href="{{ url_for('Airflow.tries', dag_id=dag.dag_id, days=30, root=root, num_runs=num_runs_arg, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-duplicate" aria-hidden="true"></span>
           Task Tries
       </a></li>
       <li>
-        <a href="{{ url_for('Airflow.landing_times', dag_id=dag.dag_id, days=30, root=root) }}">
+        <a href="{{ url_for('Airflow.landing_times', dag_id=dag.dag_id, days=30, root=root, num_runs=num_runs_arg, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-plane" aria-hidden="true"></span>
           Landing Times
         </a>
       </li>
       <li>
-        <a href="{{ url_for('Airflow.gantt', dag_id=dag.dag_id, root=root) }}">
+        <a href="{{ url_for('Airflow.gantt', dag_id=dag.dag_id, root=root, num_runs=num_runs_arg, base_date=base_date_arg) }}">
           <span class="glyphicon glyphicon-align-left" aria-hidden="true"></span>
           <i class="icon-align-left"></i>
           Gantt

From 7019a8d684909469b9dda8c793c5c8b6ebfbc4cc Mon Sep 17 00:00:00 2001
From: Abdul Nimeri <abdul@stripe.com>
Date: Thu, 26 Jul 2018 20:53:57 +0200
Subject: [PATCH 468/808] [AIRFLOW-2776] Compress tree view JSON

The tree view generates JSON that can be massive
for bigger DAGs,
up to 10s of MBs. The JSON is currently
prettified, which both
takes up more CPU time during serialization, and
slows down
everything else that uses it. Considering the JSON
is only
meant to be used programmatically, this is an easy
win

Closes #3620 from abdul-stripe/smaller-tree-view-
json
---
 airflow/www/views.py      | 3 ++-
 airflow/www_rbac/views.py | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index df3f1493611a8..40deb7aa5c236 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1489,7 +1489,8 @@ def set_duration(tid):
             'instances': [dag_runs.get(d) or {'execution_date': d.isoformat()} for d in dates],
         }
 
-        data = json.dumps(data, indent=4, default=json_ser)
+        # minimize whitespace as this can be huge for bigger dags
+        data = json.dumps(data, default=json_ser, separators=(',', ':'))
         session.commit()
 
         form = DateTimeWithNumRunsForm(data={'base_date': max_date,
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index ea520c5578a23..8c736f70982af 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1263,7 +1263,8 @@ def set_duration(tid):
                 for d in dates],
         }
 
-        data = json.dumps(data, indent=4, default=json_ser)
+        # minimize whitespace as this can be huge for bigger dags
+        data = json.dumps(data, default=json_ser, separators=(',', ':'))
         session.commit()
 
         form = DateTimeWithNumRunsForm(data={'base_date': max_date,

From f8262dd6ceb1e4d8cf9abd4423b0e93e1ce21e94 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Thu, 25 Oct 2018 06:33:21 -0400
Subject: [PATCH 469/808] [AIRFLOW-1508] Add SKIPPED to task states. (#4059)

---
 airflow/www_rbac/views.py | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 8c736f70982af..859a698ad703f 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -336,17 +336,13 @@ def dag_stats(self, session=None):
                 if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
                     payload[dag.safe_dag_id] = []
                     for state in State.dag_states:
-                        try:
-                            count = data[dag.dag_id][state]
-                        except Exception:
-                            count = 0
-                        d = {
+                        count = data.get(dag.dag_id, {}).get(state, 0)
+                        payload[dag.safe_dag_id].append({
                             'state': state,
                             'count': count,
                             'dag_id': dag.dag_id,
                             'color': State.color(state)
-                        }
-                        payload[dag.safe_dag_id].append(d)
+                        })
         return wwwutils.json_response(payload)
 
     @expose('/task_stats')
@@ -414,17 +410,13 @@ def task_stats(self, session=None):
             if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
                 payload[dag.safe_dag_id] = []
                 for state in State.task_states:
-                    try:
-                        count = data[dag.dag_id][state]
-                    except Exception:
-                        count = 0
-                    d = {
+                    count = data.get(dag.dag_id, {}).get(state, 0)
+                    payload[dag.safe_dag_id].append({
                         'state': state,
                         'count': count,
                         'dag_id': dag.dag_id,
                         'color': State.color(state)
-                    }
-                    payload[dag.safe_dag_id].append(d)
+                    })
         return wwwutils.json_response(payload)
 
     @expose('/code')

From 5e3825d811d6b78fc6f4fe81f424c57552f38f48 Mon Sep 17 00:00:00 2001
From: cclauss <cclauss@bluewin.ch>
Date: Thu, 20 Sep 2018 21:48:36 +0200
Subject: [PATCH 470/808] [AIRFLOW-2407] Use feature detection for reload()
 (#3298)

* [AIRFLOW-2407] Use feature detection for reload()

[Use feature detection instead of version detection](https://docs.python.org/3/howto/pyporting.html#use-feature-detection-instead-of-version-detection) is a Python porting best practice that avoids a flake8 undefined name error...

flake8 testing of https://github.com/apache/incubator-airflow on Python 3.6.3
---
 airflow/www/app.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/airflow/www/app.py b/airflow/www/app.py
index 428ff241fddd1..ad769b20bd839 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -147,11 +147,7 @@ def integrate_plugins():
         # required for testing purposes otherwise the module retains
         # a link to the default_auth
         if app.config['TESTING']:
-            if six.PY2:
-                reload(e)
-            else:
-                import importlib
-                importlib.reload(e)
+            six.moves.reload_module(e)
 
         app.register_blueprint(e.api_experimental, url_prefix='/api/experimental')
 

From 838873f62f4444a164f46468c001ddd8c818ae83 Mon Sep 17 00:00:00 2001
From: Marcus <marcuseagan@gmail.com>
Date: Thu, 13 Dec 2018 23:19:22 -0800
Subject: [PATCH 471/808] [AIRFLOW-3452] removed an unused/dangerous
 display-none (#4295)

* removed an unused display-none that is currently overriden but could resurface as a bug.

* remove the other display none in /www
---
 airflow/www/templates/airflow/dags.html      | 2 +-
 airflow/www_rbac/templates/airflow/dags.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index d01d51e36e187..1e98f380a3a6e 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -28,7 +28,7 @@
 {% block body %}
   <h2>DAGs</h2>
 
-  <div id="main_content" style="display:none;">
+  <div id="main_content">
     <div class="row">
       <div class="col-sm-2">
       </div>
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index e55f8278c59ee..04098ebce35be 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -28,7 +28,7 @@
 {% block content %}
   <h2>DAGs</h2>
 
-  <div id="main_content" style="display:none;">
+  <div id="main_content">
     <div class="row">
       <div class="col-sm-2">
       </div>

From ab268011d7ded6c8ac9bcb5527886aecf6dc0b7c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcin=20Szyma=C5=84ski?= <ms32035@gmail.com>
Date: Thu, 22 Nov 2018 22:34:46 +0000
Subject: [PATCH 472/808]  [AIRFLOW-3348] update run statistics on dag refresh
 (#4197)

* [AIRFLOW-3348] update run statistics on dag refresh
---
 airflow/www/views.py      | 2 ++
 airflow/www_rbac/views.py | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 40deb7aa5c236..7e146281c26a9 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1890,6 +1890,8 @@ def refresh(self, session=None):
             session.merge(orm_dag)
         session.commit()
 
+        models.DagStat.update([dag_id], session=session, dirty_only=False)
+
         dagbag.get_dag(dag_id)
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 859a698ad703f..e89575f1cbdd0 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1669,6 +1669,8 @@ def refresh(self, session=None):
         # sync dag permission
         appbuilder.sm.sync_perm_for_dag(dag_id)
 
+        models.DagStat.update([dag_id], session=session, dirty_only=False)
+
         dagbag.get_dag(dag_id)
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)

From 27608547e4bfc9012d6e3415597b9da9de4c4dcb Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 14 Oct 2018 20:11:44 +0100
Subject: [PATCH 473/808] [AIRFLOW-XXX] Fix BashOperator Docstring (#4052)

---
 airflow/operators/bash_operator.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index 17de0145a3e13..d458122b8176c 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -47,7 +47,8 @@ class BashOperator(BaseOperator):
         of inheriting the current process environment, which is the default
         behavior. (templated)
     :type env: dict
-    :type output_encoding: output encoding of bash command
+    :param output_encoding: Output encoding of bash command 
+    :type output_encoding: str
     """
     template_fields = ('bash_command', 'env')
     template_ext = ('.sh', '.bash',)

From 98ee454f5d84b8c96f6318e87fad31f527a0716c Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 5 Sep 2018 23:24:56 +0100
Subject: [PATCH 474/808] [AIRFLOW-3018] Fix Minor issues in Documentation

---
 airflow/contrib/hooks/azure_data_lake_hook.py |   2 +-
 airflow/contrib/hooks/azure_fileshare_hook.py |   8 +-
 airflow/contrib/hooks/gcp_container_hook.py   |   1 +
 airflow/contrib/hooks/gcs_hook.py             |   1 +
 airflow/contrib/hooks/wasb_hook.py            |   4 +-
 .../contrib/operators/awsbatch_operator.py    |   6 +-
 .../operators/bigquery_check_operator.py      |   2 +-
 .../contrib/operators/bigquery_get_data.py    |   2 +-
 .../contrib/operators/bigquery_operator.py    |   4 +-
 airflow/contrib/operators/bigquery_to_gcs.py  |   6 +-
 .../contrib/operators/databricks_operator.py  |   2 +-
 .../contrib/operators/dataflow_operator.py    | 129 +++++-----
 .../contrib/operators/dataproc_operator.py    |   3 +-
 .../operators/emr_add_steps_operator.py       |   2 +-
 .../operators/emr_create_job_flow_operator.py |   2 +-
 .../emr_terminate_job_flow_operator.py        |   2 +-
 .../operators/gcp_container_operator.py       | 221 +++++++++---------
 airflow/contrib/operators/gcs_to_bq.py        |   4 +-
 airflow/contrib/operators/gcs_to_gcs.py       |   9 +-
 .../contrib/operators/mlengine_operator.py    |   5 +-
 .../contrib/operators/s3_to_gcs_operator.py   |   2 +
 airflow/operators/oracle_operator.py          |   1 +
 22 files changed, 207 insertions(+), 211 deletions(-)

diff --git a/airflow/contrib/hooks/azure_data_lake_hook.py b/airflow/contrib/hooks/azure_data_lake_hook.py
index 1a02d78f27b72..74ae1948099e8 100644
--- a/airflow/contrib/hooks/azure_data_lake_hook.py
+++ b/airflow/contrib/hooks/azure_data_lake_hook.py
@@ -59,7 +59,7 @@ def check_for_file(self, file_path):
         :param file_path: Path and name of the file.
         :type file_path: str
         :return: True if the file exists, False otherwise.
-        :rtype bool
+        :rtype: bool
         """
         try:
             files = self.connection.glob(file_path, details=False, invalidate_cache=True)
diff --git a/airflow/contrib/hooks/azure_fileshare_hook.py b/airflow/contrib/hooks/azure_fileshare_hook.py
index d4066ee549f3f..8afa1540d78b4 100644
--- a/airflow/contrib/hooks/azure_fileshare_hook.py
+++ b/airflow/contrib/hooks/azure_fileshare_hook.py
@@ -56,7 +56,7 @@ def check_for_directory(self, share_name, directory_name, **kwargs):
             `FileService.exists()` takes.
         :type kwargs: object
         :return: True if the file exists, False otherwise.
-        :rtype bool
+        :rtype: bool
         """
         return self.connection.exists(share_name, directory_name,
                                       **kwargs)
@@ -75,7 +75,7 @@ def check_for_file(self, share_name, directory_name, file_name, **kwargs):
             `FileService.exists()` takes.
         :type kwargs: object
         :return: True if the file exists, False otherwise.
-        :rtype bool
+        :rtype: bool
         """
         return self.connection.exists(share_name, directory_name,
                                       file_name, **kwargs)
@@ -92,7 +92,7 @@ def list_directories_and_files(self, share_name, directory_name=None, **kwargs):
             `FileService.list_directories_and_files()` takes.
         :type kwargs: object
         :return: A list of files and directories
-        :rtype list
+        :rtype: list
         """
         return self.connection.list_directories_and_files(share_name,
                                                           directory_name,
@@ -110,7 +110,7 @@ def create_directory(self, share_name, directory_name, **kwargs):
             `FileService.create_directory()` takes.
         :type kwargs: object
         :return: A list of files and directories
-        :rtype list
+        :rtype: list
         """
         return self.connection.create_directory(share_name, directory_name, **kwargs)
 
diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 84173f249847f..4a610e56c9501 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -114,6 +114,7 @@ def _append_label(cluster_proto, key, val):
 
         Labels must fit the regex [a-z]([-a-z0-9]*[a-z0-9])? (current airflow version
         string follows semantic versioning spec: x.y.z).
+
         :param cluster_proto: The proto to append resource_label airflow version to
         :type cluster_proto: google.cloud.container_v1.types.Cluster
         :param key: The key label
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 2e7cf19ba0dcb..c6c1bf11b8981 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -68,6 +68,7 @@ def copy(self, source_bucket, source_object, destination_bucket=None,
         :type destination_bucket: string
         :param destination_object: The (renamed) path of the object if given.
             Can be omitted; then the same name is used.
+        :type destination_object: string
         """
         destination_bucket = destination_bucket or source_bucket
         destination_object = destination_object or source_object
diff --git a/airflow/contrib/hooks/wasb_hook.py b/airflow/contrib/hooks/wasb_hook.py
index 19ee442f91b1d..8e9fb7ed9b766 100644
--- a/airflow/contrib/hooks/wasb_hook.py
+++ b/airflow/contrib/hooks/wasb_hook.py
@@ -59,7 +59,7 @@ def check_for_blob(self, container_name, blob_name, **kwargs):
             `BlockBlobService.exists()` takes.
         :type kwargs: object
         :return: True if the blob exists, False otherwise.
-        :rtype bool
+        :rtype: bool
         """
         return self.connection.exists(container_name, blob_name, **kwargs)
 
@@ -75,7 +75,7 @@ def check_for_prefix(self, container_name, prefix, **kwargs):
             `BlockBlobService.list_blobs()` takes.
         :type kwargs: object
         :return: True if blobs matching the prefix exist, False otherwise.
-        :rtype bool
+        :rtype: bool
         """
         matches = self.connection.list_blobs(container_name, prefix,
                                              num_results=1, **kwargs)
diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index 89dd4940b51e9..d4cfaf9cbfc40 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -43,11 +43,11 @@ class AWSBatchOperator(BaseOperator):
     :param job_queue: the queue name on AWS Batch
     :type job_queue: str
     :param overrides: the same parameter that boto3 will receive on
-        containerOverrides (templated).
+        containerOverrides (templated):
         http://boto3.readthedocs.io/en/latest/reference/services/batch.html#submit_job
     :type overrides: dict
-    :param max_retries: exponential backoff retries while waiter is not merged,
-        4200 = 48 hours
+    :param max_retries: exponential backoff retries while waiter is not
+        merged, 4200 = 48 hours
     :type max_retries: int
     :param aws_conn_id: connection id of AWS credentials / region name. If None,
         credential boto3 strategy will be used
diff --git a/airflow/contrib/operators/bigquery_check_operator.py b/airflow/contrib/operators/bigquery_check_operator.py
index 3eba0771db91b..ff7b97eea8d82 100644
--- a/airflow/contrib/operators/bigquery_check_operator.py
+++ b/airflow/contrib/operators/bigquery_check_operator.py
@@ -113,7 +113,7 @@ class BigQueryIntervalCheckOperator(IntervalCheckOperator):
     This method constructs a query like so ::
 
         SELECT {metrics_threshold_dict_key} FROM {table}
-            WHERE {date_filter_column}=<date>
+        WHERE {date_filter_column}=<date>
 
     :param table: the table name
     :type table: str
diff --git a/airflow/contrib/operators/bigquery_get_data.py b/airflow/contrib/operators/bigquery_get_data.py
index ab8f71b717716..6e0c6c44deb04 100644
--- a/airflow/contrib/operators/bigquery_get_data.py
+++ b/airflow/contrib/operators/bigquery_get_data.py
@@ -51,7 +51,7 @@ class BigQueryGetDataOperator(BaseOperator):
         )
 
     :param dataset_id: The dataset ID of the requested table. (templated)
-    :type destination_dataset_table: string
+    :type dataset_id: string
     :param table_id: The table ID of the requested table. (templated)
     :type table_id: string
     :param max_results: The maximum number of records (rows) to be fetched
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 853e80894c10d..2f0bb07c71d55 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -377,7 +377,7 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :param source_objects: List of Google cloud storage URIs to point
         table to. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
-    :type object: list
+    :type source_objects: list
     :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
         BigQuery table to load data into (templated). If <project> is not included,
         project will be the project defined in the connection json.
@@ -394,7 +394,7 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :type schema_fields: list
     :param schema_object: If set, a GCS object path pointing to a .json file that
         contains the schema for the table. (templated)
-    :param schema_object: string
+    :type schema_object: string
     :param source_format: File format of the data.
     :type source_format: string
     :param compression: [Optional] The compression type of the data source.
diff --git a/airflow/contrib/operators/bigquery_to_gcs.py b/airflow/contrib/operators/bigquery_to_gcs.py
index 278b20804747c..7cefd7e815d49 100644
--- a/airflow/contrib/operators/bigquery_to_gcs.py
+++ b/airflow/contrib/operators/bigquery_to_gcs.py
@@ -31,8 +31,8 @@ class BigQueryToCloudStorageOperator(BaseOperator):
         https://cloud.google.com/bigquery/docs/reference/v2/jobs
 
     :param source_project_dataset_table: The dotted
-        (<project>.|<project>:)<dataset>.<table> BigQuery table to use as the source
-        data. If <project> is not included, project will be the project
+        ``(<project>.|<project>:)<dataset>.<table>`` BigQuery table to use as the
+        source data. If <project> is not included, project will be the project
         defined in the connection json. (templated)
     :type source_project_dataset_table: string
     :param destination_cloud_storage_uris: The destination Google Cloud
@@ -43,7 +43,7 @@ class BigQueryToCloudStorageOperator(BaseOperator):
     :param compression: Type of compression to use.
     :type compression: string
     :param export_format: File format to export.
-    :type field_delimiter: string
+    :type export_format: string
     :param field_delimiter: The delimiter to use when extracting to a CSV.
     :type field_delimiter: string
     :param print_header: Whether to print a header for a CSV file extract.
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 542a3d7857376..50998318d9022 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -93,7 +93,7 @@ def _handle_databricks_operator_execution(operator, hook, log, context):
 
 class DatabricksSubmitRunOperator(BaseOperator):
     """
-    Submits an Spark job run to Databricks using the
+    Submits a Spark job run to Databricks using the
     `api/2.0/jobs/runs/submit
     <https://docs.databricks.com/api/latest/jobs.html#runs-submit>`_
     API endpoint.
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 4a1be8c918027..4e9fe0c4d29c0 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -33,6 +33,39 @@ class DataFlowJavaOperator(BaseOperator):
     Start a Java Cloud DataFlow batch job. The parameters of the operation
     will be passed to the job.
 
+    .. seealso::
+        For more detail on job submission have a look at the reference:
+        https://cloud.google.com/dataflow/pipelines/specifying-exec-params
+
+    :param jar: The reference to a self executing DataFlow jar.
+    :type jar: string
+    :param dataflow_default_options: Map of default job options.
+    :type dataflow_default_options: dict
+    :param options: Map of job specific options.
+    :type options: dict
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud
+        Platform.
+    :type gcp_conn_id: string
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: string
+    :param poll_sleep: The time in seconds to sleep between polling Google
+        Cloud Platform for the dataflow job status while the job is in the
+        JOB_STATE_RUNNING state.
+    :type poll_sleep: int
+    :param job_class: The name of the dataflow job class to be executued, it
+        is often not the main class configured in the dataflow jar file.
+    :type job_class: string
+
+    Both ``jar`` and ``options`` are templated so you can use variables in them.
+
+    Note that both
+    ``dataflow_default_options`` and ``options`` will be merged to specify pipeline
+    execution parameter, and ``dataflow_default_options`` is expected to save
+    high-level options, for instances, project and zone information, which
+    apply to all dataflow operators in the DAG.
+
     It's a good practice to define dataflow_* parameters in the default_args of the dag
     like the project, zone and staging location.
 
@@ -66,7 +99,6 @@ class DataFlowJavaOperator(BaseOperator):
            gcp_conn_id='gcp-airflow-service-account',
            dag=my-dag)
 
-    Both ``jar`` and ``options`` are templated so you can use variables in them.
     """
     template_fields = ['options', 'jar']
     ui_color = '#0273d4'
@@ -83,39 +115,6 @@ def __init__(
             job_class=None,
             *args,
             **kwargs):
-        """
-        Create a new DataFlowJavaOperator. Note that both
-        dataflow_default_options and options will be merged to specify pipeline
-        execution parameter, and dataflow_default_options is expected to save
-        high-level options, for instances, project and zone information, which
-        apply to all dataflow operators in the DAG.
-
-
-        .. seealso::
-            For more detail on job submission have a look at the reference:
-            https://cloud.google.com/dataflow/pipelines/specifying-exec-params
-
-        :param jar: The reference to a self executing DataFlow jar.
-        :type jar: string
-        :param dataflow_default_options: Map of default job options.
-        :type dataflow_default_options: dict
-        :param options: Map of job specific options.
-        :type options: dict
-        :param gcp_conn_id: The connection ID to use connecting to Google Cloud
-        Platform.
-        :type gcp_conn_id: string
-        :param delegate_to: The account to impersonate, if any.
-            For this to work, the service account making the request must have
-            domain-wide delegation enabled.
-        :type delegate_to: string
-        :param poll_sleep: The time in seconds to sleep between polling Google
-            Cloud Platform for the dataflow job status while the job is in the
-            JOB_STATE_RUNNING state.
-        :type poll_sleep: int
-        :param job_class: The name of the dataflow job class to be executued, it
-        is often not the main class configured in the dataflow jar file.
-        :type job_class: string
-        """
         super(DataFlowJavaOperator, self).__init__(*args, **kwargs)
 
         dataflow_default_options = dataflow_default_options or {}
@@ -149,6 +148,25 @@ class DataflowTemplateOperator(BaseOperator):
     """
     Start a Templated Cloud DataFlow batch job. The parameters of the operation
     will be passed to the job.
+
+    :param template: The reference to the DataFlow template.
+    :type template: string
+    :param dataflow_default_options: Map of default job environment options.
+    :type dataflow_default_options: dict
+    :param parameters: Map of job specific parameters for the template.
+    :type parameters: dict
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud
+        Platform.
+    :type gcp_conn_id: string
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: string
+    :param poll_sleep: The time in seconds to sleep between polling Google
+        Cloud Platform for the dataflow job status while the job is in the
+        JOB_STATE_RUNNING state.
+    :type poll_sleep: int
+
     It's a good practice to define dataflow_* parameters in the default_args of the dag
     like the project, zone and staging location.
 
@@ -185,6 +203,16 @@ class DataflowTemplateOperator(BaseOperator):
 
     ``template``, ``dataflow_default_options`` and ``parameters`` are templated so you can
     use variables in them.
+
+    Note that ``dataflow_default_options`` is expected to save high-level options
+    for project information, which apply to all dataflow operators in the DAG.
+
+        .. seealso::
+            https://cloud.google.com/dataflow/docs/reference/rest/v1b3
+            /LaunchTemplateParameters
+            https://cloud.google.com/dataflow/docs/reference/rest/v1b3/RuntimeEnvironment
+            For more detail on job template execution have a look at the reference:
+            https://cloud.google.com/dataflow/docs/templates/executing-templates
     """
     template_fields = ['parameters', 'dataflow_default_options', 'template']
     ui_color = '#0273d4'
@@ -200,36 +228,6 @@ def __init__(
             poll_sleep=10,
             *args,
             **kwargs):
-        """
-        Create a new DataflowTemplateOperator. Note that
-        dataflow_default_options is expected to save high-level options
-        for project information, which apply to all dataflow operators in the DAG.
-
-        .. seealso::
-            https://cloud.google.com/dataflow/docs/reference/rest/v1b3
-            /LaunchTemplateParameters
-            https://cloud.google.com/dataflow/docs/reference/rest/v1b3/RuntimeEnvironment
-            For more detail on job template execution have a look at the reference:
-            https://cloud.google.com/dataflow/docs/templates/executing-templates
-
-        :param template: The reference to the DataFlow template.
-        :type template: string
-        :param dataflow_default_options: Map of default job environment options.
-        :type dataflow_default_options: dict
-        :param parameters: Map of job specific parameters for the template.
-        :type parameters: dict
-        :param gcp_conn_id: The connection ID to use connecting to Google Cloud
-        Platform.
-        :type gcp_conn_id: string
-        :param delegate_to: The account to impersonate, if any.
-            For this to work, the service account making the request must have
-            domain-wide delegation enabled.
-        :type delegate_to: string
-        :param poll_sleep: The time in seconds to sleep between polling Google
-            Cloud Platform for the dataflow job status while the job is in the
-            JOB_STATE_RUNNING state.
-        :type poll_sleep: int
-        """
         super(DataflowTemplateOperator, self).__init__(*args, **kwargs)
 
         dataflow_default_options = dataflow_default_options or {}
@@ -253,7 +251,7 @@ def execute(self, context):
 
 class DataFlowPythonOperator(BaseOperator):
     """
-    Create a new DataFlowPythonOperator. Note that both
+    Launching Cloud Dataflow jobs written in python. Note that both
     dataflow_default_options and options will be merged to specify pipeline
     execution parameter, and dataflow_default_options is expected to save
     high-level options, for instances, project and zone information, which
@@ -284,7 +282,6 @@ class DataFlowPythonOperator(BaseOperator):
         JOB_STATE_RUNNING state.
     :type poll_sleep: int
     """
-
     template_fields = ['options', 'dataflow_default_options']
 
     @apply_defaults
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 441b86fa268b6..829b5f63eedff 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -74,8 +74,7 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type: custom_image: string
     :param properties: dict of properties to set on
         config files (e.g. spark-defaults.conf), see
-        https://cloud.google.com/dataproc/docs/reference/rest/v1/ \
-        projects.regions.clusters#SoftwareConfig
+        https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#SoftwareConfig
     :type properties: dict
     :param master_machine_type: Compute engine machine type to use for the master node
     :type master_machine_type: string
diff --git a/airflow/contrib/operators/emr_add_steps_operator.py b/airflow/contrib/operators/emr_add_steps_operator.py
index 643ffe9c1b94c..44e2e674524f0 100644
--- a/airflow/contrib/operators/emr_add_steps_operator.py
+++ b/airflow/contrib/operators/emr_add_steps_operator.py
@@ -27,7 +27,7 @@ class EmrAddStepsOperator(BaseOperator):
     An operator that adds steps to an existing EMR job_flow.
 
     :param job_flow_id: id of the JobFlow to add steps to. (templated)
-    :type job_flow_name: str
+    :type job_flow_id: str
     :param aws_conn_id: aws connection to uses
     :type aws_conn_id: str
     :param steps: boto3 style steps to be added to the jobflow. (templated)
diff --git a/airflow/contrib/operators/emr_create_job_flow_operator.py b/airflow/contrib/operators/emr_create_job_flow_operator.py
index 5a39713b8a931..cb63f309123d7 100644
--- a/airflow/contrib/operators/emr_create_job_flow_operator.py
+++ b/airflow/contrib/operators/emr_create_job_flow_operator.py
@@ -33,7 +33,7 @@ class EmrCreateJobFlowOperator(BaseOperator):
     :param emr_conn_id: emr connection to use
     :type emr_conn_id: str
     :param job_flow_overrides: boto3 style arguments to override
-           emr_connection extra. (templated)
+       emr_connection extra. (templated)
     :type steps: dict
     """
     template_fields = ['job_flow_overrides']
diff --git a/airflow/contrib/operators/emr_terminate_job_flow_operator.py b/airflow/contrib/operators/emr_terminate_job_flow_operator.py
index 50407a14acad9..0a72f4ac73e81 100644
--- a/airflow/contrib/operators/emr_terminate_job_flow_operator.py
+++ b/airflow/contrib/operators/emr_terminate_job_flow_operator.py
@@ -27,7 +27,7 @@ class EmrTerminateJobFlowOperator(BaseOperator):
     Operator to terminate EMR JobFlows.
 
     :param job_flow_id: id of the JobFlow to terminate. (templated)
-    :type job_flow_name: str
+    :type job_flow_id: str
     :param aws_conn_id: aws connection to uses
     :type aws_conn_id: str
     """
diff --git a/airflow/contrib/operators/gcp_container_operator.py b/airflow/contrib/operators/gcp_container_operator.py
index c99f2a93f2c59..fda4d44b9dca9 100644
--- a/airflow/contrib/operators/gcp_container_operator.py
+++ b/airflow/contrib/operators/gcp_container_operator.py
@@ -29,6 +29,36 @@
 
 
 class GKEClusterDeleteOperator(BaseOperator):
+    """
+    Deletes the cluster, including the Kubernetes endpoint and all worker nodes.
+
+    To delete a certain cluster, you must specify the ``project_id``, the ``name``
+    of the cluster, the ``location`` that the cluster is in, and the ``task_id``.
+
+    **Operator Creation**: ::
+
+        operator = GKEClusterDeleteOperator(
+                    task_id='cluster_delete',
+                    project_id='my-project',
+                    location='cluster-location'
+                    name='cluster-name')
+
+    .. seealso::
+        For more detail about deleting clusters have a look at the reference:
+        https://google-cloud-python.readthedocs.io/en/latest/container/gapic/v1/api.html#google.cloud.container_v1.ClusterManagerClient.delete_cluster
+
+    :param project_id: The Google Developers Console [project ID or project number]
+    :type project_id: str
+    :param name: The name of the resource to delete, in this case cluster name
+    :type name: str
+    :param location: The name of the Google Compute Engine zone in which the cluster
+        resides.
+    :type location: str
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: The api version to use
+    :type api_version: str
+    """
     template_fields = ['project_id', 'gcp_conn_id', 'name', 'location', 'api_version']
 
     @apply_defaults
@@ -40,37 +70,6 @@ def __init__(self,
                  api_version='v2',
                  *args,
                  **kwargs):
-        """
-        Deletes the cluster, including the Kubernetes endpoint and all worker nodes.
-
-
-        To delete a certain cluster, you must specify the ``project_id``, the ``name``
-        of the cluster, the ``location`` that the cluster is in, and the ``task_id``.
-
-        **Operator Creation**: ::
-
-            operator = GKEClusterDeleteOperator(
-                        task_id='cluster_delete',
-                        project_id='my-project',
-                        location='cluster-location'
-                        name='cluster-name')
-
-        .. seealso::
-            For more detail about deleting clusters have a look at the reference:
-            https://google-cloud-python.readthedocs.io/en/latest/container/gapic/v1/api.html#google.cloud.container_v1.ClusterManagerClient.delete_cluster
-
-        :param project_id: The Google Developers Console [project ID or project number]
-        :type project_id: str
-        :param name: The name of the resource to delete, in this case cluster name
-        :type name: str
-        :param location: The name of the Google Compute Engine zone in which the cluster
-            resides.
-        :type location: str
-        :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-        :type gcp_conn_id: str
-        :param api_version: The api version to use
-        :type api_version: str
-        """
         super(GKEClusterDeleteOperator, self).__init__(*args, **kwargs)
 
         self.project_id = project_id
@@ -93,6 +92,48 @@ def execute(self, context):
 
 
 class GKEClusterCreateOperator(BaseOperator):
+    """
+    Create a Google Kubernetes Engine Cluster of specified dimensions
+    The operator will wait until the cluster is created.
+
+    The **minimum** required to define a cluster to create is:
+
+    ``dict()`` ::
+        cluster_def = {'name': 'my-cluster-name',
+                       'initial_node_count': 1}
+
+    or
+
+    ``Cluster`` proto ::
+        from google.cloud.container_v1.types import Cluster
+
+        cluster_def = Cluster(name='my-cluster-name', initial_node_count=1)
+
+    **Operator Creation**: ::
+
+        operator = GKEClusterCreateOperator(
+                    task_id='cluster_create',
+                    project_id='my-project',
+                    location='my-location'
+                    body=cluster_def)
+
+    .. seealso::
+        For more detail on about creating clusters have a look at the reference:
+        https://google-cloud-python.readthedocs.io/en/latest/container/gapic/v1/types.html#google.cloud.container_v1.types.Cluster
+
+    :param project_id: The Google Developers Console [project ID or project number]
+    :type project_id: str
+    :param location: The name of the Google Compute Engine zone in which the cluster
+        resides.
+    :type location: str
+    :param body: The Cluster definition to create, can be protobuf or python dict, if
+        dict it must match protobuf message Cluster
+    :type body: dict or google.cloud.container_v1.types.Cluster
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: The api version to use
+    :type api_version: str
+    """
     template_fields = ['project_id', 'gcp_conn_id', 'location', 'api_version', 'body']
 
     @apply_defaults
@@ -104,48 +145,6 @@ def __init__(self,
                  api_version='v2',
                  *args,
                  **kwargs):
-        """
-        Create a Google Kubernetes Engine Cluster of specified dimensions
-        The operator will wait until the cluster is created.
-
-        The **minimum** required to define a cluster to create is:
-
-        ``dict()`` ::
-            cluster_def = {'name': 'my-cluster-name',
-                           'initial_node_count': 1}
-
-        or
-
-        ``Cluster`` proto ::
-            from google.cloud.container_v1.types import Cluster
-
-            cluster_def = Cluster(name='my-cluster-name', initial_node_count=1)
-
-        **Operator Creation**: ::
-
-            operator = GKEClusterCreateOperator(
-                        task_id='cluster_create',
-                        project_id='my-project',
-                        location='my-location'
-                        body=cluster_def)
-
-        .. seealso::
-            For more detail on about creating clusters have a look at the reference:
-            https://google-cloud-python.readthedocs.io/en/latest/container/gapic/v1/types.html#google.cloud.container_v1.types.Cluster
-
-        :param project_id: The Google Developers Console [project ID or project number]
-        :type project_id: str
-        :param location: The name of the Google Compute Engine zone in which the cluster
-            resides.
-        :type location: str
-        :param body: The Cluster definition to create, can be protobuf or python dict, if
-            dict it must match protobuf message Cluster
-        :type body: dict or google.cloud.container_v1.types.Cluster
-        :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-        :type gcp_conn_id: str
-        :param api_version: The api version to use
-        :type api_version: str
-        """
         super(GKEClusterCreateOperator, self).__init__(*args, **kwargs)
 
         if body is None:
@@ -184,6 +183,44 @@ def execute(self, context):
 
 
 class GKEPodOperator(KubernetesPodOperator):
+    """
+    Executes a task in a Kubernetes pod in the specified Google Kubernetes
+    Engine cluster
+
+    This Operator assumes that the system has gcloud installed and either
+    has working default application credentials or has configured a
+    connection id with a service account.
+
+    The **minimum** required to define a cluster to create are the variables
+    ``task_id``, ``project_id``, ``location``, ``cluster_name``, ``name``,
+    ``namespace``, and ``image``
+
+    **Operator Creation**: ::
+
+        operator = GKEPodOperator(task_id='pod_op',
+                                  project_id='my-project',
+                                  location='us-central1-a',
+                                  cluster_name='my-cluster-name',
+                                  name='task-name',
+                                  namespace='default',
+                                  image='perl')
+
+    .. seealso::
+        For more detail about application authentication have a look at the reference:
+        https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application
+
+    :param project_id: The Google Developers Console project id
+    :type project_id: str
+    :param location: The name of the Google Kubernetes Engine zone in which the
+        cluster resides, e.g. 'us-central1-a'
+    :type location: str
+    :param cluster_name: The name of the Google Kubernetes Engine cluster the pod
+        should be spawned in
+    :type cluster_name: str
+    :param gcp_conn_id: The google cloud connection id to use. This allows for
+        users to specify a service account.
+    :type gcp_conn_id: str
+    """
     template_fields = ('project_id', 'location',
                        'cluster_name') + KubernetesPodOperator.template_fields
 
@@ -195,44 +232,6 @@ def __init__(self,
                  gcp_conn_id='google_cloud_default',
                  *args,
                  **kwargs):
-        """
-        Executes a task in a Kubernetes pod in the specified Google Kubernetes
-        Engine cluster
-
-        This Operator assumes that the system has gcloud installed and either
-        has working default application credentials or has configured a
-        connection id with a service account.
-
-        The **minimum** required to define a cluster to create are the variables
-        ``task_id``, ``project_id``, ``location``, ``cluster_name``, ``name``,
-        ``namespace``, and ``image``
-
-        **Operator Creation**: ::
-
-            operator = GKEPodOperator(task_id='pod_op',
-                                      project_id='my-project',
-                                      location='us-central1-a',
-                                      cluster_name='my-cluster-name',
-                                      name='task-name',
-                                      namespace='default',
-                                      image='perl')
-
-        .. seealso::
-            For more detail about application authentication have a look at the reference:
-            https://cloud.google.com/docs/authentication/production#providing_credentials_to_your_application
-
-        :param project_id: The Google Developers Console project id
-        :type project_id: str
-        :param location: The name of the Google Kubernetes Engine zone in which the
-            cluster resides, e.g. 'us-central1-a'
-        :type location: str
-        :param cluster_name: The name of the Google Kubernetes Engine cluster the pod
-            should be spawned in
-        :type cluster_name: str
-        :param gcp_conn_id: The google cloud connection id to use. This allows for
-            users to specify a service account.
-        :type gcp_conn_id: str
-        """
         super(GKEPodOperator, self).__init__(*args, **kwargs)
         self.project_id = project_id
         self.location = location
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index ee762d6527eac..1c94c85c6c4ca 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -49,7 +49,7 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
     :type schema_fields: list
     :param schema_object: If set, a GCS object path pointing to a .json file that
         contains the schema for the table. (templated)
-    :param schema_object: string
+    :type schema_object: string
     :param source_format: File format to export.
     :type source_format: string
     :param compression: [Optional] The compression type of the data source.
@@ -78,7 +78,7 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         invalid error is returned in the job result.
     :type ignore_unknown_values: bool
     :param allow_quoted_newlines: Whether to allow quoted newlines (true) or not (false).
-    :type allow_quoted_newlines: boolean
+    :type allow_quoted_newlines: bool
     :param allow_jagged_rows: Accept rows that are missing trailing optional columns.
         The missing values are treated as nulls. If false, records with missing trailing
         columns are treated as bad records, and if there are too many bad records, an
diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index 256685f90b2e1..523240c9090c4 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -38,7 +38,7 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
             unsupported.
     :type source_object: string
     :param destination_bucket: The destination Google cloud storage bucket
-    where the object should be. (templated)
+        where the object should be. (templated)
     :type destination_bucket: string
     :param destination_object: The destination name of the object in the
         destination Google cloud storage bucket. (templated)
@@ -46,15 +46,14 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
         prefix that will be prepended to the final destination objects' paths.
         Note that the source path's part before the wildcard will be removed;
         if it needs to be retained it should be appended to destination_object.
-        For example, with prefix ``foo/*`` and destination_object `'blah/``, the
+        For example, with prefix ``foo/*`` and destination_object ``blah/``, the
         file ``foo/baz`` will be copied to ``blah/baz``; to retain the prefix write
         the destination_object as e.g. ``blah/foo``, in which case the copied file
         will be named ``blah/foo/baz``.
     :type destination_object: string
     :param move_object: When move object is True, the object is moved instead
-    of copied to the new location.
-                        This is the equivalent of a mv command as opposed to a
-                        cp command.
+        of copied to the new location. This is the equivalent of a mv command
+        as opposed to a cp command.
     :type move_object: bool
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google cloud storage.
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 88dae39453081..b6af554606dc0 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -282,7 +282,6 @@ class MLEngineModelOperator(BaseOperator):
     :param project_id: The Google Cloud project name to which MLEngine
         model belongs. (templated)
     :type project_id: string
-
     :param model: A dictionary containing the information about the model.
         If the `operation` is `create`, then the `model` parameter should
         contain all the information about this model such as `name`.
@@ -290,15 +289,13 @@ class MLEngineModelOperator(BaseOperator):
         If the `operation` is `get`, the `model` parameter
         should contain the `name` of the model.
     :type model: dict
-
     :param operation: The operation to perform. Available operations are:
 
         * ``create``: Creates a new model as provided by the `model` parameter.
         * ``get``: Gets a particular model where the name is specified in `model`.
-
+    :type operation: string
     :param gcp_conn_id: The connection ID to use when fetching connection info.
     :type gcp_conn_id: string
-
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index b831adba19c72..f2735224790c4 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -67,7 +67,9 @@ class S3ToGoogleCloudStorageOperator(S3ListOperator):
 
 
     **Example**:
+
     .. code-block:: python
+
        s3_to_gcs_op = S3ToGoogleCloudStorageOperator(
             task_id='s3_to_gcs_example',
             bucket='my-s3-bucket',
diff --git a/airflow/operators/oracle_operator.py b/airflow/operators/oracle_operator.py
index 84820c079013e..275165f1c77e5 100644
--- a/airflow/operators/oracle_operator.py
+++ b/airflow/operators/oracle_operator.py
@@ -25,6 +25,7 @@
 class OracleOperator(BaseOperator):
     """
     Executes sql code in a specific Oracle database
+
     :param oracle_conn_id: reference to a specific Oracle database
     :type oracle_conn_id: string
     :param sql: the sql code to be executed. (templated)

From d7be0995bd09ce4548fee0b3bae80156ebe1e418 Mon Sep 17 00:00:00 2001
From: Michal Dziemianko <michal.dziemianko@gmail.com>
Date: Wed, 26 Dec 2018 20:01:34 +0000
Subject: [PATCH 475/808] [Airflow-1413] Fix FTPSensor failing on error message
 with unexpected text. (#2450)

* [AIRFLOW-1413] Fix FTPSensor file presence check

Currently FTPSensor operates by checking text of error
message returned from ftp lib. It only succeeds if the
message matches the expected text. Otherwise it fails
with an exception. However the message is dependend
on a system, locale and possibly other factors.

This patch changes the operation to inspect error code
rather than message text.

It also adds option to ignore certain classes of errors
such as Host Unavailable that are recoverable, thus the
performed action can and should be retried according
to ftp spec.

* [AIRFLOW-1413] Adjustments as per code review

* [AIRFLOW-1413] fixing style

Co-Authored-By: mdziemianko <michal.dziemianko@gmail.com>
---
 airflow/contrib/sensors/ftp_sensor.py    | 49 ++++++++++++++++++++----
 tests/contrib/sensors/test_ftp_sensor.py | 29 +++++++++++++-
 2 files changed, 69 insertions(+), 9 deletions(-)

diff --git a/airflow/contrib/sensors/ftp_sensor.py b/airflow/contrib/sensors/ftp_sensor.py
index f0a49285d031a..c419a46beb4bb 100644
--- a/airflow/contrib/sensors/ftp_sensor.py
+++ b/airflow/contrib/sensors/ftp_sensor.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 import ftplib
+import re
 
 from airflow.contrib.hooks.ftp_hook import FTPHook, FTPSHook
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
@@ -26,33 +27,65 @@
 class FTPSensor(BaseSensorOperator):
     """
     Waits for a file or directory to be present on FTP.
-
-    :param path: Remote file or directory path
-    :type path: str
-    :param ftp_conn_id: The connection to run the sensor against
-    :type ftp_conn_id: str
     """
+
     template_fields = ('path',)
 
+    """Errors that are transient in nature, and where action can be retried"""
+    transient_errors = [421, 425, 426, 434, 450, 451, 452]
+
+    error_code_pattern = re.compile("([\d]+)")
+
     @apply_defaults
-    def __init__(self, path, ftp_conn_id='ftp_default', *args, **kwargs):
+    def __init__(
+            self,
+            path,
+            ftp_conn_id='ftp_default',
+            fail_on_transient_errors=True,
+            *args,
+            **kwargs):
+        """
+        Create a new FTP sensor
+
+        :param path: Remote file or directory path
+        :type path: str
+        :param fail_on_transient_errors: Fail on all errors,
+            including 4xx transient errors. Default True.
+        :type fail_on_transient_errors: bool
+        :param ftp_conn_id: The connection to run the sensor against
+        :type ftp_conn_id: str
+        """
+
         super(FTPSensor, self).__init__(*args, **kwargs)
 
         self.path = path
         self.ftp_conn_id = ftp_conn_id
+        self.fail_on_transient_errors = fail_on_transient_errors
 
     def _create_hook(self):
         """Return connection hook."""
         return FTPHook(ftp_conn_id=self.ftp_conn_id)
 
+    def _get_error_code(self, e):
+        """Extract error code from ftp exception"""
+        try:
+            matches = self.error_code_pattern.match(str(e))
+            code = int(matches.group(0))
+            return code
+        except ValueError:
+            return e
+
     def poke(self, context):
         with self._create_hook() as hook:
             self.log.info('Poking for %s', self.path)
             try:
                 hook.get_mod_time(self.path)
             except ftplib.error_perm as e:
-                error = str(e).split(None, 1)
-                if error[1] != "Can't check for file existence":
+                self.log.info('Ftp error encountered: %s', str(e))
+                error_code = self._get_error_code(e)
+                if ((error_code != 550) and
+                        (self.fail_on_transient_errors or
+                            (error_code not in self.transient_errors))):
                     raise e
 
                 return False
diff --git a/tests/contrib/sensors/test_ftp_sensor.py b/tests/contrib/sensors/test_ftp_sensor.py
index a20618fe9923b..599e3c73d28b0 100644
--- a/tests/contrib/sensors/test_ftp_sensor.py
+++ b/tests/contrib/sensors/test_ftp_sensor.py
@@ -49,8 +49,13 @@ def test_poke(self):
                        task_id="test_task")
 
         self.hook_mock.get_mod_time.side_effect = \
-            [error_perm("550: Can't check for file existence"), None]
+            [error_perm("550: Can't check for file existence"),
+                error_perm("550: Directory or file does not exist"),
+                error_perm("550 - Directory or file does not exist"),
+                None]
 
+        self.assertFalse(op.poke(None))
+        self.assertFalse(op.poke(None))
         self.assertFalse(op.poke(None))
         self.assertTrue(op.poke(None))
 
@@ -66,6 +71,28 @@ def test_poke_fails_due_error(self):
 
         self.assertTrue("530" in str(context.exception))
 
+    def test_poke_fail_on_transient_error(self):
+        op = FTPSensor(path="foobar.json", ftp_conn_id="bob_ftp",
+                       task_id="test_task")
+
+        self.hook_mock.get_mod_time.side_effect = \
+            error_perm("434: Host unavailable")
+
+        with self.assertRaises(error_perm) as context:
+            op.execute(None)
+
+        self.assertTrue("434" in str(context.exception))
+
+    def test_poke_ignore_transient_error(self):
+        op = FTPSensor(path="foobar.json", ftp_conn_id="bob_ftp",
+                       task_id="test_task", fail_on_transient_errors=False)
+
+        self.hook_mock.get_mod_time.side_effect = \
+            [error_perm("434: Host unavailable"), None]
+
+        self.assertFalse(op.poke(None))
+        self.assertTrue(op.poke(None))
+
 
 if __name__ == '__main__':
     unittest.main()

From c42aaf2f6aa7afe4e87ada6ab7ddc5b3ee448e71 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sat, 8 Dec 2018 22:31:39 +0000
Subject: [PATCH 476/808] [AIRFLOW-XXX] Fix Minor issues with Azure Cosmos
 Operator (#4289)

- Fixed Documentation in integration.rst
- Fixed Incorrect type in docstring of `AzureCosmosInsertDocumentOperator`
- Added the Hook, Sensor and Operator in code.rst
- Updated the name of example DAG and its filename to follow the convention
---
 ...or.py => example_azure_cosmosdb_sensor.py} | 128 ++++++-------
 ...t_operator.py => azure_cosmos_operator.py} | 138 +++++++-------
 docs/code.rst                                 |   4 +
 docs/integration.rst                          |  14 +-
 ...st_azure_cosmos_insertdocument_operator.py | 168 +++++++++---------
 5 files changed, 228 insertions(+), 224 deletions(-)
 rename airflow/contrib/example_dags/{example_cosmosdb_sensor.py => example_azure_cosmosdb_sensor.py} (88%)
 rename airflow/contrib/operators/{azure_cosmos_insertdocument_operator.py => azure_cosmos_operator.py} (91%)

diff --git a/airflow/contrib/example_dags/example_cosmosdb_sensor.py b/airflow/contrib/example_dags/example_azure_cosmosdb_sensor.py
similarity index 88%
rename from airflow/contrib/example_dags/example_cosmosdb_sensor.py
rename to airflow/contrib/example_dags/example_azure_cosmosdb_sensor.py
index a801d9f41ba23..dd0b83e811d1f 100644
--- a/airflow/contrib/example_dags/example_cosmosdb_sensor.py
+++ b/airflow/contrib/example_dags/example_azure_cosmosdb_sensor.py
@@ -1,64 +1,64 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-"""
-This is only an example DAG to highlight usage of AzureCosmosDocumentSensor to detect
-if a document now exists.
-
-You can trigger this manually with `airflow trigger_dag example_cosmosdb_sensor`.
-
-*Note: Make sure that connection `azure_cosmos_default` is properly set before running
-this example.*
-"""
-
-from airflow import DAG
-from airflow.contrib.sensors.azure_cosmos_sensor import AzureCosmosDocumentSensor
-from airflow.contrib.operators.azure_cosmos_insertdocument_operator import AzureCosmosInsertDocumentOperator
-from airflow.utils import dates
-
-default_args = {
-    'owner': 'airflow',
-    'depends_on_past': False,
-    'start_date': dates.days_ago(2),
-    'email': ['airflow@example.com'],
-    'email_on_failure': False,
-    'email_on_retry': False
-}
-
-dag = DAG('example_cosmosdb_sensor', default_args=default_args)
-
-dag.doc_md = __doc__
-
-t1 = AzureCosmosDocumentSensor(
-    task_id='check_cosmos_file',
-    database_name='airflow_example_db',
-    collection_name='airflow_example_coll',
-    document_id='airflow_checkid',
-    azure_cosmos_conn_id='azure_cosmos_default',
-    dag=dag)
-
-t2 = AzureCosmosInsertDocumentOperator(
-    task_id='insert_cosmos_file',
-    dag=dag,
-    database_name='airflow_example_db',
-    collection_name='new-collection',
-    document={"id": "someuniqueid", "param1": "value1", "param2": "value2"},
-    azure_cosmos_conn_id='azure_cosmos_default')
-
-t2.set_upstream(t1)
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+This is only an example DAG to highlight usage of AzureCosmosDocumentSensor to detect
+if a document now exists.
+
+You can trigger this manually with `airflow trigger_dag example_cosmosdb_sensor`.
+
+*Note: Make sure that connection `azure_cosmos_default` is properly set before running
+this example.*
+"""
+
+from airflow import DAG
+from airflow.contrib.sensors.azure_cosmos_sensor import AzureCosmosDocumentSensor
+from airflow.contrib.operators.azure_cosmos_operator import AzureCosmosInsertDocumentOperator
+from airflow.utils import dates
+
+default_args = {
+    'owner': 'airflow',
+    'depends_on_past': False,
+    'start_date': dates.days_ago(2),
+    'email': ['airflow@example.com'],
+    'email_on_failure': False,
+    'email_on_retry': False
+}
+
+dag = DAG('example_azure_cosmosdb_sensor', default_args=default_args)
+
+dag.doc_md = __doc__
+
+t1 = AzureCosmosDocumentSensor(
+    task_id='check_cosmos_file',
+    database_name='airflow_example_db',
+    collection_name='airflow_example_coll',
+    document_id='airflow_checkid',
+    azure_cosmos_conn_id='azure_cosmos_default',
+    dag=dag)
+
+t2 = AzureCosmosInsertDocumentOperator(
+    task_id='insert_cosmos_file',
+    dag=dag,
+    database_name='airflow_example_db',
+    collection_name='new-collection',
+    document={"id": "someuniqueid", "param1": "value1", "param2": "value2"},
+    azure_cosmos_conn_id='azure_cosmos_default')
+
+t1 >> t2
diff --git a/airflow/contrib/operators/azure_cosmos_insertdocument_operator.py b/airflow/contrib/operators/azure_cosmos_operator.py
similarity index 91%
rename from airflow/contrib/operators/azure_cosmos_insertdocument_operator.py
rename to airflow/contrib/operators/azure_cosmos_operator.py
index 930ff402d0507..e0fbaf2dd2f72 100644
--- a/airflow/contrib/operators/azure_cosmos_insertdocument_operator.py
+++ b/airflow/contrib/operators/azure_cosmos_operator.py
@@ -1,69 +1,69 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
-from airflow.models import BaseOperator
-from airflow.utils.decorators import apply_defaults
-
-
-class AzureCosmosInsertDocumentOperator(BaseOperator):
-    """
-    Inserts a new document into the specified Cosmos database and collection
-    It will create both the database and collection if they do not already exist
-
-    :param database_name: The name of the database. (templated)
-    :type database_name: str
-    :param collection_name: The name of the collection. (templated)
-    :type collection_name: str
-    :param document: The document to insert
-    :type document: json
-    :param azure_cosmos_conn_id: reference to a CosmosDB connection.
-    :type azure_cosmos_conn_id: str
-    """
-    template_fields = ('database_name', 'collection_name')
-    ui_color = '#e4f0e8'
-
-    @apply_defaults
-    def __init__(self,
-                 database_name,
-                 collection_name,
-                 document,
-                 azure_cosmos_conn_id='azure_cosmos_default',
-                 *args,
-                 **kwargs):
-        super(AzureCosmosInsertDocumentOperator, self).__init__(*args, **kwargs)
-        self.database_name = database_name
-        self.collection_name = collection_name
-        self.document = document
-        self.azure_cosmos_conn_id = azure_cosmos_conn_id
-
-    def execute(self, context):
-        # Create the hook
-        hook = AzureCosmosDBHook(azure_cosmos_conn_id=self.azure_cosmos_conn_id)
-
-        # Create the DB if it doesn't already exist
-        if (not hook.does_database_exist(self.database_name)):
-            hook.create_database(self.database_name)
-
-        # Create the collection as well
-        if (not hook.does_collection_exist(self.collection_name, self.database_name)):
-            hook.create_collection(self.collection_name, self.database_name)
-
-        # finally insert the document
-        hook.upsert_document(self.document, self.database_name, self.collection_name)
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class AzureCosmosInsertDocumentOperator(BaseOperator):
+    """
+    Inserts a new document into the specified Cosmos database and collection
+    It will create both the database and collection if they do not already exist
+
+    :param database_name: The name of the database. (templated)
+    :type database_name: str
+    :param collection_name: The name of the collection. (templated)
+    :type collection_name: str
+    :param document: The document to insert
+    :type document: dict
+    :param azure_cosmos_conn_id: reference to a CosmosDB connection.
+    :type azure_cosmos_conn_id: str
+    """
+    template_fields = ('database_name', 'collection_name')
+    ui_color = '#e4f0e8'
+
+    @apply_defaults
+    def __init__(self,
+                 database_name,
+                 collection_name,
+                 document,
+                 azure_cosmos_conn_id='azure_cosmos_default',
+                 *args,
+                 **kwargs):
+        super(AzureCosmosInsertDocumentOperator, self).__init__(*args, **kwargs)
+        self.database_name = database_name
+        self.collection_name = collection_name
+        self.document = document
+        self.azure_cosmos_conn_id = azure_cosmos_conn_id
+
+    def execute(self, context):
+        # Create the hook
+        hook = AzureCosmosDBHook(azure_cosmos_conn_id=self.azure_cosmos_conn_id)
+
+        # Create the DB if it doesn't already exist
+        if not hook.does_database_exist(self.database_name):
+            hook.create_database(self.database_name)
+
+        # Create the collection as well
+        if not hook.does_collection_exist(self.collection_name, self.database_name):
+            hook.create_collection(self.collection_name, self.database_name)
+
+        # finally insert the document
+        hook.upsert_document(self.document, self.database_name, self.collection_name)
diff --git a/docs/code.rst b/docs/code.rst
index 1a90e738024c9..a9bde6558ac4f 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -133,6 +133,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.aws_athena_operator.AWSAthenaOperator
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
+.. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
@@ -235,6 +236,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.aws_athena_sensor.AthenaSensor
 .. autoclass:: airflow.contrib.sensors.aws_glue_catalog_partition_sensor.AwsGlueCatalogPartitionSensor
 .. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
+.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor
 .. autoclass:: airflow.contrib.sensors.bash_sensor.BashSensor
 .. autoclass:: airflow.contrib.sensors.bigquery_sensor.BigQueryTableSensor
 .. autoclass:: airflow.contrib.sensors.cassandra_record_sensor.CassandraRecordSensor
@@ -420,6 +422,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
 .. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
 .. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
+.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
 .. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
 .. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
@@ -477,3 +480,4 @@ Community-contributed executors
 '''''''''''''''''''''''''''''''
 
 .. autoclass:: airflow.contrib.executors.mesos_executor.MesosExecutor
+.. autoclass:: airflow.contrib.executors.kubernetes_executor.KubernetesExecutor
diff --git a/docs/integration.rst b/docs/integration.rst
index b408b7ba39a56..9cad62a225935 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -163,7 +163,7 @@ Airflow can be configured to read and write task logs in Azure Blob Storage.
 See :ref:`write-logs-azure`.
 
 Azure CosmosDB 
-'''''''''''''''''' 
+''''''''''''''
  
 AzureCosmosDBHook communicates via the Azure Cosmos library. Make sure that a 
 Airflow connection of type `azure_cosmos` exists. Authorization can be done by supplying a 
@@ -174,20 +174,20 @@ default database and collection to use (see connection `azure_cosmos_default` fo
 - :ref:`AzureCosmosInsertDocumentOperator`: Simple operator to insert document into CosmosDB. 
 - :ref:`AzureCosmosDocumentSensor`: Simple sensor to detect document existence in CosmosDB. 
 
-.. AzureCosmosDBHook: 
- 
+.. _AzureCosmosDBHook:
+
 AzureCosmosDBHook 
-""""""""" 
+"""""""""""""""""
  
 .. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook 
  
 AzureCosmosInsertDocumentOperator 
-""""""""" 
+"""""""""""""""""""""""""""""""""
  
-.. autoclass:: airflow.contrib.operators.azure_cosmos_insertdocument_operator.AzureCosmosInsertDocumentOperator 
+.. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
  
 AzureCosmosDocumentSensor 
-""""""""" 
+"""""""""""""""""""""""""
  
 .. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor 
 
diff --git a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
index 26099d0cb3b57..e6e1abe374f82 100644
--- a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
+++ b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
@@ -1,84 +1,84 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-#
-
-
-import json
-import unittest
-import uuid
-
-from airflow.contrib.operators.azure_cosmos_insertdocument_operator import AzureCosmosInsertDocumentOperator
-
-from airflow import configuration
-from airflow import models
-from airflow.utils import db
-
-try:
-    from unittest import mock
-
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-
-class TestAzureCosmosDbHook(unittest.TestCase):
-
-    # Set up an environment to test with
-    def setUp(self):
-        # set up some test variables
-        self.test_end_point = 'https://test_endpoint:443'
-        self.test_master_key = 'magic_test_key'
-        self.test_database_name = 'test_database_name'
-        self.test_collection_name = 'test_collection_name'
-        configuration.load_test_config()
-        db.merge_conn(
-            models.Connection(
-                conn_id='azure_cosmos_test_key_id',
-                conn_type='azure_cosmos',
-                login=self.test_end_point,
-                password=self.test_master_key,
-                extra=json.dumps({'database_name': self.test_database_name,
-                                  'collection_name': self.test_collection_name})
-            )
-        )
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_insert_document(self, cosmos_mock):
-        test_id = str(uuid.uuid4())
-        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
-        self.cosmos = AzureCosmosInsertDocumentOperator(
-            database_name=self.test_database_name,
-            collection_name=self.test_collection_name,
-            document={'id': test_id, 'data': 'sometestdata'},
-            azure_cosmos_conn_id='azure_cosmos_test_key_id',
-            task_id='azure_cosmos_sensor')
-
-        expected_calls = [mock.call().CreateItem(
-            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
-            {'data': 'sometestdata', 'id': test_id})]
-
-        self.cosmos.execute(None)
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-
-if __name__ == '__main__':
-    unittest.main()
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+
+import json
+import unittest
+import uuid
+
+from airflow.contrib.operators.azure_cosmos_operator import AzureCosmosInsertDocumentOperator
+
+from airflow import configuration
+from airflow import models
+from airflow.utils import db
+
+try:
+    from unittest import mock
+
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestAzureCosmosDbHook(unittest.TestCase):
+
+    # Set up an environment to test with
+    def setUp(self):
+        # set up some test variables
+        self.test_end_point = 'https://test_endpoint:443'
+        self.test_master_key = 'magic_test_key'
+        self.test_database_name = 'test_database_name'
+        self.test_collection_name = 'test_collection_name'
+        configuration.load_test_config()
+        db.merge_conn(
+            models.Connection(
+                conn_id='azure_cosmos_test_key_id',
+                conn_type='azure_cosmos',
+                login=self.test_end_point,
+                password=self.test_master_key,
+                extra=json.dumps({'database_name': self.test_database_name,
+                                  'collection_name': self.test_collection_name})
+            )
+        )
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_insert_document(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosInsertDocumentOperator(
+            database_name=self.test_database_name,
+            collection_name=self.test_collection_name,
+            document={'id': test_id, 'data': 'sometestdata'},
+            azure_cosmos_conn_id='azure_cosmos_test_key_id',
+            task_id='azure_cosmos_sensor')
+
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
+            {'data': 'sometestdata', 'id': test_id})]
+
+        self.cosmos.execute(None)
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+
+if __name__ == '__main__':
+    unittest.main()

From f00b2a2f39f2cef12e4394253bfbb9703aa49dce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Victor=20No=C3=ABl?= <victornoel@users.noreply.github.com>
Date: Mon, 26 Nov 2018 10:02:08 +0100
Subject: [PATCH 477/808] [AIRFLOW-3378] KubernetesPodOperator does not delete
 on timeout failure (#4218)

Signed-off-by: Victor Noel <victor.noel@brennus-analytics.com>
---
 .../operators/kubernetes_pod_operator.py      | 15 ++++++-------
 .../minikube/test_kubernetes_pod_operator.py  | 21 +++++++++++++++++++
 2 files changed, 29 insertions(+), 7 deletions(-)

diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 4494754f970f8..d560e2472d5a8 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -126,13 +126,14 @@ def execute(self, context):
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
-            (final_state, result) = launcher.run_pod(
-                pod,
-                startup_timeout=self.startup_timeout_seconds,
-                get_logs=self.get_logs)
-
-            if self.is_delete_operator_pod:
-                launcher.delete_pod(pod)
+            try:
+                (final_state, result) = launcher.run_pod(
+                    pod,
+                    startup_timeout=self.startup_timeout_seconds,
+                    get_logs=self.get_logs)
+            finally:
+                if self.is_delete_operator_pod:
+                    launcher.delete_pod(pod)
 
             if final_state != State.SUCCESS:
                 raise AirflowException(
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index f808a2f47febe..e1dfce28c44a6 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -107,6 +107,27 @@ def test_image_pull_secrets_correctly_set(self, client_mock, launcher_mock):
         self.assertEqual(launcher_mock.call_args[0][0].image_pull_secrets,
                          fake_pull_secrets)
 
+    @mock.patch("airflow.contrib.kubernetes.pod_launcher.PodLauncher.run_pod")
+    @mock.patch("airflow.contrib.kubernetes.pod_launcher.PodLauncher.delete_pod")
+    @mock.patch("airflow.contrib.kubernetes.kube_client.get_kube_client")
+    def test_pod_delete_even_on_launcher_error(self, client_mock, delete_pod_mock, run_pod_mock):
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            in_cluster=False,
+            cluster_context='default',
+            is_delete_operator_pod=True
+        )
+        run_pod_mock.side_effect = AirflowException('fake failure')
+        with self.assertRaises(AirflowException):
+            k.execute(None)
+        delete_pod_mock.assert_called()
+
     @staticmethod
     def test_working_pod():
         k = KubernetesPodOperator(

From 5724d23a0ef3603bb89f69391716a1e4e3314988 Mon Sep 17 00:00:00 2001
From: rmn36 <rmn36@case.edu>
Date: Fri, 23 Nov 2018 10:41:04 -0800
Subject: [PATCH 478/808] [AIRFLOW-3336] Add new TriggerRule for 0 upstream
 failures (#4182)

Add new TriggerRule that triggers only if all upstream do not fail (success or skipped tasks are allowed)
---
 airflow/models.py                           |  2 +-
 airflow/ti_deps/deps/trigger_rule_dep.py    | 14 ++++++++
 airflow/utils/trigger_rule.py               |  1 +
 docs/concepts.rst                           |  1 +
 tests/ti_deps/deps/test_trigger_rule_dep.py | 38 +++++++++++++++++++++
 tests/utils/test_trigger_rule.py            |  3 +-
 6 files changed, 57 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index c236957cfdb7e..b1bc86e74c2eb 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2431,7 +2431,7 @@ class derived from this one results in the creation of a task object,
     :param trigger_rule: defines the rule by which dependencies are applied
         for the task to get triggered. Options are:
         ``{ all_success | all_failed | all_done | one_success |
-        one_failed | dummy}``
+        one_failed | none_failed | dummy}``
         default is ``all_success``. Options can be set as string or
         using the constants defined in the static class
         ``airflow.utils.TriggerRule``
diff --git a/airflow/ti_deps/deps/trigger_rule_dep.py b/airflow/ti_deps/deps/trigger_rule_dep.py
index 76e5e1324ffd7..3bdd0ad34c248 100644
--- a/airflow/ti_deps/deps/trigger_rule_dep.py
+++ b/airflow/ti_deps/deps/trigger_rule_dep.py
@@ -152,6 +152,11 @@ def _evaluate_trigger_rule(
             elif tr == TR.ONE_FAILED:
                 if upstream_done and not (failed or upstream_failed):
                     ti.set_state(State.SKIPPED, session)
+            elif tr == TR.NONE_FAILED:
+                if upstream_failed or failed:
+                    ti.set_state(State.UPSTREAM_FAILED, session)
+                elif skipped == upstream:
+                    ti.set_state(State.SKIPPED, session)
 
         if tr == TR.ONE_SUCCESS:
             if successes <= 0:
@@ -194,6 +199,15 @@ def _evaluate_trigger_rule(
                     "upstream_task_ids={3}"
                     .format(tr, upstream_done, upstream_tasks_state,
                             task.upstream_task_ids))
+        elif tr == TR.NONE_FAILED:
+            num_failures = upstream - successes - skipped
+            if num_failures > 0:
+                yield self._failing_status(
+                    reason="Task's trigger rule '{0}' requires all upstream "
+                    "tasks to have succeeded or been skipped, but found {1} non-success(es). "
+                    "upstream_tasks_state={2}, upstream_task_ids={3}"
+                    .format(tr, num_failures, upstream_tasks_state,
+                            task.upstream_task_ids))
         else:
             yield self._failing_status(
                 reason="No strategy to evaluate trigger rule '{0}'.".format(tr))
diff --git a/airflow/utils/trigger_rule.py b/airflow/utils/trigger_rule.py
index 7fdcbc8ca8057..4f7db65f7bae5 100644
--- a/airflow/utils/trigger_rule.py
+++ b/airflow/utils/trigger_rule.py
@@ -29,6 +29,7 @@ class TriggerRule(object):
     ONE_SUCCESS = 'one_success'
     ONE_FAILED = 'one_failed'
     DUMMY = 'dummy'
+    NONE_FAILED = 'none_failed'
 
     _ALL_TRIGGER_RULES = {}
 
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 95f6e6a7a60ae..f23a8d488f6b7 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -622,6 +622,7 @@ while creating tasks:
 * ``all_done``: all parents are done with their execution
 * ``one_failed``: fires as soon as at least one parent has failed, it does not wait for all parents to be done
 * ``one_success``: fires as soon as at least one parent succeeds, it does not wait for all parents to be done
+* ``none_failed``: all parents have not failed (``failed`` or ``upstream_failed``) i.e. all parents have succeeded or been skipped
 * ``dummy``: dependencies are just for show, trigger at will
 
 Note that these can be used in conjunction with ``depends_on_past`` (boolean)
diff --git a/tests/ti_deps/deps/test_trigger_rule_dep.py b/tests/ti_deps/deps/test_trigger_rule_dep.py
index 14dc01756c0fa..2f3258f810991 100644
--- a/tests/ti_deps/deps/test_trigger_rule_dep.py
+++ b/tests/ti_deps/deps/test_trigger_rule_dep.py
@@ -163,6 +163,44 @@ def test_all_success_tr_failure(self):
         self.assertEqual(len(dep_statuses), 1)
         self.assertFalse(dep_statuses[0].passed)
 
+    def test_none_failed_tr_success(self):
+        """
+        All success including skip trigger rule success
+        """
+        ti = self._get_task_instance(TriggerRule.NONE_FAILED,
+                                     upstream_task_ids=["FakeTaskID",
+                                                        "OtherFakeTaskID"])
+        dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+            ti=ti,
+            successes=1,
+            skipped=1,
+            failed=0,
+            upstream_failed=0,
+            done=2,
+            flag_upstream_failed=False,
+            session="Fake Session"))
+        self.assertEqual(len(dep_statuses), 0)
+
+    def test_none_failed_tr_failure(self):
+        """
+        All success including skip trigger rule failure
+        """
+        ti = self._get_task_instance(TriggerRule.NONE_FAILED,
+                                     upstream_task_ids=["FakeTaskID",
+                                                        "OtherFakeTaskID",
+                                                        "FailedFakeTaskID"])
+        dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+            ti=ti,
+            successes=1,
+            skipped=1,
+            failed=1,
+            upstream_failed=0,
+            done=3,
+            flag_upstream_failed=False,
+            session="Fake Session"))
+        self.assertEqual(len(dep_statuses), 1)
+        self.assertFalse(dep_statuses[0].passed)
+
     def test_all_failed_tr_success(self):
         """
         All-failed trigger rule success
diff --git a/tests/utils/test_trigger_rule.py b/tests/utils/test_trigger_rule.py
index f068542849d35..ab21edd343ced 100644
--- a/tests/utils/test_trigger_rule.py
+++ b/tests/utils/test_trigger_rule.py
@@ -29,5 +29,6 @@ def test_valid_trigger_rules(self):
         self.assertTrue(TriggerRule.is_valid(TriggerRule.ALL_DONE))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.ONE_SUCCESS))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.ONE_FAILED))
+        self.assertTrue(TriggerRule.is_valid(TriggerRule.NONE_FAILED))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.DUMMY))
-        self.assertEqual(len(TriggerRule.all_triggers()), 6)
+        self.assertEqual(len(TriggerRule.all_triggers()), 7)

From fea522740fec10ed26b2d55f4c291e560cc120e6 Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Thu, 22 Nov 2018 22:58:32 +1100
Subject: [PATCH 479/808] [AIRFLOW-3382] Fix incorrect docstring in
 DatastoreHook (#4222)

Correct docstring in DatastoreHook
---
 airflow/contrib/hooks/datastore_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/datastore_hook.py b/airflow/contrib/hooks/datastore_hook.py
index 26ed4be544943..308809e1413b1 100644
--- a/airflow/contrib/hooks/datastore_hook.py
+++ b/airflow/contrib/hooks/datastore_hook.py
@@ -41,7 +41,7 @@ def __init__(self,
 
     def get_conn(self, version='v1'):
         """
-        Returns a Google Cloud Storage service object.
+        Returns a Google Cloud Datastore service object.
         """
         http_authorized = self._authorize()
         return build(

From 6fb66759652445e6761524f6703e2eb2db17fcd9 Mon Sep 17 00:00:00 2001
From: Nicholas Huang <nicholas.ykhuang@gmail.com>
Date: Tue, 20 Nov 2018 01:15:32 -0800
Subject: [PATCH 480/808] AIRFLOW-XXX Fix copy&paste mistake (#4212)

In emr_create_job_flow_operator.py the :type clearly mismatches with
the :param name, suggesting a copy&paste mistake.
---
 airflow/contrib/operators/emr_create_job_flow_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/emr_create_job_flow_operator.py b/airflow/contrib/operators/emr_create_job_flow_operator.py
index cb63f309123d7..62c21a7533fe1 100644
--- a/airflow/contrib/operators/emr_create_job_flow_operator.py
+++ b/airflow/contrib/operators/emr_create_job_flow_operator.py
@@ -34,7 +34,7 @@ class EmrCreateJobFlowOperator(BaseOperator):
     :type emr_conn_id: str
     :param job_flow_overrides: boto3 style arguments to override
        emr_connection extra. (templated)
-    :type steps: dict
+    :type job_flow_overrides: dict
     """
     template_fields = ['job_flow_overrides']
     template_ext = ()

From 88314d066705f1142c3fd950d267e7c47bfcdf14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcin=20Szyma=C5=84ski?= <ms32035@gmail.com>
Date: Tue, 13 Nov 2018 14:37:57 +0100
Subject: [PATCH 481/808] [AIRFLOW-3245] fix list processing in
 resolve_template_files (#4086)

* [AIRFLOW-3245] fix list processing in resolve_template_files

* [AIRFLOW-3245] add tests

* [AIRFLOW-3245] modify tests
---
 airflow/models.py | 14 ++++++++++++--
 tests/models.py   | 45 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index b1bc86e74c2eb..c9f6b4ed3b545 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2921,14 +2921,24 @@ def resolve_template_files(self):
         # Getting the content of files for template_field / template_ext
         for attr in self.template_fields:
             content = getattr(self, attr)
-            if content is not None and \
-                    isinstance(content, six.string_types) and \
+            if content is None:
+                continue
+            elif isinstance(content, six.string_types) and \
                     any([content.endswith(ext) for ext in self.template_ext]):
                 env = self.dag.get_template_env()
                 try:
                     setattr(self, attr, env.loader.get_source(env, content)[0])
                 except Exception as e:
                     self.log.exception(e)
+            elif isinstance(content, list):
+                env = self.dag.get_template_env()
+                for i in range(len(content)):
+                    if isinstance(content[i], six.string_types) and \
+                            any([content[i].endswith(ext) for ext in self.template_ext]):
+                        try:
+                            content[i] = env.loader.get_source(env, content[i])[0]
+                        except Exception as e:
+                            self.log.exception(e)
         self.prepare_template()
 
     @property
diff --git a/tests/models.py b/tests/models.py
index a627d3eb9bd26..72c5dedce5dc8 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -449,6 +449,51 @@ def jinja_udf(name):
         result = task.render_template('', "{{ 'world' | hello}}", dict())
         self.assertEqual(result, 'Hello world')
 
+    def test_resolve_template_files_value(self):
+
+        with NamedTemporaryFile(suffix='.template') as f:
+            f.write('{{ ds }}'.encode('utf8'))
+            f.flush()
+            template_dir = os.path.dirname(f.name)
+            template_file = os.path.basename(f.name)
+
+            dag = DAG('test-dag',
+                      start_date=DEFAULT_DATE,
+                      template_searchpath=template_dir)
+
+            with dag:
+                task = DummyOperator(task_id='op1')
+
+            task.test_field = template_file
+            task.template_fields = ('test_field',)
+            task.template_ext = ('.template',)
+            task.resolve_template_files()
+
+        self.assertEqual(task.test_field, '{{ ds }}')
+
+    def test_resolve_template_files_list(self):
+
+        with NamedTemporaryFile(suffix='.template') as f:
+            f = NamedTemporaryFile(suffix='.template')
+            f.write('{{ ds }}'.encode('utf8'))
+            f.flush()
+            template_dir = os.path.dirname(f.name)
+            template_file = os.path.basename(f.name)
+
+            dag = DAG('test-dag',
+                      start_date=DEFAULT_DATE,
+                      template_searchpath=template_dir)
+
+            with dag:
+                task = DummyOperator(task_id='op1')
+
+            task.test_field = [template_file, 'some_string']
+            task.template_fields = ('test_field',)
+            task.template_ext = ('.template',)
+            task.resolve_template_files()
+
+        self.assertEqual(task.test_field, ['{{ ds }}', 'some_string'])
+
     def test_cycle(self):
         # test empty
         dag = DAG(

From 959dd619d19223db3709fa4abcf52e8ee98bc079 Mon Sep 17 00:00:00 2001
From: mishikaSingh <mishikaps@gmail.com>
Date: Wed, 31 Oct 2018 18:51:28 +0530
Subject: [PATCH 482/808] [AIRFLOW-2703] Catch transient DB exceptions from
 scheduler's heartbeat it does not crash (#3650)

If there is any issue in DB connection then rest of the functions take care of those exceptions but in heartbeat of scheduler, there is no handling for this kind of situation.

Airflow Scheduler should not crash if a "transient" DB exception occurs in the heartbeat of scheduler.
---
 airflow/jobs.py | 47 +++++++++++++++++++++++++----------------------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 3c2afee1f0860..c08ebc023397c 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -156,33 +156,36 @@ def heartbeat(self):
         heart rate. If you go over 60 seconds before calling it, it won't
         sleep at all.
         """
-        with create_session() as session:
-            job = session.query(BaseJob).filter_by(id=self.id).one()
-            make_transient(job)
-            session.commit()
+        try:
+            with create_session() as session:
+                job = session.query(BaseJob).filter_by(id=self.id).one()
+                make_transient(job)
+                session.commit()
 
-        if job.state == State.SHUTDOWN:
-            self.kill()
+            if job.state == State.SHUTDOWN:
+                self.kill()
 
-        # Figure out how long to sleep for
-        sleep_for = 0
-        if job.latest_heartbeat:
-            sleep_for = max(
-                0,
-                self.heartrate - (
-                    timezone.utcnow() - job.latest_heartbeat).total_seconds())
+            # Figure out how long to sleep for
+            sleep_for = 0
+            if job.latest_heartbeat:
+                sleep_for = max(
+                    0,
+                    self.heartrate - (timezone.utcnow() -
+                                      job.latest_heartbeat).total_seconds())
 
-        sleep(sleep_for)
+            sleep(sleep_for)
 
-        # Update last heartbeat time
-        with create_session() as session:
-            job = session.query(BaseJob).filter(BaseJob.id == self.id).first()
-            job.latest_heartbeat = timezone.utcnow()
-            session.merge(job)
-            session.commit()
+            # Update last heartbeat time
+            with create_session() as session:
+                job = session.query(BaseJob).filter(BaseJob.id == self.id).first()
+                job.latest_heartbeat = timezone.utcnow()
+                session.merge(job)
+                session.commit()
 
-            self.heartbeat_callback(session=session)
-            self.log.debug('[heartbeat]')
+                self.heartbeat_callback(session=session)
+                self.log.debug('[heartbeat]')
+        except OperationalError as e:
+            self.log.error("Scheduler heartbeat got an exception: %s", str(e))
 
     def run(self):
         Stats.incr(self.__class__.__name__.lower() + '_start', 1, 1)

From cfcc10651b79b5b78a7abe9ff381f5b195361077 Mon Sep 17 00:00:00 2001
From: marengaz <marengaz@users.noreply.github.com>
Date: Mon, 29 Oct 2018 14:28:52 +0000
Subject: [PATCH 483/808] [AIRFLOW-3260] Correct misleading BigQuery error
 (#4098)

---
 airflow/contrib/operators/bigquery_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 2f0bb07c71d55..43049d9c7e334 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -208,7 +208,7 @@ def execute(self, context):
     def on_kill(self):
         super(BigQueryOperator, self).on_kill()
         if self.bq_cursor is not None:
-            self.log.info('Canceling running query due to execution timeout')
+            self.log.info('Cancelling running query')
             self.bq_cursor.cancel_query()
 
 

From 0b95fedd74ad0a770e3d9e6b4f81ef65fb178bc8 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 8 Oct 2018 13:22:03 +0100
Subject: [PATCH 484/808] [AIRFLOW-XXX] Fix Typo in SFTPOperator docstring
 (#4016)

---
 airflow/contrib/operators/sftp_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 216d2da08bc63..16e3be365210c 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -32,7 +32,7 @@ class SFTPOperation(object):
 class SFTPOperator(BaseOperator):
     """
     SFTPOperator for transferring files from remote host to local or vice a versa.
-    This operator uses ssh_hook to open sftp trasport channel that serve as basis
+    This operator uses ssh_hook to open sftp transport channel that serve as basis
     for file transfer.
 
     :param ssh_hook: predefined ssh_hook to use for remote execution.

From e719e19032d1378b668d84da93e877857cc244c5 Mon Sep 17 00:00:00 2001
From: "Santhoshkumar. P" <sann3@users.noreply.github.com>
Date: Thu, 4 Oct 2018 22:50:48 +0530
Subject: [PATCH 485/808]  [AIRFLOW-XXX] Fixing the issue in Documentation
 (#3998)

Fixing the operator name from DataFlowOperation  to DataFlowJavaOperator  in Documentation
---
 airflow/contrib/operators/dataflow_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 4e9fe0c4d29c0..0099bbc3cc3d1 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -86,7 +86,7 @@ class DataFlowJavaOperator(BaseOperator):
 
     .. code-block:: python
 
-       t1 = DataFlowOperation(
+       t1 = DataFlowJavaOperator(
            task_id='datapflow_example',
            jar='{{var.value.gcp_dataflow_base}}pipeline/build/libs/pipeline-example-1.0.jar',
            options={

From aff1bb1b389d9c0f391eb7ff5bbfacda003603c2 Mon Sep 17 00:00:00 2001
From: Szymon Bilinski <szymon.bilinski@gmail.com>
Date: Sat, 29 Sep 2018 15:45:37 +0200
Subject: [PATCH 486/808] [AIRFLOW-XXX] Fix undocumented params in S3_hook

Some function parameters were undocumented. Additional docstrings
were added for clarity.
---
 airflow/hooks/S3_hook.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index e39916a70ba3f..c337b9c535a67 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -92,6 +92,13 @@ def create_bucket(self, bucket_name, region_name=None):
     def check_for_prefix(self, bucket_name, prefix, delimiter):
         """
         Checks that a prefix exists in a bucket
+
+        :param bucket_name: the name of the bucket
+        :type bucket_name: str
+        :param prefix: a key prefix
+        :type prefix: str
+        :param delimiter: the delimiter marks key hierarchy.
+        :type delimiter: str
         """
         prefix = prefix + delimiter if prefix[-1] != delimiter else prefix
         prefix_split = re.split(r'(\w+[{d}])$'.format(d=delimiter), prefix, 1)
@@ -273,6 +280,13 @@ def check_for_wildcard_key(self,
                                wildcard_key, bucket_name=None, delimiter=''):
         """
         Checks that a key matching a wildcard expression exists in a bucket
+
+        :param wildcard_key: the path to the key
+        :type wildcard_key: str
+        :param bucket_name: the name of the bucket
+        :type bucket_name: str
+        :param delimiter: the delimiter marks key hierarchy
+        :type delimiter: str
         """
         return self.get_wildcard_key(wildcard_key=wildcard_key,
                                      bucket_name=bucket_name,
@@ -286,6 +300,8 @@ def get_wildcard_key(self, wildcard_key, bucket_name=None, delimiter=''):
         :type wildcard_key: str
         :param bucket_name: the name of the bucket
         :type bucket_name: str
+        :param delimiter: the delimiter marks key hierarchy
+        :type delimiter: str
         """
         if not bucket_name:
             (bucket_name, wildcard_key) = self.parse_s3_url(wildcard_key)

From 5ef328153be4f89c6d513cdaee0a4d738b7f90b9 Mon Sep 17 00:00:00 2001
From: Mingye Xia <mingye.xia@outlook.com>
Date: Fri, 28 Sep 2018 10:07:43 -0700
Subject: [PATCH 487/808] [AIRFLOW-3125] Monitor Task Instances creation rates
 (#3966)

Montor Task Instances creation rates by Operator type.
These stats can provide some visibility on how much workload Airflow is
getting. They can be used for resource allocation in the long run (i.e.
to determine when we should scale up workers) and debugging in scenarios
like the creation rate of certain type of Task Instances spikes.
---
 airflow/models.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/airflow/models.py b/airflow/models.py
index c9f6b4ed3b545..93633b9489647 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -5325,6 +5325,9 @@ def verify_integrity(self, session=None):
                 continue
 
             if task.task_id not in task_ids:
+                Stats.incr(
+                    "task_instance_created-{}".format(task.__class__.__name__),
+                    1, 1)
                 ti = TaskInstance(task, self.execution_date)
                 session.add(ti)
 

From ce33f4a38206ba4919049c5f228e38ace6ebf247 Mon Sep 17 00:00:00 2001
From: Nathaniel Ritholtz <nritholtz@gmail.com>
Date: Thu, 27 Sep 2018 15:43:26 -0400
Subject: [PATCH 488/808] [AIRFLOW-XXX] Fix SlackWebhookOperator execute method
 comment (#3963)

---
 airflow/contrib/operators/slack_webhook_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/slack_webhook_operator.py b/airflow/contrib/operators/slack_webhook_operator.py
index 5263b5c0f2b3f..64f2448a550dd 100644
--- a/airflow/contrib/operators/slack_webhook_operator.py
+++ b/airflow/contrib/operators/slack_webhook_operator.py
@@ -77,7 +77,7 @@ def __init__(self,
 
     def execute(self, context):
         """
-        Call the SparkSqlHook to run the provided sql query
+        Call the SlackWebhookHook to post the provided Slack message
         """
         self.hook = SlackWebhookHook(
             self.http_conn_id,

From 65736578c25fe5f5ce958f224dd7b8e423fda3b1 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 16 Sep 2018 20:38:09 +0800
Subject: [PATCH 489/808] [AIRFLOW-3070] Refine web UI authentication-related
 docs (#3863)

---
 airflow/bin/cli.py                           | 2 +-
 airflow/config_templates/default_airflow.cfg | 3 +++
 docs/security.rst                            | 7 ++++++-
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 01e25b3659172..411b62ce54000 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -2055,7 +2055,7 @@ class CLIFactory(object):
                      'conn_id', 'conn_uri', 'conn_extra') + tuple(alternative_conn_specs),
         }, {
             'func': create_user,
-            'help': "Create an account for the Web UI",
+            'help': "Create an account for the Web UI (FAB-based)",
             'args': ('role', 'username', 'email', 'firstname', 'lastname',
                      'password', 'use_random_password'),
         }, {
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index a7c180a556872..95cf69961b3f9 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -263,6 +263,9 @@ access_logfile = -
 error_logfile = -
 
 # Expose the configuration file in the web server
+# This is only applicable for the flask-admin based web UI (non FAB-based).
+# In the FAB-based web UI with RBAC feature,
+# access to configuration is controlled by role permissions.
 expose_config = False
 
 # Set to true to turn on authentication:
diff --git a/docs/security.rst b/docs/security.rst
index dec8c3fe0e73e..5efe7b847266b 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -40,9 +40,14 @@ Web Authentication
 Password
 ''''''''
 
+.. note::
+
+   This is for flask-admin based web UI only. If you are using FAB-based web UI with RBAC feature,
+   please use command line interface ``create_user`` to create accounts, or do that in the FAB-based UI itself.
+
 One of the simplest mechanisms for authentication is requiring users to specify a password before logging in.
 Password authentication requires the used of the ``password`` subpackage in your requirements file. Password hashing
-uses bcrypt before storing passwords.
+uses ``bcrypt`` before storing passwords.
 
 .. code-block:: bash
 

From cf2726c1dcd1cf5761c24eb0347cbfab1c0b3301 Mon Sep 17 00:00:00 2001
From: ubermen <kjh3477@gmail.com>
Date: Sun, 16 Sep 2018 05:01:03 +0900
Subject: [PATCH 490/808] [AIRFLOW-1298] Clear UPSTREAM_FAILED using the clean
 cli (#3886)

* [AIRFLOW-1298] Fix 'clear only_failed'

* [AIRFLOW-1298] Fix 'clear only_failed'
---
 airflow/models.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 93633b9489647..c866ef668bba6 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4003,7 +4003,9 @@ def clear(
         if end_date:
             tis = tis.filter(TI.execution_date <= end_date)
         if only_failed:
-            tis = tis.filter(TI.state == State.FAILED)
+            tis = tis.filter(or_(
+                TI.state == State.FAILED,
+                TI.state == State.UPSTREAM_FAILED))
         if only_running:
             tis = tis.filter(TI.state == State.RUNNING)
 

From d50ff40a6542cd96a7fb1bb7b0ce687206d8523e Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokkodriesprong@godatadriven.com>
Date: Mon, 15 Oct 2018 07:16:29 +0200
Subject: [PATCH 491/808] [AIRFLOW-3190] Make flake8 compliant

One voilation that slipped in by PR that didn't rebase onto
latest master
---
 airflow/operators/bash_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index d458122b8176c..c6b6cc44d5de3 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -47,7 +47,7 @@ class BashOperator(BaseOperator):
         of inheriting the current process environment, which is the default
         behavior. (templated)
     :type env: dict
-    :param output_encoding: Output encoding of bash command 
+    :param output_encoding: Output encoding of bash command
     :type output_encoding: str
     """
     template_fields = ('bash_command', 'env')

From 500541eabf9f1bba995a15ee659639c1031b2a0d Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sat, 19 Jan 2019 15:04:17 +0000
Subject: [PATCH 492/808] [AIRFLOW-3732] Fix issue when trying to edit
 connection in RBAC UI

---
 airflow/www_rbac/templates/airflow/conn_edit.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/www_rbac/templates/airflow/conn_edit.html b/airflow/www_rbac/templates/airflow/conn_edit.html
index b1cac51992fc9..92f9331aa4b8e 100644
--- a/airflow/www_rbac/templates/airflow/conn_edit.html
+++ b/airflow/www_rbac/templates/airflow/conn_edit.html
@@ -19,5 +19,5 @@
 
 {% block tail %}
   {{ super() }}
-    <script src="{{ url_for_asset('static', filename='connectionForm.js') }}"></script>
+    <script src="{{ url_for_asset(filename='connectionForm.js') }}"></script>
 {% endblock %}

From cb8b2a1dc64c3ea6ba445893c65c6c953dfb476a Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@apache.org>
Date: Sat, 19 Jan 2019 16:17:55 +0000
Subject: [PATCH 493/808] Add Changes to CHANGELOG

---
 CHANGELOG.txt | 33 ++++++++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 8c9a3c083b808..b5a0ef11d71e4 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,4 +1,4 @@
-Airflow 1.10.2, 2019-01-17
+Airflow 1.10.2, 2019-01-19
 --------------------------
 
 New features
@@ -34,6 +34,8 @@ New features
 - [AIRFLOW-3220] Add Instance Group Manager Operators for GCE (#4167)
 - [AIRFLOW-2882] Add import and export for pool cli using JSON
 - [AIRFLOW-2965] CLI tool to show the next execution datetime (#3834)
+- [AIRFLOW-2874] Enables FAB's theme support (#3719)
+- [AIRFLOW-3336] Add new TriggerRule for 0 upstream failures (#4182)
 
 Improvements
 """"""""""""
@@ -133,6 +135,13 @@ Improvements
 - [Airflow 2782] Upgrades Dagre D3 version to latest possible
 - [Airflow 2783] Implement eslint for JS code check (#3641)
 - [AIRFLOW-2805] Display multiple timezones on UI (#3687)
+- [AIRFLOW-3302] Small CSS fixes (#4140)
+- [Airflow-2766] Respect shared datetime across tabs
+- [AIRFLOW-2776] Compress tree view JSON
+- [AIRFLOW-2407] Use feature detection for reload() (#3298)
+- [AIRFLOW-3452] Removed an unused/dangerous display-none (#4295)
+- [AIRFLOW-3348] Update run statistics on dag refresh (#4197)
+- [AIRFLOW-3125] Monitor Task Instances creation rates (#3966)
 
 
 Bug fixes
@@ -205,6 +214,17 @@ Bug fixes
 - [AIRFLOW-3690] Fix bug to set state of a task for manually-triggered DAGs (#4504)
 - [AIRFLOW-3319] KubernetsExecutor: Need in try_number in labels if getting them later (#4163)
 - [AIRFLOW-3724] Fix the broken refresh button on Graph View in RBAC UI
+- [AIRFLOW-3732] Fix issue when trying to edit connection in RBAC UI
+- [AIRFLOW-2866] Fix missing CSRF token head when using RBAC UI (#3804)
+- [AIRFLOW-3259] Fix internal server error when displaying charts (#4114)
+- [AIRFLOW-3271] Fix issue with persistence of RBAC Permissions modified via UI (#4118)
+- [AIRFLOW-3141] Handle duration View for missing dag (#3984)
+- [AIRFLOW-2766] Respect shared datetime across tabs
+- [AIRFLOW-1413] Fix FTPSensor failing on error message with unexpected (#2450)
+- [AIRFLOW-3378] KubernetesPodOperator does not delete on timeout failure (#4218)
+- [AIRFLOW-3245] Fix list processing in resolve_template_files (#4086)
+- [AIRFLOW-2703] Catch transient DB exceptions from scheduler's heartbeat it does not crash (#3650)
+- [AIRFLOW-1298] Clear UPSTREAM_FAILED using the clean cli (#3886)
 
 Doc-only changes
 """"""""""""""""
@@ -236,6 +256,17 @@ Doc-only changes
 - [AIRFLOW-3696] Add Version info to Airflow Documentation (#4512)
 - [AIRFLOW-XXX] Correct Typo in sensor's exception (#4545)
 - [AIRFLOW-XXX] Fix a typo of config (#4544)
+- [AIRFLOW-XXX] Fix BashOperator Docstring (#4052)
+- [AIRFLOW-3018] Fix Minor issues in Documentation
+- [AIRFLOW-XXX] Fix Minor issues with Azure Cosmos Operator (#4289)
+- [AIRFLOW-3382] Fix incorrect docstring in DatastoreHook (#4222)
+- [AIRFLOW-XXX] Fix copy&paste mistake (#4212)
+- [AIRFLOW-3260] Correct misleading BigQuery error (#4098)
+- [AIRFLOW-XXX] Fix Typo in SFTPOperator docstring (#4016)
+- [AIRFLOW-XXX] Fixing the issue in Documentation (#3998)
+- [AIRFLOW-XXX] Fix undocumented params in S3_hook
+- [AIRFLOW-XXX] Fix SlackWebhookOperator execute method comment (#3963)
+- [AIRFLOW-3070] Refine web UI authentication-related docs (#3863)
 
 Airflow 1.10.1, 2018-11-13
 --------------------------

From 78ed4d04a29492050b7b4302c9fed85eb7938123 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <kamil.bregula@polidea.com>
Date: Fri, 25 Jan 2019 02:57:35 +0100
Subject: [PATCH 494/808] [AIRFLOW-XXX] Reduction of the number of warnings in
 the documentation (#4585)

---
 .../contrib/hooks/aws_glue_catalog_hook.py    |   2 +-
 airflow/contrib/hooks/cassandra_hook.py       |  15 +-
 airflow/contrib/hooks/ftp_hook.py             |   3 +-
 airflow/contrib/hooks/gcp_bigtable_hook.py    |   5 +-
 airflow/contrib/hooks/gcp_compute_hook.py     |   2 +-
 airflow/contrib/hooks/gcp_container_hook.py   |  17 +-
 airflow/contrib/hooks/gcp_mlengine_hook.py    |   2 +
 airflow/contrib/hooks/gcp_pubsub_hook.py      |   5 +-
 airflow/contrib/hooks/gcp_spanner_hook.py     |   7 +-
 airflow/contrib/hooks/gcs_hook.py             |   1 +
 airflow/contrib/hooks/mongo_hook.py           |   3 +-
 airflow/contrib/hooks/sftp_hook.py            |  16 +-
 airflow/contrib/hooks/spark_jdbc_hook.py      |   2 +-
 airflow/contrib/hooks/spark_sql_hook.py       |   2 +
 airflow/contrib/hooks/wasb_hook.py            |   2 +-
 airflow/contrib/operators/adls_to_gcs.py      |   3 +
 .../contrib/operators/bigquery_to_bigquery.py |   6 +-
 .../contrib/operators/databricks_operator.py  |   2 +
 airflow/contrib/operators/gcs_operator.py     |  28 +--
 airflow/contrib/operators/gcs_to_gcs.py       |  75 +++---
 .../operators/jenkins_job_trigger_operator.py |   8 +-
 .../contrib/operators/mlengine_operator.py    |  25 +-
 .../operators/qubole_check_operator.py        |   3 +-
 airflow/contrib/operators/sqoop_operator.py   |   2 +-
 .../operators/wasb_delete_blob_operator.py    |   2 +-
 airflow/contrib/sensors/python_sensor.py      |   4 +-
 airflow/contrib/sensors/weekday_sensor.py     |   2 +
 airflow/hooks/dbapi_hook.py                   |   2 +-
 airflow/hooks/http_hook.py                    |   9 +-
 airflow/hooks/mysql_hook.py                   |   2 +-
 airflow/hooks/oracle_hook.py                  |   8 +-
 airflow/models.py                             |  24 +-
 .../operators/s3_file_transform_operator.py   |   1 +
 airflow/task/task_runner/__init__.py          |   2 +-
 airflow/task/task_runner/base_task_runner.py  |   2 +-
 airflow/utils/dag_processing.py               |   2 +-
 docs/code.rst                                 |  59 +++--
 docs/conf.py                                  |  11 +-
 docs/howto/operator.rst                       |   4 -
 docs/howto/secure-connections.rst             |  12 +-
 docs/integration.rst                          | 236 +++++++++++-------
 docs/kubernetes.rst                           |   3 +
 docs/plugins.rst                              |   1 -
 docs/security.rst                             |   6 +-
 44 files changed, 384 insertions(+), 244 deletions(-)

diff --git a/airflow/contrib/hooks/aws_glue_catalog_hook.py b/airflow/contrib/hooks/aws_glue_catalog_hook.py
index 687f0fddb99c5..00501d3ddabc4 100644
--- a/airflow/contrib/hooks/aws_glue_catalog_hook.py
+++ b/airflow/contrib/hooks/aws_glue_catalog_hook.py
@@ -70,7 +70,7 @@ def get_partitions(self,
         :type max_items: int
         :return: set of partition values where each value is a tuple since
             a partition may be composed of multiple columns. For example:
-        {('2018-01-01','1'), ('2018-01-01','2')}
+            ``{('2018-01-01','1'), ('2018-01-01','2')}``
         """
         config = {
             'PageSize': page_size,
diff --git a/airflow/contrib/hooks/cassandra_hook.py b/airflow/contrib/hooks/cassandra_hook.py
index 0e0b47708d5a5..547e489130bf9 100644
--- a/airflow/contrib/hooks/cassandra_hook.py
+++ b/airflow/contrib/hooks/cassandra_hook.py
@@ -36,14 +36,17 @@ class CassandraHook(BaseHook, LoggingMixin):
     Port can be specified in the port field of the connection.
 
     If SSL is enabled in Cassandra, pass in a dict in the extra field as kwargs for
-    ``ssl.wrap_socket()``. For example:
-            {
-                'ssl_options' : {
-                    'ca_certs' : PATH_TO_CA_CERTS
-                }
+    ``ssl.wrap_socket()``. For example::
+
+        {
+            'ssl_options' : {
+                'ca_certs' : PATH_TO_CA_CERTS
             }
+        }
+
+    Default load balancing policy is RoundRobinPolicy. To specify a different
+    LB policy::
 
-    Default load balancing policy is RoundRobinPolicy. To specify a different LB policy:
         - DCAwareRoundRobinPolicy
             {
                 'load_balancing_policy': 'DCAwareRoundRobinPolicy',
diff --git a/airflow/contrib/hooks/ftp_hook.py b/airflow/contrib/hooks/ftp_hook.py
index 03849012a3d5b..d67ebf82bc4c6 100644
--- a/airflow/contrib/hooks/ftp_hook.py
+++ b/airflow/contrib/hooks/ftp_hook.py
@@ -173,7 +173,8 @@ def retrieve_file(
             [default: output_handle.write()]
         :type callback: callable
 
-        Example::
+        :Example::
+
             hook = FTPHook(ftp_conn_id='my_conn')
 
             remote_path = '/path/to/remote/file'
diff --git a/airflow/contrib/hooks/gcp_bigtable_hook.py b/airflow/contrib/hooks/gcp_bigtable_hook.py
index 81e1e017492ae..900cf1966dc07 100644
--- a/airflow/contrib/hooks/gcp_bigtable_hook.py
+++ b/airflow/contrib/hooks/gcp_bigtable_hook.py
@@ -173,7 +173,7 @@ def create_table(instance,
                      column_families=None):
         """
         Creates the specified Cloud Bigtable table.
-        Raises google.api_core.exceptions.AlreadyExists if the table exists.
+        Raises ``google.api_core.exceptions.AlreadyExists`` if the table exists.
 
         :type instance: Instance
         :param instance: The Cloud Bigtable instance that owns the table.
@@ -184,8 +184,7 @@ def create_table(instance,
             initially split the table.
         :type column_families: dict
         :param column_families: (Optional) A map of columns to create. The key is the
-            column_id str, and the
-        value is a GarbageCollectionRule.
+            column_id str, and the value is a ``GarbageCollectionRule``.
         """
         if column_families is None:
             column_families = {}
diff --git a/airflow/contrib/hooks/gcp_compute_hook.py b/airflow/contrib/hooks/gcp_compute_hook.py
index 7dd17d18b867c..02e0f56bf7697 100644
--- a/airflow/contrib/hooks/gcp_compute_hook.py
+++ b/airflow/contrib/hooks/gcp_compute_hook.py
@@ -271,7 +271,7 @@ def patch_instance_group_manager(self, zone, resource_id,
             Compute Engine Instance exists. If set to None or missing,
             the default project_id from the GCP connection is used.
         :type project_id: str
-        :return None
+        :return: None
         """
         response = self.get_conn().instanceGroupManagers().patch(
             project=project_id,
diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 4a610e56c9501..30096c14f4d7c 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -112,10 +112,11 @@ def _append_label(cluster_proto, key, val):
         """
         Append labels to provided Cluster Protobuf
 
-        Labels must fit the regex [a-z]([-a-z0-9]*[a-z0-9])? (current airflow version
-        string follows semantic versioning spec: x.y.z).
+        Labels must fit the regex ``[a-z]([-a-z0-9]*[a-z0-9])?`` (current
+         airflow version string follows semantic versioning spec: x.y.z).
 
-        :param cluster_proto: The proto to append resource_label airflow version to
+        :param cluster_proto: The proto to append resource_label airflow
+            version to
         :type cluster_proto: google.cloud.container_v1.types.Cluster
         :param key: The key label
         :type key: str
@@ -170,12 +171,14 @@ def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAUL
         Creates a cluster, consisting of the specified number and type of Google Compute
         Engine instances.
 
-        :param cluster: A Cluster protobuf or dict. If dict is provided, it must be of
-            the same form as the protobuf message google.cloud.container_v1.types.Cluster
+        :param cluster: A Cluster protobuf or dict. If dict is provided, it must
+            be of the same form as the protobuf message
+            ``google.cloud.container_v1.types.Cluster``
         :type cluster: dict or google.cloud.container_v1.types.Cluster
         :param project_id: Google Cloud Platform project ID
         :type project_id: str
-        :param retry: A retry object (google.api_core.retry.Retry) used to retry requests.
+        :param retry: A retry object (``google.api_core.retry.Retry``) used to
+            retry requests.
             If None is specified, requests will not be retried.
         :type retry: google.api_core.retry.Retry
         :param timeout: The amount of time, in seconds, to wait for the request to
@@ -183,7 +186,7 @@ def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAUL
             individual attempt.
         :type timeout: float
         :return: The full url to the new, or existing, cluster
-        :raises
+        :raises:
             ParseError: On JSON parsing problems when trying to convert dict
             AirflowException: cluster is not dict type nor Cluster proto type
         """
diff --git a/airflow/contrib/hooks/gcp_mlengine_hook.py b/airflow/contrib/hooks/gcp_mlengine_hook.py
index 039f29e8fb7a1..c67b91ea9b38a 100644
--- a/airflow/contrib/hooks/gcp_mlengine_hook.py
+++ b/airflow/contrib/hooks/gcp_mlengine_hook.py
@@ -67,6 +67,7 @@ def create_job(self, project_id, job, use_existing_job_fn=None):
 
         :param job: MLEngine Job object that should be provided to the MLEngine
             API, such as: ::
+
                 {
                   'jobId': 'my_job_id',
                   'trainingInput': {
@@ -74,6 +75,7 @@ def create_job(self, project_id, job, use_existing_job_fn=None):
                     ...
                   }
                 }
+
         :type job: dict
 
         :param use_existing_job_fn: In case that a MLEngine job with the same
diff --git a/airflow/contrib/hooks/gcp_pubsub_hook.py b/airflow/contrib/hooks/gcp_pubsub_hook.py
index b160e9634719f..9b296a5013252 100644
--- a/airflow/contrib/hooks/gcp_pubsub_hook.py
+++ b/airflow/contrib/hooks/gcp_pubsub_hook.py
@@ -239,11 +239,10 @@ def pull(self, project, subscription, max_messages,
             return if no messages are available. Otherwise, the request will
             block for an undisclosed, but bounded period of time
         :type return_immediately: bool
-        :return A list of Pub/Sub ReceivedMessage objects each containing
+        :return: A list of Pub/Sub ReceivedMessage objects each containing
             an ``ackId`` property and a ``message`` property, which includes
             the base64-encoded message content. See
-            https://cloud.google.com/pubsub/docs/reference/rest/v1/\
-                projects.subscriptions/pull#ReceivedMessage
+            https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.subscriptions/pull#ReceivedMessage
         """
         service = self.get_conn()
         full_subscription = _format_subscription(project, subscription)
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index e1ee216b62de2..8b7b9aa413c92 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -163,13 +163,14 @@ def delete_instance(self, instance_id, project_id=None):
         """
         Deletes an existing Cloud Spanner instance.
 
-        :param instance_id:  The ID of the Cloud Spanner instance.
+        :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
-        :param project_id: Optional, the ID of the  GCP project that owns the Cloud Spanner
+        :param project_id: Optional, the ID of the GCP project that owns the Cloud Spanner
             database. If set to None or missing, the default project_id from the GCP connection is used.
         :type project_id: str
-        :return None
+        :return: None
         """
+
         instance = self._get_client(project_id=project_id).instance(instance_id)
         try:
             instance.delete()
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index c6c1bf11b8981..018bf5f924269 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -500,6 +500,7 @@ def create_bucket(self,
             - ``STANDARD``
             - ``NEARLINE``
             - ``COLDLINE``.
+
             If this value is not specified when the bucket is
             created, it will default to STANDARD.
         :type storage_class: string
diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index 3561aa34ffe08..d6ad2625334e9 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -29,8 +29,7 @@ class MongoHook(BaseHook):
     https://docs.mongodb.com/manual/reference/connection-string/index.html
     You can specify connection string options in extra field of your connection
     https://docs.mongodb.com/manual/reference/connection-string/index.html#connection-string-options
-    ex.
-        {replicaSet: test, ssl: True, connectTimeoutMS: 30000}
+    ex. ``{replicaSet: test, ssl: True, connectTimeoutMS: 30000}``
     """
     conn_type = 'mongo'
 
diff --git a/airflow/contrib/hooks/sftp_hook.py b/airflow/contrib/hooks/sftp_hook.py
index c23bd3012ba32..a6a59920f2b0b 100644
--- a/airflow/contrib/hooks/sftp_hook.py
+++ b/airflow/contrib/hooks/sftp_hook.py
@@ -31,13 +31,15 @@ class SFTPHook(SSHHook):
 
     Interact with SFTP. Aims to be interchangeable with FTPHook.
 
-    Pitfalls: - In contrast with FTPHook describe_directory only returns size, type and
-                modify. It doesn't return unix.owner, unix.mode, perm, unix.group and
-                unique.
-              - retrieve_file and store_file only take a local full path and not a
-                buffer.
-              - If no mode is passed to create_directory it will be created with 777
-                permissions.
+    :Pitfalls::
+
+        - In contrast with FTPHook describe_directory only returns size, type and
+          modify. It doesn't return unix.owner, unix.mode, perm, unix.group and
+          unique.
+        - retrieve_file and store_file only take a local full path and not a
+           buffer.
+        - If no mode is passed to create_directory it will be created with 777
+          permissions.
 
     Errors that may occur throughout but should be handled downstream.
     """
diff --git a/airflow/contrib/hooks/spark_jdbc_hook.py b/airflow/contrib/hooks/spark_jdbc_hook.py
index b55e4ef060419..c188b1e863de2 100644
--- a/airflow/contrib/hooks/spark_jdbc_hook.py
+++ b/airflow/contrib/hooks/spark_jdbc_hook.py
@@ -62,7 +62,7 @@ class SparkJDBCHook(SparkSubmitHook):
     :param jdbc_table: The name of the JDBC table
     :type jdbc_table: str
     :param jdbc_conn_id: Connection id used for connection to JDBC database
-    :type: jdbc_conn_id: str
+    :type jdbc_conn_id: str
     :param jdbc_driver: Name of the JDBC driver to use for the JDBC connection. This
                         driver (usually a jar) should be passed in the 'jars' parameter
     :type jdbc_driver: str
diff --git a/airflow/contrib/hooks/spark_sql_hook.py b/airflow/contrib/hooks/spark_sql_hook.py
index c1fd2ce21c89f..25c0bc53c5576 100644
--- a/airflow/contrib/hooks/spark_sql_hook.py
+++ b/airflow/contrib/hooks/spark_sql_hook.py
@@ -27,6 +27,7 @@ class SparkSqlHook(BaseHook):
     """
     This hook is a wrapper around the spark-sql binary. It requires that the
     "spark-sql" binary is in the PATH.
+
     :param sql: The SQL query to execute
     :type sql: str
     :param conf: arbitrary Spark configuration property
@@ -91,6 +92,7 @@ def _prepare_command(self, cmd):
         """
         Construct the spark-sql command to execute. Verbose output is enabled
         as default.
+
         :param cmd: command to append to the spark-sql command
         :type cmd: str
         :return: full command to be executed
diff --git a/airflow/contrib/hooks/wasb_hook.py b/airflow/contrib/hooks/wasb_hook.py
index 8e9fb7ed9b766..d3a766cf69de7 100644
--- a/airflow/contrib/hooks/wasb_hook.py
+++ b/airflow/contrib/hooks/wasb_hook.py
@@ -162,7 +162,7 @@ def delete_file(self, container_name, blob_name, is_prefix=False,
         :param is_prefix: If blob_name is a prefix, delete all matching files
         :type is_prefix: bool
         :param ignore_if_missing: if True, then return success even if the
-        blob does not exist.
+            blob does not exist.
         :type ignore_if_missing: bool
         :param kwargs: Optional keyword arguments that
             `BlockBlobService.create_blob_from_path()` takes.
diff --git a/airflow/contrib/operators/adls_to_gcs.py b/airflow/contrib/operators/adls_to_gcs.py
index affbd456260ff..5d99251d3f6d2 100644
--- a/airflow/contrib/operators/adls_to_gcs.py
+++ b/airflow/contrib/operators/adls_to_gcs.py
@@ -52,6 +52,7 @@ class AdlsToGoogleCloudStorageOperator(AzureDataLakeStorageListOperator):
         The following Operator would copy a single file named
         ``hello/world.avro`` from ADLS to the GCS bucket ``mybucket``. Its full
         resulting gcs path will be ``gs://mybucket/hello/world.avro`` ::
+
             copy_single_file = AdlsToGoogleCloudStorageOperator(
                 task_id='copy_single_file',
                 src_adls='hello/world.avro',
@@ -63,6 +64,7 @@ class AdlsToGoogleCloudStorageOperator(AzureDataLakeStorageListOperator):
 
         The following Operator would copy all parquet files from ADLS
         to the GCS bucket ``mybucket``. ::
+
             copy_all_files = AdlsToGoogleCloudStorageOperator(
                 task_id='copy_all_files',
                 src_adls='*.parquet',
@@ -74,6 +76,7 @@ class AdlsToGoogleCloudStorageOperator(AzureDataLakeStorageListOperator):
 
          The following Operator would copy all parquet files from ADLS
          path ``/hello/world``to the GCS bucket ``mybucket``. ::
+
             copy_world_files = AdlsToGoogleCloudStorageOperator(
                 task_id='copy_world_files',
                 src_adls='hello/world/*.parquet',
diff --git a/airflow/contrib/operators/bigquery_to_bigquery.py b/airflow/contrib/operators/bigquery_to_bigquery.py
index 3a0b44db60580..be1dfea2a9c3b 100644
--- a/airflow/contrib/operators/bigquery_to_bigquery.py
+++ b/airflow/contrib/operators/bigquery_to_bigquery.py
@@ -31,13 +31,13 @@ class BigQueryToBigQueryOperator(BaseOperator):
         https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.copy
 
     :param source_project_dataset_tables: One or more
-        dotted (project:|project.)<dataset>.<table> BigQuery tables to use as the
-        source data. If <project> is not included, project will be the
+        dotted ``(project:|project.)<dataset>.<table>`` BigQuery tables to use as the
+        source data. If ``<project>`` is not included, project will be the
         project defined in the connection json. Use a list if there are multiple
         source tables. (templated)
     :type source_project_dataset_tables: list|string
     :param destination_project_dataset_table: The destination BigQuery
-        table. Format is: (project:|project.)<dataset>.<table> (templated)
+        table. Format is: ``(project:|project.)<dataset>.<table>`` (templated)
     :type destination_project_dataset_table: string
     :param write_disposition: The write disposition if the table already exists.
     :type write_disposition: string
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 50998318d9022..140cac5ffbe90 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -104,6 +104,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
     to call the ``api/2.0/jobs/runs/submit`` endpoint and pass it directly
     to our ``DatabricksSubmitRunOperator`` through the ``json`` parameter.
     For example ::
+
         json = {
           'new_cluster': {
             'spark_version': '2.1.0-db3-scala2.11',
@@ -119,6 +120,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
     of the ``DatabricksSubmitRunOperator`` directly. Note that there is exactly
     one named parameter for each top level parameter in the ``runs/submit``
     endpoint. In this method, your code would look like this: ::
+
         new_cluster = {
           'spark_version': '2.1.0-db3-scala2.11',
           'num_workers': 2
diff --git a/airflow/contrib/operators/gcs_operator.py b/airflow/contrib/operators/gcs_operator.py
index ef5e8de5043f3..60b664853b309 100644
--- a/airflow/contrib/operators/gcs_operator.py
+++ b/airflow/contrib/operators/gcs_operator.py
@@ -42,6 +42,7 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
             - ``STANDARD``
             - ``NEARLINE``
             - ``COLDLINE``.
+
             If this value is not specified when the bucket is
             created, it will default to STANDARD.
     :type storage_class: string
@@ -49,8 +50,7 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
         Object data for objects in the bucket resides in physical storage
         within this region. Defaults to US.
 
-        .. seealso::
-            https://developers.google.com/storage/docs/bucket-locations
+        .. seealso:: https://developers.google.com/storage/docs/bucket-locations
 
     :type location: string
     :param project_id: The ID of the GCP Project. (templated)
@@ -65,18 +65,18 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
         have domain-wide delegation enabled.
     :type delegate_to: string
 
-    **Example**:
-        The following Operator would create a new bucket ``test-bucket``
-        with ``MULTI_REGIONAL`` storage class in ``EU`` region ::
-
-            CreateBucket = GoogleCloudStorageCreateBucketOperator(
-                task_id='CreateNewBucket',
-                bucket_name='test-bucket',
-                storage_class='MULTI_REGIONAL',
-                location='EU',
-                labels={'env': 'dev', 'team': 'airflow'},
-                google_cloud_storage_conn_id='airflow-service-account'
-            )
+    :Example::
+    The following Operator would create a new bucket ``test-bucket``
+    with ``MULTI_REGIONAL`` storage class in ``EU`` region ::
+
+        CreateBucket = GoogleCloudStorageCreateBucketOperator(
+            task_id='CreateNewBucket',
+            bucket_name='test-bucket',
+            storage_class='MULTI_REGIONAL',
+            location='EU',
+            labels={'env': 'dev', 'team': 'airflow'},
+            google_cloud_storage_conn_id='airflow-service-account'
+        )
     """
 
     template_fields = ('bucket_name', 'storage_class',
diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index 523240c9090c4..016913ab10c61 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -63,43 +63,48 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
         domain-wide delegation enabled.
     :type delegate_to: string
 
-    **Examples**:
-        The following Operator would copy a single file named
-        ``sales/sales-2017/january.avro`` in the ``data`` bucket to the file named
-        ``copied_sales/2017/january-backup.avro` in the ``data_backup`` bucket ::
-            copy_single_file = GoogleCloudStorageToGoogleCloudStorageOperator(
-                task_id='copy_single_file',
-                source_bucket='data',
-                source_object='sales/sales-2017/january.avro',
-                destination_bucket='data_backup',
-                destination_object='copied_sales/2017/january-backup.avro',
-                google_cloud_storage_conn_id=google_cloud_conn_id
-            )
+    :Example:
 
-        The following Operator would copy all the Avro files from ``sales/sales-2017``
-        folder (i.e. with names starting with that prefix) in ``data`` bucket to the
-        ``copied_sales/2017`` folder in the ``data_backup`` bucket. ::
-            copy_files = GoogleCloudStorageToGoogleCloudStorageOperator(
-                task_id='copy_files',
-                source_bucket='data',
-                source_object='sales/sales-2017/*.avro',
-                destination_bucket='data_backup',
-                destination_object='copied_sales/2017/',
-                google_cloud_storage_conn_id=google_cloud_conn_id
-            )
+    The following Operator would copy a single file named
+    ``sales/sales-2017/january.avro`` in the ``data`` bucket to the file named
+    ``copied_sales/2017/january-backup.avro`` in the ``data_backup`` bucket ::
+
+        copy_single_file = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id='copy_single_file',
+            source_bucket='data',
+            source_object='sales/sales-2017/january.avro',
+            destination_bucket='data_backup',
+            destination_object='copied_sales/2017/january-backup.avro',
+            google_cloud_storage_conn_id=google_cloud_conn_id
+        )
+
+    The following Operator would copy all the Avro files from ``sales/sales-2017``
+    folder (i.e. with names starting with that prefix) in ``data`` bucket to the
+    ``copied_sales/2017`` folder in the ``data_backup`` bucket. ::
+
+        copy_files = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id='copy_files',
+            source_bucket='data',
+            source_object='sales/sales-2017/*.avro',
+            destination_bucket='data_backup',
+            destination_object='copied_sales/2017/',
+            google_cloud_storage_conn_id=google_cloud_conn_id
+        )
+
+    The following Operator would move all the Avro files from ``sales/sales-2017``
+    folder (i.e. with names starting with that prefix) in ``data`` bucket to the
+    same folder in the ``data_backup`` bucket, deleting the original files in the
+    process. ::
+
+        move_files = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id='move_files',
+            source_bucket='data',
+            source_object='sales/sales-2017/*.avro',
+            destination_bucket='data_backup',
+            move_object=True,
+            google_cloud_storage_conn_id=google_cloud_conn_id
+        )
 
-        The following Operator would move all the Avro files from ``sales/sales-2017``
-        folder (i.e. with names starting with that prefix) in ``data`` bucket to the
-        same folder in the ``data_backup`` bucket, deleting the original files in the
-        process. ::
-            move_files = GoogleCloudStorageToGoogleCloudStorageOperator(
-                task_id='move_files',
-                source_bucket='data',
-                source_object='sales/sales-2017/*.avro',
-                destination_bucket='data_backup',
-                move_object=True,
-                google_cloud_storage_conn_id=google_cloud_conn_id
-            )
     """
     template_fields = ('source_bucket', 'source_object', 'destination_bucket',
                        'destination_object',)
diff --git a/airflow/contrib/operators/jenkins_job_trigger_operator.py b/airflow/contrib/operators/jenkins_job_trigger_operator.py
index 37185f3e13f42..36e699b05bacb 100644
--- a/airflow/contrib/operators/jenkins_job_trigger_operator.py
+++ b/airflow/contrib/operators/jenkins_job_trigger_operator.py
@@ -43,6 +43,7 @@ def jenkins_request_with_headers(jenkins_server, req, add_crumb=True):
     to get the location from them
     This function is just a copy of the one present in python-jenkins library
     with just the return call changed
+
     :param jenkins_server: The server to query
     :param req: The request to execute
     :param add_crumb: Boolean to indicate if it should add crumb to the request
@@ -94,6 +95,7 @@ class JenkinsJobTriggerOperator(BaseOperator):
     This operator depend on python-jenkins library,
     version >= 0.4.15 to communicate with jenkins server.
     You'll also need to configure a Jenkins connection in the connections screen.
+
     :param jenkins_connection_id: The jenkins connection to use for this job
     :type jenkins_connection_id: string
     :param job_name: The name of the job to trigger
@@ -101,7 +103,7 @@ class JenkinsJobTriggerOperator(BaseOperator):
     :param parameters: The parameters block to provide to jenkins. (templated)
     :type parameters: string
     :param sleep_time: How long will the operator sleep between each status
-    request for the job (min 1, default 10)
+        request for the job (min 1, default 10)
     :type sleep_time: int
     :param max_try_before_job_appears: The maximum number of requests to make
         while waiting for the job to appears on jenkins server (default 10)
@@ -135,9 +137,10 @@ def build_job(self, jenkins_server):
         It returned a dict with 2 keys : body and headers.
         headers contains also a dict-like object which can be queried to get
         the location to poll in the queue.
+
         :param jenkins_server: The jenkins server where the job should be triggered
         :return: Dict containing the response body (key body)
-        and the headers coming along (headers)
+            and the headers coming along (headers)
         """
         # Warning if the parameter is too long, the URL can be longer than
         # the maximum allowed size
@@ -163,6 +166,7 @@ def poll_job_in_queue(self, location, jenkins_server):
         returned by the build_job call and poll this file.
         When a 'executable' block appears in the json, it means the job execution started
         and the field 'number' then contains the build number.
+
         :param location: Location to poll, returned in the header of the build_job call
         :param jenkins_server: The jenkins server to poll
         :return: The build_number corresponding to the triggered job
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index b6af554606dc0..40a675ca3b46d 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -68,17 +68,16 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     NOTE: For model origin, users should consider exactly one from the
     three options below:
-    1. Populate 'uri' field only, which should be a GCS location that
-    points to a tensorflow savedModel directory.
-    2. Populate 'model_name' field only, which refers to an existing
-    model, and the default version of the model will be used.
-    3. Populate both 'model_name' and 'version_name' fields, which
-    refers to a specific version of a specific model.
 
-    In options 2 and 3, both model and version name should contain the
-    minimal identifier. For instance, call
+    1. Populate ``uri`` field only, which should be a GCS location that
+       points to a tensorflow savedModel directory.
+    2. Populate ``model_name`` field only, which refers to an existing
+       model, and the default version of the model will be used.
+    3. Populate both ``model_name`` and ``version_name`` fields, which
+       refers to a specific version of a specific model.
 
-    ::
+    In options 2 and 3, both model and version name should contain the
+    minimal identifier. For instance, call::
 
         MLEngineBatchPredictionOperator(
             ...,
@@ -87,7 +86,7 @@ class MLEngineBatchPredictionOperator(BaseOperator):
             ...)
 
     if the desired model version is
-    "projects/my_project/models/my_model/versions/my_version".
+    ``projects/my_project/models/my_model/versions/my_version``.
 
     See https://cloud.google.com/ml-engine/reference/rest/v1/projects.jobs
     for further documentation on the parameters.
@@ -106,7 +105,7 @@ class MLEngineBatchPredictionOperator(BaseOperator):
     :type data_format: string
 
     :param input_paths: A list of GCS paths of input data for batch
-        prediction. Accepting wildcard operator *, but only at the end. (templated)
+        prediction. Accepting wildcard operator ``*``, but only at the end. (templated)
     :type input_paths: list of string
 
     :param output_path: The GCS path where the prediction results are
@@ -151,8 +150,8 @@ class MLEngineBatchPredictionOperator(BaseOperator):
         have doamin-wide delegation enabled.
     :type delegate_to: string
 
-    Raises:
-        ``ValueError``: if a unique model/version origin cannot be determined.
+    :raises: ``ValueError``: if a unique model/version origin cannot be
+        determined.
     """
 
     template_fields = [
diff --git a/airflow/contrib/operators/qubole_check_operator.py b/airflow/contrib/operators/qubole_check_operator.py
index 235af08ca753e..3745eddd7936d 100644
--- a/airflow/contrib/operators/qubole_check_operator.py
+++ b/airflow/contrib/operators/qubole_check_operator.py
@@ -69,7 +69,8 @@ class QuboleCheckOperator(CheckOperator, QuboleOperator):
             which the checks have to be performed.
 
     .. note:: All fields in common with template fields of
-            QuboleOperator and CheckOperator are template-supported.
+        QuboleOperator and CheckOperator are template-supported.
+
     """
 
     template_fields = QuboleOperator.template_fields + CheckOperator.template_fields
diff --git a/airflow/contrib/operators/sqoop_operator.py b/airflow/contrib/operators/sqoop_operator.py
index fa61ca14cac45..c7ebcf4b3a2d4 100644
--- a/airflow/contrib/operators/sqoop_operator.py
+++ b/airflow/contrib/operators/sqoop_operator.py
@@ -34,7 +34,7 @@ class SqoopOperator(BaseOperator):
     """
     Execute a Sqoop job.
     Documentation for Apache Sqoop can be found here:
-        https://sqoop.apache.org/docs/1.4.2/SqoopUserGuide.html.
+    https://sqoop.apache.org/docs/1.4.2/SqoopUserGuide.html
     """
     template_fields = ('conn_id', 'cmd_type', 'table', 'query', 'target_dir',
                        'file_type', 'columns', 'split_by',
diff --git a/airflow/contrib/operators/wasb_delete_blob_operator.py b/airflow/contrib/operators/wasb_delete_blob_operator.py
index 4634741d8b824..4173d7e7a8a5d 100644
--- a/airflow/contrib/operators/wasb_delete_blob_operator.py
+++ b/airflow/contrib/operators/wasb_delete_blob_operator.py
@@ -37,7 +37,7 @@ class WasbDeleteBlobOperator(BaseOperator):
     :param is_prefix: If blob_name is a prefix, delete all files matching prefix.
     :type is_prefix: bool
     :param ignore_if_missing: if True, then return success even if the
-    blob does not exist.
+        blob does not exist.
     :type ignore_if_missing: bool
     """
 
diff --git a/airflow/contrib/sensors/python_sensor.py b/airflow/contrib/sensors/python_sensor.py
index 68bc7497eaf41..ecdc7e6c8ea40 100644
--- a/airflow/contrib/sensors/python_sensor.py
+++ b/airflow/contrib/sensors/python_sensor.py
@@ -26,8 +26,8 @@ class PythonSensor(BaseSensorOperator):
     Waits for a Python callable to return True.
 
     User could put input argument in templates_dict
-        e.g templates_dict = {'start_ds': 1970}
-    and access the argument by calling `kwargs['templates_dict']['start_ds']`
+    e.g ``templates_dict = {'start_ds': 1970}``
+    and access the argument by calling ``kwargs['templates_dict']['start_ds']``
     in the the callable
 
     :param python_callable: A reference to an object that is callable
diff --git a/airflow/contrib/sensors/weekday_sensor.py b/airflow/contrib/sensors/weekday_sensor.py
index 1a7a702aef97c..e0357c5b2f496 100644
--- a/airflow/contrib/sensors/weekday_sensor.py
+++ b/airflow/contrib/sensors/weekday_sensor.py
@@ -60,10 +60,12 @@ class DayOfWeekSensor(BaseSensorOperator):
     :param week_day: Day of the week to check (full name). Optionally, a set
         of days can also be provided using a set.
         Example values:
+
             * ``"MONDAY"``,
             * ``{"Saturday", "Sunday"}``
             * ``{WeekDay.TUESDAY}``
             * ``{WeekDay.SATURDAY, WeekDay.SUNDAY}``
+
     :type week_day: set or str or WeekDay
     :param use_task_execution_day: If ``True``, uses task's execution day to compare
         with week_day. Execution Date is Useful for backfilling.
diff --git a/airflow/hooks/dbapi_hook.py b/airflow/hooks/dbapi_hook.py
index 5b50ade34e486..71c2f95d8bf79 100644
--- a/airflow/hooks/dbapi_hook.py
+++ b/airflow/hooks/dbapi_hook.py
@@ -194,7 +194,7 @@ def get_autocommit(self, conn):
         :param conn: Connection to get autocommit setting from.
         :type conn: connection object.
         :return: connection autocommit setting.
-        :rtype bool.
+        :rtype: bool
         """
 
         return getattr(conn, 'autocommit', False) and self.supports_autocommit
diff --git a/airflow/hooks/http_hook.py b/airflow/hooks/http_hook.py
index 1e0c7b3058147..200a6741f2cae 100644
--- a/airflow/hooks/http_hook.py
+++ b/airflow/hooks/http_hook.py
@@ -29,6 +29,7 @@
 class HttpHook(BaseHook):
     """
     Interact with HTTP servers.
+
     :param http_conn_id: connection that has the base API url i.e https://www.google.com/
         and optional authentication credentials. Default headers can also be specified in
         the Extra field in json format.
@@ -52,6 +53,7 @@ def __init__(
     def get_conn(self, headers=None):
         """
         Returns http session for use with requests
+
         :param headers: additional headers to be passed through as a dictionary
         :type headers: dict
         """
@@ -83,6 +85,7 @@ def get_conn(self, headers=None):
     def run(self, endpoint, data=None, headers=None, extra_options=None):
         """
         Performs the request
+
         :param endpoint: the endpoint to be called i.e. resource/v1/query?
         :type endpoint: str
         :param data: payload to be uploaded or request parameters
@@ -130,6 +133,7 @@ def check_response(self, response):
         """
         Checks the status code and raise an AirflowException exception on non 2XX or 3XX
         status codes
+
         :param response: A requests response object
         :type response: requests.response
         """
@@ -145,6 +149,7 @@ def run_and_check(self, session, prepped_request, extra_options):
         """
         Grabs extra options like timeout and actually runs the request,
         checking for the result
+
         :param session: the session to be used to execute the request
         :type session: requests.Session
         :param prepped_request: the prepared request generated in run()
@@ -179,12 +184,14 @@ def run_with_advanced_retry(self, _retry_args, *args, **kwargs):
         Runs Hook.run() with a Tenacity decorator attached to it. This is useful for
         connectors which might be disturbed by intermittent issues and should not
         instantly fail.
+
         :param _retry_args: Arguments which define the retry behaviour.
             See Tenacity documentation at https://github.com/jd/tenacity
         :type _retry_args: dict
 
 
-        Example: ::
+        :Example::
+
             hook = HttpHook(http_conn_id='my_conn',method='GET')
             retry_args = dict(
                  wait=tenacity.wait_exponential(),
diff --git a/airflow/hooks/mysql_hook.py b/airflow/hooks/mysql_hook.py
index 4e65fdf3a3cf5..8d7475df66625 100644
--- a/airflow/hooks/mysql_hook.py
+++ b/airflow/hooks/mysql_hook.py
@@ -54,7 +54,7 @@ def get_autocommit(self, conn):
         :param conn: connection to get autocommit setting from.
         :type conn: connection object.
         :return: connection autocommit setting
-        :rtype bool
+        :rtype: bool
         """
         return conn.get_autocommit()
 
diff --git a/airflow/hooks/oracle_hook.py b/airflow/hooks/oracle_hook.py
index 39e447d010793..ae6aa0f039cf6 100644
--- a/airflow/hooks/oracle_hook.py
+++ b/airflow/hooks/oracle_hook.py
@@ -46,6 +46,7 @@ def get_conn(self):
         :param dsn: the host address for the Oracle server
         :param service_name: the db_unique_name of the database
               that you are connecting to (CONNECT_DATA part of TNS)
+
         You can set these parameters in the extra fields of your connection
         as in ``{ "dsn":"some.host.address" , "service_name":"some.service.name" }``
         """
@@ -74,9 +75,10 @@ def insert_rows(self, table, rows, target_fields=None, commit_every=1000):
         A generic way to insert a set of tuples into a table,
         the whole set of inserts is treated as one transaction
         Changes from standard DbApiHook implementation:
-        - Oracle SQL queries in cx_Oracle can not be terminated with a semicolon (';')
-        - Replace NaN values with NULL using numpy.nan_to_num (not using is_nan()
-          because of input types error for strings)
+
+        - Oracle SQL queries in cx_Oracle can not be terminated with a semicolon (`;`)
+        - Replace NaN values with NULL using `numpy.nan_to_num` (not using
+          `is_nan()` because of input types error for strings)
         - Coerce datetime cells to Oracle DATETIME format during insert
         """
         if target_fields:
diff --git a/airflow/models.py b/airflow/models.py
index c866ef668bba6..aae1406cd3857 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -451,9 +451,9 @@ def kill_zombies(self, zombies, session=None):
         had a heartbeat for too long, in the current DagBag.
 
         :param zombies: zombie task instances to kill.
-        :type zombies: SimpleTaskInstance
+        :type zombies: ``SimpleTaskInstance``
         :param session: DB session.
-        :type Session.
+        :type session: Session
         """
         for zombie in zombies:
             if zombie.dag_id in self.dags:
@@ -3721,8 +3721,10 @@ def handle_callback(self, dagrun, success=True, reason=None, session=None):
         on_failure_callback or on_success_callback. This method gets the context of a
         single TaskInstance part of this DagRun and passes that to the callable along
         with a 'reason', primarily to differentiate DagRun failures.
-        .. note::
-            The logs end up in $AIRFLOW_HOME/logs/scheduler/latest/PROJECT/DAG_FILE.py.log
+
+        .. note: The logs end up in
+            ``$AIRFLOW_HOME/logs/scheduler/latest/PROJECT/DAG_FILE.py.log``
+
         :param dagrun: DagRun object
         :param success: Flag to specify if failure or success callback should be called
         :param reason: Completion reason
@@ -4632,10 +4634,10 @@ def setdefault(cls, key, default, deserialize_json=False):
         :param key: Dict key for this Variable
         :type key: String
         :param default: Default value to set and return if the variable
-        isn't already in the DB
+            isn't already in the DB
         :type default: Mixed
         :param deserialize_json: Store this as a JSON encoded value in the DB
-         and un-encode it when retrieving a value
+            and un-encode it when retrieving a value
         :return: Mixed
         """
         default_sentinel = object()
@@ -4738,6 +4740,7 @@ def set(
         Store an XCom value.
         TODO: "pickling" has been deprecated and JSON is preferred.
               "pickling" will be removed in Airflow 2.0.
+
         :return: None
         """
         session.expunge_all()
@@ -4787,7 +4790,8 @@ def get_one(cls,
         """
         Retrieve an XCom value, optionally meeting certain criteria.
         TODO: "pickling" has been deprecated and JSON is preferred.
-              "pickling" will be removed in Airflow 2.0.
+        "pickling" will be removed in Airflow 2.0.
+
         :return: XCom value
         """
         filters = []
@@ -4835,7 +4839,7 @@ def get_many(cls,
         """
         Retrieve an XCom value, optionally meeting certain criteria
         TODO: "pickling" has been deprecated and JSON is preferred.
-              "pickling" will be removed in Airflow 2.0.
+        "pickling" will be removed in Airflow 2.0.
         """
         filters = []
         if key:
@@ -5086,7 +5090,7 @@ def find(dag_id=None, run_id=None, execution_date=None,
         :param external_trigger: whether this dag run is externally triggered
         :type external_trigger: bool
         :param no_backfills: return no backfills (True), return all (False).
-        Defaults to False
+            Defaults to False
         :type no_backfills: bool
         :param session: database session
         :type session: Session
@@ -5343,7 +5347,7 @@ def get_run(session, dag_id, execution_date):
         :param execution_date: execution date
         :type execution_date: datetime
         :return: DagRun corresponding to the given dag_id and execution date
-        if one exists. None otherwise.
+            if one exists. None otherwise.
         :rtype: DagRun
         """
         qry = session.query(DagRun).filter(
diff --git a/airflow/operators/s3_file_transform_operator.py b/airflow/operators/s3_file_transform_operator.py
index 4a0b3ad2ee32c..abe96c780c2d3 100644
--- a/airflow/operators/s3_file_transform_operator.py
+++ b/airflow/operators/s3_file_transform_operator.py
@@ -58,6 +58,7 @@ class S3FileTransformOperator(BaseOperator):
         - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
              You can specify this argument if you want to use a different
              CA cert bundle than the one used by botocore.
+
         This is also applicable to ``dest_verify``.
     :type source_verify: bool or str
     :param dest_s3_key: The key to be written from S3. (templated)
diff --git a/airflow/task/task_runner/__init__.py b/airflow/task/task_runner/__init__.py
index 0edc020d41e3d..8766c17d13a08 100644
--- a/airflow/task/task_runner/__init__.py
+++ b/airflow/task/task_runner/__init__.py
@@ -29,7 +29,7 @@ def get_task_runner(local_task_job):
     Get the task runner that can be used to run the given job.
 
     :param local_task_job: The LocalTaskJob associated with the TaskInstance
-    that needs to be executed.
+        that needs to be executed.
     :type local_task_job: airflow.jobs.LocalTaskJob
     :return: The task runner to use to run the task.
     :rtype: airflow.task.task_runner.base_task_runner.BaseTaskRunner
diff --git a/airflow/task/task_runner/base_task_runner.py b/airflow/task/task_runner/base_task_runner.py
index 646182ace04e1..4a1c4742d1fa2 100644
--- a/airflow/task/task_runner/base_task_runner.py
+++ b/airflow/task/task_runner/base_task_runner.py
@@ -145,7 +145,7 @@ def return_code(self):
         """
         :return: The return code associated with running the task instance or
         None if the task is not yet done.
-        :rtype int:
+        :rtype: int
         """
         raise NotImplementedError()
 
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index a9bcdeb0eb5d1..6adec68e15b3d 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -225,7 +225,7 @@ def list_py_file_paths(directory, safe_mode=True,
     :param directory: the directory to traverse
     :type directory: unicode
     :param safe_mode: whether to use a heuristic to determine whether a file
-    contains Airflow DAG definitions
+        contains Airflow DAG definitions
     :return: a list of paths to Python files in the specified directory
     :rtype: list[unicode]
     """
diff --git a/docs/code.rst b/docs/code.rst
index a9bde6558ac4f..22fe6c043d25a 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -135,13 +135,13 @@ Operators
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
 .. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
+.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
+.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
 .. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
@@ -149,20 +149,20 @@ Operators
 .. autoclass:: airflow.contrib.operators.cassandra_to_gcs.CassandraToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
+.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateBaseOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
 .. autoclass:: airflow.contrib.operators.datastore_export_operator.DatastoreExportOperator
 .. autoclass:: airflow.contrib.operators.datastore_import_operator.DatastoreImportOperator
 .. autoclass:: airflow.contrib.operators.discord_webhook_operator.DiscordWebhookOperator
@@ -173,9 +173,40 @@ Operators
 .. autoclass:: airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator
 .. autoclass:: airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
+.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
+.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlBaseOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
+.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
+.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
 .. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
@@ -191,18 +222,18 @@ Operators
 .. autoclass:: airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineBatchPredictionOperator
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineModelOperator
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator
+.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator
 .. autoclass:: airflow.contrib.operators.mongo_to_s3.MongoToS3Operator
 .. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.oracle_to_azure_data_lake_transfer.OracleToAzureDataLakeTransfer
 .. autoclass:: airflow.contrib.operators.oracle_to_oracle_transfer.OracleToOracleTransfer
 .. autoclass:: airflow.contrib.operators.postgres_to_gcs_operator.PostgresToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
+.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubPublishOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubSubscriptionCreateOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubSubscriptionDeleteOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubPublishOperator
+.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
+.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
@@ -210,8 +241,8 @@ Operators
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
+.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
diff --git a/docs/conf.py b/docs/conf.py
index 0b5e69f159b18..0a9d72d951a94 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -38,19 +38,20 @@
 import airflow
 
 MOCK_MODULES = [
+    'google.auth.default',
+    'google.oauth2.service_account',
+    'google_auth_httplib2',
     'googleapiclient',
-    'googleapiclient.errors',
     'googleapiclient.discovery',
+    'googleapiclient.errors',
     'googleapiclient.http',
     'mesos',
     'mesos.interface',
     'mesos.native',
-    'google.auth.default',
-    'google_auth_httplib2',
-    'google.oauth2.service_account',
     'pandas.io.gbq',
+    'pymssql',
+    'simple_salesforce',
     'vertica_python',
-    'pymssql'
 ]
 for mod_name in MOCK_MODULES:
     sys.modules[mod_name] = mock.Mock()
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 2bf78e63cd078..538dd4d4fcacd 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1363,8 +1363,6 @@ as shown in the example:
     :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
     :end-before: [END howto_operator_cloudsql_import_gcs_permissions]
 
-.. _CloudSqlInstanceCreateOperator:
-
 CloudSqlInstanceCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1420,8 +1418,6 @@ More information
 See `Google Cloud SQL API documentation for insert
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
 
-.. _CloudSqlInstancePatchOperator:
-
 CloudSqlInstancePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index 719db2f3f9655..47b97c5fa4f47 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -37,14 +37,14 @@ You can still enable encryption for passwords within connections by following be
     print(fernet_key.decode()) # your fernet_key, keep it in secured place!
 
 3. Replace ``airflow.cfg`` fernet_key value with the one from step 2.
-Alternatively, you can store your fernet_key in OS environment variable. You
-do not need to change ``airflow.cfg`` in this case as Airflow will use environment
-variable over the value in ``airflow.cfg``:
+   Alternatively, you can store your fernet_key in OS environment variable. You
+   do not need to change ``airflow.cfg`` in this case as Airflow will use environment
+   variable over the value in ``airflow.cfg``:
 
-.. code-block:: bash
+   .. code-block:: bash
 
-  # Note the double underscores
-  export AIRFLOW__CORE__FERNET_KEY=your_fernet_key
+     # Note the double underscores
+     export AIRFLOW__CORE__FERNET_KEY=your_fernet_key
 
 4. Restart Airflow webserver.
 5. For existing connections (the ones that you had defined before installing ``airflow[crypto]`` and creating a Fernet key), you need to open each connection in the connection admin UI, re-type the password, and save it.
diff --git a/docs/integration.rst b/docs/integration.rst
index 9cad62a225935..4a1b38817d07b 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -121,6 +121,15 @@ WasbBlobSensor
 """"""""""""""
 
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
+    :noindex:
+
+.. _WasbDeleteBlobOperator:
+
+WasbDeleteBlobOperator
+""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.wasb_delete_blob_operator.WasbDeleteBlobOperator
+    :noindex:
 
 .. _WasbPrefixSensor:
 
@@ -128,6 +137,7 @@ WasbPrefixSensor
 """"""""""""""""
 
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor
+    :noindex:
 
 .. _FileToWasbOperator:
 
@@ -135,6 +145,7 @@ FileToWasbOperator
 """"""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
+    :noindex:
 
 .. _WasbHook:
 
@@ -142,6 +153,7 @@ WasbHook
 """"""""
 
 .. autoclass:: airflow.contrib.hooks.wasb_hook.WasbHook
+    :noindex:
 
 Azure File Share
 ''''''''''''''''
@@ -155,6 +167,7 @@ AzureFileShareHook
 """"""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
+    :noindex:
 
 Logging
 '''''''
@@ -178,18 +191,21 @@ default database and collection to use (see connection `azure_cosmos_default` fo
 
 AzureCosmosDBHook 
 """""""""""""""""
- 
-.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook 
- 
-AzureCosmosInsertDocumentOperator 
+
+.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
+    :noindex:
+
+AzureCosmosInsertDocumentOperator
 """""""""""""""""""""""""""""""""
  
 .. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
- 
-AzureCosmosDocumentSensor 
+    :noindex:
+
+AzureCosmosDocumentSensor
 """""""""""""""""""""""""
- 
-.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor 
+
+.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor
+    :noindex:
 
 Azure Data Lake
 '''''''''''''''
@@ -197,7 +213,7 @@ Azure Data Lake
 AzureDataLakeHook communicates via a REST API compatible with WebHDFS. Make sure that a
 Airflow connection of type `azure_data_lake` exists. Authorization can be done by supplying a
 login (=Client ID), password (=Client Secret) and extra fields tenant (Tenant) and account_name (Account Name)
- (see connection `azure_data_lake_default` for an example).
+(see connection `azure_data_lake_default` for an example).
 
 - :ref:`AzureDataLakeHook`: Interface with Azure Data Lake.
 - :ref:`AzureDataLakeStorageListOperator`: Lists the files located in a specified Azure Data Lake path.
@@ -209,6 +225,7 @@ AzureDataLakeHook
 """""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
+    :noindex:
 
 .. _AzureDataLakeStorageListOperator:
 
@@ -216,6 +233,7 @@ AzureDataLakeStorageListOperator
 """"""""""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
+    :noindex:
 
 .. _AdlsToGoogleCloudStorageOperator:
 
@@ -223,6 +241,7 @@ AdlsToGoogleCloudStorageOperator
 """"""""""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
+    :noindex:
 
 .. _AWS:
 
@@ -246,6 +265,7 @@ EmrAddStepsOperator
 """""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.emr_add_steps_operator.EmrAddStepsOperator
+    :noindex:
 
 .. _EmrCreateJobFlowOperator:
 
@@ -253,6 +273,7 @@ EmrCreateJobFlowOperator
 """"""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.emr_create_job_flow_operator.EmrCreateJobFlowOperator
+    :noindex:
 
 .. _EmrTerminateJobFlowOperator:
 
@@ -260,6 +281,7 @@ EmrTerminateJobFlowOperator
 """""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator
+    :noindex:
 
 .. _EmrHook:
 
@@ -267,6 +289,7 @@ EmrHook
 """""""
 
 .. autoclass:: airflow.contrib.hooks.emr_hook.EmrHook
+    :noindex:
 
 
 AWS S3
@@ -285,6 +308,7 @@ S3Hook
 """"""
 
 .. autoclass:: airflow.hooks.S3_hook.S3Hook
+    :noindex:
 
 .. _S3FileTransformOperator:
 
@@ -292,6 +316,7 @@ S3FileTransformOperator
 """""""""""""""""""""""
 
 .. autoclass:: airflow.operators.s3_file_transform_operator.S3FileTransformOperator
+    :noindex:
 
 .. _S3ListOperator:
 
@@ -299,6 +324,7 @@ S3ListOperator
 """"""""""""""
 
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
+    :noindex:
 
 .. _S3ToGoogleCloudStorageOperator:
 
@@ -306,13 +332,15 @@ S3ToGoogleCloudStorageOperator
 """"""""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
+    :noindex:
 
 .. _S3ToGoogleCloudStorageTransferOperator:
 
 S3ToGoogleCloudStorageTransferOperator
 """"""""""""""""""""""""""""""""""""""
 
-.. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
+    :noindex:
 
 .. _S3ToHiveTransfer:
 
@@ -320,6 +348,7 @@ S3ToHiveTransfer
 """"""""""""""""
 
 .. autoclass:: airflow.operators.s3_to_hive_operator.S3ToHiveTransfer
+    :noindex:
 
 
 AWS EC2 Container Service
@@ -333,6 +362,7 @@ ECSOperator
 """""""""""
 
 .. autoclass:: airflow.contrib.operators.ecs_operator.ECSOperator
+    :noindex:
 
 
 AWS Batch Service
@@ -346,6 +376,7 @@ AWSBatchOperator
 """"""""""""""""
 
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
+    :noindex:
 
 
 AWS RedShift
@@ -362,6 +393,7 @@ AwsRedshiftClusterSensor
 """"""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
+    :noindex:
 
 .. _RedshiftHook:
 
@@ -369,6 +401,7 @@ RedshiftHook
 """"""""""""
 
 .. autoclass:: airflow.contrib.hooks.redshift_hook.RedshiftHook
+    :noindex:
 
 .. _RedshiftToS3Transfer:
 
@@ -376,6 +409,7 @@ RedshiftToS3Transfer
 """"""""""""""""""""
 
 .. autoclass:: airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer
+    :noindex:
 
 .. _S3ToRedshiftTransfer:
 
@@ -383,77 +417,12 @@ S3ToRedshiftTransfer
 """"""""""""""""""""
 
 .. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
+    :noindex:
 
 
 Amazon SageMaker
 ''''''''''''''''
 
-For more instructions on using Amazon SageMaker in Airflow, please see `the SageMaker Python SDK README`_.
-
-.. _the SageMaker Python SDK README: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/workflow/README.rst
-
-- :ref:`SageMakerHook` : Interact with Amazon SageMaker.
-- :ref:`SageMakerTrainingOperator` : Create a SageMaker training job.
-- :ref:`SageMakerTuningOperator` : Create a SageMaker tuning job.
-- :ref:`SageMakerModelOperator` : Create a SageMaker model.
-- :ref:`SageMakerTransformOperator` : Create a SageMaker transform job.
-- :ref:`SageMakerEndpointConfigOperator` : Create a SageMaker endpoint config.
-- :ref:`SageMakerEndpointOperator` : Create a SageMaker endpoint.
-
-.. _SageMakerHook:
-
-SageMakerHook
-"""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
-
-.. _SageMakerTrainingOperator:
-
-SageMakerTrainingOperator
-"""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
-
-.. _SageMakerTuningOperator:
-
-SageMakerTuningOperator
-"""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
-
-.. _SageMakerModelOperator:
-
-SageMakerModelOperator
-""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
-
-.. _SageMakerTransformOperator:
-
-SageMakerTransformOperator
-""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
-
-.. _SageMakerEndpointConfigOperator:
-
-SageMakerEndpointConfigOperator
-"""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
-
-.. _SageMakerEndpointOperator:
-
-SageMakerEndpointOperator
-"""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
-
-Amazon SageMaker
-''''''''''''''''
-
-For more instructions on using Amazon SageMaker in Airflow, please see `the SageMaker Python SDK README`_.
-
 .. _the SageMaker Python SDK README: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/workflow/README.rst
 
 - :ref:`SageMakerHook` : Interact with Amazon SageMaker.
@@ -470,6 +439,7 @@ SageMakerHook
 """""""""""""
 
 .. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
+    :noindex:
 
 .. _SageMakerTrainingOperator:
 
@@ -477,6 +447,7 @@ SageMakerTrainingOperator
 """""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
+    :noindex:
 
 .. _SageMakerTuningOperator:
 
@@ -484,6 +455,7 @@ SageMakerTuningOperator
 """""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
+    :noindex:
 
 .. _SageMakerModelOperator:
 
@@ -491,6 +463,7 @@ SageMakerModelOperator
 """"""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
+    :noindex:
 
 .. _SageMakerTransformOperator:
 
@@ -498,6 +471,7 @@ SageMakerTransformOperator
 """"""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
+    :noindex:
 
 .. _SageMakerEndpointConfigOperator:
 
@@ -505,6 +479,7 @@ SageMakerEndpointConfigOperator
 """""""""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
+    :noindex:
 
 .. _SageMakerEndpointOperator:
 
@@ -512,6 +487,7 @@ SageMakerEndpointOperator
 """""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
+    :noindex:
 
 .. _Databricks:
 
@@ -526,7 +502,7 @@ DatabricksSubmitRunOperator
 '''''''''''''''''''''''''''
 
 .. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
-
+    :noindex:
 
 
 .. _GCP:
@@ -551,6 +527,7 @@ GoogleCloudBaseHook
 '''''''''''''''''''
 
 .. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
+    :noindex:
 
 .. _GoogleCloudBaseHook:
 
@@ -580,6 +557,7 @@ BigQueryCheckOperator
 ^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
+    :noindex:
 
 .. _BigQueryValueCheckOperator:
 
@@ -587,6 +565,7 @@ BigQueryValueCheckOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
+    :noindex:
 
 .. _BigQueryIntervalCheckOperator:
 
@@ -594,6 +573,7 @@ BigQueryIntervalCheckOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
+    :noindex:
 
 .. _BigQueryGetDataOperator:
 
@@ -601,6 +581,7 @@ BigQueryGetDataOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
+    :noindex:
 
 .. _BigQueryCreateEmptyTableOperator:
 
@@ -608,6 +589,7 @@ BigQueryCreateEmptyTableOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
+    :noindex:
 
 .. _BigQueryCreateExternalTableOperator:
 
@@ -615,6 +597,7 @@ BigQueryCreateExternalTableOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
+    :noindex:
 
 .. _BigQueryCreateEmptyDatasetOperator:
 
@@ -622,6 +605,7 @@ BigQueryCreateEmptyDatasetOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
+    :noindex:
 
 .. _BigQueryDeleteDatasetOperator:
 
@@ -629,6 +613,7 @@ BigQueryDeleteDatasetOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
+    :noindex:
 
 .. _BigQueryTableDeleteOperator:
 
@@ -636,6 +621,7 @@ BigQueryTableDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
+    :noindex:
 
 .. _BigQueryOperator:
 
@@ -643,6 +629,7 @@ BigQueryOperator
 ^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
+    :noindex:
 
 .. _BigQueryToBigQueryOperator:
 
@@ -650,6 +637,7 @@ BigQueryToBigQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
+    :noindex:
 
 .. _BigQueryToCloudStorageOperator:
 
@@ -657,6 +645,7 @@ BigQueryToCloudStorageOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.bigquery_to_gcs.BigQueryToCloudStorageOperator
+    :noindex:
 
 
 BigQueryHook
@@ -664,6 +653,7 @@ BigQueryHook
 
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
     :members:
+    :noindex:
 
 Cloud Spanner
 '''''''''''''
@@ -689,6 +679,7 @@ CloudSpannerInstanceDatabaseDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
+    :noindex:
 
 .. _CloudSpannerInstanceDatabaseDeployOperator:
 
@@ -696,6 +687,7 @@ CloudSpannerInstanceDatabaseDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
+    :noindex:
 
 .. _CloudSpannerInstanceDatabaseUpdateOperator:
 
@@ -703,6 +695,7 @@ CloudSpannerInstanceDatabaseUpdateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
+    :noindex:
 
 .. _CloudSpannerInstanceDatabaseQueryOperator:
 
@@ -710,6 +703,7 @@ CloudSpannerInstanceDatabaseQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
+    :noindex:
 
 .. _CloudSpannerInstanceDeployOperator:
 
@@ -717,6 +711,7 @@ CloudSpannerInstanceDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
+    :noindex:
 
 .. _CloudSpannerInstanceDeleteOperator:
 
@@ -724,6 +719,7 @@ CloudSpannerInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
+    :noindex:
 
 
 CloudSpannerHook
@@ -731,6 +727,7 @@ CloudSpannerHook
 
 .. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
     :members:
+    :noindex:
 
 
 Cloud SQL
@@ -758,6 +755,7 @@ CloudSqlInstanceDatabaseDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
+    :noindex:
 
 .. _CloudSqlInstanceDatabaseCreateOperator:
 
@@ -765,6 +763,7 @@ CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
+    :noindex:
 
 .. _CloudSqlInstanceDatabasePatchOperator:
 
@@ -772,6 +771,7 @@ CloudSqlInstanceDatabasePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
+    :noindex:
 
 .. _CloudSqlInstanceDeleteOperator:
 
@@ -779,6 +779,7 @@ CloudSqlInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
+    :noindex:
 
 .. _CloudSqlInstanceExportOperator:
 
@@ -786,6 +787,7 @@ CloudSqlInstanceExportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
+    :noindex:
 
 .. _CloudSqlInstanceImportOperator:
 
@@ -793,6 +795,7 @@ CloudSqlInstanceImportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
+    :noindex:
 
 .. _CloudSqlInstanceCreateOperator:
 
@@ -800,6 +803,7 @@ CloudSqlInstanceCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
+    :noindex:
 
 .. _CloudSqlInstancePatchOperator:
 
@@ -807,12 +811,15 @@ CloudSqlInstancePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
+    :noindex:
 
 .. _CloudSqlQueryOperator:
 
 CloudSqlQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^
+
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
+    :noindex:
 
 Cloud SQL Hooks
 """""""""""""""
@@ -821,16 +828,19 @@ Cloud SQL Hooks
 
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
     :members:
+    :noindex:
 
 .. _CloudSqlDatabaseHook:
 
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
     :members:
+    :noindex:
 
 .. _CloudSqlProxyRunner:
 
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner
     :members:
+    :noindex:
 
 
 Cloud Bigtable
@@ -849,9 +859,10 @@ Cloud Bigtable Operators
 .. _BigtableInstanceCreateOperator:
 
 BigtableInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
+    :noindex:
 
 .. _BigtableInstanceDeleteOperator:
 
@@ -859,6 +870,7 @@ BigtableInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
+    :noindex:
 
 .. _BigtableClusterUpdateOperator:
 
@@ -866,6 +878,7 @@ BigtableClusterUpdateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
+    :noindex:
 
 .. _BigtableTableCreateOperator:
 
@@ -873,6 +886,7 @@ BigtableTableCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
+    :noindex:
 
 .. _BigtableTableDeleteOperator:
 
@@ -880,6 +894,7 @@ BigtableTableDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
+    :noindex:
 
 .. _BigtableTableWaitForReplicationSensor:
 
@@ -887,6 +902,7 @@ BigtableTableWaitForReplicationSensor
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor
+    :noindex:
 
 .. _BigtableHook:
 
@@ -913,6 +929,7 @@ Compute Engine Operators
 The operators have the common base operator:
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
+    :noindex:
 
 They also use :ref:`GceHook` to communicate with Google Cloud Platform.
 
@@ -922,6 +939,7 @@ GceInstanceStartOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
+    :noindex:
 
 .. _GceInstanceStopOperator:
 
@@ -929,6 +947,7 @@ GceInstanceStopOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
+    :noindex:
 
 .. _GceSetMachineTypeOperator:
 
@@ -936,6 +955,7 @@ GceSetMachineTypeOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
+    :noindex:
 
 .. _GceInstanceTemplateCopyOperator:
 
@@ -943,6 +963,7 @@ GceInstanceTemplateCopyOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
+    :noindex:
 
 .. _GceInstanceGroupManagerUpdateTemplateOperator:
 
@@ -950,6 +971,7 @@ GceInstanceGroupManagerUpdateTemplateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
+    :noindex:
 
 .. _GceHook:
 
@@ -957,7 +979,8 @@ Compute Engine Hook
 """""""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.gcp_compute_hook.GceHook
-:members:
+    :members:
+    :noindex:
 
 
 Cloud Functions
@@ -969,8 +992,6 @@ Cloud Functions Operators
 - :ref:`GcfFunctionDeployOperator` : deploy Google Cloud Function to Google Cloud Platform
 - :ref:`GcfFunctionDeleteOperator` : delete Google Cloud Function in Google Cloud Platform
 
-.. autoclass:: airflow.contrib.operators.gcp_operator.GCP
-
 They also use :ref:`GcfHook` to communicate with Google Cloud Platform.
 
 .. _GcfFunctionDeployOperator:
@@ -979,7 +1000,7 @@ GcfFunctionDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
-
+    :noindex:
 
 .. _GcfFunctionDeleteOperator:
 
@@ -987,6 +1008,7 @@ GcfFunctionDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
+    :noindex:
 
 .. _GcfHook:
 
@@ -995,6 +1017,7 @@ Cloud Functions Hook
 
 .. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
     :members:
+    :noindex:
 
 
 Cloud DataFlow
@@ -1013,6 +1036,7 @@ DataFlowJavaOperator
 ^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
+    :noindex:
 
 .. code:: python
 
@@ -1054,6 +1078,7 @@ DataflowTemplateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
+    :noindex:
 
 .. _DataFlowPythonOperator:
 
@@ -1061,6 +1086,7 @@ DataFlowPythonOperator
 ^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
+    :noindex:
 
 
 DataFlowHook
@@ -1068,6 +1094,7 @@ DataFlowHook
 
 .. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
     :members:
+    :noindex:
 
 
 
@@ -1095,6 +1122,7 @@ DataprocClusterCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
+    :noindex:
 
 .. _DataprocClusterScaleOperator:
 
@@ -1102,6 +1130,7 @@ DataprocClusterScaleOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
+    :noindex:
 
 .. _DataprocClusterDeleteOperator:
 
@@ -1109,6 +1138,7 @@ DataprocClusterDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
+    :noindex:
 
 .. _DataProcPigOperator:
 
@@ -1116,6 +1146,7 @@ DataProcPigOperator
 ^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
+    :noindex:
 
 .. _DataProcHiveOperator:
 
@@ -1123,6 +1154,7 @@ DataProcHiveOperator
 ^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
+    :noindex:
 
 .. _DataProcSparkSqlOperator:
 
@@ -1130,6 +1162,7 @@ DataProcSparkSqlOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
+    :noindex:
 
 .. _DataProcSparkOperator:
 
@@ -1137,6 +1170,7 @@ DataProcSparkOperator
 ^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
+    :noindex:
 
 .. _DataProcHadoopOperator:
 
@@ -1144,6 +1178,7 @@ DataProcHadoopOperator
 ^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
+    :noindex:
 
 .. _DataProcPySparkOperator:
 
@@ -1151,6 +1186,7 @@ DataProcPySparkOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator
+    :noindex:
 
 .. _DataprocWorkflowTemplateInstantiateOperator:
 
@@ -1158,6 +1194,7 @@ DataprocWorkflowTemplateInstantiateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
+    :noindex:
 
 .. _DataprocWorkflowTemplateInstantiateInlineOperator:
 
@@ -1165,6 +1202,7 @@ DataprocWorkflowTemplateInstantiateInlineOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator
+    :noindex:
 
 Cloud Datastore
 '''''''''''''''
@@ -1181,6 +1219,7 @@ DatastoreExportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.datastore_export_operator.DatastoreExportOperator
+    :noindex:
 
 .. _DatastoreImportOperator:
 
@@ -1188,12 +1227,14 @@ DatastoreImportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.datastore_import_operator.DatastoreImportOperator
+    :noindex:
 
 DatastoreHook
 """""""""""""
 
 .. autoclass:: airflow.contrib.hooks.datastore_hook.DatastoreHook
     :members:
+    :noindex:
 
 
 Cloud ML Engine
@@ -1214,6 +1255,7 @@ MLEngineBatchPredictionOperator
 
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineBatchPredictionOperator
     :members:
+    :noindex:
 
 .. _MLEngineModelOperator:
 
@@ -1222,6 +1264,7 @@ MLEngineModelOperator
 
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineModelOperator
     :members:
+    :noindex:
 
 .. _MLEngineTrainingOperator:
 
@@ -1230,6 +1273,7 @@ MLEngineTrainingOperator
 
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator
     :members:
+    :noindex:
 
 .. _MLEngineVersionOperator:
 
@@ -1238,6 +1282,7 @@ MLEngineVersionOperator
 
 .. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator
     :members:
+    :noindex:
 
 Cloud ML Engine Hook
 """"""""""""""""""""
@@ -1249,6 +1294,7 @@ MLEngineHook
 
 .. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
     :members:
+    :noindex:
 
 
 Cloud Storage
@@ -1274,6 +1320,7 @@ FileToGoogleCloudStorageOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator
+    :noindex:
 
 .. _GoogleCloudStorageCreateBucketOperator:
 
@@ -1281,6 +1328,7 @@ GoogleCloudStorageBucketCreateAclEntryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
+    :noindex:
 
 .. _GoogleCloudStorageBucketCreateAclEntryOperator:
 
@@ -1288,6 +1336,7 @@ GoogleCloudStorageCreateBucketOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
+    :noindex:
 
 .. _GoogleCloudStorageDownloadOperator:
 
@@ -1295,6 +1344,7 @@ GoogleCloudStorageDownloadOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
+    :noindex:
 
 .. _GoogleCloudStorageListOperator:
 
@@ -1302,6 +1352,7 @@ GoogleCloudStorageListOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
+    :noindex:
 
 .. _GoogleCloudStorageToBigQueryOperator:
 
@@ -1309,6 +1360,7 @@ GoogleCloudStorageObjectCreateAclEntryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
+    :noindex:
 
 .. _GoogleCloudStorageObjectCreateAclEntryOperator:
 
@@ -1316,6 +1368,7 @@ GoogleCloudStorageToBigQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
+    :noindex:
 
 .. _GoogleCloudStorageToGoogleCloudStorageOperator:
 
@@ -1323,6 +1376,7 @@ GoogleCloudStorageToGoogleCloudStorageOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
+    :noindex:
 
 .. _GoogleCloudStorageToGoogleCloudStorageTransferOperator:
 
@@ -1330,6 +1384,7 @@ GoogleCloudStorageToGoogleCloudStorageTransferOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
+    :noindex:
 
 .. _MySqlToGoogleCloudStorageOperator:
 
@@ -1337,18 +1392,21 @@ MySqlToGoogleCloudStorageOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
+    :noindex:
 
 GoogleCloudStorageHook
 """"""""""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
     :members:
+    :noindex:
 
 GCPTransferServiceHook
 """"""""""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
     :members:
+    :noindex:
 
 Google Kubernetes Engine
 ''''''''''''''''''''''''
@@ -1363,18 +1421,24 @@ GKEClusterCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
+    :noindex:
+
 .. _GKEClusterCreateOperator:
 
 GKEClusterDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
+    :noindex:
+
 .. _GKEClusterDeleteOperator:
 
 GKEPodOperator
 ^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
+    :noindex:
+
 .. _GKEPodOperator:
 
 Google Kubernetes Engine Hook
@@ -1382,7 +1446,7 @@ Google Kubernetes Engine Hook
 
 .. autoclass:: airflow.contrib.hooks.gcp_container_hook.GKEClusterHook
     :members:
-
+    :noindex:
 
 .. _Qubole:
 
@@ -1396,24 +1460,28 @@ QuboleOperator
 ''''''''''''''
 
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
+    :noindex:
 
 QubolePartitionSensor
 '''''''''''''''''''''
 
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor
-
+    :noindex:
 
 QuboleFileSensor
 ''''''''''''''''
 
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor
+    :noindex:
 
 QuboleCheckOperator
 '''''''''''''''''''
 
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
+    :noindex:
 
 QuboleValueCheckOperator
 ''''''''''''''''''''''''
 
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
+    :noindex:
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 33b4f3474d73a..abfeedb008be7 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -128,5 +128,8 @@ Kubernetes Operator
 
 
 .. autoclass:: airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator
+    :noindex:
+
 
 .. autoclass:: airflow.contrib.kubernetes.secret.Secret
+    :noindex:
diff --git a/docs/plugins.rst b/docs/plugins.rst
index a5662da47962c..0c51003c5c068 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -246,7 +246,6 @@ component with the pattern `airflow.{component}.{name}.{component_class_name}`.
         }
     )
 
-::
 
 This will create a hook, and an operator accessible at:
  - `airflow.hooks.my_namespace.MyHook`
diff --git a/docs/security.rst b/docs/security.rst
index 5efe7b847266b..1e521e4f2872b 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -256,7 +256,7 @@ and in your DAG, when initializing the HiveOperator, specify:
 
 To use kerberos authentication, you must install Airflow with the `kerberos` extras group:
 
-.. code-block:: base
+.. code-block:: bash
 
    pip install airflow[kerberos]
 
@@ -289,7 +289,7 @@ to only members of those teams.
 
 To use GHE authentication, you must install Airflow with the `github_enterprise` extras group:
 
-.. code-block:: base
+.. code-block:: bash
 
    pip install airflow[github_enterprise]
 
@@ -337,7 +337,7 @@ login, separated with a comma, to only members of those domains.
 
 To use Google authentication, you must install Airflow with the `google_auth` extras group:
 
-.. code-block:: base
+.. code-block:: bash
 
    pip install airflow[google_auth]
 

From 66eeaf7b761207c5ebf92a7f261a577025c66423 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Thu, 24 Jan 2019 19:19:43 +0800
Subject: [PATCH 495/808] [AIRFLOW-XXX] Fix spark submit hook KeyError (#4578)

Fix string format KeyError in spark_submit_hook.py
---
 airflow/contrib/hooks/spark_submit_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 65bb6134e6ac4..8f6122dca299b 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -137,7 +137,7 @@ def __init__(self,
         self._is_kubernetes = 'k8s' in self._connection['master']
         if self._is_kubernetes and kube_client is None:
             raise RuntimeError(
-                "{master} specified by kubernetes dependencies are not installed!".format(
+                "{} specified by kubernetes dependencies are not installed!".format(
                     self._connection['master']))
 
         self._should_track_driver_status = self._resolve_should_track_driver_status()

From deb6e2e287b10d2660f2fe95729f333863dbd793 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 24 Jan 2019 00:21:24 +0000
Subject: [PATCH 496/808] [AIRFLOW-XXX] Pin version of Pip in tests to work
 around pypa/pip#6163 (#4576)

There is a bug or a new feature that causes a number of our dependencies
to fail to install.
---
 scripts/ci/kubernetes/docker/Dockerfile | 2 +-
 tox.ini                                 | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/scripts/ci/kubernetes/docker/Dockerfile b/scripts/ci/kubernetes/docker/Dockerfile
index 93b20dbcd22fa..7d9385f479896 100644
--- a/scripts/ci/kubernetes/docker/Dockerfile
+++ b/scripts/ci/kubernetes/docker/Dockerfile
@@ -45,7 +45,7 @@ RUN pip install -U setuptools && \
 
 # install airflow
 COPY airflow.tar.gz /tmp/airflow.tar.gz
-RUN pip install /tmp/airflow.tar.gz
+RUN pip install --no-use-pep517 /tmp/airflow.tar.gz
 
 COPY airflow-test-env-init.sh /tmp/airflow-test-env-init.sh
 
diff --git a/tox.ini b/tox.ini
index bc0d4b78f74cd..af7ba40d03273 100644
--- a/tox.ini
+++ b/tox.ini
@@ -53,8 +53,8 @@ setenv =
 passenv = *
 
 commands =
-  pip wheel --progress-bar off -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
-  pip install --progress-bar off --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
+  pip wheel --no-use-pep517 --progress-bar off -w {homedir}/.wheelhouse -f {homedir}/.wheelhouse -e .[devel_ci]
+  pip install --no-use-pep517 --progress-bar off --find-links={homedir}/.wheelhouse --no-index -e .[devel_ci]
   env_docker: {toxinidir}/scripts/ci/1-setup-env.sh
   env_docker: {toxinidir}/scripts/ci/2-setup-kdc.sh
   backend_mysql: {toxinidir}/scripts/ci/3-setup-mysql.sh

From 5e93e626d3ae6c03caf31399fee7d68620c69bf3 Mon Sep 17 00:00:00 2001
From: Cameron Moberg <cjmoberg@gmail.com>
Date: Fri, 3 Aug 2018 06:28:31 -0700
Subject: [PATCH 497/808] [AIRFLOW-2796] Expand code coverage for
 utils/helpers.py (#3686)

---
 tests/utils/test_helpers.py | 57 +++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index d5559ad79cf32..6e8b84d5d374c 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -117,5 +117,62 @@ def test_reduce_in_chunks(self):
                          14)
 
 
+class HelpersTest(unittest.TestCase):
+    def test_as_tuple_iter(self):
+        test_list = ['test_str']
+        as_tup = helpers.as_tuple(test_list)
+        self.assertTupleEqual(tuple(test_list), as_tup)
+
+    def test_as_tuple_no_iter(self):
+        test_str = 'test_str'
+        as_tup = helpers.as_tuple(test_str)
+        self.assertTupleEqual((test_str,), as_tup)
+
+    def test_is_in(self):
+        from airflow.utils import helpers
+        # `is_in` expects an object, and a list as input
+
+        test_dict = {'test': 1}
+        test_list = ['test', 1, dict()]
+        small_i = 3
+        big_i = 2 ** 31
+        test_str = 'test_str'
+        test_tup = ('test', 'tuple')
+
+        test_container = [test_dict, test_list, small_i, big_i, test_str, test_tup]
+
+        # Test that integers are referenced as the same object
+        self.assertTrue(helpers.is_in(small_i, test_container))
+        self.assertTrue(helpers.is_in(3, test_container))
+
+        # python caches small integers, so i is 3 will be True,
+        # but `big_i is 2 ** 31` is False.
+        self.assertTrue(helpers.is_in(big_i, test_container))
+        self.assertFalse(helpers.is_in(2 ** 31, test_container))
+
+        self.assertTrue(helpers.is_in(test_dict, test_container))
+        self.assertFalse(helpers.is_in({'test': 1}, test_container))
+
+        self.assertTrue(helpers.is_in(test_list, test_container))
+        self.assertFalse(helpers.is_in(['test', 1, dict()], test_container))
+
+        self.assertTrue(helpers.is_in(test_str, test_container))
+        self.assertTrue(helpers.is_in('test_str', test_container))
+        bad_str = 'test_'
+        bad_str += 'str'
+        self.assertFalse(helpers.is_in(bad_str, test_container))
+
+        self.assertTrue(helpers.is_in(test_tup, test_container))
+        self.assertFalse(helpers.is_in(('test', 'tuple'), test_container))
+        bad_tup = ('test', 'tuple', 'hello')
+        self.assertFalse(helpers.is_in(bad_tup[:2], test_container))
+
+    def test_is_container(self):
+        self.assertTrue(helpers.is_container(['test_list']))
+        self.assertFalse(helpers.is_container('test_str_not_iterable'))
+        # Pass an object that is not iter nor a string.
+        self.assertFalse(helpers.is_container(10))
+
+
 if __name__ == '__main__':
     unittest.main()

From df32a2d7e39c0b43eff9572684d39c1103a3e35d Mon Sep 17 00:00:00 2001
From: Andy Cooper <andycooper.s@gmail.com>
Date: Sat, 4 Aug 2018 20:53:22 -0400
Subject: [PATCH 498/808] [AIRFLOW-2796] Improve utils helpers code coverage
 (#3637)

---
 tests/utils/test_helpers.py | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index 6e8b84d5d374c..4cb3e1a1fc8e1 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -116,6 +116,43 @@ def test_reduce_in_chunks(self):
                                                   2),
                          14)
 
+    def test_is_in(self):
+        obj = ["list", "object"]
+        # Check for existence of a list object within a list
+        self.assertTrue(
+            helpers.is_in(obj, [obj])
+        )
+
+        # Check that an empty list returns false
+        self.assertFalse(
+            helpers.is_in(obj, [])
+        )
+
+        # Check to ensure it handles None types
+        self.assertFalse(
+            helpers.is_in(None, [obj])
+        )
+
+        # Check to ensure true will be returned of multiple objects exist
+        self.assertTrue(
+            helpers.is_in(obj, [obj, obj])
+        )
+
+    def test_is_container(self):
+        self.assertFalse(helpers.is_container("a string is not a container"))
+        self.assertTrue(helpers.is_container(["a", "list", "is", "a", "container"]))
+
+    def test_as_tuple(self):
+        self.assertEquals(
+            helpers.as_tuple("a string is not a container"),
+            ("a string is not a container",)
+        )
+
+        self.assertEquals(
+            helpers.as_tuple(["a", "list", "is", "a", "container"]),
+            ("a", "list", "is", "a", "container")
+        )
+
 
 class HelpersTest(unittest.TestCase):
     def test_as_tuple_iter(self):

From f8a85e4b6e9e5a3a7edd57c6beef4ad64dce374c Mon Sep 17 00:00:00 2001
From: Joshua Iverson <jiverson@docutap.com>
Date: Mon, 25 Jun 2018 19:42:38 +0100
Subject: [PATCH 499/808] [AIRFLOW-1978] Add support for additional WinRM
 parameters

Implemented all of the WinRM options from pywinrm.
Implemented support for streaming stdout/stderr.

Closes #3512 from jshvrsn/winrm
---
 airflow/contrib/hooks/winrm_hook.py         | 284 ++++++++++++++------
 airflow/contrib/operators/winrm_operator.py | 107 +++++---
 2 files changed, 272 insertions(+), 119 deletions(-)

diff --git a/airflow/contrib/hooks/winrm_hook.py b/airflow/contrib/hooks/winrm_hook.py
index 0be904b9bcdca..1dd02f9951fde 100644
--- a/airflow/contrib/hooks/winrm_hook.py
+++ b/airflow/contrib/hooks/winrm_hook.py
@@ -17,121 +17,235 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+
 import getpass
+
 from winrm.protocol import Protocol
+
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 
 class WinRMHook(BaseHook, LoggingMixin):
-
     """
     Hook for winrm remote execution using pywinrm.
 
+    :seealso: https://github.com/diyan/pywinrm/blob/master/winrm/protocol.py
+
     :param ssh_conn_id: connection id from airflow Connections from where all
-        the required parameters can be fetched like username, password or key_file.
+        the required parameters can be fetched like username and password.
         Thought the priority is given to the param passed during init
-    :type ssh_conn_id: str
-    :param remote_host: remote host to connect
-    :type remote_host: str
+    :type ssh_conn_id: string
+    :param endpoint: When set to `None`, endpoint will be constructed like this:
+        'http://{remote_host}:{remote_port}/wsman'
+    :type endpoint: string
+    :param remote_host: Remote host to connect to.
+        Ignored if `endpoint` is not `None`.
+    :type remote_host: string
+    :param remote_port: Remote port to connect to.
+        Ignored if `endpoint` is not `None`.
+    :type remote_port: int
+    :param transport: transport type, one of 'plaintext' (default), 'kerberos', 'ssl',
+        'ntlm', 'credssp'
+    :type transport: string
     :param username: username to connect to the remote_host
-    :type username: str
+    :type username: string
     :param password: password of the username to connect to the remote_host
-    :type password: str
-    :param key_file: key file to use to connect to the remote_host.
-    :type key_file: str
-    :param timeout: timeout for the attempt to connect to the remote_host.
-    :type timeout: int
-    :param keepalive_interval: send a keepalive packet to remote host
-        every keepalive_interval seconds
-    :type keepalive_interval: int
+    :type password: string
+    :param service: the service name, default is HTTP
+    :type service: string
+    :param keytab: the path to a keytab file if you are using one
+    :type keytab: string
+    :param ca_trust_path: Certification Authority trust path
+    :type ca_trust_path: string
+    :param cert_pem: client authentication certificate file path in PEM format
+    :type cert_pem: string
+    :param cert_key_pem: client authentication certificate key file path in PEM format
+    :type cert_key_pem: string
+    :param server_cert_validation: whether server certificate should be validated on
+        Python versions that suppport it; one of 'validate' (default), 'ignore'
+    :type server_cert_validation: string
+    :param kerberos_delegation: if True, TGT is sent to target server to
+        allow multiple hops
+    :type kerberos_delegation: bool
+    :param read_timeout_sec: maximum seconds to wait before an HTTP connect/read times out
+        (default 30). This value should be slightly higher than operation_timeout_sec,
+        as the server can block *at least* that long.
+    :type read_timeout_sec: int
+    :param operation_timeout_sec: maximum allowed time in seconds for any single wsman
+        HTTP operation (default 20). Note that operation timeouts while receiving output
+        (the only wsman operation that should take any significant time, and where these
+        timeouts are expected) will be silently retried indefinitely.
+    :type operation_timeout_sec: int
+    :param kerberos_hostname_override: the hostname to use for the kerberos exchange
+        (defaults to the hostname in the endpoint URL)
+    :type kerberos_hostname_override: string
+    :param message_encryption_enabled: Will encrypt the WinRM messages if set to True and
+        the transport auth supports message encryption (Default True).
+    :type message_encryption_enabled: bool
+    :param credssp_disable_tlsv1_2: Whether to disable TLSv1.2 support and work with older
+        protocols like TLSv1.0, default is False
+    :type credssp_disable_tlsv1_2: bool
+    :param send_cbt: Will send the channel bindings over a HTTPS channel (Default: True)
+    :type send_cbt: bool
     """
-
     def __init__(self,
                  ssh_conn_id=None,
+                 endpoint=None,
                  remote_host=None,
+                 remote_port=5985,
+                 transport='plaintext',
                  username=None,
                  password=None,
-                 key_file=None,
-                 timeout=10,
-                 keepalive_interval=30
+                 service='HTTP',
+                 keytab=None,
+                 ca_trust_path=None,
+                 cert_pem=None,
+                 cert_key_pem=None,
+                 server_cert_validation='validate',
+                 kerberos_delegation=False,
+                 read_timeout_sec=30,
+                 operation_timeout_sec=20,
+                 kerberos_hostname_override=None,
+                 message_encryption='auto',
+                 credssp_disable_tlsv1_2=False,
+                 send_cbt=True,
                  ):
         super(WinRMHook, self).__init__(ssh_conn_id)
-        # TODO make new win rm connection class
         self.ssh_conn_id = ssh_conn_id
+        self.endpoint = endpoint
         self.remote_host = remote_host
+        self.remote_port = remote_port
+        self.transport = transport
         self.username = username
         self.password = password
-        self.key_file = key_file
-        self.timeout = timeout
-        self.keepalive_interval = keepalive_interval
-        # Default values, overridable from Connection
-        self.compress = True
-        self.no_host_key_check = True
+        self.service = service
+        self.keytab = keytab
+        self.ca_trust_path = ca_trust_path
+        self.cert_pem = cert_pem
+        self.cert_key_pem = cert_key_pem
+        self.server_cert_validation = server_cert_validation
+        self.kerberos_delegation = kerberos_delegation
+        self.read_timeout_sec = read_timeout_sec
+        self.operation_timeout_sec = operation_timeout_sec
+        self.kerberos_hostname_override = kerberos_hostname_override
+        self.message_encryption = message_encryption
+        self.credssp_disable_tlsv1_2 = credssp_disable_tlsv1_2
+        self.send_cbt = send_cbt
+
         self.client = None
         self.winrm_protocol = None
 
     def get_conn(self):
-        if not self.client:
-            self.log.debug('Creating WinRM client for conn_id: %s', self.ssh_conn_id)
-            if self.ssh_conn_id is not None:
-                conn = self.get_connection(self.ssh_conn_id)
-                if self.username is None:
-                    self.username = conn.login
-                if self.password is None:
-                    self.password = conn.password
-                if self.remote_host is None:
-                    self.remote_host = conn.host
-                if conn.extra is not None:
-                    extra_options = conn.extra_dejson
-                    self.key_file = extra_options.get("key_file")
-
-                    if "timeout" in extra_options:
-                        self.timeout = int(extra_options["timeout"], 10)
-
-                    if "compress" in extra_options \
-                            and extra_options["compress"].lower() == 'false':
-                        self.compress = False
-                    if "no_host_key_check" in extra_options \
-                            and extra_options["no_host_key_check"].lower() == 'false':
-                        self.no_host_key_check = False
-
-            if not self.remote_host:
-                raise AirflowException("Missing required param: remote_host")
-
-            # Auto detecting username values from system
-            if not self.username:
-                self.log.debug(
-                    "username to ssh to host: %s is not specified for connection id"
-                    " %s. Using system's default provided by getpass.getuser()",
-                    self.remote_host, self.ssh_conn_id
-                )
-                self.username = getpass.getuser()
-
-            try:
-
-                if self.password and self.password.strip():
-                    self.winrm_protocol = Protocol(
-                        # TODO pass in port from ssh conn
-                        endpoint='http://' + self.remote_host + ':5985/wsman',
-                        # TODO get cert transport working
-                        # transport='certificate',
-                        transport='plaintext',
-                        # cert_pem=r'publickey.pem',
-                        # cert_key_pem=r'dev.pem',
-                        read_timeout_sec=70,
-                        operation_timeout_sec=60,
-                        username=self.username,
-                        password=self.password,
-                        server_cert_validation='ignore')
-
-                self.log.info("Opening WinRM shell")
-                self.client = self.winrm_protocol.open_shell()
-
-            except Exception as error:
-                self.log.error(
-                    "Error connecting to host: %s, error: %s",
-                    self.remote_host, error
+        if self.client:
+            return self.client
+
+        self.log.debug('Creating WinRM client for conn_id: %s', self.ssh_conn_id)
+        if self.ssh_conn_id is not None:
+            conn = self.get_connection(self.ssh_conn_id)
+
+            if self.username is None:
+                self.username = conn.login
+            if self.password is None:
+                self.password = conn.password
+            if self.remote_host is None:
+                self.remote_host = conn.host
+
+            if conn.extra is not None:
+                extra_options = conn.extra_dejson
+
+                if "endpoint" in extra_options:
+                    self.endpoint = str(extra_options["endpoint"])
+                if "remote_port" in extra_options:
+                    self.remote_port = int(extra_options["remote_port"])
+                if "transport" in extra_options:
+                    self.transport = str(extra_options["transport"])
+                if "service" in extra_options:
+                    self.service = str(extra_options["service"])
+                if "keytab" in extra_options:
+                    self.keytab = str(extra_options["keytab"])
+                if "ca_trust_path" in extra_options:
+                    self.ca_trust_path = str(extra_options["ca_trust_path"])
+                if "cert_pem" in extra_options:
+                    self.cert_pem = str(extra_options["cert_pem"])
+                if "cert_key_pem" in extra_options:
+                    self.cert_key_pem = str(extra_options["cert_key_pem"])
+                if "server_cert_validation" in extra_options:
+                    self.server_cert_validation = \
+                        str(extra_options["server_cert_validation"])
+                if "kerberos_delegation" in extra_options:
+                    self.kerberos_delegation = \
+                        str(extra_options["kerberos_delegation"]).lower() == 'true'
+                if "read_timeout_sec" in extra_options:
+                    self.read_timeout_sec = int(extra_options["read_timeout_sec"])
+                if "operation_timeout_sec" in extra_options:
+                    self.operation_timeout_sec = \
+                        int(extra_options["operation_timeout_sec"])
+                if "kerberos_hostname_override" in extra_options:
+                    self.kerberos_hostname_override = \
+                        str(extra_options["kerberos_hostname_override"])
+                if "message_encryption" in extra_options:
+                    self.message_encryption = str(extra_options["message_encryption"])
+                if "credssp_disable_tlsv1_2" in extra_options:
+                    self.credssp_disable_tlsv1_2 = \
+                        str(extra_options["credssp_disable_tlsv1_2"]).lower() == 'true'
+                if "send_cbt" in extra_options:
+                    self.send_cbt = str(extra_options["send_cbt"]).lower() == 'true'
+
+        if not self.remote_host:
+            raise AirflowException("Missing required param: remote_host")
+
+        # Auto detecting username values from system
+        if not self.username:
+            self.log.debug(
+                "username to WinRM to host: %s is not specified for connection id"
+                " %s. Using system's default provided by getpass.getuser()",
+                self.remote_host, self.ssh_conn_id
+            )
+            self.username = getpass.getuser()
+
+        # If endpoint is not set, then build a standard wsman endpoint from host and port.
+        if not self.endpoint:
+            self.endpoint = 'http://{0}:{1}/wsman'.format(
+                self.remote_host,
+                self.remote_port
+            )
+
+        try:
+            if self.password and self.password.strip():
+                self.winrm_protocol = Protocol(
+                    endpoint=self.endpoint,
+                    transport=self.transport,
+                    username=self.username,
+                    password=self.password,
+                    service=self.service,
+                    keytab=self.keytab,
+                    ca_trust_path=self.ca_trust_path,
+                    cert_pem=self.cert_pem,
+                    cert_key_pem=self.cert_key_pem,
+                    server_cert_validation=self.server_cert_validation,
+                    kerberos_delegation=self.kerberos_delegation,
+                    read_timeout_sec=self.read_timeout_sec,
+                    operation_timeout_sec=self.operation_timeout_sec,
+                    kerberos_hostname_override=self.kerberos_hostname_override,
+                    message_encryption=self.message_encryption,
+                    credssp_disable_tlsv1_2=self.credssp_disable_tlsv1_2,
+                    send_cbt=self.send_cbt
                 )
+
+            self.log.info(
+                "Establishing WinRM connection to host: %s",
+                self.remote_host
+            )
+            self.client = self.winrm_protocol.open_shell()
+
+        except Exception as error:
+            error_msg = "Error connecting to host: {0}, error: {1}".format(
+                self.remote_host,
+                error
+            )
+            self.log.error(error_msg)
+            raise AirflowException(error_msg)
+
         return self.client
diff --git a/airflow/contrib/operators/winrm_operator.py b/airflow/contrib/operators/winrm_operator.py
index fcd2328d9ad3a..c81acac44f6aa 100644
--- a/airflow/contrib/operators/winrm_operator.py
+++ b/airflow/contrib/operators/winrm_operator.py
@@ -17,14 +17,24 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from base64 import b64encode
+import logging
+
+from winrm.exceptions import WinRMOperationTimeoutError
+
+from airflow import configuration
 from airflow.contrib.hooks.winrm_hook import WinRMHook
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
 
+# Hide the following error message in urllib3 when making WinRM connections:
+# requests.packages.urllib3.exceptions.HeaderParsingError: [StartBoundaryNotFoundDefect(),
+#   MultipartInvariantViolationDefect()], unparsed data: ''
+logging.getLogger('requests.packages.urllib3.connectionpool').setLevel(logging.CRITICAL)
 
-class WinRMOperator(BaseOperator):
 
+class WinRMOperator(BaseOperator):
     """
     WinRMOperator to execute commands on given remote host using the winrm_hook.
 
@@ -41,7 +51,6 @@ class WinRMOperator(BaseOperator):
     :param do_xcom_push: return the stdout which also get set in xcom by airflow platform
     :type do_xcom_push: bool
     """
-
     template_fields = ('command',)
 
     @apply_defaults
@@ -63,48 +72,78 @@ def __init__(self,
         self.do_xcom_push = do_xcom_push
 
     def execute(self, context):
-        try:
-            if self.ssh_conn_id and not self.winrm_hook:
-                self.log.info("hook not found, creating")
-                self.winrm_hook = WinRMHook(ssh_conn_id=self.ssh_conn_id)
+        if self.ssh_conn_id and not self.winrm_hook:
+            self.log.info("Hook not found, creating...")
+            self.winrm_hook = WinRMHook(ssh_conn_id=self.ssh_conn_id)
 
-            if not self.winrm_hook:
-                raise AirflowException("can not operate without ssh_hook or ssh_conn_id")
+        if not self.winrm_hook:
+            raise AirflowException("Cannot operate without winrm_hook or ssh_conn_id.")
 
-            if self.remote_host is not None:
-                self.winrm_hook.remote_host = self.remote_host
+        if self.remote_host is not None:
+            self.winrm_hook.remote_host = self.remote_host
 
-            winrm_client = self.winrm_hook.get_conn()
-            self.log.info("Established WinRM connection")
+        if not self.command:
+            raise AirflowException("No command specified so nothing to execute here.")
 
-            if not self.command:
-                raise AirflowException("no command specified so nothing to execute here.")
+        winrm_client = self.winrm_hook.get_conn()
 
-            self.log.info(
-                "Starting command: '{command}' on remote host: {remotehost}".
-                format(command=self.command, remotehost=self.winrm_hook.remote_host)
+        try:
+            self.log.info("Running command: '{command}'...".format(command=self.command))
+            command_id = self.winrm_hook.winrm_protocol.run_command(
+                winrm_client,
+                self.command
             )
-            command_id = self.winrm_hook.winrm_protocol. \
-                run_command(winrm_client, self.command)
-            std_out, std_err, status_code = self.winrm_hook.winrm_protocol. \
-                get_command_output(winrm_client, command_id)
-
-            self.log.info("std out: " + std_out.decode())
-            self.log.info("std err: " + std_err.decode())
-            self.log.info("exit code: " + str(status_code))
-            self.log.info("Cleaning up WinRM command")
+
+            # See: https://github.com/diyan/pywinrm/blob/master/winrm/protocol.py
+            stdout_buffer = []
+            stderr_buffer = []
+            command_done = False
+            while not command_done:
+                try:
+                    stdout, stderr, return_code, command_done = \
+                        self.winrm_hook.winrm_protocol._raw_get_command_output(
+                            winrm_client,
+                            command_id
+                        )
+
+                    # Only buffer stdout if we need to so that we minimize memory usage.
+                    if self.do_xcom_push:
+                        stdout_buffer.append(stdout)
+                    stderr_buffer.append(stderr)
+
+                    for line in stdout.decode('utf-8').splitlines():
+                        self.log.info(line)
+                    for line in stderr.decode('utf-8').splitlines():
+                        self.log.warning(line)
+                except WinRMOperationTimeoutError as e:
+                    # this is an expected error when waiting for a
+                    # long-running process, just silently retry
+                    pass
+
             self.winrm_hook.winrm_protocol.cleanup_command(winrm_client, command_id)
-            self.log.info("Cleaning up WinRM protocol shell")
             self.winrm_hook.winrm_protocol.close_shell(winrm_client)
-            if status_code is 0:
-                return std_out.decode()
-
-            else:
-                error_msg = std_err.decode()
-                raise AirflowException("error running cmd: {0}, error: {1}"
-                                       .format(self.command, error_msg))
 
         except Exception as e:
             raise AirflowException("WinRM operator error: {0}".format(str(e)))
 
+        if return_code is 0:
+            # returning output if do_xcom_push is set
+            if self.do_xcom_push:
+                enable_pickling = configuration.conf.getboolean(
+                    'core', 'enable_xcom_pickling'
+                )
+                if enable_pickling:
+                    return stdout_buffer
+                else:
+                    return b64encode(b''.join(stdout_buffer)).decode('utf-8')
+        else:
+            error_msg = "Error running cmd: {0}, return code: {1}, error: {2}".format(
+                self.command,
+                return_code,
+                b''.join(stderr_buffer).decode('utf-8')
+            )
+            raise AirflowException(error_msg)
+
+        self.log.info("Finished!")
+
         return True

From 99b35b61898a6808b4a2c35619e5876cf90aebfe Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Wed, 26 Dec 2018 11:00:08 +0100
Subject: [PATCH 500/808] [AIRFLOW-3556] Add cross join set dependency function
 (#4356)

---
 airflow/utils/helpers.py    | 31 +++++++++++++++++++++++++++++++
 tests/utils/test_helpers.py | 17 ++++++++++++++++-
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 167168fb9f122..5f3216a6da323 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -172,6 +172,37 @@ def chain(*tasks):
         up_task.set_downstream(down_task)
 
 
+def cross_downstream(from_tasks, to_tasks):
+    """
+    Set downstream dependencies for all tasks in from_tasks to all tasks in to_tasks.
+    E.g.: cross_downstream(from_tasks=[t1, t2, t3], to_tasks=[t4, t5, t6])
+    Is equivalent to:
+
+    t1 --> t4
+       \ /
+    t2 -X> t5
+       / \
+    t3 --> t6
+
+    t1.set_downstream(t4)
+    t1.set_downstream(t5)
+    t1.set_downstream(t6)
+    t2.set_downstream(t4)
+    t2.set_downstream(t5)
+    t2.set_downstream(t6)
+    t3.set_downstream(t4)
+    t3.set_downstream(t5)
+    t3.set_downstream(t6)
+
+    :param from_tasks: List of tasks to start from.
+    :type from_tasks: List[airflow.models.BaseOperator]
+    :param to_tasks: List of tasks to set as downstream dependencies.
+    :type to_tasks: List[airflow.models.BaseOperator]
+    """
+    for task in from_tasks:
+        task.set_downstream(to_tasks)
+
+
 def pprinttable(rows):
     """Returns a pretty ascii table from tuples
 
diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index 4cb3e1a1fc8e1..837a79acbaebb 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -20,11 +20,16 @@
 import logging
 import multiprocessing
 import os
-import psutil
 import signal
 import time
 import unittest
+from datetime import datetime
+
+import psutil
+import six
 
+from airflow import DAG
+from airflow.operators.dummy_operator import DummyOperator
 from airflow.utils import helpers
 
 
@@ -210,6 +215,16 @@ def test_is_container(self):
         # Pass an object that is not iter nor a string.
         self.assertFalse(helpers.is_container(10))
 
+    def test_cross_downstream(self):
+        """Test if all dependencies between tasks are all set correctly."""
+        dag = DAG(dag_id="test_dag", start_date=datetime.now())
+        start_tasks = [DummyOperator(task_id="t{i}".format(i=i), dag=dag) for i in range(1, 4)]
+        end_tasks = [DummyOperator(task_id="t{i}".format(i=i), dag=dag) for i in range(4, 7)]
+        helpers.cross_downstream(from_tasks=start_tasks, to_tasks=end_tasks)
+
+        for start_task in start_tasks:
+            six.assertCountEqual(self, start_task.get_direct_relatives(upstream=False), end_tasks)
+
 
 if __name__ == '__main__':
     unittest.main()

From c4c5b234d7d06e06897b7ffcf8153a64ef55fc31 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Mon, 5 Nov 2018 19:41:14 +0100
Subject: [PATCH 501/808] [AIRFLOW-2780] Add IMAP Hook to retrieve email
 attachments (#4119)

[AIRFLOW-2780] Add IMAP Hook to retrieve email attachments
- Add has_mail_attachments to check if there are mail attachments in the given mailbox with the given attachment name
- Add retrieve_mail_attachments to download the attachments to a local directory
- Add some test cases but more are coming
- Add license header
- Change retrieve_mail_attachments to download_mail_attachments
- Add retrieve_mail_attachments that return a list of tuple containing the attachments found
- Change IMAP4_SSL close() method to be called after retrieving the attachments and not before logging out
- Change test_connect to not check for close method because no mail folder will be opened when only connecting
- Add some test cases that are still in WIP
- Fixes a bug causing multiple attachments in a single mail not being correctly added to the all mails attachments
- Fixes a bug where MailPart is_attachment always returns None
- Add logging when an attachment has been found that matches the name
- Add more test cases with sample mail
---
 docs/code.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/code.rst b/docs/code.rst
index 22fe6c043d25a..6ddde6554c6d1 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -474,7 +474,6 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
 .. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
-.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
 .. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
 .. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook

From 0083eca4ef45cb50f613cf49c450f0a694567434 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Sun, 11 Nov 2018 23:24:56 +0100
Subject: [PATCH 502/808] [AIRFLOW-3315] Add ImapAttachmentSensor (#4161)

- update license header in imap_hook and test_imap_hook
---
 airflow/contrib/hooks/imap_hook.py            |  23 ++--
 .../contrib/sensors/imap_attachment_sensor.py |  76 +++++++++++
 docs/code.rst                                 |   1 +
 tests/contrib/hooks/test_imap_hook.py         |  23 ++--
 .../sensors/test_imap_attachment_sensor.py    | 124 ++++++++++++++++++
 5 files changed, 229 insertions(+), 18 deletions(-)
 create mode 100644 airflow/contrib/sensors/imap_attachment_sensor.py
 create mode 100644 tests/contrib/sensors/test_imap_attachment_sensor.py

diff --git a/airflow/contrib/hooks/imap_hook.py b/airflow/contrib/hooks/imap_hook.py
index c0b3126a8f382..f028d3dda0911 100644
--- a/airflow/contrib/hooks/imap_hook.py
+++ b/airflow/contrib/hooks/imap_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 import email
 import imaplib
diff --git a/airflow/contrib/sensors/imap_attachment_sensor.py b/airflow/contrib/sensors/imap_attachment_sensor.py
new file mode 100644
index 0000000000000..c0eb9b6cd22c3
--- /dev/null
+++ b/airflow/contrib/sensors/imap_attachment_sensor.py
@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.imap_hook import ImapHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class ImapAttachmentSensor(BaseSensorOperator):
+    """
+    Waits for a specific attachment on a mail server.
+
+    :param attachment_name: The name of the attachment that will be checked.
+    :type attachment_name: str
+    :param check_regex: If set to True the attachment's name will be parsed as regular expression.
+                        Through this you can get a broader set of attachments
+                        that it will look for than just only the equality of the attachment name.
+                        The default value is False.
+    :type check_regex: bool
+    :param mail_folder: The mail folder in where to search for the attachment.
+                        The default value is 'INBOX'.
+    :type mail_folder: str
+    :param conn_id: The connection to run the sensor against.
+                    The default value is 'imap_default'.
+    :type conn_id: str
+    """
+    template_fields = ('attachment_name',)
+
+    @apply_defaults
+    def __init__(self,
+                 attachment_name,
+                 mail_folder='INBOX',
+                 check_regex=False,
+                 conn_id='imap_default',
+                 *args,
+                 **kwargs):
+        super(ImapAttachmentSensor, self).__init__(*args, **kwargs)
+
+        self.attachment_name = attachment_name
+        self.mail_folder = mail_folder
+        self.check_regex = check_regex
+        self.conn_id = conn_id
+
+    def poke(self, context):
+        """
+        Pokes for a mail attachment on the mail server.
+
+        :param context: The context that is being provided when poking.
+        :type context: dict
+        :return: True if attachment with the given name is present and False if not.
+        :rtype: bool
+        """
+        self.log.info('Poking for %s', self.attachment_name)
+
+        with ImapHook(imap_conn_id=self.conn_id) as imap_hook:
+            return imap_hook.has_mail_attachment(
+                name=self.attachment_name,
+                mail_folder=self.mail_folder,
+                check_regex=self.check_regex
+            )
diff --git a/docs/code.rst b/docs/code.rst
index 6ddde6554c6d1..46a40bc143f21 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -284,6 +284,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStoragePrefixSensor
 .. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorFolder
 .. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorRegex
+.. autoclass:: airflow.contrib.sensors.imap_attachment_sensor.ImapAttachmentSensor
 .. autoclass:: airflow.contrib.sensors.jira_sensor.JiraSensor
 .. autoclass:: airflow.contrib.sensors.pubsub_sensor.PubSubPullSensor
 .. autoclass:: airflow.contrib.sensors.python_sensor.PythonSensor
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index 63dc13a874e63..b4e4ff3ed76ee 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#   http://www.apache.org/licenses/LICENSE-2.0
 #
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
 
 import imaplib
 import unittest
diff --git a/tests/contrib/sensors/test_imap_attachment_sensor.py b/tests/contrib/sensors/test_imap_attachment_sensor.py
new file mode 100644
index 0000000000000..297de02a99b49
--- /dev/null
+++ b/tests/contrib/sensors/test_imap_attachment_sensor.py
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from mock import patch, Mock
+
+from airflow import configuration, models
+from airflow.contrib.sensors.imap_attachment_sensor import ImapAttachmentSensor
+from airflow.utils import db
+
+imap_hook_string = 'airflow.contrib.sensors.imap_attachment_sensor.ImapHook'
+
+
+class TestImapAttachmentSensor(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            models.Connection(
+                conn_id='imap_test',
+                host='base_url',
+                login='user',
+                password='password'
+            )
+        )
+
+    @patch(imap_hook_string)
+    def test_poke_with_attachment_found(self, mock_imap_hook):
+        mock_imap_hook.return_value.__enter__ = Mock(return_value=mock_imap_hook)
+        mock_imap_hook.has_mail_attachment.return_value = True
+
+        imap_attachment_sensor = ImapAttachmentSensor(
+            conn_id='imap_test',
+            attachment_name='test_attachment',
+            task_id='check_for_attachment_on_mail_server_test',
+            dag=None
+        )
+
+        self.assertTrue(imap_attachment_sensor.poke(context={}))
+        mock_imap_hook.has_mail_attachment.assert_called_once_with(
+            name='test_attachment',
+            mail_folder='INBOX',
+            check_regex=False
+        )
+
+    @patch(imap_hook_string)
+    def test_poke_with_attachment_not_found(self, mock_imap_hook):
+        mock_imap_hook.return_value.__enter__ = Mock(return_value=mock_imap_hook)
+        mock_imap_hook.has_mail_attachment.return_value = False
+
+        imap_attachment_sensor = ImapAttachmentSensor(
+            conn_id='imap_test',
+            attachment_name='test_attachment',
+            task_id='check_for_attachment_on_mail_server_test',
+            dag=None
+        )
+
+        self.assertFalse(imap_attachment_sensor.poke(context={}))
+        mock_imap_hook.has_mail_attachment.assert_called_once_with(
+            name='test_attachment',
+            mail_folder='INBOX',
+            check_regex=False
+        )
+
+    @patch(imap_hook_string)
+    def test_poke_with_check_regex_true(self, mock_imap_hook):
+        mock_imap_hook.return_value.__enter__ = Mock(return_value=mock_imap_hook)
+        mock_imap_hook.has_mail_attachment.return_value = True
+
+        imap_attachment_sensor = ImapAttachmentSensor(
+            conn_id='imap_test',
+            attachment_name='.*_test_attachment',
+            task_id='check_for_attachment_on_mail_server_test',
+            check_regex=True,
+            dag=None
+        )
+
+        self.assertTrue(imap_attachment_sensor.poke(context={}))
+        mock_imap_hook.has_mail_attachment.assert_called_once_with(
+            name='.*_test_attachment',
+            mail_folder='INBOX',
+            check_regex=True
+        )
+
+    @patch(imap_hook_string)
+    def test_poke_with_different_mail_folder(self, mock_imap_hook):
+        mock_imap_hook.return_value.__enter__ = Mock(return_value=mock_imap_hook)
+        mock_imap_hook.has_mail_attachment.return_value = True
+
+        imap_attachment_sensor = ImapAttachmentSensor(
+            conn_id='imap_test',
+            attachment_name='test_attachment',
+            task_id='check_for_attachment_on_mail_server_test',
+            mail_folder='test',
+            dag=None
+        )
+
+        self.assertTrue(imap_attachment_sensor.poke(context={}))
+        mock_imap_hook.has_mail_attachment.assert_called_once_with(
+            name='test_attachment',
+            mail_folder='test',
+            check_regex=False
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

From 6a890ee19fe9fe7f3fc4dd434857ff4c34aeb6b6 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Tue, 8 Jan 2019 12:12:08 -0500
Subject: [PATCH 503/808] [AIRFLOW-3631] Update flake8 and fix lint. (#4436)

---
 .flake8                                            |  2 +-
 airflow/config_templates/default_celery.py         |  4 ++--
 airflow/contrib/executors/kubernetes_executor.py   |  2 +-
 airflow/contrib/hooks/gcp_dataflow_hook.py         |  2 +-
 airflow/contrib/hooks/spark_submit_hook.py         |  6 +++---
 airflow/contrib/operators/winrm_operator.py        |  2 +-
 airflow/contrib/sensors/ftp_sensor.py              |  2 +-
 airflow/hooks/hive_hooks.py                        |  2 +-
 airflow/hooks/webhdfs_hook.py                      |  4 ++--
 airflow/lineage/datasets.py                        |  2 +-
 airflow/operators/check_operator.py                |  2 +-
 airflow/operators/hive_operator.py                 |  2 +-
 airflow/operators/pig_operator.py                  |  2 +-
 airflow/security/utils.py                          |  2 +-
 airflow/sensors/hdfs_sensor.py                     |  2 +-
 airflow/settings.py                                | 14 +++++++-------
 airflow/utils/dates.py                             |  6 ++----
 airflow/utils/helpers.py                           |  2 +-
 airflow/utils/module_loading.py                    |  2 +-
 airflow/utils/tests.py                             |  2 +-
 airflow/www/views.py                               |  2 +-
 airflow/www_rbac/views.py                          |  6 +++---
 setup.py                                           |  3 ++-
 .../contrib/executors/test_kubernetes_executor.py  |  2 +-
 tests/contrib/hooks/test_imap_hook.py              | 12 ++++++------
 tests/contrib/minikube/test_kubernetes_executor.py |  2 +-
 .../contrib/operators/test_databricks_operator.py  |  8 ++++----
 tests/contrib/sensors/test_hdfs_sensor.py          |  2 +-
 tests/core.py                                      |  2 +-
 tests/jobs.py                                      |  2 +-
 tox.ini                                            |  2 +-
 31 files changed, 53 insertions(+), 54 deletions(-)

diff --git a/.flake8 b/.flake8
index 2723df1f10969..e2ba4cbf6f631 100644
--- a/.flake8
+++ b/.flake8
@@ -1,3 +1,3 @@
 [flake8]
 max-line-length = 110
-ignore = E731
+ignore = E731,W504
diff --git a/airflow/config_templates/default_celery.py b/airflow/config_templates/default_celery.py
index 000545f1dd257..7a9fd25064b8a 100644
--- a/airflow/config_templates/default_celery.py
+++ b/airflow/config_templates/default_celery.py
@@ -55,7 +55,7 @@ def _broker_supports_visibility_timeout(url):
 celery_ssl_active = False
 try:
     celery_ssl_active = configuration.conf.getboolean('celery', 'SSL_ACTIVE')
-except AirflowConfigException as e:
+except AirflowConfigException:
     log.warning("Celery Executor will run without SSL")
 
 try:
@@ -75,7 +75,7 @@ def _broker_supports_visibility_timeout(url):
                                    'Please use RabbitMQ or Redis if you would like to use SSL for broker.')
 
         DEFAULT_CELERY_CONFIG['broker_use_ssl'] = broker_use_ssl
-except AirflowConfigException as e:
+except AirflowConfigException:
     raise AirflowException('AirflowConfigException: SSL_ACTIVE is True, '
                            'please ensure SSL_KEY, '
                            'SSL_CERT and SSL_CACERT are set')
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 222b196e88a61..f548beb4b530f 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -443,7 +443,7 @@ def _strip_unsafe_kubernetes_special_chars(string):
 
     @staticmethod
     def _make_safe_pod_id(safe_dag_id, safe_task_id, safe_uuid):
-        """
+        r"""
         Kubernetes pod names must be <= 253 chars and must pass the following regex for
         validation
         "^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$"
diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 8d07b0514e22d..d02a98c5e4b12 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -141,7 +141,7 @@ def _line(self, fd):
     def _extract_job(line):
         # Job id info: https://goo.gl/SE29y9.
         job_id_pattern = re.compile(
-            b'.*console.cloud.google.com/dataflow.*/jobs/([a-z|0-9|A-Z|\-|\_]+).*')
+            br'.*console.cloud.google.com/dataflow.*/jobs/([a-z|0-9|A-Z|\-|\_]+).*')
         matched_job = job_id_pattern.search(line or '')
         if matched_job:
             return matched_job.group(1).decode()
diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 8f6122dca299b..20bd2547e698e 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -390,14 +390,14 @@ def _process_spark_submit_log(self, itr):
             # If we run Kubernetes cluster mode, we want to extract the driver pod id
             # from the logs so we can kill the application when we stop it unexpectedly
             elif self._is_kubernetes:
-                match = re.search('\s*pod name: ((.+?)-([a-z0-9]+)-driver)', line)
+                match = re.search(r'\s*pod name: ((.+?)-([a-z0-9]+)-driver)', line)
                 if match:
                     self._kubernetes_driver_pod = match.groups()[0]
                     self.log.info("Identified spark driver pod: %s",
                                   self._kubernetes_driver_pod)
 
                 # Store the Spark Exit code
-                match_exit_code = re.search('\s*Exit code: (\d+)', line)
+                match_exit_code = re.search(r'\s*Exit code: (\d+)', line)
                 if match_exit_code:
                     self._spark_exit_code = int(match_exit_code.groups()[0])
 
@@ -405,7 +405,7 @@ def _process_spark_submit_log(self, itr):
             # we need to extract the driver id from the logs. This allows us to poll for
             # the status using the driver id. Also, we can kill the driver when needed.
             elif self._should_track_driver_status and not self._driver_id:
-                match_driver_id = re.search('(driver-[0-9\-]+)', line)
+                match_driver_id = re.search(r'(driver-[0-9\-]+)', line)
                 if match_driver_id:
                     self._driver_id = match_driver_id.groups()[0]
                     self.log.info("identified spark driver id: {}"
diff --git a/airflow/contrib/operators/winrm_operator.py b/airflow/contrib/operators/winrm_operator.py
index c81acac44f6aa..e8366b809da20 100644
--- a/airflow/contrib/operators/winrm_operator.py
+++ b/airflow/contrib/operators/winrm_operator.py
@@ -115,7 +115,7 @@ def execute(self, context):
                         self.log.info(line)
                     for line in stderr.decode('utf-8').splitlines():
                         self.log.warning(line)
-                except WinRMOperationTimeoutError as e:
+                except WinRMOperationTimeoutError:
                     # this is an expected error when waiting for a
                     # long-running process, just silently retry
                     pass
diff --git a/airflow/contrib/sensors/ftp_sensor.py b/airflow/contrib/sensors/ftp_sensor.py
index c419a46beb4bb..4773b15989299 100644
--- a/airflow/contrib/sensors/ftp_sensor.py
+++ b/airflow/contrib/sensors/ftp_sensor.py
@@ -34,7 +34,7 @@ class FTPSensor(BaseSensorOperator):
     """Errors that are transient in nature, and where action can be retried"""
     transient_errors = [421, 425, 426, 434, 450, 451, 452]
 
-    error_code_pattern = re.compile("([\d]+)")
+    error_code_pattern = re.compile(r"([\d]+)")
 
     @apply_defaults
     def __init__(
diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index 65c46d6e54562..b934ad038917b 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -289,7 +289,7 @@ def test_hql(self, hql):
                 except AirflowException as e:
                     message = e.args[0].split('\n')[-2]
                     self.log.info(message)
-                    error_loc = re.search('(\d+):(\d+)', message)
+                    error_loc = re.search(r'(\d+):(\d+)', message)
                     if error_loc and error_loc.group(1).isdigit():
                         lst = int(error_loc.group(1))
                         begin = max(lst - 2, 0)
diff --git a/airflow/hooks/webhdfs_hook.py b/airflow/hooks/webhdfs_hook.py
index c4dbe8be6505a..9833be6cd6e6c 100644
--- a/airflow/hooks/webhdfs_hook.py
+++ b/airflow/hooks/webhdfs_hook.py
@@ -67,7 +67,7 @@ def get_conn(self):
             except HdfsError as e:
                 self.log.debug(
                     "Read operation on namenode {nn.host} "
-                    "failed with error: {e}".format(**locals())
+                    "failed with error: {e}".format(nn=nn, e=e)
                 )
         nn_hosts = [c.host for c in nn_connections]
         no_nn_error = "Read operations failed " \
@@ -83,7 +83,7 @@ def check_for_path(self, hdfs_path):
 
     def load_file(self, source, destination, overwrite=True, parallelism=1,
                   **kwargs):
-        """
+        r"""
         Uploads a file to HDFS
 
         :param source: Local path to file or folder. If a folder, all the files
diff --git a/airflow/lineage/datasets.py b/airflow/lineage/datasets.py
index 40c8edc9a8f9d..49dd492bb775a 100644
--- a/airflow/lineage/datasets.py
+++ b/airflow/lineage/datasets.py
@@ -96,7 +96,7 @@ def map_type(name):
             if cls.type_name == name:
                 return cls
 
-        raise NotImplemented("No known mapping for {}".format(name))
+        raise NotImplementedError("No known mapping for {}".format(name))
 
 
 class DataBase(DataSet):
diff --git a/airflow/operators/check_operator.py b/airflow/operators/check_operator.py
index a0d213cf6619c..d60bbb4a06850 100644
--- a/airflow/operators/check_operator.py
+++ b/airflow/operators/check_operator.py
@@ -158,7 +158,7 @@ def execute(self, context=None):
         elif is_numeric_value_check:
             try:
                 num_rec = [float(r) for r in records]
-            except (ValueError, TypeError) as e:
+            except (ValueError, TypeError):
                 cvestr = "Converting a result to float failed.\n"
                 raise AirflowException(cvestr + except_temp.format(**locals()))
             if self.has_tolerance:
diff --git a/airflow/operators/hive_operator.py b/airflow/operators/hive_operator.py
index bd727039b9f52..cc9157a20758c 100644
--- a/airflow/operators/hive_operator.py
+++ b/airflow/operators/hive_operator.py
@@ -110,7 +110,7 @@ def get_hook(self):
     def prepare_template(self):
         if self.hiveconf_jinja_translate:
             self.hql = re.sub(
-                "(\$\{(hiveconf:)?([ a-zA-Z0-9_]*)\})", "{{ \g<3> }}", self.hql)
+                r"(\$\{(hiveconf:)?([ a-zA-Z0-9_]*)\})", r"{{ \g<3> }}", self.hql)
         if self.script_begin_tag and self.script_begin_tag in self.hql:
             self.hql = "\n".join(self.hql.split(self.script_begin_tag)[1:])
 
diff --git a/airflow/operators/pig_operator.py b/airflow/operators/pig_operator.py
index d22f19f70921e..8603068f87398 100644
--- a/airflow/operators/pig_operator.py
+++ b/airflow/operators/pig_operator.py
@@ -62,7 +62,7 @@ def get_hook(self):
     def prepare_template(self):
         if self.pigparams_jinja_translate:
             self.pig = re.sub(
-                "(\$([a-zA-Z_][a-zA-Z0-9_]*))", "{{ \g<2> }}", self.pig)
+                r"(\$([a-zA-Z_][a-zA-Z0-9_]*))", r"{{ \g<2> }}", self.pig)
 
     def execute(self, context):
         self.log.info('Executing: %s', self.pig)
diff --git a/airflow/security/utils.py b/airflow/security/utils.py
index d46c03af99a0f..e10510e24eb71 100644
--- a/airflow/security/utils.py
+++ b/airflow/security/utils.py
@@ -30,7 +30,7 @@ def get_components(principal):
     """
     if not principal:
         return None
-    return re.split('[\/@]', str(principal))
+    return re.split(r'[\/@]', str(principal))
 
 
 def replace_hostname_pattern(components, host=None):
diff --git a/airflow/sensors/hdfs_sensor.py b/airflow/sensors/hdfs_sensor.py
index 4d95556f47a8d..298ac48aecc6c 100644
--- a/airflow/sensors/hdfs_sensor.py
+++ b/airflow/sensors/hdfs_sensor.py
@@ -87,7 +87,7 @@ def filter_for_ignored_ext(result, ignored_ext, ignore_copying):
         """
         if ignore_copying:
             log = LoggingMixin().log
-            regex_builder = "^.*\.(%s$)$" % '$|'.join(ignored_ext)
+            regex_builder = r"^.*\.(%s$)$" % '$|'.join(ignored_ext)
             ignored_extensions_regex = re.compile(regex_builder)
             log.debug(
                 'Filtering result for ignored extensions: %s in files %s',
diff --git a/airflow/settings.py b/airflow/settings.py
index 69622ba15afff..5cda472565888 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -82,13 +82,13 @@ def timing(cls, stat, dt):
 else:
     Stats = DummyStatsLogger
 
-HEADER = """\
-  ____________       _____________
- ____    |__( )_________  __/__  /________      __
-____  /| |_  /__  ___/_  /_ __  /_  __ \_ | /| / /
-___  ___ |  / _  /   _  __/ _  / / /_/ /_ |/ |/ /
- _/_/  |_/_/  /_/    /_/    /_/  \____/____/|__/
- """
+HEADER = '\n'.join([
+    r'  ____________       _____________',
+    r' ____    |__( )_________  __/__  /________      __',
+    r'____  /| |_  /__  ___/_  /_ __  /_  __ \_ | /| / /',
+    r'___  ___ |  / _  /   _  __/ _  / / /_/ /_ |/ |/ /',
+    r' _/_/  |_/_/  /_/    /_/    /_/  \____/____/|__/',
+])
 
 LOGGING_LEVEL = logging.INFO
 
diff --git a/airflow/utils/dates.py b/airflow/utils/dates.py
index 3393de0311491..6926535930681 100644
--- a/airflow/utils/dates.py
+++ b/airflow/utils/dates.py
@@ -24,7 +24,7 @@
 
 from airflow.utils import timezone
 from datetime import datetime, timedelta
-from dateutil.relativedelta import relativedelta  # flake8: noqa: F401 for doctest
+from dateutil.relativedelta import relativedelta  # noqa: F401 for doctest
 import six
 
 from croniter import croniter
@@ -175,9 +175,7 @@ def round_time(dt, delta, start_date=timezone.make_aware(datetime.min)):
         if start_date + (lower + 1) * delta >= dt:
             # Check if start_date + (lower + 1)*delta or
             # start_date + lower*delta is closer to dt and return the solution
-            if (
-                (start_date + (lower + 1) * delta) - dt <=
-                dt - (start_date + lower * delta)):
+            if (start_date + (lower + 1) * delta) - dt <= dt - (start_date + lower * delta):
                 return start_date + (lower + 1) * delta
             else:
                 return start_date + lower * delta
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 5f3216a6da323..c8afff3f52b06 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -173,7 +173,7 @@ def chain(*tasks):
 
 
 def cross_downstream(from_tasks, to_tasks):
-    """
+    r"""
     Set downstream dependencies for all tasks in from_tasks to all tasks in to_tasks.
     E.g.: cross_downstream(from_tasks=[t1, t2, t3], to_tasks=[t4, t5, t6])
     Is equivalent to:
diff --git a/airflow/utils/module_loading.py b/airflow/utils/module_loading.py
index 6e638b00d3318..51c6adf4e642c 100644
--- a/airflow/utils/module_loading.py
+++ b/airflow/utils/module_loading.py
@@ -48,7 +48,7 @@ def import_string(dotted_path):
 
     try:
         return getattr(module, class_name)
-    except AttributeError as err:
+    except AttributeError:
         raise ImportError('Module "{}" does not define a "{}" attribute/class'.format(
             module_path, class_name)
         )
diff --git a/airflow/utils/tests.py b/airflow/utils/tests.py
index 954ac35f786c6..6604bb1987db2 100644
--- a/airflow/utils/tests.py
+++ b/airflow/utils/tests.py
@@ -35,5 +35,5 @@ def skipUnlessImported(module, obj):
 
 def assertEqualIgnoreMultipleSpaces(case, first, second, msg=None):
     def _trim(s):
-        re.sub("\s+", " ", s.strip())
+        re.sub(r"\s+", " ", s.strip())
     return case.assertEqual(_trim(first), _trim(second), msg)
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 7e146281c26a9..7c9ec0192a72b 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -478,7 +478,7 @@ def chart_data(self):
                         df[df.columns[x_col]])
                     df[df.columns[x_col]] = df[df.columns[x_col]].apply(
                         lambda x: int(x.strftime("%s")) * 1000)
-                except Exception as e:
+                except Exception:
                     payload['error'] = "Time conversion failed"
 
             if chart_type == 'datatable':
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index e89575f1cbdd0..83865c1ec437c 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -2256,7 +2256,7 @@ def action_set_failed(self, drs, session=None):
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
                 "were set to failed".format(**locals()))
-        except Exception as ex:
+        except Exception:
             flash('Failed to set state', 'error')
         return redirect(self.route_base + '/list')
 
@@ -2284,7 +2284,7 @@ def action_set_success(self, drs, session=None):
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
                 "were set to success".format(**locals()))
-        except Exception as ex:
+        except Exception:
             flash('Failed to set state', 'error')
         return redirect(self.route_base + '/list')
 
@@ -2392,7 +2392,7 @@ def set_task_instance_state(self, tis, target_state, session=None):
             session.commit()
             flash(
                 "{count} task instances were set to '{target_state}'".format(**locals()))
-        except Exception as ex:
+        except Exception:
             flash('Failed to set state', 'error')
 
     @action('set_running', "Set state to 'running'", '', single=False)
diff --git a/setup.py b/setup.py
index cd9bb3aa7b784..e4bacfe790c23 100644
--- a/setup.py
+++ b/setup.py
@@ -264,7 +264,8 @@ def write_version(filename=os.path.join(*['airflow',
     'pywinrm',
     'qds-sdk>=1.9.6',
     'rednose',
-    'requests_mock'
+    'requests_mock',
+    'flake8>=3.6.0',
 ]
 devel_minreq = devel + kubernetes + mysql + doc + password + s3 + cgroups
 devel_hadoop = devel_minreq + hive + hdfs + webhdfs + kerberos
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index d67b9b23b4a76..8bd4bd35c86eb 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -57,7 +57,7 @@ def _cases(self):
 
     @staticmethod
     def _is_valid_name(name):
-        regex = "^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$"
+        regex = r"^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$"
         return (
             len(name) <= 253 and
             all(ch.lower() == ch for ch in name) and
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index b4e4ff3ed76ee..da80e890cf672 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -99,7 +99,7 @@ def test_has_mail_attachments_with_regex_found(self, mock_imaplib):
 
         with ImapHook() as imap_hook:
             has_attachment_in_inbox = imap_hook.has_mail_attachment(
-                name='test(\d+).csv',
+                name=r'test(\d+).csv',
                 check_regex=True
             )
 
@@ -111,7 +111,7 @@ def test_has_mail_attachments_with_regex_not_found(self, mock_imaplib):
 
         with ImapHook() as imap_hook:
             has_attachment_in_inbox = imap_hook.has_mail_attachment(
-                name='test_(\d+).csv',
+                name=r'test_(\d+).csv',
                 check_regex=True
             )
 
@@ -141,7 +141,7 @@ def test_retrieve_mail_attachments_with_regex_found(self, mock_imaplib):
 
         with ImapHook() as imap_hook:
             attachments_in_inbox = imap_hook.retrieve_mail_attachments(
-                name='test(\d+).csv',
+                name=r'test(\d+).csv',
                 check_regex=True
             )
 
@@ -153,7 +153,7 @@ def test_retrieve_mail_attachments_with_regex_not_found(self, mock_imaplib):
 
         with ImapHook() as imap_hook:
             attachments_in_inbox = imap_hook.retrieve_mail_attachments(
-                name='test_(\d+).csv',
+                name=r'test_(\d+).csv',
                 check_regex=True
             )
 
@@ -200,7 +200,7 @@ def test_download_mail_attachments_with_regex_found(self, mock_imaplib, mock_ope
 
         with ImapHook() as imap_hook:
             imap_hook.download_mail_attachments(
-                name='test(\d+).csv',
+                name=r'test(\d+).csv',
                 local_output_directory='test_directory',
                 check_regex=True
             )
@@ -215,7 +215,7 @@ def test_download_mail_attachments_with_regex_not_found(self, mock_imaplib, mock
 
         with ImapHook() as imap_hook:
             imap_hook.download_mail_attachments(
-                name='test_(\d+).csv',
+                name=r'test_(\d+).csv',
                 local_output_directory='test_directory',
                 check_regex=True
             )
diff --git a/tests/contrib/minikube/test_kubernetes_executor.py b/tests/contrib/minikube/test_kubernetes_executor.py
index 58d28a60070ae..fad358205fc93 100644
--- a/tests/contrib/minikube/test_kubernetes_executor.py
+++ b/tests/contrib/minikube/test_kubernetes_executor.py
@@ -54,7 +54,7 @@ class KubernetesExecutorTest(unittest.TestCase):
     def _delete_airflow_pod():
         air_pod = check_output(['kubectl', 'get', 'pods']).decode()
         air_pod = air_pod.split('\n')
-        names = [re.compile('\s+').split(x)[0] for x in air_pod if 'airflow' in x]
+        names = [re.compile(r'\s+').split(x)[0] for x in air_pod if 'airflow' in x]
         if names:
             check_call(['kubectl', 'delete', 'pod', names[0]])
 
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index af62a3e4c3406..56440cddf6f04 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -185,8 +185,8 @@ def test_init_with_bad_type(self):
             'test': datetime.now()
         }
         # Looks a bit weird since we have to escape regex reserved symbols.
-        exception_message = 'Type \<(type|class) \'datetime.datetime\'\> used ' + \
-                            'for parameter json\[test\] is not a number or a string'
+        exception_message = r'Type \<(type|class) \'datetime.datetime\'\> used ' + \
+                            r'for parameter json\[test\] is not a number or a string'
         with self.assertRaisesRegexp(AirflowException, exception_message):
             DatabricksSubmitRunOperator(task_id=TASK_ID, json=json)
 
@@ -352,8 +352,8 @@ def test_init_with_bad_type(self):
             'test': datetime.now()
         }
         # Looks a bit weird since we have to escape regex reserved symbols.
-        exception_message = 'Type \<(type|class) \'datetime.datetime\'\> used ' + \
-                            'for parameter json\[test\] is not a number or a string'
+        exception_message = r'Type \<(type|class) \'datetime.datetime\'\> used ' + \
+                            r'for parameter json\[test\] is not a number or a string'
         with self.assertRaisesRegexp(AirflowException, exception_message):
             DatabricksRunNowOperator(task_id=TASK_ID, job_id=JOB_ID, json=json)
 
diff --git a/tests/contrib/sensors/test_hdfs_sensor.py b/tests/contrib/sensors/test_hdfs_sensor.py
index f72d9834477d0..b03b738686ed8 100644
--- a/tests/contrib/sensors/test_hdfs_sensor.py
+++ b/tests/contrib/sensors/test_hdfs_sensor.py
@@ -236,7 +236,7 @@ def test_should_match_regex_but_copyingext(self):
         self.log.debug('#' * 10)
         self.log.debug('Running %s', self._testMethodName)
         self.log.debug('#' * 10)
-        compiled_regex = re.compile("copying_file_\d+.txt")
+        compiled_regex = re.compile(r"copying_file_\d+.txt")
         task = HdfsSensorRegex(task_id='Should_match_the_regex_but_filesize',
                                filepath='/datadirectory/regex_dir',
                                regex=compiled_regex,
diff --git a/tests/core.py b/tests/core.py
index e773030d58ad9..d07ca10c9d84a 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1211,7 +1211,7 @@ def test_cli_connections_list(self):
                         new_callable=six.StringIO) as mock_stdout:
             cli.connections(self.parser.parse_args(['connections', '--list']))
             stdout = mock_stdout.getvalue()
-        conns = [[x.strip("'") for x in re.findall("'\w+'", line)[:2]]
+        conns = [[x.strip("'") for x in re.findall(r"'\w+'", line)[:2]]
                  for ii, line in enumerate(stdout.split('\n'))
                  if ii % 2 == 1]
         conns = [conn for conn in conns if len(conn) > 0]
diff --git a/tests/jobs.py b/tests/jobs.py
index 15daeaca7a61b..66920bf523366 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -3223,7 +3223,7 @@ def test_dag_get_active_runs(self):
 
         try:
             running_date = running_dates[0]
-        except Exception as _:
+        except Exception:
             running_date = 'Except'
 
         self.assertEqual(execution_date, running_date, 'Running Date must match Execution Date')
diff --git a/tox.ini b/tox.ini
index af7ba40d03273..ecedcf02d4a9e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -66,6 +66,6 @@ commands =
 basepython = python3
 
 deps =
-    flake8==3.5.0
+    flake8>=3.6.0
 
 commands = flake8

From b07ed8651f7fd81da5b9d357717b124672693cd4 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Fri, 25 Jan 2019 22:22:43 +0100
Subject: [PATCH 504/808] [AIRFLOW-3602] Improve ImapHook handling of
 retrieving no attachments (#4475)

---
 airflow/contrib/hooks/imap_hook.py    | 83 ++++++++++++++++++---------
 tests/contrib/hooks/test_imap_hook.py | 53 +++++++++--------
 2 files changed, 83 insertions(+), 53 deletions(-)

diff --git a/airflow/contrib/hooks/imap_hook.py b/airflow/contrib/hooks/imap_hook.py
index f028d3dda0911..1bc19fcdac380 100644
--- a/airflow/contrib/hooks/imap_hook.py
+++ b/airflow/contrib/hooks/imap_hook.py
@@ -19,10 +19,10 @@
 
 import email
 import imaplib
-import os
+import os.path
 import re
 
-from airflow import LoggingMixin
+from airflow import LoggingMixin, AirflowException
 from airflow.hooks.base_hook import BaseHook
 
 
@@ -30,9 +30,7 @@ class ImapHook(BaseHook):
     """
     This hook connects to a mail server by using the imap protocol.
 
-    :param imap_conn_id: The connection id that contains the information
-                         used to authenticate the client.
-                         The default value is 'imap_default'.
+    :param imap_conn_id: The connection id that contains the information used to authenticate the client.
     :type imap_conn_id: str
     """
 
@@ -55,49 +53,63 @@ def has_mail_attachment(self, name, mail_folder='INBOX', check_regex=False):
         :param name: The name of the attachment that will be searched for.
         :type name: str
         :param mail_folder: The mail folder where to look at.
-                            The default value is 'INBOX'.
         :type mail_folder: str
         :param check_regex: Checks the name for a regular expression.
-                            The default value is False.
         :type check_regex: bool
         :returns: True if there is an attachment with the given name and False if not.
         :rtype: bool
         """
-        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
+        mail_attachments = self._retrieve_mails_attachments_by_name(name,
+                                                                    mail_folder,
                                                                     check_regex,
                                                                     latest_only=True)
         return len(mail_attachments) > 0
 
-    def retrieve_mail_attachments(self, name, mail_folder='INBOX', check_regex=False,
-                                  latest_only=False):
+    def retrieve_mail_attachments(self,
+                                  name,
+                                  mail_folder='INBOX',
+                                  check_regex=False,
+                                  latest_only=False,
+                                  not_found_mode='raise'):
         """
         Retrieves mail's attachments in the mail folder by its name.
 
         :param name: The name of the attachment that will be downloaded.
         :type name: str
         :param mail_folder: The mail folder where to look at.
-                            The default value is 'INBOX'.
         :type mail_folder: str
         :param check_regex: Checks the name for a regular expression.
-                            The default value is False.
         :type check_regex: bool
         :param latest_only: If set to True it will only retrieve
                             the first matched attachment.
-                            The default value is False.
         :type latest_only: bool
+        :param not_found_mode: Specify what should happen if no attachment has been found.
+                               Supported values are 'raise', 'warn' and 'ignore'.
+                               If it is set to 'raise' it will raise an exception,
+                               if set to 'warn' it will only print a warning and
+                               if set to 'ignore' it won't notify you at all.
+        :type not_found_mode: str
         :returns: a list of tuple each containing the attachment filename and its payload.
         :rtype: a list of tuple
         """
-        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
+        mail_attachments = self._retrieve_mails_attachments_by_name(name,
+                                                                    mail_folder,
                                                                     check_regex,
                                                                     latest_only)
+        if not mail_attachments:
+            self._handle_not_found_mode(not_found_mode)
+
         return mail_attachments
 
-    def download_mail_attachments(self, name, local_output_directory, mail_folder='INBOX',
-                                  check_regex=False, latest_only=False):
+    def download_mail_attachments(self,
+                                  name,
+                                  local_output_directory,
+                                  mail_folder='INBOX',
+                                  check_regex=False,
+                                  latest_only=False,
+                                  not_found_mode='raise'):
         """
-        Downloads mail's attachments in the mail folder by its name
-        to the local directory.
+        Downloads mail's attachments in the mail folder by its name to the local directory.
 
         :param name: The name of the attachment that will be downloaded.
         :type name: str
@@ -105,22 +117,40 @@ def download_mail_attachments(self, name, local_output_directory, mail_folder='I
                                        where the files will be downloaded to.
         :type local_output_directory: str
         :param mail_folder: The mail folder where to look at.
-                            The default value is 'INBOX'.
         :type mail_folder: str
         :param check_regex: Checks the name for a regular expression.
-                            The default value is False.
         :type check_regex: bool
         :param latest_only: If set to True it will only download
                             the first matched attachment.
-                            The default value is False.
         :type latest_only: bool
+        :param not_found_mode: Specify what should happen if no attachment has been found.
+                               Supported values are 'raise', 'warn' and 'ignore'.
+                               If it is set to 'raise' it will raise an exception,
+                               if set to 'warn' it will only print a warning and
+                               if set to 'ignore' it won't notify you at all.
+        :type not_found_mode: str
         """
-        mail_attachments = self._retrieve_mails_attachments_by_name(name, mail_folder,
-                                                                    check_regex, latest_only)
+        mail_attachments = self._retrieve_mails_attachments_by_name(name,
+                                                                    mail_folder,
+                                                                    check_regex,
+                                                                    latest_only)
+
+        if not mail_attachments:
+            self._handle_not_found_mode(not_found_mode)
+
         self._create_files(mail_attachments, local_output_directory)
 
-    def _retrieve_mails_attachments_by_name(self, name, mail_folder, check_regex,
-                                            latest_only):
+    def _handle_not_found_mode(self, not_found_mode):
+        if not_found_mode is 'raise':
+            raise AirflowException('No mail attachments found!')
+        elif not_found_mode is 'warn':
+            self.log.warning('No mail attachments found!')
+        elif not_found_mode is 'ignore':
+            pass  # Do not notify if the attachment has not been found.
+        else:
+            self.log.error('Invalid "not_found_mode" %s', not_found_mode)
+
+    def _retrieve_mails_attachments_by_name(self, name, mail_folder, check_regex, latest_only):
         all_matching_attachments = []
 
         self.mail_client.select(mail_folder)
@@ -164,6 +194,8 @@ def _create_files(self, mail_attachments, local_output_directory):
                 self._create_file(name, payload, local_output_directory)
 
     def _is_symlink(self, name):
+        # IMPORTANT NOTE: os.path.islink is not working for windows symlinks
+        # See: https://stackoverflow.com/a/11068434
         return os.path.islink(name)
 
     def _is_escaping_current_directory(self, name):
@@ -210,7 +242,6 @@ def get_attachments_by_name(self, name, check_regex, find_first=False):
         :param check_regex: Checks the name for a regular expression.
         :type check_regex: bool
         :param find_first: If set to True it will only find the first match and then quit.
-                           The default value is False.
         :type find_first: bool
         :returns: a list of tuples each containing name and payload
                   where the attachments name matches the given name.
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index da80e890cf672..98919b03a81ca 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -22,7 +22,7 @@
 
 from mock import Mock, patch, mock_open
 
-from airflow import configuration, models
+from airflow import configuration, models, AirflowException
 from airflow.contrib.hooks.imap_hook import ImapHook
 from airflow.utils import db
 
@@ -131,9 +131,7 @@ def test_retrieve_mail_attachments_not_found(self, mock_imaplib):
         _create_fake_imap(mock_imaplib, with_mail=True)
 
         with ImapHook() as imap_hook:
-            attachments_in_inbox = imap_hook.retrieve_mail_attachments('test1.txt')
-
-        self.assertEquals(attachments_in_inbox, [])
+            self.assertRaises(AirflowException, imap_hook.retrieve_mail_attachments, 'test1.txt')
 
     @patch(imaplib_string)
     def test_retrieve_mail_attachments_with_regex_found(self, mock_imaplib):
@@ -152,12 +150,10 @@ def test_retrieve_mail_attachments_with_regex_not_found(self, mock_imaplib):
         _create_fake_imap(mock_imaplib, with_mail=True)
 
         with ImapHook() as imap_hook:
-            attachments_in_inbox = imap_hook.retrieve_mail_attachments(
-                name=r'test_(\d+).csv',
-                check_regex=True
-            )
-
-        self.assertEquals(attachments_in_inbox, [])
+            self.assertRaises(AirflowException,
+                              imap_hook.retrieve_mail_attachments,
+                              name=r'test_(\d+).csv',
+                              check_regex=True)
 
     @patch(imaplib_string)
     def test_retrieve_mail_attachments_latest_only(self, mock_imaplib):
@@ -180,7 +176,7 @@ def test_download_mail_attachments_found(self, mock_imaplib, mock_open_method):
             imap_hook.download_mail_attachments('test1.csv', 'test_directory')
 
         mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
-        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+        mock_open_method.return_value.write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
@@ -188,10 +184,11 @@ def test_download_mail_attachments_not_found(self, mock_imaplib, mock_open_metho
         _create_fake_imap(mock_imaplib, with_mail=True)
 
         with ImapHook() as imap_hook:
-            imap_hook.download_mail_attachments('test1.txt', 'test_directory')
+            self.assertRaises(AirflowException,
+                              imap_hook.download_mail_attachments, 'test1.txt', 'test_directory')
 
         mock_open_method.assert_not_called()
-        mock_open_method().write.assert_not_called()
+        mock_open_method.return_value.write.assert_not_called()
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
@@ -206,7 +203,7 @@ def test_download_mail_attachments_with_regex_found(self, mock_imaplib, mock_ope
             )
 
         mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
-        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+        mock_open_method.return_value.write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
@@ -214,14 +211,14 @@ def test_download_mail_attachments_with_regex_not_found(self, mock_imaplib, mock
         _create_fake_imap(mock_imaplib, with_mail=True)
 
         with ImapHook() as imap_hook:
-            imap_hook.download_mail_attachments(
-                name=r'test_(\d+).csv',
-                local_output_directory='test_directory',
-                check_regex=True
-            )
+            self.assertRaises(AirflowException,
+                              imap_hook.download_mail_attachments,
+                              name=r'test_(\d+).csv',
+                              local_output_directory='test_directory',
+                              check_regex=True)
 
         mock_open_method.assert_not_called()
-        mock_open_method().write.assert_not_called()
+        mock_open_method.return_value.write.assert_not_called()
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
@@ -236,7 +233,7 @@ def test_download_mail_attachments_with_latest_only(self, mock_imaplib, mock_ope
             )
 
         mock_open_method.assert_called_once_with('test_directory/test1.csv', 'wb')
-        mock_open_method().write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
+        mock_open_method.return_value.write.assert_called_once_with(b'SWQsTmFtZQoxLEZlbGl4')
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
@@ -245,26 +242,28 @@ def test_download_mail_attachments_with_escaping_chars(self, mock_imaplib, mock_
 
         with ImapHook() as imap_hook:
             imap_hook.download_mail_attachments(
-                name='test1.csv',
+                name='../test1.csv',
                 local_output_directory='test_directory'
             )
 
         mock_open_method.assert_not_called()
-        mock_open_method().write.assert_not_called()
+        mock_open_method.return_value.write.assert_not_called()
 
+    @patch('airflow.contrib.hooks.imap_hook.os.path.islink', return_value=True)
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
-    def test_download_mail_attachments_with_symlink(self, mock_imaplib, mock_open_method):
-        _create_fake_imap(mock_imaplib, with_mail=True, attachment_name='initrd.img')
+    def test_download_mail_attachments_with_symlink(self, mock_imaplib, mock_open_method, mock_is_symlink):
+        _create_fake_imap(mock_imaplib, with_mail=True, attachment_name='symlink')
 
         with ImapHook() as imap_hook:
             imap_hook.download_mail_attachments(
-                name='test1.csv',
+                name='symlink',
                 local_output_directory='test_directory'
             )
 
+        mock_is_symlink.assert_called_once()
         mock_open_method.assert_not_called()
-        mock_open_method().write.assert_not_called()
+        mock_open_method.return_value.write.assert_not_called()
 
 
 if __name__ == '__main__':

From 5fdfdf00a9888771243f92917c1d63e9a98b5240 Mon Sep 17 00:00:00 2001
From: Craig Forster <craig.forster@olono.ai>
Date: Fri, 6 Jul 2018 22:30:02 +0200
Subject: [PATCH 505/808] [AIRFLOW-2706] AWS Batch Operator should use
 top-level job state to determine status

Rather than inspecting the state of job attempts,
the operator should use the top-level job status
to determine the overall success or failure of the
task. This means the following cases are handled
correctly:

1. Any infrastructure failure that results in no
attempts being performed is now detected.
2. Any retry policy that AWS Batch will do is now
honored -- the job isn't marked FAILED until all
   attempts to retry have failed. Previously, the
first failed *attempt* would make the task as
   failed.

Closes #3567 from craigforster/master
---
 .../contrib/operators/awsbatch_operator.py    | 22 ++++++++++---------
 .../operators/test_awsbatch_operator.py       |  6 +++--
 2 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index d4cfaf9cbfc40..d398ae30f693e 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -154,17 +154,19 @@ def _check_success_task(self):
             raise AirflowException('No job found for {}'.format(response))
 
         for job in response['jobs']:
-            if 'attempts' in job:
-                containers = job['attempts']
-                for container in containers:
-                    if (job['status'] == 'FAILED' or
-                            container['container']['exitCode'] != 0):
-                        raise AirflowException(
-                            'This containers encounter an error during '
-                            'execution {}'.format(job))
-            elif job['status'] is not 'SUCCEEDED':
+            job_status = job['status']
+            if job_status is 'FAILED':
+                reason = job['statusReason']
+                raise AirflowException('Job failed with status {}'.format(reason))
+            elif job_status in [
+                'SUBMITTED',
+                'PENDING',
+                'RUNNABLE',
+                'STARTING',
+                'RUNNING'
+            ]:
                 raise AirflowException(
-                    'This task is still pending {}'.format(job['status']))
+                    'This task is still pending {}'.format(job_status))
 
     def get_hook(self):
         return AwsHook(
diff --git a/tests/contrib/operators/test_awsbatch_operator.py b/tests/contrib/operators/test_awsbatch_operator.py
index f081a274213ec..cdb838200fad1 100644
--- a/tests/contrib/operators/test_awsbatch_operator.py
+++ b/tests/contrib/operators/test_awsbatch_operator.py
@@ -144,6 +144,7 @@ def test_check_success_tasks_raises_failed(self):
         client_mock.describe_jobs.return_value = {
             'jobs': [{
                 'status': 'FAILED',
+                'statusReason': 'This is an error reason',
                 'attempts': [{
                     'exitCode': 1
                 }]
@@ -154,7 +155,7 @@ def test_check_success_tasks_raises_failed(self):
             self.batch._check_success_task()
 
         # Ordering of str(dict) is not guaranteed.
-        self.assertIn('This containers encounter an error during execution ', str(e.exception))
+        self.assertIn('Job failed with status ', str(e.exception))
 
     def test_check_success_tasks_raises_pending(self):
         client_mock = mock.Mock()
@@ -181,6 +182,7 @@ def test_check_success_tasks_raises_mutliple(self):
         client_mock.describe_jobs.return_value = {
             'jobs': [{
                 'status': 'FAILED',
+                'statusReason': 'This is an error reason',
                 'attempts': [{
                     'exitCode': 1
                 }, {
@@ -193,7 +195,7 @@ def test_check_success_tasks_raises_mutliple(self):
             self.batch._check_success_task()
 
         # Ordering of str(dict) is not guaranteed.
-        self.assertIn('This containers encounter an error during execution ', str(e.exception))
+        self.assertIn('Job failed with status ', str(e.exception))
 
     def test_check_success_task_not_raises(self):
         client_mock = mock.Mock()

From 95691d372b4dbd8ce8bad0f7fdbc02ff63467764 Mon Sep 17 00:00:00 2001
From: Craig Forster <craig.forster@olono.ai>
Date: Tue, 10 Jul 2018 10:03:09 +0200
Subject: [PATCH 506/808] [AIRFLOW-2735] Use equality, not identity, check for
 detecting AWS Batch failures[]

Closes #3589 from craigforster/master
---
 airflow/contrib/operators/awsbatch_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index d398ae30f693e..bb5be459c5a12 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -155,7 +155,7 @@ def _check_success_task(self):
 
         for job in response['jobs']:
             job_status = job['status']
-            if job_status is 'FAILED':
+            if job_status == 'FAILED':
                 reason = job['statusReason']
                 raise AirflowException('Job failed with status {}'.format(reason))
             elif job_status in [

From d04fc391251e795f553bb601c0019a057a6e854c Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Wed, 30 Jan 2019 11:52:19 -0500
Subject: [PATCH 507/808] [AIRFLOW-3789] Fix flake8 3.7 errors. (#4617)

---
 .../airflow_local_settings.py                 |  8 +--
 airflow/contrib/hooks/gcp_dataflow_hook.py    |  2 +-
 airflow/contrib/hooks/imap_hook.py            |  6 +-
 .../pod_request_factory.py                    |  1 +
 airflow/contrib/kubernetes/pod_launcher.py    |  5 +-
 .../contrib/operators/mlengine_operator.py    |  2 +-
 airflow/contrib/operators/ssh_operator.py     |  2 +-
 airflow/contrib/operators/winrm_operator.py   |  2 +-
 airflow/contrib/utils/gcp_field_validator.py  |  3 +-
 setup.py                                      |  1 +
 tests/hooks/test_http_hook.py                 |  8 +--
 tests/jobs.py                                 | 66 +++++++++----------
 12 files changed, 55 insertions(+), 51 deletions(-)

diff --git a/airflow/config_templates/airflow_local_settings.py b/airflow/config_templates/airflow_local_settings.py
index 45a2f2923c058..b82755c939120 100644
--- a/airflow/config_templates/airflow_local_settings.py
+++ b/airflow/config_templates/airflow_local_settings.py
@@ -214,10 +214,10 @@
     mkdirs(directory, 0o755)
 
 if REMOTE_LOGGING and REMOTE_BASE_LOG_FOLDER.startswith('s3://'):
-        DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['s3'])
+    DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['s3'])
 elif REMOTE_LOGGING and REMOTE_BASE_LOG_FOLDER.startswith('gs://'):
-        DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['gcs'])
+    DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['gcs'])
 elif REMOTE_LOGGING and REMOTE_BASE_LOG_FOLDER.startswith('wasb'):
-        DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['wasb'])
+    DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['wasb'])
 elif REMOTE_LOGGING and ELASTICSEARCH_HOST:
-        DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['elasticsearch'])
+    DEFAULT_LOGGING_CONFIG['handlers'].update(REMOTE_HANDLERS['elasticsearch'])
diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index d02a98c5e4b12..2c572617331dc 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -167,7 +167,7 @@ def wait_for_done(self):
             if self._proc.poll() is not None:
                 # Mark process completion but allows its outputs to be consumed.
                 process_ends = True
-        if self._proc.returncode is not 0:
+        if self._proc.returncode != 0:
             raise Exception("DataFlow failed with return code {}".format(
                 self._proc.returncode))
         return job_id
diff --git a/airflow/contrib/hooks/imap_hook.py b/airflow/contrib/hooks/imap_hook.py
index 1bc19fcdac380..79f08cd5649cb 100644
--- a/airflow/contrib/hooks/imap_hook.py
+++ b/airflow/contrib/hooks/imap_hook.py
@@ -141,11 +141,11 @@ def download_mail_attachments(self,
         self._create_files(mail_attachments, local_output_directory)
 
     def _handle_not_found_mode(self, not_found_mode):
-        if not_found_mode is 'raise':
+        if not_found_mode == 'raise':
             raise AirflowException('No mail attachments found!')
-        elif not_found_mode is 'warn':
+        elif not_found_mode == 'warn':
             self.log.warning('No mail attachments found!')
-        elif not_found_mode is 'ignore':
+        elif not_found_mode == 'ignore':
             pass  # Do not notify if the attachment has not been found.
         else:
             self.log.error('Invalid "not_found_mode" %s', not_found_mode)
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index 059026b320240..cb1b6667c7e4f 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -16,6 +16,7 @@
 # under the License.
 
 import yaml
+from airflow.contrib.kubernetes.pod import Pod
 from airflow.contrib.kubernetes.kubernetes_request_factory.kubernetes_request_factory \
     import KubernetesRequestFactory
 
diff --git a/airflow/contrib/kubernetes/pod_launcher.py b/airflow/contrib/kubernetes/pod_launcher.py
index 8c8d949107494..2704fd9d32715 100644
--- a/airflow/contrib/kubernetes/pod_launcher.py
+++ b/airflow/contrib/kubernetes/pod_launcher.py
@@ -20,6 +20,7 @@
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.state import State
 from datetime import datetime as dt
+from airflow.contrib.kubernetes.pod import Pod
 from airflow.contrib.kubernetes.kubernetes_request_factory import \
     pod_request_factory as pod_factory
 from kubernetes import watch, client
@@ -69,7 +70,7 @@ def delete_pod(self, pod):
                 raise
 
     def run_pod(self, pod, startup_timeout=120, get_logs=True):
-        # type: (Pod) -> (State, result)
+        # type: (Pod, int, bool) -> (State, str)
         """
         Launches the pod synchronously and waits for completion.
         Args:
@@ -90,7 +91,7 @@ def run_pod(self, pod, startup_timeout=120, get_logs=True):
         return self._monitor_pod(pod, get_logs)
 
     def _monitor_pod(self, pod, get_logs):
-        # type: (Pod) -> (State, content)
+        # type: (Pod, bool) -> (State, str)
 
         if get_logs:
             logs = self._client.read_namespaced_pod_log(
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 40a675ca3b46d..0bf9d6cb551b9 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -42,7 +42,7 @@ def _normalize_mlengine_job_id(job_id):
 
     # Add a prefix when a job_id starts with a digit or a template
     match = re.search(r'\d|\{{2}', job_id)
-    if match and match.start() is 0:
+    if match and match.start() == 0:
         job = 'z_{}'.format(job_id)
     else:
         job = job_id
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index 2bf342935d60c..8d8dd1124a99b 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -147,7 +147,7 @@ def execute(self, context):
                 stderr.close()
 
                 exit_status = stdout.channel.recv_exit_status()
-                if exit_status is 0:
+                if exit_status == 0:
                     # returning output if do_xcom_push is set
                     if self.do_xcom_push:
                         enable_pickling = configuration.conf.getboolean(
diff --git a/airflow/contrib/operators/winrm_operator.py b/airflow/contrib/operators/winrm_operator.py
index e8366b809da20..c3f96693f0e4d 100644
--- a/airflow/contrib/operators/winrm_operator.py
+++ b/airflow/contrib/operators/winrm_operator.py
@@ -126,7 +126,7 @@ def execute(self, context):
         except Exception as e:
             raise AirflowException("WinRM operator error: {0}".format(str(e)))
 
-        if return_code is 0:
+        if return_code == 0:
             # returning output if do_xcom_push is set
             if self.do_xcom_push:
                 enable_pickling = configuration.conf.getboolean(
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index e8b59c855e27c..5ae1bdf9ce51e 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -134,6 +134,7 @@
 
 import re
 
+from typing import Callable
 from airflow import LoggingMixin, AirflowException
 
 COMPOSITE_FIELD_TYPES = ['union', 'dict', 'list']
@@ -209,7 +210,7 @@ def _get_field_name_with_parent(field_name, parent):
     @staticmethod
     def _sanity_checks(children_validation_specs, field_type, full_field_path,
                        regexp, allow_empty, custom_validation, value):
-        # type: (dict, str, str, str, function, object) -> None
+        # type: (dict, str, str, str, Callable, object) -> None
         if value is None and field_type != 'union':
             raise GcpFieldValidationException(
                 "The required body field '{}' is missing. Please add it.".
diff --git a/setup.py b/setup.py
index e4bacfe790c23..4f73287876753 100644
--- a/setup.py
+++ b/setup.py
@@ -266,6 +266,7 @@ def write_version(filename=os.path.join(*['airflow',
     'rednose',
     'requests_mock',
     'flake8>=3.6.0',
+    'typing',
 ]
 devel_minreq = devel + kubernetes + mysql + doc + password + s3 + cgroups
 devel_hadoop = devel_minreq + hive + hdfs + webhdfs + kerberos
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index 22797c927f274..4e9226035bd15 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -139,13 +139,13 @@ def test_hook_contains_header_from_extra_field(self, m):
 
     @requests_mock.mock()
     def test_hook_uses_provided_header(self, m):
-            conn = self.get_hook.get_conn(headers={"bareer": "newT0k3n"})
-            self.assertEquals(conn.headers.get('bareer'), "newT0k3n")
+        conn = self.get_hook.get_conn(headers={"bareer": "newT0k3n"})
+        self.assertEqual(conn.headers.get('bareer'), "newT0k3n")
 
     @requests_mock.mock()
     def test_hook_has_no_header_from_extra(self, m):
-            conn = self.get_hook.get_conn()
-            self.assertIsNone(conn.headers.get('bareer'))
+        conn = self.get_hook.get_conn()
+        self.assertIsNone(conn.headers.get('bareer'))
 
     @requests_mock.mock()
     def test_hooks_header_from_extra_is_overridden(self, m):
diff --git a/tests/jobs.py b/tests/jobs.py
index 66920bf523366..cfb90ef765785 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -335,44 +335,44 @@ def test_backfill_rerun_failed_tasks(self):
         self.assertEquals(ti.state, State.SUCCESS)
 
     def test_backfill_rerun_upstream_failed_tasks(self):
-            dag = DAG(
-                dag_id='test_backfill_rerun_upstream_failed',
-                start_date=DEFAULT_DATE,
-                schedule_interval='@daily')
+        dag = DAG(
+            dag_id='test_backfill_rerun_upstream_failed',
+            start_date=DEFAULT_DATE,
+            schedule_interval='@daily')
 
-            with dag:
-                t1 = DummyOperator(task_id='test_backfill_rerun_upstream_failed_task-1',
-                                   dag=dag)
-                t2 = DummyOperator(task_id='test_backfill_rerun_upstream_failed_task-2',
-                                   dag=dag)
-                t1.set_upstream(t2)
+        with dag:
+            t1 = DummyOperator(task_id='test_backfill_rerun_upstream_failed_task-1',
+                               dag=dag)
+            t2 = DummyOperator(task_id='test_backfill_rerun_upstream_failed_task-2',
+                               dag=dag)
+            t1.set_upstream(t2)
 
-            dag.clear()
-            executor = TestExecutor(do_update=True)
+        dag.clear()
+        executor = TestExecutor(do_update=True)
 
-            job = BackfillJob(dag=dag,
-                              executor=executor,
-                              start_date=DEFAULT_DATE,
-                              end_date=DEFAULT_DATE + datetime.timedelta(days=2),
-                              )
-            job.run()
+        job = BackfillJob(dag=dag,
+                          executor=executor,
+                          start_date=DEFAULT_DATE,
+                          end_date=DEFAULT_DATE + datetime.timedelta(days=2),
+                          )
+        job.run()
 
-            ti = TI(task=dag.get_task('test_backfill_rerun_upstream_failed_task-1'),
-                    execution_date=DEFAULT_DATE)
-            ti.refresh_from_db()
-            ti.set_state(State.UPSTREAM_FAILED)
+        ti = TI(task=dag.get_task('test_backfill_rerun_upstream_failed_task-1'),
+                execution_date=DEFAULT_DATE)
+        ti.refresh_from_db()
+        ti.set_state(State.UPSTREAM_FAILED)
 
-            job = BackfillJob(dag=dag,
-                              executor=executor,
-                              start_date=DEFAULT_DATE,
-                              end_date=DEFAULT_DATE + datetime.timedelta(days=2),
-                              rerun_failed_tasks=True
-                              )
-            job.run()
-            ti = TI(task=dag.get_task('test_backfill_rerun_upstream_failed_task-1'),
-                    execution_date=DEFAULT_DATE)
-            ti.refresh_from_db()
-            self.assertEquals(ti.state, State.SUCCESS)
+        job = BackfillJob(dag=dag,
+                          executor=executor,
+                          start_date=DEFAULT_DATE,
+                          end_date=DEFAULT_DATE + datetime.timedelta(days=2),
+                          rerun_failed_tasks=True
+                          )
+        job.run()
+        ti = TI(task=dag.get_task('test_backfill_rerun_upstream_failed_task-1'),
+                execution_date=DEFAULT_DATE)
+        ti.refresh_from_db()
+        self.assertEqual(ti.state, State.SUCCESS)
 
     def test_backfill_rerun_failed_tasks_without_flag(self):
         dag = DAG(

From 58bde52dde8d3e8c1e9e04e0b63ac12ab4b98ef9 Mon Sep 17 00:00:00 2001
From: Brad Holmes <holmesbr@ncbi.nlm.nih.gov>
Date: Sat, 29 Sep 2018 13:17:43 -0400
Subject: [PATCH 508/808] [AIRFLOW-3079] Improve migration scripts to support
 MSSQL Server (#3964)

There were two problems for MSSQL.  First, 'timestamp' data type in MSSQL Server
is essentially a row-id, and not a timezone enabled date/time stamp. Second, alembic
creates invalid SQL when applying the 0/1 constraint to boolean values. MSSQL should
enforce this constraint by simply asserting a boolean value.
---
 .../versions/0a2a5b66e19d_add_task_reschedule_table.py    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py b/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
index 6eef6a9437544..643a1ca81b678 100644
--- a/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
+++ b/airflow/migrations/versions/0a2a5b66e19d_add_task_reschedule_table.py
@@ -39,6 +39,12 @@
 TABLE_NAME = 'task_reschedule'
 INDEX_NAME = 'idx_' + TABLE_NAME + '_dag_task_date'
 
+# For Microsoft SQL Server, TIMESTAMP is a row-id type,
+# having nothing to do with date-time.  DateTime() will
+# be sufficient.
+def mssql_timestamp():
+    return sa.DateTime()
+
 def mysql_timestamp():
     return mysql.TIMESTAMP(fsp=6)
 
@@ -50,6 +56,8 @@ def upgrade():
     conn = op.get_bind()
     if conn.dialect.name == 'mysql':
         timestamp = mysql_timestamp
+    elif conn.dialect.name == 'mssql':
+        timestamp = mssql_timestamp
     else:
         timestamp = sa_timestamp
 

From c2f46d637cb621dc4be2142a356ae26fd9ed77c2 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 29 Jan 2019 19:56:08 +0000
Subject: [PATCH 509/808] [AIRFLOW-3742] Respect the `fallback` arg in
 airflow.configuration.get (#4567)

This argument is part of the API from our parent class, but we didn't
support it because of the various steps we perform in `get()` - this
makes it behave more like the parent class, and can simplify a few
instances in our code (I've only included one that I found here)
---
 airflow/configuration.py                |  9 +++++----
 airflow/settings.py                     | 16 +++++-----------
 tests/cli/test_worker_initialisation.py |  6 ++++--
 tests/configuration.py                  |  6 ++++++
 4 files changed, 20 insertions(+), 17 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 459e2a39b8e7b..2534fc4c7d7c5 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -35,7 +35,7 @@
 import sys
 import warnings
 
-from backports.configparser import ConfigParser
+from backports.configparser import ConfigParser, _UNSET, NoOptionError
 from zope.deprecation import deprecated as _deprecated
 
 from airflow.exceptions import AirflowConfigException
@@ -246,7 +246,7 @@ def get(self, section, key, **kwargs):
                 return option
 
         # ...then the default config
-        if self.airflow_defaults.has_option(section, key):
+        if self.airflow_defaults.has_option(section, key) or 'fallback' in kwargs:
             return expand_env_var(
                 self.airflow_defaults.get(section, key, **kwargs))
 
@@ -290,9 +290,10 @@ def has_option(self, section, option):
         try:
             # Using self.get() to avoid reimplementing the priority order
             # of config variables (env, config, cmd, defaults)
-            self.get(section, option)
+            # UNSET to avoid logging a warning about missing values
+            self.get(section, option, fallback=_UNSET)
             return True
-        except AirflowConfigException:
+        except NoOptionError:
             return False
 
     def remove_option(self, section, option, remove_default=True):
diff --git a/airflow/settings.py b/airflow/settings.py
index 5cda472565888..e614378780cfd 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -175,13 +175,10 @@ def configure_orm(disable_connection_pool=False):
         engine_args['pool_size'] = pool_size
         engine_args['pool_recycle'] = pool_recycle
 
-    try:
-        # Allow the user to specify an encoding for their DB otherwise default
-        # to utf-8 so jobs & users with non-latin1 characters can still use
-        # us.
-        engine_args['encoding'] = conf.get('core', 'SQL_ENGINE_ENCODING')
-    except conf.AirflowConfigException:
-        engine_args['encoding'] = 'utf-8'
+    # Allow the user to specify an encoding for their DB otherwise default
+    # to utf-8 so jobs & users with non-latin1 characters can still use
+    # us.
+    engine_args['encoding'] = conf.get('core', 'SQL_ENGINE_ENCODING', fallback='utf-8')
     # For Python2 we get back a newstr and need a str
     engine_args['encoding'] = engine_args['encoding'].__str__()
 
@@ -225,10 +222,7 @@ def configure_adapters():
 
 
 def validate_session():
-    try:
-        worker_precheck = conf.getboolean('core', 'worker_precheck')
-    except conf.AirflowConfigException:
-        worker_precheck = False
+    worker_precheck = conf.getboolean('core', 'worker_precheck', fallback=False)
     if not worker_precheck:
         return True
     else:
diff --git a/tests/cli/test_worker_initialisation.py b/tests/cli/test_worker_initialisation.py
index 477221693abe1..03fb9487fec58 100644
--- a/tests/cli/test_worker_initialisation.py
+++ b/tests/cli/test_worker_initialisation.py
@@ -59,8 +59,10 @@ def test_worker_precheck_exception(self, mock_getboolean):
         Test to check the behaviour of validate_session method
         when worker_precheck is absent in airflow configuration
         """
-        mock_getboolean.side_effect = airflow.configuration.AirflowConfigException
-        self.assertEqual(airflow.settings.validate_session(), True)
+        mock_getboolean.return_value = False
+
+        self.assertTrue(airflow.settings.validate_session())
+        mock_getboolean.assert_called_once_with('core', 'worker_precheck', fallback=False)
 
     @mock.patch('sqlalchemy.orm.session.Session.execute')
     @mock.patch('airflow.configuration.getboolean')
diff --git a/tests/configuration.py b/tests/configuration.py
index acebd5732c3df..94c061a548c65 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -56,6 +56,8 @@ def test_env_var_config(self):
         opt = conf.get('testsection', 'testpercent')
         self.assertEqual(opt, 'with%percent')
 
+        self.assertTrue(conf.has_option('testsection', 'testkey'))
+
     def test_conf_as_dict(self):
         cfg_dict = conf.as_dict()
 
@@ -123,6 +125,10 @@ def test_command_config(self):
         self.assertEqual('key4_result', test_conf.get('test', 'key4'))
         self.assertEqual('value6', test_conf.get('another', 'key6'))
 
+        self.assertEqual('hello', test_conf.get('test', 'key1', fallback='fb'))
+        self.assertEqual('value6', test_conf.get('another', 'key6', fallback='fb'))
+        self.assertEqual('fb', test_conf.get('another', 'key7', fallback='fb'))
+
         self.assertTrue(test_conf.has_option('test', 'key1'))
         self.assertTrue(test_conf.has_option('test', 'key2'))
         self.assertTrue(test_conf.has_option('test', 'key3'))

From f8776d61afb0bbd8d38c990248fe9460486b1db3 Mon Sep 17 00:00:00 2001
From: Tanay Tummalapalli <ttanay100@gmail.com>
Date: Mon, 11 Feb 2019 15:23:55 +0530
Subject: [PATCH 510/808] [AIRFLOW-3742] Fix handling of "fallback" for
 AirflowConfigParsxer.getint/boolean (#4674)

We added (and used) fallback as an argument on `getboolean` but didn't
add it to the method, or add tests covering those "casting" accessors,
so they broke.

This fixes those methods, and adds tests covering them
---
 airflow/configuration.py | 20 ++++++++++----------
 tests/configuration.py   |  5 ++++-
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 2534fc4c7d7c5..751dce1c6da3d 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -259,27 +259,27 @@ def get(self, section, key, **kwargs):
                 "section/key [{section}/{key}] not found "
                 "in config".format(**locals()))
 
-    def getboolean(self, section, key):
-        val = str(self.get(section, key)).lower().strip()
+    def getboolean(self, section, key, **kwargs):
+        val = str(self.get(section, key, **kwargs)).lower().strip()
         if '#' in val:
             val = val.split('#')[0].strip()
-        if val.lower() in ('t', 'true', '1'):
+        if val in ('t', 'true', '1'):
             return True
-        elif val.lower() in ('f', 'false', '0'):
+        elif val in ('f', 'false', '0'):
             return False
         else:
             raise AirflowConfigException(
                 'The value for configuration option "{}:{}" is not a '
                 'boolean (received "{}").'.format(section, key, val))
 
-    def getint(self, section, key):
-        return int(self.get(section, key))
+    def getint(self, section, key, **kwargs):
+        return int(self.get(section, key, **kwargs))
 
-    def getfloat(self, section, key):
-        return float(self.get(section, key))
+    def getfloat(self, section, key, **kwargs):
+        return float(self.get(section, key, **kwargs))
 
-    def read(self, filenames):
-        super(AirflowConfigParser, self).read(filenames)
+    def read(self, filenames, **kwargs):
+        super(AirflowConfigParser, self).read(filenames, **kwargs)
         self._validate()
 
     def read_dict(self, *args, **kwargs):
diff --git a/tests/configuration.py b/tests/configuration.py
index 94c061a548c65..278e2e597abbc 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -97,7 +97,7 @@ def test_conf_as_dict_raw(self):
         self.assertEqual(cfg_dict['testsection']['testpercent'], 'with%%percent')
         self.assertEqual(cfg_dict['core']['percent'], 'with%%inside')
 
-    def test_command_config(self):
+    def test_command_precedence(self):
         TEST_CONFIG = '''[test]
 key1 = hello
 key2_cmd = printf cmd_result
@@ -128,6 +128,9 @@ def test_command_config(self):
         self.assertEqual('hello', test_conf.get('test', 'key1', fallback='fb'))
         self.assertEqual('value6', test_conf.get('another', 'key6', fallback='fb'))
         self.assertEqual('fb', test_conf.get('another', 'key7', fallback='fb'))
+        self.assertEqual(True, test_conf.getboolean('another', 'key8_boolean', fallback='True'))
+        self.assertEqual(10, test_conf.getint('another', 'key8_int', fallback='10'))
+        self.assertEqual(1.0, test_conf.getfloat('another', 'key8_float', fallback='1'))
 
         self.assertTrue(test_conf.has_option('test', 'key1'))
         self.assertTrue(test_conf.has_option('test', 'key2'))

From 23662dbee8c467009a1d8863cb2453aee6fb2dc4 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Wed, 21 Nov 2018 15:59:19 +0100
Subject: [PATCH 511/808] [AIRFLOW-3375] Support returning multiple tasks with
 BranchPythonOperator (#4215)

---
 airflow/operators/python_operator.py    | 16 ++++----
 docs/concepts.rst                       |  4 +-
 tests/operators/test_python_operator.py | 54 ++++++++++++++++++++++---
 3 files changed, 59 insertions(+), 15 deletions(-)

diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index e6a0795dc6ce7..9fadee2b391c8 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -110,14 +110,14 @@ def execute_callable(self):
 
 class BranchPythonOperator(PythonOperator, SkipMixin):
     """
-    Allows a workflow to "branch" or follow a single path following the
-    execution of this task.
+    Allows a workflow to "branch" or follow a path following the execution
+    of this task.
 
     It derives the PythonOperator and expects a Python function that returns
-    the task_id to follow. The task_id returned should point to a task
-    directly downstream from {self}. All other "branches" or
-    directly downstream tasks are marked with a state of ``skipped`` so that
-    these paths can't move forward. The ``skipped`` states are propageted
+    a single task_id or list of task_ids to follow. The task_id(s) returned
+    should point to a task directly downstream from {self}. All other "branches"
+    or directly downstream tasks are marked with a state of ``skipped`` so that
+    these paths can't move forward. The ``skipped`` states are propagated
     downstream to allow for the DAG state to fill up and the DAG run's state
     to be inferred.
 
@@ -129,13 +129,15 @@ class BranchPythonOperator(PythonOperator, SkipMixin):
     """
     def execute(self, context):
         branch = super(BranchPythonOperator, self).execute(context)
+        if isinstance(branch, str):
+            branch = [branch]
         self.log.info("Following branch %s", branch)
         self.log.info("Marking other directly downstream tasks as skipped")
 
         downstream_tasks = context['task'].downstream_list
         self.log.debug("Downstream task_ids %s", downstream_tasks)
 
-        skip_tasks = [t for t in downstream_tasks if t.task_id != branch]
+        skip_tasks = [t for t in downstream_tasks if t.task_id not in branch]
         if downstream_tasks:
             self.skip(context['dag_run'], context['ti'].execution_date, skip_tasks)
 
diff --git a/docs/concepts.rst b/docs/concepts.rst
index f23a8d488f6b7..ef02ad6ccd8d1 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -470,8 +470,8 @@ that happened in an upstream task. One way to do this is by using the
 ``BranchPythonOperator``.
 
 The ``BranchPythonOperator`` is much like the PythonOperator except that it
-expects a python_callable that returns a task_id. The task_id returned
-is followed, and all of the other paths are skipped.
+expects a python_callable that returns a task_id (or list of task_ids). The
+task_id returned is followed, and all of the other paths are skipped.
 The task_id returned by the Python function has to be referencing a task
 directly downstream from the BranchPythonOperator task.
 
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index afc2a1383ae84..dd830b899c13d 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -183,15 +183,9 @@ def setUp(self):
                            'owner': 'airflow',
                            'start_date': DEFAULT_DATE},
                        schedule_interval=INTERVAL)
-        self.branch_op = BranchPythonOperator(task_id='make_choice',
-                                              dag=self.dag,
-                                              python_callable=lambda: 'branch_1')
 
         self.branch_1 = DummyOperator(task_id='branch_1', dag=self.dag)
-        self.branch_1.set_upstream(self.branch_op)
         self.branch_2 = DummyOperator(task_id='branch_2', dag=self.dag)
-        self.branch_2.set_upstream(self.branch_op)
-        self.dag.clear()
 
     def tearDown(self):
         super(BranchOperatorTest, self).tearDown()
@@ -206,6 +200,13 @@ def tearDown(self):
 
     def test_without_dag_run(self):
         """This checks the defensive against non existent tasks in a dag run"""
+        self.branch_op = BranchPythonOperator(task_id='make_choice',
+                                              dag=self.dag,
+                                              python_callable=lambda: 'branch_1')
+        self.branch_1.set_upstream(self.branch_op)
+        self.branch_2.set_upstream(self.branch_op)
+        self.dag.clear()
+
         self.branch_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
 
         session = Session()
@@ -226,7 +227,48 @@ def test_without_dag_run(self):
             else:
                 raise
 
+    def test_branch_list_without_dag_run(self):
+        """This checks if the BranchPythonOperator supports branching off to a list of tasks."""
+        self.branch_op = BranchPythonOperator(task_id='make_choice',
+                                              dag=self.dag,
+                                              python_callable=lambda: ['branch_1', 'branch_2'])
+        self.branch_1.set_upstream(self.branch_op)
+        self.branch_2.set_upstream(self.branch_op)
+        self.branch_3 = DummyOperator(task_id='branch_3', dag=self.dag)
+        self.branch_3.set_upstream(self.branch_op)
+        self.dag.clear()
+
+        self.branch_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
+        session = Session()
+        tis = session.query(TI).filter(
+            TI.dag_id == self.dag.dag_id,
+            TI.execution_date == DEFAULT_DATE
+        )
+        session.close()
+
+        expected = {
+            "make_choice": State.SUCCESS,
+            "branch_1": State.NONE,
+            "branch_2": State.NONE,
+            "branch_3": State.SKIPPED,
+        }
+
+        for ti in tis:
+            if ti.task_id in expected:
+                self.assertEquals(ti.state, expected[ti.task_id])
+            else:
+                raise
+
     def test_with_dag_run(self):
+        self.branch_op = BranchPythonOperator(task_id='make_choice',
+                                              dag=self.dag,
+                                              python_callable=lambda: 'branch_1')
+
+        self.branch_1.set_upstream(self.branch_op)
+        self.branch_2.set_upstream(self.branch_op)
+        self.dag.clear()
+
         dr = self.dag.create_dagrun(
             run_id="manual__",
             start_date=timezone.utcnow(),

From a5500dc5f19672be4aae8fe022c2e9884f4c7388 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 30 Jan 2019 19:19:41 +0000
Subject: [PATCH 512/808] [AIRFLOW-3779] Don't install enum34 backport when not
 needed (#4620)

https://setuptools.readthedocs.io/en/latest/setuptools.html#declaring-platform-specific-dependencies

Installing this in more recent versions causes a "AttributeError: module
'enum' has no attribute 'IntFlag'`" in re.py
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 4f73287876753..3a379a47ae758 100644
--- a/setup.py
+++ b/setup.py
@@ -306,7 +306,7 @@ def do_setup():
             'configparser>=3.5.0, <3.6.0',
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
-            'enum34~=1.1.6',
+            'enum34~=1.1.6;python_version<"3.4"',
             'flask>=0.12.4, <0.13',
             'flask-appbuilder==1.12.1',
             'flask-admin==1.5.2',

From e603bf73ad9f63e1533811576cf1fbc9014f780a Mon Sep 17 00:00:00 2001
From: Maria R <37372982+vapiravfif@users.noreply.github.com>
Date: Tue, 12 Feb 2019 18:43:48 +0200
Subject: [PATCH 513/808] [AIRFLOW-3639] Fix request creation in Jenkins
 Operator (#4450)

Change Jenkins Operator to work with native Jenkins library method to configure REST request headers correctly
---
 .../operators/jenkins_job_trigger_operator.py | 24 +++++++------------
 setup.py                                      |  2 +-
 2 files changed, 10 insertions(+), 16 deletions(-)

diff --git a/airflow/contrib/operators/jenkins_job_trigger_operator.py b/airflow/contrib/operators/jenkins_job_trigger_operator.py
index 36e699b05bacb..ee9f2be6d1870 100644
--- a/airflow/contrib/operators/jenkins_job_trigger_operator.py
+++ b/airflow/contrib/operators/jenkins_job_trigger_operator.py
@@ -26,7 +26,7 @@
 from airflow.contrib.hooks.jenkins_hook import JenkinsHook
 import jenkins
 from jenkins import JenkinsException
-from six.moves.urllib.request import Request, urlopen
+from requests import Request
 from six.moves.urllib.error import HTTPError, URLError
 
 try:
@@ -35,28 +35,22 @@
     basestring = str  # For python3 compatibility
 
 
-# TODO Use jenkins_urlopen instead when it will be available
-# in the stable python-jenkins version (> 0.4.15)
-def jenkins_request_with_headers(jenkins_server, req, add_crumb=True):
+def jenkins_request_with_headers(jenkins_server, req):
     """
     We need to get the headers in addition to the body answer
     to get the location from them
-    This function is just a copy of the one present in python-jenkins library
+    This function uses jenkins_request method from python-jenkins library
     with just the return call changed
 
     :param jenkins_server: The server to query
     :param req: The request to execute
-    :param add_crumb: Boolean to indicate if it should add crumb to the request
-    :return:
+    :return: Dict containing the response body (key body)
+    and the headers coming along (headers)
     """
     try:
-        if jenkins_server.auth:
-            req.add_header('Authorization', jenkins_server.auth)
-        if add_crumb:
-            jenkins_server.maybe_add_crumb(req)
-        response = urlopen(req, timeout=jenkins_server.timeout)
-        response_body = response.read()
-        response_headers = response.info()
+        response = jenkins_server.jenkins_request(req)
+        response_body = response.content
+        response_headers = response.headers
         if response_body is None:
             raise jenkins.EmptyResponseException(
                 "Error communicating with server[%s]: "
@@ -153,7 +147,7 @@ def build_job(self, jenkins_server):
             self.parameters = None
 
         request = Request(jenkins_server.build_job_url(self.job_name,
-                                                       self.parameters, None), b'')
+                                                       self.parameters, None))
         return jenkins_request_with_headers(jenkins_server, request)
 
     def poll_job_in_queue(self, location, jenkins_server):
diff --git a/setup.py b/setup.py
index 3a379a47ae758..3f33cc8ff6fdb 100644
--- a/setup.py
+++ b/setup.py
@@ -207,7 +207,7 @@ def write_version(filename=os.path.join(*['airflow',
     'pyhive>=0.6.0',
 ]
 jdbc = ['jaydebeapi>=1.1.1']
-jenkins = ['python-jenkins>=0.4.15']
+jenkins = ['python-jenkins>=1.0.0']
 jira = ['JIRA>1.0.7']
 kerberos = ['pykerberos>=1.1.13',
             'requests_kerberos>=0.10.0',

From 0d8dc30d924cf54b8875b2037d7ce9c1aee0a5d3 Mon Sep 17 00:00:00 2001
From: Ian Wong <yihengw@gmail.com>
Date: Wed, 13 Feb 2019 04:22:38 +0800
Subject: [PATCH 514/808] [AIRFLOW-3780] Fix some incorrect when base_url is
 used (#4643)

Some links are incorrect when base_url is set.
---
 airflow/www/templates/airflow/dag.html       | 6 +++---
 airflow/www/templates/airflow/dags.html      | 2 +-
 airflow/www_rbac/templates/airflow/dags.html | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index e69f31ad0674d..4721c6cf72880 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -40,7 +40,7 @@ <h3 class="pull-left">
       {% endif %}
     </h3>
     <h4 class="pull-right">
-      <a class="label label-default" href="/admin/dagrun/?flt2_dag_id_equals={{ dag.dag_id }}">
+      <a class="label label-default" href="{{ url_for('dagrun.index_view') }}?_flt_2_dag_id={{ dag.dag_id }}">
         schedule: {{ dag.schedule_interval }}
       </a>
     </h4>
@@ -369,7 +369,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $("#btn_ti").click(function(){
-      url = "/admin/taskinstance/" +
+      url = "{{ url_for('taskinstance.index_view') }}" +
         "?flt1_dag_id_equals=" + encodeURIComponent(dag_id) +
         "&flt2_task_id_equals=" + encodeURIComponent(task_id) +
         "&sort=3&desc=1";
@@ -481,7 +481,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $('#btn_edit_dagrun').click(function(){
-      window.location = '/admin/dagrun/edit/?id=' + id;
+      window.location = "{{ url_for('dagrun.edit_view') }}?id=" + id;
     });
 
   </script>
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 1e98f380a3a6e..57e949e8ad8ca 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -139,7 +139,7 @@ <h2>DAGs</h2>
                 {% if dag %}
 
                 <!-- Trigger Dag -->
-                <a href="{{ url_for('airflow.trigger', dag_id=dag.dag_id) }}"
+                <a href="{{ url_for('airflow.trigger', dag_id=dag.dag_id) }}&origin={{ request.base_url }}"
                    onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
                     <span class="glyphicon glyphicon-play-circle" aria-hidden="true" data-original-title="Trigger Dag"></span>
                 </a>
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index 04098ebce35be..527643e87242a 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -140,7 +140,7 @@ <h2>DAGs</h2>
                 {% if dag %}
 
                 <!-- Trigger Dag -->
-                <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id) }}"
+                <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id) }}&origin={{ request.base_url }}"
                    onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
                     <span class="glyphicon glyphicon-play-circle" aria-hidden="true" data-original-title="Trigger Dag"></span>
                 </a>

From 8a329c03f2ddb0e84fd704c4bc970004b8bb0186 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Wed, 13 Feb 2019 01:42:37 -0800
Subject: [PATCH 515/808] [AIRFLOW-XXX] Pin pinodb dependency (#4704)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 3f33cc8ff6fdb..e5465ba9b5291 100644
--- a/setup.py
+++ b/setup.py
@@ -223,7 +223,7 @@ def write_version(filename=os.path.join(*['airflow',
     'bcrypt>=2.0.0',
     'flask-bcrypt>=0.7.1',
 ]
-pinot = ['pinotdb>=0.1.1']
+pinot = ['pinotdb==0.1.1']
 postgres = ['psycopg2>=2.7.4']
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']

From 6bcf023b27e0b463b7e28fff81b6c9ccbcb31b78 Mon Sep 17 00:00:00 2001
From: George Leslie-Waksman <waksman@gmail.com>
Date: Mon, 6 Aug 2018 15:45:59 -0700
Subject: [PATCH 516/808] AIRFLOW-2787 Allow is_backfill to handle NULL
 DagRun.run_id (#3629)

---
 airflow/models.py |  5 ++++-
 tests/models.py   | 11 ++++++++++-
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index aae1406cd3857..aaf50e2101863 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -5360,7 +5360,10 @@ def get_run(session, dag_id, execution_date):
     @property
     def is_backfill(self):
         from airflow.jobs import BackfillJob
-        return self.run_id.startswith(BackfillJob.ID_PREFIX)
+        return (
+            self.run_id is not None and
+            self.run_id.startswith(BackfillJob.ID_PREFIX)
+        )
 
     @classmethod
     @provide_session
diff --git a/tests/models.py b/tests/models.py
index 72c5dedce5dc8..3675e83d70ae0 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1302,11 +1302,20 @@ def test_get_latest_runs(self):
 
     def test_is_backfill(self):
         dag = DAG(dag_id='test_is_backfill', start_date=DEFAULT_DATE)
+
         dagrun = self.create_dag_run(dag, execution_date=DEFAULT_DATE)
         dagrun.run_id = BackfillJob.ID_PREFIX + '_sfddsffds'
-        dagrun2 = self.create_dag_run(dag, execution_date=DEFAULT_DATE + datetime.timedelta(days=1))
+
+        dagrun2 = self.create_dag_run(
+            dag, execution_date=DEFAULT_DATE + datetime.timedelta(days=1))
+
+        dagrun3 = self.create_dag_run(
+            dag, execution_date=DEFAULT_DATE + datetime.timedelta(days=2))
+        dagrun3.run_id = None
+
         self.assertTrue(dagrun.is_backfill)
         self.assertFalse(dagrun2.is_backfill)
+        self.assertFalse(dagrun3.is_backfill)
 
     def test_removed_task_instances_can_be_restored(self):
         def with_all_tasks_removed(dag):

From 54aa290798171ac76ec5e470af13b1e14c104930 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Tue, 19 Feb 2019 16:25:38 +0100
Subject: [PATCH 517/808] [AIRFLOW-3616][AIRFLOW-1215] Add aliases for schema
 with underscore (#4523)

---
 airflow/models.py                 | 24 +++++++++++----------
 docs/concepts.rst                 | 11 ++++++++++
 docs/howto/manage-connections.rst | 35 +++++++++++++++++++++++++++----
 tests/models.py                   | 17 +++++++++++++++
 4 files changed, 72 insertions(+), 15 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index aaf50e2101863..513b6ab430db2 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -679,22 +679,24 @@ def __init__(
             self.extra = extra
 
     def parse_from_uri(self, uri):
-        temp_uri = urlparse(uri)
-        hostname = temp_uri.hostname or ''
-        conn_type = temp_uri.scheme
+        uri_parts = urlparse(uri)
+        hostname = uri_parts.hostname or ''
+        conn_type = uri_parts.scheme
         if conn_type == 'postgresql':
             conn_type = 'postgres'
+        elif '-' in conn_type:
+            conn_type = conn_type.replace('-', '_')
         self.conn_type = conn_type
         self.host = unquote(hostname) if hostname else hostname
-        quoted_schema = temp_uri.path[1:]
+        quoted_schema = uri_parts.path[1:]
         self.schema = unquote(quoted_schema) if quoted_schema else quoted_schema
-        self.login = unquote(temp_uri.username) \
-            if temp_uri.username else temp_uri.username
-        self.password = unquote(temp_uri.password) \
-            if temp_uri.password else temp_uri.password
-        self.port = temp_uri.port
-        if temp_uri.query:
-            self.extra = json.dumps(dict(parse_qsl(temp_uri.query)))
+        self.login = unquote(uri_parts.username) \
+            if uri_parts.username else uri_parts.username
+        self.password = unquote(uri_parts.password) \
+            if uri_parts.password else uri_parts.password
+        self.port = uri_parts.port
+        if uri_parts.query:
+            self.extra = json.dumps(dict(parse_qsl(uri_parts.query)))
 
     def get_password(self):
         if self._password and self.is_encrypted:
diff --git a/docs/concepts.rst b/docs/concepts.rst
index ef02ad6ccd8d1..e5c28bb11f598 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -349,6 +349,17 @@ from ``BaseHook``, Airflow will choose one connection randomly, allowing
 for some basic load balancing and fault tolerance when used in conjunction
 with retries.
 
+Airflow also has the ability to reference connections via environment
+variables from the operating system. Then connection parameters must
+be saved in URI format.
+
+If connections with the same ``conn_id`` are defined in both Airflow metadata
+database and environment variables, only the one in environment variables
+will be referenced by Airflow (for example, given ``conn_id``
+``postgres_master``, Airflow will search for ``AIRFLOW_CONN_POSTGRES_MASTER``
+in environment variables first and directly reference it if found,
+before it starts to search in metadata database).
+
 Many hooks have a default ``conn_id``, where operators using that hook do not
 need to supply an explicit connection ID. For example, the default
 ``conn_id`` for the :class:`~airflow.hooks.postgres_hook.PostgresHook` is
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index f38ff2fb61abe..0d25ea94885c4 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -70,10 +70,15 @@ When referencing the connection in the Airflow pipeline, the ``conn_id``
 should be the name of the variable without the prefix. For example, if the
 ``conn_id`` is named ``postgres_master`` the environment variable should be
 named ``AIRFLOW_CONN_POSTGRES_MASTER`` (note that the environment variable
-must be all uppercase). Airflow assumes the value returned from the
-environment variable to be in a URI format (e.g.
-``postgres://user:password@localhost:5432/master`` or
-``s3://accesskey:secretkey@S3``).
+must be all uppercase).
+
+Airflow assumes the value returned from the environment variable to be in a URI
+format (e.g.``postgres://user:password@localhost:5432/master`` or
+``s3://accesskey:secretkey@S3``). The underscore character is not allowed
+in the scheme part of URI, so it must be changed to a hyphen character
+(e.g. `google-compute-platform` if `conn_type` is `google_compute_platform`).
+Query parameters are parsed to one-dimensional dict and then used to fill extra.
+
 
 .. _manage-connections-connection-types:
 
@@ -151,6 +156,28 @@ Scopes (comma separated)
         issue `AIRFLOW-2522
         <https://issues.apache.org/jira/browse/AIRFLOW-2522>`_.
 
+    When specifying the connection in environment variable you should specify
+    it using URI syntax, with the following requirements:
+
+      * scheme part should be equals ``google-cloud-platform`` (Note: look for a
+        hyphen character)
+      * authority (username, password, host, port), path is ignored
+      * query parameters contains information specific to this type of
+        connection. The following keys are accepted:
+
+        * ``extra__google_cloud_platform__project`` - Project Id
+        * ``extra__google_cloud_platform__key_path`` - Keyfile Path
+        * ``extra__google_cloud_platform__key_dict`` - Keyfile JSON
+        * ``extra__google_cloud_platform__scope`` - Scopes
+
+    Note that all components of the URI should be URL-encoded.
+
+    For example:
+
+    .. code-block:: bash
+
+       google-cloud-platform://?extra__google_cloud_platform__key_path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra__google_cloud_platform__project=airflow
+
 MySQL
 ~~~~~
 The MySQL connection type provides connection to a MySQL database.
diff --git a/tests/models.py b/tests/models.py
index 3675e83d70ae0..ca2cfe030e5d2 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -3034,6 +3034,23 @@ def test_connection_from_uri_no_schema(self):
         self.assertEqual(connection.password, 'password with space')
         self.assertEqual(connection.port, 1234)
 
+    def test_connection_from_uri_with_underscore(self):
+        uri = 'google-cloud-platform://?extra__google_cloud_platform__key_' \
+              'path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=' \
+              'https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra' \
+              '__google_cloud_platform__project=airflow'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'google_cloud_platform')
+        self.assertEqual(connection.host, '')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.extra_dejson, dict(
+            extra__google_cloud_platform__key_path='/keys/key.json',
+            extra__google_cloud_platform__project='airflow',
+            extra__google_cloud_platform__scope='https://www.googleapis.com/'
+                                                'auth/cloud-platform'))
+
 
 class TestSkipMixin(unittest.TestCase):
 

From 397e06f91cddba09a47e59cc78a8daec696dbc69 Mon Sep 17 00:00:00 2001
From: Dana Ma <dana.ma537@gmail.com>
Date: Wed, 23 Jan 2019 04:23:48 +1100
Subject: [PATCH 518/808] [AIRFLOW-3698] Add documentation for AWS Connection
 (#4514)

---
 docs/howto/manage-connections.rst | 49 ++++++++++++++++++++++++++++++-
 1 file changed, 48 insertions(+), 1 deletion(-)

diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 0d25ea94885c4..5dd8ecbfd8f10 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -28,7 +28,7 @@ will author will reference the 'conn_id' of the Connection objects.
 Connections can be created and managed using either the UI or environment
 variables.
 
-See the :ref:`Connenctions Concepts <concepts-connections>` documentation for
+See the :ref:`Connections Concepts <concepts-connections>` documentation for
 more information.
 
 Creating a Connection with the UI
@@ -178,6 +178,53 @@ Scopes (comma separated)
 
        google-cloud-platform://?extra__google_cloud_platform__key_path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra__google_cloud_platform__project=airflow
 
+Amazon Web Services
+~~~~~~~~~~~~~~~~~~~
+
+The Amazon Web Services connection type enables the :ref:`AWS Integrations
+<AWS>`.
+
+Authenticating to AWS
+'''''''''''''''''''''
+
+Authentication may be performed using any of the `boto3 options <https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html#configuring-credentials>`_. Alternatively, one can pass credentials in as a Connection initialisation parameter.
+
+To use IAM instance profile, create an "empty" connection (i.e. one with no Login or Password specified).
+
+Default Connection IDs
+''''''''''''''''''''''
+
+The default connection ID is ``aws_default``.
+
+Configuring the Connection
+''''''''''''''''''''''''''
+
+Login (optional)
+    Specify the AWS access key ID.
+
+Password (optional)
+    Specify the AWS secret access key.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in AWS
+    connection. The following parameters are supported:
+
+    * **aws_account_id**: AWS account ID for the connection
+    * **aws_iam_role**: AWS IAM role for the connection
+    * **external_id**: AWS external ID for the connection
+    * **host**: Endpoint URL for the connection
+    * **region_name**: AWS region for the connection
+    * **role_arn**: AWS role ARN for the connection
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "aws_iam_role": "aws_iam_role_name",
+          "region_name": "ap-southeast-2"
+       }
+
 MySQL
 ~~~~~
 The MySQL connection type provides connection to a MySQL database.

From d615f1e3656770c62b002ab26c6c4beefd26c379 Mon Sep 17 00:00:00 2001
From: stefan-wolfsheimer <stefan.wolfsheimer@gmail.com>
Date: Thu, 21 Feb 2019 16:19:45 +0100
Subject: [PATCH 519/808] [AIRFLOW-3683] Fix formatting of error message for
 invalid TriggerRule (#4490)

---
 airflow/models.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 513b6ab430db2..6cb42a32b221a 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2543,7 +2543,7 @@ def __init__(
             raise AirflowException(
                 "The trigger_rule must be one of {all_triggers},"
                 "'{d}.{t}'; received '{tr}'."
-                .format(all_triggers=TriggerRule.all_triggers,
+                .format(all_triggers=TriggerRule.all_triggers(),
                         d=dag.dag_id if dag else "", t=task_id, tr=trigger_rule))
 
         self.trigger_rule = trigger_rule

From 46633a2188c1a9b917e35ffabf9af8d5b6b0601f Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Tue, 12 Feb 2019 01:33:23 -0800
Subject: [PATCH 520/808] [AIRFLOW-XXX] Upgrade FAB to 1.12.3 (#4694)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index e5465ba9b5291..0bb0b570da824 100644
--- a/setup.py
+++ b/setup.py
@@ -308,7 +308,7 @@ def do_setup():
             'dill>=0.2.2, <0.3',
             'enum34~=1.1.6;python_version<"3.4"',
             'flask>=0.12.4, <0.13',
-            'flask-appbuilder==1.12.1',
+            'flask-appbuilder==1.12.3',
             'flask-admin==1.5.2',
             'flask-caching>=1.3.3, <1.4.0',
             'flask-login>=0.3, <0.5',

From 1211dddfd7167fd90575f40dd6734b0af9aec8b7 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 18 Feb 2019 20:54:39 -0500
Subject: [PATCH 521/808] [AIRFLOW-3907] Upgrade flask and set cookie security
 flags. (#4725)

---
 airflow/config_templates/default_airflow.cfg | 6 ++++++
 airflow/www/app.py                           | 4 ++++
 airflow/www_rbac/app.py                      | 4 ++++
 setup.py                                     | 2 +-
 4 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 95cf69961b3f9..15da6155f73ef 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -317,6 +317,12 @@ default_dag_run_display_number = 25
 # Enable werkzeug `ProxyFix` middleware
 enable_proxy_fix = False
 
+# Set secure flag on session cookie
+cookie_secure = False
+
+# Set samesite policy on session cookie
+cookie_samesite =
+
 
 [email]
 email_backend = airflow.utils.email.send_email_smtp
diff --git a/airflow/www/app.py b/airflow/www/app.py
index ad769b20bd839..e600247cc9d1e 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -50,6 +50,10 @@ def create_app(config=None, testing=False):
     app.config['LOGIN_DISABLED'] = not configuration.conf.getboolean(
         'webserver', 'AUTHENTICATE')
 
+    app.config['SESSION_COOKIE_HTTPONLY'] = True
+    app.config['SESSION_COOKIE_SECURE'] = conf.getboolean('webserver', 'COOKIE_SECURE')
+    app.config['SESSION_COOKIE_SAMESITE'] = conf.get('webserver', 'COOKIE_SAMESITE')
+
     csrf.init_app(app)
 
     app.config['TESTING'] = testing
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 50f823b50d605..5c23aecea9d98 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -54,6 +54,10 @@ def create_app(config=None, session=None, testing=False, app_name="Airflow"):
     app.config['APP_NAME'] = app_name
     app.config['TESTING'] = testing
 
+    app.config['SESSION_COOKIE_HTTPONLY'] = True
+    app.config['SESSION_COOKIE_SECURE'] = conf.getboolean('webserver', 'COOKIE_SECURE')
+    app.config['SESSION_COOKIE_SAMESITE'] = conf.get('webserver', 'COOKIE_SAMESITE')
+
     csrf.init_app(app)
 
     db = SQLA(app)
diff --git a/setup.py b/setup.py
index 0bb0b570da824..0ef84d6169935 100644
--- a/setup.py
+++ b/setup.py
@@ -307,7 +307,7 @@ def do_setup():
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
             'enum34~=1.1.6;python_version<"3.4"',
-            'flask>=0.12.4, <0.13',
+            'flask>=1.0, <2.0',
             'flask-appbuilder==1.12.3',
             'flask-admin==1.5.2',
             'flask-caching>=1.3.3, <1.4.0',

From 48c4fd7a2388e9f49856d428670cc57600ffe102 Mon Sep 17 00:00:00 2001
From: David Smith <suburbanmtman@users.noreply.github.com>
Date: Tue, 19 Feb 2019 21:10:05 -0800
Subject: [PATCH 522/808] [AIRFLOW-3923] Update flask-admin dependency to 1.5.3
 to resolve security vulnerabilities from safety (#4739)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 0ef84d6169935..747d655149e56 100644
--- a/setup.py
+++ b/setup.py
@@ -309,7 +309,7 @@ def do_setup():
             'enum34~=1.1.6;python_version<"3.4"',
             'flask>=1.0, <2.0',
             'flask-appbuilder==1.12.3',
-            'flask-admin==1.5.2',
+            'flask-admin==1.5.3',
             'flask-caching>=1.3.3, <1.4.0',
             'flask-login>=0.3, <0.5',
             'flask-swagger==0.2.13',

From 37bcdb2f56ccbbbafd616e7be4d95c8f299412dd Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Sun, 13 Jan 2019 13:34:00 +0100
Subject: [PATCH 523/808] [AIRFLOW-3692] Remove ENV variables to avoid GPL
 (#4506)

This reverts the commit "Revert [AIRFLOW-3692] Remove ENV variables to
avoid GPL (#4506)" (dcad2e8) - although it didn't work on it's own we
have a further fix about to be cherry-picked that will fix it, and it
needs these changes first.
---
 CONTRIBUTING.md                         |  2 +-
 INSTALL                                 |  8 --------
 UPDATING.md                             |  8 ++++++++
 docs/installation.rst                   |  8 --------
 scripts/ci/docker-compose.yml           |  1 -
 scripts/ci/kubernetes/docker/Dockerfile |  2 --
 scripts/ci/kubernetes/docker/build.sh   |  2 +-
 setup.py                                | 20 +-------------------
 8 files changed, 11 insertions(+), 40 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a54db677a4787..f1dedc98fac0f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -121,7 +121,7 @@ There are three ways to setup an Apache Airflow development environment.
 
   ```
   # Start docker in your Airflow directory
-  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ -e SLUGIFY_USES_TEXT_UNIDECODE=yes python:3 bash
+  docker run -t -i -v `pwd`:/airflow/ -w /airflow/ python:3 bash
 
 
   # Install Airflow with all the required dependencies,
diff --git a/INSTALL b/INSTALL
index 00d458f450737..c3d15a23eaa08 100644
--- a/INSTALL
+++ b/INSTALL
@@ -14,14 +14,6 @@ java -jar apache-rat.jar -E ./.rat-excludes -d .
 python -m my_env
 source my_env/bin/activate
 
-# [required] by default one of Apache Airflow's dependencies pulls in a GPL
-# library. Airflow will not install (and upgrade) without an explicit choice.
-#
-# To make sure not to install the GPL dependency:
-#   export SLUGIFY_USES_TEXT_UNIDECODE=yes
-# In case you do not mind:
-#   export AIRFLOW_GPL_UNIDECODE=yes
-
 # [required] building and installing
 # by pip (preferred)
 pip install .
diff --git a/UPDATING.md b/UPDATING.md
index 91d509d681548..7b6b17bc0d4a0 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -22,6 +22,14 @@ under the License.
 This file documents any backwards-incompatible changes in Airflow and
 assists users migrating to a new version.
 
+## Airflow 1.10.3
+
+#### SLUGIFY_USES_TEXT_UNIDECODE or AIRFLOW_GPL_UNIDECODE no longer required
+
+It is no longer required to set one of the environment variables to avoid
+a GPL dependency. Airflow will now always use text-unidecode if unidecode
+was not installed before.
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
diff --git a/docs/installation.rst b/docs/installation.rst
index f06aab56c5067..2c9436e2f997b 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -33,14 +33,6 @@ You can also install Airflow with support for extra features like ``s3`` or ``po
 
     pip install apache-airflow[postgres,s3]
 
-.. note:: GPL dependency
-
-    One of the dependencies of Apache Airflow by default pulls in a GPL library ('unidecode').
-    In case this is a concern you can force a non GPL library by issuing
-    ``export SLUGIFY_USES_TEXT_UNIDECODE=yes`` and then proceed with the normal installation.
-    Please note that this needs to be specified at every upgrade. Also note that if `unidecode`
-    is already present on the system the dependency will still be used.
-
 Extra Packages
 ''''''''''''''
 
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 32e0a536c1597..0f5d660c390e9 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -67,7 +67,6 @@ services:
     init: true
     environment:
       - USER=airflow
-      - SLUGIFY_USES_TEXT_UNIDECODE=yes
       - TOX_ENV
       - PYTHON_VERSION
       - CI
diff --git a/scripts/ci/kubernetes/docker/Dockerfile b/scripts/ci/kubernetes/docker/Dockerfile
index 7d9385f479896..aca828746b27f 100644
--- a/scripts/ci/kubernetes/docker/Dockerfile
+++ b/scripts/ci/kubernetes/docker/Dockerfile
@@ -17,8 +17,6 @@
 
 FROM ubuntu:16.04
 
-ENV SLUGIFY_USES_TEXT_UNIDECODE=yes
-
 # install deps
 RUN apt-get update -y && apt-get install -y \
         wget \
diff --git a/scripts/ci/kubernetes/docker/build.sh b/scripts/ci/kubernetes/docker/build.sh
index df755f9659178..cb0995aaf473c 100755
--- a/scripts/ci/kubernetes/docker/build.sh
+++ b/scripts/ci/kubernetes/docker/build.sh
@@ -41,7 +41,7 @@ else
 fi
 
 cd $AIRFLOW_ROOT
-docker run -ti --rm -e SLUGIFY_USES_TEXT_UNIDECODE -v ${AIRFLOW_ROOT}:/airflow \
+docker run -ti --rm -v ${AIRFLOW_ROOT}:/airflow \
     -w /airflow ${PYTHON_DOCKER_IMAGE} ./scripts/ci/kubernetes/docker/compile.sh \
 
 sudo rm -rf ${AIRFLOW_ROOT}/airflow/www_rbac/node_modules
diff --git a/setup.py b/setup.py
index 747d655149e56..a64ac08e7bc44 100644
--- a/setup.py
+++ b/setup.py
@@ -39,24 +39,6 @@
     long_description = f.read()
 
 
-# See LEGAL-362
-def verify_gpl_dependency():
-    # The Read the Docs build environment [1] does a pip install of Airflow which cannot
-    # be overridden with custom environment variables, so we detect the READTHEDOCS env
-    # var they provide to set the env var that avoids the GPL dependency on install when
-    # building the docs site.
-    # [1]: http://docs.readthedocs.io/en/latest/builds.html#build-environment
-    if os.getenv("READTHEDOCS") == "True":
-        os.environ["SLUGIFY_USES_TEXT_UNIDECODE"] = "yes"
-
-    if not os.getenv("AIRFLOW_GPL_UNIDECODE") and not os.getenv("SLUGIFY_USES_TEXT_UNIDECODE") == "yes":
-        raise RuntimeError("By default one of Airflow's dependencies installs a GPL "
-                           "dependency (unidecode). To avoid this dependency set "
-                           "SLUGIFY_USES_TEXT_UNIDECODE=yes in your environment when you "
-                           "install or upgrade Airflow. To force installing the GPL "
-                           "version set AIRFLOW_GPL_UNIDECODE")
-
-
 class Tox(TestCommand):
     user_options = [('tox-args=', None, "Arguments to pass to tox")]
 
@@ -286,7 +268,6 @@ def write_version(filename=os.path.join(*['airflow',
 
 
 def do_setup():
-    verify_gpl_dependency()
     write_version()
     setup(
         name='apache-airflow',
@@ -335,6 +316,7 @@ def do_setup():
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
+            'text-unidecode==1.2',  # Avoid GPL dependency, pip uses reverse order(!)
             'thrift>=0.9.2',
             'tzlocal>=1.4',
             'unicodecsv>=0.14.1',

From 3501fc01ae025c2157ca98535fc9a2a212dfd006 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 23 Feb 2019 18:31:03 +0000
Subject: [PATCH 524/808] [AIRFLOW-3697] Vendorize nvd3 and slugify (#4513)

Merge branch 'AIRFLOW-3697'

This PR was done as a merge commit so that we maintain the history of
vendorizing modules and local changes separately.
---
 .flake8                                       |   1 +
 .rat-excludes                                 |   3 +
 .travis.yml                                   |   1 -
 LICENSE                                       |   2 +
 MANIFEST.in                                   |   2 +
 NOTICE                                        |  12 +
 airflow/_vendor/README                        |  13 +
 airflow/_vendor/__init__.py                   |  18 +
 airflow/_vendor/nvd3/LICENSE                  |  24 +
 airflow/_vendor/nvd3/NVD3Chart.py             | 506 ++++++++++++++++++
 airflow/_vendor/nvd3/__init__.py              |  29 +
 airflow/_vendor/nvd3/cumulativeLineChart.py   | 104 ++++
 airflow/_vendor/nvd3/discreteBarChart.py      |  91 ++++
 airflow/_vendor/nvd3/ipynb.py                 |  91 ++++
 airflow/_vendor/nvd3/lineChart.py             | 120 +++++
 airflow/_vendor/nvd3/linePlusBarChart.py      | 131 +++++
 airflow/_vendor/nvd3/lineWithFocusChart.py    | 105 ++++
 airflow/_vendor/nvd3/multiBarChart.py         |  95 ++++
 .../_vendor/nvd3/multiBarHorizontalChart.py   | 100 ++++
 airflow/_vendor/nvd3/pieChart.py              | 101 ++++
 airflow/_vendor/nvd3/scatterChart.py          | 121 +++++
 airflow/_vendor/nvd3/stackedAreaChart.py      |  99 ++++
 airflow/_vendor/nvd3/templates/base.html      |  35 ++
 airflow/_vendor/nvd3/templates/content.html   | 123 +++++
 .../nvd3/templates/cumulativelinechart.html   |  11 +
 .../nvd3/templates/discretebarchart.html      |  31 ++
 .../nvd3/templates/linebarwfocuschart.html    |  60 +++
 airflow/_vendor/nvd3/templates/linechart.html |  47 ++
 .../nvd3/templates/lineplusbarchart.html      |  44 ++
 .../nvd3/templates/linewfocuschart.html       |  10 +
 .../_vendor/nvd3/templates/multibarchart.html |  10 +
 .../templates/multibarcharthorizontal.html    |  10 +
 airflow/_vendor/nvd3/templates/page.html      |  12 +
 airflow/_vendor/nvd3/templates/piechart.html  |  80 +++
 .../_vendor/nvd3/templates/scatterchart.html  |  52 ++
 .../nvd3/templates/stackedareachart.html      |   7 +
 airflow/_vendor/nvd3/translator.py            |  71 +++
 airflow/_vendor/slugify/LICENSE               |  21 +
 airflow/_vendor/slugify/__init__.py           |   6 +
 airflow/_vendor/slugify/slugify.py            | 185 +++++++
 airflow/www/views.py                          |   2 +-
 airflow/www_rbac/views.py                     |   2 +-
 licenses/LICENSE-python-nvd3.txt              |  24 +
 licenses/LICENSE-python-slugify.txt           |  21 +
 setup.py                                      |   3 +-
 45 files changed, 2631 insertions(+), 5 deletions(-)
 create mode 100644 airflow/_vendor/README
 create mode 100644 airflow/_vendor/__init__.py
 create mode 100644 airflow/_vendor/nvd3/LICENSE
 create mode 100644 airflow/_vendor/nvd3/NVD3Chart.py
 create mode 100755 airflow/_vendor/nvd3/__init__.py
 create mode 100644 airflow/_vendor/nvd3/cumulativeLineChart.py
 create mode 100644 airflow/_vendor/nvd3/discreteBarChart.py
 create mode 100644 airflow/_vendor/nvd3/ipynb.py
 create mode 100644 airflow/_vendor/nvd3/lineChart.py
 create mode 100644 airflow/_vendor/nvd3/linePlusBarChart.py
 create mode 100644 airflow/_vendor/nvd3/lineWithFocusChart.py
 create mode 100644 airflow/_vendor/nvd3/multiBarChart.py
 create mode 100644 airflow/_vendor/nvd3/multiBarHorizontalChart.py
 create mode 100644 airflow/_vendor/nvd3/pieChart.py
 create mode 100644 airflow/_vendor/nvd3/scatterChart.py
 create mode 100644 airflow/_vendor/nvd3/stackedAreaChart.py
 create mode 100644 airflow/_vendor/nvd3/templates/base.html
 create mode 100644 airflow/_vendor/nvd3/templates/content.html
 create mode 100644 airflow/_vendor/nvd3/templates/cumulativelinechart.html
 create mode 100644 airflow/_vendor/nvd3/templates/discretebarchart.html
 create mode 100644 airflow/_vendor/nvd3/templates/linebarwfocuschart.html
 create mode 100644 airflow/_vendor/nvd3/templates/linechart.html
 create mode 100644 airflow/_vendor/nvd3/templates/lineplusbarchart.html
 create mode 100644 airflow/_vendor/nvd3/templates/linewfocuschart.html
 create mode 100644 airflow/_vendor/nvd3/templates/multibarchart.html
 create mode 100644 airflow/_vendor/nvd3/templates/multibarcharthorizontal.html
 create mode 100644 airflow/_vendor/nvd3/templates/page.html
 create mode 100644 airflow/_vendor/nvd3/templates/piechart.html
 create mode 100644 airflow/_vendor/nvd3/templates/scatterchart.html
 create mode 100644 airflow/_vendor/nvd3/templates/stackedareachart.html
 create mode 100644 airflow/_vendor/nvd3/translator.py
 create mode 100644 airflow/_vendor/slugify/LICENSE
 create mode 100644 airflow/_vendor/slugify/__init__.py
 create mode 100644 airflow/_vendor/slugify/slugify.py
 create mode 100644 licenses/LICENSE-python-nvd3.txt
 create mode 100644 licenses/LICENSE-python-slugify.txt

diff --git a/.flake8 b/.flake8
index e2ba4cbf6f631..368fdb4331a12 100644
--- a/.flake8
+++ b/.flake8
@@ -1,3 +1,4 @@
 [flake8]
 max-line-length = 110
 ignore = E731,W504
+exclude = .svn,CVS,.bzr,.hg,.git,__pycache__,.tox,.eggs,*.egg,*/_vendor/*
diff --git a/.rat-excludes b/.rat-excludes
index 786920076dd57..fb9361f7f39fc 100644
--- a/.rat-excludes
+++ b/.rat-excludes
@@ -59,3 +59,6 @@ coverage.xml
 rat-results.txt
 apache-airflow-.*\+source.tar.gz.*
 apache-airflow-.*\+bin.tar.gz.*
+
+# vendored modules
+_vendor/*
diff --git a/.travis.yml b/.travis.yml
index 934b0d749b1f1..4dd39771e1a4a 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -22,7 +22,6 @@ language: python
 env:
   global:
     - DOCKER_COMPOSE_VERSION=1.20.0
-    - SLUGIFY_USES_TEXT_UNIDECODE=yes
     - TRAVIS_CACHE=$HOME/.travis_cache/
   matrix:
     - TOX_ENV=flake8
diff --git a/LICENSE b/LICENSE
index debddc0d7bb79..e3335acb8014a 100644
--- a/LICENSE
+++ b/LICENSE
@@ -240,6 +240,8 @@ The text of each license is also included at licenses/LICENSE-[project].txt.
     (MIT License) normalize.css v3.0.2 (http://necolas.github.io/normalize.css/)
     (MIT License) ElasticMock v1.3.2 (https://github.com/vrcmarcos/elasticmock)
     (MIT License) MomentJS v2.22.2 (http://momentjs.com/)
+    (MIT License) python-slugify v2.0.1 (https://github.com/un33k/python-slugify)
+    (MIT License) python-nvd3 v0.15.0 (https://github.com/areski/python-nvd3)
 
 ========================================================================
 BSD 2-Clause licenses
diff --git a/MANIFEST.in b/MANIFEST.in
index 2ad56c61dbfdc..5f0921dabf979 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -27,8 +27,10 @@ graft airflow/www_rbac
 graft airflow/www_rbac/static
 graft airflow/www_rbac/templates
 graft airflow/www_rbac/translations
+graft airflow/_vendor/
 include airflow/alembic.ini
 graft scripts/systemd
 graft scripts/upstart
 graft airflow/config_templates
 recursive-exclude airflow/www_rbac/node_modules *
+global-exclude __pycache__  *.pyc
diff --git a/NOTICE b/NOTICE
index 962cd8a71a425..2e6202e30e809 100644
--- a/NOTICE
+++ b/NOTICE
@@ -24,3 +24,15 @@ This product contains a modified portion of 'Hue' developed by Cloudera, Inc.
 (https://github.com/cloudera/hue/).
 
 * Copyright 2009-2017 Cloudera Inc.
+
+python-slugify:
+---------------
+
+* Copyright (c) Val Neekman @ Neekware Inc. http://neekware.com
+
+python-nvd3:
+------------
+
+* Copyright (c) 2013 Arezqui Belaid <areski@gmail.com> and other contributors
+
+
diff --git a/airflow/_vendor/README b/airflow/_vendor/README
new file mode 100644
index 0000000000000..a79ea89eae536
--- /dev/null
+++ b/airflow/_vendor/README
@@ -0,0 +1,13 @@
+Original files in this directory were created with the following commands::
+
+    mkdir -p slugify/
+    curl -fsSL -O https://files.pythonhosted.org/packages/1f/9c/8b07d625e9c9df567986d887f0375075abb1923e49d074a7803cd1527dae/python-slugify-2.0.1.tar.gz
+    tar -xzf python-slugify-*.tar.gz --strip-components=2 -C slugify/ '*/slugify/*'
+    tar -xzf python-slugify-*.tar.gz --strip-components=1 -C slugify/ '*/LICENSE'
+    rm *.tar.gz
+
+    mkdir -p nvd3/
+    curl -fsSL -O https://files.pythonhosted.org/packages/0b/aa/97165daa6e319409c5c2582e62736a7353bda3c90d90fdcb0b11e116dd2d/python-nvd3-0.15.0.tar.gz
+    tar -xzf python-nvd3-*.tar.gz --strip-components=2 -C nvd3/ '*/nvd3/*'
+    tar -xzf python-nvd3-*.tar.gz --strip-components=1 -C nvd3/ '*/LICENSE'
+    rm *.tar.gz
diff --git a/airflow/_vendor/__init__.py b/airflow/_vendor/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/airflow/_vendor/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/airflow/_vendor/nvd3/LICENSE b/airflow/_vendor/nvd3/LICENSE
new file mode 100644
index 0000000000000..1add6249e57b4
--- /dev/null
+++ b/airflow/_vendor/nvd3/LICENSE
@@ -0,0 +1,24 @@
+The MIT License (MIT)
+
+Python-nvd3
+
+Copyright (c) 2013 Arezqui Belaid <areski@gmail.com> and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/airflow/_vendor/nvd3/NVD3Chart.py b/airflow/_vendor/nvd3/NVD3Chart.py
new file mode 100644
index 0000000000000..faefe5d3a0fcf
--- /dev/null
+++ b/airflow/_vendor/nvd3/NVD3Chart.py
@@ -0,0 +1,506 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from __future__ import unicode_literals
+from optparse import OptionParser
+from jinja2 import Environment, PackageLoader
+from airflow._vendor.slugify import slugify
+
+try:
+    import simplejson as json
+except ImportError:
+    import json
+
+CONTENT_FILENAME = "./content.html"
+PAGE_FILENAME = "./page.html"
+
+
+pl = PackageLoader('airflow._vendor.nvd3', 'templates')
+jinja2_env = Environment(lstrip_blocks=True, trim_blocks=True, loader=pl)
+
+template_content = jinja2_env.get_template(CONTENT_FILENAME)
+template_page = jinja2_env.get_template(PAGE_FILENAME)
+
+
+def stab(tab=1):
+    """
+    create space tabulation
+    """
+    return ' ' * 4 * tab
+
+
+class NVD3Chart(object):
+    """
+    NVD3Chart Base class.
+    """
+    #: chart count
+    count = 0
+    #:  directory holding the assets (bower_components)
+    assets_directory = './bower_components/'
+
+    # this attribute is overriden by children of this
+    # class
+    CHART_FILENAME = None
+    template_environment = Environment(lstrip_blocks=True, trim_blocks=True,
+                                       loader=pl)
+
+    def __init__(self, **kwargs):
+        """
+        This is the base class for all the charts. The following keywords are
+        accepted:
+
+        :keyword: **display_container** - default: ``True``
+        :keyword: **jquery_on_ready** - default: ``False``
+        :keyword: **charttooltip_dateformat** - default: ``'%d %b %Y'``
+        :keyword: **name** - default: the class name
+                    ``model`` - set the model (e.g. ``pieChart``, `
+                    ``LineWithFocusChart``, ``MultiBarChart``).
+        :keyword: **color_category** - default - ``None``
+        :keyword: **color_list** - default - ``None``
+                  used by pieChart (e.g. ``['red', 'blue', 'orange']``)
+        :keyword: **margin_bottom** - default - ``20``
+        :keyword: **margin_left** - default - ``60``
+        :keyword: **margin_right** - default - ``60``
+        :keyword: **margin_top** - default - ``30``
+        :keyword: **height** - default - ``''``
+        :keyword: **width** - default - ``''``
+        :keyword: **stacked** - default - ``False``
+        :keyword: **focus_enable** - default - ``False``
+        :keyword: **resize** - define - ``False``
+        :keyword: **show_legend** - default - ``True``
+        :keyword: **show_labels** - default - ``True``
+        :keyword: **tag_script_js** - default - ``True``
+        :keyword: **use_interactive_guideline** - default - ``False``
+        :keyword: **chart_attr** - default - ``None``
+        :keyword: **extras** - default - ``None``
+
+            Extra chart modifiers. Use this to modify different attributes of
+            the chart.
+        :keyword: **x_axis_date** - default - False
+            Signal that x axis is a date axis
+        :keyword: **date_format** - default - ``%x``
+                  see https://github.com/mbostock/d3/wiki/Time-Formatting
+        :keyword: **x_axis_format** - default - ``''``.
+        :keyword: **y_axis_format** - default - ``''``.
+        :keyword: **style** - default - ``''``
+            Style modifiers for the DIV container.
+        :keyword: **color_category** - default - ``category10``
+
+            Acceptable values are nvd3 categories such as
+            ``category10``, ``category20``, ``category20c``.
+        """
+        # set the model
+        self.model = self.__class__.__name__  #: The chart model,
+
+        #: an Instance of Jinja2 template
+        self.template_page_nvd3 = template_page
+        self.template_content_nvd3 = template_content
+        self.series = []
+        self.axislist = {}
+        # accepted keywords
+        self.display_container = kwargs.get('display_container', True)
+        self.charttooltip_dateformat = kwargs.get('charttooltip_dateformat',
+                                                  '%d %b %Y')
+        self._slugify_name(kwargs.get('name', self.model))
+        self.jquery_on_ready = kwargs.get('jquery_on_ready', False)
+        self.color_category = kwargs.get('color_category', None)
+        self.color_list = kwargs.get('color_list', None)
+        self.margin_bottom = kwargs.get('margin_bottom', 20)
+        self.margin_left = kwargs.get('margin_left', 60)
+        self.margin_right = kwargs.get('margin_right', 60)
+        self.margin_top = kwargs.get('margin_top', 30)
+        self.height = kwargs.get('height', '')
+        self.width = kwargs.get('width', '')
+        self.stacked = kwargs.get('stacked', False)
+        self.focus_enable = kwargs.get('focus_enable', False)
+        self.resize = kwargs.get('resize', False)
+        self.show_legend = kwargs.get('show_legend', True)
+        self.show_labels = kwargs.get('show_labels', True)
+        self.tag_script_js = kwargs.get('tag_script_js', True)
+        self.use_interactive_guideline = kwargs.get("use_interactive_guideline",
+                                                    False)
+        self.chart_attr = kwargs.get("chart_attr", {})
+        self.extras = kwargs.get('extras', None)
+        self.style = kwargs.get('style', '')
+        self.date_format = kwargs.get('date_format', '%x')
+        self.x_axis_date = kwargs.get('x_axis_date', False)
+        #: x-axis contain date format or not
+        # possible duplicate of x_axis_date
+        self.date_flag = kwargs.get('date_flag', False)
+        self.x_axis_format = kwargs.get('x_axis_format', '')
+        # Load remote JS assets or use the local bower assets?
+        self.remote_js_assets = kwargs.get('remote_js_assets', True)
+
+        # None keywords attribute that should be modified by methods
+        # We should change all these to _attr
+
+        self.htmlcontent = ''  #: written by buildhtml
+        self.htmlheader = ''
+        #: Place holder for the graph (the HTML div)
+        #: Written by ``buildcontainer``
+        self.container = u''
+        #: Header for javascript code
+        self.containerheader = u''
+        # CDN http://cdnjs.com/libraries/nvd3/ needs to make sure it's up to
+        # date
+        self.header_css = [
+            '<link href="%s" rel="stylesheet" />' % h for h in
+            (
+                'https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.css' if self.remote_js_assets else self.assets_directory + 'nvd3/src/nv.d3.css',
+            )
+        ]
+
+        self.header_js = [
+            '<script src="%s"></script>' % h for h in
+            (
+                'https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.5/d3.min.js' if self.remote_js_assets else self.assets_directory + 'd3/d3.min.js',
+                'https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.js' if self.remote_js_assets else self.assets_directory + 'nvd3/nv.d3.min.js'
+            )
+        ]
+
+        #: Javascript code as string
+        self.jschart = None
+        self.custom_tooltip_flag = False
+        self.tooltip_condition_string = ''
+        self.charttooltip = ''
+        self.serie_no = 1
+
+    def _slugify_name(self, name):
+        """Slufigy name with underscore"""
+        self.name = slugify(name, separator='_')
+
+    def add_serie(self, y, x, name=None, extra=None, **kwargs):
+        """
+        add serie - Series are list of data that will be plotted
+        y {1, 2, 3, 4, 5} / x {1, 2, 3, 4, 5}
+
+        **Attributes**:
+
+            * ``name`` - set Serie name
+            * ``x`` - x-axis data
+            * ``y`` - y-axis data
+
+            kwargs:
+
+            * ``shape`` - for scatterChart, you can set different shapes
+                          (circle, triangle etc...)
+            * ``size`` - for scatterChart, you can set size of different shapes
+            * ``type`` - for multiChart, type should be bar
+            * ``bar`` - to display bars in Chart
+            * ``color_list`` - define list of colors which will be
+                               used by pieChart
+            * ``color`` - set axis color
+            * ``disabled`` -
+
+            extra:
+
+            * ``tooltip`` - set tooltip flag
+            * ``date_format`` - set date_format for tooltip if x-axis is in
+              date format
+
+        """
+        if not name:
+            name = "Serie %d" % (self.serie_no)
+
+        # For scatterChart shape & size fields are added in serie
+        if 'shape' in kwargs or 'size' in kwargs:
+            csize = kwargs.get('size', 1)
+            cshape = kwargs.get('shape', 'circle')
+
+            serie = [{
+                'x': x[i],
+                'y': j,
+                'shape': cshape,
+                'size': csize[i] if isinstance(csize, list) else csize
+            } for i, j in enumerate(y)]
+        else:
+            if self.model == 'pieChart':
+                serie = [{'label': x[i], 'value': y} for i, y in enumerate(y)]
+            else:
+                serie = [{'x': x[i], 'y': y} for i, y in enumerate(y)]
+
+        data_keyvalue = {'values': serie, 'key': name}
+
+        # multiChart
+        # Histogram type='bar' for the series
+        if 'type' in kwargs and kwargs['type']:
+            data_keyvalue['type'] = kwargs['type']
+
+        # Define on which Y axis the serie is related
+        # a chart can have 2 Y axis, left and right, by default only one Y Axis is used
+        if 'yaxis' in kwargs and kwargs['yaxis']:
+            data_keyvalue['yAxis'] = kwargs['yaxis']
+        else:
+            if self.model != 'pieChart':
+                data_keyvalue['yAxis'] = '1'
+
+        if 'bar' in kwargs and kwargs['bar']:
+            data_keyvalue['bar'] = 'true'
+
+        if 'disabled' in kwargs and kwargs['disabled']:
+            data_keyvalue['disabled'] = 'true'
+
+        if 'color' in kwargs and kwargs['color']:
+            data_keyvalue['color'] = kwargs['color']
+
+        if extra:
+            if self.model == 'pieChart':
+                if 'color_list' in extra and extra['color_list']:
+                    self.color_list = extra['color_list']
+
+            if extra.get('date_format'):
+                self.charttooltip_dateformat = extra['date_format']
+
+            if extra.get('tooltip'):
+                self.custom_tooltip_flag = True
+
+                if self.model != 'pieChart':
+                    _start = extra['tooltip']['y_start']
+                    _end = extra['tooltip']['y_end']
+                    _start = ("'" + str(_start) + "' + ") if _start else ''
+                    _end = (" + '" + str(_end) + "'") if _end else ''
+
+                    if self.model == 'linePlusBarChart':
+                        if self.tooltip_condition_string:
+                            self.tooltip_condition_string += stab(5)
+                        self.tooltip_condition_string += stab(0) + "if(key.indexOf('" + name + "') > -1 ){\n" +\
+                            stab(6) + "var y = " + _start + " String(graph.point.y) " + _end + ";\n" +\
+                            stab(5) + "}\n"
+                    elif self.model == 'cumulativeLineChart':
+                        self.tooltip_condition_string += stab(0) + "if(key == '" + name + "'){\n" +\
+                            stab(6) + "var y = " + _start + " String(e) " + _end + ";\n" +\
+                            stab(5) + "}\n"
+                    else:
+                        self.tooltip_condition_string += stab(5) + "if(key == '" + name + "'){\n" +\
+                            stab(6) + "var y = " + _start + " String(graph.point.y) " + _end + ";\n" +\
+                            stab(5) + "}\n"
+
+                if self.model == 'pieChart':
+                    _start = extra['tooltip']['y_start']
+                    _end = extra['tooltip']['y_end']
+                    _start = ("'" + str(_start) + "' + ") if _start else ''
+                    _end = (" + '" + str(_end) + "'") if _end else ''
+                    self.tooltip_condition_string += "var y = " + _start + " String(y) " + _end + ";\n"
+
+        # Increment series counter & append
+        self.serie_no += 1
+        self.series.append(data_keyvalue)
+
+    def add_chart_extras(self, extras):
+        """
+        Use this method to add extra d3 properties to your chart.
+        For example, you want to change the text color of the graph::
+
+            chart = pieChart(name='pieChart', color_category='category20c', height=400, width=400)
+
+            xdata = ["Orange", "Banana", "Pear", "Kiwi", "Apple", "Strawberry", "Pineapple"]
+            ydata = [3, 4, 0, 1, 5, 7, 3]
+
+            extra_serie = {"tooltip": {"y_start": "", "y_end": " cal"}}
+            chart.add_serie(y=ydata, x=xdata, extra=extra_serie)
+
+        The above code will create graph with a black text, the following will change it::
+
+            text_white="d3.selectAll('#pieChart text').style('fill', 'white');"
+            chart.add_chart_extras(text_white)
+
+        The above extras will be appended to the java script generated.
+
+        Alternatively, you can use the following initialization::
+
+            chart = pieChart(name='pieChart',
+                             color_category='category20c',
+                             height=400, width=400,
+                             extras=text_white)
+        """
+        self.extras = extras
+
+    def set_graph_height(self, height):
+        """Set Graph height"""
+        self.height = str(height)
+
+    def set_graph_width(self, width):
+        """Set Graph width"""
+        self.width = str(width)
+
+    def set_containerheader(self, containerheader):
+        """Set containerheader"""
+        self.containerheader = containerheader
+
+    def set_date_flag(self, date_flag=False):
+        """Set date flag"""
+        self.date_flag = date_flag
+
+    def set_custom_tooltip_flag(self, custom_tooltip_flag):
+        """Set custom_tooltip_flag & date_flag"""
+        self.custom_tooltip_flag = custom_tooltip_flag
+
+    def __str__(self):
+        """return htmlcontent"""
+        self.buildhtml()
+        return self.htmlcontent
+
+    def buildcontent(self):
+        """Build HTML content only, no header or body tags. To be useful this
+        will usually require the attribute `juqery_on_ready` to be set which
+        will wrap the js in $(function(){<regular_js>};)
+        """
+        self.buildcontainer()
+        # if the subclass has a method buildjs this method will be
+        # called instead of the method defined here
+        # when this subclass method is entered it does call
+        # the method buildjschart defined here
+        self.buildjschart()
+        self.htmlcontent = self.template_content_nvd3.render(chart=self)
+
+    def buildhtml(self):
+        """Build the HTML page
+        Create the htmlheader with css / js
+        Create html page
+        Add Js code for nvd3
+        """
+        self.buildcontent()
+        self.content = self.htmlcontent
+        self.htmlcontent = self.template_page_nvd3.render(chart=self)
+
+    # this is used by django-nvd3
+    def buildhtmlheader(self):
+        """generate HTML header content"""
+        self.htmlheader = ''
+        # If the JavaScript assets have already been injected, don't bother re-sourcing them.
+        global _js_initialized
+        if '_js_initialized' not in globals() or not _js_initialized:
+            for css in self.header_css:
+                self.htmlheader += css
+            for js in self.header_js:
+                self.htmlheader += js
+
+    def buildcontainer(self):
+        """generate HTML div"""
+        if self.container:
+            return
+
+        # Create SVG div with style
+        if self.width:
+            if self.width[-1] != '%':
+                self.style += 'width:%spx;' % self.width
+            else:
+                self.style += 'width:%s;' % self.width
+        if self.height:
+            if self.height[-1] != '%':
+                self.style += 'height:%spx;' % self.height
+            else:
+                self.style += 'height:%s;' % self.height
+        if self.style:
+            self.style = 'style="%s"' % self.style
+
+        self.container = self.containerheader + \
+            '<div id="%s"><svg %s></svg></div>\n' % (self.name, self.style)
+
+    def buildjschart(self):
+        """generate javascript code for the chart"""
+        self.jschart = ''
+
+        # add custom tooltip string in jschart
+        # default condition (if build_custom_tooltip is not called explicitly with date_flag=True)
+        if self.tooltip_condition_string == '':
+            self.tooltip_condition_string = 'var y = String(graph.point.y);\n'
+
+        # Include data
+        self.series_js = json.dumps(self.series)
+
+    def create_x_axis(self, name, label=None, format=None, date=False, custom_format=False):
+        """Create X-axis"""
+        axis = {}
+        if custom_format and format:
+            axis['tickFormat'] = format
+        elif format:
+            if format == 'AM_PM':
+                axis['tickFormat'] = "function(d) { return get_am_pm(parseInt(d)); }"
+            else:
+                axis['tickFormat'] = "d3.format(',%s')" % format
+
+        if label:
+            axis['axisLabel'] = "'" + label + "'"
+
+        # date format : see https://github.com/mbostock/d3/wiki/Time-Formatting
+        if date:
+            self.dateformat = format
+            axis['tickFormat'] = ("function(d) { return d3.time.format('%s')"
+                                  "(new Date(parseInt(d))) }\n"
+                                  "" % self.dateformat)
+            # flag is the x Axis is a date
+            if name[0] == 'x':
+                self.x_axis_date = True
+
+        # Add new axis to list of axis
+        self.axislist[name] = axis
+
+        # Create x2Axis if focus_enable
+        if name == "xAxis" and self.focus_enable:
+            self.axislist['x2Axis'] = axis
+
+    def create_y_axis(self, name, label=None, format=None, custom_format=False):
+        """
+        Create Y-axis
+        """
+        axis = {}
+
+        if custom_format and format:
+            axis['tickFormat'] = format
+        elif format:
+            axis['tickFormat'] = "d3.format(',%s')" % format
+
+        if label:
+            axis['axisLabel'] = "'" + label + "'"
+
+        # Add new axis to list of axis
+        self.axislist[name] = axis
+
+
+class TemplateMixin(object):
+    """
+    A mixin that override buildcontent. Instead of building the complex
+    content template we exploit Jinja2 inheritance. Thus each chart class
+    renders it's own chart template which inherits from content.html
+    """
+    def buildcontent(self):
+        """Build HTML content only, no header or body tags. To be useful this
+        will usually require the attribute `juqery_on_ready` to be set which
+        will wrap the js in $(function(){<regular_js>};)
+        """
+        self.buildcontainer()
+        # if the subclass has a method buildjs this method will be
+        # called instead of the method defined here
+        # when this subclass method is entered it does call
+        # the method buildjschart defined here
+        self.buildjschart()
+        self.htmlcontent = self.template_chart_nvd3.render(chart=self)
+
+
+def _main():
+    """
+    Parse options and process commands
+    """
+    # Parse arguments
+    usage = "usage: nvd3.py [options]"
+    parser = OptionParser(usage=usage,
+                          version=("python-nvd3 - Charts generator with "
+                                   "nvd3.js and d3.js"))
+    parser.add_option("-q", "--quiet",
+                      action="store_false", dest="verbose", default=True,
+                      help="don't print messages to stdout")
+
+    (options, args) = parser.parse_args()
+
+
+if __name__ == '__main__':
+    _main()
diff --git a/airflow/_vendor/nvd3/__init__.py b/airflow/_vendor/nvd3/__init__.py
new file mode 100755
index 0000000000000..5b737b45361ad
--- /dev/null
+++ b/airflow/_vendor/nvd3/__init__.py
@@ -0,0 +1,29 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+__version__ = '0.15.0'
+__all__ = ['lineChart', 'pieChart', 'lineWithFocusChart',
+           'stackedAreaChart', 'multiBarHorizontalChart',
+           'linePlusBarChart', 'cumulativeLineChart',
+           'scatterChart', 'discreteBarChart', 'multiBarChart']
+
+
+from .lineChart import lineChart
+from .pieChart import pieChart
+from .lineWithFocusChart import lineWithFocusChart
+from .stackedAreaChart import stackedAreaChart
+from .multiBarHorizontalChart import multiBarHorizontalChart
+from .linePlusBarChart import linePlusBarChart
+from .cumulativeLineChart import cumulativeLineChart
+from .scatterChart import scatterChart
+from .discreteBarChart import discreteBarChart
+from .multiBarChart import multiBarChart
+from . import ipynb
diff --git a/airflow/_vendor/nvd3/cumulativeLineChart.py b/airflow/_vendor/nvd3/cumulativeLineChart.py
new file mode 100644
index 0000000000000..d98d0867e4d99
--- /dev/null
+++ b/airflow/_vendor/nvd3/cumulativeLineChart.py
@@ -0,0 +1,104 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class cumulativeLineChart(TemplateMixin, NVD3Chart):
+    """
+    A cumulative line chart is used when you have one important grouping representing
+    an ordered set of data and one value to show, summed over time.
+
+    Python example::
+
+        from nvd3 import cumulativeLineChart
+        chart = cumulativeLineChart(name='cumulativeLineChart', x_is_date=True)
+        xdata = [1365026400000000, 1365026500000000, 1365026600000000]
+        ydata = [6, 5, 1]
+        y2data = [36, 55, 11]
+
+        extra_serie = {"tooltip": {"y_start": "There are ", "y_end": " calls"}}
+        chart.add_serie(name="Serie 1", y=ydata, x=xdata, extra=extra_serie)
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " mins"}}
+        chart.add_serie(name="Serie 2", y=y2data, x=xdata, extra=extra_serie)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="cumulativeLineChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+            data_cumulativeLineChart=[{"values": [{"y": 6, "x": 1365026400000000},
+            {"y": 5, "x": 1365026500000000},
+            {"y": 1, "x": 1365026600000000}],
+            "key": "Serie 1", "yAxis": "1"},
+            {"values": [{"y": 36, "x": 1365026400000000},
+            {"y": 55, "x": 1365026500000000},
+            {"y": 11, "x": 1365026600000000}], "key": "Serie 2", "yAxis": "1"}];
+            nv.addGraph(function() {
+                var chart = nv.models.cumulativeLineChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_cumulativeLineChart;
+
+                        chart.xAxis
+                            .tickFormat(function(d) { return d3.time.format('%d %b %Y')(new Date(parseInt(d))) });
+                        chart.yAxis
+                            .tickFormat(d3.format(',.1%'));
+
+                    chart.tooltipContent(function(key, y, e, graph) {
+                        var x = d3.time.format("%d %b %Y")(new Date(parseInt(graph.point.x)));
+                        var y = String(graph.point.y);
+                        if(key == 'Serie 1'){
+                                var y = 'There are ' +  String(e)  + ' calls';
+                            }if(key == 'Serie 2'){
+                                var y =  String(e)  + ' mins';
+                            }
+                        tooltip_str = '<center><b>'+key+'</b></center>' + y + ' on ' + x;
+                        return tooltip_str;
+                    });
+                    chart.showLegend(true);
+
+                d3.select('#cumulativeLineChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('height', 450)
+                    .call(chart); });
+        </script>
+
+    """
+
+    CHART_FILENAME = "./cumulativelinechart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(cumulativeLineChart, self).__init__(**kwargs)
+        self.model = 'cumulativeLineChart'
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format', '%d %b %Y'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            self.create_x_axis('xAxis', format=kwargs.get(
+                'x_axis_format', '.2f'))
+
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.1%'))
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/discreteBarChart.py b/airflow/_vendor/nvd3/discreteBarChart.py
new file mode 100644
index 0000000000000..cf6c8a4a8ff4b
--- /dev/null
+++ b/airflow/_vendor/nvd3/discreteBarChart.py
@@ -0,0 +1,91 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class discreteBarChart(TemplateMixin, NVD3Chart):
+    """
+    A discrete bar chart or bar graph is a chart with rectangular bars with
+    lengths proportional to the values that they represent.
+
+    Python example::
+
+        from nvd3 import discreteBarChart
+        chart = discreteBarChart(name='discreteBarChart', height=400, width=400)
+
+        xdata = ["A", "B", "C", "D", "E", "F"]
+        ydata = [3, 4, 0, -3, 5, 7]
+
+        chart.add_serie(y=ydata, x=xdata)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="discreteBarChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+            data_discreteBarChart=[{"values": [{"y": 3, "x": "A"}, {"y": 4, "x": "B"}, {"y": 0, "x": "C"}, {"y": -3, "x": "D"}, {"y": 5, "x": "E"}, {"y": 7, "x": "F"}], "key": "Serie 1", "yAxis": "1"}];
+
+            nv.addGraph(function() {
+                var chart = nv.models.discreteBarChart();
+
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+
+                var datum = data_discreteBarChart;
+                        chart.yAxis
+                            .tickFormat(d3.format(',.0f'));
+                        chart.tooltipContent(function(key, y, e, graph) {
+                            var x = String(graph.point.x);
+                            var y = String(graph.point.y);
+                            var y = String(graph.point.y);
+
+                            tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                            return tooltip_str;
+                        });
+
+                d3.select('#discreteBarChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 400)
+                    .attr('height', 400)
+                    .call(chart);
+            });
+        </script>
+
+
+    """
+    CHART_FILENAME = "./discretebarchart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(discreteBarChart, self).__init__(**kwargs)
+        self.model = 'discreteBarChart'
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format',
+                                                 "%d %b %Y %H %S"),
+                               date=True)
+        else:
+            self.create_x_axis('xAxis', format=None)
+
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', ".0f"))
+
+        self.set_custom_tooltip_flag(True)
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/ipynb.py b/airflow/_vendor/nvd3/ipynb.py
new file mode 100644
index 0000000000000..f421afc0a8a50
--- /dev/null
+++ b/airflow/_vendor/nvd3/ipynb.py
@@ -0,0 +1,91 @@
+'''
+ipython compatability module for nvd3-python
+This adds simple ipython compatibility to the nvd3-python package, without making any
+major modifications to how the main package is structured.  It utilizes the IPython
+display-formatter functionality, as described at:
+http://nbviewer.ipython.org/github/ipython/ipython/blob/master/examples/notebooks/Custom%20Display%20Logic.ipynb
+For additional examples, see:
+https://github.com/sympy/sympy/blob/master/sympy/interactive/printing.py
+'''
+
+try:
+    _ip = get_ipython()
+except:
+    _ip = None
+if _ip and _ip.__module__.lower().startswith('ipy'):
+    global _js_initialized
+    _js_initialized = False
+
+    def _print_html(chart):
+        '''Function to return the HTML code for the div container plus the javascript
+        to generate the chart.  This function is bound to the ipython formatter so that
+        charts are displayed inline.'''
+        global _js_initialized
+        if not _js_initialized:
+            print('js not initialized - pausing to allow time for it to load...')
+            initialize_javascript()
+            import time
+            time.sleep(5)
+        chart.buildhtml()
+        return chart.htmlcontent
+
+    def _setup_ipython_formatter(ip):
+        ''' Set up the ipython formatter to display HTML formatted output inline'''
+        from IPython import __version__ as IPython_version
+        from nvd3 import __all__ as nvd3_all
+
+        if IPython_version >= '0.11':
+            html_formatter = ip.display_formatter.formatters['text/html']
+            for chart_type in nvd3_all:
+                html_formatter.for_type_by_name('nvd3.' + chart_type, chart_type, _print_html)
+
+    def initialize_javascript(d3_js_url='https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.5/d3.min.js',
+                              nvd3_js_url='https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.js',
+                              nvd3_css_url='https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.css',
+                              use_remote=False):
+        '''Initialize the ipython notebook to be able to display nvd3 results.
+        by instructing IPython to load the nvd3 JS and css files, and the d3 JS file.
+
+        by default, it looks for the files in your IPython Notebook working directory.
+
+        Takes the following options:
+
+        use_remote: use remote hosts for d3.js, nvd3.js, and nv.d3.css (default False)
+        * Note:  the following options are ignored if use_remote is False:
+        nvd3_css_url: location of nvd3 css file (default https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.css)
+        nvd3_js_url: location of nvd3 javascript file (default  https://cdnjs.cloudflare.com/ajax/libs/nvd3/1.7.0/nv.d3.min.css)
+        d3_js_url: location of d3 javascript file (default https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.5/d3.min.js)
+        '''
+        from IPython.display import display, Javascript, HTML
+
+        if not use_remote:
+            # these file locations are for IPython 1.x, and will probably change when 2.x is released
+            d3_js_url = 'files/d3.v3.js'
+            nvd3_js_url = 'files/nv.d3.js'
+            nvd3_css_url = 'files/nv.d3.css'
+
+        # load the required javascript files
+
+        #display(Javascript('''$.getScript("%s")''' %(d3_js_url)))
+        display(HTML('''<link media="all" href="%s" type="text/css"
+                        rel="stylesheet"/>''' % (nvd3_css_url)))
+        # The following two methods for loading the script file are redundant.
+        # This is intentional.
+        # Ipython's loading of javscript in version 1.x is a bit squirrely, especially
+        # when creating demos to view in nbviewer.
+        # by trying twice, in two different ways (one using jquery and one using plain old
+        # HTML), we maximize our chances of successfully loading the script.
+        display(Javascript('''$.getScript("%s")''' % (nvd3_js_url)))
+        display(Javascript('''$.getScript("%s", function() {
+                              $.getScript("%s", function() {})});''' % (d3_js_url, nvd3_js_url)))
+        display(HTML('<script src="%s"></script>' % (d3_js_url)))
+        display(HTML('<script src="%s"></script>' % (nvd3_js_url)))
+
+        global _js_initialized
+        _js_initialized = True
+
+    print('loaded nvd3 IPython extension\n'
+          'run nvd3.ipynb.initialize_javascript() to set up the notebook\n'
+          'help(nvd3.ipynb.initialize_javascript) for options')
+
+    _setup_ipython_formatter(_ip)
diff --git a/airflow/_vendor/nvd3/lineChart.py b/airflow/_vendor/nvd3/lineChart.py
new file mode 100644
index 0000000000000..c237d069802ad
--- /dev/null
+++ b/airflow/_vendor/nvd3/lineChart.py
@@ -0,0 +1,120 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class lineChart(TemplateMixin, NVD3Chart):
+
+    """
+    A line chart or line graph is a type of chart which displays information
+    as a series of data points connected by straight line segments.
+
+    Python example::
+
+        from nvd3 import lineChart
+        chart = lineChart(name="lineChart", x_is_date=False, x_axis_format="AM_PM")
+
+        xdata = range(24)
+        ydata = [0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 4, 3, 3, 5, 7, 5, 3, 16, 6, 9, 15, 4, 12]
+        ydata2 = [9, 8, 11, 8, 3, 7, 10, 8, 6, 6, 9, 6, 5, 4, 3, 10, 0, 6, 3, 1, 0, 0, 0, 1]
+
+        extra_serie = {"tooltip": {"y_start": "There are ", "y_end": " calls"}}
+        chart.add_serie(y=ydata, x=xdata, name='sine', extra=extra_serie, **kwargs1)
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " min"}}
+        chart.add_serie(y=ydata2, x=xdata, name='cose', extra=extra_serie, **kwargs2)
+        chart.buildhtml()
+
+    Javascript renderd to:
+
+    .. raw:: html
+
+        <div id="lineChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+            data_lineChart=[{"values": [{"y": 0, "x": 0}, {"y": 0, "x": 1}, {"y": 1, "x": 2}, {"y": 1, "x": 3}, {"y": 0, "x": 4}, {"y": 0, "x": 5}, {"y": 0, "x": 6}, {"y": 0, "x": 7}, {"y": 1, "x": 8}, {"y": 0, "x": 9}, {"y": 0, "x": 10}, {"y": 4, "x": 11}, {"y": 3, "x": 12}, {"y": 3, "x": 13}, {"y": 5, "x": 14}, {"y": 7, "x": 15}, {"y": 5, "x": 16}, {"y": 3, "x": 17}, {"y": 16, "x": 18}, {"y": 6, "x": 19}, {"y": 9, "x": 20}, {"y": 15, "x": 21}, {"y": 4, "x": 22}, {"y": 12, "x": 23}], "key": "sine", "yAxis": "1"}, {"values": [{"y": 9, "x": 0}, {"y": 8, "x": 1}, {"y": 11, "x": 2}, {"y": 8, "x": 3}, {"y": 3, "x": 4}, {"y": 7, "x": 5}, {"y": 10, "x": 6}, {"y": 8, "x": 7}, {"y": 6, "x": 8}, {"y": 6, "x": 9}, {"y": 9, "x": 10}, {"y": 6, "x": 11}, {"y": 5, "x": 12}, {"y": 4, "x": 13}, {"y": 3, "x": 14}, {"y": 10, "x": 15}, {"y": 0, "x": 16}, {"y": 6, "x": 17}, {"y": 3, "x": 18}, {"y": 1, "x": 19}, {"y": 0, "x": 20}, {"y": 0, "x": 21}, {"y": 0, "x": 22}, {"y": 1, "x": 23}], "key": "cose", "yAxis": "1"}];
+
+            nv.addGraph(function() {
+                var chart = nv.models.lineChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_lineChart;
+                        chart.xAxis
+                            .tickFormat(function(d) { return get_am_pm(parseInt(d)); });
+                        chart.yAxis
+                            .tickFormat(d3.format(',.02f'));
+
+                        chart.tooltipContent(function(key, y, e, graph) {
+                            var x = String(graph.point.x);
+                            var y = String(graph.point.y);
+                                                if(key == 'sine'){
+                                var y = 'There is ' +  String(graph.point.y)  + ' calls';
+                            }
+                            if(key == 'cose'){
+                                var y =  String(graph.point.y)  + ' min';
+                            }
+
+                            tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                            return tooltip_str;
+                        });
+                    chart.showLegend(true);
+                        function get_am_pm(d){
+                    if (d > 12) {
+                        d = d - 12; return (String(d) + 'PM');
+                    }
+                    else {
+                        return (String(d) + 'AM');
+                    }
+                };
+
+                d3.select('#lineChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('height', 200)
+                    .call(chart);
+            return chart;
+        });
+        </script>
+
+    See the source code of this page, to see the underlying javascript.
+    """
+    CHART_FILENAME = "./linechart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(lineChart, self).__init__(**kwargs)
+        self.model = 'lineChart'
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format', '%d %b %Y'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            if kwargs.get('x_axis_format') == 'AM_PM':
+                self.x_axis_format = format = 'AM_PM'
+            else:
+                format = kwargs.get('x_axis_format', 'r')
+            self.create_x_axis('xAxis', format=format,
+                               custom_format=kwargs.get('x_custom_format',
+                                                        False))
+        self.create_y_axis(
+            'yAxis',
+            format=kwargs.get('y_axis_format', '.02f'),
+            custom_format=kwargs.get('y_custom_format', False))
+
+        # must have a specified height, otherwise it superimposes both chars
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/linePlusBarChart.py b/airflow/_vendor/nvd3/linePlusBarChart.py
new file mode 100644
index 0000000000000..4eaa5fc6ffdbf
--- /dev/null
+++ b/airflow/_vendor/nvd3/linePlusBarChart.py
@@ -0,0 +1,131 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class linePlusBarChart(TemplateMixin, NVD3Chart):
+
+    """
+    A linePlusBarChart Chart is a type of chart which displays information
+    as a series of data points connected by straight line segments
+    and with some series with rectangular bars with lengths proportional
+    to the values that they represent.
+
+    Python example::
+
+        from nvd3 import linePlusBarChart
+        chart = linePlusBarChart(name="linePlusBarChart",
+                             width=500, height=400, x_axis_format="%d %b %Y",
+                             x_is_date=True, focus_enable=True,
+                             yaxis2_format="function(d) { return d3.format(',0.3f')(d) }")
+
+        xdata = [1338501600000, 1345501600000, 1353501600000]
+        ydata = [6, 5, 1]
+        y2data = [0.002, 0.003, 0.004]
+
+        extra_serie = {"tooltip": {"y_start": "There are ", "y_end": " calls"},
+                       "date_format": "%d %b %Y %H:%S" }
+        chart.add_serie(name="Serie 1", y=ydata, x=xdata, extra=extra_serie,
+                        bar=True)
+
+        extra_serie = {"tooltip": {"y_start": "There are ", "y_end": " min"}}
+        chart.add_serie(name="Serie 2", y=y2data, x=xdata, extra=extra_serie)
+        chart.buildcontent()
+
+    Note that in case you have two data serie with extreme different numbers,
+    that you would like to format in different ways,
+    you can pass a keyword *yaxis1_format* or *yaxis2_format* when
+    creating the graph.
+
+    In the example above the graph created presents the values of the second
+    data series with three digits right  of the decimal point.
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="linePlusBarChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+            data_linePlusBarChart=[{"bar": "true", "values": [{"y": 6, "x": 1338501600000}, {"y": 5, "x": 1345501600000}, {"y": 1, "x": 1353501600000}], "key": "Serie 1", "yAxis": "1"}, {"values": [{"y": 0.002, "x": 1338501600000}, {"y": 0.003, "x": 1345501600000}, {"y": 0.004, "x": 1353501600000}], "key": "Serie 2", "yAxis": "1"}];
+            nv.addGraph(function() {
+                var chart = nv.models.linePlusBarChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_linePlusBarChart;
+
+                    chart.y2Axis
+                        .tickFormat(function(d) { return d3.format(',0.3f')(d) });
+                    chart.xAxis
+                        .tickFormat(function(d) { return d3.time.format('%d %b %Y')(new Date(parseInt(d))) });
+                    chart.y1Axis
+                        .tickFormat(function(d) { return d3.format(',f')(d) });
+
+                    chart.tooltipContent(function(key, y, e, graph) {
+                        var x = d3.time.format("%d %b %Y %H:%S")(new Date(parseInt(graph.point.x)));
+                        var y = String(graph.point.y);
+                        if(key.indexOf('Serie 1') > -1 ){
+                                var y = 'There are ' +  String(graph.point.y)  + ' calls';
+                            }
+                            if(key.indexOf('Serie 2') > -1 ){
+                                var y = 'There are ' +  String(graph.point.y)  + ' min';
+                            }
+                        tooltip_str = '<center><b>'+key+'</b></center>' + y + ' on ' + x;
+                        return tooltip_str;
+                    });
+                    chart.showLegend(true);
+                d3.select('#linePlusBarChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 500)
+                    .attr('height', 400)
+                    .call(chart);
+            });
+        </script>
+
+    """
+    CHART_FILENAME = "./lineplusbarchart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(linePlusBarChart, self).__init__(**kwargs)
+        self.model = 'linePlusBarChart'
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+        self.yaxis1_format = kwargs.get('yaxis1_format',
+                                        "function(d) { return d3.format(',f')(d) }")
+        self.yaxis2_format = kwargs.get('yaxis2_format',
+                                        "function(d) { return d3.format(',f')(d) }")
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format',
+                                                 '%d %b %Y %H %S'),
+                               date=True)
+            self.create_x_axis('x2Axis', format=kwargs.get('x_axis_format',
+                                                           '%d %b %Y %H %S'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            self.create_x_axis('xAxis', format=kwargs.get('x_axis_format',
+                                                          '.2f'))
+            self.create_x_axis('x2Axis', format=kwargs.get('x_axis_format',
+                                                           '.2f'))
+
+        self.create_y_axis('y1Axis', format=self.yaxis1_format,
+                           custom_format=True)
+        self.create_y_axis('y2Axis', format=self.yaxis2_format,
+                           custom_format=True)
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/lineWithFocusChart.py b/airflow/_vendor/nvd3/lineWithFocusChart.py
new file mode 100644
index 0000000000000..cd26cd4716652
--- /dev/null
+++ b/airflow/_vendor/nvd3/lineWithFocusChart.py
@@ -0,0 +1,105 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class lineWithFocusChart(TemplateMixin, NVD3Chart):
+    """
+    A lineWithFocusChart or line graph is a type of chart which displays information
+    as a series of data points connected by straight line segments.
+    The lineWithFocusChart provide a smaller chart that act as a selector,
+    this is very useful if you want to zoom on a specific time period.
+
+    Python example::
+
+        from nvd3 import lineWithFocusChart
+        chart = lineWithFocusChart(name='lineWithFocusChart', x_is_date=True, x_axis_format="%d %b %Y")
+        xdata = [1365026400000000, 1365026500000000, 1365026600000000, 1365026700000000, 1365026800000000, 1365026900000000, 1365027000000000]
+        ydata = [-6, 5, -1, 2, 4, 8, 10]
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " ext"},
+                       "date_format": "%d %b %Y"}
+        chart.add_serie(name="Serie 1", y=ydata, x=xdata, extra=extra_serie)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="lineWithFocusChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+            data_lineWithFocusChart=[{"values": [{"y": -6, "x": 1365026400000000}, {"y": 5, "x": 1365026500000000}, {"y": -1, "x": 1365026600000000}], "key": "Serie 1", "yAxis": "1"}];
+            nv.addGraph(function() {
+                var chart = nv.models.lineWithFocusChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_lineWithFocusChart;
+                        chart.yAxis
+                            .tickFormat(d3.format(',.2f'));
+                        chart.y2Axis
+                            .tickFormat(d3.format(',.2f'));
+                        chart.xAxis
+                            .tickFormat(function(d) { return d3.time.format('%d %b %Y')(new Date(parseInt(d))) });
+                        chart.x2Axis
+                            .tickFormat(function(d) { return d3.time.format('%d %b %Y')(new Date(parseInt(d))) });
+
+                    chart.tooltipContent(function(key, y, e, graph) {
+                        var x = d3.time.format("%d %b %Y")(new Date(parseInt(graph.point.x)));
+                        var y = String(graph.point.y);
+                                            if(key == 'Serie 1'){
+                                var y =  String(graph.point.y)  + ' ext';
+                            }
+
+                        tooltip_str = '<center><b>'+key+'</b></center>' + y + ' on ' + x;
+                        return tooltip_str; });
+
+                    chart.showLegend(true);
+
+                d3.select('#lineWithFocusChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('height', 450)
+                    .call(chart); });
+        </script>
+
+    """
+
+    CHART_FILENAME = "./linewfocuschart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(lineWithFocusChart, self).__init__(**kwargs)
+        self.model = 'lineWithFocusChart'
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis', format=kwargs.get('x_axis_format',
+                                                          '%d %b %Y %H %S'),
+                               date=True)
+            self.create_x_axis('x2Axis', format=kwargs.get('x_axis_format',
+                                                           '%d %b %Y %H %S'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            self.create_x_axis('xAxis', format=kwargs.get('x_axis_format',
+                                                          '.2f'))
+            self.create_x_axis('x2Axis', format=kwargs.get('x_axis_format',
+                                                           '.2f'))
+
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.2f'))
+        self.create_y_axis('y2Axis', format=kwargs.get('y_axis_format', '.2f'))
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/multiBarChart.py b/airflow/_vendor/nvd3/multiBarChart.py
new file mode 100644
index 0000000000000..cf335919a84c7
--- /dev/null
+++ b/airflow/_vendor/nvd3/multiBarChart.py
@@ -0,0 +1,95 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class multiBarChart(TemplateMixin, NVD3Chart):
+    """
+    A multiple bar graph contains comparisons of two or more categories or bars.
+    One axis represents a quantity and the other axis identifies a specific feature
+    about the categories. Reading a multiple bar graph includes looking at extremes
+    (tallest/longest vs. shortest) in each grouping.
+
+    Python example::
+
+        from nvd3 import multiBarChart
+        chart = multiBarChart(width=500, height=400, x_axis_format=None)
+        xdata = ['one', 'two', 'three', 'four']
+        ydata1 = [6, 12, 9, 16]
+        ydata2 = [8, 14, 7, 11]
+
+        chart.add_serie(name="Serie 1", y=ydata1, x=xdata)
+        chart.add_serie(name="Serie 2", y=ydata2, x=xdata)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="multiBarChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+            data_multiBarChart=[{"values":
+                                [{"y": 6, "x": "one"},
+                                {"y": 12, "x": "two"},
+                                {"y": 9, "x": "three"},
+                                {"y": 16, "x": "four"}],
+                                "key": "Serie 1", "yAxis": "1"},
+                                {"values":
+                                    [{"y": 8, "x": "one"},
+                                    {"y": 14, "x": "two"},
+                                    {"y": 7, "x": "three"},
+                                    {"y": 11, "x": "four"}],
+                                "key": "Serie 2", "yAxis": "1"}];
+
+            nv.addGraph(function() {
+                var chart = nv.models.multiBarChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_multiBarChart;
+                        chart.yAxis
+                            .tickFormat(d3.format(',.2f'));
+                    chart.showLegend(true);
+                d3.select('#multiBarChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 500)
+                    .attr('height', 400)
+                    .call(chart);
+            });
+
+
+        </script>
+
+    """
+
+    CHART_FILENAME = "./multibarchart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(multiBarChart, self).__init__(**kwargs)
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format', '%d %b %Y'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            self.create_x_axis('xAxis', format=kwargs.get('x_axis_format', '.2f'))
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.2f'))
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/multiBarHorizontalChart.py b/airflow/_vendor/nvd3/multiBarHorizontalChart.py
new file mode 100644
index 0000000000000..ac969c31b548c
--- /dev/null
+++ b/airflow/_vendor/nvd3/multiBarHorizontalChart.py
@@ -0,0 +1,100 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class multiBarHorizontalChart(TemplateMixin, NVD3Chart):
+    """
+    A multiple horizontal bar graph contains comparisons of two or more categories or bars.
+
+    Python example::
+
+        from nvd3 import multiBarHorizontalChart
+        chart = multiBarHorizontalChart(name='multiBarHorizontalChart', height=400, width=400)
+        xdata = [-14, -7, 7, 14]
+        ydata = [-6, 5, -1, 9]
+        y2data = [-23, -6, -32, 9]
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " balls"}}
+        chart.add_serie(name="Serie 1", y=ydata, x=xdata, extra=extra_serie)
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " calls"}}
+        chart.add_serie(name="Serie 2", y=y2data, x=xdata, extra=extra_serie)
+        chart.buildcontent()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="multiBarHorizontalChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+            data_multiBarHorizontalChart=[{"values":
+                [{"y": -6, "x": -14}, {"y": 5, "x": -7}, {"y": -1, "x": 7}, {"y": 9, "x": 14}],
+                "key": "Serie 1", "yAxis": "1"},
+                {"values":
+                    [{"y": -23, "x": -14}, {"y": -6, "x": -7}, {"y": -32, "x": 7}, {"y": 9, "x": 14}],
+                "key": "Serie 2", "yAxis": "1"}];
+
+            nv.addGraph(function() {
+                var chart = nv.models.multiBarHorizontalChart();
+
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+
+                var datum = data_multiBarHorizontalChart;
+
+                        chart.xAxis
+                            .tickFormat(d3.format(',.2f'));
+                        chart.yAxis
+                            .tickFormat(d3.format(',.2f'));
+
+                        chart.tooltipContent(function(key, y, e, graph) {
+                            var x = String(graph.point.x);
+                            var y = String(graph.point.y);
+                                                if(key == 'Serie 1'){
+                                var y =  String(graph.point.y)  + ' balls';
+                            }
+                            if(key == 'Serie 2'){
+                                var y =  String(graph.point.y)  + ' calls';
+                            }
+
+                            tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                            return tooltip_str;
+                        });
+
+                    chart.showLegend(true);
+
+                d3.select('#multiBarHorizontalChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 400)
+                    .attr('height', 400)
+                    .call(chart);
+            });
+        </script>
+
+    """
+
+    CHART_FILENAME = "./multibarcharthorizontal.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(multiBarHorizontalChart, self).__init__(**kwargs)
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+
+        self.create_x_axis('xAxis', format=kwargs.get('x_axis_format', '.2f'))
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.2f'))
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/pieChart.py b/airflow/_vendor/nvd3/pieChart.py
new file mode 100644
index 0000000000000..1db76bdb3424c
--- /dev/null
+++ b/airflow/_vendor/nvd3/pieChart.py
@@ -0,0 +1,101 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class pieChart(TemplateMixin, NVD3Chart):
+
+    """
+    A pie chart (or a circle graph) is a circular chart divided into sectors,
+    illustrating numerical proportion. In chart, the arc length of each sector
+    is proportional to the quantity it represents.
+
+    Python example::
+
+        from nvd3 import pieChart
+        chart = pieChart(name='pieChart', color_category='category20c',
+                         height=400, width=400)
+
+        xdata = ["Orange", "Banana", "Pear", "Kiwi", "Apple", "Strawbery",
+                 "Pineapple"]
+        ydata = [3, 4, 0, 1, 5, 7, 3]
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " cal"}}
+        chart.add_serie(y=ydata, x=xdata, extra=extra_serie)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="pieChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+
+            data_pieChart=[{"values": [{"value": 3, "label": "Orange"},
+                           {"value": 4, "label": "Banana"},
+                           {"value": 0, "label": "Pear"},
+                           {"value": 1, "label": "Kiwi"},
+                           {"value": 5, "label": "Apple"},
+                           {"value": 7, "label": "Strawberry"},
+                           {"value": 3, "label": "Pineapple"}],
+                           "key": "Serie 1"}];
+
+            nv.addGraph(function() {
+                var chart = nv.models.pieChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_pieChart[0].values;
+                        chart.tooltipContent(function(key, y, e, graph) {
+                            var x = String(key);
+                            var y =  String(y)  + ' cal';
+
+                            tooltip_str = '<center><b>'+x+'</b></center>' + y;
+                            return tooltip_str;
+                        });
+                    chart.showLegend(true);
+                    chart.showLabels(true);
+                    chart.donut(false);
+                chart
+                    .x(function(d) { return d.label })
+                    .y(function(d) { return d.value });
+                chart.width(400);
+                chart.height(400);
+
+                d3.select('#pieChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 400)
+                    .attr('height', 400)
+                    .call(chart);  });
+        </script>
+
+    """
+    CHART_FILENAME = "./piechart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(pieChart, self).__init__(**kwargs)
+
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+        self.donut = kwargs.get('donut', False)
+        self.donutRatio = kwargs.get('donutRatio', 0.35)
+        self.color_list = []
+        self.create_x_axis('xAxis', format=None)
+        self.create_y_axis('yAxis', format=None)
+        # must have a specified height, otherwise it superimposes both chars
+        if height:
+            self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
+        self.donut = kwargs.get('donut', False)
+        self.donutRatio = kwargs.get('donutRatio', 0.35)
diff --git a/airflow/_vendor/nvd3/scatterChart.py b/airflow/_vendor/nvd3/scatterChart.py
new file mode 100644
index 0000000000000..c3a87d2908bde
--- /dev/null
+++ b/airflow/_vendor/nvd3/scatterChart.py
@@ -0,0 +1,121 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class scatterChart(TemplateMixin, NVD3Chart):
+
+    """
+    A scatter plot or scattergraph is a type of mathematical diagram using Cartesian
+    coordinates to display values for two variables for a set of data.
+    The data is displayed as a collection of points, each having the value of one variable
+    determining the position on the horizontal axis and the value of the other variable
+    determining the position on the vertical axis.
+
+    Python example::
+
+        from nvd3 import scatterChart
+        chart = scatterChart(name='scatterChart', height=400, width=400)
+        xdata = [3, 4, 0, -3, 5, 7]
+        ydata = [-1, 2, 3, 3, 15, 2]
+        ydata2 = [1, -2, 4, 7, -5, 3]
+
+        kwargs1 = {'shape': 'circle', 'size': '1'}
+        kwargs2 = {'shape': 'cross', 'size': '10'}
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " call"}}
+        chart.add_serie(name="series 1", y=ydata, x=xdata, extra=extra_serie, **kwargs1)
+
+        extra_serie = {"tooltip": {"y_start": "", "y_end": " min"}}
+        chart.add_serie(name="series 2", y=ydata2, x=xdata, extra=extra_serie, **kwargs2)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="scatterChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+        data_scatterChart=[{"values": [{"y": -1, "x": 3, "shape": "circle",
+            "size": "1"}, {"y": 2, "x": 4, "shape": "circle", "size": "1"},
+            {"y": 3, "x": 0, "shape": "circle", "size": "1"},
+            {"y": 3, "x": -3, "shape": "circle", "size": "1"},
+            {"y": 15, "x": 5, "shape": "circle", "size": "1"},
+            {"y": 2, "x": 7, "shape": "circle", "size": "1"}],
+            "key": "series 1", "yAxis": "1"},
+            {"values": [{"y": 1, "x": 3, "shape": "cross", "size": "10"},
+            {"y": -2, "x": 4, "shape": "cross", "size": "10"},
+            {"y": 4, "x": 0, "shape": "cross", "size": "10"},
+            {"y": 7, "x": -3, "shape": "cross", "size": "10"},
+            {"y": -5, "x": 5, "shape": "cross", "size": "10"},
+            {"y": 3, "x": 7, "shape": "cross", "size": "10"}],
+            "key": "series 2", "yAxis": "1"}];
+        nv.addGraph(function() {
+        var chart = nv.models.scatterChart();
+
+        chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+
+        var datum = data_scatterChart;
+
+                chart.xAxis
+                    .tickFormat(d3.format(',.02f'));
+                chart.yAxis
+                    .tickFormat(d3.format(',.02f'));
+
+                chart.tooltipContent(function(key, y, e, graph) {
+                    var x = String(graph.point.x);
+                    var y = String(graph.point.y);
+                                        if(key == 'series 1'){
+                        var y =  String(graph.point.y)  + ' call';
+                    }
+                    if(key == 'series 2'){
+                        var y =  String(graph.point.y)  + ' min';
+                    }
+
+                    tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                    return tooltip_str;
+                });
+
+        chart.showLegend(true);
+
+        chart
+        .showDistX(true)
+        .showDistY(true)
+        .color(d3.scale.category10().range());
+
+            d3.select('#scatterChart svg')
+                .datum(datum)
+                .transition().duration(500)
+                .attr('width', 400)
+                .attr('height', 400)
+                .call(chart);
+        });
+        </script>
+
+    """
+
+    CHART_FILENAME = "./scatterchart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(scatterChart, self).__init__(**kwargs)
+        self.model = 'scatterChart'
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+        self.create_x_axis('xAxis', format=kwargs.get('x_axis_format', '.02f'),
+                           label=kwargs.get('x_axis_label', None))
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.02f'),
+                           label=kwargs.get('y_axis_label', None))
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/stackedAreaChart.py b/airflow/_vendor/nvd3/stackedAreaChart.py
new file mode 100644
index 0000000000000..8346cd2c53879
--- /dev/null
+++ b/airflow/_vendor/nvd3/stackedAreaChart.py
@@ -0,0 +1,99 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+"""
+Python-nvd3 is a Python wrapper for NVD3 graph library.
+NVD3 is an attempt to build re-usable charts and chart components
+for d3.js without taking away the power that d3.js gives you.
+
+Project location : https://github.com/areski/python-nvd3
+"""
+
+from .NVD3Chart import NVD3Chart, TemplateMixin
+
+
+class stackedAreaChart(TemplateMixin, NVD3Chart):
+    """
+    The stacked area chart is identical to the area chart, except the areas are stacked
+    on top of each other, rather than overlapping. This can make the chart much easier to read.
+
+    Python example::
+
+        from nvd3 import stackedAreaChart
+        chart = stackedAreaChart(name='stackedAreaChart', height=400, width=400)
+
+        xdata = [100, 101, 102, 103, 104, 105, 106,]
+        ydata = [6, 11, 12, 7, 11, 10, 11]
+        ydata2 = [8, 20, 16, 12, 20, 28, 28]
+
+        extra_serie = {"tooltip": {"y_start": "There is ", "y_end": " min"}}
+        chart.add_serie(name="Serie 1", y=ydata, x=xdata, extra=extra_serie)
+        chart.add_serie(name="Serie 2", y=ydata2, x=xdata, extra=extra_serie)
+        chart.buildhtml()
+
+    Javascript generated:
+
+    .. raw:: html
+
+        <div id="stackedAreaChart"><svg style="height:450px; width:100%"></svg></div>
+        <script>
+
+
+            data_stackedAreaChart=[{"values": [{"y": 6, "x": 100}, {"y": 11, "x": 101}, {"y": 12, "x": 102}, {"y": 7, "x": 103}, {"y": 11, "x": 104}, {"y": 10, "x": 105}, {"y": 11, "x": 106}], "key": "Serie 1", "yAxis": "1"}, {"values": [{"y": 8, "x": 100}, {"y": 20, "x": 101}, {"y": 16, "x": 102}, {"y": 12, "x": 103}, {"y": 20, "x": 104}, {"y": 28, "x": 105}, {"y": 28, "x": 106}], "key": "Serie 2", "yAxis": "1"}];
+            nv.addGraph(function() {
+                var chart = nv.models.stackedAreaChart();
+                chart.margin({top: 30, right: 60, bottom: 20, left: 60});
+                var datum = data_stackedAreaChart;
+                        chart.xAxis
+                            .tickFormat(d3.format(',.2f'));
+                        chart.yAxis
+                            .tickFormat(d3.format(',.2f'));
+
+                        chart.tooltipContent(function(key, y, e, graph) {
+                            var x = String(graph.point.x);
+                            var y = String(graph.point.y);
+                                                if(key == 'Serie 1'){
+                                var y = 'There is ' +  String(graph.point.y)  + ' min';
+                            }
+                            if(key == 'Serie 2'){
+                                var y = 'There is ' +  String(graph.point.y)  + ' min';
+                            }
+
+                            tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                            return tooltip_str;
+                        });
+                    chart.showLegend(true);
+                d3.select('#stackedAreaChart svg')
+                    .datum(datum)
+                    .transition().duration(500)
+                    .attr('width', 400)
+                    .attr('height', 400)
+                    .call(chart);
+            });
+        </script>
+
+    """
+
+    CHART_FILENAME = "./stackedareachart.html"
+    template_chart_nvd3 = NVD3Chart.template_environment.get_template(CHART_FILENAME)
+
+    def __init__(self, **kwargs):
+        super(stackedAreaChart, self).__init__(**kwargs)
+        height = kwargs.get('height', 450)
+        width = kwargs.get('width', None)
+        self.model = 'stackedAreaChart'
+
+        if kwargs.get('x_is_date', False):
+            self.set_date_flag(True)
+            self.create_x_axis('xAxis',
+                               format=kwargs.get('x_axis_format', '%d %b %Y'),
+                               date=True)
+            self.set_custom_tooltip_flag(True)
+        else:
+            self.create_x_axis('xAxis', format=kwargs.get('x_axis_format',
+                                                          '.2f'))
+        self.create_y_axis('yAxis', format=kwargs.get('y_axis_format', '.2f'))
+
+        self.set_graph_height(height)
+        if width:
+            self.set_graph_width(width)
diff --git a/airflow/_vendor/nvd3/templates/base.html b/airflow/_vendor/nvd3/templates/base.html
new file mode 100644
index 0000000000000..e2d39dd7642cb
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/base.html
@@ -0,0 +1,35 @@
+{% block container %}
+{% endblock %}
+
+{% block start_script %}
+    {% if chart.tag_script_js %}
+    <script>
+    {% endif %}
+
+    {% if chart.jquery_on_ready %}
+    $(function(){
+    {% endif %}
+{% endblock start_script %}
+
+{% block body %}
+    
+    {% block data %}
+    {% endblock data %}
+
+    {% block inject %}
+    {% endblock inject %}
+    
+    {% block foot %}
+    {% endblock foot %}
+     <!-- end of body from base-->
+    
+     {% endblock body%}
+
+{% block endscript %}
+    {% if chart.jquery_on_ready %}
+        });
+    {% endif %}
+    {% if chart.tag_script_js %}
+    </script>
+    {% endif %}
+{% endblock endscript %}
diff --git a/airflow/_vendor/nvd3/templates/content.html b/airflow/_vendor/nvd3/templates/content.html
new file mode 100644
index 0000000000000..787f39b555a4a
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/content.html
@@ -0,0 +1,123 @@
+{% extends "base.html" %}
+{% block container %}
+{% if chart.display_container %}
+    {{ chart.container }}
+{% endif %}
+{%  endblock  container %}
+
+{% block body %}
+    {% block data %}
+        data_{{ chart.name }}={{ chart.series_js }};
+    {% endblock data %}
+
+    {% block init %}
+    nv.addGraph(function() {
+        var chart = nv.models.{{ chart.model }}(){% if chart.use_interactive_guideline %}.useInteractiveGuideline(true){% endif %};
+
+        chart.margin({top: {{ chart.margin_top }}, right: {{ chart.margin_right }}, bottom: {{ chart.margin_bottom }}, left: {{ chart.margin_left }}});
+
+        var datum = data_{{ chart.name }};
+
+    {% if not chart.color_list and chart.color_category %}
+        chart.color(d3.scale.{{ chart.color_category }}().range());
+    {% endif %}
+    {% endblock init %}
+
+    {% if chart.stacked %}
+        chart.stacked(true);
+    {% endif %}
+
+    {% block focus %}
+    {% endblock focus %}
+
+
+    {% block axes %}
+        {% for axis, a in chart.axislist.items() %}
+            {% if a.items() %}
+            chart.{{ axis }}
+            {% for attr, value in a.items() %}
+                .{{ attr}}({{ value}}){% if loop.last %};
+                {% endif %}
+            {% endfor %}
+            {% endif %}
+        {% endfor %}
+    {% endblock axes %}
+
+    {# generate custom tooltip for the chart #}
+    {% block tooltip %}
+        {% if chart.custom_tooltip_flag %}
+            {% if not chart.date_flag %}
+                {% if chart.model == 'pieChart' %}
+                    {% block pietooltip %}
+                    {% endblock pietooltip %}
+                {% else %}
+                    chart.tooltipContent(function(key, y, e, graph) {
+                        var x = String(graph.point.x);
+                        var y = String(graph.point.y);
+                        {{ chart.tooltip_condition_string }}
+                        tooltip_str = '<center><b>'+key+'</b></center>' + y + ' at ' + x;
+                        return tooltip_str;
+                    });
+                {% endif %}
+            {% else %}
+                chart.tooltipContent(function(key, y, e, graph) {
+                    var x = d3.time.format("{{ chart.charttooltip_dateformat }}")(new Date(parseInt(graph.point.x)));
+                    var y = String(graph.point.y);
+                    {{ chart.tooltip_condition_string }}
+                    tooltip_str = '<center><b>'+key+'</b></center>' + y + ' on ' + x;
+                    return tooltip_str;
+                });
+            {% endif %}
+        {% endif %}
+    {% endblock tooltip %}
+
+    {# the shape attribute in kwargs is not applied when #}
+    {# not allowing other shapes to be rendered #}
+    {% block legend %}
+      chart.showLegend({{chart.show_legend|lower}});
+    {% endblock legend %}
+
+    {% block custoattr %}
+        {# add custom chart attributes #}
+        {% for attr, value in chart.chart_attr.items() %}
+            {% if value is string and value.startswith(".") %}:
+                chart.{{ attr }}{{ value }};
+            {% else %}
+                chart.{{ attr }}({{ value }});
+            {% endif %}
+        {% endfor %}
+
+        {% if chart.resize %}
+            nv.utils.windowResize(chart.update);
+        {% endif %}
+
+        {# include specific subchart #}
+        {{ chart.jschart }}
+
+    {% endblock custoattr %}
+
+    {% block inject %}
+        {# Inject data to D3 #}
+        d3.select('#{{ chart.name }} svg')
+            .datum(datum)
+            .transition().duration(500)
+            {% if chart.width %}
+            .attr('width', {{ chart.width}})
+            {% endif %}
+            {% if chart.height %}
+            .attr('height', {{ chart.height}})
+            {% endif %}
+            .call(chart);
+    {% endblock inject %}
+
+    {# extra chart attributes #}
+    {% if chart.extras %}
+        {{ chart.extras }}
+    {% endif %}
+
+    {# closing nv.addGraph #}
+    {% block close %}
+    });
+    {% endblock close %}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/cumulativelinechart.html b/airflow/_vendor/nvd3/templates/cumulativelinechart.html
new file mode 100644
index 0000000000000..546a3e8e55171
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/cumulativelinechart.html
@@ -0,0 +1,11 @@
+{# This template adds attributes unique
+   to cumulativeLineChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+{# calling super guarantees everying in content is also found here ...#}
+{{super()}}
+
+{% endblock body %}
+
diff --git a/airflow/_vendor/nvd3/templates/discretebarchart.html b/airflow/_vendor/nvd3/templates/discretebarchart.html
new file mode 100644
index 0000000000000..2e31ae4874be0
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/discretebarchart.html
@@ -0,0 +1,31 @@
+{# This is a dummy template, we can use that template to add attributes unique
+   to discreteBarChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+    {% block data %}
+        {{super()}}
+    {% endblock data %}
+
+    {% block init %}
+        {{super()}}
+    {% endblock init %}
+
+    {% block axes %}
+        {{super()}}
+    {% endblock axes %}
+    
+    {% block custoattr %}
+    {{super()}}
+    {% endblock custoattr %}
+
+    {% block inject %}
+    {{ super() }}
+    {% endblock inject %}
+    
+    {% block close %}
+    {{ super() }}
+    {% endblock close %}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/linebarwfocuschart.html b/airflow/_vendor/nvd3/templates/linebarwfocuschart.html
new file mode 100644
index 0000000000000..ad4866c8153f9
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/linebarwfocuschart.html
@@ -0,0 +1,60 @@
+{# This template adds attributes unique
+   to lineChart #}
+
+{% extends "content.html" %}
+{% block body %}
+    {% block data %}
+        data_{{ chart.name }}={{ chart.series_js }};
+    {% endblock data %}
+
+
+    {% block init %}
+        {{super()}}
+    {% endblock init %}
+    {% block axes %}
+        {{super()}}
+    {% endblock axes %}
+    {% block tooltip %}
+        {{super()}}
+    {% endblock tooltip %}
+
+    chart.showLegend({{chart.show_legend|lower}});
+
+    {# add custom chart attributes #}
+    {% for attr, value in chart.chart_attr.items() %}
+        {% if value is string and value.startswith(".") %}:
+            chart.{{ attr }}{{ value }};
+        {% else %}
+            chart.{{ attr }}({{ value }});
+        {% endif %}
+    {% endfor %}
+
+    {% if chart.x_axis_format == 'AM_PM' %}
+        function get_am_pm(d){
+            if (d > 12) {
+                d = d - 12; return (String(d) + 'PM');
+            }
+            else {
+                return (String(d) + 'AM');
+            }
+        };
+    {% else %}
+        chart.x(function(d,i) { return i });
+    {% endif %}
+
+    {% if chart.resize %}
+        nv.utils.windowResize(chart.update);
+    {% endif %}
+    {% block inject %}
+    {{super()}}
+    {% endblock inject %}
+
+		{% if chart.extras %}
+			{{ chart.extras }}
+		{% endif %}
+
+    {% block close %}
+    });
+    {% endblock close %}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/linechart.html b/airflow/_vendor/nvd3/templates/linechart.html
new file mode 100644
index 0000000000000..cf15d33041558
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/linechart.html
@@ -0,0 +1,47 @@
+{# This template adds attributes unique
+   to lineChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+    {% block data %}
+    {{super()}}
+    {% endblock data %}
+
+    {% block init %}
+    {{super()}}
+    {% endblock init %}
+
+    {% block axes %}
+    {{super()}}
+    {% endblock axes %}
+
+    {% if chart.x_axis_format == 'AM_PM' %}
+        function get_am_pm(d){
+            if (d > 12) {
+                d = d - 12; return (String(d) + 'PM');
+            }
+            else {
+                return (String(d) + 'AM');
+            }
+        };
+    {% endif %}
+
+    {% block legend %}
+    {{super()}}
+    {% endblock legend %}
+
+    {% block custoattr %}
+    {{super()}}
+    {% endblock custoattr %}
+
+    {% block inject %}
+    {{ super() }}
+    {% endblock inject %}
+
+    {% block close %}
+    {{ super() }}
+    {% endblock close %}
+
+{% endblock body %}
+
diff --git a/airflow/_vendor/nvd3/templates/lineplusbarchart.html b/airflow/_vendor/nvd3/templates/lineplusbarchart.html
new file mode 100644
index 0000000000000..73aeceacd2419
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/lineplusbarchart.html
@@ -0,0 +1,44 @@
+{# This template adds attributes unique
+   to linePlusBarChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+    {% block data %}
+    {{super()}}
+    {% endblock data %}
+
+    {% block init %}
+    {{super()}}
+    {% endblock init %}
+
+    {% block focus %}
+    {% if chart.focus_enable %}
+        chart.focusEnable(true);
+    {% else %}
+        chart.focusEnable(false);
+    {% endif %}
+    {% endblock focus %}
+
+    {% block axes %}
+    {{super()}}
+    {% endblock axes %}
+
+    {% block legend %}
+    {{super()}}
+    {% endblock legend %}
+
+    {% block custoattr %}
+    {{super()}}
+    {% endblock custoattr %}
+
+    {% block inject %}
+    {{ super() }}
+    {% endblock inject %}
+
+    {% block close %}
+    {{ super() }}
+    {% endblock close %}
+
+{% endblock body %}
+
diff --git a/airflow/_vendor/nvd3/templates/linewfocuschart.html b/airflow/_vendor/nvd3/templates/linewfocuschart.html
new file mode 100644
index 0000000000000..5abe983d7efc3
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/linewfocuschart.html
@@ -0,0 +1,10 @@
+{# This template adds attributes unique
+   to lineWithFocusChart #}
+
+{% extends "content.html" %}
+{% block body %}
+    
+{# calling super guarantees everying in content is also found here ...#}
+{{super()}}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/multibarchart.html b/airflow/_vendor/nvd3/templates/multibarchart.html
new file mode 100644
index 0000000000000..17eae7a634fef
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/multibarchart.html
@@ -0,0 +1,10 @@
+{# This template adds attributes unique
+   to multiBarChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+{# calling super guarantees everying in content is also found here ...#}
+{{super()}}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/multibarcharthorizontal.html b/airflow/_vendor/nvd3/templates/multibarcharthorizontal.html
new file mode 100644
index 0000000000000..17eae7a634fef
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/multibarcharthorizontal.html
@@ -0,0 +1,10 @@
+{# This template adds attributes unique
+   to multiBarChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+{# calling super guarantees everying in content is also found here ...#}
+{{super()}}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/page.html b/airflow/_vendor/nvd3/templates/page.html
new file mode 100644
index 0000000000000..2dd0f5d16f829
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/page.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="utf-8" />
+        {% for header_element in chart.header_css+chart.header_js %}
+        {{ header_element }}
+        {% endfor %}
+    </head>
+    <body>
+        {{ chart.content }}
+    </body>
+</html>
diff --git a/airflow/_vendor/nvd3/templates/piechart.html b/airflow/_vendor/nvd3/templates/piechart.html
new file mode 100644
index 0000000000000..a200e6d4a21bb
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/piechart.html
@@ -0,0 +1,80 @@
+{# This template adds attributes unique
+   to pieChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+    data_{{ chart.name }}={{ chart.series_js }};
+
+    nv.addGraph(function() {
+        var chart = nv.models.{{ chart.model }}(){% if chart.use_interactive_guideline %}.useInteractiveGuideline(true){% endif %};
+        chart.margin({top: {{ chart.margin_top }}, right: {{ chart.margin_right }}, bottom: {{ chart.margin_bottom }}, left: {{ chart.margin_left }}});
+        var datum = data_{{ chart.name }}[0].values;
+
+    {% if not chart.color_list and chart.color_category %}
+        chart.color(d3.scale.{{ chart.color_category }}().range());
+    {% endif %}
+
+    chart.tooltipContent(function(key, y, e, graph) {
+          var x = String(key);
+              {{ chart.tooltip_condition_string }}
+              tooltip_str = '<center><b>'+x+'</b></center>' + y;
+              return tooltip_str;
+              });
+    {# showLabels only supported in pieChart #}
+        chart.showLabels({{chart.show_labels|lower}});
+
+        {% if chart.donut %}
+            chart.donut(true);
+            chart.donutRatio({{ chart.donutRatio }});
+        {% else %}
+            chart.donut(false);
+        {% endif %}
+
+    chart.showLegend({{chart.show_legend|lower}});
+
+    {# add custom chart attributes #}
+    {% for attr, value in chart.chart_attr.items() %}
+        {% if value is string and value.startswith(".") %}:
+            chart.{{ attr }}{{ value }};
+        {% else %}
+            chart.{{ attr }}({{ value }});
+        {% endif %}
+    {% endfor %}
+
+    {% if chart.resize %}
+        nv.utils.windowResize(chart.update);
+    {% endif %}
+
+    {% if chart.color_list %}
+        var mycolor = new Array();
+        {% for color in chart.color_list %}
+            mycolor[{{ loop.index - 1}}] = "{{ color }}";
+        {% endfor %}
+    {% endif %}
+
+        chart
+            .x(function(d) { return d.label })
+            .y(function(d) { return d.value });
+
+    {% if chart.width %}
+        chart.width({{ chart.width }});
+    {% endif %}
+
+    {% if chart.height %}
+        chart.height({{ chart.height }});
+    {% endif %}
+
+    {% if chart.color_list %}
+        chart.color(mycolor);
+    {% endif %}
+
+    {% block inject %}
+    {{super()}}
+    {% endblock inject %}
+
+    {% block close %}
+    {{ super() }}
+    {% endblock close %}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/scatterchart.html b/airflow/_vendor/nvd3/templates/scatterchart.html
new file mode 100644
index 0000000000000..8c2adaae34cee
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/scatterchart.html
@@ -0,0 +1,52 @@
+{# This template adds attributes unique
+   to  scatterChart #}
+
+{% extends "content.html" %}
+{% block body %}
+
+    {% block data %}
+    {{super()}}
+    {% endblock data %}
+
+    {% block init %}
+    {{super()}}
+    {% endblock init %}
+
+    {% block axes %}
+    {{super()}}
+    {% endblock axes %}
+
+    {% if chart.x_axis_format == 'AM_PM' %}
+        function get_am_pm(d){
+            if (d > 12) {
+                d = d - 12; return (String(d) + 'PM');
+            }
+            else {
+                return (String(d) + 'AM');
+            }
+        };
+    {% endif %}
+
+    {% block legend %}
+    {{super()}}
+    {% endblock legend %}
+
+    {% block custoattr %}
+    {{super()}}
+    {% endblock custoattr %}
+
+    {% block inject %}
+
+    chart
+        .showDistX(true)
+        .showDistY(true)
+        .color(d3.scale.category10().range());
+
+    {{ super() }}
+    {% endblock inject %}
+
+    {% block close %}
+    {{ super() }}
+    {% endblock close %}
+
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/templates/stackedareachart.html b/airflow/_vendor/nvd3/templates/stackedareachart.html
new file mode 100644
index 0000000000000..b70833d2b385d
--- /dev/null
+++ b/airflow/_vendor/nvd3/templates/stackedareachart.html
@@ -0,0 +1,7 @@
+{# This is a dummy template, we can use that template to add attributes unique
+   to stackedareachart #}
+
+{% extends "content.html" %}
+{% block body %}
+    {{ super() }}
+{% endblock body %}
diff --git a/airflow/_vendor/nvd3/translator.py b/airflow/_vendor/nvd3/translator.py
new file mode 100644
index 0000000000000..ffde2c2a1cec9
--- /dev/null
+++ b/airflow/_vendor/nvd3/translator.py
@@ -0,0 +1,71 @@
+#!/usr/bin/env python
+# -*- coding: UTF-8 -*-
+
+
+class Tag(object):
+    """Tag class"""
+
+    def __init__(self, content=None):
+        self.content = content
+        self.attrs = ' '.join(['%s="%s"' % (attr, value)
+                               for attr, value in self.attrs])
+
+    def __str__(self):
+        return '<%s%s>\n    %s\n</%s>' % (self.name,
+                                          ' ' + self.attrs if self.attrs else '',
+                                          self.content,
+                                          self.name)
+
+
+class ScriptTag(Tag):
+    name = 'script'
+    attrs = (('type', 'text/javascript'),)
+
+
+class AnonymousFunction(object):
+    def __init__(self, arguments, content):
+        self.arguments = arguments
+        self.content = content
+
+    def __str__(self):
+        return 'function(%s) { %s }' % (self.arguments, self.content)
+
+
+class Function(object):
+
+    def __init__(self, name):
+        self.name = name
+        self._calls = []
+
+    def __str__(self):
+        operations = [self.name]
+        operations.extend(str(call) for call in self._calls)
+        return '%s' % ('.'.join(operations),)
+
+    def __getattr__(self, attr):
+        self._calls.append(attr)
+        return self
+
+    def __call__(self, *args):
+        if not args:
+            self._calls[-1] = self._calls[-1] + '()'
+        else:
+            arguments = ','.join([str(arg) for arg in args])
+            self._calls[-1] = self._calls[-1] + '(%s)' % (arguments,)
+        return self
+
+
+class Assignment(object):
+
+    def __init__(self, key, value, scoped=True):
+        self.key = key
+        self.value = value
+        self.scoped = scoped
+
+    def __str__(self):
+        return '%s%s = %s;' % ('var ' if self.scoped else '', self.key, self.value)
+
+
+def indent(func):
+    # TODO: Add indents to function str
+    return str(func)
diff --git a/airflow/_vendor/slugify/LICENSE b/airflow/_vendor/slugify/LICENSE
new file mode 100644
index 0000000000000..82af695f594e8
--- /dev/null
+++ b/airflow/_vendor/slugify/LICENSE
@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Val Neekman @ Neekware Inc. http://neekware.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/airflow/_vendor/slugify/__init__.py b/airflow/_vendor/slugify/__init__.py
new file mode 100644
index 0000000000000..7358b998cd543
--- /dev/null
+++ b/airflow/_vendor/slugify/__init__.py
@@ -0,0 +1,6 @@
+from .slugify import *
+
+
+__author__ = 'Val Neekman @ Neekware Inc. [@vneekman]'
+__description__ = 'A Python slugify application that also handles Unicode'
+__version__ = '2.0.1'
diff --git a/airflow/_vendor/slugify/slugify.py b/airflow/_vendor/slugify/slugify.py
new file mode 100644
index 0000000000000..0e9886d827138
--- /dev/null
+++ b/airflow/_vendor/slugify/slugify.py
@@ -0,0 +1,185 @@
+import re
+import unicodedata
+import types
+import sys
+
+try:
+    from htmlentitydefs import name2codepoint
+    _unicode = unicode
+    _unicode_type = types.UnicodeType
+except ImportError:
+    from html.entities import name2codepoint
+    _unicode = str
+    _unicode_type = str
+    unichr = chr
+
+import text_unidecode as unidecode
+
+__all__ = ['slugify', 'smart_truncate']
+
+
+CHAR_ENTITY_PATTERN = re.compile(r'&(%s);' % '|'.join(name2codepoint))
+DECIMAL_PATTERN = re.compile(r'&#(\d+);')
+HEX_PATTERN = re.compile(r'&#x([\da-fA-F]+);')
+QUOTE_PATTERN = re.compile(r'[\']+')
+ALLOWED_CHARS_PATTERN = re.compile(r'[^-a-z0-9]+')
+ALLOWED_CHARS_PATTERN_WITH_UPPERCASE = re.compile(r'[^-a-zA-Z0-9]+')
+DUPLICATE_DASH_PATTERN = re.compile(r'-{2,}')
+NUMBERS_PATTERN = re.compile(r'(?<=\d),(?=\d)')
+DEFAULT_SEPARATOR = '-'
+
+
+def smart_truncate(string, max_length=0, word_boundary=False, separator=' ', save_order=False):
+    """
+    Truncate a string.
+    :param string (str): string for modification
+    :param max_length (int): output string length
+    :param word_boundary (bool):
+    :param save_order (bool): if True then word order of output string is like input string
+    :param separator (str): separator between words
+    :return:
+    """
+
+    string = string.strip(separator)
+
+    if not max_length:
+        return string
+
+    if len(string) < max_length:
+        return string
+
+    if not word_boundary:
+        return string[:max_length].strip(separator)
+
+    if separator not in string:
+        return string[:max_length]
+
+    truncated = ''
+    for word in string.split(separator):
+        if word:
+            next_len = len(truncated) + len(word)
+            if next_len < max_length:
+                truncated += '{0}{1}'.format(word, separator)
+            elif next_len == max_length:
+                truncated += '{0}'.format(word)
+                break
+            else:
+                if save_order:
+                    break
+    if not truncated: # pragma: no cover
+        truncated = string[:max_length]
+    return truncated.strip(separator)
+
+
+def slugify(text, entities=True, decimal=True, hexadecimal=True, max_length=0, word_boundary=False,
+            separator=DEFAULT_SEPARATOR, save_order=False, stopwords=(), regex_pattern=None, lowercase=True,
+            replacements=()):
+    """
+    Make a slug from the given text.
+    :param text (str): initial text
+    :param entities (bool):
+    :param decimal (bool):
+    :param hexadecimal (bool):
+    :param max_length (int): output string length
+    :param word_boundary (bool):
+    :param save_order (bool): if parameter is True and max_length > 0 return whole words in the initial order
+    :param separator (str): separator between words
+    :param stopwords (iterable): words to discount
+    :param regex_pattern (str): regex pattern for allowed characters
+    :param lowercase (bool): activate case sensitivity by setting it to False
+    :param replacements (iterable): list of replacement rules e.g. [['|', 'or'], ['%', 'percent']]
+    :return (str):
+    """
+
+    # user-specific replacements
+    if replacements:
+        for old, new in replacements:
+            text = text.replace(old, new)
+
+    # ensure text is unicode
+    if not isinstance(text, _unicode_type):
+        text = _unicode(text, 'utf-8', 'ignore')
+
+    # replace quotes with dashes - pre-process
+    text = QUOTE_PATTERN.sub(DEFAULT_SEPARATOR, text)
+
+    # decode unicode
+    text = unidecode.unidecode(text)
+
+    # ensure text is still in unicode
+    if not isinstance(text, _unicode_type):
+        text = _unicode(text, 'utf-8', 'ignore')
+
+    # character entity reference
+    if entities:
+        text = CHAR_ENTITY_PATTERN.sub(lambda m: unichr(name2codepoint[m.group(1)]), text)
+
+    # decimal character reference
+    if decimal:
+        try:
+            text = DECIMAL_PATTERN.sub(lambda m: unichr(int(m.group(1))), text)
+        except Exception:
+            pass
+
+    # hexadecimal character reference
+    if hexadecimal:
+        try:
+            text = HEX_PATTERN.sub(lambda m: unichr(int(m.group(1), 16)), text)
+        except Exception:
+            pass
+
+    # translate
+    text = unicodedata.normalize('NFKD', text)
+    if sys.version_info < (3,):
+        text = text.encode('ascii', 'ignore')
+
+    # make the text lowercase (optional)
+    if lowercase:
+        text = text.lower()
+
+    # remove generated quotes -- post-process
+    text = QUOTE_PATTERN.sub('', text)
+
+    # cleanup numbers
+    text = NUMBERS_PATTERN.sub('', text)
+
+    # replace all other unwanted characters
+    if lowercase:
+        pattern = regex_pattern or ALLOWED_CHARS_PATTERN
+    else:
+        pattern = regex_pattern or ALLOWED_CHARS_PATTERN_WITH_UPPERCASE
+    text = re.sub(pattern, DEFAULT_SEPARATOR, text)
+
+    # remove redundant
+    text = DUPLICATE_DASH_PATTERN.sub(DEFAULT_SEPARATOR, text).strip(DEFAULT_SEPARATOR)
+
+    # remove stopwords
+    if stopwords:
+        if lowercase:
+            stopwords_lower = [s.lower() for s in stopwords]
+            words = [w for w in text.split(DEFAULT_SEPARATOR) if w not in stopwords_lower]
+        else:
+            words = [w for w in text.split(DEFAULT_SEPARATOR) if w not in stopwords]
+        text = DEFAULT_SEPARATOR.join(words)
+
+    # finalize user-specific replacements
+    if replacements:
+        for old, new in replacements:
+            text = text.replace(old, new)
+
+    # smart truncate if requested
+    if max_length > 0:
+        text = smart_truncate(text, max_length, word_boundary, DEFAULT_SEPARATOR, save_order)
+
+    if separator != DEFAULT_SEPARATOR:
+        text = text.replace(DEFAULT_SEPARATOR, separator)
+
+    return text
+
+
+def main(): # pragma: no cover
+    if len(sys.argv) < 2:
+        print("Usage %s TEXT TO SLUGIFY" % sys.argv[0])
+    else:
+        text = ' '.join(sys.argv[1:])
+        print(slugify(text))
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 7c9ec0192a72b..54e78482a091c 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -35,7 +35,6 @@
 
 import bleach
 import markdown
-import nvd3
 import pendulum
 import sqlalchemy as sqla
 from flask import (
@@ -79,6 +78,7 @@
 from airflow.utils.net import get_hostname
 from airflow.utils.state import State
 from airflow.utils.timezone import datetime
+from airflow._vendor import nvd3
 from airflow.www import utils as wwwutils
 from airflow.www.forms import (DateTimeForm, DateTimeWithNumRunsForm,
                                DateTimeWithNumRunsWithDagRunsForm)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 83865c1ec437c..6c306710efe6d 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -31,7 +31,6 @@
 
 
 import markdown
-import nvd3
 import pendulum
 import sqlalchemy as sqla
 from flask import (
@@ -62,6 +61,7 @@
 from airflow.utils.helpers import alchemy_to_dict
 from airflow.utils.json import json_ser
 from airflow.utils.state import State
+from airflow._vendor import nvd3
 from airflow.www_rbac import utils as wwwutils
 from airflow.www_rbac.app import app, appbuilder
 from airflow.www_rbac.decorators import action_logging, gzipped, has_dag_access
diff --git a/licenses/LICENSE-python-nvd3.txt b/licenses/LICENSE-python-nvd3.txt
new file mode 100644
index 0000000000000..1add6249e57b4
--- /dev/null
+++ b/licenses/LICENSE-python-nvd3.txt
@@ -0,0 +1,24 @@
+The MIT License (MIT)
+
+Python-nvd3
+
+Copyright (c) 2013 Arezqui Belaid <areski@gmail.com> and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/licenses/LICENSE-python-slugify.txt b/licenses/LICENSE-python-slugify.txt
new file mode 100644
index 0000000000000..82af695f594e8
--- /dev/null
+++ b/licenses/LICENSE-python-slugify.txt
@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Val Neekman @ Neekware Inc. http://neekware.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/setup.py b/setup.py
index a64ac08e7bc44..2695c8d1d6174 100644
--- a/setup.py
+++ b/setup.py
@@ -310,13 +310,12 @@ def do_setup():
             'pygments>=2.0.1, <3.0',
             'python-daemon>=2.1.1, <2.2',
             'python-dateutil>=2.3, <3',
-            'python-nvd3==0.15.0',
             'requests>=2.20.0, <3',
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
             'tenacity==4.8.0',
-            'text-unidecode==1.2',  # Avoid GPL dependency, pip uses reverse order(!)
+            'text-unidecode==1.2',
             'thrift>=0.9.2',
             'tzlocal>=1.4',
             'unicodecsv>=0.14.1',

From 24cc0edd95a847d4694459f8d2db59da2d702dbc Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 1 Mar 2019 21:05:01 +0000
Subject: [PATCH 525/808] [AIRFLOW-XXX] Pin version of tornado pulled in by
 Celery. (#4815)

https://github.com/tornadoweb/tornado/issues/2604
---
 setup.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 2695c8d1d6174..5ca0dd85490fa 100644
--- a/setup.py
+++ b/setup.py
@@ -141,7 +141,8 @@ def write_version(filename=os.path.join(*['airflow',
 cassandra = ['cassandra-driver>=3.13.0']
 celery = [
     'celery>=4.1.1, <4.2.0',
-    'flower>=0.7.3, <1.0'
+    'flower>=0.7.3, <1.0',
+    'tornado>=4.2.0, <6.0',  # Dep of flower. Pin to a version that works on Py3.5.2
 ]
 cgroups = [
     'cgroupspy>=0.1.4',

From 4aeebe1aa94236c52b3dc29460f7bd46c6996569 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Mon, 4 Mar 2019 05:48:55 -0800
Subject: [PATCH 526/808] [AIRFLOW-XXX] Solve lodash security warning (#4820)

We don't use lodash at runtime, so this won't affect anything, but it's nice to remove the warning
---
 airflow/www_rbac/package-lock.json | 7 +++----
 airflow/www_rbac/package.json      | 2 ++
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index 2e75cf9ec40d9..6a760de11a673 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -4880,10 +4880,9 @@
       }
     },
     "lodash": {
-      "version": "4.17.10",
-      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.10.tgz",
-      "integrity": "sha512-UejweD1pDoXu+AD825lWwp4ZGtSwgnpZxb3JDViD7StjQz+Nb/6l093lx4OQ0foGWNRoc19mWy7BzL+UAK2iVg==",
-      "dev": true
+      "version": "4.17.11",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.11.tgz",
+      "integrity": "sha512-cQKh8igo5QUhZ7lg38DYWAxMvjSAKG0A8wGSVimP07SIUEK2UO+arSRKbRZWtelMtN5V0Hkwh5ryOto/SshYIg=="
     },
     "lodash.camelcase": {
       "version": "4.3.0",
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index 5d40eb6b11a4e..5c431895a7666 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -45,6 +45,7 @@
     "eslint-plugin-standard": "^3.1.0",
     "file-loader": "^1.1.11",
     "imports-loader": "^0.8.0",
+    "lodash": "^4.17.11",
     "mini-css-extract-plugin": "^0.4.1",
     "style-loader": "^0.21.0",
     "url-loader": "^1.0.1",
@@ -60,6 +61,7 @@
     "dagre-d3": "^0.4.18",
     "datatables.net": "^1.10.19",
     "datatables.net-bs": "^1.10.19",
+    "lodash": "^4.17.11",
     "moment-timezone": "^0.5.21",
     "npm": "^6.3.0",
     "nvd3": "^1.8.6"

From 9249ba930c6ab2d0bde1a32b96c1b03e325d11d1 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Thu, 31 Jan 2019 07:59:49 +0100
Subject: [PATCH 527/808] [AIRFLOW-2876] Update Tenacity to 4.12 (#3723)

Tenacity 4.8 is not python 3.7 compatible because it contains
reserved keywords in the code
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 5ca0dd85490fa..128f00e3988c2 100644
--- a/setup.py
+++ b/setup.py
@@ -315,7 +315,7 @@ def do_setup():
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.3.0',
             'tabulate>=0.7.5, <=0.8.2',
-            'tenacity==4.8.0',
+            'tenacity==4.12.0',
             'text-unidecode==1.2',
             'thrift>=0.9.2',
             'tzlocal>=1.4',

From 0a29b3910d2f82646cf3bf003bff9d79de75fcbf Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Sat, 26 Jan 2019 16:13:43 -0800
Subject: [PATCH 528/808] [AIRFLOW-2190] Fix TypeError when returning 404
 (#4596)

When processing HTTP response headers, gunicorn checks that the name of each
header is a string. Here's the relevant gunicorn code:

From gunicorn/http/wsgi.py, line 257

    def process_headers(self, headers):
        for name, value in headers:
            if not isinstance(name, string_types):
                raise TypeError('%r is not a string' % name)

In Python3, `string_types` is set to the built-in `str`. For Python 2,
it's set to `basestring`. Again, the relevant gunicorn code:

From gunicorn/six.py, line 38:

    if PY3:
        string_types = str,
        ...
    else:
        string_types = basestring,

On Python2 the `b''` syntax returns a `str`, but in Python3 it returns `bytes`.
`bytes` != `str`, so we get the following error when returning a 404 on
Python3:

    File "/usr/local/lib/python3.6/site-packages/airflow/www/app.py", line 166, in root_app
    resp(b'404 Not Found', [(b'Content-Type', b'text/plain')])
    File "/usr/local/lib/python3.6/site-packages/gunicorn/http/wsgi.py", line 261, in start_response
    self.process_headers(headers)
    File "/usr/local/lib/python3.6/site-packages/gunicorn/http/wsgi.py", line 268, in process_headers
    raise TypeError('%r is not a string' % name)
    TypeError: b'Content-Type' is not a string

Dropping the `b` prefix in favor of the single-quote string syntax should work
for both Python2 and 3, as demonstrated below:

    Python 3.7.2 (default, Jan 13 2019, 12:50:15)
    [Clang 10.0.0 (clang-1000.11.45.5)] on darwin
    Type "help", "copyright", "credits" or "license" for more information.
    >>> isinstance('foo', str)
    True

    Python 2.7.15 (default, Jan 12 2019, 21:43:48)
    [GCC 4.2.1 Compatible Apple LLVM 10.0.0 (clang-1000.11.45.5)] on darwin
    Type "help", "copyright", "credits" or "license" for more information.
    >>> isinstance('foo', basestring)
    True
---
 airflow/www/app.py      | 2 +-
 airflow/www_rbac/app.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/app.py b/airflow/www/app.py
index e600247cc9d1e..e17f1c9edd0e6 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -173,7 +173,7 @@ def shutdown_session(exception=None):
 
 
 def root_app(env, resp):
-    resp(b'404 Not Found', [(b'Content-Type', b'text/plain')])
+    resp(b'404 Not Found', [('Content-Type', 'text/plain')])
     return [b'Apache Airflow is not at this location']
 
 
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 5c23aecea9d98..af0b09daa96b4 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -197,7 +197,7 @@ def shutdown_session(exception=None):
 
 
 def root_app(env, resp):
-    resp(b'404 Not Found', [(b'Content-Type', b'text/plain')])
+    resp(b'404 Not Found', [('Content-Type', 'text/plain')])
     return [b'Apache Airflow is not at this location']
 
 

From fe440c9ab3941369cea1f21460cb707bbc27fc0b Mon Sep 17 00:00:00 2001
From: Jimmy Cao <jcao2462@gmail.com>
Date: Wed, 12 Sep 2018 14:38:26 -0700
Subject: [PATCH 529/808] [AIRFLOW-2988] Run specifically python2 for dataflow
 (#3826)

Apache beam does not yet support python3, so it's best to run dataflow
jobs with python2 specifically until python3 support is complete
(BEAM-1251), in case if the user's 'python' in PATH is python3.
---
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 4 +++-
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 2c572617331dc..da4cf82aeb456 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -235,8 +235,10 @@ def start_python_dataflow(self, task_id, variables, dataflow, py_options,
         def label_formatter(labels_dict):
             return ['--labels={}={}'.format(key, value)
                     for key, value in labels_dict.items()]
+        # TODO: Change python2 to python when Beam supports both python 2 and 3
+        # Remember to change the test case too
         self._start_dataflow(task_id, variables, name,
-                             ["python"] + py_options + [dataflow],
+                             ["python2"] + py_options + [dataflow],
                              label_formatter)
 
     @staticmethod
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 7a02c1a33ec59..c70f161ef3bf8 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -93,7 +93,7 @@ def test_start_python_dataflow(self, mock_conn,
         self.dataflow_hook.start_python_dataflow(
             task_id=TASK_ID, variables=DATAFLOW_OPTIONS_PY,
             dataflow=PY_FILE, py_options=PY_OPTIONS)
-        EXPECTED_CMD = ['python', '-m', PY_FILE,
+        EXPECTED_CMD = ['python2', '-m', PY_FILE,
                         '--region=us-central1',
                         '--runner=DataflowRunner', '--project=test',
                         '--labels=foo=bar',

From 2873854724ac71f3a3d8c6f425d17fc2513e7c20 Mon Sep 17 00:00:00 2001
From: Ken Kawamoto <ken.kawamoto@kittyhawk.aero>
Date: Wed, 29 Aug 2018 06:43:40 -0700
Subject: [PATCH 530/808] [AIRFLOW-2928] Use uuid4 instead of uuid1 (#3779)

for better randomness.
---
 airflow/contrib/hooks/gcp_dataflow_hook.py        | 2 +-
 airflow/contrib/hooks/gcp_dataproc_hook.py        | 4 ++--
 airflow/contrib/kubernetes/pod_generator.py       | 2 +-
 airflow/contrib/operators/dataflow_operator.py    | 2 +-
 airflow/contrib/operators/dataproc_operator.py    | 6 +++---
 airflow/contrib/task_runner/cgroup_task_runner.py | 2 +-
 tests/contrib/hooks/test_gcp_dataflow_hook.py     | 6 +++---
 7 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index da4cf82aeb456..008e90787b51e 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -252,7 +252,7 @@ def _build_dataflow_job_name(task_id, append_job_name=True):
                 'letter and ending with a letter or number '.format(task_id))
 
         if append_job_name:
-            job_name = task_id + "-" + str(uuid.uuid1())[:8]
+            job_name = task_id + "-" + str(uuid.uuid4())[:8]
         else:
             job_name = task_id
 
diff --git a/airflow/contrib/hooks/gcp_dataproc_hook.py b/airflow/contrib/hooks/gcp_dataproc_hook.py
index 49345b51f731f..0f5d6e216b018 100644
--- a/airflow/contrib/hooks/gcp_dataproc_hook.py
+++ b/airflow/contrib/hooks/gcp_dataproc_hook.py
@@ -85,7 +85,7 @@ def get(self):
 
 class _DataProcJobBuilder:
     def __init__(self, project_id, task_id, cluster_name, job_type, properties):
-        name = task_id + "_" + str(uuid.uuid1())[:8]
+        name = task_id + "_" + str(uuid.uuid4())[:8]
         self.job_type = job_type
         self.job = {
             "job": {
@@ -145,7 +145,7 @@ def set_python_main(self, main):
         self.job["job"][self.job_type]["mainPythonFileUri"] = main
 
     def set_job_name(self, name):
-        self.job["job"]["reference"]["jobId"] = name + "_" + str(uuid.uuid1())[:8]
+        self.job["job"]["reference"]["jobId"] = name + "_" + str(uuid.uuid4())[:8]
 
     def build(self):
         return self.job
diff --git a/airflow/contrib/kubernetes/pod_generator.py b/airflow/contrib/kubernetes/pod_generator.py
index 6d8d83ef054a9..bee7f5b9572a0 100644
--- a/airflow/contrib/kubernetes/pod_generator.py
+++ b/airflow/contrib/kubernetes/pod_generator.py
@@ -149,7 +149,7 @@ def make_pod(self, namespace, image, pod_id, cmds, arguments, labels):
 
         return Pod(
             namespace=namespace,
-            name=pod_id + "-" + str(uuid.uuid1())[:8],
+            name=pod_id + "-" + str(uuid.uuid4())[:8],
             image=image,
             cmds=cmds,
             args=arguments,
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 0099bbc3cc3d1..ac9ad88ed9b53 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -363,7 +363,7 @@ def google_cloud_to_local(self, file_name):
 
         bucket_id = path_components[0]
         object_id = '/'.join(path_components[1:])
-        local_file = '/tmp/dataflow{}-{}'.format(str(uuid.uuid1())[:8],
+        local_file = '/tmp/dataflow{}-{}'.format(str(uuid.uuid4())[:8],
                                                  path_components[-1])
         self._gcs_hook.download(bucket_id, object_id, local_file)
 
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 829b5f63eedff..5f1052fefeb79 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -1255,7 +1255,7 @@ class DataProcPySparkOperator(BaseOperator):
     @staticmethod
     def _generate_temp_filename(filename):
         dt = time.strftime('%Y%m%d%H%M%S')
-        return "{}_{}_{}".format(dt, str(uuid.uuid1())[:8], ntpath.basename(filename))
+        return "{}_{}_{}".format(dt, str(uuid.uuid4())[:8], ntpath.basename(filename))
 
     """
     Upload a local file to a Google Cloud Storage bucket
@@ -1411,7 +1411,7 @@ def start(self):
             .instantiate(
                 name=('projects/%s/regions/%s/workflowTemplates/%s' %
                       (self.project_id, self.region, self.template_id)),
-                body={'instanceId': str(uuid.uuid1())})
+                body={'instanceId': str(uuid.uuid4())})
             .execute())
 
 
@@ -1454,6 +1454,6 @@ def start(self):
             self.hook.get_conn().projects().regions().workflowTemplates()
             .instantiateInline(
                 parent='projects/%s/regions/%s' % (self.project_id, self.region),
-                instanceId=str(uuid.uuid1()),
+                instanceId=str(uuid.uuid4()),
                 body=self.template)
             .execute())
diff --git a/airflow/contrib/task_runner/cgroup_task_runner.py b/airflow/contrib/task_runner/cgroup_task_runner.py
index faa2407f09a97..ef51b665d9bed 100644
--- a/airflow/contrib/task_runner/cgroup_task_runner.py
+++ b/airflow/contrib/task_runner/cgroup_task_runner.py
@@ -123,7 +123,7 @@ def start(self):
         # Create a unique cgroup name
         cgroup_name = "airflow/{}/{}".format(datetime.datetime.utcnow().
                                              strftime("%Y-%m-%d"),
-                                             str(uuid.uuid1()))
+                                             str(uuid.uuid4()))
 
         self.mem_cgroup_name = "memory/{}".format(cgroup_name)
         self.cpu_cgroup_name = "cpu/{}".format(cgroup_name)
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index c70f161ef3bf8..a22f66335cecd 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -78,7 +78,7 @@ def setUp(self):
                         new=mock_init):
             self.dataflow_hook = DataFlowHook(gcp_conn_id='test')
 
-    @mock.patch(DATAFLOW_STRING.format('uuid.uuid1'))
+    @mock.patch(DATAFLOW_STRING.format('uuid.uuid4'))
     @mock.patch(DATAFLOW_STRING.format('_DataflowJob'))
     @mock.patch(DATAFLOW_STRING.format('_Dataflow'))
     @mock.patch(DATAFLOW_STRING.format('DataFlowHook.get_conn'))
@@ -102,7 +102,7 @@ def test_start_python_dataflow(self, mock_conn,
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
-    @mock.patch(DATAFLOW_STRING.format('uuid.uuid1'))
+    @mock.patch(DATAFLOW_STRING.format('uuid.uuid4'))
     @mock.patch(DATAFLOW_STRING.format('_DataflowJob'))
     @mock.patch(DATAFLOW_STRING.format('_Dataflow'))
     @mock.patch(DATAFLOW_STRING.format('DataFlowHook.get_conn'))
@@ -126,7 +126,7 @@ def test_start_java_dataflow(self, mock_conn,
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
-    @mock.patch(DATAFLOW_STRING.format('uuid.uuid1'))
+    @mock.patch(DATAFLOW_STRING.format('uuid.uuid4'))
     @mock.patch(DATAFLOW_STRING.format('_DataflowJob'))
     @mock.patch(DATAFLOW_STRING.format('_Dataflow'))
     @mock.patch(DATAFLOW_STRING.format('DataFlowHook.get_conn'))

From 2dcaa4f6cae6abf57a3cdc4e86aed11a039a4788 Mon Sep 17 00:00:00 2001
From: Thibault Clement <thibault.clem@gmail.com>
Date: Mon, 25 Jun 2018 13:07:23 +0200
Subject: [PATCH 531/808] [AIRFLOW-XXX] Fix typo in http_operator.py

Replace sensor by operator in the comment:
`:param http_conn_id: The connection to run the
sensor against` by `:param http_conn_id: The
connection to run the operator against`

Closes #3544 from thibaultclem/patch-1
---
 airflow/operators/http_operator.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/operators/http_operator.py b/airflow/operators/http_operator.py
index 40fba453db9d1..7d641720705a5 100644
--- a/airflow/operators/http_operator.py
+++ b/airflow/operators/http_operator.py
@@ -27,7 +27,7 @@ class SimpleHttpOperator(BaseOperator):
     """
     Calls an endpoint on an HTTP system to execute an action
 
-    :param http_conn_id: The connection to run the sensor against
+    :param http_conn_id: The connection to run the operator against
     :type http_conn_id: string
     :param endpoint: The relative part of the full url. (templated)
     :type endpoint: string

From 9fe8e81fe5292fe93c7d1988cddd591d6364b0e5 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Thu, 6 Sep 2018 22:10:11 +0100
Subject: [PATCH 532/808] [AIRFLOW-3023] Fix docstring datatypes

---
 .../contrib/executors/kubernetes_executor.py  |   2 +-
 airflow/contrib/hooks/bigquery_hook.py        |  78 ++++-----
 airflow/contrib/hooks/cassandra_hook.py       |   4 +-
 airflow/contrib/hooks/databricks_hook.py      |   6 +-
 airflow/contrib/hooks/datadog_hook.py         |  16 +-
 airflow/contrib/hooks/gcp_api_base_hook.py    |   4 +-
 airflow/contrib/hooks/gcp_mlengine_hook.py    |   2 +-
 airflow/contrib/hooks/gcp_pubsub_hook.py      |  34 ++--
 airflow/contrib/hooks/gcs_hook.py             |  70 ++++----
 airflow/contrib/hooks/jira_hook.py            |   2 +-
 airflow/contrib/hooks/redis_hook.py           |   2 +-
 airflow/contrib/hooks/segment_hook.py         |   2 +-
 airflow/contrib/hooks/winrm_hook.py           |  26 +--
 .../operators/bigquery_check_operator.py      |  12 +-
 .../contrib/operators/bigquery_get_data.py    |  12 +-
 .../contrib/operators/bigquery_operator.py    |  60 +++----
 .../bigquery_table_delete_operator.py         |   8 +-
 .../contrib/operators/bigquery_to_bigquery.py |  10 +-
 airflow/contrib/operators/bigquery_to_gcs.py  |  14 +-
 airflow/contrib/operators/cassandra_to_gcs.py |  14 +-
 .../contrib/operators/databricks_operator.py  |  14 +-
 .../contrib/operators/dataflow_operator.py    |  24 +--
 .../contrib/operators/dataproc_operator.py    | 152 +++++++++---------
 .../operators/datastore_export_operator.py    |   8 +-
 .../operators/datastore_import_operator.py    |   8 +-
 airflow/contrib/operators/file_to_gcs.py      |  10 +-
 .../operators/gcs_download_operator.py        |  12 +-
 .../contrib/operators/gcs_list_operator.py    |  10 +-
 airflow/contrib/operators/gcs_operator.py     |  12 +-
 airflow/contrib/operators/gcs_to_bq.py        |  26 +--
 airflow/contrib/operators/gcs_to_gcs.py       |  12 +-
 airflow/contrib/operators/gcs_to_s3.py        |  10 +-
 .../operators/jenkins_job_trigger_operator.py |   6 +-
 .../operators/kubernetes_pod_operator.py      |   2 +-
 .../contrib/operators/mlengine_operator.py    |  68 ++++----
 .../operators/mlengine_operator_utils.py      |  18 +--
 airflow/contrib/operators/mysql_to_gcs.py     |  12 +-
 .../operators/postgres_to_gcs_operator.py     |  12 +-
 airflow/contrib/operators/pubsub_operator.py  |  44 ++---
 airflow/contrib/operators/s3_list_operator.py |   8 +-
 .../contrib/operators/s3_to_gcs_operator.py   |  14 +-
 .../operators/segment_track_event_operator.py |   8 +-
 .../contrib/operators/snowflake_operator.py   |   6 +-
 airflow/contrib/operators/vertica_operator.py |   2 +-
 airflow/contrib/sensors/bash_sensor.py        |   4 +-
 airflow/contrib/sensors/bigquery_sensor.py    |  10 +-
 .../sensors/cassandra_record_sensor.py        |   4 +-
 .../contrib/sensors/cassandra_table_sensor.py |   4 +-
 airflow/contrib/sensors/datadog_sensor.py     |   2 +-
 .../contrib/sensors/emr_job_flow_sensor.py    |   2 +-
 airflow/contrib/sensors/emr_step_sensor.py    |   4 +-
 airflow/contrib/sensors/file_sensor.py        |   4 +-
 airflow/contrib/sensors/gcs_sensor.py         |  24 +--
 airflow/contrib/sensors/mongo_sensor.py       |   4 +-
 airflow/contrib/sensors/pubsub_sensor.py      |   8 +-
 airflow/contrib/sensors/qubole_sensor.py      |   2 +-
 airflow/contrib/sensors/redis_key_sensor.py   |   4 +-
 airflow/executors/local_executor.py           |   6 +-
 airflow/hooks/S3_hook.py                      |   2 +-
 airflow/hooks/druid_hook.py                   |   2 +-
 airflow/hooks/hdfs_hook.py                    |   4 +-
 airflow/hooks/hive_hooks.py                   |  32 ++--
 airflow/hooks/slack_hook.py                   |   4 +-
 airflow/macros/hive.py                        |   6 +-
 airflow/models.py                             |  60 +++----
 airflow/operators/bash_operator.py            |   2 +-
 airflow/operators/check_operator.py           |   4 +-
 airflow/operators/druid_check_operator.py     |   4 +-
 airflow/operators/email_operator.py           |   8 +-
 airflow/operators/hive_operator.py            |  12 +-
 airflow/operators/hive_to_samba_operator.py   |   6 +-
 airflow/operators/http_operator.py            |   6 +-
 airflow/operators/jdbc_operator.py            |   2 +-
 airflow/operators/mssql_operator.py           |   6 +-
 airflow/operators/mysql_operator.py           |   4 +-
 airflow/operators/oracle_operator.py          |   2 +-
 airflow/operators/pig_operator.py             |   6 +-
 airflow/operators/postgres_operator.py        |   4 +-
 airflow/operators/presto_check_operator.py    |  10 +-
 airflow/operators/redshift_to_s3_operator.py  |  12 +-
 airflow/operators/s3_to_redshift_operator.py  |  12 +-
 airflow/operators/slack_operator.py           |  14 +-
 airflow/operators/sqlite_operator.py          |   4 +-
 airflow/sensors/external_task_sensor.py       |   4 +-
 airflow/sensors/hive_partition_sensor.py      |   4 +-
 airflow/sensors/http_sensor.py                |   6 +-
 airflow/sensors/sql_sensor.py                 |   2 +-
 airflow/ti_deps/dep_context.py                |  14 +-
 airflow/ti_deps/deps/trigger_rule_dep.py      |  12 +-
 airflow/utils/helpers.py                      |   4 +-
 airflow/utils/log/gcs_task_handler.py         |   6 +-
 airflow/utils/log/s3_task_handler.py          |   6 +-
 airflow/utils/log/wasb_task_handler.py        |   6 +-
 airflow/utils/operator_resources.py           |   4 +-
 94 files changed, 627 insertions(+), 627 deletions(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index f548beb4b530f..a76b3854e11fb 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -479,7 +479,7 @@ def _label_safe_datestring_to_datetime(string):
         "_", let's
         replace ":" with "_"
 
-        :param string: string
+        :param string: str
         :return: datetime.datetime object
         """
         return parser.parse(string.replace('_plus_', '+').replace("_", ":"))
diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index ab5d9f7496fab..f7ba4e5d69c0c 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -100,13 +100,13 @@ def get_pandas_df(self, sql, parameters=None, dialect=None):
         https://github.com/pydata/pandas/issues/6900
 
         :param sql: The BigQuery SQL to execute.
-        :type sql: string
+        :type sql: str
         :param parameters: The parameters to render the SQL query with (not
             used, leave to override superclass method)
         :type parameters: mapping or iterable
         :param dialect: Dialect of BigQuery SQL – legacy SQL or standard SQL
             defaults to use `self.use_legacy_sql` if not specified
-        :type dialect: string in {'legacy', 'standard'}
+        :type dialect: str in {'legacy', 'standard'}
         """
         if dialect is None:
             dialect = 'legacy' if self.use_legacy_sql else 'standard'
@@ -123,12 +123,12 @@ def table_exists(self, project_id, dataset_id, table_id):
         :param project_id: The Google cloud project in which to look for the
             table. The connection supplied to the hook must provide access to
             the specified project.
-        :type project_id: string
+        :type project_id: str
         :param dataset_id: The name of the dataset in which to look for the
             table.
-        :type dataset_id: string
+        :type dataset_id: str
         :param table_id: The name of the table to check the existence of.
-        :type table_id: string
+        :type table_id: str
         """
         service = self.get_service()
         try:
@@ -336,7 +336,7 @@ def create_external_table(self,
             table name to create external table.
             If <project> is not included, project will be the
             project defined in the connection json.
-        :type external_project_dataset_table: string
+        :type external_project_dataset_table: str
         :param schema_fields: The schema field list as defined here:
             https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#resource
         :type schema_fields: list
@@ -345,7 +345,7 @@ def create_external_table(self,
             per-object name can be used.
         :type source_uris: list
         :param source_format: File format to export.
-        :type source_format: string
+        :type source_format: str
         :param autodetect: Try to detect schema and format options automatically.
             Any option specified explicitly will be honored.
         :type autodetect: bool
@@ -354,7 +354,7 @@ def create_external_table(self,
             The default value is NONE.
             This setting is ignored for Google Cloud Bigtable,
                 Google Cloud Datastore backups and Avro formats.
-        :type compression: string
+        :type compression: str
         :param ignore_unknown_values: [Optional] Indicates if BigQuery should allow
             extra values that are not represented in the table schema.
             If true, the extra values are ignored. If false, records with extra columns
@@ -367,13 +367,13 @@ def create_external_table(self,
         :param skip_leading_rows: Number of rows to skip when loading from a CSV.
         :type skip_leading_rows: int
         :param field_delimiter: The delimiter to use when loading from a CSV.
-        :type field_delimiter: string
+        :type field_delimiter: str
         :param quote_character: The value that is used to quote data sections in a CSV
             file.
-        :type quote_character: string
+        :type quote_character: str
         :param allow_quoted_newlines: Whether to allow quoted newlines (true) or not
             (false).
-        :type allow_quoted_newlines: boolean
+        :type allow_quoted_newlines: bool
         :param allow_jagged_rows: Accept rows that are missing trailing optional columns.
             The missing values are treated as nulls. If false, records with missing
             trailing columns are treated as bad records, and if there are too many bad
@@ -532,28 +532,28 @@ def run_query(self,
 
         :param bql: (Deprecated. Use `sql` parameter instead) The BigQuery SQL
             to execute.
-        :type bql: string
+        :type bql: str
         :param sql: The BigQuery SQL to execute.
-        :type sql: string
+        :type sql: str
         :param destination_dataset_table: The dotted <dataset>.<table>
             BigQuery table to save the query results.
-        :type destination_dataset_table: string
+        :type destination_dataset_table: str
         :param write_disposition: What to do if the table already exists in
             BigQuery.
-        :type write_disposition: string
+        :type write_disposition: str
         :param allow_large_results: Whether to allow large results.
-        :type allow_large_results: boolean
+        :type allow_large_results: bool
         :param flatten_results: If true and query uses legacy SQL dialect, flattens
             all nested and repeated fields in the query results. ``allowLargeResults``
             must be true if this is set to false. For standard SQL queries, this
             flag is ignored and results are never flattened.
-        :type flatten_results: boolean
+        :type flatten_results: bool
         :param udf_config: The User Defined Function configuration for the query.
             See https://cloud.google.com/bigquery/user-defined-functions for details.
         :type udf_config: list
         :param use_legacy_sql: Whether to use legacy SQL (true) or standard SQL (false).
             If `None`, defaults to `self.use_legacy_sql`.
-        :type use_legacy_sql: boolean
+        :type use_legacy_sql: bool
         :param api_resource_configs: a dictionary that contain params
             'configuration' applied for Google BigQuery Jobs API:
             https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs
@@ -563,7 +563,7 @@ def run_query(self,
         :type api_resource_configs: dict
         :param maximum_billing_tier: Positive integer that serves as a
             multiplier of the basic price.
-        :type maximum_billing_tier: integer
+        :type maximum_billing_tier: int
         :param maximum_bytes_billed: Limits the bytes billed for this job.
             Queries that will have bytes billed beyond this limit will fail
             (without incurring a charge). If unspecified, this will be
@@ -571,7 +571,7 @@ def run_query(self,
         :type maximum_bytes_billed: float
         :param create_disposition: Specifies whether the job is allowed to
             create new tables.
-        :type create_disposition: string
+        :type create_disposition: str
         :param query_params a dictionary containing query parameter types and
             values, passed to BigQuery
         :type query_params: dict
@@ -584,7 +584,7 @@ def run_query(self,
         :param priority: Specifies a priority for the query.
             Possible values include INTERACTIVE and BATCH.
             The default value is INTERACTIVE.
-        :type priority: string
+        :type priority: str
         :param time_partitioning: configure optional time partitioning fields i.e.
             partition by field, type and expiration as per API specifications.
         :type time_partitioning: dict
@@ -759,20 +759,20 @@ def run_extract(  # noqa
 
         :param source_project_dataset_table: The dotted <dataset>.<table>
             BigQuery table to use as the source data.
-        :type source_project_dataset_table: string
+        :type source_project_dataset_table: str
         :param destination_cloud_storage_uris: The destination Google Cloud
             Storage URI (e.g. gs://some-bucket/some-file.txt). Follows
             convention defined here:
             https://cloud.google.com/bigquery/exporting-data-from-bigquery#exportingmultiple
         :type destination_cloud_storage_uris: list
         :param compression: Type of compression to use.
-        :type compression: string
+        :type compression: str
         :param export_format: File format to export.
-        :type export_format: string
+        :type export_format: str
         :param field_delimiter: The delimiter to use when extracting to a CSV.
-        :type field_delimiter: string
+        :type field_delimiter: str
         :param print_header: Whether to print a header for a CSV file extract.
-        :type print_header: boolean
+        :type print_header: bool
         :param labels: a dictionary containing labels for the job/query,
             passed to BigQuery
         :type labels: dict
@@ -831,11 +831,11 @@ def run_copy(self,
         :type source_project_dataset_tables: list|string
         :param destination_project_dataset_table: The destination BigQuery
             table. Format is: (project:|project.)<dataset>.<table>
-        :type destination_project_dataset_table: string
+        :type destination_project_dataset_table: str
         :param write_disposition: The write disposition if the table already exists.
-        :type write_disposition: string
+        :type write_disposition: str
         :param create_disposition: The create disposition if the table doesn't exist.
-        :type create_disposition: string
+        :type create_disposition: str
         :param labels a dictionary containing labels for the job/query,
             passed to BigQuery
         :type labels: dict
@@ -914,7 +914,7 @@ def run_load(self,
             project defined in the connection json. If a partition is specified the
             operator will automatically append the data, create a new partition or create
             a new DAY partitioned table.
-        :type destination_project_dataset_table: string
+        :type destination_project_dataset_table: str
         :param schema_fields: The schema field list as defined here:
             https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load
             Required if autodetect=False; optional if autodetect=True.
@@ -927,21 +927,21 @@ def run_load(self,
             per-object name can be used.
         :type source_uris: list
         :param source_format: File format to export.
-        :type source_format: string
+        :type source_format: str
         :param create_disposition: The create disposition if the table doesn't exist.
-        :type create_disposition: string
+        :type create_disposition: str
         :param skip_leading_rows: Number of rows to skip when loading from a CSV.
         :type skip_leading_rows: int
         :param write_disposition: The write disposition if the table already exists.
-        :type write_disposition: string
+        :type write_disposition: str
         :param field_delimiter: The delimiter to use when loading from a CSV.
-        :type field_delimiter: string
+        :type field_delimiter: str
         :param max_bad_records: The maximum number of bad records that BigQuery can
             ignore when running the job.
         :type max_bad_records: int
         :param quote_character: The value that is used to quote data sections in a CSV
             file.
-        :type quote_character: string
+        :type quote_character: str
         :param ignore_unknown_values: [Optional] Indicates if BigQuery should allow
             extra values that are not represented in the table schema.
             If true, the extra values are ignored. If false, records with extra columns
@@ -950,7 +950,7 @@ def run_load(self,
         :type ignore_unknown_values: bool
         :param allow_quoted_newlines: Whether to allow quoted newlines (true) or not
             (false).
-        :type allow_quoted_newlines: boolean
+        :type allow_quoted_newlines: bool
         :param allow_jagged_rows: Accept rows that are missing trailing optional columns.
             The missing values are treated as nulls. If false, records with missing
             trailing columns are treated as bad records, and if there are too many bad
@@ -1280,7 +1280,7 @@ def run_table_delete(self, deletion_dataset_table,
         :type deletion_dataset_table: str
         :param ignore_if_missing: if True, then return success even if the
         requested table does not exist.
-        :type ignore_if_missing: boolean
+        :type ignore_if_missing: bool
         :return:
         """
         deletion_project, deletion_dataset, deletion_table = \
@@ -1699,7 +1699,7 @@ def execute(self, operation, parameters=None):
         Executes a BigQuery query, and returns the job ID.
 
         :param operation: The query to execute.
-        :type operation: string
+        :type operation: str
         :param parameters: Parameters to substitute into the query.
         :type parameters: dict
         """
@@ -1712,7 +1712,7 @@ def executemany(self, operation, seq_of_parameters):
         Execute a BigQuery query multiple times with different parameters.
 
         :param operation: The query to execute.
-        :type operation: string
+        :type operation: str
         :param seq_of_parameters: List of dictionary parameters to substitute into the
             query.
         :type seq_of_parameters: list
diff --git a/airflow/contrib/hooks/cassandra_hook.py b/airflow/contrib/hooks/cassandra_hook.py
index 547e489130bf9..08def3a5b775c 100644
--- a/airflow/contrib/hooks/cassandra_hook.py
+++ b/airflow/contrib/hooks/cassandra_hook.py
@@ -167,7 +167,7 @@ def table_exists(self, table):
 
         :param table: Target Cassandra table.
                       Use dot notation to target a specific keyspace.
-        :type table: string
+        :type table: str
         """
         keyspace = self.keyspace
         if '.' in table:
@@ -182,7 +182,7 @@ def record_exists(self, table, keys):
 
         :param table: Target Cassandra table.
                       Use dot notation to target a specific keyspace.
-        :type table: string
+        :type table: str
         :param keys: The keys and their values to check the existence.
         :type keys: dict
         """
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index 284db98d91c2e..f4a890ac7ba4a 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -56,7 +56,7 @@ def __init__(
             retry_delay=1.0):
         """
         :param databricks_conn_id: The name of the databricks connection to use.
-        :type databricks_conn_id: string
+        :type databricks_conn_id: str
         :param timeout_seconds: The amount of time in seconds the requests library
             will wait before timing-out.
         :type timeout_seconds: int
@@ -169,7 +169,7 @@ def run_now(self, json):
         :param json: The data used in the body of the request to the ``run-now`` endpoint.
         :type json: dict
         :return: the run_id as a string
-        :rtype: string
+        :rtype: str
         """
         response = self._do_api_call(RUN_NOW_ENDPOINT, json)
         return response['run_id']
@@ -181,7 +181,7 @@ def submit_run(self, json):
         :param json: The data used in the body of the request to the ``submit`` endpoint.
         :type json: dict
         :return: the run_id as a string
-        :rtype: string
+        :rtype: str
         """
         response = self._do_api_call(SUBMIT_RUN_ENDPOINT, json)
         return response['run_id']
diff --git a/airflow/contrib/hooks/datadog_hook.py b/airflow/contrib/hooks/datadog_hook.py
index 3dfeb781aefe0..f00e49b097ffe 100644
--- a/airflow/contrib/hooks/datadog_hook.py
+++ b/airflow/contrib/hooks/datadog_hook.py
@@ -35,7 +35,7 @@ class DatadogHook(BaseHook, LoggingMixin):
     Airflow runs.
 
     :param datadog_conn_id: The connection to datadog, containing metadata for api keys.
-    :param datadog_conn_id: string
+    :param datadog_conn_id: str
     """
     def __init__(self, datadog_conn_id='datadog_default'):
         conn = self.get_connection(datadog_conn_id)
@@ -71,9 +71,9 @@ def send_metric(self, metric_name, datapoint, tags=None):
         Sends a single datapoint metric to DataDog
 
         :param metric_name: The name of the metric
-        :type metric_name: string
+        :type metric_name: str
         :param datapoint: A single integer or float related to the metric
-        :type datapoint: integer or float
+        :type datapoint: int or float
         :param tags: A list of tags associated with the metric
         :type tags: list
         """
@@ -95,7 +95,7 @@ def query_metric(self,
         function applied to it and returns the results.
 
         :param query: The datadog query to execute (see datadog docs)
-        :type query: string
+        :type query: str
         :param from_seconds_ago: How many seconds ago to start querying for.
         :type from_seconds_ago: int
         :param to_seconds_ago: Up to how many seconds ago to query for.
@@ -118,16 +118,16 @@ def post_event(self, title, text, tags=None, alert_type=None, aggregation_key=No
         alerting itself.
 
         :param title: The title of the event
-        :type title: string
+        :type title: str
         :param text: The body of the event (more information)
-        :type text: string
+        :type text: str
         :param tags: List of string tags to apply to the event
         :type tags: list
         :param alert_type: The alert type for the event, one of
             ["error", "warning", "info", "success"]
-        :type alert_type: string
+        :type alert_type: str
         :param aggregation_key: Key that can be used to aggregate this event in a stream
-        :type aggregation_key: string
+        :type aggregation_key: str
         """
         response = api.Event.create(
             title=title,
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index e2d7676a13632..a8a80813e7503 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -61,11 +61,11 @@ class GoogleCloudBaseHook(BaseHook, LoggingMixin):
     def __init__(self, gcp_conn_id='google_cloud_default', delegate_to=None):
         """
         :param gcp_conn_id: The connection ID to use when fetching connection info.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request must have
             domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         self.gcp_conn_id = gcp_conn_id
         self.delegate_to = delegate_to
diff --git a/airflow/contrib/hooks/gcp_mlengine_hook.py b/airflow/contrib/hooks/gcp_mlengine_hook.py
index c67b91ea9b38a..715e82d47d5de 100644
--- a/airflow/contrib/hooks/gcp_mlengine_hook.py
+++ b/airflow/contrib/hooks/gcp_mlengine_hook.py
@@ -63,7 +63,7 @@ def create_job(self, project_id, job, use_existing_job_fn=None):
 
         :param project_id: The Google Cloud project id within which MLEngine
             job will be launched.
-        :type project_id: string
+        :type project_id: str
 
         :param job: MLEngine Job object that should be provided to the MLEngine
             API, such as: ::
diff --git a/airflow/contrib/hooks/gcp_pubsub_hook.py b/airflow/contrib/hooks/gcp_pubsub_hook.py
index 9b296a5013252..50512d2127463 100644
--- a/airflow/contrib/hooks/gcp_pubsub_hook.py
+++ b/airflow/contrib/hooks/gcp_pubsub_hook.py
@@ -60,10 +60,10 @@ def publish(self, project, topic, messages):
         """Publishes messages to a Pub/Sub topic.
 
         :param project: the GCP project ID in which to publish
-        :type project: string
+        :type project: str
         :param topic: the Pub/Sub topic to which to publish; do not
             include the ``projects/{project}/topics/`` prefix.
-        :type topic: string
+        :type topic: str
         :param messages: messages to publish; if the data field in a
             message is set, it should already be base64 encoded.
         :type messages: list of PubSub messages; see
@@ -84,10 +84,10 @@ def create_topic(self, project, topic, fail_if_exists=False):
 
         :param project: the GCP project ID in which to create
             the topic
-        :type project: string
+        :type project: str
         :param topic: the Pub/Sub topic name to create; do not
             include the ``projects/{project}/topics/`` prefix.
-        :type topic: string
+        :type topic: str
         :param fail_if_exists: if set, raise an exception if the topic
             already exists
         :type fail_if_exists: bool
@@ -112,10 +112,10 @@ def delete_topic(self, project, topic, fail_if_not_exists=False):
         """Deletes a Pub/Sub topic if it exists.
 
         :param project: the GCP project ID in which to delete the topic
-        :type project: string
+        :type project: str
         :param topic: the Pub/Sub topic name to delete; do not
             include the ``projects/{project}/topics/`` prefix.
-        :type topic: string
+        :type topic: str
         :param fail_if_not_exists: if set, raise an exception if the topic
             does not exist
         :type fail_if_not_exists: bool
@@ -142,17 +142,17 @@ def create_subscription(self, topic_project, topic, subscription=None,
 
         :param topic_project: the GCP project ID of the topic that the
             subscription will be bound to.
-        :type topic_project: string
+        :type topic_project: str
         :param topic: the Pub/Sub topic name that the subscription will be bound
             to create; do not include the ``projects/{project}/subscriptions/``
             prefix.
-        :type topic: string
+        :type topic: str
         :param subscription: the Pub/Sub subscription name. If empty, a random
             name will be generated using the uuid module
-        :type subscription: string
+        :type subscription: str
         :param subscription_project: the GCP project ID where the subscription
             will be created. If unspecified, ``topic_project`` will be used.
-        :type subscription_project: string
+        :type subscription_project: str
         :param ack_deadline_secs: Number of seconds that a subscriber has to
             acknowledge each message pulled from the subscription
         :type ack_deadline_secs: int
@@ -161,7 +161,7 @@ def create_subscription(self, topic_project, topic, subscription=None,
         :type fail_if_exists: bool
         :return: subscription name which will be the system-generated value if
             the ``subscription`` parameter is not supplied
-        :rtype: string
+        :rtype: str
         """
         service = self.get_conn()
         full_topic = _format_topic(topic_project, topic)
@@ -197,10 +197,10 @@ def delete_subscription(self, project, subscription,
         """Deletes a Pub/Sub subscription, if it exists.
 
         :param project: the GCP project ID where the subscription exists
-        :type project: string
+        :type project: str
         :param subscription: the Pub/Sub subscription name to delete; do not
             include the ``projects/{project}/subscriptions/`` prefix.
-        :type subscription: string
+        :type subscription: str
         :param fail_if_not_exists: if set, raise an exception if the topic
             does not exist
         :type fail_if_not_exists: bool
@@ -228,10 +228,10 @@ def pull(self, project, subscription, max_messages,
         """Pulls up to ``max_messages`` messages from Pub/Sub subscription.
 
         :param project: the GCP project ID where the subscription exists
-        :type project: string
+        :type project: str
         :param subscription: the Pub/Sub subscription name to pull from; do not
             include the 'projects/{project}/topics/' prefix.
-        :type subscription: string
+        :type subscription: str
         :param max_messages: The maximum number of messages to return from
             the Pub/Sub API.
         :type max_messages: int
@@ -264,10 +264,10 @@ def acknowledge(self, project, subscription, ack_ids):
 
         :param project: the GCP project name or ID in which to create
             the topic
-        :type project: string
+        :type project: str
         :param subscription: the Pub/Sub subscription name to delete; do not
             include the 'projects/{project}/topics/' prefix.
-        :type subscription: string
+        :type subscription: str
         :param ack_ids: List of ReceivedMessage ackIds from a previous pull
             response
         :type ack_ids: list
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 018bf5f924269..02b7cd2cd38e5 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -60,15 +60,15 @@ def copy(self, source_bucket, source_object, destination_bucket=None,
         source bucket/object is used, but not both.
 
         :param source_bucket: The bucket of the object to copy from.
-        :type source_bucket: string
+        :type source_bucket: str
         :param source_object: The object to copy.
-        :type source_object: string
+        :type source_object: str
         :param destination_bucket: The destination of the object to copied to.
             Can be omitted; then the same bucket is used.
-        :type destination_bucket: string
+        :type destination_bucket: str
         :param destination_object: The (renamed) path of the object if given.
             Can be omitted; then the same name is used.
-        :type destination_object: string
+        :type destination_object: str
         """
         destination_bucket = destination_bucket or source_bucket
         destination_object = destination_object or source_object
@@ -106,11 +106,11 @@ def rewrite(self, source_bucket, source_object, destination_bucket,
         destination_object can be omitted, in which case source_object is used.
 
         :param source_bucket: The bucket of the object to copy from.
-        :type source_bucket: string
+        :type source_bucket: str
         :param source_object: The object to copy.
-        :type source_object: string
+        :type source_object: str
         :param destination_bucket: The destination of the object to copied to.
-        :type destination_bucket: string
+        :type destination_bucket: str
         :param destination_object: The (renamed) path of the object if given.
             Can be omitted; then the same name is used.
         """
@@ -154,11 +154,11 @@ def download(self, bucket, object, filename=None):
         Get a file from Google Cloud Storage.
 
         :param bucket: The bucket to fetch from.
-        :type bucket: string
+        :type bucket: str
         :param object: The object to fetch.
-        :type object: string
+        :type object: str
         :param filename: If set, a local file path where the file should be written to.
-        :type filename: string
+        :type filename: str
         """
         service = self.get_conn()
         downloaded_file_bytes = service \
@@ -182,11 +182,11 @@ def upload(self, bucket, object, filename,
         Uploads a local file to Google Cloud Storage.
 
         :param bucket: The bucket to upload to.
-        :type bucket: string
+        :type bucket: str
         :param object: The object name to set when uploading the local file.
-        :type object: string
+        :type object: str
         :param filename: The local file path to the file to be uploaded.
-        :type filename: string
+        :type filename: str
         :param mime_type: The MIME type to set when uploading the file.
         :type mime_type: str
         :param gzip: Option to compress file for upload
@@ -255,10 +255,10 @@ def exists(self, bucket, object):
         Checks for the existence of a file in Google Cloud Storage.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         """
         service = self.get_conn()
         try:
@@ -278,10 +278,10 @@ def is_updated_after(self, bucket, object, ts):
         Checks if an object is updated in Google Cloud Storage.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         :param ts: The timestamp to check against.
         :type ts: datetime
         """
@@ -317,11 +317,11 @@ def delete(self, bucket, object, generation=None):
         parameter is used.
 
         :param bucket: name of the bucket, where the object resides
-        :type bucket: string
+        :type bucket: str
         :param object: name of the object to delete
-        :type object: string
+        :type object: str
         :param generation: if present, permanently delete the object of this generation
-        :type generation: string
+        :type generation: str
         :return: True if succeeded
         """
         service = self.get_conn()
@@ -342,16 +342,16 @@ def list(self, bucket, versions=None, maxResults=None, prefix=None, delimiter=No
         List all objects from the bucket with the give string prefix in name
 
         :param bucket: bucket name
-        :type bucket: string
+        :type bucket: str
         :param versions: if true, list all versions of the objects
-        :type versions: boolean
+        :type versions: bool
         :param maxResults: max count of items to return in a single page of responses
-        :type maxResults: integer
+        :type maxResults: int
         :param prefix: prefix string which filters objects whose name begin with
             this prefix
-        :type prefix: string
+        :type prefix: str
         :param delimiter: filters objects based on the delimiter (for e.g '.csv')
-        :type delimiter: string
+        :type delimiter: str
         :return: a stream of object names matching the filtering criteria
         """
         service = self.get_conn()
@@ -395,9 +395,9 @@ def get_size(self, bucket, object):
         Gets the size of a file in Google Cloud Storage.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud storage bucket.
-        :type object: string
+        :type object: str
 
         """
         self.log.info('Checking the file size of object: %s in bucket: %s',
@@ -426,10 +426,10 @@ def get_crc32c(self, bucket, object):
         Gets the CRC32c checksum of an object in Google Cloud Storage.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         """
         self.log.info('Retrieving the crc32c checksum of '
                       'object: %s in bucket: %s', object, bucket)
@@ -453,10 +453,10 @@ def get_md5hash(self, bucket, object):
         Gets the MD5 hash of an object in Google Cloud Storage.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         """
         self.log.info('Retrieving the MD5 hash of '
                       'object: %s in bucket: %s', object, bucket)
@@ -491,7 +491,7 @@ def create_bucket(self,
             https://cloud.google.com/storage/docs/bucketnaming.html#requirements
 
         :param bucket_name: The name of the bucket.
-        :type bucket_name: string
+        :type bucket_name: str
         :param storage_class: This defines how objects in the bucket are stored
             and determines the SLA and the cost of storage. Values include
 
@@ -503,7 +503,7 @@ def create_bucket(self,
 
             If this value is not specified when the bucket is
             created, it will default to STANDARD.
-        :type storage_class: string
+        :type storage_class: str
         :param location: The location of the bucket.
             Object data for objects in the bucket resides in physical storage
             within this region. Defaults to US.
@@ -511,9 +511,9 @@ def create_bucket(self,
             .. seealso::
                 https://developers.google.com/storage/docs/bucket-locations
 
-        :type location: string
+        :type location: str
         :param project_id: The ID of the GCP Project.
-        :type project_id: string
+        :type project_id: str
         :param labels: User-provided labels, in key/value pairs.
         :type labels: dict
         :return: If successful, it returns the ``id`` of the bucket.
diff --git a/airflow/contrib/hooks/jira_hook.py b/airflow/contrib/hooks/jira_hook.py
index c6806d935acf2..a56c414dceb54 100644
--- a/airflow/contrib/hooks/jira_hook.py
+++ b/airflow/contrib/hooks/jira_hook.py
@@ -29,7 +29,7 @@ class JiraHook(BaseHook, LoggingMixin):
     Jira interaction hook, a Wrapper around JIRA Python SDK.
 
     :param jira_conn_id: reference to a pre-defined Jira Connection
-    :type jira_conn_id: string
+    :type jira_conn_id: str
     """
     def __init__(self,
                  jira_conn_id='jira_default',
diff --git a/airflow/contrib/hooks/redis_hook.py b/airflow/contrib/hooks/redis_hook.py
index 1de75dbca905f..650cc9308be91 100644
--- a/airflow/contrib/hooks/redis_hook.py
+++ b/airflow/contrib/hooks/redis_hook.py
@@ -88,6 +88,6 @@ def key_exists(self, key):
         Checks if a key exists in Redis database
 
         :param key: The key to check the existence.
-        :type key: string
+        :type key: str
         """
         return self.get_conn().exists(key)
diff --git a/airflow/contrib/hooks/segment_hook.py b/airflow/contrib/hooks/segment_hook.py
index 874d35d0743b9..01613f2adee8e 100644
--- a/airflow/contrib/hooks/segment_hook.py
+++ b/airflow/contrib/hooks/segment_hook.py
@@ -54,7 +54,7 @@ def __init__(
         :type segment_conn_id: str
         :param segment_debug_mode: Determines whether Segment should run in debug mode.
         Defaults to False
-        :type segment_debug_mode: boolean
+        :type segment_debug_mode: bool
         .. note::
             You must include a JSON structure in the `Extras` field.
             We need a user's security token to connect to Segment.
diff --git a/airflow/contrib/hooks/winrm_hook.py b/airflow/contrib/hooks/winrm_hook.py
index 1dd02f9951fde..5cc24cb7ad75f 100644
--- a/airflow/contrib/hooks/winrm_hook.py
+++ b/airflow/contrib/hooks/winrm_hook.py
@@ -36,36 +36,36 @@ class WinRMHook(BaseHook, LoggingMixin):
     :param ssh_conn_id: connection id from airflow Connections from where all
         the required parameters can be fetched like username and password.
         Thought the priority is given to the param passed during init
-    :type ssh_conn_id: string
+    :type ssh_conn_id: str
     :param endpoint: When set to `None`, endpoint will be constructed like this:
         'http://{remote_host}:{remote_port}/wsman'
-    :type endpoint: string
+    :type endpoint: str
     :param remote_host: Remote host to connect to.
         Ignored if `endpoint` is not `None`.
-    :type remote_host: string
+    :type remote_host: str
     :param remote_port: Remote port to connect to.
         Ignored if `endpoint` is not `None`.
     :type remote_port: int
     :param transport: transport type, one of 'plaintext' (default), 'kerberos', 'ssl',
         'ntlm', 'credssp'
-    :type transport: string
+    :type transport: str
     :param username: username to connect to the remote_host
-    :type username: string
+    :type username: str
     :param password: password of the username to connect to the remote_host
-    :type password: string
+    :type password: str
     :param service: the service name, default is HTTP
-    :type service: string
+    :type service: str
     :param keytab: the path to a keytab file if you are using one
-    :type keytab: string
+    :type keytab: str
     :param ca_trust_path: Certification Authority trust path
-    :type ca_trust_path: string
+    :type ca_trust_path: str
     :param cert_pem: client authentication certificate file path in PEM format
-    :type cert_pem: string
+    :type cert_pem: str
     :param cert_key_pem: client authentication certificate key file path in PEM format
-    :type cert_key_pem: string
+    :type cert_key_pem: str
     :param server_cert_validation: whether server certificate should be validated on
         Python versions that suppport it; one of 'validate' (default), 'ignore'
-    :type server_cert_validation: string
+    :type server_cert_validation: str
     :param kerberos_delegation: if True, TGT is sent to target server to
         allow multiple hops
     :type kerberos_delegation: bool
@@ -80,7 +80,7 @@ class WinRMHook(BaseHook, LoggingMixin):
     :type operation_timeout_sec: int
     :param kerberos_hostname_override: the hostname to use for the kerberos exchange
         (defaults to the hostname in the endpoint URL)
-    :type kerberos_hostname_override: string
+    :type kerberos_hostname_override: str
     :param message_encryption_enabled: Will encrypt the WinRM messages if set to True and
         the transport auth supports message encryption (Default True).
     :type message_encryption_enabled: bool
diff --git a/airflow/contrib/operators/bigquery_check_operator.py b/airflow/contrib/operators/bigquery_check_operator.py
index ff7b97eea8d82..247a1ae7fba1b 100644
--- a/airflow/contrib/operators/bigquery_check_operator.py
+++ b/airflow/contrib/operators/bigquery_check_operator.py
@@ -52,12 +52,12 @@ class BigQueryCheckOperator(CheckOperator):
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
-    :type sql: string
+    :type sql: str
     :param bigquery_conn_id: reference to the BigQuery database
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param use_legacy_sql: Whether to use legacy SQL (true)
         or standard SQL (false).
-    :type use_legacy_sql: boolean
+    :type use_legacy_sql: bool
     """
 
     @apply_defaults
@@ -81,10 +81,10 @@ class BigQueryValueCheckOperator(ValueCheckOperator):
     Performs a simple value check using sql code.
 
     :param sql: the sql to be executed
-    :type sql: string
+    :type sql: str
     :param use_legacy_sql: Whether to use legacy SQL (true)
         or standard SQL (false).
-    :type use_legacy_sql: boolean
+    :type use_legacy_sql: bool
     """
 
     @apply_defaults
@@ -126,7 +126,7 @@ class BigQueryIntervalCheckOperator(IntervalCheckOperator):
     :type metrics_threshold: dict
     :param use_legacy_sql: Whether to use legacy SQL (true)
         or standard SQL (false).
-    :type use_legacy_sql: boolean
+    :type use_legacy_sql: bool
     """
 
     @apply_defaults
diff --git a/airflow/contrib/operators/bigquery_get_data.py b/airflow/contrib/operators/bigquery_get_data.py
index 6e0c6c44deb04..f5e6e50f066d5 100644
--- a/airflow/contrib/operators/bigquery_get_data.py
+++ b/airflow/contrib/operators/bigquery_get_data.py
@@ -51,21 +51,21 @@ class BigQueryGetDataOperator(BaseOperator):
         )
 
     :param dataset_id: The dataset ID of the requested table. (templated)
-    :type dataset_id: string
+    :type dataset_id: str
     :param table_id: The table ID of the requested table. (templated)
-    :type table_id: string
+    :type table_id: str
     :param max_results: The maximum number of records (rows) to be fetched
         from the table. (templated)
-    :type max_results: string
+    :type max_results: str
     :param selected_fields: List of fields to return (comma-separated). If
         unspecified, all fields are returned.
-    :type selected_fields: string
+    :type selected_fields: str
     :param bigquery_conn_id: reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
     template_fields = ('dataset_id', 'table_id', 'max_results')
     ui_color = '#e4f0e8'
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 43049d9c7e334..ebc063bb0fc64 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -41,35 +41,35 @@ class BigQueryOperator(BaseOperator):
     :param destination_dataset_table: A dotted
         (<project>.|<project>:)<dataset>.<table> that, if set, will store the results
         of the query. (templated)
-    :type destination_dataset_table: string
+    :type destination_dataset_table: str
     :param write_disposition: Specifies the action that occurs if the destination table
         already exists. (default: 'WRITE_EMPTY')
-    :type write_disposition: string
+    :type write_disposition: str
     :param create_disposition: Specifies whether the job is allowed to create new tables.
         (default: 'CREATE_IF_NEEDED')
-    :type create_disposition: string
+    :type create_disposition: str
     :param allow_large_results: Whether to allow large results.
-    :type allow_large_results: boolean
+    :type allow_large_results: bool
     :param flatten_results: If true and query uses legacy SQL dialect, flattens
         all nested and repeated fields in the query results. ``allow_large_results``
         must be ``true`` if this is set to ``false``. For standard SQL queries, this
         flag is ignored and results are never flattened.
-    :type flatten_results: boolean
+    :type flatten_results: bool
     :param bigquery_conn_id: reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param udf_config: The User Defined Function configuration for the query.
         See https://cloud.google.com/bigquery/user-defined-functions for details.
     :type udf_config: list
     :param use_legacy_sql: Whether to use legacy SQL (true) or standard SQL (false).
-    :type use_legacy_sql: boolean
+    :type use_legacy_sql: bool
     :param maximum_billing_tier: Positive integer that serves as a multiplier
         of the basic price.
         Defaults to None, in which case it uses the value set in the project.
-    :type maximum_billing_tier: integer
+    :type maximum_billing_tier: int
     :param maximum_bytes_billed: Limits the bytes billed for this job.
         Queries that will have bytes billed beyond this limit will fail
         (without incurring a charge). If unspecified, this will be
@@ -94,7 +94,7 @@ class BigQueryOperator(BaseOperator):
     :param priority: Specifies a priority for the query.
         Possible values include INTERACTIVE and BATCH.
         The default value is INTERACTIVE.
-    :type priority: string
+    :type priority: str
     :param time_partitioning: configure optional time partitioning fields i.e.
         partition by field, type and expiration as per API specifications.
     :type time_partitioning: dict
@@ -224,11 +224,11 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
     You can also create a table without schema.
 
     :param project_id: The project to create the table into. (templated)
-    :type project_id: string
+    :type project_id: str
     :param dataset_id: The dataset to create the table into. (templated)
-    :type dataset_id: string
+    :type dataset_id: str
     :param table_id: The Name of the table to be created. (templated)
-    :type table_id: string
+    :type table_id: str
     :param schema_fields: If set, the schema field list as defined here:
         https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
 
@@ -241,7 +241,7 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
     :param gcs_schema_object: Full path to the JSON file containing
         schema (templated). For
         example: ``gs://test-bucket/dir1/dir2/employee_schema.json``
-    :type gcs_schema_object: string
+    :type gcs_schema_object: str
     :param time_partitioning: configure optional time partitioning fields i.e.
         partition by field, type and  expiration as per API specifications.
 
@@ -249,14 +249,14 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
             https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#timePartitioning
     :type time_partitioning: dict
     :param bigquery_conn_id: Reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param google_cloud_storage_conn_id: Reference to a specific Google
         cloud storage hook.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any. For this to
         work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param labels: a dictionary containing labels for the table, passed to BigQuery
 
         **Example (with schema JSON in GCS)**: ::
@@ -373,7 +373,7 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     Google cloud storage must be a JSON file with the schema fields in it.
 
     :param bucket: The bucket to point the external table to. (templated)
-    :type bucket: string
+    :type bucket: str
     :param source_objects: List of Google cloud storage URIs to point
         table to. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
@@ -381,7 +381,7 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
         BigQuery table to load data into (templated). If <project> is not included,
         project will be the project defined in the connection json.
-    :type destination_project_dataset_table: string
+    :type destination_project_dataset_table: str
     :param schema_fields: If set, the schema field list as defined here:
         https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
 
@@ -394,26 +394,26 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :type schema_fields: list
     :param schema_object: If set, a GCS object path pointing to a .json file that
         contains the schema for the table. (templated)
-    :type schema_object: string
+    :type schema_object: str
     :param source_format: File format of the data.
-    :type source_format: string
+    :type source_format: str
     :param compression: [Optional] The compression type of the data source.
         Possible values include GZIP and NONE.
         The default value is NONE.
         This setting is ignored for Google Cloud Bigtable,
         Google Cloud Datastore backups and Avro formats.
-    :type compression: string
+    :type compression: str
     :param skip_leading_rows: Number of rows to skip when loading from a CSV.
     :type skip_leading_rows: int
     :param field_delimiter: The delimiter to use for the CSV.
-    :type field_delimiter: string
+    :type field_delimiter: str
     :param max_bad_records: The maximum number of bad records that BigQuery can
         ignore when running the job.
     :type max_bad_records: int
     :param quote_character: The value that is used to quote data sections in a CSV file.
-    :type quote_character: string
+    :type quote_character: str
     :param allow_quoted_newlines: Whether to allow quoted newlines (true) or not (false).
-    :type allow_quoted_newlines: boolean
+    :type allow_quoted_newlines: bool
     :param allow_jagged_rows: Accept rows that are missing trailing optional columns.
         The missing values are treated as nulls. If false, records with missing trailing
         columns are treated as bad records, and if there are too many bad records, an
@@ -421,14 +421,14 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
         for other formats.
     :type allow_jagged_rows: bool
     :param bigquery_conn_id: Reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param google_cloud_storage_conn_id: Reference to a specific Google
         cloud storage hook.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any. For this to
         work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param src_fmt_configs: configure optional fields specific to the source format
     :type src_fmt_configs: dict
     :param labels a dictionary containing labels for the table, passed to BigQuery
@@ -528,9 +528,9 @@ class BigQueryDeleteDatasetOperator(BaseOperator):
     This operator deletes an existing dataset from your Project in Big query.
     https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/delete
     :param project_id: The project id of the dataset.
-    :type project_id: string
+    :type project_id: str
     :param dataset_id: The dataset to be deleted.
-    :type dataset_id: string
+    :type dataset_id: str
 
     **Example**: ::
 
diff --git a/airflow/contrib/operators/bigquery_table_delete_operator.py b/airflow/contrib/operators/bigquery_table_delete_operator.py
index a16107d8c41ec..45c481454e475 100644
--- a/airflow/contrib/operators/bigquery_table_delete_operator.py
+++ b/airflow/contrib/operators/bigquery_table_delete_operator.py
@@ -29,16 +29,16 @@ class BigQueryTableDeleteOperator(BaseOperator):
     :param deletion_dataset_table: A dotted
         (<project>.|<project>:)<dataset>.<table> that indicates which table
         will be deleted. (templated)
-    :type deletion_dataset_table: string
+    :type deletion_dataset_table: str
     :param bigquery_conn_id: reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param ignore_if_missing: if True, then return success even if the
         requested table does not exist.
-    :type ignore_if_missing: boolean
+    :type ignore_if_missing: bool
     """
     template_fields = ('deletion_dataset_table',)
     ui_color = '#ffd1dc'
diff --git a/airflow/contrib/operators/bigquery_to_bigquery.py b/airflow/contrib/operators/bigquery_to_bigquery.py
index be1dfea2a9c3b..288731e157de7 100644
--- a/airflow/contrib/operators/bigquery_to_bigquery.py
+++ b/airflow/contrib/operators/bigquery_to_bigquery.py
@@ -38,17 +38,17 @@ class BigQueryToBigQueryOperator(BaseOperator):
     :type source_project_dataset_tables: list|string
     :param destination_project_dataset_table: The destination BigQuery
         table. Format is: ``(project:|project.)<dataset>.<table>`` (templated)
-    :type destination_project_dataset_table: string
+    :type destination_project_dataset_table: str
     :param write_disposition: The write disposition if the table already exists.
-    :type write_disposition: string
+    :type write_disposition: str
     :param create_disposition: The create disposition if the table doesn't exist.
-    :type create_disposition: string
+    :type create_disposition: str
     :param bigquery_conn_id: reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param labels: a dictionary containing labels for the job/query,
         passed to BigQuery
     :type labels: dict
diff --git a/airflow/contrib/operators/bigquery_to_gcs.py b/airflow/contrib/operators/bigquery_to_gcs.py
index 7cefd7e815d49..ec6b937d218b2 100644
--- a/airflow/contrib/operators/bigquery_to_gcs.py
+++ b/airflow/contrib/operators/bigquery_to_gcs.py
@@ -34,26 +34,26 @@ class BigQueryToCloudStorageOperator(BaseOperator):
         ``(<project>.|<project>:)<dataset>.<table>`` BigQuery table to use as the
         source data. If <project> is not included, project will be the project
         defined in the connection json. (templated)
-    :type source_project_dataset_table: string
+    :type source_project_dataset_table: str
     :param destination_cloud_storage_uris: The destination Google Cloud
         Storage URI (e.g. gs://some-bucket/some-file.txt). (templated) Follows
         convention defined here:
         https://cloud.google.com/bigquery/exporting-data-from-bigquery#exportingmultiple
     :type destination_cloud_storage_uris: list
     :param compression: Type of compression to use.
-    :type compression: string
+    :type compression: str
     :param export_format: File format to export.
-    :type export_format: string
+    :type export_format: str
     :param field_delimiter: The delimiter to use when extracting to a CSV.
-    :type field_delimiter: string
+    :type field_delimiter: str
     :param print_header: Whether to print a header for a CSV file extract.
-    :type print_header: boolean
+    :type print_header: bool
     :param bigquery_conn_id: reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param labels: a dictionary containing labels for the job/query,
         passed to BigQuery
     :type labels: dict
diff --git a/airflow/contrib/operators/cassandra_to_gcs.py b/airflow/contrib/operators/cassandra_to_gcs.py
index 211444b96d1b9..95107a497fd61 100644
--- a/airflow/contrib/operators/cassandra_to_gcs.py
+++ b/airflow/contrib/operators/cassandra_to_gcs.py
@@ -60,18 +60,18 @@ def __init__(self,
                  **kwargs):
         """
         :param cql: The CQL to execute on the Cassandra table.
-        :type cql: string
+        :type cql: str
         :param bucket: The bucket to upload to.
-        :type bucket: string
+        :type bucket: str
         :param filename: The filename to use as the object name when uploading
             to Google cloud storage. A {} should be specified in the filename
             to allow the operator to inject file numbers in cases where the
             file is split due to size.
-        :type filename: string
+        :type filename: str
         :param schema_filename: If set, the filename to use as the object name
             when uploading a .json file containing the BigQuery schema fields
             for the table that was dumped from MySQL.
-        :type schema_filename: string
+        :type schema_filename: str
         :param approx_max_file_size_bytes: This operator supports the ability
             to split large table dumps into multiple files (see notes in the
             filenamed param docs above). Google cloud storage allows for files
@@ -79,14 +79,14 @@ def __init__(self,
             file size of the splits.
         :type approx_max_file_size_bytes: long
         :param cassandra_conn_id: Reference to a specific Cassandra hook.
-        :type cassandra_conn_id: string
+        :type cassandra_conn_id: str
         :param google_cloud_storage_conn_id: Reference to a specific Google
             cloud storage hook.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param delegate_to: The account to impersonate, if any. For this to
             work, the service account making the request must have domain-wide
             delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(CassandraToGoogleCloudStorageOperator, self).__init__(*args, **kwargs)
         self.cql = cql
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 140cac5ffbe90..5fbc605abea60 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -182,7 +182,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
     :param existing_cluster_id: ID for existing cluster on which to run this task.
         *EITHER* ``new_cluster`` *OR* ``existing_cluster_id`` should be specified.
         This field will be templated.
-    :type existing_cluster_id: string
+    :type existing_cluster_id: str
     :param libraries: Libraries which this run will use.
         This field will be templated.
 
@@ -193,7 +193,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
         By default this will be set to the Airflow ``task_id``. This ``task_id`` is a
         required parameter of the superclass ``BaseOperator``.
         This field will be templated.
-    :type run_name: string
+    :type run_name: str
     :param timeout_seconds: The timeout for this run. By default a value of 0 is used
         which means to have no timeout.
         This field will be templated.
@@ -202,7 +202,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
         By default and in the common case this will be ``databricks_default``. To use
         token based authentication, provide the key ``token`` in the extra field for the
         connection.
-    :type databricks_conn_id: string
+    :type databricks_conn_id: str
     :param polling_period_seconds: Controls the rate which we poll for the result of
         this run. By default the operator will poll every 30 seconds.
     :type polling_period_seconds: int
@@ -213,7 +213,7 @@ class DatabricksSubmitRunOperator(BaseOperator):
             might be a floating point number).
     :type databricks_retry_delay: float
     :param do_xcom_push: Whether we should push run_id and run_page_url to xcom.
-    :type do_xcom_push: boolean
+    :type do_xcom_push: bool
     """
     # Used in airflow.models.BaseOperator
     template_fields = ('json',)
@@ -351,7 +351,7 @@ class DatabricksRunNowOperator(BaseOperator):
         This field will be templated.
         .. seealso::
             https://docs.databricks.com/api/latest/jobs.html#run-now
-    :type job_id: string
+    :type job_id: str
     :param json: A JSON object containing API parameters which will be passed
         directly to the ``api/2.0/jobs/run-now`` endpoint. The other named parameters
         (i.e. ``notebook_params``, ``spark_submit_params``..) to this operator will
@@ -407,7 +407,7 @@ class DatabricksRunNowOperator(BaseOperator):
         By default and in the common case this will be ``databricks_default``. To use
         token based authentication, provide the key ``token`` in the extra field for the
         connection.
-    :type databricks_conn_id: string
+    :type databricks_conn_id: str
     :param polling_period_seconds: Controls the rate which we poll for the result of
         this run. By default the operator will poll every 30 seconds.
     :type polling_period_seconds: int
@@ -415,7 +415,7 @@ class DatabricksRunNowOperator(BaseOperator):
         unreachable. Its value must be greater than or equal to 1.
     :type databricks_retry_limit: int
     :param do_xcom_push: Whether we should push run_id and run_page_url to xcom.
-    :type do_xcom_push: boolean
+    :type do_xcom_push: bool
     """
     # Used in airflow.models.BaseOperator
     template_fields = ('json',)
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index ac9ad88ed9b53..429d63bb885dd 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -38,25 +38,25 @@ class DataFlowJavaOperator(BaseOperator):
         https://cloud.google.com/dataflow/pipelines/specifying-exec-params
 
     :param jar: The reference to a self executing DataFlow jar.
-    :type jar: string
+    :type jar: str
     :param dataflow_default_options: Map of default job options.
     :type dataflow_default_options: dict
     :param options: Map of job specific options.
     :type options: dict
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud
         Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param poll_sleep: The time in seconds to sleep between polling Google
         Cloud Platform for the dataflow job status while the job is in the
         JOB_STATE_RUNNING state.
     :type poll_sleep: int
     :param job_class: The name of the dataflow job class to be executued, it
         is often not the main class configured in the dataflow jar file.
-    :type job_class: string
+    :type job_class: str
 
     Both ``jar`` and ``options`` are templated so you can use variables in them.
 
@@ -150,18 +150,18 @@ class DataflowTemplateOperator(BaseOperator):
     will be passed to the job.
 
     :param template: The reference to the DataFlow template.
-    :type template: string
+    :type template: str
     :param dataflow_default_options: Map of default job environment options.
     :type dataflow_default_options: dict
     :param parameters: Map of job specific parameters for the template.
     :type parameters: dict
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud
         Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param poll_sleep: The time in seconds to sleep between polling Google
         Cloud Platform for the dataflow job status while the job is in the
         JOB_STATE_RUNNING state.
@@ -263,7 +263,7 @@ class DataFlowPythonOperator(BaseOperator):
 
     :param py_file: Reference to the python dataflow pipleline file.py, e.g.,
         /some/local/file/path/to/your/python/pipeline/file.
-    :type py_file: string
+    :type py_file: str
     :param py_options: Additional python options.
     :type pyt_options: list of strings, e.g., ["-m", "-v"].
     :param dataflow_default_options: Map of default job options.
@@ -272,11 +272,11 @@ class DataFlowPythonOperator(BaseOperator):
     :type options: dict
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud
         Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide  delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param poll_sleep: The time in seconds to sleep between polling Google
         Cloud Platform for the dataflow job status while the job is in the
         JOB_STATE_RUNNING state.
@@ -346,9 +346,9 @@ def google_cloud_to_local(self, file_name):
         will be returned immediately.
 
         :param file_name: The full path of input file.
-        :type file_name: string
+        :type file_name: str
         :return: The full path of local file.
-        :type: string
+        :type: str
         """
         if not file_name.startswith('gs://'):
             return file_name
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 5f1052fefeb79..6694092d2d568 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -48,7 +48,7 @@ class DataprocClusterCreateOperator(BaseOperator):
     parameters detailed in the link are available as a parameter to this operator.
 
     :param cluster_name: The name of the DataProc cluster to create. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param project_id: The ID of the google cloud project in which
         to create the cluster. (templated)
     :type project_id: str
@@ -57,41 +57,40 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type num_workers: int
     :param storage_bucket: The storage bucket to use, setting to None lets dataproc
         generate a custom one for you
-    :type storage_bucket: string
+    :type storage_bucket: str
     :param init_actions_uris: List of GCS uri's containing
         dataproc initialization scripts
     :type init_actions_uris: list[string]
     :param init_action_timeout: Amount of time executable scripts in
         init_actions_uris has to complete
-    :type init_action_timeout: string
+    :type init_action_timeout: str
     :param metadata: dict of key-value google compute engine metadata entries
         to add to all instances
     :type metadata: dict
     :param image_version: the version of software inside the Dataproc cluster
-    :type image_version: string
+    :type image_version: str
     :param custom_image: custom Dataproc image for more info see
         https://cloud.google.com/dataproc/docs/guides/dataproc-images
     :type: custom_image: string
-    :param properties: dict of properties to set on
         config files (e.g. spark-defaults.conf), see
         https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#SoftwareConfig
     :type properties: dict
     :param master_machine_type: Compute engine machine type to use for the master node
-    :type master_machine_type: string
+    :type master_machine_type: str
     :param master_disk_type: Type of the boot disk for the master node
         (default is ``pd-standard``).
         Valid values: ``pd-ssd`` (Persistent Disk Solid State Drive) or
         ``pd-standard`` (Persistent Disk Hard Disk Drive).
-    :type master_disk_type: string
+    :type master_disk_type: str
     :param master_disk_size: Disk size for the master node
     :type master_disk_size: int
     :param worker_machine_type: Compute engine machine type to use for the worker nodes
-    :type worker_machine_type: string
+    :type worker_machine_type: str
     :param worker_disk_type: Type of the boot disk for the worker node
         (default is ``pd-standard``).
         Valid values: ``pd-ssd`` (Persistent Disk Solid State Drive) or
         ``pd-standard`` (Persistent Disk Hard Disk Drive).
-    :type worker_disk_type: string
+    :type worker_disk_type: str
     :param worker_disk_size: Disk size for the worker nodes
     :type worker_disk_size: int
     :param num_preemptible_workers: The # of preemptible worker nodes to spin up
@@ -99,13 +98,13 @@ class DataprocClusterCreateOperator(BaseOperator):
     :param labels: dict of labels to add to the cluster
     :type labels: dict
     :param zone: The zone where the cluster will be located. (templated)
-    :type zone: string
+    :type zone: str
     :param network_uri: The network uri to be used for machine communication, cannot be
         specified with subnetwork_uri
-    :type network_uri: string
+    :type network_uri: str
     :param subnetwork_uri: The subnetwork uri to be used for machine communication,
         cannot be specified with network_uri
-    :type subnetwork_uri: string
+    :type subnetwork_uri: str
     :param internal_ip_only: If true, all instances in the cluster will only
         have internal IP addresses. This can only be enabled for subnetwork
         enabled networks
@@ -113,14 +112,15 @@ class DataprocClusterCreateOperator(BaseOperator):
     :param tags: The GCE tags to add to all instances
     :type tags: list[string]
     :param region: leave as 'global', might become relevant in the future. (templated)
+    :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param service_account: The service account of the dataproc instances.
-    :type service_account: string
+    :type service_account: str
     :param service_account_scopes: The URIs of service account scopes to be included.
     :type service_account_scopes: list[string]
     :param idle_delete_ttl: The longest duration that cluster would keep alive while
@@ -455,25 +455,25 @@ class DataprocClusterScaleOperator(BaseOperator):
         https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/scaling-clusters
 
     :param cluster_name: The name of the cluster to scale. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param project_id: The ID of the google cloud project in which
         the cluster runs. (templated)
-    :type project_id: string
+    :type project_id: str
     :param region: The region for the dataproc cluster. (templated)
-    :type region: string
+    :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param num_workers: The new number of workers
     :type num_workers: int
     :param num_preemptible_workers: The new number of preemptible workers
     :type num_preemptible_workers: int
     :param graceful_decommission_timeout: Timeout for graceful YARN decomissioning.
         Maximum value is 1d
-    :type graceful_decommission_timeout: string
+    :type graceful_decommission_timeout: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = ['cluster_name', 'project_id', 'region']
@@ -589,18 +589,18 @@ class DataprocClusterDeleteOperator(BaseOperator):
     cluster is destroyed.
 
     :param cluster_name: The name of the cluster to create. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param project_id: The ID of the google cloud project in which
         the cluster runs. (templated)
-    :type project_id: string
+    :type project_id: str
     :param region: leave as 'global', might become relevant in the future. (templated)
-    :type region: string
+    :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = ['cluster_name', 'project_id', 'region']
@@ -691,18 +691,18 @@ class DataProcPigOperator(BaseOperator):
 
     :param query: The query or reference to the query
         file (pg or pig extension). (templated)
-    :type query: string
+    :type query: str
     :param query_uri: The uri of a pig script on Cloud Storage.
-    :type query_uri: string
+    :type query_uri: str
     :param variables: Map of named parameters for the query. (templated)
     :type variables: dict
     :param job_name: The job name used in the DataProc cluster. This
         name by default is the task_id appended with the execution data, but can
         be templated. The name will always be appended with a random number to
         avoid name clashes. (templated)
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_pig_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_pig_properties: dict
@@ -710,11 +710,11 @@ class DataProcPigOperator(BaseOperator):
         UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_pig_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -728,7 +728,7 @@ class DataProcPigOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.pg', '.pig',)
@@ -789,17 +789,17 @@ class DataProcHiveOperator(BaseOperator):
     Start a Hive query Job on a Cloud DataProc cluster.
 
     :param query: The query or reference to the query file (q extension).
-    :type query: string
+    :type query: str
     :param query_uri: The uri of a hive script on Cloud Storage.
-    :type query_uri: string
+    :type query_uri: str
     :param variables: Map of named parameters for the query.
     :type variables: dict
     :param job_name: The job name used in the DataProc cluster. This name by default
         is the task_id appended with the execution data, but can be templated. The
         name will always be appended with a random number to avoid name clashes.
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster.
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_hive_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_hive_properties: dict
@@ -807,11 +807,11 @@ class DataProcHiveOperator(BaseOperator):
         UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_hive_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -825,7 +825,7 @@ class DataProcHiveOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.q',)
@@ -887,18 +887,18 @@ class DataProcSparkSqlOperator(BaseOperator):
     Start a Spark SQL query Job on a Cloud DataProc cluster.
 
     :param query: The query or reference to the query file (q extension). (templated)
-    :type query: string
+    :type query: str
     :param query_uri: The uri of a spark sql script on Cloud Storage.
-    :type query_uri: string
+    :type query_uri: str
     :param variables: Map of named parameters for the query. (templated)
     :type variables: dict
     :param job_name: The job name used in the DataProc cluster. This
         name by default is the task_id appended with the execution data, but can
         be templated. The name will always be appended with a random number to
         avoid name clashes. (templated)
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_spark_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_spark_properties: dict
@@ -906,11 +906,11 @@ class DataProcSparkSqlOperator(BaseOperator):
         for UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_spark_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -924,7 +924,7 @@ class DataProcSparkSqlOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
     template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
     template_ext = ('.q',)
@@ -987,10 +987,10 @@ class DataProcSparkOperator(BaseOperator):
 
     :param main_jar: URI of the job jar provisioned on Cloud Storage. (use this or
             the main_class, not both together).
-    :type main_jar: string
+    :type main_jar: str
     :param main_class: Name of the job class. (use this or the main_jar, not both
         together).
-    :type main_class: string
+    :type main_class: str
     :param arguments: Arguments for the job. (templated)
     :type arguments: list
     :param archives: List of archived files that will be unpacked in the work
@@ -1002,9 +1002,9 @@ class DataProcSparkOperator(BaseOperator):
         name by default is the task_id appended with the execution data, but can
         be templated. The name will always be appended with a random number to
         avoid name clashes. (templated)
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_spark_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_spark_properties: dict
@@ -1012,11 +1012,11 @@ class DataProcSparkOperator(BaseOperator):
         for UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_spark_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -1030,7 +1030,7 @@ class DataProcSparkOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1095,10 +1095,10 @@ class DataProcHadoopOperator(BaseOperator):
 
     :param main_jar: URI of the job jar provisioned on Cloud Storage. (use this or
             the main_class, not both together).
-    :type main_jar: string
+    :type main_jar: str
     :param main_class: Name of the job class. (use this or the main_jar, not both
         together).
-    :type main_class: string
+    :type main_class: str
     :param arguments: Arguments for the job. (templated)
     :type arguments: list
     :param archives: List of archived files that will be unpacked in the work
@@ -1110,9 +1110,9 @@ class DataProcHadoopOperator(BaseOperator):
         name by default is the task_id appended with the execution data, but can
         be templated. The name will always be appended with a random number to
         avoid name clashes. (templated)
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster. (templated)
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_hadoop_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_hadoop_properties: dict
@@ -1120,11 +1120,11 @@ class DataProcHadoopOperator(BaseOperator):
         for UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_hadoop_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -1138,7 +1138,7 @@ class DataProcHadoopOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1203,7 +1203,7 @@ class DataProcPySparkOperator(BaseOperator):
 
     :param main: [Required] The Hadoop Compatible Filesystem (HCFS) URI of the main
             Python file to use as the driver. Must be a .py file.
-    :type main: string
+    :type main: str
     :param arguments: Arguments for the job. (templated)
     :type arguments: list
     :param archives: List of archived files that will be unpacked in the work
@@ -1218,9 +1218,9 @@ class DataProcPySparkOperator(BaseOperator):
         name by default is the task_id appended with the execution data, but can
         be templated. The name will always be appended with a random number to
         avoid name clashes. (templated)
-    :type job_name: string
+    :type job_name: str
     :param cluster_name: The name of the DataProc cluster.
-    :type cluster_name: string
+    :type cluster_name: str
     :param dataproc_pyspark_properties: Map for the Pig properties. Ideal to put in
         default arguments
     :type dataproc_pyspark_properties: dict
@@ -1228,11 +1228,11 @@ class DataProcPySparkOperator(BaseOperator):
         for UDFs and libs) and are ideal to put in default arguments.
     :type dataproc_pyspark_jars: list
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param region: The specified region where the dataproc cluster is created.
     :type region: str
     :param job_error_states: Job states that should be considered error states.
@@ -1246,7 +1246,7 @@ class DataProcPySparkOperator(BaseOperator):
         This is useful for identifying or linking to the job in the Google Cloud Console
         Dataproc UI, as the actual "jobId" submitted to the Dataproc API is appended with
         an 8 character random string.
-    :vartype dataproc_job_id: string
+    :vartype dataproc_job_id: str
     """
 
     template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
@@ -1382,18 +1382,18 @@ class DataprocWorkflowTemplateInstantiateOperator(DataprocWorkflowTemplateBaseOp
         https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.workflowTemplates/instantiate
 
     :param template_id: The id of the template. (templated)
-    :type template_id: string
+    :type template_id: str
     :param project_id: The ID of the google cloud project in which
         the template runs
-    :type project_id: string
+    :type project_id: str
     :param region: leave as 'global', might become relevant in the future
-    :type region: string
+    :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = ['template_id']
@@ -1429,15 +1429,15 @@ class DataprocWorkflowTemplateInstantiateInlineOperator(
     :type template: map
     :param project_id: The ID of the google cloud project in which
         the template runs
-    :type project_id: string
+    :type project_id: str
     :param region: leave as 'global', might become relevant in the future
-    :type region: string
+    :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = ['template']
diff --git a/airflow/contrib/operators/datastore_export_operator.py b/airflow/contrib/operators/datastore_export_operator.py
index f6dc7cc571b41..9d95eadc74822 100644
--- a/airflow/contrib/operators/datastore_export_operator.py
+++ b/airflow/contrib/operators/datastore_export_operator.py
@@ -29,19 +29,19 @@ class DatastoreExportOperator(BaseOperator):
     Export entities from Google Cloud Datastore to Cloud Storage
 
     :param bucket: name of the cloud storage bucket to backup data
-    :type bucket: string
+    :type bucket: str
     :param namespace: optional namespace path in the specified Cloud Storage bucket
         to backup data. If this namespace does not exist in GCS, it will be created.
     :type namespace: str
     :param datastore_conn_id: the name of the Datastore connection id to use
-    :type datastore_conn_id: string
+    :type datastore_conn_id: str
     :param cloud_storage_conn_id: the name of the cloud storage connection id to
         force-write backup
-    :type cloud_storage_conn_id: string
+    :type cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param entity_filter: description of what data from the project is included in the
         export, refer to
         https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/EntityFilter
diff --git a/airflow/contrib/operators/datastore_import_operator.py b/airflow/contrib/operators/datastore_import_operator.py
index 401d36e05b7a8..c79767f35e9cd 100644
--- a/airflow/contrib/operators/datastore_import_operator.py
+++ b/airflow/contrib/operators/datastore_import_operator.py
@@ -28,10 +28,10 @@ class DatastoreImportOperator(BaseOperator):
     Import entities from Cloud Storage to Google Cloud Datastore
 
     :param bucket: container in Cloud Storage to store data
-    :type bucket: string
+    :type bucket: str
     :param file: path of the backup metadata file in the specified Cloud Storage bucket.
         It should have the extension .overall_export_metadata
-    :type file: string
+    :type file: str
     :param namespace: optional namespace of the backup metadata file in
         the specified Cloud Storage bucket.
     :type namespace: str
@@ -42,11 +42,11 @@ class DatastoreImportOperator(BaseOperator):
     :param labels: client-assigned labels for cloud storage
     :type labels: dict
     :param datastore_conn_id: the name of the connection id to use
-    :type datastore_conn_id: string
+    :type datastore_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param polling_interval_in_seconds: number of seconds to wait before polling for
         execution status again
     :type polling_interval_in_seconds: int
diff --git a/airflow/contrib/operators/file_to_gcs.py b/airflow/contrib/operators/file_to_gcs.py
index b750e0fc4879e..de40abd473e86 100644
--- a/airflow/contrib/operators/file_to_gcs.py
+++ b/airflow/contrib/operators/file_to_gcs.py
@@ -29,15 +29,15 @@ class FileToGoogleCloudStorageOperator(BaseOperator):
     Optionally can compress the file for upload.
 
     :param src: Path to the local file. (templated)
-    :type src: string
+    :type src: str
     :param dst: Destination path within the specified bucket. (templated)
-    :type dst: string
+    :type dst: str
     :param bucket: The bucket to upload to. (templated)
-    :type bucket: string
+    :type bucket: str
     :param google_cloud_storage_conn_id: The Airflow connection ID to upload with
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param mime_type: The mime-type string
-    :type mime_type: string
+    :type mime_type: str
     :param delegate_to: The account to impersonate, if any
     :type delegate_to: str
     :param gzip: Allows for file to be compressed and uploaded as gzip
diff --git a/airflow/contrib/operators/gcs_download_operator.py b/airflow/contrib/operators/gcs_download_operator.py
index ce272aedd501c..1d168d4660722 100644
--- a/airflow/contrib/operators/gcs_download_operator.py
+++ b/airflow/contrib/operators/gcs_download_operator.py
@@ -29,26 +29,26 @@ class GoogleCloudStorageDownloadOperator(BaseOperator):
     Downloads a file from Google Cloud Storage.
 
     :param bucket: The Google cloud storage bucket where the object is. (templated)
-    :type bucket: string
+    :type bucket: str
     :param object: The name of the object to download in the Google cloud
         storage bucket. (templated)
-    :type object: string
+    :type object: str
     :param filename: The file path on the local file system (where the
         operator is being executed) that the file should be downloaded to. (templated)
         If no filename passed, the downloaded data will not be stored on the local file
         system.
-    :type filename: string
+    :type filename: str
     :param store_to_xcom_key: If this param is set, the operator will push
         the contents of the downloaded file to XCom with the key set in this
         parameter. If not set, the downloaded data will not be pushed to XCom. (templated)
-    :type store_to_xcom_key: string
+    :type store_to_xcom_key: str
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google cloud storage.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
     template_fields = ('bucket', 'object', 'filename', 'store_to_xcom_key',)
     ui_color = '#f0eee4'
diff --git a/airflow/contrib/operators/gcs_list_operator.py b/airflow/contrib/operators/gcs_list_operator.py
index 6474453afabec..7b37b269a6035 100644
--- a/airflow/contrib/operators/gcs_list_operator.py
+++ b/airflow/contrib/operators/gcs_list_operator.py
@@ -30,21 +30,21 @@ class GoogleCloudStorageListOperator(BaseOperator):
      `xcom` in the downstream task.
 
     :param bucket: The Google cloud storage bucket to find the objects. (templated)
-    :type bucket: string
+    :type bucket: str
     :param prefix: Prefix string which filters objects whose name begin with
            this prefix. (templated)
-    :type prefix: string
+    :type prefix: str
     :param delimiter: The delimiter by which you want to filter the objects. (templated)
         For e.g to lists the CSV files from in a directory in GCS you would use
         delimiter='.csv'.
-    :type delimiter: string
+    :type delimiter: str
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google cloud storage.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
 
     **Example**:
         The following Operator would list all the Avro files from ``sales/sales-2017``
diff --git a/airflow/contrib/operators/gcs_operator.py b/airflow/contrib/operators/gcs_operator.py
index 60b664853b309..db821717cdb51 100644
--- a/airflow/contrib/operators/gcs_operator.py
+++ b/airflow/contrib/operators/gcs_operator.py
@@ -33,7 +33,7 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
             https://cloud.google.com/storage/docs/bucketnaming.html#requirements
 
     :param bucket_name: The name of the bucket. (templated)
-    :type bucket_name: string
+    :type bucket_name: str
     :param storage_class: This defines how objects in the bucket are stored
             and determines the SLA and the cost of storage (templated). Values include
 
@@ -45,25 +45,25 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
 
             If this value is not specified when the bucket is
             created, it will default to STANDARD.
-    :type storage_class: string
+    :type storage_class: str
     :param location: The location of the bucket. (templated)
         Object data for objects in the bucket resides in physical storage
         within this region. Defaults to US.
 
         .. seealso:: https://developers.google.com/storage/docs/bucket-locations
 
-    :type location: string
+    :type location: str
     :param project_id: The ID of the GCP Project. (templated)
-    :type project_id: string
+    :type project_id: str
     :param labels: User-provided labels, in key/value pairs.
     :type labels: dict
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google cloud storage.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must
         have domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
 
     :Example::
     The following Operator would create a new bucket ``test-bucket``
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 1c94c85c6c4ca..abbf380b2d0fb 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -35,42 +35,42 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
     Google cloud storage must be a JSON file with the schema fields in it.
 
     :param bucket: The bucket to load from. (templated)
-    :type bucket: string
+    :type bucket: str
     :param source_objects: List of Google cloud storage URIs to load from. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
     :type source_objects: list of str
     :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
         BigQuery table to load data into. If <project> is not included,
         project will be the project defined in the connection json. (templated)
-    :type destination_project_dataset_table: string
+    :type destination_project_dataset_table: str
     :param schema_fields: If set, the schema field list as defined here:
         https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load
         Should not be set when source_format is 'DATASTORE_BACKUP'.
     :type schema_fields: list
     :param schema_object: If set, a GCS object path pointing to a .json file that
         contains the schema for the table. (templated)
-    :type schema_object: string
+    :type schema_object: str
     :param source_format: File format to export.
-    :type source_format: string
+    :type source_format: str
     :param compression: [Optional] The compression type of the data source.
         Possible values include GZIP and NONE.
         The default value is NONE.
         This setting is ignored for Google Cloud Bigtable,
         Google Cloud Datastore backups and Avro formats.
-    :type compression: string
+    :type compression: str
     :param create_disposition: The create disposition if the table doesn't exist.
-    :type create_disposition: string
+    :type create_disposition: str
     :param skip_leading_rows: Number of rows to skip when loading from a CSV.
     :type skip_leading_rows: int
     :param write_disposition: The write disposition if the table already exists.
-    :type write_disposition: string
+    :type write_disposition: str
     :param field_delimiter: The delimiter to use when loading from a CSV.
-    :type field_delimiter: string
+    :type field_delimiter: str
     :param max_bad_records: The maximum number of bad records that BigQuery can
         ignore when running the job.
     :type max_bad_records: int
     :param quote_character: The value that is used to quote data sections in a CSV file.
-    :type quote_character: string
+    :type quote_character: str
     :param ignore_unknown_values: [Optional] Indicates if BigQuery should allow
         extra values that are not represented in the table schema.
         If true, the extra values are ignored. If false, records with extra columns
@@ -91,16 +91,16 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         execute() command, which in turn gets stored in XCom for future
         operators to use. This can be helpful with incremental loads--during
         future executions, you can pick up from the max ID.
-    :type max_id_key: string
+    :type max_id_key: str
     :param bigquery_conn_id: Reference to a specific BigQuery hook.
-    :type bigquery_conn_id: string
+    :type bigquery_conn_id: str
     :param google_cloud_storage_conn_id: Reference to a specific Google
         cloud storage hook.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any. For this to
         work, the service account making the request must have domain-wide
         delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param schema_update_options: Allows the schema of the destination
         table to be updated as a side effect of the load job.
     :type schema_update_options: list
diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index 016913ab10c61..ce0450807a6f7 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -28,7 +28,7 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
 
     :param source_bucket: The source Google cloud storage bucket where the
          object is. (templated)
-    :type source_bucket: string
+    :type source_bucket: str
     :param source_object: The source name of the object to copy in the Google cloud
         storage bucket. (templated)
         If wildcards are used in this argument:
@@ -36,10 +36,10 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
             bucket. The wildcard can appear inside the object name or at the
             end of the object name. Appending a wildcard to the bucket name is
             unsupported.
-    :type source_object: string
+    :type source_object: str
     :param destination_bucket: The destination Google cloud storage bucket
         where the object should be. (templated)
-    :type destination_bucket: string
+    :type destination_bucket: str
     :param destination_object: The destination name of the object in the
         destination Google cloud storage bucket. (templated)
         If a wildcard is supplied in the source_object argument, this is the
@@ -50,18 +50,18 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
         file ``foo/baz`` will be copied to ``blah/baz``; to retain the prefix write
         the destination_object as e.g. ``blah/foo``, in which case the copied file
         will be named ``blah/foo/baz``.
-    :type destination_object: string
+    :type destination_object: str
     :param move_object: When move object is True, the object is moved instead
         of copied to the new location. This is the equivalent of a mv command
         as opposed to a cp command.
     :type move_object: bool
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google cloud storage.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
 
     :Example:
 
diff --git a/airflow/contrib/operators/gcs_to_s3.py b/airflow/contrib/operators/gcs_to_s3.py
index d0a7947f9f54e..3d841bd02ebd5 100644
--- a/airflow/contrib/operators/gcs_to_s3.py
+++ b/airflow/contrib/operators/gcs_to_s3.py
@@ -28,21 +28,21 @@ class GoogleCloudStorageToS3Operator(GoogleCloudStorageListOperator):
     Synchronizes a Google Cloud Storage bucket with an S3 bucket.
 
     :param bucket: The Google Cloud Storage bucket to find the objects. (templated)
-    :type bucket: string
+    :type bucket: str
     :param prefix: Prefix string which filters objects whose name begin with
         this prefix. (templated)
-    :type prefix: string
+    :type prefix: str
     :param delimiter: The delimiter by which you want to filter the objects. (templated)
         For e.g to lists the CSV files from in a directory in GCS you would use
         delimiter='.csv'.
-    :type delimiter: string
+    :type delimiter: str
     :param google_cloud_storage_conn_id: The connection ID to use when
         connecting to Google Cloud Storage.
-    :type google_cloud_storage_conn_id: string
+    :type google_cloud_storage_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param dest_aws_conn_id: The destination S3 connection
     :type dest_aws_conn_id: str
     :param dest_s3_key: The base S3 key to be used to store the files. (templated)
diff --git a/airflow/contrib/operators/jenkins_job_trigger_operator.py b/airflow/contrib/operators/jenkins_job_trigger_operator.py
index ee9f2be6d1870..7472a59e431d7 100644
--- a/airflow/contrib/operators/jenkins_job_trigger_operator.py
+++ b/airflow/contrib/operators/jenkins_job_trigger_operator.py
@@ -91,11 +91,11 @@ class JenkinsJobTriggerOperator(BaseOperator):
     You'll also need to configure a Jenkins connection in the connections screen.
 
     :param jenkins_connection_id: The jenkins connection to use for this job
-    :type jenkins_connection_id: string
+    :type jenkins_connection_id: str
     :param job_name: The name of the job to trigger
-    :type job_name: string
+    :type job_name: str
     :param parameters: The parameters block to provide to jenkins. (templated)
-    :type parameters: string
+    :type parameters: str
     :param sleep_time: How long will the operator sleep between each status
         request for the job (min 1, default 10)
     :type sleep_time: int
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index d560e2472d5a8..3a5bef5381780 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -71,7 +71,7 @@ class KubernetesPodOperator(BaseOperator):
     :type in_cluster: bool
     :param cluster_context: context that points to kubernetes cluster.
         Ignored when in_cluster is True. If None, current-context is used.
-    :type cluster_context: string
+    :type cluster_context: str
     :param get_logs: get the stdout of the container as logs of the tasks
     :type get_logs: bool
     :param affinity: A dict containing a group of affinity scheduling rules
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 0bf9d6cb551b9..e9b7c1702e8d3 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -93,16 +93,16 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     :param project_id: The Google Cloud project name where the
         prediction job is submitted. (templated)
-    :type project_id: string
+    :type project_id: str
 
     :param job_id: A unique id for the prediction job on Google Cloud
         ML Engine. (templated)
-    :type job_id: string
+    :type job_id: str
 
     :param data_format: The format of the input data.
         It will default to 'DATA_FORMAT_UNSPECIFIED' if is not provided
         or is not one of ["TEXT", "TF_RECORD", "TF_RECORD_GZIP"].
-    :type data_format: string
+    :type data_format: str
 
     :param input_paths: A list of GCS paths of input data for batch
         prediction. Accepting wildcard operator ``*``, but only at the end. (templated)
@@ -110,28 +110,28 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     :param output_path: The GCS path where the prediction results are
         written to. (templated)
-    :type output_path: string
+    :type output_path: str
 
     :param region: The Google Compute Engine region to run the
         prediction job in. (templated)
-    :type region: string
+    :type region: str
 
     :param model_name: The Google Cloud ML Engine model to use for prediction.
         If version_name is not provided, the default version of this
         model will be used.
         Should not be None if version_name is provided.
         Should be None if uri is provided. (templated)
-    :type model_name: string
+    :type model_name: str
 
     :param version_name: The Google Cloud ML Engine model version to use for
         prediction.
         Should be None if uri is provided. (templated)
-    :type version_name: string
+    :type version_name: str
 
     :param uri: The GCS path of the saved model to use for prediction.
         Should be None if model_name is provided.
         It should be a GCS path pointing to a tensorflow SavedModel. (templated)
-    :type uri: string
+    :type uri: str
 
     :param max_worker_count: The maximum number of workers to be used
         for parallel processing. Defaults to 10 if not specified.
@@ -139,16 +139,16 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     :param runtime_version: The Google Cloud ML Engine runtime version to use
         for batch prediction.
-    :type runtime_version: string
+    :type runtime_version: str
 
     :param gcp_conn_id: The connection ID used for connection to Google
         Cloud Platform.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
 
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must
         have doamin-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
 
     :raises: ``ValueError``: if a unique model/version origin cannot be
         determined.
@@ -280,7 +280,7 @@ class MLEngineModelOperator(BaseOperator):
 
     :param project_id: The Google Cloud project name to which MLEngine
         model belongs. (templated)
-    :type project_id: string
+    :type project_id: str
     :param model: A dictionary containing the information about the model.
         If the `operation` is `create`, then the `model` parameter should
         contain all the information about this model such as `name`.
@@ -292,13 +292,13 @@ class MLEngineModelOperator(BaseOperator):
 
         * ``create``: Creates a new model as provided by the `model` parameter.
         * ``get``: Gets a particular model where the name is specified in `model`.
-    :type operation: string
+    :type operation: str
     :param gcp_conn_id: The connection ID to use when fetching connection info.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = [
@@ -338,17 +338,17 @@ class MLEngineVersionOperator(BaseOperator):
 
     :param project_id: The Google Cloud project name to which MLEngine
         model belongs.
-    :type project_id: string
+    :type project_id: str
 
     :param model_name: The name of the Google Cloud ML Engine model that the version
         belongs to. (templated)
-    :type model_name: string
+    :type model_name: str
 
     :param version_name: A name to use for the version being operated upon.
         If not None and the `version` argument is None or does not have a value for
         the `name` key, then this will be populated in the payload for the
         `name` key. (templated)
-    :type version_name: string
+    :type version_name: str
 
     :param version: A dictionary containing the information about the version.
         If the `operation` is `create`, `version` should contain all the
@@ -377,15 +377,15 @@ class MLEngineVersionOperator(BaseOperator):
             model specified by `model_name`).
             The name of the version should be specified in the `version`
             parameter.
-    :type operation: string
+    :type operation: str
 
     :param gcp_conn_id: The connection ID to use when fetching connection info.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
 
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     """
 
     template_fields = [
@@ -446,56 +446,56 @@ class MLEngineTrainingOperator(BaseOperator):
 
     :param project_id: The Google Cloud project name within which MLEngine
         training job should run (templated).
-    :type project_id: string
+    :type project_id: str
 
     :param job_id: A unique templated id for the submitted Google MLEngine
         training job. (templated)
-    :type job_id: string
+    :type job_id: str
 
     :param package_uris: A list of package locations for MLEngine training job,
         which should include the main training program + any additional
         dependencies. (templated)
-    :type package_uris: string
+    :type package_uris: str
 
     :param training_python_module: The Python module name to run within MLEngine
         training job after installing 'package_uris' packages. (templated)
-    :type training_python_module: string
+    :type training_python_module: str
 
     :param training_args: A list of templated command line arguments to pass to
         the MLEngine training program. (templated)
-    :type training_args: string
+    :type training_args: str
 
     :param region: The Google Compute Engine region to run the MLEngine training
         job in (templated).
-    :type region: string
+    :type region: str
 
     :param scale_tier: Resource tier for MLEngine training job. (templated)
-    :type scale_tier: string
+    :type scale_tier: str
 
     :param runtime_version: The Google Cloud ML runtime version to use for
         training. (templated)
-    :type runtime_version: string
+    :type runtime_version: str
 
     :param python_version: The version of Python used in training. (templated)
-    :type python_version: string
+    :type python_version: str
 
     :param job_dir: A Google Cloud Storage path in which to store training
         outputs and other data needed for training. (templated)
-    :type job_dir: string
+    :type job_dir: str
 
     :param gcp_conn_id: The connection ID to use when fetching connection info.
-    :type gcp_conn_id: string
+    :type gcp_conn_id: str
 
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
 
     :param mode: Can be one of 'DRY_RUN'/'CLOUD'. In 'DRY_RUN' mode, no real
         training job will be launched, but the MLEngine training job request
         will be printed out. In 'CLOUD' mode, a real MLEngine training job
         creation request will be issued.
-    :type mode: string
+    :type mode: str
     """
 
     template_fields = [
diff --git a/airflow/contrib/operators/mlengine_operator_utils.py b/airflow/contrib/operators/mlengine_operator_utils.py
index 60001daea4d0f..c2951b715d337 100644
--- a/airflow/contrib/operators/mlengine_operator_utils.py
+++ b/airflow/contrib/operators/mlengine_operator_utils.py
@@ -108,16 +108,16 @@ def validate_err_and_count(summary):
     :param task_prefix: a prefix for the tasks. Only alphanumeric characters and
         hyphen are allowed (no underscores), since this will be used as dataflow
         job name, which doesn't allow other characters.
-    :type task_prefix: string
+    :type task_prefix: str
 
     :param data_format: either of 'TEXT', 'TF_RECORD', 'TF_RECORD_GZIP'
-    :type data_format: string
+    :type data_format: str
 
     :param input_paths: a list of input paths to be sent to BatchPrediction.
     :type input_paths: list of strings
 
     :param prediction_path: GCS path to put the prediction results in.
-    :type prediction_path: string
+    :type prediction_path: str
 
     :param metric_fn_and_keys: a tuple of metric_fn and metric_keys:
         - metric_fn is a function that accepts a dictionary (for an instance),
@@ -132,17 +132,17 @@ def validate_err_and_count(summary):
     :param batch_prediction_job_id: the id to use for the Cloud ML Batch
         prediction job. Passed directly to the MLEngineBatchPredictionOperator as
         the job_id argument.
-    :type batch_prediction_job_id: string
+    :type batch_prediction_job_id: str
 
     :param project_id: the Google Cloud Platform project id in which to execute
         Cloud ML Batch Prediction and Dataflow jobs. If None, then the `dag`'s
         `default_args['project_id']` will be used.
-    :type project_id: string
+    :type project_id: str
 
     :param region: the Google Cloud Platform region in which to execute Cloud ML
         Batch Prediction and Dataflow jobs. If None, then the `dag`'s
         `default_args['region']` will be used.
-    :type region: string
+    :type region: str
 
     :param dataflow_options: options to run Dataflow jobs. If None, then the
         `dag`'s `default_args['dataflow_default_options']` will be used.
@@ -152,19 +152,19 @@ def validate_err_and_count(summary):
         tensorflow.estimator.export_savedmodel(). It cannot be used with
         model_name or version_name below. See MLEngineBatchPredictionOperator for
         more detail.
-    :type model_uri: string
+    :type model_uri: str
 
     :param model_name: Used to indicate a model to use for prediction. Can be
         used in combination with version_name, but cannot be used together with
         model_uri. See MLEngineBatchPredictionOperator for more detail. If None,
         then the `dag`'s `default_args['model_name']` will be used.
-    :type model_name: string
+    :type model_name: str
 
     :param version_name: Used to indicate a model version to use for prediction,
         in combination with model_name. Cannot be used together with model_uri.
         See MLEngineBatchPredictionOperator for more detail. If None, then the
         `dag`'s `default_args['version_name']` will be used.
-    :type version_name: string
+    :type version_name: str
 
     :param dag: The `DAG` to use for all Operators.
     :type dag: airflow.DAG
diff --git a/airflow/contrib/operators/mysql_to_gcs.py b/airflow/contrib/operators/mysql_to_gcs.py
index eb47465e8e8ec..d9fc932ff58dd 100644
--- a/airflow/contrib/operators/mysql_to_gcs.py
+++ b/airflow/contrib/operators/mysql_to_gcs.py
@@ -58,18 +58,18 @@ def __init__(self,
                  **kwargs):
         """
         :param sql: The SQL to execute on the MySQL table.
-        :type sql: string
+        :type sql: str
         :param bucket: The bucket to upload to.
-        :type bucket: string
+        :type bucket: str
         :param filename: The filename to use as the object name when uploading
             to Google cloud storage. A {} should be specified in the filename
             to allow the operator to inject file numbers in cases where the
             file is split due to size.
-        :type filename: string
+        :type filename: str
         :param schema_filename: If set, the filename to use as the object name
             when uploading a .json file containing the BigQuery schema fields
             for the table that was dumped from MySQL.
-        :type schema_filename: string
+        :type schema_filename: str
         :param approx_max_file_size_bytes: This operator supports the ability
             to split large table dumps into multiple files (see notes in the
             filenamed param docs above). Google cloud storage allows for files
@@ -77,10 +77,10 @@ def __init__(self,
             file size of the splits.
         :type approx_max_file_size_bytes: long
         :param mysql_conn_id: Reference to a specific MySQL hook.
-        :type mysql_conn_id: string
+        :type mysql_conn_id: str
         :param google_cloud_storage_conn_id: Reference to a specific Google
             cloud storage hook.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param schema: The schema to use, if any. Should be a list of dict or
             a str. Pass a string if using Jinja template, otherwise, pass a list of
             dict. Examples could be seen: https://cloud.google.com/bigquery/docs
diff --git a/airflow/contrib/operators/postgres_to_gcs_operator.py b/airflow/contrib/operators/postgres_to_gcs_operator.py
index ddebc05319039..78da78ee2f20d 100644
--- a/airflow/contrib/operators/postgres_to_gcs_operator.py
+++ b/airflow/contrib/operators/postgres_to_gcs_operator.py
@@ -56,18 +56,18 @@ def __init__(self,
                  **kwargs):
         """
         :param sql: The SQL to execute on the Postgres table.
-        :type sql: string
+        :type sql: str
         :param bucket: The bucket to upload to.
-        :type bucket: string
+        :type bucket: str
         :param filename: The filename to use as the object name when uploading
             to Google Cloud Storage. A {} should be specified in the filename
             to allow the operator to inject file numbers in cases where the
             file is split due to size.
-        :type filename: string
+        :type filename: str
         :param schema_filename: If set, the filename to use as the object name
             when uploading a .json file containing the BigQuery schema fields
             for the table that was dumped from Postgres.
-        :type schema_filename: string
+        :type schema_filename: str
         :param approx_max_file_size_bytes: This operator supports the ability
             to split large table dumps into multiple files (see notes in the
             filenamed param docs above). Google Cloud Storage allows for files
@@ -75,10 +75,10 @@ def __init__(self,
             file size of the splits.
         :type approx_max_file_size_bytes: long
         :param postgres_conn_id: Reference to a specific Postgres hook.
-        :type postgres_conn_id: string
+        :type postgres_conn_id: str
         :param google_cloud_storage_conn_id: Reference to a specific Google
             cloud storage hook.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param delegate_to: The account to impersonate, if any. For this to
             work, the service account making the request must have domain-wide
             delegation enabled.
diff --git a/airflow/contrib/operators/pubsub_operator.py b/airflow/contrib/operators/pubsub_operator.py
index 2d55b19f8595d..e40828bf92151 100644
--- a/airflow/contrib/operators/pubsub_operator.py
+++ b/airflow/contrib/operators/pubsub_operator.py
@@ -67,19 +67,19 @@ def __init__(
             **kwargs):
         """
         :param project: the GCP project ID where the topic will be created
-        :type project: string
+        :type project: str
         :param topic: the topic to create. Do not include the
             full topic path. In other words, instead of
             ``projects/{project}/topics/{topic}``, provide only
             ``{topic}``. (templated)
-        :type topic: string
+        :type topic: str
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubTopicCreateOperator, self).__init__(*args, **kwargs)
 
@@ -163,28 +163,28 @@ def __init__(
             **kwargs):
         """
         :param topic_project: the GCP project ID where the topic exists
-        :type topic_project: string
+        :type topic_project: str
         :param topic: the topic to create. Do not include the
             full topic path. In other words, instead of
             ``projects/{project}/topics/{topic}``, provide only
             ``{topic}``. (templated)
-        :type topic: string
+        :type topic: str
         :param subscription: the Pub/Sub subscription name. If empty, a random
             name will be generated using the uuid module
-        :type subscription: string
+        :type subscription: str
         :param subscription_project: the GCP project ID where the subscription
             will be created. If empty, ``topic_project`` will be used.
-        :type subscription_project: string
+        :type subscription_project: str
         :param ack_deadline_secs: Number of seconds that a subscriber has to
             acknowledge each message pulled from the subscription
         :type ack_deadline_secs: int
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubSubscriptionCreateOperator, self).__init__(*args, **kwargs)
 
@@ -248,22 +248,22 @@ def __init__(
             **kwargs):
         """
         :param project: the GCP project ID in which to work (templated)
-        :type project: string
+        :type project: str
         :param topic: the topic to delete. Do not include the
             full topic path. In other words, instead of
             ``projects/{project}/topics/{topic}``, provide only
             ``{topic}``. (templated)
-        :type topic: string
+        :type topic: str
         :param fail_if_not_exists: If True and the topic does not exist, fail
             the task
         :type fail_if_not_exists: bool
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubTopicDeleteOperator, self).__init__(*args, **kwargs)
 
@@ -324,22 +324,22 @@ def __init__(
             **kwargs):
         """
         :param project: the GCP project ID in which to work (templated)
-        :type project: string
+        :type project: str
         :param subscription: the subscription to delete. Do not include the
             full subscription path. In other words, instead of
             ``projects/{project}/subscription/{subscription}``, provide only
             ``{subscription}``. (templated)
-        :type subscription: string
+        :type subscription: str
         :param fail_if_not_exists: If True and the subscription does not exist,
             fail the task
         :type fail_if_not_exists: bool
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubSubscriptionDeleteOperator, self).__init__(*args, **kwargs)
 
@@ -396,12 +396,12 @@ def __init__(
             **kwargs):
         """
         :param project: the GCP project ID in which to work (templated)
-        :type project: string
+        :type project: str
         :param topic: the topic to which to publish. Do not include the
             full topic path. In other words, instead of
             ``projects/{project}/topics/{topic}``, provide only
             ``{topic}``. (templated)
-        :type topic: string
+        :type topic: str
         :param messages: a list of messages to be published to the
             topic. Each message is a dict with one or more of the
             following keys-value mappings:
@@ -413,11 +413,11 @@ def __init__(
         :type messages: list
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubPublishOperator, self).__init__(*args, **kwargs)
 
diff --git a/airflow/contrib/operators/s3_list_operator.py b/airflow/contrib/operators/s3_list_operator.py
index a9e005eed3f65..3ca22d5932b75 100644
--- a/airflow/contrib/operators/s3_list_operator.py
+++ b/airflow/contrib/operators/s3_list_operator.py
@@ -30,14 +30,14 @@ class S3ListOperator(BaseOperator):
     used by `xcom` in the downstream task.
 
     :param bucket: The S3 bucket where to find the objects. (templated)
-    :type bucket: string
+    :type bucket: str
     :param prefix: Prefix string to filters the objects whose name begin with
         such prefix. (templated)
-    :type prefix: string
+    :type prefix: str
     :param delimiter: the delimiter marks key hierarchy. (templated)
-    :type delimiter: string
+    :type delimiter: str
     :param aws_conn_id: The connection ID to use when connecting to S3 storage.
-    :type aws_conn_id: string
+    :type aws_conn_id: str
     :parame verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index f2735224790c4..c6228bf4554c8 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -33,14 +33,14 @@ class S3ToGoogleCloudStorageOperator(S3ListOperator):
     destination path.
 
     :param bucket: The S3 bucket where to find the objects. (templated)
-    :type bucket: string
+    :type bucket: str
     :param prefix: Prefix string which filters objects whose name begin with
         such prefix. (templated)
-    :type prefix: string
+    :type prefix: str
     :param delimiter: the delimiter marks key hierarchy. (templated)
-    :type delimiter: string
+    :type delimiter: str
     :param aws_conn_id: The source S3 connection
-    :type aws_conn_id: string
+    :type aws_conn_id: str
     :parame verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
@@ -53,14 +53,14 @@ class S3ToGoogleCloudStorageOperator(S3ListOperator):
     :type verify: bool or str
     :param dest_gcs_conn_id: The destination connection ID to use
         when connecting to Google Cloud Storage.
-    :type dest_gcs_conn_id: string
+    :type dest_gcs_conn_id: str
     :param dest_gcs: The destination Google Cloud Storage bucket and prefix
         where you want to store the files. (templated)
-    :type dest_gcs: string
+    :type dest_gcs: str
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
-    :type delegate_to: string
+    :type delegate_to: str
     :param replace: Whether you want to replace existing destination files
         or not.
     :type replace: bool
diff --git a/airflow/contrib/operators/segment_track_event_operator.py b/airflow/contrib/operators/segment_track_event_operator.py
index 04f6ae6d41d4b..5d2f2db539083 100644
--- a/airflow/contrib/operators/segment_track_event_operator.py
+++ b/airflow/contrib/operators/segment_track_event_operator.py
@@ -27,16 +27,16 @@ class SegmentTrackEventOperator(BaseOperator):
     Send Track Event to Segment for a specified user_id and event
 
     :param user_id: The ID for this user in your database. (templated)
-    :type user_id: string
+    :type user_id: str
     :param event: The name of the event you're tracking. (templated)
-    :type event: string
+    :type event: str
     :param properties: A dictionary of properties for the event. (templated)
     :type properties: dict
     :param segment_conn_id: The connection ID to use when connecting to Segment.
-    :type segment_conn_id: string
+    :type segment_conn_id: str
     :param segment_debug_mode: Determines whether Segment should run in debug mode.
         Defaults to False
-    :type segment_debug_mode: boolean
+    :type segment_debug_mode: bool
     """
     template_fields = ('user_id', 'event', 'properties')
     ui_color = '#ffd700'
diff --git a/airflow/contrib/operators/snowflake_operator.py b/airflow/contrib/operators/snowflake_operator.py
index 39d7d496ea740..6c3f403912134 100644
--- a/airflow/contrib/operators/snowflake_operator.py
+++ b/airflow/contrib/operators/snowflake_operator.py
@@ -26,16 +26,16 @@ class SnowflakeOperator(BaseOperator):
     Executes sql code in a Snowflake database
 
     :param snowflake_conn_id: reference to specific snowflake connection id
-    :type snowflake_conn_id: string
+    :type snowflake_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
     :param warehouse: name of warehouse which overwrite defined
         one in connection
-    :type warehouse: string
+    :type warehouse: str
     :param database: name of database which overwrite defined one in connection
-    :type database: string
+    :type database: str
     """
 
     template_fields = ('sql',)
diff --git a/airflow/contrib/operators/vertica_operator.py b/airflow/contrib/operators/vertica_operator.py
index 41072ff82bdf0..37ccd134e84ac 100644
--- a/airflow/contrib/operators/vertica_operator.py
+++ b/airflow/contrib/operators/vertica_operator.py
@@ -26,7 +26,7 @@ class VerticaOperator(BaseOperator):
     Executes sql code in a specific Vertica database
 
     :param vertica_conn_id: reference to a specific Vertica database
-    :type vertica_conn_id: string
+    :type vertica_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
diff --git a/airflow/contrib/sensors/bash_sensor.py b/airflow/contrib/sensors/bash_sensor.py
index 26fbb06c18d81..7372a419b6900 100644
--- a/airflow/contrib/sensors/bash_sensor.py
+++ b/airflow/contrib/sensors/bash_sensor.py
@@ -33,7 +33,7 @@ class BashSensor(BaseSensorOperator):
 
     :param bash_command: The command, set of commands or reference to a
         bash script (must be '.sh') to be executed.
-    :type bash_command: string
+    :type bash_command: str
 
     :param env: If env is not None, it must be a mapping that defines the
         environment variables for the new process; these are used instead
@@ -41,7 +41,7 @@ class BashSensor(BaseSensorOperator):
         behavior. (templated)
     :type env: dict
     :param output_encoding: output encoding of bash command.
-    :type output_encoding: string
+    :type output_encoding: str
     """
 
     template_fields = ('bash_command', 'env')
diff --git a/airflow/contrib/sensors/bigquery_sensor.py b/airflow/contrib/sensors/bigquery_sensor.py
index 2e496f68897dd..89ec476d9d565 100644
--- a/airflow/contrib/sensors/bigquery_sensor.py
+++ b/airflow/contrib/sensors/bigquery_sensor.py
@@ -28,19 +28,19 @@ class BigQueryTableSensor(BaseSensorOperator):
         :param project_id: The Google cloud project in which to look for the table.
             The connection supplied to the hook must provide
             access to the specified project.
-        :type project_id: string
+        :type project_id: str
         :param dataset_id: The name of the dataset in which to look for the table.
             storage bucket.
-        :type dataset_id: string
+        :type dataset_id: str
         :param table_id: The name of the table to check the existence of.
-        :type table_id: string
+        :type table_id: str
         :param bigquery_conn_id: The connection ID to use when connecting to
             Google BigQuery.
-        :type bigquery_conn_id: string
+        :type bigquery_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request must
             have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
     """
     template_fields = ('project_id', 'dataset_id', 'table_id',)
     ui_color = '#f0eee4'
diff --git a/airflow/contrib/sensors/cassandra_record_sensor.py b/airflow/contrib/sensors/cassandra_record_sensor.py
index 493a6ba6b1e08..bbb2f5099030e 100644
--- a/airflow/contrib/sensors/cassandra_record_sensor.py
+++ b/airflow/contrib/sensors/cassandra_record_sensor.py
@@ -43,12 +43,12 @@ def __init__(self, table, keys, cassandra_conn_id, *args, **kwargs):
 
         :param table: Target Cassandra table.
                       Use dot notation to target a specific keyspace.
-        :type table: string
+        :type table: str
         :param keys: The keys and their values to be monitored
         :type keys: dict
         :param cassandra_conn_id: The connection ID to use
                                   when connecting to Cassandra cluster
-        :type cassandra_conn_id: string
+        :type cassandra_conn_id: str
         """
         super(CassandraRecordSensor, self).__init__(*args, **kwargs)
         self.cassandra_conn_id = cassandra_conn_id
diff --git a/airflow/contrib/sensors/cassandra_table_sensor.py b/airflow/contrib/sensors/cassandra_table_sensor.py
index 5a85995acaaec..088c82bdd3060 100644
--- a/airflow/contrib/sensors/cassandra_table_sensor.py
+++ b/airflow/contrib/sensors/cassandra_table_sensor.py
@@ -41,10 +41,10 @@ def __init__(self, table, cassandra_conn_id, *args, **kwargs):
 
         :param table: Target Cassandra table.
                       Use dot notation to target a specific keyspace.
-        :type table: string
+        :type table: str
         :param cassandra_conn_id: The connection ID to use
                                   when connecting to Cassandra cluster
-        :type cassandra_conn_id: string
+        :type cassandra_conn_id: str
         """
         super(CassandraTableSensor, self).__init__(*args, **kwargs)
         self.cassandra_conn_id = cassandra_conn_id
diff --git a/airflow/contrib/sensors/datadog_sensor.py b/airflow/contrib/sensors/datadog_sensor.py
index fb455d6cd77eb..df0fb0976fb36 100644
--- a/airflow/contrib/sensors/datadog_sensor.py
+++ b/airflow/contrib/sensors/datadog_sensor.py
@@ -32,7 +32,7 @@ class DatadogSensor(BaseSensorOperator):
     Airflow runs.
 
     :param datadog_conn_id: The connection to datadog, containing metadata for api keys.
-    :param datadog_conn_id: string
+    :param datadog_conn_id: str
     """
     ui_color = '#66c3dd'
 
diff --git a/airflow/contrib/sensors/emr_job_flow_sensor.py b/airflow/contrib/sensors/emr_job_flow_sensor.py
index 4193c2d53ed4e..2c7514b3926f3 100644
--- a/airflow/contrib/sensors/emr_job_flow_sensor.py
+++ b/airflow/contrib/sensors/emr_job_flow_sensor.py
@@ -27,7 +27,7 @@ class EmrJobFlowSensor(EmrBaseSensor):
     If it fails the sensor errors, failing the task.
 
     :param job_flow_id: job_flow_id to check the state of
-    :type job_flow_id: string
+    :type job_flow_id: str
     """
 
     NON_TERMINAL_STATES = ['STARTING', 'BOOTSTRAPPING', 'RUNNING',
diff --git a/airflow/contrib/sensors/emr_step_sensor.py b/airflow/contrib/sensors/emr_step_sensor.py
index fc37a5ddb6ea2..8440acbbb314a 100644
--- a/airflow/contrib/sensors/emr_step_sensor.py
+++ b/airflow/contrib/sensors/emr_step_sensor.py
@@ -27,9 +27,9 @@ class EmrStepSensor(EmrBaseSensor):
     If it fails the sensor errors, failing the task.
 
     :param job_flow_id: job_flow_id which contains the step check the state of
-    :type job_flow_id: string
+    :type job_flow_id: str
     :param step_id: step to check the state of
-    :type step_id: string
+    :type step_id: str
     """
 
     NON_TERMINAL_STATES = ['PENDING', 'RUNNING', 'CONTINUE', 'CANCEL_PENDING']
diff --git a/airflow/contrib/sensors/file_sensor.py b/airflow/contrib/sensors/file_sensor.py
index 3f7bb24e0837f..570faac86a610 100644
--- a/airflow/contrib/sensors/file_sensor.py
+++ b/airflow/contrib/sensors/file_sensor.py
@@ -35,10 +35,10 @@ class FileSensor(BaseSensorOperator):
 
     :param fs_conn_id: reference to the File (path)
         connection id
-    :type fs_conn_id: string
+    :type fs_conn_id: str
     :param filepath: File or folder name (relative to
         the base path set within the connection)
-    :type fs_conn_id: string
+    :type fs_conn_id: str
     """
     template_fields = ('filepath',)
     ui_color = '#91818a'
diff --git a/airflow/contrib/sensors/gcs_sensor.py b/airflow/contrib/sensors/gcs_sensor.py
index 23cd760a41f19..5a4f73e61e822 100644
--- a/airflow/contrib/sensors/gcs_sensor.py
+++ b/airflow/contrib/sensors/gcs_sensor.py
@@ -27,17 +27,17 @@ class GoogleCloudStorageObjectSensor(BaseSensorOperator):
     Create a new GoogleCloudStorageObjectSensor.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to check in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         :param google_cloud_storage_conn_id: The connection ID to use when
             connecting to Google cloud storage.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request must have
             domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
     """
     template_fields = ('bucket', 'object')
     ui_color = '#f0eee4'
@@ -79,21 +79,21 @@ class GoogleCloudStorageObjectUpdatedSensor(BaseSensorOperator):
     Create a new GoogleCloudStorageObjectUpdatedSensor.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param object: The name of the object to download in the Google cloud
             storage bucket.
-        :type object: string
+        :type object: str
         :param ts_func: Callback for defining the update condition. The default callback
             returns execution_date + schedule_interval. The callback takes the context
             as parameter.
         :type ts_func: function
         :param google_cloud_storage_conn_id: The connection ID to use when
             connecting to Google cloud storage.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request must have domain-wide
             delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
     """
     template_fields = ('bucket', 'object')
     template_ext = ('.sql',)
@@ -129,17 +129,17 @@ class GoogleCloudStoragePrefixSensor(BaseSensorOperator):
     Create a new GoogleCloudStorageObjectSensor.
 
         :param bucket: The Google cloud storage bucket where the object is.
-        :type bucket: string
+        :type bucket: str
         :param prefix: The name of the prefix to check in the Google cloud
             storage bucket.
-        :type prefix: string
+        :type prefix: str
         :param google_cloud_storage_conn_id: The connection ID to use when
             connecting to Google cloud storage.
-        :type google_cloud_storage_conn_id: string
+        :type google_cloud_storage_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request must have
             domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
     """
     template_fields = ('bucket', 'prefix')
     ui_color = '#f0eee4'
diff --git a/airflow/contrib/sensors/mongo_sensor.py b/airflow/contrib/sensors/mongo_sensor.py
index 3ed49a6f9d64f..8fd32a0775feb 100644
--- a/airflow/contrib/sensors/mongo_sensor.py
+++ b/airflow/contrib/sensors/mongo_sensor.py
@@ -39,12 +39,12 @@ def __init__(self, collection, query, mongo_conn_id="mongo_default", *args, **kw
         Create a new MongoSensor
 
         :param collection: Target MongoDB collection.
-        :type collection: string
+        :type collection: str
         :param query: The query to find the target document.
         :type query: dict
         :param mongo_conn_id: The connection ID to use
                               when connecting to MongoDB.
-        :type mongo_conn_id: string
+        :type mongo_conn_id: str
         """
         super(MongoSensor, self).__init__(*args, **kwargs)
         self.mongo_conn_id = mongo_conn_id
diff --git a/airflow/contrib/sensors/pubsub_sensor.py b/airflow/contrib/sensors/pubsub_sensor.py
index 7d1721570dea4..8104fb56997b2 100644
--- a/airflow/contrib/sensors/pubsub_sensor.py
+++ b/airflow/contrib/sensors/pubsub_sensor.py
@@ -54,10 +54,10 @@ def __init__(
             **kwargs):
         """
         :param project: the GCP project ID for the subscription (templated)
-        :type project: string
+        :type project: str
         :param subscription: the Pub/Sub subscription name. Do not include the
             full subscription path.
-        :type subscription: string
+        :type subscription: str
         :param max_messages: The maximum number of messages to retrieve per
             PubSub pull request
         :type max_messages: int
@@ -69,11 +69,11 @@ def __init__(
         :type ack_messages: bool
         :param gcp_conn_id: The connection ID to use connecting to
             Google Cloud Platform.
-        :type gcp_conn_id: string
+        :type gcp_conn_id: str
         :param delegate_to: The account to impersonate, if any.
             For this to work, the service account making the request
             must have domain-wide delegation enabled.
-        :type delegate_to: string
+        :type delegate_to: str
         """
         super(PubSubPullSensor, self).__init__(*args, **kwargs)
 
diff --git a/airflow/contrib/sensors/qubole_sensor.py b/airflow/contrib/sensors/qubole_sensor.py
index 895fc171bc704..3d4831a40e77a 100644
--- a/airflow/contrib/sensors/qubole_sensor.py
+++ b/airflow/contrib/sensors/qubole_sensor.py
@@ -31,7 +31,7 @@ class QuboleSensor(BaseSensorOperator):
     Base class for all Qubole Sensors
 
     :param qubole_conn_id: The qubole connection to run the sensor against
-    :type qubole_conn_id: string
+    :type qubole_conn_id: str
     :param data: a JSON object containing payload, whose presence needs to be checked
     :type data: a JSON object
 
diff --git a/airflow/contrib/sensors/redis_key_sensor.py b/airflow/contrib/sensors/redis_key_sensor.py
index baf3e161f5365..a2d190baae2a8 100644
--- a/airflow/contrib/sensors/redis_key_sensor.py
+++ b/airflow/contrib/sensors/redis_key_sensor.py
@@ -34,9 +34,9 @@ def __init__(self, key, redis_conn_id, *args, **kwargs):
         Create a new RedisKeySensor
 
         :param key: The key to be monitored
-        :type key: string
+        :type key: str
         :param redis_conn_id: The connection ID to use when connecting to Redis DB.
-        :type redis_conn_id: string
+        :type redis_conn_id: str
         """
         super(RedisKeySensor, self).__init__(*args, **kwargs)
         self.redis_conn_id = redis_conn_id
diff --git a/airflow/executors/local_executor.py b/airflow/executors/local_executor.py
index 0c85262324283..cbb2fd4ea0e33 100644
--- a/airflow/executors/local_executor.py
+++ b/airflow/executors/local_executor.py
@@ -77,7 +77,7 @@ def execute_work(self, key, command):
         :param key: the key to identify the TI
         :type key: Tuple(dag_id, task_id, execution_date)
         :param command: the command to execute
-        :type command: string
+        :type command: str
         """
         if key is None:
             return
@@ -147,7 +147,7 @@ def execute_async(self, key, command):
             :param key: the key to identify the TI
             :type key: Tuple(dag_id, task_id, execution_date)
             :param command: the command to execute
-            :type command: string
+            :type command: str
             """
             local_worker = LocalWorker(self.executor.result_queue)
             local_worker.key = key
@@ -192,7 +192,7 @@ def execute_async(self, key, command):
             :param key: the key to identify the TI
             :type key: Tuple(dag_id, task_id, execution_date)
             :param command: the command to execute
-            :type command: string
+            :type command: str
             """
             self.executor.queue.put((key, command))
 
diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index c337b9c535a67..f8ccb370f8ce0 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -362,7 +362,7 @@ def load_string(self,
         This is provided as a convenience to drop a string in S3. It uses the
         boto infrastructure to ship a file to s3.
 
-        :param string_data: string to set as content for the key.
+        :param string_data: str to set as content for the key.
         :type string_data: str
         :param key: S3 key that will point to the file
         :type key: str
diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index 817295e89609d..a45ebf472fe68 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -35,7 +35,7 @@ class DruidHook(BaseHook):
 
     :param druid_ingest_conn_id: The connection id to the Druid overlord machine
                                  which accepts index jobs
-    :type druid_ingest_conn_id: string
+    :type druid_ingest_conn_id: str
     :param timeout: The interval between polling
                     the Druid job for the status of the ingestion job.
                     Must be greater than or equal to 1
diff --git a/airflow/hooks/hdfs_hook.py b/airflow/hooks/hdfs_hook.py
index 3c9136b1fd165..b00bab42ce813 100644
--- a/airflow/hooks/hdfs_hook.py
+++ b/airflow/hooks/hdfs_hook.py
@@ -39,9 +39,9 @@ class HDFSHook(BaseHook):
     Interact with HDFS. This class is a wrapper around the snakebite library.
 
     :param hdfs_conn_id: Connection id to fetch connection info
-    :type conn_id: string
+    :type conn_id: str
     :param proxy_user: effective user for HDFS operations
-    :type proxy_user: string
+    :type proxy_user: str
     :param autoconfig: use snakebite's automatically configured client
     :type autoconfig: bool
     """
diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index b934ad038917b..871205b93dff6 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -71,13 +71,13 @@ class HiveCliHook(BaseHook):
     connection string as is.
 
     :param mapred_queue: queue used by the Hadoop Scheduler (Capacity or Fair)
-    :type  mapred_queue: string
+    :type  mapred_queue: str
     :param mapred_queue_priority: priority within the job queue.
         Possible settings include: VERY_HIGH, HIGH, NORMAL, LOW, VERY_LOW
-    :type  mapred_queue_priority: string
+    :type  mapred_queue_priority: str
     :param mapred_job_name: This name will appear in the jobtracker.
         This can make monitoring easier.
-    :type  mapred_job_name: string
+    :type  mapred_job_name: str
     """
 
     def __init__(
@@ -323,7 +323,7 @@ def load_df(
         :type field_dict: OrderedDict
         :param delimiter: field delimiter in the file
         :type delimiter: str
-        :param encoding: string encoding to use when writing DataFrame to file
+        :param encoding: str encoding to use when writing DataFrame to file
         :type encoding: str
         :param pandas_kwargs: passed to DataFrame.to_csv
         :type pandas_kwargs: dict
@@ -536,13 +536,13 @@ def check_for_partition(self, schema, table, partition):
         Checks whether a partition exists
 
         :param schema: Name of hive schema (database) @table belongs to
-        :type schema: string
+        :type schema: str
         :param table: Name of hive table @partition belongs to
-        :type schema: string
+        :type schema: str
         :partition: Expression that matches the partitions to check for
             (eg `a = 'b' AND c = 'd'`)
-        :type schema: string
-        :rtype: boolean
+        :type schema: str
+        :rtype: bool
 
         >>> hh = HiveMetastoreHook()
         >>> t = 'static_babynames_partitioned'
@@ -563,12 +563,12 @@ def check_for_named_partition(self, schema, table, partition_name):
         Checks whether a partition with a given name exists
 
         :param schema: Name of hive schema (database) @table belongs to
-        :type schema: string
+        :type schema: str
         :param table: Name of hive table @partition belongs to
-        :type schema: string
+        :type schema: str
         :partition: Name of the partitions to check for (eg `a=b/c=d`)
-        :type schema: string
-        :rtype: boolean
+        :type schema: str
+        :rtype: bool
 
         >>> hh = HiveMetastoreHook()
         >>> t = 'static_babynames_partitioned'
@@ -652,7 +652,7 @@ def _get_max_partition_from_part_specs(part_specs, partition_key, filter_map):
         :param part_specs: list of partition specs.
         :type part_specs: list
         :param partition_key: partition key name.
-        :type partition_key: string
+        :type partition_key: str
         :param filter_map: partition_key:partition_value map used for partition filtering,
                            e.g. {'key1': 'value1', 'key2': 'value2'}.
                            Only partitions matching all partition_key:partition_value
@@ -692,11 +692,11 @@ def max_partition(self, schema, table_name, field=None, filter_map=None):
         filter out partitions.
 
         :param schema: schema name.
-        :type schema: string
+        :type schema: str
         :param table_name: table name.
-        :type table_name: string
+        :type table_name: str
         :param field: partition key to get max partition from.
-        :type field: string
+        :type field: str
         :param filter_map: partition_key:partition_value map used for partition filtering.
         :type filter_map: map
 
diff --git a/airflow/hooks/slack_hook.py b/airflow/hooks/slack_hook.py
index 17006fc9a5cc9..953ce319b1eee 100644
--- a/airflow/hooks/slack_hook.py
+++ b/airflow/hooks/slack_hook.py
@@ -34,9 +34,9 @@ def __init__(self, token=None, slack_conn_id=None):
         If both supplied, Slack API token will be used.
 
         :param token: Slack API token
-        :type token: string
+        :type token: str
         :param slack_conn_id: connection that has Slack API token in the password field
-        :type slack_conn_id: string
+        :type slack_conn_id: str
         """
         self.token = self.__get_token(token, slack_conn_id)
 
diff --git a/airflow/macros/hive.py b/airflow/macros/hive.py
index bb60203e95347..f8e57bb5156dd 100644
--- a/airflow/macros/hive.py
+++ b/airflow/macros/hive.py
@@ -27,14 +27,14 @@ def max_partition(
     Gets the max partition for a table.
 
     :param schema: The hive schema the table lives in
-    :type schema: string
+    :type schema: str
     :param table: The hive table you are interested in, supports the dot
         notation as in "my_database.my_table", if a dot is found,
         the schema param is disregarded
-    :type table: string
+    :type table: str
     :param metastore_conn_id: The hive connection you are interested in.
         If your default is set you don't need to use this parameter.
-    :type metastore_conn_id: string
+    :type metastore_conn_id: str
     :param filter_map: partition_key:partition_value map used for partition filtering,
                        e.g. {'key1': 'value1', 'key2': 'value2'}.
                        Only partitions matching all partition_key:partition_value
diff --git a/airflow/models.py b/airflow/models.py
index 6cb42a32b221a..31cf043dfe90e 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1081,15 +1081,15 @@ def generate_command(dag_id,
         :type mark_success: bool
         :param ignore_all_deps: Ignore all ignorable dependencies.
             Overrides the other ignore_* parameters.
-        :type ignore_all_deps: boolean
+        :type ignore_all_deps: bool
         :param ignore_depends_on_past: Ignore depends_on_past parameter of DAGs
             (e.g. for Backfills)
-        :type ignore_depends_on_past: boolean
+        :type ignore_depends_on_past: bool
         :param ignore_task_deps: Ignore task-specific dependencies such as depends_on_past
             and trigger rule
-        :type ignore_task_deps: boolean
+        :type ignore_task_deps: bool
         :param ignore_ti_state: Ignore the task instance's previous failure/success
-        :type ignore_ti_state: boolean
+        :type ignore_ti_state: bool
         :param local: Whether to run the task locally
         :type local: bool
         :param pickle_id: If the DAG was serialized to the DB, the ID
@@ -1340,7 +1340,7 @@ def are_dependencies_met(
         :type session: Session
         :param verbose: whether log details on failed dependencies on
             info or debug log level
-        :type verbose: boolean
+        :type verbose: bool
         """
         dep_context = dep_context or DepContext()
         failed = False
@@ -1480,19 +1480,19 @@ def _check_and_change_state_before_execution(
         executed, in preparation for _run_raw_task
 
         :param verbose: whether to turn on more verbose logging
-        :type verbose: boolean
+        :type verbose: bool
         :param ignore_all_deps: Ignore all of the non-critical dependencies, just runs
-        :type ignore_all_deps: boolean
+        :type ignore_all_deps: bool
         :param ignore_depends_on_past: Ignore depends_on_past DAG attribute
-        :type ignore_depends_on_past: boolean
+        :type ignore_depends_on_past: bool
         :param ignore_task_deps: Don't check the dependencies of this TI's task
-        :type ignore_task_deps: boolean
+        :type ignore_task_deps: bool
         :param ignore_ti_state: Disregards previous task instance state
-        :type ignore_ti_state: boolean
+        :type ignore_ti_state: bool
         :param mark_success: Don't run the task, mark its state as success
-        :type mark_success: boolean
+        :type mark_success: bool
         :param test_mode: Doesn't record success or failure in the DB
-        :type test_mode: boolean
+        :type test_mode: bool
         :param pool: specifies the pool to use to run the task instance
         :type pool: str
         :return: whether the state was changed to running or not
@@ -1610,9 +1610,9 @@ def _run_raw_task(
         only after another function changes the state to running.
 
         :param mark_success: Don't run the task, mark its state as success
-        :type mark_success: boolean
+        :type mark_success: bool
         :param test_mode: Doesn't record success or failure in the DB
-        :type test_mode: boolean
+        :type test_mode: bool
         :param pool: specifies the pool to use to run the task instance
         :type pool: str
         """
@@ -2032,7 +2032,7 @@ def xcom_push(
         Make an XCom available for tasks to pull.
 
         :param key: A key for the XCom
-        :type key: string
+        :type key: str
         :param value: A value for the XCom. The value is pickled and stored
             in the database.
         :type value: any pickleable object
@@ -2078,13 +2078,13 @@ def xcom_pull(
             available as a constant XCOM_RETURN_KEY. This key is automatically
             given to XComs returned by tasks (as opposed to being pushed
             manually). To remove the filter, pass key=None.
-        :type key: string
+        :type key: str
         :param task_ids: Only XComs from tasks with matching ids will be
             pulled. Can pass None to remove the filter.
-        :type task_ids: string or iterable of strings (representing task_ids)
+        :type task_ids: str or iterable of strings (representing task_ids)
         :param dag_id: If provided, only pulls XComs from this DAG.
             If None (default), the DAG of the calling task is used.
-        :type dag_id: string
+        :type dag_id: str
         :param include_prior_dates: If False, only XComs from the current
             execution_date are returned. If True, XComs from previous dates
             are returned as well.
@@ -2323,9 +2323,9 @@ class derived from this one results in the creation of a task object,
     be set by using the set_upstream and/or set_downstream methods.
 
     :param task_id: a unique, meaningful id for the task
-    :type task_id: string
+    :type task_id: str
     :param owner: the owner of the task, using the unix username is recommended
-    :type owner: string
+    :type owner: str
     :param retries: the number of retries that should be performed before
         failing the task
     :type retries: int
@@ -3245,9 +3245,9 @@ class DAG(BaseDag, LoggingMixin):
     added once to a DAG.
 
     :param dag_id: The id of the DAG
-    :type dag_id: string
+    :type dag_id: str
     :param description: The description for the DAG to e.g. be shown on the webserver
-    :type description: string
+    :type description: str
     :param schedule_interval: Defines how often that DAG runs, this
         timedelta object gets added to your latest task instance's
         execution_date to figure out the next schedule
@@ -3264,7 +3264,7 @@ class DAG(BaseDag, LoggingMixin):
         defines where jinja will look for your templates. Order matters.
         Note that jinja/airflow includes the path of your DAG file by
         default
-    :type template_searchpath: string or list of stings
+    :type template_searchpath: str or list of stings
     :param user_defined_macros: a dictionary of macros that will be exposed
         in your jinja templates. For example, passing ``dict(foo='bar')``
         to this argument allows you to ``{{ foo }}`` in all jinja
@@ -3303,9 +3303,9 @@ class DAG(BaseDag, LoggingMixin):
     :type sla_miss_callback: types.FunctionType
     :param default_view: Specify DAG default view (tree, graph, duration,
                                                    gantt, landing_times)
-    :type default_view: string
+    :type default_view: str
     :param orientation: Specify DAG orientation in graph view (LR, TB, RL, BT)
-    :type orientation: string
+    :type orientation: str
     :param catchup: Perform scheduler catchup (or only run latest)? Defaults to True
     :type catchup: bool
     :param on_failure_callback: A function to be called when a DagRun of this dag fails.
@@ -4296,12 +4296,12 @@ def run(
             dependencies for the first set of tasks only
         :type ignore_first_depends_on_past: bool
         :param pool: Resource pool to use
-        :type pool: string
+        :type pool: str
         :param delay_on_limit_secs: Time in seconds to wait before next attempt to run
             dag run when max_active_runs limit has been reached
         :type delay_on_limit_secs: float
         :param verbose: Make logging output more verbose
-        :type verbose: boolean
+        :type verbose: bool
         :param conf: user defined dictionary passed from CLI
         :type conf: dict
         """
@@ -4350,7 +4350,7 @@ def create_dagrun(self,
         Returns the dag run.
 
         :param run_id: defines the the run id for this dag run
-        :type run_id: string
+        :type run_id: str
         :param execution_date: the execution date of this dag run
         :type execution_date: datetime
         :param state: the state of the dag run
@@ -5082,9 +5082,9 @@ def find(dag_id=None, run_id=None, execution_date=None,
         Returns a set of dag runs for the given search criteria.
 
         :param dag_id: the dag_id to find dag runs for
-        :type dag_id: integer, list
+        :type dag_id: int, list
         :param run_id: defines the the run id for this dag run
-        :type run_id: string
+        :type run_id: str
         :param execution_date: the execution date
         :type execution_date: datetime
         :param state: the state of the dag run
diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index c6b6cc44d5de3..f9c2e1bbc007d 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -38,7 +38,7 @@ class BashOperator(BaseOperator):
 
     :param bash_command: The command, set of commands or reference to a
         bash script (must be '.sh') to be executed. (templated)
-    :type bash_command: string
+    :type bash_command: str
     :param xcom_push: If xcom_push is True, the last line written to stdout
         will also be pushed to an XCom when the bash command completes.
     :type xcom_push: bool
diff --git a/airflow/operators/check_operator.py b/airflow/operators/check_operator.py
index d60bbb4a06850..404964dad6cc8 100644
--- a/airflow/operators/check_operator.py
+++ b/airflow/operators/check_operator.py
@@ -59,7 +59,7 @@ class CheckOperator(BaseOperator):
     single record from an external source.
 
     :param sql: the sql to be executed. (templated)
-    :type sql: string
+    :type sql: str
     """
 
     template_fields = ('sql',)
@@ -114,7 +114,7 @@ class ValueCheckOperator(BaseOperator):
     single record from an external source.
 
     :param sql: the sql to be executed. (templated)
-    :type sql: string
+    :type sql: str
     """
 
     __mapper_args__ = {
diff --git a/airflow/operators/druid_check_operator.py b/airflow/operators/druid_check_operator.py
index 73f7915ca5f40..39674fdd3983e 100644
--- a/airflow/operators/druid_check_operator.py
+++ b/airflow/operators/druid_check_operator.py
@@ -51,9 +51,9 @@ class DruidCheckOperator(CheckOperator):
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
-    :type sql: string
+    :type sql: str
     :param druid_broker_conn_id: reference to the druid broker
-    :type druid_broker_conn_id: string
+    :type druid_broker_conn_id: str
     """
 
     @apply_defaults
diff --git a/airflow/operators/email_operator.py b/airflow/operators/email_operator.py
index ae176caecff2a..0ea7fc0cc476a 100644
--- a/airflow/operators/email_operator.py
+++ b/airflow/operators/email_operator.py
@@ -29,10 +29,10 @@ class EmailOperator(BaseOperator):
     :param to: list of emails to send the email to. (templated)
     :type to: list or string (comma or semicolon delimited)
     :param subject: subject line for the email. (templated)
-    :type subject: string
+    :type subject: str
     :param html_content: content of the email, html markup
         is allowed. (templated)
-    :type html_content: string
+    :type html_content: str
     :param files: file names to attach in email
     :type files: list
     :param cc: list of recipients to be added in CC field
@@ -40,10 +40,10 @@ class EmailOperator(BaseOperator):
     :param bcc: list of recipients to be added in BCC field
     :type bcc: list or string (comma or semicolon delimited)
     :param mime_subtype: MIME sub content type
-    :type mime_subtype: string
+    :type mime_subtype: str
     :param mime_charset: character set parameter added to the Content-Type
         header.
-    :type mime_charset: string
+    :type mime_charset: str
     """
 
     template_fields = ('to', 'subject', 'html_content')
diff --git a/airflow/operators/hive_operator.py b/airflow/operators/hive_operator.py
index cc9157a20758c..9cebc386c3192 100644
--- a/airflow/operators/hive_operator.py
+++ b/airflow/operators/hive_operator.py
@@ -34,9 +34,9 @@ class HiveOperator(BaseOperator):
     :param hql: the hql to be executed. Note that you may also use
         a relative path from the dag file of a (template) hive
         script. (templated)
-    :type hql: string
+    :type hql: str
     :param hive_cli_conn_id: reference to the Hive database. (templated)
-    :type hive_cli_conn_id: string
+    :type hive_cli_conn_id: str
     :param hiveconfs: if defined, these key value pairs will be passed
         to hive as ``-hiveconf "key"="value"``
     :type hiveconfs: dict
@@ -46,18 +46,18 @@ class HiveOperator(BaseOperator):
         Note that you may want to use this along with the
         ``DAG(user_defined_macros=myargs)`` parameter. View the DAG
         object documentation for more details.
-    :type hiveconf_jinja_translate: boolean
+    :type hiveconf_jinja_translate: bool
     :param script_begin_tag: If defined, the operator will get rid of the
         part of the script before the first occurrence of `script_begin_tag`
     :type script_begin_tag: str
     :param mapred_queue: queue used by the Hadoop CapacityScheduler. (templated)
-    :type  mapred_queue: string
+    :type  mapred_queue: str
     :param mapred_queue_priority: priority within CapacityScheduler queue.
         Possible settings include: VERY_HIGH, HIGH, NORMAL, LOW, VERY_LOW
-    :type  mapred_queue_priority: string
+    :type  mapred_queue_priority: str
     :param mapred_job_name: This name will appear in the jobtracker.
         This can make monitoring easier.
-    :type  mapred_job_name: string
+    :type  mapred_job_name: str
     """
 
     template_fields = ('hql', 'schema', 'hive_cli_conn_id', 'mapred_queue',
diff --git a/airflow/operators/hive_to_samba_operator.py b/airflow/operators/hive_to_samba_operator.py
index fa2a9619eb73e..7963524a106e3 100644
--- a/airflow/operators/hive_to_samba_operator.py
+++ b/airflow/operators/hive_to_samba_operator.py
@@ -32,11 +32,11 @@ class Hive2SambaOperator(BaseOperator):
     results of the query as a csv to a Samba location.
 
     :param hql: the hql to be exported. (templated)
-    :type hql: string
+    :type hql: str
     :param hiveserver2_conn_id: reference to the hiveserver2 service
-    :type hiveserver2_conn_id: string
+    :type hiveserver2_conn_id: str
     :param samba_conn_id: reference to the samba destination
-    :type samba_conn_id: string
+    :type samba_conn_id: str
     """
 
     template_fields = ('hql', 'destination_filepath')
diff --git a/airflow/operators/http_operator.py b/airflow/operators/http_operator.py
index 7d641720705a5..3e00de96ebf4c 100644
--- a/airflow/operators/http_operator.py
+++ b/airflow/operators/http_operator.py
@@ -28,11 +28,11 @@ class SimpleHttpOperator(BaseOperator):
     Calls an endpoint on an HTTP system to execute an action
 
     :param http_conn_id: The connection to run the operator against
-    :type http_conn_id: string
+    :type http_conn_id: str
     :param endpoint: The relative part of the full url. (templated)
-    :type endpoint: string
+    :type endpoint: str
     :param method: The HTTP method to use, default = "POST"
-    :type method: string
+    :type method: str
     :param data: The data to pass. POST-data in POST/PUT and params
         in the URL for a GET request. (templated)
     :type data: For POST/PUT, depends on the content-type parameter,
diff --git a/airflow/operators/jdbc_operator.py b/airflow/operators/jdbc_operator.py
index 9e7f24dbf6fa3..a10bf30c5c0db 100644
--- a/airflow/operators/jdbc_operator.py
+++ b/airflow/operators/jdbc_operator.py
@@ -29,7 +29,7 @@ class JdbcOperator(BaseOperator):
     Requires jaydebeapi.
 
     :param jdbc_conn_id: reference to a predefined database
-    :type jdbc_conn_id: string
+    :type jdbc_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
diff --git a/airflow/operators/mssql_operator.py b/airflow/operators/mssql_operator.py
index 1309be94e4520..f27e2145ebd63 100644
--- a/airflow/operators/mssql_operator.py
+++ b/airflow/operators/mssql_operator.py
@@ -27,12 +27,12 @@ class MsSqlOperator(BaseOperator):
     Executes sql code in a specific Microsoft SQL database
 
     :param mssql_conn_id: reference to a specific mssql database
-    :type mssql_conn_id: string
+    :type mssql_conn_id: str
     :param sql: the sql code to be executed
-    :type sql: string or string pointing to a template file with .sql
+    :type sql: str or string pointing to a template file with .sql
         extension. (templated)
     :param database: name of database which overwrite defined one in connection
-    :type database: string
+    :type database: str
     """
 
     template_fields = ('sql',)
diff --git a/airflow/operators/mysql_operator.py b/airflow/operators/mysql_operator.py
index 2b940c785be35..e5bd788bd163a 100644
--- a/airflow/operators/mysql_operator.py
+++ b/airflow/operators/mysql_operator.py
@@ -27,13 +27,13 @@ class MySqlOperator(BaseOperator):
     Executes sql code in a specific MySQL database
 
     :param mysql_conn_id: reference to a specific mysql database
-    :type mysql_conn_id: string
+    :type mysql_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
     :param database: name of database which overwrite defined one in connection
-    :type database: string
+    :type database: str
     """
 
     template_fields = ('sql',)
diff --git a/airflow/operators/oracle_operator.py b/airflow/operators/oracle_operator.py
index 275165f1c77e5..b97129715ff13 100644
--- a/airflow/operators/oracle_operator.py
+++ b/airflow/operators/oracle_operator.py
@@ -27,7 +27,7 @@ class OracleOperator(BaseOperator):
     Executes sql code in a specific Oracle database
 
     :param oracle_conn_id: reference to a specific Oracle database
-    :type oracle_conn_id: string
+    :type oracle_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
diff --git a/airflow/operators/pig_operator.py b/airflow/operators/pig_operator.py
index 8603068f87398..3426ec522e4b6 100644
--- a/airflow/operators/pig_operator.py
+++ b/airflow/operators/pig_operator.py
@@ -29,15 +29,15 @@ class PigOperator(BaseOperator):
     Executes pig script.
 
     :param pig: the pig latin script to be executed. (templated)
-    :type pig: string
+    :type pig: str
     :param pig_cli_conn_id: reference to the Hive database
-    :type pig_cli_conn_id: string
+    :type pig_cli_conn_id: str
     :param pigparams_jinja_translate: when True, pig params-type templating
         ${var} gets translated into jinja-type templating {{ var }}. Note that
         you may want to use this along with the
         ``DAG(user_defined_macros=myargs)`` parameter. View the DAG
         object documentation for more details.
-    :type pigparams_jinja_translate: boolean
+    :type pigparams_jinja_translate: bool
     """
 
     template_fields = ('pig',)
diff --git a/airflow/operators/postgres_operator.py b/airflow/operators/postgres_operator.py
index 5ff6e9e643278..e329100aa2e8e 100644
--- a/airflow/operators/postgres_operator.py
+++ b/airflow/operators/postgres_operator.py
@@ -26,13 +26,13 @@ class PostgresOperator(BaseOperator):
     Executes sql code in a specific Postgres database
 
     :param postgres_conn_id: reference to a specific postgres database
-    :type postgres_conn_id: string
+    :type postgres_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
     :param database: name of database which overwrite defined one in connection
-    :type database: string
+    :type database: str
     """
 
     template_fields = ('sql',)
diff --git a/airflow/operators/presto_check_operator.py b/airflow/operators/presto_check_operator.py
index 608aebfe2966a..16f5bc0212a15 100644
--- a/airflow/operators/presto_check_operator.py
+++ b/airflow/operators/presto_check_operator.py
@@ -52,9 +52,9 @@ class PrestoCheckOperator(CheckOperator):
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
-    :type sql: string
+    :type sql: str
     :param presto_conn_id: reference to the Presto database
-    :type presto_conn_id: string
+    :type presto_conn_id: str
     """
 
     @apply_defaults
@@ -76,9 +76,9 @@ class PrestoValueCheckOperator(ValueCheckOperator):
     Performs a simple value check using sql code.
 
     :param sql: the sql to be executed
-    :type sql: string
+    :type sql: str
     :param presto_conn_id: reference to the Presto database
-    :type presto_conn_id: string
+    :type presto_conn_id: str
     """
 
     @apply_defaults
@@ -108,7 +108,7 @@ class PrestoIntervalCheckOperator(IntervalCheckOperator):
     :param metrics_threshold: a dictionary of ratios indexed by metrics
     :type metrics_threshold: dict
     :param presto_conn_id: reference to the Presto database
-    :type presto_conn_id: string
+    :type presto_conn_id: str
     """
 
     @apply_defaults
diff --git a/airflow/operators/redshift_to_s3_operator.py b/airflow/operators/redshift_to_s3_operator.py
index e6682c78df3f7..b1fee56e95c60 100644
--- a/airflow/operators/redshift_to_s3_operator.py
+++ b/airflow/operators/redshift_to_s3_operator.py
@@ -28,17 +28,17 @@ class RedshiftToS3Transfer(BaseOperator):
     Executes an UNLOAD command to s3 as a CSV with headers
 
     :param schema: reference to a specific schema in redshift database
-    :type schema: string
+    :type schema: str
     :param table: reference to a specific table in redshift database
-    :type table: string
+    :type table: str
     :param s3_bucket: reference to a specific S3 bucket
-    :type s3_bucket: string
+    :type s3_bucket: str
     :param s3_key: reference to a specific S3 key
-    :type s3_key: string
+    :type s3_key: str
     :param redshift_conn_id: reference to a specific redshift database
-    :type redshift_conn_id: string
+    :type redshift_conn_id: str
     :param aws_conn_id: reference to a specific S3 connection
-    :type aws_conn_id: string
+    :type aws_conn_id: str
     :parame verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
diff --git a/airflow/operators/s3_to_redshift_operator.py b/airflow/operators/s3_to_redshift_operator.py
index 8c83f4437267f..265d6e25634f2 100644
--- a/airflow/operators/s3_to_redshift_operator.py
+++ b/airflow/operators/s3_to_redshift_operator.py
@@ -28,17 +28,17 @@ class S3ToRedshiftTransfer(BaseOperator):
     Executes an COPY command to load files from s3 to Redshift
 
     :param schema: reference to a specific schema in redshift database
-    :type schema: string
+    :type schema: str
     :param table: reference to a specific table in redshift database
-    :type table: string
+    :type table: str
     :param s3_bucket: reference to a specific S3 bucket
-    :type s3_bucket: string
+    :type s3_bucket: str
     :param s3_key: reference to a specific S3 key
-    :type s3_key: string
+    :type s3_key: str
     :param redshift_conn_id: reference to a specific redshift database
-    :type redshift_conn_id: string
+    :type redshift_conn_id: str
     :param aws_conn_id: reference to a specific S3 connection
-    :type aws_conn_id: string
+    :type aws_conn_id: str
     :parame verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
diff --git a/airflow/operators/slack_operator.py b/airflow/operators/slack_operator.py
index 98a56947c0ee1..b6fb75a2360e3 100644
--- a/airflow/operators/slack_operator.py
+++ b/airflow/operators/slack_operator.py
@@ -32,11 +32,11 @@ class SlackAPIOperator(BaseOperator):
     In the future additional Slack API Operators will be derived from this class as well
 
     :param slack_conn_id: Slack connection ID which its password is Slack API token
-    :type slack_conn_id: string
+    :type slack_conn_id: str
     :param token: Slack API token (https://api.slack.com/web)
-    :type token: string
+    :type token: str
     :param method: The Slack API Method to Call (https://api.slack.com/methods)
-    :type method: string
+    :type method: str
     :param api_params: API Method call parameters (https://api.slack.com/methods)
     :type api_params: dict
     """
@@ -93,13 +93,13 @@ class SlackAPIPostOperator(SlackAPIOperator):
 
     :param channel: channel in which to post message on slack name (#general) or
         ID (C12318391). (templated)
-    :type channel: string
+    :type channel: str
     :param username: Username that airflow will be posting to Slack as. (templated)
-    :type username: string
+    :type username: str
     :param text: message to send to slack. (templated)
-    :type text: string
+    :type text: str
     :param icon_url: url to icon used for this message
-    :type icon_url: string
+    :type icon_url: str
     :param attachments: extra formatting details. (templated)
         - see https://api.slack.com/docs/attachments.
     :type attachments: array of hashes
diff --git a/airflow/operators/sqlite_operator.py b/airflow/operators/sqlite_operator.py
index 5b7213ed816d8..8280075a32f87 100644
--- a/airflow/operators/sqlite_operator.py
+++ b/airflow/operators/sqlite_operator.py
@@ -27,9 +27,9 @@ class SqliteOperator(BaseOperator):
     Executes sql code in a specific Sqlite database
 
     :param sqlite_conn_id: reference to a specific sqlite database
-    :type sqlite_conn_id: string
+    :type sqlite_conn_id: str
     :param sql: the sql code to be executed. (templated)
-    :type sql: string or string pointing to a template file. File must have
+    :type sql: str or string pointing to a template file. File must have
         a '.sql' extensions.
     """
 
diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index bf36ee786f413..5ac6b0c22ab0f 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -30,10 +30,10 @@ class ExternalTaskSensor(BaseSensorOperator):
 
     :param external_dag_id: The dag_id that contains the task you want to
         wait for
-    :type external_dag_id: string
+    :type external_dag_id: str
     :param external_task_id: The task_id that contains the task you want to
         wait for
-    :type external_task_id: string
+    :type external_task_id: str
     :param allowed_states: list of allowed states, default is ``['success']``
     :type allowed_states: list
     :param execution_delta: time difference with the previous execution to
diff --git a/airflow/sensors/hive_partition_sensor.py b/airflow/sensors/hive_partition_sensor.py
index c8eddc3443fc6..ca10c863b478c 100644
--- a/airflow/sensors/hive_partition_sensor.py
+++ b/airflow/sensors/hive_partition_sensor.py
@@ -31,12 +31,12 @@ class HivePartitionSensor(BaseSensorOperator):
 
     :param table: The name of the table to wait for, supports the dot
         notation (my_database.my_table)
-    :type table: string
+    :type table: str
     :param partition: The partition clause to wait for. This is passed as
         is to the metastore Thrift client ``get_partitions_by_filter`` method,
         and apparently supports SQL like notation as in ``ds='2015-01-01'
         AND type='value'`` and comparison operators as in ``"ds>=2015-01-01"``
-    :type partition: string
+    :type partition: str
     :param metastore_conn_id: reference to the metastore thrift service
         connection id
     :type metastore_conn_id: str
diff --git a/airflow/sensors/http_sensor.py b/airflow/sensors/http_sensor.py
index 33f8531368ec1..4a1c75be30bb4 100644
--- a/airflow/sensors/http_sensor.py
+++ b/airflow/sensors/http_sensor.py
@@ -32,11 +32,11 @@ class HttpSensor(BaseSensorOperator):
         404 not found or response_check function returned False
 
     :param http_conn_id: The connection to run the sensor against
-    :type http_conn_id: string
+    :type http_conn_id: str
     :param method: The HTTP request method to use
-    :type method: string
+    :type method: str
     :param endpoint: The relative part of the full url
-    :type endpoint: string
+    :type endpoint: str
     :param request_params: The parameters to be added to the GET url
     :type request_params: a dictionary of string key/value pairs
     :param headers: The HTTP headers to be added to the GET request
diff --git a/airflow/sensors/sql_sensor.py b/airflow/sensors/sql_sensor.py
index e9208fa89042d..de46e6d3db9b8 100644
--- a/airflow/sensors/sql_sensor.py
+++ b/airflow/sensors/sql_sensor.py
@@ -30,7 +30,7 @@ class SqlSensor(BaseSensorOperator):
     sql returns no row, or if the first cell in (0, '0', '').
 
     :param conn_id: The connection to run the sensor against
-    :type conn_id: string
+    :type conn_id: str
     :param sql: The sql to run. To pass, it needs to return at least one cell
         that contains a non-zero / empty string value.
     """
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index fbfb1a038d09b..cd3c2720783fe 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -49,22 +49,22 @@ class DepContext(object):
         creation while checking to see whether the task instance is runnable. It was the
         shortest path to add the feature. This is bad since this class should be pure (no
         side effects).
-    :type flag_upstream_failed: boolean
+    :type flag_upstream_failed: bool
     :param ignore_all_deps: Whether or not the context should ignore all ignoreable
         dependencies. Overrides the other ignore_* parameters
-    :type ignore_all_deps: boolean
+    :type ignore_all_deps: bool
     :param ignore_depends_on_past: Ignore depends_on_past parameter of DAGs (e.g. for
         Backfills)
-    :type ignore_depends_on_past: boolean
+    :type ignore_depends_on_past: bool
     :param ignore_in_retry_period: Ignore the retry period for task instances
-    :type ignore_in_retry_period: boolean
+    :type ignore_in_retry_period: bool
     :param ignore_in_reschedule_period: Ignore the reschedule period for task instances
-    :type ignore_in_reschedule_period: boolean
+    :type ignore_in_reschedule_period: bool
     :param ignore_task_deps: Ignore task-specific dependencies such as depends_on_past and
         trigger rule
-    :type ignore_task_deps: boolean
+    :type ignore_task_deps: bool
     :param ignore_ti_state: Ignore the task instance's previous failure/success
-    :type ignore_ti_state: boolean
+    :type ignore_ti_state: bool
     """
     def __init__(
             self,
diff --git a/airflow/ti_deps/deps/trigger_rule_dep.py b/airflow/ti_deps/deps/trigger_rule_dep.py
index 3bdd0ad34c248..f1d58d005791d 100644
--- a/airflow/ti_deps/deps/trigger_rule_dep.py
+++ b/airflow/ti_deps/deps/trigger_rule_dep.py
@@ -105,20 +105,20 @@ def _evaluate_trigger_rule(
         :param ti: the task instance to evaluate the trigger rule of
         :type ti: TaskInstance
         :param successes: Number of successful upstream tasks
-        :type successes: boolean
+        :type successes: bool
         :param skipped: Number of skipped upstream tasks
-        :type skipped: boolean
+        :type skipped: bool
         :param failed: Number of failed upstream tasks
-        :type failed: boolean
+        :type failed: bool
         :param upstream_failed: Number of upstream_failed upstream tasks
-        :type upstream_failed: boolean
+        :type upstream_failed: bool
         :param done: Number of completed upstream tasks
-        :type done: boolean
+        :type done: bool
         :param flag_upstream_failed: This is a hack to generate
             the upstream_failed state creation while checking to see
             whether the task instance is runnable. It was the shortest
             path to add the feature
-        :type flag_upstream_failed: boolean
+        :type flag_upstream_failed: bool
         :param session: database session
         :type session: Session
         """
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index c8afff3f52b06..36648825ef639 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -322,10 +322,10 @@ def __init__(self, parent_module, module_attributes):
         """
         :param parent_module: The string package name of the parent module. For
             example, 'airflow.operators'
-        :type parent_module: string
+        :type parent_module: str
         :param module_attributes: The file to class mappings for all importable
             classes.
-        :type module_attributes: string
+        :type module_attributes: str
         """
         self._parent_module = parent_module
         self._attribute_modules = self._build_attribute_modules(module_attributes)
diff --git a/airflow/utils/log/gcs_task_handler.py b/airflow/utils/log/gcs_task_handler.py
index e768882ac5df3..a9502ef8db64f 100644
--- a/airflow/utils/log/gcs_task_handler.py
+++ b/airflow/utils/log/gcs_task_handler.py
@@ -126,7 +126,7 @@ def gcs_read(self, remote_log_location):
         """
         Returns the log found at the remote_log_location.
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         """
         bkt, blob = self.parse_gcs_url(remote_log_location)
         return self.hook.download(bkt, blob).decode()
@@ -136,9 +136,9 @@ def gcs_write(self, log, remote_log_location, append=True):
         Writes the log to the remote_log_location. Fails silently if no hook
         was created.
         :param log: the log to write to the remote_log_location
-        :type log: string
+        :type log: str
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         :param append: if False, any existing log file is overwritten. If True,
             the new log is appended to any existing logs.
         :type append: bool
diff --git a/airflow/utils/log/s3_task_handler.py b/airflow/utils/log/s3_task_handler.py
index bdbf94b6bbbbd..196aec50f1bd4 100644
--- a/airflow/utils/log/s3_task_handler.py
+++ b/airflow/utils/log/s3_task_handler.py
@@ -132,7 +132,7 @@ def s3_read(self, remote_log_location, return_error=False):
         Returns the log found at the remote_log_location. Returns '' if no
         logs are found or there is an error.
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         :param return_error: if True, returns a string error message if an
             error occurs. Otherwise returns '' when an error occurs.
         :type return_error: bool
@@ -151,9 +151,9 @@ def s3_write(self, log, remote_log_location, append=True):
         Writes the log to the remote_log_location. Fails silently if no hook
         was created.
         :param log: the log to write to the remote_log_location
-        :type log: string
+        :type log: str
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         :param append: if False, any existing log file is overwritten. If True,
             the new log is appended to any existing logs.
         :type append: bool
diff --git a/airflow/utils/log/wasb_task_handler.py b/airflow/utils/log/wasb_task_handler.py
index a2a0c0daee999..b7f726d41db52 100644
--- a/airflow/utils/log/wasb_task_handler.py
+++ b/airflow/utils/log/wasb_task_handler.py
@@ -140,7 +140,7 @@ def wasb_read(self, remote_log_location, return_error=False):
         Returns the log found at the remote_log_location. Returns '' if no
         logs are found or there is an error.
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         :param return_error: if True, returns a string error message if an
             error occurs. Otherwise returns '' when an error occurs.
         :type return_error: bool
@@ -159,9 +159,9 @@ def wasb_write(self, log, remote_log_location, append=True):
         Writes the log to the remote_log_location. Fails silently if no hook
         was created.
         :param log: the log to write to the remote_log_location
-        :type log: string
+        :type log: str
         :param remote_log_location: the log's location in remote storage
-        :type remote_log_location: string (path)
+        :type remote_log_location: str (path)
         :param append: if False, any existing log file is overwritten. If True,
             the new log is appended to any existing logs.
         :type append: bool
diff --git a/airflow/utils/operator_resources.py b/airflow/utils/operator_resources.py
index 649961340eb42..44df83eafb508 100644
--- a/airflow/utils/operator_resources.py
+++ b/airflow/utils/operator_resources.py
@@ -33,10 +33,10 @@ class Resource(object):
     Represents a resource requirement in an execution environment for an operator.
 
     :param name: Name of the resource
-    :type name: string
+    :type name: str
     :param units_str: The string representing the units of a resource (e.g. MB for a CPU
         resource) to be used for display purposes
-    :type units_str: string
+    :type units_str: str
     :param qty: The number of units of the specified resource that are required for
         execution of the operator.
     :type qty: long

From 3db5f63dd1380ac8a0d14ea01909fd037208aa38 Mon Sep 17 00:00:00 2001
From: Jeff Payne <jeffkpayne@gmail.com>
Date: Sat, 15 Sep 2018 09:37:28 -0700
Subject: [PATCH 533/808] [AIRFLOW-3044] Dataflow operators accept templated
 job_name param (#3887)

* Default value of new job_name param is templated task_id, to match the
existing behavior as much as possible.
* Change expected value in test_mlengine_operator_utils.py to match
default for new job_name param.
---
 airflow/contrib/hooks/gcp_dataflow_hook.py    | 42 ++++++++----------
 .../contrib/operators/dataflow_operator.py    | 36 +++++++++++-----
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 43 ++++++++++---------
 .../operators/test_dataflow_operator.py       | 15 +++++--
 .../operators/test_mlengine_operator_utils.py |  2 +-
 5 files changed, 78 insertions(+), 60 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 008e90787b51e..f6086730d5df0 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -190,11 +190,9 @@ def get_conn(self):
         return build(
             'dataflow', 'v1b3', http=http_authorized, cache_discovery=False)
 
-    def _start_dataflow(self, task_id, variables, name,
-                        command_prefix, label_formatter):
+    def _start_dataflow(self, variables, name, command_prefix, label_formatter):
         variables = self._set_variables(variables)
-        cmd = command_prefix + self._build_cmd(task_id, variables,
-                                               label_formatter)
+        cmd = command_prefix + self._build_cmd(variables, label_formatter)
         job_id = _Dataflow(cmd).wait_for_done()
         _DataflowJob(self.get_conn(), variables['project'], name,
                      variables['region'],
@@ -208,9 +206,9 @@ def _set_variables(variables):
             variables['region'] = DEFAULT_DATAFLOW_LOCATION
         return variables
 
-    def start_java_dataflow(self, task_id, variables, dataflow, job_class=None,
+    def start_java_dataflow(self, job_name, variables, dataflow, job_class=None,
                             append_job_name=True):
-        name = self._build_dataflow_job_name(task_id, append_job_name)
+        name = self._build_dataflow_job_name(job_name, append_job_name)
         variables['jobName'] = name
 
         def label_formatter(labels_dict):
@@ -218,48 +216,44 @@ def label_formatter(labels_dict):
                 json.dumps(labels_dict).replace(' ', ''))]
         command_prefix = (["java", "-cp", dataflow, job_class] if job_class
                           else ["java", "-jar", dataflow])
-        self._start_dataflow(task_id, variables, name,
-                             command_prefix, label_formatter)
+        self._start_dataflow(variables, name, command_prefix, label_formatter)
 
-    def start_template_dataflow(self, task_id, variables, parameters, dataflow_template,
+    def start_template_dataflow(self, job_name, variables, parameters, dataflow_template,
                                 append_job_name=True):
-        name = self._build_dataflow_job_name(task_id, append_job_name)
+        name = self._build_dataflow_job_name(job_name, append_job_name)
         self._start_template_dataflow(
             name, variables, parameters, dataflow_template)
 
-    def start_python_dataflow(self, task_id, variables, dataflow, py_options,
+    def start_python_dataflow(self, job_name, variables, dataflow, py_options,
                               append_job_name=True):
-        name = self._build_dataflow_job_name(task_id, append_job_name)
+        name = self._build_dataflow_job_name(job_name, append_job_name)
         variables['job_name'] = name
 
         def label_formatter(labels_dict):
             return ['--labels={}={}'.format(key, value)
                     for key, value in labels_dict.items()]
-        # TODO: Change python2 to python when Beam supports both python 2 and 3
-        # Remember to change the test case too
-        self._start_dataflow(task_id, variables, name,
-                             ["python2"] + py_options + [dataflow],
+        self._start_dataflow(variables, name, ["python2"] + py_options + [dataflow],
                              label_formatter)
 
     @staticmethod
-    def _build_dataflow_job_name(task_id, append_job_name=True):
-        task_id = str(task_id).replace('_', '-')
+    def _build_dataflow_job_name(job_name, append_job_name=True):
+        base_job_name = str(job_name).replace('_', '-')
 
-        if not re.match(r"^[a-z]([-a-z0-9]*[a-z0-9])?$", task_id):
+        if not re.match(r"^[a-z]([-a-z0-9]*[a-z0-9])?$", base_job_name):
             raise ValueError(
                 'Invalid job_name ({}); the name must consist of'
                 'only the characters [-a-z0-9], starting with a '
-                'letter and ending with a letter or number '.format(task_id))
+                'letter and ending with a letter or number '.format(base_job_name))
 
         if append_job_name:
-            job_name = task_id + "-" + str(uuid.uuid4())[:8]
+            safe_job_name = base_job_name + "-" + str(uuid.uuid4())[:8]
         else:
-            job_name = task_id
+            safe_job_name = base_job_name
 
-        return job_name
+        return safe_job_name
 
     @staticmethod
-    def _build_cmd(task_id, variables, label_formatter):
+    def _build_cmd(variables, label_formatter):
         command = ["--runner=DataflowRunner"]
         if variables is not None:
             for attr, value in variables.items():
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 429d63bb885dd..77c0063d60b69 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -37,8 +37,12 @@ class DataFlowJavaOperator(BaseOperator):
         For more detail on job submission have a look at the reference:
         https://cloud.google.com/dataflow/pipelines/specifying-exec-params
 
-    :param jar: The reference to a self executing DataFlow jar.
+    :param jar: The reference to a self executing DataFlow jar (templated).
     :type jar: str
+    :param job_name: The 'jobName' to use when executing the DataFlow job
+        (templated). This ends up being set in the pipeline options, so any entry
+        with key ``'jobName'`` in ``options`` will be overwritten.
+    :type job_name: str
     :param dataflow_default_options: Map of default job options.
     :type dataflow_default_options: dict
     :param options: Map of job specific options.
@@ -58,7 +62,7 @@ class DataFlowJavaOperator(BaseOperator):
         is often not the main class configured in the dataflow jar file.
     :type job_class: str
 
-    Both ``jar`` and ``options`` are templated so you can use variables in them.
+    ``jar``, ``options``, and ``job_name`` are templated so you can use variables in them.
 
     Note that both
     ``dataflow_default_options`` and ``options`` will be merged to specify pipeline
@@ -100,13 +104,14 @@ class DataFlowJavaOperator(BaseOperator):
            dag=my-dag)
 
     """
-    template_fields = ['options', 'jar']
+    template_fields = ['options', 'jar', 'job_name']
     ui_color = '#0273d4'
 
     @apply_defaults
     def __init__(
             self,
             jar,
+            job_name='{{task.task_id}}',
             dataflow_default_options=None,
             options=None,
             gcp_conn_id='google_cloud_default',
@@ -124,6 +129,7 @@ def __init__(
         self.gcp_conn_id = gcp_conn_id
         self.delegate_to = delegate_to
         self.jar = jar
+        self.job_name = job_name
         self.dataflow_default_options = dataflow_default_options
         self.options = options
         self.poll_sleep = poll_sleep
@@ -140,7 +146,7 @@ def execute(self, context):
         dataflow_options = copy.copy(self.dataflow_default_options)
         dataflow_options.update(self.options)
 
-        hook.start_java_dataflow(self.task_id, dataflow_options,
+        hook.start_java_dataflow(self.job_name, dataflow_options,
                                  self.jar, self.job_class)
 
 
@@ -151,6 +157,8 @@ class DataflowTemplateOperator(BaseOperator):
 
     :param template: The reference to the DataFlow template.
     :type template: str
+    :param job_name: The 'jobName' to use when executing the DataFlow template
+        (templated).
     :param dataflow_default_options: Map of default job environment options.
     :type dataflow_default_options: dict
     :param parameters: Map of job specific parameters for the template.
@@ -201,8 +209,8 @@ class DataflowTemplateOperator(BaseOperator):
            gcp_conn_id='gcp-airflow-service-account',
            dag=my-dag)
 
-    ``template``, ``dataflow_default_options`` and ``parameters`` are templated so you can
-    use variables in them.
+    ``template``, ``dataflow_default_options``, ``parameters``, and ``job_name`` are
+    templated so you can use variables in them.
 
     Note that ``dataflow_default_options`` is expected to save high-level options
     for project information, which apply to all dataflow operators in the DAG.
@@ -214,13 +222,14 @@ class DataflowTemplateOperator(BaseOperator):
             For more detail on job template execution have a look at the reference:
             https://cloud.google.com/dataflow/docs/templates/executing-templates
     """
-    template_fields = ['parameters', 'dataflow_default_options', 'template']
+    template_fields = ['parameters', 'dataflow_default_options', 'template', 'job_name']
     ui_color = '#0273d4'
 
     @apply_defaults
     def __init__(
             self,
             template,
+            job_name='{{task.task_id}}',
             dataflow_default_options=None,
             parameters=None,
             gcp_conn_id='google_cloud_default',
@@ -238,6 +247,7 @@ def __init__(
         self.dataflow_default_options = dataflow_default_options
         self.poll_sleep = poll_sleep
         self.template = template
+        self.job_name = job_name
         self.parameters = parameters
 
     def execute(self, context):
@@ -245,7 +255,7 @@ def execute(self, context):
                             delegate_to=self.delegate_to,
                             poll_sleep=self.poll_sleep)
 
-        hook.start_template_dataflow(self.task_id, self.dataflow_default_options,
+        hook.start_template_dataflow(self.job_name, self.dataflow_default_options,
                                      self.parameters, self.template)
 
 
@@ -264,6 +274,10 @@ class DataFlowPythonOperator(BaseOperator):
     :param py_file: Reference to the python dataflow pipleline file.py, e.g.,
         /some/local/file/path/to/your/python/pipeline/file.
     :type py_file: str
+    :param job_name: The 'job_name' to use when executing the DataFlow job
+        (templated). This ends up being set in the pipeline options, so any entry
+        with key ``'jobName'`` or ``'job_name'`` in ``options`` will be overwritten.
+    :type job_name: str
     :param py_options: Additional python options.
     :type pyt_options: list of strings, e.g., ["-m", "-v"].
     :param dataflow_default_options: Map of default job options.
@@ -282,12 +296,13 @@ class DataFlowPythonOperator(BaseOperator):
         JOB_STATE_RUNNING state.
     :type poll_sleep: int
     """
-    template_fields = ['options', 'dataflow_default_options']
+    template_fields = ['options', 'dataflow_default_options', 'job_name']
 
     @apply_defaults
     def __init__(
             self,
             py_file,
+            job_name='{{task.task_id}}',
             py_options=None,
             dataflow_default_options=None,
             options=None,
@@ -300,6 +315,7 @@ def __init__(
         super(DataFlowPythonOperator, self).__init__(*args, **kwargs)
 
         self.py_file = py_file
+        self.job_name = job_name
         self.py_options = py_options or []
         self.dataflow_default_options = dataflow_default_options or {}
         self.options = options or {}
@@ -325,7 +341,7 @@ def execute(self, context):
         formatted_options = {camel_to_snake(key): dataflow_options[key]
                              for key in dataflow_options}
         hook.start_python_dataflow(
-            self.task_id, formatted_options,
+            self.job_name, formatted_options,
             self.py_file, self.py_options)
 
 
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index a22f66335cecd..653993a7de7c1 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -34,6 +34,7 @@
 
 
 TASK_ID = 'test-dataflow-operator'
+JOB_NAME = 'test-dataflow-pipeline'
 TEMPLATE = 'gs://dataflow-templates/wordcount/template_file'
 PARAMETERS = {
     'inputFile': 'gs://dataflow-samples/shakespeare/kinglear.txt',
@@ -91,14 +92,14 @@ def test_start_python_dataflow(self, mock_conn,
         dataflowjob_instance = mock_dataflowjob.return_value
         dataflowjob_instance.wait_for_done.return_value = None
         self.dataflow_hook.start_python_dataflow(
-            task_id=TASK_ID, variables=DATAFLOW_OPTIONS_PY,
+            job_name=JOB_NAME, variables=DATAFLOW_OPTIONS_PY,
             dataflow=PY_FILE, py_options=PY_OPTIONS)
         EXPECTED_CMD = ['python2', '-m', PY_FILE,
                         '--region=us-central1',
                         '--runner=DataflowRunner', '--project=test',
                         '--labels=foo=bar',
                         '--staging_location=gs://test/staging',
-                        '--job_name={}-{}'.format(TASK_ID, MOCK_UUID)]
+                        '--job_name={}-{}'.format(JOB_NAME, MOCK_UUID)]
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
@@ -115,14 +116,14 @@ def test_start_java_dataflow(self, mock_conn,
         dataflowjob_instance = mock_dataflowjob.return_value
         dataflowjob_instance.wait_for_done.return_value = None
         self.dataflow_hook.start_java_dataflow(
-            task_id=TASK_ID, variables=DATAFLOW_OPTIONS_JAVA,
+            job_name=JOB_NAME, variables=DATAFLOW_OPTIONS_JAVA,
             dataflow=JAR_FILE)
         EXPECTED_CMD = ['java', '-jar', JAR_FILE,
                         '--region=us-central1',
                         '--runner=DataflowRunner', '--project=test',
                         '--stagingLocation=gs://test/staging',
                         '--labels={"foo":"bar"}',
-                        '--jobName={}-{}'.format(TASK_ID, MOCK_UUID)]
+                        '--jobName={}-{}'.format(JOB_NAME, MOCK_UUID)]
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
@@ -139,14 +140,14 @@ def test_start_java_dataflow_with_job_class(
         dataflowjob_instance = mock_dataflowjob.return_value
         dataflowjob_instance.wait_for_done.return_value = None
         self.dataflow_hook.start_java_dataflow(
-            task_id=TASK_ID, variables=DATAFLOW_OPTIONS_JAVA,
+            job_name=JOB_NAME, variables=DATAFLOW_OPTIONS_JAVA,
             dataflow=JAR_FILE, job_class=JOB_CLASS)
         EXPECTED_CMD = ['java', '-cp', JAR_FILE, JOB_CLASS,
                         '--region=us-central1',
                         '--runner=DataflowRunner', '--project=test',
                         '--stagingLocation=gs://test/staging',
                         '--labels={"foo":"bar"}',
-                        '--jobName={}-{}'.format(TASK_ID, MOCK_UUID)]
+                        '--jobName={}-{}'.format(JOB_NAME, MOCK_UUID)]
         self.assertListEqual(sorted(mock_dataflow.call_args[0][0]),
                              sorted(EXPECTED_CMD))
 
@@ -176,18 +177,18 @@ def poll_resp_error():
 
     def test_valid_dataflow_job_name(self):
         job_name = self.dataflow_hook._build_dataflow_job_name(
-            task_id=TASK_ID, append_job_name=False
+            job_name=JOB_NAME, append_job_name=False
         )
 
-        self.assertEquals(job_name, TASK_ID)
+        self.assertEquals(job_name, JOB_NAME)
 
-    def test_fix_underscore_in_task_id(self):
-        task_id_with_underscore = 'test_example'
-        fixed_job_name = task_id_with_underscore.replace(
+    def test_fix_underscore_in_job_name(self):
+        job_name_with_underscore = 'test_example'
+        fixed_job_name = job_name_with_underscore.replace(
             '_', '-'
         )
         job_name = self.dataflow_hook._build_dataflow_job_name(
-            task_id=task_id_with_underscore, append_job_name=False
+            job_name=job_name_with_underscore, append_job_name=False
         )
 
         self.assertEquals(job_name, fixed_job_name)
@@ -199,7 +200,7 @@ def test_invalid_dataflow_job_name(self):
 
         with self.assertRaises(ValueError) as e:
             self.dataflow_hook._build_dataflow_job_name(
-                task_id=invalid_job_name, append_job_name=False
+                job_name=invalid_job_name, append_job_name=False
             )
         #   Test whether the job_name is present in the Error msg
         self.assertIn('Invalid job_name ({})'.format(fixed_name),
@@ -208,37 +209,37 @@ def test_invalid_dataflow_job_name(self):
     def test_dataflow_job_regex_check(self):
 
         self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
-            task_id='df-job-1', append_job_name=False
+            job_name='df-job-1', append_job_name=False
         ), 'df-job-1')
 
         self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
-            task_id='df-job', append_job_name=False
+            job_name='df-job', append_job_name=False
         ), 'df-job')
 
         self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
-            task_id='dfjob', append_job_name=False
+            job_name='dfjob', append_job_name=False
         ), 'dfjob')
 
         self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
-            task_id='dfjob1', append_job_name=False
+            job_name='dfjob1', append_job_name=False
         ), 'dfjob1')
 
         self.assertRaises(
             ValueError,
             self.dataflow_hook._build_dataflow_job_name,
-            task_id='1dfjob', append_job_name=False
+            job_name='1dfjob', append_job_name=False
         )
 
         self.assertRaises(
             ValueError,
             self.dataflow_hook._build_dataflow_job_name,
-            task_id='dfjob@', append_job_name=False
+            job_name='dfjob@', append_job_name=False
         )
 
         self.assertRaises(
             ValueError,
             self.dataflow_hook._build_dataflow_job_name,
-            task_id='df^jo', append_job_name=False
+            job_name='df^jo', append_job_name=False
         )
 
 
@@ -252,7 +253,7 @@ def setUp(self):
     @mock.patch(DATAFLOW_STRING.format('DataFlowHook._start_template_dataflow'))
     def test_start_template_dataflow(self, internal_dataflow_mock):
         self.dataflow_hook.start_template_dataflow(
-            task_id=TASK_ID, variables=DATAFLOW_OPTIONS_TEMPLATE, parameters=PARAMETERS,
+            job_name=JOB_NAME, variables=DATAFLOW_OPTIONS_TEMPLATE, parameters=PARAMETERS,
             dataflow_template=TEMPLATE)
         internal_dataflow_mock.assert_called_once_with(
             mock.ANY, DATAFLOW_OPTIONS_TEMPLATE, PARAMETERS, TEMPLATE)
diff --git a/tests/contrib/operators/test_dataflow_operator.py b/tests/contrib/operators/test_dataflow_operator.py
index 8ed4583255733..b951503eb5bf7 100644
--- a/tests/contrib/operators/test_dataflow_operator.py
+++ b/tests/contrib/operators/test_dataflow_operator.py
@@ -36,6 +36,7 @@
 
 
 TASK_ID = 'test-dataflow-operator'
+JOB_NAME = 'test-dataflow-pipeline'
 TEMPLATE = 'gs://dataflow-templates/wordcount/template_file'
 PARAMETERS = {
     'inputFile': 'gs://dataflow-samples/shakespeare/kinglear.txt',
@@ -74,6 +75,7 @@ def setUp(self):
         self.dataflow = DataFlowPythonOperator(
             task_id=TASK_ID,
             py_file=PY_FILE,
+            job_name=JOB_NAME,
             py_options=PY_OPTIONS,
             dataflow_default_options=DEFAULT_OPTIONS_PYTHON,
             options=ADDITIONAL_OPTIONS,
@@ -82,6 +84,7 @@ def setUp(self):
     def test_init(self):
         """Test DataFlowPythonOperator instance is properly initialized."""
         self.assertEqual(self.dataflow.task_id, TASK_ID)
+        self.assertEqual(self.dataflow.job_name, JOB_NAME)
         self.assertEqual(self.dataflow.py_file, PY_FILE)
         self.assertEqual(self.dataflow.py_options, PY_OPTIONS)
         self.assertEqual(self.dataflow.poll_sleep, POLL_SLEEP)
@@ -108,8 +111,8 @@ def test_exec(self, gcs_hook, dataflow_mock):
             'labels': {'foo': 'bar', 'airflow-version': TEST_VERSION}
         }
         gcs_download_hook.assert_called_once_with(PY_FILE)
-        start_python_hook.assert_called_once_with(TASK_ID, expected_options,
-                                                  mock.ANY, PY_OPTIONS)
+        start_python_hook.assert_called_once_with(JOB_NAME, expected_options, mock.ANY,
+                                                  PY_OPTIONS)
         self.assertTrue(self.dataflow.py_file.startswith('/tmp/dataflow'))
 
 
@@ -119,6 +122,7 @@ def setUp(self):
         self.dataflow = DataFlowJavaOperator(
             task_id=TASK_ID,
             jar=JAR_FILE,
+            job_name=JOB_NAME,
             job_class=JOB_CLASS,
             dataflow_default_options=DEFAULT_OPTIONS_JAVA,
             options=ADDITIONAL_OPTIONS,
@@ -127,6 +131,7 @@ def setUp(self):
     def test_init(self):
         """Test DataflowTemplateOperator instance is properly initialized."""
         self.assertEqual(self.dataflow.task_id, TASK_ID)
+        self.assertEqual(self.dataflow.job_name, JOB_NAME)
         self.assertEqual(self.dataflow.poll_sleep, POLL_SLEEP)
         self.assertEqual(self.dataflow.dataflow_default_options,
                          DEFAULT_OPTIONS_JAVA)
@@ -147,7 +152,7 @@ def test_exec(self, gcs_hook, dataflow_mock):
         self.dataflow.execute(None)
         self.assertTrue(dataflow_mock.called)
         gcs_download_hook.assert_called_once_with(JAR_FILE)
-        start_java_hook.assert_called_once_with(TASK_ID, mock.ANY,
+        start_java_hook.assert_called_once_with(JOB_NAME, mock.ANY,
                                                 mock.ANY, JOB_CLASS)
 
 
@@ -157,6 +162,7 @@ def setUp(self):
         self.dataflow = DataflowTemplateOperator(
             task_id=TASK_ID,
             template=TEMPLATE,
+            job_name=JOB_NAME,
             parameters=PARAMETERS,
             dataflow_default_options=DEFAULT_OPTIONS_TEMPLATE,
             poll_sleep=POLL_SLEEP)
@@ -164,6 +170,7 @@ def setUp(self):
     def test_init(self):
         """Test DataflowTemplateOperator instance is properly initialized."""
         self.assertEqual(self.dataflow.task_id, TASK_ID)
+        self.assertEqual(self.dataflow.job_name, JOB_NAME)
         self.assertEqual(self.dataflow.template, TEMPLATE)
         self.assertEqual(self.dataflow.parameters, PARAMETERS)
         self.assertEqual(self.dataflow.poll_sleep, POLL_SLEEP)
@@ -185,7 +192,7 @@ def test_exec(self, dataflow_mock):
             'tempLocation': 'gs://test/temp',
             'zone': 'us-central1-f'
         }
-        start_template_hook.assert_called_once_with(TASK_ID, expected_options,
+        start_template_hook.assert_called_once_with(JOB_NAME, expected_options,
                                                     PARAMETERS, TEMPLATE)
 
 
diff --git a/tests/contrib/operators/test_mlengine_operator_utils.py b/tests/contrib/operators/test_mlengine_operator_utils.py
index 554a6b9e4f7df..a0722650417d2 100644
--- a/tests/contrib/operators/test_mlengine_operator_utils.py
+++ b/tests/contrib/operators/test_mlengine_operator_utils.py
@@ -111,7 +111,7 @@ def testSuccessfulRun(self):
             mock_dataflow_hook.assert_called_with(
                 gcp_conn_id='google_cloud_default', delegate_to=None, poll_sleep=10)
             hook_instance.start_python_dataflow.assert_called_once_with(
-                'eval-test-summary',
+                '{{task.task_id}}',
                 {
                     'prediction_path': 'gs://legal-bucket/fake-output-path',
                     'labels': {'airflow-version': TEST_VERSION},

From 68401611d59f1d0ed787f8609abcc773af157447 Mon Sep 17 00:00:00 2001
From: fenglu-g <fenglu@google.com>
Date: Mon, 21 Jan 2019 12:18:16 -0800
Subject: [PATCH 534/808] [AIRFLOW-2009] Fix dataflow hook connection-id
 (#4563)

---
 airflow/contrib/hooks/gcp_api_base_hook.py    | 34 ++++++++++++++
 airflow/contrib/hooks/gcp_dataflow_hook.py    |  1 +
 tests/contrib/hooks/test_gcp_api_base_hook.py | 44 +++++++++++++++++++
 .../operators/test_gcp_container_operator.py  |  2 +
 4 files changed, 81 insertions(+)

diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index a8a80813e7503..58e79c87db3f7 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -24,6 +24,8 @@
 import google.auth
 import google_auth_httplib2
 import google.oauth2.service_account
+import os
+import tempfile
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
@@ -31,6 +33,10 @@
 
 
 _DEFAULT_SCOPES = ('https://www.googleapis.com/auth/cloud-platform',)
+# The name of the environment variable that Google Authentication library uses
+# to get service account key location. Read more:
+# https://cloud.google.com/docs/authentication/getting-started#setting_the_environment_variable
+_G_APP_CRED_ENV_VAR = "GOOGLE_APPLICATION_CREDENTIALS"
 
 
 class GoogleCloudBaseHook(BaseHook, LoggingMixin):
@@ -193,3 +199,31 @@ def _get_project_id(self, project_id):
         :return: the project_id specified or default project id if project_id is None
         """
         return project_id if project_id else self.project_id
+
+    class _Decorators(object):
+        """A private inner class for keeping all decorator methods."""
+
+        @staticmethod
+        def provide_gcp_credential_file(func):
+            """
+            Function decorator that provides a GOOGLE_APPLICATION_CREDENTIALS
+            environment variable, pointing to file path of a JSON file of service
+            account key.
+            """
+            @functools.wraps(func)
+            def wrapper(self, *args, **kwargs):
+                with tempfile.NamedTemporaryFile(mode='w+t') as conf_file:
+                    key_path = self._get_field('key_path', False)
+                    keyfile_dict = self._get_field('keyfile_dict', False)
+                    if key_path:
+                        if key_path.endswith('.p12'):
+                            raise AirflowException(
+                                'Legacy P12 key file are not supported, '
+                                'use a JSON key file.')
+                        os.environ[_G_APP_CRED_ENV_VAR] = key_path
+                    elif keyfile_dict:
+                        conf_file.write(keyfile_dict)
+                        conf_file.flush()
+                        os.environ[_G_APP_CRED_ENV_VAR] = conf_file.name
+                    return func(self, *args, **kwargs)
+            return wrapper
diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index f6086730d5df0..c7a51e092db11 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -190,6 +190,7 @@ def get_conn(self):
         return build(
             'dataflow', 'v1b3', http=http_authorized, cache_discovery=False)
 
+    @GoogleCloudBaseHook._Decorators.provide_gcp_credential_file
     def _start_dataflow(self, variables, name, command_prefix, label_formatter):
         variables = self._set_variables(variables)
         cmd = command_prefix + self._build_cmd(variables, label_formatter)
diff --git a/tests/contrib/hooks/test_gcp_api_base_hook.py b/tests/contrib/hooks/test_gcp_api_base_hook.py
index f4509d9111ff6..116f684da9edc 100644
--- a/tests/contrib/hooks/test_gcp_api_base_hook.py
+++ b/tests/contrib/hooks/test_gcp_api_base_hook.py
@@ -18,12 +18,24 @@
 # under the License.
 #
 
+import os
 import unittest
 
 from airflow.contrib.hooks import gcp_api_base_hook as hook
 
 import google.auth
 from google.auth.exceptions import GoogleAuthError
+try:
+    from StringIO import StringIO
+except ImportError:
+    from io import StringIO
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
 
 
 default_creds_available = True
@@ -81,3 +93,35 @@ def test_default_creds_no_scopes(self):
 
         scopes = credentials.scopes
         self.assertEqual(tuple(hook._DEFAULT_SCOPES), tuple(scopes))
+
+    def test_provide_gcp_credential_file_decorator_key_path(self):
+        key_path = '/test/key-path'
+        self.instance.extras = {
+            'extra__google_cloud_platform__key_path': key_path
+        }
+
+        @hook.GoogleCloudBaseHook._Decorators.provide_gcp_credential_file
+        def assert_gcp_credential_file_in_env(hook_instance):
+            self.assertEqual(os.environ[hook._G_APP_CRED_ENV_VAR],
+                             key_path)
+        assert_gcp_credential_file_in_env(self.instance)
+
+    @mock.patch('tempfile.NamedTemporaryFile')
+    def test_provide_gcp_credential_file_decorator_key_content(self,
+                                                               mock_file):
+        string_file = StringIO()
+        file_content = '{"foo": "bar"}'
+        file_name = '/test/mock-file'
+        self.instance.extras = {
+            'extra__google_cloud_platform__keyfile_dict': file_content
+        }
+        mock_file_handler = mock_file.return_value.__enter__.return_value
+        mock_file_handler.name = file_name
+        mock_file_handler.write = string_file.write
+
+        @hook.GoogleCloudBaseHook._Decorators.provide_gcp_credential_file
+        def assert_gcp_credential_file_in_env(hook_instance):
+            self.assertEqual(os.environ[hook._G_APP_CRED_ENV_VAR],
+                             file_name)
+            self.assertEqual(file_content, string_file.getvalue())
+        assert_gcp_credential_file_in_env(self.instance)
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index 600c7cd8a89e4..52cb3a19dffe4 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -145,6 +145,8 @@ def setUp(self):
                                      name=TASK_NAME,
                                      namespace=NAMESPACE,
                                      image=IMAGE)
+        if GAC_ENV_VAR in os.environ:
+            del os.environ[GAC_ENV_VAR]
 
     def test_template_fields(self):
         self.assertTrue(set(KubernetesPodOperator.template_fields).issubset(

From 5f4558e2143c9bf74263f417fd77c53c2b9ca994 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Graczyk?= <graczpaw@gmail.com>
Date: Sun, 25 Nov 2018 23:01:09 +0100
Subject: [PATCH 535/808] [AIRFLOW-3250] Fix for Redis Hook for not authorised
 connection calls (#4090)

Password stay None value and not None (str) in case there is no password set through webadmin interfaces.
This is fix for connections for Redis that not expect autorisation from clients.
---
 airflow/contrib/hooks/redis_hook.py         | 66 +++++++--------------
 airflow/contrib/sensors/redis_key_sensor.py | 14 +----
 airflow/utils/db.py                         |  2 +-
 scripts/ci/docker-compose.yml               |  5 ++
 tests/contrib/hooks/test_redis_hook.py      | 41 ++++++++-----
 tests/contrib/sensors/test_redis_sensor.py  | 27 +++------
 6 files changed, 63 insertions(+), 92 deletions(-)

diff --git a/airflow/contrib/hooks/redis_hook.py b/airflow/contrib/hooks/redis_hook.py
index 650cc9308be91..a34e8807967ad 100644
--- a/airflow/contrib/hooks/redis_hook.py
+++ b/airflow/contrib/hooks/redis_hook.py
@@ -21,15 +21,13 @@
 RedisHook module
 """
 from redis import StrictRedis
-
-from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 
 class RedisHook(BaseHook, LoggingMixin):
     """
-    Hook to interact with Redis database
+    Wrapper for connection to interact with Redis in-memory data structure store
     """
     def __init__(self, redis_conn_id='redis_default'):
         """
@@ -39,55 +37,31 @@ def __init__(self, redis_conn_id='redis_default'):
                             we need to connect to Redis.
         """
         self.redis_conn_id = redis_conn_id
-        self.client = None
-        conn = self.get_connection(self.redis_conn_id)
-        self.host = conn.host
-        self.port = int(conn.port)
-        self.password = conn.password
-        self.db = int(conn.extra_dejson.get('db', 0))
-
-        self.log.debug(
-            '''Connection "{conn}":
-            \thost: {host}
-            \tport: {port}
-            \textra: {extra}
-            '''.format(
-                conn=self.redis_conn_id,
-                host=self.host,
-                port=self.port,
-                extra=conn.extra_dejson
-            )
-        )
+        self.redis = None
+        self.host = None
+        self.port = None
+        self.password = None
+        self.db = None
 
     def get_conn(self):
         """
         Returns a Redis connection.
         """
-        if not self.client:
+        conn = self.get_connection(self.redis_conn_id)
+        self.host = conn.host
+        self.port = conn.port
+        self.password = None if str(conn.password).lower() in ['none', 'false', ''] else conn.password
+        self.db = conn.extra_dejson.get('db', None)
+
+        if not self.redis:
             self.log.debug(
-                'generating Redis client for conn_id "%s" on %s:%s:%s',
+                'Initializing redis object for conn_id "%s" on %s:%s:%s',
                 self.redis_conn_id, self.host, self.port, self.db
             )
-            try:
-                self.client = StrictRedis(
-                    host=self.host,
-                    port=self.port,
-                    password=self.password,
-                    db=self.db)
-            except Exception as general_error:
-                raise AirflowException(
-                    'Failed to create Redis client, error: {error}'.format(
-                        error=str(general_error)
-                    )
-                )
-
-        return self.client
-
-    def key_exists(self, key):
-        """
-        Checks if a key exists in Redis database
+            self.redis = StrictRedis(
+                host=self.host,
+                port=self.port,
+                password=self.password,
+                db=self.db)
 
-        :param key: The key to check the existence.
-        :type key: str
-        """
-        return self.get_conn().exists(key)
+        return self.redis
diff --git a/airflow/contrib/sensors/redis_key_sensor.py b/airflow/contrib/sensors/redis_key_sensor.py
index a2d190baae2a8..4c0ac68840b50 100644
--- a/airflow/contrib/sensors/redis_key_sensor.py
+++ b/airflow/contrib/sensors/redis_key_sensor.py
@@ -23,25 +23,17 @@
 
 class RedisKeySensor(BaseSensorOperator):
     """
-    Checks for the existence of a key in a Redis database
+    Checks for the existence of a key in a Redis
     """
     template_fields = ('key',)
     ui_color = '#f0eee4'
 
     @apply_defaults
     def __init__(self, key, redis_conn_id, *args, **kwargs):
-        """
-        Create a new RedisKeySensor
-
-        :param key: The key to be monitored
-        :type key: str
-        :param redis_conn_id: The connection ID to use when connecting to Redis DB.
-        :type redis_conn_id: str
-        """
         super(RedisKeySensor, self).__init__(*args, **kwargs)
         self.redis_conn_id = redis_conn_id
         self.key = key
 
     def poke(self, context):
-        self.log.info('Sensor check existence of key: %s', self.key)
-        return RedisHook(self.redis_conn_id).key_exists(self.key)
+        self.log.info('Sensor checks for existence of key: %s', self.key)
+        return RedisHook(self.redis_conn_id).get_conn().exists(self.key)
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 92ffd373bf4ff..a89f1a88cebd7 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -207,7 +207,7 @@ def initdb(rbac=False):
     merge_conn(
         models.Connection(
             conn_id='redis_default', conn_type='redis',
-            host='localhost', port=6379,
+            host='redis', port=6379,
             extra='{"db": 0}'))
     merge_conn(
         models.Connection(
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 0f5d660c390e9..37a556b75b1e7 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -45,6 +45,10 @@ services:
     image: rabbitmq:3.7
     restart: always
 
+  redis:
+    image: redis:5.0.1
+    restart: always
+
   openldap:
     image: osixia/openldap:1.2.0
     restart: always
@@ -86,6 +90,7 @@ services:
       - mongo
       - cassandra
       - rabbitmq
+      - redis
       - openldap
       - krb5-kdc-server
     volumes:
diff --git a/tests/contrib/hooks/test_redis_hook.py b/tests/contrib/hooks/test_redis_hook.py
index 12c30680e1bfa..978b304d41f03 100644
--- a/tests/contrib/hooks/test_redis_hook.py
+++ b/tests/contrib/hooks/test_redis_hook.py
@@ -19,32 +19,43 @@
 
 
 import unittest
-from mock import patch
-
 from airflow import configuration
 from airflow.contrib.hooks.redis_hook import RedisHook
 
 
 class TestRedisHook(unittest.TestCase):
+
     def setUp(self):
         configuration.load_test_config()
 
     def test_get_conn(self):
         hook = RedisHook(redis_conn_id='redis_default')
-        self.assertEqual(hook.client, None)
-        self.assertEqual(
-            repr(hook.get_conn()),
-            (
-                'StrictRedis<ConnectionPool'
-                '<Connection<host=localhost,port=6379,db=0>>>'
-            )
-        )
-
-    @patch("airflow.contrib.hooks.redis_hook.RedisHook.get_conn")
-    def test_first_conn_instantiation(self, get_conn):
+        self.assertEqual(hook.redis, None)
+
+        self.assertEqual(hook.host, None, 'host initialised as None.')
+        self.assertEqual(hook.port, None, 'port initialised as None.')
+        self.assertEqual(hook.password, None, 'password initialised as None.')
+        self.assertEqual(hook.db, None, 'db initialised as None.')
+        self.assertIs(hook.get_conn(), hook.get_conn(), 'Connection initialized only if None.')
+
+    def test_get_conn_password_stays_none(self):
+        hook = RedisHook(redis_conn_id='redis_default')
+        hook.get_conn()
+        self.assertEqual(hook.password, None)
+
+    def test_real_ping(self):
         hook = RedisHook(redis_conn_id='redis_default')
-        hook.key_exists('test_key')
-        self.assertTrue(get_conn.called_once())
+        redis = hook.get_conn()
+
+        self.assertTrue(redis.ping(), 'Connection to Redis with PING works.')
+
+    def test_real_get_and_set(self):
+        hook = RedisHook(redis_conn_id='redis_default')
+        redis = hook.get_conn()
+
+        self.assertTrue(redis.set('test_key', 'test_value'), 'Connection to Redis with SET works.')
+        self.assertEqual(redis.get('test_key'), b'test_value', 'Connection to Redis with GET works.')
+        self.assertEqual(redis.delete('test_key'), 1, 'Connection to Redis with DELETE works.')
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/sensors/test_redis_sensor.py b/tests/contrib/sensors/test_redis_sensor.py
index 394c8e574bd4f..ec2868c6f7158 100644
--- a/tests/contrib/sensors/test_redis_sensor.py
+++ b/tests/contrib/sensors/test_redis_sensor.py
@@ -19,11 +19,9 @@
 
 
 import unittest
-
-from mock import patch
-
 from airflow import DAG
 from airflow import configuration
+from airflow.contrib.hooks.redis_hook import RedisHook
 from airflow.contrib.sensors.redis_key_sensor import RedisKeySensor
 from airflow.utils import timezone
 
@@ -47,22 +45,13 @@ def setUp(self):
             key='test_key'
         )
 
-    @patch("airflow.contrib.hooks.redis_hook.RedisHook.key_exists")
-    def test_poke(self, key_exists):
-        key_exists.return_value = True
-        self.assertTrue(self.sensor.poke(None))
-
-        key_exists.return_value = False
-        self.assertFalse(self.sensor.poke(None))
-
-    @patch("airflow.contrib.hooks.redis_hook.StrictRedis.exists")
-    def test_existing_key_called(self, redis_client_exists):
-        self.sensor.run(
-            start_date=DEFAULT_DATE,
-            end_date=DEFAULT_DATE, ignore_ti_state=True
-        )
-
-        self.assertTrue(redis_client_exists.called_with('test_key'))
+    def test_poke(self):
+        hook = RedisHook(redis_conn_id='redis_default')
+        redis = hook.get_conn()
+        redis.set('test_key', 'test_value')
+        self.assertTrue(self.sensor.poke(None), "Key exists on first call.")
+        redis.delete('test_key')
+        self.assertFalse(self.sensor.poke(None), "Key does NOT exists on second call.")
 
 
 if __name__ == '__main__':

From 015a0e107f605d396b7dacc0b022a3ecb9381b16 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 4 Mar 2019 18:04:14 +0000
Subject: [PATCH 536/808] [AIRFLOW-3353] Upgrade Redis client (#4834)

Now that Celery/Kombu have updated and work with RedisPy 3.x (they in
fact force us to use 3.2) we should re-introduce this change.
---
 UPDATING.md                         | 10 +++++++++-
 airflow/contrib/hooks/redis_hook.py |  4 ++--
 setup.py                            |  2 +-
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 7b6b17bc0d4a0..f57e311b6d438 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -24,7 +24,15 @@ assists users migrating to a new version.
 
 ## Airflow 1.10.3
 
-#### SLUGIFY_USES_TEXT_UNIDECODE or AIRFLOW_GPL_UNIDECODE no longer required
+### RedisPy dependency updated to v3 series
+
+If you are using the Redis Sensor or Hook you may have to update your code. See
+[redis-py porting instructions] to check if your code might be affected (MSET,
+MSETNX, ZADD, and ZINCRBY all were, but read the full doc).
+
+[redis-py porting instructions]: https://github.com/andymccurdy/redis-py/tree/3.2.0#upgrading-from-redis-py-2x-to-30
+
+### SLUGIFY_USES_TEXT_UNIDECODE or AIRFLOW_GPL_UNIDECODE no longer required
 
 It is no longer required to set one of the environment variables to avoid
 a GPL dependency. Airflow will now always use text-unidecode if unidecode
diff --git a/airflow/contrib/hooks/redis_hook.py b/airflow/contrib/hooks/redis_hook.py
index a34e8807967ad..8108c63687b80 100644
--- a/airflow/contrib/hooks/redis_hook.py
+++ b/airflow/contrib/hooks/redis_hook.py
@@ -20,7 +20,7 @@
 """
 RedisHook module
 """
-from redis import StrictRedis
+from redis import Redis
 from airflow.hooks.base_hook import BaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -58,7 +58,7 @@ def get_conn(self):
                 'Initializing redis object for conn_id "%s" on %s:%s:%s',
                 self.redis_conn_id, self.host, self.port, self.db
             )
-            self.redis = StrictRedis(
+            self.redis = Redis(
                 host=self.host,
                 port=self.port,
                 password=self.password,
diff --git a/setup.py b/setup.py
index 128f00e3988c2..7a53a3f350ded 100644
--- a/setup.py
+++ b/setup.py
@@ -210,7 +210,7 @@ def write_version(filename=os.path.join(*['airflow',
 postgres = ['psycopg2>=2.7.4']
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']
-redis = ['redis>=2.10.5,<3.0.0']
+redis = ['redis~=3.2']
 s3 = ['boto3>=1.7.0, <1.8.0']
 salesforce = ['simple-salesforce>=0.72']
 samba = ['pysmbclient>=0.1.3']

From 2da10c50814460e67624ca6197c677362d45c49e Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 14 Jan 2019 20:50:57 +0800
Subject: [PATCH 537/808] [AIRFLOW-3569] Add "Trigger DAG" button in DAG page
 (/www_rbac only) (#4373)

To have the Manual Trigger DAG button in the DAG page as well,
rather than only in the home page.
---
 airflow/www_rbac/templates/airflow/dag.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 78c3f251694ce..404adeed7677f 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -94,6 +94,13 @@ <h4 class="pull-right">
           Code
         </a>
       </li>
+      <li>
+        <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin="/tree?dag_id="+dag.dag_id) }}"
+          onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+          <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
+          Trigger DAG
+        </a>
+      </li>
       <li>
         <a href="{{ url_for('Airflow.refresh', dag_id=dag.dag_id) }}" title="Refresh">
           <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
@@ -330,6 +337,10 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
+    function confirmTriggerDag(dag_id){
+        return confirm("Are you sure you want to run '"+dag_id+"' now?");
+    }
+
     function confirmDeleteDag(dag_id){
         return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\

From b012ec9bc3474e43ee3410ed69b0d3697e1ffcdc Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 5 Mar 2019 11:11:43 +0000
Subject: [PATCH 538/808] [AIRFLOW-3569] Add "Trigger DAG" button in DAG page
 (/www only) (#4373)

This is a back-ported version of the change introducted to the RBAC ui
in #4373.
---
 airflow/www/templates/airflow/dag.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 4721c6cf72880..04380f64de3ea 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -94,6 +94,13 @@ <h4 class="pull-right">
           Code
         </a>
       </li>
+      <li>
+        <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin="/tree?dag_id="+dag.dag_id) }}"
+          onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+          <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
+          Trigger DAG
+        </a>
+      </li>
       <li>
         <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}" title="Refresh">
           <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
@@ -330,6 +337,10 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
+    function confirmTriggerDag(dag_id){
+        return confirm("Are you sure you want to run '"+dag_id+"' now?");
+    }
+
     function confirmDeleteDag(dag_id){
         return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\

From b0f783b397fd9efefebdeebe22bdb5347cc3dd8c Mon Sep 17 00:00:00 2001
From: Michael Holtzscher <mholtz@protonmail.com>
Date: Mon, 14 Jan 2019 06:52:33 -0600
Subject: [PATCH 539/808] [AIRFLOW-3522] Add support for sending Slack
 attachments (#4332)

* [AIRFLOW-3522] Add support for sending Slack attachments

Add attachments args to SlackWebhookHook and
SlackWebhookOperator to support sending more
detailed Slack messages.

* [AIRFLOW-3522] Update attachments docstrings
---
 airflow/contrib/hooks/slack_webhook_hook.py       |  8 +++++++-
 .../contrib/operators/slack_webhook_operator.py   |  6 ++++++
 tests/contrib/hooks/test_slack_webhook_hook.py    | 15 +++++++++------
 .../operators/test_slack_webhook_operator.py      |  2 ++
 4 files changed, 24 insertions(+), 7 deletions(-)

diff --git a/airflow/contrib/hooks/slack_webhook_hook.py b/airflow/contrib/hooks/slack_webhook_hook.py
index 670d40105e669..ab7d7827702ab 100644
--- a/airflow/contrib/hooks/slack_webhook_hook.py
+++ b/airflow/contrib/hooks/slack_webhook_hook.py
@@ -38,6 +38,9 @@ class SlackWebhookHook(HttpHook):
     :type webhook_token: str
     :param message: The message you want to send on Slack
     :type message: str
+    :param attachments: The attachments to send on Slack. Should be a list of
+                        dictionaries representing Slack attachments.
+    :type attachments: list
     :param channel: The channel the message should be posted to
     :type channel: str
     :param username: The username to post to slack with
@@ -54,6 +57,7 @@ def __init__(self,
                  http_conn_id=None,
                  webhook_token=None,
                  message="",
+                 attachments=None,
                  channel=None,
                  username=None,
                  icon_emoji=None,
@@ -66,6 +70,7 @@ def __init__(self,
         self.http_conn_id = http_conn_id
         self.webhook_token = self._get_token(webhook_token, http_conn_id)
         self.message = message
+        self.attachments = attachments
         self.channel = channel
         self.username = username
         self.icon_emoji = icon_emoji
@@ -105,8 +110,9 @@ def _build_slack_message(self):
             cmd['icon_emoji'] = self.icon_emoji
         if self.link_names:
             cmd['link_names'] = 1
+        if self.attachments:
+            cmd['attachments'] = self.attachments
 
-        # there should always be a message to post ;-)
         cmd['text'] = self.message
         return json.dumps(cmd)
 
diff --git a/airflow/contrib/operators/slack_webhook_operator.py b/airflow/contrib/operators/slack_webhook_operator.py
index 64f2448a550dd..8950c69b5a38e 100644
--- a/airflow/contrib/operators/slack_webhook_operator.py
+++ b/airflow/contrib/operators/slack_webhook_operator.py
@@ -37,6 +37,9 @@ class SlackWebhookOperator(SimpleHttpOperator):
     :type webhook_token: str
     :param message: The message you want to send on Slack
     :type message: str
+    :param attachments: The attachments to send on Slack. Should be a list of
+                        dictionaries representing Slack attachments.
+    :type attachments: list
     :param channel: The channel the message should be posted to
     :type channel: str
     :param username: The username to post to slack with
@@ -55,6 +58,7 @@ def __init__(self,
                  http_conn_id=None,
                  webhook_token=None,
                  message="",
+                 attachments=None,
                  channel=None,
                  username=None,
                  icon_emoji=None,
@@ -68,6 +72,7 @@ def __init__(self,
         self.http_conn_id = http_conn_id
         self.webhook_token = webhook_token
         self.message = message
+        self.attachments = attachments
         self.channel = channel
         self.username = username
         self.icon_emoji = icon_emoji
@@ -83,6 +88,7 @@ def execute(self, context):
             self.http_conn_id,
             self.webhook_token,
             self.message,
+            self.attachments,
             self.channel,
             self.username,
             self.icon_emoji,
diff --git a/tests/contrib/hooks/test_slack_webhook_hook.py b/tests/contrib/hooks/test_slack_webhook_hook.py
index a26204f39ef39..384da6d517b0d 100644
--- a/tests/contrib/hooks/test_slack_webhook_hook.py
+++ b/tests/contrib/hooks/test_slack_webhook_hook.py
@@ -32,18 +32,21 @@ class TestSlackWebhookHook(unittest.TestCase):
         'http_conn_id': 'slack-webhook-default',
         'webhook_token': 'manual_token',
         'message': 'Awesome message to put on Slack',
+        'attachments': [{'fallback': 'Required plain-text summary'}],
         'channel': '#general',
         'username': 'SlackMcSlackFace',
         'icon_emoji': ':hankey:',
         'link_names': True,
         'proxy': 'https://my-horrible-proxy.proxyist.com:8080'
     }
-    expected_message_dict = {'channel': _config['channel'],
-                             'username': _config['username'],
-                             'icon_emoji': _config['icon_emoji'],
-                             'link_names': 1,
-                             'text': _config['message']
-                             }
+    expected_message_dict = {
+        'channel': _config['channel'],
+        'username': _config['username'],
+        'icon_emoji': _config['icon_emoji'],
+        'link_names': 1,
+        'attachments': _config['attachments'],
+        'text': _config['message']
+    }
     expected_message = json.dumps(expected_message_dict)
 
     def setUp(self):
diff --git a/tests/contrib/operators/test_slack_webhook_operator.py b/tests/contrib/operators/test_slack_webhook_operator.py
index 6345ad0ef9924..68078bb8018a9 100644
--- a/tests/contrib/operators/test_slack_webhook_operator.py
+++ b/tests/contrib/operators/test_slack_webhook_operator.py
@@ -33,6 +33,7 @@ class TestSlackWebhookOperator(unittest.TestCase):
         'http_conn_id': 'slack-webhook-default',
         'webhook_token': 'manual_token',
         'message': 'your message here',
+        'attachments': [{'fallback': 'Required plain-text summary'}],
         'channel': '#general',
         'username': 'SlackMcSlackFace',
         'icon_emoji': ':hankey',
@@ -59,6 +60,7 @@ def test_execute(self):
         self.assertEqual(self._config['http_conn_id'], operator.http_conn_id)
         self.assertEqual(self._config['webhook_token'], operator.webhook_token)
         self.assertEqual(self._config['message'], operator.message)
+        self.assertEqual(self._config['attachments'], operator.attachments)
         self.assertEqual(self._config['channel'], operator.channel)
         self.assertEqual(self._config['username'], operator.username)
         self.assertEqual(self._config['icon_emoji'], operator.icon_emoji)

From 3697a68cb5201d423cc7e937e8064c17f780724a Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 16 Jan 2019 05:14:30 +0800
Subject: [PATCH 540/808] [AIRFLOW-3709] Validate `allowed_states` for
 ExternalTaskSensor (#4536)

In ExternalTaskSensor, we can specify `allowed_states`.
This commit adds validation for it, so that users will not
specify any invalid state.

This change works no matter the sensor waits for a DAG or
a specific task.
---
 airflow/sensors/external_task_sensor.py    | 13 +++++++++++++
 tests/sensors/test_external_task_sensor.py | 19 +++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index 5ac6b0c22ab0f..e3750ab5ce52a 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -61,6 +61,19 @@ def __init__(self,
                  **kwargs):
         super(ExternalTaskSensor, self).__init__(*args, **kwargs)
         self.allowed_states = allowed_states or [State.SUCCESS]
+        if external_task_id:
+            if not set(self.allowed_states) <= set(State.task_states):
+                raise ValueError(
+                    'Valid values for `allowed_states` '
+                    'when `external_task_id` is not `None`: {}'.format(State.task_states)
+                )
+        else:
+            if not set(self.allowed_states) <= set(State.dag_states):
+                raise ValueError(
+                    'Valid values for `allowed_states` '
+                    'when `external_task_id` is `None`: {}'.format(State.dag_states)
+                )
+
         if execution_delta is not None and execution_date_fn is not None:
             raise ValueError(
                 'Only one of `execution_delta` or `execution_date_fn` may '
diff --git a/tests/sensors/test_external_task_sensor.py b/tests/sensors/test_external_task_sensor.py
index feb0cdcd40a3b..d8f3e44a7946b 100644
--- a/tests/sensors/test_external_task_sensor.py
+++ b/tests/sensors/test_external_task_sensor.py
@@ -247,3 +247,22 @@ def test_external_task_sensor_error_delta_and_fn(self):
                 allowed_states=['success'],
                 dag=self.dag
             )
+
+    def test_catch_invalid_allowed_states(self):
+        with self.assertRaises(ValueError):
+            ExternalTaskSensor(
+                task_id='test_external_task_sensor_check',
+                external_dag_id=TEST_DAG_ID,
+                external_task_id=TEST_TASK_ID,
+                allowed_states=['invalid_state'],
+                dag=self.dag
+            )
+
+        with self.assertRaises(ValueError):
+            ExternalTaskSensor(
+                task_id='test_external_task_sensor_check',
+                external_dag_id=TEST_DAG_ID,
+                external_task_id=None,
+                allowed_states=['invalid_state'],
+                dag=self.dag
+            )

From 428a91de39bcc1a03f8ff214f943cd3979e0156b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcin=20Szyma=C5=84ski?= <ms32035@gmail.com>
Date: Mon, 5 Nov 2018 18:36:45 +0000
Subject: [PATCH 541/808] [AIRFLOW-3218] add support for poking a whole DAG
 (#4058)

Add support for poking a whole DAG
---
 airflow/sensors/external_task_sensor.py    | 32 ++++++++++++++--------
 tests/sensors/test_external_task_sensor.py | 25 ++++++++++++++++-
 2 files changed, 45 insertions(+), 12 deletions(-)

diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index e3750ab5ce52a..0bb62d42b7f34 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from airflow.models import TaskInstance
+from airflow.models import TaskInstance, DagRun
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.utils.db import provide_session
 from airflow.utils.decorators import apply_defaults
@@ -26,18 +26,18 @@
 
 class ExternalTaskSensor(BaseSensorOperator):
     """
-    Waits for a task to complete in a different DAG
+    Waits for a different DAG or a task in in a different DAG to complete
 
     :param external_dag_id: The dag_id that contains the task you want to
         wait for
     :type external_dag_id: str
     :param external_task_id: The task_id that contains the task you want to
-        wait for
+        wait for. If ``None`` the sensor waits for the DAG
     :type external_task_id: str
     :param allowed_states: list of allowed states, default is ``['success']``
     :type allowed_states: list
     :param execution_delta: time difference with the previous execution to
-        look at, the default is the same execution_date as the current task.
+        look at, the default is the same execution_date as the current task or DAG.
         For yesterday, use [positive!] datetime.timedelta(days=1). Either
         execution_delta or execution_date_fn can be passed to
         ExternalTaskSensor, but not both.
@@ -102,13 +102,23 @@ def poke(self, context, session=None):
             '{self.external_dag_id}.'
             '{self.external_task_id} on '
             '{} ... '.format(serialized_dttm_filter, **locals()))
-        TI = TaskInstance
 
-        count = session.query(TI).filter(
-            TI.dag_id == self.external_dag_id,
-            TI.task_id == self.external_task_id,
-            TI.state.in_(self.allowed_states),
-            TI.execution_date.in_(dttm_filter),
-        ).count()
+        if self.external_task_id:
+            TI = TaskInstance
+
+            count = session.query(TI).filter(
+                TI.dag_id == self.external_dag_id,
+                TI.task_id == self.external_task_id,
+                TI.state.in_(self.allowed_states),
+                TI.execution_date.in_(dttm_filter),
+            ).count()
+        else:
+            DR = DagRun
+            count = session.query(DR).filter(
+                DR.dag_id == self.external_dag_id,
+                DR.state.in_(self.allowed_states),
+                DR.execution_date.in_(dttm_filter),
+            ).count()
+
         session.commit()
         return count == len(dttm_filter)
diff --git a/tests/sensors/test_external_task_sensor.py b/tests/sensors/test_external_task_sensor.py
index d8f3e44a7946b..cf156990b8ef0 100644
--- a/tests/sensors/test_external_task_sensor.py
+++ b/tests/sensors/test_external_task_sensor.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 import unittest
-
 from datetime import timedelta, time
 
 from airflow import DAG, configuration, settings
@@ -75,6 +74,30 @@ def test_external_task_sensor(self):
             ignore_ti_state=True
         )
 
+    def test_external_dag_sensor(self):
+
+        other_dag = DAG(
+            'other_dag',
+            default_args=self.args,
+            end_date=DEFAULT_DATE,
+            schedule_interval='@once')
+        other_dag.create_dagrun(
+            run_id='test',
+            start_date=DEFAULT_DATE,
+            execution_date=DEFAULT_DATE,
+            state=State.SUCCESS)
+        t = ExternalTaskSensor(
+            task_id='test_external_dag_sensor_check',
+            external_dag_id='other_dag',
+            external_task_id=None,
+            dag=self.dag
+        )
+        t.run(
+            start_date=DEFAULT_DATE,
+            end_date=DEFAULT_DATE,
+            ignore_ti_state=True
+        )
+
     def test_templated_sensor(self):
         dag = DAG(TEST_DAG_ID, self.args)
 

From 653a5864d35d29fcecf60f32d993fa2301122c10 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 17 Sep 2018 08:59:09 -0400
Subject: [PATCH 542/808] [AIRFLOW-3074] Add relevant ECS options to ECS
 operator. (#3908)

The ECS operator currently supports only a subset of available options
for running ECS tasks. This patch adds all ECS options that could be
relevant to airflow; options that wouldn't make sense here, like
`count`, were skipped.
---
 airflow/contrib/operators/ecs_operator.py    | 39 +++++++++++++----
 tests/contrib/operators/test_ecs_operator.py | 45 ++++++++++++++++++--
 2 files changed, 73 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/operators/ecs_operator.py b/airflow/contrib/operators/ecs_operator.py
index 34a5e0b7694f5..55732b21e5ac8 100644
--- a/airflow/contrib/operators/ecs_operator.py
+++ b/airflow/contrib/operators/ecs_operator.py
@@ -46,6 +46,15 @@ class ECSOperator(BaseOperator):
     :type region_name: str
     :param launch_type: the launch type on which to run your task ('EC2' or 'FARGATE')
     :type launch_type: str
+    :param group: the name of the task group associated with the task
+    :type group: str
+    :param placement_constraints: an array of placement constraint objects to use for
+        the task
+    :type placement_constraints: list
+    :param platform_version: the platform version on which your task is running
+    :type platform_version: str
+    :param network_configuration: the network configuration for the task
+    :type network_configuration: dict
     """
 
     ui_color = '#f0ede4'
@@ -55,7 +64,9 @@ class ECSOperator(BaseOperator):
 
     @apply_defaults
     def __init__(self, task_definition, cluster, overrides,
-                 aws_conn_id=None, region_name=None, launch_type='EC2', **kwargs):
+                 aws_conn_id=None, region_name=None, launch_type='EC2',
+                 group=None, placement_constraints=None, platform_version='LATEST',
+                 network_configuration=None, **kwargs):
         super(ECSOperator, self).__init__(**kwargs)
 
         self.aws_conn_id = aws_conn_id
@@ -64,6 +75,10 @@ def __init__(self, task_definition, cluster, overrides,
         self.cluster = cluster
         self.overrides = overrides
         self.launch_type = launch_type
+        self.group = group
+        self.placement_constraints = placement_constraints
+        self.platform_version = platform_version
+        self.network_configuration = network_configuration
 
         self.hook = self.get_hook()
 
@@ -79,13 +94,21 @@ def execute(self, context):
             region_name=self.region_name
         )
 
-        response = self.client.run_task(
-            cluster=self.cluster,
-            taskDefinition=self.task_definition,
-            overrides=self.overrides,
-            startedBy=self.owner,
-            launchType=self.launch_type
-        )
+        run_opts = {
+            'cluster': self.cluster,
+            'taskDefinition': self.task_definition,
+            'overrides': self.overrides,
+            'startedBy': self.owner,
+            'launchType': self.launch_type,
+            'platformVersion': self.platform_version,
+        }
+        if self.group is not None:
+            run_opts['group'] = self.group
+        if self.placement_constraints is not None:
+            run_opts['placementConstraints'] = self.placement_constraints
+        if self.network_configuration is not None:
+            run_opts['networkConfiguration'] = self.network_configuration
+        response = self.client.run_task(**run_opts)
 
         failures = response['failures']
         if len(failures) > 0:
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index a5914ae585d4c..51391c7b1ea9a 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -69,7 +69,20 @@ def setUp(self, aws_hook_mock):
             cluster='c',
             overrides={},
             aws_conn_id=None,
-            region_name='eu-west-1')
+            region_name='eu-west-1',
+            group='group',
+            placement_constraints=[
+                {
+                    'expression': 'attribute:ecs.instance-type =~ t2.*',
+                    'type': 'memberOf'
+                }
+            ],
+            network_configuration={
+                'awsvpcConfiguration': {
+                    'securityGroups': ['sg-123abc']
+                }
+            }
+        )
 
     def test_init(self):
         self.assertEqual(self.ecs.region_name, 'eu-west-1')
@@ -99,7 +112,20 @@ def test_execute_without_failures(self, check_mock, wait_mock):
             launchType='EC2',
             overrides={},
             startedBy=mock.ANY,  # Can by 'airflow' or 'Airflow'
-            taskDefinition='t'
+            taskDefinition='t',
+            group='group',
+            placementConstraints=[
+                {
+                    'expression': 'attribute:ecs.instance-type =~ t2.*',
+                    'type': 'memberOf'
+                }
+            ],
+            platformVersion='LATEST',
+            networkConfiguration={
+                'awsvpcConfiguration': {
+                    'securityGroups': ['sg-123abc']
+                }
+            }
         )
 
         wait_mock.assert_called_once_with()
@@ -123,7 +149,20 @@ def test_execute_with_failures(self):
             launchType='EC2',
             overrides={},
             startedBy=mock.ANY,  # Can by 'airflow' or 'Airflow'
-            taskDefinition='t'
+            taskDefinition='t',
+            group='group',
+            placementConstraints=[
+                {
+                    'expression': 'attribute:ecs.instance-type =~ t2.*',
+                    'type': 'memberOf'
+                }
+            ],
+            platformVersion='LATEST',
+            networkConfiguration={
+                'awsvpcConfiguration': {
+                    'securityGroups': ['sg-123abc']
+                }
+            }
         )
 
     def test_wait_end_tasks(self):

From 871699483df2e004fdac5decb993c385b412416b Mon Sep 17 00:00:00 2001
From: Thales Mello <thalesmello@gmail.com>
Date: Tue, 15 Jan 2019 19:54:55 -0200
Subject: [PATCH 543/808] [AIRFLOW-3108] Define get_autocommit method for
 MsSqlHook (#4525)

The default implementation of DbApiHook merely checks for an attribute named `autocommit`.

Since `pymssql` Connection object actually has a method with that name, it returns a bound method when fetching an attribute with that name, evaluating to a "truthy" value. It resulted in SQL statements not actually being committed.
---
 airflow/hooks/mssql_hook.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/airflow/hooks/mssql_hook.py b/airflow/hooks/mssql_hook.py
index 7ba34892a7d56..6dc3980fd20e2 100644
--- a/airflow/hooks/mssql_hook.py
+++ b/airflow/hooks/mssql_hook.py
@@ -50,3 +50,6 @@ def get_conn(self):
 
     def set_autocommit(self, conn, autocommit):
         conn.autocommit(autocommit)
+
+    def get_autocommit(self, conn):
+        return conn.autocommit_state

From 2f1e6b728ffc53067522fe1eab709fd0f760484e Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Fri, 18 Jan 2019 18:00:42 +0100
Subject: [PATCH 544/808] [AIRFLOW-3591] Fix start date, end date, duration for
 rescheduled tasks (#4502)

* Use first start date when running a rescheduled task, this also fixes
  the duration. Use actual start date to record reschedule requests.
* Simplify gantt view code now that start date and duration are correct
  in `task_instance` table
---
 airflow/models.py                 |  13 +++-
 airflow/www/views.py              |  31 ++-------
 airflow/www_rbac/views.py         |  29 ++-------
 tests/models.py                   | 105 ++++++++++++++++++++++++++++++
 tests/sensors/test_base_sensor.py |   6 ++
 5 files changed, 134 insertions(+), 50 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 31cf043dfe90e..25a12bcd0c3e6 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1531,7 +1531,13 @@ def _check_and_change_state_before_execution(
         msg = "Starting attempt {attempt} of {total}".format(
             attempt=self.try_number,
             total=self.max_tries + 1)
+
+        # Set the task start date. In case it was re-scheduled use the initial
+        # start date that is recorded in task_reschedule table
         self.start_date = timezone.utcnow()
+        task_reschedules = TaskReschedule.find_for_task_instance(self, session)
+        if task_reschedules:
+            self.start_date = task_reschedules[0].start_date
 
         dep_context = DepContext(
             deps=RUN_DEPS - QUEUE_DEPS,
@@ -1625,6 +1631,7 @@ def _run_raw_task(
         self.operator = task.__class__.__name__
 
         context = {}
+        actual_start_date = timezone.utcnow()
         try:
             if not mark_success:
                 context = self.get_template_context()
@@ -1688,7 +1695,7 @@ def signal_handler(signum, frame):
             self.state = State.SKIPPED
         except AirflowRescheduleException as reschedule_exception:
             self.refresh_from_db()
-            self._handle_reschedule(reschedule_exception, test_mode, context)
+            self._handle_reschedule(actual_start_date, reschedule_exception, test_mode, context)
             return
         except AirflowException as e:
             self.refresh_from_db()
@@ -1760,7 +1767,7 @@ def dry_run(self):
         task_copy.dry_run()
 
     @provide_session
-    def _handle_reschedule(self, reschedule_exception, test_mode=False, context=None,
+    def _handle_reschedule(self, actual_start_date, reschedule_exception, test_mode=False, context=None,
                            session=None):
         # Don't record reschedule request in test mode
         if test_mode:
@@ -1771,7 +1778,7 @@ def _handle_reschedule(self, reschedule_exception, test_mode=False, context=None
 
         # Log reschedule request
         session.add(TaskReschedule(self.task, self.execution_date, self._try_number,
-                    self.start_date, self.end_date,
+                    actual_start_date, self.end_date,
                     reschedule_exception.reschedule_date))
 
         # set state
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 54e78482a091c..737b821382c1e 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1939,32 +1939,15 @@ def gantt(self, session=None):
                     TF.execution_date == ti.execution_date)
             .all()
         ) for ti in tis]))
-        TR = models.TaskReschedule
-        ti_reschedules = list(itertools.chain(*[(
-            session
-            .query(TR)
-            .filter(TR.dag_id == ti.dag_id,
-                    TR.task_id == ti.task_id,
-                    TR.execution_date == ti.execution_date)
-            .all()
-        ) for ti in tis]))
+
         # determine bars to show in the gantt chart
-        # all reschedules of one attempt are combinded into one bar
         gantt_bar_items = []
-        for task_id, items in itertools.groupby(
-                sorted(tis + ti_fails + ti_reschedules, key=lambda ti: ti.task_id),
-                key=lambda ti: ti.task_id):
-            start_date = None
-            for i in sorted(items, key=lambda ti: ti.start_date):
-                start_date = start_date or i.start_date
-                end_date = i.end_date or timezone.utcnow()
-                if type(i) == models.TaskInstance:
-                    gantt_bar_items.append((task_id, start_date, end_date, i.state))
-                    start_date = None
-                elif type(i) == TF and (len(gantt_bar_items) == 0 or
-                                        end_date != gantt_bar_items[-1][2]):
-                    gantt_bar_items.append((task_id, start_date, end_date, State.FAILED))
-                    start_date = None
+        for ti in tis:
+            end_date = ti.end_date or timezone.utcnow()
+            gantt_bar_items.append((ti.task_id, ti.start_date, end_date, ti.state))
+        for tf in ti_fails:
+            end_date = tf.end_date or timezone.utcnow()
+            gantt_bar_items.append((tf.task_id, tf.start_date, end_date, State.FAILED))
 
         tasks = []
         for gantt_bar_item in gantt_bar_items:
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 6c306710efe6d..e06f7c78c1cd0 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1721,33 +1721,16 @@ def gantt(self, session=None):
                     TF.execution_date == ti.execution_date)
             .all()
         ) for ti in tis]))
-        TR = models.TaskReschedule
-        ti_reschedules = list(itertools.chain(*[(
-            session
-            .query(TR)
-            .filter(TR.dag_id == ti.dag_id,
-                    TR.task_id == ti.task_id,
-                    TR.execution_date == ti.execution_date)
-            .all()
-        ) for ti in tis]))
 
         # determine bars to show in the gantt chart
         # all reschedules of one attempt are combinded into one bar
         gantt_bar_items = []
-        for task_id, items in itertools.groupby(
-                sorted(tis + ti_fails + ti_reschedules, key=lambda ti: ti.task_id),
-                key=lambda ti: ti.task_id):
-            start_date = None
-            for i in sorted(items, key=lambda ti: ti.start_date):
-                start_date = start_date or i.start_date
-                end_date = i.end_date or timezone.utcnow()
-                if type(i) == models.TaskInstance:
-                    gantt_bar_items.append((task_id, start_date, end_date, i.state))
-                    start_date = None
-                elif type(i) == TF and (len(gantt_bar_items) == 0 or
-                                        end_date != gantt_bar_items[-1][2]):
-                    gantt_bar_items.append((task_id, start_date, end_date, State.FAILED))
-                    start_date = None
+        for ti in tis:
+            end_date = ti.end_date or timezone.utcnow()
+            gantt_bar_items.append((ti.task_id, ti.start_date, end_date, ti.state))
+        for tf in ti_fails:
+            end_date = tf.end_date or timezone.utcnow()
+            gantt_bar_items.append((tf.task_id, tf.start_date, end_date, State.FAILED))
 
         tasks = []
         for gantt_bar_item in gantt_bar_items:
diff --git a/tests/models.py b/tests/models.py
index ca2cfe030e5d2..92376f135169d 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -37,8 +37,10 @@
 import six
 from mock import ANY, Mock, patch
 from parameterized import parameterized
+from freezegun import freeze_time
 
 from airflow import AirflowException, configuration, models, settings
+from airflow.contrib.sensors.python_sensor import PythonSensor
 from airflow.exceptions import AirflowDagCycleException, AirflowSkipException
 from airflow.jobs import BackfillJob
 from airflow.models import Connection
@@ -47,6 +49,7 @@
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.models import SkipMixin
 from airflow.models import State as ST
+from airflow.models import TaskReschedule as TR
 from airflow.models import XCom
 from airflow.models import clear_task_instances
 from airflow.operators.bash_operator import BashOperator
@@ -1841,6 +1844,12 @@ def test_deactivate_unknown_dags(self):
 
 class TaskInstanceTest(unittest.TestCase):
 
+    def tearDown(self):
+        with create_session() as session:
+            session.query(models.TaskFail).delete()
+            session.query(models.TaskReschedule).delete()
+            session.query(models.TaskInstance).delete()
+
     def test_set_task_dates(self):
         """
         Test that tasks properly take start/end dates from DAGs
@@ -2211,6 +2220,102 @@ def test_next_retry_datetime(self):
         dt = ti.next_retry_datetime()
         self.assertEqual(dt, ti.end_date + max_delay)
 
+    @patch.object(TI, 'pool_full')
+    def test_reschedule_handling(self, mock_pool_full):
+        """
+        Test that task reschedules are handled properly
+        """
+        # Mock the pool with a pool with slots open since the pool doesn't actually exist
+        mock_pool_full.return_value = False
+
+        # Return values of the python sensor callable, modified during tests
+        done = False
+        fail = False
+
+        def callable():
+            if fail:
+                raise AirflowException()
+            return done
+
+        dag = models.DAG(dag_id='test_reschedule_handling')
+        task = PythonSensor(
+            task_id='test_reschedule_handling_sensor',
+            poke_interval=0,
+            mode='reschedule',
+            python_callable=callable,
+            retries=1,
+            retry_delay=datetime.timedelta(seconds=0),
+            dag=dag,
+            owner='airflow',
+            start_date=timezone.datetime(2016, 2, 1, 0, 0, 0))
+
+        ti = TI(task=task, execution_date=timezone.utcnow())
+        self.assertEqual(ti._try_number, 0)
+        self.assertEqual(ti.try_number, 1)
+
+        def run_ti_and_assert(run_date, expected_start_date, expected_end_date, expected_duration,
+                              expected_state, expected_try_number, expected_task_reschedule_count):
+            with freeze_time(run_date):
+                try:
+                    ti.run()
+                except AirflowException:
+                    if not fail:
+                        raise
+            ti.refresh_from_db()
+            self.assertEqual(ti.state, expected_state)
+            self.assertEqual(ti._try_number, expected_try_number)
+            self.assertEqual(ti.try_number, expected_try_number + 1)
+            self.assertEqual(ti.start_date, expected_start_date)
+            self.assertEqual(ti.end_date, expected_end_date)
+            self.assertEqual(ti.duration, expected_duration)
+            trs = TR.find_for_task_instance(ti)
+            self.assertEqual(len(trs), expected_task_reschedule_count)
+
+        date1 = timezone.utcnow()
+        date2 = date1 + datetime.timedelta(minutes=1)
+        date3 = date2 + datetime.timedelta(minutes=1)
+        date4 = date3 + datetime.timedelta(minutes=1)
+
+        # Run with multiple reschedules.
+        # During reschedule the try number remains the same, but each reschedule is recorded.
+        # The start date is expected to remain the inital date, hence the duration increases.
+        # When finished the try number is incremented and there is no reschedule expected
+        # for this try.
+
+        done, fail = False, False
+        run_ti_and_assert(date1, date1, date1, 0, State.UP_FOR_RESCHEDULE, 0, 1)
+
+        done, fail = False, False
+        run_ti_and_assert(date2, date1, date2, 60, State.UP_FOR_RESCHEDULE, 0, 2)
+
+        done, fail = False, False
+        run_ti_and_assert(date3, date1, date3, 120, State.UP_FOR_RESCHEDULE, 0, 3)
+
+        done, fail = True, False
+        run_ti_and_assert(date4, date1, date4, 180, State.SUCCESS, 1, 0)
+
+        # Clear the task instance.
+        dag.clear()
+        ti.refresh_from_db()
+        self.assertEqual(ti.state, State.NONE)
+        self.assertEqual(ti._try_number, 1)
+
+        # Run again after clearing with reschedules and a retry.
+        # The retry increments the try number, and for that try no reschedule is expected.
+        # After the retry the start date is reset, hence the duration is also reset.
+
+        done, fail = False, False
+        run_ti_and_assert(date1, date1, date1, 0, State.UP_FOR_RESCHEDULE, 1, 1)
+
+        done, fail = False, True
+        run_ti_and_assert(date2, date1, date2, 60, State.UP_FOR_RETRY, 2, 0)
+
+        done, fail = False, False
+        run_ti_and_assert(date3, date3, date3, 0, State.UP_FOR_RESCHEDULE, 2, 1)
+
+        done, fail = True, False
+        run_ti_and_assert(date4, date3, date4, 60, State.SUCCESS, 3, 0)
+
     def test_depends_on_past(self):
         dagbag = models.DagBag()
         dag = dagbag.get_dag('test_depends_on_past')
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index f9186db149c5c..239d1b7c4d447 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -183,6 +183,8 @@ def test_ok_with_reschedule(self):
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
                 self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                # verify task start date is the initial one
+                self.assertEquals(ti.start_date, date1)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 1)
@@ -202,6 +204,8 @@ def test_ok_with_reschedule(self):
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
                 self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                # verify task start date is the initial one
+                self.assertEquals(ti.start_date, date1)
                 # verify two rows in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
                 self.assertEquals(len(task_reschedules), 2)
@@ -220,6 +224,8 @@ def test_ok_with_reschedule(self):
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 self.assertEquals(ti.state, State.SUCCESS)
+                # verify task start date is the initial one
+                self.assertEquals(ti.start_date, date1)
             if ti.task_id == DUMMY_OP:
                 self.assertEquals(ti.state, State.NONE)
 

From 2ff35ebd5b826194c013f16e98f448cc7a69b560 Mon Sep 17 00:00:00 2001
From: yangaws <31293788+yangaws@users.noreply.github.com>
Date: Fri, 25 Jan 2019 13:15:22 -0800
Subject: [PATCH 545/808] [AIRFLOW-3719] Handle StopIteration in CloudWatch
 logs retrieval (#4516)

---
 airflow/contrib/hooks/sagemaker_hook.py    | 10 +++++++++-
 tests/contrib/hooks/test_sagemaker_hook.py |  8 ++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index 55e62a78e238f..8ff478649de1a 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -304,7 +304,15 @@ def multi_stream_iter(self, log_group, streams, positions=None):
         positions = positions or {s: Position(timestamp=0, skip=0) for s in streams}
         event_iters = [self.log_stream(log_group, s, positions[s].timestamp, positions[s].skip)
                        for s in streams]
-        events = [next(s) if s else None for s in event_iters]
+        events = []
+        for s in event_iters:
+            if not s:
+                events.append(None)
+                continue
+            try:
+                events.append(next(s))
+            except StopIteration:
+                events.append(None)
 
         while any(events):
             i = argmin(events, lambda x: x['timestamp'] if x else 9999999999)
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
index bec00bf601a8f..02dad6cb851e5 100644
--- a/tests/contrib/hooks/test_sagemaker_hook.py
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -256,6 +256,14 @@ class TestSageMakerHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
 
+    @mock.patch.object(SageMakerHook, 'log_stream')
+    def test_multi_stream_iter(self, mock_log_stream):
+        event = {'timestamp': 1}
+        mock_log_stream.side_effect = [iter([event]), iter([]), None]
+        hook = SageMakerHook()
+        event_iter = hook.multi_stream_iter('log', [None, None, None])
+        self.assertEqual(next(event_iter), (0, event))
+
     @mock.patch.object(S3Hook, 'create_bucket')
     @mock.patch.object(S3Hook, 'load_file')
     def test_configure_s3_resources(self, mock_load_file, mock_create_bucket):

From 988ac592eb9b3621e2ac006b842dc1af8d8154ce Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Tue, 29 Jan 2019 22:44:10 +0100
Subject: [PATCH 546/808] AIRFLOW-3590: Change log message of executor exit
 status (#4616)

Try to make the log message clearer in the presence of rescheduled tasks -
i.e that the task exited with 0/1, not the status of the task, without having each
executor having to know about reschedule or other states we might introduce.
---
 airflow/jobs.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index c08ebc023397c..f6f0ef111737d 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1441,7 +1441,8 @@ def _process_executor_events(self, simple_dag_bag, session=None):
                                    .items()):
             dag_id, task_id, execution_date, try_number = key
             self.log.info(
-                "Executor reports %s.%s execution_date=%s as %s for try_number %s",
+                "Executor reports execution of %s.%s execution_date=%s "
+                "exited with status %s for try_number %s",
                 dag_id, task_id, execution_date, state, try_number
             )
             if state == State.FAILED or state == State.SUCCESS:

From cc1c75aa877f6a9064e7cf4042971bee922e453e Mon Sep 17 00:00:00 2001
From: "Drew J. Sonne" <drew.sonne@gmail.com>
Date: Wed, 30 Jan 2019 19:10:25 +0000
Subject: [PATCH 547/808] [AIRFLOW-3774] Register blueprints with RBAC web app
 (#4598)

---
 airflow/plugins_manager.py                 |  5 ++++-
 airflow/www/app.py                         |  4 ++--
 airflow/www_rbac/app.py                    | 11 ++++++++++-
 tests/plugins/test_plugins_manager_rbac.py |  7 +++++++
 4 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index b74c35e56045a..5345637a8121e 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -191,7 +191,10 @@ def make_module(name, objects):
     macros_modules.append(make_module('airflow.macros.' + p.name, p.macros))
 
     admin_views.extend(p.admin_views)
-    flask_blueprints.extend(p.flask_blueprints)
     menu_links.extend(p.menu_links)
     flask_appbuilder_views.extend(p.appbuilder_views)
     flask_appbuilder_menu_links.extend(p.appbuilder_menu_items)
+    flask_blueprints.extend([{
+        'name': p.name,
+        'blueprint': bp
+    } for bp in p.flask_blueprints])
diff --git a/airflow/www/app.py b/airflow/www/app.py
index e17f1c9edd0e6..22c41bc18d046 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -139,8 +139,8 @@ def integrate_plugins():
                 log.debug('Adding view %s', v.name)
                 admin.add_view(v)
             for bp in flask_blueprints:
-                log.debug('Adding blueprint %s', bp.name)
-                app.register_blueprint(bp)
+                log.debug("Adding blueprint %s:%s", bp["name"], bp["blueprint"].import_name)
+                app.register_blueprint(bp["blueprint"])
             for ml in sorted(menu_links, key=lambda x: x.name):
                 log.debug('Adding menu link %s', ml.name)
                 admin.add_link(ml)
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index af0b09daa96b4..185f308f36889 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -145,7 +145,8 @@ def init_views(appbuilder):
             def integrate_plugins():
                 """Integrate plugins to the context"""
                 from airflow.plugins_manager import (
-                    flask_appbuilder_views, flask_appbuilder_menu_links)
+                    flask_appbuilder_views, flask_appbuilder_menu_links
+                )
 
                 for v in flask_appbuilder_views:
                     log.debug("Adding view %s", v["name"])
@@ -165,7 +166,15 @@ def integrate_plugins():
             # will add the new Views and Menus names to the backend, but will not
             # delete the old ones.
 
+        def init_plugin_blueprints(app):
+            from airflow.plugins_manager import flask_blueprints
+
+            for bp in flask_blueprints:
+                log.debug("Adding blueprint %s:%s", bp["name"], bp["blueprint"].import_name)
+                app.register_blueprint(bp["blueprint"])
+
         init_views(appbuilder)
+        init_plugin_blueprints(app)
 
         security_manager = appbuilder.sm
         security_manager.sync_roles()
diff --git a/tests/plugins/test_plugins_manager_rbac.py b/tests/plugins/test_plugins_manager_rbac.py
index b33464d397cda..fe440debc4e30 100644
--- a/tests/plugins/test_plugins_manager_rbac.py
+++ b/tests/plugins/test_plugins_manager_rbac.py
@@ -66,3 +66,10 @@ def test_flaskappbuilder_menu_links(self):
         link = links[0]
         self.assertEqual(link.name, appbuilder_mitem['category'])
         self.assertEqual(link.childs[0].name, appbuilder_mitem['name'])
+
+    def test_app_blueprints(self):
+        from tests.plugins.test_plugin import bp
+
+        # Blueprint should be present in the app
+        self.assertTrue('test_plugin' in self.app.blueprints)
+        self.assertEqual(self.app.blueprints['test_plugin'].name, bp.name)

From dede2566fccff873fa20b6684d48f70b4dfa4826 Mon Sep 17 00:00:00 2001
From: phanindhra <phani8996@gmail.com>
Date: Mon, 15 Oct 2018 22:33:08 +0530
Subject: [PATCH 548/808] [AIRFLOW-1945] Add Autoscale config for Celery
 workers (#3989)

---
 airflow/bin/cli.py                           | 9 ++++++++-
 airflow/config_templates/default_airflow.cfg | 7 +++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 411b62ce54000..7bb2d8055168f 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1026,12 +1026,16 @@ def worker(args):
     from airflow.executors.celery_executor import app as celery_app
     from celery.bin import worker
 
+    autoscale = args.autoscale
+    if autoscale is None and conf.has_option("celery", "worker_autoscale"):
+        autoscale = conf.get("celery", "worker_autoscale")
     worker = worker.worker(app=celery_app)
     options = {
         'optimization': 'fair',
         'O': 'fair',
         'queues': args.queues,
         'concurrency': args.concurrency,
+        'autoscale': autoscale,
         'hostname': args.celery_hostname,
         'loglevel': conf.get('core', 'LOGGING_LEVEL'),
     }
@@ -1897,6 +1901,9 @@ class CLIFactory(object):
             help='Do not prompt for password.  Use random string instead',
             default=False,
             action='store_true'),
+        'autoscale': Arg(
+            ('-a', '--autoscale'),
+            help="Minimum and Maximum number of worker to autoscale"),
     }
     subparsers = (
         {
@@ -2038,7 +2045,7 @@ class CLIFactory(object):
             'func': worker,
             'help': "Start a Celery worker node",
             'args': ('do_pickle', 'queues', 'concurrency', 'celery_hostname',
-                     'pid', 'daemon', 'stdout', 'stderr', 'log_file'),
+                     'pid', 'daemon', 'stdout', 'stderr', 'log_file', 'autoscale'),
         }, {
             'func': flower,
             'help': "Start a Celery Flower",
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 15da6155f73ef..846ad22f71d3c 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -355,6 +355,13 @@ celery_app_name = airflow.executors.celery_executor
 # your worker box and the nature of your tasks
 worker_concurrency = 16
 
+# The minimum and maximum concurrency that will be used when starting workers with the
+# "airflow worker" command. Pick these numbers based on resources on
+# worker box and the nature of the task. If autoscale option is available worker_concurrency
+# will be ignored.
+# http://docs.celeryproject.org/en/latest/reference/celery.bin.worker.html#cmdoption-celery-worker-autoscale
+# worker_autoscale = 12,16
+
 # When you start an airflow worker, airflow starts a tiny web server
 # subprocess to serve the workers local log files to the airflow main
 # web server, who then builds pages and sends them to users. This defines

From 04f4ff12f2f90cd22ade9ef5c7dd322349a8e6bb Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 31 Jan 2019 22:12:57 +0800
Subject: [PATCH 549/808] [AIRFLOW-3782] Clarify docs around celery
 worker_autoscale in default_airflow.cfg (#4609)

Celery supports `autoscale` by accepting values in format "max_concurrency,min_concurrency".
But the default value in default_airflow.cfg is wrong, and the comment can be clearer.
---
 airflow/config_templates/default_airflow.cfg | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 846ad22f71d3c..d2ecc3e5aa559 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -355,12 +355,13 @@ celery_app_name = airflow.executors.celery_executor
 # your worker box and the nature of your tasks
 worker_concurrency = 16
 
-# The minimum and maximum concurrency that will be used when starting workers with the
-# "airflow worker" command. Pick these numbers based on resources on
-# worker box and the nature of the task. If autoscale option is available worker_concurrency
-# will be ignored.
+# The maximum and minimum concurrency that will be used when starting workers with the
+# "airflow worker" command (always keep minimum processes, but grow to maximum if necessary).
+# Note the value should be "max_concurrency,min_concurrency"
+# Pick these numbers based on resources on worker box and the nature of the task.
+# If autoscale option is available, worker_concurrency will be ignored.
 # http://docs.celeryproject.org/en/latest/reference/celery.bin.worker.html#cmdoption-celery-worker-autoscale
-# worker_autoscale = 12,16
+# worker_autoscale = 16,12
 
 # When you start an airflow worker, airflow starts a tiny web server
 # subprocess to serve the workers local log files to the airflow main

From 1495f6fc46e95109bd6bd8a0dfeab1836030ce91 Mon Sep 17 00:00:00 2001
From: mans2singh <mans2singh@users.noreply.github.com>
Date: Thu, 7 Feb 2019 00:43:13 -0500
Subject: [PATCH 550/808] [AIRFLOW-3817] - Corrected task ids returned by
 BranchPythonOperator to match the dummy operator ids (#4659)

---
 airflow/example_dags/example_branch_python_dop_operator_3.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/example_dags/example_branch_python_dop_operator_3.py b/airflow/example_dags/example_branch_python_dop_operator_3.py
index 950d5c1ae253b..36edb27317344 100644
--- a/airflow/example_dags/example_branch_python_dop_operator_3.py
+++ b/airflow/example_dags/example_branch_python_dop_operator_3.py
@@ -42,9 +42,9 @@ def should_run(**kwargs):
     print('------------- exec dttm = {} and minute = {}'.
           format(kwargs['execution_date'], kwargs['execution_date'].minute))
     if kwargs['execution_date'].minute % 2 == 0:
-        return "oper_1"
+        return "dummy_task_1"
     else:
-        return "oper_2"
+        return "dummy_task_2"
 
 
 cond = BranchPythonOperator(

From 66fef93138f7880e1e10b4459503a74277aa246c Mon Sep 17 00:00:00 2001
From: mans2singh <mans2singh@users.noreply.github.com>
Date: Thu, 7 Feb 2019 00:44:36 -0500
Subject: [PATCH 551/808] [AIRFLOW-3802] Updated documentation for
 HiveServer2Hook (#4647)

---
 airflow/hooks/hive_hooks.py | 48 +++++++++++++++++++++++++++++++------
 1 file changed, 41 insertions(+), 7 deletions(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index 871205b93dff6..adf629e858a31 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -761,6 +761,9 @@ def __init__(self, hiveserver2_conn_id='hiveserver2_default'):
         self.hiveserver2_conn_id = hiveserver2_conn_id
 
     def get_conn(self, schema=None):
+        """
+        Returns a Hive connection object.
+        """
         db = self.get_connection(self.hiveserver2_conn_id)
         auth_mechanism = db.extra_dejson.get('authMechanism', 'NONE')
         if auth_mechanism == 'NONE' and db.login is None:
@@ -834,11 +837,17 @@ def _get_results(self, hql, schema='default', fetch_size=None, hive_conf=None):
     def get_results(self, hql, schema='default', fetch_size=None, hive_conf=None):
         """
         Get results of the provided hql in target schema.
+
         :param hql: hql to be executed.
+        :type hql: str or list
         :param schema: target schema, default to 'default'.
-        :param fetch_size max size of result to fetch.
+        :type schema: str
+        :param fetch_size max: size of result to fetch.
+        :type fetch_size_max: int
         :param hive_conf: hive_conf to execute alone with the hql.
-        :return: results of hql execution.
+        :type hive_conf: dict
+        :return: results of hql execution, dict with data (list of results) and header
+        :rtype: dict
         """
         results_iter = self._get_results(hql, schema,
                                          fetch_size=fetch_size, hive_conf=hive_conf)
@@ -861,15 +870,24 @@ def to_csv(
             hive_conf=None):
         """
         Execute hql in target schema and write results to a csv file.
+
         :param hql: hql to be executed.
+        :type hql: str or list
         :param csv_filepath: filepath of csv to write results into.
-        :param schema: target schema, , default to 'default'.
-        :param delimiter: delimiter of the csv file.
+        :type csv_filepath: str
+        :param schema: target schema, default to 'default'.
+        :type schema: str
+        :param delimiter: delimiter of the csv file, default to ','.
+        :type delimiter: str
         :param lineterminator: lineterminator of the csv file.
-        :param output_header: header of the csv file.
-        :param fetch_size: number of result rows to write into the csv file.
+        :type lineterminator: str
+        :param output_header: header of the csv file, default to True.
+        :type output_header: bool
+        :param fetch_size: number of result rows to write into the csv file, default to 1000.
+        :type fetch_size: int
         :param hive_conf: hive_conf to execute alone with the hql.
-        :return:
+        :type hive_conf: dict
+
         """
 
         results_iter = self._get_results(hql, schema,
@@ -905,6 +923,15 @@ def get_records(self, hql, schema='default'):
         """
         Get a set of records from a Hive query.
 
+        :param hql: hql to be executed.
+        :type hql: str or list
+        :param schema: target schema, default to 'default'.
+        :type schema: str
+        :param hive_conf: hive_conf to execute alone with the hql.
+        :type hive_conf: dict
+        :return: result of hive execution
+        :rtype: list
+
         >>> hh = HiveServer2Hook()
         >>> sql = "SELECT * FROM airflow.static_babynames LIMIT 100"
         >>> len(hh.get_records(sql))
@@ -916,6 +943,13 @@ def get_pandas_df(self, hql, schema='default'):
         """
         Get a pandas dataframe from a Hive query
 
+        :param hql: hql to be executed.
+        :type hql: str or list
+        :param schema: target schema, default to 'default'.
+        :type schema: str
+        :return: result of hql execution
+        :rtype: DataFrame
+
         >>> hh = HiveServer2Hook()
         >>> sql = "SELECT * FROM airflow.static_babynames LIMIT 100"
         >>> df = hh.get_pandas_df(sql)

From 9c11ac92fdda0e8ba623cb0be543ff5058cd9ce2 Mon Sep 17 00:00:00 2001
From: Penumbra69 <wgold@flyingplastic.com>
Date: Thu, 7 Feb 2019 03:37:25 -0800
Subject: [PATCH 552/808] [AIRFLOW-3647] Add archives config option to
 SparkSubmitOperator (#4467)

To enable to spark behavior of transporting and extracting an archive
on job launch,  making the _contents_ of the archive available to the
driver as well as the workers (not just the jar or archive as a zip
file) - this configuration attribute is necessary.

This is required if you have no ability to modify the Python env on
the worker / driver nodes, but you wish to use versions, modules, or
features not installed.

We transport a full Python 3.5 environment to our CDH cluster using
this option and the alias "#PYTHON" paired an additional configuration
to spark to use it:

    --archives "hdfs:///user/myuser/my_python_env.zip#PYTHON"
    --conf "spark.yarn.appMasterEnv.PYSPARK_PYTHON=./PYTHON/python35/bin/python3"
---
 airflow/contrib/hooks/spark_submit_hook.py            | 6 ++++++
 airflow/contrib/operators/spark_submit_operator.py    | 3 +++
 tests/contrib/hooks/test_spark_submit_hook.py         | 2 ++
 tests/contrib/operators/test_spark_submit_operator.py | 3 +++
 4 files changed, 14 insertions(+)

diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 20bd2547e698e..ee43652e92660 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -44,6 +44,8 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :type files: str
     :param py_files: Additional python files used by the job, can be .zip, .egg or .py.
     :type py_files: str
+    :param: archives: Archives that spark should unzip (and possibly tag with #ALIAS) into
+        the application working directory.
     :param driver_classpath: Additional, driver-specific, classpath settings.
     :type driver_classpath: str
     :param jars: Submit additional jars to upload and place them in executor classpath.
@@ -90,6 +92,7 @@ def __init__(self,
                  conn_id='spark_default',
                  files=None,
                  py_files=None,
+                 archives=None,
                  driver_classpath=None,
                  jars=None,
                  java_class=None,
@@ -111,6 +114,7 @@ def __init__(self,
         self._conn_id = conn_id
         self._files = files
         self._py_files = py_files
+        self._archives = archives
         self._driver_classpath = driver_classpath
         self._jars = jars
         self._java_class = java_class
@@ -238,6 +242,8 @@ def _build_spark_submit_command(self, application):
             connection_cmd += ["--files", self._files]
         if self._py_files:
             connection_cmd += ["--py-files", self._py_files]
+        if self._archives:
+            connection_cmd += ["--archives", self._archives]
         if self._driver_classpath:
             connection_cmd += ["--driver-classpath", self._driver_classpath]
         if self._jars:
diff --git a/airflow/contrib/operators/spark_submit_operator.py b/airflow/contrib/operators/spark_submit_operator.py
index 3c3cab0ceb350..938fc34ca4191 100644
--- a/airflow/contrib/operators/spark_submit_operator.py
+++ b/airflow/contrib/operators/spark_submit_operator.py
@@ -94,6 +94,7 @@ def __init__(self,
                  conn_id='spark_default',
                  files=None,
                  py_files=None,
+                 archives=None,
                  driver_classpath=None,
                  jars=None,
                  java_class=None,
@@ -118,6 +119,7 @@ def __init__(self,
         self._conf = conf
         self._files = files
         self._py_files = py_files
+        self._archives = archives
         self._driver_classpath = driver_classpath
         self._jars = jars
         self._java_class = java_class
@@ -147,6 +149,7 @@ def execute(self, context):
             conn_id=self._conn_id,
             files=self._files,
             py_files=self._py_files,
+            archives=self._archives,
             driver_classpath=self._driver_classpath,
             jars=self._jars,
             java_class=self._java_class,
diff --git a/tests/contrib/hooks/test_spark_submit_hook.py b/tests/contrib/hooks/test_spark_submit_hook.py
index 1bdcda56ec6f6..beecf6a7241bc 100644
--- a/tests/contrib/hooks/test_spark_submit_hook.py
+++ b/tests/contrib/hooks/test_spark_submit_hook.py
@@ -37,6 +37,7 @@ class TestSparkSubmitHook(unittest.TestCase):
         'conn_id': 'default_spark',
         'files': 'hive-site.xml',
         'py_files': 'sample_library.py',
+        'archives': 'sample_archive.zip#SAMPLE',
         'jars': 'parquet.jar',
         'packages': 'com.databricks:spark-avro_2.11:3.2.0',
         'exclude_packages': 'org.bad.dependency:1.0.0',
@@ -142,6 +143,7 @@ def test_build_spark_submit_command(self):
             '--conf', 'parquet.compression=SNAPPY',
             '--files', 'hive-site.xml',
             '--py-files', 'sample_library.py',
+            '--archives', 'sample_archive.zip#SAMPLE',
             '--jars', 'parquet.jar',
             '--packages', 'com.databricks:spark-avro_2.11:3.2.0',
             '--exclude-packages', 'org.bad.dependency:1.0.0',
diff --git a/tests/contrib/operators/test_spark_submit_operator.py b/tests/contrib/operators/test_spark_submit_operator.py
index 38018d9d8cc3d..99d8d84c3f306 100644
--- a/tests/contrib/operators/test_spark_submit_operator.py
+++ b/tests/contrib/operators/test_spark_submit_operator.py
@@ -39,6 +39,7 @@ class TestSparkSubmitOperator(unittest.TestCase):
         },
         'files': 'hive-site.xml',
         'py_files': 'sample_library.py',
+        'archives': 'sample_archive.zip#SAMPLE',
         'driver_classpath': 'parquet.jar',
         'jars': 'parquet.jar',
         'packages': 'com.databricks:spark-avro_2.11:3.2.0',
@@ -88,6 +89,7 @@ def test_execute(self):
             },
             'files': 'hive-site.xml',
             'py_files': 'sample_library.py',
+            'archives': 'sample_archive.zip#SAMPLE',
             'driver_classpath': 'parquet.jar',
             'jars': 'parquet.jar',
             'packages': 'com.databricks:spark-avro_2.11:3.2.0',
@@ -118,6 +120,7 @@ def test_execute(self):
         self.assertEqual(expected_dict['conf'], operator._conf)
         self.assertEqual(expected_dict['files'], operator._files)
         self.assertEqual(expected_dict['py_files'], operator._py_files)
+        self.assertEqual(expected_dict['archives'], operator._archives)
         self.assertEqual(expected_dict['driver_classpath'], operator._driver_classpath)
         self.assertEqual(expected_dict['jars'], operator._jars)
         self.assertEqual(expected_dict['packages'], operator._packages)

From 09f7a89453b6a567290048f0115f50510c8c5f56 Mon Sep 17 00:00:00 2001
From: Mathew Wicks <thesuperzapper@users.noreply.github.com>
Date: Fri, 8 Feb 2019 22:54:11 +1300
Subject: [PATCH 553/808] [AIRFLOW-3547] Fixed Jinja templating in
 SparkSubmitOperator (#4347)

* [AIRFLOW-3547] Fixed Jinja templating in SparkSubmitOperator

This is a minor change to allow Jinja templating in parameters where it
makes sense for SparkSubmitOperator.

* [AIRFLOW-3547] Fixed Jinja templating in SparkSubmitOperator

This is a minor change to allow Jinja templating in parameters where it
makes sense for SparkSubmitOperator.
---
 .../operators/spark_submit_operator.py        | 33 +++++++++----------
 1 file changed, 16 insertions(+), 17 deletions(-)

diff --git a/airflow/contrib/operators/spark_submit_operator.py b/airflow/contrib/operators/spark_submit_operator.py
index 938fc34ca4191..f8ebe77171ad8 100644
--- a/airflow/contrib/operators/spark_submit_operator.py
+++ b/airflow/contrib/operators/spark_submit_operator.py
@@ -29,31 +29,30 @@ class SparkSubmitOperator(BaseOperator):
     It requires that the "spark-submit" binary is in the PATH or the spark-home is set
     in the extra on the connection.
 
-    :param application: The application that submitted as a job, either jar or
-        py file. (templated)
+    :param application: The application that submitted as a job, either jar or py file. (templated)
     :type application: str
-    :param conf: Arbitrary Spark configuration properties
+    :param conf: Arbitrary Spark configuration properties (templated)
     :type conf: dict
     :param conn_id: The connection id as configured in Airflow administration. When an
                     invalid connection_id is supplied, it will default to yarn.
     :type conn_id: str
     :param files: Upload additional files to the executor running the job, separated by a
                   comma. Files will be placed in the working directory of each executor.
-                  For example, serialized objects.
+                  For example, serialized objects. (templated)
     :type files: str
-    :param py_files: Additional python files used by the job, can be .zip, .egg or .py.
+    :param py_files: Additional python files used by the job, can be .zip, .egg or .py. (templated)
     :type py_files: str
-    :param jars: Submit additional jars to upload and place them in executor classpath.
-    :param driver_classpath: Additional, driver-specific, classpath settings.
-    :type driver_classpath: str
+    :param jars: Submit additional jars to upload and place them in executor classpath. (templated)
     :type jars: str
+    :param driver_classpath: Additional, driver-specific, classpath settings. (templated)
+    :type driver_classpath: str
     :param java_class: the main class of the Java application
     :type java_class: str
     :param packages: Comma-separated list of maven coordinates of jars to include on the
                      driver and executor classpaths. (templated)
     :type packages: str
     :param exclude_packages: Comma-separated list of maven coordinates of jars to exclude
-                             while resolving the dependencies provided in 'packages'
+                             while resolving the dependencies provided in 'packages' (templated)
     :type exclude_packages: str
     :param repositories: Comma-separated list of additional remote repositories to search
                          for the maven coordinates given with 'packages'
@@ -61,30 +60,30 @@ class SparkSubmitOperator(BaseOperator):
     :param total_executor_cores: (Standalone & Mesos only) Total cores for all executors
                                  (Default: all the available cores on the worker)
     :type total_executor_cores: int
-    :param executor_cores: (Standalone & YARN only) Number of cores per executor
-                           (Default: 2)
+    :param executor_cores: (Standalone & YARN only) Number of cores per executor (Default: 2)
     :type executor_cores: int
     :param executor_memory: Memory per executor (e.g. 1000M, 2G) (Default: 1G)
     :type executor_memory: str
     :param driver_memory: Memory allocated to the driver (e.g. 1000M, 2G) (Default: 1G)
     :type driver_memory: str
-    :param keytab: Full path to the file that contains the keytab
+    :param keytab: Full path to the file that contains the keytab (templated)
     :type keytab: str
-    :param principal: The name of the kerberos principal used for keytab
+    :param principal: The name of the kerberos principal used for keytab (templated)
     :type principal: str
     :param name: Name of the job (default airflow-spark). (templated)
     :type name: str
     :param num_executors: Number of executors to launch
     :type num_executors: int
-    :param application_args: Arguments for the application being submitted
+    :param application_args: Arguments for the application being submitted (templated)
     :type application_args: list
-    :param env_vars: Environment variables for spark-submit. It
-                     supports yarn and k8s mode too.
+    :param env_vars: Environment variables for spark-submit. It supports yarn and k8s mode too. (templated)
     :type env_vars: dict
     :param verbose: Whether to pass the verbose flag to spark-submit process for debugging
     :type verbose: bool
     """
-    template_fields = ('_name', '_application_args', '_packages')
+    template_fields = ('_application', '_conf', '_files', '_py_files', '_jars', '_driver_classpath',
+                       '_packages', '_exclude_packages', '_keytab', '_principal', '_name',
+                       '_application_args', '_env_vars')
     ui_color = WEB_COLORS['LIGHTORANGE']
 
     @apply_defaults

From dd698b7d1b648243a7199cee79195ef9e31ec1ce Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 29 Sep 2018 08:33:11 +0100
Subject: [PATCH 554/808] [AIRFLOW-XXX] Speed up DagBagTest cases (#3974)

I noticed that many of the tests of DagBags operate on a specific DAG
only, and don't need to load the example or test dags. By not loading
the dags we don't need to this shaves about 10-20s of test time.
---
 tests/models.py | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/tests/models.py b/tests/models.py
index 92376f135169d..297d42763ae81 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1346,12 +1346,19 @@ def with_all_tasks_removed(dag):
 
 
 class DagBagTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.empty_dir = mkdtemp()
+
+    @classmethod
+    def tearDownClass(cls):
+        os.rmdir(cls.empty_dir)
 
     def test_get_existing_dag(self):
         """
         test that were're able to parse some example DAGs and retrieve them
         """
-        dagbag = models.DagBag(include_examples=True)
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=True)
 
         some_expected_dag_ids = ["example_bash_operator",
                                  "example_branch_operator"]
@@ -1368,7 +1375,7 @@ def test_get_non_existing_dag(self):
         """
         test that retrieving a non existing dag id returns None without crashing
         """
-        dagbag = models.DagBag(include_examples=True)
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
 
         non_existing_dag_id = "non_existing_dag_id"
         self.assertIsNone(dagbag.get_dag(non_existing_dag_id))
@@ -1381,7 +1388,7 @@ def test_process_file_that_contains_multi_bytes_char(self):
         f.write('\u3042'.encode('utf8'))  # write multi-byte char (hiragana)
         f.flush()
 
-        dagbag = models.DagBag(include_examples=True)
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
         self.assertEqual([], dagbag.process_file(f.name))
 
     def test_zip_skip_log(self):
@@ -1403,7 +1410,7 @@ def test_zip(self):
         """
         test the loading of a DAG within a zip file that includes dependencies
         """
-        dagbag = models.DagBag()
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
         dagbag.process_file(os.path.join(TEST_DAGS_FOLDER, "test_zip.zip"))
         self.assertTrue(dagbag.get_dag("test_zip_dag"))
 
@@ -1413,7 +1420,7 @@ def test_process_file_cron_validity_check(self):
         as schedule interval can be identified
         """
         invalid_dag_files = ["test_invalid_cron.py", "test_zip_invalid_cron.zip"]
-        dagbag = models.DagBag(dag_folder=mkdtemp())
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
 
         self.assertEqual(len(dagbag.import_errors), 0)
         for d in invalid_dag_files:
@@ -1477,7 +1484,7 @@ def process_dag(self, create_dag):
         f.write(source.encode('utf8'))
         f.flush()
 
-        dagbag = models.DagBag(include_examples=False)
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
         found_dags = dagbag.process_file(f.name)
         return dagbag, found_dags, f.name
 
@@ -1788,7 +1795,7 @@ def test_process_file_with_none(self):
         """
         test that process_file can handle Nones
         """
-        dagbag = models.DagBag(include_examples=True)
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
 
         self.assertEqual([], dagbag.process_file(None))
 

From 351514905897e15e316b3e6ee812d085f4e3dcd8 Mon Sep 17 00:00:00 2001
From: Patouche <Patouche@users.noreply.github.com>
Date: Mon, 11 Feb 2019 17:40:21 +0100
Subject: [PATCH 555/808] [AIRFLOW-3801] Fix DagBag collect dags invocation to
 prevent examples to be loaded (#4677)

---
 airflow/models.py | 4 ++--
 tests/models.py   | 8 ++++++++
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 25a12bcd0c3e6..e7d39335f191e 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -279,7 +279,7 @@ def __init__(
         self.import_errors = {}
         self.has_logged = False
 
-        self.collect_dags(dag_folder, include_examples)
+        self.collect_dags(dag_folder=dag_folder, include_examples=include_examples)
 
     def size(self):
         """
@@ -534,7 +534,7 @@ def collect_dags(
         stats = []
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
-        for filepath in list_py_file_paths(dag_folder, include_examples):
+        for filepath in list_py_file_paths(dag_folder, include_examples=include_examples):
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(
diff --git a/tests/models.py b/tests/models.py
index 297d42763ae81..d45c0b870e780 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -1380,6 +1380,14 @@ def test_get_non_existing_dag(self):
         non_existing_dag_id = "non_existing_dag_id"
         self.assertIsNone(dagbag.get_dag(non_existing_dag_id))
 
+    def test_dont_load_example(self):
+        """
+        test that the example are not loaded
+        """
+        dagbag = models.DagBag(dag_folder=self.empty_dir, include_examples=False)
+
+        self.assertEqual(dagbag.size(), 0)
+
     def test_process_file_that_contains_multi_bytes_char(self):
         """
         test that we're able to parse file that contains multi-byte char

From 01adff1b15365d6cfb2565237c1dd44e7cb84170 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Mon, 11 Feb 2019 12:31:45 +0100
Subject: [PATCH 556/808] [AIRFLOW-3749] Fix Edit Dag Run page when using RBAC
 (#4613)

---
 airflow/www_rbac/templates/airflow/dag.html |  5 ++---
 airflow/www_rbac/views.py                   |  2 +-
 tests/www_rbac/test_views.py                | 16 +++++++++++++---
 3 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 404adeed7677f..0a964ec0edb59 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -491,9 +491,8 @@ <h4 class="modal-title" id="dagModalLabel">
       $.post(url);
     });
 
-    $('#btn_edit_dagrun').click(function(){
-      window.location = "{{ url_for('DagModelView.show', pk=id) }}";
-
+    $('#btn_edit_dagrun').click(function() {
+      window.location = "{{ url_for('DagModelView.edit', pk=dag.dag_id) }}";
     });
 
   </script>
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index e06f7c78c1cd0..70f056123aa43 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -2424,7 +2424,7 @@ class DagModelView(AirflowModelView):
 
     datamodel = AirflowModelView.CustomSQLAInterface(models.DagModel)
 
-    base_permissions = ['can_list', 'can_show']
+    base_permissions = ['can_list', 'can_show', 'can_edit']
 
     list_columns = ['dag_id', 'is_paused', 'last_scheduler_run',
                     'last_expired', 'scheduler_lock', 'fileloc', 'owners']
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index e295c8dbd3b83..7bfbe19f5eb35 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -21,18 +21,19 @@
 import io
 import json
 import logging.config
-import mock
 import os
 import shutil
 import sys
 import tempfile
 import unittest
 import urllib
-
 from datetime import timedelta
+from urllib.parse import quote_plus
+
+import mock
+from flask import url_for
 from flask._compat import PY2
 from parameterized import parameterized
-from urllib.parse import quote_plus
 from werkzeug.test import Client
 
 from airflow import configuration as conf
@@ -410,6 +411,15 @@ def test_xcom(self):
         resp = self.client.get(url, follow_redirects=True)
         self.check_content_in_response('XCom', resp)
 
+    def test_edit_dagrun_page(self):
+        resp = self.client.get('dagmodel/edit/example_bash_operator', follow_redirects=False)
+        self.assertEqual(resp.status_code, 200)
+
+    def test_edit_dagrun_url(self):
+        with self.app.test_request_context():
+            url = url_for('DagModelView.edit', pk='example_bash_operator')
+            self.assertEqual(url, '/dagmodel/edit/example_bash_operator')
+
     def test_rendered(self):
         url = ('rendered?task_id=runme_0&dag_id=example_bash_operator&execution_date={}'
                .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))

From 750ab5a4b114f3d226342749010325e49c7812c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antoni=20Smoli=C5=84ski?=
 <45817886+antonimaciej@users.noreply.github.com>
Date: Tue, 12 Feb 2019 23:46:20 +0100
Subject: [PATCH 557/808] [AIRFLOW-3821] Add replicas logic to GCP SQL example
 DAG (#4662)

---
 .../contrib/example_dags/example_gcp_sql.py   | 48 ++++++++++++++++++-
 docs/howto/operator.rst                       | 32 ++++++++++++-
 .../operators/test_gcp_sql_operator_system.py |  2 +
 3 files changed, 80 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_sql.py b/airflow/contrib/example_dags/example_gcp_sql.py
index 3ec9429a76f97..6c357f4b07e2f 100644
--- a/airflow/contrib/example_dags/example_gcp_sql.py
+++ b/airflow/contrib/example_dags/example_gcp_sql.py
@@ -58,6 +58,11 @@
 # Bodies below represent Cloud SQL instance resources:
 # https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances
 
+# [START howto_operator_cloudsql_create_arguments]
+FAILOVER_REPLICA_NAME = INSTANCE_NAME + "-failover-replica"
+READ_REPLICA_NAME = INSTANCE_NAME + "-read-replica"
+# [END howto_operator_cloudsql_create_arguments]
+
 # [START howto_operator_cloudsql_create_body]
 body = {
     "name": INSTANCE_NAME,
@@ -86,12 +91,15 @@
         },
         "pricingPlan": "PER_USE",
         "replicationType": "ASYNCHRONOUS",
-        "storageAutoResize": False,
+        "storageAutoResize": True,
         "storageAutoResizeLimit": 0,
         "userLabels": {
             "my-key": "my-value"
         }
     },
+    "failoverReplica": {
+        "name": FAILOVER_REPLICA_NAME
+    },
     "databaseVersion": "MYSQL_5_7",
     "region": "europe-west4",
 }
@@ -106,6 +114,19 @@
     "region": "europe-west4",
 }
 
+# [START howto_operator_cloudsql_create_replica]
+read_replica_body = {
+    "name": READ_REPLICA_NAME,
+    "settings": {
+        "tier": "db-n1-standard-1",
+    },
+    "databaseVersion": "MYSQL_5_7",
+    "region": "europe-west4",
+    "masterInstanceName": INSTANCE_NAME,
+}
+# [END howto_operator_cloudsql_create_replica]
+
+
 # [START howto_operator_cloudsql_patch_body]
 patch_body = {
     "name": INSTANCE_NAME,
@@ -194,6 +215,14 @@ def next_dep(task, prev):
     prev_task = sql_instance_create_task
     prev_task = next_dep(sql_instance_create_2_task, prev_task)
 
+    sql_instance_read_replica_create = CloudSqlInstanceCreateOperator(
+        project_id=GCP_PROJECT_ID,
+        body=read_replica_body,
+        instance=INSTANCE_NAME2,
+        task_id='sql_instance_read_replica_create'
+    )
+    prev_task = next_dep(sql_instance_read_replica_create, prev_task)
+
     # ############################################## #
     # ### MODIFYING INSTANCE AND ITS DATABASE ###### #
     # ############################################## #
@@ -356,6 +385,23 @@ def next_dep(task, prev):
     # ### INSTANCES TEAR DOWN ###################### #
     # ############################################## #
 
+    # [START howto_operator_cloudsql_replicas_delete]
+    sql_instance_failover_replica_delete_task = CloudSqlInstanceDeleteOperator(
+        project_id=GCP_PROJECT_ID,
+        instance=FAILOVER_REPLICA_NAME,
+        task_id='sql_instance_failover_replica_delete_task'
+    )
+
+    sql_instance_read_replica_delete_task = CloudSqlInstanceDeleteOperator(
+        project_id=GCP_PROJECT_ID,
+        instance=READ_REPLICA_NAME,
+        task_id='sql_instance_read_replica_delete_task'
+    )
+    # [END howto_operator_cloudsql_replicas_delete]
+
+    prev_task = next_dep(sql_instance_failover_replica_delete_task, prev_task)
+    prev_task = next_dep(sql_instance_read_replica_delete_task, prev_task)
+
     # [START howto_operator_cloudsql_delete]
     sql_instance_delete_task = CloudSqlInstanceDeleteOperator(
         project_id=GCP_PROJECT_ID,
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 538dd4d4fcacd..3f6cd628a402e 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1145,6 +1145,8 @@ CloudSqlInstanceDeleteOperator
 
 Deletes a Cloud SQL instance in Google Cloud Platform.
 
+It is also used for deleting read and failover replicas.
+
 For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`.
 
@@ -1170,6 +1172,15 @@ it will be retrieved from the GCP connection used. Both variants are shown:
     :start-after: [START howto_operator_cloudsql_delete]
     :end-before: [END howto_operator_cloudsql_delete]
 
+Note: If the instance has read or failover replicas you need to delete them before you delete the primary instance.
+Replicas are deleted the same way as primary instances:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_replicas_delete]
+    :end-before: [END howto_operator_cloudsql_replicas_delete]
+
 Templating
 """"""""""
 
@@ -1368,6 +1379,8 @@ CloudSqlInstanceCreateOperator
 
 Creates a new Cloud SQL instance in Google Cloud Platform.
 
+It is also used for creating read replicas.
+
 For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`.
 
@@ -1384,13 +1397,30 @@ Some arguments in the example DAG are taken from OS environment variables:
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
 
-Example body defining the instance:
+Some other arguments are created based on the arguments above:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_arguments]
+    :end-before: [END howto_operator_cloudsql_create_arguments]
+
+Example body defining the instance with failover replica:
 
 .. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_create_body]
     :end-before: [END howto_operator_cloudsql_create_body]
 
+Example body defining read replica for the instance above:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_replica]
+    :end-before: [END howto_operator_cloudsql_create_replica]
+
+Note: Failover replicas are created together with the instance in a single task.
+Read replicas need to be created in separate tasks.
+
 Using the operator
 """"""""""""""""""
 
diff --git a/tests/contrib/operators/test_gcp_sql_operator_system.py b/tests/contrib/operators/test_gcp_sql_operator_system.py
index 4fc7b56136cee..5508233cfe4cd 100644
--- a/tests/contrib/operators/test_gcp_sql_operator_system.py
+++ b/tests/contrib/operators/test_gcp_sql_operator_system.py
@@ -43,6 +43,8 @@ def tearDown(self):
         # Delete instances just in case the test failed and did not cleanup after itself
         self.gcp_authenticator.gcp_authenticate()
         try:
+            SQL_QUERY_TEST_HELPER.delete_instances(instance_suffix="-failover-replica")
+            SQL_QUERY_TEST_HELPER.delete_instances(instance_suffix="-read-replica")
             SQL_QUERY_TEST_HELPER.delete_instances()
             SQL_QUERY_TEST_HELPER.delete_instances(instance_suffix="2")
             SQL_QUERY_TEST_HELPER.delete_service_account_acls()

From 2e6ff4e002fc98a50c6325b39326e70da685883b Mon Sep 17 00:00:00 2001
From: Olivier Girardot <ogirardot@users.noreply.github.com>
Date: Wed, 13 Feb 2019 00:40:37 +0100
Subject: [PATCH 558/808] [AIRFLOW-3792] Fix validation in BQ for useLegacySQL
 & queryParameters (#4626)

---
 airflow/contrib/hooks/bigquery_hook.py    | 10 +++++-----
 tests/contrib/hooks/test_bigquery_hook.py | 23 +++++++++++++++++++++++
 2 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index f7ba4e5d69c0c..efc766852469a 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -572,10 +572,10 @@ def run_query(self,
         :param create_disposition: Specifies whether the job is allowed to
             create new tables.
         :type create_disposition: str
-        :param query_params a dictionary containing query parameter types and
+        :param query_params: a list of dictionary containing query parameter types and
             values, passed to BigQuery
-        :type query_params: dict
-        :param labels a dictionary containing labels for the job/query,
+        :type query_params: list
+        :param labels: a dictionary containing labels for the job/query,
             passed to BigQuery
         :type labels: dict
         :param schema_update_options: Allows the schema of the destination
@@ -675,7 +675,7 @@ def run_query(self,
             (sql, 'query', None, six.string_types),
             (priority, 'priority', 'INTERACTIVE', six.string_types),
             (use_legacy_sql, 'useLegacySql', self.use_legacy_sql, bool),
-            (query_params, 'queryParameters', None, dict),
+            (query_params, 'queryParameters', None, list),
             (udf_config, 'userDefinedFunctionResources', None, list),
             (maximum_billing_tier, 'maximumBillingTier', None, int),
             (maximum_bytes_billed, 'maximumBytesBilled', None, float),
@@ -728,7 +728,7 @@ def run_query(self,
                         'createDisposition': create_disposition,
                     })
 
-        if 'useLegacySql' in configuration['query'] and \
+        if 'useLegacySql' in configuration['query'] and configuration['query']['useLegacySql'] and\
                 'queryParameters' in configuration['query']:
             raise ValueError("Query parameters are not allowed "
                              "when using legacy SQL")
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index baec6cafced42..ecae0b6ffb347 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -281,6 +281,29 @@ def test_run_query_sql_dialect_override(self, run_with_config):
             args, kwargs = run_with_config.call_args
             self.assertIs(args[0]['query']['useLegacySql'], bool_val)
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_query_sql_dialect_legacy_with_query_params(self, run_with_config):
+        cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
+        params = [{
+            'name': "param_name",
+            'parameterType': {'type': "STRING"},
+            'parameterValue': {'value': "param_value"}
+        }]
+        cursor.run_query('query', use_legacy_sql=False, query_params=params)
+        args, kwargs = run_with_config.call_args
+        self.assertIs(args[0]['query']['useLegacySql'], False)
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_run_query_sql_dialect_legacy_with_query_params_fails(self, run_with_config):
+        cursor = hook.BigQueryBaseCursor(mock.Mock(), "project_id")
+        params = [{
+            'name': "param_name",
+            'parameterType': {'type': "STRING"},
+            'parameterValue': {'value': "param_value"}
+        }]
+        with self.assertRaises(ValueError):
+            cursor.run_query('query', use_legacy_sql=True, query_params=params)
+
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_api_resource_configs(self, run_with_config):
         for bool_val in [True, False]:

From 3b28dd596f89d01866bac64894abe9e6927586be Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Mon, 18 Feb 2019 09:19:33 +1100
Subject: [PATCH 559/808] [AIRFLOW-3799] Add compose method to
 GoogleCloudStorageHook (#4641)

---
 airflow/contrib/hooks/gcs_hook.py    | 48 ++++++++++++++++
 tests/contrib/hooks/test_gcs_hook.py | 82 ++++++++++++++++++++++++++++
 2 files changed, 130 insertions(+)

diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 02b7cd2cd38e5..a8442a1c3edd8 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -654,6 +654,54 @@ def insert_object_acl(self, bucket, object_name, entity, role, generation,
                 'Object ACL entry creation failed. Error was: {}'.format(ex.content)
             )
 
+    def compose(self, bucket, source_objects, destination_object, num_retries=5):
+        """
+        Composes a list of existing object into a new object in the same storage bucket
+
+        Currently it only supports up to 32 objects that can be concatenated
+        in a single operation
+
+        https://cloud.google.com/storage/docs/json_api/v1/objects/compose
+
+        :param bucket: The name of the bucket containing the source objects.
+            This is also the same bucket to store the composed destination object.
+        :type bucket: str
+        :param source_objects: The list of source objects that will be composed
+            into a single object.
+        :type source_objects: list
+        :param destination_object: The path of the object if given.
+        :type destination_object: str
+        """
+
+        if not source_objects or not len(source_objects):
+            raise ValueError('source_objects cannot be empty.')
+
+        if not bucket or not destination_object:
+            raise ValueError('bucket and destination_object cannot be empty.')
+
+        service = self.get_conn()
+
+        dict_source_objects = [{'name': source_object}
+                               for source_object in source_objects]
+        body = {
+            'sourceObjects': dict_source_objects
+        }
+
+        try:
+            self.log.info("Composing %s to %s in the bucket %s",
+                          source_objects, destination_object, bucket)
+            service \
+                .objects() \
+                .compose(destinationBucket=bucket,
+                         destinationObject=destination_object,
+                         body=body) \
+                .execute(num_retries=num_retries)
+            return True
+        except HttpError as ex:
+            if ex.resp['status'] == '404':
+                return False
+            raise
+
 
 def _parse_gcs_url(gsurl):
     """
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index 16a9afb0978b2..3dedc37516d50 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -343,6 +343,88 @@ def test_delete_nonexisting_object(self, mock_service):
 
         self.assertFalse(response)
 
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_compose(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_source_objects = ['test_object_1', 'test_object_2', 'test_object_3']
+        test_destination_object = 'test_object_composed'
+
+        method = (mock_service.return_value.objects.return_value.compose)
+
+        self.gcs_hook.compose(
+            bucket=test_bucket,
+            source_objects=test_source_objects,
+            destination_object=test_destination_object
+        )
+
+        body = {
+            'sourceObjects': [
+                {'name': 'test_object_1'},
+                {'name': 'test_object_2'},
+                {'name': 'test_object_3'}
+            ]
+        }
+
+        method.assert_called_once_with(
+            destinationBucket=test_bucket,
+            destinationObject=test_destination_object,
+            body=body
+        )
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_compose_with_empty_source_objects(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_source_objects = []
+        test_destination_object = 'test_object_composed'
+
+        with self.assertRaises(ValueError) as e:
+            self.gcs_hook.compose(
+                bucket=test_bucket,
+                source_objects=test_source_objects,
+                destination_object=test_destination_object
+            )
+
+        self.assertEqual(
+            str(e.exception),
+            'source_objects cannot be empty.'
+        )
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_compose_without_bucket(self, mock_service):
+        test_bucket = None
+        test_source_objects = ['test_object_1', 'test_object_2', 'test_object_3']
+        test_destination_object = 'test_object_composed'
+
+        with self.assertRaises(ValueError) as e:
+            self.gcs_hook.compose(
+                bucket=test_bucket,
+                source_objects=test_source_objects,
+                destination_object=test_destination_object
+            )
+
+        self.assertEqual(
+            str(e.exception),
+            'bucket and destination_object cannot be empty.'
+        )
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_compose_without_destination_object(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_source_objects = ['test_object_1', 'test_object_2', 'test_object_3']
+        test_destination_object = None
+
+        with self.assertRaises(ValueError) as e:
+            self.gcs_hook.compose(
+                bucket=test_bucket,
+                source_objects=test_source_objects,
+                destination_object=test_destination_object
+            )
+
+        self.assertEqual(
+            str(e.exception),
+            'bucket and destination_object cannot be empty.'
+        )
+
 
 class TestGoogleCloudStorageHookUpload(unittest.TestCase):
     def setUp(self):

From 057258e3ec3f585eb7afb6dd2857e9bf5e262103 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A9raud?= <galak75@users.noreply.github.com>
Date: Wed, 23 Jan 2019 08:02:04 -0500
Subject: [PATCH 560/808] [AIRFLOW-2508] Handle non string types in Operators
 templatized fields (#4292)

---
 airflow/models.py |  11 +----
 tests/models.py   | 117 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 119 insertions(+), 9 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index e7d39335f191e..b837438148701 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -39,7 +39,6 @@
 import jinja2
 import json
 import logging
-import numbers
 import os
 import pendulum
 import pickle
@@ -2879,25 +2878,19 @@ def render_template_from_field(self, attr, content, context, jinja_env):
         Renders a template from a field. If the field is a string, it will
         simply render the string and return the result. If it is a collection or
         nested set of collections, it will traverse the structure and render
-        all strings in it.
+        all elements in it. If the field has another type, it will return it as it is.
         """
         rt = self.render_template
         if isinstance(content, six.string_types):
             result = jinja_env.from_string(content).render(**context)
         elif isinstance(content, (list, tuple)):
             result = [rt(attr, e, context) for e in content]
-        elif isinstance(content, numbers.Number):
-            result = content
         elif isinstance(content, dict):
             result = {
                 k: rt("{}[{}]".format(attr, k), v, context)
                 for k, v in list(content.items())}
         else:
-            param_type = type(content)
-            msg = (
-                "Type '{param_type}' used for parameter '{attr}' is "
-                "not supported for templating").format(**locals())
-            raise AirflowException(msg)
+            result = content
         return result
 
     def render_template(self, attr, content, context):
diff --git a/tests/models.py b/tests/models.py
index d45c0b870e780..6c60ef956d0fd 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -31,6 +31,7 @@
 import time
 import unittest
 import urllib
+import uuid
 from tempfile import NamedTemporaryFile, mkdtemp
 
 import pendulum
@@ -395,6 +396,122 @@ def test_render_template_field(self):
         result = task.render_template('', '{{ foo }}', dict(foo='bar'))
         self.assertEqual(result, 'bar')
 
+    def test_render_template_list_field(self):
+        """Tests if render_template from a list field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        self.assertListEqual(
+            task.render_template('', ['{{ foo }}_1', '{{ foo }}_2'], {'foo': 'bar'}),
+            ['bar_1', 'bar_2']
+        )
+
+    def test_render_template_tuple_field(self):
+        """Tests if render_template from a tuple field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        # tuple is replaced by a list
+        self.assertListEqual(
+            task.render_template('', ('{{ foo }}_1', '{{ foo }}_2'), {'foo': 'bar'}),
+            ['bar_1', 'bar_2']
+        )
+
+    def test_render_template_dict_field(self):
+        """Tests if render_template from a dict field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        self.assertDictEqual(
+            task.render_template('', {'key1': '{{ foo }}_1', 'key2': '{{ foo }}_2'}, {'foo': 'bar'}),
+            {'key1': 'bar_1', 'key2': 'bar_2'}
+        )
+
+    def test_render_template_dict_field_with_templated_keys(self):
+        """Tests if render_template from a dict field works as expected:
+        dictionary keys are not templated"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        self.assertDictEqual(
+            task.render_template('', {'key_{{ foo }}_1': 1, 'key_2': '{{ foo }}_2'}, {'foo': 'bar'}),
+            {'key_{{ foo }}_1': 1, 'key_2': 'bar_2'}
+        )
+
+    def test_render_template_date_field(self):
+        """Tests if render_template from a date field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        self.assertEqual(
+            task.render_template('', datetime.date(2018, 12, 6), {'foo': 'bar'}),
+            datetime.date(2018, 12, 6)
+        )
+
+    def test_render_template_datetime_field(self):
+        """Tests if render_template from a datetime field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        self.assertEqual(
+            task.render_template('', datetime.datetime(2018, 12, 6, 10, 55), {'foo': 'bar'}),
+            datetime.datetime(2018, 12, 6, 10, 55)
+        )
+
+    def test_render_template_UUID_field(self):
+        """Tests if render_template from a UUID field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        random_uuid = uuid.uuid4()
+        self.assertIs(
+            task.render_template('', random_uuid, {'foo': 'bar'}),
+            random_uuid
+        )
+
+    def test_render_template_object_field(self):
+        """Tests if render_template from an object field works"""
+
+        dag = DAG('test-dag',
+                  start_date=DEFAULT_DATE)
+
+        with dag:
+            task = DummyOperator(task_id='op1')
+
+        test_object = object()
+        self.assertIs(
+            task.render_template('', test_object, {'foo': 'bar'}),
+            test_object
+        )
+
     def test_render_template_field_macro(self):
         """ Tests if render_template from a field works,
             if a custom filter was defined"""

From 71c6bb14a738eed8d3d836abb9265adfc979bd87 Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Sun, 17 Feb 2019 21:06:27 -0800
Subject: [PATCH 561/808] [AIRFLOW-3885] ~20x speed-up of slowest unit test
 (#4726)

The test `SchedulerJobTest.test_scheduler_start_date` is the slowest test,
taking ~5 minutes on average:

    >>> [success] 12.99% tests.test_jobs.SchedulerJobTest.test_scheduler_start_date: 295.1935s
	[success] 6.79% tests.test_jobs.SchedulerJobTest.test_scheduler_multiprocessing: 154.2304s
	[success] 6.72% tests.test_jobs.SchedulerJobTest.test_scheduler_task_start_date: 152.7215s
	[success] 4.34% tests.test_jobs.SchedulerJobTest.test_new_import_error_replaces_old: 98.7339s
	[success] 3.63% tests.test_jobs.SchedulerJobTest.test_remove_error_clears_import_error: 82.4062s

After setting the subdirectory and eliminating (I think) redundant scheduler
loops, the test time comes down to ~15 seconds.
---
 tests/jobs.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/tests/jobs.py b/tests/jobs.py
index cfb90ef765785..ecc0d55ced8e4 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -2333,7 +2333,8 @@ def test_scheduler_start_date(self):
             self.assertTrue(dag.start_date > datetime.datetime.utcnow())
 
             scheduler = SchedulerJob(dag_id,
-                                     num_runs=2)
+                                     subdir=os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py'),
+                                     num_runs=1)
             scheduler.run()
 
             # zero tasks ran
@@ -2357,7 +2358,8 @@ def test_scheduler_start_date(self):
             session.commit()
 
             scheduler = SchedulerJob(dag_id,
-                                     num_runs=2)
+                                     subdir=os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py'),
+                                     num_runs=1)
             scheduler.run()
 
             # still one task

From 85f0cf3cd9dea9c55f24da37c7c2f78f0d4bc34d Mon Sep 17 00:00:00 2001
From: Dima Kamalov <42555784+dima-asana@users.noreply.github.com>
Date: Wed, 13 Feb 2019 23:56:16 -0800
Subject: [PATCH 562/808] [AIRFLOW-3702] Add backfill option to run backwards
 (#4676)

---
 airflow/bin/cli.py                 | 10 ++++-
 airflow/executors/base_executor.py |  3 +-
 airflow/jobs.py                    | 19 ++++++++-
 airflow/models.py                  |  7 ++++
 tests/jobs.py                      | 62 +++++++++++++++++++++++++++++-
 5 files changed, 96 insertions(+), 5 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 7bb2d8055168f..8019112df4dd0 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -218,6 +218,7 @@ def backfill(args, dag=None):
             verbose=args.verbose,
             conf=run_conf,
             rerun_failed_tasks=args.rerun_failed_tasks,
+            run_backwards=args.run_backwards
         )
 
 
@@ -1576,6 +1577,13 @@ class CLIFactory(object):
                 "all the failed tasks for the backfill date range "
                 "instead of throwing exceptions"),
             "store_true"),
+        'run_backwards': Arg(
+            ("-B", "--run_backwards",),
+            (
+                "if set, the backfill will run tasks from the most "
+                "recent day first.  if there are tasks that depend_on_past "
+                "this option will throw an exception"),
+            "store_true"),
 
         # list_tasks
         'tree': Arg(("-t", "--tree"), "Tree view", "store_true"),
@@ -1921,7 +1929,7 @@ class CLIFactory(object):
                 'mark_success', 'local', 'donot_pickle',
                 'bf_ignore_dependencies', 'bf_ignore_first_depends_on_past',
                 'subdir', 'pool', 'delay_on_limit', 'dry_run', 'verbose', 'conf',
-                'reset_dag_run', 'rerun_failed_tasks',
+                'reset_dag_run', 'rerun_failed_tasks', 'run_backwards'
             )
         }, {
             'func': list_dag_runs,
diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index 25bfe3cd91064..c61154c474a47 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -18,6 +18,7 @@
 # under the License.
 
 from builtins import range
+from collections import OrderedDict
 
 from airflow import configuration
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -39,7 +40,7 @@ def __init__(self, parallelism=PARALLELISM):
         :type parallelism: int
         """
         self.parallelism = parallelism
-        self.queued_tasks = {}
+        self.queued_tasks = OrderedDict()
         self.running = {}
         self.event_buffer = {}
 
diff --git a/airflow/jobs.py b/airflow/jobs.py
index f6f0ef111737d..17a677b34023d 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -30,7 +30,7 @@
 import sys
 import threading
 import time
-from collections import defaultdict
+from collections import defaultdict, OrderedDict
 from time import sleep
 
 import six
@@ -1833,7 +1833,7 @@ def __init__(self,
             :param total_runs: Number of total dag runs able to run
             :type total_runs: int
             """
-            self.to_run = to_run or dict()
+            self.to_run = to_run or OrderedDict()
             self.running = running or dict()
             self.skipped = skipped or set()
             self.succeeded = succeeded or set()
@@ -1859,6 +1859,7 @@ def __init__(
             verbose=False,
             conf=None,
             rerun_failed_tasks=False,
+            run_backwards=False,
             *args, **kwargs):
         """
         :param dag: DAG object.
@@ -1885,6 +1886,8 @@ def __init__(
         :param rerun_failed_tasks: flag to whether to
                                    auto rerun the failed task in backfill
         :type rerun_failed_tasks: bool
+        :param run_backwards: Whether to process the dates from most to least recent
+        :type run_backwards bool
         :param args:
         :param kwargs:
         """
@@ -1901,6 +1904,7 @@ def __init__(
         self.verbose = verbose
         self.conf = conf
         self.rerun_failed_tasks = rerun_failed_tasks
+        self.run_backwards = run_backwards
         super(BackfillJob, self).__init__(*args, **kwargs)
 
     def _update_counters(self, ti_status):
@@ -2141,8 +2145,10 @@ def _process_backfill_task_instances(self,
             # or leaf to root, as otherwise tasks might be
             # determined deadlocked while they are actually
             # waiting for their upstream to finish
+
             for task in self.dag.topological_sort():
                 for key, ti in list(ti_status.to_run.items()):
+
                     if task.task_id != ti.task_id:
                         continue
 
@@ -2228,6 +2234,7 @@ def _process_backfill_task_instances(self,
                                 self.log.debug('Sending %s to executor', ti)
                                 # Skip scheduled state, we are executing immediately
                                 ti.state = State.QUEUED
+                                ti.queued_dttm = timezone.utcnow() if not ti.queued_dttm else ti.queued_dttm
                                 session.merge(ti)
 
                                 cfg_path = None
@@ -2409,6 +2416,14 @@ def _execute(self, session=None):
         # Get intervals between the start/end dates, which will turn into dag runs
         run_dates = self.dag.get_run_dates(start_date=start_date,
                                            end_date=self.bf_end_date)
+        if self.run_backwards:
+            tasks_that_depend_on_past = [t.task_id for t in self.dag.task_dict.values() if t.depends_on_past]
+            if tasks_that_depend_on_past:
+                raise AirflowException(
+                    'You cannot backfill backwards because one or more tasks depend_on_past: {}'.format(
+                        ",".join(tasks_that_depend_on_past)))
+            run_dates = run_dates[::-1]
+
         if len(run_dates) == 0:
             self.log.info("No run dates were found for the given dates and dag interval.")
             return
diff --git a/airflow/models.py b/airflow/models.py
index b837438148701..f28138e40ad6c 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -4274,6 +4274,7 @@ def run(
             verbose=False,
             conf=None,
             rerun_failed_tasks=False,
+            run_backwards=False,
     ):
         """
         Runs the DAG.
@@ -4304,6 +4305,11 @@ def run(
         :type verbose: bool
         :param conf: user defined dictionary passed from CLI
         :type conf: dict
+        :param rerun_failed_tasks:
+        :type: bool
+        :param run_backwards:
+        :type: bool
+
         """
         from airflow.jobs import BackfillJob
         if not executor and local:
@@ -4324,6 +4330,7 @@ def run(
             verbose=verbose,
             conf=conf,
             rerun_failed_tasks=rerun_failed_tasks,
+            run_backwards=run_backwards,
         )
         job.run()
 
diff --git a/tests/jobs.py b/tests/jobs.py
index ecc0d55ced8e4..90e9f64820188 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -617,6 +617,41 @@ def test_cli_backfill_depends_on_past(self):
         self.assertEqual(ti.state, State.SUCCESS)
         dag.clear()
 
+    def test_cli_backfill_depends_on_past_backwards(self):
+        """
+        Test that CLI respects -B argument and raises on interaction with depends_on_past
+        """
+        dag_id = 'test_depends_on_past'
+        start_date = DEFAULT_DATE + datetime.timedelta(days=1)
+        end_date = start_date + datetime.timedelta(days=1)
+        args = [
+            'backfill',
+            dag_id,
+            '-l',
+            '-s',
+            start_date.isoformat(),
+            '-e',
+            end_date.isoformat(),
+            '-I'
+        ]
+        dag = self.dagbag.get_dag(dag_id)
+        dag.clear()
+
+        cli.backfill(self.parser.parse_args(args + ['-I']))
+        ti = TI(dag.get_task('test_dop_task'), end_date)
+        ti.refresh_from_db()
+        # runs fine forwards
+        self.assertEqual(ti.state, State.SUCCESS)
+
+        # raises backwards
+        expected_msg = 'You cannot backfill backwards because one or more tasks depend_on_past: {}'.format(
+            'test_dop_task')
+        self.assertRaisesRegexp(
+            AirflowException,
+            expected_msg,
+            cli.backfill,
+            self.parser.parse_args(args + ['-B']))
+
     def test_cli_receives_delay_arg(self):
         """
         Tests that the --delay argument is passed correctly to the BackfillJob
@@ -1141,7 +1176,8 @@ def get_test_dag_for_backfill(schedule_interval=None):
             DummyOperator(
                 task_id='dummy',
                 dag=dag,
-                owner='airflow')
+                owner='airflow',
+            )
             return dag
 
         test_dag = get_test_dag_for_backfill()
@@ -1158,6 +1194,30 @@ def get_test_dag_for_backfill(schedule_interval=None):
                              start_date=DEFAULT_DATE - datetime.timedelta(hours=3),
                              end_date=DEFAULT_DATE,))
 
+    def test_backfill_run_backwards(self):
+        dag = self.dagbag.get_dag("test_start_date_scheduling")
+        dag.clear()
+
+        job = BackfillJob(
+            dag=dag,
+            start_date=DEFAULT_DATE,
+            end_date=DEFAULT_DATE + datetime.timedelta(days=5),
+            run_backwards=True
+        )
+        job.run()
+
+        session = settings.Session()
+        tis = session.query(TI).filter(
+            TI.dag_id == 'test_start_date_scheduling' and TI.task_id == 'dummy'
+        ).order_by(TI.execution_date).all()
+
+        queued_times = [ti.queued_dttm for ti in tis]
+        self.assertTrue(queued_times == sorted(queued_times, reverse=True))
+        self.assertTrue(all([ti.state == State.SUCCESS for ti in tis]))
+
+        dag.clear()
+        session.close()
+
 
 class LocalTaskJobTest(unittest.TestCase):
     def setUp(self):

From e6fcd29a6a5042139e5b118b123d230a05a4dec4 Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Mon, 18 Feb 2019 17:13:45 -0800
Subject: [PATCH 563/808] [AIRFLOW-3885] ~2.5x speed-up for backfill tests
 (#4731)

The BackfillJobTest suite now takes 57 seconds vs. the baseline of 147
seconds on my laptop.

A couple of optimizations:

- Don't sleep() if we are running unit tests
- Don't backfill more DagRuns than needed (reduced from 5 to 2, since we
  only need 2 DagRuns to verify that we can run backwards)

I've also made a few tests reentrant by clearing out the Pool, DagRun,
and TaskInstance table between runs.
---
 airflow/jobs.py | 20 +++++++++++---------
 tests/jobs.py   |  7 ++++++-
 2 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 17a677b34023d..55b1b92bfa8e3 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -165,15 +165,17 @@ def heartbeat(self):
             if job.state == State.SHUTDOWN:
                 self.kill()
 
-            # Figure out how long to sleep for
-            sleep_for = 0
-            if job.latest_heartbeat:
-                sleep_for = max(
-                    0,
-                    self.heartrate - (timezone.utcnow() -
-                                      job.latest_heartbeat).total_seconds())
-
-            sleep(sleep_for)
+            is_unit_test = conf.getboolean('core', 'unit_test_mode')
+            if not is_unit_test:
+                # Figure out how long to sleep for
+                sleep_for = 0
+                if job.latest_heartbeat:
+                    seconds_remaining = self.heartrate - \
+                        (timezone.utcnow() - job.latest_heartbeat)\
+                        .total_seconds()
+                    sleep_for = max(0, seconds_remaining)
+
+                sleep(sleep_for)
 
             # Update last heartbeat time
             with create_session() as session:
diff --git a/tests/jobs.py b/tests/jobs.py
index 90e9f64820188..8581c03fd0112 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -130,6 +130,11 @@ def abort():
 class BackfillJobTest(unittest.TestCase):
 
     def setUp(self):
+        with create_session() as session:
+            session.query(models.DagRun).delete()
+            session.query(models.Pool).delete()
+            session.query(models.TaskInstance).delete()
+
         self.parser = cli.CLIFactory.get_parser()
         self.dagbag = DagBag(include_examples=True)
 
@@ -1201,7 +1206,7 @@ def test_backfill_run_backwards(self):
         job = BackfillJob(
             dag=dag,
             start_date=DEFAULT_DATE,
-            end_date=DEFAULT_DATE + datetime.timedelta(days=5),
+            end_date=DEFAULT_DATE + datetime.timedelta(days=1),
             run_backwards=True
         )
         job.run()

From be7121b89416201df599da7f722738f29c0f6393 Mon Sep 17 00:00:00 2001
From: yrqls21 <yrqls21@gmail.com>
Date: Tue, 11 Sep 2018 09:12:18 -0700
Subject: [PATCH 564/808] [AIRFLOW-2156] Parallelize Celery Executor task state
 fetching (#3830)

---
 UPDATING.md                                   |  10 +-
 airflow/config_templates/default_airflow.cfg  |   4 +
 airflow/config_templates/default_test.cfg     |   1 +
 airflow/executors/celery_executor.py          | 115 ++++++++++++++++--
 scripts/ci/airflow_travis.cfg                 |   1 +
 .../kube/templates/configmaps.template.yaml   |   4 +
 tests/executors/test_celery_executor.py       |  22 ++++
 7 files changed, 142 insertions(+), 15 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index f57e311b6d438..5efb4dfda110a 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -38,6 +38,11 @@ It is no longer required to set one of the environment variables to avoid
 a GPL dependency. Airflow will now always use text-unidecode if unidecode
 was not installed before.
 
+### new `sync_parallelism` config option in celery section
+
+The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
+fetch celery task state in parallel. Default value is max(1, number of cores - 1)
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
@@ -92,11 +97,6 @@ then you need to change it like this
 The DAG parsing manager log now by default will be log into a file, where its location is
 controlled by the new `dag_processor_manager_log_location` config option in core section.
 
-### new `sync_parallelism` config option in celery section
-
-The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
-fetch celery task state in parallel. Default value is max(1, number of cores - 1)
-
 ### StatsD Metrics
 
 The `scheduler_heartbeat` metric has been changed from a gauge to a counter. Each loop of the scheduler will increment the counter by 1. This provides a higher degree of visibility and allows for better integration with Prometheus using the [StatsD Exporter](https://github.com/prometheus/statsd_exporter). Scheduler upness can be determined by graphing and alerting using a rate. If the scheduler goes down, the rate will drop to 0.
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index d2ecc3e5aa559..c0c772cc6adbf 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -403,6 +403,10 @@ flower_basic_auth =
 # Default queue that tasks get assigned to and that worker listen on.
 default_queue = default
 
+# How many processes CeleryExecutor uses to sync task state.
+# 0 means to use max(1, number of cores - 1) processes.
+sync_parallelism = 0
+
 # Import path for celery configuration options
 celery_config_options = airflow.config_templates.default_celery.DEFAULT_CELERY_CONFIG
 
diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index 887d7a9c8fedd..4a72190bb1ee6 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -97,6 +97,7 @@ result_backend = db+mysql://airflow:airflow@localhost:3306/airflow
 flower_host = 0.0.0.0
 flower_port = 5555
 default_queue = default
+sync_parallelism = 0
 
 [mesos]
 master = localhost:5050
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 7916eda122c57..cec4396142e52 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -17,20 +17,26 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import math
+import os
 import subprocess
 import time
-import os
+import traceback
+from multiprocessing import Pool, cpu_count
 
 from celery import Celery
 from celery import states as celery_states
 
+from airflow import configuration
 from airflow.config_templates.default_celery import DEFAULT_CELERY_CONFIG
 from airflow.exceptions import AirflowException
 from airflow.executors.base_executor import BaseExecutor
-from airflow import configuration
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.module_loading import import_string
 
+# Make it constant for unit test.
+CELERY_FETCH_ERR_MSG_HEADER = 'Error fetching Celery task state'
+
 '''
 To start the celery worker, run the command:
 airflow worker
@@ -63,6 +69,42 @@ def execute_command(command):
         raise AirflowException('Celery command failed')
 
 
+class ExceptionWithTraceback(object):
+    """
+    Wrapper class used to propogate exceptions to parent processes from subprocesses.
+    :param exception: The exception to wrap
+    :type exception: Exception
+    :param traceback: The stacktrace to wrap
+    :type traceback: str
+    """
+
+    def __init__(self, exception, exception_traceback):
+        self.exception = exception
+        self.traceback = exception_traceback
+
+
+def fetch_celery_task_state(celery_task):
+    """
+    Fetch and return the state of the given celery task. The scope of this function is
+    global so that it can be called by subprocesses in the pool.
+    :param celery_task: a tuple of the Celery task key and the async Celery object used
+                        to fetch the task's state
+    :type celery_task: (str, celery.result.AsyncResult)
+    :return: a tuple of the Celery task key and the Celery state of the task
+    :rtype: (str, str)
+    """
+
+    try:
+        # Accessing state property of celery task will make actual network request
+        # to get the current state of the task.
+        res = (celery_task[0], celery_task[1].state)
+    except Exception as e:
+        exception_traceback = "Celery Task ID: {}\n{}".format(celery_task[0],
+                                                              traceback.format_exc())
+        res = ExceptionWithTraceback(e, exception_traceback)
+    return res
+
+
 class CeleryExecutor(BaseExecutor):
     """
     CeleryExecutor is recommended for production use of Airflow. It allows
@@ -72,10 +114,27 @@ class CeleryExecutor(BaseExecutor):
     vast amounts of messages, while providing operations with the tools
     required to maintain such a system.
     """
-    def start(self):
+
+    def __init__(self):
+        super(CeleryExecutor, self).__init__()
+
+        # Celery doesn't support querying the state of multiple tasks in parallel
+        # (which can become a bottleneck on bigger clusters) so we use
+        # a multiprocessing pool to speed this up.
+        # How many worker processes are created for checking celery task state.
+        self._sync_parallelism = configuration.getint('celery', 'SYNC_PARALLELISM')
+        if self._sync_parallelism == 0:
+            self._sync_parallelism = max(1, cpu_count() - 1)
+
+        self._sync_pool = None
         self.tasks = {}
         self.last_state = {}
 
+    def start(self):
+        self.log.debug(
+            'Starting Celery Executor using {} processes for syncing'.format(
+                self._sync_parallelism))
+
     def execute_async(self, key, command,
                       queue=DEFAULT_CELERY_CONFIG['task_default_queue'],
                       executor_config=None):
@@ -85,11 +144,48 @@ def execute_async(self, key, command,
             args=[command], queue=queue)
         self.last_state[key] = celery_states.PENDING
 
+    def _num_tasks_per_process(self):
+        """
+        How many Celery tasks should be sent to each worker process.
+        :return: Number of tasks that should be used per process
+        :rtype: int
+        """
+        return max(1,
+                   int(math.ceil(1.0 * len(self.tasks) / self._sync_parallelism)))
+
     def sync(self):
-        self.log.debug("Inquiring about %s celery task(s)", len(self.tasks))
-        for key, task in list(self.tasks.items()):
+        num_processes = min(len(self.tasks), self._sync_parallelism)
+        if num_processes == 0:
+            self.log.debug("No task to query celery, skipping sync")
+            return
+
+        self.log.debug("Inquiring about %s celery task(s) using %s processes",
+                       len(self.tasks), num_processes)
+
+        # Recreate the process pool each sync in case processes in the pool die
+        self._sync_pool = Pool(processes=num_processes)
+
+        # Use chunking instead of a work queue to reduce context switching since tasks are
+        # roughly uniform in size
+        chunksize = self._num_tasks_per_process()
+
+        self.log.debug("Waiting for inquiries to complete...")
+        task_keys_to_states = self._sync_pool.map(
+            fetch_celery_task_state,
+            self.tasks.items(),
+            chunksize=chunksize)
+        self._sync_pool.close()
+        self._sync_pool.join()
+        self.log.debug("Inquiries completed.")
+
+        for key_and_state in task_keys_to_states:
+            if isinstance(key_and_state, ExceptionWithTraceback):
+                self.log.error(
+                    CELERY_FETCH_ERR_MSG_HEADER + ", ignoring it:{}\n{}\n".format(
+                        key_and_state.exception, key_and_state.traceback))
+                continue
+            key, state = key_and_state
             try:
-                state = task.state
                 if self.last_state[key] != state:
                     if state == celery_states.SUCCESS:
                         self.success(key)
@@ -104,11 +200,10 @@ def sync(self):
                         del self.tasks[key]
                         del self.last_state[key]
                     else:
-                        self.log.info("Unexpected state: %s", state)
+                        self.log.info("Unexpected state: " + state)
                         self.last_state[key] = state
-            except Exception as e:
-                self.log.error("Error syncing the celery executor, ignoring it:")
-                self.log.exception(e)
+            except Exception:
+                self.log.exception("Error syncing the Celery executor, ignoring it.")
 
     def end(self, synchronous=False):
         if synchronous:
diff --git a/scripts/ci/airflow_travis.cfg b/scripts/ci/airflow_travis.cfg
index 9a0c6184cef1b..7b6d3622804bf 100644
--- a/scripts/ci/airflow_travis.cfg
+++ b/scripts/ci/airflow_travis.cfg
@@ -59,6 +59,7 @@ broker_url = amqp://guest:guest@rabbitmq:5672/
 result_backend = # overridden by tox.ini
 flower_port = 5555
 default_queue = default
+sync_parallelism = 0
 
 [celery_broker_transport_options]
 visibility_timeout = 21600
diff --git a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
index dd699228ef89e..7761a6bcdc089 100644
--- a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
+++ b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
@@ -273,6 +273,10 @@ data:
     # Default queue that tasks get assigned to and that worker listen on.
     default_queue = default
 
+    # How many processes CeleryExecutor uses to sync task state.
+    # 0 means to use max(1, number of cores - 1) processes.
+    sync_parallelism = 0
+
     # Import path for celery configuration options
     celery_config_options = airflow.config_templates.default_celery.DEFAULT_CELERY_CONFIG
 
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 8a06e1560266f..9a7f19f69da3d 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -18,10 +18,12 @@
 # under the License.
 import sys
 import unittest
+import mock
 from celery.contrib.testing.worker import start_worker
 
 from airflow.executors.celery_executor import CeleryExecutor
 from airflow.executors.celery_executor import app
+from airflow.executors.celery_executor import CELERY_FETCH_ERR_MSG_HEADER
 from airflow.utils.state import State
 
 from airflow import configuration
@@ -62,6 +64,26 @@ def test_celery_integration(self):
         self.assertNotIn('success', executor.last_state)
         self.assertNotIn('fail', executor.last_state)
 
+    def test_exception_propagation(self):
+        @app.task
+        def fake_celery_task():
+            return {}
+
+        mock_log = mock.MagicMock()
+        executor = CeleryExecutor()
+        executor._log = mock_log
+
+        executor.tasks = {'key': fake_celery_task()}
+        executor.sync()
+        mock_log.error.assert_called_once()
+        args, kwargs = mock_log.error.call_args_list[0]
+        log = args[0]
+        # Result of queuing is not a celery task but a dict,
+        # and it should raise AttributeError and then get propagated
+        # to the error log.
+        self.assertIn(CELERY_FETCH_ERR_MSG_HEADER, log)
+        self.assertIn('AttributeError', log)
+
 
 if __name__ == '__main__':
     unittest.main()

From ad2bc2c3400bd55fa560f43a718d0db9cc9abbdc Mon Sep 17 00:00:00 2001
From: bolkedebruin <bolkedebruin@users.noreply.github.com>
Date: Wed, 15 Aug 2018 07:13:02 +0200
Subject: [PATCH 565/808] [AIRFLOW-2888] Remove shell=True and bash from task
 launch (#3740)

shell=True is a security risk. Bash is not required to launch
tasks and will consume extra resources.
---
 UPDATING.md                                               | 7 +++++++
 airflow/config_templates/default_airflow.cfg              | 2 +-
 airflow/contrib/executors/mesos_executor.py               | 2 +-
 airflow/contrib/kubernetes/worker_configuration.py        | 3 +--
 airflow/contrib/task_runner/cgroup_task_runner.py         | 2 +-
 airflow/executors/base_executor.py                        | 2 +-
 airflow/executors/celery_executor.py                      | 4 ++--
 airflow/executors/local_executor.py                       | 3 +--
 airflow/executors/sequential_executor.py                  | 2 +-
 airflow/jobs.py                                           | 4 ++--
 airflow/task/task_runner/__init__.py                      | 6 +++---
 airflow/task/task_runner/base_task_runner.py              | 4 +++-
 .../{bash_task_runner.py => standard_task_runner.py}      | 8 ++++----
 tests/executors/dask_executor.py                          | 4 ++--
 tests/executors/test_celery_executor.py                   | 4 ++--
 tests/executors/test_local_executor.py                    | 6 +++---
 ...t_bash_task_runner.py => test_standard_task_runner.py} | 8 ++++----
 17 files changed, 39 insertions(+), 32 deletions(-)
 rename airflow/task/task_runner/{bash_task_runner.py => standard_task_runner.py} (85%)
 rename tests/task/task_runner/{test_bash_task_runner.py => test_standard_task_runner.py} (94%)

diff --git a/UPDATING.md b/UPDATING.md
index 5efb4dfda110a..89f33543395ba 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -43,6 +43,13 @@ was not installed before.
 The new `sync_parallelism` config option will control how many processes CeleryExecutor will use to
 fetch celery task state in parallel. Default value is max(1, number of cores - 1)
 
+### Rename of BashTaskRunner to StandardTaskRunner
+
+BashTaskRunner has been renamed to StandardTaskRunner. It is the default task runner
+so you might need to update your config.
+
+`task_runner = StandardTaskRunner`
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index c0c772cc6adbf..ac3ae06f55346 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -142,7 +142,7 @@ donot_pickle = False
 dagbag_import_timeout = 30
 
 # The class to use for running task instances in a subprocess
-task_runner = BashTaskRunner
+task_runner = StandardTaskRunner
 
 # If set, tasks without a `run_as_user` argument will be run with this user
 # Can be used to de-elevate a sudo user running Airflow when executing tasks
diff --git a/airflow/contrib/executors/mesos_executor.py b/airflow/contrib/executors/mesos_executor.py
index ff974ffc3c080..0609d71cf20b9 100644
--- a/airflow/contrib/executors/mesos_executor.py
+++ b/airflow/contrib/executors/mesos_executor.py
@@ -162,7 +162,7 @@ def resourceOffers(self, driver, offers):
 
                 command = mesos_pb2.CommandInfo()
                 command.shell = True
-                command.value = cmd
+                command.value = " ".join(cmd)
                 task.command.MergeFrom(command)
 
                 # If docker image for airflow is specified in config then pull that
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 21cbdd6c7fc0f..62c6ef68b03b3 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -238,8 +238,7 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             image=kube_executor_config.image or self.kube_config.kube_image,
             image_pull_policy=(kube_executor_config.image_pull_policy or
                                self.kube_config.kube_image_pull_policy),
-            cmds=['bash', '-cx', '--'],
-            args=[airflow_command],
+            cmds=airflow_command,
             labels={
                 'airflow-worker': worker_uuid,
                 'dag_id': dag_id,
diff --git a/airflow/contrib/task_runner/cgroup_task_runner.py b/airflow/contrib/task_runner/cgroup_task_runner.py
index ef51b665d9bed..4662b0fe82f5a 100644
--- a/airflow/contrib/task_runner/cgroup_task_runner.py
+++ b/airflow/contrib/task_runner/cgroup_task_runner.py
@@ -117,7 +117,7 @@ def start(self):
                 "creating another one",
                 cgroups.get("cpu"), cgroups.get("memory")
             )
-            self.process = self.run_command(['bash', '-c'], join_args=True)
+            self.process = self.run_command()
             return
 
         # Create a unique cgroup name
diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index c61154c474a47..7bf6470543026 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -76,7 +76,7 @@ def queue_task_instance(
         # cfg_path is needed to propagate the config values if using impersonation
         # (run_as_user), given that there are different code paths running tasks.
         # For a long term solution we need to address AIRFLOW-1986
-        command = task_instance.command(
+        command = task_instance.command_as_list(
             local=True,
             mark_success=mark_success,
             ignore_all_deps=ignore_all_deps,
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index cec4396142e52..2580e2900d6e3 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -60,7 +60,7 @@ def execute_command(command):
     log.info("Executing command in Celery: %s", command)
     env = os.environ.copy()
     try:
-        subprocess.check_call(command, shell=True, stderr=subprocess.STDOUT,
+        subprocess.check_call(command, stderr=subprocess.STDOUT,
                               close_fds=True, env=env)
     except subprocess.CalledProcessError as e:
         log.exception('execute_command encountered a CalledProcessError')
@@ -141,7 +141,7 @@ def execute_async(self, key, command,
         self.log.info("[celery] queuing {key} through celery, "
                       "queue={queue}".format(**locals()))
         self.tasks[key] = execute_command.apply_async(
-            args=[command], queue=queue)
+            args=command, queue=queue)
         self.last_state[key] = celery_states.PENDING
 
     def _num_tasks_per_process(self):
diff --git a/airflow/executors/local_executor.py b/airflow/executors/local_executor.py
index cbb2fd4ea0e33..3e622da0531f3 100644
--- a/airflow/executors/local_executor.py
+++ b/airflow/executors/local_executor.py
@@ -82,9 +82,8 @@ def execute_work(self, key, command):
         if key is None:
             return
         self.log.info("%s running %s", self.__class__.__name__, command)
-        command = "exec bash -c '{0}'".format(command)
         try:
-            subprocess.check_call(command, shell=True, close_fds=True)
+            subprocess.check_call(command, close_fds=True)
             state = State.SUCCESS
         except subprocess.CalledProcessError as e:
             state = State.FAILED
diff --git a/airflow/executors/sequential_executor.py b/airflow/executors/sequential_executor.py
index 9c0d8ecf0ca6f..1542e3318eb28 100644
--- a/airflow/executors/sequential_executor.py
+++ b/airflow/executors/sequential_executor.py
@@ -45,7 +45,7 @@ def sync(self):
             self.log.info("Executing command: %s", command)
 
             try:
-                subprocess.check_call(command, shell=True, close_fds=True)
+                subprocess.check_call(command, close_fds=True)
                 self.change_state(key, State.SUCCESS)
             except subprocess.CalledProcessError as e:
                 self.change_state(key, State.FAILED)
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 55b1b92bfa8e3..3e44c1a9044a1 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1322,7 +1322,7 @@ def _enqueue_task_instances_with_queued_state(self, simple_dag_bag, task_instanc
         # actually enqueue them
         for task_instance in task_instances:
             simple_dag = simple_dag_bag.get_dag(task_instance.dag_id)
-            command = " ".join(TI.generate_command(
+            command = TI.generate_command(
                 task_instance.dag_id,
                 task_instance.task_id,
                 task_instance.execution_date,
@@ -1334,7 +1334,7 @@ def _enqueue_task_instances_with_queued_state(self, simple_dag_bag, task_instanc
                 ignore_ti_state=False,
                 pool=task_instance.pool,
                 file_path=simple_dag.full_filepath,
-                pickle_id=simple_dag.pickle_id))
+                pickle_id=simple_dag.pickle_id)
 
             priority = task_instance.priority_weight
             queue = task_instance.queue
diff --git a/airflow/task/task_runner/__init__.py b/airflow/task/task_runner/__init__.py
index 8766c17d13a08..960a9e9e8e426 100644
--- a/airflow/task/task_runner/__init__.py
+++ b/airflow/task/task_runner/__init__.py
@@ -18,7 +18,7 @@
 # under the License.
 
 from airflow import configuration
-from airflow.task.task_runner.bash_task_runner import BashTaskRunner
+from airflow.task.task_runner.standard_task_runner import StandardTaskRunner
 from airflow.exceptions import AirflowException
 
 _TASK_RUNNER = configuration.conf.get('core', 'TASK_RUNNER')
@@ -34,8 +34,8 @@ def get_task_runner(local_task_job):
     :return: The task runner to use to run the task.
     :rtype: airflow.task.task_runner.base_task_runner.BaseTaskRunner
     """
-    if _TASK_RUNNER == "BashTaskRunner":
-        return BashTaskRunner(local_task_job)
+    if _TASK_RUNNER == "StandardTaskRunner":
+        return StandardTaskRunner(local_task_job)
     elif _TASK_RUNNER == "CgroupTaskRunner":
         from airflow.contrib.task_runner.cgroup_task_runner import CgroupTaskRunner
         return CgroupTaskRunner(local_task_job)
diff --git a/airflow/task/task_runner/base_task_runner.py b/airflow/task/task_runner/base_task_runner.py
index 4a1c4742d1fa2..d2bf172bd435c 100644
--- a/airflow/task/task_runner/base_task_runner.py
+++ b/airflow/task/task_runner/base_task_runner.py
@@ -100,7 +100,7 @@ def _read_task_logs(self, stream):
                           self._task_instance.job_id, self._task_instance.task_id,
                           line.rstrip('\n'))
 
-    def run_command(self, run_with, join_args=False):
+    def run_command(self, run_with=None, join_args=False):
         """
         Run the task command
 
@@ -113,8 +113,10 @@ def run_command(self, run_with, join_args=False):
         :return: the process that was run
         :rtype: subprocess.Popen
         """
+        run_with = run_with or []
         cmd = [" ".join(self._command)] if join_args else self._command
         full_cmd = run_with + cmd
+
         self.log.info('Running: %s', full_cmd)
         proc = subprocess.Popen(
             full_cmd,
diff --git a/airflow/task/task_runner/bash_task_runner.py b/airflow/task/task_runner/standard_task_runner.py
similarity index 85%
rename from airflow/task/task_runner/bash_task_runner.py
rename to airflow/task/task_runner/standard_task_runner.py
index 4ddcac5982666..6b65fc35c555a 100644
--- a/airflow/task/task_runner/bash_task_runner.py
+++ b/airflow/task/task_runner/standard_task_runner.py
@@ -23,15 +23,15 @@
 from airflow.utils.helpers import reap_process_group
 
 
-class BashTaskRunner(BaseTaskRunner):
+class StandardTaskRunner(BaseTaskRunner):
     """
     Runs the raw Airflow task by invoking through the Bash shell.
     """
     def __init__(self, local_task_job):
-        super(BashTaskRunner, self).__init__(local_task_job)
+        super(StandardTaskRunner, self).__init__(local_task_job)
 
     def start(self):
-        self.process = self.run_command(['bash', '-c'], join_args=True)
+        self.process = self.run_command()
 
     def return_code(self):
         return self.process.poll()
@@ -41,4 +41,4 @@ def terminate(self):
             reap_process_group(self.process.pid, self.log)
 
     def on_finish(self):
-        super(BashTaskRunner, self).on_finish()
+        super(StandardTaskRunner, self).on_finish()
diff --git a/tests/executors/dask_executor.py b/tests/executors/dask_executor.py
index 45f25fe77ff24..9bf051f5805d2 100644
--- a/tests/executors/dask_executor.py
+++ b/tests/executors/dask_executor.py
@@ -55,8 +55,8 @@ def assert_tasks_on_executor(self, executor):
         # start the executor
         executor.start()
 
-        success_command = 'echo 1'
-        fail_command = 'exit 1'
+        success_command = ['true', ]
+        fail_command = ['false', ]
 
         executor.execute_async(key='success', command=success_command)
         executor.execute_async(key='fail', command=fail_command)
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 9a7f19f69da3d..11e505c10b058 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -41,8 +41,8 @@ def test_celery_integration(self):
         executor.start()
         with start_worker(app=app, logfile=sys.stdout, loglevel='debug'):
 
-            success_command = 'echo 1'
-            fail_command = 'exit 1'
+            success_command = ['true', ]
+            fail_command = ['false', ]
 
             executor.execute_async(key='success', command=success_command)
             # errors are propagated for some reason
diff --git a/tests/executors/test_local_executor.py b/tests/executors/test_local_executor.py
index 2c6b4f90f5c46..a4ac37d8825cf 100644
--- a/tests/executors/test_local_executor.py
+++ b/tests/executors/test_local_executor.py
@@ -33,11 +33,11 @@ def execution_parallelism(self, parallelism=0):
         executor.start()
 
         success_key = 'success {}'
-        success_command = 'echo {}'
-        fail_command = 'exit 1'
+        success_command = ['true', ]
+        fail_command = ['false', ]
 
         for i in range(self.TEST_SUCCESS_COMMANDS):
-            key, command = success_key.format(i), success_command.format(i)
+            key, command = success_key.format(i), success_command
             executor.execute_async(key=key, command=command)
             executor.running[key] = True
 
diff --git a/tests/task/task_runner/test_bash_task_runner.py b/tests/task/task_runner/test_standard_task_runner.py
similarity index 94%
rename from tests/task/task_runner/test_bash_task_runner.py
rename to tests/task/task_runner/test_standard_task_runner.py
index 1342e10945c24..38a4e41e37ed6 100644
--- a/tests/task/task_runner/test_bash_task_runner.py
+++ b/tests/task/task_runner/test_standard_task_runner.py
@@ -25,7 +25,7 @@
 from airflow import models, settings
 from airflow.jobs import LocalTaskJob
 from airflow.models import TaskInstance as TI
-from airflow.task.task_runner import BashTaskRunner
+from airflow.task.task_runner import StandardTaskRunner
 from airflow.utils import timezone
 from airflow.utils.state import State
 
@@ -61,7 +61,7 @@
 }
 
 
-class TestBashTaskRunner(unittest.TestCase):
+class TestStandardTaskRunner(unittest.TestCase):
     def setUp(self):
         dictConfig(LOGGING_CONFIG)
 
@@ -71,7 +71,7 @@ def test_start_and_terminate(self):
         local_task_job.task_instance.run_as_user = None
         local_task_job.task_instance.command_as_list.return_value = ['sleep', '1000']
 
-        runner = BashTaskRunner(local_task_job)
+        runner = StandardTaskRunner(local_task_job)
         runner.start()
 
         pgid = os.getpgid(runner.process.pid)
@@ -119,7 +119,7 @@ def test_on_kill(self):
         ti = TI(task=task, execution_date=DEFAULT_DATE)
         job1 = LocalTaskJob(task_instance=ti, ignore_ti_state=True)
 
-        runner = BashTaskRunner(job1)
+        runner = StandardTaskRunner(job1)
         runner.start()
 
         # give the task some time to startup

From 067ec041a5553c694e7023b24847509eb6ac616b Mon Sep 17 00:00:00 2001
From: Yingbo Wang <ybwang@gmail.com>
Date: Tue, 28 Aug 2018 05:33:22 -0700
Subject: [PATCH 566/808] [AIRFLOW-2930] Fix celery excecutor scheduler crash
 (#3784)

Caused by an update in PR #3740.
execute_command.apply_async(args=command, ...)
-command is a list of short unicode strings and the above code pass multiple
arguments to a function defined as taking only one argument.
-command = ["airflow", "run", "dag323",...]
-args = command = ["airflow", "run", "dag323", ...]
-execute_command("airflow","run","dag3s3", ...) will be error and exit.
---
 airflow/executors/celery_executor.py    | 2 +-
 tests/executors/dask_executor.py        | 4 ++--
 tests/executors/test_celery_executor.py | 4 ++--
 tests/executors/test_local_executor.py  | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 2580e2900d6e3..0de48b4d39ff1 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -141,7 +141,7 @@ def execute_async(self, key, command,
         self.log.info("[celery] queuing {key} through celery, "
                       "queue={queue}".format(**locals()))
         self.tasks[key] = execute_command.apply_async(
-            args=command, queue=queue)
+            args=[command], queue=queue)
         self.last_state[key] = celery_states.PENDING
 
     def _num_tasks_per_process(self):
diff --git a/tests/executors/dask_executor.py b/tests/executors/dask_executor.py
index 9bf051f5805d2..4f0009e1ccb21 100644
--- a/tests/executors/dask_executor.py
+++ b/tests/executors/dask_executor.py
@@ -55,8 +55,8 @@ def assert_tasks_on_executor(self, executor):
         # start the executor
         executor.start()
 
-        success_command = ['true', ]
-        fail_command = ['false', ]
+        success_command = ['true', 'some_parameter']
+        fail_command = ['false', 'some_parameter']
 
         executor.execute_async(key='success', command=success_command)
         executor.execute_async(key='fail', command=fail_command)
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 11e505c10b058..380201d30a045 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -41,8 +41,8 @@ def test_celery_integration(self):
         executor.start()
         with start_worker(app=app, logfile=sys.stdout, loglevel='debug'):
 
-            success_command = ['true', ]
-            fail_command = ['false', ]
+            success_command = ['true', 'some_parameter']
+            fail_command = ['false', 'some_parameter']
 
             executor.execute_async(key='success', command=success_command)
             # errors are propagated for some reason
diff --git a/tests/executors/test_local_executor.py b/tests/executors/test_local_executor.py
index a4ac37d8825cf..2a29ee2cd5c49 100644
--- a/tests/executors/test_local_executor.py
+++ b/tests/executors/test_local_executor.py
@@ -33,8 +33,8 @@ def execution_parallelism(self, parallelism=0):
         executor.start()
 
         success_key = 'success {}'
-        success_command = ['true', ]
-        fail_command = ['false', ]
+        success_command = ['true', 'some_parameter']
+        fail_command = ['false', 'some_parameter']
 
         for i in range(self.TEST_SUCCESS_COMMANDS):
             key, command = success_key.format(i), success_command

From c1070f33ad4171893536e039d31464b5f749d5cf Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Wed, 19 Dec 2018 13:28:56 -0500
Subject: [PATCH 567/808] [AIRFLOW-3540] Respect environment config when
 looking up config file. (#4340)

---
 UPDATING.md              |  9 ++++++++-
 airflow/configuration.py | 26 ++++++++++++-------------
 tests/configuration.py   | 42 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 63 insertions(+), 14 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 89f33543395ba..29c62bca2156c 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -25,7 +25,6 @@ assists users migrating to a new version.
 ## Airflow 1.10.3
 
 ### RedisPy dependency updated to v3 series
-
 If you are using the Redis Sensor or Hook you may have to update your code. See
 [redis-py porting instructions] to check if your code might be affected (MSET,
 MSETNX, ZADD, and ZINCRBY all were, but read the full doc).
@@ -50,6 +49,14 @@ so you might need to update your config.
 
 `task_runner = StandardTaskRunner`
 
+### Modification to config file discovery
+
+If the `AIRFLOW_CONFIG` environment variable was not set and the
+`~/airflow/airflow.cfg` file existed, airflow previously used
+`~/airflow/airflow.cfg` instead of `$AIRFLOW_HOME/airflow.cfg`. Now airflow
+will discover its config file using the `$AIRFLOW_CONFIG` and `$AIRFLOW_HOME`
+environment variables rather than checking for the presence of a file.
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
diff --git a/airflow/configuration.py b/airflow/configuration.py
index 751dce1c6da3d..76dceaf58fd81 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -441,23 +441,23 @@ def mkdir_p(path):
                 'Error creating {}: {}'.format(path, exc.strerror))
 
 
-# Setting AIRFLOW_HOME and AIRFLOW_CONFIG from environment variables, using
-# "~/airflow" and "~/airflow/airflow.cfg" respectively as defaults.
+def get_airflow_home():
+    return expand_env_var(os.environ.get('AIRFLOW_HOME', '~/airflow'))
+
+
+def get_airflow_config(airflow_home):
+    if 'AIRFLOW_CONFIG' not in os.environ:
+        return os.path.join(airflow_home, 'airflow.cfg')
+    return expand_env_var(os.environ['AIRFLOW_CONFIG'])
 
-if 'AIRFLOW_HOME' not in os.environ:
-    AIRFLOW_HOME = expand_env_var('~/airflow')
-else:
-    AIRFLOW_HOME = expand_env_var(os.environ['AIRFLOW_HOME'])
 
+# Setting AIRFLOW_HOME and AIRFLOW_CONFIG from environment variables, using
+# "~/airflow" and "$AIRFLOW_HOME/airflow.cfg" respectively as defaults.
+
+AIRFLOW_HOME = get_airflow_home()
+AIRFLOW_CONFIG = get_airflow_config(AIRFLOW_HOME)
 mkdir_p(AIRFLOW_HOME)
 
-if 'AIRFLOW_CONFIG' not in os.environ:
-    if os.path.isfile(expand_env_var('~/airflow.cfg')):
-        AIRFLOW_CONFIG = expand_env_var('~/airflow.cfg')
-    else:
-        AIRFLOW_CONFIG = AIRFLOW_HOME + '/airflow.cfg'
-else:
-    AIRFLOW_CONFIG = expand_env_var(os.environ['AIRFLOW_CONFIG'])
 
 # Set up dags folder for unit tests
 # this directory won't exist if users install via pip
diff --git a/tests/configuration.py b/tests/configuration.py
index 278e2e597abbc..e3b81f769f7b9 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -21,6 +21,7 @@
 from __future__ import unicode_literals
 
 import os
+import contextlib
 from collections import OrderedDict
 
 import six
@@ -35,6 +36,23 @@
     import unittest
 
 
+@contextlib.contextmanager
+def env_vars(**vars):
+    original = {}
+    for key, value in vars.items():
+        original[key] = os.environ.get(key)
+        if value is not None:
+            os.environ[key] = value
+        else:
+            os.environ.pop(key, None)
+    yield
+    for key, value in original.items():
+        if value is not None:
+            os.environ[key] = value
+        else:
+            os.environ.pop(key, None)
+
+
 class ConfTest(unittest.TestCase):
 
     @classmethod
@@ -49,6 +67,30 @@ def tearDownClass(cls):
         del os.environ['AIRFLOW__TESTSECTION__TESTKEY']
         del os.environ['AIRFLOW__TESTSECTION__TESTPERCENT']
 
+    def test_airflow_home_default(self):
+        with env_vars(AIRFLOW_HOME=None):
+            self.assertEqual(
+                configuration.get_airflow_home(),
+                configuration.expand_env_var('~/airflow'))
+
+    def test_airflow_home_override(self):
+        with env_vars(AIRFLOW_HOME='/path/to/airflow'):
+            self.assertEqual(
+                configuration.get_airflow_home(),
+                '/path/to/airflow')
+
+    def test_airflow_config_default(self):
+        with env_vars(AIRFLOW_CONFIG=None):
+            self.assertEqual(
+                configuration.get_airflow_config('/home/airflow'),
+                configuration.expand_env_var('/home/airflow/airflow.cfg'))
+
+    def test_airflow_config_override(self):
+        with env_vars(AIRFLOW_CONFIG='/path/to/airflow/airflow.cfg'):
+            self.assertEqual(
+                configuration.get_airflow_config('/home//airflow'),
+                '/path/to/airflow/airflow.cfg')
+
     def test_env_var_config(self):
         opt = conf.get('testsection', 'testkey')
         self.assertEqual(opt, 'testvalue')

From 1dae31990b5f271c6c2a645dadf0f146ddce0c10 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 6 Mar 2019 20:14:06 +0000
Subject: [PATCH 568/808] [AIRFLOW-2888] Add deprecation path for task_runner
 config change (#4851)

This change allows users to seamlessly upgrade without a hard-to-debug
error when a task is actually run. This allows us to pull the change in
to 1.10.3
---
 airflow/configuration.py | 34 ++++++++++++++++++++++++++++++-
 tests/configuration.py   | 43 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 75 insertions(+), 2 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 76dceaf58fd81..faec3e74d9672 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -151,6 +151,19 @@ class AirflowConfigParser(ConfigParser):
         'setting has been used, but please update your config.'
     )
 
+    # A mapping of old default values that we want to change and warn the user
+    # about. Mapping of section -> setting -> { old, replace, by_version }
+    deprecated_values = {
+        'core': {
+            'task_runner': ('BashTaskRunner', 'StandardTaskRunner', '2.0'),
+        },
+    }
+    deprecation_value_format_string = (
+        'The {name} setting in [{section}] has the old default value of {old!r}. This '
+        'value has been changed to {new!r} in the running config, but please '
+        'update your config before Apache Airflow {version}.'
+    )
+
     def __init__(self, default_config=None, *args, **kwargs):
         super(AirflowConfigParser, self).__init__(*args, **kwargs)
 
@@ -186,11 +199,30 @@ def _validate(self):
                 "error: attempt at using ldapgroup "
                 "filtering without using the Ldap backend")
 
+        for section, replacement in self.deprecated_values.items():
+            for name, info in replacement.items():
+                old, new, version = info
+                if self.get(section, name, fallback=None) == old:
+                    # Make sure the env var option is removed, otherwise it
+                    # would be read and used instead of the value we set
+                    env_var = self._env_var_name(section, name)
+                    os.environ.pop(env_var, None)
+
+                    self.set(section, name, new)
+                    warnings.warn(
+                        self.deprecation_value_format_string.format(**locals()),
+                        FutureWarning,
+                    )
+
         self.is_validated = True
 
+    @staticmethod
+    def _env_var_name(section, key):
+        return 'AIRFLOW__{S}__{K}'.format(S=section.upper(), K=key.upper())
+
     def _get_env_var_option(self, section, key):
         # must have format AIRFLOW__{SECTION}__{KEY} (note double underscore)
-        env_var = 'AIRFLOW__{S}__{K}'.format(S=section.upper(), K=key.upper())
+        env_var = self._env_var_name(section, key)
         if env_var in os.environ:
             return expand_env_var(os.environ[env_var])
 
diff --git a/tests/configuration.py b/tests/configuration.py
index e3b81f769f7b9..58113f126cdf1 100644
--- a/tests/configuration.py
+++ b/tests/configuration.py
@@ -20,8 +20,9 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-import os
 import contextlib
+import os
+import warnings
 from collections import OrderedDict
 
 import six
@@ -278,3 +279,43 @@ def test_deprecated_options_cmd(self):
             self.assertEquals(conf.getint('celery', 'result_backend'), 99)
             if tmp:
                 os.environ['AIRFLOW__CELERY__RESULT_BACKEND'] = tmp
+
+    def test_deprecated_values(self):
+        def make_config():
+            test_conf = AirflowConfigParser()
+            # Guarantee we have a deprecated setting, so we test the deprecation
+            # lookup even if we remove this explicit fallback
+            test_conf.deprecated_values = {
+                'core': {
+                    'task_runner': ('BashTaskRunner', 'StandardTaskRunner', '2.0'),
+                },
+            }
+            test_conf.read_dict({
+                'core': {
+                    'executor': 'SequentialExecutor',
+                    'task_runner': 'BashTaskRunner',
+                    'sql_alchemy_conn': 'sqlite://',
+                },
+                'webserver': {
+                    'authenticate': False,
+                },
+            })
+            return test_conf
+
+        with self.assertWarns(FutureWarning):
+            test_conf = make_config()
+            self.assertEqual(test_conf.get('core', 'task_runner'), 'StandardTaskRunner')
+
+        with self.assertWarns(FutureWarning):
+            with env_vars(AIRFLOW__CORE__TASK_RUNNER='BashTaskRunner'):
+                test_conf = make_config()
+
+                self.assertEqual(test_conf.get('core', 'task_runner'), 'StandardTaskRunner')
+
+        with warnings.catch_warnings(record=True) as w:
+            with env_vars(AIRFLOW__CORE__TASK_RUNNER='NotBashTaskRunner'):
+                test_conf = make_config()
+
+                self.assertEqual(test_conf.get('core', 'task_runner'), 'NotBashTaskRunner')
+
+                self.assertListEqual([], w)

From b8ad457bf88d97fbb78880eda8e5c36a0cf7542a Mon Sep 17 00:00:00 2001
From: Colin <colin.streicher@freckleiot.com>
Date: Thu, 7 Mar 2019 05:47:59 -0500
Subject: [PATCH 569/808] [AIRFLOW-3751] Option to allow malformed schemas for
 LDAP authentication (#4574)

---
 airflow/config_templates/default_airflow.cfg |  4 ++++
 airflow/contrib/auth/backends/ldap_auth.py   | 10 +++++++++-
 docs/security.rst                            |  4 ++++
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index ac3ae06f55346..bec898453d230 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -530,6 +530,10 @@ basedn = dc=example,dc=com
 cacert = /etc/ca/ldap_ca.crt
 search_scope = LEVEL
 
+# This setting allows the use of LDAP servers that either return a 
+# broken schema, or do not return a schema. 
+ignore_malformed_schema = False
+
 [mesos]
 # Mesos master address which MesosExecutor will connect to.
 master = localhost:5050
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index 587fc2be16d05..9135b4c3964b0 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -24,7 +24,7 @@
 from wtforms import Form, PasswordField, StringField
 from wtforms.validators import InputRequired
 
-from ldap3 import Server, Connection, Tls, LEVEL, SUBTREE
+from ldap3 import Server, Connection, Tls, set_config_parameter, LEVEL, SUBTREE
 import ssl
 
 from flask import url_for, redirect
@@ -60,6 +60,14 @@ def get_ldap_connection(dn=None, password=None):
     except AirflowConfigException:
         pass
 
+    try:
+        ignore_malformed_schema = configuration.conf.get("ldap", "ignore_malformed_schema")
+    except AirflowConfigException:
+        pass
+
+    if ignore_malformed_schema:
+        set_config_parameter('IGNORE_MALFORMED_SCHEMA', ignore_malformed_schema)
+
     tls_configuration = Tls(validate=ssl.CERT_REQUIRED,
                             ca_certs_file=cacert)
 
diff --git a/docs/security.rst b/docs/security.rst
index 1e521e4f2872b..d309ca629c2c7 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -117,6 +117,10 @@ Valid search_scope options can be found in the `ldap3 Documentation <http://ldap
     # Set search_scope to SUBTREE if using Active Directory, and not specifying an Organizational Unit
     search_scope = LEVEL
 
+    # This option tells ldap3 to ignore schemas that are considered malformed. This sometimes comes up
+    # when using hosted ldap services.
+    ignore_malformed_schema = False
+
 The superuser_filter and data_profiler_filter are optional. If defined, these configurations allow you to specify LDAP groups that users must belong to in order to have superuser (admin) and data-profiler permissions. If undefined, all users will be superusers and data profilers.
 
 Roll your own

From e7343a3db108f5aea8467c73ca9856819e130d73 Mon Sep 17 00:00:00 2001
From: OmerJog <44576851+OmerJog@users.noreply.github.com>
Date: Thu, 3 Jan 2019 22:25:57 +0200
Subject: [PATCH 570/808] [AIRFLOW-2641] Fix MySqlToHiveTransfer to handle
 MySQL DECIMAL correctly

---
 airflow/operators/mysql_to_hive.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/airflow/operators/mysql_to_hive.py b/airflow/operators/mysql_to_hive.py
index 94d660801ff82..edffe9164e577 100644
--- a/airflow/operators/mysql_to_hive.py
+++ b/airflow/operators/mysql_to_hive.py
@@ -101,6 +101,7 @@ def type_map(cls, mysql_type):
         d = {
             t.BIT: 'INT',
             t.DECIMAL: 'DOUBLE',
+            t.NEWDECIMAL: 'DOUBLE',
             t.DOUBLE: 'DOUBLE',
             t.FLOAT: 'DOUBLE',
             t.INT24: 'INT',
@@ -122,7 +123,8 @@ def execute(self, context):
         cursor = conn.cursor()
         cursor.execute(self.sql)
         with NamedTemporaryFile("wb") as f:
-            csv_writer = csv.writer(f, delimiter=self.delimiter, encoding="utf-8")
+            csv_writer = csv.writer(f, delimiter=self.delimiter,
+                                    encoding="utf-8")
             field_dict = OrderedDict()
             for field in cursor.description:
                 field_dict[field[0]] = self.type_map(field[1])

From f68938fd629ada00f14f10ea27e094e28e7247a8 Mon Sep 17 00:00:00 2001
From: brookskd <brookskd@gmail.com>
Date: Tue, 7 Aug 2018 10:53:18 -0400
Subject: [PATCH 571/808] [AIRFLOW-2231] Fix relativedelta DAG
 schedule_interval (#3174)

Fixes issues when specifying a DAG with a schedule_interval of type relativedelta.
---
 airflow/models.py |  6 +++---
 tests/core.py     | 40 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 3 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index f28138e40ad6c..8547e9cafb42d 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -26,7 +26,7 @@
 
 from builtins import str, object, bytes, ImportError as BuiltinImportError
 import copy
-from collections import namedtuple, defaultdict, OrderedDict
+from collections import namedtuple, defaultdict, Hashable, OrderedDict
 from datetime import timedelta
 
 import dill
@@ -3387,7 +3387,7 @@ def __init__(
             )
 
         self.schedule_interval = schedule_interval
-        if schedule_interval in cron_presets:
+        if isinstance(schedule_interval, Hashable) and schedule_interval in cron_presets:
             self._schedule_interval = cron_presets.get(schedule_interval)
         elif schedule_interval == '@once':
             self._schedule_interval = None
@@ -3518,7 +3518,7 @@ def following_schedule(self, dttm):
                 tz = pendulum.timezone(self.timezone.name)
                 following = timezone.make_aware(naive, tz)
             return timezone.convert_to_utc(following)
-        elif isinstance(self._schedule_interval, timedelta):
+        elif self._schedule_interval is not None:
             return dttm + self._schedule_interval
 
     def previous_schedule(self, dttm):
diff --git a/tests/core.py b/tests/core.py
index d07ca10c9d84a..6549a610e5f8d 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -156,6 +156,46 @@ def test_schedule_dag_no_previous_runs(self):
         self.assertFalse(dag_run.external_trigger)
         dag.clear()
 
+    def test_schedule_dag_relativedelta(self):
+        """
+        Tests scheduling a dag with a relativedelta schedule_interval
+        """
+        delta = relativedelta(hours=+1)
+        dag = DAG(TEST_DAG_ID + 'test_schedule_dag_relativedelta',
+                  schedule_interval=delta)
+        dag.add_task(models.BaseOperator(
+            task_id="faketastic",
+            owner='Also fake',
+            start_date=datetime(2015, 1, 2, 0, 0)))
+
+        dag_run = jobs.SchedulerJob(**self.default_scheduler_args).create_dag_run(dag)
+        self.assertIsNotNone(dag_run)
+        self.assertEqual(dag.dag_id, dag_run.dag_id)
+        self.assertIsNotNone(dag_run.run_id)
+        self.assertNotEqual('', dag_run.run_id)
+        self.assertEqual(
+            datetime(2015, 1, 2, 0, 0),
+            dag_run.execution_date,
+            msg='dag_run.execution_date did not match expectation: {0}'
+            .format(dag_run.execution_date)
+        )
+        self.assertEqual(State.RUNNING, dag_run.state)
+        self.assertFalse(dag_run.external_trigger)
+        dag_run2 = jobs.SchedulerJob(**self.default_scheduler_args).create_dag_run(dag)
+        self.assertIsNotNone(dag_run2)
+        self.assertEqual(dag.dag_id, dag_run2.dag_id)
+        self.assertIsNotNone(dag_run2.run_id)
+        self.assertNotEqual('', dag_run2.run_id)
+        self.assertEqual(
+            datetime(2015, 1, 2, 0, 0) + delta,
+            dag_run2.execution_date,
+            msg='dag_run2.execution_date did not match expectation: {0}'
+            .format(dag_run2.execution_date)
+        )
+        self.assertEqual(State.RUNNING, dag_run2.state)
+        self.assertFalse(dag_run2.external_trigger)
+        dag.clear()
+
     def test_schedule_dag_fake_scheduled_previous(self):
         """
         Test scheduling a dag where there is a prior DagRun

From 231e4c44af0adfcf6aca8b9157b3c950a12897b1 Mon Sep 17 00:00:00 2001
From: Francis Lalonde <fralalonde@gmail.com>
Date: Tue, 25 Sep 2018 05:54:35 -0400
Subject: [PATCH 572/808] [AIRFLOW-3009] Import Hashable from collection.abc to
 fix Python 3.7 deprecation warning (#3849)

---
 airflow/models.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index 8547e9cafb42d..3e09875e5f225 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -26,7 +26,13 @@
 
 from builtins import str, object, bytes, ImportError as BuiltinImportError
 import copy
-from collections import namedtuple, defaultdict, Hashable, OrderedDict
+from collections import namedtuple, defaultdict, OrderedDict
+try:
+    # Fix Python > 3.7 deprecation
+    from collections.abc import Hashable
+except ImportError:
+    # Preserve Python < 3.3 compatibility
+    from collections import Hashable
 from datetime import timedelta
 
 import dill

From eb9c4028c8adf1979fec01c2f464930e12ed013c Mon Sep 17 00:00:00 2001
From: Kevin Yang <yrqls21@gmail.com>
Date: Wed, 28 Nov 2018 14:23:44 -0800
Subject: [PATCH 573/808] [AIRFLOW-2761] Parallelize enqueue in celery executor
 (#4234)

---
 airflow/executors/base_executor.py      |  38 +++----
 airflow/executors/celery_executor.py    | 116 ++++++++++++++++---
 airflow/jobs.py                         | 145 ++++++++++++++----------
 airflow/models.py                       |   7 +-
 airflow/utils/dag_processing.py         |  67 ++++++++++-
 airflow/utils/timeout.py                |   5 +-
 tests/executors/test_celery_executor.py |  61 ++++++++--
 tests/executors/test_executor.py        |   3 +-
 tests/jobs.py                           |  71 ++++++++++--
 9 files changed, 389 insertions(+), 124 deletions(-)

diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index 7bf6470543026..fad3c5a0ee3a6 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -20,11 +20,12 @@
 from builtins import range
 from collections import OrderedDict
 
+# To avoid circular imports
+import airflow.utils.dag_processing
 from airflow import configuration
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.state import State
 
-
 PARALLELISM = configuration.conf.getint('core', 'PARALLELISM')
 
 
@@ -51,11 +52,11 @@ def start(self):  # pragma: no cover
         """
         pass
 
-    def queue_command(self, task_instance, command, priority=1, queue=None):
-        key = task_instance.key
+    def queue_command(self, simple_task_instance, command, priority=1, queue=None):
+        key = simple_task_instance.key
         if key not in self.queued_tasks and key not in self.running:
             self.log.info("Adding to queue: %s", command)
-            self.queued_tasks[key] = (command, priority, queue, task_instance)
+            self.queued_tasks[key] = (command, priority, queue, simple_task_instance)
         else:
             self.log.info("could not queue task {}".format(key))
 
@@ -87,7 +88,7 @@ def queue_task_instance(
             pickle_id=pickle_id,
             cfg_path=cfg_path)
         self.queue_command(
-            task_instance,
+            airflow.utils.dag_processing.SimpleTaskInstance(task_instance),
             command,
             priority=task_instance.task.priority_weight_total,
             queue=task_instance.task.queue)
@@ -125,26 +126,13 @@ def heartbeat(self):
             key=lambda x: x[1][1],
             reverse=True)
         for i in range(min((open_slots, len(self.queued_tasks)))):
-            key, (command, _, queue, ti) = sorted_queue.pop(0)
-            # TODO(jlowin) without a way to know what Job ran which tasks,
-            # there is a danger that another Job started running a task
-            # that was also queued to this executor. This is the last chance
-            # to check if that happened. The most probable way is that a
-            # Scheduler tried to run a task that was originally queued by a
-            # Backfill. This fix reduces the probability of a collision but
-            # does NOT eliminate it.
+            key, (command, _, queue, simple_ti) = sorted_queue.pop(0)
             self.queued_tasks.pop(key)
-            ti.refresh_from_db()
-            if ti.state != State.RUNNING:
-                self.running[key] = command
-                self.execute_async(key=key,
-                                   command=command,
-                                   queue=queue,
-                                   executor_config=ti.executor_config)
-            else:
-                self.log.info(
-                    'Task is already running, not sending to '
-                    'executor: {}'.format(key))
+            self.running[key] = command
+            self.execute_async(key=key,
+                               command=command,
+                               queue=queue,
+                               executor_config=simple_ti.executor_config)
 
         # Calling child class sync method
         self.log.debug("Calling the %s sync method", self.__class__)
@@ -152,7 +140,7 @@ def heartbeat(self):
 
     def change_state(self, key, state):
         self.log.debug("Changing state: {}".format(key))
-        self.running.pop(key)
+        self.running.pop(key, None)
         self.event_buffer[key] = state
 
     def fail(self, key):
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 0de48b4d39ff1..98ce6efba7546 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -33,10 +33,13 @@
 from airflow.executors.base_executor import BaseExecutor
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.module_loading import import_string
+from airflow.utils.timeout import timeout
 
 # Make it constant for unit test.
 CELERY_FETCH_ERR_MSG_HEADER = 'Error fetching Celery task state'
 
+CELERY_SEND_ERR_MSG_HEADER = 'Error sending Celery task'
+
 '''
 To start the celery worker, run the command:
 airflow worker
@@ -55,12 +58,12 @@
 
 
 @app.task
-def execute_command(command):
+def execute_command(command_to_exec):
     log = LoggingMixin().log
-    log.info("Executing command in Celery: %s", command)
+    log.info("Executing command in Celery: %s", command_to_exec)
     env = os.environ.copy()
     try:
-        subprocess.check_call(command, stderr=subprocess.STDOUT,
+        subprocess.check_call(command_to_exec, stderr=subprocess.STDOUT,
                               close_fds=True, env=env)
     except subprocess.CalledProcessError as e:
         log.exception('execute_command encountered a CalledProcessError')
@@ -95,9 +98,10 @@ def fetch_celery_task_state(celery_task):
     """
 
     try:
-        # Accessing state property of celery task will make actual network request
-        # to get the current state of the task.
-        res = (celery_task[0], celery_task[1].state)
+        with timeout(seconds=2):
+            # Accessing state property of celery task will make actual network request
+            # to get the current state of the task.
+            res = (celery_task[0], celery_task[1].state)
     except Exception as e:
         exception_traceback = "Celery Task ID: {}\n{}".format(celery_task[0],
                                                               traceback.format_exc())
@@ -105,6 +109,19 @@ def fetch_celery_task_state(celery_task):
     return res
 
 
+def send_task_to_executor(task_tuple):
+    key, simple_ti, command, queue, task = task_tuple
+    try:
+        with timeout(seconds=2):
+            result = task.apply_async(args=[command], queue=queue)
+    except Exception as e:
+        exception_traceback = "Celery Task ID: {}\n{}".format(key,
+                                                              traceback.format_exc())
+        result = ExceptionWithTraceback(e, exception_traceback)
+
+    return key, command, result
+
+
 class CeleryExecutor(BaseExecutor):
     """
     CeleryExecutor is recommended for production use of Airflow. It allows
@@ -135,24 +152,91 @@ def start(self):
             'Starting Celery Executor using {} processes for syncing'.format(
                 self._sync_parallelism))
 
-    def execute_async(self, key, command,
-                      queue=DEFAULT_CELERY_CONFIG['task_default_queue'],
-                      executor_config=None):
-        self.log.info("[celery] queuing {key} through celery, "
-                      "queue={queue}".format(**locals()))
-        self.tasks[key] = execute_command.apply_async(
-            args=[command], queue=queue)
-        self.last_state[key] = celery_states.PENDING
+    def _num_tasks_per_send_process(self, to_send_count):
+        """
+        How many Celery tasks should each worker process send.
 
-    def _num_tasks_per_process(self):
+        :return: Number of tasks that should be sent per process
+        :rtype: int
+        """
+        return max(1,
+                   int(math.ceil(1.0 * to_send_count / self._sync_parallelism)))
+
+    def _num_tasks_per_fetch_process(self):
         """
         How many Celery tasks should be sent to each worker process.
+
         :return: Number of tasks that should be used per process
         :rtype: int
         """
         return max(1,
                    int(math.ceil(1.0 * len(self.tasks) / self._sync_parallelism)))
 
+    def heartbeat(self):
+        # Triggering new jobs
+        if not self.parallelism:
+            open_slots = len(self.queued_tasks)
+        else:
+            open_slots = self.parallelism - len(self.running)
+
+        self.log.debug("{} running task instances".format(len(self.running)))
+        self.log.debug("{} in queue".format(len(self.queued_tasks)))
+        self.log.debug("{} open slots".format(open_slots))
+
+        sorted_queue = sorted(
+            [(k, v) for k, v in self.queued_tasks.items()],
+            key=lambda x: x[1][1],
+            reverse=True)
+
+        task_tuples_to_send = []
+
+        for i in range(min((open_slots, len(self.queued_tasks)))):
+            key, (command, _, queue, simple_ti) = sorted_queue.pop(0)
+            task_tuples_to_send.append((key, simple_ti, command, queue,
+                                        execute_command))
+
+        cached_celery_backend = None
+        if task_tuples_to_send:
+            tasks = [t[4] for t in task_tuples_to_send]
+
+            # Celery state queries will stuck if we do not use one same backend
+            # for all tasks.
+            cached_celery_backend = tasks[0].backend
+
+        if task_tuples_to_send:
+            # Use chunking instead of a work queue to reduce context switching
+            # since tasks are roughly uniform in size
+            chunksize = self._num_tasks_per_send_process(len(task_tuples_to_send))
+            num_processes = min(len(task_tuples_to_send), self._sync_parallelism)
+
+            send_pool = Pool(processes=num_processes)
+            key_and_async_results = send_pool.map(
+                send_task_to_executor,
+                task_tuples_to_send,
+                chunksize=chunksize)
+
+            send_pool.close()
+            send_pool.join()
+            self.log.debug('Sent all tasks.')
+
+            for key, command, result in key_and_async_results:
+                if isinstance(result, ExceptionWithTraceback):
+                    self.log.error(
+                        CELERY_SEND_ERR_MSG_HEADER + ":{}\n{}\n".format(
+                            result.exception, result.traceback))
+                elif result is not None:
+                    # Only pops when enqueued successfully, otherwise keep it
+                    # and expect scheduler loop to deal with it.
+                    self.queued_tasks.pop(key)
+                    result.backend = cached_celery_backend
+                    self.running[key] = command
+                    self.tasks[key] = result
+                    self.last_state[key] = celery_states.PENDING
+
+        # Calling child class sync method
+        self.log.debug("Calling the {} sync method".format(self.__class__))
+        self.sync()
+
     def sync(self):
         num_processes = min(len(self.tasks), self._sync_parallelism)
         if num_processes == 0:
@@ -167,7 +251,7 @@ def sync(self):
 
         # Use chunking instead of a work queue to reduce context switching since tasks are
         # roughly uniform in size
-        chunksize = self._num_tasks_per_process()
+        chunksize = self._num_tasks_per_fetch_process()
 
         self.log.debug("Waiting for inquiries to complete...")
         task_keys_to_states = self._sync_pool.map(
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 3e44c1a9044a1..1064ba48e6fc6 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -52,6 +52,7 @@
                                           DagFileProcessorAgent,
                                           SimpleDag,
                                           SimpleDagBag,
+                                          SimpleTaskInstance,
                                           list_py_file_paths)
 from airflow.utils.db import create_session, provide_session
 from airflow.utils.email import get_email_address_list, send_email
@@ -600,6 +601,7 @@ def __init__(
                                             'run_duration')
 
         self.processor_agent = None
+        self._last_loop = False
 
         signal.signal(signal.SIGINT, self._exit_gracefully)
         signal.signal(signal.SIGTERM, self._exit_gracefully)
@@ -1231,13 +1233,13 @@ def _change_state_for_executable_task_instances(self, task_instances,
                                                     acceptable_states, session=None):
         """
         Changes the state of task instances in the list with one of the given states
-        to QUEUED atomically, and returns the TIs changed.
+        to QUEUED atomically, and returns the TIs changed in SimpleTaskInstance format.
 
         :param task_instances: TaskInstances to change the state of
         :type task_instances: List[TaskInstance]
         :param acceptable_states: Filters the TaskInstances updated to be in these states
         :type acceptable_states: Iterable[State]
-        :return: List[TaskInstance]
+        :return: List[SimpleTaskInstance]
         """
         if len(task_instances) == 0:
             session.commit()
@@ -1279,81 +1281,57 @@ def _change_state_for_executable_task_instances(self, task_instances,
                                          else task_instance.queued_dttm)
             session.merge(task_instance)
 
-        # save which TIs we set before session expires them
-        filter_for_ti_enqueue = ([and_(TI.dag_id == ti.dag_id,
-                                  TI.task_id == ti.task_id,
-                                  TI.execution_date == ti.execution_date)
-                                  for ti in tis_to_set_to_queued])
-        session.commit()
-
-        # requery in batches since above was expired by commit
+        # Generate a list of SimpleTaskInstance for the use of queuing
+        # them in the executor.
+        simple_task_instances = [SimpleTaskInstance(ti) for ti in
+                                 tis_to_set_to_queued]
 
-        def query(result, items):
-            tis_to_be_queued = (
-                session
-                .query(TI)
-                .filter(or_(*items))
-                .all())
-            task_instance_str = "\n\t".join(
-                ["{}".format(x) for x in tis_to_be_queued])
-            self.log.info("Setting the following {} tasks to queued state:\n\t{}"
-                          .format(len(tis_to_be_queued),
-                                  task_instance_str))
-            return result + tis_to_be_queued
-
-        tis_to_be_queued = helpers.reduce_in_chunks(query,
-                                                    filter_for_ti_enqueue,
-                                                    [],
-                                                    self.max_tis_per_query)
+        task_instance_str = "\n\t".join(
+            ["{}".format(x) for x in tis_to_set_to_queued])
 
-        return tis_to_be_queued
+        session.commit()
+        self.log.info("Setting the following {} tasks to queued state:\n\t{}"
+                      .format(len(tis_to_set_to_queued), task_instance_str))
+        return simple_task_instances
 
-    def _enqueue_task_instances_with_queued_state(self, simple_dag_bag, task_instances):
+    def _enqueue_task_instances_with_queued_state(self, simple_dag_bag,
+                                                  simple_task_instances):
         """
         Takes task_instances, which should have been set to queued, and enqueues them
         with the executor.
 
-        :param task_instances: TaskInstances to enqueue
-        :type task_instances: List[TaskInstance]
+        :param simple_task_instances: TaskInstances to enqueue
+        :type simple_task_instances: List[SimpleTaskInstance]
         :param simple_dag_bag: Should contains all of the task_instances' dags
         :type simple_dag_bag: SimpleDagBag
         """
         TI = models.TaskInstance
         # actually enqueue them
-        for task_instance in task_instances:
-            simple_dag = simple_dag_bag.get_dag(task_instance.dag_id)
+        for simple_task_instance in simple_task_instances:
+            simple_dag = simple_dag_bag.get_dag(simple_task_instance.dag_id)
             command = TI.generate_command(
-                task_instance.dag_id,
-                task_instance.task_id,
-                task_instance.execution_date,
+                simple_task_instance.dag_id,
+                simple_task_instance.task_id,
+                simple_task_instance.execution_date,
                 local=True,
                 mark_success=False,
                 ignore_all_deps=False,
                 ignore_depends_on_past=False,
                 ignore_task_deps=False,
                 ignore_ti_state=False,
-                pool=task_instance.pool,
+                pool=simple_task_instance.pool,
                 file_path=simple_dag.full_filepath,
                 pickle_id=simple_dag.pickle_id)
 
-            priority = task_instance.priority_weight
-            queue = task_instance.queue
+            priority = simple_task_instance.priority_weight
+            queue = simple_task_instance.queue
             self.log.info(
                 "Sending %s to executor with priority %s and queue %s",
-                task_instance.key, priority, queue
+                simple_task_instance.key, priority, queue
             )
 
-            # save attributes so sqlalchemy doesnt expire them
-            copy_dag_id = task_instance.dag_id
-            copy_task_id = task_instance.task_id
-            copy_execution_date = task_instance.execution_date
-            make_transient(task_instance)
-            task_instance.dag_id = copy_dag_id
-            task_instance.task_id = copy_task_id
-            task_instance.execution_date = copy_execution_date
-
             self.executor.queue_command(
-                task_instance,
+                simple_task_instance,
                 command,
                 priority=priority,
                 queue=queue)
@@ -1377,24 +1355,65 @@ def _execute_task_instances(self,
         :type simple_dag_bag: SimpleDagBag
         :param states: Execute TaskInstances in these states
         :type states: Tuple[State]
-        :return: None
+        :return: Number of task instance with state changed.
         """
         executable_tis = self._find_executable_task_instances(simple_dag_bag, states,
                                                               session=session)
 
         def query(result, items):
-            tis_with_state_changed = self._change_state_for_executable_task_instances(
-                items,
-                states,
-                session=session)
+            simple_tis_with_state_changed = \
+                self._change_state_for_executable_task_instances(items,
+                                                                 states,
+                                                                 session=session)
             self._enqueue_task_instances_with_queued_state(
                 simple_dag_bag,
-                tis_with_state_changed)
+                simple_tis_with_state_changed)
             session.commit()
-            return result + len(tis_with_state_changed)
+            return result + len(simple_tis_with_state_changed)
 
         return helpers.reduce_in_chunks(query, executable_tis, 0, self.max_tis_per_query)
 
+    @provide_session
+    def _change_state_for_tasks_failed_to_execute(self, session):
+        """
+        If there are tasks left over in the executor,
+        we set them back to SCHEDULED to avoid creating hanging tasks.
+
+        :param session: session for ORM operations
+        """
+        if self.executor.queued_tasks:
+            TI = models.TaskInstance
+            filter_for_ti_state_change = (
+                [and_(
+                    TI.dag_id == dag_id,
+                    TI.task_id == task_id,
+                    TI.execution_date == execution_date,
+                    # The TI.try_number will return raw try_number+1 since the
+                    # ti is not running. And we need to -1 to match the DB record.
+                    TI._try_number == try_number - 1,
+                    TI.state == State.QUEUED)
+                    for dag_id, task_id, execution_date, try_number
+                    in self.executor.queued_tasks.keys()])
+            ti_query = (session.query(TI)
+                        .filter(or_(*filter_for_ti_state_change)))
+            tis_to_set_to_scheduled = (ti_query
+                                       .with_for_update()
+                                       .all())
+            if len(tis_to_set_to_scheduled) == 0:
+                session.commit()
+                return
+
+            # set TIs to queued state
+            for task_instance in tis_to_set_to_scheduled:
+                task_instance.state = State.SCHEDULED
+
+            task_instance_str = "\n\t".join(
+                ["{}".format(x) for x in tis_to_set_to_scheduled])
+
+            session.commit()
+            self.log.info("Set the follow tasks to scheduled state:\n\t{}"
+                          .format(task_instance_str))
+
     def _process_dags(self, dagbag, dags, tis_out):
         """
         Iterates over the dags and processes them. Processing includes:
@@ -1511,6 +1530,8 @@ def processor_factory(file_path, zombies):
 
         try:
             self._execute_helper()
+        except Exception:
+            self.log.exception("Exception when executing execute_helper")
         finally:
             self.processor_agent.end()
             self.log.info("Exited execute loop")
@@ -1561,6 +1582,7 @@ def _execute_helper(self):
 
             self.log.info("Harvesting DAG parsing results")
             simple_dags = self.processor_agent.harvest_simple_dags()
+            self.log.debug("Harvested {} SimpleDAGs".format(len(simple_dags)))
 
             # Send tasks for execution if available
             simple_dag_bag = SimpleDagBag(simple_dags)
@@ -1598,6 +1620,8 @@ def _execute_helper(self):
             self.log.debug("Heartbeating the executor")
             self.executor.heartbeat()
 
+            self._change_state_for_tasks_failed_to_execute()
+
             # Process events from the executor
             self._process_executor_events(simple_dag_bag)
 
@@ -1617,8 +1641,13 @@ def _execute_helper(self):
             self.log.debug("Sleeping for %.2f seconds", self._processor_poll_interval)
             time.sleep(self._processor_poll_interval)
 
-            # Exit early for a test mode
+            # Exit early for a test mode, run one additional scheduler loop
+            # to reduce the possibility that parsed DAG was put into the queue
+            # by the DAG manager but not yet received by DAG agent.
             if self.processor_agent.done:
+                self._last_loop = True
+
+            if self._last_loop:
                 self.log.info("Exiting scheduler loop as all files"
                               " have been processed {} times".format(self.num_runs))
                 break
diff --git a/airflow/models.py b/airflow/models.py
index 3e09875e5f225..f11f90888e4d4 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -22,11 +22,12 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-from future.standard_library import install_aliases
-
-from builtins import str, object, bytes, ImportError as BuiltinImportError
 import copy
 from collections import namedtuple, defaultdict, OrderedDict
+
+from builtins import ImportError as BuiltinImportError, bytes, object, str
+from future.standard_library import install_aliases
+
 try:
     # Fix Python > 3.7 deprecation
     from collections.abc import Hashable
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 6adec68e15b3d..97d2c17999b83 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -148,6 +148,21 @@ def __init__(self, ti):
         self._end_date = ti.end_date
         self._try_number = ti.try_number
         self._state = ti.state
+        self._executor_config = ti.executor_config
+        if hasattr(ti, 'run_as_user'):
+            self._run_as_user = ti.run_as_user
+        else:
+            self._run_as_user = None
+        if hasattr(ti, 'pool'):
+            self._pool = ti.pool
+        else:
+            self._pool = None
+        if hasattr(ti, 'priority_weight'):
+            self._priority_weight = ti.priority_weight
+        else:
+            self._priority_weight = None
+        self._queue = ti.queue
+        self._key = ti.key
 
     @property
     def dag_id(self):
@@ -177,6 +192,49 @@ def try_number(self):
     def state(self):
         return self._state
 
+    @property
+    def pool(self):
+        return self._pool
+
+    @property
+    def priority_weight(self):
+        return self._priority_weight
+
+    @property
+    def queue(self):
+        return self._queue
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def executor_config(self):
+        return self._executor_config
+
+    @provide_session
+    def construct_task_instance(self, session=None, lock_for_update=False):
+        """
+        Construct a TaskInstance from the database based on the primary key
+
+        :param session: DB session.
+        :param lock_for_update: if True, indicates that the database should
+            lock the TaskInstance (issuing a FOR UPDATE clause) until the
+            session is committed.
+        """
+        TI = airflow.models.TaskInstance
+
+        qry = session.query(TI).filter(
+            TI.dag_id == self._dag_id,
+            TI.task_id == self._task_id,
+            TI.execution_date == self._execution_date)
+
+        if lock_for_update:
+            ti = qry.with_for_update().first()
+        else:
+            ti = qry.first()
+        return ti
+
 
 class SimpleDagBag(BaseDagBag):
     """
@@ -575,11 +633,16 @@ def end(self):
         Terminate (and then kill) the manager process launched.
         :return:
         """
-        if not self._process or not self._process.is_alive():
+        if not self._process:
             self.log.warn('Ending without manager process.')
             return
         this_process = psutil.Process(os.getpid())
-        manager_process = psutil.Process(self._process.pid)
+        try:
+            manager_process = psutil.Process(self._process.pid)
+        except psutil.NoSuchProcess:
+            self.log.info("Manager process not running.")
+            return
+
         # First try SIGTERM
         if manager_process.is_running() \
                 and manager_process.pid in [x.pid for x in this_process.children()]:
diff --git a/airflow/utils/timeout.py b/airflow/utils/timeout.py
index a86b9d357b5c6..f64800587792b 100644
--- a/airflow/utils/timeout.py
+++ b/airflow/utils/timeout.py
@@ -23,6 +23,7 @@
 from __future__ import unicode_literals
 
 import signal
+import os
 
 from airflow.exceptions import AirflowTaskTimeout
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -35,10 +36,10 @@ class timeout(LoggingMixin):
 
     def __init__(self, seconds=1, error_message='Timeout'):
         self.seconds = seconds
-        self.error_message = error_message
+        self.error_message = error_message + ', PID: ' + str(os.getpid())
 
     def handle_timeout(self, signum, frame):
-        self.log.error("Process timed out")
+        self.log.error("Process timed out, PID: " + str(os.getpid()))
         raise AirflowTaskTimeout(self.error_message)
 
     def __enter__(self):
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 380201d30a045..954e17ca03a97 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -18,12 +18,17 @@
 # under the License.
 import sys
 import unittest
+from multiprocessing import Pool
+
 import mock
 from celery.contrib.testing.worker import start_worker
 
-from airflow.executors.celery_executor import CeleryExecutor
-from airflow.executors.celery_executor import app
+from airflow.executors import celery_executor
 from airflow.executors.celery_executor import CELERY_FETCH_ERR_MSG_HEADER
+from airflow.executors.celery_executor import (CeleryExecutor, celery_configuration,
+                                               send_task_to_executor, execute_command)
+from airflow.executors.celery_executor import app
+from celery import states as celery_states
 from airflow.utils.state import State
 
 from airflow import configuration
@@ -40,16 +45,37 @@ def test_celery_integration(self):
         executor = CeleryExecutor()
         executor.start()
         with start_worker(app=app, logfile=sys.stdout, loglevel='debug'):
-
             success_command = ['true', 'some_parameter']
             fail_command = ['false', 'some_parameter']
 
-            executor.execute_async(key='success', command=success_command)
-            # errors are propagated for some reason
-            try:
-                executor.execute_async(key='fail', command=fail_command)
-            except Exception:
-                pass
+            cached_celery_backend = execute_command.backend
+            task_tuples_to_send = [('success', 'fake_simple_ti', success_command,
+                                    celery_configuration['task_default_queue'],
+                                    execute_command),
+                                   ('fail', 'fake_simple_ti', fail_command,
+                                    celery_configuration['task_default_queue'],
+                                    execute_command)]
+
+            chunksize = executor._num_tasks_per_send_process(len(task_tuples_to_send))
+            num_processes = min(len(task_tuples_to_send), executor._sync_parallelism)
+
+            send_pool = Pool(processes=num_processes)
+            key_and_async_results = send_pool.map(
+                send_task_to_executor,
+                task_tuples_to_send,
+                chunksize=chunksize)
+
+            send_pool.close()
+            send_pool.join()
+
+            for key, command, result in key_and_async_results:
+                # Only pops when enqueued successfully, otherwise keep it
+                # and expect scheduler loop to deal with it.
+                result.backend = cached_celery_backend
+                executor.running[key] = command
+                executor.tasks[key] = result
+                executor.last_state[key] = celery_states.PENDING
+
             executor.running['success'] = True
             executor.running['fail'] = True
 
@@ -64,6 +90,23 @@ def test_celery_integration(self):
         self.assertNotIn('success', executor.last_state)
         self.assertNotIn('fail', executor.last_state)
 
+    @unittest.skipIf('sqlite' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                     "sqlite is configured with SequentialExecutor")
+    def test_error_sending_task(self):
+        @app.task
+        def fake_execute_command():
+            pass
+
+        # fake_execute_command takes no arguments while execute_command takes 1,
+        # which will cause TypeError when calling task.apply_async()
+        celery_executor.execute_command = fake_execute_command
+        executor = CeleryExecutor()
+        value_tuple = 'command', '_', 'queue', 'should_be_a_simple_ti'
+        executor.queued_tasks['key'] = value_tuple
+        executor.heartbeat()
+        self.assertEquals(1, len(executor.queued_tasks))
+        self.assertEquals(executor.queued_tasks['key'], value_tuple)
+
     def test_exception_propagation(self):
         @app.task
         def fake_celery_task():
diff --git a/tests/executors/test_executor.py b/tests/executors/test_executor.py
index aab66644b8a76..366ea8c967cce 100644
--- a/tests/executors/test_executor.py
+++ b/tests/executors/test_executor.py
@@ -46,7 +46,8 @@ def heartbeat(self):
                 ti = self._running.pop()
                 ti.set_state(State.SUCCESS, session)
             for key, val in list(self.queued_tasks.items()):
-                (command, priority, queue, ti) = val
+                (command, priority, queue, simple_ti) = val
+                ti = simple_ti.construct_task_instance()
                 ti.set_state(State.RUNNING, session)
                 self._running.append(ti)
                 self.queued_tasks.pop(key)
diff --git a/tests/jobs.py b/tests/jobs.py
index 8581c03fd0112..e3195f86c8a8b 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -2160,6 +2160,54 @@ def test_change_state_for_tis_without_dagrun(self):
         ti2.refresh_from_db(session=session)
         self.assertEqual(ti2.state, State.SCHEDULED)
 
+    def test_change_state_for_tasks_failed_to_execute(self):
+        dag = DAG(
+            dag_id='dag_id',
+            start_date=DEFAULT_DATE)
+
+        task = DummyOperator(
+            task_id='task_id',
+            dag=dag,
+            owner='airflow')
+
+        # If there's no left over task in executor.queued_tasks, nothing happens
+        session = settings.Session()
+        scheduler_job = SchedulerJob()
+        mock_logger = mock.MagicMock()
+        test_executor = TestExecutor()
+        scheduler_job.executor = test_executor
+        scheduler_job._logger = mock_logger
+        scheduler_job._change_state_for_tasks_failed_to_execute()
+        mock_logger.info.assert_not_called()
+
+        # Tasks failed to execute with QUEUED state will be set to SCHEDULED state.
+        session.query(TI).delete()
+        session.commit()
+        key = 'dag_id', 'task_id', DEFAULT_DATE, 1
+        test_executor.queued_tasks[key] = 'value'
+        ti = TI(task, DEFAULT_DATE)
+        ti.state = State.QUEUED
+        session.merge(ti)
+        session.commit()
+
+        scheduler_job._change_state_for_tasks_failed_to_execute()
+
+        ti.refresh_from_db()
+        self.assertEquals(State.SCHEDULED, ti.state)
+
+        # Tasks failed to execute with RUNNING state will not be set to SCHEDULED state.
+        session.query(TI).delete()
+        session.commit()
+        ti.state = State.RUNNING
+
+        session.merge(ti)
+        session.commit()
+
+        scheduler_job._change_state_for_tasks_failed_to_execute()
+
+        ti.refresh_from_db()
+        self.assertEquals(State.RUNNING, ti.state)
+
     def test_execute_helper_reset_orphaned_tasks(self):
         session = settings.Session()
         dag = DAG(
@@ -3136,7 +3184,8 @@ def run_with_error(task):
                 pass
 
         ti_tuple = six.next(six.itervalues(executor.queued_tasks))
-        (command, priority, queue, ti) = ti_tuple
+        (command, priority, queue, simple_ti) = ti_tuple
+        ti = simple_ti.construct_task_instance()
         ti.task = dag_task1
 
         self.assertEqual(ti.try_number, 1)
@@ -3157,15 +3206,21 @@ def run_with_error(task):
         # removing self.assertEqual(ti.state, State.SCHEDULED)
         # as scheduler will move state from SCHEDULED to QUEUED
 
-        # now the executor has cleared and it should be allowed the re-queue
+        # now the executor has cleared and it should be allowed the re-queue,
+        # but tasks stay in the executor.queued_tasks after executor.heartbeat()
+        # will be set back to SCHEDULED state
         executor.queued_tasks.clear()
         do_schedule()
         ti.refresh_from_db()
-        self.assertEqual(ti.state, State.QUEUED)
-        # calling below again in order to ensure with try_number 2,
-        # scheduler doesn't put task in queue
+
+        self.assertEqual(ti.state, State.SCHEDULED)
+
+        # To verify that task does get re-queued.
+        executor.queued_tasks.clear()
+        executor.do_update = True
         do_schedule()
-        self.assertEquals(1, len(executor.queued_tasks))
+        ti.refresh_from_db()
+        self.assertEqual(ti.state, State.RUNNING)
 
     @unittest.skipUnless("INTEGRATION" in os.environ, "Can only run end to end")
     def test_retry_handling_job(self):
@@ -3210,8 +3265,8 @@ def test_scheduler_run_duration(self):
         logging.info("Test ran in %.2fs, expected %.2fs",
                      run_duration,
                      expected_run_duration)
-        # 5s to wait for child process to exit and 1s dummy sleep
-        # in scheduler loop to prevent excessive logs.
+        # 5s to wait for child process to exit, 1s dummy sleep
+        # in scheduler loop to prevent excessive logs and 1s for last loop to finish.
         self.assertLess(run_duration - expected_run_duration, 6.0)
 
     def test_dag_with_system_exit(self):

From 4f277394eaba0f37733671faa21a8ba9a2e0df97 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 21 Feb 2019 08:59:44 +0800
Subject: [PATCH 574/808] [AIRFLOW-3905] Allow using "parameters" in SqlSensor
 (#4723)

* [AIRFLOW-3905] Allow 'parameters' in SqlSensor

* Add check on conn_type & add test

Not all SQL-related connections are supported by SqlSensor,
due to limitation in Connection model and hook implementation.
---
 airflow/sensors/sql_sensor.py    | 23 +++++++++++++++----
 tests/sensors/test_sql_sensor.py | 39 ++++++++++++++++++++++++++++----
 2 files changed, 53 insertions(+), 9 deletions(-)

diff --git a/airflow/sensors/sql_sensor.py b/airflow/sensors/sql_sensor.py
index de46e6d3db9b8..9a1b11fc50b1a 100644
--- a/airflow/sensors/sql_sensor.py
+++ b/airflow/sensors/sql_sensor.py
@@ -19,6 +19,7 @@
 
 from builtins import str
 
+from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.utils.decorators import apply_defaults
@@ -33,22 +34,34 @@ class SqlSensor(BaseSensorOperator):
     :type conn_id: str
     :param sql: The sql to run. To pass, it needs to return at least one cell
         that contains a non-zero / empty string value.
+    :type sql: str
+    :param parameters: The parameters to render the SQL query with (optional).
+    :type parameters: mapping or iterable
     """
     template_fields = ('sql',)
     template_ext = ('.hql', '.sql',)
     ui_color = '#7c7287'
 
     @apply_defaults
-    def __init__(self, conn_id, sql, *args, **kwargs):
-        self.sql = sql
+    def __init__(self, conn_id, sql, parameters=None, *args, **kwargs):
         self.conn_id = conn_id
+        self.sql = sql
+        self.parameters = parameters
         super(SqlSensor, self).__init__(*args, **kwargs)
 
     def poke(self, context):
-        hook = BaseHook.get_connection(self.conn_id).get_hook()
+        conn = BaseHook.get_connection(self.conn_id)
+
+        allowed_conn_type = {'google_cloud_platform', 'jdbc', 'mssql',
+                             'mysql', 'oracle', 'postgres',
+                             'presto', 'sqlite', 'vertica'}
+        if conn.conn_type not in allowed_conn_type:
+            raise AirflowException("The connection type is not supported by SqlSensor. " +
+                                   "Supported connection types: {}".format(list(allowed_conn_type)))
+        hook = conn.get_hook()
 
-        self.log.info('Poking: %s', self.sql)
-        records = hook.get_records(self.sql)
+        self.log.info('Poking: %s (with parameters %s)', self.sql, self.parameters)
+        records = hook.get_records(self.sql, self.parameters)
         if not records:
             return False
         else:
diff --git a/tests/sensors/test_sql_sensor.py b/tests/sensors/test_sql_sensor.py
index 81bcdd1691919..0b25d58056eda 100644
--- a/tests/sensors/test_sql_sensor.py
+++ b/tests/sensors/test_sql_sensor.py
@@ -21,6 +21,7 @@
 
 from airflow import DAG
 from airflow import configuration
+from airflow.exceptions import AirflowException
 from airflow.sensors.sql_sensor import SqlSensor
 from airflow.utils.timezone import datetime
 
@@ -39,27 +40,56 @@ def setUp(self):
         }
         self.dag = DAG(TEST_DAG_ID, default_args=args)
 
+    def test_unsupported_conn_type(self):
+        t = SqlSensor(
+            task_id='sql_sensor_check',
+            conn_id='redis_default',
+            sql="SELECT count(1) FROM INFORMATION_SCHEMA.TABLES",
+            dag=self.dag
+        )
+
+        with self.assertRaises(AirflowException):
+            t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+
     @unittest.skipUnless(
         'mysql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a mysql test")
     def test_sql_sensor_mysql(self):
-        t = SqlSensor(
+        t1 = SqlSensor(
             task_id='sql_sensor_check',
             conn_id='mysql_default',
             sql="SELECT count(1) FROM INFORMATION_SCHEMA.TABLES",
             dag=self.dag
         )
-        t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+        t1.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+
+        t2 = SqlSensor(
+            task_id='sql_sensor_check',
+            conn_id='mysql_default',
+            sql="SELECT count(%s) FROM INFORMATION_SCHEMA.TABLES",
+            parameters=["table_name"],
+            dag=self.dag
+        )
+        t2.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
     @unittest.skipUnless(
         'postgresql' in configuration.conf.get('core', 'sql_alchemy_conn'), "this is a postgres test")
     def test_sql_sensor_postgres(self):
-        t = SqlSensor(
+        t1 = SqlSensor(
             task_id='sql_sensor_check',
             conn_id='postgres_default',
             sql="SELECT count(1) FROM INFORMATION_SCHEMA.TABLES",
             dag=self.dag
         )
-        t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+        t1.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
+
+        t2 = SqlSensor(
+            task_id='sql_sensor_check',
+            conn_id='postgres_default',
+            sql="SELECT count(%s) FROM INFORMATION_SCHEMA.TABLES",
+            parameters=["table_name"],
+            dag=self.dag
+        )
+        t2.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
     @mock.patch('airflow.sensors.sql_sensor.BaseHook')
     def test_sql_sensor_postgres_poke(self, mock_hook):
@@ -69,6 +99,7 @@ def test_sql_sensor_postgres_poke(self, mock_hook):
             sql="SELECT 1",
         )
 
+        mock_hook.get_connection('postgres_default').conn_type = "postgres"
         mock_get_records = mock_hook.get_connection.return_value.get_hook.return_value.get_records
 
         mock_get_records.return_value = []

From f3dcc1ff2d35c65cd74b74da20a1ce628e7cf4ed Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Wed, 30 Jan 2019 22:50:13 -0800
Subject: [PATCH 575/808] [AIRFLOW-XXX] Add a doc about fab security (#4595)

---
 docs/security.rst | 149 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 149 insertions(+)

diff --git a/docs/security.rst b/docs/security.rst
index d309ca629c2c7..879ae8c62a564 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -441,3 +441,152 @@ command, or as a configuration item in your ``airflow.cfg``. For both cases, ple
 
     [celery]
     flower_basic_auth = user1:password1,user2:password2
+
+
+RBAC UI Security
+----------------
+
+Security of Airflow Webserver UI when running with ``rbac=True`` in the config is handled by Flask AppBuilder (FAB).
+Please read its related `security document <http://flask-appbuilder.readthedocs.io/en/latest/security.html>`_
+regarding its security model.
+
+Default Roles
+'''''''''''''
+Airflow ships with a set of roles by default: Admin, User, Op, Viewer, and Public.
+Only ``Admin`` users could configure/alter the permissions for other roles. But it is not recommended
+that ``Admin`` users alter these default roles in any way by removing
+or adding permissions to these roles.
+
+Admin
+^^^^^
+``Admin`` users have all possible permissions, including granting or revoking permissions from
+other users.
+
+Public
+^^^^^^
+``Public`` users (anonymous) don't have any permissions.
+
+Viewer
+^^^^^^
+``Viewer`` users have limited viewer permissions
+
+.. code:: python
+
+    VIEWER_PERMS = {
+        'menu_access',
+        'can_index',
+        'can_list',
+        'can_show',
+        'can_chart',
+        'can_dag_stats',
+        'can_dag_details',
+        'can_task_stats',
+        'can_code',
+        'can_log',
+        'can_get_logs_with_metadata',
+        'can_tries',
+        'can_graph',
+        'can_tree',
+        'can_task',
+        'can_task_instances',
+        'can_xcom',
+        'can_gantt',
+        'can_landing_times',
+        'can_duration',
+        'can_blocked',
+        'can_rendered',
+        'can_pickle_info',
+        'can_version',
+    }
+
+on limited web views
+
+.. code:: python
+
+    VIEWER_VMS = {
+        'Airflow',
+        'DagModelView',
+        'Browse',
+        'DAG Runs',
+        'DagRunModelView',
+        'Task Instances',
+        'TaskInstanceModelView',
+        'SLA Misses',
+        'SlaMissModelView',
+        'Jobs',
+        'JobModelView',
+        'Logs',
+        'LogModelView',
+        'Docs',
+        'Documentation',
+        'Github',
+        'About',
+        'Version',
+        'VersionView',
+    }
+
+User
+^^^^
+``User`` users have ``Viewer`` permissions plus additional user permissions
+
+.. code:: python
+
+    USER_PERMS = {
+        'can_dagrun_clear',
+        'can_run',
+        'can_trigger',
+        'can_add',
+        'can_edit',
+        'can_delete',
+        'can_paused',
+        'can_refresh',
+        'can_success',
+        'muldelete',
+        'set_failed',
+        'set_running',
+        'set_success',
+        'clear',
+        'can_clear',
+    }
+
+
+on User web views which is the same as Viewer web views.
+
+Op
+^^
+``Op`` users have ``User`` permissions plus additional op permissions
+
+.. code:: python
+
+    OP_PERMS = {
+        'can_conf',
+        'can_varimport',
+    }
+
+on ``User`` web views plus these additional op web views
+
+.. code:: python
+
+    OP_VMS = {
+        'Admin',
+        'Configurations',
+        'ConfigurationView',
+        'Connections',
+        'ConnectionModelView',
+        'Pools',
+        'PoolModelView',
+        'Variables',
+        'VariableModelView',
+        'XComs',
+        'XComModelView',
+    }
+
+Custom Roles
+'''''''''''''
+
+DAG Level Role
+^^^^^^^^^^^^^^
+``Admin`` can create a set of roles which are only allowed to view a certain set of dags. This is called DAG level access. Each dag defined in the dag model table
+is treated as a ``View`` which has two permissions associated with it (``can_dag_read`` and ``can_dag_edit``). There is a special view called ``all_dags`` which
+allows the role to access all the dags. The default ``Admin``, ``Viewer``, ``User``, ``Op`` roles can all access ``all_dags`` view.
+

From 8b339481cec14e5ee240d4b31f8543ea3210c35a Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Thu, 21 Feb 2019 21:50:05 +1100
Subject: [PATCH 576/808] [AIRFLOW-3933] Fix various typos (#4747)

Fix typos
---
 CONTRIBUTING.md                                         | 3 +--
 UPDATING.md                                             | 2 +-
 airflow/contrib/example_dags/example_qubole_operator.py | 4 ++--
 airflow/contrib/hooks/azure_data_lake_hook.py           | 2 +-
 airflow/contrib/hooks/fs_hook.py                        | 2 +-
 airflow/contrib/hooks/qubole_hook.py                    | 2 +-
 airflow/contrib/hooks/salesforce_hook.py                | 2 +-
 airflow/contrib/operators/awsbatch_operator.py          | 2 +-
 airflow/contrib/operators/bigquery_check_operator.py    | 2 +-
 airflow/contrib/operators/cassandra_to_gcs.py           | 4 ++--
 airflow/contrib/operators/dataflow_operator.py          | 2 +-
 airflow/contrib/operators/dataproc_operator.py          | 2 +-
 airflow/contrib/operators/druid_operator.py             | 2 +-
 airflow/operators/druid_check_operator.py               | 2 +-
 airflow/operators/presto_check_operator.py              | 2 +-
 airflow/www/app.py                                      | 2 +-
 airflow/www_rbac/app.py                                 | 2 +-
 dev/airflow-pr                                          | 2 +-
 docs/howto/operator.rst                                 | 2 +-
 docs/installation.rst                                   | 2 +-
 docs/project.rst                                        | 2 +-
 docs/security.rst                                       | 2 +-
 22 files changed, 24 insertions(+), 25 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f1dedc98fac0f..f9be5d52789b3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -263,7 +263,7 @@ The JIRA link should also be contained in the PR description.
 4. Preface your commit's subject & PR's title with **[AIRFLOW-XXX]**
 where *XXX* is the JIRA number. We compose release notes (i.e. for Airflow releases) from all commit titles in a release.
 By placing the JIRA number in the commit title and hence in the release notes,
-Airflow users can look into JIRA and Github PRs for more details about a particular change.
+Airflow users can look into JIRA and GitHub PRs for more details about a particular change.
 5. Add an [Apache License](http://www.apache.org/legal/src-headers.html)
  header to all new files
 6. If the pull request adds functionality, the docs should be updated as part
@@ -285,7 +285,6 @@ using `flake8 airflow tests`. `git diff upstream/master -u -- "*.py" | flake8 --
 commit messages and adhere to them. It makes the lives of those who
 come after you a lot easier.
 
-
 ### Changing the Metadata Database
 
 When developing features the need may arise to persist information to the the
diff --git a/UPDATING.md b/UPDATING.md
index 29c62bca2156c..ca159b9366333 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -60,7 +60,7 @@ environment variables rather than checking for the presence of a file.
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
-`ts_nodash` previously contained TimeZone information alongwith execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes. 
+`ts_nodash` previously contained TimeZone information along with execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes.
 
 Examples:
   * `ts_nodash`: `20150101T000000`
diff --git a/airflow/contrib/example_dags/example_qubole_operator.py b/airflow/contrib/example_dags/example_qubole_operator.py
index 826a50af99cd9..5f77d09ba1442 100644
--- a/airflow/contrib/example_dags/example_qubole_operator.py
+++ b/airflow/contrib/example_dags/example_qubole_operator.py
@@ -65,7 +65,7 @@ def compare_result(ds, **kwargs):
     fetch_logs=True,
     # If `fetch_logs`=true, will fetch qubole command logs and concatenate
     # them into corresponding airflow task logs
-    tags='aiflow_example_run',
+    tags='airflow_example_run',
     # To attach tags to qubole command, auto attach 3 tags - dag_id, task_id, run_id
     qubole_conn_id='qubole_default',
     # Connection id to submit commands inside QDS, if not set "qubole_default" is used
@@ -220,7 +220,7 @@ def main(args: Array[String]) {
     program=prog,
     language='scala',
     arguments='--class SparkPi',
-    tags='aiflow_example_run',
+    tags='airflow_example_run',
     dag=dag)
 
 t11.set_upstream(branching)
diff --git a/airflow/contrib/hooks/azure_data_lake_hook.py b/airflow/contrib/hooks/azure_data_lake_hook.py
index 74ae1948099e8..049fadbb78274 100644
--- a/airflow/contrib/hooks/azure_data_lake_hook.py
+++ b/airflow/contrib/hooks/azure_data_lake_hook.py
@@ -77,7 +77,7 @@ def upload_file(self, local_path, remote_path, nthreads=64, overwrite=True,
             are not supported.
         :type local_path: str
         :param remote_path: Remote path to upload to; if multiple files, this is the
-            dircetory root to write within.
+            directory root to write within.
         :type remote_path: str
         :param nthreads: Number of threads to use. If None, uses the number of cores.
         :type nthreads: int
diff --git a/airflow/contrib/hooks/fs_hook.py b/airflow/contrib/hooks/fs_hook.py
index 6832f20c225c1..1aa528b6205dc 100644
--- a/airflow/contrib/hooks/fs_hook.py
+++ b/airflow/contrib/hooks/fs_hook.py
@@ -30,7 +30,7 @@ class FSHook(BaseHook):
     example:
     Conn Id: fs_test
     Conn Type: File (path)
-    Host, Shchema, Login, Password, Port: empty
+    Host, Schema, Login, Password, Port: empty
     Extra: {"path": "/tmp"}
     """
 
diff --git a/airflow/contrib/hooks/qubole_hook.py b/airflow/contrib/hooks/qubole_hook.py
index 2aac592bf3ebe..43eb5e6f82e15 100755
--- a/airflow/contrib/hooks/qubole_hook.py
+++ b/airflow/contrib/hooks/qubole_hook.py
@@ -176,7 +176,7 @@ def get_jobs_id(self, ti):
         """
         Get jobs associated with a Qubole commands
         :param ti: Task Instance of the dag, used to determine the Quboles command id
-        :return: Job informations assoiciated with command
+        :return: Job information associated with command
         """
         if self.cmd is None:
             cmd_id = ti.xcom_pull(key="qbol_cmd_id", task_ids=self.task_id)
diff --git a/airflow/contrib/hooks/salesforce_hook.py b/airflow/contrib/hooks/salesforce_hook.py
index efc819e543995..8c2d2f8e93b4a 100644
--- a/airflow/contrib/hooks/salesforce_hook.py
+++ b/airflow/contrib/hooks/salesforce_hook.py
@@ -276,7 +276,7 @@ def write_object_to_file(
 
             schema = self.describe_object(object_name)
 
-            # possible columns that can be convereted to timestamps
+            # possible columns that can be converted to timestamps
             # are the ones that are either date or datetime types
             # strings are too general and we risk unintentional conversion
             possible_timestamp_cols = [
diff --git a/airflow/contrib/operators/awsbatch_operator.py b/airflow/contrib/operators/awsbatch_operator.py
index bb5be459c5a12..c0b96d819c820 100644
--- a/airflow/contrib/operators/awsbatch_operator.py
+++ b/airflow/contrib/operators/awsbatch_operator.py
@@ -33,7 +33,7 @@ class AWSBatchOperator(BaseOperator):
     """
     Execute a job on AWS Batch Service
 
-    .. warning: the queue parameter was renamed to job_queue to segreggate the
+    .. warning: the queue parameter was renamed to job_queue to segregate the
                 internal CeleryExecutor queue from the AWS Batch internal queue.
 
     :param job_name: the name for the job that will run on AWS Batch
diff --git a/airflow/contrib/operators/bigquery_check_operator.py b/airflow/contrib/operators/bigquery_check_operator.py
index 247a1ae7fba1b..afb600a3d9120 100644
--- a/airflow/contrib/operators/bigquery_check_operator.py
+++ b/airflow/contrib/operators/bigquery_check_operator.py
@@ -48,7 +48,7 @@ class BigQueryCheckOperator(CheckOperator):
     This operator can be used as a data quality check in your pipeline, and
     depending on where you put it in your DAG, you have the choice to
     stop the critical path, preventing from
-    publishing dubious data, or on the side and receive email alterts
+    publishing dubious data, or on the side and receive email alerts
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
diff --git a/airflow/contrib/operators/cassandra_to_gcs.py b/airflow/contrib/operators/cassandra_to_gcs.py
index 95107a497fd61..6819eca404ebb 100644
--- a/airflow/contrib/operators/cassandra_to_gcs.py
+++ b/airflow/contrib/operators/cassandra_to_gcs.py
@@ -266,7 +266,7 @@ def convert_tuple_type(cls, name, value):
         """
         Converts a tuple to RECORD that contains n fields, each will be converted
         to its corresponding data type in bq and will be named 'field_<index>', where
-        index is determined by the order of the tuple elments defined in cassandra.
+        index is determined by the order of the tuple elements defined in cassandra.
         """
         names = ['field_' + str(i) for i in range(len(value))]
         values = [cls.convert_value(name, value) for name, value in zip(names, value)]
@@ -276,7 +276,7 @@ def convert_tuple_type(cls, name, value):
     def convert_map_type(cls, name, value):
         """
         Converts a map to a repeated RECORD that contains two fields: 'key' and 'value',
-        each will be converted to its corresopnding data type in BQ.
+        each will be converted to its corresponding data type in BQ.
         """
         converted_map = []
         for k, v in zip(value.keys(), value.values()):
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 77c0063d60b69..430042990fad0 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -58,7 +58,7 @@ class DataFlowJavaOperator(BaseOperator):
         Cloud Platform for the dataflow job status while the job is in the
         JOB_STATE_RUNNING state.
     :type poll_sleep: int
-    :param job_class: The name of the dataflow job class to be executued, it
+    :param job_class: The name of the dataflow job class to be executed, it
         is often not the main class configured in the dataflow jar file.
     :type job_class: str
 
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 6694092d2d568..9a0a47279b191 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -1369,7 +1369,7 @@ def execute(self, context):
         self.hook.wait(self.start())
 
     def start(self, context):
-        raise AirflowException('plese start a workflow operation')
+        raise AirflowException('Please start a workflow operation')
 
 
 class DataprocWorkflowTemplateInstantiateOperator(DataprocWorkflowTemplateBaseOperator):
diff --git a/airflow/contrib/operators/druid_operator.py b/airflow/contrib/operators/druid_operator.py
index 1436d99f28d6f..75d552fec5a5b 100644
--- a/airflow/contrib/operators/druid_operator.py
+++ b/airflow/contrib/operators/druid_operator.py
@@ -60,5 +60,5 @@ def execute(self, context):
             druid_ingest_conn_id=self.conn_id,
             max_ingestion_time=self.max_ingestion_time
         )
-        self.log.info("Sumitting %s", self.index_spec_str)
+        self.log.info("Submitting %s", self.index_spec_str)
         hook.submit_indexing_job(self.index_spec_str)
diff --git a/airflow/operators/druid_check_operator.py b/airflow/operators/druid_check_operator.py
index 39674fdd3983e..514f61fc88988 100644
--- a/airflow/operators/druid_check_operator.py
+++ b/airflow/operators/druid_check_operator.py
@@ -47,7 +47,7 @@ class DruidCheckOperator(CheckOperator):
     This operator can be used as a data quality check in your pipeline, and
     depending on where you put it in your DAG, you have the choice to
     stop the critical path, preventing from
-    publishing dubious data, or on the side and receive email alterts
+    publishing dubious data, or on the side and receive email alerts
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
diff --git a/airflow/operators/presto_check_operator.py b/airflow/operators/presto_check_operator.py
index 16f5bc0212a15..d70dcaa7d25af 100644
--- a/airflow/operators/presto_check_operator.py
+++ b/airflow/operators/presto_check_operator.py
@@ -48,7 +48,7 @@ class PrestoCheckOperator(CheckOperator):
     This operator can be used as a data quality check in your pipeline, and
     depending on where you put it in your DAG, you have the choice to
     stop the critical path, preventing from
-    publishing dubious data, or on the side and receive email alterts
+    publishing dubious data, or on the side and receive email alerts
     without stopping the progress of the DAG.
 
     :param sql: the sql to be executed
diff --git a/airflow/www/app.py b/airflow/www/app.py
index 22c41bc18d046..d85caa5de3ad8 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -119,7 +119,7 @@ def create_app(config=None, testing=False):
             url='https://airflow.apache.org/'))
         admin.add_link(
             base.MenuLink(category='Docs',
-                          name='Github',
+                          name='GitHub',
                           url='https://github.com/apache/airflow'))
 
         av(vs.VersionView(name='Version', category="About"))
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 185f308f36889..bb13dd649b07e 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -134,7 +134,7 @@ def init_views(appbuilder):
                                 href='https://airflow.apache.org/',
                                 category="Docs",
                                 category_icon="fa-cube")
-            appbuilder.add_link("Github",
+            appbuilder.add_link("GitHub",
                                 href='https://github.com/apache/airflow',
                                 category="Docs")
             appbuilder.add_link('Version',
diff --git a/dev/airflow-pr b/dev/airflow-pr
index da996d1d6aa48..9b499ec0c2a53 100755
--- a/dev/airflow-pr
+++ b/dev/airflow-pr
@@ -63,7 +63,7 @@ AIRFLOW_GIT_LOCATION = os.environ.get(
     "AIRFLOW_GIT",
     os.path.dirname(os.path.dirname(os.path.realpath(__file__))))
 
-# Remote name which points to the Gihub site
+# Remote name which points to the GitHub site
 GITHUB_REMOTE_NAME = os.environ.get("GITHUB_REMOTE_NAME", "github")
 # OAuth key used for issuing requests against the GitHub API. If this is not
 # defined, then requests will be unauthenticated. You should only need to
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 3f6cd628a402e..05a588f2efe90 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -514,7 +514,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Advanced
 """"""""
 
-When creating a table, you can specify the optional ``initial_split_keys`` and ``column_familes``.
+When creating a table, you can specify the optional ``initial_split_keys`` and ``column_families``.
 Please refer to the Python Client for Google Cloud Bigtable documentation
 `for Table <https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html>`_ and `for Column
 Families <https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html>`_.
diff --git a/docs/installation.rst b/docs/installation.rst
index 2c9436e2f997b..33c71439d241e 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -71,7 +71,7 @@ Here's the list of the subpackages and what they enable:
 | gcp_api             | ``pip install apache-airflow[gcp_api]``           | Google Cloud Platform hooks and operators       |
 |                     |                                                   | (using ``google-api-python-client``)            |
 +---------------------+---------------------------------------------------+-------------------------------------------------+
-| github_enterprise   | ``pip install apache-airflow[github_enterprise]`` | Github Enterprise auth backend                  |
+| github_enterprise   | ``pip install apache-airflow[github_enterprise]`` | GitHub Enterprise auth backend                  |
 +---------------------+---------------------------------------------------+-------------------------------------------------+
 | google_auth         | ``pip install apache-airflow[google_auth]``       | Google auth backend                             |
 +---------------------+---------------------------------------------------+-------------------------------------------------+
diff --git a/docs/project.rst b/docs/project.rst
index 2554702a8a1e0..0c35096c9b458 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -23,7 +23,7 @@ History
 
 Airflow was started in October 2014 by Maxime Beauchemin at Airbnb.
 It was open source from the very first commit and officially brought under
-the Airbnb Github and announced in June 2015.
+the Airbnb GitHub and announced in June 2015.
 
 The project joined the Apache Software Foundation's incubation program in March 2016.
 
diff --git a/docs/security.rst b/docs/security.rst
index 879ae8c62a564..1234f90c2f364 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -519,7 +519,7 @@ on limited web views
         'LogModelView',
         'Docs',
         'Documentation',
-        'Github',
+        'GitHub',
         'About',
         'Version',
         'VersionView',

From c67a3960f25cf31501dd80546ed56f686b5b4637 Mon Sep 17 00:00:00 2001
From: wmorris75 <waynemorris75@gmail.com>
Date: Sat, 20 Oct 2018 09:43:40 -0400
Subject: [PATCH 577/808] [AIRFLOW-2993] s3_to_sftp and sftp_to_s3 operators
 (#3828)

Add operators for transferring files between s3 and sftp.
---
 .../contrib/operators/s3_to_sftp_operator.py  |  84 +++++++++
 .../contrib/operators/sftp_to_s3_operator.py  |  89 ++++++++++
 .../operators/test_s3_to_sftp_operator.py     | 167 ++++++++++++++++++
 .../operators/test_sftp_to_s3_operator.py     | 144 +++++++++++++++
 4 files changed, 484 insertions(+)
 create mode 100644 airflow/contrib/operators/s3_to_sftp_operator.py
 create mode 100644 airflow/contrib/operators/sftp_to_s3_operator.py
 create mode 100644 tests/contrib/operators/test_s3_to_sftp_operator.py
 create mode 100644 tests/contrib/operators/test_sftp_to_s3_operator.py

diff --git a/airflow/contrib/operators/s3_to_sftp_operator.py b/airflow/contrib/operators/s3_to_sftp_operator.py
new file mode 100644
index 0000000000000..7e02e97cd24e4
--- /dev/null
+++ b/airflow/contrib/operators/s3_to_sftp_operator.py
@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import BaseOperator
+from airflow.hooks.S3_hook import S3Hook
+from airflow.contrib.hooks.ssh_hook import SSHHook
+from tempfile import NamedTemporaryFile
+from urllib.parse import urlparse
+from airflow.utils.decorators import apply_defaults
+
+
+class S3ToSFTPOperator(BaseOperator):
+    """
+    This operator enables the transferring of files from S3 to a SFTP server
+    :param sftp_conn_id:    The sftp connection id. The name or
+                            identifier for establishing a connection to the SFTP server.
+    :type sftp_conn_id:     string
+    :param sftp_path:       The sftp remote path. This is the specified
+                            file path for uploading file to the SFTP server.
+    :type sftp_path:        string
+    :param s3_conn_id:      The s3 connnection id. The name or identifier for establishing
+                            a connection to S3
+    :type s3_conn_id:       string
+    :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
+                            from where the file is downloaded.
+    :type s3_bucket:        string
+    :param s3_key:          The targeted s3 key. This is the specified file path
+                            for downloading the file from S3.
+    :type s3_key:           string
+    """
+
+    template_fields = ('s3_key', 'sftp_path')
+
+    @apply_defaults
+    def __init__(self,
+                 s3_bucket,
+                 s3_key,
+                 sftp_path,
+                 sftp_conn_id='ssh_default',
+                 s3_conn_id='aws_default',
+                 *args,
+                 **kwargs):
+        super(S3ToSFTPOperator, self).__init__(*args, **kwargs)
+        self.sftp_conn_id = sftp_conn_id
+        self.sftp_path = sftp_path
+        self.s3_bucket = s3_bucket
+        self.s3_key = s3_key
+        self.s3_conn_id = s3_conn_id
+
+    @staticmethod
+    def get_s3_key(s3_key):
+        """This parses the correct format for S3 keys
+            regardless of how the S3 url is passed."""
+
+        parsed_s3_key = urlparse(s3_key)
+        return parsed_s3_key.path.lstrip('/')
+
+    def execute(self, context):
+        self.s3_key = self.get_s3_key(self.s3_key)
+        ssh_hook = SSHHook(ssh_conn_id=self.sftp_conn_id)
+        s3_hook = S3Hook(self.s3_conn_id)
+
+        s3_client = s3_hook.get_conn()
+        sftp_client = ssh_hook.get_conn().open_sftp()
+
+        with NamedTemporaryFile("w") as f:
+            s3_client.download_file(self.s3_bucket, self.s3_key, f.name)
+            sftp_client.put(f.name, self.sftp_path)
diff --git a/airflow/contrib/operators/sftp_to_s3_operator.py b/airflow/contrib/operators/sftp_to_s3_operator.py
new file mode 100644
index 0000000000000..b0ed1e16a3630
--- /dev/null
+++ b/airflow/contrib/operators/sftp_to_s3_operator.py
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import BaseOperator
+from airflow.hooks.S3_hook import S3Hook
+from airflow.contrib.hooks.ssh_hook import SSHHook
+from tempfile import NamedTemporaryFile
+from urllib.parse import urlparse
+from airflow.utils.decorators import apply_defaults
+
+
+class SFTPToS3Operator(BaseOperator):
+    """
+    This operator enables the transferring of files from a SFTP server to Amazon S3
+    :param sftp_conn_id:    The sftp connection id. The name or identifier for
+                            establishing a connection to the SFTP server.
+    :type sftp_conn_id:     string
+    :param sftp_path:       The sftp remote path. This is the specified file
+                            path for downloading the file from the SFTP server.
+    :type sftp_path:        string
+    :param s3_conn_id:      The s3 connnection id. The name or identifier for
+                            establishing a connection to S3
+    :type s3_conn_id:       string
+    :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
+                            to where the file is uploaded.
+    :type s3_bucket:        string
+    :param s3_key:          The targeted s3 key. This is the specified path
+                            for uploading the file to S3.
+    :type s3_key:           string
+    """
+
+    template_fields = ('s3_key', 'sftp_path')
+
+    @apply_defaults
+    def __init__(self,
+                 s3_bucket,
+                 s3_key,
+                 sftp_path,
+                 sftp_conn_id='ssh_default',
+                 s3_conn_id='aws_default',
+                 *args,
+                 **kwargs):
+        super(SFTPToS3Operator, self).__init__(*args, **kwargs)
+        self.sftp_conn_id = sftp_conn_id
+        self.sftp_path = sftp_path
+        self.s3_bucket = s3_bucket
+        self.s3_key = s3_key
+        self.s3_conn_id = s3_conn_id
+
+    @staticmethod
+    def get_s3_key(s3_key):
+        """This parses the correct format for S3 keys
+            regardless of how the S3 url is passed."""
+
+        parsed_s3_key = urlparse(s3_key)
+        return parsed_s3_key.path.lstrip('/')
+
+    def execute(self, context):
+        self.s3_key = self.get_s3_key(self.s3_key)
+        ssh_hook = SSHHook(ssh_conn_id=self.sftp_conn_id)
+        s3_hook = S3Hook(self.s3_conn_id)
+
+        sftp_client = ssh_hook.get_conn().open_sftp()
+
+        with NamedTemporaryFile("w") as f:
+            sftp_client.get(self.sftp_path, f.name)
+
+            s3_hook.load_file(
+                filename=f.name,
+                key=self.s3_key,
+                bucket_name=self.s3_bucket,
+                replace=True
+            )
diff --git a/tests/contrib/operators/test_s3_to_sftp_operator.py b/tests/contrib/operators/test_s3_to_sftp_operator.py
new file mode 100644
index 0000000000000..359c5eb912172
--- /dev/null
+++ b/tests/contrib/operators/test_s3_to_sftp_operator.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow import models
+from airflow.contrib.operators.s3_to_sftp_operator import S3ToSFTPOperator
+from airflow.contrib.operators.ssh_operator import SSHOperator
+from airflow.models import DAG, TaskInstance
+from airflow.settings import Session
+from airflow.utils import timezone
+from airflow.utils.timezone import datetime
+import boto3
+from moto import mock_s3
+
+
+TASK_ID = 'test_s3_to_sftp'
+BUCKET = 'test-s3-bucket'
+S3_KEY = 'test/test_1_file.csv'
+SFTP_PATH = '/tmp/remote_path.txt'
+SFTP_CONN_ID = 'ssh_default'
+S3_CONN_ID = 'aws_default'
+LOCAL_FILE_PATH = '/tmp/test_s3_upload'
+
+SFTP_MOCK_FILE = 'test_sftp_file.csv'
+S3_MOCK_FILES = 'test_1_file.csv'
+
+TEST_DAG_ID = 'unit_tests'
+DEFAULT_DATE = datetime(2018, 1, 1)
+
+
+def reset(dag_id=TEST_DAG_ID):
+    session = Session()
+    tis = session.query(models.TaskInstance).filter_by(dag_id=dag_id)
+    tis.delete()
+    session.commit()
+    session.close()
+
+
+reset()
+
+
+class S3ToSFTPOperatorTest(unittest.TestCase):
+    @mock_s3
+    def setUp(self):
+        configuration.load_test_config()
+        from airflow.contrib.hooks.ssh_hook import SSHHook
+        from airflow.hooks.S3_hook import S3Hook
+
+        hook = SSHHook(ssh_conn_id='ssh_default')
+        s3_hook = S3Hook('aws_default')
+        hook.no_host_key_check = True
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE,
+            'provide_context': True
+        }
+        dag = DAG(TEST_DAG_ID + 'test_schedule_dag_once', default_args=args)
+        dag.schedule_interval = '@once'
+
+        self.hook = hook
+        self.s3_hook = s3_hook
+
+        self.ssh_client = self.hook.get_conn()
+        self.sftp_client = self.ssh_client.open_sftp()
+
+        self.dag = dag
+        self.s3_bucket = BUCKET
+        self.sftp_path = SFTP_PATH
+        self.s3_key = S3_KEY
+
+    @mock_s3
+    def test_s3_to_sftp_operation(self):
+        # Setting
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_remote_file_content = \
+            "This is remote file content \n which is also multiline " \
+            "another line here \n this is last line. EOF"
+
+        # Test for creation of s3 bucket
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=self.s3_bucket)
+        self.assertTrue((self.s3_hook.check_for_bucket(self.s3_bucket)))
+
+        with open(LOCAL_FILE_PATH, 'w') as f:
+            f.write(test_remote_file_content)
+        self.s3_hook.load_file(LOCAL_FILE_PATH, self.s3_key, bucket_name=BUCKET)
+
+        # Check if object was created in s3
+        objects_in_dest_bucket = conn.list_objects(Bucket=self.s3_bucket,
+                                                   Prefix=self.s3_key)
+        # there should be object found, and there should only be one object found
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), 1)
+
+        # the object found should be consistent with dest_key specified earlier
+        self.assertEqual(objects_in_dest_bucket['Contents'][0]['Key'], self.s3_key)
+
+        # get remote file to local
+        run_task = S3ToSFTPOperator(
+            s3_bucket=BUCKET,
+            s3_key=S3_KEY,
+            sftp_path=SFTP_PATH,
+            sftp_conn_id=SFTP_CONN_ID,
+            s3_conn_id=S3_CONN_ID,
+            task_id=TASK_ID,
+            dag=self.dag
+        )
+        self.assertIsNotNone(run_task)
+
+        run_task.execute(None)
+
+        # Check that the file is created remotely
+        check_file_task = SSHOperator(
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="cat {0}".format(self.sftp_path),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(check_file_task)
+        ti3 = TaskInstance(task=check_file_task, execution_date=timezone.utcnow())
+        ti3.run()
+        self.assertEqual(
+            ti3.xcom_pull(task_ids='test_check_file', key='return_value').strip(),
+            test_remote_file_content.encode('utf-8'))
+
+        # Clean up after finishing with test
+        conn.delete_object(Bucket=self.s3_bucket, Key=self.s3_key)
+        conn.delete_bucket(Bucket=self.s3_bucket)
+        self.assertFalse((self.s3_hook.check_for_bucket(self.s3_bucket)))
+
+    def delete_remote_resource(self):
+        # check the remote file content
+        remove_file_task = SSHOperator(
+            task_id="test_check_file",
+            ssh_hook=self.hook,
+            command="rm {0}".format(self.sftp_path),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(remove_file_task)
+        ti3 = TaskInstance(task=remove_file_task, execution_date=timezone.utcnow())
+        ti3.run()
+
+    def tearDown(self):
+        self.delete_remote_resource()
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sftp_to_s3_operator.py b/tests/contrib/operators/test_sftp_to_s3_operator.py
new file mode 100644
index 0000000000000..4be3a71d208f6
--- /dev/null
+++ b/tests/contrib/operators/test_sftp_to_s3_operator.py
@@ -0,0 +1,144 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow import models
+from airflow.contrib.operators.sftp_to_s3_operator import SFTPToS3Operator
+from airflow.contrib.operators.ssh_operator import SSHOperator
+from airflow.models import DAG, TaskInstance
+from airflow.settings import Session
+from airflow.utils import timezone
+from airflow.utils.timezone import datetime
+from airflow.contrib.hooks.ssh_hook import SSHHook
+from airflow.hooks.S3_hook import S3Hook
+
+import boto3
+from moto import mock_s3
+
+BUCKET = 'test-bucket'
+S3_KEY = 'test/test_1_file.csv'
+SFTP_PATH = '/tmp/remote_path.txt'
+SFTP_CONN_ID = 'ssh_default'
+S3_CONN_ID = 'aws_default'
+
+SFTP_MOCK_FILE = 'test_sftp_file.csv'
+S3_MOCK_FILES = 'test_1_file.csv'
+
+TEST_DAG_ID = 'unit_tests'
+DEFAULT_DATE = datetime(2018, 1, 1)
+
+
+def reset(dag_id=TEST_DAG_ID):
+    session = Session()
+    tis = session.query(models.TaskInstance).filter_by(dag_id=dag_id)
+    tis.delete()
+    session.commit()
+    session.close()
+
+
+reset()
+
+
+class SFTPToS3OperatorTest(unittest.TestCase):
+
+    @mock_s3
+    def setUp(self):
+        configuration.load_test_config()
+
+        hook = SSHHook(ssh_conn_id='ssh_default')
+        s3_hook = S3Hook('aws_default')
+        hook.no_host_key_check = True
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE,
+            'provide_context': True
+        }
+        dag = DAG(TEST_DAG_ID + 'test_schedule_dag_once', default_args=args)
+        dag.schedule_interval = '@once'
+
+        self.hook = hook
+        self.s3_hook = s3_hook
+
+        self.ssh_client = self.hook.get_conn()
+        self.sftp_client = self.ssh_client.open_sftp()
+
+        self.dag = dag
+        self.s3_bucket = BUCKET
+        self.sftp_path = SFTP_PATH
+        self.s3_key = S3_KEY
+
+    @mock_s3
+    def test_sftp_to_s3_operation(self):
+        # Setting
+        configuration.conf.set("core", "enable_xcom_pickling", "True")
+        test_remote_file_content = \
+            "This is remote file content \n which is also multiline " \
+            "another line here \n this is last line. EOF"
+
+        # create a test file remotely
+        create_file_task = SSHOperator(
+            task_id="test_create_file",
+            ssh_hook=self.hook,
+            command="echo '{0}' > {1}".format(test_remote_file_content,
+                                              self.sftp_path),
+            do_xcom_push=True,
+            dag=self.dag
+        )
+        self.assertIsNotNone(create_file_task)
+        ti1 = TaskInstance(task=create_file_task, execution_date=timezone.utcnow())
+        ti1.run()
+
+        # Test for creation of s3 bucket
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=self.s3_bucket)
+        self.assertTrue((self.s3_hook.check_for_bucket(self.s3_bucket)))
+
+        # get remote file to local
+        run_task = SFTPToS3Operator(
+            s3_bucket=BUCKET,
+            s3_key=S3_KEY,
+            sftp_path=SFTP_PATH,
+            sftp_conn_id=SFTP_CONN_ID,
+            s3_conn_id=S3_CONN_ID,
+            task_id='test_sftp_to_s3',
+            dag=self.dag
+        )
+        self.assertIsNotNone(run_task)
+
+        run_task.execute(None)
+
+        # Check if object was created in s3
+        objects_in_dest_bucket = conn.list_objects(Bucket=self.s3_bucket,
+                                                   Prefix=self.s3_key)
+        # there should be object found, and there should only be one object found
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), 1)
+
+        # the object found should be consistent with dest_key specified earlier
+        self.assertEqual(objects_in_dest_bucket['Contents'][0]['Key'], self.s3_key)
+
+        # Clean up after finishing with test
+        conn.delete_object(Bucket=self.s3_bucket, Key=self.s3_key)
+        conn.delete_bucket(Bucket=self.s3_bucket)
+        self.assertFalse((self.s3_hook.check_for_bucket(self.s3_bucket)))
+
+
+if __name__ == '__main__':
+    unittest.main()

From 874bdd1e3aab8615b195d77185b3b3826fcd3411 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Mon, 21 Jan 2019 18:11:58 +0800
Subject: [PATCH 578/808] [AIRFLOW-XXX] Fix typo (#4564)

Fix typos in various files
---
 CONTRIBUTING.md                                                 | 2 +-
 airflow/contrib/hooks/bigquery_hook.py                          | 2 +-
 airflow/contrib/hooks/salesforce_hook.py                        | 2 +-
 airflow/contrib/operators/dataflow_operator.py                  | 2 +-
 airflow/contrib/operators/mlengine_operator.py                  | 2 +-
 airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py | 2 +-
 airflow/contrib/operators/qubole_operator.py                    | 2 +-
 airflow/contrib/operators/s3_to_sftp_operator.py                | 2 +-
 airflow/contrib/operators/sftp_operator.py                      | 2 +-
 airflow/contrib/operators/sftp_to_s3_operator.py                | 2 +-
 airflow/contrib/operators/ssh_operator.py                       | 2 +-
 airflow/contrib/plugins/metastore_browser/main.py               | 2 +-
 airflow/contrib/utils/weekday.py                                | 2 +-
 airflow/operators/s3_file_transform_operator.py                 | 2 +-
 airflow/sensors/base_sensor_operator.py                         | 2 +-
 airflow/ti_deps/dep_context.py                                  | 2 +-
 airflow/utils/sqlalchemy.py                                     | 2 +-
 tests/ti_deps/deps/fake_models.py                               | 2 +-
 18 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index f9be5d52789b3..3326018234c74 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -96,7 +96,7 @@ extras to build the full API reference.
 
 ## Development and Testing
 
-### Set up a development environment
+### Setting up a development environment
 
 There are three ways to setup an Apache Airflow development environment.
 
diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index efc766852469a..57ef3ac9c26dc 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -957,7 +957,7 @@ def run_load(self,
             records, an invalid error is returned in the job result. Only applicable when
             soure_format is CSV.
         :type allow_jagged_rows: bool
-        :param schema_update_options: Allows the schema of the desitination
+        :param schema_update_options: Allows the schema of the destination
             table to be updated as a side effect of the load job.
         :type schema_update_options: tuple
         :param src_fmt_configs: configure optional fields specific to the source format
diff --git a/airflow/contrib/hooks/salesforce_hook.py b/airflow/contrib/hooks/salesforce_hook.py
index 8c2d2f8e93b4a..a3301ad6f5ccc 100644
--- a/airflow/contrib/hooks/salesforce_hook.py
+++ b/airflow/contrib/hooks/salesforce_hook.py
@@ -53,7 +53,7 @@ def __init__(
 
         :param conn_id:     the name of the connection that has the parameters
                             we need to connect to Salesforce.
-                            The connection shoud be type `http` and include a
+                            The connection should be type `http` and include a
                             user's security token in the `Extras` field.
         .. note::
             For the HTTP connection type, you can include a
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 430042990fad0..d020a6c9bbffe 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -271,7 +271,7 @@ class DataFlowPythonOperator(BaseOperator):
         For more detail on job submission have a look at the reference:
         https://cloud.google.com/dataflow/pipelines/specifying-exec-params
 
-    :param py_file: Reference to the python dataflow pipleline file.py, e.g.,
+    :param py_file: Reference to the python dataflow pipeline file.py, e.g.,
         /some/local/file/path/to/your/python/pipeline/file.
     :type py_file: str
     :param job_name: The 'job_name' to use when executing the DataFlow job
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index e9b7c1702e8d3..0c0df3e842c9a 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -147,7 +147,7 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     :param delegate_to: The account to impersonate, if any.
         For this to work, the service account making the request must
-        have doamin-wide delegation enabled.
+        have domain-wide delegation enabled.
     :type delegate_to: str
 
     :raises: ``ValueError``: if a unique model/version origin cannot be
diff --git a/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
index 80cec8f462d9a..967f84828d9fd 100644
--- a/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
+++ b/airflow/contrib/operators/oracle_to_azure_data_lake_transfer.py
@@ -47,7 +47,7 @@ class OracleToAzureDataLakeTransfer(BaseOperator):
     :type sql_params: str
     :param delimiter: field delimiter in the file.
     :type delimiter: str
-    :param encoding: enconding type for the file.
+    :param encoding: encoding type for the file.
     :type encoding: str
     :param quotechar: Character to use in quoting.
     :type quotechar: str
diff --git a/airflow/contrib/operators/qubole_operator.py b/airflow/contrib/operators/qubole_operator.py
index 82ee293b934bc..c6de0153f7421 100755
--- a/airflow/contrib/operators/qubole_operator.py
+++ b/airflow/contrib/operators/qubole_operator.py
@@ -57,7 +57,7 @@ class QuboleOperator(BaseOperator):
                 copied into the working directory where the qubole command is being
                 executed.
             :archives: list of archives in s3 bucket as archive1,archive2 format. These
-                will be unarchived intothe working directory where the qubole command is
+                will be unarchived into the working directory where the qubole command is
                 being executed
             :parameters: any extra args which need to be passed to script (only when
                 script_location is supplied)
diff --git a/airflow/contrib/operators/s3_to_sftp_operator.py b/airflow/contrib/operators/s3_to_sftp_operator.py
index 7e02e97cd24e4..422165bca7fed 100644
--- a/airflow/contrib/operators/s3_to_sftp_operator.py
+++ b/airflow/contrib/operators/s3_to_sftp_operator.py
@@ -34,7 +34,7 @@ class S3ToSFTPOperator(BaseOperator):
     :param sftp_path:       The sftp remote path. This is the specified
                             file path for uploading file to the SFTP server.
     :type sftp_path:        string
-    :param s3_conn_id:      The s3 connnection id. The name or identifier for establishing
+    :param s3_conn_id:      The s3 connection id. The name or identifier for establishing
                             a connection to S3
     :type s3_conn_id:       string
     :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 16e3be365210c..74e86398db3f2 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -39,7 +39,7 @@ class SFTPOperator(BaseOperator):
         Either `ssh_hook` or `ssh_conn_id` needs to be provided.
     :type ssh_hook: :class:`SSHHook`
     :param ssh_conn_id: connection id from airflow Connections.
-        `ssh_conn_id` will be ingored if `ssh_hook` is provided.
+        `ssh_conn_id` will be ignored if `ssh_hook` is provided.
     :type ssh_conn_id: str
     :param remote_host: remote host to connect (templated)
         Nullable. If provided, it will replace the `remote_host` which was
diff --git a/airflow/contrib/operators/sftp_to_s3_operator.py b/airflow/contrib/operators/sftp_to_s3_operator.py
index b0ed1e16a3630..0c94541b74771 100644
--- a/airflow/contrib/operators/sftp_to_s3_operator.py
+++ b/airflow/contrib/operators/sftp_to_s3_operator.py
@@ -34,7 +34,7 @@ class SFTPToS3Operator(BaseOperator):
     :param sftp_path:       The sftp remote path. This is the specified file
                             path for downloading the file from the SFTP server.
     :type sftp_path:        string
-    :param s3_conn_id:      The s3 connnection id. The name or identifier for
+    :param s3_conn_id:      The s3 connection id. The name or identifier for
                             establishing a connection to S3
     :type s3_conn_id:       string
     :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index 8d8dd1124a99b..00462ad3d6889 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -35,7 +35,7 @@ class SSHOperator(BaseOperator):
         Either `ssh_hook` or `ssh_conn_id` needs to be provided.
     :type ssh_hook: :class:`SSHHook`
     :param ssh_conn_id: connection id from airflow Connections.
-        `ssh_conn_id` will be ingored if `ssh_hook` is provided.
+        `ssh_conn_id` will be ignored if `ssh_hook` is provided.
     :type ssh_conn_id: str
     :param remote_host: remote host to connect (templated)
         Nullable. If provided, it will replace the `remote_host` which was
diff --git a/airflow/contrib/plugins/metastore_browser/main.py b/airflow/contrib/plugins/metastore_browser/main.py
index 836e53191ac71..33a8ca5f661ce 100644
--- a/airflow/contrib/plugins/metastore_browser/main.py
+++ b/airflow/contrib/plugins/metastore_browser/main.py
@@ -164,7 +164,7 @@ def ddl(self):
 
 v = MetastoreBrowserView(category="Plugins", name="Hive Metadata Browser")
 
-# Creating a flask blueprint to intergrate the templates and static folder
+# Creating a flask blueprint to integrate the templates and static folder
 bp = Blueprint(
     "metastore_browser", __name__,
     template_folder='templates',
diff --git a/airflow/contrib/utils/weekday.py b/airflow/contrib/utils/weekday.py
index 1fe4ad3a59011..8630e5a3dca7c 100644
--- a/airflow/contrib/utils/weekday.py
+++ b/airflow/contrib/utils/weekday.py
@@ -39,7 +39,7 @@ def get_weekday_number(cls, week_day_str):
 
         :param week_day_str: Full Name of the Week Day. Example: "Sunday"
         :type week_day_str: str
-        :return: ISO Week Day Number corresponding to the provided Weedkay
+        :return: ISO Week Day Number corresponding to the provided Weekday
         """
         sanitized_week_day_str = week_day_str.upper()
 
diff --git a/airflow/operators/s3_file_transform_operator.py b/airflow/operators/s3_file_transform_operator.py
index abe96c780c2d3..74c351db86356 100644
--- a/airflow/operators/s3_file_transform_operator.py
+++ b/airflow/operators/s3_file_transform_operator.py
@@ -48,7 +48,7 @@ class S3FileTransformOperator(BaseOperator):
     :type source_s3_key: str
     :param source_aws_conn_id: source s3 connection
     :type source_aws_conn_id: str
-    :param source_verify: Whether or not to verify SSL certificates for S3 connetion.
+    :param source_verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
 
diff --git a/airflow/sensors/base_sensor_operator.py b/airflow/sensors/base_sensor_operator.py
index 1dc59dd230b0c..1d65a30719376 100644
--- a/airflow/sensors/base_sensor_operator.py
+++ b/airflow/sensors/base_sensor_operator.py
@@ -52,7 +52,7 @@ class BaseSensorOperator(BaseOperator, SkipMixin):
         When set to ``reschedule`` the sensor task frees the worker slot when
         the criteria is not yet met and it's rescheduled at a later time. Use
         this mode if the expected time until the criteria is met is. The poke
-        inteval should be more than one minute to prevent too much load on
+        interval should be more than one minute to prevent too much load on
         the scheduler.
     :type mode: str
     """
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index cd3c2720783fe..f946cf720e5e2 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -33,7 +33,7 @@ class DepContext(object):
     """
     A base class for contexts that specifies which dependencies should be evaluated in
     the context for a task instance to satisfy the requirements of the context. Also
-    stores state related to the context that can be used by dependendency classes.
+    stores state related to the context that can be used by dependency classes.
 
     For example there could be a SomeRunContext that subclasses this class which has
     dependencies for:
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index 7e97371319ee0..fe29b76e60d8b 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -66,7 +66,7 @@ def ping_connection(connection, branch):
 
             try:
                 connection.scalar(select([1]))
-                # If we made it here then the connection appears to be healty
+                # If we made it here then the connection appears to be healthy
                 break
             except exc.DBAPIError as err:
                 if time.time() - start >= reconnect_timeout_seconds:
diff --git a/tests/ti_deps/deps/fake_models.py b/tests/ti_deps/deps/fake_models.py
index 7896f205ff74d..f7b94846ee5f2 100644
--- a/tests/ti_deps/deps/fake_models.py
+++ b/tests/ti_deps/deps/fake_models.py
@@ -26,7 +26,7 @@ def __init__(self, **kwds):
         self.__dict__.update(kwds)
 
     def pool_full(self):
-        # Allow users of this fake to set pool_filled in the contructor to make this
+        # Allow users of this fake to set pool_filled in the constructor to make this
         # return True
         try:
             return self.pool_filled

From 1744c0afeaf48244c5d4ee7fcd9b5698b908cd48 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 10 Sep 2018 17:06:28 +0800
Subject: [PATCH 579/808] [AIRFLOW-2985] Operators for S3 object
 copying/deleting (#3823)

1. Copying:
Under the hood, it's `boto3.client.copy_object()`.
It can only handle the situation in which the
S3 connection used can access both source and
destination bucket/key.

2. Deleting:
2.1 Under the hood, it's `boto3.client.delete_objects()`.
It supports either deleting one single object or
multiple objects.
2.2 If users try to delete a non-existent object, the
request will still succeed, but there will be an
entry 'Errors' in the response. There may also be
other reasons which may cause similar 'Errors' (
request itself would succeed without explicit
exception). So an argument `silent_on_errors` is added
to let users decide if this sort of 'Errors' should
fail the operator.

The corresponding methods are added into S3Hook, and
these two operators are 'wrappers' of these methods.
---
 .../operators/s3_copy_object_operator.py      | 93 +++++++++++++++++++
 .../operators/s3_delete_objects_operator.py   | 85 +++++++++++++++++
 docs/code.rst                                 |  2 +
 .../operators/test_s3_copy_object_operator.py | 89 ++++++++++++++++++
 .../test_s3_delete_objects_operator.py        | 85 +++++++++++++++++
 5 files changed, 354 insertions(+)
 create mode 100644 airflow/contrib/operators/s3_copy_object_operator.py
 create mode 100644 airflow/contrib/operators/s3_delete_objects_operator.py
 create mode 100644 tests/contrib/operators/test_s3_copy_object_operator.py
 create mode 100644 tests/contrib/operators/test_s3_delete_objects_operator.py

diff --git a/airflow/contrib/operators/s3_copy_object_operator.py b/airflow/contrib/operators/s3_copy_object_operator.py
new file mode 100644
index 0000000000000..330138ed27594
--- /dev/null
+++ b/airflow/contrib/operators/s3_copy_object_operator.py
@@ -0,0 +1,93 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.S3_hook import S3Hook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class S3CopyObjectOperator(BaseOperator):
+    """
+    Creates a copy of an object that is already stored in S3.
+
+    Note: the S3 connection used here needs to have access to both
+    source and destination bucket/key.
+
+    :param source_bucket_key: The key of the source object.
+
+        It can be either full s3:// style url or relative path from root level.
+
+        When it's specified as a full s3:// url, please omit source_bucket_name.
+    :type source_bucket_key: str
+    :param dest_bucket_key: The key of the object to copy to.
+
+        The convention to specify `dest_bucket_key` is the same as `source_bucket_key`.
+    :type dest_bucket_key: str
+    :param source_bucket_name: Name of the S3 bucket where the source object is in.
+
+        It should be omitted when `source_bucket_key` is provided as a full s3:// url.
+    :type source_bucket_name: str
+    :param dest_bucket_name: Name of the S3 bucket to where the object is copied.
+
+        It should be omitted when `dest_bucket_key` is provided as a full s3:// url.
+    :type dest_bucket_name: str
+    :param source_version_id: Version ID of the source object (OPTIONAL)
+    :type source_version_id: str
+    :param aws_conn_id: Connection id of the S3 connection to use
+    :type aws_conn_id: str
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+
+        You can provide the following values:
+
+        - False: do not validate SSL certificates. SSL will still be used,
+                 but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
+    """
+
+    @apply_defaults
+    def __init__(
+            self,
+            source_bucket_key,
+            dest_bucket_key,
+            source_bucket_name=None,
+            dest_bucket_name=None,
+            source_version_id=None,
+            aws_conn_id='aws_default',
+            verify=None,
+            *args, **kwargs):
+        super(S3CopyObjectOperator, self).__init__(*args, **kwargs)
+
+        self.source_bucket_key = source_bucket_key
+        self.dest_bucket_key = dest_bucket_key
+        self.source_bucket_name = source_bucket_name
+        self.dest_bucket_name = dest_bucket_name
+        self.source_version_id = source_version_id
+        self.aws_conn_id = aws_conn_id
+        self.verify = verify
+
+    def execute(self, context):
+        s3_hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
+        s3_hook.copy_object(self.source_bucket_key, self.dest_bucket_key,
+                            self.source_bucket_name, self.dest_bucket_name,
+                            self.source_version_id)
diff --git a/airflow/contrib/operators/s3_delete_objects_operator.py b/airflow/contrib/operators/s3_delete_objects_operator.py
new file mode 100644
index 0000000000000..1aa1b3901e83f
--- /dev/null
+++ b/airflow/contrib/operators/s3_delete_objects_operator.py
@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.exceptions import AirflowException
+from airflow.hooks.S3_hook import S3Hook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class S3DeleteObjectsOperator(BaseOperator):
+    """
+    To enable users to delete single object or multiple objects from
+    a bucket using a single HTTP request.
+
+    Users may specify up to 1000 keys to delete.
+
+    :param bucket: Name of the bucket in which you are going to delete object(s)
+    :type bucket: str
+    :param keys: The key(s) to delete from S3 bucket.
+
+        When ``keys`` is a string, it's supposed to be the key name of
+        the single object to delete.
+
+        When ``keys`` is a list, it's supposed to be the list of the
+        keys to delete.
+
+        You may specify up to 1000 keys.
+    :type keys: str or list
+    :param aws_conn_id: Connection id of the S3 connection to use
+    :type aws_conn_id: str
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
+        By default SSL certificates are verified.
+
+        You can provide the following values:
+
+        - False: do not validate SSL certificates. SSL will still be used,
+                 but SSL certificates will not be
+                 verified.
+        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+                 You can specify this argument if you want to use a different
+                 CA cert bundle than the one used by botocore.
+    :type verify: bool or str
+    """
+
+    @apply_defaults
+    def __init__(
+            self,
+            bucket,
+            keys,
+            aws_conn_id='aws_default',
+            verify=None,
+            *args, **kwargs):
+        super(S3DeleteObjectsOperator, self).__init__(*args, **kwargs)
+        self.bucket = bucket
+        self.keys = keys
+        self.aws_conn_id = aws_conn_id
+        self.verify = verify
+
+    def execute(self, context):
+        s3_hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
+
+        response = s3_hook.delete_objects(bucket=self.bucket, keys=self.keys)
+
+        deleted_keys = [x['Key'] for x in response.get("Deleted", [])]
+        self.log.info("Deleted: {}".format(deleted_keys))
+
+        if "Errors" in response:
+            errors_keys = [x['Key'] for x in response.get("Errors", [])]
+            raise AirflowException("Errors when deleting: {}".format(errors_keys))
diff --git a/docs/code.rst b/docs/code.rst
index 46a40bc143f21..b22e8e3c92474 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -237,6 +237,8 @@ Operators
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
+.. autoclass:: airflow.contrib.operators.s3_copy_object_operator.S3CopyObjectOperator
+.. autoclass:: airflow.contrib.operators.s3_delete_objects_operator.S3DeleteObjectsOperator
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
diff --git a/tests/contrib/operators/test_s3_copy_object_operator.py b/tests/contrib/operators/test_s3_copy_object_operator.py
new file mode 100644
index 0000000000000..25904ecc51476
--- /dev/null
+++ b/tests/contrib/operators/test_s3_copy_object_operator.py
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import io
+import unittest
+
+import boto3
+from moto import mock_s3
+
+from airflow.contrib.operators.s3_copy_object_operator import S3CopyObjectOperator
+
+
+class TestS3CopyObjectOperator(unittest.TestCase):
+
+    def setUp(self):
+        self.source_bucket = "bucket1"
+        self.source_key = "path1/data.txt"
+        self.dest_bucket = "bucket2"
+        self.dest_key = "path2/data_copy.txt"
+
+    @mock_s3
+    def test_s3_copy_object_arg_combination_1(self):
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=self.source_bucket)
+        conn.create_bucket(Bucket=self.dest_bucket)
+        conn.upload_fileobj(Bucket=self.source_bucket,
+                            Key=self.source_key,
+                            Fileobj=io.BytesIO(b"input"))
+
+        # there should be nothing found before S3CopyObjectOperator is executed
+        self.assertFalse('Contents' in conn.list_objects(Bucket=self.dest_bucket,
+                                                         Prefix=self.dest_key))
+
+        t = S3CopyObjectOperator(task_id="test_task_s3_copy_object",
+                                 source_bucket_key=self.source_key,
+                                 source_bucket_name=self.source_bucket,
+                                 dest_bucket_key=self.dest_key,
+                                 dest_bucket_name=self.dest_bucket)
+        t.execute(None)
+
+        objects_in_dest_bucket = conn.list_objects(Bucket=self.dest_bucket,
+                                                   Prefix=self.dest_key)
+        # there should be object found, and there should only be one object found
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), 1)
+        # the object found should be consistent with dest_key specified earlier
+        self.assertEqual(objects_in_dest_bucket['Contents'][0]['Key'], self.dest_key)
+
+    @mock_s3
+    def test_s3_copy_object_arg_combination_2(self):
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=self.source_bucket)
+        conn.create_bucket(Bucket=self.dest_bucket)
+        conn.upload_fileobj(Bucket=self.source_bucket,
+                            Key=self.source_key,
+                            Fileobj=io.BytesIO(b"input"))
+
+        # there should be nothing found before S3CopyObjectOperator is executed
+        self.assertFalse('Contents' in conn.list_objects(Bucket=self.dest_bucket,
+                                                         Prefix=self.dest_key))
+
+        source_key_s3_url = "s3://{}/{}".format(self.source_bucket, self.source_key)
+        dest_key_s3_url = "s3://{}/{}".format(self.dest_bucket, self.dest_key)
+        t = S3CopyObjectOperator(task_id="test_task_s3_copy_object",
+                                 source_bucket_key=source_key_s3_url,
+                                 dest_bucket_key=dest_key_s3_url)
+        t.execute(None)
+
+        objects_in_dest_bucket = conn.list_objects(Bucket=self.dest_bucket,
+                                                   Prefix=self.dest_key)
+        # there should be object found, and there should only be one object found
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), 1)
+        # the object found should be consistent with dest_key specified earlier
+        self.assertEqual(objects_in_dest_bucket['Contents'][0]['Key'], self.dest_key)
diff --git a/tests/contrib/operators/test_s3_delete_objects_operator.py b/tests/contrib/operators/test_s3_delete_objects_operator.py
new file mode 100644
index 0000000000000..05ce1f57db758
--- /dev/null
+++ b/tests/contrib/operators/test_s3_delete_objects_operator.py
@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import io
+import unittest
+
+import boto3
+from moto import mock_s3
+
+from airflow.contrib.operators.s3_delete_objects_operator import S3DeleteObjectsOperator
+
+
+class TestS3DeleteObjectsOperator(unittest.TestCase):
+
+    @mock_s3
+    def test_s3_delete_single_object(self):
+        bucket = "testbucket"
+        key = "path/data.txt"
+
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=bucket)
+        conn.upload_fileobj(Bucket=bucket,
+                            Key=key,
+                            Fileobj=io.BytesIO(b"input"))
+
+        # The object should be detected before the DELETE action is taken
+        objects_in_dest_bucket = conn.list_objects(Bucket=bucket,
+                                                   Prefix=key)
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), 1)
+        self.assertEqual(objects_in_dest_bucket['Contents'][0]['Key'], key)
+
+        t = S3DeleteObjectsOperator(task_id="test_task_s3_delete_single_object",
+                                    bucket=bucket,
+                                    keys=key)
+        t.execute(None)
+
+        # There should be no object found in the bucket created earlier
+        self.assertFalse('Contents' in conn.list_objects(Bucket=bucket,
+                                                         Prefix=key))
+
+    @mock_s3
+    def test_s3_delete_multiple_objects(self):
+        bucket = "testbucket"
+        key_pattern = "path/data"
+        n_keys = 3
+        keys = [key_pattern + str(i) for i in range(n_keys)]
+
+        conn = boto3.client('s3')
+        conn.create_bucket(Bucket=bucket)
+        for k in keys:
+            conn.upload_fileobj(Bucket=bucket,
+                                Key=k,
+                                Fileobj=io.BytesIO(b"input"))
+
+        # The objects should be detected before the DELETE action is taken
+        objects_in_dest_bucket = conn.list_objects(Bucket=bucket,
+                                                   Prefix=key_pattern)
+        self.assertEqual(len(objects_in_dest_bucket['Contents']), n_keys)
+        self.assertEqual(sorted([x['Key'] for x in objects_in_dest_bucket['Contents']]),
+                         sorted(keys))
+
+        t = S3DeleteObjectsOperator(task_id="test_task_s3_delete_multiple_objects",
+                                    bucket=bucket,
+                                    keys=keys)
+        t.execute(None)
+
+        # There should be no object found in the bucket created earlier
+        self.assertFalse('Contents' in conn.list_objects(Bucket=bucket,
+                                                         Prefix=key_pattern))

From c55fd32a78005c4c65bc6b1863fbd7eebf0a6a64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Tue, 5 Feb 2019 21:48:25 +0100
Subject: [PATCH 580/808] [AIRFLOW-XXX] Add missing class references to docs
 (#4644)

---
 .../contrib/operators/databricks_operator.py  |   5 +-
 .../contrib/operators/s3_to_sftp_operator.py  |  33 ++--
 .../contrib/operators/sftp_to_s3_operator.py  |  34 ++--
 docs/code.rst                                 | 149 ++++++++++--------
 docs/integration.rst                          |   1 +
 5 files changed, 126 insertions(+), 96 deletions(-)

diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index 5fbc605abea60..a8742e401c4fe 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -37,7 +37,7 @@ def _deep_string_coerce(content, json_path='json'):
     function will throw if content contains non-string or non-numeric types.
 
     The reason why we have this function is because the ``self.json`` field must be a
-     dict with only string values. This is because ``render_template`` will fail
+    dict with only string values. This is because ``render_template`` will fail
     for numerical values.
     """
     c = _deep_string_coerce
@@ -302,6 +302,7 @@ class DatabricksRunNowOperator(BaseOperator):
     to call the ``api/2.0/jobs/run-now`` endpoint and pass it directly
     to our ``DatabricksRunNowOperator`` through the ``json`` parameter.
     For example ::
+
         json = {
           "job_id": 42,
           "notebook_params": {
@@ -349,6 +350,7 @@ class DatabricksRunNowOperator(BaseOperator):
 
     :param job_id: the job_id of the existing Databricks job.
         This field will be templated.
+
         .. seealso::
             https://docs.databricks.com/api/latest/jobs.html#run-now
     :type job_id: str
@@ -396,6 +398,7 @@ class DatabricksRunNowOperator(BaseOperator):
         in job setting.
         The json representation of this field cannot exceed 10,000 bytes.
         This field will be templated.
+
         .. seealso::
             https://docs.databricks.com/api/latest/jobs.html#run-now
     :type spark_submit_params: array of strings
diff --git a/airflow/contrib/operators/s3_to_sftp_operator.py b/airflow/contrib/operators/s3_to_sftp_operator.py
index 422165bca7fed..43ef269032db8 100644
--- a/airflow/contrib/operators/s3_to_sftp_operator.py
+++ b/airflow/contrib/operators/s3_to_sftp_operator.py
@@ -27,22 +27,23 @@
 
 class S3ToSFTPOperator(BaseOperator):
     """
-    This operator enables the transferring of files from S3 to a SFTP server
-    :param sftp_conn_id:    The sftp connection id. The name or
-                            identifier for establishing a connection to the SFTP server.
-    :type sftp_conn_id:     string
-    :param sftp_path:       The sftp remote path. This is the specified
-                            file path for uploading file to the SFTP server.
-    :type sftp_path:        string
-    :param s3_conn_id:      The s3 connection id. The name or identifier for establishing
-                            a connection to S3
-    :type s3_conn_id:       string
-    :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
-                            from where the file is downloaded.
-    :type s3_bucket:        string
-    :param s3_key:          The targeted s3 key. This is the specified file path
-                            for downloading the file from S3.
-    :type s3_key:           string
+    This operator enables the transferring of files from S3 to a SFTP server.
+
+    :param sftp_conn_id: The sftp connection id. The name or identifier for
+        establishing a connection to the SFTP server.
+    :type sftp_conn_id: string
+    :param sftp_path: The sftp remote path. This is the specified file path for
+        uploading file to the SFTP server.
+    :type sftp_path: string
+    :param s3_conn_id: The s3 connection id. The name or identifier for
+        establishing a connection to S3
+    :type s3_conn_id: string
+    :param s3_bucket: The targeted s3 bucket. This is the S3 bucket from
+        where the file is downloaded.
+    :type s3_bucket: string
+    :param s3_key: The targeted s3 key. This is the specified file path for
+        downloading the file from S3.
+    :type s3_key: string
     """
 
     template_fields = ('s3_key', 'sftp_path')
diff --git a/airflow/contrib/operators/sftp_to_s3_operator.py b/airflow/contrib/operators/sftp_to_s3_operator.py
index 0c94541b74771..cefc838cf12d1 100644
--- a/airflow/contrib/operators/sftp_to_s3_operator.py
+++ b/airflow/contrib/operators/sftp_to_s3_operator.py
@@ -27,22 +27,24 @@
 
 class SFTPToS3Operator(BaseOperator):
     """
-    This operator enables the transferring of files from a SFTP server to Amazon S3
-    :param sftp_conn_id:    The sftp connection id. The name or identifier for
-                            establishing a connection to the SFTP server.
-    :type sftp_conn_id:     string
-    :param sftp_path:       The sftp remote path. This is the specified file
-                            path for downloading the file from the SFTP server.
-    :type sftp_path:        string
-    :param s3_conn_id:      The s3 connection id. The name or identifier for
-                            establishing a connection to S3
-    :type s3_conn_id:       string
-    :param s3_bucket:       The targeted s3 bucket. This is the S3 bucket
-                            to where the file is uploaded.
-    :type s3_bucket:        string
-    :param s3_key:          The targeted s3 key. This is the specified path
-                            for uploading the file to S3.
-    :type s3_key:           string
+    This operator enables the transferring of files from a SFTP server to
+    Amazon S3.
+
+    :param sftp_conn_id: The sftp connection id. The name or identifier for
+        establishing a connection to the SFTP server.
+    :type sftp_conn_id: string
+    :param sftp_path: The sftp remote path. This is the specified file path
+        for downloading the file from the SFTP server.
+    :type sftp_path: string
+    :param s3_conn_id: The s3 connection id. The name or identifier for
+        establishing a connection to S3
+    :type s3_conn_id: string
+    :param s3_bucket: The targeted s3 bucket. This is the S3 bucket to where
+        the file is uploaded.
+    :type s3_bucket: string
+    :param s3_key: The targeted s3 key. This is the specified path for
+        uploading the file to S3.
+    :type s3_key: string
     """
 
     template_fields = ('s3_key', 'sftp_path')
diff --git a/docs/code.rst b/docs/code.rst
index b22e8e3c92474..d86ffba4cba13 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -69,15 +69,15 @@ Operators
 .. autoclass:: airflow.operators.python_operator.BranchPythonOperator
 .. autoclass:: airflow.operators.check_operator.CheckOperator
 .. autoclass:: airflow.operators.docker_operator.DockerOperator
-.. autoclass:: airflow.operators.dummy_operator.DummyOperator
 .. autoclass:: airflow.operators.druid_check_operator.DruidCheckOperator
+.. autoclass:: airflow.operators.dummy_operator.DummyOperator
 .. autoclass:: airflow.operators.email_operator.EmailOperator
 .. autoclass:: airflow.operators.generic_transfer.GenericTransfer
-.. autoclass:: airflow.operators.hive_to_druid.HiveToDruidTransfer
-.. autoclass:: airflow.operators.hive_to_mysql.HiveToMySqlTransfer
 .. autoclass:: airflow.operators.hive_to_samba_operator.Hive2SambaOperator
 .. autoclass:: airflow.operators.hive_operator.HiveOperator
 .. autoclass:: airflow.operators.hive_stats_operator.HiveStatsCollectionOperator
+.. autoclass:: airflow.operators.hive_to_druid.HiveToDruidTransfer
+.. autoclass:: airflow.operators.hive_to_mysql.HiveToMySqlTransfer
 .. autoclass:: airflow.operators.check_operator.IntervalCheckOperator
 .. autoclass:: airflow.operators.jdbc_operator.JdbcOperator
 .. autoclass:: airflow.operators.latest_only_operator.LatestOnlyOperator
@@ -94,6 +94,7 @@ Operators
 .. autoclass:: airflow.operators.presto_check_operator.PrestoValueCheckOperator
 .. autoclass:: airflow.operators.python_operator.PythonOperator
 .. autoclass:: airflow.operators.python_operator.PythonVirtualenvOperator
+.. autoclass:: airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer
 .. autoclass:: airflow.operators.s3_file_transform_operator.S3FileTransformOperator
 .. autoclass:: airflow.operators.s3_to_hive_operator.S3ToHiveTransfer
 .. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
@@ -105,7 +106,6 @@ Operators
 .. autoclass:: airflow.operators.subdag_operator.SubDagOperator
 .. autoclass:: airflow.operators.dagrun_operator.TriggerDagRunOperator
 .. autoclass:: airflow.operators.check_operator.ValueCheckOperator
-.. autoclass:: airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer
 
 Sensors
 ^^^^^^^
@@ -118,8 +118,8 @@ Sensors
 .. autoclass:: airflow.sensors.s3_key_sensor.S3KeySensor
 .. autoclass:: airflow.sensors.s3_prefix_sensor.S3PrefixSensor
 .. autoclass:: airflow.sensors.sql_sensor.SqlSensor
-.. autoclass:: airflow.sensors.time_sensor.TimeSensor
 .. autoclass:: airflow.sensors.time_delta_sensor.TimeDeltaSensor
+.. autoclass:: airflow.sensors.time_sensor.TimeSensor
 .. autoclass:: airflow.sensors.web_hdfs_sensor.WebHdfsSensor
 
 Community-contributed Operators
@@ -129,37 +129,61 @@ Operators
 ^^^^^^^^^
 .. Alphabetize this list
 
-.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
-.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.aws_athena_operator.AWSAthenaOperator
 .. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
+.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.azure_container_instances_operator.AzureContainerInstancesOperator
 .. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
+.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
 .. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
+.. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
+.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
 .. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
 .. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
 .. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
 .. autoclass:: airflow.contrib.operators.bigquery_to_gcs.BigQueryToCloudStorageOperator
+.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor
 .. autoclass:: airflow.contrib.operators.cassandra_to_gcs.CassandraToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlBaseOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
+.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
+.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksRunNowOperator
+.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
+.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
+.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateBaseOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
@@ -173,43 +197,22 @@ Operators
 .. autoclass:: airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator
 .. autoclass:: airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlBaseOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
-.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
+.. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
 .. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
-.. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
+.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
@@ -235,13 +238,17 @@ Operators
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
 .. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
 .. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
-.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
 .. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
+.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
 .. autoclass:: airflow.contrib.operators.s3_copy_object_operator.S3CopyObjectOperator
 .. autoclass:: airflow.contrib.operators.s3_delete_objects_operator.S3DeleteObjectsOperator
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.s3_to_sftp_operator.S3ToSFTPOperator
+.. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
+.. autoclass:: airflow.contrib.operators.sftp_to_s3_operator.SFTPToS3Operator
+.. autoclass:: airflow.contrib.operators.ssh_operator.SSHOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
@@ -250,7 +257,6 @@ Operators
 .. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
 .. autoclass:: airflow.contrib.operators.segment_track_event_operator.SegmentTrackEventOperator
-.. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
 .. autoclass:: airflow.contrib.operators.slack_webhook_operator.SlackWebhookOperator
 .. autoclass:: airflow.contrib.operators.snowflake_operator.SnowflakeOperator
 .. autoclass:: airflow.contrib.operators.sns_publish_operator.SnsPublishOperator
@@ -258,9 +264,10 @@ Operators
 .. autoclass:: airflow.contrib.operators.spark_sql_operator.SparkSqlOperator
 .. autoclass:: airflow.contrib.operators.spark_submit_operator.SparkSubmitOperator
 .. autoclass:: airflow.contrib.operators.sqoop_operator.SqoopOperator
-.. autoclass:: airflow.contrib.operators.ssh_operator.SSHOperator
 .. autoclass:: airflow.contrib.operators.vertica_operator.VerticaOperator
 .. autoclass:: airflow.contrib.operators.vertica_to_hive.VerticaToHiveTransfer
+.. autoclass:: airflow.contrib.operators.vertica_to_mysql.VerticaToMySqlTransfer
+.. autoclass:: airflow.contrib.operators.wasb_delete_blob_operator.WasbDeleteBlobOperator
 .. autoclass:: airflow.contrib.operators.winrm_operator.WinRMOperator
 
 Sensors
@@ -275,12 +282,13 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.cassandra_record_sensor.CassandraRecordSensor
 .. autoclass:: airflow.contrib.sensors.cassandra_table_sensor.CassandraTableSensor
 .. autoclass:: airflow.contrib.sensors.datadog_sensor.DatadogSensor
+.. autoclass:: airflow.contrib.sensors.weekday_sensor.DayOfWeekSensor
 .. autoclass:: airflow.contrib.sensors.emr_base_sensor.EmrBaseSensor
 .. autoclass:: airflow.contrib.sensors.emr_job_flow_sensor.EmrJobFlowSensor
 .. autoclass:: airflow.contrib.sensors.emr_step_sensor.EmrStepSensor
-.. autoclass:: airflow.contrib.sensors.file_sensor.FileSensor
-.. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSensor
 .. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSSensor
+.. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSensor
+.. autoclass:: airflow.contrib.sensors.file_sensor.FileSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectUpdatedSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStoragePrefixSensor
@@ -288,18 +296,22 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorRegex
 .. autoclass:: airflow.contrib.sensors.imap_attachment_sensor.ImapAttachmentSensor
 .. autoclass:: airflow.contrib.sensors.jira_sensor.JiraSensor
+.. autoclass:: airflow.contrib.sensors.jira_sensor.JiraTicketSensor
+.. autoclass:: airflow.contrib.sensors.mongo_sensor.MongoSensor
 .. autoclass:: airflow.contrib.sensors.pubsub_sensor.PubSubPullSensor
 .. autoclass:: airflow.contrib.sensors.python_sensor.PythonSensor
+.. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor
+.. autoclass:: airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor
 .. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleSensor
 .. autoclass:: airflow.contrib.sensors.redis_key_sensor.RedisKeySensor
+.. autoclass:: airflow.contrib.sensors.sftp_sensor.SFTPSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_base_sensor.SageMakerBaseSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_endpoint_sensor.SageMakerEndpointSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_training_sensor.SageMakerTrainingSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_transform_sensor.SageMakerTransformSensor
 .. autoclass:: airflow.contrib.sensors.sagemaker_tuning_sensor.SageMakerTuningSensor
-.. autoclass:: airflow.contrib.sensors.sftp_sensor.SFTPSensor
 .. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
-.. autoclass:: airflow.contrib.sensors.weekday_sensor.DayOfWeekSensor
+.. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor
 
 .. _macros:
 
@@ -413,7 +425,7 @@ persisted in the database.
 
 .. automodule:: airflow.models
     :show-inheritance:
-    :members: DAG, BaseOperator, TaskInstance, DagBag, Connection
+    :members: DAG, TaskInstance, DagBag, Connection, Variable, Pool, KubeResourceVersion, KubeWorkerIdentifier
 
 Hooks
 -----
@@ -421,17 +433,16 @@ Hooks
 Hooks are interfaces to external platforms and databases, implementing a common
 interface when possible and acting as building blocks for operators.
 
+.. autoclass:: airflow.hooks.base_hook.BaseHook
 .. autoclass:: airflow.hooks.dbapi_hook.DbApiHook
 .. autoclass:: airflow.hooks.docker_hook.DockerHook
-.. automodule:: airflow.hooks.hive_hooks
-    :members:
-      HiveCliHook,
-      HiveMetastoreHook,
-      HiveServer2Hook
-.. autoclass:: airflow.hooks.http_hook.HttpHook
 .. autoclass:: airflow.hooks.druid_hook.DruidDbApiHook
 .. autoclass:: airflow.hooks.druid_hook.DruidHook
 .. autoclass:: airflow.hooks.hdfs_hook.HDFSHook
+.. autoclass:: airflow.hooks.hive_hooks.HiveCliHook
+.. autoclass:: airflow.hooks.hive_hooks.HiveMetastoreHook
+.. autoclass:: airflow.hooks.hive_hooks.HiveServer2Hook
+.. autoclass:: airflow.hooks.http_hook.HttpHook
 .. autoclass:: airflow.hooks.jdbc_hook.JdbcHook
 .. autoclass:: airflow.hooks.mssql_hook.MsSqlHook
 .. autoclass:: airflow.hooks.mysql_hook.MySqlHook
@@ -456,12 +467,21 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
 .. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
 .. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
+.. autoclass:: airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook
+.. autoclass:: airflow.contrib.hooks.azure_container_registry_hook.AzureContainerRegistryHook
+.. autoclass:: airflow.contrib.hooks.azure_container_volume_hook.AzureContainerVolumeHook
 .. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
 .. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
 .. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
 .. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
+.. autoclass:: airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook
 .. autoclass:: airflow.contrib.hooks.cassandra_hook.CassandraHook
+.. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
+.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
+.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
 .. autoclass:: airflow.contrib.hooks.cloudant_hook.CloudantHook
+.. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
+.. autoclass:: airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook
 .. autoclass:: airflow.contrib.hooks.databricks_hook.DatabricksHook
 .. autoclass:: airflow.contrib.hooks.datadog_hook.DatadogHook
 .. autoclass:: airflow.contrib.hooks.datastore_hook.DatastoreHook
@@ -470,33 +490,36 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.fs_hook.FSHook
 .. autoclass:: airflow.contrib.hooks.ftp_hook.FTPHook
 .. autoclass:: airflow.contrib.hooks.ftp_hook.FTPSHook
-.. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
+.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
 .. autoclass:: airflow.contrib.hooks.gcp_container_hook.GKEClusterHook
-.. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
-.. autoclass:: airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook
-.. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
-.. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
+.. autoclass:: airflow.contrib.hooks.gcp_compute_hook.GceHook
+.. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
+.. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
+.. autoclass:: airflow.contrib.hooks.gcp_kms_hook.GoogleCloudKMSHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
 .. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
 .. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook
+.. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
 .. autoclass:: airflow.contrib.hooks.mongo_hook.MongoHook
 .. autoclass:: airflow.contrib.hooks.openfaas_hook.OpenFaasHook
 .. autoclass:: airflow.contrib.hooks.pinot_hook.PinotDbApiHook
+.. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
+.. autoclass:: airflow.contrib.hooks.qubole_check_hook.QuboleCheckHook
 .. autoclass:: airflow.contrib.hooks.qubole_hook.QuboleHook
 .. autoclass:: airflow.contrib.hooks.redis_hook.RedisHook
 .. autoclass:: airflow.contrib.hooks.redshift_hook.RedshiftHook
+.. autoclass:: airflow.contrib.hooks.sftp_hook.SFTPHook
+.. autoclass:: airflow.contrib.hooks.ssh_hook.SSHHook
 .. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
 .. autoclass:: airflow.contrib.hooks.salesforce_hook.SalesforceHook
 .. autoclass:: airflow.contrib.hooks.segment_hook.SegmentHook
-.. autoclass:: airflow.contrib.hooks.sftp_hook.SFTPHook
 .. autoclass:: airflow.contrib.hooks.slack_webhook_hook.SlackWebhookHook
 .. autoclass:: airflow.contrib.hooks.snowflake_hook.SnowflakeHook
 .. autoclass:: airflow.contrib.hooks.spark_jdbc_hook.SparkJDBCHook
 .. autoclass:: airflow.contrib.hooks.spark_sql_hook.SparkSqlHook
 .. autoclass:: airflow.contrib.hooks.spark_submit_hook.SparkSubmitHook
 .. autoclass:: airflow.contrib.hooks.sqoop_hook.SqoopHook
-.. autoclass:: airflow.contrib.hooks.ssh_hook.SSHHook
 .. autoclass:: airflow.contrib.hooks.vertica_hook.VerticaHook
 .. autoclass:: airflow.contrib.hooks.wasb_hook.WasbHook
 .. autoclass:: airflow.contrib.hooks.winrm_hook.WinRMHook
@@ -505,8 +528,8 @@ Executors
 ---------
 Executors are the mechanism by which task instances get run.
 
-.. autoclass:: airflow.executors.local_executor.LocalExecutor
 .. autoclass:: airflow.executors.celery_executor.CeleryExecutor
+.. autoclass:: airflow.executors.local_executor.LocalExecutor
 .. autoclass:: airflow.executors.sequential_executor.SequentialExecutor
 
 Community-contributed executors
diff --git a/docs/integration.rst b/docs/integration.rst
index 4a1b38817d07b..3938eb4277471 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -911,6 +911,7 @@ Cloud Bigtable Hook
 
 .. autoclass:: airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook
     :members:
+    :noindex:
 
 Compute Engine
 ''''''''''''''

From 45fb7825feabe6e91fccc51f5243e3014e3d4834 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Sun, 17 Feb 2019 07:12:28 +0100
Subject: [PATCH 581/808] [AIRFLOW-3807] Fix Graph View Highlighting of Tasks
 (#4653)

- fixes up_for_retry and up_for_reschedule tasks when hovering over retry/rescheduled task state
- adds missing task states to stateFocusMap that will be used for highlighting tasks when clicking on task state
- removed invalid attributes for some tags
- reformatted accordingly to rules from .editorconfig

[AIRFLOW-3807] Fix no_status tasks highlighting in graph view

[AIRFLOW-3807] Change "no status" string to "no_status"

[AIRFLOW-3807] Fix syntax issue in js statement

[AIRFLOW-3807] Correct tree view tasks' status labels

- reformat tree.html file
- remove invalid attributes from tree.html tags
---
 airflow/www/templates/airflow/graph.html      | 119 +++++++++---------
 airflow/www/templates/airflow/tree.html       |  86 +++++++------
 airflow/www_rbac/static/js/graph.js           |   2 +-
 airflow/www_rbac/templates/airflow/graph.html | 115 +++++++++--------
 airflow/www_rbac/templates/airflow/tree.html  |  87 +++++++------
 5 files changed, 208 insertions(+), 201 deletions(-)

diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index dcd4f1c468c7d..e7e6325bbb9f7 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -23,84 +23,82 @@
 
 {% block head_css %}
 {{ super() }}
-<link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='dagre.css') }}">
-<link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='graph.css') }}">
+<link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='dagre.css') }}">
+<link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='graph.css') }}">
 {% endblock %}
 
 {% block body %}
 {{ super() }}
-    {% if dag.doc_md %}
-        <div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
-    {% endif %}
-    <div class="form-inline">
-        <form method="get" style="float:left;">
-            {{ state_token }}
-            Base date: {{ form.base_date(class_="form-control") }}
-            Number of runs: {{ form.num_runs(class_="form-control") }}
-            Run:
-            {{ form.execution_date(class_="form-control") | safe }}
-            Layout:
-            {{ form.arrange(class_="form-control") | safe }}
-            <input type="hidden" name="root" value="{{ root }}">
-            <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
-            <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
-            <input type="submit" value="Go" class="btn btn-default"
-            action="" method="get">
-        </form>
-            <div class="input-group" style="float: right;">
-              <input type="text" id="searchbox" class="form-control" placeholder="Search for..." onenter="null">
-            </div><!-- /input-group -->
-        <div style="clear: both;"/>
-    </div>
+{% if dag.doc_md %}
+<div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
+{% endif %}
+<div class="form-inline">
+  <form method="get" style="float:left;">
+    {{ state_token }}
+    Base date: {{ form.base_date(class_="form-control") }}
+    Number of runs: {{ form.num_runs(class_="form-control") }}
+    Run:
+    {{ form.execution_date(class_="form-control") | safe }}
+    Layout:
+    {{ form.arrange(class_="form-control") | safe }}
+    <input type="hidden" name="root" value="{{ root }}">
+    <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
+    <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
+    <input type="submit" value="Go" class="btn btn-default">
+  </form>
+  <div class="input-group" style="float: right;">
+    <input type="text" id="searchbox" class="form-control" placeholder="Search for...">
+  </div>
+  <div style="clear: both;"></div>
+</div>
 <hr/>
 <div>
-    {% for op in operators %}
-    <div class="legend_item" style="border-width:1px;float:left;background:{{ op.ui_color }};color:{{ op.ui_fgcolor }};">
-        {{ op.__name__ }}
-    </div>
-    {% endfor %}
-
-    <div style"background-color: blue;">
-    <div class="legend_item state" style="border-color:white;">no status</div>
+  {% for op in operators %}
+  <div class="legend_item"
+       style="border-width:1px;float:left;background:{{ op.ui_color }};color:{{ op.ui_fgcolor }};">
+    {{ op.__name__ }}
+  </div>
+  {% endfor %}
+
+  <div>
+    <div class="legend_item state" style="border-color:white;">no_status</div>
     <div class="legend_item state" style="border-color:grey;">queued</div>
-    <div class="legend_item state" style="border-color:gold;">retry</div>
-    <div class="legend_item state" style="border-color:turquoise;">rescheduled</div>
+    <div class="legend_item state" style="border-color:gold;">up_for_retry</div>
+    <div class="legend_item state" style="border-color:turquoise;">up_for_reschedule</div>
     <div class="legend_item state" style="border-color:pink;">skipped</div>
     <div class="legend_item state" style="border-color:red;">failed</div>
     <div class="legend_item state" style="border-color:lime;">running</div>
     <div class="legend_item state" style="border-color:green;">success</div>
-    </div>
-    <div style="clear:both;"></div>
+  </div>
+  <div style="clear:both;"></div>
 </div>
 <div id="error" style="display: none; margin-top: 10px;" class="alert alert-danger" role="alert">
-        <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
-        <span id="error_msg">Oops.</span>
+  <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
+  <span id="error_msg">Oops.</span>
 </div>
 <hr style="margin-bottom: 0px;"/>
 <button class="btn btn-default pull-right" id="refresh_button">
-    <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
+  <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
 </button>
 <div id="svg_container">
 
-    <svg width="{{ width }}" height="{{ height }}">
-        <g id='dig' transform="translate(20,20)"/>
-        <filter id="blur-effect-1">
-        <feGaussianBlur stdDeviation="3" />
-        </filter>
-    </svg>
-    <img id="loading" alt="spinner" src="{{ url_for('static', filename='loading.gif') }}">
+  <svg width="{{ width }}" height="{{ height }}">
+    <g id='dig' transform="translate(20,20)"></g>
+    <filter id="blur-effect-1">
+      <feGaussianBlur stdDeviation="3"></feGaussianBlur>
+    </filter>
+  </svg>
+  <img id="loading" alt="spinner" src="{{ url_for('static', filename='loading.gif') }}">
 </div>
 <hr>
 {% endblock %}
 
 {% block tail %}
-    {{ super() }}
+{{ super() }}
 
-    <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-    <script src="{{ url_for('static', filename='dagre-d3.js') }}"></script>
-    <script>
+<script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
+<script src="{{ url_for('static', filename='dagre-d3.js') }}"></script>
+<script>
 
     var highlight_color = "#000000";
     var upstream_color = "#2020A0";
@@ -115,8 +113,15 @@
     var g = dagreD3.json.decode(nodes, edges);
     var duration = 500;
     var stateFocusMap = {
-        'no status':false, 'failed':false, 'running':false,
-        'queued': false, 'success': false};
+        'success': false,
+        'running':false,
+        'failed':false,
+        'skipped': false,
+        'up_for_reschedule': false,
+        'up_for_retry': false,
+        'queued': false,
+        'no_status': false
+    };
 
 
     var layout = dagreD3.layout().rankDir(arrange).nodeSep(15).rankSep(15);
@@ -270,7 +275,7 @@
         $.each(task_instances, function(task_id, ti) {
           $('tspan').filter(function(index) { return $(this).text() === task_id; })
             .parent().parent().parent()
-            .attr("class", "node enter " + ti.state)
+            .attr("class", "node enter " + (ti.state ? ti.state : "no_status"))
             .attr("data-toggle", "tooltip")
             .attr("data-original-title", function(d) {
               // Tooltip
@@ -368,7 +373,7 @@
         }
     );
 
-    </script>
+</script>
 
 
 {% endblock %}
diff --git a/airflow/www/templates/airflow/tree.html b/airflow/www/templates/airflow/tree.html
index da109c1e5ea9f..8e95de239ac24 100644
--- a/airflow/www/templates/airflow/tree.html
+++ b/airflow/www/templates/airflow/tree.html
@@ -20,66 +20,63 @@
 
 {% block head_css %}
 {{ super() }}
-<link rel="stylesheet" type="text/css"
-    href="{{ url_for('static', filename='tree.css') }}">
+<link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='tree.css') }}">
 <link href="{{ admin_static.url(filename='vendor/bootstrap-daterangepicker/daterangepicker-bs2.css') }}" rel="stylesheet">
 {% endblock %}
 
 {% block body %}
 {{ super() }}
 <div style="float: left" class="form-inline">
-    <form method="get" style="float:left;">
-        Base date: {{ form.base_date(class_="form-control") }}
-        Number of runs: {{ form.num_runs(class_="form-control") }}
-        <input type="hidden" name="root" value="{{ root if root else '' }}">
-        <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
-        <input type="submit" value="Go" class="btn btn-default"
-        action="" method="get">
-        <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
-    </form>
+  <form method="get" style="float:left;">
+    Base date: {{ form.base_date(class_="form-control") }}
+    Number of runs: {{ form.num_runs(class_="form-control") }}
+    <input type="hidden" name="root" value="{{ root if root else '' }}">
+    <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
+    <input type="submit" value="Go" class="btn btn-default">
+    <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
+  </form>
 </div>
 <div style="clear: both;"></div>
 <hr/>
 <div>
-    <div class="legend_item" style="border: none;">no status</div>
-    <div class="square" style="background: white;"></div>
-    <div class="legend_item" style="border: none;">queued</div>
-    <div class="square" style="background: grey;"></div>
-    <div class="legend_item" style="border: none;">retry</div>
-    <div class="square" style="background: gold;"></div>
-    <div class="legend_item" style="border: none;">rescheduled</div>
-    <div class="square" style="background: turquoise;"></div>
-    <div class="legend_item" style="border: none;">skipped</div>
-    <div class="square" style="background: pink;"></div>
-    <div class="legend_item" style="border: none;">failed</div>
-    <div class="square" style="background: red;"></div>
-    <div class="legend_item" style="border: none;">running</div>
-    <div class="square" style="background: lime;"></div>
-    <div class="legend_item" style="border: none;">success</div>
-    <div class="square" style="background: green;"></div>
-    {% for op in operators %}
-        <div class="legend_circle" style="background:{{ op.ui_color }};">
-        </div>
-        <div class="legend_item" style="float:left;border-color:white;">{{ op.__name__ }}</div>
-    {% endfor %}
-    <div style="clear:both;"></div>
+  <div class="legend_item" style="border: none;">no_status</div>
+  <div class="square" style="background: white;"></div>
+  <div class="legend_item" style="border: none;">queued</div>
+  <div class="square" style="background: grey;"></div>
+  <div class="legend_item" style="border: none;">up_for_retry</div>
+  <div class="square" style="background: gold;"></div>
+  <div class="legend_item" style="border: none;">up_for_reschedule</div>
+  <div class="square" style="background: turquoise;"></div>
+  <div class="legend_item" style="border: none;">skipped</div>
+  <div class="square" style="background: pink;"></div>
+  <div class="legend_item" style="border: none;">failed</div>
+  <div class="square" style="background: red;"></div>
+  <div class="legend_item" style="border: none;">running</div>
+  <div class="square" style="background: lime;"></div>
+  <div class="legend_item" style="border: none;">success</div>
+  <div class="square" style="background: green;"></div>
+  {% for op in operators %}
+  <div class="legend_circle" style="background:{{ op.ui_color }};">
+  </div>
+  <div class="legend_item" style="float:left;border-color:white;">{{ op.__name__ }}</div>
+  {% endfor %}
+  <div style="clear:both;"></div>
 </div>
 <hr/>
 <div id="svg_container">
-  <img id='loading' width="50"
-    src="{{ url_for('static', filename='loading.gif') }}">
-    <svg class='tree' width="100%">
-        <filter id="blur-effect-1">
-            <feGaussianBlur stdDeviation="3" />
-        </filter>
-    </svg>
+  <img id='loading' width="50" src="{{ url_for('static', filename='loading.gif') }}">
+  <svg class='tree' width="100%">
+    <filter id="blur-effect-1">
+      <feGaussianBlur stdDeviation="3"></feGaussianBlur>
+    </filter>
+  </svg>
 </div>
 {% endblock %}
 
 {% block tail %}
-  {{ super() }}
-  <script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
-  <script>
+{{ super() }}
+<script src="{{ url_for('static', filename='d3.v3.min.js') }}"></script>
+<script>
 $('span.status_square').tooltip({html: true});
 
 var data = {{ data|safe }};
@@ -379,5 +376,6 @@
   }
 }
 set_tooltip();
-  </script>
+
+</script>
 {% endblock %}
diff --git a/airflow/www_rbac/static/js/graph.js b/airflow/www_rbac/static/js/graph.js
index 3ccc72cc6f78a..c5a428b0e9476 100644
--- a/airflow/www_rbac/static/js/graph.js
+++ b/airflow/www_rbac/static/js/graph.js
@@ -27,7 +27,7 @@ function update_nodes_states(task_instances) {
       return $(this).text() === task_id;
     })
       .parent().parent().parent().parent()
-      .attr("class", "node enter " + ti.state)
+      .attr("class", "node enter " + (ti.state ? ti.state : "no_status"))
       .attr("data-toggle", "tooltip")
       .attr("data-original-title", function (d) {
         // Tooltip
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index edca149babe97..063d6ae3f5843 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -21,82 +21,80 @@
 
 {% block head_css %}
 {{ super() }}
-<link rel="stylesheet" type="text/css"
-      href="{{ url_for('static', filename='css/graph.css') }}">
+<link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='css/graph.css') }}">
 {% endblock %}
 
 {% block content %}
 {{ super() }}
-    {% if dag.doc_md %}
-        <div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
-    {% endif %}
-    <div class="form-inline">
-        <form method="get" style="float:left;">
-            {{ state_token }}
-            Base date: {{ form.base_date(class_="form-control") }}
-            Number of runs: {{ form.num_runs(class_="form-control") }}
-            Run:
-            {{ form.execution_date(class_="form-control") | safe }}
-            Layout:
-            {{ form.arrange(class_="form-control") | safe }}
-            <input type="hidden" name="root" value="{{ root }}">
-            <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
-            <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
-            <input type="submit" value="Go" class="btn btn-default"
-            action="" method="get">
-        </form>
-            <div class="input-group" style="float: right;">
-              <input type="text" id="searchbox" class="form-control" placeholder="Search for..." onenter="null">
-            </div><!-- /input-group -->
-        <div style="clear: both;"/>
-    </div>
+{% if dag.doc_md %}
+<div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
+{% endif %}
+<div class="form-inline">
+  <form method="get" style="float:left;">
+    {{ state_token }}
+    Base date: {{ form.base_date(class_="form-control") }}
+    Number of runs: {{ form.num_runs(class_="form-control") }}
+    Run:
+    {{ form.execution_date(class_="form-control") | safe }}
+    Layout:
+    {{ form.arrange(class_="form-control") | safe }}
+    <input type="hidden" name="root" value="{{ root }}">
+    <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
+    <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
+    <input type="submit" value="Go" class="btn btn-default">
+  </form>
+  <div class="input-group" style="float: right;">
+    <input type="text" id="searchbox" class="form-control" placeholder="Search for..." onenter="null">
+  </div>
+  <div style="clear: both;"></div>
+</div>
 <hr/>
 <div>
-    {% for op in operators %}
-    <div class="legend_item" style="border-width:1px;float:left;background:{{ op.ui_color }};color:{{ op.ui_fgcolor }};">
-        {{ op.__name__ }}
-    </div>
-    {% endfor %}
-
-    <div style"background-color: blue;">
-    <div class="legend_item state" style="border-color:white;">no status</div>
+  {% for op in operators %}
+  <div class="legend_item" style="border-width:1px;float:left;background:{{ op.ui_color }};color:{{ op.ui_fgcolor }};">
+      {{ op.__name__ }}
+  </div>
+  {% endfor %}
+
+  <div>
+    <div class="legend_item state" style="border-color:white;">no_status</div>
     <div class="legend_item state" style="border-color:grey;">queued</div>
-    <div class="legend_item state" style="border-color:gold;">retry</div>
-    <div class="legend_item state" style="border-color:turquoise;">rescheduled</div>
+    <div class="legend_item state" style="border-color:gold;">up_for_retry</div>
+    <div class="legend_item state" style="border-color:turquoise;">up_for_reschedule</div>
     <div class="legend_item state" style="border-color:pink;">skipped</div>
     <div class="legend_item state" style="border-color:red;">failed</div>
     <div class="legend_item state" style="border-color:lime;">running</div>
     <div class="legend_item state" style="border-color:green;">success</div>
-    </div>
-    <div style="clear:both;"></div>
+  </div>
+  <div style="clear:both;"></div>
 </div>
 <div id="error" style="display: none; margin-top: 10px;" class="alert alert-danger" role="alert">
-        <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
-        <span id="error_msg">Oops.</span>
+  <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
+  <span id="error_msg">Oops.</span>
 </div>
 <hr style="margin-bottom: 0px;"/>
 <button class="btn btn-default pull-right" id="refresh_button">
-    <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
+  <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
 </button>
 <div id="svg_container">
 
-    <svg width="{{ width }}" height="{{ height }}">
-        <g id='dig' transform="translate(20,20)"/>
-        <filter id="blur-effect-1">
-        <feGaussianBlur stdDeviation="3" />
-        </filter>
-    </svg>
-    <img id="loading" alt="spinner" src="{{ url_for('static', filename='loading.gif') }}">
+  <svg width="{{ width }}" height="{{ height }}">
+    <g id='dig' transform="translate(20,20)"/>
+    <filter id="blur-effect-1">
+    <feGaussianBlur stdDeviation="3" />
+    </filter>
+  </svg>
+  <img id="loading" alt="spinner" src="{{ url_for('static', filename='loading.gif') }}">
 </div>
 <hr>
 {% endblock %}
 
 {% block tail %}
-    {{ super() }}
+{{ super() }}
 
-    <script src="{{ url_for_asset('d3.min.js') }}"></script>
-    <script src="{{ url_for_asset('dagre-d3.min.js') }}"></script>
-    <script>
+<script src="{{ url_for_asset('d3.min.js') }}"></script>
+<script src="{{ url_for_asset('dagre-d3.min.js') }}"></script>
+<script>
 
     var highlight_color = "#000000";
     var upstream_color = "#2020A0";
@@ -118,8 +116,15 @@
 
     var duration = 500;
     var stateFocusMap = {
-        'no status':false, 'failed':false, 'running':false,
-        'queued': false, 'success': false};
+        'success': false,
+        'running':false,
+        'failed':false,
+        'skipped': false,
+        'up_for_reschedule': false,
+        'up_for_retry': false,
+        'queued': false,
+        'no_status': false
+    };
 
     // Preparation of DagreD3 data structures
     var g = new dagreD3.graphlib.Graph().setGraph({
@@ -352,8 +357,8 @@
         }
         return false
     }
-    </script>
-    <script src="{{ url_for_asset('graph.js') }}"></script>
+</script>
+<script src="{{ url_for_asset('graph.js') }}"></script>
 
 
 {% endblock %}
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index a00fda6c29eb4..d419eeb2baac3 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -20,8 +20,7 @@
 
 {% block head_css %}
 {{ super() }}
-<link rel="stylesheet" type="text/css"
-      href="{{ url_for('static', filename='css/tree.css') }}">
+<link rel="stylesheet" type="text/css" href="{{ url_for('static', filename='css/tree.css') }}">
 <link rel="stylesheet" type="text/css"
     href="{{url_for('appbuilder.static',filename='datepicker/bootstrap-datepicker.css')}}" >
 {% endblock %}
@@ -29,58 +28,57 @@
 {% block content %}
 {{ super() }}
 <div style="float: left" class="form-inline">
-    <form method="get" style="float:left;">
-        Base date: {{ form.base_date(class_="form-control") }}
-        Number of runs: {{ form.num_runs(class_="form-control") }}
-        <input type="hidden" name="root" value="{{ root if root else '' }}">
-        <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
-        <input type="submit" value="Go" class="btn btn-default"
-        action="" method="get">
-        <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
-    </form>
+  <form method="get" style="float:left;">
+    Base date: {{ form.base_date(class_="form-control") }}
+    Number of runs: {{ form.num_runs(class_="form-control") }}
+    <input type="hidden" name="root" value="{{ root if root else '' }}">
+    <input type="hidden" value="{{ dag.dag_id }}" name="dag_id">
+    <input type="submit" value="Go" class="btn btn-default"
+                                    action="" method="get">
+    <input name="_csrf_token" type="hidden" value="{{ csrf_token() }}">
+  </form>
 </div>
 <div style="clear: both;"></div>
 <hr/>
 <div>
-    <div class="legend_item" style="border: none;">no status</div>
-    <div class="square" style="background: white;"></div>
-    <div class="legend_item" style="border: none;">queued</div>
-    <div class="square" style="background: grey;"></div>
-    <div class="legend_item" style="border: none;">retry</div>
-    <div class="square" style="background: gold;"></div>
-    <div class="legend_item" style="border: none;">rescheduled</div>
-    <div class="square" style="background: turquoise;"></div>
-    <div class="legend_item" style="border: none;">skipped</div>
-    <div class="square" style="background: pink;"></div>
-    <div class="legend_item" style="border: none;">failed</div>
-    <div class="square" style="background: red;"></div>
-    <div class="legend_item" style="border: none;">running</div>
-    <div class="square" style="background: lime;"></div>
-    <div class="legend_item" style="border: none;">success</div>
-    <div class="square" style="background: green;"></div>
-    {% for op in operators %}
-        <div class="legend_circle" style="background:{{ op.ui_color }};">
-        </div>
-        <div class="legend_item" style="float:left;border-color:white;">{{ op.__name__ }}</div>
-    {% endfor %}
-    <div style="clear:both;"></div>
+  <div class="legend_item" style="border: none;">no_status</div>
+  <div class="square" style="background: white;"></div>
+  <div class="legend_item" style="border: none;">queued</div>
+  <div class="square" style="background: grey;"></div>
+  <div class="legend_item" style="border: none;">up_for_retry</div>
+  <div class="square" style="background: gold;"></div>
+  <div class="legend_item" style="border: none;">up_for_reschedule</div>
+  <div class="square" style="background: turquoise;"></div>
+  <div class="legend_item" style="border: none;">skipped</div>
+  <div class="square" style="background: pink;"></div>
+  <div class="legend_item" style="border: none;">failed</div>
+  <div class="square" style="background: red;"></div>
+  <div class="legend_item" style="border: none;">running</div>
+  <div class="square" style="background: lime;"></div>
+  <div class="legend_item" style="border: none;">success</div>
+  <div class="square" style="background: green;"></div>
+  {% for op in operators %}
+  <div class="legend_circle" style="background:{{ op.ui_color }};">
+  </div>
+  <div class="legend_item" style="float:left;border-color:white;">{{ op.__name__ }}</div>
+  {% endfor %}
+  <div style="clear:both;"></div>
 </div>
 <hr/>
 <div id="svg_container">
-  <img id='loading' width="50"
-    src="{{ url_for('static', filename='loading.gif') }}">
-    <svg class='tree' width="100%">
-        <filter id="blur-effect-1">
-            <feGaussianBlur stdDeviation="3" />
-        </filter>
-    </svg>
+  <img id='loading' width="50" src="{{ url_for('static', filename='loading.gif') }}">
+  <svg class='tree' width="100%">
+    <filter id="blur-effect-1">
+      <feGaussianBlur stdDeviation="3"></feGaussianBlur>
+    </filter>
+  </svg>
 </div>
 {% endblock %}
 
 {% block tail %}
-  {{ super() }}
-  <script src="{{ url_for_asset('d3.min.js') }}"></script>
-  <script>
+{{ super() }}
+<script src="{{ url_for_asset('d3.min.js') }}"></script>
+<script>
 $('span.status_square').tooltip({html: true});
 
 var data = {{ data|safe }};
@@ -380,5 +378,6 @@
   }
 }
 set_tooltip();
-  </script>
+
+</script>
 {% endblock %}

From 8e5eb07fd2c54274b284574d625e4be0b09ec4f2 Mon Sep 17 00:00:00 2001
From: Ian Wong <yihengw@gmail.com>
Date: Wed, 13 Feb 2019 04:22:38 +0800
Subject: [PATCH 582/808] [AIRFLOW-3780] Fix some incorrect when base_url is
 used (#4643)

Some links are incorrect when base_url is set.
---
 airflow/www/templates/airflow/dag.html      | 2 +-
 airflow/www_rbac/templates/airflow/dag.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 04380f64de3ea..2d197168a6ebc 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -95,7 +95,7 @@ <h4 class="pull-right">
         </a>
       </li>
       <li>
-        <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin="/tree?dag_id="+dag.dag_id) }}"
+        <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin=request.base_url) }}"
           onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 0a964ec0edb59..fe5ffca25a974 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -95,7 +95,7 @@ <h4 class="pull-right">
         </a>
       </li>
       <li>
-        <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin="/tree?dag_id="+dag.dag_id) }}"
+        <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin=request.base_url ) }}"
           onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG

From f1ed9552f98213dcdefb851c2a09c4ad8170c26d Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Mon, 18 Feb 2019 17:23:28 -0800
Subject: [PATCH 583/808] [AIRFLOW-3885] ~10x speed-up of SchedulerJobTest
 suite (#4730)

The SchedulerJobTest suite now takes ~90 seconds on my laptop (down from
~900 seconds == 15 minutes) on Jenkins.

There are a few optimizations here:

1. Don't sleep() for 1 second every scheduling loop (in unit tests)
2. Don't process the example DAGs
3. Use `subdir` to process only the DAGs we need, for a couple of tests
   that actually run the scheduler
4. Only load the DagBag once instead of before each test

I've also added a few tables to the list of tables that are cleaned up
in between test runs to make the tests re-entrant.
---
 airflow/jobs.py                 |  9 ++++++---
 airflow/utils/dag_processing.py |  4 +++-
 tests/jobs.py                   | 27 +++++++++++++++++++++++++--
 3 files changed, 34 insertions(+), 6 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 1064ba48e6fc6..9b71854d4dcdf 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1633,13 +1633,16 @@ def _execute_helper(self):
                 self.heartbeat()
                 last_self_heartbeat_time = timezone.utcnow()
 
+            is_unit_test = conf.getboolean('core', 'unit_test_mode')
             loop_end_time = time.time()
             loop_duration = loop_end_time - loop_start_time
             self.log.debug(
                 "Ran scheduling loop in %.2f seconds",
                 loop_duration)
-            self.log.debug("Sleeping for %.2f seconds", self._processor_poll_interval)
-            time.sleep(self._processor_poll_interval)
+
+            if not is_unit_test:
+                self.log.debug("Sleeping for %.2f seconds", self._processor_poll_interval)
+                time.sleep(self._processor_poll_interval)
 
             # Exit early for a test mode, run one additional scheduler loop
             # to reduce the possibility that parsed DAG was put into the queue
@@ -1652,7 +1655,7 @@ def _execute_helper(self):
                               " have been processed {} times".format(self.num_runs))
                 break
 
-            if loop_duration < 1:
+            if loop_duration < 1 and not is_unit_test:
                 sleep_length = 1 - loop_duration
                 self.log.debug(
                     "Sleeping for {0:.2f} seconds to prevent excessive logging"
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 97d2c17999b83..aceaec1598266 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -276,7 +276,7 @@ def get_dag(self, dag_id):
 
 
 def list_py_file_paths(directory, safe_mode=True,
-                       include_examples=conf.getboolean('core', 'LOAD_EXAMPLES')):
+                       include_examples=None):
     """
     Traverse a directory and look for Python files.
 
@@ -287,6 +287,8 @@ def list_py_file_paths(directory, safe_mode=True,
     :return: a list of paths to Python files in the specified directory
     :rtype: list[unicode]
     """
+    if include_examples is None:
+        include_examples = conf.getboolean('core', 'LOAD_EXAMPLES')
     file_paths = []
     if directory is None:
         return []
diff --git a/tests/jobs.py b/tests/jobs.py
index e3195f86c8a8b..8cb53e948f7f7 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -1386,12 +1386,33 @@ def test_localtaskjob_double_trigger(self):
 class SchedulerJobTest(unittest.TestCase):
 
     def setUp(self):
-        self.dagbag = DagBag()
         with create_session() as session:
             session.query(models.DagRun).delete()
+            session.query(models.TaskInstance).delete()
+            session.query(models.Pool).delete()
+            session.query(models.DagModel).delete()
+            session.query(models.SlaMiss).delete()
             session.query(models.ImportError).delete()
             session.commit()
 
+    @classmethod
+    def setUpClass(cls):
+        cls.dagbag = DagBag()
+
+        def getboolean(section, key):
+            if section.lower() == 'core' and key.lower() == 'load_examples':
+                return False
+            else:
+                return configuration.conf.getboolean(section, key)
+
+        cls.patcher = mock.patch('airflow.jobs.conf.getboolean')
+        mock_getboolean = cls.patcher.start()
+        mock_getboolean.side_effect = getboolean
+
+    @classmethod
+    def tearDownClass(cls):
+        cls.patcher.stop()
+
     @staticmethod
     def run_single_scheduler_loop_with_no_dags(dags_folder):
         """
@@ -2489,6 +2510,7 @@ def test_scheduler_task_start_date(self):
         dag = self.dagbag.get_dag(dag_id)
         dag.clear()
         scheduler = SchedulerJob(dag_id,
+                                 subdir=os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py'),
                                  num_runs=2)
         scheduler.run()
 
@@ -2511,7 +2533,8 @@ def test_scheduler_multiprocessing(self):
             dag.clear()
 
         scheduler = SchedulerJob(dag_ids=dag_ids,
-                                 num_runs=2)
+                                 subdir=os.path.join(TEST_DAG_FOLDER, 'test_scheduler_dags.py'),
+                                 num_runs=1)
         scheduler.run()
 
         # zero tasks ran

From e2e2beb179146865e52fdfabd23c5c8893a11069 Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Tue, 19 Feb 2019 10:16:33 -0800
Subject: [PATCH 584/808] [AIRFLOW-3885] Fix race condition in scheduler test
 (#4737)

We're hitting this race condition frequently now that we don't sleep()
during unit tests. We don't actually need to assert that the task is
currently running - it's fine if it has already run successfully.
---
 tests/jobs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/jobs.py b/tests/jobs.py
index 8cb53e948f7f7..30428b32a574a 100644
--- a/tests/jobs.py
+++ b/tests/jobs.py
@@ -3243,7 +3243,7 @@ def run_with_error(task):
         executor.do_update = True
         do_schedule()
         ti.refresh_from_db()
-        self.assertEqual(ti.state, State.RUNNING)
+        self.assertIn(ti.state, [State.RUNNING, State.SUCCESS])
 
     @unittest.skipUnless("INTEGRATION" in os.environ, "Can only run end to end")
     def test_retry_handling_job(self):

From d8aebe445a1fe7f749ab0fe1b5cc432a06a82e0e Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sat, 29 Sep 2018 00:56:52 -0700
Subject: [PATCH 585/808] [AIRFLOW-1390] Update Alembic to 0.9 (#3935)

---
 setup.py                          |  2 +-
 tests/hooks/test_postgres_hook.py | 27 +++++++++++++--------
 tests/operators/operators.py      |  7 ++++++
 tests/utils/test_db.py            | 39 +++++++++++++++++++++++--------
 4 files changed, 54 insertions(+), 21 deletions(-)

diff --git a/setup.py b/setup.py
index 7a53a3f350ded..8d88ae02aecba 100644
--- a/setup.py
+++ b/setup.py
@@ -283,7 +283,7 @@ def do_setup():
         zip_safe=False,
         scripts=['airflow/bin/airflow'],
         install_requires=[
-            'alembic>=0.8.3, <0.9',
+            'alembic>=0.9, <1.0',
             'bleach~=2.1.3',
             'configparser>=3.5.0, <3.6.0',
             'croniter>=0.3.17, <0.4',
diff --git a/tests/hooks/test_postgres_hook.py b/tests/hooks/test_postgres_hook.py
index 5c87484ac200c..f937c26782401 100644
--- a/tests/hooks/test_postgres_hook.py
+++ b/tests/hooks/test_postgres_hook.py
@@ -28,6 +28,10 @@
 
 class TestPostgresHook(unittest.TestCase):
 
+    def __init__(self, *args, **kwargs):
+        super(TestPostgresHook, self).__init__(*args, **kwargs)
+        self.table = "test_postgres_hook_table"
+
     def setUp(self):
         super(TestPostgresHook, self).setUp()
 
@@ -43,6 +47,13 @@ def get_conn(self):
 
         self.db_hook = UnitTestPostgresHook()
 
+    def tearDown(self):
+        super(TestPostgresHook, self).tearDown()
+
+        with PostgresHook().get_conn() as conn:
+            with conn.cursor() as cur:
+                cur.execute("DROP TABLE IF EXISTS {}".format(self.table))
+
     def test_copy_expert(self):
         m = mock.mock_open(read_data='{"some": "json"}')
         with mock.patch('airflow.hooks.postgres_hook.open', m):
@@ -61,40 +72,36 @@ def test_copy_expert(self):
 
     def test_bulk_load(self):
         hook = PostgresHook()
-        table = "t"
         input_data = ["foo", "bar", "baz"]
 
         with hook.get_conn() as conn:
             with conn.cursor() as cur:
-                cur.execute("DROP TABLE IF EXISTS {}".format(table))
-                cur.execute("CREATE TABLE {} (c VARCHAR)".format(table))
+                cur.execute("CREATE TABLE {} (c VARCHAR)".format(self.table))
                 conn.commit()
 
                 with NamedTemporaryFile() as f:
                     f.write("\n".join(input_data).encode("utf-8"))
                     f.flush()
-                    hook.bulk_load(table, f.name)
+                    hook.bulk_load(self.table, f.name)
 
-                cur.execute("SELECT * FROM {}".format(table))
+                cur.execute("SELECT * FROM {}".format(self.table))
                 results = [row[0] for row in cur.fetchall()]
 
         self.assertEqual(sorted(input_data), sorted(results))
 
     def test_bulk_dump(self):
         hook = PostgresHook()
-        table = "t"
         input_data = ["foo", "bar", "baz"]
 
         with hook.get_conn() as conn:
             with conn.cursor() as cur:
-                cur.execute("DROP TABLE IF EXISTS {}".format(table))
-                cur.execute("CREATE TABLE {} (c VARCHAR)".format(table))
+                cur.execute("CREATE TABLE {} (c VARCHAR)".format(self.table))
                 values = ",".join("('{}')".format(data) for data in input_data)
-                cur.execute("INSERT INTO {} VALUES {}".format(table, values))
+                cur.execute("INSERT INTO {} VALUES {}".format(self.table, values))
                 conn.commit()
 
                 with NamedTemporaryFile() as f:
-                    hook.bulk_dump(table, f.name)
+                    hook.bulk_dump(self.table, f.name)
                     f.seek(0)
                     results = [line.rstrip().decode("utf-8") for line in f.readlines()]
 
diff --git a/tests/operators/operators.py b/tests/operators/operators.py
index d3bbe77f95476..a2d2e4ccff765 100644
--- a/tests/operators/operators.py
+++ b/tests/operators/operators.py
@@ -46,6 +46,13 @@ def setUp(self):
         dag = DAG(TEST_DAG_ID, default_args=args)
         self.dag = dag
 
+    def tearDown(self):
+        from airflow.hooks.mysql_hook import MySqlHook
+        drop_tables = {'test_mysql_to_mysql', 'test_airflow'}
+        with MySqlHook().get_conn() as conn:
+            for table in drop_tables:
+                conn.execute("DROP TABLE IF EXISTS {}".format(table))
+
     def test_mysql_operator_test(self):
         sql = """
         CREATE TABLE IF NOT EXISTS test_airflow (
diff --git a/tests/utils/test_db.py b/tests/utils/test_db.py
index 5fdc40b5255be..718e2ae1066fe 100644
--- a/tests/utils/test_db.py
+++ b/tests/utils/test_db.py
@@ -45,20 +45,19 @@ def test_database_schema_and_sqlalchemy_model_are_in_sync(self):
             lambda t: (t[0] == 'remove_column' and
                        t[2] == 'users' and
                        t[3].name == 'password'),
-            # ignore tables created by other tests
-            lambda t: (t[0] == 'remove_table' and
-                       t[1].name == 't'),
-            lambda t: (t[0] == 'remove_table' and
-                       t[1].name == 'test_airflow'),
-            lambda t: (t[0] == 'remove_table' and
-                       t[1].name == 'test_postgres_to_postgres'),
-            lambda t: (t[0] == 'remove_table' and
-                       t[1].name == 'test_mysql_to_mysql'),
+
             # ignore tables created by celery
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'celery_taskmeta'),
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'celery_tasksetmeta'),
+
+            # ignore indices created by celery
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'task_id'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'taskset_id'),
+
             # Ignore all the fab tables
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'ab_permission'),
@@ -76,6 +75,23 @@ def test_database_schema_and_sqlalchemy_model_are_in_sync(self):
                        t[1].name == 'ab_user'),
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'ab_view_menu'),
+
+            # Ignore all the fab indices
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'permission_id'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'name'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'user_id'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'username'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'field_string'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'email'),
+            lambda t: (t[0] == 'remove_index' and
+                       t[1].name == 'permission_view_id'),
+
             # from test_security unit test
             lambda t: (t[0] == 'remove_table' and
                        t[1].name == 'some_model'),
@@ -83,4 +99,7 @@ def test_database_schema_and_sqlalchemy_model_are_in_sync(self):
         for ignore in ignores:
             diff = [d for d in diff if not ignore(d)]
 
-        self.assertFalse(diff, 'Database schema and SQLAlchemy model are not in sync')
+        self.assertFalse(
+            diff,
+            'Database schema and SQLAlchemy model are not in sync: ' + str(diff)
+        )

From 412c497256fc54516b6b4572b8b272ca9de469d7 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 5 Nov 2018 23:52:22 +0800
Subject: [PATCH 586/808] [AIRFLOW-3239] Enable existing CI tests (#4131)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

1. Renamed files:
- tests/configuration.py → tests/test_configuration.py
- tests/impersonation.py → tests/test_impersonation.py
- tests/utils.py → tests/test_utils.py
- tests/operators/operators.py → tests/operators/test_operators.py
- tests/operators/bash_operator.py → tests/operators/test_bash_operator.py
- tests/jobs.py → tests/test_jobs.py

2. Updated tests/__init__.py accordingly

3. Fixed database-specific tests in tests/operators/test_operators.py

4. Fixed issue in tests/operators/test_bash_operator.py
---
 tests/__init__.py                             | 10 ----
 ...bash_operator.py => test_bash_operator.py} |  5 ++
 .../{operators.py => test_operators.py}       | 46 +++++++++++++++++++
 ...configuration.py => test_configuration.py} |  0
 ...impersonation.py => test_impersonation.py} |  0
 tests/{jobs.py => test_jobs.py}               |  0
 tests/{utils.py => test_utils.py}             |  0
 7 files changed, 51 insertions(+), 10 deletions(-)
 rename tests/operators/{bash_operator.py => test_bash_operator.py} (96%)
 rename tests/operators/{operators.py => test_operators.py} (86%)
 rename tests/{configuration.py => test_configuration.py} (100%)
 rename tests/{impersonation.py => test_impersonation.py} (100%)
 rename tests/{jobs.py => test_jobs.py} (100%)
 rename tests/{utils.py => test_utils.py} (100%)

diff --git a/tests/__init__.py b/tests/__init__.py
index eff9d4b9f311d..6cc4996f5e2f7 100644
--- a/tests/__init__.py
+++ b/tests/__init__.py
@@ -22,15 +22,5 @@
 from __future__ import absolute_import
 
 from .api import *
-from .configuration import *
-from .contrib import *
 from .core import *
-from .executors import *
-from .jobs import *
-from .impersonation import *
-from .lineage import *
 from .models import *
-from .operators import *
-from .security import *
-from .task import *
-from .utils import *
diff --git a/tests/operators/bash_operator.py b/tests/operators/test_bash_operator.py
similarity index 96%
rename from tests/operators/bash_operator.py
rename to tests/operators/test_bash_operator.py
index e934fdbcc4eda..aa62cd1f94ab6 100644
--- a/tests/operators/bash_operator.py
+++ b/tests/operators/test_bash_operator.py
@@ -70,6 +70,9 @@ def test_echo_env_variables(self):
                              'echo $AIRFLOW_CTX_EXECUTION_DATE>> {0};'
                              'echo $AIRFLOW_CTX_DAG_RUN_ID>> {0};'.format(fname)
             )
+
+            original_AIRFLOW_HOME = os.environ['AIRFLOW_HOME']
+
             os.environ['AIRFLOW_HOME'] = 'MY_PATH_TO_AIRFLOW_HOME'
             t.run(DEFAULT_DATE, DEFAULT_DATE,
                   ignore_first_depends_on_past=True, ignore_ti_state=True)
@@ -83,3 +86,5 @@ def test_echo_env_variables(self):
                 self.assertIn('echo_env_vars', output)
                 self.assertIn(DEFAULT_DATE.isoformat(), output)
                 self.assertIn('manual__' + DEFAULT_DATE.isoformat(), output)
+
+            os.environ['AIRFLOW_HOME'] = original_AIRFLOW_HOME
diff --git a/tests/operators/operators.py b/tests/operators/test_operators.py
similarity index 86%
rename from tests/operators/operators.py
rename to tests/operators/test_operators.py
index a2d2e4ccff765..39a813316e7c0 100644
--- a/tests/operators/operators.py
+++ b/tests/operators/test_operators.py
@@ -53,6 +53,8 @@ def tearDown(self):
             for table in drop_tables:
                 conn.execute("DROP TABLE IF EXISTS {}".format(table))
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_operator_test(self):
         sql = """
         CREATE TABLE IF NOT EXISTS test_airflow (
@@ -66,8 +68,11 @@ def test_mysql_operator_test(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_operator_test_multi(self):
         sql = [
+            "CREATE TABLE IF NOT EXISTS test_airflow (dummy VARCHAR(50))",
             "TRUNCATE TABLE test_airflow",
             "INSERT INTO test_airflow VALUES ('X')",
         ]
@@ -79,6 +84,8 @@ def test_mysql_operator_test_multi(self):
         )
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_hook_test_bulk_load(self):
         records = ("foo", "bar", "baz")
 
@@ -101,6 +108,8 @@ def test_mysql_hook_test_bulk_load(self):
                 results = tuple(result[0] for result in c.fetchall())
                 self.assertEqual(sorted(results), sorted(records))
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_hook_test_bulk_dump(self):
         from airflow.hooks.mysql_hook import MySqlHook
         hook = MySqlHook('airflow_db')
@@ -112,6 +121,8 @@ def test_mysql_hook_test_bulk_dump(self):
             self.skipTest("Skip test_mysql_hook_test_bulk_load "
                           "since file output is not permitted")
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     @mock.patch('airflow.hooks.mysql_hook.MySqlHook.get_conn')
     def test_mysql_hook_test_bulk_dump_mock(self, mock_get_conn):
         mock_execute = mock.MagicMock()
@@ -131,6 +142,8 @@ def test_mysql_hook_test_bulk_dump_mock(self, mock_get_conn):
         """.format(tmp_file=tmp_file, table=table)
         assertEqualIgnoreMultipleSpaces(self, mock_execute.call_args[0][0], query)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_to_mysql(self):
         sql = "SELECT * FROM INFORMATION_SCHEMA.TABLES LIMIT 100;"
         from airflow.operators.generic_transfer import GenericTransfer
@@ -148,6 +161,8 @@ def test_mysql_to_mysql(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_overwrite_schema(self):
         """
         Verifies option to overwrite connection schema
@@ -177,6 +192,16 @@ def setUp(self):
         dag = DAG(TEST_DAG_ID, default_args=args)
         self.dag = dag
 
+    def tearDown(self):
+        tables_to_drop = ['test_postgres_to_postgres', 'test_airflow']
+        from airflow.hooks.postgres_hook import PostgresHook
+        with PostgresHook().get_conn() as conn:
+            with conn.cursor() as cur:
+                for t in tables_to_drop:
+                    cur.execute("DROP TABLE IF EXISTS {}".format(t))
+
+    @unittest.skipUnless('postgres' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a Postgres test")
     def test_postgres_operator_test(self):
         sql = """
         CREATE TABLE IF NOT EXISTS test_airflow (
@@ -197,8 +222,11 @@ def test_postgres_operator_test(self):
             end_date=DEFAULT_DATE,
             ignore_ti_state=True)
 
+    @unittest.skipUnless('postgres' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a Postgres test")
     def test_postgres_operator_test_multi(self):
         sql = [
+            "CREATE TABLE IF NOT EXISTS test_airflow (dummy VARCHAR(50))",
             "TRUNCATE TABLE test_airflow",
             "INSERT INTO test_airflow VALUES ('X')",
         ]
@@ -207,6 +235,8 @@ def test_postgres_operator_test_multi(self):
             task_id='postgres_operator_test_multi', sql=sql, dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('postgres' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a Postgres test")
     def test_postgres_to_postgres(self):
         sql = "SELECT * FROM INFORMATION_SCHEMA.TABLES LIMIT 100;"
         from airflow.operators.generic_transfer import GenericTransfer
@@ -224,6 +254,8 @@ def test_postgres_to_postgres(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('postgres' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a Postgres test")
     def test_vacuum(self):
         """
         Verifies the VACUUM operation runs well with the PostgresOperator
@@ -238,6 +270,8 @@ def test_vacuum(self):
             autocommit=True)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('postgres' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a Postgres test")
     def test_overwrite_schema(self):
         """
         Verifies option to overwrite connection schema
@@ -343,11 +377,15 @@ def tearDown(self):
         with MySqlHook().get_conn() as cur:
             cur.execute("DROP TABLE IF EXISTS baby_names CASCADE;")
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_clear(self):
         self.dag.clear(
             start_date=DEFAULT_DATE,
             end_date=timezone.utcnow())
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_to_hive(self):
         from airflow.operators.mysql_to_hive import MySqlToHiveTransfer
         sql = "SELECT * FROM baby_names LIMIT 1000;"
@@ -361,6 +399,8 @@ def test_mysql_to_hive(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_to_hive_partition(self):
         from airflow.operators.mysql_to_hive import MySqlToHiveTransfer
         sql = "SELECT * FROM baby_names LIMIT 1000;"
@@ -376,6 +416,8 @@ def test_mysql_to_hive_partition(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_to_hive_tblproperties(self):
         from airflow.operators.mysql_to_hive import MySqlToHiveTransfer
         sql = "SELECT * FROM baby_names LIMIT 1000;"
@@ -390,6 +432,8 @@ def test_mysql_to_hive_tblproperties(self):
             dag=self.dag)
         t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     @mock.patch('airflow.hooks.hive_hooks.HiveCliHook.load_file')
     def test_mysql_to_hive_type_conversion(self, mock_load_file):
         mysql_table = 'test_mysql_to_hive'
@@ -433,6 +477,8 @@ def test_mysql_to_hive_type_conversion(self, mock_load_file):
             with m.get_conn() as c:
                 c.execute("DROP TABLE IF EXISTS {}".format(mysql_table))
 
+    @unittest.skipUnless('mysql' in configuration.conf.get('core', 'sql_alchemy_conn'),
+                         "This is a MySQL test")
     def test_mysql_to_hive_verify_loaded_values(self):
         mysql_table = 'test_mysql_to_hive'
         hive_table = 'test_mysql_to_hive'
diff --git a/tests/configuration.py b/tests/test_configuration.py
similarity index 100%
rename from tests/configuration.py
rename to tests/test_configuration.py
diff --git a/tests/impersonation.py b/tests/test_impersonation.py
similarity index 100%
rename from tests/impersonation.py
rename to tests/test_impersonation.py
diff --git a/tests/jobs.py b/tests/test_jobs.py
similarity index 100%
rename from tests/jobs.py
rename to tests/test_jobs.py
diff --git a/tests/utils.py b/tests/test_utils.py
similarity index 100%
rename from tests/utils.py
rename to tests/test_utils.py

From e7ed3a41698e5814b37a1409b375f67671c257cc Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sat, 13 Oct 2018 14:09:31 +0800
Subject: [PATCH 587/808] [AIRFLOW-3174] Refine Docstring for SQL Operators &
 Hooks (#4043)

Add missing arguments
---
 airflow/hooks/dbapi_hook.py            | 1 +
 airflow/hooks/mysql_hook.py            | 1 +
 airflow/operators/jdbc_operator.py     | 9 +++++++--
 airflow/operators/mssql_operator.py    | 9 +++++++--
 airflow/operators/mysql_operator.py    | 9 +++++++--
 airflow/operators/oracle_operator.py   | 9 +++++++--
 airflow/operators/postgres_operator.py | 9 +++++++--
 airflow/operators/sqlite_operator.py   | 6 ++++--
 8 files changed, 41 insertions(+), 12 deletions(-)

diff --git a/airflow/hooks/dbapi_hook.py b/airflow/hooks/dbapi_hook.py
index 71c2f95d8bf79..eece267072f13 100644
--- a/airflow/hooks/dbapi_hook.py
+++ b/airflow/hooks/dbapi_hook.py
@@ -191,6 +191,7 @@ def get_autocommit(self, conn):
         Return True if conn.autocommit is set to True.
         Return False if conn.autocommit is not set or set to False or conn
         does not support autocommit.
+
         :param conn: Connection to get autocommit setting from.
         :type conn: connection object.
         :return: connection autocommit setting.
diff --git a/airflow/hooks/mysql_hook.py b/airflow/hooks/mysql_hook.py
index 8d7475df66625..3e839527ee9a5 100644
--- a/airflow/hooks/mysql_hook.py
+++ b/airflow/hooks/mysql_hook.py
@@ -51,6 +51,7 @@ def set_autocommit(self, conn, autocommit):
     def get_autocommit(self, conn):
         """
         MySql connection gets autocommit in a different way.
+
         :param conn: connection to get autocommit setting from.
         :type conn: connection object.
         :return: connection autocommit setting
diff --git a/airflow/operators/jdbc_operator.py b/airflow/operators/jdbc_operator.py
index a10bf30c5c0db..1c9423d5abd8b 100644
--- a/airflow/operators/jdbc_operator.py
+++ b/airflow/operators/jdbc_operator.py
@@ -28,12 +28,17 @@ class JdbcOperator(BaseOperator):
 
     Requires jaydebeapi.
 
-    :param jdbc_conn_id: reference to a predefined database
-    :type jdbc_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+    :param jdbc_conn_id: reference to a predefined database
+    :type jdbc_conn_id: str
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
     """
 
     template_fields = ('sql',)
diff --git a/airflow/operators/mssql_operator.py b/airflow/operators/mssql_operator.py
index f27e2145ebd63..086d1e39a9d28 100644
--- a/airflow/operators/mssql_operator.py
+++ b/airflow/operators/mssql_operator.py
@@ -26,11 +26,16 @@ class MsSqlOperator(BaseOperator):
     """
     Executes sql code in a specific Microsoft SQL database
 
-    :param mssql_conn_id: reference to a specific mssql database
-    :type mssql_conn_id: str
     :param sql: the sql code to be executed
     :type sql: str or string pointing to a template file with .sql
         extension. (templated)
+    :param mssql_conn_id: reference to a specific mssql database
+    :type mssql_conn_id: str
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
     :param database: name of database which overwrite defined one in connection
     :type database: str
     """
diff --git a/airflow/operators/mysql_operator.py b/airflow/operators/mysql_operator.py
index e5bd788bd163a..2cc9b07e3478b 100644
--- a/airflow/operators/mysql_operator.py
+++ b/airflow/operators/mysql_operator.py
@@ -26,12 +26,17 @@ class MySqlOperator(BaseOperator):
     """
     Executes sql code in a specific MySQL database
 
-    :param mysql_conn_id: reference to a specific mysql database
-    :type mysql_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+    :param mysql_conn_id: reference to a specific mysql database
+    :type mysql_conn_id: str
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
     :param database: name of database which overwrite defined one in connection
     :type database: str
     """
diff --git a/airflow/operators/oracle_operator.py b/airflow/operators/oracle_operator.py
index b97129715ff13..2d1a655f9a552 100644
--- a/airflow/operators/oracle_operator.py
+++ b/airflow/operators/oracle_operator.py
@@ -26,12 +26,17 @@ class OracleOperator(BaseOperator):
     """
     Executes sql code in a specific Oracle database
 
-    :param oracle_conn_id: reference to a specific Oracle database
-    :type oracle_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+    :param oracle_conn_id: reference to a specific Oracle database
+    :type oracle_conn_id: str
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
     """
 
     template_fields = ('sql',)
diff --git a/airflow/operators/postgres_operator.py b/airflow/operators/postgres_operator.py
index e329100aa2e8e..8f2aaf553dc1c 100644
--- a/airflow/operators/postgres_operator.py
+++ b/airflow/operators/postgres_operator.py
@@ -25,12 +25,17 @@ class PostgresOperator(BaseOperator):
     """
     Executes sql code in a specific Postgres database
 
-    :param postgres_conn_id: reference to a specific postgres database
-    :type postgres_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+    :param postgres_conn_id: reference to a specific postgres database
+    :type postgres_conn_id: str
+    :param autocommit: if True, each command is automatically committed.
+        (default value: False)
+    :type autocommit: bool
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
     :param database: name of database which overwrite defined one in connection
     :type database: str
     """
diff --git a/airflow/operators/sqlite_operator.py b/airflow/operators/sqlite_operator.py
index 8280075a32f87..fb4a30e350250 100644
--- a/airflow/operators/sqlite_operator.py
+++ b/airflow/operators/sqlite_operator.py
@@ -26,11 +26,13 @@ class SqliteOperator(BaseOperator):
     """
     Executes sql code in a specific Sqlite database
 
-    :param sqlite_conn_id: reference to a specific sqlite database
-    :type sqlite_conn_id: str
     :param sql: the sql code to be executed. (templated)
     :type sql: str or string pointing to a template file. File must have
         a '.sql' extensions.
+    :param sqlite_conn_id: reference to a specific sqlite database
+    :type sqlite_conn_id: str
+    :param parameters: (optional) the parameters to render the SQL query with.
+    :type parameters: mapping or iterable
     """
 
     template_fields = ('sql',)

From 6982393f178054ddb3eb5b5fb04d696dfb98dff8 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 8 Oct 2018 22:00:15 +0800
Subject: [PATCH 588/808] [AIRFLOW-3139] include parameters into log.info in
 SQL operators, if any (#3986)

For all SQL-operators based on DbApiHook, sql command itself is printed
into log.info. But if parameters are used for the sql command, the
parameters would not be included in the printing. This makes the log
less useful.

This commit ensures that the parameters are also printed into the
log.info, if any.
---
 airflow/hooks/dbapi_hook.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/hooks/dbapi_hook.py b/airflow/hooks/dbapi_hook.py
index eece267072f13..4fce22786997e 100644
--- a/airflow/hooks/dbapi_hook.py
+++ b/airflow/hooks/dbapi_hook.py
@@ -163,10 +163,11 @@ def run(self, sql, autocommit=False, parameters=None):
                 for s in sql:
                     if sys.version_info[0] < 3:
                         s = s.encode('utf-8')
-                    self.log.info(s)
                     if parameters is not None:
+                        self.log.info("{} with parameters {}".format(s, parameters))
                         cur.execute(s, parameters)
                     else:
+                        self.log.info(s)
                         cur.execute(s)
 
             # If autocommit was set to False for db that supports autocommit,

From c3e9ab116a3c027ed87a9b44f3a483c491d9892d Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Sat, 19 Jan 2019 17:37:03 +0100
Subject: [PATCH 589/808] [AIRFLOW-3731] Constrain mysqlclient to <1.4 (#4558)

To maintain Python2 compatibility
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 8d88ae02aecba..55a4d6b38c576 100644
--- a/setup.py
+++ b/setup.py
@@ -200,7 +200,7 @@ def write_version(filename=os.path.join(*['airflow',
               'cryptography>=2.0.0']
 ldap = ['ldap3>=2.5.1']
 mssql = ['pymssql>=2.1.1']
-mysql = ['mysqlclient>=1.3.6']
+mysql = ['mysqlclient>=1.3.6,<1.4']
 oracle = ['cx_Oracle>=5.1.2']
 password = [
     'bcrypt>=2.0.0',

From ee8b58ea4dcf8cf4f56266417f89c591323e7007 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 8 Mar 2019 14:14:24 +0000
Subject: [PATCH 590/808] [AIRFLOW-XXX] Improve airflow-jira script to make
 RelManager's life easier (#4857)

These changes do a number of things:

- Add colours to the output so  I can easily see which issues against a
  release are still open
- Order the Jira issues by update date (so oldest updated are at the
  bottom) - the older issuer will likely cherry-pick better if done in
  the bottom to top order
- Add an `--unmerged` flag to only show un-merged issues in the output
- Attempt to find the PR# and merge commit from master branch for a
  given jira issue. This won't cope with the case where we have multiple
  PRs targeting one issue.
---
 dev/airflow-jira | 97 +++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 75 insertions(+), 22 deletions(-)

diff --git a/dev/airflow-jira b/dev/airflow-jira
index 5625654c19d76..4a9833e7cb07b 100755
--- a/dev/airflow-jira
+++ b/dev/airflow-jira
@@ -58,8 +58,13 @@ JIRA_BASE = "https://issues.apache.org/jira/browse"
 JIRA_API_BASE = "https://issues.apache.org/jira"
 
 GIT_COMMIT_FIELDS = ['id', 'author_name', 'author_email', 'date', 'subject', 'body']
-GIT_LOG_FORMAT = ['%H', '%an', '%ae', '%ad', '%s', '%b']
-GIT_LOG_FORMAT = '%x1f'.join(GIT_LOG_FORMAT) + '%x1e'
+GIT_LOG_FORMAT = '%x1f'.join(['%h', '%an', '%ae', '%ad', '%s', '%b']) + '%x1e'
+
+STATUS_COLUR_MAP = {
+    'Resolved': 'green',
+    'Open': 'red',
+    'Closed': 'yellow'
+}
 
 
 def get_jiras_for_version(version):
@@ -69,7 +74,7 @@ def get_jiras_for_version(version):
     page_size = 50
     while True:
         results = asf_jira.search_issues(
-            'PROJECT={} and fixVersion={}'.format(PROJECT, version),
+            'PROJECT={} and fixVersion={} order by updated desc'.format(PROJECT, version),
             maxResults=page_size,
             startAt=start_at,
         )
@@ -83,24 +88,31 @@ def get_jiras_for_version(version):
         start_at += page_size
 
 
-def get_merged_issues(version):
-    repo = git.Repo(".", search_parent_directories=True)
-    log = repo.git.log('--format={}'.format(GIT_LOG_FORMAT))
+issue_re = re.compile(r".*? (AIRFLOW-[0-9]{1,6}) (?: \]|\s|: )", flags=re.X)
+pr_re = re.compile(r"(.*)Closes (#[0-9]{1,6})", flags=re.DOTALL)
+pr_title_re = re.compile(r".*\((#[0-9]{1,6})\)$")
+
+
+def get_merged_issues(repo, version, previous_version=None):
+    log_args = ['--format={}'.format(GIT_LOG_FORMAT)]
+    if previous_version:
+        log_args.append(previous_version + "..")
+    log = repo.git.log(*log_args)
+
     log = log.strip('\n\x1e').split("\x1e")
     log = [row.strip().split("\x1f") for row in log]
     log = [dict(zip(GIT_COMMIT_FIELDS, row)) for row in log]
 
-    issue_re = re.compile(".*(AIRFLOW-[0-9]{1,6})(\]|\s|:)")
-    pr_re = re.compile("(.*)Closes (#[0-9]{1,6})", flags=re.DOTALL)
-
     merges = {}
     for log_item in log:
         issue_id = None
 
-        match = issue_re.match(log_item['subject'])
+        issue_ids = issue_re.findall(log_item['subject'])
+
+        match = pr_title_re.match(log_item['subject'])
         if match:
-            issue_id = match.group(1)
-        if 'body' in log_item:
+            log_item['pull_request'] = match.group(1)
+        elif 'body' in log_item:
             match = pr_re.match(log_item['body'])
             if match:
                 log_item['pull_request'] = match.group(2)
@@ -109,12 +121,34 @@ def get_merged_issues(version):
         else:
             log_item['pull_request'] = '#na'
 
-        if issue_id:
+        for issue_id in issue_ids:
             merges[issue_id] = log_item
 
     return merges
 
 
+def get_commits_from_master(repo, issue):
+    log = repo.git.log(
+        '--format=%h%x1f%s',
+        '-1',
+        '--grep',
+        r'.*{issue}\(\]\|:\|\s\)'.format(issue=issue.key),
+        'origin/master')
+    if not log:
+        return None
+    commit, subject = log.split('\x1f')
+
+    merge = {'id': commit}
+    match = pr_title_re.match(subject)
+
+    if match:
+        merge['pull_request'] = match.group(1)
+    else:
+        merge['pull_request'] = '-'
+
+    return merge
+
+
 @click.group()
 def cli():
     r"""
@@ -127,22 +161,25 @@ def cli():
 
 @cli.command(short_help='Compare a jira target version against git merges')
 @click.argument('target_version', default=None)
-def compare(target_version):
-    merges = get_merged_issues(target_version)
+@click.argument('previous_version', default="")
+@click.option('--unmerged', 'unmerged_only', help="Show unmerged issues only", is_flag=True)
+def compare(target_version, previous_version=None, unmerged_only=False):
+    repo = git.Repo(".", search_parent_directories=True)
+    merges = get_merged_issues(repo, target_version, previous_version)
     issues = get_jiras_for_version(target_version)
 
     # :<18 says left align, pad to 18
     # :<50.50 truncates after 50 chars
     # !s forces as string - some of the Jira objects have a string method, but
     #    Py3 doesn't call by default
-    formatstr = "{id:<18}|{typ!s:<12}||{priority!s:<10}||{status!s:<10}|" \
-                "{description:<50.50}|{merged:<6}|{pr:<6}|{commit:<40}"
+    formatstr = "{id:<18}|{typ!s:<12}||{priority!s:<10}||{status!s}|" \
+                "{description:<83.83}|{merged:<6}|{pr:<6}|{commit:<7}"
 
     print(formatstr.format(
         id="ISSUE ID",
         typ="TYPE",
         priority="PRIORITY",
-        status="STATUS",
+        status="STATUS".ljust(10),
         description="DESCRIPTION",
         merged="MERGED",
         pr="PR",
@@ -150,15 +187,31 @@ def compare(target_version):
 
     for issue in issues:
         is_merged = issue.key in merges
+
+        if unmerged_only and is_merged:
+            continue
+
+        # Put colour on the status field. Since it will have non-printable
+        # characters we can't us string format to limit the length
+        status = issue.fields.status.name
+        if status in STATUS_COLUR_MAP:
+            status = click.style(status[:10].ljust(10), STATUS_COLUR_MAP[status])
+        else:
+            status = status[:10].ljust(10)
+
+        merge = merges.get(issue.key)
+        if not merge and issue.fields.status.name in {'Resolved', 'Closed'}:
+            merge = get_commits_from_master(repo, issue)
+
         print(formatstr.format(
             id=issue.key,
             typ=issue.fields.issuetype,
             priority=issue.fields.priority,
-            status=issue.fields.status,
+            status=status,
             description=issue.fields.summary,
             merged=is_merged,
-            pr=merges[issue.key]['pull_request'] if is_merged else "-",
-            commit=merges[issue.key]['id'] if is_merged else "-"))
+            pr=merge['pull_request'] if merge else "-",
+            commit=merge['id'] if merge else "-"))
 
 
 if __name__ == "__main__":
@@ -168,5 +221,5 @@ if __name__ == "__main__":
         exit(-1)
     try:
         cli()
-    except:
+    except Exception:
         raise

From 4eb175400b57398be511a6d13b61b6d0303f857d Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 9 Mar 2019 17:28:14 +0000
Subject: [PATCH 591/808] [AIRFLOW-4015] Add get_dag_runs GET endpoint to
 "classic" API (#4884)

We documented it as being present in 1.10.2, but we only actually made
it available in under the RBAC mode of the webserver.
---
 .../api/common/experimental/get_dag_runs.py   |   4 +-
 airflow/www/api/experimental/endpoints.py     |  23 ++++
 .../experimental/test_dag_runs_endpoint.py    | 129 ++++++++++++++++++
 3 files changed, 154 insertions(+), 2 deletions(-)
 create mode 100644 tests/www/api/experimental/test_dag_runs_endpoint.py

diff --git a/airflow/api/common/experimental/get_dag_runs.py b/airflow/api/common/experimental/get_dag_runs.py
index 63b1f993d392d..739905d5df903 100644
--- a/airflow/api/common/experimental/get_dag_runs.py
+++ b/airflow/api/common/experimental/get_dag_runs.py
@@ -22,7 +22,7 @@
 from airflow.models import DagBag, DagRun
 
 
-def get_dag_runs(dag_id, state=None):
+def get_dag_runs(dag_id, state=None, run_url_route='Airflow.graph'):
     """
     Returns a list of Dag Runs for a specific DAG ID.
     :param dag_id: String identifier of a DAG
@@ -48,7 +48,7 @@ def get_dag_runs(dag_id, state=None):
             'execution_date': run.execution_date.isoformat(),
             'start_date': ((run.start_date or '') and
                            run.start_date.isoformat()),
-            'dag_run_url': url_for('Airflow.graph', dag_id=run.dag_id,
+            'dag_run_url': url_for(run_url_route, dag_id=run.dag_id,
                                    execution_date=run.execution_date)
         })
 
diff --git a/airflow/www/api/experimental/endpoints.py b/airflow/www/api/experimental/endpoints.py
index f0bc319eb6665..ab434b2ab9b30 100644
--- a/airflow/www/api/experimental/endpoints.py
+++ b/airflow/www/api/experimental/endpoints.py
@@ -24,6 +24,7 @@
 from airflow.api.common.experimental import delete_dag as delete
 from airflow.api.common.experimental import pool as pool_api
 from airflow.api.common.experimental import trigger_dag as trigger
+from airflow.api.common.experimental.get_dag_runs import get_dag_runs
 from airflow.api.common.experimental.get_task import get_task
 from airflow.api.common.experimental.get_task_instance import get_task_instance
 from airflow.exceptions import AirflowException
@@ -106,6 +107,28 @@ def delete_dag(dag_id):
     return jsonify(message="Removed {} record(s)".format(count), count=count)
 
 
+@api_experimental.route('/dags/<string:dag_id>/dag_runs', methods=['GET'])
+@requires_authentication
+def dag_runs(dag_id):
+    """
+    Returns a list of Dag Runs for a specific DAG ID.
+    :query param state: a query string parameter '?state=queued|running|success...'
+    :param dag_id: String identifier of a DAG
+    :return: List of DAG runs of a DAG with requested state,
+    or all runs if the state is not specified
+    """
+    try:
+        state = request.args.get('state')
+        dagruns = get_dag_runs(dag_id, state, run_url_route='airflow.graph')
+    except AirflowException as err:
+        _log.info(err)
+        response = jsonify(error="{}".format(err))
+        response.status_code = 400
+        return response
+
+    return jsonify(dagruns)
+
+
 @api_experimental.route('/test', methods=['GET'])
 @requires_authentication
 def test():
diff --git a/tests/www/api/experimental/test_dag_runs_endpoint.py b/tests/www/api/experimental/test_dag_runs_endpoint.py
new file mode 100644
index 0000000000000..614023bdeef18
--- /dev/null
+++ b/tests/www/api/experimental/test_dag_runs_endpoint.py
@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import json
+import unittest
+
+from airflow import configuration
+from airflow.api.common.experimental.trigger_dag import trigger_dag
+from airflow.models import DagRun
+from airflow.settings import Session
+from airflow.www import app as application
+
+
+class TestDagRunsEndpoint(unittest.TestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        super(TestDagRunsEndpoint, cls).setUpClass()
+        session = Session()
+        session.query(DagRun).delete()
+        session.commit()
+        session.close()
+
+    def setUp(self):
+        super(TestDagRunsEndpoint, self).setUp()
+        configuration.load_test_config()
+        app = application.create_app(testing=True)
+        self.app = app.test_client()
+
+    def tearDown(self):
+        session = Session()
+        session.query(DagRun).delete()
+        session.commit()
+        session.close()
+        super(TestDagRunsEndpoint, self).tearDown()
+
+    def test_get_dag_runs_success(self):
+        url_template = '/api/experimental/dags/{}/dag_runs'
+        dag_id = 'example_bash_operator'
+        # Create DagRun
+        dag_run = trigger_dag(dag_id=dag_id, run_id='test_get_dag_runs_success')
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(200, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertIsInstance(data, list)
+        self.assertEqual(len(data), 1)
+        self.assertEqual(data[0]['dag_id'], dag_id)
+        self.assertEqual(data[0]['id'], dag_run.id)
+
+    def test_get_dag_runs_success_with_state_parameter(self):
+        url_template = '/api/experimental/dags/{}/dag_runs?state=running'
+        dag_id = 'example_bash_operator'
+        # Create DagRun
+        dag_run = trigger_dag(dag_id=dag_id, run_id='test_get_dag_runs_success')
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(200, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertIsInstance(data, list)
+        self.assertEqual(len(data), 1)
+        self.assertEqual(data[0]['dag_id'], dag_id)
+        self.assertEqual(data[0]['id'], dag_run.id)
+
+    def test_get_dag_runs_success_with_capital_state_parameter(self):
+        url_template = '/api/experimental/dags/{}/dag_runs?state=RUNNING'
+        dag_id = 'example_bash_operator'
+        # Create DagRun
+        dag_run = trigger_dag(dag_id=dag_id, run_id='test_get_dag_runs_success')
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(200, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertIsInstance(data, list)
+        self.assertEqual(len(data), 1)
+        self.assertEqual(data[0]['dag_id'], dag_id)
+        self.assertEqual(data[0]['id'], dag_run.id)
+
+    def test_get_dag_runs_success_with_state_no_result(self):
+        url_template = '/api/experimental/dags/{}/dag_runs?state=dummy'
+        dag_id = 'example_bash_operator'
+        # Create DagRun
+        trigger_dag(dag_id=dag_id, run_id='test_get_dag_runs_success')
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(200, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertIsInstance(data, list)
+        self.assertEqual(len(data), 0)
+
+    def test_get_dag_runs_invalid_dag_id(self):
+        url_template = '/api/experimental/dags/{}/dag_runs'
+        dag_id = 'DUMMY_DAG'
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(400, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertNotIsInstance(data, list)
+
+    def test_get_dag_runs_no_runs(self):
+        url_template = '/api/experimental/dags/{}/dag_runs'
+        dag_id = 'example_bash_operator'
+
+        response = self.app.get(url_template.format(dag_id))
+        self.assertEqual(200, response.status_code)
+        data = json.loads(response.data.decode('utf-8'))
+
+        self.assertIsInstance(data, list)
+        self.assertEqual(len(data), 0)

From 3e72759e02113a3567abed6a1e0a1a5dae7e64ca Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 13 Mar 2019 18:58:53 +0000
Subject: [PATCH 592/808] [AIRFLOW-2190] Send correct HTTP status for base_url
 not found (#4910)

The previous fix for this (#4596) fixed the type error, but didn't send
the correct status - we were sending a HTTP response of:

    HTTP/1.0 404 b'Not Found'

which some browsers interpret as a 200!
---
 airflow/bin/cli.py           |  6 +++---
 airflow/www/app.py           |  5 ++++-
 airflow/www_rbac/app.py      |  5 ++++-
 tests/www/test_views.py      | 29 +++++++++++++++++------------
 tests/www_rbac/test_views.py | 30 ++++++++++++++++++------------
 5 files changed, 46 insertions(+), 29 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 8019112df4dd0..e78e8657d88ac 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -845,15 +845,15 @@ def webserver(args):
             "Starting the web server on port {0} and host {1}.".format(
                 args.port, args.hostname))
         if settings.RBAC:
-            app, _ = create_app_rbac(conf, testing=conf.get('core', 'unit_test_mode'))
+            app, _ = create_app_rbac(None, testing=conf.get('core', 'unit_test_mode'))
         else:
-            app = create_app(conf, testing=conf.get('core', 'unit_test_mode'))
+            app = create_app(None, testing=conf.get('core', 'unit_test_mode'))
         app.run(debug=True, use_reloader=False if app.config['TESTING'] else True,
                 port=args.port, host=args.hostname,
                 ssl_context=(ssl_cert, ssl_key) if ssl_cert and ssl_key else None)
     else:
         os.environ['SKIP_DAGS_PARSING'] = 'True'
-        app = cached_app_rbac(conf) if settings.RBAC else cached_app(conf)
+        app = cached_app_rbac(None) if settings.RBAC else cached_app(None)
         pid, stdout, stderr, log_file = setup_locations(
             "webserver", args.pid, args.stdout, args.stderr, args.log_file)
         os.environ.pop('SKIP_DAGS_PARSING')
diff --git a/airflow/www/app.py b/airflow/www/app.py
index d85caa5de3ad8..f2041dd9f3bea 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -54,6 +54,9 @@ def create_app(config=None, testing=False):
     app.config['SESSION_COOKIE_SECURE'] = conf.getboolean('webserver', 'COOKIE_SECURE')
     app.config['SESSION_COOKIE_SAMESITE'] = conf.get('webserver', 'COOKIE_SAMESITE')
 
+    if config:
+        app.config.from_mapping(config)
+
     csrf.init_app(app)
 
     app.config['TESTING'] = testing
@@ -173,7 +176,7 @@ def shutdown_session(exception=None):
 
 
 def root_app(env, resp):
-    resp(b'404 Not Found', [('Content-Type', 'text/plain')])
+    resp('404 Not Found', [('Content-Type', 'text/plain')])
     return [b'Apache Airflow is not at this location']
 
 
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index bb13dd649b07e..f1155d677438a 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -58,6 +58,9 @@ def create_app(config=None, session=None, testing=False, app_name="Airflow"):
     app.config['SESSION_COOKIE_SECURE'] = conf.getboolean('webserver', 'COOKIE_SECURE')
     app.config['SESSION_COOKIE_SAMESITE'] = conf.get('webserver', 'COOKIE_SAMESITE')
 
+    if config:
+        app.config.from_mapping(config)
+
     csrf.init_app(app)
 
     db = SQLA(app)
@@ -206,7 +209,7 @@ def shutdown_session(exception=None):
 
 
 def root_app(env, resp):
-    resp(b'404 Not Found', [('Content-Type', 'text/plain')])
+    resp('404 Not Found', [('Content-Type', 'text/plain')])
     return [b'Apache Airflow is not at this location']
 
 
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index a0d86ac54a02a..3da5cb5552fdf 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -30,6 +30,7 @@
 
 from urllib.parse import quote_plus
 from werkzeug.test import Client
+from werkzeug.wrappers import BaseResponse
 
 from airflow import models, configuration
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
@@ -507,25 +508,29 @@ def test_import_variables(self):
 
 
 class TestMountPoint(unittest.TestCase):
-    def setUp(self):
-        super(TestMountPoint, self).setUp()
+    @classmethod
+    def setUpClass(cls):
         configuration.load_test_config()
         configuration.conf.set("webserver", "base_url", "http://localhost:8080/test")
-        config = dict()
-        config['WTF_CSRF_METHODS'] = []
         # Clear cached app to remount base_url forcefully
         application.app = None
-        app = application.cached_app(config=config, testing=True)
-        self.client = Client(app)
+        app = application.cached_app(config={'WTF_CSRF_ENABLED': False}, testing=True)
+        cls.client = Client(app, BaseResponse)
+
+    @classmethod
+    def tearDownClass(cls):
+        application.app = None
+        application.appbuilder = None
 
     def test_mount(self):
-        response, _, _ = self.client.get('/', follow_redirects=True)
-        txt = b''.join(response)
-        self.assertEqual(b"Apache Airflow is not at this location", txt)
+        # Test an endpoint that doesn't need auth!
+        resp = self.client.get('/test/health')
+        self.assertEqual(resp.status_code, 200)
+        self.assertIn(b"healthy", resp.data)
 
-        response, _, _ = self.client.get('/test', follow_redirects=True)
-        resp_html = b''.join(response)
-        self.assertIn(b"DAGs", resp_html)
+    def test_not_found(self):
+        resp = self.client.get('/', follow_redirects=True)
+        self.assertEqual(resp.status_code, 404)
 
 
 class ViewWithDateTimeAndNumRunsAndDagRunsFormTester:
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 7bfbe19f5eb35..2d4e83de55ba2 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -35,6 +35,7 @@
 from flask._compat import PY2
 from parameterized import parameterized
 from werkzeug.test import Client
+from werkzeug.wrappers import BaseResponse
 
 from airflow import configuration as conf
 from airflow import models, settings
@@ -262,24 +263,29 @@ def test_odd_name(self):
 
 
 class TestMountPoint(unittest.TestCase):
-    def setUp(self):
+    @classmethod
+    def setUpClass(cls):
         application.app = None
-        super(TestMountPoint, self).setUp()
+        application.appbuilder = None
         conf.load_test_config()
         conf.set("webserver", "base_url", "http://localhost:8080/test")
-        config = dict()
-        config['WTF_CSRF_METHODS'] = []
-        app = application.cached_app(config=config, testing=True)
-        self.client = Client(app)
+        app = application.cached_app(config={'WTF_CSRF_ENABLED': False}, session=Session, testing=True)
+        cls.client = Client(app, BaseResponse)
+
+    @classmethod
+    def tearDownClass(cls):
+        application.app = None
+        application.appbuilder = None
 
     def test_mount(self):
-        resp, _, _ = self.client.get('/', follow_redirects=True)
-        txt = b''.join(resp)
-        self.assertEqual(b"Apache Airflow is not at this location", txt)
+        # Test an endpoint that doesn't need auth!
+        resp = self.client.get('/test/health')
+        self.assertEqual(resp.status_code, 200)
+        self.assertIn(b"healthy", resp.data)
 
-        resp, _, _ = self.client.get('/test/home', follow_redirects=True)
-        resp_html = b''.join(resp)
-        self.assertIn(b"DAGs", resp_html)
+    def test_not_found(self):
+        resp = self.client.get('/', follow_redirects=True)
+        self.assertEqual(resp.status_code, 404)
 
 
 class TestAirflowBaseViews(TestBase):

From 2de34bd8c5215c2d84e6a768a33d8f9fa323542c Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 14 Mar 2019 14:50:41 +0000
Subject: [PATCH 593/808] [AIRFLOW-4083] Add tests for link generation utils
 (#4912)

We were making use of the "bleach" module or jinja.escape function to
clean parameters when it wasn't needed - we could simply call .format on
the Markup object and it will handle escaping for us. (format the
object, not format the string passed to the constructor)

This removes the (direct?) dependency on bleach - one less thing to
depend on is a good thing too.
---
 airflow/www/views.py         | 43 +++++++++++--------------
 airflow/www_rbac/app.py      |  2 +-
 airflow/www_rbac/utils.py    | 23 +++++++-------
 airflow/www_rbac/views.py    | 11 +++----
 setup.py                     |  1 -
 tests/core.py                |  3 +-
 tests/www/test_views.py      | 61 ++++++++++++++++++++++++++++++++++++
 tests/www_rbac/test_utils.py | 59 +++++++++++++++++++++++++++++++---
 8 files changed, 152 insertions(+), 51 deletions(-)

diff --git a/airflow/www/views.py b/airflow/www/views.py
index 737b821382c1e..398c223f29516 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -33,7 +33,6 @@
 from functools import wraps
 from textwrap import dedent
 
-import bleach
 import markdown
 import pendulum
 import sqlalchemy as sqla
@@ -108,13 +107,12 @@ def dag_link(v, c, m, p):
     if m.dag_id is None:
         return Markup()
 
-    dag_id = bleach.clean(m.dag_id)
     url = url_for(
         'airflow.graph',
-        dag_id=dag_id,
+        dag_id=m.dag_id,
         execution_date=m.execution_date)
     return Markup(
-        '<a href="{}">{}</a>'.format(url, dag_id))
+        '<a href="{}">{}</a>').format(url, m.dag_id)
 
 
 def log_url_formatter(v, c, m, p):
@@ -125,46 +123,43 @@ def log_url_formatter(v, c, m, p):
 
 
 def dag_run_link(v, c, m, p):
-    dag_id = bleach.clean(m.dag_id)
     url = url_for(
         'airflow.graph',
         dag_id=m.dag_id,
         run_id=m.run_id,
         execution_date=m.execution_date)
-    title = escape(m.run_id)
-    return Markup('<a href="{url}">{title}</a>'.format(**locals()))
+    title = m.run_id
+    return Markup('<a href="{url}">{title}</a>').format(**locals())
 
 
 def task_instance_link(v, c, m, p):
-    dag_id = bleach.clean(m.dag_id)
-    task_id = bleach.clean(m.task_id)
     url = url_for(
         'airflow.task',
-        dag_id=dag_id,
-        task_id=task_id,
+        dag_id=m.dag_id,
+        task_id=m.task_id,
         execution_date=m.execution_date.isoformat())
     url_root = url_for(
         'airflow.graph',
-        dag_id=dag_id,
-        root=task_id,
+        dag_id=m.dag_id,
+        root=m.task_id,
         execution_date=m.execution_date.isoformat())
     return Markup(
         """
         <span style="white-space: nowrap;">
-        <a href="{url}">{task_id}</a>
+        <a href="{url}">{m.task_id}</a>
         <a href="{url_root}" title="Filter on this task and upstream">
         <span class="glyphicon glyphicon-filter" style="margin-left: 0px;"
             aria-hidden="true"></span>
         </a>
         </span>
-        """.format(**locals()))
+        """).format(**locals())
 
 
 def state_token(state):
     color = State.color(state)
     return Markup(
         '<span class="label" style="background-color:{color};">'
-        '{state}</span>'.format(**locals()))
+        '{state}</span>').format(**locals())
 
 
 def parse_datetime_f(value):
@@ -188,11 +183,11 @@ def datetime_f(v, c, m, p):
     dttm = attr.isoformat() if attr else ''
     if timezone.utcnow().isoformat()[:4] == dttm[:4]:
         dttm = dttm[5:]
-    return Markup("<nobr>{}</nobr>".format(dttm))
+    return Markup("<nobr>{}</nobr>").format(dttm)
 
 
 def nobr_f(v, c, m, p):
-    return Markup("<nobr>{}</nobr>".format(getattr(m, p)))
+    return Markup("<nobr>{}</nobr>").format(getattr(m, p))
 
 
 def label_link(v, c, m, p):
@@ -203,15 +198,15 @@ def label_link(v, c, m, p):
     url = url_for(
         'airflow.chart', chart_id=m.id, iteration_no=m.iteration_no,
         **default_params)
-    title = escape(m.label)
-    return Markup("<a href='{url}'>{title}</a>".format(**locals()))
+    title = m.label
+    return Markup("<a href='{url}'>{title}</a>").format(**locals())
 
 
 def pool_link(v, c, m, p):
-    title = escape(m.pool)
+    title = m.pool
 
     url = url_for('airflow.task', flt1_pool_equals=m.pool)
-    return Markup("<a href='{url}'>{title}</a>".format(**locals()))
+    return Markup("<a href='{url}'>{title}</a>").format(**locals())
 
 
 def pygment_html_render(s, lexer=lexers.TextLexer):
@@ -279,7 +274,7 @@ def fused_slots(v, c, m, p):
         flt1_pool_equals=m.pool,
         flt2_state_equals='running',
     )
-    return Markup("<a href='{0}'>{1}</a>".format(url, m.used_slots()))
+    return Markup("<a href='{0}'>{1}</a>").format(url, m.used_slots())
 
 
 def fqueued_slots(v, c, m, p):
@@ -290,7 +285,7 @@ def fqueued_slots(v, c, m, p):
         sort='1',
         desc='1'
     )
-    return Markup("<a href='{0}'>{1}</a>".format(url, m.queued_slots()))
+    return Markup("<a href='{0}'>{1}</a>").format(url, m.queued_slots())
 
 
 def recurse_tasks(tasks, task_ids, dag_ids, task_id_to_dag):
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index f1155d677438a..58e296c4ca9bf 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -227,5 +227,5 @@ def cached_app(config=None, session=None, testing=False):
 
 def cached_appbuilder(config=None, testing=False):
     global appbuilder
-    cached_app(config, testing)
+    cached_app(config=config, testing=testing)
     return appbuilder
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index 7c983279afebb..dbed4001dc4a9 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -24,7 +24,6 @@
 import json
 import time
 import wtforms
-import bleach
 import markdown
 import re
 import zipfile
@@ -235,8 +234,8 @@ def make_cache_key(*args, **kwargs):
 
 
 def task_instance_link(attr):
-    dag_id = bleach.clean(attr.get('dag_id')) if attr.get('dag_id') else None
-    task_id = bleach.clean(attr.get('task_id')) if attr.get('task_id') else None
+    dag_id = attr.get('dag_id')
+    task_id = attr.get('task_id')
     execution_date = attr.get('execution_date')
     url = url_for(
         'Airflow.task',
@@ -257,14 +256,14 @@ def task_instance_link(attr):
             aria-hidden="true"></span>
         </a>
         </span>
-        """.format(**locals()))
+        """).format(**locals())
 
 
 def state_token(state):
     color = State.color(state)
     return Markup(
         '<span class="label" style="background-color:{color};">'
-        '{state}</span>'.format(**locals()))
+        '{state}</span>').format(**locals())
 
 
 def state_f(attr):
@@ -275,7 +274,7 @@ def state_f(attr):
 def nobr_f(attr_name):
     def nobr(attr):
         f = attr.get(attr_name)
-        return Markup("<nobr>{}</nobr>".format(f))
+        return Markup("<nobr>{}</nobr>").format(f)
     return nobr
 
 
@@ -285,24 +284,24 @@ def dt(attr):
         f = f.isoformat() if f else ''
         if timezone.utcnow().isoformat()[:4] == f[:4]:
             f = f[5:]
-        return Markup("<nobr>{}</nobr>".format(f))
+        return Markup("<nobr>{}</nobr>").format(f)
     return dt
 
 
 def dag_link(attr):
-    dag_id = bleach.clean(attr.get('dag_id')) if attr.get('dag_id') else None
+    dag_id = attr.get('dag_id')
     execution_date = attr.get('execution_date')
     url = url_for(
         'Airflow.graph',
         dag_id=dag_id,
         execution_date=execution_date)
     return Markup(
-        '<a href="{}">{}</a>'.format(url, dag_id))
+        '<a href="{}">{}</a>').format(url, dag_id)
 
 
 def dag_run_link(attr):
-    dag_id = bleach.clean(attr.get('dag_id')) if attr.get('dag_id') else None
-    run_id = bleach.clean(attr.get('run_id')) if attr.get('run_id') else None
+    dag_id = attr.get('dag_id')
+    run_id = attr.get('run_id')
     execution_date = attr.get('execution_date')
     url = url_for(
         'Airflow.graph',
@@ -310,7 +309,7 @@ def dag_run_link(attr):
         run_id=run_id,
         execution_date=execution_date)
     return Markup(
-        '<a href="{url}">{run_id}</a>'.format(**locals()))
+        '<a href="{url}">{run_id}</a>').format(**locals())
 
 
 def pygment_html_render(s, lexer=lexers.TextLexer):
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 70f056123aa43..3be5181cfbc35 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -35,7 +35,7 @@
 import sqlalchemy as sqla
 from flask import (
     redirect, request, Markup, Response, render_template,
-    make_response, flash, jsonify, escape, url_for)
+    make_response, flash, jsonify, url_for)
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
@@ -2000,8 +2000,7 @@ def pool_link(attr):
         pool_id = attr.get('pool')
         if pool_id is not None:
             url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id)
-            pool_id = escape(pool_id)
-            return Markup("<a href='{url}'>{pool_id}</a>".format(**locals()))
+            return Markup("<a href='{url}'>{pool_id}</a>").format(**locals())
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
 
@@ -2010,8 +2009,7 @@ def fused_slots(attr):
         used_slots = attr.get('used_slots')
         if pool_id is not None and used_slots is not None:
             url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id, _flt_3_state='running')
-            pool_id = escape(pool_id)
-            return Markup("<a href='{url}'>{used_slots}</a>".format(**locals()))
+            return Markup("<a href='{url}'>{used_slots}</a>").format(**locals())
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
 
@@ -2020,8 +2018,7 @@ def fqueued_slots(attr):
         queued_slots = attr.get('queued_slots')
         if pool_id is not None and queued_slots is not None:
             url = url_for('TaskInstanceModelView.list', _flt_3_pool=pool_id, _flt_3_state='queued')
-            pool_id = escape(pool_id)
-            return Markup("<a href='{url}'>{queued_slots}</a>".format(**locals()))
+            return Markup("<a href='{url}'>{queued_slots}</a>").format(**locals())
         else:
             return Markup('<span class="label label-danger">Invalid</span>')
 
diff --git a/setup.py b/setup.py
index 55a4d6b38c576..547168ce4b847 100644
--- a/setup.py
+++ b/setup.py
@@ -284,7 +284,6 @@ def do_setup():
         scripts=['airflow/bin/airflow'],
         install_requires=[
             'alembic>=0.9, <1.0',
-            'bleach~=2.1.3',
             'configparser>=3.5.0, <3.6.0',
             'croniter>=0.3.17, <0.4',
             'dill>=0.2.2, <0.3',
diff --git a/tests/core.py b/tests/core.py
index 6549a610e5f8d..e98d3cfb13dad 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -22,7 +22,6 @@
 import json
 import unittest
 
-import bleach
 import doctest
 import mock
 import multiprocessing
@@ -1824,7 +1823,7 @@ def test_xss(self):
             # exception is expected here since dag doesnt exist
             pass
         response = self.app.get("/admin/log", follow_redirects=True)
-        self.assertIn(bleach.clean("<script>alert(123456)</script>"), response.data.decode('UTF-8'))
+        self.assertNotIn("<script>alert(123456)</script>", response.data.decode('UTF-8'))
 
     def test_chart_data_template(self):
         """Protect chart_data from being able to do RCE."""
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 3da5cb5552fdf..31188ef2439f6 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -32,6 +32,8 @@
 from werkzeug.test import Client
 from werkzeug.wrappers import BaseResponse
 
+
+import airflow
 from airflow import models, configuration
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
 from airflow.models import DAG, DagRun, TaskInstance
@@ -826,5 +828,64 @@ def test_delete_dag_button_for_dag_on_scheduler_only(self):
         session.commit()
 
 
+class HelpersTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):
+        cls.app = application.create_app(testing=True)
+
+        airflow.load_login()
+        # Delay this import until here
+        import airflow.www.views as views
+        cls.views = views
+
+    def test_state_token(self):
+        # It's shouldn't possible to set these odd values anymore, but lets
+        # ensure they are escaped!
+        html = str(self.views.state_token('<script>alert(1)</script>'))
+
+        self.assertIn(
+            '&lt;script&gt;alert(1)&lt;/script&gt;',
+            html,
+        )
+        self.assertNotIn(
+            '<script>alert(1)</script>',
+            html,
+        )
+
+    def test_task_instance_link(self):
+        mock_task = mock.Mock(dag_id='<a&1>', task_id='<b2>', execution_date=datetime(2017, 10, 12))
+        with self.app.test_request_context():
+            html = str(self.views.task_instance_link(
+                v=None, c=None, m=mock_task, p=None
+            ))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertIn('%3Cb2%3E', html)
+        self.assertNotIn('<a&1>', html)
+        self.assertNotIn('<b2>', html)
+
+    def test_dag_link(self):
+        mock_dag = mock.Mock(dag_id='<a&1>', execution_date=datetime(2017, 10, 12))
+        with self.app.test_request_context():
+            html = str(self.views.dag_link(
+                v=None, c=None, m=mock_dag, p=None
+            ))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertNotIn('<a&1>', html)
+
+    def test_dag_run_link(self):
+        mock_run = mock.Mock(dag_id='<a&1>', run_id='<b2>', execution_date=datetime(2017, 10, 12))
+        with self.app.test_request_context():
+            html = str(self.views.dag_run_link(
+                v=None, c=None, m=mock_run, p=None
+            ))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertIn('%3Cb2%3E', html)
+        self.assertNotIn('<a&1>', html)
+        self.assertNotIn('<b2>', html)
+
+
 if __name__ == '__main__':
     unittest.main()
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index 84bf6ce8aeb07..b0122be4dafed 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from datetime import datetime
 import unittest
 import mock
 from xml.dom import minidom
@@ -25,10 +26,6 @@
 
 
 class UtilsTest(unittest.TestCase):
-
-    def setUp(self):
-        super(UtilsTest, self).setUp()
-
     def test_empty_variable_should_not_be_hidden(self):
         self.assertFalse(utils.should_hide_value_for_key(""))
         self.assertFalse(utils.should_hide_value_for_key(None))
@@ -148,6 +145,60 @@ def test_open_maybe_zipped_archive(self, mocked_ZipFile, mocked_is_zipfile):
         (args, kwargs) = instance.open.call_args_list[0]
         self.assertEqual('deep/path/to/file.txt', args[0])
 
+    def test_state_token(self):
+        # It's shouldn't possible to set these odd values anymore, but lets
+        # ensure they are escaped!
+        html = str(utils.state_token('<script>alert(1)</script>'))
+
+        self.assertIn(
+            '&lt;script&gt;alert(1)&lt;/script&gt;',
+            html,
+        )
+        self.assertNotIn(
+            '<script>alert(1)</script>',
+            html,
+        )
+
+    def test_task_instance_link(self):
+
+        from airflow.www_rbac.app import cached_appbuilder
+        with cached_appbuilder(testing=True).app.test_request_context():
+            html = str(utils.task_instance_link({
+                'dag_id': '<a&1>',
+                'task_id': '<b2>',
+                'execution_date': datetime.now()
+            }))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertIn('%3Cb2%3E', html)
+        self.assertNotIn('<a&1>', html)
+        self.assertNotIn('<b2>', html)
+
+    def test_dag_link(self):
+        from airflow.www_rbac.app import cached_appbuilder
+        with cached_appbuilder(testing=True).app.test_request_context():
+            html = str(utils.dag_link({
+                'dag_id': '<a&1>',
+                'execution_date': datetime.now()
+            }))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertNotIn('<a&1>', html)
+
+    def test_dag_run_link(self):
+        from airflow.www_rbac.app import cached_appbuilder
+        with cached_appbuilder(testing=True).app.test_request_context():
+            html = str(utils.dag_run_link({
+                'dag_id': '<a&1>',
+                'run_id': '<b2>',
+                'execution_date': datetime.now()
+            }))
+
+        self.assertIn('%3Ca%261%3E', html)
+        self.assertIn('%3Cb2%3E', html)
+        self.assertNotIn('<a&1>', html)
+        self.assertNotIn('<b2>', html)
+
 
 if __name__ == '__main__':
     unittest.main()

From 03b2d74e31122f0001a7cc4e463f6af12ed14948 Mon Sep 17 00:00:00 2001
From: Xiaodong <11539188+XD-DENG@users.noreply.github.com>
Date: Wed, 25 Jul 2018 19:09:38 -0700
Subject: [PATCH 594/808] [AIRFLOW-2798] Remove needless code from models.py

If `email_on_failure` or `email_on_failure` set to
TRUE and email available, there will be email sent
out on event of retry or failure.

In the implementation, there is a argument
`is_retry` passed to method `self.email_alert`.
However, inside this method, this argument is not
used at all. I believer the initial author of this
method was planning to differentiate the email to
be sent out, but for whatever reason this was not
implemented.

Given in the email to be sent out, there will be a
line "Try {try_number} out of {max_tries}<br>", it
would be fine not to differentiate **retry email**
and **failure email**.

Closes #3640 from XD-DENG/patch-1
---
 airflow/models.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index f11f90888e4d4..010ea819451de 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -1825,7 +1825,7 @@ def handle_failure(self, error, test_mode=False, context=None, session=None):
                 self.state = State.UP_FOR_RETRY
                 self.log.info('Marking task as UP_FOR_RETRY')
                 if task.email_on_retry and task.email:
-                    self.email_alert(error, is_retry=True)
+                    self.email_alert(error)
             else:
                 self.state = State.FAILED
                 if task.retries:
@@ -1833,7 +1833,7 @@ def handle_failure(self, error, test_mode=False, context=None, session=None):
                 else:
                     self.log.info('Marking task as FAILED.')
                 if task.email_on_failure and task.email:
-                    self.email_alert(error, is_retry=False)
+                    self.email_alert(error)
         except Exception as e2:
             self.log.error('Failed to send email to: %s', task.email)
             self.log.exception(e2)
@@ -2013,7 +2013,7 @@ def render_templates(self):
                 rendered_content = rt(attr, content, jinja_context)
                 setattr(task, attr, rendered_content)
 
-    def email_alert(self, exception, is_retry=False):
+    def email_alert(self, exception):
         task = self.task
         title = "Airflow alert: {self}".format(**locals())
         exception = str(exception).replace('\n', '<br>')

From da4e3a0670dec64eb0bd0cb014a9969683e46465 Mon Sep 17 00:00:00 2001
From: Alek Storm <alek.storm@gmail.com>
Date: Wed, 14 Nov 2018 15:12:31 -0600
Subject: [PATCH 595/808] [AIRFLOW-1262] Allow configuration of email alert
 subject and body (#2338)

---
 airflow/models.py | 54 +++++++++++++++++++++++++++++++++--------------
 tests/models.py   | 52 +++++++++++++++++++++++++++++++++++++++------
 2 files changed, 83 insertions(+), 23 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 010ea819451de..cdedbab0ebf80 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2014,21 +2014,40 @@ def render_templates(self):
                 setattr(task, attr, rendered_content)
 
     def email_alert(self, exception):
-        task = self.task
-        title = "Airflow alert: {self}".format(**locals())
-        exception = str(exception).replace('\n', '<br>')
+        exception_html = str(exception).replace('\n', '<br>')
+        jinja_context = self.get_template_context()
+        jinja_context.update(dict(
+            exception=exception,
+            exception_html=exception_html,
+            try_number=self.try_number,
+            max_tries=self.max_tries))
+
+        jinja_env = self.task.get_template_env()
+
+        default_subject = 'Airflow alert: {{ti}}'
         # For reporting purposes, we report based on 1-indexed,
         # not 0-indexed lists (i.e. Try 1 instead of
         # Try 0 for the first attempt).
-        body = (
-            "Try {try_number} out of {max_tries}<br>"
-            "Exception:<br>{exception}<br>"
-            "Log: <a href='{self.log_url}'>Link</a><br>"
-            "Host: {self.hostname}<br>"
-            "Log file: {self.log_filepath}<br>"
-            "Mark success: <a href='{self.mark_success_url}'>Link</a><br>"
-        ).format(try_number=self.try_number, max_tries=self.max_tries + 1, **locals())
-        send_email(task.email, title, body)
+        default_html_content = (
+            'Try {{try_number}} out of {{max_tries + 1}}<br>'
+            'Exception:<br>{{exception_html}}<br>'
+            'Log: <a href="{{ti.log_url}}">Link</a><br>'
+            'Host: {{ti.hostname}}<br>'
+            'Log file: {{ti.log_filepath}}<br>'
+            'Mark success: <a href="{{ti.mark_success_url}}">Link</a><br>'
+        )
+
+        def render(key, content):
+            if configuration.has_option('email', key):
+                path = configuration.get('email', key)
+                with open(path) as f:
+                    content = f.read()
+
+            return jinja_env.from_string(content).render(**jinja_context)
+
+        subject = render('subject_template', default_subject)
+        html_content = render('html_content_template', default_html_content)
+        send_email(self.task.email, subject, html_content)
 
     def set_duration(self):
         if self.end_date and self.start_date:
@@ -2905,9 +2924,7 @@ def render_template(self, attr, content, context):
         Renders a template either from a file or directly in a field, and returns
         the rendered result.
         """
-        jinja_env = self.dag.get_template_env() \
-            if hasattr(self, 'dag') \
-            else jinja2.Environment(cache_size=0)
+        jinja_env = self.get_template_env()
 
         exts = self.__class__.template_ext
         if (
@@ -2917,6 +2934,11 @@ def render_template(self, attr, content, context):
         else:
             return self.render_template_from_field(attr, content, context, jinja_env)
 
+    def get_template_env(self):
+        return self.dag.get_template_env() \
+            if hasattr(self, 'dag') \
+            else jinja2.Environment(cache_size=0)
+
     def prepare_template(self):
         """
         Hook that is triggered after the templated fields get replaced
@@ -2934,7 +2956,7 @@ def resolve_template_files(self):
                 continue
             elif isinstance(content, six.string_types) and \
                     any([content.endswith(ext) for ext in self.template_ext]):
-                env = self.dag.get_template_env()
+                env = self.get_template_env()
                 try:
                     setattr(self, attr, env.loader.get_source(env, content)[0])
                 except Exception as e:
diff --git a/tests/models.py b/tests/models.py
index 6c60ef956d0fd..fcabd97f3e51c 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -36,7 +36,7 @@
 
 import pendulum
 import six
-from mock import ANY, Mock, patch
+from mock import ANY, Mock, mock_open, patch
 from parameterized import parameterized
 from freezegun import freeze_time
 
@@ -2835,15 +2835,53 @@ def success_handler(self, context):
 
     @patch('airflow.models.send_email')
     def test_email_alert(self, mock_send_email):
-        task = DummyOperator(task_id='op', email='test@test.test')
+        dag = models.DAG(dag_id='test_failure_email')
+        task = BashOperator(
+            task_id='test_email_alert',
+            dag=dag,
+            bash_command='exit 1',
+            start_date=DEFAULT_DATE,
+            email='to')
+
         ti = TI(task=task, execution_date=datetime.datetime.now())
-        ti.email_alert(RuntimeError('it broke'))
 
-        self.assertTrue(mock_send_email.called)
+        try:
+            ti.run()
+        except AirflowException:
+            pass
+
+        (email, title, body), _ = mock_send_email.call_args
+        self.assertEqual(email, 'to')
+        self.assertIn('test_email_alert', title)
+        self.assertIn('test_email_alert', body)
+
+    @patch('airflow.models.send_email')
+    def test_email_alert_with_config(self, mock_send_email):
+        dag = models.DAG(dag_id='test_failure_email')
+        task = BashOperator(
+            task_id='test_email_alert_with_config',
+            dag=dag,
+            bash_command='exit 1',
+            start_date=DEFAULT_DATE,
+            email='to')
+
+        ti = TI(
+            task=task, execution_date=datetime.datetime.now())
+
+        configuration.set('email', 'SUBJECT_TEMPLATE', '/subject/path')
+        configuration.set('email', 'HTML_CONTENT_TEMPLATE', '/html_content/path')
+
+        opener = mock_open(read_data='template: {{ti.task_id}}')
+        with patch('airflow.models.open', opener, create=True):
+            try:
+                ti.run()
+            except AirflowException:
+                pass
+
         (email, title, body), _ = mock_send_email.call_args
-        self.assertEqual(email, 'test@test.test')
-        self.assertIn(repr(ti), title)
-        self.assertIn('it broke', body)
+        self.assertEqual(email, 'to')
+        self.assertEqual('template: test_email_alert_with_config', title)
+        self.assertEqual('template: test_email_alert_with_config', body)
 
     def test_set_duration(self):
         task = DummyOperator(task_id='op', email='test@test.test')

From 1c00bce96aa806fa16a24923054d6ae2127b6fc1 Mon Sep 17 00:00:00 2001
From: Dane Laban <dane.laban@gmail.com>
Date: Sat, 23 Feb 2019 10:35:00 +1100
Subject: [PATCH 596/808] [AIRFLOW-3924] Fix try number in alert emails (#4741)

Alert emails sent via email_alert() have the correct try number
in the body of the text.
Add a test to ensure the first email sent says `Try 1`.
---
 airflow/models.py | 4 +++-
 tests/models.py   | 1 +
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/airflow/models.py b/airflow/models.py
index cdedbab0ebf80..bbeb026e86676 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -2016,10 +2016,12 @@ def render_templates(self):
     def email_alert(self, exception):
         exception_html = str(exception).replace('\n', '<br>')
         jinja_context = self.get_template_context()
+        # This function is called after changing the state
+        # from State.RUNNING so need to subtract 1 from self.try_number.
         jinja_context.update(dict(
             exception=exception,
             exception_html=exception_html,
-            try_number=self.try_number,
+            try_number=self.try_number - 1,
             max_tries=self.max_tries))
 
         jinja_env = self.task.get_template_env()
diff --git a/tests/models.py b/tests/models.py
index fcabd97f3e51c..8ca41a9e06c30 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -2854,6 +2854,7 @@ def test_email_alert(self, mock_send_email):
         self.assertEqual(email, 'to')
         self.assertIn('test_email_alert', title)
         self.assertIn('test_email_alert', body)
+        self.assertIn('Try 1', body)
 
     @patch('airflow.models.send_email')
     def test_email_alert_with_config(self, mock_send_email):

From ce23f16452eafedf4a3112beb77155089078c6cf Mon Sep 17 00:00:00 2001
From: Newton Le <newtonle@gmail.com>
Date: Thu, 13 Sep 2018 17:59:27 -0700
Subject: [PATCH 597/808] [AIRFLOW-3060] DAG context manager fails to exit
 properly in certain circumstances

---
 airflow/models.py | 9 +++++++--
 tests/models.py   | 9 +++++++++
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index bbeb026e86676..16bcd9943448d 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -3442,6 +3442,8 @@ def __init__(
         self.on_success_callback = on_success_callback
         self.on_failure_callback = on_failure_callback
 
+        self._context_manager_set = False
+
         self._comps = {
             'dag_id',
             'task_ids',
@@ -3490,13 +3492,16 @@ def __hash__(self):
 
     def __enter__(self):
         global _CONTEXT_MANAGER_DAG
-        self._old_context_manager_dag = _CONTEXT_MANAGER_DAG
-        _CONTEXT_MANAGER_DAG = self
+        if not self._context_manager_set:
+            self._old_context_manager_dag = _CONTEXT_MANAGER_DAG
+            _CONTEXT_MANAGER_DAG = self
+            self._context_manager_set = True
         return self
 
     def __exit__(self, _type, _value, _tb):
         global _CONTEXT_MANAGER_DAG
         _CONTEXT_MANAGER_DAG = self._old_context_manager_dag
+        self._context_manager_set = False
 
     # /Context Manager ----------------------------------------------
 
diff --git a/tests/models.py b/tests/models.py
index 8ca41a9e06c30..e4f9b1f61e8eb 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -147,6 +147,15 @@ def test_dag_as_context_manager(self):
         self.assertEqual(dag.dag_id, 'creating_dag_in_cm')
         self.assertEqual(dag.tasks[0].task_id, 'op6')
 
+        with dag:
+            with dag:
+                op7 = DummyOperator(task_id='op7')
+        op8 = DummyOperator(task_id='op8')
+        op8.dag = dag2
+
+        self.assertEqual(op7.dag, dag)
+        self.assertEqual(op8.dag, dag2)
+
     def test_dag_topological_sort(self):
         dag = DAG(
             'dag',

From be5df5c6ff31038e7f25de07b409a65ce616eeff Mon Sep 17 00:00:00 2001
From: Newton Le <newtonle@gmail.com>
Date: Fri, 28 Sep 2018 09:51:34 -0700
Subject: [PATCH 598/808] [AIRFLOW-3123] Use a stack for DAG context management
 (#3956)

---
 airflow/models.py | 11 ++++-------
 tests/models.py   |  8 +++++---
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index 16bcd9943448d..ab78abad85848 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -3442,7 +3442,7 @@ def __init__(
         self.on_success_callback = on_success_callback
         self.on_failure_callback = on_failure_callback
 
-        self._context_manager_set = False
+        self._old_context_manager_dags = []
 
         self._comps = {
             'dag_id',
@@ -3492,16 +3492,13 @@ def __hash__(self):
 
     def __enter__(self):
         global _CONTEXT_MANAGER_DAG
-        if not self._context_manager_set:
-            self._old_context_manager_dag = _CONTEXT_MANAGER_DAG
-            _CONTEXT_MANAGER_DAG = self
-            self._context_manager_set = True
+        self._old_context_manager_dags.append(_CONTEXT_MANAGER_DAG)
+        _CONTEXT_MANAGER_DAG = self
         return self
 
     def __exit__(self, _type, _value, _tb):
         global _CONTEXT_MANAGER_DAG
-        _CONTEXT_MANAGER_DAG = self._old_context_manager_dag
-        self._context_manager_set = False
+        _CONTEXT_MANAGER_DAG = self._old_context_manager_dags.pop()
 
     # /Context Manager ----------------------------------------------
 
diff --git a/tests/models.py b/tests/models.py
index e4f9b1f61e8eb..45c5183d5b2b8 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -150,11 +150,13 @@ def test_dag_as_context_manager(self):
         with dag:
             with dag:
                 op7 = DummyOperator(task_id='op7')
-        op8 = DummyOperator(task_id='op8')
-        op8.dag = dag2
+            op8 = DummyOperator(task_id='op8')
+        op9 = DummyOperator(task_id='op8')
+        op9.dag = dag2
 
         self.assertEqual(op7.dag, dag)
-        self.assertEqual(op8.dag, dag2)
+        self.assertEqual(op8.dag, dag)
+        self.assertEqual(op9.dag, dag2)
 
     def test_dag_topological_sort(self):
         dag = DAG(

From 7e695d5d00ca647010b3d37bbb6ae6bf2a036ccb Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 15 Mar 2019 15:16:39 +0000
Subject: [PATCH 599/808] [AIRFLOW-4045] Fix hard-coded URLs in FAB-based UI
 (#4914)

---
 airflow/www_rbac/blueprints.py                |  4 ++--
 airflow/www_rbac/static_config.py             |  7 ++++++-
 .../templates/airflow/dag_details.html        |  2 +-
 .../templates/appbuilder/navbar_menu.html     |  2 +-
 airflow/www_rbac/views.py                     | 20 +++++++++----------
 tests/www_rbac/test_views.py                  |  7 ++++++-
 6 files changed, 26 insertions(+), 16 deletions(-)

diff --git a/airflow/www_rbac/blueprints.py b/airflow/www_rbac/blueprints.py
index dfa29f19caa38..36c365b185ad6 100644
--- a/airflow/www_rbac/blueprints.py
+++ b/airflow/www_rbac/blueprints.py
@@ -17,11 +17,11 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-from flask import Blueprint, redirect
+from flask import Blueprint, redirect, url_for
 
 routes = Blueprint('routes', __name__)
 
 
 @routes.route('/')
 def index():
-    return redirect('/home')
+    return redirect(url_for('Airflow.index'))
diff --git a/airflow/www_rbac/static_config.py b/airflow/www_rbac/static_config.py
index 278c499eee5e1..53b357c7b5da2 100644
--- a/airflow/www_rbac/static_config.py
+++ b/airflow/www_rbac/static_config.py
@@ -21,6 +21,8 @@
 import json
 import os
 
+from flask import url_for
+
 manifest = dict()
 
 
@@ -39,6 +41,9 @@ def parse_manifest_json():
                                          'static/dist/manifest.json')
             with open(manifest_file, 'r') as f:
                 manifest.update(json.load(f))
+
+                for k in manifest.keys():
+                    manifest[k] = os.path.join("dist", manifest[k])
         except Exception:
             print("Please make sure to build the frontend in "
                   "static/ directory and restart the server")
@@ -47,7 +52,7 @@ def parse_manifest_json():
     def get_asset_url(filename):
         if app.debug:
             parse_manifest_json()
-        return '/static/dist/{}'.format(manifest.get(filename, ''))
+        return url_for('static', filename=manifest.get(filename, ''))
 
     parse_manifest_json()
 
diff --git a/airflow/www_rbac/templates/airflow/dag_details.html b/airflow/www_rbac/templates/airflow/dag_details.html
index dfd28bc1f89ad..2ef49ff16b760 100644
--- a/airflow/www_rbac/templates/airflow/dag_details.html
+++ b/airflow/www_rbac/templates/airflow/dag_details.html
@@ -29,7 +29,7 @@ <h2>{{ title }}</h2>
       <a
           class="btn"
           style="border: none; background-color:{{ State.color(state)}}; color: {{ State.color_fg(state) }};"
-          href="/taskinstance/list/?_flt_3_dag_id={{ dag.dag_id }}&_flt_3_state={{ state }}">
+          href="{{ url_for('TaskInstanceModelView.list', _flt_3_dag_id=dag.dag_id, _flt_3_state=state) }}">
         {{ state }} <span class="badge">{{ count }}</span>
       </a>
       {% endfor %}
diff --git a/airflow/www_rbac/templates/appbuilder/navbar_menu.html b/airflow/www_rbac/templates/appbuilder/navbar_menu.html
index 5661e894762b3..9cf3f94f4094e 100644
--- a/airflow/www_rbac/templates/appbuilder/navbar_menu.html
+++ b/airflow/www_rbac/templates/appbuilder/navbar_menu.html
@@ -23,7 +23,7 @@
     {{_(item.label)}}</a>
 {% endmacro %}
 
-<li class="dropdown"><a href="/">DAGs</a></li>
+<li class="dropdown"><a href="{{ url_for('Airflow.index') }}">DAGs</a></li>
 
 {% for item1 in menu.get_list() %}
     {% if item1 | is_menu_visible %}
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 3be5181cfbc35..8fd38179c78c2 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -637,7 +637,7 @@ def task(self):
                 "Task [{}.{}] doesn't seem to exist"
                 " at the moment".format(dag_id, task_id),
                 "error")
-            return redirect('/')
+            return redirect(url_for('Airflow.index'))
         task = copy.copy(dag.get_task(task_id))
         task.resolve_template_files()
         ti = TI(task=task, execution_date=dttm)
@@ -713,7 +713,7 @@ def xcom(self, session=None):
                 "Task [{}.{}] doesn't seem to exist"
                 " at the moment".format(dag_id, task_id),
                 "error")
-            return redirect('/')
+            return redirect(url_for('Airflow.index'))
 
         xcomlist = session.query(XCom).filter(
             XCom.dag_id == dag_id, XCom.task_id == task_id,
@@ -810,7 +810,7 @@ def delete(self):
         from airflow.exceptions import DagNotFound, DagFileExists
 
         dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin') or "/"
+        origin = request.args.get('origin') or url_for('Airflow.index')
 
         try:
             delete_dag.delete_dag(dag_id)
@@ -1153,7 +1153,7 @@ def tree(self, session=None):
         dag = dagbag.get_dag(dag_id)
         if dag_id not in dagbag.dags:
             flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
-            return redirect('/')
+            return redirect(url_for('Airflow.index'))
 
         root = request.args.get('root')
         if root:
@@ -1283,7 +1283,7 @@ def graph(self, session=None):
         dag = dagbag.get_dag(dag_id)
         if dag_id not in dagbag.dags:
             flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
-            return redirect('/')
+            return redirect(url_for('Airflow.index'))
 
         root = request.args.get('root')
         if root:
@@ -1387,7 +1387,7 @@ def duration(self, session=None):
 
         if dag is None:
             flash('DAG "{0}" seems to be missing.'.format(dag_id), "error")
-            return redirect('/')
+            return redirect(url_for('Airflow.index'))
 
         if base_date:
             base_date = pendulum.parse(base_date)
@@ -1683,7 +1683,7 @@ def refresh_all(self):
         # sync permissions for all dags
         appbuilder.sm.sync_perm_for_dag()
         flash("All DAGs are now up to date")
-        return redirect('/')
+        return redirect(url_for('Airflow.index'))
 
     @expose('/gantt')
     @has_dag_access(can_dag_read=True)
@@ -2210,7 +2210,7 @@ def action_set_running(self, drs, session=None):
         except Exception as ex:
             flash(str(ex), 'error')
             flash('Failed to set state', 'error')
-        return redirect(self.route_base + '/list')
+        return redirect(self.get_default_url())
 
     @action('set_failed', "Set state to 'failed'",
             "All running task instances would also be marked as failed, are you sure?",
@@ -2238,7 +2238,7 @@ def action_set_failed(self, drs, session=None):
                 "were set to failed".format(**locals()))
         except Exception:
             flash('Failed to set state', 'error')
-        return redirect(self.route_base + '/list')
+        return redirect(self.get_default_url())
 
     @action('set_success', "Set state to 'success'",
             "All task instances would also be marked as success, are you sure?",
@@ -2266,7 +2266,7 @@ def action_set_success(self, drs, session=None):
                 "were set to success".format(**locals()))
         except Exception:
             flash('Failed to set state', 'error')
-        return redirect(self.route_base + '/list')
+        return redirect(self.get_default_url())
 
 
 class LogModelView(AirflowModelView):
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 2d4e83de55ba2..c569accacaaa9 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -268,7 +268,7 @@ def setUpClass(cls):
         application.app = None
         application.appbuilder = None
         conf.load_test_config()
-        conf.set("webserver", "base_url", "http://localhost:8080/test")
+        conf.set("webserver", "base_url", "http://localhost/test")
         app = application.cached_app(config={'WTF_CSRF_ENABLED': False}, session=Session, testing=True)
         cls.client = Client(app, BaseResponse)
 
@@ -287,6 +287,11 @@ def test_not_found(self):
         resp = self.client.get('/', follow_redirects=True)
         self.assertEqual(resp.status_code, 404)
 
+    def test_index(self):
+        resp = self.client.get('/test/')
+        self.assertEqual(resp.status_code, 302)
+        self.assertEqual(resp.headers['Location'], 'http://localhost/test/home')
+
 
 class TestAirflowBaseViews(TestBase):
     EXAMPLE_DAG_DEFAULT_DATE = dates.days_ago(2)

From 73280e489c8a766264f2dd9225c3c899f31be758 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 15 Mar 2019 17:46:53 +0000
Subject: [PATCH 600/808] [AIRFLOW-3768] Escape search parameter in pagination
 controls (#4911)

The "minidom" we were using from lxml didn't cope with the &gt; etc
entities (because it is an XML parser, not an HTML parser): rather than
special casing each one I have instead swapped out lxml-based parser for
BeautifulSoup which 1) handles these, and 2) is pure-python so is easier
to install :)
---
 airflow/www/utils.py         | 45 +++++++++------------
 airflow/www_rbac/utils.py    | 45 +++++++++------------
 setup.py                     |  2 +-
 tests/core.py                | 21 ++++------
 tests/www/test_utils.py      | 78 ++++++++++++++++++++++++------------
 tests/www_rbac/test_utils.py | 78 ++++++++++++++++++++++++------------
 6 files changed, 153 insertions(+), 116 deletions(-)

diff --git a/airflow/www/utils.py b/airflow/www/utils.py
index 757d2268bf4f5..b15c515882bfb 100644
--- a/airflow/www/utils.py
+++ b/airflow/www/utils.py
@@ -36,10 +36,11 @@
 from wtforms.compat import text_type
 import zipfile
 
-from flask import after_this_request, request, Response
+from flask import after_this_request, request, Markup, Response
 from flask_admin.model import filters
 import flask_admin.contrib.sqla.filters as sqlafilters
 from flask_login import current_user
+from six.moves.urllib.parse import urlencode
 
 from airflow import configuration, models, settings
 from airflow.utils.db import create_session
@@ -96,17 +97,11 @@ def is_accessible(self):
 
 
 def get_params(**kwargs):
-    params = []
-    for k, v in kwargs.items():
-        if k == 'showPaused':
-            # True is default or None
-            if v or v is None:
-                continue
-            params.append('{}={}'.format(k, v))
-        elif v:
-            params.append('{}={}'.format(k, v))
-    params = sorted(params, key=lambda x: x.split('=')[0])
-    return '&'.join(params)
+    if 'showPaused' in kwargs:
+        v = kwargs['showPaused']
+        if v or v is None:
+            kwargs.pop('showPaused')
+    return urlencode({d: v if v is not None else '' for d, v in kwargs.items()})
 
 
 def generate_pages(current_page, num_of_pages,
@@ -137,27 +132,27 @@ def generate_pages(current_page, num_of_pages,
     """
 
     void_link = 'javascript:void(0)'
-    first_node = """<li class="paginate_button {disabled}" id="dags_first">
+    first_node = Markup("""<li class="paginate_button {disabled}" id="dags_first">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="0" tabindex="0">&laquo;</a>
-</li>"""
+</li>""")
 
-    previous_node = """<li class="paginate_button previous {disabled}" id="dags_previous">
+    previous_node = Markup("""<li class="paginate_button previous {disabled}" id="dags_previous">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="0" tabindex="0">&lt;</a>
-</li>"""
+</li>""")
 
-    next_node = """<li class="paginate_button next {disabled}" id="dags_next">
+    next_node = Markup("""<li class="paginate_button next {disabled}" id="dags_next">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="3" tabindex="0">&gt;</a>
-</li>"""
+</li>""")
 
-    last_node = """<li class="paginate_button {disabled}" id="dags_last">
+    last_node = Markup("""<li class="paginate_button {disabled}" id="dags_last">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="3" tabindex="0">&raquo;</a>
-</li>"""
+</li>""")
 
-    page_node = """<li class="paginate_button {is_active}">
+    page_node = Markup("""<li class="paginate_button {is_active}">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="2" tabindex="0">{page_num}</a>
-</li>"""
+</li>""")
 
-    output = ['<ul class="pagination" style="margin-top:0px;">']
+    output = [Markup('<ul class="pagination" style="margin-top:0px;">')]
 
     is_disabled = 'disabled' if current_page <= 0 else ''
     output.append(first_node.format(href_link="?{}"
@@ -213,9 +208,9 @@ def is_current(current, page):
                                                       showPaused=showPaused)),
                                    disabled=is_disabled))
 
-    output.append('</ul>')
+    output.append(Markup('</ul>'))
 
-    return wtforms.widgets.core.HTMLString('\n'.join(output))
+    return Markup('\n'.join(output))
 
 
 def limit_sql(sql, limit, conn_type):
diff --git a/airflow/www_rbac/utils.py b/airflow/www_rbac/utils.py
index dbed4001dc4a9..23a07f923b1aa 100644
--- a/airflow/www_rbac/utils.py
+++ b/airflow/www_rbac/utils.py
@@ -23,7 +23,6 @@
 import inspect
 import json
 import time
-import wtforms
 import markdown
 import re
 import zipfile
@@ -39,6 +38,8 @@
 from flask_appbuilder.models.sqla.interface import SQLAInterface
 import flask_appbuilder.models.sqla.filters as fab_sqlafilters
 import sqlalchemy as sqla
+from six.moves.urllib.parse import urlencode
+
 from airflow import configuration
 from airflow.models import BaseOperator
 from airflow.operators.subdag_operator import SubDagOperator
@@ -70,17 +71,11 @@ def should_hide_value_for_key(key_name):
 
 
 def get_params(**kwargs):
-    params = []
-    for k, v in kwargs.items():
-        if k == 'showPaused':
-            # True is default or None
-            if v or v is None:
-                continue
-            params.append('{}={}'.format(k, v))
-        elif v:
-            params.append('{}={}'.format(k, v))
-    params = sorted(params, key=lambda x: x.split('=')[0])
-    return '&'.join(params)
+    if 'showPaused' in kwargs:
+        v = kwargs['showPaused']
+        if v or v is None:
+            kwargs.pop('showPaused')
+    return urlencode({d: v if v is not None else '' for d, v in kwargs.items()})
 
 
 def generate_pages(current_page, num_of_pages,
@@ -111,27 +106,27 @@ def generate_pages(current_page, num_of_pages,
     """
 
     void_link = 'javascript:void(0)'
-    first_node = """<li class="paginate_button {disabled}" id="dags_first">
+    first_node = Markup("""<li class="paginate_button {disabled}" id="dags_first">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="0" tabindex="0">&laquo;</a>
-</li>"""
+</li>""")
 
-    previous_node = """<li class="paginate_button previous {disabled}" id="dags_previous">
+    previous_node = Markup("""<li class="paginate_button previous {disabled}" id="dags_previous">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="0" tabindex="0">&lt;</a>
-</li>"""
+</li>""")
 
-    next_node = """<li class="paginate_button next {disabled}" id="dags_next">
+    next_node = Markup("""<li class="paginate_button next {disabled}" id="dags_next">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="3" tabindex="0">&gt;</a>
-</li>"""
+</li>""")
 
-    last_node = """<li class="paginate_button {disabled}" id="dags_last">
+    last_node = Markup("""<li class="paginate_button {disabled}" id="dags_last">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="3" tabindex="0">&raquo;</a>
-</li>"""
+</li>""")
 
-    page_node = """<li class="paginate_button {is_active}">
+    page_node = Markup("""<li class="paginate_button {is_active}">
     <a href="{href_link}" aria-controls="dags" data-dt-idx="2" tabindex="0">{page_num}</a>
-</li>"""
+</li>""")
 
-    output = ['<ul class="pagination" style="margin-top:0px;">']
+    output = [Markup('<ul class="pagination" style="margin-top:0px;">')]
 
     is_disabled = 'disabled' if current_page <= 0 else ''
     output.append(first_node.format(href_link="?{}"
@@ -187,9 +182,9 @@ def is_current(current, page):
                                                       showPaused=showPaused)),
                                    disabled=is_disabled))
 
-    output.append('</ul>')
+    output.append(Markup('</ul>'))
 
-    return wtforms.widgets.core.HTMLString('\n'.join(output))
+    return Markup('\n'.join(output))
 
 
 def epoch(dttm):
diff --git a/setup.py b/setup.py
index 547168ce4b847..4352dac78f622 100644
--- a/setup.py
+++ b/setup.py
@@ -231,10 +231,10 @@ def write_version(filename=os.path.join(*['airflow',
     + cassandra + mongo
 
 devel = [
+    'beautifulsoup4~=4.7.1',
     'click==6.7',
     'freezegun',
     'jira',
-    'lxml>=4.0.0',
     'mock',
     'mongomock',
     'moto==1.3.5',
diff --git a/tests/core.py b/tests/core.py
index e98d3cfb13dad..625eca9adea0a 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -41,6 +41,8 @@
 from six.moves.urllib.parse import urlencode
 from time import sleep
 
+from bs4 import BeautifulSoup
+
 from airflow import configuration
 from airflow.executors import SequentialExecutor
 from airflow.models import Variable, TaskInstance
@@ -63,7 +65,6 @@
 from airflow.utils.timezone import datetime
 from airflow.utils.state import State
 from airflow.utils.dates import days_ago, infer_time_unit, round_time, scale_time_units
-from lxml import html
 from airflow.exceptions import AirflowException
 from airflow.configuration import AirflowConfigException, run_command
 from jinja2.sandbox import SecurityError
@@ -1796,10 +1797,8 @@ def setUp(self):
         self.runme_0 = self.dag_bash.get_task('runme_0')
 
     def get_csrf(self, response):
-        tree = html.fromstring(response.data)
-        form = tree.find('.//form')
-
-        return form.find('.//input[@name="_csrf_token"]').value
+        tree = BeautifulSoup(response.data, 'html.parser')
+        return tree.find('input', attrs={'name': '_csrf_token'})['value']
 
     def test_csrf_rejection(self):
         endpoints = ([
@@ -2288,10 +2287,8 @@ def setUp(self):
         session.close()
 
     def get_csrf(self, response):
-        tree = html.fromstring(response.data)
-        form = tree.find('.//form')
-
-        return form.find('.//input[@name="_csrf_token"]').value
+        tree = BeautifulSoup(response.data, 'html.parser')
+        return tree.find('input', attrs={'name': '_csrf_token'})['value']
 
     def login(self, username, password):
         response = self.app.get('/admin/airflow/login')
@@ -2355,10 +2352,8 @@ def setUp(self):
         self.app = app.test_client()
 
     def get_csrf(self, response):
-        tree = html.fromstring(response.data)
-        form = tree.find('.//form')
-
-        return form.find('.//input[@name="_csrf_token"]').value
+        tree = BeautifulSoup(response.data, 'html.parser')
+        return tree.find('input', attrs={'name': '_csrf_token'})['value']
 
     def login(self, username, password):
         response = self.app.get('/admin/airflow/login')
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index a824e58b09c31..771847e5b9f26 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -18,14 +18,22 @@
 # under the License.
 
 import functools
+
+from bs4 import BeautifulSoup
 import mock
-import unittest
-from xml.dom import minidom
+import six
+from six.moves.urllib.parse import parse_qs
 
 from airflow.www import app as application
 
 from airflow.www import utils
 
+if six.PY2:
+    # Need `assertRegex` back-ported from unittest2
+    import unittest2 as unittest
+else:
+    import unittest
+
 
 class UtilsTest(unittest.TestCase):
 
@@ -48,39 +56,43 @@ def test_sensitive_variable_should_be_hidden_ic(self):
     def check_generate_pages_html(self, current_page, total_pages,
                                   window=7, check_middle=False):
         extra_links = 4  # first, prev, next, last
-        html_str = utils.generate_pages(current_page, total_pages)
+        search = "'>\"/><img src=x onerror=alert(1)>"
+        html_str = utils.generate_pages(current_page, total_pages,
+                                        search=search)
+
+        self.assertNotIn(search, html_str,
+                         "The raw search string shouldn't appear in the output")
+        self.assertIn('search=%27%3E%22%2F%3E%3Cimg+src%3Dx+onerror%3Dalert%281%29%3E',
+                      html_str)
 
-        # dom parser has issues with special &laquo; and &raquo;
-        html_str = html_str.replace('&laquo;', '')
-        html_str = html_str.replace('&raquo;', '')
-        dom = minidom.parseString(html_str)
+        self.assertTrue(
+            callable(html_str.__html__),
+            "Should return something that is HTML-escaping aware"
+        )
+
+        dom = BeautifulSoup(html_str, 'html.parser')
         self.assertIsNotNone(dom)
 
-        ulist = dom.getElementsByTagName('ul')[0]
-        ulist_items = ulist.getElementsByTagName('li')
+        ulist = dom.ul
+        ulist_items = ulist.find_all('li')
         self.assertEqual(min(window, total_pages) + extra_links, len(ulist_items))
 
-        def get_text(nodelist):
-            rc = []
-            for node in nodelist:
-                if node.nodeType == node.TEXT_NODE:
-                    rc.append(node.data)
-            return ''.join(rc)
-
         page_items = ulist_items[2:-2]
         mid = int(len(page_items) / 2)
         for i, item in enumerate(page_items):
-            a_node = item.getElementsByTagName('a')[0]
-            href_link = a_node.getAttribute('href')
-            node_text = get_text(a_node.childNodes)
+            a_node = item.a
+            href_link = a_node['href']
+            node_text = a_node.string
             if node_text == str(current_page + 1):
                 if check_middle:
                     self.assertEqual(mid, i)
-                self.assertEqual('javascript:void(0)', a_node.getAttribute('href'))
-                self.assertIn('active', item.getAttribute('class'))
+                self.assertEqual('javascript:void(0)', href_link)
+                self.assertIn('active', item['class'])
             else:
-                link_str = '?page=' + str(int(node_text) - 1)
-                self.assertEqual(link_str, href_link)
+                self.assertRegex(href_link, r'^\?', 'Link is page-relative')
+                query = parse_qs(href_link[1:])
+                self.assertListEqual(query['page'], [str(int(node_text) - 1)])
+                self.assertListEqual(query['search'], [search])
 
     def test_generate_pager_current_start(self):
         self.check_generate_pages_html(current_page=0,
@@ -112,10 +124,24 @@ def test_params_showPaused_false(self):
         self.assertEqual('showPaused=False',
                          utils.get_params(showPaused=False))
 
+    def test_params_none_and_zero(self):
+        qs = utils.get_params(a=0, b=None)
+        # The order won't be consistent, but that doesn't affect behaviour of a browser
+        pairs = list(sorted(qs.split('&')))
+        self.assertListEqual(['a=0', 'b='], pairs)
+
     def test_params_all(self):
-        """Should return params string ordered by param key"""
-        self.assertEqual('page=3&search=bash_&showPaused=False',
-                         utils.get_params(showPaused=False, page=3, search='bash_'))
+        query = utils.get_params(showPaused=False, page=3, search='bash_')
+        self.assertEqual(
+            {'page': ['3'],
+             'search': ['bash_'],
+             'showPaused': ['False']},
+            parse_qs(query)
+        )
+
+    def test_params_escape(self):
+        self.assertEqual('search=%27%3E%22%2F%3E%3Cimg+src%3Dx+onerror%3Dalert%281%29%3E',
+                         utils.get_params(search="'>\"/><img src=x onerror=alert(1)>"))
 
     # flask_login is loaded by calling flask_login.utils._get_user.
     @mock.patch("flask_login.utils._get_user")
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index b0122be4dafed..44bac6b74a965 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -18,12 +18,20 @@
 # under the License.
 
 from datetime import datetime
-import unittest
+
+from bs4 import BeautifulSoup
 import mock
-from xml.dom import minidom
+import six
+from six.moves.urllib.parse import parse_qs
 
 from airflow.www_rbac import utils
 
+if six.PY2:
+    # Need `assertRegex` back-ported from unittest2
+    import unittest2 as unittest
+else:
+    import unittest
+
 
 class UtilsTest(unittest.TestCase):
     def test_empty_variable_should_not_be_hidden(self):
@@ -42,39 +50,43 @@ def test_sensitive_variable_should_be_hidden_ic(self):
     def check_generate_pages_html(self, current_page, total_pages,
                                   window=7, check_middle=False):
         extra_links = 4  # first, prev, next, last
-        html_str = utils.generate_pages(current_page, total_pages)
+        search = "'>\"/><img src=x onerror=alert(1)>"
+        html_str = utils.generate_pages(current_page, total_pages,
+                                        search=search)
+
+        self.assertNotIn(search, html_str,
+                         "The raw search string shouldn't appear in the output")
+        self.assertIn('search=%27%3E%22%2F%3E%3Cimg+src%3Dx+onerror%3Dalert%281%29%3E',
+                      html_str)
+
+        self.assertTrue(
+            callable(html_str.__html__),
+            "Should return something that is HTML-escaping aware"
+        )
 
-        # dom parser has issues with special &laquo; and &raquo;
-        html_str = html_str.replace('&laquo;', '')
-        html_str = html_str.replace('&raquo;', '')
-        dom = minidom.parseString(html_str)
+        dom = BeautifulSoup(html_str, 'html.parser')
         self.assertIsNotNone(dom)
 
-        ulist = dom.getElementsByTagName('ul')[0]
-        ulist_items = ulist.getElementsByTagName('li')
+        ulist = dom.ul
+        ulist_items = ulist.find_all('li')
         self.assertEqual(min(window, total_pages) + extra_links, len(ulist_items))
 
-        def get_text(nodelist):
-            rc = []
-            for node in nodelist:
-                if node.nodeType == node.TEXT_NODE:
-                    rc.append(node.data)
-            return ''.join(rc)
-
         page_items = ulist_items[2:-2]
         mid = int(len(page_items) / 2)
         for i, item in enumerate(page_items):
-            a_node = item.getElementsByTagName('a')[0]
-            href_link = a_node.getAttribute('href')
-            node_text = get_text(a_node.childNodes)
+            a_node = item.a
+            href_link = a_node['href']
+            node_text = a_node.string
             if node_text == str(current_page + 1):
                 if check_middle:
                     self.assertEqual(mid, i)
-                self.assertEqual('javascript:void(0)', a_node.getAttribute('href'))
-                self.assertIn('active', item.getAttribute('class'))
+                self.assertEqual('javascript:void(0)', href_link)
+                self.assertIn('active', item['class'])
             else:
-                link_str = '?page=' + str(int(node_text) - 1)
-                self.assertEqual(link_str, href_link)
+                self.assertRegex(href_link, r'^\?', 'Link is page-relative')
+                query = parse_qs(href_link[1:])
+                self.assertListEqual(query['page'], [str(int(node_text) - 1)])
+                self.assertListEqual(query['search'], [search])
 
     def test_generate_pager_current_start(self):
         self.check_generate_pages_html(current_page=0,
@@ -106,10 +118,24 @@ def test_params_showPaused_false(self):
         self.assertEqual('showPaused=False',
                          utils.get_params(showPaused=False))
 
+    def test_params_none_and_zero(self):
+        qs = utils.get_params(a=0, b=None)
+        # The order won't be consistent, but that doesn't affect behaviour of a browser
+        pairs = list(sorted(qs.split('&')))
+        self.assertListEqual(['a=0', 'b='], pairs)
+
     def test_params_all(self):
-        """Should return params string ordered by param key"""
-        self.assertEqual('page=3&search=bash_&showPaused=False',
-                         utils.get_params(showPaused=False, page=3, search='bash_'))
+        query = utils.get_params(showPaused=False, page=3, search='bash_')
+        self.assertEqual(
+            {'page': ['3'],
+             'search': ['bash_'],
+             'showPaused': ['False']},
+            parse_qs(query)
+        )
+
+    def test_params_escape(self):
+        self.assertEqual('search=%27%3E%22%2F%3E%3Cimg+src%3Dx+onerror%3Dalert%281%29%3E',
+                         utils.get_params(search="'>\"/><img src=x onerror=alert(1)>"))
 
     def test_open_maybe_zipped_normal_file(self):
         with mock.patch(

From bb388ec5812561ea2604943c343333f75ab12a41 Mon Sep 17 00:00:00 2001
From: Vincent Ketelaars <vincentketelaars@gmail.com>
Date: Tue, 13 Nov 2018 14:26:03 +0800
Subject: [PATCH 601/808] [AIRFLOW-XXX] Correct schedule_interval in Scheduler
 docs (#4157)

---
 docs/scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 8c7d435b32440..25e14cb4a387f 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -130,7 +130,7 @@ interval series.
         'email_on_retry': False,
         'retries': 1,
         'retry_delay': timedelta(minutes=5),
-        'schedule_interval': '@hourly',
+        'schedule_interval': '@daily',
     }
 
     dag = DAG('tutorial', catchup=False, default_args=default_args)

From 3c2a2e2183c10a214eb7b15c13537cffff734b80 Mon Sep 17 00:00:00 2001
From: "Y.Yaswanth Raj Kumar" <yaswanthraj671@gmail.com>
Date: Sat, 16 Mar 2019 07:40:21 +0530
Subject: [PATCH 602/808] [AIRFLOW-4095] Add template_fields for
 S3CopyObjectOperator & S3DeleteObjectsOperator (#4920)

---
 airflow/contrib/operators/s3_copy_object_operator.py  | 11 +++++++----
 .../contrib/operators/s3_delete_objects_operator.py   |  6 ++++--
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/operators/s3_copy_object_operator.py b/airflow/contrib/operators/s3_copy_object_operator.py
index 330138ed27594..43651707f8925 100644
--- a/airflow/contrib/operators/s3_copy_object_operator.py
+++ b/airflow/contrib/operators/s3_copy_object_operator.py
@@ -29,21 +29,21 @@ class S3CopyObjectOperator(BaseOperator):
     Note: the S3 connection used here needs to have access to both
     source and destination bucket/key.
 
-    :param source_bucket_key: The key of the source object.
+    :param source_bucket_key: The key of the source object. (templated)
 
         It can be either full s3:// style url or relative path from root level.
 
         When it's specified as a full s3:// url, please omit source_bucket_name.
     :type source_bucket_key: str
-    :param dest_bucket_key: The key of the object to copy to.
+    :param dest_bucket_key: The key of the object to copy to. (templated)
 
         The convention to specify `dest_bucket_key` is the same as `source_bucket_key`.
     :type dest_bucket_key: str
-    :param source_bucket_name: Name of the S3 bucket where the source object is in.
+    :param source_bucket_name: Name of the S3 bucket where the source object is in. (templated)
 
         It should be omitted when `source_bucket_key` is provided as a full s3:// url.
     :type source_bucket_name: str
-    :param dest_bucket_name: Name of the S3 bucket to where the object is copied.
+    :param dest_bucket_name: Name of the S3 bucket to where the object is copied. (templated)
 
         It should be omitted when `dest_bucket_key` is provided as a full s3:// url.
     :type dest_bucket_name: str
@@ -65,6 +65,9 @@ class S3CopyObjectOperator(BaseOperator):
     :type verify: bool or str
     """
 
+    template_fields = ('source_bucket_key', 'dest_bucket_key',
+                       'source_bucket_name', 'dest_bucket_name')
+
     @apply_defaults
     def __init__(
             self,
diff --git a/airflow/contrib/operators/s3_delete_objects_operator.py b/airflow/contrib/operators/s3_delete_objects_operator.py
index 1aa1b3901e83f..0471693cd093c 100644
--- a/airflow/contrib/operators/s3_delete_objects_operator.py
+++ b/airflow/contrib/operators/s3_delete_objects_operator.py
@@ -30,9 +30,9 @@ class S3DeleteObjectsOperator(BaseOperator):
 
     Users may specify up to 1000 keys to delete.
 
-    :param bucket: Name of the bucket in which you are going to delete object(s)
+    :param bucket: Name of the bucket in which you are going to delete object(s). (templated)
     :type bucket: str
-    :param keys: The key(s) to delete from S3 bucket.
+    :param keys: The key(s) to delete from S3 bucket. (templated)
 
         When ``keys`` is a string, it's supposed to be the key name of
         the single object to delete.
@@ -58,6 +58,8 @@ class S3DeleteObjectsOperator(BaseOperator):
     :type verify: bool or str
     """
 
+    template_fields = ('keys', 'bucket')
+
     @apply_defaults
     def __init__(
             self,

From 6d64b165ec5197ebab45835d8844cecadda752c1 Mon Sep 17 00:00:00 2001
From: Anthony Brown <anthony@found-it.net>
Date: Wed, 27 Feb 2019 13:28:19 +0000
Subject: [PATCH 603/808] [AIRFLOW-3931] set network, subnetwork when launching
 dataflow template (#4744)

---
 airflow/contrib/hooks/gcp_dataflow_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index c7a51e092db11..94142b2e7da4e 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -272,7 +272,7 @@ def _start_template_dataflow(self, name, variables, parameters,
         # https://cloud.google.com/dataflow/docs/reference/rest/v1b3/RuntimeEnvironment
         environment = {}
         for key in ['maxWorkers', 'zone', 'serviceAccountEmail', 'tempLocation',
-                    'bypassTempDirValidation', 'machineType']:
+                    'bypassTempDirValidation', 'machineType', 'network', 'subnetwork']:
             if key in variables:
                 environment.update({key: variables[key]})
         body = {"jobName": name,

From a06baa12298bd556c9d131f84a418627c3732395 Mon Sep 17 00:00:00 2001
From: Junda Yang <youngyjd@gmail.com>
Date: Thu, 14 Mar 2019 16:34:25 -0700
Subject: [PATCH 604/808] [AIRFLOW-4087] remove sudo in basetaskrunner
 on_finish (#4916)

---
 airflow/task/task_runner/base_task_runner.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/airflow/task/task_runner/base_task_runner.py b/airflow/task/task_runner/base_task_runner.py
index d2bf172bd435c..4a62cab941e61 100644
--- a/airflow/task/task_runner/base_task_runner.py
+++ b/airflow/task/task_runner/base_task_runner.py
@@ -162,4 +162,7 @@ def on_finish(self):
         A callback that should be called when this is done running.
         """
         if self._cfg_path and os.path.isfile(self._cfg_path):
-            subprocess.call(['sudo', 'rm', self._cfg_path], close_fds=True)
+            if self.run_as_user:
+                subprocess.call(['sudo', 'rm', self._cfg_path], close_fds=True)
+            else:
+                os.remove(self._cfg_path)

From 8eb114ed2612685e4d8808984700d03e08856774 Mon Sep 17 00:00:00 2001
From: marengaz <marengaz@users.noreply.github.com>
Date: Sat, 9 Mar 2019 17:23:22 +0000
Subject: [PATCH 605/808] [AIRFLOW-XXX] Add Hint at user defined macros (#4885)

---
 docs/code.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/code.rst b/docs/code.rst
index d86ffba4cba13..f489d2e8cfbf0 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -317,8 +317,10 @@ Sensors
 
 Macros
 ------
-Here's a list of variables and macros that can be used in templates
+Variables and macros can be used in templates (see the :ref:`jinja-templating` section)
 
+The following come for free out of the box with Airflow. 
+Additional custom macros can be added globally through :ref:`plugins`, or at a DAG level through the ``DAG.user_defined_macros`` argument.
 
 Default Variables
 '''''''''''''''''

From d1442e1e025ec5dbc3a043324d3e4ba6f577d52e Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Sat, 23 Feb 2019 00:12:21 +0800
Subject: [PATCH 606/808] [AIRFLOW-3741] Add extra config to Oracle hook
 (#4584)

Add extra config to Oracle hook including encoding, mode, threaded etc
---
 airflow/hooks/oracle_hook.py      |  78 +++++++++-
 docs/howto/manage-connections.rst |  69 +++++++++
 tests/hooks/test_oracle_hook.py   | 242 ++++++++++++++++++++++++++++++
 3 files changed, 384 insertions(+), 5 deletions(-)
 create mode 100644 tests/hooks/test_oracle_hook.py

diff --git a/airflow/hooks/oracle_hook.py b/airflow/hooks/oracle_hook.py
index ae6aa0f039cf6..202208084f32d 100644
--- a/airflow/hooks/oracle_hook.py
+++ b/airflow/hooks/oracle_hook.py
@@ -49,22 +49,66 @@ def get_conn(self):
 
         You can set these parameters in the extra fields of your connection
         as in ``{ "dsn":"some.host.address" , "service_name":"some.service.name" }``
+        see more param detail in
+        `cx_Oracle.connect <https://cx-oracle.readthedocs.io/en/latest/module.html#cx_Oracle.connect>`_
         """
         conn = self.get_connection(self.oracle_conn_id)
+        conn_config = {
+            'user': conn.login,
+            'password': conn.password
+        }
         dsn = conn.extra_dejson.get('dsn', None)
         sid = conn.extra_dejson.get('sid', None)
         mod = conn.extra_dejson.get('module', None)
 
         service_name = conn.extra_dejson.get('service_name', None)
+        port = conn.port if conn.port else 1521
         if dsn and sid and not service_name:
-            dsn = cx_Oracle.makedsn(dsn, conn.port, sid)
-            conn = cx_Oracle.connect(conn.login, conn.password, dsn=dsn)
+            conn_config['dsn'] = cx_Oracle.makedsn(dsn, port, sid)
         elif dsn and service_name and not sid:
-            dsn = cx_Oracle.makedsn(dsn, conn.port, service_name=service_name)
-            conn = cx_Oracle.connect(conn.login, conn.password, dsn=dsn)
+            conn_config['dsn'] = cx_Oracle.makedsn(dsn, port, service_name=service_name)
         else:
-            conn = cx_Oracle.connect(conn.login, conn.password, conn.host)
+            conn_config['dsn'] = conn.host
 
+        if 'encoding' in conn.extra_dejson:
+            conn_config['encoding'] = conn.extra_dejson.get('encoding')
+            # if `encoding` is specific but `nencoding` is not
+            # `nencoding` should use same values as `encoding` to set encoding, inspired by
+            # https://github.com/oracle/python-cx_Oracle/issues/157#issuecomment-371877993
+            if 'nencoding' not in conn.extra_dejson:
+                conn_config['nencoding'] = conn.extra_dejson.get('encoding')
+        if 'nencoding' in conn.extra_dejson:
+            conn_config['nencoding'] = conn.extra_dejson.get('nencoding')
+        if 'threaded' in conn.extra_dejson:
+            conn_config['threaded'] = conn.extra_dejson.get('threaded')
+        if 'events' in conn.extra_dejson:
+            conn_config['events'] = conn.extra_dejson.get('events')
+
+        mode = conn.extra_dejson.get('mode', '').lower()
+        if mode == 'sysdba':
+            conn_config['mode'] = cx_Oracle.SYSDBA
+        elif mode == 'sysasm':
+            conn_config['mode'] = cx_Oracle.SYSASM
+        elif mode == 'sysoper':
+            conn_config['mode'] = cx_Oracle.SYSOPER
+        elif mode == 'sysbkp':
+            conn_config['mode'] = cx_Oracle.SYSBKP
+        elif mode == 'sysdgd':
+            conn_config['mode'] = cx_Oracle.SYSDGD
+        elif mode == 'syskmt':
+            conn_config['mode'] = cx_Oracle.SYSKMT
+        elif mode == 'sysrac':
+            conn_config['mode'] = cx_Oracle.SYSRAC
+
+        purity = conn.extra_dejson.get('purity', '').lower()
+        if purity == 'new':
+            conn_config['purity'] = cx_Oracle.ATTR_PURITY_NEW
+        elif purity == 'self':
+            conn_config['purity'] = cx_Oracle.ATTR_PURITY_SELF
+        elif purity == 'default':
+            conn_config['purity'] = cx_Oracle.ATTR_PURITY_DEFAULT
+
+        conn = cx_Oracle.connect(**conn_config)
         if mod is not None:
             conn.module = mod
 
@@ -80,6 +124,18 @@ def insert_rows(self, table, rows, target_fields=None, commit_every=1000):
         - Replace NaN values with NULL using `numpy.nan_to_num` (not using
           `is_nan()` because of input types error for strings)
         - Coerce datetime cells to Oracle DATETIME format during insert
+
+        :param table: target Oracle table, use dot notation to target a
+            specific database
+        :type table: str
+        :param rows: the rows to insert into the table
+        :type rows: iterable of tuples
+        :param target_fields: the names of the columns to fill in the table
+        :type target_fields: iterable of str
+        :param commit_every: the maximum number of rows to insert in one transaction
+            Default 1000, Set greater than 0.
+            Set 1 to insert each row in each single transaction
+        :type commit_every: int
         """
         if target_fields:
             target_fields = ', '.join(target_fields)
@@ -130,6 +186,18 @@ def bulk_insert_rows(self, table, rows, target_fields=None, commit_every=5000):
         A performant bulk insert for cx_Oracle
         that uses prepared statements via `executemany()`.
         For best performance, pass in `rows` as an iterator.
+
+        :param table: target Oracle table, use dot notation to target a
+            specific database
+        :type table: str
+        :param rows: the rows to insert into the table
+        :type rows: iterable of tuples
+        :param target_fields: the names of the columns to fill in the table, default None.
+            If None, each rows should have some order as table columns name
+        :type target_fields: iterable of str Or None
+        :param commit_every: the maximum number of rows to insert in one transaction
+            Default 5000. Set greater than 0. Set 1 to insert each row in each transaction
+        :type commit_every: int
         """
         conn = self.get_conn()
         cursor = conn.cursor()
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 5dd8ecbfd8f10..5f5be3489578c 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -366,6 +366,75 @@ Extra (optional)
 
         postgresql://postgres_user:XXXXXXXXXXXX@1.1.1.1:5432/postgresdb?sslmode=verify-ca&sslcert=%2Ftmp%2Fclient-cert.pem&sslkey=%2Ftmp%2Fclient-key.pem&sslrootcert=%2Ftmp%2Fserver-ca.pem
 
+Oracle
+~~~~~~~~
+The Oracle connection type provides connection to a Oracle database.
+
+Configuring the Connection
+''''''''''''''''''''''''''
+Dsn (required)
+    The Data Source Name. The host address for the Oracle server.
+
+Sid (optional)
+    The Oracle System ID. The uniquely identify a particular database on a system.
+
+Service_name (optional)
+    The db_unique_name of the database.
+
+Port (optional)
+    The port for the Oracle server, Default 1521.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in Oracle
+    connection. The following parameters are supported:
+
+    * **encoding** - The encoding to use for regular database strings. If not specified,
+      the environment variable `NLS_LANG` is used. If the environment variable `NLS_LANG`
+      is not set, `ASCII` is used.
+    * **nencoding** - The encoding to use for national character set database strings.
+      If not specified, the environment variable `NLS_NCHAR` is used. If the environment
+      variable `NLS_NCHAR` is not used, the environment variable `NLS_LANG` is used instead,
+      and if the environment variable `NLS_LANG` is not set, `ASCII` is used.
+    * **threaded** - Whether or not Oracle should wrap accesses to connections with a mutex.
+      Default value is False.
+    * **events** - Whether or not to initialize Oracle in events mode.
+    * **mode** - one of `sysdba`, `sysasm`, `sysoper`, `sysbkp`, `sysdgd`, `syskmt` or `sysrac`
+      which are defined at the module level, Default mode is connecting.
+    * **purity** - one of `new`, `self`, `default`. Specify the session acquired from the pool.
+      configuration parameter.
+
+    More details on all Oracle connect parameters supported can be found in
+    `cx_Oracle documentation <https://cx-oracle.readthedocs.io/en/latest/module.html#cx_Oracle.connect>`_.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "encoding": "UTF-8",
+          "nencoding": "UTF-8",
+          "threaded": false,
+          "events": false,
+          "mode": "sysdba",
+          "purity": "new"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras are passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        oracle://oracle_user:XXXXXXXXXXXX@1.1.1.1:1521?encoding=UTF-8&nencoding=UTF-8&threaded=False&events=False&mode=sysdba&purity=new
+
 Cloudsql
 ~~~~~~~~
 The gcpcloudsql:// connection is used by
diff --git a/tests/hooks/test_oracle_hook.py b/tests/hooks/test_oracle_hook.py
new file mode 100644
index 0000000000000..36a29ec9d3580
--- /dev/null
+++ b/tests/hooks/test_oracle_hook.py
@@ -0,0 +1,242 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+import unittest
+from datetime import datetime
+
+try:
+    import cx_Oracle
+except ImportError:
+    cx_Oracle = None
+import mock
+import numpy
+
+from airflow.hooks.oracle_hook import OracleHook
+from airflow.models import Connection
+
+
+@unittest.skipIf(cx_Oracle is None, 'cx_Oracle package not present')
+class TestOracleHookConn(unittest.TestCase):
+
+    def setUp(self):
+        super(TestOracleHookConn, self).setUp()
+
+        self.connection = Connection(
+            login='login',
+            password='password',
+            host='host',
+            port=1521
+        )
+
+        self.db_hook = OracleHook()
+        self.db_hook.get_connection = mock.Mock()
+        self.db_hook.get_connection.return_value = self.connection
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_host(self, mock_connect):
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['user'], 'login')
+        self.assertEqual(kwargs['password'], 'password')
+        self.assertEqual(kwargs['dsn'], 'host')
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_sid(self, mock_connect):
+        dsn_sid = {'dsn': 'dsn', 'sid': 'sid'}
+        self.connection.extra = json.dumps(dsn_sid)
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['dsn'],
+                         cx_Oracle.makedsn(dsn_sid['dsn'],
+                                           self.connection.port, dsn_sid['sid']))
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_service_name(self, mock_connect):
+        dsn_service_name = {'dsn': 'dsn', 'service_name': 'service_name'}
+        self.connection.extra = json.dumps(dsn_service_name)
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['dsn'], cx_Oracle.makedsn(
+            dsn_service_name['dsn'], self.connection.port,
+            service_name=dsn_service_name['service_name']))
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_encoding_without_nencoding(self, mock_connect):
+        self.connection.extra = json.dumps({'encoding': 'UTF-8'})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['encoding'], 'UTF-8')
+        self.assertEqual(kwargs['nencoding'], 'UTF-8')
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_encoding_with_nencoding(self, mock_connect):
+        self.connection.extra = json.dumps({'encoding': 'UTF-8', 'nencoding': 'gb2312'})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['encoding'], 'UTF-8')
+        self.assertEqual(kwargs['nencoding'], 'gb2312')
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_nencoding(self, mock_connect):
+        self.connection.extra = json.dumps({'nencoding': 'UTF-8'})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertNotIn('encoding', kwargs)
+        self.assertEqual(kwargs['nencoding'], 'UTF-8')
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_mode(self, mock_connect):
+        mode = {
+            'sysdba': cx_Oracle.SYSDBA,
+            'sysasm': cx_Oracle.SYSASM,
+            'sysoper': cx_Oracle.SYSOPER,
+            'sysbkp': cx_Oracle.SYSBKP,
+            'sysdgd': cx_Oracle.SYSDGD,
+            'syskmt': cx_Oracle.SYSKMT,
+        }
+        first = True
+        for m in mode:
+            self.connection.extra = json.dumps({'mode': m})
+            self.db_hook.get_conn()
+            if first:
+                mock_connect.assert_called_once()
+                first = False
+            args, kwargs = mock_connect.call_args
+            self.assertEqual(args, ())
+            self.assertEqual(kwargs['mode'], mode.get(m))
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_threaded(self, mock_connect):
+        self.connection.extra = json.dumps({'threaded': True})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['threaded'], True)
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_events(self, mock_connect):
+        self.connection.extra = json.dumps({'events': True})
+        self.db_hook.get_conn()
+        mock_connect.assert_called_once()
+        args, kwargs = mock_connect.call_args
+        self.assertEqual(args, ())
+        self.assertEqual(kwargs['events'], True)
+
+    @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
+    def test_get_conn_purity(self, mock_connect):
+        purity = {
+            'new': cx_Oracle.ATTR_PURITY_NEW,
+            'self': cx_Oracle.ATTR_PURITY_SELF,
+            'default': cx_Oracle.ATTR_PURITY_DEFAULT
+        }
+        first = True
+        for p in purity:
+            self.connection.extra = json.dumps({'purity': p})
+            self.db_hook.get_conn()
+            if first:
+                mock_connect.assert_called_once()
+                first = False
+            args, kwargs = mock_connect.call_args
+            self.assertEqual(args, ())
+            self.assertEqual(kwargs['purity'], purity.get(p))
+
+
+@unittest.skipIf(cx_Oracle is None, 'cx_Oracle package not present')
+class TestOracleHook(unittest.TestCase):
+    def setUp(self):
+        super(TestOracleHook, self).setUp()
+
+        self.cur = mock.MagicMock()
+        self.conn = mock.MagicMock()
+        self.conn.cursor.return_value = self.cur
+        conn = self.conn
+
+        class UnitTestOracleHook(OracleHook):
+            conn_name_attr = 'test_conn_id'
+
+            def get_conn(self):
+                return conn
+
+        self.db_hook = UnitTestOracleHook()
+
+    def test_run_without_parameters(self):
+        sql = 'SQL'
+        self.db_hook.run(sql)
+        self.cur.execute.assert_called_once_with(sql)
+        self.conn.commit.assert_called()
+
+    def test_run_with_parameters(self):
+        sql = 'SQL'
+        param = ('p1', 'p2')
+        self.db_hook.run(sql, parameters=param)
+        self.cur.execute.assert_called_once_with(sql, param)
+        self.conn.commit.assert_called()
+
+    def test_insert_rows_with_fields(self):
+        rows = [("'basestr_with_quote", None, numpy.NAN,
+                 numpy.datetime64('2019-01-24T01:02:03'),
+                 datetime(2019, 1, 24), 1, 10.24, 'str')]
+        target_fields = ['basestring', 'none', 'numpy_nan', 'numpy_datetime64',
+                         'datetime', 'int', 'float', 'str']
+        self.db_hook.insert_rows('table', rows, target_fields)
+        self.cur.execute.assert_called_once_with(
+            "INSERT /*+ APPEND */ INTO table "
+            "(basestring, none, numpy_nan, numpy_datetime64, datetime, int, float, str) "
+            "VALUES ('''basestr_with_quote',NULL,NULL,'2019-01-24T01:02:03',"
+            "to_date('2019-01-24 00:00:00','YYYY-MM-DD HH24:MI:SS'),1,10.24,'str')")
+
+    def test_insert_rows_without_fields(self):
+        rows = [("'basestr_with_quote", None, numpy.NAN,
+                 numpy.datetime64('2019-01-24T01:02:03'),
+                 datetime(2019, 1, 24), 1, 10.24, 'str')]
+        self.db_hook.insert_rows('table', rows)
+        self.cur.execute.assert_called_once_with(
+            "INSERT /*+ APPEND */ INTO table "
+            " VALUES ('''basestr_with_quote',NULL,NULL,'2019-01-24T01:02:03',"
+            "to_date('2019-01-24 00:00:00','YYYY-MM-DD HH24:MI:SS'),1,10.24,'str')")
+
+    def test_bulk_insert_rows_with_fields(self):
+        rows = [(1, 2, 3), (4, 5, 6), (7, 8, 9)]
+        target_fields = ['col1', 'col2', 'col3']
+        self.db_hook.bulk_insert_rows('table', rows, target_fields)
+        self.cur.prepare.assert_called_once_with(
+            "insert into table (col1, col2, col3) values (:1, :2, :3)")
+        self.cur.executemany.assert_called_once_with(None, rows)
+
+    def test_bulk_insert_rows_with_commit_every(self):
+        rows = [(1, 2, 3), (4, 5, 6), (7, 8, 9)]
+        target_fields = ['col1', 'col2', 'col3']
+        self.db_hook.bulk_insert_rows('table', rows, target_fields, commit_every=2)
+        self.cur.prepare.assert_called_with(
+            "insert into table (col1, col2, col3) values (:1, :2, :3)")
+        self.cur.executemany.assert_called_with(None, rows[2:])

From c433be2b05a37d4150685d5095670caa57531bd5 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Mon, 4 Mar 2019 22:20:45 +0800
Subject: [PATCH 607/808] [AIRFLOW-3767] Correct bulk insert function (#4773)

* [AIRFLOW-3767] Correct bulk insert function

Fix Oracle hook bulk_insert bug when
param target_fields is None or rows
is empty iterable

* change without overwriting variables as Fokko said
---
 airflow/hooks/oracle_hook.py    | 10 ++++++----
 tests/hooks/test_oracle_hook.py | 11 +++++++++++
 2 files changed, 17 insertions(+), 4 deletions(-)

diff --git a/airflow/hooks/oracle_hook.py b/airflow/hooks/oracle_hook.py
index 202208084f32d..c98dbf62a2bc8 100644
--- a/airflow/hooks/oracle_hook.py
+++ b/airflow/hooks/oracle_hook.py
@@ -199,13 +199,15 @@ def bulk_insert_rows(self, table, rows, target_fields=None, commit_every=5000):
             Default 5000. Set greater than 0. Set 1 to insert each row in each transaction
         :type commit_every: int
         """
+        if not rows:
+            raise ValueError("parameter rows could not be None or empty iterable")
         conn = self.get_conn()
         cursor = conn.cursor()
-        values = ', '.join(':%s' % i for i in range(1, len(target_fields) + 1))
-        prepared_stm = 'insert into {tablename} ({columns}) values ({values})'.format(
+        values_base = target_fields if target_fields else rows[0]
+        prepared_stm = 'insert into {tablename} {columns} values ({values})'.format(
             tablename=table,
-            columns=', '.join(target_fields),
-            values=values,
+            columns='({})'.format(', '.join(target_fields)) if target_fields else '',
+            values=', '.join(':%s' % i for i in range(1, len(values_base) + 1)),
         )
         row_count = 0
         # Chunk the rows
diff --git a/tests/hooks/test_oracle_hook.py b/tests/hooks/test_oracle_hook.py
index 36a29ec9d3580..c3299d79bce44 100644
--- a/tests/hooks/test_oracle_hook.py
+++ b/tests/hooks/test_oracle_hook.py
@@ -240,3 +240,14 @@ def test_bulk_insert_rows_with_commit_every(self):
         self.cur.prepare.assert_called_with(
             "insert into table (col1, col2, col3) values (:1, :2, :3)")
         self.cur.executemany.assert_called_with(None, rows[2:])
+
+    def test_bulk_insert_rows_without_fields(self):
+        rows = [(1, 2, 3), (4, 5, 6), (7, 8, 9)]
+        self.db_hook.bulk_insert_rows('table', rows)
+        self.cur.prepare.assert_called_once_with(
+            "insert into table  values (:1, :2, :3)")
+        self.cur.executemany.assert_called_once_with(None, rows)
+
+    def test_bulk_insert_rows_no_rows(self):
+        rows = []
+        self.assertRaises(ValueError, self.db_hook.bulk_insert_rows, 'table', rows)

From d68ca0b84c85be58217e9ea5912d8a2d4b32e63e Mon Sep 17 00:00:00 2001
From: Stijn De Haes <stijn.de.haes@gmail.com>
Date: Fri, 1 Mar 2019 09:13:09 +0100
Subject: [PATCH 608/808] [AIRFLOW-3766] Add support for kubernetes annotations
 (#4589)

---
 airflow/config_templates/default_airflow.cfg                  | 4 ++++
 airflow/contrib/executors/kubernetes_executor.py              | 1 +
 airflow/contrib/kubernetes/worker_configuration.py            | 2 +-
 scripts/ci/kubernetes/kube/templates/configmaps.template.yaml | 4 ++++
 4 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index bec898453d230..69b70c2f41516 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -687,6 +687,10 @@ tolerations =
 # The worker pods will be scheduled to the nodes of the specified key-value pairs.
 # Should be supplied in the format: key = value
 
+[kubernetes_annotations]
+# The Key-value annotations pairs to be given to worker pods.
+# Should be supplied in the format: key = value
+
 [kubernetes_secrets]
 # The scheduler mounts the following secrets into your workers as they are launched by the
 # scheduler. You may define as many secrets as needed and the kubernetes launcher will parse the
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index a76b3854e11fb..2368383cd5ad4 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -134,6 +134,7 @@ def __init__(self):
             self.kubernetes_section, "worker_container_image_pull_policy"
         )
         self.kube_node_selectors = configuration_dict.get('kubernetes_node_selectors', {})
+        self.kube_annotations = configuration_dict.get('kubernetes_annotations', {})
         self.delete_worker_pods = conf.getboolean(
             self.kubernetes_section, 'delete_worker_pods')
 
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 62c6ef68b03b3..ae86e5c225fd4 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -222,7 +222,7 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             limit_cpu=kube_executor_config.limit_cpu
         )
         gcp_sa_key = kube_executor_config.gcp_service_account_key
-        annotations = dict(kube_executor_config.annotations)
+        annotations = dict(kube_executor_config.annotations) or self.kube_config.kube_annotations
         if gcp_sa_key:
             annotations['iam.cloud.google.com/service-account'] = gcp_sa_key
 
diff --git a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
index 7761a6bcdc089..527023d36ef80 100644
--- a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
+++ b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
@@ -213,6 +213,10 @@ data:
     # The worker pods will be scheduled to the nodes of the specified key-value pairs.
     # Should be supplied in the format: key = value
 
+    [kubernetes_annotations]
+    # The Key-value annotations pairs to be given to worker pods.
+    # Should be supplied in the format: key = value
+
     [kubernetes_secrets]
     SQL_ALCHEMY_CONN = airflow-secrets=sql_alchemy_conn
 

From ddaa00cd0beab2bf212ad67d2fb57de35ab7ee22 Mon Sep 17 00:00:00 2001
From: davlum <david.lum@ssense.com>
Date: Wed, 6 Mar 2019 12:40:52 -0500
Subject: [PATCH 609/808] [AIRFLOW-3258] K8S executor environment variables
 section. (#4627)

* [AIRFLOW-3258] K8S executor, optional mount current env in worker pods

* fix(AIRFLOW-3258): fix tests

* fetch config in KubeConfig init

* fix(AIRFLOW-3258): address pr comments

feat(AIRFLOW-3258): move feature to AIRFLOW-4008

fix(AIRFLOW-3258): fix tests

* refactor(AIRFLOW-3258): changes for PR
---
 airflow/config_templates/default_airflow.cfg  | 13 +++++++++++
 .../contrib/executors/kubernetes_executor.py  |  1 +
 .../kubernetes/worker_configuration.py        |  9 +++++---
 .../executors/test_kubernetes_executor.py     | 22 +++++++++++++++++++
 4 files changed, 42 insertions(+), 3 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 69b70c2f41516..222fe12d87a51 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -691,6 +691,19 @@ tolerations =
 # The Key-value annotations pairs to be given to worker pods.
 # Should be supplied in the format: key = value
 
+[kubernetes_environment_variables]
+# The scheduler sets the following environment variables into your workers. You may define as
+# many environment variables as needed and the kubernetes launcher will set them in the launched workers.
+# Environment variables in this section are defined as follows
+#     <environment_variable_key> = <environment_variable_value>
+#
+# For example if you wanted to set an environment variable with value `prod` and key
+# `ENVIRONMENT` you would follow the following format:
+#     ENVIRONMENT = prod
+#
+# Additionally you may override worker airflow settings with the AIRFLOW__<SECTION>__<KEY>
+# formatting as supported by airflow normally.
+
 [kubernetes_secrets]
 # The scheduler mounts the following secrets into your workers as they are launched by the
 # scheduler. You may define as many secrets as needed and the kubernetes launcher will parse the
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 2368383cd5ad4..1a4faa1ab78d2 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -121,6 +121,7 @@ def __init__(self):
         configuration_dict = configuration.as_dict(display_sensitive=True)
         self.core_configuration = configuration_dict['core']
         self.kube_secrets = configuration_dict.get('kubernetes_secrets', {})
+        self.kube_env_vars = configuration_dict.get('kubernetes_environment_variables', {})
         self.airflow_home = configuration.get(self.core_section, 'airflow_home')
         self.dags_folder = configuration.get(self.core_section, 'dags_folder')
         self.parallelism = configuration.getint(self.core_section, 'PARALLELISM')
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index ae86e5c225fd4..f875606950179 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -95,9 +95,12 @@ def _get_init_containers(self, volume_mounts):
 
     def _get_environment(self):
         """Defines any necessary environment variables for the pod executor"""
-        env = {
-            "AIRFLOW__CORE__EXECUTOR": "LocalExecutor",
-        }
+        env = {}
+
+        for env_var_name, env_var_val in six.iteritems(self.kube_config.kube_env_vars):
+            env[env_var_name] = env_var_val
+
+        env["AIRFLOW__CORE__EXECUTOR"] = "LocalExecutor"
 
         if self.kube_config.airflow_configmap:
             env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 8bd4bd35c86eb..48ed69abd3bcf 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -348,6 +348,28 @@ def test_worker_container_dags(self):
         self.assertEqual(0, len(dag_volume_mount))
         self.assertEqual(0, len(init_containers))
 
+    def test_kubernetes_environment_variables(self):
+        # Tests the kubernetes environment variables get copied into the worker pods
+        input_environment = {
+            'ENVIRONMENT': 'prod',
+            'LOG_LEVEL': 'warning'
+        }
+        self.kube_config.kube_env_vars = input_environment
+        worker_config = WorkerConfiguration(self.kube_config)
+        env = worker_config._get_environment()
+        for key in input_environment:
+            self.assertIn(key, env)
+            self.assertIn(input_environment[key], env.values())
+
+        core_executor = 'AIRFLOW__CORE__EXECUTOR'
+        input_environment = {
+            core_executor: 'NotLocalExecutor'
+        }
+        self.kube_config.kube_env_vars = input_environment
+        worker_config = WorkerConfiguration(self.kube_config)
+        env = worker_config._get_environment()
+        self.assertEqual(env[core_executor], 'LocalExecutor')
+
 
 if __name__ == '__main__':
     unittest.main()

From b967748872d86b202deace22e62eb61dc8e6d6c4 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Sat, 23 Feb 2019 11:55:34 -0500
Subject: [PATCH 610/808] [AIRFLOW-3932] Optionally skip dag discovery
 heuristic. (#4746)

---
 UPDATING.md                                  | 6 ++++++
 airflow/config_templates/default_airflow.cfg | 4 ++++
 airflow/models.py                            | 5 ++++-
 3 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/UPDATING.md b/UPDATING.md
index ca159b9366333..45b10fa0ef987 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -57,6 +57,12 @@ If the `AIRFLOW_CONFIG` environment variable was not set and the
 will discover its config file using the `$AIRFLOW_CONFIG` and `$AIRFLOW_HOME`
 environment variables rather than checking for the presence of a file.
 
+### New `dag_discovery_safe_mode` config option
+
+If `dag_discovery_safe_mode` is enabled, only check files for DAGs if
+they contain the strings "airflow" and "DAG". For backwards
+compatibility, this option is enabled by default.
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 222fe12d87a51..9e6264c2307d8 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -178,6 +178,10 @@ dag_run_conf_overrides_params = False
 # Worker initialisation check to validate Metadata Database connection
 worker_precheck = False
 
+# When discovering DAGs, ignore any files that don't contain the strings `DAG` and `airflow`.
+dag_discovery_safe_mode = True
+
+
 [cli]
 # In what way should the cli access the API. The LocalClient will use the
 # database directly, while the json_client will use the api running on the
diff --git a/airflow/models.py b/airflow/models.py
index ab78abad85848..a90c405ac2b4b 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -540,7 +540,10 @@ def collect_dags(
         stats = []
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
-        for filepath in list_py_file_paths(dag_folder, include_examples=include_examples):
+
+        safe_mode = configuration.conf.getboolean('core', 'dag_discovery_safe_mode')
+        for filepath in list_py_file_paths(dag_folder, safe_mode=safe_mode,
+                                           include_examples=include_examples):
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(

From 229509939e7999fdb498e2a2d6de2509c28df358 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 25 Feb 2019 00:35:14 -0500
Subject: [PATCH 611/808] [AIRFLOW-3932] Update unit tests and documentation
 for safe mode flag. (#4760)

---
 airflow/models.py | 15 ++++++++++-----
 docs/concepts.rst |  6 ++++--
 tests/models.py   | 38 +++++++++++++++++++++++++++++++++++++-
 3 files changed, 51 insertions(+), 8 deletions(-)

diff --git a/airflow/models.py b/airflow/models.py
index a90c405ac2b4b..e76254cfcfed1 100755
--- a/airflow/models.py
+++ b/airflow/models.py
@@ -270,7 +270,8 @@ def __init__(
             self,
             dag_folder=None,
             executor=None,
-            include_examples=configuration.conf.getboolean('core', 'LOAD_EXAMPLES')):
+            include_examples=configuration.conf.getboolean('core', 'LOAD_EXAMPLES'),
+            safe_mode=configuration.conf.getboolean('core', 'DAG_DISCOVERY_SAFE_MODE')):
 
         # do not use default arg in signature, to fix import cycle on plugin load
         if executor is None:
@@ -285,7 +286,10 @@ def __init__(
         self.import_errors = {}
         self.has_logged = False
 
-        self.collect_dags(dag_folder=dag_folder, include_examples=include_examples)
+        self.collect_dags(
+            dag_folder=dag_folder,
+            include_examples=include_examples,
+            safe_mode=safe_mode)
 
     def size(self):
         """
@@ -520,7 +524,8 @@ def collect_dags(
             self,
             dag_folder=None,
             only_if_updated=True,
-            include_examples=configuration.conf.getboolean('core', 'LOAD_EXAMPLES')):
+            include_examples=configuration.conf.getboolean('core', 'LOAD_EXAMPLES'),
+            safe_mode=configuration.conf.getboolean('core', 'DAG_DISCOVERY_SAFE_MODE')):
         """
         Given a file path or a folder, this method looks for python modules,
         imports them and adds them to the dagbag collection.
@@ -541,13 +546,13 @@ def collect_dags(
         FileLoadStat = namedtuple(
             'FileLoadStat', "file duration dag_num task_num dags")
 
-        safe_mode = configuration.conf.getboolean('core', 'dag_discovery_safe_mode')
         for filepath in list_py_file_paths(dag_folder, safe_mode=safe_mode,
                                            include_examples=include_examples):
             try:
                 ts = timezone.utcnow()
                 found_dags = self.process_file(
-                    filepath, only_if_updated=only_if_updated)
+                    filepath, only_if_updated=only_if_updated,
+                    safe_mode=safe_mode)
 
                 td = timezone.utcnow() - ts
                 td = td.total_seconds() + (
diff --git a/docs/concepts.rst b/docs/concepts.rst
index e5c28bb11f598..790247ec07cac 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -52,8 +52,10 @@ the ``DAG`` objects. You can have as many DAGs as you want, each describing an
 arbitrary number of tasks. In general, each one should correspond to a single
 logical workflow.
 
-.. note:: When searching for DAGs, Airflow will only consider files where the string
-   "airflow" and "DAG" both appear in the contents of the ``.py`` file.
+.. note:: When searching for DAGs, Airflow only considers python files
+   that contain the strings "airflow" and "DAG" by default. To consider
+   all python files instead, disable the ``DAG_DISCOVERY_SAFE_MODE``
+   configuration flag.
 
 Scope
 -----
diff --git a/tests/models.py b/tests/models.py
index 45c5183d5b2b8..076bde436558c 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -32,6 +32,7 @@
 import unittest
 import urllib
 import uuid
+import shutil
 from tempfile import NamedTemporaryFile, mkdtemp
 
 import pendulum
@@ -1480,7 +1481,7 @@ def setUpClass(cls):
 
     @classmethod
     def tearDownClass(cls):
-        os.rmdir(cls.empty_dir)
+        shutil.rmtree(cls.empty_dir)
 
     def test_get_existing_dag(self):
         """
@@ -1516,6 +1517,41 @@ def test_dont_load_example(self):
 
         self.assertEqual(dagbag.size(), 0)
 
+    def test_safe_mode_heuristic_match(self):
+        """With safe mode enabled, a file matching the discovery heuristics
+        should be discovered.
+        """
+        with NamedTemporaryFile(dir=self.empty_dir, suffix=".py") as fp:
+            fp.write("# airflow".encode())
+            fp.write("# DAG".encode())
+            fp.flush()
+            dagbag = models.DagBag(
+                dag_folder=self.empty_dir, include_examples=False, safe_mode=True)
+            self.assertEqual(len(dagbag.dagbag_stats), 1)
+            self.assertEqual(
+                dagbag.dagbag_stats[0].file,
+                "/{}".format(os.path.basename(fp.name)))
+
+    def test_safe_mode_heuristic_mismatch(self):
+        """With safe mode enabled, a file not matching the discovery heuristics
+        should not be discovered.
+        """
+        with NamedTemporaryFile(dir=self.empty_dir, suffix=".py"):
+            dagbag = models.DagBag(
+                dag_folder=self.empty_dir, include_examples=False, safe_mode=True)
+            self.assertEqual(len(dagbag.dagbag_stats), 0)
+
+    def test_safe_mode_disabled(self):
+        """With safe mode disabled, an empty python file should be discovered.
+        """
+        with NamedTemporaryFile(dir=self.empty_dir, suffix=".py") as fp:
+            dagbag = models.DagBag(
+                dag_folder=self.empty_dir, include_examples=False, safe_mode=False)
+            self.assertEqual(len(dagbag.dagbag_stats), 1)
+            self.assertEqual(
+                dagbag.dagbag_stats[0].file,
+                "/{}".format(os.path.basename(fp.name)))
+
     def test_process_file_that_contains_multi_bytes_char(self):
         """
         test that we're able to parse file that contains multi-byte char

From 8be766484369471db473636bcf7c4b1c72b6d35b Mon Sep 17 00:00:00 2001
From: "Santhoshkumar. P" <sann3@users.noreply.github.com>
Date: Sun, 19 Aug 2018 20:06:37 +0530
Subject: [PATCH 612/808] [AIRFLOW-XXX] Fixing the issue in Documentation
 (#3756)

---
 airflow/contrib/operators/dataflow_operator.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index d020a6c9bbffe..4e76c6e5a6388 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -186,9 +186,9 @@ class DataflowTemplateOperator(BaseOperator):
 
        default_args = {
            'dataflow_default_options': {
-               'project': 'my-gcp-project'
+               'project': 'my-gcp-project',
                'zone': 'europe-west1-d',
-               'tempLocation': 'gs://my-staging-bucket/staging/'
+               'tempLocation': 'gs://my-staging-bucket/staging/',
                }
            }
        }

From f00ce81a56d1c0876ff75a4464e9dfd27aeed408 Mon Sep 17 00:00:00 2001
From: Jan Hicken <janhicken@users.noreply.github.com>
Date: Sun, 25 Nov 2018 15:10:32 +0100
Subject: [PATCH 613/808] [AIRFLOW-2715] Use region setting when launching
 Dataflow templates (#4139)

To launch an instance of a Dataflow template in the configured region,
the API service.projects().locations().teplates() instead of
service.projects().templates() has to be used. Otherwise, all jobs will
always be started in us-central1.

In case there is no region configured, the default region `us-central1`
will get picked up.

To make it even worse, the polling for the job status already honors the
region parameter and will search for the job in the wrong region in the
current implementation. Because the job's status is not found, the
corresponding Airflow task will hang.
---
 airflow/contrib/hooks/gcp_dataflow_hook.py     | 4 +++-
 airflow/contrib/operators/dataflow_operator.py | 1 +
 tests/contrib/hooks/test_gcp_dataflow_hook.py  | 4 +++-
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/gcp_dataflow_hook.py b/airflow/contrib/hooks/gcp_dataflow_hook.py
index 94142b2e7da4e..44679b3205362 100644
--- a/airflow/contrib/hooks/gcp_dataflow_hook.py
+++ b/airflow/contrib/hooks/gcp_dataflow_hook.py
@@ -221,6 +221,7 @@ def label_formatter(labels_dict):
 
     def start_template_dataflow(self, job_name, variables, parameters, dataflow_template,
                                 append_job_name=True):
+        variables = self._set_variables(variables)
         name = self._build_dataflow_job_name(job_name, append_job_name)
         self._start_template_dataflow(
             name, variables, parameters, dataflow_template)
@@ -279,8 +280,9 @@ def _start_template_dataflow(self, name, variables, parameters,
                 "parameters": parameters,
                 "environment": environment}
         service = self.get_conn()
-        request = service.projects().templates().launch(
+        request = service.projects().locations().templates().launch(
             projectId=variables['project'],
+            location=variables['region'],
             gcsPath=dataflow_template,
             body=body
         )
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index 4e76c6e5a6388..de91804950092 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -187,6 +187,7 @@ class DataflowTemplateOperator(BaseOperator):
        default_args = {
            'dataflow_default_options': {
                'project': 'my-gcp-project',
+               'region': 'europe-west1',
                'zone': 'europe-west1-d',
                'tempLocation': 'gs://my-staging-bucket/staging/',
                }
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 653993a7de7c1..57932c47f647a 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -255,8 +255,10 @@ def test_start_template_dataflow(self, internal_dataflow_mock):
         self.dataflow_hook.start_template_dataflow(
             job_name=JOB_NAME, variables=DATAFLOW_OPTIONS_TEMPLATE, parameters=PARAMETERS,
             dataflow_template=TEMPLATE)
+        options_with_region = {'region': 'us-central1'}
+        options_with_region.update(DATAFLOW_OPTIONS_TEMPLATE)
         internal_dataflow_mock.assert_called_once_with(
-            mock.ANY, DATAFLOW_OPTIONS_TEMPLATE, PARAMETERS, TEMPLATE)
+            mock.ANY, options_with_region, PARAMETERS, TEMPLATE)
 
 
 class DataFlowJobTest(unittest.TestCase):

From e9a1bf8b6e85b19f38c6fd4e0e661e9b69cb7d70 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Tue, 29 Jan 2019 19:49:06 +0800
Subject: [PATCH 614/808] [AIRFLOW-3734] Fix hql not run when partition is None
 (#4561)

---
 airflow/hooks/hive_hooks.py   | 4 ++--
 tests/hooks/test_hive_hook.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index adf629e858a31..fc41ac815bc5c 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -451,11 +451,11 @@ def load_file(
         if partition:
             pvals = ", ".join(
                 ["{0}='{1}'".format(k, v) for k, v in partition.items()])
-            hql += "PARTITION ({pvals});"
+            hql += "PARTITION ({pvals})"
 
         # As a workaround for HIVE-10541, add a newline character
         # at the end of hql (AIRFLOW-2412).
-        hql += '\n'
+        hql += ';\n'
 
         hql = hql.format(**locals())
         self.log.info(hql)
diff --git a/tests/hooks/test_hive_hook.py b/tests/hooks/test_hive_hook.py
index 1cac74c6cd846..fd1c9faafa056 100644
--- a/tests/hooks/test_hive_hook.py
+++ b/tests/hooks/test_hive_hook.py
@@ -138,7 +138,7 @@ def test_load_file(self, mock_run_cli):
 
         query = (
             "LOAD DATA LOCAL INPATH '{filepath}' "
-            "OVERWRITE INTO TABLE {table} \n"
+            "OVERWRITE INTO TABLE {table} ;\n"
             .format(filepath=filepath, table=table)
         )
         mock_run_cli.assert_called_with(query)

From ee688f6987221788c1c67cc15b6b49938f8d61cb Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Mon, 18 Feb 2019 16:21:50 +0800
Subject: [PATCH 615/808] [AIRFLOW-3733] Don't raise NameError in HQL hook
 to_csv when no rows returned (#4560)

---
 airflow/hooks/hive_hooks.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index fc41ac815bc5c..cc503ac462d02 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -895,6 +895,7 @@ def to_csv(
         header = next(results_iter)
         message = None
 
+        i = 0
         with open(csv_filepath, 'wb') as f:
             writer = csv.writer(f,
                                 delimiter=delimiter,

From 288c9a509d7d2aeb2fb5c21b6d5037feaa012eb2 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Tue, 12 Feb 2019 23:02:22 +0800
Subject: [PATCH 616/808] [AIRFLOW-3875] Simplify SlackWebhookHook code and
 change docstring (#4696)

---
 airflow/contrib/hooks/slack_webhook_hook.py | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/hooks/slack_webhook_hook.py b/airflow/contrib/hooks/slack_webhook_hook.py
index ab7d7827702ab..aca10385ff901 100644
--- a/airflow/contrib/hooks/slack_webhook_hook.py
+++ b/airflow/contrib/hooks/slack_webhook_hook.py
@@ -67,7 +67,6 @@ def __init__(self,
                  **kwargs
                  ):
         super(SlackWebhookHook, self).__init__(*args, **kwargs)
-        self.http_conn_id = http_conn_id
         self.webhook_token = self._get_token(webhook_token, http_conn_id)
         self.message = message
         self.attachments = attachments
@@ -81,7 +80,9 @@ def _get_token(self, token, http_conn_id):
         """
         Given either a manually set token or a conn_id, return the webhook_token to use
         :param token: The manually provided token
-        :param conn_id: The conn_id provided
+        :type token: str
+        :param http_conn_id: The conn_id provided
+        :type http_conn_id: str
         :return: webhook_token (str) to use
         """
         if token:
@@ -119,9 +120,6 @@ def _build_slack_message(self):
     def execute(self):
         """
         Remote Popen (actually execute the slack webhook call)
-
-        :param cmd: command to remotely execute
-        :param kwargs: extra arguments to Popen (see subprocess.Popen)
         """
         proxies = {}
         if self.proxy:

From 037b6d67c494d2a18de86be48d4ff137c5e304bf Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Wed, 27 Feb 2019 23:34:59 +0800
Subject: [PATCH 617/808] [AIRFLOW-3881] Correct to_csv row number (#4699)

---
 airflow/hooks/hive_hooks.py   |  2 +-
 tests/hooks/test_hive_hook.py | 21 +++++++++++++++++++--
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index cc503ac462d02..7653072a1f50c 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -906,7 +906,7 @@ def to_csv(
                     self.log.debug('Cursor description is %s', header)
                     writer.writerow([c[0] for c in header])
 
-                for i, row in enumerate(results_iter):
+                for i, row in enumerate(results_iter, 1):
                     writer.writerow(row)
                     if i % fetch_size == 0:
                         self.log.info("Written %s rows so far.", i)
diff --git a/tests/hooks/test_hive_hook.py b/tests/hooks/test_hive_hook.py
index fd1c9faafa056..2a303c165c453 100644
--- a/tests/hooks/test_hive_hook.py
+++ b/tests/hooks/test_hive_hook.py
@@ -22,6 +22,7 @@
 import itertools
 import os
 import random
+import sys
 import unittest
 from collections import OrderedDict
 
@@ -39,10 +40,10 @@
 
 configuration.load_test_config()
 
-
 DEFAULT_DATE = timezone.datetime(2015, 1, 1)
 DEFAULT_DATE_ISO = DEFAULT_DATE.isoformat()
 DEFAULT_DATE_DS = DEFAULT_DATE_ISO[:10]
+NOT_ASSERTLOGS_VERSION = sys.version_info.major + sys.version_info.minor / 10
 
 
 class HiveEnvironmentTest(unittest.TestCase):
@@ -430,7 +431,23 @@ def test_get_results_data(self):
         results = hook.get_results(query, schema=self.database)
         self.assertListEqual(results['data'], [(1, 1), (2, 2)])
 
-    def test_to_csv(self):
+    @unittest.skipIf(NOT_ASSERTLOGS_VERSION < 3.4, 'assertLogs not support before python 3.4')
+    def test_to_csv_assertlogs(self):
+        hook = HiveServer2Hook()
+        query = "SELECT * FROM {}".format(self.table)
+        csv_filepath = 'query_results.csv'
+        with self.assertLogs() as cm:
+            hook.to_csv(query, csv_filepath, schema=self.database,
+                        delimiter=',', lineterminator='\n', output_header=True, fetch_size=2)
+            df = pd.read_csv(csv_filepath, sep=',')
+            self.assertListEqual(df.columns.tolist(), self.columns)
+            self.assertListEqual(df[self.columns[0]].values.tolist(), [1, 2])
+            self.assertEqual(len(df), 2)
+            self.assertIn('INFO:airflow.hooks.hive_hooks.HiveServer2Hook:'
+                          'Written 2 rows so far.', cm.output)
+
+    @unittest.skipIf(NOT_ASSERTLOGS_VERSION >= 3.4, 'test could cover by test_to_csv_assertLogs')
+    def test_to_csv_without_assertlogs(self):
         hook = HiveServer2Hook()
         query = "SELECT * FROM {}".format(self.table)
         csv_filepath = 'query_results.csv'

From 0196b5f05f1032621024389b6a089aedc3921b69 Mon Sep 17 00:00:00 2001
From: Vardan Gupta <vardanguptacse@gmail.com>
Date: Fri, 1 Mar 2019 17:39:36 +0530
Subject: [PATCH 618/808] [AIRFLOW-3962] Added graceful handling for creation
 of dag_run of a dag which doesn't have any task (#4781)

---
 airflow/jobs.py    |  4 ++--
 tests/test_jobs.py | 14 ++++++++++++++
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 9b71854d4dcdf..691c5d361706f 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -872,8 +872,8 @@ def create_dag_run(self, dag, session=None):
                     dag.start_date, next_run_date
                 )
 
-            # don't ever schedule in the future
-            if next_run_date > timezone.utcnow():
+            # don't ever schedule in the future or if next_run_date is None
+            if not next_run_date or next_run_date > timezone.utcnow():
                 return
 
             # this structure is necessary to avoid a TypeError from concatenating
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 30428b32a574a..8203cdab675e4 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -2659,6 +2659,20 @@ def test_scheduler_do_not_schedule_too_early(self):
 
         queue.put.assert_not_called()
 
+    def test_scheduler_do_not_schedule_without_tasks(self):
+        dag = DAG(
+            dag_id='test_scheduler_do_not_schedule_without_tasks',
+            start_date=DEFAULT_DATE)
+
+        with create_session() as session:
+            orm_dag = DagModel(dag_id=dag.dag_id)
+            session.merge(orm_dag)
+            scheduler = SchedulerJob()
+            dag.clear(session=session)
+            dag.start_date = None
+            dr = scheduler.create_dag_run(dag, session=session)
+            self.assertIsNone(dr)
+
     def test_scheduler_do_not_run_finished(self):
         dag = DAG(
             dag_id='test_scheduler_do_not_run_finished',

From f559d43abf4e53a3a7afbfba4b3469ffddf9182c Mon Sep 17 00:00:00 2001
From: fenglu-g <fenglu@google.com>
Date: Fri, 1 Mar 2019 09:41:27 -0800
Subject: [PATCH 619/808] [AIRFLOW-2511] Fix improper failed session commit
 handling causing deadlocks (#4769)

---
 airflow/jobs.py | 254 ++++++++++++++++++++++++------------------------
 1 file changed, 128 insertions(+), 126 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 691c5d361706f..3cd461863aa44 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -2179,147 +2179,149 @@ def _process_backfill_task_instances(self,
             # or leaf to root, as otherwise tasks might be
             # determined deadlocked while they are actually
             # waiting for their upstream to finish
+            @provide_session
+            def _per_task_process(task, key, ti, session=None):
+                if task.task_id != ti.task_id:
+                    return
 
-            for task in self.dag.topological_sort():
-                for key, ti in list(ti_status.to_run.items()):
-
-                    if task.task_id != ti.task_id:
-                        continue
-
-                    ti.refresh_from_db()
+                ti.refresh_from_db()
 
-                    task = self.dag.get_task(ti.task_id)
-                    ti.task = task
+                task = self.dag.get_task(ti.task_id)
+                ti.task = task
 
-                    ignore_depends_on_past = (
-                        self.ignore_first_depends_on_past and
-                        ti.execution_date == (start_date or ti.start_date))
-                    self.log.debug(
-                        "Task instance to run %s state %s", ti, ti.state)
+                ignore_depends_on_past = (
+                    self.ignore_first_depends_on_past and
+                    ti.execution_date == (start_date or ti.start_date))
+                self.log.debug(
+                    "Task instance to run %s state %s", ti, ti.state)
+
+                # The task was already marked successful or skipped by a
+                # different Job. Don't rerun it.
+                if ti.state == State.SUCCESS:
+                    ti_status.succeeded.add(key)
+                    self.log.debug("Task instance %s succeeded. Don't rerun.", ti)
+                    ti_status.to_run.pop(key)
+                    if key in ti_status.running:
+                        ti_status.running.pop(key)
+                    return
+                elif ti.state == State.SKIPPED:
+                    ti_status.skipped.add(key)
+                    self.log.debug("Task instance %s skipped. Don't rerun.", ti)
+                    ti_status.to_run.pop(key)
+                    if key in ti_status.running:
+                        ti_status.running.pop(key)
+                    return
 
-                    # The task was already marked successful or skipped by a
-                    # different Job. Don't rerun it.
-                    if ti.state == State.SUCCESS:
-                        ti_status.succeeded.add(key)
-                        self.log.debug("Task instance %s succeeded. Don't rerun.", ti)
-                        ti_status.to_run.pop(key)
+                # guard against externally modified tasks instances or
+                # in case max concurrency has been reached at task runtime
+                elif ti.state == State.NONE:
+                    self.log.warning(
+                        "FIXME: task instance {} state was set to None "
+                        "externally. This should not happen"
+                    )
+                    ti.set_state(State.SCHEDULED, session=session)
+                if self.rerun_failed_tasks:
+                    # Rerun failed tasks or upstreamed failed tasks
+                    if ti.state in (State.FAILED, State.UPSTREAM_FAILED):
+                        self.log.error("Task instance {ti} "
+                                       "with state {state}".format(ti=ti,
+                                                                   state=ti.state))
                         if key in ti_status.running:
                             ti_status.running.pop(key)
-                        continue
-                    elif ti.state == State.SKIPPED:
-                        ti_status.skipped.add(key)
-                        self.log.debug("Task instance %s skipped. Don't rerun.", ti)
+                        # Reset the failed task in backfill to scheduled state
+                        ti.set_state(State.SCHEDULED, session=session)
+                else:
+                    # Default behaviour which works for subdag.
+                    if ti.state in (State.FAILED, State.UPSTREAM_FAILED):
+                        self.log.error("Task instance {ti} "
+                                       "with {state} state".format(ti=ti,
+                                                                   state=ti.state))
+                        ti_status.failed.add(key)
                         ti_status.to_run.pop(key)
                         if key in ti_status.running:
                             ti_status.running.pop(key)
-                        continue
+                        return
 
-                    # guard against externally modified tasks instances or
-                    # in case max concurrency has been reached at task runtime
-                    elif ti.state == State.NONE:
-                        self.log.warning(
-                            "FIXME: task instance {} state was set to None "
-                            "externally. This should not happen"
-                        )
-                        ti.set_state(State.SCHEDULED, session=session)
-                    if self.rerun_failed_tasks:
-                        # Rerun failed tasks or upstreamed failed tasks
-                        if ti.state in (State.FAILED, State.UPSTREAM_FAILED):
-                            self.log.error("Task instance {ti} "
-                                           "with state {state}".format(ti=ti,
-                                                                       state=ti.state))
-                            if key in ti_status.running:
-                                ti_status.running.pop(key)
-                            # Reset the failed task in backfill to scheduled state
-                            ti.set_state(State.SCHEDULED, session=session)
-                    else:
-                        # Default behaviour which works for subdag.
-                        if ti.state in (State.FAILED, State.UPSTREAM_FAILED):
-                            self.log.error("Task instance {ti} "
-                                           "with {state} state".format(ti=ti,
-                                                                       state=ti.state))
-                            ti_status.failed.add(key)
+                backfill_context = DepContext(
+                    deps=RUN_DEPS,
+                    ignore_depends_on_past=ignore_depends_on_past,
+                    ignore_task_deps=self.ignore_task_deps,
+                    flag_upstream_failed=True)
+
+                # Is the task runnable? -- then run it
+                # the dependency checker can change states of tis
+                if ti.are_dependencies_met(
+                        dep_context=backfill_context,
+                        session=session,
+                        verbose=self.verbose):
+                    ti.refresh_from_db(lock_for_update=True, session=session)
+                    if ti.state in (State.SCHEDULED, State.UP_FOR_RETRY, State.UP_FOR_RESCHEDULE):
+                        if executor.has_task(ti):
+                            self.log.debug(
+                                "Task Instance %s already in executor "
+                                "waiting for queue to clear",
+                                ti
+                            )
+                        else:
+                            self.log.debug('Sending %s to executor', ti)
+                            # Skip scheduled state, we are executing immediately
+                            ti.state = State.QUEUED
+                            ti.queued_dttm = timezone.utcnow() if not ti.queued_dttm else ti.queued_dttm
+                            session.merge(ti)
+
+                            cfg_path = None
+                            if executor.__class__ in (executors.LocalExecutor,
+                                                      executors.SequentialExecutor):
+                                cfg_path = tmp_configuration_copy()
+
+                            executor.queue_task_instance(
+                                ti,
+                                mark_success=self.mark_success,
+                                pickle_id=pickle_id,
+                                ignore_task_deps=self.ignore_task_deps,
+                                ignore_depends_on_past=ignore_depends_on_past,
+                                pool=self.pool,
+                                cfg_path=cfg_path)
+                            ti_status.running[key] = ti
                             ti_status.to_run.pop(key)
-                            if key in ti_status.running:
-                                ti_status.running.pop(key)
-                            continue
-
-                    backfill_context = DepContext(
-                        deps=RUN_DEPS,
-                        ignore_depends_on_past=ignore_depends_on_past,
-                        ignore_task_deps=self.ignore_task_deps,
-                        flag_upstream_failed=True)
-
-                    # Is the task runnable? -- then run it
-                    # the dependency checker can change states of tis
-                    if ti.are_dependencies_met(
-                            dep_context=backfill_context,
-                            session=session,
-                            verbose=self.verbose):
-                        ti.refresh_from_db(lock_for_update=True, session=session)
-                        if ti.state in (State.SCHEDULED, State.UP_FOR_RETRY, State.UP_FOR_RESCHEDULE):
-                            if executor.has_task(ti):
-                                self.log.debug(
-                                    "Task Instance %s already in executor "
-                                    "waiting for queue to clear",
-                                    ti
-                                )
-                            else:
-                                self.log.debug('Sending %s to executor', ti)
-                                # Skip scheduled state, we are executing immediately
-                                ti.state = State.QUEUED
-                                ti.queued_dttm = timezone.utcnow() if not ti.queued_dttm else ti.queued_dttm
-                                session.merge(ti)
-
-                                cfg_path = None
-                                if executor.__class__ in (executors.LocalExecutor,
-                                                          executors.SequentialExecutor):
-                                    cfg_path = tmp_configuration_copy()
-
-                                executor.queue_task_instance(
-                                    ti,
-                                    mark_success=self.mark_success,
-                                    pickle_id=pickle_id,
-                                    ignore_task_deps=self.ignore_task_deps,
-                                    ignore_depends_on_past=ignore_depends_on_past,
-                                    pool=self.pool,
-                                    cfg_path=cfg_path)
-                                ti_status.running[key] = ti
-                                ti_status.to_run.pop(key)
-                        session.commit()
-                        continue
+                    session.commit()
+                    return
 
-                    if ti.state == State.UPSTREAM_FAILED:
-                        self.log.error("Task instance %s upstream failed", ti)
-                        ti_status.failed.add(key)
-                        ti_status.to_run.pop(key)
-                        if key in ti_status.running:
-                            ti_status.running.pop(key)
-                        continue
+                if ti.state == State.UPSTREAM_FAILED:
+                    self.log.error("Task instance %s upstream failed", ti)
+                    ti_status.failed.add(key)
+                    ti_status.to_run.pop(key)
+                    if key in ti_status.running:
+                        ti_status.running.pop(key)
+                    return
 
-                    # special case
-                    if ti.state == State.UP_FOR_RETRY:
-                        self.log.debug(
-                            "Task instance %s retry period not "
-                            "expired yet", ti)
-                        if key in ti_status.running:
-                            ti_status.running.pop(key)
-                        ti_status.to_run[key] = ti
-                        continue
+                # special case
+                if ti.state == State.UP_FOR_RETRY:
+                    self.log.debug(
+                        "Task instance %s retry period not "
+                        "expired yet", ti)
+                    if key in ti_status.running:
+                        ti_status.running.pop(key)
+                    ti_status.to_run[key] = ti
+                    return
 
-                    # special case
-                    if ti.state == State.UP_FOR_RESCHEDULE:
-                        self.log.debug(
-                            "Task instance %s reschedule period not "
-                            "expired yet", ti)
-                        if key in ti_status.running:
-                            ti_status.running.pop(key)
-                        ti_status.to_run[key] = ti
-                        continue
+                # special case
+                if ti.state == State.UP_FOR_RESCHEDULE:
+                    self.log.debug(
+                        "Task instance %s reschedule period not "
+                        "expired yet", ti)
+                    if key in ti_status.running:
+                        ti_status.running.pop(key)
+                    ti_status.to_run[key] = ti
+                    return
+
+                # all remaining tasks
+                self.log.debug('Adding %s to not_ready', ti)
+                ti_status.not_ready.add(key)
 
-                    # all remaining tasks
-                    self.log.debug('Adding %s to not_ready', ti)
-                    ti_status.not_ready.add(key)
+            for task in self.dag.topological_sort():
+                for key, ti in list(ti_status.to_run.items()):
+                    _per_task_process(task, key, ti)
 
             # execute the tasks in the queue
             self.heartbeat()

From 9bdb7d6fbcabf4b90710a33019ef733b7a908612 Mon Sep 17 00:00:00 2001
From: Chen Tong <cixuuz@gmail.com>
Date: Sat, 2 Mar 2019 02:13:57 -0500
Subject: [PATCH 620/808] [AIRFLOW-3977] Add examples of trigger rules in doc
 (#4805)

The current LatestOnlyOperator will skip all downstream tasks blindly.
The doc shows a wrong behavior. It also shows an incorrect example about
the interaction between skipped tasks and trigger rules. I replace it with
another example using BranchingOperator in schedule level.

This fix can resolve this ticket:
https://issues.apache.org/jira/browse/AIRFLOW-3977
Also,
https://issues.apache.org/jira/browse/AIRFLOW-1784
---
 docs/concepts.rst                     |  88 ++++++++++++++++++++------
 docs/img/branch_with_trigger.png      | Bin 0 -> 34081 bytes
 docs/img/branch_without_trigger.png   | Bin 0 -> 39815 bytes
 docs/img/latest_only_with_trigger.png | Bin 40034 -> 49510 bytes
 4 files changed, 68 insertions(+), 20 deletions(-)
 create mode 100644 docs/img/branch_with_trigger.png
 create mode 100644 docs/img/branch_without_trigger.png

diff --git a/docs/concepts.rst b/docs/concepts.rst
index 790247ec07cac..0ac187fe859e9 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -642,6 +642,67 @@ Note that these can be used in conjunction with ``depends_on_past`` (boolean)
 that, when set to ``True``, keeps a task from getting triggered if the
 previous schedule for the task hasn't succeeded.
 
+One must be aware of the interaction between trigger rules and skipped tasks
+in schedule level. Skipped tasks will cascade through trigger rules 
+``all_success`` and ``all_failed`` but not ``all_done``, ``one_failed``, ``one_success``,
+``none_failed`` and ``dummy``. 
+
+For example, consider the following DAG:
+
+.. code:: python
+
+  #dags/branch_without_trigger.py
+  import datetime as dt  
+  
+  from airflow.models import DAG
+  from airflow.operators.dummy_operator import DummyOperator
+  from airflow.operators.python_operator import BranchPythonOperator  
+  
+  dag = DAG(
+      dag_id='branch_without_trigger',
+      schedule_interval='@once',
+      start_date=dt.datetime(2019, 2, 28)
+  )  
+  
+  run_this_first = DummyOperator(task_id='run_this_first', dag=dag)  
+  branching = BranchPythonOperator(
+      task_id='branching', dag=dag,
+      python_callable=lambda: 'branch_a'
+  )  
+  
+  branch_a = DummyOperator(task_id='branch_a', dag=dag)
+  follow_branch_a = DummyOperator(task_id='follow_branch_a', dag=dag)  
+  
+  branch_false = DummyOperator(task_id='branch_false', dag=dag)  
+  
+  join = DummyOperator(task_id='join', dag=dag)  
+  
+  run_this_first >> branching
+  branching >> branch_a >> follow_branch_a >> join
+  branching >> branch_false >> join
+
+In the case of this DAG, ``join`` is downstream of ``follow_branch_a`` 
+and ``branch_false``. The ``join`` task will show up as skipped 
+because its ``trigger_rule`` is set to ``all_success`` by default and 
+skipped tasks will cascade through ``all_success``. 
+
+.. image:: img/branch_without_trigger.png
+
+By setting ``trigger_rule`` to ``none_failed`` in ``join`` task, 
+
+.. code:: python
+  
+  #dags/branch_with_trigger.py
+  ...
+  join = DummyOperator(task_id='join', dag=dag, trigger_rule='none_failed')
+  ...
+
+The ``join`` task will be triggered as soon as 
+``branch_false`` has been skipped (a valid completion state) and 
+``follow_branch_a`` has succeeded. Because skipped tasks **will not** 
+cascade through ``none_failed``. 
+
+.. image:: img/branch_with_trigger.png
 
 Latest Run Only
 ===============
@@ -654,21 +715,9 @@ a pause just wastes CPU cycles.
 
 For situations like this, you can use the ``LatestOnlyOperator`` to skip
 tasks that are not being run during the most recent scheduled run for a
-DAG. The ``LatestOnlyOperator`` skips all immediate downstream tasks, and
-itself, if the time right now is not between its ``execution_time`` and the
-next scheduled ``execution_time``.
-
-One must be aware of the interaction between skipped tasks and trigger
-rules. Skipped tasks will cascade through trigger rules ``all_success``
-and ``all_failed`` but not ``all_done``, ``one_failed``, ``one_success``,
-and ``dummy``. If you would like to use the ``LatestOnlyOperator`` with
-trigger rules that do not cascade skips, you will need to ensure that the
-``LatestOnlyOperator`` is **directly** upstream of the task you would like
-to skip.
-
-It is possible, through use of trigger rules to mix tasks that should run
-in the typical date/time dependent mode and those using the
-``LatestOnlyOperator``.
+DAG. The ``LatestOnlyOperator`` skips all downstream tasks, if the time 
+right now is not between its ``execution_time`` and the next scheduled 
+``execution_time``.
 
 For example, consider the following dag:
 
@@ -685,8 +734,8 @@ For example, consider the following dag:
 
   dag = DAG(
       dag_id='latest_only_with_trigger',
-      schedule_interval=dt.timedelta(hours=4),
-      start_date=dt.datetime(2016, 9, 20),
+      schedule_interval=dt.timedelta(hours=1),
+      start_date=dt.datetime(2019, 2, 28),
   )
 
   latest_only = LatestOnlyOperator(task_id='latest_only', dag=dag)
@@ -710,9 +759,8 @@ for all runs except the latest run. ``task1`` is directly downstream of
 scheduled periods. ``task3`` is downstream of ``task1`` and ``task2`` and
 because of the default ``trigger_rule`` being ``all_success`` will receive
 a cascaded skip from ``task1``. ``task4`` is downstream of ``task1`` and
-``task2`` but since its ``trigger_rule`` is set to ``all_done`` it will
-trigger as soon as ``task1`` has been skipped (a valid completion state)
-and ``task2`` has succeeded.
+``task2``. It will be first skipped directly by ``LatestOnlyOperator``, 
+even its ``trigger_rule`` is set to ``all_done``.
 
 .. image:: img/latest_only_with_trigger.png
 
diff --git a/docs/img/branch_with_trigger.png b/docs/img/branch_with_trigger.png
new file mode 100644
index 0000000000000000000000000000000000000000..0aab8a1b3a5c88ab876394ac92de8bb00b80dfd4
GIT binary patch
literal 34081
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
a3%Kkvk!<5;@iG|jPfSQ!u=2C6|NjB|Ed7W8

literal 0
HcmV?d00001

diff --git a/docs/img/branch_without_trigger.png b/docs/img/branch_without_trigger.png
new file mode 100644
index 0000000000000000000000000000000000000000..748c796a4981f1a722f92802038b88fbfebe6b5e
GIT binary patch
literal 39815
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
GXaWEOl!3MY

literal 0
HcmV?d00001

diff --git a/docs/img/latest_only_with_trigger.png b/docs/img/latest_only_with_trigger.png
index 629adfa9079643d9989ffe46a8415b7df8d829c4..623f8ee177ff000b4d4ecfaf8368976061406da8 100644
GIT binary patch
literal 49510
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
Wm?95^6-R7=Uz)0VD)~wmZv6+}uE`Am

literal 40034
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


From 4579a007ef10280c05cc6d33ce0eed0fb8b50508 Mon Sep 17 00:00:00 2001
From: Ping Zhang <pingzh@umich.edu>
Date: Thu, 3 Jan 2019 20:40:58 -0800
Subject: [PATCH 621/808] [AIRFLOW-3623] Support download logs by attempts from
 UI (#4425)

---
 airflow/utils/helpers.py                     | 20 +++++++++
 airflow/www/templates/airflow/dag.html       | 44 ++++++++++++++++----
 airflow/www/templates/airflow/tree.html      |  4 +-
 airflow/www/views.py                         | 27 +++++++++---
 airflow/www_rbac/templates/airflow/dag.html  | 41 +++++++++++++++---
 airflow/www_rbac/templates/airflow/tree.html |  4 +-
 airflow/www_rbac/views.py                    | 26 +++++++++---
 tests/utils/test_helpers.py                  | 25 ++++++++++-
 tests/www/test_views.py                      | 22 ++++++++++
 tests/www_rbac/test_views.py                 | 22 ++++++++++
 10 files changed, 207 insertions(+), 28 deletions(-)

diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 36648825ef639..06229079338b9 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -415,3 +415,23 @@ def __getattr__(self, attribute):
             return loaded_attribute
 
         raise AttributeError
+
+
+def render_log_filename(ti, try_number, filename_template):
+    """
+    Given task instance, try_number, filename_template, return the rendered log filename
+
+    :param ti: task instance
+    :param try_number: try_number of the task
+    :param filename_template: filename template, which can be jinja template or python string template
+    """
+    filename_template, filename_jinja_template = parse_template_string(filename_template)
+    if filename_jinja_template:
+        jinja_context = ti.get_template_context()
+        jinja_context['try_number'] = try_number
+        return filename_jinja_template.render(**jinja_context)
+
+    return filename_template.format(dag_id=ti.dag_id,
+                                    task_id=ti.task_id,
+                                    execution_date=ti.execution_date.isoformat(),
+                                    try_number=try_number)
diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 2d197168a6ebc..05762b41f673f 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -153,6 +153,12 @@ <h4 class="modal-title" id="myModalLabel">
             View Log
           </button>
           <hr/>
+          <div>
+            <label style="display:inline"> Download Log (by attempts): </label>
+            <ul class="nav nav-pills" role="tablist" id="try_index" style="display:inline">
+            </ul>
+          </div>
+          <hr/>
           <button id="btn_run" type="button" class="btn btn-primary"
             title="Runs a single task instance">
             Run
@@ -309,7 +315,7 @@ <h4 class="modal-title" id="dagModalLabel">
     var task_id = '';
     var exection_date = '';
     var subdag_id = '';
-    function call_modal(t, d, sd) {
+    function call_modal(t, d, try_numbers, sd) {
       task_id = t;
       loc = String(window.location);
       $("#btn_filter").on("click", function(){
@@ -321,12 +327,35 @@ <h4 class="modal-title" id="dagModalLabel">
       $('#execution_date').html(d);
       $('#myModal').modal({});
       $("#myModal").css("margin-top","0px")
-        if (subdag_id===undefined)
-            $("#div_btn_subdag").hide();
-        else {
-            $("#div_btn_subdag").show();
-            subdag_id = "{{ dag.dag_id }}."+t;
+      if (subdag_id === undefined)
+          $("#div_btn_subdag").hide();
+      else {
+          $("#div_btn_subdag").show();
+          subdag_id = "{{ dag.dag_id }}."+t;
+      }
+
+      $("#try_index > li").remove();
+      var startIndex = (try_numbers > 2 ? 0 : 1);
+      for (var index = startIndex; index <  try_numbers; index++) {
+        var url = "{{ url_for('airflow.get_logs_with_metadata') }}" +
+          "?dag_id=" + encodeURIComponent(dag_id) +
+          "&task_id=" + encodeURIComponent(task_id) +
+          "&execution_date=" + encodeURIComponent(execution_date) +
+          "&metadata=null" +
+          "&format=file";
+
+        var showLabel = index;
+        if (index != 0) {
+          url += "&try_number=" + index;
+        } else {
+          showLabel = 'All';
         }
+
+        $("#try_index").append(`<li role="presentation" style="display:inline">
+          <a href="${url}"> ${showLabel} </a>
+          </li>`
+        );
+      }
     }
 
     function call_modal_dag(dag) {
@@ -367,7 +396,8 @@ <h4 class="modal-title" id="dagModalLabel">
       url = "{{ url_for('airflow.log') }}" +
         "?task_id=" + encodeURIComponent(task_id) +
         "&dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date);
+        "&execution_date=" + encodeURIComponent(execution_date) +
+        "&format=json";
       window.location = url;
     });
 
diff --git a/airflow/www/templates/airflow/tree.html b/airflow/www/templates/airflow/tree.html
index 8e95de239ac24..49db8071133ad 100644
--- a/airflow/www/templates/airflow/tree.html
+++ b/airflow/www/templates/airflow/tree.html
@@ -232,9 +232,9 @@
         if(d.task_id === undefined)
             call_modal_dag(d);
         else if(nodeobj[d.task_id].operator=='SubDagOperator')
-            call_modal(d.task_id, d.execution_date, true);
+            call_modal(d.task_id, d.execution_date, d.try_number, true);
         else
-            call_modal(d.task_id, d.execution_date);
+            call_modal(d.task_id, d.execution_date, d.try_number);
       })
       .attr("class", function(d) {return "state " + d.state})
       .attr("data-toggle", "tooltip")
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 398c223f29516..f0c1a5b48e669 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -38,7 +38,7 @@
 import sqlalchemy as sqla
 from flask import (
     abort, jsonify, redirect, url_for, request, Markup, Response,
-    current_app, render_template, make_response)
+    current_app, render_template, make_response, send_file)
 from flask import flash
 from flask._compat import PY2
 from flask_admin import BaseView, expose, AdminIndexView
@@ -72,7 +72,7 @@
 from airflow.utils import timezone
 from airflow.utils.dates import infer_time_unit, scale_time_units, parse_execution_date
 from airflow.utils.db import create_session, provide_session
-from airflow.utils.helpers import alchemy_to_dict
+from airflow.utils.helpers import alchemy_to_dict, render_log_filename
 from airflow.utils.json import json_ser
 from airflow.utils.net import get_hostname
 from airflow.utils.state import State
@@ -82,6 +82,10 @@
 from airflow.www.forms import (DateTimeForm, DateTimeWithNumRunsForm,
                                DateTimeWithNumRunsWithDagRunsForm)
 from airflow.www.validators import GreaterEqualThan
+if PY2:
+    from cStringIO import StringIO
+else:
+    from io import StringIO
 
 QUERY_LIMIT = 100000
 CHART_LIMIT = 200000
@@ -768,7 +772,12 @@ def get_logs_with_metadata(self, session=None):
         task_id = request.args.get('task_id')
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
-        try_number = int(request.args.get('try_number'))
+        if request.args.get('try_number') is not None:
+            try_number = int(request.args.get('try_number'))
+        else:
+            try_number = None
+        response_format = request.args.get('format', 'json')
+
         metadata = request.args.get('metadata')
         metadata = json.loads(metadata)
 
@@ -810,8 +819,16 @@ def get_logs_with_metadata(self, session=None):
             for i, log in enumerate(logs):
                 if PY2 and not isinstance(log, unicode):
                     logs[i] = log.decode('utf-8')
-            message = logs[0]
-            return jsonify(message=message, metadata=metadata)
+
+            if response_format == 'json':
+                message = logs[0] if try_number is not None else logs
+                return jsonify(message=message, metadata=metadata)
+
+            file_obj = StringIO('\n'.join(logs))
+            filename_template = conf.get('core', 'LOG_FILENAME_TEMPLATE')
+            attachment_filename = render_log_filename(ti, try_number, filename_template)
+            return send_file(file_obj, as_attachment=True,
+                             attachment_filename=attachment_filename)
         except AttributeError as e:
             error_message = ["Task log handler {} does not support read logs.\n{}\n"
                              .format(task_log_reader, str(e))]
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index fe5ffca25a974..58d35ed55e5ba 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -153,6 +153,12 @@ <h4 class="modal-title" id="myModalLabel">
             View Log
           </button>
           <hr/>
+          <div>
+            <label style="display:inline"> Download Log (by attempts): </label>
+            <ul class="nav nav-pills" role="tablist" id="try_index" style="display:inline">
+            </ul>
+          </div>
+          <hr/>
           <button id="btn_run" type="button" class="btn btn-primary"
             title="Runs a single task instance">
             Run
@@ -309,7 +315,7 @@ <h4 class="modal-title" id="dagModalLabel">
     var task_id = '';
     var exection_date = '';
     var subdag_id = '';
-    function call_modal(t, d, sd) {
+    function call_modal(t, d, try_numbers, sd) {
       task_id = t;
       loc = String(window.location);
       $("#btn_filter").on("click", function(){
@@ -321,12 +327,35 @@ <h4 class="modal-title" id="dagModalLabel">
       $('#execution_date').html(d);
       $('#myModal').modal({});
       $("#myModal").css("margin-top","0px")
-        if (subdag_id===undefined)
-            $("#div_btn_subdag").hide();
-        else {
-            $("#div_btn_subdag").show();
-            subdag_id = "{{ dag.dag_id }}."+t;
+      if (subdag_id === undefined)
+          $("#div_btn_subdag").hide();
+      else {
+          $("#div_btn_subdag").show();
+          subdag_id = "{{ dag.dag_id }}."+t;
+      }
+
+      $("#try_index > li").remove();
+      var startIndex = (try_numbers > 2 ? 0 : 1)
+      for (var index = startIndex; index <  try_numbers; index++) {
+        var url = "{{ url_for('Airflow.get_logs_with_metadata') }}" +
+          "?dag_id=" + encodeURIComponent(dag_id) +
+          "&task_id=" + encodeURIComponent(task_id) +
+          "&execution_date=" + encodeURIComponent(execution_date) +
+          "&metadata=null" +
+          "&format=file";
+
+        var showLabel = index;
+        if (index != 0) {
+          url += "&try_number=" + index;
+        } else {
+          showLabel = 'All';
         }
+
+        $("#try_index").append(`<li role="presentation" style="display:inline">
+          <a href="${url}"> ${showLabel} </a>
+          </li>`
+        );
+      }
     }
 
     function call_modal_dag(dag) {
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index d419eeb2baac3..1e20152568af4 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -234,9 +234,9 @@
         if(d.task_id === undefined)
             call_modal_dag(d);
         else if(nodeobj[d.task_id].operator=='SubDagOperator')
-            call_modal(d.task_id, d.execution_date, true);
+            call_modal(d.task_id, d.execution_date, d.try_number, true);
         else
-            call_modal(d.task_id, d.execution_date);
+            call_modal(d.task_id, d.execution_date, d.try_number);
       })
       .attr("class", function(d) {return "state " + d.state})
       .attr("data-toggle", "tooltip")
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 8fd38179c78c2..e15f5fac0bf85 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -35,7 +35,7 @@
 import sqlalchemy as sqla
 from flask import (
     redirect, request, Markup, Response, render_template,
-    make_response, flash, jsonify, url_for)
+    make_response, flash, jsonify, send_file, url_for)
 from flask._compat import PY2
 from flask_appbuilder import BaseView, ModelView, expose, has_access
 from flask_appbuilder.actions import action
@@ -58,7 +58,7 @@
 from airflow.utils import timezone
 from airflow.utils.dates import infer_time_unit, scale_time_units
 from airflow.utils.db import provide_session
-from airflow.utils.helpers import alchemy_to_dict
+from airflow.utils.helpers import alchemy_to_dict, render_log_filename
 from airflow.utils.json import json_ser
 from airflow.utils.state import State
 from airflow._vendor import nvd3
@@ -69,6 +69,10 @@
                                     DateTimeWithNumRunsWithDagRunsForm,
                                     DagRunForm, ConnectionForm)
 from airflow.www_rbac.widgets import AirflowModelListWidget
+if PY2:
+    from cStringIO import StringIO
+else:
+    from io import StringIO
 
 
 PAGE_SIZE = conf.getint('webserver', 'page_size')
@@ -535,9 +539,13 @@ def get_logs_with_metadata(self, session=None):
         task_id = request.args.get('task_id')
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
-        try_number = int(request.args.get('try_number'))
+        if request.args.get('try_number') is not None:
+            try_number = int(request.args.get('try_number'))
+        else:
+            try_number = None
         metadata = request.args.get('metadata')
         metadata = json.loads(metadata)
+        response_format = request.args.get('format', 'json')
 
         # metadata may be null
         if not metadata:
@@ -577,8 +585,16 @@ def get_logs_with_metadata(self, session=None):
             for i, log in enumerate(logs):
                 if PY2 and not isinstance(log, unicode):
                     logs[i] = log.decode('utf-8')
-            message = logs[0]
-            return jsonify(message=message, metadata=metadata)
+
+            if response_format == 'json':
+                message = logs[0] if try_number is not None else logs
+                return jsonify(message=message, metadata=metadata)
+
+            file_obj = StringIO('\n'.join(logs))
+            filename_template = conf.get('core', 'LOG_FILENAME_TEMPLATE')
+            attachment_filename = render_log_filename(ti, try_number, filename_template)
+            return send_file(file_obj, as_attachment=True,
+                             attachment_filename=attachment_filename)
         except AttributeError as e:
             error_message = ["Task log handler {} does not support read logs.\n{}\n"
                              .format(task_log_reader, str(e))]
diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index 837a79acbaebb..ec7fc58d3ab32 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -29,8 +29,9 @@
 import six
 
 from airflow import DAG
-from airflow.operators.dummy_operator import DummyOperator
 from airflow.utils import helpers
+from airflow.models import TaskInstance
+from airflow.operators.dummy_operator import DummyOperator
 
 
 class TestHelpers(unittest.TestCase):
@@ -62,6 +63,28 @@ def signal_handler(signum, frame):
         while True:
             time.sleep(1)
 
+    def test_render_log_filename(self):
+        try_number = 1
+        dag_id = 'test_render_log_filename_dag'
+        task_id = 'test_render_log_filename_task'
+        execution_date = datetime(2016, 1, 1)
+
+        dag = DAG(dag_id, start_date=execution_date)
+        task = DummyOperator(task_id=task_id, dag=dag)
+        ti = TaskInstance(task=task, execution_date=execution_date)
+
+        filename_template = "{{ ti.dag_id }}/{{ ti.task_id }}/{{ ts }}/{{ try_number }}.log"
+
+        ts = ti.get_template_context()['ts']
+        expected_filename = "{dag_id}/{task_id}/{ts}/{try_number}.log".format(dag_id=dag_id,
+                                                                              task_id=task_id,
+                                                                              ts=ts,
+                                                                              try_number=try_number)
+
+        rendered_filename = helpers.render_log_filename(ti, try_number, filename_template)
+
+        self.assertEqual(rendered_filename, expected_filename)
+
     def test_reap_process_group(self):
         """
         Spin up a process that can't be killed by SIGTERM and make sure
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 31188ef2439f6..1807d203d7f95 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -387,6 +387,28 @@ def test_get_file_task_log(self):
         self.assertIn('Log by attempts',
                       response.data.decode('utf-8'))
 
+    def test_get_logs_with_metadata_as_download_file(self):
+        url_template = "/admin/airflow/get_logs_with_metadata?dag_id={}&" \
+                       "task_id={}&execution_date={}&" \
+                       "try_number={}&metadata={}&format=file"
+        try_number = 1
+        url = url_template.format(self.DAG_ID,
+                                  self.TASK_ID,
+                                  quote_plus(self.DEFAULT_DATE.isoformat()),
+                                  try_number,
+                                  json.dumps({}))
+        response = self.app.get(url)
+        expected_filename = '{}/{}/{}/{}.log'.format(self.DAG_ID,
+                                                     self.TASK_ID,
+                                                     self.DEFAULT_DATE.isoformat(),
+                                                     try_number)
+
+        self.assertEqual(200, response.status_code)
+        content_disposition = response.headers.get('Content-Disposition')
+        self.assertTrue(content_disposition.startswith('attachment'), content_disposition)
+        self.assertTrue(content_disposition.endswith(expected_filename + '"'), content_disposition)
+        self.assertIn('Log for testing.', response.data.decode('utf-8'))
+
     def test_get_logs_with_metadata(self):
         url_template = "/admin/airflow/get_logs_with_metadata?dag_id={}&" \
                        "task_id={}&execution_date={}&" \
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index c569accacaaa9..4917781c7f1c4 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -664,6 +664,28 @@ def test_get_file_task_log(self, state, try_number, expected_num_logs_visible):
         self.assertNotIn('try-0', response.data.decode('utf-8'))
         self.assertNotIn('try-{}'.format(expected_num_logs_visible + 1), response.data.decode('utf-8'))
 
+    def test_get_logs_with_metadata_as_download_file(self):
+        url_template = "get_logs_with_metadata?dag_id={}&" \
+                       "task_id={}&execution_date={}&" \
+                       "try_number={}&metadata={}&format=file"
+        try_number = 1
+        url = url_template.format(self.DAG_ID,
+                                  self.TASK_ID,
+                                  quote_plus(self.DEFAULT_DATE.isoformat()),
+                                  try_number,
+                                  json.dumps({}))
+        response = self.app.get(url)
+        expected_filename = '{}/{}/{}/{}.log'.format(self.DAG_ID,
+                                                     self.TASK_ID,
+                                                     self.DEFAULT_DATE.isoformat(),
+                                                     try_number)
+
+        content_disposition = response.headers.get('Content-Disposition')
+        self.assertTrue(content_disposition.startswith('attachment'))
+        self.assertTrue(content_disposition.endswith(expected_filename))
+        self.assertEqual(200, response.status_code)
+        self.assertIn('Log for testing.', response.data.decode('utf-8'))
+
     def test_get_logs_with_metadata(self):
         url_template = "get_logs_with_metadata?dag_id={}&" \
                        "task_id={}&execution_date={}&" \

From dc8385b47ffe72569ac4515cfa677829a3a3da20 Mon Sep 17 00:00:00 2001
From: Ping Zhang <pingzh@umich.edu>
Date: Sat, 5 Jan 2019 22:17:11 -0800
Subject: [PATCH 622/808] [AIRFLOW-3636] Fix a test introduced in #4425 (#4446)

---
 tests/www/test_views.py      | 6 +++---
 tests/www_rbac/test_views.py | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 1807d203d7f95..9c7cac16c7231 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -403,10 +403,10 @@ def test_get_logs_with_metadata_as_download_file(self):
                                                      self.DEFAULT_DATE.isoformat(),
                                                      try_number)
 
-        self.assertEqual(200, response.status_code)
         content_disposition = response.headers.get('Content-Disposition')
-        self.assertTrue(content_disposition.startswith('attachment'), content_disposition)
-        self.assertTrue(content_disposition.endswith(expected_filename + '"'), content_disposition)
+        self.assertTrue(content_disposition.startswith('attachment'))
+        self.assertTrue(expected_filename in content_disposition)
+        self.assertEqual(200, response.status_code)
         self.assertIn('Log for testing.', response.data.decode('utf-8'))
 
     def test_get_logs_with_metadata(self):
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 4917781c7f1c4..3c47acfd4fd06 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -674,7 +674,7 @@ def test_get_logs_with_metadata_as_download_file(self):
                                   quote_plus(self.DEFAULT_DATE.isoformat()),
                                   try_number,
                                   json.dumps({}))
-        response = self.app.get(url)
+        response = self.client.get(url)
         expected_filename = '{}/{}/{}/{}.log'.format(self.DAG_ID,
                                                      self.TASK_ID,
                                                      self.DEFAULT_DATE.isoformat(),
@@ -682,7 +682,7 @@ def test_get_logs_with_metadata_as_download_file(self):
 
         content_disposition = response.headers.get('Content-Disposition')
         self.assertTrue(content_disposition.startswith('attachment'))
-        self.assertTrue(content_disposition.endswith(expected_filename))
+        self.assertTrue(expected_filename in content_disposition)
         self.assertEqual(200, response.status_code)
         self.assertIn('Log for testing.', response.data.decode('utf-8'))
 

From 13a40a9ad88d02aeb543643e0ceecfd5c6949159 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 15 Mar 2019 16:02:53 +0000
Subject: [PATCH 623/808] [AIRFLOW-4100] Correctly JSON escape data for
 tree/graph views (#4921)

---
 airflow/www/templates/airflow/gantt.html      |  2 +-
 airflow/www/templates/airflow/graph.html      |  8 ++++----
 airflow/www/templates/airflow/tree.html       |  2 +-
 airflow/www/views.py                          | 13 +++++--------
 airflow/www_rbac/templates/airflow/gantt.html |  2 +-
 airflow/www_rbac/templates/airflow/graph.html |  8 ++++----
 airflow/www_rbac/templates/airflow/tree.html  |  2 +-
 airflow/www_rbac/views.py                     | 13 +++++--------
 8 files changed, 22 insertions(+), 28 deletions(-)

diff --git a/airflow/www/templates/airflow/gantt.html b/airflow/www/templates/airflow/gantt.html
index 01d3cd8cdfcc5..b070409654e08 100644
--- a/airflow/www/templates/airflow/gantt.html
+++ b/airflow/www/templates/airflow/gantt.html
@@ -55,7 +55,7 @@
     var dag_id = '{{ dag.dag_id }}';
     var task_id = '';
     var exection_date = '';
-    data = {{ data |safe }};
+    data = {{ data |tojson|safe }};
     var gantt = d3.gantt()
       .taskTypes(data.taskNames)
       .taskStatus(data.taskStatus)
diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index e7e6325bbb9f7..91dc34fb59e60 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -104,10 +104,10 @@
     var upstream_color = "#2020A0";
     var downstream_color = "#0000FF";
 
-    var nodes = {{ nodes|safe }};
-    var edges = {{ edges|safe }};
-    var tasks = {{ tasks|safe }};
-    var task_instances = {{ task_instances|safe }};
+    var nodes = {{ nodes|tojson|safe }};
+    var edges = {{ edges|tojson|safe }};
+    var tasks = {{ tasks|tojson|safe }};
+    var task_instances = {{ task_instances|tojson|safe }};
     var execution_date = "{{ execution_date }}";
     var arrange = "{{ arrange }}";
     var g = dagreD3.json.decode(nodes, edges);
diff --git a/airflow/www/templates/airflow/tree.html b/airflow/www/templates/airflow/tree.html
index 49db8071133ad..9d116ed5e0916 100644
--- a/airflow/www/templates/airflow/tree.html
+++ b/airflow/www/templates/airflow/tree.html
@@ -79,7 +79,7 @@
 <script>
 $('span.status_square').tooltip({html: true});
 
-var data = {{ data|safe }};
+var data = {{ data|tojson|safe }};
 var barHeight = 20;
 var axisHeight = 40;
 var square_x = 500;
diff --git a/airflow/www/views.py b/airflow/www/views.py
index f0c1a5b48e669..dc7d0b7860a1d 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -73,7 +73,6 @@
 from airflow.utils.dates import infer_time_unit, scale_time_units, parse_execution_date
 from airflow.utils.db import create_session, provide_session
 from airflow.utils.helpers import alchemy_to_dict, render_log_filename
-from airflow.utils.json import json_ser
 from airflow.utils.net import get_hostname
 from airflow.utils.state import State
 from airflow.utils.timezone import datetime
@@ -1501,8 +1500,6 @@ def set_duration(tid):
             'instances': [dag_runs.get(d) or {'execution_date': d.isoformat()} for d in dates],
         }
 
-        # minimize whitespace as this can be huge for bigger dags
-        data = json.dumps(data, default=json_ser, separators=(',', ':'))
         session.commit()
 
         form = DateTimeWithNumRunsForm(data={'base_date': max_date,
@@ -1609,10 +1606,10 @@ class GraphForm(DateTimeWithNumRunsWithDagRunsForm):
             ),
             blur=blur,
             root=root or '',
-            task_instances=json.dumps(task_instances, indent=2),
-            tasks=json.dumps(tasks, indent=2),
-            nodes=json.dumps(nodes, indent=2),
-            edges=json.dumps(edges, indent=2), )
+            task_instances=task_instances,
+            tasks=tasks,
+            nodes=nodes,
+            edges=edges)
 
     @expose('/duration')
     @login_required
@@ -1992,7 +1989,7 @@ def gantt(self, session=None):
             dag=dag,
             execution_date=dttm.isoformat(),
             form=form,
-            data=json.dumps(data, indent=2),
+            data=data,
             base_date='',
             demo_mode=demo_mode,
             root=root,
diff --git a/airflow/www_rbac/templates/airflow/gantt.html b/airflow/www_rbac/templates/airflow/gantt.html
index 64212a5a3c246..7d8135a5da454 100644
--- a/airflow/www_rbac/templates/airflow/gantt.html
+++ b/airflow/www_rbac/templates/airflow/gantt.html
@@ -55,7 +55,7 @@
     var dag_id = '{{ dag.dag_id }}';
     var task_id = '';
     var exection_date = '';
-    data = {{ data |safe }};
+    data = {{ data |tojson|safe }};
     var gantt = d3.gantt()
       .taskTypes(data.taskNames)
       .taskStatus(data.taskStatus)
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 063d6ae3f5843..ddd57c98ef7ad 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -102,14 +102,14 @@
     var initialStrokeWidth = '3px';
     var highlightStrokeWidth = '5px';
 
-    var nodes = {{ nodes|safe }};
-    var edges = {{ edges|safe }};
+    var nodes = {{ nodes|tojson|safe }};
+    var edges = {{ edges|tojson|safe }};
     var execution_date = "{{ execution_date }}";
     var arrange = "{{ arrange }}";
 
     // Below variables are being used in dag.js
-    var tasks = {{ tasks|safe }};
-    var task_instances = {{ task_instances|safe }};
+    var tasks = {{ tasks|tojson|safe }};
+    var task_instances = {{ task_instances|tojson|safe }};
     var getTaskInstanceURL = "{{ url_for('Airflow.task_instances') }}" +
       "?dag_id=" + encodeURIComponent(dag_id) + "&execution_date=" +
       encodeURIComponent(execution_date);
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index 1e20152568af4..87afe2fd14193 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -81,7 +81,7 @@
 <script>
 $('span.status_square').tooltip({html: true});
 
-var data = {{ data|safe }};
+var data = {{ data|tojson|safe }};
 var barHeight = 20;
 var axisHeight = 40;
 var square_x = 500;
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index e15f5fac0bf85..61fa15cd87056 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -59,7 +59,6 @@
 from airflow.utils.dates import infer_time_unit, scale_time_units
 from airflow.utils.db import provide_session
 from airflow.utils.helpers import alchemy_to_dict, render_log_filename
-from airflow.utils.json import json_ser
 from airflow.utils.state import State
 from airflow._vendor import nvd3
 from airflow.www_rbac import utils as wwwutils
@@ -1271,8 +1270,6 @@ def set_duration(tid):
                 for d in dates],
         }
 
-        # minimize whitespace as this can be huge for bigger dags
-        data = json.dumps(data, default=json_ser, separators=(',', ':'))
         session.commit()
 
         form = DateTimeWithNumRunsForm(data={'base_date': max_date,
@@ -1383,10 +1380,10 @@ class GraphForm(DateTimeWithNumRunsWithDagRunsForm):
             ),
             blur=blur,
             root=root or '',
-            task_instances=json.dumps(task_instances, indent=2),
-            tasks=json.dumps(tasks, indent=2),
-            nodes=json.dumps(nodes, indent=2),
-            edges=json.dumps(edges, indent=2), )
+            task_instances=task_instances,
+            tasks=tasks,
+            nodes=nodes,
+            edges=edges)
 
     @expose('/duration')
     @has_dag_access(can_dag_read=True)
@@ -1779,7 +1776,7 @@ def gantt(self, session=None):
             dag=dag,
             execution_date=dttm.isoformat(),
             form=form,
-            data=json.dumps(data, indent=2),
+            data=data,
             base_date='',
             demo_mode=demo_mode,
             root=root,

From 1618ec421b0d85d8c83d3baaf1732d85470925b5 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 20 Mar 2019 08:13:18 +0000
Subject: [PATCH 624/808] [AIRFLOW-3706] Fix tooltip max-width by correcting
 ordering of CSS files (#4947)

The "airflowDefaultTheme.css" file is created by webpack out of
bootstrap-theme.css, which is a "base" file. But this was loaded _after_
Airflow's main.css, meaning the `max-width` we set on `.tooltip-inner`
was being replaced by the default from bootstrap.
---
 airflow/www_rbac/templates/appbuilder/baselayout.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/www_rbac/templates/appbuilder/baselayout.html b/airflow/www_rbac/templates/appbuilder/baselayout.html
index 89e32cae783ec..9cf6145cb8053 100644
--- a/airflow/www_rbac/templates/appbuilder/baselayout.html
+++ b/airflow/www_rbac/templates/appbuilder/baselayout.html
@@ -21,12 +21,12 @@
 {% block head_css %}
   {{ super() }}
 
-  <link href="{{ url_for_asset('main.css') }}" rel="stylesheet">
 
   {% if not appbuilder.app_theme %}
     {# airflowDefaultTheme.css file contains the styles from local bootstrap-theme.css #}
     <link href="{{ url_for_asset('airflowDefaultTheme.css') }}" rel="stylesheet">
   {% endif %}
+  <link href="{{ url_for_asset('main.css') }}" rel="stylesheet">
 
   <link rel="icon" type="image/png" href="{{ url_for('static', filename='pin_30.png') }}">
 {% endblock %}

From b14d070836165d046056f9c6a7d474fbb34aca28 Mon Sep 17 00:00:00 2001
From: Szymon Przedwojski <szymon.przedwojski@gmail.com>
Date: Fri, 22 Feb 2019 15:56:53 +0100
Subject: [PATCH 625/808] [AIRFLOW-3701] Add Google Cloud Vision Product Search
 operators (#4665)

---
 .../example_dags/example_gcp_vision.py        | 245 +++++++
 airflow/contrib/hooks/gcp_vision_hook.py      | 356 +++++++++
 .../contrib/operators/gcp_vision_operator.py  | 673 ++++++++++++++++++
 docs/code.rst                                 |   9 +
 docs/howto/operator.rst                       | 595 +++++++++++++++-
 docs/integration.rst                          |  25 +
 setup.py                                      |   1 +
 tests/contrib/hooks/test_gcp_vision_hook.py   | 548 ++++++++++++++
 .../operators/test_gcp_vision_operator.py     | 234 ++++++
 .../test_gcp_vision_operator_system.py        |  34 +
 tests/contrib/utils/gcp_authenticator.py      |   1 +
 11 files changed, 2720 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_vision.py
 create mode 100644 airflow/contrib/hooks/gcp_vision_hook.py
 create mode 100644 airflow/contrib/operators/gcp_vision_operator.py
 create mode 100644 tests/contrib/hooks/test_gcp_vision_hook.py
 create mode 100644 tests/contrib/operators/test_gcp_vision_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_vision_operator_system.py

diff --git a/airflow/contrib/example_dags/example_gcp_vision.py b/airflow/contrib/example_dags/example_gcp_vision.py
new file mode 100644
index 0000000000000..9ca96012ebb2d
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_vision.py
@@ -0,0 +1,245 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that creates, gets, updates and deletes Products and Product Sets in the Google Cloud
+Vision service in the Google Cloud Platform.
+
+This DAG relies on the following OS environment variables
+
+* GCP_VISION_LOCATION - Google Cloud Platform zone where the instance exists.
+"""
+import os
+
+# [START howto_operator_vision_retry_import]
+from google.api_core.retry import Retry
+# [END howto_operator_vision_retry_import]
+# [START howto_operator_vision_productset_import]
+from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet
+# [END howto_operator_vision_productset_import]
+# [START howto_operator_vision_product_import]
+from google.cloud.vision_v1.proto.product_search_service_pb2 import Product
+# [END howto_operator_vision_product_import]
+
+import airflow
+from airflow import models
+
+from airflow.contrib.operators.gcp_vision_operator import (
+    CloudVisionProductSetCreateOperator,
+    CloudVisionProductSetGetOperator,
+    CloudVisionProductSetUpdateOperator,
+    CloudVisionProductSetDeleteOperator,
+    CloudVisionProductCreateOperator,
+    CloudVisionProductGetOperator,
+    CloudVisionProductUpdateOperator,
+    CloudVisionProductDeleteOperator,
+)
+
+default_args = {'start_date': airflow.utils.dates.days_ago(1)}
+
+# [START howto_operator_vision_args_common]
+GCP_VISION_LOCATION = os.environ.get('GCP_VISION_LOCATION', 'europe-west1')
+# [END howto_operator_vision_args_common]
+
+# [START howto_operator_vision_productset]
+product_set = ProductSet(display_name='My Product Set 1')
+# [END howto_operator_vision_productset]
+
+# [START howto_operator_vision_product]
+product = Product(display_name='My Product 1', product_category='toys')
+# [END howto_operator_vision_product]
+
+# [START howto_operator_vision_productset_explicit_id]
+GCP_VISION_PRODUCT_SET_ID = os.environ.get('GCP_VISION_PRODUCT_SET_ID', 'product_set_explicit_id')
+# [END howto_operator_vision_productset_explicit_id]
+
+# [START howto_operator_vision_product_explicit_id]
+GCP_VISION_PRODUCT_ID = os.environ.get('GCP_VISION_PRODUCT_ID', 'product_explicit_id')
+# [END howto_operator_vision_product_explicit_id]
+
+with models.DAG(
+    'example_gcp_vision', default_args=default_args, schedule_interval=None  # Override to match your needs
+) as dag:
+    # ################################## #
+    # ### Autogenerated IDs examples ### #
+    # ################################## #
+
+    # [START howto_operator_vision_product_set_create]
+    product_set_create = CloudVisionProductSetCreateOperator(
+        location=GCP_VISION_LOCATION,
+        product_set=product_set,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_set_create',
+    )
+    # [END howto_operator_vision_product_set_create]
+
+    # [START howto_operator_vision_product_set_get]
+    product_set_get = CloudVisionProductSetGetOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id="{{ task_instance.xcom_pull('product_set_create') }}",
+        task_id='product_set_get',
+    )
+    # [END howto_operator_vision_product_set_get]
+
+    # [START howto_operator_vision_product_set_update]
+    product_set_update = CloudVisionProductSetUpdateOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id="{{ task_instance.xcom_pull('product_set_create') }}",
+        product_set=ProductSet(display_name='My Product Set 2'),
+        task_id='product_set_update',
+    )
+    # [END howto_operator_vision_product_set_update]
+
+    # [START howto_operator_vision_product_set_delete]
+    product_set_delete = CloudVisionProductSetDeleteOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id="{{ task_instance.xcom_pull('product_set_create') }}",
+        task_id='product_set_delete',
+    )
+    # [END howto_operator_vision_product_set_delete]
+
+    # [START howto_operator_vision_product_create]
+    product_create = CloudVisionProductCreateOperator(
+        location=GCP_VISION_LOCATION,
+        product=product,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_create',
+    )
+    # [END howto_operator_vision_product_create]
+
+    # [START howto_operator_vision_product_get]
+    product_get = CloudVisionProductGetOperator(
+        location=GCP_VISION_LOCATION,
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        task_id='product_get',
+    )
+    # [END howto_operator_vision_product_get]
+
+    # [START howto_operator_vision_product_update]
+    product_update = CloudVisionProductUpdateOperator(
+        location=GCP_VISION_LOCATION,
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        product=Product(display_name='My Product 2', description='My updated description'),
+        task_id='product_update',
+    )
+    # [END howto_operator_vision_product_update]
+
+    # [START howto_operator_vision_product_delete]
+    product_delete = CloudVisionProductDeleteOperator(
+        location=GCP_VISION_LOCATION,
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        task_id='product_delete',
+    )
+    # [END howto_operator_vision_product_delete]
+
+    product_set_create >> product_set_get >> product_set_update >> product_set_delete
+    product_create >> product_get >> product_update >> product_delete
+
+    # ############################# #
+    # ### Explicit IDs examples ### #
+    # ############################# #
+
+    # [START howto_operator_vision_product_set_create_2]
+    product_set_create_2 = CloudVisionProductSetCreateOperator(
+        product_set_id=GCP_VISION_PRODUCT_SET_ID,
+        location=GCP_VISION_LOCATION,
+        product_set=product_set,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_set_create_2',
+    )
+    # [END howto_operator_vision_product_set_create_2]
+
+    # Second 'create' task with the same product_set_id to demonstrate idempotence
+    product_set_create_2_idempotence = CloudVisionProductSetCreateOperator(
+        product_set_id=GCP_VISION_PRODUCT_SET_ID,
+        location=GCP_VISION_LOCATION,
+        product_set=product_set,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_set_create_2_idempotence',
+    )
+
+    # [START howto_operator_vision_product_set_get_2]
+    product_set_get_2 = CloudVisionProductSetGetOperator(
+        location=GCP_VISION_LOCATION, product_set_id=GCP_VISION_PRODUCT_SET_ID, task_id='product_set_get_2'
+    )
+    # [END howto_operator_vision_product_set_get_2]
+
+    # [START howto_operator_vision_product_set_update_2]
+    product_set_update_2 = CloudVisionProductSetUpdateOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id=GCP_VISION_PRODUCT_SET_ID,
+        product_set=ProductSet(display_name='My Product Set 2'),
+        task_id='product_set_update_2',
+    )
+    # [END howto_operator_vision_product_set_update_2]
+
+    # [START howto_operator_vision_product_set_delete_2]
+    product_set_delete_2 = CloudVisionProductSetDeleteOperator(
+        location=GCP_VISION_LOCATION, product_set_id=GCP_VISION_PRODUCT_SET_ID, task_id='product_set_delete_2'
+    )
+    # [END howto_operator_vision_product_set_delete_2]
+
+    # [START howto_operator_vision_product_create_2]
+    product_create_2 = CloudVisionProductCreateOperator(
+        product_id=GCP_VISION_PRODUCT_ID,
+        location=GCP_VISION_LOCATION,
+        product=product,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_create_2',
+    )
+    # [END howto_operator_vision_product_create_2]
+
+    # Second 'create' task with the same product_id to demonstrate idempotence
+    product_create_2_idempotence = CloudVisionProductCreateOperator(
+        product_id=GCP_VISION_PRODUCT_ID,
+        location=GCP_VISION_LOCATION,
+        product=product,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='product_create_2_idempotence',
+    )
+
+    # [START howto_operator_vision_product_get_2]
+    product_get_2 = CloudVisionProductGetOperator(
+        location=GCP_VISION_LOCATION, product_id=GCP_VISION_PRODUCT_ID, task_id='product_get_2'
+    )
+    # [END howto_operator_vision_product_get_2]
+
+    # [START howto_operator_vision_product_update_2]
+    product_update_2 = CloudVisionProductUpdateOperator(
+        location=GCP_VISION_LOCATION,
+        product_id=GCP_VISION_PRODUCT_ID,
+        product=Product(display_name='My Product 2', description='My updated description'),
+        task_id='product_update_2',
+    )
+    # [END howto_operator_vision_product_update_2]
+
+    # [START howto_operator_vision_product_delete_2]
+    product_delete_2 = CloudVisionProductDeleteOperator(
+        location=GCP_VISION_LOCATION, product_id=GCP_VISION_PRODUCT_ID, task_id='product_delete_2'
+    )
+    # [END howto_operator_vision_product_delete_2]
+
+    product_set_create_2 >> product_set_get_2 >> product_set_update_2 >> product_set_delete_2
+    product_create_2 >> product_get_2 >> product_update_2 >> product_delete_2
diff --git a/airflow/contrib/hooks/gcp_vision_hook.py b/airflow/contrib/hooks/gcp_vision_hook.py
new file mode 100644
index 0000000000000..099c21972526d
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_vision_hook.py
@@ -0,0 +1,356 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from copy import deepcopy
+
+from google.api_core.exceptions import AlreadyExists, GoogleAPICallError, RetryError
+from google.cloud.vision_v1 import ProductSearchClient
+from google.protobuf.json_format import MessageToDict
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+
+class NameDeterminer:
+    """
+    Class used for checking if the entity has the 'name' attribute set.
+
+    - If so, no action is taken.
+    - If not, and the name can be constructed from other parameters provided, it is created and filled in
+      the entity.
+    - If both the entity's 'name' attribute is set and the name can be constructed from other parameters
+      provided:
+        - If they are the same: no action is taken.
+        - If they are different: an exception is thrown.
+    """
+
+    def __init__(self, label, id_label, get_path):
+        self.label = label
+        self.id_label = id_label
+        self.get_path = get_path
+
+    def get_entity_with_name(self, entity, entity_id, location, project_id):
+        entity = deepcopy(entity)
+        explicit_name = getattr(entity, 'name')
+        if location and entity_id:
+            # Necessary parameters to construct the name are present. Checking for conflict with explicit name
+            constructed_name = self.get_path(project_id, location, entity_id)
+            if not explicit_name:
+                entity.name = constructed_name
+                return entity
+            elif explicit_name != constructed_name:
+                self._raise_ex_different_names(constructed_name, explicit_name)
+        else:
+            # Not enough parameters to construct the name. Trying to use the name from Product / ProductSet.
+            if explicit_name:
+                return entity
+            else:
+                self._raise_ex_unable_to_determine_name()
+
+    def _raise_ex_unable_to_determine_name(self):
+        raise AirflowException(
+            "Unable to determine the {label} name. Please either set the name directly in the {label} "
+            "object or provide the `location` and `{id_label}` parameters.".format(
+                label=self.label, id_label=self.id_label
+            )
+        )
+
+    def _raise_ex_different_names(self, constructed_name, explicit_name):
+        raise AirflowException(
+            "The {label} name provided in the object ({explicit_name}) is different than the name created "
+            "from the input parameters ({constructed_name}). Please either: 1) Remove the {label} name, 2) "
+            "Remove the location and {id_label} parameters, 3) Unify the {label} name and input "
+            "parameters.".format(
+                label=self.label,
+                explicit_name=explicit_name,
+                constructed_name=constructed_name,
+                id_label=self.id_label,
+            )
+        )
+
+
+class CloudVisionHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud Vision APIs.
+    """
+
+    _client = None
+    product_name_determiner = NameDeterminer('Product', 'product_id', ProductSearchClient.product_path)
+    product_set_name_determiner = NameDeterminer(
+        'ProductSet', 'productset_id', ProductSearchClient.product_set_path
+    )
+
+    def __init__(self, gcp_conn_id='google_cloud_default', delegate_to=None):
+        super(CloudVisionHook, self).__init__(gcp_conn_id, delegate_to)
+
+    def get_conn(self):
+        """
+        Retrieves connection to Cloud Vision.
+
+        :return: Google Cloud Vision client object.
+        :rtype: google.cloud.vision_v1.ProductSearchClient
+        """
+        if not self._client:
+            self._client = ProductSearchClient(credentials=self._get_credentials())
+        return self._client
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_product_set(
+        self,
+        location,
+        product_set,
+        project_id=None,
+        product_set_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+        """
+        client = self.get_conn()
+        parent = ProductSearchClient.location_path(project_id, location)
+        self.log.info('Creating a new ProductSet under the parent: %s', parent)
+        response = self._handle_request(
+            lambda **kwargs: client.create_product_set(**kwargs),
+            parent=parent,
+            product_set=product_set,
+            product_set_id=product_set_id,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('ProductSet created: %s', response.name if response else '')
+        self.log.debug('ProductSet created:\n%s', response)
+
+        if not product_set_id:
+            # Product set id was generated by the API
+            product_set_id = self._get_autogenerated_id(response)
+            self.log.info('Extracted autogenerated ProductSet ID from the response: %s', product_set_id)
+
+        return product_set_id
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_product_set(
+        self, location, product_set_id, project_id=None, retry=None, timeout=None, metadata=None
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+        """
+        client = self.get_conn()
+        name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
+        self.log.info('Retrieving ProductSet: %s', name)
+        response = self._handle_request(
+            lambda **kwargs: client.get_product_set(**kwargs),
+            name=name,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('ProductSet retrieved.')
+        self.log.debug('ProductSet retrieved:\n%s', response)
+        return MessageToDict(response)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def update_product_set(
+        self,
+        product_set,
+        location=None,
+        product_set_id=None,
+        update_mask=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+        """
+        client = self.get_conn()
+        product_set = self.product_set_name_determiner.get_entity_with_name(
+            product_set, product_set_id, location, project_id
+        )
+        self.log.info('Updating ProductSet: %s', product_set.name)
+        response = self._handle_request(
+            lambda **kwargs: client.update_product_set(**kwargs),
+            product_set=product_set,
+            update_mask=update_mask,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('ProductSet updated: %s', response.name if response else '')
+        self.log.debug('ProductSet updated:\n%s', response)
+        return MessageToDict(response)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_product_set(
+        self, location, product_set_id, project_id=None, retry=None, timeout=None, metadata=None
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+        """
+        client = self.get_conn()
+        name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
+        self.log.info('Deleting ProductSet: %s', name)
+        response = self._handle_request(
+            lambda **kwargs: client.delete_product_set(**kwargs),
+            name=name,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('ProductSet with the name [%s] deleted.', name)
+        return response
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_product(
+        self, location, product, project_id=None, product_id=None, retry=None, timeout=None, metadata=None
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+        """
+        client = self.get_conn()
+        parent = ProductSearchClient.location_path(project_id, location)
+        self.log.info('Creating a new Product under the parent: %s', parent)
+        response = self._handle_request(
+            lambda **kwargs: client.create_product(**kwargs),
+            parent=parent,
+            product=product,
+            product_id=product_id,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('Product created: %s', response.name if response else '')
+        self.log.debug('Product created:\n%s', response)
+
+        if not product_id:
+            # Product id was generated by the API
+            product_id = self._get_autogenerated_id(response)
+            self.log.info('Extracted autogenerated Product ID from the response: %s', product_id)
+
+        return product_id
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def get_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+        """
+        client = self.get_conn()
+        name = ProductSearchClient.product_path(project_id, location, product_id)
+        self.log.info('Retrieving Product: %s', name)
+        response = self._handle_request(
+            lambda **kwargs: client.get_product(**kwargs),
+            name=name,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('Product retrieved.')
+        self.log.debug('Product retrieved:\n%s', response)
+        return MessageToDict(response)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def update_product(
+        self,
+        product,
+        location=None,
+        product_id=None,
+        update_mask=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
+        """
+        client = self.get_conn()
+        product = self.product_name_determiner.get_entity_with_name(product, product_id, location, project_id)
+        self.log.info('Updating ProductSet: %s', product.name)
+        response = self._handle_request(
+            lambda **kwargs: client.update_product(**kwargs),
+            product=product,
+            update_mask=update_mask,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('Product updated: %s', response.name if response else '')
+        self.log.debug('Product updated:\n%s', response)
+        return MessageToDict(response)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+        """
+        client = self.get_conn()
+        name = ProductSearchClient.product_path(project_id, location, product_id)
+        self.log.info('Deleting ProductSet: %s', name)
+        response = self._handle_request(
+            lambda **kwargs: client.delete_product(**kwargs),
+            name=name,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+        self.log.info('Product with the name [%s] deleted:', name)
+        return response
+
+    def _handle_request(self, fun, **kwargs):
+        try:
+            return fun(**kwargs)
+        except GoogleAPICallError as e:
+            if isinstance(e, AlreadyExists):
+                raise e
+            else:
+                self.log.error('The request failed:\n%s', str(e))
+                raise AirflowException(e)
+        except RetryError as e:
+            self.log.error('The request failed due to a retryable error and retry attempts failed.')
+            raise AirflowException(e)
+        except ValueError as e:
+            self.log.error('The request failed, the parameters are invalid.')
+            raise AirflowException(e)
+
+    @staticmethod
+    def _get_entity_name(is_product, project_id, location, entity_id):
+        if is_product:
+            return ProductSearchClient.product_path(project_id, location, entity_id)
+        else:
+            return ProductSearchClient.product_set_path(project_id, location, entity_id)
+
+    @staticmethod
+    def _get_autogenerated_id(response):
+        try:
+            name = response.name
+        except AttributeError as e:
+            raise AirflowException('Unable to get name from response... [{}]\n{}'.format(response, e))
+        if '/' not in name:
+            raise AirflowException('Unable to get id from name... [{}]'.format(name))
+        return name.rsplit('/', 1)[1]
diff --git a/airflow/contrib/operators/gcp_vision_operator.py b/airflow/contrib/operators/gcp_vision_operator.py
new file mode 100644
index 0000000000000..96ed11dc2bbdd
--- /dev/null
+++ b/airflow/contrib/operators/gcp_vision_operator.py
@@ -0,0 +1,673 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from google.api_core.exceptions import AlreadyExists
+
+from airflow.contrib.hooks.gcp_vision_hook import CloudVisionHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class CloudVisionProductSetCreateOperator(BaseOperator):
+    """
+    Creates a new ProductSet resource.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductSetCreateOperator`
+
+    :param product_set: (Required) The ProductSet to create. If a dict is provided, it must be of the same
+        form as the protobuf message `ProductSet`.
+    :type product_set: dict or google.cloud.vision_v1.types.ProductSet
+    :param location: (Required) The region where the ProductSet should be created. Valid regions
+        (as of 2019-02-05) are: us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param project_id: (Optional) The project in which the ProductSet should be created. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param product_set_id: (Optional) A user-supplied resource id for this ProductSet.
+        If set, the server will attempt to use this value as the resource id. If it is
+        already in use, an error is returned with code ALREADY_EXISTS. Must be at most
+        128 characters long. It cannot contain the character /.
+    :type product_set_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_productset_create_template_fields]
+    template_fields = ('location', 'project_id', 'product_set_id', 'gcp_conn_id')
+    # [END vision_productset_create_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        product_set,
+        location,
+        project_id=None,
+        product_set_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductSetCreateOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.project_id = project_id
+        self.product_set = product_set
+        self.product_set_id = product_set_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        try:
+            return self._hook.create_product_set(
+                location=self.location,
+                project_id=self.project_id,
+                product_set=self.product_set,
+                product_set_id=self.product_set_id,
+                retry=self.retry,
+                timeout=self.timeout,
+                metadata=self.metadata,
+            )
+        except AlreadyExists:
+            self.log.info(
+                'Product set with id %s already exists. Exiting from the create operation.',
+                self.product_set_id,
+            )
+            return self.product_set_id
+
+
+class CloudVisionProductSetGetOperator(BaseOperator):
+    """
+    Gets information associated with a ProductSet.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductSetGetOperator`
+
+    :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
+        are: us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_set_id: (Required) The resource id of this ProductSet.
+    :type product_set_id: str
+    :param project_id: (Optional) The project in which the ProductSet is located. If set
+        to None or missing, the default `project_id` from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_productset_get_template_fields]
+    template_fields = ('location', 'project_id', 'product_set_id', 'gcp_conn_id')
+    # [END vision_productset_get_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        product_set_id,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductSetGetOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.project_id = project_id
+        self.product_set_id = product_set_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.get_product_set(
+            location=self.location,
+            product_set_id=self.product_set_id,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionProductSetUpdateOperator(BaseOperator):
+    """
+    Makes changes to a `ProductSet` resource. Only display_name can be updated currently.
+
+    .. note:: To locate the `ProductSet` resource, its `name` in the form
+        `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID` is necessary.
+
+    You can provide the `name` directly as an attribute of the `product_set` object.
+    However, you can leave it blank and provide `location` and `product_set_id` instead
+    (and optionally `project_id` - if not present, the connection default will be used)
+    and the `name` will be created by the operator itself.
+
+    This mechanism exists for your convenience, to allow leaving the `project_id` empty
+    and having Airflow use the connection default `project_id`.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductSetUpdateOperator`
+
+    :param product_set: (Required) The ProductSet resource which replaces the one on the
+        server. If a dict is provided, it must be of the same form as the protobuf
+        message `ProductSet`.
+    :type product_set: dict or google.cloud.vision_v1.types.ProductSet
+    :param location: (Optional) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
+        are: us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_set_id: (Optional) The resource id of this ProductSet.
+    :type product_set_id: str
+    :param project_id: (Optional) The project in which the ProductSet should be created. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param update_mask: (Optional) The `FieldMask` that specifies which fields to update. If update_mask
+        isn’t specified, all mutable fields are to be updated. Valid mask path is display_name. If a dict is
+        provided, it must be of the same form as the protobuf message `FieldMask`.
+    :type update_mask: dict or google.cloud.vision_v1.types.FieldMask
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+
+    """
+
+    # [START vision_productset_update_template_fields]
+    template_fields = ('location', 'project_id', 'product_set_id', 'gcp_conn_id')
+    # [END vision_productset_update_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        product_set,
+        location=None,
+        product_set_id=None,
+        project_id=None,
+        update_mask=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductSetUpdateOperator, self).__init__(*args, **kwargs)
+        self.product_set = product_set
+        self.update_mask = update_mask
+        self.location = location
+        self.project_id = project_id
+        self.product_set_id = product_set_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.update_product_set(
+            location=self.location,
+            product_set_id=self.product_set_id,
+            project_id=self.project_id,
+            product_set=self.product_set,
+            update_mask=self.update_mask,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionProductSetDeleteOperator(BaseOperator):
+    """
+    Permanently deletes a `ProductSet`. `Products` and `ReferenceImages` in the
+    `ProductSet` are not deleted. The actual image files are not deleted from Google
+    Cloud Storage.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductSetDeleteOperator`
+
+    :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
+        are: us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_set_id: (Required) The resource id of this ProductSet.
+    :type product_set_id: str
+    :param project_id: (Optional) The project in which the ProductSet should be created.
+        If set to None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+
+    """
+
+    # [START vision_productset_delete_template_fields]
+    template_fields = ('location', 'project_id', 'product_set_id', 'gcp_conn_id')
+    # [END vision_productset_delete_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        product_set_id,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductSetDeleteOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.project_id = project_id
+        self.product_set_id = product_set_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.delete_product_set(
+            location=self.location,
+            product_set_id=self.product_set_id,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionProductCreateOperator(BaseOperator):
+    """
+    Creates and returns a new product resource.
+
+    Possible errors regarding the `Product` object provided:
+
+    - Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
+    - Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
+    - Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductCreateOperator`
+
+    :param location: (Required) The region where the Product should be created. Valid regions
+        (as of 2019-02-05) are: us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product: (Required) The product to create. If a dict is provided, it must be of the same form as
+        the protobuf message `Product`.
+    :type product: dict or google.cloud.vision_v1.types.Product
+    :param project_id: (Optional) The project in which the Product should be created. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param product_id: (Optional) A user-supplied resource id for this Product.
+        If set, the server will attempt to use this value as the resource id. If it is
+        already in use, an error is returned with code ALREADY_EXISTS. Must be at most
+        128 characters long. It cannot contain the character /.
+    :type product_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+
+    """
+
+    # [START vision_product_create_template_fields]
+    template_fields = ('location', 'project_id', 'product_id', 'gcp_conn_id')
+    # [END vision_product_create_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        product,
+        project_id=None,
+        product_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductCreateOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.product = product
+        self.project_id = project_id
+        self.product_id = product_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        try:
+            return self._hook.create_product(
+                location=self.location,
+                product=self.product,
+                project_id=self.project_id,
+                product_id=self.product_id,
+                retry=self.retry,
+                timeout=self.timeout,
+                metadata=self.metadata,
+            )
+        except AlreadyExists:
+            self.log.info(
+                'Product with id %s already exists. Exiting from the create operation.', self.product_id
+            )
+            return self.product_id
+
+
+class CloudVisionProductGetOperator(BaseOperator):
+    """
+    Gets information associated with a `Product`.
+
+    Possible errors:
+
+    - Returns NOT_FOUND if the `Product` does not exist.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductGetOperator`
+
+    :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
+        us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_id: (Required) The resource id of this Product.
+    :type product_id: str
+    :param project_id: (Optional) The project in which the Product is located. If set to
+        None or missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+
+    """
+
+    # [START vision_product_get_template_fields]
+    template_fields = ('location', 'project_id', 'product_id', 'gcp_conn_id')
+    # [END vision_product_get_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        product_id,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductGetOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.product_id = product_id
+        self.project_id = project_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.get_product(
+            location=self.location,
+            product_id=self.product_id,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionProductUpdateOperator(BaseOperator):
+    """
+    Makes changes to a Product resource. Only the display_name, description, and labels fields can be
+    updated right now.
+
+    If labels are updated, the change will not be reflected in queries until the next index time.
+
+    .. note:: To locate the `Product` resource, its `name` in the form
+        `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID` is necessary.
+
+    You can provide the `name` directly as an attribute of the `product` object. However, you can leave it
+    blank and provide `location` and `product_id` instead (and optionally `project_id` - if not present,
+    the connection default will be used) and the `name` will be created by the operator itself.
+
+    This mechanism exists for your convenience, to allow leaving the `project_id` empty and having Airflow
+    use the connection default `project_id`.
+
+    Possible errors related to the provided `Product`:
+
+    - Returns NOT_FOUND if the Product does not exist.
+    - Returns INVALID_ARGUMENT if display_name is present in update_mask but is missing from the request or
+        longer than 4096 characters.
+    - Returns INVALID_ARGUMENT if description is present in update_mask but is longer than 4096 characters.
+    - Returns INVALID_ARGUMENT if product_category is present in update_mask.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductUpdateOperator`
+
+    :param product: (Required) The Product resource which replaces the one on the server. product.name is
+        immutable. If a dict is provided, it must be of the same form as the protobuf message `Product`.
+    :type product: dict or google.cloud.vision_v1.types.ProductSet
+    :param location: (Optional) The region where the Product is located. Valid regions (as of 2019-02-05) are:
+        us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_id: (Optional) The resource id of this Product.
+    :type product_id: str
+    :param project_id: (Optional) The project in which the Product is located. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param update_mask: (Optional) The `FieldMask` that specifies which fields to update. If update_mask
+        isn’t specified, all mutable fields are to be updated. Valid mask paths include product_labels,
+        display_name, and description. If a dict is provided, it must be of the same form as the protobuf
+        message `FieldMask`.
+    :type update_mask: dict or google.cloud.vision_v1.types.FieldMask
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_product_update_template_fields]
+    template_fields = ('location', 'project_id', 'product_id', 'gcp_conn_id')
+    # [END vision_product_update_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        product,
+        location=None,
+        product_id=None,
+        project_id=None,
+        update_mask=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductUpdateOperator, self).__init__(*args, **kwargs)
+        self.product = product
+        self.location = location
+        self.product_id = product_id
+        self.project_id = project_id
+        self.update_mask = update_mask
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.update_product(
+            product=self.product,
+            location=self.location,
+            product_id=self.product_id,
+            project_id=self.project_id,
+            update_mask=self.update_mask,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionProductDeleteOperator(BaseOperator):
+    """
+    Permanently deletes a product and its reference images.
+
+    Metadata of the product and all its images will be deleted right away, but search queries against
+    ProductSets containing the product may still work until all related caches are refreshed.
+
+    Possible errors:
+
+    - Returns NOT_FOUND if the product does not exist.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionProductDeleteOperator`
+
+    :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
+        us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param product_id: (Required) The resource id of this Product.
+    :type product_id: str
+    :param project_id: (Optional) The project in which the Product is located. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: Sequence[Tuple[str, str]]
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_product_delete_template_fields]
+    template_fields = ('location', 'project_id', 'product_id', 'gcp_conn_id')
+    # [END vision_product_delete_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        product_id,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionProductDeleteOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.product_id = product_id
+        self.project_id = project_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+        self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+
+    def execute(self, context):
+        return self._hook.delete_product(
+            location=self.location,
+            product_id=self.product_id,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
diff --git a/docs/code.rst b/docs/code.rst
index f489d2e8cfbf0..1f5ef652341be 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -208,6 +208,14 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
@@ -481,6 +489,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
+.. autoclass:: airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook
 .. autoclass:: airflow.contrib.hooks.cloudant_hook.CloudantHook
 .. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
 .. autoclass:: airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 05a588f2efe90..6f312081e6a6d 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -1680,4 +1680,597 @@ More information
 """"""""""""""""
 
 See `Google Cloud Storage ObjectAccessControls insert documentation
-<https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_
+<https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_.
+
+Google Cloud Vision Operators
+------------------------------
+
+.. _howto/operator:CloudVisionProductSetCreateOperator:
+
+CloudVisionProductSetCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new :code:`ProductSet` resource.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_explicit_id]
+      :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_import]
+      :end-before: [END howto_operator_vision_productset_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset]
+      :end-before: [END howto_operator_vision_productset]
+
+The ``product_set_id`` argument can be omitted (it will be generated by the API):
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_create]
+      :end-before: [END howto_operator_vision_product_set_create]
+
+Or it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_create_2]
+      :end-before: [END howto_operator_vision_product_set_create_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_create_template_fields]
+    :end-before: [END vision_productset_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetGetOperator:
+
+CloudVisionProductSetGetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Gets information associated with a :code:`ProductSet`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_explicit_id]
+      :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_get]
+      :end-before: [END howto_operator_vision_product_set_get]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_get_2]
+      :end-before: [END howto_operator_vision_product_set_get_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_get_template_fields]
+    :end-before: [END vision_productset_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetUpdateOperator:
+
+CloudVisionProductSetUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Makes changes to a :code:`ProductSet` resource. Only :code:`display_name` can be updated
+currently.
+
+.. note:: To locate the `ProductSet` resource, its `name` in the form
+  ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`` is necessary.
+
+You can provide the `name` directly as an attribute of the `product_set` object.
+However, you can leave it blank and provide `location` and `product_set_id` instead (and
+optionally `project_id` - if not present, the connection default will be used) and the
+`name` will be created by the operator itself.
+
+This mechanism exists for your convenience, to allow leaving the `project_id` empty and
+having Airflow use the connection default `project_id`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_explicit_id]
+      :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``ProductSet`` object from the Google Cloud Vision library:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_import]
+      :end-before: [END howto_operator_vision_productset_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset]
+      :end-before: [END howto_operator_vision_productset]
+
+Initialization of the task:
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_update]
+      :end-before: [END howto_operator_vision_product_set_update]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_update_2]
+      :end-before: [END howto_operator_vision_product_set_update_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_update_template_fields]
+    :end-before: [END vision_productset_update_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet update documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetDeleteOperator:
+
+CloudVisionProductSetDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Permanently deletes a :code:`ProductSet`. :code:`Products` and :code:`ReferenceImages` in
+the :code:`ProductSet` are not deleted. The actual image files are not deleted from
+Google Cloud Storage.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_productset_explicit_id]
+      :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_delete]
+      :end-before: [END howto_operator_vision_product_set_delete]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_set_delete_2]
+      :end-before: [END howto_operator_vision_product_set_delete_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_delete_template_fields]
+    :end-before: [END vision_productset_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet delete documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product_set>`_.
+
+.. _howto/operator:CloudVisionProductCreateOperator:
+
+CloudVisionProductCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates and returns a new product resource.
+
+Possible errors regarding the :code:`Product` object provided:
+
+- Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``Product`` and ``Retry`` objects from Google libraries:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_import]
+      :end-before: [END howto_operator_vision_product_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product]
+      :end-before: [END howto_operator_vision_product]
+
+The ``product_id`` argument can be omitted (it will be generated by the API):
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_create]
+      :end-before: [END howto_operator_vision_product_create]
+
+Or it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_create_2]
+      :end-before: [END howto_operator_vision_product_create_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_create_template_fields]
+    :end-before: [END vision_product_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product>`_.
+
+.. _howto/operator:CloudVisionProductGetOperator:
+
+CloudVisionProductGetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Gets information associated with a :code:`Product`.
+
+Possible errors:
+
+- Returns NOT_FOUND if the `Product` does not exist.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_get]
+      :end-before: [END howto_operator_vision_product_get]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_get_2]
+      :end-before: [END howto_operator_vision_product_get_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_get_template_fields]
+    :end-before: [END vision_product_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product>`_.
+
+.. _howto/operator:CloudVisionProductUpdateOperator:
+
+CloudVisionProductUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Makes changes to a :code:`Product` resource. Only the :code:`display_name`,
+:code:`description`, and :code:`labels` fields can be updated right now.
+If labels are updated, the change will not be reflected in queries until the next index
+time.
+
+.. note:: To locate the `Product` resource, its `name` in the form
+  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`` is necessary.
+
+You can provide the `name` directly as an attribute of the `product` object. However, you
+can leave it blank and provide `location` and `product_id` instead (and optionally
+`project_id` - if not present, the connection default will be used) and the `name` will
+be created by the operator itself.
+
+This mechanism exists for your convenience, to allow leaving the `project_id` empty and
+having Airflow use the connection default `project_id`.
+
+Possible errors:
+
+- Returns NOT_FOUND if the `Product` does not exist.
+- Returns INVALID_ARGUMENT if `display_name` is present in `update_mask` but is missing
+  from the request or longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `description` is present in `update_mask` but is longer than
+  4096 characters.
+- Returns INVALID_ARGUMENT if `product_category` is present in `update_mask`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``Product`` object from the Google Cloud Vision library:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_import]
+      :end-before: [END howto_operator_vision_product_import]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product]
+      :end-before: [END howto_operator_vision_product]
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_update]
+      :end-before: [END howto_operator_vision_product_update]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_update_2]
+      :end-before: [END howto_operator_vision_product_update_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_update_template_fields]
+    :end-before: [END vision_product_update_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product update documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product>`_.
+
+.. _howto/operator:CloudVisionProductDeleteOperator:
+
+CloudVisionProductDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Permanently deletes a product and its reference images.
+
+Metadata of the product and all its images will be deleted right away, but search queries
+against :code:`ProductSets` containing the product may still work until all related
+caches are refreshed.
+
+Possible errors:
+
+- Returns NOT_FOUND if the product does not exist.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_delete]
+      :end-before: [END howto_operator_vision_product_delete]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_product_delete_2]
+      :end-before: [END howto_operator_vision_product_delete_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_delete_template_fields]
+    :end-before: [END vision_product_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product delete documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product>`_.
+>>>>>>> ce499bb2... [AIRFLOW-3701] Add Google Cloud Vision Product Search operators (#4665)
diff --git a/docs/integration.rst b/docs/integration.rst
index 3938eb4277471..80d744da1b3f9 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1409,6 +1409,31 @@ GCPTransferServiceHook
     :members:
     :noindex:
 
+Cloud Vision
+''''''''''''
+
+Cloud Vision Product Search Operators
+"""""""""""""""""""""""""""""""""""""
+
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+    Creates a new ProductSet resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+    Gets information associated with a ProductSet.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+    Makes changes to a ProductSet resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+    Permanently deletes a ProductSet.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+    Creates a new Product resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+    Gets information associated with a Product.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
+    Makes changes to a Product resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+    Permanently deletes a product and its reference images.
+
+They also use :class:`airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook` to communicate with Google Cloud Platform.
+
 Google Kubernetes Engine
 ''''''''''''''''''''''''
 
diff --git a/setup.py b/setup.py
index 4352dac78f622..bd490fad0afb6 100644
--- a/setup.py
+++ b/setup.py
@@ -178,6 +178,7 @@ def write_version(filename=os.path.join(*['airflow',
     'google-cloud-container>=0.1.1',
     'google-cloud-bigtable==0.31.0',
     'google-cloud-spanner>=1.7.1',
+    'google-cloud-vision>=0.35.2',
     'grpcio-gcp>=0.2.2',
     'PyOpenSSL',
     'pandas-gbq'
diff --git a/tests/contrib/hooks/test_gcp_vision_hook.py b/tests/contrib/hooks/test_gcp_vision_hook.py
new file mode 100644
index 0000000000000..ddc7114d8a612
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_vision_hook.py
@@ -0,0 +1,548 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from google.cloud.vision_v1 import ProductSearchClient
+from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet, Product
+from google.protobuf.json_format import MessageToDict
+from parameterized import parameterized
+
+from airflow.contrib.hooks.gcp_vision_hook import CloudVisionHook
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+from airflow import AirflowException
+
+PROJECT_ID_TEST = 'project-id'
+PROJECT_ID_TEST_2 = 'project-id-2'
+LOC_ID_TEST = 'loc-id'
+LOC_ID_TEST_2 = 'loc-id-2'
+PRODUCTSET_ID_TEST = 'ps-id'
+PRODUCTSET_ID_TEST_2 = 'ps-id-2'
+PRODUCT_ID_TEST = 'p-id'
+PRODUCT_ID_TEST_2 = 'p-id-2'
+
+
+class TestGcpVisionHook(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(
+            'airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.__init__',
+            new=mock_base_gcp_hook_default_project_id,
+        ):
+            self.vision_hook_default_project_id = CloudVisionHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_productset_explicit_id(self, get_conn):
+        # Given
+        create_product_set_method = get_conn.return_value.create_product_set
+        create_product_set_method.return_value = None
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product_set = ProductSet()
+        # When
+        result = hook.create_product_set(
+            location=LOC_ID_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_set=product_set,
+            project_id=PROJECT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+        # Then
+        # ProductSet ID was provided explicitly in the method call above, should be returned from the method
+        self.assertEqual(result, PRODUCTSET_ID_TEST)
+        create_product_set_method.assert_called_once_with(
+            parent=parent,
+            product_set=product_set,
+            product_set_id=PRODUCTSET_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_productset_autogenerated_id(self, get_conn):
+        # Given
+        autogenerated_id = 'autogen-id'
+        response_product_set = ProductSet(
+            name=ProductSearchClient.product_set_path(PROJECT_ID_TEST, LOC_ID_TEST, autogenerated_id)
+        )
+        create_product_set_method = get_conn.return_value.create_product_set
+        create_product_set_method.return_value = response_product_set
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product_set = ProductSet()
+        # When
+        result = hook.create_product_set(
+            location=LOC_ID_TEST, product_set_id=None, product_set=product_set, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        # ProductSet ID was not provided in the method call above. Should be extracted from the API response
+        # and returned.
+        self.assertEqual(result, autogenerated_id)
+        create_product_set_method.assert_called_once_with(
+            parent=parent,
+            product_set=product_set,
+            product_set_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_productset_autogenerated_id_wrong_api_response(self, get_conn):
+        # Given
+        response_product_set = None
+        create_product_set_method = get_conn.return_value.create_product_set
+        create_product_set_method.return_value = response_product_set
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product_set = ProductSet()
+        # When
+        with self.assertRaises(AirflowException) as cm:
+            hook.create_product_set(
+                location=LOC_ID_TEST,
+                product_set_id=None,
+                product_set=product_set,
+                project_id=PROJECT_ID_TEST,
+                retry=None,
+                timeout=None,
+                metadata=None,
+            )
+        # Then
+        # API response was wrong (None) and thus ProductSet ID extraction should fail.
+        err = cm.exception
+        self.assertIn('Unable to get name from response...', str(err))
+        create_product_set_method.assert_called_once_with(
+            parent=parent,
+            product_set=product_set,
+            product_set_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_get_productset(self, get_conn):
+        # Given
+        name = ProductSearchClient.product_set_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST)
+        response_product_set = ProductSet(name=name)
+        get_product_set_method = get_conn.return_value.get_product_set
+        get_product_set_method.return_value = response_product_set
+        hook = self.vision_hook_default_project_id
+        # When
+        response = hook.get_product_set(
+            location=LOC_ID_TEST, product_set_id=PRODUCTSET_ID_TEST, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        self.assertTrue(response)
+        self.assertEqual(response, MessageToDict(response_product_set))
+        get_product_set_method.assert_called_once_with(name=name, retry=None, timeout=None, metadata=None)
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_productset_no_explicit_name(self, get_conn):
+        # Given
+        product_set = ProductSet()
+        update_product_set_method = get_conn.return_value.update_product_set
+        update_product_set_method.return_value = product_set
+        hook = self.vision_hook_default_project_id
+        productset_name = ProductSearchClient.product_set_path(
+            PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST
+        )
+        # When
+        result = hook.update_product_set(
+            location=LOC_ID_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_set=product_set,
+            update_mask=None,
+            project_id=PROJECT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+        # Then
+        self.assertEqual(result, MessageToDict(product_set))
+        update_product_set_method.assert_called_once_with(
+            product_set=ProductSet(name=productset_name),
+            metadata=None,
+            retry=None,
+            timeout=None,
+            update_mask=None,
+        )
+
+    @parameterized.expand([(None, None), (None, PRODUCTSET_ID_TEST), (LOC_ID_TEST, None)])
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_productset_no_explicit_name_and_missing_params_for_constructed_name(
+        self, location, product_set_id, get_conn
+    ):
+        # Given
+        update_product_set_method = get_conn.return_value.update_product_set
+        update_product_set_method.return_value = None
+        hook = self.vision_hook_default_project_id
+        product_set = ProductSet()
+        # When
+        with self.assertRaises(AirflowException) as cm:
+            hook.update_product_set(
+                location=location,
+                product_set_id=product_set_id,
+                product_set=product_set,
+                update_mask=None,
+                project_id=PROJECT_ID_TEST,
+                retry=None,
+                timeout=None,
+                metadata=None,
+            )
+        err = cm.exception
+        self.assertTrue(err)
+        self.assertIn(
+            "Unable to determine the ProductSet name. Please either set the name directly in the "
+            "ProductSet object or provide the `location` and `productset_id` parameters.",
+            str(err),
+        )
+        update_product_set_method.assert_not_called()
+
+    @parameterized.expand([(None, None), (None, PRODUCTSET_ID_TEST), (LOC_ID_TEST, None)])
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_productset_explicit_name_missing_params_for_constructed_name(
+        self, location, product_set_id, get_conn
+    ):
+        # Given
+        explicit_ps_name = ProductSearchClient.product_set_path(
+            PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCTSET_ID_TEST_2
+        )
+        product_set = ProductSet(name=explicit_ps_name)
+        update_product_set_method = get_conn.return_value.update_product_set
+        update_product_set_method.return_value = product_set
+        hook = self.vision_hook_default_project_id
+        # When
+        result = hook.update_product_set(
+            location=location,
+            product_set_id=product_set_id,
+            product_set=product_set,
+            update_mask=None,
+            project_id=PROJECT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+        # Then
+        self.assertEqual(result, MessageToDict(product_set))
+        update_product_set_method.assert_called_once_with(
+            product_set=ProductSet(name=explicit_ps_name),
+            metadata=None,
+            retry=None,
+            timeout=None,
+            update_mask=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_productset_explicit_name_different_from_constructed(self, get_conn):
+        # Given
+        update_product_set_method = get_conn.return_value.update_product_set
+        update_product_set_method.return_value = None
+        hook = self.vision_hook_default_project_id
+        explicit_ps_name = ProductSearchClient.product_set_path(
+            PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCTSET_ID_TEST_2
+        )
+        product_set = ProductSet(name=explicit_ps_name)
+        template_ps_name = ProductSearchClient.product_set_path(
+            PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST
+        )
+        # When
+        # Location and product_set_id are passed in addition to a ProductSet with an explicit name,
+        # but both names differ (constructed != explicit).
+        # Should throw AirflowException in this case.
+        with self.assertRaises(AirflowException) as cm:
+            hook.update_product_set(
+                location=LOC_ID_TEST,
+                product_set_id=PRODUCTSET_ID_TEST,
+                product_set=product_set,
+                update_mask=None,
+                project_id=PROJECT_ID_TEST,
+                retry=None,
+                timeout=None,
+                metadata=None,
+            )
+        err = cm.exception
+        # self.assertIn("The required parameter 'project_id' is missing", str(err))
+        self.assertTrue(err)
+        self.assertIn(
+            "The ProductSet name provided in the object ({}) is different than the name "
+            "created from the input parameters ({}). Please either: 1) Remove the ProductSet "
+            "name, 2) Remove the location and productset_id parameters, 3) Unify the "
+            "ProductSet name and input parameters.".format(explicit_ps_name, template_ps_name),
+            str(err),
+        )
+        update_product_set_method.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_delete_productset(self, get_conn):
+        # Given
+        delete_product_set_method = get_conn.return_value.delete_product_set
+        delete_product_set_method.return_value = None
+        name = ProductSearchClient.product_set_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        # When
+        response = hook.delete_product_set(
+            location=LOC_ID_TEST, product_set_id=PRODUCTSET_ID_TEST, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        self.assertIsNone(response)
+        delete_product_set_method.assert_called_once_with(name=name, retry=None, timeout=None, metadata=None)
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_product_explicit_id(self, get_conn):
+        # Given
+        create_product_method = get_conn.return_value.create_product
+        create_product_method.return_value = None
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product = Product()
+        # When
+        result = hook.create_product(
+            location=LOC_ID_TEST, product_id=PRODUCT_ID_TEST, product=product, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        self.assertEqual(result, PRODUCT_ID_TEST)
+        create_product_method.assert_called_once_with(
+            parent=parent,
+            product=product,
+            product_id=PRODUCT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_product_autogenerated_id(self, get_conn):
+        # Given
+        autogenerated_id = 'autogen-p-id'
+        response_product = Product(
+            name=ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, autogenerated_id)
+        )
+        create_product_method = get_conn.return_value.create_product
+        create_product_method.return_value = response_product
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product = Product()
+        # When
+        result = hook.create_product(
+            location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        # Product ID was not provided in the method call above. Should be extracted from the API response
+        # and returned.
+        self.assertEqual(result, autogenerated_id)
+        create_product_method.assert_called_once_with(
+            parent=parent, product=product, product_id=None, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_product_autogenerated_id_wrong_name_in_response(self, get_conn):
+        # Given
+        wrong_name = 'wrong_name_not_a_correct_path'
+        response_product = Product(name=wrong_name)
+        create_product_method = get_conn.return_value.create_product
+        create_product_method.return_value = response_product
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product = Product()
+        # When
+        with self.assertRaises(AirflowException) as cm:
+            hook.create_product(
+                location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
+            )
+        # Then
+        # API response was wrong (wrong name format) and thus ProductSet ID extraction should fail.
+        err = cm.exception
+        self.assertIn('Unable to get id from name', str(err))
+        create_product_method.assert_called_once_with(
+            parent=parent, product=product, product_id=None, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_create_product_autogenerated_id_wrong_api_response(self, get_conn):
+        # Given
+        response_product = None
+        create_product_method = get_conn.return_value.create_product
+        create_product_method.return_value = response_product
+        parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        product = Product()
+        # When
+        with self.assertRaises(AirflowException) as cm:
+            hook.create_product(
+                location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
+            )
+        # Then
+        # API response was wrong (None) and thus ProductSet ID extraction should fail.
+        err = cm.exception
+        self.assertIn('Unable to get name from response...', str(err))
+        create_product_method.assert_called_once_with(
+            parent=parent, product=product, product_id=None, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_product_no_explicit_name(self, get_conn):
+        # Given
+        product = Product()
+        update_product_method = get_conn.return_value.update_product
+        update_product_method.return_value = product
+        hook = self.vision_hook_default_project_id
+        product_name = ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
+        # When
+        result = hook.update_product(
+            location=LOC_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            product=product,
+            update_mask=None,
+            project_id=PROJECT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+        # Then
+        self.assertEqual(result, MessageToDict(product))
+        update_product_method.assert_called_once_with(
+            product=Product(name=product_name), metadata=None, retry=None, timeout=None, update_mask=None
+        )
+
+    @parameterized.expand([(None, None), (None, PRODUCT_ID_TEST), (LOC_ID_TEST, None)])
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_product_no_explicit_name_and_missing_params_for_constructed_name(
+        self, location, product_id, get_conn
+    ):
+        # Given
+        update_product_method = get_conn.return_value.update_product
+        update_product_method.return_value = None
+        hook = self.vision_hook_default_project_id
+        product = Product()
+        # When
+        with self.assertRaises(AirflowException) as cm:
+            hook.update_product(
+                location=location,
+                product_id=product_id,
+                product=product,
+                update_mask=None,
+                project_id=PROJECT_ID_TEST,
+                retry=None,
+                timeout=None,
+                metadata=None,
+            )
+        err = cm.exception
+        self.assertTrue(err)
+        self.assertIn(
+            "Unable to determine the Product name. Please either set the name directly in the "
+            "Product object or provide the `location` and `product_id` parameters.",
+            str(err),
+        )
+        update_product_method.assert_not_called()
+
+    @parameterized.expand([(None, None), (None, PRODUCT_ID_TEST), (LOC_ID_TEST, None)])
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_product_explicit_name_missing_params_for_constructed_name(
+        self, location, product_id, get_conn
+    ):
+        # Given
+        explicit_p_name = ProductSearchClient.product_path(
+            PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCT_ID_TEST_2
+        )
+        product = Product(name=explicit_p_name)
+        update_product_method = get_conn.return_value.update_product
+        update_product_method.return_value = product
+        hook = self.vision_hook_default_project_id
+        # When
+        result = hook.update_product(
+            location=location,
+            product_id=product_id,
+            product=product,
+            update_mask=None,
+            project_id=PROJECT_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+        # Then
+        self.assertEqual(result, MessageToDict(product))
+        update_product_method.assert_called_once_with(
+            product=Product(name=explicit_p_name), metadata=None, retry=None, timeout=None, update_mask=None
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_update_product_explicit_name_different_from_constructed(self, get_conn):
+        # Given
+        update_product_method = get_conn.return_value.update_product
+        update_product_method.return_value = None
+        hook = self.vision_hook_default_project_id
+        explicit_p_name = ProductSearchClient.product_path(
+            PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCT_ID_TEST_2
+        )
+        product = Product(name=explicit_p_name)
+        template_p_name = ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
+        # When
+        # Location and product_id are passed in addition to a Product with an explicit name,
+        # but both names differ (constructed != explicit).
+        # Should throw AirflowException in this case.
+        with self.assertRaises(AirflowException) as cm:
+            hook.update_product(
+                location=LOC_ID_TEST,
+                product_id=PRODUCT_ID_TEST,
+                product=product,
+                update_mask=None,
+                project_id=PROJECT_ID_TEST,
+                retry=None,
+                timeout=None,
+                metadata=None,
+            )
+        err = cm.exception
+        self.assertTrue(err)
+        self.assertIn(
+            "The Product name provided in the object ({}) is different than the name created from the input "
+            "parameters ({}). Please either: 1) Remove the Product name, 2) Remove the location and product_"
+            "id parameters, 3) Unify the Product name and input parameters.".format(
+                explicit_p_name, template_p_name
+            ),
+            str(err),
+        )
+        update_product_method.assert_not_called()
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_delete_product(self, get_conn):
+        # Given
+        delete_product_method = get_conn.return_value.delete_product
+        delete_product_method.return_value = None
+        name = ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
+        hook = self.vision_hook_default_project_id
+        # When
+        response = hook.delete_product(
+            location=LOC_ID_TEST, product_id=PRODUCT_ID_TEST, project_id=PROJECT_ID_TEST
+        )
+        # Then
+        self.assertIsNone(response)
+        delete_product_method.assert_called_once_with(name=name, retry=None, timeout=None, metadata=None)
diff --git a/tests/contrib/operators/test_gcp_vision_operator.py b/tests/contrib/operators/test_gcp_vision_operator.py
new file mode 100644
index 0000000000000..a806f85021d69
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_vision_operator.py
@@ -0,0 +1,234 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from google.api_core.exceptions import AlreadyExists
+from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet, Product
+
+from airflow.contrib.operators.gcp_vision_operator import (
+    CloudVisionProductSetCreateOperator,
+    CloudVisionProductSetGetOperator,
+    CloudVisionProductSetUpdateOperator,
+    CloudVisionProductSetDeleteOperator,
+    CloudVisionProductCreateOperator,
+    CloudVisionProductGetOperator,
+    CloudVisionProductUpdateOperator,
+    CloudVisionProductDeleteOperator,
+)
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PRODUCTSET_TEST = ProductSet(display_name='Test Product Set')
+PRODUCTSET_ID_TEST = 'my-productset'
+PRODUCT_TEST = Product(display_name='My Product 1', product_category='toys')
+PRODUCT_ID_TEST = 'my-product'
+LOCATION_TEST = 'europe-west1'
+GCP_CONN_ID = 'google_cloud_default'
+
+
+class CloudVisionProductSetCreateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.create_product_set.return_value = {}
+        op = CloudVisionProductSetCreateOperator(
+            location=LOCATION_TEST, product_set=PRODUCTSET_TEST, task_id='id'
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.create_product_set.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_set=PRODUCTSET_TEST,
+            product_set_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.get_conn')
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook._handle_request')
+    def test_already_exists(self, _handle_request, get_conn):
+        get_conn.return_value = {}
+        _handle_request.side_effect = AlreadyExists(message='')
+        # Exception AlreadyExists not raised, caught in the operator's execute() - idempotence
+        op = CloudVisionProductSetCreateOperator(
+            location=LOCATION_TEST,
+            product_set=PRODUCTSET_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            project_id='mock-project-id',
+            task_id='id',
+        )
+        result = op.execute(None)
+        self.assertEqual(PRODUCTSET_ID_TEST, result)
+
+
+class CloudVisionProductSetUpdateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.update_product_set.return_value = {}
+        op = CloudVisionProductSetUpdateOperator(
+            location=LOCATION_TEST, product_set=PRODUCTSET_TEST, task_id='id'
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.update_product_set.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_set=PRODUCTSET_TEST,
+            product_set_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+            update_mask=None,
+        )
+
+
+class CloudVisionProductSetGetTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.get_product_set.return_value = {}
+        op = CloudVisionProductSetGetOperator(
+            location=LOCATION_TEST, product_set_id=PRODUCTSET_ID_TEST, task_id='id'
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.get_product_set.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionProductSetDeleteTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.delete_product_set.return_value = {}
+        op = CloudVisionProductSetDeleteOperator(
+            location=LOCATION_TEST, product_set_id=PRODUCTSET_ID_TEST, task_id='id'
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.delete_product_set.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionProductCreateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.create_product.return_value = {}
+        op = CloudVisionProductCreateOperator(location=LOCATION_TEST, product=PRODUCT_TEST, task_id='id')
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.create_product.assert_called_once_with(
+            location=LOCATION_TEST,
+            product=PRODUCT_TEST,
+            product_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.get_conn')
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook._handle_request')
+    def test_already_exists(self, _handle_request, get_conn):
+        get_conn.return_value = {}
+        _handle_request.side_effect = AlreadyExists(message='')
+        # Exception AlreadyExists not raised, caught in the operator's execute() - idempotence
+        op = CloudVisionProductCreateOperator(
+            location=LOCATION_TEST,
+            product=PRODUCT_TEST,
+            product_id=PRODUCT_ID_TEST,
+            project_id='mock-project-id',
+            task_id='id',
+        )
+        result = op.execute(None)
+        self.assertEqual(PRODUCT_ID_TEST, result)
+
+
+class CloudVisionProductGetTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.get_product.return_value = {}
+        op = CloudVisionProductGetOperator(location=LOCATION_TEST, product_id=PRODUCT_ID_TEST, task_id='id')
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.get_product.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionProductUpdateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.update_product.return_value = {}
+        op = CloudVisionProductUpdateOperator(location=LOCATION_TEST, product=PRODUCT_TEST, task_id='id')
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.update_product.assert_called_once_with(
+            location=LOCATION_TEST,
+            product=PRODUCT_TEST,
+            product_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+            update_mask=None,
+        )
+
+
+class CloudVisionProductDeleteTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.delete_product.return_value = {}
+        op = CloudVisionProductDeleteOperator(
+            location=LOCATION_TEST, product_id=PRODUCT_ID_TEST, task_id='id'
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.delete_product.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
diff --git a/tests/contrib/operators/test_gcp_vision_operator_system.py b/tests/contrib/operators/test_gcp_vision_operator_system.py
new file mode 100644
index 0000000000000..2b75642d6f3a3
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_vision_operator_system.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import DagGcpSystemTestCase, SKIP_TEST_WARNING
+from tests.contrib.utils.gcp_authenticator import GCP_AI_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_AI_KEY), SKIP_TEST_WARNING)
+class CloudVisionExampleDagsSystemTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudVisionExampleDagsSystemTest, self).__init__(
+            method_name, dag_id='example_gcp_vision', gcp_key=GCP_AI_KEY
+        )
+
+    def test_run_example_dag_function(self):
+        self._run_dag()
diff --git a/tests/contrib/utils/gcp_authenticator.py b/tests/contrib/utils/gcp_authenticator.py
index 4734a42b10287..b361fcdeb18c6 100644
--- a/tests/contrib/utils/gcp_authenticator.py
+++ b/tests/contrib/utils/gcp_authenticator.py
@@ -31,6 +31,7 @@
 GCP_BIGTABLE_KEY = 'gcp_bigtable.json'
 GCP_SPANNER_KEY = 'gcp_spanner.json'
 GCP_GCS_KEY = 'gcp_gcs.json'
+GCP_AI_KEY = 'gcp_ai.json'
 
 KEYPATH_EXTRA = 'extra__google_cloud_platform__key_path'
 KEYFILE_DICT_EXTRA = 'extra__google_cloud_platform__keyfile_dict'

From 753cc45730d4afe7a0f15e3fc1d59d3c0d06d1d2 Mon Sep 17 00:00:00 2001
From: Tanay Tummalapalli <ttanay100@gmail.com>
Date: Wed, 6 Mar 2019 01:12:23 +0530
Subject: [PATCH 626/808] [AIRFLOW-3758] Fix circular import in WasbTaskHandler
 (#4601)

WasbHook was causing a circular import error when configure_logging() was called.
---
 airflow/utils/log/wasb_task_handler.py |  2 +-
 tests/test_logging_config.py           | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/airflow/utils/log/wasb_task_handler.py b/airflow/utils/log/wasb_task_handler.py
index b7f726d41db52..71e1ae5d16dfd 100644
--- a/airflow/utils/log/wasb_task_handler.py
+++ b/airflow/utils/log/wasb_task_handler.py
@@ -20,7 +20,6 @@
 import shutil
 
 from airflow import configuration
-from airflow.contrib.hooks.wasb_hook import WasbHook
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.log.file_task_handler import FileTaskHandler
 from azure.common import AzureHttpError
@@ -47,6 +46,7 @@ def __init__(self, base_log_folder, wasb_log_folder, wasb_container,
     def _build_hook(self):
         remote_conn_id = configuration.get('core', 'REMOTE_LOG_CONN_ID')
         try:
+            from airflow.contrib.hooks.wasb_hook import WasbHook
             return WasbHook(remote_conn_id)
         except AzureHttpError:
             self.log.error(
diff --git a/tests/test_logging_config.py b/tests/test_logging_config.py
index 324e33a3acb2b..01f40b5e77548 100644
--- a/tests/test_logging_config.py
+++ b/tests/test_logging_config.py
@@ -251,6 +251,23 @@ def test_1_9_config(self):
         finally:
             conf.remove_option('core', 'task_log_reader', remove_default=False)
 
+    def test_loading_remote_logging_with_wasb_handler(self):
+        """Test if logging can be configured successfully for Azure Blob Storage"""
+        import logging
+        from airflow.config_templates import airflow_local_settings
+        from airflow.logging_config import configure_logging
+        from airflow.utils.log.wasb_task_handler import WasbTaskHandler
+
+        conf.set('core', 'remote_logging', 'True')
+        conf.set('core', 'remote_log_conn_id', 'some_wasb')
+        conf.set('core', 'remote_base_log_folder', 'wasb://some-folder')
+
+        six.moves.reload_module(airflow_local_settings)
+        configure_logging()
+
+        logger = logging.getLogger('airflow.task')
+        self.assertIsInstance(logger.handlers[0], WasbTaskHandler)
+
 
 if __name__ == '__main__':
     unittest.main()

From ed10eb4e01e40d44ac6bc71e28a5909f60943ce8 Mon Sep 17 00:00:00 2001
From: OmerJog <44576851+OmerJog@users.noreply.github.com>
Date: Tue, 5 Mar 2019 23:27:25 +0200
Subject: [PATCH 627/808] [AIRFLOW-4012]  - Upgrade tabulate to 0.8.3 (#4838)

Pin upper version bound to 0.9 too, so we don't have to update this again
until 0.9 is out (when we can check for compatability)
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index bd490fad0afb6..dd21fcd66cfb7 100644
--- a/setup.py
+++ b/setup.py
@@ -314,7 +314,7 @@ def do_setup():
             'requests>=2.20.0, <3',
             'setproctitle>=1.1.8, <2',
             'sqlalchemy>=1.1.15, <1.3.0',
-            'tabulate>=0.7.5, <=0.8.2',
+            'tabulate>=0.7.5, <0.9',
             'tenacity==4.12.0',
             'text-unidecode==1.2',
             'thrift>=0.9.2',

From 0fb32166825d630cc5e87b39588e280737567448 Mon Sep 17 00:00:00 2001
From: Mariko Wakabayashi <mariko@mwkby.com>
Date: Tue, 5 Mar 2019 16:14:22 -0600
Subject: [PATCH 628/808] [AIRFLOW-4019] Fix AWS Athena Sensor object has no
 attribute 'mode' (#4844)

---
 airflow/contrib/sensors/aws_athena_sensor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/sensors/aws_athena_sensor.py b/airflow/contrib/sensors/aws_athena_sensor.py
index af864d3a36694..af758b93c1335 100644
--- a/airflow/contrib/sensors/aws_athena_sensor.py
+++ b/airflow/contrib/sensors/aws_athena_sensor.py
@@ -56,7 +56,7 @@ def __init__(self,
                  aws_conn_id='aws_default',
                  sleep_time=10,
                  *args, **kwargs):
-        super(BaseSensorOperator, self).__init__(*args, **kwargs)
+        super(AthenaSensor, self).__init__(*args, **kwargs)
         self.aws_conn_id = aws_conn_id
         self.query_execution_id = query_execution_id
         self.hook = None

From 94f355c7cd3bb4e64974c2f8f0f6e796da9423ea Mon Sep 17 00:00:00 2001
From: Sergio Soto <scots4ever@gmail.com>
Date: Wed, 27 Feb 2019 16:33:15 +0100
Subject: [PATCH 629/808] [AIRFLOW-3795] provide_context param is now used
 (#4735)

* provide_context param is now used

* Fixed new PythonVirtualenvOperator test
---
 airflow/operators/python_operator.py        | 13 ++++++++++---
 tests/operators/test_virtualenv_operator.py | 14 ++++++++++++++
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 9fadee2b391c8..678e8fe986b21 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -208,6 +208,12 @@ class PythonVirtualenvOperator(PythonOperator):
     :type op_kwargs: list
     :param op_kwargs: A dict of keyword arguments to pass to python_callable.
     :type op_kwargs: dict
+    :param provide_context: if set to true, Airflow will pass a set of
+        keyword arguments that can be used in your function. This set of
+        kwargs correspond exactly to what you can use in your jinja
+        templates. For this to work, you need to define `**kwargs` in your
+        function header.
+    :type provide_context: bool
     :param string_args: Strings that are present in the global var virtualenv_string_args,
         available to python_callable at runtime as a list(str). Note that args are split
         by newline.
@@ -226,15 +232,16 @@ def __init__(self, python_callable,
                  requirements=None,
                  python_version=None, use_dill=False,
                  system_site_packages=True,
-                 op_args=None, op_kwargs=None, string_args=None,
-                 templates_dict=None, templates_exts=None, *args, **kwargs):
+                 op_args=None, op_kwargs=None, provide_context=False,
+                 string_args=None, templates_dict=None, templates_exts=None,
+                 *args, **kwargs):
         super(PythonVirtualenvOperator, self).__init__(
             python_callable=python_callable,
             op_args=op_args,
             op_kwargs=op_kwargs,
             templates_dict=templates_dict,
             templates_exts=templates_exts,
-            provide_context=False,
+            provide_context=provide_context,
             *args,
             **kwargs)
         self.requirements = requirements or []
diff --git a/tests/operators/test_virtualenv_operator.py b/tests/operators/test_virtualenv_operator.py
index 460ea2f4a25b6..dc83f2206569e 100644
--- a/tests/operators/test_virtualenv_operator.py
+++ b/tests/operators/test_virtualenv_operator.py
@@ -205,3 +205,17 @@ def test_context(self):
         def f(**kwargs):
             return kwargs['templates_dict']['ds']
         self._run_as_operator(f, templates_dict={'ds': '{{ ds }}'})
+
+    def test_provide_context(self):
+        def fn():
+            pass
+        task = PythonVirtualenvOperator(
+            python_callable=fn,
+            python_version=sys.version_info[0],
+            task_id='task',
+            dag=self.dag,
+            provide_context=True,
+        )
+        self.assertTrue(
+            task.provide_context
+        )

From f2d570385b0b7c6ca1a871bf9d92aca0231077e7 Mon Sep 17 00:00:00 2001
From: RosterIn <48057736+RosterIn@users.noreply.github.com>
Date: Thu, 28 Feb 2019 08:05:49 +0200
Subject: [PATCH 630/808] [AIRFLOW-2767] - Upgrade gunicorn to 19.5.0 to avoid
 moderate-severity CVE (#4795)

Upgrade gunicorn to 19.5.0 to avoid moderate-severity CVE
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index dd21fcd66cfb7..bf423edb5b06a 100644
--- a/setup.py
+++ b/setup.py
@@ -299,7 +299,7 @@ def do_setup():
             'funcsigs==1.0.0',
             'future>=0.16.0, <0.17',
             'gitpython>=2.0.2',
-            'gunicorn>=19.4.0, <20.0',
+            'gunicorn>=19.5.0, <20.0',
             'iso8601>=0.1.12',
             'json-merge-patch==0.2',
             'jinja2>=2.7.3, <=2.10.0',

From d4b9c069f8caf34b4f1dee40dafd963690edd954 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Thu, 20 Dec 2018 13:15:38 +0100
Subject: [PATCH 631/808] [AIRFLOW-3458] Move models.Connection into separate
 file (#4335)

---
 airflow/bin/cli.py                            |   5 +-
 airflow/contrib/executors/mesos_executor.py   |   4 +-
 airflow/contrib/hooks/gcp_sql_hook.py         |   8 +-
 airflow/hooks/base_hook.py                    |   2 +-
 airflow/{models.py => models/__init__.py}     | 244 +----------
 airflow/models/connection.py                  | 270 ++++++++++++
 airflow/utils/db.py                           |  74 ++--
 airflow/www/app.py                            |   3 +-
 airflow/www/views.py                          |  12 +-
 airflow/www_rbac/forms.py                     |   4 +-
 airflow/www_rbac/views.py                     |   3 +-
 docs/concepts.rst                             |   2 +-
 tests/contrib/hooks/test_aws_hook.py          |   2 +-
 tests/contrib/hooks/test_azure_cosmos_hook.py | 404 +++++++++---------
 .../hooks/test_azure_data_lake_hook.py        |   4 +-
 .../hooks/test_azure_fileshare_hook.py        |   6 +-
 tests/contrib/hooks/test_cassandra_hook.py    |   6 +-
 tests/contrib/hooks/test_databricks_hook.py   |   2 +-
 .../hooks/test_discord_webhook_hook.py        |   5 +-
 tests/contrib/hooks/test_imap_hook.py         |   5 +-
 tests/contrib/hooks/test_jdbc_hook.py         |   4 +-
 tests/contrib/hooks/test_jira_hook.py         |   4 +-
 tests/contrib/hooks/test_openfaas_hook.py     |   2 +-
 tests/contrib/hooks/test_sftp_hook.py         |  15 +-
 .../contrib/hooks/test_slack_webhook_hook.py  |   5 +-
 tests/contrib/hooks/test_spark_jdbc_hook.py   |   7 +-
 tests/contrib/hooks/test_spark_sql_hook.py    |   5 +-
 tests/contrib/hooks/test_spark_submit_hook.py |  21 +-
 tests/contrib/hooks/test_sqoop_hook.py        |   5 +-
 tests/contrib/hooks/test_ssh_hook.py          |   4 +-
 tests/contrib/hooks/test_wasb_hook.py         |   6 +-
 ...st_azure_cosmos_insertdocument_operator.py |   4 +-
 .../operators/test_gcp_sql_operator.py        |   2 +-
 .../operators/test_jira_operator_test.py      |   4 +-
 .../contrib/operators/test_qubole_operator.py |   3 +-
 tests/contrib/sensors/test_datadog_sensor.py  |   4 +-
 .../sensors/test_imap_attachment_sensor.py    |   5 +-
 .../contrib/sensors/test_jira_sensor_test.py  |   4 +-
 tests/contrib/sensors/test_mongo_sensor.py    |   2 +-
 tests/contrib/sensors/test_qubole_sensor.py   |   3 +-
 tests/core.py                                 |  29 +-
 tests/hooks/test_docker_hook.py               |  10 +-
 tests/hooks/test_http_hook.py                 |  23 +-
 tests/hooks/test_mysql_hook.py                |   4 +-
 tests/models.py                               |   2 +-
 tests/www_rbac/test_views.py                  |   3 +-
 46 files changed, 646 insertions(+), 599 deletions(-)
 rename airflow/{models.py => models/__init__.py} (95%)
 create mode 100644 airflow/models/connection.py

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index e78e8657d88ac..d11c3e2934a98 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -33,6 +33,8 @@
 import argparse
 from builtins import input
 from collections import namedtuple
+
+from airflow.models.connection import Connection
 from airflow.utils.timezone import parse as parsedate
 import json
 from tabulate import tabulate
@@ -55,8 +57,7 @@
 from airflow.exceptions import AirflowException, AirflowWebServerTimeout
 from airflow.executors import GetDefaultExecutor
 from airflow.models import (DagModel, DagBag, TaskInstance,
-                            DagPickle, DagRun, Variable, DagStat,
-                            Connection, DAG)
+                            DagPickle, DagRun, Variable, DagStat, DAG)
 
 from airflow.ti_deps.dep_context import (DepContext, SCHEDULER_DEPS)
 from airflow.utils import cli as cli_utils, db
diff --git a/airflow/contrib/executors/mesos_executor.py b/airflow/contrib/executors/mesos_executor.py
index 0609d71cf20b9..7aae91e6d4348 100644
--- a/airflow/contrib/executors/mesos_executor.py
+++ b/airflow/contrib/executors/mesos_executor.py
@@ -80,7 +80,7 @@ def registered(self, driver, frameworkId, masterInfo):
         if configuration.conf.getboolean('mesos', 'CHECKPOINT') and \
                 configuration.conf.get('mesos', 'FAILOVER_TIMEOUT'):
             # Import here to work around a circular import error
-            from airflow.models import Connection
+            from airflow.models.connection import Connection
 
             # Update the Framework ID in the database.
             session = Session()
@@ -253,7 +253,7 @@ def start(self):
 
             if configuration.conf.get('mesos', 'FAILOVER_TIMEOUT'):
                 # Import here to work around a circular import error
-                from airflow.models import Connection
+                from airflow.models.connection import Connection
 
                 # Query the database to get the ID of the Mesos Framework, if available.
                 conn_id = FRAMEWORK_CONNID_PREFIX + framework.name
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index a5bd51c24cc8d..57b48616be942 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -38,7 +38,7 @@
 import requests
 from googleapiclient.discovery import build
 
-from airflow import AirflowException, LoggingMixin, models
+from airflow import AirflowException, LoggingMixin
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
 
 # Number of retries - used by googleapiclient method calls to perform retries
@@ -46,7 +46,7 @@
 from airflow.hooks.base_hook import BaseHook
 from airflow.hooks.mysql_hook import MySqlHook
 from airflow.hooks.postgres_hook import PostgresHook
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.utils.db import provide_session
 
 UNIX_PATH_MAX = 108
@@ -481,8 +481,8 @@ def _download_sql_proxy_if_needed(self):
 
     @provide_session
     def _get_credential_parameters(self, session):
-        connection = session.query(models.Connection). \
-            filter(models.Connection.conn_id == self.gcp_conn_id).first()
+        connection = session.query(Connection). \
+            filter(Connection.conn_id == self.gcp_conn_id).first()
         session.expunge_all()
         if GCP_CREDENTIALS_KEY_PATH in connection.extra_dejson:
             credential_params = [
diff --git a/airflow/hooks/base_hook.py b/airflow/hooks/base_hook.py
index ef44f6469dcb1..c1283e3fb4ceb 100644
--- a/airflow/hooks/base_hook.py
+++ b/airflow/hooks/base_hook.py
@@ -25,7 +25,7 @@
 import os
 import random
 
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.exceptions import AirflowException
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
diff --git a/airflow/models.py b/airflow/models/__init__.py
similarity index 95%
rename from airflow/models.py
rename to airflow/models/__init__.py
index e76254cfcfed1..1be3e899e101f 100755
--- a/airflow/models.py
+++ b/airflow/models/__init__.py
@@ -59,7 +59,7 @@
 
 import uuid
 from datetime import datetime
-from urllib.parse import urlparse, quote, parse_qsl, unquote
+from urllib.parse import quote
 
 from sqlalchemy import (
     Boolean, Column, DateTime, Float, ForeignKey, ForeignKeyConstraint, Index,
@@ -105,6 +105,7 @@
 from airflow.utils.net import get_hostname
 from airflow.utils.log.logging_mixin import LoggingMixin
 
+
 install_aliases()
 
 Base = declarative_base()
@@ -614,247 +615,6 @@ def is_superuser(self):
         return self.superuser
 
 
-class Connection(Base, LoggingMixin):
-    """
-    Placeholder to store information about different database instances
-    connection information. The idea here is that scripts use references to
-    database instances (conn_id) instead of hard coding hostname, logins and
-    passwords when using operators or hooks.
-    """
-    __tablename__ = "connection"
-
-    id = Column(Integer(), primary_key=True)
-    conn_id = Column(String(ID_LEN))
-    conn_type = Column(String(500))
-    host = Column(String(500))
-    schema = Column(String(500))
-    login = Column(String(500))
-    _password = Column('password', String(5000))
-    port = Column(Integer())
-    is_encrypted = Column(Boolean, unique=False, default=False)
-    is_extra_encrypted = Column(Boolean, unique=False, default=False)
-    _extra = Column('extra', String(5000))
-
-    _types = [
-        ('docker', 'Docker Registry',),
-        ('fs', 'File (path)'),
-        ('ftp', 'FTP',),
-        ('google_cloud_platform', 'Google Cloud Platform'),
-        ('hdfs', 'HDFS',),
-        ('http', 'HTTP',),
-        ('hive_cli', 'Hive Client Wrapper',),
-        ('hive_metastore', 'Hive Metastore Thrift',),
-        ('hiveserver2', 'Hive Server 2 Thrift',),
-        ('jdbc', 'Jdbc Connection',),
-        ('jenkins', 'Jenkins'),
-        ('mysql', 'MySQL',),
-        ('postgres', 'Postgres',),
-        ('oracle', 'Oracle',),
-        ('vertica', 'Vertica',),
-        ('presto', 'Presto',),
-        ('s3', 'S3',),
-        ('samba', 'Samba',),
-        ('sqlite', 'Sqlite',),
-        ('ssh', 'SSH',),
-        ('cloudant', 'IBM Cloudant',),
-        ('mssql', 'Microsoft SQL Server'),
-        ('mesos_framework-id', 'Mesos Framework ID'),
-        ('jira', 'JIRA',),
-        ('redis', 'Redis',),
-        ('wasb', 'Azure Blob Storage'),
-        ('databricks', 'Databricks',),
-        ('aws', 'Amazon Web Services',),
-        ('emr', 'Elastic MapReduce',),
-        ('snowflake', 'Snowflake',),
-        ('segment', 'Segment',),
-        ('azure_data_lake', 'Azure Data Lake'),
-        ('azure_cosmos', 'Azure CosmosDB'),
-        ('cassandra', 'Cassandra',),
-        ('qubole', 'Qubole'),
-        ('mongo', 'MongoDB'),
-        ('gcpcloudsql', 'Google Cloud SQL'),
-    ]
-
-    def __init__(
-            self, conn_id=None, conn_type=None,
-            host=None, login=None, password=None,
-            schema=None, port=None, extra=None,
-            uri=None):
-        self.conn_id = conn_id
-        if uri:
-            self.parse_from_uri(uri)
-        else:
-            self.conn_type = conn_type
-            self.host = host
-            self.login = login
-            self.password = password
-            self.schema = schema
-            self.port = port
-            self.extra = extra
-
-    def parse_from_uri(self, uri):
-        uri_parts = urlparse(uri)
-        hostname = uri_parts.hostname or ''
-        conn_type = uri_parts.scheme
-        if conn_type == 'postgresql':
-            conn_type = 'postgres'
-        elif '-' in conn_type:
-            conn_type = conn_type.replace('-', '_')
-        self.conn_type = conn_type
-        self.host = unquote(hostname) if hostname else hostname
-        quoted_schema = uri_parts.path[1:]
-        self.schema = unquote(quoted_schema) if quoted_schema else quoted_schema
-        self.login = unquote(uri_parts.username) \
-            if uri_parts.username else uri_parts.username
-        self.password = unquote(uri_parts.password) \
-            if uri_parts.password else uri_parts.password
-        self.port = uri_parts.port
-        if uri_parts.query:
-            self.extra = json.dumps(dict(parse_qsl(uri_parts.query)))
-
-    def get_password(self):
-        if self._password and self.is_encrypted:
-            fernet = get_fernet()
-            if not fernet.is_encrypted:
-                raise AirflowException(
-                    "Can't decrypt encrypted password for login={}, \
-                    FERNET_KEY configuration is missing".format(self.login))
-            return fernet.decrypt(bytes(self._password, 'utf-8')).decode()
-        else:
-            return self._password
-
-    def set_password(self, value):
-        if value:
-            fernet = get_fernet()
-            self._password = fernet.encrypt(bytes(value, 'utf-8')).decode()
-            self.is_encrypted = fernet.is_encrypted
-
-    @declared_attr
-    def password(cls):
-        return synonym('_password',
-                       descriptor=property(cls.get_password, cls.set_password))
-
-    def get_extra(self):
-        if self._extra and self.is_extra_encrypted:
-            fernet = get_fernet()
-            if not fernet.is_encrypted:
-                raise AirflowException(
-                    "Can't decrypt `extra` params for login={},\
-                    FERNET_KEY configuration is missing".format(self.login))
-            return fernet.decrypt(bytes(self._extra, 'utf-8')).decode()
-        else:
-            return self._extra
-
-    def set_extra(self, value):
-        if value:
-            fernet = get_fernet()
-            self._extra = fernet.encrypt(bytes(value, 'utf-8')).decode()
-            self.is_extra_encrypted = fernet.is_encrypted
-        else:
-            self._extra = value
-            self.is_extra_encrypted = False
-
-    @declared_attr
-    def extra(cls):
-        return synonym('_extra',
-                       descriptor=property(cls.get_extra, cls.set_extra))
-
-    def get_hook(self):
-        try:
-            if self.conn_type == 'mysql':
-                from airflow.hooks.mysql_hook import MySqlHook
-                return MySqlHook(mysql_conn_id=self.conn_id)
-            elif self.conn_type == 'google_cloud_platform':
-                from airflow.contrib.hooks.bigquery_hook import BigQueryHook
-                return BigQueryHook(bigquery_conn_id=self.conn_id)
-            elif self.conn_type == 'postgres':
-                from airflow.hooks.postgres_hook import PostgresHook
-                return PostgresHook(postgres_conn_id=self.conn_id)
-            elif self.conn_type == 'hive_cli':
-                from airflow.hooks.hive_hooks import HiveCliHook
-                return HiveCliHook(hive_cli_conn_id=self.conn_id)
-            elif self.conn_type == 'presto':
-                from airflow.hooks.presto_hook import PrestoHook
-                return PrestoHook(presto_conn_id=self.conn_id)
-            elif self.conn_type == 'hiveserver2':
-                from airflow.hooks.hive_hooks import HiveServer2Hook
-                return HiveServer2Hook(hiveserver2_conn_id=self.conn_id)
-            elif self.conn_type == 'sqlite':
-                from airflow.hooks.sqlite_hook import SqliteHook
-                return SqliteHook(sqlite_conn_id=self.conn_id)
-            elif self.conn_type == 'jdbc':
-                from airflow.hooks.jdbc_hook import JdbcHook
-                return JdbcHook(jdbc_conn_id=self.conn_id)
-            elif self.conn_type == 'mssql':
-                from airflow.hooks.mssql_hook import MsSqlHook
-                return MsSqlHook(mssql_conn_id=self.conn_id)
-            elif self.conn_type == 'oracle':
-                from airflow.hooks.oracle_hook import OracleHook
-                return OracleHook(oracle_conn_id=self.conn_id)
-            elif self.conn_type == 'vertica':
-                from airflow.contrib.hooks.vertica_hook import VerticaHook
-                return VerticaHook(vertica_conn_id=self.conn_id)
-            elif self.conn_type == 'cloudant':
-                from airflow.contrib.hooks.cloudant_hook import CloudantHook
-                return CloudantHook(cloudant_conn_id=self.conn_id)
-            elif self.conn_type == 'jira':
-                from airflow.contrib.hooks.jira_hook import JiraHook
-                return JiraHook(jira_conn_id=self.conn_id)
-            elif self.conn_type == 'redis':
-                from airflow.contrib.hooks.redis_hook import RedisHook
-                return RedisHook(redis_conn_id=self.conn_id)
-            elif self.conn_type == 'wasb':
-                from airflow.contrib.hooks.wasb_hook import WasbHook
-                return WasbHook(wasb_conn_id=self.conn_id)
-            elif self.conn_type == 'docker':
-                from airflow.hooks.docker_hook import DockerHook
-                return DockerHook(docker_conn_id=self.conn_id)
-            elif self.conn_type == 'azure_data_lake':
-                from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
-                return AzureDataLakeHook(azure_data_lake_conn_id=self.conn_id)
-            elif self.conn_type == 'azure_cosmos':
-                from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
-                return AzureCosmosDBHook(azure_cosmos_conn_id=self.conn_id)
-            elif self.conn_type == 'cassandra':
-                from airflow.contrib.hooks.cassandra_hook import CassandraHook
-                return CassandraHook(cassandra_conn_id=self.conn_id)
-            elif self.conn_type == 'mongo':
-                from airflow.contrib.hooks.mongo_hook import MongoHook
-                return MongoHook(conn_id=self.conn_id)
-            elif self.conn_type == 'gcpcloudsql':
-                from airflow.contrib.hooks.gcp_sql_hook import CloudSqlDatabaseHook
-                return CloudSqlDatabaseHook(gcp_cloudsql_conn_id=self.conn_id)
-        except Exception:
-            pass
-
-    def __repr__(self):
-        return self.conn_id
-
-    def debug_info(self):
-        return ("id: {}. Host: {}, Port: {}, Schema: {}, "
-                "Login: {}, Password: {}, extra: {}".
-                format(self.conn_id,
-                       self.host,
-                       self.port,
-                       self.schema,
-                       self.login,
-                       "XXXXXXXX" if self.password else None,
-                       self.extra_dejson))
-
-    @property
-    def extra_dejson(self):
-        """Returns the extra property by deserializing json."""
-        obj = {}
-        if self.extra:
-            try:
-                obj = json.loads(self.extra)
-            except Exception as e:
-                self.log.exception(e)
-                self.log.error("Failed parsing the json for conn_id %s", self.conn_id)
-
-        return obj
-
-
 class DagPickle(Base):
     """
     Dags can originate from different places (user repos, master repo, ...)
diff --git a/airflow/models/connection.py b/airflow/models/connection.py
new file mode 100644
index 0000000000000..aeed9b68bdcab
--- /dev/null
+++ b/airflow/models/connection.py
@@ -0,0 +1,270 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+from builtins import bytes
+from urllib.parse import urlparse, unquote, parse_qsl
+
+from sqlalchemy import Column, Integer, String, Boolean
+from sqlalchemy.ext.declarative import declared_attr
+from sqlalchemy.orm import synonym
+
+from airflow import LoggingMixin, AirflowException
+from airflow.models import Base, ID_LEN, get_fernet
+
+
+class Connection(Base, LoggingMixin):
+    """
+    Placeholder to store information about different database instances
+    connection information. The idea here is that scripts use references to
+    database instances (conn_id) instead of hard coding hostname, logins and
+    passwords when using operators or hooks.
+    """
+    __tablename__ = "connection"
+
+    id = Column(Integer(), primary_key=True)
+    conn_id = Column(String(ID_LEN))
+    conn_type = Column(String(500))
+    host = Column(String(500))
+    schema = Column(String(500))
+    login = Column(String(500))
+    _password = Column('password', String(5000))
+    port = Column(Integer())
+    is_encrypted = Column(Boolean, unique=False, default=False)
+    is_extra_encrypted = Column(Boolean, unique=False, default=False)
+    _extra = Column('extra', String(5000))
+
+    _types = [
+        ('docker', 'Docker Registry',),
+        ('fs', 'File (path)'),
+        ('ftp', 'FTP',),
+        ('google_cloud_platform', 'Google Cloud Platform'),
+        ('hdfs', 'HDFS',),
+        ('http', 'HTTP',),
+        ('hive_cli', 'Hive Client Wrapper',),
+        ('hive_metastore', 'Hive Metastore Thrift',),
+        ('hiveserver2', 'Hive Server 2 Thrift',),
+        ('jdbc', 'Jdbc Connection',),
+        ('jenkins', 'Jenkins'),
+        ('mysql', 'MySQL',),
+        ('postgres', 'Postgres',),
+        ('oracle', 'Oracle',),
+        ('vertica', 'Vertica',),
+        ('presto', 'Presto',),
+        ('s3', 'S3',),
+        ('samba', 'Samba',),
+        ('sqlite', 'Sqlite',),
+        ('ssh', 'SSH',),
+        ('cloudant', 'IBM Cloudant',),
+        ('mssql', 'Microsoft SQL Server'),
+        ('mesos_framework-id', 'Mesos Framework ID'),
+        ('jira', 'JIRA',),
+        ('redis', 'Redis',),
+        ('wasb', 'Azure Blob Storage'),
+        ('databricks', 'Databricks',),
+        ('aws', 'Amazon Web Services',),
+        ('emr', 'Elastic MapReduce',),
+        ('snowflake', 'Snowflake',),
+        ('segment', 'Segment',),
+        ('azure_data_lake', 'Azure Data Lake'),
+        ('azure_cosmos', 'Azure CosmosDB'),
+        ('cassandra', 'Cassandra',),
+        ('qubole', 'Qubole'),
+        ('mongo', 'MongoDB'),
+        ('gcpcloudsql', 'Google Cloud SQL'),
+    ]
+
+    def __init__(
+            self, conn_id=None, conn_type=None,
+            host=None, login=None, password=None,
+            schema=None, port=None, extra=None,
+            uri=None):
+        self.conn_id = conn_id
+        if uri:
+            self.parse_from_uri(uri)
+        else:
+            self.conn_type = conn_type
+            self.host = host
+            self.login = login
+            self.password = password
+            self.schema = schema
+            self.port = port
+            self.extra = extra
+
+    def parse_from_uri(self, uri):
+        uri_parts = urlparse(uri)
+        hostname = uri_parts.hostname or ''
+        conn_type = uri_parts.scheme
+        if conn_type == 'postgresql':
+            conn_type = 'postgres'
+        elif '-' in conn_type:
+            conn_type = conn_type.replace('-', '_')
+        self.conn_type = conn_type
+        self.host = unquote(hostname) if hostname else hostname
+        quoted_schema = uri_parts.path[1:]
+        self.schema = unquote(quoted_schema) if quoted_schema else quoted_schema
+        self.login = unquote(uri_parts.username) \
+            if uri_parts.username else uri_parts.username
+        self.password = unquote(uri_parts.password) \
+            if uri_parts.password else uri_parts.password
+        self.port = uri_parts.port
+        if uri_parts.query:
+            self.extra = json.dumps(dict(parse_qsl(uri_parts.query)))
+
+    def get_password(self):
+        if self._password and self.is_encrypted:
+            fernet = get_fernet()
+            if not fernet.is_encrypted:
+                raise AirflowException(
+                    "Can't decrypt encrypted password for login={}, \
+                    FERNET_KEY configuration is missing".format(self.login))
+            return fernet.decrypt(bytes(self._password, 'utf-8')).decode()
+        else:
+            return self._password
+
+    def set_password(self, value):
+        if value:
+            fernet = get_fernet()
+            self._password = fernet.encrypt(bytes(value, 'utf-8')).decode()
+            self.is_encrypted = fernet.is_encrypted
+
+    @declared_attr
+    def password(cls):
+        return synonym('_password',
+                       descriptor=property(cls.get_password, cls.set_password))
+
+    def get_extra(self):
+        if self._extra and self.is_extra_encrypted:
+            fernet = get_fernet()
+            if not fernet.is_encrypted:
+                raise AirflowException(
+                    "Can't decrypt `extra` params for login={},\
+                    FERNET_KEY configuration is missing".format(self.login))
+            return fernet.decrypt(bytes(self._extra, 'utf-8')).decode()
+        else:
+            return self._extra
+
+    def set_extra(self, value):
+        if value:
+            fernet = get_fernet()
+            self._extra = fernet.encrypt(bytes(value, 'utf-8')).decode()
+            self.is_extra_encrypted = fernet.is_encrypted
+        else:
+            self._extra = value
+            self.is_extra_encrypted = False
+
+    @declared_attr
+    def extra(cls):
+        return synonym('_extra',
+                       descriptor=property(cls.get_extra, cls.set_extra))
+
+    def get_hook(self):
+        try:
+            if self.conn_type == 'mysql':
+                from airflow.hooks.mysql_hook import MySqlHook
+                return MySqlHook(mysql_conn_id=self.conn_id)
+            elif self.conn_type == 'google_cloud_platform':
+                from airflow.contrib.hooks.bigquery_hook import BigQueryHook
+                return BigQueryHook(bigquery_conn_id=self.conn_id)
+            elif self.conn_type == 'postgres':
+                from airflow.hooks.postgres_hook import PostgresHook
+                return PostgresHook(postgres_conn_id=self.conn_id)
+            elif self.conn_type == 'hive_cli':
+                from airflow.hooks.hive_hooks import HiveCliHook
+                return HiveCliHook(hive_cli_conn_id=self.conn_id)
+            elif self.conn_type == 'presto':
+                from airflow.hooks.presto_hook import PrestoHook
+                return PrestoHook(presto_conn_id=self.conn_id)
+            elif self.conn_type == 'hiveserver2':
+                from airflow.hooks.hive_hooks import HiveServer2Hook
+                return HiveServer2Hook(hiveserver2_conn_id=self.conn_id)
+            elif self.conn_type == 'sqlite':
+                from airflow.hooks.sqlite_hook import SqliteHook
+                return SqliteHook(sqlite_conn_id=self.conn_id)
+            elif self.conn_type == 'jdbc':
+                from airflow.hooks.jdbc_hook import JdbcHook
+                return JdbcHook(jdbc_conn_id=self.conn_id)
+            elif self.conn_type == 'mssql':
+                from airflow.hooks.mssql_hook import MsSqlHook
+                return MsSqlHook(mssql_conn_id=self.conn_id)
+            elif self.conn_type == 'oracle':
+                from airflow.hooks.oracle_hook import OracleHook
+                return OracleHook(oracle_conn_id=self.conn_id)
+            elif self.conn_type == 'vertica':
+                from airflow.contrib.hooks.vertica_hook import VerticaHook
+                return VerticaHook(vertica_conn_id=self.conn_id)
+            elif self.conn_type == 'cloudant':
+                from airflow.contrib.hooks.cloudant_hook import CloudantHook
+                return CloudantHook(cloudant_conn_id=self.conn_id)
+            elif self.conn_type == 'jira':
+                from airflow.contrib.hooks.jira_hook import JiraHook
+                return JiraHook(jira_conn_id=self.conn_id)
+            elif self.conn_type == 'redis':
+                from airflow.contrib.hooks.redis_hook import RedisHook
+                return RedisHook(redis_conn_id=self.conn_id)
+            elif self.conn_type == 'wasb':
+                from airflow.contrib.hooks.wasb_hook import WasbHook
+                return WasbHook(wasb_conn_id=self.conn_id)
+            elif self.conn_type == 'docker':
+                from airflow.hooks.docker_hook import DockerHook
+                return DockerHook(docker_conn_id=self.conn_id)
+            elif self.conn_type == 'azure_data_lake':
+                from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
+                return AzureDataLakeHook(azure_data_lake_conn_id=self.conn_id)
+            elif self.conn_type == 'azure_cosmos':
+                from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+                return AzureCosmosDBHook(azure_cosmos_conn_id=self.conn_id)
+            elif self.conn_type == 'cassandra':
+                from airflow.contrib.hooks.cassandra_hook import CassandraHook
+                return CassandraHook(cassandra_conn_id=self.conn_id)
+            elif self.conn_type == 'mongo':
+                from airflow.contrib.hooks.mongo_hook import MongoHook
+                return MongoHook(conn_id=self.conn_id)
+            elif self.conn_type == 'gcpcloudsql':
+                from airflow.contrib.hooks.gcp_sql_hook import CloudSqlDatabaseHook
+                return CloudSqlDatabaseHook(gcp_cloudsql_conn_id=self.conn_id)
+        except Exception:
+            pass
+
+    def __repr__(self):
+        return self.conn_id
+
+    def debug_info(self):
+        return ("id: {}. Host: {}, Port: {}, Schema: {}, "
+                "Login: {}, Password: {}, extra: {}".
+                format(self.conn_id,
+                       self.host,
+                       self.port,
+                       self.schema,
+                       self.login,
+                       "XXXXXXXX" if self.password else None,
+                       self.extra_dejson))
+
+    @property
+    def extra_dejson(self):
+        """Returns the extra property by deserializing json."""
+        obj = {}
+        if self.extra:
+            try:
+                obj = json.loads(self.extra)
+            except Exception as e:
+                self.log.exception(e)
+                self.log.error("Failed parsing the json for conn_id %s", self.conn_id)
+
+        return obj
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index a89f1a88cebd7..e44614a2eab92 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -77,9 +77,8 @@ def wrapper(*args, **kwargs):
 
 @provide_session
 def merge_conn(conn, session=None):
-    from airflow import models
-    C = models.Connection
-    if not session.query(C).filter(C.conn_id == conn.conn_id).first():
+    from airflow.models.connection import Connection
+    if not session.query(Connection).filter(Connection.conn_id == conn.conn_id).first():
         session.add(conn)
         session.commit()
 
@@ -88,133 +87,134 @@ def initdb(rbac=False):
     session = settings.Session()
 
     from airflow import models
+    from airflow.models.connection import Connection
     upgradedb()
 
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='airflow_db', conn_type='mysql',
             host='mysql', login='root', password='',
             schema='airflow'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='beeline_default', conn_type='beeline', port="10000",
             host='localhost', extra="{\"use_beeline\": true, \"auth\": \"\"}",
             schema='default'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='bigquery_default', conn_type='google_cloud_platform',
             schema='default'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='local_mysql', conn_type='mysql',
             host='localhost', login='airflow', password='airflow',
             schema='airflow'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='presto_default', conn_type='presto',
             host='localhost',
             schema='hive', port=3400))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='google_cloud_default', conn_type='google_cloud_platform',
             schema='default',))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='hive_cli_default', conn_type='hive_cli',
             schema='default',))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='hiveserver2_default', conn_type='hiveserver2',
             host='localhost',
             schema='default', port=10000))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='metastore_default', conn_type='hive_metastore',
             host='localhost', extra="{\"authMechanism\": \"PLAIN\"}",
             port=9083))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='mongo_default', conn_type='mongo',
             host='mongo', port=27017))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='mysql_default', conn_type='mysql',
             login='root',
             schema='airflow',
             host='mysql'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='postgres_default', conn_type='postgres',
             login='postgres',
             password='airflow',
             schema='airflow',
             host='postgres'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='sqlite_default', conn_type='sqlite',
             host='/tmp/sqlite_default.db'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='http_default', conn_type='http',
             host='https://www.google.com/'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='mssql_default', conn_type='mssql',
             host='localhost', port=1433))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='vertica_default', conn_type='vertica',
             host='localhost', port=5433))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='wasb_default', conn_type='wasb',
             extra='{"sas_token": null}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='webhdfs_default', conn_type='hdfs',
             host='localhost', port=50070))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='ssh_default', conn_type='ssh',
             host='localhost'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='sftp_default', conn_type='sftp',
             host='localhost', port=22, login='airflow',
             extra='''
                 {"key_file": "~/.ssh/id_rsa", "no_host_key_check": true}
             '''))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='fs_default', conn_type='fs',
             extra='{"path": "/"}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='aws_default', conn_type='aws',
             extra='{"region_name": "us-east-1"}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='spark_default', conn_type='spark',
             host='yarn', extra='{"queue": "root.default"}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='druid_broker_default', conn_type='druid',
             host='druid-broker', port=8082, extra='{"endpoint": "druid/v2/sql"}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='druid_ingest_default', conn_type='druid',
             host='druid-overlord', port=8081, extra='{"endpoint": "druid/indexer/v1/task"}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='redis_default', conn_type='redis',
             host='redis', port=6379,
             extra='{"db": 0}'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='sqoop_default', conn_type='sqoop',
             host='rmdbs', extra=''))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='emr_default', conn_type='emr',
             extra='''
                 {   "Name": "default_job_flow_name",
@@ -261,27 +261,27 @@ def initdb(rbac=False):
                 }
             '''))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='databricks_default', conn_type='databricks',
             host='localhost'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='qubole_default', conn_type='qubole',
             host='localhost'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='segment_default', conn_type='segment',
             extra='{"write_key": "my-segment-write-key"}')),
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='azure_data_lake_default', conn_type='azure_data_lake',
             extra='{"tenant": "<TENANT>", "account_name": "<ACCOUNTNAME>" }'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='azure_cosmos_default', conn_type='azure_cosmos',
             extra='{"database_name": "<DATABASE_NAME>", "collection_name": "<COLLECTION_NAME>" }'))
     merge_conn(
-        models.Connection(
+        Connection(
             conn_id='cassandra_default', conn_type='cassandra',
             host='cassandra', port=9042))
 
diff --git a/airflow/www/app.py b/airflow/www/app.py
index f2041dd9f3bea..8121585f6472c 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -30,6 +30,7 @@
 import airflow
 from airflow import configuration as conf
 from airflow import models, LoggingMixin
+from airflow.models.connection import Connection
 from airflow.settings import Session
 
 from airflow.www.blueprints import routes
@@ -111,7 +112,7 @@ def create_app(config=None, testing=False):
         av(vs.UserModelView(
             models.User, Session, name="Users", category="Admin"))
         av(vs.ConnectionModelView(
-            models.Connection, Session, name="Connections", category="Admin"))
+            Connection, Session, name="Connections", category="Admin"))
         av(vs.VariableView(
             models.Variable, Session, name="Variables", category="Admin"))
         av(vs.XComView(
diff --git a/airflow/www/views.py b/airflow/www/views.py
index dc7d0b7860a1d..947c0ed3b08f9 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -67,6 +67,7 @@
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
 from airflow.models import XCom, DagRun
+from airflow.models.connection import Connection
 from airflow.operators.subdag_operator import SubDagOperator
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
@@ -393,7 +394,7 @@ def chart_data(self):
             csv = request.args.get('csv') == "true"
             chart = session.query(models.Chart).filter_by(id=chart_id).first()
             db = session.query(
-                models.Connection).filter_by(conn_id=chart.conn_id).first()
+                Connection).filter_by(conn_id=chart.conn_id).first()
 
         payload = {
             "state": "ERROR",
@@ -2221,8 +2222,7 @@ class QueryView(wwwutils.DataProfilingMixin, BaseView):
     @wwwutils.gzipped
     @provide_session
     def query(self, session=None):
-        dbs = session.query(models.Connection).order_by(
-            models.Connection.conn_id).all()
+        dbs = session.query(Connection).order_by(Connection.conn_id).all()
         session.expunge_all()
         db_choices = list(
             ((db.conn_id, db.conn_id) for db in dbs if db.get_hook()))
@@ -2340,8 +2340,8 @@ class SlaMissModelView(wwwutils.SuperUserMixin, ModelViewOnly):
 def _connection_ids(session=None):
     return [(c.conn_id, c.conn_id) for c in (
         session
-            .query(models.Connection.conn_id)
-            .group_by(models.Connection.conn_id))]
+            .query(Connection.conn_id)
+            .group_by(Connection.conn_id))]
 
 
 class ChartModelView(wwwutils.DataProfilingMixin, AirflowModelView):
@@ -3001,7 +3001,7 @@ class ConnectionModelView(wwwutils.SuperUserMixin, AirflowModelView):
         'extra__google_cloud_platform__scope': StringField('Scopes (comma separated)'),
     }
     form_choices = {
-        'conn_type': models.Connection._types
+        'conn_type': Connection._types
     }
 
     def on_model_change(self, form, model, is_created):
diff --git a/airflow/www_rbac/forms.py b/airflow/www_rbac/forms.py
index 61c34888e3568..0a36a90ef3ced 100644
--- a/airflow/www_rbac/forms.py
+++ b/airflow/www_rbac/forms.py
@@ -22,7 +22,7 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import timezone
 
 from flask_appbuilder.forms import DynamicForm
@@ -93,7 +93,7 @@ class ConnectionForm(DynamicForm):
         widget=BS3TextFieldWidget())
     conn_type = SelectField(
         lazy_gettext('Conn Type'),
-        choices=models.Connection._types,
+        choices=Connection._types,
         widget=Select2Widget())
     host = StringField(
         lazy_gettext('Host'),
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 61fa15cd87056..b36061b914644 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -54,6 +54,7 @@
 from airflow.api.common.experimental.mark_tasks import (set_dag_run_state_to_success,
                                                         set_dag_run_state_to_failed)
 from airflow.models import XCom, DagRun
+from airflow.models.connection import Connection
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
 from airflow.utils.dates import infer_time_unit, scale_time_units
@@ -1936,7 +1937,7 @@ def action_muldelete(self, items):
 class ConnectionModelView(AirflowModelView):
     route_base = '/connection'
 
-    datamodel = AirflowModelView.CustomSQLAInterface(models.Connection)
+    datamodel = AirflowModelView.CustomSQLAInterface(Connection)
 
     base_permissions = ['can_add', 'can_list', 'can_edit', 'can_delete']
 
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 0ac187fe859e9..74bcd93418a9a 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -286,7 +286,7 @@ Hooks
 Hooks are interfaces to external platforms and databases like Hive, S3,
 MySQL, Postgres, HDFS, and Pig. Hooks implement a common interface when
 possible, and act as a building block for operators. They also use
-the ``airflow.models.Connection`` model to retrieve hostnames
+the ``airflow.models.connection.Connection`` model to retrieve hostnames
 and authentication information. Hooks keep authentication code and
 information out of pipelines, centralized in the metadata database.
 
diff --git a/tests/contrib/hooks/test_aws_hook.py b/tests/contrib/hooks/test_aws_hook.py
index addee85109194..f842b44e908ee 100644
--- a/tests/contrib/hooks/test_aws_hook.py
+++ b/tests/contrib/hooks/test_aws_hook.py
@@ -23,7 +23,7 @@
 import boto3
 
 from airflow import configuration
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.contrib.hooks.aws_hook import AwsHook
 
 try:
diff --git a/tests/contrib/hooks/test_azure_cosmos_hook.py b/tests/contrib/hooks/test_azure_cosmos_hook.py
index 653242a34b48f..4c926b5d89d2b 100644
--- a/tests/contrib/hooks/test_azure_cosmos_hook.py
+++ b/tests/contrib/hooks/test_azure_cosmos_hook.py
@@ -1,202 +1,202 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-#
-
-
-import json
-import unittest
-import uuid
-
-from airflow.exceptions import AirflowException
-from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
-
-from airflow import configuration
-from airflow import models
-from airflow.utils import db
-
-import logging
-
-try:
-    from unittest import mock
-
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-
-class TestAzureCosmosDbHook(unittest.TestCase):
-
-    # Set up an environment to test with
-    def setUp(self):
-        # set up some test variables
-        self.test_end_point = 'https://test_endpoint:443'
-        self.test_master_key = 'magic_test_key'
-        self.test_database_name = 'test_database_name'
-        self.test_collection_name = 'test_collection_name'
-        self.test_database_default = 'test_database_default'
-        self.test_collection_default = 'test_collection_default'
-        configuration.load_test_config()
-        db.merge_conn(
-            models.Connection(
-                conn_id='azure_cosmos_test_key_id',
-                conn_type='azure_cosmos',
-                login=self.test_end_point,
-                password=self.test_master_key,
-                extra=json.dumps({'database_name': self.test_database_default,
-                                  'collection_name': self.test_collection_default})
-            )
-        )
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_create_database(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.create_database(self.test_database_name)
-        expected_calls = [mock.call().CreateDatabase({'id': self.test_database_name})]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_create_database_exception(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.assertRaises(AirflowException, self.cosmos.create_database, None)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_create_container_exception(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.assertRaises(AirflowException, self.cosmos.create_collection, None)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_create_container(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.create_collection(self.test_collection_name, self.test_database_name)
-        expected_calls = [mock.call().CreateContainer(
-            'dbs/test_database_name',
-            {'id': self.test_collection_name})]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_create_container_default(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.create_collection(self.test_collection_name)
-        expected_calls = [mock.call().CreateContainer(
-            'dbs/test_database_default',
-            {'id': self.test_collection_name})]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_upsert_document_default(self, cosmos_mock):
-        test_id = str(uuid.uuid4())
-        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        returned_item = self.cosmos.upsert_document({'id': test_id})
-        expected_calls = [mock.call().CreateItem(
-            'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
-            {'id': test_id})]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-        logging.getLogger().info(returned_item)
-        self.assertEqual(returned_item['id'], test_id)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_upsert_document(self, cosmos_mock):
-        test_id = str(uuid.uuid4())
-        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        returned_item = self.cosmos.upsert_document(
-            {'data1': 'somedata'},
-            database_name=self.test_database_name,
-            collection_name=self.test_collection_name,
-            document_id=test_id)
-
-        expected_calls = [mock.call().CreateItem(
-            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
-            {'data1': 'somedata', 'id': test_id})]
-
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-        logging.getLogger().info(returned_item)
-        self.assertEqual(returned_item['id'], test_id)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_insert_documents(self, cosmos_mock):
-        test_id1 = str(uuid.uuid4())
-        test_id2 = str(uuid.uuid4())
-        test_id3 = str(uuid.uuid4())
-        documents = [
-            {'id': test_id1, 'data': 'data1'},
-            {'id': test_id2, 'data': 'data2'},
-            {'id': test_id3, 'data': 'data3'}]
-
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        returned_item = self.cosmos.insert_documents(documents)
-        expected_calls = [
-            mock.call().CreateItem(
-                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
-                {'data': 'data1', 'id': test_id1}),
-            mock.call().CreateItem(
-                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
-                {'data': 'data2', 'id': test_id2}),
-            mock.call().CreateItem(
-                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
-                {'data': 'data3', 'id': test_id3})]
-        logging.getLogger().info(returned_item)
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_delete_database(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.delete_database(self.test_database_name)
-        expected_calls = [mock.call().DeleteDatabase('dbs/test_database_name')]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_delete_database_exception(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.assertRaises(AirflowException, self.cosmos.delete_database, None)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_delete_container_exception(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.assertRaises(AirflowException, self.cosmos.delete_collection, None)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_delete_container(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.delete_collection(self.test_collection_name, self.test_database_name)
-        expected_calls = [mock.call().DeleteContainer('dbs/test_database_name/colls/test_collection_name')]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
-    def test_delete_container_default(self, cosmos_mock):
-        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
-        self.cosmos.delete_collection(self.test_collection_name)
-        expected_calls = [mock.call().DeleteContainer('dbs/test_database_default/colls/test_collection_name')]
-        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
-        cosmos_mock.assert_has_calls(expected_calls)
-
-
-if __name__ == '__main__':
-    unittest.main()
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+
+import json
+import unittest
+import uuid
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.hooks.azure_cosmos_hook import AzureCosmosDBHook
+
+from airflow import configuration
+from airflow.models.connection import Connection
+from airflow.utils import db
+
+import logging
+
+try:
+    from unittest import mock
+
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestAzureCosmosDbHook(unittest.TestCase):
+
+    # Set up an environment to test with
+    def setUp(self):
+        # set up some test variables
+        self.test_end_point = 'https://test_endpoint:443'
+        self.test_master_key = 'magic_test_key'
+        self.test_database_name = 'test_database_name'
+        self.test_collection_name = 'test_collection_name'
+        self.test_database_default = 'test_database_default'
+        self.test_collection_default = 'test_collection_default'
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id='azure_cosmos_test_key_id',
+                conn_type='azure_cosmos',
+                login=self.test_end_point,
+                password=self.test_master_key,
+                extra=json.dumps({'database_name': self.test_database_default,
+                                  'collection_name': self.test_collection_default})
+            )
+        )
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_database(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_database(self.test_database_name)
+        expected_calls = [mock.call().CreateDatabase({'id': self.test_database_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_database_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.create_database, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.create_collection, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_collection(self.test_collection_name, self.test_database_name)
+        expected_calls = [mock.call().CreateContainer(
+            'dbs/test_database_name',
+            {'id': self.test_collection_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_create_container_default(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.create_collection(self.test_collection_name)
+        expected_calls = [mock.call().CreateContainer(
+            'dbs/test_database_default',
+            {'id': self.test_collection_name})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_upsert_document_default(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.upsert_document({'id': test_id})
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+            {'id': test_id})]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+        logging.getLogger().info(returned_item)
+        self.assertEqual(returned_item['id'], test_id)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_upsert_document(self, cosmos_mock):
+        test_id = str(uuid.uuid4())
+        cosmos_mock.return_value.CreateItem.return_value = {'id': test_id}
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.upsert_document(
+            {'data1': 'somedata'},
+            database_name=self.test_database_name,
+            collection_name=self.test_collection_name,
+            document_id=test_id)
+
+        expected_calls = [mock.call().CreateItem(
+            'dbs/' + self.test_database_name + '/colls/' + self.test_collection_name,
+            {'data1': 'somedata', 'id': test_id})]
+
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+        logging.getLogger().info(returned_item)
+        self.assertEqual(returned_item['id'], test_id)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_insert_documents(self, cosmos_mock):
+        test_id1 = str(uuid.uuid4())
+        test_id2 = str(uuid.uuid4())
+        test_id3 = str(uuid.uuid4())
+        documents = [
+            {'id': test_id1, 'data': 'data1'},
+            {'id': test_id2, 'data': 'data2'},
+            {'id': test_id3, 'data': 'data3'}]
+
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        returned_item = self.cosmos.insert_documents(documents)
+        expected_calls = [
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data1', 'id': test_id1}),
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data2', 'id': test_id2}),
+            mock.call().CreateItem(
+                'dbs/' + self.test_database_default + '/colls/' + self.test_collection_default,
+                {'data': 'data3', 'id': test_id3})]
+        logging.getLogger().info(returned_item)
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_database(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_database(self.test_database_name)
+        expected_calls = [mock.call().DeleteDatabase('dbs/test_database_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_database_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.delete_database, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container_exception(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.assertRaises(AirflowException, self.cosmos.delete_collection, None)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_collection(self.test_collection_name, self.test_database_name)
+        expected_calls = [mock.call().DeleteContainer('dbs/test_database_name/colls/test_collection_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+    @mock.patch('azure.cosmos.cosmos_client.CosmosClient')
+    def test_delete_container_default(self, cosmos_mock):
+        self.cosmos = AzureCosmosDBHook(azure_cosmos_conn_id='azure_cosmos_test_key_id')
+        self.cosmos.delete_collection(self.test_collection_name)
+        expected_calls = [mock.call().DeleteContainer('dbs/test_database_default/colls/test_collection_name')]
+        cosmos_mock.assert_any_call(self.test_end_point, {'masterKey': self.test_master_key})
+        cosmos_mock.assert_has_calls(expected_calls)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/hooks/test_azure_data_lake_hook.py b/tests/contrib/hooks/test_azure_data_lake_hook.py
index d99581b829209..00ad086813219 100644
--- a/tests/contrib/hooks/test_azure_data_lake_hook.py
+++ b/tests/contrib/hooks/test_azure_data_lake_hook.py
@@ -23,7 +23,7 @@
 import unittest
 
 from airflow import configuration
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 try:
@@ -40,7 +40,7 @@ class TestAzureDataLakeHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='adl_test_key',
                 conn_type='azure_data_lake',
                 login='client_id',
diff --git a/tests/contrib/hooks/test_azure_fileshare_hook.py b/tests/contrib/hooks/test_azure_fileshare_hook.py
index 5803cd83f7a0f..43c075e9463b2 100644
--- a/tests/contrib/hooks/test_azure_fileshare_hook.py
+++ b/tests/contrib/hooks/test_azure_fileshare_hook.py
@@ -23,8 +23,8 @@
 import unittest
 
 from airflow import configuration
-from airflow import models
 from airflow.contrib.hooks.azure_fileshare_hook import AzureFileShareHook
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 
@@ -42,13 +42,13 @@ class TestAzureFileshareHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='wasb_test_key', conn_type='wasb',
                 login='login', password='key'
             )
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='wasb_test_sas_token', conn_type='wasb',
                 login='login', extra=json.dumps({'sas_token': 'token'})
             )
diff --git a/tests/contrib/hooks/test_cassandra_hook.py b/tests/contrib/hooks/test_cassandra_hook.py
index 73dac4f3b42ba..687d3169bb2d6 100644
--- a/tests/contrib/hooks/test_cassandra_hook.py
+++ b/tests/contrib/hooks/test_cassandra_hook.py
@@ -27,7 +27,7 @@
 from cassandra.policies import (
     TokenAwarePolicy, RoundRobinPolicy, DCAwareRoundRobinPolicy, WhiteListRoundRobinPolicy
 )
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 
@@ -35,12 +35,12 @@ class CassandraHookTest(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='cassandra_test', conn_type='cassandra',
                 host='host-1,host-2', port='9042', schema='test_keyspace',
                 extra='{"load_balancing_policy":"TokenAwarePolicy"}'))
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='cassandra_default_with_schema', conn_type='cassandra',
                 host='cassandra', port='9042', schema='s'))
 
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 597c88192997f..4ebc78c664038 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -31,7 +31,7 @@
     SUBMIT_RUN_ENDPOINT
 )
 from airflow.exceptions import AirflowException
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 try:
diff --git a/tests/contrib/hooks/test_discord_webhook_hook.py b/tests/contrib/hooks/test_discord_webhook_hook.py
index c6b3eac00fd07..e41d88cf45b1f 100644
--- a/tests/contrib/hooks/test_discord_webhook_hook.py
+++ b/tests/contrib/hooks/test_discord_webhook_hook.py
@@ -20,7 +20,8 @@
 import json
 import unittest
 
-from airflow import configuration, models, AirflowException
+from airflow import configuration, AirflowException
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 from airflow.contrib.hooks.discord_webhook_hook import DiscordWebhookHook
@@ -50,7 +51,7 @@ class TestDiscordWebhookHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='default-discord-webhook',
                 host='https://discordapp.com/api/',
                 extra='{"webhook_endpoint": "webhooks/00000/some-discord-token_000"}')
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index 98919b03a81ca..f4e68fec8442f 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -22,8 +22,9 @@
 
 from mock import Mock, patch, mock_open
 
-from airflow import configuration, models, AirflowException
+from airflow import configuration, AirflowException
 from airflow.contrib.hooks.imap_hook import ImapHook
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 imaplib_string = 'airflow.contrib.hooks.imap_hook.imaplib'
@@ -56,7 +57,7 @@ def setUp(self):
         configuration.load_test_config()
 
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='imap_default',
                 host='imap_server_address',
                 login='imap_user',
diff --git a/tests/contrib/hooks/test_jdbc_hook.py b/tests/contrib/hooks/test_jdbc_hook.py
index 3f708997d93e9..1779b781b7e50 100644
--- a/tests/contrib/hooks/test_jdbc_hook.py
+++ b/tests/contrib/hooks/test_jdbc_hook.py
@@ -26,7 +26,7 @@
 
 from airflow import configuration
 from airflow.hooks.jdbc_hook import JdbcHook
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 jdbc_conn_mock = Mock(
@@ -38,7 +38,7 @@ class TestJdbcHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='jdbc_default', conn_type='jdbc',
                 host='jdbc://localhost/', port=443,
                 extra=json.dumps({"extra__jdbc__drv_path": "/path1/test.jar,/path2/t.jar2",
diff --git a/tests/contrib/hooks/test_jira_hook.py b/tests/contrib/hooks/test_jira_hook.py
index 378c379d5551c..26aae945a0789 100644
--- a/tests/contrib/hooks/test_jira_hook.py
+++ b/tests/contrib/hooks/test_jira_hook.py
@@ -25,7 +25,7 @@
 
 from airflow import configuration
 from airflow.contrib.hooks.jira_hook import JiraHook
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 jira_client_mock = Mock(
@@ -37,7 +37,7 @@ class TestJiraHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='jira_default', conn_type='jira',
                 host='https://localhost/jira/', port=443,
                 extra='{"verify": "False", "project": "AIRFLOW"}'))
diff --git a/tests/contrib/hooks/test_openfaas_hook.py b/tests/contrib/hooks/test_openfaas_hook.py
index 28f1158fbf404..7649e6a320e39 100644
--- a/tests/contrib/hooks/test_openfaas_hook.py
+++ b/tests/contrib/hooks/test_openfaas_hook.py
@@ -20,7 +20,7 @@
 
 import unittest
 import requests_mock
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.contrib.hooks.openfaas_hook import OpenFaasHook
 from airflow.hooks.base_hook import BaseHook
 from airflow import configuration, AirflowException
diff --git a/tests/contrib/hooks/test_sftp_hook.py b/tests/contrib/hooks/test_sftp_hook.py
index ac4d78e9b1609..bcdcb80dc3840 100644
--- a/tests/contrib/hooks/test_sftp_hook.py
+++ b/tests/contrib/hooks/test_sftp_hook.py
@@ -25,8 +25,9 @@
 import os
 import pysftp
 
-from airflow import configuration, models
+from airflow import configuration
 from airflow.contrib.hooks.sftp_hook import SFTPHook
+from airflow.models.connection import Connection
 
 TMP_PATH = '/tmp'
 TMP_DIR_FOR_TESTS = 'tests_sftp_hook_dir'
@@ -108,14 +109,14 @@ def test_get_mod_time(self):
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_default(self, get_connection):
-        connection = models.Connection(login='login', host='host')
+        connection = Connection(login='login', host='host')
         get_connection.return_value = connection
         hook = SFTPHook()
         self.assertEqual(hook.no_host_key_check, False)
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_enabled(self, get_connection):
-        connection = models.Connection(
+        connection = Connection(
             login='login', host='host',
             extra='{"no_host_key_check": true}')
 
@@ -125,7 +126,7 @@ def test_no_host_key_check_enabled(self, get_connection):
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_disabled(self, get_connection):
-        connection = models.Connection(
+        connection = Connection(
             login='login', host='host',
             extra='{"no_host_key_check": false}')
 
@@ -135,7 +136,7 @@ def test_no_host_key_check_disabled(self, get_connection):
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_disabled_for_all_but_true(self, get_connection):
-        connection = models.Connection(
+        connection = Connection(
             login='login', host='host',
             extra='{"no_host_key_check": "foo"}')
 
@@ -145,7 +146,7 @@ def test_no_host_key_check_disabled_for_all_but_true(self, get_connection):
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_ignore(self, get_connection):
-        connection = models.Connection(
+        connection = Connection(
             login='login', host='host',
             extra='{"ignore_hostkey_verification": true}')
 
@@ -155,7 +156,7 @@ def test_no_host_key_check_ignore(self, get_connection):
 
     @mock.patch('airflow.contrib.hooks.sftp_hook.SFTPHook.get_connection')
     def test_no_host_key_check_no_ignore(self, get_connection):
-        connection = models.Connection(
+        connection = Connection(
             login='login', host='host',
             extra='{"ignore_hostkey_verification": false}')
 
diff --git a/tests/contrib/hooks/test_slack_webhook_hook.py b/tests/contrib/hooks/test_slack_webhook_hook.py
index 384da6d517b0d..5d92f86e6f5c1 100644
--- a/tests/contrib/hooks/test_slack_webhook_hook.py
+++ b/tests/contrib/hooks/test_slack_webhook_hook.py
@@ -20,7 +20,8 @@
 import json
 import unittest
 
-from airflow import configuration, models
+from airflow import configuration
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 from airflow.contrib.hooks.slack_webhook_hook import SlackWebhookHook
@@ -52,7 +53,7 @@ class TestSlackWebhookHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='slack-webhook-default',
                 extra='{"webhook_token": "your_token_here"}')
         )
diff --git a/tests/contrib/hooks/test_spark_jdbc_hook.py b/tests/contrib/hooks/test_spark_jdbc_hook.py
index a6202dcfb95ca..f7979f25510b1 100644
--- a/tests/contrib/hooks/test_spark_jdbc_hook.py
+++ b/tests/contrib/hooks/test_spark_jdbc_hook.py
@@ -19,7 +19,8 @@
 #
 import unittest
 
-from airflow import configuration, models
+from airflow import configuration
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 from airflow.contrib.hooks.spark_jdbc_hook import SparkJDBCHook
@@ -67,13 +68,13 @@ class TestSparkJDBCHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark-default', conn_type='spark',
                 host='yarn://yarn-master',
                 extra='{"queue": "root.etl", "deploy-mode": "cluster"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='jdbc-default', conn_type='postgres',
                 host='localhost', schema='default', port=5432,
                 login='user', password='supersecret',
diff --git a/tests/contrib/hooks/test_spark_sql_hook.py b/tests/contrib/hooks/test_spark_sql_hook.py
index f76768efcd947..04d5439b9bcc1 100644
--- a/tests/contrib/hooks/test_spark_sql_hook.py
+++ b/tests/contrib/hooks/test_spark_sql_hook.py
@@ -24,7 +24,8 @@
 
 from mock import patch, call
 
-from airflow import configuration, models
+from airflow import configuration
+from airflow.models.connection import Connection
 from airflow.utils import db
 from airflow.contrib.hooks.spark_sql_hook import SparkSqlHook
 
@@ -53,7 +54,7 @@ def setUp(self):
 
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_default', conn_type='spark',
                 host='yarn://yarn-master')
         )
diff --git a/tests/contrib/hooks/test_spark_submit_hook.py b/tests/contrib/hooks/test_spark_submit_hook.py
index beecf6a7241bc..a01379214e9a3 100644
--- a/tests/contrib/hooks/test_spark_submit_hook.py
+++ b/tests/contrib/hooks/test_spark_submit_hook.py
@@ -20,7 +20,8 @@
 import six
 import unittest
 
-from airflow import configuration, models, AirflowException
+from airflow import configuration, AirflowException
+from airflow.models.connection import Connection
 from airflow.utils import db
 from mock import patch, call
 
@@ -73,13 +74,13 @@ def setUp(self):
 
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_yarn_cluster', conn_type='spark',
                 host='yarn://yarn-master',
                 extra='{"queue": "root.etl", "deploy-mode": "cluster"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_k8s_cluster', conn_type='spark',
                 host='k8s://https://k8s-master',
                 extra='{"spark-home": "/opt/spark", ' +
@@ -87,43 +88,43 @@ def setUp(self):
                       '"namespace": "mynamespace"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_default_mesos', conn_type='spark',
                 host='mesos://host', port=5050)
         )
 
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_home_set', conn_type='spark',
                 host='yarn://yarn-master',
                 extra='{"spark-home": "/opt/myspark"}')
         )
 
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_home_not_set', conn_type='spark',
                 host='yarn://yarn-master')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_binary_set', conn_type='spark',
                 host='yarn', extra='{"spark-binary": "custom-spark-submit"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_binary_and_home_set', conn_type='spark',
                 host='yarn',
                 extra='{"spark-home": "/path/to/spark_home", ' +
                       '"spark-binary": "custom-spark-submit"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_standalone_cluster', conn_type='spark',
                 host='spark://spark-standalone-master:6066',
                 extra='{"spark-home": "/path/to/spark_home", "deploy-mode": "cluster"}')
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='spark_standalone_cluster_client_mode', conn_type='spark',
                 host='spark://spark-standalone-master:6066',
                 extra='{"spark-home": "/path/to/spark_home", "deploy-mode": "client"}')
diff --git a/tests/contrib/hooks/test_sqoop_hook.py b/tests/contrib/hooks/test_sqoop_hook.py
index 8bef5a4937b75..64c7e0c8a55a0 100644
--- a/tests/contrib/hooks/test_sqoop_hook.py
+++ b/tests/contrib/hooks/test_sqoop_hook.py
@@ -22,9 +22,10 @@
 import json
 import unittest
 
-from airflow import configuration, models
+from airflow import configuration
 from airflow.contrib.hooks.sqoop_hook import SqoopHook
 from airflow.exceptions import AirflowException
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 from mock import patch, call
@@ -86,7 +87,7 @@ class TestSqoopHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='sqoop_test', conn_type='sqoop', schema='schema',
                 host='rmdbs', port=5050, extra=json.dumps(self._config_json)
             )
diff --git a/tests/contrib/hooks/test_ssh_hook.py b/tests/contrib/hooks/test_ssh_hook.py
index 64b015d09e5d7..80589848929cc 100644
--- a/tests/contrib/hooks/test_ssh_hook.py
+++ b/tests/contrib/hooks/test_ssh_hook.py
@@ -19,8 +19,8 @@
 
 import unittest
 from airflow import configuration
+from airflow.models.connection import Connection
 from airflow.utils import db
-from airflow import models
 
 try:
     from unittest import mock
@@ -132,7 +132,7 @@ def test_tunnel_without_password(self, ssh_mock):
 
     def test_conn_with_extra_parameters(self):
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='ssh_with_extra',
                 host='localhost',
                 conn_type='ssh',
diff --git a/tests/contrib/hooks/test_wasb_hook.py b/tests/contrib/hooks/test_wasb_hook.py
index 88481440e71be..07013528dd066 100644
--- a/tests/contrib/hooks/test_wasb_hook.py
+++ b/tests/contrib/hooks/test_wasb_hook.py
@@ -24,8 +24,8 @@
 from collections import namedtuple
 
 from airflow import configuration, AirflowException
-from airflow import models
 from airflow.contrib.hooks.wasb_hook import WasbHook
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 try:
@@ -42,13 +42,13 @@ class TestWasbHook(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='wasb_test_key', conn_type='wasb',
                 login='login', password='key'
             )
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='wasb_test_sas_token', conn_type='wasb',
                 login='login', extra=json.dumps({'sas_token': 'token'})
             )
diff --git a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
index e6e1abe374f82..14439514f889a 100644
--- a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
+++ b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
@@ -26,7 +26,7 @@
 from airflow.contrib.operators.azure_cosmos_operator import AzureCosmosInsertDocumentOperator
 
 from airflow import configuration
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 try:
@@ -50,7 +50,7 @@ def setUp(self):
         self.test_collection_name = 'test_collection_name'
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='azure_cosmos_test_key_id',
                 conn_type='azure_cosmos',
                 login=self.test_end_point,
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 447b2348eff92..1ae01453e7ab0 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -28,7 +28,7 @@
     CloudSqlInstanceDatabaseCreateOperator, CloudSqlInstanceDatabasePatchOperator, \
     CloudSqlInstanceExportOperator, CloudSqlInstanceImportOperator, \
     CloudSqlInstanceDatabaseDeleteOperator, CloudSqlQueryOperator
-from airflow.models import Connection
+from airflow.models.connection import Connection
 
 try:
     # noinspection PyProtectedMember
diff --git a/tests/contrib/operators/test_jira_operator_test.py b/tests/contrib/operators/test_jira_operator_test.py
index 2509038a36c53..5d15832525c77 100644
--- a/tests/contrib/operators/test_jira_operator_test.py
+++ b/tests/contrib/operators/test_jira_operator_test.py
@@ -25,7 +25,7 @@
 
 from airflow import DAG, configuration
 from airflow.contrib.operators.jira_operator import JiraOperator
-from airflow import models
+from airflow.models.connection import Connection
 from airflow.utils import db
 from airflow.utils import timezone
 
@@ -58,7 +58,7 @@ def setUp(self):
         dag = DAG('test_dag_id', default_args=args)
         self.dag = dag
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='jira_default', conn_type='jira',
                 host='https://localhost/jira/', port=443,
                 extra='{"verify": "False", "project": "AIRFLOW"}'))
diff --git a/tests/contrib/operators/test_qubole_operator.py b/tests/contrib/operators/test_qubole_operator.py
index c0894c0ba76ae..43d20d2750278 100644
--- a/tests/contrib/operators/test_qubole_operator.py
+++ b/tests/contrib/operators/test_qubole_operator.py
@@ -21,7 +21,8 @@
 import unittest
 from datetime import datetime
 
-from airflow.models import DAG, Connection, TaskInstance
+from airflow.models import DAG, TaskInstance
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 from airflow.contrib.hooks.qubole_hook import QuboleHook
diff --git a/tests/contrib/sensors/test_datadog_sensor.py b/tests/contrib/sensors/test_datadog_sensor.py
index 75fca65033766..d5d9309666093 100644
--- a/tests/contrib/sensors/test_datadog_sensor.py
+++ b/tests/contrib/sensors/test_datadog_sensor.py
@@ -23,8 +23,8 @@
 from mock import patch
 
 from airflow import configuration
-from airflow import models
 from airflow.contrib.sensors.datadog_sensor import DatadogSensor
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 at_least_one_event = [{'alert_type': 'info',
@@ -64,7 +64,7 @@ class TestDatadogSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='datadog_default', conn_type='datadog',
                 login='login', password='password',
                 extra=json.dumps({'api_key': 'api_key', 'app_key': 'app_key'})
diff --git a/tests/contrib/sensors/test_imap_attachment_sensor.py b/tests/contrib/sensors/test_imap_attachment_sensor.py
index 297de02a99b49..66e3cfc7883b9 100644
--- a/tests/contrib/sensors/test_imap_attachment_sensor.py
+++ b/tests/contrib/sensors/test_imap_attachment_sensor.py
@@ -21,8 +21,9 @@
 
 from mock import patch, Mock
 
-from airflow import configuration, models
+from airflow import configuration
 from airflow.contrib.sensors.imap_attachment_sensor import ImapAttachmentSensor
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 imap_hook_string = 'airflow.contrib.sensors.imap_attachment_sensor.ImapHook'
@@ -33,7 +34,7 @@ class TestImapAttachmentSensor(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='imap_test',
                 host='base_url',
                 login='user',
diff --git a/tests/contrib/sensors/test_jira_sensor_test.py b/tests/contrib/sensors/test_jira_sensor_test.py
index 32aa235851a6d..edbcb4b57b2dc 100644
--- a/tests/contrib/sensors/test_jira_sensor_test.py
+++ b/tests/contrib/sensors/test_jira_sensor_test.py
@@ -24,8 +24,8 @@
 from mock import patch
 
 from airflow import DAG, configuration
-from airflow import models
 from airflow.contrib.sensors.jira_sensor import JiraTicketSensor
+from airflow.models.connection import Connection
 from airflow.utils import db, timezone
 
 DEFAULT_DATE = timezone.datetime(2017, 1, 1)
@@ -57,7 +57,7 @@ def setUp(self):
         dag = DAG('test_dag_id', default_args=args)
         self.dag = dag
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='jira_default', conn_type='jira',
                 host='https://localhost/jira/', port=443,
                 extra='{"verify": "False", "project": "AIRFLOW"}'))
diff --git a/tests/contrib/sensors/test_mongo_sensor.py b/tests/contrib/sensors/test_mongo_sensor.py
index 6a78b7d146498..e2110002ba456 100644
--- a/tests/contrib/sensors/test_mongo_sensor.py
+++ b/tests/contrib/sensors/test_mongo_sensor.py
@@ -24,7 +24,7 @@
 from airflow import configuration
 from airflow.contrib.hooks.mongo_hook import MongoHook
 from airflow.contrib.sensors.mongo_sensor import MongoSensor
-from airflow.models import Connection
+from airflow.models.connection import Connection
 from airflow.utils import db, timezone
 
 
diff --git a/tests/contrib/sensors/test_qubole_sensor.py b/tests/contrib/sensors/test_qubole_sensor.py
index 9a0365d021570..bc9ad8f742f5e 100644
--- a/tests/contrib/sensors/test_qubole_sensor.py
+++ b/tests/contrib/sensors/test_qubole_sensor.py
@@ -25,7 +25,8 @@
 
 from airflow.contrib.sensors.qubole_sensor import QuboleFileSensor, QubolePartitionSensor
 from airflow.exceptions import AirflowException
-from airflow.models import DAG, Connection
+from airflow.models import DAG
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 DAG_ID = "qubole_test_dag"
diff --git a/tests/core.py b/tests/core.py
index 625eca9adea0a..fc96fbf4f6d84 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -50,6 +50,7 @@
 
 from airflow import jobs, models, DAG, utils, macros, settings, exceptions
 from airflow.models import BaseOperator
+from airflow.models.connection import Connection
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.check_operator import CheckOperator, ValueCheckOperator
 from airflow.operators.dagrun_operator import TriggerDagRunOperator
@@ -1390,8 +1391,8 @@ def test_cli_connections_add_delete(self):
         for index in range(1, 6):
             conn_id = 'new%s' % index
             result = (session
-                      .query(models.Connection)
-                      .filter(models.Connection.conn_id == conn_id)
+                      .query(Connection)
+                      .filter(Connection.conn_id == conn_id)
                       .first())
             result = (result.conn_id, result.conn_type, result.host,
                       result.port, result.get_extra())
@@ -1436,8 +1437,8 @@ def test_cli_connections_add_delete(self):
         # Check deletions
         for index in range(1, 7):
             conn_id = 'new%s' % index
-            result = (session.query(models.Connection)
-                      .filter(models.Connection.conn_id == conn_id)
+            result = (session.query(Connection)
+                      .filter(Connection.conn_id == conn_id)
                       .first())
 
             self.assertTrue(result is None)
@@ -2643,9 +2644,9 @@ def test_using_unix_socket_env_var(self):
         self.assertIsNone(c.port)
 
     def test_param_setup(self):
-        c = models.Connection(conn_id='local_mysql', conn_type='mysql',
-                              host='localhost', login='airflow',
-                              password='airflow', schema='airflow')
+        c = Connection(conn_id='local_mysql', conn_type='mysql',
+                       host='localhost', login='airflow',
+                       password='airflow', schema='airflow')
         self.assertEqual('localhost', c.host)
         self.assertEqual('airflow', c.schema)
         self.assertEqual('airflow', c.login)
@@ -2737,9 +2738,9 @@ def test_get_client(self):
     @mock.patch('airflow.hooks.hdfs_hook.HDFSHook.get_connections')
     def test_get_autoconfig_client(self, mock_get_connections,
                                    MockAutoConfigClient):
-        c = models.Connection(conn_id='hdfs', conn_type='hdfs',
-                              host='localhost', port=8020, login='foo',
-                              extra=json.dumps({'autoconfig': True}))
+        c = Connection(conn_id='hdfs', conn_type='hdfs',
+                       host='localhost', port=8020, login='foo',
+                       extra=json.dumps({'autoconfig': True}))
         mock_get_connections.return_value = [c]
         HDFSHook(hdfs_conn_id='hdfs').get_conn()
         MockAutoConfigClient.assert_called_once_with(effective_user='foo',
@@ -2753,10 +2754,10 @@ def test_get_autoconfig_client_no_conn(self, MockAutoConfigClient):
 
     @mock.patch('airflow.hooks.hdfs_hook.HDFSHook.get_connections')
     def test_get_ha_client(self, mock_get_connections):
-        c1 = models.Connection(conn_id='hdfs_default', conn_type='hdfs',
-                               host='localhost', port=8020)
-        c2 = models.Connection(conn_id='hdfs_default', conn_type='hdfs',
-                               host='localhost2', port=8020)
+        c1 = Connection(conn_id='hdfs_default', conn_type='hdfs',
+                        host='localhost', port=8020)
+        c2 = Connection(conn_id='hdfs_default', conn_type='hdfs',
+                        host='localhost2', port=8020)
         mock_get_connections.return_value = [c1, c2]
         client = HDFSHook().get_conn()
         self.assertIsInstance(client, snakebite.client.HAClient)
diff --git a/tests/hooks/test_docker_hook.py b/tests/hooks/test_docker_hook.py
index dd7ed4d44d388..f4bc6b4f4673c 100644
--- a/tests/hooks/test_docker_hook.py
+++ b/tests/hooks/test_docker_hook.py
@@ -20,8 +20,8 @@
 import unittest
 
 from airflow import configuration
-from airflow import models
 from airflow.exceptions import AirflowException
+from airflow.models.connection import Connection
 from airflow.utils import db
 
 try:
@@ -43,7 +43,7 @@ class DockerHookTest(unittest.TestCase):
     def setUp(self):
         configuration.load_test_config()
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='docker_default',
                 conn_type='docker',
                 host='some.docker.registry.com',
@@ -52,7 +52,7 @@ def setUp(self):
             )
         )
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='docker_with_extras',
                 conn_type='docker',
                 host='some.docker.registry.com',
@@ -148,7 +148,7 @@ def test_conn_with_extra_config_passes_parameters(self, _):
 
     def test_conn_with_broken_config_missing_username_fails(self, _):
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='docker_without_username',
                 conn_type='docker',
                 host='some.docker.registry.com',
@@ -165,7 +165,7 @@ def test_conn_with_broken_config_missing_username_fails(self, _):
 
     def test_conn_with_broken_config_missing_host_fails(self, _):
         db.merge_conn(
-            models.Connection(
+            Connection(
                 conn_id='docker_without_host',
                 conn_type='docker',
                 login='some_user',
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index 4e9226035bd15..dc34ea21f3bb1 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -25,9 +25,10 @@
 
 import tenacity
 
-from airflow import configuration, models
+from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.hooks.http_hook import HttpHook
+from airflow.models.connection import Connection
 
 try:
     from unittest import mock
@@ -39,7 +40,7 @@
 
 
 def get_airflow_connection(conn_id=None):
-    return models.Connection(
+    return Connection(
         conn_id='http_default',
         conn_type='http',
         host='test:8080/',
@@ -48,7 +49,7 @@ def get_airflow_connection(conn_id=None):
 
 
 def get_airflow_connection_with_port(conn_id=None):
-    return models.Connection(
+    return Connection(
         conn_id='http_default',
         conn_type='http',
         host='test.com',
@@ -252,8 +253,8 @@ def run_and_return(session, prepped_request, extra_options, **kwargs):
 
     @mock.patch('airflow.hooks.http_hook.HttpHook.get_connection')
     def test_http_connection(self, mock_get_connection):
-        c = models.Connection(conn_id='http_default', conn_type='http',
-                              host='localhost', schema='http')
+        c = Connection(conn_id='http_default', conn_type='http',
+                       host='localhost', schema='http')
         mock_get_connection.return_value = c
         hook = HttpHook()
         hook.get_conn({})
@@ -261,8 +262,8 @@ def test_http_connection(self, mock_get_connection):
 
     @mock.patch('airflow.hooks.http_hook.HttpHook.get_connection')
     def test_https_connection(self, mock_get_connection):
-        c = models.Connection(conn_id='http_default', conn_type='http',
-                              host='localhost', schema='https')
+        c = Connection(conn_id='http_default', conn_type='http',
+                       host='localhost', schema='https')
         mock_get_connection.return_value = c
         hook = HttpHook()
         hook.get_conn({})
@@ -270,8 +271,8 @@ def test_https_connection(self, mock_get_connection):
 
     @mock.patch('airflow.hooks.http_hook.HttpHook.get_connection')
     def test_host_encoded_http_connection(self, mock_get_connection):
-        c = models.Connection(conn_id='http_default', conn_type='http',
-                              host='http://localhost')
+        c = Connection(conn_id='http_default', conn_type='http',
+                       host='http://localhost')
         mock_get_connection.return_value = c
         hook = HttpHook()
         hook.get_conn({})
@@ -279,8 +280,8 @@ def test_host_encoded_http_connection(self, mock_get_connection):
 
     @mock.patch('airflow.hooks.http_hook.HttpHook.get_connection')
     def test_host_encoded_https_connection(self, mock_get_connection):
-        c = models.Connection(conn_id='http_default', conn_type='http',
-                              host='https://localhost')
+        c = Connection(conn_id='http_default', conn_type='http',
+                       host='https://localhost')
         mock_get_connection.return_value = c
         hook = HttpHook()
         hook.get_conn({})
diff --git a/tests/hooks/test_mysql_hook.py b/tests/hooks/test_mysql_hook.py
index 22e1874ed2f36..ed7855959fd88 100644
--- a/tests/hooks/test_mysql_hook.py
+++ b/tests/hooks/test_mysql_hook.py
@@ -24,8 +24,8 @@
 
 import MySQLdb.cursors
 
-from airflow import models
 from airflow.hooks.mysql_hook import MySqlHook
+from airflow.models.connection import Connection
 
 SSL_DICT = {
     'cert': '/tmp/client-cert.pem',
@@ -39,7 +39,7 @@ class TestMySqlHookConn(unittest.TestCase):
     def setUp(self):
         super(TestMySqlHookConn, self).setUp()
 
-        self.connection = models.Connection(
+        self.connection = Connection(
             login='login',
             password='password',
             host='host',
diff --git a/tests/models.py b/tests/models.py
index 076bde436558c..7baa798fe6ce2 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -45,7 +45,6 @@
 from airflow.contrib.sensors.python_sensor import PythonSensor
 from airflow.exceptions import AirflowDagCycleException, AirflowSkipException
 from airflow.jobs import BackfillJob
-from airflow.models import Connection
 from airflow.models import DAG, TaskInstance as TI
 from airflow.models import DagModel, DagRun, DagStat
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
@@ -54,6 +53,7 @@
 from airflow.models import TaskReschedule as TR
 from airflow.models import XCom
 from airflow.models import clear_task_instances
+from airflow.models.connection import Connection
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import PythonOperator
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 3c47acfd4fd06..9fbbb2a73344c 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -42,6 +42,7 @@
 from airflow.config_templates.airflow_local_settings import DEFAULT_LOGGING_CONFIG
 from airflow.jobs import BaseJob
 from airflow.models import DAG, DagRun, TaskInstance
+from airflow.models.connection import Connection
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.settings import Session
 from airflow.utils import dates, timezone
@@ -126,7 +127,7 @@ def setUp(self):
         }
 
     def tearDown(self):
-        self.clear_table(models.Connection)
+        self.clear_table(Connection)
         super(TestConnectionModelView, self).tearDown()
 
     def test_create_connection(self):

From 3899027251532beecbfd8d4afe8886ae43fd9d1a Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 20 Mar 2019 14:51:46 +0000
Subject: [PATCH 632/808] [AIRFLOW-3458] Deprecation path for moving
 models.Connection

---
 airflow/models/__init__.py   | 4 ++++
 airflow/models/connection.py | 3 ++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 1be3e899e101f..ab78fb3785a74 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -5339,3 +5339,7 @@ def checkpoint_kube_worker_uuid(worker_uuid, session=None):
                 KubeWorkerIdentifier.worker_uuid: worker_uuid
             })
             session.commit()
+
+
+# To avoid circular import on Python2.7 we need to define this at the _bottom_
+from airflow.models.connection import Connection  # noqa: E402,F401
diff --git a/airflow/models/connection.py b/airflow/models/connection.py
index aeed9b68bdcab..75384dc34c47b 100644
--- a/airflow/models/connection.py
+++ b/airflow/models/connection.py
@@ -25,7 +25,8 @@
 from sqlalchemy.ext.declarative import declared_attr
 from sqlalchemy.orm import synonym
 
-from airflow import LoggingMixin, AirflowException
+from airflow.exceptions import AirflowException
+from airflow import LoggingMixin
 from airflow.models import Base, ID_LEN, get_fernet
 
 

From ad80e69535b1e1c96416cd2f376fb36de1915d46 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Thu, 17 Jan 2019 18:37:07 +0100
Subject: [PATCH 633/808] [AIRFLOW-3713] Updated documentation for GCP optional
 project_id (#4541)

---
 UPDATING.md                                | 41 ++++++++++++++++++++++
 airflow/contrib/hooks/gcp_api_base_hook.py |  4 +--
 airflow/contrib/hooks/gcp_bigtable_hook.py |  5 +--
 airflow/contrib/hooks/gcp_function_hook.py |  3 ++
 airflow/contrib/hooks/gcp_spanner_hook.py  |  3 ++
 airflow/contrib/hooks/gcp_sql_hook.py      |  3 ++
 docs/howto/manage-connections.rst          | 29 +++++++++------
 7 files changed, 73 insertions(+), 15 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 45b10fa0ef987..3556ce5dc9f76 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -63,6 +63,47 @@ If `dag_discovery_safe_mode` is enabled, only check files for DAGs if
 they contain the strings "airflow" and "DAG". For backwards
 compatibility, this option is enabled by default.
 
+### Changes in Google Cloud Platform related operators
+
+Most GCP-related operators have now optional `PROJECT_ID` parameter. In case you do not specify it,
+the project id configured in
+[GCP Connection](https://airflow.apache.org/howto/manage-connections.html#connection-type-gcp) is used.
+There will be an `AirflowException` thrown in case `PROJECT_ID` parameter is not specified and the
+connection used has no project id defined. This change should be  backwards compatible as earlier version
+of the operators had `PROJECT_ID` mandatory.
+
+Operators involved:
+
+  * GCP Compute Operators
+    * GceInstanceStartOperator
+    * GceInstanceStopOperator
+    * GceSetMachineTypeOperator
+  * GCP Function Operators
+    * GcfFunctionDeployOperator
+  * GCP Cloud SQL Operators
+    * CloudSqlInstanceCreateOperator
+    * CloudSqlInstancePatchOperator
+    * CloudSqlInstanceDeleteOperator
+    * CloudSqlInstanceDatabaseCreateOperator
+    * CloudSqlInstanceDatabasePatchOperator
+    * CloudSqlInstanceDatabaseDeleteOperator
+
+Other GCP operators are unaffected.
+
+### Changes in Google Cloud Platform related hooks
+
+The change in GCP operators implies that GCP Hooks for those operators require now keyword parameters rather
+than positional ones in all methods where `project_id` is used. The methods throw an explanatory exception
+in case they are called using positional parameters.
+
+Hooks involved:
+
+  * GceHook
+  * GcfHook
+  * CloudSqlHook
+
+Other GCP hooks are unaffected.
+
 ## Airflow 1.10.2
 
 ### Modification to `ts_nodash` macro
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 58e79c87db3f7..596209fb542ef 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -174,8 +174,8 @@ def fallback_to_default_project_id(func):
         def inner_wrapper(self, *args, **kwargs):
             if len(args) > 0:
                 raise AirflowException(
-                    "Use keyword arguments when initializing method with the "
-                    "'fallback_to_default_project_id' decorator")
+                    "You must use keyword arguments in this methods rather than"
+                    " positional")
             if 'project_id' in kwargs:
                 kwargs['project_id'] = self._get_project_id(kwargs['project_id'])
             else:
diff --git a/airflow/contrib/hooks/gcp_bigtable_hook.py b/airflow/contrib/hooks/gcp_bigtable_hook.py
index 900cf1966dc07..aeca2b475f566 100644
--- a/airflow/contrib/hooks/gcp_bigtable_hook.py
+++ b/airflow/contrib/hooks/gcp_bigtable_hook.py
@@ -28,6 +28,9 @@
 class BigtableHook(GoogleCloudBaseHook):
     """
     Hook for Google Cloud Bigtable APIs.
+
+    All the methods in the hook where project_id is used must be called with
+    keyword arguments rather than positional.
     """
 
     _client = None
@@ -48,7 +51,6 @@ def get_instance(self, instance_id, project_id=None):
         """
         Retrieves and returns the specified Cloud Bigtable instance if it exists.
         Otherwise, returns None.
-        Must be called with keyword arguments rather than positional.
 
         :param instance_id: The ID of the Cloud Bigtable instance.
         :type instance_id: str
@@ -67,7 +69,6 @@ def get_instance(self, instance_id, project_id=None):
     def delete_instance(self, instance_id, project_id=None):
         """
         Deletes the specified Cloud Bigtable instance.
-        Must be called with keyword arguments rather than positional.
         Raises google.api_core.exceptions.NotFound if the Cloud Bigtable instance does
         not exist.
 
diff --git a/airflow/contrib/hooks/gcp_function_hook.py b/airflow/contrib/hooks/gcp_function_hook.py
index 13e6dc63966a5..86a82dd7607c7 100644
--- a/airflow/contrib/hooks/gcp_function_hook.py
+++ b/airflow/contrib/hooks/gcp_function_hook.py
@@ -36,6 +36,9 @@
 class GcfHook(GoogleCloudBaseHook):
     """
     Hook for the Google Cloud Functions APIs.
+
+    All the methods in the hook where project_id is used must be called with
+    keyword arguments rather than positional.
     """
     _conn = None
 
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index 8b7b9aa413c92..66e9fc52dbad0 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -27,6 +27,9 @@
 class CloudSpannerHook(GoogleCloudBaseHook):
     """
     Hook for Google Cloud Spanner APIs.
+
+    All the methods in the hook where project_id is used must be called with
+    keyword arguments rather than positional.
     """
     _client = None
 
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 57b48616be942..d1792397adb1c 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -68,6 +68,9 @@ class CloudSqlOperationStatus:
 class CloudSqlHook(GoogleCloudBaseHook):
     """
     Hook for Google Cloud SQL APIs.
+
+    All the methods in the hook where project_id is used must be called with
+    keyword arguments rather than positional.
     """
     _conn = None
 
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index 5f5be3489578c..c99d28b58e9ca 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -119,18 +119,25 @@ The following connection IDs are used by default.
     hook.
 
 ``google_cloud_default``
-    Used by the
-    :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`,
-    :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`,
-    :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`,
-    :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`, and
-    :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook` hooks.
+    Used by those hooks:
+* :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`
+* :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`
+* :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`
+* :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`
+* :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook`
+* :class:`~airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook`
+* :class:`~airflow.contrib.hooks.gcp_compute_hook.GceHook`
+* :class:`~airflow.contrib.hooks.gcp_function_hook.GcfHook`
+* :class:`~airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook`
+* :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook`
+
 
 Configuring the Connection
 ''''''''''''''''''''''''''
 
-Project Id (required)
-    The Google Cloud project ID to connect to.
+Project Id (optional)
+    The Google Cloud project ID to connect to. It is used as default project id by operators using it and
+    can usually be overridden at the operator level.
 
 Keyfile Path
     Path to a `service account
@@ -239,10 +246,10 @@ Schema (optional)
 
 Login (required)
     Specify the user name to connect.
-    
+
 Password (required)
-    Specify the password to connect.    
-    
+    Specify the password to connect.
+
 Extra (optional)
     Specify the extra parameters (as json dictionary) that can be used in MySQL
     connection. The following parameters are supported:

From 8271250a7e2cde3c1d7f193ca41bd2595c717b4e Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Mon, 31 Dec 2018 12:46:06 +0100
Subject: [PATCH 634/808] [AIRFLOW-3600] Remove dagbag from trigger (#4407)

* Remove dagbag from trigger call

* Adding fix to rbac

* empty commit

* Added create_dagrun to DagModel

* Adding testing to /trigger calls

* Make session a class var
---
 airflow/models/__init__.py   | 44 ++++++++++++++++++++++++++++++++++++
 airflow/www/views.py         |  6 ++---
 airflow/www_rbac/views.py    |  6 ++---
 tests/www/test_views.py      | 30 ++++++++++++++++++++++++
 tests/www_rbac/test_views.py | 40 ++++++++++++++++++++++++++++++++
 5 files changed, 120 insertions(+), 6 deletions(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index ab78fb3785a74..b972e6a7d3f5c 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -3029,6 +3029,50 @@ def __repr__(self):
     def get_current(cls, dag_id, session=None):
         return session.query(cls).filter(cls.dag_id == dag_id).first()
 
+    def get_default_view(self):
+        if self.default_view is None:
+            return configuration.conf.get('webserver', 'dag_default_view').lower()
+        else:
+            return self.default_view
+
+    def get_dag(self):
+        return DagBag(dag_folder=self.fileloc).get_dag(self.dag_id)
+
+    @provide_session
+    def create_dagrun(self,
+                      run_id,
+                      state,
+                      execution_date,
+                      start_date=None,
+                      external_trigger=False,
+                      conf=None,
+                      session=None):
+        """
+        Creates a dag run from this dag including the tasks associated with this dag.
+        Returns the dag run.
+
+        :param run_id: defines the the run id for this dag run
+        :type run_id: str
+        :param execution_date: the execution date of this dag run
+        :type execution_date: datetime
+        :param state: the state of the dag run
+        :type state: State
+        :param start_date: the date this dag run should be evaluated
+        :type start_date: datetime
+        :param external_trigger: whether this dag run is externally triggered
+        :type external_trigger: bool
+        :param session: database session
+        :type session: Session
+        """
+
+        return self.get_dag().create_dagrun(run_id=run_id,
+                                            state=state,
+                                            execution_date=execution_date,
+                                            start_date=start_date,
+                                            external_trigger=external_trigger,
+                                            conf=conf,
+                                            session=session)
+
 
 @functools.total_ordering
 class DAG(BaseDag, LoggingMixin):
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 947c0ed3b08f9..21782ac150514 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1089,11 +1089,11 @@ def delete(self):
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
-    def trigger(self):
+    @provide_session
+    def trigger(self, session=None):
         dag_id = request.args.get('dag_id')
         origin = request.args.get('origin') or "/admin/"
-        dag = dagbag.get_dag(dag_id)
-
+        dag = session.query(models.DagModel).filter(models.DagModel.dag_id == dag_id).first()
         if not dag:
             flash("Cannot find dag {}".format(dag_id))
             return redirect(origin)
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index b36061b914644..f0589b8a7ebf7 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -849,11 +849,11 @@ def delete(self):
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
-    def trigger(self):
+    @provide_session
+    def trigger(self, session=None):
         dag_id = request.args.get('dag_id')
         origin = request.args.get('origin') or "/"
-        dag = dagbag.get_dag(dag_id)
-
+        dag = session.query(models.DagModel).filter(models.DagModel.dag_id == dag_id).first()
         if not dag:
             flash("Cannot find dag {}".format(dag_id))
             return redirect(origin)
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 9c7cac16c7231..9c08864e9ccca 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -850,6 +850,36 @@ def test_delete_dag_button_for_dag_on_scheduler_only(self):
         session.commit()
 
 
+class TestTriggerDag(unittest.TestCase):
+
+    def setUp(self):
+        conf.load_test_config()
+        app = application.create_app(testing=True)
+        app.config['WTF_CSRF_METHODS'] = []
+        self.app = app.test_client()
+        self.session = Session()
+        models.DagBag().get_dag("example_bash_operator").sync_to_db()
+
+    def test_trigger_dag_button_normal_exist(self):
+        resp = self.app.get('/', follow_redirects=True)
+        self.assertIn('/trigger?dag_id=example_bash_operator', resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+
+    def test_trigger_dag_button(self):
+
+        test_dag_id = "example_bash_operator"
+
+        DR = models.DagRun
+        self.session.query(DR).delete()
+        self.session.commit()
+
+        self.app.get('/admin/airflow/trigger?dag_id={}'.format(test_dag_id))
+
+        run = self.session.query(DR).filter(DR.dag_id == test_dag_id).first()
+        self.assertIsNotNone(run)
+        self.assertIn("manual__", run.run_id)
+
+
 class HelpersTest(unittest.TestCase):
     @classmethod
     def setUpClass(cls):
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 9fbbb2a73344c..7598fa29d48ba 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -1546,5 +1546,45 @@ def test_log_success_for_user(self):
         self.check_content_in_response('"metadata":', resp)
 
 
+class TestTaskInstanceView(TestBase):
+    TI_ENDPOINT = '/taskinstance/list/?_flt_0_execution_date={}'
+
+    def test_start_date_filter(self):
+        resp = self.client.get(self.TI_ENDPOINT.format(
+            self.percent_encode('2018-10-09 22:44:31')))
+        # We aren't checking the logic of the date filter itself (that is built
+        # in to FAB) but simply that our UTC conversion was run - i.e. it
+        # doesn't blow up!
+        self.check_content_in_response('List Task Instance', resp)
+        pass
+
+
+class TestTriggerDag(TestBase):
+
+    def setUp(self):
+        super(TestTriggerDag, self).setUp()
+        self.session = Session()
+        models.DagBag().get_dag("example_bash_operator").sync_to_db(session=self.session)
+
+    def test_trigger_dag_button_normal_exist(self):
+        resp = self.client.get('/', follow_redirects=True)
+        self.assertIn('/trigger?dag_id=example_bash_operator', resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+
+    def test_trigger_dag_button(self):
+
+        test_dag_id = "example_bash_operator"
+
+        DR = models.DagRun
+        self.session.query(DR).delete()
+        self.session.commit()
+
+        resp = self.client.get('trigger?dag_id={}'.format(test_dag_id))
+
+        run = self.session.query(DR).filter(DR.dag_id == test_dag_id).first()
+        self.assertIsNotNone(run)
+        self.assertIn("manual__", run.run_id)
+
+
 if __name__ == '__main__':
     unittest.main()

From ad7a70297b639142e0a89cfb89a116371d90e605 Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Thu, 27 Dec 2018 08:32:00 +0100
Subject: [PATCH 635/808] [AIRFLOW-3561] Improve queries (#4368)

* improve queries

* Adding field to the database

* Set length of field

* remove dagbag use in xcom call

* Fixing typo

* Adding test

* Remove default_view

* fixing test

* rename var

* Fixing rbac dag_stats

* Fixing rbac task_stats

* Fixing rbac code

* Fixing rbac xcom

* Fixing template

* Fixing default view call

* Added timezone to DagModel

* Fixing timezone
---
 .../c8ffec048a3b_add_fields_to_dag.py         | 44 ++++++++++++++
 airflow/models/__init__.py                    | 21 ++++++-
 airflow/www/templates/airflow/dag.html        |  4 +-
 airflow/www/templates/airflow/dags.html       |  2 +-
 airflow/www/views.py                          | 54 +++++++++--------
 airflow/www_rbac/templates/airflow/dag.html   |  4 +-
 airflow/www_rbac/templates/airflow/dags.html  |  2 +-
 airflow/www_rbac/views.py                     | 60 ++++++++++---------
 tests/models.py                               | 28 +++++++++
 9 files changed, 159 insertions(+), 60 deletions(-)
 create mode 100644 airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py

diff --git a/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py b/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py
new file mode 100644
index 0000000000000..a74e0b50a49b2
--- /dev/null
+++ b/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py
@@ -0,0 +1,44 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+# 
+#   http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""add fields to dag
+
+Revision ID: c8ffec048a3b
+Revises: 41f5f12752f8
+Create Date: 2018-12-23 21:55:46.463634
+
+"""
+
+# revision identifiers, used by Alembic.
+revision = 'c8ffec048a3b'
+down_revision = '41f5f12752f8'
+branch_labels = None
+depends_on = None
+
+from alembic import op
+import sqlalchemy as sa
+
+
+def upgrade():
+    op.add_column('dag', sa.Column('description', sa.Text(), nullable=True))
+    op.add_column('dag', sa.Column('default_view', sa.String(25), nullable=True))
+
+
+def downgrade():
+    op.drop_column('dag', 'description')
+    op.drop_column('dag', 'default_view')
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index b972e6a7d3f5c..b9d7620c14436 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -3020,10 +3020,18 @@ class DagModel(Base):
     fileloc = Column(String(2000))
     # String representing the owners
     owners = Column(String(2000))
+    # Description of the dag
+    description = Column(Text)
+    # Default view of the inside the webserver
+    default_view = Column(String(25))
 
     def __repr__(self):
         return "<DAG: {self.dag_id}>".format(self=self)
 
+    @property
+    def timezone(self):
+        return settings.TIMEZONE
+
     @classmethod
     @provide_session
     def get_current(cls, dag_id, session=None):
@@ -3174,7 +3182,7 @@ def __init__(
                 'core', 'max_active_runs_per_dag'),
             dagrun_timeout=None,
             sla_miss_callback=None,
-            default_view=configuration.conf.get('webserver', 'dag_default_view').lower(),
+            default_view=None,
             orientation=configuration.conf.get('webserver', 'dag_orientation'),
             catchup=configuration.conf.getboolean('scheduler', 'catchup_by_default'),
             on_success_callback=None, on_failure_callback=None,
@@ -3245,7 +3253,7 @@ def __init__(
         self.max_active_runs = max_active_runs
         self.dagrun_timeout = dagrun_timeout
         self.sla_miss_callback = sla_miss_callback
-        self.default_view = default_view
+        self._default_view = default_view
         self.orientation = orientation
         self.catchup = catchup
         self.is_subdag = False  # DagBag.bag_dag() will set this to True if appropriate
@@ -3314,6 +3322,13 @@ def __exit__(self, _type, _value, _tb):
 
     # /Context Manager ----------------------------------------------
 
+    def get_default_view(self):
+        """This is only there for backward compatible jinja2 templates"""
+        if self._default_view is None:
+            return configuration.conf.get('webserver', 'dag_default_view').lower()
+        else:
+            return self._default_view
+
     def date_range(self, start_date, num=None, end_date=timezone.utcnow()):
         if num:
             end_date = None
@@ -4268,6 +4283,8 @@ def sync_to_db(self, owner=None, sync_time=None, session=None):
         orm_dag.owners = owner
         orm_dag.is_active = True
         orm_dag.last_scheduler_run = sync_time
+        orm_dag.default_view = self._default_view
+        orm_dag.description = self.description
         session.merge(orm_dag)
         session.commit()
 
diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 05762b41f673f..c041616736980 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -49,7 +49,7 @@ <h4 class="pull-right">
   <div>
     <ul class="nav nav-pills">
       {% if dag.parent_dag %}
-          <li class="never_active"><a href="{{ url_for('airflow.' + dag.default_view, dag_id=dag.parent_dag.dag_id) }}">
+          <li class="never_active"><a href="{{ url_for('airflow.' + dag.get_default_view(), dag_id=dag.parent_dag.dag_id) }}">
               <span class="glyphicon glyphicon-arrow-left" aria-hidden="true"></span>
               Back to {{ dag.parent_dag.dag_id }}</a>
           </li>
@@ -386,7 +386,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $("#btn_subdag").click(function(){
-      url = "{{ url_for( 'airflow.' + dag.default_view ) }}" +
+      url = "{{ url_for( 'airflow.' + dag.get_default_view() ) }}" +
         "?dag_id=" + encodeURIComponent(subdag_id) +
         "&execution_date=" + encodeURIComponent(execution_date);
       window.location = url;
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 57e949e8ad8ca..fb9e53105a8ec 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -85,7 +85,7 @@ <h2>DAGs</h2>
                 <!-- Column 3: Name -->
                 <td>
                     {% if dag_id in webserver_dags %}
-                    <a href="{{ url_for('airflow.'+dag.default_view, dag_id=dag.dag_id) }}" title="{{ dag.description }}">
+                    <a href="{{ url_for('airflow.'+ dag.get_default_view(), dag_id=dag.dag_id) }}" title="{{ dag.description }}">
                         {{ dag_id }}
                     </a>
                     {% else %}
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 21782ac150514..3a137f1036c3f 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -555,31 +555,29 @@ def chart(self):
     @login_required
     @provide_session
     def dag_stats(self, session=None):
-        ds = models.DagStat
+        dr = models.DagRun
+        dm = models.DagModel
+        dag_ids = session.query(dm.dag_id)
 
-        ds.update(
-            dag_ids=[dag.dag_id for dag in dagbag.dags.values() if not dag.is_subdag]
-        )
-
-        qry = (
-            session.query(ds.dag_id, ds.state, ds.count)
-        )
+        dag_state_stats = session.query(dr.dag_id, dr.state, sqla.func.count(dr.state)).group_by(dr.dag_id, dr.state)
 
         data = {}
-        for dag_id, state, count in qry:
+        for (dag_id, ) in dag_ids:
+            data[dag_id] = {}
+        for dag_id, state, count in dag_state_stats:
             if dag_id not in data:
                 data[dag_id] = {}
             data[dag_id][state] = count
 
         payload = {}
-        for dag in dagbag.dags.values():
-            payload[dag.safe_dag_id] = []
+        for dag_id, d in data.items():
+            payload[dag_id] = []
             for state in State.dag_states:
-                count = data.get(dag.dag_id, {}).get(state, 0)
-                payload[dag.safe_dag_id].append({
+                count = d.get(state, 0)
+                payload[dag_id].append({
                     'state': state,
                     'count': count,
-                    'dag_id': dag.dag_id,
+                    'dag_id': dag_id,
                     'color': State.color(state)
                 })
         return wwwutils.json_response(payload)
@@ -592,6 +590,8 @@ def task_stats(self, session=None):
         DagRun = models.DagRun
         Dag = models.DagModel
 
+        dag_ids = session.query(Dag.dag_id)
+
         LastDagRun = (
             session.query(DagRun.dag_id, sqla.func.max(DagRun.execution_date).label('execution_date'))
                 .join(Dag, Dag.dag_id == DagRun.dag_id)
@@ -639,24 +639,25 @@ def task_stats(self, session=None):
         session.commit()
 
         payload = {}
-        for dag in dagbag.dags.values():
-            payload[dag.safe_dag_id] = []
+        for (dag_id, ) in dag_ids:
+            payload[dag_id] = []
             for state in State.task_states:
-                count = data.get(dag.dag_id, {}).get(state, 0)
-                payload[dag.safe_dag_id].append({
+                count = data.get(dag_id, {}).get(state, 0)
+                payload[dag_id].append({
                     'state': state,
                     'count': count,
-                    'dag_id': dag.dag_id,
+                    'dag_id': dag_id,
                     'color': State.color(state)
                 })
         return wwwutils.json_response(payload)
 
     @expose('/code')
     @login_required
-    def code(self):
+    @provide_session
+    def code(self, session=None):
         dag_id = request.args.get('dag_id')
-        dag = dagbag.get_dag(dag_id)
-        title = dag_id
+        dm = models.DagModel
+        dag = session.query(dm).filter(dm.dag_id == dag_id).first()
         try:
             with wwwutils.open_maybe_zipped(dag.fileloc, 'r') as f:
                 code = f.read()
@@ -666,7 +667,7 @@ def code(self):
             html_code = str(e)
 
         return self.render(
-            'airflow/dag_code.html', html_code=html_code, dag=dag, title=title,
+            'airflow/dag_code.html', html_code=html_code, dag=dag, title=dag_id,
             root=request.args.get('root'),
             demo_mode=conf.getboolean('webserver', 'demo_mode'))
 
@@ -965,8 +966,11 @@ def xcom(self, session=None):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
-        dag = dagbag.get_dag(dag_id)
-        if not dag or task_id not in dag.task_ids:
+        dm_db = models.DagModel
+        ti_db = models.TaskInstance
+        dag = session.query(dm_db).filter(dm_db.dag_id == dag_id).first()
+        ti = session.query(ti_db).filter(ti_db.dag_id == dag_id and ti_db.task_id == task_id).first()
+        if not ti:
             flash(
                 "Task [{}.{}] doesn't seem to exist"
                 " at the moment".format(dag_id, task_id),
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 58d35ed55e5ba..03b79b298e045 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -49,7 +49,7 @@ <h4 class="pull-right">
     {% set num_runs_arg = request.args.get('num_runs') %}
     <ul class="nav nav-pills">
       {% if dag.parent_dag %}
-          <li class="never_active"><a href="{{ url_for('Airflow.' + dag.default_view, dag_id=dag.parent_dag.dag_id) }}">
+          <li class="never_active"><a href="{{ url_for('Airflow.' + dag.get_default_view(), dag_id=dag.parent_dag.dag_id) }}">
               <span class="glyphicon glyphicon-arrow-left" aria-hidden="true"></span>
               Back to {{ dag.parent_dag.dag_id }}</a>
           </li>
@@ -386,7 +386,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $("#btn_subdag").click(function(){
-      url = "{{ url_for( 'Airflow.' + dag.default_view ) }}" +
+      url = "{{ url_for( 'Airflow.' + dag.get_default_view() ) }}" +
         "?dag_id=" + encodeURIComponent(subdag_id) +
         "&execution_date=" + encodeURIComponent(execution_date);
       window.location = url;
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index 527643e87242a..24ecc57fcfd5b 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -86,7 +86,7 @@ <h2>DAGs</h2>
                 <!-- Column 3: Name -->
                 <td>
                     {% if dag_id in webserver_dags %}
-                    <a href="{{ url_for('Airflow.'+dag.default_view, dag_id=dag.dag_id) }}" title="{{ dag.description }}">
+                    <a href="{{ url_for('Airflow.'+ dag.get_default_view(), dag_id=dag.dag_id) }}" title="{{ dag.description }}">
                         {{ dag_id }}
                     </a>
                     {% else %}
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index f0589b8a7ebf7..5199911f48978 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -316,35 +316,34 @@ def get_int_arg(value, default=0):
     @has_access
     @provide_session
     def dag_stats(self, session=None):
-        ds = models.DagStat
-
-        ds.update()
-
-        qry = (
-            session.query(ds.dag_id, ds.state, ds.count)
-        )
+        dr = models.DagRun
 
         filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
 
+        dag_state_stats = session.query(dr.dag_id, dr.state, sqla.func.count(dr.state)).group_by(dr.dag_id, dr.state)
+
         payload = {}
         if filter_dag_ids:
             if 'all_dags' not in filter_dag_ids:
-                qry = qry.filter(ds.dag_id.in_(filter_dag_ids))
+                dag_state_stats = dag_state_stats.filter(dr.dag_id.in_(filter_dag_ids))
             data = {}
-            for dag_id, state, count in qry:
+            for dag_id, state, count in dag_state_stats:
                 if dag_id not in data:
                     data[dag_id] = {}
                 data[dag_id][state] = count
 
-            for dag in dagbag.dags.values():
-                if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
-                    payload[dag.safe_dag_id] = []
+            if 'all_dags' in filter_dag_ids:
+                filter_dag_ids = [dag_id for dag_id, in session.query(models.DagModel.dag_id)]
+
+            for dag_id in filter_dag_ids:
+                if 'all_dags' in filter_dag_ids or dag_id in filter_dag_ids:
+                    payload[dag_id] = []
                     for state in State.dag_states:
-                        count = data.get(dag.dag_id, {}).get(state, 0)
-                        payload[dag.safe_dag_id].append({
+                        count = data.get(dag_id, {}).get(state, 0)
+                        payload[dag_id].append({
                             'state': state,
                             'count': count,
-                            'dag_id': dag.dag_id,
+                            'dag_id': dag_id,
                             'color': State.color(state)
                         })
         return wwwutils.json_response(payload)
@@ -410,15 +409,17 @@ def task_stats(self, session=None):
                 data[dag_id][state] = count
         session.commit()
 
-        for dag in dagbag.dags.values():
-            if 'all_dags' in filter_dag_ids or dag.dag_id in filter_dag_ids:
-                payload[dag.safe_dag_id] = []
+        if 'all_dags' in filter_dag_ids:
+            filter_dag_ids = [dag_id for dag_id, in session.query(models.DagModel.dag_id)]
+        for dag_id in filter_dag_ids:
+            if 'all_dags' in filter_dag_ids or dag_id in filter_dag_ids:
+                payload[dag_id] = []
                 for state in State.task_states:
-                    count = data.get(dag.dag_id, {}).get(state, 0)
-                    payload[dag.safe_dag_id].append({
+                    count = data.get(dag_id, {}).get(state, 0)
+                    payload[dag_id].append({
                         'state': state,
                         'count': count,
-                        'dag_id': dag.dag_id,
+                        'dag_id': dag_id,
                         'color': State.color(state)
                     })
         return wwwutils.json_response(payload)
@@ -426,10 +427,11 @@ def task_stats(self, session=None):
     @expose('/code')
     @has_dag_access(can_dag_read=True)
     @has_access
-    def code(self):
+    @provide_session
+    def code(self, session=None):
+        dm = models.DagModel
         dag_id = request.args.get('dag_id')
-        dag = dagbag.get_dag(dag_id)
-        title = dag_id
+        dag = session.query(dm).filter(dm.dag_id == dag_id).first()
         try:
             with wwwutils.open_maybe_zipped(dag.fileloc, 'r') as f:
                 code = f.read()
@@ -439,7 +441,7 @@ def code(self):
             html_code = str(e)
 
         return self.render(
-            'airflow/dag_code.html', html_code=html_code, dag=dag, title=title,
+            'airflow/dag_code.html', html_code=html_code, dag=dag, title=dag_id,
             root=request.args.get('root'),
             demo_mode=conf.getboolean('webserver', 'demo_mode'))
 
@@ -723,8 +725,12 @@ def xcom(self, session=None):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
-        dag = dagbag.get_dag(dag_id)
-        if not dag or task_id not in dag.task_ids:
+        dm_db = models.DagModel
+        ti_db = models.TaskInstance
+        dag = session.query(dm_db).filter(dm_db.dag_id == dag_id).first()
+        ti = session.query(ti_db).filter(ti_db.dag_id == dag_id and ti_db.task_id == task_id).first()
+
+        if not ti:
             flash(
                 "Task [{}.{}] doesn't seem to exist"
                 " at the moment".format(dag_id, task_id),
diff --git a/tests/models.py b/tests/models.py
index 7baa798fe6ce2..e2b9f9055b7c9 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -867,6 +867,8 @@ def test_sync_to_db(self, mock_now):
         self.assertEqual(set(orm_dag.owners.split(', ')), {'owner1', 'owner2'})
         self.assertEqual(orm_dag.last_scheduler_run, now)
         self.assertTrue(orm_dag.is_active)
+        self.assertIsNone(orm_dag.default_view)
+        self.assertEqual(orm_dag.get_default_view(), configuration.conf.get('webserver', 'dag_default_view').lower())
 
         orm_subdag = session.query(DagModel).filter(
             DagModel.dag_id == 'dag.subtask').one()
@@ -874,6 +876,32 @@ def test_sync_to_db(self, mock_now):
         self.assertEqual(orm_subdag.last_scheduler_run, now)
         self.assertTrue(orm_subdag.is_active)
 
+    @patch('airflow.models.timezone.utcnow')
+    def test_sync_to_db_default_view(self, mock_now):
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+            default_view="graph",
+        )
+        with dag:
+            DummyOperator(task_id='task', owner='owner1')
+            SubDagOperator(
+                task_id='subtask',
+                owner='owner2',
+                subdag=DAG(
+                    'dag.subtask',
+                    start_date=DEFAULT_DATE,
+                )
+            )
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        session = settings.Session()
+        dag.sync_to_db(session=session)
+
+        orm_dag = session.query(DagModel).filter(DagModel.dag_id == 'dag').one()
+        self.assertIsNotNone(orm_dag.default_view)
+        self.assertEqual(orm_dag.get_default_view(), "graph")
+
 
 class DagStatTest(unittest.TestCase):
     def test_dagstats_crud(self):

From 628548bd8a6433d1b33d621574ce9f36bab94b85 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Mon, 6 Aug 2018 02:24:20 +0800
Subject: [PATCH 636/808] [AIRFLOW-2821] Refine Doc "Plugins" (#3664)

---
 docs/plugins.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/plugins.rst b/docs/plugins.rst
index 0c51003c5c068..a2c02b3f406ed 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -100,6 +100,26 @@ looks like:
 
 
 
+You can derive it by inheritance (please refer to the example below).
+Please note ``name`` inside this class must be specified.
+
+After the plugin is imported into Airflow,
+you can invoke it using statement like
+
+
+.. code:: python
+
+    from airflow.{type, like "operators", "sensors"}.{name specificed inside the plugin class} import *
+
+
+When you write your own plugins, make sure you understand them well.
+There are some essential properties for each type of plugin.
+For example,
+
+* For ``Operator`` plugin, an ``execute`` method is compulsory.
+* For ``Sensor`` plugin, a ``poke`` method returning a Boolean value is compulsory.
+
+
 Example
 -------
 

From 95cfffdaef33b85531f7b856fe5c8da643138846 Mon Sep 17 00:00:00 2001
From: Jimmy Cao <jcao2462@gmail.com>
Date: Wed, 2 Jan 2019 07:11:15 -0600
Subject: [PATCH 637/808] [AIRFLOW-2548] Output plugin import errors to web UI
 (#3930)

---
 airflow/plugins_manager.py |  3 +++
 airflow/www/views.py       |  8 ++++++++
 airflow/www_rbac/views.py  | 14 +++++++++++---
 docs/plugins.rst           |  2 ++
 4 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index 5345637a8121e..811e1b4c58122 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -35,6 +35,8 @@
 
 log = LoggingMixin().log
 
+import_errors = {}
+
 
 class AirflowPluginException(Exception):
     pass
@@ -148,6 +150,7 @@ def is_valid_plugin(plugin_obj, existing_plugins):
         except Exception as e:
             log.exception(e)
             log.error('Failed to import plugin %s', filepath)
+            import_errors[filepath] = str(e)
 
 plugins = load_entrypoint_plugins(
     pkg_resources.iter_entry_points('airflow.plugins'),
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 3a137f1036c3f..96d39668e1ff1 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2136,6 +2136,14 @@ def get_int_arg(value, default=0):
                 "Broken DAG: [{ie.filename}] {ie.stacktrace}".format(ie=ie),
                 "error")
 
+        from airflow.plugins_manager import import_errors as plugin_import_errors
+        for filename, stacktrace in plugin_import_errors.items():
+            flash(
+                "Broken plugin: [{filename}] {stacktrace}".format(
+                    stacktrace=stacktrace,
+                    filename=filename),
+                "error")
+
         # get a list of all non-subdag dags visible to everyone
         # optionally filter out "paused" dags
         if hide_paused:
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 5199911f48978..2d75a37ec3646 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -224,15 +224,20 @@ def get_int_arg(value, default=0):
         if hide_paused:
             sql_query = sql_query.filter(~DM.is_paused)
 
-        # Get all the dag id the user could access
-        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
-
         import_errors = session.query(models.ImportError).all()
         for ie in import_errors:
             flash(
                 "Broken DAG: [{ie.filename}] {ie.stacktrace}".format(ie=ie),
                 "error")
 
+        from airflow.plugins_manager import import_errors as plugin_import_errors
+        for filename, stacktrace in plugin_import_errors.items():
+            flash(
+                "Broken plugin: [{filename}] {stacktrace}".format(
+                    stacktrace=stacktrace,
+                    filename=filename),
+                "error")
+
         # get a list of all non-subdag dags visible to everyone
         # optionally filter out "paused" dags
         if hide_paused:
@@ -243,6 +248,9 @@ def get_int_arg(value, default=0):
             unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
                                          not dag.parent_dag]
 
+        # Get all the dag id the user could access
+        filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
+
         if 'all_dags' in filter_dag_ids:
             orm_dags = {dag.dag_id: dag for dag
                         in sql_query
diff --git a/docs/plugins.rst b/docs/plugins.rst
index a2c02b3f406ed..a11f5c3dad5d8 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -119,6 +119,8 @@ For example,
 * For ``Operator`` plugin, an ``execute`` method is compulsory.
 * For ``Sensor`` plugin, a ``poke`` method returning a Boolean value is compulsory.
 
+Make sure you restart the webserver and scheduler after making changes to plugins so that they take effect.
+
 
 Example
 -------

From a62bc75fce1bb9a1700c55e8cbd24c7c9400fa80 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 11 Jan 2019 05:18:00 -0500
Subject: [PATCH 638/808] [AIRFLOW-3584] Use ORM DAGs for index view. (#4390)

* [AIRFLOW-3584] Use ORM DAGs for index view.

* Serialize schedule interval to json rather than pickle.
---
 ...4ecb8fbee3_add_schedule_interval_to_dag.py | 42 +++++++++
 airflow/models/__init__.py                    | 47 ++++++----
 airflow/utils/sqlalchemy.py                   | 35 ++++++-
 airflow/www/templates/airflow/dags.html       | 51 ++++------
 airflow/www/views.py                          | 92 ++++---------------
 airflow/www_rbac/package-lock.json            | 48 ++++------
 airflow/www_rbac/package.json                 |  2 +-
 airflow/www_rbac/templates/airflow/dags.html  | 45 +++------
 airflow/www_rbac/views.py                     | 72 +++------------
 tests/models.py                               |  5 +-
 10 files changed, 192 insertions(+), 247 deletions(-)
 create mode 100644 airflow/migrations/versions/dd4ecb8fbee3_add_schedule_interval_to_dag.py

diff --git a/airflow/migrations/versions/dd4ecb8fbee3_add_schedule_interval_to_dag.py b/airflow/migrations/versions/dd4ecb8fbee3_add_schedule_interval_to_dag.py
new file mode 100644
index 0000000000000..3b2e6d577ac9d
--- /dev/null
+++ b/airflow/migrations/versions/dd4ecb8fbee3_add_schedule_interval_to_dag.py
@@ -0,0 +1,42 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""Add schedule interval to dag
+
+Revision ID: dd4ecb8fbee3
+Revises: c8ffec048a3b
+Create Date: 2018-12-27 18:39:25.748032
+
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision = 'dd4ecb8fbee3'
+down_revision = 'c8ffec048a3b'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.add_column('dag', sa.Column('schedule_interval', sa.Text(), nullable=True))
+
+
+def downgrade():
+    op.drop_column('dag', sa.Column('schedule_interval', sa.Text(), nullable=True))
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index b9d7620c14436..d5c9bad46e275 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -98,7 +98,7 @@
     as_tuple, is_container, validate_key, pprinttable)
 from airflow.utils.operator_resources import Resources
 from airflow.utils.state import State
-from airflow.utils.sqlalchemy import UtcDateTime
+from airflow.utils.sqlalchemy import UtcDateTime, Interval
 from airflow.utils.timeout import timeout
 from airflow.utils.trigger_rule import TriggerRule
 from airflow.utils.weight_rule import WeightRule
@@ -239,6 +239,20 @@ def clear_task_instances(tis,
             dr.start_date = timezone.utcnow()
 
 
+def get_last_dagrun(dag_id, session, include_externally_triggered=False):
+    """
+    Returns the last dag run for a dag, None if there was none.
+    Last dag run can be any type of run eg. scheduled or backfilled.
+    Overridden DagRuns are ignored.
+    """
+    DR = DagRun
+    query = session.query(DR).filter(DR.dag_id == dag_id)
+    if not include_externally_triggered:
+        query = query.filter(DR.external_trigger == False)  # noqa
+    query = query.order_by(DR.execution_date.desc())
+    return query.first()
+
+
 class DagBag(BaseDagBag, LoggingMixin):
     """
     A dagbag is a collection of dags, parsed out of a folder tree and has high
@@ -3024,6 +3038,8 @@ class DagModel(Base):
     description = Column(Text)
     # Default view of the inside the webserver
     default_view = Column(String(25))
+    # Schedule interval
+    schedule_interval = Column(Interval)
 
     def __repr__(self):
         return "<DAG: {self.dag_id}>".format(self=self)
@@ -3043,6 +3059,15 @@ def get_default_view(self):
         else:
             return self.default_view
 
+    @provide_session
+    def get_last_dagrun(self, session=None, include_externally_triggered=False):
+        return get_last_dagrun(self.dag_id, session=session,
+                               include_externally_triggered=include_externally_triggered)
+
+    @property
+    def safe_dag_id(self):
+        return self.dag_id.replace('.', '__dot__')
+
     def get_dag(self):
         return DagBag(dag_folder=self.fileloc).get_dag(self.dag_id)
 
@@ -3457,23 +3482,8 @@ def normalize_schedule(self, dttm):
 
     @provide_session
     def get_last_dagrun(self, session=None, include_externally_triggered=False):
-        """
-        Returns the last dag run for this dag, None if there was none.
-        Last dag run can be any type of run eg. scheduled or backfilled.
-        Overridden DagRuns are ignored
-        """
-        DR = DagRun
-        qry = session.query(DR).filter(
-            DR.dag_id == self.dag_id,
-        )
-        if not include_externally_triggered:
-            qry = qry.filter(DR.external_trigger.__eq__(False))
-
-        qry = qry.order_by(DR.execution_date.desc())
-
-        last = qry.first()
-
-        return last
+        return get_last_dagrun(self.dag_id, session=session,
+                               include_externally_triggered=include_externally_triggered)
 
     @property
     def dag_id(self):
@@ -4285,6 +4295,7 @@ def sync_to_db(self, owner=None, sync_time=None, session=None):
         orm_dag.last_scheduler_run = sync_time
         orm_dag.default_view = self._default_view
         orm_dag.description = self.description
+        orm_dag.schedule_interval = self.schedule_interval
         session.merge(orm_dag)
         session.commit()
 
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index fe29b76e60d8b..e5dea174020a0 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -24,12 +24,14 @@
 
 import datetime
 import os
+import json
 import pendulum
 import time
 import random
 
+from dateutil import relativedelta
 from sqlalchemy import event, exc, select
-from sqlalchemy.types import DateTime, TypeDecorator
+from sqlalchemy.types import Text, DateTime, TypeDecorator
 
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -169,3 +171,34 @@ def process_result_value(self, value, dialect):
                 value = value.astimezone(utc)
 
         return value
+
+
+class Interval(TypeDecorator):
+
+    impl = Text
+
+    attr_keys = {
+        datetime.timedelta: ('days', 'seconds', 'microseconds'),
+        relativedelta.relativedelta: (
+            'years', 'months', 'days', 'leapdays', 'hours', 'minutes', 'seconds', 'microseconds',
+            'year', 'month', 'day', 'hour', 'minute', 'second', 'microsecond',
+        ),
+    }
+
+    def process_bind_param(self, value, dialect):
+        if type(value) in self.attr_keys:
+            attrs = {
+                key: getattr(value, key)
+                for key in self.attr_keys[type(value)]
+            }
+            return json.dumps({'type': type(value).__name__, 'attrs': attrs})
+        return json.dumps(value)
+
+    def process_result_value(self, value, dialect):
+        if not value:
+            return value
+        data = json.loads(value)
+        if isinstance(data, dict):
+            type_map = {key.__name__: key for key in self.attr_keys}
+            return type_map[data['type']](**data['attrs'])
+        return data
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index fb9e53105a8ec..81d60f31d2803 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -63,52 +63,37 @@ <h2>DAGs</h2>
             </tr>
         </thead>
         <tbody>
-        {% for dag_id in dag_ids_in_page %}
-            {% set dag = webserver_dags[dag_id] if dag_id in webserver_dags else None %}
+        {% for dag in dags %}
             <tr>
                 <!-- Column 1: Edit dag -->
                 <td class="text-center" style="width:10px;">
-                    {% if dag_id in orm_dags %}
-                  <a href="{{ url_for('dagmodel.edit_view') }}?id={{ dag_id }}" title="Info">
+                  <a href="{{ url_for('dagmodel.edit_view') }}?id={{ dag.dag_id }}" title="Info">
                         <span class="glyphicon glyphicon-edit" aria-hidden="true"></span>
                     </a>
-                    {% endif %}
                 </td>
 
                 <!-- Column 2: Turn dag on/off -->
                 <td>
-                  {% if dag_id in orm_dags %}
-                    <input id="toggle-{{ dag_id }}" dag_id="{{ dag_id }}" type="checkbox" {{ "checked" if not orm_dags[dag_id].is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
-                  {% endif %}
+                  <input id="toggle-{{ dag.dag_id }}" dag_id="{{ dag.dag_id }}" type="checkbox" {{ "checked" if not dag.is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
                 </td>
 
                 <!-- Column 3: Name -->
                 <td>
-                    {% if dag_id in webserver_dags %}
-                    <a href="{{ url_for('airflow.'+ dag.get_default_view(), dag_id=dag.dag_id) }}" title="{{ dag.description }}">
-                        {{ dag_id }}
-                    </a>
-                    {% else %}
-                        {{ dag_id }}
-                        <span class="glyphicon glyphicon-info-sign" class="info" aria-hidden="true" title="This DAG isn't available in the web server's DagBag object. It shows up in this list because the scheduler marked it as active in the metadata database."></span>
-                    {% endif %}
-                    {% if dag_id not in orm_dags %}
-                        <span class="glyphicon glyphicon-info-sign" class="info" aria-hidden="true" title="This DAG seems to be existing only locally. The master scheduler doesn't seem to be aware of its existence."></span>
-                    {% endif %}
+                  <a href="{{ url_for('airflow.'+ dag.get_default_view(), dag_id=dag.dag_id) }}" title="{{ dag.description }}">
+                      {{ dag.dag_id }}
+                  </a>
                 </td>
 
                 <!-- Column 4: Dag Schedule -->
                 <td>
-                    {% if dag_id in webserver_dags %}
                   <a class="label label-default schedule {{ dag.dag_id }}" href="{{ url_for('dagrun.index_view') }}?flt2_dag_id_equals={{ dag.dag_id }}">
-                        {{ dag.schedule_interval }}
+                        {{ dag.schedule_interval | string }}
                     </a>
-                    {% endif %}
                 </td>
 
                 <!-- Column 5: Dag Owners -->
                 <td>
-                  {{ dag.owner if dag else orm_dags[dag_id].owners }}
+                  {{ dag.owners }}
                 </td>
 
                 <!-- Column 6: Recent Tasks -->
@@ -118,14 +103,12 @@ <h2>DAGs</h2>
 
                 <!-- Column 7: Last Run -->
                 <td class="text-nowrap latest_dag_run {{ dag.dag_id }}">
-                  {% if dag %}
-                    {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
-                    {% if last_run and last_run.execution_date %}
-                      <a href="{{ url_for('airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
-                        {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}
-                      </a>
-                      <span aria-hidden="true" id="statuses_info" title="Start Date: {{ last_run.start_date.strftime("%Y-%m-%d %H:%M") }}" class="glyphicon glyphicon-info-sign"></span>
-                    {% endif %}
+                  {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
+                  {% if last_run and last_run.execution_date %}
+                    <a href="{{ url_for('airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
+                      {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}
+                    </a>
+                    <span aria-hidden="true" id="statuses_info" title="Start Date: {{ last_run.start_date.strftime("%Y-%m-%d %H:%M") }}" class="glyphicon glyphicon-info-sign"></span>
                   {% endif %}
                 </td>
 
@@ -186,14 +169,14 @@ <h2>DAGs</h2>
                 {% endif %}
 
                 <!-- Refresh -->
-                <a href="{{ url_for("airflow.refresh", dag_id=dag_id) }}">
+                <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}">
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
                 <!-- Delete -->
                 <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
-                <a href="{{ url_for('airflow.delete', dag_id=dag_id) }}"
-                  onclick="return confirmDeleteDag('{{ dag_id }}')">
+                <a href="{{ url_for('airflow.delete', dag_id=dag.dag_id) }}"
+                  onclick="return confirmDeleteDag('{{ dag.dag_id }}')">
                    <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
                 </td>
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 96d39668e1ff1..731e4715006ed 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2104,31 +2104,37 @@ def get_int_arg(value, default=0):
             hide_paused = hide_paused_dags_by_default
 
         # read orm_dags from the db
-        sql_query = session.query(DM)
+        query = session.query(DM)
 
         if do_filter and owner_mode == 'ldapgroup':
-            sql_query = sql_query.filter(
+            query = query.filter(
                 ~DM.is_subdag,
                 DM.is_active,
                 DM.owners.in_(current_user.ldap_groups)
             )
         elif do_filter and owner_mode == 'user':
-            sql_query = sql_query.filter(
+            query = query.filter(
                 ~DM.is_subdag, DM.is_active,
                 DM.owners == current_user.user.username
             )
         else:
-            sql_query = sql_query.filter(
+            query = query.filter(
                 ~DM.is_subdag, DM.is_active
             )
 
         # optionally filter out "paused" dags
         if hide_paused:
-            sql_query = sql_query.filter(~DM.is_paused)
+            query = query.filter(~DM.is_paused)
 
-        orm_dags = {dag.dag_id: dag for dag
-                    in sql_query
-                    .all()}
+        if arg_search_query:
+            query = query.filter(sqla.func.lower(DM.dag_id) == arg_search_query.lower())
+
+        query = query.order_by(DM.dag_id)
+
+        start = current_page * dags_per_page
+        end = start + dags_per_page
+
+        dags = query.offset(start).limit(dags_per_page).all()
 
         import_errors = session.query(models.ImportError).all()
         for ie in import_errors:
@@ -2144,76 +2150,17 @@ def get_int_arg(value, default=0):
                     filename=filename),
                 "error")
 
-        # get a list of all non-subdag dags visible to everyone
-        # optionally filter out "paused" dags
-        if hide_paused:
-            unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
-                                         not dag.parent_dag and not dag.is_paused]
-
-        else:
-            unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
-                                         not dag.parent_dag]
-
-        # optionally filter to get only dags that the user should see
-        if do_filter and owner_mode == 'ldapgroup':
-            # only show dags owned by someone in @current_user.ldap_groups
-            webserver_dags = {
-                dag.dag_id: dag
-                for dag in unfiltered_webserver_dags
-                if dag.owner in current_user.ldap_groups
-            }
-        elif do_filter and owner_mode == 'user':
-            # only show dags owned by @current_user.user.username
-            webserver_dags = {
-                dag.dag_id: dag
-                for dag in unfiltered_webserver_dags
-                if dag.owner == current_user.user.username
-            }
-        else:
-            webserver_dags = {
-                dag.dag_id: dag
-                for dag in unfiltered_webserver_dags
-            }
-
-        if arg_search_query:
-            lower_search_query = arg_search_query.lower()
-            # filter by dag_id
-            webserver_dags_filtered = {
-                dag_id: dag
-                for dag_id, dag in webserver_dags.items()
-                if (lower_search_query in dag_id.lower() or
-                    lower_search_query in dag.owner.lower())
-            }
-
-            all_dag_ids = (set([dag.dag_id for dag in orm_dags.values()
-                                if lower_search_query in dag.dag_id.lower() or
-                                lower_search_query in dag.owners.lower()]) |
-                           set(webserver_dags_filtered.keys()))
-
-            sorted_dag_ids = sorted(all_dag_ids)
-        else:
-            webserver_dags_filtered = webserver_dags
-            sorted_dag_ids = sorted(set(orm_dags.keys()) | set(webserver_dags.keys()))
-
-        start = current_page * dags_per_page
-        end = start + dags_per_page
-
-        num_of_all_dags = len(sorted_dag_ids)
-        page_dag_ids = sorted_dag_ids[start:end]
+        num_of_all_dags = query.count()
         num_of_pages = int(math.ceil(num_of_all_dags / float(dags_per_page)))
 
         auto_complete_data = set()
-        for dag in webserver_dags_filtered.values():
-            auto_complete_data.add(dag.dag_id)
-            auto_complete_data.add(dag.owner)
-        for dag in orm_dags.values():
-            auto_complete_data.add(dag.dag_id)
-            auto_complete_data.add(dag.owners)
+        for row in query.with_entities(DM.dag_id, DM.owners):
+            auto_complete_data.add(row.dag_id)
+            auto_complete_data.add(row.owners)
 
         return self.render(
             'airflow/dags.html',
-            webserver_dags=webserver_dags_filtered,
-            orm_dags=orm_dags,
+            dags=dags,
             hide_paused=hide_paused,
             current_page=current_page,
             search_query=arg_search_query if arg_search_query else '',
@@ -2225,7 +2172,6 @@ def get_int_arg(value, default=0):
             paging=wwwutils.generate_pages(current_page, num_of_pages,
                                            search=arg_search_query,
                                            showPaused=not hide_paused),
-            dag_ids_in_page=page_dag_ids,
             auto_complete_data=auto_complete_data)
 
 
diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index 6a760de11a673..a26d0b8894e39 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -2154,30 +2154,23 @@
       }
     },
     "dagre": {
-      "version": "0.7.4",
-      "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.7.4.tgz",
-      "integrity": "sha1-3nLw50pVDOEc5jjwoTb+1xI5gCI=",
+      "version": "0.8.4",
+      "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.8.4.tgz",
+      "integrity": "sha512-Dj0csFDrWYKdavwROb9FccHfTC4fJbyF/oJdL9LNZJ8WUvl968P6PAKEriGqfbdArVJEmmfA+UyumgWEwcHU6A==",
       "requires": {
-        "graphlib": "^1.0.5",
-        "lodash": "^3.10.0"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "3.10.1",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
-          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
-        }
+        "graphlib": "^2.1.7",
+        "lodash": "^4.17.4"
       }
     },
     "dagre-d3": {
-      "version": "0.4.18",
-      "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.4.18.tgz",
-      "integrity": "sha512-7tRltaOfNTIkNEZYMCL8N3Q8bCre99x/mAJL2RbuUfPu5d+4f0KOHglZm+AzOG2Z/+S2HBDYciE6iDcDtki6Tg==",
-      "requires": {
-        "d3": "^3.3.8",
-        "dagre": "^0.7.3",
-        "graphlib": "^1.0.5",
-        "lodash": "^3.10.0"
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.6.3.tgz",
+      "integrity": "sha512-1vAzNp7OR1370JtjNaVFiW04DBjPDq513cJnqNVWxIkZqB0HfIArsc5eriTY9RM9cVMUjxdCJ3z4of5f8HqbdA==",
+      "requires": {
+        "d3": "^4.12.2",
+        "dagre": "^0.8.4",
+        "graphlib": "^2.1.7",
+        "lodash": "^4.17.10"
       },
       "dependencies": {
         "lodash": {
@@ -4109,18 +4102,11 @@
       "dev": true
     },
     "graphlib": {
-      "version": "1.0.7",
-      "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-1.0.7.tgz",
-      "integrity": "sha1-DKst8P/mq+BwsmJb+h7bbslnuLE=",
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-2.1.7.tgz",
+      "integrity": "sha512-TyI9jIy2J4j0qgPmOOrHTCtpPqJGN/aurBwc6ZT+bRii+di1I+Wv3obRhVrmBEXet+qkMaEX67dXrwsd3QQM6w==",
       "requires": {
-        "lodash": "^3.10.0"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "3.10.1",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
-          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
-        }
+        "lodash": "^4.17.5"
       }
     },
     "handlebars": {
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index 5c431895a7666..f9a99fdc171d9 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -58,7 +58,7 @@
     "bootstrap-toggle": "^2.2.2",
     "d3": "^3.4.4",
     "d3-tip": "^0.9.1",
-    "dagre-d3": "^0.4.18",
+    "dagre-d3": "^0.6.3",
     "datatables.net": "^1.10.19",
     "datatables.net-bs": "^1.10.19",
     "lodash": "^4.17.11",
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index 24ecc57fcfd5b..dae0816507a4d 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -63,53 +63,38 @@ <h2>DAGs</h2>
             </tr>
         </thead>
         <tbody>
-        {% for dag_id in dag_ids_in_page %}
-            {% set dag = webserver_dags[dag_id] if dag_id in webserver_dags else None %}
+        {% for dag in dags %}
             <tr>
                 <!-- Column 1: Edit dag -->
                 <td class="text-center" style="width:10px;">
-                    {% if dag_id in orm_dags %}
-                    <a href="{{ url_for('DagModelView.show', pk=dag_id) }}" title="Info">
+                    <a href="{{ url_for('DagModelView.show', pk=dag.dag_id) }}" title="Info">
                         <span class="glyphicon glyphicon-edit" aria-hidden="true"></span>
                     </a>
-                    {% endif %}
                 </td>
 
                 <!-- Column 2: Turn dag on/off -->
                 <td>
-                  {% if dag_id in orm_dags %}
                     {% set disabled = 'disabled' if view_only else None %}
-                    <input id="toggle-{{ dag_id }}" {{ disabled }} dag_id="{{ dag_id }}" type="checkbox" {{ "checked" if not orm_dags[dag_id].is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
-                  {% endif %}
+                    <input id="toggle-{{ dag.dag_id }}" {{ disabled }} dag_id="{{ dag.dag_id }}" type="checkbox" {{ "checked" if not dag.is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
                 </td>
 
                 <!-- Column 3: Name -->
                 <td>
-                    {% if dag_id in webserver_dags %}
                     <a href="{{ url_for('Airflow.'+ dag.get_default_view(), dag_id=dag.dag_id) }}" title="{{ dag.description }}">
-                        {{ dag_id }}
+                        {{ dag.dag_id }}
                     </a>
-                    {% else %}
-                        {{ dag_id }}
-                        <span class="glyphicon glyphicon-info-sign" class="info" aria-hidden="true" title="This DAG isn't available in the web server's DagBag object. It shows up in this list because the scheduler marked it as active in the metadata database."></span>
-                    {% endif %}
-                    {% if dag_id not in orm_dags %}
-                        <span class="glyphicon glyphicon-info-sign" class="info" aria-hidden="true" title="This DAG seems to be existing only locally. The master scheduler doesn't seem to be aware of its existence."></span>
-                    {% endif %}
                 </td>
 
                 <!-- Column 4: Dag Schedule -->
                 <td>
-                    {% if dag_id in webserver_dags %}
                     <a class="label label-default schedule {{ dag.dag_id }}" href="{{ url_for('DagRunModelView.list') }}?_flt_3_dag_id={{ dag.dag_id }}">
                         {{ dag.schedule_interval }}
                     </a>
-                    {% endif %}
                 </td>
 
                 <!-- Column 5: Dag Owners -->
                 <td>
-                  {{ dag.owner if dag else orm_dags[dag_id].owners }}
+                  {{ dag.owners }}
                 </td>
 
                 <!-- Column 6: Recent Tasks -->
@@ -119,14 +104,12 @@ <h2>DAGs</h2>
 
                 <!-- Column 7: Last Run -->
                 <td class="text-nowrap latest_dag_run {{ dag.dag_id }}">
-                  {% if dag %}
-                    {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
-                    {% if last_run and last_run.execution_date %}
-                      <a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
-                        {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}
-                      </a>
-                      <span aria-hidden="true" id="statuses_info" title="Start Date: {{ last_run.start_date.strftime("%Y-%m-%d %H:%M") }}" class="glyphicon glyphicon-info-sign"></span>
-                    {% endif %}
+                  {% set last_run = dag.get_last_dagrun(include_externally_triggered=True) %}
+                  {% if last_run and last_run.execution_date %}
+                    <a href="{{ url_for('Airflow.graph', dag_id=dag.dag_id, execution_date=last_run.execution_date) }}">
+                      {{ last_run.execution_date.strftime("%Y-%m-%d %H:%M") }}
+                    </a>
+                    <span aria-hidden="true" id="statuses_info" title="Start Date: {{ last_run.start_date.strftime("%Y-%m-%d %H:%M") }}" class="glyphicon glyphicon-info-sign"></span>
                   {% endif %}
                 </td>
 
@@ -187,14 +170,14 @@ <h2>DAGs</h2>
                 {% endif %}
 
                 <!-- Refresh -->
-                <a href="{{ url_for("Airflow.refresh", dag_id=dag_id) }}">
+                <a href="{{ url_for("Airflow.refresh", dag_id=dag.dag_id) }}">
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
                 <!-- Delete -->
                 <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
-                <a href="{{ url_for('Airflow.delete', dag_id=dag_id) }}"
-                  onclick="return confirmDeleteDag('{{ dag_id }}')">
+                <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id) }}"
+                  onclick="return confirmDeleteDag('{{ dag.dag_id }}')">
                    <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
                 </td>
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 2d75a37ec3646..9d2e89e1e6fe7 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -216,13 +216,16 @@ def get_int_arg(value, default=0):
             hide_paused = hide_paused_dags_by_default
 
         # read orm_dags from the db
-        sql_query = session.query(DM).filter(
+        query = session.query(DM).filter(
             ~DM.is_subdag, DM.is_active
         )
 
         # optionally filter out "paused" dags
         if hide_paused:
-            sql_query = sql_query.filter(~DM.is_paused)
+            query = query.filter(~DM.is_paused)
+
+        if arg_search_query:
+            query = query.filter(sqla.func.lower(DM.dag_id) == arg_search_query.lower())
 
         import_errors = session.query(models.ImportError).all()
         for ie in import_errors:
@@ -238,74 +241,30 @@ def get_int_arg(value, default=0):
                     filename=filename),
                 "error")
 
-        # get a list of all non-subdag dags visible to everyone
-        # optionally filter out "paused" dags
-        if hide_paused:
-            unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
-                                         not dag.parent_dag and not dag.is_paused]
-
-        else:
-            unfiltered_webserver_dags = [dag for dag in dagbag.dags.values() if
-                                         not dag.parent_dag]
-
         # Get all the dag id the user could access
         filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
 
-        if 'all_dags' in filter_dag_ids:
-            orm_dags = {dag.dag_id: dag for dag
-                        in sql_query
-                        .all()}
-        else:
-            orm_dags = {dag.dag_id: dag for dag in
-                        sql_query.filter(DM.dag_id.in_(filter_dag_ids)).all()}
-            unfiltered_webserver_dags = [dag for dag in
-                                         unfiltered_webserver_dags
-                                         if dag.dag_id in filter_dag_ids]
-
-        webserver_dags = {
-            dag.dag_id: dag
-            for dag in unfiltered_webserver_dags
-        }
-
-        if arg_search_query:
-            lower_search_query = arg_search_query.lower()
-            # filter by dag_id
-            webserver_dags_filtered = {
-                dag_id: dag
-                for dag_id, dag in webserver_dags.items()
-                if (lower_search_query in dag_id.lower() or
-                    lower_search_query in dag.owner.lower())
-            }
-
-            all_dag_ids = (set([dag.dag_id for dag in orm_dags.values()
-                                if lower_search_query in dag.dag_id.lower() or
-                                lower_search_query in dag.owners.lower()]) |
-                           set(webserver_dags_filtered.keys()))
+        if 'all_dags' not in filter_dag_ids:
+            query = query.filter(DM.dag_id.in_(filter_dag_ids))
 
-            sorted_dag_ids = sorted(all_dag_ids)
-        else:
-            webserver_dags_filtered = webserver_dags
-            sorted_dag_ids = sorted(set(orm_dags.keys()) | set(webserver_dags.keys()))
+        query = query.order_by(DM.dag_id)
 
         start = current_page * dags_per_page
         end = start + dags_per_page
 
-        num_of_all_dags = len(sorted_dag_ids)
-        page_dag_ids = sorted_dag_ids[start:end]
+        dags = query.offset(start).limit(dags_per_page).all()
+
+        num_of_all_dags = query.count()
         num_of_pages = int(math.ceil(num_of_all_dags / float(dags_per_page)))
 
         auto_complete_data = set()
-        for dag in webserver_dags_filtered.values():
-            auto_complete_data.add(dag.dag_id)
-            auto_complete_data.add(dag.owner)
-        for dag in orm_dags.values():
-            auto_complete_data.add(dag.dag_id)
-            auto_complete_data.add(dag.owners)
+        for row in query.with_entities(DM.dag_id, DM.owners):
+            auto_complete_data.add(row.dag_id)
+            auto_complete_data.add(row.owners)
 
         return self.render(
             'airflow/dags.html',
-            webserver_dags=webserver_dags_filtered,
-            orm_dags=orm_dags,
+            dags=dags,
             hide_paused=hide_paused,
             current_page=current_page,
             search_query=arg_search_query if arg_search_query else '',
@@ -317,7 +276,6 @@ def get_int_arg(value, default=0):
             paging=wwwutils.generate_pages(current_page, num_of_pages,
                                            search=arg_search_query,
                                            showPaused=not hide_paused),
-            dag_ids_in_page=page_dag_ids,
             auto_complete_data=auto_complete_data)
 
     @expose('/dag_stats')
diff --git a/tests/models.py b/tests/models.py
index e2b9f9055b7c9..82adec275bb66 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -868,13 +868,16 @@ def test_sync_to_db(self, mock_now):
         self.assertEqual(orm_dag.last_scheduler_run, now)
         self.assertTrue(orm_dag.is_active)
         self.assertIsNone(orm_dag.default_view)
-        self.assertEqual(orm_dag.get_default_view(), configuration.conf.get('webserver', 'dag_default_view').lower())
+        self.assertEqual(orm_dag.get_default_view(),
+                         configuration.conf.get('webserver', 'dag_default_view').lower())
+        self.assertEqual(orm_dag.safe_dag_id, 'dag')
 
         orm_subdag = session.query(DagModel).filter(
             DagModel.dag_id == 'dag.subtask').one()
         self.assertEqual(set(orm_subdag.owners.split(', ')), {'owner1', 'owner2'})
         self.assertEqual(orm_subdag.last_scheduler_run, now)
         self.assertTrue(orm_subdag.is_active)
+        self.assertEqual(orm_subdag.safe_dag_id, 'dag__dot__subtask')
 
     @patch('airflow.models.timezone.utcnow')
     def test_sync_to_db_default_view(self, mock_now):

From 54501f1661c71b1df51d3344ec308bc7c79d2d4b Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Wed, 27 Feb 2019 15:55:16 +0100
Subject: [PATCH 639/808] AIRFLOW-3543: Fix deletion of DAG with rescheduled
 tasks (#4646)

---
 ...c8_task_reschedule_fk_on_cascade_delete.py |  62 ++++++++
 airflow/models/__init__.py                    |   9 +-
 .../common/experimental/test_delete_dag.py    | 137 ++++++++++--------
 3 files changed, 145 insertions(+), 63 deletions(-)
 create mode 100644 airflow/migrations/versions/939bb1e647c8_task_reschedule_fk_on_cascade_delete.py

diff --git a/airflow/migrations/versions/939bb1e647c8_task_reschedule_fk_on_cascade_delete.py b/airflow/migrations/versions/939bb1e647c8_task_reschedule_fk_on_cascade_delete.py
new file mode 100644
index 0000000000000..b425b4aecec34
--- /dev/null
+++ b/airflow/migrations/versions/939bb1e647c8_task_reschedule_fk_on_cascade_delete.py
@@ -0,0 +1,62 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""task reschedule fk on cascade delete
+
+Revision ID: 939bb1e647c8
+Revises: 4ebbffe0a39a
+Create Date: 2019-02-04 20:21:50.669751
+
+"""
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = '939bb1e647c8'
+down_revision = 'dd4ecb8fbee3'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    with op.batch_alter_table('task_reschedule') as batch_op:
+        batch_op.drop_constraint(
+            'task_reschedule_dag_task_date_fkey',
+            type_='foreignkey'
+        )
+        batch_op.create_foreign_key(
+            'task_reschedule_dag_task_date_fkey',
+            'task_instance',
+            ['task_id', 'dag_id', 'execution_date'],
+            ['task_id', 'dag_id', 'execution_date'],
+            ondelete='CASCADE'
+        )
+
+
+def downgrade():
+    with op.batch_alter_table('task_reschedule') as batch_op:
+        batch_op.drop_constraint(
+            'task_reschedule_dag_task_date_fkey',
+            type_='foreignkey'
+        )
+        batch_op.create_foreign_key(
+            'task_reschedule_dag_task_date_fkey',
+            'task_instance',
+            ['task_id', 'dag_id', 'execution_date'],
+            ['task_id', 'dag_id', 'execution_date']
+        )
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index d5c9bad46e275..85b11fe6c38d5 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -1992,9 +1992,10 @@ class TaskReschedule(Base):
         Index('idx_task_reschedule_dag_task_date', dag_id, task_id, execution_date,
               unique=False),
         ForeignKeyConstraint([task_id, dag_id, execution_date],
-                             [TaskInstance.task_id, TaskInstance.dag_id,
-                              TaskInstance.execution_date],
-                             name='task_reschedule_dag_task_date_fkey')
+                             ['task_instance.task_id', 'task_instance.dag_id',
+                              'task_instance.execution_date'],
+                             name='task_reschedule_dag_task_date_fkey',
+                             ondelete='CASCADE')
     )
 
     def __init__(self, task, execution_date, try_number, start_date, end_date,
@@ -2016,7 +2017,7 @@ def find_for_task_instance(task_instance, session):
         in ascending order.
 
         :param task_instance: the task instance to find task reschedules for
-        :type task_instance: TaskInstance
+        :type task_instance: airflow.models.TaskInstance
         """
         TR = TaskReschedule
         return (
diff --git a/tests/api/common/experimental/test_delete_dag.py b/tests/api/common/experimental/test_delete_dag.py
index a012e5d3d0edd..89744d26e05ec 100644
--- a/tests/api/common/experimental/test_delete_dag.py
+++ b/tests/api/common/experimental/test_delete_dag.py
@@ -20,11 +20,11 @@
 import unittest
 
 from airflow import models
-from airflow import settings
 from airflow.api.common.experimental.delete_dag import delete_dag
 from airflow.exceptions import DagNotFound, DagFileExists
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.utils.dates import days_ago
+from airflow.utils.db import create_session
 from airflow.utils.state import State
 
 DM = models.DagModel
@@ -32,50 +32,50 @@
 DR = models.DagRun
 TI = models.TaskInstance
 LOG = models.Log
+TF = models.TaskFail
+TR = models.TaskReschedule
 
 
 class TestDeleteDAGCatchError(unittest.TestCase):
 
     def setUp(self):
-        self.session = settings.Session()
         self.dagbag = models.DagBag(include_examples=True)
         self.dag_id = 'example_bash_operator'
         self.dag = self.dagbag.dags[self.dag_id]
 
     def tearDown(self):
         self.dag.clear()
-        self.session.close()
 
     def test_delete_dag_non_existent_dag(self):
         with self.assertRaises(DagNotFound):
             delete_dag("non-existent DAG")
 
     def test_delete_dag_dag_still_in_dagbag(self):
-        models_to_check = ['DagModel', 'DagStat', 'DagRun', 'TaskInstance']
-        record_counts = {}
+        with create_session() as session:
+            models_to_check = ['DagModel', 'DagStat', 'DagRun', 'TaskInstance']
+            record_counts = {}
 
-        for model_name in models_to_check:
-            m = getattr(models, model_name)
-            record_counts[model_name] = self.session.query(m).filter(m.dag_id == self.dag_id).count()
+            for model_name in models_to_check:
+                m = getattr(models, model_name)
+                record_counts[model_name] = session.query(m).filter(m.dag_id == self.dag_id).count()
 
-        with self.assertRaises(DagFileExists):
-            delete_dag(self.dag_id)
+            with self.assertRaises(DagFileExists):
+                delete_dag(self.dag_id)
 
-        # No change should happen in DB
-        for model_name in models_to_check:
-            m = getattr(models, model_name)
-            self.assertEqual(
-                self.session.query(m).filter(
-                    m.dag_id == self.dag_id
-                ).count(),
-                record_counts[model_name]
-            )
+            # No change should happen in DB
+            for model_name in models_to_check:
+                m = getattr(models, model_name)
+                self.assertEqual(
+                    session.query(m).filter(
+                        m.dag_id == self.dag_id
+                    ).count(),
+                    record_counts[model_name]
+                )
 
 
 class TestDeleteDAGSuccessfulDelete(unittest.TestCase):
 
     def setUp(self):
-        self.session = settings.Session()
         self.key = "test_dag_id"
 
         task = DummyOperator(task_id='dummy',
@@ -83,58 +83,77 @@ def setUp(self):
                                             default_args={'start_date': days_ago(2)}),
                              owner='airflow')
 
-        self.session.add(DM(dag_id=self.key))
-        self.session.add(DS(dag_id=self.key, state=State.SUCCESS))
-        self.session.add(DR(dag_id=self.key))
-        self.session.add(TI(task=task,
-                            execution_date=days_ago(1),
-                            state=State.SUCCESS))
-        self.session.add(LOG(dag_id=self.key, task_id=None, task_instance=None,
-                             execution_date=days_ago(1), event="varimport"))
-
-        self.session.commit()
+        d = days_ago(1)
+        with create_session() as session:
+            session.add(DM(dag_id=self.key))
+            session.add(DS(dag_id=self.key, state=State.SUCCESS))
+            session.add(DR(dag_id=self.key))
+            session.add(TI(task=task,
+                           execution_date=d,
+                           state=State.SUCCESS))
+            # flush to ensure task instance if written before
+            # task reschedule because of FK constraint
+            session.flush()
+            session.add(LOG(dag_id=self.key, task_id=None, task_instance=None,
+                            execution_date=d, event="varimport"))
+            session.add(TF(task=task, execution_date=d,
+                           start_date=d, end_date=d))
+            session.add(TR(task=task, execution_date=d,
+                           start_date=d, end_date=d,
+                           try_number=1, reschedule_date=d))
 
     def tearDown(self):
-        self.session.query(DM).filter(DM.dag_id == self.key).delete()
-        self.session.query(DS).filter(DS.dag_id == self.key).delete()
-        self.session.query(DR).filter(DR.dag_id == self.key).delete()
-        self.session.query(TI).filter(TI.dag_id == self.key).delete()
-        self.session.query(LOG).filter(LOG.dag_id == self.key).delete()
-        self.session.commit()
-
-        self.session.close()
+        with create_session() as session:
+            session.query(TR).filter(TR.dag_id == self.key).delete()
+            session.query(TF).filter(TF.dag_id == self.key).delete()
+            session.query(TI).filter(TI.dag_id == self.key).delete()
+            session.query(DR).filter(DR.dag_id == self.key).delete()
+            session.query(DS).filter(DS.dag_id == self.key).delete()
+            session.query(DM).filter(DM.dag_id == self.key).delete()
+            session.query(LOG).filter(LOG.dag_id == self.key).delete()
 
     def test_delete_dag_successful_delete(self):
-
-        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+        with create_session() as session:
+            self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TR).filter(TR.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
 
         delete_dag(dag_id=self.key)
 
-        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+        with create_session() as session:
+            self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TR).filter(TR.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
 
     def test_delete_dag_successful_delete_not_keeping_records_in_log(self):
 
-        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 1)
-        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
+        with create_session() as session:
+            self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(TR).filter(TR.dag_id == self.key).count(), 1)
+            self.assertEqual(session.query(LOG).filter(LOG.dag_id == self.key).count(), 1)
 
         delete_dag(dag_id=self.key, keep_records_in_log=False)
 
-        self.assertEqual(self.session.query(DM).filter(DM.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(DS).filter(DS.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(DR).filter(DR.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(TI).filter(TI.dag_id == self.key).count(), 0)
-        self.assertEqual(self.session.query(LOG).filter(LOG.dag_id == self.key).count(), 0)
+        with create_session() as session:
+            self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(TR).filter(TR.dag_id == self.key).count(), 0)
+            self.assertEqual(session.query(LOG).filter(LOG.dag_id == self.key).count(), 0)
 
 
 if __name__ == '__main__':

From 2336e225305ec5f7e0c2e6e1e9be90d667f01f25 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 2 Jan 2019 14:49:38 +0800
Subject: [PATCH 640/808] [AIRFLOW-3606] Fix Flake8 test & fix the Flake8
 errors introduced since Flake8 test was broken (#4415)

The flake8 test in the Travis CI was broken since https://github.com/apache/incubator-airflow/pull/4361
(https://github.com/apache/incubator-airflow/commit/7a6acbf5b343e4a6895d1cc8af75ecc02b4fd0e8 )

And some Flake8 errors (code style/quality issues. found in 10 files) were introduce since flake8 test was broken.
---
 .../versions/c8ffec048a3b_add_fields_to_dag.py         | 10 +++++-----
 airflow/www/views.py                                   |  4 +++-
 airflow/www_rbac/views.py                              |  3 ++-
 tests/www_rbac/test_views.py                           |  2 +-
 4 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py b/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py
index a74e0b50a49b2..70282715edfa6 100644
--- a/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py
+++ b/airflow/migrations/versions/c8ffec048a3b_add_fields_to_dag.py
@@ -6,9 +6,9 @@
 # to you under the Apache License, Version 2.0 (the
 # "License"); you may not use this file except in compliance
 # with the License.  You may obtain a copy of the License at
-# 
+#
 #   http://www.apache.org/licenses/LICENSE-2.0
-# 
+#
 # Unless required by applicable law or agreed to in writing,
 # software distributed under the License is distributed on an
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -24,15 +24,15 @@
 
 """
 
+from alembic import op
+import sqlalchemy as sa
+
 # revision identifiers, used by Alembic.
 revision = 'c8ffec048a3b'
 down_revision = '41f5f12752f8'
 branch_labels = None
 depends_on = None
 
-from alembic import op
-import sqlalchemy as sa
-
 
 def upgrade():
     op.add_column('dag', sa.Column('description', sa.Text(), nullable=True))
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 731e4715006ed..ad829a4e05f07 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -559,7 +559,9 @@ def dag_stats(self, session=None):
         dm = models.DagModel
         dag_ids = session.query(dm.dag_id)
 
-        dag_state_stats = session.query(dr.dag_id, dr.state, sqla.func.count(dr.state)).group_by(dr.dag_id, dr.state)
+        dag_state_stats = (
+            session.query(dr.dag_id, dr.state, sqla.func.count(dr.state)).group_by(dr.dag_id, dr.state)
+        )
 
         data = {}
         for (dag_id, ) in dag_ids:
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 9d2e89e1e6fe7..df76ed291ec0e 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -286,7 +286,8 @@ def dag_stats(self, session=None):
 
         filter_dag_ids = appbuilder.sm.get_accessible_dag_ids()
 
-        dag_state_stats = session.query(dr.dag_id, dr.state, sqla.func.count(dr.state)).group_by(dr.dag_id, dr.state)
+        dag_state_stats = session.query(dr.dag_id, dr.state, sqla.func.count(dr.state))\
+            .group_by(dr.dag_id, dr.state)
 
         payload = {}
         if filter_dag_ids:
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 7598fa29d48ba..c7cec424e57e5 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -1579,7 +1579,7 @@ def test_trigger_dag_button(self):
         self.session.query(DR).delete()
         self.session.commit()
 
-        resp = self.client.get('trigger?dag_id={}'.format(test_dag_id))
+        self.client.get('trigger?dag_id={}'.format(test_dag_id))
 
         run = self.session.query(DR).filter(DR.dag_id == test_dag_id).first()
         self.assertIsNotNone(run)

From 8dc0e51f6e41ed14e82fcdd9ff48e91bbe591053 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Mon, 27 Aug 2018 17:32:56 +0200
Subject: [PATCH 641/808] [AIRFLOW-2961] Refactor
 tests.BackfillJobTest.test_backfill_examples test (#3811)

Simplify this test since it takes up 15% of all the time. This is because
every example dag, with some exclusions, are backfilled. This will put some
pressure on the scheduler and everything. If the test just covers a couple
of dags should be sufficient

254 seconds:
[success] 15.03% tests.BackfillJobTest.test_backfill_examples: 254.9323s
---
 tests/test_jobs.py | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 8203cdab675e4..784620bfcc350 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -62,6 +62,7 @@
 
 configuration.load_test_config()
 
+logger = logging.getLogger(__name__)
 
 try:
     from unittest import mock
@@ -200,23 +201,21 @@ def test_backfill_multi_dates(self):
     def test_backfill_examples(self):
         """
         Test backfilling example dags
-        """
 
-        # some DAGs really are just examples... but try to make them work!
-        skip_dags = [
-            'example_http_operator',
-            'example_twitter_dag',
-            'example_trigger_target_dag',
-            'example_trigger_controller_dag',  # tested above
-            'test_utils',  # sleeps forever
-            'example_kubernetes_executor',  # requires kubernetes cluster
-            'example_kubernetes_operator'  # requires kubernetes cluster
-        ]
+        Try to backfill some of the example dags. Be carefull, not all dags are suitable
+        for doing this. For example, a dag that sleeps forever, or does not have a
+        schedule won't work here since you simply can't backfill them.
+        """
+        include_dags = {
+            'example_branch_operator',
+            'example_bash_operator',
+            'example_skip_dag',
+            'latest_only'
+        }
 
-        logger = logging.getLogger('BackfillJobTest.test_backfill_examples')
         dags = [
             dag for dag in self.dagbag.dags.values()
-            if 'example_dags' in dag.full_filepath and dag.dag_id not in skip_dags
+            if 'example_dags' in dag.full_filepath and dag.dag_id in include_dags
         ]
 
         for dag in dags:
@@ -224,6 +223,11 @@ def test_backfill_examples(self):
                 start_date=DEFAULT_DATE,
                 end_date=DEFAULT_DATE)
 
+        # Make sure that we have the dags that we want to test available
+        # in the example_dags folder, if this assertion fails, one of the
+        # dags in the include_dags array isn't available anymore
+        self.assertEqual(len(include_dags), len(dags))
+
         for i, dag in enumerate(sorted(dags, key=lambda d: d.dag_id)):
             logger.info('*** Running example DAG #{}: {}'.format(i, dag.dag_id))
             job = BackfillJob(

From b74712ba5e9c7742a4ddd38879710a1dc5964c8e Mon Sep 17 00:00:00 2001
From: Nathaniel Ritholtz <nritholtz@gmail.com>
Date: Mon, 18 Feb 2019 20:26:46 -0500
Subject: [PATCH 642/808] [AIRFLOW-3911] Change Harvesting DAG parsing results
 to DEBUG log level (#4729)

---
 airflow/jobs.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 3cd461863aa44..a0bd9129d5fe2 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1580,7 +1580,7 @@ def _execute_helper(self):
                     "Waiting for processors to finish since we're using sqlite")
                 self.processor_agent.wait_until_finished()
 
-            self.log.info("Harvesting DAG parsing results")
+            self.log.debug("Harvesting DAG parsing results")
             simple_dags = self.processor_agent.harvest_simple_dags()
             self.log.debug("Harvested {} SimpleDAGs".format(len(simple_dags)))
 

From 94a8da446aa40c3cecd24744868844d10a37cfb7 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 9 Mar 2019 06:17:48 +0000
Subject: [PATCH 643/808] [AIRFLOW-4053] Fix KubePodOperator Xcom on Kube
 1.13.0 (#4883)

Newer versions of Kube return "failed" events for the side car container
when the ^C causes the python process to exit with 1

Kube 1.13 runs a different number of kube-dns pods (2 by default, 1.9
and 1.10 ran only 1) so the setup scripts needed changing a little bit.

To get a Kube 1.13 cluster I had to upgrade minikube, and it no longer
works on a dist without systemd installed (#systemdsucks) so I had to
update the travis dist to xenial which is no bad thing!

This version of minikube doesn't need the localkube bootstrapper set
anymore, it handles driver=none much more gracefully, and some of the
permissions set up for context files/keys needed to be updated.
---
 .travis.yml                                          |  4 ++--
 .../pod_request_factory.py                           | 11 ++++++++++-
 scripts/ci/kubernetes/minikube/_k8s.sh               | 12 +++++-------
 scripts/ci/kubernetes/minikube/start_minikube.sh     |  7 +++++--
 scripts/ci/kubernetes/minikube/stop_minikube.sh      |  3 +++
 5 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 4dd39771e1a4a..dc0c462563909 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -17,7 +17,7 @@
 # under the License.
 #
 sudo: true
-dist: trusty
+dist: xenial
 language: python
 env:
   global:
@@ -32,7 +32,7 @@ env:
     - TOX_ENV=py35-backend_sqlite-env_docker PYTHON_VERSION=3
     - TOX_ENV=py35-backend_postgres-env_docker PYTHON_VERSION=3
     - TOX_ENV=py27-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.9.0
-    - TOX_ENV=py35-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.10.0 PYTHON_VERSION=3
+    - TOX_ENV=py35-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.13.0 PYTHON_VERSION=3
 
 cache:
   directories:
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index cb1b6667c7e4f..5bd6b23e11b9f 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -89,7 +89,16 @@ class ExtractXcomPodRequestFactory(KubernetesRequestFactory):
           mountPath: {xcomMountPath}
     - name: {sidecarContainerName}
       image: python:3.5-alpine
-      command: ["python", "-m", "http.server"]
+      command:
+        - python
+        - -c
+        - |
+            import time
+            while True:
+                try:
+                    time.sleep(3600)
+                except KeyboardInterrupt:
+                    exit(0)
       volumeMounts:
         - name: xcom
           mountPath: {xcomMountPath}
diff --git a/scripts/ci/kubernetes/minikube/_k8s.sh b/scripts/ci/kubernetes/minikube/_k8s.sh
index 6ce9d3170ceb6..8debeb866651f 100644
--- a/scripts/ci/kubernetes/minikube/_k8s.sh
+++ b/scripts/ci/kubernetes/minikube/_k8s.sh
@@ -27,7 +27,7 @@ function _wait_for_ready () {
   shift
   local attempts=40
   echo "Waiting till ready (count: $count): $@"
-  while [[ "$count" != $("$@" 2>&1 | tail -n +2 | grep -c $evidence) ]];
+  while [[ "$count" < $("$@" 2>&1 | tail -n +2 | awk '{print $2}' | grep -c $evidence) ]];
   do
     if [[ "$attempts" = "1" ]]; then
       echo "Last run: $@"
@@ -54,16 +54,14 @@ function k8s_single_node_ready () {
   k8s_all_nodes_ready 1
 }
 
-# Wait for all expected number of pods to be ready. This works only for
-# pods with up to 4 containers, as we check "1/1" to "4/4" in
-# `kubectl get pods` output.
-function k8s_all_pods_ready () {
+# Wait for at leat expected number of pods to be ready.
+function k8s_at_least_n_pods_ready () {
   local count="$1"
   shift
-  local evidence="-e 1/1 -e 2/2 -e 3/3 -e 4/4"
+  local evidence="-E '([0-9])\/(\1)'"
   _wait_for_ready "$count" "$evidence" kubectl get pods "$@"
 }
 
 function k8s_single_pod_ready () {
-  k8s_all_pods_ready 1 "$@"
+  k8s_at_least_n_pods_ready 1 "$@"
 }
diff --git a/scripts/ci/kubernetes/minikube/start_minikube.sh b/scripts/ci/kubernetes/minikube/start_minikube.sh
index 9727a00acfac2..e0c621712efa4 100755
--- a/scripts/ci/kubernetes/minikube/start_minikube.sh
+++ b/scripts/ci/kubernetes/minikube/start_minikube.sh
@@ -25,7 +25,7 @@ _MY_SCRIPT="${BASH_SOURCE[0]}"
 _MY_DIR=$(cd "$(dirname "$_MY_SCRIPT")" && pwd)
 # Avoids 1.7.x because of https://github.com/kubernetes/minikube/issues/2240
 _KUBERNETES_VERSION="${KUBERNETES_VERSION}"
-_MINIKUBE_VERSION="${MINIKUBE_VERSION:-v0.28.2}"
+_MINIKUBE_VERSION="${MINIKUBE_VERSION:-v0.34.1}"
 
 echo "setting up kubernetes ${_KUBERNETES_VERSION}, using minikube ${_MINIKUBE_VERSION}"
 
@@ -105,10 +105,13 @@ echo "your path is ${PATH}"
 
 _MINIKUBE="sudo -E PATH=$PATH minikube"
 
-$_MINIKUBE config set bootstrapper localkube
 $_MINIKUBE start --kubernetes-version=${_KUBERNETES_VERSION} --vm-driver=${_VM_DRIVER}
 $_MINIKUBE update-context
 
+if [[ "${TRAVIS}" == true ]]; then
+  sudo chown -R travis.travis $HOME/.kube $HOME/.minikube
+fi
+
 # Wait for Kubernetes to be up and ready.
 k8s_single_node_ready
 
diff --git a/scripts/ci/kubernetes/minikube/stop_minikube.sh b/scripts/ci/kubernetes/minikube/stop_minikube.sh
index bd5f8bcbe7468..78150be81d43f 100755
--- a/scripts/ci/kubernetes/minikube/stop_minikube.sh
+++ b/scripts/ci/kubernetes/minikube/stop_minikube.sh
@@ -34,6 +34,9 @@ sudo minikube status
 if [[ $? = 0 ]]; then
   sudo minikube delete
   sudo rm -rf HOME/.kube $HOME/.minikube
+  if [[ "${TRAVIS}" == true ]]; then
+    sudo rm -rf /etc/kubernetes/*.conf
+  fi
 fi
 
 sudo chown -R travis.travis .

From 4dd74602c8d1361202595714b23a0143bbbb196f Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sun, 21 Oct 2018 18:50:53 +0800
Subject: [PATCH 644/808] [AIRFLOW-3239] Fix test recovery further (#4074)

Prepend "test_" for
- tests/executors/dask_executor.py
- tests/security/kerberos.py
---
 tests/executors/{dask_executor.py => test_dask_executor.py} | 0
 tests/security/{kerberos.py => test_kerberos.py}            | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename tests/executors/{dask_executor.py => test_dask_executor.py} (100%)
 rename tests/security/{kerberos.py => test_kerberos.py} (100%)

diff --git a/tests/executors/dask_executor.py b/tests/executors/test_dask_executor.py
similarity index 100%
rename from tests/executors/dask_executor.py
rename to tests/executors/test_dask_executor.py
diff --git a/tests/security/kerberos.py b/tests/security/test_kerberos.py
similarity index 100%
rename from tests/security/kerberos.py
rename to tests/security/test_kerberos.py

From 2c047aadbb923ee9bf06392660a2959a3fe7bbc5 Mon Sep 17 00:00:00 2001
From: J <jucke@users.noreply.github.com>
Date: Sat, 9 Mar 2019 22:33:31 +0000
Subject: [PATCH 645/808] [AIRFLOW-4054] Fix assertEqualIgnoreMultipleSpaces
 util & add tests (#4886)

---
 airflow/utils/tests.py    |  2 +-
 tests/utils/test_tests.py | 39 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 tests/utils/test_tests.py

diff --git a/airflow/utils/tests.py b/airflow/utils/tests.py
index 6604bb1987db2..33157f5fba9fc 100644
--- a/airflow/utils/tests.py
+++ b/airflow/utils/tests.py
@@ -35,5 +35,5 @@ def skipUnlessImported(module, obj):
 
 def assertEqualIgnoreMultipleSpaces(case, first, second, msg=None):
     def _trim(s):
-        re.sub(r"\s+", " ", s.strip())
+        return re.sub(r"\s+", " ", s.strip())
     return case.assertEqual(_trim(first), _trim(second), msg)
diff --git a/tests/utils/test_tests.py b/tests/utils/test_tests.py
new file mode 100644
index 0000000000000..8ef5b5ce22262
--- /dev/null
+++ b/tests/utils/test_tests.py
@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow.utils.tests import assertEqualIgnoreMultipleSpaces
+
+
+class UtilsTestsTest(unittest.TestCase):
+
+    def test_assertEqualIgnoreMultipleSpaces_raises(self):
+        str1 = 'w oo f'
+        str2 = 'meow'
+
+        self.assertRaises(AssertionError, lambda: assertEqualIgnoreMultipleSpaces(self, str1, str2))
+
+    def test_assertEqualIgnoreMultipleSpaces_passes(self):
+        str1 = 'w oo f'
+        str2 = """
+            w
+            oo    f
+        """
+
+        assertEqualIgnoreMultipleSpaces(self, str1, str2)

From 70c96812df9a1bafffdb38327f1a08ef801ec11c Mon Sep 17 00:00:00 2001
From: raman <ramandumcs@gmail.com>
Date: Fri, 15 Mar 2019 17:30:46 +0530
Subject: [PATCH 646/808] [AIRFLOW-3917] Specify alternate kube config
 file/context when running out of cluster (#4859)

---
 airflow/config_templates/default_airflow.cfg | 6 ++++++
 airflow/contrib/kubernetes/kube_client.py    | 5 +++++
 2 files changed, 11 insertions(+)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 9e6264c2307d8..707c45d3e316d 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -676,6 +676,12 @@ gcp_service_account_keys =
 # It will raise an exception if called from a process not running in a kubernetes environment.
 in_cluster = True
 
+# When running with in_cluster=False change the default cluster_context or config_file
+# options to Kubernetes client. Leave blank these to use default behaviour like `kubectl` has.
+# cluster_context =
+# config_file =
+
+
 # Affinity configuration as a single line formatted JSON object.
 # See the affinity model for top-level key names (e.g. `nodeAffinity`, etc.):
 #   https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.12/#affinity-v1-core
diff --git a/airflow/contrib/kubernetes/kube_client.py b/airflow/contrib/kubernetes/kube_client.py
index 4b8fa17155eed..cc699e7104475 100644
--- a/airflow/contrib/kubernetes/kube_client.py
+++ b/airflow/contrib/kubernetes/kube_client.py
@@ -48,4 +48,9 @@ def _load_kube_config(in_cluster, cluster_context, config_file):
 def get_kube_client(in_cluster=conf.getboolean('kubernetes', 'in_cluster'),
                     cluster_context=None,
                     config_file=None):
+    if not in_cluster:
+        if cluster_context is None:
+            cluster_context = conf.get('kubernetes', 'cluster_context', fallback=None)
+        if config_file is None:
+            config_file = conf.get('kubernetes', 'config_file', fallback=None)
     return _load_kube_config(in_cluster, cluster_context, config_file)

From 52f938a58224960c91571a972e3a123617b517d1 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Mon, 21 Jan 2019 20:47:47 +0100
Subject: [PATCH 647/808] [AIRFLOW-1262] Adds missing docs for email
 configuration (#4557)

---
 docs/concepts.rst | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/docs/concepts.rst b/docs/concepts.rst
index 74bcd93418a9a..9c8dbc7ba9e7a 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -612,9 +612,37 @@ Service Level Agreements, or time by which a task or DAG should have
 succeeded, can be set at a task level as a ``timedelta``. If
 one or many instances have not succeeded by that time, an alert email is sent
 detailing the list of tasks that missed their SLA. The event is also recorded
-in the database and made available in the web UI under ``Browse->Missed SLAs``
+in the database and made available in the web UI under ``Browse->SLA Misses``
 where events can be analyzed and documented.
 
+Email Configuration
+-------------------
+
+You can configure the email that is being sent in your ``airflow.cfg``
+by setting a ``subject_template`` and/or a ``html_content_template``
+in the ``email`` section.
+
+.. code::
+
+  [email]
+
+  email_backend = airflow.utils.email.send_email_smtp
+
+  subject_template = /path/to/my_subject_template_file
+  html_content_template = /path/to/my_html_content_template_file
+
+To access the task's information you use `Jinja Templating <http://jinja.pocoo.org/docs/dev/>`_  in your template files.
+
+For example a ``html_content_template`` file could look like this:
+
+.. code::
+
+  Try {{try_number}} out of {{max_tries + 1}}<br>
+  Exception:<br>{{exception_html}}<br>
+  Log: <a href="{{ti.log_url}}">Link</a><br>
+  Host: {{ti.hostname}}<br>
+  Log file: {{ti.log_filepath}}<br>
+  Mark success: <a href="{{ti.mark_success_url}}">Link</a><br>
 
 Trigger Rules
 =============

From 16dcf5d5cb7587862bd87923b8f7de96a8990675 Mon Sep 17 00:00:00 2001
From: Bryan Yang <kenshin2004528@gmail.com>
Date: Wed, 20 Mar 2019 07:48:22 +0800
Subject: [PATCH 648/808] [AIRFLOW-4124] add get_table and get_table_location
 in aws_glue_hook and tests (#4942)

---
 .../contrib/hooks/aws_glue_catalog_hook.py    | 34 +++++++++
 .../hooks/test_aws_glue_catalog_hook.py       | 69 +++++++++++++++++++
 2 files changed, 103 insertions(+)

diff --git a/airflow/contrib/hooks/aws_glue_catalog_hook.py b/airflow/contrib/hooks/aws_glue_catalog_hook.py
index 00501d3ddabc4..4b7fba533f920 100644
--- a/airflow/contrib/hooks/aws_glue_catalog_hook.py
+++ b/airflow/contrib/hooks/aws_glue_catalog_hook.py
@@ -116,3 +116,37 @@ def check_for_partition(self, database_name, table_name, expression):
             return True
         else:
             return False
+
+    def get_table(self, database_name, table_name):
+        """
+        Get the information of the table
+
+        :param database_name: Name of hive database (schema) @table belongs to
+        :type database_name: str
+        :param table_name: Name of hive table
+        :type table_name: str
+        :rtype: dict
+
+        >>> hook = AwsGlueCatalogHook()
+        >>> r = hook.get_table('db', 'table_foo')
+        >>> r['Name'] = 'table_foo'
+        """
+
+        result = self.get_conn().get_table(DatabaseName=database_name, Name=table_name)
+
+        return result['Table']
+
+    def get_table_location(self, database_name, table_name):
+        """
+        Get the physical location of the table
+
+        :param database_name: Name of hive database (schema) @table belongs to
+        :type database_name: str
+        :param table_name: Name of hive table
+        :type table_name: str
+        :return: str
+        """
+
+        table = self.get_table(database_name, table_name)
+
+        return table['StorageDescriptor']['Location']
diff --git a/tests/contrib/hooks/test_aws_glue_catalog_hook.py b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
index cddc5cfb6ff3a..4f28a1a18966e 100644
--- a/tests/contrib/hooks/test_aws_glue_catalog_hook.py
+++ b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
@@ -18,6 +18,7 @@
 
 import unittest
 
+import boto3
 from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
 
 try:
@@ -30,11 +31,31 @@
 except ImportError:
     import mock
 
+DB_NAME = 'db'
+TABLE_NAME = 'table'
+TABLE_INPUT = {
+    "Name": TABLE_NAME,
+    "StorageDescriptor": {
+        "Columns": [
+            {
+                "Name": "string",
+                "Type": "string",
+                "Comment": "string"
+            }
+        ],
+        "Location": "s3://mybucket/{}/{}".format(DB_NAME, TABLE_NAME),
+    }
+}
 
 @unittest.skipIf(mock_glue is None,
                  "Skipping test because moto.mock_glue is not available")
 class TestAwsGlueCatalogHook(unittest.TestCase):
 
+    @mock_glue
+    def setUp(self):
+        self.client = boto3.client('glue', region_name='us-east-1')
+        self.hook = AwsGlueCatalogHook(region_name="us-east-1")
+
     @mock_glue
     def test_get_conn_returns_a_boto3_connection(self):
         hook = AwsGlueCatalogHook(region_name="us-east-1")
@@ -105,6 +126,54 @@ def test_check_for_partition_false(self, mock_get_partitions):
 
         self.assertFalse(hook.check_for_partition('db', 'tbl', 'expr'))
 
+    @mock_glue
+    def test_get_table_exists(self):
+        self.client.create_database(
+            DatabaseInput={
+                'Name': DB_NAME
+            }
+        )
+        self.client.create_table(
+            DatabaseName=DB_NAME,
+            TableInput=TABLE_INPUT
+        )
+
+        result = self.hook.get_table(DB_NAME, TABLE_NAME)
+
+        self.assertEqual(result['Name'], TABLE_INPUT['Name'])
+        self.assertEqual(result['StorageDescriptor']['Location'],
+                         TABLE_INPUT['StorageDescriptor']['Location'])
+
+    @mock_glue
+    def test_get_table_not_exists(self):
+        self.client.create_database(
+            DatabaseInput={
+                'Name': DB_NAME
+            }
+        )
+        self.client.create_table(
+            DatabaseName=DB_NAME,
+            TableInput=TABLE_INPUT
+        )
+
+        with self.assertRaises(Exception):
+            self.hook.get_table(DB_NAME, 'dummy_table')
+
+    @mock_glue
+    def test_get_table_location(self):
+        self.client.create_database(
+            DatabaseInput={
+                'Name': DB_NAME
+            }
+        )
+        self.client.create_table(
+            DatabaseName=DB_NAME,
+            TableInput=TABLE_INPUT
+        )
+
+        result = self.hook.get_table_location(DB_NAME, TABLE_NAME)
+        self.assertEqual(result, TABLE_INPUT['StorageDescriptor']['Location'])
+
 
 if __name__ == '__main__':
     unittest.main()

From 15ad633cb2315222eef13235f35f17477f44445d Mon Sep 17 00:00:00 2001
From: Newton Le <newtonle@gmail.com>
Date: Mon, 18 Mar 2019 23:56:44 -0700
Subject: [PATCH 649/808] [AIRFLOW-4070] AirflowException -> log.warning for
 duplicate task dependencies (#4904)

* [AIRFLOW-4070] log.warning for duplicate task dependencies

This change logs a warning on duplicate task dependencies rather than
raising an AirflowException. This will allow automated task
dependencies to be generated while giving the user the option to
explicitly define task dependencies.

* remove test_duplicate_dependencies
---
 airflow/models/__init__.py |  2 +-
 tests/core.py              | 11 -----------
 2 files changed, 1 insertion(+), 12 deletions(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 85b11fe6c38d5..d87756511b586 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -2911,7 +2911,7 @@ def task_type(self):
 
     def add_only_new(self, item_set, item):
         if item in item_set:
-            raise AirflowException(
+            self.log.warning(
                 'Dependency {self}, {item} already registered'
                 ''.format(**locals()))
         else:
diff --git a/tests/core.py b/tests/core.py
index fc96fbf4f6d84..4e9bcf177ef0f 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -871,17 +871,6 @@ def test_scale_time_units(self):
         arr4 = scale_time_units([200000, 100000], 'days')
         assert_array_almost_equal(arr4, [2.315, 1.157], decimal=3)
 
-    def test_duplicate_dependencies(self):
-
-        regexp = "Dependency (.*)runme_0(.*)run_after_loop(.*) " \
-                 "already registered"
-
-        with self.assertRaisesRegexp(AirflowException, regexp):
-            self.runme_0.set_downstream(self.run_after_loop)
-
-        with self.assertRaisesRegexp(AirflowException, regexp):
-            self.run_after_loop.set_upstream(self.runme_0)
-
     def test_bad_trigger_rule(self):
         with self.assertRaises(AirflowException):
             DummyOperator(

From 937608ab80d29106d82f4faf19ec82296a6f7e7a Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 21 Mar 2019 17:13:35 +0000
Subject: [PATCH 650/808] [AIRFLOW-4129] Escape HTML in generated tooltips
 (#4950)

Many of these properties aren't user generated, but it is better to be
safe

Co-Authored-By: ashb <ash_github@firemirror.com>

Closes #4948
---
 airflow/www/templates/admin/master.html      |  7 ++++
 airflow/www/templates/airflow/graph.html     | 19 ++++++----
 airflow/www/templates/airflow/tree.html      | 39 ++++++++++++--------
 airflow/www_rbac/static/js/base.js           |  9 +++++
 airflow/www_rbac/static/js/graph.js          | 18 +++++----
 airflow/www_rbac/templates/airflow/tree.html | 39 ++++++++++++--------
 6 files changed, 86 insertions(+), 45 deletions(-)

diff --git a/airflow/www/templates/admin/master.html b/airflow/www/templates/admin/master.html
index 1d47bcc71905e..ec4573b5d4adb 100644
--- a/airflow/www/templates/admin/master.html
+++ b/airflow/www/templates/admin/master.html
@@ -45,6 +45,13 @@
         }
       }
     });
+
+var el = document.createElement("span");
+
+function escapeHtml(text) {
+  el.textContent = text;
+  return el.innerHTML;
+}
 </script>
 {% endblock %}
 
diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index 91dc34fb59e60..2e95ea387e909 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -280,16 +280,19 @@
             .attr("data-original-title", function(d) {
               // Tooltip
               task = tasks[task_id];
-              tt =  "Task_id: " + ti.task_id + "<br>";
-              tt += "Run: " + ti.execution_date + "<br>";
+              tt = "";
+              if(ti.task_id != undefined){
+                tt +=  "Task_id: " + escapeHtml(ti.task_id) + "<br>";
+              }
+              tt += "Run: " + escapeHtml(ti.execution_date) + "<br>";
               if(ti.run_id != undefined){
-                tt += "run_id: <nobr>" + ti.run_id + "</nobr><br>";
+                tt += "run_id: <nobr>" + escapeHtml(ti.run_id) + "</nobr><br>";
               }
-              tt += "Operator: " + task.task_type + "<br>";
-              tt += "Started: " + ti.start_date + "<br>";
-              tt += "Ended: " + ti.end_date + "<br>";
-              tt += "Duration: " + ti.duration + "<br>";
-              tt += "State: " + ti.state + "<br>";
+              tt += "Operator: " + escapeHtml(task.task_type) + "<br>";
+              tt += "Started: " + escapeHtml(ti.start_date) + "<br>";
+              tt += "Ended: " + escapeHtml(ti.end_date) + "<br>";
+              tt += "Duration: " + escapeHtml(ti.duration) + "<br>";
+              tt += "State: " + escapeHtml(ti.state) + "<br>";
               return tt;
             });
         });
diff --git a/airflow/www/templates/airflow/tree.html b/airflow/www/templates/airflow/tree.html
index 9d116ed5e0916..f16743ce35967 100644
--- a/airflow/www/templates/airflow/tree.html
+++ b/airflow/www/templates/airflow/tree.html
@@ -197,13 +197,15 @@
       .attr("title", function(d){
         var tt = "";
         if (d.operator != undefined) {
-          tt += "operator: " + d.operator + "<br/>";
-          tt += "depends_on_past: " + d.depends_on_past + "<br/>";
-          tt += "upstream: " + d.num_dep + "<br/>";
-          tt += "retries: " + d.retries + "<br/>";
-          tt += "owner: " + d.owner + "<br/>";
-          tt += "start_date: " + d.start_date + "<br/>";
-          tt += "end_date: " + d.end_date + "<br/>";
+          if (d.operator != undefined) {
+            tt += "operator: " + escapeHtml(d.operator) + "<br/>";
+          }
+          tt += "depends_on_past: " + escapeHtml(d.depends_on_past) + "<br/>";
+          tt += "upstream: " + escapeHtml(d.num_dep) + "<br/>";
+          tt += "retries: " + escapeHtml(d.retries) + "<br/>";
+          tt += "owner: " + escapeHtml(d.owner) + "<br/>";
+          tt += "start_date: " + escapeHtml(d.start_date) + "<br/>";
+          tt += "end_date: " + escapeHtml(d.end_date) + "<br/>";
         }
         return tt;
       })
@@ -244,17 +246,24 @@
       .style("stroke-width", function(d) {return (d.run_id != undefined)? "2": "1"})
       .style("stroke-opacity", function(d) {return d.external_trigger ? "0": "1"})
       .attr("title", function(d){
-        s =  "Task_id: " + d.task_id + "<br>";
-        s += "Run: " + d.execution_date + "<br>";
+        var s = "";
+        if (d.task_id != undefined ) {
+          s += "Task_id: " + escapeHtml(d.task_id) + "<br>";
+        }
+        s += "Run: " + escapeHtml(d.execution_date) + "<br>";
         if(d.run_id != undefined){
-          s += "run_id: <nobr>" + d.run_id + "</nobr><br>";
+          s += "run_id: <nobr>" + escapeHtml(d.run_id) + "</nobr><br>";
+        }
+        if (d.operator != undefined) {
+          s += "Operator: " + escapeHtml(d.operator) + "<br>"
         }
-        s += "Operator: " + d.operator + "<br>"
         if(d.start_date != undefined){
-          s += "Started: " + d.start_date + "<br>";
-          s += "Ended: " + d.end_date + "<br>";
-          s += "Duration: " + d.duration + "<br>";
-          s += "State: " + d.state + "<br>";
+          s += "Started: " + escapeHtml(d.start_date) + "<br>";
+          s += "Ended: " + escapeHtml(d.end_date) + "<br>";
+          if (d.duration != undefined) {
+            s += "Duration: " + escapeHtml(d.duration) + "<br>";
+          }
+          s += "State: " + escapeHtml(d.state) + "<br>";
         }
         return s;
       })
diff --git a/airflow/www_rbac/static/js/base.js b/airflow/www_rbac/static/js/base.js
index ea065792a533a..1f16b44a16bb9 100644
--- a/airflow/www_rbac/static/js/base.js
+++ b/airflow/www_rbac/static/js/base.js
@@ -30,6 +30,15 @@ function displayTime() {
   setTimeout(displayTime, 1000);
 }
 
+var el = document.createElement("span");
+
+export function escapeHtml(text) {
+  el.textContent = text;
+  return el.innerHTML;
+}
+
+window.escapeHtml = escapeHtml;
+
 $(document).ready(function () {
   displayTime();
   $('span').tooltip();
diff --git a/airflow/www_rbac/static/js/graph.js b/airflow/www_rbac/static/js/graph.js
index c5a428b0e9476..416d4198d3572 100644
--- a/airflow/www_rbac/static/js/graph.js
+++ b/airflow/www_rbac/static/js/graph.js
@@ -18,6 +18,7 @@
  */
 
 import { generateTooltipDateTime, converAndFormatUTC } from './datetime-utils';
+import { escapeHtml } from './base';
 
 // Assigning css classes based on state to nodes
 // Initiating the tooltips
@@ -32,14 +33,17 @@ function update_nodes_states(task_instances) {
       .attr("data-original-title", function (d) {
         // Tooltip
         const task = tasks[task_id];
-        let tt = "Task_id: " + ti.task_id + "<br>";
-        tt += "Run: " + converAndFormatUTC(ti.execution_date) + "<br>";
-        if (ti.run_id != undefined) {
-          tt += "run_id: <nobr>" + ti.run_id + "</nobr><br>";
+        let tt = "";
+        if(ti.task_id != undefined) {
+          tt +=  "Task_id: " + escapeHtml(task.task_id) + "<br>";
         }
-        tt += "Operator: " + task.task_type + "<br>";
-        tt += "Duration: " + ti.duration + "<br>";
-        tt += "State: " + ti.state + "<br>";
+        tt += "Run: " + converAndFormatUTC(task.execution_date) + "<br>";
+        if(ti.run_id != undefined) {
+          tt += "run_id: <nobr>" + escapeHtml(task.run_id) + "</nobr><br>";
+        }
+        tt += "Operator: " + escapeHtml(task.task_type) + "<br>";
+        tt += "Duration: " + escapeHtml(task.duration) + "<br>";
+        tt += "Started: " + escapeHtml(ti.start_date) + "<br>";
         tt += generateTooltipDateTime(ti.start_date, ti.end_date, dagTZ); // dagTZ has been defined in dag.html
         return tt;
       });
diff --git a/airflow/www_rbac/templates/airflow/tree.html b/airflow/www_rbac/templates/airflow/tree.html
index 87afe2fd14193..904d0b007a42f 100644
--- a/airflow/www_rbac/templates/airflow/tree.html
+++ b/airflow/www_rbac/templates/airflow/tree.html
@@ -199,13 +199,15 @@
       .attr("title", function(d){
         var tt = "";
         if (d.operator != undefined) {
-          tt += "operator: " + d.operator + "<br/>";
-          tt += "depends_on_past: " + d.depends_on_past + "<br/>";
-          tt += "upstream: " + d.num_dep + "<br/>";
-          tt += "retries: " + d.retries + "<br/>";
-          tt += "owner: " + d.owner + "<br/>";
-          tt += "start_date: " + d.start_date + "<br/>";
-          tt += "end_date: " + d.end_date + "<br/>";
+          if (d.operator != undefined) {
+            tt += "operator: " + escapeHtml(d.operator) + "<br/>";
+          }
+          tt += "depends_on_past: " + escapeHtml(d.depends_on_past) + "<br/>";
+          tt += "upstream: " + escapeHtml(d.num_dep) + "<br/>";
+          tt += "retries: " + escapeHtml(d.retries) + "<br/>";
+          tt += "owner: " + escapeHtml(d.owner) + "<br/>";
+          tt += "start_date: " + escapeHtml(d.start_date) + "<br/>";
+          tt += "end_date: " + escapeHtml(d.end_date) + "<br/>";
         }
         return tt;
       })
@@ -246,17 +248,24 @@
       .style("stroke-width", function(d) {return (d.run_id != undefined)? "2": "1"})
       .style("stroke-opacity", function(d) {return d.external_trigger ? "0": "1"})
       .attr("title", function(d){
-        s =  "Task_id: " + d.task_id + "<br>";
-        s += "Run: " + d.execution_date + "<br>";
+        var s = "";
+        if (d.task_id != undefined) {
+          s += "Task_id: " + escapeHtml(d.task_id) + "<br>";
+        }
+        s += "Run: " + escapeHtml(d.execution_date) + "<br>";
         if(d.run_id != undefined){
-          s += "run_id: <nobr>" + d.run_id + "</nobr><br>";
+          s += "run_id: <nobr>" + escapeHtml(d.run_id) + "</nobr><br>";
+        }
+        if (d.operator != undefined) {
+          s += "Operator: " + escapeHtml(d.operator) + "<br>"
         }
-        s += "Operator: " + d.operator + "<br>"
         if(d.start_date != undefined){
-          s += "Started: " + d.start_date + "<br>";
-          s += "Ended: " + d.end_date + "<br>";
-          s += "Duration: " + d.duration + "<br>";
-          s += "State: " + d.state + "<br>";
+          s += "Started: " + escapeHtml(d.start_date) + "<br>";
+          s += "Ended: " + escapeHtml(d.end_date) + "<br>";
+          if (d.duration != undefined) {
+            s += "Duration: " + escapeHtml(d.duration) + "<br>";
+          }
+          s += "State: " + escapeHtml(d.state) + "<br>";
         }
         return s;
       })

From ca2f54eeb89a98e98d42a3dbf46f1ebd3aad9bd7 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 5 Mar 2019 12:33:34 +0800
Subject: [PATCH 651/808] [AIRFLOW-4006] Make better use of Set in
 AirflowSecurityManager (#4833)

* [AIRFLOW-4006] Make better use of Set in AirflowSecurityManager

For performance & simplicity

* Use more neat method for Set union operation
---
 airflow/www_rbac/security.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 6bc627a561eed..eb8427898248d 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -184,11 +184,11 @@ def init_role(self, role_name, role_vms, role_perms):
 
         if len(role.permissions) == 0:
             logging.info('Initializing permissions for role:%s in the database.', role_name)
-            role_pvms = []
+            role_pvms = set()
             for pvm in pvms:
                 if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
-                    role_pvms.append(pvm)
-            role.permissions = list(set(role_pvms))
+                    role_pvms.add(pvm)
+            role.permissions = list(role_pvms)
             self.get_session.merge(role)
             self.get_session.commit()
         else:
@@ -212,8 +212,8 @@ def get_all_permissions_views(self):
         """
         perms_views = set()
         for role in self.get_user_roles():
-            for perm_view in role.permissions:
-                perms_views.add((perm_view.permission.name, perm_view.view_menu.name))
+            perms_views.update({(perm_view.permission.name, perm_view.view_menu.name)
+                                for perm_view in role.permissions})
         return perms_views
 
     def get_accessible_dag_ids(self, username=None):

From 917680ae4f7c5c3d2aaf9a0fd507f8bacfbafd43 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 26 Feb 2019 10:07:07 +0800
Subject: [PATCH 652/808] [AIRFLOW-3950] Improve
 AirflowSecurityManager.update_admin_perm_view (#4774)

- simplify the implementation
- improve the performance
---
 airflow/www_rbac/security.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index eb8427898248d..91645d95f7088 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -419,11 +419,8 @@ def update_admin_perm_view(self):
         pvms = [p for p in pvms if p.permission and p.view_menu]
 
         admin = self.find_role('Admin')
-        existing_perms_vms = set(admin.permissions)
-        for p in pvms:
-            if p not in existing_perms_vms:
-                existing_perms_vms.add(p)
-        admin.permissions = list(existing_perms_vms)
+        admin.permissions = list(set(admin.permissions) | set(pvms))
+
         self.get_session.commit()
 
     def sync_roles(self):

From 10d64c7770f554ca55d4ecec983f996ab40ab388 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ole=20Christian=20Langfj=C3=A6ran?= <judoole@gmail.com>
Date: Wed, 6 Mar 2019 16:18:53 +0100
Subject: [PATCH 653/808] [AIRFLOW-3895] GoogleCloudStorageHook/Op
 create_bucket takes optional resource params (#4717)

This makes it possible to supply missing request-parameters when
creating a bucket in Google Cloud Storage
---
 airflow/contrib/hooks/gcs_hook.py            | 11 +++-
 airflow/contrib/operators/gcs_operator.py    |  7 +++
 tests/contrib/hooks/test_gcs_hook.py         | 66 ++++++++++++++++++++
 tests/contrib/operators/test_gcs_operator.py |  4 +-
 4 files changed, 85 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index a8442a1c3edd8..987dbf583892b 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
+
 from googleapiclient.discovery import build
 from googleapiclient.http import MediaFileUpload
 from googleapiclient.errors import HttpError
@@ -477,6 +478,7 @@ def get_md5hash(self, bucket, object):
 
     def create_bucket(self,
                       bucket_name,
+                      resource=None,
                       storage_class='MULTI_REGIONAL',
                       location='US',
                       project_id=None,
@@ -492,6 +494,10 @@ def create_bucket(self,
 
         :param bucket_name: The name of the bucket.
         :type bucket_name: str
+        :param resource: An optional dict with parameters for creating the bucket.
+            For information on available parameters, see Cloud Storage API doc:
+            https://cloud.google.com/storage/docs/json_api/v1/buckets/insert
+        :type resource: dict
         :param storage_class: This defines how objects in the bucket are stored
             and determines the SLA and the cost of storage. Values include
 
@@ -542,11 +548,12 @@ def create_bucket(self,
             raise ValueError('Bucket names must end with a number or letter.')
 
         service = self.get_conn()
-        bucket_resource = {
+        bucket_resource = resource or {}
+        bucket_resource.update({
             'name': bucket_name,
             'location': location,
             'storageClass': storage_class
-        }
+        })
 
         self.log.info('The Default Project ID is %s', self.project_id)
 
diff --git a/airflow/contrib/operators/gcs_operator.py b/airflow/contrib/operators/gcs_operator.py
index db821717cdb51..31c8f8fa0c91c 100644
--- a/airflow/contrib/operators/gcs_operator.py
+++ b/airflow/contrib/operators/gcs_operator.py
@@ -34,6 +34,10 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
 
     :param bucket_name: The name of the bucket. (templated)
     :type bucket_name: str
+    :param resource: An optional dict with parameters for creating the bucket.
+            For information on available parameters, see Cloud Storage API doc:
+            https://cloud.google.com/storage/docs/json_api/v1/buckets/insert
+    :type resource: dict
     :param storage_class: This defines how objects in the bucket are stored
             and determines the SLA and the cost of storage (templated). Values include
 
@@ -86,6 +90,7 @@ class GoogleCloudStorageCreateBucketOperator(BaseOperator):
     @apply_defaults
     def __init__(self,
                  bucket_name,
+                 resource=None,
                  storage_class='MULTI_REGIONAL',
                  location='US',
                  project_id=None,
@@ -96,6 +101,7 @@ def __init__(self,
                  **kwargs):
         super(GoogleCloudStorageCreateBucketOperator, self).__init__(*args, **kwargs)
         self.bucket_name = bucket_name
+        self.resource = resource
         self.storage_class = storage_class
         self.location = location
         self.project_id = project_id
@@ -116,6 +122,7 @@ def execute(self, context):
         )
 
         hook.create_bucket(bucket_name=self.bucket_name,
+                           resource=self.resource,
                            storage_class=self.storage_class,
                            location=self.location,
                            project_id=self.project_id,
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index 3dedc37516d50..46faede46a8e5 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -343,6 +343,72 @@ def test_delete_nonexisting_object(self, mock_service):
 
         self.assertFalse(response)
 
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_create_bucket(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_project = 'test-project'
+        test_location = 'EU',
+        test_labels = {'env': 'prod'}
+        test_storage_class = 'MULTI_REGIONAL'
+        test_response_id = "{}/0123456789012345".format(test_bucket)
+
+        (mock_service.return_value.buckets.return_value
+         .insert.return_value.execute.return_value) = {"id": test_response_id}
+
+        response = self.gcs_hook.create_bucket(
+            bucket_name=test_bucket,
+            storage_class=test_storage_class,
+            location=test_location,
+            labels=test_labels,
+            project_id=test_project
+        )
+
+        self.assertEqual(response, test_response_id)
+        mock_service.return_value.buckets.return_value.insert.assert_called_with(
+            project=test_project,
+            body={
+                'name': test_bucket,
+                'location': test_location,
+                'storageClass': test_storage_class,
+                'labels': test_labels
+            }
+        )
+
+    @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
+    def test_create_bucket_with_resource(self, mock_service):
+        test_bucket = 'test_bucket'
+        test_project = 'test-project'
+        test_location = 'EU',
+        test_labels = {'env': 'prod'}
+        test_storage_class = 'MULTI_REGIONAL'
+        test_response_id = "{}/0123456789012345".format(test_bucket)
+        test_lifecycle = {"rule": [{"action": {"type": "Delete"}, "condition": {"age": 7}}]}
+
+        (mock_service.return_value.buckets.return_value
+         .insert.return_value.execute.return_value) = {"id": test_response_id}
+
+        # Assert for resource other than None.
+        response = self.gcs_hook.create_bucket(
+            bucket_name=test_bucket,
+            resource={"lifecycle": {"rule": [{"action": {"type": "Delete"}, "condition": {"age": 7}}]}},
+            storage_class=test_storage_class,
+            location=test_location,
+            labels=test_labels,
+            project_id=test_project
+        )
+
+        self.assertEqual(response, test_response_id)
+        mock_service.return_value.buckets.return_value.insert.assert_called_with(
+            project=test_project,
+            body={
+                "lifecycle": test_lifecycle,
+                'name': test_bucket,
+                'location': test_location,
+                'storageClass': test_storage_class,
+                'labels': test_labels
+            }
+        )
+
     @mock.patch(GCS_STRING.format('GoogleCloudStorageHook.get_conn'))
     def test_compose(self, mock_service):
         test_bucket = 'test_bucket'
diff --git a/tests/contrib/operators/test_gcs_operator.py b/tests/contrib/operators/test_gcs_operator.py
index cd51933de7268..095f316bd82ce 100644
--- a/tests/contrib/operators/test_gcs_operator.py
+++ b/tests/contrib/operators/test_gcs_operator.py
@@ -42,6 +42,7 @@ def test_execute(self, mock_hook):
         operator = GoogleCloudStorageCreateBucketOperator(
             task_id=TASK_ID,
             bucket_name=TEST_BUCKET,
+            resource={"lifecycle": {"rule": [{"action": {"type": "Delete"}, "condition": {"age": 7}}]}},
             storage_class='MULTI_REGIONAL',
             location='EU',
             labels={'env': 'prod'},
@@ -54,5 +55,6 @@ def test_execute(self, mock_hook):
             location='EU', labels={
                 'airflow-version': 'v' + version.replace('.', '-').replace('+', '-'),
                 'env': 'prod'
-            }, project_id=TEST_PROJECT
+            }, project_id=TEST_PROJECT,
+            resource={'lifecycle': {'rule': [{'action': {'type': 'Delete'}, 'condition': {'age': 7}}]}}
         )

From 05384fc6e3badaa09a6dcd499929fc942f5c8e38 Mon Sep 17 00:00:00 2001
From: mans2singh <mans2singh@users.noreply.github.com>
Date: Wed, 6 Mar 2019 12:47:06 -0500
Subject: [PATCH 654/808] [AIRFLOW-3892] Create Redis pub sub sensor (#4712)

* [AIRFLOW-3892] Create Redis pub sub sensor

* [AIRFLOW-3892] - Updated based on review comments (#4712)

Use redis_conn_id, removed logging from test, corrected unittest import, removed rtype from poke doc

* [AIRFLOW-3892] Combined import based on review comments

* [AIRFLOW-3892] Removed extra log based on review comments

* [AIRFLOW-3892] - Added integration tests based on review comments

* [AIRFLOW-3892] - Added example dag to kick off the build

* [AIRFLOW-3892] - Removed example dag based on review comments
---
 .../contrib/sensors/redis_pub_sub_sensor.py   |  73 ++++++++++
 .../sensors/test_redis_pub_sub_sensor.py      | 125 ++++++++++++++++++
 2 files changed, 198 insertions(+)
 create mode 100644 airflow/contrib/sensors/redis_pub_sub_sensor.py
 create mode 100644 tests/contrib/sensors/test_redis_pub_sub_sensor.py

diff --git a/airflow/contrib/sensors/redis_pub_sub_sensor.py b/airflow/contrib/sensors/redis_pub_sub_sensor.py
new file mode 100644
index 0000000000000..474a8d21d61ef
--- /dev/null
+++ b/airflow/contrib/sensors/redis_pub_sub_sensor.py
@@ -0,0 +1,73 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+from airflow.contrib.hooks.redis_hook import RedisHook
+
+
+class RedisPubSubSensor(BaseSensorOperator):
+
+    """
+    Redis sensor for reading a message from pub sub channels
+    """
+    template_fields = ('channels',)
+    ui_color = '#f0eee4'
+
+    @apply_defaults
+    def __init__(self, channels, redis_conn_id, *args, **kwargs):
+        """
+        Create a new RedisPubSubSensor and subscribe to the channels
+
+        :param channels: The channels to be subscribed to (templated)
+        :type channels: str or list of str
+        :param redis_conn_id: the redis connection id
+        :type redis_conn_id: str
+        """
+
+        super(RedisPubSubSensor, self).__init__(*args, **kwargs)
+        self.channels = channels
+        self.redis_conn_id = redis_conn_id
+        self.pubsub = RedisHook(redis_conn_id=self.redis_conn_id).get_conn().pubsub()
+        self.pubsub.subscribe(self.channels)
+
+    def poke(self, context):
+        """
+        Check for message on subscribed channels and write to xcom the message with key ``message``
+
+        An example of message ``{'type': 'message', 'pattern': None, 'channel': b'test', 'data': b'hello'}``
+
+        :param context: the context object
+        :type context: dict
+        :return: ``True`` if message (with type 'message') is available or ``False`` if not
+        """
+        self.log.info('RedisPubSubSensor checking for message on channels: %s', self.channels)
+
+        message = self.pubsub.get_message()
+        self.log.info('Message %s from channel %s', message, self.channels)
+
+        # Process only message types
+        if message and message['type'] == 'message':
+
+            context['ti'].xcom_push(key='message', value=message)
+            self.pubsub.unsubscribe(self.channels)
+
+            return True
+
+        return False
diff --git a/tests/contrib/sensors/test_redis_pub_sub_sensor.py b/tests/contrib/sensors/test_redis_pub_sub_sensor.py
new file mode 100644
index 0000000000000..42b47b6f57996
--- /dev/null
+++ b/tests/contrib/sensors/test_redis_pub_sub_sensor.py
@@ -0,0 +1,125 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+
+import unittest
+from airflow import DAG, configuration
+from airflow.contrib.sensors.redis_pub_sub_sensor import RedisPubSubSensor
+from airflow.utils import timezone
+from airflow.contrib.hooks.redis_hook import RedisHook
+from mock import patch, call, MagicMock
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+
+class TestRedisPubSubSensor(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+
+        self.dag = DAG('test_dag_id', default_args=args)
+
+        self.mock_context = MagicMock()
+
+    @patch('airflow.contrib.hooks.redis_hook.RedisHook.get_conn')
+    def test_poke_mock_true(self, mock_redis_conn):
+        sensor = RedisPubSubSensor(
+            task_id='test_task',
+            dag=self.dag,
+            channels='test',
+            redis_conn_id='redis_default'
+        )
+
+        self.mock_redis_conn = mock_redis_conn
+        self.mock_redis_conn().pubsub().get_message.return_value = \
+            {'type': 'message', 'channel': b'test', 'data': b'd1'}
+
+        result = sensor.poke(self.mock_context)
+        self.assertTrue(result)
+
+        context_calls = [call.xcom_push(key='message',
+                                        value={'type': 'message', 'channel': b'test', 'data': b'd1'})]
+
+        self.assertTrue(self.mock_context['ti'].method_calls == context_calls, "context call  should be same")
+
+    @patch('airflow.contrib.hooks.redis_hook.RedisHook.get_conn')
+    def test_poke_mock_false(self, mock_redis_conn):
+        sensor = RedisPubSubSensor(
+            task_id='test_task',
+            dag=self.dag,
+            channels='test',
+            redis_conn_id='redis_default'
+        )
+        self.mock_redis_conn = mock_redis_conn
+        self.mock_redis_conn().pubsub().get_message.return_value = \
+            {'type': 'subscribe', 'channel': b'test', 'data': b'd1'}
+
+        result = sensor.poke(self.mock_context)
+        self.assertFalse(result)
+
+        context_calls = []
+        self.assertTrue(self.mock_context['ti'].method_calls == context_calls, "context calls should be same")
+
+    def test_poke_true(self):
+        sensor = RedisPubSubSensor(
+            task_id='test_task',
+            dag=self.dag,
+            channels='test',
+            redis_conn_id='redis_default'
+        )
+
+        hook = RedisHook(redis_conn_id='redis_default')
+        redis = hook.get_conn()
+        redis.publish('test', 'message')
+
+        result = sensor.poke(self.mock_context)
+        self.assertFalse(result)
+        result = sensor.poke(self.mock_context)
+        self.assertTrue(result)
+        context_calls = [
+            call.xcom_push(
+                key='message',
+                value={'type': 'message', 'pattern': None, 'channel': b'test', 'data': b'message'})]
+        self.assertTrue(self.mock_context['ti'].method_calls == context_calls, "context calls should be same")
+        result = sensor.poke(self.mock_context)
+        self.assertFalse(result)
+
+    def test_poke_false(self):
+        sensor = RedisPubSubSensor(
+            task_id='test_task',
+            dag=self.dag,
+            channels='test',
+            redis_conn_id='redis_default'
+        )
+
+        result = sensor.poke(self.mock_context)
+        self.assertFalse(result)
+        self.assertTrue(self.mock_context['ti'].method_calls == [], "context calls should be same")
+        result = sensor.poke(self.mock_context)
+        self.assertFalse(result)
+        self.assertTrue(self.mock_context['ti'].method_calls == [], "context calls should be same")
+
+
+if __name__ == '__main__':
+    unittest.main()

From bc65917a3dc6b92f2fa1313f375de590ce1c379a Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Sun, 2 Dec 2018 11:08:26 +0000
Subject: [PATCH 655/808] [AIRFLOW-XXX] Add missing GCP operators to Docs
 (#4260)

---
 airflow/contrib/operators/mysql_to_gcs.py | 67 +++++++++++------------
 1 file changed, 33 insertions(+), 34 deletions(-)

diff --git a/airflow/contrib/operators/mysql_to_gcs.py b/airflow/contrib/operators/mysql_to_gcs.py
index d9fc932ff58dd..40d9c49fa29a4 100644
--- a/airflow/contrib/operators/mysql_to_gcs.py
+++ b/airflow/contrib/operators/mysql_to_gcs.py
@@ -38,6 +38,39 @@
 class MySqlToGoogleCloudStorageOperator(BaseOperator):
     """
     Copy data from MySQL to Google cloud storage in JSON format.
+
+    :param sql: The SQL to execute on the MySQL table.
+    :type sql: str
+    :param bucket: The bucket to upload to.
+    :type bucket: str
+    :param filename: The filename to use as the object name when uploading
+        to Google cloud storage. A {} should be specified in the filename
+        to allow the operator to inject file numbers in cases where the
+        file is split due to size.
+    :type filename: str
+    :param schema_filename: If set, the filename to use as the object name
+        when uploading a .json file containing the BigQuery schema fields
+        for the table that was dumped from MySQL.
+    :type schema_filename: str
+    :param approx_max_file_size_bytes: This operator supports the ability
+        to split large table dumps into multiple files (see notes in the
+        filenamed param docs above). Google cloud storage allows for files
+        to be a maximum of 4GB. This param allows developers to specify the
+        file size of the splits.
+    :type approx_max_file_size_bytes: long
+    :param mysql_conn_id: Reference to a specific MySQL hook.
+    :type mysql_conn_id: str
+    :param google_cloud_storage_conn_id: Reference to a specific Google
+        cloud storage hook.
+    :type google_cloud_storage_conn_id: str
+    :param schema: The schema to use, if any. Should be a list of dict or
+        a str. Pass a string if using Jinja template, otherwise, pass a list of
+        dict. Examples could be seen: https://cloud.google.com/bigquery/docs
+        /schemas#specifying_a_json_schema_file
+    :type schema: str or list
+    :param delegate_to: The account to impersonate, if any. For this to
+        work, the service account making the request must have domain-wide
+        delegation enabled.
     """
     template_fields = ('sql', 'bucket', 'filename', 'schema_filename', 'schema')
     template_ext = ('.sql',)
@@ -56,40 +89,6 @@ def __init__(self,
                  delegate_to=None,
                  *args,
                  **kwargs):
-        """
-        :param sql: The SQL to execute on the MySQL table.
-        :type sql: str
-        :param bucket: The bucket to upload to.
-        :type bucket: str
-        :param filename: The filename to use as the object name when uploading
-            to Google cloud storage. A {} should be specified in the filename
-            to allow the operator to inject file numbers in cases where the
-            file is split due to size.
-        :type filename: str
-        :param schema_filename: If set, the filename to use as the object name
-            when uploading a .json file containing the BigQuery schema fields
-            for the table that was dumped from MySQL.
-        :type schema_filename: str
-        :param approx_max_file_size_bytes: This operator supports the ability
-            to split large table dumps into multiple files (see notes in the
-            filenamed param docs above). Google cloud storage allows for files
-            to be a maximum of 4GB. This param allows developers to specify the
-            file size of the splits.
-        :type approx_max_file_size_bytes: long
-        :param mysql_conn_id: Reference to a specific MySQL hook.
-        :type mysql_conn_id: str
-        :param google_cloud_storage_conn_id: Reference to a specific Google
-            cloud storage hook.
-        :type google_cloud_storage_conn_id: str
-        :param schema: The schema to use, if any. Should be a list of dict or
-            a str. Pass a string if using Jinja template, otherwise, pass a list of
-            dict. Examples could be seen: https://cloud.google.com/bigquery/docs
-            /schemas#specifying_a_json_schema_file
-        :type schema: str or list
-        :param delegate_to: The account to impersonate, if any. For this to
-            work, the service account making the request must have domain-wide
-            delegation enabled.
-        """
         super(MySqlToGoogleCloudStorageOperator, self).__init__(*args, **kwargs)
         self.sql = sql
         self.bucket = bucket

From 452ed736f4dd1a57ddf7f4270a5c49048eddf006 Mon Sep 17 00:00:00 2001
From: Tanay Tummalapalli <ttanay100@gmail.com>
Date: Thu, 7 Mar 2019 01:09:20 +0530
Subject: [PATCH 656/808] [AIRFLOW-2224] Add support CSV files in
 MySqlToGoogleCloudStorageOperator (#4738)

MySqlToGoogleCloudStorageOperator supported export from MySQL in
newline-delimited JSON format only. Added support for export
from MySQL in CSV format with the option of specifying a field
delimiter.Thanks to Bernardo Najlis(@bnajlis) for the original
PR(#3139). I made some changes to the the original PR.
---
 airflow/contrib/operators/mysql_to_gcs.py     | 103 ++++++--
 .../operators/test_mysql_to_gcs_operator.py   | 241 +++++++++++++++---
 2 files changed, 290 insertions(+), 54 deletions(-)

diff --git a/airflow/contrib/operators/mysql_to_gcs.py b/airflow/contrib/operators/mysql_to_gcs.py
index 40d9c49fa29a4..c168b75e75e55 100644
--- a/airflow/contrib/operators/mysql_to_gcs.py
+++ b/airflow/contrib/operators/mysql_to_gcs.py
@@ -31,13 +31,18 @@
 from MySQLdb.constants import FIELD_TYPE
 from tempfile import NamedTemporaryFile
 from six import string_types
+import unicodecsv as csv
 
 PY3 = sys.version_info[0] == 3
 
 
 class MySqlToGoogleCloudStorageOperator(BaseOperator):
-    """
-    Copy data from MySQL to Google cloud storage in JSON format.
+    """Copy data from MySQL to Google cloud storage in JSON or CSV format.
+
+    The JSON data files generated are newline-delimited to enable them to be
+    loaded into BigQuery.
+    Reference: https://cloud.google.com/bigquery/docs/
+    loading-data-cloud-storage-json#limitations
 
     :param sql: The SQL to execute on the MySQL table.
     :type sql: str
@@ -71,6 +76,11 @@ class MySqlToGoogleCloudStorageOperator(BaseOperator):
     :param delegate_to: The account to impersonate, if any. For this to
         work, the service account making the request must have domain-wide
         delegation enabled.
+    :type delegate_to: str
+    :param export_format: Desired format of files to be exported.
+    :type export_format: str
+    :param field_delimiter: The delimiter to be used for CSV files.
+    :type field_delimiter: str
     """
     template_fields = ('sql', 'bucket', 'filename', 'schema_filename', 'schema')
     template_ext = ('.sql',)
@@ -87,6 +97,8 @@ def __init__(self,
                  google_cloud_storage_conn_id='google_cloud_default',
                  schema=None,
                  delegate_to=None,
+                 export_format='json',
+                 field_delimiter=',',
                  *args,
                  **kwargs):
         super(MySqlToGoogleCloudStorageOperator, self).__init__(*args, **kwargs)
@@ -99,6 +111,8 @@ def __init__(self,
         self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
         self.schema = schema
         self.delegate_to = delegate_to
+        self.export_format = export_format.lower()
+        self.field_delimiter = field_delimiter
 
     def execute(self, context):
         cursor = self._query_mysql()
@@ -106,17 +120,19 @@ def execute(self, context):
 
         # If a schema is set, create a BQ schema JSON file.
         if self.schema_filename:
-            files_to_upload.update(self._write_local_schema_file(cursor))
+            files_to_upload.append(self._write_local_schema_file(cursor))
 
         # Flush all files before uploading.
-        for file_handle in files_to_upload.values():
-            file_handle.flush()
+        for tmp_file in files_to_upload:
+            tmp_file_handle = tmp_file.get('file_handle')
+            tmp_file_handle.flush()
 
         self._upload_to_gcs(files_to_upload)
 
         # Close all temp file handles.
-        for file_handle in files_to_upload.values():
-            file_handle.close()
+        for tmp_file in files_to_upload:
+            tmp_file_handle = tmp_file.get('file_handle')
+            tmp_file_handle.close()
 
     def _query_mysql(self):
         """
@@ -140,41 +156,73 @@ def _write_local_data_files(self, cursor):
         col_type_dict = self._get_col_type_dict()
         file_no = 0
         tmp_file_handle = NamedTemporaryFile(delete=True)
-        tmp_file_handles = {self.filename.format(file_no): tmp_file_handle}
+        if self.export_format == 'csv':
+            file_mime_type = 'text/csv'
+        else:
+            file_mime_type = 'application/json'
+        files_to_upload = [{
+            'file_name': self.filename.format(file_no),
+            'file_handle': tmp_file_handle,
+            'file_mime_type': file_mime_type
+        }]
+
+        if self.export_format == 'csv':
+            csv_writer = self._configure_csv_file(tmp_file_handle, schema)
 
         for row in cursor:
             # Convert datetime objects to utc seconds, and decimals to floats.
             # Convert binary type object to string encoded with base64.
             row = self._convert_types(schema, col_type_dict, row)
-            row_dict = dict(zip(schema, row))
 
-            # TODO validate that row isn't > 2MB. BQ enforces a hard row size of 2MB.
-            s = json.dumps(row_dict)
-            if PY3:
-                s = s.encode('utf-8')
-            tmp_file_handle.write(s)
+            if self.export_format == 'csv':
+                csv_writer.writerow(row)
+            else:
+                row_dict = dict(zip(schema, row))
+
+                # TODO validate that row isn't > 2MB. BQ enforces a hard row size of 2MB.
+                s = json.dumps(row_dict, sort_keys=True)
+                if PY3:
+                    s = s.encode('utf-8')
+                tmp_file_handle.write(s)
 
-            # Append newline to make dumps BigQuery compatible.
-            tmp_file_handle.write(b'\n')
+                # Append newline to make dumps BigQuery compatible.
+                tmp_file_handle.write(b'\n')
 
             # Stop if the file exceeds the file size limit.
             if tmp_file_handle.tell() >= self.approx_max_file_size_bytes:
                 file_no += 1
                 tmp_file_handle = NamedTemporaryFile(delete=True)
-                tmp_file_handles[self.filename.format(file_no)] = tmp_file_handle
+                files_to_upload.append({
+                    'file_name': self.filename.format(file_no),
+                    'file_handle': tmp_file_handle,
+                    'file_mime_type': file_mime_type
+                })
+
+                if self.export_format == 'csv':
+                    csv_writer = self._configure_csv_file(tmp_file_handle, schema)
 
-        return tmp_file_handles
+        return files_to_upload
+
+    def _configure_csv_file(self, file_handle, schema):
+        """Configure a csv writer with the file_handle and write schema
+        as headers for the new file.
+        """
+        csv_writer = csv.writer(file_handle, encoding='utf-8',
+                                delimiter=self.field_delimiter)
+        csv_writer.writerow(schema)
+        return csv_writer
 
     def _write_local_schema_file(self, cursor):
         """
-        Takes a cursor, and writes the BigQuery schema for the results to a
-        local file system.
+        Takes a cursor, and writes the BigQuery schema in .json format for the
+        results to a local file system.
 
         :return: A dictionary where key is a filename to be used as an object
             name in GCS, and values are file handles to local files that
             contains the BigQuery schema fields in .json format.
         """
         schema_str = None
+        schema_file_mime_type = 'application/json'
         tmp_schema_file_handle = NamedTemporaryFile(delete=True)
         if self.schema is not None and isinstance(self.schema, string_types):
             schema_str = self.schema
@@ -198,13 +246,18 @@ def _write_local_schema_file(self, cursor):
                     'type': field_type,
                     'mode': field_mode,
                 })
-            schema_str = json.dumps(schema)
+            schema_str = json.dumps(schema, sort_keys=True)
         if PY3:
             schema_str = schema_str.encode('utf-8')
         tmp_schema_file_handle.write(schema_str)
 
         self.log.info('Using schema for %s: %s', self.schema_filename, schema_str)
-        return {self.schema_filename: tmp_schema_file_handle}
+        schema_file_to_upload = {
+            'file_name': self.schema_filename,
+            'file_handle': tmp_schema_file_handle,
+            'file_mime_type': schema_file_mime_type
+        }
+        return schema_file_to_upload
 
     def _upload_to_gcs(self, files_to_upload):
         """
@@ -214,8 +267,10 @@ def _upload_to_gcs(self, files_to_upload):
         hook = GoogleCloudStorageHook(
             google_cloud_storage_conn_id=self.google_cloud_storage_conn_id,
             delegate_to=self.delegate_to)
-        for object, tmp_file_handle in files_to_upload.items():
-            hook.upload(self.bucket, object, tmp_file_handle.name, 'application/json')
+        for tmp_file in files_to_upload:
+            hook.upload(self.bucket, tmp_file.get('file_name'),
+                        tmp_file.get('file_handle').name,
+                        mime_type=tmp_file.get('file_mime_type'))
 
     @staticmethod
     def _convert_types(schema, col_type_dict, row):
diff --git a/tests/contrib/operators/test_mysql_to_gcs_operator.py b/tests/contrib/operators/test_mysql_to_gcs_operator.py
index e33d270032765..94bf25486905e 100644
--- a/tests/contrib/operators/test_mysql_to_gcs_operator.py
+++ b/tests/contrib/operators/test_mysql_to_gcs_operator.py
@@ -17,45 +17,226 @@
 # specific language governing permissions and limitations
 # under the License.
 
+import sys
 import unittest
-import json
-from mock import MagicMock
 
 from airflow.contrib.operators.mysql_to_gcs import \
     MySqlToGoogleCloudStorageOperator
 
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PY3 = sys.version_info[0] == 3
+
+TASK_ID = 'test-mysql-to-gcs'
+MYSQL_CONN_ID = 'mysql_conn_test'
+SQL = 'select 1'
+BUCKET = 'gs://test'
+JSON_FILENAME = 'test_{}.ndjson'
+CSV_FILENAME = 'test_{}.csv'
+
+ROWS = [
+    ('mock_row_content_1', 42),
+    ('mock_row_content_2', 43),
+    ('mock_row_content_3', 44)
+]
+CURSOR_DESCRIPTION = (
+    ('some_str', 0, 0, 0, 0, 0, False),
+    ('some_num', 1005, 0, 0, 0, 0, False)
+)
+NDJSON_LINES = [
+    b'{"some_num": 42, "some_str": "mock_row_content_1"}\n',
+    b'{"some_num": 43, "some_str": "mock_row_content_2"}\n',
+    b'{"some_num": 44, "some_str": "mock_row_content_3"}\n'
+]
+CSV_LINES = [
+    b'some_str,some_num\r\n'
+    b'mock_row_content_1,42\r\n',
+    b'mock_row_content_2,43\r\n',
+    b'mock_row_content_3,44\r\n'
+]
+CSV_LINES_PIPE_DELIMITED = [
+    b'some_str|some_num\r\n'
+    b'mock_row_content_1|42\r\n',
+    b'mock_row_content_2|43\r\n',
+    b'mock_row_content_3|44\r\n'
+]
+SCHEMA_FILENAME = 'schema_test.json'
+SCHEMA_JSON = [
+    b'[{"mode": "REQUIRED", "name": "some_str", "type": "FLOAT"}, ',
+    b'{"mode": "REQUIRED", "name": "some_num", "type": "STRING"}]'
+]
+
 
 class MySqlToGoogleCloudStorageOperatorTest(unittest.TestCase):
 
-    @staticmethod
-    def test_write_local_data_files():
-
-        # Configure
-        task_id = "some_test_id"
-        sql = "some_sql"
-        bucket = "some_bucket"
-        filename = "some_filename"
-        row_iter = [[1, b'byte_str_1'], [2, b'byte_str_2']]
-        schema = [{
-            'name': 'location',
-            'type': 'STRING',
-            'mode': 'nullable',
-        }, {
-            'name': 'uuid',
-            'type': 'BYTES',
-            'mode': 'nullable',
-        }]
-        schema_str = json.dumps(schema)
+    def test_init(self):
+        """Test MySqlToGoogleCloudStorageOperator instance is properly initialized."""
+        op = MySqlToGoogleCloudStorageOperator(
+            task_id=TASK_ID, sql=SQL, bucket=BUCKET, filename=JSON_FILENAME,
+            export_format='CSV', field_delimiter='|')
+        self.assertEqual(op.task_id, TASK_ID)
+        self.assertEqual(op.sql, SQL)
+        self.assertEqual(op.bucket, BUCKET)
+        self.assertEqual(op.filename, JSON_FILENAME)
+        self.assertEqual(op.export_format, 'csv')
+        self.assertEqual(op.field_delimiter, '|')
+
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.MySqlHook')
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.GoogleCloudStorageHook')
+    def test_exec_success_json(self, gcs_hook_mock_class, mysql_hook_mock_class):
+        """Test successful run of execute function for JSON"""
+        op = MySqlToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            mysql_conn_id=MYSQL_CONN_ID,
+            sql=SQL,
+            bucket=BUCKET,
+            filename=JSON_FILENAME)
+
+        mysql_hook_mock = mysql_hook_mock_class.return_value
+        mysql_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
+        mysql_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
+
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+
+        def _assert_upload(bucket, obj, tmp_filename, mime_type=None):
+            self.assertEqual(BUCKET, bucket)
+            self.assertEqual(JSON_FILENAME.format(0), obj)
+            self.assertEqual('application/json', mime_type)
+            with open(tmp_filename, 'rb') as f:
+                self.assertEqual(b''.join(NDJSON_LINES), f.read())
+
+        gcs_hook_mock.upload.side_effect = _assert_upload
+
+        op.execute(None)
+
+        mysql_hook_mock_class.assert_called_once_with(mysql_conn_id=MYSQL_CONN_ID)
+        mysql_hook_mock.get_conn().cursor().execute.assert_called_once_with(SQL)
+
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.MySqlHook')
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.GoogleCloudStorageHook')
+    def test_exec_success_csv(self, gcs_hook_mock_class, mysql_hook_mock_class):
+        """Test successful run of execute function for CSV"""
+        op = MySqlToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            mysql_conn_id=MYSQL_CONN_ID,
+            sql=SQL,
+            export_format='CSV',
+            bucket=BUCKET,
+            filename=CSV_FILENAME)
+
+        mysql_hook_mock = mysql_hook_mock_class.return_value
+        mysql_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
+        mysql_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
+
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+
+        def _assert_upload(bucket, obj, tmp_filename, mime_type=None):
+            self.assertEqual(BUCKET, bucket)
+            self.assertEqual(CSV_FILENAME.format(0), obj)
+            self.assertEqual('text/csv', mime_type)
+            with open(tmp_filename, 'rb') as f:
+                self.assertEqual(b''.join(CSV_LINES), f.read())
+
+        gcs_hook_mock.upload.side_effect = _assert_upload
 
+        op.execute(None)
+
+        mysql_hook_mock_class.assert_called_once_with(mysql_conn_id=MYSQL_CONN_ID)
+        mysql_hook_mock.get_conn().cursor().execute.assert_called_once_with(SQL)
+
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.MySqlHook')
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.GoogleCloudStorageHook')
+    def test_exec_success_csv_with_delimiter(self, gcs_hook_mock_class, mysql_hook_mock_class):
+        """Test successful run of execute function for CSV with a field delimiter"""
         op = MySqlToGoogleCloudStorageOperator(
-            task_id=task_id,
-            sql=sql,
-            bucket=bucket,
-            filename=filename,
-            schema=schema_str)
+            task_id=TASK_ID,
+            mysql_conn_id=MYSQL_CONN_ID,
+            sql=SQL,
+            export_format='csv',
+            field_delimiter='|',
+            bucket=BUCKET,
+            filename=CSV_FILENAME)
+
+        mysql_hook_mock = mysql_hook_mock_class.return_value
+        mysql_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
+        mysql_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
+
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+
+        def _assert_upload(bucket, obj, tmp_filename, mime_type=None):
+            self.assertEqual(BUCKET, bucket)
+            self.assertEqual(CSV_FILENAME.format(0), obj)
+            self.assertEqual('text/csv', mime_type)
+            with open(tmp_filename, 'rb') as f:
+                self.assertEqual(b''.join(CSV_LINES_PIPE_DELIMITED), f.read())
+
+        gcs_hook_mock.upload.side_effect = _assert_upload
+
+        op.execute(None)
+
+        mysql_hook_mock_class.assert_called_once_with(mysql_conn_id=MYSQL_CONN_ID)
+        mysql_hook_mock.get_conn().cursor().execute.assert_called_once_with(SQL)
+
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.MySqlHook')
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.GoogleCloudStorageHook')
+    def test_file_splitting(self, gcs_hook_mock_class, mysql_hook_mock_class):
+        """Test that ndjson is split by approx_max_file_size_bytes param."""
+        mysql_hook_mock = mysql_hook_mock_class.return_value
+        mysql_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
+        mysql_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
+
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+        expected_upload = {
+            JSON_FILENAME.format(0): b''.join(NDJSON_LINES[:2]),
+            JSON_FILENAME.format(1): NDJSON_LINES[2],
+        }
 
-        cursor_mock = MagicMock()
-        cursor_mock.__iter__.return_value = row_iter
+        def _assert_upload(bucket, obj, tmp_filename, mime_type=None):
+            self.assertEqual(BUCKET, bucket)
+            self.assertEqual('application/json', mime_type)
+            with open(tmp_filename, 'rb') as f:
+                self.assertEqual(expected_upload[obj], f.read())
+
+        gcs_hook_mock.upload.side_effect = _assert_upload
+
+        op = MySqlToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            sql=SQL,
+            bucket=BUCKET,
+            filename=JSON_FILENAME,
+            approx_max_file_size_bytes=len(expected_upload[JSON_FILENAME.format(0)]))
+        op.execute(None)
+
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.MySqlHook')
+    @mock.patch('airflow.contrib.operators.mysql_to_gcs.GoogleCloudStorageHook')
+    def test_schema_file(self, gcs_hook_mock_class, mysql_hook_mock_class):
+        """Test writing schema files."""
+        mysql_hook_mock = mysql_hook_mock_class.return_value
+        mysql_hook_mock.get_conn().cursor().__iter__.return_value = iter(ROWS)
+        mysql_hook_mock.get_conn().cursor().description = CURSOR_DESCRIPTION
+
+        gcs_hook_mock = gcs_hook_mock_class.return_value
+
+        def _assert_upload(bucket, obj, tmp_filename, mime_type):
+            if obj == SCHEMA_FILENAME:
+                with open(tmp_filename, 'rb') as f:
+                    self.assertEqual(b''.join(SCHEMA_JSON), f.read())
+
+        gcs_hook_mock.upload.side_effect = _assert_upload
+
+        op = MySqlToGoogleCloudStorageOperator(
+            task_id=TASK_ID,
+            sql=SQL,
+            bucket=BUCKET,
+            filename=JSON_FILENAME,
+            schema_filename=SCHEMA_FILENAME)
+        op.execute(None)
 
-        # Run
-        op._write_local_data_files(cursor_mock)
+        # once for the file and once for the schema
+        self.assertEqual(2, gcs_hook_mock.upload.call_count)

From d529da5148cd84cfb82fe11093d3e20a8f8ca50b Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 18 Jan 2019 01:36:35 +0800
Subject: [PATCH 657/808] [AIRFLOW-2843] Add flag in ExternalTaskSensor to
 check if external DAG/task exists (#4547)

In ExternalTaskSensor, it may be good to provide
an option to cease waiting immediately if the external
DAG/task specified doesn't exist.

To provide an argument "check_existence". Set to True to check
if the external DAG/task exists, and immediately cease waiting
if the external DAG/task does not exist.

The default value is set to False (no check or ceasing
will happen) so it will not affect any existing DAGs or
current user expectation.
---
 airflow/sensors/external_task_sensor.py    | 41 +++++++++++++++++++---
 tests/sensors/test_external_task_sensor.py | 34 +++++++++++++++++-
 2 files changed, 69 insertions(+), 6 deletions(-)

diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index 0bb62d42b7f34..96e5fd8aeb15a 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -17,7 +17,10 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from airflow.models import TaskInstance, DagRun
+import os
+
+from airflow.exceptions import AirflowException
+from airflow.models import TaskInstance, DagBag, DagModel, DagRun
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.utils.db import provide_session
 from airflow.utils.decorators import apply_defaults
@@ -26,7 +29,8 @@
 
 class ExternalTaskSensor(BaseSensorOperator):
     """
-    Waits for a different DAG or a task in in a different DAG to complete
+    Waits for a different DAG or a task in a different DAG to complete for a
+    specific execution_date
 
     :param external_dag_id: The dag_id that contains the task you want to
         wait for
@@ -46,6 +50,11 @@ class ExternalTaskSensor(BaseSensorOperator):
         and returns the desired execution dates to query. Either execution_delta
         or execution_date_fn can be passed to ExternalTaskSensor, but not both.
     :type execution_date_fn: callable
+    :param check_existence: Set to `True` to check if the external task exists (when
+        external_task_id is not None) or check if the DAG to wait for exists (when
+        external_task_id is None), and immediately cease waiting if the external task
+        or DAG does not exist (default value: False).
+    :type check_existence: bool
     """
     template_fields = ['external_dag_id', 'external_task_id']
     ui_color = '#19647e'
@@ -57,6 +66,7 @@ def __init__(self,
                  allowed_states=None,
                  execution_delta=None,
                  execution_date_fn=None,
+                 check_existence=False,
                  *args,
                  **kwargs):
         super(ExternalTaskSensor, self).__init__(*args, **kwargs)
@@ -83,6 +93,7 @@ def __init__(self,
         self.execution_date_fn = execution_date_fn
         self.external_dag_id = external_dag_id
         self.external_task_id = external_task_id
+        self.check_existence = check_existence
 
     @provide_session
     def poke(self, context, session=None):
@@ -103,9 +114,30 @@ def poke(self, context, session=None):
             '{self.external_task_id} on '
             '{} ... '.format(serialized_dttm_filter, **locals()))
 
-        if self.external_task_id:
-            TI = TaskInstance
+        DM = DagModel
+        TI = TaskInstance
+        DR = DagRun
+        if self.check_existence:
+            dag_to_wait = session.query(DM).filter(
+                DM.dag_id == self.external_dag_id
+            ).first()
+
+            if not dag_to_wait:
+                raise AirflowException('The external DAG '
+                                       '{} does not exist.'.format(self.external_dag_id))
+            else:
+                if not os.path.exists(dag_to_wait.fileloc):
+                    raise AirflowException('The external DAG '
+                                           '{} was deleted.'.format(self.external_dag_id))
 
+            if self.external_task_id:
+                refreshed_dag_info = DagBag(dag_to_wait.fileloc).get_dag(self.external_dag_id)
+                if not refreshed_dag_info.has_task(self.external_task_id):
+                    raise AirflowException('The external task'
+                                           '{} in DAG {} does not exist.'.format(self.external_task_id,
+                                                                                 self.external_dag_id))
+
+        if self.external_task_id:
             count = session.query(TI).filter(
                 TI.dag_id == self.external_dag_id,
                 TI.task_id == self.external_task_id,
@@ -113,7 +145,6 @@ def poke(self, context, session=None):
                 TI.execution_date.in_(dttm_filter),
             ).count()
         else:
-            DR = DagRun
             count = session.query(DR).filter(
                 DR.dag_id == self.external_dag_id,
                 DR.state.in_(self.allowed_states),
diff --git a/tests/sensors/test_external_task_sensor.py b/tests/sensors/test_external_task_sensor.py
index cf156990b8ef0..18fff556bf035 100644
--- a/tests/sensors/test_external_task_sensor.py
+++ b/tests/sensors/test_external_task_sensor.py
@@ -21,7 +21,7 @@
 
 from airflow import DAG, configuration, settings
 from airflow import exceptions
-from airflow.exceptions import AirflowSensorTimeout
+from airflow.exceptions import AirflowException, AirflowSensorTimeout
 from airflow.models import TaskInstance, DagBag
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
@@ -289,3 +289,35 @@ def test_catch_invalid_allowed_states(self):
                 allowed_states=['invalid_state'],
                 dag=self.dag
             )
+
+    def test_external_task_sensor_waits_for_task_check_existence(self):
+        t = ExternalTaskSensor(
+            task_id='test_external_task_sensor_check',
+            external_dag_id="example_bash_operator",
+            external_task_id="non-existing-task",
+            check_existence=True,
+            dag=self.dag
+        )
+
+        with self.assertRaises(AirflowException):
+            t.run(
+                start_date=DEFAULT_DATE,
+                end_date=DEFAULT_DATE,
+                ignore_ti_state=True
+            )
+
+    def test_external_task_sensor_waits_for_dag_check_existence(self):
+        t = ExternalTaskSensor(
+            task_id='test_external_task_sensor_check',
+            external_dag_id="non-existing-dag",
+            external_task_id=None,
+            check_existence=True,
+            dag=self.dag
+        )
+
+        with self.assertRaises(AirflowException):
+            t.run(
+                start_date=DEFAULT_DATE,
+                end_date=DEFAULT_DATE,
+                ignore_ti_state=True
+            )

From 12a2e55c665bacfe59bc8aa3326783b8981e0161 Mon Sep 17 00:00:00 2001
From: johnhofman <johncarlhofman@gmail.com>
Date: Tue, 20 Nov 2018 11:13:53 +0100
Subject: [PATCH 658/808] [AIRFLOW-2966] Catch ApiException in the Kubernetes
 Executor (#4209)

Creating a pod that exceeds a namespace's resource quota throws an
ApiException. This change catches the exception and the task is
re-queued inside the Executor instead of killing the scheduler.
---
 airflow/config_templates/default_test.cfg     |  3 +
 .../contrib/executors/kubernetes_executor.py  | 10 +++-
 .../executors/test_kubernetes_executor.py     | 60 +++++++++++++++++++
 3 files changed, 71 insertions(+), 2 deletions(-)

diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index 4a72190bb1ee6..4b1b84f5e9f93 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -126,3 +126,6 @@ hide_sensitive_variable_fields = True
 elasticsearch_host =
 elasticsearch_log_id_template = {{dag_id}}-{{task_id}}-{{execution_date}}-{{try_number}}
 elasticsearch_end_of_log_mark = end_of_log
+
+[kubernetes]
+dags_volume_claim = default
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 1a4faa1ab78d2..4d9251d2fade1 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -651,8 +651,14 @@ def sync(self):
         KubeResourceVersion.checkpoint_resource_version(last_resource_version)
 
         if not self.task_queue.empty():
-            key, command, kube_executor_config = self.task_queue.get()
-            self.kube_scheduler.run_next((key, command, kube_executor_config))
+            task = self.task_queue.get()
+
+            try:
+                self.kube_scheduler.run_next(task)
+            except ApiException:
+                self.log.exception('ApiException when attempting ' +
+                                   'to run task, re-queueing.')
+                self.task_queue.put(task)
 
     def _change_state(self, key, state, pod_id):
         if state != State.RUNNING:
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 48ed69abd3bcf..7c83eb45cb222 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -24,10 +24,13 @@
 import re
 import string
 import random
+from urllib3 import HTTPResponse
 from datetime import datetime
 
 try:
+    from kubernetes.client.rest import ApiException
     from airflow.contrib.executors.kubernetes_executor import AirflowKubernetesScheduler
+    from airflow.contrib.executors.kubernetes_executor import KubernetesExecutor
     from airflow.contrib.executors.kubernetes_executor import KubernetesExecutorConfig
     from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
 except ImportError:
@@ -371,5 +374,62 @@ def test_kubernetes_environment_variables(self):
         self.assertEqual(env[core_executor], 'LocalExecutor')
 
 
+class TestKubernetesExecutor(unittest.TestCase):
+    """
+    Tests if an ApiException from the Kube Client will cause the task to
+    be rescheduled.
+    """
+    @unittest.skipIf(AirflowKubernetesScheduler is None,
+                     'kubernetes python package is not installed')
+    @mock.patch('airflow.contrib.executors.kubernetes_executor.KubernetesJobWatcher')
+    @mock.patch('airflow.contrib.executors.kubernetes_executor.get_kube_client')
+    def test_run_next_exception(self, mock_get_kube_client, mock_kubernetes_job_watcher):
+
+        # When a quota is exceeded this is the ApiException we get
+        r = HTTPResponse()
+        r.body = {
+            "kind": "Status",
+            "apiVersion": "v1",
+            "metadata": {},
+            "status": "Failure",
+            "message": "pods \"podname\" is forbidden: " +
+            "exceeded quota: compute-resources, " +
+            "requested: limits.memory=4Gi, " +
+            "used: limits.memory=6508Mi, " +
+            "limited: limits.memory=10Gi",
+            "reason": "Forbidden",
+            "details": {"name": "podname", "kind": "pods"},
+            "code": 403},
+        r.status = 403
+        r.reason = "Forbidden"
+
+        # A mock kube_client that throws errors when making a pod
+        mock_kube_client = mock.patch('kubernetes.client.CoreV1Api', autospec=True)
+        mock_kube_client.create_namespaced_pod = mock.MagicMock(
+            side_effect=ApiException(http_resp=r))
+        mock_get_kube_client.return_value = mock_kube_client
+
+        kubernetesExecutor = KubernetesExecutor()
+        kubernetesExecutor.start()
+
+        # Execute a task while the Api Throws errors
+        try_number = 1
+        kubernetesExecutor.execute_async(key=('dag', 'task', datetime.utcnow(), try_number),
+                                         command='command', executor_config={})
+        kubernetesExecutor.sync()
+        kubernetesExecutor.sync()
+
+        mock_kube_client.create_namespaced_pod.assert_called()
+        self.assertFalse(kubernetesExecutor.task_queue.empty())
+
+        # Disable the ApiException
+        mock_kube_client.create_namespaced_pod.side_effect = None
+
+        # Execute the task without errors should empty the queue
+        kubernetesExecutor.sync()
+        mock_kube_client.create_namespaced_pod.assert_called()
+        self.assertTrue(kubernetesExecutor.task_queue.empty())
+
+
 if __name__ == '__main__':
     unittest.main()

From ecba1527b8884b51e340e8bd9834f60a23fc3d83 Mon Sep 17 00:00:00 2001
From: raman <ramandumcs@gmail.com>
Date: Wed, 16 Jan 2019 05:51:06 +0530
Subject: [PATCH 659/808] [AIRFLOW-3516] Support to create k8 worker pods in
 batches (#4434)

---
 airflow/config_templates/default_airflow.cfg     | 3 +++
 airflow/contrib/executors/kubernetes_executor.py | 5 +++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 707c45d3e316d..459713526230f 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -610,6 +610,9 @@ worker_container_image_pull_policy = IfNotPresent
 # If True (default), worker pods will be deleted upon termination
 delete_worker_pods = True
 
+# Number of Kubernetes Worker Pod creation calls per scheduler loop
+worker_pods_creation_batch_size = 1
+
 # The Kubernetes namespace where airflow workers should be created. Defaults to `default`
 namespace = default
 
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 4d9251d2fade1..afbb592021d0b 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -138,7 +138,8 @@ def __init__(self):
         self.kube_annotations = configuration_dict.get('kubernetes_annotations', {})
         self.delete_worker_pods = conf.getboolean(
             self.kubernetes_section, 'delete_worker_pods')
-
+        self.worker_pods_creation_batch_size = conf.getint(
+            self.kubernetes_section, 'worker_pods_creation_batch_size')
         self.worker_service_account_name = conf.get(
             self.kubernetes_section, 'worker_service_account_name')
         self.image_pull_secrets = conf.get(self.kubernetes_section, 'image_pull_secrets')
@@ -650,7 +651,7 @@ def sync(self):
 
         KubeResourceVersion.checkpoint_resource_version(last_resource_version)
 
-        if not self.task_queue.empty():
+        for i in range(min((self.kube_config.worker_pods_creation_batch_size, self.task_queue.qsize()))):
             task = self.task_queue.get()
 
             try:

From 119a93c4e2d02588f2000015c2f771809ee8d4bf Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Thu, 21 Feb 2019 11:49:38 -0800
Subject: [PATCH 660/808] [AIRFLOW-3153] Send DAG processing stats to statsd
 (#4748)

Add 2 stats under the `airflow.dag_processing` namespace. The metric
names follow the template: `dag_processing.<metric>.<dag_file>`, where
`<dag_file>` is the name of a file in the dag_folder (without the
extension) and `<metric>` is one of the following:

- `last_runtime`: the number of seconds it took to process the DAG file
  on the most recent iteration
- `last_run.seconds_ago`: the number of seconds that have elapsed since
  the DAG file was last processed

I've verified the logging by running the scheduler on the examples DAGs
and logging the value of the gauges with netcat:

    $ nc -u -l -p 8125 | tr '|' '\n' | grep dag_processing
      gairflow.dag_processing.last_runtime.example_docker_operator:2.002253
      gairflow.dag_processing.last_run.seconds_ago.example_docker_operator:18.066831
      gairflow.dag_processing.last_runtime.tutorial:2.001403
      gairflow.dag_processing.last_run.seconds_ago.tutorial:36.114995
      gairflow.dag_processing.last_runtime.docker_copy_data:2.003188
      gairflow.dag_processing.last_run.seconds_ago.docker_copy_data:28.097275
---
 airflow/utils/dag_processing.py | 16 +++++++++++++++-
 docs/metrics.rst                | 16 +++++++++-------
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index aceaec1598266..6264fc4939a8e 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -46,7 +46,7 @@
 from airflow import configuration as conf
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.exceptions import AirflowException
-from airflow.settings import logging_class_path
+from airflow.settings import logging_class_path, Stats
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -965,11 +965,25 @@ def _log_file_processing_stats(self, known_file_paths):
         rows = []
         for file_path in known_file_paths:
             last_runtime = self.get_last_runtime(file_path)
+            file_name = os.path.basename(file_path)
+            file_name = os.path.splitext(file_name)[0].replace(os.sep, '.')
+            if last_runtime:
+                Stats.gauge(
+                    'dag_processing.last_runtime.{}'.format(file_name),
+                    last_runtime
+                )
+
             processor_pid = self.get_pid(file_path)
             processor_start_time = self.get_start_time(file_path)
             runtime = ((timezone.utcnow() - processor_start_time).total_seconds()
                        if processor_start_time else None)
             last_run = self.get_last_finish_time(file_path)
+            if last_run:
+                seconds_ago = (timezone.utcnow() - last_run).total_seconds()
+                Stats.gauge(
+                    'dag_processing.last_run.seconds_ago.{}'.format(file_name),
+                    seconds_ago
+                )
 
             rows.append((file_path,
                          processor_pid,
diff --git a/docs/metrics.rst b/docs/metrics.rst
index 29819c03e6ebe..0bd70fce32a61 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -49,13 +49,15 @@ scheduler_heartbeat                 Scheduler heartbeats
 Gauges
 ------
 
-===================== =====================================
-Name                  Description
-===================== =====================================
-collect_dags          Seconds taken to scan and import DAGs
-dagbag_import_errors  DAG import errors
-dagbag_size           DAG bag size
-===================== =====================================
+=============================================== ========================================================================
+Name                                            Description
+=============================================== ========================================================================
+collect_dags                                    Seconds taken to scan and import DAGs
+dagbag_import_errors                            DAG import errors
+dagbag_size                                     DAG bag size
+dag_processing.last_runtime.<dag_file>          Seconds spent processing <dag_file> (in most recent iteration)
+dag_processing.last_run.seconds_ago.<dag_file>  Seconds since <dag_file> was last processed
+=============================================== ========================================================================
 
 Timers
 ------

From 1045a46b1b831d6c0058f79c3c1332ff6e62f08c Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Thu, 21 Mar 2019 14:57:49 +0000
Subject: [PATCH 661/808] [AIRFLOW-4015] Make missing API endpoints available
 in classic mode

---
 airflow/www/api/experimental/endpoints.py    | 62 ++++++++++++++++++++
 tests/www/api/experimental/test_endpoints.py | 60 +++++++++++++++++++
 2 files changed, 122 insertions(+)

diff --git a/airflow/www/api/experimental/endpoints.py b/airflow/www/api/experimental/endpoints.py
index ab434b2ab9b30..565d485edd48c 100644
--- a/airflow/www/api/experimental/endpoints.py
+++ b/airflow/www/api/experimental/endpoints.py
@@ -27,10 +27,13 @@
 from airflow.api.common.experimental.get_dag_runs import get_dag_runs
 from airflow.api.common.experimental.get_task import get_task
 from airflow.api.common.experimental.get_task_instance import get_task_instance
+from airflow.api.common.experimental.get_dag_run_state import get_dag_run_state
 from airflow.exceptions import AirflowException
 from airflow.utils import timezone
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.www.app import csrf
+from airflow import models
+from airflow.utils.db import create_session
 
 _log = LoggingMixin().log
 
@@ -154,6 +157,28 @@ def task_info(dag_id, task_id):
     return jsonify(fields)
 
 
+# ToDo: Shouldn't this be a PUT method?
+@api_experimental.route('/dags/<string:dag_id>/paused/<string:paused>', methods=['GET'])
+@requires_authentication
+def dag_paused(dag_id, paused):
+    """(Un)pauses a dag"""
+
+    DagModel = models.DagModel
+    with create_session() as session:
+        orm_dag = (
+            session.query(DagModel)
+                   .filter(DagModel.dag_id == dag_id).first()
+        )
+        if paused == 'true':
+            orm_dag.is_paused = True
+        else:
+            orm_dag.is_paused = False
+        session.merge(orm_dag)
+        session.commit()
+
+    return jsonify({'response': 'ok'})
+
+
 @api_experimental.route(
     '/dags/<string:dag_id>/dag_runs/<string:execution_date>/tasks/<string:task_id>',
     methods=['GET'])
@@ -195,6 +220,43 @@ def task_instance_info(dag_id, execution_date, task_id):
     return jsonify(fields)
 
 
+@api_experimental.route(
+    '/dags/<string:dag_id>/dag_runs/<string:execution_date>',
+    methods=['GET'])
+@requires_authentication
+def dag_run_status(dag_id, execution_date):
+    """
+    Returns a JSON with a dag_run's public instance variables.
+    The format for the exec_date is expected to be
+    "YYYY-mm-DDTHH:MM:SS", for example: "2016-11-16T11:34:15". This will
+    of course need to have been encoded for URL in the request.
+    """
+
+    # Convert string datetime into actual datetime
+    try:
+        execution_date = timezone.parse(execution_date)
+    except ValueError:
+        error_message = (
+            'Given execution date, {}, could not be identified '
+            'as a date. Example date format: 2015-11-16T14:34:15+00:00'.format(
+                execution_date))
+        _log.info(error_message)
+        response = jsonify({'error': error_message})
+        response.status_code = 400
+
+        return response
+
+    try:
+        info = get_dag_run_state(dag_id, execution_date)
+    except AirflowException as err:
+        _log.info(err)
+        response = jsonify(error="{}".format(err))
+        response.status_code = err.status_code
+        return response
+
+    return jsonify(info)
+
+
 @api_experimental.route('/latest_runs', methods=['GET'])
 @requires_authentication
 def latest_dag_runs():
diff --git a/tests/www/api/experimental/test_endpoints.py b/tests/www/api/experimental/test_endpoints.py
index 187ca921d59d8..58d1a9eb3b8f1 100644
--- a/tests/www/api/experimental/test_endpoints.py
+++ b/tests/www/api/experimental/test_endpoints.py
@@ -77,6 +77,23 @@ def test_task_info(self):
         self.assertIn('error', response.data.decode('utf-8'))
         self.assertEqual(404, response.status_code)
 
+    def test_task_paused(self):
+        url_template = '/api/experimental/dags/{}/paused/{}'
+
+        response = self.app.get(
+            url_template.format('example_bash_operator', 'true')
+        )
+        self.assertIn('ok', response.data.decode('utf-8'))
+        self.assertEqual(200, response.status_code)
+
+        url_template = '/api/experimental/dags/{}/paused/{}'
+
+        response = self.app.get(
+            url_template.format('example_bash_operator', 'false')
+        )
+        self.assertIn('ok', response.data.decode('utf-8'))
+        self.assertEqual(200, response.status_code)
+
     def test_trigger_dag(self):
         url_template = '/api/experimental/dags/{}/dag_runs'
         response = self.app.post(
@@ -207,6 +224,49 @@ def test_task_instance_info(self):
         self.assertEqual(400, response.status_code)
         self.assertIn('error', response.data.decode('utf-8'))
 
+    def test_dagrun_status(self):
+        url_template = '/api/experimental/dags/{}/dag_runs/{}'
+        dag_id = 'example_bash_operator'
+        execution_date = utcnow().replace(microsecond=0)
+        datetime_string = quote_plus(execution_date.isoformat())
+        wrong_datetime_string = quote_plus(
+            datetime(1990, 1, 1, 1, 1, 1).isoformat()
+        )
+
+        # Create DagRun
+        trigger_dag(dag_id=dag_id,
+                    run_id='test_task_instance_info_run',
+                    execution_date=execution_date)
+
+        # Test Correct execution
+        response = self.app.get(
+            url_template.format(dag_id, datetime_string)
+        )
+        self.assertEqual(200, response.status_code)
+        self.assertIn('state', response.data.decode('utf-8'))
+        self.assertNotIn('error', response.data.decode('utf-8'))
+
+        # Test error for nonexistent dag
+        response = self.app.get(
+            url_template.format('does_not_exist_dag', datetime_string),
+        )
+        self.assertEqual(404, response.status_code)
+        self.assertIn('error', response.data.decode('utf-8'))
+
+        # Test error for nonexistent dag run (wrong execution_date)
+        response = self.app.get(
+            url_template.format(dag_id, wrong_datetime_string)
+        )
+        self.assertEqual(404, response.status_code)
+        self.assertIn('error', response.data.decode('utf-8'))
+
+        # Test error for bad datetime format
+        response = self.app.get(
+            url_template.format(dag_id, 'not_a_datetime')
+        )
+        self.assertEqual(400, response.status_code)
+        self.assertIn('error', response.data.decode('utf-8'))
+
 
 class TestPoolApiExperimental(unittest.TestCase):
 

From c316e2e146012390232259660746f752153b8885 Mon Sep 17 00:00:00 2001
From: raman <ramandumcs@gmail.com>
Date: Thu, 21 Feb 2019 15:37:12 +0530
Subject: [PATCH 662/808] [AIRFLOW-3865] Add API endpoint to get python code of
 dag by id (#4687)

---
 airflow/api/common/experimental/get_code.py   | 42 +++++++++++++++++++
 airflow/www/api/experimental/endpoints.py     | 14 +++++++
 .../www_rbac/api/experimental/endpoints.py    | 14 +++++++
 tests/www/api/experimental/test_endpoints.py  | 14 +++++++
 .../api/experimental/test_endpoints.py        | 14 +++++++
 5 files changed, 98 insertions(+)
 create mode 100644 airflow/api/common/experimental/get_code.py

diff --git a/airflow/api/common/experimental/get_code.py b/airflow/api/common/experimental/get_code.py
new file mode 100644
index 0000000000000..f082cb03837da
--- /dev/null
+++ b/airflow/api/common/experimental/get_code.py
@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.exceptions import AirflowException, DagNotFound
+from airflow import models, settings
+from airflow.www import utils as wwwutils
+
+
+def get_code(dag_id):
+    """Return python code of a given dag_id."""
+    session = settings.Session()
+    DM = models.DagModel
+    dag = session.query(DM).filter(DM.dag_id == dag_id).first()
+    session.close()
+    # Check DAG exists.
+    if dag is None:
+        error_message = "Dag id {} not found".format(dag_id)
+        raise DagNotFound(error_message)
+
+    try:
+        with wwwutils.open_maybe_zipped(dag.fileloc, 'r') as f:
+            code = f.read()
+            return code
+    except IOError as e:
+        error_message = "Error {} while reading Dag id {} Code".format(str(e), dag_id)
+        raise AirflowException(error_message)
diff --git a/airflow/www/api/experimental/endpoints.py b/airflow/www/api/experimental/endpoints.py
index 565d485edd48c..abcea15e3019a 100644
--- a/airflow/www/api/experimental/endpoints.py
+++ b/airflow/www/api/experimental/endpoints.py
@@ -27,6 +27,7 @@
 from airflow.api.common.experimental.get_dag_runs import get_dag_runs
 from airflow.api.common.experimental.get_task import get_task
 from airflow.api.common.experimental.get_task_instance import get_task_instance
+from airflow.api.common.experimental.get_code import get_code
 from airflow.api.common.experimental.get_dag_run_state import get_dag_run_state
 from airflow.exceptions import AirflowException
 from airflow.utils import timezone
@@ -138,6 +139,19 @@ def test():
     return jsonify(status='OK')
 
 
+@api_experimental.route('/dags/<string:dag_id>/code', methods=['GET'])
+@requires_authentication
+def get_dag_code(dag_id):
+    """Return python code of a given dag_id."""
+    try:
+        return get_code(dag_id)
+    except AirflowException as err:
+        _log.info(err)
+        response = jsonify(error="{}".format(err))
+        response.status_code = err.status_code
+        return response
+
+
 @api_experimental.route('/dags/<string:dag_id>/tasks/<string:task_id>', methods=['GET'])
 @requires_authentication
 def task_info(dag_id, task_id):
diff --git a/airflow/www_rbac/api/experimental/endpoints.py b/airflow/www_rbac/api/experimental/endpoints.py
index 21aa7e8a1a60b..637d3ef53d55a 100644
--- a/airflow/www_rbac/api/experimental/endpoints.py
+++ b/airflow/www_rbac/api/experimental/endpoints.py
@@ -23,6 +23,7 @@
 from airflow.api.common.experimental.get_dag_runs import get_dag_runs
 from airflow.api.common.experimental.get_task import get_task
 from airflow.api.common.experimental.get_task_instance import get_task_instance
+from airflow.api.common.experimental.get_code import get_code
 from airflow.api.common.experimental.get_dag_run_state import get_dag_run_state
 from airflow.exceptions import AirflowException
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -119,6 +120,19 @@ def test():
     return jsonify(status='OK')
 
 
+@api_experimental.route('/dags/<string:dag_id>/code', methods=['GET'])
+@requires_authentication
+def get_dag_code(dag_id):
+    """Return python code of a given dag_id."""
+    try:
+        return get_code(dag_id)
+    except AirflowException as err:
+        _log.info(err)
+        response = jsonify(error="{}".format(err))
+        response.status_code = err.status_code
+        return response
+
+
 @api_experimental.route('/dags/<string:dag_id>/tasks/<string:task_id>', methods=['GET'])
 @requires_authentication
 def task_info(dag_id, task_id):
diff --git a/tests/www/api/experimental/test_endpoints.py b/tests/www/api/experimental/test_endpoints.py
index 58d1a9eb3b8f1..14f0e73cb32ed 100644
--- a/tests/www/api/experimental/test_endpoints.py
+++ b/tests/www/api/experimental/test_endpoints.py
@@ -77,6 +77,20 @@ def test_task_info(self):
         self.assertIn('error', response.data.decode('utf-8'))
         self.assertEqual(404, response.status_code)
 
+    def test_get_dag_code(self):
+        url_template = '/api/experimental/dags/{}/code'
+
+        response = self.app.get(
+            url_template.format('example_bash_operator')
+        )
+        self.assertIn('BashOperator(', response.data.decode('utf-8'))
+        self.assertEqual(200, response.status_code)
+
+        response = self.app.get(
+            url_template.format('xyz')
+        )
+        self.assertEqual(404, response.status_code)
+
     def test_task_paused(self):
         url_template = '/api/experimental/dags/{}/paused/{}'
 
diff --git a/tests/www_rbac/api/experimental/test_endpoints.py b/tests/www_rbac/api/experimental/test_endpoints.py
index 059ae0eabb888..6f902cc4fd34c 100644
--- a/tests/www_rbac/api/experimental/test_endpoints.py
+++ b/tests/www_rbac/api/experimental/test_endpoints.py
@@ -89,6 +89,20 @@ def test_task_info(self):
         self.assertIn('error', response.data.decode('utf-8'))
         self.assertEqual(404, response.status_code)
 
+    def test_get_dag_code(self):
+        url_template = '/api/experimental/dags/{}/code'
+
+        response = self.client.get(
+            url_template.format('example_bash_operator')
+        )
+        self.assertIn('BashOperator(', response.data.decode('utf-8'))
+        self.assertEqual(200, response.status_code)
+
+        response = self.client.get(
+            url_template.format('xyz')
+        )
+        self.assertEqual(404, response.status_code)
+
     def test_task_paused(self):
         url_template = '/api/experimental/dags/{}/paused/{}'
 

From 27be6326fa974d547dfaf30c58fb5888c79577d6 Mon Sep 17 00:00:00 2001
From: Hengfeng Li <hengf.li@gmail.com>
Date: Sat, 9 Mar 2019 17:20:37 +1100
Subject: [PATCH 663/808] [AIRFLOW-4044] The documentation of `query_params` in
 `BigQueryOperator` is wrong.  (#4876)

* Updated the documentation of `query_params` in BigQueryOperator.

* Removed trailing whitespaces.
---
 airflow/contrib/operators/bigquery_operator.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index ebc063bb0fc64..b6e1e1a471036 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -85,9 +85,13 @@ class BigQueryOperator(BaseOperator):
     :param schema_update_options: Allows the schema of the destination
         table to be updated as a side effect of the load job.
     :type schema_update_options: tuple
-    :param query_params: a dictionary containing query parameter types and
-        values, passed to BigQuery.
-    :type query_params: dict
+    :param query_params: a list of dictionary containing query parameter types and
+        values, passed to BigQuery. The structure of dictionary should look like
+        'queryParameters' in Google BigQuery Jobs API:
+        https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs.
+        For example, [{ 'name': 'corpus', 'parameterType': { 'type': 'STRING' },
+        'parameterValue': { 'value': 'romeoandjuliet' } }].
+    :type query_params: list
     :param labels: a dictionary containing labels for the job/query,
         passed to BigQuery
     :type labels: dict

From 25a1f3a8d8adc7508b25c9ad7d884bb1e326de33 Mon Sep 17 00:00:00 2001
From: hixus <1814734+hixus@users.noreply.github.com>
Date: Sat, 9 Mar 2019 15:25:13 +0200
Subject: [PATCH 664/808] [AIRFLOW-4037] Log response in SimpleHttpOperator
 even if the response check fails

---
 airflow/operators/http_operator.py    |  4 ++--
 tests/operators/test_http_operator.py | 26 ++++++++++++++++++++++++++
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/airflow/operators/http_operator.py b/airflow/operators/http_operator.py
index 3e00de96ebf4c..f3ae33547d079 100644
--- a/airflow/operators/http_operator.py
+++ b/airflow/operators/http_operator.py
@@ -92,10 +92,10 @@ def execute(self, context):
                             self.data,
                             self.headers,
                             self.extra_options)
+        if self.log_response:
+            self.log.info(response.text)
         if self.response_check:
             if not self.response_check(response):
                 raise AirflowException("Response check returned False.")
         if self.xcom_push_flag:
             return response.text
-        if self.log_response:
-            self.log.info(response.text)
diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
index e6033155e9b46..29bab1005a184 100644
--- a/tests/operators/test_http_operator.py
+++ b/tests/operators/test_http_operator.py
@@ -22,6 +22,8 @@
 
 import requests_mock
 from airflow.operators.http_operator import SimpleHttpOperator
+from airflow.exceptions import AirflowException
+
 
 try:
     from unittest import mock
@@ -52,3 +54,27 @@ def test_response_in_logs(self, m):
         with mock.patch.object(operator.log, 'info') as mock_info:
             operator.execute(None)
             mock_info.assert_called_with('Example.com fake response')
+
+    @requests_mock.mock()
+    def test_response_in_logs_after_failed_check(self, m):
+        """
+        Test that when using SimpleHttpOperator with log_response=True,
+        the reponse is logged even if request_check fails
+        """
+
+        def response_check(response):
+            return response.text != 'invalid response'
+
+        m.get('http://www.example.com', text='invalid response')
+        operator = SimpleHttpOperator(
+            task_id='test_HTTP_op',
+            method='GET',
+            endpoint='/',
+            http_conn_id='HTTP_EXAMPLE',
+            log_response=True,
+            response_check=response_check
+        )
+
+        with mock.patch.object(operator.log, 'info') as mock_info:
+            self.assertRaises(AirflowException, operator.execute, None)
+            mock_info.assert_called_with('invalid response')

From 5367c2c910ca3cb3cd73516f890684d7a84d1687 Mon Sep 17 00:00:00 2001
From: Chao-Han Tsai <milton0825@gmail.com>
Date: Sun, 10 Mar 2019 20:48:49 -0700
Subject: [PATCH 665/808] [AIRFLOW-4033] record stats of task duration (#4858)

update docs

fix
---
 airflow/models/__init__.py | 11 +++++++++++
 docs/metrics.rst           |  1 +
 2 files changed, 12 insertions(+)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index d87756511b586..9b47333567ae9 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -52,6 +52,7 @@
 import re
 import signal
 import sys
+import time
 import textwrap
 import traceback
 import warnings
@@ -1436,6 +1437,8 @@ def signal_handler(signum, frame):
                 # Don't clear Xcom until the task is certain to execute
                 self.clear_xcom_data()
 
+                start_time = time.time()
+
                 self.render_templates()
                 task_copy.pre_execute(context=context)
 
@@ -1473,6 +1476,14 @@ def signal_handler(signum, frame):
                     else:
                         raise
 
+                end_time = time.time()
+                duration = end_time - start_time
+                Stats.timing(
+                    'dag.{dag_id}.{task_id}.duration'.format(
+                        dag_id=task_copy.dag_id,
+                        task_id=task_copy.task_id),
+                    duration)
+
                 Stats.incr('operator_successes_{}'.format(
                     self.task.__class__.__name__), 1, 1)
                 Stats.incr('ti_successes')
diff --git a/docs/metrics.rst b/docs/metrics.rst
index 0bd70fce32a61..4b818ac9e8305 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -66,4 +66,5 @@ Timers
 Name                              Description
 ================================= =======================================
 dagrun.dependency-check.<dag_id>  Seconds taken to check DAG dependencies
+dag.<dag_id>.<task_id>.duration   Seconds taken to finish a task
 ================================= =======================================

From 90648cd9200eeefbcec6c8d76343adc8c095afa2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 23 Jan 2019 00:45:12 +0100
Subject: [PATCH 666/808] [AIRFLOW-3744] Abandon the use of obsolete aliases of
 methods (#4568)

---
 .../common/experimental/test_trigger_dag.py   |   4 +-
 tests/cli/test_worker_initialisation.py       |   2 +-
 .../executors/test_kubernetes_executor.py     |   2 +-
 tests/contrib/hooks/test_aws_firehose_hook.py |   6 +-
 .../hooks/test_aws_glue_catalog_hook.py       |   8 +-
 tests/contrib/hooks/test_aws_lambda_hook.py   |   2 +-
 tests/contrib/hooks/test_bigquery_hook.py     |   2 +-
 tests/contrib/hooks/test_databricks_hook.py   |  24 +--
 tests/contrib/hooks/test_gcp_bigtable_hook.py |   6 +-
 .../contrib/hooks/test_gcp_container_hook.py  |   2 +-
 tests/contrib/hooks/test_gcp_dataflow_hook.py |  12 +-
 tests/contrib/hooks/test_gcp_function_hook.py |   8 +-
 tests/contrib/hooks/test_gcp_mlengine_hook.py |  20 +--
 tests/contrib/hooks/test_gcp_pubsub_hook.py   |  30 ++--
 tests/contrib/hooks/test_gcp_sql_hook.py      |  12 +-
 tests/contrib/hooks/test_gcs_hook.py          |   6 +-
 tests/contrib/hooks/test_imap_hook.py         |   6 +-
 tests/contrib/hooks/test_pinot_hook.py        |   2 +-
 tests/contrib/hooks/test_spark_jdbc_hook.py   |   2 +-
 tests/contrib/hooks/test_spark_submit_hook.py |   2 +-
 .../operators/test_awsbatch_operator.py       |   2 +-
 .../test_cassandra_to_gcs_operator.py         |  34 ++--
 .../operators/test_databricks_operator.py     |   8 +-
 .../operators/test_dataflow_operator.py       |   4 +-
 tests/contrib/operators/test_ecs_operator.py  |   2 +-
 .../operators/test_gcp_container_operator.py  |   4 +-
 .../operators/test_jenkins_operator.py        |   4 +-
 .../operators/test_mlengine_operator.py       |  50 +++---
 .../contrib/operators/test_pubsub_operator.py |   6 +-
 tests/contrib/operators/test_ssh_operator.py  |   4 +-
 tests/contrib/sensors/test_pubsub_sensor.py   |   6 +-
 tests/core.py                                 |  42 ++---
 tests/executors/test_celery_executor.py       |   4 +-
 tests/hooks/test_druid_hook.py                |   4 +-
 tests/hooks/test_http_hook.py                 |  18 +-
 tests/macros/test_hive.py                     |  10 +-
 tests/models.py                               |  36 ++--
 tests/operators/test_python_operator.py       |  42 ++---
 tests/sensors/test_base_sensor.py             | 166 +++++++++---------
 tests/test_configuration.py                   |   6 +-
 tests/test_jobs.py                            |  80 ++++-----
 tests/utils/test_cli_util.py                  |  10 +-
 tests/utils/test_dag_processing.py            |   8 +-
 tests/utils/test_email.py                     |   6 +-
 tests/utils/test_helpers.py                   |   4 +-
 tests/utils/test_timezone.py                  |   6 +-
 tests/www/test_utils.py                       |   2 +-
 tests/www/test_views.py                       |  10 +-
 tests/www_rbac/test_security.py               |   8 +-
 tests/www_rbac/test_utils.py                  |   2 +-
 50 files changed, 373 insertions(+), 373 deletions(-)

diff --git a/tests/api/common/experimental/test_trigger_dag.py b/tests/api/common/experimental/test_trigger_dag.py
index fc1d7cda8e55c..ec9899936569d 100644
--- a/tests/api/common/experimental/test_trigger_dag.py
+++ b/tests/api/common/experimental/test_trigger_dag.py
@@ -106,7 +106,7 @@ def test_trigger_dag_with_str_conf(self, dag_bag_mock):
             execution_date=None,
             replace_microseconds=True)
 
-        self.assertEquals(triggers[0].conf, json.loads(conf))
+        self.assertEqual(triggers[0].conf, json.loads(conf))
 
     @mock.patch('airflow.models.DagBag')
     def test_trigger_dag_with_dict_conf(self, dag_bag_mock):
@@ -125,7 +125,7 @@ def test_trigger_dag_with_dict_conf(self, dag_bag_mock):
             execution_date=None,
             replace_microseconds=True)
 
-        self.assertEquals(triggers[0].conf, conf)
+        self.assertEqual(triggers[0].conf, conf)
 
 
 if __name__ == '__main__':
diff --git a/tests/cli/test_worker_initialisation.py b/tests/cli/test_worker_initialisation.py
index 03fb9487fec58..8baa787a61b37 100644
--- a/tests/cli/test_worker_initialisation.py
+++ b/tests/cli/test_worker_initialisation.py
@@ -72,4 +72,4 @@ def test_validate_session_dbapi_exception(self, mock_getboolean, mock_session):
         """
         mock_getboolean.return_value = True
         mock_session.side_effect = sqlalchemy.exc.OperationalError("m1", "m2", "m3", "m4")
-        self.assertEquals(airflow.settings.validate_session(), False)
+        self.assertEqual(airflow.settings.validate_session(), False)
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 7c83eb45cb222..c80e5cfeb46db 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -83,7 +83,7 @@ def test_execution_date_serialize_deserialize(self):
         new_datetime_obj = AirflowKubernetesScheduler._label_safe_datestring_to_datetime(
             serialized_datetime)
 
-        self.assertEquals(datetime_obj, new_datetime_obj)
+        self.assertEqual(datetime_obj, new_datetime_obj)
 
 
 class TestKubernetesWorkerConfiguration(unittest.TestCase):
diff --git a/tests/contrib/hooks/test_aws_firehose_hook.py b/tests/contrib/hooks/test_aws_firehose_hook.py
index f22bcde2b1e29..441242c49ef50 100644
--- a/tests/contrib/hooks/test_aws_firehose_hook.py
+++ b/tests/contrib/hooks/test_aws_firehose_hook.py
@@ -57,7 +57,7 @@ def test_insert_batch_records_kinesis_firehose(self):
         )
 
         stream_arn = response['DeliveryStreamARN']
-        self.assertEquals(
+        self.assertEqual(
             stream_arn, "arn:aws:firehose:us-east-1:123456789012:deliverystream/test_airflow")
 
         records = [{"Data": str(uuid.uuid4())}
@@ -65,8 +65,8 @@ def test_insert_batch_records_kinesis_firehose(self):
 
         response = hook.put_records(records)
 
-        self.assertEquals(response['FailedPutCount'], 0)
-        self.assertEquals(response['ResponseMetadata']['HTTPStatusCode'], 200)
+        self.assertEqual(response['FailedPutCount'], 0)
+        self.assertEqual(response['ResponseMetadata']['HTTPStatusCode'], 200)
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/hooks/test_aws_glue_catalog_hook.py b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
index 4f28a1a18966e..96c70bd2642e1 100644
--- a/tests/contrib/hooks/test_aws_glue_catalog_hook.py
+++ b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
@@ -64,12 +64,12 @@ def test_get_conn_returns_a_boto3_connection(self):
     @mock_glue
     def test_conn_id(self):
         hook = AwsGlueCatalogHook(aws_conn_id='my_aws_conn_id', region_name="us-east-1")
-        self.assertEquals(hook.aws_conn_id, 'my_aws_conn_id')
+        self.assertEqual(hook.aws_conn_id, 'my_aws_conn_id')
 
     @mock_glue
     def test_region(self):
         hook = AwsGlueCatalogHook(region_name="us-west-2")
-        self.assertEquals(hook.region_name, 'us-west-2')
+        self.assertEqual(hook.region_name, 'us-west-2')
 
     @mock_glue
     @mock.patch.object(AwsGlueCatalogHook, 'get_conn')
@@ -78,7 +78,7 @@ def test_get_partitions_empty(self, mock_get_conn):
         mock_get_conn.get_paginator.paginate.return_value = response
         hook = AwsGlueCatalogHook(region_name="us-east-1")
 
-        self.assertEquals(hook.get_partitions('db', 'tbl'), set())
+        self.assertEqual(hook.get_partitions('db', 'tbl'), set())
 
     @mock_glue
     @mock.patch.object(AwsGlueCatalogHook, 'get_conn')
@@ -100,7 +100,7 @@ def test_get_partitions(self, mock_get_conn):
                                      page_size=2,
                                      max_items=3)
 
-        self.assertEquals(result, set([('2015-01-01',)]))
+        self.assertEqual(result, set([('2015-01-01',)]))
         mock_conn.get_paginator.assert_called_once_with('get_partitions')
         mock_paginator.paginate.assert_called_once_with(DatabaseName='db',
                                                         TableName='tbl',
diff --git a/tests/contrib/hooks/test_aws_lambda_hook.py b/tests/contrib/hooks/test_aws_lambda_hook.py
index e71bac5518ebf..ec97098e5119f 100644
--- a/tests/contrib/hooks/test_aws_lambda_hook.py
+++ b/tests/contrib/hooks/test_aws_lambda_hook.py
@@ -78,7 +78,7 @@ def test_invoke_lambda_function(self):
         input = {'hello': 'airflow'}
         response = hook.invoke_lambda(payload=json.dumps(input))
 
-        self.assertEquals(response["StatusCode"], 202)
+        self.assertEqual(response["StatusCode"], 202)
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index ecae0b6ffb347..f8f5c45c0f6ca 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -759,7 +759,7 @@ def test_location_propagates_properly(self, run_with_config):
             self.assertIsNone(bq_cursor.location)
             bq_cursor.run_query(sql='select 1', location='US')
             run_with_config.assert_called_once()
-            self.assertEquals(bq_cursor.location, 'US')
+            self.assertEqual(bq_cursor.location, 'US')
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 4ebc78c664038..83b75c9c20e10 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -180,11 +180,11 @@ def setUp(self, session=None):
 
     def test_parse_host_with_proper_host(self):
         host = self.hook._parse_host(HOST)
-        self.assertEquals(host, HOST)
+        self.assertEqual(host, HOST)
 
     def test_parse_host_with_scheme(self):
         host = self.hook._parse_host(HOST_WITH_SCHEME)
-        self.assertEquals(host, HOST)
+        self.assertEqual(host, HOST)
 
     def test_init_bad_retry_limit(self):
         with self.assertRaises(ValueError):
@@ -203,7 +203,7 @@ def test_do_api_call_retries_with_retryable_error(self):
                     with self.assertRaises(AirflowException):
                         self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
 
-                    self.assertEquals(mock_errors.call_count, self.hook.retry_limit)
+                    self.assertEqual(mock_errors.call_count, self.hook.retry_limit)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
     def test_do_api_call_does_not_retry_with_non_retryable_error(self, mock_requests):
@@ -234,8 +234,8 @@ def test_do_api_call_succeeds_after_retrying(self):
 
                     response = self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
 
-                    self.assertEquals(mock_errors.call_count, 2)
-                    self.assertEquals(response, {'run_id': '1'})
+                    self.assertEqual(mock_errors.call_count, 2)
+                    self.assertEqual(response, {'run_id': '1'})
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.sleep')
     def test_do_api_call_waits_between_retries(self, mock_sleep):
@@ -255,7 +255,7 @@ def test_do_api_call_waits_between_retries(self, mock_sleep):
                     with self.assertRaises(AirflowException):
                         self.hook._do_api_call(SUBMIT_RUN_ENDPOINT, {})
 
-                    self.assertEquals(len(mock_sleep.mock_calls), self.hook.retry_limit - 1)
+                    self.assertEqual(len(mock_sleep.mock_calls), self.hook.retry_limit - 1)
                     mock_sleep.assert_called_with(retry_delay)
 
     @mock.patch('airflow.contrib.hooks.databricks_hook.requests')
@@ -267,7 +267,7 @@ def test_submit_run(self, mock_requests):
         }
         run_id = self.hook.submit_run(json)
 
-        self.assertEquals(run_id, '1')
+        self.assertEqual(run_id, '1')
         mock_requests.post.assert_called_once_with(
             submit_run_endpoint(HOST),
             json={
@@ -291,7 +291,7 @@ def test_run_now(self, mock_requests):
         }
         run_id = self.hook.run_now(json)
 
-        self.assertEquals(run_id, '1')
+        self.assertEqual(run_id, '1')
 
         mock_requests.post.assert_called_once_with(
             run_now_endpoint(HOST),
@@ -310,7 +310,7 @@ def test_get_run_page_url(self, mock_requests):
 
         run_page_url = self.hook.get_run_page_url(RUN_ID)
 
-        self.assertEquals(run_page_url, RUN_PAGE_URL)
+        self.assertEqual(run_page_url, RUN_PAGE_URL)
         mock_requests.get.assert_called_once_with(
             get_run_endpoint(HOST),
             json={'run_id': RUN_ID},
@@ -324,7 +324,7 @@ def test_get_run_state(self, mock_requests):
 
         run_state = self.hook.get_run_state(RUN_ID)
 
-        self.assertEquals(run_state, RunState(
+        self.assertEqual(run_state, RunState(
             LIFE_CYCLE_STATE,
             RESULT_STATE,
             STATE_MESSAGE))
@@ -424,10 +424,10 @@ def test_submit_run(self, mock_requests):
         }
         run_id = self.hook.submit_run(json)
 
-        self.assertEquals(run_id, '1')
+        self.assertEqual(run_id, '1')
         args = mock_requests.post.call_args
         kwargs = args[1]
-        self.assertEquals(kwargs['auth'].token, TOKEN)
+        self.assertEqual(kwargs['auth'].token, TOKEN)
 
 
 class RunStateTest(unittest.TestCase):
diff --git a/tests/contrib/hooks/test_gcp_bigtable_hook.py b/tests/contrib/hooks/test_gcp_bigtable_hook.py
index ea86ff9d756b6..96ea68c425a53 100644
--- a/tests/contrib/hooks/test_gcp_bigtable_hook.py
+++ b/tests/contrib/hooks/test_gcp_bigtable_hook.py
@@ -133,7 +133,7 @@ def test_create_instance_overridden_project_id(self, get_client, instance_create
             main_cluster_zone=CBT_ZONE)
         get_client.assert_called_once_with(project_id='example-project')
         instance_create.assert_called_once_with(clusters=mock.ANY)
-        self.assertEquals(res.instance_id, 'instance')
+        self.assertEqual(res.instance_id, 'instance')
 
     @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
     def test_delete_table_missing_project_id(self, get_client):
@@ -263,7 +263,7 @@ def test_create_instance(self, get_client, instance_create):
             main_cluster_zone=CBT_ZONE)
         get_client.assert_called_once_with(project_id='example-project')
         instance_create.assert_called_once_with(clusters=mock.ANY)
-        self.assertEquals(res.instance_id, 'instance')
+        self.assertEqual(res.instance_id, 'instance')
 
     @mock.patch('google.cloud.bigtable.instance.Instance.create')
     @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
@@ -278,7 +278,7 @@ def test_create_instance_overridden_project_id(self, get_client, instance_create
             main_cluster_zone=CBT_ZONE)
         get_client.assert_called_once_with(project_id='new-project')
         instance_create.assert_called_once_with(clusters=mock.ANY)
-        self.assertEquals(res.instance_id, 'instance')
+        self.assertEqual(res.instance_id, 'instance')
 
     @mock.patch('airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook._get_client')
     def test_delete_table(self, get_client):
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index dfcc98cb5cc85..be337c64baec2 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -161,7 +161,7 @@ def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
 
         self.gke_hook.create_cluster({})
         wait_mock.assert_not_called()
-        self.assertEquals(convert_mock.call_count, 1)
+        self.assertEqual(convert_mock.call_count, 1)
         log_mock.info.assert_any_call("Assuming Success: " + message)
 
 
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index 57932c47f647a..fb4a83c6be19d 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -180,7 +180,7 @@ def test_valid_dataflow_job_name(self):
             job_name=JOB_NAME, append_job_name=False
         )
 
-        self.assertEquals(job_name, JOB_NAME)
+        self.assertEqual(job_name, JOB_NAME)
 
     def test_fix_underscore_in_job_name(self):
         job_name_with_underscore = 'test_example'
@@ -191,7 +191,7 @@ def test_fix_underscore_in_job_name(self):
             job_name=job_name_with_underscore, append_job_name=False
         )
 
-        self.assertEquals(job_name, fixed_job_name)
+        self.assertEqual(job_name, fixed_job_name)
 
     def test_invalid_dataflow_job_name(self):
         invalid_job_name = '9test_invalid_name'
@@ -208,19 +208,19 @@ def test_invalid_dataflow_job_name(self):
 
     def test_dataflow_job_regex_check(self):
 
-        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+        self.assertEqual(self.dataflow_hook._build_dataflow_job_name(
             job_name='df-job-1', append_job_name=False
         ), 'df-job-1')
 
-        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+        self.assertEqual(self.dataflow_hook._build_dataflow_job_name(
             job_name='df-job', append_job_name=False
         ), 'df-job')
 
-        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+        self.assertEqual(self.dataflow_hook._build_dataflow_job_name(
             job_name='dfjob', append_job_name=False
         ), 'dfjob')
 
-        self.assertEquals(self.dataflow_hook._build_dataflow_job_name(
+        self.assertEqual(self.dataflow_hook._build_dataflow_job_name(
             job_name='dfjob1', append_job_name=False
         ), 'dfjob1')
 
diff --git a/tests/contrib/hooks/test_gcp_function_hook.py b/tests/contrib/hooks/test_gcp_function_hook.py
index b9cd9780a127a..a271f05c74ed6 100644
--- a/tests/contrib/hooks/test_gcp_function_hook.py
+++ b/tests/contrib/hooks/test_gcp_function_hook.py
@@ -118,7 +118,7 @@ def test_upload_function_zip_overridden_project_id(self, get_conn, requests_put)
                 location=GCF_LOCATION,
                 zip_path="/tmp/path.zip"
             )
-            self.assertEquals("http://uploadHere", res)
+            self.assertEqual("http://uploadHere", res)
             generate_upload_url_method.assert_called_with(
                 parent='projects/example-project/locations/location')
             execute_method.assert_called_once_with(num_retries=5)
@@ -183,7 +183,7 @@ def test_get_function(self, get_conn):
             name=GCF_FUNCTION
         )
         self.assertIsNotNone(res)
-        self.assertEquals('function', res['name'])
+        self.assertEqual('function', res['name'])
         get_method.assert_called_once_with(name='function')
         execute_method.assert_called_once_with(num_retries=5)
 
@@ -238,7 +238,7 @@ def test_upload_function_zip(self, get_conn, requests_put):
                 location=GCF_LOCATION,
                 zip_path="/tmp/path.zip"
             )
-            self.assertEquals("http://uploadHere", res)
+            self.assertEqual("http://uploadHere", res)
             generate_upload_url_method.assert_called_with(
                 parent='projects/example-project/locations/location')
             execute_method.assert_called_once_with(num_retries=5)
@@ -264,7 +264,7 @@ def test_upload_function_zip_overridden_project_id(self, get_conn, requests_put)
                 location=GCF_LOCATION,
                 zip_path="/tmp/path.zip"
             )
-            self.assertEquals("http://uploadHere", res)
+            self.assertEqual("http://uploadHere", res)
             generate_upload_url_method.assert_called_with(
                 parent='projects/new-project/locations/location')
             execute_method.assert_called_once_with(num_retries=5)
diff --git a/tests/contrib/hooks/test_gcp_mlengine_hook.py b/tests/contrib/hooks/test_gcp_mlengine_hook.py
index 7313d8dc9ba8e..be06619d53e84 100644
--- a/tests/contrib/hooks/test_gcp_mlengine_hook.py
+++ b/tests/contrib/hooks/test_gcp_mlengine_hook.py
@@ -90,7 +90,7 @@ def __exit__(self, *args):
         # Propogating exceptions here since assert will silence them.
         if any(args):
             return None
-        self._test_cls.assertEquals(
+        self._test_cls.assertEqual(
             [self._normalize_requests_for_comparison(x[0], x[1], x[2])
                 for x in self._actual_requests],
             self._expected_requests)
@@ -132,7 +132,7 @@ def test_create_version(self):
             create_version_response = cml_hook.create_version(
                 project_id=project, model_name=model_name,
                 version_spec=version)
-            self.assertEquals(create_version_response, response_body)
+            self.assertEqual(create_version_response, response_body)
 
     @_SKIP_IF
     def test_set_default_version(self):
@@ -158,7 +158,7 @@ def test_set_default_version(self):
             set_default_version_response = cml_hook.set_default_version(
                 project_id=project, model_name=model_name,
                 version_name=version)
-            self.assertEquals(set_default_version_response, response_body)
+            self.assertEqual(set_default_version_response, response_body)
 
     @_SKIP_IF
     def test_list_versions(self):
@@ -196,7 +196,7 @@ def test_list_versions(self):
                 expected_requests=expected_requests) as cml_hook:
             list_versions_response = cml_hook.list_versions(
                 project_id=project, model_name=model_name)
-            self.assertEquals(list_versions_response, versions)
+            self.assertEqual(list_versions_response, versions)
 
     @_SKIP_IF
     def test_delete_version(self):
@@ -230,7 +230,7 @@ def test_delete_version(self):
             delete_version_response = cml_hook.delete_version(
                 project_id=project, model_name=model_name,
                 version_name=version)
-            self.assertEquals(delete_version_response, done_response_body)
+            self.assertEqual(delete_version_response, done_response_body)
 
     @_SKIP_IF
     def test_create_model(self):
@@ -254,7 +254,7 @@ def test_create_model(self):
                 expected_requests=expected_requests) as cml_hook:
             create_model_response = cml_hook.create_model(
                 project_id=project, model=model)
-            self.assertEquals(create_model_response, response_body)
+            self.assertEqual(create_model_response, response_body)
 
     @_SKIP_IF
     def test_get_model(self):
@@ -275,7 +275,7 @@ def test_get_model(self):
                 expected_requests=expected_requests) as cml_hook:
             get_model_response = cml_hook.get_model(
                 project_id=project, model_name=model_name)
-            self.assertEquals(get_model_response, response_body)
+            self.assertEqual(get_model_response, response_body)
 
     @_SKIP_IF
     def test_create_mlengine_job(self):
@@ -311,7 +311,7 @@ def test_create_mlengine_job(self):
                 expected_requests=expected_requests) as cml_hook:
             create_job_response = cml_hook.create_job(
                 project_id=project, job=my_job)
-            self.assertEquals(create_job_response, my_job)
+            self.assertEqual(create_job_response, my_job)
 
     @_SKIP_IF
     def test_create_mlengine_job_reuse_existing_job_by_default(self):
@@ -343,7 +343,7 @@ def test_create_mlengine_job_reuse_existing_job_by_default(self):
                 expected_requests=expected_requests) as cml_hook:
             create_job_response = cml_hook.create_job(
                 project_id=project, job=my_job)
-            self.assertEquals(create_job_response, my_job)
+            self.assertEqual(create_job_response, my_job)
 
     @_SKIP_IF
     def test_create_mlengine_job_check_existing_job(self):
@@ -414,7 +414,7 @@ def check_input(existing_job):
             create_job_response = cml_hook.create_job(
                 project_id=project, job=my_job,
                 use_existing_job_fn=check_input)
-            self.assertEquals(create_job_response, my_job)
+            self.assertEqual(create_job_response, my_job)
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/hooks/test_gcp_pubsub_hook.py b/tests/contrib/hooks/test_gcp_pubsub_hook.py
index 3cd6e2a89b507..ebab0566fe1c7 100644
--- a/tests/contrib/hooks/test_gcp_pubsub_hook.py
+++ b/tests/contrib/hooks/test_gcp_pubsub_hook.py
@@ -93,8 +93,8 @@ def test_delete_nonexisting_topic_failifnotexists(self, mock_service):
         with self.assertRaises(PubSubException) as e:
             self.pubsub_hook.delete_topic(TEST_PROJECT, TEST_TOPIC, True)
 
-        self.assertEquals(str(e.exception),
-                          'Topic does not exist: %s' % EXPANDED_TOPIC)
+        self.assertEqual(str(e.exception),
+                         'Topic does not exist: %s' % EXPANDED_TOPIC)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_preexisting_topic_failifexists(self, mock_service):
@@ -104,8 +104,8 @@ def test_create_preexisting_topic_failifexists(self, mock_service):
 
         with self.assertRaises(PubSubException) as e:
             self.pubsub_hook.create_topic(TEST_PROJECT, TEST_TOPIC, True)
-        self.assertEquals(str(e.exception),
-                          'Topic already exists: %s' % EXPANDED_TOPIC)
+        self.assertEqual(str(e.exception),
+                         'Topic already exists: %s' % EXPANDED_TOPIC)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_preexisting_topic_nofailifexists(self, mock_service):
@@ -130,7 +130,7 @@ def test_create_nonexistent_subscription(self, mock_service):
         create_method.assert_called_with(name=EXPANDED_SUBSCRIPTION,
                                          body=expected_body)
         create_method.return_value.execute.assert_called_with()
-        self.assertEquals(TEST_SUBSCRIPTION, response)
+        self.assertEqual(TEST_SUBSCRIPTION, response)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_subscription_different_project_topic(self, mock_service):
@@ -150,7 +150,7 @@ def test_create_subscription_different_project_topic(self, mock_service):
         create_method.assert_called_with(name=expected_subscription,
                                          body=expected_body)
         create_method.return_value.execute.assert_called_with()
-        self.assertEquals(TEST_SUBSCRIPTION, response)
+        self.assertEqual(TEST_SUBSCRIPTION, response)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_delete_subscription(self, mock_service):
@@ -172,9 +172,9 @@ def test_delete_nonexisting_subscription_failifnotexists(self,
             self.pubsub_hook.delete_subscription(
                 TEST_PROJECT, TEST_SUBSCRIPTION, fail_if_not_exists=True)
 
-        self.assertEquals(str(e.exception),
-                          'Subscription does not exist: %s' %
-                          EXPANDED_SUBSCRIPTION)
+        self.assertEqual(str(e.exception),
+                         'Subscription does not exist: %s' %
+                         EXPANDED_SUBSCRIPTION)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     @mock.patch(PUBSUB_STRING.format('uuid4'),
@@ -194,7 +194,7 @@ def test_create_subscription_without_name(self, mock_uuid, mock_service):
         create_method.assert_called_with(name=expected_name,
                                          body=expected_body)
         create_method.return_value.execute.assert_called_with()
-        self.assertEquals('sub-%s' % TEST_UUID, response)
+        self.assertEqual('sub-%s' % TEST_UUID, response)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_subscription_with_ack_deadline(self, mock_service):
@@ -211,7 +211,7 @@ def test_create_subscription_with_ack_deadline(self, mock_service):
         create_method.assert_called_with(name=EXPANDED_SUBSCRIPTION,
                                          body=expected_body)
         create_method.return_value.execute.assert_called_with()
-        self.assertEquals(TEST_SUBSCRIPTION, response)
+        self.assertEqual(TEST_SUBSCRIPTION, response)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_subscription_failifexists(self, mock_service):
@@ -225,9 +225,9 @@ def test_create_subscription_failifexists(self, mock_service):
                 TEST_PROJECT, TEST_TOPIC, TEST_SUBSCRIPTION,
                 fail_if_exists=True)
 
-        self.assertEquals(str(e.exception),
-                          'Subscription already exists: %s' %
-                          EXPANDED_SUBSCRIPTION)
+        self.assertEqual(str(e.exception),
+                         'Subscription already exists: %s' %
+                         EXPANDED_SUBSCRIPTION)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_create_subscription_nofailifexists(self, mock_service):
@@ -238,7 +238,7 @@ def test_create_subscription_nofailifexists(self, mock_service):
         response = self.pubsub_hook.create_subscription(
             TEST_PROJECT, TEST_TOPIC, TEST_SUBSCRIPTION
         )
-        self.assertEquals(TEST_SUBSCRIPTION, response)
+        self.assertEqual(TEST_SUBSCRIPTION, response)
 
     @mock.patch(PUBSUB_STRING.format('PubSubHook.get_conn'))
     def test_publish(self, mock_service):
diff --git a/tests/contrib/hooks/test_gcp_sql_hook.py b/tests/contrib/hooks/test_gcp_sql_hook.py
index 51b84104ef60b..3c49e4299b57f 100644
--- a/tests/contrib/hooks/test_gcp_sql_hook.py
+++ b/tests/contrib/hooks/test_gcp_sql_hook.py
@@ -145,7 +145,7 @@ def test_get_instance(self, wait_for_operation_to_complete, get_conn):
         res = self.cloudsql_hook.get_instance(
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('instance', res['name'])
+        self.assertEqual('instance', res['name'])
         get_method.assert_called_once_with(instance='instance', project='example-project')
         execute_method.assert_called_once_with(num_retries=5)
         wait_for_operation_to_complete.assert_not_called()
@@ -161,7 +161,7 @@ def test_get_instance_overridden_project_id(self, wait_for_operation_to_complete
             project_id='new-project',
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('instance', res['name'])
+        self.assertEqual('instance', res['name'])
         get_method.assert_called_once_with(instance='instance', project='new-project')
         execute_method.assert_called_once_with(num_retries=5)
         wait_for_operation_to_complete.assert_not_called()
@@ -278,7 +278,7 @@ def test_get_database(self, wait_for_operation_to_complete, get_conn):
             database='database',
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('database', res['name'])
+        self.assertEqual('database', res['name'])
         get_method.assert_called_once_with(instance='instance',
                                            database='database',
                                            project='example-project')
@@ -297,7 +297,7 @@ def test_get_database_overridden_project_id(self, wait_for_operation_to_complete
             database='database',
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('database', res['name'])
+        self.assertEqual('database', res['name'])
         get_method.assert_called_once_with(instance='instance',
                                            database='database',
                                            project='new-project')
@@ -507,7 +507,7 @@ def test_get_instance_overridden_project_id(self, wait_for_operation_to_complete
             project_id='example-project',
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('instance', res['name'])
+        self.assertEqual('instance', res['name'])
         get_method.assert_called_once_with(instance='instance', project='example-project')
         execute_method.assert_called_once_with(num_retries=5)
         wait_for_operation_to_complete.assert_not_called()
@@ -641,7 +641,7 @@ def test_get_database_overridden_project_id(self, wait_for_operation_to_complete
             database='database',
             instance='instance')
         self.assertIsNotNone(res)
-        self.assertEquals('database', res['name'])
+        self.assertEqual('database', res['name'])
         get_method.assert_called_once_with(instance='instance',
                                            database='database',
                                            project='example-project')
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index 46faede46a8e5..1ee26be09b14c 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -208,7 +208,7 @@ def test_copy_fail_same_source_and_destination(self):
                                destination_bucket=destination_bucket,
                                destination_object=destination_object)
 
-        self.assertEquals(
+        self.assertEqual(
             str(e.exception),
             'Either source/destination bucket or source/destination object '
             'must be different, not both the same: bucket=%s, object=%s' %
@@ -228,7 +228,7 @@ def test_copy_empty_source_bucket(self):
                                destination_bucket=destination_bucket,
                                destination_object=destination_object)
 
-        self.assertEquals(
+        self.assertEqual(
             str(e.exception),
             'source_bucket and source_object cannot be empty.'
         )
@@ -246,7 +246,7 @@ def test_copy_empty_source_object(self):
                                destination_bucket=destination_bucket,
                                destination_object=destination_object)
 
-        self.assertEquals(
+        self.assertEqual(
             str(e.exception),
             'source_bucket and source_object cannot be empty.'
         )
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index f4e68fec8442f..57dbf532d51a1 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -125,7 +125,7 @@ def test_retrieve_mail_attachments_found(self, mock_imaplib):
         with ImapHook() as imap_hook:
             attachments_in_inbox = imap_hook.retrieve_mail_attachments('test1.csv')
 
-        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+        self.assertEqual(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
 
     @patch(imaplib_string)
     def test_retrieve_mail_attachments_not_found(self, mock_imaplib):
@@ -144,7 +144,7 @@ def test_retrieve_mail_attachments_with_regex_found(self, mock_imaplib):
                 check_regex=True
             )
 
-        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+        self.assertEqual(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
 
     @patch(imaplib_string)
     def test_retrieve_mail_attachments_with_regex_not_found(self, mock_imaplib):
@@ -166,7 +166,7 @@ def test_retrieve_mail_attachments_latest_only(self, mock_imaplib):
                 latest_only=True
             )
 
-        self.assertEquals(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
+        self.assertEqual(attachments_in_inbox, [('test1.csv', b'SWQsTmFtZQoxLEZlbGl4')])
 
     @patch(open_string, new_callable=mock_open)
     @patch(imaplib_string)
diff --git a/tests/contrib/hooks/test_pinot_hook.py b/tests/contrib/hooks/test_pinot_hook.py
index d63ee1cc7de7c..74be9a3624e09 100644
--- a/tests/contrib/hooks/test_pinot_hook.py
+++ b/tests/contrib/hooks/test_pinot_hook.py
@@ -51,7 +51,7 @@ def test_get_uri(self):
         Test on getting a pinot connection uri
         """
         db_hook = self.db_hook()
-        self.assertEquals(db_hook.get_uri(), 'http://host:1000/pql')
+        self.assertEqual(db_hook.get_uri(), 'http://host:1000/pql')
 
     def test_get_conn(self):
         """
diff --git a/tests/contrib/hooks/test_spark_jdbc_hook.py b/tests/contrib/hooks/test_spark_jdbc_hook.py
index f7979f25510b1..41bc1f3e30cfb 100644
--- a/tests/contrib/hooks/test_spark_jdbc_hook.py
+++ b/tests/contrib/hooks/test_spark_jdbc_hook.py
@@ -126,7 +126,7 @@ def test_build_jdbc_arguments(self):
             '-createTableColumnTypes', 'columnMcColumnFace INTEGER(100), name CHAR(64),'
                                        'comments VARCHAR(1024)'
         ]
-        self.assertEquals(expected_jdbc_arguments, cmd)
+        self.assertEqual(expected_jdbc_arguments, cmd)
 
     def test_build_jdbc_arguments_invalid(self):
         # Given
diff --git a/tests/contrib/hooks/test_spark_submit_hook.py b/tests/contrib/hooks/test_spark_submit_hook.py
index a01379214e9a3..45b10d42bce5b 100644
--- a/tests/contrib/hooks/test_spark_submit_hook.py
+++ b/tests/contrib/hooks/test_spark_submit_hook.py
@@ -165,7 +165,7 @@ def test_build_spark_submit_command(self):
             '--with-spaces', 'args should keep embdedded spaces',
             'baz'
         ]
-        self.assertEquals(expected_build_cmd, cmd)
+        self.assertEqual(expected_build_cmd, cmd)
 
     @patch('airflow.contrib.hooks.spark_submit_hook.subprocess.Popen')
     def test_spark_process_runcmd(self, mock_popen):
diff --git a/tests/contrib/operators/test_awsbatch_operator.py b/tests/contrib/operators/test_awsbatch_operator.py
index cdb838200fad1..3c4f7991c6f0d 100644
--- a/tests/contrib/operators/test_awsbatch_operator.py
+++ b/tests/contrib/operators/test_awsbatch_operator.py
@@ -119,7 +119,7 @@ def test_wait_end_tasks(self):
         client_mock.get_waiter.return_value.wait.assert_called_once_with(
             jobs=['8ba9d676-4108-4474-9dca-8bbac1da9b19']
         )
-        self.assertEquals(sys.maxsize, client_mock.get_waiter.return_value.config.max_attempts)
+        self.assertEqual(sys.maxsize, client_mock.get_waiter.return_value.config.max_attempts)
 
     def test_check_success_tasks_raises(self):
         client_mock = mock.Mock()
diff --git a/tests/contrib/operators/test_cassandra_to_gcs_operator.py b/tests/contrib/operators/test_cassandra_to_gcs_operator.py
index 42f8195f51f0c..7807ca816472a 100644
--- a/tests/contrib/operators/test_cassandra_to_gcs_operator.py
+++ b/tests/contrib/operators/test_cassandra_to_gcs_operator.py
@@ -44,49 +44,49 @@ def test_execute(self, upload, get_conn):
 
     def test_convert_value(self):
         op = CassandraToGoogleCloudStorageOperator
-        self.assertEquals(op.convert_value('None', None), None)
-        self.assertEquals(op.convert_value('int', 1), 1)
-        self.assertEquals(op.convert_value('float', 1.0), 1.0)
-        self.assertEquals(op.convert_value('str', "text"), "text")
-        self.assertEquals(op.convert_value('bool', True), True)
-        self.assertEquals(op.convert_value('dict', {"a": "b"}), {"a": "b"})
+        self.assertEqual(op.convert_value('None', None), None)
+        self.assertEqual(op.convert_value('int', 1), 1)
+        self.assertEqual(op.convert_value('float', 1.0), 1.0)
+        self.assertEqual(op.convert_value('str', "text"), "text")
+        self.assertEqual(op.convert_value('bool', True), True)
+        self.assertEqual(op.convert_value('dict', {"a": "b"}), {"a": "b"})
 
         from datetime import datetime
         now = datetime.now()
-        self.assertEquals(op.convert_value('datetime', now), str(now))
+        self.assertEqual(op.convert_value('datetime', now), str(now))
 
         from cassandra.util import Date
         date_str = '2018-01-01'
         date = Date(date_str)
-        self.assertEquals(op.convert_value('date', date), str(date_str))
+        self.assertEqual(op.convert_value('date', date), str(date_str))
 
         import uuid
         from base64 import b64encode
         test_uuid = uuid.uuid4()
         encoded_uuid = b64encode(test_uuid.bytes).decode('ascii')
-        self.assertEquals(op.convert_value('uuid', test_uuid), encoded_uuid)
+        self.assertEqual(op.convert_value('uuid', test_uuid), encoded_uuid)
 
         b = b'abc'
         encoded_b = b64encode(b).decode('ascii')
-        self.assertEquals(op.convert_value('binary', b), encoded_b)
+        self.assertEqual(op.convert_value('binary', b), encoded_b)
 
         from decimal import Decimal
         d = Decimal(1.0)
-        self.assertEquals(op.convert_value('decimal', d), float(d))
+        self.assertEqual(op.convert_value('decimal', d), float(d))
 
         from cassandra.util import Time
         time = Time(0)
-        self.assertEquals(op.convert_value('time', time), '00:00:00')
+        self.assertEqual(op.convert_value('time', time), '00:00:00')
 
         date_str_lst = ['2018-01-01', '2018-01-02', '2018-01-03']
         date_lst = [Date(d) for d in date_str_lst]
-        self.assertEquals(op.convert_value('list', date_lst), date_str_lst)
+        self.assertEqual(op.convert_value('list', date_lst), date_str_lst)
 
         date_tpl = tuple(date_lst)
-        self.assertEquals(op.convert_value('tuple', date_tpl),
-                          {'field_0': '2018-01-01',
-                           'field_1': '2018-01-02',
-                           'field_2': '2018-01-03', })
+        self.assertEqual(op.convert_value('tuple', date_tpl),
+                         {'field_0': '2018-01-01',
+                          'field_1': '2018-01-02',
+                          'field_2': '2018-01-03', })
 
 
 if __name__ == '__main__':
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index 56440cddf6f04..6b5dfc99d0b79 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -219,7 +219,7 @@ def test_exec_success(self, db_mock_class):
         db_mock.submit_run.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
-        self.assertEquals(RUN_ID, op.run_id)
+        self.assertEqual(RUN_ID, op.run_id)
 
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_exec_failure(self, db_mock_class):
@@ -250,7 +250,7 @@ def test_exec_failure(self, db_mock_class):
         db_mock.submit_run.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
-        self.assertEquals(RUN_ID, op.run_id)
+        self.assertEqual(RUN_ID, op.run_id)
 
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_on_kill(self, db_mock_class):
@@ -388,7 +388,7 @@ def test_exec_success(self, db_mock_class):
         db_mock.run_now.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
-        self.assertEquals(RUN_ID, op.run_id)
+        self.assertEqual(RUN_ID, op.run_id)
 
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_exec_failure(self, db_mock_class):
@@ -421,7 +421,7 @@ def test_exec_failure(self, db_mock_class):
         db_mock.run_now.assert_called_once_with(expected)
         db_mock.get_run_page_url.assert_called_once_with(RUN_ID)
         db_mock.get_run_state.assert_called_once_with(RUN_ID)
-        self.assertEquals(RUN_ID, op.run_id)
+        self.assertEqual(RUN_ID, op.run_id)
 
     @mock.patch('airflow.contrib.operators.databricks_operator.DatabricksHook')
     def test_on_kill(self, db_mock_class):
diff --git a/tests/contrib/operators/test_dataflow_operator.py b/tests/contrib/operators/test_dataflow_operator.py
index b951503eb5bf7..0eb4d0b12b286 100644
--- a/tests/contrib/operators/test_dataflow_operator.py
+++ b/tests/contrib/operators/test_dataflow_operator.py
@@ -213,7 +213,7 @@ def test_invalid_object_path(self, mock_parent_init):
         with self.assertRaises(Exception) as context:
             gcs_bucket_helper.google_cloud_to_local(file_name)
 
-        self.assertEquals(
+        self.assertEqual(
             'Invalid Google Cloud Storage (GCS) object path: {}'.format(file_name),
             str(context.exception))
 
@@ -261,6 +261,6 @@ def _mock_download(bucket, object, filename=None):
         with self.assertRaises(Exception) as context:
             gcs_bucket_helper.google_cloud_to_local(file_name)
 
-        self.assertEquals(
+        self.assertEqual(
             'Failed to download Google Cloud Storage (GCS) object: {}'.format(file_name),
             str(context.exception))
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index 51391c7b1ea9a..348876d2ca8d8 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -174,7 +174,7 @@ def test_wait_end_tasks(self):
         client_mock.get_waiter.assert_called_once_with('tasks_stopped')
         client_mock.get_waiter.return_value.wait.assert_called_once_with(
             cluster='c', tasks=['arn'])
-        self.assertEquals(
+        self.assertEqual(
             sys.maxsize, client_mock.get_waiter.return_value.config.max_attempts)
 
     def test_check_success_tasks_raises(self):
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index 52cb3a19dffe4..b337791be7b51 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -256,7 +256,7 @@ def test_set_env_from_extras_dict(self, file_mock):
         }
 
         self.gke_op._set_env_from_extras(extras)
-        self.assertEquals(os.environ[GAC_ENV_VAR], FILE_NAME)
+        self.assertEqual(os.environ[GAC_ENV_VAR], FILE_NAME)
 
         file_mock.return_value.write.assert_called_once_with(KEYFILE_DICT_STR)
 
@@ -269,7 +269,7 @@ def test_set_env_from_extras_path(self):
         }
 
         self.gke_op._set_env_from_extras(extras)
-        self.assertEquals(os.environ[GAC_ENV_VAR], TEST_PATH)
+        self.assertEqual(os.environ[GAC_ENV_VAR], TEST_PATH)
 
     def test_get_field(self):
         FIELD_NAME = 'test_field'
diff --git a/tests/contrib/operators/test_jenkins_operator.py b/tests/contrib/operators/test_jenkins_operator.py
index 23e0bcb66fd97..33269264fb717 100644
--- a/tests/contrib/operators/test_jenkins_operator.py
+++ b/tests/contrib/operators/test_jenkins_operator.py
@@ -70,7 +70,7 @@ def test_execute(self):
 
             operator.execute(None)
 
-            self.assertEquals(jenkins_mock.get_build_info.call_count, 1)
+            self.assertEqual(jenkins_mock.get_build_info.call_count, 1)
             jenkins_mock.get_build_info.assert_called_with(name='a_job_on_jenkins',
                                                            number='1')
 
@@ -107,7 +107,7 @@ def test_execute_job_polling_loop(self):
                 sleep_time=1)
 
             operator.execute(None)
-            self.assertEquals(jenkins_mock.get_build_info.call_count, 2)
+            self.assertEqual(jenkins_mock.get_build_info.call_count, 2)
 
     @unittest.skipIf(mock is None, 'mock package not present')
     def test_execute_job_failure(self):
diff --git a/tests/contrib/operators/test_mlengine_operator.py b/tests/contrib/operators/test_mlengine_operator.py
index bceeb5c225e54..eb62e79d4c54c 100644
--- a/tests/contrib/operators/test_mlengine_operator.py
+++ b/tests/contrib/operators/test_mlengine_operator.py
@@ -109,8 +109,8 @@ def testSuccessWithModel(self):
                     'jobId': 'test_prediction',
                     'predictionInput': input_with_model
                 }, ANY)
-            self.assertEquals(success_message['predictionOutput'],
-                              prediction_output)
+            self.assertEqual(success_message['predictionOutput'],
+                             prediction_output)
 
     def testSuccessWithVersion(self):
         with patch('airflow.contrib.operators.mlengine_operator.MLEngineHook') \
@@ -148,8 +148,8 @@ def testSuccessWithVersion(self):
                     'jobId': 'test_prediction',
                     'predictionInput': input_with_version
                 }, ANY)
-            self.assertEquals(success_message['predictionOutput'],
-                              prediction_output)
+            self.assertEqual(success_message['predictionOutput'],
+                             prediction_output)
 
     def testSuccessWithURI(self):
         with patch('airflow.contrib.operators.mlengine_operator.MLEngineHook') \
@@ -185,8 +185,8 @@ def testSuccessWithURI(self):
                     'jobId': 'test_prediction',
                     'predictionInput': input_with_uri
                 }, ANY)
-            self.assertEquals(success_message['predictionOutput'],
-                              prediction_output)
+            self.assertEqual(success_message['predictionOutput'],
+                             prediction_output)
 
     def testInvalidModelOrigin(self):
         # Test that both uri and model is given
@@ -195,9 +195,9 @@ def testInvalidModelOrigin(self):
         task_args['model_name'] = 'fake_model'
         with self.assertRaises(AirflowException) as context:
             MLEngineBatchPredictionOperator(**task_args).execute(None)
-        self.assertEquals('Ambiguous model origin: Both uri and '
-                          'model/version name are provided.',
-                          str(context.exception))
+        self.assertEqual('Ambiguous model origin: Both uri and '
+                         'model/version name are provided.',
+                         str(context.exception))
 
         # Test that both uri and model/version is given
         task_args = self.BATCH_PREDICTION_DEFAULT_ARGS.copy()
@@ -206,24 +206,24 @@ def testInvalidModelOrigin(self):
         task_args['version_name'] = 'fake_version'
         with self.assertRaises(AirflowException) as context:
             MLEngineBatchPredictionOperator(**task_args).execute(None)
-        self.assertEquals('Ambiguous model origin: Both uri and '
-                          'model/version name are provided.',
-                          str(context.exception))
+        self.assertEqual('Ambiguous model origin: Both uri and '
+                         'model/version name are provided.',
+                         str(context.exception))
 
         # Test that a version is given without a model
         task_args = self.BATCH_PREDICTION_DEFAULT_ARGS.copy()
         task_args['version_name'] = 'bare_version'
         with self.assertRaises(AirflowException) as context:
             MLEngineBatchPredictionOperator(**task_args).execute(None)
-        self.assertEquals('Missing model: Batch prediction expects a model '
-                          'name when a version name is provided.',
-                          str(context.exception))
+        self.assertEqual('Missing model: Batch prediction expects a model '
+                         'name when a version name is provided.',
+                         str(context.exception))
 
         # Test that none of uri, model, model/version is given
         task_args = self.BATCH_PREDICTION_DEFAULT_ARGS.copy()
         with self.assertRaises(AirflowException) as context:
             MLEngineBatchPredictionOperator(**task_args).execute(None)
-        self.assertEquals(
+        self.assertEqual(
             'Missing model origin: Batch prediction expects a '
             'model, a model & version combination, or a URI to a savedModel.',
             str(context.exception))
@@ -264,7 +264,7 @@ def testHttpError(self):
                         'predictionInput': input_with_model
                     }, ANY)
 
-            self.assertEquals(http_error_code, context.exception.resp.status)
+            self.assertEqual(http_error_code, context.exception.resp.status)
 
     def testFailedJobError(self):
         with patch('airflow.contrib.operators.mlengine_operator.MLEngineHook') \
@@ -280,7 +280,7 @@ def testFailedJobError(self):
             with self.assertRaises(RuntimeError) as context:
                 MLEngineBatchPredictionOperator(**task_args).execute(None)
 
-            self.assertEquals('A failure message', str(context.exception))
+            self.assertEqual('A failure message', str(context.exception))
 
 
 class MLEngineTrainingOperatorTest(unittest.TestCase):
@@ -320,7 +320,7 @@ def testSuccessCreateTrainingJob(self):
             mock_hook.assert_called_with(
                 gcp_conn_id='google_cloud_default', delegate_to=None)
             # Make sure only 'create_job' is invoked on hook instance
-            self.assertEquals(len(hook_instance.mock_calls), 1)
+            self.assertEqual(len(hook_instance.mock_calls), 1)
             hook_instance.create_job.assert_called_with(
                 'test-project', self.TRAINING_INPUT, ANY)
 
@@ -347,7 +347,7 @@ def testSuccessCreateTrainingJobWithOptionalArgs(self):
             mock_hook.assert_called_with(gcp_conn_id='google_cloud_default',
                                          delegate_to=None)
             # Make sure only 'create_job' is invoked on hook instance
-            self.assertEquals(len(hook_instance.mock_calls), 1)
+            self.assertEqual(len(hook_instance.mock_calls), 1)
             hook_instance.create_job.assert_called_with(
                 'test-project', training_input, ANY)
 
@@ -370,10 +370,10 @@ def testHttpError(self):
             mock_hook.assert_called_with(
                 gcp_conn_id='google_cloud_default', delegate_to=None)
             # Make sure only 'create_job' is invoked on hook instance
-            self.assertEquals(len(hook_instance.mock_calls), 1)
+            self.assertEqual(len(hook_instance.mock_calls), 1)
             hook_instance.create_job.assert_called_with(
                 'test-project', self.TRAINING_INPUT, ANY)
-            self.assertEquals(http_error_code, context.exception.resp.status)
+            self.assertEqual(http_error_code, context.exception.resp.status)
 
     def testFailedJobError(self):
         with patch('airflow.contrib.operators.mlengine_operator.MLEngineHook') \
@@ -392,10 +392,10 @@ def testFailedJobError(self):
             mock_hook.assert_called_with(
                 gcp_conn_id='google_cloud_default', delegate_to=None)
             # Make sure only 'create_job' is invoked on hook instance
-            self.assertEquals(len(hook_instance.mock_calls), 1)
+            self.assertEqual(len(hook_instance.mock_calls), 1)
             hook_instance.create_job.assert_called_with(
                 'test-project', self.TRAINING_INPUT, ANY)
-            self.assertEquals('A failure message', str(context.exception))
+            self.assertEqual('A failure message', str(context.exception))
 
 
 class MLEngineVersionOperatorTest(unittest.TestCase):
@@ -425,7 +425,7 @@ def testSuccessCreateVersion(self):
             mock_hook.assert_called_with(gcp_conn_id='google_cloud_default',
                                          delegate_to=None)
             # Make sure only 'create_version' is invoked on hook instance
-            self.assertEquals(len(hook_instance.mock_calls), 1)
+            self.assertEqual(len(hook_instance.mock_calls), 1)
             hook_instance.create_version.assert_called_with(
                 'test-project', 'test-model', self.VERSION_INPUT)
 
diff --git a/tests/contrib/operators/test_pubsub_operator.py b/tests/contrib/operators/test_pubsub_operator.py
index 26424b46881d6..4503971ee564b 100644
--- a/tests/contrib/operators/test_pubsub_operator.py
+++ b/tests/contrib/operators/test_pubsub_operator.py
@@ -101,7 +101,7 @@ def test_execute(self, mock_hook):
         mock_hook.return_value.create_subscription.assert_called_once_with(
             TEST_PROJECT, TEST_TOPIC, TEST_SUBSCRIPTION, None,
             10, False)
-        self.assertEquals(response, TEST_SUBSCRIPTION)
+        self.assertEqual(response, TEST_SUBSCRIPTION)
 
     @mock.patch('airflow.contrib.operators.pubsub_operator.PubSubHook')
     def test_execute_different_project_ids(self, mock_hook):
@@ -116,7 +116,7 @@ def test_execute_different_project_ids(self, mock_hook):
         mock_hook.return_value.create_subscription.assert_called_once_with(
             TEST_PROJECT, TEST_TOPIC, TEST_SUBSCRIPTION, another_project,
             10, False)
-        self.assertEquals(response, TEST_SUBSCRIPTION)
+        self.assertEqual(response, TEST_SUBSCRIPTION)
 
     @mock.patch('airflow.contrib.operators.pubsub_operator.PubSubHook')
     def test_execute_no_subscription(self, mock_hook):
@@ -127,7 +127,7 @@ def test_execute_no_subscription(self, mock_hook):
         response = operator.execute(None)
         mock_hook.return_value.create_subscription.assert_called_once_with(
             TEST_PROJECT, TEST_TOPIC, None, None, 10, False)
-        self.assertEquals(response, TEST_SUBSCRIPTION)
+        self.assertEqual(response, TEST_SUBSCRIPTION)
 
 
 class PubSubSubscriptionDeleteOperatorTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_ssh_operator.py b/tests/contrib/operators/test_ssh_operator.py
index 00c4be679bb4b..a8b6841f11282 100644
--- a/tests/contrib/operators/test_ssh_operator.py
+++ b/tests/contrib/operators/test_ssh_operator.py
@@ -74,8 +74,8 @@ def test_hook_created_correctly(self):
 
         task.execute(None)
 
-        self.assertEquals(TIMEOUT, task.ssh_hook.timeout)
-        self.assertEquals(SSH_ID, task.ssh_hook.ssh_conn_id)
+        self.assertEqual(TIMEOUT, task.ssh_hook.timeout)
+        self.assertEqual(SSH_ID, task.ssh_hook.ssh_conn_id)
 
     def test_json_command_execution(self):
         configuration.conf.set("core", "enable_xcom_pickling", "False")
diff --git a/tests/contrib/sensors/test_pubsub_sensor.py b/tests/contrib/sensors/test_pubsub_sensor.py
index 1973b0453ab76..a6931a0836b11 100644
--- a/tests/contrib/sensors/test_pubsub_sensor.py
+++ b/tests/contrib/sensors/test_pubsub_sensor.py
@@ -66,7 +66,7 @@ def test_poke_no_messages(self, mock_hook):
         operator = PubSubPullSensor(task_id=TASK_ID, project=TEST_PROJECT,
                                     subscription=TEST_SUBSCRIPTION)
         mock_hook.return_value.pull.return_value = []
-        self.assertEquals([], operator.poke(None))
+        self.assertEqual([], operator.poke(None))
 
     @mock.patch('airflow.contrib.sensors.pubsub_sensor.PubSubHook')
     def test_poke_with_ack_messages(self, mock_hook):
@@ -75,7 +75,7 @@ def test_poke_with_ack_messages(self, mock_hook):
                                     ack_messages=True)
         generated_messages = self._generate_messages(5)
         mock_hook.return_value.pull.return_value = generated_messages
-        self.assertEquals(generated_messages, operator.poke(None))
+        self.assertEqual(generated_messages, operator.poke(None))
         mock_hook.return_value.acknowledge.assert_called_with(
             TEST_PROJECT, TEST_SUBSCRIPTION, ['1', '2', '3', '4', '5']
         )
@@ -90,7 +90,7 @@ def test_execute(self, mock_hook):
         response = operator.execute(None)
         mock_hook.return_value.pull.assert_called_with(
             TEST_PROJECT, TEST_SUBSCRIPTION, 5, False)
-        self.assertEquals(response, generated_messages)
+        self.assertEqual(response, generated_messages)
 
     @mock.patch('airflow.contrib.sensors.pubsub_sensor.PubSubHook')
     def test_execute_timeout(self, mock_hook):
diff --git a/tests/core.py b/tests/core.py
index 4e9bcf177ef0f..6428a6a7fa5e3 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -660,26 +660,26 @@ def test_task_get_template(self):
         context = ti.get_template_context()
 
         # DEFAULT DATE is 2015-01-01
-        self.assertEquals(context['ds'], '2015-01-01')
-        self.assertEquals(context['ds_nodash'], '20150101')
+        self.assertEqual(context['ds'], '2015-01-01')
+        self.assertEqual(context['ds_nodash'], '20150101')
 
         # next_ds is 2015-01-02 as the dag interval is daily
-        self.assertEquals(context['next_ds'], '2015-01-02')
-        self.assertEquals(context['next_ds_nodash'], '20150102')
+        self.assertEqual(context['next_ds'], '2015-01-02')
+        self.assertEqual(context['next_ds_nodash'], '20150102')
 
         # prev_ds is 2014-12-31 as the dag interval is daily
-        self.assertEquals(context['prev_ds'], '2014-12-31')
-        self.assertEquals(context['prev_ds_nodash'], '20141231')
+        self.assertEqual(context['prev_ds'], '2014-12-31')
+        self.assertEqual(context['prev_ds_nodash'], '20141231')
 
-        self.assertEquals(context['ts'], '2015-01-01T00:00:00+00:00')
-        self.assertEquals(context['ts_nodash'], '20150101T000000')
-        self.assertEquals(context['ts_nodash_with_tz'], '20150101T000000+0000')
+        self.assertEqual(context['ts'], '2015-01-01T00:00:00+00:00')
+        self.assertEqual(context['ts_nodash'], '20150101T000000')
+        self.assertEqual(context['ts_nodash_with_tz'], '20150101T000000+0000')
 
-        self.assertEquals(context['yesterday_ds'], '2014-12-31')
-        self.assertEquals(context['yesterday_ds_nodash'], '20141231')
+        self.assertEqual(context['yesterday_ds'], '2014-12-31')
+        self.assertEqual(context['yesterday_ds_nodash'], '20141231')
 
-        self.assertEquals(context['tomorrow_ds'], '2015-01-02')
-        self.assertEquals(context['tomorrow_ds_nodash'], '20150102')
+        self.assertEqual(context['tomorrow_ds'], '2015-01-02')
+        self.assertEqual(context['tomorrow_ds_nodash'], '20150102')
 
     def test_import_examples(self):
         self.assertEqual(len(self.dagbag.dags), NUM_EXAMPLE_DAGS)
@@ -1050,9 +1050,9 @@ def payload_generator(context, object):
         task.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
         dag_runs = models.DagRun.find(dag_id='example_bash_operator',
                                       run_id=run_id)
-        self.assertEquals(len(dag_runs), 1)
+        self.assertEqual(len(dag_runs), 1)
         dag_run = dag_runs[0]
-        self.assertEquals(dag_run.execution_date, utc_now)
+        self.assertEqual(dag_run.execution_date, utc_now)
 
     def test_trigger_dagrun_with_str_execution_date(self):
         utc_now_str = timezone.utcnow().isoformat()
@@ -1072,9 +1072,9 @@ def payload_generator(context, object):
         task.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
         dag_runs = models.DagRun.find(dag_id='example_bash_operator',
                                       run_id=run_id)
-        self.assertEquals(len(dag_runs), 1)
+        self.assertEqual(len(dag_runs), 1)
         dag_run = dag_runs[0]
-        self.assertEquals(dag_run.execution_date.isoformat(), utc_now_str)
+        self.assertEqual(dag_run.execution_date.isoformat(), utc_now_str)
 
     def test_trigger_dagrun_with_templated_execution_date(self):
         task = TriggerDagRunOperator(
@@ -1116,11 +1116,11 @@ def test_externally_triggered_dagrun(self):
         context = ti.get_template_context()
 
         # next_ds/prev_ds should be the execution date for manually triggered runs
-        self.assertEquals(context['next_ds'], EXECUTION_DS)
-        self.assertEquals(context['next_ds_nodash'], EXECUTION_DS_NODASH)
+        self.assertEqual(context['next_ds'], EXECUTION_DS)
+        self.assertEqual(context['next_ds_nodash'], EXECUTION_DS_NODASH)
 
-        self.assertEquals(context['prev_ds'], EXECUTION_DS)
-        self.assertEquals(context['prev_ds_nodash'], EXECUTION_DS_NODASH)
+        self.assertEqual(context['prev_ds'], EXECUTION_DS)
+        self.assertEqual(context['prev_ds_nodash'], EXECUTION_DS_NODASH)
 
 
 class CliTests(unittest.TestCase):
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 954e17ca03a97..caa00c912cb33 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -104,8 +104,8 @@ def fake_execute_command():
         value_tuple = 'command', '_', 'queue', 'should_be_a_simple_ti'
         executor.queued_tasks['key'] = value_tuple
         executor.heartbeat()
-        self.assertEquals(1, len(executor.queued_tasks))
-        self.assertEquals(executor.queued_tasks['key'], value_tuple)
+        self.assertEqual(1, len(executor.queued_tasks))
+        self.assertEqual(executor.queued_tasks['key'], value_tuple)
 
     def test_exception_propagation(self):
         @app.task
diff --git a/tests/hooks/test_druid_hook.py b/tests/hooks/test_druid_hook.py
index 4243343b88227..3d90c8e25709c 100644
--- a/tests/hooks/test_druid_hook.py
+++ b/tests/hooks/test_druid_hook.py
@@ -132,7 +132,7 @@ def test_get_conn_url(self, mock_get_connection):
         get_conn_value.extra_dejson = {'endpoint': 'ingest'}
         mock_get_connection.return_value = get_conn_value
         hook = DruidHook(timeout=1, max_ingestion_time=5)
-        self.assertEquals(hook.get_conn_url(), 'https://test_host:1/ingest')
+        self.assertEqual(hook.get_conn_url(), 'https://test_host:1/ingest')
 
 
 class TestDruidDbApiHook(unittest.TestCase):
@@ -158,7 +158,7 @@ def get_connection(self, conn_id):
 
     def test_get_uri(self):
         db_hook = self.db_hook()
-        self.assertEquals('druid://host:1000/druid/v2/sql', db_hook.get_uri())
+        self.assertEqual('druid://host:1000/druid/v2/sql', db_hook.get_uri())
 
     def test_get_first_record(self):
         statement = 'SQL'
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index dc34ea21f3bb1..ca325940dcb4e 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -82,7 +82,7 @@ def test_raise_for_status_with_200(self, m):
         ):
 
             resp = self.get_hook.run('v1/test')
-            self.assertEquals(resp.text, '{"status":{"status": 200}}')
+            self.assertEqual(resp.text, '{"status":{"status": 200}}')
 
     @requests_mock.mock()
     @mock.patch('requests.Request')
@@ -125,7 +125,7 @@ def test_get_request_do_not_raise_for_status_if_check_response_is_false(self, m)
             side_effect=get_airflow_connection
         ):
             resp = self.get_hook.run('v1/test', extra_options={'check_response': False})
-            self.assertEquals(resp.text, '{"status":{"status": 404}}')
+            self.assertEqual(resp.text, '{"status":{"status": 404}}')
 
     @requests_mock.mock()
     def test_hook_contains_header_from_extra_field(self, m):
@@ -136,7 +136,7 @@ def test_hook_contains_header_from_extra_field(self, m):
             expected_conn = get_airflow_connection()
             conn = self.get_hook.get_conn()
             self.assertDictContainsSubset(json.loads(expected_conn.extra), conn.headers)
-            self.assertEquals(conn.headers.get('bareer'), 'test')
+            self.assertEqual(conn.headers.get('bareer'), 'test')
 
     @requests_mock.mock()
     def test_hook_uses_provided_header(self, m):
@@ -155,7 +155,7 @@ def test_hooks_header_from_extra_is_overridden(self, m):
             side_effect=get_airflow_connection
         ):
             conn = self.get_hook.get_conn(headers={"bareer": "newT0k3n"})
-            self.assertEquals(conn.headers.get('bareer'), 'newT0k3n')
+            self.assertEqual(conn.headers.get('bareer'), 'newT0k3n')
 
     @requests_mock.mock()
     def test_post_request(self, m):
@@ -172,7 +172,7 @@ def test_post_request(self, m):
             side_effect=get_airflow_connection
         ):
             resp = self.post_hook.run('v1/test')
-            self.assertEquals(resp.status_code, 200)
+            self.assertEqual(resp.status_code, 200)
 
     @requests_mock.mock()
     def test_post_request_with_error_code(self, m):
@@ -206,7 +206,7 @@ def test_post_request_do_not_raise_for_status_if_check_response_is_false(self, m
             side_effect=get_airflow_connection
         ):
             resp = self.post_hook.run('v1/test', extra_options={'check_response': False})
-            self.assertEquals(resp.status_code, 418)
+            self.assertEqual(resp.status_code, 418)
 
     @mock.patch('airflow.hooks.http_hook.requests.Session')
     def test_retry_on_conn_error(self, mocked_session):
@@ -227,7 +227,7 @@ def send_and_raise(request, **kwargs):
                 endpoint='v1/test',
                 _retry_args=retry_args
             )
-        self.assertEquals(
+        self.assertEqual(
             self.get_hook._retry_obj.stop.max_attempt_number + 1,
             mocked_session.call_count
         )
@@ -248,8 +248,8 @@ def run_and_return(session, prepped_request, extra_options, **kwargs):
             ):
                 pr = self.get_hook.run('v1/test', headers={'some_other_header': 'test'})
                 actual = dict(pr.headers)
-                self.assertEquals(actual.get('bareer'), 'test')
-                self.assertEquals(actual.get('some_other_header'), 'test')
+                self.assertEqual(actual.get('bareer'), 'test')
+                self.assertEqual(actual.get('some_other_header'), 'test')
 
     @mock.patch('airflow.hooks.http_hook.HttpHook.get_connection')
     def test_http_connection(self, mock_get_connection):
diff --git a/tests/macros/test_hive.py b/tests/macros/test_hive.py
index 73e42717fa837..c3c4506b0bc61 100644
--- a/tests/macros/test_hive.py
+++ b/tests/macros/test_hive.py
@@ -33,13 +33,13 @@ def test_closest_ds_partition(self):
         target_dt = datetime.strptime('2017-04-27', '%Y-%m-%d')
         date_list = [d1, d2, d3, d4, d5]
 
-        self.assertEquals("2017-04-26", str(hive._closest_date(target_dt, date_list, True)))
-        self.assertEquals("2017-04-28", str(hive._closest_date(target_dt, date_list, False)))
+        self.assertEqual("2017-04-26", str(hive._closest_date(target_dt, date_list, True)))
+        self.assertEqual("2017-04-28", str(hive._closest_date(target_dt, date_list, False)))
 
         # when before is not set, the closest date should be returned
-        self.assertEquals("2017-04-26", str(hive._closest_date(target_dt, [d1, d2, d3, d5], None)))
-        self.assertEquals("2017-04-28", str(hive._closest_date(target_dt, [d1, d2, d4, d5])))
-        self.assertEquals("2017-04-26", str(hive._closest_date(target_dt, date_list)))
+        self.assertEqual("2017-04-26", str(hive._closest_date(target_dt, [d1, d2, d3, d5], None)))
+        self.assertEqual("2017-04-28", str(hive._closest_date(target_dt, [d1, d2, d4, d5])))
+        self.assertEqual("2017-04-26", str(hive._closest_date(target_dt, date_list)))
 
 
 if __name__ == '__main__':
diff --git a/tests/models.py b/tests/models.py
index 82adec275bb66..ea3e3aefa5ea7 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -232,7 +232,7 @@ def test_dag_topological_sort(self):
             start_date=DEFAULT_DATE,
             default_args={'owner': 'owner1'})
 
-        self.assertEquals(tuple(), dag.topological_sort())
+        self.assertEqual(tuple(), dag.topological_sort())
 
     def test_dag_naive_default_args_start_date(self):
         dag = DAG('DAG', default_args={'start_date': datetime.datetime(2018, 1, 1)})
@@ -277,7 +277,7 @@ def test_dag_task_priority_weight_total(self):
                 correct_weight = ((depth - (task_depth + 1)) * width + 1) * weight
 
                 calculated_weight = task.priority_weight_total
-                self.assertEquals(calculated_weight, correct_weight)
+                self.assertEqual(calculated_weight, correct_weight)
 
         # Same test as above except use 'upstream' for weight calculation
         weight = 3
@@ -303,7 +303,7 @@ def test_dag_task_priority_weight_total(self):
                 correct_weight = (task_depth * width + 1) * weight
 
                 calculated_weight = task.priority_weight_total
-                self.assertEquals(calculated_weight, correct_weight)
+                self.assertEqual(calculated_weight, correct_weight)
 
         # Same test as above except use 'absolute' for weight calculation
         weight = 10
@@ -329,7 +329,7 @@ def test_dag_task_priority_weight_total(self):
                 correct_weight = weight
 
                 calculated_weight = task.priority_weight_total
-                self.assertEquals(calculated_weight, correct_weight)
+                self.assertEqual(calculated_weight, correct_weight)
 
         # Test if we enter an invalid weight rule
         with DAG('dag', start_date=DEFAULT_DATE,
@@ -1027,7 +1027,7 @@ def test_clear_task_instances_for_backfill_dagrun(self):
             DagRun.dag_id == dag_id,
             DagRun.execution_date == now
         ).first()
-        self.assertEquals(dr0.state, State.RUNNING)
+        self.assertEqual(dr0.state, State.RUNNING)
 
     def test_id_for_date(self):
         run_id = models.DagRun.id_for_date(
@@ -1489,20 +1489,20 @@ def with_all_tasks_removed(dag):
 
         dagrun = self.create_dag_run(dag)
         flaky_ti = dagrun.get_task_instances()[0]
-        self.assertEquals('flaky_task', flaky_ti.task_id)
-        self.assertEquals(State.NONE, flaky_ti.state)
+        self.assertEqual('flaky_task', flaky_ti.task_id)
+        self.assertEqual(State.NONE, flaky_ti.state)
 
         dagrun.dag = with_all_tasks_removed(dag)
 
         dagrun.verify_integrity()
         flaky_ti.refresh_from_db()
-        self.assertEquals(State.NONE, flaky_ti.state)
+        self.assertEqual(State.NONE, flaky_ti.state)
 
         dagrun.dag.add_task(DummyOperator(task_id='flaky_task', owner='test'))
 
         dagrun.verify_integrity()
         flaky_ti.refresh_from_db()
-        self.assertEquals(State.NONE, flaky_ti.state)
+        self.assertEqual(State.NONE, flaky_ti.state)
 
 
 class DagBagTest(unittest.TestCase):
@@ -1700,12 +1700,12 @@ def validate_dags(self, expected_parent_dag, actual_found_dags, actual_dagbag,
 
         for dag_id in expected_dag_ids:
             actual_dagbag.log.info('validating %s' % dag_id)
-            self.assertEquals(
+            self.assertEqual(
                 dag_id in actual_found_dag_ids, should_be_found,
                 'dag "%s" should %shave been found after processing dag "%s"' %
                 (dag_id, '' if should_be_found else 'not ', expected_parent_dag.dag_id)
             )
-            self.assertEquals(
+            self.assertEqual(
                 dag_id in actual_dagbag.dags, should_be_found,
                 'dag "%s" should %sbe in dagbag.dags after processing dag "%s"' %
                 (dag_id, '' if should_be_found else 'not ', expected_parent_dag.dag_id)
@@ -2044,7 +2044,7 @@ def test_deactivate_unknown_dags(self):
             if dag.dag_id in expected_active_dags:
                 self.assertTrue(dag.is_active)
             else:
-                self.assertEquals(dag.dag_id, 'test_deactivate_unknown_dags')
+                self.assertEqual(dag.dag_id, 'test_deactivate_unknown_dags')
                 self.assertFalse(dag.is_active)
 
         # clean up
@@ -2106,7 +2106,7 @@ def test_timezone_awareness(self):
         op_no_dag = DummyOperator(task_id='op_no_dag')
         ti = TI(task=op_no_dag, execution_date=NAIVE_DATETIME)
 
-        self.assertEquals(ti.execution_date, DEFAULT_DATE)
+        self.assertEqual(ti.execution_date, DEFAULT_DATE)
 
         # check with dag without localized execution_date
         dag = DAG('dag', start_date=DEFAULT_DATE)
@@ -2114,14 +2114,14 @@ def test_timezone_awareness(self):
         dag.add_task(op1)
         ti = TI(task=op1, execution_date=NAIVE_DATETIME)
 
-        self.assertEquals(ti.execution_date, DEFAULT_DATE)
+        self.assertEqual(ti.execution_date, DEFAULT_DATE)
 
         # with dag and localized execution_date
         tz = pendulum.timezone("Europe/Amsterdam")
         execution_date = timezone.datetime(2016, 1, 1, 1, 0, 0, tzinfo=tz)
         utc_date = timezone.convert_to_utc(execution_date)
         ti = TI(task=op1, execution_date=execution_date)
-        self.assertEquals(ti.execution_date, utc_date)
+        self.assertEqual(ti.execution_date, utc_date)
 
     def test_task_naive_datetime(self):
         NAIVE_DATETIME = DEFAULT_DATE.replace(tzinfo=None)
@@ -2805,9 +2805,9 @@ def test_get_num_running_task_instances(self):
         session.add(ti3)
         session.commit()
 
-        self.assertEquals(1, ti1.get_num_running_task_instances(session=session))
-        self.assertEquals(1, ti2.get_num_running_task_instances(session=session))
-        self.assertEquals(1, ti3.get_num_running_task_instances(session=session))
+        self.assertEqual(1, ti1.get_num_running_task_instances(session=session))
+        self.assertEqual(1, ti2.get_num_running_task_instances(session=session))
+        self.assertEqual(1, ti3.get_num_running_task_instances(session=session))
 
     def test_log_url(self):
         now = pendulum.now('Europe/Brussels')
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index dd830b899c13d..ecc3f73194f9d 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -131,11 +131,11 @@ def test_python_operator_shallow_copy_attr(self):
         )
         new_task = copy.deepcopy(original_task)
         # shallow copy op_kwargs
-        self.assertEquals(id(original_task.op_kwargs['certain_attrs']),
-                          id(new_task.op_kwargs['certain_attrs']))
+        self.assertEqual(id(original_task.op_kwargs['certain_attrs']),
+                         id(new_task.op_kwargs['certain_attrs']))
         # shallow copy python_callable
-        self.assertEquals(id(original_task.python_callable),
-                          id(new_task.python_callable))
+        self.assertEqual(id(original_task.python_callable),
+                         id(new_task.python_callable))
 
     def _env_var_check_callback(self):
         self.assertEqual('test_dag', os.environ['AIRFLOW_CTX_DAG_ID'])
@@ -218,12 +218,12 @@ def test_without_dag_run(self):
 
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'branch_1':
                 # should exist with state None
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
             elif ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.SKIPPED)
+                self.assertEqual(ti.state, State.SKIPPED)
             else:
                 raise
 
@@ -256,7 +256,7 @@ def test_branch_list_without_dag_run(self):
 
         for ti in tis:
             if ti.task_id in expected:
-                self.assertEquals(ti.state, expected[ti.task_id])
+                self.assertEqual(ti.state, expected[ti.task_id])
             else:
                 raise
 
@@ -281,11 +281,11 @@ def test_with_dag_run(self):
         tis = dr.get_task_instances()
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'branch_1':
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
             elif ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.SKIPPED)
+                self.assertEqual(ti.state, State.SKIPPED)
             else:
                 raise
 
@@ -342,12 +342,12 @@ def test_without_dag_run(self):
 
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'upstream':
                 # should not exist
                 raise
             elif ti.task_id == 'branch_1' or ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.SKIPPED)
+                self.assertEqual(ti.state, State.SKIPPED)
             else:
                 raise
 
@@ -357,12 +357,12 @@ def test_without_dag_run(self):
         short_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'upstream':
                 # should not exist
                 raise
             elif ti.task_id == 'branch_1' or ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
             else:
                 raise
 
@@ -402,11 +402,11 @@ def test_with_dag_run(self):
         self.assertEqual(len(tis), 4)
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'upstream':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'branch_1' or ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.SKIPPED)
+                self.assertEqual(ti.state, State.SKIPPED)
             else:
                 raise
 
@@ -420,10 +420,10 @@ def test_with_dag_run(self):
         self.assertEqual(len(tis), 4)
         for ti in tis:
             if ti.task_id == 'make_choice':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'upstream':
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             elif ti.task_id == 'branch_1' or ti.task_id == 'branch_2':
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
             else:
                 raise
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index 239d1b7c4d447..451c95e5d11a4 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -106,12 +106,12 @@ def test_ok(self):
 
         self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_fail(self):
         sensor = self._make_sensor(False)
@@ -120,12 +120,12 @@ def test_fail(self):
         with self.assertRaises(AirflowSensorTimeout):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.FAILED)
+                self.assertEqual(ti.state, State.FAILED)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_soft_fail(self):
         sensor = self._make_sensor(False, soft_fail=True)
@@ -133,9 +133,9 @@ def test_soft_fail(self):
 
         self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
-            self.assertEquals(ti.state, State.SKIPPED)
+            self.assertEqual(ti.state, State.SKIPPED)
 
     def test_soft_fail_with_retries(self):
         sensor = self._make_sensor(
@@ -149,20 +149,20 @@ def test_soft_fail_with_retries(self):
         with self.assertRaises(AirflowSensorTimeout):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RETRY)
+                self.assertEqual(ti.state, State.UP_FOR_RETRY)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         sleep(0.001)
         # after retry DAG run is skipped
         self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
-            self.assertEquals(ti.state, State.SKIPPED)
+            self.assertEqual(ti.state, State.SKIPPED)
 
     def test_ok_with_reschedule(self):
         sensor = self._make_sensor(
@@ -178,56 +178,56 @@ def test_ok_with_reschedule(self):
         with freeze_time(date1):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify task start date is the initial one
-                self.assertEquals(ti.start_date, date1)
+                self.assertEqual(ti.start_date, date1)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 1)
-                self.assertEquals(task_reschedules[0].start_date, date1)
-                self.assertEquals(task_reschedules[0].reschedule_date,
-                                  date1 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(len(task_reschedules), 1)
+                self.assertEqual(task_reschedules[0].start_date, date1)
+                self.assertEqual(task_reschedules[0].reschedule_date,
+                                 date1 + timedelta(seconds=sensor.poke_interval))
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # second poke returns False and task is re-scheduled
         date2 = date1 + timedelta(seconds=sensor.poke_interval)
         with freeze_time(date2):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify task start date is the initial one
-                self.assertEquals(ti.start_date, date1)
+                self.assertEqual(ti.start_date, date1)
                 # verify two rows in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 2)
-                self.assertEquals(task_reschedules[1].start_date, date2)
-                self.assertEquals(task_reschedules[1].reschedule_date,
-                                  date2 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(len(task_reschedules), 2)
+                self.assertEqual(task_reschedules[1].start_date, date2)
+                self.assertEqual(task_reschedules[1].reschedule_date,
+                                 date2 + timedelta(seconds=sensor.poke_interval))
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # third poke returns True and task succeeds
         date3 = date2 + timedelta(seconds=sensor.poke_interval)
         with freeze_time(date3):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
                 # verify task start date is the initial one
-                self.assertEquals(ti.start_date, date1)
+                self.assertEqual(ti.start_date, date1)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_fail_with_reschedule(self):
         sensor = self._make_sensor(
@@ -242,12 +242,12 @@ def test_fail_with_reschedule(self):
         with freeze_time(date1):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # second poke returns False, timeout occurs
         date2 = date1 + timedelta(seconds=sensor.poke_interval)
@@ -255,12 +255,12 @@ def test_fail_with_reschedule(self):
             with self.assertRaises(AirflowSensorTimeout):
                 self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.FAILED)
+                self.assertEqual(ti.state, State.FAILED)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_soft_fail_with_reschedule(self):
         sensor = self._make_sensor(
@@ -276,21 +276,21 @@ def test_soft_fail_with_reschedule(self):
         with freeze_time(date1):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # second poke returns False, timeout occurs
         date2 = date1 + timedelta(seconds=sensor.poke_interval)
         with freeze_time(date2):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
-            self.assertEquals(ti.state, State.SKIPPED)
+            self.assertEqual(ti.state, State.SKIPPED)
 
     def test_ok_with_reschedule_and_retry(self):
         sensor = self._make_sensor(
@@ -308,19 +308,19 @@ def test_ok_with_reschedule_and_retry(self):
         with freeze_time(date1):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 1)
-                self.assertEquals(task_reschedules[0].start_date, date1)
-                self.assertEquals(task_reschedules[0].reschedule_date,
-                                  date1 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(len(task_reschedules), 1)
+                self.assertEqual(task_reschedules[0].start_date, date1)
+                self.assertEqual(task_reschedules[0].reschedule_date,
+                                 date1 + timedelta(seconds=sensor.poke_interval))
                 self.assertEqual(task_reschedules[0].try_number, 1)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # second poke fails and task instance is marked up to retry
         date2 = date1 + timedelta(seconds=sensor.poke_interval)
@@ -328,43 +328,43 @@ def test_ok_with_reschedule_and_retry(self):
             with self.assertRaises(AirflowSensorTimeout):
                 self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RETRY)
+                self.assertEqual(ti.state, State.UP_FOR_RETRY)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # third poke returns False and task is rescheduled again
         date3 = date2 + timedelta(seconds=sensor.poke_interval) + sensor.retry_delay
         with freeze_time(date3):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 1)
-                self.assertEquals(task_reschedules[0].start_date, date3)
-                self.assertEquals(task_reschedules[0].reschedule_date,
-                                  date3 + timedelta(seconds=sensor.poke_interval))
+                self.assertEqual(len(task_reschedules), 1)
+                self.assertEqual(task_reschedules[0].start_date, date3)
+                self.assertEqual(task_reschedules[0].reschedule_date,
+                                 date3 + timedelta(seconds=sensor.poke_interval))
                 self.assertEqual(task_reschedules[0].try_number, 2)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # fourth poke return True and task succeeds
         date4 = date3 + timedelta(seconds=sensor.poke_interval)
         with freeze_time(date4):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_should_include_ready_to_reschedule_dep(self):
         sensor = self._make_sensor(True)
@@ -395,46 +395,46 @@ def test_ok_with_custom_reschedule_exception(self):
         with freeze_time(date1):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify one row in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 1)
-                self.assertEquals(task_reschedules[0].start_date, date1)
-                self.assertEquals(task_reschedules[0].reschedule_date, date2)
+                self.assertEqual(len(task_reschedules), 1)
+                self.assertEqual(task_reschedules[0].start_date, date1)
+                self.assertEqual(task_reschedules[0].reschedule_date, date2)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # second poke returns False and task is re-scheduled
         with freeze_time(date2):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # verify task is re-scheduled, i.e. state set to NONE
-                self.assertEquals(ti.state, State.UP_FOR_RESCHEDULE)
+                self.assertEqual(ti.state, State.UP_FOR_RESCHEDULE)
                 # verify two rows in task_reschedule table
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 2)
-                self.assertEquals(task_reschedules[1].start_date, date2)
-                self.assertEquals(task_reschedules[1].reschedule_date, date3)
+                self.assertEqual(len(task_reschedules), 2)
+                self.assertEqual(task_reschedules[1].start_date, date2)
+                self.assertEqual(task_reschedules[1].reschedule_date, date3)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
         # third poke returns True and task succeeds
         with freeze_time(date3):
             self._run(sensor)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
-                self.assertEquals(ti.state, State.SUCCESS)
+                self.assertEqual(ti.state, State.SUCCESS)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
 
     def test_reschedule_with_test_mode(self):
         sensor = self._make_sensor(
@@ -453,13 +453,13 @@ def test_reschedule_with_test_mode(self):
                     ignore_ti_state=True,
                     test_mode=True)
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
         for ti in tis:
             if ti.task_id == SENSOR_OP:
                 # in test mode state is not modified
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
                 # in test mode no reschedule request is recorded
                 task_reschedules = TaskReschedule.find_for_task_instance(ti)
-                self.assertEquals(len(task_reschedules), 0)
+                self.assertEqual(len(task_reschedules), 0)
             if ti.task_id == DUMMY_OP:
-                self.assertEquals(ti.state, State.NONE)
+                self.assertEqual(ti.state, State.NONE)
diff --git a/tests/test_configuration.py b/tests/test_configuration.py
index 58113f126cdf1..a768f3083b805 100644
--- a/tests/test_configuration.py
+++ b/tests/test_configuration.py
@@ -255,12 +255,12 @@ def test_deprecated_options(self):
 
         with self.assertWarns(DeprecationWarning):
             os.environ['AIRFLOW__CELERY__CELERYD_CONCURRENCY'] = '99'
-            self.assertEquals(conf.getint('celery', 'worker_concurrency'), 99)
+            self.assertEqual(conf.getint('celery', 'worker_concurrency'), 99)
             os.environ.pop('AIRFLOW__CELERY__CELERYD_CONCURRENCY')
 
         with self.assertWarns(DeprecationWarning):
             conf.set('celery', 'celeryd_concurrency', '99')
-            self.assertEquals(conf.getint('celery', 'worker_concurrency'), 99)
+            self.assertEqual(conf.getint('celery', 'worker_concurrency'), 99)
             conf.remove_option('celery', 'celeryd_concurrency')
 
     def test_deprecated_options_cmd(self):
@@ -276,7 +276,7 @@ def test_deprecated_options_cmd(self):
             tmp = None
             if 'AIRFLOW__CELERY__RESULT_BACKEND' in os.environ:
                 tmp = os.environ.pop('AIRFLOW__CELERY__RESULT_BACKEND')
-            self.assertEquals(conf.getint('celery', 'result_backend'), 99)
+            self.assertEqual(conf.getint('celery', 'result_backend'), 99)
             if tmp:
                 os.environ['AIRFLOW__CELERY__RESULT_BACKEND'] = tmp
 
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 784620bfcc350..6559c01285b18 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -105,7 +105,7 @@ def test_state_success(self):
         job = self.TestJob(lambda: True)
         job.run()
 
-        self.assertEquals(job.state, State.SUCCESS)
+        self.assertEqual(job.state, State.SUCCESS)
         self.assertIsNotNone(job.end_date)
 
     def test_state_sysexit(self):
@@ -113,7 +113,7 @@ def test_state_sysexit(self):
         job = self.TestJob(lambda: sys.exit(0))
         job.run()
 
-        self.assertEquals(job.state, State.SUCCESS)
+        self.assertEqual(job.state, State.SUCCESS)
         self.assertIsNotNone(job.end_date)
 
     def test_state_failed(self):
@@ -124,7 +124,7 @@ def abort():
         with self.assertRaises(RuntimeError):
             job.run()
 
-        self.assertEquals(job.state, State.FAILED)
+        self.assertEqual(job.state, State.FAILED)
         self.assertIsNotNone(job.end_date)
 
 
@@ -302,7 +302,7 @@ def test_backfill_run_rescheduled(self):
         ti = TI(task=dag.get_task('test_backfill_run_rescheduled_task-1'),
                 execution_date=DEFAULT_DATE)
         ti.refresh_from_db()
-        self.assertEquals(ti.state, State.SUCCESS)
+        self.assertEqual(ti.state, State.SUCCESS)
 
     def test_backfill_rerun_failed_tasks(self):
         dag = DAG(
@@ -341,7 +341,7 @@ def test_backfill_rerun_failed_tasks(self):
         ti = TI(task=dag.get_task('test_backfill_rerun_failed_task-1'),
                 execution_date=DEFAULT_DATE)
         ti.refresh_from_db()
-        self.assertEquals(ti.state, State.SUCCESS)
+        self.assertEqual(ti.state, State.SUCCESS)
 
     def test_backfill_rerun_upstream_failed_tasks(self):
         dag = DAG(
@@ -519,7 +519,7 @@ def test_backfill_depends_on_past(self):
         # ti should have succeeded
         ti = TI(dag.tasks[0], run_date)
         ti.refresh_from_db()
-        self.assertEquals(ti.state, State.SUCCESS)
+        self.assertEqual(ti.state, State.SUCCESS)
 
     def test_run_ignores_all_dependencies(self):
         """
@@ -542,7 +542,7 @@ def test_run_ignores_all_dependencies(self):
             execution_date=DEFAULT_DATE)
 
         ti_dependent0.refresh_from_db()
-        self.assertEquals(ti_dependent0.state, State.FAILED)
+        self.assertEqual(ti_dependent0.state, State.FAILED)
 
         task1_id = 'test_run_dependency_task'
         args1 = ['run',
@@ -556,7 +556,7 @@ def test_run_ignores_all_dependencies(self):
             task=dag.get_task(task1_id),
             execution_date=DEFAULT_DATE + datetime.timedelta(days=1))
         ti_dependency.refresh_from_db()
-        self.assertEquals(ti_dependency.state, State.FAILED)
+        self.assertEqual(ti_dependency.state, State.FAILED)
 
         task2_id = 'test_run_dependent_task'
         args2 = ['run',
@@ -570,7 +570,7 @@ def test_run_ignores_all_dependencies(self):
             task=dag.get_task(task2_id),
             execution_date=DEFAULT_DATE + datetime.timedelta(days=1))
         ti_dependent.refresh_from_db()
-        self.assertEquals(ti_dependent.state, State.SUCCESS)
+        self.assertEqual(ti_dependent.state, State.SUCCESS)
 
     def test_run_naive_taskinstance(self):
         """
@@ -595,7 +595,7 @@ def test_run_naive_taskinstance(self):
             execution_date=NAIVE_DATE)
 
         ti_dependent0.refresh_from_db()
-        self.assertEquals(ti_dependent0.state, State.FAILED)
+        self.assertEqual(ti_dependent0.state, State.FAILED)
 
     def test_cli_backfill_depends_on_past(self):
         """
@@ -1016,12 +1016,12 @@ def test_subdag_clear_parentdag_downstream_clear(self):
             include_parentdag=True)
 
         ti0.refresh_from_db()
-        self.assertEquals(State.NONE, ti0.state)
+        self.assertEqual(State.NONE, ti0.state)
 
         ti1 = TI(
             task=dag.get_task('some-other-task'),
             execution_date=DEFAULT_DATE)
-        self.assertEquals(State.NONE, ti1.state)
+        self.assertEqual(State.NONE, ti1.state)
 
         # Checks that all the Downstream tasks for Parent DAG
         # have been cleared
@@ -1030,7 +1030,7 @@ def test_subdag_clear_parentdag_downstream_clear(self):
                 task=dag.get_task(task.task_id),
                 execution_date=DEFAULT_DATE
             )
-            self.assertEquals(State.NONE, ti.state)
+            self.assertEqual(State.NONE, ti.state)
 
         subdag.clear()
         dag.clear()
@@ -1523,7 +1523,7 @@ def test_execute_task_instances_is_paused_wont_execute(self):
 
         scheduler._execute_task_instances(dagbag, [State.SCHEDULED])
         ti1.refresh_from_db()
-        self.assertEquals(State.SCHEDULED, ti1.state)
+        self.assertEqual(State.SCHEDULED, ti1.state)
 
     def test_execute_task_instances_no_dagrun_task_will_execute(self):
         """
@@ -1548,7 +1548,7 @@ def test_execute_task_instances_no_dagrun_task_will_execute(self):
 
         scheduler._execute_task_instances(dagbag, [State.SCHEDULED])
         ti1.refresh_from_db()
-        self.assertEquals(State.QUEUED, ti1.state)
+        self.assertEqual(State.QUEUED, ti1.state)
 
     def test_execute_task_instances_backfill_tasks_wont_execute(self):
         """
@@ -1577,7 +1577,7 @@ def test_execute_task_instances_backfill_tasks_wont_execute(self):
 
         scheduler._execute_task_instances(dagbag, [State.SCHEDULED])
         ti1.refresh_from_db()
-        self.assertEquals(State.SCHEDULED, ti1.state)
+        self.assertEqual(State.SCHEDULED, ti1.state)
 
     def test_find_executable_task_instances_backfill_nodagrun(self):
         dag_id = 'SchedulerJobTest.test_find_executable_task_instances_backfill_nodagrun'
@@ -2160,7 +2160,7 @@ def test_change_state_for_tis_without_dagrun(self):
         self.assertEqual(ti2.state, State.SCHEDULED)
 
         ti3.refresh_from_db(session=session)
-        self.assertEquals(ti3.state, State.NONE)
+        self.assertEqual(ti3.state, State.NONE)
 
         dr1.refresh_from_db(session=session)
         dr1.state = State.FAILED
@@ -2218,7 +2218,7 @@ def test_change_state_for_tasks_failed_to_execute(self):
         scheduler_job._change_state_for_tasks_failed_to_execute()
 
         ti.refresh_from_db()
-        self.assertEquals(State.SCHEDULED, ti.state)
+        self.assertEqual(State.SCHEDULED, ti.state)
 
         # Tasks failed to execute with RUNNING state will not be set to SCHEDULED state.
         session.query(TI).delete()
@@ -2231,7 +2231,7 @@ def test_change_state_for_tasks_failed_to_execute(self):
         scheduler_job._change_state_for_tasks_failed_to_execute()
 
         ti.refresh_from_db()
-        self.assertEquals(State.RUNNING, ti.state)
+        self.assertEqual(State.RUNNING, ti.state)
 
     def test_execute_helper_reset_orphaned_tasks(self):
         session = settings.Session()
@@ -2735,7 +2735,7 @@ def test_scheduler_add_new_task(self):
         self.assertIsNotNone(dr)
 
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 1)
+        self.assertEqual(len(tis), 1)
 
         DummyOperator(
             task_id='dummy2',
@@ -2746,7 +2746,7 @@ def test_scheduler_add_new_task(self):
         scheduler._process_task_instances(dag, queue=queue)
 
         tis = dr.get_task_instances()
-        self.assertEquals(len(tis), 2)
+        self.assertEqual(len(tis), 2)
 
     def test_scheduler_verify_max_active_runs(self):
         """
@@ -2809,7 +2809,7 @@ def test_scheduler_fail_dagrun_timeout(self):
         self.assertIsNotNone(dr2)
 
         dr.refresh_from_db(session=session)
-        self.assertEquals(dr.state, State.FAILED)
+        self.assertEqual(dr.state, State.FAILED)
 
     def test_scheduler_verify_max_active_runs_and_dagrun_timeout(self):
         """
@@ -2923,12 +2923,12 @@ def test_scheduler_verify_pool_full(self, mock_pool_full):
         # Create 2 dagruns, which will create 2 task instances.
         dr = scheduler.create_dag_run(dag)
         self.assertIsNotNone(dr)
-        self.assertEquals(dr.execution_date, DEFAULT_DATE)
+        self.assertEqual(dr.execution_date, DEFAULT_DATE)
         dr = scheduler.create_dag_run(dag)
         self.assertIsNotNone(dr)
         queue = []
         scheduler._process_task_instances(dag, queue=queue)
-        self.assertEquals(len(queue), 2)
+        self.assertEqual(len(queue), 2)
         dagbag = self._make_simple_dag_bag([dag])
 
         # Recreated part of the scheduler here, to kick off tasks -> executor
@@ -2947,7 +2947,7 @@ def test_scheduler_verify_pool_full(self, mock_pool_full):
                                           (State.SCHEDULED,
                                            State.UP_FOR_RETRY))
 
-        self.assertEquals(len(scheduler.executor.queued_tasks), 1)
+        self.assertEqual(len(scheduler.executor.queued_tasks), 1)
 
     def test_scheduler_auto_align(self):
         """
@@ -2976,7 +2976,7 @@ def test_scheduler_auto_align(self):
 
         dr = scheduler.create_dag_run(dag)
         self.assertIsNotNone(dr)
-        self.assertEquals(dr.execution_date, timezone.datetime(2016, 1, 2, 5, 4))
+        self.assertEqual(dr.execution_date, timezone.datetime(2016, 1, 2, 5, 4))
 
         dag = DAG(
             dag_id='test_scheduler_auto_align_2',
@@ -2998,7 +2998,7 @@ def test_scheduler_auto_align(self):
 
         dr = scheduler.create_dag_run(dag)
         self.assertIsNotNone(dr)
-        self.assertEquals(dr.execution_date, timezone.datetime(2016, 1, 1, 10, 10))
+        self.assertEqual(dr.execution_date, timezone.datetime(2016, 1, 1, 10, 10))
 
     def test_scheduler_reschedule(self):
         """
@@ -3044,11 +3044,11 @@ def do_schedule(function, function2):
             scheduler.run()
 
         do_schedule()
-        self.assertEquals(1, len(executor.queued_tasks))
+        self.assertEqual(1, len(executor.queued_tasks))
         executor.queued_tasks.clear()
 
         do_schedule()
-        self.assertEquals(2, len(executor.queued_tasks))
+        self.assertEqual(2, len(executor.queued_tasks))
 
     def test_scheduler_sla_miss_callback(self):
         """
@@ -3216,7 +3216,7 @@ def do_schedule(function, function2):
             scheduler.run()
 
         do_schedule()
-        self.assertEquals(1, len(executor.queued_tasks))
+        self.assertEqual(1, len(executor.queued_tasks))
 
         def run_with_error(task):
             try:
@@ -3659,7 +3659,7 @@ def test_reset_orphaned_tasks_external_triggered_dag(self):
         session.commit()
 
         reset_tis = scheduler.reset_state_for_orphaned_tasks(session=session)
-        self.assertEquals(1, len(reset_tis))
+        self.assertEqual(1, len(reset_tis))
 
     def test_reset_orphaned_tasks_backfill_dag(self):
         dag_id = 'test_reset_orphaned_tasks_backfill_dag'
@@ -3680,7 +3680,7 @@ def test_reset_orphaned_tasks_backfill_dag(self):
         session.commit()
 
         self.assertTrue(dr1.is_backfill)
-        self.assertEquals(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
+        self.assertEqual(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
 
     def test_reset_orphaned_tasks_specified_dagrun(self):
         """Try to reset when we specify a dagrun and ensure nothing else is."""
@@ -3708,11 +3708,11 @@ def test_reset_orphaned_tasks_specified_dagrun(self):
         session.commit()
 
         reset_tis = scheduler.reset_state_for_orphaned_tasks(filter_by_dag_run=dr2, session=session)
-        self.assertEquals(1, len(reset_tis))
+        self.assertEqual(1, len(reset_tis))
         ti1.refresh_from_db(session=session)
         ti2.refresh_from_db(session=session)
-        self.assertEquals(State.SCHEDULED, ti1.state)
-        self.assertEquals(State.NONE, ti2.state)
+        self.assertEqual(State.SCHEDULED, ti1.state)
+        self.assertEqual(State.NONE, ti2.state)
 
     def test_reset_orphaned_tasks_nonexistent_dagrun(self):
         """Make sure a task in an orphaned state is not reset if it has no dagrun. """
@@ -3733,7 +3733,7 @@ def test_reset_orphaned_tasks_nonexistent_dagrun(self):
         session.merge(ti)
         session.commit()
 
-        self.assertEquals(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
+        self.assertEqual(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
 
     def test_reset_orphaned_tasks_no_orphans(self):
         dag_id = 'test_reset_orphaned_tasks_no_orphans'
@@ -3752,9 +3752,9 @@ def test_reset_orphaned_tasks_no_orphans(self):
         session.merge(tis[0])
         session.commit()
 
-        self.assertEquals(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
+        self.assertEqual(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
         tis[0].refresh_from_db()
-        self.assertEquals(State.RUNNING, tis[0].state)
+        self.assertEqual(State.RUNNING, tis[0].state)
 
     def test_reset_orphaned_tasks_non_running_dagruns(self):
         """Ensure orphaned tasks with non-running dagruns are not reset."""
@@ -3769,13 +3769,13 @@ def test_reset_orphaned_tasks_non_running_dagruns(self):
         dr1 = scheduler.create_dag_run(dag)
         dr1.state = State.SUCCESS
         tis = dr1.get_task_instances(session=session)
-        self.assertEquals(1, len(tis))
+        self.assertEqual(1, len(tis))
         tis[0].state = State.SCHEDULED
         session.merge(dr1)
         session.merge(tis[0])
         session.commit()
 
-        self.assertEquals(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
+        self.assertEqual(0, len(scheduler.reset_state_for_orphaned_tasks(session=session)))
 
     def test_reset_orphaned_tasks_with_orphans(self):
         """Create dagruns and esnure only ones with correct states are reset."""
diff --git a/tests/utils/test_cli_util.py b/tests/utils/test_cli_util.py
index ec159abd68470..6a411faba7ed5 100644
--- a/tests/utils/test_cli_util.py
+++ b/tests/utils/test_cli_util.py
@@ -42,17 +42,17 @@ def test_metrics_build(self):
                     'task_id': 'bar',
                     'execution_date': exec_date}
         for k, v in expected.items():
-            self.assertEquals(v, metrics.get(k))
+            self.assertEqual(v, metrics.get(k))
 
         self.assertTrue(metrics.get('start_datetime') <= datetime.utcnow())
         self.assertTrue(metrics.get('full_command'))
 
         log_dao = metrics.get('log')
         self.assertTrue(log_dao)
-        self.assertEquals(log_dao.dag_id, metrics.get('dag_id'))
-        self.assertEquals(log_dao.task_id, metrics.get('task_id'))
-        self.assertEquals(log_dao.execution_date, metrics.get('execution_date'))
-        self.assertEquals(log_dao.owner, metrics.get('user'))
+        self.assertEqual(log_dao.dag_id, metrics.get('dag_id'))
+        self.assertEqual(log_dao.task_id, metrics.get('task_id'))
+        self.assertEqual(log_dao.execution_date, metrics.get('execution_date'))
+        self.assertEqual(log_dao.owner, metrics.get('user'))
 
     def test_fail_function(self):
         """
diff --git a/tests/utils/test_dag_processing.py b/tests/utils/test_dag_processing.py
index 9c85b66c578ad..ad33b7f64372d 100644
--- a/tests/utils/test_dag_processing.py
+++ b/tests/utils/test_dag_processing.py
@@ -205,11 +205,11 @@ def test_find_zombies(self):
             manager._last_zombie_query_time = timezone.utcnow() - timedelta(
                 seconds=manager._zombie_threshold_secs + 1)
             zombies = manager._find_zombies()
-            self.assertEquals(1, len(zombies))
+            self.assertEqual(1, len(zombies))
             self.assertIsInstance(zombies[0], SimpleTaskInstance)
-            self.assertEquals(ti.dag_id, zombies[0].dag_id)
-            self.assertEquals(ti.task_id, zombies[0].task_id)
-            self.assertEquals(ti.execution_date, zombies[0].execution_date)
+            self.assertEqual(ti.dag_id, zombies[0].dag_id)
+            self.assertEqual(ti.task_id, zombies[0].task_id)
+            self.assertEqual(ti.execution_date, zombies[0].execution_date)
 
             session.query(TI).delete()
             session.query(LJ).delete()
diff --git a/tests/utils/test_email.py b/tests/utils/test_email.py
index 1666ef5c627cc..6dae967c4abb9 100644
--- a/tests/utils/test_email.py
+++ b/tests/utils/test_email.py
@@ -28,17 +28,17 @@ class EmailTest(unittest.TestCase):
     def test_get_email_address_comma_sep_string(self):
         emails_string = 'test1@example.com, test2@example.com'
 
-        self.assertEquals(
+        self.assertEqual(
             get_email_address_list(emails_string), EMAILS)
 
     def test_get_email_address_colon_sep_string(self):
         emails_string = 'test1@example.com; test2@example.com'
 
-        self.assertEquals(
+        self.assertEqual(
             get_email_address_list(emails_string), EMAILS)
 
     def test_get_email_address_list(self):
         emails_list = ['test1@example.com', 'test2@example.com']
 
-        self.assertEquals(
+        self.assertEqual(
             get_email_address_list(emails_list), EMAILS)
diff --git a/tests/utils/test_helpers.py b/tests/utils/test_helpers.py
index ec7fc58d3ab32..9101adae5ef82 100644
--- a/tests/utils/test_helpers.py
+++ b/tests/utils/test_helpers.py
@@ -171,12 +171,12 @@ def test_is_container(self):
         self.assertTrue(helpers.is_container(["a", "list", "is", "a", "container"]))
 
     def test_as_tuple(self):
-        self.assertEquals(
+        self.assertEqual(
             helpers.as_tuple("a string is not a container"),
             ("a string is not a container",)
         )
 
-        self.assertEquals(
+        self.assertEqual(
             helpers.as_tuple(["a", "list", "is", "a", "container"]),
             ("a", "list", "is", "a", "container")
         )
diff --git a/tests/utils/test_timezone.py b/tests/utils/test_timezone.py
index 07e0befcb81a6..e31895e2df521 100644
--- a/tests/utils/test_timezone.py
+++ b/tests/utils/test_timezone.py
@@ -41,16 +41,16 @@ def test_is_naive(self):
     def test_utcnow(self):
         now = timezone.utcnow()
         self.assertTrue(timezone.is_localized(now))
-        self.assertEquals(now.replace(tzinfo=None), now.astimezone(UTC).replace(tzinfo=None))
+        self.assertEqual(now.replace(tzinfo=None), now.astimezone(UTC).replace(tzinfo=None))
 
     def test_convert_to_utc(self):
         naive = datetime.datetime(2011, 9, 1, 13, 20, 30)
         utc = datetime.datetime(2011, 9, 1, 13, 20, 30, tzinfo=UTC)
-        self.assertEquals(utc, timezone.convert_to_utc(naive))
+        self.assertEqual(utc, timezone.convert_to_utc(naive))
 
         eat = datetime.datetime(2011, 9, 1, 13, 20, 30, tzinfo=EAT)
         utc = datetime.datetime(2011, 9, 1, 10, 20, 30, tzinfo=UTC)
-        self.assertEquals(utc, timezone.convert_to_utc(eat))
+        self.assertEqual(utc, timezone.convert_to_utc(eat))
 
     def test_make_naive(self):
         self.assertEqual(
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index 771847e5b9f26..a8aa959ad7ba9 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -109,7 +109,7 @@ def test_generate_pager_current_end(self):
 
     def test_params_no_values(self):
         """Should return an empty string if no params are passed"""
-        self.assertEquals('', utils.get_params())
+        self.assertEqual('', utils.get_params())
 
     def test_params_search(self):
         self.assertEqual('search=bash_',
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 9c08864e9ccca..393bde147bd0a 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -519,16 +519,16 @@ def test_import_variables(self):
         self.assertIn('int_key', db_dict)
         self.assertIn('list_key', db_dict)
         self.assertIn('dict_key', db_dict)
-        self.assertEquals('str_value', db_dict['str_key'])
-        self.assertEquals('60', db_dict['int_key'])
-        self.assertEquals('[1, 2]', db_dict['list_key'])
+        self.assertEqual('str_value', db_dict['str_key'])
+        self.assertEqual('60', db_dict['int_key'])
+        self.assertEqual('[1, 2]', db_dict['list_key'])
 
         case_a_dict = '{"k_a": 2, "k_b": 3}'
         case_b_dict = '{"k_b": 3, "k_a": 2}'
         try:
-            self.assertEquals(case_a_dict, db_dict['dict_key'])
+            self.assertEqual(case_a_dict, db_dict['dict_key'])
         except AssertionError:
-            self.assertEquals(case_b_dict, db_dict['dict_key'])
+            self.assertEqual(case_b_dict, db_dict['dict_key'])
 
 
 class TestMountPoint(unittest.TestCase):
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index 9b32a86c9cdf4..58b9659d06b17 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -143,8 +143,8 @@ def test_get_all_permissions_views(self, mock_get_user_roles):
                          {('can_some_action', 'SomeBaseView')})
 
         mock_get_user_roles.return_value = []
-        self.assertEquals(len(self.security_manager
-                              .get_all_permissions_views()), 0)
+        self.assertEqual(len(self.security_manager
+                             .get_all_permissions_views()), 0)
 
     @mock.patch('airflow.www_rbac.security.AirflowSecurityManager'
                 '.get_all_permissions_views')
@@ -163,8 +163,8 @@ def test_get_accessible_dag_ids(self, mock_get_user_roles,
         mock_get_all_permissions_views.return_value = {('can_dag_read', 'dag_id')}
 
         mock_get_user_roles.return_value = [role]
-        self.assertEquals(self.security_manager
-                          .get_accessible_dag_ids(user), set(['dag_id']))
+        self.assertEqual(self.security_manager
+                         .get_accessible_dag_ids(user), set(['dag_id']))
 
     @mock.patch('airflow.www_rbac.security.AirflowSecurityManager._has_view_access')
     def test_has_access(self, mock_has_view_access):
diff --git a/tests/www_rbac/test_utils.py b/tests/www_rbac/test_utils.py
index 44bac6b74a965..9c75ad39e84fb 100644
--- a/tests/www_rbac/test_utils.py
+++ b/tests/www_rbac/test_utils.py
@@ -103,7 +103,7 @@ def test_generate_pager_current_end(self):
 
     def test_params_no_values(self):
         """Should return an empty string if no params are passed"""
-        self.assertEquals('', utils.get_params())
+        self.assertEqual('', utils.get_params())
 
     def test_params_search(self):
         self.assertEqual('search=bash_',

From e011e91702345166bc65b4bd6e52dbf94e0aa545 Mon Sep 17 00:00:00 2001
From: kani5hk <47313506+kani5hk@users.noreply.github.com>
Date: Mon, 11 Mar 2019 06:07:39 +0530
Subject: [PATCH 667/808] [AIRFLOW-4046] Add validations for poke_interval &
 timeout for Sensor (#4878)

---
 airflow/sensors/base_sensor_operator.py | 15 +++++++--
 tests/sensors/test_base_sensor.py       | 42 +++++++++++++++++++++++++
 2 files changed, 54 insertions(+), 3 deletions(-)

diff --git a/airflow/sensors/base_sensor_operator.py b/airflow/sensors/base_sensor_operator.py
index 1d65a30719376..3874fd4dd26c4 100644
--- a/airflow/sensors/base_sensor_operator.py
+++ b/airflow/sensors/base_sensor_operator.py
@@ -71,14 +71,23 @@ def __init__(self,
         self.poke_interval = poke_interval
         self.soft_fail = soft_fail
         self.timeout = timeout
-        if mode not in self.valid_modes:
+        self.mode = mode
+        self._validate_input_values()
+
+    def _validate_input_values(self):
+        if not isinstance(self.poke_interval, (int, float)) or self.poke_interval < 0:
+            raise AirflowException(
+                "The poke_interval must be a non-negative number")
+        if not isinstance(self.timeout, (int, float)) or self.timeout < 0:
+            raise AirflowException(
+                "The timeout must be a non-negative number")
+        if self.mode not in self.valid_modes:
             raise AirflowException(
                 "The mode must be one of {valid_modes},"
                 "'{d}.{t}'; received '{m}'."
                 .format(valid_modes=self.valid_modes,
                         d=self.dag.dag_id if self.dag else "",
-                        t=self.task_id, m=mode))
-        self.mode = mode
+                        t=self.task_id, m=self.mode))
 
     def poke(self, context):
         """
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index 451c95e5d11a4..9cb192e927de7 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -463,3 +463,45 @@ def test_reschedule_with_test_mode(self):
                 self.assertEqual(len(task_reschedules), 0)
             if ti.task_id == DUMMY_OP:
                 self.assertEqual(ti.state, State.NONE)
+
+    def test_sensor_with_invalid_poke_interval(self):
+        negative_poke_interval = -10
+        non_number_poke_interval = "abcd"
+        positive_poke_interval = 10
+        with self.assertRaises(AirflowException):
+            self._make_sensor(
+                return_value=None,
+                poke_interval=negative_poke_interval,
+                timeout=25)
+
+        with self.assertRaises(AirflowException):
+            self._make_sensor(
+                return_value=None,
+                poke_interval=non_number_poke_interval,
+                timeout=25)
+
+        self._make_sensor(
+            return_value=None,
+            poke_interval=positive_poke_interval,
+            timeout=25)
+
+    def test_sensor_with_invalid_timeout(self):
+        negative_timeout = -25
+        non_number_timeout = "abcd"
+        positive_timeout = 25
+        with self.assertRaises(AirflowException):
+            self._make_sensor(
+                return_value=None,
+                poke_interval=10,
+                timeout=negative_timeout)
+
+        with self.assertRaises(AirflowException):
+            self._make_sensor(
+                return_value=None,
+                poke_interval=10,
+                timeout=non_number_timeout)
+
+        self._make_sensor(
+            return_value=None,
+            poke_interval=10,
+            timeout=positive_timeout)

From ad68b5974e1d9a2a5d3f08fa9a2eaaff15da5d8b Mon Sep 17 00:00:00 2001
From: RosterIn <48057736+RosterIn@users.noreply.github.com>
Date: Mon, 11 Mar 2019 12:53:48 +0200
Subject: [PATCH 668/808] [AIRFLOW-4063] Fix exception string in BigQueryHook
 (#4899)

---
 airflow/contrib/hooks/bigquery_hook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 57ef3ac9c26dc..b898c4b16ce81 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1150,8 +1150,8 @@ def run_with_configuration(self, configuration):
                     time.sleep(5)
                 else:
                     raise Exception(
-                        'BigQuery job status check failed. Final error was: %s',
-                        err.resp.status)
+                        'BigQuery job status check failed. Final error was: {}'.
+                        format(err.resp.status))
 
         return self.running_job_id
 

From 79c4cf25286319e573dd9e04e449ccd8b13e1e18 Mon Sep 17 00:00:00 2001
From: RosterIn <48057736+RosterIn@users.noreply.github.com>
Date: Tue, 12 Mar 2019 01:56:13 +0200
Subject: [PATCH 669/808] [AIRFLOW-4063] Fix exception string in BigQueryHook
 [2/2] (#4902)

---
 airflow/contrib/hooks/bigquery_hook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index b898c4b16ce81..4e30a93bfeea9 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1174,8 +1174,8 @@ def poll_job_complete(self, job_id):
                     err.resp.status, job_id)
             else:
                 raise Exception(
-                    'BigQuery job status check failed. Final error was: %s',
-                    err.resp.status)
+                    'BigQuery job status check failed. Final error was: {}'.
+                    format(err.resp.status))
         return False
 
     def cancel_query(self):

From 22081c6edc408cdfd0413aba0fc39d998a12c07b Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Wed, 13 Mar 2019 15:45:33 +0800
Subject: [PATCH 670/808] [AIRFLOW-4076] Correct port type of beeline_default
 in init_db (#4908)

airflow initdb will create default beeline connection
with port "10000", but airflow.models.connection
variable port is Integer type. It's better to set
values in same type as int although it could auto
transfer
---
 airflow/utils/db.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index e44614a2eab92..075503115992a 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -97,7 +97,7 @@ def initdb(rbac=False):
             schema='airflow'))
     merge_conn(
         Connection(
-            conn_id='beeline_default', conn_type='beeline', port="10000",
+            conn_id='beeline_default', conn_type='beeline', port=10000,
             host='localhost', extra="{\"use_beeline\": true, \"auth\": \"\"}",
             schema='default'))
     merge_conn(

From 81993d595afcc09353b753e397f0377d7ba7c793 Mon Sep 17 00:00:00 2001
From: kik-kik <42538694+kik-kik@users.noreply.github.com>
Date: Wed, 13 Mar 2019 09:46:15 +0100
Subject: [PATCH 671/808] [AIRFLOW-3736] Allow int value in
 SqoopOperator.extra_import_options(#4906)

* now the value of a dict inside extra_export_options can be an int

* added modified unit tests test_import_cmd, test_export_cmd and test_popen to include testing for integer values passed in extra_export_options

* added "fetch-size" containing integer value to extra_import_options to one SqoopOperator inside test_execute
---
 airflow/contrib/hooks/sqoop_hook.py            |  4 ++--
 tests/contrib/hooks/test_sqoop_hook.py         | 13 +++++++++++--
 tests/contrib/operators/test_sqoop_operator.py |  7 +++++--
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/hooks/sqoop_hook.py b/airflow/contrib/hooks/sqoop_hook.py
index 74cddc2b21027..101259bcca811 100644
--- a/airflow/contrib/hooks/sqoop_hook.py
+++ b/airflow/contrib/hooks/sqoop_hook.py
@@ -195,7 +195,7 @@ def _import_cmd(self, target_dir, append, file_type, split_by, direct,
             for key, value in extra_import_options.items():
                 cmd += ['--{}'.format(key)]
                 if value:
-                    cmd += [value]
+                    cmd += [str(value)]
 
         return cmd
 
@@ -302,7 +302,7 @@ def _export_cmd(self, table, export_dir, input_null_string,
             for key, value in extra_export_options.items():
                 cmd += ['--{}'.format(key)]
                 if value:
-                    cmd += [value]
+                    cmd += [str(value)]
 
         # The required option
         cmd += ["--table", table]
diff --git a/tests/contrib/hooks/test_sqoop_hook.py b/tests/contrib/hooks/test_sqoop_hook.py
index 64c7e0c8a55a0..3d1589e3ee1c8 100644
--- a/tests/contrib/hooks/test_sqoop_hook.py
+++ b/tests/contrib/hooks/test_sqoop_hook.py
@@ -60,7 +60,8 @@ class TestSqoopHook(unittest.TestCase):
         'relaxed_isolation': True,
         'extra_export_options': collections.OrderedDict([
             ('update-key', 'id'),
-            ('update-mode', 'allowinsert')
+            ('update-mode', 'allowinsert'),
+            ('fetch-size', 1)
         ])
     }
     _config_import = {
@@ -72,7 +73,8 @@ class TestSqoopHook(unittest.TestCase):
         'driver': 'com.microsoft.jdbc.sqlserver.SQLServerDriver',
         'extra_import_options': {
             'hcatalog-storage-stanza': "\"stored as orcfile\"",
-            'show': ''
+            'show': '',
+            'fetch-size': 1
         }
     }
 
@@ -130,6 +132,7 @@ def test_popen(self, mock_popen):
              '--export-dir', self._config_export['export_dir'],
              '--update-key', 'id',
              '--update-mode', 'allowinsert',
+             '--fetch-size', str(self._config_export['extra_export_options'].get('fetch-size')),
              '--table', self._config_export['table']], stderr=-2, stdout=-1))
 
     def test_submit_none_mappers(self):
@@ -250,6 +253,11 @@ def test_export_cmd(self):
         if self._config_export['relaxed_isolation']:
             self.assertIn("--relaxed-isolation", cmd)
 
+        if self._config_export['extra_export_options']:
+            self.assertIn("--update-key", cmd)
+            self.assertIn("--update-mode", cmd)
+            self.assertIn("--fetch-size", cmd)
+
     def test_import_cmd(self):
         """
         Tests to verify the hook import command is building correct Sqoop import command.
@@ -300,6 +308,7 @@ def test_import_cmd(self):
         # these checks are from the extra import options
         self.assertIn('--show', cmd)
         self.assertIn('hcatalog-storage-stanza \"stored as orcfile\"', cmd)
+        self.assertIn('--fetch-size', cmd)
 
     def test_get_export_format_argument(self):
         """
diff --git a/tests/contrib/operators/test_sqoop_operator.py b/tests/contrib/operators/test_sqoop_operator.py
index e3cf32fdae45c..484d74b801748 100644
--- a/tests/contrib/operators/test_sqoop_operator.py
+++ b/tests/contrib/operators/test_sqoop_operator.py
@@ -64,7 +64,8 @@ class TestSqoopOperator(unittest.TestCase):
         },
         'extra_export_options': {
             'update-key': 'id',
-            'update-mode': 'allowinsert'
+            'update-mode': 'allowinsert',
+            'fetch-size': 1
         }
     }
 
@@ -154,7 +155,9 @@ def test_execute(self):
             extra_import_options={
                 'hcatalog-storage-stanza': "\"stored as orcfile\"",
                 'hive-partition-key': 'day',
-                'hive-partition-value': '2017-10-18'},
+                'hive-partition-value': '2017-10-18',
+                'fetch-size': 1
+            },
             dag=self.dag
         )
 

From 8e8d6927e24c7f9a4508287083db4ee71ca3d80a Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Mon, 10 Dec 2018 01:48:39 +0300
Subject: [PATCH 672/808] [AIRFLOW-987] pass kerberos cli args keytab and
 principal to kerberos.run() (#4238)

---
 airflow/bin/cli.py              |  7 +++----
 airflow/security/kerberos.py    | 30 +++++++++++++-------------
 tests/security/test_kerberos.py | 37 +++++++++++++++++++++++++++------
 3 files changed, 49 insertions(+), 25 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index d11c3e2934a98..78837c90684c9 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -1322,12 +1322,12 @@ def kerberos(args):  # noqa
         )
 
         with ctx:
-            airflow.security.kerberos.run()
+            airflow.security.kerberos.run(principal=args.principal, keytab=args.keytab)
 
         stdout.close()
         stderr.close()
     else:
-        airflow.security.kerberos.run()
+        airflow.security.kerberos.run(principal=args.principal, keytab=args.keytab)
 
 
 @cli_utils.action_logging
@@ -1676,8 +1676,7 @@ class CLIFactory(object):
             help="Delete a variable"),
         # kerberos
         'principal': Arg(
-            ("principal",), "kerberos principal",
-            nargs='?', default=conf.get('kerberos', 'principal')),
+            ("principal",), "kerberos principal", nargs='?'),
         'keytab': Arg(
             ("-kt", "--keytab"), "keytab",
             nargs='?', default=conf.get('kerberos', 'keytab')),
diff --git a/airflow/security/kerberos.py b/airflow/security/kerberos.py
index 43c9fcccdca85..b91241bc1de1c 100644
--- a/airflow/security/kerberos.py
+++ b/airflow/security/kerberos.py
@@ -27,11 +27,13 @@
 log = LoggingMixin().log
 
 
-def renew_from_kt():
+def renew_from_kt(principal, keytab):
     # The config is specified in seconds. But we ask for that same amount in
     # minutes to give ourselves a large renewal buffer.
+
     renewal_lifetime = "%sm" % configuration.conf.getint('kerberos', 'reinit_frequency')
-    principal = configuration.conf.get('kerberos', 'principal').replace(
+
+    cmd_principal = principal or configuration.conf.get('kerberos', 'principal').replace(
         "_HOST", socket.getfqdn()
     )
 
@@ -39,9 +41,9 @@ def renew_from_kt():
         configuration.conf.get('kerberos', 'kinit_path'),
         "-r", renewal_lifetime,
         "-k",  # host ticket
-        "-t", configuration.conf.get('kerberos', 'keytab'),  # specify keytab
+        "-t", keytab,  # specify keytab
         "-c", configuration.conf.get('kerberos', 'ccache'),  # specify credentials cache
-        principal
+        cmd_principal
     ]
     log.info("Reinitting kerberos from keytab: " + " ".join(cmdv))
 
@@ -55,8 +57,8 @@ def renew_from_kt():
     if subp.returncode != 0:
         log.error("Couldn't reinit from keytab! `kinit' exited with %s.\n%s\n%s" % (
             subp.returncode,
-            b"\n".join(subp.stdout.readlines()),
-            b"\n".join(subp.stderr.readlines())))
+            "\n".join(subp.stdout.readlines()),
+            "\n".join(subp.stderr.readlines())))
         sys.exit(subp.returncode)
 
     global NEED_KRB181_WORKAROUND
@@ -66,10 +68,10 @@ def renew_from_kt():
         # (From: HUE-640). Kerberos clock have seconds level granularity. Make sure we
         # renew the ticket after the initial valid time.
         time.sleep(1.5)
-        perform_krb181_workaround()
+        perform_krb181_workaround(principal)
 
 
-def perform_krb181_workaround():
+def perform_krb181_workaround(principal):
     cmdv = [configuration.conf.get('kerberos', 'kinit_path'),
             "-c", configuration.conf.get('kerberos', 'ccache'),
             "-R"]  # Renew ticket_cache
@@ -80,10 +82,8 @@ def perform_krb181_workaround():
     ret = subprocess.call(cmdv, close_fds=True)
 
     if ret != 0:
-        principal = "%s/%s" % (
-            configuration.conf.get('kerberos', 'principal'),
-            socket.getfqdn()
-        )
+        principal = "%s/%s" % (principal or configuration.conf.get('kerberos', 'principal'),
+                               socket.getfqdn())
         fmt_dict = dict(princ=principal,
                         ccache=configuration.conf.get('kerberos', 'principal'))
         log.error("Couldn't renew kerberos ticket in order to work around "
@@ -110,11 +110,11 @@ def detect_conf_var():
         return b'X-CACHECONF:' in f.read()
 
 
-def run():
-    if configuration.conf.get('kerberos', 'keytab') is None:
+def run(principal, keytab):
+    if not keytab:
         log.debug("Keytab renewer not starting, no keytab configured")
         sys.exit(0)
 
     while True:
-        renew_from_kt()
+        renew_from_kt(principal, keytab)
         time.sleep(configuration.conf.getint('kerberos', 'reinit_frequency'))
diff --git a/tests/security/test_kerberos.py b/tests/security/test_kerberos.py
index c495dd08c4d3d..d3d7bd5b00857 100644
--- a/tests/security/test_kerberos.py
+++ b/tests/security/test_kerberos.py
@@ -18,10 +18,14 @@
 # under the License.
 
 import os
-import unittest
-
+try:
+    import unittest2 as unittest  # PY27
+except ImportError:
+    import unittest
+from argparse import Namespace
 from airflow import configuration
 from airflow.security.kerberos import renew_from_kt
+from airflow import LoggingMixin
 
 
 @unittest.skipIf('KRB5_KTNAME' not in os.environ,
@@ -32,13 +36,34 @@ def setUp(self):
 
         if not configuration.conf.has_section("kerberos"):
             configuration.conf.add_section("kerberos")
-
-        configuration.conf.set("kerberos",
-                               "keytab",
+        configuration.conf.set("kerberos", "keytab",
                                os.environ['KRB5_KTNAME'])
+        keytab_from_cfg = configuration.conf.get("kerberos", "keytab")
+        self.args = Namespace(keytab=keytab_from_cfg, principal=None, pid=None,
+                              daemon=None, stdout=None, stderr=None, log_file=None)
 
     def test_renew_from_kt(self):
         """
         We expect no result, but a successful run. No more TypeError
         """
-        self.assertIsNone(renew_from_kt())
+        self.assertIsNone(renew_from_kt(principal=self.args.principal,
+                                        keytab=self.args.keytab))
+
+    def test_args_from_cli(self):
+        """
+        We expect no result, but a run with sys.exit(1) because keytab not exist.
+        """
+        configuration.conf.set("kerberos", "keytab", "")
+        self.args.keytab = "test_keytab"
+
+        with self.assertRaises(SystemExit) as se:
+            renew_from_kt(principal=self.args.principal,
+                          keytab=self.args.keytab)
+
+            with self.assertLogs(LoggingMixin().log) as log:
+                self.assertIn(
+                    'kinit: krb5_init_creds_set_keytab: Failed to find '
+                    'airflow@LUPUS.GRIDDYNAMICS.NET in keytab FILE:{} '
+                    '(unknown enctype)'.format(self.args.keytab), log.output)
+
+        self.assertEqual(se.exception.code, 1)

From 7e4e9f07084c2eb8c69f5fa9145c3c4a7cf83ddf Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Sat, 26 Jan 2019 22:49:58 -0800
Subject: [PATCH 673/808] [AIRFLOW-3771] Minor refactor securityManager (#4594)

---
 UPDATING.md                     |  8 +++
 airflow/www_rbac/security.py    | 93 +++++++++++++++++++--------------
 tests/www_rbac/test_security.py |  4 +-
 3 files changed, 65 insertions(+), 40 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 3556ce5dc9f76..ba1a6272f2bd7 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -106,6 +106,14 @@ Other GCP hooks are unaffected.
 
 ## Airflow 1.10.2
 
+### DAG level Access Control for new RBAC UI
+
+Extend and enhance new Airflow RBAC UI to support DAG level ACL. Each dag now has two permissions(one for write, one for read) associated('can_dag_edit', 'can_dag_read').
+The admin will create new role, associate the dag permission with the target dag and assign that role to users. That user can only access / view the certain dags on the UI
+that he has permissions on. If a new role wants to access all the dags, the admin could associate dag permissions on an artificial view(``all_dags``) with that role.
+
+We also provide a new cli command(``sync_perm``) to allow admin to auto sync permissions.
+
 ### Modification to `ts_nodash` macro
 `ts_nodash` previously contained TimeZone information along with execution date. For Example: `20150101T000000+0000`. This is not user-friendly for file or folder names which was a popular use case for `ts_nodash`. Hence this behavior has been changed and using `ts_nodash` will no longer contain TimeZone information, restoring the pre-1.10 behavior of this macro. And a new macro `ts_nodash_with_tz` has been added which can be used to get a string with execution date and timezone info without dashes.
 
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 91645d95f7088..9812222d73aca 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -18,7 +18,6 @@
 # under the License.
 #
 
-import logging
 from flask import g
 from flask_appbuilder.security.sqla import models as sqla_models
 from flask_appbuilder.security.sqla.manager import SecurityManager
@@ -27,11 +26,12 @@
 from airflow import models
 from airflow.www_rbac.app import appbuilder
 from airflow.utils.db import provide_session
+from airflow.utils.log.logging_mixin import LoggingMixin
 
 ###########################################################################
 #                               VIEW MENUS
 ###########################################################################
-viewer_vms = {
+VIEWER_VMS = {
     'Airflow',
     'DagModelView',
     'Browse',
@@ -53,9 +53,9 @@
     'VersionView',
 }
 
-user_vms = viewer_vms
+USER_VMS = VIEWER_VMS
 
-op_vms = {
+OP_VMS = {
     'Admin',
     'Configurations',
     'ConfigurationView',
@@ -73,7 +73,7 @@
 #                               PERMISSIONS
 ###########################################################################
 
-viewer_perms = {
+VIEWER_PERMS = {
     'menu_access',
     'can_index',
     'can_list',
@@ -100,7 +100,7 @@
     'can_version',
 }
 
-user_perms = {
+USER_PERMS = {
     'can_dagrun_clear',
     'can_run',
     'can_trigger',
@@ -118,17 +118,17 @@
     'can_clear',
 }
 
-op_perms = {
+OP_PERMS = {
     'can_conf',
     'can_varimport',
 }
 
 # global view-menu for dag-level access
-dag_vms = {
+DAG_VMS = {
     'all_dags'
 }
 
-dag_perms = {
+DAG_PERMS = {
     'can_dag_read',
     'can_dag_edit',
 }
@@ -140,18 +140,18 @@
 ROLE_CONFIGS = [
     {
         'role': 'Viewer',
-        'perms': viewer_perms,
-        'vms': viewer_vms | dag_vms
+        'perms': VIEWER_PERMS,
+        'vms': VIEWER_VMS | DAG_VMS,
     },
     {
         'role': 'User',
-        'perms': viewer_perms | user_perms | dag_perms,
-        'vms': viewer_vms | dag_vms | user_vms,
+        'perms': VIEWER_PERMS | USER_PERMS | DAG_PERMS,
+        'vms': VIEWER_VMS | DAG_VMS | USER_VMS,
     },
     {
         'role': 'Op',
-        'perms': viewer_perms | user_perms | op_perms | dag_perms,
-        'vms': viewer_vms | dag_vms | user_vms | op_vms,
+        'perms': VIEWER_PERMS | USER_PERMS | OP_PERMS | DAG_PERMS,
+        'vms': VIEWER_VMS | DAG_VMS | USER_VMS | OP_VMS,
     },
 ]
 
@@ -164,7 +164,7 @@
 }
 
 
-class AirflowSecurityManager(SecurityManager):
+class AirflowSecurityManager(SecurityManager, LoggingMixin):
 
     def init_role(self, role_name, role_vms, role_perms):
         """
@@ -183,7 +183,7 @@ def init_role(self, role_name, role_vms, role_perms):
             role = self.add_role(role_name)
 
         if len(role.permissions) == 0:
-            logging.info('Initializing permissions for role:%s in the database.', role_name)
+            self.log.info('Initializing permissions for role:%s in the database.', role_name)
             role_pvms = set()
             for pvm in pvms:
                 if pvm.view_menu.name in role_vms and pvm.permission.name in role_perms:
@@ -192,11 +192,14 @@ def init_role(self, role_name, role_vms, role_perms):
             self.get_session.merge(role)
             self.get_session.commit()
         else:
-            logging.info('Existing permissions for the role:%s within the database will persist.', role_name)
+            self.log.info('Existing permissions for the role:%s within the database will persist.', role_name)
 
     def get_user_roles(self, user=None):
         """
         Get all the roles associated with the user.
+
+        :param user: the ab_user in FAB model.
+        :return: a list of roles associated with the user.
         """
         if user is None:
             user = g.user
@@ -227,16 +230,16 @@ def get_accessible_dag_ids(self, username=None):
             username = g.user
 
         if username.is_anonymous or 'Public' in username.roles:
-            # return an empty list if the role is public
+            # return an empty set if the role is public
             return set()
 
         roles = {role.name for role in username.roles}
         if {'Admin', 'Viewer', 'User', 'Op'} & roles:
-            return dag_vms
+            return DAG_VMS
 
         user_perms_views = self.get_all_permissions_views()
-        # return all dags that the user could access
-        return set([view for perm, view in user_perms_views if perm in dag_perms])
+        # return a set of all dags that the user could access
+        return set([view for perm, view in user_perms_views if perm in DAG_PERMS])
 
     def has_access(self, permission, view_name, user=None):
         """
@@ -296,7 +299,7 @@ def clean_perms(self):
         """
         FAB leaves faulty permissions that need to be cleaned up
         """
-        logging.info('Cleaning faulty perms')
+        self.log.info('Cleaning faulty perms')
         sesh = self.get_session
         pvms = (
             sesh.query(sqla_models.PermissionView)
@@ -308,7 +311,7 @@ def clean_perms(self):
         deleted_count = pvms.delete()
         sesh.commit()
         if deleted_count:
-            logging.info('Deleted {} faulty permissions'.format(deleted_count))
+            self.log.info('Deleted {} faulty permissions'.format(deleted_count))
 
     def _merge_perm(self, permission_name, view_menu_name):
         """
@@ -334,16 +337,18 @@ def _merge_perm(self, permission_name, view_menu_name):
     def create_custom_dag_permission_view(self, session=None):
         """
         Workflow:
-        1. when scheduler found a new dag, we will create an entry in ab_view_menu
-        2. we fetch all the roles associated with dag users.
-        3. we join and create all the entries for ab_permission_view_menu
-           (predefined permissions * dag-view_menus)
-        4. Create all the missing role-permission-views for the ab_role_permission_views
+        1. Fetch all the existing (permissions, view-menu) from Airflow DB.
+        2. Fetch all the existing dag models that are either active or paused. Exclude the subdags.
+        3. Create both read and write permission view-menus relation for every dags from step 2
+        4. Find out all the dag specific roles(excluded pubic, admin, viewer, op, user)
+        5. Get all the permission-vm owned by the user role.
+        6. Grant all the user role's permission-vm except the all-dag view-menus to the dag roles.
+        7. Commit the updated permission-vm-role into db
 
         :return: None.
         """
         # todo(Tao): should we put this function here or in scheduler loop?
-        logging.info('Fetching a set of all permission, view_menu from FAB meta-table')
+        self.log.info('Fetching a set of all permission, view_menu from FAB meta-table')
 
         def merge_pv(perm, view_menu):
             """Create permission view menu only if it doesn't exist"""
@@ -356,8 +361,8 @@ def merge_pv(perm, view_menu):
                 all_pvs.add((pv.permission.name, pv.view_menu.name))
 
         # create perm for global logical dag
-        for dag in dag_vms:
-            for perm in dag_perms:
+        for dag in DAG_VMS:
+            for perm in DAG_PERMS:
                 merge_pv(perm, dag)
 
         # Get all the active / paused dags and insert them into a set
@@ -365,8 +370,9 @@ def merge_pv(perm, view_menu):
             .filter(or_(models.DagModel.is_active, models.DagModel.is_paused))\
             .filter(~models.DagModel.is_subdag).all()
 
+        # create can_dag_edit and can_dag_read permissions for every dag(vm)
         for dag in all_dags_models:
-            for perm in dag_perms:
+            for perm in DAG_PERMS:
                 merge_pv(perm, dag.dag_id)
 
         # for all the dag-level role, add the permission of viewer
@@ -377,13 +383,12 @@ def merge_pv(perm, view_menu):
         dag_role = [role for role in all_roles if role.name not in EXISTING_ROLES]
         update_perm_views = []
 
-        # todo(tao) need to remove all_dag vm
+        # need to remove all_dag vm from all the existing view-menus
         dag_vm = self.find_view_menu('all_dags')
         ab_perm_view_role = sqla_models.assoc_permissionview_role
         perm_view = self.permissionview_model
         view_menu = self.viewmenu_model
 
-        # todo(tao) comment on the query
         all_perm_view_by_user = session.query(ab_perm_view_role)\
             .join(perm_view, perm_view.id == ab_perm_view_role
                   .columns.permission_view_id)\
@@ -431,7 +436,9 @@ def sync_roles(self):
 
         :return: None.
         """
-        logging.info('Start syncing user roles.')
+        self.log.info('Start syncing user roles.')
+        # Create global all-dag VM
+        self.create_perm_vm_for_all_dag()
 
         # Create default user role.
         for config in ROLE_CONFIGS:
@@ -448,12 +455,22 @@ def sync_roles(self):
     def sync_perm_for_dag(self, dag_id):
         """
         Sync permissions for given dag id. The dag id surely exists in our dag bag
-        as only /refresh button will call this function
+        as only / refresh button will call this function
 
         :param dag_id:
         :return:
         """
-        for dag_perm in dag_perms:
+        for dag_perm in DAG_PERMS:
             perm_on_dag = self.find_permission_view_menu(dag_perm, dag_id)
             if perm_on_dag is None:
                 self.add_permission_view_menu(dag_perm, dag_id)
+
+    def create_perm_vm_for_all_dag(self):
+        """
+        Create perm-vm if not exist and insert into FAB security model for all-dags.
+        """
+        # create perm for global logical dag
+        for dag_vm in DAG_VMS:
+            for perm in DAG_PERMS:
+                self._merge_perm(permission_name=perm,
+                                 view_menu_name=dag_vm)
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index 58b9659d06b17..91e4fa9cf6bd9 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -30,7 +30,7 @@
 
 from sqlalchemy import Column, Integer, String, Date, Float
 
-from airflow.www_rbac.security import AirflowSecurityManager, dag_perms
+from airflow.www_rbac.security import AirflowSecurityManager, DAG_PERMS
 
 
 logging.basicConfig(format='%(asctime)s:%(levelname)s:%(name)s:%(message)s')
@@ -176,7 +176,7 @@ def test_has_access(self, mock_has_view_access):
     def test_sync_perm_for_dag(self):
         test_dag_id = 'TEST_DAG'
         self.security_manager.sync_perm_for_dag(test_dag_id)
-        for dag_perm in dag_perms:
+        for dag_perm in DAG_PERMS:
             self.assertIsNotNone(self.security_manager.
                                  find_permission_view_menu(dag_perm, test_dag_id))
 

From f27a63d800f5c4d922802804e2a5224cc5f145b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Sun, 10 Mar 2019 14:45:36 +0100
Subject: [PATCH 674/808] [AIRFLOW-3980] Unify logger (#4804)

---
 airflow/bin/cli.py                            |  2 +-
 airflow/configuration.py                      |  4 +-
 airflow/contrib/auth/backends/ldap_auth.py    |  2 +-
 airflow/contrib/hooks/bigquery_hook.py        | 40 +++++++------
 airflow/contrib/hooks/gcp_container_hook.py   | 27 ++++-----
 airflow/contrib/kubernetes/pod_launcher.py    |  2 +-
 .../contrib/operators/aws_athena_operator.py  | 10 ++--
 .../contrib/operators/gcp_compute_operator.py | 10 ++--
 .../operators/gcp_container_operator.py       |  2 +-
 .../contrib/operators/mlengine_operator.py    | 11 ++--
 .../operators/oracle_to_oracle_transfer.py    |  5 +-
 .../operators/s3_delete_objects_operator.py   |  2 +-
 airflow/contrib/operators/s3_list_operator.py |  5 +-
 .../contrib/operators/s3_to_gcs_operator.py   |  5 +-
 .../operators/sagemaker_endpoint_operator.py  |  2 +-
 airflow/contrib/operators/winrm_operator.py   |  2 +-
 .../aws_glue_catalog_partition_sensor.py      |  4 +-
 airflow/contrib/sensors/bash_sensor.py        |  8 +--
 airflow/contrib/sensors/hdfs_sensor.py        | 10 +---
 airflow/contrib/sensors/python_sensor.py      |  2 +-
 .../sensors/sagemaker_training_sensor.py      |  2 +-
 airflow/contrib/sensors/wasb_sensor.py        |  5 +-
 airflow/contrib/utils/gcp_field_sanitizer.py  | 24 ++++----
 airflow/contrib/utils/gcp_field_validator.py  | 56 +++++++++----------
 airflow/executors/base_executor.py            |  4 +-
 airflow/executors/celery_executor.py          | 24 ++++----
 airflow/hooks/dbapi_hook.py                   |  5 +-
 airflow/hooks/druid_hook.py                   |  7 +--
 airflow/hooks/hive_hooks.py                   |  2 +-
 airflow/hooks/http_hook.py                    |  3 +-
 airflow/hooks/oracle_hook.py                  |  4 +-
 airflow/hooks/pig_hook.py                     |  2 +-
 airflow/hooks/webhdfs_hook.py                 |  4 +-
 airflow/jobs.py                               | 55 +++++++-----------
 airflow/models/__init__.py                    | 33 +++++------
 airflow/operators/bash_operator.py            |  2 +-
 airflow/operators/check_operator.py           | 12 ++--
 airflow/operators/druid_check_operator.py     |  4 +-
 airflow/operators/python_operator.py          |  8 +--
 airflow/operators/s3_to_hive_operator.py      | 20 +++----
 airflow/security/kerberos.py                  | 34 +++++------
 airflow/sensors/external_task_sensor.py       |  7 +--
 airflow/sensors/hdfs_sensor.py                |  2 +-
 airflow/sensors/hive_partition_sensor.py      |  4 +-
 .../sensors/named_hive_partition_sensor.py    | 10 ++--
 airflow/sensors/s3_key_sensor.py              |  3 +-
 airflow/sensors/s3_prefix_sensor.py           |  3 +-
 airflow/sensors/web_hdfs_sensor.py            |  2 +-
 airflow/utils/cli_action_loggers.py           | 12 ++--
 airflow/utils/dag_processing.py               | 44 ++++++---------
 airflow/utils/log/es_task_handler.py          |  4 +-
 airflow/utils/log/gcs_task_handler.py         |  4 +-
 airflow/utils/timeout.py                      |  2 +-
 airflow/www/api/experimental/endpoints.py     |  2 +-
 airflow/www_rbac/security.py                  |  5 +-
 .../contrib/hooks/test_gcp_container_hook.py  |  4 +-
 .../operators/test_gcp_container_operator.py  |  4 +-
 tests/executors/test_celery_executor.py       |  6 +-
 tests/utils/log/test_es_task_handler.py       |  3 +-
 59 files changed, 268 insertions(+), 318 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 78837c90684c9..d63065ac24d10 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -506,7 +506,7 @@ def run(args, dag=None):
         dag = get_dag(args)
     elif not dag:
         with db.create_session() as session:
-            log.info('Loading pickle id {args.pickle}'.format(args=args))
+            log.info('Loading pickle id %s', args.pickle)
             dag_pickle = session.query(DagPickle).filter(DagPickle.id == args.pickle).first()
             if not dag_pickle:
                 raise AirflowException("Who hid the pickle!? [missing pickle]")
diff --git a/airflow/configuration.py b/airflow/configuration.py
index faec3e74d9672..64ce7792bd069 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -284,12 +284,12 @@ def get(self, section, key, **kwargs):
 
         else:
             log.warning(
-                "section/key [{section}/{key}] not found in config".format(**locals())
+                "section/key [%s/%s] not found in config", section, key
             )
 
             raise AirflowConfigException(
                 "section/key [{section}/{key}] not found "
-                "in config".format(**locals()))
+                "in config".format(section=section, key=key))
 
     def getboolean(self, section, key, **kwargs):
         val = str(self.get(section, key, **kwargs)).lower().strip()
diff --git a/airflow/contrib/auth/backends/ldap_auth.py b/airflow/contrib/auth/backends/ldap_auth.py
index 9135b4c3964b0..1639f43aec307 100644
--- a/airflow/contrib/auth/backends/ldap_auth.py
+++ b/airflow/contrib/auth/backends/ldap_auth.py
@@ -235,7 +235,7 @@ def try_login(username, password):
             Unable to parse LDAP structure. If you're using Active Directory
             and not specifying an OU, you must set search_scope=SUBTREE in airflow.cfg.
             %s
-            """ % traceback.format_exc())
+            """, traceback.format_exc())
             raise LdapException(
                 "Could not parse LDAP structure. "
                 "Try setting search_scope in airflow.cfg, or check logs"
diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 4e30a93bfeea9..8094e14f4ba98 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -710,7 +710,7 @@ def run_query(self,
 
                 if param_name == 'schemaUpdateOptions' and param:
                     self.log.info("Adding experimental 'schemaUpdateOptions': "
-                                  "{0}".format(schema_update_options))
+                                  "%s", schema_update_options)
 
                 if param_name == 'destinationTable':
                     for key in ['projectId', 'datasetId', 'tableId']:
@@ -1051,8 +1051,9 @@ def run_load(self,
                                  "'WRITE_APPEND' or 'WRITE_TRUNCATE'.")
             else:
                 self.log.info(
-                    "Adding experimental "
-                    "'schemaUpdateOptions': {0}".format(schema_update_options))
+                    "Adding experimental 'schemaUpdateOptions': %s",
+                    schema_update_options
+                )
                 configuration['load'][
                     'schemaUpdateOptions'] = schema_update_options
 
@@ -1449,9 +1450,10 @@ def create_empty_dataset(self, dataset_id="", project_id="",
             param, param_name, param_default = param_tuple
             if param_name not in dataset_reference['datasetReference']:
                 if param_default and not param:
-                    self.log.info("{} was not specified. Will be used default "
-                                  "value {}.".format(param_name,
-                                                     param_default))
+                    self.log.info(
+                        "%s was not specified. Will be used default value %s.",
+                        param_name, param_default
+                    )
                     param = param_default
                 dataset_reference['datasetReference'].update(
                     {param_name: param})
@@ -1529,7 +1531,7 @@ def get_dataset(self, dataset_id, project_id=None):
         try:
             dataset_resource = self.service.datasets().get(
                 datasetId=dataset_id, projectId=dataset_project_id).execute()
-            self.log.info("Dataset Resource: {}".format(dataset_resource))
+            self.log.info("Dataset Resource: %s", dataset_resource)
         except HttpError as err:
             raise AirflowException(
                 'BigQuery job failed. Error was: {}'.format(err.content))
@@ -1576,7 +1578,7 @@ def get_datasets_list(self, project_id=None):
         try:
             datasets_list = self.service.datasets().list(
                 projectId=dataset_project_id).execute()['datasets']
-            self.log.info("Datasets List: {}".format(datasets_list))
+            self.log.info("Datasets List: %s", datasets_list)
 
         except HttpError as err:
             raise AirflowException(
@@ -1631,9 +1633,10 @@ def insert_all(self, project_id, dataset_id, table_id,
         }
 
         try:
-            self.log.info('Inserting {} row(s) into Table {}:{}.{}'.format(
-                len(rows), dataset_project_id,
-                dataset_id, table_id))
+            self.log.info(
+                'Inserting %s row(s) into Table %s:%s.%s',
+                len(rows), dataset_project_id, dataset_id, table_id
+            )
 
             resp = self.service.tabledata().insertAll(
                 projectId=dataset_project_id, datasetId=dataset_id,
@@ -1641,8 +1644,10 @@ def insert_all(self, project_id, dataset_id, table_id,
             ).execute()
 
             if 'insertErrors' not in resp:
-                self.log.info('All row(s) inserted successfully: {}:{}.{}'.format(
-                    dataset_project_id, dataset_id, table_id))
+                self.log.info(
+                    'All row(s) inserted successfully: %s:%s.%s',
+                    dataset_project_id, dataset_id, table_id
+                )
             else:
                 error_msg = '{} insert error(s) occured: {}:{}.{}. Details: {}'.format(
                     len(resp['insertErrors']),
@@ -1924,11 +1929,10 @@ def var_print(var_name):
     if project_id is None:
         if var_name is not None:
             log = LoggingMixin().log
-            log.info('Project not included in {var}: {input}; '
-                     'using project "{project}"'.format(
-                         var=var_name,
-                         input=table_input,
-                         project=default_project_id))
+            log.info(
+                'Project not included in %s: %s; using project "%s"',
+                var_name, table_input, default_project_id
+            )
         project_id = default_project_id
 
     return project_id, dataset_id, table_id
diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 30096c14f4d7c..652e6213085a7 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -80,7 +80,7 @@ def wait_for_operation(self, operation, project_id=None):
         :type project_id: str
         :return: A new, updated operation fetched from Google Cloud
         """
-        self.log.info("Waiting for OPERATION_NAME %s" % operation.name)
+        self.log.info("Waiting for OPERATION_NAME %s", operation.name)
         time.sleep(OPERATIONAL_POLL_INTERVAL)
         while operation.status != Operation.Status.DONE:
             if operation.status == Operation.Status.RUNNING or operation.status == \
@@ -151,8 +151,9 @@ def delete_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         :return: The full url to the delete operation if successful, else None
         """
 
-        self.log.info("Deleting (project_id={}, zone={}, cluster_id={})".format(
-            self.project_id, self.location, name))
+        self.log.info(
+            "Deleting (project_id=%s, zone=%s, cluster_id=%s)", self.project_id, self.location, name
+        )
 
         try:
             op = self.get_client().delete_cluster(project_id=project_id or self.project_id,
@@ -164,7 +165,7 @@ def delete_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
             # Returns server-defined url for the resource
             return op.self_link
         except NotFound as error:
-            self.log.info('Assuming Success: ' + error.message)
+            self.log.info('Assuming Success: %s', error.message)
 
     def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         """
@@ -200,10 +201,10 @@ def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAUL
 
         self._append_label(cluster, 'airflow-version', 'v' + version.version)
 
-        self.log.info("Creating (project_id={}, zone={}, cluster_name={})".format(
-            self.project_id,
-            self.location,
-            cluster.name))
+        self.log.info(
+            "Creating (project_id=%s, zone=%s, cluster_name=%s)",
+            self.project_id, self.location, cluster.name
+        )
         try:
             op = self.get_client().create_cluster(project_id=project_id or self.project_id,
                                                   zone=self.location,
@@ -214,7 +215,7 @@ def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAUL
 
             return op.target_link
         except AlreadyExists as error:
-            self.log.info('Assuming Success: ' + error.message)
+            self.log.info('Assuming Success: %s', error.message)
             return self.get_cluster(name=cluster.name).self_link
 
     def get_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
@@ -234,10 +235,10 @@ def get_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
         :type timeout: float
         :return: A google.cloud.container_v1.types.Cluster instance
         """
-        self.log.info("Fetching cluster (project_id={}, zone={}, cluster_name={})".format(
-            project_id or self.project_id,
-            self.location,
-            name))
+        self.log.info(
+            "Fetching cluster (project_id=%s, zone=%s, cluster_name=%s)",
+            project_id or self.project_id, self.location, name
+        )
 
         return self.get_client().get_cluster(project_id=project_id or self.project_id,
                                              zone=self.location,
diff --git a/airflow/contrib/kubernetes/pod_launcher.py b/airflow/contrib/kubernetes/pod_launcher.py
index 2704fd9d32715..f3708813f6c7d 100644
--- a/airflow/contrib/kubernetes/pod_launcher.py
+++ b/airflow/contrib/kubernetes/pod_launcher.py
@@ -164,7 +164,7 @@ def _extract_xcom(self, pod):
 
     def _exec_pod_command(self, resp, command):
         if resp.is_open():
-            self.log.info('Running command... %s\n' % command)
+            self.log.info('Running command... %s\n', command)
             resp.write_stdin(command + '\n')
             while resp.is_open():
                 resp.update(timeout=1)
diff --git a/airflow/contrib/operators/aws_athena_operator.py b/airflow/contrib/operators/aws_athena_operator.py
index 432410e31100a..28054d320168a 100644
--- a/airflow/contrib/operators/aws_athena_operator.py
+++ b/airflow/contrib/operators/aws_athena_operator.py
@@ -81,8 +81,9 @@ def on_kill(self):
         """
         if self.query_execution_id:
             self.log.info('⚰️⚰️⚰️ Received a kill Signal. Time to Die')
-            self.log.info('Stopping Query with executionId - {queryId}'.format(
-                queryId=self.query_execution_id))
+            self.log.info(
+                'Stopping Query with executionId - %s', self.query_execution_id
+            )
             response = self.hook.stop_query(self.query_execution_id)
             http_status_code = None
             try:
@@ -93,6 +94,7 @@ def on_kill(self):
                 if http_status_code is None or http_status_code != 200:
                     self.log.error('Unable to request query cancel on athena. Exiting')
                 else:
-                    self.log.info('Polling Athena for query with id {queryId} to reach final state'.format(
-                        queryId=self.query_execution_id))
+                    self.log.info(
+                        'Polling Athena for query with id %s to reach final state', self.query_execution_id
+                    )
                     self.hook.poll_query_status(self.query_execution_id)
diff --git a/airflow/contrib/operators/gcp_compute_operator.py b/airflow/contrib/operators/gcp_compute_operator.py
index 0645ce6ce856f..c7dc9f315f73f 100644
--- a/airflow/contrib/operators/gcp_compute_operator.py
+++ b/airflow/contrib/operators/gcp_compute_operator.py
@@ -343,8 +343,11 @@ def execute(self, context):
             # Group Manager. We assume success if the template is simply present
             existing_template = self._hook.get_instance_template(
                 resource_id=self.body_patch['name'], project_id=self.project_id)
-            self.log.info("The {} template already existed. It was likely "
-                          "created by previous run of the operator. Assuming success.")
+            self.log.info(
+                "The %s template already existed. It was likely created by previous run of the operator. "
+                "Assuming success.",
+                existing_template
+            )
             return existing_template
         except HttpError as e:
             # We actually expect to get 404 / Not Found here as the template should
@@ -356,8 +359,7 @@ def execute(self, context):
         new_body = deepcopy(old_body)
         self._field_sanitizer.sanitize(new_body)
         new_body = merge(new_body, self.body_patch)
-        self.log.info("Calling insert instance template with updated body: {}".
-                      format(new_body))
+        self.log.info("Calling insert instance template with updated body: %s", new_body)
         self._hook.insert_instance_template(body=new_body,
                                             request_id=self.request_id,
                                             project_id=self.project_id)
diff --git a/airflow/contrib/operators/gcp_container_operator.py b/airflow/contrib/operators/gcp_container_operator.py
index fda4d44b9dca9..663d8510d371d 100644
--- a/airflow/contrib/operators/gcp_container_operator.py
+++ b/airflow/contrib/operators/gcp_container_operator.py
@@ -318,5 +318,5 @@ def _get_field(self, extras, field, default=None):
         if long_f in extras:
             return extras[long_f]
         else:
-            self.log.info('Field {} not found in extras.'.format(field))
+            self.log.info('Field %s not found in extras.', field)
             return default
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 0c0df3e842c9a..91e636b61ac5c 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -267,8 +267,9 @@ def check_existing_job(existing_job):
             raise
 
         if finished_prediction_job['state'] != 'SUCCEEDED':
-            self.log.error('MLEngine batch prediction job failed: {}'.format(
-                str(finished_prediction_job)))
+            self.log.error(
+                'MLEngine batch prediction job failed: %s', str(finished_prediction_job)
+            )
             raise RuntimeError(finished_prediction_job['errorMessage'])
 
         return finished_prediction_job['predictionOutput']
@@ -584,8 +585,7 @@ def execute(self, context):
 
         if self._mode == 'DRY_RUN':
             self.log.info('In dry_run mode.')
-            self.log.info('MLEngine Training job request is: {}'.format(
-                training_request))
+            self.log.info('MLEngine Training job request is: %s', training_request)
             return
 
         hook = MLEngineHook(
@@ -604,6 +604,5 @@ def check_existing_job(existing_job):
             raise
 
         if finished_training_job['state'] != 'SUCCEEDED':
-            self.log.error('MLEngine training job failed: {}'.format(
-                str(finished_training_job)))
+            self.log.error('MLEngine training job failed: %s', str(finished_training_job))
             raise RuntimeError(finished_training_job['errorMessage'])
diff --git a/airflow/contrib/operators/oracle_to_oracle_transfer.py b/airflow/contrib/operators/oracle_to_oracle_transfer.py
index 1db95f7520bb1..58613c4f33489 100644
--- a/airflow/contrib/operators/oracle_to_oracle_transfer.py
+++ b/airflow/contrib/operators/oracle_to_oracle_transfer.py
@@ -68,8 +68,7 @@ def __init__(
     def _execute(self, src_hook, dest_hook, context):
         with src_hook.get_conn() as src_conn:
             cursor = src_conn.cursor()
-            self.log.info("Querying data from source: {0}".format(
-                self.oracle_source_conn_id))
+            self.log.info("Querying data from source: %s", self.oracle_source_conn_id)
             cursor.execute(self.source_sql, self.source_sql_params)
             target_fields = list(map(lambda field: field[0], cursor.description))
 
@@ -81,7 +80,7 @@ def _execute(self, src_hook, dest_hook, context):
                                            target_fields=target_fields,
                                            commit_every=self.rows_chunk)
                 rows = cursor.fetchmany(self.rows_chunk)
-                self.log.info("Total inserted: {0} rows".format(rows_total))
+                self.log.info("Total inserted: %s rows", rows_total)
 
             self.log.info("Finished data transfer.")
             cursor.close()
diff --git a/airflow/contrib/operators/s3_delete_objects_operator.py b/airflow/contrib/operators/s3_delete_objects_operator.py
index 0471693cd093c..0758223217777 100644
--- a/airflow/contrib/operators/s3_delete_objects_operator.py
+++ b/airflow/contrib/operators/s3_delete_objects_operator.py
@@ -80,7 +80,7 @@ def execute(self, context):
         response = s3_hook.delete_objects(bucket=self.bucket, keys=self.keys)
 
         deleted_keys = [x['Key'] for x in response.get("Deleted", [])]
-        self.log.info("Deleted: {}".format(deleted_keys))
+        self.log.info("Deleted: %s", deleted_keys)
 
         if "Errors" in response:
             errors_keys = [x['Key'] for x in response.get("Errors", [])]
diff --git a/airflow/contrib/operators/s3_list_operator.py b/airflow/contrib/operators/s3_list_operator.py
index 3ca22d5932b75..41ef7efd6960c 100644
--- a/airflow/contrib/operators/s3_list_operator.py
+++ b/airflow/contrib/operators/s3_list_operator.py
@@ -85,8 +85,9 @@ def execute(self, context):
         hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
 
         self.log.info(
-            'Getting the list of files from bucket: {0} in prefix: {1} (Delimiter {2})'.
-            format(self.bucket, self.prefix, self.delimiter))
+            'Getting the list of files from bucket: %s in prefix: %s (Delimiter {%s)',
+            self.bucket, self.prefix, self.delimiter
+        )
 
         return hook.list_keys(
             bucket_name=self.bucket,
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index c6228bf4554c8..d8085043df444 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -153,8 +153,9 @@ def execute(self, context):
 
             files = list(set(files) - set(existing_files))
             if len(files) > 0:
-                self.log.info('{0} files are going to be synced: {1}.'.format(
-                    len(files), files))
+                self.log.info(
+                    '%s files are going to be synced: %s.', len(files), files
+                )
             else:
                 self.log.info(
                     'There are no new files to sync. Have a nice day!')
diff --git a/airflow/contrib/operators/sagemaker_endpoint_operator.py b/airflow/contrib/operators/sagemaker_endpoint_operator.py
index b3f17df128a35..45af3381cb9cd 100644
--- a/airflow/contrib/operators/sagemaker_endpoint_operator.py
+++ b/airflow/contrib/operators/sagemaker_endpoint_operator.py
@@ -128,7 +128,7 @@ def execute(self, context):
         else:
             raise ValueError('Invalid value! Argument operation has to be one of "create" and "update"')
 
-        self.log.info('{} SageMaker endpoint {}.'.format(log_str, endpoint_info['EndpointName']))
+        self.log.info('%s SageMaker endpoint %s.', log_str, endpoint_info['EndpointName'])
 
         response = sagemaker_operation(
             endpoint_info,
diff --git a/airflow/contrib/operators/winrm_operator.py b/airflow/contrib/operators/winrm_operator.py
index c3f96693f0e4d..760b2548e858a 100644
--- a/airflow/contrib/operators/winrm_operator.py
+++ b/airflow/contrib/operators/winrm_operator.py
@@ -88,7 +88,7 @@ def execute(self, context):
         winrm_client = self.winrm_hook.get_conn()
 
         try:
-            self.log.info("Running command: '{command}'...".format(command=self.command))
+            self.log.info("Running command: '%s'...", self.command)
             command_id = self.winrm_hook.winrm_protocol.run_command(
                 winrm_client,
                 self.command
diff --git a/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py b/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
index 74e25a29dc4ff..d4c1d3a884e72 100644
--- a/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
+++ b/airflow/contrib/sensors/aws_glue_catalog_partition_sensor.py
@@ -74,8 +74,8 @@ def poke(self, context):
         if '.' in self.table_name:
             self.database_name, self.table_name = self.table_name.split('.')
         self.log.info(
-            'Poking for table {self.database_name}.{self.table_name}, '
-            'expression {self.expression}'.format(**locals()))
+            'Poking for table %s. %s, expression %s', self.database_name, self.table_name, self.expression
+        )
 
         return self.get_hook().check_for_partition(
             self.database_name, self.table_name, self.expression)
diff --git a/airflow/contrib/sensors/bash_sensor.py b/airflow/contrib/sensors/bash_sensor.py
index 7372a419b6900..fec48c5778ef1 100644
--- a/airflow/contrib/sensors/bash_sensor.py
+++ b/airflow/contrib/sensors/bash_sensor.py
@@ -70,10 +70,7 @@ def poke(self, context):
                 f.flush()
                 fname = f.name
                 script_location = tmp_dir + "/" + fname
-                self.log.info(
-                    "Temporary script location: %s",
-                    script_location
-                )
+                self.log.info("Temporary script location: %s", script_location)
                 self.log.info("Running command: %s", bash_command)
                 sp = Popen(
                     ['bash', fname],
@@ -89,7 +86,6 @@ def poke(self, context):
                     line = line.decode(self.output_encoding).strip()
                     self.log.info(line)
                 sp.wait()
-                self.log.info("Command exited with "
-                              "return code {0}".format(sp.returncode))
+                self.log.info("Command exited with return code %s", sp.returncode)
 
                 return not sp.returncode
diff --git a/airflow/contrib/sensors/hdfs_sensor.py b/airflow/contrib/sensors/hdfs_sensor.py
index 832b81b8e5f25..fe9e5cfc6f4df 100644
--- a/airflow/contrib/sensors/hdfs_sensor.py
+++ b/airflow/contrib/sensors/hdfs_sensor.py
@@ -35,9 +35,7 @@ def poke(self, context):
         """
         sb = self.hook(self.hdfs_conn_id).get_conn()
         self.log.info(
-            'Poking for {self.filepath} to be a directory '
-            'with files matching {self.regex.pattern}'.
-            format(**locals())
+            'Poking for %s to be a directory with files matching %s', self.filepath, self.regex.pattern
         )
         result = [f for f in sb.ls([self.filepath], include_toplevel=False) if
                   f['file_type'] == 'f' and
@@ -68,11 +66,9 @@ def poke(self, context):
                                              self.ignore_copying)
         result = self.filter_for_filesize(result, self.file_size)
         if self.be_empty:
-            self.log.info('Poking for filepath {self.filepath} to a empty directory'
-                          .format(**locals()))
+            self.log.info('Poking for filepath %s to a empty directory', self.filepath)
             return len(result) == 1 and result[0]['path'] == self.filepath
         else:
-            self.log.info('Poking for filepath {self.filepath} to a non empty directory'
-                          .format(**locals()))
+            self.log.info('Poking for filepath %s to a non empty directory', self.filepath)
             result.pop(0)
             return bool(result) and result[0]['file_type'] == 'f'
diff --git a/airflow/contrib/sensors/python_sensor.py b/airflow/contrib/sensors/python_sensor.py
index ecdc7e6c8ea40..81b7af72130a2 100644
--- a/airflow/contrib/sensors/python_sensor.py
+++ b/airflow/contrib/sensors/python_sensor.py
@@ -76,6 +76,6 @@ def poke(self, context):
             context['templates_dict'] = self.templates_dict
             self.op_kwargs = context
 
-        self.log.info("Poking callable: " + str(self.python_callable))
+        self.log.info("Poking callable: %s", str(self.python_callable))
         return_value = self.python_callable(*self.op_args, **self.op_kwargs)
         return bool(return_value)
diff --git a/airflow/contrib/sensors/sagemaker_training_sensor.py b/airflow/contrib/sensors/sagemaker_training_sensor.py
index 2d820111a08c8..d550a6c434bfb 100644
--- a/airflow/contrib/sensors/sagemaker_training_sensor.py
+++ b/airflow/contrib/sensors/sagemaker_training_sensor.py
@@ -91,7 +91,7 @@ def get_sagemaker_response(self):
             billable_time = \
                 (self.last_description['TrainingEndTime'] - self.last_description['TrainingStartTime']) * \
                 self.last_description['ResourceConfig']['InstanceCount']
-            self.log.info('Billable seconds:{}'.format(int(billable_time.total_seconds()) + 1))
+            self.log.info('Billable seconds: %s', int(billable_time.total_seconds()) + 1)
 
         return self.last_description
 
diff --git a/airflow/contrib/sensors/wasb_sensor.py b/airflow/contrib/sensors/wasb_sensor.py
index ec6a63bf3d633..8b32d3fa221d9 100644
--- a/airflow/contrib/sensors/wasb_sensor.py
+++ b/airflow/contrib/sensors/wasb_sensor.py
@@ -90,10 +90,7 @@ def __init__(self, container_name, prefix, wasb_conn_id='wasb_default',
         self.check_options = check_options
 
     def poke(self, context):
-        self.log.info(
-            'Poking for prefix: {self.prefix}\n'
-            'in wasb://{self.container_name}'.format(**locals())
-        )
+        self.log.info('Poking for prefix: %s in wasb://%s', self.prefix, self.container_name)
         hook = WasbHook(wasb_conn_id=self.wasb_conn_id)
         return hook.check_for_prefix(self.container_name, self.prefix,
                                      **self.check_options)
diff --git a/airflow/contrib/utils/gcp_field_sanitizer.py b/airflow/contrib/utils/gcp_field_sanitizer.py
index c0a8985281e1a..f6c5af0adf0ed 100644
--- a/airflow/contrib/utils/gcp_field_sanitizer.py
+++ b/airflow/contrib/utils/gcp_field_sanitizer.py
@@ -127,18 +127,20 @@ def _sanitize(self, dictionary, remaining_field_spec, current_path):
         if len(field_split) == 1:
             field_name = field_split[0]
             if field_name in dictionary:
-                self.log.info("Deleted {} [{}]".format(field_name, current_path))
+                self.log.info("Deleted %s [%s]", field_name, current_path)
                 del dictionary[field_name]
             else:
-                self.log.debug("The field {} is missing in {} at the path {}.".
-                               format(field_name, dictionary, current_path))
+                self.log.debug(
+                    "The field %s is missing in %s at the path %s.", field_name, dictionary, current_path
+                )
         else:
             field_name = field_split[0]
             remaining_path = field_split[1]
             child = dictionary.get(field_name)
             if child is None:
-                self.log.debug("The field {} is missing in {} at the path {}. ".
-                               format(field_name, dictionary, current_path))
+                self.log.debug(
+                    "The field %s is missing in %s at the path %s. ", field_name, dictionary, current_path
+                )
             elif isinstance(child, dict):
                 self._sanitize(child, remaining_path, "{}.{}".format(
                     current_path, field_name))
@@ -146,16 +148,16 @@ def _sanitize(self, dictionary, remaining_field_spec, current_path):
                 for index, elem in enumerate(child):
                     if not isinstance(elem, dict):
                         self.log.warn(
-                            "The field {} element at index {} is of wrong type. "
-                            "It should be dict and is {}. Skipping it.".
-                            format(current_path, index, elem))
+                            "The field %s element at index %s is of wrong type. "
+                            "It should be dict and is %s. Skipping it.",
+                            current_path, index, elem)
                     self._sanitize(elem, remaining_path, "{}.{}[{}]".format(
                         current_path, field_name, index))
             else:
                 self.log.warn(
-                    "The field {} is of wrong type. "
-                    "It should be dict or list and it is {}. Skipping it.".
-                    format(current_path, child))
+                    "The field %s is of wrong type. It should be dict or list and it is %s. Skipping it.",
+                    current_path, child
+                )
 
     def sanitize(self, body):
         for elem in self._sanitize_specs:
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index 5ae1bdf9ce51e..797be076d7914 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -264,14 +264,14 @@ def _validate_dict(self, children_validation_specs, full_field_path, value):
         for field_name in value.keys():
             if field_name not in all_dict_keys:
                 self.log.warning(
-                    "The field '{}' is in the body, but is not specified in the "
-                    "validation specification '{}'. "
+                    "The field '%s' is in the body, but is not specified in the "
+                    "validation specification '%s'. "
                     "This might be because you are using newer API version and "
                     "new field names defined for that version. Then the warning "
                     "can be safely ignored, or you might want to upgrade the operator"
-                    "to the version that supports the new API version.".format(
-                        self._get_field_name_with_parent(field_name, full_field_path),
-                        children_validation_specs))
+                    "to the version that supports the new API version.",
+                    self._get_field_name_with_parent(field_name, full_field_path),
+                    children_validation_specs)
 
     def _validate_union(self, children_validation_specs, full_field_path,
                         dictionary_to_validate):
@@ -297,15 +297,14 @@ def _validate_union(self, children_validation_specs, full_field_path,
                 found_field_name = field_name
         if not field_found:
             self.log.warning(
-                "There is no '{}' union defined in the body {}. "
-                "Validation expected one of '{}' but could not find any. It's possible "
+                "There is no '%s' union defined in the body %s. "
+                "Validation expected one of '%s' but could not find any. It's possible "
                 "that you are using newer API version and there is another union variant "
                 "defined for that version. Then the warning can be safely ignored, "
                 "or you might want to upgrade the operator to the version that "
-                "supports the new API version.".format(
-                    full_field_path,
-                    dictionary_to_validate,
-                    [field['name'] for field in children_validation_specs]))
+                "supports the new API version.",
+                full_field_path, dictionary_to_validate,
+                [field['name'] for field in children_validation_specs])
 
     def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                         force_optional=False):
@@ -335,15 +334,14 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                                                            parent=parent)
         if required_api_version and required_api_version != self._api_version:
             self.log.debug(
-                "Skipping validation of the field '{}' for API version '{}' "
-                "as it is only valid for API version '{}'".
-                format(field_name, self._api_version, required_api_version))
+                "Skipping validation of the field '%s' for API version '%s' "
+                "as it is only valid for API version '%s'",
+                field_name, self._api_version, required_api_version)
             return False
         value = dictionary_to_validate.get(field_name)
 
         if (optional or force_optional) and value is None:
-            self.log.debug("The optional field '{}' is missing. That's perfectly OK.".
-                           format(full_field_path))
+            self.log.debug("The optional field '%s' is missing. That's perfectly OK.", full_field_path)
             return False
 
         # Certainly down from here the field is present (value is not None)
@@ -369,18 +367,17 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                     format(full_field_path, validation_spec, value))
             if children_validation_specs is None:
                 self.log.debug(
-                    "The dict field '{}' has no nested fields defined in the "
-                    "specification '{}'. That's perfectly ok - it's content will "
-                    "not be validated."
-                        .format(full_field_path, validation_spec))
+                    "The dict field '%s' has no nested fields defined in the "
+                    "specification '%s'. That's perfectly ok - it's content will "
+                    "not be validated.", full_field_path, validation_spec)
             else:
                 self._validate_dict(children_validation_specs, full_field_path, value)
         elif field_type == 'union':
             if not children_validation_specs:
                 raise GcpValidationSpecificationException(
-                    "The union field '{}' has no nested fields "
-                    "defined in specification '{}'. Unions should have at least one "
-                    "nested field defined.".format(full_field_path, validation_spec))
+                    "The union field '%s' has no nested fields "
+                    "defined in specification '%s'. Unions should have at least one "
+                    "nested field defined.", full_field_path, validation_spec)
             self._validate_union(children_validation_specs, full_field_path,
                                  dictionary_to_validate)
         elif field_type == 'list':
@@ -397,9 +394,8 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                     "Error while validating custom field '{}' specified by '{}': '{}'".
                     format(full_field_path, validation_spec, e))
         elif field_type is None:
-            self.log.debug("The type of field '{}' is not specified in '{}'. "
-                           "Not validating its content.".
-                           format(full_field_path, validation_spec))
+            self.log.debug("The type of field '%s' is not specified in '%s'. "
+                           "Not validating its content.", full_field_path, validation_spec)
         else:
             raise GcpValidationSpecificationException(
                 "The field '{}' is of type '{}' in specification '{}'."
@@ -438,10 +434,10 @@ def validate(self, body_to_validate):
         for field_name in body_to_validate.keys():
             if field_name not in all_field_names:
                 self.log.warning(
-                    "The field '{}' is in the body, but is not specified in the "
-                    "validation specification '{}'. "
+                    "The field '%s' is in the body, but is not specified in the "
+                    "validation specification '%s'. "
                     "This might be because you are using newer API version and "
                     "new field names defined for that version. Then the warning "
                     "can be safely ignored, or you might want to upgrade the operator"
-                    "to the version that supports the new API version.".format(
-                        field_name, self._validation_specs))
+                    "to the version that supports the new API version.",
+                    field_name, self._validation_specs)
diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index fad3c5a0ee3a6..a0b71e575a2c2 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -58,7 +58,7 @@ def queue_command(self, simple_task_instance, command, priority=1, queue=None):
             self.log.info("Adding to queue: %s", command)
             self.queued_tasks[key] = (command, priority, queue, simple_task_instance)
         else:
-            self.log.info("could not queue task {}".format(key))
+            self.log.info("could not queue task %s", key)
 
     def queue_task_instance(
             self,
@@ -139,7 +139,7 @@ def heartbeat(self):
         self.sync()
 
     def change_state(self, key, state):
-        self.log.debug("Changing state: {}".format(key))
+        self.log.debug("Changing state: %s", key)
         self.running.pop(key, None)
         self.event_buffer[key] = state
 
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index 98ce6efba7546..db46d29ca6383 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -149,8 +149,9 @@ def __init__(self):
 
     def start(self):
         self.log.debug(
-            'Starting Celery Executor using {} processes for syncing'.format(
-                self._sync_parallelism))
+            'Starting Celery Executor using %s processes for syncing',
+            self._sync_parallelism
+        )
 
     def _num_tasks_per_send_process(self, to_send_count):
         """
@@ -179,9 +180,9 @@ def heartbeat(self):
         else:
             open_slots = self.parallelism - len(self.running)
 
-        self.log.debug("{} running task instances".format(len(self.running)))
-        self.log.debug("{} in queue".format(len(self.queued_tasks)))
-        self.log.debug("{} open slots".format(open_slots))
+        self.log.debug("%s running task instances", len(self.running))
+        self.log.debug("%s in queue", len(self.queued_tasks))
+        self.log.debug("%s open slots", open_slots)
 
         sorted_queue = sorted(
             [(k, v) for k, v in self.queued_tasks.items()],
@@ -222,8 +223,8 @@ def heartbeat(self):
             for key, command, result in key_and_async_results:
                 if isinstance(result, ExceptionWithTraceback):
                     self.log.error(
-                        CELERY_SEND_ERR_MSG_HEADER + ":{}\n{}\n".format(
-                            result.exception, result.traceback))
+                        CELERY_SEND_ERR_MSG_HEADER + ":%s\n%s\n", result.exception, result.traceback
+                    )
                 elif result is not None:
                     # Only pops when enqueued successfully, otherwise keep it
                     # and expect scheduler loop to deal with it.
@@ -234,7 +235,7 @@ def heartbeat(self):
                     self.last_state[key] = celery_states.PENDING
 
         # Calling child class sync method
-        self.log.debug("Calling the {} sync method".format(self.__class__))
+        self.log.debug("Calling the %s sync method", self.__class__)
         self.sync()
 
     def sync(self):
@@ -265,8 +266,9 @@ def sync(self):
         for key_and_state in task_keys_to_states:
             if isinstance(key_and_state, ExceptionWithTraceback):
                 self.log.error(
-                    CELERY_FETCH_ERR_MSG_HEADER + ", ignoring it:{}\n{}\n".format(
-                        key_and_state.exception, key_and_state.traceback))
+                    CELERY_FETCH_ERR_MSG_HEADER + ", ignoring it:%s\n%s\n",
+                    repr(key_and_state.exception), key_and_state.traceback
+                )
                 continue
             key, state = key_and_state
             try:
@@ -284,7 +286,7 @@ def sync(self):
                         del self.tasks[key]
                         del self.last_state[key]
                     else:
-                        self.log.info("Unexpected state: " + state)
+                        self.log.info("Unexpected state: %s", state)
                         self.last_state[key] = state
             except Exception:
                 self.log.exception("Error syncing the Celery executor, ignoring it.")
diff --git a/airflow/hooks/dbapi_hook.py b/airflow/hooks/dbapi_hook.py
index 4fce22786997e..7fa69436e6a13 100644
--- a/airflow/hooks/dbapi_hook.py
+++ b/airflow/hooks/dbapi_hook.py
@@ -256,12 +256,11 @@ def insert_rows(self, table, rows, target_fields=None, commit_every=1000,
                     if commit_every and i % commit_every == 0:
                         conn.commit()
                         self.log.info(
-                            "Loaded {i} into {table} rows so far".format(**locals())
+                            "Loaded %s into %s rows so far", i, table
                         )
 
             conn.commit()
-        self.log.info(
-            "Done loading. Loaded a total of {i} rows".format(**locals()))
+        self.log.info("Done loading. Loaded a total of %s rows", i)
 
     @staticmethod
     def _serialize_cell(cell, conn=None):
diff --git a/airflow/hooks/druid_hook.py b/airflow/hooks/druid_hook.py
index a45ebf472fe68..5e2f94f1258dd 100644
--- a/airflow/hooks/druid_hook.py
+++ b/airflow/hooks/druid_hook.py
@@ -68,7 +68,7 @@ def get_conn_url(self):
     def submit_indexing_job(self, json_index_spec):
         url = self.get_conn_url()
 
-        self.log.info("Druid ingestion spec: {}".format(json_index_spec))
+        self.log.info("Druid ingestion spec: %s", json_index_spec)
         req_index = requests.post(url, json=json_index_spec, headers=self.header)
         if req_index.status_code != 200:
             raise AirflowException('Did not get 200 when '
@@ -77,7 +77,7 @@ def submit_indexing_job(self, json_index_spec):
         req_json = req_index.json()
         # Wait until the job is completed
         druid_task_id = req_json['task']
-        self.log.info("Druid indexing task-id: {}".format(druid_task_id))
+        self.log.info("Druid indexing task-id: %s", druid_task_id)
 
         running = True
 
@@ -136,8 +136,7 @@ def get_conn(self):
             path=conn.extra_dejson.get('endpoint', '/druid/v2/sql'),
             scheme=conn.extra_dejson.get('schema', 'http')
         )
-        self.log.info('Get the connection to druid '
-                      'broker on {host}'.format(host=conn.host))
+        self.log.info('Get the connection to druid broker on %s', conn.host)
         return druid_broker_conn
 
     def get_uri(self):
diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index 7653072a1f50c..c67dced7b1f87 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -233,7 +233,7 @@ def run_cli(self, hql, schema=None, verbose=True, hive_conf=None):
                 hive_cmd.extend(['-f', f.name])
 
                 if verbose:
-                    self.log.info(" ".join(hive_cmd))
+                    self.log.info("%s", " ".join(hive_cmd))
                 sp = subprocess.Popen(
                     hive_cmd,
                     stdout=subprocess.PIPE,
diff --git a/airflow/hooks/http_hook.py b/airflow/hooks/http_hook.py
index 200a6741f2cae..9c8c3854f2200 100644
--- a/airflow/hooks/http_hook.py
+++ b/airflow/hooks/http_hook.py
@@ -75,8 +75,7 @@ def get_conn(self, headers=None):
             try:
                 session.headers.update(conn.extra_dejson)
             except TypeError:
-                self.log.warn('Connection to {} has invalid extra field.'.format(
-                    conn.host))
+                self.log.warn('Connection to %s has invalid extra field.', conn.host)
         if headers:
             session.headers.update(headers)
 
diff --git a/airflow/hooks/oracle_hook.py b/airflow/hooks/oracle_hook.py
index c98dbf62a2bc8..5d617c9a87073 100644
--- a/airflow/hooks/oracle_hook.py
+++ b/airflow/hooks/oracle_hook.py
@@ -175,11 +175,11 @@ def insert_rows(self, table, rows, target_fields=None, commit_every=1000):
             cur.execute(sql)
             if i % commit_every == 0:
                 conn.commit()
-                self.log.info('Loaded {i} into {table} rows so far'.format(**locals()))
+                self.log.info('Loaded %s into %s rows so far', i, table)
         conn.commit()
         cur.close()
         conn.close()
-        self.log.info('Done loading. Loaded a total of {i} rows'.format(**locals()))
+        self.log.info('Done loading. Loaded a total of %s rows', i)
 
     def bulk_insert_rows(self, table, rows, target_fields=None, commit_every=5000):
         """
diff --git a/airflow/hooks/pig_hook.py b/airflow/hooks/pig_hook.py
index a3836b1ba321f..fb5ed5b813039 100644
--- a/airflow/hooks/pig_hook.py
+++ b/airflow/hooks/pig_hook.py
@@ -67,7 +67,7 @@ def run_cli(self, pig, verbose=True):
                     pig_properties_list = self.pig_properties.split()
                     pig_cmd.extend(pig_properties_list)
                 if verbose:
-                    self.log.info(" ".join(pig_cmd))
+                    self.log.info("%s", " ".join(pig_cmd))
                 sp = subprocess.Popen(
                     pig_cmd,
                     stdout=subprocess.PIPE,
diff --git a/airflow/hooks/webhdfs_hook.py b/airflow/hooks/webhdfs_hook.py
index 9833be6cd6e6c..58289ba40653a 100644
--- a/airflow/hooks/webhdfs_hook.py
+++ b/airflow/hooks/webhdfs_hook.py
@@ -66,8 +66,8 @@ def get_conn(self):
                 return client
             except HdfsError as e:
                 self.log.debug(
-                    "Read operation on namenode {nn.host} "
-                    "failed with error: {e}".format(nn=nn, e=e)
+                    "Read operation on namenode %s "
+                    "failed with error: %s", nn.host, e
                 )
         nn_hosts = [c.host for c in nn_connections]
         no_nn_error = "Read operations failed " \
diff --git a/airflow/jobs.py b/airflow/jobs.py
index a0bd9129d5fe2..ffcf84a068890 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -124,7 +124,7 @@ def kill(self, session=None):
         try:
             self.on_kill()
         except Exception as e:
-            self.log.error('on_kill() method failed: {}'.format(e))
+            self.log.error('on_kill() method failed: %s', str(e))
         session.merge(job)
         session.commit()
         raise AirflowException("Job shut down externally.")
@@ -610,7 +610,7 @@ def _exit_gracefully(self, signum, frame):
         """
         Helper method to clean up processor_agent to avoid leaving orphan processes.
         """
-        self.log.info("Exiting gracefully upon receiving signal {}".format(signum))
+        self.log.info("Exiting gracefully upon receiving signal %s", signum)
         if self.processor_agent:
             self.processor_agent.end()
         sys.exit(os.EX_OK)
@@ -625,10 +625,7 @@ def manage_slas(self, dag, session=None):
         tasks that should have succeeded in the past hour.
         """
         if not any([ti.sla for ti in dag.tasks]):
-            self.log.info(
-                "Skipping SLA check for %s because no tasks in DAG have SLAs",
-                dag
-            )
+            self.log.info("Skipping SLA check for %s because no tasks in DAG have SLAs", dag)
             return
 
         TI = models.TaskInstance
@@ -1105,9 +1102,10 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         # Put one task instance on each line
         task_instance_str = "\n\t".join(
             ["{}".format(x) for x in task_instances_to_examine])
-        self.log.info("{} tasks up for execution:\n\t{}"
-                      .format(len(task_instances_to_examine),
-                              task_instance_str))
+        self.log.info(
+            "%s tasks up for execution:\n\t%s", len(task_instances_to_examine),
+            task_instance_str
+        )
 
         # Get the pool settings
         pools = {p.pool: p for p in session.query(models.Pool).all()}
@@ -1140,10 +1138,9 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
 
             num_queued = len(task_instances)
             self.log.info(
-                "Figuring out tasks to run in Pool(name={pool}) with {open_slots} "
-                "open slots and {num_queued} task instances in queue".format(
-                    **locals()
-                )
+                "Figuring out tasks to run in Pool(name=%s) with %s open slots "
+                "and %s task instances in queue",
+                pool, open_slots, num_queued
             )
 
             priority_sorted_task_instances = sorted(
@@ -1290,8 +1287,8 @@ def _change_state_for_executable_task_instances(self, task_instances,
             ["{}".format(x) for x in tis_to_set_to_queued])
 
         session.commit()
-        self.log.info("Setting the following {} tasks to queued state:\n\t{}"
-                      .format(len(tis_to_set_to_queued), task_instance_str))
+        self.log.info("Setting the following %s tasks to queued state:\n\t%s",
+                      len(tis_to_set_to_queued), task_instance_str)
         return simple_task_instances
 
     def _enqueue_task_instances_with_queued_state(self, simple_dag_bag,
@@ -2116,27 +2113,13 @@ def _task_instances_for_dag_run(self, dag_run, session=None):
         return tasks_to_run
 
     def _log_progress(self, ti_status):
-        msg = ' | '.join([
-            "[backfill progress]",
-            "finished run {0} of {1}",
-            "tasks waiting: {2}",
-            "succeeded: {3}",
-            "running: {4}",
-            "failed: {5}",
-            "skipped: {6}",
-            "deadlocked: {7}",
-            "not ready: {8}"
-        ]).format(
-            ti_status.finished_runs,
-            ti_status.total_runs,
-            len(ti_status.to_run),
-            len(ti_status.succeeded),
-            len(ti_status.running),
-            len(ti_status.failed),
-            len(ti_status.skipped),
-            len(ti_status.deadlocked),
-            len(ti_status.not_ready))
-        self.log.info(msg)
+        self.log.info(
+            '[backfill progress] | finished run %s of %s | tasks waiting: %s | succeeded: %s | '
+            'running: %s | failed: %s | skipped: %s | deadlocked: %s | not ready: %s',
+            ti_status.finished_runs, ti_status.total_runs, len(ti_status.to_run), len(ti_status.succeeded),
+            len(ti_status.running), len(ti_status.failed), len(ti_status.skipped), len(ti_status.deadlocked),
+            len(ti_status.not_ready)
+        )
 
         self.log.debug(
             "Finished dag run loop iteration. Remaining tasks %s",
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 9b47333567ae9..fabb368fc2d16 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -524,7 +524,7 @@ def bag_dag(self, dag, parent_dag, root_dag):
                 self.bag_dag(subdag, parent_dag=dag, root_dag=root_dag)
 
             self.dags[dag.dag_id] = dag
-            self.log.debug('Loaded DAG {dag}'.format(**locals()))
+            self.log.debug('Loaded DAG %s', dag)
         except AirflowDagCycleException as cycle_exception:
             # There was an error in bagging the dag. Remove it from the list of dags
             self.log.exception('Exception bagging dag: {dag.dag_id}'.format(**locals()))
@@ -1312,15 +1312,11 @@ def _check_and_change_state_before_execution(
             return False
 
         # TODO: Logging needs cleanup, not clear what is being printed
-        hr = "\n" + ("-" * 80) + "\n"  # Line break
+        hr = "\n" + ("-" * 80)  # Line break
 
         # For reporting purposes, we report based on 1-indexed,
         # not 0-indexed lists (i.e. Attempt 1 instead of
         # Attempt 0 for the first attempt).
-        msg = "Starting attempt {attempt} of {total}".format(
-            attempt=self.try_number,
-            total=self.max_tries + 1)
-
         # Set the task start date. In case it was re-scheduled use the initial
         # start date that is recorded in task_reschedule table
         self.start_date = timezone.utcnow()
@@ -1344,11 +1340,12 @@ def _check_and_change_state_before_execution(
             # have been running prematurely. This should be handled in the
             # scheduling mechanism.
             self.state = State.NONE
-            msg = ("FIXME: Rescheduling due to concurrency limits reached at task "
-                   "runtime. Attempt {attempt} of {total}. State set to NONE.").format(
-                attempt=self.try_number,
-                total=self.max_tries + 1)
-            self.log.warning(hr + msg + hr)
+            self.log.warning(hr)
+            self.log.warning(
+                "FIXME: Rescheduling due to concurrency limits reached at task runtime. Attempt %s of "
+                "%s. State set to NONE.", self.try_number, self.max_tries + 1
+            )
+            self.log.warning(hr)
 
             self.queued_dttm = timezone.utcnow()
             self.log.info("Queuing into pool %s", self.pool)
@@ -1359,13 +1356,14 @@ def _check_and_change_state_before_execution(
         # Another worker might have started running this task instance while
         # the current worker process was blocked on refresh_from_db
         if self.state == State.RUNNING:
-            msg = "Task Instance already running {}".format(self)
-            self.log.warning(msg)
+            self.log.warning("Task Instance already running %s", self)
             session.commit()
             return False
 
         # print status message
-        self.log.info(hr + msg + hr)
+        self.log.info(hr)
+        self.log.info("Starting attempt %s of %s", self.try_number, self.max_tries + 1)
+        self.log.info(hr)
         self._try_number += 1
 
         if not test_mode:
@@ -1382,12 +1380,9 @@ def _check_and_change_state_before_execution(
         settings.engine.dispose()
         if verbose:
             if mark_success:
-                msg = "Marking success for {} on {}".format(self.task,
-                                                            self.execution_date)
-                self.log.info(msg)
+                self.log.info("Marking success for %s on %s", self.task, self.execution_date)
             else:
-                msg = "Executing {} on {}".format(self.task, self.execution_date)
-                self.log.info(msg)
+                self.log.info("Executing %s on %s", self.task, self.execution_date)
         return True
 
     @provide_session
diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index f9c2e1bbc007d..8bb3111d4788a 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -80,7 +80,7 @@ def execute(self, context):
         if self.env is None:
             self.env = os.environ.copy()
         airflow_context_vars = context_to_airflow_vars(context, in_env_var_format=True)
-        self.log.info("Exporting the following env vars:\n" +
+        self.log.info('Exporting the following env vars:\n%s',
                       '\n'.join(["{}={}".format(k, v)
                                  for k, v in
                                  airflow_context_vars.items()]))
diff --git a/airflow/operators/check_operator.py b/airflow/operators/check_operator.py
index 404964dad6cc8..97e18571fda84 100644
--- a/airflow/operators/check_operator.py
+++ b/airflow/operators/check_operator.py
@@ -233,29 +233,25 @@ def execute(self, context=None):
         reference = dict(zip(self.metrics_sorted, row2))
         ratios = {}
         test_results = {}
-        rlog = "Ratio for {0}: {1} \n Ratio threshold : {2}"
-        fstr = "'{k}' check failed. {r} is above {tr}"
-        estr = "The following tests have failed:\n {0}"
-        countstr = "The following {j} tests out of {n} failed:"
         for m in self.metrics_sorted:
             if current[m] == 0 or reference[m] == 0:
                 ratio = None
             else:
                 ratio = float(max(current[m], reference[m])) / \
                     min(current[m], reference[m])
-            self.log.info(rlog.format(m, ratio, self.metrics_thresholds[m]))
+            self.log.info("Ratio for %s: %s \n Ratio threshold : %s", m, ratio, self.metrics_thresholds[m])
             ratios[m] = ratio
             test_results[m] = ratio < self.metrics_thresholds[m]
         if not all(test_results.values()):
             failed_tests = [it[0] for it in test_results.items() if not it[1]]
             j = len(failed_tests)
             n = len(self.metrics_sorted)
-            self.log.warning(countstr.format(**locals()))
+            self.log.warning("The following %s tests out of %s failed:", j, n)
             for k in failed_tests:
                 self.log.warning(
-                    fstr.format(k=k, r=ratios[k], tr=self.metrics_thresholds[k])
+                    "'%s' check failed. %s is above %s", k, ratios[k], self.metrics_thresholds[k]
                 )
-            raise AirflowException(estr.format(", ".join(failed_tests)))
+            raise AirflowException("The following tests have failed:\n {0}".format(", ".join(failed_tests)))
         self.log.info("All tests have passed")
 
     def get_db_hook(self):
diff --git a/airflow/operators/druid_check_operator.py b/airflow/operators/druid_check_operator.py
index 514f61fc88988..ac18f0567d4ad 100644
--- a/airflow/operators/druid_check_operator.py
+++ b/airflow/operators/druid_check_operator.py
@@ -83,9 +83,9 @@ def get_first(self, sql):
             return cur.fetchone()
 
     def execute(self, context=None):
-        self.log.info('Executing SQL check: {}'.format(self.sql))
+        self.log.info('Executing SQL check: %s', self.sql)
         record = self.get_first(self.sql)
-        self.log.info("Record: {}".format(str(record)))
+        self.log.info("Record: %s", str(record))
         if not record:
             raise AirflowException("The query returned None")
         self.log.info("Success.")
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 678e8fe986b21..a4a426879153e 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -90,7 +90,7 @@ def __init__(
     def execute(self, context):
         # Export context to make it available for callables to use.
         airflow_context_vars = context_to_airflow_vars(context, in_env_var_format=True)
-        self.log.info("Exporting the following env vars:\n" +
+        self.log.info("Exporting the following env vars:\n%s",
                       '\n'.join(["{}={}".format(k, v)
                                  for k, v in airflow_context_vars.items()]))
         os.environ.update(airflow_context_vars)
@@ -305,14 +305,14 @@ def _pass_op_args(self):
 
     def _execute_in_subprocess(self, cmd):
         try:
-            self.log.info("Executing cmd\n{}".format(cmd))
+            self.log.info("Executing cmd\n%s", cmd)
             output = subprocess.check_output(cmd,
                                              stderr=subprocess.STDOUT,
                                              close_fds=True)
             if output:
-                self.log.info("Got output\n{}".format(output))
+                self.log.info("Got output\n%s", output)
         except subprocess.CalledProcessError as e:
-            self.log.info("Got error output\n{}".format(e.output))
+            self.log.info("Got error output\n%s", e.output)
             raise
 
     def _write_string_args(self, filename):
diff --git a/airflow/operators/s3_to_hive_operator.py b/airflow/operators/s3_to_hive_operator.py
index 85f05325f65be..0e28ffaf5c68e 100644
--- a/airflow/operators/s3_to_hive_operator.py
+++ b/airflow/operators/s3_to_hive_operator.py
@@ -173,8 +173,9 @@ def execute(self, context):
                 NamedTemporaryFile(mode="wb",
                                    dir=tmp_dir,
                                    suffix=file_ext) as f:
-            self.log.info("Dumping S3 key {0} contents to local file {1}"
-                          .format(s3_key_object.key, f.name))
+            self.log.info(
+                "Dumping S3 key %s contents to local file %s", s3_key_object.key, f.name
+            )
             if self.select_expression:
                 option = {}
                 if self.headers:
@@ -257,18 +258,17 @@ def _match_headers(self, header_list):
             raise AirflowException("Unable to retrieve header row from file")
         field_names = self.field_dict.keys()
         if len(field_names) != len(header_list):
-            self.log.warning("Headers count mismatch"
-                             "File headers:\n {header_list}\n"
-                             "Field names: \n {field_names}\n"
-                             .format(**locals()))
+            self.log.warning(
+                "Headers count mismatch File headers:\n %s\nField names: \n %s\n", header_list, field_names
+            )
             return False
         test_field_match = [h1.lower() == h2.lower()
                             for h1, h2 in zip(header_list, field_names)]
         if not all(test_field_match):
-            self.log.warning("Headers do not match field names"
-                             "File headers:\n {header_list}\n"
-                             "Field names: \n {field_names}\n"
-                             .format(**locals()))
+            self.log.warning(
+                "Headers do not match field names File headers:\n %s\nField names: \n %s\n",
+                header_list, field_names
+            )
             return False
         else:
             return True
diff --git a/airflow/security/kerberos.py b/airflow/security/kerberos.py
index b91241bc1de1c..3fc6aa345d79f 100644
--- a/airflow/security/kerberos.py
+++ b/airflow/security/kerberos.py
@@ -45,7 +45,7 @@ def renew_from_kt(principal, keytab):
         "-c", configuration.conf.get('kerberos', 'ccache'),  # specify credentials cache
         cmd_principal
     ]
-    log.info("Reinitting kerberos from keytab: " + " ".join(cmdv))
+    log.info("Reinitting kerberos from keytab: %s", " ".join(cmdv))
 
     subp = subprocess.Popen(cmdv,
                             stdout=subprocess.PIPE,
@@ -55,10 +55,10 @@ def renew_from_kt(principal, keytab):
                             universal_newlines=True)
     subp.wait()
     if subp.returncode != 0:
-        log.error("Couldn't reinit from keytab! `kinit' exited with %s.\n%s\n%s" % (
-            subp.returncode,
-            "\n".join(subp.stdout.readlines()),
-            "\n".join(subp.stderr.readlines())))
+        log.error(
+            "Couldn't reinit from keytab! `kinit' exited with %s.\n%s\n%s",
+            subp.returncode, "\n".join(subp.stdout.readlines()), "\n".join(subp.stderr.readlines())
+        )
         sys.exit(subp.returncode)
 
     global NEED_KRB181_WORKAROUND
@@ -76,24 +76,24 @@ def perform_krb181_workaround(principal):
             "-c", configuration.conf.get('kerberos', 'ccache'),
             "-R"]  # Renew ticket_cache
 
-    log.info("Renewing kerberos ticket to work around kerberos 1.8.1: " +
-             " ".join(cmdv))
+    log.info(
+        "Renewing kerberos ticket to work around kerberos 1.8.1: %s", " ".join(cmdv)
+    )
 
     ret = subprocess.call(cmdv, close_fds=True)
 
     if ret != 0:
         principal = "%s/%s" % (principal or configuration.conf.get('kerberos', 'principal'),
                                socket.getfqdn())
-        fmt_dict = dict(princ=principal,
-                        ccache=configuration.conf.get('kerberos', 'principal'))
-        log.error("Couldn't renew kerberos ticket in order to work around "
-                  "Kerberos 1.8.1 issue. Please check that the ticket for "
-                  "'%(princ)s' is still renewable:\n"
-                  "  $ kinit -f -c %(ccache)s\n"
-                  "If the 'renew until' date is the same as the 'valid starting' "
-                  "date, the ticket cannot be renewed. Please check your KDC "
-                  "configuration, and the ticket renewal policy (maxrenewlife) "
-                  "for the '%(princ)s' and `krbtgt' principals." % fmt_dict)
+        princ = principal
+        ccache = configuration.conf.get('kerberos', 'principal')
+        log.error(
+            "Couldn't renew kerberos ticket in order to work around Kerberos 1.8.1 issue. Please check that "
+            "the ticket for '%s' is still renewable:\n  $ kinit -f -c %s\nIf the 'renew until' date is the "
+            "same as the 'valid starting' date, the ticket cannot be renewed. Please check your KDC "
+            "configuration, and the ticket renewal policy (maxrenewlife) for the '%s' and `krbtgt' "
+            "principals.", princ, ccache, princ
+        )
         sys.exit(ret)
 
 
diff --git a/airflow/sensors/external_task_sensor.py b/airflow/sensors/external_task_sensor.py
index 96e5fd8aeb15a..ca98cbf50e736 100644
--- a/airflow/sensors/external_task_sensor.py
+++ b/airflow/sensors/external_task_sensor.py
@@ -109,10 +109,9 @@ def poke(self, context, session=None):
             [datetime.isoformat() for datetime in dttm_filter])
 
         self.log.info(
-            'Poking for '
-            '{self.external_dag_id}.'
-            '{self.external_task_id} on '
-            '{} ... '.format(serialized_dttm_filter, **locals()))
+            'Poking for %s.%s on %s ... ',
+            self.external_dag_id, self.external_task_id, serialized_dttm_filter
+        )
 
         DM = DagModel
         TI = TaskInstance
diff --git a/airflow/sensors/hdfs_sensor.py b/airflow/sensors/hdfs_sensor.py
index 298ac48aecc6c..dbff9b2e1c6a9 100644
--- a/airflow/sensors/hdfs_sensor.py
+++ b/airflow/sensors/hdfs_sensor.py
@@ -99,7 +99,7 @@ def filter_for_ignored_ext(result, ignored_ext, ignore_copying):
 
     def poke(self, context):
         sb = self.hook(self.hdfs_conn_id).get_conn()
-        self.log.info('Poking for file {self.filepath}'.format(**locals()))
+        self.log.info('Poking for file %s', self.filepath)
         try:
             # IMOO it's not right here, as there no raise of any kind.
             # if the filepath is let's say '/data/mydirectory',
diff --git a/airflow/sensors/hive_partition_sensor.py b/airflow/sensors/hive_partition_sensor.py
index ca10c863b478c..5165540bb4346 100644
--- a/airflow/sensors/hive_partition_sensor.py
+++ b/airflow/sensors/hive_partition_sensor.py
@@ -65,8 +65,8 @@ def poke(self, context):
         if '.' in self.table:
             self.schema, self.table = self.table.split('.')
         self.log.info(
-            'Poking for table {self.schema}.{self.table}, '
-            'partition {self.partition}'.format(**locals()))
+            'Poking for table %s.%s, partition %s', self.schema, self.table, self.partition
+        )
         if not hasattr(self, 'hook'):
             from airflow.hooks.hive_hooks import HiveMetastoreHook
             self.hook = HiveMetastoreHook(
diff --git a/airflow/sensors/named_hive_partition_sensor.py b/airflow/sensors/named_hive_partition_sensor.py
index 4a076a3dd6870..84b84d93a9c7d 100644
--- a/airflow/sensors/named_hive_partition_sensor.py
+++ b/airflow/sensors/named_hive_partition_sensor.py
@@ -61,9 +61,9 @@ def __init__(self,
         self.partition_names = partition_names
         self.hook = hook
         if self.hook and metastore_conn_id != 'metastore_default':
-            self.log.warning('A hook was passed but a non default'
-                             'metastore_conn_id='
-                             '{} was used'.format(metastore_conn_id))
+            self.log.warning(
+                'A hook was passed but a non defaul metastore_conn_id=%s was used', metastore_conn_id
+            )
 
     @staticmethod
     def parse_partition_name(partition):
@@ -89,9 +89,7 @@ def poke_partition(self, partition):
 
         schema, table, partition = self.parse_partition_name(partition)
 
-        self.log.info(
-            'Poking for {schema}.{table}/{partition}'.format(**locals())
-        )
+        self.log.info('Poking for %s.%s/%s', schema, table, partition)
         return self.hook.check_for_named_partition(
             schema, table, partition)
 
diff --git a/airflow/sensors/s3_key_sensor.py b/airflow/sensors/s3_key_sensor.py
index 4935561d057f1..d5a148716a845 100644
--- a/airflow/sensors/s3_key_sensor.py
+++ b/airflow/sensors/s3_key_sensor.py
@@ -84,8 +84,7 @@ def __init__(self,
     def poke(self, context):
         from airflow.hooks.S3_hook import S3Hook
         hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
-        full_url = "s3://" + self.bucket_name + "/" + self.bucket_key
-        self.log.info('Poking for key : {full_url}'.format(**locals()))
+        self.log.info('Poking for key : s3://%s/%s', self.bucket_name, self.bucket_key)
         if self.wildcard_match:
             return hook.check_for_wildcard_key(self.bucket_key,
                                                self.bucket_name)
diff --git a/airflow/sensors/s3_prefix_sensor.py b/airflow/sensors/s3_prefix_sensor.py
index 4617c97cf360e..61f9a477ae2ef 100644
--- a/airflow/sensors/s3_prefix_sensor.py
+++ b/airflow/sensors/s3_prefix_sensor.py
@@ -72,8 +72,7 @@ def __init__(self,
         self.verify = verify
 
     def poke(self, context):
-        self.log.info('Poking for prefix : {self.prefix}\n'
-                      'in bucket s3://{self.bucket_name}'.format(**locals()))
+        self.log.info('Poking for prefix : %s in bucket s3://%s', self.prefix, self.bucket_name)
         from airflow.hooks.S3_hook import S3Hook
         hook = S3Hook(aws_conn_id=self.aws_conn_id, verify=self.verify)
         return hook.check_for_prefix(
diff --git a/airflow/sensors/web_hdfs_sensor.py b/airflow/sensors/web_hdfs_sensor.py
index 67b1d385b40a2..f31a307a67ff9 100644
--- a/airflow/sensors/web_hdfs_sensor.py
+++ b/airflow/sensors/web_hdfs_sensor.py
@@ -40,5 +40,5 @@ def __init__(self,
     def poke(self, context):
         from airflow.hooks.webhdfs_hook import WebHDFSHook
         c = WebHDFSHook(self.webhdfs_conn_id)
-        self.log.info('Poking for file {self.filepath}'.format(**locals()))
+        self.log.info('Poking for file %s', self.filepath)
         return c.check_for_path(hdfs_path=self.filepath)
diff --git a/airflow/utils/cli_action_loggers.py b/airflow/utils/cli_action_loggers.py
index 21304936f3ff5..2a0de06d663aa 100644
--- a/airflow/utils/cli_action_loggers.py
+++ b/airflow/utils/cli_action_loggers.py
@@ -37,7 +37,7 @@ def register_pre_exec_callback(action_logger):
     :param action_logger: An action logger function
     :return: None
     """
-    logging.debug("Adding {} to pre execution callback".format(action_logger))
+    logging.debug("Adding %s to pre execution callback", action_logger)
     __pre_exec_callbacks.append(action_logger)
 
 
@@ -50,7 +50,7 @@ def register_post_exec_callback(action_logger):
     :param action_logger: An action logger function
     :return: None
     """
-    logging.debug("Adding {} to post execution callback".format(action_logger))
+    logging.debug("Adding %s to post execution callback", action_logger)
     __post_exec_callbacks.append(action_logger)
 
 
@@ -61,12 +61,12 @@ def on_pre_execution(**kwargs):
     :param kwargs:
     :return: None
     """
-    logging.debug("Calling callbacks: {}".format(__pre_exec_callbacks))
+    logging.debug("Calling callbacks: %s", __pre_exec_callbacks)
     for cb in __pre_exec_callbacks:
         try:
             cb(**kwargs)
         except Exception:
-            logging.exception('Failed on pre-execution callback using {}'.format(cb))
+            logging.exception('Failed on pre-execution callback using %s', cb)
 
 
 def on_post_execution(**kwargs):
@@ -78,12 +78,12 @@ def on_post_execution(**kwargs):
     :param kwargs:
     :return: None
     """
-    logging.debug("Calling callbacks: {}".format(__post_exec_callbacks))
+    logging.debug("Calling callbacks: %s", __post_exec_callbacks)
     for cb in __post_exec_callbacks:
         try:
             cb(**kwargs)
         except Exception:
-            logging.exception('Failed on post-execution callback using {}'.format(cb))
+            logging.exception('Failed on post-execution callback using %s', cb)
 
 
 def default_action_log(log, **_):
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 6264fc4939a8e..27a5da252dc21 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -509,8 +509,7 @@ def start(self):
                                              self._stat_queue,
                                              self._result_queue,
                                              self._async_mode)
-        self.log.info("Launched DagFileProcessorManager with pid: {}"
-                      .format(self._process.pid))
+        self.log.info("Launched DagFileProcessorManager with pid: %s", self._process.pid)
 
     def heartbeat(self):
         """
@@ -648,13 +647,11 @@ def end(self):
         # First try SIGTERM
         if manager_process.is_running() \
                 and manager_process.pid in [x.pid for x in this_process.children()]:
-            self.log.info(
-                "Terminating manager process: {}".format(manager_process.pid))
+            self.log.info("Terminating manager process: %s", manager_process.pid)
             manager_process.terminate()
             # TODO: Remove magic number
             timeout = 5
-            self.log.info("Waiting up to {}s for manager process to exit..."
-                          .format(timeout))
+            self.log.info("Waiting up to %ss for manager process to exit...", timeout)
             try:
                 psutil.wait_procs({manager_process}, timeout)
             except psutil.TimeoutExpired:
@@ -664,7 +661,7 @@ def end(self):
         # Then SIGKILL
         if manager_process.is_running() \
                 and manager_process.pid in [x.pid for x in this_process.children()]:
-            self.log.info("Killing manager process: {}".format(manager_process.pid))
+            self.log.info("Killing manager process: %s", manager_process.pid)
             manager_process.kill()
             manager_process.wait()
 
@@ -770,7 +767,7 @@ def _exit_gracefully(self, signum, frame):
         """
         Helper method to clean up DAG file processors to avoid leaving orphan processes.
         """
-        self.log.info("Exiting gracefully upon receiving signal {}".format(signum))
+        self.log.info("Exiting gracefully upon receiving signal %s", signum)
         self.terminate()
         self.end()
         self.log.debug("Finished terminating DAG processors.")
@@ -785,12 +782,11 @@ def start(self):
         :return:
         """
 
-        self.log.info("Processing files using up to {} processes at a time "
-                      .format(self._parallelism))
-        self.log.info("Process each file at most once every {} seconds"
-                      .format(self._file_process_interval))
-        self.log.info("Checking for new files in {} every {} seconds"
-                      .format(self._dag_directory, self.dag_dir_list_interval))
+        self.log.info("Processing files using up to %s processes at a time ", self._parallelism)
+        self.log.info("Process each file at most once every %s seconds", self._file_process_interval)
+        self.log.info(
+            "Checking for new files in %s every %s seconds", self._dag_directory, self.dag_dir_list_interval
+        )
 
         if self._async_mode:
             self.log.debug("Starting DagFileProcessorManager in async mode")
@@ -842,8 +838,7 @@ def start_in_async(self):
             loop_duration = time.time() - loop_start_time
             if loop_duration < 1:
                 sleep_length = 1 - loop_duration
-                self.log.debug("Sleeping for {0:.2f} seconds "
-                               "to prevent excessive logging".format(sleep_length))
+                self.log.debug("Sleeping for %.2f seconds to prevent excessive logging", sleep_length)
                 time.sleep(sleep_length)
 
     def start_in_sync(self):
@@ -898,13 +893,10 @@ def _refresh_dag_dir(self):
                                       self.last_dag_dir_refresh_time).total_seconds()
         if elapsed_time_since_refresh > self.dag_dir_list_interval:
             # Build up a list of Python files that could contain DAGs
-            self.log.info(
-                "Searching for files in {}".format(self._dag_directory))
+            self.log.info("Searching for files in %s", self._dag_directory)
             self._file_paths = list_py_file_paths(self._dag_directory)
             self.last_dag_dir_refresh_time = timezone.utcnow()
-            self.log.info("There are {} files in {}"
-                          .format(len(self._file_paths),
-                                  self._dag_directory))
+            self.log.info("There are %s files in %s", len(self._file_paths), self._dag_directory)
             self.set_file_paths(self._file_paths)
 
             try:
@@ -1237,8 +1229,7 @@ def _find_zombies(self, session):
             TI = airflow.models.TaskInstance
             limit_dttm = timezone.utcnow() - timedelta(
                 seconds=self._zombie_threshold_secs)
-            self.log.info(
-                "Failing jobs without heartbeat after {}".format(limit_dttm))
+            self.log.info("Failing jobs without heartbeat after %s", limit_dttm)
 
             tis = (
                 session.query(TI)
@@ -1293,12 +1284,11 @@ def end(self):
             child_processes = [x for x in this_process.children(recursive=True)
                                if x.is_running() and x.pid in pids_to_kill]
             for child in child_processes:
-                self.log.info("Terminating child PID: {}".format(child.pid))
+                self.log.info("Terminating child PID: %s", child.pid)
                 child.terminate()
             # TODO: Remove magic number
             timeout = 5
-            self.log.info(
-                "Waiting up to %s seconds for processes to exit...", timeout)
+            self.log.info("Waiting up to %s seconds for processes to exit...", timeout)
             try:
                 psutil.wait_procs(
                     child_processes, timeout=timeout,
@@ -1312,6 +1302,6 @@ def end(self):
             if len(child_processes) > 0:
                 self.log.info("SIGKILL processes that did not terminate gracefully")
                 for child in child_processes:
-                    self.log.info("Killing child PID: {}".format(child.pid))
+                    self.log.info("Killing child PID: %s", child.pid)
                     child.kill()
                     child.wait()
diff --git a/airflow/utils/log/es_task_handler.py b/airflow/utils/log/es_task_handler.py
index 16372c0600bb5..687e14b5e2830 100644
--- a/airflow/utils/log/es_task_handler.py
+++ b/airflow/utils/log/es_task_handler.py
@@ -147,9 +147,7 @@ def es_read(self, log_id, offset):
                 logs = s[self.MAX_LINE_PER_PAGE * self.PAGE:self.MAX_LINE_PER_PAGE] \
                     .execute()
             except Exception as e:
-                msg = 'Could not read log with log_id: {}, ' \
-                      'error: {}'.format(log_id, str(e))
-                self.log.exception(msg)
+                self.log.exception('Could not read log with log_id: %s, error: %s', log_id, str(e))
 
         return logs
 
diff --git a/airflow/utils/log/gcs_task_handler.py b/airflow/utils/log/gcs_task_handler.py
index a9502ef8db64f..ed7edf4a27010 100644
--- a/airflow/utils/log/gcs_task_handler.py
+++ b/airflow/utils/log/gcs_task_handler.py
@@ -49,8 +49,8 @@ def _build_hook(self):
         except Exception as e:
             self.log.error(
                 'Could not create a GoogleCloudStorageHook with connection id '
-                '"{}". {}\n\nPlease make sure that airflow[gcp_api] is installed '
-                'and the GCS connection exists.'.format(remote_conn_id, str(e))
+                '"%s". %s\n\nPlease make sure that airflow[gcp_api] is installed '
+                'and the GCS connection exists.', remote_conn_id, str(e)
             )
 
     @property
diff --git a/airflow/utils/timeout.py b/airflow/utils/timeout.py
index f64800587792b..362baa197f33d 100644
--- a/airflow/utils/timeout.py
+++ b/airflow/utils/timeout.py
@@ -39,7 +39,7 @@ def __init__(self, seconds=1, error_message='Timeout'):
         self.error_message = error_message + ', PID: ' + str(os.getpid())
 
     def handle_timeout(self, signum, frame):
-        self.log.error("Process timed out, PID: " + str(os.getpid()))
+        self.log.error("Process timed out, PID: %s", str(os.getpid()))
         raise AirflowTaskTimeout(self.error_message)
 
     def __enter__(self):
diff --git a/airflow/www/api/experimental/endpoints.py b/airflow/www/api/experimental/endpoints.py
index abcea15e3019a..8ba47fb114a62 100644
--- a/airflow/www/api/experimental/endpoints.py
+++ b/airflow/www/api/experimental/endpoints.py
@@ -88,7 +88,7 @@ def trigger_dag(dag_id):
         return response
 
     if getattr(g, 'user', None):
-        _log.info("User {} created {}".format(g.user, dr))
+        _log.info("User %s created %s", g.user, dr)
 
     response = jsonify(message="Created {}".format(dr))
     return response
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index 9812222d73aca..b75379e22e6ab 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -192,7 +192,8 @@ def init_role(self, role_name, role_vms, role_perms):
             self.get_session.merge(role)
             self.get_session.commit()
         else:
-            self.log.info('Existing permissions for the role:%s within the database will persist.', role_name)
+            self.log.debug('Existing permissions for the role:%s '
+                           'within the database will persist.', role_name)
 
     def get_user_roles(self, user=None):
         """
@@ -311,7 +312,7 @@ def clean_perms(self):
         deleted_count = pvms.delete()
         sesh.commit()
         if deleted_count:
-            self.log.info('Deleted {} faulty permissions'.format(deleted_count))
+            self.log.info('Deleted %s faulty permissions', deleted_count)
 
     def _merge_perm(self, permission_name, view_menu_name):
         """
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index be337c64baec2..5cee388599ff0 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -69,7 +69,7 @@ def test_delete_cluster_not_found(self, wait_mock, convert_mock, log_mock):
         self.gke_hook.delete_cluster('not-existing')
         wait_mock.assert_not_called()
         convert_mock.assert_not_called()
-        log_mock.info.assert_any_call("Assuming Success: " + message)
+        log_mock.info.assert_any_call("Assuming Success: %s", message)
 
     @mock.patch("airflow.contrib.hooks.gcp_container_hook.GKEClusterHook._dict_to_proto")
     @mock.patch(
@@ -162,7 +162,7 @@ def test_create_cluster_already_exists(self, wait_mock, convert_mock, log_mock):
         self.gke_hook.create_cluster({})
         wait_mock.assert_not_called()
         self.assertEqual(convert_mock.call_count, 1)
-        log_mock.info.assert_any_call("Assuming Success: " + message)
+        log_mock.info.assert_any_call("Assuming Success: %s", message)
 
 
 class GKEClusterHookGetTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index b337791be7b51..71df169239101 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -285,7 +285,7 @@ def test_get_field(self):
     @mock.patch('airflow.contrib.operators.gcp_container_operator.GKEPodOperator.log')
     def test_get_field_fail(self, log_mock):
         log_mock.info = mock.Mock()
-        LOG_STR = 'Field {} not found in extras.'
+        LOG_STR = 'Field %s not found in extras.'
         FIELD_NAME = 'test_field'
         FIELD_VALUE = 'test_field_value'
 
@@ -294,4 +294,4 @@ def test_get_field_fail(self, log_mock):
         ret_val = self.gke_op._get_field(extras, FIELD_NAME, default=FIELD_VALUE)
         # Assert default is returned upon failure
         self.assertEqual(FIELD_VALUE, ret_val)
-        log_mock.info.assert_called_with(LOG_STR.format(FIELD_NAME))
+        log_mock.info.assert_called_with(LOG_STR, FIELD_NAME)
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index caa00c912cb33..43b59f8f2cd3e 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -24,7 +24,6 @@
 from celery.contrib.testing.worker import start_worker
 
 from airflow.executors import celery_executor
-from airflow.executors.celery_executor import CELERY_FETCH_ERR_MSG_HEADER
 from airflow.executors.celery_executor import (CeleryExecutor, celery_configuration,
                                                send_task_to_executor, execute_command)
 from airflow.executors.celery_executor import app
@@ -120,12 +119,11 @@ def fake_celery_task():
         executor.sync()
         mock_log.error.assert_called_once()
         args, kwargs = mock_log.error.call_args_list[0]
-        log = args[0]
         # Result of queuing is not a celery task but a dict,
         # and it should raise AttributeError and then get propagated
         # to the error log.
-        self.assertIn(CELERY_FETCH_ERR_MSG_HEADER, log)
-        self.assertIn('AttributeError', log)
+        self.assertIn(celery_executor.CELERY_FETCH_ERR_MSG_HEADER, args[0])
+        self.assertIn('AttributeError', args[1])
 
 
 if __name__ == '__main__':
diff --git a/tests/utils/log/test_es_task_handler.py b/tests/utils/log/test_es_task_handler.py
index 94184fc82685d..accdfe32d7418 100644
--- a/tests/utils/log/test_es_task_handler.py
+++ b/tests/utils/log/test_es_task_handler.py
@@ -171,10 +171,9 @@ def test_read_raises(self):
             with mock.patch("elasticsearch_dsl.Search.execute") as mock_execute:
                 mock_execute.side_effect = Exception('Failed to read')
                 logs, metadatas = self.es_task_handler.read(self.ti, 1)
-            msg = "Could not read log with log_id: {}".format(self.LOG_ID)
             mock_exception.assert_called_once()
             args, kwargs = mock_exception.call_args
-            self.assertIn(msg, args[0])
+            self.assertIn("Could not read log with log_id:", args[0])
 
         self.assertEqual(1, len(logs))
         self.assertEqual(len(logs), len(metadatas))

From 09c4d52832000397c6b5918cca9e7f4354591e8b Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Sun, 10 Mar 2019 04:35:09 +1100
Subject: [PATCH 675/808] [AIRFLOW-4009] Fix docstring issue in GCSToBQOperator
 (#4836)

---
 airflow/contrib/hooks/bigquery_hook.py             | 14 +++++++-------
 airflow/contrib/hooks/gcp_sql_hook.py              |  4 ++--
 airflow/contrib/operators/bigquery_operator.py     |  6 +++---
 .../operators/bigquery_table_delete_operator.py    |  2 +-
 airflow/contrib/operators/bigquery_to_gcs.py       |  2 +-
 airflow/contrib/operators/gcs_to_bq.py             |  9 +++++----
 6 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 8094e14f4ba98..6c6154a984e59 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -332,9 +332,9 @@ def create_external_table(self,
         for more details about these parameters.
 
         :param external_project_dataset_table:
-            The dotted (<project>.|<project>:)<dataset>.<table>($<partition>) BigQuery
+            The dotted ``(<project>.|<project>:)<dataset>.<table>($<partition>)`` BigQuery
             table name to create external table.
-            If <project> is not included, project will be the
+            If ``<project>`` is not included, project will be the
             project defined in the connection json.
         :type external_project_dataset_table: str
         :param schema_fields: The schema field list as defined here:
@@ -535,7 +535,7 @@ def run_query(self,
         :type bql: str
         :param sql: The BigQuery SQL to execute.
         :type sql: str
-        :param destination_dataset_table: The dotted <dataset>.<table>
+        :param destination_dataset_table: The dotted ``<dataset>.<table>``
             BigQuery table to save the query results.
         :type destination_dataset_table: str
         :param write_disposition: What to do if the table already exists in
@@ -757,7 +757,7 @@ def run_extract(  # noqa
 
         For more details about these parameters.
 
-        :param source_project_dataset_table: The dotted <dataset>.<table>
+        :param source_project_dataset_table: The dotted ``<dataset>.<table>``
             BigQuery table to use as the source data.
         :type source_project_dataset_table: str
         :param destination_cloud_storage_uris: The destination Google Cloud
@@ -826,7 +826,7 @@ def run_copy(self,
             (project:|project.)<dataset>.<table>
             BigQuery tables to use as the source data. Use a list if there are
             multiple source tables.
-            If <project> is not included, project will be the project defined
+            If ``<project>`` is not included, project will be the project defined
             in the connection json.
         :type source_project_dataset_tables: list|string
         :param destination_project_dataset_table: The destination BigQuery
@@ -909,8 +909,8 @@ def run_load(self,
         For more details about these parameters.
 
         :param destination_project_dataset_table:
-            The dotted (<project>.|<project>:)<dataset>.<table>($<partition>) BigQuery
-            table to load data into. If <project> is not included, project will be the
+            The dotted ``(<project>.|<project>:)<dataset>.<table>($<partition>)`` BigQuery
+            table to load data into. If ``<project>`` is not included, project will be the
             project defined in the connection json. If a partition is specified the
             operator will automatically append the data, create a new partition or create
             a new DAY partitioned table.
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index d1792397adb1c..002083cdcea8b 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -407,9 +407,9 @@ def __init__(self,
         :param instance_specification: Specification of the instance to connect the
             proxy to. It should be specified in the form that is described in
             https://cloud.google.com/sql/docs/mysql/sql-proxy#multiple-instances in
-            -instances parameter (typically in the form of <project>:<region>:<instance>
+            -instances parameter (typically in the form of ``<project>:<region>:<instance>``
             for UNIX socket connections and in the form of
-            <project>:<region>:<instance>=tcp:<port> for TCP connections.
+            ``<project>:<region>:<instance>=tcp:<port>`` for TCP connections.
         :type instance_specification: str
         :param gcp_conn_id: Id of Google Cloud Platform connection to use for
             authentication
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index b6e1e1a471036..cbcdfd3325194 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -39,7 +39,7 @@ class BigQueryOperator(BaseOperator):
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'.
     :param destination_dataset_table: A dotted
-        (<project>.|<project>:)<dataset>.<table> that, if set, will store the results
+        ``(<project>.|<project>:)<dataset>.<table>`` that, if set, will store the results
         of the query. (templated)
     :type destination_dataset_table: str
     :param write_disposition: Specifies the action that occurs if the destination table
@@ -382,8 +382,8 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
         table to. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
     :type source_objects: list
-    :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
-        BigQuery table to load data into (templated). If <project> is not included,
+    :param destination_project_dataset_table: The dotted ``(<project>.)<dataset>.<table>``
+        BigQuery table to load data into (templated). If ``<project>`` is not included,
         project will be the project defined in the connection json.
     :type destination_project_dataset_table: str
     :param schema_fields: If set, the schema field list as defined here:
diff --git a/airflow/contrib/operators/bigquery_table_delete_operator.py b/airflow/contrib/operators/bigquery_table_delete_operator.py
index 45c481454e475..106afd1e94f0e 100644
--- a/airflow/contrib/operators/bigquery_table_delete_operator.py
+++ b/airflow/contrib/operators/bigquery_table_delete_operator.py
@@ -27,7 +27,7 @@ class BigQueryTableDeleteOperator(BaseOperator):
     Deletes BigQuery tables
 
     :param deletion_dataset_table: A dotted
-        (<project>.|<project>:)<dataset>.<table> that indicates which table
+        ``(<project>.|<project>:)<dataset>.<table>`` that indicates which table
         will be deleted. (templated)
     :type deletion_dataset_table: str
     :param bigquery_conn_id: reference to a specific BigQuery hook.
diff --git a/airflow/contrib/operators/bigquery_to_gcs.py b/airflow/contrib/operators/bigquery_to_gcs.py
index ec6b937d218b2..19b004fdfe2fb 100644
--- a/airflow/contrib/operators/bigquery_to_gcs.py
+++ b/airflow/contrib/operators/bigquery_to_gcs.py
@@ -32,7 +32,7 @@ class BigQueryToCloudStorageOperator(BaseOperator):
 
     :param source_project_dataset_table: The dotted
         ``(<project>.|<project>:)<dataset>.<table>`` BigQuery table to use as the
-        source data. If <project> is not included, project will be the project
+        source data. If ``<project>`` is not included, project will be the project
         defined in the connection json. (templated)
     :type source_project_dataset_table: str
     :param destination_cloud_storage_uris: The destination Google Cloud
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index abbf380b2d0fb..24b2f02eec0ad 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -38,10 +38,11 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
     :type bucket: str
     :param source_objects: List of Google cloud storage URIs to load from. (templated)
         If source_format is 'DATASTORE_BACKUP', the list must only contain a single URI.
-    :type source_objects: list of str
-    :param destination_project_dataset_table: The dotted (<project>.)<dataset>.<table>
-        BigQuery table to load data into. If <project> is not included,
-        project will be the project defined in the connection json. (templated)
+    :type source_objects: list[str]
+    :param destination_project_dataset_table: The dotted
+        ``(<project>.|<project>:)<dataset>.<table>`` BigQuery table to load data into.
+        If ``<project>`` is not included, project will be the project defined in
+        the connection json. (templated)
     :type destination_project_dataset_table: str
     :param schema_fields: If set, the schema field list as defined here:
         https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load

From a40106292eba8c320fe6a8a0f5adac5de369db85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristian=20Yrj=C3=B6l=C3=A4?= <kristian.y@gmail.com>
Date: Wed, 13 Mar 2019 17:14:28 +0100
Subject: [PATCH 676/808] [AIRFLOW-3997] Extend Variable.get so it can return
 None when var not found (#4819)

This will not change existing regular functions in the `Variable` class. If
variable `foo` doesn't exist:

```
foo = Variable.get("foo")
-> KeyError
```

For passing `default_var=None` to get, `None` is returned instead:
```
foo = Variable.get("foo", default_var=None)
if foo is None:
    handle_missing_foo()
```
---
 UPDATING.md                | 13 +++++++++++++
 airflow/models/__init__.py | 10 +++++-----
 docs/concepts.rst          |  6 +++++-
 tests/core.py              |  7 +++++++
 4 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index ba1a6272f2bd7..8d7f04f8f0d3f 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -104,6 +104,19 @@ Hooks involved:
 
 Other GCP hooks are unaffected.
 
+### Changed behaviour of using default value when accessing variables
+It's now possible to use `None` as a default value with the `default_var` parameter when getting a variable, e.g.
+
+```python
+foo = Variable.get("foo", default_var=None)
+if foo is None:
+    handle_missing_foo()
+```
+
+(Note: there is already `Variable.setdefault()` which me be helpful in some cases.)
+
+This changes the behaviour if you previously explicitly provided `None` as a default value. If your code expects a `KeyError` to be thrown, then don't pass the `default_var` argument.
+
 ## Airflow 1.10.2
 
 ### DAG level Access Control for new RBAC UI
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index fabb368fc2d16..8a459181d53e2 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -4476,6 +4476,7 @@ def __repr__(self):
 
 class Variable(Base, LoggingMixin):
     __tablename__ = "variable"
+    __NO_DEFAULT_SENTINEL = object()
 
     id = Column(Integer, primary_key=True)
     key = Column(String(ID_LEN), unique=True)
@@ -4529,10 +4530,9 @@ def setdefault(cls, key, default, deserialize_json=False):
             and un-encode it when retrieving a value
         :return: Mixed
         """
-        default_sentinel = object()
-        obj = Variable.get(key, default_var=default_sentinel,
+        obj = Variable.get(key, default_var=None,
                            deserialize_json=deserialize_json)
-        if obj is default_sentinel:
+        if obj is None:
             if default is not None:
                 Variable.set(key, default, serialize_json=deserialize_json)
                 return default
@@ -4543,10 +4543,10 @@ def setdefault(cls, key, default, deserialize_json=False):
 
     @classmethod
     @provide_session
-    def get(cls, key, default_var=None, deserialize_json=False, session=None):
+    def get(cls, key, default_var=__NO_DEFAULT_SENTINEL, deserialize_json=False, session=None):
         obj = session.query(cls).filter(cls.key == key).first()
         if obj is None:
-            if default_var is not None:
+            if default_var is not cls.__NO_DEFAULT_SENTINEL:
                 return default_var
             else:
                 raise KeyError('Variable {} does not exist'.format(key))
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 9c8dbc7ba9e7a..0fa6124fe50a1 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -456,10 +456,14 @@ accessible and modifiable through the UI.
     from airflow.models import Variable
     foo = Variable.get("foo")
     bar = Variable.get("bar", deserialize_json=True)
+    baz = Variable.get("baz", default_var=None)
 
 The second call assumes ``json`` content and will be deserialized into
 ``bar``. Note that ``Variable`` is a sqlalchemy model and can be used
-as such.
+as such. The third call uses the ``default_var`` parameter with the value
+``None``, which either returns an existing value or ``None`` if the variable
+isn't defined. The get function will throw a ``KeyError`` if the variable
+doesn't exist and no default is provided.
 
 You can use a variable from a jinja template with the syntax :
 
diff --git a/tests/core.py b/tests/core.py
index 6428a6a7fa5e3..ae732041f5e59 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -719,6 +719,13 @@ def test_get_non_existing_var_should_return_default(self):
         self.assertEqual(default_value, Variable.get("thisIdDoesNotExist",
                                                      default_var=default_value))
 
+    def test_get_non_existing_var_should_raise_key_error(self):
+        with self.assertRaises(KeyError):
+            Variable.get("thisIdDoesNotExist")
+
+    def test_get_non_existing_var_with_none_default_should_return_none(self):
+        self.assertIsNone(Variable.get("thisIdDoesNotExist", default_var=None))
+
     def test_get_non_existing_var_should_not_deserialize_json_default(self):
         default_value = "}{ this is a non JSON default }{"
         self.assertEqual(default_value, Variable.get("thisIdDoesNotExist",

From b7382f33396cb64dc187438d0dfc8470c104b0a6 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Thu, 14 Mar 2019 17:30:47 -0400
Subject: [PATCH 677/808] [AIRFLOW-4002] Option to open debugger on errors in
 `airflow test`. (#4828)

---
 airflow/bin/cli.py | 26 +++++++++++++++++++++-----
 1 file changed, 21 insertions(+), 5 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index d63065ac24d10..459e35d967e2e 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -19,6 +19,7 @@
 # under the License.
 
 from __future__ import print_function
+import importlib
 import logging
 
 import os
@@ -647,10 +648,20 @@ def test(args, dag=None):
         task.params.update(passed_in_params)
     ti = TaskInstance(task, args.execution_date)
 
-    if args.dry_run:
-        ti.dry_run()
-    else:
-        ti.run(ignore_task_deps=True, ignore_ti_state=True, test_mode=True)
+    try:
+        if args.dry_run:
+            ti.dry_run()
+        else:
+            ti.run(ignore_task_deps=True, ignore_ti_state=True, test_mode=True)
+    except Exception:
+        if args.post_mortem:
+            try:
+                debugger = importlib.import_module("ipdb")
+            except ImportError:
+                debugger = importlib.import_module("pdb")
+            debugger.post_mortem()
+        else:
+            raise
 
 
 @cli_utils.action_logging
@@ -1833,6 +1844,11 @@ class CLIFactory(object):
         'task_params': Arg(
             ("-tp", "--task_params"),
             help="Sends a JSON params dict to the task"),
+        'post_mortem': Arg(
+            ("-pm", "--post_mortem"),
+            action="store_true",
+            help="Open debugger on uncaught exception",
+        ),
         # connections
         'list_connections': Arg(
             ('-l', '--list'),
@@ -2028,7 +2044,7 @@ class CLIFactory(object):
                 "dependencies or recording its state in the database."),
             'args': (
                 'dag_id', 'task_id', 'execution_date', 'subdir', 'dry_run',
-                'task_params'),
+                'task_params', 'post_mortem'),
         }, {
             'func': webserver,
             'help': "Start a Airflow webserver instance",

From 0e73672df6a2b4fb0c0736f62fa5bd287d6e2e16 Mon Sep 17 00:00:00 2001
From: Chao-Han Tsai <milton0825@gmail.com>
Date: Sun, 17 Mar 2019 22:16:14 -0700
Subject: [PATCH 678/808] [AIRFLOW-4107] instrument executor (#4928)

---
 airflow/executors/base_executor.py | 12 ++++++++++--
 docs/metrics.rst                   |  3 +++
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/airflow/executors/base_executor.py b/airflow/executors/base_executor.py
index a0b71e575a2c2..f88f34591ec4b 100644
--- a/airflow/executors/base_executor.py
+++ b/airflow/executors/base_executor.py
@@ -23,6 +23,7 @@
 # To avoid circular imports
 import airflow.utils.dag_processing
 from airflow import configuration
+from airflow.settings import Stats
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.state import State
 
@@ -117,10 +118,17 @@ def heartbeat(self):
         else:
             open_slots = self.parallelism - len(self.running)
 
-        self.log.debug("%s running task instances", len(self.running))
-        self.log.debug("%s in queue", len(self.queued_tasks))
+        num_running_tasks = len(self.running)
+        num_queued_tasks = len(self.queued_tasks)
+
+        self.log.debug("%s running task instances", num_running_tasks)
+        self.log.debug("%s in queue", num_queued_tasks)
         self.log.debug("%s open slots", open_slots)
 
+        Stats.gauge('executor.open_slots', open_slots)
+        Stats.gauge('executor.queued_tasks', num_queued_tasks)
+        Stats.gauge('executor.running_tasks', num_running_tasks)
+
         sorted_queue = sorted(
             [(k, v) for k, v in self.queued_tasks.items()],
             key=lambda x: x[1][1],
diff --git a/docs/metrics.rst b/docs/metrics.rst
index 4b818ac9e8305..ae1afd26073c3 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -57,6 +57,9 @@ dagbag_import_errors                            DAG import errors
 dagbag_size                                     DAG bag size
 dag_processing.last_runtime.<dag_file>          Seconds spent processing <dag_file> (in most recent iteration)
 dag_processing.last_run.seconds_ago.<dag_file>  Seconds since <dag_file> was last processed
+executor.open_slots                             Number of of open slots on executor
+executor.queued_tasks                           Number of queued tasks on executor
+executor.running_tasks                          Number of running tasks on executor
 =============================================== ========================================================================
 
 Timers

From 898aec9ce93226066bd499786eb876c832b08f73 Mon Sep 17 00:00:00 2001
From: Omeed Musavi <omusavi@users.noreply.github.com>
Date: Wed, 26 Dec 2018 12:06:28 -0800
Subject: [PATCH 679/808] [AIRFLOW-2568] Azure Container Instances operator
 (#4121)

Add an operator to create a Docker container in Azure Container
Instances. Azure Container Instances hosts a container and abstracts
away the infrastructure around orchestration of a container service.

Operator supports creating an ACI container and pull an image from Azure
Container Registry or public Docker registries.
---
 ...mple_azure_container_instances_operator.py |  54 ++++
 .../hooks/azure_container_instance_hook.py    | 167 ++++++++++++
 .../hooks/azure_container_registry_hook.py    |  39 +++
 .../hooks/azure_container_volume_hook.py      |  54 ++++
 .../azure_container_instances_operator.py     | 257 ++++++++++++++++++
 airflow/models/connection.py                  |   1 +
 airflow/utils/db.py                           |   4 +
 docs/integration.rst                          |  73 ++++-
 setup.py                                      |   4 +-
 .../test_azure_container_instance_hook.py     | 124 +++++++++
 .../test_azure_container_registry_hook.py     |  44 +++
 .../hooks/test_azure_container_volume_hook.py |  50 ++++
 ...test_azure_container_instances_operator.py | 115 ++++++++
 13 files changed, 973 insertions(+), 13 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_azure_container_instances_operator.py
 create mode 100644 airflow/contrib/hooks/azure_container_instance_hook.py
 create mode 100644 airflow/contrib/hooks/azure_container_registry_hook.py
 create mode 100644 airflow/contrib/hooks/azure_container_volume_hook.py
 create mode 100644 airflow/contrib/operators/azure_container_instances_operator.py
 create mode 100644 tests/contrib/hooks/test_azure_container_instance_hook.py
 create mode 100644 tests/contrib/hooks/test_azure_container_registry_hook.py
 create mode 100644 tests/contrib/hooks/test_azure_container_volume_hook.py
 create mode 100644 tests/contrib/operators/test_azure_container_instances_operator.py

diff --git a/airflow/contrib/example_dags/example_azure_container_instances_operator.py b/airflow/contrib/example_dags/example_azure_container_instances_operator.py
new file mode 100644
index 0000000000000..181a30b50e62f
--- /dev/null
+++ b/airflow/contrib/example_dags/example_azure_container_instances_operator.py
@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow import DAG
+from airflow.contrib.operators.azure_container_instances_operator import AzureContainerInstancesOperator
+from datetime import datetime, timedelta
+
+default_args = {
+    'owner': 'airflow',
+    'depends_on_past': False,
+    'start_date': datetime(2018, 11, 1),
+    'email': ['airflow@example.com'],
+    'email_on_failure': False,
+    'email_on_retry': False,
+    'retries': 1,
+    'retry_delay': timedelta(minutes=5),
+}
+
+dag = DAG(
+    'aci_example',
+    default_args=default_args,
+    schedule_interval=timedelta(1)
+)
+
+t1 = AzureContainerInstancesOperator(
+    ci_conn_id='azure_container_instances_default',
+    registry_conn_id=None,
+    resource_group='resource-group',
+    name='aci-test-{{ ds }}',
+    image='hello-world',
+    region='WestUS2',
+    environment_variables={},
+    volumes=[],
+    memory_in_gb=4.0,
+    cpu=1.0,
+    task_id='start_container',
+    dag=dag
+)
diff --git a/airflow/contrib/hooks/azure_container_instance_hook.py b/airflow/contrib/hooks/azure_container_instance_hook.py
new file mode 100644
index 0000000000000..5ad64de6d7592
--- /dev/null
+++ b/airflow/contrib/hooks/azure_container_instance_hook.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+import os
+
+from airflow.hooks.base_hook import BaseHook
+from airflow.exceptions import AirflowException
+
+from azure.common.client_factory import get_client_from_auth_file
+from azure.common.credentials import ServicePrincipalCredentials
+
+from azure.mgmt.containerinstance import ContainerInstanceManagementClient
+
+
+class AzureContainerInstanceHook(BaseHook):
+    """
+    A hook to communicate with Azure Container Instances.
+
+    This hook requires a service principal in order to work.
+    After creating this service principal
+    (Azure Active Directory/App Registrations), you need to fill in the
+    client_id (Application ID) as login, the generated password as password,
+    and tenantId and subscriptionId in the extra's field as a json.
+
+    :param conn_id: connection id of a service principal which will be used
+        to start the container instance
+    :type conn_id: str
+    """
+
+    def __init__(self, conn_id='azure_default'):
+        self.conn_id = conn_id
+        self.connection = self.get_conn()
+
+    def get_conn(self):
+        conn = self.get_connection(self.conn_id)
+        key_path = conn.extra_dejson.get('key_path', False)
+        if key_path:
+            if key_path.endswith('.json'):
+                self.log.info('Getting connection using a JSON key file.')
+                return get_client_from_auth_file(ContainerInstanceManagementClient,
+                                                 key_path)
+            else:
+                raise AirflowException('Unrecognised extension for key file.')
+
+        if os.environ.get('AZURE_AUTH_LOCATION'):
+            key_path = os.environ.get('AZURE_AUTH_LOCATION')
+            if key_path.endswith('.json'):
+                self.log.info('Getting connection using a JSON key file.')
+                return get_client_from_auth_file(ContainerInstanceManagementClient,
+                                                 key_path)
+            else:
+                raise AirflowException('Unrecognised extension for key file.')
+
+        credentials = ServicePrincipalCredentials(
+            client_id=conn.login,
+            secret=conn.password,
+            tenant=conn.extra_dejson['tenantId']
+        )
+
+        subscription_id = conn.extra_dejson['subscriptionId']
+        return ContainerInstanceManagementClient(credentials, str(subscription_id))
+
+    def create_or_update(self, resource_group, name, container_group):
+        """
+        Create a new container group
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        :param container_group: the properties of the container group
+        :type container_group: azure.mgmt.containerinstance.models.ContainerGroup
+        """
+        self.connection.container_groups.create_or_update(resource_group,
+                                                          name,
+                                                          container_group)
+
+    def get_state_exitcode_details(self, resource_group, name):
+        """
+        Get the state and exitcode of a container group
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        :return: A tuple with the state, exitcode, and details.
+        If the exitcode is unknown 0 is returned.
+        :rtype: tuple(state,exitcode,details)
+        """
+        current_state = self._get_instance_view(resource_group, name).current_state
+        return (current_state.state,
+                current_state.exit_code,
+                current_state.detail_status)
+
+    def _get_instance_view(self, resource_group, name):
+        response = self.connection.container_groups.get(resource_group,
+                                                        name,
+                                                        raw=False)
+        return response.containers[0].instance_view.current_state
+
+    def get_messages(self, resource_group, name):
+        """
+        Get the messages of a container group
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        :return: A list of the event messages
+        :rtype: list<str>
+        """
+        instance_view = self._get_instance_view(resource_group, name)
+
+        return [event.message for event in instance_view.events]
+
+    def get_logs(self, resource_group, name, tail=1000):
+        """
+        Get the tail from logs of a container group
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        :param tail: the size of the tail
+        :type tail: int
+        :return: A list of log messages
+        :rtype: list<str>
+        """
+        logs = self.connection.container.list_logs(resource_group, name, name, tail=tail)
+        return logs.content.splitlines(True)
+
+    def delete(self, resource_group, name):
+        """
+        Delete a container group
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        """
+        self.connection.container_groups.delete(resource_group, name)
+
+    def exists(self, resource_group, name):
+        """
+        Test if a container group exists
+
+        :param resource_group: the name of the resource group
+        :type resource_group: str
+        :param name: the name of the container group
+        :type name: str
+        """
+        for container in self.connection.container_groups.list_by_resource_group(resource_group):
+            if container.name == name:
+                return True
+        return False
diff --git a/airflow/contrib/hooks/azure_container_registry_hook.py b/airflow/contrib/hooks/azure_container_registry_hook.py
new file mode 100644
index 0000000000000..af38c1a94380e
--- /dev/null
+++ b/airflow/contrib/hooks/azure_container_registry_hook.py
@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.base_hook import BaseHook
+from azure.mgmt.containerinstance.models import ImageRegistryCredential
+
+
+class AzureContainerRegistryHook(BaseHook):
+    """
+    A hook to communicate with a Azure Container Registry.
+
+    :param conn_id: connection id of a service principal which will be used
+        to start the container instance
+    :type conn_id: str
+    """
+
+    def __init__(self, conn_id='azure_registry'):
+        self.conn_id = conn_id
+        self.connection = self.get_conn()
+
+    def get_conn(self):
+        conn = self.get_connection(self.conn_id)
+        return ImageRegistryCredential(server=conn.host, username=conn.login, password=conn.password)
diff --git a/airflow/contrib/hooks/azure_container_volume_hook.py b/airflow/contrib/hooks/azure_container_volume_hook.py
new file mode 100644
index 0000000000000..5bf349106433d
--- /dev/null
+++ b/airflow/contrib/hooks/azure_container_volume_hook.py
@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.hooks.base_hook import BaseHook
+from azure.mgmt.containerinstance.models import (Volume,
+                                                 AzureFileVolume)
+
+
+class AzureContainerVolumeHook(BaseHook):
+    """
+    A hook which wraps an Azure Volume.
+
+    :param wasb_conn_id: connection id of a Azure storage account of
+    which file shares should be mounted
+    :type wasb_conn_id: str
+    """
+
+    def __init__(self, wasb_conn_id='wasb_default'):
+        self.conn_id = wasb_conn_id
+
+    def get_storagekey(self):
+        conn = self.get_connection(self.conn_id)
+        service_options = conn.extra_dejson
+
+        if 'connection_string' in service_options:
+            for keyvalue in service_options['connection_string'].split(";"):
+                key, value = keyvalue.split("=", 1)
+                if key == "AccountKey":
+                    return value
+        return conn.password
+
+    def get_file_volume(self, mount_name, share_name,
+                        storage_account_name, read_only=False):
+        return Volume(name=mount_name,
+                      azure_file=AzureFileVolume(share_name=share_name,
+                                                 storage_account_name=storage_account_name,
+                                                 read_only=read_only,
+                                                 storage_account_key=self.get_storagekey()))
diff --git a/airflow/contrib/operators/azure_container_instances_operator.py b/airflow/contrib/operators/azure_container_instances_operator.py
new file mode 100644
index 0000000000000..f1b2a2a1a5bab
--- /dev/null
+++ b/airflow/contrib/operators/azure_container_instances_operator.py
@@ -0,0 +1,257 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from time import sleep
+
+from airflow.contrib.hooks.azure_container_instance_hook import AzureContainerInstanceHook
+from airflow.contrib.hooks.azure_container_registry_hook import AzureContainerRegistryHook
+from airflow.contrib.hooks.azure_container_volume_hook import AzureContainerVolumeHook
+
+from airflow.exceptions import AirflowException, AirflowTaskTimeout
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+from azure.mgmt.containerinstance.models import (EnvironmentVariable,
+                                                 VolumeMount,
+                                                 ResourceRequests,
+                                                 ResourceRequirements,
+                                                 Container,
+                                                 ContainerGroup)
+from msrestazure.azure_exceptions import CloudError
+
+
+DEFAULT_ENVIRONMENT_VARIABLES = {}
+DEFAULT_VOLUMES = []
+DEFAULT_MEMORY_IN_GB = 2.0
+DEFAULT_CPU = 1.0
+
+
+class AzureContainerInstancesOperator(BaseOperator):
+    """
+    Start a container on Azure Container Instances
+
+    :param ci_conn_id: connection id of a service principal which will be used
+        to start the container instance
+    :type ci_conn_id: str
+    :param registry_conn_id: connection id of a user which can login to a
+        private docker registry. If None, we assume a public registry
+    :type registry_conn_id: str
+    :param resource_group: name of the resource group wherein this container
+        instance should be started
+    :type resource_group: str
+    :param name: name of this container instance. Please note this name has
+        to be unique in order to run containers in parallel.
+    :type name: str
+    :param image: the docker image to be used
+    :type image: str
+    :param region: the region wherein this container instance should be started
+    :type region: str
+    :param: environment_variables: key,value pairs containing environment variables
+        which will be passed to the running container
+    :type: environment_variables: dict
+    :param: volumes: list of volumes to be mounted to the container.
+        Currently only Azure Fileshares are supported.
+    :type: volumes: list[<conn_id, account_name, share_name, mount_path, read_only>]
+    :param: memory_in_gb: the amount of memory to allocate to this container
+    :type: memory_in_gb: double
+    :param: cpu: the number of cpus to allocate to this container
+    :type: cpu: double
+    :param: command: the command to run inside the container
+    :type: command: str
+
+    :Example:
+
+    >>>  a = AzureContainerInstancesOperator(
+                'azure_service_principal',
+                'azure_registry_user',
+                'my-resource-group',
+                'my-container-name-{{ ds }}',
+                'myprivateregistry.azurecr.io/my_container:latest',
+                'westeurope',
+                {'EXECUTION_DATE': '{{ ds }}'},
+                [('azure_wasb_conn_id',
+                  'my_storage_container',
+                  'my_fileshare',
+                  '/input-data',
+                  True),],
+                memory_in_gb=14.0,
+                cpu=4.0,
+                command='python /app/myfile.py',
+                task_id='start_container'
+            )
+    """
+
+    template_fields = ('name', 'environment_variables')
+    template_ext = tuple()
+
+    @apply_defaults
+    def __init__(self, ci_conn_id, registry_conn_id, resource_group, name, image, region,
+                 environment_variables=None, volumes=None, memory_in_gb=None, cpu=None,
+                 command=None, remove_on_error=True, fail_if_exists=True, *args, **kwargs):
+        super(AzureContainerInstancesOperator, self).__init__(*args, **kwargs)
+
+        self.ci_conn_id = ci_conn_id
+        self.resource_group = resource_group
+        self.name = name
+        self.image = image
+        self.region = region
+        self.registry_conn_id = registry_conn_id
+        self.environment_variables = environment_variables or DEFAULT_ENVIRONMENT_VARIABLES
+        self.volumes = volumes or DEFAULT_VOLUMES
+        self.memory_in_gb = memory_in_gb or DEFAULT_MEMORY_IN_GB
+        self.cpu = cpu or DEFAULT_CPU
+        self.command = command
+        self.remove_on_error = remove_on_error
+        self.fail_if_exists = fail_if_exists
+
+    def execute(self, context):
+        ci_hook = AzureContainerInstanceHook(self.ci_conn_id)
+
+        if self.fail_if_exists:
+            self.log.info("Testing if container group already exists")
+            if ci_hook.exists(self.resource_group, self.name):
+                raise AirflowException("Container group exists")
+
+        if self.registry_conn_id:
+            registry_hook = AzureContainerRegistryHook(self.registry_conn_id)
+            image_registry_credentials = [registry_hook.connection, ]
+        else:
+            image_registry_credentials = None
+
+        environment_variables = []
+        for key, value in self.environment_variables.items():
+            environment_variables.append(EnvironmentVariable(key, value))
+
+        volumes = []
+        volume_mounts = []
+        for conn_id, account_name, share_name, mount_path, read_only in self.volumes:
+            hook = AzureContainerVolumeHook(conn_id)
+
+            mount_name = "mount-%d" % len(volumes)
+            volumes.append(hook.get_file_volume(mount_name,
+                                                share_name,
+                                                account_name,
+                                                read_only))
+            volume_mounts.append(VolumeMount(mount_name, mount_path, read_only))
+
+        exit_code = 1
+        try:
+            self.log.info("Starting container group with %.1f cpu %.1f mem",
+                          self.cpu, self.memory_in_gb)
+
+            resources = ResourceRequirements(requests=ResourceRequests(
+                memory_in_gb=self.memory_in_gb,
+                cpu=self.cpu))
+
+            container = Container(
+                name=self.name,
+                image=self.image,
+                resources=resources,
+                command=self.command,
+                environment_variables=environment_variables,
+                volume_mounts=volume_mounts)
+
+            container_group = ContainerGroup(
+                location=self.region,
+                containers=[container, ],
+                image_registry_credentials=image_registry_credentials,
+                volumes=volumes,
+                restart_policy='Never',
+                os_type='Linux')
+
+            ci_hook.create_or_update(self.resource_group, self.name, container_group)
+
+            self.log.info("Container group started %s/%s", self.resource_group, self.name)
+
+            exit_code = self._monitor_logging(ci_hook, self.resource_group, self.name)
+
+            self.log.info("Container had exit code: %s", exit_code)
+            if exit_code != 0:
+                raise AirflowException("Container had a non-zero exit code, %s"
+                                       % exit_code)
+
+        except CloudError:
+            self.log.exception("Could not start container group")
+            raise AirflowException("Could not start container group")
+
+        finally:
+            if exit_code == 0 or self.remove_on_error:
+                self.log.info("Deleting container group")
+                try:
+                    ci_hook.delete(self.resource_group, self.name)
+                except Exception:
+                    self.log.exception("Could not delete container group")
+
+    def _monitor_logging(self, ci_hook, resource_group, name):
+        last_state = None
+        last_message_logged = None
+        last_line_logged = None
+        for _ in range(43200):  # roughly 12 hours
+            try:
+                state, exit_code, detail_status = ci_hook.get_state_exitcode_details(resource_group, name)
+                if state != last_state:
+                    self.log.info("Container group state changed to %s", state)
+                    last_state = state
+
+                messages = ci_hook.get_messages(resource_group, name)
+                last_message_logged = self._log_last(messages, last_message_logged)
+
+                if state in ["Running", "Terminated"]:
+                    try:
+                        logs = ci_hook.get_logs(resource_group, name)
+                        last_line_logged = self._log_last(logs, last_line_logged)
+                    except CloudError:
+                        self.log.exception("Exception while getting logs from "
+                                           "container instance, retrying...")
+
+                if state == "Terminated":
+                    self.log.info("Container exited with detail_status %s", detail_status)
+                    return exit_code
+
+            except CloudError as err:
+                if 'ResourceNotFound' in str(err):
+                    self.log.warning("ResourceNotFound, container is probably removed "
+                                     "by another process "
+                                     "(make sure that the name is unique).")
+                    return 1
+                else:
+                    self.log.exception("Exception while getting container groups")
+            except Exception:
+                self.log.exception("Exception while getting container groups")
+
+            sleep(1)
+
+        # no return -> hence still running
+        raise AirflowTaskTimeout("Did not complete on time")
+
+    def _log_last(self, logs, last_line_logged):
+        if logs:
+            # determine the last line which was logged before
+            last_line_index = 0
+            for i in range(len(logs) - 1, -1, -1):
+                if logs[i] == last_line_logged:
+                    # this line is the same, hence print from i+1
+                    last_line_index = i + 1
+                    break
+
+            # log all new ones
+            for line in logs[last_line_index:]:
+                self.log.info(line.rstrip())
+
+            return logs[-1]
diff --git a/airflow/models/connection.py b/airflow/models/connection.py
index 75384dc34c47b..5d8905a183530 100644
--- a/airflow/models/connection.py
+++ b/airflow/models/connection.py
@@ -84,6 +84,7 @@ class Connection(Base, LoggingMixin):
         ('snowflake', 'Snowflake',),
         ('segment', 'Segment',),
         ('azure_data_lake', 'Azure Data Lake'),
+        ('azure_container_instances', 'Azure Container Instances'),
         ('azure_cosmos', 'Azure CosmosDB'),
         ('cassandra', 'Cassandra',),
         ('qubole', 'Qubole'),
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 075503115992a..144cfab8232dd 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -280,6 +280,10 @@ def initdb(rbac=False):
         Connection(
             conn_id='azure_cosmos_default', conn_type='azure_cosmos',
             extra='{"database_name": "<DATABASE_NAME>", "collection_name": "<COLLECTION_NAME>" }'))
+    merge_conn(
+        Connection(
+            conn_id='azure_container_instances_default', conn_type='azure_container_instances',
+            extra='{"tenantId": "<TENANT>", "subscriptionId": "<SUBSCRIPTION ID>" }'))
     merge_conn(
         Connection(
             conn_id='cassandra_default', conn_type='cassandra',
diff --git a/docs/integration.rst b/docs/integration.rst
index 80d744da1b3f9..0a55fa506f684 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -175,21 +175,21 @@ Logging
 Airflow can be configured to read and write task logs in Azure Blob Storage.
 See :ref:`write-logs-azure`.
 
-Azure CosmosDB 
+Azure CosmosDB
 ''''''''''''''
- 
-AzureCosmosDBHook communicates via the Azure Cosmos library. Make sure that a 
-Airflow connection of type `azure_cosmos` exists. Authorization can be done by supplying a 
-login (=Endpoint uri), password (=secret key) and extra fields database_name and collection_name to specify the  
-default database and collection to use (see connection `azure_cosmos_default` for an example). 
- 
-- :ref:`AzureCosmosDBHook`: Interface with Azure CosmosDB. 
-- :ref:`AzureCosmosInsertDocumentOperator`: Simple operator to insert document into CosmosDB. 
-- :ref:`AzureCosmosDocumentSensor`: Simple sensor to detect document existence in CosmosDB. 
+
+AzureCosmosDBHook communicates via the Azure Cosmos library. Make sure that a
+Airflow connection of type `azure_cosmos` exists. Authorization can be done by supplying a
+login (=Endpoint uri), password (=secret key) and extra fields database_name and collection_name to specify the
+default database and collection to use (see connection `azure_cosmos_default` for an example).
+
+- :ref:`AzureCosmosDBHook`: Interface with Azure CosmosDB.
+- :ref:`AzureCosmosInsertDocumentOperator`: Simple operator to insert document into CosmosDB.
+- :ref:`AzureCosmosDocumentSensor`: Simple sensor to detect document existence in CosmosDB.
 
 .. _AzureCosmosDBHook:
 
-AzureCosmosDBHook 
+AzureCosmosDBHook
 """""""""""""""""
 
 .. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
@@ -197,7 +197,7 @@ AzureCosmosDBHook
 
 AzureCosmosInsertDocumentOperator
 """""""""""""""""""""""""""""""""
- 
+
 .. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
     :noindex:
 
@@ -243,6 +243,55 @@ AdlsToGoogleCloudStorageOperator
 .. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
     :noindex:
 
+Azure Container Instances
+'''''''''''''''''''''''''
+
+Azure Container Instances provides a method to run a docker container without having to worry
+about managing infrastructure. The AzureContainerInstanceHook requires a service principal. The
+credentials for this principal can either be defined in the extra field `key_path`, as an
+environment variable named `AZURE_AUTH_LOCATION`,
+or by providing a login/password and tenantId in extras.
+
+The AzureContainerRegistryHook requires a host/login/password to be defined in the connection.
+
+- :ref:`AzureContainerInstancesOperator` : Start/Monitor a new ACI.
+- :ref:`AzureContainerInstanceHook` : Wrapper around a single ACI.
+- :ref:`AzureContainerRegistryHook` : Wrapper around a ACR
+- :ref:`AzureContainerVolumeHook` : Wrapper around Container Volumes
+
+.. _AzureContainerInstancesOperator:
+
+AzureContainerInstancesOperator
+"""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.azure_container_instances_operator.AzureContainerInstancesOperator
+    :noindex:
+
+.. _AzureContainerInstanceHook:
+
+AzureContainerInstanceHook
+""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook
+    :noindex:
+
+.. _AzureContainerRegistryHook:
+
+AzureContainerRegistryHook
+""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.azure_container_registry_hook.AzureContainerRegistryHook
+    :noindex:
+
+.. _AzureContainerVolumeHook:
+
+AzureContainerVolumeHook
+""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.azure_container_volume_hook.AzureContainerVolumeHook
+    :noindex:
+
+
 .. _AWS:
 
 AWS: Amazon Web Services
diff --git a/setup.py b/setup.py
index bf423edb5b06a..5c68fe844cee9 100644
--- a/setup.py
+++ b/setup.py
@@ -138,6 +138,7 @@ def write_version(filename=os.path.join(*['airflow',
     'azure-datalake-store==0.0.19'
 ]
 azure_cosmos = ['azure-cosmos>=3.0.1']
+azure_container_instances = ['azure-mgmt-containerinstance']
 cassandra = ['cassandra-driver>=3.13.0']
 celery = [
     'celery>=4.1.1, <4.2.0',
@@ -259,7 +260,7 @@ def write_version(filename=os.path.join(*['airflow',
              docker + ssh + kubernetes + celery + azure_blob_storage + redis + gcp_api +
              datadog + zendesk + jdbc + ldap + kerberos + password + webhdfs + jenkins +
              druid + pinot + segment + snowflake + elasticsearch + azure_data_lake + azure_cosmos +
-             atlas)
+             atlas + azure_container_instances)
 
 # Snakebite & Google Cloud Dataflow are not Python 3 compatible :'(
 if PY3:
@@ -335,6 +336,7 @@ def do_setup():
             'azure_blob_storage': azure_blob_storage,
             'azure_data_lake': azure_data_lake,
             'azure_cosmos': azure_cosmos,
+            'azure_container_instances': azure_container_instances,
             'cassandra': cassandra,
             'celery': celery,
             'cgroups': cgroups,
diff --git a/tests/contrib/hooks/test_azure_container_instance_hook.py b/tests/contrib/hooks/test_azure_container_instance_hook.py
new file mode 100644
index 0000000000000..afaf2ff40dc4a
--- /dev/null
+++ b/tests/contrib/hooks/test_azure_container_instance_hook.py
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+import unittest
+from collections import namedtuple
+from mock import patch
+
+from airflow import configuration
+from airflow.models.connection import Connection
+from airflow.contrib.hooks.azure_container_instance_hook import AzureContainerInstanceHook
+from airflow.utils import db
+
+from azure.mgmt.containerinstance.models import (Container,
+                                                 ContainerGroup,
+                                                 ContainerState,
+                                                 Event,
+                                                 Logs,
+                                                 ResourceRequests,
+                                                 ResourceRequirements)
+
+
+class TestAzureContainerInstanceHook(unittest.TestCase):
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id='azure_container_instance_test',
+                conn_type='azure_container_instances',
+                login='login',
+                password='key',
+                extra=json.dumps({'tenantId': 'tenant_id',
+                                  'subscriptionId': 'subscription_id'})
+            )
+        )
+
+        self.resources = ResourceRequirements(requests=ResourceRequests(
+            memory_in_gb='4',
+            cpu='1'))
+        with patch('azure.common.credentials.ServicePrincipalCredentials.__init__',
+                   autospec=True, return_value=None):
+            with patch('azure.mgmt.containerinstance.ContainerInstanceManagementClient'):
+                self.testHook = AzureContainerInstanceHook(conn_id='azure_container_instance_test')
+
+    @patch('azure.mgmt.containerinstance.models.ContainerGroup')
+    @patch('azure.mgmt.containerinstance.operations.ContainerGroupsOperations.create_or_update')
+    def test_create_or_update(self, create_or_update_mock, container_group_mock):
+        self.testHook.create_or_update('resource_group', 'aci-test', container_group_mock)
+        create_or_update_mock.assert_called_with('resource_group', 'aci-test', container_group_mock)
+
+    @patch('airflow.contrib.hooks.azure_container_instance_hook'
+           '.AzureContainerInstanceHook._get_instance_view')
+    def test_get_state_exitcode_details(self, get_instance_view_mock):
+        expected_state = ContainerState(state='testing', exit_code=1, detail_status='details')
+        instance_view = {"current_state": expected_state}
+        named_instance = namedtuple("InstanceView", instance_view.keys())(*instance_view.values())
+        get_instance_view_mock.return_value = named_instance
+
+        state, exit_code, details = self.testHook.get_state_exitcode_details('resource-group', 'test')
+
+        self.assertEqual(state, expected_state.state)
+        self.assertEqual(exit_code, expected_state.exit_code)
+        self.assertEqual(details, expected_state.detail_status)
+
+    @patch('airflow.contrib.hooks.azure_container_instance_hook'
+           '.AzureContainerInstanceHook._get_instance_view')
+    def test_get_messages(self, get_instance_view_mock):
+        expected_messages = ['test1', 'test2']
+        events = [Event(message=m) for m in expected_messages]
+        instance_view = {"events": events}
+        named_instance = namedtuple("Events", instance_view.keys())(*instance_view.values())
+        get_instance_view_mock.return_value = named_instance
+
+        messages = self.testHook.get_messages('resource-group', 'test')
+
+        self.assertSequenceEqual(messages, expected_messages)
+
+    @patch('azure.mgmt.containerinstance.operations.ContainerOperations.list_logs')
+    def test_get_logs(self, list_logs_mock):
+        expected_messages = ['log line 1\n', 'log line 2\n', 'log line 3\n']
+        logs = Logs(content=''.join(expected_messages))
+        list_logs_mock.return_value = logs
+
+        logs = self.testHook.get_logs('resource_group', 'name', 'name')
+
+        self.assertSequenceEqual(logs, expected_messages)
+
+    @patch('azure.mgmt.containerinstance.operations.ContainerGroupsOperations.delete')
+    def test_delete(self, delete_mock):
+        self.testHook.delete('resource_group', 'aci-test')
+        delete_mock.assert_called_with('resource_group', 'aci-test')
+
+    @patch('azure.mgmt.containerinstance.operations.ContainerGroupsOperations.list_by_resource_group')
+    def test_exists_with_existing(self, list_mock):
+        list_mock.return_value = [ContainerGroup(os_type='Linux',
+                                                 containers=[Container(name='test1',
+                                                                       image='hello-world',
+                                                                       resources=self.resources)])]
+        self.assertFalse(self.testHook.exists('test', 'test1'))
+
+    @patch('azure.mgmt.containerinstance.operations.ContainerGroupsOperations.list_by_resource_group')
+    def test_exists_with_not_existing(self, list_mock):
+        list_mock.return_value = [ContainerGroup(os_type='Linux',
+                                                 containers=[Container(name='test1',
+                                                                       image='hello-world',
+                                                                       resources=self.resources)])]
+        self.assertFalse(self.testHook.exists('test', 'not found'))
diff --git a/tests/contrib/hooks/test_azure_container_registry_hook.py b/tests/contrib/hooks/test_azure_container_registry_hook.py
new file mode 100644
index 0000000000000..02c72cce832fc
--- /dev/null
+++ b/tests/contrib/hooks/test_azure_container_registry_hook.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow.models.connection import Connection
+from airflow.contrib.hooks.azure_container_registry_hook import AzureContainerRegistryHook
+from airflow.utils import db
+
+
+class TestAzureContainerRegistryHook(unittest.TestCase):
+
+    def test_get_conn(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id='azure_container_registry',
+                login='myuser',
+                password='password',
+                host='test.cr',
+            )
+        )
+        hook = AzureContainerRegistryHook(conn_id='azure_container_registry')
+        self.assertIsNotNone(hook.connection)
+        self.assertEqual(hook.connection.username, 'myuser')
+        self.assertEqual(hook.connection.password, 'password')
+        self.assertEqual(hook.connection.server, 'test.cr')
diff --git a/tests/contrib/hooks/test_azure_container_volume_hook.py b/tests/contrib/hooks/test_azure_container_volume_hook.py
new file mode 100644
index 0000000000000..25b3c53ab196d
--- /dev/null
+++ b/tests/contrib/hooks/test_azure_container_volume_hook.py
@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow import configuration
+from airflow.models.connection import Connection
+from airflow.contrib.hooks.azure_container_volume_hook import AzureContainerVolumeHook
+from airflow.utils import db
+
+
+class TestAzureContainerVolumeHook(unittest.TestCase):
+
+    def test_get_file_volume(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id='wasb_test_key',
+                conn_type='wasb',
+                login='login',
+                password='key'
+            )
+        )
+        hook = AzureContainerVolumeHook(wasb_conn_id='wasb_test_key')
+        volume = hook.get_file_volume(mount_name='mount',
+                                      share_name='share',
+                                      storage_account_name='storage',
+                                      read_only=True)
+        self.assertIsNotNone(volume)
+        self.assertEqual(volume.name, 'mount')
+        self.assertEqual(volume.azure_file.share_name, 'share')
+        self.assertEqual(volume.azure_file.storage_account_key, 'key')
+        self.assertEqual(volume.azure_file.storage_account_name, 'storage')
+        self.assertEqual(volume.azure_file.read_only, True)
diff --git a/tests/contrib/operators/test_azure_container_instances_operator.py b/tests/contrib/operators/test_azure_container_instances_operator.py
new file mode 100644
index 0000000000000..53014de414ffb
--- /dev/null
+++ b/tests/contrib/operators/test_azure_container_instances_operator.py
@@ -0,0 +1,115 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+from airflow.exceptions import AirflowException
+from airflow.contrib.operators.azure_container_instances_operator import AzureContainerInstancesOperator
+
+import unittest
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestACIOperator(unittest.TestCase):
+
+    @mock.patch("airflow.contrib.operators."
+                "azure_container_instances_operator.AzureContainerInstanceHook")
+    def test_execute(self, aci_mock):
+        aci_mock.return_value.get_state_exitcode_details.return_value = "Terminated", 0, "test"
+        aci_mock.return_value.exists.return_value = False
+
+        aci = AzureContainerInstancesOperator(ci_conn_id=None,
+                                              registry_conn_id=None,
+                                              resource_group='resource-group',
+                                              name='container-name',
+                                              image='container-image',
+                                              region='region',
+                                              task_id='task')
+        aci.execute(None)
+
+        self.assertEqual(aci_mock.return_value.create_or_update.call_count, 1)
+        (called_rg, called_cn, called_cg), _ = \
+            aci_mock.return_value.create_or_update.call_args
+
+        self.assertEqual(called_rg, 'resource-group')
+        self.assertEqual(called_cn, 'container-name')
+
+        self.assertEqual(called_cg.location, 'region')
+        self.assertEqual(called_cg.image_registry_credentials, None)
+        self.assertEqual(called_cg.restart_policy, 'Never')
+        self.assertEqual(called_cg.os_type, 'Linux')
+
+        called_cg_container = called_cg.containers[0]
+        self.assertEqual(called_cg_container.name, 'container-name')
+        self.assertEqual(called_cg_container.image, 'container-image')
+
+        self.assertEqual(aci_mock.return_value.delete.call_count, 1)
+
+    @mock.patch("airflow.contrib.operators."
+                "azure_container_instances_operator.AzureContainerInstanceHook")
+    def test_execute_with_failures(self, aci_mock):
+        aci_mock.return_value.get_state_exitcode_details.return_value = "Terminated", 1, "test"
+        aci_mock.return_value.exists.return_value = False
+
+        aci = AzureContainerInstancesOperator(ci_conn_id=None,
+                                              registry_conn_id=None,
+                                              resource_group='resource-group',
+                                              name='container-name',
+                                              image='container-image',
+                                              region='region',
+                                              task_id='task')
+        with self.assertRaises(AirflowException):
+            aci.execute(None)
+
+        self.assertEqual(aci_mock.return_value.delete.call_count, 1)
+
+    @mock.patch("airflow.contrib.operators."
+                "azure_container_instances_operator.AzureContainerInstanceHook")
+    def test_execute_with_messages_logs(self, aci_mock):
+        aci_mock.return_value.get_state_exitcode_details.side_effect = [("Running", 0, "test"),
+                                                                        ("Terminated", 0, "test")]
+        aci_mock.return_value.get_messages.return_value = ["test", "messages"]
+        aci_mock.return_value.get_logs.return_value = ["test", "logs"]
+        aci_mock.return_value.exists.return_value = False
+
+        aci = AzureContainerInstancesOperator(ci_conn_id=None,
+                                              registry_conn_id=None,
+                                              resource_group='resource-group',
+                                              name='container-name',
+                                              image='container-image',
+                                              region='region',
+                                              task_id='task')
+        aci.execute(None)
+
+        self.assertEqual(aci_mock.return_value.create_or_update.call_count, 1)
+        self.assertEqual(aci_mock.return_value.get_state_exitcode_details.call_count, 2)
+        self.assertEqual(aci_mock.return_value.get_messages.call_count, 2)
+        self.assertEqual(aci_mock.return_value.get_logs.call_count, 2)
+
+        self.assertEqual(aci_mock.return_value.delete.call_count, 1)
+
+
+if __name__ == '__main__':
+    unittest.main()

From c1a23e62f4c92b64208de4029497af5df48bff69 Mon Sep 17 00:00:00 2001
From: Jan Hicken <janhicken@users.noreply.github.com>
Date: Sun, 25 Nov 2018 15:10:32 +0100
Subject: [PATCH 680/808] [AIRFLOW-4122] Deprecate chain function (#4940)

* [AIRFLOW-4122] Remove chain function

Bit operation like `>>` or `<<` are suggested
to set dependency, which visual and easier to
explain. and have multiple ways is confusion

* change UPDATING.md as recommend
[ci skip]

This commit differs from 0868070 in that we keep the method but have issued a deprecation waring
---
 UPDATING.md                                            |  5 +++++
 airflow/example_dags/example_short_circuit_operator.py | 10 +++++-----
 airflow/utils/helpers.py                               |  2 ++
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 8d7f04f8f0d3f..590f7bce558d1 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -117,6 +117,11 @@ if foo is None:
 
 This changes the behaviour if you previously explicitly provided `None` as a default value. If your code expects a `KeyError` to be thrown, then don't pass the `default_var` argument.
 
+### Deprecation chain function
+
+Bit operation like `>>` or `<<` are recommended for setting the dependency, which is easier to explain.
+The `airflow.utlis.helpers.chain` function is deprecated and will be removed in Airflow 2.0.
+
 ## Airflow 1.10.2
 
 ### DAG level Access Control for new RBAC UI
diff --git a/airflow/example_dags/example_short_circuit_operator.py b/airflow/example_dags/example_short_circuit_operator.py
index 1093dab616779..161af19f2b333 100644
--- a/airflow/example_dags/example_short_circuit_operator.py
+++ b/airflow/example_dags/example_short_circuit_operator.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import airflow.utils.helpers
+import airflow.utils.dates
 from airflow.models import DAG
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import ShortCircuitOperator
@@ -41,8 +41,8 @@
     dag=dag,
 )
 
-ds_true = [DummyOperator(task_id='true_' + str(i), dag=dag) for i in [1, 2]]
-ds_false = [DummyOperator(task_id='false_' + str(i), dag=dag) for i in [1, 2]]
+true_1, true_2 = [DummyOperator(task_id='true_' + str(i), dag=dag) for i in [1, 2]]
+false_1, false_2 = [DummyOperator(task_id='false_' + str(i), dag=dag) for i in [1, 2]]
 
-airflow.utils.helpers.chain(cond_true, *ds_true)
-airflow.utils.helpers.chain(cond_false, *ds_false)
+cond_true >> true_1 >> true_2
+cond_false >> false_1 >> false_2
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 06229079338b9..8e854009774f3 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -38,6 +38,7 @@
 import signal
 
 from jinja2 import Template
+from zope.deprecation import deprecate
 
 from airflow import configuration
 from airflow.exceptions import AirflowException
@@ -156,6 +157,7 @@ def as_flattened_list(iterable):
     return [e for i in iterable for e in i]
 
 
+@deprecate("chain will be removed in Airflow 2.0")
 def chain(*tasks):
     """
     Given a number of tasks, builds a dependency chain.

From b551776f0ca3da0e9829aae73547595d5496c5f3 Mon Sep 17 00:00:00 2001
From: Chao-Han Tsai <milton0825@gmail.com>
Date: Tue, 19 Mar 2019 20:05:36 -0700
Subject: [PATCH 681/808] [AIRFLOW-4106] instrument staving tasks in pool
 (#4927)

---
 airflow/jobs.py  | 10 +++++++++-
 docs/metrics.rst |  1 +
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index ffcf84a068890..35ebc1b2da40c 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1121,11 +1121,13 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
         # Go through each pool, and queue up a task for execution if there are
         # any open slots in the pool.
         for pool, task_instances in pool_to_task_instances.items():
+            pool_name = pool
             if not pool:
                 # Arbitrary:
                 # If queued outside of a pool, trigger no more than
                 # non_pooled_task_slot_count per run
                 open_slots = conf.getint('core', 'non_pooled_task_slot_count')
+                pool_name = 'not_pooled'
             else:
                 if pool not in pools:
                     self.log.warning(
@@ -1149,13 +1151,16 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
             # DAG IDs with running tasks that equal the concurrency limit of the dag
             dag_id_to_possibly_running_task_count = {}
 
-            for task_instance in priority_sorted_task_instances:
+            # Number of tasks that cannot be scheduled because of no open slot in pool
+            num_starving_tasks = 0
+            for current_index, task_instance in enumerate(priority_sorted_task_instances):
                 if open_slots <= 0:
                     self.log.info(
                         "Not scheduling since there are %s open slots in pool %s",
                         open_slots, pool
                     )
                     # Can't schedule any more since there are no more open slots.
+                    num_starving_tasks = len(priority_sorted_task_instances) - current_index
                     break
 
                 # Check to make sure that the task concurrency of the DAG hasn't been
@@ -1210,6 +1215,9 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                 open_slots -= 1
                 dag_id_to_possibly_running_task_count[dag_id] += 1
 
+            Stats.gauge('pool.starving_tasks.{pool_name}'.format(pool_name=pool_name),
+                        num_starving_tasks)
+
         task_instance_str = "\n\t".join(
             ["{}".format(x) for x in executable_tis])
         self.log.info(
diff --git a/docs/metrics.rst b/docs/metrics.rst
index ae1afd26073c3..52f4a35103f97 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -60,6 +60,7 @@ dag_processing.last_run.seconds_ago.<dag_file>  Seconds since <dag_file> was las
 executor.open_slots                             Number of of open slots on executor
 executor.queued_tasks                           Number of queued tasks on executor
 executor.running_tasks                          Number of running tasks on executor
+pool.starving_tasks.<pool_name>                 Number of starving tasks in the pool
 =============================================== ========================================================================
 
 Timers

From 34501b81bdfbb3ad3be4ae6fcec3e29613f09677 Mon Sep 17 00:00:00 2001
From: andy-g14 <andy-g14@users.noreply.github.com>
Date: Wed, 20 Mar 2019 11:18:06 +0530
Subject: [PATCH 682/808] [AIRFLOW-4123] Add Exception handling for
 _change_state method in K8 Executor (#4941)

---
 airflow/contrib/executors/kubernetes_executor.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index afbb592021d0b..10bdc935b0430 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -647,7 +647,12 @@ def sync(self):
             key, state, pod_id, resource_version = results
             last_resource_version = resource_version
             self.log.info('Changing state of %s to %s', results, state)
-            self._change_state(key, state, pod_id)
+            try:
+                self._change_state(key, state, pod_id)
+            except Exception as e:
+                self.log.exception('Exception: %s when attempting ' +
+                                   'to change state of %s to %s, re-queueing.', e, results, state)
+                self.result_queue.put(results)
 
         KubeResourceVersion.checkpoint_resource_version(last_resource_version)
 

From e7f96860f4d8ca72ccc1a47d223f310b938d7a31 Mon Sep 17 00:00:00 2001
From: diederikwp <46847987+diederikwp@users.noreply.github.com>
Date: Mon, 25 Feb 2019 09:14:05 +0100
Subject: [PATCH 683/808] [AIRFLOW-3945] Stop inserting row when permission
 views unchanged (#4764)

- Stop inserting a row where only the id is not NULL in table
  ab_permission_view_role when there are no permission views to update.

- Add a test for above issue
---
 airflow/www_rbac/security.py    |  3 ++-
 tests/www_rbac/test_security.py | 10 ++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index b75379e22e6ab..e06e2106394b4 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -411,7 +411,8 @@ def merge_pv(perm, view_menu):
                 update_perm_views.append({'permission_view_id': perm_view_id,
                                           'role_id': role.id})
 
-        self.get_session.execute(ab_perm_view_role.insert(), update_perm_views)
+        if update_perm_views:
+            self.get_session.execute(ab_perm_view_role.insert(), update_perm_views)
         self.get_session.commit()
 
     def update_admin_perm_view(self):
diff --git a/tests/www_rbac/test_security.py b/tests/www_rbac/test_security.py
index 91e4fa9cf6bd9..d140f5eb787dd 100644
--- a/tests/www_rbac/test_security.py
+++ b/tests/www_rbac/test_security.py
@@ -26,6 +26,7 @@
 from flask import Flask
 from flask_appbuilder import AppBuilder, SQLA, Model, has_access, expose
 from flask_appbuilder.models.sqla.interface import SQLAInterface
+from flask_appbuilder.security.sqla import models as sqla_models
 from flask_appbuilder.views import ModelView, BaseView
 
 from sqlalchemy import Column, Integer, String, Date, Float
@@ -192,3 +193,12 @@ def test_has_all_dag_access(self, mock_has_role, mock_has_perm):
 
         mock_has_perm.return_value = True
         self.assertTrue(self.security_manager.has_all_dags_access())
+
+    def test_no_additional_dag_permission_views_created(self):
+        ab_perm_view_role = sqla_models.assoc_permissionview_role
+
+        self.security_manager.sync_roles()
+        num_pv_before = self.db.session().query(ab_perm_view_role).count()
+        self.security_manager.sync_roles()
+        num_pv_after = self.db.session().query(ab_perm_view_role).count()
+        self.assertEqual(num_pv_before, num_pv_after)

From 5ce9f079708b509cd6f18ed7fc0479591ce0e0d0 Mon Sep 17 00:00:00 2001
From: Paul Bramhall <paulwamp@gmail.com>
Date: Fri, 22 Mar 2019 15:24:55 +0000
Subject: [PATCH 684/808] [AIRFLOW-3737] Kubernetes executor cannot handle long
 dag/task names (#4636)

Kubernetes has a 63char limit on label values, so when running either a
subdag or a dag with a name with a length longer than 63 chars, the pod
creation process will fail with the following error:

    [2019-01-21 08:07:05,337] {rest.py:219} DEBUG - response body:
    {"kind":"Status","apiVersion":"v1","metadata":{},"status":"Failure","message":"unable
    to parse requirement: invalid label value:
    \"very_long_dag_name.very_long_task_name\": must be no more than 63
    characters","reason":"BadRequest","code":400}

Annotations however, allow for a relatively unrestricted length when
storing them against pods, and as such would be better suited in this
situation.

Generate deterministic random data for dag_id and task_id
To ensure testing consistency, when calling the '_gen_random_string()'
function, we want to set the seed dependant on the string length and
iteration within the `cases.extend` loop.
This allows random values to be created (as required) but ensuring
consistency of these values during each and every time we run tests
against the code.
---
 .../contrib/executors/kubernetes_executor.py  | 80 ++++++++++++++++---
 .../executors/test_kubernetes_executor.py     | 40 ++++++++--
 2 files changed, 103 insertions(+), 17 deletions(-)

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 10bdc935b0430..cdf7e54d5d70f 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -16,6 +16,8 @@
 # under the License.
 
 import base64
+import hashlib
+import re
 import json
 import multiprocessing
 from queue import Queue
@@ -387,7 +389,9 @@ def run_next(self, next_job):
         pod = self.worker_configuration.make_pod(
             namespace=self.namespace, worker_uuid=self.worker_uuid,
             pod_id=self._create_pod_id(dag_id, task_id),
-            dag_id=dag_id, task_id=task_id, try_number=try_number,
+            dag_id=self._make_safe_label_value(dag_id),
+            task_id=self._make_safe_label_value(task_id),
+            try_number=try_number,
             execution_date=self._datetime_to_label_safe_datestring(execution_date),
             airflow_command=command, kube_executor_config=kube_executor_config
         )
@@ -464,6 +468,27 @@ def _make_safe_pod_id(safe_dag_id, safe_task_id, safe_uuid):
 
         return safe_pod_id
 
+    @staticmethod
+    def _make_safe_label_value(string):
+        """
+        Valid label values must be 63 characters or less and must be empty or begin and
+        end with an alphanumeric character ([a-z0-9A-Z]) with dashes (-), underscores (_),
+        dots (.), and alphanumerics between.
+
+        If the label value is then greater than 63 chars once made safe, or differs in any
+        way from the original value sent to this function, then we need to truncate to
+        53chars, and append it with a unique hash.
+        """
+        MAX_LABEL_LEN = 63
+
+        safe_label = re.sub(r'^[^a-z0-9A-Z]*|[^a-zA-Z0-9_\-\.]|[^a-z0-9A-Z]*$', '', string)
+
+        if len(safe_label) > MAX_LABEL_LEN or string != safe_label:
+            safe_hash = hashlib.md5(string.encode()).hexdigest()[:9]
+            safe_label = safe_label[:MAX_LABEL_LEN - len(safe_hash) - 1] + "-" + safe_hash
+
+        return safe_label
+
     @staticmethod
     def _create_pod_id(dag_id, task_id):
         safe_dag_id = AirflowKubernetesScheduler._strip_unsafe_kubernetes_special_chars(
@@ -506,18 +531,45 @@ def _labels_to_key(self, labels):
             self.log.warn("could not get try_number as an int: %s", labels.get('try_number', '1'))
 
         try:
-            return (
-                labels['dag_id'], labels['task_id'],
-                self._label_safe_datestring_to_datetime(labels['execution_date']),
-                try_num,
-            )
+            dag_id = labels['dag_id']
+            task_id = labels['task_id']
+            ex_time = self._label_safe_datestring_to_datetime(labels['execution_date'])
         except Exception as e:
             self.log.warn(
-                'Error while converting labels to key; labels: %s; exception: %s',
+                'Error while retrieving labels; labels: %s; exception: %s',
                 labels, e
             )
             return None
 
+        with create_session() as session:
+            tasks = (
+                session
+                .query(TaskInstance)
+                .filter_by(execution_date=ex_time).all()
+            )
+            self.log.info(
+                'Checking %s task instances.',
+                len(tasks)
+            )
+            for task in tasks:
+                if (
+                    self._make_safe_label_value(task.dag_id) == dag_id and
+                    self._make_safe_label_value(task.task_id) == task_id and
+                    task.execution_date == ex_time
+                ):
+                    self.log.info(
+                        'Found matching task %s-%s (%s) with current state of %s',
+                        task.dag_id, task.task_id, task.execution_date, task.state
+                    )
+                    dag_id = task.dag_id
+                    task_id = task.task_id
+                    return (dag_id, task_id, ex_time, try_num)
+        self.log.warn(
+            'Failed to find and match task details to a pod; labels: %s',
+            labels
+        )
+        return None
+
 
 class KubernetesExecutor(BaseExecutor, LoggingMixin):
     def __init__(self):
@@ -555,10 +607,16 @@ def clear_not_launched_queued_tasks(self, session=None):
         )
 
         for task in queued_tasks:
-            dict_string = "dag_id={},task_id={},execution_date={},airflow-worker={}" \
-                .format(task.dag_id, task.task_id,
-                        AirflowKubernetesScheduler._datetime_to_label_safe_datestring(
-                            task.execution_date), self.worker_uuid)
+            dict_string = (
+                "dag_id={},task_id={},execution_date={},airflow-worker={}".format(
+                    AirflowKubernetesScheduler._make_safe_label_value(task.dag_id),
+                    AirflowKubernetesScheduler._make_safe_label_value(task.task_id),
+                    AirflowKubernetesScheduler._datetime_to_label_safe_datestring(
+                        task.execution_date
+                    ),
+                    self.worker_uuid
+                )
+            )
             kwargs = dict(label_selector=dict_string)
             pod_list = self.kube_client.list_namespaced_pod(
                 self.kube_config.kube_namespace, **kwargs)
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index c80e5cfeb46db..d00b3f1debe1c 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -39,8 +39,12 @@
 
 class TestAirflowKubernetesScheduler(unittest.TestCase):
     @staticmethod
-    def _gen_random_string(str_len):
-        return ''.join([random.choice(string.printable) for _ in range(str_len)])
+    def _gen_random_string(seed, str_len):
+        char_list = []
+        for char_seed in range(str_len):
+            random.seed(str(seed) * char_seed)
+            char_list.append(random.choice(string.printable))
+        return ''.join(char_list)
 
     def _cases(self):
         cases = [
@@ -52,26 +56,50 @@ def _cases(self):
         ]
 
         cases.extend([
-            (self._gen_random_string(200), self._gen_random_string(200))
-            for _ in range(100)
+            (self._gen_random_string(seed, 200), self._gen_random_string(seed, 200))
+            for seed in range(100)
         ])
 
         return cases
 
     @staticmethod
-    def _is_valid_name(name):
+    def _is_valid_pod_id(name):
         regex = r"^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$"
         return (
             len(name) <= 253 and
             all(ch.lower() == ch for ch in name) and
             re.match(regex, name))
 
+    @staticmethod
+    def _is_safe_label_value(value):
+        regex = r'^[^a-z0-9A-Z]*|[^a-zA-Z0-9_\-\.]|[^a-z0-9A-Z]*$'
+        return (
+            len(value) <= 63 and
+            re.match(regex, value))
+
     @unittest.skipIf(AirflowKubernetesScheduler is None,
                      'kubernetes python package is not installed')
     def test_create_pod_id(self):
         for dag_id, task_id in self._cases():
             pod_name = AirflowKubernetesScheduler._create_pod_id(dag_id, task_id)
-            self.assertTrue(self._is_valid_name(pod_name))
+            self.assertTrue(self._is_valid_pod_id(pod_name))
+
+    def test_make_safe_label_value(self):
+        for dag_id, task_id in self._cases():
+            safe_dag_id = AirflowKubernetesScheduler._make_safe_label_value(dag_id)
+            self.assertTrue(self._is_safe_label_value(safe_dag_id))
+            safe_task_id = AirflowKubernetesScheduler._make_safe_label_value(task_id)
+            self.assertTrue(self._is_safe_label_value(safe_task_id))
+            id = "my_dag_id"
+            self.assertEqual(
+                id,
+                AirflowKubernetesScheduler._make_safe_label_value(id)
+            )
+            id = "my_dag_id_" + "a" * 64
+            self.assertEqual(
+                "my_dag_id_" + "a" * 43 + "-0ce114c45",
+                AirflowKubernetesScheduler._make_safe_label_value(id)
+            )
 
     @unittest.skipIf(AirflowKubernetesScheduler is None,
                      "kubernetes python package is not installed")

From 5453357b069948b878fd9b437db2cf230677be62 Mon Sep 17 00:00:00 2001
From: BrechtDeVlieger <brechtdevlieger@hotmail.com>
Date: Sat, 23 Mar 2019 22:52:50 +0100
Subject: [PATCH 685/808] [AIRFLOW-3541] Add Avro logical type conversion to
 bigquery hook (#4553)

---
 airflow/contrib/hooks/bigquery_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 6c6154a984e59..56c9180d8e99b 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -1082,7 +1082,7 @@ def run_load(self,
             'DATASTORE_BACKUP': ['projectionFields'],
             'NEWLINE_DELIMITED_JSON': ['autodetect', 'ignoreUnknownValues'],
             'PARQUET': ['autodetect', 'ignoreUnknownValues'],
-            'AVRO': [],
+            'AVRO': ['useAvroLogicalTypes'],
         }
         valid_configs = src_fmt_to_configs_mapping[source_format]
         src_fmt_configs = {

From 5af870716615f96ab60d7e83ac28959d2863edf3 Mon Sep 17 00:00:00 2001
From: Dima Kamalov <42555784+dima-asana@users.noreply.github.com>
Date: Sat, 23 Mar 2019 20:35:04 -0700
Subject: [PATCH 686/808] [AIRFLOW-3982] Update DagRun state based on its own
 tasks (#4808)

---
 airflow/example_dags/tutorial.py |  1 -
 airflow/jobs.py                  |  4 --
 airflow/models/__init__.py       | 74 +++++++++++++-------------------
 tests/dags/test_issue_1225.py    | 14 +++++-
 tests/test_jobs.py               | 18 ++++++++
 5 files changed, 60 insertions(+), 51 deletions(-)

diff --git a/airflow/example_dags/tutorial.py b/airflow/example_dags/tutorial.py
index 3ab107da83e50..f87df8b2bca95 100644
--- a/airflow/example_dags/tutorial.py
+++ b/airflow/example_dags/tutorial.py
@@ -45,7 +45,6 @@
     # 'end_date': datetime(2016, 1, 1),
     # 'wait_for_downstream': False,
     # 'dag': dag,
-    # 'adhoc':False,
     # 'sla': timedelta(hours=2),
     # 'execution_timeout': timedelta(seconds=300),
     # 'on_failure_callback': some_function,
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 35ebc1b2da40c..8ad240b14a884 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -957,10 +957,6 @@ def _process_task_instances(self, dag, queue, session=None):
                 # fixme: ti.task is transient but needs to be set
                 ti.task = task
 
-                # future: remove adhoc
-                if task.adhoc:
-                    continue
-
                 if ti.are_dependencies_met(
                         dep_context=DepContext(flag_upstream_failed=True),
                         session=session):
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 8a459181d53e2..e552f89bc136a 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -2314,7 +2314,6 @@ def __init__(
             dag=None,
             params=None,
             default_args=None,
-            adhoc=False,
             priority_weight=1,
             weight_rule=WeightRule.DOWNSTREAM,
             queue=configuration.conf.get('celery', 'default_queue'),
@@ -2399,7 +2398,6 @@ def __init__(
         self.retry_exponential_backoff = retry_exponential_backoff
         self.max_retry_delay = max_retry_delay
         self.params = params or {}  # Available in templates!
-        self.adhoc = adhoc
         self.priority_weight = priority_weight
         if not WeightRule.is_valid(weight_rule):
             raise AirflowException(
@@ -2459,7 +2457,6 @@ def __init__(
             'schedule_interval',
             'depends_on_past',
             'wait_for_downstream',
-            'adhoc',
             'priority_weight',
             'sla',
             'execution_timeout',
@@ -3541,14 +3538,6 @@ def tasks(self, val):
     def task_ids(self):
         return list(self.task_dict.keys())
 
-    @property
-    def active_task_ids(self):
-        return list(k for k, v in self.task_dict.items() if not v.adhoc)
-
-    @property
-    def active_tasks(self):
-        return [t for t in self.tasks if not t.adhoc]
-
     @property
     def filepath(self):
         """
@@ -5099,7 +5088,6 @@ def update_state(self, session=None):
         dag = self.get_dag()
 
         tis = self.get_task_instances(session=session)
-
         self.log.debug("Updating state for %s considering %s task(s)", self, len(tis))
 
         for ti in list(tis):
@@ -5140,37 +5128,35 @@ def update_state(self, session=None):
         duration = (timezone.utcnow() - start_dttm).total_seconds() * 1000
         Stats.timing("dagrun.dependency-check.{}".format(self.dag_id), duration)
 
-        # future: remove the check on adhoc tasks (=active_tasks)
-        if len(tis) == len(dag.active_tasks):
-            root_ids = [t.task_id for t in dag.roots]
-            roots = [t for t in tis if t.task_id in root_ids]
-
-            # if all roots finished and at least one failed, the run failed
-            if (not unfinished_tasks and
-                    any(r.state in (State.FAILED, State.UPSTREAM_FAILED) for r in roots)):
-                self.log.info('Marking run %s failed', self)
-                self.set_state(State.FAILED)
-                dag.handle_callback(self, success=False, reason='task_failure',
-                                    session=session)
-
-            # if all roots succeeded and no unfinished tasks, the run succeeded
-            elif not unfinished_tasks and all(r.state in (State.SUCCESS, State.SKIPPED)
-                                              for r in roots):
-                self.log.info('Marking run %s successful', self)
-                self.set_state(State.SUCCESS)
-                dag.handle_callback(self, success=True, reason='success', session=session)
-
-            # if *all tasks* are deadlocked, the run failed
-            elif (unfinished_tasks and none_depends_on_past and
-                  none_task_concurrency and no_dependencies_met):
-                self.log.info('Deadlock; marking run %s failed', self)
-                self.set_state(State.FAILED)
-                dag.handle_callback(self, success=False, reason='all_tasks_deadlocked',
-                                    session=session)
-
-            # finally, if the roots aren't done, the dag is still running
-            else:
-                self.set_state(State.RUNNING)
+        root_ids = [t.task_id for t in dag.roots]
+        roots = [t for t in tis if t.task_id in root_ids]
+
+        # if all roots finished and at least one failed, the run failed
+        if (not unfinished_tasks and
+                any(r.state in (State.FAILED, State.UPSTREAM_FAILED) for r in roots)):
+            self.log.info('Marking run %s failed', self)
+            self.set_state(State.FAILED)
+            dag.handle_callback(self, success=False, reason='task_failure',
+                                session=session)
+
+        # if all roots succeeded and no unfinished tasks, the run succeeded
+        elif not unfinished_tasks and all(r.state in (State.SUCCESS, State.SKIPPED)
+                                          for r in roots):
+            self.log.info('Marking run %s successful', self)
+            self.set_state(State.SUCCESS)
+            dag.handle_callback(self, success=True, reason='success', session=session)
+
+        # if *all tasks* are deadlocked, the run failed
+        elif (unfinished_tasks and none_depends_on_past and
+              none_task_concurrency and no_dependencies_met):
+            self.log.info('Deadlock; marking run %s failed', self)
+            self.set_state(State.FAILED)
+            dag.handle_callback(self, success=False, reason='all_tasks_deadlocked',
+                                session=session)
+
+        # finally, if the roots aren't done, the dag is still running
+        else:
+            self.set_state(State.RUNNING)
 
         # todo: determine we want to use with_for_update to make sure to lock the run
         session.merge(self)
@@ -5214,8 +5200,6 @@ def verify_integrity(self, session=None):
 
         # check for missing tasks
         for task in six.itervalues(dag.task_dict):
-            if task.adhoc:
-                continue
             if task.start_date > self.execution_date and not self.is_backfill:
                 continue
 
diff --git a/tests/dags/test_issue_1225.py b/tests/dags/test_issue_1225.py
index 0450cf470f7b4..f9dea3794facb 100644
--- a/tests/dags/test_issue_1225.py
+++ b/tests/dags/test_issue_1225.py
@@ -23,7 +23,7 @@
 by a BackfillJob.
 Addresses issue #1225.
 """
-from datetime import datetime
+from datetime import datetime, timedelta
 
 from airflow.models import DAG
 from airflow.operators.dummy_operator import DummyOperator
@@ -150,3 +150,15 @@ def delayed_fail():
     dag=dag8,
     python_callable=fail,
 )
+
+# DAG tests that a Dag run that completes but has a root in the future is marked as success
+dag9 = DAG(dag_id='test_dagrun_states_root_future', default_args=default_args)
+dag9_task1 = DummyOperator(
+    task_id='current',
+    dag=dag9,
+)
+dag8_task2 = DummyOperator(
+    task_id='future',
+    dag=dag9,
+    start_date=DEFAULT_DATE + timedelta(days=1),
+)
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 6559c01285b18..a0de2ad1284a2 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -2426,6 +2426,24 @@ def test_dagrun_root_fail_unfinished(self):
         dr_state = dr.update_state()
         self.assertEqual(dr_state, State.RUNNING)
 
+    def test_dagrun_root_after_dagrun_unfinished(self):
+        """
+        DagRuns with one successful and one future root task -> SUCCESS
+        """
+        dag_id = 'test_dagrun_states_root_future'
+        dag = self.dagbag.get_dag(dag_id)
+        dag.clear()
+        scheduler = SchedulerJob(dag_id, num_runs=2)
+        # we can't use dag.run or evaluate_dagrun because it uses BackfillJob
+        # instead of SchedulerJob and BackfillJobs are allowed to not respect start dates
+        scheduler.run()
+
+        first_run = DagRun.find(dag_id=dag_id, execution_date=DEFAULT_DATE)[0]
+        ti_ids = [(ti.task_id, ti.state) for ti in first_run.get_task_instances()]
+
+        self.assertEqual(ti_ids, [('current', State.SUCCESS)])
+        self.assertEqual(first_run.state, State.SUCCESS)
+
     def test_dagrun_deadlock_ignore_depends_on_past_advance_ex_date(self):
         """
         DagRun is marked a success if ignore_first_depends_on_past=True

From b62512ec322f8e0038c862cda14c2d1088dfac2b Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Mon, 25 Mar 2019 02:28:52 -0700
Subject: [PATCH 687/808] [AIRFLOW-3982] Fix race condition in CI test (#4968)

---
 tests/test_jobs.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index a0de2ad1284a2..29fb5728df7b0 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -2429,6 +2429,8 @@ def test_dagrun_root_fail_unfinished(self):
     def test_dagrun_root_after_dagrun_unfinished(self):
         """
         DagRuns with one successful and one future root task -> SUCCESS
+
+        Noted: the DagRun state could be still in running state during CI.
         """
         dag_id = 'test_dagrun_states_root_future'
         dag = self.dagbag.get_dag(dag_id)
@@ -2442,7 +2444,7 @@ def test_dagrun_root_after_dagrun_unfinished(self):
         ti_ids = [(ti.task_id, ti.state) for ti in first_run.get_task_instances()]
 
         self.assertEqual(ti_ids, [('current', State.SUCCESS)])
-        self.assertEqual(first_run.state, State.SUCCESS)
+        self.assertIn(first_run.state, [State.SUCCESS, State.RUNNING])
 
     def test_dagrun_deadlock_ignore_depends_on_past_advance_ex_date(self):
         """

From 756bac6cfe164abc5620f4e31ac2b013c74f0def Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 25 Mar 2019 11:10:28 +0000
Subject: [PATCH 688/808] [AIRFLOW-3743] Unify different methods of working out
 AIRFLOW_HOME (#4705)

There were a few ways of getting the AIRFLOW_HOME directory used
throughout the code base, giving possibly conflicting answer if they
weren't kept in sync:

- the AIRFLOW_HOME environment variable
- core/airflow_home from the config
- settings.AIRFLOW_HOME
- configuration.AIRFLOW_HOME

Since the home directory is used to compute the default path of the
config file to load, specifying the home directory Again in the config
file didn't make any sense to me, and I have deprecated that.

This commit makes everything in the code base use
`settings.AIRFLOW_HOME` as the source of truth, and deprecates the
core/airflow_home config option.

There was an import cycle form settings -> logging_config ->
module_loading -> settings that needed to be broken on Python 2 - so I
have moved all adjusting of sys.path in to the settings module

(This issue caused me a problem where the RBAC UI wouldn't work as it
didn't find the right webserver_config.py)
---
 UPDATING.md                                   | 15 ++++++
 airflow/__init__.py                           |  3 +-
 airflow/bin/cli.py                            | 12 ++---
 airflow/config_templates/default_airflow.cfg  |  3 --
 airflow/config_templates/default_test.cfg     |  1 -
 airflow/configuration.py                      | 23 +++++++-
 .../contrib/executors/kubernetes_executor.py  |  4 +-
 .../kubernetes/worker_configuration.py        |  2 +-
 airflow/lineage/__init__.py                   |  3 +-
 airflow/logging_config.py                     |  6 +--
 airflow/plugins_manager.py                    | 13 +----
 airflow/settings.py                           | 54 ++++++++++++++-----
 airflow/utils/dag_processing.py               |  5 +-
 airflow/utils/log/file_processor_handler.py   |  4 +-
 airflow/utils/module_loading.py               | 14 -----
 airflow/www_rbac/app.py                       |  4 +-
 scripts/ci/airflow_travis.cfg                 |  1 -
 .../kube/templates/configmaps.template.yaml   |  1 -
 tests/cli/test_worker_initialisation.py       |  4 +-
 19 files changed, 98 insertions(+), 74 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 590f7bce558d1..de90cbe7131c0 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -122,6 +122,21 @@ This changes the behaviour if you previously explicitly provided `None` as a def
 Bit operation like `>>` or `<<` are recommended for setting the dependency, which is easier to explain.
 The `airflow.utlis.helpers.chain` function is deprecated and will be removed in Airflow 2.0.
 
+### Removal of `airflow_home` config setting
+
+There were previously two ways of specifying the Airflow "home" directory
+(`~/airflow` by default): the `AIRFLOW_HOME` environment variable, and the
+`airflow_home` config setting in the `[core]` section.
+
+If they had two different values different parts of the code base would end up
+with different values. The config setting has been deprecated, and you should
+remove the value from the config file and set `AIRFLOW_HOME` environment
+variable if you need to use a non default value for this.
+
+(Since this setting is used to calculate what config file to load, it is not
+possible to keep just the config option)
+
+
 ## Airflow 1.10.2
 
 ### DAG level Access Control for new RBAC UI
diff --git a/airflow/__init__.py b/airflow/__init__.py
index d010fe4c74840..7324e49119c5d 100644
--- a/airflow/__init__.py
+++ b/airflow/__init__.py
@@ -39,8 +39,7 @@
 from importlib import import_module
 from airflow.exceptions import AirflowException
 
-if settings.DAGS_FOLDER not in sys.path:
-    sys.path.append(settings.DAGS_FOLDER)
+settings.initialize()
 
 login = None
 
diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 459e35d967e2e..523f3fa689686 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -121,17 +121,13 @@ def setup_logging(filename):
 
 def setup_locations(process, pid=None, stdout=None, stderr=None, log=None):
     if not stderr:
-        stderr = os.path.join(os.path.expanduser(settings.AIRFLOW_HOME),
-                              'airflow-{}.err'.format(process))
+        stderr = os.path.join(settings.AIRFLOW_HOME, 'airflow-{}.err'.format(process))
     if not stdout:
-        stdout = os.path.join(os.path.expanduser(settings.AIRFLOW_HOME),
-                              'airflow-{}.out'.format(process))
+        stdout = os.path.join(settings.AIRFLOW_HOME, 'airflow-{}.out'.format(process))
     if not log:
-        log = os.path.join(os.path.expanduser(settings.AIRFLOW_HOME),
-                           'airflow-{}.log'.format(process))
+        log = os.path.join(settings.AIRFLOW_HOME, 'airflow-{}.log'.format(process))
     if not pid:
-        pid = os.path.join(os.path.expanduser(settings.AIRFLOW_HOME),
-                           'airflow-{}.pid'.format(process))
+        pid = os.path.join(settings.AIRFLOW_HOME, 'airflow-{}.pid'.format(process))
 
     return pid, stdout, stderr, log
 
diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 459713526230f..f4ed342e027fc 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -30,9 +30,6 @@
 # ----------------------- TEMPLATE BEGINS HERE -----------------------
 
 [core]
-# The home folder for airflow, default is ~/airflow
-airflow_home = {AIRFLOW_HOME}
-
 # The folder where your airflow pipelines live, most likely a
 # subfolder in a code repository
 # This path must be absolute
diff --git a/airflow/config_templates/default_test.cfg b/airflow/config_templates/default_test.cfg
index 4b1b84f5e9f93..10281f6106e0d 100644
--- a/airflow/config_templates/default_test.cfg
+++ b/airflow/config_templates/default_test.cfg
@@ -31,7 +31,6 @@
 
 [core]
 unit_test_mode = True
-airflow_home = {AIRFLOW_HOME}
 dags_folder = {TEST_DAGS_FOLDER}
 plugins_folder = {TEST_PLUGINS_FOLDER}
 base_log_folder = {AIRFLOW_HOME}/logs
diff --git a/airflow/configuration.py b/airflow/configuration.py
index 64ce7792bd069..ec38236bbaa94 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -558,12 +558,31 @@ def parameterized_config(template):
 
 conf.read(AIRFLOW_CONFIG)
 
+if conf.has_option('core', 'AIRFLOW_HOME'):
+    msg = (
+        'Specifying both AIRFLOW_HOME environment variable and airflow_home '
+        'in the config file is deprecated. Please use only the AIRFLOW_HOME '
+        'environment variable and remove the config file entry.'
+    )
+    if 'AIRFLOW_HOME' in os.environ:
+        warnings.warn(msg, category=DeprecationWarning)
+    elif conf.get('core', 'airflow_home') == AIRFLOW_HOME:
+        warnings.warn(
+            'Specifying airflow_home in the config file is deprecated. As you '
+            'have left it at the default value you should remove the setting '
+            'from your airflow.cfg and suffer no change in behaviour.',
+            category=DeprecationWarning,
+        )
+    else:
+        AIRFLOW_HOME = conf.get('core', 'airflow_home')
+        warnings.warn(msg, category=DeprecationWarning)
+
+
+WEBSERVER_CONFIG = AIRFLOW_HOME + '/webserver_config.py'
 
 if conf.getboolean('webserver', 'rbac'):
     DEFAULT_WEBSERVER_CONFIG = _read_default_config_file('default_webserver_config.py')
 
-    WEBSERVER_CONFIG = AIRFLOW_HOME + '/webserver_config.py'
-
     if not os.path.isfile(WEBSERVER_CONFIG):
         log.info('Creating new FAB webserver config file in: %s', WEBSERVER_CONFIG)
         with open(WEBSERVER_CONFIG, 'w') as f:
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index cdf7e54d5d70f..994b45b4c9df1 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -35,7 +35,7 @@
 from airflow.models import TaskInstance, KubeResourceVersion, KubeWorkerIdentifier
 from airflow.utils.state import State
 from airflow.utils.db import provide_session, create_session
-from airflow import configuration
+from airflow import configuration, settings
 from airflow.exceptions import AirflowConfigException, AirflowException
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -124,7 +124,7 @@ def __init__(self):
         self.core_configuration = configuration_dict['core']
         self.kube_secrets = configuration_dict.get('kubernetes_secrets', {})
         self.kube_env_vars = configuration_dict.get('kubernetes_environment_variables', {})
-        self.airflow_home = configuration.get(self.core_section, 'airflow_home')
+        self.airflow_home = settings.AIRFLOW_HOME
         self.dags_folder = configuration.get(self.core_section, 'dags_folder')
         self.parallelism = configuration.getint(self.core_section, 'PARALLELISM')
         self.worker_container_repository = configuration.get(
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index f875606950179..0d301e910e1c8 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -103,7 +103,7 @@ def _get_environment(self):
         env["AIRFLOW__CORE__EXECUTOR"] = "LocalExecutor"
 
         if self.kube_config.airflow_configmap:
-            env['AIRFLOW__CORE__AIRFLOW_HOME'] = self.worker_airflow_home
+            env['AIRFLOW_HOME'] = self.worker_airflow_home
             env['AIRFLOW__CORE__DAGS_FOLDER'] = self.worker_airflow_dags
         if (not self.kube_config.airflow_configmap and
                 'AIRFLOW__CORE__SQL_ALCHEMY_CONN' not in self.kube_config.kube_secrets):
diff --git a/airflow/lineage/__init__.py b/airflow/lineage/__init__.py
index 3e2af478bb5e0..9eaafebc19ff1 100644
--- a/airflow/lineage/__init__.py
+++ b/airflow/lineage/__init__.py
@@ -21,7 +21,7 @@
 from airflow import configuration as conf
 from airflow.lineage.datasets import DataSet
 from airflow.utils.log.logging_mixin import LoggingMixin
-from airflow.utils.module_loading import import_string, prepare_classpath
+from airflow.utils.module_loading import import_string
 
 from itertools import chain
 
@@ -36,7 +36,6 @@ def _get_backend():
 
     try:
         _backend_str = conf.get("lineage", "backend")
-        prepare_classpath()
         backend = import_string(_backend_str)
     except ImportError as ie:
         log.debug("Cannot import %s due to %s", _backend_str, ie)
diff --git a/airflow/logging_config.py b/airflow/logging_config.py
index 4865f0567a571..0cf8f4db0d59b 100644
--- a/airflow/logging_config.py
+++ b/airflow/logging_config.py
@@ -23,7 +23,7 @@
 
 from airflow import configuration as conf
 from airflow.exceptions import AirflowConfigException
-from airflow.utils.module_loading import import_string, prepare_classpath
+from airflow.utils.module_loading import import_string
 
 log = logging.getLogger(__name__)
 
@@ -31,10 +31,6 @@
 def configure_logging():
     logging_class_path = ''
     try:
-        # Prepare the classpath so we are sure that the config folder
-        # is on the python classpath and it is reachable
-        prepare_classpath()
-
         logging_class_path = conf.get('core', 'logging_config_class')
     except AirflowConfigException:
         log.debug('Could not find key logging_config_class in config')
diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index 811e1b4c58122..9f338daed4541 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -27,10 +27,9 @@
 import inspect
 import os
 import re
-import sys
 import pkg_resources
 
-from airflow import configuration
+from airflow import settings
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 log = LoggingMixin().log
@@ -114,20 +113,12 @@ def is_valid_plugin(plugin_obj, existing_plugins):
     return False
 
 
-plugins_folder = configuration.conf.get('core', 'plugins_folder')
-if not plugins_folder:
-    plugins_folder = configuration.conf.get('core', 'airflow_home') + '/plugins'
-plugins_folder = os.path.expanduser(plugins_folder)
-
-if plugins_folder not in sys.path:
-    sys.path.append(plugins_folder)
-
 plugins = []
 
 norm_pattern = re.compile(r'[/|.]')
 
 # Crawl through the plugins folder to find AirflowPlugin derivatives
-for root, dirs, files in os.walk(plugins_folder, followlinks=True):
+for root, dirs, files in os.walk(settings.PLUGINS_FOLDER, followlinks=True):
     for f in files:
         try:
             filepath = os.path.join(root, f)
diff --git a/airflow/settings.py b/airflow/settings.py
index e614378780cfd..8a78e5e87dd41 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -26,12 +26,13 @@
 import logging
 import os
 import pendulum
+import sys
 
 from sqlalchemy import create_engine, exc
 from sqlalchemy.orm import scoped_session, sessionmaker
 from sqlalchemy.pool import NullPool
 
-from airflow import configuration as conf
+from airflow.configuration import conf, AIRFLOW_HOME, WEBSERVER_CONFIG  # NOQA F401
 from airflow.logging_config import configure_logging
 from airflow.utils.sqlalchemy import setup_event_handlers
 
@@ -98,9 +99,10 @@ def timing(cls, stat, dt):
 LOG_FORMAT = conf.get('core', 'log_format')
 SIMPLE_LOG_FORMAT = conf.get('core', 'simple_log_format')
 
-AIRFLOW_HOME = None
 SQL_ALCHEMY_CONN = None
 DAGS_FOLDER = None
+PLUGINS_FOLDER = None
+LOGGING_CLASS_PATH = None
 
 engine = None
 Session = None
@@ -134,13 +136,18 @@ def policy(task_instance):
 
 
 def configure_vars():
-    global AIRFLOW_HOME
     global SQL_ALCHEMY_CONN
     global DAGS_FOLDER
-    AIRFLOW_HOME = os.path.expanduser(conf.get('core', 'AIRFLOW_HOME'))
+    global PLUGINS_FOLDER
     SQL_ALCHEMY_CONN = conf.get('core', 'SQL_ALCHEMY_CONN')
     DAGS_FOLDER = os.path.expanduser(conf.get('core', 'DAGS_FOLDER'))
 
+    PLUGINS_FOLDER = conf.get(
+        'core',
+        'plugins_folder',
+        fallback=os.path.join(AIRFLOW_HOME, 'plugins')
+    )
+
 
 def configure_orm(disable_connection_pool=False):
     log.debug("Setting up DB connection pool (PID %s)" % os.getpid())
@@ -247,21 +254,44 @@ def configure_action_logging():
     pass
 
 
+def prepare_classpath():
+    """
+    Ensures that certain subfolders of AIRFLOW_HOME are on the classpath
+    """
+
+    if DAGS_FOLDER not in sys.path:
+        sys.path.append(DAGS_FOLDER)
+
+    # Add ./config/ for loading custom log parsers etc, or
+    # airflow_local_settings etc.
+    config_path = os.path.join(AIRFLOW_HOME, 'config')
+    if config_path not in sys.path:
+        sys.path.append(config_path)
+
+    if PLUGINS_FOLDER not in sys.path:
+        sys.path.append(PLUGINS_FOLDER)
+
+
 try:
     from airflow_local_settings import *  # noqa F403 F401
     log.info("Loaded airflow_local_settings.")
 except Exception:
     pass
 
-logging_class_path = configure_logging()
-configure_vars()
-configure_adapters()
-# The webservers import this file from models.py with the default settings.
-configure_orm()
-configure_action_logging()
 
-# Ensure we close DB connections at scheduler and gunicon worker terminations
-atexit.register(dispose_orm)
+def initialize():
+    configure_vars()
+    prepare_classpath()
+    global LOGGING_CLASS_PATH
+    LOGGING_CLASS_PATH = configure_logging()
+    configure_adapters()
+    # The webservers import this file from models.py with the default settings.
+    configure_orm()
+    configure_action_logging()
+
+    # Ensure we close DB connections at scheduler and gunicon worker terminations
+    atexit.register(dispose_orm)
+
 
 # Const stuff
 
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 27a5da252dc21..3536e0992296b 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -46,7 +46,7 @@
 from airflow import configuration as conf
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.exceptions import AirflowException
-from airflow.settings import logging_class_path, Stats
+from airflow.settings import Stats
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -544,8 +544,9 @@ def helper():
             os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER'] = 'True'
             # Replicating the behavior of how logging module was loaded
             # in logging_config.py
-            reload_module(import_module(logging_class_path.rsplit('.', 1)[0]))
+            reload_module(import_module(airflow.settings.LOGGING_CLASS_PATH.rsplit('.', 1)[0]))
             reload_module(airflow.settings)
+            airflow.settings.initialize()
             del os.environ['CONFIG_PROCESSOR_MANAGER_LOGGER']
             processor_manager = DagFileProcessorManager(dag_directory,
                                                         file_paths,
diff --git a/airflow/utils/log/file_processor_handler.py b/airflow/utils/log/file_processor_handler.py
index cc7a8bd843ace..9ef7e8eafb0ac 100644
--- a/airflow/utils/log/file_processor_handler.py
+++ b/airflow/utils/log/file_processor_handler.py
@@ -21,7 +21,7 @@
 import logging
 import os
 
-from airflow import configuration as conf
+from airflow import settings
 from airflow.utils.helpers import parse_template_string
 from datetime import datetime
 
@@ -41,7 +41,7 @@ def __init__(self, base_log_folder, filename_template):
         super(FileProcessorHandler, self).__init__()
         self.handler = None
         self.base_log_folder = base_log_folder
-        self.dag_dir = os.path.expanduser(conf.get('core', 'DAGS_FOLDER'))
+        self.dag_dir = os.path.expanduser(settings.DAGS_FOLDER)
         self.filename_template, self.filename_jinja_template = \
             parse_template_string(filename_template)
 
diff --git a/airflow/utils/module_loading.py b/airflow/utils/module_loading.py
index 51c6adf4e642c..d5b4971b736dd 100644
--- a/airflow/utils/module_loading.py
+++ b/airflow/utils/module_loading.py
@@ -16,24 +16,10 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-import os
-import sys
 
-from airflow import configuration as conf
 from importlib import import_module
 
 
-def prepare_classpath():
-    """
-    Ensures that the Airflow home directory is on the classpath
-    """
-    config_path = os.path.join(conf.get('core', 'airflow_home'), 'config')
-    config_path = os.path.expanduser(config_path)
-
-    if config_path not in sys.path:
-        sys.path.append(config_path)
-
-
 def import_string(dotted_path):
     """
     Import a dotted module path and return the attribute/class designated by the
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 58e296c4ca9bf..44adc03a56e77 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -47,9 +47,7 @@ def create_app(config=None, session=None, testing=False, app_name="Airflow"):
         app.wsgi_app = ProxyFix(app.wsgi_app)
     app.secret_key = conf.get('webserver', 'SECRET_KEY')
 
-    airflow_home_path = conf.get('core', 'AIRFLOW_HOME')
-    webserver_config_path = airflow_home_path + '/webserver_config.py'
-    app.config.from_pyfile(webserver_config_path, silent=True)
+    app.config.from_pyfile(settings.WEBSERVER_CONFIG, silent=True)
     app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
     app.config['APP_NAME'] = app_name
     app.config['TESTING'] = testing
diff --git a/scripts/ci/airflow_travis.cfg b/scripts/ci/airflow_travis.cfg
index 7b6d3622804bf..15fb53e0d8303 100644
--- a/scripts/ci/airflow_travis.cfg
+++ b/scripts/ci/airflow_travis.cfg
@@ -17,7 +17,6 @@
 # under the License.
 
 [core]
-airflow_home = ~/airflow
 dags_folder = ~/airflow/dags
 base_log_folder = ~/airflow/logs
 executor = LocalExecutor
diff --git a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
index 527023d36ef80..732eb593d4749 100644
--- a/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
+++ b/scripts/ci/kubernetes/kube/templates/configmaps.template.yaml
@@ -21,7 +21,6 @@ metadata:
 data:
   airflow.cfg: |
     [core]
-    airflow_home = /root/airflow
     dags_folder = {{CONFIGMAP_DAGS_FOLDER}}
     base_log_folder = /root/airflow/logs
     logging_level = INFO
diff --git a/tests/cli/test_worker_initialisation.py b/tests/cli/test_worker_initialisation.py
index 8baa787a61b37..d6a8fd4404323 100644
--- a/tests/cli/test_worker_initialisation.py
+++ b/tests/cli/test_worker_initialisation.py
@@ -53,7 +53,7 @@ def test_error(self, mock_validate_session):
             cli.worker(mock_args)
         self.assertEqual(cm.exception.code, 1)
 
-    @mock.patch('airflow.configuration.getboolean')
+    @mock.patch('airflow.configuration.conf.getboolean')
     def test_worker_precheck_exception(self, mock_getboolean):
         """
         Test to check the behaviour of validate_session method
@@ -65,7 +65,7 @@ def test_worker_precheck_exception(self, mock_getboolean):
         mock_getboolean.assert_called_once_with('core', 'worker_precheck', fallback=False)
 
     @mock.patch('sqlalchemy.orm.session.Session.execute')
-    @mock.patch('airflow.configuration.getboolean')
+    @mock.patch('airflow.configuration.conf.getboolean')
     def test_validate_session_dbapi_exception(self, mock_getboolean, mock_session):
         """
         Test to validate connection failure scenario on SELECT 1 query

From 1b3c54bf417bff77ebedd16d5c979d6bb9bf716d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcin=20Szyma=C5=84ski?= <ms32035@gmail.com>
Date: Mon, 25 Mar 2019 11:57:55 +0000
Subject: [PATCH 689/808] [AIRFLOW-3423] Fix mongo hook to work with anonymous
 access (#4258)

If no login/password was supplied it would generate an invalid DSN
---
 airflow/contrib/hooks/mongo_hook.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index d6ad2625334e9..01dc4a42d0b32 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -60,11 +60,11 @@ def get_conn(self):
         uri = 'mongodb://{creds}{host}{port}/{database}'.format(
             creds='{}:{}@'.format(
                 conn.login, conn.password
-            ) if conn.login is not None else '',
+            ) if conn.login else '',
 
             host=conn.host,
             port='' if conn.port is None else ':{}'.format(conn.port),
-            database='' if conn.schema is None else conn.schema
+            database=conn.schema
         )
 
         # Mongo Connection Options dict that is unpacked when passed to MongoClient

From 9a159ce94574a199ebdcc3975e0aec52079b20a6 Mon Sep 17 00:00:00 2001
From: Jiajie Zhong <zhongjiajie955@hotmail.com>
Date: Mon, 25 Mar 2019 20:14:43 +0800
Subject: [PATCH 690/808] [AIRFLOW-4062] Improve docs on install extra package
 commands (#4966)

Some command for installing extra packages like
`pip install apache-airflow[devel]` cause error
in special situation/shell, We should clear them
by add quotation like
`pip install 'apache-airflow[devel]'`
---
 CONTRIBUTING.md                               |   8 +-
 .../example_kubernetes_operator.py            |   4 +-
 airflow/contrib/utils/sendgrid.py             |   2 +-
 docs/howto/secure-connections.rst             |   4 +-
 docs/howto/write-logs.rst                     |   2 +-
 docs/installation.rst                         | 142 +++++++++---------
 docs/security.rst                             |   6 +-
 7 files changed, 85 insertions(+), 83 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3326018234c74..903f453d9faa2 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -85,7 +85,9 @@ The latest API documentation is usually available
 you need to have set up an Airflow development environemnt (see below). Also
 install the `doc` extra.
 
-    pip install -e .[doc]
+```
+pip install -e '.[doc]'
+```
 
 Generate the documentation by running:
 
@@ -112,7 +114,7 @@ There are three ways to setup an Apache Airflow development environment.
   cd $AIRFLOW_HOME
   virtualenv env
   source env/bin/activate
-  pip install -e .[devel]
+  pip install -e '.[devel]'
   ```
 
 2. Using a Docker container
@@ -126,7 +128,7 @@ There are three ways to setup an Apache Airflow development environment.
 
   # Install Airflow with all the required dependencies,
   # including the devel which will provide the development tools
-  pip install -e ".[hdfs,hive,druid,devel]"
+  pip install -e '.[hdfs,hive,druid,devel]'
 
   # Init the database
   airflow initdb
diff --git a/airflow/contrib/example_dags/example_kubernetes_operator.py b/airflow/contrib/example_dags/example_kubernetes_operator.py
index ba1f4433a78cc..4977890bc68f3 100644
--- a/airflow/contrib/example_dags/example_kubernetes_operator.py
+++ b/airflow/contrib/example_dags/example_kubernetes_operator.py
@@ -25,7 +25,7 @@
 
 try:
     # Kubernetes is optional, so not available in vanilla Airflow
-    # pip install apache-airflow[kubernetes]
+    # pip install 'apache-airflow[kubernetes]'
     from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
 
     args = {
@@ -64,4 +64,4 @@
 except ImportError as e:
     log.warn("Could not import KubernetesPodOperator: " + str(e))
     log.warn("Install kubernetes dependencies with: "
-             "    pip install apache-airflow[kubernetes]")
+             "    pip install 'apache-airflow[kubernetes]'")
diff --git a/airflow/contrib/utils/sendgrid.py b/airflow/contrib/utils/sendgrid.py
index ceb3718ff584d..5082c7a3328bf 100644
--- a/airflow/contrib/utils/sendgrid.py
+++ b/airflow/contrib/utils/sendgrid.py
@@ -42,7 +42,7 @@ def send_email(to, subject, html_content, files=None,
 
     To use this plugin:
     0. include sendgrid subpackage as part of your Airflow installation, e.g.,
-    pip install apache-airflow[sendgrid]
+    pip install 'apache-airflow[sendgrid]'
     1. update [email] backend in airflow.cfg, i.e.,
     [email]
     email_backend = airflow.contrib.utils.sendgrid.send_email
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index 47b97c5fa4f47..eef49b3234982 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -27,8 +27,8 @@ If ``crypto`` package was not installed initially, it means that your Fernet key
 
 You can still enable encryption for passwords within connections by following below steps:
 
-1. Install crypto package ``pip install apache-airflow[crypto]``
-2. Generate fernet_key, using this code snippet below. ``fernet_key`` must be a base64-encoded 32-byte key.
+#. Install crypto package ``pip install 'apache-airflow[crypto]'``
+#. Generate fernet_key, using this code snippet below. ``fernet_key`` must be a base64-encoded 32-byte key:
 
 .. code:: python
 
diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index f3cc4017f443d..b12b60ef86def 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -121,7 +121,7 @@ example:
     remote_base_log_folder = gs://my-bucket/path/to/logs
     remote_log_conn_id = MyGCSConn
 
-#. Install the ``gcp_api`` package first, like so: ``pip install apache-airflow[gcp_api]``.
+#. Install the ``gcp_api`` package first, like so: ``pip install 'apache-airflow[gcp_api]'``.
 #. Make sure a Google Cloud Platform connection hook has been defined in Airflow. The hook should have read and write access to the Google Cloud Storage bucket defined above in ``remote_base_log_folder``.
 #. Restart the Airflow webserver and scheduler, and trigger (or wait for) a new task execution.
 #. Verify that logs are showing up for newly executed tasks in the bucket you've defined.
diff --git a/docs/installation.rst b/docs/installation.rst
index 33c71439d241e..ad704c7dceebb 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -47,77 +47,77 @@ these extra dependencies.
 
 Here's the list of the subpackages and what they enable:
 
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| subpackage          | install command                                   | enables                                         |
-+=====================+===================================================+=================================================+
-| all                 | ``pip install apache-airflow[all]``               | All Airflow features known to man               |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| all_dbs             | ``pip install apache-airflow[all_dbs]``           | All databases integrations                      |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| async               | ``pip install apache-airflow[async]``             | Async worker classes for Gunicorn               |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| celery              | ``pip install apache-airflow[celery]``            | CeleryExecutor                                  |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| cloudant            | ``pip install apache-airflow[cloudant]``          | Cloudant hook                                   |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| crypto              | ``pip install apache-airflow[crypto]``            | Encrypt connection passwords in metadata db     |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| devel               | ``pip install apache-airflow[devel]``             | Minimum dev tools requirements                  |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| devel_hadoop        | ``pip install apache-airflow[devel_hadoop]``      | Airflow + dependencies on the Hadoop stack      |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| druid               | ``pip install apache-airflow[druid]``             | Druid related operators & hooks                 |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| gcp_api             | ``pip install apache-airflow[gcp_api]``           | Google Cloud Platform hooks and operators       |
-|                     |                                                   | (using ``google-api-python-client``)            |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| github_enterprise   | ``pip install apache-airflow[github_enterprise]`` | GitHub Enterprise auth backend                  |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| google_auth         | ``pip install apache-airflow[google_auth]``       | Google auth backend                             |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| hdfs                | ``pip install apache-airflow[hdfs]``              | HDFS hooks and operators                        |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| hive                | ``pip install apache-airflow[hive]``              | All Hive related operators                      |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| jdbc                | ``pip install apache-airflow[jdbc]``              | JDBC hooks and operators                        |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| kerberos            | ``pip install apache-airflow[kerberos]``          | Kerberos integration for Kerberized Hadoop      |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| kubernetes          | ``pip install apache-airflow[kubernetes]``        | Kubernetes Executor and operator                |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| ldap                | ``pip install apache-airflow[ldap]``              | LDAP authentication for users                   |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| mssql               | ``pip install apache-airflow[mssql]``             | Microsoft SQL Server operators and hook,        |
-|                     |                                                   | support as an Airflow backend                   |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| mysql               | ``pip install apache-airflow[mysql]``             | MySQL operators and hook, support as an Airflow |
-|                     |                                                   | backend. The version of MySQL server has to be  |
-|                     |                                                   | 5.6.4+. The exact version upper bound depends   |
-|                     |                                                   | on version of ``mysqlclient`` package. For      |
-|                     |                                                   | example, ``mysqlclient`` 1.3.12 can only be     |
-|                     |                                                   | used with MySQL server 5.6.4 through 5.7.       |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| password            | ``pip install apache-airflow[password]``          | Password authentication for users               |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| postgres            | ``pip install apache-airflow[postgres]``          | PostgreSQL operators and hook, support as an    |
-|                     |                                                   | Airflow backend                                 |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| qds                 | ``pip install apache-airflow[qds]``               | Enable QDS (Qubole Data Service) support        |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| rabbitmq            | ``pip install apache-airflow[rabbitmq]``          | RabbitMQ support as a Celery backend            |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| redis               | ``pip install apache-airflow[redis]``             | Redis hooks and sensors                         |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| s3                  | ``pip install apache-airflow[s3]``                | ``S3KeySensor``, ``S3PrefixSensor``             |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| samba               | ``pip install apache-airflow[samba]``             | ``Hive2SambaOperator``                          |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| slack               | ``pip install apache-airflow[slack]``             | ``SlackAPIPostOperator``                        |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| ssh                 | ``pip install apache-airflow[ssh]``               | SSH hooks and Operator                          |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
-| vertica             | ``pip install apache-airflow[vertica]``           | Vertica hook support as an Airflow backend      |
-+---------------------+---------------------------------------------------+-------------------------------------------------+
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| subpackage          | install command                                     | enables                                         |
++=====================+=====================================================+=================================================+
+| all                 | ``pip install 'apache-airflow[all]'``               | All Airflow features known to man               |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| all_dbs             | ``pip install 'apache-airflow[all_dbs]'``           | All databases integrations                      |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| async               | ``pip install 'apache-airflow[async]'``             | Async worker classes for Gunicorn               |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| celery              | ``pip install 'apache-airflow[celery]'``            | CeleryExecutor                                  |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| cloudant            | ``pip install 'apache-airflow[cloudant]'``          | Cloudant hook                                   |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| crypto              | ``pip install 'apache-airflow[crypto]'``            | Encrypt connection passwords in metadata db     |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| devel               | ``pip install 'apache-airflow[devel]'``             | Minimum dev tools requirements                  |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| devel_hadoop        | ``pip install 'apache-airflow[devel_hadoop]'``      | Airflow + dependencies on the Hadoop stack      |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| druid               | ``pip install 'apache-airflow[druid]'``             | Druid related operators & hooks                 |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| gcp_api             | ``pip install 'apache-airflow[gcp_api]'``           | Google Cloud Platform hooks and operators       |
+|                     |                                                     | (using ``google-api-python-client``)            |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| github_enterprise   | ``pip install 'apache-airflow[github_enterprise]'`` | GitHub Enterprise auth backend                  |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| google_auth         | ``pip install 'apache-airflow[google_auth]'``       | Google auth backend                             |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| hdfs                | ``pip install 'apache-airflow[hdfs]'``              | HDFS hooks and operators                        |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| hive                | ``pip install 'apache-airflow[hive]'``              | All Hive related operators                      |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| jdbc                | ``pip install 'apache-airflow[jdbc]'``              | JDBC hooks and operators                        |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| kerberos            | ``pip install 'apache-airflow[kerberos]'``          | Kerberos integration for Kerberized Hadoop      |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| kubernetes          | ``pip install 'apache-airflow[kubernetes]'``        | Kubernetes Executor and operator                |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| ldap                | ``pip install 'apache-airflow[ldap]'``              | LDAP authentication for users                   |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| mssql               | ``pip install 'apache-airflow[mssql]'``             | Microsoft SQL Server operators and hook,        |
+|                     |                                                     | support as an Airflow backend                   |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| mysql               | ``pip install 'apache-airflow[mysql]'``             | MySQL operators and hook, support as an Airflow |
+|                     |                                                     | backend. The version of MySQL server has to be  |
+|                     |                                                     | 5.6.4+. The exact version upper bound depends   |
+|                     |                                                     | on version of ``mysqlclient`` package. For      |
+|                     |                                                     | example, ``mysqlclient`` 1.3.12 can only be     |
+|                     |                                                     | used with MySQL server 5.6.4 through 5.7.       |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| password            | ``pip install 'apache-airflow[password]'``          | Password authentication for users               |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| postgres            | ``pip install 'apache-airflow[postgres]'``          | PostgreSQL operators and hook, support as an    |
+|                     |                                                     | Airflow backend                                 |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| qds                 | ``pip install 'apache-airflow[qds]'``               | Enable QDS (Qubole Data Service) support        |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| rabbitmq            | ``pip install 'apache-airflow[rabbitmq]'``          | RabbitMQ support as a Celery backend            |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| redis               | ``pip install 'apache-airflow[redis]'``             | Redis hooks and sensors                         |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| s3                  | ``pip install 'apache-airflow[s3]'``                | ``S3KeySensor``, ``S3PrefixSensor``             |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| samba               | ``pip install 'apache-airflow[samba]'``             | ``Hive2SambaOperator``                          |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| slack               | ``pip install 'apache-airflow[slack]'``             | ``SlackAPIPostOperator``                        |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| ssh                 | ``pip install 'apache-airflow[ssh]'``               | SSH hooks and Operator                          |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
+| vertica             | ``pip install 'apache-airflow[vertica]'``           | Vertica hook support as an Airflow backend      |
++---------------------+-----------------------------------------------------+-------------------------------------------------+
 
 Initiating Airflow Database
 '''''''''''''''''''''''''''
diff --git a/docs/security.rst b/docs/security.rst
index 1234f90c2f364..4058ddfe61c0e 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -262,7 +262,7 @@ To use kerberos authentication, you must install Airflow with the `kerberos` ext
 
 .. code-block:: bash
 
-   pip install airflow[kerberos]
+   pip install 'apache-airflow[kerberos]'
 
 OAuth Authentication
 --------------------
@@ -295,7 +295,7 @@ To use GHE authentication, you must install Airflow with the `github_enterprise`
 
 .. code-block:: bash
 
-   pip install airflow[github_enterprise]
+   pip install 'apache-airflow[github_enterprise]'
 
 Setting up GHE Authentication
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -343,7 +343,7 @@ To use Google authentication, you must install Airflow with the `google_auth` ex
 
 .. code-block:: bash
 
-   pip install airflow[google_auth]
+   pip install 'apache-airflow[google_auth]'
 
 Setting up Google Authentication
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

From c078bea3e85bbfe407a3b0ba920c523a943a93d9 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sun, 17 Mar 2019 20:39:58 +0000
Subject: [PATCH 691/808] [AIRFLOW-XXX] Remove old/non-test files that nose
 ignores (#4930)

This file contains tests for a module that was deleted in
[AIRFLOW-1582] but the code was deleted in a7a518902dc (in 2017)

This file _also_ matches the name of a python module:
tests.test_utils.db etc, so having a file with the same name as the
package is bad/ambigious at best.
---
 tests/test_utils.py | 100 --------------------------------------------
 1 file changed, 100 deletions(-)
 delete mode 100644 tests/test_utils.py

diff --git a/tests/test_utils.py b/tests/test_utils.py
deleted file mode 100644
index f670e4118368e..0000000000000
--- a/tests/test_utils.py
+++ /dev/null
@@ -1,100 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-from __future__ import absolute_import
-from __future__ import division
-from __future__ import print_function
-from __future__ import unicode_literals
-
-import logging
-import unittest
-
-import airflow.utils.logging
-from airflow import configuration
-from airflow.exceptions import AirflowException
-from airflow.utils.operator_resources import Resources
-
-
-class LogUtilsTest(unittest.TestCase):
-
-    def test_gcs_url_parse(self):
-        """
-        Test GCS url parsing
-        """
-        logging.info(
-            'About to create a GCSLog object without a connection. This will '
-            'log an error but testing will proceed.')
-        glog = airflow.utils.logging.GCSLog()
-
-        self.assertEqual(
-            glog.parse_gcs_url('gs://bucket/path/to/blob'),
-            ('bucket', 'path/to/blob'))
-
-        # invalid URI
-        self.assertRaises(
-            AirflowException,
-            glog.parse_gcs_url,
-            'gs:/bucket/path/to/blob')
-
-        # trailing slash
-        self.assertEqual(
-            glog.parse_gcs_url('gs://bucket/path/to/blob/'),
-            ('bucket', 'path/to/blob'))
-
-        # bucket only
-        self.assertEqual(
-            glog.parse_gcs_url('gs://bucket/'),
-            ('bucket', ''))
-
-
-class OperatorResourcesTest(unittest.TestCase):
-
-    def setUp(self):
-        configuration.load_test_config()
-
-    def test_all_resources_specified(self):
-        resources = Resources(cpus=1, ram=2, disk=3, gpus=4)
-        self.assertEqual(resources.cpus.qty, 1)
-        self.assertEqual(resources.ram.qty, 2)
-        self.assertEqual(resources.disk.qty, 3)
-        self.assertEqual(resources.gpus.qty, 4)
-
-    def test_some_resources_specified(self):
-        resources = Resources(cpus=0, disk=1)
-        self.assertEqual(resources.cpus.qty, 0)
-        self.assertEqual(resources.ram.qty,
-                         configuration.conf.getint('operators', 'default_ram'))
-        self.assertEqual(resources.disk.qty, 1)
-        self.assertEqual(resources.gpus.qty,
-                         configuration.conf.getint('operators', 'default_gpus'))
-
-    def test_no_resources_specified(self):
-        resources = Resources()
-        self.assertEqual(resources.cpus.qty,
-                         configuration.conf.getint('operators', 'default_cpus'))
-        self.assertEqual(resources.ram.qty,
-                         configuration.conf.getint('operators', 'default_ram'))
-        self.assertEqual(resources.disk.qty,
-                         configuration.conf.getint('operators', 'default_disk'))
-        self.assertEqual(resources.gpus.qty,
-                         configuration.conf.getint('operators', 'default_gpus'))
-
-    def test_negative_resource_qty(self):
-        with self.assertRaises(AirflowException):
-            Resources(cpus=-1)

From 641eba0c695629f4a27af90ef0436f9c15a715f2 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Tue, 8 Jan 2019 00:23:32 -0800
Subject: [PATCH 692/808] [AIRFLOW-3650] Skip running on mysql for the flaky
 test (#4457)

---
 tests/www_rbac/test_views.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index c7cec424e57e5..809193cdeb91a 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -1571,6 +1571,8 @@ def test_trigger_dag_button_normal_exist(self):
         self.assertIn('/trigger?dag_id=example_bash_operator', resp.data.decode('utf-8'))
         self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
 
+    @unittest.skipIf('mysql' in conf.conf.get('core', 'sql_alchemy_conn'),
+                     "flaky when run on mysql")
     def test_trigger_dag_button(self):
 
         test_dag_id = "example_bash_operator"

From 895d355f4f3cec10c7657d5f445e558bcf58b329 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 25 Mar 2019 15:48:28 +0000
Subject: [PATCH 693/808] [AIRFLOW-XXX] Version 1.10.3b1

Changelog will follow.
---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index e7deef18768cf..0fd74fd4456b8 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.2'
+version = '1.10.3b1'

From 2d9b0fb21faeb984be221a5cdd8cf68b41755981 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 26 Mar 2019 13:25:59 +0000
Subject: [PATCH 694/808] [AIRFLOW-XXX] Add missing docstring for 'autodetect'
 in GCS to BQ Operator (#4979)

---
 airflow/contrib/operators/gcs_to_bq.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 24b2f02eec0ad..540d5653bc412 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -120,6 +120,9 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         time_partitioning. The order of columns given determines the sort order.
         Not applicable for external tables.
     :type cluster_fields: list of str
+    :param autodetect: [Optional] Indicates if we should automatically infer the
+        options and schema for CSV and JSON sources. (Default: ``False``)
+    :type autodetect: bool
     """
     template_fields = ('bucket', 'source_objects',
                        'schema_object', 'destination_project_dataset_table')

From 057ccf11a7502023acf30a764005e9536534502e Mon Sep 17 00:00:00 2001
From: dbatten5 <db@mettrr.com>
Date: Tue, 26 Mar 2019 10:19:15 +0000
Subject: [PATCH 695/808] [AIRFLOW-XXX] Update plugin macros documentation
 (#4971)

Make readers aware of how to access a custom plugin macro in their
templates
---
 docs/plugins.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/plugins.rst b/docs/plugins.rst
index a11f5c3dad5d8..227332f8d30e3 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -160,6 +160,7 @@ definitions in Airflow.
         pass
 
     # Will show up under airflow.macros.test_plugin.plugin_macro
+    # and in templates through {{ macros.test_plugin.plugin_macro }}
     def plugin_macro():
         pass
 

From 4ee7ecf6187d93a976a6ccd3a9521970ed838c91 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 26 Mar 2019 18:16:34 +0800
Subject: [PATCH 696/808] [AIRFLOW-4154] Correct string formatting in jobs.py
 (#4972)

---
 airflow/jobs.py | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 8ad240b14a884..e01979073033f 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -290,7 +290,7 @@ def query(result, items):
                                              self.max_tis_per_query)
 
         task_instance_str = '\n\t'.join(
-            ["{}".format(x) for x in reset_tis])
+            [repr(x) for x in reset_tis])
         session.commit()
 
         self.log.info(
@@ -1097,7 +1097,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
 
         # Put one task instance on each line
         task_instance_str = "\n\t".join(
-            ["{}".format(x) for x in task_instances_to_examine])
+            [repr(x) for x in task_instances_to_examine])
         self.log.info(
             "%s tasks up for execution:\n\t%s", len(task_instances_to_examine),
             task_instance_str
@@ -1215,7 +1215,7 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
                         num_starving_tasks)
 
         task_instance_str = "\n\t".join(
-            ["{}".format(x) for x in executable_tis])
+            [repr(x) for x in executable_tis])
         self.log.info(
             "Setting the follow tasks to queued state:\n\t%s", task_instance_str)
         # so these dont expire on commit
@@ -1288,7 +1288,7 @@ def _change_state_for_executable_task_instances(self, task_instances,
                                  tis_to_set_to_queued]
 
         task_instance_str = "\n\t".join(
-            ["{}".format(x) for x in tis_to_set_to_queued])
+            [repr(x) for x in tis_to_set_to_queued])
 
         session.commit()
         self.log.info("Setting the following %s tasks to queued state:\n\t%s",
@@ -1409,11 +1409,10 @@ def _change_state_for_tasks_failed_to_execute(self, session):
                 task_instance.state = State.SCHEDULED
 
             task_instance_str = "\n\t".join(
-                ["{}".format(x) for x in tis_to_set_to_scheduled])
+                [repr(x) for x in tis_to_set_to_scheduled])
 
             session.commit()
-            self.log.info("Set the follow tasks to scheduled state:\n\t{}"
-                          .format(task_instance_str))
+            self.log.info("Set the following tasks to scheduled state:\n\t%s", task_instance_str)
 
     def _process_dags(self, dagbag, dags, tis_out):
         """

From ae1faf5888822bc33d5809bccad7b6cdc39e56c3 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Thu, 14 Mar 2019 11:13:44 +0100
Subject: [PATCH 697/808] [AIRFLOW-3939] Add Google Cloud Translate operator
 (#4755)

---
 .../example_dags/example_gcp_translate.py     |  52 ++++++++
 airflow/contrib/hooks/gcp_translate_hook.py   |  97 +++++++++++++++
 .../operators/gcp_translate_operator.py       | 113 ++++++++++++++++++
 docs/code.rst                                 |   2 +
 docs/howto/operator/gcp/translate.rst         |  68 +++++++++++
 docs/integration.rst                          |  10 ++
 setup.py                                      |   1 +
 .../contrib/hooks/test_gcp_translate_hook.py  |  78 ++++++++++++
 .../operators/test_gcp_translate_operator.py  |  75 ++++++++++++
 .../test_gcp_translate_operator_system.py     |  34 ++++++
 tests/contrib/utils/gcp_authenticator.py      |  67 ++++++-----
 11 files changed, 567 insertions(+), 30 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_translate.py
 create mode 100644 airflow/contrib/hooks/gcp_translate_hook.py
 create mode 100644 airflow/contrib/operators/gcp_translate_operator.py
 create mode 100644 docs/howto/operator/gcp/translate.rst
 create mode 100644 tests/contrib/hooks/test_gcp_translate_hook.py
 create mode 100644 tests/contrib/operators/test_gcp_translate_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_translate_operator_system.py

diff --git a/airflow/contrib/example_dags/example_gcp_translate.py b/airflow/contrib/example_dags/example_gcp_translate.py
new file mode 100644
index 0000000000000..bc7030cf1a084
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_translate.py
@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that translates text in Google Cloud Translate
+service in the Google Cloud Platform.
+
+"""
+import airflow
+from airflow import models
+
+from airflow.contrib.operators.gcp_translate_operator import CloudTranslateTextOperator
+from airflow.operators.bash_operator import BashOperator
+
+default_args = {'start_date': airflow.utils.dates.days_ago(1)}
+
+with models.DAG(
+    'example_gcp_translate', default_args=default_args, schedule_interval=None  # Override to match your needs
+) as dag:
+    # [START howto_operator_translate_text]
+    product_set_create = CloudTranslateTextOperator(
+        task_id='translate',
+        values=['zażółć gęślą jaźń'],
+        target_language='en',
+        format_='text',
+        source_language=None,
+        model='base',
+    )
+    # [END howto_operator_translate_text]
+    # [START howto_operator_translate_access]
+    translation_access = BashOperator(
+        task_id='access',
+        bash_command="echo '{{ task_instance.xcom_pull(\"translate\")[0] }}'"
+    )
+    product_set_create >> translation_access
+    # [END howto_operator_translate_access]
diff --git a/airflow/contrib/hooks/gcp_translate_hook.py b/airflow/contrib/hooks/gcp_translate_hook.py
new file mode 100644
index 0000000000000..2d4adbb5b2b03
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_translate_hook.py
@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from google.cloud.translate_v2 import Client
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+
+class CloudTranslateHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud translate APIs.
+    """
+
+    _client = None
+
+    def __init__(self, gcp_conn_id='google_cloud_default'):
+        super(CloudTranslateHook, self).__init__(gcp_conn_id)
+
+    def get_conn(self):
+        """
+        Retrieves connection to Cloud Translate
+
+        :return: Google Cloud Translate client object.
+        :rtype: Client
+        """
+        if not self._client:
+            self._client = Client(credentials=self._get_credentials())
+        return self._client
+
+    def translate(
+        self, values, target_language, format_=None, source_language=None, model=None
+    ):
+        """Translate a string or list of strings.
+
+        See https://cloud.google.com/translate/docs/translating-text
+
+        :type values: str or list
+        :param values: String or list of strings to translate.
+
+        :type target_language: str
+        :param target_language: The language to translate results into. This
+                                is required by the API and defaults to
+                                the target language of the current instance.
+
+        :type format_: str
+        :param format_: (Optional) One of ``text`` or ``html``, to specify
+                        if the input text is plain text or HTML.
+
+        :type source_language: str or None
+        :param source_language: (Optional) The language of the text to
+                                be translated.
+
+        :type model: str or None
+        :param model: (Optional) The model used to translate the text, such
+                      as ``'base'`` or ``'nmt'``.
+
+        :rtype: str or list
+        :returns: A list of dictionaries for each queried value. Each
+                  dictionary typically contains three keys (though not
+                  all will be present in all cases)
+
+                  * ``detectedSourceLanguage``: The detected language (as an
+                    ISO 639-1 language code) of the text.
+                  * ``translatedText``: The translation of the text into the
+                    target language.
+                  * ``input``: The corresponding input value.
+                  * ``model``: The model used to translate the text.
+
+                  If only a single value is passed, then only a single
+                  dictionary will be returned.
+        :raises: :class:`~exceptions.ValueError` if the number of
+                 values and translations differ.
+        """
+        client = self.get_conn()
+
+        return client.translate(
+            values=values,
+            target_language=target_language,
+            format_=format_,
+            source_language=source_language,
+            model=model,
+        )
diff --git a/airflow/contrib/operators/gcp_translate_operator.py b/airflow/contrib/operators/gcp_translate_operator.py
new file mode 100644
index 0000000000000..87d4aa4cfdb5c
--- /dev/null
+++ b/airflow/contrib/operators/gcp_translate_operator.py
@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_translate_hook import CloudTranslateHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class CloudTranslateTextOperator(BaseOperator):
+    """
+    Translate a string or list of strings.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudTranslateTextOperator`
+
+    See https://cloud.google.com/translate/docs/translating-text
+
+    Execute method returns str or list.
+
+    This is a list of dictionaries for each queried value. Each
+    dictionary typically contains three keys (though not
+    all will be present in all cases).
+
+    * ``detectedSourceLanguage``: The detected language (as an
+      ISO 639-1 language code) of the text.
+    * ``translatedText``: The translation of the text into the
+      target language.
+    * ``input``: The corresponding input value.
+    * ``model``: The model used to translate the text.
+
+    If only a single value is passed, then only a single
+    dictionary is set as XCom return value.
+
+    :type values: str or list
+    :param values: String or list of strings to translate.
+
+    :type target_language: str
+    :param target_language: The language to translate results into. This
+      is required by the API and defaults to
+      the target language of the current instance.
+
+    :type format_: str or None
+    :param format_: (Optional) One of ``text`` or ``html``, to specify
+      if the input text is plain text or HTML.
+
+    :type source_language: str or None
+    :param source_language: (Optional) The language of the text to
+      be translated.
+
+    :type model: str or None
+    :param model: (Optional) The model used to translate the text, such
+      as ``'base'`` or ``'nmt'``.
+
+    """
+
+    # [START translate_template_fields]
+    template_fields = ('values', 'target_language', 'format_', 'source_language', 'model', 'gcp_conn_id')
+    # [END translate_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        values,
+        target_language,
+        format_,
+        source_language,
+        model,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudTranslateTextOperator, self).__init__(*args, **kwargs)
+        self.values = values
+        self.target_language = target_language
+        self.format_ = format_
+        self.source_language = source_language
+        self.model = model
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        _hook = CloudTranslateHook(gcp_conn_id=self.gcp_conn_id)
+        try:
+            translation = _hook.translate(
+                values=self.values,
+                target_language=self.target_language,
+                format_=self.format_,
+                source_language=self.source_language,
+                model=self.model,
+            )
+            self.log.debug("Translation %s", translation)
+            return translation
+        except ValueError as e:
+            self.log.error('An error has been thrown from translate method:')
+            self.log.error(e)
+            raise AirflowException(e)
diff --git a/docs/code.rst b/docs/code.rst
index 1f5ef652341be..0f1968c09d562 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -208,6 +208,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
+.. autoclass:: airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
@@ -507,6 +508,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
 .. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
 .. autoclass:: airflow.contrib.hooks.gcp_kms_hook.GoogleCloudKMSHook
+.. autoclass:: airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
 .. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
diff --git a/docs/howto/operator/gcp/translate.rst b/docs/howto/operator/gcp/translate.rst
new file mode 100644
index 0000000000000..8418b1341e95f
--- /dev/null
+++ b/docs/howto/operator/gcp/translate.rst
@@ -0,0 +1,68 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Translate Operators
+--------------------------------
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:CloudTranslateTextOperator:
+
+CloudTranslateTextOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Translate a string or list of strings.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator`
+
+Using the operator
+""""""""""""""""""
+
+Basic usage of the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_translate_text]
+      :end-before: [END howto_operator_translate_text]
+
+The result of translation is available as dictionary or array of dictionaries accessible via the usual
+XCom mechanisms of Airflow:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_translate_access]
+      :end-before: [END howto_operator_translate_access]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_translate_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START translate_template_fields]
+    :end-before: [END translate_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Translate documentation <https://cloud.google.com/translate/docs/translating-text>`_.
diff --git a/docs/integration.rst b/docs/integration.rst
index 0a55fa506f684..443ddfb5062e6 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1483,6 +1483,16 @@ Cloud Vision Product Search Operators
 
 They also use :class:`airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook` to communicate with Google Cloud Platform.
 
+Cloud Translate
+'''''''''''''''
+
+Cloud Translate Text Operators
+""""""""""""""""""""""""""""""
+
+:class:`airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator`
+    Translate a string or list of strings.
+
+
 Google Kubernetes Engine
 ''''''''''''''''''''''''
 
diff --git a/setup.py b/setup.py
index 5c68fe844cee9..8302153863e37 100644
--- a/setup.py
+++ b/setup.py
@@ -179,6 +179,7 @@ def write_version(filename=os.path.join(*['airflow',
     'google-cloud-container>=0.1.1',
     'google-cloud-bigtable==0.31.0',
     'google-cloud-spanner>=1.7.1',
+    'google-cloud-translate>=1.3.3',
     'google-cloud-vision>=0.35.2',
     'grpcio-gcp>=0.2.2',
     'PyOpenSSL',
diff --git a/tests/contrib/hooks/test_gcp_translate_hook.py b/tests/contrib/hooks/test_gcp_translate_hook.py
new file mode 100644
index 0000000000000..d6c392020a0a8
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_translate_hook.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.hooks.gcp_translate_hook import CloudTranslateHook
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+PROJECT_ID_TEST = 'project-id'
+
+
+class TestCloudTranslateHook(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(
+            'airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook.__init__',
+            new=mock_base_gcp_hook_default_project_id,
+        ):
+            self.hook = CloudTranslateHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook.get_conn')
+    def test_translate_called(self, get_conn):
+        # Given
+        translate_method = get_conn.return_value.translate
+        translate_method.return_value = {
+            'translatedText': 'Yellowing self Gęśle',
+            'detectedSourceLanguage': 'pl',
+            'model': 'base',
+            'input': 'zażółć gęślą jaźń',
+        }
+        # When
+        result = self.hook.translate(
+            values=['zażółć gęślą jaźń'],
+            target_language='en',
+            format_='text',
+            source_language=None,
+            model='base',
+        )
+        # Then
+        self.assertEqual(
+            result,
+            {
+                'translatedText': 'Yellowing self Gęśle',
+                'detectedSourceLanguage': 'pl',
+                'model': 'base',
+                'input': 'zażółć gęślą jaźń',
+            },
+        )
+        translate_method.assert_called_once_with(
+            values=['zażółć gęślą jaźń'],
+            target_language='en',
+            format_='text',
+            source_language=None,
+            model='base',
+        )
diff --git a/tests/contrib/operators/test_gcp_translate_operator.py b/tests/contrib/operators/test_gcp_translate_operator.py
new file mode 100644
index 0000000000000..023ad0595577c
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_translate_operator.py
@@ -0,0 +1,75 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from airflow.contrib.operators.gcp_translate_operator import CloudTranslateTextOperator
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+GCP_CONN_ID = 'google_cloud_default'
+
+
+class CloudTranslateTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_translate_operator.CloudTranslateHook')
+    def test_minimal_green_path(self, mock_hook):
+        mock_hook.return_value.translate.return_value = [
+            {
+                'translatedText': 'Yellowing self Gęśle',
+                'detectedSourceLanguage': 'pl',
+                'model': 'base',
+                'input': 'zażółć gęślą jaźń',
+            }
+        ]
+        op = CloudTranslateTextOperator(
+            values=['zażółć gęślą jaźń'],
+            target_language='en',
+            format_='text',
+            source_language=None,
+            model='base',
+            gcp_conn_id=GCP_CONN_ID,
+            task_id='id',
+        )
+        return_value = op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.translate.assert_called_once_with(
+            values=['zażółć gęślą jaźń'],
+            target_language='en',
+            format_='text',
+            source_language=None,
+            model='base',
+        )
+        self.assertEqual(
+            [
+                {
+                    'translatedText': 'Yellowing self Gęśle',
+                    'detectedSourceLanguage': 'pl',
+                    'model': 'base',
+                    'input': 'zażółć gęślą jaźń',
+                }
+            ],
+            return_value,
+        )
diff --git a/tests/contrib/operators/test_gcp_translate_operator_system.py b/tests/contrib/operators/test_gcp_translate_operator_system.py
new file mode 100644
index 0000000000000..70e774230b05c
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_translate_operator_system.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import DagGcpSystemTestCase, SKIP_TEST_WARNING
+from tests.contrib.utils.gcp_authenticator import GCP_AI_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_AI_KEY), SKIP_TEST_WARNING)
+class CloudTranslateExampleDagsSystemTest(DagGcpSystemTestCase):
+    def __init__(self, method_name='runTest'):
+        super(CloudTranslateExampleDagsSystemTest, self).__init__(
+            method_name, dag_id='example_gcp_translate', gcp_key=GCP_AI_KEY
+        )
+
+    def test_run_example_dag_function(self):
+        self._run_dag()
diff --git a/tests/contrib/utils/gcp_authenticator.py b/tests/contrib/utils/gcp_authenticator.py
index b361fcdeb18c6..8cf209cd027e1 100644
--- a/tests/contrib/utils/gcp_authenticator.py
+++ b/tests/contrib/utils/gcp_authenticator.py
@@ -38,9 +38,9 @@
 SCOPE_EXTRA = 'extra__google_cloud_platform__scope'
 PROJECT_EXTRA = 'extra__google_cloud_platform__project'
 
-AIRFLOW_MAIN_FOLDER = os.path.realpath(os.path.join(
-    os.path.dirname(os.path.realpath(__file__)),
-    os.pardir, os.pardir, os.pardir))
+AIRFLOW_MAIN_FOLDER = os.path.realpath(
+    os.path.join(os.path.dirname(os.path.realpath(__file__)), os.pardir, os.pardir, os.pardir)
+)
 
 
 class GcpAuthenticator(LoggingCommandExecutor):
@@ -48,6 +48,7 @@ class GcpAuthenticator(LoggingCommandExecutor):
     Manages authentication to Google Cloud Platform. It helps to manage
     connection - it can authenticate with the gcp key name specified
     """
+
     original_account = None
 
     def __init__(self, gcp_key, project_extra=None):
@@ -77,15 +78,13 @@ def set_key_path_in_airflow_connection(self):
         """
         session = settings.Session()
         try:
-            conn = session.query(Connection).filter(
-                Connection.conn_id == 'google_cloud_default')[0]
+            conn = session.query(Connection).filter(Connection.conn_id == 'google_cloud_default')[0]
             extras = conn.extra_dejson
             extras[KEYPATH_EXTRA] = self.full_key_path
             if extras.get(KEYFILE_DICT_EXTRA):
                 del extras[KEYFILE_DICT_EXTRA]
             extras[SCOPE_EXTRA] = 'https://www.googleapis.com/auth/cloud-platform'
-            extras[PROJECT_EXTRA] = self.project_extra if self.project_extra else \
-                self.project_id
+            extras[PROJECT_EXTRA] = self.project_extra if self.project_extra else self.project_id
             conn.extra = json.dumps(extras)
             session.commit()
         except BaseException as ex:
@@ -103,8 +102,7 @@ def set_dictionary_in_airflow_connection(self):
         """
         session = settings.Session()
         try:
-            conn = session.query(Connection).filter(
-                Connection.conn_id == 'google_cloud_default')[0]
+            conn = session.query(Connection).filter(Connection.conn_id == 'google_cloud_default')[0]
             extras = conn.extra_dejson
             with open(self.full_key_path, "r") as path_file:
                 content = json.load(path_file)
@@ -135,9 +133,7 @@ def _set_key_path(self):
         if "GCP_CONFIG_DIR" in os.environ:
             gcp_config_dir = os.environ["GCP_CONFIG_DIR"]
         else:
-            gcp_config_dir = os.path.join(AIRFLOW_MAIN_FOLDER,
-                                          os.pardir,
-                                          "config")
+            gcp_config_dir = os.path.join(AIRFLOW_MAIN_FOLDER, os.pardir, "config")
         if not os.path.isdir(gcp_config_dir):
             self.log.info("The {} is not a directory".format(gcp_config_dir))
         key_dir = os.path.join(gcp_config_dir, "keys")
@@ -154,8 +150,10 @@ def _validate_key_set(self):
             raise AirflowException("The gcp_key is not set!")
         if not os.path.isfile(self.full_key_path):
             raise AirflowException(
-                "The key {} could not be found. Please copy it to the {} path.".
-                format(self.gcp_key, self.full_key_path))
+                "The key {} could not be found. Please copy it to the {} path.".format(
+                    self.gcp_key, self.full_key_path
+                )
+            )
 
     def gcp_authenticate(self):
         """
@@ -165,9 +163,14 @@ def gcp_authenticate(self):
         self.log.info("Setting the GCP key to {}".format(self.full_key_path))
         # Checking if we can authenticate using service account credentials provided
         self.execute_cmd(
-            ['gcloud', 'auth', 'activate-service-account',
-             '--key-file={}'.format(self.full_key_path),
-             '--project={}'.format(self.project_id)])
+            [
+                'gcloud',
+                'auth',
+                'activate-service-account',
+                '--key-file={}'.format(self.full_key_path),
+                '--project={}'.format(self.project_id),
+            ]
+        )
         self.set_key_path_in_airflow_connection()
 
     def gcp_revoke_authentication(self):
@@ -176,11 +179,10 @@ def gcp_revoke_authentication(self):
         """
         self._validate_key_set()
         self.log.info("Revoking authentication - setting it to none")
+        self.execute_cmd(['gcloud', 'config', 'get-value', 'account', '--project={}'.format(self.project_id)])
         self.execute_cmd(
-            ['gcloud', 'config', 'get-value', 'account',
-             '--project={}'.format(self.project_id)])
-        self.execute_cmd(['gcloud', 'config', 'set', 'account', 'none',
-                          '--project={}'.format(self.project_id)])
+            ['gcloud', 'config', 'set', 'account', 'none', '--project={}'.format(self.project_id)]
+        )
 
     def gcp_store_authentication(self):
         """
@@ -190,10 +192,9 @@ def gcp_store_authentication(self):
         self._validate_key_set()
         if not GcpAuthenticator.original_account:
             GcpAuthenticator.original_account = self.check_output(
-                ['gcloud', 'config', 'get-value', 'account',
-                 '--project={}'.format(self.project_id)]).decode('utf-8')
-            self.log.info("Storing account: to restore it later {}".format(
-                GcpAuthenticator.original_account))
+                ['gcloud', 'config', 'get-value', 'account', '--project={}'.format(self.project_id)]
+            ).decode('utf-8')
+            self.log.info("Storing account: to restore it later {}".format(GcpAuthenticator.original_account))
 
     def gcp_restore_authentication(self):
         """
@@ -201,10 +202,16 @@ def gcp_restore_authentication(self):
         """
         self._validate_key_set()
         if GcpAuthenticator.original_account:
-            self.log.info("Restoring original account stored: {}".
-                          format(GcpAuthenticator.original_account))
-            subprocess.call(['gcloud', 'config', 'set', 'account',
-                             GcpAuthenticator.original_account,
-                             '--project={}'.format(self.project_id)])
+            self.log.info("Restoring original account stored: {}".format(GcpAuthenticator.original_account))
+            subprocess.call(
+                [
+                    'gcloud',
+                    'config',
+                    'set',
+                    'account',
+                    GcpAuthenticator.original_account,
+                    '--project={}'.format(self.project_id),
+                ]
+            )
         else:
             self.log.info("Not restoring the original GCP account: it is not set")

From cf7dc5ff19d431eed98a3659c6d06bcf3ac1eac0 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 25 Jan 2019 20:56:57 +0000
Subject: [PATCH 698/808] [AIRFLOW-XXX] Mock optional modules when building
 docs (#4586)

---
 docs/conf.py | 56 +++++++++++++++++++++++++++++++++++++++++-----------
 setup.py     |  1 -
 2 files changed, 44 insertions(+), 13 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 0a9d72d951a94..cf31d5e57ded5 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -33,28 +33,60 @@
 # serve to show the default.
 import os
 import sys
-import mock
 
 import airflow
 
-MOCK_MODULES = [
-    'google.auth.default',
-    'google.oauth2.service_account',
+autodoc_mock_imports = [
+    'MySQLdb',
+    'adal',
+    'analytics',
+    'azure',
+    'azure.cosmos',
+    'azure.datalake',
+    'azure.mgmt',
+    'boto3',
+    'botocore',
+    'bson',
+    'cassandra',
+    'celery',
+    'cloudant',
+    'cx_Oracle',
+    'datadog',
+    'docker',
+    'google',
     'google_auth_httplib2',
     'googleapiclient',
-    'googleapiclient.discovery',
-    'googleapiclient.errors',
-    'googleapiclient.http',
+    'hdfs',
+    'httplib2',
+    'jaydebeapi',
+    'jenkins',
+    'jira',
+    'kubernetes',
     'mesos',
-    'mesos.interface',
-    'mesos.native',
-    'pandas.io.gbq',
+    'msrestazure',
+    'pandas',
+    'pandas_gbq',
+    'paramiko',
+    'pinotdb',
+    'psycopg2',
+    'pydruid',
+    'pyhive',
+    'pyhive',
+    'pymongo',
     'pymssql',
+    'pysftp',
+    'qds_sdk',
+    'redis',
     'simple_salesforce',
+    'slackclient',
+    'smbclient',
+    'snowflake',
+    'sshtunnel',
+    'tenacity',
     'vertica_python',
+    'winrm',
+    'zdesk',
 ]
-for mod_name in MOCK_MODULES:
-    sys.modules[mod_name] = mock.Mock()
 
 # Hack to allow changing for piece of the code to behave differently while
 # the docs are being built. The main objective was to alter the
diff --git a/setup.py b/setup.py
index 8302153863e37..b4d20c6bbb9d1 100644
--- a/setup.py
+++ b/setup.py
@@ -157,7 +157,6 @@ def write_version(filename=os.path.join(*['airflow',
 databricks = ['requests>=2.20.0, <3']
 datadog = ['datadog>=0.14.0']
 doc = [
-    'mock',
     'sphinx>=1.2.3',
     'sphinx-argparse>=0.1.13',
     'sphinx-rtd-theme>=0.1.6',

From 6fb635eb6f0e92038693d4a07e1562b4c1464400 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 7 Aug 2018 15:15:15 +0100
Subject: [PATCH 699/808] [AIRFLOW-2864] Fix docstrings for SubDagOperator
 (#3712)

The docstrings are currently in the `__init__` method, due to which they are not automatically shown in the Sphinx documentation.
---
 airflow/operators/subdag_operator.py | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/airflow/operators/subdag_operator.py b/airflow/operators/subdag_operator.py
index 052095e2a618f..90f17fcf6aa10 100644
--- a/airflow/operators/subdag_operator.py
+++ b/airflow/operators/subdag_operator.py
@@ -25,6 +25,18 @@
 
 
 class SubDagOperator(BaseOperator):
+    """
+    This runs a sub dag. By convention, a sub dag's dag_id
+    should be prefixed by its parent and a dot. As in `parent.child`.
+
+    :param subdag: the DAG object to run as a subdag of the current DAG.
+    :type subdag: airflow.DAG.
+    :param dag: the parent DAG for the subdag.
+    :type dag: airflow.DAG.
+    :param executor: the executor for this subdag. Default to use SequentialExecutor.
+        Please find AIRFLOW-74 for more details.
+    :type executor: airflow.executors.
+    """
 
     template_fields = tuple()
     ui_color = '#555'
@@ -37,18 +49,6 @@ def __init__(
             subdag,
             executor=SequentialExecutor(),
             *args, **kwargs):
-        """
-        This runs a sub dag. By convention, a sub dag's dag_id
-        should be prefixed by its parent and a dot. As in `parent.child`.
-
-        :param subdag: the DAG object to run as a subdag of the current DAG.
-        :type subdag: airflow.DAG.
-        :param dag: the parent DAG for the subdag.
-        :type dag: airflow.DAG.
-        :param executor: the executor for this subdag. Default to use SequentialExecutor.
-                         Please find AIRFLOW-74 for more details.
-        :type executor: airflow.executors.
-        """
         import airflow.models
         dag = kwargs.get('dag') or airflow.models._CONTEXT_MANAGER_DAG
         if not dag:

From 51b8e93bac6628feccb85679237787e6baf95ca6 Mon Sep 17 00:00:00 2001
From: Brandon Kvarda <bjkvarda@gmail.com>
Date: Mon, 15 Oct 2018 03:21:15 -0700
Subject: [PATCH 700/808] [AIRFLOW-3155] Add ability to filter by a last
 modified time in GCS Operator (#4008)

* [AIRFLOW-3155] Add ability to filter by a last modified time in GoogleCloudStorageToGoogleCloudStorageOperator
---
 airflow/contrib/operators/gcs_to_gcs.py       |  21 ++++
 .../operators/test_gcs_to_gcs_operator.py     | 113 ++++++++++++++++++
 2 files changed, 134 insertions(+)

diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index ce0450807a6f7..f4f70aa50865a 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -62,6 +62,10 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
         For this to work, the service account making the request must have
         domain-wide delegation enabled.
     :type delegate_to: str
+    :param last_modified_time: When specified, if the object(s) were
+        modified after last_modified_time, they will be copied/moved.
+        If tzinfo has not been set, UTC will be assumed.
+    :type last_modified_time: datetime
 
     :Example:
 
@@ -119,6 +123,7 @@ def __init__(self,
                  move_object=False,
                  google_cloud_storage_conn_id='google_cloud_default',
                  delegate_to=None,
+                 last_modified_time=None,
                  *args,
                  **kwargs):
         super(GoogleCloudStorageToGoogleCloudStorageOperator,
@@ -130,6 +135,7 @@ def __init__(self,
         self.move_object = move_object
         self.google_cloud_storage_conn_id = google_cloud_storage_conn_id
         self.delegate_to = delegate_to
+        self.last_modified_time = last_modified_time
         self.wildcard = '*'
 
     def execute(self, context):
@@ -145,6 +151,13 @@ def execute(self, context):
             objects = hook.list(self.source_bucket, prefix=prefix, delimiter=delimiter)
 
             for source_object in objects:
+                if self.last_modified_time is not None:
+                    # Check to see if object was modified after last_modified_time
+                    if hook.is_updated_after(self.source_bucket, source_object,
+                                             self.last_modified_time):
+                        pass
+                    else:
+                        continue
                 if self.destination_object is None:
                     destination_object = source_object
                 else:
@@ -161,6 +174,14 @@ def execute(self, context):
                     hook.delete(self.source_bucket, source_object)
 
         else:
+            if self.last_modified_time is not None:
+                if hook.is_updated_after(self.source_bucket,
+                                         self.source_object,
+                                         self.last_modified_time):
+                    pass
+                else:
+                    return
+
             self.log.info(
                 log_message.format(self.source_bucket, self.source_object,
                                    self.destination_bucket or self.source_bucket,
diff --git a/tests/contrib/operators/test_gcs_to_gcs_operator.py b/tests/contrib/operators/test_gcs_to_gcs_operator.py
index 6b866d11e1796..dd16e2f2df87b 100644
--- a/tests/contrib/operators/test_gcs_to_gcs_operator.py
+++ b/tests/contrib/operators/test_gcs_to_gcs_operator.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import unittest
+from datetime import datetime
 
 from airflow.contrib.operators.gcs_to_gcs import \
     GoogleCloudStorageToGoogleCloudStorageOperator
@@ -38,6 +39,7 @@
 SOURCE_OBJECT_2 = 'test_object*'
 SOURCE_OBJECT_3 = 'test*object'
 SOURCE_OBJECT_4 = 'test_object*.txt'
+SOURCE_OBJECT_5 = 'test_object.txt'
 DESTINATION_BUCKET = 'archive'
 DESTINATION_OBJECT_PREFIX = 'foo/bar'
 SOURCE_FILES_LIST = [
@@ -45,6 +47,7 @@
     'test_object/file2.txt',
     'test_object/file3.json',
 ]
+MOD_TIME_1 = datetime(2016, 1, 1)
 
 
 class GoogleCloudStorageToCloudStorageOperatorTest(unittest.TestCase):
@@ -167,3 +170,113 @@ def test_execute_wildcard_empty_destination_object(self, mock_hook):
                       DESTINATION_BUCKET, '/file2.txt'),
         ]
         mock_hook.return_value.rewrite.assert_has_calls(mock_calls_empty)
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_execute_last_modified_time(self, mock_hook):
+        mock_hook.return_value.list.return_value = SOURCE_FILES_LIST
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_4,
+            destination_bucket=DESTINATION_BUCKET,
+            last_modified_time=None)
+
+        operator.execute(None)
+        mock_calls_none = [
+            mock.call(TEST_BUCKET, 'test_object/file1.txt',
+                      DESTINATION_BUCKET, 'test_object/file1.txt'),
+            mock.call(TEST_BUCKET, 'test_object/file2.txt',
+                      DESTINATION_BUCKET, 'test_object/file2.txt'),
+        ]
+        mock_hook.return_value.rewrite.assert_has_calls(mock_calls_none)
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_wc_with_last_modified_time_with_all_true_cond(self, mock_hook):
+        mock_hook.return_value.list.return_value = SOURCE_FILES_LIST
+        mock_hook.return_value.is_updated_after.side_effect = [True, True, True]
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_4,
+            destination_bucket=DESTINATION_BUCKET,
+            last_modified_time=MOD_TIME_1)
+
+        operator.execute(None)
+        mock_calls_none = [
+            mock.call(TEST_BUCKET, 'test_object/file1.txt',
+                      DESTINATION_BUCKET, 'test_object/file1.txt'),
+            mock.call(TEST_BUCKET, 'test_object/file2.txt',
+                      DESTINATION_BUCKET, 'test_object/file2.txt'),
+        ]
+        mock_hook.return_value.rewrite.assert_has_calls(mock_calls_none)
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_wc_with_last_modified_time_with_one_true_cond(self, mock_hook):
+        mock_hook.return_value.list.return_value = SOURCE_FILES_LIST
+        mock_hook.return_value.is_updated_after.side_effect = [True, False, False]
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_4,
+            destination_bucket=DESTINATION_BUCKET,
+            last_modified_time=MOD_TIME_1)
+
+        operator.execute(None)
+        mock_hook.return_value.rewrite.assert_called_once_with(
+            TEST_BUCKET, 'test_object/file1.txt',
+            DESTINATION_BUCKET, 'test_object/file1.txt')
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_wc_with_no_last_modified_time(self, mock_hook):
+        mock_hook.return_value.list.return_value = SOURCE_FILES_LIST
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_4,
+            destination_bucket=DESTINATION_BUCKET,
+            last_modified_time=None)
+
+        operator.execute(None)
+        mock_calls_none = [
+            mock.call(TEST_BUCKET, 'test_object/file1.txt',
+                      DESTINATION_BUCKET, 'test_object/file1.txt'),
+            mock.call(TEST_BUCKET, 'test_object/file2.txt',
+                      DESTINATION_BUCKET, 'test_object/file2.txt'),
+        ]
+        mock_hook.return_value.rewrite.assert_has_calls(mock_calls_none)
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_no_prefix_with_last_modified_time_with_true_cond(self, mock_hook):
+        mock_hook.return_value.is_updated_after.return_value = True
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_5,
+            destination_bucket=DESTINATION_BUCKET,
+            destination_object=SOURCE_OBJECT_5,
+            last_modified_time=MOD_TIME_1)
+
+        operator.execute(None)
+        mock_hook.return_value.rewrite.assert_called_once_with(
+            TEST_BUCKET, 'test_object.txt', DESTINATION_BUCKET, 'test_object.txt')
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_execute_no_prefix_with_no_last_modified_time(self, mock_hook):
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_5,
+            destination_bucket=DESTINATION_BUCKET,
+            destination_object=SOURCE_OBJECT_5,
+            last_modified_time=None)
+
+        operator.execute(None)
+        mock_hook.return_value.rewrite.assert_called_once_with(
+            TEST_BUCKET, 'test_object.txt', DESTINATION_BUCKET, 'test_object.txt')
+
+    @mock.patch('airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageHook')
+    def test_no_prefix_with_last_modified_time_with_false_cond(self, mock_hook):
+        mock_hook.return_value.is_updated_after.return_value = False
+        operator = GoogleCloudStorageToGoogleCloudStorageOperator(
+            task_id=TASK_ID, source_bucket=TEST_BUCKET,
+            source_object=SOURCE_OBJECT_5,
+            destination_bucket=DESTINATION_BUCKET,
+            destination_object=SOURCE_OBJECT_5,
+            last_modified_time=MOD_TIME_1)
+
+        operator.execute(None)
+        mock_hook.return_value.rewrite.assert_not_called()

From fa06466ffaaadbf43a46628734d9849d45650a66 Mon Sep 17 00:00:00 2001
From: Holden Karau <holden@pigscanfly.ca>
Date: Mon, 21 Jan 2019 06:45:35 -0800
Subject: [PATCH 701/808] [AIRFLOW-1191] Simplify override of spark submit
 command. (#4360)

Adds a spark_binary param to the spark submit operator to
allow folks to more easily configure the operator to use a
different binary, as is needed for some distros of the
Hadoop ecosystem which ship multiple version of Spark.
---
 airflow/contrib/hooks/spark_submit_hook.py            | 11 ++++++++---
 airflow/contrib/operators/spark_submit_operator.py    |  8 +++++++-
 tests/contrib/operators/test_spark_submit_operator.py |  9 +++++++--
 3 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index ee43652e92660..6215bb4750f8d 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -86,6 +86,9 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :type env_vars: dict
     :param verbose: Whether to pass the verbose flag to spark-submit process for debugging
     :type verbose: bool
+    :param spark_binary: The command to use for spark submit.
+                         Some distros may use spark2-submit.
+    :type spark_binary: string
     """
     def __init__(self,
                  conf=None,
@@ -109,7 +112,8 @@ def __init__(self,
                  num_executors=None,
                  application_args=None,
                  env_vars=None,
-                 verbose=False):
+                 verbose=False,
+                 spark_binary="spark-submit"):
         self._conf = conf
         self._conn_id = conn_id
         self._files = files
@@ -135,6 +139,7 @@ def __init__(self,
         self._submit_sp = None
         self._yarn_application_id = None
         self._kubernetes_driver_pod = None
+        self._spark_binary = spark_binary
 
         self._connection = self._resolve_connection()
         self._is_yarn = 'yarn' in self._connection['master']
@@ -164,7 +169,7 @@ def _resolve_connection(self):
                      'queue': None,
                      'deploy_mode': None,
                      'spark_home': None,
-                     'spark_binary': 'spark-submit',
+                     'spark_binary': self._spark_binary,
                      'namespace': 'default'}
 
         try:
@@ -181,7 +186,7 @@ def _resolve_connection(self):
             conn_data['queue'] = extra.get('queue', None)
             conn_data['deploy_mode'] = extra.get('deploy-mode', None)
             conn_data['spark_home'] = extra.get('spark-home', None)
-            conn_data['spark_binary'] = extra.get('spark-binary', 'spark-submit')
+            conn_data['spark_binary'] = extra.get('spark-binary', "spark-submit")
             conn_data['namespace'] = extra.get('namespace', 'default')
         except AirflowException:
             self.log.debug(
diff --git a/airflow/contrib/operators/spark_submit_operator.py b/airflow/contrib/operators/spark_submit_operator.py
index f8ebe77171ad8..93dc08f1f77e0 100644
--- a/airflow/contrib/operators/spark_submit_operator.py
+++ b/airflow/contrib/operators/spark_submit_operator.py
@@ -80,6 +80,9 @@ class SparkSubmitOperator(BaseOperator):
     :type env_vars: dict
     :param verbose: Whether to pass the verbose flag to spark-submit process for debugging
     :type verbose: bool
+    :param spark_binary: The command to use for spark submit.
+                         Some distros may use spark2-submit.
+    :type spark_binary: string
     """
     template_fields = ('_application', '_conf', '_files', '_py_files', '_jars', '_driver_classpath',
                        '_packages', '_exclude_packages', '_keytab', '_principal', '_name',
@@ -111,6 +114,7 @@ def __init__(self,
                  application_args=None,
                  env_vars=None,
                  verbose=False,
+                 spark_binary="spark-submit",
                  *args,
                  **kwargs):
         super(SparkSubmitOperator, self).__init__(*args, **kwargs)
@@ -136,6 +140,7 @@ def __init__(self,
         self._application_args = application_args
         self._env_vars = env_vars
         self._verbose = verbose
+        self._spark_binary = spark_binary
         self._hook = None
         self._conn_id = conn_id
 
@@ -165,7 +170,8 @@ def execute(self, context):
             num_executors=self._num_executors,
             application_args=self._application_args,
             env_vars=self._env_vars,
-            verbose=self._verbose
+            verbose=self._verbose,
+            spark_binary=self._spark_binary
         )
         self._hook.submit(self._application)
 
diff --git a/tests/contrib/operators/test_spark_submit_operator.py b/tests/contrib/operators/test_spark_submit_operator.py
index 99d8d84c3f306..b865fda930108 100644
--- a/tests/contrib/operators/test_spark_submit_operator.py
+++ b/tests/contrib/operators/test_spark_submit_operator.py
@@ -28,6 +28,7 @@
 
 from datetime import timedelta
 
+
 DEFAULT_DATE = timezone.datetime(2017, 1, 1)
 
 
@@ -74,15 +75,17 @@ def setUp(self):
         self.dag = DAG('test_dag_id', default_args=args)
 
     def test_execute(self):
+
         # Given / When
         conn_id = 'spark_default'
         operator = SparkSubmitOperator(
             task_id='spark_submit_job',
+            spark_binary="sparky",
             dag=self.dag,
             **self._config
         )
 
-        # Then
+        # Then expected results
         expected_dict = {
             'conf': {
                 'parquet.compression': 'SNAPPY'
@@ -112,7 +115,8 @@ def test_execute(self):
                 '--start', '{{ macros.ds_add(ds, -1)}}',
                 '--end', '{{ ds }}',
                 '--with-spaces', 'args should keep embdedded spaces',
-            ]
+            ],
+            "spark_binary": "sparky"
         }
 
         self.assertEqual(conn_id, operator._conn_id)
@@ -138,6 +142,7 @@ def test_execute(self):
         self.assertEqual(expected_dict['java_class'], operator._java_class)
         self.assertEqual(expected_dict['driver_memory'], operator._driver_memory)
         self.assertEqual(expected_dict['application_args'], operator._application_args)
+        self.assertEqual(expected_dict['spark_binary'], operator._spark_binary)
 
     def test_render_template(self):
         # Given

From 9dcf1f6c973b47d014140dee0e74fc177143313d Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Wed, 16 Jan 2019 19:27:07 -0500
Subject: [PATCH 702/808] [AIRFLOW-3559] Add missing options to DatadogHook.
 (#4362)

---
 airflow/contrib/hooks/datadog_hook.py    |  52 ++++++---
 tests/contrib/hooks/test_datadog_hook.py | 142 +++++++++++++++++++++++
 2 files changed, 176 insertions(+), 18 deletions(-)
 create mode 100644 tests/contrib/hooks/test_datadog_hook.py

diff --git a/airflow/contrib/hooks/datadog_hook.py b/airflow/contrib/hooks/datadog_hook.py
index f00e49b097ffe..45aa09a094a5f 100644
--- a/airflow/contrib/hooks/datadog_hook.py
+++ b/airflow/contrib/hooks/datadog_hook.py
@@ -50,23 +50,16 @@ def __init__(self, datadog_conn_id='datadog_default'):
         if self.api_key is None:
             raise AirflowException("api_key must be specified in the "
                                    "Datadog connection details")
-        if self.app_key is None:
-            raise AirflowException("app_key must be specified in the "
-                                   "Datadog connection details")
 
         self.log.info("Setting up api keys for Datadog")
-        options = {
-            'api_key': self.api_key,
-            'app_key': self.app_key
-        }
-        initialize(**options)
+        initialize(api_key=self.api_key, app_key=self.app_key)
 
     def validate_response(self, response):
         if response['status'] != 'ok':
             self.log.error("Datadog returned: %s", response)
             raise AirflowException("Error status received from Datadog")
 
-    def send_metric(self, metric_name, datapoint, tags=None):
+    def send_metric(self, metric_name, datapoint, tags=None, type_=None, interval=None):
         """
         Sends a single datapoint metric to DataDog
 
@@ -76,12 +69,18 @@ def send_metric(self, metric_name, datapoint, tags=None):
         :type datapoint: int or float
         :param tags: A list of tags associated with the metric
         :type tags: list
+        :param type_: Type of your metric: gauge, rate, or count
+        :type type_: str
+        :param interval: If the type of the metric is rate or count, define the corresponding interval
+        :type interval: int
         """
         response = api.Metric.send(
             metric=metric_name,
             points=datapoint,
             host=self.host,
-            tags=tags)
+            tags=tags,
+            type=type_,
+            interval=interval)
 
         self.validate_response(response)
         return response
@@ -111,7 +110,8 @@ def query_metric(self,
         self.validate_response(response)
         return response
 
-    def post_event(self, title, text, tags=None, alert_type=None, aggregation_key=None):
+    def post_event(self, title, text, aggregation_key=None, alert_type=None, date_happened=None,
+                   handle=None, priority=None, related_event_id=None, tags=None, device_name=None):
         """
         Posts an event to datadog (processing finished, potentially alerts, other issues)
         Think about this as a means to maintain persistence of alerts, rather than
@@ -121,21 +121,37 @@ def post_event(self, title, text, tags=None, alert_type=None, aggregation_key=No
         :type title: str
         :param text: The body of the event (more information)
         :type text: str
-        :param tags: List of string tags to apply to the event
-        :type tags: list
+        :param aggregation_key: Key that can be used to aggregate this event in a stream
+        :type aggregation_key: str
         :param alert_type: The alert type for the event, one of
             ["error", "warning", "info", "success"]
         :type alert_type: str
-        :param aggregation_key: Key that can be used to aggregate this event in a stream
-        :type aggregation_key: str
+        :param date_happened: POSIX timestamp of the event; defaults to now
+        :type date_happened: int
+        :handle: User to post the event as; defaults to owner of the application key used
+            to submit.
+        :param handle: str
+        :param priority: Priority to post the event as. ("normal" or "low", defaults to "normal")
+        :type priority: str
+        :param related_event_id: Post event as a child of the given event
+        :type related_event_id: id
+        :param tags: List of string tags to apply to the event
+        :type tags: list
+        :param device_name: device_name to post the event with
+        :type device_name: list
         """
         response = api.Event.create(
             title=title,
             text=text,
-            host=self.host,
-            tags=tags,
-            alert_type=alert_type,
             aggregation_key=aggregation_key,
+            alert_type=alert_type,
+            date_happened=date_happened,
+            handle=handle,
+            priority=priority,
+            related_event_id=related_event_id,
+            tags=tags,
+            host=self.host,
+            device_name=device_name,
             source_type_name=self.source_type_name)
 
         self.validate_response(response)
diff --git a/tests/contrib/hooks/test_datadog_hook.py b/tests/contrib/hooks/test_datadog_hook.py
new file mode 100644
index 0000000000000..09e19d700d862
--- /dev/null
+++ b/tests/contrib/hooks/test_datadog_hook.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import json
+import mock
+import unittest
+
+from airflow.exceptions import AirflowException
+from airflow.models.connection import Connection
+
+from airflow.contrib.hooks.datadog_hook import DatadogHook
+
+
+APP_KEY = 'app_key'
+API_KEY = 'api_key'
+METRIC_NAME = 'metric'
+DATAPOINT = 7
+TAGS = ['tag']
+TYPE = 'rate'
+INTERVAL = 30
+TITLE = 'title'
+TEXT = 'text'
+AGGREGATION_KEY = 'aggregation-key'
+ALERT_TYPE = 'warning'
+DATE_HAPPENED = 12345
+HANDLE = 'handle'
+PRIORITY = 'normal'
+RELATED_EVENT_ID = 7
+DEVICE_NAME = 'device-name'
+
+
+class TestDatadogHook(unittest.TestCase):
+
+    @mock.patch('airflow.contrib.hooks.datadog_hook.initialize')
+    @mock.patch('airflow.contrib.hooks.datadog_hook.DatadogHook.get_connection')
+    def setUp(self, mock_get_connection, mock_initialize):
+        mock_get_connection.return_value = Connection(extra=json.dumps({
+            'app_key': APP_KEY,
+            'api_key': API_KEY,
+        }))
+        self.hook = DatadogHook()
+
+    @mock.patch('airflow.contrib.hooks.datadog_hook.initialize')
+    @mock.patch('airflow.contrib.hooks.datadog_hook.DatadogHook.get_connection')
+    def test_api_key_required(self, mock_get_connection, mock_initialize):
+        mock_get_connection.return_value = Connection()
+        with self.assertRaises(AirflowException) as ctx:
+            DatadogHook()
+        self.assertEqual(str(ctx.exception),
+                         'api_key must be specified in the Datadog connection details')
+
+    def test_validate_response_valid(self):
+        try:
+            self.hook.validate_response({'status': 'ok'})
+        except AirflowException:
+            self.fail('Unexpected AirflowException raised')
+
+    def test_validate_response_invalid(self):
+        with self.assertRaises(AirflowException):
+            self.hook.validate_response({'status': 'error'})
+
+    @mock.patch('airflow.contrib.hooks.datadog_hook.api.Metric.send')
+    def test_send_metric(self, mock_send):
+        mock_send.return_value = {'status': 'ok'}
+        self.hook.send_metric(
+            METRIC_NAME,
+            DATAPOINT,
+            tags=TAGS,
+            type_=TYPE,
+            interval=INTERVAL,
+        )
+        mock_send.assert_called_with(
+            metric=METRIC_NAME,
+            points=DATAPOINT,
+            host=self.hook.host,
+            tags=TAGS,
+            type=TYPE,
+            interval=INTERVAL,
+        )
+
+    @mock.patch('airflow.contrib.hooks.datadog_hook.api.Metric.query')
+    @mock.patch('airflow.contrib.hooks.datadog_hook.time.time')
+    def test_query_metric(self, mock_time, mock_query):
+        now = 12345
+        mock_time.return_value = now
+        mock_query.return_value = {'status': 'ok'}
+        self.hook.query_metric('query', 60, 30)
+        mock_query.assert_called_with(
+            start=now - 60,
+            end=now - 30,
+            query='query',
+        )
+
+    @mock.patch('airflow.contrib.hooks.datadog_hook.api.Event.create')
+    def test_post_event(self, mock_create):
+        mock_create.return_value = {'status': 'ok'}
+        self.hook.post_event(
+            TITLE,
+            TEXT,
+            aggregation_key=AGGREGATION_KEY,
+            alert_type=ALERT_TYPE,
+            date_happened=DATE_HAPPENED,
+            handle=HANDLE,
+            priority=PRIORITY,
+            related_event_id=RELATED_EVENT_ID,
+            tags=TAGS,
+            device_name=DEVICE_NAME,
+        )
+        mock_create.assert_called_with(
+            title=TITLE,
+            text=TEXT,
+            aggregation_key=AGGREGATION_KEY,
+            alert_type=ALERT_TYPE,
+            date_happened=DATE_HAPPENED,
+            handle=HANDLE,
+            priority=PRIORITY,
+            related_event_id=RELATED_EVENT_ID,
+            tags=TAGS,
+            host=self.hook.host,
+            device_name=DEVICE_NAME,
+            source_type_name=self.hook.source_type_name,
+        )
+
+
+if __name__ == '__main__':
+    unittest.main()

From 5150e24ddaf2baaaa85844a45bc440087880c8ed Mon Sep 17 00:00:00 2001
From: David Volquartz Lebech <david@lebech.info>
Date: Mon, 29 Oct 2018 15:16:40 +0100
Subject: [PATCH 703/808] [AIRFLOW-3049] Add extra operations for Mongo hook
 (#3890)

This commit adds update, replace and delete operations for the Mongo
hook.
---
 airflow/contrib/hooks/mongo_hook.py    | 157 ++++++++++++++++++++++++-
 tests/contrib/hooks/test_mongo_hook.py | 152 ++++++++++++++++++++++++
 2 files changed, 308 insertions(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index 01dc4a42d0b32..000fe8d73e3b4 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -19,7 +19,7 @@
 from ssl import CERT_NONE
 
 from airflow.hooks.base_hook import BaseHook
-from pymongo import MongoClient
+from pymongo import MongoClient, ReplaceOne
 
 
 class MongoHook(BaseHook):
@@ -134,3 +134,158 @@ def insert_many(self, mongo_collection, docs, mongo_db=None, **kwargs):
         collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
 
         return collection.insert_many(docs, **kwargs)
+
+    def update_one(self, mongo_collection, filter_doc, update_doc,
+                   mongo_db=None, **kwargs):
+        """
+        Updates a single document in a mongo collection.
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.update_one
+
+        :param mongo_collection: The name of the collection to update.
+        :type mongo_collection: str
+        :param filter_doc: A query that matches the documents to update.
+        :type filter_doc: dict
+        :param update_doc: The modifications to apply.
+        :type update_doc: dict
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        return collection.update_one(filter_doc, update_doc, **kwargs)
+
+    def update_many(self, mongo_collection, filter_doc, update_doc,
+                    mongo_db=None, **kwargs):
+        """
+        Updates one or more documents in a mongo collection.
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.update_many
+
+        :param mongo_collection: The name of the collection to update.
+        :type mongo_collection: str
+        :param filter_doc: A query that matches the documents to update.
+        :type filter_doc: dict
+        :param update_doc: The modifications to apply.
+        :type update_doc: dict
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        return collection.update_many(filter_doc, update_doc, **kwargs)
+
+    def replace_one(self, mongo_collection, doc, filter_doc=None,
+                    mongo_db=None, **kwargs):
+        """
+        Replaces a single document in a mongo collection.
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.replace_one
+
+        .. note::
+            If no ``filter_doc`` is given, it is assumed that the replacement
+            document contain the ``_id`` field which is then used as filters.
+
+        :param mongo_collection: The name of the collection to update.
+        :type mongo_collection: str
+        :param doc: The new document.
+        :type doc: dict
+        :param filter_doc: A query that matches the documents to replace.
+            Can be omitted; then the _id field from doc will be used.
+        :type filter_doc: dict
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        if not filter_doc:
+            filter_doc = {'_id': doc['_id']}
+
+        return collection.replace_one(filter_doc, doc, **kwargs)
+
+    def replace_many(self, mongo_collection, docs,
+                     filter_docs=None, mongo_db=None, upsert=False, collation=None,
+                     **kwargs):
+        """
+        Replaces many documents in a mongo collection.
+
+        Uses bulk_write with multiple ReplaceOne operations
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.bulk_write
+
+        .. note::
+            If no ``filter_docs``are given, it is assumed that all
+            replacement documents contain the ``_id`` field which are then
+            used as filters.
+
+        :param mongo_collection: The name of the collection to update.
+        :type mongo_collection: str
+        :param docs: The new documents.
+        :type docs: list(dict)
+        :param filter_docs: A list of queries that match the documents to replace.
+            Can be omitted; then the _id fields from docs will be used.
+        :type filter_docs: list(dict)
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+        :param upsert: If ``True``, perform an insert if no documents
+            match the filters for the replace operation.
+        :type upsert: bool
+        :param collation: An instance of
+            :class:`~pymongo.collation.Collation`. This option is only
+            supported on MongoDB 3.4 and above.
+        :type collation: :class:`~pymongo.collation.Collation`
+
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        if not filter_docs:
+            filter_docs = [{'_id': doc['_id']} for doc in docs]
+
+        requests = [
+            ReplaceOne(
+                filter_docs[i],
+                docs[i],
+                upsert=upsert,
+                collation=collation)
+            for i in range(len(docs))
+        ]
+
+        return collection.bulk_write(requests, **kwargs)
+
+    def delete_one(self, mongo_collection, filter_doc, mongo_db=None, **kwargs):
+        """
+        Deletes a single document in a mongo collection.
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.delete_one
+
+        :param mongo_collection: The name of the collection to delete from.
+        :type mongo_collection: str
+        :param filter_doc: A query that matches the document to delete.
+        :type filter_doc: dict
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        return collection.delete_one(filter_doc, **kwargs)
+
+    def delete_many(self, mongo_collection, filter_doc, mongo_db=None, **kwargs):
+        """
+        Deletes one or more documents in a mongo collection.
+        https://api.mongodb.com/python/current/api/pymongo/collection.html#pymongo.collection.Collection.delete_many
+
+        :param mongo_collection: The name of the collection to delete from.
+        :type mongo_collection: str
+        :param filter_doc: A query that matches the documents to delete.
+        :type filter_doc: dict
+        :param mongo_db: The name of the database to use.
+            Can be omitted; then the database from the connection string is used.
+        :type mongo_db: str
+
+        """
+        collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
+
+        return collection.delete_many(filter_doc, **kwargs)
diff --git a/tests/contrib/hooks/test_mongo_hook.py b/tests/contrib/hooks/test_mongo_hook.py
index 6b7fd528e0e7d..114ba8495911c 100644
--- a/tests/contrib/hooks/test_mongo_hook.py
+++ b/tests/contrib/hooks/test_mongo_hook.py
@@ -74,6 +74,158 @@ def test_insert_many(self):
         result_objs = [result for result in result_objs]
         self.assertEqual(len(result_objs), 2)
 
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_update_one(self):
+        collection = mongomock.MongoClient().db.collection
+        obj = {'_id': '1', 'field': 0}
+        collection.insert_one(obj)
+
+        filter_doc = obj
+        update_doc = {'$inc': {'field': 123}}
+
+        self.hook.update_one(collection, filter_doc, update_doc)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual(123, result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_update_one_with_upsert(self):
+        collection = mongomock.MongoClient().db.collection
+
+        filter_doc = {'_id': '1', 'field': 0}
+        update_doc = {'$inc': {'field': 123}}
+
+        self.hook.update_one(collection, filter_doc, update_doc, upsert=True)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual(123, result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_update_many(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 0}
+        obj2 = {'_id': '2', 'field': 0}
+        collection.insert_many([obj1, obj2])
+
+        filter_doc = {'field': 0}
+        update_doc = {'$inc': {'field': 123}}
+
+        self.hook.update_many(collection, filter_doc, update_doc)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual(123, result_obj['field'])
+
+        result_obj = collection.find_one(filter='2')
+        self.assertEqual(123, result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_update_many_with_upsert(self):
+        collection = mongomock.MongoClient().db.collection
+
+        filter_doc = {'_id': '1', 'field': 0}
+        update_doc = {'$inc': {'field': 123}}
+
+        self.hook.update_many(collection, filter_doc, update_doc, upsert=True)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual(123, result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_replace_one(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 'test_value_1'}
+        obj2 = {'_id': '2', 'field': 'test_value_2'}
+        collection.insert_many([obj1, obj2])
+
+        obj1['field'] = 'test_value_1_updated'
+        self.hook.replace_one(collection, obj1)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual('test_value_1_updated', result_obj['field'])
+
+        # Other document should stay intact
+        result_obj = collection.find_one(filter='2')
+        self.assertEqual('test_value_2', result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_replace_one_with_filter(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 'test_value_1'}
+        obj2 = {'_id': '2', 'field': 'test_value_2'}
+        collection.insert_many([obj1, obj2])
+
+        obj1['field'] = 'test_value_1_updated'
+        self.hook.replace_one(collection, obj1, {'field': 'test_value_1'})
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual('test_value_1_updated', result_obj['field'])
+
+        # Other document should stay intact
+        result_obj = collection.find_one(filter='2')
+        self.assertEqual('test_value_2', result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_replace_one_with_upsert(self):
+        collection = mongomock.MongoClient().db.collection
+
+        obj = {'_id': '1', 'field': 'test_value_1'}
+        self.hook.replace_one(collection, obj, upsert=True)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual('test_value_1', result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_replace_many(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 'test_value_1'}
+        obj2 = {'_id': '2', 'field': 'test_value_2'}
+        collection.insert_many([obj1, obj2])
+
+        obj1['field'] = 'test_value_1_updated'
+        obj2['field'] = 'test_value_2_updated'
+        self.hook.replace_many(collection, [obj1, obj2])
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual('test_value_1_updated', result_obj['field'])
+
+        result_obj = collection.find_one(filter='2')
+        self.assertEqual('test_value_2_updated', result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_replace_many_with_upsert(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 'test_value_1'}
+        obj2 = {'_id': '2', 'field': 'test_value_2'}
+
+        self.hook.replace_many(collection, [obj1, obj2], upsert=True)
+
+        result_obj = collection.find_one(filter='1')
+        self.assertEqual('test_value_1', result_obj['field'])
+
+        result_obj = collection.find_one(filter='2')
+        self.assertEqual('test_value_2', result_obj['field'])
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_delete_one(self):
+        collection = mongomock.MongoClient().db.collection
+        obj = {'_id': '1'}
+        collection.insert_one(obj)
+
+        self.hook.delete_one(collection, {'_id': '1'})
+
+        self.assertEqual(0, collection.count())
+
+    @unittest.skipIf(mongomock is None, 'mongomock package not present')
+    def test_delete_many(self):
+        collection = mongomock.MongoClient().db.collection
+        obj1 = {'_id': '1', 'field': 'value'}
+        obj2 = {'_id': '2', 'field': 'value'}
+        collection.insert_many([obj1, obj2])
+
+        self.hook.delete_many(collection, {'field': 'value'})
+
+        self.assertEqual(0, collection.count())
+
     @unittest.skipIf(mongomock is None, 'mongomock package not present')
     def test_find_one(self):
         collection = mongomock.MongoClient().db.collection

From 3441e47c29a7ce53cc632b513b70e16356a09fef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Thu, 7 Feb 2019 12:57:32 +0100
Subject: [PATCH 704/808] [AIRFLOW-XXX] Improve linking to classes (#4655)

---
 airflow/configuration.py                      |   3 +-
 .../hooks/azure_container_instance_hook.py    |   4 +-
 airflow/contrib/hooks/bigquery_hook.py        |   6 +-
 airflow/contrib/hooks/datadog_hook.py         |   4 +-
 airflow/contrib/hooks/gcp_bigtable_hook.py    |   3 +-
 airflow/contrib/hooks/gcp_container_hook.py   |   6 +-
 airflow/contrib/hooks/gcp_spanner_hook.py     |   8 +-
 airflow/contrib/hooks/gcp_sql_hook.py         |   2 +-
 airflow/contrib/hooks/gcs_hook.py             |   2 +-
 airflow/contrib/hooks/mongo_hook.py           |   6 +-
 airflow/contrib/hooks/sagemaker_hook.py       |   4 +-
 airflow/contrib/hooks/spark_submit_hook.py    |   2 +-
 airflow/contrib/hooks/ssh_hook.py             |   2 +-
 airflow/contrib/kubernetes/pod.py             |   4 +-
 airflow/contrib/kubernetes/secret.py          |   8 +-
 airflow/contrib/kubernetes/volume.py          |   4 +-
 .../azure_container_instances_operator.py     |  22 +--
 .../contrib/operators/bigquery_operator.py    |   2 +-
 .../contrib/operators/databricks_operator.py  |   4 +-
 .../contrib/operators/dataflow_operator.py    |   6 +-
 .../contrib/operators/dataproc_operator.py    |   6 +-
 .../operators/gcp_bigtable_operator.py        |   6 +-
 .../operators/gcp_container_operator.py       |   2 +-
 .../contrib/operators/gcp_spanner_operator.py |   2 +-
 airflow/contrib/operators/gcp_sql_operator.py |   4 +-
 airflow/contrib/operators/gcs_to_bq.py        |   2 +-
 airflow/contrib/operators/gcs_to_gcs.py       |   2 +-
 .../operators/kubernetes_pod_operator.py      |  16 +-
 .../contrib/operators/mlengine_operator.py    |   2 +-
 .../operators/mlengine_operator_utils.py      |   6 +-
 .../operators/qubole_check_operator.py        |   4 +-
 airflow/contrib/operators/sftp_operator.py    |   2 +-
 airflow/contrib/operators/ssh_operator.py     |   2 +-
 airflow/contrib/operators/winrm_operator.py   |   2 +-
 airflow/contrib/sensors/weekday_sensor.py     |   2 +-
 airflow/contrib/utils/gcp_field_sanitizer.py  |   2 +-
 airflow/contrib/utils/gcp_field_validator.py  |   2 +-
 airflow/dag/base_dag.py                       |   2 +-
 airflow/exceptions.py                         |   2 +-
 airflow/executors/celery_executor.py          |   4 +-
 airflow/executors/local_executor.py           |   6 +-
 airflow/hooks/hdfs_hook.py                    |   2 +-
 airflow/hooks/hive_hooks.py                   |  12 +-
 airflow/jobs.py                               |  90 +++++------
 airflow/macros/hive.py                        |   4 +-
 airflow/models/__init__.py                    |  48 +++---
 airflow/operators/docker_operator.py          |   4 +-
 airflow/operators/generic_transfer.py         |   2 +-
 airflow/operators/hive_to_druid.py            |   2 +-
 airflow/operators/mysql_operator.py           |   7 +-
 airflow/operators/oracle_operator.py          |   5 +-
 airflow/operators/python_operator.py          |  12 +-
 airflow/operators/subdag_operator.py          |   6 +-
 airflow/plugins_manager.py                    |   4 +-
 airflow/sensors/hdfs_sensor.py                |  12 +-
 .../sensors/named_hive_partition_sensor.py    |   2 +-
 airflow/settings.py                           |   2 +-
 airflow/ti_deps/dep_context.py                |   2 +-
 airflow/ti_deps/deps/base_ti_dep.py           |  16 +-
 airflow/ti_deps/deps/trigger_rule_dep.py      |   4 +-
 airflow/utils/dag_processing.py               |  44 +++---
 airflow/utils/log/es_task_handler.py          |   2 +-
 airflow/utils/log/file_processor_handler.py   |   2 +-
 airflow/utils/log/file_task_handler.py        |   2 +-
 airflow/utils/operator_helpers.py             |   2 +-
 airflow/www_rbac/security.py                  |  17 ++-
 docs/code.rst                                 |   2 +
 docs/concepts.rst                             |  21 ++-
 docs/conf.py                                  |  10 +-
 docs/howto/executor/use-dask.rst              |   4 +-
 docs/howto/executor/use-mesos.rst             |   4 +-
 docs/installation.rst                         | 142 +++++++++---------
 docs/scheduler.rst                            |   6 +-
 docs/start.rst                                |   2 +-
 74 files changed, 353 insertions(+), 323 deletions(-)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index ec38236bbaa94..357da6f945a04 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -344,8 +344,9 @@ def getsection(self, section):
         """
         Returns the section as a dict. Values are converted to int, float, bool
         as required.
+
         :param section: section from the config
-        :return: dict
+        :rtype: dict
         """
         if (section not in self._sections and
                 section not in self.airflow_defaults._sections):
diff --git a/airflow/contrib/hooks/azure_container_instance_hook.py b/airflow/contrib/hooks/azure_container_instance_hook.py
index 5ad64de6d7592..27aa649814885 100644
--- a/airflow/contrib/hooks/azure_container_instance_hook.py
+++ b/airflow/contrib/hooks/azure_container_instance_hook.py
@@ -119,7 +119,7 @@ def get_messages(self, resource_group, name):
         :param name: the name of the container group
         :type name: str
         :return: A list of the event messages
-        :rtype: list<str>
+        :rtype: list[str]
         """
         instance_view = self._get_instance_view(resource_group, name)
 
@@ -136,7 +136,7 @@ def get_logs(self, resource_group, name, tail=1000):
         :param tail: the size of the tail
         :type tail: int
         :return: A list of log messages
-        :rtype: list<str>
+        :rtype: list[str]
         """
         logs = self.connection.container.list_logs(resource_group, name, name, tail=tail)
         return logs.content.splitlines(True)
diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 56c9180d8e99b..457397d661a7c 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -591,7 +591,7 @@ def run_query(self,
         :param cluster_fields: Request that the result of this query be stored sorted
             by one or more columns. This is only available in combination with
             time_partitioning. The order of columns given determines the sort order.
-        :type cluster_fields: list of str
+        :type cluster_fields: list[str]
         :param location: The geographic location of the job. Required except for
             US and EU. See details at
             https://cloud.google.com/bigquery/docs/locations#specifying_your_location
@@ -836,7 +836,7 @@ def run_copy(self,
         :type write_disposition: str
         :param create_disposition: The create disposition if the table doesn't exist.
         :type create_disposition: str
-        :param labels a dictionary containing labels for the job/query,
+        :param labels: a dictionary containing labels for the job/query,
             passed to BigQuery
         :type labels: dict
         """
@@ -968,7 +968,7 @@ def run_load(self,
         :param cluster_fields: Request that the result of this load be stored sorted
             by one or more columns. This is only available in combination with
             time_partitioning. The order of columns given determines the sort order.
-        :type cluster_fields: list of str
+        :type cluster_fields: list[str]
         """
 
         # bigquery only allows certain source formats
diff --git a/airflow/contrib/hooks/datadog_hook.py b/airflow/contrib/hooks/datadog_hook.py
index 45aa09a094a5f..50209dd112e06 100644
--- a/airflow/contrib/hooks/datadog_hook.py
+++ b/airflow/contrib/hooks/datadog_hook.py
@@ -135,8 +135,8 @@ def post_event(self, title, text, aggregation_key=None, alert_type=None, date_ha
         :type priority: str
         :param related_event_id: Post event as a child of the given event
         :type related_event_id: id
-        :param tags: List of string tags to apply to the event
-        :type tags: list
+        :param tags: List of tags to apply to the event
+        :type tags: list[str]
         :param device_name: device_name to post the event with
         :type device_name: list
         """
diff --git a/airflow/contrib/hooks/gcp_bigtable_hook.py b/airflow/contrib/hooks/gcp_bigtable_hook.py
index aeca2b475f566..d50a95deb46c7 100644
--- a/airflow/contrib/hooks/gcp_bigtable_hook.py
+++ b/airflow/contrib/hooks/gcp_bigtable_hook.py
@@ -185,7 +185,8 @@ def create_table(instance,
             initially split the table.
         :type column_families: dict
         :param column_families: (Optional) A map of columns to create. The key is the
-            column_id str, and the value is a ``GarbageCollectionRule``.
+            column_id str, and the value is a
+            :class:`google.cloud.bigtable.column_family.GarbageCollectionRule`.
         """
         if column_families is None:
             column_families = {}
diff --git a/airflow/contrib/hooks/gcp_container_hook.py b/airflow/contrib/hooks/gcp_container_hook.py
index 652e6213085a7..909cc6338377b 100644
--- a/airflow/contrib/hooks/gcp_container_hook.py
+++ b/airflow/contrib/hooks/gcp_container_hook.py
@@ -75,7 +75,7 @@ def wait_for_operation(self, operation, project_id=None):
         completion or an error occurring
 
         :param operation: The Operation to wait for
-        :type operation: A google.cloud.container_V1.gapic.enums.Operator
+        :type operation: google.cloud.container_V1.gapic.enums.Operation
         :param project_id: Google Cloud Platform project ID
         :type project_id: str
         :return: A new, updated operation fetched from Google Cloud
@@ -174,7 +174,7 @@ def create_cluster(self, cluster, project_id=None, retry=DEFAULT, timeout=DEFAUL
 
         :param cluster: A Cluster protobuf or dict. If dict is provided, it must
             be of the same form as the protobuf message
-            ``google.cloud.container_v1.types.Cluster``
+            :class:`google.cloud.container_v1.types.Cluster`
         :type cluster: dict or google.cloud.container_v1.types.Cluster
         :param project_id: Google Cloud Platform project ID
         :type project_id: str
@@ -233,7 +233,7 @@ def get_cluster(self, name, project_id=None, retry=DEFAULT, timeout=DEFAULT):
             complete. Note that if retry is specified, the timeout applies to each
             individual attempt.
         :type timeout: float
-        :return: A google.cloud.container_v1.types.Cluster instance
+        :return: google.cloud.container_v1.types.Cluster
         """
         self.log.info(
             "Fetching cluster (project_id=%s, zone=%s, cluster_name=%s)",
diff --git a/airflow/contrib/hooks/gcp_spanner_hook.py b/airflow/contrib/hooks/gcp_spanner_hook.py
index 66e9fc52dbad0..6b442c46989f5 100644
--- a/airflow/contrib/hooks/gcp_spanner_hook.py
+++ b/airflow/contrib/hooks/gcp_spanner_hook.py
@@ -44,8 +44,7 @@ def _get_client(self, project_id):
 
         :param project_id: The ID of the  GCP project.
         :type project_id: str
-        :return: Client for interacting with the Cloud Spanner API. See:
-            https://googleapis.github.io/google-cloud-python/latest/spanner/client-api.html#google.cloud.spanner_v1.client.Client
+        :return: google.cloud.spanner_v1.client.Client
         :rtype: object
         """
         if not self._client:
@@ -62,8 +61,7 @@ def get_instance(self, instance_id, project_id=None):
         :type project_id: str
         :param instance_id: The ID of the Cloud Spanner instance.
         :type instance_id: str
-        :return: Representation of a Cloud Spanner Instance. See:
-            https://googleapis.github.io/google-cloud-python/latest/spanner/instance-api.html#google.cloud.spanner_v1.instance.Instance
+        :return: google.cloud.spanner_v1.instance.Instance
         :rtype: object
         """
         instance = self._get_client(project_id=project_id).instance(instance_id=instance_id)
@@ -196,7 +194,7 @@ def get_database(self, instance_id, database_id, project_id=None):
             database. If set to None or missing, the default project_id from the GCP connection is used.
         :type project_id: str
         :return: Database object or None if database does not exist
-        :rtype: Union[Database, None]
+        :rtype: google.cloud.spanner_v1.database.Database or None
         """
 
         instance = self._get_client(project_id=project_id).instance(
diff --git a/airflow/contrib/hooks/gcp_sql_hook.py b/airflow/contrib/hooks/gcp_sql_hook.py
index 002083cdcea8b..b81fc81cb4766 100644
--- a/airflow/contrib/hooks/gcp_sql_hook.py
+++ b/airflow/contrib/hooks/gcp_sql_hook.py
@@ -413,7 +413,7 @@ def __init__(self,
         :type instance_specification: str
         :param gcp_conn_id: Id of Google Cloud Platform connection to use for
             authentication
-        :type: str
+        :type gcp_conn_id: str
         :param project_id: Optional id of the GCP project to connect to - it overwrites
             default project id taken from the GCP connection.
         :type project_id: str
diff --git a/airflow/contrib/hooks/gcs_hook.py b/airflow/contrib/hooks/gcs_hook.py
index 987dbf583892b..cab06b92d5dec 100644
--- a/airflow/contrib/hooks/gcs_hook.py
+++ b/airflow/contrib/hooks/gcs_hook.py
@@ -284,7 +284,7 @@ def is_updated_after(self, bucket, object, ts):
             storage bucket.
         :type object: str
         :param ts: The timestamp to check against.
-        :type ts: datetime
+        :type ts: datetime.datetime
         """
         service = self.get_conn()
         try:
diff --git a/airflow/contrib/hooks/mongo_hook.py b/airflow/contrib/hooks/mongo_hook.py
index 000fe8d73e3b4..959d4cc86274c 100644
--- a/airflow/contrib/hooks/mongo_hook.py
+++ b/airflow/contrib/hooks/mongo_hook.py
@@ -222,10 +222,10 @@ def replace_many(self, mongo_collection, docs,
         :param mongo_collection: The name of the collection to update.
         :type mongo_collection: str
         :param docs: The new documents.
-        :type docs: list(dict)
+        :type docs: list[dict]
         :param filter_docs: A list of queries that match the documents to replace.
             Can be omitted; then the _id fields from docs will be used.
-        :type filter_docs: list(dict)
+        :type filter_docs: list[dict]
         :param mongo_db: The name of the database to use.
             Can be omitted; then the database from the connection string is used.
         :type mongo_db: str
@@ -235,7 +235,7 @@ def replace_many(self, mongo_collection, docs,
         :param collation: An instance of
             :class:`~pymongo.collation.Collation`. This option is only
             supported on MongoDB 3.4 and above.
-        :type collation: :class:`~pymongo.collation.Collation`
+        :type collation: pymongo.collation.Collation
 
         """
         collection = self.get_collection(mongo_collection, mongo_db=mongo_db)
diff --git a/airflow/contrib/hooks/sagemaker_hook.py b/airflow/contrib/hooks/sagemaker_hook.py
index 8ff478649de1a..80777821fef39 100644
--- a/airflow/contrib/hooks/sagemaker_hook.py
+++ b/airflow/contrib/hooks/sagemaker_hook.py
@@ -234,7 +234,7 @@ def get_log_conn(self):
         """
         Establish an AWS connection for retrieving logs during training
 
-        :rtype: :py:class:`CloudWatchLog.Client`
+        :rtype: CloudWatchLogs.Client
         """
         config = botocore.config.Config(retries={'max_attempts': 15})
         return self.get_client_type('logs', config=config)
@@ -373,7 +373,7 @@ def create_tuning_job(self, config, wait_for_completion=True,
         :param config: the config for tuning
         :type config: dict
         :param wait_for_completion: if the program should keep running until job finishes
-        :param wait_for_completion: bool
+        :type wait_for_completion: bool
         :param check_interval: the time interval in seconds which the operator
             will check the status of any SageMaker job
         :type check_interval: int
diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 6215bb4750f8d..55242c8c5ff82 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -88,7 +88,7 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :type verbose: bool
     :param spark_binary: The command to use for spark submit.
                          Some distros may use spark2-submit.
-    :type spark_binary: string
+    :type spark_binary: str
     """
     def __init__(self,
                  conf=None,
diff --git a/airflow/contrib/hooks/ssh_hook.py b/airflow/contrib/hooks/ssh_hook.py
index 97e93bbc603f9..d81cfd3cd4d7b 100755
--- a/airflow/contrib/hooks/ssh_hook.py
+++ b/airflow/contrib/hooks/ssh_hook.py
@@ -146,7 +146,7 @@ def get_conn(self):
         """
         Opens a ssh connection to the remote host.
 
-        :return paramiko.SSHClient object
+        :rtype: paramiko.client.SSHClient
         """
 
         self.log.debug('Creating SSH client for conn_id: %s', self.ssh_conn_id)
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 6d2977592598a..96947a79a3e95 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -46,9 +46,9 @@ class Pod:
     :param envs: A dict containing the environment variables
     :type envs: dict
     :param cmds: The command to be run on the pod
-    :type cmds: list str
+    :type cmds: list[str]
     :param secrets: Secrets to be launched to the pod
-    :type secrets: list Secret
+    :type secrets: list[airflow.contrib.kubernetes.secret.Secret]
     :param result: The result that will be returned to the operator after
                    successful execution of the pod
     :type result: any
diff --git a/airflow/contrib/kubernetes/secret.py b/airflow/contrib/kubernetes/secret.py
index 5c1038cd84e9a..bf1526b1a393b 100644
--- a/airflow/contrib/kubernetes/secret.py
+++ b/airflow/contrib/kubernetes/secret.py
@@ -24,14 +24,14 @@ def __init__(self, deploy_type, deploy_target, secret, key):
         the user.
         :param deploy_type: The type of secret deploy in Kubernetes, either `env` or
             `volume`
-        :type deploy_type: ``str``
+        :type deploy_type: str
         :param deploy_target: The environment variable when `deploy_type` `env` or
             file path when `deploy_type` `volume` where expose secret
-        :type deploy_target: ``str``
+        :type deploy_target: str
         :param secret: Name of the secrets object in Kubernetes
-        :type secret: ``str``
+        :type secret: str
         :param key: Key of the secret within the Kubernetes Secret
-        :type key: ``str``
+        :type key: str
         """
         self.deploy_type = deploy_type
         self.deploy_target = deploy_target.upper()
diff --git a/airflow/contrib/kubernetes/volume.py b/airflow/contrib/kubernetes/volume.py
index d5b4f60cc3850..94003fe48dcb3 100644
--- a/airflow/contrib/kubernetes/volume.py
+++ b/airflow/contrib/kubernetes/volume.py
@@ -23,11 +23,11 @@ def __init__(self, name, configs):
         """ Adds Kubernetes Volume to pod. allows pod to access features like ConfigMaps
         and Persistent Volumes
         :param name: the name of the volume mount
-        :type: name: str
+        :type name: str
         :param configs: dictionary of any features needed for volume.
         We purposely keep this vague since there are multiple volume types with changing
         configs.
-        :type: configs: dict
+        :type configs: dict
         """
         self.name = name
         self.configs = configs
diff --git a/airflow/contrib/operators/azure_container_instances_operator.py b/airflow/contrib/operators/azure_container_instances_operator.py
index f1b2a2a1a5bab..7ec6ca6ab8d5e 100644
--- a/airflow/contrib/operators/azure_container_instances_operator.py
+++ b/airflow/contrib/operators/azure_container_instances_operator.py
@@ -62,18 +62,18 @@ class AzureContainerInstancesOperator(BaseOperator):
     :type image: str
     :param region: the region wherein this container instance should be started
     :type region: str
-    :param: environment_variables: key,value pairs containing environment variables
-        which will be passed to the running container
-    :type: environment_variables: dict
-    :param: volumes: list of volumes to be mounted to the container.
+    :param environment_variables: key,value pairs containing environment
+        variables which will be passed to the running container
+    :type environment_variables: dict
+    :param volumes: list of volumes to be mounted to the container.
         Currently only Azure Fileshares are supported.
-    :type: volumes: list[<conn_id, account_name, share_name, mount_path, read_only>]
-    :param: memory_in_gb: the amount of memory to allocate to this container
-    :type: memory_in_gb: double
-    :param: cpu: the number of cpus to allocate to this container
-    :type: cpu: double
-    :param: command: the command to run inside the container
-    :type: command: str
+    :type volumes: list[<conn_id, account_name, share_name, mount_path, read_only>]
+    :param memory_in_gb: the amount of memory to allocate to this container
+    :type memory_in_gb: double
+    :param cpu: the number of cpus to allocate to this container
+    :type cpu: double
+    :param command: the command to run inside the container
+    :type command: str
 
     :Example:
 
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index cbcdfd3325194..3153102b1d151 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -105,7 +105,7 @@ class BigQueryOperator(BaseOperator):
     :param cluster_fields: Request that the result of this query be stored sorted
         by one or more columns. This is only available in conjunction with
         time_partitioning. The order of columns given determines the sort order.
-    :type cluster_fields: list of str
+    :type cluster_fields: list[str]
     :param location: The geographic location of the job. Required except for
         US and EU. See details at
         https://cloud.google.com/bigquery/docs/locations#specifying_your_location
diff --git a/airflow/contrib/operators/databricks_operator.py b/airflow/contrib/operators/databricks_operator.py
index a8742e401c4fe..df3f903725ef6 100644
--- a/airflow/contrib/operators/databricks_operator.py
+++ b/airflow/contrib/operators/databricks_operator.py
@@ -390,7 +390,7 @@ class DatabricksRunNowOperator(BaseOperator):
 
         .. seealso::
             https://docs.databricks.com/api/latest/jobs.html#run-now
-    :type python_params: array of strings
+    :type python_params: list[str]
     :param spark_submit_params: A list of parameters for jobs with spark submit task,
         e.g. "spark_submit_params": ["--class", "org.apache.spark.examples.SparkPi"].
         The parameters will be passed to spark-submit script as command line parameters.
@@ -401,7 +401,7 @@ class DatabricksRunNowOperator(BaseOperator):
 
         .. seealso::
             https://docs.databricks.com/api/latest/jobs.html#run-now
-    :type spark_submit_params: array of strings
+    :type spark_submit_params: list[str]
     :param timeout_seconds: The timeout for this run. By default a value of 0 is used
         which means to have no timeout.
         This field will be templated.
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index de91804950092..c67ab69275d98 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -279,8 +279,8 @@ class DataFlowPythonOperator(BaseOperator):
         (templated). This ends up being set in the pipeline options, so any entry
         with key ``'jobName'`` or ``'job_name'`` in ``options`` will be overwritten.
     :type job_name: str
-    :param py_options: Additional python options.
-    :type pyt_options: list of strings, e.g., ["-m", "-v"].
+    :param py_options: Additional python options, e.g., ["-m", "-v"].
+    :type pyt_options: list[str]
     :param dataflow_default_options: Map of default job options.
     :type dataflow_default_options: dict
     :param options: Map of job specific options.
@@ -365,7 +365,7 @@ def google_cloud_to_local(self, file_name):
         :param file_name: The full path of input file.
         :type file_name: str
         :return: The full path of local file.
-        :type: str
+        :type str
         """
         if not file_name.startswith('gs://'):
             return file_name
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 9a0a47279b191..33a3e9347c7ff 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -60,7 +60,7 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type storage_bucket: str
     :param init_actions_uris: List of GCS uri's containing
         dataproc initialization scripts
-    :type init_actions_uris: list[string]
+    :type init_actions_uris: list[str]
     :param init_action_timeout: Amount of time executable scripts in
         init_actions_uris has to complete
     :type init_action_timeout: str
@@ -110,7 +110,7 @@ class DataprocClusterCreateOperator(BaseOperator):
         enabled networks
     :type internal_ip_only: bool
     :param tags: The GCE tags to add to all instances
-    :type tags: list[string]
+    :type tags: list[str]
     :param region: leave as 'global', might become relevant in the future. (templated)
     :type region: str
     :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
@@ -122,7 +122,7 @@ class DataprocClusterCreateOperator(BaseOperator):
     :param service_account: The service account of the dataproc instances.
     :type service_account: str
     :param service_account_scopes: The URIs of service account scopes to be included.
-    :type service_account_scopes: list[string]
+    :type service_account_scopes: list[str]
     :param idle_delete_ttl: The longest duration that cluster would keep alive while
         staying idle. Passing this threshold will cause cluster to be auto-deleted.
         A duration in seconds.
diff --git a/airflow/contrib/operators/gcp_bigtable_operator.py b/airflow/contrib/operators/gcp_bigtable_operator.py
index c59ee5561d259..e100af12ad748 100644
--- a/airflow/contrib/operators/gcp_bigtable_operator.py
+++ b/airflow/contrib/operators/gcp_bigtable_operator.py
@@ -65,7 +65,7 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
     :param replica_cluster_id: (optional) The ID for replica cluster for the new instance.
     :type replica_cluster_zone: str
     :param replica_cluster_zone: (optional)  The zone for replica cluster.
-    :type instance_type: IntEnum
+    :type instance_type: enums.IntEnum
     :param instance_type: (optional) The type of the instance.
     :type instance_display_name: str
     :param instance_display_name: (optional) Human-readable name of the instance. Defaults
@@ -75,7 +75,7 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
         with the instance.
     :type cluster_nodes: int
     :param cluster_nodes: (optional) Number of nodes for cluster.
-    :type cluster_storage_type: IntEnum
+    :type cluster_storage_type: enums.IntEnum
     :param cluster_storage_type: (optional) The type of storage.
     :type timeout: int
     :param timeout: (optional) timeout (in seconds) for instance creation.
@@ -213,7 +213,7 @@ class BigtableTableCreateOperator(BaseOperator, BigtableValidationMixin):
     :type column_families: dict
     :param column_families: (Optional) A map columns to create.
                             The key is the column_id str and the value is a
-                            GarbageCollectionRule
+                            :class:`google.cloud.bigtable.column_family.GarbageCollectionRule`
     """
     REQUIRED_ATTRIBUTES = ('instance_id', 'table_id')
     template_fields = ['project_id', 'instance_id', 'table_id']
diff --git a/airflow/contrib/operators/gcp_container_operator.py b/airflow/contrib/operators/gcp_container_operator.py
index 663d8510d371d..c5325193f6ff0 100644
--- a/airflow/contrib/operators/gcp_container_operator.py
+++ b/airflow/contrib/operators/gcp_container_operator.py
@@ -119,7 +119,7 @@ class GKEClusterCreateOperator(BaseOperator):
 
     .. seealso::
         For more detail on about creating clusters have a look at the reference:
-        https://google-cloud-python.readthedocs.io/en/latest/container/gapic/v1/types.html#google.cloud.container_v1.types.Cluster
+        :class:`google.cloud.container_v1.types.Cluster`
 
     :param project_id: The Google Developers Console [project ID or project number]
     :type project_id: str
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index a85e1aeb76020..f78fcbde3211c 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -221,7 +221,7 @@ class CloudSpannerInstanceDatabaseDeployOperator(BaseOperator):
     :param database_id: The Cloud Spanner database ID.
     :type database_id: str
     :param ddl_statements: The string list containing DDL for the new database.
-    :type ddl_statements: list of str
+    :type ddl_statements: list[str]
     :param project_id: Optional, the ID of the project that owns the Cloud Spanner
         Database.  If set to None or missing, the default project_id from the GCP connection is used.
     :type project_id: str
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index 5a7f348984ec0..ece91cf40456f 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -697,7 +697,7 @@ class CloudSqlQueryOperator(BaseOperator):
         so it is useless to pass it DQL queries. Note that it is responsibility of the
         author of the queries to make sure that the queries are idempotent. For example
         you can use CREATE TABLE IF NOT EXISTS to create a table.
-    :type sql: str or [str]
+    :type sql: str or list[str]
     :param parameters: (optional) the parameters to render the SQL query with.
     :type parameters: mapping or iterable
     :param autocommit: if True, each command is automatically committed.
@@ -708,7 +708,7 @@ class CloudSqlQueryOperator(BaseOperator):
     :type gcp_conn_id: str
     :param gcp_cloudsql_conn_id: The connection ID used to connect to Google Cloud SQL
        its schema should be gcpcloudsql://.
-       See :class:`~airflow.contrib.hooks.gcp_sql_hooks.CloudSqlDatabaseHook` for
+       See :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` for
        details on how to define gcpcloudsql:// connection.
     :type gcp_cloudsql_conn_id: str
     """
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 540d5653bc412..28a04d36c1b07 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -119,7 +119,7 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
         by one or more columns. This is only available in conjunction with
         time_partitioning. The order of columns given determines the sort order.
         Not applicable for external tables.
-    :type cluster_fields: list of str
+    :type cluster_fields: list[str]
     :param autodetect: [Optional] Indicates if we should automatically infer the
         options and schema for CSV and JSON sources. (Default: ``False``)
     :type autodetect: bool
diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index f4f70aa50865a..7e7400936ae43 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -65,7 +65,7 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
     :param last_modified_time: When specified, if the object(s) were
         modified after last_modified_time, they will be copied/moved.
         If tzinfo has not been set, UTC will be assumed.
-    :type last_modified_time: datetime
+    :type last_modified_time: datetime.datetime
 
     :Example:
 
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 3a5bef5381780..25b734da9b20a 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -37,14 +37,14 @@ class KubernetesPodOperator(BaseOperator):
     :param image: Docker image you wish to launch. Defaults to dockerhub.io,
         but fully qualified URLS will point to custom repositories
     :type image: str
-    :param: namespace: the namespace to run within kubernetes
-    :type: namespace: str
+    :param namespace: the namespace to run within kubernetes
+    :type namespace: str
     :param cmds: entrypoint of the container. (templated)
         The docker images's entrypoint is used if this is not provide.
-    :type cmds: list of str
-    :param arguments: arguments of to the entrypoint. (templated)
+    :type cmds: list[str]
+    :param arguments: arguments of the entrypoint. (templated)
         The docker image's CMD is used if this is not provided.
-    :type arguments: list of str
+    :type arguments: list[str]
     :param image_pull_policy: Specify a policy to cache or always pull an image
     :type image_pull_policy: str
     :param image_pull_secrets: Any image pull secrets to be given to the pod.
@@ -52,9 +52,9 @@ class KubernetesPodOperator(BaseOperator):
                                comma separated list: secret_a,secret_b
     :type image_pull_secrets: str
     :param volume_mounts: volumeMounts for launched pod
-    :type volume_mounts: list of VolumeMount
+    :type volume_mounts: list[airflow.contrib.kubernetes.volume_mount.VolumeMount]
     :param volumes: volumes for launched pod. Includes ConfigMaps and PersistentVolumes
-    :type volumes: list of Volume
+    :type volumes: list[airflow.contrib.kubernetes.volume.Volume]
     :param labels: labels to apply to the Pod
     :type labels: dict
     :param startup_timeout_seconds: timeout in seconds to startup the pod
@@ -66,7 +66,7 @@ class KubernetesPodOperator(BaseOperator):
     :type env_vars: dict
     :param secrets: Kubernetes secrets to inject in the container,
         They can be exposed as environment vars or files in a volume.
-    :type secrets: list of Secret
+    :type secrets: list[airflow.contrib.kubernetes.secret.Secret]
     :param in_cluster: run kubernetes client with in_cluster configuration
     :type in_cluster: bool
     :param cluster_context: context that points to kubernetes cluster.
diff --git a/airflow/contrib/operators/mlengine_operator.py b/airflow/contrib/operators/mlengine_operator.py
index 91e636b61ac5c..a5ac41911d93d 100644
--- a/airflow/contrib/operators/mlengine_operator.py
+++ b/airflow/contrib/operators/mlengine_operator.py
@@ -106,7 +106,7 @@ class MLEngineBatchPredictionOperator(BaseOperator):
 
     :param input_paths: A list of GCS paths of input data for batch
         prediction. Accepting wildcard operator ``*``, but only at the end. (templated)
-    :type input_paths: list of string
+    :type input_paths: list[str]
 
     :param output_path: The GCS path where the prediction results are
         written to. (templated)
diff --git a/airflow/contrib/operators/mlengine_operator_utils.py b/airflow/contrib/operators/mlengine_operator_utils.py
index c2951b715d337..4a8fa0589def7 100644
--- a/airflow/contrib/operators/mlengine_operator_utils.py
+++ b/airflow/contrib/operators/mlengine_operator_utils.py
@@ -114,7 +114,7 @@ def validate_err_and_count(summary):
     :type data_format: str
 
     :param input_paths: a list of input paths to be sent to BatchPrediction.
-    :type input_paths: list of strings
+    :type input_paths: list[str]
 
     :param prediction_path: GCS path to put the prediction results in.
     :type prediction_path: str
@@ -123,7 +123,7 @@ def validate_err_and_count(summary):
         - metric_fn is a function that accepts a dictionary (for an instance),
           and returns a tuple of metric(s) that it calculates.
         - metric_keys is a list of strings to denote the key of each metric.
-    :type metric_fn_and_keys: tuple of a function and a list of strings
+    :type metric_fn_and_keys: tuple of a function and a list[str]
 
     :param validate_fn: a function to validate whether the averaged metric(s) is
         good enough to push the model.
@@ -167,7 +167,7 @@ def validate_err_and_count(summary):
     :type version_name: str
 
     :param dag: The `DAG` to use for all Operators.
-    :type dag: airflow.DAG
+    :type dag: airflow.models.DAG
 
     :returns: a tuple of three operators, (prediction, summary, validation)
     :rtype: tuple(DataFlowPythonOperator, DataFlowPythonOperator,
diff --git a/airflow/contrib/operators/qubole_check_operator.py b/airflow/contrib/operators/qubole_check_operator.py
index 3745eddd7936d..bbef16ea10842 100644
--- a/airflow/contrib/operators/qubole_check_operator.py
+++ b/airflow/contrib/operators/qubole_check_operator.py
@@ -129,13 +129,13 @@ class QuboleValueCheckOperator(ValueCheckOperator, QuboleOperator):
     :type qubole_conn_id: str
 
     :param pass_value: Expected value of the query results.
-    :type pass_value: str/int/float
+    :type pass_value: str or int or float
 
     :param tolerance: Defines the permissible pass_value range, for example if
         tolerance is 2, the Qubole command output can be anything between
         -2*pass_value and 2*pass_value, without the operator erring out.
 
-    :type tolerance: int/float
+    :type tolerance: int or float
 
 
     kwargs:
diff --git a/airflow/contrib/operators/sftp_operator.py b/airflow/contrib/operators/sftp_operator.py
index 74e86398db3f2..4af5fe9a59979 100644
--- a/airflow/contrib/operators/sftp_operator.py
+++ b/airflow/contrib/operators/sftp_operator.py
@@ -37,7 +37,7 @@ class SFTPOperator(BaseOperator):
 
     :param ssh_hook: predefined ssh_hook to use for remote execution.
         Either `ssh_hook` or `ssh_conn_id` needs to be provided.
-    :type ssh_hook: :class:`SSHHook`
+    :type ssh_hook: airflow.contrib.hooks.ssh_hook.SSHHook
     :param ssh_conn_id: connection id from airflow Connections.
         `ssh_conn_id` will be ignored if `ssh_hook` is provided.
     :type ssh_conn_id: str
diff --git a/airflow/contrib/operators/ssh_operator.py b/airflow/contrib/operators/ssh_operator.py
index 00462ad3d6889..5686792b35d62 100644
--- a/airflow/contrib/operators/ssh_operator.py
+++ b/airflow/contrib/operators/ssh_operator.py
@@ -33,7 +33,7 @@ class SSHOperator(BaseOperator):
 
     :param ssh_hook: predefined ssh_hook to use for remote execution.
         Either `ssh_hook` or `ssh_conn_id` needs to be provided.
-    :type ssh_hook: :class:`SSHHook`
+    :type ssh_hook: airflow.contrib.hooks.ssh_hook.SSHHook
     :param ssh_conn_id: connection id from airflow Connections.
         `ssh_conn_id` will be ignored if `ssh_hook` is provided.
     :type ssh_conn_id: str
diff --git a/airflow/contrib/operators/winrm_operator.py b/airflow/contrib/operators/winrm_operator.py
index 760b2548e858a..e7738a471fd92 100644
--- a/airflow/contrib/operators/winrm_operator.py
+++ b/airflow/contrib/operators/winrm_operator.py
@@ -39,7 +39,7 @@ class WinRMOperator(BaseOperator):
     WinRMOperator to execute commands on given remote host using the winrm_hook.
 
     :param winrm_hook: predefined ssh_hook to use for remote execution
-    :type winrm_hook: :class:`WinRMHook`
+    :type winrm_hook: airflow.contrib.hooks.winrm_hook.WinRMHook
     :param ssh_conn_id: connection id from airflow Connections
     :type ssh_conn_id: str
     :param remote_host: remote host to connect
diff --git a/airflow/contrib/sensors/weekday_sensor.py b/airflow/contrib/sensors/weekday_sensor.py
index e0357c5b2f496..8d99e11fb459f 100644
--- a/airflow/contrib/sensors/weekday_sensor.py
+++ b/airflow/contrib/sensors/weekday_sensor.py
@@ -66,7 +66,7 @@ class DayOfWeekSensor(BaseSensorOperator):
             * ``{WeekDay.TUESDAY}``
             * ``{WeekDay.SATURDAY, WeekDay.SUNDAY}``
 
-    :type week_day: set or str or WeekDay
+    :type week_day: set or str or airflow.contrib.utils.weekday.WeekDay
     :param use_task_execution_day: If ``True``, uses task's execution day to compare
         with week_day. Execution Date is Useful for backfilling.
         If ``False``, uses system's day of the week. Useful when you
diff --git a/airflow/contrib/utils/gcp_field_sanitizer.py b/airflow/contrib/utils/gcp_field_sanitizer.py
index f6c5af0adf0ed..2f5ff6730a8ac 100644
--- a/airflow/contrib/utils/gcp_field_sanitizer.py
+++ b/airflow/contrib/utils/gcp_field_sanitizer.py
@@ -114,7 +114,7 @@ class GcpBodyFieldSanitizer(LoggingMixin):
     """Sanitizes the body according to specification.
 
     :param sanitize_specs: array of strings that specifies which fields to remove
-    :type sanitize_specs: [string]
+    :type sanitize_specs: list[str]
 
     """
     def __init__(self, sanitize_specs):
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index 797be076d7914..71b6c74eaf6b7 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -190,7 +190,7 @@ class GcpBodyFieldValidator(LoggingMixin):
     for some examples and explanations of how to create specification.
 
     :param validation_specs: dictionary describing validation specification
-    :type validation_specs: [dict]
+    :type validation_specs: list[dict]
     :param api_version: Version of the api used (for example v1)
     :type api_version: str
 
diff --git a/airflow/dag/base_dag.py b/airflow/dag/base_dag.py
index 5719f572e9b4c..0e65775d41424 100644
--- a/airflow/dag/base_dag.py
+++ b/airflow/dag/base_dag.py
@@ -96,6 +96,6 @@ def dag_ids(self):
     def get_dag(self, dag_id):
         """
         :return: whether the task exists in this bag
-        :rtype: BaseDag
+        :rtype: airflow.dag.base_dag.BaseDag
         """
         raise NotImplementedError()
diff --git a/airflow/exceptions.py b/airflow/exceptions.py
index d4098c4a32435..41f0a3dda8e38 100644
--- a/airflow/exceptions.py
+++ b/airflow/exceptions.py
@@ -52,7 +52,7 @@ class AirflowRescheduleException(AirflowException):
     Raise when the task should be re-scheduled at a later time.
 
     :param reschedule_date: The date when the task should be rescheduled
-    :type reschedule: datetime
+    :type reschedule: datetime.datetime
     """
     def __init__(self, reschedule_date):
         self.reschedule_date = reschedule_date
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index db46d29ca6383..f877368325a10 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -92,9 +92,9 @@ def fetch_celery_task_state(celery_task):
     global so that it can be called by subprocesses in the pool.
     :param celery_task: a tuple of the Celery task key and the async Celery object used
                         to fetch the task's state
-    :type celery_task: (str, celery.result.AsyncResult)
+    :type celery_task: tuple(str, celery.result.AsyncResult)
     :return: a tuple of the Celery task key and the Celery state of the task
-    :rtype: (str, str)
+    :rtype: luple[str, str]
     """
 
     try:
diff --git a/airflow/executors/local_executor.py b/airflow/executors/local_executor.py
index 3e622da0531f3..c9454a677f832 100644
--- a/airflow/executors/local_executor.py
+++ b/airflow/executors/local_executor.py
@@ -75,7 +75,7 @@ def execute_work(self, key, command):
         """
         Executes command received and stores result state in queue.
         :param key: the key to identify the TI
-        :type key: Tuple(dag_id, task_id, execution_date)
+        :type key: tuple(dag_id, task_id, execution_date)
         :param command: the command to execute
         :type command: str
         """
@@ -144,7 +144,7 @@ def start(self):
         def execute_async(self, key, command):
             """
             :param key: the key to identify the TI
-            :type key: Tuple(dag_id, task_id, execution_date)
+            :type key: tuple(dag_id, task_id, execution_date)
             :param command: the command to execute
             :type command: str
             """
@@ -189,7 +189,7 @@ def start(self):
         def execute_async(self, key, command):
             """
             :param key: the key to identify the TI
-            :type key: Tuple(dag_id, task_id, execution_date)
+            :type key: tuple(dag_id, task_id, execution_date)
             :param command: the command to execute
             :type command: str
             """
diff --git a/airflow/hooks/hdfs_hook.py b/airflow/hooks/hdfs_hook.py
index b00bab42ce813..597b7c4f7ec83 100644
--- a/airflow/hooks/hdfs_hook.py
+++ b/airflow/hooks/hdfs_hook.py
@@ -39,7 +39,7 @@ class HDFSHook(BaseHook):
     Interact with HDFS. This class is a wrapper around the snakebite library.
 
     :param hdfs_conn_id: Connection id to fetch connection info
-    :type conn_id: str
+    :type hdfs_conn_id: str
     :param proxy_user: effective user for HDFS operations
     :type proxy_user: str
     :param autoconfig: use snakebite's automatically configured client
diff --git a/airflow/hooks/hive_hooks.py b/airflow/hooks/hive_hooks.py
index c67dced7b1f87..2cf22a36498aa 100644
--- a/airflow/hooks/hive_hooks.py
+++ b/airflow/hooks/hive_hooks.py
@@ -314,13 +314,13 @@ def load_df(
         not be sanitized.
 
         :param df: DataFrame to load into a Hive table
-        :type df: DataFrame
+        :type df: pandas.DataFrame
         :param table: target Hive table, use dot notation to target a
             specific database
         :type table: str
         :param field_dict: mapping from column name to hive data type.
             Note that it must be OrderedDict so as to keep columns' order.
-        :type field_dict: OrderedDict
+        :type field_dict: collections.OrderedDict
         :param delimiter: field delimiter in the file
         :type delimiter: str
         :param encoding: str encoding to use when writing DataFrame to file
@@ -406,7 +406,7 @@ def load_file(
         :param field_dict: A dictionary of the fields name in the file
             as keys and their Hive types as values.
             Note that it must be OrderedDict so as to keep columns' order.
-        :type field_dict: OrderedDict
+        :type field_dict: collections.OrderedDict
         :param create: whether to create the table if it doesn't exist
         :type create: bool
         :param overwrite: whether to overwrite the data in table or partition
@@ -842,8 +842,8 @@ def get_results(self, hql, schema='default', fetch_size=None, hive_conf=None):
         :type hql: str or list
         :param schema: target schema, default to 'default'.
         :type schema: str
-        :param fetch_size max: size of result to fetch.
-        :type fetch_size_max: int
+        :param fetch_size: max size of result to fetch.
+        :type fetch_size: int
         :param hive_conf: hive_conf to execute alone with the hql.
         :type hive_conf: dict
         :return: results of hql execution, dict with data (list of results) and header
@@ -956,6 +956,8 @@ def get_pandas_df(self, hql, schema='default'):
         >>> df = hh.get_pandas_df(sql)
         >>> len(df.index)
         100
+
+        :return: pandas.DateFrame
         """
         import pandas as pd
         res = self.get_results(hql, schema=schema)
diff --git a/airflow/jobs.py b/airflow/jobs.py
index e01979073033f..634c0ba249c9e 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -232,9 +232,9 @@ def reset_state_for_orphaned_tasks(self, filter_by_dag_run=None, session=None):
         sequence.
 
         :param filter_by_dag_run: the dag_run we want to process, None if all
-        :type filter_by_dag_run: models.DagRun
+        :type filter_by_dag_run: airflow.models.DagRun
         :return: the TIs reset (in expired SQLAlchemy state)
-        :rtype: List(TaskInstance)
+        :rtype: list[airflow.models.TaskInstance]
         """
         queued_tis = self.executor.queued_tasks
         # also consider running as the state might not have changed in the db yet
@@ -315,7 +315,7 @@ def __init__(self, file_path, pickle_dags, dag_id_white_list, zombies):
         :param dag_id_whitelist: If specified, only look at these DAG ID's
         :type dag_id_whitelist: list[unicode]
         :param zombies: zombie task instances to kill
-        :type zombies: list[SimpleTaskInstance]
+        :type zombies: list[airflow.utils.dag_processing.SimpleTaskInstance]
         """
         self._file_path = file_path
         # Queue that's used to pass results from the child process.
@@ -365,7 +365,7 @@ def _launch_process(result_queue,
         :return: the process that was launched
         :rtype: multiprocessing.Process
         :param zombies: zombie task instances to kill
-        :type zombies: list[SimpleTaskInstance]
+        :type zombies: list[airflow.utils.dag_processing.SimpleTaskInstance]
         """
         def helper():
             # This helper runs in the newly created process
@@ -509,7 +509,7 @@ def done(self):
     def result(self):
         """
         :return: result of running SchedulerJob.process_file()
-        :rtype: SimpleDag
+        :rtype: airflow.utils.dag_processing.SimpleDag
         """
         if not self.done:
             raise AirflowException("Tried to get the result before it's done!")
@@ -757,7 +757,7 @@ def update_import_errors(session, dagbag):
         :param session: session for ORM operations
         :type session: sqlalchemy.orm.session.Session
         :param dagbag: DagBag containing DAGs with import errors
-        :type dagbag: models.Dagbag
+        :type dagbag: airflow.models.DagBag
         """
         # Clear the errors of the processed files
         for dagbag_file in dagbag.file_last_changed:
@@ -977,12 +977,12 @@ def _change_state_for_tis_without_dagrun(self,
         changed manually.
 
         :param old_states: examine TaskInstances in this state
-        :type old_state: list[State]
+        :type old_state: list[airflow.utils.state.State]
         :param new_state: set TaskInstances to this state
-        :type new_state: State
+        :type new_state: airflow.utils.state.State
         :param simple_dag_bag: TaskInstances associated with DAGs in the
             simple_dag_bag and with states in the old_state will be examined
-        :type simple_dag_bag: SimpleDagBag
+        :type simple_dag_bag: airflow.utils.dag_processing.SimpleDagBag
         """
         tis_changed = 0
         query = session \
@@ -1027,9 +1027,9 @@ def __get_task_concurrency_map(self, states, session=None):
         Returns a map from tasks to number in the states list given.
 
         :param states: List of states to query for
-        :type states: List[State]
+        :type states: list[airflow.utils.state.State]
         :return: A map from (dag_id, task_id) to count of tasks in states
-        :rtype: Dict[[String, String], Int]
+        :rtype: dict[tuple[str, str], int]
 
         """
         TI = models.TaskInstance
@@ -1053,12 +1053,12 @@ def _find_executable_task_instances(self, simple_dag_bag, states, session=None):
 
         :param simple_dag_bag: TaskInstances associated with DAGs in the
             simple_dag_bag will be fetched from the DB and executed
-        :type simple_dag_bag: SimpleDagBag
+        :type simple_dag_bag: airflow.utils.dag_processing.SimpleDagBag
         :param executor: the executor that runs task instances
         :type executor: BaseExecutor
         :param states: Execute TaskInstances in these states
-        :type states: Tuple[State]
-        :return: List[TaskInstance]
+        :type states: tuple[airflow.utils.state.State]
+        :return: list[airflow.models.TaskInstance]
         """
         executable_tis = []
 
@@ -1237,10 +1237,10 @@ def _change_state_for_executable_task_instances(self, task_instances,
         to QUEUED atomically, and returns the TIs changed in SimpleTaskInstance format.
 
         :param task_instances: TaskInstances to change the state of
-        :type task_instances: List[TaskInstance]
+        :type task_instances: list[airflow.models.TaskInstance]
         :param acceptable_states: Filters the TaskInstances updated to be in these states
         :type acceptable_states: Iterable[State]
-        :return: List[SimpleTaskInstance]
+        :rtype: list[airflow.utils.dag_processing.SimpleTaskInstance]
         """
         if len(task_instances) == 0:
             session.commit()
@@ -1302,9 +1302,9 @@ def _enqueue_task_instances_with_queued_state(self, simple_dag_bag,
         with the executor.
 
         :param simple_task_instances: TaskInstances to enqueue
-        :type simple_task_instances: List[SimpleTaskInstance]
+        :type simple_task_instances: list[SimpleTaskInstance]
         :param simple_dag_bag: Should contains all of the task_instances' dags
-        :type simple_dag_bag: SimpleDagBag
+        :type simple_dag_bag: airflow.utils.dag_processing.SimpleDagBag
         """
         TI = models.TaskInstance
         # actually enqueue them
@@ -1353,9 +1353,9 @@ def _execute_task_instances(self,
 
         :param simple_dag_bag: TaskInstances associated with DAGs in the
             simple_dag_bag will be fetched from the DB and executed
-        :type simple_dag_bag: SimpleDagBag
+        :type simple_dag_bag: airflow.utils.dag_processing.SimpleDagBag
         :param states: Execute TaskInstances in these states
-        :type states: Tuple[State]
+        :type states: tuple[airflow.utils.state.State]
         :return: Number of task instance with state changed.
         """
         executable_tis = self._find_executable_task_instances(simple_dag_bag, states,
@@ -1423,12 +1423,12 @@ def _process_dags(self, dagbag, dags, tis_out):
         3. Send emails for tasks that have missed SLAs.
 
         :param dagbag: a collection of DAGs to process
-        :type dagbag: models.DagBag
+        :type dagbag: airflow.models.DagBag
         :param dags: the DAGs from the DagBag to process
-        :type dags: DAG
+        :type dags: airflow.models.DAG
         :param tis_out: A queue to add generated TaskInstance objects
         :type tis_out: multiprocessing.Queue[TaskInstance]
-        :return: None
+        :rtype: None
         """
         for dag in dags:
             dag = dagbag.get_dag(dag.dag_id)
@@ -1551,7 +1551,7 @@ def _execute_helper(self):
 
         .. image:: ../docs/img/scheduler_loop.jpg
 
-        :return: None
+        :rtype: None
         """
         self.executor.start()
 
@@ -1700,12 +1700,12 @@ def process_file(self, file_path, zombies, pickle_dags=False, session=None):
         :param file_path: the path to the Python file that should be executed
         :type file_path: unicode
         :param zombies: zombie task instances to kill.
-        :type zombies: list[SimpleTaskInstance]
+        :type zombies: list[airflow.utils.dag_processing.SimpleTaskInstance]
         :param pickle_dags: whether serialize the DAGs found in the file and
             save them to the db
         :type pickle_dags: bool
         :return: a list of SimpleDags made from the Dags found in the file
-        :rtype: list[SimpleDag]
+        :rtype: list[airflow.utils.dag_processing.SimpleDagBag]
         """
         self.log.info("Processing file %s for tasks to queue", file_path)
         # As DAGs are parsed from this file, they will be converted into SimpleDags
@@ -1845,23 +1845,23 @@ def __init__(self,
                      ):
             """
             :param to_run: Tasks to run in the backfill
-            :type to_run: dict[Tuple[String, String, DateTime], TaskInstance]
+            :type to_run: dict[tuple[string, string, datetime.datetime], airflow.models.TaskInstance]
             :param running: Maps running task instance key to task instance object
-            :type running: dict[Tuple[String, String, DateTime], TaskInstance]
+            :type running: dict[tuple[string, string, datetime.datetime], airflow.models.TaskInstance]
             :param skipped: Tasks that have been skipped
-            :type skipped: set[Tuple[String, String, DateTime]]
+            :type skipped: set[tuple[string, string, datetime.datetime]]
             :param succeeded: Tasks that have succeeded so far
-            :type succeeded: set[Tuple[String, String, DateTime]]
+            :type succeeded: set[tuple[string, string, datetime.datetime]]
             :param failed: Tasks that have failed
-            :type failed: set[Tuple[String, String, DateTime]]
+            :type failed: set[tuple[string, string, datetime.datetime]]
             :param not_ready: Tasks not ready for execution
-            :type not_ready: set[Tuple[String, String, DateTime]]
+            :type not_ready: set[tuple[string, string, datetime.datetime]]
             :param deadlocked: Deadlocked tasks
-            :type deadlocked: set[Tuple[String, String, DateTime]]
+            :type deadlocked: set[tuple[string, string, datetime.datetime]]
             :param active_runs: Active dag runs at a certain point in time
             :type active_runs: list[DagRun]
             :param executed_dag_run_dates: Datetime objects for the executed dag runs
-            :type executed_dag_run_dates: set[Datetime]
+            :type executed_dag_run_dates: set[datetime.datetime]
             :param finished_runs: Number of finished runs so far
             :type finished_runs: int
             :param total_runs: Number of total dag runs able to run
@@ -1897,11 +1897,11 @@ def __init__(
             *args, **kwargs):
         """
         :param dag: DAG object.
-        :type dag: `class DAG`.
+        :type dag: airflow.models.DAG
         :param start_date: start date for the backfill date range.
-        :type start_date: datetime.
+        :type start_date: datetime.datetime
         :param end_date: end date for the backfill date range.
-        :type end_date: datetime
+        :type end_date: datetime.datetime
         :param mark_success: flag whether to mark the task auto success.
         :type mark_success: bool
         :param donot_pickle: whether pickle
@@ -2029,9 +2029,9 @@ def _get_dag_run(self, run_date, session=None):
         limit is reached, this function will return None.
 
         :param run_date: the execution date for the dag run
-        :type run_date: datetime
+        :type run_date: datetime.datetime
         :param session: the database session object
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :return: a DagRun in state RUNNING or None
         """
         run_id = BackfillJob.ID_FORMAT_PREFIX.format(run_date.isoformat())
@@ -2089,9 +2089,9 @@ def _task_instances_for_dag_run(self, dag_run, session=None):
         run in the given dag run.
 
         :param dag_run: the dag run to get the tasks from
-        :type dag_run: models.DagRun
+        :type dag_run: airflow.models.DagRun
         :param session: the database session object
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
         tasks_to_run = {}
 
@@ -2147,9 +2147,9 @@ def _process_backfill_task_instances(self,
         :param pickle_id: the pickle_id if dag is pickled, None otherwise
         :type pickle_id: int
         :param start_date: the start date of the backfill job
-        :type start_date: datetime
+        :type start_date: datetime.datetime
         :param session: the current session object
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :return: the list of execution_dates for the finished dag runs
         :rtype: list
         """
@@ -2402,9 +2402,9 @@ def _execute_for_run_dates(self, run_dates, ti_status, executor, pickle_id,
         :param pickle_id: numeric id of the pickled dag, None if not pickled
         :type pickle_id: int
         :param start_date: backfill start date
-        :type start_date: datetime
+        :type start_date: datetime.datetime
         :param session: the current session object
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
         for next_run_date in run_dates:
             dag_run = self._get_dag_run(next_run_date, session=session)
diff --git a/airflow/macros/hive.py b/airflow/macros/hive.py
index f8e57bb5156dd..914b9af2c4b1e 100644
--- a/airflow/macros/hive.py
+++ b/airflow/macros/hive.py
@@ -63,7 +63,7 @@ def _closest_date(target_dt, date_list, before_target=None):
     :param target_dt: The target date
     :type target_dt: datetime.date
     :param date_list: The list of dates to search
-    :type date_list: datetime.date list
+    :type date_list: list[datetime.date]
     :param before_target: closest before or after the target
     :type before_target: bool or None
     :returns: The closest date
@@ -90,7 +90,7 @@ def closest_ds_partition(
     :param table: A hive table name
     :type table: str
     :param ds: A datestamp ``%Y-%m-%d`` e.g. ``yyyy-mm-dd``
-    :type ds: datetime.date list
+    :type ds: list[datetime.date]
     :param before: closest before (True), after (False) or either side of ds
     :type before: bool or None
     :returns: The closest date
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index e552f89bc136a..9951f02e52002 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -151,7 +151,7 @@ def get_fernet():
     or because the Fernet key is invalid.
 
     :return: Fernet object
-    :raises: AirflowException if there's a problem trying to load Fernet
+    :raises: airflow.exceptions.AirflowException if there's a problem trying to load Fernet
     """
     global _fernet
     log = LoggingMixin().log
@@ -477,9 +477,9 @@ def kill_zombies(self, zombies, session=None):
         had a heartbeat for too long, in the current DagBag.
 
         :param zombies: zombie task instances to kill.
-        :type zombies: ``SimpleTaskInstance``
+        :type zombies: airflow.utils.dag_processing.SimpleTaskInstance
         :param session: DB session.
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
         for zombie in zombies:
             if zombie.dag_id in self.dags:
@@ -1126,7 +1126,7 @@ def are_dependencies_met(
             should be evaluated.
         :type dep_context: DepContext
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :param verbose: whether log details on failed dependencies on
             info or debug log level
         :type verbose: bool
@@ -2153,13 +2153,13 @@ class derived from this one results in the creation of a task object,
         failing the task
     :type retries: int
     :param retry_delay: delay between retries
-    :type retry_delay: timedelta
+    :type retry_delay: datetime.timedelta
     :param retry_exponential_backoff: allow progressive longer waits between
         retries by using exponential backoff algorithm on retry delay (delay
         will be converted into seconds)
     :type retry_exponential_backoff: bool
     :param max_retry_delay: maximum delay interval between retries
-    :type max_retry_delay: timedelta
+    :type max_retry_delay: datetime.timedelta
     :param start_date: The ``start_date`` for the task, determines
         the ``execution_date`` for the first task instance. The best practice
         is to have the start_date rounded
@@ -2176,9 +2176,9 @@ class derived from this one results in the creation of a task object,
         ``TimeSensor`` and ``TimeDeltaSensor``. We advise against using
         dynamic ``start_date`` and recommend using fixed ones. Read the
         FAQ entry about start_date for more information.
-    :type start_date: datetime
+    :type start_date: datetime.datetime
     :param end_date: if specified, the scheduler won't go beyond this date
-    :type end_date: datetime
+    :type end_date: datetime.datetime
     :param depends_on_past: when set to true, task instances will run
         sequentially while relying on the previous task's schedule to
         succeed. The task instance for the start_date is allowed to run.
@@ -2195,7 +2195,7 @@ class derived from this one results in the creation of a task object,
         does support targeting specific queues.
     :type queue: str
     :param dag: a reference to the dag the task is attached to (if any)
-    :type dag: DAG
+    :type dag: airflow.models.DAG
     :param priority_weight: priority weight of this task against other task.
         This allows the executor to trigger higher priority tasks before
         others when things get backed up.
@@ -3091,15 +3091,15 @@ def create_dagrun(self,
         :param run_id: defines the the run id for this dag run
         :type run_id: str
         :param execution_date: the execution date of this dag run
-        :type execution_date: datetime
+        :type execution_date: datetime.datetime
         :param state: the state of the dag run
-        :type state: State
+        :type state: airflow.utils.state.State
         :param start_date: the date this dag run should be evaluated
-        :type start_date: datetime
+        :type start_date: datetime.datetime
         :param external_trigger: whether this dag run is externally triggered
         :type external_trigger: bool
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
 
         return self.get_dag().create_dagrun(run_id=run_id,
@@ -3144,7 +3144,7 @@ class DAG(BaseDag, LoggingMixin):
         defines where jinja will look for your templates. Order matters.
         Note that jinja/airflow includes the path of your DAG file by
         default
-    :type template_searchpath: str or list of stings
+    :type template_searchpath: str or list[str]
     :param user_defined_macros: a dictionary of macros that will be exposed
         in your jinja templates. For example, passing ``dict(foo='bar')``
         to this argument allows you to ``{{ foo }}`` in all jinja
@@ -4146,9 +4146,9 @@ def run(
         Runs the DAG.
 
         :param start_date: the start date of the range to run
-        :type start_date: datetime
+        :type start_date: datetime.datetime
         :param end_date: the end date of the range to run
-        :type end_date: datetime
+        :type end_date: datetime.datetime
         :param mark_success: True to mark jobs as succeeded without running them
         :type mark_success: bool
         :param local: True to run the tasks using the LocalExecutor
@@ -4225,15 +4225,15 @@ def create_dagrun(self,
         :param run_id: defines the the run id for this dag run
         :type run_id: str
         :param execution_date: the execution date of this dag run
-        :type execution_date: datetime
+        :type execution_date: datetime.datetime
         :param state: the state of the dag run
-        :type state: State
+        :type state: airflow.utils.state.State
         :param start_date: the date this dag run should be evaluated
         :type start_date: datetime
         :param external_trigger: whether this dag run is externally triggered
         :type external_trigger: bool
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
         run = DagRun(
             dag_id=self.dag_id,
@@ -4268,7 +4268,7 @@ def sync_to_db(self, owner=None, sync_time=None, session=None):
         SubDagOperator.
 
         :param dag: the DAG object to save to the DB
-        :type dag: DAG
+        :type dag: airflow.models.DAG
         :param sync_time: The time that the DAG should be marked as sync'ed
         :type sync_time: datetime
         :return: None
@@ -4511,7 +4511,7 @@ def setdefault(cls, key, default, deserialize_json=False):
         for a key, and if it isn't there, stores the default value and returns it.
 
         :param key: Dict key for this Variable
-        :type key: String
+        :type key: str
         :param default: Default value to set and return if the variable
             isn't already in the DB
         :type default: Mixed
@@ -4962,16 +4962,16 @@ def find(dag_id=None, run_id=None, execution_date=None,
         :param run_id: defines the the run id for this dag run
         :type run_id: str
         :param execution_date: the execution date
-        :type execution_date: datetime
+        :type execution_date: datetime.datetime
         :param state: the state of the dag run
-        :type state: State
+        :type state: airflow.utils.state.State
         :param external_trigger: whether this dag run is externally triggered
         :type external_trigger: bool
         :param no_backfills: return no backfills (True), return all (False).
             Defaults to False
         :type no_backfills: bool
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
         DR = DagRun
 
diff --git a/airflow/operators/docker_operator.py b/airflow/operators/docker_operator.py
index cf9838593fe18..1d550cec8804a 100644
--- a/airflow/operators/docker_operator.py
+++ b/airflow/operators/docker_operator.py
@@ -59,9 +59,9 @@ class DockerOperator(BaseOperator):
         https://docs.docker.com/engine/reference/run/#cpu-share-constraint
     :type cpus: float
     :param dns: Docker custom DNS servers
-    :type dns: list of strings
+    :type dns: list[str]
     :param dns_search: Docker custom DNS search domain
-    :type dns_search: list of strings
+    :type dns_search: list[str]
     :param docker_url: URL of the host running the docker daemon.
         Default is unix://var/run/docker.sock
     :type docker_url: str
diff --git a/airflow/operators/generic_transfer.py b/airflow/operators/generic_transfer.py
index 7b1a64ee753d5..61d6692e5ff6b 100644
--- a/airflow/operators/generic_transfer.py
+++ b/airflow/operators/generic_transfer.py
@@ -41,7 +41,7 @@ class GenericTransfer(BaseOperator):
     :type destination_conn_id: str
     :param preoperator: sql statement or list of statements to be
         executed prior to loading the data. (templated)
-    :type preoperator: str or list of str
+    :type preoperator: str or list[str]
     """
 
     template_fields = ('sql', 'destination_table', 'preoperator')
diff --git a/airflow/operators/hive_to_druid.py b/airflow/operators/hive_to_druid.py
index ee924a0d2c32a..7c2fa19c033ed 100644
--- a/airflow/operators/hive_to_druid.py
+++ b/airflow/operators/hive_to_druid.py
@@ -48,7 +48,7 @@ class HiveToDruidTransfer(BaseOperator):
     :type metastore_conn_id: str
     :param hadoop_dependency_coordinates: list of coordinates to squeeze
         int the ingest json
-    :type hadoop_dependency_coordinates: list of str
+    :type hadoop_dependency_coordinates: list[str]
     :param intervals: list of time intervals that defines segments,
         this is passed as is to the json object. (templated)
     :type intervals: list
diff --git a/airflow/operators/mysql_operator.py b/airflow/operators/mysql_operator.py
index 2cc9b07e3478b..905a43d64b964 100644
--- a/airflow/operators/mysql_operator.py
+++ b/airflow/operators/mysql_operator.py
@@ -26,10 +26,11 @@ class MySqlOperator(BaseOperator):
     """
     Executes sql code in a specific MySQL database
 
-    :param sql: the sql code to be executed. (templated)
-    :type sql: Can receive a str representing a sql statement,
-        a list of str (sql statements), or reference to a template file.
+    :param sql: the sql code to be executed. Can receive a str representing a
+        sql statement, a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+        (templated)
+    :type sql: str or list[str]
     :param mysql_conn_id: reference to a specific mysql database
     :type mysql_conn_id: str
     :param parameters: (optional) the parameters to render the SQL query with.
diff --git a/airflow/operators/oracle_operator.py b/airflow/operators/oracle_operator.py
index 2d1a655f9a552..5cb62ef8a3455 100644
--- a/airflow/operators/oracle_operator.py
+++ b/airflow/operators/oracle_operator.py
@@ -26,10 +26,11 @@ class OracleOperator(BaseOperator):
     """
     Executes sql code in a specific Oracle database
 
-    :param sql: the sql code to be executed. (templated)
-    :type sql: Can receive a str representing a sql statement,
+    :param sql: the sql code to be executed. Can receive a str representing a sql statement,
         a list of str (sql statements), or reference to a template file.
         Template reference are recognized by str ending in '.sql'
+        (templated)
+    :type sql: str or list[str]
     :param oracle_conn_id: reference to a specific Oracle database
     :type oracle_conn_id: str
     :param parameters: (optional) the parameters to render the SQL query with.
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index a4a426879153e..845793bc3f980 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -57,10 +57,10 @@ class PythonOperator(BaseOperator):
         will get templated by the Airflow engine sometime between
         ``__init__`` and ``execute`` takes place and are made available
         in your callable's context after the template has been applied. (templated)
-    :type templates_dict: dict of str
+    :type templates_dict: dict[str]
     :param templates_exts: a list of file extensions to resolve while
         processing templated fields, for examples ``['.sql', '.hql']``
-    :type templates_exts: list(str)
+    :type templates_exts: list[str]
     """
     template_fields = ('templates_dict',)
     template_ext = tuple()
@@ -192,7 +192,7 @@ class PythonVirtualenvOperator(PythonOperator):
         defined with def, which will be run in a virtualenv
     :type python_callable: function
     :param requirements: A list of requirements as specified in a pip install command
-    :type requirements: list(str)
+    :type requirements: list[str]
     :param python_version: The Python version to run the virtualenv with. Note that
         both 2 and 2.7 are acceptable forms.
     :type python_version: str
@@ -215,9 +215,9 @@ class PythonVirtualenvOperator(PythonOperator):
         function header.
     :type provide_context: bool
     :param string_args: Strings that are present in the global var virtualenv_string_args,
-        available to python_callable at runtime as a list(str). Note that args are split
+        available to python_callable at runtime as a list[str]. Note that args are split
         by newline.
-    :type string_args: list(str)
+    :type string_args: list[str]
     :param templates_dict: a dictionary where the values are templates that
         will get templated by the Airflow engine sometime between
         ``__init__`` and ``execute`` takes place and are made available
@@ -225,7 +225,7 @@ class PythonVirtualenvOperator(PythonOperator):
     :type templates_dict: dict of str
     :param templates_exts: a list of file extensions to resolve while
         processing templated fields, for examples ``['.sql', '.hql']``
-    :type templates_exts: list(str)
+    :type templates_exts: list[str]
     """
     @apply_defaults
     def __init__(self, python_callable,
diff --git a/airflow/operators/subdag_operator.py b/airflow/operators/subdag_operator.py
index 90f17fcf6aa10..bdee51548d874 100644
--- a/airflow/operators/subdag_operator.py
+++ b/airflow/operators/subdag_operator.py
@@ -30,12 +30,12 @@ class SubDagOperator(BaseOperator):
     should be prefixed by its parent and a dot. As in `parent.child`.
 
     :param subdag: the DAG object to run as a subdag of the current DAG.
-    :type subdag: airflow.DAG.
+    :type subdag: airflow.models.DAG
     :param dag: the parent DAG for the subdag.
-    :type dag: airflow.DAG.
+    :type dag: airflow.models.DAG
     :param executor: the executor for this subdag. Default to use SequentialExecutor.
         Please find AIRFLOW-74 for more details.
-    :type executor: airflow.executors.
+    :type executor: airflow.executors.base_executor.BaseExecutor
     """
 
     template_fields = tuple()
diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index 9f338daed4541..531dab7d6c1b6 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -80,8 +80,8 @@ def load_entrypoint_plugins(entry_points, airflow_plugins):
     :type entry_points: Generator[setuptools.EntryPoint, None, None]
     :param airflow_plugins: A collection of existing airflow plugins to
         ensure we don't load duplicates
-    :type airflow_plugins: List[AirflowPlugin]
-    :return: List[Type[AirflowPlugin]]
+    :type airflow_plugins: list[type[airflow.plugins_manager.AirflowPlugin]]
+    :rtype: list[airflow.plugins_manager.AirflowPlugin]
     """
     for entry_point in entry_points:
         log.debug('Importing entry_point plugin %s', entry_point.name)
diff --git a/airflow/sensors/hdfs_sensor.py b/airflow/sensors/hdfs_sensor.py
index dbff9b2e1c6a9..bc3a3c63fd64e 100644
--- a/airflow/sensors/hdfs_sensor.py
+++ b/airflow/sensors/hdfs_sensor.py
@@ -80,10 +80,14 @@ def filter_for_ignored_ext(result, ignored_ext, ignore_copying):
         """
         Will filter if instructed to do so the result to remove matching criteria
 
-        :param result: (list) of dicts returned by Snakebite ls
-        :param ignored_ext: (list) of ignored extensions
-        :param ignore_copying: (bool) shall we ignore ?
-        :return: (list) of dicts which were not removed
+        :param result: list of dicts returned by Snakebite ls
+        :type result: list[dict]
+        :param ignored_ext: list of ignored extensions
+        :type ignored_ext: list
+        :param ignore_copying: shall we ignore ?
+        :type ignore_copying: bool
+        :return: list of dicts which were not removed
+        :rtype: list[dict]
         """
         if ignore_copying:
             log = LoggingMixin().log
diff --git a/airflow/sensors/named_hive_partition_sensor.py b/airflow/sensors/named_hive_partition_sensor.py
index 84b84d93a9c7d..6f25458965854 100644
--- a/airflow/sensors/named_hive_partition_sensor.py
+++ b/airflow/sensors/named_hive_partition_sensor.py
@@ -34,7 +34,7 @@ class NamedHivePartitionSensor(BaseSensorOperator):
         Thrift client ``get_partitions_by_name`` method. Note that
         you cannot use logical or comparison operators as in
         HivePartitionSensor.
-    :type partition_names: list of strings
+    :type partition_names: list[str]
     :param metastore_conn_id: reference to the metastore thrift service
         connection id
     :type metastore_conn_id: str
diff --git a/airflow/settings.py b/airflow/settings.py
index 8a78e5e87dd41..b7ccf6a033d5e 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -249,7 +249,7 @@ def configure_action_logging():
     """
     Any additional configuration (register callback) for airflow.utils.action_loggers
     module
-    :return: None
+    :rtype: None
     """
     pass
 
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index f946cf720e5e2..96b0e773fbe3c 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -44,7 +44,7 @@ class DepContext(object):
 
     :param deps: The context-specific dependencies that need to be evaluated for a
         task instance to run in this execution context.
-    :type deps: set(BaseTIDep)
+    :type deps: set(airflow.ti_deps.deps.base_ti_dep.BaseTIDep)
     :param flag_upstream_failed: This is a hack to generate the upstream_failed state
         creation while checking to see whether the task instance is runnable. It was the
         shortest path to add the feature. This is bad since this class should be pure (no
diff --git a/airflow/ti_deps/deps/base_ti_dep.py b/airflow/ti_deps/deps/base_ti_dep.py
index 90c156cb760b9..1be9bd7d67650 100644
--- a/airflow/ti_deps/deps/base_ti_dep.py
+++ b/airflow/ti_deps/deps/base_ti_dep.py
@@ -66,9 +66,9 @@ def _get_dep_statuses(self, ti, session, dep_context=None):
         representing if each of the passed in task's upstream tasks succeeded or not.
 
         :param ti: the task instance to get the dependency status for
-        :type ti: TaskInstance
+        :type ti: airflow.models.TaskInstance
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :param dep_context: the context for which this dependency should be evaluated for
         :type dep_context: DepContext
         """
@@ -81,9 +81,9 @@ def get_dep_statuses(self, ti, session, dep_context=None):
         checks for all dependencies.
 
         :param ti: the task instance to get the dependency status for
-        :type ti: TaskInstance
+        :type ti: airflow.models.TaskInstance
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :param dep_context: the context for which this dependency should be evaluated for
         :type dep_context: DepContext
         """
@@ -114,9 +114,9 @@ def is_met(self, ti, session, dep_context=None):
         passing.
 
         :param ti: the task instance to see if this dependency is met for
-        :type ti: TaskInstance
+        :type ti: airflow.models.TaskInstance
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :param dep_context: The context this dependency is being checked under that stores
             state that can be used by this dependency.
         :type dep_context: BaseDepContext
@@ -130,9 +130,9 @@ def get_failure_reasons(self, ti, session, dep_context=None):
         Returns an iterable of strings that explain why this dependency wasn't met.
 
         :param ti: the task instance to see if this dependency is met for
-        :type ti: TaskInstance
+        :type ti: airflow.models.TaskInstance
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         :param dep_context: The context this dependency is being checked under that stores
             state that can be used by this dependency.
         :type dep_context: BaseDepContext
diff --git a/airflow/ti_deps/deps/trigger_rule_dep.py b/airflow/ti_deps/deps/trigger_rule_dep.py
index f1d58d005791d..71994fc2e0946 100644
--- a/airflow/ti_deps/deps/trigger_rule_dep.py
+++ b/airflow/ti_deps/deps/trigger_rule_dep.py
@@ -103,7 +103,7 @@ def _evaluate_trigger_rule(
         rule was met.
 
         :param ti: the task instance to evaluate the trigger rule of
-        :type ti: TaskInstance
+        :type ti: airflow.models.TaskInstance
         :param successes: Number of successful upstream tasks
         :type successes: bool
         :param skipped: Number of skipped upstream tasks
@@ -120,7 +120,7 @@ def _evaluate_trigger_rule(
             path to add the feature
         :type flag_upstream_failed: bool
         :param session: database session
-        :type session: Session
+        :type session: sqlalchemy.orm.session.Session
         """
 
         TR = airflow.models.TriggerRule
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 3536e0992296b..61c4fb36f3d1f 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -62,7 +62,7 @@ class SimpleDag(BaseDag):
     def __init__(self, dag, pickle_id=None):
         """
         :param dag: the DAG
-        :type dag: DAG
+        :type dag: airflow.models.DAG
         :param pickle_id: ID associated with the pickled version of this DAG.
         :type pickle_id: unicode
         """
@@ -246,7 +246,7 @@ def __init__(self, simple_dags):
         Constructor.
 
         :param simple_dags: SimpleDag objects that should be in this
-        :type: list(SimpleDag)
+        :type list(airflow.utils.dag_processing.SimpleDagBag)
         """
         self.simple_dags = simple_dags
         self.dag_id_to_simple_dag = {}
@@ -268,7 +268,7 @@ def get_dag(self, dag_id):
         :type dag_id: unicode
         :return: if the given DAG ID exists in the bag, return the BaseDag
         corresponding to that ID. Otherwise, throw an Exception
-        :rtype: SimpleDag
+        :rtype: airflow.utils.dag_processing.SimpleDag
         """
         if dag_id not in self.dag_id_to_simple_dag:
             raise AirflowException("Unknown DAG ID {}".format(dag_id))
@@ -407,7 +407,7 @@ def done(self):
     def result(self):
         """
         :return: result of running SchedulerJob.process_file()
-        :rtype: list[SimpleDag]
+        :rtype: list[airflow.utils.dag_processing.SimpleDag]
         """
         raise NotImplementedError()
 
@@ -457,15 +457,15 @@ def __init__(self,
                  async_mode):
         """
         :param dag_directory: Directory where DAG definitions are kept. All
-        files in file_paths should be under this directory
+            files in file_paths should be under this directory
         :type dag_directory: unicode
         :param file_paths: list of file paths that contain DAG definitions
         :type file_paths: list[unicode]
         :param max_runs: The number of times to parse and schedule each file. -1
-        for unlimited.
+            for unlimited.
         :type max_runs: int
         :param processor_factory: function that creates processors for DAG
-        definition files. Arguments are (dag_definition_path, log_file_path)
+            definition files. Arguments are (dag_definition_path, log_file_path)
         :type processor_factory: (unicode, unicode, list) -> (AbstractDagFileProcessor)
         :param async_mode: Whether to start agent in async mode
         :type async_mode: bool
@@ -678,7 +678,7 @@ class DagFileProcessorManager(LoggingMixin):
     :type _file_path_queue: list[unicode]
     :type _processors: dict[unicode, AbstractDagFileProcessor]
     :type _last_runtime: dict[unicode, float]
-    :type _last_finish_time: dict[unicode, datetime]
+    :type _last_finish_time: dict[unicode, datetime.datetime]
     """
 
     def __init__(self,
@@ -692,18 +692,18 @@ def __init__(self,
                  async_mode=True):
         """
         :param dag_directory: Directory where DAG definitions are kept. All
-        files in file_paths should be under this directory
+            files in file_paths should be under this directory
         :type dag_directory: unicode
         :param file_paths: list of file paths that contain DAG definitions
         :type file_paths: list[unicode]
         :param max_runs: The number of times to parse and schedule each file. -1
-        for unlimited.
+            for unlimited.
         :type max_runs: int
         :param processor_factory: function that creates processors for DAG
-        definition files. Arguments are (dag_definition_path)
+            definition files. Arguments are (dag_definition_path)
         :type processor_factory: (unicode, unicode, list) -> (AbstractDagFileProcessor)
         :param signal_conn: connection to communicate signal with processor agent.
-        :type signal_conn: Connection
+        :type signal_conn: airflow.models.connection.Connection
         :param stat_queue: the queue to use for passing back parsing stat to agent.
         :type stat_queue: multiprocessing.Queue
         :param result_queue: the queue to use for passing back the result to agent.
@@ -780,7 +780,6 @@ def start(self):
         DAGs in parallel. By processing them in separate processes,
         we can get parallelism and isolation from potentially harmful
         user code.
-        :return:
         """
 
         self.log.info("Processing files using up to %s processes at a time ", self._parallelism)
@@ -909,7 +908,6 @@ def _refresh_dag_dir(self):
     def _print_stat(self):
         """
         Occasionally print out stats about how fast the files are getting processed
-        :return:
         """
         if ((timezone.utcnow() - self.last_stat_print_time).total_seconds() >
                 self.print_stats_interval):
@@ -921,6 +919,7 @@ def _print_stat(self):
     def clear_nonexistent_import_errors(self, session):
         """
         Clears import errors for files that no longer exist.
+
         :param session: session for ORM operations
         :type session: sqlalchemy.orm.session.Session
         """
@@ -935,6 +934,7 @@ def clear_nonexistent_import_errors(self, session):
     def _log_file_processing_stats(self, known_file_paths):
         """
         Print out stats about how files are getting processed.
+
         :param known_file_paths: a list of file paths that may contain Airflow
             DAG definitions
         :type known_file_paths: list[unicode]
@@ -1016,7 +1016,7 @@ def get_pid(self, file_path):
         :param file_path: the path to the file that's being processed
         :type file_path: unicode
         :return: the PID of the process processing the given file or None if
-        the specified file is not being processed
+            the specified file is not being processed
         :rtype: int
         """
         if file_path in self._processors:
@@ -1035,8 +1035,8 @@ def get_runtime(self, file_path):
         :param file_path: the path to the file that's being processed
         :type file_path: unicode
         :return: the current runtime (in seconds) of the process that's
-        processing the specified file or None if the file is not currently
-        being processed
+            processing the specified file or None if the file is not currently
+            being processed
         """
         if file_path in self._processors:
             return (timezone.utcnow() - self._processors[file_path].start_time)\
@@ -1048,7 +1048,7 @@ def get_last_runtime(self, file_path):
         :param file_path: the path to the file that was processed
         :type file_path: unicode
         :return: the runtime (in seconds) of the process of the last run, or
-        None if the file was never processed.
+            None if the file was never processed.
         :rtype: float
         """
         return self._last_runtime.get(file_path)
@@ -1058,7 +1058,7 @@ def get_last_finish_time(self, file_path):
         :param file_path: the path to the file that was processed
         :type file_path: unicode
         :return: the finish time of the process of the last run, or None if the
-        file was never processed.
+            file was never processed.
         :rtype: datetime
         """
         return self._last_finish_time.get(file_path)
@@ -1068,7 +1068,7 @@ def get_start_time(self, file_path):
         :param file_path: the path to the file that's being processed
         :type file_path: unicode
         :return: the start time of the process that's processing the
-        specified file or None if the file is not currently being processed
+            specified file or None if the file is not currently being processed
         :rtype: datetime
         """
         if file_path in self._processors:
@@ -1118,8 +1118,8 @@ def heartbeat(self):
         results from the finished processors.
 
         :return: a list of SimpleDags that were produced by processors that
-        have finished since the last time this was called
-        :rtype: list[SimpleDag]
+            have finished since the last time this was called
+        :rtype: list[airflow.utils.dag_processing.SimpleDag]
         """
         finished_processors = {}
         """:type : dict[unicode, AbstractDagFileProcessor]"""
diff --git a/airflow/utils/log/es_task_handler.py b/airflow/utils/log/es_task_handler.py
index 687e14b5e2830..3d4273cb5d4d3 100644
--- a/airflow/utils/log/es_task_handler.py
+++ b/airflow/utils/log/es_task_handler.py
@@ -87,7 +87,7 @@ def _read(self, ti, try_number, metadata=None):
         :param try_number: try_number of the task instance
         :param metadata: log metadata,
                          can be used for steaming log reading and auto-tailing.
-        :return a list of log documents and metadata.
+        :return: a list of log documents and metadata.
         """
         if not metadata:
             metadata = {'offset': 0}
diff --git a/airflow/utils/log/file_processor_handler.py b/airflow/utils/log/file_processor_handler.py
index 9ef7e8eafb0ac..fb7b2fad32013 100644
--- a/airflow/utils/log/file_processor_handler.py
+++ b/airflow/utils/log/file_processor_handler.py
@@ -131,7 +131,7 @@ def _init_file(self, filename):
         """
         Create log file and directory if required.
         :param filename: task instance object
-        :return relative log path of the given task instance
+        :return: relative log path of the given task instance
         """
         relative_path = self._render_filename(filename)
         full_path = os.path.join(self._get_log_directory(), relative_path)
diff --git a/airflow/utils/log/file_task_handler.py b/airflow/utils/log/file_task_handler.py
index 113bd254ad0b2..111f26c279cf0 100644
--- a/airflow/utils/log/file_task_handler.py
+++ b/airflow/utils/log/file_task_handler.py
@@ -171,7 +171,7 @@ def _init_file(self, ti):
         """
         Create log directory and give it correct permissions.
         :param ti: task instance object
-        :return relative log path of the given task instance
+        :return: relative log path of the given task instance
         """
         # To handle log writing when tasks are impersonated, the log files need to
         # be writable by the user that runs the Airflow command and the user
diff --git a/airflow/utils/operator_helpers.py b/airflow/utils/operator_helpers.py
index e981941d84fea..e015f1d5ef072 100644
--- a/airflow/utils/operator_helpers.py
+++ b/airflow/utils/operator_helpers.py
@@ -41,7 +41,7 @@ def context_to_airflow_vars(context, in_env_var_format=False):
     :type context: dict
     :param in_env_var_format: If returned vars should be in ABC_DEF_GHI format.
     :type in_env_var_format: bool
-    :return task_instance context as dict.
+    :return: task_instance context as dict.
     """
     params = dict()
     if in_env_var_format:
diff --git a/airflow/www_rbac/security.py b/airflow/www_rbac/security.py
index e06e2106394b4..18a9c447b66a4 100644
--- a/airflow/www_rbac/security.py
+++ b/airflow/www_rbac/security.py
@@ -247,10 +247,14 @@ def has_access(self, permission, view_name, user=None):
         Verify whether a given user could perform certain permission
         (e.g can_read, can_write) on the given dag_id.
 
-        :param str permission: permission on dag_id(e.g can_read, can_edit).
-        :param str view_name: name of view-menu(e.g dag id is a view-menu as well).
-        :param str user: user name
+        :param permission: permission on dag_id(e.g can_read, can_edit).
+        :type permission: str
+        :param view_name: name of view-menu(e.g dag id is a view-menu as well).
+        :type permission: str
+        :param user: user name
+        :type permission: str
         :return: a bool whether user could perform certain permission on the dag_id.
+        :rtype bool
         """
         if not user:
             user = g.user
@@ -320,9 +324,10 @@ def _merge_perm(self, permission_name, view_menu_name):
         It will add the related entry to ab_permission
         and ab_view_menu two meta tables as well.
 
-        :param str permission_name: Name of the permission.
-        :param str view_menu_name: Name of the view-menu
-
+        :param permission_name: Name of the permission.
+        :type permission_name: str
+        :param view_menu_name: Name of the view-menu
+        :type view_menu_name: str
         :return:
         """
         permission = self.find_permission(permission_name)
diff --git a/docs/code.rst b/docs/code.rst
index 0f1968c09d562..fe24e2ad5d2e3 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -544,6 +544,8 @@ Executors are the mechanism by which task instances get run.
 .. autoclass:: airflow.executors.celery_executor.CeleryExecutor
 .. autoclass:: airflow.executors.local_executor.LocalExecutor
 .. autoclass:: airflow.executors.sequential_executor.SequentialExecutor
+.. autoclass:: airflow.executors.dask_executor.DaskExecutor
+
 
 Community-contributed executors
 '''''''''''''''''''''''''''''''
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 0fa6124fe50a1..ff2124f31444d 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -131,16 +131,23 @@ described elsewhere in this document.
 
 Airflow provides operators for many common tasks, including:
 
-- ``BashOperator`` - executes a bash command
-- ``PythonOperator`` - calls an arbitrary Python function
-- ``EmailOperator`` - sends an email
-- ``SimpleHttpOperator`` - sends an HTTP request
-- ``MySqlOperator``, ``SqliteOperator``, ``PostgresOperator``, ``MsSqlOperator``, ``OracleOperator``, ``JdbcOperator``, etc. - executes a SQL command
+- :class:`airflow.operators.bash_operator.BashOperator` - executes a bash command
+- :class:`airflow.operators.python_operator.PythonOperator` - calls an arbitrary Python function
+- :class:`airflow.operators.email_operator.EmailOperator` - sends an email
+- :class:`airflow.operators.http_operator.SimpleHttpOperator` - sends an HTTP request
+- :class:`airflow.operators.mysql_operator.MySqlOperator`,
+  :class:`airflow.operators.sqlite_operator.SqliteOperator`,
+  :class:`airflow.operators.postgres_operator.PostgresOperator`,
+  :class:`airflow.operators.mssql_operator.MsSqlOperator`,
+  :class:`airflow.operators.oracle_operator.OracleOperator`,
+  :class:`airflow.operators.jdbc_operator.JdbcOperator`, etc. - executes a SQL command
 - ``Sensor`` - waits for a certain time, file, database row, S3 key, etc...
 
 In addition to these basic building blocks, there are many more specific
-operators: ``DockerOperator``, ``HiveOperator``, ``S3FileTransformOperator``,
-``PrestoToMysqlOperator``, ``SlackOperator``... you get the idea!
+operators: :class:`airflow.operators.docker_operator.DockerOperator`,
+:class:`airflow.operators.hive_operator.HiveOperator`, :class:`airflow.operators.s3_file_transform_operator.S3FileTransformOperator(`,
+:class:`airflow.operators.presto_to_mysql.PrestoToMySqlTransfer`,
+:class:`airflow.operators.slack_operator.SlackAPIOperator`... you get the idea!
 
 The ``airflow/contrib/`` directory contains yet more operators built by the
 community. These operators aren't always as complete or well-tested as those in
diff --git a/docs/conf.py b/docs/conf.py
index cf31d5e57ded5..c6cac01770932 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -52,6 +52,7 @@
     'cloudant',
     'cx_Oracle',
     'datadog',
+    'distributed',
     'docker',
     'google',
     'google_auth_httplib2',
@@ -185,7 +186,14 @@
 
 
 intersphinx_mapping = {
-    'boto3': ('https://boto3.amazonaws.com/v1/documentation/api/latest', None),
+    'boto3': ('https://boto3.amazonaws.com/v1/documentation/api/latest/', None),
+    'google-cloud-python': (
+        'https://googleapis.github.io/google-cloud-python/latest/', None),
+    'mongodb': ('https://api.mongodb.com/python/current/', None),
+    'pandas': ('https://pandas.pydata.org/pandas-docs/stable/', None),
+    'python': ('https://docs.python.org/3/', None),
+    'requests': ('http://docs.python-requests.org/en/master/', None),
+    'sqlalchemy': ('https://docs.sqlalchemy.org/en/latest/', None),
 }
 
 # -- Options for HTML output ----------------------------------------------
diff --git a/docs/howto/executor/use-dask.rst b/docs/howto/executor/use-dask.rst
index 6d3efcb349a76..08e923af022a8 100644
--- a/docs/howto/executor/use-dask.rst
+++ b/docs/howto/executor/use-dask.rst
@@ -18,7 +18,7 @@
 Scaling Out with Dask
 =====================
 
-``DaskExecutor`` allows you to run Airflow tasks in a Dask Distributed cluster.
+:class:`airflow.executors.dask_executor.DaskExecutor` allows you to run Airflow tasks in a Dask Distributed cluster.
 
 Dask clusters can be run on a single machine or on remote networks. For complete
 details, consult the `Distributed documentation <https://distributed.readthedocs.io/>`_.
@@ -39,7 +39,7 @@ Next start at least one Worker on any machine that can connect to the host:
 
     dask-worker $DASK_HOST:$DASK_PORT
 
-Edit your ``airflow.cfg`` to set your executor to ``DaskExecutor`` and provide
+Edit your ``airflow.cfg`` to set your executor to :class:`airflow.executors.dask_executor.DaskExecutor` and provide
 the Dask Scheduler address in the ``[dask]`` section.
 
 Please note:
diff --git a/docs/howto/executor/use-mesos.rst b/docs/howto/executor/use-mesos.rst
index d67579ddcb96b..1cbe268298c93 100644
--- a/docs/howto/executor/use-mesos.rst
+++ b/docs/howto/executor/use-mesos.rst
@@ -26,7 +26,7 @@ There are two ways you can run airflow as a mesos framework:
 Tasks executed directly on mesos slaves
 ---------------------------------------
 
-``MesosExecutor`` allows you to schedule airflow tasks on a Mesos cluster.
+:class:`airflow.contrib.executors.mesos_executor.MesosExecutor` allows you to schedule airflow tasks on a Mesos cluster.
 For this to work, you need a running mesos cluster and you must perform the following
 steps -
 
@@ -57,7 +57,7 @@ You can now see the airflow framework and corresponding tasks in mesos UI.
 The logs for airflow tasks can be seen in airflow UI as usual.
 
 For more information about mesos, refer to `mesos documentation <http://mesos.apache.org/documentation/latest/>`_.
-For any queries/bugs on `MesosExecutor`, please contact `@kapil-malik <https://github.com/kapil-malik>`_.
+For any queries/bugs on :class:`airflow.contrib.executors.mesos_executor.MesosExecutor`, please contact `@kapil-malik <https://github.com/kapil-malik>`_.
 
 Tasks executed in containers on mesos slaves
 --------------------------------------------
diff --git a/docs/installation.rst b/docs/installation.rst
index ad704c7dceebb..4a8a9322d7231 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -47,77 +47,77 @@ these extra dependencies.
 
 Here's the list of the subpackages and what they enable:
 
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| subpackage          | install command                                     | enables                                         |
-+=====================+=====================================================+=================================================+
-| all                 | ``pip install 'apache-airflow[all]'``               | All Airflow features known to man               |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| all_dbs             | ``pip install 'apache-airflow[all_dbs]'``           | All databases integrations                      |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| async               | ``pip install 'apache-airflow[async]'``             | Async worker classes for Gunicorn               |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| celery              | ``pip install 'apache-airflow[celery]'``            | CeleryExecutor                                  |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| cloudant            | ``pip install 'apache-airflow[cloudant]'``          | Cloudant hook                                   |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| crypto              | ``pip install 'apache-airflow[crypto]'``            | Encrypt connection passwords in metadata db     |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| devel               | ``pip install 'apache-airflow[devel]'``             | Minimum dev tools requirements                  |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| devel_hadoop        | ``pip install 'apache-airflow[devel_hadoop]'``      | Airflow + dependencies on the Hadoop stack      |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| druid               | ``pip install 'apache-airflow[druid]'``             | Druid related operators & hooks                 |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| gcp_api             | ``pip install 'apache-airflow[gcp_api]'``           | Google Cloud Platform hooks and operators       |
-|                     |                                                     | (using ``google-api-python-client``)            |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| github_enterprise   | ``pip install 'apache-airflow[github_enterprise]'`` | GitHub Enterprise auth backend                  |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| google_auth         | ``pip install 'apache-airflow[google_auth]'``       | Google auth backend                             |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| hdfs                | ``pip install 'apache-airflow[hdfs]'``              | HDFS hooks and operators                        |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| hive                | ``pip install 'apache-airflow[hive]'``              | All Hive related operators                      |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| jdbc                | ``pip install 'apache-airflow[jdbc]'``              | JDBC hooks and operators                        |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| kerberos            | ``pip install 'apache-airflow[kerberos]'``          | Kerberos integration for Kerberized Hadoop      |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| kubernetes          | ``pip install 'apache-airflow[kubernetes]'``        | Kubernetes Executor and operator                |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| ldap                | ``pip install 'apache-airflow[ldap]'``              | LDAP authentication for users                   |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| mssql               | ``pip install 'apache-airflow[mssql]'``             | Microsoft SQL Server operators and hook,        |
-|                     |                                                     | support as an Airflow backend                   |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| mysql               | ``pip install 'apache-airflow[mysql]'``             | MySQL operators and hook, support as an Airflow |
-|                     |                                                     | backend. The version of MySQL server has to be  |
-|                     |                                                     | 5.6.4+. The exact version upper bound depends   |
-|                     |                                                     | on version of ``mysqlclient`` package. For      |
-|                     |                                                     | example, ``mysqlclient`` 1.3.12 can only be     |
-|                     |                                                     | used with MySQL server 5.6.4 through 5.7.       |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| password            | ``pip install 'apache-airflow[password]'``          | Password authentication for users               |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| postgres            | ``pip install 'apache-airflow[postgres]'``          | PostgreSQL operators and hook, support as an    |
-|                     |                                                     | Airflow backend                                 |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| qds                 | ``pip install 'apache-airflow[qds]'``               | Enable QDS (Qubole Data Service) support        |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| rabbitmq            | ``pip install 'apache-airflow[rabbitmq]'``          | RabbitMQ support as a Celery backend            |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| redis               | ``pip install 'apache-airflow[redis]'``             | Redis hooks and sensors                         |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| s3                  | ``pip install 'apache-airflow[s3]'``                | ``S3KeySensor``, ``S3PrefixSensor``             |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| samba               | ``pip install 'apache-airflow[samba]'``             | ``Hive2SambaOperator``                          |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| slack               | ``pip install 'apache-airflow[slack]'``             | ``SlackAPIPostOperator``                        |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| ssh                 | ``pip install 'apache-airflow[ssh]'``               | SSH hooks and Operator                          |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
-| vertica             | ``pip install 'apache-airflow[vertica]'``           | Vertica hook support as an Airflow backend      |
-+---------------------+-----------------------------------------------------+-------------------------------------------------+
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| subpackage          | install command                                     | enables                                                              |
++=====================+=====================================================+======================================================================+
+| all                 | ``pip install 'apache-airflow[all]'``               | All Airflow features known to man                                    |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| all_dbs             | ``pip install 'apache-airflow[all_dbs]'``           | All databases integrations                                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| async               | ``pip install 'apache-airflow[async]'``             | Async worker classes for Gunicorn                                    |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| celery              | ``pip install 'apache-airflow[celery]'``            | CeleryExecutor                                                       |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| cloudant            | ``pip install 'apache-airflow[cloudant]'``          | Cloudant hook                                                        |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| crypto              | ``pip install 'apache-airflow[crypto]'``            | Encrypt connection passwords in metadata db                          |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| devel               | ``pip install 'apache-airflow[devel]'``             | Minimum dev tools requirements                                       |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| devel_hadoop        | ``pip install 'apache-airflow[devel_hadoop]'``      | Airflow + dependencies on the Hadoop stack                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| druid               | ``pip install 'apache-airflow[druid]'``             | Druid related operators & hooks                                      |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| gcp_api             | ``pip install 'apache-airflow[gcp_api]'``           | Google Cloud Platform hooks and operators                            |
+|                     |                                                     | (using ``google-api-python-client``)                                 |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| github_enterprise   | ``pip install 'apache-airflow[github_enterprise]'`` | GitHub Enterprise auth backend                                       |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| google_auth         | ``pip install 'apache-airflow[google_auth]'``       | Google auth backend                                                  |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| hdfs                | ``pip install 'apache-airflow[hdfs]'``              | HDFS hooks and operators                                             |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| hive                | ``pip install 'apache-airflow[hive]'``              | All Hive related operators                                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| jdbc                | ``pip install 'apache-airflow[jdbc]'``              | JDBC hooks and operators                                             |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| kerberos            | ``pip install 'apache-airflow[kerberos]'``          | Kerberos integration for Kerberized Hadoop                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| kubernetes          | ``pip install 'apache-airflow[kubernetes]'``        | Kubernetes Executor and operator                                     |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| ldap                | ``pip install 'apache-airflow[ldap]'``              | LDAP authentication for users                                        |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| mssql               | ``pip install 'apache-airflow[mssql]'``             | Microsoft SQL Server operators and hook,                             |
+|                     |                                                     | support as an Airflow backend                                        |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| mysql               | ``pip install 'apache-airflow[mysql]'``             | MySQL operators and hook, support as an Airflow                      |
+|                     |                                                     | backend. The version of MySQL server has to be                       |
+|                     |                                                     | 5.6.4+. The exact version upper bound depends                        |
+|                     |                                                     | on version of ``mysqlclient`` package. For                           |
+|                     |                                                     | example, ``mysqlclient`` 1.3.12 can only be                          |
+|                     |                                                     | used with MySQL server 5.6.4 through 5.7.                            |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| password            | ``pip install 'apache-airflow[password]'``          | Password authentication for users                                    |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| postgres            | ``pip install 'apache-airflow[postgres]'``          | PostgreSQL operators and hook, support as an                         |
+|                     |                                                     | Airflow backend                                                      |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| qds                 | ``pip install 'apache-airflow[qds]'``               | Enable QDS (Qubole Data Service) support                             |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| rabbitmq            | ``pip install 'apache-airflow[rabbitmq]'``          | RabbitMQ support as a Celery backend                                 |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| redis               | ``pip install 'apache-airflow[redis]'``             | Redis hooks and sensors                                              |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| s3                  | ``pip install 'apache-airflow[s3]'``                | ``S3KeySensor``, ``S3PrefixSensor``                                  |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| samba               | ``pip install apache-airflow[samba]'``              | :class:`airflow.operators.hive_to_samba_operator.Hive2SambaOperator` |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| slack               | ``pip install 'apache-airflow[slack']``             | :class:`airflow.operators.slack_operator.SlackAPIOperator`           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| ssh                 | ``pip install 'apache-airflow[ssh]'``               | SSH hooks and Operator                                               |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| vertica             | ``pip install 'apache-airflow[vertica]'``           | Vertica hook support as an Airflow backend                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
 
 Initiating Airflow Database
 '''''''''''''''''''''''''''
diff --git a/docs/scheduler.rst b/docs/scheduler.rst
index 25e14cb4a387f..4d99e100b060f 100644
--- a/docs/scheduler.rst
+++ b/docs/scheduler.rst
@@ -39,9 +39,9 @@ has ended.
 start date, at the END of the period.
 
 The scheduler starts an instance of the executor specified in the your
-``airflow.cfg``. If it happens to be the ``LocalExecutor``, tasks will be
-executed as subprocesses; in the case of ``CeleryExecutor`` and
-``MesosExecutor``, tasks are executed remotely.
+``airflow.cfg``. If it happens to be the :class:`airflow.contrib.executors.local_executor.LocalExecutor`, tasks will be
+executed as subprocesses; in the case of :class:`airflow.executors.celery_executor.CeleryExecutor`, :class:`airflow.executors.dask_executor.DaskExecutor``, and
+:class:`airflow.contrib.executors.mesos_executor.MesosExecutor`, tasks are executed remotely.
 
 To start a scheduler, simply run the command:
 
diff --git a/docs/start.rst b/docs/start.rst
index e3b16b28f7fab..620cc4dc12094 100644
--- a/docs/start.rst
+++ b/docs/start.rst
@@ -50,7 +50,7 @@ if started by systemd.
 
 Out of the box, Airflow uses a sqlite database, which you should outgrow
 fairly quickly since no parallelization is possible using this database
-backend. It works in conjunction with the ``SequentialExecutor`` which will
+backend. It works in conjunction with the :class:`airflow.executors.sequential_executor.SequentialExecutor` which will
 only run task instances sequentially. While this is very limiting, it allows
 you to get up and running quickly and take a tour of the UI and the
 command line utilities.

From e65321337a595fe0d070a5560a09d8361135b5f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 8 Feb 2019 11:22:48 +0100
Subject: [PATCH 705/808] [AIRFLOW-XXX] Add backreference in docs between
 operator and integration (#4671)

---
 .../operators/gcp_bigtable_operator.py        | 24 ++++++++
 .../contrib/operators/gcp_compute_operator.py | 20 +++++++
 .../operators/gcp_function_operator.py        |  8 +++
 .../contrib/operators/gcp_spanner_operator.py | 20 +++++++
 airflow/contrib/operators/gcp_sql_operator.py | 36 ++++++++++++
 airflow/contrib/operators/gcs_acl_operator.py |  8 +++
 airflow/contrib/operators/gcs_to_bq.py        |  4 ++
 airflow/operators/bash_operator.py            |  4 ++
 airflow/operators/python_operator.py          |  4 ++
 docs/howto/operator.rst                       | 57 ++++++++++++++++++-
 10 files changed, 183 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/operators/gcp_bigtable_operator.py b/airflow/contrib/operators/gcp_bigtable_operator.py
index e100af12ad748..48fd632de024d 100644
--- a/airflow/contrib/operators/gcp_bigtable_operator.py
+++ b/airflow/contrib/operators/gcp_bigtable_operator.py
@@ -51,6 +51,10 @@ class BigtableInstanceCreateOperator(BaseOperator, BigtableValidationMixin):
     For more details about instance creation have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.create
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableInstanceCreateOperator`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance to create.
     :type main_cluster_id: str
@@ -157,6 +161,10 @@ class BigtableInstanceDeleteOperator(BaseOperator, BigtableValidationMixin):
     For more details about deleting instance have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/instance.html#google.cloud.bigtable.instance.Instance.delete
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableInstanceDeleteOperator`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance to delete.
     :param project_id: Optional, the ID of the GCP project.  If set to None or missing,
@@ -199,6 +207,10 @@ class BigtableTableCreateOperator(BaseOperator, BigtableValidationMixin):
     For more details about creating table have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.create
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableTableCreateOperator`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance that will
         hold the new table.
@@ -290,6 +302,10 @@ class BigtableTableDeleteOperator(BaseOperator, BigtableValidationMixin):
     For more details about deleting table have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.delete
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableTableDeleteOperator`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type table_id: str
@@ -348,6 +364,10 @@ class BigtableClusterUpdateOperator(BaseOperator, BigtableValidationMixin):
     have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/cluster.html#google.cloud.bigtable.cluster.Cluster.update
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableClusterUpdateOperator`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type cluster_id: str
@@ -405,6 +425,10 @@ class BigtableTableWaitForReplicationSensor(BaseSensorOperator, BigtableValidati
     For more details about cluster states for a table, have a look at the reference:
     https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html#google.cloud.bigtable.table.Table.get_cluster_states
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BigtableTableWaitForReplicationSensor`
+
     :type instance_id: str
     :param instance_id: The ID of the Cloud Bigtable instance.
     :type table_id: str
diff --git a/airflow/contrib/operators/gcp_compute_operator.py b/airflow/contrib/operators/gcp_compute_operator.py
index c7dc9f315f73f..23c339bf32842 100644
--- a/airflow/contrib/operators/gcp_compute_operator.py
+++ b/airflow/contrib/operators/gcp_compute_operator.py
@@ -67,6 +67,10 @@ class GceInstanceStartOperator(GceBaseOperator):
     """
     Starts an instance in Google Compute Engine.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GceInstanceStartOperator`
+
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
@@ -110,6 +114,10 @@ class GceInstanceStopOperator(GceBaseOperator):
     """
     Stops an instance in Google Compute Engine.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GceInstanceStopOperator`
+
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
@@ -159,6 +167,10 @@ class GceSetMachineTypeOperator(GceBaseOperator):
     Changes the machine type for a stopped instance to the machine type specified in
         the request.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GceSetMachineTypeOperator`
+
     :param zone: Google Cloud Platform zone where the instance exists.
     :type zone: str
     :param resource_id: Name of the Compute Engine instance resource.
@@ -267,6 +279,10 @@ class GceInstanceTemplateCopyOperator(GceBaseOperator):
     """
     Copies the instance template, applying specified changes.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GceInstanceTemplateCopyOperator`
+
     :param resource_id: Name of the Instance Template
     :type resource_id: str
     :param body_patch: Patch to the body of instanceTemplates object following rfc7386
@@ -373,6 +389,10 @@ class GceInstanceGroupManagerUpdateTemplateOperator(GceBaseOperator):
     destination one. API V1 does not have update/patch operations for Instance
     Group Manager, so you must use beta or newer API version. Beta is the default.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GceInstanceGroupManagerUpdateTemplateOperator`
+
     :param resource_id: Name of the Instance Group Manager
     :type resource_id: str
     :param zone: Google Cloud Platform zone where the Instance Group Manager exists.
diff --git a/airflow/contrib/operators/gcp_function_operator.py b/airflow/contrib/operators/gcp_function_operator.py
index 420fd12bff0d7..5fc3b82794b80 100644
--- a/airflow/contrib/operators/gcp_function_operator.py
+++ b/airflow/contrib/operators/gcp_function_operator.py
@@ -83,6 +83,10 @@ class GcfFunctionDeployOperator(BaseOperator):
     Creates a function in Google Cloud Functions.
     If a function with this name already exists, it will be updated.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcfFunctionDeployOperator`
+
     :param location: Google Cloud Platform region where the function should be created.
     :type location: str
     :param body: Body of the Cloud Functions definition. The body must be a
@@ -274,6 +278,10 @@ class GcfFunctionDeleteOperator(BaseOperator):
     """
     Deletes the specified function from Google Cloud Functions.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcfFunctionDeleteOperator`
+
     :param name: A fully-qualified function name, matching
         the pattern: `^projects/[^/]+/locations/[^/]+/functions/[^/]+$`
     :type name: str
diff --git a/airflow/contrib/operators/gcp_spanner_operator.py b/airflow/contrib/operators/gcp_spanner_operator.py
index f78fcbde3211c..bea4f676e3ccc 100644
--- a/airflow/contrib/operators/gcp_spanner_operator.py
+++ b/airflow/contrib/operators/gcp_spanner_operator.py
@@ -98,6 +98,10 @@ class CloudSpannerInstanceDeleteOperator(BaseOperator):
     Deletes a Cloud Spanner instance. If an instance does not exist,
     no action is taken and the operator succeeds.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSpannerInstanceDeleteOperator`
+
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param project_id: Optional, the ID of the project that owns the Cloud Spanner
@@ -144,6 +148,10 @@ class CloudSpannerInstanceDatabaseQueryOperator(BaseOperator):
     """
     Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSpannerInstanceDatabaseQueryOperator`
+
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
@@ -216,6 +224,10 @@ class CloudSpannerInstanceDatabaseDeployOperator(BaseOperator):
     Creates a new Cloud Spanner database, or if database exists,
     the operator does nothing.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSpannerInstanceDatabaseDeployOperator`
+
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
@@ -283,6 +295,10 @@ class CloudSpannerInstanceDatabaseUpdateOperator(BaseOperator):
     """
     Updates a Cloud Spanner database with the specified DDL statement.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSpannerInstanceDatabaseUpdateOperator`
+
     :param instance_id: The Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: The Cloud Spanner database ID.
@@ -357,6 +373,10 @@ class CloudSpannerInstanceDatabaseDeleteOperator(BaseOperator):
     """
     Deletes a Cloud Spanner database.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSpannerInstanceDatabaseDeleteOperator`
+
     :param instance_id: Cloud Spanner instance ID.
     :type instance_id: str
     :param database_id: Cloud Spanner database ID.
diff --git a/airflow/contrib/operators/gcp_sql_operator.py b/airflow/contrib/operators/gcp_sql_operator.py
index ece91cf40456f..cdce4baa7591b 100644
--- a/airflow/contrib/operators/gcp_sql_operator.py
+++ b/airflow/contrib/operators/gcp_sql_operator.py
@@ -205,6 +205,10 @@ class CloudSqlInstanceCreateOperator(CloudSqlBaseOperator):
     If an instance with the same name exists, no action will be taken and
     the operator will succeed.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceCreateOperator`
+
     :param body: Body required by the Cloud SQL insert API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert
         #request-body
@@ -278,6 +282,10 @@ class CloudSqlInstancePatchOperator(CloudSqlBaseOperator):
     to the rules of patch semantics.
     https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstancePatchOperator`
+
     :param body: Body required by the Cloud SQL patch API, as described in
         https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch#request-body
     :type body: dict
@@ -329,6 +337,10 @@ class CloudSqlInstanceDeleteOperator(CloudSqlBaseOperator):
     """
     Deletes a Cloud SQL instance.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceDeleteOperator`
+
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
     :param project_id: Optional, Google Cloud Platform Project ID. If set to None or missing,
@@ -369,6 +381,10 @@ class CloudSqlInstanceDatabaseCreateOperator(CloudSqlBaseOperator):
     """
     Creates a new database inside a Cloud SQL instance.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceDatabaseCreateOperator`
+
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
@@ -438,6 +454,10 @@ class CloudSqlInstanceDatabasePatchOperator(CloudSqlBaseOperator):
     instance using patch semantics.
     See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceDatabasePatchOperator`
+
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param database: Name of the database to be updated in the instance.
@@ -507,6 +527,10 @@ class CloudSqlInstanceDatabaseDeleteOperator(CloudSqlBaseOperator):
     """
     Deletes a database from a Cloud SQL instance.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceDatabaseDeleteOperator`
+
     :param instance: Database instance ID. This does not include the project ID.
     :type instance: str
     :param database: Name of the database to be deleted in the instance.
@@ -563,6 +587,10 @@ class CloudSqlInstanceExportOperator(CloudSqlBaseOperator):
     Note: This operator is idempotent. If executed multiple times with the same
     export file URI, the export file in GCS will simply be overridden.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceImportOperator`
+
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
@@ -635,6 +663,10 @@ class CloudSqlInstanceImportOperator(CloudSqlBaseOperator):
     If the import file was generated in a different way, idempotence is not guaranteed.
     It has to be ensured on the SQL file level.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlInstanceImportOperator`
+
     :param instance: Cloud SQL instance ID. This does not include the project ID.
     :type instance: str
     :param body: The request body, as described in
@@ -692,6 +724,10 @@ class CloudSqlQueryOperator(BaseOperator):
     Performs DML or DDL query on an existing Cloud Sql instance. It optionally uses
     cloud-sql-proxy to establish secure connection with the database.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudSqlQueryOperator`
+
     :param sql: SQL query or list of queries to run (should be DML or DDL query -
         this operator does not return any data from the database,
         so it is useless to pass it DQL queries. Note that it is responsibility of the
diff --git a/airflow/contrib/operators/gcs_acl_operator.py b/airflow/contrib/operators/gcs_acl_operator.py
index a39b8cf5d9616..03c72ce328c93 100644
--- a/airflow/contrib/operators/gcs_acl_operator.py
+++ b/airflow/contrib/operators/gcs_acl_operator.py
@@ -26,6 +26,10 @@ class GoogleCloudStorageBucketCreateAclEntryOperator(BaseOperator):
     """
     Creates a new ACL entry on the specified bucket.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GoogleCloudStorageBucketCreateAclEntryOperator`
+
     :param bucket: Name of a bucket.
     :type bucket: str
     :param entity: The entity holding the permission, in one of the following forms:
@@ -69,6 +73,10 @@ class GoogleCloudStorageObjectCreateAclEntryOperator(BaseOperator):
     """
     Creates a new ACL entry on the specified object.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator`
+
     :param bucket: Name of a bucket.
     :type bucket: str
     :param object_name: Name of the object. For information about how to URL encode object
diff --git a/airflow/contrib/operators/gcs_to_bq.py b/airflow/contrib/operators/gcs_to_bq.py
index 28a04d36c1b07..4fd1f6a4ef88c 100644
--- a/airflow/contrib/operators/gcs_to_bq.py
+++ b/airflow/contrib/operators/gcs_to_bq.py
@@ -34,6 +34,10 @@ class GoogleCloudStorageToBigQueryOperator(BaseOperator):
     point the operator to a Google cloud storage object name. The object in
     Google cloud storage must be a JSON file with the schema fields in it.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GoogleCloudStorageToBigQueryOperator`
+
     :param bucket: The bucket to load from. (templated)
     :type bucket: str
     :param source_objects: List of Google cloud storage URIs to load from. (templated)
diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index 8bb3111d4788a..54c2dfba8907a 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -36,6 +36,10 @@ class BashOperator(BaseOperator):
     """
     Execute a Bash script, command or set of commands.
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:BashOperator`
+
     :param bash_command: The command, set of commands or reference to a
         bash script (must be '.sh') to be executed. (templated)
     :type bash_command: str
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 845793bc3f980..ee0f9087ee158 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -39,6 +39,10 @@ class PythonOperator(BaseOperator):
     """
     Executes a Python callable
 
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:PythonOperator`
+
     :param python_callable: A reference to an object that is callable
     :type python_callable: python callable
     :param op_kwargs: a dictionary of keyword arguments that will get unpacked
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 6f312081e6a6d..9be08cca6e6ba 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -27,6 +27,8 @@ information.
 
 .. contents:: :local:
 
+.. _howto/operator:BashOperator:
+
 BashOperator
 ------------
 
@@ -71,6 +73,8 @@ template to it, which will fail.
         bash_command="/home/batcher/test.sh ",
         dag=dag)
 
+.. _howto/operator:PythonOperator:
+
 PythonOperator
 --------------
 
@@ -106,6 +110,8 @@ is evaluated as a :ref:`Jinja template <jinja-templating>`.
 Google Cloud Storage Operators
 ------------------------------
 
+.. _howto/operator:GoogleCloudStorageToBigQueryOperator:
+
 GoogleCloudStorageToBigQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -123,6 +129,8 @@ to execute a BigQuery load job.
 Google Compute Engine Operators
 -------------------------------
 
+.. _howto/operator:GceInstanceStartOperator:
+
 GceInstanceStartOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -177,6 +185,7 @@ More information
 See `Google Compute Engine API documentation
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
 
+.. _howto/operator:GceInstanceStopOperator:
 
 GceInstanceStopOperator
 ^^^^^^^^^^^^^^^^^^^^^^^
@@ -231,6 +240,7 @@ More information
 See `Google Compute Engine API documentation
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
 
+.. _howto/operator:GceSetMachineTypeOperator:
 
 GceSetMachineTypeOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -291,6 +301,7 @@ More information
 See `Google Compute Engine API documentation
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
 
+.. _howto/operator:GceInstanceTemplateCopyOperator:
 
 GceInstanceTemplateCopyOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -351,6 +362,8 @@ More information
 See `Google Compute Engine API documentation
 <https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
 
+.. _howto/operator:GceInstanceGroupManagerUpdateTemplateOperator:
+
 GceInstanceGroupManagerUpdateTemplateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -431,6 +444,7 @@ All examples below rely on the following variables, which can be passed via envi
     :start-after: [START howto_operator_gcp_bigtable_args]
     :end-before: [END howto_operator_gcp_bigtable_args]
 
+.. _howto/operator:BigtableInstanceCreateOperator:
 
 BigtableInstanceCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -453,6 +467,8 @@ it will be retrieved from the GCP connection used. Both variants are shown:
     :start-after: [START howto_operator_gcp_bigtable_instance_create]
     :end-before: [END howto_operator_gcp_bigtable_instance_create]
 
+.. _howto/operator:BigtableInstanceDeleteOperator:
+
 BigtableInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -471,6 +487,8 @@ it will be retrieved from the GCP connection used. Both variants are shown:
     :start-after: [START howto_operator_gcp_bigtable_instance_delete]
     :end-before: [END howto_operator_gcp_bigtable_instance_delete]
 
+.. _howto/operator:BigtableClusterUpdateOperator:
+
 BigtableClusterUpdateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -489,6 +507,8 @@ it will be retrieved from the GCP connection used. Both variants are shown:
     :start-after: [START howto_operator_gcp_bigtable_cluster_update]
     :end-before: [END howto_operator_gcp_bigtable_cluster_update]
 
+.. _howto/operator:BigtableTableCreateOperator:
+
 BigtableTableCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -519,6 +539,7 @@ Please refer to the Python Client for Google Cloud Bigtable documentation
 `for Table <https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html>`_ and `for Column
 Families <https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html>`_.
 
+.. _howto/operator:BigtableTableDeleteOperator:
 
 BigtableTableDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -538,6 +559,8 @@ it will be retrieved from the GCP connection used. Both variants are shown:
     :start-after: [START howto_operator_gcp_bigtable_table_delete]
     :end-before: [END howto_operator_gcp_bigtable_table_delete]
 
+.. _howto/operator:BigtableTableWaitForReplicationSensor:
+
 BigtableTableWaitForReplicationSensor
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -564,6 +587,8 @@ Using the operator
 Google Cloud Functions Operators
 --------------------------------
 
+.. _howto/operator:GcfFunctionDeleteOperator:
+
 GcfFunctionDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -607,6 +632,8 @@ More information
 See `Google Cloud Functions API documentation
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
 
+.. _howto/operator:GcfFunctionDeployOperator:
+
 GcfFunctionDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -742,6 +769,8 @@ See `Google Cloud Functions API documentation
 Google Cloud Spanner Operators
 ------------------------------
 
+.. _howto/operator:CloudSpannerInstanceDatabaseDeleteOperator:
+
 CloudSpannerInstanceDatabaseDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -788,6 +817,7 @@ More information
 See `Google Cloud Spanner API documentation for database drop call
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/dropDatabase>`_.
 
+.. _howto/operator:CloudSpannerInstanceDatabaseDeployOperator:
 
 CloudSpannerInstanceDatabaseDeployOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -837,6 +867,8 @@ More information
 See Google Cloud Spanner API documentation for `database create
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_
 
+.. _howto/operator:CloudSpannerInstanceDatabaseUpdateOperator:
+
 CloudSpannerInstanceDatabaseUpdateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -895,6 +927,8 @@ More information
 See Google Cloud Spanner API documentation for `database update_ddl
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_.
 
+.. _howto/operator:CloudSpannerInstanceDatabaseQueryOperator:
+
 CloudSpannerInstanceDatabaseQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -940,6 +974,8 @@ More information
 See Google Cloud Spanner API documentation for `the DML syntax
 <https://cloud.google.com/spanner/docs/dml-syntax>`_.
 
+.. _howto/operator:CloudSpannerInstanceDeleteOperator:
+
 CloudSpannerInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -989,6 +1025,8 @@ See `Google Cloud Spanner API documentation for instance delete
 Google Cloud Sql Operators
 --------------------------
 
+.. _howto/operator:CloudSqlInstanceDatabaseCreateOperator:
+
 CloudSqlInstanceDatabaseCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1041,6 +1079,8 @@ More information
 See `Google Cloud SQL API documentation for database insert
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert>`_.
 
+.. _howto/operator:CloudSqlInstanceDatabaseDeleteOperator:
+
 CloudSqlInstanceDatabaseDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1086,6 +1126,8 @@ More information
 See `Google Cloud SQL API documentation for database delete
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/delete>`_.
 
+.. _howto/operator:CloudSqlInstanceDatabasePatchOperator:
+
 CloudSqlInstanceDatabasePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1140,6 +1182,8 @@ More information
 See `Google Cloud SQL API documentation for database patch
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch>`_.
 
+.. _howto/operator:CloudSqlInstanceDeleteOperator:
+
 CloudSqlInstanceDeleteOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1196,7 +1240,7 @@ More information
 See `Google Cloud SQL API documentation for delete
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
 
-.. CloudSqlInstanceExportOperator:
+.. _howto/operator:CloudSqlInstanceExportOperator:
 
 CloudSqlInstanceExportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -1279,7 +1323,7 @@ as shown in the example:
     :end-before: [END howto_operator_cloudsql_export_gcs_permissions]
 
 
-.. CloudSqlInstanceImportOperator:
+.. _howto/operator:CloudSqlInstanceImportOperator:
 
 CloudSqlInstanceImportOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -1374,6 +1418,8 @@ as shown in the example:
     :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
     :end-before: [END howto_operator_cloudsql_import_gcs_permissions]
 
+.. _howto/operator:CloudSqlInstanceCreateOperator:
+
 CloudSqlInstanceCreateOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1448,6 +1494,8 @@ More information
 See `Google Cloud SQL API documentation for insert
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
 
+.. _howto/operator:CloudSqlInstancePatchOperator:
+
 CloudSqlInstancePatchOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1504,6 +1552,7 @@ More information
 See `Google Cloud SQL API documentation for patch
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
 
+.. _howto/operator:CloudSqlQueryOperator:
 
 CloudSqlQueryOperator
 ^^^^^^^^^^^^^^^^^^^^^
@@ -1598,6 +1647,8 @@ See `Google Cloud SQL Proxy documentation
 Google Cloud Storage Operators
 ------------------------------
 
+.. _howto/operator:GoogleCloudStorageBucketCreateAclEntryOperator:
+
 GoogleCloudStorageBucketCreateAclEntryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -1640,6 +1691,8 @@ More information
 See `Google Cloud Storage BucketAccessControls insert documentation
 <https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_.
 
+.. _howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator:
+
 GoogleCloudStorageObjectCreateAclEntryOperator
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 04fd3288777b9660c94338a7a378588ee8f26df7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Sun, 27 Jan 2019 12:32:10 +0100
Subject: [PATCH 706/808] [AIRFLOW-XXX] Remove almost all warnings from
 building docs (#4588)

---
 airflow/contrib/operators/qubole_operator.py | 10 +++++++---
 airflow/models/__init__.py                   |  2 +-
 docs/code.rst                                |  4 ++--
 docs/conf.py                                 |  2 +-
 docs/howto/manage-connections.rst            | 21 ++++++++++----------
 docs/howto/operator.rst                      | 21 ++++++++++----------
 docs/integration.rst                         | 11 +++++++---
 docs/plugins.rst                             |  2 +-
 8 files changed, 42 insertions(+), 31 deletions(-)

diff --git a/airflow/contrib/operators/qubole_operator.py b/airflow/contrib/operators/qubole_operator.py
index c6de0153f7421..cea9679ad45b8 100755
--- a/airflow/contrib/operators/qubole_operator.py
+++ b/airflow/contrib/operators/qubole_operator.py
@@ -103,15 +103,19 @@ class QuboleOperator(BaseOperator):
             :boundary_query: Query to be used get range of row IDs to be extracted
             :split_column: Column used as row ID to split data into ranges (mode 2)
 
-    .. note:: Following fields are template-supported : ``query``, ``script_location``,
+    .. note:
+
+        Following fields are template-supported : ``query``, ``script_location``,
         ``sub_command``, ``script``, ``files``, ``archives``, ``program``, ``cmdline``,
         ``sql``, ``where_clause``, ``extract_query``, ``boundary_query``, ``macros``,
         ``tags``, ``name``, ``parameters``, ``dbtap_id``, ``hive_table``, ``db_table``,
         ``split_column``, ``note_id``, ``db_update_keys``, ``export_dir``,
         ``partition_spec``, ``qubole_conn_id``, ``arguments``, ``user_program_arguments``.
-         You can also use ``.txt`` files for template driven use cases.
+        You can also use ``.txt`` files for template driven use cases.
+
+    .. note:
 
-    .. note:: In QuboleOperator there is a default handler for task failures and retries,
+        In QuboleOperator there is a default handler for task failures and retries,
         which generally kills the command running at QDS for the corresponding task
         instance. You can override this behavior by providing your own failure and retry
         handler in task definition.
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 9951f02e52002..6199d4b3d15a8 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -4617,7 +4617,7 @@ def set(
         """
         Store an XCom value.
         TODO: "pickling" has been deprecated and JSON is preferred.
-              "pickling" will be removed in Airflow 2.0.
+        "pickling" will be removed in Airflow 2.0.
 
         :return: None
         """
diff --git a/docs/code.rst b/docs/code.rst
index fe24e2ad5d2e3..77a6f9abf0930 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -344,11 +344,11 @@ Variable                            Description
 ``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``
                                     if ``{{ ds }}`` is ``2018-01-08`` and ``schedule_interval`` is ``@weekly``,
                                     ``{{ prev_ds }}`` will be ``2016-01-01``
-``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None`
+``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None``
 ``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``
                                     if ``{{ ds }}`` is ``2018-01-01`` and ``schedule_interval`` is ``@weekly``,
                                     ``{{ next_ds }}`` will be ``2018-01-08``
-``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None`
+``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None``
 ``{{ yesterday_ds }}``              the day before the execution date as ``YYYY-MM-DD``
 ``{{ yesterday_ds_nodash }}``       the day before the execution date as ``YYYYMMDD``
 ``{{ tomorrow_ds }}``               the day after the execution date as ``YYYY-MM-DD``
diff --git a/docs/conf.py b/docs/conf.py
index c6cac01770932..cdf41b10f0fa4 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -232,7 +232,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
index c99d28b58e9ca..4c839d7fd07c7 100644
--- a/docs/howto/manage-connections.rst
+++ b/docs/howto/manage-connections.rst
@@ -120,16 +120,17 @@ The following connection IDs are used by default.
 
 ``google_cloud_default``
     Used by those hooks:
-* :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`
-* :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`
-* :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`
-* :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`
-* :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook`
-* :class:`~airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook`
-* :class:`~airflow.contrib.hooks.gcp_compute_hook.GceHook`
-* :class:`~airflow.contrib.hooks.gcp_function_hook.GcfHook`
-* :class:`~airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook`
-* :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook`
+
+    * :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`
+    * :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`
+    * :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`
+    * :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`
+    * :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook`
+    * :class:`~airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook`
+    * :class:`~airflow.contrib.hooks.gcp_compute_hook.GceHook`
+    * :class:`~airflow.contrib.hooks.gcp_function_hook.GcfHook`
+    * :class:`~airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook`
+    * :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook`
 
 
 Configuring the Connection
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
index 9be08cca6e6ba..6ddb5be2afa33 100644
--- a/docs/howto/operator.rst
+++ b/docs/howto/operator.rst
@@ -182,7 +182,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation
+See `Google Compute Engine API documentation for start
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
 
 .. _howto/operator:GceInstanceStopOperator:
@@ -237,7 +237,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation
+See `Google Compute Engine API documentation for stop
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
 
 .. _howto/operator:GceSetMachineTypeOperator:
@@ -298,7 +298,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation
+See `Google Compute Engine API documentation for setMachineType
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
 
 .. _howto/operator:GceInstanceTemplateCopyOperator:
@@ -359,7 +359,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation
+See `Google Compute Engine API documentation for instanceTemplates
 <https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
 
 .. _howto/operator:GceInstanceGroupManagerUpdateTemplateOperator:
@@ -428,14 +428,14 @@ the permissions that theService Account User role provides
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation
+See `Google Compute Engine API documentation for instanceGroupManagers
 <https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_.
 
 Google Cloud Bigtable Operators
 -------------------------------
 
 Arguments
-"""""""""
+^^^^^^^^^
 
 All examples below rely on the following variables, which can be passed via environment variables.
 
@@ -629,7 +629,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation
+See `Google Cloud Functions API documentation for delete
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
 
 .. _howto/operator:GcfFunctionDeployOperator:
@@ -763,7 +763,7 @@ can be downloaded if necessary.
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation
+See `Google Cloud Functions API documentation for create
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_.
 
 Google Cloud Spanner Operators
@@ -1248,8 +1248,9 @@ CloudSqlInstanceExportOperator
 Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
 or CSV file.
 
-Note: This operator is idempotent. If executed multiple times with the same
-export file URI, the export file in GCS will simply be overridden.
+.. note::
+    This operator is idempotent. If executed multiple times with the same
+    export file URI, the export file in GCS will simply be overridden.
 
 For parameter definition take a look at
 :class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator`.
diff --git a/docs/integration.rst b/docs/integration.rst
index 443ddfb5062e6..193a43e52cbc6 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -90,8 +90,9 @@ middleware in your `airflow.cfg`::
 
     enable_proxy_fix = True
 
-Note: you should only enable the `ProxyFix` middleware when running
-Airflow behind a trusted proxy (AWS ELB, nginx, etc.).
+.. note:: 
+    You should only enable the `ProxyFix` middleware when running
+    Airflow behind a trusted proxy (AWS ELB, nginx, etc.).
 
 .. _Azure:
 
@@ -195,12 +196,16 @@ AzureCosmosDBHook
 .. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
     :noindex:
 
+.. _AzureCosmosInsertDocumentOperator:
+
 AzureCosmosInsertDocumentOperator
 """""""""""""""""""""""""""""""""
 
 .. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
     :noindex:
 
+.. _AzureCosmosDocumentSensor:
+
 AzureCosmosDocumentSensor
 """""""""""""""""""""""""
 
@@ -908,7 +913,7 @@ Cloud Bigtable Operators
 .. _BigtableInstanceCreateOperator:
 
 BigtableInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
     :noindex:
diff --git a/docs/plugins.rst b/docs/plugins.rst
index 227332f8d30e3..51040b07302ff 100644
--- a/docs/plugins.rst
+++ b/docs/plugins.rst
@@ -226,7 +226,7 @@ the fields appbuilder_views and appbuilder_menu_items were added to the AirflowT
 Plugins as Python packages
 --------------------------
 
-It is possible to load plugins via `setuptools' entrypoint<https://packaging.python.org/guides/creating-and-discovering-plugins/#using-package-metadata>`_ mechanism. To do this link
+It is possible to load plugins via `setuptools entrypoint <https://packaging.python.org/guides/creating-and-discovering-plugins/#using-package-metadata>`_ mechanism. To do this link
 your plugin using an entrypoint in your package. If the package is installed, airflow
 will automatically load the registered plugins from the entrypoint list.
 

From f4e14909992379c7170dd37378e81b93fd88263f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Mon, 4 Mar 2019 14:51:38 +0100
Subject: [PATCH 707/808] [AIRFLOW-XXX] Split connection guide to multiple
 files (#4824)

---
 docs/concepts.rst                  |   2 +-
 docs/howto/connection/aws.rst      |  64 ++++
 docs/howto/connection/gcp.rst      | 115 ++++++
 docs/howto/connection/gcp_sql.rst  |  76 ++++
 docs/howto/connection/index.rst    |  92 +++++
 docs/howto/connection/mysql.rst    |  94 +++++
 docs/howto/connection/oracle.rst   |  85 +++++
 docs/howto/connection/postgres.rst |  79 +++++
 docs/howto/connection/ssh.rst      |  65 ++++
 docs/howto/index.rst               |   2 +-
 docs/howto/manage-connections.rst  | 551 -----------------------------
 docs/integration.rst               |   2 +-
 12 files changed, 673 insertions(+), 554 deletions(-)
 create mode 100644 docs/howto/connection/aws.rst
 create mode 100644 docs/howto/connection/gcp.rst
 create mode 100644 docs/howto/connection/gcp_sql.rst
 create mode 100644 docs/howto/connection/index.rst
 create mode 100644 docs/howto/connection/mysql.rst
 create mode 100644 docs/howto/connection/oracle.rst
 create mode 100644 docs/howto/connection/postgres.rst
 create mode 100644 docs/howto/connection/ssh.rst
 delete mode 100644 docs/howto/manage-connections.rst

diff --git a/docs/concepts.rst b/docs/concepts.rst
index ff2124f31444d..d625cd7ff1889 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -374,7 +374,7 @@ need to supply an explicit connection ID. For example, the default
 ``conn_id`` for the :class:`~airflow.hooks.postgres_hook.PostgresHook` is
 ``postgres_default``.
 
-See :doc:`howto/manage-connections` for how to create and manage connections.
+See :doc:`howto/connection/index` for how to create and manage connections.
 
 Queues
 ======
diff --git a/docs/howto/connection/aws.rst b/docs/howto/connection/aws.rst
new file mode 100644
index 0000000000000..0cda3d6bdb6ca
--- /dev/null
+++ b/docs/howto/connection/aws.rst
@@ -0,0 +1,64 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Amazon Web Services Connection
+==============================
+
+The Amazon Web Services connection type enables the :ref:`AWS Integrations
+<AWS>`.
+
+Authenticating to AWS
+---------------------
+
+Authentication may be performed using any of the `boto3 options <https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html#configuring-credentials>`_. Alternatively, one can pass credentials in as a Connection initialisation parameter.
+
+To use IAM instance profile, create an "empty" connection (i.e. one with no Login or Password specified).
+
+Default Connection IDs
+-----------------------
+
+The default connection ID is ``aws_default``.
+
+Configuring the Connection
+--------------------------
+
+
+Login (optional)
+    Specify the AWS access key ID.
+
+Password (optional)
+    Specify the AWS secret access key.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in AWS
+    connection. The following parameters are supported:
+
+    * **aws_account_id**: AWS account ID for the connection
+    * **aws_iam_role**: AWS IAM role for the connection
+    * **external_id**: AWS external ID for the connection
+    * **host**: Endpoint URL for the connection
+    * **region_name**: AWS region for the connection
+    * **role_arn**: AWS role ARN for the connection
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "aws_iam_role": "aws_iam_role_name",
+          "region_name": "ap-southeast-2"
+       }
diff --git a/docs/howto/connection/gcp.rst b/docs/howto/connection/gcp.rst
new file mode 100644
index 0000000000000..942132a41a218
--- /dev/null
+++ b/docs/howto/connection/gcp.rst
@@ -0,0 +1,115 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Platform Connection
+================================
+
+The Google Cloud Platform connection type enables the :ref:`GCP Integrations
+<GCP>`.
+
+Authenticating to GCP
+---------------------
+
+There are two ways to connect to GCP using Airflow.
+
+1. Use `Application Default Credentials
+   <https://google-auth.readthedocs.io/en/latest/reference/google.auth.html#google.auth.default>`_,
+   such as via the metadata server when running on Google Compute Engine.
+2. Use a `service account
+   <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
+   file (JSON format) on disk.
+
+Default Connection IDs
+----------------------
+
+The following connection IDs are used by default.
+
+``bigquery_default``
+    Used by the :class:`~airflow.contrib.hooks.bigquery_hook.BigQueryHook`
+    hook.
+
+``google_cloud_datastore_default``
+    Used by the :class:`~airflow.contrib.hooks.datastore_hook.DatastoreHook`
+    hook.
+
+``google_cloud_default``
+    Used by those hooks:
+
+    * :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`
+    * :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`
+    * :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`
+    * :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`
+    * :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook`
+    * :class:`~airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook`
+    * :class:`~airflow.contrib.hooks.gcp_compute_hook.GceHook`
+    * :class:`~airflow.contrib.hooks.gcp_function_hook.GcfHook`
+    * :class:`~airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook`
+    * :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook`
+
+
+Configuring the Connection
+--------------------------
+
+Project Id (optional)
+    The Google Cloud project ID to connect to. It is used as default project id by operators using it and
+    can usually be overridden at the operator level.
+
+Keyfile Path
+    Path to a `service account
+    <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
+    file (JSON format) on disk.
+
+    Not required if using application default credentials.
+
+Keyfile JSON
+    Contents of a `service account
+    <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
+    file (JSON format) on disk. It is recommended to :doc:`Secure your connections <../secure-connections>` if using this method to authenticate.
+
+    Not required if using application default credentials.
+
+Scopes (comma separated)
+    A list of comma-separated `Google Cloud scopes
+    <https://developers.google.com/identity/protocols/googlescopes>`_ to
+    authenticate with.
+
+    .. note::
+        Scopes are ignored when using application default credentials. See
+        issue `AIRFLOW-2522
+        <https://issues.apache.org/jira/browse/AIRFLOW-2522>`_.
+
+    When specifying the connection in environment variable you should specify
+    it using URI syntax, with the following requirements:
+
+      * scheme part should be equals ``google-cloud-platform`` (Note: look for a
+        hyphen character)
+      * authority (username, password, host, port), path is ignored
+      * query parameters contains information specific to this type of
+        connection. The following keys are accepted:
+
+        * ``extra__google_cloud_platform__project`` - Project Id
+        * ``extra__google_cloud_platform__key_path`` - Keyfile Path
+        * ``extra__google_cloud_platform__key_dict`` - Keyfile JSON
+        * ``extra__google_cloud_platform__scope`` - Scopes
+
+    Note that all components of the URI should be URL-encoded.
+
+    For example:
+
+    .. code-block:: bash
+
+       google-cloud-platform://?extra__google_cloud_platform__key_path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra__google_cloud_platform__project=airflow
diff --git a/docs/howto/connection/gcp_sql.rst b/docs/howto/connection/gcp_sql.rst
new file mode 100644
index 0000000000000..6f19fd78f8051
--- /dev/null
+++ b/docs/howto/connection/gcp_sql.rst
@@ -0,0 +1,76 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud SQL Connection
+===========================
+
+The gcpcloudsql:// connection is used by
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator` to perform query
+on a Google Cloud SQL database. Google Cloud SQL database can be either
+Postgres or MySQL, so this is a "meta" connection type. It introduces common schema
+for both MySQL and Postgres, including what kind of connectivity should be used.
+Google Cloud SQL supports connecting via public IP or via Cloud SQL Proxy.
+In the latter case the
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` uses
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to automatically prepare
+and use temporary Postgres or MySQL connection that will use the proxy to connect
+(either via TCP or UNIX socket.
+
+Configuring the Connection
+--------------------------
+
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as JSON dictionary) that can be used in Google Cloud SQL
+    connection.
+
+    Details of all the parameters supported in extra field can be found in
+    :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "database_type": "mysql",
+          "project_id": "example-project",
+          "location": "europe-west1",
+          "instance": "testinstance",
+          "use_proxy": true,
+          "sql_proxy_use_tcp": false
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable), you should specify
+    it following the standard syntax of DB connection, where extras are passed as
+    parameters of the URI. Note that all components of the URI should be URL-encoded.
+
+    For example:
+
+    .. code-block:: bash
+
+        gcpcloudsql://user:XXXXXXXXX@1.1.1.1:3306/mydb?database_type=mysql&project_id=example-project&location=europe-west1&instance=testinstance&use_proxy=True&sql_proxy_use_tcp=False
diff --git a/docs/howto/connection/index.rst b/docs/howto/connection/index.rst
new file mode 100644
index 0000000000000..1f7a13a432cf2
--- /dev/null
+++ b/docs/howto/connection/index.rst
@@ -0,0 +1,92 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Managing Connections
+====================
+
+Airflow needs to know how to connect to your environment. Information
+such as hostname, port, login and passwords to other systems and services is
+handled in the ``Admin->Connections`` section of the UI. The pipeline code you
+will author will reference the 'conn_id' of the Connection objects.
+
+.. image:: ../../img/connections.png
+
+Connections can be created and managed using either the UI or environment
+variables.
+
+See the :ref:`Connections Concepts <concepts-connections>` documentation for
+more information.
+
+Creating a Connection with the UI
+---------------------------------
+
+Open the ``Admin->Connections`` section of the UI. Click the ``Create`` link
+to create a new connection.
+
+.. image:: ../../img/connection_create.png
+
+1. Fill in the ``Conn Id`` field with the desired connection ID. It is
+   recommended that you use lower-case characters and separate words with
+   underscores.
+2. Choose the connection type with the ``Conn Type`` field.
+3. Fill in the remaining fields. See
+   :ref:`manage-connections-connection-types` for a description of the fields
+   belonging to the different connection types.
+4. Click the ``Save`` button to create the connection.
+
+Editing a Connection with the UI
+--------------------------------
+
+Open the ``Admin->Connections`` section of the UI. Click the pencil icon next
+to the connection you wish to edit in the connection list.
+
+.. image:: ../../img/connection_edit.png
+
+Modify the connection properties and click the ``Save`` button to save your
+changes.
+
+Creating a Connection with Environment Variables
+------------------------------------------------
+
+Connections in Airflow pipelines can be created using environment variables.
+The environment variable needs to have a prefix of ``AIRFLOW_CONN_`` for
+Airflow with the value in a URI format to use the connection properly.
+
+When referencing the connection in the Airflow pipeline, the ``conn_id``
+should be the name of the variable without the prefix. For example, if the
+``conn_id`` is named ``postgres_master`` the environment variable should be
+named ``AIRFLOW_CONN_POSTGRES_MASTER`` (note that the environment variable
+must be all uppercase).
+
+Airflow assumes the value returned from the environment variable to be in a URI
+format (e.g.``postgres://user:password@localhost:5432/master`` or
+``s3://accesskey:secretkey@S3``). The underscore character is not allowed
+in the scheme part of URI, so it must be changed to a hyphen character
+(e.g. `google-compute-platform` if `conn_type` is `google_compute_platform`).
+Query parameters are parsed to one-dimensional dict and then used to fill extra.
+
+
+.. _manage-connections-connection-types:
+
+Connection Types
+----------------
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    *
diff --git a/docs/howto/connection/mysql.rst b/docs/howto/connection/mysql.rst
new file mode 100644
index 0000000000000..ab2162eb2c1b7
--- /dev/null
+++ b/docs/howto/connection/mysql.rst
@@ -0,0 +1,94 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+MySQL Connection
+================
+The MySQL connection type provides connection to a MySQL database.
+
+Configuring the Connection
+--------------------------
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in MySQL
+    connection. The following parameters are supported:
+
+    * **charset**: specify charset of the connection
+    * **cursor**: one of "sscursor", "dictcursor, "ssdictcursor" . Specifies cursor class to be
+      used
+    * **local_infile**: controls MySQL's LOCAL capability (permitting local data loading by
+      clients). See `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_
+      for details.
+    * **unix_socket**: UNIX socket used instead of the default socket.
+    * **ssl**: Dictionary of SSL parameters that control connecting using SSL. Those
+      parameters are server specific and should contain "ca", "cert", "key", "capath",
+      "cipher" parameters. See
+      `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_ for details.
+      Note that to be useful in URL notation, this parameter might also be
+      a string where the SSL dictionary is a string-encoded JSON dictionary.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "charset": "utf8",
+          "cursorclass": "sscursor",
+          "local_infile": true,
+          "unix_socket": "/var/socket",
+          "ssl": {
+            "cert": "/tmp/client-cert.pem",
+            "ca": "/tmp/server-ca.pem'",
+            "key": "/tmp/client-key.pem"
+          }
+       }
+
+    or
+
+    .. code-block:: json
+
+       {
+          "charset": "utf8",
+          "cursorclass": "sscursor",
+          "local_infile": true,
+          "unix_socket": "/var/socket",
+          "ssl": "{\"cert\": \"/tmp/client-cert.pem\", \"ca\": \"/tmp/server-ca.pem\", \"key\": \"/tmp/client-key.pem\"}"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections - where extras are passed as parameters
+    of the URI. Note that all components of the URI should be URL-encoded.
+
+    For example:
+
+    .. code-block:: bash
+
+       mysql://mysql_user:XXXXXXXXXXXX@1.1.1.1:3306/mysqldb?ssl=%7B%22cert%22%3A+%22%2Ftmp%2Fclient-cert.pem%22%2C+%22ca%22%3A+%22%2Ftmp%2Fserver-ca.pem%22%2C+%22key%22%3A+%22%2Ftmp%2Fclient-key.pem%22%7D
+
+    .. note::
+        If encounter UnicodeDecodeError while working with MySQL connection, check
+        the charset defined is matched to the database charset.
diff --git a/docs/howto/connection/oracle.rst b/docs/howto/connection/oracle.rst
new file mode 100644
index 0000000000000..6a3b23f88bc54
--- /dev/null
+++ b/docs/howto/connection/oracle.rst
@@ -0,0 +1,85 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Oracle Connection
+=================
+The Oracle connection type provides connection to a Oracle database.
+
+Configuring the Connection
+--------------------------
+Dsn (required)
+    The Data Source Name. The host address for the Oracle server.
+
+Sid (optional)
+    The Oracle System ID. The uniquely identify a particular database on a system.
+
+Service_name (optional)
+    The db_unique_name of the database.
+
+Port (optional)
+    The port for the Oracle server, Default 1521.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in Oracle
+    connection. The following parameters are supported:
+
+    * **encoding** - The encoding to use for regular database strings. If not specified,
+      the environment variable `NLS_LANG` is used. If the environment variable `NLS_LANG`
+      is not set, `ASCII` is used.
+    * **nencoding** - The encoding to use for national character set database strings.
+      If not specified, the environment variable `NLS_NCHAR` is used. If the environment
+      variable `NLS_NCHAR` is not used, the environment variable `NLS_LANG` is used instead,
+      and if the environment variable `NLS_LANG` is not set, `ASCII` is used.
+    * **threaded** - Whether or not Oracle should wrap accesses to connections with a mutex.
+      Default value is False.
+    * **events** - Whether or not to initialize Oracle in events mode.
+    * **mode** - one of `sysdba`, `sysasm`, `sysoper`, `sysbkp`, `sysdgd`, `syskmt` or `sysrac`
+      which are defined at the module level, Default mode is connecting.
+    * **purity** - one of `new`, `self`, `default`. Specify the session acquired from the pool.
+      configuration parameter.
+
+    More details on all Oracle connect parameters supported can be found in
+    `cx_Oracle documentation <https://cx-oracle.readthedocs.io/en/latest/module.html#cx_Oracle.connect>`_.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "encoding": "UTF-8",
+          "nencoding": "UTF-8",
+          "threaded": false,
+          "events": false,
+          "mode": "sysdba",
+          "purity": "new"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras are passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        oracle://oracle_user:XXXXXXXXXXXX@1.1.1.1:1521?encoding=UTF-8&nencoding=UTF-8&threaded=False&events=False&mode=sysdba&purity=new
diff --git a/docs/howto/connection/postgres.rst b/docs/howto/connection/postgres.rst
new file mode 100644
index 0000000000000..2ca8b6df1814f
--- /dev/null
+++ b/docs/howto/connection/postgres.rst
@@ -0,0 +1,79 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+PostgresSQL Connection
+======================
+The Postgres connection type provides connection to a Postgres database.
+
+Configuring the Connection
+--------------------------
+Host (required)
+    The host to connect to.
+
+Schema (optional)
+    Specify the schema name to be used in the database.
+
+Login (required)
+    Specify the user name to connect.
+
+Password (required)
+    Specify the password to connect.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in postgres
+    connection. The following parameters out of the standard python parameters
+    are supported:
+
+    * **sslmode** - This option determines whether or with what priority a secure SSL
+      TCP/IP connection will be negotiated with the server. There are six modes:
+      'disable', 'allow', 'prefer', 'require', 'verify-ca', 'verify-full'.
+    * **sslcert** - This parameter specifies the file name of the client SSL certificate,
+      replacing the default.
+    * **sslkey** - This parameter specifies the file name of the client SSL key,
+      replacing the default.
+    * **sslrootcert** - This parameter specifies the name of a file containing SSL
+      certificate authority (CA) certificate(s).
+    * **sslcrl** - This parameter specifies the file name of the SSL certificate
+      revocation list (CRL).
+    * **application_name** - Specifies a value for the application_name
+      configuration parameter.
+    * **keepalives_idle** - Controls the number of seconds of inactivity after which TCP
+      should send a keepalive message to the server.
+
+    More details on all Postgres parameters supported can be found in
+    `Postgres documentation <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING>`_.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "sslmode": "verify-ca",
+          "sslcert": "/tmp/client-cert.pem",
+          "sslca": "/tmp/server-ca.pem",
+          "sslkey": "/tmp/client-key.pem"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of DB connections, where extras are passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        postgresql://postgres_user:XXXXXXXXXXXX@1.1.1.1:5432/postgresdb?sslmode=verify-ca&sslcert=%2Ftmp%2Fclient-cert.pem&sslkey=%2Ftmp%2Fclient-key.pem&sslrootcert=%2Ftmp%2Fserver-ca.pem
diff --git a/docs/howto/connection/ssh.rst b/docs/howto/connection/ssh.rst
new file mode 100644
index 0000000000000..cd7c048ebd508
--- /dev/null
+++ b/docs/howto/connection/ssh.rst
@@ -0,0 +1,65 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+SSH Connection
+==============
+The SSH connection type provides connection to use :class:`~airflow.contrib.hooks.ssh_hook.SSHHook` to run commands on a remote server using :class:`~airflow.contrib.operators.ssh_operator.SSHOperator` or transfer file from/to the remote server using :class:`~airflow.contrib.operators.ssh_operator.SFTPOperator`.
+
+Configuring the Connection
+--------------------------
+Host (required)
+    The Remote host to connect.
+
+Username (optional)
+    The Username to connect to the remote_host.
+
+Password (optional)
+    Specify the password of the username to connect to the remote_host.
+
+Port (optional)
+    Port of remote host to connect. Default is 22.
+
+Extra (optional)
+    Specify the extra parameters (as json dictionary) that can be used in ssh
+    connection. The following parameters out of the standard python parameters
+    are supported:
+
+    * **timeout** - An optional timeout (in seconds) for the TCP connect. Default is ``10``.
+    * **compress** - ``true`` to ask the remote client/server to compress traffic; `false` to refuse compression. Default is ``true``.
+    * **no_host_key_check** - Set to ``false`` to restrict connecting to hosts with no entries in ``~/.ssh/known_hosts`` (Hosts file). This provides maximum protection against trojan horse attacks, but can be troublesome when the ``/etc/ssh/ssh_known_hosts`` file is poorly maintained or connections to new hosts are frequently made. This option forces the user to manually add all new hosts. Default is ``true``, ssh will automatically add new host keys to the user known hosts files.
+    * **allow_host_key_change** - Set to ``true`` if you want to allow connecting to hosts that has host key changed or when you get 'REMOTE HOST IDENTIFICATION HAS CHANGED' error.  This wont protect against Man-In-The-Middle attacks. Other possible solution is to remove the host entry from ``~/.ssh/known_hosts`` file. Default is ``false``.
+
+    Example "extras" field:
+
+    .. code-block:: json
+
+       {
+          "timeout": "10",
+          "compress": "false",
+          "no_host_key_check": "false",
+          "allow_host_key_change": "false"
+       }
+
+    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
+    following the standard syntax of connections, where extras are passed as parameters
+    of the URI (note that all components of the URI should be URL-encoded).
+
+    For example:
+
+    .. code-block:: bash
+
+        ssh://user:pass@localhost:22?timeout=10&compress=false&no_host_key_check=false&allow_host_key_change=true
diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index c83df3632de91..402f3fd1b12db 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -30,7 +30,7 @@ configuring an Airflow environment.
     set-config
     initialize-database
     operator
-    manage-connections
+    connection/index
     secure-connections
     write-logs
     executor/use-celery
diff --git a/docs/howto/manage-connections.rst b/docs/howto/manage-connections.rst
deleted file mode 100644
index 4c839d7fd07c7..0000000000000
--- a/docs/howto/manage-connections.rst
+++ /dev/null
@@ -1,551 +0,0 @@
-..  Licensed to the Apache Software Foundation (ASF) under one
-    or more contributor license agreements.  See the NOTICE file
-    distributed with this work for additional information
-    regarding copyright ownership.  The ASF licenses this file
-    to you under the Apache License, Version 2.0 (the
-    "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
-
-..    http://www.apache.org/licenses/LICENSE-2.0
-
-..  Unless required by applicable law or agreed to in writing,
-    software distributed under the License is distributed on an
-    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-    KIND, either express or implied.  See the License for the
-    specific language governing permissions and limitations
-    under the License.
-
-Managing Connections
-====================
-
-Airflow needs to know how to connect to your environment. Information
-such as hostname, port, login and passwords to other systems and services is
-handled in the ``Admin->Connections`` section of the UI. The pipeline code you
-will author will reference the 'conn_id' of the Connection objects.
-
-.. image:: ../img/connections.png
-
-Connections can be created and managed using either the UI or environment
-variables.
-
-See the :ref:`Connections Concepts <concepts-connections>` documentation for
-more information.
-
-Creating a Connection with the UI
----------------------------------
-
-Open the ``Admin->Connections`` section of the UI. Click the ``Create`` link
-to create a new connection.
-
-.. image:: ../img/connection_create.png
-
-1. Fill in the ``Conn Id`` field with the desired connection ID. It is
-   recommended that you use lower-case characters and separate words with
-   underscores.
-2. Choose the connection type with the ``Conn Type`` field.
-3. Fill in the remaining fields. See
-   :ref:`manage-connections-connection-types` for a description of the fields
-   belonging to the different connection types.
-4. Click the ``Save`` button to create the connection.
-
-Editing a Connection with the UI
---------------------------------
-
-Open the ``Admin->Connections`` section of the UI. Click the pencil icon next
-to the connection you wish to edit in the connection list.
-
-.. image:: ../img/connection_edit.png
-
-Modify the connection properties and click the ``Save`` button to save your
-changes.
-
-Creating a Connection with Environment Variables
-------------------------------------------------
-
-Connections in Airflow pipelines can be created using environment variables.
-The environment variable needs to have a prefix of ``AIRFLOW_CONN_`` for
-Airflow with the value in a URI format to use the connection properly.
-
-When referencing the connection in the Airflow pipeline, the ``conn_id``
-should be the name of the variable without the prefix. For example, if the
-``conn_id`` is named ``postgres_master`` the environment variable should be
-named ``AIRFLOW_CONN_POSTGRES_MASTER`` (note that the environment variable
-must be all uppercase).
-
-Airflow assumes the value returned from the environment variable to be in a URI
-format (e.g.``postgres://user:password@localhost:5432/master`` or
-``s3://accesskey:secretkey@S3``). The underscore character is not allowed
-in the scheme part of URI, so it must be changed to a hyphen character
-(e.g. `google-compute-platform` if `conn_type` is `google_compute_platform`).
-Query parameters are parsed to one-dimensional dict and then used to fill extra.
-
-
-.. _manage-connections-connection-types:
-
-Connection Types
-----------------
-
-.. _connection-type-GCP:
-
-Google Cloud Platform
-~~~~~~~~~~~~~~~~~~~~~
-
-The Google Cloud Platform connection type enables the :ref:`GCP Integrations
-<GCP>`.
-
-Authenticating to GCP
-'''''''''''''''''''''
-
-There are two ways to connect to GCP using Airflow.
-
-1. Use `Application Default Credentials
-   <https://google-auth.readthedocs.io/en/latest/reference/google.auth.html#google.auth.default>`_,
-   such as via the metadata server when running on Google Compute Engine.
-2. Use a `service account
-   <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
-   file (JSON format) on disk.
-
-Default Connection IDs
-''''''''''''''''''''''
-
-The following connection IDs are used by default.
-
-``bigquery_default``
-    Used by the :class:`~airflow.contrib.hooks.bigquery_hook.BigQueryHook`
-    hook.
-
-``google_cloud_datastore_default``
-    Used by the :class:`~airflow.contrib.hooks.datastore_hook.DatastoreHook`
-    hook.
-
-``google_cloud_default``
-    Used by those hooks:
-
-    * :class:`~airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`
-    * :class:`~airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook`
-    * :class:`~airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook`
-    * :class:`~airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook`
-    * :class:`~airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook`
-    * :class:`~airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook`
-    * :class:`~airflow.contrib.hooks.gcp_compute_hook.GceHook`
-    * :class:`~airflow.contrib.hooks.gcp_function_hook.GcfHook`
-    * :class:`~airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook`
-    * :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook`
-
-
-Configuring the Connection
-''''''''''''''''''''''''''
-
-Project Id (optional)
-    The Google Cloud project ID to connect to. It is used as default project id by operators using it and
-    can usually be overridden at the operator level.
-
-Keyfile Path
-    Path to a `service account
-    <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
-    file (JSON format) on disk.
-
-    Not required if using application default credentials.
-
-Keyfile JSON
-    Contents of a `service account
-    <https://cloud.google.com/docs/authentication/#service_accounts>`_ key
-    file (JSON format) on disk. It is recommended to :doc:`Secure your connections <secure-connections>` if using this method to authenticate.
-
-    Not required if using application default credentials.
-
-Scopes (comma separated)
-    A list of comma-separated `Google Cloud scopes
-    <https://developers.google.com/identity/protocols/googlescopes>`_ to
-    authenticate with.
-
-    .. note::
-        Scopes are ignored when using application default credentials. See
-        issue `AIRFLOW-2522
-        <https://issues.apache.org/jira/browse/AIRFLOW-2522>`_.
-
-    When specifying the connection in environment variable you should specify
-    it using URI syntax, with the following requirements:
-
-      * scheme part should be equals ``google-cloud-platform`` (Note: look for a
-        hyphen character)
-      * authority (username, password, host, port), path is ignored
-      * query parameters contains information specific to this type of
-        connection. The following keys are accepted:
-
-        * ``extra__google_cloud_platform__project`` - Project Id
-        * ``extra__google_cloud_platform__key_path`` - Keyfile Path
-        * ``extra__google_cloud_platform__key_dict`` - Keyfile JSON
-        * ``extra__google_cloud_platform__scope`` - Scopes
-
-    Note that all components of the URI should be URL-encoded.
-
-    For example:
-
-    .. code-block:: bash
-
-       google-cloud-platform://?extra__google_cloud_platform__key_path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra__google_cloud_platform__project=airflow
-
-Amazon Web Services
-~~~~~~~~~~~~~~~~~~~
-
-The Amazon Web Services connection type enables the :ref:`AWS Integrations
-<AWS>`.
-
-Authenticating to AWS
-'''''''''''''''''''''
-
-Authentication may be performed using any of the `boto3 options <https://boto3.amazonaws.com/v1/documentation/api/latest/guide/configuration.html#configuring-credentials>`_. Alternatively, one can pass credentials in as a Connection initialisation parameter.
-
-To use IAM instance profile, create an "empty" connection (i.e. one with no Login or Password specified).
-
-Default Connection IDs
-''''''''''''''''''''''
-
-The default connection ID is ``aws_default``.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-
-Login (optional)
-    Specify the AWS access key ID.
-
-Password (optional)
-    Specify the AWS secret access key.
-
-Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in AWS
-    connection. The following parameters are supported:
-
-    * **aws_account_id**: AWS account ID for the connection
-    * **aws_iam_role**: AWS IAM role for the connection
-    * **external_id**: AWS external ID for the connection
-    * **host**: Endpoint URL for the connection
-    * **region_name**: AWS region for the connection
-    * **role_arn**: AWS role ARN for the connection
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "aws_iam_role": "aws_iam_role_name",
-          "region_name": "ap-southeast-2"
-       }
-
-MySQL
-~~~~~
-The MySQL connection type provides connection to a MySQL database.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-Host (required)
-    The host to connect to.
-
-Schema (optional)
-    Specify the schema name to be used in the database.
-
-Login (required)
-    Specify the user name to connect.
-
-Password (required)
-    Specify the password to connect.
-
-Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in MySQL
-    connection. The following parameters are supported:
-
-    * **charset**: specify charset of the connection
-    * **cursor**: one of "sscursor", "dictcursor, "ssdictcursor" . Specifies cursor class to be
-      used
-    * **local_infile**: controls MySQL's LOCAL capability (permitting local data loading by
-      clients). See `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_
-      for details.
-    * **unix_socket**: UNIX socket used instead of the default socket.
-    * **ssl**: Dictionary of SSL parameters that control connecting using SSL. Those
-      parameters are server specific and should contain "ca", "cert", "key", "capath",
-      "cipher" parameters. See
-      `MySQLdb docs <https://mysqlclient.readthedocs.io/user_guide.html>`_ for details.
-      Note that to be useful in URL notation, this parameter might also be
-      a string where the SSL dictionary is a string-encoded JSON dictionary.
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "charset": "utf8",
-          "cursorclass": "sscursor",
-          "local_infile": true,
-          "unix_socket": "/var/socket",
-          "ssl": {
-            "cert": "/tmp/client-cert.pem",
-            "ca": "/tmp/server-ca.pem'",
-            "key": "/tmp/client-key.pem"
-          }
-       }
-
-    or
-
-    .. code-block:: json
-
-       {
-          "charset": "utf8",
-          "cursorclass": "sscursor",
-          "local_infile": true,
-          "unix_socket": "/var/socket",
-          "ssl": "{\"cert\": \"/tmp/client-cert.pem\", \"ca\": \"/tmp/server-ca.pem\", \"key\": \"/tmp/client-key.pem\"}"
-       }
-
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections - where extras are passed as parameters
-    of the URI. Note that all components of the URI should be URL-encoded.
-
-    For example:
-
-    .. code-block:: bash
-
-       mysql://mysql_user:XXXXXXXXXXXX@1.1.1.1:3306/mysqldb?ssl=%7B%22cert%22%3A+%22%2Ftmp%2Fclient-cert.pem%22%2C+%22ca%22%3A+%22%2Ftmp%2Fserver-ca.pem%22%2C+%22key%22%3A+%22%2Ftmp%2Fclient-key.pem%22%7D
-
-    .. note::
-        If encounter UnicodeDecodeError while working with MySQL connection, check
-        the charset defined is matched to the database charset.
-
-Postgres
-~~~~~~~~
-The Postgres connection type provides connection to a Postgres database.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-Host (required)
-    The host to connect to.
-
-Schema (optional)
-    Specify the schema name to be used in the database.
-
-Login (required)
-    Specify the user name to connect.
-
-Password (required)
-    Specify the password to connect.
-
-Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in postgres
-    connection. The following parameters out of the standard python parameters
-    are supported:
-
-    * **sslmode** - This option determines whether or with what priority a secure SSL
-      TCP/IP connection will be negotiated with the server. There are six modes:
-      'disable', 'allow', 'prefer', 'require', 'verify-ca', 'verify-full'.
-    * **sslcert** - This parameter specifies the file name of the client SSL certificate,
-      replacing the default.
-    * **sslkey** - This parameter specifies the file name of the client SSL key,
-      replacing the default.
-    * **sslrootcert** - This parameter specifies the name of a file containing SSL
-      certificate authority (CA) certificate(s).
-    * **sslcrl** - This parameter specifies the file name of the SSL certificate
-      revocation list (CRL).
-    * **application_name** - Specifies a value for the application_name
-      configuration parameter.
-    * **keepalives_idle** - Controls the number of seconds of inactivity after which TCP
-      should send a keepalive message to the server.
-
-    More details on all Postgres parameters supported can be found in
-    `Postgres documentation <https://www.postgresql.org/docs/current/static/libpq-connect.html#LIBPQ-CONNSTRING>`_.
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "sslmode": "verify-ca",
-          "sslcert": "/tmp/client-cert.pem",
-          "sslca": "/tmp/server-ca.pem",
-          "sslkey": "/tmp/client-key.pem"
-       }
-
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras are passed as parameters
-    of the URI (note that all components of the URI should be URL-encoded).
-
-    For example:
-
-    .. code-block:: bash
-
-        postgresql://postgres_user:XXXXXXXXXXXX@1.1.1.1:5432/postgresdb?sslmode=verify-ca&sslcert=%2Ftmp%2Fclient-cert.pem&sslkey=%2Ftmp%2Fclient-key.pem&sslrootcert=%2Ftmp%2Fserver-ca.pem
-
-Oracle
-~~~~~~~~
-The Oracle connection type provides connection to a Oracle database.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-Dsn (required)
-    The Data Source Name. The host address for the Oracle server.
-
-Sid (optional)
-    The Oracle System ID. The uniquely identify a particular database on a system.
-
-Service_name (optional)
-    The db_unique_name of the database.
-
-Port (optional)
-    The port for the Oracle server, Default 1521.
-
-Login (required)
-    Specify the user name to connect.
-
-Password (required)
-    Specify the password to connect.
-
-Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in Oracle
-    connection. The following parameters are supported:
-
-    * **encoding** - The encoding to use for regular database strings. If not specified,
-      the environment variable `NLS_LANG` is used. If the environment variable `NLS_LANG`
-      is not set, `ASCII` is used.
-    * **nencoding** - The encoding to use for national character set database strings.
-      If not specified, the environment variable `NLS_NCHAR` is used. If the environment
-      variable `NLS_NCHAR` is not used, the environment variable `NLS_LANG` is used instead,
-      and if the environment variable `NLS_LANG` is not set, `ASCII` is used.
-    * **threaded** - Whether or not Oracle should wrap accesses to connections with a mutex.
-      Default value is False.
-    * **events** - Whether or not to initialize Oracle in events mode.
-    * **mode** - one of `sysdba`, `sysasm`, `sysoper`, `sysbkp`, `sysdgd`, `syskmt` or `sysrac`
-      which are defined at the module level, Default mode is connecting.
-    * **purity** - one of `new`, `self`, `default`. Specify the session acquired from the pool.
-      configuration parameter.
-
-    More details on all Oracle connect parameters supported can be found in
-    `cx_Oracle documentation <https://cx-oracle.readthedocs.io/en/latest/module.html#cx_Oracle.connect>`_.
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "encoding": "UTF-8",
-          "nencoding": "UTF-8",
-          "threaded": false,
-          "events": false,
-          "mode": "sysdba",
-          "purity": "new"
-       }
-
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of DB connections, where extras are passed as parameters
-    of the URI (note that all components of the URI should be URL-encoded).
-
-    For example:
-
-    .. code-block:: bash
-
-        oracle://oracle_user:XXXXXXXXXXXX@1.1.1.1:1521?encoding=UTF-8&nencoding=UTF-8&threaded=False&events=False&mode=sysdba&purity=new
-
-Cloudsql
-~~~~~~~~
-The gcpcloudsql:// connection is used by
-:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator` to perform query
-on a Google Cloud SQL database. Google Cloud SQL database can be either
-Postgres or MySQL, so this is a "meta" connection type. It introduces common schema
-for both MySQL and Postgres, including what kind of connectivity should be used.
-Google Cloud SQL supports connecting via public IP or via Cloud SQL Proxy.
-In the latter case the
-:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` uses
-:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to automatically prepare
-and use temporary Postgres or MySQL connection that will use the proxy to connect
-(either via TCP or UNIX socket.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-Host (required)
-    The host to connect to.
-
-Schema (optional)
-    Specify the schema name to be used in the database.
-
-Login (required)
-    Specify the user name to connect.
-
-Password (required)
-    Specify the password to connect.
-
-Extra (optional)
-    Specify the extra parameters (as JSON dictionary) that can be used in Google Cloud SQL
-    connection.
-
-    Details of all the parameters supported in extra field can be found in
-    :class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "database_type": "mysql",
-          "project_id": "example-project",
-          "location": "europe-west1",
-          "instance": "testinstance",
-          "use_proxy": true,
-          "sql_proxy_use_tcp": false
-       }
-
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable), you should specify
-    it following the standard syntax of DB connection, where extras are passed as
-    parameters of the URI. Note that all components of the URI should be URL-encoded.
-
-    For example:
-
-    .. code-block:: bash
-
-        gcpcloudsql://user:XXXXXXXXX@1.1.1.1:3306/mydb?database_type=mysql&project_id=example-project&location=europe-west1&instance=testinstance&use_proxy=True&sql_proxy_use_tcp=False
-
-SSH
-~~~
-The SSH connection type provides connection to use :class:`~airflow.contrib.hooks.ssh_hook.SSHHook` to run commands on a remote server using :class:`~airflow.contrib.operators.ssh_operator.SSHOperator` or transfer file from/to the remote server using :class:`~airflow.contrib.operators.ssh_operator.SFTPOperator`.
-
-Configuring the Connection
-''''''''''''''''''''''''''
-Host (required)
-    The Remote host to connect.
-
-Username (optional)
-    The Username to connect to the remote_host.
-
-Password (optional)
-    Specify the password of the username to connect to the remote_host.
-
-Port (optional)
-    Port of remote host to connect. Default is 22.
-
-Extra (optional)
-    Specify the extra parameters (as json dictionary) that can be used in ssh
-    connection. The following parameters out of the standard python parameters
-    are supported:
-
-    * **timeout** - An optional timeout (in seconds) for the TCP connect. Default is ``10``.
-    * **compress** - ``true`` to ask the remote client/server to compress traffic; `false` to refuse compression. Default is ``true``.
-    * **no_host_key_check** - Set to ``false`` to restrict connecting to hosts with no entries in ``~/.ssh/known_hosts`` (Hosts file). This provides maximum protection against trojan horse attacks, but can be troublesome when the ``/etc/ssh/ssh_known_hosts`` file is poorly maintained or connections to new hosts are frequently made. This option forces the user to manually add all new hosts. Default is ``true``, ssh will automatically add new host keys to the user known hosts files.
-    * **allow_host_key_change** - Set to ``true`` if you want to allow connecting to hosts that has host key changed or when you get 'REMOTE HOST IDENTIFICATION HAS CHANGED' error.  This wont protect against Man-In-The-Middle attacks. Other possible solution is to remove the host entry from ``~/.ssh/known_hosts`` file. Default is ``false``.
-
-    Example "extras" field:
-
-    .. code-block:: json
-
-       {
-          "timeout": "10",
-          "compress": "false",
-          "no_host_key_check": "false",
-          "allow_host_key_change": "false"
-       }
-
-    When specifying the connection as URI (in AIRFLOW_CONN_* variable) you should specify it
-    following the standard syntax of connections, where extras are passed as parameters
-    of the URI (note that all components of the URI should be URL-encoded).
-
-    For example:
-
-    .. code-block:: bash
-
-        ssh://user:pass@localhost:22?timeout=10&compress=false&no_host_key_check=false&allow_host_key_change=true
diff --git a/docs/integration.rst b/docs/integration.rst
index 193a43e52cbc6..9ec656f8ee8dd 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -568,7 +568,7 @@ Airflow has extensive support for the Google Cloud Platform. But note that most
 Operators are in the contrib section. Meaning that they have a *beta* status, meaning that
 they can have breaking changes between minor releases.
 
-See the :ref:`GCP connection type <connection-type-GCP>` documentation to
+See the :doc:`GCP connection type <howto/connection/gcp>` documentation to
 configure connections to GCP.
 
 Logging

From 147502e11c1a32c9e7b902b9fd0e742b1a97b473 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 6 Mar 2019 20:11:35 +0100
Subject: [PATCH 708/808] [AIRFLOW-XXX] Split guide for operators to multiple
 files (#4814)

---
 airflow/operators/bash_operator.py   |    2 +-
 airflow/operators/python_operator.py |    2 +-
 docs/concepts.rst                    |    4 +-
 docs/howto/index.rst                 |    2 +-
 docs/howto/operator.rst              | 2330 --------------------------
 docs/howto/operator/bash.rst         |   60 +
 docs/howto/operator/gcp/bigtable.rst |  170 ++
 docs/howto/operator/gcp/compute.rst  |  325 ++++
 docs/howto/operator/gcp/function.rst |  202 +++
 docs/howto/operator/gcp/gcs.rst      |  127 ++
 docs/howto/operator/gcp/index.rst    |   26 +
 docs/howto/operator/gcp/spanner.rst  |  276 +++
 docs/howto/operator/gcp/sql.rst      |  643 +++++++
 docs/howto/operator/gcp/vision.rst   |  612 +++++++
 docs/howto/operator/index.rst        |   33 +
 docs/howto/operator/python.rst       |   48 +
 16 files changed, 2527 insertions(+), 2335 deletions(-)
 delete mode 100644 docs/howto/operator.rst
 create mode 100644 docs/howto/operator/bash.rst
 create mode 100644 docs/howto/operator/gcp/bigtable.rst
 create mode 100644 docs/howto/operator/gcp/compute.rst
 create mode 100644 docs/howto/operator/gcp/function.rst
 create mode 100644 docs/howto/operator/gcp/gcs.rst
 create mode 100644 docs/howto/operator/gcp/index.rst
 create mode 100644 docs/howto/operator/gcp/spanner.rst
 create mode 100644 docs/howto/operator/gcp/sql.rst
 create mode 100644 docs/howto/operator/gcp/vision.rst
 create mode 100644 docs/howto/operator/index.rst
 create mode 100644 docs/howto/operator/python.rst

diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index 54c2dfba8907a..32d37ebe7a8eb 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -38,7 +38,7 @@ class BashOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:BashOperator`
+        :doc:`howto/operator/bash`
 
     :param bash_command: The command, set of commands or reference to a
         bash script (must be '.sh') to be executed. (templated)
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index ee0f9087ee158..166201672dac4 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -41,7 +41,7 @@ class PythonOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :ref:`howto/operator:PythonOperator`
+        :doc:`howto/operator/python`
 
     :param python_callable: A reference to an object that is callable
     :type python_callable: python callable
diff --git a/docs/concepts.rst b/docs/concepts.rst
index d625cd7ff1889..46ba71764a4a1 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -156,8 +156,8 @@ the platform.
 
 Operators are only loaded by Airflow if they are assigned to a DAG.
 
-See :doc:`howto/operator` for how to use Airflow operators.
-
+See :doc:`howto/operator/index` for how to use Airflow operators.
+ 
 DAG Assignment
 --------------
 
diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index 402f3fd1b12db..f4ac5a163af00 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -29,7 +29,7 @@ configuring an Airflow environment.
 
     set-config
     initialize-database
-    operator
+    operator/index
     connection/index
     secure-connections
     write-logs
diff --git a/docs/howto/operator.rst b/docs/howto/operator.rst
deleted file mode 100644
index 6ddb5be2afa33..0000000000000
--- a/docs/howto/operator.rst
+++ /dev/null
@@ -1,2330 +0,0 @@
-..  Licensed to the Apache Software Foundation (ASF) under one
-    or more contributor license agreements.  See the NOTICE file
-    distributed with this work for additional information
-    regarding copyright ownership.  The ASF licenses this file
-    to you under the Apache License, Version 2.0 (the
-    "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
-
-..    http://www.apache.org/licenses/LICENSE-2.0
-
-..  Unless required by applicable law or agreed to in writing,
-    software distributed under the License is distributed on an
-    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-    KIND, either express or implied.  See the License for the
-    specific language governing permissions and limitations
-    under the License.
-
-Using Operators
-===============
-
-An operator represents a single, ideally idempotent, task. Operators
-determine what actually executes when your DAG runs.
-
-See the :ref:`Operators Concepts <concepts-operators>` documentation and the
-:ref:`Operators API Reference <api-reference-operators>` for more
-information.
-
-.. contents:: :local:
-
-.. _howto/operator:BashOperator:
-
-BashOperator
-------------
-
-Use the :class:`~airflow.operators.bash_operator.BashOperator` to execute
-commands in a `Bash <https://www.gnu.org/software/bash/>`__ shell.
-
-.. literalinclude:: ../../airflow/example_dags/example_bash_operator.py
-    :language: python
-    :start-after: [START howto_operator_bash]
-    :end-before: [END howto_operator_bash]
-
-Templating
-^^^^^^^^^^
-
-You can use :ref:`Jinja templates <jinja-templating>` to parameterize the
-``bash_command`` argument.
-
-.. literalinclude:: ../../airflow/example_dags/example_bash_operator.py
-    :language: python
-    :start-after: [START howto_operator_bash_template]
-    :end-before: [END howto_operator_bash_template]
-
-Troubleshooting
-^^^^^^^^^^^^^^^
-
-Jinja template not found
-""""""""""""""""""""""""
-
-Add a space after the script name when directly calling a Bash script with
-the ``bash_command`` argument. This is because Airflow tries to apply a Jinja
-template to it, which will fail.
-
-.. code-block:: python
-
-    t2 = BashOperator(
-        task_id='bash_example',
-
-        # This fails with `Jinja template not found` error
-        # bash_command="/home/batcher/test.sh",
-
-        # This works (has a space after)
-        bash_command="/home/batcher/test.sh ",
-        dag=dag)
-
-.. _howto/operator:PythonOperator:
-
-PythonOperator
---------------
-
-Use the :class:`~airflow.operators.python_operator.PythonOperator` to execute
-Python callables.
-
-.. literalinclude:: ../../airflow/example_dags/example_python_operator.py
-    :language: python
-    :start-after: [START howto_operator_python]
-    :end-before: [END howto_operator_python]
-
-Passing in arguments
-^^^^^^^^^^^^^^^^^^^^
-
-Use the ``op_args`` and ``op_kwargs`` arguments to pass additional arguments
-to the Python callable.
-
-.. literalinclude:: ../../airflow/example_dags/example_python_operator.py
-    :language: python
-    :start-after: [START howto_operator_python_kwargs]
-    :end-before: [END howto_operator_python_kwargs]
-
-Templating
-^^^^^^^^^^
-
-When you set the ``provide_context`` argument to ``True``, Airflow passes in
-an additional set of keyword arguments: one for each of the :ref:`Jinja
-template variables <macros>` and a ``templates_dict`` argument.
-
-The ``templates_dict`` argument is templated, so each value in the dictionary
-is evaluated as a :ref:`Jinja template <jinja-templating>`.
-
-Google Cloud Storage Operators
-------------------------------
-
-.. _howto/operator:GoogleCloudStorageToBigQueryOperator:
-
-GoogleCloudStorageToBigQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the
-:class:`~airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator`
-to execute a BigQuery load job.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_to_bq_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcs_to_bq]
-    :end-before: [END howto_operator_gcs_to_bq]
-
-
-Google Compute Engine Operators
--------------------------------
-
-.. _howto/operator:GceInstanceStartOperator:
-
-GceInstanceStartOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator`
-to start an existing Google Compute Engine instance.
-
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables used to pass arguments to the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :start-after: [START howto_operator_gce_args_common]
-    :end-before: [END howto_operator_gce_args_common]
-
-Using the operator
-""""""""""""""""""
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_start]
-    :end-before: [END howto_operator_gce_start]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection id used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_start_no_project_id]
-    :end-before: [END howto_operator_gce_start_no_project_id]
-
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gce_instance_start_template_fields]
-    :end-before: [END gce_instance_start_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Compute Engine API documentation for start
-<https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
-
-.. _howto/operator:GceInstanceStopOperator:
-
-GceInstanceStopOperator
-^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to stop Google Compute Engine instance.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator`
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables used to pass arguments to the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-   :language: python
-   :start-after: [START howto_operator_gce_args_common]
-   :end-before: [END howto_operator_gce_args_common]
-
-Using the operator
-""""""""""""""""""
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_stop]
-    :end-before: [END howto_operator_gce_stop]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_stop_no_project_id]
-    :end-before: [END howto_operator_gce_stop_no_project_id]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gce_instance_stop_template_fields]
-    :end-before: [END gce_instance_stop_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Compute Engine API documentation for stop
-<https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
-
-.. _howto/operator:GceSetMachineTypeOperator:
-
-GceSetMachineTypeOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to change machine type of a Google Compute Engine instance.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`.
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables used to pass arguments to the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :start-after: [START howto_operator_gce_args_common]
-    :end-before: [END howto_operator_gce_args_common]
-
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :start-after: [START howto_operator_gce_args_set_machine_type]
-    :end-before: [END howto_operator_gce_args_set_machine_type]
-
-Using the operator
-""""""""""""""""""
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_set_machine_type]
-    :end-before: [END howto_operator_gce_set_machine_type]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_set_machine_type_no_project_id]
-    :end-before: [END howto_operator_gce_set_machine_type_no_project_id]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gce_instance_set_machine_type_template_fields]
-    :end-before: [END gce_instance_set_machine_type_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Compute Engine API documentation for setMachineType
-<https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
-
-.. _howto/operator:GceInstanceTemplateCopyOperator:
-
-GceInstanceTemplateCopyOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to copy an existing Google Compute Engine instance template
-applying a patch to it.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator`.
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables used to pass arguments to the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :start-after: [START howto_operator_compute_igm_common_args]
-    :end-before: [END howto_operator_compute_igm_common_args]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :start-after: [START howto_operator_compute_template_copy_args]
-    :end-before: [END howto_operator_compute_template_copy_args]
-
-Using the operator
-""""""""""""""""""
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_igm_copy_template]
-    :end-before: [END howto_operator_gce_igm_copy_template]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_igm_copy_template_no_project_id]
-    :end-before: [END howto_operator_gce_igm_copy_template_no_project_id]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gce_instance_template_copy_operator_template_fields]
-    :end-before: [END gce_instance_template_copy_operator_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Compute Engine API documentation for instanceTemplates
-<https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
-
-.. _howto/operator:GceInstanceGroupManagerUpdateTemplateOperator:
-
-GceInstanceGroupManagerUpdateTemplateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to update template in Google Compute Engine Instance Group Manager.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`.
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables used to pass arguments to the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :start-after: [START howto_operator_compute_igm_common_args]
-    :end-before: [END howto_operator_compute_igm_common_args]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :start-after: [START howto_operator_compute_igm_update_template_args]
-    :end-before: [END howto_operator_compute_igm_update_template_args]
-
-Using the operator
-""""""""""""""""""
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_igm_update_template]
-    :end-before: [END howto_operator_gce_igm_update_template]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_compute_igm.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gce_igm_update_template_no_project_id]
-    :end-before: [END howto_operator_gce_igm_update_template_no_project_id]
-
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_compute_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gce_igm_update_template_operator_template_fields]
-    :end-before: [END gce_igm_update_template_operator_template_fields]
-
-Troubleshooting
-"""""""""""""""
-
-You might find that your GceInstanceGroupManagerUpdateTemplateOperator fails with
-missing permissions. To execute the operation, the service account requires
-the permissions that theService Account User role provides
-(assigned via Google Cloud IAM).
-
-More information
-""""""""""""""""
-
-See `Google Compute Engine API documentation for instanceGroupManagers
-<https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_.
-
-Google Cloud Bigtable Operators
--------------------------------
-
-Arguments
-^^^^^^^^^
-
-All examples below rely on the following variables, which can be passed via environment variables.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :start-after: [START howto_operator_gcp_bigtable_args]
-    :end-before: [END howto_operator_gcp_bigtable_args]
-
-.. _howto/operator:BigtableInstanceCreateOperator:
-
-BigtableInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator`
-to create a Google Cloud Bigtable instance.
-
-If the Cloud Bigtable instance with the given ID exists, the operator does not compare its configuration
-and immediately succeeds. No changes are made to the existing instance.
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_instance_create]
-    :end-before: [END howto_operator_gcp_bigtable_instance_create]
-
-.. _howto/operator:BigtableInstanceDeleteOperator:
-
-BigtableInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator`
-to delete a Google Cloud Bigtable instance.
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_instance_delete]
-    :end-before: [END howto_operator_gcp_bigtable_instance_delete]
-
-.. _howto/operator:BigtableClusterUpdateOperator:
-
-BigtableClusterUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator`
-to modify number of nodes in a Cloud Bigtable cluster.
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_cluster_update]
-    :end-before: [END howto_operator_gcp_bigtable_cluster_update]
-
-.. _howto/operator:BigtableTableCreateOperator:
-
-BigtableTableCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a table in a Cloud Bigtable instance.
-
-If the table with given ID exists in the Cloud Bigtable instance, the operator compares the Column Families.
-If the Column Families are identical operator succeeds. Otherwise, the operator fails with the appropriate
-error message.
-
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_table_create]
-    :end-before: [END howto_operator_gcp_bigtable_table_create]
-
-Advanced
-""""""""
-
-When creating a table, you can specify the optional ``initial_split_keys`` and ``column_families``.
-Please refer to the Python Client for Google Cloud Bigtable documentation
-`for Table <https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html>`_ and `for Column
-Families <https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html>`_.
-
-.. _howto/operator:BigtableTableDeleteOperator:
-
-BigtableTableDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator`
-to delete a table in Google Cloud Bigtable.
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_table_delete]
-    :end-before: [END howto_operator_gcp_bigtable_table_delete]
-
-.. _howto/operator:BigtableTableWaitForReplicationSensor:
-
-BigtableTableWaitForReplicationSensor
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor`
-to wait for the table to replicate fully.
-
-The same arguments apply to this sensor as the BigtableTableCreateOperator_.
-
-**Note:** If the table or the Cloud Bigtable instance does not exist, this sensor waits for the table until
-timeout hits and does not raise any exception.
-
-Using the operator
-""""""""""""""""""
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcp_bigtable_table_wait_for_replication]
-    :end-before: [END howto_operator_gcp_bigtable_table_wait_for_replication]
-
-Google Cloud Functions Operators
---------------------------------
-
-.. _howto/operator:GcfFunctionDeleteOperator:
-
-GcfFunctionDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to delete a function from Google Cloud Functions.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`.
-
-Arguments
-"""""""""
-
-The following examples of OS environment variables show how you can build function name
-to use in the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_common_variables]
-    :end-before: [END howto_operator_gcf_common_variables]
-
-Using the operator
-""""""""""""""""""
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcf_delete]
-    :end-before: [END howto_operator_gcf_delete]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcf_function_delete_template_fields]
-    :end-before: [END gcf_function_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Functions API documentation for delete
-<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
-
-.. _howto/operator:GcfFunctionDeployOperator:
-
-GcfFunctionDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Use the operator to deploy a function to Google Cloud Functions.
-If a function with this name already exists, it will be updated.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`.
-
-
-Arguments
-"""""""""
-
-In the example DAG the following environment variables are used to parameterize the
-operator's definition:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_common_variables]
-    :end-before: [END howto_operator_gcf_common_variables]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_deploy_variables]
-    :end-before: [END howto_operator_gcf_deploy_variables]
-
-Some of those variables are used to create the request's body:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_deploy_body]
-    :end-before: [END howto_operator_gcf_deploy_body]
-
-When a DAG is created, the default_args dictionary can be used to pass
-arguments common with other tasks:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_default_args]
-    :end-before: [END howto_operator_gcf_default_args]
-
-Note that the neither the body nor the default args are complete in the above examples.
-Depending on the variables set, there might be different variants on how to pass source
-code related fields. Currently, you can pass either ``sourceArchiveUrl``,
-``sourceRepository`` or ``sourceUploadUrl`` as described in the
-`Cloud Functions API specification
-<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
-
-Additionally, ``default_args`` or direct operator args might contain ``zip_path``
-parameter
-to run the extra step of uploading the source code before deploying it.
-In this case, you also need to provide an empty ``sourceUploadUrl``
-parameter in the body.
-
-Using the operator
-""""""""""""""""""
-
-Depending on the combination of parameters, the Function's source code can be obtained
-from different sources:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :start-after: [START howto_operator_gcf_deploy_variants]
-    :end-before: [END howto_operator_gcf_deploy_variants]
-
-The code to create the operator:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcf_deploy]
-    :end-before: [END howto_operator_gcf_deploy]
-
-You can also create the operator without project id - project id will be retrieved
-from the GCP connection used:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_function.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_gcf_deploy_no_project_id]
-    :end-before: [END howto_operator_gcf_deploy_no_project_id]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_function_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcf_function_deploy_template_fields]
-    :end-before: [END gcf_function_deploy_template_fields]
-
-
-Troubleshooting
-"""""""""""""""
-
-If during the deploy you see an error similar to:
-
-`"HttpError 403: Missing necessary permission iam.serviceAccounts.actAs for on resource
-project-name@appspot.gserviceaccount.com. Please grant the
-roles/iam.serviceAccountUser role."`
-
-it means that your service account does not have the correct Cloud IAM permissions.
-
-1. Assign your Service Account the Cloud Functions Developer role.
-2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
-   service account.
-
-The typical way of assigning Cloud IAM permissions with `gcloud` is
-shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
-and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
-
-.. code-block:: bash
-
-  gcloud iam service-accounts add-iam-policy-binding \
-    PROJECT_ID@appspot.gserviceaccount.com \
-    --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
-    --role="roles/iam.serviceAccountUser"
-
-You can also do that via the GCP Web console.
-
-See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details.
-
-If the source code for your function is in Google Source Repository, make sure that
-your service account has the Source Repository Viewer role so that the source code
-can be downloaded if necessary.
-
-More information
-""""""""""""""""
-
-See `Google Cloud Functions API documentation for create
-<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_.
-
-Google Cloud Spanner Operators
-------------------------------
-
-.. _howto/operator:CloudSpannerInstanceDatabaseDeleteOperator:
-
-CloudSpannerInstanceDatabaseDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Deletes a database from the specified Cloud Spanner instance. If the database does not
-exist, no action is taken, and the operator succeeds.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :start-after: [START howto_operator_spanner_arguments]
-    :end-before: [END howto_operator_spanner_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_database_delete]
-    :end-before: [END howto_operator_spanner_database_delete]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_spanner_delete_template_fields]
-    :end-before: [END gcp_spanner_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Spanner API documentation for database drop call
-<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/dropDatabase>`_.
-
-.. _howto/operator:CloudSpannerInstanceDatabaseDeployOperator:
-
-CloudSpannerInstanceDatabaseDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new Cloud Spanner database in the specified instance, or if the
-desired database exists, assumes success with no changes applied to database
-configuration. No structure of the database is verified - it's enough if the database exists
-with the same name.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :start-after: [START howto_operator_spanner_arguments]
-    :end-before: [END howto_operator_spanner_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_database_deploy]
-    :end-before: [END howto_operator_spanner_database_deploy]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_spanner_database_deploy_template_fields]
-    :end-before: [END gcp_spanner_database_deploy_template_fields]
-
-More information
-""""""""""""""""
-
-See Google Cloud Spanner API documentation for `database create
-<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_
-
-.. _howto/operator:CloudSpannerInstanceDatabaseUpdateOperator:
-
-CloudSpannerInstanceDatabaseUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Runs a DDL query in a Cloud Spanner database and allows you to modify the structure of an
-existing database.
-
-You can optionally specify an operation_id parameter which simplifies determining whether
-the statements were executed in case the update_database call is replayed
-(idempotency check). The operation_id should be unique within the database, and must be
-a valid identifier: `[a-z][a-z0-9_]*`. More information can be found in
-`the documentation of updateDdl API <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_
-
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :start-after: [START howto_operator_spanner_arguments]
-    :end-before: [END howto_operator_spanner_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_database_update]
-    :end-before: [END howto_operator_spanner_database_update]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_database_update_idempotent]
-    :end-before: [END howto_operator_spanner_database_update_idempotent]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_spanner_database_update_template_fields]
-    :end-before: [END gcp_spanner_database_update_template_fields]
-
-More information
-""""""""""""""""
-
-See Google Cloud Spanner API documentation for `database update_ddl
-<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_.
-
-.. _howto/operator:CloudSpannerInstanceDatabaseQueryOperator:
-
-CloudSpannerInstanceDatabaseQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
-
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables.
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :start-after: [START howto_operator_spanner_arguments]
-    :end-before: [END howto_operator_spanner_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_query]
-    :end-before: [END howto_operator_spanner_query]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_spanner_query_template_fields]
-    :end-before: [END gcp_spanner_query_template_fields]
-
-More information
-""""""""""""""""
-
-See Google Cloud Spanner API documentation for `the DML syntax
-<https://cloud.google.com/spanner/docs/dml-syntax>`_.
-
-.. _howto/operator:CloudSpannerInstanceDeleteOperator:
-
-CloudSpannerInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Deletes a Cloud Spanner instance. If an instance does not exist, no action is taken,
-and the operator succeeds.
-
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :start-after: [START howto_operator_spanner_arguments]
-    :end-before: [END howto_operator_spanner_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_spanner.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_spanner_delete]
-    :end-before: [END howto_operator_spanner_delete]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_spanner_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_spanner_delete_template_fields]
-  :end-before: [END gcp_spanner_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Spanner API documentation for instance delete
-<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/delete>`_.
-
-Google Cloud Sql Operators
---------------------------
-
-.. _howto/operator:CloudSqlInstanceDatabaseCreateOperator:
-
-CloudSqlInstanceDatabaseCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new database inside a Cloud SQL instance.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_db_create]
-    :end-before: [END howto_operator_cloudsql_db_create]
-
-Example request body:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_db_create_body]
-    :end-before: [END howto_operator_cloudsql_db_create_body]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_db_create_template_fields]
-  :end-before: [END gcp_sql_db_create_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for database insert
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert>`_.
-
-.. _howto/operator:CloudSqlInstanceDatabaseDeleteOperator:
-
-CloudSqlInstanceDatabaseDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Deletes a database from a Cloud SQL instance.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_db_delete]
-    :end-before: [END howto_operator_cloudsql_db_delete]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_db_delete_template_fields]
-  :end-before: [END gcp_sql_db_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for database delete
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/delete>`_.
-
-.. _howto/operator:CloudSqlInstanceDatabasePatchOperator:
-
-CloudSqlInstanceDatabasePatchOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Updates a resource containing information about a database inside a Cloud SQL instance
-using patch semantics.
-See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_db_patch]
-    :end-before: [END howto_operator_cloudsql_db_patch]
-
-Example request body:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_db_patch_body]
-    :end-before: [END howto_operator_cloudsql_db_patch_body]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_db_patch_template_fields]
-  :end-before: [END gcp_sql_db_patch_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for database patch
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch>`_.
-
-.. _howto/operator:CloudSqlInstanceDeleteOperator:
-
-CloudSqlInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Deletes a Cloud SQL instance in Google Cloud Platform.
-
-It is also used for deleting read and failover replicas.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_delete]
-    :end-before: [END howto_operator_cloudsql_delete]
-
-Note: If the instance has read or failover replicas you need to delete them before you delete the primary instance.
-Replicas are deleted the same way as primary instances:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_replicas_delete]
-    :end-before: [END howto_operator_cloudsql_replicas_delete]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_delete_template_fields]
-  :end-before: [END gcp_sql_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for delete
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
-
-.. _howto/operator:CloudSqlInstanceExportOperator:
-
-CloudSqlInstanceExportOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
-or CSV file.
-
-.. note::
-    This operator is idempotent. If executed multiple times with the same
-    export file URI, the export file in GCS will simply be overridden.
-
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from Airflow variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_export_import_arguments]
-    :end-before: [END howto_operator_cloudsql_export_import_arguments]
-
-Example body defining the export operation:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_export_body]
-    :end-before: [END howto_operator_cloudsql_export_body]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_export]
-    :end-before: [END howto_operator_cloudsql_export]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_sql_export_template_fields]
-    :end-before: [END gcp_sql_export_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for export <https://cloud.google
-.com/sql/docs/mysql/admin-api/v1beta4/instances/export>`_.
-
-Troubleshooting
-"""""""""""""""
-
-If you receive an "Unauthorized" error in GCP, make sure that the service account
-of the Cloud SQL instance is authorized to write to the selected GCS bucket.
-
-It is not the service account configured in Airflow that communicates with GCS,
-but rather the service account of the particular Cloud SQL instance.
-
-To grant the service account with the appropriate WRITE permissions for the GCS bucket
-you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`,
-as shown in the example:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_export_gcs_permissions]
-    :end-before: [END howto_operator_cloudsql_export_gcs_permissions]
-
-
-.. _howto/operator:CloudSqlInstanceImportOperator:
-
-CloudSqlInstanceImportOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
-
-CSV import:
-"""""""""""
-
-This operator is NOT idempotent for a CSV import. If the same file is imported
-multiple times, the imported data will be duplicated in the database.
-Moreover, if there are any unique constraints the duplicate import may result in an
-error.
-
-SQL import:
-"""""""""""
-
-This operator is idempotent for a SQL import if it was also exported by Cloud SQL.
-The exported SQL contains 'DROP TABLE IF EXISTS' statements for all tables
-to be imported.
-
-If the import file was generated in a different way, idempotence is not guaranteed.
-It has to be ensured on the SQL file level.
-
-For parameter definition take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator`.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from Airflow variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_export_import_arguments]
-    :end-before: [END howto_operator_cloudsql_export_import_arguments]
-
-Example body defining the import operation:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_import_body]
-    :end-before: [END howto_operator_cloudsql_import_body]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_import]
-    :end-before: [END howto_operator_cloudsql_import]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_sql_import_template_fields]
-    :end-before: [END gcp_sql_import_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for import <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/import>`_.
-
-Troubleshooting
-"""""""""""""""
-
-If you receive an "Unauthorized" error in GCP, make sure that the service account
-of the Cloud SQL instance is authorized to read from the selected GCS object.
-
-It is not the service account configured in Airflow that communicates with GCS,
-but rather the service account of the particular Cloud SQL instance.
-
-To grant the service account with the appropriate READ permissions for the GCS object
-you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`,
-as shown in the example:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
-    :end-before: [END howto_operator_cloudsql_import_gcs_permissions]
-
-.. _howto/operator:CloudSqlInstanceCreateOperator:
-
-CloudSqlInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new Cloud SQL instance in Google Cloud Platform.
-
-It is also used for creating read replicas.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`.
-
-If an instance with the same name exists, no action will be taken and the operator
-will succeed.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Some other arguments are created based on the arguments above:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_create_arguments]
-    :end-before: [END howto_operator_cloudsql_create_arguments]
-
-Example body defining the instance with failover replica:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_create_body]
-    :end-before: [END howto_operator_cloudsql_create_body]
-
-Example body defining read replica for the instance above:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_create_replica]
-    :end-before: [END howto_operator_cloudsql_create_replica]
-
-Note: Failover replicas are created together with the instance in a single task.
-Read replicas need to be created in separate tasks.
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_create]
-    :end-before: [END howto_operator_cloudsql_create]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_create_template_fields]
-  :end-before: [END gcp_sql_create_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for insert
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
-
-.. _howto/operator:CloudSqlInstancePatchOperator:
-
-CloudSqlInstancePatchOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Updates settings of a Cloud SQL instance in Google Cloud Platform (partial update).
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator`.
-
-This is a partial update, so only values for the settings specified in the body
-will be set / updated. The rest of the existing instance's configuration will remain
-unchanged.
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_arguments]
-    :end-before: [END howto_operator_cloudsql_arguments]
-
-Example body defining the instance:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :start-after: [START howto_operator_cloudsql_patch_body]
-    :end-before: [END howto_operator_cloudsql_patch_body]
-
-Using the operator
-""""""""""""""""""
-
-You can create the operator with or without project id. If project id is missing
-it will be retrieved from the GCP connection used. Both variants are shown:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_cloudsql_patch]
-    :end-before: [END howto_operator_cloudsql_patch]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-  :language: python
-  :dedent: 4
-  :start-after: [START gcp_sql_patch_template_fields]
-  :end-before: [END gcp_sql_patch_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL API documentation for patch
-<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
-
-.. _howto/operator:CloudSqlQueryOperator:
-
-CloudSqlQueryOperator
-^^^^^^^^^^^^^^^^^^^^^
-
-Performs DDL or DML SQL queries in Google Cloud SQL instance. The DQL
-(retrieving data from Google Cloud SQL) is not supported. You might run the SELECT
-queries, but the results of those queries are discarded.
-
-You can specify various connectivity methods to connect to running instance,
-starting from public IP plain connection through public IP with SSL or both TCP and
-socket connection via Cloud SQL Proxy. The proxy is downloaded and started/stopped
-dynamically as needed by the operator.
-
-There is a *gcpcloudsql://* connection type that you should use to define what
-kind of connectivity you want the operator to use. The connection is a "meta"
-type of connection. It is not used to make an actual connectivity on its own, but it
-determines whether Cloud SQL Proxy should be started by `CloudSqlDatabaseHook`
-and what kind of database connection (Postgres or MySQL) should be created
-dynamically to connect to Cloud SQL via public IP address or via the proxy.
-The 'CloudSqlDatabaseHook` uses
-:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to manage Cloud SQL
-Proxy lifecycle (each task has its own Cloud SQL Proxy)
-
-When you build connection, you should use connection parameters as described in
-:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`. You can see
-examples of connections below for all the possible types of connectivity. Such connection
-can be reused between different tasks (instances of `CloudSqlQueryOperator`). Each
-task will get their own proxy started if needed with their own TCP or UNIX socket.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator`.
-
-Since query operator can run arbitrary query, it cannot be guaranteed to be
-idempotent. SQL query designer should design the queries to be idempotent. For example,
-both Postgres and MySQL support CREATE TABLE IF NOT EXISTS statements that can be
-used to create tables in an idempotent way.
-
-Arguments
-"""""""""
-
-If you define connection via `AIRFLOW_CONN_*` URL defined in an environment
-variable, make sure the URL components in the URL are URL-encoded.
-See examples below for details.
-
-Note that in case of SSL connections you need to have a mechanism to make the
-certificate/key files available in predefined locations for all the workers on
-which the operator can run. This can be provided for example by mounting
-NFS-like volumes in the same path for all the workers.
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
-      :language: python
-      :start-after: [START howto_operator_cloudsql_query_arguments]
-      :end-before: [END howto_operator_cloudsql_query_arguments]
-
-Example connection definitions for all connectivity cases. Note that all the components
-of the connection URI should be URL-encoded:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
-      :language: python
-      :start-after: [START howto_operator_cloudsql_query_connections]
-      :end-before: [END howto_operator_cloudsql_query_connections]
-
-Using the operator
-""""""""""""""""""
-
-Example operators below are using all connectivity options. Note connection id
-from the operator matches the `AIRFLOW_CONN_*` postfix uppercase. This is
-standard AIRFLOW notation for defining connection via environment variables):
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_sql_query.py
-      :language: python
-      :start-after: [START howto_operator_cloudsql_query_operators]
-      :end-before: [END howto_operator_cloudsql_query_operators]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_sql_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcp_sql_query_template_fields]
-    :end-before: [END gcp_sql_query_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud SQL Proxy documentation
-<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_.
-
-Google Cloud Storage Operators
-------------------------------
-
-.. _howto/operator:GoogleCloudStorageBucketCreateAclEntryOperator:
-
-GoogleCloudStorageBucketCreateAclEntryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new ACL entry on the specified bucket.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
-      :language: python
-      :start-after: [START howto_operator_gcs_acl_args_common]
-      :end-before: [END howto_operator_gcs_acl_args_common]
-
-Using the operator
-""""""""""""""""""
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_gcs_bucket_create_acl_entry_task]
-      :end-before: [END howto_operator_gcs_bucket_create_acl_entry_task]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcs_acl_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcs_bucket_create_acl_template_fields]
-    :end-before: [END gcs_bucket_create_acl_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Storage BucketAccessControls insert documentation
-<https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_.
-
-.. _howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator:
-
-GoogleCloudStorageObjectCreateAclEntryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new ACL entry on the specified object.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
-      :language: python
-      :start-after: [START howto_operator_gcs_acl_args_common]
-      :end-before: [END howto_operator_gcs_acl_args_common]
-
-Using the operator
-""""""""""""""""""
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcs_acl.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_gcs_object_create_acl_entry_task]
-      :end-before: [END howto_operator_gcs_object_create_acl_entry_task]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcs_acl_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START gcs_object_create_acl_template_fields]
-    :end-before: [END gcs_object_create_acl_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Storage ObjectAccessControls insert documentation
-<https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_.
-
-Google Cloud Vision Operators
-------------------------------
-
-.. _howto/operator:CloudVisionProductSetCreateOperator:
-
-CloudVisionProductSetCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates a new :code:`ProductSet` resource.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_explicit_id]
-      :end-before: [END howto_operator_vision_productset_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_import]
-      :end-before: [END howto_operator_vision_productset_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_retry_import]
-      :end-before: [END howto_operator_vision_retry_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset]
-      :end-before: [END howto_operator_vision_productset]
-
-The ``product_set_id`` argument can be omitted (it will be generated by the API):
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_create]
-      :end-before: [END howto_operator_vision_product_set_create]
-
-Or it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_create_2]
-      :end-before: [END howto_operator_vision_product_set_create_2]
-
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_productset_create_template_fields]
-    :end-before: [END vision_productset_create_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision ProductSet create documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product_set>`_.
-
-.. _howto/operator:CloudVisionProductSetGetOperator:
-
-CloudVisionProductSetGetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Gets information associated with a :code:`ProductSet`.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_explicit_id]
-      :end-before: [END howto_operator_vision_productset_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-If ``product_set_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_get]
-      :end-before: [END howto_operator_vision_product_set_get]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_get_2]
-      :end-before: [END howto_operator_vision_product_set_get_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_productset_get_template_fields]
-    :end-before: [END vision_productset_get_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision ProductSet get documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product_set>`_.
-
-.. _howto/operator:CloudVisionProductSetUpdateOperator:
-
-CloudVisionProductSetUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Makes changes to a :code:`ProductSet` resource. Only :code:`display_name` can be updated
-currently.
-
-.. note:: To locate the `ProductSet` resource, its `name` in the form
-  ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`` is necessary.
-
-You can provide the `name` directly as an attribute of the `product_set` object.
-However, you can leave it blank and provide `location` and `product_set_id` instead (and
-optionally `project_id` - if not present, the connection default will be used) and the
-`name` will be created by the operator itself.
-
-This mechanism exists for your convenience, to allow leaving the `project_id` empty and
-having Airflow use the connection default `project_id`.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_explicit_id]
-      :end-before: [END howto_operator_vision_productset_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-We are using the ``ProductSet`` object from the Google Cloud Vision library:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_import]
-      :end-before: [END howto_operator_vision_productset_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset]
-      :end-before: [END howto_operator_vision_productset]
-
-Initialization of the task:
-
-If ``product_set_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_update]
-      :end-before: [END howto_operator_vision_product_set_update]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_update_2]
-      :end-before: [END howto_operator_vision_product_set_update_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_productset_update_template_fields]
-    :end-before: [END vision_productset_update_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision ProductSet update documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product_set>`_.
-
-.. _howto/operator:CloudVisionProductSetDeleteOperator:
-
-CloudVisionProductSetDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Permanently deletes a :code:`ProductSet`. :code:`Products` and :code:`ReferenceImages` in
-the :code:`ProductSet` are not deleted. The actual image files are not deleted from
-Google Cloud Storage.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_productset_explicit_id]
-      :end-before: [END howto_operator_vision_productset_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-If ``product_set_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_delete]
-      :end-before: [END howto_operator_vision_product_set_delete]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_set_delete_2]
-      :end-before: [END howto_operator_vision_product_set_delete_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_productset_delete_template_fields]
-    :end-before: [END vision_productset_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision ProductSet delete documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product_set>`_.
-
-.. _howto/operator:CloudVisionProductCreateOperator:
-
-CloudVisionProductCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates and returns a new product resource.
-
-Possible errors regarding the :code:`Product` object provided:
-
-- Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
-- Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
-- Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_explicit_id]
-      :end-before: [END howto_operator_vision_product_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-We are using the ``Product`` and ``Retry`` objects from Google libraries:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_import]
-      :end-before: [END howto_operator_vision_product_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_retry_import]
-      :end-before: [END howto_operator_vision_retry_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product]
-      :end-before: [END howto_operator_vision_product]
-
-The ``product_id`` argument can be omitted (it will be generated by the API):
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_create]
-      :end-before: [END howto_operator_vision_product_create]
-
-Or it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_create_2]
-      :end-before: [END howto_operator_vision_product_create_2]
-
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_product_create_template_fields]
-    :end-before: [END vision_product_create_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision Product create documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product>`_.
-
-.. _howto/operator:CloudVisionProductGetOperator:
-
-CloudVisionProductGetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Gets information associated with a :code:`Product`.
-
-Possible errors:
-
-- Returns NOT_FOUND if the `Product` does not exist.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_explicit_id]
-      :end-before: [END howto_operator_vision_product_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-If ``product_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_get]
-      :end-before: [END howto_operator_vision_product_get]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_get_2]
-      :end-before: [END howto_operator_vision_product_get_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_product_get_template_fields]
-    :end-before: [END vision_product_get_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision Product get documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product>`_.
-
-.. _howto/operator:CloudVisionProductUpdateOperator:
-
-CloudVisionProductUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Makes changes to a :code:`Product` resource. Only the :code:`display_name`,
-:code:`description`, and :code:`labels` fields can be updated right now.
-If labels are updated, the change will not be reflected in queries until the next index
-time.
-
-.. note:: To locate the `Product` resource, its `name` in the form
-  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`` is necessary.
-
-You can provide the `name` directly as an attribute of the `product` object. However, you
-can leave it blank and provide `location` and `product_id` instead (and optionally
-`project_id` - if not present, the connection default will be used) and the `name` will
-be created by the operator itself.
-
-This mechanism exists for your convenience, to allow leaving the `project_id` empty and
-having Airflow use the connection default `project_id`.
-
-Possible errors:
-
-- Returns NOT_FOUND if the `Product` does not exist.
-- Returns INVALID_ARGUMENT if `display_name` is present in `update_mask` but is missing
-  from the request or longer than 4096 characters.
-- Returns INVALID_ARGUMENT if `description` is present in `update_mask` but is longer than
-  4096 characters.
-- Returns INVALID_ARGUMENT if `product_category` is present in `update_mask`.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_explicit_id]
-      :end-before: [END howto_operator_vision_product_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-We are using the ``Product`` object from the Google Cloud Vision library:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_import]
-      :end-before: [END howto_operator_vision_product_import]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product]
-      :end-before: [END howto_operator_vision_product]
-
-If ``product_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_update]
-      :end-before: [END howto_operator_vision_product_update]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_update_2]
-      :end-before: [END howto_operator_vision_product_update_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_product_update_template_fields]
-    :end-before: [END vision_product_update_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision Product update documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product>`_.
-
-.. _howto/operator:CloudVisionProductDeleteOperator:
-
-CloudVisionProductDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Permanently deletes a product and its reference images.
-
-Metadata of the product and all its images will be deleted right away, but search queries
-against :code:`ProductSets` containing the product may still work until all related
-caches are refreshed.
-
-Possible errors:
-
-- Returns NOT_FOUND if the product does not exist.
-
-For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
-
-Arguments
-"""""""""
-
-Some arguments in the example DAG are taken from the OS environment variables:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_args_common]
-      :end-before: [END howto_operator_vision_args_common]
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :start-after: [START howto_operator_vision_product_explicit_id]
-      :end-before: [END howto_operator_vision_product_explicit_id]
-
-Using the operator
-""""""""""""""""""
-
-If ``product_id`` was generated by the API it can be extracted from XCOM:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_delete]
-      :end-before: [END howto_operator_vision_product_delete]
-
-Otherwise it can be specified explicitly:
-
-.. literalinclude:: ../../airflow/contrib/example_dags/example_gcp_vision.py
-      :language: python
-      :dedent: 4
-      :start-after: [START howto_operator_vision_product_delete_2]
-      :end-before: [END howto_operator_vision_product_delete_2]
-
-Templating
-""""""""""
-
-.. literalinclude:: ../../airflow/contrib/operators/gcp_vision_operator.py
-    :language: python
-    :dedent: 4
-    :start-after: [START vision_product_delete_template_fields]
-    :end-before: [END vision_product_delete_template_fields]
-
-More information
-""""""""""""""""
-
-See `Google Cloud Vision Product delete documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product>`_.
->>>>>>> ce499bb2... [AIRFLOW-3701] Add Google Cloud Vision Product Search operators (#4665)
diff --git a/docs/howto/operator/bash.rst b/docs/howto/operator/bash.rst
new file mode 100644
index 0000000000000..463056196ee49
--- /dev/null
+++ b/docs/howto/operator/bash.rst
@@ -0,0 +1,60 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+BashOperator
+============
+
+Use the :class:`~airflow.operators.bash_operator.BashOperator` to execute
+commands in a `Bash <https://www.gnu.org/software/bash/>`__ shell.
+
+.. literalinclude:: ../../../airflow/example_dags/example_bash_operator.py
+    :language: python
+    :start-after: [START howto_operator_bash]
+    :end-before: [END howto_operator_bash]
+
+Templating
+----------
+
+You can use :ref:`Jinja templates <jinja-templating>` to parameterize the
+``bash_command`` argument.
+
+.. literalinclude:: ../../../airflow/example_dags/example_bash_operator.py
+    :language: python
+    :start-after: [START howto_operator_bash_template]
+    :end-before: [END howto_operator_bash_template]
+
+Troubleshooting
+---------------
+
+Jinja template not found
+""""""""""""""""""""""""
+
+Add a space after the script name when directly calling a Bash script with
+the ``bash_command`` argument. This is because Airflow tries to apply a Jinja
+template to it, which will fail.
+
+.. code-block:: python
+
+    t2 = BashOperator(
+        task_id='bash_example',
+
+        # This fails with `Jinja template not found` error
+        # bash_command="/home/batcher/test.sh",
+
+        # This works (has a space after)
+        bash_command="/home/batcher/test.sh ",
+        dag=dag)
diff --git a/docs/howto/operator/gcp/bigtable.rst b/docs/howto/operator/gcp/bigtable.rst
new file mode 100644
index 0000000000000..4fcdd85fb6624
--- /dev/null
+++ b/docs/howto/operator/gcp/bigtable.rst
@@ -0,0 +1,170 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Bigtable Operators
+===============================
+
+.. contents::
+  :depth: 1
+  :local:
+
+All examples below rely on the following variables, which can be passed via environment variables.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :start-after: [START howto_operator_gcp_bigtable_args]
+    :end-before: [END howto_operator_gcp_bigtable_args]
+
+.. _howto/operator:BigtableInstanceCreateOperator:
+
+BigtableInstanceCreateOperator
+------------------------------
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator`
+to create a Google Cloud Bigtable instance.
+
+If the Cloud Bigtable instance with the given ID exists, the operator does not compare its configuration
+and immediately succeeds. No changes are made to the existing instance.
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_instance_create]
+    :end-before: [END howto_operator_gcp_bigtable_instance_create]
+
+.. _howto/operator:BigtableInstanceDeleteOperator:
+
+BigtableInstanceDeleteOperator
+------------------------------
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator`
+to delete a Google Cloud Bigtable instance.
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_instance_delete]
+    :end-before: [END howto_operator_gcp_bigtable_instance_delete]
+
+.. _howto/operator:BigtableClusterUpdateOperator:
+
+BigtableClusterUpdateOperator
+-----------------------------
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator`
+to modify number of nodes in a Cloud Bigtable cluster.
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_cluster_update]
+    :end-before: [END howto_operator_gcp_bigtable_cluster_update]
+
+.. _howto/operator:BigtableTableCreateOperator:
+
+BigtableTableCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a table in a Cloud Bigtable instance.
+
+If the table with given ID exists in the Cloud Bigtable instance, the operator compares the Column Families.
+If the Column Families are identical operator succeeds. Otherwise, the operator fails with the appropriate
+error message.
+
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_create]
+    :end-before: [END howto_operator_gcp_bigtable_table_create]
+
+Advanced
+""""""""
+
+When creating a table, you can specify the optional ``initial_split_keys`` and ``column_families``.
+Please refer to the Python Client for Google Cloud Bigtable documentation
+`for Table <https://googleapis.github.io/google-cloud-python/latest/bigtable/table.html>`_ and `for Column
+Families <https://googleapis.github.io/google-cloud-python/latest/bigtable/column-family.html>`_.
+
+.. _howto/operator:BigtableTableDeleteOperator:
+
+BigtableTableDeleteOperator
+---------------------------
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator`
+to delete a table in Google Cloud Bigtable.
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_delete]
+    :end-before: [END howto_operator_gcp_bigtable_table_delete]
+
+.. _howto/operator:BigtableTableWaitForReplicationSensor:
+
+BigtableTableWaitForReplicationSensor
+-------------------------------------
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+Use the :class:`~airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor`
+to wait for the table to replicate fully.
+
+The same arguments apply to this sensor as the BigtableTableCreateOperator_.
+
+**Note:** If the table or the Cloud Bigtable instance does not exist, this sensor waits for the table until
+timeout hits and does not raise any exception.
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_bigtable_table_wait_for_replication]
+    :end-before: [END howto_operator_gcp_bigtable_table_wait_for_replication]
diff --git a/docs/howto/operator/gcp/compute.rst b/docs/howto/operator/gcp/compute.rst
new file mode 100644
index 0000000000000..cc26005dabf4e
--- /dev/null
+++ b/docs/howto/operator/gcp/compute.rst
@@ -0,0 +1,325 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Compute Engine Operators
+===============================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:GceInstanceStartOperator:
+
+GceInstanceStartOperator
+------------------------
+
+Use the
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator`
+to start an existing Google Compute Engine instance.
+
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables used to pass arguments to the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args_common]
+    :end-before: [END howto_operator_gce_args_common]
+
+Using the operator
+""""""""""""""""""
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_start]
+    :end-before: [END howto_operator_gce_start]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection id used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_start_no_project_id]
+    :end-before: [END howto_operator_gce_start_no_project_id]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_start_template_fields]
+    :end-before: [END gce_instance_start_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation for start
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
+
+.. _howto/operator:GceInstanceStopOperator:
+
+GceInstanceStopOperator
+-----------------------
+
+Use the operator to stop Google Compute Engine instance.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator`
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables used to pass arguments to the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+   :language: python
+   :start-after: [START howto_operator_gce_args_common]
+   :end-before: [END howto_operator_gce_args_common]
+
+Using the operator
+""""""""""""""""""
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_stop]
+    :end-before: [END howto_operator_gce_stop]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_stop_no_project_id]
+    :end-before: [END howto_operator_gce_stop_no_project_id]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_stop_template_fields]
+    :end-before: [END gce_instance_stop_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation for stop
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
+
+.. _howto/operator:GceSetMachineTypeOperator:
+
+GceSetMachineTypeOperator
+-------------------------
+
+Use the operator to change machine type of a Google Compute Engine instance.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables used to pass arguments to the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args_common]
+    :end-before: [END howto_operator_gce_args_common]
+
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :start-after: [START howto_operator_gce_args_set_machine_type]
+    :end-before: [END howto_operator_gce_args_set_machine_type]
+
+Using the operator
+""""""""""""""""""
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_set_machine_type]
+    :end-before: [END howto_operator_gce_set_machine_type]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_set_machine_type_no_project_id]
+    :end-before: [END howto_operator_gce_set_machine_type_no_project_id]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_set_machine_type_template_fields]
+    :end-before: [END gce_instance_set_machine_type_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation for setMachineType
+<https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
+
+.. _howto/operator:GceInstanceTemplateCopyOperator:
+
+GceInstanceTemplateCopyOperator
+-------------------------------
+
+Use the operator to copy an existing Google Compute Engine instance template
+applying a patch to it.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables used to pass arguments to the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_common_args]
+    :end-before: [END howto_operator_compute_igm_common_args]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_template_copy_args]
+    :end-before: [END howto_operator_compute_template_copy_args]
+
+Using the operator
+""""""""""""""""""
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_copy_template]
+    :end-before: [END howto_operator_gce_igm_copy_template]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_copy_template_no_project_id]
+    :end-before: [END howto_operator_gce_igm_copy_template_no_project_id]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_instance_template_copy_operator_template_fields]
+    :end-before: [END gce_instance_template_copy_operator_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation for instanceTemplates
+<https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
+
+.. _howto/operator:GceInstanceGroupManagerUpdateTemplateOperator:
+
+GceInstanceGroupManagerUpdateTemplateOperator
+---------------------------------------------
+
+Use the operator to update template in Google Compute Engine Instance Group Manager.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables used to pass arguments to the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_common_args]
+    :end-before: [END howto_operator_compute_igm_common_args]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :start-after: [START howto_operator_compute_igm_update_template_args]
+    :end-before: [END howto_operator_compute_igm_update_template_args]
+
+Using the operator
+""""""""""""""""""
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_update_template]
+    :end-before: [END howto_operator_gce_igm_update_template]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gce_igm_update_template_no_project_id]
+    :end-before: [END howto_operator_gce_igm_update_template_no_project_id]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gce_igm_update_template_operator_template_fields]
+    :end-before: [END gce_igm_update_template_operator_template_fields]
+
+Troubleshooting
+"""""""""""""""
+
+You might find that your GceInstanceGroupManagerUpdateTemplateOperator fails with
+missing permissions. To execute the operation, the service account requires
+the permissions that theService Account User role provides
+(assigned via Google Cloud IAM).
+
+More information
+""""""""""""""""
+
+See `Google Compute Engine API documentation for instanceGroupManagers
+<https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_.
diff --git a/docs/howto/operator/gcp/function.rst b/docs/howto/operator/gcp/function.rst
new file mode 100644
index 0000000000000..14e7722f3969f
--- /dev/null
+++ b/docs/howto/operator/gcp/function.rst
@@ -0,0 +1,202 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Functions Operators
+================================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:GcfFunctionDeleteOperator:
+
+GcfFunctionDeleteOperator
+-------------------------
+
+Use the operator to delete a function from Google Cloud Functions.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`.
+
+Arguments
+"""""""""
+
+The following examples of OS environment variables show how you can build function name
+to use in the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_common_variables]
+    :end-before: [END howto_operator_gcf_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcf_delete]
+    :end-before: [END howto_operator_gcf_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcf_function_delete_template_fields]
+    :end-before: [END gcf_function_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Functions API documentation for delete
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
+
+.. _howto/operator:GcfFunctionDeployOperator:
+
+GcfFunctionDeployOperator
+-------------------------
+
+Use the operator to deploy a function to Google Cloud Functions.
+If a function with this name already exists, it will be updated.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`.
+
+
+Arguments
+"""""""""
+
+In the example DAG the following environment variables are used to parameterize the
+operator's definition:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_common_variables]
+    :end-before: [END howto_operator_gcf_common_variables]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_variables]
+    :end-before: [END howto_operator_gcf_deploy_variables]
+
+Some of those variables are used to create the request's body:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_body]
+    :end-before: [END howto_operator_gcf_deploy_body]
+
+When a DAG is created, the default_args dictionary can be used to pass
+arguments common with other tasks:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_default_args]
+    :end-before: [END howto_operator_gcf_default_args]
+
+Note that the neither the body nor the default args are complete in the above examples.
+Depending on the variables set, there might be different variants on how to pass source
+code related fields. Currently, you can pass either ``sourceArchiveUrl``,
+``sourceRepository`` or ``sourceUploadUrl`` as described in the
+`Cloud Functions API specification
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#CloudFunction>`_.
+
+Additionally, ``default_args`` or direct operator args might contain ``zip_path``
+parameter
+to run the extra step of uploading the source code before deploying it.
+In this case, you also need to provide an empty ``sourceUploadUrl``
+parameter in the body.
+
+Using the operator
+""""""""""""""""""
+
+Depending on the combination of parameters, the Function's source code can be obtained
+from different sources:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :start-after: [START howto_operator_gcf_deploy_variants]
+    :end-before: [END howto_operator_gcf_deploy_variants]
+
+The code to create the operator:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcf_deploy]
+    :end-before: [END howto_operator_gcf_deploy]
+
+You can also create the operator without project id - project id will be retrieved
+from the GCP connection used:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcf_deploy_no_project_id]
+    :end-before: [END howto_operator_gcf_deploy_no_project_id]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcf_function_deploy_template_fields]
+    :end-before: [END gcf_function_deploy_template_fields]
+
+
+Troubleshooting
+"""""""""""""""
+
+If during the deploy you see an error similar to:
+
+`"HttpError 403: Missing necessary permission iam.serviceAccounts.actAs for on resource
+project-name@appspot.gserviceaccount.com. Please grant the
+roles/iam.serviceAccountUser role."`
+
+it means that your service account does not have the correct Cloud IAM permissions.
+
+1. Assign your Service Account the Cloud Functions Developer role.
+2. Grant the user the Cloud IAM Service Account User role on the Cloud Functions runtime
+   service account.
+
+The typical way of assigning Cloud IAM permissions with `gcloud` is
+shown below. Just replace PROJECT_ID with ID of your Google Cloud Platform project
+and SERVICE_ACCOUNT_EMAIL with the email ID of your service account.
+
+.. code-block:: bash
+
+  gcloud iam service-accounts add-iam-policy-binding \
+    PROJECT_ID@appspot.gserviceaccount.com \
+    --member="serviceAccount:[SERVICE_ACCOUNT_EMAIL]" \
+    --role="roles/iam.serviceAccountUser"
+
+You can also do that via the GCP Web console.
+
+See `Adding the IAM service agent user role to the runtime service <https://cloud.google.com/functions/docs/reference/iam/roles#adding_the_iam_service_agent_user_role_to_the_runtime_service_account>`_  for details.
+
+If the source code for your function is in Google Source Repository, make sure that
+your service account has the Source Repository Viewer role so that the source code
+can be downloaded if necessary.
+
+More information
+""""""""""""""""
+
+See `Google Cloud Functions API documentation for create
+<https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_.
diff --git a/docs/howto/operator/gcp/gcs.rst b/docs/howto/operator/gcp/gcs.rst
new file mode 100644
index 0000000000000..c277900c51702
--- /dev/null
+++ b/docs/howto/operator/gcp/gcs.rst
@@ -0,0 +1,127 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Storage Operators
+==============================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:GoogleCloudStorageToBigQueryOperator:
+
+GoogleCloudStorageToBigQueryOperator
+------------------------------------
+
+Use the
+:class:`~airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator`
+to execute a BigQuery load job.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_to_bq_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcs_to_bq]
+    :end-before: [END howto_operator_gcs_to_bq]
+
+
+.. _howto/operator:GoogleCloudStorageBucketCreateAclEntryOperator:
+
+GoogleCloudStorageBucketCreateAclEntryOperator
+----------------------------------------------
+
+Creates a new ACL entry on the specified bucket.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+    :language: python
+    :start-after: [START howto_operator_gcs_acl_args_common]
+    :end-before: [END howto_operator_gcs_acl_args_common]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcs_bucket_create_acl_entry_task]
+    :end-before: [END howto_operator_gcs_bucket_create_acl_entry_task]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcs_bucket_create_acl_template_fields]
+    :end-before: [END gcs_bucket_create_acl_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Storage BucketAccessControls insert documentation
+<https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_.
+
+.. _howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator:
+
+GoogleCloudStorageObjectCreateAclEntryOperator
+----------------------------------------------
+
+Creates a new ACL entry on the specified object.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+    :language: python
+    :start-after: [START howto_operator_gcs_acl_args_common]
+    :end-before: [END howto_operator_gcs_acl_args_common]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcs_object_create_acl_entry_task]
+    :end-before: [END howto_operator_gcs_object_create_acl_entry_task]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcs_object_create_acl_template_fields]
+    :end-before: [END gcs_object_create_acl_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Storage ObjectAccessControls insert documentation
+<https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_.
diff --git a/docs/howto/operator/gcp/index.rst b/docs/howto/operator/gcp/index.rst
new file mode 100644
index 0000000000000..bee1c8de0227b
--- /dev/null
+++ b/docs/howto/operator/gcp/index.rst
@@ -0,0 +1,26 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Operators
+======================
+
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    *
diff --git a/docs/howto/operator/gcp/spanner.rst b/docs/howto/operator/gcp/spanner.rst
new file mode 100644
index 0000000000000..0ad700cf68b46
--- /dev/null
+++ b/docs/howto/operator/gcp/spanner.rst
@@ -0,0 +1,276 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Spanner Operators
+==============================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:CloudSpannerInstanceDatabaseDeleteOperator:
+
+CloudSpannerInstanceDatabaseDeleteOperator
+------------------------------------------
+
+Deletes a database from the specified Cloud Spanner instance. If the database does not
+exist, no action is taken, and the operator succeeds.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_delete]
+    :end-before: [END howto_operator_spanner_database_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_delete_template_fields]
+    :end-before: [END gcp_spanner_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Spanner API documentation for database drop call
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/dropDatabase>`_.
+
+.. _howto/operator:CloudSpannerInstanceDatabaseDeployOperator:
+
+CloudSpannerInstanceDatabaseDeployOperator
+------------------------------------------
+
+Creates a new Cloud Spanner database in the specified instance, or if the
+desired database exists, assumes success with no changes applied to database
+configuration. No structure of the database is verified - it's enough if the database exists
+with the same name.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_deploy]
+    :end-before: [END howto_operator_spanner_database_deploy]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_database_deploy_template_fields]
+    :end-before: [END gcp_spanner_database_deploy_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for `database create
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_
+
+.. _howto/operator:CloudSpannerInstanceDatabaseUpdateOperator:
+
+CloudSpannerInstanceDatabaseUpdateOperator
+------------------------------------------
+
+Runs a DDL query in a Cloud Spanner database and allows you to modify the structure of an
+existing database.
+
+You can optionally specify an operation_id parameter which simplifies determining whether
+the statements were executed in case the update_database call is replayed
+(idempotency check). The operation_id should be unique within the database, and must be
+a valid identifier: `[a-z][a-z0-9_]*`. More information can be found in
+`the documentation of updateDdl API <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_update]
+    :end-before: [END howto_operator_spanner_database_update]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_database_update_idempotent]
+    :end-before: [END howto_operator_spanner_database_update_idempotent]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_database_update_template_fields]
+    :end-before: [END gcp_spanner_database_update_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for `database update_ddl
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/updateDdl>`_.
+
+.. _howto/operator:CloudSpannerInstanceDatabaseQueryOperator:
+
+CloudSpannerInstanceDatabaseQueryOperator
+-----------------------------------------
+
+Executes an arbitrary DML query (INSERT, UPDATE, DELETE).
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables.
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_query]
+    :end-before: [END howto_operator_spanner_query]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_query_template_fields]
+    :end-before: [END gcp_spanner_query_template_fields]
+
+More information
+""""""""""""""""
+
+See Google Cloud Spanner API documentation for `the DML syntax
+<https://cloud.google.com/spanner/docs/dml-syntax>`_.
+
+.. _howto/operator:CloudSpannerInstanceDeleteOperator:
+
+CloudSpannerInstanceDeleteOperator
+----------------------------------
+
+Deletes a Cloud Spanner instance. If an instance does not exist, no action is taken,
+and the operator succeeds.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :start-after: [START howto_operator_spanner_arguments]
+    :end-before: [END howto_operator_spanner_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_spanner_delete]
+    :end-before: [END howto_operator_spanner_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_spanner_delete_template_fields]
+    :end-before: [END gcp_spanner_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Spanner API documentation for instance delete
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/delete>`_.
diff --git a/docs/howto/operator/gcp/sql.rst b/docs/howto/operator/gcp/sql.rst
new file mode 100644
index 0000000000000..e5eb41e131577
--- /dev/null
+++ b/docs/howto/operator/gcp/sql.rst
@@ -0,0 +1,643 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Sql Operators
+==========================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:CloudSqlInstanceDatabaseCreateOperator:
+
+CloudSqlInstanceDatabaseCreateOperator
+--------------------------------------
+
+Creates a new database inside a Cloud SQL instance.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_create]
+    :end-before: [END howto_operator_cloudsql_db_create]
+
+Example request body:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_db_create_body]
+    :end-before: [END howto_operator_cloudsql_db_create_body]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_db_create_template_fields]
+    :end-before: [END gcp_sql_db_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database insert
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert>`_.
+
+.. _howto/operator:CloudSqlInstanceDatabaseDeleteOperator:
+
+CloudSqlInstanceDatabaseDeleteOperator
+--------------------------------------
+
+Deletes a database from a Cloud SQL instance.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_delete]
+    :end-before: [END howto_operator_cloudsql_db_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_db_delete_template_fields]
+    :end-before: [END gcp_sql_db_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database delete
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/delete>`_.
+
+.. _howto/operator:CloudSqlInstanceDatabasePatchOperator:
+
+CloudSqlInstanceDatabasePatchOperator
+-------------------------------------
+
+Updates a resource containing information about a database inside a Cloud SQL instance
+using patch semantics.
+See: https://cloud.google.com/sql/docs/mysql/admin-api/how-tos/performance#patch
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_db_patch]
+    :end-before: [END howto_operator_cloudsql_db_patch]
+
+Example request body:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_db_patch_body]
+    :end-before: [END howto_operator_cloudsql_db_patch_body]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_db_patch_template_fields]
+    :end-before: [END gcp_sql_db_patch_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for database patch
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch>`_.
+
+.. _howto/operator:CloudSqlInstanceDeleteOperator:
+
+CloudSqlInstanceDeleteOperator
+------------------------------
+
+Deletes a Cloud SQL instance in Google Cloud Platform.
+
+It is also used for deleting read and failover replicas.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_delete]
+    :end-before: [END howto_operator_cloudsql_delete]
+
+Note: If the instance has read or failover replicas you need to delete them before you delete the primary instance.
+Replicas are deleted the same way as primary instances:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_replicas_delete]
+    :end-before: [END howto_operator_cloudsql_replicas_delete]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_delete_template_fields]
+    :end-before: [END gcp_sql_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for delete
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
+
+.. _howto/operator:CloudSqlInstanceExportOperator:
+
+CloudSqlInstanceExportOperator
+------------------------------
+
+Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
+or CSV file.
+
+.. note::
+    This operator is idempotent. If executed multiple times with the same
+    export file URI, the export file in GCS will simply be overridden.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_import_arguments]
+    :end-before: [END howto_operator_cloudsql_export_import_arguments]
+
+Example body defining the export operation:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_body]
+    :end-before: [END howto_operator_cloudsql_export_body]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_export]
+    :end-before: [END howto_operator_cloudsql_export]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_export_template_fields]
+    :end-before: [END gcp_sql_export_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for export <https://cloud.google
+.com/sql/docs/mysql/admin-api/v1beta4/instances/export>`_.
+
+Troubleshooting
+"""""""""""""""
+
+If you receive an "Unauthorized" error in GCP, make sure that the service account
+of the Cloud SQL instance is authorized to write to the selected GCS bucket.
+
+It is not the service account configured in Airflow that communicates with GCS,
+but rather the service account of the particular Cloud SQL instance.
+
+To grant the service account with the appropriate WRITE permissions for the GCS bucket
+you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`,
+as shown in the example:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_export_gcs_permissions]
+    :end-before: [END howto_operator_cloudsql_export_gcs_permissions]
+
+
+.. _howto/operator:CloudSqlInstanceImportOperator:
+
+CloudSqlInstanceImportOperator
+------------------------------
+
+Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud Storage.
+
+CSV import:
+"""""""""""
+
+This operator is NOT idempotent for a CSV import. If the same file is imported
+multiple times, the imported data will be duplicated in the database.
+Moreover, if there are any unique constraints the duplicate import may result in an
+error.
+
+SQL import:
+"""""""""""
+
+This operator is idempotent for a SQL import if it was also exported by Cloud SQL.
+The exported SQL contains 'DROP TABLE IF EXISTS' statements for all tables
+to be imported.
+
+If the import file was generated in a different way, idempotence is not guaranteed.
+It has to be ensured on the SQL file level.
+
+For parameter definition take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator`.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from Airflow variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_export_import_arguments]
+    :end-before: [END howto_operator_cloudsql_export_import_arguments]
+
+Example body defining the import operation:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_import_body]
+    :end-before: [END howto_operator_cloudsql_import_body]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_import]
+    :end-before: [END howto_operator_cloudsql_import]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_import_template_fields]
+    :end-before: [END gcp_sql_import_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for import <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/import>`_.
+
+Troubleshooting
+"""""""""""""""
+
+If you receive an "Unauthorized" error in GCP, make sure that the service account
+of the Cloud SQL instance is authorized to read from the selected GCS object.
+
+It is not the service account configured in Airflow that communicates with GCS,
+but rather the service account of the particular Cloud SQL instance.
+
+To grant the service account with the appropriate READ permissions for the GCS object
+you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`,
+as shown in the example:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
+    :end-before: [END howto_operator_cloudsql_import_gcs_permissions]
+
+.. _howto/operator:CloudSqlInstanceCreateOperator:
+
+CloudSqlInstanceCreateOperator
+------------------------------
+
+Creates a new Cloud SQL instance in Google Cloud Platform.
+
+It is also used for creating read replicas.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`.
+
+If an instance with the same name exists, no action will be taken and the operator
+will succeed.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Some other arguments are created based on the arguments above:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_arguments]
+    :end-before: [END howto_operator_cloudsql_create_arguments]
+
+Example body defining the instance with failover replica:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_body]
+    :end-before: [END howto_operator_cloudsql_create_body]
+
+Example body defining read replica for the instance above:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_create_replica]
+    :end-before: [END howto_operator_cloudsql_create_replica]
+
+Note: Failover replicas are created together with the instance in a single task.
+Read replicas need to be created in separate tasks.
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_create]
+    :end-before: [END howto_operator_cloudsql_create]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_create_template_fields]
+    :end-before: [END gcp_sql_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for insert
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
+
+.. _howto/operator:CloudSqlInstancePatchOperator:
+
+CloudSqlInstancePatchOperator
+-----------------------------
+
+Updates settings of a Cloud SQL instance in Google Cloud Platform (partial update).
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator`.
+
+This is a partial update, so only values for the settings specified in the body
+will be set / updated. The rest of the existing instance's configuration will remain
+unchanged.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_arguments]
+    :end-before: [END howto_operator_cloudsql_arguments]
+
+Example body defining the instance:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_patch_body]
+    :end-before: [END howto_operator_cloudsql_patch_body]
+
+Using the operator
+""""""""""""""""""
+
+You can create the operator with or without project id. If project id is missing
+it will be retrieved from the GCP connection used. Both variants are shown:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_cloudsql_patch]
+    :end-before: [END howto_operator_cloudsql_patch]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_patch_template_fields]
+    :end-before: [END gcp_sql_patch_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL API documentation for patch
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
+
+.. _howto/operator:CloudSqlQueryOperator:
+
+CloudSqlQueryOperator
+---------------------
+
+Performs DDL or DML SQL queries in Google Cloud SQL instance. The DQL
+(retrieving data from Google Cloud SQL) is not supported. You might run the SELECT
+queries, but the results of those queries are discarded.
+
+You can specify various connectivity methods to connect to running instance,
+starting from public IP plain connection through public IP with SSL or both TCP and
+socket connection via Cloud SQL Proxy. The proxy is downloaded and started/stopped
+dynamically as needed by the operator.
+
+There is a *gcpcloudsql://* connection type that you should use to define what
+kind of connectivity you want the operator to use. The connection is a "meta"
+type of connection. It is not used to make an actual connectivity on its own, but it
+determines whether Cloud SQL Proxy should be started by `CloudSqlDatabaseHook`
+and what kind of database connection (Postgres or MySQL) should be created
+dynamically to connect to Cloud SQL via public IP address or via the proxy.
+The 'CloudSqlDatabaseHook` uses
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner` to manage Cloud SQL
+Proxy lifecycle (each task has its own Cloud SQL Proxy)
+
+When you build connection, you should use connection parameters as described in
+:class:`~airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook`. You can see
+examples of connections below for all the possible types of connectivity. Such connection
+can be reused between different tasks (instances of `CloudSqlQueryOperator`). Each
+task will get their own proxy started if needed with their own TCP or UNIX socket.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator`.
+
+Since query operator can run arbitrary query, it cannot be guaranteed to be
+idempotent. SQL query designer should design the queries to be idempotent. For example,
+both Postgres and MySQL support CREATE TABLE IF NOT EXISTS statements that can be
+used to create tables in an idempotent way.
+
+Arguments
+"""""""""
+
+If you define connection via `AIRFLOW_CONN_*` URL defined in an environment
+variable, make sure the URL components in the URL are URL-encoded.
+See examples below for details.
+
+Note that in case of SSL connections you need to have a mechanism to make the
+certificate/key files available in predefined locations for all the workers on
+which the operator can run. This can be provided for example by mounting
+NFS-like volumes in the same path for all the workers.
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_query_arguments]
+    :end-before: [END howto_operator_cloudsql_query_arguments]
+
+Example connection definitions for all connectivity cases. Note that all the components
+of the connection URI should be URL-encoded:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_query_connections]
+    :end-before: [END howto_operator_cloudsql_query_connections]
+
+Using the operator
+""""""""""""""""""
+
+Example operators below are using all connectivity options. Note connection id
+from the operator matches the `AIRFLOW_CONN_*` postfix uppercase. This is
+standard AIRFLOW notation for defining connection via environment variables):
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+    :language: python
+    :start-after: [START howto_operator_cloudsql_query_operators]
+    :end-before: [END howto_operator_cloudsql_query_operators]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_sql_query_template_fields]
+    :end-before: [END gcp_sql_query_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud SQL Proxy documentation
+<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_.
diff --git a/docs/howto/operator/gcp/vision.rst b/docs/howto/operator/gcp/vision.rst
new file mode 100644
index 0000000000000..ee280cfa8ce72
--- /dev/null
+++ b/docs/howto/operator/gcp/vision.rst
@@ -0,0 +1,612 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Vision Operators
+=============================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:CloudVisionProductSetCreateOperator:
+
+CloudVisionProductSetCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates a new :code:`ProductSet` resource.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_explicit_id]
+    :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_import]
+    :end-before: [END howto_operator_vision_productset_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_retry_import]
+    :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset]
+    :end-before: [END howto_operator_vision_productset]
+
+The ``product_set_id`` argument can be omitted (it will be generated by the API):
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_create]
+    :end-before: [END howto_operator_vision_product_set_create]
+
+Or it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_create_2]
+    :end-before: [END howto_operator_vision_product_set_create_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_create_template_fields]
+    :end-before: [END vision_productset_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetGetOperator:
+
+CloudVisionProductSetGetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Gets information associated with a :code:`ProductSet`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_explicit_id]
+    :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_get]
+    :end-before: [END howto_operator_vision_product_set_get]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_get_2]
+    :end-before: [END howto_operator_vision_product_set_get_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_get_template_fields]
+    :end-before: [END vision_productset_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetUpdateOperator:
+
+CloudVisionProductSetUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Makes changes to a :code:`ProductSet` resource. Only :code:`display_name` can be updated
+currently.
+
+.. note:: To locate the `ProductSet` resource, its `name` in the form
+  ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`` is necessary.
+
+You can provide the `name` directly as an attribute of the `product_set` object.
+However, you can leave it blank and provide `location` and `product_set_id` instead (and
+optionally `project_id` - if not present, the connection default will be used) and the
+`name` will be created by the operator itself.
+
+This mechanism exists for your convenience, to allow leaving the `project_id` empty and
+having Airflow use the connection default `project_id`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_explicit_id]
+    :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``ProductSet`` object from the Google Cloud Vision library:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_import]
+    :end-before: [END howto_operator_vision_productset_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset]
+    :end-before: [END howto_operator_vision_productset]
+
+Initialization of the task:
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_update]
+    :end-before: [END howto_operator_vision_product_set_update]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_update_2]
+    :end-before: [END howto_operator_vision_product_set_update_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_update_template_fields]
+    :end-before: [END vision_productset_update_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet update documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product_set>`_.
+
+.. _howto/operator:CloudVisionProductSetDeleteOperator:
+
+CloudVisionProductSetDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Permanently deletes a :code:`ProductSet`. :code:`Products` and :code:`ReferenceImages` in
+the :code:`ProductSet` are not deleted. The actual image files are not deleted from
+Google Cloud Storage.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_productset_explicit_id]
+    :end-before: [END howto_operator_vision_productset_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_delete]
+    :end-before: [END howto_operator_vision_product_set_delete]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_set_delete_2]
+    :end-before: [END howto_operator_vision_product_set_delete_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_productset_delete_template_fields]
+    :end-before: [END vision_productset_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ProductSet delete documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product_set>`_.
+
+.. _howto/operator:CloudVisionProductCreateOperator:
+
+CloudVisionProductCreateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Creates and returns a new product resource.
+
+Possible errors regarding the :code:`Product` object provided:
+
+- Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``Product`` and ``Retry`` objects from Google libraries:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_import]
+    :end-before: [END howto_operator_vision_product_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_retry_import]
+    :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product]
+    :end-before: [END howto_operator_vision_product]
+
+The ``product_id`` argument can be omitted (it will be generated by the API):
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_create]
+    :end-before: [END howto_operator_vision_product_create]
+
+Or it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_create_2]
+    :end-before: [END howto_operator_vision_product_create_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_create_template_fields]
+    :end-before: [END vision_product_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product>`_.
+
+.. _howto/operator:CloudVisionProductGetOperator:
+
+CloudVisionProductGetOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Gets information associated with a :code:`Product`.
+
+Possible errors:
+
+- Returns NOT_FOUND if the `Product` does not exist.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_get]
+    :end-before: [END howto_operator_vision_product_get]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_get_2]
+    :end-before: [END howto_operator_vision_product_get_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_get_template_fields]
+    :end-before: [END vision_product_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product>`_.
+
+.. _howto/operator:CloudVisionProductUpdateOperator:
+
+CloudVisionProductUpdateOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Makes changes to a :code:`Product` resource. Only the :code:`display_name`,
+:code:`description`, and :code:`labels` fields can be updated right now.
+If labels are updated, the change will not be reflected in queries until the next index
+time.
+
+.. note:: To locate the `Product` resource, its `name` in the form
+  ``projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`` is necessary.
+
+You can provide the `name` directly as an attribute of the `product` object. However, you
+can leave it blank and provide `location` and `product_id` instead (and optionally
+`project_id` - if not present, the connection default will be used) and the `name` will
+be created by the operator itself.
+
+This mechanism exists for your convenience, to allow leaving the `project_id` empty and
+having Airflow use the connection default `project_id`.
+
+Possible errors:
+
+- Returns NOT_FOUND if the `Product` does not exist.
+- Returns INVALID_ARGUMENT if `display_name` is present in `update_mask` but is missing
+  from the request or longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `description` is present in `update_mask` but is longer than
+  4096 characters.
+- Returns INVALID_ARGUMENT if `product_category` is present in `update_mask`.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the ``Product`` object from the Google Cloud Vision library:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_import]
+    :end-before: [END howto_operator_vision_product_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product]
+    :end-before: [END howto_operator_vision_product]
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_update]
+    :end-before: [END howto_operator_vision_product_update]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_update_2]
+    :end-before: [END howto_operator_vision_product_update_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_update_template_fields]
+    :end-before: [END vision_product_update_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product update documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product>`_.
+
+.. _howto/operator:CloudVisionProductDeleteOperator:
+
+CloudVisionProductDeleteOperator
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Permanently deletes a product and its reference images.
+
+Metadata of the product and all its images will be deleted right away, but search queries
+against :code:`ProductSets` containing the product may still work until all related
+caches are refreshed.
+
+Possible errors:
+
+- Returns NOT_FOUND if the product does not exist.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_delete]
+    :end-before: [END howto_operator_vision_product_delete]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_delete_2]
+    :end-before: [END howto_operator_vision_product_delete_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_delete_template_fields]
+    :end-before: [END vision_product_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product delete documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product>`_.
diff --git a/docs/howto/operator/index.rst b/docs/howto/operator/index.rst
new file mode 100644
index 0000000000000..647ffcc354fc6
--- /dev/null
+++ b/docs/howto/operator/index.rst
@@ -0,0 +1,33 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Using Operators
+===============
+
+An operator represents a single, ideally idempotent, task. Operators
+determine what actually executes when your DAG runs.
+
+See the :ref:`Operators Concepts <concepts-operators>` documentation and the
+:ref:`Operators API Reference <api-reference-operators>` for more
+information.
+
+.. toctree::
+    :maxdepth: 2
+
+    python
+    bash
+    gcp/index
diff --git a/docs/howto/operator/python.rst b/docs/howto/operator/python.rst
new file mode 100644
index 0000000000000..f6aa48f0b8970
--- /dev/null
+++ b/docs/howto/operator/python.rst
@@ -0,0 +1,48 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+PythonOperator
+==============
+
+Use the :class:`~airflow.operators.python_operator.PythonOperator` to execute
+Python callables.
+
+.. literalinclude:: ../../../airflow/example_dags/example_python_operator.py
+    :language: python
+    :start-after: [START howto_operator_python]
+    :end-before: [END howto_operator_python]
+
+Passing in arguments
+^^^^^^^^^^^^^^^^^^^^
+
+Use the ``op_args`` and ``op_kwargs`` arguments to pass additional arguments
+to the Python callable.
+
+.. literalinclude:: ../../../airflow/example_dags/example_python_operator.py
+    :language: python
+    :start-after: [START howto_operator_python_kwargs]
+    :end-before: [END howto_operator_python_kwargs]
+
+Templating
+^^^^^^^^^^
+
+When you set the ``provide_context`` argument to ``True``, Airflow passes in
+an additional set of keyword arguments: one for each of the :ref:`Jinja
+template variables <macros>` and a ``templates_dict`` argument.
+
+The ``templates_dict`` argument is templated, so each value in the dictionary
+is evaluated as a :ref:`Jinja template <jinja-templating>`.

From 8178f66ca5221d94f7abfb121e1621642f87c105 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Tue, 6 Nov 2018 12:11:08 +0000
Subject: [PATCH 709/808] [AIRFLOW-XXX] Fix Docstrings in Hooks, Sensors &
 Operators (#4137)

---
 airflow/contrib/hooks/spark_submit_hook.py    | 19 +++++------
 airflow/contrib/hooks/sqoop_hook.py           | 18 +++++++----
 .../contrib/operators/bigquery_operator.py    |  7 ++--
 .../contrib/operators/dataproc_operator.py    |  3 +-
 airflow/contrib/operators/gcs_to_s3.py        |  7 ++--
 airflow/contrib/operators/pubsub_operator.py  |  2 +-
 .../operators/s3_delete_objects_operator.py   |  4 +--
 airflow/contrib/operators/s3_list_operator.py |  8 +++--
 .../contrib/operators/s3_to_gcs_operator.py   |  7 ++--
 .../contrib/operators/spark_jdbc_operator.py  |  2 +-
 airflow/contrib/sensors/bigquery_sensor.py    | 32 +++++++++----------
 airflow/contrib/sensors/sftp_sensor.py        |  1 +
 airflow/operators/http_operator.py            |  8 ++---
 airflow/operators/python_operator.py          |  1 +
 airflow/operators/redshift_to_s3_operator.py  |  6 ++--
 airflow/operators/s3_to_hive_operator.py      |  7 ++--
 airflow/operators/s3_to_redshift_operator.py  |  7 ++--
 airflow/sensors/s3_key_sensor.py              |  5 +--
 airflow/sensors/s3_prefix_sensor.py           |  5 +--
 19 files changed, 82 insertions(+), 67 deletions(-)

diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 55242c8c5ff82..0912fb40a5138 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -33,14 +33,15 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     This hook is a wrapper around the spark-submit binary to kick off a spark-submit job.
     It requires that the "spark-submit" binary is in the PATH or the spark_home to be
     supplied.
+
     :param conf: Arbitrary Spark configuration properties
     :type conf: dict
     :param conn_id: The connection id as configured in Airflow administration. When an
-                    invalid connection_id is supplied, it will default to yarn.
+        invalid connection_id is supplied, it will default to yarn.
     :type conn_id: str
     :param files: Upload additional files to the executor running the job, separated by a
-                  comma. Files will be placed in the working directory of each executor.
-                  For example, serialized objects.
+        comma. Files will be placed in the working directory of each executor.
+        For example, serialized objects.
     :type files: str
     :param py_files: Additional python files used by the job, can be .zip, .egg or .py.
     :type py_files: str
@@ -53,19 +54,19 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :param java_class: the main class of the Java application
     :type java_class: str
     :param packages: Comma-separated list of maven coordinates of jars to include on the
-    driver and executor classpaths
+        driver and executor classpaths
     :type packages: str
     :param exclude_packages: Comma-separated list of maven coordinates of jars to exclude
-    while resolving the dependencies provided in 'packages'
+        while resolving the dependencies provided in 'packages'
     :type exclude_packages: str
     :param repositories: Comma-separated list of additional remote repositories to search
-    for the maven coordinates given with 'packages'
+        for the maven coordinates given with 'packages'
     :type repositories: str
     :param total_executor_cores: (Standalone & Mesos only) Total cores for all executors
-    (Default: all the available cores on the worker)
+        (Default: all the available cores on the worker)
     :type total_executor_cores: int
     :param executor_cores: (Standalone, YARN and Kubernetes only) Number of cores per
-    executor (Default: 2)
+        executor (Default: 2)
     :type executor_cores: int
     :param executor_memory: Memory per executor (e.g. 1000M, 2G) (Default: 1G)
     :type executor_memory: str
@@ -82,7 +83,7 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :param application_args: Arguments for the application being submitted
     :type application_args: list
     :param env_vars: Environment variables for spark-submit. It
-                     supports yarn and k8s mode too.
+        supports yarn and k8s mode too.
     :type env_vars: dict
     :param verbose: Whether to pass the verbose flag to spark-submit process for debugging
     :type verbose: bool
diff --git a/airflow/contrib/hooks/sqoop_hook.py b/airflow/contrib/hooks/sqoop_hook.py
index 101259bcca811..13a6cccca869e 100644
--- a/airflow/contrib/hooks/sqoop_hook.py
+++ b/airflow/contrib/hooks/sqoop_hook.py
@@ -36,13 +36,14 @@ class SqoopHook(BaseHook, LoggingMixin):
 
     Additional arguments that can be passed via the 'extra' JSON field of the
     sqoop connection:
-    * job_tracker: Job tracker local|jobtracker:port.
-    * namenode: Namenode.
-    * lib_jars: Comma separated jar files to include in the classpath.
-    * files: Comma separated files to be copied to the map reduce cluster.
-    * archives: Comma separated archives to be unarchived on the compute
-        machines.
-    * password_file: Path to file containing the password.
+
+        * ``job_tracker``: Job tracker local|jobtracker:port.
+        * ``namenode``: Namenode.
+        * ``lib_jars``: Comma separated jar files to include in the classpath.
+        * ``files``: Comma separated files to be copied to the map reduce cluster.
+        * ``archives``: Comma separated archives to be unarchived on the compute
+            machines.
+        * ``password_file``: Path to file containing the password.
 
     :param conn_id: Reference to the sqoop connection.
     :type conn_id: str
@@ -205,6 +206,7 @@ def import_table(self, table, target_dir=None, append=False, file_type="text",
         """
         Imports table from remote location to target dir. Arguments are
         copies of direct sqoop command line arguments
+
         :param table: Table to read
         :param target_dir: HDFS destination dir
         :param append: Append data to an existing dataset in HDFS
@@ -235,6 +237,7 @@ def import_query(self, query, target_dir, append=False, file_type="text",
                      split_by=None, direct=None, driver=None, extra_import_options=None):
         """
         Imports a specific query from the rdbms to hdfs
+
         :param query: Free format query to run
         :param target_dir: HDFS destination dir
         :param append: Append data to an existing dataset in HDFS
@@ -319,6 +322,7 @@ def export_table(self, table, export_dir, input_null_string,
         """
         Exports Hive table to remote location. Arguments are copies of direct
         sqoop command line Arguments
+
         :param table: Table remote destination
         :param export_dir: Hive table to export
         :param input_null_string: The string to be interpreted as null for
diff --git a/airflow/contrib/operators/bigquery_operator.py b/airflow/contrib/operators/bigquery_operator.py
index 3153102b1d151..746abac5360ce 100644
--- a/airflow/contrib/operators/bigquery_operator.py
+++ b/airflow/contrib/operators/bigquery_operator.py
@@ -435,7 +435,7 @@ class BigQueryCreateExternalTableOperator(BaseOperator):
     :type delegate_to: str
     :param src_fmt_configs: configure optional fields specific to the source format
     :type src_fmt_configs: dict
-    :param labels a dictionary containing labels for the table, passed to BigQuery
+    :param labels: a dictionary containing labels for the table, passed to BigQuery
     :type labels: dict
     """
     template_fields = ('bucket', 'source_objects',
@@ -528,9 +528,10 @@ def execute(self, context):
 
 
 class BigQueryDeleteDatasetOperator(BaseOperator):
-    """"
+    """
     This operator deletes an existing dataset from your Project in Big query.
     https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets/delete
+
     :param project_id: The project id of the dataset.
     :type project_id: str
     :param dataset_id: The dataset to be deleted.
@@ -579,7 +580,7 @@ def execute(self, context):
 
 
 class BigQueryCreateEmptyDatasetOperator(BaseOperator):
-    """"
+    """
     This operator is used to create new dataset for your Project in Big query.
     https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#resource
 
diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index 33a3e9347c7ff..e9684b987e5c4 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -71,7 +71,8 @@ class DataprocClusterCreateOperator(BaseOperator):
     :type image_version: str
     :param custom_image: custom Dataproc image for more info see
         https://cloud.google.com/dataproc/docs/guides/dataproc-images
-    :type: custom_image: string
+    :type: custom_image: str
+    :param properties: dict of properties to set on
         config files (e.g. spark-defaults.conf), see
         https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.clusters#SoftwareConfig
     :type properties: dict
diff --git a/airflow/contrib/operators/gcs_to_s3.py b/airflow/contrib/operators/gcs_to_s3.py
index 3d841bd02ebd5..6029661f370c6 100644
--- a/airflow/contrib/operators/gcs_to_s3.py
+++ b/airflow/contrib/operators/gcs_to_s3.py
@@ -47,13 +47,14 @@ class GoogleCloudStorageToS3Operator(GoogleCloudStorageListOperator):
     :type dest_aws_conn_id: str
     :param dest_s3_key: The base S3 key to be used to store the files. (templated)
     :type dest_s3_key: str
-    :parame dest_verify: Whether or not to verify SSL certificates for S3 connection.
+    :param dest_verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type dest_verify: bool or str
diff --git a/airflow/contrib/operators/pubsub_operator.py b/airflow/contrib/operators/pubsub_operator.py
index e40828bf92151..7c4d2fde5a560 100644
--- a/airflow/contrib/operators/pubsub_operator.py
+++ b/airflow/contrib/operators/pubsub_operator.py
@@ -378,7 +378,7 @@ class PubSubPublishOperator(BaseOperator):
             create_topic=True,
             dag=dag)
 
-     ``project`` , ``topic``, and ``messages`` are templated so you can use
+    ``project`` , ``topic``, and ``messages`` are templated so you can use
     variables in them.
     """
     template_fields = ['project', 'topic', 'messages']
diff --git a/airflow/contrib/operators/s3_delete_objects_operator.py b/airflow/contrib/operators/s3_delete_objects_operator.py
index 0758223217777..926667b497195 100644
--- a/airflow/contrib/operators/s3_delete_objects_operator.py
+++ b/airflow/contrib/operators/s3_delete_objects_operator.py
@@ -49,10 +49,10 @@ class S3DeleteObjectsOperator(BaseOperator):
 
         You can provide the following values:
 
-        - False: do not validate SSL certificates. SSL will still be used,
+        - ``False``: do not validate SSL certificates. SSL will still be used,
                  but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/contrib/operators/s3_list_operator.py b/airflow/contrib/operators/s3_list_operator.py
index 41ef7efd6960c..d5a58d7d10b2f 100644
--- a/airflow/contrib/operators/s3_list_operator.py
+++ b/airflow/contrib/operators/s3_list_operator.py
@@ -38,17 +38,19 @@ class S3ListOperator(BaseOperator):
     :type delimiter: str
     :param aws_conn_id: The connection ID to use when connecting to S3 storage.
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
 
+
     **Example**:
         The following operator would list all the files
         (excluding subfolders) from the S3
diff --git a/airflow/contrib/operators/s3_to_gcs_operator.py b/airflow/contrib/operators/s3_to_gcs_operator.py
index d8085043df444..ad456a5c9bae0 100644
--- a/airflow/contrib/operators/s3_to_gcs_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_operator.py
@@ -41,13 +41,14 @@ class S3ToGoogleCloudStorageOperator(S3ListOperator):
     :type delimiter: str
     :param aws_conn_id: The source S3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/contrib/operators/spark_jdbc_operator.py b/airflow/contrib/operators/spark_jdbc_operator.py
index 42f9dd5676f1b..b1c2a138b9ea2 100644
--- a/airflow/contrib/operators/spark_jdbc_operator.py
+++ b/airflow/contrib/operators/spark_jdbc_operator.py
@@ -64,7 +64,7 @@ class SparkJDBCOperator(SparkSubmitOperator):
     :param jdbc_table: The name of the JDBC table
     :type jdbc_table: str
     :param jdbc_conn_id: Connection id used for connection to JDBC database
-    :type: jdbc_conn_id: str
+    :type jdbc_conn_id: str
     :param jdbc_driver: Name of the JDBC driver to use for the JDBC connection. This
                         driver (usually a jar) should be passed in the 'jars' parameter
     :type jdbc_driver: str
diff --git a/airflow/contrib/sensors/bigquery_sensor.py b/airflow/contrib/sensors/bigquery_sensor.py
index 89ec476d9d565..fe8bd2ed6acc9 100644
--- a/airflow/contrib/sensors/bigquery_sensor.py
+++ b/airflow/contrib/sensors/bigquery_sensor.py
@@ -25,22 +25,22 @@ class BigQueryTableSensor(BaseSensorOperator):
     """
     Checks for the existence of a table in Google Bigquery.
 
-        :param project_id: The Google cloud project in which to look for the table.
-            The connection supplied to the hook must provide
-            access to the specified project.
-        :type project_id: str
-        :param dataset_id: The name of the dataset in which to look for the table.
-            storage bucket.
-        :type dataset_id: str
-        :param table_id: The name of the table to check the existence of.
-        :type table_id: str
-        :param bigquery_conn_id: The connection ID to use when connecting to
-            Google BigQuery.
-        :type bigquery_conn_id: str
-        :param delegate_to: The account to impersonate, if any.
-            For this to work, the service account making the request must
-            have domain-wide delegation enabled.
-        :type delegate_to: str
+    :param project_id: The Google cloud project in which to look for the table.
+        The connection supplied to the hook must provide
+        access to the specified project.
+    :type project_id: str
+    :param dataset_id: The name of the dataset in which to look for the table.
+        storage bucket.
+    :type dataset_id: str
+    :param table_id: The name of the table to check the existence of.
+    :type table_id: str
+    :param bigquery_conn_id: The connection ID to use when connecting to
+        Google BigQuery.
+    :type bigquery_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must
+        have domain-wide delegation enabled.
+    :type delegate_to: str
     """
     template_fields = ('project_id', 'dataset_id', 'table_id',)
     ui_color = '#f0eee4'
diff --git a/airflow/contrib/sensors/sftp_sensor.py b/airflow/contrib/sensors/sftp_sensor.py
index 51ad11ddbf68b..3b06814cbcaa4 100644
--- a/airflow/contrib/sensors/sftp_sensor.py
+++ b/airflow/contrib/sensors/sftp_sensor.py
@@ -27,6 +27,7 @@
 class SFTPSensor(BaseSensorOperator):
     """
     Waits for a file or directory to be present on SFTP.
+
     :param path: Remote file or directory path
     :type path: str
     :param sftp_conn_id: The connection to run the sensor against
diff --git a/airflow/operators/http_operator.py b/airflow/operators/http_operator.py
index f3ae33547d079..d382b012ab090 100644
--- a/airflow/operators/http_operator.py
+++ b/airflow/operators/http_operator.py
@@ -46,7 +46,9 @@ class SimpleHttpOperator(BaseOperator):
         'requests' documentation (options to modify timeout, ssl, etc.)
     :type extra_options: A dictionary of options, where key is string and value
         depends on the option that's being modified.
-    :param xcom_push: Push the response to Xcom (default: False)
+    :param xcom_push: Push the response to Xcom (default: False).
+        If xcom_push is True, response of an HTTP request will also
+        be pushed to an XCom.
     :type xcom_push: bool
     :param log_response: Log the response (default: False)
     :type log_response: bool
@@ -68,10 +70,6 @@ def __init__(self,
                  http_conn_id='http_default',
                  log_response=False,
                  *args, **kwargs):
-        """
-        If xcom_push is True, response of an HTTP request will also
-        be pushed to an XCom.
-        """
         super(SimpleHttpOperator, self).__init__(*args, **kwargs)
         self.http_conn_id = http_conn_id
         self.method = method
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 166201672dac4..6d2dbf9b326bb 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -192,6 +192,7 @@ class PythonVirtualenvOperator(PythonOperator):
     can use a return value.
     Note that if your virtualenv runs in a different Python major version than Airflow,
     you cannot use return values, op_args, or op_kwargs. You can use string_args though.
+
     :param python_callable: A python function with no references to outside variables,
         defined with def, which will be run in a virtualenv
     :type python_callable: function
diff --git a/airflow/operators/redshift_to_s3_operator.py b/airflow/operators/redshift_to_s3_operator.py
index b1fee56e95c60..8498545f2671c 100644
--- a/airflow/operators/redshift_to_s3_operator.py
+++ b/airflow/operators/redshift_to_s3_operator.py
@@ -39,13 +39,13 @@ class RedshiftToS3Transfer(BaseOperator):
     :type redshift_conn_id: str
     :param aws_conn_id: reference to a specific S3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/operators/s3_to_hive_operator.py b/airflow/operators/s3_to_hive_operator.py
index 0e28ffaf5c68e..33aa5b0103627 100644
--- a/airflow/operators/s3_to_hive_operator.py
+++ b/airflow/operators/s3_to_hive_operator.py
@@ -78,13 +78,14 @@ class S3ToHiveTransfer(BaseOperator):
     :type delimiter: str
     :param aws_conn_id: source s3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/operators/s3_to_redshift_operator.py b/airflow/operators/s3_to_redshift_operator.py
index 265d6e25634f2..65bc679f243ab 100644
--- a/airflow/operators/s3_to_redshift_operator.py
+++ b/airflow/operators/s3_to_redshift_operator.py
@@ -39,13 +39,14 @@ class S3ToRedshiftTransfer(BaseOperator):
     :type redshift_conn_id: str
     :param aws_conn_id: reference to a specific S3 connection
     :type aws_conn_id: str
-    :parame verify: Whether or not to verify SSL certificates for S3 connection.
+    :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/sensors/s3_key_sensor.py b/airflow/sensors/s3_key_sensor.py
index d5a148716a845..a72b1c7a87d46 100644
--- a/airflow/sensors/s3_key_sensor.py
+++ b/airflow/sensors/s3_key_sensor.py
@@ -44,10 +44,11 @@ class S3KeySensor(BaseSensorOperator):
     :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str
diff --git a/airflow/sensors/s3_prefix_sensor.py b/airflow/sensors/s3_prefix_sensor.py
index 61f9a477ae2ef..16980e7b4ac31 100644
--- a/airflow/sensors/s3_prefix_sensor.py
+++ b/airflow/sensors/s3_prefix_sensor.py
@@ -43,10 +43,11 @@ class S3PrefixSensor(BaseSensorOperator):
     :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
-        - False: do not validate SSL certificates. SSL will still be used
+
+        - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
-        - path/to/cert/bundle.pem: A filename of the CA cert bundle to uses.
+        - ``path/to/cert/bundle.pem``: A filename of the CA cert bundle to uses.
                  You can specify this argument if you want to use a different
                  CA cert bundle than the one used by botocore.
     :type verify: bool or str

From f80f3bdefd93cb5ae81b8d83951c864f11fd1cdc Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 5 Oct 2018 16:30:09 +0800
Subject: [PATCH 710/808] [AIRFLOW-3148] Remove unnecessary arg "parameters" in
 RedshiftToS3Transfer (#3995)

"Parameters" are used to help render the SQL command.
But in this operator, only "schema" and "table" are needed.
There is no SQL command to render.

By checking the code,we can also find argument
"parameters" is never really used.

(Fix a minor issue in the docstring as well)
---
 airflow/operators/redshift_to_s3_operator.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/airflow/operators/redshift_to_s3_operator.py b/airflow/operators/redshift_to_s3_operator.py
index 8498545f2671c..c0c4db3503467 100644
--- a/airflow/operators/redshift_to_s3_operator.py
+++ b/airflow/operators/redshift_to_s3_operator.py
@@ -42,6 +42,7 @@ class RedshiftToS3Transfer(BaseOperator):
     :param verify: Whether or not to verify SSL certificates for S3 connection.
         By default SSL certificates are verified.
         You can provide the following values:
+
         - ``False``: do not validate SSL certificates. SSL will still be used
                  (unless use_ssl is False), but SSL certificates will not be
                  verified.
@@ -69,7 +70,6 @@ def __init__(
             verify=None,
             unload_options=tuple(),
             autocommit=False,
-            parameters=None,
             include_header=False,
             *args, **kwargs):
         super(RedshiftToS3Transfer, self).__init__(*args, **kwargs)
@@ -82,7 +82,6 @@ def __init__(
         self.verify = verify
         self.unload_options = unload_options
         self.autocommit = autocommit
-        self.parameters = parameters
         self.include_header = include_header
 
         if self.include_header and \

From 0cf47c811c95bc2d328d39885eea898521265128 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Mon, 15 Oct 2018 11:12:12 +0100
Subject: [PATCH 711/808] [AIRFLOW-XXX] Fix GCS Operator docstrings (#4054)

---
 airflow/contrib/operators/gcs_to_gcs.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/airflow/contrib/operators/gcs_to_gcs.py b/airflow/contrib/operators/gcs_to_gcs.py
index 7e7400936ae43..b694b802fc878 100644
--- a/airflow/contrib/operators/gcs_to_gcs.py
+++ b/airflow/contrib/operators/gcs_to_gcs.py
@@ -31,11 +31,10 @@ class GoogleCloudStorageToGoogleCloudStorageOperator(BaseOperator):
     :type source_bucket: str
     :param source_object: The source name of the object to copy in the Google cloud
         storage bucket. (templated)
-        If wildcards are used in this argument:
-            You can use only one wildcard for objects (filenames) within your
-            bucket. The wildcard can appear inside the object name or at the
-            end of the object name. Appending a wildcard to the bucket name is
-            unsupported.
+        You can use only one wildcard for objects (filenames) within your
+        bucket. The wildcard can appear inside the object name or at the
+        end of the object name. Appending a wildcard to the bucket name is
+        unsupported.
     :type source_object: str
     :param destination_bucket: The destination Google cloud storage bucket
         where the object should be. (templated)

From 89b544acbd9c08e24b4c36e6d80a62c652df4a1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Bili=C5=84ski?= <szymon.bilinski@gmail.com>
Date: Sat, 3 Nov 2018 07:04:19 +0100
Subject: [PATCH 712/808] [AIRFLOW-3288] Add SNS integration (#4123)

Provides a hook and an operator for publishing Amazon SNS messages.

Useful for integrating various Amazon services (SQS, Lambda) and
sending regular notifications (e-mail, SMS, ...).
---
 airflow/contrib/hooks/aws_sns_hook.py         | 60 ++++++++++++++++
 .../contrib/operators/sns_publish_operator.py | 65 +++++++++++++++++
 tests/contrib/hooks/test_aws_sns_hook.py      | 53 ++++++++++++++
 .../operators/test_sns_publish_operator.py    | 72 +++++++++++++++++++
 4 files changed, 250 insertions(+)
 create mode 100644 airflow/contrib/hooks/aws_sns_hook.py
 create mode 100644 airflow/contrib/operators/sns_publish_operator.py
 create mode 100644 tests/contrib/hooks/test_aws_sns_hook.py
 create mode 100644 tests/contrib/operators/test_sns_publish_operator.py

diff --git a/airflow/contrib/hooks/aws_sns_hook.py b/airflow/contrib/hooks/aws_sns_hook.py
new file mode 100644
index 0000000000000..4308b493ce3e3
--- /dev/null
+++ b/airflow/contrib/hooks/aws_sns_hook.py
@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+
+from airflow.contrib.hooks.aws_hook import AwsHook
+
+
+class AwsSnsHook(AwsHook):
+    """
+    Interact with Amazon Simple Notification Service.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super(AwsSnsHook, self).__init__(*args, **kwargs)
+
+    def get_conn(self):
+        """
+        Get an SNS connection
+        """
+        self.conn = self.get_client_type('sns')
+        return self.conn
+
+    def publish_to_target(self, target_arn, message):
+        """
+        Publish a message to a topic or an endpoint.
+
+        :param target_arn: either a TopicArn or an EndpointArn
+        :type target_arn: str
+        :param message: the default message you want to send
+        :param message: str
+        """
+
+        conn = self.get_conn()
+
+        messages = {
+            'default': message
+        }
+
+        return conn.publish(
+            TargetArn=target_arn,
+            Message=json.dumps(messages),
+            MessageStructure='json'
+        )
diff --git a/airflow/contrib/operators/sns_publish_operator.py b/airflow/contrib/operators/sns_publish_operator.py
new file mode 100644
index 0000000000000..d1a042be55e03
--- /dev/null
+++ b/airflow/contrib/operators/sns_publish_operator.py
@@ -0,0 +1,65 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.aws_sns_hook import AwsSnsHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class SnsPublishOperator(BaseOperator):
+    """
+    Publish a message to Amazon SNS.
+
+    :param aws_conn_id: aws connection to use
+    :type aws_conn_id: str
+    :param target_arn: either a TopicArn or an EndpointArn
+    :type target_arn: str
+    :param message: the default message you want to send (templated)
+    :type message: str
+    """
+    template_fields = ['message']
+    template_ext = ()
+
+    @apply_defaults
+    def __init__(
+            self,
+            target_arn,
+            message,
+            aws_conn_id='aws_default',
+            *args, **kwargs):
+        super(SnsPublishOperator, self).__init__(*args, **kwargs)
+        self.target_arn = target_arn
+        self.message = message
+        self.aws_conn_id = aws_conn_id
+
+    def execute(self, context):
+        sns = AwsSnsHook(aws_conn_id=self.aws_conn_id)
+
+        self.log.info(
+            'Sending SNS notification to {} using {}:\n{}'.format(
+                self.target_arn,
+                self.aws_conn_id,
+                self.message
+            )
+        )
+
+        return sns.publish_to_target(
+            target_arn=self.target_arn,
+            message=self.message
+        )
diff --git a/tests/contrib/hooks/test_aws_sns_hook.py b/tests/contrib/hooks/test_aws_sns_hook.py
new file mode 100644
index 0000000000000..480e29d08842e
--- /dev/null
+++ b/tests/contrib/hooks/test_aws_sns_hook.py
@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import unittest
+
+from airflow.contrib.hooks.aws_sns_hook import AwsSnsHook
+
+try:
+    from moto import mock_sns
+except ImportError:
+    mock_sns = None
+
+
+@unittest.skipIf(mock_sns is None, 'moto package not present')
+class TestAwsLambdaHook(unittest.TestCase):
+
+    @mock_sns
+    def test_get_conn_returns_a_boto3_connection(self):
+        hook = AwsSnsHook(aws_conn_id='aws_default')
+        self.assertIsNotNone(hook.get_conn())
+
+    @mock_sns
+    def test_publish_to_target(self):
+        hook = AwsSnsHook(aws_conn_id='aws_default')
+
+        message = "Hello world"
+        topic_name = "test-topic"
+        target = hook.get_conn().create_topic(Name=topic_name).get('TopicArn')
+
+        response = hook.publish_to_target(target, message)
+
+        self.assertTrue('MessageId' in response)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_sns_publish_operator.py b/tests/contrib/operators/test_sns_publish_operator.py
new file mode 100644
index 0000000000000..d30bfa57f8dad
--- /dev/null
+++ b/tests/contrib/operators/test_sns_publish_operator.py
@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import mock
+import unittest
+
+from airflow.contrib.operators.sns_publish_operator import SnsPublishOperator
+
+TASK_ID = "sns_publish_job"
+AWS_CONN_ID = "custom_aws_conn"
+TARGET_ARN = "arn:aws:sns:eu-central-1:1234567890:test-topic"
+MESSAGE = "Message to send"
+
+
+class TestSnsPublishOperator(unittest.TestCase):
+
+    def test_init(self):
+        # Given / When
+        operator = SnsPublishOperator(
+            task_id=TASK_ID,
+            aws_conn_id=AWS_CONN_ID,
+            target_arn=TARGET_ARN,
+            message=MESSAGE
+        )
+
+        # Then
+        self.assertEqual(TASK_ID, operator.task_id)
+        self.assertEqual(AWS_CONN_ID, operator.aws_conn_id)
+        self.assertEqual(TARGET_ARN, operator.target_arn)
+        self.assertEqual(MESSAGE, operator.message)
+
+    @mock.patch('airflow.contrib.operators.sns_publish_operator.AwsSnsHook')
+    def test_execute(self, mock_hook):
+        # Given
+        hook_response = {'MessageId': 'foobar'}
+
+        hook_instance = mock_hook.return_value
+        hook_instance.publish_to_target.return_value = hook_response
+
+        operator = SnsPublishOperator(
+            task_id=TASK_ID,
+            aws_conn_id=AWS_CONN_ID,
+            target_arn=TARGET_ARN,
+            message=MESSAGE
+        )
+
+        # When
+        result = operator.execute(None)
+
+        # Then
+        self.assertEqual(hook_response, result)
+
+
+if __name__ == '__main__':
+    unittest.main()

From 8f736b6c87603bc8b7b1acff4f38f35cfada02e5 Mon Sep 17 00:00:00 2001
From: Sumit Maheshwari <sumeet.manit@gmail.com>
Date: Mon, 1 Oct 2018 11:58:27 +0530
Subject: [PATCH 713/808] [AIRFLOW-3062] Add Qubole in integration docs (#3946)

Most of these had already been applied (hence why this commit is so much
smaller than the matching commit on master)
---
 airflow/contrib/sensors/qubole_sensor.py | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/airflow/contrib/sensors/qubole_sensor.py b/airflow/contrib/sensors/qubole_sensor.py
index 3d4831a40e77a..08e4290570fe0 100644
--- a/airflow/contrib/sensors/qubole_sensor.py
+++ b/airflow/contrib/sensors/qubole_sensor.py
@@ -29,14 +29,6 @@
 class QuboleSensor(BaseSensorOperator):
     """
     Base class for all Qubole Sensors
-
-    :param qubole_conn_id: The qubole connection to run the sensor against
-    :type qubole_conn_id: str
-    :param data: a JSON object containing payload, whose presence needs to be checked
-    :type data: a JSON object
-
-    .. note:: Both ``data`` and ``qubole_conn_id`` fields are template-supported. You can
-    also use ``.txt`` files for template driven use cases.
     """
 
     template_fields = ('data', 'qubole_conn_id')

From 8cc2ca6465ccd36db241a78864312006683ead2f Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Tue, 26 Mar 2019 12:22:01 +0000
Subject: [PATCH 714/808] [AIRFLOW-XXX] Reduction of the number of warnings in
 the documentation (#4585)

This is a _re-apply_ of this commit: These hunks got missed or
over-written again and we didn't have checks in place.
---
 airflow/contrib/hooks/azure_container_instance_hook.py | 2 +-
 airflow/contrib/hooks/azure_container_volume_hook.py   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/contrib/hooks/azure_container_instance_hook.py b/airflow/contrib/hooks/azure_container_instance_hook.py
index 27aa649814885..988cbd9e74ba6 100644
--- a/airflow/contrib/hooks/azure_container_instance_hook.py
+++ b/airflow/contrib/hooks/azure_container_instance_hook.py
@@ -96,7 +96,7 @@ def get_state_exitcode_details(self, resource_group, name):
         :param name: the name of the container group
         :type name: str
         :return: A tuple with the state, exitcode, and details.
-        If the exitcode is unknown 0 is returned.
+            If the exitcode is unknown 0 is returned.
         :rtype: tuple(state,exitcode,details)
         """
         current_state = self._get_instance_view(resource_group, name).current_state
diff --git a/airflow/contrib/hooks/azure_container_volume_hook.py b/airflow/contrib/hooks/azure_container_volume_hook.py
index 5bf349106433d..c81c5190776c6 100644
--- a/airflow/contrib/hooks/azure_container_volume_hook.py
+++ b/airflow/contrib/hooks/azure_container_volume_hook.py
@@ -27,7 +27,7 @@ class AzureContainerVolumeHook(BaseHook):
     A hook which wraps an Azure Volume.
 
     :param wasb_conn_id: connection id of a Azure storage account of
-    which file shares should be mounted
+        which file shares should be mounted
     :type wasb_conn_id: str
     """
 

From d8cb43df6dde4d2c668934f070961ce6e0c2cd0e Mon Sep 17 00:00:00 2001
From: Tim Swast <swast@google.com>
Date: Mon, 20 Aug 2018 13:57:50 -0700
Subject: [PATCH 715/808] [AIRFLOW-2915] Add example DAG for
 GoogleCloudStorageToBigQueryOperator (#3763)

* Don't add DAG if GCP operators aren't installed.
* Remove extra blank lines for flake8.
---
 .../example_gcs_to_bq_operator.py             | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 airflow/contrib/example_dags/example_gcs_to_bq_operator.py

diff --git a/airflow/contrib/example_dags/example_gcs_to_bq_operator.py b/airflow/contrib/example_dags/example_gcs_to_bq_operator.py
new file mode 100644
index 0000000000000..ee9fe093913e2
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcs_to_bq_operator.py
@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import airflow
+try:
+    from airflow.contrib.operators import gcs_to_bq
+except ImportError:
+    gcs_to_bq = None
+from airflow import models
+from airflow.operators import bash_operator
+
+
+if gcs_to_bq is not None:
+    args = {
+        'owner': 'airflow',
+        'start_date': airflow.utils.dates.days_ago(2)
+    }
+
+    dag = models.DAG(
+        dag_id='example_gcs_to_bq_operator', default_args=args,
+        schedule_interval=None)
+
+    create_test_dataset = bash_operator.BashOperator(
+        task_id='create_airflow_test_dataset',
+        bash_command='bq mk airflow_test',
+        dag=dag)
+
+    # [START howto_operator_gcs_to_bq]
+    load_csv = gcs_to_bq.GoogleCloudStorageToBigQueryOperator(
+        task_id='gcs_to_bq_example',
+        bucket='cloud-samples-data',
+        source_objects=['bigquery/us-states/us-states.csv'],
+        destination_project_dataset_table='airflow_test.gcs_to_bq_table',
+        schema_fields=[
+            {'name': 'name', 'type': 'STRING', 'mode': 'NULLABLE'},
+            {'name': 'post_abbr', 'type': 'STRING', 'mode': 'NULLABLE'},
+        ],
+        write_disposition='WRITE_TRUNCATE',
+        dag=dag)
+    # [END howto_operator_gcs_to_bq]
+
+    delete_test_dataset = bash_operator.BashOperator(
+        task_id='delete_airflow_test_dataset',
+        bash_command='bq rm -rf airflow_test',
+        dag=dag)
+
+    create_test_dataset >> load_csv >> delete_test_dataset

From 7d20912d68de07a8bdaeeb2ff529b2823b85993a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Thu, 21 Mar 2019 11:49:57 +0100
Subject: [PATCH 716/808] [AIRFLOW-3908] Add more Google Cloud Vision operators
 (#4791)

---
 .../example_dags/example_gcp_vision.py        | 206 +++++-
 airflow/contrib/hooks/gcp_api_base_hook.py    |  26 +-
 airflow/contrib/hooks/gcp_vision_hook.py      | 229 +++++--
 .../contrib/operators/gcp_vision_operator.py  | 354 +++++++++-
 airflow/utils/decorators.py                   |  16 +
 docs/code.rst                                 |   4 +
 docs/howto/operator/gcp/vision.rst            | 643 +++++++++++++-----
 docs/integration.rst                          |  24 +-
 tests/contrib/hooks/test_gcp_api_base_hook.py |  66 +-
 tests/contrib/hooks/test_gcp_vision_hook.py   | 184 +++--
 .../operators/test_gcp_vision_operator.py     | 127 +++-
 .../test_gcp_vision_operator_system.py        |  33 +-
 .../test_gcp_vision_operator_system_helper.py |  90 +++
 .../utils/base_gcp_system_test_case.py        |  22 +-
 tests/utils/test_decorators.py                |  29 +-
 15 files changed, 1695 insertions(+), 358 deletions(-)
 create mode 100755 tests/contrib/operators/test_gcp_vision_operator_system_helper.py

diff --git a/airflow/contrib/example_dags/example_gcp_vision.py b/airflow/contrib/example_dags/example_gcp_vision.py
index 9ca96012ebb2d..2a1facffcef78 100644
--- a/airflow/contrib/example_dags/example_gcp_vision.py
+++ b/airflow/contrib/example_dags/example_gcp_vision.py
@@ -23,22 +23,36 @@
 
 This DAG relies on the following OS environment variables
 
-* GCP_VISION_LOCATION - Google Cloud Platform zone where the instance exists.
+* GCP_VISION_LOCATION - Zone where the instance exists.
+* GCP_VISION_PRODUCT_SET_ID - Product Set ID.
+* GCP_VISION_PRODUCT_ID - Product  ID.
+* GCP_VISION_REFERENCE_IMAGE_ID - Reference Image ID.
+* GCP_VISION_REFERENCE_IMAGE_URL - A link to the bucket that contains the reference image.
+* GCP_VISION_ANNOTATE_IMAGE_URL - A link to the bucket that contains the file to be annotated.
+
 """
 import os
 
 # [START howto_operator_vision_retry_import]
 from google.api_core.retry import Retry
+
 # [END howto_operator_vision_retry_import]
-# [START howto_operator_vision_productset_import]
-from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet
-# [END howto_operator_vision_productset_import]
+# [START howto_operator_vision_product_set_import]
+from google.cloud.vision_v1.types import ProductSet
+# [END howto_operator_vision_product_set_import]
 # [START howto_operator_vision_product_import]
-from google.cloud.vision_v1.proto.product_search_service_pb2 import Product
+from google.cloud.vision_v1.types import Product
 # [END howto_operator_vision_product_import]
+# [START howto_operator_vision_reference_image_import]
+from google.cloud.vision_v1.types import ReferenceImage
+# [END howto_operator_vision_reference_image_import]
+# [START howto_operator_vision_enums_import]
+from google.cloud.vision import enums
+# [END howto_operator_vision_enums_import]
 
 import airflow
 from airflow import models
+from airflow.operators.bash_operator import BashOperator
 
 from airflow.contrib.operators.gcp_vision_operator import (
     CloudVisionProductSetCreateOperator,
@@ -49,6 +63,10 @@
     CloudVisionProductGetOperator,
     CloudVisionProductUpdateOperator,
     CloudVisionProductDeleteOperator,
+    CloudVisionReferenceImageCreateOperator,
+    CloudVisionAddProductToProductSetOperator,
+    CloudVisionRemoveProductFromProductSetOperator,
+    CloudVisionAnnotateImageOperator,
 )
 
 default_args = {'start_date': airflow.utils.dates.days_ago(1)}
@@ -57,25 +75,45 @@
 GCP_VISION_LOCATION = os.environ.get('GCP_VISION_LOCATION', 'europe-west1')
 # [END howto_operator_vision_args_common]
 
-# [START howto_operator_vision_productset]
-product_set = ProductSet(display_name='My Product Set 1')
-# [END howto_operator_vision_productset]
+# [START howto_operator_vision_product_set_explicit_id]
+GCP_VISION_PRODUCT_SET_ID = os.environ.get('GCP_VISION_PRODUCT_SET_ID', 'product_set_explicit_id')
+# [END howto_operator_vision_product_set_explicit_id]
+
+# [START howto_operator_vision_product_explicit_id]
+GCP_VISION_PRODUCT_ID = os.environ.get('GCP_VISION_PRODUCT_ID', 'product_explicit_id')
+# [END howto_operator_vision_product_explicit_id]
+
+# [START howto_operator_vision_reference_image_args]
+GCP_VISION_REFERENCE_IMAGE_ID = os.environ.get('GCP_VISION_REFERENCE_IMAGE_ID', 'reference_image_explicit_id')
+GCP_VISION_REFERENCE_IMAGE_URL = os.environ.get('GCP_VISION_REFERENCE_IMAGE_URL', 'gs://bucket/image1.jpg')
+# [END howto_operator_vision_reference_image_args]
+
+# [START howto_operator_vision_annotate_image_url]
+GCP_VISION_ANNOTATE_IMAGE_URL = os.environ.get('GCP_VISION_ANNOTATE_IMAGE_URL', 'gs://bucket/image2.jpg')
+# [END howto_operator_vision_annotate_image_url]
+
+# [START howto_operator_vision_product_set]
+product_set = ProductSet(display_name='My Product Set')
+# [END howto_operator_vision_product_set]
 
 # [START howto_operator_vision_product]
 product = Product(display_name='My Product 1', product_category='toys')
 # [END howto_operator_vision_product]
 
-# [START howto_operator_vision_productset_explicit_id]
-GCP_VISION_PRODUCT_SET_ID = os.environ.get('GCP_VISION_PRODUCT_SET_ID', 'product_set_explicit_id')
-# [END howto_operator_vision_productset_explicit_id]
+# [START howto_operator_vision_reference_image]
+reference_image = ReferenceImage(uri=GCP_VISION_REFERENCE_IMAGE_URL)
+# [END howto_operator_vision_reference_image]
 
-# [START howto_operator_vision_product_explicit_id]
-GCP_VISION_PRODUCT_ID = os.environ.get('GCP_VISION_PRODUCT_ID', 'product_explicit_id')
-# [END howto_operator_vision_product_explicit_id]
+# [START howto_operator_vision_annotate_image_request]
+annotate_image_request = {
+    'image': {'source': {'image_uri': GCP_VISION_ANNOTATE_IMAGE_URL}},
+    'features': [{'type': enums.Feature.Type.LOGO_DETECTION}],
+}
+# [END howto_operator_vision_annotate_image_request]
 
 with models.DAG(
-    'example_gcp_vision', default_args=default_args, schedule_interval=None  # Override to match your needs
-) as dag:
+    'example_gcp_vision_autogenerated_id', default_args=default_args, schedule_interval=None
+) as dag_autogenerated_id:
     # ################################## #
     # ### Autogenerated IDs examples ### #
     # ################################## #
@@ -150,9 +188,59 @@
     )
     # [END howto_operator_vision_product_delete]
 
-    product_set_create >> product_set_get >> product_set_update >> product_set_delete
+    # [START howto_operator_vision_reference_image_create]
+    reference_image_create = CloudVisionReferenceImageCreateOperator(
+        location=GCP_VISION_LOCATION,
+        reference_image=reference_image,
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        reference_image_id=GCP_VISION_REFERENCE_IMAGE_ID,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='reference_image_create',
+    )
+    # [END howto_operator_vision_reference_image_create]
+
+    # [START howto_operator_vision_add_product_to_product_set]
+    add_product_to_product_set = CloudVisionAddProductToProductSetOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id="{{ task_instance.xcom_pull('product_set_create') }}",
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='add_product_to_product_set',
+    )
+    # [END howto_operator_vision_add_product_to_product_set]
+
+    # [START howto_operator_vision_remove_product_from_product_set]
+    remove_product_from_product_set = CloudVisionRemoveProductFromProductSetOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id="{{ task_instance.xcom_pull('product_set_create') }}",
+        product_id="{{ task_instance.xcom_pull('product_create') }}",
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='remove_product_from_product_set',
+    )
+    # [END howto_operator_vision_remove_product_from_product_set]
+
+    # Product path
     product_create >> product_get >> product_update >> product_delete
 
+    # ProductSet path
+    product_set_create >> product_set_get >> product_set_update >> product_set_delete
+
+    # ReferenceImage path
+    product_create >> reference_image_create >> product_delete
+
+    # Product/ProductSet path
+    product_create >> add_product_to_product_set
+    product_set_create >> add_product_to_product_set
+    add_product_to_product_set >> remove_product_from_product_set
+    remove_product_from_product_set >> product_delete
+    remove_product_from_product_set >> product_set_delete
+
+with models.DAG(
+    'example_gcp_vision_explicit_id', default_args=default_args, schedule_interval=None
+) as dag_explicit_id:
     # ############################# #
     # ### Explicit IDs examples ### #
     # ############################# #
@@ -241,5 +329,87 @@
     )
     # [END howto_operator_vision_product_delete_2]
 
+    # [START howto_operator_vision_reference_image_create_2]
+    reference_image_create_2 = CloudVisionReferenceImageCreateOperator(
+        location=GCP_VISION_LOCATION,
+        reference_image=reference_image,
+        product_id=GCP_VISION_PRODUCT_ID,
+        reference_image_id=GCP_VISION_REFERENCE_IMAGE_ID,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='reference_image_create_2',
+    )
+    # [END howto_operator_vision_reference_image_create_2]
+
+    # Second 'create' task with the same product_id to demonstrate idempotence
+    reference_image_create_2_idempotence = CloudVisionReferenceImageCreateOperator(
+        location=GCP_VISION_LOCATION,
+        reference_image=reference_image,
+        product_id=GCP_VISION_PRODUCT_ID,
+        reference_image_id=GCP_VISION_REFERENCE_IMAGE_ID,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='reference_image_create_2_idempotence',
+    )
+
+    # [START howto_operator_vision_add_product_to_product_set_2]
+    add_product_to_product_set_2 = CloudVisionAddProductToProductSetOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id=GCP_VISION_PRODUCT_SET_ID,
+        product_id=GCP_VISION_PRODUCT_ID,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='add_product_to_product_set_2',
+    )
+    # [END howto_operator_vision_add_product_to_product_set_2]
+
+    # [START howto_operator_vision_remove_product_from_product_set_2]
+    remove_product_from_product_set_2 = CloudVisionRemoveProductFromProductSetOperator(
+        location=GCP_VISION_LOCATION,
+        product_set_id=GCP_VISION_PRODUCT_SET_ID,
+        product_id=GCP_VISION_PRODUCT_ID,
+        retry=Retry(maximum=10.0),
+        timeout=5,
+        task_id='remove_product_from_product_set_2',
+    )
+    # [END howto_operator_vision_remove_product_from_product_set_2]
+
+    # Product path
+    product_create_2 >> product_create_2_idempotence >> product_get_2 >> product_update_2 >> product_delete_2
+
+    # ProductSet path
     product_set_create_2 >> product_set_get_2 >> product_set_update_2 >> product_set_delete_2
-    product_create_2 >> product_get_2 >> product_update_2 >> product_delete_2
+    product_set_create_2 >> product_set_create_2_idempotence >> product_set_delete_2
+
+    # ReferenceImage path
+    product_create_2 >> reference_image_create_2 >> reference_image_create_2_idempotence >> product_delete_2
+
+    # Product/ProductSet path
+    add_product_to_product_set_2 >> remove_product_from_product_set_2
+    product_set_create_2 >> add_product_to_product_set_2
+    product_create_2 >> add_product_to_product_set_2
+    remove_product_from_product_set_2 >> product_set_delete_2
+    remove_product_from_product_set_2 >> product_delete_2
+
+with models.DAG(
+    'example_gcp_vision_annotate_image', default_args=default_args, schedule_interval=None
+) as dag_annotate_image:
+    # ############################## #
+    # ### Annotate image example ### #
+    # ############################## #
+
+    # [START howto_operator_vision_annotate_image]
+    annotate_image = CloudVisionAnnotateImageOperator(
+        request=annotate_image_request, retry=Retry(maximum=10.0), timeout=5, task_id='annotate_image'
+    )
+    # [END howto_operator_vision_annotate_image]
+
+    # [START howto_operator_vision_annotate_image_result]
+    annotate_image_result = BashOperator(
+        bash_command="echo {{ task_instance.xcom_pull('annotate_image')"
+        "['logoAnnotations'][0]['description'] }}",
+        task_id='annotate_image_result',
+    )
+    # [END howto_operator_vision_annotate_image_result]
+
+    annotate_image >> annotate_image_result
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 596209fb542ef..00a5a9685afed 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -27,6 +27,8 @@
 import os
 import tempfile
 
+from google.api_core.exceptions import GoogleAPICallError, AlreadyExists, RetryError
+
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -160,6 +162,28 @@ def _get_field(self, f, default=None):
     def project_id(self):
         return self._get_field('project')
 
+    @staticmethod
+    def catch_http_exception(func):
+        @functools.wraps(func)
+        def wrapper_decorator(self, *args, **kwargs):
+            try:
+                return func(self, *args, **kwargs)
+            except GoogleAPICallError as e:
+                if isinstance(e, AlreadyExists):
+                    raise e
+                else:
+                    self.log.error('The request failed:\n%s', str(e))
+                    raise AirflowException(e)
+            except RetryError as e:
+                self.log.error('The request failed due to a retryable error and retry attempts failed.')
+                raise AirflowException(e)
+            except ValueError as e:
+                self.log.error('The request failed, the parameters are invalid.')
+                raise AirflowException(e)
+
+        return wrapper_decorator
+
+    @staticmethod
     def fallback_to_default_project_id(func):
         """
         Decorator that provides fallback for Google Cloud Platform project id. If
@@ -187,8 +211,6 @@ def inner_wrapper(self, *args, **kwargs):
             return func(self, *args, **kwargs)
         return inner_wrapper
 
-    fallback_to_default_project_id = staticmethod(fallback_to_default_project_id)
-
     def _get_project_id(self, project_id):
         """
         In case project_id is None, overrides it with default project_id from
diff --git a/airflow/contrib/hooks/gcp_vision_hook.py b/airflow/contrib/hooks/gcp_vision_hook.py
index 099c21972526d..6490f12fe2132 100644
--- a/airflow/contrib/hooks/gcp_vision_hook.py
+++ b/airflow/contrib/hooks/gcp_vision_hook.py
@@ -18,12 +18,12 @@
 # under the License.
 from copy import deepcopy
 
-from google.api_core.exceptions import AlreadyExists, GoogleAPICallError, RetryError
-from google.cloud.vision_v1 import ProductSearchClient
+from google.cloud.vision_v1 import ProductSearchClient, ImageAnnotatorClient
 from google.protobuf.json_format import MessageToDict
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+from airflow.utils.decorators import cached_property
 
 
 class NameDeterminer:
@@ -109,6 +109,11 @@ def get_conn(self):
             self._client = ProductSearchClient(credentials=self._get_credentials())
         return self._client
 
+    @cached_property
+    def annotator_client(self):
+        return ImageAnnotatorClient(credentials=self._get_credentials())
+
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def create_product_set(
         self,
@@ -127,8 +132,7 @@ def create_product_set(
         client = self.get_conn()
         parent = ProductSearchClient.location_path(project_id, location)
         self.log.info('Creating a new ProductSet under the parent: %s', parent)
-        response = self._handle_request(
-            lambda **kwargs: client.create_product_set(**kwargs),
+        response = client.create_product_set(
             parent=parent,
             product_set=product_set,
             product_set_id=product_set_id,
@@ -146,6 +150,7 @@ def create_product_set(
 
         return product_set_id
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def get_product_set(
         self, location, product_set_id, project_id=None, retry=None, timeout=None, metadata=None
@@ -157,17 +162,12 @@ def get_product_set(
         client = self.get_conn()
         name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
         self.log.info('Retrieving ProductSet: %s', name)
-        response = self._handle_request(
-            lambda **kwargs: client.get_product_set(**kwargs),
-            name=name,
-            retry=retry,
-            timeout=timeout,
-            metadata=metadata,
-        )
+        response = client.get_product_set(name=name, retry=retry, timeout=timeout, metadata=metadata)
         self.log.info('ProductSet retrieved.')
         self.log.debug('ProductSet retrieved:\n%s', response)
         return MessageToDict(response)
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def update_product_set(
         self,
@@ -189,18 +189,14 @@ def update_product_set(
             product_set, product_set_id, location, project_id
         )
         self.log.info('Updating ProductSet: %s', product_set.name)
-        response = self._handle_request(
-            lambda **kwargs: client.update_product_set(**kwargs),
-            product_set=product_set,
-            update_mask=update_mask,
-            retry=retry,
-            timeout=timeout,
-            metadata=metadata,
+        response = client.update_product_set(
+            product_set=product_set, update_mask=update_mask, retry=retry, timeout=timeout, metadata=metadata
         )
         self.log.info('ProductSet updated: %s', response.name if response else '')
         self.log.debug('ProductSet updated:\n%s', response)
         return MessageToDict(response)
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def delete_product_set(
         self, location, product_set_id, project_id=None, retry=None, timeout=None, metadata=None
@@ -212,16 +208,10 @@ def delete_product_set(
         client = self.get_conn()
         name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
         self.log.info('Deleting ProductSet: %s', name)
-        response = self._handle_request(
-            lambda **kwargs: client.delete_product_set(**kwargs),
-            name=name,
-            retry=retry,
-            timeout=timeout,
-            metadata=metadata,
-        )
+        client.delete_product_set(name=name, retry=retry, timeout=timeout, metadata=metadata)
         self.log.info('ProductSet with the name [%s] deleted.', name)
-        return response
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def create_product(
         self, location, product, project_id=None, product_id=None, retry=None, timeout=None, metadata=None
@@ -233,8 +223,7 @@ def create_product(
         client = self.get_conn()
         parent = ProductSearchClient.location_path(project_id, location)
         self.log.info('Creating a new Product under the parent: %s', parent)
-        response = self._handle_request(
-            lambda **kwargs: client.create_product(**kwargs),
+        response = client.create_product(
             parent=parent,
             product=product,
             product_id=product_id,
@@ -252,6 +241,7 @@ def create_product(
 
         return product_id
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def get_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
         """
@@ -261,17 +251,12 @@ def get_product(self, location, product_id, project_id=None, retry=None, timeout
         client = self.get_conn()
         name = ProductSearchClient.product_path(project_id, location, product_id)
         self.log.info('Retrieving Product: %s', name)
-        response = self._handle_request(
-            lambda **kwargs: client.get_product(**kwargs),
-            name=name,
-            retry=retry,
-            timeout=timeout,
-            metadata=metadata,
-        )
+        response = client.get_product(name=name, retry=retry, timeout=timeout, metadata=metadata)
         self.log.info('Product retrieved.')
         self.log.debug('Product retrieved:\n%s', response)
         return MessageToDict(response)
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def update_product(
         self,
@@ -291,18 +276,14 @@ def update_product(
         client = self.get_conn()
         product = self.product_name_determiner.get_entity_with_name(product, product_id, location, project_id)
         self.log.info('Updating ProductSet: %s', product.name)
-        response = self._handle_request(
-            lambda **kwargs: client.update_product(**kwargs),
-            product=product,
-            update_mask=update_mask,
-            retry=retry,
-            timeout=timeout,
-            metadata=metadata,
+        response = client.update_product(
+            product=product, update_mask=update_mask, retry=retry, timeout=timeout, metadata=metadata
         )
         self.log.info('Product updated: %s', response.name if response else '')
         self.log.debug('Product updated:\n%s', response)
         return MessageToDict(response)
 
+    @GoogleCloudBaseHook.catch_http_exception
     @GoogleCloudBaseHook.fallback_to_default_project_id
     def delete_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
         """
@@ -312,38 +293,150 @@ def delete_product(self, location, product_id, project_id=None, retry=None, time
         client = self.get_conn()
         name = ProductSearchClient.product_path(project_id, location, product_id)
         self.log.info('Deleting ProductSet: %s', name)
-        response = self._handle_request(
-            lambda **kwargs: client.delete_product(**kwargs),
-            name=name,
+        client.delete_product(name=name, retry=retry, timeout=timeout, metadata=metadata)
+        self.log.info('Product with the name [%s] deleted:', name)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def create_reference_image(
+        self,
+        location,
+        product_id,
+        reference_image,
+        reference_image_id=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator`
+        """
+        client = self.get_conn()
+        self.log.info('Creating ReferenceImage')
+        parent = ProductSearchClient.product_path(project=project_id, location=location, product=product_id)
+
+        response = client.create_reference_image(
+            parent=parent,
+            reference_image=reference_image,
+            reference_image_id=reference_image_id,
             retry=retry,
             timeout=timeout,
             metadata=metadata,
         )
-        self.log.info('Product with the name [%s] deleted:', name)
-        return response
 
-    def _handle_request(self, fun, **kwargs):
-        try:
-            return fun(**kwargs)
-        except GoogleAPICallError as e:
-            if isinstance(e, AlreadyExists):
-                raise e
-            else:
-                self.log.error('The request failed:\n%s', str(e))
-                raise AirflowException(e)
-        except RetryError as e:
-            self.log.error('The request failed due to a retryable error and retry attempts failed.')
-            raise AirflowException(e)
-        except ValueError as e:
-            self.log.error('The request failed, the parameters are invalid.')
-            raise AirflowException(e)
+        self.log.info('ReferenceImage created: %s', response.name if response else '')
+        self.log.debug('ReferenceImage created:\n%s', response)
 
-    @staticmethod
-    def _get_entity_name(is_product, project_id, location, entity_id):
-        if is_product:
-            return ProductSearchClient.product_path(project_id, location, entity_id)
-        else:
-            return ProductSearchClient.product_set_path(project_id, location, entity_id)
+        if not reference_image_id:
+            # Refernece image  id was generated by the API
+            reference_image_id = self._get_autogenerated_id(response)
+            self.log.info(
+                'Extracted autogenerated ReferenceImage ID from the response: %s', reference_image_id
+            )
+
+        return reference_image_id
+
+    @GoogleCloudBaseHook.catch_http_exception
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def delete_reference_image(
+        self,
+        location,
+        product_id,
+        reference_image_id,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator`
+        """
+        client = self.get_conn()
+        self.log.info('Deleting ReferenceImage')
+        name = ProductSearchClient.reference_image_path(
+            project=project_id, location=location, product=product_id, reference_image=reference_image_id
+        )
+        response = client.delete_reference_image(name=name, retry=retry, timeout=timeout, metadata=metadata)
+        self.log.info('ReferenceImage with the name [%s] deleted.', name)
+
+        return MessageToDict(response)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def add_product_to_product_set(
+        self,
+        product_set_id,
+        product_id,
+        location=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator`
+        """
+        client = self.get_conn()
+
+        product_name = ProductSearchClient.product_path(project_id, location, product_id)
+        product_set_name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
+
+        self.log.info('Add Product[name=%s] to Product Set[name=%s]', product_name, product_set_name)
+
+        client.add_product_to_product_set(
+            name=product_set_name, product=product_name, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+        self.log.info('Product added to Product Set')
+
+    @GoogleCloudBaseHook.catch_http_exception
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    def remove_product_from_product_set(
+        self,
+        product_set_id,
+        product_id,
+        location=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+    ):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator`
+        """
+        client = self.get_conn()
+
+        product_name = ProductSearchClient.product_path(project_id, location, product_id)
+        product_set_name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
+
+        self.log.info('Remove Product[name=%s] from Product Set[name=%s]', product_name, product_set_name)
+
+        client.remove_product_from_product_set(
+            name=product_set_name, product=product_name, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+        self.log.info('Product removed from Product Set')
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def annotate_image(self, request, retry=None, timeout=None):
+        """
+        For the documentation see:
+        :py:class:`~airflow.contrib.operators.gcp_vision_image_annotator_operator.CloudVisionAnnotateImage`
+        """
+        client = self.annotator_client
+
+        self.log.info('Annotating image')
+
+        response = client.annotate_image(request=request, retry=retry, timeout=timeout)
+
+        self.log.info('Image annotated')
+
+        return MessageToDict(response)
 
     @staticmethod
     def _get_autogenerated_id(response):
diff --git a/airflow/contrib/operators/gcp_vision_operator.py b/airflow/contrib/operators/gcp_vision_operator.py
index 96ed11dc2bbdd..ba1c1b5058aab 100644
--- a/airflow/contrib/operators/gcp_vision_operator.py
+++ b/airflow/contrib/operators/gcp_vision_operator.py
@@ -53,13 +53,13 @@ class CloudVisionProductSetCreateOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
 
     # [START vision_productset_create_template_fields]
-    template_fields = ('location', 'project_id', 'product_set_id', 'gcp_conn_id')
+    template_fields = ("location", "project_id", "product_set_id", "gcp_conn_id")
     # [END vision_productset_create_template_fields]
 
     @apply_defaults
@@ -72,7 +72,7 @@ def __init__(
         retry=None,
         timeout=None,
         metadata=None,
-        gcp_conn_id='google_cloud_default',
+        gcp_conn_id="google_cloud_default",
         *args,
         **kwargs
     ):
@@ -100,7 +100,7 @@ def execute(self, context):
             )
         except AlreadyExists:
             self.log.info(
-                'Product set with id %s already exists. Exiting from the create operation.',
+                "Product set with id %s already exists. Exiting from the create operation.",
                 self.product_set_id,
             )
             return self.product_set_id
@@ -130,8 +130,8 @@ class CloudVisionProductSetGetOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
 
@@ -216,8 +216,8 @@ class CloudVisionProductSetUpdateOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
 
     """
@@ -292,8 +292,8 @@ class CloudVisionProductSetDeleteOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
 
     """
@@ -326,7 +326,7 @@ def __init__(
         self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
 
     def execute(self, context):
-        return self._hook.delete_product_set(
+        self._hook.delete_product_set(
             location=self.location,
             product_set_id=self.product_set_id,
             project_id=self.project_id,
@@ -342,9 +342,9 @@ class CloudVisionProductCreateOperator(BaseOperator):
 
     Possible errors regarding the `Product` object provided:
 
-    - Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
-    - Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
-    - Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+    - Returns `INVALID_ARGUMENT` if `display_name` is missing or longer than 4096 characters.
+    - Returns `INVALID_ARGUMENT` if `description` is longer than 4096 characters.
+    - Returns `INVALID_ARGUMENT` if `product_category` is missing or invalid.
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
@@ -372,8 +372,8 @@ class CloudVisionProductCreateOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
 
     """
@@ -431,7 +431,7 @@ class CloudVisionProductGetOperator(BaseOperator):
 
     Possible errors:
 
-    - Returns NOT_FOUND if the `Product` does not exist.
+    - Returns `NOT_FOUND` if the `Product` does not exist.
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
@@ -453,8 +453,8 @@ class CloudVisionProductGetOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
 
     """
@@ -472,7 +472,7 @@ def __init__(
         retry=None,
         timeout=None,
         metadata=None,
-        gcp_conn_id='google_cloud_default',
+        gcp_conn_id="google_cloud_default",
         *args,
         **kwargs
     ):
@@ -516,11 +516,12 @@ class CloudVisionProductUpdateOperator(BaseOperator):
 
     Possible errors related to the provided `Product`:
 
-    - Returns NOT_FOUND if the Product does not exist.
-    - Returns INVALID_ARGUMENT if display_name is present in update_mask but is missing from the request or
-        longer than 4096 characters.
-    - Returns INVALID_ARGUMENT if description is present in update_mask but is longer than 4096 characters.
-    - Returns INVALID_ARGUMENT if product_category is present in update_mask.
+    - Returns `NOT_FOUND` if the Product does not exist.
+    - Returns `INVALID_ARGUMENT` if `display_name` is present in update_mask but is missing from the request
+        or longer than 4096 characters.
+    - Returns `INVALID_ARGUMENT` if `description` is present in update_mask but is longer than 4096
+        characters.
+    - Returns `INVALID_ARGUMENT` if `product_category` is present in update_mask.
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
@@ -550,8 +551,8 @@ class CloudVisionProductUpdateOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
 
@@ -608,7 +609,7 @@ class CloudVisionProductDeleteOperator(BaseOperator):
 
     Possible errors:
 
-    - Returns NOT_FOUND if the product does not exist.
+    - Returns `NOT_FOUND` if the product does not exist.
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
@@ -630,8 +631,8 @@ class CloudVisionProductDeleteOperator(BaseOperator):
         attempt.
     :type timeout: float
     :param metadata: (Optional) Additional metadata that is provided to the method.
-    :type metadata: Sequence[Tuple[str, str]]
-    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
     :type gcp_conn_id: str
     """
 
@@ -663,7 +664,7 @@ def __init__(
         self._hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
 
     def execute(self, context):
-        return self._hook.delete_product(
+        self._hook.delete_product(
             location=self.location,
             product_id=self.product_id,
             project_id=self.project_id,
@@ -671,3 +672,292 @@ def execute(self, context):
             timeout=self.timeout,
             metadata=self.metadata,
         )
+
+
+class CloudVisionAnnotateImageOperator(BaseOperator):
+    """
+    Run image detection and annotation for an image.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionAnnotateImageOperator`
+
+    :param request: (Required) Individual file annotation requests.
+        If a dict is provided, it must be of the same form as the protobuf
+        message class:`google.cloud.vision_v1.types.AnnotateImageRequest`
+    :type request: dict or google.cloud.vision_v1.types.AnnotateImageRequest
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_annotate_image_template_fields]
+    template_fields = ('request', 'gcp_conn_id')
+    # [END vision_annotate_image_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self, request, retry=None, timeout=None, gcp_conn_id='google_cloud_default', *args, **kwargs
+    ):
+        super(CloudVisionAnnotateImageOperator, self).__init__(*args, **kwargs)
+        self.request = request
+        self.retry = retry
+        self.timeout = timeout
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+        return hook.annotate_image(request=self.request, retry=self.retry, timeout=self.timeout)
+
+
+class CloudVisionReferenceImageCreateOperator(BaseOperator):
+    """
+    Creates and returns a new ReferenceImage ID resource.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionReferenceImageCreateOperator`
+
+    :param location: (Required) The region where the Product is located. Valid regions (as of 2019-02-05) are:
+        us-east1, us-west1, europe-west1, asia-east1
+    :type location: str
+    :param reference_image: (Required) The reference image to create. If an image ID is specified, it is
+        ignored.
+        If a dict is provided, it must be of the same form as the protobuf message
+        :class:`google.cloud.vision_v1.types.ReferenceImage`
+    :type reference_image: dict or google.cloud.vision_v1.types.ReferenceImage
+    :param reference_image_id: (Optional) A user-supplied resource id for the ReferenceImage to be added.
+        If set, the server will attempt to use this value as the resource id. If it is already in use, an
+        error is returned with code ALREADY_EXISTS. Must be at most 128 characters long. It cannot contain
+        the character `/`.
+    :type reference_image_id: str
+    :param product_id: (Optional) The resource id of this Product.
+    :type product_id: str
+    :param project_id: (Optional) The project in which the Product is located. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_reference_image_create_template_fields]
+    template_fields = (
+        "location",
+        "reference_image",
+        "product_id",
+        "reference_image_id",
+        "project_id",
+        "gcp_conn_id",
+    )
+    # [END vision_reference_image_create_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        location,
+        reference_image,
+        product_id,
+        reference_image_id=None,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionReferenceImageCreateOperator, self).__init__(*args, **kwargs)
+        self.location = location
+        self.product_id = product_id
+        self.reference_image = reference_image
+        self.reference_image_id = reference_image_id
+        self.project_id = project_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        try:
+            hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+            return hook.create_reference_image(
+                location=self.location,
+                product_id=self.product_id,
+                reference_image=self.reference_image,
+                reference_image_id=self.reference_image_id,
+                project_id=self.project_id,
+                retry=self.retry,
+                timeout=self.timeout,
+                metadata=self.metadata,
+            )
+        except AlreadyExists:
+            self.log.info(
+                "ReferenceImage with id %s already exists. Exiting from the create operation.",
+                self.product_id,
+            )
+            return self.reference_image_id
+
+
+class CloudVisionAddProductToProductSetOperator(BaseOperator):
+    """
+    Adds a Product to the specified ProductSet. If the Product is already present, no change is made.
+
+    One Product can be added to at most 100 ProductSets.
+
+    Possible errors:
+
+    - Returns `NOT_FOUND` if the Product or the ProductSet doesn’t exist.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionAddProductToProductSetOperator`
+
+    :param product_set_id: (Required) The resource id for the ProductSet to modify.
+    :type product_set_id: str
+    :param product_id: (Required) The resource id of this Product.
+    :type product_id: str
+    :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
+        are: us-east1, us-west1, europe-west1, asia-east1
+    :type: str
+    :param project_id: (Optional) The project in which the Product is located. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_add_product_to_product_set_template_fields]
+    template_fields = ("location", "product_set_id", "product_id", "project_id", "gcp_conn_id")
+    # [END vision_add_product_to_product_set_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        product_set_id,
+        product_id,
+        location,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionAddProductToProductSetOperator, self).__init__(*args, **kwargs)
+        self.product_set_id = product_set_id
+        self.product_id = product_id
+        self.location = location
+        self.project_id = project_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+        return hook.add_product_to_product_set(
+            product_set_id=self.product_set_id,
+            product_id=self.product_id,
+            location=self.location,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+
+
+class CloudVisionRemoveProductFromProductSetOperator(BaseOperator):
+    """
+    Removes a Product from the specified ProductSet.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudVisionRemoveProductFromProductSetOperator`
+
+    :param product_set_id: (Required) The resource id for the ProductSet to modify.
+    :type product_set_id: str
+    :param product_id: (Required) The resource id of this Product.
+    :type product_id: str
+    :param location: (Required) The region where the ProductSet is located. Valid regions (as of 2019-02-05)
+        are: us-east1, us-west1, europe-west1, asia-east1
+    :type: str
+    :param project_id: (Optional) The project in which the Product is located. If set to None or
+        missing, the default project_id from the GCP connection is used.
+    :type project_id: str
+    :param retry: (Optional) A retry object used to retry requests. If `None` is
+        specified, requests will not be retried.
+    :type retry: google.api_core.retry.Retry
+    :param timeout: (Optional) The amount of time, in seconds, to wait for the request to
+        complete. Note that if retry is specified, the timeout applies to each individual
+        attempt.
+    :type timeout: float
+    :param metadata: (Optional) Additional metadata that is provided to the method.
+    :type metadata: sequence[tuple[str, str]]
+    :param gcp_conn_id: (Optional) The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START vision_remove_product_from_product_set_template_fields]
+    template_fields = ("location", "product_set_id", "product_id", "project_id", "gcp_conn_id")
+    # [END vision_remove_product_from_product_set_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        product_set_id,
+        product_id,
+        location,
+        project_id=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudVisionRemoveProductFromProductSetOperator, self).__init__(*args, **kwargs)
+        self.product_set_id = product_set_id
+        self.product_id = product_id
+        self.location = location
+        self.project_id = project_id
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudVisionHook(gcp_conn_id=self.gcp_conn_id)
+        return hook.remove_product_from_product_set(
+            product_set_id=self.product_set_id,
+            product_id=self.product_id,
+            location=self.location,
+            project_id=self.project_id,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
diff --git a/airflow/utils/decorators.py b/airflow/utils/decorators.py
index 4bc8e0debdaaf..15847cf050857 100644
--- a/airflow/utils/decorators.py
+++ b/airflow/utils/decorators.py
@@ -103,3 +103,19 @@ def wrapper(*args, **kwargs):
     # flake8: noqa: F811
     # Monkey patch hook to get good function headers while building docs
     apply_defaults = lambda x: x
+
+
+class cached_property:
+    """
+    A decorator creating a property, the value of which is calculated only once and cached for later use.
+    """
+    def __init__(self, func):
+        self.func = func
+        self.__doc__ = getattr(func, '__doc__')
+
+    def __get__(self, instance, cls=None):
+        if instance is None:
+            return self
+        result = self.func(instance)
+        instance.__dict__[self.func.__name__] = result
+        return result
diff --git a/docs/code.rst b/docs/code.rst
index 77a6f9abf0930..13dec2f79f061 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -209,6 +209,8 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
 .. autoclass:: airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
@@ -217,6 +219,8 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator
 .. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
diff --git a/docs/howto/operator/gcp/vision.rst b/docs/howto/operator/gcp/vision.rst
index ee280cfa8ce72..165eca13e7787 100644
--- a/docs/howto/operator/gcp/vision.rst
+++ b/docs/howto/operator/gcp/vision.rst
@@ -22,15 +22,180 @@ Google Cloud Vision Operators
   :depth: 1
   :local:
 
-.. _howto/operator:CloudVisionProductSetCreateOperator:
+.. _howto/operator:CloudVisionAddProductToProductSetOperator:
 
-CloudVisionProductSetCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudVisionAddProductToProductSetOperator
+-----------------------------------------
 
-Creates a new :code:`ProductSet` resource.
+Creates a new :code:`ReferenceImage` resource.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_set_explicit_id]
+      :end-before: [END howto_operator_vision_product_set_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+We are using the :class:`~google.cloud.vision_v1.types.Product`,
+:class:`~google.cloud.vision_v1.types.ProductSet` and ``Retry`` objects from
+Google libraries:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_set_import]
+      :end-before: [END howto_operator_vision_product_set_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_import]
+      :end-before: [END howto_operator_vision_product_import]
+
+
+If ``product_set_id`` and ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_add_product_to_product_set]
+      :end-before: [END howto_operator_vision_add_product_to_product_set]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_add_product_to_product_set_2]
+      :end-before: [END howto_operator_vision_add_product_to_product_set_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_add_product_to_product_set_template_fields]
+    :end-before: [END vision_add_product_to_product_set_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Add Product To Product Set documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.add_product_to_product_set>`_.
+
+
+.. _howto/operator:CloudVisionAnnotateImageOperator:
+
+CloudVisionAnnotateImageOperator
+--------------------------------
+
+Run image detection and annotation for an image.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_annotate_image_url]
+      :end-before: [END howto_operator_vision_annotate_image_url]
+
+
+Using the operator
+""""""""""""""""""
+
+We are using the :class:`~google.cloud.enums` and ``Retry`` objects from
+Google libraries:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_enums_import]
+      :end-before: [END howto_operator_vision_enums_import]
+
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_annotate_image]
+      :end-before: [END howto_operator_vision_annotate_image]
+
+The result can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_annotate_image_result]
+      :end-before: [END howto_operator_vision_annotate_image_result]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_annotate_image_template_fields]
+    :end-before: [END vision_annotate_image_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Annotate Image documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ImageAnnotatorClient.annotate_image>`_.
+
+.. _howto/operator:CloudVisionProductCreateOperator:
+
+CloudVisionProductCreateOperator
+--------------------------------
+
+Creates and returns a new product resource.
+
+Possible errors regarding the :code:`Product` object provided:
+
+- Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
+- Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
 
 Arguments
 """""""""
@@ -44,18 +209,18 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_explicit_id]
-    :end-before: [END howto_operator_vision_productset_explicit_id]
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
 
 Using the operator
 """"""""""""""""""
 
-We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
+We are using the ``Product`` and ``Retry`` objects from Google libraries:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_import]
-    :end-before: [END howto_operator_vision_productset_import]
+    :start-after: [START howto_operator_vision_product_import]
+    :end-before: [END howto_operator_vision_product_import]
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
@@ -64,24 +229,24 @@ We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset]
-    :end-before: [END howto_operator_vision_productset]
+    :start-after: [START howto_operator_vision_product]
+    :end-before: [END howto_operator_vision_product]
 
-The ``product_set_id`` argument can be omitted (it will be generated by the API):
+The ``product_id`` argument can be omitted (it will be generated by the API):
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_create]
-    :end-before: [END howto_operator_vision_product_set_create]
+    :start-after: [START howto_operator_vision_product_create]
+    :end-before: [END howto_operator_vision_product_create]
 
 Or it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_create_2]
-    :end-before: [END howto_operator_vision_product_set_create_2]
+    :start-after: [START howto_operator_vision_product_create_2]
+    :end-before: [END howto_operator_vision_product_create_2]
 
 
 Templating
@@ -90,24 +255,32 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_productset_create_template_fields]
-    :end-before: [END vision_productset_create_template_fields]
+    :start-after: [START vision_product_create_template_fields]
+    :end-before: [END vision_product_create_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision ProductSet create documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product_set>`_.
+See `Google Cloud Vision Product create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product>`_.
 
-.. _howto/operator:CloudVisionProductSetGetOperator:
+.. _howto/operator:CloudVisionProductDeleteOperator:
 
-CloudVisionProductSetGetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudVisionProductDeleteOperator
+--------------------------------
 
-Gets information associated with a :code:`ProductSet`.
+Permanently deletes a product and its reference images.
+
+Metadata of the product and all its images will be deleted right away, but search queries
+against :code:`ProductSets` containing the product may still work until all related
+caches are refreshed.
+
+Possible errors:
+
+- Returns NOT_FOUND if the product does not exist.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
 
 Arguments
 """""""""
@@ -121,27 +294,27 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_explicit_id]
-    :end-before: [END howto_operator_vision_productset_explicit_id]
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
 
 Using the operator
 """"""""""""""""""
 
-If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+If ``product_id`` was generated by the API it can be extracted from XCOM:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_get]
-    :end-before: [END howto_operator_vision_product_set_get]
+    :start-after: [START howto_operator_vision_product_delete]
+    :end-before: [END howto_operator_vision_product_delete]
 
 Otherwise it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_get_2]
-    :end-before: [END howto_operator_vision_product_set_get_2]
+    :start-after: [START howto_operator_vision_product_delete_2]
+    :end-before: [END howto_operator_vision_product_delete_2]
 
 Templating
 """"""""""
@@ -149,36 +322,87 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_productset_get_template_fields]
-    :end-before: [END vision_productset_get_template_fields]
+    :start-after: [START vision_product_delete_template_fields]
+    :end-before: [END vision_product_delete_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision ProductSet get documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product_set>`_.
+See `Google Cloud Vision Product delete documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product>`_.
 
-.. _howto/operator:CloudVisionProductSetUpdateOperator:
+.. _howto/operator:CloudVisionProductGetOperator:
 
-CloudVisionProductSetUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudVisionProductGetOperator
+-----------------------------
 
-Makes changes to a :code:`ProductSet` resource. Only :code:`display_name` can be updated
-currently.
+Gets information associated with a :code:`Product`.
 
-.. note:: To locate the `ProductSet` resource, its `name` in the form
-  ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`` is necessary.
+Possible errors:
 
-You can provide the `name` directly as an attribute of the `product_set` object.
-However, you can leave it blank and provide `location` and `product_set_id` instead (and
-optionally `project_id` - if not present, the connection default will be used) and the
-`name` will be created by the operator itself.
+- Returns NOT_FOUND if the `Product` does not exist.
 
-This mechanism exists for your convenience, to allow leaving the `project_id` empty and
-having Airflow use the connection default `project_id`.
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_args_common]
+    :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_explicit_id]
+    :end-before: [END howto_operator_vision_product_explicit_id]
+
+Using the operator
+""""""""""""""""""
+
+If ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_get]
+    :end-before: [END howto_operator_vision_product_get]
+
+Otherwise it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_vision_product_get_2]
+    :end-before: [END howto_operator_vision_product_get_2]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_product_get_template_fields]
+    :end-before: [END vision_product_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision Product get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product>`_.
+
+.. _howto/operator:CloudVisionProductSetCreateOperator:
+
+CloudVisionProductSetCreateOperator
+-----------------------------------
+
+Creates a new :code:`ProductSet` resource.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
 
 Arguments
 """""""""
@@ -192,41 +416,45 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_explicit_id]
-    :end-before: [END howto_operator_vision_productset_explicit_id]
+    :start-after: [START howto_operator_vision_product_set_explicit_id
+    :end-before: [END howto_operator_vision_product_set_explicit_id
 
 Using the operator
 """"""""""""""""""
 
-We are using the ``ProductSet`` object from the Google Cloud Vision library:
+We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_import]
-    :end-before: [END howto_operator_vision_productset_import]
+    :start-after: [START howto_operator_vision_product_set_import]
+    :end-before: [END howto_operator_vision_product_set_import]
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset]
-    :end-before: [END howto_operator_vision_productset]
+    :start-after: [START howto_operator_vision_retry_import]
+    :end-before: [END howto_operator_vision_retry_import]
 
-Initialization of the task:
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_set]
+    :end-before: [END howto_operator_vision_product_set]
 
-If ``product_set_id`` was generated by the API it can be extracted from XCOM:
+The ``product_set_id`` argument can be omitted (it will be generated by the API):
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_update]
-    :end-before: [END howto_operator_vision_product_set_update]
+    :start-after: [START howto_operator_vision_product_set_create]
+    :end-before: [END howto_operator_vision_product_set_create]
 
-Otherwise it can be specified explicitly:
+Or it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_set_update_2]
-    :end-before: [END howto_operator_vision_product_set_update_2]
+    :start-after: [START howto_operator_vision_product_set_create_2]
+    :end-before: [END howto_operator_vision_product_set_create_2]
+
 
 Templating
 """"""""""
@@ -234,19 +462,19 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_productset_update_template_fields]
-    :end-before: [END vision_productset_update_template_fields]
+    :start-after: [START vision_productset_create_template_fields]
+    :end-before: [END vision_productset_create_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision ProductSet update documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product_set>`_.
+See `Google Cloud Vision ProductSet create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product_set>`_.
 
 .. _howto/operator:CloudVisionProductSetDeleteOperator:
 
 CloudVisionProductSetDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-----------------------------------
 
 Permanently deletes a :code:`ProductSet`. :code:`Products` and :code:`ReferenceImages` in
 the :code:`ProductSet` are not deleted. The actual image files are not deleted from
@@ -267,8 +495,8 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_productset_explicit_id]
-    :end-before: [END howto_operator_vision_productset_explicit_id]
+    :start-after: [START howto_operator_vision_product_set_explicit_id]
+    :end-before: [END howto_operator_vision_product_set_explicit_id]
 
 Using the operator
 """"""""""""""""""
@@ -304,21 +532,15 @@ More information
 See `Google Cloud Vision ProductSet delete documentation
 <https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product_set>`_.
 
-.. _howto/operator:CloudVisionProductCreateOperator:
-
-CloudVisionProductCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Creates and returns a new product resource.
+.. _howto/operator:CloudVisionProductSetGetOperator:
 
-Possible errors regarding the :code:`Product` object provided:
+CloudVisionProductSetGetOperator
+--------------------------------
 
-- Returns INVALID_ARGUMENT if `display_name` is missing or longer than 4096 characters.
-- Returns INVALID_ARGUMENT if `description` is longer than 4096 characters.
-- Returns INVALID_ARGUMENT if `product_category` is missing or invalid.
+Gets information associated with a :code:`ProductSet`.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
 
 Arguments
 """""""""
@@ -332,45 +554,27 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_product_explicit_id]
-    :end-before: [END howto_operator_vision_product_explicit_id]
+    :start-after: [START howto_operator_vision_product_set_explicit_id]
+    :end-before: [END howto_operator_vision_product_set_explicit_id]
 
 Using the operator
 """"""""""""""""""
 
-We are using the ``Product`` and ``Retry`` objects from Google libraries:
-
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :start-after: [START howto_operator_vision_product_import]
-    :end-before: [END howto_operator_vision_product_import]
-
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :start-after: [START howto_operator_vision_retry_import]
-    :end-before: [END howto_operator_vision_retry_import]
-
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :start-after: [START howto_operator_vision_product]
-    :end-before: [END howto_operator_vision_product]
-
-The ``product_id`` argument can be omitted (it will be generated by the API):
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_create]
-    :end-before: [END howto_operator_vision_product_create]
+    :start-after: [START howto_operator_vision_product_set_get]
+    :end-before: [END howto_operator_vision_product_set_get]
 
-Or it can be specified explicitly:
+Otherwise it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_create_2]
-    :end-before: [END howto_operator_vision_product_create_2]
-
+    :start-after: [START howto_operator_vision_product_set_get_2]
+    :end-before: [END howto_operator_vision_product_set_get_2]
 
 Templating
 """"""""""
@@ -378,28 +582,36 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_product_create_template_fields]
-    :end-before: [END vision_product_create_template_fields]
+    :start-after: [START vision_productset_get_template_fields]
+    :end-before: [END vision_productset_get_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision Product create documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_product>`_.
+See `Google Cloud Vision ProductSet get documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product_set>`_.
 
-.. _howto/operator:CloudVisionProductGetOperator:
+.. _howto/operator:CloudVisionProductSetUpdateOperator:
 
-CloudVisionProductGetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudVisionProductSetUpdateOperator
+-----------------------------------
 
-Gets information associated with a :code:`Product`.
+Makes changes to a :code:`ProductSet` resource. Only :code:`display_name` can be updated
+currently.
 
-Possible errors:
+.. note:: To locate the `ProductSet` resource, its `name` in the form
+  ``projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`` is necessary.
 
-- Returns NOT_FOUND if the `Product` does not exist.
+You can provide the `name` directly as an attribute of the `product_set` object.
+However, you can leave it blank and provide `location` and `product_set_id` instead (and
+optionally `project_id` - if not present, the connection default will be used) and the
+`name` will be created by the operator itself.
+
+This mechanism exists for your convenience, to allow leaving the `project_id` empty and
+having Airflow use the connection default `project_id`.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
 
 Arguments
 """""""""
@@ -413,27 +625,41 @@ Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
-    :start-after: [START howto_operator_vision_product_explicit_id]
-    :end-before: [END howto_operator_vision_product_explicit_id]
+    :start-after: [START howto_operator_vision_product_set_explicit_id]
+    :end-before: [END howto_operator_vision_product_set_explicit_id]
 
 Using the operator
 """"""""""""""""""
 
-If ``product_id`` was generated by the API it can be extracted from XCOM:
+We are using the ``ProductSet`` object from the Google Cloud Vision library:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_set_import]
+    :end-before: [END howto_operator_vision_product_set_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+    :language: python
+    :start-after: [START howto_operator_vision_product_set]
+    :end-before: [END howto_operator_vision_product_set]
+
+Initialization of the task:
+
+If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_get]
-    :end-before: [END howto_operator_vision_product_get]
+    :start-after: [START howto_operator_vision_product_set_update]
+    :end-before: [END howto_operator_vision_product_set_update]
 
 Otherwise it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
-    :start-after: [START howto_operator_vision_product_get_2]
-    :end-before: [END howto_operator_vision_product_get_2]
+    :start-after: [START howto_operator_vision_product_set_update_2]
+    :end-before: [END howto_operator_vision_product_set_update_2]
 
 Templating
 """"""""""
@@ -441,19 +667,19 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_product_get_template_fields]
-    :end-before: [END vision_product_get_template_fields]
+    :start-after: [START vision_productset_update_template_fields]
+    :end-before: [END vision_productset_update_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision Product get documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.get_product>`_.
+See `Google Cloud Vision ProductSet update documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product_set>`_.
 
 .. _howto/operator:CloudVisionProductUpdateOperator:
 
 CloudVisionProductUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------------
 
 Makes changes to a :code:`Product` resource. Only the :code:`display_name`,
 :code:`description`, and :code:`labels` fields can be updated right now.
@@ -544,23 +770,92 @@ More information
 See `Google Cloud Vision Product update documentation
 <https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.update_product>`_.
 
-.. _howto/operator:CloudVisionProductDeleteOperator:
+.. _howto/operator:CloudVisionReferenceImageCreateOperator:
 
-CloudVisionProductDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CloudVisionReferenceImageCreateOperator
+---------------------------------------
 
-Permanently deletes a product and its reference images.
+Creates a new :code:`ReferenceImage` resource.
 
-Metadata of the product and all its images will be deleted right away, but search queries
-against :code:`ProductSets` containing the product may still work until all related
-caches are refreshed.
+For parameter definition, take a look at
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator`
 
-Possible errors:
+Arguments
+"""""""""
 
-- Returns NOT_FOUND if the product does not exist.
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_reference_image_args]
+      :end-before: [END howto_operator_vision_reference_image_args]
+
+Using the operator
+""""""""""""""""""
+
+We are using the :class:`~google.cloud.vision_v1.types.ReferenceImage` and ``Retry`` objects from Google libraries:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_reference_image_import]
+      :end-before: [END howto_operator_vision_reference_image_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_reference_image]
+      :end-before: [END howto_operator_vision_reference_image]
+
+The ``product_set_id`` argument can be omitted (it will be generated by the API):
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_reference_image_create]
+      :end-before: [END howto_operator_vision_reference_image_create]
+
+Or it can be specified explicitly:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_reference_image_create_2]
+      :end-before: [END howto_operator_vision_reference_image_create_2]
+
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START vision_reference_image_create_template_fields]
+    :end-before: [END vision_reference_image_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Vision ReferenceImage create documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.create_reference_image>`_.
+
+.. _howto/operator:CloudVisionRemoveProductFromProductSetOperator:
+
+CloudVisionRemoveProductFromProductSetOperator
+----------------------------------------------
+
+Creates a new :code:`ReferenceImage` resource.
 
 For parameter definition, take a look at
-:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator`
 
 Arguments
 """""""""
@@ -568,33 +863,59 @@ Arguments
 Some arguments in the example DAG are taken from the OS environment variables:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :start-after: [START howto_operator_vision_args_common]
-    :end-before: [END howto_operator_vision_args_common]
+      :language: python
+      :start-after: [START howto_operator_vision_args_common]
+      :end-before: [END howto_operator_vision_args_common]
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :start-after: [START howto_operator_vision_product_explicit_id]
-    :end-before: [END howto_operator_vision_product_explicit_id]
+      :language: python
+      :start-after: [START howto_operator_vision_product_explicit_id]
+      :end-before: [END howto_operator_vision_product_explicit_id]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_set_explicit_id]
+      :end-before: [END howto_operator_vision_product_set_explicit_id]
 
 Using the operator
 """"""""""""""""""
 
-If ``product_id`` was generated by the API it can be extracted from XCOM:
+We are using the :class:`~google.cloud.vision_v1.types.Product`,
+:class:`~google.cloud.vision_v1.types.ProductSet` and ``Retry`` objects from
+Google libraries:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_vision_product_delete]
-    :end-before: [END howto_operator_vision_product_delete]
+      :language: python
+      :start-after: [START howto_operator_vision_retry_import]
+      :end-before: [END howto_operator_vision_retry_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_set_import]
+      :end-before: [END howto_operator_vision_product_set_import]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :start-after: [START howto_operator_vision_product_import]
+      :end-before: [END howto_operator_vision_product_import]
+
+
+If ``product_set_id`` and ``product_id`` was generated by the API it can be extracted from XCOM:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_remove_product_from_product_set]
+      :end-before: [END howto_operator_vision_remove_product_from_product_set]
 
 Otherwise it can be specified explicitly:
 
 .. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
-    :language: python
-    :dedent: 4
-    :start-after: [START howto_operator_vision_product_delete_2]
-    :end-before: [END howto_operator_vision_product_delete_2]
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_vision_remove_product_from_product_set_2]
+      :end-before: [END howto_operator_vision_remove_product_from_product_set_2]
+
 
 Templating
 """"""""""
@@ -602,11 +923,11 @@ Templating
 .. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
-    :start-after: [START vision_product_delete_template_fields]
-    :end-before: [END vision_product_delete_template_fields]
+    :start-after: [START vision_remove_product_from_product_set_template_fields]
+    :end-before: [END vision_remove_product_from_product_set_template_fields]
 
 More information
 """"""""""""""""
 
-See `Google Cloud Vision Product delete documentation
-<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.delete_product>`_.
+See `Google Cloud Vision Remove Product From Product Set documentation
+<https://googleapis.github.io/google-cloud-python/latest/vision/gapic/v1/api.html#google.cloud.vision_v1.ProductSearchClient.remove_product_from_product_set>`_.
diff --git a/docs/integration.rst b/docs/integration.rst
index 9ec656f8ee8dd..7e282b0d945d0 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1469,22 +1469,30 @@ Cloud Vision
 Cloud Vision Product Search Operators
 """""""""""""""""""""""""""""""""""""
 
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator`
+    Adds a Product to the specified ProductSet.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator`
+    Run image detection and annotation for an image.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+    Creates a new Product resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+    Permanently deletes a product and its reference images.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+    Gets information associated with a Product.
 :class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
     Creates a new ProductSet resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+    Permanently deletes a ProductSet.
 :class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
     Gets information associated with a ProductSet.
 :class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
     Makes changes to a ProductSet resource.
-:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
-    Permanently deletes a ProductSet.
-:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
-    Creates a new Product resource.
-:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
-    Gets information associated with a Product.
 :class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
     Makes changes to a Product resource.
-:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
-    Permanently deletes a product and its reference images.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator`
+    Creates a new ReferenceImage resource.
+:class:`airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator`
+    Removes a Product from the specified ProductSet.
 
 They also use :class:`airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook` to communicate with Google Cloud Platform.
 
diff --git a/tests/contrib/hooks/test_gcp_api_base_hook.py b/tests/contrib/hooks/test_gcp_api_base_hook.py
index 116f684da9edc..b22e8c0881240 100644
--- a/tests/contrib/hooks/test_gcp_api_base_hook.py
+++ b/tests/contrib/hooks/test_gcp_api_base_hook.py
@@ -21,10 +21,16 @@
 import os
 import unittest
 
+from parameterized import parameterized
+from google.api_core.exceptions import RetryError, AlreadyExists
+from google.cloud.exceptions import MovedPermanently
+
+from airflow import AirflowException, LoggingMixin
 from airflow.contrib.hooks import gcp_api_base_hook as hook
 
 import google.auth
 from google.auth.exceptions import GoogleAuthError
+
 try:
     from StringIO import StringIO
 except ImportError:
@@ -46,6 +52,55 @@
     default_creds_available = False
 
 
+class TestCatchHttpException(unittest.TestCase):
+    def test_no_exception(self):
+        self.called = False
+
+        class FixtureClass(LoggingMixin):
+            @hook.GoogleCloudBaseHook.catch_http_exception
+            def text_fixture(*args, **kwargs):
+                self.called = True
+
+        FixtureClass().text_fixture()
+
+        self.assertTrue(self.called)
+
+    @parameterized.expand(
+        [
+            (MovedPermanently("MESSAGE"),),
+            (RetryError("MESSAGE", cause=Exception("MESSAGE")),),
+            (ValueError("MESSAGE"),),
+        ]
+    )
+    def test_raise_airflowexception(self, ex_obj):
+        self.called = False
+
+        class FixtureClass(LoggingMixin):
+            @hook.GoogleCloudBaseHook.catch_http_exception
+            def test_fixutre(*args, **kwargs):
+                self.called = True
+                raise ex_obj
+
+        with self.assertRaises(AirflowException):
+            FixtureClass().test_fixutre()
+
+        self.assertTrue(self.called)
+
+    def test_raise_alreadyexists(self):
+        self.called = False
+
+        class FixtureClass(LoggingMixin):
+            @hook.GoogleCloudBaseHook.catch_http_exception
+            def test_fixutre(*args, **kwargs):
+                self.called = True
+                raise AlreadyExists("MESSAGE")
+
+        with self.assertRaises(AlreadyExists):
+            FixtureClass().test_fixutre()
+
+        self.assertTrue(self.called)
+
+
 class TestGoogleCloudBaseHook(unittest.TestCase):
     def setUp(self):
         self.instance = hook.GoogleCloudBaseHook()
@@ -81,7 +136,7 @@ def test_default_creds_with_scopes(self):
         'Default GCP credentials not available to run tests')
     def test_default_creds_no_scopes(self):
         self.instance.extras = {
-            'extra__google_cloud_platform__project': default_project,
+            'extra__google_cloud_platform__project': default_project
         }
 
         credentials = self.instance._get_credentials()
@@ -96,19 +151,17 @@ def test_default_creds_no_scopes(self):
 
     def test_provide_gcp_credential_file_decorator_key_path(self):
         key_path = '/test/key-path'
-        self.instance.extras = {
-            'extra__google_cloud_platform__key_path': key_path
-        }
+        self.instance.extras = {'extra__google_cloud_platform__key_path': key_path}
 
         @hook.GoogleCloudBaseHook._Decorators.provide_gcp_credential_file
         def assert_gcp_credential_file_in_env(hook_instance):
             self.assertEqual(os.environ[hook._G_APP_CRED_ENV_VAR],
                              key_path)
+
         assert_gcp_credential_file_in_env(self.instance)
 
     @mock.patch('tempfile.NamedTemporaryFile')
-    def test_provide_gcp_credential_file_decorator_key_content(self,
-                                                               mock_file):
+    def test_provide_gcp_credential_file_decorator_key_content(self, mock_file):
         string_file = StringIO()
         file_content = '{"foo": "bar"}'
         file_name = '/test/mock-file'
@@ -124,4 +177,5 @@ def assert_gcp_credential_file_in_env(hook_instance):
             self.assertEqual(os.environ[hook._G_APP_CRED_ENV_VAR],
                              file_name)
             self.assertEqual(file_content, string_file.getvalue())
+
         assert_gcp_credential_file_in_env(self.instance)
diff --git a/tests/contrib/hooks/test_gcp_vision_hook.py b/tests/contrib/hooks/test_gcp_vision_hook.py
index ddc7114d8a612..ef8f2f0ff8d5e 100644
--- a/tests/contrib/hooks/test_gcp_vision_hook.py
+++ b/tests/contrib/hooks/test_gcp_vision_hook.py
@@ -19,8 +19,9 @@
 
 import unittest
 
+from google.cloud.vision import enums
 from google.cloud.vision_v1 import ProductSearchClient
-from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet, Product
+from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet, Product, ReferenceImage
 from google.protobuf.json_format import MessageToDict
 from parameterized import parameterized
 
@@ -43,8 +44,26 @@
 LOC_ID_TEST_2 = 'loc-id-2'
 PRODUCTSET_ID_TEST = 'ps-id'
 PRODUCTSET_ID_TEST_2 = 'ps-id-2'
+PRODUCTSET_NAME_TEST = 'projects/{}/locations/{}/productSets/{}'.format(
+    PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST
+)
 PRODUCT_ID_TEST = 'p-id'
 PRODUCT_ID_TEST_2 = 'p-id-2'
+PRODUCT_NAME_TEST = "projects/{}/locations/{}/products/{}".format(
+    PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST
+)
+PRODUCT_NAME = "projects/{}/locations/{}/products/{}".format(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
+REFERENCE_IMAGE_ID_TEST = 'ri-id'
+REFERENCE_IMAGE_GEN_ID_TEST = 'ri-id'
+ANNOTATE_IMAGE_REQUEST = {
+    'image': {'source': {'image_uri': "gs://bucket-name/object-name"}},
+    'features': [{'type': enums.Feature.Type.LOGO_DETECTION}],
+}
+REFERENCE_IMAGE_NAME_TEST = "projects/{}/locations/{}/products/{}/referenceImages/{}".format(
+    PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST, REFERENCE_IMAGE_ID_TEST
+)
+REFERENCE_IMAGE_TEST = ReferenceImage(name=REFERENCE_IMAGE_GEN_ID_TEST)
+REFERENCE_IMAGE_WITHOUT_ID_NAME = ReferenceImage()
 
 
 class TestGcpVisionHook(unittest.TestCase):
@@ -53,7 +72,7 @@ def setUp(self):
             'airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.__init__',
             new=mock_base_gcp_hook_default_project_id,
         ):
-            self.vision_hook_default_project_id = CloudVisionHook(gcp_conn_id='test')
+            self.hook = CloudVisionHook(gcp_conn_id='test')
 
     @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
     def test_create_productset_explicit_id(self, get_conn):
@@ -61,10 +80,9 @@ def test_create_productset_explicit_id(self, get_conn):
         create_product_set_method = get_conn.return_value.create_product_set
         create_product_set_method.return_value = None
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product_set = ProductSet()
         # When
-        result = hook.create_product_set(
+        result = self.hook.create_product_set(
             location=LOC_ID_TEST,
             product_set_id=PRODUCTSET_ID_TEST,
             product_set=product_set,
@@ -73,6 +91,7 @@ def test_create_productset_explicit_id(self, get_conn):
             timeout=None,
             metadata=None,
         )
+
         # Then
         # ProductSet ID was provided explicitly in the method call above, should be returned from the method
         self.assertEqual(result, PRODUCTSET_ID_TEST)
@@ -95,10 +114,9 @@ def test_create_productset_autogenerated_id(self, get_conn):
         create_product_set_method = get_conn.return_value.create_product_set
         create_product_set_method.return_value = response_product_set
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product_set = ProductSet()
         # When
-        result = hook.create_product_set(
+        result = self.hook.create_product_set(
             location=LOC_ID_TEST, product_set_id=None, product_set=product_set, project_id=PROJECT_ID_TEST
         )
         # Then
@@ -121,11 +139,10 @@ def test_create_productset_autogenerated_id_wrong_api_response(self, get_conn):
         create_product_set_method = get_conn.return_value.create_product_set
         create_product_set_method.return_value = response_product_set
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product_set = ProductSet()
         # When
         with self.assertRaises(AirflowException) as cm:
-            hook.create_product_set(
+            self.hook.create_product_set(
                 location=LOC_ID_TEST,
                 product_set_id=None,
                 product_set=product_set,
@@ -154,9 +171,8 @@ def test_get_productset(self, get_conn):
         response_product_set = ProductSet(name=name)
         get_product_set_method = get_conn.return_value.get_product_set
         get_product_set_method.return_value = response_product_set
-        hook = self.vision_hook_default_project_id
         # When
-        response = hook.get_product_set(
+        response = self.hook.get_product_set(
             location=LOC_ID_TEST, product_set_id=PRODUCTSET_ID_TEST, project_id=PROJECT_ID_TEST
         )
         # Then
@@ -170,12 +186,11 @@ def test_update_productset_no_explicit_name(self, get_conn):
         product_set = ProductSet()
         update_product_set_method = get_conn.return_value.update_product_set
         update_product_set_method.return_value = product_set
-        hook = self.vision_hook_default_project_id
         productset_name = ProductSearchClient.product_set_path(
             PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST
         )
         # When
-        result = hook.update_product_set(
+        result = self.hook.update_product_set(
             location=LOC_ID_TEST,
             product_set_id=PRODUCTSET_ID_TEST,
             product_set=product_set,
@@ -203,11 +218,10 @@ def test_update_productset_no_explicit_name_and_missing_params_for_constructed_n
         # Given
         update_product_set_method = get_conn.return_value.update_product_set
         update_product_set_method.return_value = None
-        hook = self.vision_hook_default_project_id
         product_set = ProductSet()
         # When
         with self.assertRaises(AirflowException) as cm:
-            hook.update_product_set(
+            self.hook.update_product_set(
                 location=location,
                 product_set_id=product_set_id,
                 product_set=product_set,
@@ -238,9 +252,8 @@ def test_update_productset_explicit_name_missing_params_for_constructed_name(
         product_set = ProductSet(name=explicit_ps_name)
         update_product_set_method = get_conn.return_value.update_product_set
         update_product_set_method.return_value = product_set
-        hook = self.vision_hook_default_project_id
         # When
-        result = hook.update_product_set(
+        result = self.hook.update_product_set(
             location=location,
             product_set_id=product_set_id,
             product_set=product_set,
@@ -265,7 +278,6 @@ def test_update_productset_explicit_name_different_from_constructed(self, get_co
         # Given
         update_product_set_method = get_conn.return_value.update_product_set
         update_product_set_method.return_value = None
-        hook = self.vision_hook_default_project_id
         explicit_ps_name = ProductSearchClient.product_set_path(
             PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCTSET_ID_TEST_2
         )
@@ -278,7 +290,7 @@ def test_update_productset_explicit_name_different_from_constructed(self, get_co
         # but both names differ (constructed != explicit).
         # Should throw AirflowException in this case.
         with self.assertRaises(AirflowException) as cm:
-            hook.update_product_set(
+            self.hook.update_product_set(
                 location=LOC_ID_TEST,
                 product_set_id=PRODUCTSET_ID_TEST,
                 product_set=product_set,
@@ -306,25 +318,129 @@ def test_delete_productset(self, get_conn):
         delete_product_set_method = get_conn.return_value.delete_product_set
         delete_product_set_method.return_value = None
         name = ProductSearchClient.product_set_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCTSET_ID_TEST)
-        hook = self.vision_hook_default_project_id
         # When
-        response = hook.delete_product_set(
+        response = self.hook.delete_product_set(
             location=LOC_ID_TEST, product_set_id=PRODUCTSET_ID_TEST, project_id=PROJECT_ID_TEST
         )
         # Then
         self.assertIsNone(response)
         delete_product_set_method.assert_called_once_with(name=name, retry=None, timeout=None, metadata=None)
 
+    @mock.patch(
+        'airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn',
+        **{'return_value.create_reference_image.return_value': REFERENCE_IMAGE_TEST}
+    )
+    def test_create_reference_image_explicit_id(self, get_conn):
+        # Given
+        create_reference_image_method = get_conn.return_value.create_reference_image
+
+        # When
+        result = self.hook.create_reference_image(
+            project_id=PROJECT_ID_TEST,
+            location=LOC_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_WITHOUT_ID_NAME,
+            reference_image_id=REFERENCE_IMAGE_ID_TEST,
+        )
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        self.assertEqual(result, REFERENCE_IMAGE_ID_TEST)
+        create_reference_image_method.assert_called_once_with(
+            parent=PRODUCT_NAME,
+            reference_image=REFERENCE_IMAGE_WITHOUT_ID_NAME,
+            reference_image_id=REFERENCE_IMAGE_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch(
+        'airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn',
+        **{'return_value.create_reference_image.return_value': REFERENCE_IMAGE_TEST}
+    )
+    def test_create_reference_image_autogenerated_id(self, get_conn):
+        # Given
+        create_reference_image_method = get_conn.return_value.create_reference_image
+
+        # When
+        result = self.hook.create_reference_image(
+            project_id=PROJECT_ID_TEST,
+            location=LOC_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_TEST,
+            reference_image_id=REFERENCE_IMAGE_ID_TEST,
+        )
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        self.assertEqual(result, REFERENCE_IMAGE_GEN_ID_TEST)
+        create_reference_image_method.assert_called_once_with(
+            parent=PRODUCT_NAME,
+            reference_image=REFERENCE_IMAGE_TEST,
+            reference_image_id=REFERENCE_IMAGE_ID_TEST,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_add_product_to_product_set(self, get_conn):
+        # Given
+        add_product_to_product_set_method = get_conn.return_value.add_product_to_product_set
+
+        # When
+        self.hook.add_product_to_product_set(
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            location=LOC_ID_TEST,
+            project_id=PROJECT_ID_TEST,
+        )
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        add_product_to_product_set_method.assert_called_once_with(
+            name=PRODUCTSET_NAME_TEST, product=PRODUCT_NAME_TEST, retry=None, timeout=None, metadata=None
+        )
+
+    # remove_product_from_product_set
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
+    def test_remove_product_from_product_set(self, get_conn):
+        # Given
+        remove_product_from_product_set_method = get_conn.return_value.remove_product_from_product_set
+
+        # When
+        self.hook.remove_product_from_product_set(
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            location=LOC_ID_TEST,
+            project_id=PROJECT_ID_TEST,
+        )
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        remove_product_from_product_set_method.assert_called_once_with(
+            name=PRODUCTSET_NAME_TEST, product=PRODUCT_NAME_TEST, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.annotator_client')
+    def test_annotate_image(self, annotator_client_mock):
+        # Given
+        annotate_image_method = annotator_client_mock.annotate_image
+
+        # When
+        self.hook.annotate_image(request=ANNOTATE_IMAGE_REQUEST)
+        # Then
+        # Product ID was provided explicitly in the method call above, should be returned from the method
+        annotate_image_method.assert_called_once_with(
+            request=ANNOTATE_IMAGE_REQUEST, retry=None, timeout=None
+        )
+
     @mock.patch('airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook.get_conn')
     def test_create_product_explicit_id(self, get_conn):
         # Given
         create_product_method = get_conn.return_value.create_product
         create_product_method.return_value = None
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product = Product()
         # When
-        result = hook.create_product(
+        result = self.hook.create_product(
             location=LOC_ID_TEST, product_id=PRODUCT_ID_TEST, product=product, project_id=PROJECT_ID_TEST
         )
         # Then
@@ -349,10 +465,9 @@ def test_create_product_autogenerated_id(self, get_conn):
         create_product_method = get_conn.return_value.create_product
         create_product_method.return_value = response_product
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product = Product()
         # When
-        result = hook.create_product(
+        result = self.hook.create_product(
             location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
         )
         # Then
@@ -371,11 +486,10 @@ def test_create_product_autogenerated_id_wrong_name_in_response(self, get_conn):
         create_product_method = get_conn.return_value.create_product
         create_product_method.return_value = response_product
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product = Product()
         # When
         with self.assertRaises(AirflowException) as cm:
-            hook.create_product(
+            self.hook.create_product(
                 location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
             )
         # Then
@@ -393,11 +507,10 @@ def test_create_product_autogenerated_id_wrong_api_response(self, get_conn):
         create_product_method = get_conn.return_value.create_product
         create_product_method.return_value = response_product
         parent = ProductSearchClient.location_path(PROJECT_ID_TEST, LOC_ID_TEST)
-        hook = self.vision_hook_default_project_id
         product = Product()
         # When
         with self.assertRaises(AirflowException) as cm:
-            hook.create_product(
+            self.hook.create_product(
                 location=LOC_ID_TEST, product_id=None, product=product, project_id=PROJECT_ID_TEST
             )
         # Then
@@ -414,10 +527,9 @@ def test_update_product_no_explicit_name(self, get_conn):
         product = Product()
         update_product_method = get_conn.return_value.update_product
         update_product_method.return_value = product
-        hook = self.vision_hook_default_project_id
         product_name = ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
         # When
-        result = hook.update_product(
+        result = self.hook.update_product(
             location=LOC_ID_TEST,
             product_id=PRODUCT_ID_TEST,
             product=product,
@@ -441,11 +553,10 @@ def test_update_product_no_explicit_name_and_missing_params_for_constructed_name
         # Given
         update_product_method = get_conn.return_value.update_product
         update_product_method.return_value = None
-        hook = self.vision_hook_default_project_id
         product = Product()
         # When
         with self.assertRaises(AirflowException) as cm:
-            hook.update_product(
+            self.hook.update_product(
                 location=location,
                 product_id=product_id,
                 product=product,
@@ -476,9 +587,8 @@ def test_update_product_explicit_name_missing_params_for_constructed_name(
         product = Product(name=explicit_p_name)
         update_product_method = get_conn.return_value.update_product
         update_product_method.return_value = product
-        hook = self.vision_hook_default_project_id
         # When
-        result = hook.update_product(
+        result = self.hook.update_product(
             location=location,
             product_id=product_id,
             product=product,
@@ -499,7 +609,6 @@ def test_update_product_explicit_name_different_from_constructed(self, get_conn)
         # Given
         update_product_method = get_conn.return_value.update_product
         update_product_method.return_value = None
-        hook = self.vision_hook_default_project_id
         explicit_p_name = ProductSearchClient.product_path(
             PROJECT_ID_TEST_2, LOC_ID_TEST_2, PRODUCT_ID_TEST_2
         )
@@ -510,7 +619,7 @@ def test_update_product_explicit_name_different_from_constructed(self, get_conn)
         # but both names differ (constructed != explicit).
         # Should throw AirflowException in this case.
         with self.assertRaises(AirflowException) as cm:
-            hook.update_product(
+            self.hook.update_product(
                 location=LOC_ID_TEST,
                 product_id=PRODUCT_ID_TEST,
                 product=product,
@@ -538,9 +647,8 @@ def test_delete_product(self, get_conn):
         delete_product_method = get_conn.return_value.delete_product
         delete_product_method.return_value = None
         name = ProductSearchClient.product_path(PROJECT_ID_TEST, LOC_ID_TEST, PRODUCT_ID_TEST)
-        hook = self.vision_hook_default_project_id
         # When
-        response = hook.delete_product(
+        response = self.hook.delete_product(
             location=LOC_ID_TEST, product_id=PRODUCT_ID_TEST, project_id=PROJECT_ID_TEST
         )
         # Then
diff --git a/tests/contrib/operators/test_gcp_vision_operator.py b/tests/contrib/operators/test_gcp_vision_operator.py
index a806f85021d69..3448c1a95de95 100644
--- a/tests/contrib/operators/test_gcp_vision_operator.py
+++ b/tests/contrib/operators/test_gcp_vision_operator.py
@@ -20,7 +20,7 @@
 import unittest
 
 from google.api_core.exceptions import AlreadyExists
-from google.cloud.vision_v1.proto.product_search_service_pb2 import ProductSet, Product
+from google.cloud.vision_v1.types import ProductSet, Product, ReferenceImage
 
 from airflow.contrib.operators.gcp_vision_operator import (
     CloudVisionProductSetCreateOperator,
@@ -31,6 +31,10 @@
     CloudVisionProductGetOperator,
     CloudVisionProductUpdateOperator,
     CloudVisionProductDeleteOperator,
+    CloudVisionReferenceImageCreateOperator,
+    CloudVisionAddProductToProductSetOperator,
+    CloudVisionRemoveProductFromProductSetOperator,
+    CloudVisionAnnotateImageOperator,
 )
 
 try:
@@ -46,6 +50,9 @@
 PRODUCTSET_ID_TEST = 'my-productset'
 PRODUCT_TEST = Product(display_name='My Product 1', product_category='toys')
 PRODUCT_ID_TEST = 'my-product'
+REFERENCE_IMAGE_TEST = ReferenceImage(uri='gs://bucket_name/file.txt')
+REFERENCE_IMAGE_ID_TEST = 'my-reference-image'
+ANNOTATE_REQUEST_TEST = {'image': {'source': {'image_uri': 'https://foo.com/image.jpg'}}}
 LOCATION_TEST = 'europe-west1'
 GCP_CONN_ID = 'google_cloud_default'
 
@@ -70,10 +77,10 @@ def test_minimal_green_path(self, mock_hook):
         )
 
     @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.get_conn')
-    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook._handle_request')
-    def test_already_exists(self, _handle_request, get_conn):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.create_product_set')
+    def test_already_exists(self, create_product_set_mock, get_conn):
         get_conn.return_value = {}
-        _handle_request.side_effect = AlreadyExists(message='')
+        create_product_set_mock.side_effect = AlreadyExists(message='')
         # Exception AlreadyExists not raised, caught in the operator's execute() - idempotence
         op = CloudVisionProductSetCreateOperator(
             location=LOCATION_TEST,
@@ -163,10 +170,10 @@ def test_minimal_green_path(self, mock_hook):
         )
 
     @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.get_conn')
-    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook._handle_request')
-    def test_already_exists(self, _handle_request, get_conn):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook.create_product')
+    def test_already_exists(self, create_product_mock, get_conn):
         get_conn.return_value = {}
-        _handle_request.side_effect = AlreadyExists(message='')
+        create_product_mock.side_effect = AlreadyExists(message='')
         # Exception AlreadyExists not raised, caught in the operator's execute() - idempotence
         op = CloudVisionProductCreateOperator(
             location=LOCATION_TEST,
@@ -232,3 +239,109 @@ def test_minimal_green_path(self, mock_hook):
             timeout=None,
             metadata=None,
         )
+
+
+class CloudVisionReferenceImageCreateTest(unittest.TestCase):
+    @mock.patch(
+        'airflow.contrib.operators.gcp_vision_operator.CloudVisionHook',
+        **{'return_value.create_reference_image.return_value': {}}
+    )
+    def test_minimal_green_path(self, mock_hook):
+        op = CloudVisionReferenceImageCreateOperator(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_TEST,
+            task_id='id',
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.create_reference_image.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_TEST,
+            reference_image_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch(
+        'airflow.contrib.operators.gcp_vision_operator.CloudVisionHook',
+        **{'return_value.create_reference_image.side_effect': AlreadyExists("MESSAGe")}
+    )
+    def test_already_exists(self, mock_hook):
+        # Exception AlreadyExists not raised, caught in the operator's execute() - idempotence
+        op = CloudVisionReferenceImageCreateOperator(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_TEST,
+            task_id='id',
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.create_reference_image.assert_called_once_with(
+            location=LOCATION_TEST,
+            product_id=PRODUCT_ID_TEST,
+            reference_image=REFERENCE_IMAGE_TEST,
+            reference_image_id=None,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionAddProductToProductSetOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        op = CloudVisionAddProductToProductSetOperator(
+            location=LOCATION_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            task_id='id',
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.add_product_to_product_set.assert_called_once_with(
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            location=LOCATION_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionRemoveProductFromProductSetOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        op = CloudVisionRemoveProductFromProductSetOperator(
+            location=LOCATION_TEST,
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            task_id='id',
+        )
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.remove_product_from_product_set.assert_called_once_with(
+            product_set_id=PRODUCTSET_ID_TEST,
+            product_id=PRODUCT_ID_TEST,
+            location=LOCATION_TEST,
+            project_id=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+
+class CloudVisionAnnotateImageOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_vision_operator.CloudVisionHook')
+    def test_minimal_green_path(self, mock_hook):
+        op = CloudVisionAnnotateImageOperator(request=ANNOTATE_REQUEST_TEST, task_id='id')
+        op.execute(context=None)
+        mock_hook.assert_called_once_with(gcp_conn_id=GCP_CONN_ID)
+        mock_hook.return_value.annotate_image.assert_called_once_with(
+            request=ANNOTATE_REQUEST_TEST, retry=None, timeout=None
+        )
diff --git a/tests/contrib/operators/test_gcp_vision_operator_system.py b/tests/contrib/operators/test_gcp_vision_operator_system.py
index 2b75642d6f3a3..8618e61bcf6e8 100644
--- a/tests/contrib/operators/test_gcp_vision_operator_system.py
+++ b/tests/contrib/operators/test_gcp_vision_operator_system.py
@@ -19,16 +19,41 @@
 
 import unittest
 
-from tests.contrib.utils.base_gcp_system_test_case import DagGcpSystemTestCase, SKIP_TEST_WARNING
 from tests.contrib.utils.gcp_authenticator import GCP_AI_KEY
+from tests.contrib.operators.test_gcp_vision_operator_system_helper import GCPVisionTestHelper
+from tests.contrib.utils.base_gcp_system_test_case import SKIP_TEST_WARNING, DagGcpSystemTestCase
+
+VISION_HELPER = GCPVisionTestHelper()
 
 
 @unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_AI_KEY), SKIP_TEST_WARNING)
 class CloudVisionExampleDagsSystemTest(DagGcpSystemTestCase):
     def __init__(self, method_name='runTest'):
         super(CloudVisionExampleDagsSystemTest, self).__init__(
-            method_name, dag_id='example_gcp_vision', gcp_key=GCP_AI_KEY
+            method_name, dag_name='example_gcp_vision.py', gcp_key=GCP_AI_KEY
         )
 
-    def test_run_example_dag_function(self):
-        self._run_dag()
+    def setUp(self):
+        super(CloudVisionExampleDagsSystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            VISION_HELPER.create_bucket()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        try:
+            VISION_HELPER.delete_bucket()
+        finally:
+            self.gcp_authenticator.gcp_revoke_authentication()
+        super(CloudVisionExampleDagsSystemTest, self).tearDown()
+
+    def test_run_example_gcp_vision_autogenerated_id_dag(self):
+        self._run_dag('example_gcp_vision_autogenerated_id')
+
+    def test_run_example_gcp_vision_explicit_id_dag(self):
+        self._run_dag('example_gcp_vision_explicit_id')
+
+    def test_run_example_gcp_vision_annotate_image_dag(self):
+        self._run_dag('example_gcp_vision_annotate_image')
diff --git a/tests/contrib/operators/test_gcp_vision_operator_system_helper.py b/tests/contrib/operators/test_gcp_vision_operator_system_helper.py
new file mode 100755
index 0000000000000..3a88286ca25e4
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_vision_operator_system_helper.py
@@ -0,0 +1,90 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import os
+
+import argparse
+from tempfile import NamedTemporaryFile
+
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_AI_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_BUCKET_NAME = os.environ.get('GCP_VISION_BUCKET_NAME', 'vision-bucket-system-test')
+GCP_REFERENCE_IMAGE_URL = os.environ.get('GCP_VISION_REFERENCE_IMAGE_URL', 'gs://bucket-name/image.png')
+GCP_ANNOTATE_IMAGE_URL = os.environ.get('GCP_VISION_ANNOTATE_IMAGE_URL', 'gs://bucket-name/image.png')
+GCP_VIDEO_SOURCE_URL = os.environ.get('GCP_VISION_SOURCE_IMAGE_URL', "http://google.com/image.jpg")
+
+
+class GCPVisionTestHelper(LoggingCommandExecutor):
+    def create_bucket(self):
+        self.execute_cmd(
+            [
+                'gsutil',
+                'mb',
+                "-p",
+                GCP_PROJECT_ID,
+                "-c",
+                "regional",
+                "-l",
+                "europe-north1",
+                "gs://%s/" % GCP_BUCKET_NAME,
+            ]
+        )
+
+        with NamedTemporaryFile(suffix=".png") as file:
+            self.execute_cmd(["curl", "-s", GCP_VIDEO_SOURCE_URL, "-o", file.name])
+            self.execute_cmd(['gsutil', 'cp', file.name, GCP_REFERENCE_IMAGE_URL])
+            self.execute_cmd(['gsutil', 'cp', file.name, GCP_ANNOTATE_IMAGE_URL])
+
+    def delete_bucket(self):
+        self.execute_cmd(['gsutil', 'rm', '-r', "gs://%s/" % GCP_BUCKET_NAME])
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description='Create and remove a bucket for system tests.')
+    parser.add_argument(
+        '--action',
+        dest='action',
+        required=True,
+        choices=('create-bucket', 'delete-bucket', 'before-tests', 'after-tests'),
+    )
+    action = parser.parse_args().action
+
+    helper = GCPVisionTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_AI_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'create-bucket':
+            helper.create_bucket()
+        elif action == 'delete-bucket':
+            helper.delete_bucket()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/utils/base_gcp_system_test_case.py b/tests/contrib/utils/base_gcp_system_test_case.py
index 113d3e31526db..70b47497c8680 100644
--- a/tests/contrib/utils/base_gcp_system_test_case.py
+++ b/tests/contrib/utils/base_gcp_system_test_case.py
@@ -119,8 +119,8 @@ def tearDown(self):
 class DagGcpSystemTestCase(BaseGcpSystemTestCase):
     def __init__(self,
                  method_name,
-                 dag_id,
                  gcp_key,
+                 dag_id=None,
                  dag_name=None,
                  require_local_executor=False,
                  example_dags_folder=CONTRIB_OPERATORS_EXAMPLES_DAG_FOLDER,
@@ -161,24 +161,21 @@ def _symlink_dag_and_associated_files(self, remove=False):
             target_path = os.path.join(target_folder, file_name)
             if remove:
                 try:
-                    self.log.info("Remove symlink: {} -> {} ".format(
-                        target_path, source_path))
+                    self.log.info("Remove symlink: %s -> %s", target_path, source_path)
                     os.remove(target_path)
                 except OSError:
                     pass
             else:
                 if not os.path.exists(target_path):
-                    self.log.info("Symlink: {} -> {} ".format(target_path, source_path))
+                    self.log.info("Symlink: %s -> %s ", target_path, source_path)
                     os.symlink(source_path, target_path)
                 else:
-                    self.log.info("Symlink {} already exists. Not symlinking it.".
-                                  format(target_path))
+                    self.log.info("Symlink %s already exists. Not symlinking it.", target_path)
 
     def _store_dags_to_temporary_directory(self):
         dag_folder = self._get_dag_folder()
         self.temp_dir = mkdtemp()
-        self.log.info("Storing DAGS from {} to temporary directory {}".
-                      format(dag_folder, self.temp_dir))
+        self.log.info("Storing DAGS from %s to temporary directory %s", dag_folder, self.temp_dir)
         try:
             os.mkdir(dag_folder)
         except OSError:
@@ -188,20 +185,19 @@ def _store_dags_to_temporary_directory(self):
 
     def _restore_dags_from_temporary_directory(self):
         dag_folder = self._get_dag_folder()
-        self.log.info("Restoring DAGS to {} from temporary directory {}"
-                      .format(dag_folder, self.temp_dir))
+        self.log.info("Restoring DAGS to %s from temporary directory %s", dag_folder, self.temp_dir)
         for file in os.listdir(self.temp_dir):
             move(os.path.join(self.temp_dir, file), os.path.join(dag_folder, file))
 
-    def _run_dag(self):
-        self.log.info("Attempting to run DAG: {}".format(self.dag_id))
+    def _run_dag(self, dag_id=None):
+        self.log.info("Attempting to run DAG: %s", self.dag_id)
         if not self.setup_called:
             raise AirflowException("Please make sure to call super.setUp() in your "
                                    "test class!")
         dag_folder = self._get_dag_folder()
         dag_bag = models.DagBag(dag_folder=dag_folder, include_examples=False)
         self.args = {'owner': 'airflow', 'start_date': DEFAULT_DATE}
-        dag = dag_bag.get_dag(self.dag_id)
+        dag = dag_bag.get_dag(self.dag_id or dag_id)
         if dag is None:
             raise AirflowException(
                 "The Dag {} could not be found. It's either an import problem or "
diff --git a/tests/utils/test_decorators.py b/tests/utils/test_decorators.py
index 3a196dd8a1eb0..5e6ff5f935714 100644
--- a/tests/utils/test_decorators.py
+++ b/tests/utils/test_decorators.py
@@ -18,7 +18,8 @@
 # under the License.
 
 import unittest
-from airflow.utils.decorators import apply_defaults
+
+from airflow.utils.decorators import apply_defaults, cached_property
 from airflow.exceptions import AirflowException
 
 
@@ -72,3 +73,29 @@ def test_incorrect_default_args(self):
         default_args = {'random_params': True}
         with self.assertRaisesRegexp(AirflowException, 'Argument.*test_param.*required'):
             DummyClass(default_args=default_args)
+
+
+class FixtureClass:
+    @cached_property
+    def value(self):
+        """Fixture docstring"""
+        return 1, object()
+
+
+class FixtureSubClass(FixtureClass):
+    pass
+
+
+class CachedPropertyTest(unittest.TestCase):
+
+    def setUp(self):
+        self.test_obj = FixtureClass()
+        self.test_sub_obj = FixtureSubClass()
+
+    def test_cache_works(self):
+        self.assertIs(self.test_obj.value, self.test_obj.value)
+        self.assertIs(self.test_sub_obj.value, self.test_sub_obj.value)
+
+    def test_docstring(self):
+        self.assertEqual(FixtureClass.value.__doc__, "Fixture docstring")
+        self.assertEqual(FixtureSubClass.value.__doc__, "Fixture docstring")

From ffa63b34c0c614a0ac1d7a61cfec780b5ba47ecd Mon Sep 17 00:00:00 2001
From: Siddharth Gupta <sid88in@gmail.com>
Date: Sat, 13 Oct 2018 00:16:40 -0700
Subject: [PATCH 717/808] [AIRFLOW-3202] add missing documentation for AWS
 hooks/operator (#4048)

Add missing documentation for AWS hooks/operator
---
 docs/code.rst        |  1 +
 docs/integration.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+)

diff --git a/docs/code.rst b/docs/code.rst
index 13dec2f79f061..277ec9b6382d6 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -480,6 +480,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
 .. autoclass:: airflow.contrib.hooks.aws_glue_catalog_hook.AwsGlueCatalogHook
 .. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
+.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
 .. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
 .. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
 .. autoclass:: airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook
diff --git a/docs/integration.rst b/docs/integration.rst
index 7e282b0d945d0..d58bb49d0dd64 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -543,6 +543,54 @@ SageMakerEndpointOperator
 .. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
     :noindex:
 
+AWS DynamoDB
+''''''''''''
+
+- :ref:`HiveToDynamoDBTransferOperator` :  Moves data from Hive to DynamoDB.
+- :ref:`AwsDynamoDBHook` : Interact with AWS DynamoDB.
+
+.. _HiveToDynamoDBTransferOperator:
+
+HiveToDynamoDBTransferOperator
+""""""""""""""""""""""""""""""
+
+.. autoclass:: airflow.contrib.operators.hive_to_dynamodb.HiveToDynamoDBTransferOperator
+   :noindex:
+
+.. _AwsDynamoDBHook:
+
+AwsDynamoDBHook
+"""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
+   :noindex:
+
+AWS Lambda
+''''''''''
+
+- :ref:`AwsLambdaHook` : Interact with AWS Lambda.
+
+.. _AwsLambdaHook:
+
+AwsLambdaHook
+"""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
+   :noindex:
+
+AWS Kinesis
+'''''''''''
+
+- :ref:`AwsFirehoseHook` : Interact with AWS Kinesis Firehose.
+
+.. _AwsFirehoseHook:
+
+AwsFirehoseHook
+"""""""""""""""
+
+.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
+   :noindex:
+
 .. _Databricks:
 
 Databricks

From a4000f30251278945025326a72c653ba3e8d53aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 6 Feb 2019 15:35:12 +0100
Subject: [PATCH 718/808] [AIRFLOW-3810] Remove duplicate autoclass directive
 (#4656)

---
 docs/integration.rst | 1402 +++++++++---------------------------------
 1 file changed, 278 insertions(+), 1124 deletions(-)

diff --git a/docs/integration.rst b/docs/integration.rst
index d58bb49d0dd64..a48e38793e86d 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -1,4 +1,3 @@
-
 ..  Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
@@ -111,50 +110,21 @@ Airflow connection of type `wasb` exists. Authorization can be done by supplying
 login (=Storage account name) and password (=KEY), or login and SAS token in the extra
 field (see connection `wasb_default` for an example).
 
-- :ref:`WasbBlobSensor`: Checks if a blob is present on Azure Blob storage.
-- :ref:`WasbPrefixSensor`: Checks if blobs matching a prefix are present on Azure Blob storage.
-- :ref:`FileToWasbOperator`: Uploads a local file to a container as a blob.
-- :ref:`WasbHook`: Interface with Azure Blob Storage.
-
-.. _WasbBlobSensor:
-
-WasbBlobSensor
-""""""""""""""
-
-.. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
-    :noindex:
-
-.. _WasbDeleteBlobOperator:
-
-WasbDeleteBlobOperator
-""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.wasb_delete_blob_operator.WasbDeleteBlobOperator
-    :noindex:
-
-.. _WasbPrefixSensor:
-
-WasbPrefixSensor
-""""""""""""""""
-
-.. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor
-    :noindex:
+:class:`airflow.contrib.hooks.wasb_hook.WasbHook`
+    Interface with Azure Blob Storage.
 
-.. _FileToWasbOperator:
+:class:`airflow.contrib.sensors.wasb_sensor.WasbBlobSensor`
+    Checks if a blob is present on Azure Blob storage.
 
-FileToWasbOperator
-""""""""""""""""""
+:class:`airflow.contrib.operators.wasb_delete_blob_operator.WasbDeleteBlobOperator`
+    Deletes blob(s) on Azure Blob Storage.
 
-.. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
-    :noindex:
+:class:`airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor`
+    Checks if blobs matching a prefix are present on Azure Blob storage.
 
-.. _WasbHook:
+:class:`airflow.contrib.operators.file_to_wasb.FileToWasbOperator`
+    Uploads a local file to a container as a blob.
 
-WasbHook
-""""""""
-
-.. autoclass:: airflow.contrib.hooks.wasb_hook.WasbHook
-    :noindex:
 
 Azure File Share
 ''''''''''''''''
@@ -164,11 +134,8 @@ type `wasb` exists. Authorization can be done by supplying a login (=Storage acc
 and password (=Storage account key), or login and SAS token in the extra field
 (see connection `wasb_default` for an example).
 
-AzureFileShareHook
-""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
-    :noindex:
+:class:`airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook`:
+    Interface with Azure File Share.
 
 Logging
 '''''''
@@ -184,33 +151,15 @@ Airflow connection of type `azure_cosmos` exists. Authorization can be done by s
 login (=Endpoint uri), password (=secret key) and extra fields database_name and collection_name to specify the
 default database and collection to use (see connection `azure_cosmos_default` for an example).
 
-- :ref:`AzureCosmosDBHook`: Interface with Azure CosmosDB.
-- :ref:`AzureCosmosInsertDocumentOperator`: Simple operator to insert document into CosmosDB.
-- :ref:`AzureCosmosDocumentSensor`: Simple sensor to detect document existence in CosmosDB.
-
-.. _AzureCosmosDBHook:
-
-AzureCosmosDBHook
-"""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
-    :noindex:
+:class:`airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook`
+    Interface with Azure CosmosDB.
 
-.. _AzureCosmosInsertDocumentOperator:
+:class:`airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator`
+    Simple operator to insert document into CosmosDB.
 
-AzureCosmosInsertDocumentOperator
-"""""""""""""""""""""""""""""""""
+:class:`airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor`
+    Simple sensor to detect document existence in CosmosDB.
 
-.. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
-    :noindex:
-
-.. _AzureCosmosDocumentSensor:
-
-AzureCosmosDocumentSensor
-"""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor
-    :noindex:
 
 Azure Data Lake
 '''''''''''''''
@@ -220,81 +169,39 @@ Airflow connection of type `azure_data_lake` exists. Authorization can be done b
 login (=Client ID), password (=Client Secret) and extra fields tenant (Tenant) and account_name (Account Name)
 (see connection `azure_data_lake_default` for an example).
 
-- :ref:`AzureDataLakeHook`: Interface with Azure Data Lake.
-- :ref:`AzureDataLakeStorageListOperator`: Lists the files located in a specified Azure Data Lake path.
-- :ref:`AdlsToGoogleCloudStorageOperator`: Copies files from an Azure Data Lake path to a Google Cloud Storage bucket.
-
-.. _AzureDataLakeHook:
-
-AzureDataLakeHook
-"""""""""""""""""
+:class:`airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook`
+    Interface with Azure Data Lake.
 
-.. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
-    :noindex:
+:class:`airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator`
+    Lists the files located in a specified Azure Data Lake path.
 
-.. _AzureDataLakeStorageListOperator:
+:class:`airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator`
+    Copies files from an Azure Data Lake path to a Google Cloud Storage bucket.
 
-AzureDataLakeStorageListOperator
-""""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
-    :noindex:
-
-.. _AdlsToGoogleCloudStorageOperator:
-
-AdlsToGoogleCloudStorageOperator
-""""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
-    :noindex:
 
 Azure Container Instances
 '''''''''''''''''''''''''
 
 Azure Container Instances provides a method to run a docker container without having to worry
 about managing infrastructure. The AzureContainerInstanceHook requires a service principal. The
-credentials for this principal can either be defined in the extra field `key_path`, as an
-environment variable named `AZURE_AUTH_LOCATION`,
+credentials for this principal can either be defined in the extra field ``key_path``, as an
+environment variable named ``AZURE_AUTH_LOCATION``,
 or by providing a login/password and tenantId in extras.
 
 The AzureContainerRegistryHook requires a host/login/password to be defined in the connection.
 
-- :ref:`AzureContainerInstancesOperator` : Start/Monitor a new ACI.
-- :ref:`AzureContainerInstanceHook` : Wrapper around a single ACI.
-- :ref:`AzureContainerRegistryHook` : Wrapper around a ACR
-- :ref:`AzureContainerVolumeHook` : Wrapper around Container Volumes
-
-.. _AzureContainerInstancesOperator:
-
-AzureContainerInstancesOperator
-"""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.azure_container_instances_operator.AzureContainerInstancesOperator
-    :noindex:
-
-.. _AzureContainerInstanceHook:
-
-AzureContainerInstanceHook
-""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook
-    :noindex:
+:class:`airflow.contrib.hooks.azure_container_volume_hook.AzureContainerVolumeHook`
+    Interface with Azure Container Volumes
 
-.. _AzureContainerRegistryHook:
+:class:`airflow.contrib.operators.azure_container_instances_operator.AzureContainerInstancesOperator`
+    Start/Monitor a new ACI.
 
-AzureContainerRegistryHook
-""""""""""""""""""""""""""
+:class:`airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook`
+    Wrapper around a single ACI.
 
-.. autoclass:: airflow.contrib.hooks.azure_container_registry_hook.AzureContainerRegistryHook
-    :noindex:
+:class:`airflow.contrib.hooks.azure_container_registry_hook.AzureContainerRegistryHook`
+    Interface with ACR
 
-.. _AzureContainerVolumeHook:
-
-AzureContainerVolumeHook
-""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.azure_container_volume_hook.AzureContainerVolumeHook
-    :noindex:
 
 
 .. _AWS:
@@ -308,288 +215,115 @@ Operators are in the contrib section.
 AWS EMR
 '''''''
 
-- :ref:`EmrAddStepsOperator` : Adds steps to an existing EMR JobFlow.
-- :ref:`EmrCreateJobFlowOperator` : Creates an EMR JobFlow, reading the config from the EMR connection.
-- :ref:`EmrTerminateJobFlowOperator` : Terminates an EMR JobFlow.
-- :ref:`EmrHook` : Interact with AWS EMR.
-
-.. _EmrAddStepsOperator:
-
-EmrAddStepsOperator
-"""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.emr_add_steps_operator.EmrAddStepsOperator
-    :noindex:
-
-.. _EmrCreateJobFlowOperator:
-
-EmrCreateJobFlowOperator
-""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.emr_create_job_flow_operator.EmrCreateJobFlowOperator
-    :noindex:
-
-.. _EmrTerminateJobFlowOperator:
+:class:`airflow.contrib.hooks.emr_hook.EmrHook`
+    Interface with AWS EMR.
 
-EmrTerminateJobFlowOperator
-"""""""""""""""""""""""""""
+:class:`airflow.contrib.operators.emr_add_steps_operator.EmrAddStepsOperator`
+    Adds steps to an existing EMR JobFlow.
 
-.. autoclass:: airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator
-    :noindex:
+:class:`airflow.contrib.operators.emr_create_job_flow_operator.EmrCreateJobFlowOperator`
+    Creates an EMR JobFlow, reading the config from the EMR connection.
 
-.. _EmrHook:
-
-EmrHook
-"""""""
-
-.. autoclass:: airflow.contrib.hooks.emr_hook.EmrHook
-    :noindex:
+:class:`airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator`
+    Terminates an EMR JobFlow.
 
 
 AWS S3
 ''''''
 
-- :ref:`S3Hook` : Interact with AWS S3.
-- :ref:`S3FileTransformOperator` : Copies data from a source S3 location to a temporary location on the local filesystem.
-- :ref:`S3ListOperator` : Lists the files matching a key prefix from a S3 location.
-- :ref:`S3ToGoogleCloudStorageOperator` : Syncs an S3 location with a Google Cloud Storage bucket.
-- :ref:`S3ToGoogleCloudStorageTransferOperator` : Syncs an S3 bucket with a Google Cloud Storage bucket using the GCP Storage Transfer Service.
-- :ref:`S3ToHiveTransfer` : Moves data from S3 to Hive. The operator downloads a file from S3, stores the file locally before loading it into a Hive table.
-
-.. _S3Hook:
-
-S3Hook
-""""""
-
-.. autoclass:: airflow.hooks.S3_hook.S3Hook
-    :noindex:
-
-.. _S3FileTransformOperator:
-
-S3FileTransformOperator
-"""""""""""""""""""""""
-
-.. autoclass:: airflow.operators.s3_file_transform_operator.S3FileTransformOperator
-    :noindex:
-
-.. _S3ListOperator:
-
-S3ListOperator
-""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
-    :noindex:
-
-.. _S3ToGoogleCloudStorageOperator:
-
-S3ToGoogleCloudStorageOperator
-""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
-    :noindex:
-
-.. _S3ToGoogleCloudStorageTransferOperator:
-
-S3ToGoogleCloudStorageTransferOperator
-""""""""""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
-    :noindex:
-
-.. _S3ToHiveTransfer:
+:class:`airflow.hooks.S3_hook.S3Hook`
+    Interface with AWS S3.
 
-S3ToHiveTransfer
-""""""""""""""""
+:class:`airflow.operators.s3_file_transform_operator.S3FileTransformOperator`
+    Copies data from a source S3 location to a temporary location on the local filesystem.
 
-.. autoclass:: airflow.operators.s3_to_hive_operator.S3ToHiveTransfer
-    :noindex:
+:class:`airflow.contrib.operators.s3_list_operator.S3ListOperator`
+    Lists the files matching a key prefix from a S3 location.
 
+:class:`airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator`
+    Syncs an S3 location with a Google Cloud Storage bucket.
 
-AWS EC2 Container Service
-'''''''''''''''''''''''''
-
-- :ref:`ECSOperator` : Execute a task on AWS EC2 Container Service.
-
-.. _ECSOperator:
+:class:`airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator`
+    Syncs an S3 bucket with a Google Cloud Storage bucket using the GCP Storage Transfer Service.
 
-ECSOperator
-"""""""""""
-
-.. autoclass:: airflow.contrib.operators.ecs_operator.ECSOperator
-    :noindex:
+:class:`airflow.operators.s3_to_hive_operator.S3ToHiveTransfer`
+    Moves data from S3 to Hive. The operator downloads a file from S3, stores the file locally before loading it into a Hive table.
 
 
 AWS Batch Service
 '''''''''''''''''
 
-- :ref:`AWSBatchOperator` : Execute a task on AWS Batch Service.
-
-.. _AWSBatchOperator:
-
-AWSBatchOperator
-""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
-    :noindex:
+:class:`airflow.contrib.operators.awsbatch_operator.AWSBatchOperator`
+    Execute a task on AWS Batch Service.
 
 
 AWS RedShift
 ''''''''''''
 
-- :ref:`AwsRedshiftClusterSensor` : Waits for a Redshift cluster to reach a specific status.
-- :ref:`RedshiftHook` : Interact with AWS Redshift, using the boto3 library.
-- :ref:`RedshiftToS3Transfer` : Executes an unload command to S3 as CSV with or without headers.
-- :ref:`S3ToRedshiftTransfer` : Executes an copy command from S3 as CSV with or without headers.
+:class:`airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor`
+    Waits for a Redshift cluster to reach a specific status.
 
-.. _AwsRedshiftClusterSensor:
+:class:`airflow.contrib.hooks.redshift_hook.RedshiftHook`
+    Interact with AWS Redshift, using the boto3 library.
 
-AwsRedshiftClusterSensor
-""""""""""""""""""""""""
+:class:`airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer`
+    Executes an unload command to S3 as CSV with or without headers.
 
-.. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
-    :noindex:
+:class:`airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer`
+    Executes an copy command from S3 as CSV with or without headers.
 
-.. _RedshiftHook:
 
-RedshiftHook
-""""""""""""
 
-.. autoclass:: airflow.contrib.hooks.redshift_hook.RedshiftHook
-    :noindex:
+AWS DynamoDB
+''''''''''''
 
-.. _RedshiftToS3Transfer:
+:class:`airflow.contrib.operators.hive_to_dynamodb.HiveToDynamoDBTransferOperator`
+     Moves data from Hive to DynamoDB.
 
-RedshiftToS3Transfer
-""""""""""""""""""""
+:class:`airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook`
+    Interface with AWS DynamoDB.
 
-.. autoclass:: airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer
-    :noindex:
 
-.. _S3ToRedshiftTransfer:
+AWS Lambda
+''''''''''
 
-S3ToRedshiftTransfer
-""""""""""""""""""""
+:class:`airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook`
+    Interface with AWS Lambda.
 
-.. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
-    :noindex:
 
+AWS Kinesis
+'''''''''''
+
+:class:`airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook`
+    Interface with AWS Kinesis Firehose.
 
 Amazon SageMaker
 ''''''''''''''''
 
 .. _the SageMaker Python SDK README: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/workflow/README.rst
 
-- :ref:`SageMakerHook` : Interact with Amazon SageMaker.
-- :ref:`SageMakerTrainingOperator` : Create a SageMaker training job.
-- :ref:`SageMakerTuningOperator` : Create a SageMaker tuning job.
-- :ref:`SageMakerModelOperator` : Create a SageMaker model.
-- :ref:`SageMakerTransformOperator` : Create a SageMaker transform job.
-- :ref:`SageMakerEndpointConfigOperator` : Create a SageMaker endpoint config.
-- :ref:`SageMakerEndpointOperator` : Create a SageMaker endpoint.
-
-.. _SageMakerHook:
-
-SageMakerHook
-"""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
-    :noindex:
-
-.. _SageMakerTrainingOperator:
-
-SageMakerTrainingOperator
-"""""""""""""""""""""""""
+:class:`airflow.contrib.hooks.sagemaker_hook.SageMakerHook`
+    Interface with Amazon SageMaker.
 
-.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
-    :noindex:
+:class:`airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator`
+    Create a SageMaker training job.
 
-.. _SageMakerTuningOperator:
+:class:`airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator`
+    Create a SageMaker tuning job.
 
-SageMakerTuningOperator
-"""""""""""""""""""""""
+:class:`airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator`
+    Create a SageMaker model.
 
-.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
-    :noindex:
+:class:`airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator`
+    Create a SageMaker transform job.
 
-.. _SageMakerModelOperator:
+:class:`airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator`
+    Create a SageMaker endpoint config.
 
-SageMakerModelOperator
-""""""""""""""""""""""
+:class:`airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator`
+    Create a SageMaker endpoint.
 
-.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
-    :noindex:
 
-.. _SageMakerTransformOperator:
-
-SageMakerTransformOperator
-""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
-    :noindex:
-
-.. _SageMakerEndpointConfigOperator:
-
-SageMakerEndpointConfigOperator
-"""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
-    :noindex:
-
-.. _SageMakerEndpointOperator:
-
-SageMakerEndpointOperator
-"""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
-    :noindex:
-
-AWS DynamoDB
-''''''''''''
-
-- :ref:`HiveToDynamoDBTransferOperator` :  Moves data from Hive to DynamoDB.
-- :ref:`AwsDynamoDBHook` : Interact with AWS DynamoDB.
-
-.. _HiveToDynamoDBTransferOperator:
-
-HiveToDynamoDBTransferOperator
-""""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.operators.hive_to_dynamodb.HiveToDynamoDBTransferOperator
-   :noindex:
-
-.. _AwsDynamoDBHook:
-
-AwsDynamoDBHook
-"""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
-   :noindex:
-
-AWS Lambda
-''''''''''
-
-- :ref:`AwsLambdaHook` : Interact with AWS Lambda.
-
-.. _AwsLambdaHook:
-
-AwsLambdaHook
-"""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
-   :noindex:
-
-AWS Kinesis
-'''''''''''
-
-- :ref:`AwsFirehoseHook` : Interact with AWS Kinesis Firehose.
-
-.. _AwsFirehoseHook:
-
-AwsFirehoseHook
-"""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
-   :noindex:
 
 .. _Databricks:
 
@@ -600,11 +334,12 @@ Databricks
 submitting runs to the Databricks platform. Internally the operator talks to the
 ``api/2.0/jobs/runs/submit`` `endpoint <https://docs.databricks.com/api/latest/jobs.html#runs-submit>`_.
 
-DatabricksSubmitRunOperator
-'''''''''''''''''''''''''''
 
-.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
-    :noindex:
+:class:`airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator`
+    Submits a Spark job run to Databricks using the
+    `api/2.0/jobs/runs/submit
+    <https://docs.databricks.com/api/latest/jobs.html#runs-submit>`_
+    API endpoint.
 
 
 .. _GCP:
@@ -625,522 +360,197 @@ Logging
 Airflow can be configured to read and write task logs in Google Cloud Storage.
 See :ref:`write-logs-gcp`.
 
+
 GoogleCloudBaseHook
 '''''''''''''''''''
 
-.. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
-    :noindex:
+All hooks is based on :class:`airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`.
 
-.. _GoogleCloudBaseHook:
 
 BigQuery
 ''''''''
 
-BigQuery Operators
-""""""""""""""""""
-
-- :ref:`BigQueryCheckOperator` : Performs checks against a SQL query that will return a single row with different values.
-- :ref:`BigQueryValueCheckOperator` : Performs a simple value check using SQL code.
-- :ref:`BigQueryIntervalCheckOperator` : Checks that the values of metrics given as SQL expressions are within a certain tolerance of the ones from days_back before.
-- :ref:`BigQueryGetDataOperator` : Fetches the data from a BigQuery table and returns data in a python list
-- :ref:`BigQueryCreateEmptyDatasetOperator` : Creates an empty BigQuery dataset.
-- :ref:`BigQueryCreateEmptyTableOperator` : Creates a new, empty table in the specified BigQuery dataset optionally with schema.
-- :ref:`BigQueryCreateExternalTableOperator` : Creates a new, external table in the dataset with the data in Google Cloud Storage.
-- :ref:`BigQueryDeleteDatasetOperator` : Deletes an existing BigQuery dataset.
-- :ref:`BigQueryTableDeleteOperator` : Deletes an existing BigQuery table.
-- :ref:`BigQueryOperator` : Executes BigQuery SQL queries in a specific BigQuery database.
-- :ref:`BigQueryToBigQueryOperator` : Copy a BigQuery table to another BigQuery table.
-- :ref:`BigQueryToCloudStorageOperator` : Transfers a BigQuery table to a Google Cloud Storage bucket
-
-
-.. _BigQueryCheckOperator:
-
-BigQueryCheckOperator
-^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator`
+    Performs checks against a SQL query that will return a single row with different values.
 
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
-    :noindex:
+:class:`airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator`
+    Checks that the values of metrics given as SQL expressions are within a certain tolerance of the ones from days_back before.
 
-.. _BigQueryValueCheckOperator:
+:class:`airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator`
+    Performs a simple value check using SQL code.
 
-BigQueryValueCheckOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator`
+    Fetches the data from a BigQuery table and returns data in a python list
 
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
-    :noindex:
+:class:`airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator`
+    Creates an empty BigQuery dataset.
 
-.. _BigQueryIntervalCheckOperator:
+:class:`airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator`
+    Creates a new, empty table in the specified BigQuery dataset optionally with schema.
 
-BigQueryIntervalCheckOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator`
+    Creates a new, external table in the dataset with the data in Google Cloud Storage.
 
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
-    :noindex:
+:class:`airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator`
+    Deletes an existing BigQuery dataset.
 
-.. _BigQueryGetDataOperator:
+:class:`airflow.contrib.operators.bigquery_operator.BigQueryOperator`
+    Executes BigQuery SQL queries in a specific BigQuery database.
 
-BigQueryGetDataOperator
-^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator`
+    Deletes an existing BigQuery table.
 
-.. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
-    :noindex:
+:class:`airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator`
+    Copy a BigQuery table to another BigQuery table.
 
-.. _BigQueryCreateEmptyTableOperator:
+:class:`airflow.contrib.operators.bigquery_to_gcs.BigQueryToCloudStorageOperator`
+    Transfers a BigQuery table to a Google Cloud Storage bucket
 
-BigQueryCreateEmptyTableOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
-    :noindex:
+They also use :class:`airflow.contrib.hooks.bigquery_hook.BigQueryHook` to communicate with Google Cloud Platform.
 
-.. _BigQueryCreateExternalTableOperator:
-
-BigQueryCreateExternalTableOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
-    :noindex:
-
-.. _BigQueryCreateEmptyDatasetOperator:
-
-BigQueryCreateEmptyDatasetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
-    :noindex:
-
-.. _BigQueryDeleteDatasetOperator:
-
-BigQueryDeleteDatasetOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
-    :noindex:
-
-.. _BigQueryTableDeleteOperator:
-
-BigQueryTableDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
-    :noindex:
-
-.. _BigQueryOperator:
-
-BigQueryOperator
-^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
-    :noindex:
-
-.. _BigQueryToBigQueryOperator:
-
-BigQueryToBigQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
-    :noindex:
-
-.. _BigQueryToCloudStorageOperator:
-
-BigQueryToCloudStorageOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.bigquery_to_gcs.BigQueryToCloudStorageOperator
-    :noindex:
-
-
-BigQueryHook
-""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
-    :members:
-    :noindex:
 
 Cloud Spanner
 '''''''''''''
 
-Cloud Spanner Operators
-"""""""""""""""""""""""
-
-- :ref:`CloudSpannerInstanceDatabaseDeleteOperator` : deletes an existing database from
-  a Google Cloud Spanner instance or returns success if the database is missing.
-- :ref:`CloudSpannerInstanceDatabaseDeployOperator` : creates a new database in a Google
-  Cloud instance or returns success if the database already exists.
-- :ref:`CloudSpannerInstanceDatabaseUpdateOperator` : updates the structure of a
-  Google Cloud Spanner database.
-- :ref:`CloudSpannerInstanceDatabaseQueryOperator` : executes an arbitrary DML query
-  (INSERT, UPDATE, DELETE).
-- :ref:`CloudSpannerInstanceDeployOperator` : creates a new Google Cloud Spanner instance,
-  or if an instance with the same name exists, updates the instance.
-- :ref:`CloudSpannerInstanceDeleteOperator` : deletes a Google Cloud Spanner instance.
-
-.. _CloudSpannerInstanceDatabaseDeleteOperator:
-
-CloudSpannerInstanceDatabaseDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
-    :noindex:
-
-.. _CloudSpannerInstanceDatabaseDeployOperator:
-
-CloudSpannerInstanceDatabaseDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
-    :noindex:
-
-.. _CloudSpannerInstanceDatabaseUpdateOperator:
-
-CloudSpannerInstanceDatabaseUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
-    :noindex:
-
-.. _CloudSpannerInstanceDatabaseQueryOperator:
-
-CloudSpannerInstanceDatabaseQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
-    :noindex:
-
-.. _CloudSpannerInstanceDeployOperator:
-
-CloudSpannerInstanceDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator`
+    deletes an existing database from a Google Cloud Spanner instance or returns success if the database is missing.
 
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator`
+    creates a new database in a Google Cloud instance or returns success if the database already exists.
 
-.. _CloudSpannerInstanceDeleteOperator:
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator`
+    executes an arbitrary DML query (INSERT, UPDATE, DELETE).
 
-CloudSpannerInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator`
+    updates the structure of a Google Cloud Spanner database.
 
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator`
+    deletes a Google Cloud Spanner instance.
 
+:class:`airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator`
+    creates a new Google Cloud Spanner instance, or if an instance with the same name exists, updates the instance.
 
-CloudSpannerHook
-""""""""""""""""
 
-.. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
-    :members:
-    :noindex:
+They also use :class:`airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook` to communicate with Google Cloud Platform.
 
 
 Cloud SQL
 '''''''''
 
-Cloud SQL Operators
-"""""""""""""""""""
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator`
+    create a new Cloud SQL instance.
 
-- :ref:`CloudSqlInstanceDatabaseDeleteOperator` : deletes a database from a Cloud SQL
-  instance.
-- :ref:`CloudSqlInstanceDatabaseCreateOperator` : creates a new database inside a Cloud
-  SQL instance.
-- :ref:`CloudSqlInstanceDatabasePatchOperator` : updates a database inside a Cloud
-  SQL instance.
-- :ref:`CloudSqlInstanceDeleteOperator` : delete a Cloud SQL instance.
-- :ref:`CloudSqlInstanceExportOperator` : exports data from a Cloud SQL instance.
-- :ref:`CloudSqlInstanceImportOperator` : imports data into a Cloud SQL instance.
-- :ref:`CloudSqlInstanceCreateOperator` : create a new Cloud SQL instance.
-- :ref:`CloudSqlInstancePatchOperator` : patch a Cloud SQL instance.
-- :ref:`CloudSqlQueryOperator` : run query in a Cloud SQL instance.
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator`
+    creates a new database inside a Cloud SQL instance.
 
-.. _CloudSqlInstanceDatabaseDeleteOperator:
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator`
+    deletes a database from a Cloud SQL instance.
 
-CloudSqlInstanceDatabaseDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator`
+    updates a database inside a Cloud SQL instance.
 
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator`
+    delete a Cloud SQL instance.
 
-.. _CloudSqlInstanceDatabaseCreateOperator:
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator`
+    exports data from a Cloud SQL instance.
 
-CloudSqlInstanceDatabaseCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator`
+    imports data into a Cloud SQL instance.
 
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator`
+    patch a Cloud SQL instance.
 
-.. _CloudSqlInstanceDatabasePatchOperator:
+:class:`airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator`
+    run query in a Cloud SQL instance.
 
-CloudSqlInstanceDatabasePatchOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
-    :noindex:
-
-.. _CloudSqlInstanceDeleteOperator:
-
-CloudSqlInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
-    :noindex:
-
-.. _CloudSqlInstanceExportOperator:
-
-CloudSqlInstanceExportOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
-    :noindex:
-
-.. _CloudSqlInstanceImportOperator:
-
-CloudSqlInstanceImportOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
-    :noindex:
-
-.. _CloudSqlInstanceCreateOperator:
-
-CloudSqlInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
-    :noindex:
-
-.. _CloudSqlInstancePatchOperator:
-
-CloudSqlInstancePatchOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
-    :noindex:
-
-.. _CloudSqlQueryOperator:
-
-CloudSqlQueryOperator
-^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
-    :noindex:
-
-Cloud SQL Hooks
-"""""""""""""""
-
-.. _CloudSqlHook:
-
-.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
-    :members:
-    :noindex:
-
-.. _CloudSqlDatabaseHook:
-
-.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
-    :members:
-    :noindex:
-
-.. _CloudSqlProxyRunner:
-
-.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlProxyRunner
-    :members:
-    :noindex:
+They also use :class:`airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook` and :class:`airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook` to communicate with Google Cloud Platform.
 
 
 Cloud Bigtable
 ''''''''''''''
 
-Cloud Bigtable Operators
-""""""""""""""""""""""""
-
-- :ref:`BigtableInstanceCreateOperator` : creates a Cloud Bigtable instance.
-- :ref:`BigtableInstanceDeleteOperator` : deletes a Google Cloud Bigtable instance.
-- :ref:`BigtableClusterUpdateOperator` : updates the number of nodes in a Google Cloud Bigtable cluster.
-- :ref:`BigtableTableCreateOperator` : creates a table in a Google Cloud Bigtable instance.
-- :ref:`BigtableTableDeleteOperator` : deletes a table in a Google Cloud Bigtable instance.
-- :ref:`BigtableTableWaitForReplicationSensor` : (sensor) waits for a table to be fully replicated.
-
-.. _BigtableInstanceCreateOperator:
-
-BigtableInstanceCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
-    :noindex:
-
-.. _BigtableInstanceDeleteOperator:
-
-BigtableInstanceDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
-    :noindex:
-
-.. _BigtableClusterUpdateOperator:
-
-BigtableClusterUpdateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
-    :noindex:
-
-.. _BigtableTableCreateOperator:
-
-BigtableTableCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator`
+    updates the number of nodes in a Google Cloud Bigtable cluster.
 
-.. _BigtableTableDeleteOperator:
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator`
+    creates a Cloud Bigtable instance.
 
-BigtableTableDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator`
+    deletes a Google Cloud Bigtable instance.
 
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator`
+    creates a table in a Google Cloud Bigtable instance.
 
-.. _BigtableTableWaitForReplicationSensor:
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator`
+    deletes a table in a Google Cloud Bigtable instance.
 
-BigtableTableWaitForReplicationSensor
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor`
+    (sensor) waits for a table to be fully replicated.
 
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor
-    :noindex:
 
-.. _BigtableHook:
+They also use :class:`airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook` to communicate with Google Cloud Platform.
 
-Cloud Bigtable Hook
-""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook
-    :members:
-    :noindex:
 
 Compute Engine
 ''''''''''''''
 
-Compute Engine Operators
-""""""""""""""""""""""""
-
-- :ref:`GceInstanceStartOperator` : start an existing Google Compute Engine instance.
-- :ref:`GceInstanceStopOperator` : stop an existing Google Compute Engine instance.
-- :ref:`GceSetMachineTypeOperator` : change the machine type for a stopped instance.
-- :ref:`GceInstanceTemplateCopyOperator` : copy the Instance Template, applying
-  specified changes.
-- :ref:`GceInstanceGroupManagerUpdateTemplateOperator` : patch the Instance Group Manager,
-  replacing source Instance Template URL with the destination one.
-
-The operators have the common base operator:
-
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
-    :noindex:
-
-They also use :ref:`GceHook` to communicate with Google Cloud Platform.
-
-.. _GceInstanceStartOperator:
-
-GceInstanceStartOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
-    :noindex:
-
-.. _GceInstanceStopOperator:
-
-GceInstanceStopOperator
-^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator`
+    start an existing Google Compute Engine instance.
 
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator`
+    stop an existing Google Compute Engine instance.
 
-.. _GceSetMachineTypeOperator:
+:class:`airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator`
+    change the machine type for a stopped instance.
 
-GceSetMachineTypeOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator`
+    copy the Instance Template, applying specified changes.
 
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`
+    patch the Instance Group Manager, replacing source Instance Template URL with the destination one.
 
-.. _GceInstanceTemplateCopyOperator:
 
-GceInstanceTemplateCopyOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The operators have the common base operator :class:`airflow.contrib.operators.gcp_compute_operator.GceBaseOperator`
 
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
-    :noindex:
-
-.. _GceInstanceGroupManagerUpdateTemplateOperator:
-
-GceInstanceGroupManagerUpdateTemplateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
-    :noindex:
-
-.. _GceHook:
-
-Compute Engine Hook
-"""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.gcp_compute_hook.GceHook
-    :members:
-    :noindex:
+They also use :class:`airflow.contrib.hooks.gcp_compute_hook.GceHook` to communicate with Google Cloud Platform.
 
 
 Cloud Functions
 '''''''''''''''
 
-Cloud Functions Operators
-"""""""""""""""""""""""""
-
-- :ref:`GcfFunctionDeployOperator` : deploy Google Cloud Function to Google Cloud Platform
-- :ref:`GcfFunctionDeleteOperator` : delete Google Cloud Function in Google Cloud Platform
-
-They also use :ref:`GcfHook` to communicate with Google Cloud Platform.
-
-.. _GcfFunctionDeployOperator:
+:class:`airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator`
+    deploy Google Cloud Function to Google Cloud Platform
 
-GcfFunctionDeployOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator`
+    delete Google Cloud Function in Google Cloud Platform
 
-.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
-    :noindex:
 
-.. _GcfFunctionDeleteOperator:
+They also use :class:`airflow.contrib.hooks.gcp_function_hook.GcfHook` to communicate with Google Cloud Platform.
 
-GcfFunctionDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
-    :noindex:
-
-.. _GcfHook:
-
-Cloud Functions Hook
-""""""""""""""""""""
+Cloud DataFlow
+''''''''''''''
 
-.. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
-    :members:
-    :noindex:
+:class:`airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator`
+    launching Cloud Dataflow jobs written in Java.
 
+:class:`airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator`
+    launching a templated Cloud DataFlow batch job.
 
-Cloud DataFlow
-''''''''''''''
+:class:`airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator`
+    launching Cloud Dataflow jobs written in python.
 
-DataFlow Operators
-""""""""""""""""""
 
-- :ref:`DataFlowJavaOperator` : launching Cloud Dataflow jobs written in Java.
-- :ref:`DataflowTemplateOperator` : launching a templated Cloud DataFlow batch job.
-- :ref:`DataFlowPythonOperator` : launching Cloud Dataflow jobs written in python.
+They also use :class:`airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook` to communicate with Google Cloud Platform.
 
 .. _DataFlowJavaOperator:
 
 DataFlowJavaOperator
 ^^^^^^^^^^^^^^^^^^^^
 
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
-    :noindex:
-
 .. code:: python
 
     default_args = {
@@ -1175,341 +585,119 @@ DataFlowJavaOperator
         },
         dag=dag)
 
-.. _DataflowTemplateOperator:
-
-DataflowTemplateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
-    :noindex:
-
-.. _DataFlowPythonOperator:
-
-DataFlowPythonOperator
-^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
-    :noindex:
-
-
-DataFlowHook
-""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
-    :members:
-    :noindex:
-
-
 
 Cloud DataProc
 ''''''''''''''
 
-DataProc Operators
-""""""""""""""""""
-
-- :ref:`DataprocClusterCreateOperator` : Create a new cluster on Google Cloud Dataproc.
-- :ref:`DataprocClusterDeleteOperator` : Delete a cluster on Google Cloud Dataproc.
-- :ref:`DataprocClusterScaleOperator` : Scale up or down a cluster on Google Cloud Dataproc.
-- :ref:`DataProcPigOperator` : Start a Pig query Job on a Cloud DataProc cluster.
-- :ref:`DataProcHiveOperator` : Start a Hive query Job on a Cloud DataProc cluster.
-- :ref:`DataProcSparkSqlOperator` : Start a Spark SQL query Job on a Cloud DataProc cluster.
-- :ref:`DataProcSparkOperator` : Start a Spark Job on a Cloud DataProc cluster.
-- :ref:`DataProcHadoopOperator` : Start a Hadoop Job on a Cloud DataProc cluster.
-- :ref:`DataProcPySparkOperator` : Start a PySpark Job on a Cloud DataProc cluster.
-- :ref:`DataprocWorkflowTemplateInstantiateOperator` : Instantiate a WorkflowTemplate on Google Cloud Dataproc.
-- :ref:`DataprocWorkflowTemplateInstantiateInlineOperator` : Instantiate a WorkflowTemplate Inline on Google Cloud Dataproc.
-
-.. _DataprocClusterCreateOperator:
+:class:`airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator`
+    Create a new cluster on Google Cloud Dataproc.
 
-DataprocClusterCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator`
+    Delete a cluster on Google Cloud Dataproc.
 
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
-    :noindex:
+:class:`airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator`
+    Scale up or down a cluster on Google Cloud Dataproc.
 
-.. _DataprocClusterScaleOperator:
+:class:`airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator`
+    Start a Hadoop Job on a Cloud DataProc cluster.
 
-DataprocClusterScaleOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.dataproc_operator.DataProcHiveOperator`
+    Start a Hive query Job on a Cloud DataProc cluster.
 
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
-    :noindex:
+:class:`airflow.contrib.operators.dataproc_operator.DataProcPigOperator`
+    Start a Pig query Job on a Cloud DataProc cluster.
 
-.. _DataprocClusterDeleteOperator:
+:class:`airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator`
+    Start a PySpark Job on a Cloud DataProc cluster.
 
-DataprocClusterDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.dataproc_operator.DataProcSparkOperator`
+    Start a Spark Job on a Cloud DataProc cluster.
 
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
-    :noindex:
+:class:`airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator`
+    Start a Spark SQL query Job on a Cloud DataProc cluster.
 
-.. _DataProcPigOperator:
+:class:`airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator`
+    Instantiate a WorkflowTemplate Inline on Google Cloud Dataproc.
 
-DataProcPigOperator
-^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator`
+    Instantiate a WorkflowTemplate on Google Cloud Dataproc.
 
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
-    :noindex:
-
-.. _DataProcHiveOperator:
-
-DataProcHiveOperator
-^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
-    :noindex:
-
-.. _DataProcSparkSqlOperator:
-
-DataProcSparkSqlOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
-    :noindex:
-
-.. _DataProcSparkOperator:
-
-DataProcSparkOperator
-^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
-    :noindex:
-
-.. _DataProcHadoopOperator:
-
-DataProcHadoopOperator
-^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
-    :noindex:
-
-.. _DataProcPySparkOperator:
-
-DataProcPySparkOperator
-^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator
-    :noindex:
-
-.. _DataprocWorkflowTemplateInstantiateOperator:
-
-DataprocWorkflowTemplateInstantiateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
-    :noindex:
-
-.. _DataprocWorkflowTemplateInstantiateInlineOperator:
-
-DataprocWorkflowTemplateInstantiateInlineOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator
-    :noindex:
 
 Cloud Datastore
 '''''''''''''''
 
-Datastore Operators
-"""""""""""""""""""
-
-- :ref:`DatastoreExportOperator` : Export entities from Google Cloud Datastore to Cloud Storage.
-- :ref:`DatastoreImportOperator` : Import entities from Cloud Storage to Google Cloud Datastore.
-
-.. _DatastoreExportOperator:
+:class:`airflow.contrib.operators.datastore_export_operator.DatastoreExportOperator`
+    Export entities from Google Cloud Datastore to Cloud Storage.
 
-DatastoreExportOperator
-^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.datastore_import_operator.DatastoreImportOperator`
+    Import entities from Cloud Storage to Google Cloud Datastore.
 
-.. autoclass:: airflow.contrib.operators.datastore_export_operator.DatastoreExportOperator
-    :noindex:
 
-.. _DatastoreImportOperator:
-
-DatastoreImportOperator
-^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.datastore_import_operator.DatastoreImportOperator
-    :noindex:
-
-DatastoreHook
-"""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.datastore_hook.DatastoreHook
-    :members:
-    :noindex:
+They also use :class:`airflow.contrib.hooks.datastore_hook.DatastoreHook` to communicate with Google Cloud Platform.
 
 
 Cloud ML Engine
 '''''''''''''''
 
-Cloud ML Engine Operators
-"""""""""""""""""""""""""
-
-- :ref:`MLEngineBatchPredictionOperator` : Start a Cloud ML Engine batch prediction job.
-- :ref:`MLEngineModelOperator` : Manages a Cloud ML Engine model.
-- :ref:`MLEngineTrainingOperator` : Start a Cloud ML Engine training job.
-- :ref:`MLEngineVersionOperator` : Manages a Cloud ML Engine model version.
-
-.. _MLEngineBatchPredictionOperator:
-
-MLEngineBatchPredictionOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineBatchPredictionOperator
-    :members:
-    :noindex:
-
-.. _MLEngineModelOperator:
-
-MLEngineModelOperator
-^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineModelOperator
-    :members:
-    :noindex:
-
-.. _MLEngineTrainingOperator:
-
-MLEngineTrainingOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator
-    :members:
-    :noindex:
+:class:`airflow.contrib.operators.mlengine_operator.MLEngineBatchPredictionOperator`
+    Start a Cloud ML Engine batch prediction job.
 
-.. _MLEngineVersionOperator:
+:class:`airflow.contrib.operators.mlengine_operator.MLEngineModelOperator`
+    Manages a Cloud ML Engine model.
 
-MLEngineVersionOperator
-^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator`
+    Start a Cloud ML Engine training job.
 
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator
-    :members:
-    :noindex:
+:class:`airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator`
+    Manages a Cloud ML Engine model version.
 
-Cloud ML Engine Hook
-""""""""""""""""""""
 
-.. _MLEngineHook:
-
-MLEngineHook
-^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
-    :members:
-    :noindex:
+They also use :class:`airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook` to communicate with Google Cloud Platform.
 
 
 Cloud Storage
 '''''''''''''
 
-Storage Operators
-"""""""""""""""""
-
-- :ref:`FileToGoogleCloudStorageOperator` : Uploads a file to Google Cloud Storage.
-- :ref:`GoogleCloudStorageBucketCreateAclEntryOperator` : Creates a new ACL entry on the specified bucket.
-- :ref:`GoogleCloudStorageCreateBucketOperator` : Creates a new cloud storage bucket.
-- :ref:`GoogleCloudStorageDownloadOperator` : Downloads a file from Google Cloud Storage.
-- :ref:`GoogleCloudStorageListOperator` : List all objects from the bucket with the give string prefix and delimiter in name.
-- :ref:`GoogleCloudStorageObjectCreateAclEntryOperator` : Creates a new ACL entry on the specified object.
-- :ref:`GoogleCloudStorageToBigQueryOperator` : Loads files from Google cloud storage into BigQuery.
-- :ref:`GoogleCloudStorageToGoogleCloudStorageOperator` : Copies objects from a bucket to another, with renaming if requested.
-- :ref:`GoogleCloudStorageToGoogleCloudStorageTransferOperator` : Copies objects from a bucket to another using Google Transfer service.
-- :ref:`MySqlToGoogleCloudStorageOperator`: Copy data from any MySQL Database to Google cloud storage in JSON format.
-
-.. _FileToGoogleCloudStorageOperator:
-
-FileToGoogleCloudStorageOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator
-    :noindex:
-
-.. _GoogleCloudStorageCreateBucketOperator:
-
-GoogleCloudStorageBucketCreateAclEntryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
-    :noindex:
-
-.. _GoogleCloudStorageBucketCreateAclEntryOperator:
-
-GoogleCloudStorageCreateBucketOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
-    :noindex:
-
-.. _GoogleCloudStorageDownloadOperator:
-
-GoogleCloudStorageDownloadOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
-    :noindex:
-
-.. _GoogleCloudStorageListOperator:
-
-GoogleCloudStorageListOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
-    :noindex:
-
-.. _GoogleCloudStorageToBigQueryOperator:
+:class:`airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator`
+    Uploads a file to Google Cloud Storage.
 
-GoogleCloudStorageObjectCreateAclEntryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`
+    Creates a new ACL entry on the specified bucket.
 
-.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`
+    Creates a new ACL entry on the specified object.
 
-.. _GoogleCloudStorageObjectCreateAclEntryOperator:
+:class:`airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator`
+    Downloads a file from Google Cloud Storage.
 
-GoogleCloudStorageToBigQueryOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator`
+    List all objects from the bucket with the give string prefix and delimiter in name.
 
-.. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator`
+    Creates a new cloud storage bucket.
 
-.. _GoogleCloudStorageToGoogleCloudStorageOperator:
+:class:`airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator`
+    Loads files from Google cloud storage into BigQuery.
 
-GoogleCloudStorageToGoogleCloudStorageOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator`
+    Copies objects from a bucket to another, with renaming if requested.
 
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
-    :noindex:
+:class:`airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator`
+    Copy data from any MySQL Database to Google cloud storage in JSON format.
 
-.. _GoogleCloudStorageToGoogleCloudStorageTransferOperator:
 
-GoogleCloudStorageToGoogleCloudStorageTransferOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+They also use :class:`airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook` to communicate with Google Cloud Platform.
 
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
-    :noindex:
 
-.. _MySqlToGoogleCloudStorageOperator:
-
-MySqlToGoogleCloudStorageOperator
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
-    :noindex:
+Transfer Service
+''''''''''''''''
 
-GoogleCloudStorageHook
-""""""""""""""""""""""
+:class:`airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator`
+    Copies objects from a bucket to another using Google Transfer service.
 
-.. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
-    :members:
-    :noindex:
 
-GCPTransferServiceHook
-""""""""""""""""""""""
+They also use :class:`airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook` to communicate with Google Cloud Platform.
 
-.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
-    :members:
-    :noindex:
 
 Cloud Vision
 ''''''''''''
@@ -1557,42 +745,17 @@ Cloud Translate Text Operators
 Google Kubernetes Engine
 ''''''''''''''''''''''''
 
-Google Kubernetes Engine Cluster Operators
-""""""""""""""""""""""""""""""""""""""""""
-
-- :ref:`GKEClusterCreateOperator` : Creates a Kubernetes Cluster in Google Cloud Platform
-- :ref:`GKEClusterDeleteOperator` : Deletes a Kubernetes Cluster in Google Cloud Platform
-
-GKEClusterCreateOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
-    :noindex:
-
-.. _GKEClusterCreateOperator:
-
-GKEClusterDeleteOperator
-^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
-    :noindex:
-
-.. _GKEClusterDeleteOperator:
+:class:`airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator`
+    Creates a Kubernetes Cluster in Google Cloud Platform
 
-GKEPodOperator
-^^^^^^^^^^^^^^
+:class:`airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator`
+    Deletes a Kubernetes Cluster in Google Cloud Platform
 
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
-    :noindex:
+:class:`airflow.contrib.operators.gcp_container_operator.GKEPodOperator`
+    Executes a task in a Kubernetes pod in the specified Google Kubernetes Engine cluster
 
-.. _GKEPodOperator:
+They also use :class:`airflow.contrib.hooks.gcp_container_hook.GKEClusterHook` to communicate with Google Cloud Platform.
 
-Google Kubernetes Engine Hook
-"""""""""""""""""""""""""""""
-
-.. autoclass:: airflow.contrib.hooks.gcp_container_hook.GKEClusterHook
-    :members:
-    :noindex:
 
 .. _Qubole:
 
@@ -1602,32 +765,23 @@ Qubole
 Apache Airflow has a native operator and hooks to talk to `Qubole <https://qubole.com/>`__,
 which lets you submit your big data jobs directly to Qubole from Apache Airflow.
 
-QuboleOperator
-''''''''''''''
-
-.. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
-    :noindex:
 
-QubolePartitionSensor
-'''''''''''''''''''''
+:class:`airflow.contrib.operators.qubole_operator.QuboleOperator`
+    Execute tasks (commands) on QDS (https://qubole.com).
 
-.. autoclass:: airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor
-    :noindex:
-
-QuboleFileSensor
-''''''''''''''''
+:class:`airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor`
+    Wait for a Hive partition to show up in QHS (Qubole Hive Service)
+    and check for its presence via QDS APIs
 
-.. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor
-    :noindex:
+:class:`airflow.contrib.sensors.qubole_sensor.QuboleFileSensor`
+    Wait for a file or folder to be present in cloud storage
+    and check for its presence via QDS APIs
 
-QuboleCheckOperator
-'''''''''''''''''''
-
-.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
-    :noindex:
-
-QuboleValueCheckOperator
-''''''''''''''''''''''''
+:class:`airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator`
+    Performs checks against Qubole Commands. ``QuboleCheckOperator`` expects
+    a command that will be executed on QDS.
 
-.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
-    :noindex:
+:class:`airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator`
+    Performs a simple value check using Qubole command.
+    By default, each value on the first row of this
+    Qubole command is compared with a pre-defined value

From 92ee6d5641beb5b18a5134241501004ac2926b96 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 6 Feb 2019 19:45:46 +0100
Subject: [PATCH 719/808] [AIRFLOW-XXX] Extract reverse proxy info to a
 separate file (#4657)

---
 docs/howto/index.rst            |  1 +
 docs/howto/run-behind-proxy.rst | 82 +++++++++++++++++++++++++++++++++
 docs/integration.rst            | 69 ---------------------------
 3 files changed, 83 insertions(+), 69 deletions(-)
 create mode 100644 docs/howto/run-behind-proxy.rst

diff --git a/docs/howto/index.rst b/docs/howto/index.rst
index f4ac5a163af00..51746bde9af6e 100644
--- a/docs/howto/index.rst
+++ b/docs/howto/index.rst
@@ -36,6 +36,7 @@ configuring an Airflow environment.
     executor/use-celery
     executor/use-dask
     executor/use-mesos
+    run-behind-proxy
     run-with-systemd
     run-with-upstart
     use-test-config
diff --git a/docs/howto/run-behind-proxy.rst b/docs/howto/run-behind-proxy.rst
new file mode 100644
index 0000000000000..5db4ab0bf155e
--- /dev/null
+++ b/docs/howto/run-behind-proxy.rst
@@ -0,0 +1,82 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Running Airflow behind a reverse proxy
+======================================
+
+Airflow can be set up behind a reverse proxy, with the ability to set its endpoint with great
+flexibility.
+
+For example, you can configure your reverse proxy to get:
+
+::
+
+    https://lab.mycompany.com/myorg/airflow/
+
+To do so, you need to set the following setting in your `airflow.cfg`::
+
+    base_url = http://my_host/myorg/airflow
+
+Additionally if you use Celery Executor, you can get Flower in `/myorg/flower` with::
+
+    flower_url_prefix = /myorg/flower
+
+Your reverse proxy (ex: nginx) should be configured as follow:
+
+- pass the url and http header as it for the Airflow webserver, without any rewrite, for example::
+
+      server {
+        listen 80;
+        server_name lab.mycompany.com;
+
+        location /myorg/airflow/ {
+            proxy_pass http://localhost:8080;
+            proxy_set_header Host $host;
+            proxy_redirect off;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+        }
+      }
+
+- rewrite the url for the flower endpoint::
+
+      server {
+          listen 80;
+          server_name lab.mycompany.com;
+
+          location /myorg/flower/ {
+              rewrite ^/myorg/flower/(.*)$ /$1 break;  # remove prefix from http header
+              proxy_pass http://localhost:5555;
+              proxy_set_header Host $host;
+              proxy_redirect off;
+              proxy_http_version 1.1;
+              proxy_set_header Upgrade $http_upgrade;
+              proxy_set_header Connection "upgrade";
+          }
+      }
+
+To ensure that Airflow generates URLs with the correct scheme when
+running behind a TLS-terminating proxy, you should configure the proxy
+to set the `X-Forwarded-Proto` header, and enable the `ProxyFix`
+middleware in your `airflow.cfg`::
+
+    enable_proxy_fix = True
+
+.. note::
+    You should only enable the `ProxyFix` middleware when running
+    Airflow behind a trusted proxy (AWS ELB, nginx, etc.).
diff --git a/docs/integration.rst b/docs/integration.rst
index a48e38793e86d..cad741f8d853f 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -18,81 +18,12 @@
 Integration
 ===========
 
-- :ref:`ReverseProxy`
 - :ref:`Azure`
 - :ref:`AWS`
 - :ref:`Databricks`
 - :ref:`GCP`
 - :ref:`Qubole`
 
-.. _ReverseProxy:
-
-Reverse Proxy
--------------
-
-Airflow can be set up behind a reverse proxy, with the ability to set its endpoint with great
-flexibility.
-
-For example, you can configure your reverse proxy to get:
-
-::
-
-    https://lab.mycompany.com/myorg/airflow/
-
-To do so, you need to set the following setting in your `airflow.cfg`::
-
-    base_url = http://my_host/myorg/airflow
-
-Additionally if you use Celery Executor, you can get Flower in `/myorg/flower` with::
-
-    flower_url_prefix = /myorg/flower
-
-Your reverse proxy (ex: nginx) should be configured as follow:
-
-- pass the url and http header as it for the Airflow webserver, without any rewrite, for example::
-
-      server {
-        listen 80;
-        server_name lab.mycompany.com;
-
-        location /myorg/airflow/ {
-            proxy_pass http://localhost:8080;
-            proxy_set_header Host $host;
-            proxy_redirect off;
-            proxy_http_version 1.1;
-            proxy_set_header Upgrade $http_upgrade;
-            proxy_set_header Connection "upgrade";
-        }
-      }
-
-- rewrite the url for the flower endpoint::
-
-      server {
-          listen 80;
-          server_name lab.mycompany.com;
-
-          location /myorg/flower/ {
-              rewrite ^/myorg/flower/(.*)$ /$1 break;  # remove prefix from http header
-              proxy_pass http://localhost:5555;
-              proxy_set_header Host $host;
-              proxy_redirect off;
-              proxy_http_version 1.1;
-              proxy_set_header Upgrade $http_upgrade;
-              proxy_set_header Connection "upgrade";
-          }
-      }
-
-To ensure that Airflow generates URLs with the correct scheme when
-running behind a TLS-terminating proxy, you should configure the proxy
-to set the `X-Forwarded-Proto` header, and enable the `ProxyFix`
-middleware in your `airflow.cfg`::
-
-    enable_proxy_fix = True
-
-.. note:: 
-    You should only enable the `ProxyFix` middleware when running
-    Airflow behind a trusted proxy (AWS ELB, nginx, etc.).
-
 .. _Azure:
 
 Azure: Microsoft Azure

From 899b63411623cddfa05a1f1823be9d91ae2a08e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 8 Feb 2019 18:32:11 +0100
Subject: [PATCH 720/808] [AIRFLOW-XXX] Move out the examples from
 integration.rst (#4672)

---
 .../contrib/operators/dataflow_operator.py    | 34 ++++++++++++++++
 docs/integration.rst                          | 39 -------------------
 2 files changed, 34 insertions(+), 39 deletions(-)

diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index c67ab69275d98..babadac70602a 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -33,6 +33,40 @@ class DataFlowJavaOperator(BaseOperator):
     Start a Java Cloud DataFlow batch job. The parameters of the operation
     will be passed to the job.
 
+    **Example**: ::
+
+        default_args = {
+            'owner': 'airflow',
+            'depends_on_past': False,
+            'start_date':
+                (2016, 8, 1),
+            'email': ['alex@vanboxel.be'],
+            'email_on_failure': False,
+            'email_on_retry': False,
+            'retries': 1,
+            'retry_delay': timedelta(minutes=30),
+            'dataflow_default_options': {
+                'project': 'my-gcp-project',
+                'zone': 'us-central1-f',
+                'stagingLocation': 'gs://bucket/tmp/dataflow/staging/',
+            }
+        }
+
+        dag = DAG('test-dag', default_args=default_args)
+
+        task = DataFlowJavaOperator(
+            gcp_conn_id='gcp_default',
+            task_id='normalize-cal',
+            jar='{{var.value.gcp_dataflow_base}}pipeline-ingress-cal-normalize-1.0.jar',
+            options={
+                'autoscalingAlgorithm': 'BASIC',
+                'maxNumWorkers': '50',
+                'start': '{{ds}}',
+                'partitionType': 'DAY'
+
+            },
+            dag=dag)
+
     .. seealso::
         For more detail on job submission have a look at the reference:
         https://cloud.google.com/dataflow/pipelines/specifying-exec-params
diff --git a/docs/integration.rst b/docs/integration.rst
index cad741f8d853f..4e9975e14cedc 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -477,45 +477,6 @@ Cloud DataFlow
 
 They also use :class:`airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook` to communicate with Google Cloud Platform.
 
-.. _DataFlowJavaOperator:
-
-DataFlowJavaOperator
-^^^^^^^^^^^^^^^^^^^^
-
-.. code:: python
-
-    default_args = {
-        'owner': 'airflow',
-        'depends_on_past': False,
-        'start_date':
-            (2016, 8, 1),
-        'email': ['alex@vanboxel.be'],
-        'email_on_failure': False,
-        'email_on_retry': False,
-        'retries': 1,
-        'retry_delay': timedelta(minutes=30),
-        'dataflow_default_options': {
-            'project': 'my-gcp-project',
-            'zone': 'us-central1-f',
-            'stagingLocation': 'gs://bucket/tmp/dataflow/staging/',
-        }
-    }
-
-    dag = DAG('test-dag', default_args=default_args)
-
-    task = DataFlowJavaOperator(
-        gcp_conn_id='gcp_default',
-        task_id='normalize-cal',
-        jar='{{var.value.gcp_dataflow_base}}pipeline-ingress-cal-normalize-1.0.jar',
-        options={
-            'autoscalingAlgorithm': 'BASIC',
-            'maxNumWorkers': '50',
-            'start': '{{ds}}',
-            'partitionType': 'DAY'
-
-        },
-        dag=dag)
-
 
 Cloud DataProc
 ''''''''''''''

From 65411622722f3bd1ec1b1c9dfd9dddee84913ad2 Mon Sep 17 00:00:00 2001
From: zhongjiajie <zhongjiajie955@hotmail.com>
Date: Wed, 27 Feb 2019 21:56:38 +0800
Subject: [PATCH 721/808] [AIRFLOW-XXX] Add history become ASF top level
 project (#4757)

---
 docs/project.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/project.rst b/docs/project.rst
index 0c35096c9b458..deb8d55f3d17d 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -25,7 +25,10 @@ Airflow was started in October 2014 by Maxime Beauchemin at Airbnb.
 It was open source from the very first commit and officially brought under
 the Airbnb GitHub and announced in June 2015.
 
-The project joined the Apache Software Foundation's incubation program in March 2016.
+The project joined the Apache Software Foundation's Incubator program in March 2016 and the
+Foundation `announced Apache Airflow as a Top-Level Project
+<https://blogs.apache.org/foundation/entry/the-apache-software-foundation-announces44>`_
+in January 2019.
 
 
 Committers

From 7860e03c9cda3a2c2abbe0a9446178d08ffc6c0d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Sat, 23 Mar 2019 23:52:26 +0100
Subject: [PATCH 722/808] [AIRFLOW-3659] Create Google Cloud Transfer Service
 Operators (#4792)

Co-authored-by: Antoni Smolinski <antoni.smolinski@polidea.com>
---
 UPDATING.md                                   |  63 ++
 .../example_dags/example_gcp_transfer.py      | 253 ++++++
 airflow/contrib/hooks/gcp_api_base_hook.py    |   9 +-
 airflow/contrib/hooks/gcp_transfer_hook.py    | 391 +++++++--
 .../operators/gcp_transfer_operator.py        | 798 ++++++++++++++++++
 .../operators/gcs_to_gcs_transfer_operator.py | 115 +--
 .../operators/s3_to_gcs_transfer_operator.py  | 123 +--
 .../contrib/sensors/gcp_transfer_sensor.py    |  80 ++
 docs/code.rst                                 |  42 +-
 docs/howto/operator/gcp/transfer.rst          | 420 +++++++++
 docs/integration.rst                          |  27 +-
 tests/contrib/hooks/test_gcp_api_base_hook.py |  32 +-
 tests/contrib/hooks/test_gcp_transfer_hook.py | 660 ++++++++++++---
 .../operators/test_gcp_transfer_operator.py   | 754 +++++++++++++++++
 .../test_gcp_transfer_operator_system.py      |  48 ++
 ...est_gcp_transfer_operator_system_helper.py | 192 +++++
 .../test_gcs_to_gcs_transfer_operator.py      | 131 ---
 .../test_s3_to_gcs_transfer_operator.py       | 158 ----
 .../sensors/test_gcp_transfer_sensor.py       | 148 ++++
 tests/contrib/utils/gcp_authenticator.py      |   1 +
 20 files changed, 3751 insertions(+), 694 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_transfer.py
 create mode 100644 airflow/contrib/operators/gcp_transfer_operator.py
 create mode 100644 airflow/contrib/sensors/gcp_transfer_sensor.py
 create mode 100644 docs/howto/operator/gcp/transfer.rst
 create mode 100644 tests/contrib/operators/test_gcp_transfer_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_transfer_operator_system.py
 create mode 100755 tests/contrib/operators/test_gcp_transfer_operator_system_helper.py
 delete mode 100644 tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py
 delete mode 100644 tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
 create mode 100644 tests/contrib/sensors/test_gcp_transfer_sensor.py

diff --git a/UPDATING.md b/UPDATING.md
index de90cbe7131c0..bdb35cb1aed6d 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -136,6 +136,69 @@ variable if you need to use a non default value for this.
 (Since this setting is used to calculate what config file to load, it is not
 possible to keep just the config option)
 
+### Change of two methods signatures in `GCPTransferServiceHook`
+
+The signature of the `create_transfer_job` method in `GCPTransferServiceHook`
+class has changed. The change does not change the behavior of the method.
+
+Old signature:
+```python
+def create_transfer_job(self, description, schedule, transfer_spec, project_id=None):
+```
+New signature:
+```python
+def create_transfer_job(self, body):
+```
+
+It is necessary to rewrite calls to method. The new call looks like this:
+```python
+body = {
+  'status': 'ENABLED',
+  'projectId': project_id,
+  'description': description,
+  'transferSpec': transfer_spec,
+  'schedule': schedule,
+}
+gct_hook.create_transfer_job(body)
+```
+The change results from the unification of all hooks and adjust to
+[the official recommendations](https://lists.apache.org/thread.html/e8534d82be611ae7bcb21ba371546a4278aad117d5e50361fd8f14fe@%3Cdev.airflow.apache.org%3E)
+for the Google Cloud Platform.
+
+The signature of `wait_for_transfer_job` method in `GCPTransferServiceHook` has changed.
+
+Old signature:
+```python
+def wait_for_transfer_job(self, job):
+```
+New signature:
+```python
+def wait_for_transfer_job(self, job, expected_statuses=(GcpTransferOperationStatus.SUCCESS, )):
+```
+
+The behavior of `wait_for_transfer_job` has changed:
+
+Old behavior:
+
+`wait_for_transfer_job` would wait for the SUCCESS status in specified jobs operations.
+
+New behavior:
+
+You can now specify an array of expected statuses. `wait_for_transfer_job` now waits for any of them.
+
+The default value of `expected_statuses` is SUCCESS so that change is backwards compatible.
+
+### Moved two classes to different modules
+
+The class `GoogleCloudStorageToGoogleCloudStorageTransferOperator` has been moved from
+`airflow.contrib.operators.gcs_to_gcs_transfer_operator` to `airflow.contrib.operators.gcp_transfer_operator`
+
+the class `S3ToGoogleCloudStorageTransferOperator` has been moved from
+`airflow.contrib.operators.s3_to_gcs_transfer_operator` to `airflow.contrib.operators.gcp_transfer_operator`
+
+The change was made to keep all the operators related to GCS Transfer Services in one file.
+
+The previous imports will continue to work until Airflow 2.0
 
 ## Airflow 1.10.2
 
diff --git a/airflow/contrib/example_dags/example_gcp_transfer.py b/airflow/contrib/example_dags/example_gcp_transfer.py
new file mode 100644
index 0000000000000..a21bdbcc18a4d
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_transfer.py
@@ -0,0 +1,253 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG that demonstrates interactions with Google Cloud Transfer.
+
+
+This DAG relies on the following OS environment variables
+
+* GCP_PROJECT_ID - Google Cloud Project to use for the Google Cloud Transfer Service.
+* GCP_DESCRIPTION - Description of transfer job
+* GCP_TRANSFER_SOURCE_AWS_BUCKET - Amazon Web Services Storage bucket from which files are copied.
+  .. warning::
+    You need to provide a large enough set of data so that operations do not execute too quickly.
+    Otherwise, DAG will fail.
+* GCP_TRANSFER_FIRST_TARGET_BUCKET - Google Cloud Storage bucket to which files are copied from AWS.
+  It is also a source bucket in next step
+* GCP_TRANSFER_SECOND_TARGET_BUCKET - Google Cloud Storage bucket bucket to which files are copied
+* WAIT_FOR_OPERATION_POKE_INTERVAL - interval of what to check the status of the operation
+  A smaller value than the default value accelerates the system test and ensures its correct execution with
+  smaller quantities of files in the source bucket
+  Look at documentation of :class:`~airflow.operators.sensors.BaseSensorOperator` for more information
+
+"""
+import os
+from datetime import datetime, timedelta
+from typing import Any, Dict
+
+from airflow import models
+from airflow.contrib.hooks.gcp_transfer_hook import (
+    GcpTransferOperationStatus,
+    GcpTransferJobsStatus,
+    TRANSFER_OPTIONS,
+    PROJECT_ID,
+    BUCKET_NAME,
+    GCS_DATA_SINK,
+    STATUS,
+    DESCRIPTION,
+    GCS_DATA_SOURCE,
+    START_TIME_OF_DAY,
+    SCHEDULE_END_DATE,
+    SCHEDULE_START_DATE,
+    SCHEDULE,
+    AWS_S3_DATA_SOURCE,
+    TRANSFER_SPEC,
+    FILTER_PROJECT_ID,
+    FILTER_JOB_NAMES,
+    TRANSFER_JOB,
+    TRANSFER_JOB_FIELD_MASK,
+    ALREADY_EXISTING_IN_SINK,
+)
+from airflow.contrib.operators.gcp_transfer_operator import (
+    GcpTransferServiceJobCreateOperator,
+    GcpTransferServiceJobDeleteOperator,
+    GcpTransferServiceJobUpdateOperator,
+    GcpTransferServiceOperationsListOperator,
+    GcpTransferServiceOperationGetOperator,
+    GcpTransferServiceOperationPauseOperator,
+    GcpTransferServiceOperationResumeOperator,
+    GcpTransferServiceOperationCancelOperator,
+)
+from airflow.contrib.sensors.gcp_transfer_sensor import GCPTransferServiceWaitForJobStatusSensor
+from airflow.utils.dates import days_ago
+
+# [START howto_operator_gcp_transfer_common_variables]
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_DESCRIPTION = os.environ.get('GCP_DESCRIPTION', 'description')
+GCP_TRANSFER_TARGET_BUCKET = os.environ.get('GCP_TRANSFER_TARGET_BUCKET')
+WAIT_FOR_OPERATION_POKE_INTERVAL = int(os.environ.get('WAIT_FOR_OPERATION_POKE_INTERVAL', 5))
+
+GCP_TRANSFER_SOURCE_AWS_BUCKET = os.environ.get('GCP_TRANSFER_SOURCE_AWS_BUCKET')
+GCP_TRANSFER_FIRST_TARGET_BUCKET = os.environ.get(
+    'GCP_TRANSFER_FIRST_TARGET_BUCKET', 'gcp-transfer-first-target'
+)
+GCP_TRANSFER_SECOND_TARGET_BUCKET = os.environ.get(
+    'GCP_TRANSFER_SECOND_TARGET_BUCKET', 'gcp-transfer-second-target'
+)
+# [END howto_operator_gcp_transfer_common_variables]
+
+# [START howto_operator_gcp_transfer_create_job_body_aws]
+aws_to_gcs_transfer_body = {
+    DESCRIPTION: GCP_DESCRIPTION,
+    STATUS: GcpTransferJobsStatus.ENABLED,
+    PROJECT_ID: GCP_PROJECT_ID,
+    SCHEDULE: {
+        SCHEDULE_START_DATE: datetime(2015, 1, 1).date(),
+        SCHEDULE_END_DATE: datetime(2030, 1, 1).date(),
+        START_TIME_OF_DAY: (datetime.utcnow() + timedelta(minutes=2)).time(),
+    },
+    TRANSFER_SPEC: {
+        AWS_S3_DATA_SOURCE: {BUCKET_NAME: GCP_TRANSFER_SOURCE_AWS_BUCKET},
+        GCS_DATA_SINK: {BUCKET_NAME: GCP_TRANSFER_FIRST_TARGET_BUCKET},
+        TRANSFER_OPTIONS: {ALREADY_EXISTING_IN_SINK: True},
+    },
+}
+# [END howto_operator_gcp_transfer_create_job_body_aws]
+
+# [START howto_operator_gcp_transfer_create_job_body_gcp]
+gcs_to_gcs_transfer_body = {
+    DESCRIPTION: GCP_DESCRIPTION,
+    STATUS: GcpTransferJobsStatus.ENABLED,
+    PROJECT_ID: GCP_PROJECT_ID,
+    SCHEDULE: {
+        SCHEDULE_START_DATE: datetime(2015, 1, 1).date(),
+        SCHEDULE_END_DATE: datetime(2030, 1, 1).date(),
+        START_TIME_OF_DAY: (datetime.utcnow() + timedelta(minutes=2)).time(),
+    },
+    TRANSFER_SPEC: {
+        GCS_DATA_SOURCE: {BUCKET_NAME: GCP_TRANSFER_FIRST_TARGET_BUCKET},
+        GCS_DATA_SINK: {BUCKET_NAME: GCP_TRANSFER_SECOND_TARGET_BUCKET},
+        TRANSFER_OPTIONS: {ALREADY_EXISTING_IN_SINK: True},
+    },
+}  # type: Dict[str, Any]
+# [END howto_operator_gcp_transfer_create_job_body_gcp]
+
+# [START howto_operator_gcp_transfer_update_job_body]
+update_body = {
+    PROJECT_ID: GCP_PROJECT_ID,
+    TRANSFER_JOB: {DESCRIPTION: "{}_updated".format(GCP_DESCRIPTION)},
+    TRANSFER_JOB_FIELD_MASK: "description",
+}
+# [END howto_operator_gcp_transfer_update_job_body]
+
+list_filter_dict = {FILTER_PROJECT_ID: GCP_PROJECT_ID, FILTER_JOB_NAMES: []}
+
+# [START howto_operator_gcp_transfer_default_args]
+default_args = {'start_date': days_ago(1)}
+# [END howto_operator_gcp_transfer_default_args]
+
+with models.DAG(
+    'example_gcp_transfer', default_args=default_args, schedule_interval=None  # Override to match your needs
+) as dag:
+
+    # [START howto_operator_gcp_transfer_create_job]
+    create_transfer_job_from_aws = GcpTransferServiceJobCreateOperator(
+        task_id="create_transfer_job_from_aws", body=aws_to_gcs_transfer_body
+    )
+    # [END howto_operator_gcp_transfer_create_job]
+
+    wait_for_operation_to_start = GCPTransferServiceWaitForJobStatusSensor(
+        task_id="wait_for_operation_to_start",
+        job_name="{{task_instance.xcom_pull('create_transfer_job_from_aws')['name']}}",
+        project_id=GCP_PROJECT_ID,
+        expected_statuses={GcpTransferOperationStatus.IN_PROGRESS},
+        poke_interval=WAIT_FOR_OPERATION_POKE_INTERVAL,
+    )
+
+    # [START howto_operator_gcp_transfer_pause_operation]
+    pause_operation = GcpTransferServiceOperationPauseOperator(
+        task_id="pause_operation",
+        operation_name="{{task_instance.xcom_pull('wait_for_operation_to_start', "
+        "key='sensed_operations')[0]['name']}}",
+    )
+    # [END howto_operator_gcp_transfer_pause_operation]
+
+    # [START howto_operator_gcp_transfer_update_job]
+    update_job = GcpTransferServiceJobUpdateOperator(
+        task_id="update_job",
+        job_name="{{task_instance.xcom_pull('create_transfer_job_from_aws')['name']}}",
+        body=update_body,
+    )
+    # [END howto_operator_gcp_transfer_update_job]
+
+    # [START howto_operator_gcp_transfer_list_operations]
+    list_operations = GcpTransferServiceOperationsListOperator(
+        task_id="list_operations",
+        filter={
+            FILTER_PROJECT_ID: GCP_PROJECT_ID,
+            FILTER_JOB_NAMES: ["{{task_instance.xcom_pull('create_transfer_job_from_aws')['name']}}"],
+        },
+    )
+    # [END howto_operator_gcp_transfer_list_operations]
+
+    # [START howto_operator_gcp_transfer_get_operation]
+    get_operation = GcpTransferServiceOperationGetOperator(
+        task_id="get_operation", operation_name="{{task_instance.xcom_pull('list_operations')[0]['name']}}"
+    )
+    # [END howto_operator_gcp_transfer_get_operation]
+
+    # [START howto_operator_gcp_transfer_resume_operation]
+    resume_operation = GcpTransferServiceOperationResumeOperator(
+        task_id="resume_operation", operation_name="{{task_instance.xcom_pull('get_operation')['name']}}"
+    )
+    # [END howto_operator_gcp_transfer_resume_operation]
+
+    # [START howto_operator_gcp_transfer_wait_operation]
+    wait_for_operation_to_end = GCPTransferServiceWaitForJobStatusSensor(
+        task_id="wait_for_operation_to_end",
+        job_name="{{task_instance.xcom_pull('create_transfer_job_from_aws')['name']}}",
+        project_id=GCP_PROJECT_ID,
+        expected_statuses={GcpTransferOperationStatus.SUCCESS},
+        poke_interval=WAIT_FOR_OPERATION_POKE_INTERVAL,
+    )
+    # [END howto_operator_gcp_transfer_wait_operation]
+
+    job_time = datetime.utcnow() + timedelta(minutes=2)
+
+    gcs_to_gcs_transfer_body['schedule']['startTimeOfDay'] = (datetime.utcnow() + timedelta(minutes=2)).time()
+
+    create_transfer_job_from_gcp = GcpTransferServiceJobCreateOperator(
+        task_id="create_transfer_job_from_gcp", body=gcs_to_gcs_transfer_body
+    )
+
+    wait_for_second_operation_to_start = GCPTransferServiceWaitForJobStatusSensor(
+        task_id="wait_for_second_operation_to_start",
+        job_name="{{ task_instance.xcom_pull('create_transfer_job_from_gcp')['name'] }}",
+        project_id=GCP_PROJECT_ID,
+        expected_statuses={GcpTransferOperationStatus.IN_PROGRESS},
+        poke_interval=WAIT_FOR_OPERATION_POKE_INTERVAL,
+    )
+
+    # [START howto_operator_gcp_transfer_cancel_operation]
+    cancel_operation = GcpTransferServiceOperationCancelOperator(
+        task_id="cancel_operation",
+        operation_name="{{task_instance.xcom_pull("
+        "'wait_for_second_operation_to_start', key='sensed_operations')[0]['name']}}",
+    )
+    # [END howto_operator_gcp_transfer_cancel_operation]
+
+    # [START howto_operator_gcp_transfer_delete_job]
+    delete_transfer_from_aws_job = GcpTransferServiceJobDeleteOperator(
+        task_id="delete_transfer_from_aws_job",
+        job_name="{{task_instance.xcom_pull('create_transfer_job_from_aws')['name']}}",
+        project_id=GCP_PROJECT_ID,
+    )
+    # [END howto_operator_gcp_transfer_delete_job]
+
+    delete_transfer_from_gcp_job = GcpTransferServiceJobDeleteOperator(
+        task_id="delete_transfer_from_gcp_job",
+        job_name="{{task_instance.xcom_pull('create_transfer_job_from_gcp')['name']}}",
+        project_id=GCP_PROJECT_ID,
+    )
+
+    create_transfer_job_from_aws >> wait_for_operation_to_start >> pause_operation >> \
+        list_operations >> get_operation >> resume_operation >> wait_for_operation_to_end >> \
+        create_transfer_job_from_gcp >> wait_for_second_operation_to_start >> cancel_operation >> \
+        delete_transfer_from_aws_job >> delete_transfer_from_gcp_job
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 00a5a9685afed..ad46b59da3458 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -28,6 +28,7 @@
 import tempfile
 
 from google.api_core.exceptions import GoogleAPICallError, AlreadyExists, RetryError
+from googleapiclient.errors import HttpError
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
@@ -164,6 +165,10 @@ def project_id(self):
 
     @staticmethod
     def catch_http_exception(func):
+        """
+        Function decorator that intercepts HTTP Errors and raises AirflowException
+        with more informative message.
+        """
         @functools.wraps(func)
         def wrapper_decorator(self, *args, **kwargs):
             try:
@@ -180,7 +185,9 @@ def wrapper_decorator(self, *args, **kwargs):
             except ValueError as e:
                 self.log.error('The request failed, the parameters are invalid.')
                 raise AirflowException(e)
-
+            except HttpError as e:
+                self.log.error('The request failed:\n%s', str(e))
+                raise AirflowException(e)
         return wrapper_decorator
 
     @staticmethod
diff --git a/airflow/contrib/hooks/gcp_transfer_hook.py b/airflow/contrib/hooks/gcp_transfer_hook.py
index 6966ec3ae244e..c6fd4d5e2f6a6 100644
--- a/airflow/contrib/hooks/gcp_transfer_hook.py
+++ b/airflow/contrib/hooks/gcp_transfer_hook.py
@@ -19,7 +19,9 @@
 
 import json
 import time
-import datetime
+from copy import deepcopy
+
+import six
 from googleapiclient.discovery import build
 
 from airflow.exceptions import AirflowException
@@ -29,17 +31,76 @@
 TIME_TO_SLEEP_IN_SECONDS = 10
 
 
+class GcpTransferJobsStatus:
+    ENABLED = "ENABLED"
+    DISABLED = "DISABLED"
+    DELETED = "DELETED"
+
+
+class GcpTransferOperationStatus:
+    IN_PROGRESS = "IN_PROGRESS"
+    PAUSED = "PAUSED"
+    SUCCESS = "SUCCESS"
+    FAILED = "FAILED"
+    ABORTED = "ABORTED"
+
+
+# A list of keywords used to build a request or response
+ACCESS_KEY_ID = "accessKeyId"
+ALREADY_EXISTING_IN_SINK = "overwriteObjectsAlreadyExistingInSink"
+AWS_ACCESS_KEY = "awsAccessKey"
+AWS_S3_DATA_SOURCE = 'awsS3DataSource'
+BODY = 'body'
+BUCKET_NAME = 'bucketName'
+DAY = 'day'
+DESCRIPTION = "description"
+FILTER = 'filter'
+FILTER_JOB_NAMES = 'job_names'
+FILTER_PROJECT_ID = 'project_id'
+GCS_DATA_SINK = 'gcsDataSink'
+GCS_DATA_SOURCE = 'gcsDataSource'
+HOURS = "hours"
+HTTP_DATA_SOURCE = 'httpDataSource'
+LIST_URL = 'list_url'
+METADATA = 'metadata'
+MINUTES = "minutes"
+MONTH = 'month'
+NAME = 'name'
+OBJECT_CONDITIONS = 'object_conditions'
+OPERATIONS = 'operations'
+PROJECT_ID = 'projectId'
+SCHEDULE = 'schedule'
+SCHEDULE_END_DATE = 'scheduleEndDate'
+SCHEDULE_START_DATE = 'scheduleStartDate'
+SECONDS = "seconds"
+SECRET_ACCESS_KEY = "secretAccessKey"
+START_TIME_OF_DAY = 'startTimeOfDay'
+STATUS = "status"
+STATUS1 = 'status'
+TRANSFER_JOB = 'transfer_job'
+TRANSFER_JOB_FIELD_MASK = 'update_transfer_job_field_mask'
+TRANSFER_JOBS = 'transferJobs'
+TRANSFER_OPERATIONS = 'transferOperations'
+TRANSFER_OPTIONS = 'transfer_options'
+TRANSFER_SPEC = 'transferSpec'
+YEAR = 'year'
+
+NEGATIVE_STATUSES = {GcpTransferOperationStatus.FAILED, GcpTransferOperationStatus.ABORTED}
+
+# Number of retries - used by googleapiclient method calls to perform retries
+# For requests that are "retriable"
+NUM_RETRIES = 5
+
+
 # noinspection PyAbstractClass
 class GCPTransferServiceHook(GoogleCloudBaseHook):
     """
-    Hook for GCP Storage Transfer Service.
+    Hook for Google Storage Transfer Service.
     """
+
     _conn = None
 
-    def __init__(self,
-                 api_version='v1',
-                 gcp_conn_id='google_cloud_default',
-                 delegate_to=None):
+    def __init__(self, api_version='v1', gcp_conn_id='google_cloud_default', delegate_to=None):
         super(GCPTransferServiceHook, self).__init__(gcp_conn_id, delegate_to)
         self.api_version = api_version
 
@@ -52,56 +113,280 @@ def get_conn(self):
         """
         if not self._conn:
             http_authorized = self._authorize()
-            self._conn = build('storagetransfer', self.api_version,
-                               http=http_authorized, cache_discovery=False)
+            self._conn = build(
+                'storagetransfer', self.api_version, http=http_authorized, cache_discovery=False
+            )
         return self._conn
 
-    def create_transfer_job(self, description, schedule, transfer_spec, project_id=None):
-        transfer_job = {
-            'status': 'ENABLED',
-            'projectId': project_id or self.project_id,
-            'description': description,
-            'transferSpec': transfer_spec,
-            'schedule': schedule or self._schedule_once_now(),
-        }
-        return self.get_conn().transferJobs().create(body=transfer_job).execute()
-
-    def wait_for_transfer_job(self, job):
-        while True:
-            result = self.get_conn().transferOperations().list(
-                name='transferOperations',
-                filter=json.dumps({
-                    'project_id': job['projectId'],
-                    'job_names': [job['name']],
-                }),
-            ).execute()
-            if self._check_operations_result(result):
-                return True
+    @GoogleCloudBaseHook.catch_http_exception
+    def create_transfer_job(self, body):
+        """
+        Creates a transfer job that runs periodically.
+
+        :param body: (Required) A request body, as described in
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/patch#request-body
+        :type body: dict
+        :return: transfer job.
+            See:
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs#TransferJob
+        :rtype: dict
+        """
+        body = self._inject_project_id(body, BODY, PROJECT_ID)
+        return self.get_conn().transferJobs().create(body=body).execute(num_retries=NUM_RETRIES)
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    @GoogleCloudBaseHook.catch_http_exception
+    def get_transfer_job(self, job_name, project_id=None):
+        """
+        Gets the latest state of a long-running operation in Google Storage
+        Transfer Service.
+
+        :param job_name: (Required) Name of the job to be fetched
+        :type job_name: str
+        :param project_id: (Optional) the ID of the project that owns the Transfer
+            Job. If set to None or missing, the default project_id from the GCP
+            connection is used.
+        :type project_id: str
+        :return: Transfer Job
+        :rtype: dict
+        """
+        return (
+            self.get_conn()
+            .transferJobs()
+            .get(jobName=job_name, projectId=project_id)
+            .execute(num_retries=NUM_RETRIES)
+        )
+
+    def list_transfer_job(self, filter):
+        """
+        Lists long-running operations in Google Storage Transfer
+        Service that match the specified filter.
+
+        :param filter: (Required) A request filter, as described in
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/list#body.QUERY_PARAMETERS.filter
+        :type filter: dict
+        :return: List of Transfer Jobs
+        :rtype: list[dict]
+        """
+        conn = self.get_conn()
+        filter = self._inject_project_id(filter, FILTER, FILTER_PROJECT_ID)
+        request = conn.transferJobs().list(filter=json.dumps(filter))
+        jobs = []
+
+        while request is not None:
+            response = request.execute(num_retries=NUM_RETRIES)
+            jobs.extend(response[TRANSFER_JOBS])
+
+            request = conn.transferJobs().list_next(previous_request=request, previous_response=response)
+
+        return jobs
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def update_transfer_job(self, job_name, body):
+        """
+        Updates a transfer job that runs periodically.
+
+        :param job_name: (Required) Name of the job to be updated
+        :type job_name: str
+        :param body: A request body, as described in
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/patch#request-body
+        :type body: dict
+        :return: If successful, TransferJob.
+        :rtype: dict
+        """
+        body = self._inject_project_id(body, BODY, PROJECT_ID)
+        return (
+            self.get_conn().transferJobs().patch(jobName=job_name, body=body).execute(num_retries=NUM_RETRIES)
+        )
+
+    @GoogleCloudBaseHook.fallback_to_default_project_id
+    @GoogleCloudBaseHook.catch_http_exception
+    def delete_transfer_job(self, job_name, project_id):
+        """
+        Deletes a transfer job. This is a soft delete. After a transfer job is
+        deleted, the job and all the transfer executions are subject to garbage
+        collection. Transfer jobs become eligible for garbage collection
+        30 days after soft delete.
+
+        :param job_name: (Required) Name of the job to be deleted
+        :type job_name: str
+        :param project_id: (Optional) the ID of the project that owns the Transfer
+            Job. If set to None or missing, the default project_id from the GCP
+            connection is used.
+        :type project_id: str
+        :rtype: None
+        """
+
+        return (
+            self.get_conn()
+            .transferJobs()
+            .patch(
+                jobName=job_name,
+                body={
+                    PROJECT_ID: project_id,
+                    TRANSFER_JOB: {STATUS1: GcpTransferJobsStatus.DELETED},
+                    TRANSFER_JOB_FIELD_MASK: STATUS1,
+                },
+            )
+            .execute(num_retries=NUM_RETRIES)
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def cancel_transfer_operation(self, operation_name):
+        """
+        Cancels an transfer operation in Google Storage Transfer Service.
+
+        :param operation_name: Name of the transfer operation.
+        :type operation_name: str
+        :rtype: None
+        """
+        self.get_conn().transferOperations().cancel(name=operation_name).execute(num_retries=NUM_RETRIES)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def get_transfer_operation(self, operation_name):
+        """
+        Gets an transfer operation in Google Storage Transfer Service.
+
+        :param operation_name: (Required) Name of the transfer operation.
+        :type operation_name: str
+        :return: transfer operation
+            See:
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/Operation
+        :rtype: dict
+        """
+        return self.get_conn().transferOperations().get(name=operation_name).execute(num_retries=NUM_RETRIES)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def list_transfer_operations(self, filter):
+        """
+        Gets an transfer operation in Google Storage Transfer Service.
+
+        :param filter: (Required) A request filter, as described in
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/list#body.QUERY_PARAMETERS.filter
+            With one additional improvement:
+
+            * project_id is optional if you have a project id defined
+              in the connection
+              See: :doc:`howto/connection/gcp`
+
+        :type filter: dict
+        :return: transfer operation
+        :rtype: list[dict]
+        """
+        conn = self.get_conn()
+
+        filter = self._inject_project_id(filter, FILTER, FILTER_PROJECT_ID)
+
+        operations = []
+
+        request = conn.transferOperations().list(name=TRANSFER_OPERATIONS, filter=json.dumps(filter))
+
+        while request is not None:
+            response = request.execute(num_retries=NUM_RETRIES)
+            if OPERATIONS in response:
+                operations.extend(response[OPERATIONS])
+
+            request = conn.transferOperations().list_next(
+                previous_request=request, previous_response=response
+            )
+
+        return operations
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def pause_transfer_operation(self, operation_name):
+        """
+        Pauses an transfer operation in Google Storage Transfer Service.
+
+        :param operation_name: (Required) Name of the transfer operation.
+        :type operation_name: str
+        :rtype: None
+        """
+        self.get_conn().transferOperations().pause(name=operation_name).execute(num_retries=NUM_RETRIES)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def resume_transfer_operation(self, operation_name):
+        """
+        Resumes an transfer operation in Google Storage Transfer Service.
+
+        :param operation_name: (Required) Name of the transfer operation.
+        :type operation_name: str
+        :rtype: None
+        """
+        self.get_conn().transferOperations().resume(name=operation_name).execute(num_retries=NUM_RETRIES)
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def wait_for_transfer_job(self, job, expected_statuses=(GcpTransferOperationStatus.SUCCESS,), timeout=60):
+        """
+        Waits until the job reaches the expected state.
+
+        :param job: Transfer job
+            See:
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs#TransferJob
+        :type job: dict
+        :param expected_statuses: State that is expected
+            See:
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations#Status
+        :type expected_statuses: set[str]
+        :param timeout:
+        :type timeout: time in which the operation must end in seconds
+        :rtype: None
+        """
+        while timeout > 0:
+            operations = self.list_transfer_operations(
+                filter={FILTER_PROJECT_ID: job[PROJECT_ID], FILTER_JOB_NAMES: [job[NAME]]}
+            )
+
+            if GCPTransferServiceHook.operations_contain_expected_statuses(operations, expected_statuses):
+                return
             time.sleep(TIME_TO_SLEEP_IN_SECONDS)
+            timeout -= TIME_TO_SLEEP_IN_SECONDS
+        raise AirflowException("Timeout. The operation could not be completed within the allotted time.")
+
+    def _inject_project_id(self, body, param_name, target_key):
+        body = deepcopy(body)
+        body[target_key] = body.get(target_key, self.project_id)
+        if not body.get(target_key):
+            raise AirflowException(
+                "The project id must be passed either as `{}` key in `{}` parameter or as project_id "
+                "extra in GCP connection definition. Both are not set!".format(target_key, param_name)
+            )
+        return body
+
+    @staticmethod
+    def operations_contain_expected_statuses(operations, expected_statuses):
+        """
+        Checks whether the operation list has an operation with the
+        expected status, then returns true
+        If it encounters operations in FAILED or ABORTED state
+        throw :class:`airflow.exceptions.AirflowException`.
 
-    def _check_operations_result(self, result):
-        operations = result.get('operations', [])
+        :param operations: (Required) List of transfer operations to check.
+        :type operations: list[dict]
+        :param expected_statuses: (Required) status that is expected
+            See:
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations#Status
+        :type expected_statuses: set[str]
+        :return: If there is an operation with the expected state
+            in the operation list, returns true,
+        :raises: airflow.exceptions.AirflowException If it encounters operations
+            with a state in the list,
+        :rtype: bool
+        """
+        expected_statuses = (
+            {expected_statuses} if isinstance(expected_statuses, six.string_types) else set(expected_statuses)
+        )
         if len(operations) == 0:
             return False
-        for operation in operations:
-            if operation['metadata']['status'] in {'FAILED', 'ABORTED'}:
-                raise AirflowException('Operation {} {}'.format(
-                    operation['name'], operation['metadata']['status']))
-            if operation['metadata']['status'] != 'SUCCESS':
-                return False
-        return True
-
-    def _schedule_once_now(self):
-        now = datetime.datetime.utcnow()
-        return {
-            'scheduleStartDate': {
-                'day': now.day,
-                'month': now.month,
-                'year': now.year,
-            },
-            'scheduleEndDate': {
-                'day': now.day,
-                'month': now.month,
-                'year': now.year,
-            }
-        }
+
+        current_statuses = {operation[METADATA][STATUS] for operation in operations}
+
+        if len(current_statuses - set(expected_statuses)) != len(current_statuses):
+            return True
+
+        if len(NEGATIVE_STATUSES - current_statuses) != len(NEGATIVE_STATUSES):
+            raise AirflowException(
+                'An unexpected operation status was encountered. Expected: {}'.format(
+                    ", ".join(expected_statuses)
+                )
+            )
+        return False
diff --git a/airflow/contrib/operators/gcp_transfer_operator.py b/airflow/contrib/operators/gcp_transfer_operator.py
new file mode 100644
index 0000000000000..c961bdd97ece2
--- /dev/null
+++ b/airflow/contrib/operators/gcp_transfer_operator.py
@@ -0,0 +1,798 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+from copy import deepcopy
+from datetime import date, time
+
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_transfer_hook import (
+    GCPTransferServiceHook,
+    GcpTransferJobsStatus,
+    TRANSFER_OPTIONS,
+    OBJECT_CONDITIONS,
+    PROJECT_ID,
+    BUCKET_NAME,
+    GCS_DATA_SINK,
+    STATUS,
+    DESCRIPTION,
+    GCS_DATA_SOURCE,
+    HTTP_DATA_SOURCE,
+    SECONDS,
+    MINUTES,
+    HOURS,
+    YEAR,
+    MONTH,
+    DAY,
+    START_TIME_OF_DAY,
+    SCHEDULE_END_DATE,
+    SCHEDULE_START_DATE,
+    SCHEDULE,
+    SECRET_ACCESS_KEY,
+    ACCESS_KEY_ID,
+    AWS_ACCESS_KEY,
+    AWS_S3_DATA_SOURCE,
+    TRANSFER_SPEC,
+)
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+try:
+    from airflow.contrib.hooks.aws_hook import AwsHook
+except ImportError:  # pragma: no cover
+    AwsHook = None  # type: ignore
+
+
+class TransferJobPreprocessor:
+    def __init__(self, body, aws_conn_id='aws_default'):
+        self.body = body
+        self.aws_conn_id = aws_conn_id
+
+    def _inject_aws_credentials(self):
+        if TRANSFER_SPEC not in self.body or AWS_S3_DATA_SOURCE not in self.body[TRANSFER_SPEC]:
+            return
+
+        aws_hook = AwsHook(self.aws_conn_id)
+        aws_credentials = aws_hook.get_credentials()
+        aws_access_key_id = aws_credentials.access_key
+        aws_secret_access_key = aws_credentials.secret_key
+        self.body[TRANSFER_SPEC][AWS_S3_DATA_SOURCE][AWS_ACCESS_KEY] = {
+            ACCESS_KEY_ID: aws_access_key_id,
+            SECRET_ACCESS_KEY: aws_secret_access_key,
+        }
+
+    def _reformat_date(self, field_key):
+        schedule = self.body[SCHEDULE]
+        if field_key not in schedule:
+            return
+        if isinstance(schedule[field_key], date):
+            schedule[field_key] = self._convert_date_to_dict(schedule[field_key])
+
+    def _reformat_time(self, field_key):
+        schedule = self.body[SCHEDULE]
+        if field_key not in schedule:
+            return
+        if isinstance(schedule[field_key], time):
+            schedule[field_key] = self._convert_time_to_dict(schedule[field_key])
+
+    def _reformat_schedule(self):
+        if SCHEDULE not in self.body:
+            return
+        self._reformat_date(SCHEDULE_START_DATE)
+        self._reformat_date(SCHEDULE_END_DATE)
+        self._reformat_time(START_TIME_OF_DAY)
+
+    def process_body(self):
+        self._inject_aws_credentials()
+        self._reformat_schedule()
+        return self.body
+
+    @staticmethod
+    def _convert_date_to_dict(field_date):
+        """
+        Convert native python ``datetime.date`` object  to a format supported by the API
+        """
+        return {DAY: field_date.day, MONTH: field_date.month, YEAR: field_date.year}
+
+    @staticmethod
+    def _convert_time_to_dict(time):
+        """
+        Convert native python ``datetime.time`` object  to a format supported by the API
+        """
+        return {HOURS: time.hour, MINUTES: time.minute, SECONDS: time.second}
+
+
+class TransferJobValidator:
+    def __init__(self, body):
+        self.body = body
+
+    def _verify_data_source(self):
+        is_gcs = GCS_DATA_SOURCE in self.body[TRANSFER_SPEC]
+        is_aws_s3 = AWS_S3_DATA_SOURCE in self.body[TRANSFER_SPEC]
+        is_http = HTTP_DATA_SOURCE in self.body[TRANSFER_SPEC]
+
+        sources_count = sum([is_gcs, is_aws_s3, is_http])
+        if sources_count != 0 and sources_count != 1:
+            raise AirflowException(
+                "More than one data source detected. Please choose exactly one data source from: "
+                "gcsDataSource, awsS3DataSource and httpDataSource."
+            )
+
+    def _restrict_aws_credentials(self):
+        if AWS_S3_DATA_SOURCE not in self.body[TRANSFER_SPEC]:
+            return
+
+        if AWS_ACCESS_KEY in self.body[TRANSFER_SPEC][AWS_S3_DATA_SOURCE]:
+            raise AirflowException(
+                "AWS credentials detected inside the body parameter (awsAccessKey). This is not allowed, "
+                "please use Airflow connections to store credentials."
+            )
+
+    def _restrict_empty_body(self):
+        if not self.body:
+            raise AirflowException("The required parameter 'body' is empty or None")
+
+    def validate_body(self):
+        self._restrict_empty_body()
+
+        if TRANSFER_SPEC not in self.body:
+            return
+
+        self._restrict_aws_credentials()
+        self._verify_data_source()
+
+
+class GcpTransferServiceJobCreateOperator(BaseOperator):
+    """
+    Creates a transfer job that runs periodically.
+
+    .. warning::
+
+        This operator is NOT idempotent. If you run it many times, many transfer
+        jobs will be created in the Google Cloud Platform.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceJobCreateOperator`
+
+    :param body: (Required) The request body, as described in
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/create#request-body
+        With three additional improvements:
+
+        * dates can be given in the form :class:`datetime.date`
+        * times can be given in the form :class:`datetime.time`
+        * credentials to Amazon Web Service should be stored in the connection and indicated by the
+          aws_conn_id parameter
+
+    :type body: dict
+    :param aws_conn_id: The connection ID used to retrieve credentials to
+        Amazon Web Service.
+    :type aws_conn_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud
+        Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_job_create_template_fields]
+    template_fields = ('body', 'gcp_conn_id', 'aws_conn_id')
+    # [END gcp_transfer_job_create_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        body,
+        aws_conn_id='aws_default',
+        gcp_conn_id='google_cloud_default',
+        api_version='v1',
+        *args,
+        **kwargs
+    ):
+        super(GcpTransferServiceJobCreateOperator, self).__init__(*args, **kwargs)
+        self.body = deepcopy(body)
+        self.aws_conn_id = aws_conn_id
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        TransferJobValidator(body=self.body).validate_body()
+
+    def execute(self, context):
+        TransferJobPreprocessor(body=self.body, aws_conn_id=self.aws_conn_id).process_body()
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        return hook.create_transfer_job(body=self.body)
+
+
+class GcpTransferServiceJobUpdateOperator(BaseOperator):
+    """
+    Updates a transfer job that runs periodically.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceJobUpdateOperator`
+
+    :param job_name: (Required) Name of the job to be updated
+    :type job_name: str
+    :param body: (Required) The request body, as described in
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/patch#request-body
+        With three additional improvements:
+
+        * dates can be given in the form :class:`datetime.date`
+        * times can be given in the form :class:`datetime.time`
+        * credentials to Amazon Web Service should be stored in the connection and indicated by the
+          aws_conn_id parameter
+
+    :type body: dict
+    :param aws_conn_id: The connection ID used to retrieve credentials to
+        Amazon Web Service.
+    :type aws_conn_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud
+        Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_job_update_template_fields]
+    template_fields = ('job_name', 'body', 'gcp_conn_id', 'aws_conn_id')
+    # [END gcp_transfer_job_update_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        job_name,
+        body,
+        aws_conn_id='aws_default',
+        gcp_conn_id='google_cloud_default',
+        api_version='v1',
+        *args,
+        **kwargs
+    ):
+        super(GcpTransferServiceJobUpdateOperator, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.body = body
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self.aws_conn_id = aws_conn_id
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        TransferJobValidator(body=self.body).validate_body()
+        if not self.job_name:
+            raise AirflowException("The required parameter 'job_name' is empty or None")
+
+    def execute(self, context):
+        TransferJobPreprocessor(body=self.body, aws_conn_id=self.aws_conn_id).process_body()
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        return hook.update_transfer_job(job_name=self.job_name, body=self.body)
+
+
+class GcpTransferServiceJobDeleteOperator(BaseOperator):
+    """
+    Delete a transfer job. This is a soft delete. After a transfer job is
+    deleted, the job and all the transfer executions are subject to garbage
+    collection. Transfer jobs become eligible for garbage collection
+    30 days after soft delete.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceJobDeleteOperator`
+
+    :param job_name: (Required) Name of the TRANSFER operation
+    :type job_name: str
+    :param project_id: (Optional) the ID of the project that owns the Transfer
+        Job. If set to None or missing, the default project_id from the GCP
+        connection is used.
+    :type project_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud
+        Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_job_delete_template_fields]
+    template_fields = ('job_name', 'project_id', 'gcp_conn_id', 'api_version')
+    # [END gcp_transfer_job_delete_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self, job_name, gcp_conn_id='google_cloud_default', api_version='v1', project_id=None, *args, **kwargs
+    ):
+        super(GcpTransferServiceJobDeleteOperator, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.project_id = project_id
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        if not self.job_name:
+            raise AirflowException("The required parameter 'job_name' is empty or None")
+
+    def execute(self, context):
+        self._validate_inputs()
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        hook.delete_transfer_job(job_name=self.job_name, project_id=self.project_id)
+
+
+class GcpTransferServiceOperationGetOperator(BaseOperator):
+    """
+    Gets the latest state of a long-running operation in Google Storage Transfer
+    Service.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceOperationGetOperator`
+
+    :param operation_name: (Required) Name of the transfer operation.
+    :type operation_name: str
+    :param gcp_conn_id: The connection ID used to connect to Google
+        Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_operation_get_template_fields]
+    template_fields = ('operation_name', 'gcp_conn_id')
+    # [END gcp_transfer_operation_get_template_fields]
+
+    @apply_defaults
+    def __init__(self, operation_name, gcp_conn_id='google_cloud_default', api_version='v1', *args, **kwargs):
+        super(GcpTransferServiceOperationGetOperator, self).__init__(*args, **kwargs)
+        self.operation_name = operation_name
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        if not self.operation_name:
+            raise AirflowException("The required parameter 'operation_name' is empty or None")
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        operation = hook.get_transfer_operation(operation_name=self.operation_name)
+        return operation
+
+
+class GcpTransferServiceOperationsListOperator(BaseOperator):
+    """
+    Lists long-running operations in Google Storage Transfer
+    Service that match the specified filter.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceOperationsListOperator`
+
+    :param filter: (Required) A request filter, as described in
+            https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/list#body.QUERY_PARAMETERS.filter
+    :type filter: dict
+    :param gcp_conn_id: The connection ID used to connect to Google
+        Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_operations_list_template_fields]
+    template_fields = ('filter', 'gcp_conn_id')
+    # [END gcp_transfer_operations_list_template_fields]
+
+    def __init__(self, filter, gcp_conn_id='google_cloud_default', api_version='v1', *args, **kwargs):
+        super(GcpTransferServiceOperationsListOperator, self).__init__(*args, **kwargs)
+        self.filter = filter
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        if not self.filter:
+            raise AirflowException("The required parameter 'filter' is empty or None")
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        operations_list = hook.list_transfer_operations(filter=self.filter)
+        self.log.info(operations_list)
+        return operations_list
+
+
+class GcpTransferServiceOperationPauseOperator(BaseOperator):
+    """
+    Pauses a transfer operation in Google Storage Transfer Service.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceOperationPauseOperator`
+
+    :param operation_name: (Required) Name of the transfer operation.
+    :type operation_name: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :type gcp_conn_id: str
+    :param api_version:  API version used (e.g. v1).
+    :type api_version: str
+    """
+
+    # [START gcp_transfer_operation_pause_template_fields]
+    template_fields = ('operation_name', 'gcp_conn_id', 'api_version')
+    # [END gcp_transfer_operation_pause_template_fields]
+
+    @apply_defaults
+    def __init__(self, operation_name, gcp_conn_id='google_cloud_default', api_version='v1', *args, **kwargs):
+        super(GcpTransferServiceOperationPauseOperator, self).__init__(*args, **kwargs)
+        self.operation_name = operation_name
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        if not self.operation_name:
+            raise AirflowException("The required parameter 'operation_name' is empty or None")
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        hook.pause_transfer_operation(operation_name=self.operation_name)
+
+
+class GcpTransferServiceOperationResumeOperator(BaseOperator):
+    """
+    Resumes a transfer operation in Google Storage Transfer Service.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceOperationResumeOperator`
+
+    :param operation_name: (Required) Name of the transfer operation.
+    :type operation_name: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud Platform.
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    :type gcp_conn_id: str
+    """
+
+    # [START gcp_transfer_operation_resume_template_fields]
+    template_fields = ('operation_name', 'gcp_conn_id', 'api_version')
+    # [END gcp_transfer_operation_resume_template_fields]
+
+    @apply_defaults
+    def __init__(self, operation_name, gcp_conn_id='google_cloud_default', api_version='v1', *args, **kwargs):
+        self.operation_name = operation_name
+        self.gcp_conn_id = gcp_conn_id
+        self.api_version = api_version
+        self._validate_inputs()
+        super(GcpTransferServiceOperationResumeOperator, self).__init__(*args, **kwargs)
+
+    def _validate_inputs(self):
+        if not self.operation_name:
+            raise AirflowException("The required parameter 'operation_name' is empty or None")
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        hook.resume_transfer_operation(operation_name=self.operation_name)
+
+
+class GcpTransferServiceOperationCancelOperator(BaseOperator):
+    """
+    Cancels a transfer operation in Google Storage Transfer Service.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:GcpTransferServiceOperationCancelOperator`
+
+    :param operation_name: (Required) Name of the transfer operation.
+    :type operation_name: str
+    :param api_version: API version used (e.g. v1).
+    :type api_version: str
+    :param gcp_conn_id: The connection ID used to connect to Google
+        Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START gcp_transfer_operation_cancel_template_fields]
+    template_fields = ('operation_name', 'gcp_conn_id', 'api_version')
+    # [END gcp_transfer_operation_cancel_template_fields]
+
+    @apply_defaults
+    def __init__(self, operation_name, api_version='v1', gcp_conn_id='google_cloud_default', *args, **kwargs):
+        super(GcpTransferServiceOperationCancelOperator, self).__init__(*args, **kwargs)
+        self.operation_name = operation_name
+        self.api_version = api_version
+        self.gcp_conn_id = gcp_conn_id
+        self._validate_inputs()
+
+    def _validate_inputs(self):
+        if not self.operation_name:
+            raise AirflowException("The required parameter 'operation_name' is empty or None")
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(api_version=self.api_version, gcp_conn_id=self.gcp_conn_id)
+        hook.cancel_transfer_operation(operation_name=self.operation_name)
+
+
+class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
+    """
+    Synchronizes an S3 bucket with a Google Cloud Storage bucket using the
+    GCP Storage Transfer Service.
+
+    .. warning::
+
+        This operator is NOT idempotent. If you run it many times, many transfer
+        jobs will be created in the Google Cloud Platform.
+
+    **Example**:
+
+    .. code-block:: python
+
+       s3_to_gcs_transfer_op = S3ToGoogleCloudStorageTransferOperator(
+            task_id='s3_to_gcs_transfer_example',
+            s3_bucket='my-s3-bucket',
+            project_id='my-gcp-project',
+            gcs_bucket='my-gcs-bucket',
+            dag=my_dag)
+
+    :param s3_bucket: The S3 bucket where to find the objects. (templated)
+    :type s3_bucket: str
+    :param gcs_bucket: The destination Google Cloud Storage bucket
+        where you want to store the files. (templated)
+    :type gcs_bucket: str
+    :param project_id: Optional ID of the Google Cloud Platform Console project that
+        owns the job
+    :type project_id: str
+    :param aws_conn_id: The source S3 connection
+    :type aws_conn_id: str
+    :param gcp_conn_id: The destination connection ID to use
+        when connecting to Google Cloud Storage.
+    :type gcp_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+    :param description: Optional transfer service job description
+    :type description: str
+    :param schedule: Optional transfer service schedule;
+        If not set, run transfer job once as soon as the operator runs
+        The format is described
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
+        With two additional improvements:
+
+        * dates they can be passed as :class:`datetime.date`
+        * times they can be passed as :class:`datetime.time`
+
+    :type schedule: dict
+    :param object_conditions: Optional transfer service object conditions; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
+    :type object_conditions: dict
+    :param transfer_options: Optional transfer service transfer options; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
+    :type transfer_options: dict
+    :param wait: Wait for transfer to finish
+    :type wait: bool
+    :param timeout: Time to wait for the operation to end in seconds
+    :type timeout: int
+    """
+
+    template_fields = ('gcp_conn_id', 's3_bucket', 'gcs_bucket', 'description', 'object_conditions')
+    ui_color = '#e09411'
+
+    @apply_defaults
+    def __init__(
+        self,
+        s3_bucket,
+        gcs_bucket,
+        project_id=None,
+        aws_conn_id='aws_default',
+        gcp_conn_id='google_cloud_default',
+        delegate_to=None,
+        description=None,
+        schedule=None,
+        object_conditions=None,
+        transfer_options=None,
+        wait=True,
+        timeout=None,
+        *args,
+        **kwargs
+    ):
+
+        super(S3ToGoogleCloudStorageTransferOperator, self).__init__(*args, **kwargs)
+        self.s3_bucket = s3_bucket
+        self.gcs_bucket = gcs_bucket
+        self.project_id = project_id
+        self.aws_conn_id = aws_conn_id
+        self.gcp_conn_id = gcp_conn_id
+        self.delegate_to = delegate_to
+        self.description = description
+        self.schedule = schedule
+        self.object_conditions = object_conditions
+        self.transfer_options = transfer_options
+        self.wait = wait
+        self.timeout = timeout
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(gcp_conn_id=self.gcp_conn_id, delegate_to=self.delegate_to)
+        body = self._create_body()
+
+        TransferJobPreprocessor(body=body, aws_conn_id=self.aws_conn_id).process_body()
+
+        job = hook.create_transfer_job(body=body)
+
+        if self.wait:
+            hook.wait_for_transfer_job(job, timeout=self.timeout)
+
+    def _create_body(self):
+        body = {
+            DESCRIPTION: self.description,
+            STATUS: GcpTransferJobsStatus.ENABLED,
+            TRANSFER_SPEC: {
+                AWS_S3_DATA_SOURCE: {BUCKET_NAME: self.s3_bucket},
+                GCS_DATA_SINK: {BUCKET_NAME: self.gcs_bucket},
+            },
+        }
+
+        if self.project_id is not None:
+            body[PROJECT_ID] = self.project_id
+
+        if self.schedule is not None:
+            body[SCHEDULE] = self.schedule
+
+        if self.object_conditions is not None:
+            body[TRANSFER_SPEC][OBJECT_CONDITIONS] = self.object_conditions
+
+        if self.transfer_options is not None:
+            body[TRANSFER_SPEC][TRANSFER_OPTIONS] = self.transfer_options
+
+        return body
+
+
+class GoogleCloudStorageToGoogleCloudStorageTransferOperator(BaseOperator):
+    """
+    Copies objects from a bucket to another using the GCP Storage Transfer
+    Service.
+
+    .. warning::
+
+        This operator is NOT idempotent. If you run it many times, many transfer
+        jobs will be created in the Google Cloud Platform.
+
+    **Example**:
+
+    .. code-block:: python
+
+       gcs_to_gcs_transfer_op = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id='gcs_to_gcs_transfer_example',
+            source_bucket='my-source-bucket',
+            destination_bucket='my-destination-bucket',
+            project_id='my-gcp-project',
+            dag=my_dag)
+
+    :param source_bucket: The source Google cloud storage bucket where the
+         object is. (templated)
+    :type source_bucket: str
+    :param destination_bucket: The destination Google cloud storage bucket
+        where the object should be. (templated)
+    :type destination_bucket: str
+    :param project_id: The ID of the Google Cloud Platform Console project that
+        owns the job
+    :type project_id: str
+    :param gcp_conn_id: Optional connection ID to use when connecting to Google Cloud
+        Storage.
+    :type gcp_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+    :param description: Optional transfer service job description
+    :type description: str
+    :param schedule: Optional transfer service schedule;
+        If not set, run transfer job once as soon as the operator runs
+        See:
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
+        With two additional improvements:
+
+        * dates they can be passed as :class:`datetime.date`
+        * times they can be passed as :class:`datetime.time`
+
+    :type schedule: dict
+    :param object_conditions: Optional transfer service object conditions; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#ObjectConditions
+    :type object_conditions: dict
+    :param transfer_options: Optional transfer service transfer options; see
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#TransferOptions
+    :type transfer_options: dict
+    :param wait: Wait for transfer to finish; defaults to `True`
+    :type wait: bool
+    :param timeout: Time to wait for the operation to end in seconds
+    :type timeout: int
+    """
+
+    template_fields = (
+        'gcp_conn_id',
+        'source_bucket',
+        'destination_bucket',
+        'description',
+        'object_conditions',
+    )
+    ui_color = '#e09411'
+
+    @apply_defaults
+    def __init__(
+        self,
+        source_bucket,
+        destination_bucket,
+        project_id=None,
+        gcp_conn_id='google_cloud_default',
+        delegate_to=None,
+        description=None,
+        schedule=None,
+        object_conditions=None,
+        transfer_options=None,
+        wait=True,
+        timeout=None,
+        *args,
+        **kwargs
+    ):
+
+        super(GoogleCloudStorageToGoogleCloudStorageTransferOperator, self).__init__(*args, **kwargs)
+        self.source_bucket = source_bucket
+        self.destination_bucket = destination_bucket
+        self.project_id = project_id
+        self.gcp_conn_id = gcp_conn_id
+        self.delegate_to = delegate_to
+        self.description = description
+        self.schedule = schedule
+        self.object_conditions = object_conditions
+        self.transfer_options = transfer_options
+        self.wait = wait
+        self.timeout = timeout
+
+    def execute(self, context):
+        hook = GCPTransferServiceHook(gcp_conn_id=self.gcp_conn_id, delegate_to=self.delegate_to)
+
+        body = self._create_body()
+
+        TransferJobPreprocessor(body=body).process_body()
+
+        job = hook.create_transfer_job(body=body)
+
+        if self.wait:
+            hook.wait_for_transfer_job(job, timeout=self.timeout)
+
+    def _create_body(self):
+        body = {
+            DESCRIPTION: self.description,
+            STATUS: GcpTransferJobsStatus.ENABLED,
+            TRANSFER_SPEC: {
+                GCS_DATA_SOURCE: {BUCKET_NAME: self.source_bucket},
+                GCS_DATA_SINK: {BUCKET_NAME: self.destination_bucket},
+            },
+        }
+
+        if self.project_id is not None:
+            body[PROJECT_ID] = self.project_id
+
+        if self.schedule is not None:
+            body[SCHEDULE] = self.schedule
+
+        if self.object_conditions is not None:
+            body[TRANSFER_SPEC][OBJECT_CONDITIONS] = self.object_conditions
+
+        if self.transfer_options is not None:
+            body[TRANSFER_SPEC][TRANSFER_OPTIONS] = self.transfer_options
+
+        return body
diff --git a/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py b/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
index 410d65821d205..41be57a1bbfed 100644
--- a/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
+++ b/airflow/contrib/operators/gcs_to_gcs_transfer_operator.py
@@ -16,112 +16,13 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+import warnings
 
-from airflow.models import BaseOperator
-from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
-from airflow.utils.decorators import apply_defaults
+from airflow.contrib.operators.gcp_transfer_operator import (  # noqa
+    GoogleCloudStorageToGoogleCloudStorageTransferOperator,
+)
 
-
-class GoogleCloudStorageToGoogleCloudStorageTransferOperator(BaseOperator):
-    """
-    Copies objects from a bucket to another using the GCP Storage Transfer
-    Service.
-
-    :param source_bucket: The source Google cloud storage bucket where the
-         object is. (templated)
-    :type source_bucket: str
-    :param destination_bucket: The destination Google cloud storage bucket
-        where the object should be. (templated)
-    :type destination_bucket: str
-    :param project_id: The ID of the Google Cloud Platform Console project that
-        owns the job
-    :type project_id: str
-    :param gcp_conn_id: Optional connection ID to use when connecting to Google Cloud
-        Storage.
-    :type gcp_conn_id: str
-    :param delegate_to: The account to impersonate, if any.
-        For this to work, the service account making the request must have
-        domain-wide delegation enabled.
-    :type delegate_to: str
-    :param description: Optional transfer service job description
-    :type description: str
-    :param schedule: Optional transfer service schedule; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
-        If not set, run transfer job once as soon as the operator runs
-    :type schedule: dict
-    :param object_conditions: Optional transfer service object conditions; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#ObjectConditions
-    :type object_conditions: dict
-    :param transfer_options: Optional transfer service transfer options; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec#TransferOptions
-    :type transfer_options: dict
-    :param wait: Wait for transfer to finish; defaults to `True`
-    :type wait: bool
-
-    **Example**:
-
-    .. code-block:: python
-
-       gcs_to_gcs_transfer_op = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
-            task_id='gcs_to_gcs_transfer_example',
-            source_bucket='my-source-bucket',
-            destination_bucket='my-destination-bucket',
-            project_id='my-gcp-project',
-            dag=my_dag)
-    """
-
-    template_fields = ('source_bucket', 'destination_bucket', 'description', 'object_conditions')
-    ui_color = '#e09411'
-
-    @apply_defaults
-    def __init__(self,
-                 source_bucket,
-                 destination_bucket,
-                 project_id=None,
-                 gcp_conn_id='google_cloud_default',
-                 delegate_to=None,
-                 description=None,
-                 schedule=None,
-                 object_conditions=None,
-                 transfer_options=None,
-                 wait=True,
-                 *args,
-                 **kwargs):
-
-        super(GoogleCloudStorageToGoogleCloudStorageTransferOperator, self).__init__(
-            *args,
-            **kwargs)
-        self.source_bucket = source_bucket
-        self.destination_bucket = destination_bucket
-        self.project_id = project_id
-        self.gcp_conn_id = gcp_conn_id
-        self.delegate_to = delegate_to
-        self.description = description
-        self.schedule = schedule
-        self.object_conditions = object_conditions or {}
-        self.transfer_options = transfer_options or {}
-        self.wait = wait
-
-    def execute(self, context):
-        transfer_hook = GCPTransferServiceHook(
-            gcp_conn_id=self.gcp_conn_id,
-            delegate_to=self.delegate_to)
-
-        job = transfer_hook.create_transfer_job(
-            project_id=self.project_id,
-            description=self.description,
-            schedule=self.schedule,
-            transfer_spec={
-                'gcsDataSource': {
-                    'bucketName': self.source_bucket,
-                },
-                'gcsDataSink': {
-                    'bucketName': self.destination_bucket,
-                },
-                'objectConditions': self.object_conditions,
-                'transferOptions': self.transfer_options,
-            }
-        )
-
-        if self.wait:
-            transfer_hook.wait_for_transfer_job(job)
+warnings.warn(
+    "This module is deprecated. Please use `airflow.contrib.operators.gcp_transfer_operator`",
+    DeprecationWarning,
+)
diff --git a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
index c46a9460e701c..aaae9bff2111e 100644
--- a/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
+++ b/airflow/contrib/operators/s3_to_gcs_transfer_operator.py
@@ -16,122 +16,11 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+import warnings
 
-from airflow.models import BaseOperator
-from airflow.hooks.S3_hook import S3Hook
-from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
-from airflow.utils.decorators import apply_defaults
+from airflow.contrib.operators.gcp_transfer_operator import S3ToGoogleCloudStorageTransferOperator  # noqa
 
-
-class S3ToGoogleCloudStorageTransferOperator(BaseOperator):
-    """
-    Synchronizes an S3 bucket with a Google Cloud Storage bucket using the
-    GCP Storage Transfer Service.
-
-    :param s3_bucket: The S3 bucket where to find the objects. (templated)
-    :type s3_bucket: str
-    :param gcs_bucket: The destination Google Cloud Storage bucket
-        where you want to store the files. (templated)
-    :type gcs_bucket: str
-    :param project_id: Optional ID of the Google Cloud Platform Console project that
-        owns the job
-    :type project_id: str
-    :param aws_conn_id: The source S3 connection
-    :type aws_conn_id: str
-    :param gcp_conn_id: The destination connection ID to use
-        when connecting to Google Cloud Storage.
-    :type gcp_conn_id: str
-    :param delegate_to: The account to impersonate, if any.
-        For this to work, the service account making the request must have
-        domain-wide delegation enabled.
-    :type delegate_to: str
-    :param description: Optional transfer service job description
-    :type description: str
-    :param schedule: Optional transfer service schedule; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs.
-        If not set, run transfer job once as soon as the operator runs
-    :type schedule: dict
-    :param object_conditions: Optional transfer service object conditions; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
-    :type object_conditions: dict
-    :param transfer_options: Optional transfer service transfer options; see
-        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/TransferSpec
-    :type transfer_options: dict
-    :param wait: Wait for transfer to finish
-    :type wait: bool
-
-    **Example**:
-
-    .. code-block:: python
-
-       s3_to_gcs_transfer_op = S3ToGoogleCloudStorageTransferOperator(
-            task_id='s3_to_gcs_transfer_example',
-            s3_bucket='my-s3-bucket',
-            project_id='my-gcp-project',
-            gcs_bucket='my-gcs-bucket',
-            dag=my_dag)
-    """
-
-    template_fields = ('s3_bucket', 'gcs_bucket', 'description', 'object_conditions')
-    ui_color = '#e09411'
-
-    @apply_defaults
-    def __init__(self,
-                 s3_bucket,
-                 gcs_bucket,
-                 project_id=None,
-                 aws_conn_id='aws_default',
-                 gcp_conn_id='google_cloud_default',
-                 delegate_to=None,
-                 description=None,
-                 schedule=None,
-                 object_conditions=None,
-                 transfer_options=None,
-                 wait=True,
-                 *args,
-                 **kwargs):
-
-        super(S3ToGoogleCloudStorageTransferOperator, self).__init__(
-            *args,
-            **kwargs)
-        self.s3_bucket = s3_bucket
-        self.gcs_bucket = gcs_bucket
-        self.project_id = project_id
-        self.aws_conn_id = aws_conn_id
-        self.gcp_conn_id = gcp_conn_id
-        self.delegate_to = delegate_to
-        self.description = description
-        self.schedule = schedule
-        self.object_conditions = object_conditions or {}
-        self.transfer_options = transfer_options or {}
-        self.wait = wait
-
-    def execute(self, context):
-        transfer_hook = GCPTransferServiceHook(
-            gcp_conn_id=self.gcp_conn_id,
-            delegate_to=self.delegate_to)
-
-        s3_creds = S3Hook(aws_conn_id=self.aws_conn_id).get_credentials()
-
-        job = transfer_hook.create_transfer_job(
-            project_id=self.project_id,
-            description=self.description,
-            schedule=self.schedule,
-            transfer_spec={
-                'awsS3DataSource': {
-                    'bucketName': self.s3_bucket,
-                    'awsAccessKey': {
-                        'accessKeyId': s3_creds.access_key,
-                        'secretAccessKey': s3_creds.secret_key,
-                    }
-                },
-                'gcsDataSink': {
-                    'bucketName': self.gcs_bucket,
-                },
-                'objectConditions': self.object_conditions,
-                'transferOptions': self.transfer_options,
-            }
-        )
-
-        if self.wait:
-            transfer_hook.wait_for_transfer_job(job)
+warnings.warn(
+    "This module is deprecated. Please use `airflow.contrib.operators.gcp_transfer_operator`",
+    DeprecationWarning,
+)
diff --git a/airflow/contrib/sensors/gcp_transfer_sensor.py b/airflow/contrib/sensors/gcp_transfer_sensor.py
new file mode 100644
index 0000000000000..a6a1c73c39dea
--- /dev/null
+++ b/airflow/contrib/sensors/gcp_transfer_sensor.py
@@ -0,0 +1,80 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import six
+
+from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
+from airflow.sensors.base_sensor_operator import BaseSensorOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class GCPTransferServiceWaitForJobStatusSensor(BaseSensorOperator):
+    """
+    Waits for at least one operation belonging to the job to have the
+    expected status.
+
+    :param job_name: The name of the transfer job
+    :type job_name: str
+    :param expected_statuses: The expected state of the operation.
+        See:
+        https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations#Status
+    :type expected_statuses: set[str] or string
+    :param project_id: (Optional) the ID of the project that owns the Transfer
+        Job. If set to None or missing, the default project_id from the GCP
+        connection is used.
+    :type project_id: str
+    :param gcp_conn_id: The connection ID used to connect to Google Cloud
+        Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START gcp_transfer_job_sensor_template_fields]
+    template_fields = ('job_name',)
+    # [END gcp_transfer_job_sensor_template_fields]
+
+    @apply_defaults
+    def __init__(
+        self,
+        job_name,
+        expected_statuses,
+        project_id=None,
+        gcp_conn_id='google_cloud_default',
+        *args,
+        **kwargs
+    ):
+        super(GCPTransferServiceWaitForJobStatusSensor, self).__init__(*args, **kwargs)
+        self.job_name = job_name
+        self.expected_statuses = (
+            {expected_statuses} if isinstance(expected_statuses, six.string_types) else expected_statuses
+        )
+        self.project_id = project_id
+        self.gcp_cloud_conn_id = gcp_conn_id
+
+    def poke(self, context):
+        hook = GCPTransferServiceHook(gcp_conn_id=self.gcp_cloud_conn_id)
+        operations = hook.list_transfer_operations(
+            filter={'project_id': self.project_id, 'job_names': [self.job_name]}
+        )
+
+        check = GCPTransferServiceHook.operations_contain_expected_statuses(
+            operations=operations, expected_statuses=self.expected_statuses
+        )
+        if check:
+            self.xcom_push(key="sensed_operations", value=operations, context=context)
+
+        return check
diff --git a/docs/code.rst b/docs/code.rst
index 277ec9b6382d6..368c2e9e00b59 100644
--- a/docs/code.rst
+++ b/docs/code.rst
@@ -170,6 +170,19 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
 .. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
+.. autoclass:: airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
 .. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
 .. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
@@ -208,19 +221,14 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
 .. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobCreateOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobDeleteOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobUpdateOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationCancelOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationGetOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationPauseOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationResumeOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationsListOperator
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
 .. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
@@ -228,7 +236,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.gcs_to_s3.GoogleCloudStorageToS3Operator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPIOperator
 .. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPISendRoomNotificationOperator
@@ -257,7 +265,7 @@ Operators
 .. autoclass:: airflow.contrib.operators.s3_delete_objects_operator.S3DeleteObjectsOperator
 .. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
 .. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.s3_to_gcs_transfer_operator.S3ToGoogleCloudStorageTransferOperator
+.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.S3ToGoogleCloudStorageTransferOperator
 .. autoclass:: airflow.contrib.operators.s3_to_sftp_operator.S3ToSFTPOperator
 .. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
 .. autoclass:: airflow.contrib.operators.sftp_to_s3_operator.SFTPToS3Operator
@@ -302,6 +310,7 @@ Sensors
 .. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSSensor
 .. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSensor
 .. autoclass:: airflow.contrib.sensors.file_sensor.FileSensor
+.. autoclass:: airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceWaitForJobStatusSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectUpdatedSensor
 .. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStoragePrefixSensor
@@ -495,6 +504,7 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
 .. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
+.. autoclass:: airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook
 .. autoclass:: airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook
 .. autoclass:: airflow.contrib.hooks.cloudant_hook.CloudantHook
 .. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
@@ -513,7 +523,6 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
 .. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
 .. autoclass:: airflow.contrib.hooks.gcp_kms_hook.GoogleCloudKMSHook
-.. autoclass:: airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook
 .. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
 .. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
 .. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
@@ -530,7 +539,6 @@ Community contributed hooks
 .. autoclass:: airflow.contrib.hooks.sftp_hook.SFTPHook
 .. autoclass:: airflow.contrib.hooks.ssh_hook.SSHHook
 .. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
-.. autoclass:: airflow.contrib.hooks.salesforce_hook.SalesforceHook
 .. autoclass:: airflow.contrib.hooks.segment_hook.SegmentHook
 .. autoclass:: airflow.contrib.hooks.slack_webhook_hook.SlackWebhookHook
 .. autoclass:: airflow.contrib.hooks.snowflake_hook.SnowflakeHook
diff --git a/docs/howto/operator/gcp/transfer.rst b/docs/howto/operator/gcp/transfer.rst
new file mode 100644
index 0000000000000..0385bc9bcf3fb
--- /dev/null
+++ b/docs/howto/operator/gcp/transfer.rst
@@ -0,0 +1,420 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Transfer Service Operators
+=======================================
+
+.. contents::
+  :depth: 1
+  :local:
+
+.. _howto/operator:GcpTransferServiceJobCreateOperator:
+
+GcpTransferServiceJobCreateOperator
+-----------------------------------
+
+Create a transfer job.
+
+The function accepts dates in two formats:
+
+- consistent with `Google API <https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs#TimeOfDay>`_ ::
+
+    { "year": 2019, "month": 2, "day": 11 }
+
+- as an :class:`~datetime.datetime` object
+
+The function accepts time in two formats:
+
+- consistent with `Google API <https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs#TimeOfDay>`_ ::
+
+    { "hours": 12, "minutes": 30, "seconds": 0 }
+
+- as an :class:`~datetime.time` object
+
+If you want to create a job transfer that copies data from AWS S3 then you must have a connection configured. Information about configuration for AWS is available: :doc:`../../connection/aws`
+The selected connection for AWS can be indicated by the parameter ``aws_conn_id``.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_create_job_body_gcp]
+      :end-before: [END howto_operator_gcp_transfer_create_job_body_gcp]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_create_job_body_aws]
+      :end-before: [END howto_operator_gcp_transfer_create_job_body_aws]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_create_job]
+      :end-before: [END howto_operator_gcp_transfer_create_job]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_job_create_template_fields]
+    :end-before: [END gcp_transfer_job_create_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferJobs.create
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/create>`_.
+
+.. _howto/operator:GcpTransferServiceJobDeleteOperator:
+
+GcpTransferServiceJobDeleteOperator
+-----------------------------------
+
+Deletes a transfer job.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_delete_job]
+      :end-before: [END howto_operator_gcp_transfer_delete_job]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_job_delete_template_fields]
+    :end-before: [END gcp_transfer_job_delete_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - REST Resource: transferJobs - Status
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs#Status>`_
+
+.. _howto/operator:GcpTransferServiceJobUpdateOperator:
+
+GcpTransferServiceJobUpdateOperator
+-----------------------------------
+
+Updates a transfer job.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_update_job_body]
+      :end-before: [END howto_operator_gcp_transfer_update_job_body]
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_update_job]
+      :end-before: [END howto_operator_gcp_transfer_update_job]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_job_update_template_fields]
+    :end-before: [END gcp_transfer_job_update_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferJobs.patch
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferJobs/patch>`_
+
+.. _howto/operator:GcpTransferServiceOperationCancelOperator:
+
+GcpTransferServiceOperationCancelOperator
+-----------------------------------------
+
+Gets a transfer operation. The result is returned to XCOM.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_cancel_operation]
+      :end-before: [END howto_operator_gcp_transfer_cancel_operation]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_operation_cancel_template_fields]
+    :end-before: [END gcp_transfer_operation_cancel_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferOperations.cancel
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations/cancel>`_
+
+
+.. _howto/operator:GcpTransferServiceOperationGetOperator:
+
+GcpTransferServiceOperationGetOperator
+--------------------------------------
+
+Gets a transfer operation. The result is returned to XCOM.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_get_operation]
+      :end-before: [END howto_operator_gcp_transfer_get_operation]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_operation_get_template_fields]
+    :end-before: [END gcp_transfer_operation_get_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferOperations.get
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations/get>`_
+
+.. _howto/operator:GcpTransferServiceOperationsListOperator:
+
+GcpTransferServiceOperationsListOperator
+----------------------------------------
+
+List a transfer operations. The result is returned to XCOM.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_list_operations]
+      :end-before: [END howto_operator_gcp_transfer_list_operations]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_operations_list_template_fields]
+    :end-before: [END gcp_transfer_operations_list_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferOperations.list
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations/list>`_
+
+.. _howto/operator:GcpTransferServiceOperationPauseOperator:
+
+GcpTransferServiceOperationPauseOperator
+----------------------------------------
+
+Pauses a transfer operations.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_pause_operation]
+      :end-before: [END howto_operator_gcp_transfer_pause_operation]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_operation_pause_template_fields]
+    :end-before: [END gcp_transfer_operation_pause_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferOperations.pause
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations/pause>`_
+
+.. _howto/operator:GcpTransferServiceOperationResumeOperator:
+
+GcpTransferServiceOperationResumeOperator
+-----------------------------------------
+
+Resumes a transfer operations.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_resume_operation]
+      :end-before: [END howto_operator_gcp_transfer_resume_operation]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_operation_resume_template_fields]
+    :end-before: [END gcp_transfer_operation_resume_template_fields]
+
+More information
+""""""""""""""""
+
+See `Google Cloud Transfer Service - Method: transferOperations.resume
+<https://cloud.google.com/storage-transfer/docs/reference/rest/v1/transferOperations/resume>`_
+
+
+GCPTransferServiceWaitForJobStatusSensor
+----------------------------------------
+
+Waits for at least one operation belonging to the job to have the expected status.
+
+Arguments
+"""""""""
+
+Some arguments in the example DAG are taken from the OS environment variables:
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :start-after: [START howto_operator_gcp_transfer_common_variables]
+      :end-before: [END howto_operator_gcp_transfer_common_variables]
+
+Using the operator
+""""""""""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+      :language: python
+      :dedent: 4
+      :start-after: [START howto_operator_gcp_transfer_wait_operation]
+      :end-before: [END howto_operator_gcp_transfer_wait_operation]
+
+Templating
+""""""""""
+
+.. literalinclude:: ../../../../airflow/contrib/sensors/gcp_transfer_sensor.py
+    :language: python
+    :dedent: 4
+    :start-after: [START gcp_transfer_job_sensor_template_fields]
+    :end-before: [END gcp_transfer_job_sensor_template_fields]
diff --git a/docs/integration.rst b/docs/integration.rst
index 4e9975e14cedc..67a7f56ffd9c9 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -584,8 +584,31 @@ They also use :class:`airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook` to
 Transfer Service
 ''''''''''''''''
 
-:class:`airflow.contrib.operators.gcs_to_gcs_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator`
-    Copies objects from a bucket to another using Google Transfer service.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobDeleteOperator`
+    Deletes a transfer job.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobCreateOperator`
+    Creates a transfer job.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobUpdateOperator`
+    Updates a transfer job.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationCancelOperator`
+    Cancels a transfer operation.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationGetOperator`
+    Gets a transfer operation.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationPauseOperator`
+    Pauses a transfer operation
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationResumeOperator`
+    Resumes a transfer operation.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationsListOperator`
+    Gets a list of transfer operations.
+:class:`airflow.contrib.operators.gcp_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator`
+    Copies objects from a Google Cloud Storage bucket to another bucket.
+:class:`airflow.contrib.operators.gcp_transfer_operator.S3ToGoogleCloudStorageTransferOperator`
+    Synchronizes an S3 bucket with a Google Cloud Storage bucket.
+
+
+:class:`airflow.contrib.sensors.gcp_transfer_operator.GCPTransferServiceWaitForJobStatusSensor`
+    Waits for at least one operation belonging to the job to have the
+    expected status.
 
 
 They also use :class:`airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook` to communicate with Google Cloud Platform.
diff --git a/tests/contrib/hooks/test_gcp_api_base_hook.py b/tests/contrib/hooks/test_gcp_api_base_hook.py
index b22e8c0881240..35c95ecc8a04f 100644
--- a/tests/contrib/hooks/test_gcp_api_base_hook.py
+++ b/tests/contrib/hooks/test_gcp_api_base_hook.py
@@ -26,11 +26,15 @@
 from google.cloud.exceptions import MovedPermanently
 
 from airflow import AirflowException, LoggingMixin
+from googleapiclient.errors import HttpError
+
 from airflow.contrib.hooks import gcp_api_base_hook as hook
 
 import google.auth
 from google.auth.exceptions import GoogleAuthError
 
+from airflow.hooks.base_hook import BaseHook
+
 try:
     from StringIO import StringIO
 except ImportError:
@@ -100,22 +104,36 @@ def test_fixutre(*args, **kwargs):
 
         self.assertTrue(self.called)
 
+    def test_raise_http_error(self):
+        self.called = False
+
+        class FixtureClass(BaseHook):
+            @hook.GoogleCloudBaseHook.catch_http_exception
+            def test_fixtue(*args, **kwargs):
+                self.called = True
+                raise HttpError(mock.Mock(**{"reason.return_value": None}), b"CONTENT")
+
+        with self.assertRaises(AirflowException):
+            FixtureClass(None).test_fixtue()
+
+        self.assertTrue(self.called)
+
 
 class TestGoogleCloudBaseHook(unittest.TestCase):
     def setUp(self):
         self.instance = hook.GoogleCloudBaseHook()
 
-    @unittest.skipIf(
-        not default_creds_available,
-        'Default GCP credentials not available to run tests')
+    @unittest.skipIf(not default_creds_available, 'Default GCP credentials not available to run tests')
     def test_default_creds_with_scopes(self):
         self.instance.extras = {
             'extra__google_cloud_platform__project': default_project,
             'extra__google_cloud_platform__scope': (
-                ','.join((
-                    'https://www.googleapis.com/auth/bigquery',
-                    'https://www.googleapis.com/auth/devstorage.read_only',
-                ))
+                ','.join(
+                    (
+                        'https://www.googleapis.com/auth/bigquery',
+                        'https://www.googleapis.com/auth/devstorage.read_only',
+                    )
+                )
             ),
         }
 
diff --git a/tests/contrib/hooks/test_gcp_transfer_hook.py b/tests/contrib/hooks/test_gcp_transfer_hook.py
index e42550979d836..eeb42d2b737aa 100644
--- a/tests/contrib/hooks/test_gcp_transfer_hook.py
+++ b/tests/contrib/hooks/test_gcp_transfer_hook.py
@@ -18,125 +18,583 @@
 # under the License.
 #
 import json
-import datetime
 import unittest
+from copy import deepcopy
 
-from airflow.exceptions import AirflowException
-from airflow.contrib.hooks.gcp_transfer_hook import GCPTransferServiceHook
-from airflow.contrib.hooks.gcp_transfer_hook import TIME_TO_SLEEP_IN_SECONDS
+import six
+from parameterized import parameterized
 
+from airflow import AirflowException
+from airflow.contrib.hooks.gcp_transfer_hook import (
+    GCPTransferServiceHook,
+    TIME_TO_SLEEP_IN_SECONDS,
+    GcpTransferOperationStatus,
+    GcpTransferJobsStatus,
+    PROJECT_ID,
+    STATUS,
+    DESCRIPTION,
+    FILTER_PROJECT_ID,
+    FILTER_JOB_NAMES,
+    TRANSFER_JOBS,
+    OPERATIONS,
+    METADATA,
+    TRANSFER_JOB,
+    TRANSFER_JOB_FIELD_MASK,
+)
+from tests.contrib.utils.base_gcp_mock import (
+    mock_base_gcp_hook_no_default_project_id,
+    mock_base_gcp_hook_default_project_id,
+)
+
+NAME = "name"
 try:
     from unittest import mock
-except ImportError:
+except ImportError:  # pragma: no cover
     try:
         import mock
     except ImportError:
         mock = None
 
+TEST_PROJECT_ID = 'project-id'
+TEST_BODY = {DESCRIPTION: 'AAA', PROJECT_ID: TEST_PROJECT_ID}
+
+TEST_TRANSFER_JOB_NAME = "transfer-job"
+TEST_TRANSFER_OPERATION_NAME = "transfer-operation"
+
+TEST_TRANSFER_JOB = {NAME: TEST_TRANSFER_JOB_NAME}
+TEST_TRANSFER_OPERATION = {NAME: TEST_TRANSFER_OPERATION_NAME}
+
+TEST_TRANSFER_JOB_FILTER = {FILTER_PROJECT_ID: TEST_PROJECT_ID, FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME]}
+TEST_TRANSFER_OPERATION_FILTER = {
+    FILTER_PROJECT_ID: TEST_PROJECT_ID,
+    FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME],
+}
+TEST_UPDATE_TRANSFER_JOB_BODY = {
+    TRANSFER_JOB: {DESCRIPTION: 'description-1'},
+    PROJECT_ID: TEST_PROJECT_ID,
+    TRANSFER_JOB_FIELD_MASK: 'description',
+}
 
-class TestGCPTransferServiceHook(unittest.TestCase):
+
+def _without_key(body, key):
+    obj = deepcopy(body)
+    del obj[key]
+    return obj
+
+
+class TestGCPTransferServiceHookWithPassedProjectId(unittest.TestCase):
     def setUp(self):
-        with mock.patch.object(GCPTransferServiceHook, '__init__', return_value=None):
-            self.conn = mock.Mock()
-            self.transfer_hook = GCPTransferServiceHook()
-            self.transfer_hook._conn = self.conn
-
-    def test_create_transfer_job(self):
-        mock_create = self.conn.transferJobs.return_value.create
-        mock_execute = mock_create.return_value.execute
-        mock_execute.return_value = {
-            'projectId': 'test-project',
-            'name': 'transferJobs/test-job',
-        }
-        now = datetime.datetime.utcnow()
-        transfer_spec = {
-            'awsS3DataSource': {'bucketName': 'test-s3-bucket'},
-            'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
-        }
-        self.transfer_hook.create_transfer_job(
-            project_id='test-project',
-            description='test-description',
-            schedule=None,
-            transfer_spec=transfer_spec)
-        mock_create.assert_called_once_with(body={
-            'status': 'ENABLED',
-            'projectId': 'test-project',
-            'description': 'test-description',
-            'transferSpec': transfer_spec,
-            'schedule': {
-                'scheduleStartDate': {
-                    'day': now.day,
-                    'month': now.month,
-                    'year': now.year,
-                },
-                'scheduleEndDate': {
-                    'day': now.day,
-                    'month': now.month,
-                    'year': now.year,
-                }
-            }
-        })
-
-    def test_create_transfer_job_custom_schedule(self):
-        mock_create = self.conn.transferJobs.return_value.create
-        mock_execute = mock_create.return_value.execute
-        mock_execute.return_value = {
-            'projectId': 'test-project',
-            'name': 'transferJobs/test-job',
-        }
-        schedule = {
-            'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
-            'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
-        }
-        transfer_spec = {
-            'awsS3DataSource': {'bucketName': 'test-s3-bucket'},
-            'gcsDataSink': {'bucketName': 'test-gcs-bucket'}
+        with mock.patch(
+            'airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+            new=mock_base_gcp_hook_no_default_project_id,
+        ):
+            self.gct_hook = GCPTransferServiceHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_create_transfer_job(self, get_conn):
+        create_method = get_conn.return_value.transferJobs.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        res = self.gct_hook.create_transfer_job(body=TEST_BODY)
+        self.assertEqual(res, TEST_TRANSFER_JOB)
+        create_method.assert_called_once_with(body=TEST_BODY)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_get_transfer_job(self, get_conn):
+        get_method = get_conn.return_value.transferJobs.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        res = self.gct_hook.get_transfer_job(job_name=TEST_TRANSFER_JOB_NAME, project_id=TEST_PROJECT_ID)
+        self.assertIsNotNone(res)
+        self.assertEqual(TEST_TRANSFER_JOB_NAME, res[NAME])
+        get_method.assert_called_once_with(jobName=TEST_TRANSFER_JOB_NAME, projectId=TEST_PROJECT_ID)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_job(self, get_conn):
+        list_method = get_conn.return_value.transferJobs.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {TRANSFER_JOBS: [TEST_TRANSFER_JOB]}
+
+        list_next = get_conn.return_value.transferJobs.return_value.list_next
+        list_next.return_value = None
+
+        res = self.gct_hook.list_transfer_job(filter=TEST_TRANSFER_JOB_FILTER)
+        self.assertIsNotNone(res)
+        self.assertEqual(res, [TEST_TRANSFER_JOB])
+        list_method.assert_called_once_with(filter=mock.ANY)
+        args, kwargs = list_method.call_args_list[0]
+        self.assertEqual(
+            json.loads(kwargs['filter']),
+            {FILTER_PROJECT_ID: TEST_PROJECT_ID, FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME]},
+        )
+        list_execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_update_transfer_job(self, get_conn):
+        update_method = get_conn.return_value.transferJobs.return_value.patch
+        execute_method = update_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        res = self.gct_hook.update_transfer_job(
+            job_name=TEST_TRANSFER_JOB_NAME, body=TEST_UPDATE_TRANSFER_JOB_BODY
+        )
+        self.assertIsNotNone(res)
+        update_method.assert_called_once_with(
+            jobName=TEST_TRANSFER_JOB_NAME, body=TEST_UPDATE_TRANSFER_JOB_BODY
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_delete_transfer_job(self, get_conn):
+        update_method = get_conn.return_value.transferJobs.return_value.patch
+        execute_method = update_method.return_value.execute
+
+        self.gct_hook.delete_transfer_job(job_name=TEST_TRANSFER_JOB_NAME, project_id=TEST_PROJECT_ID)
+
+        update_method.assert_called_once_with(
+            jobName=TEST_TRANSFER_JOB_NAME,
+            body={
+                PROJECT_ID: TEST_PROJECT_ID,
+                TRANSFER_JOB: {STATUS: GcpTransferJobsStatus.DELETED},
+                TRANSFER_JOB_FIELD_MASK: STATUS,
+            },
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_cancel_transfer_operation(self, get_conn):
+        cancel_method = get_conn.return_value.transferOperations.return_value.cancel
+        execute_method = cancel_method.return_value.execute
+
+        self.gct_hook.cancel_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        cancel_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_get_transfer_operation(self, get_conn):
+        get_method = get_conn.return_value.transferOperations.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_OPERATION
+        res = self.gct_hook.get_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        self.assertEqual(res, TEST_TRANSFER_OPERATION)
+        get_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_operation(self, get_conn):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {OPERATIONS: [TEST_TRANSFER_OPERATION]}
+
+        list_next = get_conn.return_value.transferOperations.return_value.list_next
+        list_next.return_value = None
+
+        res = self.gct_hook.list_transfer_operations(filter=TEST_TRANSFER_OPERATION_FILTER)
+        self.assertIsNotNone(res)
+        self.assertEqual(res, [TEST_TRANSFER_OPERATION])
+        list_method.assert_called_once_with(filter=mock.ANY, name='transferOperations')
+        args, kwargs = list_method.call_args_list[0]
+        self.assertEqual(
+            json.loads(kwargs['filter']),
+            {FILTER_PROJECT_ID: TEST_PROJECT_ID, FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME]},
+        )
+        list_execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_pause_transfer_operation(self, get_conn):
+        pause_method = get_conn.return_value.transferOperations.return_value.pause
+        execute_method = pause_method.return_value.execute
+
+        self.gct_hook.pause_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        pause_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_resume_transfer_operation(self, get_conn):
+        resume_method = get_conn.return_value.transferOperations.return_value.resume
+        execute_method = resume_method.return_value.execute
+
+        self.gct_hook.resume_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        resume_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('time.sleep')
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_wait_for_transfer_job(self, get_conn, mock_sleep):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.side_effect = [
+            {OPERATIONS: [{METADATA: {STATUS: GcpTransferOperationStatus.IN_PROGRESS}}]},
+            {OPERATIONS: [{METADATA: {STATUS: GcpTransferOperationStatus.SUCCESS}}]},
+        ]
+        get_conn.return_value.transferOperations.return_value.list_next.return_value = None
+
+        self.gct_hook.wait_for_transfer_job({PROJECT_ID: TEST_PROJECT_ID, 'name': 'transferJobs/test-job'})
+        self.assertTrue(list_method.called)
+
+        list_method.assert_called_with(name='transferOperations', filter=mock.ANY)
+        args, kwargs = list_method.call_args_list[0]
+        self.assertEqual(
+            json.loads(kwargs['filter']),
+            {FILTER_PROJECT_ID: TEST_PROJECT_ID, FILTER_JOB_NAMES: ["transferJobs/test-job"]},
+        )
+
+        mock_sleep.assert_called_once_with(TIME_TO_SLEEP_IN_SECONDS)
+
+    @mock.patch('time.sleep')
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_wait_for_transfer_job_failed(self, get_conn, mock_sleep):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {
+            OPERATIONS: [
+                {NAME: TEST_TRANSFER_OPERATION_NAME, METADATA: {STATUS: GcpTransferOperationStatus.FAILED}}
+            ]
         }
-        self.transfer_hook.create_transfer_job(
-            project_id='test-project',
-            description='test-description',
-            schedule=schedule,
-            transfer_spec=transfer_spec)
-        mock_create.assert_called_once_with(body={
-            'status': 'ENABLED',
-            'projectId': 'test-project',
-            'description': 'test-description',
-            'transferSpec': transfer_spec,
-            'schedule': schedule,
-        })
+
+        get_conn.return_value.transferOperations.return_value.list_next.return_value = None
+
+        with self.assertRaises(AirflowException):
+            self.gct_hook.wait_for_transfer_job({PROJECT_ID: TEST_PROJECT_ID, NAME: 'transferJobs/test-job'})
+            self.assertTrue(list_method.called)
 
     @mock.patch('time.sleep')
-    def test_wait_for_transfer_job(self, mock_sleep):
-        mock_list = self.conn.transferOperations.return_value.list
-        mock_execute = mock_list.return_value.execute
-        mock_execute.side_effect = [
-            {'operations': [{'metadata': {'status': 'IN_PROGRESS'}}]},
-            {'operations': [{'metadata': {'status': 'SUCCESS'}}]},
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_wait_for_transfer_job_expect_failed(self, get_conn, mock_sleep):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {
+            OPERATIONS: [
+                {NAME: TEST_TRANSFER_OPERATION_NAME, METADATA: {STATUS: GcpTransferOperationStatus.FAILED}}
+            ]
+        }
+
+        get_conn.return_value.transferOperations.return_value.list_next.return_value = None
+        with six.assertRaisesRegex(
+            self, AirflowException, "An unexpected operation status was encountered. Expected: SUCCESS"
+        ):
+            self.gct_hook.wait_for_transfer_job(
+                job={PROJECT_ID: 'test-project', NAME: 'transferJobs/test-job'},
+                expected_statuses=GcpTransferOperationStatus.SUCCESS,
+            )
+
+    @parameterized.expand(
+        [
+            ([GcpTransferOperationStatus.ABORTED], (GcpTransferOperationStatus.IN_PROGRESS,)),
+            (
+                [GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.IN_PROGRESS,),
+            ),
+            (
+                [GcpTransferOperationStatus.PAUSED, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.IN_PROGRESS,),
+            ),
+            ([GcpTransferOperationStatus.ABORTED], (GcpTransferOperationStatus.IN_PROGRESS,)),
+            (
+                [GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.IN_PROGRESS,),
+            ),
+            (
+                [GcpTransferOperationStatus.PAUSED, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.IN_PROGRESS,),
+            ),
         ]
-        self.transfer_hook.wait_for_transfer_job({
-            'projectId': 'test-project',
-            'name': 'transferJobs/test-job',
-        })
-        self.assertTrue(mock_list.called)
-        list_args, list_kwargs = mock_list.call_args_list[0]
-        self.assertEqual(list_kwargs.get('name'), 'transferOperations')
+    )
+    def test_operations_contain_expected_statuses_red_path(self, statuses, expected_statuses):
+        operations = [{NAME: TEST_TRANSFER_OPERATION_NAME, METADATA: {STATUS: status}} for status in statuses]
+
+        with six.assertRaisesRegex(
+            self,
+            AirflowException,
+            "An unexpected operation status was encountered. Expected: {}".format(
+                ", ".join(expected_statuses)
+            ),
+        ):
+            GCPTransferServiceHook.operations_contain_expected_statuses(
+                operations, GcpTransferOperationStatus.IN_PROGRESS
+            )
+
+    @parameterized.expand(
+        [
+            ([GcpTransferOperationStatus.ABORTED], GcpTransferOperationStatus.ABORTED),
+            (
+                [GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.ABORTED],
+                GcpTransferOperationStatus.ABORTED,
+            ),
+            (
+                [GcpTransferOperationStatus.PAUSED, GcpTransferOperationStatus.ABORTED],
+                GcpTransferOperationStatus.ABORTED,
+            ),
+            ([GcpTransferOperationStatus.ABORTED], (GcpTransferOperationStatus.ABORTED,)),
+            (
+                [GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.ABORTED,),
+            ),
+            (
+                [GcpTransferOperationStatus.PAUSED, GcpTransferOperationStatus.ABORTED],
+                (GcpTransferOperationStatus.ABORTED,),
+            ),
+        ]
+    )
+    def test_operations_contain_expected_statuses_green_path(self, statuses, expected_statuses):
+        operations = [{NAME: TEST_TRANSFER_OPERATION_NAME, METADATA: {STATUS: status}} for status in statuses]
+
+        result = GCPTransferServiceHook.operations_contain_expected_statuses(operations, expected_statuses)
+
+        self.assertTrue(result)
+
+
+class TestGCPTransferServiceHookWithProjectIdFromConnection(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(
+            'airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+            new=mock_base_gcp_hook_default_project_id,
+        ):
+            self.gct_hook = GCPTransferServiceHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_create_transfer_job(self, get_conn):
+        create_method = get_conn.return_value.transferJobs.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = deepcopy(TEST_TRANSFER_JOB)
+        res = self.gct_hook.create_transfer_job(body=self._without_project_id(TEST_BODY))
+        self.assertEqual(res, TEST_TRANSFER_JOB)
+        create_method.assert_called_once_with(body=self._with_project_id(TEST_BODY, 'example-project'))
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_get_transfer_job(self, get_conn):
+        get_method = get_conn.return_value.transferJobs.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        res = self.gct_hook.get_transfer_job(job_name=TEST_TRANSFER_JOB_NAME)
+        self.assertIsNotNone(res)
+        self.assertEqual(TEST_TRANSFER_JOB_NAME, res[NAME])
+        get_method.assert_called_once_with(jobName=TEST_TRANSFER_JOB_NAME, projectId='example-project')
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_job(self, get_conn):
+        list_method = get_conn.return_value.transferJobs.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {TRANSFER_JOBS: [TEST_TRANSFER_JOB]}
+
+        list_next = get_conn.return_value.transferJobs.return_value.list_next
+        list_next.return_value = None
+
+        res = self.gct_hook.list_transfer_job(
+            filter=_without_key(TEST_TRANSFER_JOB_FILTER, FILTER_PROJECT_ID)
+        )
+        self.assertIsNotNone(res)
+        self.assertEqual(res, [TEST_TRANSFER_JOB])
+
+        list_method.assert_called_with(filter=mock.ANY)
+        args, kwargs = list_method.call_args_list[0]
         self.assertEqual(
-            json.loads(list_kwargs.get('filter')),
-            {
-                'project_id': 'test-project',
-                'job_names': ['transferJobs/test-job']
+            json.loads(kwargs['filter']),
+            {FILTER_PROJECT_ID: 'example-project', FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME]},
+        )
+        list_execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_update_transfer_job(self, get_conn):
+        update_method = get_conn.return_value.transferJobs.return_value.patch
+        execute_method = update_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        res = self.gct_hook.update_transfer_job(
+            job_name=TEST_TRANSFER_JOB_NAME, body=self._without_project_id(TEST_UPDATE_TRANSFER_JOB_BODY)
+        )
+        self.assertIsNotNone(res)
+        update_method.assert_called_once_with(
+            jobName=TEST_TRANSFER_JOB_NAME,
+            body=self._with_project_id(TEST_UPDATE_TRANSFER_JOB_BODY, 'example-project'),
+        )
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_delete_transfer_job(self, get_conn):
+        update_method = get_conn.return_value.transferJobs.return_value.patch
+        execute_method = update_method.return_value.execute
+
+        self.gct_hook.delete_transfer_job(job_name=TEST_TRANSFER_JOB_NAME, project_id=TEST_PROJECT_ID)
+
+        update_method.assert_called_once_with(
+            jobName=TEST_TRANSFER_JOB_NAME,
+            body={
+                PROJECT_ID: TEST_PROJECT_ID,
+                TRANSFER_JOB: {STATUS: 'DELETED'},
+                TRANSFER_JOB_FIELD_MASK: STATUS,
             },
         )
-        mock_sleep.assert_called_once_with(TIME_TO_SLEEP_IN_SECONDS)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_cancel_transfer_operation(self, get_conn):
+        cancel_method = get_conn.return_value.transferOperations.return_value.cancel
+        execute_method = cancel_method.return_value.execute
+
+        self.gct_hook.cancel_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        cancel_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_get_transfer_operation(self, get_conn):
+        get_method = get_conn.return_value.transferOperations.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_OPERATION
+        res = self.gct_hook.get_transfer_operation(operation_name=TEST_TRANSFER_OPERATION_NAME)
+        self.assertEqual(res, TEST_TRANSFER_OPERATION)
+        get_method.assert_called_once_with(name=TEST_TRANSFER_OPERATION_NAME)
+        execute_method.assert_called_once_with(num_retries=5)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_operation(self, get_conn):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {OPERATIONS: [TEST_TRANSFER_OPERATION]}
+
+        list_next = get_conn.return_value.transferOperations.return_value.list_next
+        list_next.return_value = None
+
+        res = self.gct_hook.list_transfer_operations(
+            filter=_without_key(TEST_TRANSFER_OPERATION_FILTER, FILTER_PROJECT_ID)
+        )
+        self.assertIsNotNone(res)
+        self.assertEqual(res, [TEST_TRANSFER_OPERATION])
+        list_method.assert_called_once_with(filter=mock.ANY, name='transferOperations')
+        args, kwargs = list_method.call_args_list[0]
+        self.assertEqual(
+            json.loads(kwargs['filter']),
+            {FILTER_PROJECT_ID: 'example-project', FILTER_JOB_NAMES: [TEST_TRANSFER_JOB_NAME]},
+        )
+        list_execute_method.assert_called_once_with(num_retries=5)
+
+    @staticmethod
+    def _without_project_id(body):
+        body = deepcopy(body)
+        del body[PROJECT_ID]
+        return body
+
+    @staticmethod
+    def _with_project_id(body, project_id):
+        body = deepcopy(body)
+        del body[PROJECT_ID]
+        body[PROJECT_ID] = project_id
+        return body
+
+
+class TestGCPTransferServiceHookWithoutProjectId(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(
+            'airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook.__init__',
+            new=mock_base_gcp_hook_no_default_project_id,
+        ):
+            self.gct_hook = GCPTransferServiceHook(gcp_conn_id='test')
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_create_transfer_job(self, get_conn):
+        create_method = get_conn.return_value.transferJobs.return_value.create
+        execute_method = create_method.return_value.execute
+        execute_method.return_value = deepcopy(TEST_TRANSFER_JOB)
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.create_transfer_job(body=_without_key(TEST_BODY, PROJECT_ID))
 
-    def test_wait_for_transfer_job_failed(self):
-        mock_list = self.conn.transferOperations.return_value.list
-        mock_execute = mock_list.return_value.execute
-        mock_execute.side_effect = [
-            {'operations': [{'name': 'test-job', 'metadata': {'status': 'FAILED'}}]},
+        self.assertEqual(
+            'The project id must be passed either as `projectId` key in `body` parameter or as project_id '
+            'extra in GCP connection definition. Both are not set!',
+            str(e.exception),
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_get_transfer_job(self, get_conn):
+        get_method = get_conn.return_value.transferJobs.return_value.get
+        execute_method = get_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.get_transfer_job(job_name=TEST_TRANSFER_JOB_NAME)
+        self.assertEqual(
+            'The project id must be passed either as keyword project_id '
+            'parameter or as project_id extra in GCP connection definition. '
+            'Both are not set!',
+            str(e.exception),
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_job(self, get_conn):
+        list_method = get_conn.return_value.transferJobs.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {"transferJobs": [TEST_TRANSFER_JOB]}
+
+        list_next = get_conn.return_value.transferJobs.return_value.list_next
+        list_next.return_value = None
+
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.list_transfer_job(filter=_without_key(TEST_TRANSFER_JOB_FILTER, FILTER_PROJECT_ID))
+
+        self.assertEqual(
+            'The project id must be passed either as `project_id` key in `filter` parameter or as '
+            'project_id extra in GCP connection definition. Both are not set!',
+            str(e.exception),
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_operation_multiple_page(self, get_conn):
+        pages_requests = [
+            mock.Mock(**{'execute.return_value': {"operations": [TEST_TRANSFER_OPERATION]}}) for _ in range(4)
         ]
-        with self.assertRaises(AirflowException):
-            self.transfer_hook.wait_for_transfer_job({
-                'projectId': 'test-project',
-                'name': 'transferJobs/test-job',
-            })
+        transfer_operation_mock = mock.Mock(
+            **{'list.return_value': pages_requests[1], 'list_next.side_effect': pages_requests[1:] + [None]}
+        )
+
+        get_conn.return_value.transferOperations.return_value = transfer_operation_mock
+
+        res = self.gct_hook.list_transfer_operations(filter=TEST_TRANSFER_OPERATION_FILTER)
+        self.assertEqual(res, [TEST_TRANSFER_OPERATION] * 4)
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_update_transfer_job(self, get_conn):
+        update_method = get_conn.return_value.transferJobs.return_value.patch
+        execute_method = update_method.return_value.execute
+        execute_method.return_value = TEST_TRANSFER_JOB
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.update_transfer_job(
+                job_name=TEST_TRANSFER_JOB_NAME, body=_without_key(TEST_UPDATE_TRANSFER_JOB_BODY, PROJECT_ID)
+            )
+
+        self.assertEqual(
+            'The project id must be passed either as `projectId` key in `body` parameter or as project_id '
+            'extra in GCP connection definition. Both are not set!',
+            str(e.exception),
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_delete_transfer_job(self, get_conn):
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.delete_transfer_job(job_name=TEST_TRANSFER_JOB_NAME)
+
+        self.assertEqual(
+            'The project id must be passed either as keyword project_id parameter or as project_id extra in '
+            'GCP connection definition. Both are not set!',
+            str(e.exception),
+        )
+
+    @mock.patch('airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook.get_conn')
+    def test_list_transfer_operation(self, get_conn):
+        list_method = get_conn.return_value.transferOperations.return_value.list
+        list_execute_method = list_method.return_value.execute
+        list_execute_method.return_value = {"operations": [TEST_TRANSFER_OPERATION]}
+
+        list_next = get_conn.return_value.transferOperations.return_value.list_next
+        list_next.return_value = None
+
+        with self.assertRaises(AirflowException) as e:
+            self.gct_hook.list_transfer_operations(
+                filter=_without_key(TEST_TRANSFER_OPERATION_FILTER, FILTER_PROJECT_ID)
+            )
+
+        self.assertEqual(
+            'The project id must be passed either as `project_id` key in `filter` parameter or as project_id '
+            'extra in GCP connection definition. Both are not set!',
+            str(e.exception),
+        )
diff --git a/tests/contrib/operators/test_gcp_transfer_operator.py b/tests/contrib/operators/test_gcp_transfer_operator.py
new file mode 100644
index 0000000000000..ffab04b72cb99
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_transfer_operator.py
@@ -0,0 +1,754 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import itertools
+import unittest
+from copy import deepcopy
+from datetime import date, time
+
+from parameterized import parameterized
+from botocore.credentials import Credentials
+
+from airflow import AirflowException, configuration
+from airflow.contrib.hooks.gcp_transfer_hook import (
+    FILTER_JOB_NAMES,
+    SCHEDULE_START_DATE,
+    SCHEDULE_END_DATE,
+    START_TIME_OF_DAY,
+    STATUS,
+    NAME,
+    AWS_S3_DATA_SOURCE,
+    GCS_DATA_SOURCE,
+    GCS_DATA_SINK,
+    AWS_ACCESS_KEY,
+    ACCESS_KEY_ID,
+    SECRET_ACCESS_KEY,
+    BUCKET_NAME,
+    SCHEDULE,
+    TRANSFER_SPEC,
+    HTTP_DATA_SOURCE,
+    LIST_URL,
+)
+from airflow.contrib.operators.gcp_transfer_operator import (
+    GcpTransferServiceOperationCancelOperator,
+    GcpTransferServiceOperationResumeOperator,
+    GcpTransferServiceOperationsListOperator,
+    TransferJobValidator,
+    TransferJobPreprocessor,
+    GcpTransferServiceJobCreateOperator,
+    GcpTransferServiceJobUpdateOperator,
+    GcpTransferServiceOperationGetOperator,
+    GcpTransferServiceOperationPauseOperator,
+    S3ToGoogleCloudStorageTransferOperator,
+    GoogleCloudStorageToGoogleCloudStorageTransferOperator,
+    GcpTransferServiceJobDeleteOperator,
+)
+from airflow.models import TaskInstance, DAG
+from airflow.utils import timezone
+
+try:
+    # noinspection PyProtectedMember
+    from unittest import mock
+except ImportError:  # pragma: no cover
+    try:
+        import mock
+    except ImportError:
+        mock = None
+try:
+    import boto3
+except ImportError:  # pragma: no cover
+    boto3 = None
+
+GCP_PROJECT_ID = 'project-id'
+TASK_ID = 'task-id'
+
+JOB_NAME = "job-name"
+OPERATION_NAME = "operation-name"
+AWS_BUCKET_NAME = "aws-bucket-name"
+GCS_BUCKET_NAME = "gcp-bucket-name"
+DESCRIPTION = "description"
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+TEST_FILTER = {FILTER_JOB_NAMES: [JOB_NAME]}
+
+TEST_AWS_ACCESS_KEY_ID = "test-key-1"
+TEST_AWS_ACCESS_SECRET = "test-secret-1"
+TEST_AWS_ACCESS_KEY = {ACCESS_KEY_ID: TEST_AWS_ACCESS_KEY_ID, SECRET_ACCESS_KEY: TEST_AWS_ACCESS_SECRET}
+
+NATIVE_DATE = date(2018, 10, 15)
+DICT_DATE = {'day': 15, 'month': 10, 'year': 2018}
+NATIVE_TIME = time(hour=11, minute=42, second=43)
+DICT_TIME = {'hours': 11, 'minutes': 42, 'seconds': 43}
+SCHEDULE_NATIVE = {
+    SCHEDULE_START_DATE: NATIVE_DATE,
+    SCHEDULE_END_DATE: NATIVE_DATE,
+    START_TIME_OF_DAY: NATIVE_TIME,
+}
+
+SCHEDULE_DICT = {
+    SCHEDULE_START_DATE: {'day': 15, 'month': 10, 'year': 2018},
+    SCHEDULE_END_DATE: {'day': 15, 'month': 10, 'year': 2018},
+    START_TIME_OF_DAY: {'hours': 11, 'minutes': 42, 'seconds': 43},
+}
+
+SOURCE_AWS = {AWS_S3_DATA_SOURCE: {BUCKET_NAME: AWS_BUCKET_NAME}}
+SOURCE_GCS = {GCS_DATA_SOURCE: {BUCKET_NAME: GCS_BUCKET_NAME}}
+SOURCE_HTTP = {HTTP_DATA_SOURCE: {LIST_URL: "http://example.com"}}
+
+VALID_TRANSFER_JOB_BASE = {
+    NAME: JOB_NAME,
+    DESCRIPTION: DESCRIPTION,
+    STATUS: 'ENABLED',
+    SCHEDULE: SCHEDULE_DICT,
+    TRANSFER_SPEC: {GCS_DATA_SINK: {BUCKET_NAME: GCS_BUCKET_NAME}},
+}
+VALID_TRANSFER_JOB_GCS = deepcopy(VALID_TRANSFER_JOB_BASE)
+VALID_TRANSFER_JOB_GCS[TRANSFER_SPEC].update(deepcopy(SOURCE_GCS))
+VALID_TRANSFER_JOB_AWS = deepcopy(VALID_TRANSFER_JOB_BASE)
+VALID_TRANSFER_JOB_AWS[TRANSFER_SPEC].update(deepcopy(SOURCE_AWS))
+
+VALID_TRANSFER_JOB_GCS = {
+    NAME: JOB_NAME,
+    DESCRIPTION: DESCRIPTION,
+    STATUS: 'ENABLED',
+    SCHEDULE: SCHEDULE_NATIVE,
+    TRANSFER_SPEC: {
+        GCS_DATA_SOURCE: {BUCKET_NAME: GCS_BUCKET_NAME},
+        GCS_DATA_SINK: {BUCKET_NAME: GCS_BUCKET_NAME},
+    },
+}
+
+VALID_TRANSFER_JOB_RAW = {
+    DESCRIPTION: DESCRIPTION,
+    STATUS: 'ENABLED',
+    SCHEDULE: SCHEDULE_DICT,
+    TRANSFER_SPEC: {GCS_DATA_SINK: {BUCKET_NAME: GCS_BUCKET_NAME}},
+}
+
+VALID_TRANSFER_JOB_GCS_RAW = deepcopy(VALID_TRANSFER_JOB_RAW)
+VALID_TRANSFER_JOB_GCS_RAW[TRANSFER_SPEC].update(SOURCE_GCS)
+VALID_TRANSFER_JOB_AWS_RAW = deepcopy(VALID_TRANSFER_JOB_RAW)
+VALID_TRANSFER_JOB_AWS_RAW[TRANSFER_SPEC].update(deepcopy(SOURCE_AWS))
+VALID_TRANSFER_JOB_AWS_RAW[TRANSFER_SPEC][AWS_S3_DATA_SOURCE][AWS_ACCESS_KEY] = TEST_AWS_ACCESS_KEY
+
+
+VALID_OPERATION = {NAME: "operation-name"}
+
+
+class TransferJobPreprocessorTest(unittest.TestCase):
+    def test_should_do_nothing_on_empty(self):
+        body = {}
+        TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body, {})
+
+    @unittest.skipIf(boto3 is None, "Skipping test because boto3 is not available")
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.AwsHook')
+    def test_should_inject_aws_credentials(self, mock_hook):
+        mock_hook.return_value.get_credentials.return_value = Credentials(
+            TEST_AWS_ACCESS_KEY_ID, TEST_AWS_ACCESS_SECRET, None
+        )
+
+        body = {TRANSFER_SPEC: deepcopy(SOURCE_AWS)}
+        body = TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body[TRANSFER_SPEC][AWS_S3_DATA_SOURCE][AWS_ACCESS_KEY], TEST_AWS_ACCESS_KEY)
+
+    @parameterized.expand([(SCHEDULE_START_DATE,), (SCHEDULE_END_DATE,)])
+    def test_should_format_date_from_python_to_dict(self, field_attr):
+        body = {SCHEDULE: {field_attr: NATIVE_DATE}}
+        TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body[SCHEDULE][field_attr], DICT_DATE)
+
+    def test_should_format_time_from_python_to_dict(self):
+        body = {SCHEDULE: {START_TIME_OF_DAY: NATIVE_TIME}}
+        TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body[SCHEDULE][START_TIME_OF_DAY], DICT_TIME)
+
+    @parameterized.expand([(SCHEDULE_START_DATE,), (SCHEDULE_END_DATE,)])
+    def test_should_not_change_date_for_dict(self, field_attr):
+        body = {SCHEDULE: {field_attr: DICT_DATE}}
+        TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body[SCHEDULE][field_attr], DICT_DATE)
+
+    def test_should_not_change_time_for_dict(self):
+        body = {SCHEDULE: {START_TIME_OF_DAY: DICT_TIME}}
+        TransferJobPreprocessor(body=body).process_body()
+        self.assertEqual(body[SCHEDULE][START_TIME_OF_DAY], DICT_TIME)
+
+
+class TransferJobValidatorTest(unittest.TestCase):
+    def test_should_raise_exception_when_encounters_aws_credentials(self):
+        body = {"transferSpec": {"awsS3DataSource": {"awsAccessKey": TEST_AWS_ACCESS_KEY}}}
+        with self.assertRaises(AirflowException) as cm:
+            TransferJobValidator(body=body).validate_body()
+        err = cm.exception
+        self.assertIn(
+            "AWS credentials detected inside the body parameter (awsAccessKey). This is not allowed, please "
+            "use Airflow connections to store credentials.",
+            str(err),
+        )
+
+    def test_should_raise_exception_when_body_empty(self):
+        body = None
+        with self.assertRaises(AirflowException) as cm:
+            TransferJobValidator(body=body).validate_body()
+        err = cm.exception
+        self.assertIn("The required parameter 'body' is empty or None", str(err))
+
+    @parameterized.expand(
+        [
+            (dict(itertools.chain(SOURCE_AWS.items(), SOURCE_GCS.items(), SOURCE_HTTP.items())),),
+            (dict(itertools.chain(SOURCE_AWS.items(), SOURCE_GCS.items())),),
+            (dict(itertools.chain(SOURCE_AWS.items(), SOURCE_HTTP.items())),),
+            (dict(itertools.chain(SOURCE_GCS.items(), SOURCE_HTTP.items())),),
+        ]
+    )
+    def test_verify_data_source(self, transferSpec):
+        body = {TRANSFER_SPEC: transferSpec}
+
+        with self.assertRaises(AirflowException) as cm:
+            TransferJobValidator(body=body).validate_body()
+        err = cm.exception
+        self.assertIn(
+            "More than one data source detected. Please choose exactly one data source from: "
+            "gcsDataSource, awsS3DataSource and httpDataSource.",
+            str(err),
+        )
+
+    @parameterized.expand([(VALID_TRANSFER_JOB_GCS,), (VALID_TRANSFER_JOB_AWS,)])
+    def test_verify_success(self, body):
+
+        TransferJobValidator(body=body).validate_body()
+
+        self.assertTrue(True)
+
+
+class GcpStorageTransferJobCreateOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_job_create_gcs(self, mock_hook):
+        mock_hook.return_value.create_transfer_job.return_value = VALID_TRANSFER_JOB_GCS_RAW
+        body = deepcopy(VALID_TRANSFER_JOB_GCS)
+        del (body['name'])
+        op = GcpTransferServiceJobCreateOperator(body=body, task_id=TASK_ID)
+        result = op.execute(None)
+
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+
+        mock_hook.return_value.create_transfer_job.assert_called_once_with(body=VALID_TRANSFER_JOB_GCS_RAW)
+
+        self.assertEqual(result, VALID_TRANSFER_JOB_GCS_RAW)
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.AwsHook')
+    def test_job_create_aws(self, aws_hook, mock_hook):
+        mock_hook.return_value.create_transfer_job.return_value = VALID_TRANSFER_JOB_AWS_RAW
+        aws_hook.return_value.get_credentials.return_value = Credentials(
+            TEST_AWS_ACCESS_KEY_ID, TEST_AWS_ACCESS_SECRET, None
+        )
+        body = deepcopy(VALID_TRANSFER_JOB_AWS)
+        del (body['name'])
+        op = GcpTransferServiceJobCreateOperator(body=body, task_id=TASK_ID)
+
+        result = op.execute(None)
+
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+
+        mock_hook.return_value.create_transfer_job.assert_called_once_with(body=VALID_TRANSFER_JOB_AWS_RAW)
+
+        self.assertEqual(result, VALID_TRANSFER_JOB_AWS_RAW)
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.AwsHook')
+    def test_job_create_multiple(self, aws_hook, gcp_hook):
+        aws_hook.return_value.get_credentials.return_value = Credentials(
+            TEST_AWS_ACCESS_KEY_ID, TEST_AWS_ACCESS_SECRET, None
+        )
+        gcp_hook.return_value.create_transfer_job.return_value = VALID_TRANSFER_JOB_AWS_RAW
+        body = deepcopy(VALID_TRANSFER_JOB_AWS)
+
+        op = GcpTransferServiceJobCreateOperator(body=body, task_id=TASK_ID)
+        result = op.execute(None)
+        self.assertEqual(result, VALID_TRANSFER_JOB_AWS_RAW)
+
+        op = GcpTransferServiceJobCreateOperator(body=body, task_id=TASK_ID)
+        result = op.execute(None)
+        self.assertEqual(result, VALID_TRANSFER_JOB_AWS_RAW)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        self.dag = DAG(dag_id, default_args={'start_date': DEFAULT_DATE})
+        op = GcpTransferServiceJobCreateOperator(
+            body={"description": "{{ dag.dag_id }}"},
+            gcp_conn_id='{{ dag.dag_id }}',
+            aws_conn_id='{{ dag.dag_id }}',
+            task_id='task-id',
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'body')[DESCRIPTION])
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'aws_conn_id'))
+
+
+class GcpStorageTransferJobUpdateOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_job_update(self, mock_hook):
+        mock_hook.return_value.update_transfer_job.return_value = VALID_TRANSFER_JOB_GCS
+        body = {'transferJob': {'description': 'example-name'}, 'updateTransferJobFieldMask': DESCRIPTION}
+
+        op = GcpTransferServiceJobUpdateOperator(job_name=JOB_NAME, body=body, task_id=TASK_ID)
+        result = op.execute(None)
+
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.update_transfer_job.assert_called_once_with(job_name=JOB_NAME, body=body)
+        self.assertEqual(result, VALID_TRANSFER_JOB_GCS)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceJobUpdateOperator(
+            job_name='{{ dag.dag_id }}',
+            body={'transferJob': {"name": "{{ dag.dag_id }}"}},
+            task_id='task-id',
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'body')['transferJob']['name'])
+        self.assertEqual(dag_id, getattr(op, 'job_name'))
+
+
+class GcpStorageTransferJobDeleteOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_job_delete(self, mock_hook):
+        op = GcpTransferServiceJobDeleteOperator(
+            job_name=JOB_NAME, project_id=GCP_PROJECT_ID, task_id='task-id'
+        )
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.delete_transfer_job.assert_called_once_with(
+            job_name=JOB_NAME, project_id=GCP_PROJECT_ID
+        )
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_job_delete_with_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceJobDeleteOperator(
+            job_name='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'job_name'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_job_delete_should_throw_ex_when_name_none(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GcpTransferServiceJobDeleteOperator(job_name="", task_id='task-id')
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'job_name' is empty or None", str(err))
+        mock_hook.assert_not_called()
+
+
+class GpcStorageTransferOperationsGetOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_get(self, mock_hook):
+        mock_hook.return_value.get_transfer_operation.return_value = VALID_OPERATION
+        op = GcpTransferServiceOperationGetOperator(operation_name=OPERATION_NAME, task_id=TASK_ID)
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.get_transfer_operation.assert_called_once_with(operation_name=OPERATION_NAME)
+        self.assertEqual(result, VALID_OPERATION)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_get_with_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceOperationGetOperator(
+            operation_name='{{ dag.dag_id }}', task_id='task-id', dag=self.dag
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'operation_name'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_get_should_throw_ex_when_operation_name_none(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GcpTransferServiceOperationGetOperator(operation_name="", task_id=TASK_ID)
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'operation_name' is empty or None", str(err))
+        mock_hook.assert_not_called()
+
+
+class GcpStorageTransferOperationListOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_list(self, mock_hook):
+        mock_hook.return_value.list_transfer_operations.return_value = [VALID_TRANSFER_JOB_GCS]
+        op = GcpTransferServiceOperationsListOperator(filter=TEST_FILTER, task_id=TASK_ID)
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.list_transfer_operations.assert_called_once_with(filter=TEST_FILTER)
+        self.assertEqual(result, [VALID_TRANSFER_JOB_GCS])
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceOperationsListOperator(
+            filter={"job_names": ['{{ dag.dag_id }}']},
+            gcp_conn_id='{{ dag.dag_id }}',
+            task_id='task-id',
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'filter')['job_names'][0])
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+
+
+class GcpStorageTransferOperationsPauseOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_pause(self, mock_hook):
+        op = GcpTransferServiceOperationPauseOperator(operation_name=OPERATION_NAME, task_id='task-id')
+        op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.pause_transfer_operation.assert_called_once_with(operation_name=OPERATION_NAME)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_pause_with_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceOperationPauseOperator(
+            operation_name='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'operation_name'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_pause_should_throw_ex_when_name_none(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GcpTransferServiceOperationPauseOperator(operation_name="", task_id='task-id')
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'operation_name' is empty or None", str(err))
+        mock_hook.assert_not_called()
+
+
+class GcpStorageTransferOperationsResumeOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_resume(self, mock_hook):
+        op = GcpTransferServiceOperationResumeOperator(operation_name=OPERATION_NAME, task_id=TASK_ID)
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.resume_transfer_operation.assert_called_once_with(
+            operation_name=OPERATION_NAME
+        )
+        self.assertIsNone(result)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_resume_with_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceOperationResumeOperator(
+            operation_name='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'operation_name'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_resume_should_throw_ex_when_name_none(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GcpTransferServiceOperationResumeOperator(operation_name="", task_id=TASK_ID)
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'operation_name' is empty or None", str(err))
+        mock_hook.assert_not_called()
+
+
+class GcpStorageTransferOperationsCancelOperatorTest(unittest.TestCase):
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_cancel(self, mock_hook):
+        op = GcpTransferServiceOperationCancelOperator(operation_name=OPERATION_NAME, task_id=TASK_ID)
+        result = op.execute(None)
+        mock_hook.assert_called_once_with(api_version='v1', gcp_conn_id='google_cloud_default')
+        mock_hook.return_value.cancel_transfer_operation.assert_called_once_with(
+            operation_name=OPERATION_NAME
+        )
+        self.assertIsNone(result)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_cancel_with_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GcpTransferServiceOperationCancelOperator(
+            operation_name='{{ dag.dag_id }}',
+            gcp_conn_id='{{ dag.dag_id }}',
+            api_version='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'operation_name'))
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+        self.assertEqual(dag_id, getattr(op, 'api_version'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_operation_cancel_should_throw_ex_when_name_none(self, mock_hook):
+        with self.assertRaises(AirflowException) as cm:
+            op = GcpTransferServiceOperationCancelOperator(operation_name="", task_id=TASK_ID)
+            op.execute(None)
+        err = cm.exception
+        self.assertIn("The required parameter 'operation_name' is empty or None", str(err))
+        mock_hook.assert_not_called()
+
+
+class S3ToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
+    def test_constructor(self):
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=AWS_BUCKET_NAME,
+            gcs_bucket=GCS_BUCKET_NAME,
+            project_id=GCP_PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE_DICT,
+        )
+
+        self.assertEqual(operator.task_id, TASK_ID)
+        self.assertEqual(operator.s3_bucket, AWS_BUCKET_NAME)
+        self.assertEqual(operator.gcs_bucket, GCS_BUCKET_NAME)
+        self.assertEqual(operator.project_id, GCP_PROJECT_ID)
+        self.assertEqual(operator.description, DESCRIPTION)
+        self.assertEqual(operator.schedule, SCHEDULE_DICT)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = S3ToGoogleCloudStorageTransferOperator(
+            s3_bucket='{{ dag.dag_id }}',
+            gcs_bucket='{{ dag.dag_id }}',
+            description='{{ dag.dag_id }}',
+            object_conditions={'exclude_prefixes': ['{{ dag.dag_id }}']},
+            gcp_conn_id='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 's3_bucket'))
+        self.assertEqual(dag_id, getattr(op, 'gcs_bucket'))
+        self.assertEqual(dag_id, getattr(op, 'description'))
+        self.assertEqual(dag_id, getattr(op, 'object_conditions')['exclude_prefixes'][0])
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.AwsHook')
+    def test_execute(self, mock_aws_hook, mock_transfer_hook):
+        mock_aws_hook.return_value.get_credentials.return_value = Credentials(
+            TEST_AWS_ACCESS_KEY_ID, TEST_AWS_ACCESS_SECRET, None
+        )
+
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=AWS_BUCKET_NAME,
+            gcs_bucket=GCS_BUCKET_NAME,
+            description=DESCRIPTION,
+            schedule=SCHEDULE_DICT,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            body=VALID_TRANSFER_JOB_AWS_RAW
+        )
+
+        self.assertTrue(mock_transfer_hook.return_value.wait_for_transfer_job.called)
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.AwsHook')
+    def test_execute_skip_wait(self, mock_aws_hook, mock_transfer_hook):
+        mock_aws_hook.return_value.get_credentials.return_value = Credentials(
+            TEST_AWS_ACCESS_KEY_ID, TEST_AWS_ACCESS_SECRET, None
+        )
+
+        operator = S3ToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            s3_bucket=AWS_BUCKET_NAME,
+            gcs_bucket=GCS_BUCKET_NAME,
+            description=DESCRIPTION,
+            schedule=SCHEDULE_DICT,
+            wait=False,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            body=VALID_TRANSFER_JOB_AWS_RAW
+        )
+
+        self.assertFalse(mock_transfer_hook.return_value.wait_for_transfer_job.called)
+
+
+class GoogleCloudStorageToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
+    def test_constructor(self):
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=GCS_BUCKET_NAME,
+            destination_bucket=GCS_BUCKET_NAME,
+            project_id=GCP_PROJECT_ID,
+            description=DESCRIPTION,
+            schedule=SCHEDULE_DICT,
+        )
+
+        self.assertEqual(operator.task_id, TASK_ID)
+        self.assertEqual(operator.source_bucket, GCS_BUCKET_NAME)
+        self.assertEqual(operator.destination_bucket, GCS_BUCKET_NAME)
+        self.assertEqual(operator.project_id, GCP_PROJECT_ID)
+        self.assertEqual(operator.description, DESCRIPTION)
+        self.assertEqual(operator.schedule, SCHEDULE_DICT)
+
+    # Setting all of the operator's input parameters as templated dag_ids
+    # (could be anything else) just to test if the templating works for all
+    # fields
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_templates(self, _):
+        dag_id = 'test_dag_id'
+        configuration.load_test_config()
+        args = {'start_date': DEFAULT_DATE}
+        self.dag = DAG(dag_id, default_args=args)
+        op = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            source_bucket='{{ dag.dag_id }}',
+            destination_bucket='{{ dag.dag_id }}',
+            description='{{ dag.dag_id }}',
+            object_conditions={'exclude_prefixes': ['{{ dag.dag_id }}']},
+            gcp_conn_id='{{ dag.dag_id }}',
+            task_id=TASK_ID,
+            dag=self.dag,
+        )
+        ti = TaskInstance(op, DEFAULT_DATE)
+        ti.render_templates()
+        self.assertEqual(dag_id, getattr(op, 'source_bucket'))
+        self.assertEqual(dag_id, getattr(op, 'destination_bucket'))
+        self.assertEqual(dag_id, getattr(op, 'description'))
+        self.assertEqual(dag_id, getattr(op, 'object_conditions')['exclude_prefixes'][0])
+        self.assertEqual(dag_id, getattr(op, 'gcp_conn_id'))
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_execute(self, mock_transfer_hook):
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=GCS_BUCKET_NAME,
+            destination_bucket=GCS_BUCKET_NAME,
+            description=DESCRIPTION,
+            schedule=SCHEDULE_DICT,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            body=VALID_TRANSFER_JOB_GCS_RAW
+        )
+        self.assertTrue(mock_transfer_hook.return_value.wait_for_transfer_job.called)
+
+    @mock.patch('airflow.contrib.operators.gcp_transfer_operator.GCPTransferServiceHook')
+    def test_execute_skip_wait(self, mock_transfer_hook):
+        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
+            task_id=TASK_ID,
+            source_bucket=GCS_BUCKET_NAME,
+            destination_bucket=GCS_BUCKET_NAME,
+            description=DESCRIPTION,
+            wait=False,
+            schedule=SCHEDULE_DICT,
+        )
+
+        operator.execute(None)
+
+        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
+            body=VALID_TRANSFER_JOB_GCS_RAW
+        )
+        self.assertFalse(mock_transfer_hook.return_value.wait_for_transfer_job.called)
diff --git a/tests/contrib/operators/test_gcp_transfer_operator_system.py b/tests/contrib/operators/test_gcp_transfer_operator_system.py
new file mode 100644
index 0000000000000..7a94c3762b600
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_transfer_operator_system.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.operators.test_gcp_transfer_operator_system_helper import GCPTransferTestHelper
+from tests.contrib.utils.base_gcp_system_test_case import SKIP_TEST_WARNING, DagGcpSystemTestCase
+
+from tests.contrib.utils.gcp_authenticator import GCP_GCS_TRANSFER_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_GCS_TRANSFER_KEY), SKIP_TEST_WARNING)
+class GcpTransferExampleDagsSystemTest(DagGcpSystemTestCase):
+    def setUp(self):
+        super(GcpTransferExampleDagsSystemTest, self).setUp()
+        self.gcp_authenticator.gcp_authenticate()
+        self.helper.create_gcs_buckets()
+        self.gcp_authenticator.gcp_revoke_authentication()
+
+    def tearDown(self):
+        self.gcp_authenticator.gcp_authenticate()
+        self.helper.delete_gcs_buckets()
+        self.gcp_authenticator.gcp_revoke_authentication()
+        super(GcpTransferExampleDagsSystemTest, self).tearDown()
+
+    def __init__(self, method_name='runTest'):
+        super(GcpTransferExampleDagsSystemTest, self).__init__(
+            method_name, dag_id='example_gcp_transfer', gcp_key=GCP_GCS_TRANSFER_KEY
+        )
+        self.helper = GCPTransferTestHelper()
+
+    def test_run_example_dag_compute(self):
+        self._run_dag()
diff --git a/tests/contrib/operators/test_gcp_transfer_operator_system_helper.py b/tests/contrib/operators/test_gcp_transfer_operator_system_helper.py
new file mode 100755
index 0000000000000..b10bfeab08ade
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_transfer_operator_system_helper.py
@@ -0,0 +1,192 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import argparse
+import os
+import subprocess
+
+from googleapiclient._auth import default_credentials, with_scopes
+
+from tests.contrib.utils.base_gcp_system_test_case import RetrieveVariables
+from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_GCS_TRANSFER_KEY
+from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
+from googleapiclient import discovery
+
+
+retrieve_variables = RetrieveVariables()
+
+SERVICE_EMAIL_FORMAT = "project-%s@storage-transfer-service.iam.gserviceaccount.com"
+
+GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
+GCP_TRANSFER_SOURCE_AWS_BUCKET = os.environ.get('GCP_TRANSFER_SOURCE_AWS_BUCKET', 'instance-bucket-test-2')
+GCP_TRANSFER_FIRST_TARGET_BUCKET = os.environ.get(
+    'GCP_TRANSFER_FIRST_TARGET_BUCKET', 'gcp-transfer-first-target'
+)
+GCP_TRANSFER_SECOND_TARGET_BUCKET = os.environ.get(
+    'GCP_TRANSFER_SECOND_TARGET_BUCKET', 'gcp-transfer-second-target'
+)
+
+# 100 MB
+TEST_FILE_SIZE = 1 * 1024 * 1024
+TEST_FILE_NO = 30000
+# Total: 30000 * 1 MB = 30GB
+
+
+class GCPTransferTestHelper(LoggingCommandExecutor):
+    def create_s3_bucket(self):
+        self.execute_cmd(["aws", "s3", "mb", "s3://%s" % GCP_TRANSFER_SOURCE_AWS_BUCKET])
+
+        self.execute_cmd(
+            [
+                "bash",
+                "-c",
+                "cat /dev/urandom | head -c %s | aws s3 cp - "
+                "s3://%s/file-from-aws.bin" % (TEST_FILE_SIZE, GCP_TRANSFER_SOURCE_AWS_BUCKET),
+            ]
+        )
+
+        self.execute_cmd(
+            [
+                "bash",
+                "-c",
+                "seq 1 %s | xargs -n 1 -P 16 -I {} "
+                "aws s3 cp  s3://%s/file-from-aws.bin s3://%s/file-from-aws-{}.bin"
+                % (TEST_FILE_NO, GCP_TRANSFER_SOURCE_AWS_BUCKET, GCP_TRANSFER_SOURCE_AWS_BUCKET),
+            ]
+        )
+
+    def delete_s3_bucket(self):
+        self.execute_cmd(["aws", "s3", "rb", "s3://%s" % GCP_TRANSFER_SOURCE_AWS_BUCKET, "--force"])
+
+    def create_gcs_buckets(self):
+        self.execute_cmd(
+            [
+                'gsutil',
+                'mb',
+                "-p",
+                GCP_PROJECT_ID,
+                "-c",
+                "regional",
+                "-l",
+                "europe-north1",
+                "gs://%s/" % GCP_TRANSFER_FIRST_TARGET_BUCKET,
+            ]
+        )
+
+        self.execute_cmd(
+            [
+                'gsutil',
+                'mb',
+                "-p",
+                GCP_PROJECT_ID,
+                "-c",
+                "regional",
+                "-l",
+                "asia-east1",
+                "gs://%s/" % GCP_TRANSFER_SECOND_TARGET_BUCKET,
+            ]
+        )
+
+        project_number = (
+            subprocess.check_output(
+                ['gcloud', 'projects', 'describe', GCP_PROJECT_ID, '--format', 'value(projectNumber)']
+            )
+            .decode("utf-8")
+            .strip()
+        )
+
+        account_email = SERVICE_EMAIL_FORMAT % project_number
+
+        self.execute_cmd(
+            [
+                "gsutil",
+                "iam",
+                "ch",
+                "serviceAccount:%s:admin" % account_email,
+                "gs://%s" % GCP_TRANSFER_SECOND_TARGET_BUCKET,
+            ]
+        )
+
+        self.execute_cmd(
+            [
+                "gsutil",
+                "iam",
+                "ch",
+                "serviceAccount:%s:admin" % account_email,
+                "gs://%s" % GCP_TRANSFER_FIRST_TARGET_BUCKET,
+            ]
+        )
+
+    def delete_gcs_buckets(self):
+        self.execute_cmd(['gsutil', 'rm', "-r", "gs://%s/" % GCP_TRANSFER_FIRST_TARGET_BUCKET, "&"], True)
+
+        self.execute_cmd(['gsutil', 'rm', "-r", "gs://%s/" % GCP_TRANSFER_SECOND_TARGET_BUCKET, "&"], True)
+
+    @staticmethod
+    def _get_transfer_service_account():
+        credentials = default_credentials()
+        credentials = with_scopes(credentials, scopes=['https://www.googleapis.com/auth/cloud-platform'])
+        service = discovery.build('storagetransfer', 'v1', cache_discovery=False, credentials=credentials)
+
+        request = service.googleServiceAccounts().get(projectId=GCP_PROJECT_ID)
+        return request.execute()
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(description='Create and delete buckets for system tests.')
+    parser.add_argument(
+        '--action',
+        dest='action',
+        required=True,
+        choices=(
+            'create-s3-bucket',
+            'delete-s3-bucket',
+            'create-gcs-buckets',
+            'delete-gcs-buckets',
+            'before-tests',
+            'after-tests',
+        ),
+    )
+    action = parser.parse_args().action
+
+    helper = GCPTransferTestHelper()
+    gcp_authenticator = GcpAuthenticator(GCP_GCS_TRANSFER_KEY)
+    helper.log.info('Starting action: {}'.format(action))
+
+    gcp_authenticator.gcp_store_authentication()
+    try:
+        gcp_authenticator.gcp_authenticate()
+        if action == 'before-tests':
+            pass
+        elif action == 'after-tests':
+            pass
+        elif action == 'create-s3-bucket':
+            helper.create_s3_bucket()
+        elif action == 'delete-s3-bucket':
+            helper.delete_s3_bucket()
+        elif action == 'create-gcs-buckets':
+            helper.create_gcs_buckets()
+        elif action == 'delete-gcs-buckets':
+            helper.delete_gcs_buckets()
+        else:
+            raise Exception("Unknown action: {}".format(action))
+    finally:
+        gcp_authenticator.gcp_restore_authentication()
+
+    helper.log.info('Finishing action: {}'.format(action))
diff --git a/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py b/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py
deleted file mode 100644
index 8c0cd4ebfcaa5..0000000000000
--- a/tests/contrib/operators/test_gcs_to_gcs_transfer_operator.py
+++ /dev/null
@@ -1,131 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-import unittest
-
-from airflow.contrib.operators.gcs_to_gcs_transfer_operator import \
-    GoogleCloudStorageToGoogleCloudStorageTransferOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-
-TASK_ID = 'test-gcs-gcs-transfer-operator'
-SOURCE_BUCKET = 'test-source-bucket'
-DESTINATION_BUCKET = 'test-destination-bucket'
-PROJECT_ID = 'test-project'
-DESCRIPTION = 'test-description'
-SCHEDULE = {
-    'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
-    'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
-}
-
-
-class GoogleCloudStorageToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
-    def test_constructor(self):
-        """Test GoogleCloudStorageToGoogleCloudStorageTransferOperator instance is properly initialized."""
-
-        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            source_bucket=SOURCE_BUCKET,
-            destination_bucket=DESTINATION_BUCKET,
-            project_id=PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-        )
-
-        self.assertEqual(operator.task_id, TASK_ID)
-        self.assertEqual(operator.source_bucket, SOURCE_BUCKET)
-        self.assertEqual(operator.destination_bucket, DESTINATION_BUCKET)
-        self.assertEqual(operator.project_id, PROJECT_ID)
-        self.assertEqual(operator.description, DESCRIPTION)
-        self.assertEqual(operator.schedule, SCHEDULE)
-
-    @mock.patch('airflow.contrib.operators.gcs_to_gcs_transfer_operator.GCPTransferServiceHook')
-    def test_execute(self, mock_transfer_hook):
-        """Test the execute function when the run is successful."""
-
-        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            source_bucket=SOURCE_BUCKET,
-            destination_bucket=DESTINATION_BUCKET,
-            project_id=PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-        )
-
-        operator.execute(None)
-
-        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-            transfer_spec={
-                'gcsDataSource': {
-                    'bucketName': SOURCE_BUCKET,
-                },
-                'gcsDataSink': {
-                    'bucketName': DESTINATION_BUCKET,
-                },
-                'objectConditions': {},
-                'transferOptions': {}
-            }
-        )
-
-        mock_transfer_hook.return_value.wait_for_transfer_job.assert_called_once_with(
-            mock_transfer_hook.return_value.create_transfer_job.return_value
-        )
-
-    @mock.patch('airflow.contrib.operators.gcs_to_gcs_transfer_operator.GCPTransferServiceHook')
-    def test_execute_skip_wait(self, mock_transfer_hook):
-        """Test the execute function when the run is successful."""
-
-        operator = GoogleCloudStorageToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            source_bucket=SOURCE_BUCKET,
-            destination_bucket=DESTINATION_BUCKET,
-            project_id=PROJECT_ID,
-            description=DESCRIPTION,
-            wait=False,
-        )
-
-        operator.execute(None)
-
-        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=None,
-            transfer_spec={
-                'gcsDataSource': {
-                    'bucketName': SOURCE_BUCKET,
-                },
-                'gcsDataSink': {
-                    'bucketName': DESTINATION_BUCKET,
-                },
-                'objectConditions': {},
-                'transferOptions': {}
-            }
-        )
-
-        assert not mock_transfer_hook.return_value.wait_for_transfer_job.called
diff --git a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py b/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
deleted file mode 100644
index 2eeae3a8a9971..0000000000000
--- a/tests/contrib/operators/test_s3_to_gcs_transfer_operator.py
+++ /dev/null
@@ -1,158 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-import unittest
-import collections
-
-from airflow.contrib.operators.s3_to_gcs_transfer_operator import \
-    S3ToGoogleCloudStorageTransferOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
-
-TASK_ID = 'test-s3-gcs-transfer-operator'
-S3_BUCKET = 'test-s3-bucket'
-GCS_BUCKET = 'test-gcs-bucket'
-GCP_PROJECT_ID = 'test-project'
-DESCRIPTION = 'test-description'
-ACCESS_KEY = 'test-access-key'
-SECRET_KEY = 'test-secret-key'
-SCHEDULE = {
-    'scheduleStartDate': {'month': 10, 'day': 1, 'year': 2018},
-    'scheduleEndDate': {'month': 10, 'day': 31, 'year': 2018},
-}
-
-
-Credentials = collections.namedtuple(
-    'Credentials', ['access_key', 'secret_key'])
-
-
-class S3ToGoogleCloudStorageTransferOperatorTest(unittest.TestCase):
-    def test_constructor(self):
-        """Test S3ToGoogleCloudStorageTransferOperator instance is properly initialized."""
-
-        operator = S3ToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            s3_bucket=S3_BUCKET,
-            gcs_bucket=GCS_BUCKET,
-            project_id=GCP_PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-        )
-
-        self.assertEqual(operator.task_id, TASK_ID)
-        self.assertEqual(operator.s3_bucket, S3_BUCKET)
-        self.assertEqual(operator.gcs_bucket, GCS_BUCKET)
-        self.assertEqual(operator.project_id, GCP_PROJECT_ID)
-        self.assertEqual(operator.description, DESCRIPTION)
-        self.assertEqual(operator.schedule, SCHEDULE)
-
-    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
-    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')
-    def test_execute(self, mock_s3_hook, mock_transfer_hook):
-        """Test the execute function with a custom schedule."""
-
-        operator = S3ToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            s3_bucket=S3_BUCKET,
-            gcs_bucket=GCS_BUCKET,
-            project_id=GCP_PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-        )
-
-        mock_s3_hook.return_value.get_credentials.return_value = Credentials(
-            access_key=ACCESS_KEY,
-            secret_key=SECRET_KEY,
-        )
-
-        operator.execute(None)
-
-        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=GCP_PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=SCHEDULE,
-            transfer_spec={
-                'awsS3DataSource': {
-                    'bucketName': S3_BUCKET,
-                    'awsAccessKey': {
-                        'accessKeyId': ACCESS_KEY,
-                        'secretAccessKey': SECRET_KEY,
-                    }
-                },
-                'gcsDataSink': {
-                    'bucketName': GCS_BUCKET,
-                },
-                'objectConditions': {},
-                'transferOptions': {}
-            }
-        )
-
-        mock_transfer_hook.return_value.wait_for_transfer_job.assert_called_once_with(
-            mock_transfer_hook.return_value.create_transfer_job.return_value
-        )
-
-    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.GCPTransferServiceHook')
-    @mock.patch('airflow.contrib.operators.s3_to_gcs_transfer_operator.S3Hook')
-    def test_execute_skip_wait(self, mock_s3_hook, mock_transfer_hook):
-        """Test the execute function and wait until transfer is complete."""
-
-        operator = S3ToGoogleCloudStorageTransferOperator(
-            task_id=TASK_ID,
-            s3_bucket=S3_BUCKET,
-            gcs_bucket=GCS_BUCKET,
-            project_id=GCP_PROJECT_ID,
-            description=DESCRIPTION,
-            wait=False,
-        )
-
-        mock_s3_hook.return_value.get_credentials.return_value = Credentials(
-            access_key=ACCESS_KEY,
-            secret_key=SECRET_KEY,
-        )
-
-        operator.execute(None)
-
-        mock_transfer_hook.return_value.create_transfer_job.assert_called_once_with(
-            project_id=GCP_PROJECT_ID,
-            description=DESCRIPTION,
-            schedule=None,
-            transfer_spec={
-                'awsS3DataSource': {
-                    'bucketName': S3_BUCKET,
-                    'awsAccessKey': {
-                        'accessKeyId': ACCESS_KEY,
-                        'secretAccessKey': SECRET_KEY,
-                    }
-                },
-                'gcsDataSink': {
-                    'bucketName': GCS_BUCKET,
-                },
-                'objectConditions': {},
-                'transferOptions': {}
-            }
-        )
-
-        assert not mock_transfer_hook.return_value.wait_for_transfer_job.called
diff --git a/tests/contrib/sensors/test_gcp_transfer_sensor.py b/tests/contrib/sensors/test_gcp_transfer_sensor.py
new file mode 100644
index 0000000000000..1daee26791225
--- /dev/null
+++ b/tests/contrib/sensors/test_gcp_transfer_sensor.py
@@ -0,0 +1,148 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from parameterized import parameterized
+
+from airflow.contrib.hooks.gcp_transfer_hook import GcpTransferOperationStatus
+from airflow.contrib.sensors.gcp_transfer_sensor import GCPTransferServiceWaitForJobStatusSensor
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestGcpStorageTransferOperationWaitForJobStatusSensor(unittest.TestCase):
+    @mock.patch('airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceHook')
+    def test_wait_for_status_success(self, mock_tool):
+        operations = [{'metadata': {'status': GcpTransferOperationStatus.SUCCESS}}]
+        mock_tool.return_value.list_transfer_operations.return_value = operations
+        mock_tool.operations_contain_expected_statuses.return_value = True
+
+        op = GCPTransferServiceWaitForJobStatusSensor(
+            task_id='task-id',
+            operation_name='operation-name',
+            job_name='job-name',
+            project_id='project-id',
+            expected_statuses=GcpTransferOperationStatus.SUCCESS,
+        )
+
+        context = {'ti': (mock.Mock(**{'xcom_push.return_value': None}))}
+        result = op.poke(context)
+
+        mock_tool.return_value.list_transfer_operations.assert_called_with(
+            filter={'project_id': 'project-id', 'job_names': ['job-name']}
+        )
+        mock_tool.operations_contain_expected_statuses.assert_called_with(
+            operations=operations, expected_statuses={GcpTransferOperationStatus.SUCCESS}
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceHook')
+    def test_wait_for_status_success_default_expected_status(self, mock_tool):
+
+        op = GCPTransferServiceWaitForJobStatusSensor(
+            task_id='task-id',
+            operation_name='operation-name',
+            job_name='job-name',
+            project_id='project-id',
+            expected_statuses=GcpTransferOperationStatus.SUCCESS,
+        )
+
+        context = {'ti': (mock.Mock(**{'xcom_push.return_value': None}))}
+
+        result = op.poke(context)
+
+        mock_tool.operations_contain_expected_statuses.assert_called_with(
+            operations=mock.ANY, expected_statuses={GcpTransferOperationStatus.SUCCESS}
+        )
+        self.assertTrue(result)
+
+    @mock.patch('airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceHook')
+    def test_wait_for_status_after_retry(self, mock_tool):
+        operations_set = [
+            [{'metadata': {'status': GcpTransferOperationStatus.SUCCESS}}],
+            [{'metadata': {'status': GcpTransferOperationStatus.SUCCESS}}],
+        ]
+
+        mock_tool.return_value.list_transfer_operations.side_effect = operations_set
+        mock_tool.operations_contain_expected_statuses.side_effect = [False, True]
+
+        op = GCPTransferServiceWaitForJobStatusSensor(
+            task_id='task-id',
+            operation_name='operation-name',
+            job_name='job-name',
+            project_id='project-id',
+            expected_statuses=GcpTransferOperationStatus.SUCCESS,
+        )
+
+        context = {'ti': (mock.Mock(**{'xcom_push.return_value': None}))}
+
+        result = op.poke(context)
+        self.assertFalse(result)
+
+        mock_tool.operations_contain_expected_statuses.assert_called_with(
+            operations=operations_set[0], expected_statuses={GcpTransferOperationStatus.SUCCESS}
+        )
+        mock_tool.operations_contain_expected_statuses.reset_mock()
+
+        result = op.poke(context)
+        self.assertTrue(result)
+
+        mock_tool.operations_contain_expected_statuses.assert_called_with(
+            operations=operations_set[1], expected_statuses={GcpTransferOperationStatus.SUCCESS}
+        )
+
+    @parameterized.expand(
+        [
+            (GcpTransferOperationStatus.SUCCESS, {GcpTransferOperationStatus.SUCCESS}),
+            ({GcpTransferOperationStatus.SUCCESS}, {GcpTransferOperationStatus.SUCCESS}),
+            (
+                {GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.SUCCESS},
+                {GcpTransferOperationStatus.SUCCESS, GcpTransferOperationStatus.SUCCESS},
+            ),
+        ]
+    )
+    @mock.patch('airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceHook')
+    def test_wait_for_status_normalize_status(self, expected_status, received_status, mock_tool):
+        operations = [{'metadata': {'status': GcpTransferOperationStatus.SUCCESS}}]
+
+        mock_tool.return_value.list_transfer_operations.return_value = operations
+        mock_tool.operations_contain_expected_statuses.side_effect = [False, True]
+
+        op = GCPTransferServiceWaitForJobStatusSensor(
+            task_id='task-id',
+            operation_name='operation-name',
+            job_name='job-name',
+            project_id='project-id',
+            expected_statuses=expected_status,
+        )
+
+        context = {'ti': (mock.Mock(**{'xcom_push.return_value': None}))}
+
+        result = op.poke(context)
+        self.assertFalse(result)
+
+        mock_tool.operations_contain_expected_statuses.assert_called_with(
+            operations=operations, expected_statuses=received_status
+        )
diff --git a/tests/contrib/utils/gcp_authenticator.py b/tests/contrib/utils/gcp_authenticator.py
index 8cf209cd027e1..cec7ade2da46e 100644
--- a/tests/contrib/utils/gcp_authenticator.py
+++ b/tests/contrib/utils/gcp_authenticator.py
@@ -32,6 +32,7 @@
 GCP_SPANNER_KEY = 'gcp_spanner.json'
 GCP_GCS_KEY = 'gcp_gcs.json'
 GCP_AI_KEY = 'gcp_ai.json'
+GCP_GCS_TRANSFER_KEY = 'gcp_gcs_transfer.json'
 
 KEYPATH_EXTRA = 'extra__google_cloud_platform__key_path'
 KEYFILE_DICT_EXTRA = 'extra__google_cloud_platform__keyfile_dict'

From 203e9a855cde0e33bb1fa62a7aa34138db3b144d Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Sat, 9 Mar 2019 21:38:12 +0800
Subject: [PATCH 723/808] [AIRFLOW-XXX] Add Xiaodong Deng to committers list

---
 docs/project.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/project.rst b/docs/project.rst
index deb8d55f3d17d..7e97272a155b8 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -51,6 +51,7 @@ Committers
 - @feng-tao (Tao Feng)
 - @hiteshs (Hitesh Shah)
 - @jghoman (Jakob Homan)
+- @XD-DENG (Xiaodong Deng)
 
 For the full list of contributors, take a look at `Airflow's Github
 Contributor page:

From 69741fccea0631df957aa35cfdf04f6d1e594fc1 Mon Sep 17 00:00:00 2001
From: Tao Feng <tfeng@lyft.com>
Date: Fri, 22 Mar 2019 15:43:50 -0700
Subject: [PATCH 724/808] [AIRFLOW-XXX] Add Daniel to committer list (#4961)

---
 docs/project.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/project.rst b/docs/project.rst
index 7e97272a155b8..8c8d93cc09b25 100644
--- a/docs/project.rst
+++ b/docs/project.rst
@@ -52,6 +52,7 @@ Committers
 - @hiteshs (Hitesh Shah)
 - @jghoman (Jakob Homan)
 - @XD-DENG (Xiaodong Deng)
+- @dimberman (Daniel Imberman)
 
 For the full list of contributors, take a look at `Airflow's Github
 Contributor page:

From d1d97a2e5c8f9f7a73d94b9ab2ede1a890a83b25 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 27 Mar 2019 17:25:59 +0800
Subject: [PATCH 725/808] [AIRFLOW-4160] Fix redirecting of 'Trigger Dag'
 Button in DAG Page (#4982)

---
 airflow/www/templates/airflow/dag.html      | 2 +-
 airflow/www_rbac/templates/airflow/dag.html | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index c041616736980..48178c85755f3 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -95,7 +95,7 @@ <h4 class="pull-right">
         </a>
       </li>
       <li>
-        <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin=request.base_url) }}"
+        <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin=url_for("airflow.tree", dag_id=dag.dag_id)) }}"
           onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 03b79b298e045..a58782d052068 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -95,7 +95,7 @@ <h4 class="pull-right">
         </a>
       </li>
       <li>
-        <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin=request.base_url ) }}"
+        <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin=url_for('Airflow.tree', dag_id=dag.dag_id)) }}"
           onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG

From 44c06dd5496b684a20a407f419fcaadf41ea5c93 Mon Sep 17 00:00:00 2001
From: Kaxil Naik <kaxilnaik@gmail.com>
Date: Wed, 5 Dec 2018 20:50:16 +0000
Subject: [PATCH 726/808] [AIRFLOW-3408] Remove outdated info from Systemd
 Instructions (#4269)

---
 docs/howto/run-with-systemd.rst | 3 +--
 scripts/systemd/README          | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/howto/run-with-systemd.rst b/docs/howto/run-with-systemd.rst
index 131fc3ddc0612..bbd2235ae45ff 100644
--- a/docs/howto/run-with-systemd.rst
+++ b/docs/howto/run-with-systemd.rst
@@ -27,6 +27,5 @@ have been tested on Redhat based systems. You can copy those to
 based system) you probably need to adjust the unit files.
 
 Environment configuration is picked up from ``/etc/sysconfig/airflow``.
-An example file is supplied. Make sure to specify the ``SCHEDULER_RUNS``
-variable in this file when you run the scheduler. You
+An example file is supplied. You
 can also define here, for example, ``AIRFLOW_HOME`` or ``AIRFLOW_CONFIG``.
diff --git a/scripts/systemd/README b/scripts/systemd/README
index c53144a04c7bd..e32df5f52f638 100644
--- a/scripts/systemd/README
+++ b/scripts/systemd/README
@@ -6,6 +6,6 @@ You can then start the different servers by using systemctl start <service>. Ena
  systemctl enable <service>.
 
 By default the environment configuration points to /etc/sysconfig/airflow . You can copy the "airflow" file in this
-directory and adjust it to your liking. Make sure to specify the SCHEDULER_RUNS variable.
+directory and adjust it to your liking.
 
-With some minor changes they probably work on other systemd systems.
\ No newline at end of file
+With some minor changes they probably work on other systemd systems.

From 85dbe85b7b67c46a1e7060a52986948c479513e2 Mon Sep 17 00:00:00 2001
From: Jyothsna Kullatira <jyothsnapk17@users.noreply.github.com>
Date: Tue, 12 Mar 2019 18:41:44 -0700
Subject: [PATCH 727/808] [AIRFLOW-XXX] Improvements to formatted content in
 documentation (#4835)

* [AIRFLOW-XXX] Improvements to documentation templates
---
 docs/howto/check-health.rst          | 24 +++++++-------
 docs/howto/operator/gcp/compute.rst  | 12 +++----
 docs/howto/operator/gcp/function.rst |  4 +--
 docs/howto/operator/gcp/gcs.rst      |  4 +--
 docs/howto/operator/gcp/spanner.rst  | 10 +++---
 docs/howto/operator/gcp/sql.rst      | 23 ++++++-------
 docs/howto/run-with-systemd.rst      | 27 +++++++++------
 docs/howto/run-with-upstart.rst      | 15 ++++++---
 docs/howto/secure-connections.rst    | 37 +++++++++++++--------
 docs/howto/set-config.rst            | 10 +++---
 docs/howto/use-test-config.rst       | 12 +++----
 docs/howto/write-logs.rst            | 49 ++++++++++++++--------------
 docs/kubernetes.rst                  | 16 +++++++--
 docs/lineage.rst                     | 19 ++++++++---
 docs/metrics.rst                     |  4 ++-
 docs/timezone.rst                    |  2 +-
 docs/tutorial.rst                    |  6 ++--
 17 files changed, 161 insertions(+), 113 deletions(-)

diff --git a/docs/howto/check-health.rst b/docs/howto/check-health.rst
index e18026f1e2802..ca0e63d8f4dc0 100644
--- a/docs/howto/check-health.rst
+++ b/docs/howto/check-health.rst
@@ -19,7 +19,7 @@ Checking Airflow Health Status
 ==============================
 
 To check the health status of your Airflow instance, you can simply access the endpoint
-``"/health"``. It will return a JSON object in which a high-level glance is provided.
+``/health``. It will return a JSON object in which a high-level glance is provided.
 
 .. code-block:: JSON
 
@@ -33,15 +33,17 @@ To check the health status of your Airflow instance, you can simply access the e
     }
   }
 
-* The ``status`` of each component can be either "healthy" or "unhealthy".
+* The ``status`` of each component can be either "healthy" or "unhealthy"
 
-    * The status of ``metadatabase`` is depending on whether a valid connection can be initiated
-      with the database backend of Airflow.
-    * The status of ``scheduler`` is depending on when the latest scheduler heartbeat happened. If the latest
-      scheduler heartbeat happened 30 seconds (default value) earlier than the current time, scheduler component is
-      considered unhealthy. You can also specify this threshold value by changing
-      ``scheduler_health_check_threshold`` in ``scheduler`` section of the ``airflow.cfg`` file.
+  * The status of ``metadatabase`` depends on whether a valid connection can be initiated with the database
+
+  * The status of ``scheduler`` depends on when the latest scheduler heartbeat was received
+
+    * If the last heartbeat was received more than 30 seconds (default value) earlier than the current time, the scheduler is
+      considered unhealthy
+    * This threshold value can be specified using the option ``scheduler_health_check_threshold`` within the
+      ``scheduler`` section in ``airflow.cfg``
+
+Please keep in mind that the HTTP response code of ``/health`` endpoint **should not** be used to determine the health
+status of the application. The return code is only indicative of the state of the rest call (200 for success).
 
-* The response code of ``"/health"`` endpoint is not used to label the health status of the
-  application (it would always be 200). Hence please be reminded not to use the response code here
-  for health-check purpose.
diff --git a/docs/howto/operator/gcp/compute.rst b/docs/howto/operator/gcp/compute.rst
index cc26005dabf4e..a442c2219964a 100644
--- a/docs/howto/operator/gcp/compute.rst
+++ b/docs/howto/operator/gcp/compute.rst
@@ -75,7 +75,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation for start
+See Google Compute Engine API documentation to `start an instance
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/start>`_.
 
 .. _howto/operator:GceInstanceStopOperator:
@@ -130,7 +130,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation for stop
+See Google Compute Engine API documentation to `stop an instance
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/stop>`_.
 
 .. _howto/operator:GceSetMachineTypeOperator:
@@ -191,7 +191,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation for setMachineType
+See Google Compute Engine API documentation to `set the machine type
 <https://cloud.google.com/compute/docs/reference/rest/v1/instances/setMachineType>`_.
 
 .. _howto/operator:GceInstanceTemplateCopyOperator:
@@ -252,7 +252,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation for instanceTemplates
+See Google Compute Engine API documentation to `create a new instance with an existing template
 <https://cloud.google.com/compute/docs/reference/rest/v1/instanceTemplates>`_.
 
 .. _howto/operator:GceInstanceGroupManagerUpdateTemplateOperator:
@@ -260,7 +260,7 @@ See `Google Compute Engine API documentation for instanceTemplates
 GceInstanceGroupManagerUpdateTemplateOperator
 ---------------------------------------------
 
-Use the operator to update template in Google Compute Engine Instance Group Manager.
+Use the operator to update a template in Google Compute Engine Instance Group Manager.
 
 For parameter definition, take a look at
 :class:`~airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator`.
@@ -321,5 +321,5 @@ the permissions that theService Account User role provides
 More information
 """"""""""""""""
 
-See `Google Compute Engine API documentation for instanceGroupManagers
+See Google Compute Engine API documentation to `manage a group instance
 <https://cloud.google.com/compute/docs/reference/rest/v1/instanceGroupManagers>`_.
diff --git a/docs/howto/operator/gcp/function.rst b/docs/howto/operator/gcp/function.rst
index 14e7722f3969f..61ba01510c22f 100644
--- a/docs/howto/operator/gcp/function.rst
+++ b/docs/howto/operator/gcp/function.rst
@@ -64,7 +64,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation for delete
+See Google Cloud Functions API documentation to `delete a function
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/delete>`_.
 
 .. _howto/operator:GcfFunctionDeployOperator:
@@ -198,5 +198,5 @@ can be downloaded if necessary.
 More information
 """"""""""""""""
 
-See `Google Cloud Functions API documentation for create
+See Google Cloud API documentation `to create a function
 <https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions/create>`_.
diff --git a/docs/howto/operator/gcp/gcs.rst b/docs/howto/operator/gcp/gcs.rst
index c277900c51702..6df9c1c1c6b31 100644
--- a/docs/howto/operator/gcp/gcs.rst
+++ b/docs/howto/operator/gcp/gcs.rst
@@ -79,7 +79,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Storage BucketAccessControls insert documentation
+See Google Cloud Storage Documentation to `create a new ACL entry for a bucket
 <https://cloud.google.com/storage/docs/json_api/v1/bucketAccessControls/insert>`_.
 
 .. _howto/operator:GoogleCloudStorageObjectCreateAclEntryOperator:
@@ -123,5 +123,5 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Storage ObjectAccessControls insert documentation
+See Google Cloud Storage insert documentation to `create a ACL entry for ObjectAccess
 <https://cloud.google.com/storage/docs/json_api/v1/objectAccessControls/insert>`_.
diff --git a/docs/howto/operator/gcp/spanner.rst b/docs/howto/operator/gcp/spanner.rst
index 0ad700cf68b46..644c1c4b93f0c 100644
--- a/docs/howto/operator/gcp/spanner.rst
+++ b/docs/howto/operator/gcp/spanner.rst
@@ -67,7 +67,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Spanner API documentation for database drop call
+See `Google Cloud Spanner API documentation to drop an instance of a database
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/dropDatabase>`_.
 
 .. _howto/operator:CloudSpannerInstanceDatabaseDeployOperator:
@@ -117,8 +117,8 @@ Templating
 More information
 """"""""""""""""
 
-See Google Cloud Spanner API documentation for `database create
-<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_
+See Google Cloud Spanner API documentation `to create a new database
+<https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances.databases/create>`_.
 
 .. _howto/operator:CloudSpannerInstanceDatabaseUpdateOperator:
 
@@ -224,7 +224,7 @@ Templating
 More information
 """"""""""""""""
 
-See Google Cloud Spanner API documentation for `the DML syntax
+See Google Cloud Spanner API documentation for more information about `DML syntax
 <https://cloud.google.com/spanner/docs/dml-syntax>`_.
 
 .. _howto/operator:CloudSpannerInstanceDeleteOperator:
@@ -272,5 +272,5 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud Spanner API documentation for instance delete
+See Google Cloud Spanner API documentation to `delete an instance
 <https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instances/delete>`_.
diff --git a/docs/howto/operator/gcp/sql.rst b/docs/howto/operator/gcp/sql.rst
index e5eb41e131577..77ec21a44e404 100644
--- a/docs/howto/operator/gcp/sql.rst
+++ b/docs/howto/operator/gcp/sql.rst
@@ -73,7 +73,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for database insert
+See Google Cloud SQL API documentation for `to create a new database inside the instance
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/insert>`_.
 
 .. _howto/operator:CloudSqlInstanceDatabaseDeleteOperator:
@@ -120,7 +120,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for database delete
+See Google Cloud SQL API documentation to `delete a database
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/delete>`_.
 
 .. _howto/operator:CloudSqlInstanceDatabasePatchOperator:
@@ -176,7 +176,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for database patch
+See Google Cloud SQL API documentation to `update a database
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/databases/patch>`_.
 
 .. _howto/operator:CloudSqlInstanceDeleteOperator:
@@ -234,7 +234,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for delete
+See Google Cloud SQL API documentation to `delete a SQL instance
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/delete>`_.
 
 .. _howto/operator:CloudSqlInstanceExportOperator:
@@ -298,8 +298,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for export <https://cloud.google
-.com/sql/docs/mysql/admin-api/v1beta4/instances/export>`_.
+See Google Cloud SQL API documentation to `export data
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/export>`_.
 
 Troubleshooting
 """""""""""""""
@@ -395,7 +395,8 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for import <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/import>`_.
+See Google Cloud SQL API documentation to `import data
+<https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/import>`_.
 
 Troubleshooting
 """""""""""""""
@@ -489,7 +490,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for insert
+See Google Cloud SQL API documentation to `create an instance
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/insert>`_.
 
 .. _howto/operator:CloudSqlInstancePatchOperator:
@@ -547,7 +548,7 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL API documentation for patch
+See Google Cloud SQL API documentation to `patch an instance
 <https://cloud.google.com/sql/docs/mysql/admin-api/v1beta4/instances/patch>`_.
 
 .. _howto/operator:CloudSqlQueryOperator:
@@ -639,5 +640,5 @@ Templating
 More information
 """"""""""""""""
 
-See `Google Cloud SQL Proxy documentation
-<https://cloud.google.com/sql/docs/postgres/sql-proxy>`_.
+See Google Cloud SQL documentation for `MySQL <https://cloud.google.com/sql/docs/mysql/sql-proxy>`_ and
+`PostgreSQL <https://cloud.google.com/sql/docs/postgres/sql-proxy>`_ related proxies.
diff --git a/docs/howto/run-with-systemd.rst b/docs/howto/run-with-systemd.rst
index bbd2235ae45ff..e225c4a35ecfd 100644
--- a/docs/howto/run-with-systemd.rst
+++ b/docs/howto/run-with-systemd.rst
@@ -19,13 +19,20 @@ Running Airflow with systemd
 ============================
 
 Airflow can integrate with systemd based systems. This makes watching your
-daemons easy as systemd can take care of restarting a daemon on failure.
-In the ``scripts/systemd`` directory you can find unit files that
-have been tested on Redhat based systems. You can copy those to
-``/usr/lib/systemd/system``. It is assumed that Airflow will run under
-``airflow:airflow``. If not (or if you are running on a non Redhat
-based system) you probably need to adjust the unit files.
-
-Environment configuration is picked up from ``/etc/sysconfig/airflow``.
-An example file is supplied. You
-can also define here, for example, ``AIRFLOW_HOME`` or ``AIRFLOW_CONFIG``.
+daemons easy as `systemd` can take care of restarting a daemon on failures.
+
+In the ``scripts/systemd`` directory, you can find unit files that
+have been tested on Redhat based systems. These files can be used as-is by copying them over to
+``/usr/lib/systemd/system``.
+
+The following **assumptions** have been made while creating these unit files:
+
+#. Airflow runs as the following `user:group` ``airflow:airflow``.
+#. Airflow runs on a Redhat based system.
+
+If this is not the case, appropriate changes will need to be made.
+
+Please **note** that environment configuration is picked up from ``/etc/sysconfig/airflow``.
+
+An example file is supplied within ``scripts/systemd``.
+You can also define configuration at ``AIRFLOW_HOME`` or ``AIRFLOW_CONFIG``.
diff --git a/docs/howto/run-with-upstart.rst b/docs/howto/run-with-upstart.rst
index adfb85a31effc..a45a07de8f3c0 100644
--- a/docs/howto/run-with-upstart.rst
+++ b/docs/howto/run-with-upstart.rst
@@ -22,12 +22,17 @@ Airflow can integrate with upstart based systems. Upstart automatically starts a
 have a corresponding ``*.conf`` file in ``/etc/init`` upon system boot. On failure, upstart automatically restarts
 the process (until it reaches re-spawn limit set in a ``*.conf`` file).
 
-You can find sample upstart job files in the ``scripts/upstart`` directory. These files have been tested on
-Ubuntu 14.04 LTS. You may have to adjust ``start on`` and ``stop on`` stanzas to make it work on other upstart
-systems. Some of the possible options are listed in ``scripts/upstart/README``.
+You can find sample upstart job files in the ``scripts/upstart`` directory.
 
-Modify ``*.conf`` files as needed and copy to ``/etc/init`` directory. It is assumed that airflow will run
-under ``airflow:airflow``. Change ``setuid`` and ``setgid`` in ``*.conf`` files if you use other user/group
+The following assumptions have been used while creating these unit files:
+
+1. Airflow will run as the following `user:group` ``airflow:airflow``.
+    Change ``setuid`` and ``setgid`` appropriately in ``*.conf`` if airflow runs as a different user or group
+2. These files have been tested on **Ubuntu 14.04 LTS**
+    You may have to adjust ``start on`` and ``stop on`` stanzas to make it work on other upstart systems.
+    Some of the possible options are listed in ``scripts/upstart/README``
+
+Modify ``*.conf`` files as needed and copy to ``/etc/init`` directory.
 
 You can use ``initctl`` to manually start, stop, view status of the airflow process that has been
 integrated with upstart
diff --git a/docs/howto/secure-connections.rst b/docs/howto/secure-connections.rst
index eef49b3234982..a9240e1e20426 100644
--- a/docs/howto/secure-connections.rst
+++ b/docs/howto/secure-connections.rst
@@ -30,21 +30,32 @@ You can still enable encryption for passwords within connections by following be
 #. Install crypto package ``pip install 'apache-airflow[crypto]'``
 #. Generate fernet_key, using this code snippet below. ``fernet_key`` must be a base64-encoded 32-byte key:
 
-.. code:: python
+    .. code:: python
 
-    from cryptography.fernet import Fernet
-    fernet_key= Fernet.generate_key()
-    print(fernet_key.decode()) # your fernet_key, keep it in secured place!
+      from cryptography.fernet import Fernet
+      fernet_key= Fernet.generate_key()
+      print(fernet_key.decode()) # your fernet_key, keep it in secured place!
 
-3. Replace ``airflow.cfg`` fernet_key value with the one from step 2.
-   Alternatively, you can store your fernet_key in OS environment variable. You
-   do not need to change ``airflow.cfg`` in this case as Airflow will use environment
-   variable over the value in ``airflow.cfg``:
+#. Replace ``airflow.cfg`` fernet_key value with the one from `Step 2`. *Alternatively,* you can store your fernet_key in OS environment variable - You do not need to change ``airflow.cfg`` in this case as Airflow will use environment variable over the value in ``airflow.cfg``:
 
-   .. code-block:: bash
+    .. code-block:: bash
 
-     # Note the double underscores
-     export AIRFLOW__CORE__FERNET_KEY=your_fernet_key
+      # Note the double underscores
+      export AIRFLOW__CORE__FERNET_KEY=your_fernet_key
 
-4. Restart Airflow webserver.
-5. For existing connections (the ones that you had defined before installing ``airflow[crypto]`` and creating a Fernet key), you need to open each connection in the connection admin UI, re-type the password, and save it.
+#. Restart the webserver
+#. For existing connections (the ones that you had defined before installing ``airflow[crypto]`` and creating a Fernet key), you need to open each connection in the connection admin UI, re-type the password, and save the change
+
+Rotating encryption keys
+========================
+
+Once connection credentials and variables have been encrypted using a fernet
+key, changing the key will cause decryption of existing credentials to fail. To
+rotate the fernet key without invalidating existing encrypted values, prepend
+the new key to the ``fernet_key`` setting, run
+``airflow rotate_fernet_key``, and then drop the original key from
+``fernet_keys``:
+
+#. Set ``fernet_key`` to ``new_fernet_key,old_fernet_key``
+#. Run ``airflow rotate_fernet_key`` to re-encrypt existing credentials with the new fernet key
+#. Set ``fernet_key`` to ``new_fernet_key``
diff --git a/docs/howto/set-config.rst b/docs/howto/set-config.rst
index 6d54444547248..dbbfe6198d792 100644
--- a/docs/howto/set-config.rst
+++ b/docs/howto/set-config.rst
@@ -58,9 +58,9 @@ The following config options support this ``_cmd`` version:
 
 The idea behind this is to not store passwords on boxes in plain text files.
 
-The order of precedence for all config options is as follows -
+The universal order of precedence for all configuration options is as follows:
 
-1. environment variable
-2. configuration in airflow.cfg
-3. command in airflow.cfg
-4. Airflow's built in defaults
+#. set as an environment variable
+#. set in ``airflow.cfg``
+#. command in ``airflow.cfg``
+#. Airflow's built in defaults
diff --git a/docs/howto/use-test-config.rst b/docs/howto/use-test-config.rst
index 4f272afe96f35..e871d87b41fc2 100644
--- a/docs/howto/use-test-config.rst
+++ b/docs/howto/use-test-config.rst
@@ -19,16 +19,14 @@ Using the Test Mode Configuration
 =================================
 
 Airflow has a fixed set of "test mode" configuration options. You can load these
-at any time by calling ``airflow.configuration.load_test_config()`` (note this
-operation is not reversible!). However, some options (like the DAG_FOLDER) are
-loaded before you have a chance to call load_test_config(). In order to eagerly load
-the test configuration, set test_mode in airflow.cfg:
+at any time by calling ``airflow.configuration.load_test_config()``. Please **note** that this operation is **not reversible**.
+
+Some options for example, DAG_FOLDER, are loaded before you have a chance to call load_test_config().
+In order to eagerly load the test configuration, set test_mode in airflow.cfg:
 
 .. code-block:: bash
 
   [tests]
   unit_test_mode = True
 
-Due to Airflow's automatic environment variable expansion (see :doc:`set-config`),
-you can also set the env var ``AIRFLOW__CORE__UNIT_TEST_MODE`` to temporarily overwrite
-airflow.cfg.
+Due to Airflow's automatic environment variable expansion (see :doc:`set-config`), you can also set the environment variable ``AIRFLOW__CORE__UNIT_TEST_MODE`` to temporarily overwrite airflow.cfg.
diff --git a/docs/howto/write-logs.rst b/docs/howto/write-logs.rst
index b12b60ef86def..b069c5a50a438 100644
--- a/docs/howto/write-logs.rst
+++ b/docs/howto/write-logs.rst
@@ -21,35 +21,35 @@ Writing Logs
 Writing Logs Locally
 --------------------
 
-Users can specify a logs folder in ``airflow.cfg`` using the
-``base_log_folder`` setting. By default, it is in the ``AIRFLOW_HOME``
+Users can specify the directory to place log files in ``airflow.cfg`` using
+``base_log_folder``. By default, logs are placed in the ``AIRFLOW_HOME``
 directory.
 
-In addition, users can supply a remote location for storing logs and log
-backups in cloud storage.
+The following convention is followed while naming logs: ``{dag_id}/{task_id}/{execution_date}/{try_number}.log``
+
+In addition, users can supply a remote location to store current logs and backups.
 
 In the Airflow Web UI, local logs take precedence over remote logs. If local logs
 can not be found or accessed, the remote logs will be displayed. Note that logs
-are only sent to remote storage once a task completes (including failure). In other
-words, remote logs for running tasks are unavailable. Logs are stored in the log
-folder as ``{dag_id}/{task_id}/{execution_date}/{try_number}.log``.
+are only sent to remote storage once a task is complete (including failure); In other words, remote logs for
+running tasks are unavailable.
+
+Before you begin
+''''''''''''''''
+
+Remote logging uses an existing Airflow connection to read or write logs. If you
+don't have a connection properly setup, this process will fail.
 
 .. _write-logs-amazon:
 
 Writing Logs to Amazon S3
 -------------------------
 
-Before you begin
-''''''''''''''''
-
-Remote logging uses an existing Airflow connection to read/write logs. If you
-don't have a connection properly setup, this will fail.
 
 Enabling remote logging
 '''''''''''''''''''''''
 
-To enable this feature, ``airflow.cfg`` must be configured as in this
-example:
+To enable this feature, ``airflow.cfg`` must be configured as follows:
 
 .. code-block:: bash
 
@@ -71,11 +71,12 @@ Writing Logs to Azure Blob Storage
 ----------------------------------
 
 Airflow can be configured to read and write task logs in Azure Blob Storage.
-Follow the steps below to enable Azure Blob Storage logging.
 
-#. Airflow's logging system requires a custom .py file to be located in the ``PYTHONPATH``, so that it's importable from Airflow. Start by creating a directory to store the config file. ``$AIRFLOW_HOME/config`` is recommended.
+Follow the steps below to enable Azure Blob Storage logging:
+
+#. Airflow's logging system requires a custom `.py` file to be located in the ``PYTHONPATH``, so that it's importable from Airflow. Start by creating a directory to store the config file, ``$AIRFLOW_HOME/config`` is recommended.
 #. Create empty files called ``$AIRFLOW_HOME/config/log_config.py`` and ``$AIRFLOW_HOME/config/__init__.py``.
-#. Copy the contents of ``airflow/config_templates/airflow_local_settings.py`` into the ``log_config.py`` file that was just created in the step above.
+#. Copy the contents of ``airflow/config_templates/airflow_local_settings.py`` into the ``log_config.py`` file created in `Step 2`.
 #. Customize the following portions of the template:
 
     .. code-block:: bash
@@ -127,12 +128,12 @@ example:
 #. Verify that logs are showing up for newly executed tasks in the bucket you've defined.
 #. Verify that the Google Cloud Storage viewer is working in the UI. Pull up a newly executed task, and verify that you see something like:
 
-    .. code-block:: bash
+.. code-block:: bash
 
-        *** Reading remote log from gs://<bucket where logs should be persisted>/example_bash_operator/run_this_last/2017-10-03T00:00:00/16.log.
-        [2017-10-03 21:57:50,056] {cli.py:377} INFO - Running on host chrisr-00532
-        [2017-10-03 21:57:50,093] {base_task_runner.py:115} INFO - Running: ['bash', '-c', u'airflow run example_bash_operator run_this_last 2017-10-03T00:00:00 --job_id 47 --raw -sd DAGS_FOLDER/example_dags/example_bash_operator.py']
-        [2017-10-03 21:57:51,264] {base_task_runner.py:98} INFO - Subtask: [2017-10-03 21:57:51,263] {__init__.py:45} INFO - Using executor SequentialExecutor
-        [2017-10-03 21:57:51,306] {base_task_runner.py:98} INFO - Subtask: [2017-10-03 21:57:51,306] {models.py:186} INFO - Filling up the DagBag from /airflow/dags/example_dags/example_bash_operator.py
+  *** Reading remote log from gs://<bucket where logs should be persisted>/example_bash_operator/run_this_last/2017-10-03T00:00:00/16.log.
+  [2017-10-03 21:57:50,056] {cli.py:377} INFO - Running on host chrisr-00532
+  [2017-10-03 21:57:50,093] {base_task_runner.py:115} INFO - Running: ['bash', '-c', u'airflow run example_bash_operator run_this_last 2017-10-03T00:00:00 --job_id 47 --raw -sd DAGS_FOLDER/example_dags/example_bash_operator.py']
+  [2017-10-03 21:57:51,264] {base_task_runner.py:98} INFO - Subtask: [2017-10-03 21:57:51,263] {__init__.py:45} INFO - Using executor SequentialExecutor
+  [2017-10-03 21:57:51,306] {base_task_runner.py:98} INFO - Subtask: [2017-10-03 21:57:51,306] {models.py:186} INFO - Filling up the DagBag from /airflow/dags/example_dags/example_bash_operator.py
 
-Note the top line that says it's reading from the remote log file.
+**Note** that the path to the remote log file is listed on the first line.
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index abfeedb008be7..1d4906f6c4fb7 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -23,10 +23,20 @@ Kubernetes Executor
 
 The kubernetes executor is introduced in Apache Airflow 1.10.0. The Kubernetes executor will create a new pod for every task instance.
 
-Example helm charts are available at `scripts/ci/kubernetes/kube/{airflow,volumes,postgres}.yaml` in the source distribution. The volumes are optional and depend on your configuration. There are two volumes available:
+Example helm charts are available at ``scripts/ci/kubernetes/kube/{airflow,volumes,postgres}.yaml`` in the source distribution.
+The volumes are optional and depend on your configuration. There are two volumes available:
 
-- Dags: by storing all the dags onto the persistent disks, all the workers can read the dags from there. Another option is using git-sync, before starting the container, a git pull of the dags repository will be performed and used throughout the lifecycle of the pod.
-- Logs: by storing the logs onto a persistent disk, all the logs will be available for all the workers and the webserver itself. If you don't configure this, the logs will be lost after the worker pods shuts down. Another option is to use S3/GCS/etc to store the logs.
+- **Dags**:
+
+  - By storing dags onto persistent disk, it will be made available to all workers
+
+  - Another option is to use ``git-sync``. Before starting the container, a git pull of the dags repository will be performed and used throughout the lifecycle of the pod
+
+- **Logs**:
+
+  - By storing logs onto a persistent disk, the files are accessible by workers and the webserver. If you don't configure this, the logs will be lost after the worker pods shuts down
+
+  - Another option is to use S3/GCS/etc to store logs
 
 
 Kubernetes Operator
diff --git a/docs/lineage.rst b/docs/lineage.rst
index c94fe70e045c9..8aa7cac2bb9e6 100644
--- a/docs/lineage.rst
+++ b/docs/lineage.rst
@@ -64,10 +64,19 @@ works.
     run_this.set_downstream(run_this_last)
 
 
-Tasks take the parameters `inlets` and `outlets`. Inlets can be manually defined by a list of dataset `{"datasets":
-[dataset1, dataset2]}` or can be configured to look for outlets from upstream tasks `{"task_ids": ["task_id1", "task_id2"]}`
-or can be configured to pick up outlets from direct upstream tasks `{"auto": True}` or a combination of them. Outlets 
-are defined as list of dataset `{"datasets": [dataset1, dataset2]}`. Any fields for the dataset are templated with 
+Tasks take the parameters `inlets` and `outlets`.
+
+Inlets can be manually defined by the following options:
+
+- by a list of dataset ``{"datasets": [dataset1, dataset2]}``
+
+- can be configured to look for outlets from upstream tasks ``{"task_ids": ["task_id1", "task_id2"]}``
+
+- can be configured to pick up outlets from direct upstream tasks ``{"auto": True}``
+
+- a combination of them
+
+Outlets are defined as list of dataset ``{"datasets": [dataset1, dataset2]}``. Any fields for the dataset are templated with
 the context when the task is being executed. 
 
 .. note:: Operators can add inlets and outlets automatically if the operator supports it.
@@ -85,7 +94,7 @@ Apache Atlas
 ------------
 
 Airflow can send its lineage metadata to Apache Atlas. You need to enable the `atlas` backend and configure it 
-properly, e.g. in your `airflow.cfg`:
+properly, e.g. in your ``airflow.cfg``:
 
 .. code:: python
 
diff --git a/docs/metrics.rst b/docs/metrics.rst
index 52f4a35103f97..fb34b97e6498d 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -18,9 +18,11 @@
 Metrics
 =======
 
+Airflow can be set up to send metrics to `StatsD <https://github.com/etsy/statsd>`__:
+
 Configuration
 -------------
-Airflow can be set up to send metrics to `StatsD <https://github.com/etsy/statsd>`__:
+Add the following lines to your configuration file e.g. ``airflow.cfg``
 
 .. code-block:: bash
 
diff --git a/docs/timezone.rst b/docs/timezone.rst
index 078f948c4f903..a5a9d094410ec 100644
--- a/docs/timezone.rst
+++ b/docs/timezone.rst
@@ -34,7 +34,7 @@ happen. (The pendulum and pytz documentation discusses these issues in greater d
 for a simple DAG, but it’s a problem if you are in, for example, financial services where you have end of day
 deadlines to meet.
 
-The time zone is set in `airflow.cfg`. By default it is set to utc, but you change it to use the system’s settings or
+The time zone is set in ``airflow.cfg``. By default it is set to utc, but you change it to use the system’s settings or
 an arbitrary IANA time zone, e.g. `Europe/Amsterdam`. It is dependent on `pendulum`, which is more accurate than `pytz`.
 Pendulum is installed when you install Airflow.
 
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index 9d1c94f5b9b71..aa64cb859c224 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -368,8 +368,10 @@ Testing
 Running the Script
 ''''''''''''''''''
 
-Time to run some tests. First let's make sure that the pipeline
-parses. Let's assume we're saving the code from the previous step in
+Time to run some tests. First, let's make sure the pipeline
+is parsed successfully.
+
+Let's assume we're saving the code from the previous step in
 ``tutorial.py`` in the DAGs folder referenced in your ``airflow.cfg``.
 The default location for your DAGs is ``~/airflow/dags``.
 

From 5b7d835c5da9082567f88e1798635334cf97cd3f Mon Sep 17 00:00:00 2001
From: Daniel Mateus Pires <dmateusp@gmail.com>
Date: Fri, 1 Mar 2019 14:59:29 +0000
Subject: [PATCH 728/808] [AIRFLOW-3918] Add ssh private-key support to
 git-sync for KubernetesExecutor (#4777)

Add configuration for git SSH auth and update git-sync version in
template (mutually exclusive of user authentication).

Update git-sync version to the latest, current version did not
support SSH authentication environment variables

Security context was required to read the mounted SSH key for
git-sync SSH authentication

Add example of configmap + Kubernetes secret snippet in config template
---
 airflow/config_templates/default_airflow.cfg  |  36 ++-
 .../contrib/executors/kubernetes_executor.py  |  16 +-
 .../kubernetes_request_factory.py             |   5 +
 .../pod_request_factory.py                    |   1 +
 airflow/contrib/kubernetes/pod.py             |   4 +
 .../kubernetes/worker_configuration.py        | 107 +++++++--
 .../executors/test_kubernetes_executor.py     | 205 +++++++++++++++++-
 7 files changed, 342 insertions(+), 32 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index f4ed342e027fc..06a6053ef1238 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -643,18 +643,48 @@ logs_volume_host =
 # Git credentials and repository for DAGs mounted via Git (mutually exclusive with volume claim)
 git_repo =
 git_branch =
+git_subpath =
+# Use git_user and git_password for user authentication or git_ssh_key_secret_name and git_ssh_key_secret_key
+# for SSH authentication
 git_user =
 git_password =
-git_subpath =
 git_sync_root = /git
 git_sync_dest = repo
 # Mount point of the volume if git-sync is being used.
 # i.e. {AIRFLOW_HOME}/dags
 git_dags_folder_mount_point =
 
+# To get Git-sync SSH authentication set up follow this format
+#
+# airflow-secrets.yaml:
+# ---
+# apiVersion: v1
+# kind: Secret
+# metadata:
+#   name: airflow-secrets
+# data:
+#   # key needs to be gitSshKey
+#   gitSshKey: <base64_encoded_data>
+# ---
+# airflow-configmap.yaml:
+# apiVersion: v1
+# kind: ConfigMap
+# metadata:
+#   name: airflow-configmap
+# data:
+#   known_hosts: |
+#       github.com ssh-rsa <...>
+#   airflow.cfg: |
+#       ...
+#
+# git_ssh_key_secret_name = airflow-secrets
+# git_ssh_known_hosts_configmap_name = airflow-configmap
+git_ssh_key_secret_name =
+git_ssh_known_hosts_configmap_name =
+
 # For cloning DAGs from git repositories into volumes: https://github.com/kubernetes/git-sync
-git_sync_container_repository = gcr.io/google-containers/git-sync-amd64
-git_sync_container_tag = v2.0.5
+git_sync_container_repository = k8s.gcr.io/git-sync
+git_sync_container_tag = v3.1.1
 git_sync_init_container_name = git-sync-clone
 
 # The name of the Kubernetes service account to be associated with airflow workers, if any.
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 994b45b4c9df1..b15fdb49fa7de 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -166,10 +166,13 @@ def __init__(self):
         self.git_dags_folder_mount_point = conf.get(self.kubernetes_section,
                                                     'git_dags_folder_mount_point')
 
-        # Optionally a user may supply a `git_user` and `git_password` for private
-        # repositories
+        # Optionally a user may supply a (`git_user` AND `git_password`) OR
+        # (`git_ssh_key_secret_name` AND `git_ssh_key_secret_key`) for private repositories
         self.git_user = conf.get(self.kubernetes_section, 'git_user')
         self.git_password = conf.get(self.kubernetes_section, 'git_password')
+        self.git_ssh_key_secret_name = conf.get(self.kubernetes_section, 'git_ssh_key_secret_name')
+        self.git_ssh_known_hosts_configmap_name = conf.get(self.kubernetes_section,
+                                                           'git_ssh_known_hosts_configmap_name')
 
         # NOTE: The user may optionally use a volume claim to mount a PV containing
         # DAGs directly
@@ -254,6 +257,15 @@ def _validate(self):
                 'or `dags_volume_host` '
                 'or `dags_in_image` '
                 'or `git_repo and git_branch and git_dags_folder_mount_point`')
+        if self.git_repo \
+           and (self.git_user or self.git_password) \
+           and self.git_ssh_key_secret_name:
+            raise AirflowConfigException(
+                'In kubernetes mode, using `git_repo` to pull the DAGs: '
+                'for private repositories, either `git_user` and `git_password` '
+                'must be set for authentication through user credentials; '
+                'or `git_ssh_key_secret_name` must be set for authentication '
+                'through ssh key, but not both')
 
 
 class KubernetesJobWatcher(multiprocessing.Process, LoggingMixin, object):
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index bc424d57abf9e..50959d276d6c5 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -191,3 +191,8 @@ def extract_image_pull_secrets(pod, req):
     def extract_tolerations(pod, req):
         if pod.tolerations:
             req['spec']['tolerations'] = pod.tolerations
+
+    @staticmethod
+    def extract_security_context(pod, req):
+        if pod.security_context:
+            req['spec']['securityContext'] = pod.security_context
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index 5bd6b23e11b9f..cb93be8754f16 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -62,6 +62,7 @@ def create(self, pod):
         self.extract_affinity(pod, req)
         self.extract_hostnetwork(pod, req)
         self.extract_tolerations(pod, req)
+        self.extract_security_context(pod, req)
         return req
 
 
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 96947a79a3e95..889d3cd5972d5 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -64,6 +64,8 @@ class Pod:
     :type hostnetwork: bool
     :param tolerations: A list of kubernetes tolerations
     :type tolerations: list
+    :param security_context: A dict containing the security context for the pod
+    :type security_context: dict
     """
     def __init__(
             self,
@@ -88,6 +90,7 @@ def __init__(
             affinity=None,
             hostnetwork=False,
             tolerations=None,
+            security_context=None,
     ):
         self.image = image
         self.envs = envs or {}
@@ -110,3 +113,4 @@ def __init__(
         self.affinity = affinity or {}
         self.hostnetwork = hostnetwork or False
         self.tolerations = tolerations or []
+        self.security_context = security_context
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 0d301e910e1c8..e8bc7384a0f82 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -15,11 +15,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import copy
 import os
 import six
 
-from airflow import AirflowException
 from airflow.configuration import conf
 from airflow.contrib.kubernetes.pod import Pod, Resources
 from airflow.contrib.kubernetes.secret import Secret
@@ -29,18 +27,22 @@
 class WorkerConfiguration(LoggingMixin):
     """Contains Kubernetes Airflow Worker configuration logic"""
 
+    dags_volume_name = 'airflow-dags'
+    logs_volume_name = 'airflow-logs'
+    git_sync_ssh_secret_volume_name = 'git-sync-ssh-key'
+    git_ssh_key_secret_key = 'gitSshKey'
+    git_sync_ssh_known_hosts_volume_name = 'git-sync-known-hosts'
+    git_ssh_known_hosts_configmap_key = 'known_hosts'
+
     def __init__(self, kube_config):
         self.kube_config = kube_config
         self.worker_airflow_home = self.kube_config.airflow_home
         self.worker_airflow_dags = self.kube_config.dags_folder
         self.worker_airflow_logs = self.kube_config.base_log_folder
 
-        self.dags_volume_name = 'airflow-dags'
-        self.logs_volume_name = 'airflow-logs'
-
         super(WorkerConfiguration, self).__init__()
 
-    def _get_init_containers(self, volume_mounts):
+    def _get_init_containers(self):
         """When using git to retrieve the DAGs, use the GitSync Init Container"""
         # If we're using volume claims to mount the dags, no init container is needed
         if self.kube_config.dags_volume_claim or \
@@ -78,19 +80,54 @@ def _get_init_containers(self, volume_mounts):
                 'value': self.kube_config.git_password
             })
 
-        if self.dags_volume_name not in volume_mounts:
-            raise AirflowException(
-                "GitSync enabled but volume %s is not defined." % self.dags_volume_name)
-
-        volume_mounts[self.dags_volume_name]['mountPath'] = self.kube_config.git_sync_root
-        volume_mounts[self.dags_volume_name]['readOnly'] = False
+        volume_mounts = [{
+            'mountPath': self.kube_config.git_sync_root,
+            'name': self.dags_volume_name,
+            'readOnly': False
+        }]
+        if self.kube_config.git_ssh_key_secret_name:
+            volume_mounts.append({
+                'name': self.git_sync_ssh_secret_volume_name,
+                'mountPath': '/etc/git-secret/ssh',
+                'subPath': 'ssh'
+            })
+            init_environment.extend([
+                {
+                    'name': 'GIT_SSH_KEY_FILE',
+                    'value': '/etc/git-secret/ssh'
+                },
+                {
+                    'name': 'GIT_SYNC_SSH',
+                    'value': 'true'
+                }])
+        if self.kube_config.git_ssh_known_hosts_configmap_name:
+            volume_mounts.append({
+                'name': self.git_sync_ssh_known_hosts_volume_name,
+                'mountPath': '/etc/git-secret/known_hosts',
+                'subPath': 'known_hosts'
+            })
+            init_environment.extend([
+                {
+                    'name': 'GIT_KNOWN_HOSTS',
+                    'value': 'true'
+                },
+                {
+                    'name': 'GIT_SSH_KNOWN_HOSTS_FILE',
+                    'value': '/etc/git-secret/known_hosts'
+                }
+            ])
+        else:
+            init_environment.append({
+                'name': 'GIT_KNOWN_HOSTS',
+                'value': 'false'
+            })
 
         return [{
             'name': self.kube_config.git_sync_init_container_name,
             'image': self.kube_config.git_sync_container,
-            'securityContext': {'runAsUser': 0},
+            'securityContext': {'runAsUser': 65533},  # git-sync user
             'env': init_environment,
-            'volumeMounts': [value for value in volume_mounts.values()]
+            'volumeMounts': volume_mounts
         }]
 
     def _get_environment(self):
@@ -133,7 +170,16 @@ def _get_image_pull_secrets(self):
             return []
         return self.kube_config.image_pull_secrets.split(',')
 
-    def init_volumes_and_mounts(self):
+    def _get_security_context(self):
+        """Defines the security context"""
+        if self.kube_config.git_ssh_key_secret_name:
+            return {
+                'fsGroup': 65533  # to make SSH key readable
+            }
+        else:
+            return None
+
+    def _get_volumes_and_mounts(self):
         def _construct_volume(name, claim, host):
             volume = {
                 'name': name
@@ -186,6 +232,29 @@ def _construct_volume(name, claim, host):
             del volumes[self.dags_volume_name]
             del volume_mounts[self.dags_volume_name]
 
+        # Get the SSH key from secrets as a volume
+        if self.kube_config.git_ssh_key_secret_name:
+            volumes[self.git_sync_ssh_secret_volume_name] = {
+                'name': self.git_sync_ssh_secret_volume_name,
+                'secret': {
+                    'secretName': self.kube_config.git_ssh_key_secret_name,
+                    'items': [{
+                        'key': self.git_ssh_key_secret_key,
+                        'path': 'ssh',
+                        'mode': 0o440
+                    }]
+                }
+            }
+
+        if self.kube_config.git_ssh_known_hosts_configmap_name:
+            volumes[self.git_sync_ssh_known_hosts_volume_name] = {
+                'name': self.git_sync_ssh_known_hosts_volume_name,
+                'configMap': {
+                    'name': self.kube_config.git_ssh_known_hosts_configmap_name
+                },
+                'mode': 0o440
+            }
+
         # Mount the airflow.cfg file via a configmap the user has specified
         if self.kube_config.airflow_configmap:
             config_volume_name = 'airflow-config'
@@ -215,9 +284,8 @@ def generate_dag_volume_mount_path(self):
 
     def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_date,
                  try_number, airflow_command, kube_executor_config):
-        volumes_dict, volume_mounts_dict = self.init_volumes_and_mounts()
-        worker_init_container_spec = self._get_init_containers(
-            copy.deepcopy(volume_mounts_dict))
+        volumes_dict, volume_mounts_dict = self._get_volumes_and_mounts()
+        worker_init_container_spec = self._get_init_containers()
         resources = Resources(
             request_memory=kube_executor_config.request_memory,
             request_cpu=kube_executor_config.request_cpu,
@@ -261,5 +329,6 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             node_selectors=(kube_executor_config.node_selectors or
                             self.kube_config.kube_node_selectors),
             affinity=affinity,
-            tolerations=tolerations
+            tolerations=tolerations,
+            security_context=self._get_security_context(),
         )
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index d00b3f1debe1c..7fac05b8baed5 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -29,10 +29,14 @@
 
 try:
     from kubernetes.client.rest import ApiException
+    from airflow import configuration
+    from airflow.configuration import conf
     from airflow.contrib.executors.kubernetes_executor import AirflowKubernetesScheduler
     from airflow.contrib.executors.kubernetes_executor import KubernetesExecutor
+    from airflow.contrib.executors.kubernetes_executor import KubeConfig
     from airflow.contrib.executors.kubernetes_executor import KubernetesExecutorConfig
     from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
+    from airflow.exceptions import AirflowConfigException
 except ImportError:
     AirflowKubernetesScheduler = None
 
@@ -178,7 +182,7 @@ def setUp(self):
 
     def test_worker_configuration_no_subpaths(self):
         worker_config = WorkerConfiguration(self.kube_config)
-        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        volumes, volume_mounts = worker_config._get_volumes_and_mounts()
         volumes_list = [value for value in volumes.values()]
         volume_mounts_list = [value for value in volume_mounts.values()]
         for volume_or_mount in volumes_list + volume_mounts_list:
@@ -188,11 +192,46 @@ def test_worker_configuration_no_subpaths(self):
                     "subPath shouldn't be defined"
                 )
 
+    @mock.patch.object(conf, 'get')
+    @mock.patch.object(configuration, 'as_dict')
+    def test_worker_configuration_auth_both_ssh_and_user(self, mock_config_as_dict, mock_conf_get):
+        def get_conf(*args, **kwargs):
+            if(args[0] == 'core'):
+                return '1'
+            if(args[0] == 'kubernetes'):
+                if(args[1] == 'git_ssh_known_hosts_configmap_name'):
+                    return 'airflow-configmap'
+                if(args[1] == 'git_ssh_key_secret_name'):
+                    return 'airflow-secrets'
+                if(args[1] == 'git_user'):
+                    return 'some-user'
+                if(args[1] == 'git_password'):
+                    return 'some-password'
+                if(args[1] == 'git_repo'):
+                    return 'git@github.com:apache/airflow.git'
+                if(args[1] == 'git_branch'):
+                    return 'master'
+                if(args[1] == 'git_dags_folder_mount_point'):
+                    return '/usr/local/airflow/dags'
+                if(args[1] == 'delete_worker_pods'):
+                    return True
+                return '1'
+            return None
+
+        mock_conf_get.side_effect = get_conf
+        mock_config_as_dict.return_value = {'core': ''}
+
+        with self.assertRaisesRegexp(AirflowConfigException,
+                                     'either `git_user` and `git_password`.*'
+                                     'or `git_ssh_key_secret_name`.*'
+                                     'but not both$'):
+            KubeConfig()
+
     def test_worker_with_subpaths(self):
         self.kube_config.dags_volume_subpath = 'dags'
         self.kube_config.logs_volume_subpath = 'logs'
         worker_config = WorkerConfiguration(self.kube_config)
-        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        volumes, volume_mounts = worker_config._get_volumes_and_mounts()
 
         for volume in [value for value in volumes.values()]:
             self.assertNotIn(
@@ -263,6 +302,156 @@ def test_worker_environment_dags_folder_using_git_sync(self):
 
         self.assertEqual(dags_folder, env['AIRFLOW__CORE__DAGS_FOLDER'])
 
+    def test_init_environment_using_git_sync_ssh_without_known_hosts(self):
+        # Tests the init environment created with git-sync SSH authentication option is correct
+        # without known hosts file
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_ssh_secret_name = 'airflow-secrets'
+        self.kube_config.git_ssh_known_hosts_configmap_name = None
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        init_containers = worker_config._get_init_containers()
+
+        self.assertTrue(init_containers)  # check not empty
+        env = init_containers[0]['env']
+
+        self.assertTrue({'name': 'GIT_SSH_KEY_FILE', 'value': '/etc/git-secret/ssh'} in env)
+        self.assertTrue({'name': 'GIT_KNOWN_HOSTS', 'value': 'false'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_SSH', 'value': 'true'} in env)
+
+    def test_init_environment_using_git_sync_ssh_with_known_hosts(self):
+        # Tests the init environment created with git-sync SSH authentication option is correct
+        # with known hosts file
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_ssh_key_secret_name = 'airflow-secrets'
+        self.kube_config.git_ssh_known_hosts_configmap_name = 'airflow-configmap'
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        init_containers = worker_config._get_init_containers()
+
+        self.assertTrue(init_containers)  # check not empty
+        env = init_containers[0]['env']
+
+        self.assertTrue({'name': 'GIT_SSH_KEY_FILE', 'value': '/etc/git-secret/ssh'} in env)
+        self.assertTrue({'name': 'GIT_KNOWN_HOSTS', 'value': 'true'} in env)
+        self.assertTrue({'name': 'GIT_SSH_KNOWN_HOSTS_FILE',
+                        'value': '/etc/git-secret/known_hosts'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_SSH', 'value': 'true'} in env)
+
+    def test_init_environment_using_git_sync_user_without_known_hosts(self):
+        # Tests the init environment created with git-sync User authentication option is correct
+        # without known hosts file
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_user = 'git_user'
+        self.kube_config.git_password = 'git_password'
+        self.kube_config.git_ssh_known_hosts_configmap_name = None
+        self.kube_config.git_ssh_key_secret_name = None
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        init_containers = worker_config._get_init_containers()
+
+        self.assertTrue(init_containers)  # check not empty
+        env = init_containers[0]['env']
+
+        self.assertFalse({'name': 'GIT_SSH_KEY_FILE', 'value': '/etc/git-secret/ssh'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_USERNAME', 'value': 'git_user'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_PASSWORD', 'value': 'git_password'} in env)
+        self.assertTrue({'name': 'GIT_KNOWN_HOSTS', 'value': 'false'} in env)
+        self.assertFalse({'name': 'GIT_SSH_KNOWN_HOSTS_FILE',
+                          'value': '/etc/git-secret/known_hosts'} in env)
+        self.assertFalse({'name': 'GIT_SYNC_SSH', 'value': 'true'} in env)
+
+    def test_init_environment_using_git_sync_user_with_known_hosts(self):
+        # Tests the init environment created with git-sync User authentication option is correct
+        # with known hosts file
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_user = 'git_user'
+        self.kube_config.git_password = 'git_password'
+        self.kube_config.git_ssh_known_hosts_configmap_name = 'airflow-configmap'
+        self.kube_config.git_ssh_key_secret_name = None
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        init_containers = worker_config._get_init_containers()
+
+        self.assertTrue(init_containers)  # check not empty
+        env = init_containers[0]['env']
+
+        self.assertFalse({'name': 'GIT_SSH_KEY_FILE', 'value': '/etc/git-secret/ssh'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_USERNAME', 'value': 'git_user'} in env)
+        self.assertTrue({'name': 'GIT_SYNC_PASSWORD', 'value': 'git_password'} in env)
+        self.assertTrue({'name': 'GIT_KNOWN_HOSTS', 'value': 'true'} in env)
+        self.assertTrue({'name': 'GIT_SSH_KNOWN_HOSTS_FILE',
+                        'value': '/etc/git-secret/known_hosts'} in env)
+        self.assertFalse({'name': 'GIT_SYNC_SSH', 'value': 'true'} in env)
+
+    def test_make_pod_git_sync_ssh_without_known_hosts(self):
+        # Tests the pod created with git-sync SSH authentication option is correct without known hosts
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_ssh_key_secret_name = 'airflow-secrets'
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+        kube_executor_config = KubernetesExecutorConfig(annotations=[],
+                                                        volumes=[],
+                                                        volume_mounts=[])
+
+        pod = worker_config.make_pod("default", str(uuid.uuid4()), "test_pod_id", "test_dag_id",
+                                     "test_task_id", str(datetime.utcnow()), 1, "bash -c 'ls /'",
+                                     kube_executor_config)
+
+        init_containers = worker_config._get_init_containers()
+        git_ssh_key_file = next((x['value'] for x in init_containers[0]['env']
+                                if x['name'] == 'GIT_SSH_KEY_FILE'), None)
+        volume_mount_ssh_key = next((x['mountPath'] for x in init_containers[0]['volumeMounts']
+                                    if x['name'] == worker_config.git_sync_ssh_secret_volume_name),
+                                    None)
+        self.assertTrue(git_ssh_key_file)
+        self.assertTrue(volume_mount_ssh_key)
+        self.assertEqual({'fsGroup': 65533}, pod.security_context)
+        self.assertEqual(git_ssh_key_file,
+                         volume_mount_ssh_key,
+                         'The location where the git ssh secret is mounted'
+                         ' needs to be the same as the GIT_SSH_KEY_FILE path')
+
+    def test_make_pod_git_sync_ssh_with_known_hosts(self):
+        # Tests the pod created with git-sync SSH authentication option is correct with known hosts
+        self.kube_config.airflow_configmap = 'airflow-configmap'
+        self.kube_config.git_ssh_secret_name = 'airflow-secrets'
+        self.kube_config.dags_volume_claim = None
+        self.kube_config.dags_volume_host = None
+        self.kube_config.dags_in_image = None
+
+        worker_config = WorkerConfiguration(self.kube_config)
+
+        init_containers = worker_config._get_init_containers()
+        git_ssh_known_hosts_file = next((x['value'] for x in init_containers[0]['env']
+                                         if x['name'] == 'GIT_SSH_KNOWN_HOSTS_FILE'), None)
+
+        volume_mount_ssh_known_hosts_file = next(
+            (x['mountPath'] for x in init_containers[0]['volumeMounts']
+             if x['name'] == worker_config.git_sync_ssh_known_hosts_volume_name),
+            None)
+        self.assertTrue(git_ssh_known_hosts_file)
+        self.assertTrue(volume_mount_ssh_known_hosts_file)
+        self.assertEqual(git_ssh_known_hosts_file,
+                         volume_mount_ssh_known_hosts_file,
+                         'The location where the git known hosts file is mounted'
+                         ' needs to be the same as the GIT_SSH_KNOWN_HOSTS_FILE path')
+
     def test_make_pod_with_empty_executor_config(self):
         self.kube_config.kube_affinity = self.affinity_config
         self.kube_config.kube_tolerations = self.tolerations_config
@@ -317,9 +506,9 @@ def test_worker_pvc_dags(self):
         self.kube_config.dags_volume_claim = 'airflow-dags'
 
         worker_config = WorkerConfiguration(self.kube_config)
-        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        volumes, volume_mounts = worker_config._get_volumes_and_mounts()
 
-        init_containers = worker_config._get_init_containers(volume_mounts)
+        init_containers = worker_config._get_init_containers()
 
         dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
         dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
@@ -345,7 +534,7 @@ def test_worker_git_dags(self):
         self.kube_config.git_dags_folder_mount_point = '/usr/local/airflow/dags/repo/dags_folder'
 
         worker_config = WorkerConfiguration(self.kube_config)
-        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        volumes, volume_mounts = worker_config._get_volumes_and_mounts()
 
         dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
         dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
@@ -354,7 +543,7 @@ def test_worker_git_dags(self):
         self.assertEqual(self.kube_config.git_dags_folder_mount_point, dag_volume_mount[0]['mountPath'])
         self.assertTrue(dag_volume_mount[0]['readOnly'])
 
-        init_container = worker_config._get_init_containers(volume_mounts)[0]
+        init_container = worker_config._get_init_containers()[0]
         init_container_volume_mount = [mount for mount in init_container['volumeMounts']
                                        if mount['name'] == 'airflow-dags']
 
@@ -368,12 +557,12 @@ def test_worker_container_dags(self):
         self.kube_config.dags_in_image = True
 
         worker_config = WorkerConfiguration(self.kube_config)
-        volumes, volume_mounts = worker_config.init_volumes_and_mounts()
+        volumes, volume_mounts = worker_config._get_volumes_and_mounts()
 
         dag_volume = [volume for volume in volumes.values() if volume['name'] == 'airflow-dags']
         dag_volume_mount = [mount for mount in volume_mounts.values() if mount['name'] == 'airflow-dags']
 
-        init_containers = worker_config._get_init_containers(volume_mounts)
+        init_containers = worker_config._get_init_containers()
 
         self.assertEqual(0, len(dag_volume))
         self.assertEqual(0, len(dag_volume_mount))

From 1a74e003da3eb55f4a74268b1c8427b8a11dc1ab Mon Sep 17 00:00:00 2001
From: Thejas Babu <thejasb99@gmail.com>
Date: Mon, 10 Sep 2018 18:43:23 +0530
Subject: [PATCH 729/808] [AIRFLOW-XXX] Update kubernetes.rst docs (#3875)

Update kubernetes.rst with correct KubernetesPodOperator inputs
for the volumes.
---
 docs/kubernetes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 1d4906f6c4fb7..859e59f0b24da 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -126,7 +126,7 @@ Kubernetes Operator
                               arguments=["echo", "10"],
                               labels={"foo": "bar"},
                               secrets=[secret_file,secret_env]
-                              volume=[volume],
+                              volumes=[volume],
                               volume_mounts=[volume_mount]
                               name="test",
                               task_id="task",

From da224b901ecc8cf202e3e769d6d7c1c44ffde623 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Ga=C5=82uszka?= <galuszkak@gmail.com>
Date: Wed, 27 Mar 2019 11:08:22 +0100
Subject: [PATCH 730/808] [AIRFLOW-3937] KubernetesPodOperator support for
 envFrom configMapRef and secretRef (#4772)

---
 .../kubernetes_request_factory.py             | 39 ++++++++++++++--
 airflow/contrib/kubernetes/pod.py             |  5 +++
 airflow/contrib/kubernetes/secret.py          | 25 ++++++++---
 .../operators/kubernetes_pod_operator.py      |  6 +++
 docs/kubernetes.rst                           |  8 +++-
 .../minikube/test_kubernetes_pod_operator.py  | 45 +++++++++++++++++++
 6 files changed, 117 insertions(+), 11 deletions(-)

diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index 50959d276d6c5..ea46e1bcd385d 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -131,15 +131,21 @@ def extract_volume_secrets(pod, req):
 
     @staticmethod
     def extract_env_and_secrets(pod, req):
-        env_secrets = [s for s in pod.secrets if s.deploy_type == 'env']
-        if len(pod.envs) > 0 or len(env_secrets) > 0:
+        envs_from_key_secrets = [
+            env for env in pod.secrets if env.deploy_type == 'env' and hasattr(env, 'key')
+        ]
+
+        if len(pod.envs) > 0 or len(envs_from_key_secrets) > 0:
             env = []
             for k in pod.envs.keys():
                 env.append({'name': k, 'value': pod.envs[k]})
-            for secret in env_secrets:
+            for secret in envs_from_key_secrets:
                 KubernetesRequestFactory.add_secret_to_env(env, secret)
+
             req['spec']['containers'][0]['env'] = env
 
+        KubernetesRequestFactory._apply_env_from(pod, req)
+
     @staticmethod
     def extract_resources(pod, req):
         if not pod.resources or pod.resources.is_empty_resource_request():
@@ -196,3 +202,30 @@ def extract_tolerations(pod, req):
     def extract_security_context(pod, req):
         if pod.security_context:
             req['spec']['securityContext'] = pod.security_context
+
+    @staticmethod
+    def _apply_env_from(pod, req):
+        envs_from_secrets = [
+            env for env in pod.secrets if env.deploy_type == 'env' and not hasattr(env, 'key')
+        ]
+
+        if pod.configmaps or envs_from_secrets:
+            req['spec']['containers'][0]['envFrom'] = []
+
+        for secret in envs_from_secrets:
+            req['spec']['containers'][0]['envFrom'].append(
+                {
+                    'secretRef': {
+                        'name': secret.secret
+                    }
+                }
+            )
+
+        for configmap in pod.configmaps:
+            req['spec']['containers'][0]['envFrom'].append(
+                {
+                    'configMapRef': {
+                        'name': configmap
+                    }
+                }
+            )
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 889d3cd5972d5..3d7c138b7e179 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -66,6 +66,9 @@ class Pod:
     :type tolerations: list
     :param security_context: A dict containing the security context for the pod
     :type security_context: dict
+    :param configmaps: A list containing names of configmaps object
+        mounting env variables to the pod
+    :type configmaps: list[str]
     """
     def __init__(
             self,
@@ -91,6 +94,7 @@ def __init__(
             hostnetwork=False,
             tolerations=None,
             security_context=None,
+            configmaps=None
     ):
         self.image = image
         self.envs = envs or {}
@@ -114,3 +118,4 @@ def __init__(
         self.hostnetwork = hostnetwork or False
         self.tolerations = tolerations or []
         self.security_context = security_context
+        self.configmaps = configmaps or []
diff --git a/airflow/contrib/kubernetes/secret.py b/airflow/contrib/kubernetes/secret.py
index bf1526b1a393b..d69f507717682 100644
--- a/airflow/contrib/kubernetes/secret.py
+++ b/airflow/contrib/kubernetes/secret.py
@@ -14,28 +14,41 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
+from airflow.exceptions import AirflowConfigException
 
 
 class Secret:
     """Defines Kubernetes Secret Volume"""
 
-    def __init__(self, deploy_type, deploy_target, secret, key):
+    def __init__(self, deploy_type, deploy_target, secret, key=None):
         """Initialize a Kubernetes Secret Object. Used to track requested secrets from
         the user.
         :param deploy_type: The type of secret deploy in Kubernetes, either `env` or
             `volume`
         :type deploy_type: str
         :param deploy_target: The environment variable when `deploy_type` `env` or
-            file path when `deploy_type` `volume` where expose secret
+            file path when `deploy_type` `volume` where expose secret.
+            If `key` is not provided deploy target should be None.
         :type deploy_target: str
         :param secret: Name of the secrets object in Kubernetes
         :type secret: str
-        :param key: Key of the secret within the Kubernetes Secret
-        :type key: str
+        :param key: (Optional) Key of the secret within the Kubernetes Secret
+            if not provided in `deploy_type` `env` it will mount all secrets in object
+        :type key: str or None
         """
         self.deploy_type = deploy_type
-        self.deploy_target = deploy_target.upper()
+
+        if deploy_target:
+            self.deploy_target = deploy_target.upper()
+
         if deploy_type == 'volume':
             self.deploy_target = deploy_target
+
+        if not deploy_type == 'env' and key is None:
+            raise AirflowConfigException(
+                'In deploy_type different than `env` parameter `key` is mandatory'
+            )
+
         self.secret = secret
-        self.key = key
+        if key:
+            self.key = key
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 25b734da9b20a..73edf1b297c5b 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -88,6 +88,9 @@ class KubernetesPodOperator(BaseOperator):
     :type hostnetwork: bool
     :param tolerations: A list of kubernetes tolerations
     :type tolerations: list tolerations
+    :param configmaps: A list of configmap names objects that we
+        want mount as env variables
+    :type configmaps: list[str]
     """
     template_fields = ('cmds', 'arguments', 'env_vars', 'config_file')
 
@@ -123,6 +126,7 @@ def execute(self, context):
             pod.node_selectors = self.node_selectors
             pod.hostnetwork = self.hostnetwork
             pod.tolerations = self.tolerations
+            pod.configmaps = self.configmaps
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
@@ -172,6 +176,7 @@ def __init__(self,
                  is_delete_operator_pod=False,
                  hostnetwork=False,
                  tolerations=None,
+                 configmaps=None,
                  *args,
                  **kwargs):
         super(KubernetesPodOperator, self).__init__(*args, **kwargs)
@@ -201,3 +206,4 @@ def __init__(self,
         self.is_delete_operator_pod = is_delete_operator_pod
         self.hostnetwork = hostnetwork
         self.tolerations = tolerations or []
+        self.configmaps = configmaps or []
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 859e59f0b24da..96890c738f46d 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -50,11 +50,14 @@ Kubernetes Operator
 
     secret_file = Secret('volume', '/etc/sql_conn', 'airflow-secrets', 'sql_alchemy_conn')
     secret_env  = Secret('env', 'SQL_CONN', 'airflow-secrets', 'sql_alchemy_conn')
+    secret_all_keys  = Secret('env', None, 'airflow-secrets-2')
     volume_mount = VolumeMount('test-volume',
                                 mount_path='/root/mount_file',
                                 sub_path=None,
                                 read_only=True)
 
+    configmaps = ['test-configmap-1', 'test-configmap-2']
+
     volume_config= {
         'persistentVolumeClaim':
           {
@@ -125,7 +128,7 @@ Kubernetes Operator
                               cmds=["bash", "-cx"],
                               arguments=["echo", "10"],
                               labels={"foo": "bar"},
-                              secrets=[secret_file,secret_env]
+                              secrets=[secret_file, secret_env, secret_all_keys],
                               volumes=[volume],
                               volume_mounts=[volume_mount]
                               name="test",
@@ -133,7 +136,8 @@ Kubernetes Operator
                               affinity=affinity,
                               is_delete_operator_pod=True,
                               hostnetwork=False,
-                              tolerations=tolerations
+                              tolerations=tolerations,
+                              configmaps=configmaps
                               )
 
 
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index e1dfce28c44a6..eeb8328ee18f6 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -19,6 +19,7 @@
 import os
 import shutil
 from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
+from airflow.contrib.kubernetes.secret import Secret
 from airflow import AirflowException
 from kubernetes.client.rest import ApiException
 from subprocess import check_call
@@ -326,6 +327,50 @@ def test_xcom_push(self):
         )
         self.assertEqual(k.execute(None), json.loads(return_value))
 
+    @mock.patch("airflow.contrib.kubernetes.pod_launcher.PodLauncher.run_pod")
+    @mock.patch("airflow.contrib.kubernetes.kube_client.get_kube_client")
+    def test_envs_from_configmaps(self, client_mock, launcher_mock):
+        # GIVEN
+        from airflow.utils.state import State
+        configmaps = ['test-configmap']
+        # WHEN
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            configmaps=configmaps
+        )
+        # THEN
+        launcher_mock.return_value = (State.SUCCESS, None)
+        k.execute(None)
+        self.assertEqual(launcher_mock.call_args[0][0].configmaps, configmaps)
+
+    @mock.patch("airflow.contrib.kubernetes.pod_launcher.PodLauncher.run_pod")
+    @mock.patch("airflow.contrib.kubernetes.kube_client.get_kube_client")
+    def test_envs_from_secrets(self, client_mock, launcher_mock):
+        # GIVEN
+        from airflow.utils.state import State
+        secrets = [Secret('env', None, "secret_name")]
+        # WHEN
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo 10"],
+            secrets=secrets,
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+        )
+        # THEN
+        launcher_mock.return_value = (State.SUCCESS, None)
+        k.execute(None)
+        self.assertEqual(launcher_mock.call_args[0][0].secrets, secrets)
+
 
 if __name__ == '__main__':
     unittest.main()

From 389864ac44a872dabfcc02de19e19d07cbddb15a Mon Sep 17 00:00:00 2001
From: "Drew J. Sonne" <drew.sonne@gmail.com>
Date: Fri, 11 Jan 2019 06:36:00 +0000
Subject: [PATCH 731/808] [AIRFLOW-3670] Add stages to Travis build (#4477)

Allow travis to fail the entire build quickly, if the flake8 build fails
---
 .travis.yml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index dc0c462563909..f1cab74c8fdfb 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -24,7 +24,6 @@ env:
     - DOCKER_COMPOSE_VERSION=1.20.0
     - TRAVIS_CACHE=$HOME/.travis_cache/
   matrix:
-    - TOX_ENV=flake8
     - TOX_ENV=py27-backend_mysql-env_docker
     - TOX_ENV=py27-backend_sqlite-env_docker
     - TOX_ENV=py27-backend_postgres-env_docker
@@ -34,6 +33,16 @@ env:
     - TOX_ENV=py27-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.9.0
     - TOX_ENV=py35-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.13.0 PYTHON_VERSION=3
 
+stages:
+  - flake8
+  - test
+
+jobs:
+  include:
+    - stage: flake8
+      name: Flake8
+      script: docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
+      env: TOX_ENV=flake8
 cache:
   directories:
     - $HOME/.wheelhouse/

From 517ba5fcc7d2020cdbf3c4b90f5ab29cb1360024 Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Sun, 13 Jan 2019 03:24:50 +0100
Subject: [PATCH 732/808] [AIRFLOW-3685] Move licence header check (#4497)

---
 .travis.yml | 10 +++++++---
 tox.ini     |  1 -
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index f1cab74c8fdfb..d78839d3ea8dc 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -34,15 +34,19 @@ env:
     - TOX_ENV=py35-backend_postgres-env_kubernetes KUBERNETES_VERSION=v1.13.0 PYTHON_VERSION=3
 
 stages:
-  - flake8
+  - pre-test
   - test
 
 jobs:
   include:
-    - stage: flake8
-      name: Flake8
+    - name: Flake8
+      stage: pre-test
       script: docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
       env: TOX_ENV=flake8
+    - name: Check license header
+      stage: pre-test
+      script: scripts/ci/6-check-license.sh
+
 cache:
   directories:
     - $HOME/.wheelhouse/
diff --git a/tox.ini b/tox.ini
index ecedcf02d4a9e..0480c233dae25 100644
--- a/tox.ini
+++ b/tox.ini
@@ -59,7 +59,6 @@ commands =
   env_docker: {toxinidir}/scripts/ci/2-setup-kdc.sh
   backend_mysql: {toxinidir}/scripts/ci/3-setup-mysql.sh
   {toxinidir}/scripts/ci/5-run-tests.sh []
-  {toxinidir}/scripts/ci/6-check-license.sh
   codecov -e TOXENV
 
 [testenv:flake8]

From 9996e150262509811fd6a0183db4365a45d1e166 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Mon, 14 Jan 2019 13:59:00 +0100
Subject: [PATCH 733/808] [AIRFLOW-3699] Speed up Flake8 (#4515)

Flake8 runs within the Docker container, which is not needed.
Running this outside Docker will dramatically speed up the
CI process.
---
 .travis.yml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index d78839d3ea8dc..76cc46a3923bd 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -19,6 +19,8 @@
 sudo: true
 dist: xenial
 language: python
+python:
+  - "3.6"
 env:
   global:
     - DOCKER_COMPOSE_VERSION=1.20.0
@@ -41,8 +43,7 @@ jobs:
   include:
     - name: Flake8
       stage: pre-test
-      script: docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh
-      env: TOX_ENV=flake8
+      script: pip install flake8 && flake8
     - name: Check license header
       stage: pre-test
       script: scripts/ci/6-check-license.sh

From 7f02d6cff38ac3acda62442a68d2cff373d9352b Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Mon, 11 Feb 2019 11:15:54 +0100
Subject: [PATCH 734/808] [AIRFLOW-3866] Run docker-compose pull silently in CI
 (#4688)

To reduce the output in Travis
---
 .travis.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 76cc46a3923bd..96184bb6c9cd8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -64,8 +64,11 @@ install:
   - chmod +x docker-compose
   - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
+  - docker-compose -f scripts/ci/docker-compose.yml pull --quiet --parallel
 script:
-  - if [ -z "$KUBERNETES_VERSION" ]; then docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh; fi
+  - if [ -z "$KUBERNETES_VERSION" ]; then
+      docker-compose --log-level ERROR -f scripts/ci/docker-compose.yml run airflow-testing /app/scripts/ci/run-ci.sh;
+    fi
   - if [ ! -z "$KUBERNETES_VERSION" ]; then
       ./scripts/ci/kubernetes/minikube/stop_minikube.sh &&
       ./scripts/ci/kubernetes/setup_kubernetes.sh &&

From f27e57d73cd89bb632b08343df35cdb26e42c940 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 13 Feb 2019 00:50:23 +0100
Subject: [PATCH 735/808] [AIRFLOW-3770] Validation of documentation on CI]
 (#4593)

---
 .travis.yml   |  3 +++
 docs/build.sh | 23 +++++++++++++++++++++--
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 96184bb6c9cd8..e5ff090603e60 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -47,6 +47,9 @@ jobs:
     - name: Check license header
       stage: pre-test
       script: scripts/ci/6-check-license.sh
+    - name: Check docs
+      stage: pre-test
+      script: pip install -e .[doc] && docs/build.sh
 
 cache:
   directories:
diff --git a/docs/build.sh b/docs/build.sh
index b3a9cbef99c7f..24241c4d8cdd1 100755
--- a/docs/build.sh
+++ b/docs/build.sh
@@ -18,5 +18,24 @@
 # specific language governing permissions and limitations
 # under the License.
 
-rm -r _build
-make html
+set -e
+
+FWDIR="$(cd "`dirname "$0"`"; pwd)"
+cd "$FWDIR"
+
+[ -d _build ] && rm -r _build
+
+NUM_IGNORED_WARNINGS=4
+NUM_CURRENT_WARNINGS=$(make html |\
+    tee /dev/tty |\
+    grep 'build succeeded' |\
+    head -1 |\
+    sed -E 's/build succeeded, ([0-9]+) warnings\./\1/g')
+
+if [ "${NUM_CURRENT_WARNINGS}" != "${NUM_IGNORED_WARNINGS}" ]; then
+    echo
+    echo "Unexpected problems found in the documentation. "
+    echo "Currently, ${NUM_IGNORED_WARNINGS} warnings are ignored."
+    echo
+    exit 1
+fi

From d0f599ace26ddf4e64797dc0d8812125283dc06d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 22 Feb 2019 12:25:13 +0100
Subject: [PATCH 736/808] [AIRFLOW-3925] Don't pull docker-images on pretest
 (#4740)

Co-authored-by: Joshua Carp <jm.carp@gmail.com>
---
 .travis.yml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index e5ff090603e60..fed12b95268bf 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -43,13 +43,16 @@ jobs:
   include:
     - name: Flake8
       stage: pre-test
-      script: pip install flake8 && flake8
+      install: pip install flake8
+      script: flake8
     - name: Check license header
       stage: pre-test
+      install: skip
       script: scripts/ci/6-check-license.sh
     - name: Check docs
       stage: pre-test
-      script: pip install -e .[doc] && docs/build.sh
+      install: pip install -e .[doc]
+      script: docs/build.sh
 
 cache:
   directories:

From 59b67b10f510d006575c41e961b97db8c33e58db Mon Sep 17 00:00:00 2001
From: Chao-Han Tsai <milton0825@gmail.com>
Date: Sun, 3 Mar 2019 21:24:11 -0800
Subject: [PATCH 737/808] [AIRFLOW-4001] Update docs about how to run tests
 (#4826)

fix docs
---
 CONTRIBUTING.md      | 14 +++++++++++---
 scripts/ci/run-ci.sh |  3 ++-
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 903f453d9faa2..56258d5d75142 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -159,11 +159,19 @@ There are three ways to setup an Apache Airflow development environment.
   ```bash
   docker-compose -f scripts/ci/docker-compose.yml run airflow-testing bash
   # From the container
-  pip install -e .[devel]
-  # Run all the tests with python and mysql through tox
-  tox -e py35-backend_mysql
+  export TOX_ENV=py27-backend_mysql-env_docker
+  /app/scripts/ci/run-ci.sh
   ```
 
+  If you wish to run individual tests inside of Docker environment you can do as follows:
+
+  ```bash
+  # From the container (with your desired environment) with druid hook
+  export TOX_ENV=py27-backend_mysql-env_docker
+  /app/scripts/ci/run-ci.sh -- tests/hooks/test_druid_hook.py
+  ```
+
+
 ### Running unit tests
 
 To run tests locally, once your unit test environment is setup (directly on your
diff --git a/scripts/ci/run-ci.sh b/scripts/ci/run-ci.sh
index 4be51167bb0b0..7b0363b81d1ef 100755
--- a/scripts/ci/run-ci.sh
+++ b/scripts/ci/run-ci.sh
@@ -23,6 +23,7 @@ set -x
 DIRNAME=$(cd "$(dirname "$0")"; pwd)
 AIRFLOW_ROOT="$DIRNAME/../.."
 
+nose_args=$@
 # Fix file permissions
 sudo chown -R airflow.airflow . $HOME/.cache $HOME/.wheelhouse/ $HOME/.cache/pip
 if [ -d $HOME/.minikube ]; then
@@ -42,7 +43,7 @@ cd $AIRFLOW_ROOT && $PIP --version && tox --version
 
 if [ -z "$KUBERNETES_VERSION" ];
 then
-  tox -e $TOX_ENV
+  tox -e $TOX_ENV $nose_args
 else
   # This script runs inside a container, the path of the kubernetes certificate
   # is /home/travis/.minikube/client.crt but the user in the container is `airflow`

From 6c6e35a01bddb21c494fbcd312a51ef42e0ab03d Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Wed, 13 Mar 2019 06:26:12 -0400
Subject: [PATCH 738/808] [AIRFLOW-XXX] Drop deprecated sudo option; use
 default docker compose on Travis. (#4732)

---
 .travis.yml | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index fed12b95268bf..29aeb6ebb7b7c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -16,14 +16,12 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-sudo: true
 dist: xenial
 language: python
 python:
   - "3.6"
 env:
   global:
-    - DOCKER_COMPOSE_VERSION=1.20.0
     - TRAVIS_CACHE=$HOME/.travis_cache/
   matrix:
     - TOX_ENV=py27-backend_mysql-env_docker
@@ -64,11 +62,6 @@ before_install:
   # https://github.com/kubernetes/kubernetes/issues/61058#issuecomment-372764783
   - if [ ! -z "$KUBERNETES_VERSION" ]; then sudo mount --make-shared / && sudo service docker restart; fi
 install:
-  # Use recent docker-compose version
-  - sudo rm /usr/local/bin/docker-compose
-  - curl -L https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-`uname -s`-`uname -m` > docker-compose
-  - chmod +x docker-compose
-  - sudo mv docker-compose /usr/local/bin
   - pip install --upgrade pip
   - docker-compose -f scripts/ci/docker-compose.yml pull --quiet --parallel
 script:

From bdbf54fcdfff6ca908853647ca1da00e1abc56e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Thu, 31 Jan 2019 12:32:23 +0100
Subject: [PATCH 739/808] [AIRFLOW-3730] Standarization use of logs mechanisms
 (#4556)

---
 airflow/contrib/hooks/bigquery_hook.py        |  2 +-
 airflow/contrib/hooks/databricks_hook.py      |  4 +--
 airflow/contrib/hooks/ftp_hook.py             |  4 +--
 airflow/contrib/hooks/gcp_api_base_hook.py    |  3 +-
 airflow/contrib/hooks/jira_hook.py            |  3 +-
 airflow/contrib/hooks/redis_hook.py           |  3 +-
 airflow/contrib/hooks/salesforce_hook.py      |  2 +-
 airflow/contrib/hooks/segment_hook.py         |  4 +--
 airflow/contrib/hooks/sftp_hook.py            |  6 ++--
 airflow/contrib/hooks/sqoop_hook.py           |  3 +-
 airflow/contrib/hooks/ssh_hook.py             |  3 +-
 airflow/contrib/hooks/winrm_hook.py           |  3 +-
 airflow/contrib/operators/vertica_to_mysql.py | 29 +++++++++----------
 airflow/contrib/sensors/sftp_sensor.py        |  3 +-
 14 files changed, 28 insertions(+), 44 deletions(-)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 457397d661a7c..081feae0be9bf 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -44,7 +44,7 @@
 from pandas_gbq.gbq import GbqConnector
 
 
-class BigQueryHook(GoogleCloudBaseHook, DbApiHook, LoggingMixin):
+class BigQueryHook(GoogleCloudBaseHook, DbApiHook):
     """
     Interact with BigQuery. This hook uses the Google Cloud Platform
     connection.
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index f4a890ac7ba4a..a83e577e6aa3a 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -26,8 +26,6 @@
 from requests.auth import AuthBase
 from time import sleep
 
-from airflow.utils.log.logging_mixin import LoggingMixin
-
 try:
     from urllib import parse as urlparse
 except ImportError:
@@ -44,7 +42,7 @@
 USER_AGENT_HEADER = {'user-agent': 'airflow-{v}'.format(v=__version__)}
 
 
-class DatabricksHook(BaseHook, LoggingMixin):
+class DatabricksHook(BaseHook):
     """
     Interact with Databricks.
     """
diff --git a/airflow/contrib/hooks/ftp_hook.py b/airflow/contrib/hooks/ftp_hook.py
index d67ebf82bc4c6..a12ece9bc9420 100644
--- a/airflow/contrib/hooks/ftp_hook.py
+++ b/airflow/contrib/hooks/ftp_hook.py
@@ -24,8 +24,6 @@
 from airflow.hooks.base_hook import BaseHook
 from past.builtins import basestring
 
-from airflow.utils.log.logging_mixin import LoggingMixin
-
 
 def mlsd(conn, path="", facts=None):
     """
@@ -60,7 +58,7 @@ def mlsd(conn, path="", facts=None):
         yield (name, entry)
 
 
-class FTPHook(BaseHook, LoggingMixin):
+class FTPHook(BaseHook):
     """
     Interact with FTP.
 
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index ad46b59da3458..53b31cff56c35 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -32,7 +32,6 @@
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 
 
 _DEFAULT_SCOPES = ('https://www.googleapis.com/auth/cloud-platform',)
@@ -42,7 +41,7 @@
 _G_APP_CRED_ENV_VAR = "GOOGLE_APPLICATION_CREDENTIALS"
 
 
-class GoogleCloudBaseHook(BaseHook, LoggingMixin):
+class GoogleCloudBaseHook(BaseHook):
     """
     A base hook for Google cloud-related hooks. Google cloud has a shared REST
     API client that is built in the same way no matter which service you use.
diff --git a/airflow/contrib/hooks/jira_hook.py b/airflow/contrib/hooks/jira_hook.py
index a56c414dceb54..e3c4a12ffe69b 100644
--- a/airflow/contrib/hooks/jira_hook.py
+++ b/airflow/contrib/hooks/jira_hook.py
@@ -21,10 +21,9 @@
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 
 
-class JiraHook(BaseHook, LoggingMixin):
+class JiraHook(BaseHook):
     """
     Jira interaction hook, a Wrapper around JIRA Python SDK.
 
diff --git a/airflow/contrib/hooks/redis_hook.py b/airflow/contrib/hooks/redis_hook.py
index 8108c63687b80..a63c839e34c85 100644
--- a/airflow/contrib/hooks/redis_hook.py
+++ b/airflow/contrib/hooks/redis_hook.py
@@ -22,10 +22,9 @@
 """
 from redis import Redis
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 
 
-class RedisHook(BaseHook, LoggingMixin):
+class RedisHook(BaseHook):
     """
     Wrapper for connection to interact with Redis in-memory data structure store
     """
diff --git a/airflow/contrib/hooks/salesforce_hook.py b/airflow/contrib/hooks/salesforce_hook.py
index a3301ad6f5ccc..a1756b6530b6a 100644
--- a/airflow/contrib/hooks/salesforce_hook.py
+++ b/airflow/contrib/hooks/salesforce_hook.py
@@ -37,7 +37,7 @@
 from airflow.utils.log.logging_mixin import LoggingMixin
 
 
-class SalesforceHook(BaseHook, LoggingMixin):
+class SalesforceHook(BaseHook):
     def __init__(
             self,
             conn_id,
diff --git a/airflow/contrib/hooks/segment_hook.py b/airflow/contrib/hooks/segment_hook.py
index 01613f2adee8e..a072a9f1eaf99 100644
--- a/airflow/contrib/hooks/segment_hook.py
+++ b/airflow/contrib/hooks/segment_hook.py
@@ -29,10 +29,8 @@
 from airflow.hooks.base_hook import BaseHook
 from airflow.exceptions import AirflowException
 
-from airflow.utils.log.logging_mixin import LoggingMixin
 
-
-class SegmentHook(BaseHook, LoggingMixin):
+class SegmentHook(BaseHook):
     def __init__(
             self,
             segment_conn_id='segment_default',
diff --git a/airflow/contrib/hooks/sftp_hook.py b/airflow/contrib/hooks/sftp_hook.py
index a6a59920f2b0b..6fc01babe5ab2 100644
--- a/airflow/contrib/hooks/sftp_hook.py
+++ b/airflow/contrib/hooks/sftp_hook.py
@@ -19,7 +19,6 @@
 
 import stat
 import pysftp
-import logging
 import datetime
 from airflow.contrib.hooks.ssh_hook import SSHHook
 
@@ -183,10 +182,9 @@ def retrieve_file(self, remote_full_path, local_full_path):
         :type local_full_path: str
         """
         conn = self.get_conn()
-        logging.info('Retrieving file from FTP: {}'.format(remote_full_path))
+        self.log.info('Retrieving file from FTP: %s', remote_full_path)
         conn.get(remote_full_path, local_full_path)
-        logging.info('Finished retrieving file from FTP: {}'.format(
-            remote_full_path))
+        self.log.info('Finished retrieving file from FTP: %s', remote_full_path)
 
     def store_file(self, remote_full_path, local_full_path):
         """
diff --git a/airflow/contrib/hooks/sqoop_hook.py b/airflow/contrib/hooks/sqoop_hook.py
index 13a6cccca869e..aa5ec5222afd0 100644
--- a/airflow/contrib/hooks/sqoop_hook.py
+++ b/airflow/contrib/hooks/sqoop_hook.py
@@ -25,11 +25,10 @@
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 from copy import deepcopy
 
 
-class SqoopHook(BaseHook, LoggingMixin):
+class SqoopHook(BaseHook):
     """
     This hook is a wrapper around the sqoop 1 binary. To be able to use the hook
     it is required that "sqoop" is in the PATH.
diff --git a/airflow/contrib/hooks/ssh_hook.py b/airflow/contrib/hooks/ssh_hook.py
index d81cfd3cd4d7b..956a7fd4419d5 100755
--- a/airflow/contrib/hooks/ssh_hook.py
+++ b/airflow/contrib/hooks/ssh_hook.py
@@ -27,10 +27,9 @@
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 
 
-class SSHHook(BaseHook, LoggingMixin):
+class SSHHook(BaseHook):
     """
     Hook for ssh remote execution using Paramiko.
     ref: https://github.com/paramiko/paramiko
diff --git a/airflow/contrib/hooks/winrm_hook.py b/airflow/contrib/hooks/winrm_hook.py
index 5cc24cb7ad75f..336dc2d818c62 100644
--- a/airflow/contrib/hooks/winrm_hook.py
+++ b/airflow/contrib/hooks/winrm_hook.py
@@ -24,10 +24,9 @@
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
-from airflow.utils.log.logging_mixin import LoggingMixin
 
 
-class WinRMHook(BaseHook, LoggingMixin):
+class WinRMHook(BaseHook):
     """
     Hook for winrm remote execution using pywinrm.
 
diff --git a/airflow/contrib/operators/vertica_to_mysql.py b/airflow/contrib/operators/vertica_to_mysql.py
index 9d3fe721e4cbb..99b55e61bc6e0 100644
--- a/airflow/contrib/operators/vertica_to_mysql.py
+++ b/airflow/contrib/operators/vertica_to_mysql.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import logging
 import MySQLdb
 
 from airflow.contrib.hooks.vertica_hook import VerticaHook
@@ -103,10 +102,10 @@ def execute(self, context):
                 if self.bulk_load:
                     tmpfile = NamedTemporaryFile("w")
 
-                    logging.info(
-                        "Selecting rows from Vertica to local file " + str(
-                            tmpfile.name) + "...")
-                    logging.info(self.sql)
+                    self.log.info(
+                        "Selecting rows from Vertica to local file %s...",
+                        tmpfile.name)
+                    self.log.info(self.sql)
 
                     csv_writer = csv.writer(tmpfile, delimiter='\t', encoding='utf-8')
                     for row in cursor.iterate():
@@ -115,21 +114,21 @@ def execute(self, context):
 
                     tmpfile.flush()
                 else:
-                    logging.info("Selecting rows from Vertica...")
-                    logging.info(self.sql)
+                    self.log.info("Selecting rows from Vertica...")
+                    self.log.info(self.sql)
 
                     result = cursor.fetchall()
                     count = len(result)
 
-                logging.info("Selected rows from Vertica " + str(count))
+                self.log.info("Selected rows from Vertica %s", count)
 
         if self.mysql_preoperator:
-            logging.info("Running MySQL preoperator...")
+            self.log.info("Running MySQL preoperator...")
             mysql.run(self.mysql_preoperator)
 
         try:
             if self.bulk_load:
-                logging.info("Bulk inserting rows into MySQL...")
+                self.log.info("Bulk inserting rows into MySQL...")
                 with closing(mysql.get_conn()) as conn:
                     with closing(conn.cursor()) as cursor:
                         cursor.execute("LOAD DATA LOCAL INFILE '%s' INTO "
@@ -140,17 +139,17 @@ def execute(self, context):
                         conn.commit()
                 tmpfile.close()
             else:
-                logging.info("Inserting rows into MySQL...")
+                self.log.info("Inserting rows into MySQL...")
                 mysql.insert_rows(table=self.mysql_table,
                                   rows=result,
                                   target_fields=selected_columns)
-            logging.info("Inserted rows into MySQL " + str(count))
+            self.log.info("Inserted rows into MySQL %s", count)
         except (MySQLdb.Error, MySQLdb.Warning):
-            logging.error("Inserted rows into MySQL 0")
+            self.log.info("Inserted rows into MySQL 0")
             raise
 
         if self.mysql_postoperator:
-            logging.info("Running MySQL postoperator...")
+            self.log.info("Running MySQL postoperator...")
             mysql.run(self.mysql_postoperator)
 
-        logging.info("Done")
+        self.log.info("Done")
diff --git a/airflow/contrib/sensors/sftp_sensor.py b/airflow/contrib/sensors/sftp_sensor.py
index 3b06814cbcaa4..0b61c801514cc 100644
--- a/airflow/contrib/sensors/sftp_sensor.py
+++ b/airflow/contrib/sensors/sftp_sensor.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import logging
 from paramiko import SFTP_NO_SUCH_FILE
 from airflow.contrib.hooks.sftp_hook import SFTPHook
 from airflow.operators.sensors import BaseSensorOperator
@@ -42,7 +41,7 @@ def __init__(self, path, sftp_conn_id='sftp_default', *args, **kwargs):
         self.hook = SFTPHook(sftp_conn_id)
 
     def poke(self, context):
-        logging.info('Poking for %s', self.path)
+        self.log.info('Poking for %s', self.path)
         try:
             self.hook.get_mod_time(self.path)
         except IOError as e:

From 83088b45f41b601a6e1ec3f5f046898a83472470 Mon Sep 17 00:00:00 2001
From: Tao feng <tfeng@lyft.com>
Date: Thu, 21 Jun 2018 16:28:30 -0700
Subject: [PATCH 740/808] [AIRFLOW-2652] implement / enhance baseOperator
 deepcopy

Make sure you have checked _all_ steps below.

- [x] My PR addresses the following [Airflow JIRA]
(https://issues.apache.org/jira/browse/AIRFLOW/)
issues and references them in the PR title. For
example, "\[AIRFLOW-XXX\] My Airflow PR"
    -
https://issues.apache.org/jira/browse/AIRFLOW-2652
    - In case you are fixing a typo in the
documentation you can prepend your commit with
\[AIRFLOW-XXX\], code changes always need a JIRA
issue.

- [x] Here are some details about my PR, including
screenshots of any UI changes:
When running ``airflow backfill`` on
pythonOperator, it will do / trigger a deepcopy of
the task_instance. If some objects can't be
deepcopy in certain python version(e.g Protobuf in
python 2.7) , an exception will be thrown. We
should just do a shallow copy instead of deep copy
for the object.

The pr here is to copy the ``_deepcopy__`` method
in BaseOperator, but skip doing deepcopy for
`op_kwargs` and `python_callable`.

- [x] My PR adds the following unit tests __OR__
does not need testing for this extremely good
reason:
I can't think of a good way to test. We encounter
this in our production.

- [x] My commits all reference JIRA issues in
their subject lines, and I have squashed multiple
commits if they address the same issue. In
addition, my commits follow the guidelines from
"[How to write a good git commit
message](http://chris.beams.io/posts/git-
commit/)":
    1. Subject is separated from body by a blank line
    2. Subject is limited to 50 characters
    3. Subject does not end with a period
    4. Subject uses the imperative mood ("add", not
"adding")
    5. Body wraps at 72 characters
    6. Body explains "what" and "why", not "how"

- [x] In case of new functionality, my PR adds
documentation that describes how to use it.
    - When adding new operators/hooks/sensors, the
autoclass documentation generation needs to be
added.

- [x] Passes `git diff upstream/master -u --
"*.py" | flake8 --diff`

Closes #3528 from feng-tao/airflow-2652
---
 airflow/models/__init__.py           | 23 ++++++++++++++---------
 airflow/operators/python_operator.py |  4 ++++
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 6199d4b3d15a8..1626586b6bcc0 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -2294,6 +2294,15 @@ class derived from this one results in the creation of a task object,
     ui_color = '#fff'
     ui_fgcolor = '#000'
 
+    # base list which includes all the attrs that don't need deep copy.
+    _base_operator_shallow_copy_attrs = ('user_defined_macros',
+                                         'user_defined_filters',
+                                         'params',
+                                         '_log',)
+
+    # each operator should override this class attr for shallow copy attrs.
+    shallow_copy_attrs = ()
+
     @apply_defaults
     def __init__(
             self,
@@ -2664,17 +2673,13 @@ def __deepcopy__(self, memo):
         result = cls.__new__(cls)
         memo[id(self)] = result
 
+        shallow_copy = cls.shallow_copy_attrs + cls._base_operator_shallow_copy_attrs
+
         for k, v in list(self.__dict__.items()):
-            if k not in ('user_defined_macros', 'user_defined_filters',
-                         'params', '_log'):
+            if k not in shallow_copy:
                 setattr(result, k, copy.deepcopy(v, memo))
-        result.params = self.params
-        if hasattr(self, 'user_defined_macros'):
-            result.user_defined_macros = self.user_defined_macros
-        if hasattr(self, 'user_defined_filters'):
-            result.user_defined_filters = self.user_defined_filters
-        if hasattr(self, '_log'):
-            result._log = self._log
+            else:
+                setattr(result, k, copy.copy(v))
         return result
 
     def __getstate__(self):
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 6d2dbf9b326bb..c70cbeadf5a5e 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -70,6 +70,10 @@ class PythonOperator(BaseOperator):
     template_ext = tuple()
     ui_color = '#ffefeb'
 
+    # since we won't mutate the arguments, we should just do the shallow copy
+    # there are some cases we can't deepcopy the objects(e.g protobuf).
+    shallow_copy_attrs = ('python_callable', 'op_kwargs',)
+
     @apply_defaults
     def __init__(
             self,

From c74f6c337b25c53a4a4da7951ee2b3a0b3eeb96a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A9raud?= <galak75@users.noreply.github.com>
Date: Wed, 27 Feb 2019 08:26:36 -0500
Subject: [PATCH 741/808] [AIRFLOW-1814] : Temple PythonOperator
 {op_args,op_kwargs} fields (#4691)

---
 airflow/operators/python_operator.py    |  6 +-
 tests/operators/test_python_operator.py | 91 ++++++++++++++++++++++++-
 2 files changed, 93 insertions(+), 4 deletions(-)

diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index c70cbeadf5a5e..c2ab3a639bf21 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -47,10 +47,10 @@ class PythonOperator(BaseOperator):
     :type python_callable: python callable
     :param op_kwargs: a dictionary of keyword arguments that will get unpacked
         in your function
-    :type op_kwargs: dict
+    :type op_kwargs: dict (templated)
     :param op_args: a list of positional arguments that will get unpacked when
         calling your callable
-    :type op_args: list
+    :type op_args: list (templated)
     :param provide_context: if set to true, Airflow will pass a set of
         keyword arguments that can be used in your function. This set of
         kwargs correspond exactly to what you can use in your jinja
@@ -66,7 +66,7 @@ class PythonOperator(BaseOperator):
         processing templated fields, for examples ``['.sql', '.hql']``
     :type templates_exts: list[str]
     """
-    template_fields = ('templates_dict',)
+    template_fields = ('templates_dict', 'op_args', 'op_kwargs')
     template_ext = tuple()
     ui_color = '#ffefeb'
 
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index ecc3f73194f9d..557f021a7f49d 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -23,7 +23,7 @@
 import logging
 import os
 import unittest
-from datetime import timedelta
+from datetime import timedelta, date
 
 from airflow import configuration
 from airflow.exceptions import AirflowException
@@ -46,6 +46,24 @@
                        'AIRFLOW_CTX_DAG_RUN_ID']
 
 
+class Call:
+    def __init__(self, *args, **kwargs):
+        self.args = args
+        self.kwargs = kwargs
+
+
+def build_recording_function(calls_collection):
+    """
+    We can not use a Mock instance as a PythonOperator callable function or some tests fail with a
+    TypeError: Object of type Mock is not JSON serializable
+    Then using this custom function recording custom Call objects for further testing
+    (replacing Mock.assert_called_with assertion method)
+    """
+    def recording_function(*args, **kwargs):
+        calls_collection.append(Call(*args, **kwargs))
+    return recording_function
+
+
 class PythonOperatorTest(unittest.TestCase):
     @classmethod
     def setUpClass(cls):
@@ -121,6 +139,77 @@ def test_python_operator_python_callable_is_callable(self):
                 task_id='python_operator',
                 dag=self.dag)
 
+    def _assertCallsEqual(self, first, second):
+        self.assertIsInstance(first, Call)
+        self.assertIsInstance(second, Call)
+        self.assertTupleEqual(first.args, second.args)
+        self.assertDictEqual(first.kwargs, second.kwargs)
+
+    def test_python_callable_arguments_are_templatized(self):
+        """Test PythonOperator op_args are templatized"""
+        recorded_calls = []
+
+        task = PythonOperator(
+            task_id='python_operator',
+            # a Mock instance cannot be used as a callable function or test fails with a
+            # TypeError: Object of type Mock is not JSON serializable
+            python_callable=(build_recording_function(recorded_calls)),
+            op_args=[
+                4,
+                date(2019, 1, 1),
+                "dag {{dag.dag_id}} ran on {{ds}}."
+            ],
+            dag=self.dag)
+
+        self.dag.create_dagrun(
+            run_id='manual__' + DEFAULT_DATE.isoformat(),
+            execution_date=DEFAULT_DATE,
+            start_date=DEFAULT_DATE,
+            state=State.RUNNING
+        )
+        task.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
+        self.assertEqual(1, len(recorded_calls))
+        self._assertCallsEqual(
+            recorded_calls[0],
+            Call(4,
+                 date(2019, 1, 1),
+                 "dag {} ran on {}.".format(self.dag.dag_id, DEFAULT_DATE.date().isoformat()))
+        )
+
+    def test_python_callable_keyword_arguments_are_templatized(self):
+        """Test PythonOperator op_kwargs are templatized"""
+        recorded_calls = []
+
+        task = PythonOperator(
+            task_id='python_operator',
+            # a Mock instance cannot be used as a callable function or test fails with a
+            # TypeError: Object of type Mock is not JSON serializable
+            python_callable=(build_recording_function(recorded_calls)),
+            op_kwargs={
+                'an_int': 4,
+                'a_date': date(2019, 1, 1),
+                'a_templated_string': "dag {{dag.dag_id}} ran on {{ds}}."
+            },
+            dag=self.dag)
+
+        self.dag.create_dagrun(
+            run_id='manual__' + DEFAULT_DATE.isoformat(),
+            execution_date=DEFAULT_DATE,
+            start_date=DEFAULT_DATE,
+            state=State.RUNNING
+        )
+        task.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
+        self.assertEqual(1, len(recorded_calls))
+        self._assertCallsEqual(
+            recorded_calls[0],
+            Call(an_int=4,
+                 a_date=date(2019, 1, 1),
+                 a_templated_string="dag {} ran on {}.".format(
+                     self.dag.dag_id, DEFAULT_DATE.date().isoformat()))
+        )
+
     def test_python_operator_shallow_copy_attr(self):
         not_callable = lambda x: x
         original_task = PythonOperator(

From 445d17fc5dcba630afd0fcc24cdb75b40d007df6 Mon Sep 17 00:00:00 2001
From: Iuliia Volkova <xnuinside@gmail.com>
Date: Fri, 16 Nov 2018 16:04:27 +0300
Subject: [PATCH 742/808] [AIRFLOW-251] Add option SQL_ALCHEMY_SCHEMA parameter
 to specify schema for metadata (#4199)

---
 airflow/config_templates/default_airflow.cfg |  4 ++++
 airflow/models/__init__.py                   | 10 ++++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 06a6053ef1238..95f06ccd16e19 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -103,6 +103,10 @@ sql_alchemy_pool_recycle = 1800
 # disconnects. Setting this to 0 disables retries.
 sql_alchemy_reconnect_timeout = 300
 
+# The schema to use for the metadata database
+# SqlAlchemy supports databases with the concept of multiple schemas.
+sql_alchemy_schema =
+
 # The amount of parallelism as a setting to the executor. This defines
 # the max number of task instances that should run simultaneously
 # on this airflow installation
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 1626586b6bcc0..6817d44cee496 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -64,7 +64,7 @@
 
 from sqlalchemy import (
     Boolean, Column, DateTime, Float, ForeignKey, ForeignKeyConstraint, Index,
-    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint,
+    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, MetaData,
     and_, asc, func, or_, true as sqltrue
 )
 from sqlalchemy.ext.declarative import declarative_base, declared_attr
@@ -109,7 +109,13 @@
 
 install_aliases()
 
-Base = declarative_base()
+SQL_ALCHEMY_SCHEMA = configuration.get('core', 'SQL_ALCHEMY_SCHEMA')
+
+if not SQL_ALCHEMY_SCHEMA or SQL_ALCHEMY_SCHEMA.isspace():
+    Base = declarative_base()
+else:
+    Base = declarative_base(metadata=MetaData(schema=SQL_ALCHEMY_SCHEMA))
+
 ID_LEN = 250
 XCOM_RETURN_KEY = 'return_value'
 

From 969ff1a16f6adada403ed9f3feb101087ac20d92 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Wed, 26 Dec 2018 21:12:26 +0100
Subject: [PATCH 743/808] [AIRFLOW-3459] Move DagPickle to separate file
 (#4374)

---
 airflow/api/common/experimental/delete_dag.py |  2 +-
 airflow/bin/cli.py                            |  7 ++-
 airflow/jobs.py                               |  5 +-
 airflow/migrations/env.py                     |  2 +-
 airflow/models/__init__.py                    | 42 +++------------
 airflow/models/base.py                        | 30 +++++++++++
 airflow/models/dagpickle.py                   | 52 +++++++++++++++++++
 airflow/utils/db.py                           |  2 +-
 8 files changed, 97 insertions(+), 45 deletions(-)
 create mode 100644 airflow/models/base.py
 create mode 100644 airflow/models/dagpickle.py

diff --git a/airflow/api/common/experimental/delete_dag.py b/airflow/api/common/experimental/delete_dag.py
index b20313a56aefe..f1cb6a952f347 100644
--- a/airflow/api/common/experimental/delete_dag.py
+++ b/airflow/api/common/experimental/delete_dag.py
@@ -47,7 +47,7 @@ def delete_dag(dag_id, keep_records_in_log=True, session=None):
     count = 0
 
     # noinspection PyUnresolvedReferences,PyProtectedMember
-    for m in models.Base._decl_class_registry.values():
+    for m in models.base.Base._decl_class_registry.values():
         if hasattr(m, "dag_id"):
             if keep_records_in_log and m.__name__ == 'Log':
                 continue
diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 523f3fa689686..3736acf2afa77 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -35,7 +35,6 @@
 from builtins import input
 from collections import namedtuple
 
-from airflow.models.connection import Connection
 from airflow.utils.timezone import parse as parsedate
 import json
 from tabulate import tabulate
@@ -57,9 +56,9 @@
 from airflow import configuration as conf
 from airflow.exceptions import AirflowException, AirflowWebServerTimeout
 from airflow.executors import GetDefaultExecutor
-from airflow.models import (DagModel, DagBag, TaskInstance,
-                            DagPickle, DagRun, Variable, DagStat, DAG)
-
+from airflow.models import DagModel, DagBag, TaskInstance, DagRun, Variable, DagStat, DAG
+from airflow.models.connection import Connection
+from airflow.models.dagpickle import DagPickle
 from airflow.ti_deps.dep_context import (DepContext, SCHEDULER_DEPS)
 from airflow.utils import cli as cli_utils, db
 from airflow.utils.net import get_hostname
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 634c0ba249c9e..bc97a42df4d28 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -43,6 +43,7 @@
 from airflow import executors, models, settings
 from airflow.exceptions import AirflowException
 from airflow.models import DAG, DagRun
+from airflow.models.dagpickle import DagPickle
 from airflow.settings import Stats
 from airflow.task.task_runner import get_task_runner
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, RUN_DEPS
@@ -61,7 +62,7 @@
 from airflow.utils.sqlalchemy import UtcDateTime
 from airflow.utils.state import State
 
-Base = models.Base
+Base = models.base.Base
 ID_LEN = models.ID_LEN
 
 
@@ -2454,7 +2455,7 @@ def _execute(self, session=None):
         pickle_id = None
         if not self.donot_pickle and self.executor.__class__ not in (
                 executors.LocalExecutor, executors.SequentialExecutor):
-            pickle = models.DagPickle(self.dag)
+            pickle = DagPickle(self.dag)
             session.add(pickle)
             session.commit()
             pickle_id = pickle.id
diff --git a/airflow/migrations/env.py b/airflow/migrations/env.py
index 4e1977635a12f..76c2eb329b0df 100644
--- a/airflow/migrations/env.py
+++ b/airflow/migrations/env.py
@@ -36,7 +36,7 @@
 # for 'autogenerate' support
 # from myapp import mymodel
 # target_metadata = mymodel.Base.metadata
-target_metadata = models.Base.metadata
+target_metadata = models.base.Base.metadata
 
 # other values from the config, defined by the needs of env.py,
 # can be acquired:
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 6817d44cee496..2bc263517b1fc 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -28,6 +28,8 @@
 from builtins import ImportError as BuiltinImportError, bytes, object, str
 from future.standard_library import install_aliases
 
+from airflow.models.base import Base
+
 try:
     # Fix Python > 3.7 deprecation
     from collections.abc import Hashable
@@ -64,10 +66,10 @@
 
 from sqlalchemy import (
     Boolean, Column, DateTime, Float, ForeignKey, ForeignKeyConstraint, Index,
-    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, MetaData,
-    and_, asc, func, or_, true as sqltrue
+    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, and_, asc,
+    func, or_, true as sqltrue
 )
-from sqlalchemy.ext.declarative import declarative_base, declared_attr
+from sqlalchemy.ext.declarative import declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
 
 from croniter import (
@@ -84,6 +86,7 @@
 )
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.lineage import apply_lineage, prepare_lineage
+from airflow.models.dagpickle import DagPickle
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
 from airflow.ti_deps.deps.prev_dagrun_dep import PrevDagrunDep
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
@@ -109,13 +112,6 @@
 
 install_aliases()
 
-SQL_ALCHEMY_SCHEMA = configuration.get('core', 'SQL_ALCHEMY_SCHEMA')
-
-if not SQL_ALCHEMY_SCHEMA or SQL_ALCHEMY_SCHEMA.isspace():
-    Base = declarative_base()
-else:
-    Base = declarative_base(metadata=MetaData(schema=SQL_ALCHEMY_SCHEMA))
-
 ID_LEN = 250
 XCOM_RETURN_KEY = 'return_value'
 
@@ -636,32 +632,6 @@ def is_superuser(self):
         return self.superuser
 
 
-class DagPickle(Base):
-    """
-    Dags can originate from different places (user repos, master repo, ...)
-    and also get executed in different places (different executors). This
-    object represents a version of a DAG and becomes a source of truth for
-    a BackfillJob execution. A pickle is a native python serialized object,
-    and in this case gets stored in the database for the duration of the job.
-
-    The executors pick up the DagPickle id and read the dag definition from
-    the database.
-    """
-    id = Column(Integer, primary_key=True)
-    pickle = Column(PickleType(pickler=dill))
-    created_dttm = Column(UtcDateTime, default=timezone.utcnow)
-    pickle_hash = Column(Text)
-
-    __tablename__ = "dag_pickle"
-
-    def __init__(self, dag):
-        self.dag_id = dag.dag_id
-        if hasattr(dag, 'template_env'):
-            dag.template_env = None
-        self.pickle_hash = hash(dag)
-        self.pickle = dag
-
-
 class TaskInstance(Base, LoggingMixin):
     """
     Task instances store the state of a task instance. This table is the
diff --git a/airflow/models/base.py b/airflow/models/base.py
new file mode 100644
index 0000000000000..1a06b0b6259f7
--- /dev/null
+++ b/airflow/models/base.py
@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import MetaData
+from sqlalchemy.ext.declarative import declarative_base
+
+import airflow
+
+SQL_ALCHEMY_SCHEMA = airflow.configuration.get("core", "SQL_ALCHEMY_SCHEMA")
+
+if not SQL_ALCHEMY_SCHEMA or SQL_ALCHEMY_SCHEMA.isspace():
+    Base = declarative_base()
+else:
+    Base = declarative_base(metadata=MetaData(schema=SQL_ALCHEMY_SCHEMA))
diff --git a/airflow/models/dagpickle.py b/airflow/models/dagpickle.py
new file mode 100644
index 0000000000000..e261ab1ac009d
--- /dev/null
+++ b/airflow/models/dagpickle.py
@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import dill
+from sqlalchemy import Column, Integer, PickleType, Text
+
+from airflow.models.base import Base
+from airflow.utils import timezone
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class DagPickle(Base):
+    """
+    Dags can originate from different places (user repos, master repo, ...)
+    and also get executed in different places (different executors). This
+    object represents a version of a DAG and becomes a source of truth for
+    a BackfillJob execution. A pickle is a native python serialized object,
+    and in this case gets stored in the database for the duration of the job.
+
+    The executors pick up the DagPickle id and read the dag definition from
+    the database.
+    """
+
+    id = Column(Integer, primary_key=True)
+    pickle = Column(PickleType(pickler=dill))
+    created_dttm = Column(UtcDateTime, default=timezone.utcnow)
+    pickle_hash = Column(Text)
+
+    __tablename__ = "dag_pickle"
+
+    def __init__(self, dag):
+        self.dag_id = dag.dag_id
+        if hasattr(dag, 'template_env'):
+            dag.template_env = None
+        self.pickle_hash = hash(dag)
+        self.pickle = dag
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 144cfab8232dd..5a161ab6c9402 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -361,7 +361,7 @@ def resetdb(rbac):
 
     log.info("Dropping tables that exist")
 
-    models.Base.metadata.drop_all(settings.engine)
+    models.base.Base.metadata.drop_all(settings.engine)
     mc = MigrationContext.configure(settings.engine)
     if mc._version.exists(settings.engine):
         mc._version.drop(settings.engine)

From bf634bab358a1690bd77ca5f0989162c8826ed62 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Fri, 11 Jan 2019 11:19:27 +0100
Subject: [PATCH 744/808] [AIRFLOW-3475] Move ImportError out of models.py
 (#4383)

---
 airflow/jobs.py                 |  8 ++++----
 airflow/models/__init__.py      | 11 ++---------
 airflow/models/errors.py        | 31 +++++++++++++++++++++++++++++++
 airflow/utils/dag_processing.py |  5 +++--
 airflow/www/views.py            |  4 ++--
 airflow/www_rbac/views.py       |  4 ++--
 tests/test_jobs.py              | 17 +++++++++--------
 7 files changed, 53 insertions(+), 27 deletions(-)
 create mode 100644 airflow/models/errors.py

diff --git a/airflow/jobs.py b/airflow/jobs.py
index bc97a42df4d28..0431a9bc23730 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -42,7 +42,7 @@
 from airflow import configuration as conf
 from airflow import executors, models, settings
 from airflow.exceptions import AirflowException
-from airflow.models import DAG, DagRun
+from airflow.models import DAG, DagRun, errors
 from airflow.models.dagpickle import DagPickle
 from airflow.settings import Stats
 from airflow.task.task_runner import get_task_runner
@@ -762,13 +762,13 @@ def update_import_errors(session, dagbag):
         """
         # Clear the errors of the processed files
         for dagbag_file in dagbag.file_last_changed:
-            session.query(models.ImportError).filter(
-                models.ImportError.filename == dagbag_file
+            session.query(errors.ImportError).filter(
+                errors.ImportError.filename == dagbag_file
             ).delete()
 
         # Add the errors of the processed files
         for filename, stacktrace in six.iteritems(dagbag.import_errors):
-            session.add(models.ImportError(
+            session.add(errors.ImportError(
                 filename=filename,
                 stacktrace=stacktrace))
         session.commit()
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 2bc263517b1fc..6c5339efd5e48 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -33,7 +33,7 @@
 try:
     # Fix Python > 3.7 deprecation
     from collections.abc import Hashable
-except ImportError:
+except BuiltinImportError:
     # Preserve Python < 3.3 compatibility
     from collections import Hashable
 from datetime import timedelta
@@ -87,6 +87,7 @@
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.lineage import apply_lineage, prepare_lineage
 from airflow.models.dagpickle import DagPickle
+from airflow.models.errors import ImportError  # noqa: F401
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
 from airflow.ti_deps.deps.prev_dagrun_dep import PrevDagrunDep
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
@@ -5323,14 +5324,6 @@ def __repr__(self):
             self.dag_id, self.task_id, self.execution_date.isoformat()))
 
 
-class ImportError(Base):
-    __tablename__ = "import_error"
-    id = Column(Integer, primary_key=True)
-    timestamp = Column(UtcDateTime)
-    filename = Column(String(1024))
-    stacktrace = Column(Text)
-
-
 class KubeResourceVersion(Base):
     __tablename__ = "kube_resource_version"
     one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
diff --git a/airflow/models/errors.py b/airflow/models/errors.py
new file mode 100644
index 0000000000000..6a3797ca3df9b
--- /dev/null
+++ b/airflow/models/errors.py
@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import Integer, Column, String, Text
+
+from airflow.models.base import Base
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class ImportError(Base):
+    __tablename__ = "import_error"
+    id = Column(Integer, primary_key=True)
+    timestamp = Column(UtcDateTime)
+    filename = Column(String(1024))
+    stacktrace = Column(Text)
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 61c4fb36f3d1f..4a5a3f629d415 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -47,6 +47,7 @@
 from airflow.dag.base_dag import BaseDag, BaseDagBag
 from airflow.exceptions import AirflowException
 from airflow.settings import Stats
+from airflow.models import errors
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -923,10 +924,10 @@ def clear_nonexistent_import_errors(self, session):
         :param session: session for ORM operations
         :type session: sqlalchemy.orm.session.Session
         """
-        query = session.query(airflow.models.ImportError)
+        query = session.query(errors.ImportError)
         if self._file_paths:
             query = query.filter(
-                ~airflow.models.ImportError.filename.in_(self._file_paths)
+                ~errors.ImportError.filename.in_(self._file_paths)
             )
         query.delete(synchronize_session='fetch')
         session.commit()
diff --git a/airflow/www/views.py b/airflow/www/views.py
index ad829a4e05f07..405903f2c4499 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -65,7 +65,7 @@
                                                         set_dag_run_state_to_success,
                                                         set_dag_run_state_to_failed)
 from airflow.exceptions import AirflowException
-from airflow.models import BaseOperator
+from airflow.models import BaseOperator, errors
 from airflow.models import XCom, DagRun
 from airflow.models.connection import Connection
 from airflow.operators.subdag_operator import SubDagOperator
@@ -2138,7 +2138,7 @@ def get_int_arg(value, default=0):
 
         dags = query.offset(start).limit(dags_per_page).all()
 
-        import_errors = session.query(models.ImportError).all()
+        import_errors = session.query(errors.ImportError).all()
         for ie in import_errors:
             flash(
                 "Broken DAG: [{ie.filename}] {ie.stacktrace}".format(ie=ie),
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index df76ed291ec0e..900bc349da73f 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -53,7 +53,7 @@
 from airflow import settings
 from airflow.api.common.experimental.mark_tasks import (set_dag_run_state_to_success,
                                                         set_dag_run_state_to_failed)
-from airflow.models import XCom, DagRun
+from airflow.models import XCom, DagRun, errors
 from airflow.models.connection import Connection
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
@@ -227,7 +227,7 @@ def get_int_arg(value, default=0):
         if arg_search_query:
             query = query.filter(sqla.func.lower(DM.dag_id) == arg_search_query.lower())
 
-        import_errors = session.query(models.ImportError).all()
+        import_errors = session.query(errors.ImportError).all()
         for ie in import_errors:
             flash(
                 "Broken DAG: [{ie.filename}] {ie.stacktrace}".format(ie=ie),
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 29fb5728df7b0..41b7ace65fadb 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -46,7 +46,8 @@
 import airflow.example_dags
 from airflow.executors import BaseExecutor, SequentialExecutor
 from airflow.jobs import BaseJob, BackfillJob, SchedulerJob, LocalTaskJob
-from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI
+from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI, \
+    errors
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.task.task_runner.base_task_runner import BaseTaskRunner
@@ -1396,7 +1397,7 @@ def setUp(self):
             session.query(models.Pool).delete()
             session.query(models.DagModel).delete()
             session.query(models.SlaMiss).delete()
-            session.query(models.ImportError).delete()
+            session.query(errors.ImportError).delete()
             session.commit()
 
     @classmethod
@@ -3500,7 +3501,7 @@ def test_add_unparseable_file_before_sched_start_creates_import_error(self):
             shutil.rmtree(dags_folder)
 
         with create_session() as session:
-            import_errors = session.query(models.ImportError).all()
+            import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 1)
         import_error = import_errors[0]
@@ -3522,7 +3523,7 @@ def test_add_unparseable_file_after_sched_start_creates_import_error(self):
             shutil.rmtree(dags_folder)
 
         with create_session() as session:
-            import_errors = session.query(models.ImportError).all()
+            import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 1)
         import_error = import_errors[0]
@@ -3543,7 +3544,7 @@ def test_no_import_errors_with_parseable_dag(self):
             shutil.rmtree(dags_folder)
 
         with create_session() as session:
-            import_errors = session.query(models.ImportError).all()
+            import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 0)
 
@@ -3568,7 +3569,7 @@ def test_new_import_error_replaces_old(self):
             shutil.rmtree(dags_folder)
 
         session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 1)
         import_error = import_errors[0]
@@ -3596,7 +3597,7 @@ def test_remove_error_clears_import_error(self):
             shutil.rmtree(dags_folder)
 
         session = settings.Session()
-        import_errors = session.query(models.ImportError).all()
+        import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 0)
 
@@ -3616,7 +3617,7 @@ def test_remove_file_clears_import_error(self):
         self.run_single_scheduler_loop_with_no_dags(dags_folder)
 
         with create_session() as session:
-            import_errors = session.query(models.ImportError).all()
+            import_errors = session.query(errors.ImportError).all()
 
         self.assertEqual(len(import_errors), 0)
 

From 5ca467af099e86c64241e4f4d88266207ec9d0e2 Mon Sep 17 00:00:00 2001
From: andyh1203 <andyh1203@users.noreply.github.com>
Date: Tue, 29 Jan 2019 02:19:53 -0800
Subject: [PATCH 745/808] [AIRFLOW-3474] Move SlaMiss out of models.py (#4608)

---
 airflow/jobs.py            |  4 ++--
 airflow/models/__init__.py | 29 ++---------------------
 airflow/models/base.py     |  2 ++
 airflow/models/slamiss.py  | 48 ++++++++++++++++++++++++++++++++++++++
 tests/test_jobs.py         | 23 +++++++++---------
 5 files changed, 66 insertions(+), 40 deletions(-)
 create mode 100644 airflow/models/slamiss.py

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 0431a9bc23730..1ad2fad10c550 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -44,6 +44,7 @@
 from airflow.exceptions import AirflowException
 from airflow.models import DAG, DagRun, errors
 from airflow.models.dagpickle import DagPickle
+from airflow.models.slamiss import SlaMiss
 from airflow.settings import Stats
 from airflow.task.task_runner import get_task_runner
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, RUN_DEPS
@@ -651,7 +652,6 @@ def manage_slas(self, dag, session=None):
         ).all()
 
         ts = timezone.utcnow()
-        SlaMiss = models.SlaMiss
         for ti in max_tis:
             task = dag.get_task(ti.task_id)
             dttm = ti.execution_date
@@ -660,7 +660,7 @@ def manage_slas(self, dag, session=None):
                 while dttm < timezone.utcnow():
                     following_schedule = dag.following_schedule(dttm)
                     if following_schedule + task.sla < timezone.utcnow():
-                        session.merge(models.SlaMiss(
+                        session.merge(SlaMiss(
                             task_id=ti.task_id,
                             dag_id=ti.dag_id,
                             execution_date=dttm,
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 6c5339efd5e48..4584f749ad298 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -28,7 +28,7 @@
 from builtins import ImportError as BuiltinImportError, bytes, object, str
 from future.standard_library import install_aliases
 
-from airflow.models.base import Base
+from airflow.models.base import Base, ID_LEN
 
 try:
     # Fix Python > 3.7 deprecation
@@ -88,6 +88,7 @@
 from airflow.lineage import apply_lineage, prepare_lineage
 from airflow.models.dagpickle import DagPickle
 from airflow.models.errors import ImportError  # noqa: F401
+from airflow.models.slamiss import SlaMiss  # noqa: F401
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
 from airflow.ti_deps.deps.prev_dagrun_dep import PrevDagrunDep
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
@@ -113,7 +114,6 @@
 
 install_aliases()
 
-ID_LEN = 250
 XCOM_RETURN_KEY = 'return_value'
 
 Stats = settings.Stats
@@ -5299,31 +5299,6 @@ def open_slots(self, session):
         return self.slots - used_slots - queued_slots
 
 
-class SlaMiss(Base):
-    """
-    Model that stores a history of the SLA that have been missed.
-    It is used to keep track of SLA failures over time and to avoid double
-    triggering alert emails.
-    """
-    __tablename__ = "sla_miss"
-
-    task_id = Column(String(ID_LEN), primary_key=True)
-    dag_id = Column(String(ID_LEN), primary_key=True)
-    execution_date = Column(UtcDateTime, primary_key=True)
-    email_sent = Column(Boolean, default=False)
-    timestamp = Column(UtcDateTime)
-    description = Column(Text)
-    notification_sent = Column(Boolean, default=False)
-
-    __table_args__ = (
-        Index('sm_dag', dag_id, unique=False),
-    )
-
-    def __repr__(self):
-        return str((
-            self.dag_id, self.task_id, self.execution_date.isoformat()))
-
-
 class KubeResourceVersion(Base):
     __tablename__ = "kube_resource_version"
     one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
diff --git a/airflow/models/base.py b/airflow/models/base.py
index 1a06b0b6259f7..3f5eb80154b73 100644
--- a/airflow/models/base.py
+++ b/airflow/models/base.py
@@ -28,3 +28,5 @@
     Base = declarative_base()
 else:
     Base = declarative_base(metadata=MetaData(schema=SQL_ALCHEMY_SCHEMA))
+
+ID_LEN = 250
diff --git a/airflow/models/slamiss.py b/airflow/models/slamiss.py
new file mode 100644
index 0000000000000..0981be886ea01
--- /dev/null
+++ b/airflow/models/slamiss.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import Boolean, Column, String, Index, Text
+
+from airflow.models.base import Base, ID_LEN
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class SlaMiss(Base):
+    """
+    Model that stores a history of the SLA that have been missed.
+    It is used to keep track of SLA failures over time and to avoid double
+    triggering alert emails.
+    """
+    __tablename__ = "sla_miss"
+
+    task_id = Column(String(ID_LEN), primary_key=True)
+    dag_id = Column(String(ID_LEN), primary_key=True)
+    execution_date = Column(UtcDateTime, primary_key=True)
+    email_sent = Column(Boolean, default=False)
+    timestamp = Column(UtcDateTime)
+    description = Column(Text)
+    notification_sent = Column(Boolean, default=False)
+
+    __table_args__ = (
+        Index('sm_dag', dag_id, unique=False),
+    )
+
+    def __repr__(self):
+        return str((
+            self.dag_id, self.task_id, self.execution_date.isoformat()))
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 41b7ace65fadb..26cc5bca28b02 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -48,6 +48,7 @@
 from airflow.jobs import BaseJob, BackfillJob, SchedulerJob, LocalTaskJob
 from airflow.models import DAG, DagModel, DagBag, DagRun, Pool, TaskInstance as TI, \
     errors
+from airflow.models.slamiss import SlaMiss
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.task.task_runner.base_task_runner import BaseTaskRunner
@@ -3098,11 +3099,11 @@ def test_scheduler_sla_miss_callback(self):
                                           state='success'))
 
         # Create an SlaMiss where notification was sent, but email was not
-        session.merge(models.SlaMiss(task_id='dummy',
-                                     dag_id='test_sla_miss',
-                                     execution_date=test_start_date,
-                                     email_sent=False,
-                                     notification_sent=True))
+        session.merge(SlaMiss(task_id='dummy',
+                              dag_id='test_sla_miss',
+                              execution_date=test_start_date,
+                              email_sent=False,
+                              notification_sent=True))
 
         # Now call manage_slas and see if the sla_miss callback gets called
         scheduler = SchedulerJob(dag_id='test_sla_miss',
@@ -3135,9 +3136,9 @@ def test_scheduler_sla_miss_callback_exception(self):
                                           state='Success'))
 
         # Create an SlaMiss where notification was sent, but email was not
-        session.merge(models.SlaMiss(task_id='dummy',
-                                     dag_id='test_sla_miss',
-                                     execution_date=test_start_date))
+        session.merge(SlaMiss(task_id='dummy',
+                              dag_id='test_sla_miss',
+                              execution_date=test_start_date))
 
         # Now call manage_slas and see if the sla_miss callback gets called
         scheduler = SchedulerJob(dag_id='test_sla_miss')
@@ -3177,9 +3178,9 @@ def test_scheduler_sla_miss_email_exception(self, mock_send_email):
                                           state='Success'))
 
         # Create an SlaMiss where notification was sent, but email was not
-        session.merge(models.SlaMiss(task_id='dummy',
-                                     dag_id='test_sla_miss',
-                                     execution_date=test_start_date))
+        session.merge(SlaMiss(task_id='dummy',
+                              dag_id='test_sla_miss',
+                              execution_date=test_start_date))
 
         scheduler = SchedulerJob(dag_id='test_sla_miss',
                                  num_runs=1)

From 6f92e5144840081449b389e6f4a3f0fe88f91a76 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Wed, 30 Jan 2019 23:31:37 +0100
Subject: [PATCH 746/808] [AIRFLOW-3462] Move TaskReschedule out of models.py
 (#4618)

---
 airflow/jobs.py                               |  2 +-
 airflow/models/__init__.py                    | 66 +-------------
 airflow/models/connection.py                  |  3 +-
 airflow/models/taskreschedule.py              | 85 +++++++++++++++++++
 airflow/sensors/base_sensor_operator.py       |  3 +-
 airflow/ti_deps/deps/ready_to_reschedule.py   |  3 +-
 tests/models.py                               |  6 +-
 tests/sensors/test_base_sensor.py             |  3 +-
 .../deps/test_ready_to_reschedule_dep.py      | 13 +--
 9 files changed, 106 insertions(+), 78 deletions(-)
 create mode 100755 airflow/models/taskreschedule.py

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 1ad2fad10c550..72e802b78458a 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -64,7 +64,7 @@
 from airflow.utils.state import State
 
 Base = models.base.Base
-ID_LEN = models.ID_LEN
+ID_LEN = models.base.ID_LEN
 
 
 class BaseJob(Base, LoggingMixin):
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 4584f749ad298..eb8aa033509a2 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -65,8 +65,8 @@
 from urllib.parse import quote
 
 from sqlalchemy import (
-    Boolean, Column, DateTime, Float, ForeignKey, ForeignKeyConstraint, Index,
-    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, and_, asc,
+    Boolean, Column, DateTime, Float, ForeignKey, Index,
+    Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, and_,
     func, or_, true as sqltrue
 )
 from sqlalchemy.ext.declarative import declared_attr
@@ -89,6 +89,7 @@
 from airflow.models.dagpickle import DagPickle
 from airflow.models.errors import ImportError  # noqa: F401
 from airflow.models.slamiss import SlaMiss  # noqa: F401
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
 from airflow.ti_deps.deps.prev_dagrun_dep import PrevDagrunDep
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
@@ -1954,67 +1955,6 @@ def __init__(self, task, execution_date, start_date, end_date):
             self.duration = None
 
 
-class TaskReschedule(Base):
-    """
-    TaskReschedule tracks rescheduled task instances.
-    """
-
-    __tablename__ = "task_reschedule"
-
-    id = Column(Integer, primary_key=True)
-    task_id = Column(String(ID_LEN), nullable=False)
-    dag_id = Column(String(ID_LEN), nullable=False)
-    execution_date = Column(UtcDateTime, nullable=False)
-    try_number = Column(Integer, nullable=False)
-    start_date = Column(UtcDateTime, nullable=False)
-    end_date = Column(UtcDateTime, nullable=False)
-    duration = Column(Integer, nullable=False)
-    reschedule_date = Column(UtcDateTime, nullable=False)
-
-    __table_args__ = (
-        Index('idx_task_reschedule_dag_task_date', dag_id, task_id, execution_date,
-              unique=False),
-        ForeignKeyConstraint([task_id, dag_id, execution_date],
-                             ['task_instance.task_id', 'task_instance.dag_id',
-                              'task_instance.execution_date'],
-                             name='task_reschedule_dag_task_date_fkey',
-                             ondelete='CASCADE')
-    )
-
-    def __init__(self, task, execution_date, try_number, start_date, end_date,
-                 reschedule_date):
-        self.dag_id = task.dag_id
-        self.task_id = task.task_id
-        self.execution_date = execution_date
-        self.try_number = try_number
-        self.start_date = start_date
-        self.end_date = end_date
-        self.reschedule_date = reschedule_date
-        self.duration = (self.end_date - self.start_date).total_seconds()
-
-    @staticmethod
-    @provide_session
-    def find_for_task_instance(task_instance, session):
-        """
-        Returns all task reschedules for the task instance and try number,
-        in ascending order.
-
-        :param task_instance: the task instance to find task reschedules for
-        :type task_instance: airflow.models.TaskInstance
-        """
-        TR = TaskReschedule
-        return (
-            session
-            .query(TR)
-            .filter(TR.dag_id == task_instance.dag_id,
-                    TR.task_id == task_instance.task_id,
-                    TR.execution_date == task_instance.execution_date,
-                    TR.try_number == task_instance.try_number)
-            .order_by(asc(TR.id))
-            .all()
-        )
-
-
 class Log(Base):
     """
     Used to actively log events to the database
diff --git a/airflow/models/connection.py b/airflow/models/connection.py
index 5d8905a183530..633baaadad57d 100644
--- a/airflow/models/connection.py
+++ b/airflow/models/connection.py
@@ -27,7 +27,8 @@
 
 from airflow.exceptions import AirflowException
 from airflow import LoggingMixin
-from airflow.models import Base, ID_LEN, get_fernet
+from airflow.models import get_fernet
+from airflow.models.base import Base, ID_LEN
 
 
 class Connection(Base, LoggingMixin):
diff --git a/airflow/models/taskreschedule.py b/airflow/models/taskreschedule.py
new file mode 100755
index 0000000000000..4bdb6431f1ae4
--- /dev/null
+++ b/airflow/models/taskreschedule.py
@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import Column, ForeignKeyConstraint, Index, Integer, String, asc
+
+from airflow.models.base import Base, ID_LEN
+from airflow.utils.db import provide_session
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class TaskReschedule(Base):
+    """
+    TaskReschedule tracks rescheduled task instances.
+    """
+
+    __tablename__ = "task_reschedule"
+
+    id = Column(Integer, primary_key=True)
+    task_id = Column(String(ID_LEN), nullable=False)
+    dag_id = Column(String(ID_LEN), nullable=False)
+    execution_date = Column(UtcDateTime, nullable=False)
+    try_number = Column(Integer, nullable=False)
+    start_date = Column(UtcDateTime, nullable=False)
+    end_date = Column(UtcDateTime, nullable=False)
+    duration = Column(Integer, nullable=False)
+    reschedule_date = Column(UtcDateTime, nullable=False)
+
+    __table_args__ = (
+        Index('idx_task_reschedule_dag_task_date', dag_id, task_id, execution_date,
+              unique=False),
+        ForeignKeyConstraint([task_id, dag_id, execution_date],
+                             ['task_instance.task_id', 'task_instance.dag_id',
+                              'task_instance.execution_date'],
+                             name='task_reschedule_dag_task_date_fkey',
+                             ondelete='CASCADE')
+    )
+
+    def __init__(self, task, execution_date, try_number, start_date, end_date,
+                 reschedule_date):
+        self.dag_id = task.dag_id
+        self.task_id = task.task_id
+        self.execution_date = execution_date
+        self.try_number = try_number
+        self.start_date = start_date
+        self.end_date = end_date
+        self.reschedule_date = reschedule_date
+        self.duration = (self.end_date - self.start_date).total_seconds()
+
+    @staticmethod
+    @provide_session
+    def find_for_task_instance(task_instance, session):
+        """
+        Returns all task reschedules for the task instance and try number,
+        in ascending order.
+
+        :param task_instance: the task instance to find task reschedules for
+        :type task_instance: airflow.models.TaskInstance
+        """
+        TR = TaskReschedule
+        return (
+            session
+            .query(TR)
+            .filter(TR.dag_id == task_instance.dag_id,
+                    TR.task_id == task_instance.task_id,
+                    TR.execution_date == task_instance.execution_date,
+                    TR.try_number == task_instance.try_number)
+            .order_by(asc(TR.id))
+            .all()
+        )
diff --git a/airflow/sensors/base_sensor_operator.py b/airflow/sensors/base_sensor_operator.py
index 3874fd4dd26c4..2e99704c86feb 100644
--- a/airflow/sensors/base_sensor_operator.py
+++ b/airflow/sensors/base_sensor_operator.py
@@ -23,7 +23,8 @@
 
 from airflow.exceptions import AirflowException, AirflowSensorTimeout, \
     AirflowSkipException, AirflowRescheduleException
-from airflow.models import BaseOperator, SkipMixin, TaskReschedule
+from airflow.models import BaseOperator, SkipMixin
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.utils import timezone
 from airflow.utils.decorators import apply_defaults
 from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
diff --git a/airflow/ti_deps/deps/ready_to_reschedule.py b/airflow/ti_deps/deps/ready_to_reschedule.py
index dc1c92c654f43..348cf00f5feb6 100644
--- a/airflow/ti_deps/deps/ready_to_reschedule.py
+++ b/airflow/ti_deps/deps/ready_to_reschedule.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.deps.base_ti_dep import BaseTIDep
 from airflow.utils import timezone
 from airflow.utils.db import provide_session
@@ -49,8 +50,6 @@ def _get_dep_statuses(self, ti, session, dep_context):
                 reason="The task instance is not in State_UP_FOR_RESCHEDULE or NONE state.")
             return
 
-        # Lazy import to avoid circular dependency
-        from airflow.models import TaskReschedule
         task_reschedules = TaskReschedule.find_for_task_instance(task_instance=ti)
         if not task_reschedules:
             yield self._passing_status(
diff --git a/tests/models.py b/tests/models.py
index ea3e3aefa5ea7..848166c1d9214 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -50,10 +50,10 @@
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.models import SkipMixin
 from airflow.models import State as ST
-from airflow.models import TaskReschedule as TR
 from airflow.models import XCom
 from airflow.models import clear_task_instances
 from airflow.models.connection import Connection
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import PythonOperator
@@ -2057,7 +2057,7 @@ class TaskInstanceTest(unittest.TestCase):
     def tearDown(self):
         with create_session() as session:
             session.query(models.TaskFail).delete()
-            session.query(models.TaskReschedule).delete()
+            session.query(TaskReschedule).delete()
             session.query(models.TaskInstance).delete()
 
     def test_set_task_dates(self):
@@ -2478,7 +2478,7 @@ def run_ti_and_assert(run_date, expected_start_date, expected_end_date, expected
             self.assertEqual(ti.start_date, expected_start_date)
             self.assertEqual(ti.end_date, expected_end_date)
             self.assertEqual(ti.duration, expected_duration)
-            trs = TR.find_for_task_instance(ti)
+            trs = TaskReschedule.find_for_task_instance(ti)
             self.assertEqual(len(trs), expected_task_reschedule_count)
 
         date1 = timezone.utcnow()
diff --git a/tests/sensors/test_base_sensor.py b/tests/sensors/test_base_sensor.py
index 9cb192e927de7..9af8cbf1c3018 100644
--- a/tests/sensors/test_base_sensor.py
+++ b/tests/sensors/test_base_sensor.py
@@ -23,7 +23,8 @@
 from airflow import DAG, configuration, settings
 from airflow.exceptions import (AirflowSensorTimeout, AirflowException,
                                 AirflowRescheduleException)
-from airflow.models import DagRun, TaskInstance, TaskReschedule
+from airflow.models import DagRun, TaskInstance
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.sensors.base_sensor_operator import BaseSensorOperator
 from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
diff --git a/tests/ti_deps/deps/test_ready_to_reschedule_dep.py b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
index 9bae3498984f1..4bfcd6f12e3de 100644
--- a/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
+++ b/tests/ti_deps/deps/test_ready_to_reschedule_dep.py
@@ -21,7 +21,8 @@
 from datetime import timedelta
 from mock import Mock, patch
 
-from airflow.models import TaskInstance, DAG, TaskReschedule
+from airflow.models import TaskInstance, DAG
+from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.dep_context import DepContext
 from airflow.ti_deps.deps.ready_to_reschedule import ReadyToRescheduleDep
 from airflow.utils.state import State
@@ -52,12 +53,12 @@ def test_should_pass_if_not_in_none_state(self):
         ti = self._get_task_instance(State.UP_FOR_RETRY)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
-    @patch('airflow.models.TaskReschedule.find_for_task_instance', return_value=[])
+    @patch('airflow.models.taskreschedule.TaskReschedule.find_for_task_instance', return_value=[])
     def test_should_pass_if_no_reschedule_record_exists(self, find_for_task_instance):
         ti = self._get_task_instance(State.NONE)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
-    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    @patch('airflow.models.taskreschedule.TaskReschedule.find_for_task_instance')
     def test_should_pass_after_reschedule_date_one(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() - timedelta(minutes=1)),
@@ -65,7 +66,7 @@ def test_should_pass_after_reschedule_date_one(self, find_for_task_instance):
         ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
-    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    @patch('airflow.models.taskreschedule.TaskReschedule.find_for_task_instance')
     def test_should_pass_after_reschedule_date_multiple(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() - timedelta(minutes=21)),
@@ -75,7 +76,7 @@ def test_should_pass_after_reschedule_date_multiple(self, find_for_task_instance
         ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertTrue(ReadyToRescheduleDep().is_met(ti=ti))
 
-    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    @patch('airflow.models.taskreschedule.TaskReschedule.find_for_task_instance')
     def test_should_fail_before_reschedule_date_one(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() + timedelta(minutes=1)),
@@ -83,7 +84,7 @@ def test_should_fail_before_reschedule_date_one(self, find_for_task_instance):
         ti = self._get_task_instance(State.UP_FOR_RESCHEDULE)
         self.assertFalse(ReadyToRescheduleDep().is_met(ti=ti))
 
-    @patch('airflow.models.TaskReschedule.find_for_task_instance')
+    @patch('airflow.models.taskreschedule.TaskReschedule.find_for_task_instance')
     def test_should_fail_before_reschedule_date_multiple(self, find_for_task_instance):
         find_for_task_instance.return_value = [
             self._get_task_reschedule(utcnow() - timedelta(minutes=19)),

From aad93dd42fa04b36be5e3f9883d7eca1d0655943 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 15 Mar 2019 07:28:52 -0400
Subject: [PATCH 747/808] [AIRFLOW-3862] Check types with mypy. (#4685)

---
 .gitignore                                    |  5 ++
 .travis.yml                                   |  4 ++
 airflow/__init__.py                           |  4 +-
 airflow/api/__init__.py                       |  4 +-
 airflow/api/auth/backend/kerberos_auth.py     |  2 +-
 airflow/bin/cli.py                            | 22 +++++--
 .../airflow_local_settings.py                 |  3 +-
 .../example_gcs_to_bq_operator.py             | 10 ++-
 .../example_dags/example_winrm_operator.py    |  2 +-
 airflow/contrib/hooks/databricks_hook.py      |  6 +-
 airflow/contrib/kubernetes/pod_launcher.py    |  5 +-
 .../contrib/operators/adls_list_operator.py   |  4 +-
 .../azure_container_instances_operator.py     | 12 +++-
 .../operators/gcp_bigtable_operator.py        |  3 +-
 .../contrib/operators/gcs_list_operator.py    |  4 +-
 .../operators/jenkins_job_trigger_operator.py |  8 +--
 .../operators/kubernetes_pod_operator.py      |  4 --
 airflow/contrib/operators/qubole_operator.py  |  6 +-
 airflow/contrib/operators/s3_list_operator.py |  4 +-
 .../operators/sagemaker_base_operator.py      |  4 +-
 airflow/contrib/sensors/python_sensor.py      |  1 -
 airflow/contrib/utils/gcp_field_sanitizer.py  |  4 +-
 airflow/contrib/utils/gcp_field_validator.py  |  4 +-
 airflow/hooks/dbapi_hook.py                   |  3 +-
 airflow/jobs.py                               |  3 +-
 airflow/lineage/datasets.py                   |  3 +-
 airflow/models/__init__.py                    | 65 ++++++++++++-------
 airflow/models/base.py                        | 11 ++--
 airflow/operators/check_operator.py           | 13 ++--
 airflow/operators/dagrun_operator.py          |  1 -
 airflow/operators/dummy_operator.py           |  1 -
 airflow/operators/python_operator.py          |  1 -
 airflow/operators/subdag_operator.py          |  1 -
 airflow/plugins_manager.py                    | 35 +++++-----
 airflow/sensors/sql_sensor.py                 |  5 +-
 airflow/settings.py                           |  3 +-
 airflow/utils/cli_action_loggers.py           |  5 +-
 airflow/utils/dag_processing.py               | 10 +--
 airflow/utils/trigger_rule.py                 |  3 +-
 airflow/utils/weight_rule.py                  |  3 +-
 airflow/www/app.py                            |  5 +-
 airflow/www/views.py                          |  5 +-
 airflow/www_rbac/app.py                       |  5 +-
 airflow/www_rbac/static_config.py             |  5 +-
 airflow/www_rbac/views.py                     |  2 +-
 setup.cfg                                     | 12 ++++
 setup.py                                      |  2 +-
 47 files changed, 201 insertions(+), 126 deletions(-)

diff --git a/.gitignore b/.gitignore
index 114236d467885..089d7b1e2f7e3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -152,3 +152,8 @@ airflow-*.err
 airflow-*.out
 airflow-*.log
 airflow-*.pid
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
diff --git a/.travis.yml b/.travis.yml
index 29aeb6ebb7b7c..ff06ee7cc57fe 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -43,6 +43,10 @@ jobs:
       stage: pre-test
       install: pip install flake8
       script: flake8
+    - name: mypy
+      stage: pre-test
+      install: pip install mypy
+      script: mypy airflow
     - name: Check license header
       stage: pre-test
       install: skip
diff --git a/airflow/__init__.py b/airflow/__init__.py
index 7324e49119c5d..4434dc4413e1f 100644
--- a/airflow/__init__.py
+++ b/airflow/__init__.py
@@ -25,6 +25,8 @@
 `airflow.www.login`
 """
 from builtins import object
+from typing import Any
+
 from airflow import version
 from airflow.utils.log.logging_mixin import LoggingMixin
 
@@ -41,7 +43,7 @@
 
 settings.initialize()
 
-login = None
+login = None  # type: Any
 
 
 def load_login():
diff --git a/airflow/api/__init__.py b/airflow/api/__init__.py
index b4a2f8f5bc36f..67cb51d199e63 100644
--- a/airflow/api/__init__.py
+++ b/airflow/api/__init__.py
@@ -19,13 +19,15 @@
 
 from __future__ import print_function
 
+from typing import Any
+
 from airflow.exceptions import AirflowException
 from airflow import configuration as conf
 from importlib import import_module
 
 from airflow.utils.log.logging_mixin import LoggingMixin
 
-api_auth = None
+api_auth = None  # type: Any
 
 log = LoggingMixin().log
 
diff --git a/airflow/api/auth/backend/kerberos_auth.py b/airflow/api/auth/backend/kerberos_auth.py
index 7e560fb296dad..1b80e2efeb0cd 100644
--- a/airflow/api/auth/backend/kerberos_auth.py
+++ b/airflow/api/auth/backend/kerberos_auth.py
@@ -27,7 +27,7 @@
 from airflow import configuration as conf
 
 from flask import Response
-from flask import _request_ctx_stack as stack
+from flask import _request_ctx_stack as stack  # type: ignore
 from flask import make_response
 from flask import request
 from flask import g
diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index 3736acf2afa77..af88f2ca2c921 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -33,7 +33,6 @@
 import reprlib
 import argparse
 from builtins import input
-from collections import namedtuple
 
 from airflow.utils.timezone import parse as parsedate
 import json
@@ -49,6 +48,7 @@
 import psutil
 import re
 from urllib.parse import urlunparse
+from typing import Any
 
 import airflow
 from airflow import api
@@ -73,7 +73,7 @@
 from sqlalchemy.orm import exc
 
 api.load_auth()
-api_module = import_module(conf.get('cli', 'api_client'))
+api_module = import_module(conf.get('cli', 'api_client'))  # type: Any
 api_client = api_module.Client(api_base_url=conf.get('cli', 'endpoint_url'),
                                auth=api.api_auth.client_auth)
 
@@ -1469,9 +1469,17 @@ def sync_perm(args): # noqa
         print('The sync_perm command only works for rbac UI.')
 
 
-Arg = namedtuple(
-    'Arg', ['flags', 'help', 'action', 'default', 'nargs', 'type', 'choices', 'metavar'])
-Arg.__new__.__defaults__ = (None, None, None, None, None, None, None)
+class Arg(object):
+    def __init__(self, flags=None, help=None, action=None, default=None, nargs=None,
+                 type=None, choices=None, metavar=None):
+        self.flags = flags
+        self.help = help
+        self.action = action
+        self.default = default
+        self.nargs = nargs
+        self.type = type
+        self.choices = choices
+        self.metavar = metavar
 
 
 class CLIFactory(object):
@@ -2124,8 +2132,8 @@ def get_parser(cls, dag_parser=False):
                     continue
                 arg = cls.args[arg]
                 kwargs = {
-                    f: getattr(arg, f)
-                    for f in arg._fields if f != 'flags' and getattr(arg, f)}
+                    f: v
+                    for f, v in vars(arg).items() if f != 'flags' and v}
                 sp.add_argument(*arg.flags, **kwargs)
             sp.set_defaults(func=sub['func'])
         return parser
diff --git a/airflow/config_templates/airflow_local_settings.py b/airflow/config_templates/airflow_local_settings.py
index b82755c939120..a25f56d076647 100644
--- a/airflow/config_templates/airflow_local_settings.py
+++ b/airflow/config_templates/airflow_local_settings.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import os
+from typing import Dict, Any
 
 from airflow import configuration as conf
 from airflow.utils.file import mkdirs
@@ -107,7 +108,7 @@
         'handlers': ['console'],
         'level': LOG_LEVEL,
     }
-}
+}  # type: Dict[str, Any]
 
 DEFAULT_DAG_PARSING_LOGGING_CONFIG = {
     'handlers': {
diff --git a/airflow/contrib/example_dags/example_gcs_to_bq_operator.py b/airflow/contrib/example_dags/example_gcs_to_bq_operator.py
index ee9fe093913e2..b76d05eec138e 100644
--- a/airflow/contrib/example_dags/example_gcs_to_bq_operator.py
+++ b/airflow/contrib/example_dags/example_gcs_to_bq_operator.py
@@ -17,13 +17,17 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Any
+
 import airflow
+from airflow import models
+from airflow.operators import bash_operator
+
+gcs_to_bq = None  # type: Any
 try:
     from airflow.contrib.operators import gcs_to_bq
 except ImportError:
-    gcs_to_bq = None
-from airflow import models
-from airflow.operators import bash_operator
+    pass
 
 
 if gcs_to_bq is not None:
diff --git a/airflow/contrib/example_dags/example_winrm_operator.py b/airflow/contrib/example_dags/example_winrm_operator.py
index 195bf5d98d03c..83e1844ebb042 100644
--- a/airflow/contrib/example_dags/example_winrm_operator.py
+++ b/airflow/contrib/example_dags/example_winrm_operator.py
@@ -31,7 +31,7 @@
 from airflow.models import DAG
 from datetime import timedelta
 
-from airflow.contrib.hooks import WinRMHook
+from airflow.contrib.hooks.winrm_hook import WinRMHook
 from airflow.contrib.operators.winrm_operator import WinRMOperator
 
 
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index a83e577e6aa3a..b616f21c51906 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -25,11 +25,7 @@
 from requests import exceptions as requests_exceptions
 from requests.auth import AuthBase
 from time import sleep
-
-try:
-    from urllib import parse as urlparse
-except ImportError:
-    import urlparse
+from six.moves.urllib import parse as urlparse
 
 RESTART_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/restart")
 START_CLUSTER_ENDPOINT = ("POST", "api/2.0/clusters/start")
diff --git a/airflow/contrib/kubernetes/pod_launcher.py b/airflow/contrib/kubernetes/pod_launcher.py
index f3708813f6c7d..2d46d277b8b8e 100644
--- a/airflow/contrib/kubernetes/pod_launcher.py
+++ b/airflow/contrib/kubernetes/pod_launcher.py
@@ -17,6 +17,7 @@
 
 import json
 import time
+from typing import Tuple, Optional
 from airflow.utils.log.logging_mixin import LoggingMixin
 from airflow.utils.state import State
 from datetime import datetime as dt
@@ -70,7 +71,7 @@ def delete_pod(self, pod):
                 raise
 
     def run_pod(self, pod, startup_timeout=120, get_logs=True):
-        # type: (Pod, int, bool) -> (State, str)
+        # type: (Pod, int, bool) -> Tuple[State, Optional[str]]
         """
         Launches the pod synchronously and waits for completion.
         Args:
@@ -91,7 +92,7 @@ def run_pod(self, pod, startup_timeout=120, get_logs=True):
         return self._monitor_pod(pod, get_logs)
 
     def _monitor_pod(self, pod, get_logs):
-        # type: (Pod, bool) -> (State, str)
+        # type: (Pod, bool) -> Tuple[State, Optional[str]]
 
         if get_logs:
             logs = self._client.read_namespaced_pod_log(
diff --git a/airflow/contrib/operators/adls_list_operator.py b/airflow/contrib/operators/adls_list_operator.py
index 7d03e86b176b1..33c99064aa27b 100644
--- a/airflow/contrib/operators/adls_list_operator.py
+++ b/airflow/contrib/operators/adls_list_operator.py
@@ -17,6 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Iterable
+
 from airflow.contrib.hooks.azure_data_lake_hook import AzureDataLakeHook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
@@ -46,7 +48,7 @@ class AzureDataLakeStorageListOperator(BaseOperator):
                 azure_data_lake_conn_id='azure_data_lake_default'
             )
     """
-    template_fields = ('path',)
+    template_fields = ('path',)  # type: Iterable[str]
     ui_color = '#901dd2'
 
     @apply_defaults
diff --git a/airflow/contrib/operators/azure_container_instances_operator.py b/airflow/contrib/operators/azure_container_instances_operator.py
index 7ec6ca6ab8d5e..2d01e13f65d1b 100644
--- a/airflow/contrib/operators/azure_container_instances_operator.py
+++ b/airflow/contrib/operators/azure_container_instances_operator.py
@@ -17,7 +17,9 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from collections import namedtuple
 from time import sleep
+from typing import Dict, Sequence
 
 from airflow.contrib.hooks.azure_container_instance_hook import AzureContainerInstanceHook
 from airflow.contrib.hooks.azure_container_registry_hook import AzureContainerRegistryHook
@@ -36,8 +38,13 @@
 from msrestazure.azure_exceptions import CloudError
 
 
-DEFAULT_ENVIRONMENT_VARIABLES = {}
-DEFAULT_VOLUMES = []
+Volume = namedtuple(
+    'Volume',
+    ['conn_id', 'account_name', 'share_name', 'mount_path', 'read_only'],
+)
+
+DEFAULT_ENVIRONMENT_VARIABLES = {}  # type: Dict[str, str]
+DEFAULT_VOLUMES = []  # type: Sequence[Volume]
 DEFAULT_MEMORY_IN_GB = 2.0
 DEFAULT_CPU = 1.0
 
@@ -98,7 +105,6 @@ class AzureContainerInstancesOperator(BaseOperator):
     """
 
     template_fields = ('name', 'environment_variables')
-    template_ext = tuple()
 
     @apply_defaults
     def __init__(self, ci_conn_id, registry_conn_id, resource_group, name, image, region,
diff --git a/airflow/contrib/operators/gcp_bigtable_operator.py b/airflow/contrib/operators/gcp_bigtable_operator.py
index 48fd632de024d..d99746798dc28 100644
--- a/airflow/contrib/operators/gcp_bigtable_operator.py
+++ b/airflow/contrib/operators/gcp_bigtable_operator.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Iterable
 import google.api_core.exceptions
 
 from airflow import AirflowException
@@ -33,7 +34,7 @@ class BigtableValidationMixin(object):
     Common class for Cloud Bigtable operators for validating required fields.
     """
 
-    REQUIRED_ATTRIBUTES = []
+    REQUIRED_ATTRIBUTES = []  # type: Iterable[str]
 
     def _validate_inputs(self):
         for attr_name in self.REQUIRED_ATTRIBUTES:
diff --git a/airflow/contrib/operators/gcs_list_operator.py b/airflow/contrib/operators/gcs_list_operator.py
index 7b37b269a6035..056b349394016 100644
--- a/airflow/contrib/operators/gcs_list_operator.py
+++ b/airflow/contrib/operators/gcs_list_operator.py
@@ -17,6 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Iterable
+
 from airflow.contrib.hooks.gcs_hook import GoogleCloudStorageHook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
@@ -58,7 +60,7 @@ class GoogleCloudStorageListOperator(BaseOperator):
                 google_cloud_storage_conn_id=google_cloud_conn_id
             )
     """
-    template_fields = ('bucket', 'prefix', 'delimiter')
+    template_fields = ('bucket', 'prefix', 'delimiter')  # type: Iterable[str]
     ui_color = '#f0eee4'
 
     @apply_defaults
diff --git a/airflow/contrib/operators/jenkins_job_trigger_operator.py b/airflow/contrib/operators/jenkins_job_trigger_operator.py
index 7472a59e431d7..54d11e1a1722e 100644
--- a/airflow/contrib/operators/jenkins_job_trigger_operator.py
+++ b/airflow/contrib/operators/jenkins_job_trigger_operator.py
@@ -27,13 +27,9 @@
 import jenkins
 from jenkins import JenkinsException
 from requests import Request
+import six
 from six.moves.urllib.error import HTTPError, URLError
 
-try:
-    basestring
-except NameError:
-    basestring = str  # For python3 compatibility
-
 
 def jenkins_request_with_headers(jenkins_server, req):
     """
@@ -138,7 +134,7 @@ def build_job(self, jenkins_server):
         """
         # Warning if the parameter is too long, the URL can be longer than
         # the maximum allowed size
-        if self.parameters and isinstance(self.parameters, basestring):
+        if self.parameters and isinstance(self.parameters, six.string_types):
             import ast
             self.parameters = ast.literal_eval(self.parameters)
 
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 73edf1b297c5b..7c6060503697d 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -25,10 +25,6 @@
 from airflow.contrib.kubernetes.volume import Volume  # noqa
 from airflow.contrib.kubernetes.secret import Secret  # noqa
 
-template_fields = ('templates_dict',)
-template_ext = tuple()
-ui_color = '#ffefeb'
-
 
 class KubernetesPodOperator(BaseOperator):
     """
diff --git a/airflow/contrib/operators/qubole_operator.py b/airflow/contrib/operators/qubole_operator.py
index cea9679ad45b8..7da3be7d05792 100755
--- a/airflow/contrib/operators/qubole_operator.py
+++ b/airflow/contrib/operators/qubole_operator.py
@@ -17,6 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Iterable
+
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
 from airflow.contrib.hooks.qubole_hook import QuboleHook
@@ -126,9 +128,9 @@ class QuboleOperator(BaseOperator):
                        'extract_query', 'boundary_query', 'macros', 'name', 'parameters',
                        'dbtap_id', 'hive_table', 'db_table', 'split_column', 'note_id',
                        'db_update_keys', 'export_dir', 'partition_spec', 'qubole_conn_id',
-                       'arguments', 'user_program_arguments', 'cluster_label')
+                       'arguments', 'user_program_arguments', 'cluster_label')  # type: Iterable[str]
 
-    template_ext = ('.txt',)
+    template_ext = ('.txt',)  # type: Iterable[str]
     ui_color = '#3064A1'
     ui_fgcolor = '#fff'
 
diff --git a/airflow/contrib/operators/s3_list_operator.py b/airflow/contrib/operators/s3_list_operator.py
index d5a58d7d10b2f..9b13f0744c3de 100644
--- a/airflow/contrib/operators/s3_list_operator.py
+++ b/airflow/contrib/operators/s3_list_operator.py
@@ -17,6 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Iterable
+
 from airflow.hooks.S3_hook import S3Hook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
@@ -64,7 +66,7 @@ class S3ListOperator(BaseOperator):
                 aws_conn_id='aws_customers_conn'
             )
     """
-    template_fields = ('bucket', 'prefix', 'delimiter')
+    template_fields = ('bucket', 'prefix', 'delimiter')  # type: Iterable[str]
     ui_color = '#ffd700'
 
     @apply_defaults
diff --git a/airflow/contrib/operators/sagemaker_base_operator.py b/airflow/contrib/operators/sagemaker_base_operator.py
index 08d6d0eb6a83c..d6717fd6b41fc 100644
--- a/airflow/contrib/operators/sagemaker_base_operator.py
+++ b/airflow/contrib/operators/sagemaker_base_operator.py
@@ -19,6 +19,8 @@
 
 import json
 
+from typing import Iterable
+
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.models import BaseOperator
 from airflow.utils.decorators import apply_defaults
@@ -38,7 +40,7 @@ class SageMakerBaseOperator(BaseOperator):
     template_ext = ()
     ui_color = '#ededed'
 
-    integer_fields = []
+    integer_fields = []  # type: Iterable[Iterable[str]]
 
     @apply_defaults
     def __init__(self,
diff --git a/airflow/contrib/sensors/python_sensor.py b/airflow/contrib/sensors/python_sensor.py
index 81b7af72130a2..7c4579a891fbb 100644
--- a/airflow/contrib/sensors/python_sensor.py
+++ b/airflow/contrib/sensors/python_sensor.py
@@ -52,7 +52,6 @@ class PythonSensor(BaseSensorOperator):
     """
 
     template_fields = ('templates_dict',)
-    template_ext = tuple()
 
     @apply_defaults
     def __init__(
diff --git a/airflow/contrib/utils/gcp_field_sanitizer.py b/airflow/contrib/utils/gcp_field_sanitizer.py
index 2f5ff6730a8ac..8103e6a7f0644 100644
--- a/airflow/contrib/utils/gcp_field_sanitizer.py
+++ b/airflow/contrib/utils/gcp_field_sanitizer.py
@@ -98,6 +98,8 @@
 components in all elements of the array.
 """
 
+from typing import List
+
 from airflow import LoggingMixin, AirflowException
 
 
@@ -118,7 +120,7 @@ class GcpBodyFieldSanitizer(LoggingMixin):
 
     """
     def __init__(self, sanitize_specs):
-        # type: ([str]) -> None
+        # type: (List[str]) -> None
         super(GcpBodyFieldSanitizer, self).__init__()
         self._sanitize_specs = sanitize_specs
 
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index 71b6c74eaf6b7..25900e4242a76 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -133,8 +133,8 @@
 """
 
 import re
+from typing import Sequence, Dict, Callable
 
-from typing import Callable
 from airflow import LoggingMixin, AirflowException
 
 COMPOSITE_FIELD_TYPES = ['union', 'dict', 'list']
@@ -196,7 +196,7 @@ class GcpBodyFieldValidator(LoggingMixin):
 
     """
     def __init__(self, validation_specs, api_version):
-        # type: ([dict], str) -> None
+        # type: (Sequence[Dict], str) -> None
         super(GcpBodyFieldValidator, self).__init__()
         self._validation_specs = validation_specs
         self._api_version = api_version
diff --git a/airflow/hooks/dbapi_hook.py b/airflow/hooks/dbapi_hook.py
index 7fa69436e6a13..9f09b6ccc477a 100644
--- a/airflow/hooks/dbapi_hook.py
+++ b/airflow/hooks/dbapi_hook.py
@@ -22,6 +22,7 @@
 from datetime import datetime
 from contextlib import closing
 import sys
+from typing import Optional
 
 from sqlalchemy import create_engine
 
@@ -34,7 +35,7 @@ class DbApiHook(BaseHook):
     Abstract base class for sql hooks.
     """
     # Override to provide the connection name.
-    conn_name_attr = None
+    conn_name_attr = None  # type: Optional[str]
     # Override to have a default connection id for a particular dbHook
     default_conn_name = 'default_conn_id'
     # Override if this db supports autocommit.
diff --git a/airflow/jobs.py b/airflow/jobs.py
index 72e802b78458a..80ef3efd3058c 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -32,6 +32,7 @@
 import time
 from collections import defaultdict, OrderedDict
 from time import sleep
+from typing import Any
 
 import six
 from past.builtins import basestring
@@ -63,7 +64,7 @@
 from airflow.utils.sqlalchemy import UtcDateTime
 from airflow.utils.state import State
 
-Base = models.base.Base
+Base = models.base.Base    # type: Any
 ID_LEN = models.base.ID_LEN
 
 
diff --git a/airflow/lineage/datasets.py b/airflow/lineage/datasets.py
index 49dd492bb775a..260277065b6f0 100644
--- a/airflow/lineage/datasets.py
+++ b/airflow/lineage/datasets.py
@@ -18,6 +18,7 @@
 # under the License.
 import six
 
+from typing import List
 from jinja2 import Environment
 
 
@@ -28,7 +29,7 @@ def _inherited(cls):
 
 
 class DataSet(object):
-    attributes = []
+    attributes = []  # type: List[str]
     type_name = "dataSet"
 
     def __init__(self, qualified_name=None, data=None, **kwargs):
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index eb8aa033509a2..98374fe91e640 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -22,10 +22,11 @@
 from __future__ import print_function
 from __future__ import unicode_literals
 
+from builtins import ImportError as BuiltinImportError, bytes, object, str
+from collections import defaultdict, namedtuple, OrderedDict
 import copy
-from collections import namedtuple, defaultdict, OrderedDict
+from typing import Iterable
 
-from builtins import ImportError as BuiltinImportError, bytes, object, str
 from future.standard_library import install_aliases
 
 from airflow.models.base import Base, ID_LEN
@@ -317,6 +318,10 @@ def size(self):
         """
         return len(self.dags)
 
+    @property
+    def dag_ids(self):
+        return self.dags.keys()
+
     def get_dag(self, dag_id):
         """
         Gets the DAG out of the dictionary, and refreshes it if expired
@@ -1059,11 +1064,8 @@ def are_dependents_done(self, session=None):
         count = ti[0][0]
         return count == len(task.downstream_task_ids)
 
-    @property
     @provide_session
-    def previous_ti(self, session=None):
-        """ The task instance for the task that ran before this task instance """
-
+    def _get_previous_ti(self, session=None):
         dag = self.task.dag
         if dag:
             dr = self.get_dagrun(session=session)
@@ -1089,6 +1091,11 @@ def previous_ti(self, session=None):
 
         return None
 
+    @property
+    def previous_ti(self):
+        """The task instance for the task that ran before this task instance."""
+        return self._get_previous_ti()
+
     @provide_session
     def are_dependencies_met(
             self,
@@ -2204,9 +2211,9 @@ class derived from this one results in the creation of a task object,
     """
 
     # For derived classes to define which fields will get jinjaified
-    template_fields = []
+    template_fields = []  # type: Iterable[str]
     # Defines which files extensions to look for in the templated fields
-    template_ext = []
+    template_ext = []  # type: Iterable[str]
     # Defines the color in the UI
     ui_color = '#fff'
     ui_fgcolor = '#000'
@@ -2218,7 +2225,7 @@ class derived from this one results in the creation of a task object,
                                          '_log',)
 
     # each operator should override this class attr for shallow copy attrs.
-    shallow_copy_attrs = ()
+    shallow_copy_attrs = ()  # type: Iterable[str]
 
     @apply_defaults
     def __init__(
@@ -3137,6 +3144,7 @@ def __init__(
             orientation=configuration.conf.get('webserver', 'dag_orientation'),
             catchup=configuration.conf.getboolean('scheduler', 'catchup_by_default'),
             on_success_callback=None, on_failure_callback=None,
+            doc_md=None,
             params=None):
 
         self.user_defined_macros = user_defined_macros
@@ -3212,6 +3220,7 @@ def __init__(
         self.partial = False
         self.on_success_callback = on_success_callback
         self.on_failure_callback = on_failure_callback
+        self.doc_md = doc_md
 
         self._old_context_manager_dags = []
 
@@ -3480,13 +3489,8 @@ def folder(self):
     def owner(self):
         return ", ".join(list(set([t.owner for t in self.tasks])))
 
-    @property
     @provide_session
-    def concurrency_reached(self, session=None):
-        """
-        Returns a boolean indicating whether the concurrency limit for this DAG
-        has been reached
-        """
+    def _get_concurrency_reached(self, session=None):
         TI = TaskInstance
         qry = session.query(func.count(TI.task_id)).filter(
             TI.dag_id == self.dag_id,
@@ -3495,15 +3499,26 @@ def concurrency_reached(self, session=None):
         return qry.scalar() >= self.concurrency
 
     @property
-    @provide_session
-    def is_paused(self, session=None):
+    def concurrency_reached(self):
         """
-        Returns a boolean indicating whether this DAG is paused
+        Returns a boolean indicating whether the concurrency limit for this DAG
+        has been reached
         """
+        return self._get_concurrency_reached()
+
+    @provide_session
+    def _get_is_paused(self, session=None):
         qry = session.query(DagModel).filter(
             DagModel.dag_id == self.dag_id)
         return qry.value('is_paused')
 
+    @property
+    def is_paused(self):
+        """
+        Returns a boolean indicating whether this DAG is paused
+        """
+        return self._get_is_paused()
+
     @provide_session
     def handle_callback(self, dagrun, success=True, reason=None, session=None):
         """
@@ -3585,16 +3600,18 @@ def get_dagrun(self, execution_date, session=None):
 
         return dagrun
 
-    @property
     @provide_session
-    def latest_execution_date(self, session=None):
+    def _get_latest_execution_date(self, session=None):
+        return session.query(func.max(DagRun.execution_date)).filter(
+            DagRun.dag_id == self.dag_id
+        ).scalar()
+
+    @property
+    def latest_execution_date(self):
         """
         Returns the latest date for which at least one dag run exists
         """
-        execution_date = session.query(func.max(DagRun.execution_date)).filter(
-            DagRun.dag_id == self.dag_id
-        ).scalar()
-        return execution_date
+        return self._get_latest_execution_date()
 
     @property
     def subdags(self):
diff --git a/airflow/models/base.py b/airflow/models/base.py
index 3f5eb80154b73..97c6b777984d8 100644
--- a/airflow/models/base.py
+++ b/airflow/models/base.py
@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+from typing import Any
 from sqlalchemy import MetaData
 from sqlalchemy.ext.declarative import declarative_base
 
@@ -24,9 +25,11 @@
 
 SQL_ALCHEMY_SCHEMA = airflow.configuration.get("core", "SQL_ALCHEMY_SCHEMA")
 
-if not SQL_ALCHEMY_SCHEMA or SQL_ALCHEMY_SCHEMA.isspace():
-    Base = declarative_base()
-else:
-    Base = declarative_base(metadata=MetaData(schema=SQL_ALCHEMY_SCHEMA))
+metadata = (
+    None
+    if not SQL_ALCHEMY_SCHEMA or SQL_ALCHEMY_SCHEMA.isspace()
+    else MetaData(schema=SQL_ALCHEMY_SCHEMA)
+)
+Base = declarative_base(metadata=metadata)  # type: Any
 
 ID_LEN = 250
diff --git a/airflow/operators/check_operator.py b/airflow/operators/check_operator.py
index 97e18571fda84..e611ce0af683d 100644
--- a/airflow/operators/check_operator.py
+++ b/airflow/operators/check_operator.py
@@ -19,6 +19,7 @@
 
 from builtins import zip
 from builtins import str
+from typing import Iterable
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
@@ -62,8 +63,8 @@ class CheckOperator(BaseOperator):
     :type sql: str
     """
 
-    template_fields = ('sql',)
-    template_ext = ('.hql', '.sql',)
+    template_fields = ('sql',)  # type: Iterable[str]
+    template_ext = ('.hql', '.sql',)  # type: Iterable[str]
     ui_color = '#fff7e6'
 
     @apply_defaults
@@ -120,8 +121,8 @@ class ValueCheckOperator(BaseOperator):
     __mapper_args__ = {
         'polymorphic_identity': 'ValueCheckOperator'
     }
-    template_fields = ('sql', 'pass_value',)
-    template_ext = ('.hql', '.sql',)
+    template_fields = ('sql', 'pass_value',)  # type: Iterable[str]
+    template_ext = ('.hql', '.sql',)  # type: Iterable[str]
     ui_color = '#fff7e6'
 
     @apply_defaults
@@ -196,8 +197,8 @@ class IntervalCheckOperator(BaseOperator):
     __mapper_args__ = {
         'polymorphic_identity': 'IntervalCheckOperator'
     }
-    template_fields = ('sql1', 'sql2')
-    template_ext = ('.hql', '.sql',)
+    template_fields = ('sql1', 'sql2')  # type: Iterable[str]
+    template_ext = ('.hql', '.sql',)  # type: Iterable[str]
     ui_color = '#fff7e6'
 
     @apply_defaults
diff --git a/airflow/operators/dagrun_operator.py b/airflow/operators/dagrun_operator.py
index 7000c6c90bc18..1bc1979a1afb4 100644
--- a/airflow/operators/dagrun_operator.py
+++ b/airflow/operators/dagrun_operator.py
@@ -53,7 +53,6 @@ class TriggerDagRunOperator(BaseOperator):
     :type execution_date: str or datetime.datetime
     """
     template_fields = ('trigger_dag_id', 'execution_date')
-    template_ext = tuple()
     ui_color = '#ffefeb'
 
     @apply_defaults
diff --git a/airflow/operators/dummy_operator.py b/airflow/operators/dummy_operator.py
index 025a242fd1b94..222c853b1d1fb 100644
--- a/airflow/operators/dummy_operator.py
+++ b/airflow/operators/dummy_operator.py
@@ -27,7 +27,6 @@ class DummyOperator(BaseOperator):
     DAG.
     """
 
-    template_fields = tuple()
     ui_color = '#e8f7e4'
 
     @apply_defaults
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index c2ab3a639bf21..ccdc9ceea0b3e 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -67,7 +67,6 @@ class PythonOperator(BaseOperator):
     :type templates_exts: list[str]
     """
     template_fields = ('templates_dict', 'op_args', 'op_kwargs')
-    template_ext = tuple()
     ui_color = '#ffefeb'
 
     # since we won't mutate the arguments, we should just do the shallow copy
diff --git a/airflow/operators/subdag_operator.py b/airflow/operators/subdag_operator.py
index bdee51548d874..812f486e16428 100644
--- a/airflow/operators/subdag_operator.py
+++ b/airflow/operators/subdag_operator.py
@@ -38,7 +38,6 @@ class SubDagOperator(BaseOperator):
     :type executor: airflow.executors.base_executor.BaseExecutor
     """
 
-    template_fields = tuple()
     ui_color = '#555'
     ui_fgcolor = '#fff'
 
diff --git a/airflow/plugins_manager.py b/airflow/plugins_manager.py
index 531dab7d6c1b6..4277b33432077 100644
--- a/airflow/plugins_manager.py
+++ b/airflow/plugins_manager.py
@@ -28,6 +28,7 @@
 import os
 import re
 import pkg_resources
+from typing import List, Any
 
 from airflow import settings
 from airflow.utils.log.logging_mixin import LoggingMixin
@@ -42,17 +43,17 @@ class AirflowPluginException(Exception):
 
 
 class AirflowPlugin(object):
-    name = None
-    operators = []
-    sensors = []
-    hooks = []
-    executors = []
-    macros = []
-    admin_views = []
-    flask_blueprints = []
-    menu_links = []
-    appbuilder_views = []
-    appbuilder_menu_items = []
+    name = None  # type: str
+    operators = []  # type: List[Any]
+    sensors = []  # type: List[Any]
+    hooks = []  # type: List[Any]
+    executors = []  # type: List[Any]
+    macros = []  # type: List[Any]
+    admin_views = []  # type: List[Any]
+    flask_blueprints = []  # type: List[Any]
+    menu_links = []  # type: List[Any]
+    appbuilder_views = []  # type: List[Any]
+    appbuilder_menu_items = []  # type: List[Any]
 
     @classmethod
     def validate(cls):
@@ -113,7 +114,7 @@ def is_valid_plugin(plugin_obj, existing_plugins):
     return False
 
 
-plugins = []
+plugins = []  # type: List[AirflowPlugin]
 
 norm_pattern = re.compile(r'[/|.]')
 
@@ -167,11 +168,11 @@ def make_module(name, objects):
 macros_modules = []
 
 # Plugin components to integrate directly
-admin_views = []
-flask_blueprints = []
-menu_links = []
-flask_appbuilder_views = []
-flask_appbuilder_menu_links = []
+admin_views = []  # type: List[Any]
+flask_blueprints = []  # type: List[Any]
+menu_links = []  # type: List[Any]
+flask_appbuilder_views = []  # type: List[Any]
+flask_appbuilder_menu_links = []  # type: List[Any]
 
 for p in plugins:
     operators_modules.append(
diff --git a/airflow/sensors/sql_sensor.py b/airflow/sensors/sql_sensor.py
index 9a1b11fc50b1a..ba4e6bb03d426 100644
--- a/airflow/sensors/sql_sensor.py
+++ b/airflow/sensors/sql_sensor.py
@@ -18,6 +18,7 @@
 # under the License.
 
 from builtins import str
+from typing import Iterable
 
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
@@ -38,8 +39,8 @@ class SqlSensor(BaseSensorOperator):
     :param parameters: The parameters to render the SQL query with (optional).
     :type parameters: mapping or iterable
     """
-    template_fields = ('sql',)
-    template_ext = ('.hql', '.sql',)
+    template_fields = ('sql',)  # type: Iterable[str]
+    template_ext = ('.hql', '.sql',)  # type: Iterable[str]
     ui_color = '#7c7287'
 
     @apply_defaults
diff --git a/airflow/settings.py b/airflow/settings.py
index b7ccf6a033d5e..fcf54a869aeb0 100644
--- a/airflow/settings.py
+++ b/airflow/settings.py
@@ -27,6 +27,7 @@
 import os
 import pendulum
 import sys
+from typing import Any
 
 from sqlalchemy import create_engine, exc
 from sqlalchemy.orm import scoped_session, sessionmaker
@@ -70,7 +71,7 @@ def timing(cls, stat, dt):
         pass
 
 
-Stats = DummyStatsLogger
+Stats = DummyStatsLogger  # type: Any
 
 if conf.getboolean('scheduler', 'statsd_on'):
     from statsd import StatsClient
diff --git a/airflow/utils/cli_action_loggers.py b/airflow/utils/cli_action_loggers.py
index 2a0de06d663aa..1c96e5f55c89e 100644
--- a/airflow/utils/cli_action_loggers.py
+++ b/airflow/utils/cli_action_loggers.py
@@ -24,6 +24,7 @@
 from __future__ import absolute_import
 
 import logging
+from typing import List, Callable
 
 from airflow.utils.db import create_session
 
@@ -98,8 +99,8 @@ def default_action_log(log, **_):
         session.add(log)
 
 
-__pre_exec_callbacks = []
-__post_exec_callbacks = []
+__pre_exec_callbacks = []  # type: List[Callable]
+__post_exec_callbacks = []  # type: List[Callable]
 
 # By default, register default action log into pre-execution callback
 register_pre_exec_callback(default_action_log)
diff --git a/airflow/utils/dag_processing.py b/airflow/utils/dag_processing.py
index 4a5a3f629d415..b2055a5d7f6fc 100644
--- a/airflow/utils/dag_processing.py
+++ b/airflow/utils/dag_processing.py
@@ -35,6 +35,7 @@
 from collections import namedtuple
 from datetime import timedelta
 from importlib import import_module
+import enum
 
 import psutil
 from six.moves import range, reload_module
@@ -436,10 +437,11 @@ def file_path(self):
                              'all_files_processed', 'result_count'])
 
 
-DagParsingSignal = namedtuple(
-    'DagParsingSignal',
-    ['AGENT_HEARTBEAT', 'MANAGER_DONE', 'TERMINATE_MANAGER', 'END_MANAGER'])(
-    'agent_heartbeat', 'manager_done', 'terminate_manager', 'end_manager')
+class DagParsingSignal(enum.Enum):
+    AGENT_HEARTBEAT = 'agent_heartbeat'
+    MANAGER_DONE = 'manager_done'
+    TERMINATE_MANAGER = 'terminate_manager'
+    END_MANAGER = 'end_manager'
 
 
 class DagFileProcessorAgent(LoggingMixin):
diff --git a/airflow/utils/trigger_rule.py b/airflow/utils/trigger_rule.py
index 4f7db65f7bae5..81fad6b7bfe76 100644
--- a/airflow/utils/trigger_rule.py
+++ b/airflow/utils/trigger_rule.py
@@ -20,6 +20,7 @@
 from __future__ import unicode_literals
 
 from builtins import object
+from typing import Set
 
 
 class TriggerRule(object):
@@ -31,7 +32,7 @@ class TriggerRule(object):
     DUMMY = 'dummy'
     NONE_FAILED = 'none_failed'
 
-    _ALL_TRIGGER_RULES = {}
+    _ALL_TRIGGER_RULES = set()  # type: Set[str]
 
     @classmethod
     def is_valid(cls, trigger_rule):
diff --git a/airflow/utils/weight_rule.py b/airflow/utils/weight_rule.py
index f34856be8311e..f7f85c0734ac6 100644
--- a/airflow/utils/weight_rule.py
+++ b/airflow/utils/weight_rule.py
@@ -20,6 +20,7 @@
 from __future__ import unicode_literals
 
 from builtins import object
+from typing import Set
 
 
 class WeightRule(object):
@@ -27,7 +28,7 @@ class WeightRule(object):
     UPSTREAM = 'upstream'
     ABSOLUTE = 'absolute'
 
-    _ALL_WEIGHT_RULES = {}
+    _ALL_WEIGHT_RULES = set()  # type: Set[str]
 
     @classmethod
     def is_valid(cls, weight_rule):
diff --git a/airflow/www/app.py b/airflow/www/app.py
index 8121585f6472c..1fce12bc4e7a9 100644
--- a/airflow/www/app.py
+++ b/airflow/www/app.py
@@ -17,8 +17,9 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-import six
+from typing import Any
 
+import six
 from flask import Flask
 from flask_admin import Admin, base
 from flask_caching import Cache
@@ -173,7 +174,7 @@ def shutdown_session(exception=None):
         return app
 
 
-app = None
+app = None  # type: Any
 
 
 def root_app(env, resp):
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 405903f2c4499..9ad86347c7a4d 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -2408,7 +2408,7 @@ def on_model_change(self, form, model, is_created=True):
         model.last_modified = timezone.utcnow()
 
 
-chart_mapping = (
+chart_mapping = dict((
     ('line', 'lineChart'),
     ('spline', 'lineChart'),
     ('bar', 'multiBarChart'),
@@ -2417,8 +2417,7 @@ def on_model_change(self, form, model, is_created=True):
     ('stacked_area', 'stackedAreaChart'),
     ('percent_area', 'stackedAreaChart'),
     ('datatable', 'datatable'),
-)
-chart_mapping = dict(chart_mapping)
+))
 
 
 class KnownEventView(wwwutils.DataProfilingMixin, AirflowModelView):
diff --git a/airflow/www_rbac/app.py b/airflow/www_rbac/app.py
index 44adc03a56e77..2af868682920d 100644
--- a/airflow/www_rbac/app.py
+++ b/airflow/www_rbac/app.py
@@ -19,8 +19,9 @@
 #
 import logging
 import socket
-import six
+from typing import Any
 
+import six
 from flask import Flask
 from flask_appbuilder import AppBuilder, SQLA
 from flask_caching import Cache
@@ -34,7 +35,7 @@
 from airflow.logging_config import configure_logging
 from airflow.www_rbac.static_config import configure_manifest_files
 
-app = None
+app = None  # type: Any
 appbuilder = None
 csrf = CSRFProtect()
 
diff --git a/airflow/www_rbac/static_config.py b/airflow/www_rbac/static_config.py
index 53b357c7b5da2..7b5560c193d57 100644
--- a/airflow/www_rbac/static_config.py
+++ b/airflow/www_rbac/static_config.py
@@ -18,12 +18,13 @@
 # under the License.
 from __future__ import print_function
 
-import json
 import os
+import json
+from typing import Dict
 
 from flask import url_for
 
-manifest = dict()
+manifest = dict()  # type: Dict[str, str]
 
 
 def configure_manifest_files(app):
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 900bc349da73f..ad6042ce348c6 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -79,7 +79,7 @@
 if os.environ.get('SKIP_DAGS_PARSING') != 'True':
     dagbag = models.DagBag(settings.DAGS_FOLDER)
 else:
-    dagbag = models.DagBag
+    dagbag = models.DagBag(os.devnull, include_examples=False)
 
 
 def get_date_time_num_runs_dag_runs_form_data(request, session, dag):
diff --git a/setup.cfg b/setup.cfg
index f29267e269727..35785162aaf45 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -35,3 +35,15 @@ all_files = 1
 upload-dir = docs/_build/html
 
 [easy_install]
+
+[mypy]
+ignore_missing_imports = True
+
+[mypy-airflow.migrations.*]
+ignore_errors = True
+
+[mypy-airflow._vendor.*]
+ignore_errors = True
+
+[mypy-airflow.contrib.auth.*]
+ignore_errors = True
diff --git a/setup.py b/setup.py
index b4d20c6bbb9d1..159f478eb6e09 100644
--- a/setup.py
+++ b/setup.py
@@ -251,7 +251,6 @@ def write_version(filename=os.path.join(*['airflow',
     'rednose',
     'requests_mock',
     'flake8>=3.6.0',
-    'typing',
 ]
 devel_minreq = devel + kubernetes + mysql + doc + password + s3 + cgroups
 devel_hadoop = devel_minreq + hive + hdfs + webhdfs + kerberos
@@ -318,6 +317,7 @@ def do_setup():
             'tabulate>=0.7.5, <0.9',
             'tenacity==4.12.0',
             'text-unidecode==1.2',
+            'typing;python_version<"3.5"',
             'thrift>=0.9.2',
             'tzlocal>=1.4',
             'unicodecsv>=0.14.1',

From 230e786e86c4cee5756e426bfc1e9abd2b8eb8c0 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Wed, 5 Sep 2018 21:52:12 +0200
Subject: [PATCH 748/808] [AIRFLOW-3003] Pull the krb5 image instead of
 building (#3844)

Pull the image instead of building it, this will speed up the CI
process since we don't have to build it every time.
---
 scripts/ci/2-setup-kdc.sh                     |  2 +-
 scripts/ci/docker-compose.yml                 |  3 +-
 scripts/ci/krb5/Dockerfile                    | 52 -------------------
 scripts/ci/krb5/krb-conf/server/kadm5.acl     | 18 -------
 scripts/ci/krb5/krb-conf/server/kdc.conf      | 30 -----------
 .../ci/krb5/{krb-conf/client => }/krb5.conf   |  8 +--
 scripts/ci/krb5/start_kdc.sh                  | 41 ---------------
 scripts/ci/krb5/supervisord.conf              | 43 ---------------
 8 files changed, 6 insertions(+), 191 deletions(-)
 delete mode 100644 scripts/ci/krb5/Dockerfile
 delete mode 100644 scripts/ci/krb5/krb-conf/server/kadm5.acl
 delete mode 100644 scripts/ci/krb5/krb-conf/server/kdc.conf
 rename scripts/ci/krb5/{krb-conf/client => }/krb5.conf (92%)
 delete mode 100755 scripts/ci/krb5/start_kdc.sh
 delete mode 100644 scripts/ci/krb5/supervisord.conf

diff --git a/scripts/ci/2-setup-kdc.sh b/scripts/ci/2-setup-kdc.sh
index 56824f5a5ee3f..c5cd381c2f626 100755
--- a/scripts/ci/2-setup-kdc.sh
+++ b/scripts/ci/2-setup-kdc.sh
@@ -30,7 +30,7 @@ KRB5_KTNAME=/etc/airflow.keytab
 cat /etc/hosts
 echo "hostname: ${FQDN}"
 
-sudo cp $DIRNAME/krb5/krb-conf/client/krb5.conf /etc/krb5.conf
+sudo cp $DIRNAME/krb5/krb5.conf /etc/krb5.conf
 
 echo -e "${PASS}\n${PASS}" | sudo kadmin -p ${ADMIN}/admin -w ${PASS} -q "addprinc -randkey airflow/${FQDN}"
 sudo kadmin -p ${ADMIN}/admin -w ${PASS} -q "ktadd -k ${KRB5_KTNAME} airflow"
diff --git a/scripts/ci/docker-compose.yml b/scripts/ci/docker-compose.yml
index 37a556b75b1e7..1c44f7a74b0dd 100644
--- a/scripts/ci/docker-compose.yml
+++ b/scripts/ci/docker-compose.yml
@@ -61,8 +61,7 @@ services:
       - ./openldap/ldif:/container/service/slapd/assets/config/bootstrap/ldif/custom
 
   krb5-kdc-server:
-    build: ./krb5
-    image: krb5-kdc-server
+    image: godatadriven/krb5-kdc-server
     hostname: krb5-kdc-server
     domainname: example.com
 
diff --git a/scripts/ci/krb5/Dockerfile b/scripts/ci/krb5/Dockerfile
deleted file mode 100644
index cdb4cf979e05d..0000000000000
--- a/scripts/ci/krb5/Dockerfile
+++ /dev/null
@@ -1,52 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-FROM ubuntu:xenial
-
-# environment variables
-ENV DEBIAN_FRONTEND noninteractive
-
-# Kerberos server
-RUN apt-get update && apt-get install --no-install-recommends -y \
-    ntp \
-    python-dev \
-    python-pip \
-    python-wheel \
-    python-setuptools \
-    python-pkg-resources \
-    krb5-admin-server \
-    krb5-kdc
-
-RUN mkdir /app/
-
-# Supervisord
-RUN pip install supervisor==3.3.4
-RUN mkdir -p /var/log/supervisord/
-
-COPY ./krb-conf/server/kdc.conf /etc/krb5kdc/kdc.conf
-COPY ./krb-conf/server/kadm5.acl /etc/krb5kdc/kadm5.acl
-COPY ./krb-conf/client/krb5.conf /etc/krb5.conf
-COPY ./start_kdc.sh /app/start_kdc.sh
-
-# supervisord
-COPY ./supervisord.conf /etc/supervisord.conf
-
-WORKDIR /app
-
-# when container is starting
-CMD ["/bin/bash", "/app/start_kdc.sh"]
diff --git a/scripts/ci/krb5/krb-conf/server/kadm5.acl b/scripts/ci/krb5/krb-conf/server/kadm5.acl
deleted file mode 100644
index 41d17385ff144..0000000000000
--- a/scripts/ci/krb5/krb-conf/server/kadm5.acl
+++ /dev/null
@@ -1,18 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-*/admin@TEST.LOCAL    *
diff --git a/scripts/ci/krb5/krb-conf/server/kdc.conf b/scripts/ci/krb5/krb-conf/server/kdc.conf
deleted file mode 100644
index c21095f418d4a..0000000000000
--- a/scripts/ci/krb5/krb-conf/server/kdc.conf
+++ /dev/null
@@ -1,30 +0,0 @@
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-[kdcdefaults]
-kdc_ports = 88
-kdc_tcp_ports = 88
-
-[realms]
-TEST.LOCAL = {
-  #master_key_type = aes256-cts
-  acl_file = /etc/krb5kdc/kadm5.acl
-  dict_file = /usr/share/dict/words
-  admin_keytab = /var/krb5kdc/kadm5.keytab
-  max_renewable_life = 7d 0h 0m 0s
-  supported_enctypes = aes256-cts:normal aes128-cts:normal des3-hmac-sha1:normal arcfour-hmac:normal des-hmac-sha1:normal des-cbc-md5:normal des-cbc-crc:normal
-}
diff --git a/scripts/ci/krb5/krb-conf/client/krb5.conf b/scripts/ci/krb5/krb5.conf
similarity index 92%
rename from scripts/ci/krb5/krb-conf/client/krb5.conf
rename to scripts/ci/krb5/krb5.conf
index 471737a964123..77c78d686e39e 100644
--- a/scripts/ci/krb5/krb-conf/client/krb5.conf
+++ b/scripts/ci/krb5/krb5.conf
@@ -30,7 +30,7 @@ renew_lifetime = 7d
 forwardable = true
 
 [realms]
- TEST.LOCAL = {
-   kdc = krb5-kdc-server:88
-   admin_server = krb5-kdc-server
- }
+TEST.LOCAL = {
+  kdc = krb5-kdc-server:88
+  admin_server = krb5-kdc-server
+}
diff --git a/scripts/ci/krb5/start_kdc.sh b/scripts/ci/krb5/start_kdc.sh
deleted file mode 100755
index 6e02f006fa830..0000000000000
--- a/scripts/ci/krb5/start_kdc.sh
+++ /dev/null
@@ -1,41 +0,0 @@
-#!/usr/bin/env bash
-
-#
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-set -exuo pipefail
-
-FQDN=`hostname`
-ADMIN="admin"
-PASS="airflow"
-KRB5_KTNAME=/etc/airflow.keytab
-
-cat /etc/hosts
-echo "hostname: ${FQDN}"
-# create kerberos database
-echo -e "${PASS}\n${PASS}" | kdb5_util create -s
-# create admin
-echo -e "${PASS}\n${PASS}" | kadmin.local -q "addprinc ${ADMIN}/admin"
-# create airflow
-echo -e "${PASS}\n${PASS}" | kadmin.local -q "addprinc -randkey airflow"
-echo -e "${PASS}\n${PASS}" | kadmin.local -q "addprinc -randkey airflow/${FQDN}"
-kadmin.local -q "ktadd -k ${KRB5_KTNAME} airflow"
-kadmin.local -q "ktadd -k ${KRB5_KTNAME} airflow/${FQDN}"
-
-# Start services
-/usr/local/bin/supervisord -n -c /etc/supervisord.conf
diff --git a/scripts/ci/krb5/supervisord.conf b/scripts/ci/krb5/supervisord.conf
deleted file mode 100644
index 165e5cde84646..0000000000000
--- a/scripts/ci/krb5/supervisord.conf
+++ /dev/null
@@ -1,43 +0,0 @@
-;
-; Licensed to the Apache Software Foundation (ASF) under one
-; or more contributor license agreements.  See the NOTICE file
-; distributed with this work for additional information
-; regarding copyright ownership.  The ASF licenses this file
-; to you under the Apache License, Version 2.0 (the
-; "License"); you may not use this file except in compliance
-; with the License.  You may obtain a copy of the License at
-;
-;   http://www.apache.org/licenses/LICENSE-2.0
-;
-; Unless required by applicable law or agreed to in writing,
-; software distributed under the License is distributed on an
-; "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-; KIND, either express or implied.  See the License for the
-; specific language governing permissions and limitations
-; under the License.
-
-; supervisord.conf - kdc-server
-
-[supervisord]
-logfile=/var/log/supervisord/supervisord.log    ; supervisord log file
-logfile_maxbytes=50MB                           ; maximum size of logfile before rotation
-logfile_backups=10                              ; number of backed up logfiles
-loglevel=error                                  ; info, debug, warn, trace
-pidfile=/var/run/supervisord.pid                ; pidfile location
-nodaemon=false                                  ; run supervisord as a daemon
-minfds=1024                                     ; number of startup file descriptors
-minprocs=200                                    ; number of process descriptors
-user=root                                       ; default user
-childlogdir=/var/log/supervisord/               ; where child log files will live
-
-[program:krb5-kdc]
-command=service krb5-kdc start
-autostart=true
-autorestart=true
-
-[program:krb5-admin-server]
-command=service krb5-admin-server start
-autostart=true
-autorestart=true
-
-[supervisorctl]

From 0f3c8b764673888e3015b4f020949ff7fb87be58 Mon Sep 17 00:00:00 2001
From: dbatten5 <db@mettrr.com>
Date: Wed, 27 Mar 2019 13:50:01 +0000
Subject: [PATCH 749/808] [AIRFLOW-XXX] Mention Oracle in the Extra Packages
 documentation (#4987)

Add the `oracle` subpackage to the list of available subpackages
---
 docs/installation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/installation.rst b/docs/installation.rst
index 4a8a9322d7231..6c2695e94167f 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -97,6 +97,8 @@ Here's the list of the subpackages and what they enable:
 |                     |                                                     | example, ``mysqlclient`` 1.3.12 can only be                          |
 |                     |                                                     | used with MySQL server 5.6.4 through 5.7.                            |
 +---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
+| oracle              | ``pip install 'apache-airflow[oracle]'``            | Oracle hooks and operators                                           |
++---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
 | password            | ``pip install 'apache-airflow[password]'``          | Password authentication for users                                    |
 +---------------------+-----------------------------------------------------+----------------------------------------------------------------------+
 | postgres            | ``pip install 'apache-airflow[postgres]'``          | PostgreSQL operators and hook, support as an                         |

From 0748455ae7c0e15217b94e061e84bbf22d8d71f5 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Wed, 27 Mar 2019 21:53:45 +0800
Subject: [PATCH 750/808] [AIRFLOW-XXX] Fix flaky test -
 test_execution_unlimited_parallelism (#4988)

---
 tests/executors/test_local_executor.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/executors/test_local_executor.py b/tests/executors/test_local_executor.py
index 2a29ee2cd5c49..49939d702ecc1 100644
--- a/tests/executors/test_local_executor.py
+++ b/tests/executors/test_local_executor.py
@@ -50,7 +50,7 @@ def execution_parallelism(self, parallelism=0):
         executor.running['fail'] = True
 
         if parallelism == 0:
-            with timeout(seconds=5):
+            with timeout(seconds=10):
                 executor.end()
         else:
             executor.end()

From 522c4c17db79a0a125f95ee1df60eb4a2d067532 Mon Sep 17 00:00:00 2001
From: Anatoli Babenia <anatoli@rainforce.org>
Date: Fri, 25 Jan 2019 16:50:41 +0300
Subject: [PATCH 751/808] [AIRFLOW-XXX] Automatically link Jira/GH on doc's
 changelog page (#4587)

---
 docs/_templates/layout.html | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 docs/_templates/layout.html

diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
new file mode 100644
index 0000000000000..15822dc18d039
--- /dev/null
+++ b/docs/_templates/layout.html
@@ -0,0 +1,30 @@
+<!--
+Javascript to render AIRFLOW-XXX and PR references in text
+as HTML links.
+
+Overrides extrahead block from sphinx_rtd_theme
+https://www.sphinx-doc.org/en/master/templating.html
+-->
+
+{% extends "!layout.html" %}
+
+{% block extrahead %}
+  {{ super() }}
+  <script>
+    document.addEventListener('DOMContentLoaded', function() {
+      var el = document.getElementById('changelog');
+      if (el !== null ) {
+        // [AIRFLOW-...]
+        el.innerHTML = el.innerHTML.replace(
+            /\[(AIRFLOW-[\d]+)\]/g,
+            `<a href="https://issues.apache.org/jira/browse/$1">[$1]</a>`
+        );
+        // (#...)
+        el.innerHTML = el.innerHTML.replace(
+            /\(#([\d]+)\)/g,
+            `<a href="https://github.com/apache/airflow/pull/$1">(#$1)</a>`
+        );
+      };
+    })
+  </script>
+{% endblock %}

From f60d0f4e3fe12d7f9a9fc094cf2e416cc684348e Mon Sep 17 00:00:00 2001
From: Ryan Yuan <ryan.yuan@outlook.com>
Date: Sat, 26 Jan 2019 08:18:01 +1100
Subject: [PATCH 752/808] [AIRFLOW-3490] Add BigQueryHook's Ability to Patch
 Table/View (#4299)

---
 airflow/contrib/hooks/bigquery_hook.py    | 110 ++++++++++++++++++++++
 tests/contrib/hooks/test_bigquery_hook.py |  76 +++++++++++++++
 2 files changed, 186 insertions(+)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index 081feae0be9bf..c33a30462deed 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -502,6 +502,116 @@ def create_external_table(self,
                 'BigQuery job failed. Error was: {}'.format(err.content)
             )
 
+    def patch_table(self,
+                    dataset_id,
+                    table_id,
+                    project_id=None,
+                    description=None,
+                    expiration_time=None,
+                    external_data_configuration=None,
+                    friendly_name=None,
+                    labels=None,
+                    schema=None,
+                    time_partitioning=None,
+                    view=None,
+                    require_partition_filter=None):
+        """
+        Patch information in an existing table.
+        It only updates fileds that are provided in the request object.
+
+        Reference: https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/patch
+
+        :param dataset_id: The dataset containing the table to be patched.
+        :type dataset_id: str
+        :param table_id: The Name of the table to be patched.
+        :type table_id: str
+        :param project_id: The project containing the table to be patched.
+        :type project_id: str
+        :param description: [Optional] A user-friendly description of this table.
+        :type description: str
+        :param expiration_time: [Optional] The time when this table expires,
+            in milliseconds since the epoch.
+        :type expiration_time: int
+        :param external_data_configuration: [Optional] A dictionary containing
+            properties of a table stored outside of BigQuery.
+        :type external_data_configuration: dict
+        :param friendly_name: [Optional] A descriptive name for this table.
+        :type friendly_name: str
+        :param labels: [Optional] A dictionary containing labels associated with this table.
+        :type labels: dict
+        :param schema: [Optional] If set, the schema field list as defined here:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
+            The supported schema modifications and unsupported schema modification are listed here:
+            https://cloud.google.com/bigquery/docs/managing-table-schemas
+        :type schema: list
+
+        **Example**: ::
+
+            schema=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
+                           {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}]
+
+        :param time_partitioning: [Optional] A dictionary containing time-based partitioning
+             definition for the table.
+        :type time_partitioning: dict
+        :param view: [Optional] A dictionary containing definition for the view.
+            If set, it will patch a view instead of a table:
+            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#view
+        :type view: dict
+
+        **Example**: ::
+
+            view = {
+                "query": "SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*` LIMIT 500",
+                "useLegacySql": False
+            }
+
+        :param require_partition_filter: [Optional] If true, queries over the this table require a
+            partition filter. If false, queries over the table
+        :type require_partition_filter: bool
+
+        """
+
+        project_id = project_id if project_id is not None else self.project_id
+
+        table_resource = {}
+
+        if description is not None:
+            table_resource['description'] = description
+        if expiration_time is not None:
+            table_resource['expirationTime'] = expiration_time
+        if external_data_configuration:
+            table_resource['externalDataConfiguration'] = external_data_configuration
+        if friendly_name is not None:
+            table_resource['friendlyName'] = friendly_name
+        if labels:
+            table_resource['labels'] = labels
+        if schema:
+            table_resource['schema'] = {'fields': schema}
+        if time_partitioning:
+            table_resource['timePartitioning'] = time_partitioning
+        if view:
+            table_resource['view'] = view
+        if require_partition_filter is not None:
+            table_resource['requirePartitionFilter'] = require_partition_filter
+
+        self.log.info('Patching Table %s:%s.%s',
+                      project_id, dataset_id, table_id)
+
+        try:
+            self.service.tables().patch(
+                projectId=project_id,
+                datasetId=dataset_id,
+                tableId=table_id,
+                body=table_resource).execute()
+
+            self.log.info('Table patched successfully: %s:%s.%s',
+                          project_id, dataset_id, table_id)
+
+        except HttpError as err:
+            raise AirflowException(
+                'BigQuery job failed. Error was: {}'.format(err.content)
+            )
+
     def run_query(self,
                   bql=None,
                   sql=None,
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index f8f5c45c0f6ca..eb548607173c5 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -424,6 +424,82 @@ def test_create_view(self):
         }
         method.assert_called_once_with(projectId=project_id, datasetId=dataset_id, body=body)
 
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_patch_table(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        table_id = 'bq_table'
+
+        description_patched = 'Test description.'
+        expiration_time_patched = 2524608000000
+        friendly_name_patched = 'Test friendly name.'
+        labels_patched = {'label1': 'test1', 'label2': 'test2'}
+        schema_patched = [
+            {'name': 'id', 'type': 'STRING', 'mode': 'REQUIRED'},
+            {'name': 'name', 'type': 'STRING', 'mode': 'NULLABLE'},
+            {'name': 'balance', 'type': 'FLOAT', 'mode': 'NULLABLE'},
+            {'name': 'new_field', 'type': 'STRING', 'mode': 'NULLABLE'}
+        ]
+        time_partitioning_patched = {
+            'expirationMs': 10000000
+        }
+        require_partition_filter_patched = True
+
+        mock_service = mock.Mock()
+        method = (mock_service.tables.return_value.patch)
+        cursor = hook.BigQueryBaseCursor(mock_service, project_id)
+        cursor.patch_table(
+            dataset_id, table_id, project_id,
+            description=description_patched,
+            expiration_time=expiration_time_patched,
+            friendly_name=friendly_name_patched,
+            labels=labels_patched, schema=schema_patched,
+            time_partitioning=time_partitioning_patched,
+            require_partition_filter=require_partition_filter_patched
+        )
+
+        body = {
+            "description": description_patched,
+            "expirationTime": expiration_time_patched,
+            "friendlyName": friendly_name_patched,
+            "labels": labels_patched,
+            "schema": {
+                "fields": schema_patched
+            },
+            "timePartitioning": time_partitioning_patched,
+            "requirePartitionFilter": require_partition_filter_patched
+        }
+        method.assert_called_once_with(
+            projectId=project_id,
+            datasetId=dataset_id,
+            tableId=table_id,
+            body=body
+        )
+
+    @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
+    def test_patch_view(self, run_with_config):
+        project_id = 'bq-project'
+        dataset_id = 'bq_dataset'
+        view_id = 'bq_view'
+        view_patched = {
+            'query': "SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*` LIMIT 500",
+            'useLegacySql': False
+        }
+
+        mock_service = mock.Mock()
+        method = (mock_service.tables.return_value.patch)
+        cursor = hook.BigQueryBaseCursor(mock_service, project_id)
+        cursor.patch_table(dataset_id, view_id, project_id, view=view_patched)
+        body = {
+            'view': view_patched
+        }
+        method.assert_called_once_with(
+            projectId=project_id,
+            datasetId=dataset_id,
+            tableId=view_id,
+            body=body
+        )
+
 
 class TestBigQueryCursor(unittest.TestCase):
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')

From e354649e53889cbe445cc9453986066d206ca07d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Mon, 11 Feb 2019 11:50:33 +0100
Subject: [PATCH 753/808] [AIRFLOW-XXX] Docs rendering improvement (#4684)

---
 airflow/contrib/hooks/bigquery_hook.py        | 44 +++++++++----------
 airflow/contrib/hooks/databricks_hook.py      | 19 ++++----
 airflow/contrib/hooks/spark_submit_hook.py    | 27 ++++++++----
 .../contrib/operators/dataflow_operator.py    |  2 +-
 .../mlengine_operator_utils.py                |  2 +-
 .../mlengine_prediction_summary.py            |  0
 airflow/executors/celery_executor.py          | 12 ++---
 .../test_mlengine_operator_utils.py           | 21 ++++-----
 8 files changed, 70 insertions(+), 57 deletions(-)
 rename airflow/contrib/{operators => utils}/mlengine_operator_utils.py (99%)
 rename airflow/contrib/{operators => utils}/mlengine_prediction_summary.py (100%)
 rename tests/contrib/{operators => utils}/test_mlengine_operator_utils.py (88%)

diff --git a/airflow/contrib/hooks/bigquery_hook.py b/airflow/contrib/hooks/bigquery_hook.py
index c33a30462deed..5744e3b1756a4 100644
--- a/airflow/contrib/hooks/bigquery_hook.py
+++ b/airflow/contrib/hooks/bigquery_hook.py
@@ -252,7 +252,7 @@ def create_empty_table(self,
             partition by field, type and expiration as per API specifications.
 
             .. seealso::
-            https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#timePartitioning
+                https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#timePartitioning
         :type time_partitioning: dict
         :param view: [Optional] A dictionary containing definition for the view.
             If set, it will create a view instead of a table:
@@ -266,7 +266,7 @@ def create_empty_table(self,
                 "useLegacySql": False
             }
 
-        :return:
+        :return: None
         """
 
         project_id = project_id if project_id is not None else self.project_id
@@ -353,7 +353,7 @@ def create_external_table(self,
             Possible values include GZIP and NONE.
             The default value is NONE.
             This setting is ignored for Google Cloud Bigtable,
-                Google Cloud Datastore backups and Avro formats.
+            Google Cloud Datastore backups and Avro formats.
         :type compression: str
         :param ignore_unknown_values: [Optional] Indicates if BigQuery should allow
             extra values that are not represented in the table schema.
@@ -543,28 +543,26 @@ def patch_table(self,
             https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs#configuration.load.schema
             The supported schema modifications and unsupported schema modification are listed here:
             https://cloud.google.com/bigquery/docs/managing-table-schemas
-        :type schema: list
+            **Example**: ::
 
-        **Example**: ::
-
-            schema=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
-                           {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}]
+                schema=[{"name": "emp_name", "type": "STRING", "mode": "REQUIRED"},
+                               {"name": "salary", "type": "INTEGER", "mode": "NULLABLE"}]
 
+        :type schema: list
         :param time_partitioning: [Optional] A dictionary containing time-based partitioning
              definition for the table.
         :type time_partitioning: dict
         :param view: [Optional] A dictionary containing definition for the view.
             If set, it will patch a view instead of a table:
             https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#view
-        :type view: dict
+            **Example**: ::
 
-        **Example**: ::
-
-            view = {
-                "query": "SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*` LIMIT 500",
-                "useLegacySql": False
-            }
+                view = {
+                    "query": "SELECT * FROM `test-project-id.test_dataset_id.test_table_prefix*` LIMIT 500",
+                    "useLegacySql": False
+                }
 
+        :type view: dict
         :param require_partition_filter: [Optional] If true, queries over the this table require a
             partition filter. If false, queries over the table
         :type require_partition_filter: bool
@@ -933,14 +931,14 @@ def run_copy(self,
         For more details about these parameters.
 
         :param source_project_dataset_tables: One or more dotted
-            (project:|project.)<dataset>.<table>
+            ``(project:|project.)<dataset>.<table>``
             BigQuery tables to use as the source data. Use a list if there are
             multiple source tables.
             If ``<project>`` is not included, project will be the project defined
             in the connection json.
         :type source_project_dataset_tables: list|string
         :param destination_project_dataset_table: The destination BigQuery
-            table. Format is: (project:|project.)<dataset>.<table>
+            table. Format is: ``(project:|project.)<dataset>.<table>``
         :type destination_project_dataset_table: str
         :param write_disposition: The write disposition if the table already exists.
         :type write_disposition: str
@@ -1386,11 +1384,11 @@ def run_table_delete(self, deletion_dataset_table,
         is set to True.
 
         :param deletion_dataset_table: A dotted
-        (<project>.|<project>:)<dataset>.<table> that indicates which table
-        will be deleted.
+            ``(<project>.|<project>:)<dataset>.<table>`` that indicates which table
+            will be deleted.
         :type deletion_dataset_table: str
         :param ignore_if_missing: if True, then return success even if the
-        requested table does not exist.
+            requested table does not exist.
         :type ignore_if_missing: bool
         :return:
         """
@@ -1425,7 +1423,7 @@ def run_table_upsert(self, dataset_id, table_resource, project_id=None):
             https://cloud.google.com/bigquery/docs/reference/v2/tables#resource
         :type table_resource: dict
         :param project_id: the project to upsert the table into.  If None,
-        project will be self.project_id.
+            project will be self.project_id.
         :return:
         """
         # check to see if the table exists
@@ -1479,10 +1477,10 @@ def run_grant_dataset_view_access(self,
         :param view_table: the table of the view
         :type view_table: str
         :param source_project: the project of the source dataset. If None,
-        self.project_id will be used.
+            self.project_id will be used.
         :type source_project: str
         :param view_project: the project that the view is in. If None,
-        self.project_id will be used.
+            self.project_id will be used.
         :type view_project: str
         :return: the datasets resource of the source dataset.
         """
diff --git a/airflow/contrib/hooks/databricks_hook.py b/airflow/contrib/hooks/databricks_hook.py
index b616f21c51906..a3cd31617a4c0 100644
--- a/airflow/contrib/hooks/databricks_hook.py
+++ b/airflow/contrib/hooks/databricks_hook.py
@@ -75,16 +75,18 @@ def _parse_host(host):
         The purpose of this function is to be robust to improper connections
         settings provided by users, specifically in the host field.
 
-
         For example -- when users supply ``https://xx.cloud.databricks.com`` as the
-        host, we must strip out the protocol to get the host.
-        >>> h = DatabricksHook()
-        >>> assert h._parse_host('https://xx.cloud.databricks.com') == \
-            'xx.cloud.databricks.com'
+        host, we must strip out the protocol to get the host.::
+
+            h = DatabricksHook()
+            assert h._parse_host('https://xx.cloud.databricks.com') == \
+                'xx.cloud.databricks.com'
 
         In the case where users supply the correct ``xx.cloud.databricks.com`` as the
-        host, this function is a no-op.
-        >>> assert h._parse_host('xx.cloud.databricks.com') == 'xx.cloud.databricks.com'
+        host, this function is a no-op.::
+
+            assert h._parse_host('xx.cloud.databricks.com') == 'xx.cloud.databricks.com'
+
         """
         urlparse_host = urlparse.urlparse(host).hostname
         if urlparse_host:
@@ -97,8 +99,9 @@ def _parse_host(host):
     def _do_api_call(self, endpoint_info, json):
         """
         Utility function to perform an API call with retries
+
         :param endpoint_info: Tuple of method and endpoint
-        :type endpoint_info: (string, string)
+        :type endpoint_info: tuple[string, string]
         :param json: Parameters for this API call.
         :type json: dict
         :return: If the api call returns a OK status code,
diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 0912fb40a5138..51a59d460022a 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -452,16 +452,25 @@ def _start_driver_status_tracking(self):
         Finish failed when the status is ERROR/UNKNOWN/KILLED/FAILED.
 
         Possible status:
-            SUBMITTED: Submitted but not yet scheduled on a worker
-            RUNNING: Has been allocated to a worker to run
-            FINISHED: Previously ran and exited cleanly
-            RELAUNCHING: Exited non-zero or due to worker failure, but has not yet
+
+        SUBMITTED
+            Submitted but not yet scheduled on a worker
+        RUNNING
+            Has been allocated to a worker to run
+        FINISHED
+            Previously ran and exited cleanly
+        RELAUNCHING
+            Exited non-zero or due to worker failure, but has not yet
             started running again
-            UNKNOWN: The status of the driver is temporarily not known due to
-             master failure recovery
-            KILLED: A user manually killed this driver
-            FAILED: The driver exited non-zero and was not supervised
-            ERROR: Unable to run or restart due to an unrecoverable error
+        UNKNOWN
+            The status of the driver is temporarily not known due to
+            master failure recovery
+        KILLED
+            A user manually killed this driver
+        FAILED
+            The driver exited non-zero and was not supervised
+        ERROR
+            Unable to run or restart due to an unrecoverable error
             (e.g. missing jar file)
         """
 
diff --git a/airflow/contrib/operators/dataflow_operator.py b/airflow/contrib/operators/dataflow_operator.py
index babadac70602a..e880642f6067c 100644
--- a/airflow/contrib/operators/dataflow_operator.py
+++ b/airflow/contrib/operators/dataflow_operator.py
@@ -399,7 +399,7 @@ def google_cloud_to_local(self, file_name):
         :param file_name: The full path of input file.
         :type file_name: str
         :return: The full path of local file.
-        :type str
+        :rtype: str
         """
         if not file_name.startswith('gs://'):
             return file_name
diff --git a/airflow/contrib/operators/mlengine_operator_utils.py b/airflow/contrib/utils/mlengine_operator_utils.py
similarity index 99%
rename from airflow/contrib/operators/mlengine_operator_utils.py
rename to airflow/contrib/utils/mlengine_operator_utils.py
index 4a8fa0589def7..c3ca8530dee6e 100644
--- a/airflow/contrib/operators/mlengine_operator_utils.py
+++ b/airflow/contrib/utils/mlengine_operator_utils.py
@@ -213,7 +213,7 @@ def validate_err_and_count(summary):
     evaluate_summary = DataFlowPythonOperator(
         task_id=(task_prefix + "-summary"),
         py_options=["-m"],
-        py_file="airflow.contrib.operators.mlengine_prediction_summary",
+        py_file="airflow.contrib.utils.mlengine_prediction_summary",
         dataflow_default_options=dataflow_options,
         options={
             "prediction_path": prediction_path,
diff --git a/airflow/contrib/operators/mlengine_prediction_summary.py b/airflow/contrib/utils/mlengine_prediction_summary.py
similarity index 100%
rename from airflow/contrib/operators/mlengine_prediction_summary.py
rename to airflow/contrib/utils/mlengine_prediction_summary.py
diff --git a/airflow/executors/celery_executor.py b/airflow/executors/celery_executor.py
index f877368325a10..09ed425547e12 100644
--- a/airflow/executors/celery_executor.py
+++ b/airflow/executors/celery_executor.py
@@ -74,11 +74,12 @@ def execute_command(command_to_exec):
 
 class ExceptionWithTraceback(object):
     """
-    Wrapper class used to propogate exceptions to parent processes from subprocesses.
+    Wrapper class used to propagate exceptions to parent processes from subprocesses.
+
     :param exception: The exception to wrap
     :type exception: Exception
-    :param traceback: The stacktrace to wrap
-    :type traceback: str
+    :param exception_traceback: The stacktrace to wrap
+    :type exception_traceback: str
     """
 
     def __init__(self, exception, exception_traceback):
@@ -90,11 +91,12 @@ def fetch_celery_task_state(celery_task):
     """
     Fetch and return the state of the given celery task. The scope of this function is
     global so that it can be called by subprocesses in the pool.
+
     :param celery_task: a tuple of the Celery task key and the async Celery object used
-                        to fetch the task's state
+        to fetch the task's state
     :type celery_task: tuple(str, celery.result.AsyncResult)
     :return: a tuple of the Celery task key and the Celery state of the task
-    :rtype: luple[str, str]
+    :rtype: tuple[str, str]
     """
 
     try:
diff --git a/tests/contrib/operators/test_mlengine_operator_utils.py b/tests/contrib/utils/test_mlengine_operator_utils.py
similarity index 88%
rename from tests/contrib/operators/test_mlengine_operator_utils.py
rename to tests/contrib/utils/test_mlengine_operator_utils.py
index a0722650417d2..c6c0849250040 100644
--- a/tests/contrib/operators/test_mlengine_operator_utils.py
+++ b/tests/contrib/utils/test_mlengine_operator_utils.py
@@ -23,8 +23,7 @@
 import unittest
 
 from airflow import configuration, DAG
-from airflow.contrib.operators import mlengine_operator_utils
-from airflow.contrib.operators.mlengine_operator_utils import create_evaluate_ops
+from airflow.contrib.utils import mlengine_operator_utils
 from airflow.exceptions import AirflowException
 from airflow.version import version
 
@@ -76,7 +75,7 @@ def setUp(self):
     def testSuccessfulRun(self):
         input_with_model = self.INPUT_MISSING_ORIGIN.copy()
 
-        pred, summary, validate = create_evaluate_ops(
+        pred, summary, validate = mlengine_operator_utils.create_evaluate_ops(
             task_prefix='eval-test',
             batch_prediction_job_id='eval-test-prediction',
             data_format=input_with_model['dataFormat'],
@@ -118,10 +117,10 @@ def testSuccessfulRun(self):
                     'metric_keys': 'err',
                     'metric_fn_encoded': self.metric_fn_encoded,
                 },
-                'airflow.contrib.operators.mlengine_prediction_summary',
+                'airflow.contrib.utils.mlengine_prediction_summary',
                 ['-m'])
 
-        with patch('airflow.contrib.operators.mlengine_operator_utils.'
+        with patch('airflow.contrib.utils.mlengine_operator_utils.'
                    'GoogleCloudStorageHook') as mock_gcs_hook:
             hook_instance = mock_gcs_hook.return_value
             hook_instance.download.return_value = '{"err": 0.9, "count": 9}'
@@ -155,25 +154,27 @@ def testFailures(self):
         }
 
         with self.assertRaisesRegexp(AirflowException, 'Missing model origin'):
-            create_evaluate_ops(**other_params_but_models)
+            mlengine_operator_utils.create_evaluate_ops(**other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException, 'Ambiguous model origin'):
-            create_evaluate_ops(model_uri='abc', model_name='cde', **other_params_but_models)
+            mlengine_operator_utils.create_evaluate_ops(model_uri='abc', model_name='cde',
+                                                        **other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException, 'Ambiguous model origin'):
-            create_evaluate_ops(model_uri='abc', version_name='vvv', **other_params_but_models)
+            mlengine_operator_utils.create_evaluate_ops(model_uri='abc', version_name='vvv',
+                                                        **other_params_but_models)
 
         with self.assertRaisesRegexp(AirflowException,
                                      '`metric_fn` param must be callable'):
             params = other_params_but_models.copy()
             params['metric_fn_and_keys'] = (None, ['abc'])
-            create_evaluate_ops(model_uri='gs://blah', **params)
+            mlengine_operator_utils.create_evaluate_ops(model_uri='gs://blah', **params)
 
         with self.assertRaisesRegexp(AirflowException,
                                      '`validate_fn` param must be callable'):
             params = other_params_but_models.copy()
             params['validate_fn'] = None
-            create_evaluate_ops(model_uri='gs://blah', **params)
+            mlengine_operator_utils.create_evaluate_ops(model_uri='gs://blah', **params)
 
 
 if __name__ == '__main__':

From a4d755aee595b3da922d2ffdbf5dc1e4c4538a46 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 27 Feb 2019 14:55:27 +0100
Subject: [PATCH 754/808] [AIRFLOW-XXX] Fix syntax docs errors (#4789)

Co-authored-by: Jarek Potiuk <jarek.potiuk@polidea.com>
---
 .../example_dags/example_gcp_function.py      | 22 ++++++-------
 .../example_dags/example_gcp_spanner.py       |  9 +++--
 airflow/contrib/hooks/gcp_vision_hook.py      | 31 +++++++++--------
 .../pod_request_factory.py                    |  5 ++-
 .../operators/jenkins_job_trigger_operator.py |  2 +-
 airflow/contrib/utils/gcp_field_validator.py  | 33 ++++++++++---------
 airflow/lineage/__init__.py                   | 14 ++++----
 airflow/models/__init__.py                    |  2 +-
 airflow/task/task_runner/base_task_runner.py  | 11 +++----
 airflow/ti_deps/dep_context.py                |  1 +
 airflow/utils/asciiart.py                     |  2 +-
 airflow/utils/dates.py                        | 26 ++++++++-------
 airflow/utils/sqlalchemy.py                   |  2 ++
 docs/concepts.rst                             | 33 ++++++++-----------
 14 files changed, 99 insertions(+), 94 deletions(-)

diff --git a/airflow/contrib/example_dags/example_gcp_function.py b/airflow/contrib/example_dags/example_gcp_function.py
index b8f48cebfdda2..75dcf2ece3816 100644
--- a/airflow/contrib/example_dags/example_gcp_function.py
+++ b/airflow/contrib/example_dags/example_gcp_function.py
@@ -23,22 +23,22 @@
 
 This DAG relies on the following OS environment variables
 https://airflow.apache.org/concepts.html#variables
+
 * GCP_PROJECT_ID - Google Cloud Project to use for the Cloud Function.
 * GCP_LOCATION - Google Cloud Functions region where the function should be
   created.
 * GCF_ENTRYPOINT - Name of the executable function in the source code.
 * and one of the below:
-    - GCF_SOURCE_ARCHIVE_URL - Path to the zipped source in Google Cloud Storage
-    or
-    (
-        - GCF_SOURCE_UPLOAD_URL - Generated upload URL for the zipped source
-        and
-        - GCF_ZIP_PATH - Local path to the zipped source archive
-    )
-    or
-    - GCF_SOURCE_REPOSITORY - The URL pointing to the hosted repository where the function
-    is defined in a supported Cloud Source Repository URL format
-    https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#SourceRepository
+
+    * GCF_SOURCE_ARCHIVE_URL - Path to the zipped source in Google Cloud Storage
+
+    * GCF_SOURCE_UPLOAD_URL - Generated upload URL for the zipped source and GCF_ZIP_PATH - Local path to
+      the zipped source archive
+
+    * GCF_SOURCE_REPOSITORY - The URL pointing to the hosted repository where the function
+      is defined in a supported Cloud Source Repository URL format
+      https://cloud.google.com/functions/docs/reference/rest/v1/projects.locations.functions#SourceRepository
+
 """
 
 import os
diff --git a/airflow/contrib/example_dags/example_gcp_spanner.py b/airflow/contrib/example_dags/example_gcp_spanner.py
index 936e5094e588f..4d77b3abf096b 100644
--- a/airflow/contrib/example_dags/example_gcp_spanner.py
+++ b/airflow/contrib/example_dags/example_gcp_spanner.py
@@ -25,13 +25,12 @@
 * GCP_SPANNER_INSTANCE_ID - Cloud Spanner instance ID.
 * GCP_SPANNER_DATABASE_ID - Cloud Spanner database ID.
 * GCP_SPANNER_CONFIG_NAME - The name of the instance's configuration. Values are of the
-    form projects/<gcp_project>/instanceConfigs/<configuration>.
-    See also:
-        https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs#InstanceConfig
-        https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list#google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
+  form ``projects/<gcp_project>/instanceConfigs/<configuration>``. See also:
+  https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs#InstanceConfig
+  https://cloud.google.com/spanner/docs/reference/rest/v1/projects.instanceConfigs/list#google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs
 * GCP_SPANNER_NODE_COUNT - Number of nodes allocated to the instance.
 * GCP_SPANNER_DISPLAY_NAME - The descriptive name for this instance as it appears in UIs.
-    Must be unique per project and between 4 and 30 characters in length.
+  Must be unique per project and between 4 and 30 characters in length.
 """
 
 import os
diff --git a/airflow/contrib/hooks/gcp_vision_hook.py b/airflow/contrib/hooks/gcp_vision_hook.py
index 6490f12fe2132..ede44bf5e5e25 100644
--- a/airflow/contrib/hooks/gcp_vision_hook.py
+++ b/airflow/contrib/hooks/gcp_vision_hook.py
@@ -30,13 +30,18 @@ class NameDeterminer:
     """
     Class used for checking if the entity has the 'name' attribute set.
 
-    - If so, no action is taken.
-    - If not, and the name can be constructed from other parameters provided, it is created and filled in
+    * If so, no action is taken.
+
+    * If not, and the name can be constructed from other parameters provided, it is created and filled in
       the entity.
-    - If both the entity's 'name' attribute is set and the name can be constructed from other parameters
+
+    * If both the entity's 'name' attribute is set and the name can be constructed from other parameters
       provided:
-        - If they are the same: no action is taken.
-        - If they are different: an exception is thrown.
+
+        * If they are the same - no action is taken
+
+        * if they are different - an exception is thrown.
+
     """
 
     def __init__(self, label, id_label, get_path):
@@ -127,7 +132,7 @@ def create_product_set(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator`
         """
         client = self.get_conn()
         parent = ProductSearchClient.location_path(project_id, location)
@@ -157,7 +162,7 @@ def get_product_set(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator`
         """
         client = self.get_conn()
         name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
@@ -182,7 +187,7 @@ def update_product_set(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator`
         """
         client = self.get_conn()
         product_set = self.product_set_name_determiner.get_entity_with_name(
@@ -203,7 +208,7 @@ def delete_product_set(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator`
         """
         client = self.get_conn()
         name = ProductSearchClient.product_set_path(project_id, location, product_set_id)
@@ -218,7 +223,7 @@ def create_product(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator`
         """
         client = self.get_conn()
         parent = ProductSearchClient.location_path(project_id, location)
@@ -246,7 +251,7 @@ def create_product(
     def get_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator`
         """
         client = self.get_conn()
         name = ProductSearchClient.product_path(project_id, location, product_id)
@@ -271,7 +276,7 @@ def update_product(
     ):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator`
         """
         client = self.get_conn()
         product = self.product_name_determiner.get_entity_with_name(product, product_id, location, project_id)
@@ -288,7 +293,7 @@ def update_product(
     def delete_product(self, location, product_id, project_id=None, retry=None, timeout=None, metadata=None):
         """
         For the documentation see:
-        :py:class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
+        :class:`~airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator`
         """
         client = self.get_conn()
         name = ProductSearchClient.product_path(project_id, location, product_id)
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index cb93be8754f16..afcbf93525257 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -67,12 +67,11 @@ def create(self, pod):
 
 
 class ExtractXcomPodRequestFactory(KubernetesRequestFactory):
-
-    XCOM_MOUNT_PATH = '/airflow/xcom'
-    SIDECAR_CONTAINER_NAME = 'airflow-xcom-sidecar'
     """
     Request generator for a pod with sidecar container.
     """
+    XCOM_MOUNT_PATH = '/airflow/xcom'
+    SIDECAR_CONTAINER_NAME = 'airflow-xcom-sidecar'
     _yaml = """apiVersion: v1
 kind: Pod
 metadata:
diff --git a/airflow/contrib/operators/jenkins_job_trigger_operator.py b/airflow/contrib/operators/jenkins_job_trigger_operator.py
index 54d11e1a1722e..3af87f3f3bed7 100644
--- a/airflow/contrib/operators/jenkins_job_trigger_operator.py
+++ b/airflow/contrib/operators/jenkins_job_trigger_operator.py
@@ -41,7 +41,7 @@ def jenkins_request_with_headers(jenkins_server, req):
     :param jenkins_server: The server to query
     :param req: The request to execute
     :return: Dict containing the response body (key body)
-    and the headers coming along (headers)
+        and the headers coming along (headers)
     """
     try:
         response = jenkins_server.jenkins_request(req)
diff --git a/airflow/contrib/utils/gcp_field_validator.py b/airflow/contrib/utils/gcp_field_validator.py
index 25900e4242a76..73e37f3e41be9 100644
--- a/airflow/contrib/utils/gcp_field_validator.py
+++ b/airflow/contrib/utils/gcp_field_validator.py
@@ -45,21 +45,20 @@
 
 Typically (for clarity and in order to aid syntax highlighting) the array of
 dicts should be defined as series of dict() executions. Fragment of example
-specification might look as follows:
-
-```
-SPECIFICATION =[
-   dict(name="an_union", type="union", optional=True, fields=[
-       dict(name="variant_1", type="dict"),
-       dict(name="variant_2", regexp=r'^.+$', api_version='v1beta2'),
-   ),
-   dict(name="an_union", type="dict", fields=[
-       dict(name="field_1", type="dict"),
-       dict(name="field_2", regexp=r'^.+$'),
-   ),
-   ...
-]
-```
+specification might look as follows::
+
+    SPECIFICATION =[
+       dict(name="an_union", type="union", optional=True, fields=[
+           dict(name="variant_1", type="dict"),
+           dict(name="variant_2", regexp=r'^.+$', api_version='v1beta2'),
+       ),
+       dict(name="an_union", type="dict", fields=[
+           dict(name="field_1", type="dict"),
+           dict(name="field_2", regexp=r'^.+$'),
+       ),
+       ...
+    ]
+
 
 Each field should have key = "name" indicating field name. The field can be of one of the
 following types:
@@ -310,6 +309,7 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
                         force_optional=False):
         """
         Validates if field is OK.
+
         :param validation_spec: specification of the field
         :type validation_spec: dict
         :param dictionary_to_validate: dictionary where the field should be present
@@ -317,7 +317,7 @@ def _validate_field(self, validation_spec, dictionary_to_validate, parent=None,
         :param parent: full path of parent field
         :type parent: str
         :param force_optional: forces the field to be optional
-          (all union fields have force_optional set to True)
+            (all union fields have force_optional set to True)
         :type force_optional: bool
         :return: True if the field is present
         """
@@ -409,6 +409,7 @@ def validate(self, body_to_validate):
         instantiated with. Raises ValidationSpecificationException or
         ValidationFieldException in case of problems with specification or the
         body not conforming to the specification respectively.
+
         :param body_to_validate: body that must follow the specification
         :type body_to_validate: dict
         :return: None
diff --git a/airflow/lineage/__init__.py b/airflow/lineage/__init__.py
index 9eaafebc19ff1..124cbabbd9a3d 100644
--- a/airflow/lineage/__init__.py
+++ b/airflow/lineage/__init__.py
@@ -84,13 +84,13 @@ def wrapper(self, context, *args, **kwargs):
 
 def prepare_lineage(func):
     """
-    Prepares the lineage inlets and outlets
-    inlets can be:
-        "auto" -> picks up any outlets from direct upstream tasks that have outlets
-        defined, as such that if A -> B -> C and B does not have outlets but A does,
-        these are provided as inlets.
-        "list of task_ids" -> picks up outlets from the upstream task_ids
-        "list of datasets" -> manually defined list of DataSet
+    Prepares the lineage inlets and outlets. Inlets can be:
+
+    * "auto" -> picks up any outlets from direct upstream tasks that have outlets defined, as such that
+      if A -> B -> C and B does not have outlets but A does, these are provided as inlets.
+    * "list of task_ids" -> picks up outlets from the upstream task_ids
+    * "list of datasets" -> manually defined list of DataSet
+
     """
     @wraps(func)
     def wrapper(self, context, *args, **kwargs):
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 98374fe91e640..58feb4cbb90c5 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -4093,7 +4093,7 @@ def run(
         :param local: True to run the tasks using the LocalExecutor
         :type local: bool
         :param executor: The executor instance to run the tasks
-        :type executor: BaseExecutor
+        :type executor: airflow.executor.BaseExecutor
         :param donot_pickle: True to avoid pickling DAG object and send to workers
         :type donot_pickle: bool
         :param ignore_task_deps: True to skip upstream tasks
diff --git a/airflow/task/task_runner/base_task_runner.py b/airflow/task/task_runner/base_task_runner.py
index 4a62cab941e61..f215c91b90a29 100644
--- a/airflow/task/task_runner/base_task_runner.py
+++ b/airflow/task/task_runner/base_task_runner.py
@@ -102,13 +102,12 @@ def _read_task_logs(self, stream):
 
     def run_command(self, run_with=None, join_args=False):
         """
-        Run the task command
+        Run the task command.
 
-        :param run_with: list of tokens to run the task command with
-        E.g. ['bash', '-c']
+        :param run_with: list of tokens to run the task command with e.g. ``['bash', '-c']``
         :type run_with: list
-        :param join_args: whether to concatenate the list of command tokens
-        E.g. ['airflow', 'run'] vs ['airflow run']
+        :param join_args: whether to concatenate the list of command tokens e.g. ``['airflow', 'run']`` vs
+            ``['airflow run']``
         :param join_args: bool
         :return: the process that was run
         :rtype: subprocess.Popen
@@ -146,7 +145,7 @@ def start(self):
     def return_code(self):
         """
         :return: The return code associated with running the task instance or
-        None if the task is not yet done.
+            None if the task is not yet done.
         :rtype: int
         """
         raise NotImplementedError()
diff --git a/airflow/ti_deps/dep_context.py b/airflow/ti_deps/dep_context.py
index 96b0e773fbe3c..256063f3048e9 100644
--- a/airflow/ti_deps/dep_context.py
+++ b/airflow/ti_deps/dep_context.py
@@ -37,6 +37,7 @@ class DepContext(object):
 
     For example there could be a SomeRunContext that subclasses this class which has
     dependencies for:
+
     - Making sure there are slots available on the infrastructure to run the task instance
     - A task-instance's task-specific dependencies are met (e.g. the previous task
       instance completed successfully)
diff --git a/airflow/utils/asciiart.py b/airflow/utils/asciiart.py
index 952ebfe1e00c9..491d79aa3e74f 100644
--- a/airflow/utils/asciiart.py
+++ b/airflow/utils/asciiart.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-bug = r"""\
+bug = r"""
       =,             .=
      =.|    ,---.    |.=
      =.| "-(:::::)-" |.=
diff --git a/airflow/utils/dates.py b/airflow/utils/dates.py
index 6926535930681..e3340f557f264 100644
--- a/airflow/utils/dates.py
+++ b/airflow/utils/dates.py
@@ -41,8 +41,21 @@
 def date_range(start_date, end_date=None, num=None, delta=None):
     """
     Get a set of dates as a list based on a start, end and delta, delta
-    can be something that can be added to ``datetime.datetime``
-    or a cron expression as a ``str``
+    can be something that can be added to `datetime.datetime`
+    or a cron expression as a `str`
+
+    :Example::
+
+        date_range(datetime(2016, 1, 1), datetime(2016, 1, 3), delta=timedelta(1))
+            [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 1, 2, 0, 0),
+            datetime.datetime(2016, 1, 3, 0, 0)]
+        date_range(datetime(2016, 1, 1), datetime(2016, 1, 3), delta='0 0 * * *')
+            [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 1, 2, 0, 0),
+            datetime.datetime(2016, 1, 3, 0, 0)]
+        date_range(datetime(2016, 1, 1), datetime(2016, 3, 3), delta="0 0 0 * *")
+            [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 2, 1, 0, 0),
+            datetime.datetime(2016, 3, 1, 0, 0)]
+
     :param start_date: anchor date to start the series from
     :type start_date: datetime.datetime
     :param end_date: right boundary for the date range
@@ -51,15 +64,6 @@ def date_range(start_date, end_date=None, num=None, delta=None):
         number of entries you want in the range. This number can be negative,
         output will always be sorted regardless
     :type num: int
-    >>> date_range(datetime(2016, 1, 1), datetime(2016, 1, 3), delta=timedelta(1))
-    [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 1, 2, 0, 0),
-     datetime.datetime(2016, 1, 3, 0, 0)]
-    >>> date_range(datetime(2016, 1, 1), datetime(2016, 1, 3), delta='0 0 * * *')
-    [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 1, 2, 0, 0),
-     datetime.datetime(2016, 1, 3, 0, 0)]
-    >>> date_range(datetime(2016, 1, 1), datetime(2016, 3, 3), delta="0 0 0 * *")
-    [datetime.datetime(2016, 1, 1, 0, 0), datetime.datetime(2016, 2, 1, 0, 0),
-     datetime.datetime(2016, 3, 1, 0, 0)]
     """
     if not delta:
         return []
diff --git a/airflow/utils/sqlalchemy.py b/airflow/utils/sqlalchemy.py
index e5dea174020a0..62488ef4e2077 100644
--- a/airflow/utils/sqlalchemy.py
+++ b/airflow/utils/sqlalchemy.py
@@ -134,6 +134,7 @@ class UtcDateTime(TypeDecorator):
     """
     Almost equivalent to :class:`~sqlalchemy.types.DateTime` with
     ``timezone=True`` option, but it differs from that by:
+
     - Never silently take naive :class:`~datetime.datetime`, instead it
       always raise :exc:`ValueError` unless time zone aware value.
     - :class:`~datetime.datetime` value's :attr:`~datetime.datetime.tzinfo`
@@ -142,6 +143,7 @@ class UtcDateTime(TypeDecorator):
       it never return naive :class:`~datetime.datetime`, but time zone
       aware value, even with SQLite or MySQL.
     - Always returns DateTime in UTC
+
     """
 
     impl = DateTime(timezone=True)
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 46ba71764a4a1..9038b89f50b1f 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -131,28 +131,23 @@ described elsewhere in this document.
 
 Airflow provides operators for many common tasks, including:
 
-- :class:`airflow.operators.bash_operator.BashOperator` - executes a bash command
-- :class:`airflow.operators.python_operator.PythonOperator` - calls an arbitrary Python function
-- :class:`airflow.operators.email_operator.EmailOperator` - sends an email
-- :class:`airflow.operators.http_operator.SimpleHttpOperator` - sends an HTTP request
-- :class:`airflow.operators.mysql_operator.MySqlOperator`,
-  :class:`airflow.operators.sqlite_operator.SqliteOperator`,
-  :class:`airflow.operators.postgres_operator.PostgresOperator`,
-  :class:`airflow.operators.mssql_operator.MsSqlOperator`,
-  :class:`airflow.operators.oracle_operator.OracleOperator`,
-  :class:`airflow.operators.jdbc_operator.JdbcOperator`, etc. - executes a SQL command
+- :class:`~airflow.operators.bash_operator.BashOperator` - executes a bash command
+- :class:`~airflow.operators.python_operator.PythonOperator` - calls an arbitrary Python function
+- :class:`~airflow.operators.email_operator.EmailOperator` - sends an email
+- :class:`~airflow.operators.http_operator.SimpleHttpOperator` - sends an HTTP request
+- :class:`~airflow.operators.mysql_operator.MySqlOperator`,
+  :class:`~airflow.operators.sqlite_operator.SqliteOperator`,
+  :class:`~airflow.operators.postgres_operator.PostgresOperator`,
+  :class:`~airflow.operators.mssql_operator.MsSqlOperator`,
+  :class:`~airflow.operators.oracle_operator.OracleOperator`,
+  :class:`~airflow.operators.jdbc_operator.JdbcOperator`, etc. - executes a SQL command
 - ``Sensor`` - waits for a certain time, file, database row, S3 key, etc...
 
 In addition to these basic building blocks, there are many more specific
-operators: :class:`airflow.operators.docker_operator.DockerOperator`,
-:class:`airflow.operators.hive_operator.HiveOperator`, :class:`airflow.operators.s3_file_transform_operator.S3FileTransformOperator(`,
-:class:`airflow.operators.presto_to_mysql.PrestoToMySqlTransfer`,
-:class:`airflow.operators.slack_operator.SlackAPIOperator`... you get the idea!
-
-The ``airflow/contrib/`` directory contains yet more operators built by the
-community. These operators aren't always as complete or well-tested as those in
-the main distribution, but allow users to more easily add new functionality to
-the platform.
+operators: :class:`~airflow.operators.docker_operator.DockerOperator`,
+:class:`~airflow.operators.hive_operator.HiveOperator`, :class:`~airflow.operators.s3_file_transform_operator.S3FileTransformOperator(`,
+:class:`~airflow.operators.presto_to_mysql.PrestoToMySqlTransfer`,
+:class:`~airflow.operators.slack_operator.SlackAPIOperator`... you get the idea!
 
 Operators are only loaded by Airflow if they are assigned to a DAG.
 

From 2638ab7fc4168d40856862f3b5ec9c1631367229 Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Wed, 13 Feb 2019 09:05:13 +0100
Subject: [PATCH 755/808] =?UTF-8?q?[AIRFLOW-3884]=20Fixing=20doc=20checker?=
 =?UTF-8?q?,=20no=20warnings=20allowed=20anymore=20and=20fixed=20the=20cur?=
 =?UTF-8?q?rent=E2=80=A6=20(#4702)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Fixing doc checker, no warnings allowed anymore and fixed the current warnings

* Fixing flake8 issues
---
 CHANGELOG.txt                               |  4 ++--
 airflow/contrib/executors/mesos_executor.py |  8 ++------
 docs/build.sh                               | 13 +++++++------
 3 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index b5a0ef11d71e4..0086d93be4aae 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -941,7 +941,7 @@ Airflow 1.10.0, 2018-08-03
 - [AIRFLOW-1688] Support load.time_partitioning in bigquery_hook
 - [AIRFLOW-1975] Make TriggerDagRunOperator callback optional
 - [AIRFLOW-1480] Render template attributes for ExternalTaskSensor fields
-- [AIRFLOW-1958] Add **kwargs to send_email
+- [AIRFLOW-1958] Add kwargs to send_email
 - [AIRFLOW-1976] Fix for missing log/logger attribute FileProcessHandler
 - [AIRFLOW-1982] Fix Executor event log formatting
 - [AIRFLOW-1971] Propagate hive config on impersonation
@@ -2167,7 +2167,7 @@ Airflow 1.7.1, 2016-05-19
 - Show only Airflow's deprecation warnings
 - Set DAG_FOLDER for unit tests
 - Missing comma in setup.py
-- Deprecate *args and **kwargs in BaseOperator
+- Deprecate args and kwargs in BaseOperator
 - Raise deep scheduler exceptions to force a process restart.
 - Change inconsistent example DAG owners
 - Fix module path of send_email_smtp in configuration
diff --git a/airflow/contrib/executors/mesos_executor.py b/airflow/contrib/executors/mesos_executor.py
index 7aae91e6d4348..f101348acc1a1 100644
--- a/airflow/contrib/executors/mesos_executor.py
+++ b/airflow/contrib/executors/mesos_executor.py
@@ -19,10 +19,6 @@
 
 from future import standard_library
 
-from airflow.utils.log.logging_mixin import LoggingMixin
-from airflow.www.utils import LoginMixin
-
-
 from builtins import str
 from queue import Queue
 
@@ -49,7 +45,7 @@ def get_framework_name():
 
 # AirflowMesosScheduler, implements Mesos Scheduler interface
 # To schedule airflow jobs on mesos
-class AirflowMesosScheduler(mesos.interface.Scheduler, LoggingMixin):
+class AirflowMesosScheduler(mesos.interface.Scheduler):
     """
     Airflow Mesos scheduler implements mesos scheduler interface
     to schedule airflow tasks on mesos.
@@ -213,7 +209,7 @@ def statusUpdate(self, driver, update):
             self.task_queue.task_done()
 
 
-class MesosExecutor(BaseExecutor, LoginMixin):
+class MesosExecutor(BaseExecutor):
     """
     MesosExecutor allows distributing the execution of task
     instances to multiple mesos workers.
diff --git a/docs/build.sh b/docs/build.sh
index 24241c4d8cdd1..7fcbfa2ac06ee 100755
--- a/docs/build.sh
+++ b/docs/build.sh
@@ -25,17 +25,18 @@ cd "$FWDIR"
 
 [ -d _build ] && rm -r _build
 
-NUM_IGNORED_WARNINGS=4
-NUM_CURRENT_WARNINGS=$(make html |\
+SUCCEED_LINE=$(make html |\
     tee /dev/tty |\
     grep 'build succeeded' |\
-    head -1 |\
-    sed -E 's/build succeeded, ([0-9]+) warnings\./\1/g')
+    head -1)
 
-if [ "${NUM_CURRENT_WARNINGS}" != "${NUM_IGNORED_WARNINGS}" ]; then
+NUM_CURRENT_WARNINGS=$(echo $SUCCEED_LINE |\
+    sed -E 's/build succeeded, ([0-9]+) warnings?\./\1/g')
+
+if echo $SUCCEED_LINE | grep -q "warning"; then
     echo
     echo "Unexpected problems found in the documentation. "
-    echo "Currently, ${NUM_IGNORED_WARNINGS} warnings are ignored."
+    echo "Currently, ${NUM_CURRENT_WARNINGS} warnings found"
     echo
     exit 1
 fi

From b20d6b5219c0d81276eca0a414b50a337806770a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Tue, 26 Mar 2019 19:06:14 +0100
Subject: [PATCH 756/808] [AIRFLOW-3811] automatic generation of API Reference
 in docs (#4788)

Co-authored-by: Jarek Potiuk <jarek.potiuk@polidea.com>
---
 .gitignore                                    |   1 +
 airflow/contrib/hooks/gcp_transfer_hook.py    |   2 +-
 .../operators/kubernetes_pod_operator.py      |   3 -
 airflow/hooks/hdfs_hook.py                    |  13 +-
 airflow/operators/bash_operator.py            |   2 +-
 airflow/operators/python_operator.py          |   2 +-
 docs/autoapi_templates/index.rst              | 129 ++++
 docs/build.sh                                 |   3 +-
 docs/code.rst                                 | 567 ------------------
 docs/concepts.rst                             |   2 +-
 docs/conf.py                                  |  69 ++-
 docs/howto/connection/gcp.rst                 |   2 +
 docs/howto/operator/bash.rst                  |   2 +
 docs/howto/operator/index.rst                 |   2 +-
 docs/howto/operator/python.rst                |   6 +-
 docs/index.rst                                |   3 +-
 docs/kubernetes.rst                           |   7 +-
 docs/macros.rst                               | 118 ++++
 docs/{_templates => templates}/layout.html    |   0
 docs/tutorial.rst                             |   2 +-
 setup.py                                      |   5 +-
 21 files changed, 341 insertions(+), 599 deletions(-)
 create mode 100644 docs/autoapi_templates/index.rst
 delete mode 100644 docs/code.rst
 create mode 100644 docs/macros.rst
 rename docs/{_templates => templates}/layout.html (100%)

diff --git a/.gitignore b/.gitignore
index 089d7b1e2f7e3..0ccc81842735e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -83,6 +83,7 @@ instance/
 
 # Sphinx documentation
 docs/_build/
+docs/_api/
 
 # PyBuilder
 target/
diff --git a/airflow/contrib/hooks/gcp_transfer_hook.py b/airflow/contrib/hooks/gcp_transfer_hook.py
index c6fd4d5e2f6a6..d51d7747a9644 100644
--- a/airflow/contrib/hooks/gcp_transfer_hook.py
+++ b/airflow/contrib/hooks/gcp_transfer_hook.py
@@ -267,7 +267,7 @@ def list_transfer_operations(self, filter):
 
             * project_id is optional if you have a project id defined
               in the connection
-              See: :doc:`howto/connection/gcp`
+              See: :ref:`howto/connection:gcp`
 
         :type filter: dict
         :return: transfer operation
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 7c6060503697d..46cde7d0750c6 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -21,9 +21,6 @@
 from airflow.contrib.kubernetes import kube_client, pod_generator, pod_launcher
 from airflow.contrib.kubernetes.pod import Resources
 from airflow.utils.state import State
-from airflow.contrib.kubernetes.volume_mount import VolumeMount  # noqa
-from airflow.contrib.kubernetes.volume import Volume  # noqa
-from airflow.contrib.kubernetes.secret import Secret  # noqa
 
 
 class KubernetesPodOperator(BaseOperator):
diff --git a/airflow/hooks/hdfs_hook.py b/airflow/hooks/hdfs_hook.py
index 597b7c4f7ec83..31b2f11501a01 100644
--- a/airflow/hooks/hdfs_hook.py
+++ b/airflow/hooks/hdfs_hook.py
@@ -16,18 +16,15 @@
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
 # under the License.
-
-from six import PY2
-
 from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.hooks.base_hook import BaseHook
 
-
-snakebite_imported = False
-if PY2:
+try:
     from snakebite.client import Client, HAClient, Namenode, AutoConfigClient
-    snakebite_imported = True
+    snakebite_loaded = True
+except ImportError:
+    snakebite_loaded = False
 
 
 class HDFSHookException(AirflowException):
@@ -47,7 +44,7 @@ class HDFSHook(BaseHook):
     """
     def __init__(self, hdfs_conn_id='hdfs_default', proxy_user=None,
                  autoconfig=False):
-        if not snakebite_imported:
+        if not snakebite_loaded:
             raise ImportError(
                 'This HDFSHook implementation requires snakebite, but '
                 'snakebite is not compatible with Python 3 '
diff --git a/airflow/operators/bash_operator.py b/airflow/operators/bash_operator.py
index 32d37ebe7a8eb..54c2dfba8907a 100644
--- a/airflow/operators/bash_operator.py
+++ b/airflow/operators/bash_operator.py
@@ -38,7 +38,7 @@ class BashOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :doc:`howto/operator/bash`
+        :ref:`howto/operator:BashOperator`
 
     :param bash_command: The command, set of commands or reference to a
         bash script (must be '.sh') to be executed. (templated)
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index ccdc9ceea0b3e..a69eb535196ce 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -41,7 +41,7 @@ class PythonOperator(BaseOperator):
 
     .. seealso::
         For more information on how to use this operator, take a look at the guide:
-        :doc:`howto/operator/python`
+        :ref:`howto/operator:PythonOperator`
 
     :param python_callable: A reference to an object that is callable
     :type python_callable: python callable
diff --git a/docs/autoapi_templates/index.rst b/docs/autoapi_templates/index.rst
new file mode 100644
index 0000000000000..ab32d3aa29c0c
--- /dev/null
+++ b/docs/autoapi_templates/index.rst
@@ -0,0 +1,129 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+API Reference
+=============
+
+Operators
+---------
+Operators allow for generation of certain types of tasks that become nodes in
+the DAG when instantiated. All operators derive from :class:`~airflow.models.BaseOperator` and
+inherit many attributes and methods that way.
+
+There are 3 main types of operators:
+
+- Operators that performs an **action**, or tell another system to
+  perform an action
+- **Transfer** operators move data from one system to another
+- **Sensors** are a certain type of operator that will keep running until a
+  certain criterion is met. Examples include a specific file landing in HDFS or
+  S3, a partition appearing in Hive, or a specific time of the day. Sensors
+  are derived from :class:`~airflow.sensors.base_sensor_operator.BaseSensorOperator` and run a poke
+  method at a specified :attr:`~airflow.sensors.base_sensor_operator.BaseSensorOperator.poke_interval` until it returns ``True``.
+
+BaseOperator
+''''''''''''
+All operators are derived from :class:`~airflow.models.BaseOperator` and acquire much
+functionality through inheritance. Since this is the core of the engine,
+it's worth taking the time to understand the parameters of :class:`~airflow.models.BaseOperator`
+to understand the primitive features that can be leveraged in your
+DAGs.
+
+BaseSensorOperator
+''''''''''''''''''
+All sensors are derived from :class:`~airflow.sensors.base_sensor_operator.BaseSensorOperator`. All sensors inherit
+the :attr:`~airflow.sensors.base_sensor_operator.BaseSensorOperator.timeout` and :attr:`~airflow.sensors.base_sensor_operator.BaseSensorOperator.poke_interval` on top of the :class:`~airflow.models.BaseOperator`
+attributes.
+
+Operators packages
+''''''''''''''''''
+All operators are in the following packages:
+
+.. toctree::
+  :includehidden:
+  :glob:
+  :maxdepth: 1
+
+  airflow/operators/index
+
+  airflow/sensors/index
+
+  airflow/contrib/operators/index
+
+  airflow/contrib/sensors/index
+
+
+Hooks
+-----
+Hooks are interfaces to external platforms and databases, implementing a common
+interface when possible and acting as building blocks for operators. All hooks
+are derived from :class:`~airflow.hooks.base_hook.BaseHook`.
+
+Hooks packages
+''''''''''''''
+All hooks are in the following packages:
+
+.. toctree::
+  :includehidden:
+  :glob:
+  :maxdepth: 1
+
+  airflow/hooks/index
+
+  airflow/contrib/hooks/index
+
+
+Executors
+---------
+Executors are the mechanism by which task instances get run. All executors are
+derived from :class:`~airflow.executors.base_executor.BaseExecutor`.
+
+Executors packages
+''''''''''''''''''
+All executors are in the following packages:
+
+.. toctree::
+  :includehidden:
+  :glob:
+  :maxdepth: 1
+
+  airflow/executors/index
+
+  airflow/contrib/executors/index
+
+
+Models
+------
+Models are built on top of the SQLAlchemy ORM Base class, and instances are
+persisted in the database.
+
+.. toctree::
+  :includehidden:
+  :glob:
+  :maxdepth: 1
+
+  airflow/models/index
+
+
+Core and community package
+--------------------------
+Formerly the core code was maintained by the original creators - Airbnb. The code
+that was in the contrib package was supported by the community. The project
+was passed to the Apache community and currently the entire code is
+maintained by the community, so now the division has no justification,
+and it is only due to historical reasons. Currently, all new classes are
+added only to the contrib package.
diff --git a/docs/build.sh b/docs/build.sh
index 7fcbfa2ac06ee..7d7a433f5ac02 100755
--- a/docs/build.sh
+++ b/docs/build.sh
@@ -23,7 +23,8 @@ set -e
 FWDIR="$(cd "`dirname "$0"`"; pwd)"
 cd "$FWDIR"
 
-[ -d _build ] && rm -r _build
+[[ -d "_build" ]] && rm -r _build
+[[ -d "_api" ]] && rm -r _api
 
 SUCCEED_LINE=$(make html |\
     tee /dev/tty |\
diff --git a/docs/code.rst b/docs/code.rst
deleted file mode 100644
index 368c2e9e00b59..0000000000000
--- a/docs/code.rst
+++ /dev/null
@@ -1,567 +0,0 @@
-..  Licensed to the Apache Software Foundation (ASF) under one
-    or more contributor license agreements.  See the NOTICE file
-    distributed with this work for additional information
-    regarding copyright ownership.  The ASF licenses this file
-    to you under the Apache License, Version 2.0 (the
-    "License"); you may not use this file except in compliance
-    with the License.  You may obtain a copy of the License at
-
-..    http://www.apache.org/licenses/LICENSE-2.0
-
-..  Unless required by applicable law or agreed to in writing,
-    software distributed under the License is distributed on an
-    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-    KIND, either express or implied.  See the License for the
-    specific language governing permissions and limitations
-    under the License.
-
-API Reference
-=============
-
-.. _api-reference-operators:
-
-Operators
----------
-Operators allow for generation of certain types of tasks that become nodes in
-the DAG when instantiated. All operators derive from ``BaseOperator`` and
-inherit many attributes and methods that way. Refer to the BaseOperator_
-documentation for more details.
-
-There are 3 main types of operators:
-
-- Operators that performs an **action**, or tell another system to
-  perform an action
-- **Transfer** operators move data from one system to another
-- **Sensors** are a certain type of operator that will keep running until a
-  certain criterion is met. Examples include a specific file landing in HDFS or
-  S3, a partition appearing in Hive, or a specific time of the day. Sensors
-  are derived from ``BaseSensorOperator`` and run a poke
-  method at a specified ``poke_interval`` until it returns ``True``.
-
-BaseOperator
-''''''''''''
-All operators are derived from ``BaseOperator`` and acquire much
-functionality through inheritance. Since this is the core of the engine,
-it's worth taking the time to understand the parameters of ``BaseOperator``
-to understand the primitive features that can be leveraged in your
-DAGs.
-
-
-.. autoclass:: airflow.models.BaseOperator
-
-
-BaseSensorOperator
-'''''''''''''''''''
-All sensors are derived from ``BaseSensorOperator``. All sensors inherit
-the ``timeout`` and ``poke_interval`` on top of the ``BaseOperator``
-attributes.
-
-.. autoclass:: airflow.sensors.base_sensor_operator.BaseSensorOperator
-
-
-Core Operators
-''''''''''''''
-
-Operators
-^^^^^^^^^
-
-.. autoclass:: airflow.operators.bash_operator.BashOperator
-.. autoclass:: airflow.operators.python_operator.BranchPythonOperator
-.. autoclass:: airflow.operators.check_operator.CheckOperator
-.. autoclass:: airflow.operators.docker_operator.DockerOperator
-.. autoclass:: airflow.operators.druid_check_operator.DruidCheckOperator
-.. autoclass:: airflow.operators.dummy_operator.DummyOperator
-.. autoclass:: airflow.operators.email_operator.EmailOperator
-.. autoclass:: airflow.operators.generic_transfer.GenericTransfer
-.. autoclass:: airflow.operators.hive_to_samba_operator.Hive2SambaOperator
-.. autoclass:: airflow.operators.hive_operator.HiveOperator
-.. autoclass:: airflow.operators.hive_stats_operator.HiveStatsCollectionOperator
-.. autoclass:: airflow.operators.hive_to_druid.HiveToDruidTransfer
-.. autoclass:: airflow.operators.hive_to_mysql.HiveToMySqlTransfer
-.. autoclass:: airflow.operators.check_operator.IntervalCheckOperator
-.. autoclass:: airflow.operators.jdbc_operator.JdbcOperator
-.. autoclass:: airflow.operators.latest_only_operator.LatestOnlyOperator
-.. autoclass:: airflow.operators.mssql_operator.MsSqlOperator
-.. autoclass:: airflow.operators.mssql_to_hive.MsSqlToHiveTransfer
-.. autoclass:: airflow.operators.mysql_operator.MySqlOperator
-.. autoclass:: airflow.operators.mysql_to_hive.MySqlToHiveTransfer
-.. autoclass:: airflow.operators.oracle_operator.OracleOperator
-.. autoclass:: airflow.operators.pig_operator.PigOperator
-.. autoclass:: airflow.operators.postgres_operator.PostgresOperator
-.. autoclass:: airflow.operators.presto_check_operator.PrestoCheckOperator
-.. autoclass:: airflow.operators.presto_check_operator.PrestoIntervalCheckOperator
-.. autoclass:: airflow.operators.presto_to_mysql.PrestoToMySqlTransfer
-.. autoclass:: airflow.operators.presto_check_operator.PrestoValueCheckOperator
-.. autoclass:: airflow.operators.python_operator.PythonOperator
-.. autoclass:: airflow.operators.python_operator.PythonVirtualenvOperator
-.. autoclass:: airflow.operators.redshift_to_s3_operator.RedshiftToS3Transfer
-.. autoclass:: airflow.operators.s3_file_transform_operator.S3FileTransformOperator
-.. autoclass:: airflow.operators.s3_to_hive_operator.S3ToHiveTransfer
-.. autoclass:: airflow.operators.s3_to_redshift_operator.S3ToRedshiftTransfer
-.. autoclass:: airflow.operators.python_operator.ShortCircuitOperator
-.. autoclass:: airflow.operators.http_operator.SimpleHttpOperator
-.. autoclass:: airflow.operators.slack_operator.SlackAPIOperator
-.. autoclass:: airflow.operators.slack_operator.SlackAPIPostOperator
-.. autoclass:: airflow.operators.sqlite_operator.SqliteOperator
-.. autoclass:: airflow.operators.subdag_operator.SubDagOperator
-.. autoclass:: airflow.operators.dagrun_operator.TriggerDagRunOperator
-.. autoclass:: airflow.operators.check_operator.ValueCheckOperator
-
-Sensors
-^^^^^^^
-.. autoclass:: airflow.sensors.external_task_sensor.ExternalTaskSensor
-.. autoclass:: airflow.sensors.hdfs_sensor.HdfsSensor
-.. autoclass:: airflow.sensors.hive_partition_sensor.HivePartitionSensor
-.. autoclass:: airflow.sensors.http_sensor.HttpSensor
-.. autoclass:: airflow.sensors.metastore_partition_sensor.MetastorePartitionSensor
-.. autoclass:: airflow.sensors.named_hive_partition_sensor.NamedHivePartitionSensor
-.. autoclass:: airflow.sensors.s3_key_sensor.S3KeySensor
-.. autoclass:: airflow.sensors.s3_prefix_sensor.S3PrefixSensor
-.. autoclass:: airflow.sensors.sql_sensor.SqlSensor
-.. autoclass:: airflow.sensors.time_delta_sensor.TimeDeltaSensor
-.. autoclass:: airflow.sensors.time_sensor.TimeSensor
-.. autoclass:: airflow.sensors.web_hdfs_sensor.WebHdfsSensor
-
-Community-contributed Operators
-'''''''''''''''''''''''''''''''
-
-Operators
-^^^^^^^^^
-.. Alphabetize this list
-
-.. autoclass:: airflow.contrib.operators.aws_athena_operator.AWSAthenaOperator
-.. autoclass:: airflow.contrib.operators.awsbatch_operator.AWSBatchOperator
-.. autoclass:: airflow.contrib.operators.adls_to_gcs.AdlsToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.azure_container_instances_operator.AzureContainerInstancesOperator
-.. autoclass:: airflow.contrib.operators.azure_cosmos_operator.AzureCosmosInsertDocumentOperator
-.. autoclass:: airflow.contrib.operators.adls_list_operator.AzureDataLakeStorageListOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyDatasetOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateEmptyTableOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryCreateExternalTableOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryDeleteDatasetOperator
-.. autoclass:: airflow.contrib.operators.bigquery_get_data.BigQueryGetDataOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryIntervalCheckOperator
-.. autoclass:: airflow.contrib.operators.bigquery_operator.BigQueryOperator
-.. autoclass:: airflow.contrib.operators.bigquery_table_delete_operator.BigQueryTableDeleteOperator
-.. autoclass:: airflow.contrib.operators.bigquery_to_bigquery.BigQueryToBigQueryOperator
-.. autoclass:: airflow.contrib.operators.bigquery_to_gcs.BigQueryToCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.bigquery_check_operator.BigQueryValueCheckOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableClusterUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableInstanceDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_bigtable_operator.BigtableTableWaitForReplicationSensor
-.. autoclass:: airflow.contrib.operators.cassandra_to_gcs.CassandraToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseQueryOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDatabaseUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_spanner_operator.CloudSpannerInstanceDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlBaseOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabaseDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDatabasePatchOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceExportOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstanceImportOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlInstancePatchOperator
-.. autoclass:: airflow.contrib.operators.gcp_sql_operator.CloudSqlQueryOperator
-.. autoclass:: airflow.contrib.operators.gcp_translate_operator.CloudTranslateTextOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAddProductToProductSetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionAnnotateImageOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductGetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetGetOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionProductUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionReferenceImageCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_vision_operator.CloudVisionRemoveProductFromProductSetOperator
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowJavaOperator
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataFlowPythonOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHadoopOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcHiveOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPigOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcPySparkOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataProcSparkSqlOperator
-.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksRunNowOperator
-.. autoclass:: airflow.contrib.operators.databricks_operator.DatabricksSubmitRunOperator
-.. autoclass:: airflow.contrib.operators.dataflow_operator.DataflowTemplateOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterCreateOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterDeleteOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocClusterScaleOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateBaseOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateInlineOperator
-.. autoclass:: airflow.contrib.operators.dataproc_operator.DataprocWorkflowTemplateInstantiateOperator
-.. autoclass:: airflow.contrib.operators.datastore_export_operator.DatastoreExportOperator
-.. autoclass:: airflow.contrib.operators.datastore_import_operator.DatastoreImportOperator
-.. autoclass:: airflow.contrib.operators.discord_webhook_operator.DiscordWebhookOperator
-.. autoclass:: airflow.contrib.operators.druid_operator.DruidOperator
-.. autoclass:: airflow.contrib.operators.ecs_operator.ECSOperator
-.. autoclass:: airflow.contrib.operators.emr_add_steps_operator.EmrAddStepsOperator
-.. autoclass:: airflow.contrib.operators.emr_create_job_flow_operator.EmrCreateJobFlowOperator
-.. autoclass:: airflow.contrib.operators.emr_terminate_job_flow_operator.EmrTerminateJobFlowOperator
-.. autoclass:: airflow.contrib.operators.file_to_gcs.FileToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.file_to_wasb.FileToWasbOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEClusterDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_container_operator.GKEPodOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceBaseOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceGroupManagerUpdateTemplateOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStartOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceStopOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceInstanceTemplateCopyOperator
-.. autoclass:: airflow.contrib.operators.gcp_compute_operator.GceSetMachineTypeOperator
-.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_function_operator.GcfFunctionDeployOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobCreateOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobDeleteOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceJobUpdateOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationCancelOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationGetOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationPauseOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationResumeOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GcpTransferServiceOperationsListOperator
-.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator
-.. autoclass:: airflow.contrib.operators.gcs_operator.GoogleCloudStorageCreateBucketOperator
-.. autoclass:: airflow.contrib.operators.gcs_download_operator.GoogleCloudStorageDownloadOperator
-.. autoclass:: airflow.contrib.operators.gcs_list_operator.GoogleCloudStorageListOperator
-.. autoclass:: airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator
-.. autoclass:: airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator
-.. autoclass:: airflow.contrib.operators.gcs_to_gcs.GoogleCloudStorageToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.GoogleCloudStorageToGoogleCloudStorageTransferOperator
-.. autoclass:: airflow.contrib.operators.gcs_to_s3.GoogleCloudStorageToS3Operator
-.. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPIOperator
-.. autoclass:: airflow.contrib.operators.hipchat_operator.HipChatAPISendRoomNotificationOperator
-.. autoclass:: airflow.contrib.operators.hive_to_dynamodb.HiveToDynamoDBTransferOperator
-.. autoclass:: airflow.contrib.operators.jenkins_job_trigger_operator.JenkinsJobTriggerOperator
-.. autoclass:: airflow.contrib.operators.jira_operator.JiraOperator
-.. autoclass:: airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineBatchPredictionOperator
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineModelOperator
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineTrainingOperator
-.. autoclass:: airflow.contrib.operators.mlengine_operator.MLEngineVersionOperator
-.. autoclass:: airflow.contrib.operators.mongo_to_s3.MongoToS3Operator
-.. autoclass:: airflow.contrib.operators.mysql_to_gcs.MySqlToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.oracle_to_azure_data_lake_transfer.OracleToAzureDataLakeTransfer
-.. autoclass:: airflow.contrib.operators.oracle_to_oracle_transfer.OracleToOracleTransfer
-.. autoclass:: airflow.contrib.operators.postgres_to_gcs_operator.PostgresToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubPublishOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubSubscriptionCreateOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubSubscriptionDeleteOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicCreateOperator
-.. autoclass:: airflow.contrib.operators.pubsub_operator.PubSubTopicDeleteOperator
-.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleCheckOperator
-.. autoclass:: airflow.contrib.operators.qubole_operator.QuboleOperator
-.. autoclass:: airflow.contrib.operators.qubole_check_operator.QuboleValueCheckOperator
-.. autoclass:: airflow.contrib.operators.s3_copy_object_operator.S3CopyObjectOperator
-.. autoclass:: airflow.contrib.operators.s3_delete_objects_operator.S3DeleteObjectsOperator
-.. autoclass:: airflow.contrib.operators.s3_list_operator.S3ListOperator
-.. autoclass:: airflow.contrib.operators.s3_to_gcs_operator.S3ToGoogleCloudStorageOperator
-.. autoclass:: airflow.contrib.operators.gcp_transfer_operator.S3ToGoogleCloudStorageTransferOperator
-.. autoclass:: airflow.contrib.operators.s3_to_sftp_operator.S3ToSFTPOperator
-.. autoclass:: airflow.contrib.operators.sftp_operator.SFTPOperator
-.. autoclass:: airflow.contrib.operators.sftp_to_s3_operator.SFTPToS3Operator
-.. autoclass:: airflow.contrib.operators.ssh_operator.SSHOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_base_operator.SageMakerBaseOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_config_operator.SageMakerEndpointConfigOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_endpoint_operator.SageMakerEndpointOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_model_operator.SageMakerModelOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_training_operator.SageMakerTrainingOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_transform_operator.SageMakerTransformOperator
-.. autoclass:: airflow.contrib.operators.sagemaker_tuning_operator.SageMakerTuningOperator
-.. autoclass:: airflow.contrib.operators.segment_track_event_operator.SegmentTrackEventOperator
-.. autoclass:: airflow.contrib.operators.slack_webhook_operator.SlackWebhookOperator
-.. autoclass:: airflow.contrib.operators.snowflake_operator.SnowflakeOperator
-.. autoclass:: airflow.contrib.operators.sns_publish_operator.SnsPublishOperator
-.. autoclass:: airflow.contrib.operators.spark_jdbc_operator.SparkJDBCOperator
-.. autoclass:: airflow.contrib.operators.spark_sql_operator.SparkSqlOperator
-.. autoclass:: airflow.contrib.operators.spark_submit_operator.SparkSubmitOperator
-.. autoclass:: airflow.contrib.operators.sqoop_operator.SqoopOperator
-.. autoclass:: airflow.contrib.operators.vertica_operator.VerticaOperator
-.. autoclass:: airflow.contrib.operators.vertica_to_hive.VerticaToHiveTransfer
-.. autoclass:: airflow.contrib.operators.vertica_to_mysql.VerticaToMySqlTransfer
-.. autoclass:: airflow.contrib.operators.wasb_delete_blob_operator.WasbDeleteBlobOperator
-.. autoclass:: airflow.contrib.operators.winrm_operator.WinRMOperator
-
-Sensors
-^^^^^^^
-
-.. autoclass:: airflow.contrib.sensors.aws_athena_sensor.AthenaSensor
-.. autoclass:: airflow.contrib.sensors.aws_glue_catalog_partition_sensor.AwsGlueCatalogPartitionSensor
-.. autoclass:: airflow.contrib.sensors.aws_redshift_cluster_sensor.AwsRedshiftClusterSensor
-.. autoclass:: airflow.contrib.sensors.azure_cosmos_sensor.AzureCosmosDocumentSensor
-.. autoclass:: airflow.contrib.sensors.bash_sensor.BashSensor
-.. autoclass:: airflow.contrib.sensors.bigquery_sensor.BigQueryTableSensor
-.. autoclass:: airflow.contrib.sensors.cassandra_record_sensor.CassandraRecordSensor
-.. autoclass:: airflow.contrib.sensors.cassandra_table_sensor.CassandraTableSensor
-.. autoclass:: airflow.contrib.sensors.datadog_sensor.DatadogSensor
-.. autoclass:: airflow.contrib.sensors.weekday_sensor.DayOfWeekSensor
-.. autoclass:: airflow.contrib.sensors.emr_base_sensor.EmrBaseSensor
-.. autoclass:: airflow.contrib.sensors.emr_job_flow_sensor.EmrJobFlowSensor
-.. autoclass:: airflow.contrib.sensors.emr_step_sensor.EmrStepSensor
-.. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSSensor
-.. autoclass:: airflow.contrib.sensors.ftp_sensor.FTPSensor
-.. autoclass:: airflow.contrib.sensors.file_sensor.FileSensor
-.. autoclass:: airflow.contrib.sensors.gcp_transfer_sensor.GCPTransferServiceWaitForJobStatusSensor
-.. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectSensor
-.. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStorageObjectUpdatedSensor
-.. autoclass:: airflow.contrib.sensors.gcs_sensor.GoogleCloudStoragePrefixSensor
-.. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorFolder
-.. autoclass:: airflow.contrib.sensors.hdfs_sensor.HdfsSensorRegex
-.. autoclass:: airflow.contrib.sensors.imap_attachment_sensor.ImapAttachmentSensor
-.. autoclass:: airflow.contrib.sensors.jira_sensor.JiraSensor
-.. autoclass:: airflow.contrib.sensors.jira_sensor.JiraTicketSensor
-.. autoclass:: airflow.contrib.sensors.mongo_sensor.MongoSensor
-.. autoclass:: airflow.contrib.sensors.pubsub_sensor.PubSubPullSensor
-.. autoclass:: airflow.contrib.sensors.python_sensor.PythonSensor
-.. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleFileSensor
-.. autoclass:: airflow.contrib.sensors.qubole_sensor.QubolePartitionSensor
-.. autoclass:: airflow.contrib.sensors.qubole_sensor.QuboleSensor
-.. autoclass:: airflow.contrib.sensors.redis_key_sensor.RedisKeySensor
-.. autoclass:: airflow.contrib.sensors.sftp_sensor.SFTPSensor
-.. autoclass:: airflow.contrib.sensors.sagemaker_base_sensor.SageMakerBaseSensor
-.. autoclass:: airflow.contrib.sensors.sagemaker_endpoint_sensor.SageMakerEndpointSensor
-.. autoclass:: airflow.contrib.sensors.sagemaker_training_sensor.SageMakerTrainingSensor
-.. autoclass:: airflow.contrib.sensors.sagemaker_transform_sensor.SageMakerTransformSensor
-.. autoclass:: airflow.contrib.sensors.sagemaker_tuning_sensor.SageMakerTuningSensor
-.. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbBlobSensor
-.. autoclass:: airflow.contrib.sensors.wasb_sensor.WasbPrefixSensor
-
-.. _macros:
-
-Macros
-------
-Variables and macros can be used in templates (see the :ref:`jinja-templating` section)
-
-The following come for free out of the box with Airflow. 
-Additional custom macros can be added globally through :ref:`plugins`, or at a DAG level through the ``DAG.user_defined_macros`` argument.
-
-Default Variables
-'''''''''''''''''
-The Airflow engine passes a few variables by default that are accessible
-in all templates
-
-=================================   ====================================
-Variable                            Description
-=================================   ====================================
-``{{ ds }}``                        the execution date as ``YYYY-MM-DD``
-``{{ ds_nodash }}``                 the execution date as ``YYYYMMDD``
-``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``
-                                    if ``{{ ds }}`` is ``2018-01-08`` and ``schedule_interval`` is ``@weekly``,
-                                    ``{{ prev_ds }}`` will be ``2016-01-01``
-``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None``
-``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``
-                                    if ``{{ ds }}`` is ``2018-01-01`` and ``schedule_interval`` is ``@weekly``,
-                                    ``{{ next_ds }}`` will be ``2018-01-08``
-``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None``
-``{{ yesterday_ds }}``              the day before the execution date as ``YYYY-MM-DD``
-``{{ yesterday_ds_nodash }}``       the day before the execution date as ``YYYYMMDD``
-``{{ tomorrow_ds }}``               the day after the execution date as ``YYYY-MM-DD``
-``{{ tomorrow_ds_nodash }}``        the day after the execution date as ``YYYYMMDD``
-``{{ ts }}``                        same as ``execution_date.isoformat()``. Example: ``2018-01-01T00:00:00+00:00``
-``{{ ts_nodash }}``                 same as ``ts`` without ``-``, ``:`` and TimeZone info. Example: ``20180101T000000``
-``{{ ts_nodash_with_tz }}``         same as ``ts`` without ``-`` and ``:``. Example: ``20180101T000000+0000``
-``{{ execution_date }}``            the execution_date, (datetime.datetime)
-``{{ prev_execution_date }}``       the previous execution date (if available) (datetime.datetime)
-``{{ next_execution_date }}``       the next execution date (datetime.datetime)
-``{{ dag }}``                       the DAG object
-``{{ task }}``                      the Task object
-``{{ macros }}``                    a reference to the macros package, described below
-``{{ task_instance }}``             the task_instance object
-``{{ end_date }}``                  same as ``{{ ds }}``
-``{{ latest_date }}``               same as ``{{ ds }}``
-``{{ ti }}``                        same as ``{{ task_instance }}``
-``{{ params }}``                    a reference to the user-defined params dictionary which can be overridden by
-                                    the dictionary passed through ``trigger_dag -c`` if you enabled
-                                    ``dag_run_conf_overrides_params` in ``airflow.cfg``
-``{{ var.value.my_var }}``          global defined variables represented as a dictionary
-``{{ var.json.my_var.path }}``      global defined variables represented as a dictionary
-                                    with deserialized JSON object, append the path to the
-                                    key within the JSON object
-``{{ task_instance_key_str }}``     a unique, human-readable key to the task instance
-                                    formatted ``{dag_id}_{task_id}_{ds}``
-``{{ conf }}``                      the full configuration object located at
-                                    ``airflow.configuration.conf`` which
-                                    represents the content of your
-                                    ``airflow.cfg``
-``{{ run_id }}``                    the ``run_id`` of the current DAG run
-``{{ dag_run }}``                   a reference to the DagRun object
-``{{ test_mode }}``                 whether the task instance was called using
-                                    the CLI's test subcommand
-=================================   ====================================
-
-Note that you can access the object's attributes and methods with simple
-dot notation. Here are some examples of what is possible:
-``{{ task.owner }}``, ``{{ task.task_id }}``, ``{{ ti.hostname }}``, ...
-Refer to the models documentation for more information on the objects'
-attributes and methods.
-
-The ``var`` template variable allows you to access variables defined in Airflow's
-UI. You can access them as either plain-text or JSON. If you use JSON, you are
-also able to walk nested structures, such as dictionaries like:
-``{{ var.json.my_dict_var.key1 }}``
-
-Macros
-''''''
-Macros are a way to expose objects to your templates and live under the
-``macros`` namespace in your templates.
-
-A few commonly used libraries and methods are made available.
-
-
-=================================   ====================================
-Variable                            Description
-=================================   ====================================
-``macros.datetime``                 The standard lib's ``datetime.datetime``
-``macros.timedelta``                 The standard lib's ``datetime.timedelta``
-``macros.dateutil``                 A reference to the ``dateutil`` package
-``macros.time``                     The standard lib's ``time``
-``macros.uuid``                     The standard lib's ``uuid``
-``macros.random``                   The standard lib's ``random``
-=================================   ====================================
-
-
-Some airflow specific macros are also defined:
-
-.. automodule:: airflow.macros
-    :show-inheritance:
-    :members:
-
-.. autofunction:: airflow.macros.hive.closest_ds_partition
-.. autofunction:: airflow.macros.hive.max_partition
-
-.. _models_ref:
-
-Models
-------
-
-Models are built on top of the SQLAlchemy ORM Base class, and instances are
-persisted in the database.
-
-
-.. automodule:: airflow.models
-    :show-inheritance:
-    :members: DAG, TaskInstance, DagBag, Connection, Variable, Pool, KubeResourceVersion, KubeWorkerIdentifier
-
-Hooks
------
-
-Hooks are interfaces to external platforms and databases, implementing a common
-interface when possible and acting as building blocks for operators.
-
-.. autoclass:: airflow.hooks.base_hook.BaseHook
-.. autoclass:: airflow.hooks.dbapi_hook.DbApiHook
-.. autoclass:: airflow.hooks.docker_hook.DockerHook
-.. autoclass:: airflow.hooks.druid_hook.DruidDbApiHook
-.. autoclass:: airflow.hooks.druid_hook.DruidHook
-.. autoclass:: airflow.hooks.hdfs_hook.HDFSHook
-.. autoclass:: airflow.hooks.hive_hooks.HiveCliHook
-.. autoclass:: airflow.hooks.hive_hooks.HiveMetastoreHook
-.. autoclass:: airflow.hooks.hive_hooks.HiveServer2Hook
-.. autoclass:: airflow.hooks.http_hook.HttpHook
-.. autoclass:: airflow.hooks.jdbc_hook.JdbcHook
-.. autoclass:: airflow.hooks.mssql_hook.MsSqlHook
-.. autoclass:: airflow.hooks.mysql_hook.MySqlHook
-.. autoclass:: airflow.hooks.oracle_hook.OracleHook
-.. autoclass:: airflow.hooks.pig_hook.PigCliHook
-.. autoclass:: airflow.hooks.postgres_hook.PostgresHook
-.. autoclass:: airflow.hooks.presto_hook.PrestoHook
-.. autoclass:: airflow.hooks.S3_hook.S3Hook
-.. autoclass:: airflow.hooks.samba_hook.SambaHook
-.. autoclass:: airflow.hooks.slack_hook.SlackHook
-.. autoclass:: airflow.hooks.sqlite_hook.SqliteHook
-.. autoclass:: airflow.hooks.webhdfs_hook.WebHDFSHook
-.. autoclass:: airflow.hooks.zendesk_hook.ZendeskHook
-
-Community contributed hooks
-'''''''''''''''''''''''''''
-.. Alphabetize this list
-.. autoclass:: airflow.contrib.hooks.aws_athena_hook.AWSAthenaHook
-.. autoclass:: airflow.contrib.hooks.aws_dynamodb_hook.AwsDynamoDBHook
-.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
-.. autoclass:: airflow.contrib.hooks.aws_glue_catalog_hook.AwsGlueCatalogHook
-.. autoclass:: airflow.contrib.hooks.aws_hook.AwsHook
-.. autoclass:: airflow.contrib.hooks.aws_firehose_hook.AwsFirehoseHook
-.. autoclass:: airflow.contrib.hooks.aws_lambda_hook.AwsLambdaHook
-.. autoclass:: airflow.contrib.hooks.aws_sns_hook.AwsSnsHook
-.. autoclass:: airflow.contrib.hooks.azure_container_instance_hook.AzureContainerInstanceHook
-.. autoclass:: airflow.contrib.hooks.azure_container_registry_hook.AzureContainerRegistryHook
-.. autoclass:: airflow.contrib.hooks.azure_container_volume_hook.AzureContainerVolumeHook
-.. autoclass:: airflow.contrib.hooks.azure_cosmos_hook.AzureCosmosDBHook
-.. autoclass:: airflow.contrib.hooks.azure_data_lake_hook.AzureDataLakeHook
-.. autoclass:: airflow.contrib.hooks.azure_fileshare_hook.AzureFileShareHook
-.. autoclass:: airflow.contrib.hooks.bigquery_hook.BigQueryHook
-.. autoclass:: airflow.contrib.hooks.gcp_bigtable_hook.BigtableHook
-.. autoclass:: airflow.contrib.hooks.cassandra_hook.CassandraHook
-.. autoclass:: airflow.contrib.hooks.gcp_spanner_hook.CloudSpannerHook
-.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlDatabaseHook
-.. autoclass:: airflow.contrib.hooks.gcp_sql_hook.CloudSqlHook
-.. autoclass:: airflow.contrib.hooks.gcp_translate_hook.CloudTranslateHook
-.. autoclass:: airflow.contrib.hooks.gcp_vision_hook.CloudVisionHook
-.. autoclass:: airflow.contrib.hooks.cloudant_hook.CloudantHook
-.. autoclass:: airflow.contrib.hooks.gcp_dataflow_hook.DataFlowHook
-.. autoclass:: airflow.contrib.hooks.gcp_dataproc_hook.DataProcHook
-.. autoclass:: airflow.contrib.hooks.databricks_hook.DatabricksHook
-.. autoclass:: airflow.contrib.hooks.datadog_hook.DatadogHook
-.. autoclass:: airflow.contrib.hooks.datastore_hook.DatastoreHook
-.. autoclass:: airflow.contrib.hooks.discord_webhook_hook.DiscordWebhookHook
-.. autoclass:: airflow.contrib.hooks.emr_hook.EmrHook
-.. autoclass:: airflow.contrib.hooks.fs_hook.FSHook
-.. autoclass:: airflow.contrib.hooks.ftp_hook.FTPHook
-.. autoclass:: airflow.contrib.hooks.ftp_hook.FTPSHook
-.. autoclass:: airflow.contrib.hooks.gcp_transfer_hook.GCPTransferServiceHook
-.. autoclass:: airflow.contrib.hooks.gcp_container_hook.GKEClusterHook
-.. autoclass:: airflow.contrib.hooks.gcp_compute_hook.GceHook
-.. autoclass:: airflow.contrib.hooks.gcp_function_hook.GcfHook
-.. autoclass:: airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook
-.. autoclass:: airflow.contrib.hooks.gcp_kms_hook.GoogleCloudKMSHook
-.. autoclass:: airflow.contrib.hooks.gcs_hook.GoogleCloudStorageHook
-.. autoclass:: airflow.contrib.hooks.imap_hook.ImapHook
-.. autoclass:: airflow.contrib.hooks.jenkins_hook.JenkinsHook
-.. autoclass:: airflow.contrib.hooks.jira_hook.JiraHook
-.. autoclass:: airflow.contrib.hooks.gcp_mlengine_hook.MLEngineHook
-.. autoclass:: airflow.contrib.hooks.mongo_hook.MongoHook
-.. autoclass:: airflow.contrib.hooks.openfaas_hook.OpenFaasHook
-.. autoclass:: airflow.contrib.hooks.pinot_hook.PinotDbApiHook
-.. autoclass:: airflow.contrib.hooks.gcp_pubsub_hook.PubSubHook
-.. autoclass:: airflow.contrib.hooks.qubole_check_hook.QuboleCheckHook
-.. autoclass:: airflow.contrib.hooks.qubole_hook.QuboleHook
-.. autoclass:: airflow.contrib.hooks.redis_hook.RedisHook
-.. autoclass:: airflow.contrib.hooks.redshift_hook.RedshiftHook
-.. autoclass:: airflow.contrib.hooks.sftp_hook.SFTPHook
-.. autoclass:: airflow.contrib.hooks.ssh_hook.SSHHook
-.. autoclass:: airflow.contrib.hooks.sagemaker_hook.SageMakerHook
-.. autoclass:: airflow.contrib.hooks.segment_hook.SegmentHook
-.. autoclass:: airflow.contrib.hooks.slack_webhook_hook.SlackWebhookHook
-.. autoclass:: airflow.contrib.hooks.snowflake_hook.SnowflakeHook
-.. autoclass:: airflow.contrib.hooks.spark_jdbc_hook.SparkJDBCHook
-.. autoclass:: airflow.contrib.hooks.spark_sql_hook.SparkSqlHook
-.. autoclass:: airflow.contrib.hooks.spark_submit_hook.SparkSubmitHook
-.. autoclass:: airflow.contrib.hooks.sqoop_hook.SqoopHook
-.. autoclass:: airflow.contrib.hooks.vertica_hook.VerticaHook
-.. autoclass:: airflow.contrib.hooks.wasb_hook.WasbHook
-.. autoclass:: airflow.contrib.hooks.winrm_hook.WinRMHook
-
-Executors
----------
-Executors are the mechanism by which task instances get run.
-
-.. autoclass:: airflow.executors.celery_executor.CeleryExecutor
-.. autoclass:: airflow.executors.local_executor.LocalExecutor
-.. autoclass:: airflow.executors.sequential_executor.SequentialExecutor
-.. autoclass:: airflow.executors.dask_executor.DaskExecutor
-
-
-Community-contributed executors
-'''''''''''''''''''''''''''''''
-
-.. autoclass:: airflow.contrib.executors.mesos_executor.MesosExecutor
-.. autoclass:: airflow.contrib.executors.kubernetes_executor.KubernetesExecutor
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 9038b89f50b1f..9877efba0df68 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -893,7 +893,7 @@ Jinja Templating
 
 Airflow leverages the power of
 `Jinja Templating <http://jinja.pocoo.org/docs/dev/>`_ and this can be a
-powerful tool to use in combination with macros (see the :ref:`macros` section).
+powerful tool to use in combination with macros (see the :doc:`macros` section).
 
 For example, say you want to pass the execution date as an environment variable
 to a Bash script using the ``BashOperator``.
diff --git a/docs/conf.py b/docs/conf.py
index cdf41b10f0fa4..b73e1cd15e609 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -113,6 +113,7 @@
     'sphinxarg.ext',
     'sphinxcontrib.httpdomain',
     'sphinx.ext.intersphinx',
+    'autoapi.extension',
 ]
 
 autodoc_default_flags = ['show-inheritance', 'members']
@@ -120,7 +121,7 @@
 viewcode_import = True
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ['templates']
 
 # The suffix of source filenames.
 source_suffix = '.rst'
@@ -158,7 +159,42 @@
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
-exclude_patterns = ['_build']
+exclude_patterns = [
+    '_api/airflow/_vendor',
+    '_api/airflow/api',
+    '_api/airflow/bin',
+    '_api/airflow/config_templates',
+    '_api/airflow/configuration',
+    '_api/airflow/contrib/auth',
+    '_api/airflow/contrib/example_dags',
+    '_api/airflow/contrib/index.rst',
+    '_api/airflow/contrib/kubernetes',
+    '_api/airflow/contrib/task_runner',
+    '_api/airflow/contrib/utils',
+    '_api/airflow/dag',
+    '_api/airflow/default_login',
+    '_api/airflow/example_dags',
+    '_api/airflow/exceptions',
+    '_api/airflow/index.rst',
+    '_api/airflow/jobs',
+    '_api/airflow/lineage',
+    '_api/airflow/logging_config',
+    '_api/airflow/macros',
+    '_api/airflow/migrations',
+    '_api/airflow/plugins_manager',
+    '_api/airflow/security',
+    '_api/airflow/settings',
+    '_api/airflow/stats',
+    '_api/airflow/task',
+    '_api/airflow/ti_deps',
+    '_api/airflow/utils',
+    '_api/airflow/version',
+    '_api/airflow/www',
+    '_api/airflow/www_rbac',
+    '_api/main',
+    '_build',
+    'autoapi_templates',
+]
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
@@ -182,7 +218,7 @@
 # modindex_common_prefix = []
 
 # If true, keep warnings as "system message" paragraphs in the built documents.
-# keep_warnings = False
+keep_warnings = True
 
 
 intersphinx_mapping = {
@@ -361,3 +397,30 @@
 
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 # texinfo_no_detailmenu = False
+
+# sphinx-autoapi configuration
+# See:
+# https://sphinx-autoapi.readthedocs.io/en/latest/config.html
+
+# Paths (relative or absolute) to the source code that you wish to generate
+# your API documentation from.
+autoapi_dirs = [
+    os.path.abspath('../airflow'),
+]
+
+# A directory that has user-defined templates to override our default templates.
+autoapi_template_dir = 'autoapi_templates'
+
+# A list of patterns to ignore when finding files
+autoapi_ignore = [
+    os.path.abspath('../airflow/contrib/operators/s3_to_gcs_transfer_operator.py'),
+    os.path.abspath('../airflow/contrib/operators/gcs_to_gcs_transfer_operator.py'),
+    os.path.abspath('../airflow/contrib/operators/gcs_to_gcs_transfer_operator.py'),
+]
+# Keep the AutoAPI generated files on the filesystem after the run.
+# Useful for debugging.
+autoapi_keep_files = False
+
+# Relative path to output the AutoAPI files into. This can also be used to place the generated documentation
+# anywhere in your documentation hierarchy.
+autoapi_root = '_api'
diff --git a/docs/howto/connection/gcp.rst b/docs/howto/connection/gcp.rst
index 942132a41a218..9f56bd4d35c75 100644
--- a/docs/howto/connection/gcp.rst
+++ b/docs/howto/connection/gcp.rst
@@ -15,6 +15,8 @@
     specific language governing permissions and limitations
     under the License.
 
+.. _howto/connection:gcp:
+
 Google Cloud Platform Connection
 ================================
 
diff --git a/docs/howto/operator/bash.rst b/docs/howto/operator/bash.rst
index 463056196ee49..9795268b58240 100644
--- a/docs/howto/operator/bash.rst
+++ b/docs/howto/operator/bash.rst
@@ -15,6 +15,8 @@
     specific language governing permissions and limitations
     under the License.
 
+.. _howto/operator:BashOperator:
+
 BashOperator
 ============
 
diff --git a/docs/howto/operator/index.rst b/docs/howto/operator/index.rst
index 647ffcc354fc6..74197a2993c10 100644
--- a/docs/howto/operator/index.rst
+++ b/docs/howto/operator/index.rst
@@ -22,7 +22,7 @@ An operator represents a single, ideally idempotent, task. Operators
 determine what actually executes when your DAG runs.
 
 See the :ref:`Operators Concepts <concepts-operators>` documentation and the
-:ref:`Operators API Reference <api-reference-operators>` for more
+:doc:`Operators API Reference <../../_api/index>` for more
 information.
 
 .. toctree::
diff --git a/docs/howto/operator/python.rst b/docs/howto/operator/python.rst
index f6aa48f0b8970..c3ef068dbaf0b 100644
--- a/docs/howto/operator/python.rst
+++ b/docs/howto/operator/python.rst
@@ -15,6 +15,8 @@
     specific language governing permissions and limitations
     under the License.
 
+.. _howto/operator:PythonOperator:
+
 PythonOperator
 ==============
 
@@ -41,8 +43,8 @@ Templating
 ^^^^^^^^^^
 
 When you set the ``provide_context`` argument to ``True``, Airflow passes in
-an additional set of keyword arguments: one for each of the :ref:`Jinja
-template variables <macros>` and a ``templates_dict`` argument.
+an additional set of keyword arguments: one for each of the :doc:`Jinja
+template variables <../../macros>` and a ``templates_dict`` argument.
 
 The ``templates_dict`` argument is templated, so each value in the dictionary
 is evaluated as a :ref:`Jinja template <jinja-templating>`.
diff --git a/docs/index.rst b/docs/index.rst
index a5f0c4503a630..beb74119f7d83 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -93,4 +93,5 @@ Content
     lineage
     changelog
     faq
-    code
+    macros
+    _api/index
diff --git a/docs/kubernetes.rst b/docs/kubernetes.rst
index 96890c738f46d..b3efd336aa060 100644
--- a/docs/kubernetes.rst
+++ b/docs/kubernetes.rst
@@ -141,9 +141,4 @@ Kubernetes Operator
                               )
 
 
-.. autoclass:: airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator
-    :noindex:
-
-
-.. autoclass:: airflow.contrib.kubernetes.secret.Secret
-    :noindex:
+See :class:`airflow.contrib.operators.kubernetes_pod_operator.KubernetesPodOperator`
diff --git a/docs/macros.rst b/docs/macros.rst
new file mode 100644
index 0000000000000..43807b0ee37a7
--- /dev/null
+++ b/docs/macros.rst
@@ -0,0 +1,118 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Macros reference
+================
+
+Variables and macros can be used in templates (see the :ref:`jinja-templating` section)
+
+The following come for free out of the box with Airflow.
+Additional custom macros can be added globally through :ref:`plugins`, or at a DAG level through the ``DAG.user_defined_macros`` argument.
+
+Default Variables
+-----------------
+The Airflow engine passes a few variables by default that are accessible
+in all templates
+
+=================================   ====================================
+Variable                            Description
+=================================   ====================================
+``{{ ds }}``                        the execution date as ``YYYY-MM-DD``
+``{{ ds_nodash }}``                 the execution date as ``YYYYMMDD``
+``{{ prev_ds }}``                   the previous execution date as ``YYYY-MM-DD``
+                                    if ``{{ ds }}`` is ``2018-01-08`` and ``schedule_interval`` is ``@weekly``,
+                                    ``{{ prev_ds }}`` will be ``2018-01-01``
+``{{ prev_ds_nodash }}``            the previous execution date as ``YYYYMMDD`` if exists, else ``None``
+``{{ next_ds }}``                   the next execution date as ``YYYY-MM-DD``
+                                    if ``{{ ds }}`` is ``2018-01-01`` and ``schedule_interval`` is ``@weekly``,
+                                    ``{{ next_ds }}`` will be ``2018-01-08``
+``{{ next_ds_nodash }}``            the next execution date as ``YYYYMMDD`` if exists, else ``None``
+``{{ yesterday_ds }}``              the day before the execution date as ``YYYY-MM-DD``
+``{{ yesterday_ds_nodash }}``       the day before the execution date as ``YYYYMMDD``
+``{{ tomorrow_ds }}``               the day after the execution date as ``YYYY-MM-DD``
+``{{ tomorrow_ds_nodash }}``        the day after the execution date as ``YYYYMMDD``
+``{{ ts }}``                        same as ``execution_date.isoformat()``. Example: ``2018-01-01T00:00:00+00:00``
+``{{ ts_nodash }}``                 same as ``ts`` without ``-``, ``:`` and TimeZone info. Example: ``20180101T000000``
+``{{ ts_nodash_with_tz }}``         same as ``ts`` without ``-`` and ``:``. Example: ``20180101T000000+0000``
+``{{ execution_date }}``            the execution_date (pendulum.Pendulum)
+``{{ prev_execution_date }}``       the previous execution date (if available) (pendulum.Pendulum)
+``{{ next_execution_date }}``       the next execution date (pendulum.Pendulum)
+``{{ dag }}``                       the DAG object
+``{{ task }}``                      the Task object
+``{{ macros }}``                    a reference to the macros package, described below
+``{{ task_instance }}``             the task_instance object
+``{{ end_date }}``                  same as ``{{ ds }}``
+``{{ latest_date }}``               same as ``{{ ds }}``
+``{{ ti }}``                        same as ``{{ task_instance }}``
+``{{ params }}``                    a reference to the user-defined params dictionary which can be overridden by
+                                    the dictionary passed through ``trigger_dag -c`` if you enabled
+                                    ``dag_run_conf_overrides_params` in ``airflow.cfg``
+``{{ var.value.my_var }}``          global defined variables represented as a dictionary
+``{{ var.json.my_var.path }}``      global defined variables represented as a dictionary
+                                    with deserialized JSON object, append the path to the
+                                    key within the JSON object
+``{{ task_instance_key_str }}``     a unique, human-readable key to the task instance
+                                    formatted ``{dag_id}_{task_id}_{ds}``
+``{{ conf }}``                      the full configuration object located at
+                                    ``airflow.configuration.conf`` which
+                                    represents the content of your
+                                    ``airflow.cfg``
+``{{ run_id }}``                    the ``run_id`` of the current DAG run
+``{{ dag_run }}``                   a reference to the DagRun object
+``{{ test_mode }}``                 whether the task instance was called using
+                                    the CLI's test subcommand
+=================================   ====================================
+
+Note that you can access the object's attributes and methods with simple
+dot notation. Here are some examples of what is possible:
+``{{ task.owner }}``, ``{{ task.task_id }}``, ``{{ ti.hostname }}``, ...
+Refer to the models documentation for more information on the objects'
+attributes and methods.
+
+The ``var`` template variable allows you to access variables defined in Airflow's
+UI. You can access them as either plain-text or JSON. If you use JSON, you are
+also able to walk nested structures, such as dictionaries like:
+``{{ var.json.my_dict_var.key1 }}``
+
+Macros
+------
+Macros are a way to expose objects to your templates and live under the
+``macros`` namespace in your templates.
+
+A few commonly used libraries and methods are made available.
+
+
+=================================   ==============================================
+Variable                            Description
+=================================   ==============================================
+``macros.datetime``                 The standard lib's :class:`datetime.datetime`
+``macros.timedelta``                The standard lib's :class:`datetime.datetime`
+``macros.dateutil``                 A reference to the ``dateutil`` package
+``macros.time``                     The standard lib's :class:`datetime.time`
+``macros.uuid``                     The standard lib's :mod:`uuid`
+``macros.random``                   The standard lib's :mod:`random`
+=================================   ==============================================
+
+
+Some airflow specific macros are also defined:
+
+.. automodule:: airflow.macros
+    :show-inheritance:
+    :members:
+
+.. autofunction:: airflow.macros.hive.closest_ds_partition
+.. autofunction:: airflow.macros.hive.max_partition
diff --git a/docs/_templates/layout.html b/docs/templates/layout.html
similarity index 100%
rename from docs/_templates/layout.html
rename to docs/templates/layout.html
diff --git a/docs/tutorial.rst b/docs/tutorial.rst
index aa64cb859c224..fd4d67f0ac828 100644
--- a/docs/tutorial.rst
+++ b/docs/tutorial.rst
@@ -260,7 +260,7 @@ regarding custom filters have a look at the
 `Jinja Documentation <http://jinja.pocoo.org/docs/dev/api/#writing-filters>`_
 
 For more information on the variables and macros that can be referenced
-in templates, make sure to read through the :ref:`macros` section
+in templates, make sure to read through the :doc:`macros`
 
 Setting up Dependencies
 -----------------------
diff --git a/setup.py b/setup.py
index 159f478eb6e09..dba753593df6f 100644
--- a/setup.py
+++ b/setup.py
@@ -157,11 +157,12 @@ def write_version(filename=os.path.join(*['airflow',
 databricks = ['requests>=2.20.0, <3']
 datadog = ['datadog>=0.14.0']
 doc = [
-    'sphinx>=1.2.3',
     'sphinx-argparse>=0.1.13',
+    'sphinx-autoapi>=0.7.1',
+    'Sphinx-PyPI-upload>=0.2.1',
     'sphinx-rtd-theme>=0.1.6',
+    'sphinx>=1.2.3',
     'sphinxcontrib-httpdomain>=1.7.0',
-    'Sphinx-PyPI-upload>=0.2.1'
 ]
 docker = ['docker~=3.0']
 druid = ['pydruid>=0.4.1']

From 83bcebbc09658ca2438621228ffbd8fdaec8f70e Mon Sep 17 00:00:00 2001
From: Chao-Han Tsai <milton0825@gmail.com>
Date: Fri, 29 Mar 2019 02:59:30 -0700
Subject: [PATCH 757/808] [AIRFLOW-XXX] fix check docs failure on CI (#4998)

---
 docs/concepts.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/concepts.rst b/docs/concepts.rst
index 9877efba0df68..7be294b447949 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -432,7 +432,7 @@ passed, then a corresponding list of XCom values is returned.
 It is also possible to pull XCom directly in a template, here's an example
 of what this may look like:
 
-.. code:: sql
+.. code:: jinja
 
     SELECT * FROM {{ task_instance.xcom_pull(task_ids='foo', key='table_name') }}
 

From e118d4db00931bf1d2689662b2fb79d8d37cee0e Mon Sep 17 00:00:00 2001
From: zingorn <zingorn@gmail.com>
Date: Wed, 27 Mar 2019 18:40:01 +0200
Subject: [PATCH 758/808] [AIRFLOW-3417] ECSOperator: pass platformVersion only
 for FARGATE launch type (#4256)

---
 airflow/contrib/operators/ecs_operator.py    |  4 +-
 tests/contrib/operators/test_ecs_operator.py | 72 ++++++++++++--------
 2 files changed, 46 insertions(+), 30 deletions(-)

diff --git a/airflow/contrib/operators/ecs_operator.py b/airflow/contrib/operators/ecs_operator.py
index 55732b21e5ac8..2f7d8c20013e4 100644
--- a/airflow/contrib/operators/ecs_operator.py
+++ b/airflow/contrib/operators/ecs_operator.py
@@ -100,8 +100,10 @@ def execute(self, context):
             'overrides': self.overrides,
             'startedBy': self.owner,
             'launchType': self.launch_type,
-            'platformVersion': self.platform_version,
         }
+
+        if self.launch_type == 'FARGATE':
+            run_opts['platformVersion'] = self.platform_version
         if self.group is not None:
             run_opts['group'] = self.group
         if self.placement_constraints is not None:
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index 348876d2ca8d8..5bb52fce4efce 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -22,6 +22,8 @@
 import unittest
 from copy import deepcopy
 
+from parameterized import parameterized
+
 from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.contrib.operators.ecs_operator import ECSOperator
@@ -63,26 +65,26 @@ def setUp(self, aws_hook_mock):
         configuration.load_test_config()
 
         self.aws_hook_mock = aws_hook_mock
-        self.ecs = ECSOperator(
-            task_id='task',
-            task_definition='t',
-            cluster='c',
-            overrides={},
-            aws_conn_id=None,
-            region_name='eu-west-1',
-            group='group',
-            placement_constraints=[
-                {
-                    'expression': 'attribute:ecs.instance-type =~ t2.*',
-                    'type': 'memberOf'
-                }
-            ],
-            network_configuration={
+        self.ecs_operator_args = {
+            'task_id': 'task',
+            'task_definition': 't',
+            'cluster': 'c',
+            'overrides': {},
+            'aws_conn_id': None,
+            'region_name': 'eu-west-1',
+            'group': 'group',
+            'placement_constraints': [{
+                'expression': 'attribute:ecs.instance-type =~ t2.*',
+                'type': 'memberOf'
+            }],
+            'network_configuration': {
                 'awsvpcConfiguration': {
-                    'securityGroups': ['sg-123abc']
+                    'securityGroups': ['sg-123abc'],
+                    'subnets': ['subnet-123456ab']
                 }
             }
-        )
+        }
+        self.ecs = ECSOperator(**self.ecs_operator_args)
 
     def test_init(self):
         self.assertEqual(self.ecs.region_name, 'eu-west-1')
@@ -97,19 +99,30 @@ def test_init(self):
     def test_template_fields_overrides(self):
         self.assertEqual(self.ecs.template_fields, ('overrides',))
 
+    @parameterized.expand([
+        ['EC2'],
+        ['FARGATE']
+    ])
     @mock.patch.object(ECSOperator, '_wait_for_task_ended')
     @mock.patch.object(ECSOperator, '_check_success_task')
-    def test_execute_without_failures(self, check_mock, wait_mock):
-        client_mock = self.aws_hook_mock.return_value.get_client_type.return_value
+    @mock.patch('airflow.contrib.operators.ecs_operator.AwsHook')
+    def test_execute_without_failures(self, launch_type, aws_hook_mock,
+                                      check_mock, wait_mock):
+        client_mock = aws_hook_mock.return_value.get_client_type.return_value
         client_mock.run_task.return_value = RESPONSE_WITHOUT_FAILURES
 
-        self.ecs.execute(None)
+        ecs = ECSOperator(launch_type=launch_type, **self.ecs_operator_args)
+        ecs.execute(None)
+
+        aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs',
+                                                                           region_name='eu-west-1')
+        extend_args = {}
+        if launch_type == 'FARGATE':
+            extend_args['platformVersion'] = 'LATEST'
 
-        self.aws_hook_mock.return_value.get_client_type.assert_called_once_with('ecs',
-                                                                                region_name='eu-west-1')
         client_mock.run_task.assert_called_once_with(
             cluster='c',
-            launchType='EC2',
+            launchType=launch_type,
             overrides={},
             startedBy=mock.ANY,  # Can by 'airflow' or 'Airflow'
             taskDefinition='t',
@@ -120,17 +133,18 @@ def test_execute_without_failures(self, check_mock, wait_mock):
                     'type': 'memberOf'
                 }
             ],
-            platformVersion='LATEST',
             networkConfiguration={
                 'awsvpcConfiguration': {
-                    'securityGroups': ['sg-123abc']
+                    'securityGroups': ['sg-123abc'],
+                    'subnets': ['subnet-123456ab']
                 }
-            }
+            },
+            **extend_args
         )
 
         wait_mock.assert_called_once_with()
         check_mock.assert_called_once_with()
-        self.assertEqual(self.ecs.arn,
+        self.assertEqual(ecs.arn,
                          'arn:aws:ecs:us-east-1:012345678910:task/d8c67b3c-ac87-4ffe-a847-4785bc3a8b55')
 
     def test_execute_with_failures(self):
@@ -157,10 +171,10 @@ def test_execute_with_failures(self):
                     'type': 'memberOf'
                 }
             ],
-            platformVersion='LATEST',
             networkConfiguration={
                 'awsvpcConfiguration': {
-                    'securityGroups': ['sg-123abc']
+                    'securityGroups': ['sg-123abc'],
+                    'subnets': ['subnet-123456ab'],
                 }
             }
         )

From 296ce48aa1edd9fcc7a8434a554fbfdae813999e Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Mon, 21 Jan 2019 06:12:38 -0500
Subject: [PATCH 759/808] [AIRFLOW-3383] Rotate fernet keys. (#4225)

Add the ability to change the encryption key of all encrypted variables and
connections
---
 airflow/bin/cli.py           |  20 ++++++-
 airflow/models/__init__.py   |  12 +++-
 airflow/models/connection.py |   7 +++
 tests/models.py              | 105 +++++++++++++++++++++++++++++++++--
 4 files changed, 135 insertions(+), 9 deletions(-)

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index af88f2ca2c921..ae6cc14fb2891 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -602,6 +602,17 @@ def next_execution(args):
         print(None)
 
 
+@cli_utils.action_logging
+def rotate_fernet_key(args):
+    session = settings.Session()
+    for conn in session.query(Connection).filter(
+            Connection.is_encrypted | Connection.is_extra_encrypted):
+        conn.rotate_fernet_key()
+    for var in session.query(Variable).filter(Variable.is_encrypted):
+        var.rotate_fernet_key()
+    session.commit()
+
+
 @cli_utils.action_logging
 def list_dags(args):
     dagbag = DagBag(process_subdir(args.subdir))
@@ -2110,7 +2121,14 @@ class CLIFactory(object):
             'func': next_execution,
             'help': "Get the next execution datetime of a DAG.",
             'args': ('dag_id', 'subdir')
-        }
+        },
+        {
+            'func': rotate_fernet_key,
+            'help': 'Rotate all encrypted connection credentials and variables; see '
+                    'https://airflow.readthedocs.io/en/stable/howto/secure-connections.html'
+                    '#rotating-encryption-keys.',
+            'args': (),
+        },
     )
     subparsers_dict = {sp['func'].__name__: sp for sp in subparsers}
     dag_subparsers = (
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 58feb4cbb90c5..926ac253958e4 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -164,7 +164,7 @@ def get_fernet():
     if _fernet:
         return _fernet
     try:
-        from cryptography.fernet import Fernet, InvalidToken
+        from cryptography.fernet import Fernet, MultiFernet, InvalidToken
         global InvalidFernetToken
         InvalidFernetToken = InvalidToken
 
@@ -183,7 +183,10 @@ def get_fernet():
             )
             _fernet = NullFernet()
         else:
-            _fernet = Fernet(fernet_key.encode('utf-8'))
+            _fernet = MultiFernet([
+                Fernet(fernet_part.encode('utf-8'))
+                for fernet_part in fernet_key.split(',')
+            ])
             _fernet.is_encrypted = True
     except (ValueError, TypeError) as ve:
         raise AirflowException("Could not create Fernet object: {}".format(ve))
@@ -4497,6 +4500,11 @@ def set(cls, key, value, serialize_json=False, session=None):
         session.add(Variable(key=key, val=stored_value))
         session.flush()
 
+    def rotate_fernet_key(self):
+        fernet = get_fernet()
+        if self._val and self.is_encrypted:
+            self._val = fernet.rotate(self._val.encode('utf-8')).decode()
+
 
 class XCom(Base, LoggingMixin):
     """
diff --git a/airflow/models/connection.py b/airflow/models/connection.py
index 633baaadad57d..e4fffff780fc1 100644
--- a/airflow/models/connection.py
+++ b/airflow/models/connection.py
@@ -177,6 +177,13 @@ def extra(cls):
         return synonym('_extra',
                        descriptor=property(cls.get_extra, cls.set_extra))
 
+    def rotate_fernet_key(self):
+        fernet = get_fernet()
+        if self._password and self.is_encrypted:
+            self._password = fernet.rotate(self._password.encode('utf-8')).decode()
+        if self._extra and self.is_extra_encrypted:
+            self._extra = fernet.rotate(self._extra.encode('utf-8')).decode()
+
     def get_hook(self):
         try:
             if self.conn_type == 'mysql':
diff --git a/tests/models.py b/tests/models.py
index 848166c1d9214..1ef149f195491 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -40,6 +40,7 @@
 from mock import ANY, Mock, mock_open, patch
 from parameterized import parameterized
 from freezegun import freeze_time
+from cryptography.fernet import Fernet
 
 from airflow import AirflowException, configuration, models, settings
 from airflow.contrib.sensors.python_sensor import PythonSensor
@@ -51,6 +52,7 @@
 from airflow.models import SkipMixin
 from airflow.models import State as ST
 from airflow.models import XCom
+from airflow.models import Variable
 from airflow.models import clear_task_instances
 from airflow.models.connection import Connection
 from airflow.models.taskreschedule import TaskReschedule
@@ -3289,27 +3291,118 @@ def test_xcom_get_many(self):
             self.assertEqual(result.value, json_obj)
 
 
+class VariableTest(unittest.TestCase):
+    def setUp(self):
+        models._fernet = None
+
+    def tearDown(self):
+        models._fernet = None
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_variable_no_encryption(self, mock_get):
+        """
+        Test variables without encryption
+        """
+        mock_get.return_value = ''
+        Variable.set('key', 'value')
+        session = settings.Session()
+        test_var = session.query(Variable).filter(Variable.key == 'key').one()
+        self.assertFalse(test_var.is_encrypted)
+        self.assertEqual(test_var.val, 'value')
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_variable_with_encryption(self, mock_get):
+        """
+        Test variables with encryption
+        """
+        mock_get.return_value = Fernet.generate_key().decode()
+        Variable.set('key', 'value')
+        session = settings.Session()
+        test_var = session.query(Variable).filter(Variable.key == 'key').one()
+        self.assertTrue(test_var.is_encrypted)
+        self.assertEqual(test_var.val, 'value')
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_var_with_encryption_rotate_fernet_key(self, mock_get):
+        """
+        Tests rotating encrypted variables.
+        """
+        key1 = Fernet.generate_key()
+        key2 = Fernet.generate_key()
+
+        mock_get.return_value = key1.decode()
+        Variable.set('key', 'value')
+        session = settings.Session()
+        test_var = session.query(Variable).filter(Variable.key == 'key').one()
+        self.assertTrue(test_var.is_encrypted)
+        self.assertEqual(test_var.val, 'value')
+        self.assertEqual(Fernet(key1).decrypt(test_var._val.encode()), b'value')
+
+        # Test decrypt of old value with new key
+        mock_get.return_value = ','.join([key2.decode(), key1.decode()])
+        models._fernet = None
+        self.assertEqual(test_var.val, 'value')
+
+        # Test decrypt of new value with new key
+        test_var.rotate_fernet_key()
+        self.assertTrue(test_var.is_encrypted)
+        self.assertEqual(test_var.val, 'value')
+        self.assertEqual(Fernet(key2).decrypt(test_var._val.encode()), b'value')
+
+
 class ConnectionTest(unittest.TestCase):
-    @patch.object(configuration, 'get')
+    def setUp(self):
+        models._fernet = None
+
+    def tearDown(self):
+        models._fernet = None
+
+    @patch('airflow.models.configuration.conf.get')
     def test_connection_extra_no_encryption(self, mock_get):
         """
         Tests extras on a new connection without encryption. The fernet key
         is set to a non-base64-encoded string and the extra is stored without
         encryption.
         """
+        mock_get.return_value = ''
         test_connection = Connection(extra='testextra')
+        self.assertFalse(test_connection.is_extra_encrypted)
         self.assertEqual(test_connection.extra, 'testextra')
 
-    @patch.object(configuration, 'get')
+    @patch('airflow.models.configuration.conf.get')
     def test_connection_extra_with_encryption(self, mock_get):
         """
-        Tests extras on a new connection with encryption. The fernet key
-        is set to a base64 encoded string and the extra is encrypted.
+        Tests extras on a new connection with encryption.
+        """
+        mock_get.return_value = Fernet.generate_key().decode()
+        test_connection = Connection(extra='testextra')
+        self.assertTrue(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_connection_extra_with_encryption_rotate_fernet_key(self, mock_get):
+        """
+        Tests rotating encrypted extras.
         """
-        # 'dGVzdA==' is base64 encoded 'test'
-        mock_get.return_value = 'dGVzdA=='
+        key1 = Fernet.generate_key()
+        key2 = Fernet.generate_key()
+
+        mock_get.return_value = key1.decode()
         test_connection = Connection(extra='testextra')
+        self.assertTrue(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+        self.assertEqual(Fernet(key1).decrypt(test_connection._extra.encode()), b'testextra')
+
+        # Test decrypt of old value with new key
+        mock_get.return_value = ','.join([key2.decode(), key1.decode()])
+        models._fernet = None
+        self.assertEqual(test_connection.extra, 'testextra')
+
+        # Test decrypt of new value with new key
+        test_connection.rotate_fernet_key()
+        self.assertTrue(test_connection.is_extra_encrypted)
         self.assertEqual(test_connection.extra, 'testextra')
+        self.assertEqual(Fernet(key2).decrypt(test_connection._extra.encode()), b'testextra')
 
     def test_connection_from_uri_without_extras(self):
         uri = 'scheme://user:password@host%2flocation:1234/schema'

From 5ce4a3ed5082ef5abce51101f8de38178016748a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Wed, 20 Mar 2019 15:44:48 +0100
Subject: [PATCH 760/808] [AIRFLOW-3615] Preserve case of UNIX socket paths in
 Connections (#4591)

---
 airflow/models/connection.py |  17 +++++-
 tests/models.py              | 101 +++++++++++++++++++++++++++++++++++
 2 files changed, 116 insertions(+), 2 deletions(-)

diff --git a/airflow/models/connection.py b/airflow/models/connection.py
index e4fffff780fc1..1ac53553a9609 100644
--- a/airflow/models/connection.py
+++ b/airflow/models/connection.py
@@ -31,6 +31,20 @@
 from airflow.models.base import Base, ID_LEN
 
 
+# Python automatically converts all letters to lowercase in hostname
+# See: https://issues.apache.org/jira/browse/AIRFLOW-3615
+def parse_netloc_to_hostname(uri_parts):
+    hostname = unquote(uri_parts.hostname or '')
+    if '/' in hostname:
+        hostname = uri_parts.netloc
+        if "@" in hostname:
+            hostname = hostname.rsplit("@", 1)[1]
+        if ":" in hostname:
+            hostname = hostname.split(":", 1)[0]
+        hostname = unquote(hostname)
+    return hostname
+
+
 class Connection(Base, LoggingMixin):
     """
     Placeholder to store information about different database instances
@@ -112,14 +126,13 @@ def __init__(
 
     def parse_from_uri(self, uri):
         uri_parts = urlparse(uri)
-        hostname = uri_parts.hostname or ''
         conn_type = uri_parts.scheme
         if conn_type == 'postgresql':
             conn_type = 'postgres'
         elif '-' in conn_type:
             conn_type = conn_type.replace('-', '_')
         self.conn_type = conn_type
-        self.host = unquote(hostname) if hostname else hostname
+        self.host = parse_netloc_to_hostname(uri_parts)
         quoted_schema = uri_parts.path[1:]
         self.schema = unquote(quoted_schema) if quoted_schema else quoted_schema
         self.login = unquote(uri_parts.username) \
diff --git a/tests/models.py b/tests/models.py
index 1ef149f195491..2406d4aff47e2 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -33,6 +33,7 @@
 import urllib
 import uuid
 import shutil
+from collections import namedtuple
 from tempfile import NamedTemporaryFile, mkdtemp
 
 import pendulum
@@ -3350,6 +3351,9 @@ def test_var_with_encryption_rotate_fernet_key(self, mock_get):
         self.assertEqual(Fernet(key2).decrypt(test_var._val.encode()), b'value')
 
 
+ConnectionParts = namedtuple("ConnectionParts", ["conn_type", "login", "password", "host", "port", "schema"])
+
+
 class ConnectionTest(unittest.TestCase):
     def setUp(self):
         models._fernet = None
@@ -3498,6 +3502,103 @@ def test_connection_from_uri_with_underscore(self):
             extra__google_cloud_platform__scope='https://www.googleapis.com/'
                                                 'auth/cloud-platform'))
 
+    def test_connection_from_uri_without_authinfo(self):
+        uri = 'scheme://host:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_path(self):
+        uri = 'scheme://%2FTmP%2F:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, '/TmP/')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.port, 1234)
+
+    @parameterized.expand(
+        [
+            (
+                "http://:password@host:80/database",
+                ConnectionParts(
+                    conn_type="http", login='', password="password", host="host", port=80, schema="database"
+                ),
+            ),
+            (
+                "http://user:@host:80/database",
+                ConnectionParts(
+                    conn_type="http", login="user", password=None, host="host", port=80, schema="database"
+                ),
+            ),
+            (
+                "http://user:password@/database",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="", port=None, schema="database"
+                ),
+            ),
+            (
+                "http://user:password@host:80/",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="host", port=80, schema=""
+                ),
+            ),
+            (
+                "http://user:password@/",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="", port=None, schema=""
+                ),
+            ),
+            (
+                "postgresql://user:password@%2Ftmp%2Fz6rqdzqh%2Fexample%3Awest1%3Atestdb/testdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login="user",
+                    password="password",
+                    host="/tmp/z6rqdzqh/example:west1:testdb",
+                    port=None,
+                    schema="testdb",
+                ),
+            ),
+            (
+                "postgresql://user@%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb/testdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login="user",
+                    password=None,
+                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
+                    port=None,
+                    schema="testdb",
+                ),
+            ),
+            (
+                "postgresql://%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login=None,
+                    password=None,
+                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
+                    port=None,
+                    schema="",
+                ),
+            ),
+        ]
+    )
+    def test_connection_from_with_auth_info(self, uri, uri_parts):
+        connection = Connection(uri=uri)
+
+        self.assertEqual(connection.conn_type, uri_parts.conn_type)
+        self.assertEqual(connection.login, uri_parts.login)
+        self.assertEqual(connection.password, uri_parts.password)
+        self.assertEqual(connection.host, uri_parts.host)
+        self.assertEqual(connection.port, uri_parts.port)
+        self.assertEqual(connection.schema, uri_parts.schema)
+
 
 class TestSkipMixin(unittest.TestCase):
 

From 5edfefedbcfc18fe0d9148eac8858a57f9b8cf8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Mon, 4 Mar 2019 14:50:32 +0100
Subject: [PATCH 761/808] [AIRFLOW-XXX] Add contents to cli (#4825)

---
 docs/cli.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/cli.rst b/docs/cli.rst
index 4d68d0eef3b8d..0c0a67454b297 100644
--- a/docs/cli.rst
+++ b/docs/cli.rst
@@ -22,6 +22,10 @@ Airflow has a very rich command line interface that allows for
 many types of operation on a DAG, starting services, and supporting
 development and testing.
 
+.. contents:: Content
+    :local:
+    :depth: 2
+
 .. argparse::
    :module: airflow.bin.cli
    :func: get_parser

From b1cb667de86fbbc8196aca048485c6a11b979fef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Mon, 4 Mar 2019 14:56:55 +0100
Subject: [PATCH 762/808] [AIRFLOW-4000] Return response when no file (#4822)

---
 airflow/www_rbac/views.py    | 2 ++
 tests/www_rbac/test_views.py | 5 +++++
 2 files changed, 7 insertions(+)

diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index ad6042ce348c6..6148ff8cccafa 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -2092,7 +2092,9 @@ def varimport(self):
             else:
                 d = json.loads(out)
         except Exception:
+            self.update_redirect()
             flash("Missing file or syntax error.", 'error')
+            return redirect(self.get_redirect())
         else:
             suc_count = fail_count = 0
             for k, v in d.items():
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 809193cdeb91a..7078103b1574c 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -183,6 +183,11 @@ def test_xss_prevention(self):
         self.assertNotIn("<img src='' onerror='alert(1);'>",
                          resp.data.decode("utf-8"))
 
+    def test_import_variables_no_file(self):
+        resp = self.client.post('/variable/varimport',
+                                follow_redirects=True)
+        self.check_content_in_response('Missing file or syntax error.', resp)
+
     def test_import_variables_failed(self):
         content = '{"str_key": "str_value"}'
 

From 691d06927ba1000592c673dfba2e2b417f3101de Mon Sep 17 00:00:00 2001
From: Jiajie Zhong <zhongjiajie955@hotmail.com>
Date: Sat, 30 Mar 2019 00:50:35 +0800
Subject: [PATCH 763/808] [AIRFLOW-1526] Add dingding hook and operator (#4895)

Dingding is popular team collaboration tools talk
just like Slack. This PR is add it to master, could
help us easy send message to Dingding.

Add how to operator dingding section tell users
how to send different kind of dingding message or
how to use dingding as callback funtion in DAG
and add example to show how to use.

Set operator UI color as dingding icon color
---
 .../example_dags/example_dingding_operator.py | 223 ++++++++++++++
 airflow/contrib/hooks/dingding_hook.py        | 133 +++++++++
 .../contrib/operators/dingding_operator.py    |  74 +++++
 airflow/utils/db.py                           |   4 +
 docs/howto/operator/dingding.rst              |  91 ++++++
 docs/howto/operator/index.rst                 |   3 +-
 tests/contrib/hooks/test_dingding_hook.py     | 278 ++++++++++++++++++
 .../operators/test_dingding_operator.py       |  71 +++++
 8 files changed, 876 insertions(+), 1 deletion(-)
 create mode 100644 airflow/contrib/example_dags/example_dingding_operator.py
 create mode 100644 airflow/contrib/hooks/dingding_hook.py
 create mode 100644 airflow/contrib/operators/dingding_operator.py
 create mode 100644 docs/howto/operator/dingding.rst
 create mode 100644 tests/contrib/hooks/test_dingding_hook.py
 create mode 100644 tests/contrib/operators/test_dingding_operator.py

diff --git a/airflow/contrib/example_dags/example_dingding_operator.py b/airflow/contrib/example_dags/example_dingding_operator.py
new file mode 100644
index 0000000000000..c6d8cca6fdaad
--- /dev/null
+++ b/airflow/contrib/example_dags/example_dingding_operator.py
@@ -0,0 +1,223 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from datetime import timedelta
+
+import airflow
+from airflow.contrib.operators.dingding_operator import DingdingOperator
+from airflow.models import DAG
+
+args = {
+    'owner': 'airflow',
+    'retries': 3,
+    'start_date': airflow.utils.dates.days_ago(2),
+}
+
+
+# [START howto_operator_dingding_failure_callback]
+def failure_callback(context):
+    message = 'AIRFLOW TASK FAILURE TIPS:\n' \
+              'DAG:    {}\n' \
+              'TASKS:  {}\n' \
+              'Reason: {}\n' \
+        .format(context['task_instance'].dag_id,
+                context['task_instance'].task_id,
+                context['exception'])
+    return DingdingOperator(
+        task_id='dingding_success_callback',
+        dingding_conn_id='dingding_default',
+        message_type='text',
+        message=message,
+        at_all=True,
+    ).execute(context)
+
+
+args['on_failure_callback'] = failure_callback
+# [END howto_operator_dingding_failure_callback]
+
+dag = DAG(
+    dag_id='example_dingding_operator',
+    default_args=args,
+    schedule_interval='@once',
+    dagrun_timeout=timedelta(minutes=60),
+)
+
+# [START howto_operator_dingding]
+text_msg_remind_none = DingdingOperator(
+    task_id='text_msg_remind_none',
+    dingding_conn_id='dingding_default',
+    message_type='text',
+    message='Airflow dingding text message remind none',
+    at_mobiles=None,
+    at_all=False,
+    dag=dag,
+)
+# [END howto_operator_dingding]
+
+text_msg_remind_specific = DingdingOperator(
+    task_id='text_msg_remind_specific',
+    dingding_conn_id='dingding_default',
+    message_type='text',
+    message='Airflow dingding text message remind specific users',
+    at_mobiles=['156XXXXXXXX', '130XXXXXXXX'],
+    at_all=False,
+    dag=dag,
+)
+
+text_msg_remind_include_invalid = DingdingOperator(
+    task_id='text_msg_remind_include_invalid',
+    dingding_conn_id='dingding_default',
+    message_type='text',
+    message='Airflow dingding text message remind users including invalid',
+    # 123 is invalid user or user not in the group
+    at_mobiles=['156XXXXXXXX', '123'],
+    at_all=False,
+    dag=dag,
+)
+
+# [START howto_operator_dingding_remind_users]
+text_msg_remind_all = DingdingOperator(
+    task_id='text_msg_remind_all',
+    dingding_conn_id='dingding_default',
+    message_type='text',
+    message='Airflow dingding text message remind all users in group',
+    # list of user phone/email here in the group
+    # when at_all is specific will cover at_mobiles
+    at_mobiles=['156XXXXXXXX', '130XXXXXXXX'],
+    at_all=True,
+    dag=dag,
+)
+# [END howto_operator_dingding_remind_users]
+
+link_msg = DingdingOperator(
+    task_id='link_msg',
+    dingding_conn_id='dingding_default',
+    message_type='link',
+    message={
+        'title': 'Airflow dingding link message',
+        'text': 'Airflow official documentation link',
+        'messageUrl': 'http://airflow.apache.org',
+        'picURL': 'http://airflow.apache.org/_images/pin_large.png'
+    },
+    dag=dag,
+)
+
+# [START howto_operator_dingding_rich_text]
+markdown_msg = DingdingOperator(
+    task_id='markdown_msg',
+    dingding_conn_id='dingding_default',
+    message_type='markdown',
+    message={
+        'title': 'Airflow dingding markdown message',
+        'text': '# Markdown message title\n'
+                'content content .. \n'
+                '### sub-title\n'
+                '![logo](http://airflow.apache.org/_images/pin_large.png)'
+    },
+    at_mobiles=['156XXXXXXXX'],
+    at_all=False,
+    dag=dag,
+)
+# [END howto_operator_dingding_rich_text]
+
+single_action_card_msg = DingdingOperator(
+    task_id='single_action_card_msg',
+    dingding_conn_id='dingding_default',
+    message_type='actionCard',
+    message={
+        'title': 'Airflow dingding single actionCard message',
+        'text': 'Airflow dingding single actionCard message\n'
+                '![logo](http://airflow.apache.org/_images/pin_large.png)\n'
+                'This is a official logo in Airflow website.',
+        'hideAvatar': '0',
+        'btnOrientation': '0',
+        'singleTitle': 'read more',
+        'singleURL': 'http://airflow.apache.org'
+    },
+    dag=dag,
+)
+
+multi_action_card_msg = DingdingOperator(
+    task_id='multi_action_card_msg',
+    dingding_conn_id='dingding_default',
+    message_type='actionCard',
+    message={
+        'title': 'Airflow dingding multi actionCard message',
+        'text': 'Airflow dingding multi actionCard message\n'
+                '![logo](http://airflow.apache.org/_images/pin_large.png)\n'
+                'Airflow documentation and github',
+        'hideAvatar': '0',
+        'btnOrientation': '0',
+        'btns': [
+            {
+                'title': 'Airflow Documentation',
+                'actionURL': 'http://airflow.apache.org'
+            },
+            {
+                'title': 'Airflow Github',
+                'actionURL': 'https://github.com/apache/airflow'
+            }
+        ]
+    },
+    dag=dag,
+)
+
+feed_card_msg = DingdingOperator(
+    task_id='feed_card_msg',
+    dingding_conn_id='dingding_default',
+    message_type='feedCard',
+    message={
+        "links": [
+            {
+                "title": "Airflow DAG feed card",
+                "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                "picURL": "http://airflow.apache.org/_images/dags.png"
+            },
+            {
+                "title": "Airflow tree feed card",
+                "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                "picURL": "http://airflow.apache.org/_images/tree.png"
+            },
+            {
+                "title": "Airflow graph feed card",
+                "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                "picURL": "http://airflow.apache.org/_images/graph.png"
+            }
+        ]
+    },
+    dag=dag,
+)
+
+msg_failure_callback = DingdingOperator(
+    task_id='msg_failure_callback',
+    dingding_conn_id='dingding_default',
+    message_type='not_support_msg_type',
+    message="",
+    dag=dag,
+)
+
+[
+    text_msg_remind_none,
+    text_msg_remind_specific,
+    text_msg_remind_include_invalid,
+    text_msg_remind_all
+] >> link_msg >> markdown_msg >> [
+    single_action_card_msg,
+    multi_action_card_msg
+] >> feed_card_msg >> msg_failure_callback
diff --git a/airflow/contrib/hooks/dingding_hook.py b/airflow/contrib/hooks/dingding_hook.py
new file mode 100644
index 0000000000000..1da373a8fb940
--- /dev/null
+++ b/airflow/contrib/hooks/dingding_hook.py
@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+
+import requests
+
+from airflow import AirflowException
+from airflow.hooks.http_hook import HttpHook
+
+
+class DingdingHook(HttpHook):
+    """
+    This hook allows you send Dingding message using Dingding custom bot.
+    Get Dingding token from conn_id.password. And prefer set domain to
+    conn_id.host, if not will use default ``https://oapi.dingtalk.com``.
+
+    For more detail message in
+    `Dingding custom bot <https://open-doc.dingtalk.com/microapp/serverapi2/qf2nxq>`_
+
+    :param dingding_conn_id: The name of the Dingding connection to use
+    :type dingding_conn_id: str
+    :param message_type: Message type you want to send to Dingding, support five type so far
+        including text, link, markdown, actionCard, feedCard
+    :type message_type: str
+    :param message: The message send to Dingding chat group
+    :type message: str or dict
+    :param at_mobiles: Remind specific users with this message
+    :type at_mobiles: list[str]
+    :param at_all: Remind all people in group or not. If True, will overwrite ``at_mobiles``
+    :type at_all: bool
+    """
+
+    def __init__(self,
+                 dingding_conn_id='dingding_default',
+                 message_type='text',
+                 message=None,
+                 at_mobiles=None,
+                 at_all=False,
+                 *args,
+                 **kwargs
+                 ):
+        super(DingdingHook, self).__init__(http_conn_id=dingding_conn_id, *args, **kwargs)
+        self.message_type = message_type
+        self.message = message
+        self.at_mobiles = at_mobiles
+        self.at_all = at_all
+
+    def _get_endpoint(self):
+        """
+        Get Dingding endpoint for sending message.
+        """
+        conn = self.get_connection(self.http_conn_id)
+        token = conn.password
+        if not token:
+            raise AirflowException('Dingding token is requests but get nothing, '
+                                   'check you conn_id configuration.')
+        return 'robot/send?access_token={}'.format(token)
+
+    def _build_message(self):
+        """
+        Build different type of Dingding message
+        As most commonly used type, text message just need post message content
+        rather than a dict like ``{'content': 'message'}``
+        """
+        if self.message_type in ['text', 'markdown']:
+            data = {
+                'msgtype': self.message_type,
+                self.message_type: {
+                    'content': self.message
+                } if self.message_type == 'text' else self.message,
+                'at': {
+                    'atMobiles': self.at_mobiles,
+                    'isAtAll': self.at_all
+                }
+            }
+        else:
+            data = {
+                'msgtype': self.message_type,
+                self.message_type: self.message
+            }
+        return json.dumps(data)
+
+    def get_conn(self, headers=None):
+        """
+        Overwrite HttpHook get_conn because just need base_url and headers and
+        not don't need generic params
+        :param headers: additional headers to be passed through as a dictionary
+        :type headers: dict
+        """
+        conn = self.get_connection(self.http_conn_id)
+        self.base_url = conn.host if conn.host else 'https://oapi.dingtalk.com'
+        session = requests.Session()
+        if headers:
+            session.headers.update(headers)
+        return session
+
+    def send(self):
+        """
+        Send Dingding message
+        """
+        support_type = ['text', 'link', 'markdown', 'actionCard', 'feedCard']
+        if self.message_type not in support_type:
+            raise ValueError('DingdingWebhookHook only support {} '
+                             'so far, but receive {}'.format(support_type, self.message_type))
+
+        data = self._build_message()
+        self.log.info('Sending Dingding type %s message %s', self.message_type, data)
+        resp = self.run(endpoint=self._get_endpoint(),
+                        data=data,
+                        headers={'Content-Type': 'application/json'})
+
+        # Dingding success send message will with errcode equal to 0
+        if int(resp.json().get('errcode')) != 0:
+            raise AirflowException('Send Dingding message failed, receive error '
+                                   'message %s', resp.text)
+        self.log.info('Success Send Dingding message')
diff --git a/airflow/contrib/operators/dingding_operator.py b/airflow/contrib/operators/dingding_operator.py
new file mode 100644
index 0000000000000..2d7ea2225e90e
--- /dev/null
+++ b/airflow/contrib/operators/dingding_operator.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.dingding_hook import DingdingHook
+from airflow.operators.bash_operator import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class DingdingOperator(BaseOperator):
+    """
+    This operator allows you send Dingding message using Dingding custom bot.
+    Get Dingding token from conn_id.password. And prefer set domain to
+    conn_id.host, if not will use default ``https://oapi.dingtalk.com``.
+
+    For more detail message in
+    `Dingding custom bot <https://open-doc.dingtalk.com/microapp/serverapi2/qf2nxq>`_
+
+    :param dingding_conn_id: The name of the Dingding connection to use
+    :type dingding_conn_id: str
+    :param message_type: Message type you want to send to Dingding, support five type so far
+        including text, link, markdown, actionCard, feedCard
+    :type message_type: str
+    :param message: The message send to Dingding chat group
+    :type message: str or dict
+    :param at_mobiles: Remind specific users with this message
+    :type at_mobiles: list[str]
+    :param at_all: Remind all people in group or not. If True, will overwrite ``at_mobiles``
+    :type at_all: bool
+    """
+    template_fields = ('message',)
+    ui_color = '#4ea4d4'  # Dingding icon color
+
+    @apply_defaults
+    def __init__(self,
+                 dingding_conn_id='dingding_default',
+                 message_type='text',
+                 message=None,
+                 at_mobiles=None,
+                 at_all=False,
+                 *args,
+                 **kwargs):
+        super(DingdingOperator, self).__init__(*args, **kwargs)
+        self.dingding_conn_id = dingding_conn_id
+        self.message_type = message_type
+        self.message = message
+        self.at_mobiles = at_mobiles
+        self.at_all = at_all
+
+    def execute(self, context):
+        self.log.info('Sending Dingding message.')
+        hook = DingdingHook(
+            self.dingding_conn_id,
+            self.message_type,
+            self.message,
+            self.at_mobiles,
+            self.at_all
+        )
+        hook.send()
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index 5a161ab6c9402..b340079c88455 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -288,6 +288,10 @@ def initdb(rbac=False):
         Connection(
             conn_id='cassandra_default', conn_type='cassandra',
             host='cassandra', port=9042))
+    merge_conn(
+        Connection(
+            conn_id='dingding_default', conn_type='http',
+            host='', password=''))
 
     # Known event types
     KET = models.KnownEventType
diff --git a/docs/howto/operator/dingding.rst b/docs/howto/operator/dingding.rst
new file mode 100644
index 0000000000000..51bbd95789501
--- /dev/null
+++ b/docs/howto/operator/dingding.rst
@@ -0,0 +1,91 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Dingding Operators
+==================
+
+
+Prerequisite Tasks
+^^^^^^^^^^^^^^^^^^
+
+To use this operators, you must do a few things:
+
+  * Add custom robot to Dingding group which you want to send Dingding message.
+  * Get the webhook token from Dingding custom robot.
+  * Put the Dingding custom robot token in the password field of the ``dingding_default``
+    Connection. Notice that you just need token rather than the whole webhook string.
+
+Basic Usage
+^^^^^^^^^^^
+
+Use the :class:`~airflow/contrib/operators/dingding_operator.DingdingOperator`
+to send Dingding message:
+
+.. literalinclude:: ../../../airflow/contrib/example_dags/example_dingding_operator.py
+    :language: python
+    :start-after: [START howto_operator_dingding]
+    :end-before: [END howto_operator_dingding]
+
+
+Remind users in message
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Use parameters ``at_mobiles`` and ``at_all`` to remind specific users when you send message,
+``at_mobiles`` will be ignored When ``at_all`` is set to ``True``:
+
+.. literalinclude:: ../../../airflow/contrib/example_dags/example_dingding_operator.py
+    :language: python
+    :start-after: [START howto_operator_dingding_remind_users]
+    :end-before: [END howto_operator_dingding_remind_users]
+
+
+Send rich text message
+^^^^^^^^^^^^^^^^^^^^^^
+
+The Dingding operator can send rich text messages including link, markdown, actionCard and feedCard.
+A rich text message can not remind specific users except by using markdown type message:
+
+.. literalinclude:: ../../../airflow/contrib/example_dags/example_dingding_operator.py
+    :language: python
+    :start-after: [START howto_operator_dingding_rich_text]
+    :end-before: [END howto_operator_dingding_rich_text]
+
+
+Sending messages from a Task callback
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Dingding operator could handle task callback by writing a function wrapper dingding operators
+and then pass the function to ``sla_miss_callback``, ``on_success_callback``, ``on_failure_callback``,
+or ``on_retry_callback``. Here we use ``on_failure_callback`` as an example:
+
+.. literalinclude:: ../../../airflow/contrib/example_dags/example_dingding_operator.py
+    :language: python
+    :start-after: [START howto_operator_dingding_failure_callback]
+    :end-before: [END howto_operator_dingding_failure_callback]
+
+
+Changing connection host if you need
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The Dingding operator post http requests using default host ``https://oapi.dingtalk.com``,
+if you need to change the host used you can set the host field of the connection.
+
+
+More information
+^^^^^^^^^^^^^^^^
+
+See Dingding documentation on how to `custom robot
+<https://open-doc.dingtalk.com/microapp/serverapi2/qf2nxq>`_.
diff --git a/docs/howto/operator/index.rst b/docs/howto/operator/index.rst
index 74197a2993c10..3ed731d020d46 100644
--- a/docs/howto/operator/index.rst
+++ b/docs/howto/operator/index.rst
@@ -28,6 +28,7 @@ information.
 .. toctree::
     :maxdepth: 2
 
-    python
     bash
+    dingding
     gcp/index
+    python
diff --git a/tests/contrib/hooks/test_dingding_hook.py b/tests/contrib/hooks/test_dingding_hook.py
new file mode 100644
index 0000000000000..5afa786f34553
--- /dev/null
+++ b/tests/contrib/hooks/test_dingding_hook.py
@@ -0,0 +1,278 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import json
+import unittest
+
+from airflow.utils import db
+
+from airflow import configuration
+
+from airflow.contrib.hooks.dingding_hook import DingdingHook
+from airflow.models.connection import Connection
+
+
+class TestDingdingHook(unittest.TestCase):
+    conn_id = 'dingding_conn_id_test'
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id=self.conn_id,
+                conn_type='http',
+                host='https://oapi.dingtalk.com',
+                password='you_token_here'))
+
+    def test_get_endpoint_conn_id(self):
+        hook = DingdingHook(dingding_conn_id=self.conn_id)
+        endpoint = hook._get_endpoint()
+        self.assertEqual('robot/send?access_token=you_token_here', endpoint)
+
+    def test_build_text_message_not_remind(self):
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'text',
+            'message': 'Airflow dingding text message remind no one',
+            'at_mobiles': False,
+            'at_all': False,
+        }
+        expect = {
+            'msgtype': 'text',
+            'text': {
+                'content': 'Airflow dingding text message remind no one'
+            },
+            'at': {
+                'atMobiles': False,
+                'isAtAll': False
+            }
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_text_message_remind_specific(self):
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'text',
+            'message': 'Airflow dingding text message remind specific users',
+            'at_mobiles': ['1234', '5768'],
+            'at_all': False,
+        }
+        expect = {
+            'msgtype': 'text',
+            'text': {
+                'content': 'Airflow dingding text message remind specific users'
+            },
+            'at': {
+                'atMobiles': ['1234', '5768'],
+                'isAtAll': False
+            }
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_text_message_remind_all(self):
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'text',
+            'message': 'Airflow dingding text message remind all user in group',
+            'at_all': True,
+        }
+        expect = {
+            'msgtype': 'text',
+            'text': {
+                'content': 'Airflow dingding text message remind all user in group'
+            },
+            'at': {
+                'atMobiles': None,
+                'isAtAll': True
+            }
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_markdown_message_remind_specific(self):
+        msg = {
+            'title': 'Airflow dingding markdown message',
+            'text': '# Markdown message title\ncontent content .. \n### sub-title\n'
+                    '![logo](http://airflow.apache.org/_images/pin_large.png)'
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'markdown',
+            'message': msg,
+            'at_mobiles': ['1234', '5678'],
+            'at_all': False,
+        }
+        expect = {
+            'msgtype': 'markdown',
+            'markdown': msg,
+            'at': {
+                'atMobiles': ['1234', '5678'],
+                'isAtAll': False
+            }
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_markdown_message_remind_all(self):
+        msg = {
+            'title': 'Airflow dingding markdown message',
+            'text': '# Markdown message title\ncontent content .. \n### sub-title\n'
+                    '![logo](http://airflow.apache.org/_images/pin_large.png)'
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'markdown',
+            'message': msg,
+            'at_all': True,
+        }
+        expect = {
+            'msgtype': 'markdown',
+            'markdown': msg,
+            'at': {
+                'atMobiles': None,
+                'isAtAll': True
+            }
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_link_message(self):
+        msg = {
+            'title': 'Airflow dingding link message',
+            'text': 'Airflow official documentation link',
+            'messageUrl': 'http://airflow.apache.org',
+            'picURL': 'http://airflow.apache.org/_images/pin_large.png'
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'link',
+            'message': msg
+        }
+        expect = {
+            'msgtype': 'link',
+            'link': msg
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_single_action_card_message(self):
+        msg = {
+            'title': 'Airflow dingding single actionCard message',
+            'text': 'Airflow dingding single actionCard message\n'
+                    '![logo](http://airflow.apache.org/_images/pin_large.png)\n'
+                    'This is a official logo in Airflow website.',
+            'hideAvatar': '0',
+            'btnOrientation': '0',
+            'singleTitle': 'read more',
+            'singleURL': 'http://airflow.apache.org'
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'actionCard',
+            'message': msg
+        }
+        expect = {
+            'msgtype': 'actionCard',
+            'actionCard': msg
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_multi_action_card_message(self):
+        msg = {
+            'title': 'Airflow dingding multi actionCard message',
+            'text': 'Airflow dingding multi actionCard message\n'
+                    '![logo](http://airflow.apache.org/_images/pin_large.png)\n'
+                    'Airflow documentation and github',
+            'hideAvatar': '0',
+            'btnOrientation': '0',
+            'btns': [
+                {
+                    'title': 'Airflow Documentation',
+                    'actionURL': 'http://airflow.apache.org'
+                },
+                {
+                    'title': 'Airflow Github',
+                    'actionURL': 'https://github.com/apache/airflow'
+                }
+            ]
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'actionCard',
+            'message': msg
+        }
+        expect = {
+            'msgtype': 'actionCard',
+            'actionCard': msg
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_build_feed_card_message(self):
+        msg = {
+            "links": [
+                {
+                    "title": "Airflow DAG feed card",
+                    "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                    "picURL": "http://airflow.apache.org/_images/dags.png"
+                },
+                {
+                    "title": "Airflow tree feed card",
+                    "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                    "picURL": "http://airflow.apache.org/_images/tree.png"
+                },
+                {
+                    "title": "Airflow graph feed card",
+                    "messageURL": "https://airflow.readthedocs.io/en/latest/ui.html",
+                    "picURL": "http://airflow.apache.org/_images/graph.png"
+                }
+            ]
+        }
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'feedCard',
+            'message': msg
+        }
+        expect = {
+            'msgtype': 'feedCard',
+            'feedCard': msg
+        }
+        hook = DingdingHook(**config)
+        message = hook._build_message()
+        self.assertEqual(json.dumps(expect), message)
+
+    def test_send_not_support_type(self):
+        config = {
+            'dingding_conn_id': self.conn_id,
+            'message_type': 'not_support_type',
+            'message': 'Airflow dingding text message remind no one'
+        }
+        hook = DingdingHook(**config)
+        self.assertRaises(ValueError, hook.send)
diff --git a/tests/contrib/operators/test_dingding_operator.py b/tests/contrib/operators/test_dingding_operator.py
new file mode 100644
index 0000000000000..a744e337d24d3
--- /dev/null
+++ b/tests/contrib/operators/test_dingding_operator.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+import mock
+
+from airflow import DAG, configuration
+from airflow.contrib.operators.dingding_operator import DingdingOperator
+from airflow.utils import timezone
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+
+class TestDingdingOperator(unittest.TestCase):
+    _config = {
+        'dingding_conn_id': 'dingding_default',
+        'message_type': 'text',
+        'message': 'Airflow dingding webhook test',
+        'at_mobiles': ['123', '456'],
+        'at_all': False
+    }
+
+    def setUp(self):
+        configuration.load_test_config()
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+
+    @mock.patch('airflow.contrib.operators.dingding_operator.DingdingHook')
+    def test_execute(self, mock_hook):
+        operator = DingdingOperator(
+            task_id='dingding_task',
+            dag=self.dag,
+            **self._config
+        )
+
+        self.assertIsNotNone(operator)
+        self.assertEqual(self._config['dingding_conn_id'], operator.dingding_conn_id)
+        self.assertEqual(self._config['message_type'], operator.message_type)
+        self.assertEqual(self._config['message'], operator.message)
+        self.assertEqual(self._config['at_mobiles'], operator.at_mobiles)
+        self.assertEqual(self._config['at_all'], operator.at_all)
+
+        operator.execute(None)
+        mock_hook.assert_called_once_with(
+            self._config['dingding_conn_id'],
+            self._config['message_type'],
+            self._config['message'],
+            self._config['at_mobiles'],
+            self._config['at_all']
+        )
+        mock_hook.return_value.send.assert_called_once()

From 540612253d2f743ebc1def91fda8c9b3e36ff8bd Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 29 Mar 2019 21:21:04 +0000
Subject: [PATCH 764/808] [AIRFLOW-3540] Warn if old airflow.cfg file is found
 (#5006)

We used to read this config file, but we now don't. To make it easier on
users (particularly of puckel's docker container) lets at least issue a
warning
---
 airflow/configuration.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/airflow/configuration.py b/airflow/configuration.py
index 357da6f945a04..ad03b310073bb 100644
--- a/airflow/configuration.py
+++ b/airflow/configuration.py
@@ -578,6 +578,18 @@ def parameterized_config(template):
         AIRFLOW_HOME = conf.get('core', 'airflow_home')
         warnings.warn(msg, category=DeprecationWarning)
 
+# Warn about old config file. We used to read ~/airflow/airflow.cfg even if
+# that AIRFLOW_HOME was set to something else
+_old_config_file = os.path.expanduser("~/airflow/airflow.cfg")
+if _old_config_file != AIRFLOW_CONFIG and os.path.isfile(_old_config_file):
+    warnings.warn(
+        'You have two airflow.cfg files: {old} and {new}. Airflow used to look '
+        'at ~/airflow/airflow.cfg, even when AIRFLOW_HOME was set to a different '
+        'value. Airflow will now only read {new}, and you should remove the '
+        'other file'.format(old=_old_config_file, new=AIRFLOW_CONFIG),
+        category=DeprecationWarning,
+    )
+
 
 WEBSERVER_CONFIG = AIRFLOW_HOME + '/webserver_config.py'
 

From d10ffe7d820e42896043ca0dbebf6e3e93776985 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Fri, 29 Mar 2019 22:00:00 +0800
Subject: [PATCH 765/808] [AIRFLOW-4173] Improve SchedulerJob.process_file()
 (#4993)

By avoid processing paused DAGs.

The actions we avoid here is mainly the dagbag.get_dag() on paused DAGs.
DagBag.get_dag() itself is relatively expensive, so this change brings
considerable performance improvement.
---
 airflow/jobs.py | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index 80ef3efd3058c..ed0b606f1114b 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1736,13 +1736,12 @@ def process_file(self, file_path, zombies, pickle_dags=False, session=None):
 
         # Pickle the DAGs (if necessary) and put them into a SimpleDag
         for dag_id in dagbag.dags:
-            dag = dagbag.get_dag(dag_id)
-            pickle_id = None
-            if pickle_dags:
-                pickle_id = dag.pickle(session).id
-
             # Only return DAGs that are not paused
             if dag_id not in paused_dag_ids:
+                dag = dagbag.get_dag(dag_id)
+                pickle_id = None
+                if pickle_dags:
+                    pickle_id = dag.pickle(session).id
                 simple_dags.append(SimpleDag(dag, pickle_id=pickle_id))
 
         if len(self.dag_ids) > 0:

From 047027cc473dcace6024fe6ecb3fbb0440e2bbc0 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 29 Mar 2019 22:06:45 +0000
Subject: [PATCH 766/808] [AIRFLOW-3623] Fix bugs in Download task logs (#5005)

They didn't work in Python 3 (Bytes vs Strings), the graph_view wasn't
specifying the try_number correctly, and the "All" logs had "None" as
the suffix instead of "all".
---
 airflow/www/templates/airflow/graph.html      |  4 ++--
 airflow/www/views.py                          | 20 +++++++++----------
 airflow/www_rbac/templates/airflow/graph.html |  4 ++--
 airflow/www_rbac/views.py                     | 18 ++++++++---------
 4 files changed, 21 insertions(+), 25 deletions(-)

diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index 2e95ea387e909..6918461db1ddc 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -133,9 +133,9 @@
     d3.selectAll("g.node").on("click", function(d){
         task = tasks[d];
         if (task.task_type == "SubDagOperator")
-            call_modal(d, execution_date, true);
+            call_modal(d, execution_date, task_instances[d].try_number, true);
         else
-            call_modal(d, execution_date);
+            call_modal(d, execution_date,task_instances[d].try_number);
     });
 
 
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 9ad86347c7a4d..7f4d5e8035f4f 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -22,6 +22,7 @@
 import codecs
 import copy
 import datetime as dt
+from io import BytesIO
 import itertools
 import json
 import logging
@@ -40,7 +41,6 @@
     abort, jsonify, redirect, url_for, request, Markup, Response,
     current_app, render_template, make_response, send_file)
 from flask import flash
-from flask._compat import PY2
 from flask_admin import BaseView, expose, AdminIndexView
 from flask_admin.actions import action
 from flask_admin.babel import lazy_gettext
@@ -49,7 +49,7 @@
 from flask_admin.tools import iterdecode
 from jinja2 import escape
 from jinja2.sandbox import ImmutableSandboxedEnvironment
-from past.builtins import basestring, unicode
+from past.builtins import basestring
 from pygments import highlight, lexers
 from pygments.formatters import HtmlFormatter
 from sqlalchemy import or_, desc, and_, union_all
@@ -82,10 +82,6 @@
 from airflow.www.forms import (DateTimeForm, DateTimeWithNumRunsForm,
                                DateTimeWithNumRunsWithDagRunsForm)
 from airflow.www.validators import GreaterEqualThan
-if PY2:
-    from cStringIO import StringIO
-else:
-    from io import StringIO
 
 QUERY_LIMIT = 100000
 CHART_LIMIT = 200000
@@ -819,17 +815,19 @@ def get_logs_with_metadata(self, session=None):
                 ti.task = dag.get_task(ti.task_id)
                 logs, metadatas = handler.read(ti, try_number, metadata=metadata)
                 metadata = metadatas[0]
-            for i, log in enumerate(logs):
-                if PY2 and not isinstance(log, unicode):
-                    logs[i] = log.decode('utf-8')
 
             if response_format == 'json':
                 message = logs[0] if try_number is not None else logs
                 return jsonify(message=message, metadata=metadata)
 
-            file_obj = StringIO('\n'.join(logs))
+            file_obj = BytesIO(b'\n'.join(
+                log.encode('utf-8') for log in logs
+            ))
             filename_template = conf.get('core', 'LOG_FILENAME_TEMPLATE')
-            attachment_filename = render_log_filename(ti, try_number, filename_template)
+            attachment_filename = render_log_filename(
+                ti=ti,
+                try_number="all" if try_number is None else try_number,
+                filename_template=filename_template)
             return send_file(file_obj, as_attachment=True,
                              attachment_filename=attachment_filename)
         except AttributeError as e:
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index ddd57c98ef7ad..52c83ac0b8fa7 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -168,9 +168,9 @@
     d3.selectAll("g.node").on("click", function(d){
         task = tasks[d];
         if (task.task_type == "SubDagOperator")
-            call_modal(d, execution_date, true);
+            call_modal(d, execution_date, task_instances[d].try_number, true);
         else
-            call_modal(d, execution_date);
+            call_modal(d, execution_date,task_instances[d].try_number);
     });
 
 
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 6148ff8cccafa..198c3ad3ddfce 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -19,6 +19,7 @@
 #
 
 import copy
+from io import BytesIO
 import itertools
 import json
 import logging
@@ -41,7 +42,6 @@
 from flask_appbuilder.actions import action
 from flask_appbuilder.models.sqla.filters import BaseFilter
 from flask_babel import lazy_gettext
-from past.builtins import unicode
 from pygments import highlight, lexers
 from pygments.formatters import HtmlFormatter
 from sqlalchemy import func, or_, desc, and_, union_all
@@ -69,10 +69,6 @@
                                     DateTimeWithNumRunsWithDagRunsForm,
                                     DagRunForm, ConnectionForm)
 from airflow.www_rbac.widgets import AirflowModelListWidget
-if PY2:
-    from cStringIO import StringIO
-else:
-    from io import StringIO
 
 
 PAGE_SIZE = conf.getint('webserver', 'page_size')
@@ -551,17 +547,19 @@ def get_logs_with_metadata(self, session=None):
                 ti.task = dag.get_task(ti.task_id)
                 logs, metadatas = handler.read(ti, try_number, metadata=metadata)
                 metadata = metadatas[0]
-            for i, log in enumerate(logs):
-                if PY2 and not isinstance(log, unicode):
-                    logs[i] = log.decode('utf-8')
 
             if response_format == 'json':
                 message = logs[0] if try_number is not None else logs
                 return jsonify(message=message, metadata=metadata)
 
-            file_obj = StringIO('\n'.join(logs))
+            file_obj = BytesIO(b'\n'.join(
+                log.encode('utf-8') for log in logs
+            ))
             filename_template = conf.get('core', 'LOG_FILENAME_TEMPLATE')
-            attachment_filename = render_log_filename(ti, try_number, filename_template)
+            attachment_filename = render_log_filename(
+                ti=ti,
+                try_number="all" if try_number is None else try_number,
+                filename_template=filename_template)
             return send_file(file_obj, as_attachment=True,
                              attachment_filename=attachment_filename)
         except AttributeError as e:

From bf61eef3846a61c10e476b4c8132a812dfe0737a Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Sun, 30 Dec 2018 10:51:19 +0100
Subject: [PATCH 767/808] [AIRFLOW-3573] Remove DagStat table (#4378)

* Remove DagStat usage

* Remove tests

* Remove dag_stat table from db

* Removed dagstat class

* Revert change

* Fixing test
---
 airflow/bin/cli.py                            |  15 +--
 airflow/jobs.py                               |   5 -
 .../a56c9515abdc_remove_dag_stat_table.py     |  47 +++++++
 airflow/models/__init__.py                    | 127 ------------------
 airflow/www/views.py                          |  16 +--
 airflow/www_rbac/views.py                     |   6 -
 .../common/experimental/test_delete_dag.py    |   9 +-
 .../common/experimental/test_mark_tasks.py    |   1 -
 tests/core.py                                 |  71 ----------
 tests/models.py                               |  71 +---------
 10 files changed, 54 insertions(+), 314 deletions(-)
 create mode 100644 airflow/migrations/versions/a56c9515abdc_remove_dag_stat_table.py

diff --git a/airflow/bin/cli.py b/airflow/bin/cli.py
index ae6cc14fb2891..422942f14944d 100644
--- a/airflow/bin/cli.py
+++ b/airflow/bin/cli.py
@@ -56,7 +56,7 @@
 from airflow import configuration as conf
 from airflow.exceptions import AirflowException, AirflowWebServerTimeout
 from airflow.executors import GetDefaultExecutor
-from airflow.models import DagModel, DagBag, TaskInstance, DagRun, Variable, DagStat, DAG
+from airflow.models import DagModel, DagBag, TaskInstance, DagRun, Variable, DAG
 from airflow.models.connection import Connection
 from airflow.models.dagpickle import DagPickle
 from airflow.ti_deps.dep_context import (DepContext, SCHEDULER_DEPS)
@@ -69,7 +69,6 @@
 from airflow.www_rbac.app import create_app as create_app_rbac
 from airflow.www_rbac.app import cached_appbuilder
 
-from sqlalchemy import func
 from sqlalchemy.orm import exc
 
 api.load_auth()
@@ -1113,18 +1112,6 @@ def upgradedb(args):  # noqa
     print("DB: " + repr(settings.engine.url))
     db.upgradedb()
 
-    # Populate DagStats table
-    session = settings.Session()
-    ds_rows = session.query(DagStat).count()
-    if not ds_rows:
-        qry = (
-            session.query(DagRun.dag_id, DagRun.state, func.count('*'))
-                   .group_by(DagRun.dag_id, DagRun.state)
-        )
-        for dag_id, state, count in qry:
-            session.add(DagStat(dag_id=dag_id, state=state, count=count))
-        session.commit()
-
 
 @cli_utils.action_logging
 def version(args):  # noqa
diff --git a/airflow/jobs.py b/airflow/jobs.py
index ed0b606f1114b..d0dda16fb242e 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -1450,8 +1450,6 @@ def _process_dags(self, dagbag, dags, tis_out):
             self._process_task_instances(dag, tis_out)
             self.manage_slas(dag)
 
-        models.DagStat.update([d.dag_id for d in dags])
-
     @provide_session
     def _process_executor_events(self, simple_dag_bag, session=None):
         """
@@ -2342,9 +2340,6 @@ def _per_task_process(task, key, ti, session=None):
                     ti_status.active_runs.remove(run)
                     executed_run_dates.append(run.execution_date)
 
-                if run.dag.is_paused:
-                    models.DagStat.update([run.dag_id], session=session)
-
             self._log_progress(ti_status)
 
         # return updated status
diff --git a/airflow/migrations/versions/a56c9515abdc_remove_dag_stat_table.py b/airflow/migrations/versions/a56c9515abdc_remove_dag_stat_table.py
new file mode 100644
index 0000000000000..89dba33c3e394
--- /dev/null
+++ b/airflow/migrations/versions/a56c9515abdc_remove_dag_stat_table.py
@@ -0,0 +1,47 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""Remove dag_stat table
+
+Revision ID: a56c9515abdc
+Revises: c8ffec048a3b
+Create Date: 2018-12-27 10:27:59.715872
+
+"""
+
+from alembic import op
+import sqlalchemy as sa
+
+# revision identifiers, used by Alembic.
+revision = 'a56c9515abdc'
+down_revision = 'c8ffec048a3b'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.drop_table("dag_stats")
+
+
+def downgrade():
+    op.create_table('dag_stats',
+                    sa.Column('dag_id', sa.String(length=250), nullable=False),
+                    sa.Column('state', sa.String(length=50), nullable=False),
+                    sa.Column('count', sa.Integer(), nullable=False, default=0),
+                    sa.Column('dirty', sa.Boolean(), nullable=False, default=False),
+                    sa.PrimaryKeyConstraint('dag_id', 'state'))
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 926ac253958e4..cb1c0a25d3046 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -44,7 +44,6 @@
 import getpass
 import imp
 import importlib
-import itertools
 import zipfile
 import jinja2
 import json
@@ -3757,7 +3756,6 @@ def set_dag_runs_state(
         for dr in drs:
             dr.state = state
             dirty_ids.append(dr.dag_id)
-        DagStat.update(dirty_ids, session=session)
 
     @provide_session
     def clear(
@@ -4188,8 +4186,6 @@ def create_dagrun(self,
         )
         session.add(run)
 
-        DagStat.set_dirty(dag_id=self.dag_id, session=session)
-
         session.commit()
 
         run.dag = self
@@ -4699,122 +4695,6 @@ def delete(cls, xcoms, session=None):
         session.commit()
 
 
-class DagStat(Base):
-    __tablename__ = "dag_stats"
-
-    dag_id = Column(String(ID_LEN), primary_key=True)
-    state = Column(String(50), primary_key=True)
-    count = Column(Integer, default=0, nullable=False)
-    dirty = Column(Boolean, default=False, nullable=False)
-
-    def __init__(self, dag_id, state, count=0, dirty=False):
-        self.dag_id = dag_id
-        self.state = state
-        self.count = count
-        self.dirty = dirty
-
-    @staticmethod
-    @provide_session
-    def set_dirty(dag_id, session=None):
-        """
-        :param dag_id: the dag_id to mark dirty
-        :param session: database session
-        :return:
-        """
-        DagStat.create(dag_id=dag_id, session=session)
-
-        try:
-            stats = session.query(DagStat).filter(
-                DagStat.dag_id == dag_id
-            ).with_for_update().all()
-
-            for stat in stats:
-                stat.dirty = True
-            session.commit()
-        except Exception as e:
-            session.rollback()
-            log = LoggingMixin().log
-            log.warning("Could not update dag stats for %s", dag_id)
-            log.exception(e)
-
-    @staticmethod
-    @provide_session
-    def update(dag_ids=None, dirty_only=True, session=None):
-        """
-        Updates the stats for dirty/out-of-sync dags
-
-        :param dag_ids: dag_ids to be updated
-        :type dag_ids: list
-        :param dirty_only: only updated for marked dirty, defaults to True
-        :type dirty_only: bool
-        :param session: db session to use
-        :type session: Session
-        """
-        try:
-            qry = session.query(DagStat)
-            if dag_ids:
-                qry = qry.filter(DagStat.dag_id.in_(set(dag_ids)))
-            if dirty_only:
-                qry = qry.filter(DagStat.dirty == True) # noqa
-
-            qry = qry.with_for_update().all()
-
-            ids = set([dag_stat.dag_id for dag_stat in qry])
-
-            # avoid querying with an empty IN clause
-            if len(ids) == 0:
-                session.commit()
-                return
-
-            dagstat_states = set(itertools.product(ids, State.dag_states))
-            qry = (
-                session.query(DagRun.dag_id, DagRun.state, func.count('*'))
-                .filter(DagRun.dag_id.in_(ids))
-                .group_by(DagRun.dag_id, DagRun.state)
-            )
-
-            counts = {(dag_id, state): count for dag_id, state, count in qry}
-            for dag_id, state in dagstat_states:
-                count = 0
-                if (dag_id, state) in counts:
-                    count = counts[(dag_id, state)]
-
-                session.merge(
-                    DagStat(dag_id=dag_id, state=state, count=count, dirty=False)
-                )
-
-            session.commit()
-        except Exception as e:
-            session.rollback()
-            log = LoggingMixin().log
-            log.warning("Could not update dag stat table")
-            log.exception(e)
-
-    @staticmethod
-    @provide_session
-    def create(dag_id, session=None):
-        """
-        Creates the missing states the stats table for the dag specified
-
-        :param dag_id: dag id of the dag to create stats for
-        :param session: database session
-        :return:
-        """
-        # unfortunately sqlalchemy does not know upsert
-        qry = session.query(DagStat).filter(DagStat.dag_id == dag_id).all()
-        states = {dag_stat.state for dag_stat in qry}
-        for state in State.dag_states:
-            if state not in states:
-                try:
-                    session.merge(DagStat(dag_id=dag_id, state=state))
-                    session.commit()
-                except Exception as e:
-                    session.rollback()
-                    log = LoggingMixin().log
-                    log.warning("Could not create stat record")
-                    log.exception(e)
-
-
 class DagRun(Base, LoggingMixin):
     """
     DagRun describes an instance of a Dag. It can be created
@@ -4861,13 +4741,6 @@ def set_state(self, state):
             self._state = state
             self.end_date = timezone.utcnow() if self._state in State.finished() else None
 
-            if self.dag_id is not None:
-                # FIXME: Due to the scoped_session factor we we don't get a clean
-                # session here, so something really weird goes on:
-                # if you try to close the session dag runs will end up detached
-                session = settings.Session()
-                DagStat.set_dirty(self.dag_id, session=session)
-
     @declared_attr
     def state(self):
         return synonym('_state',
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 7f4d5e8035f4f..1fd4ba7df2b53 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1894,19 +1894,16 @@ def paused(self, session=None):
     @wwwutils.action_logging
     @provide_session
     def refresh(self, session=None):
-        DagModel = models.DagModel
+        # TODO: Is this method still needed after AIRFLOW-3561?
+        dm = models.DagModel
         dag_id = request.args.get('dag_id')
-        orm_dag = session.query(
-            DagModel).filter(DagModel.dag_id == dag_id).first()
+        orm_dag = session.query(dm).filter(dm.dag_id == dag_id).first()
 
         if orm_dag:
             orm_dag.last_expired = timezone.utcnow()
             session.merge(orm_dag)
         session.commit()
 
-        models.DagStat.update([dag_id], session=session, dirty_only=False)
-
-        dagbag.get_dag(dag_id)
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
 
@@ -1914,7 +1911,7 @@ def refresh(self, session=None):
     @login_required
     @wwwutils.action_logging
     def refresh_all(self):
-        dagbag.collect_dags(only_if_updated=False)
+        # TODO: Is this method still needed after AIRFLOW-3561?
         flash("All DAGs are now up to date")
         return redirect('/')
 
@@ -2670,7 +2667,6 @@ def action_new_delete(self, ids, session=None):
         dirty_ids = []
         for row in deleted:
             dirty_ids.append(row.dag_id)
-        models.DagStat.update(dirty_ids, dirty_only=False, session=session)
 
     @action('set_running', "Set state to 'running'", None)
     @provide_session
@@ -2684,7 +2680,6 @@ def action_set_running(self, ids, session=None):
                 count += 1
                 dr.state = State.RUNNING
                 dr.start_date = timezone.utcnow()
-            models.DagStat.update(dirty_ids, session=session)
             flash(
                 "{count} dag runs were set to running".format(**locals()))
         except Exception as ex:
@@ -2709,7 +2704,6 @@ def action_set_failed(self, ids, session=None):
                                                 dr.execution_date,
                                                 commit=True,
                                                 session=session)
-            models.DagStat.update(dirty_ids, session=session)
             altered_ti_count = len(altered_tis)
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
@@ -2736,7 +2730,6 @@ def action_set_success(self, ids, session=None):
                                                  dr.execution_date,
                                                  commit=True,
                                                  session=session)
-            models.DagStat.update(dirty_ids, session=session)
             altered_ti_count = len(altered_tis)
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
@@ -2770,7 +2763,6 @@ def after_model_change(self, form, dagrun, is_created, session=None):
                 session=session)
 
         altered_ti_count = len(altered_tis)
-        models.DagStat.update([dagrun.dag_id], session=session)
         flash(
             "1 dag run and {altered_ti_count} task instances "
             "were set to '{dagrun.state}'".format(**locals()))
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 198c3ad3ddfce..b532befa03625 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -1654,8 +1654,6 @@ def refresh(self, session=None):
         # sync dag permission
         appbuilder.sm.sync_perm_for_dag(dag_id)
 
-        models.DagStat.update([dag_id], session=session, dirty_only=False)
-
         dagbag.get_dag(dag_id)
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
@@ -2175,7 +2173,6 @@ def action_muldelete(self, items, session=None):
         dirty_ids = []
         for item in items:
             dirty_ids.append(item.dag_id)
-        models.DagStat.update(dirty_ids, dirty_only=False, session=session)
         return redirect(self.get_redirect())
 
     @action('set_running', "Set state to 'running'", '', single=False)
@@ -2191,7 +2188,6 @@ def action_set_running(self, drs, session=None):
                 count += 1
                 dr.start_date = timezone.utcnow()
                 dr.state = State.RUNNING
-            models.DagStat.update(dirty_ids, session=session)
             session.commit()
             flash("{count} dag runs were set to running".format(**locals()))
         except Exception as ex:
@@ -2218,7 +2214,6 @@ def action_set_failed(self, drs, session=None):
                                                 dr.execution_date,
                                                 commit=True,
                                                 session=session)
-            models.DagStat.update(dirty_ids, session=session)
             altered_ti_count = len(altered_tis)
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
@@ -2246,7 +2241,6 @@ def action_set_success(self, drs, session=None):
                                                  dr.execution_date,
                                                  commit=True,
                                                  session=session)
-            models.DagStat.update(dirty_ids, session=session)
             altered_ti_count = len(altered_tis)
             flash(
                 "{count} dag runs and {altered_ti_count} task instances "
diff --git a/tests/api/common/experimental/test_delete_dag.py b/tests/api/common/experimental/test_delete_dag.py
index 89744d26e05ec..aaca6be47d781 100644
--- a/tests/api/common/experimental/test_delete_dag.py
+++ b/tests/api/common/experimental/test_delete_dag.py
@@ -28,7 +28,6 @@
 from airflow.utils.state import State
 
 DM = models.DagModel
-DS = models.DagStat
 DR = models.DagRun
 TI = models.TaskInstance
 LOG = models.Log
@@ -52,7 +51,7 @@ def test_delete_dag_non_existent_dag(self):
 
     def test_delete_dag_dag_still_in_dagbag(self):
         with create_session() as session:
-            models_to_check = ['DagModel', 'DagStat', 'DagRun', 'TaskInstance']
+            models_to_check = ['DagModel', 'DagRun', 'TaskInstance']
             record_counts = {}
 
             for model_name in models_to_check:
@@ -86,7 +85,6 @@ def setUp(self):
         d = days_ago(1)
         with create_session() as session:
             session.add(DM(dag_id=self.key))
-            session.add(DS(dag_id=self.key, state=State.SUCCESS))
             session.add(DR(dag_id=self.key))
             session.add(TI(task=task,
                            execution_date=d,
@@ -108,14 +106,12 @@ def tearDown(self):
             session.query(TF).filter(TF.dag_id == self.key).delete()
             session.query(TI).filter(TI.dag_id == self.key).delete()
             session.query(DR).filter(DR.dag_id == self.key).delete()
-            session.query(DS).filter(DS.dag_id == self.key).delete()
             session.query(DM).filter(DM.dag_id == self.key).delete()
             session.query(LOG).filter(LOG.dag_id == self.key).delete()
 
     def test_delete_dag_successful_delete(self):
         with create_session() as session:
             self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 1)
-            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 1)
@@ -126,7 +122,6 @@ def test_delete_dag_successful_delete(self):
 
         with create_session() as session:
             self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 0)
-            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 0)
@@ -137,7 +132,6 @@ def test_delete_dag_successful_delete_not_keeping_records_in_log(self):
 
         with create_session() as session:
             self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 1)
-            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 1)
             self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 1)
@@ -148,7 +142,6 @@ def test_delete_dag_successful_delete_not_keeping_records_in_log(self):
 
         with create_session() as session:
             self.assertEqual(session.query(DM).filter(DM.dag_id == self.key).count(), 0)
-            self.assertEqual(session.query(DS).filter(DS.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(DR).filter(DR.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(TI).filter(TI.dag_id == self.key).count(), 0)
             self.assertEqual(session.query(TF).filter(TF.dag_id == self.key).count(), 0)
diff --git a/tests/api/common/experimental/test_mark_tasks.py b/tests/api/common/experimental/test_mark_tasks.py
index 278b917fe1f22..28df2f6a46510 100644
--- a/tests/api/common/experimental/test_mark_tasks.py
+++ b/tests/api/common/experimental/test_mark_tasks.py
@@ -514,7 +514,6 @@ def tearDown(self):
         with create_session() as session:
             session.query(models.DagRun).delete()
             session.query(models.TaskInstance).delete()
-            session.query(models.DagStat).delete()
 
 
 if __name__ == '__main__':
diff --git a/tests/core.py b/tests/core.py
index ae732041f5e59..d9f1747b2683e 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -956,77 +956,6 @@ def test_task_fail_duration(self):
         self.assertEqual(1, len(f_fails))
         self.assertGreaterEqual(sum([f.duration for f in f_fails]), 3)
 
-    def test_dag_stats(self):
-        """Correctly sets/dirties/cleans rows of DagStat table"""
-
-        session = settings.Session()
-
-        session.query(models.DagRun).delete()
-        session.query(models.DagStat).delete()
-        session.commit()
-
-        models.DagStat.update([], session=session)
-
-        self.dag_bash.create_dagrun(
-            run_id="run1",
-            execution_date=DEFAULT_DATE,
-            state=State.RUNNING)
-
-        models.DagStat.update([self.dag_bash.dag_id], session=session)
-
-        qry = session.query(models.DagStat).all()
-
-        self.assertEqual(3, len(qry))
-        self.assertEqual(self.dag_bash.dag_id, qry[0].dag_id)
-        for stats in qry:
-            if stats.state == State.RUNNING:
-                self.assertEqual(stats.count, 1)
-            else:
-                self.assertEqual(stats.count, 0)
-            self.assertFalse(stats.dirty)
-
-        self.dag_bash.create_dagrun(
-            run_id="run2",
-            execution_date=DEFAULT_DATE + timedelta(days=1),
-            state=State.RUNNING)
-
-        models.DagStat.update([self.dag_bash.dag_id], session=session)
-
-        qry = session.query(models.DagStat).all()
-
-        self.assertEqual(3, len(qry))
-        self.assertEqual(self.dag_bash.dag_id, qry[0].dag_id)
-        for stats in qry:
-            if stats.state == State.RUNNING:
-                self.assertEqual(stats.count, 2)
-            else:
-                self.assertEqual(stats.count, 0)
-            self.assertFalse(stats.dirty)
-
-        session.query(models.DagRun).first().state = State.SUCCESS
-        session.commit()
-
-        models.DagStat.update([self.dag_bash.dag_id], session=session)
-
-        qry = session.query(models.DagStat).filter(models.DagStat.state == State.SUCCESS).all()
-        self.assertEqual(1, len(qry))
-        self.assertEqual(self.dag_bash.dag_id, qry[0].dag_id)
-        self.assertEqual(State.SUCCESS, qry[0].state)
-        self.assertEqual(1, qry[0].count)
-        self.assertFalse(qry[0].dirty)
-
-        qry = session.query(models.DagStat).filter(models.DagStat.state == State.RUNNING).all()
-        self.assertEqual(1, len(qry))
-        self.assertEqual(self.dag_bash.dag_id, qry[0].dag_id)
-        self.assertEqual(State.RUNNING, qry[0].state)
-        self.assertEqual(1, qry[0].count)
-        self.assertFalse(qry[0].dirty)
-
-        session.query(models.DagRun).delete()
-        session.query(models.DagStat).delete()
-        session.commit()
-        session.close()
-
     def test_run_command(self):
         if six.PY3:
             write = r'sys.stdout.buffer.write("\u1000foo".encode("utf8"))'
diff --git a/tests/models.py b/tests/models.py
index 2406d4aff47e2..b1f19e32a61a9 100644
--- a/tests/models.py
+++ b/tests/models.py
@@ -48,7 +48,7 @@
 from airflow.exceptions import AirflowDagCycleException, AirflowSkipException
 from airflow.jobs import BackfillJob
 from airflow.models import DAG, TaskInstance as TI
-from airflow.models import DagModel, DagRun, DagStat
+from airflow.models import DagModel, DagRun
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.models import SkipMixin
 from airflow.models import State as ST
@@ -909,75 +909,6 @@ def test_sync_to_db_default_view(self, mock_now):
         self.assertEqual(orm_dag.get_default_view(), "graph")
 
 
-class DagStatTest(unittest.TestCase):
-    def test_dagstats_crud(self):
-        DagStat.create(dag_id='test_dagstats_crud')
-
-        session = settings.Session()
-        qry = session.query(DagStat).filter(DagStat.dag_id == 'test_dagstats_crud')
-        self.assertEqual(len(qry.all()), len(State.dag_states))
-
-        DagStat.set_dirty(dag_id='test_dagstats_crud')
-        res = qry.all()
-
-        for stat in res:
-            self.assertTrue(stat.dirty)
-
-        # create missing
-        DagStat.set_dirty(dag_id='test_dagstats_crud_2')
-        qry2 = session.query(DagStat).filter(DagStat.dag_id == 'test_dagstats_crud_2')
-        self.assertEqual(len(qry2.all()), len(State.dag_states))
-
-        dag = DAG(
-            'test_dagstats_crud',
-            start_date=DEFAULT_DATE,
-            default_args={'owner': 'owner1'})
-
-        with dag:
-            DummyOperator(task_id='A')
-
-        now = timezone.utcnow()
-        dag.create_dagrun(
-            run_id='manual__' + now.isoformat(),
-            execution_date=now,
-            start_date=now,
-            state=State.FAILED,
-            external_trigger=False,
-        )
-
-        DagStat.update(dag_ids=['test_dagstats_crud'])
-        res = qry.all()
-        for stat in res:
-            if stat.state == State.FAILED:
-                self.assertEqual(stat.count, 1)
-            else:
-                self.assertEqual(stat.count, 0)
-
-        DagStat.update()
-        res = qry2.all()
-        for stat in res:
-            self.assertFalse(stat.dirty)
-
-    def test_update_exception(self):
-        session = Mock()
-        (session.query.return_value
-            .filter.return_value
-            .with_for_update.return_value
-            .all.side_effect) = RuntimeError('it broke')
-        DagStat.update(session=session)
-        session.rollback.assert_called()
-
-    def test_set_dirty_exception(self):
-        session = Mock()
-        session.query.return_value.filter.return_value.all.return_value = []
-        (session.query.return_value
-            .filter.return_value
-            .with_for_update.return_value
-            .all.side_effect) = RuntimeError('it broke')
-        DagStat.set_dirty('dag', session)
-        session.rollback.assert_called()
-
-
 class DagRunTest(unittest.TestCase):
 
     def create_dag_run(self, dag,

From a63cb1adc94e36ce9f22ce7a3137db9d2ea5b955 Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Wed, 9 Jan 2019 17:16:41 -0500
Subject: [PATCH 768/808] [AIRFLOW-3596] Clean up undefined template variables.
 (#4401)

---
 airflow/www/templates/airflow/config.html     |  4 ---
 airflow/www/templates/airflow/dag_code.html   | 20 +------------
 .../www/templates/airflow/dag_details.html    |  2 +-
 airflow/www/templates/airflow/graph.html      |  2 +-
 airflow/www/templates/airflow/task.html       |  8 +++--
 airflow/www/templates/airflow/ti_code.html    | 23 +++-----------
 airflow/www/views.py                          | 23 ++++++++++++--
 .../www_rbac/templates/airflow/config.html    |  4 ---
 airflow/www_rbac/templates/airflow/dag.html   |  2 +-
 .../www_rbac/templates/airflow/dag_code.html  | 20 +------------
 .../templates/airflow/dag_details.html        |  2 +-
 airflow/www_rbac/templates/airflow/dags.html  |  3 +-
 airflow/www_rbac/templates/airflow/graph.html |  2 +-
 airflow/www_rbac/templates/airflow/task.html  |  8 +++--
 .../www_rbac/templates/airflow/ti_code.html   | 23 +++-----------
 airflow/www_rbac/views.py                     | 30 ++++++++++++++++---
 16 files changed, 74 insertions(+), 102 deletions(-)

diff --git a/airflow/www/templates/airflow/config.html b/airflow/www/templates/airflow/config.html
index a6f011d57ca60..89ad4fcd04bfd 100644
--- a/airflow/www/templates/airflow/config.html
+++ b/airflow/www/templates/airflow/config.html
@@ -33,10 +33,6 @@ <h2>{{ title }}</h2>
         <h5>{{ subtitle }}</h5>
     {% endif %}
 
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
     {% if code_html %}
         {{ code_html|safe }}
     {% endif %}
diff --git a/airflow/www/templates/airflow/dag_code.html b/airflow/www/templates/airflow/dag_code.html
index 35f85b2f789b1..65d957356cd78 100644
--- a/airflow/www/templates/airflow/dag_code.html
+++ b/airflow/www/templates/airflow/dag_code.html
@@ -21,25 +21,7 @@
 {% block body %}
     {{ super() }}
     <h4>{{ title }}</h4>
-    {% if html_code %}
-        {{ html_code|safe }}
-    {% endif %}
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
-    {% if code_dict %}
-        {% for k, v in code_dict.items() %}
-            <h5>{{ k }}</h5>
-            <pre>{{ v }}</pre>
-        {% endfor %}
-    {% endif %}
-    {% if html_dict %}
-        {% for k, v in html_dict.items() %}
-            <h5>{{ k }}</h5>
-            {{ v|safe }}
-        {% endfor %}
-    {% endif %}
+    {{ html_code|safe }}
 {% endblock %}
 
 {% block tail %}
diff --git a/airflow/www/templates/airflow/dag_details.html b/airflow/www/templates/airflow/dag_details.html
index 4f9f2eb6ad7f1..588e7ea5822de 100644
--- a/airflow/www/templates/airflow/dag_details.html
+++ b/airflow/www/templates/airflow/dag_details.html
@@ -42,7 +42,7 @@ <h2>{{ title }}</h2>
       </tr>
       <tr>
         <th>max_active_runs</td>
-        <td>{{ dag.active_runs | length }} / {{ dag.max_active_runs }}</td>
+        <td>{{ active_runs | length }} / {{ dag.max_active_runs }}</td>
       </tr>
       <tr>
         <th>concurrency</td>
diff --git a/airflow/www/templates/airflow/graph.html b/airflow/www/templates/airflow/graph.html
index 6918461db1ddc..79fbb74394745 100644
--- a/airflow/www/templates/airflow/graph.html
+++ b/airflow/www/templates/airflow/graph.html
@@ -30,7 +30,7 @@
 {% block body %}
 {{ super() }}
 {% if dag.doc_md %}
-<div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
+<div class="rich_doc" style="margin-bottom: 15px;">{{ dag.doc_md|safe }}</div>
 {% endif %}
 <div class="form-inline">
   <form method="get" style="float:left;">
diff --git a/airflow/www/templates/airflow/task.html b/airflow/www/templates/airflow/task.html
index e45b745fb879c..820a4a98149c7 100644
--- a/airflow/www/templates/airflow/task.html
+++ b/airflow/www/templates/airflow/task.html
@@ -37,7 +37,9 @@ <h5>Dependencies Blocking Task From Getting Scheduled</h5>
                 </tr>
             {% endfor %}
         </table>
-        {{ html_code|safe }}
+        {% if html_code is defined %}
+            {{ html_code|safe }}
+        {% endif %}
     </div>
     <div>
         {% for attr, value in special_attrs_rendered.items() %}
@@ -70,6 +72,8 @@ <h5>Task Attributes</h5>
                 </tr>
             {% endfor %}
         </table>
-        {{ html_code|safe }}
+        {% if html_code is defined %}
+            {{ html_code|safe }}
+        {% endif %}
     </div>
 {% endblock %}
diff --git a/airflow/www/templates/airflow/ti_code.html b/airflow/www/templates/airflow/ti_code.html
index 44942ca7d7e5d..72008f04682bb 100644
--- a/airflow/www/templates/airflow/ti_code.html
+++ b/airflow/www/templates/airflow/ti_code.html
@@ -21,23 +21,8 @@
 {% block body %}
     {{ super() }}
     <h4>{{ title }}</h4>
-    {% if html_code %}
-        {{ html_code|safe }}
-    {% endif %}
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
-    {% if code_dict %}
-        {% for k, v in code_dict.items() %}
-            <h5>{{ k }}</h5>
-            <pre>{{ v }}</pre>
-        {% endfor %}
-    {% endif %}
-    {% if html_dict %}
-        {% for k, v in html_dict.items() %}
-            <h5>{{ k }}</h5>
-            {{ v|safe }}
-        {% endfor %}
-    {% endif %}
+    {% for k, v in html_dict.items() %}
+        <h5>{{ k }}</h5>
+        {{ v|safe }}
+    {% endfor %}
 {% endblock %}
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 1fd4ba7df2b53..4cd66ff9241c4 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -676,6 +676,7 @@ def dag_details(self, session=None):
         dag_id = request.args.get('dag_id')
         dag = dagbag.get_dag(dag_id)
         title = "DAG details"
+        root = request.args.get('root', '')
 
         TI = models.TaskInstance
         states = session\
@@ -684,9 +685,17 @@ def dag_details(self, session=None):
             .group_by(TI.state)\
             .all()
 
+        active_runs = models.DagRun.find(
+            dag_id=dag.dag_id,
+            state=State.RUNNING,
+            external_trigger=False,
+            session=session
+        )
+
         return self.render(
             'airflow/dag_details.html',
-            dag=dag, title=title, states=states, State=State)
+            dag=dag, title=title, root=root, states=states, State=State,
+            active_runs=active_runs)
 
     @current_app.errorhandler(404)
     def circles(self):
@@ -736,6 +745,7 @@ def rendered(self):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dag = dagbag.get_dag(dag_id)
         task = copy.copy(dag.get_task(task_id))
         ti = models.TaskInstance(task=task, execution_date=dttm)
@@ -760,7 +770,8 @@ def rendered(self):
             task_id=task_id,
             execution_date=execution_date,
             form=form,
-            title=title, )
+            root=root,
+            title=title)
 
     @expose('/get_logs_with_metadata')
     @login_required
@@ -860,11 +871,13 @@ def log(self, session=None):
                 # Tasks in reschedule state decremented the try number
                 num_logs += 1
         logs = [''] * num_logs
+        root = request.args.get('root', '')
         return self.render(
             'airflow/ti_log.html',
             logs=logs, dag=dag, title="Log by attempts",
             dag_id=dag.dag_id, task_id=task_id,
-            execution_date=execution_date, form=form)
+            execution_date=execution_date, form=form,
+            root=root)
 
     @expose('/task')
     @login_required
@@ -879,6 +892,7 @@ def task(self):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dag = dagbag.get_dag(dag_id)
 
         if not dag or task_id not in dag.task_ids:
@@ -952,6 +966,7 @@ def task(self):
             execution_date=execution_date,
             special_attrs_rendered=special_attrs_rendered,
             form=form,
+            root=root,
             dag=dag, title=title)
 
     @expose('/xcom')
@@ -966,6 +981,7 @@ def xcom(self, session=None):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dm_db = models.DagModel
         ti_db = models.TaskInstance
         dag = session.query(dm_db).filter(dm_db.dag_id == dag_id).first()
@@ -993,6 +1009,7 @@ def xcom(self, session=None):
             task_id=task_id,
             execution_date=execution_date,
             form=form,
+            root=root,
             dag=dag, title=title)
 
     @expose('/run')
diff --git a/airflow/www_rbac/templates/airflow/config.html b/airflow/www_rbac/templates/airflow/config.html
index 501ef66ec1873..a68c5a7aef49a 100644
--- a/airflow/www_rbac/templates/airflow/config.html
+++ b/airflow/www_rbac/templates/airflow/config.html
@@ -33,10 +33,6 @@ <h2>{{ title }}</h2>
         <h5>{{ subtitle }}</h5>
     {% endif %}
 
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
     {% if code_html %}
         {{ code_html|safe }}
     {% endif %}
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index a58782d052068..685b7e9441284 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -510,7 +510,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $("#pause_resume").change(function() {
-      var dag_id =  $(this).attr('dag_id');
+      var dag_id = $(this).attr('dag_id');
       if ($(this).prop('checked')) {
         is_paused = 'true'
       } else {
diff --git a/airflow/www_rbac/templates/airflow/dag_code.html b/airflow/www_rbac/templates/airflow/dag_code.html
index dfab08b0c06e8..cb667063525a9 100644
--- a/airflow/www_rbac/templates/airflow/dag_code.html
+++ b/airflow/www_rbac/templates/airflow/dag_code.html
@@ -21,25 +21,7 @@
 {% block content %}
     {{ super() }}
     <h4>{{ title }}</h4>
-    {% if html_code %}
-        {{ html_code|safe }}
-    {% endif %}
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
-    {% if code_dict %}
-        {% for k, v in code_dict.items() %}
-            <h5>{{ k }}</h5>
-            <pre>{{ v }}</pre>
-        {% endfor %}
-    {% endif %}
-    {% if html_dict %}
-        {% for k, v in html_dict.items() %}
-            <h5>{{ k }}</h5>
-            {{ v|safe }}
-        {% endfor %}
-    {% endif %}
+    {{ html_code|safe }}
 {% endblock %}
 
 {% block tail %}
diff --git a/airflow/www_rbac/templates/airflow/dag_details.html b/airflow/www_rbac/templates/airflow/dag_details.html
index 2ef49ff16b760..37f51b53064ca 100644
--- a/airflow/www_rbac/templates/airflow/dag_details.html
+++ b/airflow/www_rbac/templates/airflow/dag_details.html
@@ -42,7 +42,7 @@ <h2>{{ title }}</h2>
       </tr>
       <tr>
         <th>max_active_runs</td>
-        <td>{{ dag.active_runs | length }} / {{ dag.max_active_runs }}</td>
+        <td>{{ active_runs | length }} / {{ dag.max_active_runs }}</td>
       </tr>
       <tr>
         <th>concurrency</td>
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index dae0816507a4d..a0bdefab64e1f 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -74,8 +74,7 @@ <h2>DAGs</h2>
 
                 <!-- Column 2: Turn dag on/off -->
                 <td>
-                    {% set disabled = 'disabled' if view_only else None %}
-                    <input id="toggle-{{ dag.dag_id }}" {{ disabled }} dag_id="{{ dag.dag_id }}" type="checkbox" {{ "checked" if not dag.is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
+                    <input id="toggle-{{ dag.dag_id }}" dag_id="{{ dag.dag_id }}" type="checkbox" {{ "checked" if not dag.is_paused else "" }} data-toggle="toggle" data-size="mini" method="post">
                 </td>
 
                 <!-- Column 3: Name -->
diff --git a/airflow/www_rbac/templates/airflow/graph.html b/airflow/www_rbac/templates/airflow/graph.html
index 52c83ac0b8fa7..123d9e42a9212 100644
--- a/airflow/www_rbac/templates/airflow/graph.html
+++ b/airflow/www_rbac/templates/airflow/graph.html
@@ -27,7 +27,7 @@
 {% block content %}
 {{ super() }}
 {% if dag.doc_md %}
-<div class="rich_doc" style="margin-bottom: 15px;">{{ doc_md|safe }}</div>
+<div class="rich_doc" style="margin-bottom: 15px;">{{ dag.doc_md|safe }}</div>
 {% endif %}
 <div class="form-inline">
   <form method="get" style="float:left;">
diff --git a/airflow/www_rbac/templates/airflow/task.html b/airflow/www_rbac/templates/airflow/task.html
index 6c843b28e3e5e..2b4356f49ec60 100644
--- a/airflow/www_rbac/templates/airflow/task.html
+++ b/airflow/www_rbac/templates/airflow/task.html
@@ -37,7 +37,9 @@ <h5>Dependencies Blocking Task From Getting Scheduled</h5>
                 </tr>
             {% endfor %}
         </table>
-        {{ html_code|safe }}
+        {% if html_code is defined %}
+            {{ html_code|safe }}
+        {% endif %}
     </div>
     <div>
         {% for attr, value in special_attrs_rendered.items() %}
@@ -70,6 +72,8 @@ <h5>Task Attributes</h5>
                 </tr>
             {% endfor %}
         </table>
-        {{ html_code|safe }}
+        {% if html_code is defined %}
+            {{ html_code|safe }}
+        {% endif %}
     </div>
 {% endblock %}
diff --git a/airflow/www_rbac/templates/airflow/ti_code.html b/airflow/www_rbac/templates/airflow/ti_code.html
index d38eb7d6c936d..8c7db0d9d415d 100644
--- a/airflow/www_rbac/templates/airflow/ti_code.html
+++ b/airflow/www_rbac/templates/airflow/ti_code.html
@@ -21,23 +21,8 @@
 {% block content %}
     {{ super() }}
     <h4>{{ title }}</h4>
-    {% if html_code %}
-        {{ html_code|safe }}
-    {% endif %}
-    {% if code %}
-        <pre>{{ code }}</pre>
-    {% endif %}
-
-    {% if code_dict %}
-        {% for k, v in code_dict.items() %}
-            <h5>{{ k }}</h5>
-            <pre>{{ v }}</pre>
-        {% endfor %}
-    {% endif %}
-    {% if html_dict %}
-        {% for k, v in html_dict.items() %}
-            <h5>{{ k }}</h5>
-            {{ v|safe }}
-        {% endfor %}
-    {% endif %}
+    {% for k, v in html_dict.items() %}
+        <h5>{{ k }}</h5>
+        {{ v|safe }}
+    {% endfor %}
 {% endblock %}
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index b532befa03625..0a1e18ae827df 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -192,6 +192,10 @@ def index(self, session=None):
                                                       'hide_paused_dags_by_default')
         show_paused_arg = request.args.get('showPaused', 'None')
 
+        default_dag_run = conf.getint('webserver', 'default_dag_run_display_number')
+        num_runs = request.args.get('num_runs')
+        num_runs = int(num_runs) if num_runs else default_dag_run
+
         def get_int_arg(value, default=0):
             try:
                 return int(value)
@@ -272,7 +276,8 @@ def get_int_arg(value, default=0):
             paging=wwwutils.generate_pages(current_page, num_of_pages,
                                            search=arg_search_query,
                                            showPaused=not hide_paused),
-            auto_complete_data=auto_complete_data)
+            auto_complete_data=auto_complete_data,
+            num_runs=num_runs)
 
     @expose('/dag_stats')
     @has_access
@@ -416,6 +421,7 @@ def dag_details(self, session=None):
         dag_id = request.args.get('dag_id')
         dag = dagbag.get_dag(dag_id)
         title = "DAG details"
+        root = request.args.get('root', '')
 
         TI = models.TaskInstance
         states = (
@@ -424,9 +430,17 @@ def dag_details(self, session=None):
                    .group_by(TI.state)
                    .all()
         )
+
+        active_runs = models.DagRun.find(
+            dag_id=dag.dag_id,
+            state=State.RUNNING,
+            external_trigger=False,
+            session=session
+        )
+
         return self.render(
             'airflow/dag_details.html',
-            dag=dag, title=title, states=states, State=State)
+            dag=dag, title=title, root=root, states=states, State=State, active_runs=active_runs)
 
     @app.errorhandler(404)
     def circles(self):
@@ -467,6 +481,7 @@ def rendered(self):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dag = dagbag.get_dag(dag_id)
         task = copy.copy(dag.get_task(task_id))
         ti = models.TaskInstance(task=task, execution_date=dttm)
@@ -492,7 +507,8 @@ def rendered(self):
             task_id=task_id,
             execution_date=execution_date,
             form=form,
-            title=title, )
+            root=root,
+            title=title)
 
     @expose('/get_logs_with_metadata')
     @has_dag_access(can_dag_read=True)
@@ -593,11 +609,13 @@ def log(self, session=None):
                 # Tasks in reschedule state decremented the try number
                 num_logs += 1
         logs = [''] * num_logs
+        root = request.args.get('root', '')
         return self.render(
             'airflow/ti_log.html',
             logs=logs, dag=dag, title="Log by attempts",
             dag_id=dag.dag_id, task_id=task_id,
-            execution_date=execution_date, form=form)
+            execution_date=execution_date, form=form,
+            root=root)
 
     @expose('/task')
     @has_dag_access(can_dag_read=True)
@@ -613,6 +631,7 @@ def task(self):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dag = dagbag.get_dag(dag_id)
 
         if not dag or task_id not in dag.task_ids:
@@ -675,6 +694,7 @@ def task(self):
             execution_date=execution_date,
             special_attrs_rendered=special_attrs_rendered,
             form=form,
+            root=root,
             dag=dag, title=title)
 
     @expose('/xcom')
@@ -690,6 +710,7 @@ def xcom(self, session=None):
         execution_date = request.args.get('execution_date')
         dttm = pendulum.parse(execution_date)
         form = DateTimeForm(data={'execution_date': dttm})
+        root = request.args.get('root', '')
         dm_db = models.DagModel
         ti_db = models.TaskInstance
         dag = session.query(dm_db).filter(dm_db.dag_id == dag_id).first()
@@ -718,6 +739,7 @@ def xcom(self, session=None):
             task_id=task_id,
             execution_date=execution_date,
             form=form,
+            root=root,
             dag=dag, title=title)
 
     @expose('/run')

From 935f7f755c2bcf0fcdac30ec215aac2fde83db5c Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Tue, 5 Mar 2019 14:04:39 +0100
Subject: [PATCH 769/808] [AIRFLOW-3830] Remove DagBag from /dag_details
 (#4831)

* Remove DagBag from /dag_details

* Fixing method call

* Adding sync to db calls
---
 airflow/models/__init__.py   |  5 +++++
 airflow/www_rbac/views.py    | 11 ++++++-----
 tests/www_rbac/test_views.py |  3 +++
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index cb1c0a25d3046..3d2cbae33f2e7 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -2983,6 +2983,11 @@ def __repr__(self):
     def timezone(self):
         return settings.TIMEZONE
 
+    @staticmethod
+    @provide_session
+    def get_dagmodel(dag_id, session=None):
+        return session.query(DagModel).filter(DagModel.dag_id == dag_id).first()
+
     @classmethod
     @provide_session
     def get_current(cls, dag_id, session=None):
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 0a1e18ae827df..96f199667a316 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -53,7 +53,7 @@
 from airflow import settings
 from airflow.api.common.experimental.mark_tasks import (set_dag_run_state_to_success,
                                                         set_dag_run_state_to_failed)
-from airflow.models import XCom, DagRun, errors
+from airflow.models import XCom, DagRun, errors, DagModel
 from airflow.models.connection import Connection
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
@@ -419,7 +419,9 @@ def code(self, session=None):
     @provide_session
     def dag_details(self, session=None):
         dag_id = request.args.get('dag_id')
-        dag = dagbag.get_dag(dag_id)
+        dag_orm = DagModel.get_dagmodel(dag_id)
+        # FIXME: items needed for this view should move to the database
+        dag = dag_orm.get_dag()
         title = "DAG details"
         root = request.args.get('root', '')
 
@@ -432,10 +434,9 @@ def dag_details(self, session=None):
         )
 
         active_runs = models.DagRun.find(
-            dag_id=dag.dag_id,
+            dag_id=dag_id,
             state=State.RUNNING,
-            external_trigger=False,
-            session=session
+            external_trigger=False
         )
 
         return self.render(
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index 7078103b1574c..bd704ec5d2392 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -325,8 +325,11 @@ def cleanup_dagruns(self):
     def prepare_dagruns(self):
         dagbag = models.DagBag(include_examples=True)
         self.bash_dag = dagbag.dags['example_bash_operator']
+        self.bash_dag.sync_to_db()
         self.sub_dag = dagbag.dags['example_subdag_operator']
+        self.sub_dag.sync_to_db()
         self.xcom_dag = dagbag.dags['example_xcom']
+        self.xcom_dag.sync_to_db()
 
         self.bash_dagrun = self.bash_dag.create_dagrun(
             run_id=self.run_id,

From 68fc6dc17bad7a2c1689135904a50979c359b717 Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Mon, 11 Mar 2019 12:21:27 +0100
Subject: [PATCH 770/808] [AIRFLOW-4058] Name models test file to get
 automatically picked up (#4901)

We had `from .models import *` inside test/__init__.py as a kludge around this test
file not being named according to expected Python conventions. Renaming the file
makes more test tools happier (and makes it easier to run a single test file without
importing half of the test tree which the current approach suffers from)
---
 tests/__init__.py                   |  1 -
 tests/cli/test_cli.py               |  6 ++----
 tests/core.py                       |  7 -------
 tests/{models.py => test_models.py} | 24 +++++++++++-------------
 4 files changed, 13 insertions(+), 25 deletions(-)
 rename tests/{models.py => test_models.py} (99%)

diff --git a/tests/__init__.py b/tests/__init__.py
index 6cc4996f5e2f7..b8630ce2b40e3 100644
--- a/tests/__init__.py
+++ b/tests/__init__.py
@@ -23,4 +23,3 @@
 
 from .api import *
 from .core import *
-from .models import *
diff --git a/tests/cli/test_cli.py b/tests/cli/test_cli.py
index f274fe907daf1..55e0de349dcce 100644
--- a/tests/cli/test_cli.py
+++ b/tests/cli/test_cli.py
@@ -202,10 +202,8 @@ def test_test(self):
 
             output = out.getvalue()
             # Check that prints, and log messages, are shown
-            self.assertIn('Done. Returned value was: Whatever you return gets printed in the logs',
-                          output)
-            self.assertIn("'example_python_operator__print_the_context__20180101'",
-                          output)
+            self.assertIn('END_DATE', output)
+            self.assertIn("'example_python_operator__print_the_context__20180101'", output)
         finally:
             sys.stdout = saved_stdout
 
diff --git a/tests/core.py b/tests/core.py
index d9f1747b2683e..34687eb76f6b6 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -2616,13 +2616,6 @@ def test_get_connections_env_var(self):
         assert conns[0].password == 'password'
         assert conns[0].port == 5432
 
-    def test_get_connections_db(self):
-        conns = BaseHook.get_connections(conn_id='airflow_db')
-        assert len(conns) == 1
-        assert conns[0].host == 'localhost'
-        assert conns[0].schema == 'airflow'
-        assert conns[0].login == 'root'
-
 
 class WebHDFSHookTest(unittest.TestCase):
     def setUp(self):
diff --git a/tests/models.py b/tests/test_models.py
similarity index 99%
rename from tests/models.py
rename to tests/test_models.py
index b1f19e32a61a9..2dd4964fa5cdb 100644
--- a/tests/models.py
+++ b/tests/test_models.py
@@ -47,7 +47,7 @@
 from airflow.contrib.sensors.python_sensor import PythonSensor
 from airflow.exceptions import AirflowDagCycleException, AirflowSkipException
 from airflow.jobs import BackfillJob
-from airflow.models import DAG, TaskInstance as TI
+from airflow.models import DAG, TaskInstance as TI, DagBag
 from airflow.models import DagModel, DagRun
 from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.models import SkipMixin
@@ -1965,25 +1965,23 @@ def test_deactivate_unknown_dags(self):
         Test that dag_ids not passed into deactivate_unknown_dags
         are deactivated when function is invoked
         """
-        dagbag = models.DagBag(include_examples=True)
+        dagbag = DagBag(include_examples=True)
+        dag_id = "test_deactivate_unknown_dags"
         expected_active_dags = dagbag.dags.keys()
 
-        session = settings.Session
-        session.add(DagModel(dag_id='test_deactivate_unknown_dags', is_active=True))
-        session.commit()
+        model_before = DagModel(dag_id=dag_id, is_active=True)
+        with create_session() as session:
+            session.merge(model_before)
 
         models.DAG.deactivate_unknown_dags(expected_active_dags)
 
-        for dag in session.query(DagModel).all():
-            if dag.dag_id in expected_active_dags:
-                self.assertTrue(dag.is_active)
-            else:
-                self.assertEqual(dag.dag_id, 'test_deactivate_unknown_dags')
-                self.assertFalse(dag.is_active)
+        after_model = DagModel.get_dagmodel(dag_id)
+        self.assertTrue(model_before.is_active)
+        self.assertFalse(after_model.is_active)
 
         # clean up
-        session.query(DagModel).filter(DagModel.dag_id == 'test_deactivate_unknown_dags').delete()
-        session.commit()
+        with create_session() as session:
+            session.query(DagModel).filter(DagModel.dag_id == 'test_deactivate_unknown_dags').delete()
 
 
 class TaskInstanceTest(unittest.TestCase):

From 1b61b95f77120d66c5e9335d49a588b209f1ad68 Mon Sep 17 00:00:00 2001
From: Jarek <exploy@users.noreply.github.com>
Date: Fri, 2 Nov 2018 11:44:47 +0100
Subject: [PATCH 771/808] [AIRFLOW-3287] Moving database clean-up code into the
 CoreTest.tearDown() (#4122)

---
 tests/core.py | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/tests/core.py b/tests/core.py
index 34687eb76f6b6..f0ffe98e0512c 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -91,19 +91,6 @@
     import pickle
 
 
-def reset(dag_id=TEST_DAG_ID):
-    session = Session()
-    tis = session.query(models.TaskInstance).filter_by(dag_id=dag_id)
-    tis.delete()
-    session.commit()
-    session.close()
-
-
-configuration.conf.load_test_config()
-if os.environ.get('KUBERNETES_VERSION') is None:
-    reset()
-
-
 class OperatorSubclass(BaseOperator):
     """
     An operator to test template substitution
@@ -132,6 +119,16 @@ def setUp(self):
         self.run_after_loop = self.dag_bash.get_task('run_after_loop')
         self.run_this_last = self.dag_bash.get_task('run_this_last')
 
+    def tearDown(self):
+        if os.environ.get('KUBERNETES_VERSION') is None:
+            session = Session()
+            session.query(models.TaskInstance).filter_by(
+                dag_id=TEST_DAG_ID).delete()
+            session.query(models.TaskFail).filter_by(
+                dag_id=TEST_DAG_ID).delete()
+            session.commit()
+            session.close()
+
     def test_schedule_dag_no_previous_runs(self):
         """
         Tests scheduling a dag with no previous runs

From 254116fcae90094c408209a06f65629e847a2e14 Mon Sep 17 00:00:00 2001
From: Stefan Seelmann <mail@stefan-seelmann.de>
Date: Thu, 31 Jan 2019 21:01:52 +0100
Subject: [PATCH 772/808] [AIRFLOW-3461] Move TaskFail out of models.py (#4630)

---
 airflow/api/common/experimental/delete_dag.py |  3 +-
 airflow/models/__init__.py                    | 33 +----------
 airflow/models/taskfail.py                    | 55 +++++++++++++++++++
 airflow/www_rbac/views.py                     |  5 +-
 .../operators/test_bigquery_operator.py       |  3 +-
 tests/contrib/sensors/test_weekday_sensor.py  |  3 +-
 tests/core.py                                 |  7 ++-
 tests/test_models.py                          |  3 +-
 8 files changed, 71 insertions(+), 41 deletions(-)
 create mode 100755 airflow/models/taskfail.py

diff --git a/airflow/api/common/experimental/delete_dag.py b/airflow/api/common/experimental/delete_dag.py
index f1cb6a952f347..365997638b64c 100644
--- a/airflow/api/common/experimental/delete_dag.py
+++ b/airflow/api/common/experimental/delete_dag.py
@@ -20,6 +20,7 @@
 from sqlalchemy import or_
 
 from airflow import models
+from airflow.models.taskfail import TaskFail
 from airflow.utils.db import provide_session
 from airflow.exceptions import DagNotFound, DagFileExists
 
@@ -56,7 +57,7 @@ def delete_dag(dag_id, keep_records_in_log=True, session=None):
 
     if dag.is_subdag:
         p, c = dag_id.rsplit(".", 1)
-        for m in models.DagRun, models.TaskFail, models.TaskInstance:
+        for m in models.DagRun, TaskFail, models.TaskInstance:
             count += session.query(m).filter(m.dag_id == p, m.task_id == c).delete()
 
     return count
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 3d2cbae33f2e7..fc692e71aa4cc 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -89,6 +89,7 @@
 from airflow.models.dagpickle import DagPickle
 from airflow.models.errors import ImportError  # noqa: F401
 from airflow.models.slamiss import SlaMiss  # noqa: F401
+from airflow.models.taskfail import TaskFail
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
 from airflow.ti_deps.deps.prev_dagrun_dep import PrevDagrunDep
@@ -1932,38 +1933,6 @@ def init_run_context(self, raw=False):
         self._set_context(self)
 
 
-class TaskFail(Base):
-    """
-    TaskFail tracks the failed run durations of each task instance.
-    """
-
-    __tablename__ = "task_fail"
-
-    id = Column(Integer, primary_key=True)
-    task_id = Column(String(ID_LEN), nullable=False)
-    dag_id = Column(String(ID_LEN), nullable=False)
-    execution_date = Column(UtcDateTime, nullable=False)
-    start_date = Column(UtcDateTime)
-    end_date = Column(UtcDateTime)
-    duration = Column(Integer)
-
-    __table_args__ = (
-        Index('idx_task_fail_dag_task_date', dag_id, task_id, execution_date,
-              unique=False),
-    )
-
-    def __init__(self, task, execution_date, start_date, end_date):
-        self.dag_id = task.dag_id
-        self.task_id = task.task_id
-        self.execution_date = execution_date
-        self.start_date = start_date
-        self.end_date = end_date
-        if self.end_date and self.start_date:
-            self.duration = (self.end_date - self.start_date).total_seconds()
-        else:
-            self.duration = None
-
-
 class Log(Base):
     """
     Used to actively log events to the database
diff --git a/airflow/models/taskfail.py b/airflow/models/taskfail.py
new file mode 100755
index 0000000000000..d9cc7af922730
--- /dev/null
+++ b/airflow/models/taskfail.py
@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import Column, Index, Integer, String
+
+from airflow.models.base import Base, ID_LEN
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class TaskFail(Base):
+    """
+    TaskFail tracks the failed run durations of each task instance.
+    """
+
+    __tablename__ = "task_fail"
+
+    id = Column(Integer, primary_key=True)
+    task_id = Column(String(ID_LEN), nullable=False)
+    dag_id = Column(String(ID_LEN), nullable=False)
+    execution_date = Column(UtcDateTime, nullable=False)
+    start_date = Column(UtcDateTime)
+    end_date = Column(UtcDateTime)
+    duration = Column(Integer)
+
+    __table_args__ = (
+        Index('idx_task_fail_dag_task_date', dag_id, task_id, execution_date,
+              unique=False),
+    )
+
+    def __init__(self, task, execution_date, start_date, end_date):
+        self.dag_id = task.dag_id
+        self.task_id = task.task_id
+        self.execution_date = execution_date
+        self.start_date = start_date
+        self.end_date = end_date
+        if self.end_date and self.start_date:
+            self.duration = (self.end_date - self.start_date).total_seconds()
+        else:
+            self.duration = None
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index 96f199667a316..d6060629c81b6 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -55,6 +55,7 @@
                                                         set_dag_run_state_to_failed)
 from airflow.models import XCom, DagRun, errors, DagModel
 from airflow.models.connection import Connection
+from airflow.models.taskfail import TaskFail
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
 from airflow.utils.dates import infer_time_unit, scale_time_units
@@ -1424,7 +1425,7 @@ def duration(self, session=None):
 
         tis = dag.get_task_instances(
             session, start_date=min_date, end_date=base_date)
-        TF = models.TaskFail
+        TF = TaskFail
         ti_fails = (
             session.query(TF)
                    .filter(TF.dag_id == dag.dag_id,  # noqa
@@ -1718,7 +1719,7 @@ def gantt(self, session=None):
             ti for ti in dag.get_task_instances(session, dttm, dttm)
             if ti.start_date]
         tis = sorted(tis, key=lambda ti: ti.start_date)
-        TF = models.TaskFail
+        TF = TaskFail
         ti_fails = list(itertools.chain(*[(
             session
             .query(TF)
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 6cc80c1eefda1..1deb542db94e1 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -25,6 +25,7 @@
 
 from airflow import configuration, models
 from airflow.models import TaskInstance, DAG
+from airflow.models.taskfail import TaskFail
 
 from airflow.contrib.operators.bigquery_operator import \
     BigQueryCreateExternalTableOperator, BigQueryCreateEmptyTableOperator, \
@@ -178,7 +179,7 @@ def tearDown(self):
         session = Session()
         session.query(models.TaskInstance).filter_by(
             dag_id=TEST_DAG_ID).delete()
-        session.query(models.TaskFail).filter_by(
+        session.query(TaskFail).filter_by(
             dag_id=TEST_DAG_ID).delete()
         session.commit()
         session.close()
diff --git a/tests/contrib/sensors/test_weekday_sensor.py b/tests/contrib/sensors/test_weekday_sensor.py
index 55a4c4da4bf7d..0255aa3a162fe 100644
--- a/tests/contrib/sensors/test_weekday_sensor.py
+++ b/tests/contrib/sensors/test_weekday_sensor.py
@@ -24,6 +24,7 @@
 from airflow.contrib.utils.weekday import WeekDay
 from airflow.exceptions import AirflowSensorTimeout
 from airflow.models import DagBag
+from airflow.models.taskfail import TaskFail
 from airflow.settings import Session
 from airflow.utils.timezone import datetime
 
@@ -53,7 +54,7 @@ def tearDown(self):
         session = Session()
         session.query(models.TaskInstance).filter_by(
             dag_id=TEST_DAG_ID).delete()
-        session.query(models.TaskFail).filter_by(
+        session.query(TaskFail).filter_by(
             dag_id=TEST_DAG_ID).delete()
         session.commit()
         session.close()
diff --git a/tests/core.py b/tests/core.py
index f0ffe98e0512c..8c407a7c952c3 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -51,6 +51,7 @@
 from airflow import jobs, models, DAG, utils, macros, settings, exceptions
 from airflow.models import BaseOperator
 from airflow.models.connection import Connection
+from airflow.models.taskfail import TaskFail
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.check_operator import CheckOperator, ValueCheckOperator
 from airflow.operators.dagrun_operator import TriggerDagRunOperator
@@ -124,7 +125,7 @@ def tearDown(self):
             session = Session()
             session.query(models.TaskInstance).filter_by(
                 dag_id=TEST_DAG_ID).delete()
-            session.query(models.TaskFail).filter_by(
+            session.query(TaskFail).filter_by(
                 dag_id=TEST_DAG_ID).delete()
             session.commit()
             session.close()
@@ -940,11 +941,11 @@ def test_task_fail_duration(self):
             f.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
         except Exception:
             pass
-        p_fails = session.query(models.TaskFail).filter_by(
+        p_fails = session.query(TaskFail).filter_by(
             task_id='pass_sleepy',
             dag_id=self.dag.dag_id,
             execution_date=DEFAULT_DATE).all()
-        f_fails = session.query(models.TaskFail).filter_by(
+        f_fails = session.query(TaskFail).filter_by(
             task_id='fail_sleepy',
             dag_id=self.dag.dag_id,
             execution_date=DEFAULT_DATE).all()
diff --git a/tests/test_models.py b/tests/test_models.py
index 2dd4964fa5cdb..edea71fdfe172 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -56,6 +56,7 @@
 from airflow.models import Variable
 from airflow.models import clear_task_instances
 from airflow.models.connection import Connection
+from airflow.models.taskfail import TaskFail
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.operators.bash_operator import BashOperator
 from airflow.operators.dummy_operator import DummyOperator
@@ -1988,7 +1989,7 @@ class TaskInstanceTest(unittest.TestCase):
 
     def tearDown(self):
         with create_session() as session:
-            session.query(models.TaskFail).delete()
+            session.query(TaskFail).delete()
             session.query(TaskReschedule).delete()
             session.query(models.TaskInstance).delete()
 

From 9ce630aaf8939faafc9aea7cb941b913f73e1194 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Wed, 6 Feb 2019 09:55:16 +0100
Subject: [PATCH 773/808] [AIRFLOW-3476,3477] Move Kube classes out of
 models.py (#4443)

---
 .../contrib/executors/kubernetes_executor.py  |  3 +-
 airflow/models/__init__.py                    | 58 +-------------
 airflow/models/kubernetes.py                  | 79 +++++++++++++++++++
 tests/models/test_kubernetes.py               | 58 ++++++++++++++
 tests/test_models.py                          | 34 --------
 5 files changed, 141 insertions(+), 91 deletions(-)
 create mode 100644 airflow/models/kubernetes.py
 create mode 100644 tests/models/test_kubernetes.py

diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index b15fdb49fa7de..38abc5ed85a08 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -32,7 +32,8 @@
 from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
 from airflow.executors.base_executor import BaseExecutor
 from airflow.executors import Executors
-from airflow.models import TaskInstance, KubeResourceVersion, KubeWorkerIdentifier
+from airflow.models import TaskInstance
+from airflow.models.kubernetes import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.utils.state import State
 from airflow.utils.db import provide_session, create_session
 from airflow import configuration, settings
diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index fc692e71aa4cc..4fcfa64aec4d9 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -60,14 +60,13 @@
 import warnings
 import hashlib
 
-import uuid
 from datetime import datetime
 from urllib.parse import quote
 
 from sqlalchemy import (
     Boolean, Column, DateTime, Float, ForeignKey, Index,
     Integer, LargeBinary, PickleType, String, Text, UniqueConstraint, and_,
-    func, or_, true as sqltrue
+    func, or_
 )
 from sqlalchemy.ext.declarative import declared_attr
 from sqlalchemy.orm import reconstructor, relationship, synonym
@@ -89,6 +88,7 @@
 from airflow.models.dagpickle import DagPickle
 from airflow.models.errors import ImportError  # noqa: F401
 from airflow.models.slamiss import SlaMiss  # noqa: F401
+from airflow.models.kubernetes import KubeWorkerIdentifier, KubeResourceVersion  # noqa: F401
 from airflow.models.taskfail import TaskFail
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
@@ -5111,59 +5111,5 @@ def open_slots(self, session):
         return self.slots - used_slots - queued_slots
 
 
-class KubeResourceVersion(Base):
-    __tablename__ = "kube_resource_version"
-    one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
-    resource_version = Column(String(255))
-
-    @staticmethod
-    @provide_session
-    def get_current_resource_version(session=None):
-        (resource_version,) = session.query(KubeResourceVersion.resource_version).one()
-        return resource_version
-
-    @staticmethod
-    @provide_session
-    def checkpoint_resource_version(resource_version, session=None):
-        if resource_version:
-            session.query(KubeResourceVersion).update({
-                KubeResourceVersion.resource_version: resource_version
-            })
-            session.commit()
-
-    @staticmethod
-    @provide_session
-    def reset_resource_version(session=None):
-        session.query(KubeResourceVersion).update({
-            KubeResourceVersion.resource_version: '0'
-        })
-        session.commit()
-        return '0'
-
-
-class KubeWorkerIdentifier(Base):
-    __tablename__ = "kube_worker_uuid"
-    one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
-    worker_uuid = Column(String(255))
-
-    @staticmethod
-    @provide_session
-    def get_or_create_current_kube_worker_uuid(session=None):
-        (worker_uuid,) = session.query(KubeWorkerIdentifier.worker_uuid).one()
-        if worker_uuid == '':
-            worker_uuid = str(uuid.uuid4())
-            KubeWorkerIdentifier.checkpoint_kube_worker_uuid(worker_uuid, session)
-        return worker_uuid
-
-    @staticmethod
-    @provide_session
-    def checkpoint_kube_worker_uuid(worker_uuid, session=None):
-        if worker_uuid:
-            session.query(KubeWorkerIdentifier).update({
-                KubeWorkerIdentifier.worker_uuid: worker_uuid
-            })
-            session.commit()
-
-
 # To avoid circular import on Python2.7 we need to define this at the _bottom_
 from airflow.models.connection import Connection  # noqa: E402,F401
diff --git a/airflow/models/kubernetes.py b/airflow/models/kubernetes.py
new file mode 100644
index 0000000000000..a18689eefd316
--- /dev/null
+++ b/airflow/models/kubernetes.py
@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import uuid
+
+from sqlalchemy import Column, Boolean, true as sqltrue, String
+
+from airflow.models.base import Base
+from airflow.utils.db import provide_session
+
+
+class KubeResourceVersion(Base):
+    __tablename__ = "kube_resource_version"
+    one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
+    resource_version = Column(String(255))
+
+    @staticmethod
+    @provide_session
+    def get_current_resource_version(session=None):
+        (resource_version,) = session.query(KubeResourceVersion.resource_version).one()
+        return resource_version
+
+    @staticmethod
+    @provide_session
+    def checkpoint_resource_version(resource_version, session=None):
+        if resource_version:
+            session.query(KubeResourceVersion).update({
+                KubeResourceVersion.resource_version: resource_version
+            })
+            session.commit()
+
+    @staticmethod
+    @provide_session
+    def reset_resource_version(session=None):
+        session.query(KubeResourceVersion).update({
+            KubeResourceVersion.resource_version: '0'
+        })
+        session.commit()
+        return '0'
+
+
+class KubeWorkerIdentifier(Base):
+    __tablename__ = "kube_worker_uuid"
+    one_row_id = Column(Boolean, server_default=sqltrue(), primary_key=True)
+    worker_uuid = Column(String(255))
+
+    @staticmethod
+    @provide_session
+    def get_or_create_current_kube_worker_uuid(session=None):
+        (worker_uuid,) = session.query(KubeWorkerIdentifier.worker_uuid).one()
+        if worker_uuid == '':
+            worker_uuid = str(uuid.uuid4())
+            KubeWorkerIdentifier.checkpoint_kube_worker_uuid(worker_uuid, session)
+        return worker_uuid
+
+    @staticmethod
+    @provide_session
+    def checkpoint_kube_worker_uuid(worker_uuid, session=None):
+        if worker_uuid:
+            session.query(KubeWorkerIdentifier).update({
+                KubeWorkerIdentifier.worker_uuid: worker_uuid
+            })
+            session.commit()
diff --git a/tests/models/test_kubernetes.py b/tests/models/test_kubernetes.py
new file mode 100644
index 0000000000000..45bea723277ec
--- /dev/null
+++ b/tests/models/test_kubernetes.py
@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from mock import patch
+
+from airflow import settings
+from airflow.models.kubernetes import KubeResourceVersion, KubeWorkerIdentifier
+
+
+class TestKubeResourceVersion(unittest.TestCase):
+
+    def test_checkpoint_resource_version(self):
+        session = settings.Session()
+        KubeResourceVersion.checkpoint_resource_version('7', session)
+        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '7')
+
+    def test_reset_resource_version(self):
+        session = settings.Session()
+        version = KubeResourceVersion.reset_resource_version(session)
+        self.assertEqual(version, '0')
+        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '0')
+
+
+class TestKubeWorkerIdentifier(unittest.TestCase):
+
+    @patch('airflow.models.uuid.uuid4')
+    def test_get_or_create_not_exist(self, mock_uuid):
+        session = settings.Session()
+        session.query(KubeWorkerIdentifier).update({
+            KubeWorkerIdentifier.worker_uuid: ''
+        })
+        mock_uuid.return_value = 'abcde'
+        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
+        self.assertEqual(worker_uuid, 'abcde')
+
+    def test_get_or_create_exist(self):
+        session = settings.Session()
+        KubeWorkerIdentifier.checkpoint_kube_worker_uuid('fghij', session)
+        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
+        self.assertEqual(worker_uuid, 'fghij')
diff --git a/tests/test_models.py b/tests/test_models.py
index edea71fdfe172..264151ea22685 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -49,7 +49,6 @@
 from airflow.jobs import BackfillJob
 from airflow.models import DAG, TaskInstance as TI, DagBag
 from airflow.models import DagModel, DagRun
-from airflow.models import KubeResourceVersion, KubeWorkerIdentifier
 from airflow.models import SkipMixin
 from airflow.models import State as ST
 from airflow.models import XCom
@@ -3591,36 +3590,3 @@ def test_skip_none_tasks(self):
         SkipMixin().skip(dag_run=None, execution_date=None, tasks=[], session=session)
         self.assertFalse(session.query.called)
         self.assertFalse(session.commit.called)
-
-
-class TestKubeResourceVersion(unittest.TestCase):
-
-    def test_checkpoint_resource_version(self):
-        session = settings.Session()
-        KubeResourceVersion.checkpoint_resource_version('7', session)
-        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '7')
-
-    def test_reset_resource_version(self):
-        session = settings.Session()
-        version = KubeResourceVersion.reset_resource_version(session)
-        self.assertEqual(version, '0')
-        self.assertEqual(KubeResourceVersion.get_current_resource_version(session), '0')
-
-
-class TestKubeWorkerIdentifier(unittest.TestCase):
-
-    @patch('airflow.models.uuid.uuid4')
-    def test_get_or_create_not_exist(self, mock_uuid):
-        session = settings.Session()
-        session.query(KubeWorkerIdentifier).update({
-            KubeWorkerIdentifier.worker_uuid: ''
-        })
-        mock_uuid.return_value = 'abcde'
-        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
-        self.assertEqual(worker_uuid, 'abcde')
-
-    def test_get_or_create_exist(self):
-        session = settings.Session()
-        KubeWorkerIdentifier.checkpoint_kube_worker_uuid('fghij', session)
-        worker_uuid = KubeWorkerIdentifier.get_or_create_current_kube_worker_uuid(session)
-        self.assertEqual(worker_uuid, 'fghij')

From 5a01be0e9b63664ece490573027491efa059aab1 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Sun, 31 Mar 2019 18:35:09 +0200
Subject: [PATCH 774/808] [AIRFLOW-3458] Move connection tests (#4680)

---
 tests/models/__init__.py        |  18 +++
 tests/models/test_connection.py | 276 ++++++++++++++++++++++++++++++++
 tests/models/test_kubernetes.py |   2 +-
 tests/test_models.py            | 251 -----------------------------
 4 files changed, 295 insertions(+), 252 deletions(-)
 create mode 100644 tests/models/__init__.py
 create mode 100644 tests/models/test_connection.py

diff --git a/tests/models/__init__.py b/tests/models/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/tests/models/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/tests/models/test_connection.py b/tests/models/test_connection.py
new file mode 100644
index 0000000000000..939869e31b688
--- /dev/null
+++ b/tests/models/test_connection.py
@@ -0,0 +1,276 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from collections import namedtuple
+
+from cryptography.fernet import Fernet
+from mock import patch
+from parameterized import parameterized
+
+from airflow import models
+from airflow.models.connection import Connection
+
+ConnectionParts = namedtuple("ConnectionParts", ["conn_type", "login", "password", "host", "port", "schema"])
+
+
+class ConnectionTest(unittest.TestCase):
+    def setUp(self):
+        models._fernet = None
+
+    def tearDown(self):
+        models._fernet = None
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_connection_extra_no_encryption(self, mock_get):
+        """
+        Tests extras on a new connection without encryption. The fernet key
+        is set to a non-base64-encoded string and the extra is stored without
+        encryption.
+        """
+        mock_get.return_value = ''
+        test_connection = Connection(extra='testextra')
+        self.assertFalse(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_connection_extra_with_encryption(self, mock_get):
+        """
+        Tests extras on a new connection with encryption.
+        """
+        mock_get.return_value = Fernet.generate_key().decode()
+        test_connection = Connection(extra='testextra')
+        self.assertTrue(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+
+    @patch('airflow.models.configuration.conf.get')
+    def test_connection_extra_with_encryption_rotate_fernet_key(self, mock_get):
+        """
+        Tests rotating encrypted extras.
+        """
+        key1 = Fernet.generate_key()
+        key2 = Fernet.generate_key()
+
+        mock_get.return_value = key1.decode()
+        test_connection = Connection(extra='testextra')
+        self.assertTrue(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+        self.assertEqual(Fernet(key1).decrypt(test_connection._extra.encode()), b'testextra')
+
+        # Test decrypt of old value with new key
+        mock_get.return_value = ','.join([key2.decode(), key1.decode()])
+        models._fernet = None
+        self.assertEqual(test_connection.extra, 'testextra')
+
+        # Test decrypt of new value with new key
+        test_connection.rotate_fernet_key()
+        self.assertTrue(test_connection.is_extra_encrypted)
+        self.assertEqual(test_connection.extra, 'testextra')
+        self.assertEqual(Fernet(key2).decrypt(test_connection._extra.encode()), b'testextra')
+
+    def test_connection_from_uri_without_extras(self):
+        uri = 'scheme://user:password@host%2flocation:1234/schema'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+        self.assertIsNone(connection.extra)
+
+    def test_connection_from_uri_with_extras(self):
+        uri = 'scheme://user:password@host%2flocation:1234/schema?' \
+              'extra1=a%20value&extra2=%2fpath%2f'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+        self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
+                                                       'extra2': '/path/'})
+
+    def test_connection_from_uri_with_colon_in_hostname(self):
+        uri = 'scheme://user:password@host%2flocation%3ax%3ay:1234/schema?' \
+              'extra1=a%20value&extra2=%2fpath%2f'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+        self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
+                                                       'extra2': '/path/'})
+
+    def test_connection_from_uri_with_encoded_password(self):
+        uri = 'scheme://user:password%20with%20space@host%2flocation%3ax%3ay:1234/schema'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_encoded_user(self):
+        uri = 'scheme://domain%2fuser:password@host%2flocation%3ax%3ay:1234/schema'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host/location:x:y')
+        self.assertEqual(connection.schema, 'schema')
+        self.assertEqual(connection.login, 'domain/user')
+        self.assertEqual(connection.password, 'password')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_encoded_schema(self):
+        uri = 'scheme://user:password%20with%20space@host:1234/schema%2ftest'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, 'schema/test')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_no_schema(self):
+        uri = 'scheme://user:password%20with%20space@host:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, 'user')
+        self.assertEqual(connection.password, 'password with space')
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_underscore(self):
+        uri = 'google-cloud-platform://?extra__google_cloud_platform__key_' \
+              'path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=' \
+              'https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra' \
+              '__google_cloud_platform__project=airflow'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'google_cloud_platform')
+        self.assertEqual(connection.host, '')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.extra_dejson, dict(
+            extra__google_cloud_platform__key_path='/keys/key.json',
+            extra__google_cloud_platform__project='airflow',
+            extra__google_cloud_platform__scope='https://www.googleapis.com/'
+                                                'auth/cloud-platform'))
+
+    def test_connection_from_uri_without_authinfo(self):
+        uri = 'scheme://host:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, 'host')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.port, 1234)
+
+    def test_connection_from_uri_with_path(self):
+        uri = 'scheme://%2FTmP%2F:1234'
+        connection = Connection(uri=uri)
+        self.assertEqual(connection.conn_type, 'scheme')
+        self.assertEqual(connection.host, '/TmP/')
+        self.assertEqual(connection.schema, '')
+        self.assertEqual(connection.login, None)
+        self.assertEqual(connection.password, None)
+        self.assertEqual(connection.port, 1234)
+
+    @parameterized.expand(
+        [
+            (
+                "http://:password@host:80/database",
+                ConnectionParts(
+                    conn_type="http", login='', password="password", host="host", port=80, schema="database"
+                ),
+            ),
+            (
+                "http://user:@host:80/database",
+                ConnectionParts(
+                    conn_type="http", login="user", password=None, host="host", port=80, schema="database"
+                ),
+            ),
+            (
+                "http://user:password@/database",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="", port=None, schema="database"
+                ),
+            ),
+            (
+                "http://user:password@host:80/",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="host", port=80, schema=""
+                ),
+            ),
+            (
+                "http://user:password@/",
+                ConnectionParts(
+                    conn_type="http", login="user", password="password", host="", port=None, schema=""
+                ),
+            ),
+            (
+                "postgresql://user:password@%2Ftmp%2Fz6rqdzqh%2Fexample%3Awest1%3Atestdb/testdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login="user",
+                    password="password",
+                    host="/tmp/z6rqdzqh/example:west1:testdb",
+                    port=None,
+                    schema="testdb",
+                ),
+            ),
+            (
+                "postgresql://user@%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb/testdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login="user",
+                    password=None,
+                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
+                    port=None,
+                    schema="testdb",
+                ),
+            ),
+            (
+                "postgresql://%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb",
+                ConnectionParts(
+                    conn_type="postgres",
+                    login=None,
+                    password=None,
+                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
+                    port=None,
+                    schema="",
+                ),
+            ),
+        ]
+    )
+    def test_connection_from_with_auth_info(self, uri, uri_parts):
+        connection = Connection(uri=uri)
+
+        self.assertEqual(connection.conn_type, uri_parts.conn_type)
+        self.assertEqual(connection.login, uri_parts.login)
+        self.assertEqual(connection.password, uri_parts.password)
+        self.assertEqual(connection.host, uri_parts.host)
+        self.assertEqual(connection.port, uri_parts.port)
+        self.assertEqual(connection.schema, uri_parts.schema)
diff --git a/tests/models/test_kubernetes.py b/tests/models/test_kubernetes.py
index 45bea723277ec..e01a88784cd4a 100644
--- a/tests/models/test_kubernetes.py
+++ b/tests/models/test_kubernetes.py
@@ -41,7 +41,7 @@ def test_reset_resource_version(self):
 
 class TestKubeWorkerIdentifier(unittest.TestCase):
 
-    @patch('airflow.models.uuid.uuid4')
+    @patch('airflow.models.kubernetes.uuid.uuid4')
     def test_get_or_create_not_exist(self, mock_uuid):
         session = settings.Session()
         session.query(KubeWorkerIdentifier).update({
diff --git a/tests/test_models.py b/tests/test_models.py
index 264151ea22685..2f9670f27bc93 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -33,7 +33,6 @@
 import urllib
 import uuid
 import shutil
-from collections import namedtuple
 from tempfile import NamedTemporaryFile, mkdtemp
 
 import pendulum
@@ -54,7 +53,6 @@
 from airflow.models import XCom
 from airflow.models import Variable
 from airflow.models import clear_task_instances
-from airflow.models.connection import Connection
 from airflow.models.taskfail import TaskFail
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.operators.bash_operator import BashOperator
@@ -3280,255 +3278,6 @@ def test_var_with_encryption_rotate_fernet_key(self, mock_get):
         self.assertEqual(Fernet(key2).decrypt(test_var._val.encode()), b'value')
 
 
-ConnectionParts = namedtuple("ConnectionParts", ["conn_type", "login", "password", "host", "port", "schema"])
-
-
-class ConnectionTest(unittest.TestCase):
-    def setUp(self):
-        models._fernet = None
-
-    def tearDown(self):
-        models._fernet = None
-
-    @patch('airflow.models.configuration.conf.get')
-    def test_connection_extra_no_encryption(self, mock_get):
-        """
-        Tests extras on a new connection without encryption. The fernet key
-        is set to a non-base64-encoded string and the extra is stored without
-        encryption.
-        """
-        mock_get.return_value = ''
-        test_connection = Connection(extra='testextra')
-        self.assertFalse(test_connection.is_extra_encrypted)
-        self.assertEqual(test_connection.extra, 'testextra')
-
-    @patch('airflow.models.configuration.conf.get')
-    def test_connection_extra_with_encryption(self, mock_get):
-        """
-        Tests extras on a new connection with encryption.
-        """
-        mock_get.return_value = Fernet.generate_key().decode()
-        test_connection = Connection(extra='testextra')
-        self.assertTrue(test_connection.is_extra_encrypted)
-        self.assertEqual(test_connection.extra, 'testextra')
-
-    @patch('airflow.models.configuration.conf.get')
-    def test_connection_extra_with_encryption_rotate_fernet_key(self, mock_get):
-        """
-        Tests rotating encrypted extras.
-        """
-        key1 = Fernet.generate_key()
-        key2 = Fernet.generate_key()
-
-        mock_get.return_value = key1.decode()
-        test_connection = Connection(extra='testextra')
-        self.assertTrue(test_connection.is_extra_encrypted)
-        self.assertEqual(test_connection.extra, 'testextra')
-        self.assertEqual(Fernet(key1).decrypt(test_connection._extra.encode()), b'testextra')
-
-        # Test decrypt of old value with new key
-        mock_get.return_value = ','.join([key2.decode(), key1.decode()])
-        models._fernet = None
-        self.assertEqual(test_connection.extra, 'testextra')
-
-        # Test decrypt of new value with new key
-        test_connection.rotate_fernet_key()
-        self.assertTrue(test_connection.is_extra_encrypted)
-        self.assertEqual(test_connection.extra, 'testextra')
-        self.assertEqual(Fernet(key2).decrypt(test_connection._extra.encode()), b'testextra')
-
-    def test_connection_from_uri_without_extras(self):
-        uri = 'scheme://user:password@host%2flocation:1234/schema'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host/location')
-        self.assertEqual(connection.schema, 'schema')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password')
-        self.assertEqual(connection.port, 1234)
-        self.assertIsNone(connection.extra)
-
-    def test_connection_from_uri_with_extras(self):
-        uri = 'scheme://user:password@host%2flocation:1234/schema?' \
-              'extra1=a%20value&extra2=%2fpath%2f'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host/location')
-        self.assertEqual(connection.schema, 'schema')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password')
-        self.assertEqual(connection.port, 1234)
-        self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
-                                                       'extra2': '/path/'})
-
-    def test_connection_from_uri_with_colon_in_hostname(self):
-        uri = 'scheme://user:password@host%2flocation%3ax%3ay:1234/schema?' \
-              'extra1=a%20value&extra2=%2fpath%2f'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host/location:x:y')
-        self.assertEqual(connection.schema, 'schema')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password')
-        self.assertEqual(connection.port, 1234)
-        self.assertDictEqual(connection.extra_dejson, {'extra1': 'a value',
-                                                       'extra2': '/path/'})
-
-    def test_connection_from_uri_with_encoded_password(self):
-        uri = 'scheme://user:password%20with%20space@host%2flocation%3ax%3ay:1234/schema'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host/location:x:y')
-        self.assertEqual(connection.schema, 'schema')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password with space')
-        self.assertEqual(connection.port, 1234)
-
-    def test_connection_from_uri_with_encoded_user(self):
-        uri = 'scheme://domain%2fuser:password@host%2flocation%3ax%3ay:1234/schema'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host/location:x:y')
-        self.assertEqual(connection.schema, 'schema')
-        self.assertEqual(connection.login, 'domain/user')
-        self.assertEqual(connection.password, 'password')
-        self.assertEqual(connection.port, 1234)
-
-    def test_connection_from_uri_with_encoded_schema(self):
-        uri = 'scheme://user:password%20with%20space@host:1234/schema%2ftest'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host')
-        self.assertEqual(connection.schema, 'schema/test')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password with space')
-        self.assertEqual(connection.port, 1234)
-
-    def test_connection_from_uri_no_schema(self):
-        uri = 'scheme://user:password%20with%20space@host:1234'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host')
-        self.assertEqual(connection.schema, '')
-        self.assertEqual(connection.login, 'user')
-        self.assertEqual(connection.password, 'password with space')
-        self.assertEqual(connection.port, 1234)
-
-    def test_connection_from_uri_with_underscore(self):
-        uri = 'google-cloud-platform://?extra__google_cloud_platform__key_' \
-              'path=%2Fkeys%2Fkey.json&extra__google_cloud_platform__scope=' \
-              'https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&extra' \
-              '__google_cloud_platform__project=airflow'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'google_cloud_platform')
-        self.assertEqual(connection.host, '')
-        self.assertEqual(connection.schema, '')
-        self.assertEqual(connection.login, None)
-        self.assertEqual(connection.password, None)
-        self.assertEqual(connection.extra_dejson, dict(
-            extra__google_cloud_platform__key_path='/keys/key.json',
-            extra__google_cloud_platform__project='airflow',
-            extra__google_cloud_platform__scope='https://www.googleapis.com/'
-                                                'auth/cloud-platform'))
-
-    def test_connection_from_uri_without_authinfo(self):
-        uri = 'scheme://host:1234'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, 'host')
-        self.assertEqual(connection.schema, '')
-        self.assertEqual(connection.login, None)
-        self.assertEqual(connection.password, None)
-        self.assertEqual(connection.port, 1234)
-
-    def test_connection_from_uri_with_path(self):
-        uri = 'scheme://%2FTmP%2F:1234'
-        connection = Connection(uri=uri)
-        self.assertEqual(connection.conn_type, 'scheme')
-        self.assertEqual(connection.host, '/TmP/')
-        self.assertEqual(connection.schema, '')
-        self.assertEqual(connection.login, None)
-        self.assertEqual(connection.password, None)
-        self.assertEqual(connection.port, 1234)
-
-    @parameterized.expand(
-        [
-            (
-                "http://:password@host:80/database",
-                ConnectionParts(
-                    conn_type="http", login='', password="password", host="host", port=80, schema="database"
-                ),
-            ),
-            (
-                "http://user:@host:80/database",
-                ConnectionParts(
-                    conn_type="http", login="user", password=None, host="host", port=80, schema="database"
-                ),
-            ),
-            (
-                "http://user:password@/database",
-                ConnectionParts(
-                    conn_type="http", login="user", password="password", host="", port=None, schema="database"
-                ),
-            ),
-            (
-                "http://user:password@host:80/",
-                ConnectionParts(
-                    conn_type="http", login="user", password="password", host="host", port=80, schema=""
-                ),
-            ),
-            (
-                "http://user:password@/",
-                ConnectionParts(
-                    conn_type="http", login="user", password="password", host="", port=None, schema=""
-                ),
-            ),
-            (
-                "postgresql://user:password@%2Ftmp%2Fz6rqdzqh%2Fexample%3Awest1%3Atestdb/testdb",
-                ConnectionParts(
-                    conn_type="postgres",
-                    login="user",
-                    password="password",
-                    host="/tmp/z6rqdzqh/example:west1:testdb",
-                    port=None,
-                    schema="testdb",
-                ),
-            ),
-            (
-                "postgresql://user@%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb/testdb",
-                ConnectionParts(
-                    conn_type="postgres",
-                    login="user",
-                    password=None,
-                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
-                    port=None,
-                    schema="testdb",
-                ),
-            ),
-            (
-                "postgresql://%2Ftmp%2Fz6rqdzqh%2Fexample%3Aeurope-west1%3Atestdb",
-                ConnectionParts(
-                    conn_type="postgres",
-                    login=None,
-                    password=None,
-                    host="/tmp/z6rqdzqh/example:europe-west1:testdb",
-                    port=None,
-                    schema="",
-                ),
-            ),
-        ]
-    )
-    def test_connection_from_with_auth_info(self, uri, uri_parts):
-        connection = Connection(uri=uri)
-
-        self.assertEqual(connection.conn_type, uri_parts.conn_type)
-        self.assertEqual(connection.login, uri_parts.login)
-        self.assertEqual(connection.password, uri_parts.password)
-        self.assertEqual(connection.host, uri_parts.host)
-        self.assertEqual(connection.port, uri_parts.port)
-        self.assertEqual(connection.schema, uri_parts.schema)
-
-
 class TestSkipMixin(unittest.TestCase):
 
     @patch('airflow.models.timezone.utcnow')

From 8f14f641defdee963cbcca6930a3751697d8188e Mon Sep 17 00:00:00 2001
From: andyh1203 <andyh1203@users.noreply.github.com>
Date: Fri, 1 Feb 2019 22:09:41 -0800
Subject: [PATCH 775/808] [AIRFLOW-3463] Move Log out of models.py (#4639)

---
 airflow/models/__init__.py                    | 45 +-----------
 airflow/models/log.py                         | 68 +++++++++++++++++++
 airflow/utils/cli.py                          |  6 +-
 airflow/www_rbac/decorators.py                |  4 +-
 airflow/www_rbac/views.py                     |  3 +-
 .../common/experimental/test_delete_dag.py    |  2 +-
 6 files changed, 77 insertions(+), 51 deletions(-)
 create mode 100644 airflow/models/log.py

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 4fcfa64aec4d9..6c454c9ac41f6 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -89,6 +89,7 @@
 from airflow.models.errors import ImportError  # noqa: F401
 from airflow.models.slamiss import SlaMiss  # noqa: F401
 from airflow.models.kubernetes import KubeWorkerIdentifier, KubeResourceVersion  # noqa: F401
+from airflow.models.log import Log
 from airflow.models.taskfail import TaskFail
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.ti_deps.deps.not_in_retry_period_dep import NotInRetryPeriodDep
@@ -1933,50 +1934,6 @@ def init_run_context(self, raw=False):
         self._set_context(self)
 
 
-class Log(Base):
-    """
-    Used to actively log events to the database
-    """
-
-    __tablename__ = "log"
-
-    id = Column(Integer, primary_key=True)
-    dttm = Column(UtcDateTime)
-    dag_id = Column(String(ID_LEN))
-    task_id = Column(String(ID_LEN))
-    event = Column(String(30))
-    execution_date = Column(UtcDateTime)
-    owner = Column(String(500))
-    extra = Column(Text)
-
-    __table_args__ = (
-        Index('idx_log_dag', dag_id),
-    )
-
-    def __init__(self, event, task_instance, owner=None, extra=None, **kwargs):
-        self.dttm = timezone.utcnow()
-        self.event = event
-        self.extra = extra
-
-        task_owner = None
-
-        if task_instance:
-            self.dag_id = task_instance.dag_id
-            self.task_id = task_instance.task_id
-            self.execution_date = task_instance.execution_date
-            task_owner = task_instance.task.owner
-
-        if 'task_id' in kwargs:
-            self.task_id = kwargs['task_id']
-        if 'dag_id' in kwargs:
-            self.dag_id = kwargs['dag_id']
-        if 'execution_date' in kwargs:
-            if kwargs['execution_date']:
-                self.execution_date = kwargs['execution_date']
-
-        self.owner = owner or task_owner
-
-
 class SkipMixin(LoggingMixin):
     @provide_session
     def skip(self, dag_run, execution_date, tasks, session=None):
diff --git a/airflow/models/log.py b/airflow/models/log.py
new file mode 100644
index 0000000000000..fa3fed60ee240
--- /dev/null
+++ b/airflow/models/log.py
@@ -0,0 +1,68 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from sqlalchemy import Column, Integer, String, Text, Index
+
+from airflow.models.base import Base, ID_LEN
+from airflow.utils import timezone
+from airflow.utils.sqlalchemy import UtcDateTime
+
+
+class Log(Base):
+    """
+    Used to actively log events to the database
+    """
+
+    __tablename__ = "log"
+
+    id = Column(Integer, primary_key=True)
+    dttm = Column(UtcDateTime)
+    dag_id = Column(String(ID_LEN))
+    task_id = Column(String(ID_LEN))
+    event = Column(String(30))
+    execution_date = Column(UtcDateTime)
+    owner = Column(String(500))
+    extra = Column(Text)
+
+    __table_args__ = (
+        Index('idx_log_dag', dag_id),
+    )
+
+    def __init__(self, event, task_instance, owner=None, extra=None, **kwargs):
+        self.dttm = timezone.utcnow()
+        self.event = event
+        self.extra = extra
+
+        task_owner = None
+
+        if task_instance:
+            self.dag_id = task_instance.dag_id
+            self.task_id = task_instance.task_id
+            self.execution_date = task_instance.execution_date
+            task_owner = task_instance.task.owner
+
+        if 'task_id' in kwargs:
+            self.task_id = kwargs['task_id']
+        if 'dag_id' in kwargs:
+            self.dag_id = kwargs['dag_id']
+        if 'execution_date' in kwargs:
+            if kwargs['execution_date']:
+                self.execution_date = kwargs['execution_date']
+
+        self.owner = owner or task_owner
diff --git a/airflow/utils/cli.py b/airflow/utils/cli.py
index 32303cd90bd8d..6c3bf42c9458c 100644
--- a/airflow/utils/cli.py
+++ b/airflow/utils/cli.py
@@ -30,7 +30,7 @@
 from argparse import Namespace
 from datetime import datetime
 
-import airflow.models
+from airflow.models.log import Log
 from airflow.utils import cli_action_loggers
 
 
@@ -46,7 +46,7 @@ def action_logging(f):
         end_datetime : end datetime instance by utc
         full_command : full command line arguments
         user : current user
-        log : airflow.models.Log ORM instance
+        log : airflow.models.log.Log ORM instance
         dag_id : dag id (optional)
         task_id : task_id (optional)
         execution_date : execution date (optional)
@@ -105,7 +105,7 @@ def _build_metrics(func_name, namespace):
     metrics['host_name'] = socket.gethostname()
 
     extra = json.dumps(dict((k, metrics[k]) for k in ('host_name', 'full_command')))
-    log = airflow.models.Log(
+    log = Log(
         event='cli_{}'.format(func_name),
         task_instance=None,
         owner=metrics['user'],
diff --git a/airflow/www_rbac/decorators.py b/airflow/www_rbac/decorators.py
index 4ec2c7e8e9774..889a0b1b33b2f 100644
--- a/airflow/www_rbac/decorators.py
+++ b/airflow/www_rbac/decorators.py
@@ -22,7 +22,7 @@
 import pendulum
 from io import BytesIO as IO
 from flask import after_this_request, redirect, request, url_for, g
-from airflow import models
+from airflow.models.log import Log
 from airflow.utils.db import create_session
 
 
@@ -39,7 +39,7 @@ def wrapper(*args, **kwargs):
             else:
                 user = g.user.username
 
-            log = models.Log(
+            log = Log(
                 event=f.__name__,
                 task_instance=None,
                 owner=user,
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index d6060629c81b6..c44d25bd474c8 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -55,6 +55,7 @@
                                                         set_dag_run_state_to_failed)
 from airflow.models import XCom, DagRun, errors, DagModel
 from airflow.models.connection import Connection
+from airflow.models.log import Log
 from airflow.models.taskfail import TaskFail
 from airflow.ti_deps.dep_context import DepContext, QUEUE_DEPS, SCHEDULER_DEPS
 from airflow.utils import timezone
@@ -2277,7 +2278,7 @@ def action_set_success(self, drs, session=None):
 class LogModelView(AirflowModelView):
     route_base = '/log'
 
-    datamodel = AirflowModelView.CustomSQLAInterface(models.Log)
+    datamodel = AirflowModelView.CustomSQLAInterface(Log)
 
     base_permissions = ['can_list']
 
diff --git a/tests/api/common/experimental/test_delete_dag.py b/tests/api/common/experimental/test_delete_dag.py
index aaca6be47d781..3ab2c030a4e60 100644
--- a/tests/api/common/experimental/test_delete_dag.py
+++ b/tests/api/common/experimental/test_delete_dag.py
@@ -30,7 +30,7 @@
 DM = models.DagModel
 DR = models.DagRun
 TI = models.TaskInstance
-LOG = models.Log
+LOG = models.log.Log
 TF = models.TaskFail
 TR = models.TaskReschedule
 

From 89b9409fa6ed48cf92dec6bd564241020a7f43a8 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Sun, 10 Feb 2019 12:47:41 +0100
Subject: [PATCH 776/808] [AIRFLOW-3464] Move SkipMixin out of models.py
 (#4386)

---
 airflow/models/__init__.py                | 43 +---------
 airflow/models/skipmixin.py               | 66 ++++++++++++++++
 airflow/operators/latest_only_operator.py |  3 +-
 airflow/operators/python_operator.py      |  3 +-
 airflow/sensors/base_sensor_operator.py   |  3 +-
 tests/models/test_skipmixin.py            | 95 +++++++++++++++++++++++
 tests/test_models.py                      | 70 +----------------
 7 files changed, 171 insertions(+), 112 deletions(-)
 create mode 100644 airflow/models/skipmixin.py
 create mode 100644 tests/models/test_skipmixin.py

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 6c454c9ac41f6..30d62983a8a9b 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -1934,48 +1934,6 @@ def init_run_context(self, raw=False):
         self._set_context(self)
 
 
-class SkipMixin(LoggingMixin):
-    @provide_session
-    def skip(self, dag_run, execution_date, tasks, session=None):
-        """
-        Sets tasks instances to skipped from the same dag run.
-
-        :param dag_run: the DagRun for which to set the tasks to skipped
-        :param execution_date: execution_date
-        :param tasks: tasks to skip (not task_ids)
-        :param session: db session to use
-        """
-        if not tasks:
-            return
-
-        task_ids = [d.task_id for d in tasks]
-        now = timezone.utcnow()
-
-        if dag_run:
-            session.query(TaskInstance).filter(
-                TaskInstance.dag_id == dag_run.dag_id,
-                TaskInstance.execution_date == dag_run.execution_date,
-                TaskInstance.task_id.in_(task_ids)
-            ).update({TaskInstance.state: State.SKIPPED,
-                      TaskInstance.start_date: now,
-                      TaskInstance.end_date: now},
-                     synchronize_session=False)
-            session.commit()
-        else:
-            assert execution_date is not None, "Execution date is None and no dag run"
-
-            self.log.warning("No DAG RUN present this should not happen")
-            # this is defensive against dag runs that are not complete
-            for task in tasks:
-                ti = TaskInstance(task, execution_date=execution_date)
-                ti.state = State.SKIPPED
-                ti.start_date = now
-                ti.end_date = now
-                session.merge(ti)
-
-            session.commit()
-
-
 @functools.total_ordering
 class BaseOperator(LoggingMixin):
     """
@@ -5070,3 +5028,4 @@ def open_slots(self, session):
 
 # To avoid circular import on Python2.7 we need to define this at the _bottom_
 from airflow.models.connection import Connection  # noqa: E402,F401
+from airflow.models.skipmixin import SkipMixin  # noqa: F401
diff --git a/airflow/models/skipmixin.py b/airflow/models/skipmixin.py
new file mode 100644
index 0000000000000..c0adbd20aa4a4
--- /dev/null
+++ b/airflow/models/skipmixin.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.models import TaskInstance
+from airflow.utils import timezone
+from airflow.utils.db import provide_session
+from airflow.utils.log.logging_mixin import LoggingMixin
+from airflow.utils.state import State
+
+
+class SkipMixin(LoggingMixin):
+    @provide_session
+    def skip(self, dag_run, execution_date, tasks, session=None):
+        """
+        Sets tasks instances to skipped from the same dag run.
+
+        :param dag_run: the DagRun for which to set the tasks to skipped
+        :param execution_date: execution_date
+        :param tasks: tasks to skip (not task_ids)
+        :param session: db session to use
+        """
+        if not tasks:
+            return
+
+        task_ids = [d.task_id for d in tasks]
+        now = timezone.utcnow()
+
+        if dag_run:
+            session.query(TaskInstance).filter(
+                TaskInstance.dag_id == dag_run.dag_id,
+                TaskInstance.execution_date == dag_run.execution_date,
+                TaskInstance.task_id.in_(task_ids)
+            ).update({TaskInstance.state: State.SKIPPED,
+                      TaskInstance.start_date: now,
+                      TaskInstance.end_date: now},
+                     synchronize_session=False)
+            session.commit()
+        else:
+            assert execution_date is not None, "Execution date is None and no dag run"
+
+            self.log.warning("No DAG RUN present this should not happen")
+            # this is defensive against dag runs that are not complete
+            for task in tasks:
+                ti = TaskInstance(task, execution_date=execution_date)
+                ti.state = State.SKIPPED
+                ti.start_date = now
+                ti.end_date = now
+                session.merge(ti)
+
+            session.commit()
diff --git a/airflow/operators/latest_only_operator.py b/airflow/operators/latest_only_operator.py
index 113977491cc4b..6fee50965d42a 100644
--- a/airflow/operators/latest_only_operator.py
+++ b/airflow/operators/latest_only_operator.py
@@ -17,7 +17,8 @@
 # specific language governing permissions and limitations
 # under the License.
 
-from airflow.models import BaseOperator, SkipMixin
+from airflow.models import BaseOperator
+from airflow.models.skipmixin import SkipMixin
 from airflow.utils import timezone
 
 
diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index a69eb535196ce..30f5290973b74 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -29,7 +29,8 @@
 from builtins import str
 
 from airflow.exceptions import AirflowException
-from airflow.models import BaseOperator, SkipMixin
+from airflow.models import BaseOperator
+from airflow.models.skipmixin import SkipMixin
 from airflow.utils.decorators import apply_defaults
 from airflow.utils.file import TemporaryDirectory
 from airflow.utils.operator_helpers import context_to_airflow_vars
diff --git a/airflow/sensors/base_sensor_operator.py b/airflow/sensors/base_sensor_operator.py
index 2e99704c86feb..fe96a36d8b3ec 100644
--- a/airflow/sensors/base_sensor_operator.py
+++ b/airflow/sensors/base_sensor_operator.py
@@ -23,7 +23,8 @@
 
 from airflow.exceptions import AirflowException, AirflowSensorTimeout, \
     AirflowSkipException, AirflowRescheduleException
-from airflow.models import BaseOperator, SkipMixin
+from airflow.models import BaseOperator
+from airflow.models.skipmixin import SkipMixin
 from airflow.models.taskreschedule import TaskReschedule
 from airflow.utils import timezone
 from airflow.utils.decorators import apply_defaults
diff --git a/tests/models/test_skipmixin.py b/tests/models/test_skipmixin.py
new file mode 100644
index 0000000000000..9b1230409dc2c
--- /dev/null
+++ b/tests/models/test_skipmixin.py
@@ -0,0 +1,95 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import datetime
+import unittest
+
+import pendulum
+from mock import patch, Mock
+
+from airflow.models import settings, DAG, TaskInstance as TI
+from airflow.models.skipmixin import SkipMixin
+from airflow.operators.dummy_operator import DummyOperator
+from airflow.utils import timezone
+from airflow.utils.state import State
+
+DEFAULT_DATE = timezone.datetime(2016, 1, 1)
+
+
+class TestSkipMixin(unittest.TestCase):
+
+    @patch('airflow.models.timezone.utcnow')
+    def test_skip(self, mock_now):
+        session = settings.Session()
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+        )
+        with dag:
+            tasks = [DummyOperator(task_id='task')]
+        dag_run = dag.create_dagrun(
+            run_id='manual__' + now.isoformat(),
+            state=State.FAILED,
+        )
+        SkipMixin().skip(
+            dag_run=dag_run,
+            execution_date=now,
+            tasks=tasks,
+            session=session)
+
+        session.query(TI).filter(
+            TI.dag_id == 'dag',
+            TI.task_id == 'task',
+            TI.state == State.SKIPPED,
+            TI.start_date == now,
+            TI.end_date == now,
+        ).one()
+
+    @patch('airflow.models.timezone.utcnow')
+    def test_skip_none_dagrun(self, mock_now):
+        session = settings.Session()
+        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
+        mock_now.return_value = now
+        dag = DAG(
+            'dag',
+            start_date=DEFAULT_DATE,
+        )
+        with dag:
+            tasks = [DummyOperator(task_id='task')]
+        SkipMixin().skip(
+            dag_run=None,
+            execution_date=now,
+            tasks=tasks,
+            session=session)
+
+        session.query(TI).filter(
+            TI.dag_id == 'dag',
+            TI.task_id == 'task',
+            TI.state == State.SKIPPED,
+            TI.start_date == now,
+            TI.end_date == now,
+        ).one()
+
+    def test_skip_none_tasks(self):
+        session = Mock()
+        SkipMixin().skip(dag_run=None, execution_date=None, tasks=[], session=session)
+        self.assertFalse(session.query.called)
+        self.assertFalse(session.commit.called)
diff --git a/tests/test_models.py b/tests/test_models.py
index 2f9670f27bc93..b04c012ff9663 100644
--- a/tests/test_models.py
+++ b/tests/test_models.py
@@ -37,10 +37,10 @@
 
 import pendulum
 import six
-from mock import ANY, Mock, mock_open, patch
-from parameterized import parameterized
-from freezegun import freeze_time
 from cryptography.fernet import Fernet
+from freezegun import freeze_time
+from mock import ANY, mock_open, patch
+from parameterized import parameterized
 
 from airflow import AirflowException, configuration, models, settings
 from airflow.contrib.sensors.python_sensor import PythonSensor
@@ -48,7 +48,6 @@
 from airflow.jobs import BackfillJob
 from airflow.models import DAG, TaskInstance as TI, DagBag
 from airflow.models import DagModel, DagRun
-from airflow.models import SkipMixin
 from airflow.models import State as ST
 from airflow.models import XCom
 from airflow.models import Variable
@@ -3276,66 +3275,3 @@ def test_var_with_encryption_rotate_fernet_key(self, mock_get):
         self.assertTrue(test_var.is_encrypted)
         self.assertEqual(test_var.val, 'value')
         self.assertEqual(Fernet(key2).decrypt(test_var._val.encode()), b'value')
-
-
-class TestSkipMixin(unittest.TestCase):
-
-    @patch('airflow.models.timezone.utcnow')
-    def test_skip(self, mock_now):
-        session = settings.Session()
-        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
-        mock_now.return_value = now
-        dag = DAG(
-            'dag',
-            start_date=DEFAULT_DATE,
-        )
-        with dag:
-            tasks = [DummyOperator(task_id='task')]
-        dag_run = dag.create_dagrun(
-            run_id='manual__' + now.isoformat(),
-            state=State.FAILED,
-        )
-        SkipMixin().skip(
-            dag_run=dag_run,
-            execution_date=now,
-            tasks=tasks,
-            session=session)
-
-        session.query(TI).filter(
-            TI.dag_id == 'dag',
-            TI.task_id == 'task',
-            TI.state == State.SKIPPED,
-            TI.start_date == now,
-            TI.end_date == now,
-        ).one()
-
-    @patch('airflow.models.timezone.utcnow')
-    def test_skip_none_dagrun(self, mock_now):
-        session = settings.Session()
-        now = datetime.datetime.utcnow().replace(tzinfo=pendulum.timezone('UTC'))
-        mock_now.return_value = now
-        dag = DAG(
-            'dag',
-            start_date=DEFAULT_DATE,
-        )
-        with dag:
-            tasks = [DummyOperator(task_id='task')]
-        SkipMixin().skip(
-            dag_run=None,
-            execution_date=now,
-            tasks=tasks,
-            session=session)
-
-        session.query(TI).filter(
-            TI.dag_id == 'dag',
-            TI.task_id == 'task',
-            TI.state == State.SKIPPED,
-            TI.start_date == now,
-            TI.end_date == now,
-        ).one()
-
-    def test_skip_none_tasks(self):
-        session = Mock()
-        SkipMixin().skip(dag_run=None, execution_date=None, tasks=[], session=session)
-        self.assertFalse(session.query.called)
-        self.assertFalse(session.commit.called)

From 3aad18feba552de3318721a26ee1edb0acdb6f03 Mon Sep 17 00:00:00 2001
From: saurabh gulati <saurabh3091@gmail.com>
Date: Sun, 31 Mar 2019 18:55:46 +0200
Subject: [PATCH 777/808] [AIRFLOW-4172] Fix changes for driver class path
 option in Spark Submit (#4992)

---
 UPDATING.md                                          |  9 +++++++++
 airflow/contrib/hooks/spark_submit_hook.py           | 12 ++++++------
 airflow/contrib/operators/spark_submit_operator.py   | 12 ++++++------
 .../contrib/operators/test_spark_submit_operator.py  |  6 +++---
 4 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index bdb35cb1aed6d..3a0667f9927e7 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -200,6 +200,15 @@ The change was made to keep all the operators related to GCS Transfer Services i
 
 The previous imports will continue to work until Airflow 2.0
 
+### Fixed typo in --driver-class-path in SparkSubmitHook
+
+The `driver_classapth` argument  to SparkSubmit Hook and Operator was
+generating `--driver-classpath` on the spark command line, but this isn't a
+valid option to spark.
+
+The argument has been renamed to `driver_class_path`  and  the option it
+generates has been fixed.
+
 ## Airflow 1.10.2
 
 ### DAG level Access Control for new RBAC UI
diff --git a/airflow/contrib/hooks/spark_submit_hook.py b/airflow/contrib/hooks/spark_submit_hook.py
index 51a59d460022a..677ea9000843b 100644
--- a/airflow/contrib/hooks/spark_submit_hook.py
+++ b/airflow/contrib/hooks/spark_submit_hook.py
@@ -47,8 +47,8 @@ class SparkSubmitHook(BaseHook, LoggingMixin):
     :type py_files: str
     :param: archives: Archives that spark should unzip (and possibly tag with #ALIAS) into
         the application working directory.
-    :param driver_classpath: Additional, driver-specific, classpath settings.
-    :type driver_classpath: str
+    :param driver_class_path: Additional, driver-specific, classpath settings.
+    :type driver_class_path: str
     :param jars: Submit additional jars to upload and place them in executor classpath.
     :type jars: str
     :param java_class: the main class of the Java application
@@ -97,7 +97,7 @@ def __init__(self,
                  files=None,
                  py_files=None,
                  archives=None,
-                 driver_classpath=None,
+                 driver_class_path=None,
                  jars=None,
                  java_class=None,
                  packages=None,
@@ -120,7 +120,7 @@ def __init__(self,
         self._files = files
         self._py_files = py_files
         self._archives = archives
-        self._driver_classpath = driver_classpath
+        self._driver_class_path = driver_class_path
         self._jars = jars
         self._java_class = java_class
         self._packages = packages
@@ -250,8 +250,8 @@ def _build_spark_submit_command(self, application):
             connection_cmd += ["--py-files", self._py_files]
         if self._archives:
             connection_cmd += ["--archives", self._archives]
-        if self._driver_classpath:
-            connection_cmd += ["--driver-classpath", self._driver_classpath]
+        if self._driver_class_path:
+            connection_cmd += ["--driver-class-path", self._driver_class_path]
         if self._jars:
             connection_cmd += ["--jars", self._jars]
         if self._packages:
diff --git a/airflow/contrib/operators/spark_submit_operator.py b/airflow/contrib/operators/spark_submit_operator.py
index 93dc08f1f77e0..45a70b64ea827 100644
--- a/airflow/contrib/operators/spark_submit_operator.py
+++ b/airflow/contrib/operators/spark_submit_operator.py
@@ -44,8 +44,8 @@ class SparkSubmitOperator(BaseOperator):
     :type py_files: str
     :param jars: Submit additional jars to upload and place them in executor classpath. (templated)
     :type jars: str
-    :param driver_classpath: Additional, driver-specific, classpath settings. (templated)
-    :type driver_classpath: str
+    :param driver_class_path: Additional, driver-specific, classpath settings. (templated)
+    :type driver_class_path: str
     :param java_class: the main class of the Java application
     :type java_class: str
     :param packages: Comma-separated list of maven coordinates of jars to include on the
@@ -84,7 +84,7 @@ class SparkSubmitOperator(BaseOperator):
                          Some distros may use spark2-submit.
     :type spark_binary: string
     """
-    template_fields = ('_application', '_conf', '_files', '_py_files', '_jars', '_driver_classpath',
+    template_fields = ('_application', '_conf', '_files', '_py_files', '_jars', '_driver_class_path',
                        '_packages', '_exclude_packages', '_keytab', '_principal', '_name',
                        '_application_args', '_env_vars')
     ui_color = WEB_COLORS['LIGHTORANGE']
@@ -97,7 +97,7 @@ def __init__(self,
                  files=None,
                  py_files=None,
                  archives=None,
-                 driver_classpath=None,
+                 driver_class_path=None,
                  jars=None,
                  java_class=None,
                  packages=None,
@@ -123,7 +123,7 @@ def __init__(self,
         self._files = files
         self._py_files = py_files
         self._archives = archives
-        self._driver_classpath = driver_classpath
+        self._driver_class_path = driver_class_path
         self._jars = jars
         self._java_class = java_class
         self._packages = packages
@@ -154,7 +154,7 @@ def execute(self, context):
             files=self._files,
             py_files=self._py_files,
             archives=self._archives,
-            driver_classpath=self._driver_classpath,
+            driver_class_path=self._driver_class_path,
             jars=self._jars,
             java_class=self._java_class,
             packages=self._packages,
diff --git a/tests/contrib/operators/test_spark_submit_operator.py b/tests/contrib/operators/test_spark_submit_operator.py
index b865fda930108..be596ca6ea2eb 100644
--- a/tests/contrib/operators/test_spark_submit_operator.py
+++ b/tests/contrib/operators/test_spark_submit_operator.py
@@ -41,7 +41,7 @@ class TestSparkSubmitOperator(unittest.TestCase):
         'files': 'hive-site.xml',
         'py_files': 'sample_library.py',
         'archives': 'sample_archive.zip#SAMPLE',
-        'driver_classpath': 'parquet.jar',
+        'driver_class_path': 'parquet.jar',
         'jars': 'parquet.jar',
         'packages': 'com.databricks:spark-avro_2.11:3.2.0',
         'exclude_packages': 'org.bad.dependency:1.0.0',
@@ -93,7 +93,7 @@ def test_execute(self):
             'files': 'hive-site.xml',
             'py_files': 'sample_library.py',
             'archives': 'sample_archive.zip#SAMPLE',
-            'driver_classpath': 'parquet.jar',
+            'driver_class_path': 'parquet.jar',
             'jars': 'parquet.jar',
             'packages': 'com.databricks:spark-avro_2.11:3.2.0',
             'exclude_packages': 'org.bad.dependency:1.0.0',
@@ -125,7 +125,7 @@ def test_execute(self):
         self.assertEqual(expected_dict['files'], operator._files)
         self.assertEqual(expected_dict['py_files'], operator._py_files)
         self.assertEqual(expected_dict['archives'], operator._archives)
-        self.assertEqual(expected_dict['driver_classpath'], operator._driver_classpath)
+        self.assertEqual(expected_dict['driver_class_path'], operator._driver_class_path)
         self.assertEqual(expected_dict['jars'], operator._jars)
         self.assertEqual(expected_dict['packages'], operator._packages)
         self.assertEqual(expected_dict['exclude_packages'], operator._exclude_packages)

From 47a744f8a5b62ac61495465c1b93611d507c790f Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Mon, 1 Apr 2019 16:05:28 +0100
Subject: [PATCH 778/808] [AIRFLOW-XXX] Version 1.10.3b2

---
 airflow/version.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/version.py b/airflow/version.py
index 0fd74fd4456b8..153b1ff2a0e67 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.3b1'
+version = '1.10.3b2'

From 7e184fca8c86a884f706ec789adc10973fc001f5 Mon Sep 17 00:00:00 2001
From: Asgeir Berland <asgeir.berland@gmail.com>
Date: Fri, 22 Mar 2019 05:40:59 +0100
Subject: [PATCH 779/808] [AIRFLOW-4127] Correct
 AzureContainerInstanceHook._get_instance_view's return (#4945)

---
 airflow/contrib/hooks/azure_container_instance_hook.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/airflow/contrib/hooks/azure_container_instance_hook.py b/airflow/contrib/hooks/azure_container_instance_hook.py
index 988cbd9e74ba6..3f29c6de4af5a 100644
--- a/airflow/contrib/hooks/azure_container_instance_hook.py
+++ b/airflow/contrib/hooks/azure_container_instance_hook.py
@@ -108,7 +108,7 @@ def _get_instance_view(self, resource_group, name):
         response = self.connection.container_groups.get(resource_group,
                                                         name,
                                                         raw=False)
-        return response.containers[0].instance_view.current_state
+        return response.containers[0].instance_view
 
     def get_messages(self, resource_group, name):
         """

From 9a9ece5d2d6d3161abbd2568f52d0ce9f84bc27c Mon Sep 17 00:00:00 2001
From: marengaz <marengaz@users.noreply.github.com>
Date: Fri, 22 Mar 2019 16:43:50 +0000
Subject: [PATCH 780/808] [AIRFLOW-4144] add description of
 is_delete_operator_pod (#4943)

[AIRFLOW-4144] add description of is_delete_operator_pod
---
 airflow/contrib/operators/kubernetes_pod_operator.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 46cde7d0750c6..1e6eef6203810 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -77,6 +77,10 @@ class KubernetesPodOperator(BaseOperator):
         /airflow/xcom/return.json in the container will also be pushed to an
         XCom when the container completes.
     :type xcom_push: bool
+    :param is_delete_operator_pod: What to do when the pod reaches its final
+        state, or the execution is interrupted.
+        If False (default): do nothing, If True: delete the pod
+    :type is_delete_operator_pod: bool
     :param hostnetwork: If True enable host networking on the pod
     :type hostnetwork: bool
     :param tolerations: A list of kubernetes tolerations

From 41fd951f9087e8cecc0e4255102c9f551e1acda4 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 27 Mar 2019 15:14:58 +0000
Subject: [PATCH 781/808] [AIRFLOW-3419] Fix S3Hook.select_key on Python3
 (#4970)

---
 airflow/hooks/S3_hook.py    | 2 +-
 tests/hooks/test_s3_hook.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/hooks/S3_hook.py b/airflow/hooks/S3_hook.py
index f8ccb370f8ce0..a8e4d865e649a 100644
--- a/airflow/hooks/S3_hook.py
+++ b/airflow/hooks/S3_hook.py
@@ -272,7 +272,7 @@ def select_key(self, key, bucket_name=None,
             InputSerialization=input_serialization,
             OutputSerialization=output_serialization)
 
-        return ''.join(event['Records']['Payload']
+        return ''.join(event['Records']['Payload'].decode('utf-8')
                        for event in response['Payload']
                        if 'Records' in event)
 
diff --git a/tests/hooks/test_s3_hook.py b/tests/hooks/test_s3_hook.py
index e0f9e8a3eca53..62092343cdf0d 100644
--- a/tests/hooks/test_s3_hook.py
+++ b/tests/hooks/test_s3_hook.py
@@ -211,7 +211,7 @@ def test_read_key(self):
     @mock.patch('airflow.contrib.hooks.aws_hook.AwsHook.get_client_type')
     def test_select_key(self, mock_get_client_type):
         mock_get_client_type.return_value.select_object_content.return_value = \
-            {'Payload': [{'Records': {'Payload': u'Contént'}}]}
+            {'Payload': [{'Records': {'Payload': b'Cont\xC3\xA9nt'}}]}
         hook = S3Hook(aws_conn_id=None)
         self.assertEqual(hook.select_key('my_key', 'mybucket'), u'Contént')
 

From 950d059851898447db6537cd663d818ac54f5dc6 Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Tue, 26 Feb 2019 01:50:00 +0800
Subject: [PATCH 782/808] [AIRFLOW-3947] Flash msg for no DAG-level access
 error (#4767)

* [AIRFLOW-3947] Flash msg for no DAG-level access error

It will show and remind user when a user clicks on a DAG that
he/she doesn't have can_dag_read or can_dag_edit permissions.

* Change the flash msg contents
---
 airflow/www_rbac/decorators.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/airflow/www_rbac/decorators.py b/airflow/www_rbac/decorators.py
index 889a0b1b33b2f..1db2dfeb363b6 100644
--- a/airflow/www_rbac/decorators.py
+++ b/airflow/www_rbac/decorators.py
@@ -21,7 +21,7 @@
 import functools
 import pendulum
 from io import BytesIO as IO
-from flask import after_this_request, redirect, request, url_for, g
+from flask import after_this_request, flash, redirect, request, url_for, g
 from airflow.models.log import Log
 from airflow.utils.db import create_session
 
@@ -120,6 +120,7 @@ def wrapper(self, *args, **kwargs):
                                                                    dag_id)))):
                 return f(self, *args, **kwargs)
             else:
+                flash("Access is Denied", "danger")
                 return redirect(url_for(self.appbuilder.sm.auth_view.
                                         __class__.__name__ + ".login"))
         return wrapper

From 4a052013d4c28d53d288fbe159c3b39153b1fc3a Mon Sep 17 00:00:00 2001
From: davlum <david.lum@ssense.com>
Date: Wed, 3 Apr 2019 05:18:39 -0400
Subject: [PATCH 783/808] [AIRFLOW-4008] add envFrom for Kubernetes Executor
 (#4952)

---
 airflow/config_templates/default_airflow.cfg  |  12 +-
 .../contrib/executors/kubernetes_executor.py  |   4 +
 .../kubernetes_request_factory.py             |  16 +-
 airflow/contrib/kubernetes/pod.py             |   6 +-
 airflow/contrib/kubernetes/secret.py          |  40 ++-
 .../kubernetes/worker_configuration.py        |  18 +-
 .../executors/test_kubernetes_executor.py     |  48 ++-
 tests/contrib/kubernetes/__init__.py          |  18 ++
 .../kubernetes_request_factory/__init__.py    |  18 ++
 .../test_kubernetes_request_factory.py        | 306 ++++++++++++++++++
 .../test_pod_request_factory.py               | 159 +++++++++
 11 files changed, 612 insertions(+), 33 deletions(-)
 create mode 100644 tests/contrib/kubernetes/__init__.py
 create mode 100644 tests/contrib/kubernetes/kubernetes_request_factory/__init__.py
 create mode 100644 tests/contrib/kubernetes/kubernetes_request_factory/test_kubernetes_request_factory.py
 create mode 100644 tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index 95f06ccd16e19..b83edefb4cfac 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -644,6 +644,14 @@ dags_volume_host =
 # Useful in local environment, discouraged in production
 logs_volume_host =
 
+# A list of configMapsRefs to envFrom. If more than one configMap is
+# specified, provide a comma separated list: configmap_a,configmap_b
+env_from_configmap_ref =
+
+# A list of secretRefs to envFrom. If more than one secret is
+# specified, provide a comma separated list: secret_a,secret_b
+env_from_secret_ref =
+
 # Git credentials and repository for DAGs mounted via Git (mutually exclusive with volume claim)
 git_repo =
 git_branch =
@@ -753,12 +761,12 @@ tolerations =
 # scheduler. You may define as many secrets as needed and the kubernetes launcher will parse the
 # defined secrets and mount them as secret environment variables in the launched workers.
 # Secrets in this section are defined as follows
-#     <environment_variable_mount> = <kubernetes_secret_object>:<kubernetes_secret_key>
+#     <environment_variable_mount> = <kubernetes_secret_object>=<kubernetes_secret_key>
 #
 # For example if you wanted to mount a kubernetes secret key named `postgres_password` from the
 # kubernetes secret object `airflow-secret` as the environment variable `POSTGRES_PASSWORD` into
 # your workers you would follow the following format:
-#     POSTGRES_PASSWORD = airflow-secret:postgres_credentials
+#     POSTGRES_PASSWORD = airflow-secret=postgres_credentials
 #
 # Additionally you may override worker airflow settings with the AIRFLOW__<SECTION>__<KEY>
 # formatting as supported by airflow normally.
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 38abc5ed85a08..83babdafa44a2 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -125,6 +125,10 @@ def __init__(self):
         self.core_configuration = configuration_dict['core']
         self.kube_secrets = configuration_dict.get('kubernetes_secrets', {})
         self.kube_env_vars = configuration_dict.get('kubernetes_environment_variables', {})
+        self.env_from_configmap_ref = configuration.get(self.kubernetes_section,
+                                                        'env_from_configmap_ref')
+        self.env_from_secret_ref = configuration.get(self.kubernetes_section,
+                                                     'env_from_secret_ref')
         self.airflow_home = settings.AIRFLOW_HOME
         self.dags_folder = configuration.get(self.core_section, 'dags_folder')
         self.parallelism = configuration.getint(self.core_section, 'PARALLELISM')
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
index ea46e1bcd385d..d1b6d4eaf4dca 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/kubernetes_request_factory.py
@@ -75,6 +75,12 @@ def extract_affinity(pod, req):
         for k, v in six.iteritems(pod.affinity):
             req['spec']['affinity'][k] = v
 
+    @staticmethod
+    def extract_node_selector(pod, req):
+        req['spec']['nodeSelector'] = req['spec'].get('nodeSelector', {})
+        for k, v in six.iteritems(pod.node_selectors):
+            req['spec']['nodeSelector'][k] = v
+
     @staticmethod
     def extract_cmds(pod, req):
         req['spec']['containers'][0]['command'] = pod.cmds
@@ -83,12 +89,6 @@ def extract_cmds(pod, req):
     def extract_args(pod, req):
         req['spec']['containers'][0]['args'] = pod.args
 
-    @staticmethod
-    def extract_node_selector(pod, req):
-        req['spec']['nodeSelector'] = req['spec'].get('nodeSelector', {})
-        for k, v in six.iteritems(pod.node_selectors):
-            req['spec']['nodeSelector'][k] = v
-
     @staticmethod
     def attach_volumes(pod, req):
         req['spec']['volumes'] = (
@@ -132,7 +132,7 @@ def extract_volume_secrets(pod, req):
     @staticmethod
     def extract_env_and_secrets(pod, req):
         envs_from_key_secrets = [
-            env for env in pod.secrets if env.deploy_type == 'env' and hasattr(env, 'key')
+            env for env in pod.secrets if env.deploy_type == 'env' and env.key is not None
         ]
 
         if len(pod.envs) > 0 or len(envs_from_key_secrets) > 0:
@@ -206,7 +206,7 @@ def extract_security_context(pod, req):
     @staticmethod
     def _apply_env_from(pod, req):
         envs_from_secrets = [
-            env for env in pod.secrets if env.deploy_type == 'env' and not hasattr(env, 'key')
+            env for env in pod.secrets if env.deploy_type == 'env' and env.key is None
         ]
 
         if pod.configmaps or envs_from_secrets:
diff --git a/airflow/contrib/kubernetes/pod.py b/airflow/contrib/kubernetes/pod.py
index 3d7c138b7e179..f8c0bdffaee08 100644
--- a/airflow/contrib/kubernetes/pod.py
+++ b/airflow/contrib/kubernetes/pod.py
@@ -50,13 +50,13 @@ class Pod:
     :param secrets: Secrets to be launched to the pod
     :type secrets: list[airflow.contrib.kubernetes.secret.Secret]
     :param result: The result that will be returned to the operator after
-                   successful execution of the pod
+        successful execution of the pod
     :type result: any
     :param image_pull_policy: Specify a policy to cache or always pull an image
     :type image_pull_policy: str
     :param image_pull_secrets: Any image pull secrets to be given to the pod.
-                               If more than one secret is required, provide a
-                               comma separated list: secret_a,secret_b
+        If more than one secret is required, provide a comma separated list:
+        secret_a,secret_b
     :type image_pull_secrets: str
     :param affinity: A dict containing a group of affinity scheduling rules
     :type affinity: dict
diff --git a/airflow/contrib/kubernetes/secret.py b/airflow/contrib/kubernetes/secret.py
index d69f507717682..73c51e900acf9 100644
--- a/airflow/contrib/kubernetes/secret.py
+++ b/airflow/contrib/kubernetes/secret.py
@@ -17,7 +17,7 @@
 from airflow.exceptions import AirflowConfigException
 
 
-class Secret:
+class Secret(object):
     """Defines Kubernetes Secret Volume"""
 
     def __init__(self, deploy_type, deploy_target, secret, key=None):
@@ -26,10 +26,10 @@ def __init__(self, deploy_type, deploy_target, secret, key=None):
         :param deploy_type: The type of secret deploy in Kubernetes, either `env` or
             `volume`
         :type deploy_type: str
-        :param deploy_target: The environment variable when `deploy_type` `env` or
-            file path when `deploy_type` `volume` where expose secret.
-            If `key` is not provided deploy target should be None.
-        :type deploy_target: str
+        :param deploy_target: (Optional) The environment variable when
+            `deploy_type` `env` or file path when `deploy_type` `volume` where
+            expose secret. If `key` is not provided deploy target should be None.
+        :type deploy_target: str or None
         :param secret: Name of the secrets object in Kubernetes
         :type secret: str
         :param key: (Optional) Key of the secret within the Kubernetes Secret
@@ -37,18 +37,32 @@ def __init__(self, deploy_type, deploy_target, secret, key=None):
         :type key: str or None
         """
         self.deploy_type = deploy_type
+        self.deploy_target = deploy_target
 
-        if deploy_target:
+        if deploy_target is not None and deploy_type == 'env':
+            # if deploying to env, capitalize the deploy target
             self.deploy_target = deploy_target.upper()
 
-        if deploy_type == 'volume':
-            self.deploy_target = deploy_target
-
-        if not deploy_type == 'env' and key is None:
+        if key is not None and deploy_target is None:
             raise AirflowConfigException(
-                'In deploy_type different than `env` parameter `key` is mandatory'
+                'If `key` is set, `deploy_target` should not be None'
             )
 
         self.secret = secret
-        if key:
-            self.key = key
+        self.key = key
+
+    def __eq__(self, other):
+        return (
+            self.deploy_type == other.deploy_type and
+            self.deploy_target == other.deploy_target and
+            self.secret == other.secret and
+            self.key == other.key
+        )
+
+    def __repr__(self):
+        return 'Secret({}, {}, {}, {})'.format(
+            self.deploy_type,
+            self.deploy_target,
+            self.secret,
+            self.key
+        )
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index e8bc7384a0f82..60128f1479e81 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -155,13 +155,28 @@ def _get_environment(self):
             env['AIRFLOW__CORE__DAGS_FOLDER'] = dag_volume_mount_path
         return env
 
+    def _get_configmaps(self):
+        """Extracts any configmapRefs to envFrom"""
+        if not self.kube_config.env_from_configmap_ref:
+            return []
+        return self.kube_config.env_from_configmap_ref.split(',')
+
     def _get_secrets(self):
         """Defines any necessary secrets for the pod executor"""
         worker_secrets = []
+
         for env_var_name, obj_key_pair in six.iteritems(self.kube_config.kube_secrets):
             k8s_secret_obj, k8s_secret_key = obj_key_pair.split('=')
             worker_secrets.append(
-                Secret('env', env_var_name, k8s_secret_obj, k8s_secret_key))
+                Secret('env', env_var_name, k8s_secret_obj, k8s_secret_key)
+            )
+
+        if self.kube_config.env_from_secret_ref:
+            for secret_ref in self.kube_config.env_from_secret_ref.split(','):
+                worker_secrets.append(
+                    Secret('env', None, secret_ref)
+                )
+
         return worker_secrets
 
     def _get_image_pull_secrets(self):
@@ -331,4 +346,5 @@ def make_pod(self, namespace, worker_uuid, pod_id, dag_id, task_id, execution_da
             affinity=affinity,
             tolerations=tolerations,
             security_context=self._get_security_context(),
+            configmaps=self._get_configmaps()
         )
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 7fac05b8baed5..9e969f390e896 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -1,5 +1,3 @@
-# -*- coding: utf-8 -*-
-#
 # Licensed to the Apache Software Foundation (ASF) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -37,6 +35,7 @@
     from airflow.contrib.executors.kubernetes_executor import KubernetesExecutorConfig
     from airflow.contrib.kubernetes.worker_configuration import WorkerConfiguration
     from airflow.exceptions import AirflowConfigException
+    from airflow.contrib.kubernetes.secret import Secret
 except ImportError:
     AirflowKubernetesScheduler = None
 
@@ -162,11 +161,8 @@ def setUp(self):
         self.resources = mock.patch(
             'airflow.contrib.kubernetes.worker_configuration.Resources'
         )
-        self.secret = mock.patch(
-            'airflow.contrib.kubernetes.worker_configuration.Secret'
-        )
 
-        for patcher in [self.resources, self.secret]:
+        for patcher in [self.resources]:
             self.mock_foo = patcher.start()
             self.addCleanup(patcher.stop)
 
@@ -590,6 +586,46 @@ def test_kubernetes_environment_variables(self):
         env = worker_config._get_environment()
         self.assertEqual(env[core_executor], 'LocalExecutor')
 
+    def test_get_secrets(self):
+        # Test when secretRef is None and kube_secrets is not empty
+        self.kube_config.kube_secrets = {
+            'AWS_SECRET_KEY': 'airflow-secret=aws_secret_key',
+            'POSTGRES_PASSWORD': 'airflow-secret=postgres_credentials'
+        }
+        self.kube_config.env_from_secret_ref = None
+        worker_config = WorkerConfiguration(self.kube_config)
+        secrets = worker_config._get_secrets()
+        secrets.sort(key=lambda secret: secret.deploy_target)
+        expected = [
+            Secret('env', 'AWS_SECRET_KEY', 'airflow-secret', 'aws_secret_key'),
+            Secret('env', 'POSTGRES_PASSWORD', 'airflow-secret', 'postgres_credentials')
+        ]
+        self.assertListEqual(expected, secrets)
+
+        # Test when secret is not empty and kube_secrets is empty dict
+        self.kube_config.kube_secrets = {}
+        self.kube_config.env_from_secret_ref = 'secret_a,secret_b'
+        worker_config = WorkerConfiguration(self.kube_config)
+        secrets = worker_config._get_secrets()
+        expected = [
+            Secret('env', None, 'secret_a'),
+            Secret('env', None, 'secret_b')
+        ]
+        self.assertListEqual(expected, secrets)
+
+    def test_get_configmaps(self):
+        # Test when configmap is empty
+        self.kube_config.env_from_configmap_ref = ''
+        worker_config = WorkerConfiguration(self.kube_config)
+        configmaps = worker_config._get_configmaps()
+        self.assertListEqual([], configmaps)
+
+        # test when configmap is not empty
+        self.kube_config.env_from_configmap_ref = 'configmap_a,configmap_b'
+        worker_config = WorkerConfiguration(self.kube_config)
+        configmaps = worker_config._get_configmaps()
+        self.assertListEqual(['configmap_a', 'configmap_b'], configmaps)
+
 
 class TestKubernetesExecutor(unittest.TestCase):
     """
diff --git a/tests/contrib/kubernetes/__init__.py b/tests/contrib/kubernetes/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/tests/contrib/kubernetes/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/tests/contrib/kubernetes/kubernetes_request_factory/__init__.py b/tests/contrib/kubernetes/kubernetes_request_factory/__init__.py
new file mode 100644
index 0000000000000..114d189da14ab
--- /dev/null
+++ b/tests/contrib/kubernetes/kubernetes_request_factory/__init__.py
@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/tests/contrib/kubernetes/kubernetes_request_factory/test_kubernetes_request_factory.py b/tests/contrib/kubernetes/kubernetes_request_factory/test_kubernetes_request_factory.py
new file mode 100644
index 0000000000000..e7f444abb14a1
--- /dev/null
+++ b/tests/contrib/kubernetes/kubernetes_request_factory/test_kubernetes_request_factory.py
@@ -0,0 +1,306 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.kubernetes.kubernetes_request_factory.\
+    kubernetes_request_factory import KubernetesRequestFactory
+from airflow.contrib.kubernetes.pod import Pod, Resources
+from airflow.contrib.kubernetes.secret import Secret
+from parameterized import parameterized
+import unittest
+import copy
+
+
+class TestKubernetesRequestFactory(unittest.TestCase):
+
+    def setUp(self):
+
+        self.expected = {
+            'apiVersion': 'v1',
+            'kind': 'Pod',
+            'metadata': {
+                'name': 'name'
+            },
+            'spec': {
+                'containers': [{
+                    'name': 'base',
+                    'image': 'airflow-worker:latest',
+                    'command': [
+                        "/usr/local/airflow/entrypoint.sh",
+                        "/bin/bash sleep 25"
+                    ],
+                }],
+                'restartPolicy': 'Never'
+            }
+        }
+        self.input_req = copy.deepcopy(self.expected)
+
+    def test_extract_image(self):
+        image = 'v3.14'
+        pod = Pod(image, {}, [])
+        KubernetesRequestFactory.extract_image(pod, self.input_req)
+        self.expected['spec']['containers'][0]['image'] = image
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_image_pull_policy(self):
+        # Test when pull policy is not none
+        pull_policy = 'IfNotPresent'
+        pod = Pod('v3.14', {}, [], image_pull_policy=pull_policy)
+
+        KubernetesRequestFactory.extract_image_pull_policy(pod, self.input_req)
+        self.expected['spec']['containers'][0]['imagePullPolicy'] = pull_policy
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_add_secret_to_env(self):
+        secret = Secret('env', 'target', 'my-secret', 'KEY')
+        secret_list = []
+        self.expected = [{
+            'name': 'TARGET',
+            'valueFrom': {
+                'secretKeyRef': {
+                    'name': 'my-secret',
+                    'key': 'KEY'
+                }
+            }
+        }]
+        KubernetesRequestFactory.add_secret_to_env(secret_list, secret)
+        self.assertListEqual(secret_list, self.expected)
+
+    def test_extract_labels(self):
+        # Test when labels are not empty
+        labels = {'label_a': 'val_a', 'label_b': 'val_b'}
+        pod = Pod('v3.14', {}, [], labels=labels)
+        self.expected['metadata']['labels'] = labels
+        KubernetesRequestFactory.extract_labels(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_annotations(self):
+        # Test when annotations are not empty
+        annotations = {'annot_a': 'val_a', 'annot_b': 'val_b'}
+        pod = Pod('v3.14', {}, [], annotations=annotations)
+        self.expected['metadata']['annotations'] = annotations
+        KubernetesRequestFactory.extract_annotations(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_affinity(self):
+        # Test when affinity is not empty
+        affinity = {'podAffinity': 'requiredDuringSchedulingIgnoredDuringExecution'}
+        pod = Pod('v3.14', {}, [], affinity=affinity)
+        self.expected['spec']['affinity'] = affinity
+        KubernetesRequestFactory.extract_affinity(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_node_selector(self):
+        # Test when affinity is not empty
+        node_selectors = {'disktype': 'ssd', 'accelerator': 'nvidia-tesla-p100'}
+        pod = Pod('v3.14', {}, [], node_selectors=node_selectors)
+        self.expected['spec']['nodeSelector'] = node_selectors
+        KubernetesRequestFactory.extract_node_selector(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_cmds(self):
+        cmds = ['test-cmd.sh']
+        pod = Pod('v3.14', {}, cmds)
+        KubernetesRequestFactory.extract_cmds(pod, self.input_req)
+        self.expected['spec']['containers'][0]['command'] = cmds
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_args(self):
+        args = ['test_arg.sh']
+        pod = Pod('v3.14', {}, [], args=args)
+        KubernetesRequestFactory.extract_args(pod, self.input_req)
+        self.expected['spec']['containers'][0]['args'] = args
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_attach_volumes(self):
+        # Test when volumes is not empty list
+        volumes = ['vol_a', 'vol_b']
+        pod = Pod('v3.14', {}, [], volumes=volumes)
+        self.expected['spec']['volumes'] = volumes
+        KubernetesRequestFactory.attach_volumes(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_attach_volume_mounts(self):
+        # Test when volumes is not empty list
+        volume_mounts = ['vol_a', 'vol_b']
+        pod = Pod('v3.14', {}, [], volume_mounts=volume_mounts)
+        self.expected['spec']['containers'][0]['volumeMounts'] = volume_mounts
+        KubernetesRequestFactory.attach_volume_mounts(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_name(self):
+        name = 'pod-name'
+        pod = Pod('v3.14', {}, [], name=name)
+        self.expected['metadata']['name'] = name
+        KubernetesRequestFactory.extract_name(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_volume_secrets(self):
+        # Test when secrets is not empty
+        secrets = [
+            Secret('volume', 'KEY1', 's1', 'key-1'),
+            Secret('env', 'KEY2', 's2'),
+            Secret('volume', 'KEY3', 's3', 'key-2')
+        ]
+        pod = Pod('v3.14', {}, [], secrets=secrets)
+        self.expected['spec']['containers'][0]['volumeMounts'] = [{
+            'mountPath': 'KEY1',
+            'name': 'secretvol0',
+            'readOnly': True
+        }, {
+            'mountPath': 'KEY3',
+            'name': 'secretvol1',
+            'readOnly': True
+        }]
+        self.expected['spec']['volumes'] = [{
+            'name': 'secretvol0',
+            'secret': {
+                'secretName': 's1'
+            }
+        }, {
+            'name': 'secretvol1',
+            'secret': {
+                'secretName': 's3'
+            }
+        }]
+        KubernetesRequestFactory.extract_volume_secrets(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_env_and_secrets(self):
+        # Test when secrets and envs are not empty
+        secrets = [
+            Secret('env', None, 's1'),
+            Secret('volume', 'KEY2', 's2', 'key-2'),
+            Secret('env', None, 's3')
+        ]
+        envs = {
+            'ENV1': 'val1',
+            'ENV2': 'val2'
+        }
+        configmaps = ['configmap_a', 'configmap_b']
+        pod = Pod('v3.14', envs, [], secrets=secrets, configmaps=configmaps)
+        self.expected['spec']['containers'][0]['env'] = [
+            {'name': 'ENV1', 'value': 'val1'},
+            {'name': 'ENV2', 'value': 'val2'},
+        ]
+        self.expected['spec']['containers'][0]['envFrom'] = [{
+            'secretRef': {
+                'name': 's1'
+            }
+        }, {
+            'secretRef': {
+                'name': 's3'
+            }
+        }, {
+            'configMapRef': {
+                'name': 'configmap_a'
+            }
+        }, {
+            'configMapRef': {
+                'name': 'configmap_b'
+            }
+        }]
+
+        KubernetesRequestFactory.extract_env_and_secrets(pod, self.input_req)
+        self.input_req['spec']['containers'][0]['env'].sort(key=lambda x: x['name'])
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_resources(self):
+        # Test when resources is not empty
+        resources = Resources('1Gi', 1, '2Gi', 2)
+        pod = Pod('v3.14', {}, [], resources=resources)
+        self.expected['spec']['containers'][0]['resources'] = {
+            'requests': {
+                'memory': '1Gi',
+                'cpu': 1
+            },
+            'limits': {
+                'memory': '2Gi',
+                'cpu': 2
+            },
+        }
+        KubernetesRequestFactory.extract_resources(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_init_containers(self):
+        init_container = 'init_container'
+        pod = Pod('v3.14', {}, [], init_containers=init_container)
+        self.expected['spec']['initContainers'] = init_container
+        KubernetesRequestFactory.extract_init_containers(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_service_account_name(self):
+        service_account_name = 'service_account_name'
+        pod = Pod('v3.14', {}, [], service_account_name=service_account_name)
+        self.expected['spec']['serviceAccountName'] = service_account_name
+        KubernetesRequestFactory.extract_service_account_name(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_hostnetwork(self):
+        hostnetwork = True
+        pod = Pod('v3.14', {}, [], hostnetwork=hostnetwork)
+        self.expected['spec']['hostNetwork'] = hostnetwork
+        KubernetesRequestFactory.extract_hostnetwork(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_image_pull_secrets(self):
+        image_pull_secrets = 'secret_a,secret_b,secret_c'
+        pod = Pod('v3.14', {}, [], image_pull_secrets=image_pull_secrets)
+        self.expected['spec']['imagePullSecrets'] = [
+            {'name': 'secret_a'},
+            {'name': 'secret_b'},
+            {'name': 'secret_c'},
+        ]
+        KubernetesRequestFactory.extract_image_pull_secrets(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_extract_tolerations(self):
+        tolerations = [{
+            'key': 'key',
+            'operator': 'Equal',
+            'value': 'value',
+            'effect': 'NoSchedule'
+        }]
+        pod = Pod('v3.14', {}, [], tolerations=tolerations)
+        self.expected['spec']['tolerations'] = tolerations
+        KubernetesRequestFactory.extract_tolerations(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    def test_security_context(self):
+        security_context = {
+            'runAsUser': 1000,
+            'fsGroup': 2000
+        }
+        pod = Pod('v3.14', {}, [], security_context=security_context)
+        self.expected['spec']['securityContext'] = security_context
+        KubernetesRequestFactory.extract_security_context(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
+
+    @parameterized.expand([
+        'extract_resources',
+        'extract_init_containers',
+        'extract_service_account_name',
+        'extract_hostnetwork',
+        'extract_image_pull_secrets',
+        'extract_tolerations',
+        'extract_security_context',
+        'extract_volume_secrets'
+    ])
+    def test_identity(self, name):
+        kube_request_factory_func = getattr(KubernetesRequestFactory, name)
+        pod = Pod('v3.14', {}, [])
+        kube_request_factory_func(pod, self.input_req)
+        self.assertEqual(self.input_req, self.expected)
diff --git a/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py b/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py
new file mode 100644
index 0000000000000..ff835ed0c9ec4
--- /dev/null
+++ b/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py
@@ -0,0 +1,159 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.kubernetes.kubernetes_request_factory.\
+    pod_request_factory import SimplePodRequestFactory, \
+    ExtractXcomPodRequestFactory
+from airflow.contrib.kubernetes.pod import Pod
+from airflow.contrib.kubernetes.secret import Secret
+from airflow.exceptions import AirflowConfigException
+import unittest
+
+XCOM_CMD = """import time
+while True:
+    try:
+        time.sleep(3600)
+    except KeyboardInterrupt:
+        exit(0)
+"""
+
+
+class TestPodRequestFactory(unittest.TestCase):
+
+    def setUp(self):
+        self.simple_pod_request_factory = SimplePodRequestFactory()
+        self.xcom_pod_request_factory = ExtractXcomPodRequestFactory()
+        self.pod = Pod(
+            image='busybox',
+            envs={
+                'ENVIRONMENT': 'prod',
+                'LOG_LEVEL': 'warning'
+            },
+            name='myapp-pod',
+            cmds=['sh', '-c', 'echo Hello Kubernetes!'],
+            labels={'app': 'myapp'},
+            image_pull_secrets='pull_secret_a,pull_secret_b',
+            configmaps=['configmap_a', 'configmap_b'],
+            secrets=[
+                # This should be a secretRef
+                Secret('env', None, 'secret_a'),
+                # This should be a single secret mounted in volumeMounts
+                Secret('volume', '/etc/foo', 'secret_b'),
+                # This should produce a single secret mounted in env
+                Secret('env', 'TARGET', 'secret_b', 'source_b'),
+            ]
+        )
+        self.maxDiff = None
+        self.expected = {
+            'apiVersion': 'v1',
+            'kind': 'Pod',
+            'metadata': {
+                'name': 'myapp-pod',
+                'labels': {'app': 'myapp'},
+                'annotations': {}},
+            'spec': {
+                'containers': [{
+                    'name': 'base',
+                    'image': 'busybox',
+                    'command': [
+                        'sh', '-c', 'echo Hello Kubernetes!'
+                    ],
+                    'imagePullPolicy': 'IfNotPresent',
+                    'args': [],
+                    'env': [{
+                        'name': 'ENVIRONMENT',
+                        'value': 'prod'
+                    }, {
+                        'name': 'LOG_LEVEL',
+                        'value': 'warning'
+                    }, {
+                        'name': 'TARGET',
+                        'valueFrom': {
+                            'secretKeyRef': {
+                                'name': 'secret_b',
+                                'key': 'source_b'
+                            }
+                        }
+                    }],
+                    'envFrom': [{
+                        'secretRef': {
+                            'name': 'secret_a'
+                        }
+                    }, {
+                        'configMapRef': {
+                            'name': 'configmap_a'
+                        }
+                    }, {
+                        'configMapRef': {
+                            'name': 'configmap_b'
+                        }
+                    }],
+                    'volumeMounts': [{
+                        'mountPath': '/etc/foo',
+                        'name': 'secretvol0',
+                        'readOnly': True
+                    }]
+                }],
+                'restartPolicy': 'Never',
+                'nodeSelector': {},
+                'volumes': [{
+                    'name': 'secretvol0',
+                    'secret': {
+                        'secretName': 'secret_b'
+                    }
+                }],
+                'imagePullSecrets': [
+                    {'name': 'pull_secret_a'},
+                    {'name': 'pull_secret_b'}
+                ],
+                'affinity': {}
+            }
+        }
+
+    def test_secret_throws(self):
+        with self.assertRaises(AirflowConfigException):
+            Secret('volume', None, 'secret_a', 'key')
+
+    def test_simple_pod_request_factory_create(self):
+        result = self.simple_pod_request_factory.create(self.pod)
+        # sort
+        result['spec']['containers'][0]['env'].sort(key=lambda x: x['name'])
+        self.assertEqual(result, self.expected)
+
+    def test_xcom_pod_request_factory_create(self):
+        result = self.xcom_pod_request_factory.create(self.pod)
+        container_two = {
+            'name': 'airflow-xcom-sidecar',
+            'image': 'python:3.5-alpine',
+            'command': ['python', '-c', XCOM_CMD],
+            'volumeMounts': [
+                {
+                    'name': 'xcom',
+                    'mountPath': '/airflow/xcom'
+                }
+            ]
+        }
+        self.expected['spec']['containers'].append(container_two)
+        self.expected['spec']['containers'][0]['volumeMounts'].insert(0, {
+            'name': 'xcom',
+            'mountPath': '/airflow/xcom'
+        })
+        self.expected['spec']['volumes'].insert(0, {
+            'name': 'xcom', 'emptyDir': {}
+        })
+        result['spec']['containers'][0]['env'].sort(key=lambda x: x['name'])
+        self.assertEqual(result, self.expected)

From 39998eeee040288cfa6c587787836f096e602183 Mon Sep 17 00:00:00 2001
From: Felix <feluelle@users.noreply.github.com>
Date: Tue, 29 Jan 2019 16:05:24 +0100
Subject: [PATCH 784/808] [AIRFLOW-3552] Add ImapToS3TransferOperator (#4476)

NOTE: This operator only transfers the latest attachment by name.
---
 .../imap_attachment_to_s3_operator.py         | 88 +++++++++++++++++++
 .../test_imap_attachment_to_s3_operator.py    | 57 ++++++++++++
 2 files changed, 145 insertions(+)
 create mode 100644 airflow/contrib/operators/imap_attachment_to_s3_operator.py
 create mode 100644 tests/contrib/operators/test_imap_attachment_to_s3_operator.py

diff --git a/airflow/contrib/operators/imap_attachment_to_s3_operator.py b/airflow/contrib/operators/imap_attachment_to_s3_operator.py
new file mode 100644
index 0000000000000..6126968c9c761
--- /dev/null
+++ b/airflow/contrib/operators/imap_attachment_to_s3_operator.py
@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from airflow.contrib.hooks.imap_hook import ImapHook
+from airflow.hooks.S3_hook import S3Hook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class ImapAttachmentToS3Operator(BaseOperator):
+    """
+    Transfers a mail attachment from a mail server into s3 bucket.
+
+    :param imap_attachment_name: The file name of the mail attachment that you want to transfer.
+    :type imap_attachment_name: str
+    :param s3_key: The destination file name in the s3 bucket for the attachment.
+    :type s3_key: str
+    :param imap_mail_folder: The folder on the mail server to look for the attachment.
+    :type imap_mail_folder: str
+    :param imap_check_regex: If set checks the `imap_attachment_name` for a regular expression.
+    :type imap_check_regex: bool
+    :param s3_overwrite: If set overwrites the s3 key if already exists.
+    :type s3_overwrite: bool
+    :param imap_conn_id: The reference to the connection details of the mail server.
+    :type imap_conn_id: str
+    :param s3_conn_id: The reference to the s3 connection details.
+    :type s3_conn_id: str
+    """
+    template_fields = ('imap_attachment_name', 's3_key')
+
+    @apply_defaults
+    def __init__(self,
+                 imap_attachment_name,
+                 s3_key,
+                 imap_mail_folder='INBOX',
+                 imap_check_regex=False,
+                 s3_overwrite=False,
+                 imap_conn_id='imap_default',
+                 s3_conn_id='aws_default',
+                 *args,
+                 **kwargs):
+        super(ImapAttachmentToS3Operator, self).__init__(*args, **kwargs)
+        self.imap_attachment_name = imap_attachment_name
+        self.s3_key = s3_key
+        self.imap_mail_folder = imap_mail_folder
+        self.imap_check_regex = imap_check_regex
+        self.s3_overwrite = s3_overwrite
+        self.imap_conn_id = imap_conn_id
+        self.s3_conn_id = s3_conn_id
+
+    def execute(self, context):
+        """
+        This function executes the transfer from the email server (via imap) into s3.
+
+        :param context: The context while executing.
+        :type context: dict
+        """
+        self.log.info(
+            'Transferring mail attachment %s from mail server via imap to s3 key %s...',
+            self.imap_attachment_name, self.s3_key
+        )
+
+        with ImapHook(imap_conn_id=self.imap_conn_id) as imap_hook:
+            imap_mail_attachments = imap_hook.retrieve_mail_attachments(
+                name=self.imap_attachment_name,
+                mail_folder=self.imap_mail_folder,
+                check_regex=self.imap_check_regex,
+                latest_only=True
+            )
+
+        s3_hook = S3Hook(aws_conn_id=self.s3_conn_id)
+        s3_hook.load_string(string_data=imap_mail_attachments[0][1], key=self.s3_key)
diff --git a/tests/contrib/operators/test_imap_attachment_to_s3_operator.py b/tests/contrib/operators/test_imap_attachment_to_s3_operator.py
new file mode 100644
index 0000000000000..0cde76cc94f1a
--- /dev/null
+++ b/tests/contrib/operators/test_imap_attachment_to_s3_operator.py
@@ -0,0 +1,57 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+
+from mock import patch
+
+from airflow.contrib.operators.imap_attachment_to_s3_operator import ImapAttachmentToS3Operator
+
+
+class TestImapAttachmentToS3Operator(unittest.TestCase):
+
+    def setUp(self):
+        self.kwargs = dict(
+            imap_attachment_name='test_file',
+            s3_key='test_file',
+            imap_mail_folder='INBOX',
+            imap_check_regex=False,
+            s3_overwrite=False,
+            task_id='test_task',
+            dag=None
+        )
+
+    @patch('airflow.contrib.operators.imap_attachment_to_s3_operator.S3Hook')
+    @patch('airflow.contrib.operators.imap_attachment_to_s3_operator.ImapHook')
+    def test_execute(self, mock_imap_hook, mock_s3_hook):
+        mock_imap_hook.return_value.__enter__ = mock_imap_hook
+        mock_imap_hook.return_value.retrieve_mail_attachments.return_value = [('test_file', b'Hello World')]
+
+        ImapAttachmentToS3Operator(**self.kwargs).execute(context={})
+
+        mock_imap_hook.return_value.retrieve_mail_attachments.assert_called_once_with(
+            name=self.kwargs['imap_attachment_name'],
+            mail_folder=self.kwargs['imap_mail_folder'],
+            check_regex=self.kwargs['imap_check_regex'],
+            latest_only=True
+        )
+        mock_s3_hook.return_value.load_string.assert_called_once_with(
+            string_data=mock_imap_hook.return_value.retrieve_mail_attachments.return_value[0][1],
+            key=self.kwargs['s3_key']
+        )

From c43a20fe23c4f62bfc84765fa99d95855c36b6e8 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Wed, 3 Apr 2019 14:38:25 +0100
Subject: [PATCH 785/808] [AIRFLOW-XXX] Pin Sendgrid dep. (#5031)

Sendgrid just released 6.0 with breaking changes, and I don't have the
time to define how to change our code or tests - as they haven't
published a migration guide :(
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index dba753593df6f..7eaca3a9fd913 100644
--- a/setup.py
+++ b/setup.py
@@ -218,7 +218,7 @@ def write_version(filename=os.path.join(*['airflow',
 salesforce = ['simple-salesforce>=0.72']
 samba = ['pysmbclient>=0.1.3']
 segment = ['analytics-python>=1.2.9']
-sendgrid = ['sendgrid>=5.2.0']
+sendgrid = ['sendgrid>=5.2.0,<6']
 slack = ['slackclient>=1.0.0']
 mongo = ['pymongo>=3.6.0']
 snowflake = ['snowflake-connector-python>=1.5.2',

From fe9df7301575f54607715dee0b170a1daf5e5dcf Mon Sep 17 00:00:00 2001
From: Andrew Stahlman <andrew.stahlman@gmail.com>
Date: Thu, 14 Feb 2019 21:33:49 -0800
Subject: [PATCH 786/808] [AIRFLOW-3887] Downgrade dagre-d3 to 0.4.18 (#4713)

dagre-d3 v0.6.3 has a bug that causes this Javascript error when loading
the Graph View:

    TypeError: previousPaths.merge is not a function

The bug fix [1] has been merged to master, but hasn't been released to
npm yet. This change temporarily downgrades our version of dagre-d3
until dagre-d3 v0.6.4 is released [2]

I also fixed a bug I encountered in the `compile_assets.sh` where the
script would fail if the directory `airflow/www/static/dist/` exists but
is empty.

[1] https://github.com/dagrejs/dagre-d3/pull/350
[2] https://github.com/dagrejs/dagre-d3/blob/5450627790ff42012ef50cef6b0e220199ae4fbe/package.json#L3
---
 airflow/www_rbac/compile_assets.sh |  2 +-
 airflow/www_rbac/package-lock.json | 93 ++++++++++++++++++++----------
 airflow/www_rbac/package.json      |  2 +-
 3 files changed, 66 insertions(+), 31 deletions(-)

diff --git a/airflow/www_rbac/compile_assets.sh b/airflow/www_rbac/compile_assets.sh
index a2b61115c8570..a3a4ea2349692 100755
--- a/airflow/www_rbac/compile_assets.sh
+++ b/airflow/www_rbac/compile_assets.sh
@@ -19,7 +19,7 @@ set -e
 
 # first bump up package.json manually, commit and tag
 if [ -d airflow/www_rbac/static/dist ]; then
-  rm airflow/www_rbac/static/dist/*
+  rm -f airflow/www_rbac/static/dist/*
 fi
 
 cd airflow/www_rbac/
diff --git a/airflow/www_rbac/package-lock.json b/airflow/www_rbac/package-lock.json
index a26d0b8894e39..c42050e276be5 100644
--- a/airflow/www_rbac/package-lock.json
+++ b/airflow/www_rbac/package-lock.json
@@ -575,6 +575,7 @@
       "resolved": "https://registry.npmjs.org/align-text/-/align-text-0.1.4.tgz",
       "integrity": "sha1-DNkKVhCT810KmSVsIrcGlDP60Rc=",
       "dev": true,
+      "optional": true,
       "requires": {
         "kind-of": "^3.0.2",
         "longest": "^1.0.1",
@@ -2154,23 +2155,30 @@
       }
     },
     "dagre": {
-      "version": "0.8.4",
-      "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.8.4.tgz",
-      "integrity": "sha512-Dj0csFDrWYKdavwROb9FccHfTC4fJbyF/oJdL9LNZJ8WUvl968P6PAKEriGqfbdArVJEmmfA+UyumgWEwcHU6A==",
+      "version": "0.7.4",
+      "resolved": "https://registry.npmjs.org/dagre/-/dagre-0.7.4.tgz",
+      "integrity": "sha1-3nLw50pVDOEc5jjwoTb+1xI5gCI=",
       "requires": {
-        "graphlib": "^2.1.7",
-        "lodash": "^4.17.4"
+        "graphlib": "^1.0.5",
+        "lodash": "^3.10.0"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
       }
     },
     "dagre-d3": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.6.3.tgz",
-      "integrity": "sha512-1vAzNp7OR1370JtjNaVFiW04DBjPDq513cJnqNVWxIkZqB0HfIArsc5eriTY9RM9cVMUjxdCJ3z4of5f8HqbdA==",
-      "requires": {
-        "d3": "^4.12.2",
-        "dagre": "^0.8.4",
-        "graphlib": "^2.1.7",
-        "lodash": "^4.17.10"
+      "version": "0.4.18",
+      "resolved": "https://registry.npmjs.org/dagre-d3/-/dagre-d3-0.4.18.tgz",
+      "integrity": "sha512-7tRltaOfNTIkNEZYMCL8N3Q8bCre99x/mAJL2RbuUfPu5d+4f0KOHglZm+AzOG2Z/+S2HBDYciE6iDcDtki6Tg==",
+      "requires": {
+        "d3": "^3.3.8",
+        "dagre": "^0.7.3",
+        "graphlib": "^1.0.5",
+        "lodash": "^3.10.0"
       },
       "dependencies": {
         "lodash": {
@@ -3451,7 +3459,8 @@
         "ansi-regex": {
           "version": "2.1.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "aproba": {
           "version": "1.2.0",
@@ -3472,12 +3481,14 @@
         "balanced-match": {
           "version": "1.0.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "brace-expansion": {
           "version": "1.1.11",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "balanced-match": "^1.0.0",
             "concat-map": "0.0.1"
@@ -3492,17 +3503,20 @@
         "code-point-at": {
           "version": "1.1.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "concat-map": {
           "version": "0.0.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "console-control-strings": {
           "version": "1.1.0",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "core-util-is": {
           "version": "1.0.2",
@@ -3619,7 +3633,8 @@
         "inherits": {
           "version": "2.0.3",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "ini": {
           "version": "1.3.5",
@@ -3631,6 +3646,7 @@
           "version": "1.0.0",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "number-is-nan": "^1.0.0"
           }
@@ -3645,6 +3661,7 @@
           "version": "3.0.4",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "brace-expansion": "^1.1.7"
           }
@@ -3652,12 +3669,14 @@
         "minimist": {
           "version": "0.0.8",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "minipass": {
           "version": "2.2.4",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "safe-buffer": "^5.1.1",
             "yallist": "^3.0.0"
@@ -3676,6 +3695,7 @@
           "version": "0.5.1",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "minimist": "0.0.8"
           }
@@ -3756,7 +3776,8 @@
         "number-is-nan": {
           "version": "1.0.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "object-assign": {
           "version": "4.1.1",
@@ -3768,6 +3789,7 @@
           "version": "1.4.0",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "wrappy": "1"
           }
@@ -3853,7 +3875,8 @@
         "safe-buffer": {
           "version": "5.1.1",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "safer-buffer": {
           "version": "2.1.2",
@@ -3889,6 +3912,7 @@
           "version": "1.0.2",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "code-point-at": "^1.0.0",
             "is-fullwidth-code-point": "^1.0.0",
@@ -3908,6 +3932,7 @@
           "version": "3.0.1",
           "bundled": true,
           "dev": true,
+          "optional": true,
           "requires": {
             "ansi-regex": "^2.0.0"
           }
@@ -3951,12 +3976,14 @@
         "wrappy": {
           "version": "1.0.2",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         },
         "yallist": {
           "version": "3.0.2",
           "bundled": true,
-          "dev": true
+          "dev": true,
+          "optional": true
         }
       }
     },
@@ -4102,11 +4129,18 @@
       "dev": true
     },
     "graphlib": {
-      "version": "2.1.7",
-      "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-2.1.7.tgz",
-      "integrity": "sha512-TyI9jIy2J4j0qgPmOOrHTCtpPqJGN/aurBwc6ZT+bRii+di1I+Wv3obRhVrmBEXet+qkMaEX67dXrwsd3QQM6w==",
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/graphlib/-/graphlib-1.0.7.tgz",
+      "integrity": "sha1-DKst8P/mq+BwsmJb+h7bbslnuLE=",
       "requires": {
-        "lodash": "^4.17.5"
+        "lodash": "^3.10.0"
+      },
+      "dependencies": {
+        "lodash": {
+          "version": "3.10.1",
+          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
+          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y="
+        }
       }
     },
     "handlebars": {
@@ -4960,7 +4994,8 @@
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/longest/-/longest-1.0.1.tgz",
       "integrity": "sha1-MKCy2jj3N3DoKUoNIuZiXtd9AJc=",
-      "dev": true
+      "dev": true,
+      "optional": true
     },
     "loose-envify": {
       "version": "1.3.1",
diff --git a/airflow/www_rbac/package.json b/airflow/www_rbac/package.json
index f9a99fdc171d9..5c431895a7666 100644
--- a/airflow/www_rbac/package.json
+++ b/airflow/www_rbac/package.json
@@ -58,7 +58,7 @@
     "bootstrap-toggle": "^2.2.2",
     "d3": "^3.4.4",
     "d3-tip": "^0.9.1",
-    "dagre-d3": "^0.6.3",
+    "dagre-d3": "^0.4.18",
     "datatables.net": "^1.10.19",
     "datatables.net-bs": "^1.10.19",
     "lodash": "^4.17.11",

From 0c46bcabf9f9d845723ee87c917964b695c9a8ea Mon Sep 17 00:00:00 2001
From: Xiaodong <xd_deng@hotmail.com>
Date: Thu, 4 Apr 2019 22:44:05 +0800
Subject: [PATCH 787/808] [AIRFLOW-XXX] Pin psycopg2 due to breaking change
 (#5036)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 7eaca3a9fd913..db6a8bb8b687b 100644
--- a/setup.py
+++ b/setup.py
@@ -210,7 +210,7 @@ def write_version(filename=os.path.join(*['airflow',
     'flask-bcrypt>=0.7.1',
 ]
 pinot = ['pinotdb==0.1.1']
-postgres = ['psycopg2>=2.7.4']
+postgres = ['psycopg2>=2.7.4,<2.8']
 qds = ['qds-sdk>=1.9.6']
 rabbitmq = ['librabbitmq>=1.6.1']
 redis = ['redis~=3.2']

From eaaa5aba1c2459bf6e6ce15db85a97c70ba2a33c Mon Sep 17 00:00:00 2001
From: Felix Uellendall <feluelle@users.noreply.github.com>
Date: Thu, 4 Apr 2019 23:40:46 +0200
Subject: [PATCH 788/808] [AIRFLOW-3552] Fix encoding issue in
 ImapAttachmentToS3Operator (#5040)

- change method to upload data to s3 from load_string to load_bytes
---
 airflow/contrib/operators/imap_attachment_to_s3_operator.py   | 2 +-
 .../contrib/operators/test_imap_attachment_to_s3_operator.py  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/operators/imap_attachment_to_s3_operator.py b/airflow/contrib/operators/imap_attachment_to_s3_operator.py
index 6126968c9c761..3b9f143591efb 100644
--- a/airflow/contrib/operators/imap_attachment_to_s3_operator.py
+++ b/airflow/contrib/operators/imap_attachment_to_s3_operator.py
@@ -85,4 +85,4 @@ def execute(self, context):
             )
 
         s3_hook = S3Hook(aws_conn_id=self.s3_conn_id)
-        s3_hook.load_string(string_data=imap_mail_attachments[0][1], key=self.s3_key)
+        s3_hook.load_bytes(bytes_data=imap_mail_attachments[0][1], key=self.s3_key)
diff --git a/tests/contrib/operators/test_imap_attachment_to_s3_operator.py b/tests/contrib/operators/test_imap_attachment_to_s3_operator.py
index 0cde76cc94f1a..66287fc7f4de3 100644
--- a/tests/contrib/operators/test_imap_attachment_to_s3_operator.py
+++ b/tests/contrib/operators/test_imap_attachment_to_s3_operator.py
@@ -51,7 +51,7 @@ def test_execute(self, mock_imap_hook, mock_s3_hook):
             check_regex=self.kwargs['imap_check_regex'],
             latest_only=True
         )
-        mock_s3_hook.return_value.load_string.assert_called_once_with(
-            string_data=mock_imap_hook.return_value.retrieve_mail_attachments.return_value[0][1],
+        mock_s3_hook.return_value.load_bytes.assert_called_once_with(
+            bytes_data=mock_imap_hook.return_value.retrieve_mail_attachments.return_value[0][1],
             key=self.kwargs['s3_key']
         )

From 9446fde04ef752d98de9ce92b738301ce8dcc423 Mon Sep 17 00:00:00 2001
From: BasPH <BasPH@users.noreply.github.com>
Date: Sun, 10 Feb 2019 19:59:46 +0100
Subject: [PATCH 789/808] AIRFLOW-[3823] Exclude branch's downstream tasks from
 the tasks to skip (#4666)

---
 airflow/operators/python_operator.py    | 17 ++++++--
 tests/operators/test_python_operator.py | 58 +++++++++++++++++++++++++
 2 files changed, 72 insertions(+), 3 deletions(-)

diff --git a/airflow/operators/python_operator.py b/airflow/operators/python_operator.py
index 30f5290973b74..67cf5492656e2 100644
--- a/airflow/operators/python_operator.py
+++ b/airflow/operators/python_operator.py
@@ -23,10 +23,11 @@
 import subprocess
 import sys
 import types
+from builtins import str
 from textwrap import dedent
 
 import dill
-from builtins import str
+import six
 
 from airflow.exceptions import AirflowException
 from airflow.models import BaseOperator
@@ -137,7 +138,7 @@ class BranchPythonOperator(PythonOperator, SkipMixin):
     """
     def execute(self, context):
         branch = super(BranchPythonOperator, self).execute(context)
-        if isinstance(branch, str):
+        if isinstance(branch, six.string_types):
             branch = [branch]
         self.log.info("Following branch %s", branch)
         self.log.info("Marking other directly downstream tasks as skipped")
@@ -145,8 +146,18 @@ def execute(self, context):
         downstream_tasks = context['task'].downstream_list
         self.log.debug("Downstream task_ids %s", downstream_tasks)
 
-        skip_tasks = [t for t in downstream_tasks if t.task_id not in branch]
         if downstream_tasks:
+            # Also check downstream tasks of the branch task. In case the task to skip
+            # is a downstream task of the branch task, we exclude it from skipping.
+            branch_downstream_task_ids = set()
+            for b in branch:
+                branch_downstream_task_ids.update(context["dag"].
+                                                  get_task(b).
+                                                  get_flat_relative_ids(upstream=False))
+            skip_tasks = [t
+                          for t in downstream_tasks
+                          if t.task_id not in branch and
+                          t.task_id not in branch_downstream_task_ids]
             self.skip(context['dag_run'], context['ti'].execution_date, skip_tasks)
 
         self.log.info("Done.")
diff --git a/tests/operators/test_python_operator.py b/tests/operators/test_python_operator.py
index 557f021a7f49d..296ef841c5deb 100644
--- a/tests/operators/test_python_operator.py
+++ b/tests/operators/test_python_operator.py
@@ -378,6 +378,64 @@ def test_with_dag_run(self):
             else:
                 raise
 
+    def test_with_skip_in_branch_downstream_dependencies(self):
+        self.branch_op = BranchPythonOperator(task_id='make_choice',
+                                              dag=self.dag,
+                                              python_callable=lambda: 'branch_1')
+
+        self.branch_op >> self.branch_1 >> self.branch_2
+        self.branch_op >> self.branch_2
+        self.dag.clear()
+
+        dr = self.dag.create_dagrun(
+            run_id="manual__",
+            start_date=timezone.utcnow(),
+            execution_date=DEFAULT_DATE,
+            state=State.RUNNING
+        )
+
+        self.branch_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
+        tis = dr.get_task_instances()
+        for ti in tis:
+            if ti.task_id == 'make_choice':
+                self.assertEqual(ti.state, State.SUCCESS)
+            elif ti.task_id == 'branch_1':
+                self.assertEqual(ti.state, State.NONE)
+            elif ti.task_id == 'branch_2':
+                self.assertEqual(ti.state, State.NONE)
+            else:
+                raise Exception
+
+    def test_with_skip_in_branch_downstream_dependencies2(self):
+        self.branch_op = BranchPythonOperator(task_id='make_choice',
+                                              dag=self.dag,
+                                              python_callable=lambda: 'branch_2')
+
+        self.branch_op >> self.branch_1 >> self.branch_2
+        self.branch_op >> self.branch_2
+        self.dag.clear()
+
+        dr = self.dag.create_dagrun(
+            run_id="manual__",
+            start_date=timezone.utcnow(),
+            execution_date=DEFAULT_DATE,
+            state=State.RUNNING
+        )
+
+        self.branch_op.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE)
+
+        tis = dr.get_task_instances()
+        for ti in tis:
+            if ti.task_id == 'make_choice':
+                self.assertEqual(ti.state, State.SUCCESS)
+            elif ti.task_id == 'branch_1':
+                self.assertEqual(ti.state, State.SKIPPED)
+            elif ti.task_id == 'branch_2':
+                self.assertEqual(ti.state, State.NONE)
+            else:
+                raise Exception
+
 
 class ShortCircuitOperatorTest(unittest.TestCase):
     @classmethod

From a76f1467cd8aab1f6a738955c91626931dac5809 Mon Sep 17 00:00:00 2001
From: gseva <gavrilovseva@gmail.com>
Date: Thu, 4 Apr 2019 18:52:45 -0300
Subject: [PATCH 790/808] [AIRFLOW-XXX] Mention that statsd must be installed
 to gather metrics (#5038)

---
 docs/metrics.rst | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/docs/metrics.rst b/docs/metrics.rst
index fb34b97e6498d..fc0c82e4d59ca 100644
--- a/docs/metrics.rst
+++ b/docs/metrics.rst
@@ -18,10 +18,17 @@
 Metrics
 =======
 
-Airflow can be set up to send metrics to `StatsD <https://github.com/etsy/statsd>`__:
+Airflow can be set up to send metrics to `StatsD <https://github.com/etsy/statsd>`__.
+
+Setup
+-----
+
+First you must install statsd requirement:
+
+.. code-block:: bash
+
+   pip install 'apache-airflow[statsd]'
 
-Configuration
--------------
 Add the following lines to your configuration file e.g. ``airflow.cfg``
 
 .. code-block:: bash

From b24489f75c6eb86ea6186a3483ee09f2fb3926a1 Mon Sep 17 00:00:00 2001
From: Paul Bramhall <paulwamp@gmail.com>
Date: Fri, 5 Apr 2019 17:11:50 +0100
Subject: [PATCH 791/808] [AIRFLOW-4246] Flask-Oauthlib needs downstream
 dependencies pinning due to breaking changes (#5045)

---
 setup.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/setup.py b/setup.py
index db6a8bb8b687b..6fed3dd7179ac 100644
--- a/setup.py
+++ b/setup.py
@@ -185,8 +185,11 @@ def write_version(filename=os.path.join(*['airflow',
     'PyOpenSSL',
     'pandas-gbq'
 ]
-github_enterprise = ['Flask-OAuthlib>=0.9.1']
-google_auth = ['Flask-OAuthlib>=0.9.1']
+flask_oauth = [
+    'Flask-OAuthlib>=0.9.1',
+    'oauthlib!=2.0.3,!=2.0.4,!=2.0.5,<3.0.0,>=1.1.2',
+    'requests-oauthlib==1.1.0'
+]
 hdfs = ['snakebite>=2.7.8']
 hive = [
     'hmsclient>=0.1.0',
@@ -355,8 +358,8 @@ def do_setup():
             'elasticsearch': elasticsearch,
             'emr': emr,
             'gcp_api': gcp_api,
-            'github_enterprise': github_enterprise,
-            'google_auth': google_auth,
+            'github_enterprise': flask_oauth,
+            'google_auth': flask_oauth,
             'hdfs': hdfs,
             'hive': hive,
             'jdbc': jdbc,

From d4d47f0615b8732998f9d95195b396ef5088cdf8 Mon Sep 17 00:00:00 2001
From: Fokko Driesprong <fokko@driesprong.frl>
Date: Fri, 5 Apr 2019 18:20:19 +0200
Subject: [PATCH 792/808] [AIRFLOW-4247] Template Region on the
 DataprocOperators (#5046)

---
 airflow/contrib/operators/dataproc_operator.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/airflow/contrib/operators/dataproc_operator.py b/airflow/contrib/operators/dataproc_operator.py
index e9684b987e5c4..f525db96836e6 100644
--- a/airflow/contrib/operators/dataproc_operator.py
+++ b/airflow/contrib/operators/dataproc_operator.py
@@ -731,7 +731,7 @@ class DataProcPigOperator(BaseOperator):
         an 8 character random string.
     :vartype dataproc_job_id: str
     """
-    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     template_ext = ('.pg', '.pig',)
     ui_color = '#0273d4'
 
@@ -828,7 +828,7 @@ class DataProcHiveOperator(BaseOperator):
         an 8 character random string.
     :vartype dataproc_job_id: str
     """
-    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     template_ext = ('.q',)
     ui_color = '#0273d4'
 
@@ -927,7 +927,7 @@ class DataProcSparkSqlOperator(BaseOperator):
         an 8 character random string.
     :vartype dataproc_job_id: str
     """
-    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['query', 'variables', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     template_ext = ('.q',)
     ui_color = '#0273d4'
 
@@ -1034,7 +1034,7 @@ class DataProcSparkOperator(BaseOperator):
     :vartype dataproc_job_id: str
     """
 
-    template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['arguments', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     ui_color = '#0273d4'
 
     @apply_defaults
@@ -1142,7 +1142,7 @@ class DataProcHadoopOperator(BaseOperator):
     :vartype dataproc_job_id: str
     """
 
-    template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['arguments', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     ui_color = '#0273d4'
 
     @apply_defaults
@@ -1250,7 +1250,7 @@ class DataProcPySparkOperator(BaseOperator):
     :vartype dataproc_job_id: str
     """
 
-    template_fields = ['arguments', 'job_name', 'cluster_name', 'dataproc_jars']
+    template_fields = ['arguments', 'job_name', 'cluster_name', 'region', 'dataproc_jars']
     ui_color = '#0273d4'
 
     @staticmethod

From eb4d3ecc23c520ebb0ed32532b1669081c362e9b Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 5 Apr 2019 19:05:10 +0100
Subject: [PATCH 793/808] [AIRFLOW-4240] State-changing actions should be POST
 requests (#5039)

To make the requests POSTs and to follow the redirect that the backend
issue I turned the "toggle" buttons in to an actual form, which makes
there much less logic needed to build up the URL - the browser handles
it all for us. The only thing we have to do is set the "action" on the
URL.

For the "link" ones (delete,trigger,refresh) I wrote a short
`postAsForm` which takes the URL and submits a form. A little bit messy,
but it works.
---
 airflow/www/static/main.css                   |   6 +-
 airflow/www/templates/admin/master.html       |  33 +-
 airflow/www/templates/airflow/confirm.html    |  13 +-
 airflow/www/templates/airflow/dag.html        | 348 ++++++++----------
 airflow/www/templates/airflow/dags.html       |  25 +-
 airflow/www/views.py                          | 135 +++----
 airflow/www_rbac/static/css/main.css          |   6 +-
 airflow/www_rbac/static/js/base.js            |  32 ++
 .../www_rbac/templates/airflow/confirm.html   |  13 +-
 airflow/www_rbac/templates/airflow/dag.html   | 347 ++++++++---------
 airflow/www_rbac/templates/airflow/dags.html  |  27 +-
 airflow/www_rbac/views.py                     | 126 +++----
 tests/core.py                                 |  94 +++--
 tests/www/test_views.py                       |   8 +-
 tests/www_rbac/test_views.py                  | 118 ++++--
 15 files changed, 703 insertions(+), 628 deletions(-)

diff --git a/airflow/www/static/main.css b/airflow/www/static/main.css
index 66f449aceee29..08bfc798a01ed 100644
--- a/airflow/www/static/main.css
+++ b/airflow/www/static/main.css
@@ -44,10 +44,14 @@ td>span.glyphicon{
     padding-left: 3px;
     padding-top: 3px;
 }
-button.btn {
+button.btn, label.btn {
     border: 1px solid black;
 }
 
+.btn-group label.btn {
+    background-color: #f0f0f0;
+}
+
 div.rich_doc {
     padding: 5px 10px;
     border: 1px solid #dddddd;
diff --git a/airflow/www/templates/admin/master.html b/airflow/www/templates/admin/master.html
index ec4573b5d4adb..7837c93f73e07 100644
--- a/airflow/www/templates/admin/master.html
+++ b/airflow/www/templates/admin/master.html
@@ -37,11 +37,12 @@
         alert('{{ hostname }}');
     });
     $('span').tooltip();
+    var CSRF = {{ csrf_token() | tojson }};
 
     $.ajaxSetup({
       beforeSend: function(xhr, settings) {
         if (!/^(GET|HEAD|OPTIONS|TRACE)$/i.test(settings.type) && !this.crossDomain) {
-          xhr.setRequestHeader("X-CSRFToken", "{{ csrf_token() }}");
+          xhr.setRequestHeader("X-CSRFToken", CSRF);
         }
       }
     });
@@ -52,6 +53,36 @@
   el.textContent = text;
   return el.innerHTML;
 }
+
+function postAsForm(url, parameters) {
+  var form = $("<form></form>");
+
+  form.attr("method", "POST");
+  form.attr("action", url);
+
+  $.each(parameters || {}, function(key, value) {
+    var field = $('<input></input>');
+
+    field.attr("type", "hidden");
+    field.attr("name", key);
+    field.attr("value", value);
+
+    form.append(field);
+  });
+
+  var field = $('<input></input>');
+
+  field.attr("type", "hidden");
+  field.attr("name", "csrf_token");
+  field.attr("value", CSRF);
+
+  form.append(field);
+
+  // The form needs to be a part of the document in order for us to be able
+  // to submit it.
+  $(document.body).append(form);
+  form.submit();
+}
 </script>
 {% endblock %}
 
diff --git a/airflow/www/templates/airflow/confirm.html b/airflow/www/templates/airflow/confirm.html
index 8084250c95bb7..c50a6e0bf0794 100644
--- a/airflow/www/templates/airflow/confirm.html
+++ b/airflow/www/templates/airflow/confirm.html
@@ -26,10 +26,15 @@ <h2>Wait a minute.</h2>
         <pre><code>{{ details }}</code></pre>
     {% endif %}
     </div>
-    <button class="btn btn-primary" onclick="window.location += '&confirmed=true'">
-        OK!
-    </button>
-    <button class="btn" onclick="window.history.back()">bail.</button>
+    <form method="POST">
+      <input name="csrf_token" type="hidden" value="{{ csrf_token() }}">
+      <input name="confirmed" type="hidden" value="true">
+      {% for name,val in request.form.items() if name != "csrf_token" %}
+        <input type="hidden" name="{{ name }}" value="{{ val }}">
+      {% endfor %}
+      <input class="btn btn-primary" type="submit" value="OK!">
+      <button class="btn" onclick="window.history.go(-2); return false">bail.</button>
+    </form>
     <br>
     <br>
 {% endblock %}
diff --git a/airflow/www/templates/airflow/dag.html b/airflow/www/templates/airflow/dag.html
index 48178c85755f3..5daf7820c0a9c 100644
--- a/airflow/www/templates/airflow/dag.html
+++ b/airflow/www/templates/airflow/dag.html
@@ -96,20 +96,20 @@ <h4 class="pull-right">
       </li>
       <li>
         <a href="{{ url_for("airflow.trigger", dag_id=dag.dag_id, origin=url_for("airflow.tree", dag_id=dag.dag_id)) }}"
-          onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+          onclick="return confirmTriggerDag(this, '{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG
         </a>
       </li>
       <li>
-        <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}" title="Refresh">
+        <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}" title="Refresh" onclick="postAsForm(this.href); return false">
           <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
           Refresh
         </a>
       </li>
       <li>
         <a href="{{ url_for("airflow.delete", dag_id=dag.dag_id, root=root) }}"
-        onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+        onclick="return confirmDeleteDag(this, '{{ dag.safe_dag_id }}')">
         <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true"></span>
         Delete
         </a>
@@ -159,92 +159,113 @@ <h4 class="modal-title" id="myModalLabel">
             </ul>
           </div>
           <hr/>
-          <button id="btn_run" type="button" class="btn btn-primary"
-            title="Runs a single task instance">
-            Run
-          </button>
-          <span class="btn-group">
-            <button id="btn_ignore_all_deps"
-              type="button" class="btn" data-toggle="button"
-              title="Ignores all non-critical dependencies, including task state and task_deps"
-              >Ignore All Deps</button>
-          </span>
-          <span class="btn-group">
-            <button id="btn_ignore_ti_state"
-              type="button" class="btn" data-toggle="button"
-              title="Ignore previous success/failure"
-              >Ignore Task State</button>
-          </span>
-          <button id="btn_ignore_task_deps"
-            type="button" class="btn" data-toggle="button"
-            title="Disregard the task-specific dependencies, e.g. status of upstream task instances and depends_on_past"
-            >Ignore Task Deps</button>
-          </span>
-          <hr/>
-          <button id="btn_clear" type="button" class="btn btn-primary"
-              title="Clearing deletes the previous state of the task instance, allowing it to get re-triggered by the scheduler or a backfill command"
-              >Clear
-          </button>
-          <span class="btn-group">
-            <button id="btn_past"
-              type="button" class="btn" data-toggle="button"
-              title="Also include past task instances when clearing this one"
-              >Past</button>
-            <button id="btn_future"
-              type="button" class="btn" data-toggle="button"
-              title="Also include future task instances when clearing this one"
-              >Future</button>
-            <button id="btn_upstream"
-              type="button" class="btn" data-toggle="button"
-              title="Also include upstream dependencies"
-              >Upstream</button>
-            <button id="btn_downstream"
-              type="button" class="btn active" data-toggle="button"
-              title="Also include downstream dependencies"
-              >
-              Downstream
+          <form method="POST">
+            <input name="csrf_token" type="hidden" value="{{ csrf_token() }}"/>
+            <input name="dag_id" type="hidden">
+            <input name="task_id" type="hidden">
+            <input name="execution_date" type="hidden">
+            <input name="origin" type="hidden" value="{{ request.base_url }}">
+            <button id="btn_run" type="button" class="btn btn-primary"
+              title="Runs a single task instance"
+              data-action="{{ url_for('airflow.run') }}">
+              Run
             </button>
-            <button id="btn_recursive"
-              type="button" class="btn active" data-toggle="button">
-               Recursive
+            <span class="btn-group" data-toggle="buttons">
+              <label
+                class="btn"
+                title="Ignores all non-critical dependencies, including task state and task_deps">
+                <input type="checkbox" value="true" name="ignore_all_deps" autocomplete="off">
+                Ignore All Deps</label>
+              <label class="btn"
+                title="Ignore previous success/failure">
+                <input type="checkbox" value="true" name="ignore_ti_state" autocomplete="off">
+                Ignore Task State
+              </label>
+              <label class="btn"
+                title="Disregard the task-specific dependencies, e.g. status of upstream task instances and depends_on_past">
+                <input type="checkbox" value="true" name="ignore_task_deps" autocomplete="off">
+                Ignore Task Deps
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_clear" type="button" class="btn btn-primary"
+                title="Clearing deletes the previous state of the task instance, allowing it to get re-triggered by the scheduler or a backfill command"
+                data-action="{{ url_for('airflow.clear') }}"
+                >Clear
             </button>
-          </span>
-          <hr/>
-          <button id="btn_failed" type="button" class="btn btn-primary">
-            Mark Failed
-          </button>
-          <span class="btn-group">
-            <button id="btn_failed_past"
-              type="button" class="btn" data-toggle="button">Past</button>
-            <button id="btn_failed_future"
-              type="button" class="btn" data-toggle="button">
-              Future
-            </button>
-            <button id="btn_failed_upstream"
-              type="button" class="btn" data-toggle="button">Upstream</button>
-            <button id="btn_failed_downstream"
-              type="button" class="btn" data-toggle="button">
-              Downstream
-            </button>
-          </span>
-          <hr/>
-          <button id="btn_success" type="button" class="btn btn-primary">
-            Mark Success
-          </button>
-          <span class="btn-group">
-            <button id="btn_success_past"
-              type="button" class="btn" data-toggle="button">Past</button>
-            <button id="btn_success_future"
-              type="button" class="btn" data-toggle="button">
-              Future
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn"
+                title="Also include past task instances when clearing this one">
+                <input type="checkbox" value="true" name="past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn"
+                title="Also include future task instances when clearing this one">
+                <input type="checkbox" value="true" name="future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn"
+                title="Also include upstream dependencies">
+                <input type="checkbox" value="true" name="upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn active"
+                title="Also include downstream dependencies">
+                <input type="checkbox" value="true" name="downstream" checked autocomplete="off">
+                Downstream
+              </label>
+              <label class="btn active">
+                <input type="checkbox" value="true" name="recursive" checked autocomplete="off">
+                 Recursive
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_failed" type="button" class="btn btn-primary"
+                data-action="{{ url_for('airflow.failed') }}">
+              Mark Failed
             </button>
-            <button id="btn_success_upstream"
-              type="button" class="btn" data-toggle="button">Upstream</button>
-            <button id="btn_success_downstream"
-              type="button" class="btn" data-toggle="button">
-              Downstream
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_downstream" autocomplete="off">
+                Downstream
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_success" type="button" class="btn btn-primary"
+                data-action="{{ url_for('airflow.success') }}">
+              Mark Success
             </button>
-          </span>
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_downstream" autocomplete="off">
+                Downstream
+              </label>
+            </span>
+          </form>
         </div>
         <div class="modal-footer">
           <button type="button" class="btn btn-default" data-dismiss="modal">
@@ -266,18 +287,24 @@ <h4 class="modal-title" id="dagModalLabel">
           </h4>
         </div>
         <div class="modal-body">
-          <button id="btn_edit_dagrun" type="button" class="btn btn-primary">
-            Edit
-          </button>
-          <button id="btn_dagrun_clear" type="button" class="btn btn-primary">
-            Clear
-          </button>
-          <button id="btn_dagrun_failed" type="button" class="btn btn-primary">
-            Mark Failed
-          </button>
-          <button id="btn_dagrun_success" type="button" class="btn btn-primary">
-            Mark Success
-          </button>
+          <form method="POST">
+            <button id="btn_edit_dagrun" type="button" class="btn btn-primary">
+              Edit
+            </button>
+            <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+            <input name="dag_id" type="hidden">
+            <input name="execution_date" type="hidden">
+            <input name="origin" type="hidden" value="{{ request.base_url }}">
+            <button id="btn_dagrun_clear" type="button" class="btn btn-primary" data-action="{{ url_for('airflow.dagrun_clear') }}">
+              Clear
+            </button>
+            <button id="btn_dagrun_failed" type="button" class="btn btn-primary" data-action="{{ url_for('airflow.dagrun_failed') }}">
+              Mark Failed
+            </button>
+            <button id="btn_dagrun_success" type="button" class="btn btn-primary" data-action="{{ url_for('airflow.dagrun_success') }}">
+              Mark Success
+            </button>
+          </form>
         </div>
         <div class="modal-footer">
           <button type="button" class="btn btn-default" data-dismiss="modal">
@@ -366,15 +393,23 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
-    function confirmTriggerDag(dag_id){
-        return confirm("Are you sure you want to run '"+dag_id+"' now?");
+
+    function confirmTriggerDag(link, dag_id){
+      if (confirm("Are you sure you want to run '"+dag_id+"' now?")) {
+        postAsForm(link.href, {});
+      }
+      // Never follow the link
+      return false;
     }
 
-    function confirmDeleteDag(dag_id){
-        return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
-          This option will delete ALL metadata, DAG runs, etc.\n\
-          EXCEPT Log.\n\
-          This cannot be undone.");
+    function confirmDeleteDag(link, dag_id){
+      if (confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+        This option will delete ALL metadata, DAG runs, etc.\n\
+        EXCEPT Log.\n\
+        This cannot be undone.")) {
+        postAsForm(link.href, {});
+      }
+      return false;
     }
 
     $("#btn_rendered").click(function(){
@@ -417,98 +452,17 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
-    $("#btn_run").click(function(){
-      url = "{{ url_for('airflow.run') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&ignore_all_deps=" + $('#btn_ignore_all_deps').hasClass('active') +
-        "&ignore_task_deps=" + $('#btn_ignore_task_deps').hasClass('active') +
-        "&ignore_ti_state=" + $('#btn_ignore_ti_state').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_clear").click(function(){
-      url = "{{ url_for('airflow.clear') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&future=" + $('#btn_future').hasClass('active') +
-        "&past=" + $('#btn_past').hasClass('active') +
-        "&upstream=" + $('#btn_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_downstream').hasClass('active') +
-        "&recursive=" + $('#btn_recursive').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_dagrun_clear").click(function(){
-      url = "{{ url_for('airflow.dagrun_clear') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_failed").click(function(){
-      url = "{{ url_for('airflow.failed') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&upstream=" + $('#btn_failed_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_failed_downstream').hasClass('active') +
-        "&future=" + $('#btn_failed_future').hasClass('active') +
-        "&past=" + $('#btn_failed_past').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-
-      window.location = url;
-    });
-
-    $("#btn_success").click(function(){
-      url = "{{ url_for('airflow.success') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&upstream=" + $('#btn_success_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_success_downstream').hasClass('active') +
-        "&future=" + $('#btn_success_future').hasClass('active') +
-        "&past=" + $('#btn_success_past').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-
-      window.location = url;
-    });
-
-    $('#btn_dagrun_failed').click(function(){
-      url = "{{ url_for('airflow.dagrun_failed') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $('#btn_dagrun_success').click(function(){
-      url = "{{ url_for('airflow.dagrun_success') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_gantt").click(function(){
-      url = "{{ url_for('airflow.gantt') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date);
-      window.location = url;
-    });
-
-    $("#btn_graph").click(function(){
-      url = "{{ url_for('airflow.graph') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date);
-      window.location = url;
-    });
+    $('form button[data-action]').click(function (e) {
+      var form = $(this).closest('form').get(0);
+      form.dag_id.value = dag_id;
+      form.execution_date.value = execution_date;
+      form.origin.value = window.location;
+      if (form.task_id) {
+        form.task_id.value = task_id;
+      }
+      form.action = $(this).data("action");
+      form.submit();
+    })
 
     $("#pause_resume").change(function() {
       var dag_id =  $(this).attr('dag_id');
@@ -522,7 +476,7 @@ <h4 class="modal-title" id="dagModalLabel">
     });
 
     $('#btn_edit_dagrun').click(function(){
-      window.location = "{{ url_for('dagrun.edit_view') }}?id=" + id;
+      window.location = "{{ url_for('dagrun.edit_view') }}?id=" + encodeURIComponent(id);
     });
 
   </script>
diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 81d60f31d2803..2340855f9c73a 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -123,7 +123,7 @@ <h2>DAGs</h2>
 
                 <!-- Trigger Dag -->
                 <a href="{{ url_for('airflow.trigger', dag_id=dag.dag_id) }}&origin={{ request.base_url }}"
-                   onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+                   onclick="return confirmTriggerDag(this, '{{ dag.safe_dag_id }}')">
                     <span class="glyphicon glyphicon-play-circle" aria-hidden="true" data-original-title="Trigger Dag"></span>
                 </a>
 
@@ -169,14 +169,14 @@ <h2>DAGs</h2>
                 {% endif %}
 
                 <!-- Refresh -->
-                <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}">
+                <a href="{{ url_for("airflow.refresh", dag_id=dag.dag_id) }}" onclick="postAsForm(this.href); return false">
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
                 <!-- Delete -->
                 <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
                 <a href="{{ url_for('airflow.delete', dag_id=dag.dag_id) }}"
-                  onclick="return confirmDeleteDag('{{ dag.dag_id }}')">
+                  onclick="return confirmDeleteDag(this, '{{ dag.dag_id }}')">
                    <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
                 </td>
@@ -230,15 +230,22 @@ <h2>DAGs</h2>
         window.location = DAGS_INDEX + "?page_size=" + p_size;
       });
 
-      function confirmTriggerDag(dag_id){
-          return confirm("Are you sure you want to run '"+dag_id+"' now?");
+      function confirmTriggerDag(link, dag_id){
+        if (confirm("Are you sure you want to run '"+dag_id+"' now?")) {
+          postAsForm(link.href, {});
+        }
+        // Never follow the link
+        return false;
       }
 
-      function confirmDeleteDag(dag_id){
-          return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+      function confirmDeleteDag(link, dag_id){
+        if (confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
           This option will delete ALL metadata, DAG runs, etc.\n\
           EXCEPT Log.\n\
-          This cannot be undone.");
+          This cannot be undone.")) {
+          postAsForm(link.href, {});
+        }
+        return false;
       }
       all_dags = $("[id^=toggle]");
       $.each(all_dags, function(i,v) {
@@ -249,7 +256,7 @@ <h2>DAGs</h2>
           } else {
             is_paused = 'false'
           }
-          url = 'airflow/paused?is_paused=' + is_paused + '&dag_id=' + dag_id;
+          url = {{ url_for('airflow.paused') | tojson }} + '?is_paused=' + is_paused + '&dag_id=' + encodeURIComponent(dag_id);
           $.post(url);
         });
       });
diff --git a/airflow/www/views.py b/airflow/www/views.py
index 4cd66ff9241c4..49ef0eba8518e 100644
--- a/airflow/www/views.py
+++ b/airflow/www/views.py
@@ -1012,22 +1012,23 @@ def xcom(self, session=None):
             root=root,
             dag=dag, title=title)
 
-    @expose('/run')
+    @expose('/run', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def run(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
+
         dag = dagbag.get_dag(dag_id)
         task = dag.get_task(task_id)
 
-        execution_date = request.args.get('execution_date')
+        execution_date = request.form.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        ignore_all_deps = request.args.get('ignore_all_deps') == "true"
-        ignore_task_deps = request.args.get('ignore_task_deps') == "true"
-        ignore_ti_state = request.args.get('ignore_ti_state') == "true"
+        ignore_all_deps = request.form.get('ignore_all_deps') == "true"
+        ignore_task_deps = request.form.get('ignore_task_deps') == "true"
+        ignore_ti_state = request.form.get('ignore_ti_state') == "true"
 
         from airflow.executors import GetDefaultExecutor
         executor = GetDefaultExecutor()
@@ -1080,7 +1081,7 @@ def run(self):
             "it should start any moment now.".format(ti))
         return redirect(origin)
 
-    @expose('/delete')
+    @expose('/delete', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
@@ -1088,8 +1089,8 @@ def delete(self):
         from airflow.api.common.experimental import delete_dag
         from airflow.exceptions import DagNotFound, DagFileExists
 
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin') or "/admin/"
+        dag_id = request.values.get('dag_id')
+        origin = request.values.get('origin') or "/admin/"
 
         try:
             delete_dag.delete_dag(dag_id)
@@ -1106,14 +1107,14 @@ def delete(self):
         # Upon successful delete return to origin
         return redirect(origin)
 
-    @expose('/trigger')
+    @expose('/trigger', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     @provide_session
     def trigger(self, session=None):
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin') or "/admin/"
+        dag_id = request.values.get('dag_id')
+        origin = request.values.get('origin') or "/admin/"
         dag = session.query(models.DagModel).filter(models.DagModel.dag_id == dag_id).first()
         if not dag:
             flash("Cannot find dag {}".format(dag_id))
@@ -1176,24 +1177,24 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
 
         return response
 
-    @expose('/clear')
+    @expose('/clear', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def clear(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
         dag = dagbag.get_dag(dag_id)
 
-        execution_date = request.args.get('execution_date')
+        execution_date = request.form.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
-        recursive = request.args.get('recursive') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
+        recursive = request.form.get('recursive') == "true"
 
         dag = dag.sub_dag(
             task_regex=r"^{0}$".format(task_id),
@@ -1206,15 +1207,15 @@ def clear(self):
         return self._clear_dag_tis(dag, start_date, end_date, origin,
                                    recursive=recursive, confirmed=confirmed)
 
-    @expose('/dagrun_clear')
+    @expose('/dagrun_clear', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def dagrun_clear(self):
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == "true"
+        dag_id = request.form.get('dag_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == "true"
 
         dag = dagbag.get_dag(dag_id)
         execution_date = pendulum.parse(execution_date)
@@ -1304,27 +1305,27 @@ def _mark_dagrun_state_as_success(self, dag_id, execution_date, confirmed, origi
 
             return response
 
-    @expose('/dagrun_failed')
+    @expose('/dagrun_failed', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def dagrun_failed(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == 'true'
+        origin = request.form.get('origin')
         return self._mark_dagrun_state_as_failed(dag_id, execution_date,
                                                  confirmed, origin)
 
-    @expose('/dagrun_success')
+    @expose('/dagrun_success', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def dagrun_success(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == 'true'
+        origin = request.form.get('origin')
         return self._mark_dagrun_state_as_success(dag_id, execution_date,
                                                   confirmed, origin)
 
@@ -1370,41 +1371,41 @@ def _mark_task_instance_state(self, dag_id, task_id, origin, execution_date,
 
         return response
 
-    @expose('/failed')
+    @expose('/failed', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def failed(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
 
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
 
         return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
                                               confirmed, upstream, downstream,
                                               future, past, State.FAILED)
 
-    @expose('/success')
+    @expose('/success', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @wwwutils.notify_owner
     def success(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
 
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
 
         return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
                                               confirmed, upstream, downstream,
@@ -1893,10 +1894,10 @@ def landing_times(self, session=None):
     @provide_session
     def paused(self, session=None):
         DagModel = models.DagModel
-        dag_id = request.args.get('dag_id')
+        dag_id = request.values.get('dag_id')
         orm_dag = session.query(
             DagModel).filter(DagModel.dag_id == dag_id).first()
-        if request.args.get('is_paused') == 'false':
+        if request.values.get('is_paused') == 'false':
             orm_dag.is_paused = True
         else:
             orm_dag.is_paused = False
@@ -1906,14 +1907,14 @@ def paused(self, session=None):
         dagbag.get_dag(dag_id)
         return "OK"
 
-    @expose('/refresh')
+    @expose('/refresh', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     @provide_session
     def refresh(self, session=None):
         # TODO: Is this method still needed after AIRFLOW-3561?
         dm = models.DagModel
-        dag_id = request.args.get('dag_id')
+        dag_id = request.values.get('dag_id')
         orm_dag = session.query(dm).filter(dm.dag_id == dag_id).first()
 
         if orm_dag:
@@ -1924,7 +1925,7 @@ def refresh(self, session=None):
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
 
-    @expose('/refresh_all')
+    @expose('/refresh_all', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     def refresh_all(self):
@@ -2057,7 +2058,7 @@ def variables(self, form):
             return ("Error: form airflow/variables/{}.html "
                     "not found.").format(form), 404
 
-    @expose('/varimport', methods=["GET", "POST"])
+    @expose('/varimport', methods=['POST'])
     @login_required
     @wwwutils.action_logging
     def varimport(self):
@@ -2213,7 +2214,7 @@ class QueryForm(Form):
         results = None
         has_data = False
         error = False
-        if conn_id_str:
+        if conn_id_str and request.method == 'POST':
             db = [db for db in dbs if db.conn_id == conn_id_str][0]
             hook = db.get_hook()
             try:
diff --git a/airflow/www_rbac/static/css/main.css b/airflow/www_rbac/static/css/main.css
index bc9bb25daa1ac..b3119e56247f2 100644
--- a/airflow/www_rbac/static/css/main.css
+++ b/airflow/www_rbac/static/css/main.css
@@ -47,10 +47,14 @@ td>span.glyphicon{
     padding-left: 3px;
     padding-top: 3px;
 }
-button.btn {
+button.btn, label.btn {
     border: 1px solid black;
 }
 
+.btn-group label.btn {
+    background-color: #f0f0f0;
+}
+
 div.rich_doc {
     padding: 5px 10px;
     border: 1px solid #dddddd;
diff --git a/airflow/www_rbac/static/js/base.js b/airflow/www_rbac/static/js/base.js
index 1f16b44a16bb9..f9385481023a5 100644
--- a/airflow/www_rbac/static/js/base.js
+++ b/airflow/www_rbac/static/js/base.js
@@ -39,6 +39,38 @@ export function escapeHtml(text) {
 
 window.escapeHtml = escapeHtml;
 
+function postAsForm(url, parameters) {
+  var form = $("<form></form>");
+
+  form.attr("method", "POST");
+  form.attr("action", url);
+
+  $.each(parameters || {}, function(key, value) {
+    var field = $('<input></input>');
+
+    field.attr("type", "hidden");
+    field.attr("name", key);
+    field.attr("value", value);
+
+    form.append(field);
+  });
+
+  var field = $('<input></input>');
+
+  field.attr("type", "hidden");
+  field.attr("name", "csrf_token");
+  field.attr("value", csrfToken);
+
+  form.append(field);
+
+  // The form needs to be a part of the document in order for us to be able
+  // to submit it.
+  $(document.body).append(form);
+  form.submit();
+}
+
+window.postAsForm = postAsForm;
+
 $(document).ready(function () {
   displayTime();
   $('span').tooltip();
diff --git a/airflow/www_rbac/templates/airflow/confirm.html b/airflow/www_rbac/templates/airflow/confirm.html
index 3d280356547b3..5b5253d9ebb17 100644
--- a/airflow/www_rbac/templates/airflow/confirm.html
+++ b/airflow/www_rbac/templates/airflow/confirm.html
@@ -26,10 +26,15 @@ <h2>Wait a minute.</h2>
         <pre><code>{{ details }}</code></pre>
     {% endif %}
     </div>
-    <button class="btn btn-primary" onclick="window.location += '&confirmed=true'">
-        OK!
-    </button>
-    <button class="btn" onclick="window.history.back()">bail.</button>
+    <form method="POST">
+      <input name="csrf_token" type="hidden" value="{{ csrf_token() }}"/>
+      <input name="confirmed" type="hidden" value="true">
+      {% for name,val in request.form.items() if name != "csrf_token" %}
+        <input type="hidden" name="{{ name }}" value="{{ val }}">
+      {% endfor %}
+      <input class="btn btn-primary" type="submit" value="OK!">
+      <button class="btn" onclick="window.history.back(); return false">bail.</button>
+    </form>
     <br>
     <br>
 {% endblock %}
diff --git a/airflow/www_rbac/templates/airflow/dag.html b/airflow/www_rbac/templates/airflow/dag.html
index 685b7e9441284..2d4f14337f70c 100644
--- a/airflow/www_rbac/templates/airflow/dag.html
+++ b/airflow/www_rbac/templates/airflow/dag.html
@@ -96,20 +96,20 @@ <h4 class="pull-right">
       </li>
       <li>
         <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id, origin=url_for('Airflow.tree', dag_id=dag.dag_id)) }}"
-          onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+          onclick="return confirmTriggerDag(this, '{{ dag.safe_dag_id }}')">
           <span class="glyphicon glyphicon-play-circle" aria-hidden="true"></span>
           Trigger DAG
         </a>
       </li>
       <li>
-        <a href="{{ url_for('Airflow.refresh', dag_id=dag.dag_id) }}" title="Refresh">
+        <a href="{{ url_for('Airflow.refresh', dag_id=dag.dag_id) }}" title="Refresh" onclick="postAsForm(this.href); return false">
           <span class="glyphicon glyphicon-refresh" aria-hidden="true"></span>
           Refresh
         </a>
       </li>
       <li>
         <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id, root=root) }}"
-        onclick="return confirmDeleteDag('{{ dag.safe_dag_id }}')">
+        onclick="return confirmDeleteDag(this, '{{ dag.safe_dag_id }}')">
         <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true"></span>
         Delete
         </a>
@@ -159,92 +159,116 @@ <h4 class="modal-title" id="myModalLabel">
             </ul>
           </div>
           <hr/>
-          <button id="btn_run" type="button" class="btn btn-primary"
-            title="Runs a single task instance">
-            Run
-          </button>
-          <span class="btn-group">
-            <button id="btn_ignore_all_deps"
-              type="button" class="btn" data-toggle="button"
-              title="Ignores all non-critical dependencies, including task state and task_deps"
-              >Ignore All Deps</button>
-          </span>
-          <span class="btn-group">
-            <button id="btn_ignore_ti_state"
-              type="button" class="btn" data-toggle="button"
-              title="Ignore previous success/failure"
-              >Ignore Task State</button>
-          </span>
-          <button id="btn_ignore_task_deps"
-            type="button" class="btn" data-toggle="button"
-            title="Disregard the task-specific dependencies, e.g. status of upstream task instances and depends_on_past"
-            >Ignore Task Deps</button>
-          </span>
-          <hr/>
-          <button id="btn_clear" type="button" class="btn btn-primary"
-              title="Clearing deletes the previous state of the task instance, allowing it to get re-triggered by the scheduler or a backfill command"
-              >Clear
-          </button>
-          <span class="btn-group">
-            <button id="btn_past"
-              type="button" class="btn" data-toggle="button"
-              title="Also include past task instances when clearing this one"
-              >Past</button>
-            <button id="btn_future"
-              type="button" class="btn" data-toggle="button"
-              title="Also include future task instances when clearing this one"
-              >Future</button>
-            <button id="btn_upstream"
-              type="button" class="btn" data-toggle="button"
-              title="Also include upstream dependencies"
-              >Upstream</button>
-            <button id="btn_downstream"
-              type="button" class="btn active" data-toggle="button"
-              title="Also include downstream dependencies"
-              >
-              Downstream
-            </button>
-            <button id="btn_recursive"
-              type="button" class="btn active" data-toggle="button">
-               Recursive
+          <form method="POST">
+            <input name="csrf_token" type="hidden" value="{{ csrf_token() }}"/>
+            <input name="dag_id" type="hidden">
+            <input name="task_id" type="hidden">
+            <input name="execution_date" type="hidden">
+            <input name="origin" type="hidden" value="{{ request.base_url }}">
+            <button id="btn_run" type="button" class="btn btn-primary"
+              title="Runs a single task instance"
+              data-action="{{ url_for('Airflow.run') }}">
+              Run
             </button>
-          </span>
-          <hr/>
-          <button id="btn_failed" type="button" class="btn btn-primary">
-            Mark Failed
-          </button>
-          <span class="btn-group">
-            <button id="btn_failed_past"
-              type="button" class="btn" data-toggle="button">Past</button>
-            <button id="btn_failed_future"
-              type="button" class="btn" data-toggle="button">
-              Future
+            <input type="hidden" name="ignore_all_deps">
+            <input type="hidden" name="ignore_ti_state">
+            <input type="hidden" name="ignore_task_deps">
+            <span class="btn-group" data-toggle="buttons">
+              <label
+                class="btn"
+                title="Ignores all non-critical dependencies, including task state and task_deps">
+                <input type="checkbox" value="true" name="ignore_all_deps" autocomplete="off">
+                Ignore All Deps</label>
+              <label class="btn"
+                title="Ignore previous success/failure">
+                <input type="checkbox" value="true" name="ignore_ti_state" autocomplete="off">
+                Ignore Task State
+              </label>
+              <label class="btn"
+                title="Disregard the task-specific dependencies, e.g. status of upstream task instances and depends_on_past">
+                <input type="checkbox" value="true" name="ignore_task_deps" autocomplete="off">
+                Ignore Task Deps
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_clear" type="button" class="btn btn-primary"
+                title="Clearing deletes the previous state of the task instance, allowing it to get re-triggered by the scheduler or a backfill command"
+                data-action="{{ url_for('Airflow.clear') }}"
+                >Clear
             </button>
-            <button id="btn_failed_upstream"
-              type="button" class="btn" data-toggle="button">Upstream</button>
-            <button id="btn_failed_downstream"
-              type="button" class="btn" data-toggle="button">
-              Downstream
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn"
+                title="Also include past task instances when clearing this one">
+                <input type="checkbox" value="true" name="past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn"
+                title="Also include future task instances when clearing this one">
+                <input type="checkbox" value="true" name="future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn"
+                title="Also include upstream dependencies">
+                <input type="checkbox" value="true" name="upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn active"
+                title="Also include downstream dependencies">
+                <input type="checkbox" value="true" name="downstream" checked autocomplete="off">
+                Downstream
+              </label>
+              <label class="btn active">
+                <input type="checkbox" value="true" name="recursive" checked autocomplete="off">
+                 Recursive
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_failed" type="button" class="btn btn-primary"
+                data-action="{{ url_for('Airflow.failed') }}">
+              Mark Failed
             </button>
-          </span>
-          <hr/>
-          <button id="btn_success" type="button" class="btn btn-primary">
-            Mark Success
-          </button>
-          <span class="btn-group">
-            <button id="btn_success_past"
-              type="button" class="btn" data-toggle="button">Past</button>
-            <button id="btn_success_future"
-              type="button" class="btn" data-toggle="button">
-              Future
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="failed_downstream" autocomplete="off">
+                Downstream
+              </label>
+            </span>
+            <hr/>
+            <button id="btn_success" type="button" class="btn btn-primary"
+                data-action="{{ url_for('Airflow.success') }}">
+              Mark Success
             </button>
-            <button id="btn_success_upstream"
-              type="button" class="btn" data-toggle="button">Upstream</button>
-            <button id="btn_success_downstream"
-              type="button" class="btn" data-toggle="button">
-              Downstream
-            </button>
-          </span>
+            <span class="btn-group" data-toggle="buttons">
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_past" autocomplete="off">
+                Past
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_future" autocomplete="off">
+                Future
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_upstream" autocomplete="off">
+                Upstream
+              </label>
+              <label class="btn">
+                <input type="checkbox" value="true" name="success_downstream" autocomplete="off">
+                Downstream
+              </label>
+            </span>
+          </form>
         </div>
         <div class="modal-footer">
           <button type="button" class="btn btn-default" data-dismiss="modal">
@@ -266,18 +290,24 @@ <h4 class="modal-title" id="dagModalLabel">
           </h4>
         </div>
         <div class="modal-body">
-          <button id="btn_edit_dagrun" type="button" class="btn btn-primary">
-            Edit
-          </button>
-          <button id="btn_dagrun_clear" type="button" class="btn btn-primary">
-            Clear
-          </button>
-          <button id="btn_dagrun_failed" type="button" class="btn btn-primary">
-            Mark Failed
-          </button>
-          <button id="btn_dagrun_success" type="button" class="btn btn-primary">
-            Mark Success
-          </button>
+          <form method="POST">
+            <button id="btn_edit_dagrun" type="button" class="btn btn-primary">
+              Edit
+            </button>
+            <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>
+            <input name="dag_id" type="hidden">
+            <input name="execution_date" type="hidden">
+            <input name="origin" type="hidden" value="{{ request.base_url }}">
+            <button id="btn_dagrun_clear" type="button" class="btn btn-primary" data-action="{{ url_for('Airflow.dagrun_clear') }}">
+              Clear
+            </button>
+            <button id="btn_dagrun_failed" type="button" class="btn btn-primary" data-action="{{ url_for('Airflow.dagrun_failed') }}">
+              Mark Failed
+            </button>
+            <button id="btn_dagrun_success" type="button" class="btn btn-primary" data-action="{{ url_for('Airflow.dagrun_success') }}">
+              Mark Success
+            </button>
+          </form>
         </div>
         <div class="modal-footer">
           <button type="button" class="btn btn-default" data-dismiss="modal">
@@ -366,15 +396,22 @@ <h4 class="modal-title" id="dagModalLabel">
       $("#dagModal").css("margin-top","0px");
     }
 
-    function confirmTriggerDag(dag_id){
-        return confirm("Are you sure you want to run '"+dag_id+"' now?");
+    function confirmTriggerDag(link, dag_id){
+      if (confirm("Are you sure you want to run '"+dag_id+"' now?")) {
+        postAsForm(link.href, {});
+      }
+      // Never follow the link
+      return false;
     }
 
-    function confirmDeleteDag(dag_id){
-        return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
-          This option will delete ALL metadata, DAG runs, etc.\n\
-          EXCEPT Log.\n\
-          This cannot be undone.");
+    function confirmDeleteDag(link, dag_id){
+      if (confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+        This option will delete ALL metadata, DAG runs, etc.\n\
+        EXCEPT Log.\n\
+        This cannot be undone.")) {
+        postAsForm(link.href, {});
+      }
+      return false;
     }
 
     $("#btn_rendered").click(function(){
@@ -416,98 +453,18 @@ <h4 class="modal-title" id="dagModalLabel">
       window.location = url;
     });
 
-    $("#btn_run").click(function(){
-      url = "{{ url_for('Airflow.run') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&ignore_all_deps=" + $('#btn_ignore_all_deps').hasClass('active') +
-        "&ignore_task_deps=" + $('#btn_ignore_task_deps').hasClass('active') +
-        "&ignore_ti_state=" + $('#btn_ignore_ti_state').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_clear").click(function(){
-      url = "{{ url_for('Airflow.clear') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&future=" + $('#btn_future').hasClass('active') +
-        "&past=" + $('#btn_past').hasClass('active') +
-        "&upstream=" + $('#btn_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_downstream').hasClass('active') +
-        "&recursive=" + $('#btn_recursive').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_dagrun_clear").click(function(){
-      url = "{{ url_for('Airflow.dagrun_clear') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_failed").click(function(){
-      url = "{{ url_for('Airflow.failed') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&upstream=" + $('#btn_failed_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_failed_downstream').hasClass('active') +
-        "&future=" + $('#btn_failed_future').hasClass('active') +
-        "&past=" + $('#btn_failed_past').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-
-      window.location = url;
-    });
-
-    $("#btn_success").click(function(){
-      url = "{{ url_for('Airflow.success') }}" +
-        "?task_id=" + encodeURIComponent(task_id) +
-        "&dag_id=" + encodeURIComponent(dag_id) +
-        "&upstream=" + $('#btn_success_upstream').hasClass('active') +
-        "&downstream=" + $('#btn_success_downstream').hasClass('active') +
-        "&future=" + $('#btn_success_future').hasClass('active') +
-        "&past=" + $('#btn_success_past').hasClass('active') +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-
-      window.location = url;
-    });
-
-    $('#btn_dagrun_failed').click(function(){
-      url = "{{ url_for('Airflow.dagrun_failed') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $('#btn_dagrun_success').click(function(){
-      url = "{{ url_for('Airflow.dagrun_success') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date) +
-        "&origin=" + encodeURIComponent(window.location);
-      window.location = url;
-    });
-
-    $("#btn_gantt").click(function(){
-      url = "{{ url_for('Airflow.gantt') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date);
-      window.location = url;
-    });
+    $('form button[data-action]').click(function (e) {
+      var form = $(this).closest('form').get(0);
+      form.dag_id.value = dag_id;
+      form.execution_date.value = execution_date;
+      form.origin.value = window.location;
+      if (form.task_id) {
+        form.task_id.value = task_id;
+      }
+      form.action = $(this).data("action");
+      form.submit();
+    })
 
-    $("#btn_graph").click(function(){
-      url = "{{ url_for('Airflow.graph') }}" +
-        "?dag_id=" + encodeURIComponent(dag_id) +
-        "&execution_date=" + encodeURIComponent(execution_date);
-      window.location = url;
-    });
 
     $("#pause_resume").change(function() {
       var dag_id = $(this).attr('dag_id');
diff --git a/airflow/www_rbac/templates/airflow/dags.html b/airflow/www_rbac/templates/airflow/dags.html
index a0bdefab64e1f..10d5bcd55c9ed 100644
--- a/airflow/www_rbac/templates/airflow/dags.html
+++ b/airflow/www_rbac/templates/airflow/dags.html
@@ -123,7 +123,7 @@ <h2>DAGs</h2>
 
                 <!-- Trigger Dag -->
                 <a href="{{ url_for('Airflow.trigger', dag_id=dag.dag_id) }}&origin={{ request.base_url }}"
-                   onclick="return confirmTriggerDag('{{ dag.safe_dag_id }}')">
+                   onclick="return confirmTriggerDag(this, '{{ dag.safe_dag_id }}')">
                     <span class="glyphicon glyphicon-play-circle" aria-hidden="true" data-original-title="Trigger Dag"></span>
                 </a>
 
@@ -169,14 +169,14 @@ <h2>DAGs</h2>
                 {% endif %}
 
                 <!-- Refresh -->
-                <a href="{{ url_for("Airflow.refresh", dag_id=dag.dag_id) }}">
+                <a href="{{ url_for("Airflow.refresh", dag_id=dag.dag_id) }}" onclick="postAsForm(this.href); return false">
                   <span class="glyphicon glyphicon-refresh" aria-hidden="true" data-original-title="Refresh"></span>
                 </a>
 
                 <!-- Delete -->
                 <!-- Use dag_id instead of dag.dag_id, because the DAG might not exist in the webserver's DagBag -->
                 <a href="{{ url_for('Airflow.delete', dag_id=dag.dag_id) }}"
-                  onclick="return confirmDeleteDag('{{ dag.dag_id }}')">
+                  onclick="return confirmDeleteDag(this, '{{ dag.dag_id }}')">
                    <span class="glyphicon glyphicon-remove-circle" style="color:red" aria-hidden="true" data-original-title="Delete Dag"></span>
                 </a>
                 </td>
@@ -231,15 +231,22 @@ <h2>DAGs</h2>
         window.location = DAGS_INDEX + "?page_size=" + p_size;
       });
 
-      function confirmDeleteDag(dag_id){
-          return confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
-          This option will delete ALL metadata, DAG runs, etc.\n\
-          EXCEPT Log.\n\
-          This cannot be undone.");
+      function confirmTriggerDag(link, dag_id){
+        if (confirm("Are you sure you want to run '"+dag_id+"' now?")) {
+          postAsForm(link.href, {});
+        }
+        // Never follow the link
+        return false;
       }
 
-      function confirmTriggerDag(dag_id){
-          return confirm("Are you sure you want to run '"+dag_id+"' now?");
+      function confirmDeleteDag(link, dag_id){
+        if (confirm("Are you sure you want to delete '"+dag_id+"' now?\n\
+          This option will delete ALL metadata, DAG runs, etc.\n\
+          EXCEPT Log.\n\
+          This cannot be undone.")) {
+          postAsForm(link.href, {});
+        }
+        return false;
       }
       all_dags = $("[id^=toggle]");
       $.each(all_dags, function(i,v) {
diff --git a/airflow/www_rbac/views.py b/airflow/www_rbac/views.py
index c44d25bd474c8..044b553c531c6 100644
--- a/airflow/www_rbac/views.py
+++ b/airflow/www_rbac/views.py
@@ -745,22 +745,22 @@ def xcom(self, session=None):
             root=root,
             dag=dag, title=title)
 
-    @expose('/run')
+    @expose('/run', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def run(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
         dag = dagbag.get_dag(dag_id)
         task = dag.get_task(task_id)
 
-        execution_date = request.args.get('execution_date')
+        execution_date = request.form.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        ignore_all_deps = request.args.get('ignore_all_deps') == "true"
-        ignore_task_deps = request.args.get('ignore_task_deps') == "true"
-        ignore_ti_state = request.args.get('ignore_ti_state') == "true"
+        ignore_all_deps = request.form.get('ignore_all_deps') == "true"
+        ignore_task_deps = request.form.get('ignore_task_deps') == "true"
+        ignore_ti_state = request.form.get('ignore_ti_state') == "true"
 
         from airflow.executors import GetDefaultExecutor
         executor = GetDefaultExecutor()
@@ -813,7 +813,7 @@ def run(self):
             "it should start any moment now.".format(ti))
         return redirect(origin)
 
-    @expose('/delete')
+    @expose('/delete', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
@@ -821,8 +821,8 @@ def delete(self):
         from airflow.api.common.experimental import delete_dag
         from airflow.exceptions import DagNotFound, DagFileExists
 
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin') or url_for('Airflow.index')
+        dag_id = request.values.get('dag_id')
+        origin = request.values.get('origin') or url_for('Airflow.index')
 
         try:
             delete_dag.delete_dag(dag_id)
@@ -841,14 +841,14 @@ def delete(self):
         # Upon success return to origin.
         return redirect(origin)
 
-    @expose('/trigger')
+    @expose('/trigger', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     @provide_session
     def trigger(self, session=None):
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin') or "/"
+        dag_id = request.values.get('dag_id')
+        origin = request.values.get('origin') or url_for('Airflow.index')
         dag = session.query(models.DagModel).filter(models.DagModel.dag_id == dag_id).first()
         if not dag:
             flash("Cannot find dag {}".format(dag_id))
@@ -911,24 +911,24 @@ def _clear_dag_tis(self, dag, start_date, end_date, origin,
 
         return response
 
-    @expose('/clear')
+    @expose('/clear', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def clear(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
         dag = dagbag.get_dag(dag_id)
 
-        execution_date = request.args.get('execution_date')
+        execution_date = request.form.get('execution_date')
         execution_date = pendulum.parse(execution_date)
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
-        recursive = request.args.get('recursive') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
+        recursive = request.form.get('recursive') == "true"
 
         dag = dag.sub_dag(
             task_regex=r"^{0}$".format(task_id),
@@ -941,15 +941,15 @@ def clear(self):
         return self._clear_dag_tis(dag, start_date, end_date, origin,
                                    recursive=recursive, confirmed=confirmed)
 
-    @expose('/dagrun_clear')
+    @expose('/dagrun_clear', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_clear(self):
-        dag_id = request.args.get('dag_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == "true"
+        dag_id = request.form.get('dag_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == "true"
 
         dag = dagbag.get_dag(dag_id)
         execution_date = pendulum.parse(execution_date)
@@ -1046,27 +1046,27 @@ def _mark_dagrun_state_as_success(self, dag_id, execution_date, confirmed, origi
 
             return response
 
-    @expose('/dagrun_failed')
+    @expose('/dagrun_failed', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_failed(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == 'true'
+        origin = request.form.get('origin')
         return self._mark_dagrun_state_as_failed(dag_id, execution_date,
                                                  confirmed, origin)
 
-    @expose('/dagrun_success')
+    @expose('/dagrun_success', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def dagrun_success(self):
-        dag_id = request.args.get('dag_id')
-        execution_date = request.args.get('execution_date')
-        confirmed = request.args.get('confirmed') == 'true'
-        origin = request.args.get('origin')
+        dag_id = request.form.get('dag_id')
+        execution_date = request.form.get('execution_date')
+        confirmed = request.form.get('confirmed') == 'true'
+        origin = request.form.get('origin')
         return self._mark_dagrun_state_as_success(dag_id, execution_date,
                                                   confirmed, origin)
 
@@ -1112,41 +1112,41 @@ def _mark_task_instance_state(self, dag_id, task_id, origin, execution_date,
 
         return response
 
-    @expose('/failed')
+    @expose('/failed', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def failed(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
 
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
 
         return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
                                               confirmed, upstream, downstream,
                                               future, past, State.FAILED)
 
-    @expose('/success')
+    @expose('/success', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     def success(self):
-        dag_id = request.args.get('dag_id')
-        task_id = request.args.get('task_id')
-        origin = request.args.get('origin')
-        execution_date = request.args.get('execution_date')
+        dag_id = request.form.get('dag_id')
+        task_id = request.form.get('task_id')
+        origin = request.form.get('origin')
+        execution_date = request.form.get('execution_date')
 
-        confirmed = request.args.get('confirmed') == "true"
-        upstream = request.args.get('upstream') == "true"
-        downstream = request.args.get('downstream') == "true"
-        future = request.args.get('future') == "true"
-        past = request.args.get('past') == "true"
+        confirmed = request.form.get('confirmed') == "true"
+        upstream = request.form.get('upstream') == "true"
+        downstream = request.form.get('downstream') == "true"
+        future = request.form.get('future') == "true"
+        past = request.form.get('past') == "true"
 
         return self._mark_task_instance_state(dag_id, task_id, origin, execution_date,
                                               confirmed, upstream, downstream,
@@ -1660,14 +1660,14 @@ def paused(self, session=None):
         dagbag.get_dag(dag_id)
         return "OK"
 
-    @expose('/refresh')
+    @expose('/refresh', methods=['POST'])
     @has_dag_access(can_dag_edit=True)
     @has_access
     @action_logging
     @provide_session
     def refresh(self, session=None):
         DagModel = models.DagModel
-        dag_id = request.args.get('dag_id')
+        dag_id = request.values.get('dag_id')
         orm_dag = session.query(
             DagModel).filter(DagModel.dag_id == dag_id).first()
 
@@ -1683,7 +1683,7 @@ def refresh(self, session=None):
         flash("DAG [{}] is now fresh as a daisy".format(dag_id))
         return redirect(request.referrer)
 
-    @expose('/refresh_all')
+    @expose('/refresh_all', methods=['POST'])
     @has_access
     @action_logging
     def refresh_all(self):
diff --git a/tests/core.py b/tests/core.py
index 8c407a7c952c3..68a795fcb31df 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -1994,49 +1994,75 @@ def test_dag_views(self):
         response = self.app.get(
             '/admin/airflow/task_stats')
         self.assertIn("example_bash_operator", response.data.decode('utf-8'))
-        url = (
-            "/admin/airflow/success?task_id=print_the_context&"
-            "dag_id=example_python_operator&upstream=false&downstream=false&"
-            "future=false&past=false&execution_date={}&"
-            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
-        response = self.app.get(url)
+
+        response = self.app.post("/admin/airflow/success", data=dict(
+            task_id="print_the_context",
+            dag_id="example_python_operator",
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
+            origin="/admin"))
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
-        response = self.app.get(
-            '/admin/airflow/clear?task_id=print_the_context&'
-            'dag_id=example_python_operator&future=true&past=false&'
-            'upstream=true&downstream=false&'
-            'execution_date={}&'
-            'origin=/admin'.format(EXAMPLE_DAG_DEFAULT_DATE))
+
+        response = self.app.post('/admin/airflow/clear', data=dict(
+            task_id="print_the_context",
+            dag_id="example_python_operator",
+            future="true",
+            past="false",
+            upstream="true",
+            downstream="false",
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
+            origin="/admin"))
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
-        url = (
-            "/admin/airflow/success?task_id=section-1&"
-            "dag_id=example_subdag_operator&upstream=true&downstream=true&"
-            "future=false&past=false&execution_date={}&"
-            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
-        response = self.app.get(url)
+
+        form = dict(
+            task_id="section-1",
+            dag_id="example_subdag_operator",
+            upstream="true",
+            downstream="true",
+            future="false",
+            past="false",
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
+            origin="/admin")
+        response = self.app.post("/admin/airflow/success", data=form)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         self.assertIn("section-1-task-1", response.data.decode('utf-8'))
         self.assertIn("section-1-task-2", response.data.decode('utf-8'))
         self.assertIn("section-1-task-3", response.data.decode('utf-8'))
         self.assertIn("section-1-task-4", response.data.decode('utf-8'))
         self.assertIn("section-1-task-5", response.data.decode('utf-8'))
-        response = self.app.get(url + "&confirmed=true")
-        url = (
-            "/admin/airflow/clear?task_id=print_the_context&"
-            "dag_id=example_python_operator&future=false&past=false&"
-            "upstream=false&downstream=true&"
-            "execution_date={}&"
-            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
-        response = self.app.get(url)
+        form["confirmed"] = "true"
+        response = self.app.post("/admin/airflow/success", data=form)
+        self.assertEqual(response.status_code, 302)
+
+        form = dict(
+            task_id="print_the_context",
+            dag_id="example_python_operator",
+            future="false",
+            past="false",
+            upstream="false",
+            downstream="true",
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
+            origin="/admin")
+        response = self.app.post("/admin/airflow/clear", data=form)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
-        response = self.app.get(url + "&confirmed=true")
-        url = (
-            "/admin/airflow/clear?task_id=section-1-task-1&"
-            "dag_id=example_subdag_operator.section-1&future=false&past=false&"
-            "upstream=false&downstream=true&recursive=true&"
-            "execution_date={}&"
-            "origin=/admin".format(EXAMPLE_DAG_DEFAULT_DATE))
-        response = self.app.get(url)
+        form["confirmed"] = "true"
+        response = self.app.post("/admin/airflow/clear", data=form)
+        self.assertEqual(response.status_code, 302)
+
+        form = dict(
+            task_id="section-1-task-1",
+            dag_id="example_subdag_operator.section-1",
+            future="false",
+            past="false",
+            upstream="false",
+            downstream="true",
+            recursive="true",
+            execution_date=EXAMPLE_DAG_DEFAULT_DATE,
+            origin="/admin")
+        response = self.app.post("/admin/airflow/clear", data=form)
         self.assertIn("Wait a minute", response.data.decode('utf-8'))
         self.assertIn("example_subdag_operator.end",
                       response.data.decode('utf-8'))
diff --git a/tests/www/test_views.py b/tests/www/test_views.py
index 393bde147bd0a..29f3d06bae920 100644
--- a/tests/www/test_views.py
+++ b/tests/www/test_views.py
@@ -828,7 +828,7 @@ def setUp(self):
     def test_delete_dag_button_normal(self):
         resp = self.app.get('/', follow_redirects=True)
         self.assertIn('/delete?dag_id=example_bash_operator', resp.data.decode('utf-8'))
-        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag(this, 'example_bash_operator')", resp.data.decode('utf-8'))
 
     def test_delete_dag_button_for_dag_on_scheduler_only(self):
         # Test for JIRA AIRFLOW-3233 (PR 4069):
@@ -844,7 +844,7 @@ def test_delete_dag_button_for_dag_on_scheduler_only(self):
 
         resp = self.app.get('/', follow_redirects=True)
         self.assertIn('/delete?dag_id={}'.format(test_dag_id), resp.data.decode('utf-8'))
-        self.assertIn("return confirmDeleteDag('{}')".format(test_dag_id), resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag(this, '{}')".format(test_dag_id), resp.data.decode('utf-8'))
 
         session.query(DM).filter(DM.dag_id == test_dag_id).update({'dag_id': 'example_bash_operator'})
         session.commit()
@@ -863,7 +863,7 @@ def setUp(self):
     def test_trigger_dag_button_normal_exist(self):
         resp = self.app.get('/', follow_redirects=True)
         self.assertIn('/trigger?dag_id=example_bash_operator', resp.data.decode('utf-8'))
-        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag(this, 'example_bash_operator')", resp.data.decode('utf-8'))
 
     def test_trigger_dag_button(self):
 
@@ -873,7 +873,7 @@ def test_trigger_dag_button(self):
         self.session.query(DR).delete()
         self.session.commit()
 
-        self.app.get('/admin/airflow/trigger?dag_id={}'.format(test_dag_id))
+        self.app.post('/admin/airflow/trigger?dag_id={}'.format(test_dag_id))
 
         run = self.session.query(DR).filter(DR.dag_id == test_dag_id).first()
         self.assertIsNotNone(run)
diff --git a/tests/www_rbac/test_views.py b/tests/www_rbac/test_views.py
index bd704ec5d2392..f11a9df0dede1 100644
--- a/tests/www_rbac/test_views.py
+++ b/tests/www_rbac/test_views.py
@@ -515,41 +515,63 @@ def test_paused(self):
         self.check_content_in_response('OK', resp)
 
     def test_failed(self):
-        url = ('failed?task_id=run_this_last&dag_id=example_bash_operator&'
-               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="run_this_last",
+            dag_id="example_bash_operator",
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+        )
+        resp = self.client.post("failed", data=form)
         self.check_content_in_response('Wait a minute', resp)
 
     def test_success(self):
-        url = ('success?task_id=run_this_last&dag_id=example_bash_operator&'
-               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="run_this_last",
+            dag_id="example_bash_operator",
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+        )
+        resp = self.client.post('success', data=form)
         self.check_content_in_response('Wait a minute', resp)
 
     def test_clear(self):
-        url = ('clear?task_id=runme_1&dag_id=example_bash_operator&'
-               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="runme_1",
+            dag_id="example_bash_operator",
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+        )
+        resp = self.client.post("clear", data=form)
         self.check_content_in_response(['example_bash_operator', 'Wait a minute'], resp)
 
     def test_run(self):
-        url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
-               'ignore_ti_state=true&execution_date={}'
-               .format(self.percent_encode(self.EXAMPLE_DAG_DEFAULT_DATE)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="runme_0",
+            dag_id="example_bash_operator",
+            ignore_all_deps="false",
+            ignore_ti_state="true",
+            execution_date=self.EXAMPLE_DAG_DEFAULT_DATE,
+        )
+        resp = self.client.post('run', data=form)
         self.check_content_in_response('', resp, resp_code=302)
 
     def test_refresh(self):
-        resp = self.client.get('refresh?dag_id=example_bash_operator')
+        resp = self.client.post('refresh?dag_id=example_bash_operator')
         self.check_content_in_response('', resp, resp_code=302)
 
     def test_delete_dag_button_normal(self):
         resp = self.client.get('/', follow_redirects=True)
         self.check_content_in_response('/delete?dag_id=example_bash_operator', resp)
-        self.check_content_in_response("return confirmDeleteDag('example_bash_operator')", resp)
+        self.check_content_in_response("return confirmDeleteDag(this, 'example_bash_operator')", resp)
 
     def test_delete_dag_button_for_dag_on_scheduler_only(self):
         # Test for JIRA AIRFLOW-3233 (PR 4069):
@@ -564,7 +586,7 @@ def test_delete_dag_button_for_dag_on_scheduler_only(self):
 
         resp = self.client.get('/', follow_redirects=True)
         self.check_content_in_response('/delete?dag_id={}'.format(test_dag_id), resp)
-        self.check_content_in_response("return confirmDeleteDag('{}')".format(test_dag_id), resp)
+        self.check_content_in_response("return confirmDeleteDag(this, '{}')".format(test_dag_id), resp)
 
         self.session.query(DM).filter(DM.dag_id == test_dag_id).update({'dag_id': 'example_bash_operator'})
         self.session.commit()
@@ -1370,20 +1392,28 @@ def test_xcom_success_for_all_dag_user(self):
     def test_run_success(self):
         self.logout()
         self.login()
-        url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
-               'ignore_ti_state=true&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="runme_0",
+            dag_id="example_bash_operator",
+            ignore_all_deps="false",
+            ignore_ti_state="true",
+            execution_date=self.default_date,
+        )
+        resp = self.client.post('run', data=form)
         self.check_content_in_response('', resp, resp_code=302)
 
     def test_run_success_for_all_dag_user(self):
         self.logout()
         self.login(username='all_dag_user',
                    password='all_dag_user')
-        url = ('run?task_id=runme_0&dag_id=example_bash_operator&ignore_all_deps=false&'
-               'ignore_ti_state=true&execution_date={}'
-               .format(self.percent_encode(self.default_date)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="runme_0",
+            dag_id="example_bash_operator",
+            ignore_all_deps="false",
+            ignore_ti_state="true",
+            execution_date=self.default_date
+        )
+        resp = self.client.post('run', data=form)
         self.check_content_in_response('', resp, resp_code=302)
 
     def test_blocked_success(self):
@@ -1405,10 +1435,16 @@ def test_blocked_success_for_all_dag_user(self):
     def test_failed_success(self):
         self.logout()
         self.login()
-        url = ('failed?task_id=run_this_last&dag_id=example_bash_operator&'
-               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.default_date)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="run_this_last",
+            dag_id="example_bash_operator",
+            execution_date=self.default_date,
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+        )
+        resp = self.client.post('failed', data=form)
         self.check_content_in_response('Redirecting', resp, 302)
 
     def test_duration_success(self):
@@ -1469,7 +1505,7 @@ def test_paused_success(self):
     def test_refresh_success(self):
         self.logout()
         self.login()
-        resp = self.client.get('refresh?dag_id=example_bash_operator')
+        resp = self.client.post('refresh?dag_id=example_bash_operator')
         self.check_content_in_response('', resp, resp_code=302)
 
     def test_gantt_success(self):
@@ -1493,10 +1529,16 @@ def test_success_fail_for_read_only_role(self):
         self.login(username='dag_read_only',
                    password='dag_read_only')
 
-        url = ('success?task_id=run_this_last&dag_id=example_bash_operator&'
-               'execution_date={}&upstream=false&downstream=false&future=false&past=false'
-               .format(self.percent_encode(self.default_date)))
-        resp = self.client.get(url)
+        form = dict(
+            task_id="run_this_last",
+            dag_id="example_bash_operator",
+            execution_date=self.default_date,
+            upstream="false",
+            downstream="false",
+            future="false",
+            past="false",
+        )
+        resp = self.client.post('success', data=form)
         self.check_content_not_in_response('Wait a minute', resp, resp_code=302)
 
     def test_tree_success_for_read_only_role(self):
@@ -1577,7 +1619,7 @@ def setUp(self):
     def test_trigger_dag_button_normal_exist(self):
         resp = self.client.get('/', follow_redirects=True)
         self.assertIn('/trigger?dag_id=example_bash_operator', resp.data.decode('utf-8'))
-        self.assertIn("return confirmDeleteDag('example_bash_operator')", resp.data.decode('utf-8'))
+        self.assertIn("return confirmDeleteDag(this, 'example_bash_operator')", resp.data.decode('utf-8'))
 
     @unittest.skipIf('mysql' in conf.conf.get('core', 'sql_alchemy_conn'),
                      "flaky when run on mysql")
@@ -1589,7 +1631,7 @@ def test_trigger_dag_button(self):
         self.session.query(DR).delete()
         self.session.commit()
 
-        self.client.get('trigger?dag_id={}'.format(test_dag_id))
+        self.client.post('trigger?dag_id={}'.format(test_dag_id))
 
         run = self.session.query(DR).filter(DR.dag_id == test_dag_id).first()
         self.assertIsNotNone(run)

From 45270cd3cfbec9d6f61794c4ddd647d6237d8603 Mon Sep 17 00:00:00 2001
From: Kevin Pullin <kevin.pullin@gmail.com>
Date: Fri, 5 Apr 2019 12:22:39 -0700
Subject: [PATCH 794/808] [AIRFLOW-4248] Fix 'FileExistsError' makedirs race in
 file_processor_handler (#5047)

---
 airflow/utils/log/file_processor_handler.py | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/airflow/utils/log/file_processor_handler.py b/airflow/utils/log/file_processor_handler.py
index fb7b2fad32013..098b018d47275 100644
--- a/airflow/utils/log/file_processor_handler.py
+++ b/airflow/utils/log/file_processor_handler.py
@@ -17,7 +17,6 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import errno
 import logging
 import os
 
@@ -49,9 +48,9 @@ def __init__(self, base_log_folder, filename_template):
         if not os.path.exists(self._get_log_directory()):
             try:
                 os.makedirs(self._get_log_directory())
-            except OSError as e:
+            except OSError:
                 # only ignore case where the directory already exist
-                if e.errno != errno.EEXIST:
+                if not os.path.isdir(self._get_log_directory()):
                     raise
 
                 logging.warning("%s already exists", self._get_log_directory())
@@ -138,7 +137,11 @@ def _init_file(self, filename):
         directory = os.path.dirname(full_path)
 
         if not os.path.exists(directory):
-            os.makedirs(directory)
+            try:
+                os.makedirs(directory)
+            except OSError:
+                if not os.path.isdir(directory):
+                    raise
 
         if not os.path.exists(full_path):
             open(full_path, "a").close()

From be20160f88d8d4ea858d989cd0868004eb9e65de Mon Sep 17 00:00:00 2001
From: Philippe Gagnon <12717218+pgagnon@users.noreply.github.com>
Date: Fri, 5 Apr 2019 17:08:25 -0400
Subject: [PATCH 795/808] [AIRFLOW-3274] Add run_as_user and fs_group options
 for Kubernetes (#4648)

---
 airflow/config_templates/default_airflow.cfg  | 12 ++++
 .../example_kubernetes_executor_config.py     | 13 ++++
 .../contrib/executors/kubernetes_executor.py  |  4 ++
 .../pod_request_factory.py                    |  1 +
 .../kubernetes/worker_configuration.py        | 19 ++++--
 .../operators/kubernetes_pod_operator.py      |  3 +
 .../executors/test_kubernetes_executor.py     |  3 +-
 .../test_pod_request_factory.py               | 12 +++-
 .../minikube/test_kubernetes_pod_operator.py  | 63 +++++++++++++++++++
 9 files changed, 121 insertions(+), 9 deletions(-)

diff --git a/airflow/config_templates/default_airflow.cfg b/airflow/config_templates/default_airflow.cfg
index b83edefb4cfac..2f990131367b5 100644
--- a/airflow/config_templates/default_airflow.cfg
+++ b/airflow/config_templates/default_airflow.cfg
@@ -734,6 +734,18 @@ affinity =
 #   https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.12/#toleration-v1-core
 tolerations =
 
+# Worker pods security context options
+# See:
+#   https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
+
+# Specifies the uid to run the first process of the worker pods containers as
+run_as_user =
+
+# Specifies a gid to associate with all containers in the worker pods
+# if using a git_ssh_key_secret_name use an fs_group
+# that allows for the key to be read, e.g. 65533
+fs_group =
+
 [kubernetes_node_selectors]
 # The Key-value pairs to be given to worker pods.
 # The worker pods will be scheduled to the nodes of the specified key-value pairs.
diff --git a/airflow/contrib/example_dags/example_kubernetes_executor_config.py b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
index 1b194499b28ec..1316b21803921 100644
--- a/airflow/contrib/example_dags/example_kubernetes_executor_config.py
+++ b/airflow/contrib/example_dags/example_kubernetes_executor_config.py
@@ -73,4 +73,17 @@ def test_volume_mount():
     }
 )
 
+# Test that we can run tasks as a normal user
+third_task = PythonOperator(
+    task_id="non_root_task", python_callable=print_stuff, dag=dag,
+    executor_config={
+        "KubernetesExecutor": {
+            "securityContext": {
+                "runAsUser": 1000
+            }
+        }
+    }
+)
+
 start_task.set_downstream(second_task)
+second_task.set_downstream(third_task)
diff --git a/airflow/contrib/executors/kubernetes_executor.py b/airflow/contrib/executors/kubernetes_executor.py
index 83babdafa44a2..ebd22076e078c 100644
--- a/airflow/contrib/executors/kubernetes_executor.py
+++ b/airflow/contrib/executors/kubernetes_executor.py
@@ -155,6 +155,10 @@ def __init__(self):
         # this will set to True if so
         self.dags_in_image = conf.getboolean(self.kubernetes_section, 'dags_in_image')
 
+        # Run as user for pod security context
+        self.worker_run_as_user = conf.get(self.kubernetes_section, 'run_as_user')
+        self.worker_fs_group = conf.get(self.kubernetes_section, 'fs_group')
+
         # NOTE: `git_repo` and `git_branch` must be specified together as a pair
         # The http URL of the git repository to clone from
         self.git_repo = conf.get(self.kubernetes_section, 'git_repo')
diff --git a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
index afcbf93525257..3aea85df3ea18 100644
--- a/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
+++ b/airflow/contrib/kubernetes/kubernetes_request_factory/pod_request_factory.py
@@ -130,4 +130,5 @@ def create(self, pod):
         self.extract_affinity(pod, req)
         self.extract_hostnetwork(pod, req)
         self.extract_tolerations(pod, req)
+        self.extract_security_context(pod, req)
         return req
diff --git a/airflow/contrib/kubernetes/worker_configuration.py b/airflow/contrib/kubernetes/worker_configuration.py
index 60128f1479e81..b9896b5b886d9 100644
--- a/airflow/contrib/kubernetes/worker_configuration.py
+++ b/airflow/contrib/kubernetes/worker_configuration.py
@@ -187,12 +187,19 @@ def _get_image_pull_secrets(self):
 
     def _get_security_context(self):
         """Defines the security context"""
-        if self.kube_config.git_ssh_key_secret_name:
-            return {
-                'fsGroup': 65533  # to make SSH key readable
-            }
-        else:
-            return None
+        security_context = {}
+
+        if self.kube_config.worker_run_as_user:
+            security_context['runAsUser'] = self.kube_config.worker_run_as_user
+
+        if self.kube_config.worker_fs_group:
+            security_context['fsGroup'] = self.kube_config.worker_fs_group
+
+        # set fs_group to 65533 if not explicitly specified and using git ssh keypair auth
+        if self.kube_config.git_ssh_key_secret_name and security_context.get('fsGroup') is None:
+            security_context['fsGroup'] = 65533
+
+        return security_context
 
     def _get_volumes_and_mounts(self):
         def _construct_volume(name, claim, host):
diff --git a/airflow/contrib/operators/kubernetes_pod_operator.py b/airflow/contrib/operators/kubernetes_pod_operator.py
index 1e6eef6203810..fcbdcfae55328 100644
--- a/airflow/contrib/operators/kubernetes_pod_operator.py
+++ b/airflow/contrib/operators/kubernetes_pod_operator.py
@@ -124,6 +124,7 @@ def execute(self, context):
             pod.hostnetwork = self.hostnetwork
             pod.tolerations = self.tolerations
             pod.configmaps = self.configmaps
+            pod.security_context = self.security_context
 
             launcher = pod_launcher.PodLauncher(kube_client=client,
                                                 extract_xcom=self.xcom_push)
@@ -174,6 +175,7 @@ def __init__(self,
                  hostnetwork=False,
                  tolerations=None,
                  configmaps=None,
+                 security_context=None,
                  *args,
                  **kwargs):
         super(KubernetesPodOperator, self).__init__(*args, **kwargs)
@@ -204,3 +206,4 @@ def __init__(self,
         self.hostnetwork = hostnetwork
         self.tolerations = tolerations or []
         self.configmaps = configmaps or []
+        self.security_context = security_context or {}
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 9e969f390e896..5ab2b3527a975 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -399,6 +399,7 @@ def test_make_pod_git_sync_ssh_without_known_hosts(self):
         self.kube_config.dags_volume_claim = None
         self.kube_config.dags_volume_host = None
         self.kube_config.dags_in_image = None
+        self.kube_config.worker_fs_group = None
 
         worker_config = WorkerConfiguration(self.kube_config)
         kube_executor_config = KubernetesExecutorConfig(annotations=[],
@@ -417,7 +418,7 @@ def test_make_pod_git_sync_ssh_without_known_hosts(self):
                                     None)
         self.assertTrue(git_ssh_key_file)
         self.assertTrue(volume_mount_ssh_key)
-        self.assertEqual({'fsGroup': 65533}, pod.security_context)
+        self.assertEqual(65533, pod.security_context['fsGroup'])
         self.assertEqual(git_ssh_key_file,
                          volume_mount_ssh_key,
                          'The location where the git ssh secret is mounted'
diff --git a/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py b/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py
index ff835ed0c9ec4..9492ec0e25fe8 100644
--- a/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py
+++ b/tests/contrib/kubernetes/kubernetes_request_factory/test_pod_request_factory.py
@@ -55,7 +55,11 @@ def setUp(self):
                 Secret('volume', '/etc/foo', 'secret_b'),
                 # This should produce a single secret mounted in env
                 Secret('env', 'TARGET', 'secret_b', 'source_b'),
-            ]
+            ],
+            security_context={
+                'runAsUser': 1000,
+                'fsGroup': 2000,
+            }
         )
         self.maxDiff = None
         self.expected = {
@@ -120,7 +124,11 @@ def setUp(self):
                     {'name': 'pull_secret_a'},
                     {'name': 'pull_secret_b'}
                 ],
-                'affinity': {}
+                'affinity': {},
+                'securityContext': {
+                    'runAsUser': 1000,
+                    'fsGroup': 2000,
+                },
             }
         }
 
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index eeb8328ee18f6..1934c58cfe026 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -265,6 +265,69 @@ def test_volume_mount():
             k.execute(None)
             mock_logger.info.assert_any_call(b"retrieved from mount\n")
 
+    @staticmethod
+    def test_run_as_user_root():
+        security_context = {
+            'securityContext': {
+                'runAsUser': 0,
+            }
+        }
+
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo", "10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            security_context=security_context,
+            executor_config={'KubernetesExecutor': {'securityContext': security_context}}
+        )
+        k.execute(None)
+
+    @staticmethod
+    def test_run_as_user_non_root():
+        security_context = {
+            'securityContext': {
+                'runAsUser': 1000,
+            }
+        }
+
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo", "10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            security_context=security_context,
+            executor_config={'KubernetesExecutor': {'securityContext': security_context}}
+        )
+        k.execute(None)
+
+    @staticmethod
+    def test_fs_group():
+        security_context = {
+            'securityContext': {
+                'fsGroup': 1000,
+            }
+        }
+
+        k = KubernetesPodOperator(
+            namespace='default',
+            image="ubuntu:16.04",
+            cmds=["bash", "-cx"],
+            arguments=["echo", "10"],
+            labels={"foo": "bar"},
+            name="test",
+            task_id="task",
+            security_context=security_context,
+            executor_config={'KubernetesExecutor': {'securityContext': security_context}}
+        )
+        k.execute(None)
+
     def test_faulty_image(self):
         bad_image_name = "foobar"
         k = KubernetesPodOperator(

From 9988fdb1bd7b97e0e23396ba3fa373af419da7d9 Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Fri, 5 Apr 2019 22:37:55 +0100
Subject: [PATCH 796/808] Revert "[AIRFLOW-4122] Deprecate chain function
 (#4940)"

This reverts commit c1a23e62f4c92b64208de4029497af5df48bff69.

This is still useful for larger/more complex DAGs
---
 UPDATING.md                                            |  5 -----
 airflow/example_dags/example_short_circuit_operator.py | 10 +++++-----
 airflow/utils/helpers.py                               |  2 --
 3 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/UPDATING.md b/UPDATING.md
index 3a0667f9927e7..bf48ee1a708f3 100644
--- a/UPDATING.md
+++ b/UPDATING.md
@@ -117,11 +117,6 @@ if foo is None:
 
 This changes the behaviour if you previously explicitly provided `None` as a default value. If your code expects a `KeyError` to be thrown, then don't pass the `default_var` argument.
 
-### Deprecation chain function
-
-Bit operation like `>>` or `<<` are recommended for setting the dependency, which is easier to explain.
-The `airflow.utlis.helpers.chain` function is deprecated and will be removed in Airflow 2.0.
-
 ### Removal of `airflow_home` config setting
 
 There were previously two ways of specifying the Airflow "home" directory
diff --git a/airflow/example_dags/example_short_circuit_operator.py b/airflow/example_dags/example_short_circuit_operator.py
index 161af19f2b333..1093dab616779 100644
--- a/airflow/example_dags/example_short_circuit_operator.py
+++ b/airflow/example_dags/example_short_circuit_operator.py
@@ -17,7 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
-import airflow.utils.dates
+import airflow.utils.helpers
 from airflow.models import DAG
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.operators.python_operator import ShortCircuitOperator
@@ -41,8 +41,8 @@
     dag=dag,
 )
 
-true_1, true_2 = [DummyOperator(task_id='true_' + str(i), dag=dag) for i in [1, 2]]
-false_1, false_2 = [DummyOperator(task_id='false_' + str(i), dag=dag) for i in [1, 2]]
+ds_true = [DummyOperator(task_id='true_' + str(i), dag=dag) for i in [1, 2]]
+ds_false = [DummyOperator(task_id='false_' + str(i), dag=dag) for i in [1, 2]]
 
-cond_true >> true_1 >> true_2
-cond_false >> false_1 >> false_2
+airflow.utils.helpers.chain(cond_true, *ds_true)
+airflow.utils.helpers.chain(cond_false, *ds_false)
diff --git a/airflow/utils/helpers.py b/airflow/utils/helpers.py
index 8e854009774f3..06229079338b9 100644
--- a/airflow/utils/helpers.py
+++ b/airflow/utils/helpers.py
@@ -38,7 +38,6 @@
 import signal
 
 from jinja2 import Template
-from zope.deprecation import deprecate
 
 from airflow import configuration
 from airflow.exceptions import AirflowException
@@ -157,7 +156,6 @@ def as_flattened_list(iterable):
     return [e for i in iterable for e in i]
 
 
-@deprecate("chain will be removed in Airflow 2.0")
 def chain(*tasks):
     """
     Given a number of tasks, builds a dependency chain.

From d949340429fc2917e24f977a7842c8a6c9aa5605 Mon Sep 17 00:00:00 2001
From: Nathaniel Ritholtz <nritholtz@gmail.com>
Date: Fri, 5 Apr 2019 17:40:54 -0400
Subject: [PATCH 797/808] [AIRFLOW-4069] Add Opsgenie Alert Hook and Operator
 (#4903)

---
 airflow/contrib/hooks/opsgenie_alert_hook.py  |  88 +++++++++++
 .../operators/opsgenie_alert_operator.py      | 131 +++++++++++++++++
 airflow/utils/db.py                           |   4 +
 .../contrib/hooks/test_opsgenie_alert_hook.py | 137 ++++++++++++++++++
 .../operators/test_opsgenie_alert_operator.py | 124 ++++++++++++++++
 5 files changed, 484 insertions(+)
 create mode 100644 airflow/contrib/hooks/opsgenie_alert_hook.py
 create mode 100644 airflow/contrib/operators/opsgenie_alert_operator.py
 create mode 100644 tests/contrib/hooks/test_opsgenie_alert_hook.py
 create mode 100644 tests/contrib/operators/test_opsgenie_alert_operator.py

diff --git a/airflow/contrib/hooks/opsgenie_alert_hook.py b/airflow/contrib/hooks/opsgenie_alert_hook.py
new file mode 100644
index 0000000000000..d576c08c23982
--- /dev/null
+++ b/airflow/contrib/hooks/opsgenie_alert_hook.py
@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import json
+
+import requests
+
+from airflow.hooks.http_hook import HttpHook
+from airflow import AirflowException
+
+
+class OpsgenieAlertHook(HttpHook):
+    """
+    This hook allows you to post alerts to Opsgenie.
+    Accepts a connection that has an Opsgenie API key as the connection's password.
+    This hook sets the domain to conn_id.host, and if not set will default
+    to ``https://api.opsgenie.com``.
+
+    Each Opsgenie API key can be pre-configured to a team integration.
+    You can override these defaults in this hook.
+
+    :param opsgenie_conn_id: The name of the Opsgenie connection to use
+    :type opsgenie_conn_id: str
+
+    """
+    def __init__(self,
+                 opsgenie_conn_id='opsgenie_default',
+                 *args,
+                 **kwargs
+                 ):
+        super(OpsgenieAlertHook, self).__init__(http_conn_id=opsgenie_conn_id, *args, **kwargs)
+
+    def _get_api_key(self):
+        """
+        Get Opsgenie api_key for creating alert
+        """
+        conn = self.get_connection(self.http_conn_id)
+        api_key = conn.password
+        if not api_key:
+            raise AirflowException('Opsgenie API Key is required for this hook, '
+                                   'please check your conn_id configuration.')
+        return api_key
+
+    def get_conn(self, headers=None):
+        """
+        Overwrite HttpHook get_conn because this hook just needs base_url
+        and headers, and does not need generic params
+
+        :param headers: additional headers to be passed through as a dictionary
+        :type headers: dict
+        """
+        conn = self.get_connection(self.http_conn_id)
+        self.base_url = conn.host if conn.host else 'https://api.opsgenie.com'
+        session = requests.Session()
+        if headers:
+            session.headers.update(headers)
+        return session
+
+    def execute(self, payload={}):
+        """
+        Execute the Opsgenie Alert call
+
+        :param payload: Opsgenie API Create Alert payload values
+            See https://docs.opsgenie.com/docs/alert-api#section-create-alert
+        :type payload: dict
+        """
+        api_key = self._get_api_key()
+        return self.run(endpoint='v2/alerts',
+                        data=json.dumps(payload),
+                        headers={'Content-Type': 'application/json',
+                                 'Authorization': 'GenieKey %s' % api_key})
diff --git a/airflow/contrib/operators/opsgenie_alert_operator.py b/airflow/contrib/operators/opsgenie_alert_operator.py
new file mode 100644
index 0000000000000..c46d234932d0d
--- /dev/null
+++ b/airflow/contrib/operators/opsgenie_alert_operator.py
@@ -0,0 +1,131 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+from airflow.contrib.hooks.opsgenie_alert_hook import OpsgenieAlertHook
+from airflow.models import BaseOperator
+from airflow.utils.decorators import apply_defaults
+
+
+class OpsgenieAlertOperator(BaseOperator):
+    """
+    This operator allows you to post alerts to Opsgenie.
+    Accepts a connection that has an Opsgenie API key as the connection's password.
+    This operator sets the domain to conn_id.host, and if not set will default
+    to ``https://api.opsgenie.com``.
+
+    Each Opsgenie API key can be pre-configured to a team integration.
+    You can override these defaults in this operator.
+
+    :param opsgenie_conn_id: The name of the Opsgenie connection to use
+    :type opsgenie_conn_id: str
+    :param message: The Message of the Opsgenie alert (templated)
+    :type message: str
+    :param alias: Client-defined identifier of the alert (templated)
+    :type alias: str
+    :param description: Description field of the alert (templated)
+    :type description: str
+    :param responders: Teams, users, escalations and schedules that
+        the alert will be routed to send notifications.
+    :type responders: list[dict]
+    :param visibleTo: Teams and users that the alert will become visible
+        to without sending any notification.
+    :type visibleTo: list[dict]
+    :param actions: Custom actions that will be available for the alert.
+    :type actions: list[str]
+    :param tags: Tags of the alert.
+    :type tags: list[str]
+    :param details: Map of key-value pairs to use as custom properties of the alert.
+    :type details: dict
+    :param entity: Entity field of the alert that is
+        generally used to specify which domain alert is related to. (templated)
+    :type entity: str
+    :param source: Source field of the alert. Default value is
+        IP address of the incoming request.
+    :type source: str
+    :param priority: Priority level of the alert. Default value is P3. (templated)
+    :type priority: str
+    :param user: Display name of the request owner.
+    :type user: str
+    :param note: Additional note that will be added while creating the alert. (templated)
+    :type note: str
+    """
+    template_fields = ('message', 'alias', 'description', 'entity', 'priority', 'note')
+
+    @apply_defaults
+    def __init__(self,
+                 message,
+                 opsgenie_conn_id='opsgenie_default',
+                 alias=None,
+                 description=None,
+                 responders=None,
+                 visibleTo=None,
+                 actions=None,
+                 tags=None,
+                 details=None,
+                 entity=None,
+                 source=None,
+                 priority=None,
+                 user=None,
+                 note=None,
+                 *args,
+                 **kwargs
+                 ):
+        super(OpsgenieAlertOperator, self).__init__(*args, **kwargs)
+
+        self.message = message
+        self.opsgenie_conn_id = opsgenie_conn_id
+        self.alias = alias
+        self.description = description
+        self.responders = responders
+        self.visibleTo = visibleTo
+        self.actions = actions
+        self.tags = tags
+        self.details = details
+        self.entity = entity
+        self.source = source
+        self.priority = priority
+        self.user = user
+        self.note = note
+        self.hook = None
+
+    def _build_opsgenie_payload(self):
+        """
+        Construct the Opsgenie JSON payload. All relevant parameters are combined here
+        to a valid Opsgenie JSON payload.
+
+        :return: Opsgenie payload (dict) to send
+        """
+        payload = {}
+
+        for key in [
+            "message", "alias", "description", "responders",
+            "visibleTo", "actions", "tags", "details", "entity",
+            "source", "priority", "user", "note"
+        ]:
+            val = getattr(self, key)
+            if val:
+                payload[key] = val
+        return payload
+
+    def execute(self, context):
+        """
+        Call the OpsgenieAlertHook to post message
+        """
+        self.hook = OpsgenieAlertHook(self.opsgenie_conn_id)
+        self.hook.execute(self._build_opsgenie_payload())
diff --git a/airflow/utils/db.py b/airflow/utils/db.py
index b340079c88455..da3cc5c36e9b4 100644
--- a/airflow/utils/db.py
+++ b/airflow/utils/db.py
@@ -292,6 +292,10 @@ def initdb(rbac=False):
         Connection(
             conn_id='dingding_default', conn_type='http',
             host='', password=''))
+    merge_conn(
+        Connection(
+            conn_id='opsgenie_default', conn_type='http',
+            host='', password=''))
 
     # Known event types
     KET = models.KnownEventType
diff --git a/tests/contrib/hooks/test_opsgenie_alert_hook.py b/tests/contrib/hooks/test_opsgenie_alert_hook.py
new file mode 100644
index 0000000000000..be6bdf6fb9d8c
--- /dev/null
+++ b/tests/contrib/hooks/test_opsgenie_alert_hook.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import unittest
+import requests_mock
+import json
+
+from airflow import configuration
+from airflow.models.connection import Connection
+from airflow.utils import db
+from airflow.contrib.hooks.opsgenie_alert_hook import OpsgenieAlertHook
+from airflow import AirflowException
+
+
+class TestOpsgenieAlertHook(unittest.TestCase):
+    conn_id = 'opsgenie_conn_id_test'
+    opsgenie_alert_endpoint = 'https://api.opsgenie.com/v2/alerts'
+    _payload = {
+        'message': 'An example alert message',
+        'alias': 'Life is too short for no alias',
+        'description': 'Every alert needs a description',
+        'responders': [
+            {'id': '4513b7ea-3b91-438f-b7e4-e3e54af9147c', 'type': 'team'},
+            {'name': 'NOC', 'type': 'team'},
+            {'id': 'bb4d9938-c3c2-455d-aaab-727aa701c0d8', 'type': 'user'},
+            {'username': 'trinity@opsgenie.com', 'type': 'user'},
+            {'id': 'aee8a0de-c80f-4515-a232-501c0bc9d715', 'type': 'escalation'},
+            {'name': 'Nightwatch Escalation', 'type': 'escalation'},
+            {'id': '80564037-1984-4f38-b98e-8a1f662df552', 'type': 'schedule'},
+            {'name': 'First Responders Schedule', 'type': 'schedule'}
+        ],
+        'visibleTo': [
+            {'id': '4513b7ea-3b91-438f-b7e4-e3e54af9147c', 'type': 'team'},
+            {'name': 'rocket_team', 'type': 'team'},
+            {'id': 'bb4d9938-c3c2-455d-aaab-727aa701c0d8', 'type': 'user'},
+            {'username': 'trinity@opsgenie.com', 'type': 'user'}
+        ],
+        'actions': ['Restart', 'AnExampleAction'],
+        'tags': ['OverwriteQuietHours', 'Critical'],
+        'details': {'key1': 'value1', 'key2': 'value2'},
+        'entity': 'An example entity',
+        'source': 'Airflow',
+        'priority': 'P1',
+        'user': 'Jesse',
+        'note': 'Write this down'
+    }
+    _mock_success_response_body = {
+        "result": "Request will be processed",
+        "took": 0.302,
+        "requestId": "43a29c5c-3dbf-4fa4-9c26-f4f71023e120"
+    }
+
+    def setUp(self):
+        configuration.load_test_config()
+        db.merge_conn(
+            Connection(
+                conn_id=self.conn_id,
+                host='https://api.opsgenie.com/',
+                password='eb243592-faa2-4ba2-a551q-1afdf565c889'
+            )
+        )
+
+    def test_get_api_key(self):
+        hook = OpsgenieAlertHook(opsgenie_conn_id=self.conn_id)
+        api_key = hook._get_api_key()
+        self.assertEqual('eb243592-faa2-4ba2-a551q-1afdf565c889', api_key)
+
+    def test_get_conn_defaults_host(self):
+        hook = OpsgenieAlertHook()
+        hook.get_conn()
+        self.assertEqual('https://api.opsgenie.com', hook.base_url)
+
+    @requests_mock.mock()
+    def test_call_with_success(self, m):
+        hook = OpsgenieAlertHook(opsgenie_conn_id=self.conn_id)
+        m.post(
+            self.opsgenie_alert_endpoint,
+            status_code=202,
+            json=self._mock_success_response_body
+        )
+        resp = hook.execute(payload=self._payload)
+        self.assertEqual(resp.status_code, 202)
+        self.assertEqual(resp.json(), self._mock_success_response_body)
+
+    @requests_mock.mock()
+    def test_api_key_set(self, m):
+        hook = OpsgenieAlertHook(opsgenie_conn_id=self.conn_id)
+        m.post(
+            self.opsgenie_alert_endpoint,
+            status_code=202,
+            json=self._mock_success_response_body
+        )
+        resp = hook.execute(payload=self._payload)
+        self.assertEqual(resp.request.headers.get('Authorization'),
+                         'GenieKey eb243592-faa2-4ba2-a551q-1afdf565c889')
+
+    @requests_mock.mock()
+    def test_api_key_not_set(self, m):
+        hook = OpsgenieAlertHook()
+        m.post(
+            self.opsgenie_alert_endpoint,
+            status_code=202,
+            json=self._mock_success_response_body
+        )
+        with self.assertRaises(AirflowException):
+            hook.execute(payload=self._payload)
+
+    @requests_mock.mock()
+    def test_payload_set(self, m):
+        hook = OpsgenieAlertHook(opsgenie_conn_id=self.conn_id)
+        m.post(
+            self.opsgenie_alert_endpoint,
+            status_code=202,
+            json=self._mock_success_response_body
+        )
+        resp = hook.execute(payload=self._payload)
+        self.assertEqual(json.loads(resp.request.body), self._payload)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/tests/contrib/operators/test_opsgenie_alert_operator.py b/tests/contrib/operators/test_opsgenie_alert_operator.py
new file mode 100644
index 0000000000000..1b4467bc5a523
--- /dev/null
+++ b/tests/contrib/operators/test_opsgenie_alert_operator.py
@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+
+import unittest
+
+from airflow import DAG, configuration
+
+from airflow.contrib.operators.opsgenie_alert_operator import OpsgenieAlertOperator
+from airflow.utils import timezone
+
+DEFAULT_DATE = timezone.datetime(2017, 1, 1)
+
+
+class TestOpsgenieAlertOperator(unittest.TestCase):
+    _config = {
+        'message': 'An example alert message',
+        'alias': 'Life is too short for no alias',
+        'description': 'Every alert needs a description',
+        'responders': [
+            {'id': '4513b7ea-3b91-438f-b7e4-e3e54af9147c', 'type': 'team'},
+            {'name': 'NOC', 'type': 'team'},
+            {'id': 'bb4d9938-c3c2-455d-aaab-727aa701c0d8', 'type': 'user'},
+            {'username': 'trinity@opsgenie.com', 'type': 'user'},
+            {'id': 'aee8a0de-c80f-4515-a232-501c0bc9d715', 'type': 'escalation'},
+            {'name': 'Nightwatch Escalation', 'type': 'escalation'},
+            {'id': '80564037-1984-4f38-b98e-8a1f662df552', 'type': 'schedule'},
+            {'name': 'First Responders Schedule', 'type': 'schedule'}
+        ],
+        'visibleTo': [
+            {'id': '4513b7ea-3b91-438f-b7e4-e3e54af9147c', 'type': 'team'},
+            {'name': 'rocket_team', 'type': 'team'},
+            {'id': 'bb4d9938-c3c2-455d-aaab-727aa701c0d8', 'type': 'user'},
+            {'username': 'trinity@opsgenie.com', 'type': 'user'}
+        ],
+        'actions': ['Restart', 'AnExampleAction'],
+        'tags': ['OverwriteQuietHours', 'Critical'],
+        'details': {'key1': 'value1', 'key2': 'value2'},
+        'entity': 'An example entity',
+        'source': 'Airflow',
+        'priority': 'P1',
+        'user': 'Jesse',
+        'note': 'Write this down'
+    }
+
+    expected_payload_dict = {
+        'message': _config['message'],
+        'alias': _config['alias'],
+        'description': _config['description'],
+        'responders': _config['responders'],
+        'visibleTo': _config['visibleTo'],
+        'actions': _config['actions'],
+        'tags': _config['tags'],
+        'details': _config['details'],
+        'entity': _config['entity'],
+        'source': _config['source'],
+        'priority': _config['priority'],
+        'user': _config['user'],
+        'note': _config['note']
+    }
+
+    def setUp(self):
+        configuration.load_test_config()
+        args = {
+            'owner': 'airflow',
+            'start_date': DEFAULT_DATE
+        }
+        self.dag = DAG('test_dag_id', default_args=args)
+
+    def test_build_opsgenie_payload(self):
+        # Given / When
+        operator = OpsgenieAlertOperator(
+            task_id='opsgenie_alert_job',
+            dag=self.dag,
+            **self._config
+        )
+
+        payload = operator._build_opsgenie_payload()
+
+        # Then
+        self.assertEqual(self.expected_payload_dict, payload)
+
+    def test_properties(self):
+        # Given / When
+        operator = OpsgenieAlertOperator(
+            task_id='opsgenie_alert_job',
+            dag=self.dag,
+            **self._config
+        )
+
+        self.assertEqual('opsgenie_default', operator.opsgenie_conn_id)
+        self.assertEqual(self._config['message'], operator.message)
+        self.assertEqual(self._config['alias'], operator.alias)
+        self.assertEqual(self._config['description'], operator.description)
+        self.assertEqual(self._config['responders'], operator.responders)
+        self.assertEqual(self._config['visibleTo'], operator.visibleTo)
+        self.assertEqual(self._config['actions'], operator.actions)
+        self.assertEqual(self._config['tags'], operator.tags)
+        self.assertEqual(self._config['details'], operator.details)
+        self.assertEqual(self._config['entity'], operator.entity)
+        self.assertEqual(self._config['source'], operator.source)
+        self.assertEqual(self._config['priority'], operator.priority)
+        self.assertEqual(self._config['user'], operator.user)
+        self.assertEqual(self._config['note'], operator.note)
+
+
+if __name__ == '__main__':
+    unittest.main()

From 96fbc6141c1dd133741ef674dbd9e580a5ee81a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 29 Mar 2019 23:30:48 +0100
Subject: [PATCH 798/808] [AIRFLOW-3996] Add view source link to included
 fragments

---
 docs/conf.py                          |   6 +
 docs/exts/__init__.py                 |  21 +++
 docs/exts/exampleinclude.py           | 211 ++++++++++++++++++++++++++
 docs/exts/removemarktransform.py      |  74 +++++++++
 docs/howto/operator/bash.rst          |   4 +-
 docs/howto/operator/gcp/bigtable.rst  |  14 +-
 docs/howto/operator/gcp/compute.rst   |  46 +++---
 docs/howto/operator/gcp/function.rst  |  22 +--
 docs/howto/operator/gcp/gcs.rst       |  14 +-
 docs/howto/operator/gcp/spanner.rst   |  32 ++--
 docs/howto/operator/gcp/sql.rst       |  82 +++++-----
 docs/howto/operator/gcp/transfer.rst  |  60 ++++----
 docs/howto/operator/gcp/translate.rst |   6 +-
 docs/howto/operator/gcp/vision.rst    | 166 ++++++++++----------
 docs/howto/operator/python.rst        |   4 +-
 docs/templates/layout.html            |  62 ++++++++
 16 files changed, 599 insertions(+), 225 deletions(-)
 create mode 100644 docs/exts/__init__.py
 create mode 100644 docs/exts/exampleinclude.py
 create mode 100644 docs/exts/removemarktransform.py

diff --git a/docs/conf.py b/docs/conf.py
index b73e1cd15e609..ef8098b5a228d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -98,6 +98,8 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 
+sys.path.append(os.path.join(os.path.dirname(__file__), 'exts'))
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -114,6 +116,7 @@
     'sphinxcontrib.httpdomain',
     'sphinx.ext.intersphinx',
     'autoapi.extension',
+    'exampleinclude',
 ]
 
 autodoc_default_flags = ['show-inheritance', 'members']
@@ -424,3 +427,6 @@
 # Relative path to output the AutoAPI files into. This can also be used to place the generated documentation
 # anywhere in your documentation hierarchy.
 autoapi_root = '_api'
+
+# -- Options for examole include ------------------------------------------
+exampleinclude_sourceroot = os.path.abspath('..')
diff --git a/docs/exts/__init__.py b/docs/exts/__init__.py
new file mode 100644
index 0000000000000..645848f26c3b3
--- /dev/null
+++ b/docs/exts/__init__.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+#
+# flake8: noqa
+# Disable Flake8 because of all the sphinx imports
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
diff --git a/docs/exts/exampleinclude.py b/docs/exts/exampleinclude.py
new file mode 100644
index 0000000000000..79eadd641da82
--- /dev/null
+++ b/docs/exts/exampleinclude.py
@@ -0,0 +1,211 @@
+# -*- coding: utf-8 -*-
+#
+# flake8: noqa
+# Disable Flake8 because of all the sphinx imports
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from os import path
+
+from docutils import nodes
+from docutils.parsers.rst import directives
+from six import text_type
+from sphinx import addnodes
+from sphinx.directives.code import LiteralIncludeReader
+from sphinx.locale import _
+from sphinx.pycode import ModuleAnalyzer
+from sphinx.util import logging
+from sphinx.util import parselinenos
+from sphinx.util.docutils import SphinxDirective
+from sphinx.util.nodes import set_source_info
+
+logger = logging.getLogger(__name__)
+
+
+class example_header(nodes.reference, nodes.FixedTextElement):
+    pass
+
+
+class ExampleInclude(SphinxDirective):
+    """
+    Like ``.. literalinclude:: ``, but it does not support caption option.
+    Adds a header with a reference to  the full source code
+
+    Based on:
+    https://raw.githubusercontent.com/sphinx-doc/sphinx/v1.8.3/sphinx/directives/code.py
+    """
+
+    has_content = False
+    required_arguments = 1
+    optional_arguments = 0
+    final_argument_whitespace = True
+    option_spec = {
+        "dedent": int,
+        "linenos": directives.flag,
+        "lineno-start": int,
+        "lineno-match": directives.flag,
+        "tab-width": int,
+        "language": directives.unchanged_required,
+        "encoding": directives.encoding,
+        "pyobject": directives.unchanged_required,
+        "lines": directives.unchanged_required,
+        "start-after": directives.unchanged_required,
+        "end-before": directives.unchanged_required,
+        "start-at": directives.unchanged_required,
+        "end-at": directives.unchanged_required,
+        "prepend": directives.unchanged_required,
+        "append": directives.unchanged_required,
+        "emphasize-lines": directives.unchanged_required,
+        "class": directives.class_option,
+        "name": directives.unchanged,
+        "diff": directives.unchanged_required,
+    }
+
+    def run(self):
+        document = self.state.document
+        if not document.settings.file_insertion_enabled:
+            return [document.reporter.warning("File insertion disabled", line=self.lineno)]
+        # convert options['diff'] to absolute path
+        if "diff" in self.options:
+            _, path = self.env.relfn2path(self.options["diff"])
+            self.options["diff"] = path
+
+        try:
+            location = self.state_machine.get_source_and_line(self.lineno)
+            rel_filename, filename = self.env.relfn2path(self.arguments[0])
+            self.env.note_dependency(rel_filename)
+
+            reader = LiteralIncludeReader(filename, self.options, self.config)
+            text, lines = reader.read(location=location)
+
+            retnode = nodes.literal_block(text, text, source=filename)
+            set_source_info(self, retnode)
+            if self.options.get("diff"):  # if diff is set, set udiff
+                retnode["language"] = "udiff"
+            elif "language" in self.options:
+                retnode["language"] = self.options["language"]
+            retnode["linenos"] = (
+                "linenos" in self.options or "lineno-start" in self.options or "lineno-match" in self.options
+            )
+            retnode["classes"] += self.options.get("class", [])
+            extra_args = retnode["highlight_args"] = {}
+            if "emphasize-lines" in self.options:
+                hl_lines = parselinenos(self.options["emphasize-lines"], lines)
+                if any(i >= lines for i in hl_lines):
+                    logger.warning(
+                        "line number spec is out of range(1-%d): %r", lines, self.options["emphasize-lines"]
+                    )
+                extra_args["hl_lines"] = [x + 1 for x in hl_lines if x < lines]
+            extra_args["linenostart"] = reader.lineno_start
+
+            container_node = nodes.container("", literal_block=True, classes=["example-block-wrapper"])
+            container_node += example_header(filename=filename)
+            container_node += retnode
+            retnode = container_node
+
+            return [retnode]
+        except Exception as exc:
+            return [document.reporter.warning(text_type(exc), line=self.lineno)]
+
+
+def register_source(app, env, modname):
+    entry = env._viewcode_modules.get(modname, None)  # type: ignore
+    if entry is False:
+        print("[%s] Entry is false for " % modname)
+        return
+
+    code_tags = app.emit_firstresult("viewcode-find-source", modname)
+    if code_tags is None:
+        try:
+            analyzer = ModuleAnalyzer.for_module(modname)
+        except Exception as ex:
+            logger.info("Module \"%s\" could not be loaded. Full source will not be available.", modname)
+            env._viewcode_modules[modname] = False  # type: ignore
+            return False
+
+        if not isinstance(analyzer.code, text_type):
+            code = analyzer.code.decode(analyzer.encoding)
+        else:
+            code = analyzer.code
+
+        analyzer.find_tags()
+        tags = analyzer.tags
+
+    else:
+        code, tags = code_tags
+
+    if entry is None or entry[0] != code:
+        # print("Registeted", entry)
+
+        entry = code, tags, {}, ""
+        env._viewcode_modules[modname] = entry  # type: ignore
+
+    return True
+
+
+def create_node(app, env, relative_path, show_button):
+    pagename = "_modules/" + relative_path[:-3]
+
+    header_classes = ["example-header"]
+    if show_button:
+        header_classes += ["example-header--with-button"]
+    paragraph = nodes.paragraph(relative_path, classes=header_classes)
+    paragraph += nodes.inline("", relative_path, classes=["example-title"])
+    if show_button:
+        pending_ref = addnodes.pending_xref(
+            "",
+            reftype="viewcode",
+            refdomain="std",
+            refexplicit=False,
+            reftarget=pagename,
+            refid="",
+            refdoc=env.docname,
+            classes=["example-header-button viewcode-button"],
+        )
+        pending_ref += nodes.inline("", _("View Source"))
+        paragraph += pending_ref
+
+    return paragraph
+
+
+def doctree_read(app, doctree):
+    env = app.builder.env
+    if not hasattr(env, "_viewcode_modules"):
+        env._viewcode_modules = {}  # type: ignore
+
+    if app.builder.name == "singlehtml":
+        return
+
+    for objnode in doctree.traverse(example_header):
+        filepath = objnode.get("filename")
+        relative_path = path.relpath(
+            filepath, path.commonprefix([app.config.exampleinclude_sourceroot, filepath])
+        )
+        modname = relative_path.replace("/", ".")[:-3]
+        show_button = register_source(app, env, modname)
+        onlynode = create_node(app, env, relative_path, show_button)
+
+        objnode.replace_self(onlynode)
+
+
+def setup(app):
+    directives.register_directive("exampleinclude", ExampleInclude)
+    app.connect("doctree-read", doctree_read)
+    app.add_config_value("exampleinclude_sourceroot", None, "env")
+
+    return {"version": "builtin", "parallel_read_safe": False, "parallel_write_safe": False}
diff --git a/docs/exts/removemarktransform.py b/docs/exts/removemarktransform.py
new file mode 100644
index 0000000000000..01ec440d0e112
--- /dev/null
+++ b/docs/exts/removemarktransform.py
@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+#
+# flake8: noqa
+# Disable Flake8 because of all the sphinx imports
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import re
+
+from docutils import nodes
+from pygments.lexers import guess_lexer, Python3Lexer, PythonLexer
+from sphinx.transforms import SphinxTransform
+from sphinx.transforms.post_transforms.code import TrimDoctestFlagsTransform
+
+docmark_re = re.compile(r"\s*#\s*\[(START|END)\s*[a-z_A-Z]+\].*$", re.MULTILINE)
+
+
+class TrimDocMarkerFlagsTransform(SphinxTransform):
+    """
+    Trim doc marker like ``# [START howto_concept]` from python code-blocks.
+
+    Based on:
+    https://github.com/sphinx-doc/sphinx/blob/master/sphinx/transforms/post_transforms/code.py
+    class TrimDoctestFlagsTransform
+    """
+
+    default_priority = TrimDoctestFlagsTransform.default_priority + 1
+
+    def apply(self, **kwargs):
+        for node in self.document.traverse(nodes.literal_block):
+            if self.is_pycode(node):
+                source = node.rawsource
+                source = docmark_re.sub("", source)
+                node.rawsource = source
+                node[:] = [nodes.Text(source)]
+
+    @staticmethod
+    def is_pycode(node):
+        # type: (nodes.literal_block) -> bool
+        if node.rawsource != node.astext():
+            return False  # skip parsed-literal node
+
+        language = node.get("language")
+        if language in ("py", "py3", "python", "python3", "default"):
+            return True
+        elif language == "guess":
+            try:
+                lexer = guess_lexer(node.rawsource)
+                return isinstance(lexer, PythonLexer) or isinstance(lexer, Python3Lexer)
+            except Exception:
+                pass
+
+        return False
+
+
+def setup(app):
+    app.add_post_transform(TrimDocMarkerFlagsTransform)
+
+    return {"version": "builtin", "parallel_read_safe": False, "parallel_write_safe": False}
diff --git a/docs/howto/operator/bash.rst b/docs/howto/operator/bash.rst
index 9795268b58240..b6a075af7edb7 100644
--- a/docs/howto/operator/bash.rst
+++ b/docs/howto/operator/bash.rst
@@ -23,7 +23,7 @@ BashOperator
 Use the :class:`~airflow.operators.bash_operator.BashOperator` to execute
 commands in a `Bash <https://www.gnu.org/software/bash/>`__ shell.
 
-.. literalinclude:: ../../../airflow/example_dags/example_bash_operator.py
+.. exampleinclude:: ../../../airflow/example_dags/example_bash_operator.py
     :language: python
     :start-after: [START howto_operator_bash]
     :end-before: [END howto_operator_bash]
@@ -34,7 +34,7 @@ Templating
 You can use :ref:`Jinja templates <jinja-templating>` to parameterize the
 ``bash_command`` argument.
 
-.. literalinclude:: ../../../airflow/example_dags/example_bash_operator.py
+.. exampleinclude:: ../../../airflow/example_dags/example_bash_operator.py
     :language: python
     :start-after: [START howto_operator_bash_template]
     :end-before: [END howto_operator_bash_template]
diff --git a/docs/howto/operator/gcp/bigtable.rst b/docs/howto/operator/gcp/bigtable.rst
index 4fcdd85fb6624..3d144a2cec9d6 100644
--- a/docs/howto/operator/gcp/bigtable.rst
+++ b/docs/howto/operator/gcp/bigtable.rst
@@ -24,7 +24,7 @@ Google Cloud Bigtable Operators
 
 All examples below rely on the following variables, which can be passed via environment variables.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :start-after: [START howto_operator_gcp_bigtable_args]
     :end-before: [END howto_operator_gcp_bigtable_args]
@@ -46,7 +46,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_instance_create]
@@ -66,7 +66,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_instance_delete]
@@ -86,7 +86,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_cluster_update]
@@ -110,7 +110,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_table_create]
@@ -138,7 +138,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_table_delete]
@@ -163,7 +163,7 @@ timeout hits and does not raise any exception.
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_bigtable_operators.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcp_bigtable_table_wait_for_replication]
diff --git a/docs/howto/operator/gcp/compute.rst b/docs/howto/operator/gcp/compute.rst
index a442c2219964a..1d773ad4ff3c5 100644
--- a/docs/howto/operator/gcp/compute.rst
+++ b/docs/howto/operator/gcp/compute.rst
@@ -37,7 +37,7 @@ Arguments
 
 The following examples of OS environment variables used to pass arguments to the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :start-after: [START howto_operator_gce_args_common]
     :end-before: [END howto_operator_gce_args_common]
@@ -47,7 +47,7 @@ Using the operator
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_start]
@@ -56,7 +56,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection id used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_start_no_project_id]
@@ -66,7 +66,7 @@ from the GCP connection id used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gce_instance_start_template_fields]
@@ -93,7 +93,7 @@ Arguments
 
 The following examples of OS environment variables used to pass arguments to the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
    :language: python
    :start-after: [START howto_operator_gce_args_common]
    :end-before: [END howto_operator_gce_args_common]
@@ -103,7 +103,7 @@ Using the operator
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_stop]
@@ -112,7 +112,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_stop_no_project_id]
@@ -121,7 +121,7 @@ from the GCP connection used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gce_instance_stop_template_fields]
@@ -148,13 +148,13 @@ Arguments
 
 The following examples of OS environment variables used to pass arguments to the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :start-after: [START howto_operator_gce_args_common]
     :end-before: [END howto_operator_gce_args_common]
 
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :start-after: [START howto_operator_gce_args_set_machine_type]
     :end-before: [END howto_operator_gce_args_set_machine_type]
@@ -164,7 +164,7 @@ Using the operator
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_set_machine_type]
@@ -173,7 +173,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_set_machine_type_no_project_id]
@@ -182,7 +182,7 @@ from the GCP connection used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gce_instance_set_machine_type_template_fields]
@@ -210,12 +210,12 @@ Arguments
 
 The following examples of OS environment variables used to pass arguments to the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :start-after: [START howto_operator_compute_igm_common_args]
     :end-before: [END howto_operator_compute_igm_common_args]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :start-after: [START howto_operator_compute_template_copy_args]
     :end-before: [END howto_operator_compute_template_copy_args]
@@ -225,7 +225,7 @@ Using the operator
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_copy_template]
@@ -234,7 +234,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_copy_template_no_project_id]
@@ -243,7 +243,7 @@ from the GCP connection used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gce_instance_template_copy_operator_template_fields]
@@ -270,12 +270,12 @@ Arguments
 
 The following examples of OS environment variables used to pass arguments to the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :start-after: [START howto_operator_compute_igm_common_args]
     :end-before: [END howto_operator_compute_igm_common_args]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :start-after: [START howto_operator_compute_igm_update_template_args]
     :end-before: [END howto_operator_compute_igm_update_template_args]
@@ -285,7 +285,7 @@ Using the operator
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_update_template]
@@ -294,7 +294,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_compute_igm.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gce_igm_update_template_no_project_id]
@@ -304,7 +304,7 @@ from the GCP connection used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_compute_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gce_igm_update_template_operator_template_fields]
diff --git a/docs/howto/operator/gcp/function.rst b/docs/howto/operator/gcp/function.rst
index 61ba01510c22f..2d2af271e869b 100644
--- a/docs/howto/operator/gcp/function.rst
+++ b/docs/howto/operator/gcp/function.rst
@@ -38,7 +38,7 @@ Arguments
 The following examples of OS environment variables show how you can build function name
 to use in the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_common_variables]
     :end-before: [END howto_operator_gcf_common_variables]
@@ -46,7 +46,7 @@ to use in the operator:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcf_delete]
@@ -55,7 +55,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcf_function_delete_template_fields]
@@ -85,19 +85,19 @@ Arguments
 In the example DAG the following environment variables are used to parameterize the
 operator's definition:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_common_variables]
     :end-before: [END howto_operator_gcf_common_variables]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_variables]
     :end-before: [END howto_operator_gcf_deploy_variables]
 
 Some of those variables are used to create the request's body:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_body]
     :end-before: [END howto_operator_gcf_deploy_body]
@@ -105,7 +105,7 @@ Some of those variables are used to create the request's body:
 When a DAG is created, the default_args dictionary can be used to pass
 arguments common with other tasks:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_default_args]
     :end-before: [END howto_operator_gcf_default_args]
@@ -129,14 +129,14 @@ Using the operator
 Depending on the combination of parameters, the Function's source code can be obtained
 from different sources:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :start-after: [START howto_operator_gcf_deploy_variants]
     :end-before: [END howto_operator_gcf_deploy_variants]
 
 The code to create the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcf_deploy]
@@ -145,7 +145,7 @@ The code to create the operator:
 You can also create the operator without project id - project id will be retrieved
 from the GCP connection used:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_function.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcf_deploy_no_project_id]
@@ -154,7 +154,7 @@ from the GCP connection used:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_function_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcf_function_deploy_template_fields]
diff --git a/docs/howto/operator/gcp/gcs.rst b/docs/howto/operator/gcp/gcs.rst
index 6df9c1c1c6b31..a5a41c9f6545c 100644
--- a/docs/howto/operator/gcp/gcs.rst
+++ b/docs/howto/operator/gcp/gcs.rst
@@ -31,7 +31,7 @@ Use the
 :class:`~airflow.contrib.operators.gcs_to_bq.GoogleCloudStorageToBigQueryOperator`
 to execute a BigQuery load job.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_to_bq_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcs_to_bq_operator.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcs_to_bq]
@@ -53,7 +53,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
     :language: python
     :start-after: [START howto_operator_gcs_acl_args_common]
     :end-before: [END howto_operator_gcs_acl_args_common]
@@ -61,7 +61,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcs_bucket_create_acl_entry_task]
@@ -70,7 +70,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcs_bucket_create_acl_template_fields]
@@ -97,7 +97,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
     :language: python
     :start-after: [START howto_operator_gcs_acl_args_common]
     :end-before: [END howto_operator_gcs_acl_args_common]
@@ -105,7 +105,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcs_acl.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_gcs_object_create_acl_entry_task]
@@ -114,7 +114,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcs_acl_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcs_object_create_acl_template_fields]
diff --git a/docs/howto/operator/gcp/spanner.rst b/docs/howto/operator/gcp/spanner.rst
index 644c1c4b93f0c..0d4c5a4e3d727 100644
--- a/docs/howto/operator/gcp/spanner.rst
+++ b/docs/howto/operator/gcp/spanner.rst
@@ -38,7 +38,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :start-after: [START howto_operator_spanner_arguments]
     :end-before: [END howto_operator_spanner_arguments]
@@ -49,7 +49,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_database_delete]
@@ -58,7 +58,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_spanner_delete_template_fields]
@@ -88,7 +88,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :start-after: [START howto_operator_spanner_arguments]
     :end-before: [END howto_operator_spanner_arguments]
@@ -99,7 +99,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_database_deploy]
@@ -108,7 +108,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_spanner_database_deploy_template_fields]
@@ -142,7 +142,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :start-after: [START howto_operator_spanner_arguments]
     :end-before: [END howto_operator_spanner_arguments]
@@ -153,13 +153,13 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_database_update]
     :end-before: [END howto_operator_spanner_database_update]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_database_update_idempotent]
@@ -168,7 +168,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_spanner_database_update_template_fields]
@@ -195,7 +195,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables.
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :start-after: [START howto_operator_spanner_arguments]
     :end-before: [END howto_operator_spanner_arguments]
@@ -206,7 +206,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_query]
@@ -215,7 +215,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_spanner_query_template_fields]
@@ -243,7 +243,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :start-after: [START howto_operator_spanner_arguments]
     :end-before: [END howto_operator_spanner_arguments]
@@ -254,7 +254,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_spanner.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_spanner_delete]
@@ -263,7 +263,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_spanner_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_spanner_delete_template_fields]
diff --git a/docs/howto/operator/gcp/sql.rst b/docs/howto/operator/gcp/sql.rst
index 77ec21a44e404..a18a95ef8ebd8 100644
--- a/docs/howto/operator/gcp/sql.rst
+++ b/docs/howto/operator/gcp/sql.rst
@@ -37,7 +37,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
@@ -48,7 +48,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_db_create]
@@ -56,7 +56,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 
 Example request body:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_db_create_body]
     :end-before: [END howto_operator_cloudsql_db_create_body]
@@ -64,7 +64,7 @@ Example request body:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_db_create_template_fields]
@@ -91,7 +91,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
@@ -102,7 +102,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_db_delete]
@@ -111,7 +111,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_db_delete_template_fields]
@@ -140,7 +140,7 @@ Arguments
 
 Some arguments in the example DAG are taken from environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
@@ -151,7 +151,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_db_patch]
@@ -159,7 +159,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 
 Example request body:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_db_patch_body]
     :end-before: [END howto_operator_cloudsql_db_patch_body]
@@ -167,7 +167,7 @@ Example request body:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_db_patch_template_fields]
@@ -196,7 +196,7 @@ Arguments
 
 Some arguments in the example DAG are taken from OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
@@ -207,7 +207,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_delete]
@@ -216,7 +216,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Note: If the instance has read or failover replicas you need to delete them before you delete the primary instance.
 Replicas are deleted the same way as primary instances:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_replicas_delete]
@@ -225,7 +225,7 @@ Replicas are deleted the same way as primary instances:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_delete_template_fields]
@@ -257,19 +257,19 @@ Arguments
 
 Some arguments in the example DAG are taken from Airflow variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_export_import_arguments]
     :end-before: [END howto_operator_cloudsql_export_import_arguments]
 
 Example body defining the export operation:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_export_body]
     :end-before: [END howto_operator_cloudsql_export_body]
@@ -280,7 +280,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_export]
@@ -289,7 +289,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_export_template_fields]
@@ -314,7 +314,7 @@ To grant the service account with the appropriate WRITE permissions for the GCS
 you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageBucketCreateAclEntryOperator`,
 as shown in the example:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_export_gcs_permissions]
@@ -354,19 +354,19 @@ Arguments
 
 Some arguments in the example DAG are taken from Airflow variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_export_import_arguments]
     :end-before: [END howto_operator_cloudsql_export_import_arguments]
 
 Example body defining the import operation:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_import_body]
     :end-before: [END howto_operator_cloudsql_import_body]
@@ -377,7 +377,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_import]
@@ -386,7 +386,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_import_template_fields]
@@ -411,7 +411,7 @@ To grant the service account with the appropriate READ permissions for the GCS o
 you can use the :class:`~airflow.contrib.operators.gcs_acl_operator.GoogleCloudStorageObjectCreateAclEntryOperator`,
 as shown in the example:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_import_gcs_permissions]
@@ -437,28 +437,28 @@ Arguments
 
 Some arguments in the example DAG are taken from OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
 
 Some other arguments are created based on the arguments above:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_create_arguments]
     :end-before: [END howto_operator_cloudsql_create_arguments]
 
 Example body defining the instance with failover replica:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_create_body]
     :end-before: [END howto_operator_cloudsql_create_body]
 
 Example body defining read replica for the instance above:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_create_replica]
     :end-before: [END howto_operator_cloudsql_create_replica]
@@ -472,7 +472,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_create]
@@ -481,7 +481,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_create_template_fields]
@@ -512,14 +512,14 @@ Arguments
 
 Some arguments in the example DAG are taken from OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_arguments]
     :end-before: [END howto_operator_cloudsql_arguments]
 
 Example body defining the instance:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :start-after: [START howto_operator_cloudsql_patch_body]
     :end-before: [END howto_operator_cloudsql_patch_body]
@@ -530,7 +530,7 @@ Using the operator
 You can create the operator with or without project id. If project id is missing
 it will be retrieved from the GCP connection used. Both variants are shown:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_cloudsql_patch]
@@ -539,7 +539,7 @@ it will be retrieved from the GCP connection used. Both variants are shown:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_patch_template_fields]
@@ -603,7 +603,7 @@ NFS-like volumes in the same path for all the workers.
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
     :language: python
     :start-after: [START howto_operator_cloudsql_query_arguments]
     :end-before: [END howto_operator_cloudsql_query_arguments]
@@ -611,7 +611,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Example connection definitions for all connectivity cases. Note that all the components
 of the connection URI should be URL-encoded:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
     :language: python
     :start-after: [START howto_operator_cloudsql_query_connections]
     :end-before: [END howto_operator_cloudsql_query_connections]
@@ -623,7 +623,7 @@ Example operators below are using all connectivity options. Note connection id
 from the operator matches the `AIRFLOW_CONN_*` postfix uppercase. This is
 standard AIRFLOW notation for defining connection via environment variables):
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_sql_query.py
     :language: python
     :start-after: [START howto_operator_cloudsql_query_operators]
     :end-before: [END howto_operator_cloudsql_query_operators]
@@ -631,7 +631,7 @@ standard AIRFLOW notation for defining connection via environment variables):
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_sql_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_sql_query_template_fields]
diff --git a/docs/howto/operator/gcp/transfer.rst b/docs/howto/operator/gcp/transfer.rst
index 0385bc9bcf3fb..c41313669cf4c 100644
--- a/docs/howto/operator/gcp/transfer.rst
+++ b/docs/howto/operator/gcp/transfer.rst
@@ -53,7 +53,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -61,17 +61,17 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_create_job_body_gcp]
       :end-before: [END howto_operator_gcp_transfer_create_job_body_gcp]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_create_job_body_aws]
       :end-before: [END howto_operator_gcp_transfer_create_job_body_aws]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_create_job]
@@ -80,7 +80,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_job_create_template_fields]
@@ -104,7 +104,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -112,7 +112,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_delete_job]
@@ -121,7 +121,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_job_delete_template_fields]
@@ -145,7 +145,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -153,12 +153,12 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_update_job_body]
       :end-before: [END howto_operator_gcp_transfer_update_job_body]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_update_job]
@@ -167,7 +167,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_job_update_template_fields]
@@ -191,7 +191,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -199,7 +199,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_cancel_operation]
@@ -208,7 +208,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_operation_cancel_template_fields]
@@ -233,7 +233,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -241,7 +241,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_get_operation]
@@ -250,7 +250,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_operation_get_template_fields]
@@ -274,7 +274,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -282,7 +282,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_list_operations]
@@ -291,7 +291,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_operations_list_template_fields]
@@ -315,7 +315,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -323,7 +323,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_pause_operation]
@@ -332,7 +332,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_operation_pause_template_fields]
@@ -356,7 +356,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -364,7 +364,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_resume_operation]
@@ -373,7 +373,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_transfer_operator.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_operation_resume_template_fields]
@@ -396,7 +396,7 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :start-after: [START howto_operator_gcp_transfer_common_variables]
       :end-before: [END howto_operator_gcp_transfer_common_variables]
@@ -404,7 +404,7 @@ Some arguments in the example DAG are taken from the OS environment variables:
 Using the operator
 """"""""""""""""""
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_transfer.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_gcp_transfer_wait_operation]
@@ -413,7 +413,7 @@ Using the operator
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/sensors/gcp_transfer_sensor.py
+.. exampleinclude:: ../../../../airflow/contrib/sensors/gcp_transfer_sensor.py
     :language: python
     :dedent: 4
     :start-after: [START gcp_transfer_job_sensor_template_fields]
diff --git a/docs/howto/operator/gcp/translate.rst b/docs/howto/operator/gcp/translate.rst
index 8418b1341e95f..32ad7bfdb688a 100644
--- a/docs/howto/operator/gcp/translate.rst
+++ b/docs/howto/operator/gcp/translate.rst
@@ -37,7 +37,7 @@ Using the operator
 
 Basic usage of the operator:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_translate_text]
@@ -46,7 +46,7 @@ Basic usage of the operator:
 The result of translation is available as dictionary or array of dictionaries accessible via the usual
 XCom mechanisms of Airflow:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_translate.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_translate_access]
@@ -56,7 +56,7 @@ XCom mechanisms of Airflow:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_translate_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_translate_operator.py
     :language: python
     :dedent: 4
     :start-after: [START translate_template_fields]
diff --git a/docs/howto/operator/gcp/vision.rst b/docs/howto/operator/gcp/vision.rst
index 165eca13e7787..67ed7cc44899e 100644
--- a/docs/howto/operator/gcp/vision.rst
+++ b/docs/howto/operator/gcp/vision.rst
@@ -37,17 +37,17 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_args_common]
       :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_explicit_id]
       :end-before: [END howto_operator_vision_product_explicit_id]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_set_explicit_id]
       :end-before: [END howto_operator_vision_product_set_explicit_id]
@@ -59,17 +59,17 @@ We are using the :class:`~google.cloud.vision_v1.types.Product`,
 :class:`~google.cloud.vision_v1.types.ProductSet` and ``Retry`` objects from
 Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_retry_import]
       :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_set_import]
       :end-before: [END howto_operator_vision_product_set_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_import]
       :end-before: [END howto_operator_vision_product_import]
@@ -77,7 +77,7 @@ Google libraries:
 
 If ``product_set_id`` and ``product_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_add_product_to_product_set]
@@ -85,7 +85,7 @@ If ``product_set_id`` and ``product_id`` was generated by the API it can be extr
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_add_product_to_product_set_2]
@@ -95,7 +95,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_add_product_to_product_set_template_fields]
@@ -123,12 +123,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_args_common]
       :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_annotate_image_url]
       :end-before: [END howto_operator_vision_annotate_image_url]
@@ -140,18 +140,18 @@ Using the operator
 We are using the :class:`~google.cloud.enums` and ``Retry`` objects from
 Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_retry_import]
       :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_enums_import]
       :end-before: [END howto_operator_vision_enums_import]
 
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_annotate_image]
@@ -159,7 +159,7 @@ Google libraries:
 
 The result can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_annotate_image_result]
@@ -169,7 +169,7 @@ The result can be extracted from XCOM:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_annotate_image_template_fields]
@@ -202,12 +202,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_explicit_id]
     :end-before: [END howto_operator_vision_product_explicit_id]
@@ -217,24 +217,24 @@ Using the operator
 
 We are using the ``Product`` and ``Retry`` objects from Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_import]
     :end-before: [END howto_operator_vision_product_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_retry_import]
     :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product]
     :end-before: [END howto_operator_vision_product]
 
 The ``product_id`` argument can be omitted (it will be generated by the API):
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_create]
@@ -242,7 +242,7 @@ The ``product_id`` argument can be omitted (it will be generated by the API):
 
 Or it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_create_2]
@@ -252,7 +252,7 @@ Or it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_product_create_template_fields]
@@ -287,12 +287,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_explicit_id]
     :end-before: [END howto_operator_vision_product_explicit_id]
@@ -302,7 +302,7 @@ Using the operator
 
 If ``product_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_delete]
@@ -310,7 +310,7 @@ If ``product_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_delete_2]
@@ -319,7 +319,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_product_delete_template_fields]
@@ -350,12 +350,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_explicit_id]
     :end-before: [END howto_operator_vision_product_explicit_id]
@@ -365,7 +365,7 @@ Using the operator
 
 If ``product_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_get]
@@ -373,7 +373,7 @@ If ``product_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_get_2]
@@ -382,7 +382,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_product_get_template_fields]
@@ -409,12 +409,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_explicit_id
     :end-before: [END howto_operator_vision_product_set_explicit_id
@@ -424,24 +424,24 @@ Using the operator
 
 We are using the ``ProductSet`` and ``Retry`` objects from Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_import]
     :end-before: [END howto_operator_vision_product_set_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_retry_import]
     :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set]
     :end-before: [END howto_operator_vision_product_set]
 
 The ``product_set_id`` argument can be omitted (it will be generated by the API):
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_create]
@@ -449,7 +449,7 @@ The ``product_set_id`` argument can be omitted (it will be generated by the API)
 
 Or it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_create_2]
@@ -459,7 +459,7 @@ Or it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_productset_create_template_fields]
@@ -488,12 +488,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_explicit_id]
     :end-before: [END howto_operator_vision_product_set_explicit_id]
@@ -503,7 +503,7 @@ Using the operator
 
 If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_delete]
@@ -511,7 +511,7 @@ If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_delete_2]
@@ -520,7 +520,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_productset_delete_template_fields]
@@ -547,12 +547,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_explicit_id]
     :end-before: [END howto_operator_vision_product_set_explicit_id]
@@ -562,7 +562,7 @@ Using the operator
 
 If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_get]
@@ -570,7 +570,7 @@ If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_get_2]
@@ -579,7 +579,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_productset_get_template_fields]
@@ -618,12 +618,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_explicit_id]
     :end-before: [END howto_operator_vision_product_set_explicit_id]
@@ -633,12 +633,12 @@ Using the operator
 
 We are using the ``ProductSet`` object from the Google Cloud Vision library:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set_import]
     :end-before: [END howto_operator_vision_product_set_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_set]
     :end-before: [END howto_operator_vision_product_set]
@@ -647,7 +647,7 @@ Initialization of the task:
 
 If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_update]
@@ -655,7 +655,7 @@ If ``product_set_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_set_update_2]
@@ -664,7 +664,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_productset_update_template_fields]
@@ -714,12 +714,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_args_common]
     :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_explicit_id]
     :end-before: [END howto_operator_vision_product_explicit_id]
@@ -729,19 +729,19 @@ Using the operator
 
 We are using the ``Product`` object from the Google Cloud Vision library:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product_import]
     :end-before: [END howto_operator_vision_product_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :start-after: [START howto_operator_vision_product]
     :end-before: [END howto_operator_vision_product]
 
 If ``product_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_update]
@@ -749,7 +749,7 @@ If ``product_id`` was generated by the API it can be extracted from XCOM:
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
     :language: python
     :dedent: 4
     :start-after: [START howto_operator_vision_product_update_2]
@@ -758,7 +758,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_product_update_template_fields]
@@ -785,12 +785,12 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_args_common]
       :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_reference_image_args]
       :end-before: [END howto_operator_vision_reference_image_args]
@@ -800,24 +800,24 @@ Using the operator
 
 We are using the :class:`~google.cloud.vision_v1.types.ReferenceImage` and ``Retry`` objects from Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_reference_image_import]
       :end-before: [END howto_operator_vision_reference_image_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_retry_import]
       :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_reference_image]
       :end-before: [END howto_operator_vision_reference_image]
 
 The ``product_set_id`` argument can be omitted (it will be generated by the API):
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_reference_image_create]
@@ -825,7 +825,7 @@ The ``product_set_id`` argument can be omitted (it will be generated by the API)
 
 Or it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_reference_image_create_2]
@@ -835,7 +835,7 @@ Or it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_reference_image_create_template_fields]
@@ -862,17 +862,17 @@ Arguments
 
 Some arguments in the example DAG are taken from the OS environment variables:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_args_common]
       :end-before: [END howto_operator_vision_args_common]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_explicit_id]
       :end-before: [END howto_operator_vision_product_explicit_id]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_set_explicit_id]
       :end-before: [END howto_operator_vision_product_set_explicit_id]
@@ -884,17 +884,17 @@ We are using the :class:`~google.cloud.vision_v1.types.Product`,
 :class:`~google.cloud.vision_v1.types.ProductSet` and ``Retry`` objects from
 Google libraries:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_retry_import]
       :end-before: [END howto_operator_vision_retry_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_set_import]
       :end-before: [END howto_operator_vision_product_set_import]
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :start-after: [START howto_operator_vision_product_import]
       :end-before: [END howto_operator_vision_product_import]
@@ -902,7 +902,7 @@ Google libraries:
 
 If ``product_set_id`` and ``product_id`` was generated by the API it can be extracted from XCOM:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_remove_product_from_product_set]
@@ -910,7 +910,7 @@ If ``product_set_id`` and ``product_id`` was generated by the API it can be extr
 
 Otherwise it can be specified explicitly:
 
-.. literalinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_vision.py
       :language: python
       :dedent: 4
       :start-after: [START howto_operator_vision_remove_product_from_product_set_2]
@@ -920,7 +920,7 @@ Otherwise it can be specified explicitly:
 Templating
 """"""""""
 
-.. literalinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
+.. exampleinclude:: ../../../../airflow/contrib/operators/gcp_vision_operator.py
     :language: python
     :dedent: 4
     :start-after: [START vision_remove_product_from_product_set_template_fields]
diff --git a/docs/howto/operator/python.rst b/docs/howto/operator/python.rst
index c3ef068dbaf0b..da2180138e069 100644
--- a/docs/howto/operator/python.rst
+++ b/docs/howto/operator/python.rst
@@ -23,7 +23,7 @@ PythonOperator
 Use the :class:`~airflow.operators.python_operator.PythonOperator` to execute
 Python callables.
 
-.. literalinclude:: ../../../airflow/example_dags/example_python_operator.py
+.. exampleinclude:: ../../../airflow/example_dags/example_python_operator.py
     :language: python
     :start-after: [START howto_operator_python]
     :end-before: [END howto_operator_python]
@@ -34,7 +34,7 @@ Passing in arguments
 Use the ``op_args`` and ``op_kwargs`` arguments to pass additional arguments
 to the Python callable.
 
-.. literalinclude:: ../../../airflow/example_dags/example_python_operator.py
+.. exampleinclude:: ../../../airflow/example_dags/example_python_operator.py
     :language: python
     :start-after: [START howto_operator_python_kwargs]
     :end-before: [END howto_operator_python_kwargs]
diff --git a/docs/templates/layout.html b/docs/templates/layout.html
index 15822dc18d039..f6bb8fa04a78d 100644
--- a/docs/templates/layout.html
+++ b/docs/templates/layout.html
@@ -27,4 +27,66 @@
       };
     })
   </script>
+  <style>
+    .example-header {
+      position: relative;
+      background: #9AAA7A;
+      padding: 8px 16px;
+      margin-bottom: 0;
+    }
+    .example-header--with-button {
+      padding-right: 166px;
+    }
+    .example-header:after{
+      content: '';
+      display: table;
+      clear: both;
+    }
+    .example-title {
+      display:block;
+      padding: 4px;
+      margin-right: 16px;
+      color: white;
+      overflow-x: auto;
+    }
+    .example-header-button {
+      top: 8px;
+      right: 16px;
+      position: absolute;
+    }
+    .example-header + .highlight-python {
+      margin-top: 0 !important;
+    }
+    .viewcode-button {
+      display: inline-block;
+      padding: 8px 16px;
+      border: 0;
+      margin: 0;
+      outline: 0;
+      border-radius: 2px;
+      -webkit-box-shadow: 0 3px 5px 0 rgba(0,0,0,.3);
+      box-shadow: 0 3px 6px 0 rgba(0,0,0,.3);
+      color: #404040;
+      background-color: #e7e7e7;
+      cursor: pointer;
+      font-size: 16px;
+      font-weight: 500;
+      line-height: 1;
+      text-decoration: none;
+      text-overflow: ellipsis;
+      overflow: hidden;
+      text-transform: uppercase;
+      -webkit-transition: background-color .2s;
+      transition: background-color .2s;
+      vertical-align: middle;
+      white-space: nowrap;
+    }
+    .viewcode-button:visited {
+      color: #404040;
+    }
+    .viewcode-button:hover, .viewcode-button:focus {
+      color: #404040;
+      background-color: #d6d6d6;
+    }
+  </style>
 {% endblock %}

From 91b856fce05e4ec73ceef19892ac2fa5606fa51d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Bregu=C5=82a?= <mik-laj@users.noreply.github.com>
Date: Fri, 5 Apr 2019 23:36:50 +0200
Subject: [PATCH 799/808] [AIRFLOW-3971] Add Google Cloud Natural Language
 operators (#4980)

---
 .../example_gcp_natural_language.py           | 114 ++++++++
 airflow/contrib/hooks/gcp_api_base_hook.py    |   2 +
 .../hooks/gcp_natural_language_hook.py        | 217 +++++++++++++++
 .../gcp_natural_language_operator.py          | 262 ++++++++++++++++++
 docs/concepts.rst                             |   2 +
 docs/conf.py                                  |   3 +-
 docs/exts/docroles.py                         |  95 +++++++
 .../gcp/_partials/prerequisite_tasks.rst      |  31 +++
 docs/howto/operator/gcp/natural_language.rst  | 180 ++++++++++++
 docs/integration.rst                          |  20 ++
 setup.py                                      |   9 +-
 .../hooks/test_gcp_natural_language_hook.py   | 126 +++++++++
 .../test_gcp_natural_language_operator.py     |  84 ++++++
 ...st_gcp_natural_language_operator_system.py |  33 +++
 14 files changed, 1173 insertions(+), 5 deletions(-)
 create mode 100644 airflow/contrib/example_dags/example_gcp_natural_language.py
 create mode 100644 airflow/contrib/hooks/gcp_natural_language_hook.py
 create mode 100644 airflow/contrib/operators/gcp_natural_language_operator.py
 create mode 100644 docs/exts/docroles.py
 create mode 100644 docs/howto/operator/gcp/_partials/prerequisite_tasks.rst
 create mode 100644 docs/howto/operator/gcp/natural_language.rst
 create mode 100644 tests/contrib/hooks/test_gcp_natural_language_hook.py
 create mode 100644 tests/contrib/operators/test_gcp_natural_language_operator.py
 create mode 100644 tests/contrib/operators/test_gcp_natural_language_operator_system.py

diff --git a/airflow/contrib/example_dags/example_gcp_natural_language.py b/airflow/contrib/example_dags/example_gcp_natural_language.py
new file mode 100644
index 0000000000000..48ace4030bf17
--- /dev/null
+++ b/airflow/contrib/example_dags/example_gcp_natural_language.py
@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+"""
+Example Airflow DAG for Google Cloud Natural Language service
+"""
+
+
+from google.cloud.language_v1.proto.language_service_pb2 import Document
+
+import airflow
+from airflow import models
+from airflow.contrib.operators.gcp_natural_language_operator import (
+    CloudLanguageAnalyzeEntitiesOperator,
+    CloudLanguageAnalyzeEntitySentimentOperator,
+    CloudLanguageAnalyzeSentimentOperator,
+    CloudLanguageClassifyTextOperator,
+)
+from airflow.operators.bash_operator import BashOperator
+
+# [START howto_operator_gcp_natural_language_document_text]
+TEXT = """
+Airflow is a platform to programmatically author, schedule and monitor workflows.
+
+Use Airflow to author workflows as Directed Acyclic Graphs (DAGs) of tasks. The Airflow scheduler executes
+ your tasks on an array of workers while following the specified dependencies. Rich command line utilities
+ make performing complex surgeries on DAGs a snap. The rich user interface makes it easy to visualize
+ pipelines running in production, monitor progress, and troubleshoot issues when needed.
+"""
+document = Document(content=TEXT, type="PLAIN_TEXT")
+# [END howto_operator_gcp_natural_language_document_text]
+
+# [START howto_operator_gcp_natural_language_document_gcs]
+GCS_CONTENT_URI = "gs://my-text-bucket/sentiment-me.txt"
+document_gcs = Document(gcs_content_uri=GCS_CONTENT_URI, type="PLAIN_TEXT")
+# [END howto_operator_gcp_natural_language_document_gcs]
+
+
+default_args = {"start_date": airflow.utils.dates.days_ago(1)}
+
+with models.DAG(
+    "example_gcp_natural_language",
+    default_args=default_args,
+    schedule_interval=None,  # Override to match your needs
+) as dag:
+
+    # [START howto_operator_gcp_natural_language_analyze_entities]
+    analyze_entities = CloudLanguageAnalyzeEntitiesOperator(document=document, task_id="analyze_entities")
+    # [END howto_operator_gcp_natural_language_analyze_entities]
+
+    # [START howto_operator_gcp_natural_language_analyze_entities_result]
+    analyze_entities_result = BashOperator(
+        bash_command="echo \"{{ task_instance.xcom_pull('analyze_entities') }}\"",
+        task_id="analyze_entities_result",
+    )
+    # [END howto_operator_gcp_natural_language_analyze_entities_result]
+
+    # [START howto_operator_gcp_natural_language_analyze_entity_sentiment]
+    analyze_entity_sentiment = CloudLanguageAnalyzeEntitySentimentOperator(
+        document=document, task_id="analyze_entity_sentiment"
+    )
+    # [END howto_operator_gcp_natural_language_analyze_entity_sentiment]
+
+    # [START howto_operator_gcp_natural_language_analyze_entity_sentiment_result]
+    analyze_entity_sentiment_result = BashOperator(
+        bash_command="echo \"{{ task_instance.xcom_pull('analyze_entity_sentiment') }}\"",
+        task_id="analyze_entity_sentiment_result",
+    )
+    # [END howto_operator_gcp_natural_language_analyze_entity_sentiment_result]
+
+    # [START howto_operator_gcp_natural_language_analyze_sentiment]
+    analyze_sentiment = CloudLanguageAnalyzeSentimentOperator(document=document, task_id="analyze_sentiment")
+    # [END howto_operator_gcp_natural_language_analyze_sentiment]
+
+    # [START howto_operator_gcp_natural_language_analyze_sentiment_result]
+    analyze_sentiment_result = BashOperator(
+        bash_command="echo \"{{ task_instance.xcom_pull('analyze_sentiment') }}\"",
+        task_id="analyze_sentiment_result",
+    )
+    # [END howto_operator_gcp_natural_language_analyze_sentiment_result]
+
+    # [START howto_operator_gcp_natural_language_analyze_classify_text]
+    analyze_classify_text = CloudLanguageClassifyTextOperator(
+        document=document, task_id="analyze_classify_text"
+    )
+    # [END howto_operator_gcp_natural_language_analyze_classify_text]
+
+    # [START howto_operator_gcp_natural_language_analyze_classify_text_result]
+    analyze_classify_text_result = BashOperator(
+        bash_command="echo \"{{ task_instance.xcom_pull('analyze_classify_text') }}\"",
+        task_id="analyze_classify_text_result",
+    )
+    # [END howto_operator_gcp_natural_language_analyze_classify_text_result]
+
+    analyze_entities >> analyze_entities_result
+    analyze_entity_sentiment >> analyze_entity_sentiment_result
+    analyze_sentiment >> analyze_sentiment_result
+    analyze_classify_text >> analyze_classify_text_result
diff --git a/airflow/contrib/hooks/gcp_api_base_hook.py b/airflow/contrib/hooks/gcp_api_base_hook.py
index 53b31cff56c35..db8f7de05e246 100644
--- a/airflow/contrib/hooks/gcp_api_base_hook.py
+++ b/airflow/contrib/hooks/gcp_api_base_hook.py
@@ -168,6 +168,7 @@ def catch_http_exception(func):
         Function decorator that intercepts HTTP Errors and raises AirflowException
         with more informative message.
         """
+
         @functools.wraps(func)
         def wrapper_decorator(self, *args, **kwargs):
             try:
@@ -187,6 +188,7 @@ def wrapper_decorator(self, *args, **kwargs):
             except HttpError as e:
                 self.log.error('The request failed:\n%s', str(e))
                 raise AirflowException(e)
+
         return wrapper_decorator
 
     @staticmethod
diff --git a/airflow/contrib/hooks/gcp_natural_language_hook.py b/airflow/contrib/hooks/gcp_natural_language_hook.py
new file mode 100644
index 0000000000000..c5fc935854256
--- /dev/null
+++ b/airflow/contrib/hooks/gcp_natural_language_hook.py
@@ -0,0 +1,217 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+from google.cloud.language_v1 import LanguageServiceClient
+
+
+from airflow.contrib.hooks.gcp_api_base_hook import GoogleCloudBaseHook
+
+
+# noinspection PyAbstractClass
+class CloudNaturalLanguageHook(GoogleCloudBaseHook):
+    """
+    Hook for Google Cloud Natural Language Service.
+
+    :param gcp_conn_id: The connection ID to use when fetching connection info.
+    :type gcp_conn_id: str
+    :param delegate_to: The account to impersonate, if any.
+        For this to work, the service account making the request must have
+        domain-wide delegation enabled.
+    :type delegate_to: str
+    """
+
+    _conn = None
+
+    def __init__(self, gcp_conn_id="google_cloud_default", delegate_to=None):
+        super(CloudNaturalLanguageHook, self).__init__(gcp_conn_id, delegate_to)
+
+    def get_conn(self):
+        """
+        Retrieves connection to Cloud Natural Language service.
+
+        :return: Cloud Natural Language service object
+        :rtype: google.cloud.language_v1.LanguageServiceClient
+        """
+        if not self._conn:
+            self._conn = LanguageServiceClient(credentials=self._get_credentials())
+        return self._conn
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def analyze_entities(self, document, encoding_type=None, retry=None, timeout=None, metadata=None):
+        """
+        Finds named entities in the text along with entity types,
+        salience, mentions for each entity, and other properties.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or class google.cloud.language_v1.types.Document
+        :param encoding_type: The encoding type used by the API to calculate offsets.
+        :type encoding_type: google.cloud.language_v1.types.EncodingType
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+        """
+        client = self.get_conn()
+
+        return client.analyze_entities(
+            document=document, encoding_type=encoding_type, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def analyze_entity_sentiment(self, document, encoding_type=None, retry=None, timeout=None, metadata=None):
+        """
+        Finds entities, similar to AnalyzeEntities in the text and analyzes sentiment associated with each
+        entity and its mentions.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or class google.cloud.language_v1.types.Document
+        :param encoding_type: The encoding type used by the API to calculate offsets.
+        :type encoding_type: google.cloud.language_v1.types.EncodingType
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+        """
+        client = self.get_conn()
+
+        return client.analyze_entity_sentiment(
+            document=document, encoding_type=encoding_type, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def analyze_sentiment(self, document, encoding_type=None, retry=None, timeout=None, metadata=None):
+        """
+        Analyzes the sentiment of the provided text.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or class google.cloud.language_v1.types.Document
+        :param encoding_type: The encoding type used by the API to calculate offsets.
+        :type encoding_type: google.cloud.language_v1.types.EncodingType
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+        """
+        client = self.get_conn()
+
+        return client.analyze_sentiment(
+            document=document, encoding_type=encoding_type, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def analyze_syntax(self, document, encoding_type=None, retry=None, timeout=None, metadata=None):
+        """
+        Analyzes the syntax of the text and provides sentence boundaries and tokenization along with part
+        of speech tags, dependency trees, and other properties.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or class google.cloud.language_v1.types.Document#
+        :param encoding_type: The encoding type used by the API to calculate offsets.
+        :type encoding_type: google.cloud.language_v1.types.EncodingType
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnalyzeSyntaxResponse
+        """
+        client = self.get_conn()
+
+        return client.analyze_syntax(
+            document=document, encoding_type=encoding_type, retry=retry, timeout=timeout, metadata=metadata
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def annotate_text(self, document, features, encoding_type=None, retry=None, timeout=None, metadata=None):
+        """
+        A convenience method that provides all the features that analyzeSentiment,
+        analyzeEntities, and analyzeSyntax provide in one call.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or google.cloud.language_v1.types.Document
+        :param features: The enabled features.
+            If a dict is provided, it must be of the same form as the protobuf message Features
+        :type features: dict or google.cloud.language_v1.enums.Features
+        :param encoding_type: The encoding type used by the API to calculate offsets.
+        :type encoding_type: google.cloud.language_v1.types.EncodingType
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnnotateTextResponse
+        """
+        client = self.get_conn()
+
+        return client.annotate_text(
+            document=document,
+            features=features,
+            encoding_type=encoding_type,
+            retry=retry,
+            timeout=timeout,
+            metadata=metadata,
+        )
+
+    @GoogleCloudBaseHook.catch_http_exception
+    def classify_text(self, document, retry=None, timeout=None, metadata=None):
+        """
+        Classifies a document into categories.
+
+        :param document: Input document.
+            If a dict is provided, it must be of the same form as the protobuf message Document
+        :type document: dict or class google.cloud.language_v1.types.Document
+        :param retry: A retry object used to retry requests. If None is specified, requests will not be
+            retried.
+        :type retry: google.api_core.retry.Retry
+        :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+            retry is specified, the timeout applies to each individual attempt.
+        :type timeout: float
+        :param metadata: Additional metadata that is provided to the method.
+        :type metadata: sequence[tuple[str, str]]]
+        :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+        """
+        client = self.get_conn()
+
+        return client.classify_text(document=document, retry=retry, timeout=timeout, metadata=metadata)
diff --git a/airflow/contrib/operators/gcp_natural_language_operator.py b/airflow/contrib/operators/gcp_natural_language_operator.py
new file mode 100644
index 0000000000000..0d47ea461ab10
--- /dev/null
+++ b/airflow/contrib/operators/gcp_natural_language_operator.py
@@ -0,0 +1,262 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from google.protobuf.json_format import MessageToDict
+
+from airflow.contrib.hooks.gcp_natural_language_hook import CloudNaturalLanguageHook
+from airflow.models import BaseOperator
+
+
+class CloudLanguageAnalyzeEntitiesOperator(BaseOperator):
+    """
+    Finds named entities in the text along with entity types,
+    salience, mentions for each entity, and other properties.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudLanguageAnalyzeEntitiesOperator`
+
+    :param document: Input document.
+        If a dict is provided, it must be of the same form as the protobuf message Document
+    :type document: dict or google.cloud.language_v1.types.Document
+    :param encoding_type: The encoding type used by the API to calculate offsets.
+    :type encoding_type: google.cloud.language_v1.types.EncodingType
+    :param retry: A retry object used to retry requests. If None is specified, requests will not be
+        retried.
+    :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+        retry is specified, the timeout applies to each individual attempt.
+    :type timeout: float
+    :param metadata: Additional metadata that is provided to the method.
+    :type metadata: seq[tuple[str, str]]]
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START natural_langauge_analyze_entities_template_fields]
+    template_fields = ("document", "gcp_conn_id")
+    # [END natural_langauge_analyze_entities_template_fields]
+
+    def __init__(
+        self,
+        document,
+        encoding_type=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudLanguageAnalyzeEntitiesOperator, self).__init__(*args, **kwargs)
+        self.document = document
+        self.encoding_type = encoding_type
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudNaturalLanguageHook(gcp_conn_id=self.gcp_conn_id)
+
+        self.log.info("Start analyzing entities")
+        response = hook.analyze_entities(
+            document=self.document, retry=self.retry, timeout=self.timeout, metadata=self.metadata
+        )
+        self.log.info("Finished analyzing entities")
+
+        return MessageToDict(response)
+
+
+class CloudLanguageAnalyzeEntitySentimentOperator(BaseOperator):
+    """
+    Finds entities, similar to AnalyzeEntities in the text and analyzes sentiment associated with each
+    entity and its mentions.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudLanguageAnalyzeEntitySentimentOperator`
+
+    :param document: Input document.
+        If a dict is provided, it must be of the same form as the protobuf message Document
+    :type document: dict or google.cloud.language_v1.types.Document
+    :param encoding_type: The encoding type used by the API to calculate offsets.
+    :type encoding_type: google.cloud.language_v1.types.EncodingType
+    :param retry: A retry object used to retry requests. If None is specified, requests will not be
+        retried.
+    :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+        retry is specified, the timeout applies to each individual attempt.
+    :type timeout: float
+    :param metadata: Additional metadata that is provided to the method.
+    :type metadata: seq[tuple[str, str]]]
+    :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START natural_langauge_analyze_entity_sentiment_template_fields]
+    template_fields = ("document", "gcp_conn_id")
+    # [END natural_langauge_analyze_entity_sentiment_template_fields]
+
+    def __init__(
+        self,
+        document,
+        encoding_type=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudLanguageAnalyzeEntitySentimentOperator, self).__init__(*args, **kwargs)
+        self.document = document
+        self.encoding_type = encoding_type
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudNaturalLanguageHook(gcp_conn_id=self.gcp_conn_id)
+
+        self.log.info("Start entity sentiment analyze")
+        response = hook.analyze_entity_sentiment(
+            document=self.document,
+            encoding_type=self.encoding_type,
+            retry=self.retry,
+            timeout=self.timeout,
+            metadata=self.metadata,
+        )
+        self.log.info("Finished entity sentiment analyze")
+
+        return MessageToDict(response)
+
+
+class CloudLanguageAnalyzeSentimentOperator(BaseOperator):
+    """
+    Analyzes the sentiment of the provided text.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudLanguageAnalyzeSentimentOperator`
+
+    :param document: Input document.
+        If a dict is provided, it must be of the same form as the protobuf message Document
+    :type document: dict or google.cloud.language_v1.types.Document
+    :param encoding_type: The encoding type used by the API to calculate offsets.
+    :type encoding_type: google.cloud.language_v1.types.EncodingType
+    :param retry: A retry object used to retry requests. If None is specified, requests will not be
+        retried.
+    :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+        retry is specified, the timeout applies to each individual attempt.
+    :type timeout: float
+    :param metadata: Additional metadata that is provided to the method.
+    :type metadata: sequence[tuple[str, str]]]
+    :rtype: google.cloud.language_v1.types.AnalyzeEntitiesResponse
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START natural_langauge_analyze_sentiment_template_fields]
+    template_fields = ("document", "gcp_conn_id")
+    # [END natural_langauge_analyze_sentiment_template_fields]
+
+    def __init__(
+        self,
+        document,
+        encoding_type=None,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudLanguageAnalyzeSentimentOperator, self).__init__(*args, **kwargs)
+        self.document = document
+        self.encoding_type = encoding_type
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudNaturalLanguageHook(gcp_conn_id=self.gcp_conn_id)
+
+        self.log.info("Start sentiment analyze")
+        response = hook.analyze_sentiment(
+            document=self.document, retry=self.retry, timeout=self.timeout, metadata=self.metadata
+        )
+        self.log.info("Finished sentiment analyze")
+
+        return MessageToDict(response)
+
+
+class CloudLanguageClassifyTextOperator(BaseOperator):
+    """
+    Classifies a document into categories.
+
+    .. seealso::
+        For more information on how to use this operator, take a look at the guide:
+        :ref:`howto/operator:CloudLanguageClassifyTextOperator`
+
+    :param document: Input document.
+        If a dict is provided, it must be of the same form as the protobuf message Document
+    :type document: dict or google.cloud.language_v1.types.Document
+    :param retry: A retry object used to retry requests. If None is specified, requests will not be
+        retried.
+    :param timeout: The amount of time, in seconds, to wait for the request to complete. Note that if
+        retry is specified, the timeout applies to each individual attempt.
+    :type timeout: float
+    :param metadata: Additional metadata that is provided to the method.
+    :type metadata: sequence[tuple[str, str]]]
+    :param gcp_conn_id: The connection ID to use connecting to Google Cloud Platform.
+    :type gcp_conn_id: str
+    """
+
+    # [START natural_langauge_classify_text_template_fields]
+    template_fields = ("document", "gcp_conn_id")
+    # [END natural_langauge_classify_text_template_fields]
+
+    def __init__(
+        self,
+        document,
+        retry=None,
+        timeout=None,
+        metadata=None,
+        gcp_conn_id="google_cloud_default",
+        *args,
+        **kwargs
+    ):
+        super(CloudLanguageClassifyTextOperator, self).__init__(*args, **kwargs)
+        self.document = document
+        self.retry = retry
+        self.timeout = timeout
+        self.metadata = metadata
+        self.gcp_conn_id = gcp_conn_id
+
+    def execute(self, context):
+        hook = CloudNaturalLanguageHook(gcp_conn_id=self.gcp_conn_id)
+
+        self.log.info("Start text classify")
+        response = hook.classify_text(
+            document=self.document, retry=self.retry, timeout=self.timeout, metadata=self.metadata
+        )
+        self.log.info("Finished text classify")
+
+        return MessageToDict(response)
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 7be294b447949..93fe3bd177809 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -392,6 +392,8 @@ could take thousands of tasks without a problem), or from an environment
 perspective (you want a worker running from within the Spark cluster
 itself because it needs a very specific environment and security rights).
 
+.. _concepts:xcom:
+
 XComs
 =====
 
diff --git a/docs/conf.py b/docs/conf.py
index ef8098b5a228d..dcc409764907e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -117,6 +117,7 @@
     'sphinx.ext.intersphinx',
     'autoapi.extension',
     'exampleinclude',
+    'docroles'
 ]
 
 autodoc_default_flags = ['show-inheritance', 'members']
@@ -195,8 +196,8 @@
     '_api/airflow/www',
     '_api/airflow/www_rbac',
     '_api/main',
-    '_build',
     'autoapi_templates',
+    'howto/operator/gcp/_partials',
 ]
 
 # The reST default role (used for this markup: `text`) to use for all
diff --git a/docs/exts/docroles.py b/docs/exts/docroles.py
new file mode 100644
index 0000000000000..00f88f1eba2b2
--- /dev/null
+++ b/docs/exts/docroles.py
@@ -0,0 +1,95 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from docutils import nodes, utils
+from sphinx.ext.autodoc.importer import import_module, mock
+from functools import partial
+
+
+class RoleException(Exception):
+    pass
+
+
+def get_template_field(env, fullname):
+    """
+    Gets template fields for specific operator class.
+
+    :param fullname: Full path to operator class.
+        For example: ``airflow.contrib.operators.gcp_vision_operator.CloudVisionProductSetCreateOperator``
+    :return: List of template field
+    :rtype: list[str]
+    """
+    modname, classname = fullname.rsplit(".", 1)
+
+    try:
+        with mock(env.config.autodoc_mock_imports):
+            mod = import_module(modname)
+    except ImportError:
+        raise RoleException("Error loading %s module." % (modname, ))
+
+    clazz = getattr(mod, classname)
+    if not clazz:
+        raise RoleException("Error finding %s class in %s module." % (classname, modname))
+
+    template_fields = getattr(clazz, "template_fields")
+
+    if not template_fields:
+        raise RoleException(
+            "Could not find the template fields for %s class in %s module." % (classname, modname)
+        )
+
+    return list(template_fields)
+
+
+def template_field_role(app, typ, rawtext, text, lineno, inliner, options={}, content=[]):
+    """
+    A role that allows you to include a list of template fields in the middle of the text. This is especially
+    useful when writing guides describing how to use the operator.
+    The result is a list of fields where each field is shorted in the literal block.
+
+    Sample usage::
+
+    :template-fields:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeSentimentOperator`
+
+    For further information look at:
+
+    * [http://docutils.sourceforge.net/docs/howto/rst-roles.html](Creating reStructuredText Interpreted
+      Text Roles)
+    """
+    text = utils.unescape(text)
+
+    try:
+        template_fields = get_template_field(app.env, text)
+    except RoleException as e:
+        msg = inliner.reporter.error("invalid class name %s \n%s" % (text, e, ), line=lineno)
+        prb = inliner.problematic(rawtext, rawtext, msg)
+        return [prb], [msg]
+
+    node = nodes.inline(rawtext=rawtext)
+    for i, field in enumerate(template_fields):
+        if i != 0:
+            node += nodes.Text(", ")
+        node += nodes.literal(field, "", nodes.Text(field))
+
+    return [node], []
+
+
+def setup(app):
+    from docutils.parsers.rst import roles
+    roles.register_local_role("template-fields", partial(template_field_role, app))
+
+    return {"version": "builtin", "parallel_read_safe": True, "parallel_write_safe": True}
diff --git a/docs/howto/operator/gcp/_partials/prerequisite_tasks.rst b/docs/howto/operator/gcp/_partials/prerequisite_tasks.rst
new file mode 100644
index 0000000000000..7af9287da4ac5
--- /dev/null
+++ b/docs/howto/operator/gcp/_partials/prerequisite_tasks.rst
@@ -0,0 +1,31 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+To use these operators, you must do a few things:
+
+  * Select or create a Cloud Platform project using `Cloud Console <https://console.cloud.google.com/project>`__.
+  * Enable billing for your project, as described in `Google Cloud documentation <https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project>`__.
+  * Enable API, as described in `Cloud Console documentation <https://cloud.google.com/apis/docs/enable-disable-apis>`__.
+  * Install API libraries via **pip**.
+
+    .. code-block:: bash
+
+      pip install 'apache-airflow[gcp]'
+
+    Detailed information is available :doc:`../../../../installation`
+
+  * :doc:`Setup Connection <../../connection/gcp>`.
diff --git a/docs/howto/operator/gcp/natural_language.rst b/docs/howto/operator/gcp/natural_language.rst
new file mode 100644
index 0000000000000..06ccfadf78203
--- /dev/null
+++ b/docs/howto/operator/gcp/natural_language.rst
@@ -0,0 +1,180 @@
+..  Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+..    http://www.apache.org/licenses/LICENSE-2.0
+
+..  Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+Google Cloud Natural Language Operators
+=======================================
+
+The `Google Cloud Natural Language <https://cloud.google.com/natural-language/>`__
+can be used to reveal the structure and meaning of text via powerful machine
+learning models. You can use it to extract information about people, places,
+events and much more, mentioned in text documents, news articles or blog posts.
+You can use it to understand sentiment about your product on social media or
+parse intent from customer conversations happening in a call center or a
+messaging app.
+
+.. contents::
+  :depth: 1
+  :local:
+
+Prerequisite Tasks
+^^^^^^^^^^^^^^^^^^
+
+.. include:: _partials/prerequisite_tasks.rst
+
+
+.. _howto/operator:CloudNaturalLanguageDocuments:
+
+Documents
+^^^^^^^^^
+
+Each operator uses a :class:`~google.cloud.language_v1.types.Document` for
+representing text.
+
+Here is an example of document with text provided as a string:
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :start-after: [START howto_operator_gcp_natural_language_document_text]
+    :end-before: [END howto_operator_gcp_natural_language_document_text]
+
+In addition to supplying string, a document can refer to content stored in Google Cloud Storage.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :start-after: [START howto_operator_gcp_natural_language_document_gcs]
+    :end-before: [END howto_operator_gcp_natural_language_document_gcs]
+
+.. _howto/operator:CloudLanguageAnalyzeEntitiesOperator:
+
+Analyzing Entities
+^^^^^^^^^^^^^^^^^^
+
+Entity Analysis inspects the given text for known entities (proper nouns such as
+public figures, landmarks, etc.), and returns information about those entities.
+Entity analysis is performed with the
+:class:`~airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntitiesOperator` operator.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_entities]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_entities]
+
+You can use :ref:`Jinja templating <jinja-templating>` with
+:template-fields:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntitiesOperator`
+parameters which allows you to dynamically determine values. The result is saved to :ref:`XCom <concepts:xcom>`, which allows it
+to be used by other operators.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_entities_result]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_entities_result]
+
+.. _howto/operator:CloudLanguageAnalyzeEntitySentimentOperator:
+
+Analyzing Entity Sentiment
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Sentiment Analysis inspects the given text and identifies the prevailing
+emotional opinion within the text, especially to determine a writer's attitude
+as positive, negative, or neutral. Sentiment analysis is performed through
+the :class:`~airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntitySentimentOperator`
+operator.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_entity_sentiment]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_entity_sentiment]
+
+You can use :ref:`Jinja templating <jinja-templating>` with
+:template-fields:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntitiesOperator`
+parameters which allows you to dynamically determine values. The result is saved to :ref:`XCom <concepts:xcom>`, which allows it
+to be used by other operators.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_entity_sentiment_result]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_entity_sentiment_result]
+
+.. _howto/operator:CloudLanguageAnalyzeSentimentOperator:
+
+Analyzing Sentiment
+^^^^^^^^^^^^^^^^^^^
+
+Sentiment Analysis inspects the given text and identifies the prevailing
+emotional opinion within the text, especially to determine a writer's
+attitude as positive, negative, or neutral. Sentiment analysis is performed
+through the
+:class:`~airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeSentimentOperator`
+operator.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_sentiment]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_sentiment]
+
+You can use :ref:`Jinja templating <jinja-templating>` with
+:template-fields:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeSentimentOperator`
+parameters which allows you to dynamically determine values. The result is saved to :ref:`XCom <concepts:xcom>`, which allows it
+to be used by other operators.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_sentiment_result]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_sentiment_result]
+
+.. _howto/operator:CloudLanguageClassifyTextOperator:
+
+Classifying Content
+^^^^^^^^^^^^^^^^^^^
+
+Content Classification analyzes a document and returns a list of content
+categories that apply to the text found in the document. To classify the
+content in a document, use the
+:class:`~airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageClassifyTextOperator`
+operator.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_classify_text]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_classify_text]
+
+You can use :ref:`Jinja templating <jinja-templating>` with
+:template-fields:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageClassifyTextOperator`
+parameters which allows you to dynamically determine values. The result is saved to :ref:`XCom <concepts:xcom>`, which allows it
+to be used by other operators.
+
+.. exampleinclude:: ../../../../airflow/contrib/example_dags/example_gcp_natural_language.py
+    :language: python
+    :dedent: 4
+    :start-after: [START howto_operator_gcp_natural_language_analyze_classify_text_result]
+    :end-before: [END howto_operator_gcp_natural_language_analyze_classify_text_result]
+
+
+Reference
+^^^^^^^^^
+
+For further information, look at:
+
+* `Client Library Documentation <https://googleapis.github.io/google-cloud-python/latest/language/index.html>`__
+* `Product Documentation <https://cloud.google.com/natural-language/docs/>`__
diff --git a/docs/integration.rst b/docs/integration.rst
index 67a7f56ffd9c9..f172b00e67e9e 100644
--- a/docs/integration.rst
+++ b/docs/integration.rst
@@ -672,6 +672,26 @@ Google Kubernetes Engine
 They also use :class:`airflow.contrib.hooks.gcp_container_hook.GKEClusterHook` to communicate with Google Cloud Platform.
 
 
+Google Natural Language
+'''''''''''''''''''''''
+
+:class:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntities`
+    Finds named entities (currently proper names and common nouns) in the text along with entity types,
+    salience, mentions for each entity, and other properties.
+
+:class:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeEntitySentiment`
+    Finds entities, similar to AnalyzeEntities in the text and analyzes sentiment associated with each
+    entity and its mentions.
+
+:class:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageAnalyzeSentiment`
+    Analyzes the sentiment of the provided text.
+
+:class:`airflow.contrib.operators.gcp_natural_language_operator.CloudLanguageClassifyTextOperator`
+    Classifies a document into categories.
+
+They also use :class:`airflow.contrib.hooks.gcp_natural_language_operator.CloudNaturalLanguageHook` to communicate with Google Cloud Platform.
+
+
 .. _Qubole:
 
 Qubole
diff --git a/setup.py b/setup.py
index 6fed3dd7179ac..c5c99e51bb7c8 100644
--- a/setup.py
+++ b/setup.py
@@ -172,18 +172,19 @@ def write_version(filename=os.path.join(*['airflow',
 ]
 emr = ['boto3>=1.0.0, <1.8.0']
 gcp_api = [
-    'httplib2>=0.9.2',
     'google-api-python-client>=1.6.0, <2.0.0dev',
-    'google-auth>=1.0.0, <2.0.0dev',
     'google-auth-httplib2>=0.0.1',
-    'google-cloud-container>=0.1.1',
+    'google-auth>=1.0.0, <2.0.0dev',
     'google-cloud-bigtable==0.31.0',
+    'google-cloud-container>=0.1.1',
+    'google-cloud-language>=1.1.1',
     'google-cloud-spanner>=1.7.1',
     'google-cloud-translate>=1.3.3',
     'google-cloud-vision>=0.35.2',
     'grpcio-gcp>=0.2.2',
+    'httplib2~=0.9.2',
+    'pandas-gbq',
     'PyOpenSSL',
-    'pandas-gbq'
 ]
 flask_oauth = [
     'Flask-OAuthlib>=0.9.1',
diff --git a/tests/contrib/hooks/test_gcp_natural_language_hook.py b/tests/contrib/hooks/test_gcp_natural_language_hook.py
new file mode 100644
index 0000000000000..33b03dea96cac
--- /dev/null
+++ b/tests/contrib/hooks/test_gcp_natural_language_hook.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import unittest
+from typing import Dict, Any
+
+from google.cloud.language_v1.proto.language_service_pb2 import Document
+
+from airflow.contrib.hooks.gcp_natural_language_hook import CloudNaturalLanguageHook
+from tests.compat import mock
+from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id
+
+
+API_RESPONSE = {}  # type: Dict[Any, Any]
+DOCUMENT = Document(
+    content="Airflow is a platform to programmatically author, schedule and monitor workflows."
+)
+ENCODING_TYPE = "UTF32"
+
+
+class TestCloudNaturalLanguageHook(unittest.TestCase):
+    def setUp(self):
+        with mock.patch(
+            "airflow.contrib.hooks." "gcp_api_base_hook.GoogleCloudBaseHook.__init__",
+            new=mock_base_gcp_hook_no_default_project_id,
+        ):
+            self.hook = CloudNaturalLanguageHook(gcp_conn_id="test")
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.analyze_entities.return_value": API_RESPONSE}  # type: ignore
+    )
+    def test_analyze_entities(self, get_conn):
+        result = self.hook.analyze_entities(document=DOCUMENT, encoding_type=ENCODING_TYPE)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.analyze_entities.assert_called_once_with(
+            document=DOCUMENT, encoding_type=ENCODING_TYPE, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.analyze_entity_sentiment.return_value": API_RESPONSE}
+    )
+    def test_analyze_entity_sentiment(self, get_conn):
+        result = self.hook.analyze_entity_sentiment(document=DOCUMENT, encoding_type=ENCODING_TYPE)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.analyze_entity_sentiment.assert_called_once_with(
+            document=DOCUMENT, encoding_type=ENCODING_TYPE, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.analyze_sentiment.return_value": API_RESPONSE}
+    )
+    def test_analyze_sentiment(self, get_conn):
+        result = self.hook.analyze_sentiment(document=DOCUMENT, encoding_type=ENCODING_TYPE)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.analyze_sentiment.assert_called_once_with(
+            document=DOCUMENT, encoding_type=ENCODING_TYPE, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.analyze_syntax.return_value": API_RESPONSE}
+    )
+    def test_analyze_syntax(self, get_conn):
+        result = self.hook.analyze_syntax(document=DOCUMENT, encoding_type=ENCODING_TYPE)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.analyze_syntax.assert_called_once_with(
+            document=DOCUMENT, encoding_type=ENCODING_TYPE, retry=None, timeout=None, metadata=None
+        )
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.annotate_text.return_value": API_RESPONSE}
+    )
+    def test_annotate_text(self, get_conn):
+        result = self.hook.annotate_text(document=DOCUMENT, encoding_type=ENCODING_TYPE, features=None)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.annotate_text.assert_called_once_with(
+            document=DOCUMENT,
+            encoding_type=ENCODING_TYPE,
+            features=None,
+            retry=None,
+            timeout=None,
+            metadata=None,
+        )
+
+    @mock.patch(  # type: ignore
+        "airflow.contrib.hooks.gcp_natural_language_hook.CloudNaturalLanguageHook.get_conn",
+        **{"return_value.classify_text.return_value": API_RESPONSE}
+    )
+    def test_classify_text(self, get_conn):
+        result = self.hook.classify_text(document=DOCUMENT)
+
+        self.assertIs(result, API_RESPONSE)
+
+        get_conn.return_value.classify_text.assert_called_once_with(
+            document=DOCUMENT, retry=None, timeout=None, metadata=None
+        )
diff --git a/tests/contrib/operators/test_gcp_natural_language_operator.py b/tests/contrib/operators/test_gcp_natural_language_operator.py
new file mode 100644
index 0000000000000..ba05c467ca90a
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_natural_language_operator.py
@@ -0,0 +1,84 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+import unittest
+
+from google.cloud.language_v1.proto.language_service_pb2 import (
+    AnalyzeEntitiesResponse,
+    AnalyzeEntitySentimentResponse,
+    AnalyzeSentimentResponse,
+    ClassifyTextResponse,
+    Document,
+)
+
+from airflow.contrib.operators.gcp_natural_language_operator import (
+    CloudLanguageAnalyzeEntitiesOperator,
+    CloudLanguageAnalyzeEntitySentimentOperator,
+    CloudLanguageAnalyzeSentimentOperator,
+    CloudLanguageClassifyTextOperator,
+)
+from tests.compat import patch
+
+
+DOCUMENT = Document(
+    content="Airflow is a platform to programmatically author, schedule and monitor workflows."
+)
+
+CLASSIFY_TEXT_RRESPONSE = ClassifyTextResponse()
+ANALYZE_ENTITIES_RESPONSE = AnalyzeEntitiesResponse()
+ANALYZE_ENTITY_SENTIMENT_RESPONSE = AnalyzeEntitySentimentResponse()
+ANALYZE_SENTIMENT_RESPONSE = AnalyzeSentimentResponse()
+
+ENCODING_TYPE = "UTF32"
+
+
+class CloudLanguageAnalyzeEntitiesOperatorTestCase(unittest.TestCase):
+    @patch("airflow.contrib.operators.gcp_natural_language_operator.CloudNaturalLanguageHook")
+    def test_minimal_green_path(self, hook_mock):
+        hook_mock.return_value.analyze_entities.return_value = ANALYZE_ENTITIES_RESPONSE
+        op = CloudLanguageAnalyzeEntitiesOperator(task_id="task-id", document=DOCUMENT)
+        resp = op.execute({})
+        self.assertEquals(resp, {})
+
+
+class CloudLanguageAnalyzeEntitySentimentOperatorTestCase(unittest.TestCase):
+    @patch("airflow.contrib.operators.gcp_natural_language_operator.CloudNaturalLanguageHook")
+    def test_minimal_green_path(self, hook_mock):
+        hook_mock.return_value.analyze_entity_sentiment.return_value = ANALYZE_ENTITY_SENTIMENT_RESPONSE
+        op = CloudLanguageAnalyzeEntitySentimentOperator(task_id="task-id", document=DOCUMENT)
+        resp = op.execute({})
+        self.assertEquals(resp, {})
+
+
+class CloudLanguageAnalyzeSentimentOperatorTestCase(unittest.TestCase):
+    @patch("airflow.contrib.operators.gcp_natural_language_operator.CloudNaturalLanguageHook")
+    def test_minimal_green_path(self, hook_mock):
+        hook_mock.return_value.analyze_sentiment.return_value = ANALYZE_SENTIMENT_RESPONSE
+        op = CloudLanguageAnalyzeSentimentOperator(task_id="task-id", document=DOCUMENT)
+        resp = op.execute({})
+        self.assertEquals(resp, {})
+
+
+class CloudLanguageClassifyTextOperatorTestCase(unittest.TestCase):
+    @patch("airflow.contrib.operators.gcp_natural_language_operator.CloudNaturalLanguageHook")
+    def test_minimal_green_path(self, hook_mock):
+        hook_mock.return_value.classify_text.return_value = CLASSIFY_TEXT_RRESPONSE
+        op = CloudLanguageClassifyTextOperator(task_id="task-id", document=DOCUMENT)
+        resp = op.execute({})
+        self.assertEquals(resp, {})
diff --git a/tests/contrib/operators/test_gcp_natural_language_operator_system.py b/tests/contrib/operators/test_gcp_natural_language_operator_system.py
new file mode 100644
index 0000000000000..a21519fb5deb9
--- /dev/null
+++ b/tests/contrib/operators/test_gcp_natural_language_operator_system.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+import unittest
+
+from tests.contrib.utils.base_gcp_system_test_case import SKIP_TEST_WARNING, DagGcpSystemTestCase
+from tests.contrib.utils.gcp_authenticator import GCP_AI_KEY
+
+
+@unittest.skipIf(DagGcpSystemTestCase.skip_check(GCP_AI_KEY), SKIP_TEST_WARNING)
+class CloudNaturalLanguageExampleDagsTest(DagGcpSystemTestCase):
+    def __init__(self, method_name="runTest"):
+        super(CloudNaturalLanguageExampleDagsTest, self).__init__(
+            method_name, dag_id="example_gcp_natural_language", gcp_key=GCP_AI_KEY
+        )
+
+    def test_run_example_dagr(self):
+        self._run_dag()

From a440e514c9e06e2601b6fe2bc747968a8a867426 Mon Sep 17 00:00:00 2001
From: al <cmdoptesc@users.noreply.github.com>
Date: Sat, 6 Apr 2019 01:17:26 -0700
Subject: [PATCH 800/808] [AIRFLOW-4232] Add `none_skipped` trigger rule
 (#5032)

Downstream tasks should run as long as their parents are in
`success`, `failed`, or `upstream_failed` states.
---
 airflow/models/__init__.py                  |  2 +-
 airflow/ti_deps/deps/trigger_rule_dep.py    | 11 ++++
 airflow/utils/trigger_rule.py               |  3 +-
 docs/concepts.rst                           |  3 +-
 tests/ti_deps/deps/test_trigger_rule_dep.py | 70 ++++++++++++++++++++-
 tests/utils/test_trigger_rule.py            |  3 +-
 6 files changed, 87 insertions(+), 5 deletions(-)

diff --git a/airflow/models/__init__.py b/airflow/models/__init__.py
index 30d62983a8a9b..702ed7f7e0431 100755
--- a/airflow/models/__init__.py
+++ b/airflow/models/__init__.py
@@ -2066,7 +2066,7 @@ class derived from this one results in the creation of a task object,
     :param trigger_rule: defines the rule by which dependencies are applied
         for the task to get triggered. Options are:
         ``{ all_success | all_failed | all_done | one_success |
-        one_failed | none_failed | dummy}``
+        one_failed | none_failed | none_skipped | dummy}``
         default is ``all_success``. Options can be set as string or
         using the constants defined in the static class
         ``airflow.utils.TriggerRule``
diff --git a/airflow/ti_deps/deps/trigger_rule_dep.py b/airflow/ti_deps/deps/trigger_rule_dep.py
index 71994fc2e0946..833e5f1d5fc34 100644
--- a/airflow/ti_deps/deps/trigger_rule_dep.py
+++ b/airflow/ti_deps/deps/trigger_rule_dep.py
@@ -157,6 +157,9 @@ def _evaluate_trigger_rule(
                     ti.set_state(State.UPSTREAM_FAILED, session)
                 elif skipped == upstream:
                     ti.set_state(State.SKIPPED, session)
+            elif tr == TR.NONE_SKIPPED:
+                if skipped:
+                    ti.set_state(State.SKIPPED, session)
 
         if tr == TR.ONE_SUCCESS:
             if successes <= 0:
@@ -208,6 +211,14 @@ def _evaluate_trigger_rule(
                     "upstream_tasks_state={2}, upstream_task_ids={3}"
                     .format(tr, num_failures, upstream_tasks_state,
                             task.upstream_task_ids))
+        elif tr == TR.NONE_SKIPPED:
+            if skipped > 0:
+                yield self._failing_status(
+                    reason="Task's trigger rule '{0}' requires all upstream "
+                    "tasks to not have been skipped, but found {1} task(s) skipped. "
+                    "upstream_tasks_state={2}, upstream_task_ids={3}"
+                    .format(tr, skipped, upstream_tasks_state,
+                            task.upstream_task_ids))
         else:
             yield self._failing_status(
                 reason="No strategy to evaluate trigger rule '{0}'.".format(tr))
diff --git a/airflow/utils/trigger_rule.py b/airflow/utils/trigger_rule.py
index 81fad6b7bfe76..a1e14c2e61568 100644
--- a/airflow/utils/trigger_rule.py
+++ b/airflow/utils/trigger_rule.py
@@ -29,8 +29,9 @@ class TriggerRule(object):
     ALL_DONE = 'all_done'
     ONE_SUCCESS = 'one_success'
     ONE_FAILED = 'one_failed'
-    DUMMY = 'dummy'
     NONE_FAILED = 'none_failed'
+    NONE_SKIPPED = 'none_skipped'
+    DUMMY = 'dummy'
 
     _ALL_TRIGGER_RULES = set()  # type: Set[str]
 
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 93fe3bd177809..5b1294d9d890a 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -672,6 +672,7 @@ while creating tasks:
 * ``one_failed``: fires as soon as at least one parent has failed, it does not wait for all parents to be done
 * ``one_success``: fires as soon as at least one parent succeeds, it does not wait for all parents to be done
 * ``none_failed``: all parents have not failed (``failed`` or ``upstream_failed``) i.e. all parents have succeeded or been skipped
+* ``none_skipped``: no parent is in a ``skipped`` state, i.e. all parents are in a ``success``, ``failed``, or ``upstream_failed`` state
 * ``dummy``: dependencies are just for show, trigger at will
 
 Note that these can be used in conjunction with ``depends_on_past`` (boolean)
@@ -681,7 +682,7 @@ previous schedule for the task hasn't succeeded.
 One must be aware of the interaction between trigger rules and skipped tasks
 in schedule level. Skipped tasks will cascade through trigger rules 
 ``all_success`` and ``all_failed`` but not ``all_done``, ``one_failed``, ``one_success``,
-``none_failed`` and ``dummy``. 
+``none_failed``, ``none_skipped`` and ``dummy``.
 
 For example, consider the following DAG:
 
diff --git a/tests/ti_deps/deps/test_trigger_rule_dep.py b/tests/ti_deps/deps/test_trigger_rule_dep.py
index 2f3258f810991..c149026944450 100644
--- a/tests/ti_deps/deps/test_trigger_rule_dep.py
+++ b/tests/ti_deps/deps/test_trigger_rule_dep.py
@@ -23,6 +23,7 @@
 from airflow.models import BaseOperator, TaskInstance
 from airflow.utils.trigger_rule import TriggerRule
 from airflow.ti_deps.deps.trigger_rule_dep import TriggerRuleDep
+from airflow.utils.db import create_session
 from airflow.utils.state import State
 
 
@@ -34,7 +35,7 @@ def _get_task_instance(self, trigger_rule=TriggerRule.ALL_SUCCESS,
                             start_date=datetime(2015, 1, 1))
         if upstream_task_ids:
             task._upstream_task_ids.update(upstream_task_ids)
-        return TaskInstance(task=task, state=state, execution_date=None)
+        return TaskInstance(task=task, state=state, execution_date=task.start_date)
 
     def test_no_upstream_tasks(self):
         """
@@ -275,6 +276,73 @@ def test_all_done_tr_failure(self):
         self.assertEqual(len(dep_statuses), 1)
         self.assertFalse(dep_statuses[0].passed)
 
+    def test_none_skipped_tr_success(self):
+        """
+        None-skipped trigger rule success
+        """
+
+        ti = self._get_task_instance(TriggerRule.NONE_SKIPPED,
+                                     upstream_task_ids=["FakeTaskID",
+                                                        "OtherFakeTaskID",
+                                                        "FailedFakeTaskID"])
+        with create_session() as session:
+            dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+                ti=ti,
+                successes=2,
+                skipped=0,
+                failed=1,
+                upstream_failed=0,
+                done=3,
+                flag_upstream_failed=False,
+                session=session))
+            self.assertEqual(len(dep_statuses), 0)
+
+            # with `flag_upstream_failed` set to True
+            dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+                ti=ti,
+                successes=0,
+                skipped=0,
+                failed=3,
+                upstream_failed=0,
+                done=3,
+                flag_upstream_failed=True,
+                session=session))
+            self.assertEqual(len(dep_statuses), 0)
+
+    def test_none_skipped_tr_failure(self):
+        """
+        None-skipped trigger rule failure
+        """
+        ti = self._get_task_instance(TriggerRule.NONE_SKIPPED,
+                                     upstream_task_ids=["FakeTaskID",
+                                                        "SkippedTaskID"])
+
+        with create_session() as session:
+            dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+                ti=ti,
+                successes=1,
+                skipped=1,
+                failed=0,
+                upstream_failed=0,
+                done=2,
+                flag_upstream_failed=False,
+                session=session))
+            self.assertEqual(len(dep_statuses), 1)
+            self.assertFalse(dep_statuses[0].passed)
+
+            # with `flag_upstream_failed` set to True
+            dep_statuses = tuple(TriggerRuleDep()._evaluate_trigger_rule(
+                ti=ti,
+                successes=1,
+                skipped=1,
+                failed=0,
+                upstream_failed=0,
+                done=2,
+                flag_upstream_failed=True,
+                session=session))
+            self.assertEqual(len(dep_statuses), 1)
+            self.assertFalse(dep_statuses[0].passed)
+
     def test_unknown_tr(self):
         """
         Unknown trigger rules should cause this dep to fail
diff --git a/tests/utils/test_trigger_rule.py b/tests/utils/test_trigger_rule.py
index ab21edd343ced..1167ac8c36edb 100644
--- a/tests/utils/test_trigger_rule.py
+++ b/tests/utils/test_trigger_rule.py
@@ -30,5 +30,6 @@ def test_valid_trigger_rules(self):
         self.assertTrue(TriggerRule.is_valid(TriggerRule.ONE_SUCCESS))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.ONE_FAILED))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.NONE_FAILED))
+        self.assertTrue(TriggerRule.is_valid(TriggerRule.NONE_SKIPPED))
         self.assertTrue(TriggerRule.is_valid(TriggerRule.DUMMY))
-        self.assertEqual(len(TriggerRule.all_triggers()), 7)
+        self.assertEqual(len(TriggerRule.all_triggers()), 8)

From 224c8bd09916825fea7bd18a33f004d86cea0d0a Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 6 Apr 2019 09:19:43 +0100
Subject: [PATCH 801/808] [AIRFLOW-XXX] Version 1.10.3

---
 CHANGELOG.txt      | 324 +++++++++++++++++++++++++++++++++++++++++++++
 airflow/version.py |   2 +-
 2 files changed, 325 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index 0086d93be4aae..fde681b2c34df 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -1,3 +1,327 @@
+Airflow 1.10.3, 2019-04-09
+--------------------------
+
+New Feature
+"""""""""""
+
+- [AIRFLOW-4232] Add ``none_skipped`` trigger rule (#5032)
+- [AIRFLOW-3971] Add Google Cloud Natural Language operators (#4980)
+- [AIRFLOW-4069] Add Opsgenie Alert Hook and Operator (#4903)
+- [AIRFLOW-3552] Fix encoding issue in ImapAttachmentToS3Operator (#5040)
+- [AIRFLOW-3552] Add ImapToS3TransferOperator (#4476)
+- [AIRFLOW-1526] Add dingding hook and operator (#4895)
+- [AIRFLOW-3490] Add BigQueryHook's Ability to Patch Table/View (#4299)
+- [AIRFLOW-3918] Add ssh private-key support to git-sync for KubernetesExecutor (#4777)
+- [AIRFLOW-3659] Create Google Cloud Transfer Service Operators (#4792)
+- [AIRFLOW-3939] Add Google Cloud Translate operator (#4755)
+- [AIRFLOW-3541] Add Avro logical type conversion to bigquery hook (#4553)
+- [AIRFLOW-4106] instrument staving tasks in pool (#4927)
+- [AIRFLOW-2568] Azure Container Instances operator (#4121)
+- [AIRFLOW-4107] instrument executor (#4928)
+- [AIRFLOW-4033] record stats of task duration (#4858)
+- [AIRFLOW-3892] Create Redis pub sub sensor (#4712)
+- [AIRFLOW-4124] add get_table and get_table_location in aws_glue_hook and tests (#4942)
+- [AIRFLOW-1262] Adds missing docs for email configuration (#4557)
+- [AIRFLOW-3701] Add Google Cloud Vision Product Search operators (#4665)
+- [AIRFLOW-3766] Add support for kubernetes annotations (#4589)
+- [AIRFLOW-3741] Add extra config to Oracle hook (#4584)
+- [AIRFLOW-1262] Allow configuration of email alert subject and body (#2338)
+- [AIRFLOW-2985] Operators for S3 object copying/deleting (#3823)
+- [AIRFLOW-2993] s3_to_sftp and sftp_to_s3 operators (#3828)
+- [AIRFLOW-3799] Add compose method to GoogleCloudStorageHook (#4641)
+- [AIRFLOW-3218] add support for poking a whole DAG (#4058)
+- [AIRFLOW-3315] Add ImapAttachmentSensor (#4161)
+- [AIRFLOW-2780] Add IMAP Hook to retrieve email attachments (#4119)
+- [AIRFLOW-3556] Add cross join set dependency function (#4356)
+
+Improvement
+"""""""""""
+
+- [AIRFLOW-3823] Exclude branch's downstream tasks from the tasks to skip (#4666)
+- [AIRFLOW-3274] Add run_as_user and fs_group options for Kubernetes (#4648)
+- [AIRFLOW-4247] Template Region on the DataprocOperators (#5046)
+- [AIRFLOW-4008] add envFrom for Kubernetes Executor (#4952)
+- [AIRFLOW-3947] Flash msg for no DAG-level access error (#4767)
+- [AIRFLOW-3287] Moving database clean-up code into the CoreTest.tearDown() (#4122)
+- [AIRFLOW-4058] Name models test file to get automatically picked up (#4901)
+- [AIRFLOW-3830] Remove DagBag from /dag_details (#4831)
+- [AIRFLOW-3596] Clean up undefined template variables. (#4401)
+- [AIRFLOW-3573] Remove DagStat table (#4378)
+- [AIRFLOW-3623] Fix bugs in Download task logs (#5005)
+- [AIRFLOW-4173] Improve SchedulerJob.process_file() (#4993)
+- [AIRFLOW-3540] Warn if old airflow.cfg file is found (#5006)
+- [AIRFLOW-4000] Return response when no file (#4822)
+- [AIRFLOW-3383] Rotate fernet keys. (#4225)
+- [AIRFLOW-3003] Pull the krb5 image instead of building (#3844)
+- [AIRFLOW-3862] Check types with mypy. (#4685)
+- [AIRFLOW-251] Add option SQL_ALCHEMY_SCHEMA parameter to specify schema for metadata (#4199)
+- [AIRFLOW-1814] Temple PythonOperator {op_args,op_kwargs} fields (#4691)
+- [AIRFLOW-3730] Standarization use of logs mechanisms (#4556)
+- [AIRFLOW-3770] Validation of documentation on CI] (#4593)
+- [AIRFLOW-3866] Run docker-compose pull silently in CI (#4688)
+- [AIRFLOW-3685] Move licence header check (#4497)
+- [AIRFLOW-3670] Add stages to Travis build (#4477)
+- [AIRFLOW-3937] KubernetesPodOperator support for envFrom configMapRef and secretRef (#4772)
+- [AIRFLOW-3408] Remove outdated info from Systemd Instructions (#4269)
+- [AIRFLOW-3202] add missing documentation for AWS hooks/operator (#4048)
+- [AIRFLOW-3908] Add more Google Cloud Vision operators (#4791)
+- [AIRFLOW-2915] Add example DAG for GoogleCloudStorageToBigQueryOperator (#3763)
+- [AIRFLOW-3062] Add Qubole in integration docs (#3946)
+- [AIRFLOW-3288] Add SNS integration (#4123)
+- [AIRFLOW-3148] Remove unnecessary arg "parameters" in RedshiftToS3Transfer (#3995)
+- [AIRFLOW-3049] Add extra operations for Mongo hook (#3890)
+- [AIRFLOW-3559] Add missing options to DatadogHook. (#4362)
+- [AIRFLOW-1191] Simplify override of spark submit command. (#4360)
+- [AIRFLOW-3155] Add ability to filter by a last modified time in GCS Operator (#4008)
+- [AIRFLOW-2864] Fix docstrings for SubDagOperator (#3712)
+- [AIRFLOW-4062] Improve docs on install extra package commands (#4966)
+- [AIRFLOW-3743] Unify different methods of working out AIRFLOW_HOME (#4705)
+- [AIRFLOW-4002] Option to open debugger on errors in `airflow test`. (#4828)
+- [AIRFLOW-3997] Extend Variable.get so it can return None when var not found (#4819)
+- [AIRFLOW-4009] Fix docstring issue in GCSToBQOperator (#4836)
+- [AIRFLOW-3980] Unify logger (#4804)
+- [AIRFLOW-4076] Correct port type of beeline_default in init_db (#4908)
+- [AIRFLOW-4046] Add validations for poke_interval & timeout for Sensor (#4878)
+- [AIRFLOW-3744] Abandon the use of obsolete aliases of methods (#4568)
+- [AIRFLOW-3865] Add API endpoint to get python code of dag by id (#4687)
+- [AIRFLOW-3516] Support to create k8 worker pods in batches (#4434)
+- [AIRFLOW-2843] Add flag in ExternalTaskSensor to check if external DAG/task exists (#4547)
+- [AIRFLOW-2224] Add support CSV files in MySqlToGoogleCloudStorageOperator (#4738)
+- [AIRFLOW-3895] GoogleCloudStorageHook/Op create_bucket takes optional resource params (#4717)
+- [AIRFLOW-3950] Improve AirflowSecurityManager.update_admin_perm_view (#4774)
+- [AIRFLOW-4006] Make better use of Set in AirflowSecurityManager (#4833)
+- [AIRFLOW-3917] Specify alternate kube config file/context when running out of cluster (#4859)
+- [AIRFLOW-3911] Change Harvesting DAG parsing results to DEBUG log level (#4729)
+- [AIRFLOW-3584] Use ORM DAGs for index view. (#4390)
+- [AIRFLOW-2821] Refine Doc "Plugins" (#3664)
+- [AIRFLOW-3561] Improve queries (#4368)
+- [AIRFLOW-3600] Remove dagbag from trigger (#4407)
+- [AIRFLOW-3713] Updated documentation for GCP optional project_id (#4541)
+- [AIRFLOW-2767] - Upgrade gunicorn to 19.5.0 to avoid moderate-severity CVE (#4795)
+- [AIRFLOW-3795] provide_context param is now used (#4735)
+- [AIRFLOW-4012]  - Upgrade tabulate to 0.8.3 (#4838)
+- [AIRFLOW-3623] Support download logs by attempts from UI (#4425)
+- [AIRFLOW-2715] Use region setting when launching Dataflow templates (#4139)
+- [AIRFLOW-3932] Update unit tests and documentation for safe mode flag. (#4760)
+- [AIRFLOW-3932] Optionally skip dag discovery heuristic. (#4746)
+- [AIRFLOW-3258] K8S executor environment variables section. (#4627)
+- [AIRFLOW-3931] set network, subnetwork when launching dataflow template (#4744)
+- [AIRFLOW-4095] Add template_fields for S3CopyObjectOperator & S3DeleteObjectsOperator (#4920)
+- [AIRFLOW-2798] Remove needless code from models.py
+- [AIRFLOW-3731] Constrain mysqlclient to <1.4 (#4558)
+- [AIRFLOW-3139] include parameters into log.info in SQL operators, if any (#3986)
+- [AIRFLOW-3174] Refine Docstring for SQL Operators & Hooks (#4043)
+- [AIRFLOW-3933] Fix various typos (#4747)
+- [AIRFLOW-3905] Allow using "parameters" in SqlSensor (#4723)
+- [AIRFLOW-2761] Parallelize enqueue in celery executor (#4234)
+- [AIRFLOW-3540] Respect environment config when looking up config file. (#4340)
+- [AIRFLOW-2156] Parallelize Celery Executor task state fetching (#3830)
+- [AIRFLOW-3702] Add backfill option to run backwards (#4676)
+- [AIRFLOW-3821] Add replicas logic to GCP SQL example DAG (#4662)
+- [AIRFLOW-3547] Fixed Jinja templating in SparkSubmitOperator (#4347)
+- [AIRFLOW-3647] Add archives config option to SparkSubmitOperator (#4467)
+- [AIRFLOW-3802] Updated documentation for HiveServer2Hook (#4647)
+- [AIRFLOW-3817] - Corrected task ids returned by BranchPythonOperator to match the dummy operator ids (#4659)
+- [AIRFLOW-3782] Clarify docs around celery worker_autoscale in default_airflow.cfg (#4609)
+- [AIRFLOW-1945] Add Autoscale config for Celery workers (#3989)
+- [AIRFLOW-3590]: Change log message of executor exit status (#4616)
+- [AIRFLOW-3591] Fix start date, end date, duration for rescheduled tasks (#4502)
+- [AIRFLOW-3709] Validate `allowed_states` for ExternalTaskSensor (#4536)
+- [AIRFLOW-3522] Add support for sending Slack attachments (#4332)
+- [AIRFLOW-3569] Add "Trigger DAG" button in DAG page (/www only) (#4373)
+- [AIRFLOW-3569] Add "Trigger DAG" button in DAG page (/www_rbac only) (#4373)
+- [AIRFLOW-3044] Dataflow operators accept templated job_name param (#3887)
+- [AIRFLOW-3023] Fix docstring datatypes
+- [AIRFLOW-2928] Use uuid4 instead of uuid1 (#3779)
+- [AIRFLOW-2988] Run specifically python2 for dataflow (#3826)
+- [AIRFLOW-3697] Vendorize nvd3 and slugify (#4513)
+- [AIRFLOW-3692] Remove ENV variables to avoid GPL (#4506)
+- [AIRFLOW-3907] Upgrade flask and set cookie security flags. (#4725)
+- [AIRFLOW-3698] Add documentation for AWS Connection (#4514)
+- [AIRFLOW-3616][AIRFLOW-1215] Add aliases for schema with underscore (#4523)
+- [AIRFLOW-3375] Support returning multiple tasks with BranchPythonOperator (#4215)
+- [AIRFLOW-3742] Fix handling of "fallback" for AirflowConfigParsxer.getint/boolean (#4674)
+- [AIRFLOW-3742] Respect the `fallback` arg in airflow.configuration.get (#4567)
+- [AIRFLOW-3789] Fix flake8 3.7 errors. (#4617)
+- [AIRFLOW-3602] Improve ImapHook handling of retrieving no attachments (#4475)
+- [AIRFLOW-3631] Update flake8 and fix lint. (#4436)
+
+Bug fixes
+"""""""""
+
+- [AIRFLOW-4248] Fix 'FileExistsError' makedirs race in file_processor_handler (#5047)
+- [AIRFLOW-4240] State-changing actions should be POST requests (#5039)
+- [AIRFLOW-4246] Flask-Oauthlib needs downstream dependencies pinning due to breaking changes (#5045)
+- [AIRFLOW-3887] Downgrade dagre-d3 to 0.4.18 (#4713)
+- [AIRFLOW-3419] Fix S3Hook.select_key on Python3 (#4970)
+- [AIRFLOW-4127] Correct AzureContainerInstanceHook._get_instance_view's return (#4945)
+- [AIRFLOW-4172] Fix changes for driver class path option in Spark Submit (#4992)
+- [AIRFLOW-3615] Preserve case of UNIX socket paths in Connections (#4591)
+- [AIRFLOW-3417] ECSOperator: pass platformVersion only for FARGATE launch type (#4256)
+- [AIRFLOW-3884] Fixing doc checker, no warnings allowed anymore and fixed the current… (#4702)
+- [AIRFLOW-2652] implement / enhance baseOperator deepcopy
+- [AIRFLOW-4001] Update docs about how to run tests (#4826)
+- [AIRFLOW-3699] Speed up Flake8 (#4515)
+- [AIRFLOW-4160] Fix redirecting of 'Trigger Dag' Button in DAG Page (#4982)
+- [AIRFLOW-3650] Skip running on mysql for the flaky test (#4457)
+- [AIRFLOW-3423] Fix mongo hook to work with anonymous access (#4258)
+- [AIRFLOW-3982] Fix race condition in CI test (#4968)
+- [AIRFLOW-3982] Update DagRun state based on its own tasks (#4808)
+- [AIRFLOW-3737] Kubernetes executor cannot handle long dag/task names (#4636)
+- [AIRFLOW-3945] Stop inserting row when permission views unchanged (#4764)
+- [AIRFLOW-4123] Add Exception handling for _change_state method in K8 Executor (#4941)
+- [AIRFLOW-3771] Minor refactor securityManager (#4594)
+- [AIRFLOW-987] pass kerberos cli args keytab and principal to kerberos.run() (#4238)
+- [AIRFLOW-3736] Allow int value in SqoopOperator.extra_import_options(#4906)
+- [AIRFLOW-4063] Fix exception string in BigQueryHook [2/2] (#4902)
+- [AIRFLOW-4063] Fix exception string in BigQueryHook (#4899)
+- [AIRFLOW-4037] Log response in SimpleHttpOperator even if the response check fails
+- [AIRFLOW-4044] The documentation of `query_params` in `BigQueryOperator` is wrong.  (#4876)
+- [AIRFLOW-4015] Make missing API endpoints available in classic mode
+- [AIRFLOW-3153] Send DAG processing stats to statsd (#4748)
+- [AIRFLOW-2966] Catch ApiException in the Kubernetes Executor (#4209)
+- [AIRFLOW-4129] Escape HTML in generated tooltips (#4950)
+- [AIRFLOW-4070] AirflowException -> log.warning for duplicate task dependencies (#4904)
+- [AIRFLOW-4054] Fix assertEqualIgnoreMultipleSpaces util & add tests (#4886)
+- [AIRFLOW-3239] Fix test recovery further (#4074)
+- [AIRFLOW-4053] Fix KubePodOperator Xcom on Kube 1.13.0 (#4883)
+- [AIRFLOW-2961] Refactor tests.BackfillJobTest.test_backfill_examples test (#3811)
+- [AIRFLOW-3606] Fix Flake8 test & fix the Flake8 errors introduced since Flake8 test was broken (#4415)
+- [AIRFLOW-3543] Fix deletion of DAG with rescheduled tasks (#4646)
+- [AIRFLOW-2548] Output plugin import errors to web UI (#3930)
+- [AIRFLOW-4019] Fix AWS Athena Sensor object has no attribute 'mode' (#4844)
+- [AIRFLOW-3758] Fix circular import in WasbTaskHandler (#4601)
+- [AIRFLOW-3706] Fix tooltip max-width by correcting ordering of CSS files (#4947)
+- [AIRFLOW-4100] Correctly JSON escape data for tree/graph views (#4921)
+- [AIRFLOW-3636] Fix a test introduced in #4425 (#4446)
+- [AIRFLOW-3977] Add examples of trigger rules in doc (#4805)
+- [AIRFLOW-2511] Fix improper failed session commit handling causing deadlocks (#4769)
+- [AIRFLOW-3962] Added graceful handling for creation of dag_run of a dag which doesn't have any task (#4781)
+- [AIRFLOW-3881] Correct to_csv row number (#4699)
+- [AIRFLOW-3875] Simplify SlackWebhookHook code and change docstring (#4696)
+- [AIRFLOW-3733] Don't raise NameError in HQL hook to_csv when no rows returned (#4560)
+- [AIRFLOW-3734] Fix hql not run when partition is None (#4561)
+- [AIRFLOW-3767] Correct bulk insert function (#4773)
+- [AIRFLOW-4087] remove sudo in basetaskrunner on_finish (#4916)
+- [AIRFLOW-3768] Escape search parameter in pagination controls (#4911)
+- [AIRFLOW-4045] Fix hard-coded URLs in FAB-based UI (#4914)
+- [AIRFLOW-3123] Use a stack for DAG context management (#3956)
+- [AIRFLOW-3060] DAG context manager fails to exit properly in certain circumstances
+- [AIRFLOW-3924] Fix try number in alert emails (#4741)
+- [AIRFLOW-4083] Add tests for link generation utils (#4912)
+- [AIRFLOW-2190] Send correct HTTP status for base_url not found (#4910)
+- [AIRFLOW-4015] Add get_dag_runs GET endpoint to "classic" API (#4884)
+- [AIRFLOW-3239] Enable existing CI tests (#4131)
+- [AIRFLOW-1390] Update Alembic to 0.9 (#3935)
+- [AIRFLOW-3885] Fix race condition in scheduler test (#4737)
+- [AIRFLOW-3885] ~10x speed-up of SchedulerJobTest suite (#4730)
+- [AIRFLOW-3780] Fix some incorrect when base_url is used (#4643)
+- [AIRFLOW-3807] Fix Graph View Highlighting of Tasks (#4653)
+- [AIRFLOW-3009] Import Hashable from collection.abc to fix Python 3.7 deprecation warning (#3849)
+- [AIRFLOW-2231] Fix relativedelta DAG schedule_interval (#3174)
+- [AIRFLOW-2641] Fix MySqlToHiveTransfer to handle MySQL DECIMAL correctly
+- [AIRFLOW-3751] Option to allow malformed schemas for LDAP authentication (#4574)
+- [AIRFLOW-2888] Add deprecation path for task_runner config change (#4851)
+- [AIRFLOW-2930] Fix celery excecutor scheduler crash (#3784)
+- [AIRFLOW-2888] Remove shell=True and bash from task launch (#3740)
+- [AIRFLOW-3885] ~2.5x speed-up for backfill tests (#4731)
+- [AIRFLOW-3885] ~20x speed-up of slowest unit test (#4726)
+- [AIRFLOW-2508] Handle non string types in Operators templatized fields (#4292)
+- [AIRFLOW-3792] Fix validation in BQ for useLegacySQL & queryParameters (#4626)
+- [AIRFLOW-3749] Fix Edit Dag Run page when using RBAC (#4613)
+- [AIRFLOW-3801] Fix DagBag collect dags invocation to prevent examples to be loaded (#4677)
+- [AIRFLOW-3774] Register blueprints with RBAC web app (#4598)
+- [AIRFLOW-3719] Handle StopIteration in CloudWatch logs retrieval (#4516)
+- [AIRFLOW-3108] Define get_autocommit method for MsSqlHook (#4525)
+- [AIRFLOW-3074] Add relevant ECS options to ECS operator. (#3908)
+- [AIRFLOW-3353] Upgrade Redis client (#4834)
+- [AIRFLOW-3250] Fix for Redis Hook for not authorised connection calls (#4090)
+- [AIRFLOW-2009] Fix dataflow hook connection-id (#4563)
+- [AIRFLOW-2190] Fix TypeError when returning 404 (#4596)
+- [AIRFLOW-2876] Update Tenacity to 4.12 (#3723)
+- [AIRFLOW-3923] Update flask-admin dependency to 1.5.3 to resolve security vulnerabilities from safety (#4739)
+- [AIRFLOW-3683] Fix formatting of error message for invalid TriggerRule (#4490)
+- [AIRFLOW-2787] Allow is_backfill to handle NULL DagRun.run_id (#3629)
+- [AIRFLOW-3780] Fix some incorrect when base_url is used (#4643)
+- [AIRFLOW-3639] Fix request creation in Jenkins Operator (#4450)
+- [AIRFLOW-3779] Don't install enum34 backport when not needed (#4620)
+- [AIRFLOW-3079] Improve migration scripts to support MSSQL Server (#3964)
+- [AIRFLOW-2735] Use equality, not identity, check for detecting AWS Batch failures[]
+- [AIRFLOW-2706] AWS Batch Operator should use top-level job state to determine status
+- [AIRFLOW-XXX] Fix typo in http_operator.py
+- [AIRFLOW-XXX] Solve lodash security warning (#4820)
+- [AIRFLOW-XXX] Pin version of tornado pulled in by Celery. (#4815)
+- [AIRFLOW-XXX] Upgrade FAB to 1.12.3 (#4694)
+- [AIRFLOW-XXX] Pin pinodb dependency (#4704)
+- [AIRFLOW-XXX] Pin version of Pip in tests to work around pypa/pip#6163 (#4576)
+- [AIRFLOW-XXX] Fix spark submit hook KeyError (#4578)
+- [AIRFLOW-XXX] Pin psycopg2 due to breaking change (#5036)
+- [AIRFLOW-XXX] Pin Sendgrid dep. (#5031)
+- [AIRFLOW-XXX] Fix flaky test - test_execution_unlimited_parallelism (#4988)
+
+Misc/Interal
+""""""""""""
+
+- [AIRFLOW-4144] add description of is_delete_operator_pod (#4943)
+- [AIRFLOW-3476,3477] Move Kube classes out of models.py (#4443)
+- [AIRFLOW-3464] Move SkipMixin out of models.py (#4386)
+- [AIRFLOW-3463] Move Log out of models.py (#4639)
+- [AIRFLOW-3458] Move connection tests (#4680)
+- [AIRFLOW-3461] Move TaskFail out of models.py (#4630)
+- [AIRFLOW-3462] Move TaskReschedule out of models.py (#4618)
+- [AIRFLOW-3474] Move SlaMiss out of models.py (#4608)
+- [AIRFLOW-3475] Move ImportError out of models.py (#4383)
+- [AIRFLOW-3459] Move DagPickle to separate file (#4374)
+- [AIRFLOW-3925] Don't pull docker-images on pretest (#4740)
+- [AIRFLOW-4154] Correct string formatting in jobs.py (#4972)
+- [AIRFLOW-3458] Deprecation path for moving models.Connection
+- [AIRFLOW-3458] Move models.Connection into separate file (#4335)
+- [AIRFLOW-XXX] Remove old/non-test files that nose ignores (#4930)
+
+Doc-only changes
+""""""""""""""""
+
+- [AIRFLOW-3996] Add view source link to included fragments
+- [AIRFLOW-3811] automatic generation of API Reference in docs (#4788)
+- [AIRFLOW-3810] Remove duplicate autoclass directive (#4656)
+- [AIRFLOW-XXX] Mention that statsd must be installed to gather metrics (#5038)
+- [AIRFLOW-XXX] Add contents to cli (#4825)
+- [AIRFLOW-XXX] fix check docs failure on CI (#4998)
+- [AIRFLOW-XXX] Fix syntax docs errors (#4789)
+- [AIRFLOW-XXX] Docs rendering improvement (#4684)
+- [AIRFLOW-XXX] Automatically link Jira/GH on doc's changelog page (#4587)
+- [AIRFLOW-XXX] Mention Oracle in the Extra Packages documentation (#4987)
+- [AIRFLOW-XXX] Drop deprecated sudo option; use default docker compose on Travis. (#4732)
+- [AIRFLOW-XXX] Update kubernetes.rst docs (#3875)
+- [AIRFLOW-XXX] Improvements to formatted content in documentation (#4835)
+- [AIRFLOW-XXX] Add Daniel to committer list (#4961)
+- [AIRFLOW-XXX] Add Xiaodong Deng to committers list
+- [AIRFLOW-XXX] Add history become ASF top level project (#4757)
+- [AIRFLOW-XXX] Move out the examples from integration.rst (#4672)
+- [AIRFLOW-XXX] Extract reverse proxy info to a separate file (#4657)
+- [AIRFLOW-XXX] Reduction of the number of warnings in the documentation (#4585)
+- [AIRFLOW-XXX] Fix GCS Operator docstrings (#4054)
+- [AIRFLOW-XXX] Fix Docstrings in Hooks, Sensors & Operators (#4137)
+- [AIRFLOW-XXX] Split guide for operators to multiple files (#4814)
+- [AIRFLOW-XXX] Split connection guide to multiple files (#4824)
+- [AIRFLOW-XXX] Remove almost all warnings from building docs (#4588)
+- [AIRFLOW-XXX] Add backreference in docs between operator and integration (#4671)
+- [AIRFLOW-XXX] Improve linking to classes (#4655)
+- [AIRFLOW-XXX] Mock optional modules when building docs (#4586)
+- [AIRFLOW-XXX] Update plugin macros documentation (#4971)
+- [AIRFLOW-XXX] Add missing docstring for 'autodetect' in GCS to BQ Operator (#4979)
+- [AIRFLOW-XXX] Add missing GCP operators to Docs (#4260)
+- [AIRFLOW-XXX] Fixing the issue in Documentation (#3756)
+- [AIRFLOW-XXX] Add Hint at user defined macros (#4885)
+- [AIRFLOW-XXX] Correct schedule_interval in Scheduler docs (#4157)
+- [AIRFLOW-XXX] Improve airflow-jira script to make RelManager's life easier (#4857)
+- [AIRFLOW-XXX] Add missing class references to docs (#4644)
+- [AIRFLOW-XXX] Fix typo (#4564)
+- [AIRFLOW-XXX] Add a doc about fab security (#4595)
+- [AIRFLOW-XXX] Speed up DagBagTest cases (#3974)
+- [AIRFLOW-XXX] Reduction of the number of warnings in the documentation (#4585)
+
+
 Airflow 1.10.2, 2019-01-19
 --------------------------
 
diff --git a/airflow/version.py b/airflow/version.py
index 153b1ff2a0e67..b7367c22a47e5 100644
--- a/airflow/version.py
+++ b/airflow/version.py
@@ -18,4 +18,4 @@
 # under the License.
 #
 
-version = '1.10.3b2'
+version = '1.10.3'

From bcd289c63cab225472fb89c1a7ce064b3444a658 Mon Sep 17 00:00:00 2001
From: Jasper Kahn <jakahn@google.com>
Date: Fri, 27 Jul 2018 16:08:32 -0700
Subject: [PATCH 802/808] [AIRFLOW-2563] Fix PigCliHook Python 3 string/bytes
 use

Unit tests added for PigCliHook as well to prevent
future issues.

Closes #3594 from jakahn/master
---
 airflow/hooks/pig_hook.py    |   6 +-
 tests/hooks/test_pig_hook.py | 137 +++++++++++++++++++++++++++++++++++
 2 files changed, 140 insertions(+), 3 deletions(-)
 create mode 100644 tests/hooks/test_pig_hook.py

diff --git a/airflow/hooks/pig_hook.py b/airflow/hooks/pig_hook.py
index fb5ed5b813039..7cb7d70ca413e 100644
--- a/airflow/hooks/pig_hook.py
+++ b/airflow/hooks/pig_hook.py
@@ -55,7 +55,7 @@ def run_cli(self, pig, verbose=True):
 
         with TemporaryDirectory(prefix='airflow_pigop_') as tmp_dir:
             with NamedTemporaryFile(dir=tmp_dir) as f:
-                f.write(pig)
+                f.write(pig.encode('utf-8'))
                 f.flush()
                 fname = f.name
                 pig_bin = 'pig'
@@ -76,8 +76,8 @@ def run_cli(self, pig, verbose=True):
                     close_fds=True)
                 self.sp = sp
                 stdout = ''
-                for line in iter(sp.stdout.readline, ''):
-                    stdout += line
+                for line in iter(sp.stdout.readline, b''):
+                    stdout += line.decode('utf-8')
                     if verbose:
                         self.log.info(line.strip())
                 sp.wait()
diff --git a/tests/hooks/test_pig_hook.py b/tests/hooks/test_pig_hook.py
new file mode 100644
index 0000000000000..c250d2355be60
--- /dev/null
+++ b/tests/hooks/test_pig_hook.py
@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+import unittest
+from airflow.hooks.pig_hook import PigCliHook
+
+try:
+    from unittest import mock
+except ImportError:
+    try:
+        import mock
+    except ImportError:
+        mock = None
+
+
+class TestPigCliHook(unittest.TestCase):
+
+    def setUp(self):
+        super(TestPigCliHook, self).setUp()
+
+        self.extra_dejson = mock.MagicMock()
+        self.extra_dejson.get.return_value = None
+        self.conn = mock.MagicMock()
+        self.conn.extra_dejson = self.extra_dejson
+        conn = self.conn
+
+        class SubPigCliHook(PigCliHook):
+            def get_connection(self, id):
+                return conn
+
+        self.pig_hook = SubPigCliHook
+
+    def test_init(self):
+        self.pig_hook()
+        self.extra_dejson.get.assert_called_with('pig_properties', '')
+
+    @mock.patch('subprocess.Popen')
+    def test_run_cli_success(self, popen_mock):
+        proc_mock = mock.MagicMock()
+        proc_mock.returncode = 0
+        proc_mock.stdout.readline.return_value = b''
+        popen_mock.return_value = proc_mock
+
+        hook = self.pig_hook()
+        stdout = hook.run_cli("")
+
+        self.assertEqual(stdout, "")
+
+    @mock.patch('subprocess.Popen')
+    def test_run_cli_fail(self, popen_mock):
+        proc_mock = mock.MagicMock()
+        proc_mock.returncode = 1
+        proc_mock.stdout.readline.return_value = b''
+        popen_mock.return_value = proc_mock
+
+        hook = self.pig_hook()
+
+        from airflow.exceptions import AirflowException
+        self.assertRaises(AirflowException, hook.run_cli, "")
+
+    @mock.patch('subprocess.Popen')
+    def test_run_cli_with_properties(self, popen_mock):
+        test_properties = "one two"
+
+        proc_mock = mock.MagicMock()
+        proc_mock.returncode = 0
+        proc_mock.stdout.readline.return_value = b''
+        popen_mock.return_value = proc_mock
+
+        hook = self.pig_hook()
+        hook.pig_properties = test_properties
+
+        stdout = hook.run_cli("")
+        self.assertEqual(stdout, "")
+
+        popen_first_arg = popen_mock.call_args[0][0]
+        for pig_prop in test_properties.split():
+            self.assertIn(pig_prop, popen_first_arg)
+
+    @mock.patch('subprocess.Popen')
+    def test_run_cli_verbose(self, popen_mock):
+        test_stdout_lines = [b"one", b"two", b""]
+        test_stdout_strings = [s.decode('utf-8') for s in test_stdout_lines]
+
+        proc_mock = mock.MagicMock()
+        proc_mock.returncode = 0
+        proc_mock.stdout.readline = mock.Mock(side_effect=test_stdout_lines)
+        popen_mock.return_value = proc_mock
+
+        hook = self.pig_hook()
+        stdout = hook.run_cli("", verbose=True)
+
+        self.assertEqual(stdout, "".join(test_stdout_strings))
+
+    def test_kill_no_sp(self):
+        sp_mock = mock.Mock()
+        hook = self.pig_hook()
+        hook.sp = sp_mock
+
+        hook.kill()
+        self.assertFalse(sp_mock.kill.called)
+
+    def test_kill_sp_done(self):
+        sp_mock = mock.Mock()
+        sp_mock.poll.return_value = 0
+
+        hook = self.pig_hook()
+        hook.sp = sp_mock
+
+        hook.kill()
+        self.assertFalse(sp_mock.kill.called)
+
+    def test_kill(self):
+        sp_mock = mock.Mock()
+        sp_mock.poll.return_value = None
+
+        hook = self.pig_hook()
+        hook.sp = sp_mock
+
+        hook.kill()
+        self.assertTrue(sp_mock.kill.called)

From 6f63db1a40bb79079647e0bb54c7a07d249bfa49 Mon Sep 17 00:00:00 2001
From: sakshi2894 <sakshibansal28@gmail.com>
Date: Wed, 29 Aug 2018 14:36:49 +0530
Subject: [PATCH 803/808] [AIRFLOW-2994] Fix command status check in Qubole
 Check operator (#3790)

---
 .../operators/qubole_check_operator.py        |  4 +--
 .../operators/test_qubole_check_operator.py   | 29 ++++++++++++++++++-
 2 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/airflow/contrib/operators/qubole_check_operator.py b/airflow/contrib/operators/qubole_check_operator.py
index bbef16ea10842..73e3a7b15f661 100644
--- a/airflow/contrib/operators/qubole_check_operator.py
+++ b/airflow/contrib/operators/qubole_check_operator.py
@@ -216,11 +216,11 @@ def get_sql_from_qbol_cmd(params):
 def handle_airflow_exception(airflow_exception, hook):
     cmd = hook.cmd
     if cmd is not None:
-        if cmd.is_success:
+        if cmd.is_success(cmd.status):
             qubole_command_results = hook.get_query_results()
             qubole_command_id = cmd.id
             exception_message = '\nQubole Command Id: {qubole_command_id}' \
                                 '\nQubole Command Results:' \
                                 '\n{qubole_command_results}'.format(**locals())
             raise AirflowException(str(airflow_exception) + exception_message)
-    raise AirflowException(airflow_exception.message)
+    raise AirflowException(str(airflow_exception))
diff --git a/tests/contrib/operators/test_qubole_check_operator.py b/tests/contrib/operators/test_qubole_check_operator.py
index 29044827ee6e5..972038005bb79 100644
--- a/tests/contrib/operators/test_qubole_check_operator.py
+++ b/tests/contrib/operators/test_qubole_check_operator.py
@@ -24,6 +24,7 @@
 from airflow.contrib.operators.qubole_check_operator import QuboleValueCheckOperator
 from airflow.contrib.hooks.qubole_check_hook import QuboleCheckHook
 from airflow.contrib.hooks.qubole_hook import QuboleHook
+from qds_sdk.commands import HiveCommand
 
 try:
     from unittest import mock
@@ -80,11 +81,13 @@ def test_execute_pass(self, mock_get_hook):
         mock_hook.get_first.assert_called_with(query)
 
     @mock.patch.object(QuboleValueCheckOperator, 'get_hook')
-    def test_execute_fail(self, mock_get_hook):
+    def test_execute_assertion_fail(self, mock_get_hook):
 
         mock_cmd = mock.Mock()
         mock_cmd.status = 'done'
         mock_cmd.id = 123
+        mock_cmd.is_success = mock.Mock(
+            return_value=HiveCommand.is_success(mock_cmd.status))
 
         mock_hook = mock.Mock()
         mock_hook.get_first.return_value = [11]
@@ -97,6 +100,30 @@ def test_execute_fail(self, mock_get_hook):
                                      'Qubole Command Id: ' + str(mock_cmd.id)):
             operator.execute()
 
+        mock_cmd.is_success.assert_called_with(mock_cmd.status)
+
+    @mock.patch.object(QuboleValueCheckOperator, 'get_hook')
+    def test_execute_assert_query_fail(self, mock_get_hook):
+
+        mock_cmd = mock.Mock()
+        mock_cmd.status = 'error'
+        mock_cmd.id = 123
+        mock_cmd.is_success = mock.Mock(
+            return_value=HiveCommand.is_success(mock_cmd.status))
+
+        mock_hook = mock.Mock()
+        mock_hook.get_first.return_value = [11]
+        mock_hook.cmd = mock_cmd
+        mock_get_hook.return_value = mock_hook
+
+        operator = self.__construct_operator('select value from tab1 limit 1;', 5, 1)
+
+        with self.assertRaises(AirflowException) as cm:
+            operator.execute()
+
+        self.assertNotIn('Qubole Command Id: ', str(cm.exception))
+        mock_cmd.is_success.assert_called_with(mock_cmd.status)
+
     @mock.patch.object(QuboleCheckHook, 'get_query_results')
     @mock.patch.object(QuboleHook, 'execute')
     def test_results_parser_callable(self, mock_execute, mock_get_query_results):

From d48cd67e8ca8cc5517912fe4f1e27572205e1a24 Mon Sep 17 00:00:00 2001
From: Markan Patel <cooltoast@users.noreply.github.com>
Date: Fri, 29 Mar 2019 06:44:14 -0400
Subject: [PATCH 804/808] [AIRFLOW-4120] Modify SchedulerJob.manage_slas to
 respect zero timedelta SLAs (#4939)

Modify SchedulerJob.manage_slas to respect zero timedelta SLAs
---
 airflow/jobs.py    |  5 ++--
 tests/test_jobs.py | 70 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 73 insertions(+), 2 deletions(-)

diff --git a/airflow/jobs.py b/airflow/jobs.py
index d0dda16fb242e..0a403b0818662 100644
--- a/airflow/jobs.py
+++ b/airflow/jobs.py
@@ -31,6 +31,7 @@
 import threading
 import time
 from collections import defaultdict, OrderedDict
+from datetime import timedelta
 from time import sleep
 from typing import Any
 
@@ -627,7 +628,7 @@ def manage_slas(self, dag, session=None):
         Where assuming that the scheduler runs often, so we only check for
         tasks that should have succeeded in the past hour.
         """
-        if not any([ti.sla for ti in dag.tasks]):
+        if not any([isinstance(ti.sla, timedelta) for ti in dag.tasks]):
             self.log.info("Skipping SLA check for %s because no tasks in DAG have SLAs", dag)
             return
 
@@ -656,7 +657,7 @@ def manage_slas(self, dag, session=None):
         for ti in max_tis:
             task = dag.get_task(ti.task_id)
             dttm = ti.execution_date
-            if task.sla:
+            if isinstance(task.sla, timedelta):
                 dttm = dag.following_schedule(dttm)
                 while dttm < timezone.utcnow():
                     following_schedule = dag.following_schedule(dttm)
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 26cc5bca28b02..0c7d0004518e7 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -3073,6 +3073,76 @@ def do_schedule(function, function2):
         self.assertEqual(2, len(executor.queued_tasks))
 
     def test_scheduler_sla_miss_callback(self):
+        """
+        Test that the scheduler calls the sla miss callback
+        """
+        session = settings.Session()
+
+        sla_callback = MagicMock()
+
+        # Create dag with a start of 1 day ago, but an sla of 0
+        # so we'll already have an sla_miss on the books.
+        test_start_date = days_ago(1)
+        dag = DAG(dag_id='test_sla_miss',
+                  sla_miss_callback=sla_callback,
+                  default_args={'start_date': test_start_date,
+                                'sla': datetime.timedelta()})
+
+        task = DummyOperator(task_id='dummy',
+                             dag=dag,
+                             owner='airflow')
+
+        session.merge(models.TaskInstance(task=task,
+                                          execution_date=test_start_date,
+                                          state='success'))
+
+        session.merge(SlaMiss(task_id='dummy',
+                              dag_id='test_sla_miss',
+                              execution_date=test_start_date))
+
+        scheduler = SchedulerJob(dag_id='test_sla_miss',
+                                 num_runs=1)
+        scheduler.manage_slas(dag=dag, session=session)
+
+        sla_callback.assert_called()
+
+    def test_scheduler_sla_miss_callback_invalid_sla(self):
+        """
+        Test that the scheduler does not call the sla miss callback when
+        given an invalid sla
+        """
+        session = settings.Session()
+
+        sla_callback = MagicMock()
+
+        # Create dag with a start of 1 day ago, but an sla of 0
+        # so we'll already have an sla_miss on the books.
+        # Pass anything besides a timedelta object to the sla argument.
+        test_start_date = days_ago(1)
+        dag = DAG(dag_id='test_sla_miss',
+                  sla_miss_callback=sla_callback,
+                  default_args={'start_date': test_start_date,
+                                'sla': None})
+
+        task = DummyOperator(task_id='dummy',
+                             dag=dag,
+                             owner='airflow')
+
+        session.merge(models.TaskInstance(task=task,
+                                          execution_date=test_start_date,
+                                          state='success'))
+
+        session.merge(SlaMiss(task_id='dummy',
+                              dag_id='test_sla_miss',
+                              execution_date=test_start_date))
+
+        scheduler = SchedulerJob(dag_id='test_sla_miss',
+                                 num_runs=1)
+        scheduler.manage_slas(dag=dag, session=session)
+
+        sla_callback.assert_not_called()
+
+    def test_scheduler_sla_miss_callback_sent_notification(self):
         """
         Test that the scheduler does not call the sla_miss_callback when a notification has already been sent
         """

From 1413776826f74d4ecf148353b380936542c3379c Mon Sep 17 00:00:00 2001
From: Joshua Carp <jm.carp@gmail.com>
Date: Fri, 29 Mar 2019 18:03:34 -0400
Subject: [PATCH 805/808] [AIRFLOW-4177] Check types in tests (#4994)

---
 .travis.yml                                   |  2 +-
 setup.py                                      |  2 +-
 tests/__init__.py                             |  4 +--
 tests/cli/test_worker_initialisation.py       | 10 +------
 tests/compat.py                               | 27 ++++++++++++++++++
 .../executors/test_kubernetes_executor.py     |  8 +++---
 .../contrib/executors/test_mesos_executor.py  | 10 ++-----
 .../hooks/test_aws_glue_catalog_hook.py       |  6 +---
 tests/contrib/hooks/test_aws_hook.py          |  9 +-----
 tests/contrib/hooks/test_azure_cosmos_hook.py | 10 +------
 .../hooks/test_azure_data_lake_hook.py        |  9 +-----
 .../hooks/test_azure_fileshare_hook.py        | 10 +------
 tests/contrib/hooks/test_bigquery_hook.py     | 25 +++++++++--------
 tests/contrib/hooks/test_cassandra_hook.py    |  5 ++--
 tests/contrib/hooks/test_databricks_hook.py   |  9 +-----
 tests/contrib/hooks/test_gcp_api_base_hook.py |  8 +-----
 tests/contrib/hooks/test_gcp_bigtable_hook.py |  9 +-----
 tests/contrib/hooks/test_gcp_compute_hook.py  |  9 +-----
 .../contrib/hooks/test_gcp_container_hook.py  |  4 +--
 tests/contrib/hooks/test_gcp_dataflow_hook.py | 10 +------
 tests/contrib/hooks/test_gcp_dataproc_hook.py |  9 +-----
 tests/contrib/hooks/test_gcp_function_hook.py |  9 +-----
 tests/contrib/hooks/test_gcp_kms_hook.py      |  9 +-----
 tests/contrib/hooks/test_gcp_pubsub_hook.py   |  9 +-----
 tests/contrib/hooks/test_gcp_spanner_hook.py  |  9 +-----
 tests/contrib/hooks/test_gcp_sql_hook.py      |  9 +-----
 tests/contrib/hooks/test_gcp_transfer_hook.py |  8 +-----
 .../contrib/hooks/test_gcp_translate_hook.py  |  9 +-----
 tests/contrib/hooks/test_gcp_vision_hook.py   |  9 +-----
 tests/contrib/hooks/test_gcs_hook.py          |  9 +-----
 tests/contrib/hooks/test_imap_hook.py         |  4 +--
 tests/contrib/hooks/test_openfaas_hook.py     |  9 +-----
 tests/contrib/hooks/test_sagemaker_hook.py    |  9 +-----
 tests/contrib/hooks/test_ssh_hook.py          |  9 +-----
 tests/contrib/hooks/test_wasb_hook.py         |  9 +-----
 .../minikube/test_kubernetes_pod_operator.py  |  4 +--
 .../operators/test_adls_list_operator.py      |  9 +-----
 .../operators/test_adls_to_gcs_operator.py    |  9 +-----
 .../operators/test_aws_athena_operator.py     |  9 +-----
 .../operators/test_awsbatch_operator.py       |  9 +-----
 ...test_azure_container_instances_operator.py |  9 +-----
 ...st_azure_cosmos_insertdocument_operator.py | 10 +------
 .../operators/test_bigquery_operator.py       |  9 +-----
 .../operators/test_databricks_operator.py     |  9 +-----
 .../operators/test_dataflow_operator.py       |  9 +-----
 .../operators/test_dataproc_operator.py       | 12 ++------
 tests/contrib/operators/test_ecs_operator.py  |  9 +-----
 tests/contrib/operators/test_file_to_gcs.py   |  9 +-----
 tests/contrib/operators/test_file_to_wasb.py  |  9 +-----
 .../operators/test_gcp_bigtable_operator.py   | 15 +++-------
 .../operators/test_gcp_compute_operator.py    | 10 +------
 .../operators/test_gcp_container_operator.py  |  9 +-----
 .../operators/test_gcp_function_operator.py   | 10 +------
 .../operators/test_gcp_spanner_operator.py    |  9 +-----
 .../operators/test_gcp_sql_operator.py        | 10 +------
 .../test_gcp_sql_operator_system_helper.py    |  9 ------
 .../operators/test_gcp_transfer_operator.py   | 14 +++-------
 .../operators/test_gcp_translate_operator.py  | 10 +------
 .../operators/test_gcp_vision_operator.py     | 11 ++------
 .../operators/test_gcs_acl_operator.py        |  9 +-----
 .../operators/test_gcs_download_operator.py   |  9 +-----
 .../operators/test_gcs_list_operator.py       |  9 +-----
 tests/contrib/operators/test_gcs_operator.py  |  9 +-----
 .../operators/test_gcs_to_gcs_operator.py     |  9 +-----
 .../operators/test_gcs_to_s3_operator.py      |  9 +-----
 .../operators/test_hipchat_operator.py        |  9 +-----
 .../operators/test_jenkins_operator.py        |  9 +-----
 .../operators/test_mongo_to_s3_operator.py    |  9 +-----
 .../operators/test_mysql_to_gcs_operator.py   |  9 +-----
 ...test_oracle_to_azure_data_lake_transfer.py | 10 +------
 .../test_oracle_to_oracle_transfer.py         | 11 +-------
 .../test_postgres_to_gcs_operator.py          |  9 +-----
 .../contrib/operators/test_pubsub_operator.py | 10 +------
 .../operators/test_qubole_check_operator.py   |  9 +-----
 .../contrib/operators/test_qubole_operator.py |  8 ------
 .../operators/test_s3_list_operator.py        |  9 +-----
 .../operators/test_s3_to_gcs_operator.py      |  9 +-----
 .../operators/test_sagemaker_base_operator.py |  7 -----
 ...test_sagemaker_endpoint_config_operator.py |  8 +-----
 .../test_sagemaker_endpoint_operator.py       |  8 +-----
 .../test_sagemaker_model_operator.py          |  8 +-----
 .../test_sagemaker_training_operator.py       |  8 +-----
 .../test_sagemaker_transform_operator.py      |  8 +-----
 .../test_sagemaker_tuning_operator.py         |  8 +-----
 .../operators/test_snowflake_operator.py      |  9 +-----
 .../test_wasb_delete_blob_operator.py         |  9 +-----
 tests/contrib/sensors/test_athena_sensor.py   |  9 +-----
 .../test_aws_glue_catalog_partition_sensor.py |  6 +---
 tests/contrib/sensors/test_datadog_sensor.py  |  6 ++--
 .../sensors/test_gcp_transfer_sensor.py       |  9 +-----
 tests/contrib/sensors/test_pubsub_sensor.py   |  9 +-----
 .../sensors/test_sagemaker_endpoint_sensor.py |  9 +-----
 .../sensors/test_sagemaker_training_sensor.py |  9 +-----
 .../test_sagemaker_transform_sensor.py        |  9 +-----
 .../sensors/test_sagemaker_tuning_sensor.py   |  9 +-----
 tests/contrib/sensors/test_wasb_sensor.py     |  9 +-----
 tests/contrib/utils/test_sendgrid.py          |  9 +-----
 tests/core.py                                 |  4 +--
 tests/executors/test_celery_executor.py       |  2 +-
 tests/hooks/test_dbapi_hook.py                | 28 +++++++++----------
 tests/hooks/test_docker_hook.py               |  9 +-----
 tests/hooks/test_druid_hook.py                |  8 +++---
 tests/hooks/test_hive_hook.py                 |  6 ++--
 tests/hooks/test_http_hook.py                 |  9 +-----
 tests/hooks/test_mysql_hook.py                | 18 ++++++------
 tests/hooks/test_oracle_hook.py               | 26 ++++++++---------
 tests/hooks/test_pig_hook.py                  |  9 +-----
 tests/hooks/test_postgres_hook.py             |  6 ++--
 tests/hooks/test_s3_hook.py                   |  2 +-
 tests/hooks/test_slack_hook.py                |  9 +-----
 tests/lineage/backend/test_atlas.py           |  9 +-----
 tests/lineage/test_lineage.py                 |  9 +-----
 tests/operators/test_check_operator.py        |  9 +-----
 tests/operators/test_docker_operator.py       |  9 +-----
 tests/operators/test_druid_check_operator.py  |  9 +-----
 tests/operators/test_email_operator.py        |  2 +-
 tests/operators/test_http_operator.py         |  7 +----
 tests/operators/test_operators.py             |  4 +--
 .../operators/test_redshift_to_s3_operator.py |  4 +--
 tests/operators/test_s3_to_hive_operator.py   |  8 +-----
 .../operators/test_s3_to_redshift_operator.py |  2 +-
 tests/operators/test_slack_operator.py        |  9 +-----
 tests/security/test_kerberos.py               |  5 +---
 tests/sensors/test_http_sensor.py             |  9 +-----
 tests/test_jobs.py                            | 17 ++++-------
 tests/test_logging_config.py                  |  2 +-
 tests/utils/log/elasticmock/__init__.py       |  5 ++--
 tests/utils/log/test_es_task_handler.py       |  2 +-
 tests/www/test_utils.py                       |  6 ++--
 129 files changed, 235 insertions(+), 906 deletions(-)
 create mode 100644 tests/compat.py

diff --git a/.travis.yml b/.travis.yml
index ff06ee7cc57fe..594bbfd8288af 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -46,7 +46,7 @@ jobs:
     - name: mypy
       stage: pre-test
       install: pip install mypy
-      script: mypy airflow
+      script: mypy airflow tests
     - name: Check license header
       stage: pre-test
       install: skip
diff --git a/setup.py b/setup.py
index c5c99e51bb7c8..006de0ad444a8 100644
--- a/setup.py
+++ b/setup.py
@@ -242,7 +242,7 @@ def write_version(filename=os.path.join(*['airflow',
     'click==6.7',
     'freezegun',
     'jira',
-    'mock',
+    'mock;python_version<"3.3"',
     'mongomock',
     'moto==1.3.5',
     'nose',
diff --git a/tests/__init__.py b/tests/__init__.py
index b8630ce2b40e3..7c1a4fb314ed0 100644
--- a/tests/__init__.py
+++ b/tests/__init__.py
@@ -21,5 +21,5 @@
 
 from __future__ import absolute_import
 
-from .api import *
-from .core import *
+from .api import *  # type: ignore
+from .core import *  # type: ignore
diff --git a/tests/cli/test_worker_initialisation.py b/tests/cli/test_worker_initialisation.py
index d6a8fd4404323..664257d0de4d4 100644
--- a/tests/cli/test_worker_initialisation.py
+++ b/tests/cli/test_worker_initialisation.py
@@ -21,15 +21,7 @@
 import sqlalchemy
 import airflow
 from argparse import Namespace
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-from mock import patch
+from tests.compat import mock, patch
 
 patch('airflow.utils.cli.action_logging', lambda x: x).start()
 from airflow.bin import cli # noqa
diff --git a/tests/compat.py b/tests/compat.py
new file mode 100644
index 0000000000000..8269a0f92aa93
--- /dev/null
+++ b/tests/compat.py
@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+try:
+    from unittest import mock  # noqa: F401
+except ImportError:
+    import mock  # type: ignore  # noqa: F401
+
+patch = mock.patch
+Mock = mock.Mock
+MagicMock = mock.MagicMock
+PropertyMock = mock.PropertyMock
diff --git a/tests/contrib/executors/test_kubernetes_executor.py b/tests/contrib/executors/test_kubernetes_executor.py
index 5ab2b3527a975..9c12d73a48d55 100644
--- a/tests/contrib/executors/test_kubernetes_executor.py
+++ b/tests/contrib/executors/test_kubernetes_executor.py
@@ -18,13 +18,13 @@
 
 import unittest
 import uuid
-import mock
 import re
 import string
 import random
 from urllib3 import HTTPResponse
 from datetime import datetime
 
+from tests.compat import mock
 try:
     from kubernetes.client.rest import ApiException
     from airflow import configuration
@@ -37,7 +37,7 @@
     from airflow.exceptions import AirflowConfigException
     from airflow.contrib.kubernetes.secret import Secret
 except ImportError:
-    AirflowKubernetesScheduler = None
+    AirflowKubernetesScheduler = None  # type: ignore
 
 
 class TestAirflowKubernetesScheduler(unittest.TestCase):
@@ -673,7 +673,7 @@ def test_run_next_exception(self, mock_get_kube_client, mock_kubernetes_job_watc
         kubernetesExecutor.sync()
         kubernetesExecutor.sync()
 
-        mock_kube_client.create_namespaced_pod.assert_called()
+        assert mock_kube_client.create_namespaced_pod.called
         self.assertFalse(kubernetesExecutor.task_queue.empty())
 
         # Disable the ApiException
@@ -681,7 +681,7 @@ def test_run_next_exception(self, mock_get_kube_client, mock_kubernetes_job_watc
 
         # Execute the task without errors should empty the queue
         kubernetesExecutor.sync()
-        mock_kube_client.create_namespaced_pod.assert_called()
+        assert mock_kube_client.create_namespaced_pod.called
         self.assertTrue(kubernetesExecutor.task_queue.empty())
 
 
diff --git a/tests/contrib/executors/test_mesos_executor.py b/tests/contrib/executors/test_mesos_executor.py
index ea3faa208c11a..f3771111f719b 100644
--- a/tests/contrib/executors/test_mesos_executor.py
+++ b/tests/contrib/executors/test_mesos_executor.py
@@ -18,20 +18,14 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 try:
     from mesos.interface import mesos_pb2
     from airflow.contrib.executors.mesos_executor import AirflowMesosScheduler
     mock_mesos = True
 except ImportError:
-    mock_mesos = None
+    mock_mesos = None  # type: ignore
 
 from airflow import configuration
 from queue import Queue
diff --git a/tests/contrib/hooks/test_aws_glue_catalog_hook.py b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
index 96c70bd2642e1..57ec7a1a793d3 100644
--- a/tests/contrib/hooks/test_aws_glue_catalog_hook.py
+++ b/tests/contrib/hooks/test_aws_glue_catalog_hook.py
@@ -20,17 +20,13 @@
 
 import boto3
 from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
+from tests.compat import mock
 
 try:
     from moto import mock_glue
 except ImportError:
     mock_glue = None
 
-try:
-    from unittest import mock
-except ImportError:
-    import mock
-
 DB_NAME = 'db'
 TABLE_NAME = 'table'
 TABLE_INPUT = {
diff --git a/tests/contrib/hooks/test_aws_hook.py b/tests/contrib/hooks/test_aws_hook.py
index f842b44e908ee..61acec69fb446 100644
--- a/tests/contrib/hooks/test_aws_hook.py
+++ b/tests/contrib/hooks/test_aws_hook.py
@@ -25,14 +25,7 @@
 from airflow import configuration
 from airflow.models.connection import Connection
 from airflow.contrib.hooks.aws_hook import AwsHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 try:
     from moto import mock_emr, mock_dynamodb2, mock_sts, mock_iam
diff --git a/tests/contrib/hooks/test_azure_cosmos_hook.py b/tests/contrib/hooks/test_azure_cosmos_hook.py
index 4c926b5d89d2b..8994a61625ed9 100644
--- a/tests/contrib/hooks/test_azure_cosmos_hook.py
+++ b/tests/contrib/hooks/test_azure_cosmos_hook.py
@@ -29,18 +29,10 @@
 from airflow import configuration
 from airflow.models.connection import Connection
 from airflow.utils import db
+from tests.compat import mock
 
 import logging
 
-try:
-    from unittest import mock
-
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 class TestAzureCosmosDbHook(unittest.TestCase):
 
diff --git a/tests/contrib/hooks/test_azure_data_lake_hook.py b/tests/contrib/hooks/test_azure_data_lake_hook.py
index 00ad086813219..107c4e871ad8e 100644
--- a/tests/contrib/hooks/test_azure_data_lake_hook.py
+++ b/tests/contrib/hooks/test_azure_data_lake_hook.py
@@ -25,14 +25,7 @@
 from airflow import configuration
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestAzureDataLakeHook(unittest.TestCase):
diff --git a/tests/contrib/hooks/test_azure_fileshare_hook.py b/tests/contrib/hooks/test_azure_fileshare_hook.py
index 43c075e9463b2..bea3978ccf40c 100644
--- a/tests/contrib/hooks/test_azure_fileshare_hook.py
+++ b/tests/contrib/hooks/test_azure_fileshare_hook.py
@@ -26,15 +26,7 @@
 from airflow.contrib.hooks.azure_fileshare_hook import AzureFileShareHook
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestAzureFileshareHook(unittest.TestCase):
diff --git a/tests/contrib/hooks/test_bigquery_hook.py b/tests/contrib/hooks/test_bigquery_hook.py
index eb548607173c5..e0617cb8e2613 100644
--- a/tests/contrib/hooks/test_bigquery_hook.py
+++ b/tests/contrib/hooks/test_bigquery_hook.py
@@ -20,6 +20,7 @@
 
 import unittest
 import warnings
+from typing import List
 
 from google.auth.exceptions import GoogleAuthError
 import mock
@@ -195,7 +196,7 @@ def test_invalid_source_format(self):
 
 # Helpers to test_cancel_queries that have mock_poll_job_complete returning false,
 # unless mock_job_cancel was called with the same job_id
-mock_canceled_jobs = []
+mock_canceled_jobs = []  # type: List
 
 
 def mock_poll_job_complete(job_id):
@@ -506,7 +507,7 @@ class TestBigQueryCursor(unittest.TestCase):
     def test_execute_with_parameters(self, mocked_rwc):
         hook.BigQueryCursor("test", "test").execute(
             "SELECT %(foo)s", {"foo": "bar"})
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
 
 class TestLabelsInRunJob(unittest.TestCase):
@@ -527,7 +528,7 @@ def run_with_config(config):
             labels={'label1': 'test1', 'label2': 'test2'}
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
 
 class TestDatasetsOperations(unittest.TestCase):
@@ -628,7 +629,7 @@ def run_with_config(config):
             source_uris=[],
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_with_auto_detect(self, run_with_config):
@@ -661,7 +662,7 @@ def run_with_config(config):
             time_partitioning={'type': 'DAY', 'field': 'test_field', 'expirationMs': 1000}
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_query_default(self, mocked_rwc):
@@ -674,7 +675,7 @@ def run_with_config(config):
         bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
         bq_hook.run_query(sql='select 1')
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_query_with_arg(self, mocked_rwc):
@@ -699,7 +700,7 @@ def run_with_config(config):
                                'field': 'test_field', 'expirationMs': 1000}
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     def test_dollar_makes_partition(self):
         tp_out = _cleanse_time_partitioning('test.teast$20170101', {})
@@ -739,7 +740,7 @@ def run_with_config(config):
             source_uris=[],
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_load_with_arg(self, mocked_rwc):
@@ -763,7 +764,7 @@ def run_with_config(config):
             time_partitioning={'type': 'DAY'}
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_query_default(self, mocked_rwc):
@@ -776,7 +777,7 @@ def run_with_config(config):
         bq_hook = hook.BigQueryBaseCursor(mock.Mock(), project_id)
         bq_hook.run_query(sql='select 1')
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
     @mock.patch.object(hook.BigQueryBaseCursor, 'run_with_configuration')
     def test_run_query_with_arg(self, mocked_rwc):
@@ -799,7 +800,7 @@ def run_with_config(config):
             time_partitioning={'type': 'DAY'}
         )
 
-        mocked_rwc.assert_called_once()
+        assert mocked_rwc.call_count == 1
 
 
 class TestBigQueryHookLegacySql(unittest.TestCase):
@@ -834,7 +835,7 @@ def test_location_propagates_properly(self, run_with_config):
                                                 location=None)
             self.assertIsNone(bq_cursor.location)
             bq_cursor.run_query(sql='select 1', location='US')
-            run_with_config.assert_called_once()
+            assert run_with_config.call_count == 1
             self.assertEqual(bq_cursor.location, 'US')
 
 
diff --git a/tests/contrib/hooks/test_cassandra_hook.py b/tests/contrib/hooks/test_cassandra_hook.py
index 687d3169bb2d6..fb48961e53c20 100644
--- a/tests/contrib/hooks/test_cassandra_hook.py
+++ b/tests/contrib/hooks/test_cassandra_hook.py
@@ -18,8 +18,6 @@
 # under the License.
 
 import unittest
-import mock
-from mock import patch
 
 from airflow import configuration
 from airflow.contrib.hooks.cassandra_hook import CassandraHook
@@ -29,6 +27,7 @@
 )
 from airflow.models.connection import Connection
 from airflow.utils import db
+from tests.compat import mock, patch
 
 
 class CassandraHookTest(unittest.TestCase):
@@ -65,7 +64,7 @@ def test_get_conn(self):
             mock_connect.return_value = 'session'
             hook = CassandraHook(cassandra_conn_id='cassandra_test')
             hook.get_conn()
-            mock_getaddrinfo.assert_called()
+            assert mock_getaddrinfo.called
             mock_connect.assert_called_once_with('test_keyspace')
 
             cluster = hook.get_cluster()
diff --git a/tests/contrib/hooks/test_databricks_hook.py b/tests/contrib/hooks/test_databricks_hook.py
index 83b75c9c20e10..e335e21e61fca 100644
--- a/tests/contrib/hooks/test_databricks_hook.py
+++ b/tests/contrib/hooks/test_databricks_hook.py
@@ -33,14 +33,7 @@
 from airflow.exceptions import AirflowException
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'databricks-operator'
 DEFAULT_CONN_ID = 'databricks_default'
diff --git a/tests/contrib/hooks/test_gcp_api_base_hook.py b/tests/contrib/hooks/test_gcp_api_base_hook.py
index 35c95ecc8a04f..19123d1f01712 100644
--- a/tests/contrib/hooks/test_gcp_api_base_hook.py
+++ b/tests/contrib/hooks/test_gcp_api_base_hook.py
@@ -34,18 +34,12 @@
 from google.auth.exceptions import GoogleAuthError
 
 from airflow.hooks.base_hook import BaseHook
+from tests.compat import mock
 
 try:
     from StringIO import StringIO
 except ImportError:
     from io import StringIO
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 
 default_creds_available = True
diff --git a/tests/contrib/hooks/test_gcp_bigtable_hook.py b/tests/contrib/hooks/test_gcp_bigtable_hook.py
index 96ea68c425a53..876879d588352 100644
--- a/tests/contrib/hooks/test_gcp_bigtable_hook.py
+++ b/tests/contrib/hooks/test_gcp_bigtable_hook.py
@@ -26,14 +26,7 @@
 
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
     mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_bigtable_hook import BigtableHook
diff --git a/tests/contrib/hooks/test_gcp_compute_hook.py b/tests/contrib/hooks/test_gcp_compute_hook.py
index 59cab2650636b..76af96fe40ad2 100644
--- a/tests/contrib/hooks/test_gcp_compute_hook.py
+++ b/tests/contrib/hooks/test_gcp_compute_hook.py
@@ -21,14 +21,7 @@
 
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
     mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_compute_hook import GceHook
diff --git a/tests/contrib/hooks/test_gcp_container_hook.py b/tests/contrib/hooks/test_gcp_container_hook.py
index 5cee388599ff0..f4687cfa041a0 100644
--- a/tests/contrib/hooks/test_gcp_container_hook.py
+++ b/tests/contrib/hooks/test_gcp_container_hook.py
@@ -17,11 +17,11 @@
 # specific language governing permissions and limitations
 # under the License.
 #
-import mock
 import unittest
 
 from airflow import AirflowException
 from airflow.contrib.hooks.gcp_container_hook import GKEClusterHook
+from tests.compat import mock
 
 
 TASK_ID = 'test-gke-cluster-operator'
@@ -199,7 +199,7 @@ def setUp(self):
     def test_get_client(self, mock_get_credentials, mock_client_info, mock_client):
         self.gke_hook._client = None
         self.gke_hook.get_client()
-        mock_get_credentials.assert_called()
+        assert mock_get_credentials.called
         mock_client.assert_called_with(
             credentials=mock_get_credentials.return_value,
             client_info=mock_client_info.return_value)
diff --git a/tests/contrib/hooks/test_gcp_dataflow_hook.py b/tests/contrib/hooks/test_gcp_dataflow_hook.py
index fb4a83c6be19d..7e97ea94d3f2e 100644
--- a/tests/contrib/hooks/test_gcp_dataflow_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataflow_hook.py
@@ -19,18 +19,10 @@
 #
 
 import unittest
-from mock import MagicMock
 
 from airflow.contrib.hooks.gcp_dataflow_hook import DataFlowHook,\
     _Dataflow, _DataflowJob
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock, MagicMock
 
 
 TASK_ID = 'test-dataflow-operator'
diff --git a/tests/contrib/hooks/test_gcp_dataproc_hook.py b/tests/contrib/hooks/test_gcp_dataproc_hook.py
index 117ddca018bd3..d5b5e96af421a 100644
--- a/tests/contrib/hooks/test_gcp_dataproc_hook.py
+++ b/tests/contrib/hooks/test_gcp_dataproc_hook.py
@@ -22,14 +22,7 @@
 from airflow.contrib.hooks.gcp_dataproc_hook import _DataProcJob
 from airflow.contrib.hooks.gcp_dataproc_hook import DataProcHook
 from tests.contrib.utils.base_gcp_mock import GCP_PROJECT_ID_HOOK_UNIT_TEST
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 JOB = 'test-job'
 GCP_REGION = 'global'
diff --git a/tests/contrib/hooks/test_gcp_function_hook.py b/tests/contrib/hooks/test_gcp_function_hook.py
index a271f05c74ed6..0ba1956805619 100644
--- a/tests/contrib/hooks/test_gcp_function_hook.py
+++ b/tests/contrib/hooks/test_gcp_function_hook.py
@@ -22,14 +22,7 @@
 from airflow import AirflowException
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
     mock_base_gcp_hook_default_project_id, GCP_PROJECT_ID_HOOK_UNIT_TEST, get_open_mock
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 from airflow.contrib.hooks.gcp_function_hook import GcfHook
 
diff --git a/tests/contrib/hooks/test_gcp_kms_hook.py b/tests/contrib/hooks/test_gcp_kms_hook.py
index eabf20e5642b2..e8ad400e74361 100644
--- a/tests/contrib/hooks/test_gcp_kms_hook.py
+++ b/tests/contrib/hooks/test_gcp_kms_hook.py
@@ -24,14 +24,7 @@
 from base64 import b64encode
 
 from airflow.contrib.hooks.gcp_kms_hook import GoogleCloudKMSHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
 KMS_STRING = 'airflow.contrib.hooks.gcp_kms_hook.{}'
diff --git a/tests/contrib/hooks/test_gcp_pubsub_hook.py b/tests/contrib/hooks/test_gcp_pubsub_hook.py
index ebab0566fe1c7..29231866f7f2e 100644
--- a/tests/contrib/hooks/test_gcp_pubsub_hook.py
+++ b/tests/contrib/hooks/test_gcp_pubsub_hook.py
@@ -26,14 +26,7 @@
 from googleapiclient.errors import HttpError
 
 from airflow.contrib.hooks.gcp_pubsub_hook import PubSubException, PubSubHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
 PUBSUB_STRING = 'airflow.contrib.hooks.gcp_pubsub_hook.{}'
diff --git a/tests/contrib/hooks/test_gcp_spanner_hook.py b/tests/contrib/hooks/test_gcp_spanner_hook.py
index 083c338d8e86c..601e111ca5749 100644
--- a/tests/contrib/hooks/test_gcp_spanner_hook.py
+++ b/tests/contrib/hooks/test_gcp_spanner_hook.py
@@ -23,14 +23,7 @@
 from airflow.contrib.hooks.gcp_spanner_hook import CloudSpannerHook
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_no_default_project_id, \
     GCP_PROJECT_ID_HOOK_UNIT_TEST, mock_base_gcp_hook_default_project_id
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 SPANNER_INSTANCE = 'instance'
 SPANNER_CONFIGURATION = 'configuration'
diff --git a/tests/contrib/hooks/test_gcp_sql_hook.py b/tests/contrib/hooks/test_gcp_sql_hook.py
index 3c49e4299b57f..a7d548e1467f3 100644
--- a/tests/contrib/hooks/test_gcp_sql_hook.py
+++ b/tests/contrib/hooks/test_gcp_sql_hook.py
@@ -26,17 +26,10 @@
 from airflow.models import Connection
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id, \
     mock_base_gcp_hook_no_default_project_id
+from tests.compat import mock
 
 from parameterized import parameterized
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 class TestGcpSqlHookDefaultProjectId(unittest.TestCase):
 
diff --git a/tests/contrib/hooks/test_gcp_transfer_hook.py b/tests/contrib/hooks/test_gcp_transfer_hook.py
index eeb42d2b737aa..ab0cfbf4f0454 100644
--- a/tests/contrib/hooks/test_gcp_transfer_hook.py
+++ b/tests/contrib/hooks/test_gcp_transfer_hook.py
@@ -45,15 +45,9 @@
     mock_base_gcp_hook_no_default_project_id,
     mock_base_gcp_hook_default_project_id,
 )
+from tests.compat import mock
 
 NAME = "name"
-try:
-    from unittest import mock
-except ImportError:  # pragma: no cover
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 TEST_PROJECT_ID = 'project-id'
 TEST_BODY = {DESCRIPTION: 'AAA', PROJECT_ID: TEST_PROJECT_ID}
diff --git a/tests/contrib/hooks/test_gcp_translate_hook.py b/tests/contrib/hooks/test_gcp_translate_hook.py
index d6c392020a0a8..003e65e4de15b 100644
--- a/tests/contrib/hooks/test_gcp_translate_hook.py
+++ b/tests/contrib/hooks/test_gcp_translate_hook.py
@@ -21,14 +21,7 @@
 
 from airflow.contrib.hooks.gcp_translate_hook import CloudTranslateHook
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 PROJECT_ID_TEST = 'project-id'
 
diff --git a/tests/contrib/hooks/test_gcp_vision_hook.py b/tests/contrib/hooks/test_gcp_vision_hook.py
index ef8f2f0ff8d5e..2fcef744bdbef 100644
--- a/tests/contrib/hooks/test_gcp_vision_hook.py
+++ b/tests/contrib/hooks/test_gcp_vision_hook.py
@@ -27,14 +27,7 @@
 
 from airflow.contrib.hooks.gcp_vision_hook import CloudVisionHook
 from tests.contrib.utils.base_gcp_mock import mock_base_gcp_hook_default_project_id
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 from airflow import AirflowException
 
diff --git a/tests/contrib/hooks/test_gcs_hook.py b/tests/contrib/hooks/test_gcs_hook.py
index 1ee26be09b14c..faed4db6c0f09 100644
--- a/tests/contrib/hooks/test_gcs_hook.py
+++ b/tests/contrib/hooks/test_gcs_hook.py
@@ -25,14 +25,7 @@
 
 from airflow.exceptions import AirflowException
 from googleapiclient.errors import HttpError
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 BASE_STRING = 'airflow.contrib.hooks.gcp_api_base_hook.{}'
 GCS_STRING = 'airflow.contrib.hooks.gcs_hook.{}'
diff --git a/tests/contrib/hooks/test_imap_hook.py b/tests/contrib/hooks/test_imap_hook.py
index 57dbf532d51a1..460bd6e3ea356 100644
--- a/tests/contrib/hooks/test_imap_hook.py
+++ b/tests/contrib/hooks/test_imap_hook.py
@@ -74,7 +74,7 @@ def test_connect_and_disconnect(self, mock_imaplib):
 
         mock_imaplib.IMAP4_SSL.assert_called_once_with('imap_server_address')
         mock_conn.login.assert_called_once_with('imap_user', 'imap_password')
-        mock_conn.logout.assert_called_once()
+        assert mock_conn.logout.call_count == 1
 
     @patch(imaplib_string)
     def test_has_mail_attachments_found(self, mock_imaplib):
@@ -262,7 +262,7 @@ def test_download_mail_attachments_with_symlink(self, mock_imaplib, mock_open_me
                 local_output_directory='test_directory'
             )
 
-        mock_is_symlink.assert_called_once()
+        assert mock_is_symlink.call_count == 1
         mock_open_method.assert_not_called()
         mock_open_method.return_value.write.assert_not_called()
 
diff --git a/tests/contrib/hooks/test_openfaas_hook.py b/tests/contrib/hooks/test_openfaas_hook.py
index 7649e6a320e39..162bf38c59ded 100644
--- a/tests/contrib/hooks/test_openfaas_hook.py
+++ b/tests/contrib/hooks/test_openfaas_hook.py
@@ -24,14 +24,7 @@
 from airflow.contrib.hooks.openfaas_hook import OpenFaasHook
 from airflow.hooks.base_hook import BaseHook
 from airflow import configuration, AirflowException
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 FUNCTION_NAME = "function_name"
 
diff --git a/tests/contrib/hooks/test_sagemaker_hook.py b/tests/contrib/hooks/test_sagemaker_hook.py
index 02dad6cb851e5..4837e7af0340e 100644
--- a/tests/contrib/hooks/test_sagemaker_hook.py
+++ b/tests/contrib/hooks/test_sagemaker_hook.py
@@ -23,19 +23,12 @@
 from datetime import datetime
 from tzlocal import get_localzone
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import (SageMakerHook, secondary_training_status_changed,
                                                   secondary_training_status_message, LogState)
 from airflow.hooks.S3_hook import S3Hook
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 
 role = 'arn:aws:iam:role/test-role'
diff --git a/tests/contrib/hooks/test_ssh_hook.py b/tests/contrib/hooks/test_ssh_hook.py
index 80589848929cc..6cc1e0df88070 100644
--- a/tests/contrib/hooks/test_ssh_hook.py
+++ b/tests/contrib/hooks/test_ssh_hook.py
@@ -21,14 +21,7 @@
 from airflow import configuration
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 from airflow.contrib.hooks.ssh_hook import SSHHook
 
diff --git a/tests/contrib/hooks/test_wasb_hook.py b/tests/contrib/hooks/test_wasb_hook.py
index 07013528dd066..c9458287e9097 100644
--- a/tests/contrib/hooks/test_wasb_hook.py
+++ b/tests/contrib/hooks/test_wasb_hook.py
@@ -27,14 +27,7 @@
 from airflow.contrib.hooks.wasb_hook import WasbHook
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestWasbHook(unittest.TestCase):
diff --git a/tests/contrib/minikube/test_kubernetes_pod_operator.py b/tests/contrib/minikube/test_kubernetes_pod_operator.py
index 1934c58cfe026..9c8419286280e 100644
--- a/tests/contrib/minikube/test_kubernetes_pod_operator.py
+++ b/tests/contrib/minikube/test_kubernetes_pod_operator.py
@@ -23,11 +23,11 @@
 from airflow import AirflowException
 from kubernetes.client.rest import ApiException
 from subprocess import check_call
-import mock
 import json
 from airflow.contrib.kubernetes.pod_launcher import PodLauncher
 from airflow.contrib.kubernetes.volume_mount import VolumeMount
 from airflow.contrib.kubernetes.volume import Volume
+from tests.compat import mock
 
 try:
     check_call(["/usr/local/bin/kubectl", "get", "pods"])
@@ -127,7 +127,7 @@ def test_pod_delete_even_on_launcher_error(self, client_mock, delete_pod_mock, r
         run_pod_mock.side_effect = AirflowException('fake failure')
         with self.assertRaises(AirflowException):
             k.execute(None)
-        delete_pod_mock.assert_called()
+        assert delete_pod_mock.called
 
     @staticmethod
     def test_working_pod():
diff --git a/tests/contrib/operators/test_adls_list_operator.py b/tests/contrib/operators/test_adls_list_operator.py
index 52decd0cd2ccf..f668b55a5a80f 100644
--- a/tests/contrib/operators/test_adls_list_operator.py
+++ b/tests/contrib/operators/test_adls_list_operator.py
@@ -20,14 +20,7 @@
 import unittest
 
 from airflow.contrib.operators.adls_list_operator import AzureDataLakeStorageListOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-adls-list-operator'
 TEST_PATH = 'test/*'
diff --git a/tests/contrib/operators/test_adls_to_gcs_operator.py b/tests/contrib/operators/test_adls_to_gcs_operator.py
index 0277f55d55771..d551a05971417 100644
--- a/tests/contrib/operators/test_adls_to_gcs_operator.py
+++ b/tests/contrib/operators/test_adls_to_gcs_operator.py
@@ -22,14 +22,7 @@
 from airflow.contrib.hooks.gcs_hook import _parse_gcs_url
 from airflow.contrib.operators.adls_to_gcs import \
     AdlsToGoogleCloudStorageOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-adls-gcs-operator'
 ADLS_PATH_1 = '*'
diff --git a/tests/contrib/operators/test_aws_athena_operator.py b/tests/contrib/operators/test_aws_athena_operator.py
index ecfb0d2890100..8c6b045d1aa3a 100644
--- a/tests/contrib/operators/test_aws_athena_operator.py
+++ b/tests/contrib/operators/test_aws_athena_operator.py
@@ -23,14 +23,7 @@
 from airflow.contrib.operators.aws_athena_operator import AWSAthenaOperator
 from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
 from airflow import configuration
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 MOCK_DATA = {
     'task_id': 'test_aws_athena_operator',
diff --git a/tests/contrib/operators/test_awsbatch_operator.py b/tests/contrib/operators/test_awsbatch_operator.py
index 3c4f7991c6f0d..c825545cc6a47 100644
--- a/tests/contrib/operators/test_awsbatch_operator.py
+++ b/tests/contrib/operators/test_awsbatch_operator.py
@@ -24,14 +24,7 @@
 from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.contrib.operators.awsbatch_operator import AWSBatchOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 RESPONSE_WITHOUT_FAILURES = {
     "jobName": "51455483-c62c-48ac-9b88-53a6a725baa3",
diff --git a/tests/contrib/operators/test_azure_container_instances_operator.py b/tests/contrib/operators/test_azure_container_instances_operator.py
index 53014de414ffb..53ed71116b805 100644
--- a/tests/contrib/operators/test_azure_container_instances_operator.py
+++ b/tests/contrib/operators/test_azure_container_instances_operator.py
@@ -20,17 +20,10 @@
 
 from airflow.exceptions import AirflowException
 from airflow.contrib.operators.azure_container_instances_operator import AzureContainerInstancesOperator
+from tests.compat import mock
 
 import unittest
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 class TestACIOperator(unittest.TestCase):
 
diff --git a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
index 14439514f889a..282114a1e3cf7 100644
--- a/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
+++ b/tests/contrib/operators/test_azure_cosmos_insertdocument_operator.py
@@ -28,15 +28,7 @@
 from airflow import configuration
 from airflow.models.connection import Connection
 from airflow.utils import db
-
-try:
-    from unittest import mock
-
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestAzureCosmosDbHook(unittest.TestCase):
diff --git a/tests/contrib/operators/test_bigquery_operator.py b/tests/contrib/operators/test_bigquery_operator.py
index 1deb542db94e1..11dab67ec1111 100644
--- a/tests/contrib/operators/test_bigquery_operator.py
+++ b/tests/contrib/operators/test_bigquery_operator.py
@@ -32,14 +32,7 @@
     BigQueryDeleteDatasetOperator, BigQueryCreateEmptyDatasetOperator, \
     BigQueryOperator
 from airflow.settings import Session
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-bq-create-table-operator'
 TEST_DATASET = 'test-dataset'
diff --git a/tests/contrib/operators/test_databricks_operator.py b/tests/contrib/operators/test_databricks_operator.py
index 6b5dfc99d0b79..57b0829e2e215 100644
--- a/tests/contrib/operators/test_databricks_operator.py
+++ b/tests/contrib/operators/test_databricks_operator.py
@@ -27,14 +27,7 @@
 from airflow.contrib.operators.databricks_operator import DatabricksRunNowOperator
 from airflow.exceptions import AirflowException
 from airflow.models import DAG
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 DATE = '2017-04-20'
 TASK_ID = 'databricks-operator'
diff --git a/tests/contrib/operators/test_dataflow_operator.py b/tests/contrib/operators/test_dataflow_operator.py
index 0eb4d0b12b286..b56db3de51bff 100644
--- a/tests/contrib/operators/test_dataflow_operator.py
+++ b/tests/contrib/operators/test_dataflow_operator.py
@@ -25,14 +25,7 @@
     DataflowTemplateOperator, GoogleCloudBucketHelper
 
 from airflow.version import version
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 TASK_ID = 'test-dataflow-operator'
diff --git a/tests/contrib/operators/test_dataproc_operator.py b/tests/contrib/operators/test_dataproc_operator.py
index 28e4e035e96b8..47a105ff52789 100644
--- a/tests/contrib/operators/test_dataproc_operator.py
+++ b/tests/contrib/operators/test_dataproc_operator.py
@@ -21,6 +21,7 @@
 import datetime
 import re
 import unittest
+from typing import Dict
 
 from airflow import DAG, AirflowException
 from airflow.contrib.operators.dataproc_operator import \
@@ -34,17 +35,10 @@
     DataprocWorkflowTemplateInstantiateOperator, \
     DataprocClusterScaleOperator
 from airflow.version import version
+from tests.compat import mock
 
 from copy import deepcopy
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from mock import MagicMock, Mock
 from mock import patch
 
@@ -68,7 +62,7 @@
 WORKER_DISK_TYPE = 'pd-standard'
 NUM_PREEMPTIBLE_WORKERS = 2
 GET_INIT_ACTION_TIMEOUT = "600s"  # 10m
-LABEL1 = {}
+LABEL1 = {}  # type: Dict
 LABEL2 = {'application': 'test', 'year': 2017}
 SERVICE_ACCOUNT_SCOPES = [
     'https://www.googleapis.com/auth/bigquery',
diff --git a/tests/contrib/operators/test_ecs_operator.py b/tests/contrib/operators/test_ecs_operator.py
index 5bb52fce4efce..e65663df6b3ef 100644
--- a/tests/contrib/operators/test_ecs_operator.py
+++ b/tests/contrib/operators/test_ecs_operator.py
@@ -27,14 +27,7 @@
 from airflow import configuration
 from airflow.exceptions import AirflowException
 from airflow.contrib.operators.ecs_operator import ECSOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 RESPONSE_WITHOUT_FAILURES = {
     "failures": [],
diff --git a/tests/contrib/operators/test_file_to_gcs.py b/tests/contrib/operators/test_file_to_gcs.py
index 7e20579ecda92..29ceae5d52bde 100644
--- a/tests/contrib/operators/test_file_to_gcs.py
+++ b/tests/contrib/operators/test_file_to_gcs.py
@@ -23,14 +23,7 @@
 
 from airflow import DAG, configuration
 from airflow.contrib.operators.file_to_gcs import FileToGoogleCloudStorageOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestFileToGcsOperator(unittest.TestCase):
diff --git a/tests/contrib/operators/test_file_to_wasb.py b/tests/contrib/operators/test_file_to_wasb.py
index 46630cb475c1b..61fcc7cba3243 100644
--- a/tests/contrib/operators/test_file_to_wasb.py
+++ b/tests/contrib/operators/test_file_to_wasb.py
@@ -23,14 +23,7 @@
 
 from airflow import DAG, configuration
 from airflow.contrib.operators.file_to_wasb import FileToWasbOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestFileToWasbOperator(unittest.TestCase):
diff --git a/tests/contrib/operators/test_gcp_bigtable_operator.py b/tests/contrib/operators/test_gcp_bigtable_operator.py
index 1633acb9d94f4..ed839bd231dfb 100644
--- a/tests/contrib/operators/test_gcp_bigtable_operator.py
+++ b/tests/contrib/operators/test_gcp_bigtable_operator.py
@@ -18,6 +18,7 @@
 # under the License.
 
 import unittest
+from typing import List, Dict
 import google.api_core.exceptions
 from google.cloud.bigtable.column_family import MaxVersionsGCRule
 from google.cloud.bigtable.instance import Instance
@@ -32,15 +33,7 @@
     BigtableTableWaitForReplicationSensor, \
     BigtableClusterUpdateOperator, \
     BigtableInstanceCreateOperator
-
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 PROJECT_ID = 'test_project_id'
 INSTANCE_ID = 'test-instance-id'
@@ -48,8 +41,8 @@
 CLUSTER_ZONE = 'us-central1-f'
 NODES = 5
 TABLE_ID = 'test-table-id'
-INITIAL_SPLIT_KEYS = []
-EMPTY_COLUMN_FAMILIES = {}
+INITIAL_SPLIT_KEYS = []  # type: List
+EMPTY_COLUMN_FAMILIES = {}  # type: Dict
 
 
 class BigtableInstanceCreateTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_gcp_compute_operator.py b/tests/contrib/operators/test_gcp_compute_operator.py
index 8ff30dd320945..7613c2a05752a 100644
--- a/tests/contrib/operators/test_gcp_compute_operator.py
+++ b/tests/contrib/operators/test_gcp_compute_operator.py
@@ -29,15 +29,7 @@
     GceInstanceGroupManagerUpdateTemplateOperator
 from airflow.models import TaskInstance, DAG
 from airflow.utils import timezone
-
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 EMPTY_CONTENT = ''.encode('utf8')
 
diff --git a/tests/contrib/operators/test_gcp_container_operator.py b/tests/contrib/operators/test_gcp_container_operator.py
index 71df169239101..8fe322dbbb947 100644
--- a/tests/contrib/operators/test_gcp_container_operator.py
+++ b/tests/contrib/operators/test_gcp_container_operator.py
@@ -24,14 +24,7 @@
 from airflow.contrib.operators.gcp_container_operator import GKEClusterCreateOperator, \
     GKEClusterDeleteOperator, GKEPodOperator
 from airflow.contrib.operators.kubernetes_pod_operator import KubernetesPodOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TEST_GCP_PROJECT_ID = 'test-id'
 PROJECT_LOCATION = 'test-location'
diff --git a/tests/contrib/operators/test_gcp_function_operator.py b/tests/contrib/operators/test_gcp_function_operator.py
index 394c24b86a232..c1abff0a3e889 100644
--- a/tests/contrib/operators/test_gcp_function_operator.py
+++ b/tests/contrib/operators/test_gcp_function_operator.py
@@ -26,18 +26,10 @@
     GcfFunctionDeployOperator, GcfFunctionDeleteOperator, FUNCTION_NAME_PATTERN
 from airflow import AirflowException
 from airflow.version import version
+from tests.compat import mock
 
 from copy import deepcopy
 
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 EMPTY_CONTENT = ''.encode('utf8')
 MOCK_RESP_404 = type('', (object,), {"status": 404})()
 
diff --git a/tests/contrib/operators/test_gcp_spanner_operator.py b/tests/contrib/operators/test_gcp_spanner_operator.py
index eea242bbc1437..7c06d4f6629a7 100644
--- a/tests/contrib/operators/test_gcp_spanner_operator.py
+++ b/tests/contrib/operators/test_gcp_spanner_operator.py
@@ -28,15 +28,8 @@
     CloudSpannerInstanceDatabaseDeployOperator, \
     CloudSpannerInstanceDatabaseDeleteOperator, \
     CloudSpannerInstanceDatabaseUpdateOperator
+from tests.compat import mock
 
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 PROJECT_ID = 'project-id'
 INSTANCE_ID = 'instance-id'
diff --git a/tests/contrib/operators/test_gcp_sql_operator.py b/tests/contrib/operators/test_gcp_sql_operator.py
index 1ae01453e7ab0..f8266adbd5449 100644
--- a/tests/contrib/operators/test_gcp_sql_operator.py
+++ b/tests/contrib/operators/test_gcp_sql_operator.py
@@ -29,15 +29,7 @@
     CloudSqlInstanceExportOperator, CloudSqlInstanceImportOperator, \
     CloudSqlInstanceDatabaseDeleteOperator, CloudSqlQueryOperator
 from airflow.models.connection import Connection
-
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 PROJECT_ID = os.environ.get('PROJECT_ID', 'project-id')
 INSTANCE_NAME = os.environ.get('INSTANCE_NAME', 'test-name')
diff --git a/tests/contrib/operators/test_gcp_sql_operator_system_helper.py b/tests/contrib/operators/test_gcp_sql_operator_system_helper.py
index 85974a9987d33..d2898ed5db38a 100755
--- a/tests/contrib/operators/test_gcp_sql_operator_system_helper.py
+++ b/tests/contrib/operators/test_gcp_sql_operator_system_helper.py
@@ -33,15 +33,6 @@
 from tests.contrib.utils.gcp_authenticator import GcpAuthenticator, GCP_CLOUDSQL_KEY
 from tests.contrib.utils.logging_command_executor import LoggingCommandExecutor
 
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 retrieve_variables = RetrieveVariables()
 
 GCP_PROJECT_ID = os.environ.get('GCP_PROJECT_ID', 'example-project')
diff --git a/tests/contrib/operators/test_gcp_transfer_operator.py b/tests/contrib/operators/test_gcp_transfer_operator.py
index ffab04b72cb99..67fd4649fdfbe 100644
--- a/tests/contrib/operators/test_gcp_transfer_operator.py
+++ b/tests/contrib/operators/test_gcp_transfer_operator.py
@@ -20,6 +20,7 @@
 import unittest
 from copy import deepcopy
 from datetime import date, time
+from typing import Dict
 
 from parameterized import parameterized
 from botocore.credentials import Credentials
@@ -60,15 +61,8 @@
 )
 from airflow.models import TaskInstance, DAG
 from airflow.utils import timezone
+from tests.compat import mock
 
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:  # pragma: no cover
-    try:
-        import mock
-    except ImportError:
-        mock = None
 try:
     import boto3
 except ImportError:  # pragma: no cover
@@ -117,7 +111,7 @@
     STATUS: 'ENABLED',
     SCHEDULE: SCHEDULE_DICT,
     TRANSFER_SPEC: {GCS_DATA_SINK: {BUCKET_NAME: GCS_BUCKET_NAME}},
-}
+}  # type: Dict
 VALID_TRANSFER_JOB_GCS = deepcopy(VALID_TRANSFER_JOB_BASE)
 VALID_TRANSFER_JOB_GCS[TRANSFER_SPEC].update(deepcopy(SOURCE_GCS))
 VALID_TRANSFER_JOB_AWS = deepcopy(VALID_TRANSFER_JOB_BASE)
@@ -139,7 +133,7 @@
     STATUS: 'ENABLED',
     SCHEDULE: SCHEDULE_DICT,
     TRANSFER_SPEC: {GCS_DATA_SINK: {BUCKET_NAME: GCS_BUCKET_NAME}},
-}
+}  # type: Dict
 
 VALID_TRANSFER_JOB_GCS_RAW = deepcopy(VALID_TRANSFER_JOB_RAW)
 VALID_TRANSFER_JOB_GCS_RAW[TRANSFER_SPEC].update(SOURCE_GCS)
diff --git a/tests/contrib/operators/test_gcp_translate_operator.py b/tests/contrib/operators/test_gcp_translate_operator.py
index 023ad0595577c..5e8f245c182c1 100644
--- a/tests/contrib/operators/test_gcp_translate_operator.py
+++ b/tests/contrib/operators/test_gcp_translate_operator.py
@@ -20,15 +20,7 @@
 import unittest
 
 from airflow.contrib.operators.gcp_translate_operator import CloudTranslateTextOperator
-
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 GCP_CONN_ID = 'google_cloud_default'
 
diff --git a/tests/contrib/operators/test_gcp_vision_operator.py b/tests/contrib/operators/test_gcp_vision_operator.py
index 3448c1a95de95..37365d9bec10b 100644
--- a/tests/contrib/operators/test_gcp_vision_operator.py
+++ b/tests/contrib/operators/test_gcp_vision_operator.py
@@ -37,14 +37,7 @@
     CloudVisionAnnotateImageOperator,
 )
 
-try:
-    # noinspection PyProtectedMember
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 PRODUCTSET_TEST = ProductSet(display_name='Test Product Set')
 PRODUCTSET_ID_TEST = 'my-productset'
@@ -242,7 +235,7 @@ def test_minimal_green_path(self, mock_hook):
 
 
 class CloudVisionReferenceImageCreateTest(unittest.TestCase):
-    @mock.patch(
+    @mock.patch(  # type: ignore
         'airflow.contrib.operators.gcp_vision_operator.CloudVisionHook',
         **{'return_value.create_reference_image.return_value': {}}
     )
diff --git a/tests/contrib/operators/test_gcs_acl_operator.py b/tests/contrib/operators/test_gcs_acl_operator.py
index f428397e8bf1f..cae3484613276 100644
--- a/tests/contrib/operators/test_gcs_acl_operator.py
+++ b/tests/contrib/operators/test_gcs_acl_operator.py
@@ -22,14 +22,7 @@
 from airflow.contrib.operators.gcs_acl_operator import \
     GoogleCloudStorageBucketCreateAclEntryOperator, \
     GoogleCloudStorageObjectCreateAclEntryOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class GoogleCloudStorageAclTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_gcs_download_operator.py b/tests/contrib/operators/test_gcs_download_operator.py
index 4e9914e8fd446..c366afed162ea 100644
--- a/tests/contrib/operators/test_gcs_download_operator.py
+++ b/tests/contrib/operators/test_gcs_download_operator.py
@@ -21,14 +21,7 @@
 
 from airflow.contrib.operators.gcs_download_operator \
     import GoogleCloudStorageDownloadOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-gcs-download-operator'
 TEST_BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_gcs_list_operator.py b/tests/contrib/operators/test_gcs_list_operator.py
index 8f0281f76fb64..7b01b2143085b 100644
--- a/tests/contrib/operators/test_gcs_list_operator.py
+++ b/tests/contrib/operators/test_gcs_list_operator.py
@@ -20,14 +20,7 @@
 import unittest
 
 from airflow.contrib.operators.gcs_list_operator import GoogleCloudStorageListOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-gcs-list-operator'
 TEST_BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_gcs_operator.py b/tests/contrib/operators/test_gcs_operator.py
index 095f316bd82ce..67c86d62d6f6e 100644
--- a/tests/contrib/operators/test_gcs_operator.py
+++ b/tests/contrib/operators/test_gcs_operator.py
@@ -21,14 +21,7 @@
 
 from airflow.contrib.operators.gcs_operator import GoogleCloudStorageCreateBucketOperator
 from airflow.version import version
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-gcs-operator'
 TEST_BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_gcs_to_gcs_operator.py b/tests/contrib/operators/test_gcs_to_gcs_operator.py
index dd16e2f2df87b..bcf56af9765c0 100644
--- a/tests/contrib/operators/test_gcs_to_gcs_operator.py
+++ b/tests/contrib/operators/test_gcs_to_gcs_operator.py
@@ -22,14 +22,7 @@
 
 from airflow.contrib.operators.gcs_to_gcs import \
     GoogleCloudStorageToGoogleCloudStorageOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-gcs-to-gcs-operator'
 TEST_BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_gcs_to_s3_operator.py b/tests/contrib/operators/test_gcs_to_s3_operator.py
index 1a35a223ab8aa..092d4dfadbb7f 100644
--- a/tests/contrib/operators/test_gcs_to_s3_operator.py
+++ b/tests/contrib/operators/test_gcs_to_s3_operator.py
@@ -21,14 +21,7 @@
 
 from airflow.contrib.operators.gcs_to_s3 import GoogleCloudStorageToS3Operator
 from airflow.hooks.S3_hook import S3Hook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 try:
     from moto import mock_s3
diff --git a/tests/contrib/operators/test_hipchat_operator.py b/tests/contrib/operators/test_hipchat_operator.py
index dbfb227d1d4b5..be86a1bb595f4 100644
--- a/tests/contrib/operators/test_hipchat_operator.py
+++ b/tests/contrib/operators/test_hipchat_operator.py
@@ -24,14 +24,7 @@
     HipChatAPISendRoomNotificationOperator
 from airflow.exceptions import AirflowException
 from airflow import configuration
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class HipChatOperatorTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_jenkins_operator.py b/tests/contrib/operators/test_jenkins_operator.py
index 33269264fb717..875d906082d5f 100644
--- a/tests/contrib/operators/test_jenkins_operator.py
+++ b/tests/contrib/operators/test_jenkins_operator.py
@@ -26,14 +26,7 @@
 from airflow.contrib.hooks.jenkins_hook import JenkinsHook
 
 from airflow.exceptions import AirflowException
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class JenkinsOperatorTestCase(unittest.TestCase):
diff --git a/tests/contrib/operators/test_mongo_to_s3_operator.py b/tests/contrib/operators/test_mongo_to_s3_operator.py
index ad3e1e939fabb..d1de69e6ae832 100644
--- a/tests/contrib/operators/test_mongo_to_s3_operator.py
+++ b/tests/contrib/operators/test_mongo_to_s3_operator.py
@@ -22,14 +22,7 @@
 from airflow.contrib.operators.mongo_to_s3 import MongoToS3Operator
 from airflow.models import TaskInstance
 from airflow.utils import timezone
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test_mongo_to_s3_operator'
 MONGO_CONN_ID = 'default_mongo'
diff --git a/tests/contrib/operators/test_mysql_to_gcs_operator.py b/tests/contrib/operators/test_mysql_to_gcs_operator.py
index 94bf25486905e..bb9685e51669e 100644
--- a/tests/contrib/operators/test_mysql_to_gcs_operator.py
+++ b/tests/contrib/operators/test_mysql_to_gcs_operator.py
@@ -22,14 +22,7 @@
 
 from airflow.contrib.operators.mysql_to_gcs import \
     MySqlToGoogleCloudStorageOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 PY3 = sys.version_info[0] == 3
 
diff --git a/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py b/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py
index e02e6312fb740..7686afad21885 100644
--- a/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py
+++ b/tests/contrib/operators/test_oracle_to_azure_data_lake_transfer.py
@@ -24,15 +24,7 @@
 import unicodecsv as csv
 import os
 
-try:
-    from unittest import mock
-    from unittest.mock import MagicMock
-except ImportError:
-    try:
-        import mock
-        from mock import MagicMock
-    except ImportError:
-        mock = None
+from tests.compat import mock, MagicMock
 
 
 class OracleToAzureDataLakeTransferTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_oracle_to_oracle_transfer.py b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
index 9c738dc8f76da..e814b83ea3a12 100644
--- a/tests/contrib/operators/test_oracle_to_oracle_transfer.py
+++ b/tests/contrib/operators/test_oracle_to_oracle_transfer.py
@@ -20,16 +20,7 @@
 import unittest
 from airflow.contrib.operators.oracle_to_oracle_transfer \
     import OracleToOracleTransfer
-
-try:
-    from unittest import mock
-    from unittest.mock import MagicMock
-except ImportError:
-    try:
-        import mock
-        from mock import MagicMock
-    except ImportError:
-        mock = None
+from tests.compat import MagicMock
 
 
 class OracleToOracleTransferTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_postgres_to_gcs_operator.py b/tests/contrib/operators/test_postgres_to_gcs_operator.py
index 904f57689d4b9..420c1d4195379 100644
--- a/tests/contrib/operators/test_postgres_to_gcs_operator.py
+++ b/tests/contrib/operators/test_postgres_to_gcs_operator.py
@@ -27,14 +27,7 @@
 from airflow.hooks.postgres_hook import PostgresHook
 from airflow.contrib.operators.postgres_to_gcs_operator import \
     PostgresToGoogleCloudStorageOperator
-
-try:
-    from unittest.mock import patch
-except ImportError:
-    try:
-        from mock import patch
-    except ImportError:
-        mock = None
+from tests.compat import patch
 
 TABLES = {'postgres_to_gcs_operator', 'postgres_to_gcs_operator_empty'}
 
diff --git a/tests/contrib/operators/test_pubsub_operator.py b/tests/contrib/operators/test_pubsub_operator.py
index 4503971ee564b..ada3b8c9edc38 100644
--- a/tests/contrib/operators/test_pubsub_operator.py
+++ b/tests/contrib/operators/test_pubsub_operator.py
@@ -26,15 +26,7 @@
     PubSubTopicCreateOperator, PubSubTopicDeleteOperator,
     PubSubSubscriptionCreateOperator, PubSubSubscriptionDeleteOperator,
     PubSubPublishOperator)
-
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-task-id'
 TEST_PROJECT = 'test-project'
diff --git a/tests/contrib/operators/test_qubole_check_operator.py b/tests/contrib/operators/test_qubole_check_operator.py
index 972038005bb79..b356f6091c90a 100644
--- a/tests/contrib/operators/test_qubole_check_operator.py
+++ b/tests/contrib/operators/test_qubole_check_operator.py
@@ -25,14 +25,7 @@
 from airflow.contrib.hooks.qubole_check_hook import QuboleCheckHook
 from airflow.contrib.hooks.qubole_hook import QuboleHook
 from qds_sdk.commands import HiveCommand
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class QuboleValueCheckOperatorTest(unittest.TestCase):
diff --git a/tests/contrib/operators/test_qubole_operator.py b/tests/contrib/operators/test_qubole_operator.py
index 43d20d2750278..de314ba110909 100644
--- a/tests/contrib/operators/test_qubole_operator.py
+++ b/tests/contrib/operators/test_qubole_operator.py
@@ -28,14 +28,6 @@
 from airflow.contrib.hooks.qubole_hook import QuboleHook
 from airflow.contrib.operators.qubole_operator import QuboleOperator
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 DAG_ID = "qubole_test_dag"
 TASK_ID = "test_task"
 DEFAULT_CONN = "qubole_default"
diff --git a/tests/contrib/operators/test_s3_list_operator.py b/tests/contrib/operators/test_s3_list_operator.py
index df897b5700286..e041fd07545f5 100644
--- a/tests/contrib/operators/test_s3_list_operator.py
+++ b/tests/contrib/operators/test_s3_list_operator.py
@@ -20,14 +20,7 @@
 import unittest
 
 from airflow.contrib.operators.s3_list_operator import S3ListOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-s3-list-operator'
 BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_s3_to_gcs_operator.py b/tests/contrib/operators/test_s3_to_gcs_operator.py
index 3534bb1c2b517..28f71b3973d85 100644
--- a/tests/contrib/operators/test_s3_to_gcs_operator.py
+++ b/tests/contrib/operators/test_s3_to_gcs_operator.py
@@ -22,14 +22,7 @@
 from airflow.contrib.hooks.gcs_hook import _parse_gcs_url
 from airflow.contrib.operators.s3_to_gcs_operator import \
     S3ToGoogleCloudStorageOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-s3-gcs-operator'
 S3_BUCKET = 'test-bucket'
diff --git a/tests/contrib/operators/test_sagemaker_base_operator.py b/tests/contrib/operators/test_sagemaker_base_operator.py
index 996e61e20f2d1..5ab7a614ae3b1 100644
--- a/tests/contrib/operators/test_sagemaker_base_operator.py
+++ b/tests/contrib/operators/test_sagemaker_base_operator.py
@@ -18,13 +18,6 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.operators.sagemaker_base_operator import SageMakerBaseOperator
diff --git a/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py b/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
index 658fd813df73e..911a7e2334782 100644
--- a/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
+++ b/tests/contrib/operators/test_sagemaker_endpoint_config_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_endpoint_config_operator \
     import SageMakerEndpointConfigOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 model_name = 'test-model-name'
 config_name = 'test-config-name'
diff --git a/tests/contrib/operators/test_sagemaker_endpoint_operator.py b/tests/contrib/operators/test_sagemaker_endpoint_operator.py
index 710daceff5b57..cc6f118855d69 100644
--- a/tests/contrib/operators/test_sagemaker_endpoint_operator.py
+++ b/tests/contrib/operators/test_sagemaker_endpoint_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_endpoint_operator \
     import SageMakerEndpointOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 role = 'arn:aws:iam:role/test-role'
 bucket = 'test-bucket'
diff --git a/tests/contrib/operators/test_sagemaker_model_operator.py b/tests/contrib/operators/test_sagemaker_model_operator.py
index 6b6d12de10264..c01e466e161d4 100644
--- a/tests/contrib/operators/test_sagemaker_model_operator.py
+++ b/tests/contrib/operators/test_sagemaker_model_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_model_operator \
     import SageMakerModelOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 role = 'arn:aws:iam:role/test-role'
 
diff --git a/tests/contrib/operators/test_sagemaker_training_operator.py b/tests/contrib/operators/test_sagemaker_training_operator.py
index 147b7f1bb7fac..8d81c6147b486 100644
--- a/tests/contrib/operators/test_sagemaker_training_operator.py
+++ b/tests/contrib/operators/test_sagemaker_training_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_training_operator \
     import SageMakerTrainingOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 role = 'arn:aws:iam:role/test-role'
 
diff --git a/tests/contrib/operators/test_sagemaker_transform_operator.py b/tests/contrib/operators/test_sagemaker_transform_operator.py
index e6bc4272b1cb0..74825bbdb2ba7 100644
--- a/tests/contrib/operators/test_sagemaker_transform_operator.py
+++ b/tests/contrib/operators/test_sagemaker_transform_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_transform_operator \
     import SageMakerTransformOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 role = 'arn:aws:iam:role/test-role'
 
diff --git a/tests/contrib/operators/test_sagemaker_tuning_operator.py b/tests/contrib/operators/test_sagemaker_tuning_operator.py
index 9ec533fa869b4..088a055296c9a 100644
--- a/tests/contrib/operators/test_sagemaker_tuning_operator.py
+++ b/tests/contrib/operators/test_sagemaker_tuning_operator.py
@@ -18,19 +18,13 @@
 # under the License.
 
 import unittest
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
 
 from airflow import configuration
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.contrib.operators.sagemaker_tuning_operator \
     import SageMakerTuningOperator
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 role = 'arn:aws:iam:role/test-role'
 
diff --git a/tests/contrib/operators/test_snowflake_operator.py b/tests/contrib/operators/test_snowflake_operator.py
index f5da6f6c43ae8..8b394a7d5e0e3 100644
--- a/tests/contrib/operators/test_snowflake_operator.py
+++ b/tests/contrib/operators/test_snowflake_operator.py
@@ -25,14 +25,7 @@
 from airflow.utils import timezone
 
 from airflow.contrib.operators.snowflake_operator import SnowflakeOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 DEFAULT_DATE = timezone.datetime(2015, 1, 1)
diff --git a/tests/contrib/operators/test_wasb_delete_blob_operator.py b/tests/contrib/operators/test_wasb_delete_blob_operator.py
index 7c3ed0bd630ad..04c3f7efdb9a3 100644
--- a/tests/contrib/operators/test_wasb_delete_blob_operator.py
+++ b/tests/contrib/operators/test_wasb_delete_blob_operator.py
@@ -23,14 +23,7 @@
 
 from airflow import DAG, configuration
 from airflow.contrib.operators.wasb_delete_blob_operator import WasbDeleteBlobOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestWasbDeleteBlobOperator(unittest.TestCase):
diff --git a/tests/contrib/sensors/test_athena_sensor.py b/tests/contrib/sensors/test_athena_sensor.py
index 6a8d713e3f6a7..48da102fd2b27 100644
--- a/tests/contrib/sensors/test_athena_sensor.py
+++ b/tests/contrib/sensors/test_athena_sensor.py
@@ -21,14 +21,7 @@
 from airflow import configuration, AirflowException
 from airflow.contrib.sensors.aws_athena_sensor import AthenaSensor
 from airflow.contrib.hooks.aws_athena_hook import AWSAthenaHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestAthenaSensor(unittest.TestCase):
diff --git a/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py b/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py
index fc12318e1a448..a925f0e29685c 100644
--- a/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py
+++ b/tests/contrib/sensors/test_aws_glue_catalog_partition_sensor.py
@@ -22,17 +22,13 @@
 from airflow import configuration
 from airflow.contrib.hooks.aws_glue_catalog_hook import AwsGlueCatalogHook
 from airflow.contrib.sensors.aws_glue_catalog_partition_sensor import AwsGlueCatalogPartitionSensor
+from tests.compat import mock
 
 try:
     from moto import mock_glue
 except ImportError:
     mock_glue = None
 
-try:
-    from unittest import mock
-except ImportError:
-    import mock
-
 
 @unittest.skipIf(mock_glue is None,
                  "Skipping test because moto.mock_glue is not available")
diff --git a/tests/contrib/sensors/test_datadog_sensor.py b/tests/contrib/sensors/test_datadog_sensor.py
index d5d9309666093..2c59d665d2e69 100644
--- a/tests/contrib/sensors/test_datadog_sensor.py
+++ b/tests/contrib/sensors/test_datadog_sensor.py
@@ -19,13 +19,13 @@
 
 import json
 import unittest
-
-from mock import patch
+from typing import List
 
 from airflow import configuration
 from airflow.contrib.sensors.datadog_sensor import DatadogSensor
 from airflow.models.connection import Connection
 from airflow.utils import db
+from tests.compat import patch
 
 at_least_one_event = [{'alert_type': 'info',
                        'comments': [],
@@ -56,7 +56,7 @@
                        'title': 'Something big happened!',
                        'url': '/event/jump_to?event_id=2603387619536318141'}]
 
-zero_events = []
+zero_events = []  # type: List
 
 
 class TestDatadogSensor(unittest.TestCase):
diff --git a/tests/contrib/sensors/test_gcp_transfer_sensor.py b/tests/contrib/sensors/test_gcp_transfer_sensor.py
index 1daee26791225..d15aac30e87d2 100644
--- a/tests/contrib/sensors/test_gcp_transfer_sensor.py
+++ b/tests/contrib/sensors/test_gcp_transfer_sensor.py
@@ -22,14 +22,7 @@
 
 from airflow.contrib.hooks.gcp_transfer_hook import GcpTransferOperationStatus
 from airflow.contrib.sensors.gcp_transfer_sensor import GCPTransferServiceWaitForJobStatusSensor
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestGcpStorageTransferOperationWaitForJobStatusSensor(unittest.TestCase):
diff --git a/tests/contrib/sensors/test_pubsub_sensor.py b/tests/contrib/sensors/test_pubsub_sensor.py
index a6931a0836b11..317de92dcaec2 100644
--- a/tests/contrib/sensors/test_pubsub_sensor.py
+++ b/tests/contrib/sensors/test_pubsub_sensor.py
@@ -25,14 +25,7 @@
 
 from airflow.contrib.sensors.pubsub_sensor import PubSubPullSensor
 from airflow.exceptions import AirflowSensorTimeout
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 TASK_ID = 'test-task-id'
 TEST_PROJECT = 'test-project'
diff --git a/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py b/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py
index 2e438e4e193ae..0c2bcab70be0c 100644
--- a/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_endpoint_sensor.py
@@ -19,19 +19,12 @@
 
 import unittest
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from airflow import configuration
 from airflow.contrib.sensors.sagemaker_endpoint_sensor \
     import SageMakerEndpointSensor
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 DESCRIBE_ENDPOINT_CREATING_RESPONSE = {
     'EndpointStatus': 'Creating',
diff --git a/tests/contrib/sensors/test_sagemaker_training_sensor.py b/tests/contrib/sensors/test_sagemaker_training_sensor.py
index 6642449c6a795..fe7944e33971d 100644
--- a/tests/contrib/sensors/test_sagemaker_training_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_training_sensor.py
@@ -20,19 +20,12 @@
 import unittest
 from datetime import datetime
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from airflow import configuration
 from airflow.contrib.sensors.sagemaker_training_sensor \
     import SageMakerTrainingSensor
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook, LogState
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 DESCRIBE_TRAINING_COMPELETED_RESPONSE = {
     'TrainingJobStatus': 'Completed',
diff --git a/tests/contrib/sensors/test_sagemaker_transform_sensor.py b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
index 810680683cde3..be84b96d88f6a 100644
--- a/tests/contrib/sensors/test_sagemaker_transform_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_transform_sensor.py
@@ -19,19 +19,12 @@
 
 import unittest
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from airflow import configuration
 from airflow.contrib.sensors.sagemaker_transform_sensor \
     import SageMakerTransformSensor
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 DESCRIBE_TRANSFORM_INPROGRESS_RESPONSE = {
     'TransformJobStatus': 'InProgress',
diff --git a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
index beb62dc47b1d1..b904e8a2e3aea 100644
--- a/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
+++ b/tests/contrib/sensors/test_sagemaker_tuning_sensor.py
@@ -19,19 +19,12 @@
 
 import unittest
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 from airflow import configuration
 from airflow.contrib.sensors.sagemaker_tuning_sensor \
     import SageMakerTuningSensor
 from airflow.contrib.hooks.sagemaker_hook import SageMakerHook
 from airflow.exceptions import AirflowException
+from tests.compat import mock
 
 DESCRIBE_TUNING_INPROGRESS_RESPONSE = {
     'HyperParameterTuningJobStatus': 'InProgress',
diff --git a/tests/contrib/sensors/test_wasb_sensor.py b/tests/contrib/sensors/test_wasb_sensor.py
index d122e4c454403..6edc58da9fb2d 100644
--- a/tests/contrib/sensors/test_wasb_sensor.py
+++ b/tests/contrib/sensors/test_wasb_sensor.py
@@ -25,14 +25,7 @@
 from airflow import DAG, configuration
 from airflow.contrib.sensors.wasb_sensor import WasbBlobSensor
 from airflow.contrib.sensors.wasb_sensor import WasbPrefixSensor
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestWasbBlobSensor(unittest.TestCase):
diff --git a/tests/contrib/utils/test_sendgrid.py b/tests/contrib/utils/test_sendgrid.py
index 6710076c2da80..d8a3c9439a1b7 100644
--- a/tests/contrib/utils/test_sendgrid.py
+++ b/tests/contrib/utils/test_sendgrid.py
@@ -22,14 +22,7 @@
 import unittest
 
 from airflow.contrib.utils.sendgrid import send_email
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class SendEmailSendGridTest(unittest.TestCase):
diff --git a/tests/core.py b/tests/core.py
index 68a795fcb31df..20b714dca74ba 100644
--- a/tests/core.py
+++ b/tests/core.py
@@ -69,7 +69,7 @@
 from airflow.utils.dates import days_ago, infer_time_unit, round_time, scale_time_units
 from airflow.exceptions import AirflowException
 from airflow.configuration import AirflowConfigException, run_command
-from jinja2.sandbox import SecurityError
+from jinja2.exceptions import SecurityError
 from jinja2 import UndefinedError
 from pendulum import utcnow
 
@@ -89,7 +89,7 @@
     import cPickle as pickle
 except ImportError:
     # Python 3
-    import pickle
+    import pickle  # type: ignore
 
 
 class OperatorSubclass(BaseOperator):
diff --git a/tests/executors/test_celery_executor.py b/tests/executors/test_celery_executor.py
index 43b59f8f2cd3e..821f265f1070e 100644
--- a/tests/executors/test_celery_executor.py
+++ b/tests/executors/test_celery_executor.py
@@ -117,7 +117,7 @@ def fake_celery_task():
 
         executor.tasks = {'key': fake_celery_task()}
         executor.sync()
-        mock_log.error.assert_called_once()
+        assert mock_log.error.call_count == 1
         args, kwargs = mock_log.error.call_args_list[0]
         # Result of queuing is not a celery task but a dict,
         # and it should raise AttributeError and then get propagated
diff --git a/tests/hooks/test_dbapi_hook.py b/tests/hooks/test_dbapi_hook.py
index 3484ee99da99b..05a571d8430b3 100644
--- a/tests/hooks/test_dbapi_hook.py
+++ b/tests/hooks/test_dbapi_hook.py
@@ -51,8 +51,8 @@ def test_get_records(self):
 
         self.assertEqual(rows, self.db_hook.get_records(statement))
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
         self.cur.execute.assert_called_once_with(statement)
 
     def test_get_records_parameters(self):
@@ -65,8 +65,8 @@ def test_get_records_parameters(self):
 
         self.assertEqual(rows, self.db_hook.get_records(statement, parameters))
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
         self.cur.execute.assert_called_once_with(statement, parameters)
 
     def test_get_records_exception(self):
@@ -76,8 +76,8 @@ def test_get_records_exception(self):
         with self.assertRaises(RuntimeError):
             self.db_hook.get_records(statement)
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        self.conn.close.call_count == 1
+        self.cur.close.call_count == 1
         self.cur.execute.assert_called_once_with(statement)
 
     def test_insert_rows(self):
@@ -87,8 +87,8 @@ def test_insert_rows(self):
 
         self.db_hook.insert_rows(table, rows)
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
 
         commit_count = 2  # The first and last commit
         self.assertEqual(commit_count, self.conn.commit.call_count)
@@ -104,8 +104,8 @@ def test_insert_rows_replace(self):
 
         self.db_hook.insert_rows(table, rows, replace=True)
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
 
         commit_count = 2  # The first and last commit
         self.assertEqual(commit_count, self.conn.commit.call_count)
@@ -122,8 +122,8 @@ def test_insert_rows_target_fields(self):
 
         self.db_hook.insert_rows(table, rows, target_fields)
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
 
         commit_count = 2  # The first and last commit
         self.assertEqual(commit_count, self.conn.commit.call_count)
@@ -140,8 +140,8 @@ def test_insert_rows_commit_every(self):
 
         self.db_hook.insert_rows(table, rows, commit_every=commit_every)
 
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
 
         commit_count = 2 + divmod(len(rows), commit_every)[0]
         self.assertEqual(commit_count, self.conn.commit.call_count)
diff --git a/tests/hooks/test_docker_hook.py b/tests/hooks/test_docker_hook.py
index f4bc6b4f4673c..438c70134f0a0 100644
--- a/tests/hooks/test_docker_hook.py
+++ b/tests/hooks/test_docker_hook.py
@@ -23,20 +23,13 @@
 from airflow.exceptions import AirflowException
 from airflow.models.connection import Connection
 from airflow.utils import db
+from tests.compat import mock
 
 try:
     from airflow.hooks.docker_hook import DockerHook
 except ImportError:
     pass
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 @mock.patch('airflow.hooks.docker_hook.APIClient', autospec=True)
 class DockerHookTest(unittest.TestCase):
diff --git a/tests/hooks/test_druid_hook.py b/tests/hooks/test_druid_hook.py
index 3d90c8e25709c..633d985d4a6e3 100644
--- a/tests/hooks/test_druid_hook.py
+++ b/tests/hooks/test_druid_hook.py
@@ -166,8 +166,8 @@ def test_get_first_record(self):
         self.cur.fetchone.return_value = result_sets[0]
 
         self.assertEqual(result_sets[0], self.db_hook().get_first(statement))
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
         self.cur.execute.assert_called_once_with(statement)
 
     def test_get_records(self):
@@ -176,8 +176,8 @@ def test_get_records(self):
         self.cur.fetchall.return_value = result_sets
 
         self.assertEqual(result_sets, self.db_hook().get_records(statement))
-        self.conn.close.assert_called_once()
-        self.cur.close.assert_called_once()
+        assert self.conn.close.call_count == 1
+        assert self.cur.close.call_count == 1
         self.cur.execute.assert_called_once_with(statement)
 
 
diff --git a/tests/hooks/test_hive_hook.py b/tests/hooks/test_hive_hook.py
index 2a303c165c453..aa1e95149021c 100644
--- a/tests/hooks/test_hive_hook.py
+++ b/tests/hooks/test_hive_hook.py
@@ -158,13 +158,13 @@ def test_load_df(self, mock_to_csv, mock_load_file):
                      delimiter=delimiter,
                      encoding=encoding)
 
-        mock_to_csv.assert_called_once()
+        assert mock_to_csv.call_count == 1
         kwargs = mock_to_csv.call_args[1]
         self.assertEqual(kwargs["header"], False)
         self.assertEqual(kwargs["index"], False)
         self.assertEqual(kwargs["sep"], delimiter)
 
-        mock_load_file.assert_called_once()
+        assert mock_load_file.call_count == 1
         kwargs = mock_load_file.call_args[1]
         self.assertEqual(kwargs["delimiter"], delimiter)
         self.assertEqual(kwargs["field_dict"], {"c": u"STRING"})
@@ -183,7 +183,7 @@ def test_load_df_with_optional_parameters(self, mock_to_csv, mock_load_file):
                          create=create,
                          recreate=recreate)
 
-            mock_load_file.assert_called_once()
+            assert mock_load_file.call_count == 1
             kwargs = mock_load_file.call_args[1]
             self.assertEqual(kwargs["create"], create)
             self.assertEqual(kwargs["recreate"], recreate)
diff --git a/tests/hooks/test_http_hook.py b/tests/hooks/test_http_hook.py
index ca325940dcb4e..f569c51f2f047 100644
--- a/tests/hooks/test_http_hook.py
+++ b/tests/hooks/test_http_hook.py
@@ -29,14 +29,7 @@
 from airflow.exceptions import AirflowException
 from airflow.hooks.http_hook import HttpHook
 from airflow.models.connection import Connection
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 def get_airflow_connection(conn_id=None):
diff --git a/tests/hooks/test_mysql_hook.py b/tests/hooks/test_mysql_hook.py
index ed7855959fd88..94694618481a2 100644
--- a/tests/hooks/test_mysql_hook.py
+++ b/tests/hooks/test_mysql_hook.py
@@ -53,7 +53,7 @@ def setUp(self):
     @mock.patch('airflow.hooks.mysql_hook.MySQLdb.connect')
     def test_get_conn(self, mock_connect):
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['user'], 'login')
@@ -65,7 +65,7 @@ def test_get_conn(self, mock_connect):
     def test_get_conn_port(self, mock_connect):
         self.connection.port = 3307
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['port'], 3307)
@@ -74,7 +74,7 @@ def test_get_conn_port(self, mock_connect):
     def test_get_conn_charset(self, mock_connect):
         self.connection.extra = json.dumps({'charset': 'utf-8'})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['charset'], 'utf-8')
@@ -84,7 +84,7 @@ def test_get_conn_charset(self, mock_connect):
     def test_get_conn_cursor(self, mock_connect):
         self.connection.extra = json.dumps({'cursor': 'sscursor'})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['cursorclass'], MySQLdb.cursors.SSCursor)
@@ -93,7 +93,7 @@ def test_get_conn_cursor(self, mock_connect):
     def test_get_conn_local_infile(self, mock_connect):
         self.connection.extra = json.dumps({'local_infile': True})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['local_infile'], 1)
@@ -102,7 +102,7 @@ def test_get_conn_local_infile(self, mock_connect):
     def test_get_con_unix_socket(self, mock_connect):
         self.connection.extra = json.dumps({'unix_socket': "/tmp/socket"})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['unix_socket'], '/tmp/socket')
@@ -111,7 +111,7 @@ def test_get_con_unix_socket(self, mock_connect):
     def test_get_conn_ssl_as_dictionary(self, mock_connect):
         self.connection.extra = json.dumps({'ssl': SSL_DICT})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['ssl'], SSL_DICT)
@@ -120,7 +120,7 @@ def test_get_conn_ssl_as_dictionary(self, mock_connect):
     def test_get_conn_ssl_as_string(self, mock_connect):
         self.connection.extra = json.dumps({'ssl': json.dumps(SSL_DICT)})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['ssl'], SSL_DICT)
@@ -159,7 +159,7 @@ def test_run_without_autocommit(self):
         self.db_hook.run(sql, autocommit=False)
         self.conn.autocommit.assert_called_once_with(False)
         self.cur.execute.assert_called_once_with(sql)
-        self.conn.commit.assert_called_once()
+        assert self.conn.commit.call_count == 1
 
     def test_run_with_autocommit(self):
         sql = 'SQL'
diff --git a/tests/hooks/test_oracle_hook.py b/tests/hooks/test_oracle_hook.py
index c3299d79bce44..927a7b8f110b7 100644
--- a/tests/hooks/test_oracle_hook.py
+++ b/tests/hooks/test_oracle_hook.py
@@ -25,11 +25,11 @@
     import cx_Oracle
 except ImportError:
     cx_Oracle = None
-import mock
 import numpy
 
 from airflow.hooks.oracle_hook import OracleHook
 from airflow.models import Connection
+from tests.compat import mock
 
 
 @unittest.skipIf(cx_Oracle is None, 'cx_Oracle package not present')
@@ -52,7 +52,7 @@ def setUp(self):
     @mock.patch('airflow.hooks.oracle_hook.cx_Oracle.connect')
     def test_get_conn_host(self, mock_connect):
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['user'], 'login')
@@ -64,7 +64,7 @@ def test_get_conn_sid(self, mock_connect):
         dsn_sid = {'dsn': 'dsn', 'sid': 'sid'}
         self.connection.extra = json.dumps(dsn_sid)
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['dsn'],
@@ -76,7 +76,7 @@ def test_get_conn_service_name(self, mock_connect):
         dsn_service_name = {'dsn': 'dsn', 'service_name': 'service_name'}
         self.connection.extra = json.dumps(dsn_service_name)
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['dsn'], cx_Oracle.makedsn(
@@ -87,7 +87,7 @@ def test_get_conn_service_name(self, mock_connect):
     def test_get_conn_encoding_without_nencoding(self, mock_connect):
         self.connection.extra = json.dumps({'encoding': 'UTF-8'})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['encoding'], 'UTF-8')
@@ -97,7 +97,7 @@ def test_get_conn_encoding_without_nencoding(self, mock_connect):
     def test_get_conn_encoding_with_nencoding(self, mock_connect):
         self.connection.extra = json.dumps({'encoding': 'UTF-8', 'nencoding': 'gb2312'})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['encoding'], 'UTF-8')
@@ -107,7 +107,7 @@ def test_get_conn_encoding_with_nencoding(self, mock_connect):
     def test_get_conn_nencoding(self, mock_connect):
         self.connection.extra = json.dumps({'nencoding': 'UTF-8'})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertNotIn('encoding', kwargs)
@@ -128,7 +128,7 @@ def test_get_conn_mode(self, mock_connect):
             self.connection.extra = json.dumps({'mode': m})
             self.db_hook.get_conn()
             if first:
-                mock_connect.assert_called_once()
+                assert mock_connect.call_count == 1
                 first = False
             args, kwargs = mock_connect.call_args
             self.assertEqual(args, ())
@@ -138,7 +138,7 @@ def test_get_conn_mode(self, mock_connect):
     def test_get_conn_threaded(self, mock_connect):
         self.connection.extra = json.dumps({'threaded': True})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['threaded'], True)
@@ -147,7 +147,7 @@ def test_get_conn_threaded(self, mock_connect):
     def test_get_conn_events(self, mock_connect):
         self.connection.extra = json.dumps({'events': True})
         self.db_hook.get_conn()
-        mock_connect.assert_called_once()
+        assert mock_connect.call_count == 1
         args, kwargs = mock_connect.call_args
         self.assertEqual(args, ())
         self.assertEqual(kwargs['events'], True)
@@ -164,7 +164,7 @@ def test_get_conn_purity(self, mock_connect):
             self.connection.extra = json.dumps({'purity': p})
             self.db_hook.get_conn()
             if first:
-                mock_connect.assert_called_once()
+                assert mock_connect.call_count == 1
                 first = False
             args, kwargs = mock_connect.call_args
             self.assertEqual(args, ())
@@ -193,14 +193,14 @@ def test_run_without_parameters(self):
         sql = 'SQL'
         self.db_hook.run(sql)
         self.cur.execute.assert_called_once_with(sql)
-        self.conn.commit.assert_called()
+        assert self.conn.commit.called
 
     def test_run_with_parameters(self):
         sql = 'SQL'
         param = ('p1', 'p2')
         self.db_hook.run(sql, parameters=param)
         self.cur.execute.assert_called_once_with(sql, param)
-        self.conn.commit.assert_called()
+        assert self.conn.commit.called
 
     def test_insert_rows_with_fields(self):
         rows = [("'basestr_with_quote", None, numpy.NAN,
diff --git a/tests/hooks/test_pig_hook.py b/tests/hooks/test_pig_hook.py
index c250d2355be60..8f8dfdc6e5387 100644
--- a/tests/hooks/test_pig_hook.py
+++ b/tests/hooks/test_pig_hook.py
@@ -19,14 +19,7 @@
 
 import unittest
 from airflow.hooks.pig_hook import PigCliHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class TestPigCliHook(unittest.TestCase):
diff --git a/tests/hooks/test_postgres_hook.py b/tests/hooks/test_postgres_hook.py
index f937c26782401..d69f20ce06b82 100644
--- a/tests/hooks/test_postgres_hook.py
+++ b/tests/hooks/test_postgres_hook.py
@@ -64,9 +64,9 @@ def test_copy_expert(self):
 
             self.assertEqual(None, self.db_hook.copy_expert(statement, filename, open=m))
 
-            self.conn.close.assert_called_once()
-            self.cur.close.assert_called_once()
-            self.conn.commit.assert_called_once()
+            assert self.conn.close.call_count == 1
+            assert self.cur.close.call_count == 1
+            assert self.conn.commit.call_count == 1
             self.cur.copy_expert.assert_called_once_with(statement, m.return_value)
             self.assertEqual(m.call_args[0], (filename, "r+"))
 
diff --git a/tests/hooks/test_s3_hook.py b/tests/hooks/test_s3_hook.py
index 62092343cdf0d..45646b0c77462 100644
--- a/tests/hooks/test_s3_hook.py
+++ b/tests/hooks/test_s3_hook.py
@@ -29,7 +29,7 @@
 try:
     from airflow.hooks.S3_hook import S3Hook
 except ImportError:
-    S3Hook = None
+    S3Hook = None  # type: ignore
 
 try:
     import boto3
diff --git a/tests/hooks/test_slack_hook.py b/tests/hooks/test_slack_hook.py
index 73193dff8cc6f..d15c5f251258a 100644
--- a/tests/hooks/test_slack_hook.py
+++ b/tests/hooks/test_slack_hook.py
@@ -20,14 +20,7 @@
 import unittest
 from airflow.exceptions import AirflowException
 from airflow.hooks.slack_hook import SlackHook
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class SlackHookTestCase(unittest.TestCase):
diff --git a/tests/lineage/backend/test_atlas.py b/tests/lineage/backend/test_atlas.py
index 9c98334a9a634..5898e683336d5 100644
--- a/tests/lineage/backend/test_atlas.py
+++ b/tests/lineage/backend/test_atlas.py
@@ -25,19 +25,12 @@
 from airflow.models import DAG, TaskInstance as TI
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.utils import timezone
+from tests.compat import mock
 
 from backports.configparser import DuplicateSectionError
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 class TestAtlas(unittest.TestCase):
     def setUp(self):
diff --git a/tests/lineage/test_lineage.py b/tests/lineage/test_lineage.py
index 92b74fe869ed4..451d1f32eb35c 100644
--- a/tests/lineage/test_lineage.py
+++ b/tests/lineage/test_lineage.py
@@ -23,17 +23,10 @@
 from airflow.models import DAG, TaskInstance as TI
 from airflow.operators.dummy_operator import DummyOperator
 from airflow.utils import timezone
+from tests.compat import mock
 
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 
 class TestLineage(unittest.TestCase):
 
diff --git a/tests/operators/test_check_operator.py b/tests/operators/test_check_operator.py
index d3b546058431c..eeec061715aa0 100644
--- a/tests/operators/test_check_operator.py
+++ b/tests/operators/test_check_operator.py
@@ -22,14 +22,7 @@
 from airflow.models import DAG
 from airflow.exceptions import AirflowException
 from airflow.operators.check_operator import ValueCheckOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class ValueCheckOperatorTest(unittest.TestCase):
diff --git a/tests/operators/test_docker_operator.py b/tests/operators/test_docker_operator.py
index 23577d7a2830f..9747a1b96ad50 100644
--- a/tests/operators/test_docker_operator.py
+++ b/tests/operators/test_docker_operator.py
@@ -28,14 +28,7 @@
     pass
 
 from airflow.exceptions import AirflowException
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class DockerOperatorTestCase(unittest.TestCase):
diff --git a/tests/operators/test_druid_check_operator.py b/tests/operators/test_druid_check_operator.py
index f64ad7e32b1d4..c18b56d97115e 100644
--- a/tests/operators/test_druid_check_operator.py
+++ b/tests/operators/test_druid_check_operator.py
@@ -24,14 +24,7 @@
 from airflow.models import DAG
 from airflow.exceptions import AirflowException
 from airflow.operators.druid_check_operator import DruidCheckOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class DruidCheckOperatorTest(unittest.TestCase):
diff --git a/tests/operators/test_email_operator.py b/tests/operators/test_email_operator.py
index a19f450a5cbe9..67baa42cb29df 100644
--- a/tests/operators/test_email_operator.py
+++ b/tests/operators/test_email_operator.py
@@ -62,4 +62,4 @@ def test_execute(self):
         configuration.conf.set('email', 'EMAIL_BACKEND',
                                'tests.operators.test_email_operator.send_email_test')
         self._run_as_operator()
-        send_email_test.assert_called_once()
+        assert send_email_test.call_count == 1
diff --git a/tests/operators/test_http_operator.py b/tests/operators/test_http_operator.py
index 29bab1005a184..12fc6529752b3 100644
--- a/tests/operators/test_http_operator.py
+++ b/tests/operators/test_http_operator.py
@@ -23,12 +23,7 @@
 import requests_mock
 from airflow.operators.http_operator import SimpleHttpOperator
 from airflow.exceptions import AirflowException
-
-
-try:
-    from unittest import mock
-except ImportError:
-    import mock
+from tests.compat import mock
 
 
 class SimpleHttpOpTests(unittest.TestCase):
diff --git a/tests/operators/test_operators.py b/tests/operators/test_operators.py
index 39a813316e7c0..0d817c001b755 100644
--- a/tests/operators/test_operators.py
+++ b/tests/operators/test_operators.py
@@ -135,7 +135,7 @@ def test_mysql_hook_test_bulk_dump_mock(self, mock_get_conn):
         hook.bulk_dump(table, tmp_file)
 
         from airflow.utils.tests import assertEqualIgnoreMultipleSpaces
-        mock_execute.assert_called_once()
+        assert mock_execute.call_count == 1
         query = """
             SELECT * INTO OUTFILE '{tmp_file}'
             FROM {table}
@@ -464,7 +464,7 @@ def test_mysql_to_hive_type_conversion(self, mock_load_file):
                 dag=self.dag)
             t.run(start_date=DEFAULT_DATE, end_date=DEFAULT_DATE, ignore_ti_state=True)
 
-            mock_load_file.assert_called_once()
+            assert mock_load_file.call_count == 1
             d = OrderedDict()
             d["c0"] = "SMALLINT"
             d["c1"] = "INT"
diff --git a/tests/operators/test_redshift_to_s3_operator.py b/tests/operators/test_redshift_to_s3_operator.py
index 314b74a8042d2..0b4309214f227 100644
--- a/tests/operators/test_redshift_to_s3_operator.py
+++ b/tests/operators/test_redshift_to_s3_operator.py
@@ -92,8 +92,8 @@ def test_execute(self, mock_get_conn, mock_run, mock_Session):
                            secret_key=secret_key,
                            unload_options=unload_options)
 
-        cur.execute.assert_called_once()
+        assert cur.execute.call_count == 1
         assertEqualIgnoreMultipleSpaces(self, cur.execute.call_args[0][0], columns_query)
 
-        mock_run.assert_called_once()
+        assert mock_run.call_count == 1
         assertEqualIgnoreMultipleSpaces(self, mock_run.call_args[0][0], unload_query)
diff --git a/tests/operators/test_s3_to_hive_operator.py b/tests/operators/test_s3_to_hive_operator.py
index bafa3eb191a79..8366465a9ebd8 100644
--- a/tests/operators/test_s3_to_hive_operator.py
+++ b/tests/operators/test_s3_to_hive_operator.py
@@ -19,13 +19,7 @@
 
 import unittest
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 import logging
 from itertools import product
 from airflow.operators.s3_to_hive_operator import S3ToHiveTransfer
diff --git a/tests/operators/test_s3_to_redshift_operator.py b/tests/operators/test_s3_to_redshift_operator.py
index 95e0f1d823935..8c0175311562b 100644
--- a/tests/operators/test_s3_to_redshift_operator.py
+++ b/tests/operators/test_s3_to_redshift_operator.py
@@ -67,5 +67,5 @@ def test_execute(self, mock_run, mock_Session):
                    secret_key=secret_key,
                    copy_options=copy_options)
 
-        mock_run.assert_called_once()
+        assert mock_run.call_count == 1
         assertEqualIgnoreMultipleSpaces(self, mock_run.call_args[0][0], copy_query)
diff --git a/tests/operators/test_slack_operator.py b/tests/operators/test_slack_operator.py
index d29f7c8236ff3..08434f9622e72 100644
--- a/tests/operators/test_slack_operator.py
+++ b/tests/operators/test_slack_operator.py
@@ -21,14 +21,7 @@
 import json
 from airflow.exceptions import AirflowException
 from airflow.operators.slack_operator import SlackAPIPostOperator
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 
 class SlackAPIPostOperatorTestCase(unittest.TestCase):
diff --git a/tests/security/test_kerberos.py b/tests/security/test_kerberos.py
index d3d7bd5b00857..36372696682ab 100644
--- a/tests/security/test_kerberos.py
+++ b/tests/security/test_kerberos.py
@@ -18,10 +18,7 @@
 # under the License.
 
 import os
-try:
-    import unittest2 as unittest  # PY27
-except ImportError:
-    import unittest
+import unittest
 from argparse import Namespace
 from airflow import configuration
 from airflow.security.kerberos import renew_from_kt
diff --git a/tests/sensors/test_http_sensor.py b/tests/sensors/test_http_sensor.py
index cfa135e2047c9..7e078be2a7e2c 100644
--- a/tests/sensors/test_http_sensor.py
+++ b/tests/sensors/test_http_sensor.py
@@ -26,14 +26,7 @@
 from airflow.operators.http_operator import SimpleHttpOperator
 from airflow.sensors.http_sensor import HttpSensor
 from airflow.utils.timezone import datetime
-
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
+from tests.compat import mock
 
 configuration.load_test_config()
 
diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 0c7d0004518e7..9bfefb4ece7b9 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -36,7 +36,7 @@
 import psutil
 import six
 import sqlalchemy
-from mock import Mock, patch, MagicMock, PropertyMock
+from tests.compat import Mock, patch, MagicMock, PropertyMock
 from parameterized import parameterized
 
 from airflow.utils.db import create_session
@@ -61,19 +61,12 @@
 from airflow.utils.timeout import timeout
 from tests.core import TEST_DAG_FOLDER
 from tests.executors.test_executor import TestExecutor
+from tests.compat import mock
 
 configuration.load_test_config()
 
 logger = logging.getLogger(__name__)
 
-try:
-    from unittest import mock
-except ImportError:
-    try:
-        import mock
-    except ImportError:
-        mock = None
-
 DEV_NULL = '/dev/null'
 DEFAULT_DATE = timezone.datetime(2016, 1, 1)
 TRY_NUMBER = 1
@@ -1969,7 +1962,7 @@ def test_enqueue_task_instances_with_queued_state(self):
         with patch.object(BaseExecutor, 'queue_command') as mock_queue_command:
             scheduler._enqueue_task_instances_with_queued_state(dagbag, [ti1])
 
-        mock_queue_command.assert_called()
+        assert mock_queue_command.called
 
     def test_execute_task_instances_nothing(self):
         dag_id = 'SchedulerJobTest.test_execute_task_instances_nothing'
@@ -3104,7 +3097,7 @@ def test_scheduler_sla_miss_callback(self):
                                  num_runs=1)
         scheduler.manage_slas(dag=dag, session=session)
 
-        sla_callback.assert_called()
+        assert sla_callback.called
 
     def test_scheduler_sla_miss_callback_invalid_sla(self):
         """
@@ -3216,7 +3209,7 @@ def test_scheduler_sla_miss_callback_exception(self):
         with mock.patch('airflow.jobs.SchedulerJob.log',
                         new_callable=PropertyMock) as mock_log:
             scheduler.manage_slas(dag=dag, session=session)
-            sla_callback.assert_called()
+            assert sla_callback.called
             mock_log().exception.assert_called_with(
                 'Could not call sla_miss_callback for DAG %s',
                 'test_sla_miss')
diff --git a/tests/test_logging_config.py b/tests/test_logging_config.py
index 01f40b5e77548..29d101f8be2e3 100644
--- a/tests/test_logging_config.py
+++ b/tests/test_logging_config.py
@@ -20,11 +20,11 @@
 import six
 import sys
 import tempfile
-from mock import patch, mock
 
 from airflow import configuration as conf
 from airflow.configuration import mkdir_p
 from airflow.exceptions import AirflowConfigException
+from tests.compat import mock, patch
 
 
 if six.PY2:
diff --git a/tests/utils/log/elasticmock/__init__.py b/tests/utils/log/elasticmock/__init__.py
index 73c4879847138..6d4ce51fa26ba 100644
--- a/tests/utils/log/elasticmock/__init__.py
+++ b/tests/utils/log/elasticmock/__init__.py
@@ -23,13 +23,14 @@
 # SOFTWARE.
 
 from functools import wraps
+from typing import Dict
 
 from elasticsearch.client import _normalize_hosts
-from mock import patch
+from tests.compat import patch
 
 from .fake_elasticsearch import FakeElasticsearch
 
-ELASTIC_INSTANCES = {}
+ELASTIC_INSTANCES = {}  # type: Dict[str, FakeElasticsearch]
 
 
 def _get_elasticmock(hosts=None, *args, **kwargs):
diff --git a/tests/utils/log/test_es_task_handler.py b/tests/utils/log/test_es_task_handler.py
index accdfe32d7418..b6dd2fe1fb051 100644
--- a/tests/utils/log/test_es_task_handler.py
+++ b/tests/utils/log/test_es_task_handler.py
@@ -171,7 +171,7 @@ def test_read_raises(self):
             with mock.patch("elasticsearch_dsl.Search.execute") as mock_execute:
                 mock_execute.side_effect = Exception('Failed to read')
                 logs, metadatas = self.es_task_handler.read(self.ti, 1)
-            mock_exception.assert_called_once()
+            assert mock_exception.call_count == 1
             args, kwargs = mock_exception.call_args
             self.assertIn("Could not read log with log_id:", args[0])
 
diff --git a/tests/www/test_utils.py b/tests/www/test_utils.py
index a8aa959ad7ba9..22f1e790eb012 100644
--- a/tests/www/test_utils.py
+++ b/tests/www/test_utils.py
@@ -243,15 +243,15 @@ def test_open_maybe_zipped_archive(self, mocked_ZipFile, mocked_is_zipfile):
 
         utils.open_maybe_zipped('/path/to/archive.zip/deep/path/to/file.txt')
 
-        mocked_is_zipfile.assert_called_once()
+        assert mocked_is_zipfile.call_count == 1
         (args, kwargs) = mocked_is_zipfile.call_args_list[0]
         self.assertEqual('/path/to/archive.zip', args[0])
 
-        mocked_ZipFile.assert_called_once()
+        assert mocked_ZipFile.call_count == 1
         (args, kwargs) = mocked_ZipFile.call_args_list[0]
         self.assertEqual('/path/to/archive.zip', args[0])
 
-        instance.open.assert_called_once()
+        assert instance.open.call_count == 1
         (args, kwargs) = instance.open.call_args_list[0]
         self.assertEqual('deep/path/to/file.txt', args[0])
 

From 04ac286ae88ffad478350dbc43e219498af2f0ea Mon Sep 17 00:00:00 2001
From: Peter van 't Hof <ffinfo@users.noreply.github.com>
Date: Tue, 5 Mar 2019 22:28:59 +0100
Subject: [PATCH 806/808] [AIRFLOW-4016] Clear runs for BackfillJobTest (#4839)

* Clear runs for BackfillJobTest

* Fixing import

* Fixing flake8
---
 tests/test_jobs.py     | 23 +++++++++------------
 tests/test_utils/db.py | 47 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+), 13 deletions(-)
 create mode 100644 tests/test_utils/db.py

diff --git a/tests/test_jobs.py b/tests/test_jobs.py
index 9bfefb4ece7b9..e3ae8be181b25 100644
--- a/tests/test_jobs.py
+++ b/tests/test_jobs.py
@@ -59,6 +59,8 @@
 from airflow.utils.net import get_hostname
 from airflow.utils.state import State
 from airflow.utils.timeout import timeout
+from tests.test_utils.db import clear_db_runs, clear_db_pools, clear_db_dags, \
+    clear_db_sla_miss, clear_db_errors
 from tests.core import TEST_DAG_FOLDER
 from tests.executors.test_executor import TestExecutor
 from tests.compat import mock
@@ -126,10 +128,8 @@ def abort():
 class BackfillJobTest(unittest.TestCase):
 
     def setUp(self):
-        with create_session() as session:
-            session.query(models.DagRun).delete()
-            session.query(models.Pool).delete()
-            session.query(models.TaskInstance).delete()
+        clear_db_runs()
+        clear_db_pools()
 
         self.parser = cli.CLIFactory.get_parser()
         self.dagbag = DagBag(include_examples=True)
@@ -1225,7 +1225,7 @@ def test_backfill_run_backwards(self):
 
 class LocalTaskJobTest(unittest.TestCase):
     def setUp(self):
-        pass
+        clear_db_runs()
 
     def test_localtaskjob_essential_attr(self):
         """
@@ -1385,14 +1385,11 @@ def test_localtaskjob_double_trigger(self):
 class SchedulerJobTest(unittest.TestCase):
 
     def setUp(self):
-        with create_session() as session:
-            session.query(models.DagRun).delete()
-            session.query(models.TaskInstance).delete()
-            session.query(models.Pool).delete()
-            session.query(models.DagModel).delete()
-            session.query(models.SlaMiss).delete()
-            session.query(errors.ImportError).delete()
-            session.commit()
+        clear_db_runs()
+        clear_db_pools()
+        clear_db_dags()
+        clear_db_sla_miss()
+        clear_db_errors()
 
     @classmethod
     def setUpClass(cls):
diff --git a/tests/test_utils/db.py b/tests/test_utils/db.py
new file mode 100644
index 0000000000000..0a2f3961c2852
--- /dev/null
+++ b/tests/test_utils/db.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+from airflow.models import DagRun, TaskInstance, Pool, DagModel, errors
+from airflow.models.slamiss import SlaMiss
+from airflow.utils.db import create_session
+
+
+def clear_db_runs():
+    with create_session() as session:
+        session.query(DagRun).delete()
+        session.query(TaskInstance).delete()
+
+
+def clear_db_dags():
+    with create_session() as session:
+        session.query(DagModel).delete()
+
+
+def clear_db_sla_miss():
+    with create_session() as session:
+        session.query(SlaMiss).delete()
+
+
+def clear_db_errors():
+    with create_session() as session:
+        session.query(errors.ImportError).delete()
+
+
+def clear_db_pools():
+    with create_session() as session:
+        session.query(Pool).delete()

From 16d93c9e45e14179c7822fed248743f0c3fd935c Mon Sep 17 00:00:00 2001
From: Ash Berlin-Taylor <ash_github@firemirror.com>
Date: Sat, 6 Apr 2019 14:18:05 +0100
Subject: [PATCH 807/808] [AIRFLOW-XXX] Changes since 1.10.3rc1

---
 CHANGELOG.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.txt b/CHANGELOG.txt
index fde681b2c34df..02221bfe0de65 100644
--- a/CHANGELOG.txt
+++ b/CHANGELOG.txt
@@ -37,6 +37,7 @@ New Feature
 Improvement
 """""""""""
 
+- [AIRFLOW-4120] Modify SchedulerJob.manage_slas to respect zero timedelta SLAs (#4939)
 - [AIRFLOW-3823] Exclude branch's downstream tasks from the tasks to skip (#4666)
 - [AIRFLOW-3274] Add run_as_user and fs_group options for Kubernetes (#4648)
 - [AIRFLOW-4247] Template Region on the DataprocOperators (#5046)
@@ -149,6 +150,8 @@ Improvement
 Bug fixes
 """""""""
 
+- [AIRFLOW-2994] Fix command status check in Qubole Check operator (#3790)
+- [AIRFLOW-2563] Fix PigCliHook Python 3 string/bytes use
 - [AIRFLOW-4248] Fix 'FileExistsError' makedirs race in file_processor_handler (#5047)
 - [AIRFLOW-4240] State-changing actions should be POST requests (#5039)
 - [AIRFLOW-4246] Flask-Oauthlib needs downstream dependencies pinning due to breaking changes (#5045)
@@ -262,6 +265,8 @@ Bug fixes
 Misc/Interal
 """"""""""""
 
+- [AIRFLOW-4016] Clear runs for BackfillJobTest (#4839)
+- [AIRFLOW-4177] Check types in tests
 - [AIRFLOW-4144] add description of is_delete_operator_pod (#4943)
 - [AIRFLOW-3476,3477] Move Kube classes out of models.py (#4443)
 - [AIRFLOW-3464] Move SkipMixin out of models.py (#4386)

From 6d7cb530d36075011ef17e4c3e872251f966511b Mon Sep 17 00:00:00 2001
From: Hiro Dozono <hiro@dozono.ca>
Date: Wed, 17 Apr 2019 11:56:10 +0200
Subject: [PATCH 808/808] [AIRFLOW-4294] Fix missing dag & task runs in UI
 dag_id contains a dot (#5111)

We used to key on `safe_dag_id` but in that got changed in #4368 to use a
more efficient query, which broke for non-sub-DAGs that contain a `.` in their id.

Arguably this escaping is a front-end concern anyway, so handling the escaping in the front end makes sense anyway.

(cherry picked from commit c696dd4d3fdddd65b0cb62f17bf619c0492cbb96)
---
 airflow/www/templates/airflow/dags.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/airflow/www/templates/airflow/dags.html b/airflow/www/templates/airflow/dags.html
index 2340855f9c73a..1a0ebc01f44ba 100644
--- a/airflow/www/templates/airflow/dags.html
+++ b/airflow/www/templates/airflow/dags.html
@@ -312,7 +312,7 @@ <h2>DAGs</h2>
       d3.json("{{ url_for('airflow.dag_stats') }}", function(error, json) {
         for(var dag_id in json) {
             states = json[dag_id];
-            g = d3.select('svg#dag-run-' + dag_id)
+            g = d3.select('svg#dag-run-' + dag_id.replace(/\./g, '__dot__'))
               .attr('height', diameter + (stroke_width_hover * 2))
               .attr('width', '110px')
               .selectAll("g")
@@ -391,7 +391,7 @@ <h2>DAGs</h2>
       d3.json("{{ url_for('airflow.task_stats') }}", function(error, json) {
         for(var dag_id in json) {
             states = json[dag_id];
-            g = d3.select('svg#task-run-' + dag_id)
+            g = d3.select('svg#task-run-' + dag_id.replace(/\./g, '__dot__'))
               .attr('height', diameter + (stroke_width_hover * 2))
               .attr('width', '300px')
               .selectAll("g")